summaryrefslogtreecommitdiff
path: root/macros/latex/contrib
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2022-10-20 03:04:26 +0000
committerNorbert Preining <norbert@preining.info>2022-10-20 03:04:26 +0000
commit3b961a61ef9fb89adf20a89550d5de0bfe135448 (patch)
treee36f997e624c704dbb4ed2b5fdbd02835ea3c133 /macros/latex/contrib
parent7b6cdf4c23e6ed232601dabc70f5553a8dee9c9b (diff)
CTAN sync 202210200304
Diffstat (limited to 'macros/latex/contrib')
-rw-r--r--macros/latex/contrib/acmart/Makefile11
-rw-r--r--macros/latex/contrib/acmart/README6
-rw-r--r--macros/latex/contrib/acmart/acmart.dtx418
-rw-r--r--macros/latex/contrib/acmart/acmart.pdfbin909624 -> 905284 bytes
-rw-r--r--macros/latex/contrib/acmart/acmguide.pdfbin427632 -> 431697 bytes
-rw-r--r--macros/latex/contrib/acmart/samples/sample-acmcp.pdfbin0 -> 208463 bytes
-rw-r--r--macros/latex/contrib/acmart/samples/sample-acmengage.pdfbin395777 -> 395897 bytes
-rw-r--r--macros/latex/contrib/acmart/samples/sample-acmlarge.pdfbin605879 -> 606046 bytes
-rw-r--r--macros/latex/contrib/acmart/samples/sample-acmsmall-biblatex.pdfbin628602 -> 628568 bytes
-rw-r--r--macros/latex/contrib/acmart/samples/sample-acmsmall-conf.pdfbin1049943 -> 1050111 bytes
-rw-r--r--macros/latex/contrib/acmart/samples/sample-acmsmall-submission.pdfbin618221 -> 618407 bytes
-rw-r--r--macros/latex/contrib/acmart/samples/sample-acmsmall.pdfbin615731 -> 615912 bytes
-rw-r--r--macros/latex/contrib/acmart/samples/sample-acmtog.pdfbin563350 -> 563306 bytes
-rw-r--r--macros/latex/contrib/acmart/samples/sample-authordraft.pdfbin1043038 -> 1043265 bytes
-rw-r--r--macros/latex/contrib/acmart/samples/sample-lualatex.pdfbin780062 -> 780905 bytes
-rw-r--r--macros/latex/contrib/acmart/samples/sample-manuscript.pdfbin617941 -> 618126 bytes
-rw-r--r--macros/latex/contrib/acmart/samples/sample-sigconf-biblatex.pdfbin615270 -> 615682 bytes
-rw-r--r--macros/latex/contrib/acmart/samples/sample-sigconf-i13n.pdfbin1054983 -> 1055067 bytes
-rw-r--r--macros/latex/contrib/acmart/samples/sample-sigconf.pdfbin1039228 -> 1039467 bytes
-rw-r--r--macros/latex/contrib/acmart/samples/sample-sigplan.pdfbin1048048 -> 1048138 bytes
-rw-r--r--macros/latex/contrib/acmart/samples/sample-xelatex.pdfbin659074 -> 659258 bytes
-rw-r--r--macros/latex/contrib/acmart/samples/samples.dtx90
-rw-r--r--macros/latex/contrib/acmart/samples/samples.ins3
-rw-r--r--macros/latex/contrib/glossaries-extra/CHANGES335
-rw-r--r--macros/latex/contrib/glossaries-extra/DEPENDS.txt1
-rw-r--r--macros/latex/contrib/glossaries-extra/README4
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-code.pdfbin1523017 -> 1805034 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example001.pdfbin0 -> 24434 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example001.pngbin0 -> 3024 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example001.tex19
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example002.pdfbin0 -> 26398 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example002.pngbin0 -> 5604 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example002.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example003.pdfbin0 -> 26398 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example003.pngbin0 -> 5563 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example003.tex29
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example004.pdfbin0 -> 31736 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example004.pngbin0 -> 11529 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example004.tex36
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example005.pdfbin0 -> 33337 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example005.pngbin0 -> 7830 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example005.tex20
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example006.pdfbin0 -> 28569 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example006.pngbin0 -> 8408 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example006.tex30
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example007.pdfbin0 -> 67117 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example007.pngbin0 -> 9843 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example007.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example008.pdfbin0 -> 36784 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example008.pngbin0 -> 4763 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example008.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example009.pdfbin0 -> 49366 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example009.pngbin0 -> 5079 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example009.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example010.pdfbin0 -> 36798 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example010.pngbin0 -> 4787 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example010.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example011.pdfbin0 -> 55865 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example011.pngbin0 -> 4622 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example011.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example012.pdfbin0 -> 73199 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example012.pngbin0 -> 4947 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example012.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example013.pdfbin0 -> 55874 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example013.pngbin0 -> 4660 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example013.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example014.pdfbin0 -> 48913 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example014.pngbin0 -> 4645 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example014.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example015.pdfbin0 -> 66258 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example015.pngbin0 -> 4963 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example015.tex18
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example016.pdfbin0 -> 48931 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example016.pngbin0 -> 4647 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example016.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example017.pdfbin0 -> 50134 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example017.pngbin0 -> 4813 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example017.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example018.pdfbin0 -> 67478 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example018.pngbin0 -> 5134 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example018.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example019.pdfbin0 -> 50147 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example019.pngbin0 -> 4879 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example019.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example020.pdfbin0 -> 47640 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example020.pngbin0 -> 4771 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example020.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example021.pdfbin0 -> 36785 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example021.pngbin0 -> 4708 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example021.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example022.pdfbin0 -> 55844 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example022.pngbin0 -> 4644 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example022.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example023.pdfbin0 -> 57133 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example023.pngbin0 -> 4764 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example023.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example024.pdfbin0 -> 39659 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example024.pngbin0 -> 4696 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example024.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example025.pdfbin0 -> 51597 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example025.pngbin0 -> 4787 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example025.tex18
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example026.pdfbin0 -> 49894 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example026.pngbin0 -> 4827 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example026.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example027.pdfbin0 -> 56567 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example027.pngbin0 -> 4851 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example027.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example028.pdfbin0 -> 59225 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example028.pngbin0 -> 4920 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example028.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example029.pdfbin0 -> 69396 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example029.pngbin0 -> 4962 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example029.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example030.pdfbin0 -> 36810 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example030.pngbin0 -> 4952 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example030.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example031.pdfbin0 -> 49378 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example031.pngbin0 -> 5268 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example031.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example032.pdfbin0 -> 55905 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example032.pngbin0 -> 4848 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example032.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example033.pdfbin0 -> 73249 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example033.pngbin0 -> 5185 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example033.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example034.pdfbin0 -> 48949 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example034.pngbin0 -> 4951 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example034.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example035.pdfbin0 -> 66300 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example035.pngbin0 -> 5273 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example035.tex18
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example036.pdfbin0 -> 50170 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example036.pngbin0 -> 5090 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example036.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example037.pdfbin0 -> 67533 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example037.pngbin0 -> 5421 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example037.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example038.pdfbin0 -> 59249 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example038.pngbin0 -> 5102 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example038.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example039.pdfbin0 -> 75150 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example039.pngbin0 -> 5430 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example039.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example040.pdfbin0 -> 36971 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example040.pngbin0 -> 5173 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example040.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example041.pdfbin0 -> 51165 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example041.pngbin0 -> 5642 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example041.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example042.pdfbin0 -> 36944 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example042.pngbin0 -> 5195 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example042.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example043.pdfbin0 -> 51134 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example043.pngbin0 -> 5673 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example043.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example044.pdfbin0 -> 56045 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example044.pngbin0 -> 5326 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example044.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example045.pdfbin0 -> 75064 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example045.pngbin0 -> 5819 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example045.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example046.pdfbin0 -> 36786 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example046.pngbin0 -> 4925 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example046.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example047.pdfbin0 -> 49359 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example047.pngbin0 -> 5235 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example047.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example048.pdfbin0 -> 55883 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example048.pngbin0 -> 4850 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example048.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example049.pdfbin0 -> 73221 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example049.pngbin0 -> 5177 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example049.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example050.pdfbin0 -> 48942 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example050.pngbin0 -> 4892 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example050.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example051.pdfbin0 -> 66289 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example051.pngbin0 -> 5207 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example051.tex18
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example052.pdfbin0 -> 50119 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example052.pngbin0 -> 4945 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example052.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example053.pdfbin0 -> 67471 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example053.pngbin0 -> 5269 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example053.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example054.pdfbin0 -> 59230 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example054.pngbin0 -> 5071 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example054.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example055.pdfbin0 -> 75123 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example055.pngbin0 -> 5395 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example055.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example056.pdfbin0 -> 36971 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example056.pngbin0 -> 5279 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example056.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example057.pdfbin0 -> 51412 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example057.pngbin0 -> 5780 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example057.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example058.pdfbin0 -> 36969 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example058.pngbin0 -> 5139 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example058.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example059.pdfbin0 -> 51416 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example059.pngbin0 -> 5676 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example059.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example060.pdfbin0 -> 36808 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example060.pngbin0 -> 5004 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example060.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example061.pdfbin0 -> 36797 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example061.pngbin0 -> 5220 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example061.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example062.pdfbin0 -> 49384 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example062.pngbin0 -> 5323 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example062.tex18
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example063.pdfbin0 -> 49371 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example063.pngbin0 -> 5560 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example063.tex18
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example064.pdfbin0 -> 47645 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example064.pngbin0 -> 4868 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example064.tex18
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example065.pdfbin0 -> 36791 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example065.pngbin0 -> 4804 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example065.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example066.pdfbin0 -> 36809 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example066.pngbin0 -> 4963 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example066.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example067.pdfbin0 -> 36792 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example067.pngbin0 -> 5027 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example067.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example068.pdfbin0 -> 49385 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example068.pngbin0 -> 5279 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example068.tex18
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example069.pdfbin0 -> 49372 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example069.pngbin0 -> 5392 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example069.tex18
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example070.pdfbin0 -> 36797 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example070.pngbin0 -> 4815 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example070.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example071.pdfbin0 -> 47651 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example071.pngbin0 -> 4878 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example071.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example072.pdfbin0 -> 55866 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example072.pngbin0 -> 4734 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example072.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example073.pdfbin0 -> 57158 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example073.pngbin0 -> 4851 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example073.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example074.pdfbin0 -> 48400 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example074.pngbin0 -> 8118 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example074.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example075.pdfbin0 -> 56151 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example075.pngbin0 -> 8907 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example075.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example076.pdfbin0 -> 47021 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example076.pngbin0 -> 7731 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example076.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example077.pdfbin0 -> 54773 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example077.pngbin0 -> 8533 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example077.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example078.pdfbin0 -> 60215 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example078.pngbin0 -> 7936 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example078.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example079.pdfbin0 -> 71793 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example079.pngbin0 -> 8721 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example079.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example080.pdfbin0 -> 58844 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example080.pngbin0 -> 7484 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example080.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example081.pdfbin0 -> 70427 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example081.pngbin0 -> 8282 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example081.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example082.pdfbin0 -> 52340 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example082.pngbin0 -> 7977 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example082.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example083.pdfbin0 -> 63908 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example083.pngbin0 -> 8753 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example083.tex18
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example084.pdfbin0 -> 50964 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example084.pngbin0 -> 7464 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example084.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example085.pdfbin0 -> 62538 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example085.pngbin0 -> 8250 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example085.tex18
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example086.pdfbin0 -> 63254 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example086.pngbin0 -> 8537 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example086.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example087.pdfbin0 -> 74842 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example087.pngbin0 -> 9261 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example087.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example088.pdfbin0 -> 61873 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example088.pngbin0 -> 7860 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example088.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example089.pdfbin0 -> 73471 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example089.pngbin0 -> 8607 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example089.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example090.pdfbin0 -> 14050 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example090.pngbin0 -> 3020 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example090.tex15
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example091.pdfbin0 -> 13308 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example091.pngbin0 -> 2301 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example091.tex15
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example092.pdfbin0 -> 32546 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example092.pngbin0 -> 6433 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example092.tex29
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example093.pdfbin0 -> 32547 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example093.pngbin0 -> 6433 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example093.tex25
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example094.pdfbin0 -> 32642 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example094.pngbin0 -> 5217 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example094.tex23
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example095.pdfbin0 -> 49978 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example095.pngbin0 -> 8694 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example095.tex22
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example096.pdfbin0 -> 58585 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example096.pngbin0 -> 8642 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example096.tex32
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example097.pdfbin0 -> 75552 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example097.pngbin0 -> 9724 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example097.tex36
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example098.pdfbin0 -> 51818 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example098.pngbin0 -> 5106 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example098.tex18
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example099.pdfbin0 -> 30861 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example099.pngbin0 -> 1755 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example099.tex10
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example100.pdfbin0 -> 11481 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example100.pngbin0 -> 1547 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example100.tex20
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example101.pdfbin0 -> 12132 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example101.pngbin0 -> 1089 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example101.tex12
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example102.pdfbin0 -> 12424 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example102.pngbin0 -> 1167 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example102.tex12
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example103.pdfbin0 -> 21279 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example103.pngbin0 -> 1902 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example103.tex20
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example104.pdfbin0 -> 22136 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example104.pngbin0 -> 2937 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example104.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example105.pdfbin0 -> 22136 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example105.pngbin0 -> 2932 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example105.tex21
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example106.pdfbin0 -> 35074 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example106.pngbin0 -> 7821 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example106.tex32
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example107.pdfbin0 -> 25034 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example107.pngbin0 -> 5835 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example107.tex32
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example108.pdfbin0 -> 33689 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example108.pngbin0 -> 6134 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example108.tex34
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example109.pdfbin0 -> 33996 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example109.pngbin0 -> 6867 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example109.tex30
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example110.pdfbin0 -> 33982 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example110.pngbin0 -> 6522 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example110.tex28
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example111.pdfbin0 -> 34676 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example111.pngbin0 -> 7651 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example111.tex28
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example112.pdfbin0 -> 34579 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example112.pngbin0 -> 7310 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example112.tex28
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example113.pdfbin0 -> 50276 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example113.pngbin0 -> 4787 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example113.tex16
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example114.pdfbin0 -> 14950 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example114.pngbin0 -> 1916 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example114.tex19
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115-page1.pngbin0 -> 4306 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115-page2.pngbin0 -> 4315 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115-page3.pngbin0 -> 4519 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115-page4.pngbin0 -> 4332 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115.pdfbin0 -> 36050 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115.tex29
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example116.pdfbin0 -> 16446 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example116.pngbin0 -> 2086 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example116.tex21
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example117.pdfbin0 -> 17940 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example117.pngbin0 -> 4915 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example117.tex38
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example118.pdfbin0 -> 39192 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example118.pngbin0 -> 7922 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example118.tex38
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example119.pdfbin0 -> 81361 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example119.pngbin0 -> 7409 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example119.tex58
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example120.pdfbin0 -> 25036 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example120.pngbin0 -> 4843 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example120.tex25
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example121.pdfbin0 -> 26274 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example121.pngbin0 -> 5925 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example121.tex22
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example122.pdfbin0 -> 26812 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example122.pngbin0 -> 7886 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example122.tex36
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example123-page1.pngbin0 -> 3527 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example123-page2.pngbin0 -> 4260 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example123.pdfbin0 -> 23761 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example123.tex35
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example124.pdfbin0 -> 25960 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example124.pngbin0 -> 6300 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example124.tex42
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example125.pdfbin0 -> 33199 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example125.pngbin0 -> 5633 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example125.tex47
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example126.pdfbin0 -> 35051 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example126.pngbin0 -> 6344 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example126.tex47
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example127.pdfbin0 -> 35051 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example127.pngbin0 -> 6344 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example127.tex56
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example128.pdfbin0 -> 33222 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example128.pngbin0 -> 5571 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example128.tex55
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example129.pdfbin0 -> 35045 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example129.pngbin0 -> 9118 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example129.tex38
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example130.pdfbin0 -> 35491 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example130.pngbin0 -> 8982 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example130.tex54
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example131.pdfbin0 -> 35828 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example131.pngbin0 -> 10600 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example131.tex85
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example132.pdfbin0 -> 44895 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example132.pngbin0 -> 9310 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example132.tex19
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example133.pdfbin0 -> 44961 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example133.pngbin0 -> 9325 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example133.tex19
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example134.pdfbin0 -> 11385 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example134.pngbin0 -> 1544 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example134.tex13
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example135.pdfbin0 -> 11882 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example135.pngbin0 -> 1581 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example135.tex13
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example136.pdfbin0 -> 12709 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example136.pngbin0 -> 4690 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example136.tex17
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example137.pdfbin0 -> 23838 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example137.pngbin0 -> 5891 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example137.tex27
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example138.pdfbin0 -> 23628 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example138.pngbin0 -> 6049 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example138.tex48
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example139.pdfbin0 -> 23651 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example139.pngbin0 -> 6601 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example139.tex52
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example140.pdfbin0 -> 38067 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example140.pngbin0 -> 12115 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example140.tex31
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example141.pdfbin0 -> 11251 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example141.pngbin0 -> 1277 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example141.tex19
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example142.pdfbin0 -> 22391 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example142.pngbin0 -> 2451 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example142.tex20
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example143.pdfbin0 -> 42206 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example143.pngbin0 -> 4447 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example143.tex36
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example144.pdfbin0 -> 42504 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example144.pngbin0 -> 10793 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example144.tex36
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example145.pdfbin0 -> 42513 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example145.pngbin0 -> 10761 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example145.tex48
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example146.pdfbin0 -> 33649 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example146.pngbin0 -> 8671 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example146.tex18
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example147.pdfbin0 -> 55956 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example147.pngbin0 -> 11067 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example147.tex54
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example148.pdfbin0 -> 56111 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example148.pngbin0 -> 11609 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example148.tex54
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example149.pdfbin0 -> 56086 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example149.pngbin0 -> 11982 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example149.tex56
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example150.pdfbin0 -> 28202 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example150.pngbin0 -> 15986 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example150.tex27
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example151.pdfbin0 -> 53938 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example151.pngbin0 -> 12159 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example151.tex85
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example152.pdfbin0 -> 54402 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example152.pngbin0 -> 13362 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example152.tex85
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example153.pdfbin0 -> 54470 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example153.pngbin0 -> 13459 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example153.tex90
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example154.pdfbin0 -> 53695 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example154.pngbin0 -> 9148 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example154.tex92
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example155-page1.pngbin0 -> 4295 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example155-page2.pngbin0 -> 4700 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example155-page3.pngbin0 -> 6935 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example155.pdfbin0 -> 53902 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example155.tex62
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example156-page1.pngbin0 -> 5232 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example156-page2.pngbin0 -> 5402 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example156-page3.pngbin0 -> 6935 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example156.pdfbin0 -> 55073 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example156.tex65
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example157.pdfbin0 -> 23457 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example157.pngbin0 -> 3684 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example157.tex31
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example158.pdfbin0 -> 32323 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example158.pngbin0 -> 5378 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example158.tex29
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example159.pdfbin0 -> 36181 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example159.pngbin0 -> 7477 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example159.tex36
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual.html59749
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual.pdfbin937636 -> 13030615 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra-manual.tex56610
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra.dtx48545
-rw-r--r--macros/latex/contrib/glossaries-extra/glossaries-extra.ins22
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-abbr-styles.pdfbin556783 -> 1518890 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-abbr-styles.tex457
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-abbrv.pdfbin47261 -> 47270 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-accsupp.pdfbin83775 -> 83719 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-acronym-desc.pdfbin53665 -> 53675 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-acronym.pdfbin39238 -> 39250 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-alias.pdfbin46956 -> 46963 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-altmodifier.pdfbin37805 -> 37817 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-alttree-marginpar.pdfbin94528 -> 94465 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-alttree-sym.pdfbin74480 -> 74462 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-alttree.pdfbin58134 -> 58142 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-autoindex-hyp.pdfbin146844 -> 149156 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-autoindex.pdfbin171404 -> 171465 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-crossref.pdfbin44626 -> 44639 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-crossref2.pdfbin44932 -> 44941 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-docdef.pdfbin48575 -> 48584 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-entrycount.pdfbin58659 -> 58668 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-external.pdfbin36681 -> 36692 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-fmt.pdfbin81379 -> 81525 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-footnote.pdfbin68233 -> 68245 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-header.pdfbin135372 -> 134679 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-indexhook.pdfbin46037 -> 46049 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-initialisms.pdfbin87240 -> 87339 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-initialisms.tex2
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-linkcount.pdfbin40764 -> 40775 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-mixed-abbrv-styles.pdfbin62787 -> 62799 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-mixedsort.pdfbin48415 -> 48427 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-mixedsort.tex2
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-mixture.pdfbin168974 -> 169036 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-multientry.pdfbin58332 -> 58340 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-name-font.pdfbin214722 -> 214759 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-nested.pdfbin72395 -> 77642 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-nested.tex8
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-noidx-restricteddocdefs.pdfbin50828 -> 50842 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-onelink.pdfbin25864 -> 47025 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-onthefly-utf8.pdfbin111694 -> 111703 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-onthefly-xetex.pdfbin19669 -> 19653 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-onthefly.pdfbin46363 -> 46373 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-pages.pdfbin41286 -> 41300 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-postdot.pdfbin39556 -> 39563 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-postlink.pdfbin73848 -> 73857 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-prefix.pdfbin35603 -> 43297 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-prefix.tex7
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-record-nameref.pdfbin76219 -> 75683 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-record.pdfbin53514 -> 53524 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-restricteddocdefs.pdfbin51137 -> 51150 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-suppl-hyp.pdfbin37481 -> 37492 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-suppl-main-hyp.pdfbin49663 -> 49673 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-suppl-main.pdfbin34098 -> 34109 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-suppl.pdfbin14247 -> 14259 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-trans.pdfbin53229 -> 53238 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-undef.pdfbin35728 -> 36985 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-undef.tex1
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-unitentrycount.pdfbin64556 -> 65135 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-unitentrycount.tex1
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample.pdfbin48266 -> 48281 bytes
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample.tex4
-rw-r--r--macros/latex/contrib/qrbill/README.md12
-rw-r--r--macros/latex/contrib/qrbill/qrbill.dtx744
-rw-r--r--macros/latex/contrib/qrbill/qrbill.ins3
-rw-r--r--macros/latex/contrib/qrbill/qrbill.pdfbin85725 -> 86369 bytes
578 files changed, 113932 insertions, 57127 deletions
diff --git a/macros/latex/contrib/acmart/Makefile b/macros/latex/contrib/acmart/Makefile
index 44f80ef195..6c120b6afb 100644
--- a/macros/latex/contrib/acmart/Makefile
+++ b/macros/latex/contrib/acmart/Makefile
@@ -135,7 +135,14 @@ archive: all clean
zip: all clean
zip -r $(PACKAGE).zip * -x '*~' -x '*.tgz' -x '*.zip' -x CVS -x 'CVS/*'
-documents.zip: all docclean
- zip -r $@ acmart.pdf acmguide.pdf samples *.cls ACM-Reference-Format.*
+# distros
+distros: all docclean
+ zip -r acm-distro.zip \
+ acmart.pdf acmguide.pdf samples *.cls ACM-Reference-Format.* \
+ --exclude samples/sample-acmengage*
+ zip -r acmengage-distro.zip samples/sample-acmengage* \
+ samples/*.bib \
+ acmart.pdf acmguide.pdf *.cls ACM-Reference-Format.*
+
.PHONY: all ALLSAMPLES docclean clean distclean archive zip
diff --git a/macros/latex/contrib/acmart/README b/macros/latex/contrib/acmart/README
index b84560af24..b30dc5e1fd 100644
--- a/macros/latex/contrib/acmart/README
+++ b/macros/latex/contrib/acmart/README
@@ -12,6 +12,12 @@ The production version is the one on CTAN and ACM sites.
Changes
+Version 1.87 CC license is allowed for non-acm documents and ACM Engage
+ documents only
+ New format acmcp for the cover page
+ New journals: JATS, ACMJCSS, TORS
+ Bug fixes
+
Version 1.86. Empty country in affiliation now produces an error
Bug fixes
New samples for acmengage
diff --git a/macros/latex/contrib/acmart/acmart.dtx b/macros/latex/contrib/acmart/acmart.dtx
index da94d187c5..f8221dcccb 100644
--- a/macros/latex/contrib/acmart/acmart.dtx
+++ b/macros/latex/contrib/acmart/acmart.dtx
@@ -302,14 +302,14 @@
% \normalfont Value & Meaning\\
% \midrule
% manuscript & A manuscript. This is the default. \\
-% acmsmall & Small single-column format. Used for CIE, CSUR,
-% DLT, FAC, GAMES, JACM, JDIQ, JDS, JEA, JERIC,
+% acmsmall & Small single-column format. Used for ACMJCSS, CIE, CSUR,
+% DLT, FAC, GAMES, JACM, JATS, JDIQ, JDS, JEA, JERIC,
% JETC, JRC, PACMCGIT, PACMHCI, PACMPL, TAAS, TACCESS, TACO,
% TALG, TALLIP (formerly TALIP), TCPS, TDS,
% TEAC, TECS, TELO, THRI, TIIS, TIOT, TISSEC, TIST, TKDD, TMIS,
% TOCE, TOCHI, TOCL,
% TOCS, TOCT, TODAES, TODS, TOIS, TOIT, TOMACS, TOMM (formerly
-% TOMCCAP), TOMPECS, TOMS, TOPC, TOPLAS, TOPS,
+% TOMCCAP), TOMPECS, TOMS, TOPC, TOPLAS, TOPS, TORS
% TOS, TOSEM, TOSN, TQC, TRETS,
% TSAS, TSC, TSLP and TWEB, including special issues. \\
% acmlarge & Large single-column format. Used for DTRAP, HEALTH,
@@ -317,10 +317,11 @@
% acmtog & Large double-column format. Used for
% TOG, including annual conference Technical Papers.\\
% sigconf & Proceedings format for most ACM
-% conferences (with the exceptions listed below) and all ICPS
+% conferences (with the exception of SIGPlAN) and all ICPS
% volumes.\\
% sigplan & Proceedings format for SIGPLAN conferences.\\
-%. acmengage & ACM EngageCSEdu Course materials.\\
+% acmengage & ACM EngageCSEdu Course materials.\\
+% acmcp & ACM cover page. \\
% \bottomrule
% \end{tabularx}
% \end{table}
@@ -330,6 +331,9 @@
% If a file uses |sigchi| format, a warning is issued, and the format
% is automatically switched to |sigconf|. Format |sigchi-a| can be
% used for non-ACM documents only (see Section~\ref{sec:sigchi-a}).
+% The format |acmcp| is used for ACM cover pages discussed in
+% Section~\ref{sec:ug_acmcp}.
+%
%
% There are several Boolean options that can take |true| or |false|
% values. They are listed in Table~\ref{tab:opts_bool}. The words
@@ -408,7 +412,8 @@
% Section~\ref{sec:ug_topmatter})\\
% nonacm & false & Use the class typesetting options for
% a non-ACM document, which will not include the conference/journal
-% header and footers or permission statements\\
+% header and footers. Currenly such documents allow only a
+% Creative Commons license.\\
% timestamp & false & Whether to put a time stamp in the
% footer of each page\\
% authordraft & false & Whether author's-draft mode is enabled\\
@@ -1000,6 +1005,8 @@
% \verb|\setcopyright{acmcopyright}|. The possible values for this
% command are listed in Table~\ref{tab:setcopyright}. This command
% must be placed in the preamble, before |\begin{document}|.
+% Additional information about ACM copyright rules is discussed in
+% Section~\ref{ug_cc}.
%
% \begin{table}
% \centering
@@ -1043,7 +1050,9 @@
% by IW3C2, when some authors are approved Google employees.\\
% \texttt{cc} & Creative Commons license. If this key is set,
% \textsl{doclicense} images are used to typeset the license. See
-% also \cs{setcctype} command.\\
+% also \cs{setcctype} command. Note that at present this license
+% can be used only for \texttt{acmengage} format or for
+% \texttt{nonacm} publications.\\
% \bottomrule
% \end{tabularx}
% \end{table}
@@ -1164,9 +1173,9 @@
% is |Received| for the first date and |revised| for the subsequent
% ones. For example,
% \begin{verbatim}
-% \received{February 2007}
-% \received[revised]{March 2009}
-% \received[accepted]{June 2009}
+% \received{20 February 2007}
+% \received[revised]{12 March 2009}
+% \received[accepted]{5 June 2009}
% \end{verbatim}
%
%
@@ -1211,6 +1220,58 @@
% Note that the type of Creative Commons license, if such license is
% used, is automatically added to the metadata.
%
+%
+%\subsection{ACM cover page}
+%\label{sec:ug_acmcp}
+%
+% ACM cover pages are forms of extended abstracts that are added to
+% journals at the late stage. Authors prepare them as separate
+% \texttt{.tex} files using |acmcp| format. At present only JDS uses
+% them, but in the future this may change.
+%
+% There are several top matter commands specific for this format.
+%
+% \DescribeMacro{\acmArticleType}%
+% There are five article types accepted by JDS: \emph{Research} (the
+% default), \emph{Review}, \emph{Discussion}, \emph{Invited}, and
+% \emph{Position}. The command \cs{acmArticleType}\marg{type} sets the
+% article type, for example
+% \begin{verbatim}
+% \acmArticleType{Review}
+% \end{verbatim}
+%
+% \DescribeMacro{\acmCodeLink}%
+% \DescribeMacro{\acmDataLink}%
+% The commands \cs{acmCodeDataLink}\marg{link} and
+% \cs{acmDataLink}\marg{link} set the links to the data and code
+% accompanying the paper, for example,
+% \begin{verbatim}
+% \acmCodeLink{https://github.com/repository/code}
+% \acmDataLink{https://datadryad.org/stash/dataset/doi:DOI}
+% \end{verbatim}
+% You may repeat these commands if you have several repositories.
+%
+%
+% ACM cover page should have the following obligatory sections:
+% \begin{itemize}
+% \item Problem statement,
+% \item Methods,
+% \item Results,
+% \item Significance.
+% \end{itemize}
+%
+% Sometimes the addresses extracted from the authors' data are too
+% long to fit on the page. In this case the command
+% \cs{authorsaddresses} can be use to override them, for example,
+% \begin{verbatim}
+% \authorsaddresses{Corresponding author: Ben Trovato,
+% \href{mailto:trovato@corporation.com}{trovato@corporation.com};
+% Institute for Clarity in Documentation, P.O. Box 1212, Dublin,
+% Ohio, USA, 43017-6221}
+% \end{verbatim}
+%
+%
+%
%\subsection{Internationalization}
%\label{sec:ug_i13n}
%
@@ -1908,6 +1969,29 @@
% document.
%
%
+%\subsection{Creative Commons licenses for ACM publications}
+%\label{sec:ug_cc}
+%
+% At present ACM does not allow the authors to typeset Creative
+% Commons license for most ACM publications. These licenses can be
+% used under an agreement with the ACM publishing office. In this
+% case they are inserted by ACM itself.
+%
+% The exceptions are ACM Engage format, which allows Creative Commons
+% license, and conferences organized and copyrighted by IW3C2. In
+% these cases the authors should use correspondingly
+% |\setcopyright{cc}|, |\setcopyright{iw3c2w3}|, or
+% |\setcopyright{iw3c2w3g}| (the latter should be used by Google
+% employees).
+%
+% Yet another case is the typesetting of non-ACM materials, when the
+% option |nonacm| is used. This case is somewhat opposite, because
+% for this case \emph{only} Creative Common licenses are supported.
+%
+% The command |\setcopyright{cc}| produces an error unless the format is
+% |acmengage| or |nonacm| option is selected. On the other hand, if
+% the option |nonacm| is selected, any argument of |\setcopyright|
+% other than |cc| is treated as |none|.
%
%
%\subsection{Disabled or forbidden commands}
@@ -1999,7 +2083,8 @@
% \midrule
% \endhead
% \bottomrule
-% \endfoot
+% \endfoot
+% ACMJCSS & ACM Journal on Computing and Sustainable Societies \\
% CIE & ACM Computers in Entertainment \\
% CSUR & ACM Computing Surveys\\
% DLT & Distributed Ledger Technologies: Research and Practice\\
@@ -2011,6 +2096,7 @@
% IMWUT & PACM on Interactive, Mobile, Wearable and Ubiquitous
% Technologies\\
% JACM & Journal of the ACM \\
+% JATS & ACM Journal on Autonomous Transportation Systems \\
% JDIQ & ACM Journal of Data and Information Quality \\
% JDS & ACM/IMS Journal of Data Science \\
% JEA & ACM Journal of Experimental Algorithmics \\
@@ -2061,6 +2147,7 @@
% TOPC & ACM Transactions on Parallel Computing\\
% TOPLAS & ACM Transactions on Programming Languages and Systems\\
% TOPS & ACM Transactions on Privacy and Security\\
+% TORS & ACM Transactions on Recommender Systems\\
% TOS & ACM Transactions on Storage\\
% TOSEM & ACM Transactions on Software Engineering and Methodology\\
% TOSN & ACM Transactions on Sensor Networks\\
@@ -2142,7 +2229,7 @@
\ProvidesFile{acmart.dtx}
%</gobble>
%<class>\ProvidesClass{acmart}
-[2022/06/26 v1.86 Typesetting articles for the Association for Computing Machinery]
+[2022/10/18 v1.87 Typesetting articles for the Association for Computing Machinery]
% \end{macrocode}
%
% \changes{v1.00}{2016/04/14}{First released version}
@@ -2252,6 +2339,7 @@
% \changes{1.78}{2021/05/01}{Documentation update: Word count}
% \changes{1.84}{2022/04/09}{New journals: JDS, GAMES}
% \changes{1.85}{2022/05/08}{Added CC licenses}
+% \changes{1.87}{2022/08/02}{New format: |acmcp|}
%
% And the driver code:
% \begin{macrocode}
@@ -2310,11 +2398,12 @@
%
% \begin{macro}{format}
% \changes{1.85}{2022/05/08}{New format: acmengage}
+% \changes{1.87}{2022/08/13}{New format: acmcp}
% The possible formats
% \begin{macrocode}
\define@choicekey*+{acmart.cls}{format}[\ACM@format\ACM@format@nr]{%
manuscript, acmsmall, acmlarge, acmtog, sigconf, siggraph,
- sigplan, sigchi, sigchi-a, acmengage}[manuscript]{}{%
+ sigplan, sigchi, sigchi-a, acmengage, acmcp}[manuscript]{}{%
\ClassError{\@classname}{The option format must be manuscript,
acmsmall, acmlarge, acmtog, sigconf, siggraph,
sigplan, sigchi or sigchi-a}}
@@ -2329,6 +2418,7 @@
\@DeclareACMFormat{sigchi}
\@DeclareACMFormat{sigchi-a}
\@DeclareACMFormat{acmengage}
+\@DeclareACMFormat{acmcp}
\ExecuteOptionsX{format}
% \end{macrocode}
%
@@ -2539,7 +2629,9 @@
% \begin{macro}{\ACM@fontsize}
% The font size to pass to the base class
% \begin{macrocode}
+% \changes{v1.87}{2022/08/27}{Added fontsize 8pt}
\def\ACM@fontsize{}
+\DeclareOptionX{8pt}{\edef\ACM@fontsize{\CurrentOption}}
\DeclareOptionX{9pt}{\edef\ACM@fontsize{\CurrentOption}}
\DeclareOptionX{10pt}{\edef\ACM@fontsize{\CurrentOption}}
\DeclareOptionX{11pt}{\edef\ACM@fontsize{\CurrentOption}}
@@ -2626,6 +2718,19 @@
%
% \end{macro}
%
+% \begin{macro}{\if@ACM@acmcp}
+% \changes{v1.87}{2022/08/12}{Introduced macro}
+% ACM cover page formatting
+% \begin{macrocode}
+\newif\if@ACM@acmcp
+\@ACM@acmcpfalse
+% \end{macrocode}
+%
+% \end{macro}
+%
+%
+%
+%
% Setting up switches
% \begin{macrocode}
\ifnum\ACM@format@nr=5\relax % siggraph
@@ -2682,6 +2787,10 @@
\or % acmengage
\@ACM@journalfalse
\@ACM@engagetrue
+\or % acmcp
+ \@ACM@journaltrue
+ \@ACM@acmcptrue
+ \AtBeginDocument{\@ACM@printacmreffalse}%
\fi
\if@ACM@journal
\@ACM@journal@bibstriptrue
@@ -2697,6 +2806,7 @@
%
% \changes{v1.13}{2016/06/06}{Increased font size for ACM Large}
% \changes{v1.38}{2017/05/13}{Increase default font size for SIGPLAN}
+% \changes{v1.87}{2022/08/27}{Set font sizes for |acmengage| and |acmcp|}
%
%
% At this point we either have \cs{ACM@fontsize} or use defaults
@@ -2721,6 +2831,10 @@
\def\ACM@fontsize{9pt}%
\or % sigchi-a
\def\ACM@fontsize{10pt}%
+ \or % acmengage
+ \def\ACM@fontsize{10pt}%
+ \or % acmcp
+ \def\ACM@fontsize{9pt}%
\fi
\fi
\ClassInfo{\@classname}{Using fontsize \ACM@fontsize}
@@ -2768,6 +2882,13 @@
% \end{macrocode}
%
%
+% \changes{v1.87}{2022/08/14}{Added `framed' package for acmcp}
+% \begin{macrocode}
+\if@ACM@acmcp
+\RequirePackage{framed}
+\fi
+% \end{macrocode}
+%
%
%
%
@@ -3327,6 +3448,7 @@
\or % sigchi-a
\urlstyle{sf}
\or % acmengage
+\or % acmcp
\fi
\AtEndPreamble{%
\if@ACM@urlbreakonhyphens
@@ -3521,6 +3643,13 @@
top=57pt, bottom=73pt, inner=54pt, outer=54pt,
marginparwidth=2pc,heightrounded
}%
+\or % acmcp
+ \geometry{twoside=true,
+ includeheadfoot, head=13pt, foot=2pc,
+ paperwidth=6.75in, paperheight=10in,
+ top=58pt, bottom=44pt, inner=46pt, outer=46pt,
+ marginparwidth=2pc,heightrounded
+ }%
\fi
% \end{macrocode}
%
@@ -3544,6 +3673,7 @@
\or % sigchi
\or % sigchi-a
\or % acmengage
+\or % acmcp
\fi
% \end{macrocode}
%
@@ -3652,6 +3782,8 @@
\or % sigchi-a
\or % acmengage
\flushbottom
+\or % acmcp
+ \flushbottom
\fi
% \end{macrocode}
%
@@ -3878,6 +4010,7 @@
\captionsetup[table]{labelfont={bf, small},
textfont={bf, small}}
\or % acmengage
+ \or % acmcp
\fi
\fi
% \end{macrocode}
@@ -4029,6 +4162,7 @@
\or % sigchi
\or % sigchi-a
\or % acmengage
+\or % acmcp
\fi
% \end{macrocode}
%
@@ -4142,11 +4276,13 @@
% several journals}
% \changes{1.84}{2022/04/09}{New journals: JDS, GAMES}
% \changes{1.85}{2022/05/08}{New journal: JRC}
+% \changes{1.85}{2022/10/18}{New journals: ACMJCSS, JATS, TORS}
%
% We use the |xkeyval| interface to define journal titles and the relevant
% information
% \begin{macrocode}
\define@choicekey*+{ACM}{acmJournal}[\@journalCode\@journalCode@nr]{%
+ ACMJCSS,%
CIE,%
CSUR,%
DGOV,%
@@ -4157,6 +4293,7 @@
HEALTH,%
IMWUT,%
JACM,%
+ JATS,%
JDIQ,%
JDS,%
JEA,%
@@ -4203,6 +4340,7 @@
TOPC,%
TOPS,%
TOPLAS,%
+ TORS,%
TOS,%
TOSEM,%
TOSN,%
@@ -4215,7 +4353,11 @@
FACMP%
}{%
\ifcase\@journalCode@nr
-\relax % CIE
+\relax % ACMJCSS
+ \def\@journalName{ACM Journal on Computing and Sustainable Societies}%
+ \def\@journalNameShort{ACM J. Comput. Sustain. Soc.}%
+ \def\@permissionCodeOne{}%
+\or % CIE
\def\@journalName{ACM Computers in Entertainment}%
\def\@journalNameShort{ACM Comput. Entertain.}%
\def\@permissionCodeOne{1544-3574}%
@@ -4258,6 +4400,10 @@
\def\@journalName{Journal of the ACM}%
\def\@journalNameShort{J. ACM}%
\def\@permissionCodeOne{0004-5411}%
+\or % JATS
+ \def\@journalName{Journal on Autonomous Transportation Systems}%
+ \def\@journalNameShort{ACM J. Auton. Transport. Syst.}%
+ \def\@permissionCodeOne{2833-0528}%
\or % JDIQ
\def\@journalName{ACM Journal of Data and Information Quality}%
\def\@journalNameShort{ACM J. Data Inform. Quality}%
@@ -4446,7 +4592,8 @@
\or % TOPC
\def\@journalName{ACM Transactions on Parallel Computing}%
\def\@journalNameShort{ACM Trans. Parallel Comput.}%
- \def\@permissionCodeOne{1539-9087}%
+ \def\@permissionCodeOne{2329-4949}%
+ \def\@permissionCodeTwo{2329-4957}%
\or % TOPS
\def\@journalName{ACM Transactions on Privacy and Security}%
\def\@journalNameShort{ACM Trans. Priv. Sec.}%
@@ -4455,6 +4602,10 @@
\def\@journalName{ACM Transactions on Programming Languages and Systems}%
\def\@journalNameShort{ACM Trans. Program. Lang. Syst.}%
\def\@permissionCodeOne{0164-0925}%
+\or % TORS
+ \def\@journalName{ACM Transactions on Recommender Systems}%
+ \def\@journalNameShort{ACM Trans. Recomm. Syst.}%
+ \def\@permissionCodeOne{2770-6699}%
\or % TOS
\def\@journalName{ACM Transactions on Storage}%
\def\@journalNameShort{ACM Trans. Storage}%
@@ -5282,6 +5433,67 @@
%
% \end{macro}
%
+% \begin{macro}{\acmArticleType}
+% \changes{v1.87}{2022/08/13}{Introduced macro}
+% Article type. We set up the color.
+% \begin{macrocode}
+\define@choicekey+{ACM}{articletype}[\ACM@ArticleType\ACM@ArticleType@nr]{%
+ Research,Review,Discussion,Invited,Position}[Review]{%
+ \ifcase\ACM@ArticleType@nr
+ \relax % Research
+ \colorlet{@ACM@Article@color}{ACMBlue}%
+ \or % Review
+ \colorlet{@ACM@Article@color}{ACMOrange}%
+ \or % Discussion
+ \colorlet{@ACM@Article@color}{ACMGreen}%
+ \or % Invited
+ \colorlet{@ACM@Article@color}{ACMPurple}%
+ \or % Position
+ \colorlet{@ACM@Article@color}{ACMRed}%
+ \fi
+}{%
+ \ClassError{\@classname}{Article Type must be Research, Review,\MessageBreak
+ Discussion, Invited, or Position}}
+\def\acmArticleType#1{\setkeys{ACM}{articletype=#1}}
+\newenvironment{@ACM@color@frame}{%
+ \def\FrameCommand{\hspace*{-6.5pc}%
+ \colorbox{@ACM@Article@color!10!white}}%
+ \MakeFramed {\advance\hsize -6.5pc\relax\FrameRestore}}{\endMakeFramed}
+\if@ACM@acmcp
+\acmArticleType{Research}%
+\fi
+% \end{macrocode}
+%
+% \end{macro}
+%
+% \begin{macro}{\acmCodeLink}
+% \changes{v1.87}{2022/08/13}{Introduced macro}
+% \changes{v1.87}{2022/08/28}{Added possibility to have several links}
+% The code link
+% \begin{macrocode}
+\def\acmCodeLink#1{%
+ \ifx\@acmCodeDataLink\@empty
+ \gdef\@acmCodeDataLink{\url{#1}}%
+ \else
+ \g@addto@macro{\@acmCodeDataLink}{\\ \url{#1}}%
+ \fi}
+\def\@acmCodeDataLink{}
+% \end{macrocode}
+%
+% \end{macro}
+%
+% \begin{macro}{\acmDataLink}
+% \changes{v1.87}{2022/08/13}{Introduced macro}
+% \changes{v1.87}{2022/08/28}{Now this is the same as the code link}
+% The code link
+% \begin{macrocode}
+\let\acmDataLink\acmCodeLink
+% \end{macrocode}
+%
+% \end{macro}
+%
+%
+%
%\subsection{Concepts system}
%\label{sec:concepts}
%
@@ -5547,12 +5759,40 @@
%
% \end{macro}
%
+% \begin{macro}{\@ACM@copyright@check@cc}
+% \changes{v1.87}{2022/07/30}{Added macro}
+% At present cC licenses can be used only for acmengage format or for
+% non-acm stuff. This macro checks whether the CC license is
+% applicable and generates an error if not.
+% \begin{macrocode}
+\def\@ACM@copyright@check@cc{%
+ \if@ACM@nonacm
+ \ClassInfo{\@classname}{Using CC license with a non-acm
+ material}%
+ \else
+ \if@ACM@engage
+ \ClassInfo{\@classname}{Using CC license with ACM Enage
+ material}%
+ \else
+ \ClassError{\@classname}{%
+ Sorry, Creative Commons licenses are\MessageBreak
+ currently not used with ACM publications\MessageBreak
+ typeset by the authors}{Please use nonacm
+ option or ACM Engage class to enable CC licenses}%
+ \fi
+ \fi}
+% \end{macrocode}
+%
+% \end{macro}
+%
% \begin{macro}{\@copyrightpermission}
% \changes{v1.40}{2017/06/16}{Added new copyright version: licensedcagov}
% \changes{v1.50}{2018/02/07}{New copyright statements for iw3c2w3[g]}
% \changes{v1.52}{2018/04/09}{Another rewording of copyright
% statements for iw3c2w3[g]}
% \changes{v1.85}{2022/05/08}{Added CC licenses}
+% \changes{v1.87}{2022/07/30}{CC licenses now are allowed only for
+% non-acm or ACM engage publications}
% The canned permission block.
% \begin{macrocode}
\def\@copyrightpermission{%
@@ -5678,6 +5918,7 @@
disseminate the work on their personal and corporate Web sites with
the appropriate attribution.
\or % CC
+ \@ACM@copyright@check@cc
\IfEq{\ACM@cc@type}{zero}{%
\def\ACM@CC@Url{https://creativecommons.org/publicdomain/zero/1.0/legalcode}}{%
\edef\ACM@CC@Url{https://creativecommons.org/licenses/\ACM@cc@type/\ACM@cc@version/legalcode}}%
@@ -5867,6 +6108,7 @@
% \changes{v1.76}{2021/04/05}{Put \cs{par} inside group for keywords}
% \changes{v1.83}{2022/02/20}{I13n}
% \changes{v1.85}{2022/05/08}{acmengage}
+% \changes{v1.87}{2022/07/30}{CC license are allowed for non-acm publications}
% The (in)famous \cs{maketitle}. Note that in |sigchi-a| mode, authors
% are \emph{not} in the title box.
%
@@ -5904,15 +6146,23 @@
\footnotetextauthorsaddresses{%
\def\par{\let\par\@par}\parindent\z@\@setthanks}%
\fi
- \ifx\@empty\@authorsaddresses\else
- \if@ACM@anonymous\else
- \if@ACM@journal@bibstrip
- \footnotetextauthorsaddresses{%
- \def\par{\let\par\@par}\parindent\z@\@setauthorsaddresses}%
+ \if@ACM@acmcp\else
+ \ifx\@empty\@authorsaddresses\else
+ \if@ACM@anonymous\else
+ \if@ACM@journal@bibstrip
+ \footnotetextauthorsaddresses{%
+ \def\par{\let\par\@par}\parindent\z@\@setauthorsaddresses}%
+ \fi
\fi
- \fi
+ \fi
\fi
- \if@ACM@nonacm\else\footnotetextcopyrightpermission{%
+ \if@ACM@nonacm
+ \ifnum\acm@copyrightmode=15\relax % cc
+ \footnotetextcopyrightpermission{\@copyrightpermission}%
+ \fi
+ \else
+ \if@ACM@acmcp\else
+ \footnotetextcopyrightpermission{%
\if@ACM@authordraft
\raisebox{-2ex}[\z@][\z@]{\makebox[0pt][l]{\large\bfseries
Unpublished working draft. Not for distribution.}}%
@@ -5966,7 +6216,8 @@
\fi
\fi
\fi
- \fi}
+ \fi}%
+ \fi
\fi
\endgroup
\if@ACM@engage\@typesetengagemetadata\fi
@@ -5980,12 +6231,14 @@
\noindent\@concepts\par}\egroup
\fi
\fi
- \ifx\@keywords\@empty\else\bgroup
- {\@specialsection{\keywordsname}%
- \noindent\@keywords\par}\egroup
- \fi
- \ifx\@translatedkeywords\@empty\else
- \@translatedkeywords
+ \if@ACM@acmcp\else
+ \ifx\@keywords\@empty\else\bgroup
+ {\@specialsection{\keywordsname}%
+ \noindent\@keywords\par}\egroup
+ \fi
+ \ifx\@translatedkeywords\@empty\else
+ \@translatedkeywords
+ \fi
\fi
\let\metadata@authors=\authors
\nxandlist{, }{, }{, }\metadata@authors
@@ -6012,11 +6265,43 @@
\@printendtopmatter
\@afterindentfalse
\@afterheading
+ \if@ACM@acmcp
+ \set@ACM@acmcpbox
+ \AtEndDocument{\end@ACM@color@frame}%
+ \@ACM@color@frame
+ \fi
}
% \end{macrocode}
%
% \end{macro}
%
+% \begin{macro}{\set@ACM@acmcpbox}
+% \changes{v1.87}{2022/08/14}{Added macro}
+% Setting infobox for acmcp
+% \begin{macrocode}
+\newbox\@ACM@acmcpbox
+\def\set@ACM@acmcpbox{%
+ \bgroup
+ \hsize=5pc
+ \global\setbox\@ACM@acmcpbox=\vtop to \textheight{%
+ \setlength{\parindent}{\z@}%
+ {\Large LOGO\par}%
+ \scriptsize
+ \vfill
+ \ifx\@acmCodeDataLink\@empty\else
+ Code and data links:\\ \@acmCodeDataLink\par\vfill
+ \fi
+ \ifx\@keywords\@empty\else Keywords:
+ \@keywords\par\vfill
+ \fi
+ \ifx\@empty\@authorsaddresses\else\@setauthorsaddresses\vfill\fi
+ }
+\egroup}
+% \end{macrocode}
+%
+% \end{macro}
+%
+%
% \begin{macro}{\@specialsection}
% \changes{v1.66}{2019/11/23}{Suppress warnings about \cs{vspace}}
% \changes{v1.67}{2020/01/11}{Paragraph inside group does not print
@@ -6051,6 +6336,8 @@
\section*{#1}%
\or % acmengage
\section*{#1}%
+ \or % acmcp
+ \section*{#1}%
\fi
\let\@vspace\@vspace@acm
\let\@vspacer\@vspacer@acm
@@ -6126,6 +6413,8 @@
\fi
\or % acmengage
\twocolumn[\box\mktitle@bx]%
+ \or % acmcp
+ \box\mktitle@bx\par
\fi
}
% \end{macrocode}
@@ -6158,6 +6447,8 @@
\@mktitle@iv
\or % acmengage
\@mktitle@iii
+ \or % acmcp
+ \@mktitle@i
\fi
}
% \end{macrocode}
@@ -6193,6 +6484,8 @@
\Huge\bfseries
\or % acmengage
\Huge\sffamily\bfseries
+ \or % acmcp
+ \LARGE\sffamily\bfseries
\fi}
% \end{macrocode}
%
@@ -6226,6 +6519,8 @@
\mdseries
\or % acmengage
\LARGE\mdseries
+ \or % acmcp
+ \mdseries
\fi}
% \end{macrocode}
%
@@ -6236,9 +6531,13 @@
% \changes{v1.06}{2016/05/01}{Added processing badges}
% \changes{v1.83}{2022/02/20}{Added \cs{translatedtitle} and
% \cs{translatedsubtitle}}
+% \changes{v1.87}{2022/08/14}{Special treatment for acmcp}
% The version of \cs{mktitle} for most journals
% \begin{macrocode}
\def\@mktitle@i{\hsize=\textwidth
+ \if@ACM@acmcp
+ \advance\hsize by -6pc%
+ \fi
\@ACM@title@width=\hsize
\ifx\@acmBadgeL@image\@empty\else
\advance\@ACM@title@width by -\@ACM@badge@width
@@ -6465,6 +6764,8 @@
\@mkauthors@iv
\or % acmengage
\@mkauthors@iii
+ \or % acmcp
+ \@mkauthors@i
\fi
\endgroup
}
@@ -6518,6 +6819,9 @@
\or % acmengage
\def\@authorfont{\LARGE}
\def\@affiliationfont{\large}
+\or % acmcp
+ \def\@authorfont{\large\sffamily}
+ \def\@affiliationfont{\small\normalfont}
\fi
% \end{macrocode}
%
@@ -6615,6 +6919,7 @@
% \changes{v1.78}{2021/05/16}{Unboxing \cs{mktitle@bx}}
% This version is used in most journal formats. Note that \cs{and} between
% authors with the same affiliation becomes \verb*| and |:
+% \changes{v1.87}{2022/08/14}{Special treatment for acmcp}
% \begin{macrocode}
\def\@mkauthors@i{%
\def\@currentauthors{}%
@@ -6644,6 +6949,9 @@
\fi
\fi
\global\let\and\@typeset@author@line}%
+ \if@ACM@acmcp
+ \advance\hsize by -6pc%
+ \fi
\global\setbox\mktitle@bx=\vbox{\noindent\unvbox\mktitle@bx\par\medskip
\noindent\addresses\@typeset@author@line
\par\medskip}%
@@ -7181,6 +7489,8 @@
\ACM@mk@linecount
\or % acmengage
\ACM@mk@linecount
+ \or % acmcp
+ \relax
\fi
\begin{picture}(0,0)%
\put(20,-22){\usebox{\ACM@linecount@bx}}%
@@ -7263,6 +7573,7 @@
% \changes{v1.76}{2021/02/21}{Fixed bug with no line numbers for
% nonacm}
% \changes{v1.86}{2022/06/26}{Special treatment of ACM Engage materials}
+% \changes{v1.87}{2022/08/14}{Special treatment of ACMCP}
% The page style for all pages but the first one
% \begin{macrocode}
\AtBeginDocument{%
@@ -7371,6 +7682,21 @@
\if@ACM@timestamp
\fancyfoot[LO,RE]{\ACM@timestamp}
\fi
+ \if@ACM@acmcp
+ \renewcommand{\footrulewidth}{0.1\p@}%
+ \fancyheadoffset[L]{46pt}%
+ \fancyhead[L]{\makebox[\z@][l]{%
+ \raisebox{-\dimexpr(0.25\textheight*\ACM@ArticleType@nr)}{%
+ \rotatebox{90}{\colorbox{@ACM@Article@color}{\color{white}%
+ \strut\ACM@ArticleType~Article}}}}%
+ \ACM@linecountL}%
+ \fancyhead[R]{\makebox[\z@][r]{\box\@ACM@acmcpbox}}%
+ \fancyfoot[L,C]{}%
+ \fancyfoot[R]{\footnotesize
+ \@journalName, Volume~\@acmVolume, Issue~\@acmNumber,
+ \ifx\@acmArticle\@empty\else Article~\@acmArticle\fi\space
+ (\@acmPubDate)\ifx\@acmDOI\@empty\else\\\@formatdoi{\@acmDOI}\fi}
+ \fi
}%
\pagestyle{standardpagestyle}
}
@@ -7448,6 +7774,8 @@
%
% \end{macro}
%
+%
+%
% \begin{macro}{firstpagestyle}
% \changes{v1.33}{2017/03/10}{Added timestamp (Michael D.~Adams)}
% \changes{v1.33}{2017/03/29}{Added right linecount for two-column
@@ -7457,6 +7785,7 @@
% \changes{v1.59}{2019/04/20}{Added logic for conference papers using
% journal format}
% \changes{v1.59}{2019/04/20}{Moved page styles to \cs{AtBeginDocument}}
+% \changes{v1.87}{2022/08/14}{Special treatment for acmcp}
% The page style for the first page only.
% \begin{macrocode}
\AtBeginDocument{%
@@ -7520,6 +7849,21 @@
\fancyfoot[LO,RE]{\ACM@timestamp}
\fi
\fi
+ \if@ACM@acmcp
+ \renewcommand{\footrulewidth}{0.1\p@}%
+ \fancyheadoffset[L]{46pt}%
+ \fancyhead[L]{\makebox[\z@][l]{%
+ \raisebox{-\dimexpr(0.25\textheight*\ACM@ArticleType@nr)}{%
+ \rotatebox{90}{\colorbox{@ACM@Article@color}{\color{white}%
+ \strut\ACM@ArticleType~Article}}}}%
+ \ACM@linecountL}%
+ \fancyhead[R]{\makebox[\z@][r]{\box\@ACM@acmcpbox}}%
+ \fancyfoot[L,C]{}%
+ \fancyfoot[R]{\footnotesize
+ \@journalName, Volume~\@acmVolume, Issue~\@acmNumber,
+ \ifx\@acmArticle\@empty\else Article~\@acmArticle\fi\space
+ (\@acmPubDate)\ifx\@acmDOI\@empty\else\\\@formatdoi{\@acmDOI}\fi}
+ \fi
}}
% \end{macrocode}
%
@@ -7529,6 +7873,7 @@
%\subsection{Sectioning}
%\label{sec:sectioninng}
%
+%
% \begin{macro}{\ACM@NRadjust}
% \changes{v1.54}{2018/06/17}{Added macro}
% Ross Moore's macro.
@@ -7700,6 +8045,7 @@
\or % acmengage
\def\@secfont{\bfseries\Large\section@raggedright\MakeTextUppercase}
\def\@subsecfont{\bfseries\Large\section@raggedright}
+\or %acmcp
\fi
% \end{macrocode}
%
@@ -7724,6 +8070,14 @@
%
% \end{macro}
%
+% \changes{v1.87}{2022/08/14}{No numbering sections for ACMCP}
+% \begin{macrocode}
+\if@ACM@acmcp
+ \setcounter{secnumdepth}{-1}%
+\fi
+% \end{macrocode}
+%
+%
%\subsection{TOC lists}
%\label{sec:tocs}
%
@@ -7792,6 +8146,7 @@
\or % sigchi
\or % sigchi-a
\or % acmengage
+\or % acmcp
\fi
% \end{macrocode}
%
@@ -7863,6 +8218,7 @@
\or % sigchi
\or % sigchi-a
\or % acmengage
+\or % acmcp
\fi
% \end{macrocode}
%
@@ -7962,6 +8318,7 @@
\or % sigchi
\or % sigchi-a
\or % acmengage
+\or % acmcp
\fi
% \end{macrocode}
%
@@ -8010,6 +8367,7 @@
\or % sigchi-a
\or % acmengage
\RequirePackage{pbalance}%
+ \or % acmcp
\fi
\fi
\if@ACM@balance
@@ -8034,6 +8392,8 @@
\global\@ACM@balancefalse
\or % acmengage
\RequirePackage{balance}%
+ \or % acmcp
+ \global\@ACM@balancefalse
\fi
\fi
}
diff --git a/macros/latex/contrib/acmart/acmart.pdf b/macros/latex/contrib/acmart/acmart.pdf
index d7d29d8279..606574db26 100644
--- a/macros/latex/contrib/acmart/acmart.pdf
+++ b/macros/latex/contrib/acmart/acmart.pdf
Binary files differ
diff --git a/macros/latex/contrib/acmart/acmguide.pdf b/macros/latex/contrib/acmart/acmguide.pdf
index 2c96654fa5..70313fded3 100644
--- a/macros/latex/contrib/acmart/acmguide.pdf
+++ b/macros/latex/contrib/acmart/acmguide.pdf
Binary files differ
diff --git a/macros/latex/contrib/acmart/samples/sample-acmcp.pdf b/macros/latex/contrib/acmart/samples/sample-acmcp.pdf
new file mode 100644
index 0000000000..c3993bfd61
--- /dev/null
+++ b/macros/latex/contrib/acmart/samples/sample-acmcp.pdf
Binary files differ
diff --git a/macros/latex/contrib/acmart/samples/sample-acmengage.pdf b/macros/latex/contrib/acmart/samples/sample-acmengage.pdf
index f9caa582b9..6c12412fcd 100644
--- a/macros/latex/contrib/acmart/samples/sample-acmengage.pdf
+++ b/macros/latex/contrib/acmart/samples/sample-acmengage.pdf
Binary files differ
diff --git a/macros/latex/contrib/acmart/samples/sample-acmlarge.pdf b/macros/latex/contrib/acmart/samples/sample-acmlarge.pdf
index 1d17b01c8e..606a977bda 100644
--- a/macros/latex/contrib/acmart/samples/sample-acmlarge.pdf
+++ b/macros/latex/contrib/acmart/samples/sample-acmlarge.pdf
Binary files differ
diff --git a/macros/latex/contrib/acmart/samples/sample-acmsmall-biblatex.pdf b/macros/latex/contrib/acmart/samples/sample-acmsmall-biblatex.pdf
index 71f6045226..cbb483fe0b 100644
--- a/macros/latex/contrib/acmart/samples/sample-acmsmall-biblatex.pdf
+++ b/macros/latex/contrib/acmart/samples/sample-acmsmall-biblatex.pdf
Binary files differ
diff --git a/macros/latex/contrib/acmart/samples/sample-acmsmall-conf.pdf b/macros/latex/contrib/acmart/samples/sample-acmsmall-conf.pdf
index 72f5f4d98d..02ac97731e 100644
--- a/macros/latex/contrib/acmart/samples/sample-acmsmall-conf.pdf
+++ b/macros/latex/contrib/acmart/samples/sample-acmsmall-conf.pdf
Binary files differ
diff --git a/macros/latex/contrib/acmart/samples/sample-acmsmall-submission.pdf b/macros/latex/contrib/acmart/samples/sample-acmsmall-submission.pdf
index a01026bcb6..776edd55f0 100644
--- a/macros/latex/contrib/acmart/samples/sample-acmsmall-submission.pdf
+++ b/macros/latex/contrib/acmart/samples/sample-acmsmall-submission.pdf
Binary files differ
diff --git a/macros/latex/contrib/acmart/samples/sample-acmsmall.pdf b/macros/latex/contrib/acmart/samples/sample-acmsmall.pdf
index a966e4d256..b996692fa2 100644
--- a/macros/latex/contrib/acmart/samples/sample-acmsmall.pdf
+++ b/macros/latex/contrib/acmart/samples/sample-acmsmall.pdf
Binary files differ
diff --git a/macros/latex/contrib/acmart/samples/sample-acmtog.pdf b/macros/latex/contrib/acmart/samples/sample-acmtog.pdf
index d42901423d..e3512e0b46 100644
--- a/macros/latex/contrib/acmart/samples/sample-acmtog.pdf
+++ b/macros/latex/contrib/acmart/samples/sample-acmtog.pdf
Binary files differ
diff --git a/macros/latex/contrib/acmart/samples/sample-authordraft.pdf b/macros/latex/contrib/acmart/samples/sample-authordraft.pdf
index 654952f224..efcebebee7 100644
--- a/macros/latex/contrib/acmart/samples/sample-authordraft.pdf
+++ b/macros/latex/contrib/acmart/samples/sample-authordraft.pdf
Binary files differ
diff --git a/macros/latex/contrib/acmart/samples/sample-lualatex.pdf b/macros/latex/contrib/acmart/samples/sample-lualatex.pdf
index a488510535..54d7f0fae7 100644
--- a/macros/latex/contrib/acmart/samples/sample-lualatex.pdf
+++ b/macros/latex/contrib/acmart/samples/sample-lualatex.pdf
Binary files differ
diff --git a/macros/latex/contrib/acmart/samples/sample-manuscript.pdf b/macros/latex/contrib/acmart/samples/sample-manuscript.pdf
index 7ab5447a4f..b51259c8ba 100644
--- a/macros/latex/contrib/acmart/samples/sample-manuscript.pdf
+++ b/macros/latex/contrib/acmart/samples/sample-manuscript.pdf
Binary files differ
diff --git a/macros/latex/contrib/acmart/samples/sample-sigconf-biblatex.pdf b/macros/latex/contrib/acmart/samples/sample-sigconf-biblatex.pdf
index 5b32f3eb2f..86affdb954 100644
--- a/macros/latex/contrib/acmart/samples/sample-sigconf-biblatex.pdf
+++ b/macros/latex/contrib/acmart/samples/sample-sigconf-biblatex.pdf
Binary files differ
diff --git a/macros/latex/contrib/acmart/samples/sample-sigconf-i13n.pdf b/macros/latex/contrib/acmart/samples/sample-sigconf-i13n.pdf
index 312f44903c..d1a809306c 100644
--- a/macros/latex/contrib/acmart/samples/sample-sigconf-i13n.pdf
+++ b/macros/latex/contrib/acmart/samples/sample-sigconf-i13n.pdf
Binary files differ
diff --git a/macros/latex/contrib/acmart/samples/sample-sigconf.pdf b/macros/latex/contrib/acmart/samples/sample-sigconf.pdf
index ee926cd110..2431f25131 100644
--- a/macros/latex/contrib/acmart/samples/sample-sigconf.pdf
+++ b/macros/latex/contrib/acmart/samples/sample-sigconf.pdf
Binary files differ
diff --git a/macros/latex/contrib/acmart/samples/sample-sigplan.pdf b/macros/latex/contrib/acmart/samples/sample-sigplan.pdf
index c77f003baf..a9a992f2a9 100644
--- a/macros/latex/contrib/acmart/samples/sample-sigplan.pdf
+++ b/macros/latex/contrib/acmart/samples/sample-sigplan.pdf
Binary files differ
diff --git a/macros/latex/contrib/acmart/samples/sample-xelatex.pdf b/macros/latex/contrib/acmart/samples/sample-xelatex.pdf
index 77dcd18b8a..a39b085482 100644
--- a/macros/latex/contrib/acmart/samples/sample-xelatex.pdf
+++ b/macros/latex/contrib/acmart/samples/sample-xelatex.pdf
Binary files differ
diff --git a/macros/latex/contrib/acmart/samples/samples.dtx b/macros/latex/contrib/acmart/samples/samples.dtx
index e5ab6b4399..24fa4f0594 100644
--- a/macros/latex/contrib/acmart/samples/samples.dtx
+++ b/macros/latex/contrib/acmart/samples/samples.dtx
@@ -1,4 +1,4 @@
-%<*manuscript|acmsmall|acmsmall-submission|acmsmall-biblatex|acmlarge|acmtog|sigconf|sigconf-biblatex|authordraft|sigplan|sigchi|sigchi-a|acmsmall-conf|sigconf-i13n>
+%<*manuscript|acmsmall|acmsmall-submission|acmsmall-biblatex|acmlarge|acmtog|sigconf|sigconf-biblatex|authordraft|sigplan|sigchi|sigchi-a|acmsmall-conf|sigconf-i13n|acmcp>
%%
%%
%% Commands for TeXCount
@@ -15,7 +15,17 @@
%TCMACROS
%%
%%
-%% The first command in your LaTeX source must be the \documentclass command.
+%% The first command in your LaTeX source must be the \documentclass
+%% command.
+%%
+%% For submission and review of your manuscript please change the
+%% command to \documentclass[manuscript, screen, review]{acmart}.
+%%
+%% When submitting camera ready or to TAPS, please change the command
+%% to \documentclass[sigconf]{acmart} or whichever template is required
+%% for your publication.
+%%
+%%
%<manuscript>\documentclass[manuscript,screen,review]{acmart}
%<acmsmall|acmsmall-conf>\documentclass[acmsmall]{acmart}
%<acmsmall-biblatex>\documentclass[acmsmall,natbib=false]{acmart}
@@ -30,6 +40,7 @@
%<sigchi-a>\documentclass[sigchi-a, nonacm]{acmart}
%<sigconf-i13n>\documentclass[sigconf, language=french,
%<sigconf-i13n>language=german, language=spanish, language=english]{acmart}
+%<acmcp>\documentclass[acmcp]{acmart}
%%
%% \BibTeX command to typeset BibTeX logo in the docs
@@ -48,7 +59,7 @@
\acmYear{2018}
\acmDOI{XXXXXXX.XXXXXXX}
-%</manuscript|acmsmall|acmsmall-submission|acmsmall-biblatex|acmlarge|acmtog|sigconf|sigconf-biblatex|authordraft|sigplan|sigchi|sigchi-a|acmsmall-conf|sigconf-i13n>
+%</manuscript|acmsmall|acmsmall-submission|acmsmall-biblatex|acmlarge|acmtog|sigconf|sigconf-biblatex|authordraft|sigplan|sigchi|sigchi-a|acmsmall-conf|sigconf-i13n|acmcp>
%<*manuscript|sigconf|authordraft|sigplan|sigchi|sigchi-a|acmsmall-conf|sigconf-i13n>
%% These commands are for a PROCEEDINGS abstract or paper.
\acmConference[Conference acronym 'XX]{Make sure to enter the correct
@@ -64,18 +75,19 @@
\acmISBN{978-1-4503-XXXX-X/18/06}
%</manuscript|sigconf|authordraft|sigplan|sigchi|sigchi-a|acmsmall-conf|sigconf-i13n>
-%<*acmsmall|acmsmall-submission|acmsmall-biblatex|acmlarge|acmtog>
+%<*acmsmall|acmsmall-submission|acmsmall-biblatex|acmlarge|acmtog|acmcp>
%%
%% These commands are for a JOURNAL article.
%<acmsmall|acmsmall-submission|acmsmall-biblatex>\acmJournal{JACM}
%<acmlarge>\acmJournal{POMACS}
%<acmtog>\acmJournal{TOG}
+%<acmcp>\acmJournal{JDS}
\acmVolume{37}
\acmNumber{4}
\acmArticle{111}
\acmMonth{8}
-%</acmsmall|acmsmall-submission|acmsmall-biblatex|acmlarge|acmtog>
-%<*manuscript|acmsmall|acmsmall-submission|acmsmall-biblatex|acmlarge|acmtog|sigconf|sigconf-biblatex|authordraft|sigplan|sigchi|sigchi-a|acmsmall-conf|sigconf-i13n>
+%</acmsmall|acmsmall-submission|acmsmall-biblatex|acmlarge|acmtog|acmcp>
+%<*manuscript|acmsmall|acmsmall-submission|acmsmall-biblatex|acmlarge|acmtog|sigconf|sigconf-biblatex|authordraft|sigplan|sigchi|sigchi-a|acmsmall-conf|sigconf-i13n|acmcp>
%%
@@ -84,8 +96,9 @@
%% receive a unique submission ID from the organizers
%% of the event, and this ID should be used as the parameter to this command.
%%\acmSubmissionID{123-A56-BU3}
-%</manuscript|acmsmall|acmsmall-submission|acmsmall-biblatex|acmlarge|acmtog|sigconf|sigconf-biblatex|authordraft|sigplan|sigchi|sigchi-a|acmsmall-conf|sigconf-i13n>
+%</manuscript|acmsmall|acmsmall-submission|acmsmall-biblatex|acmlarge|acmtog|sigconf|sigconf-biblatex|authordraft|sigplan|sigchi|sigchi-a|acmsmall-conf|sigconf-i13n|acmcp>
+%<*!acmcp>
%%
%% For managing citations, it is recommended to use bibliography
%% files in BibTeX format.
@@ -98,6 +111,7 @@
%% Look at the sample-*-biblatex.tex files for templates showcasing
%% the biblatex styles.
%%
+%</!acmcp>
%<*manuscript|acmsmall|acmsmall-submission|acmlarge|acmtog|sigconf|authordraft|sigplan|sigchi|sigchi-a|acmsmall-conf|sigconf-i13n>
%%
@@ -135,8 +149,7 @@
\addbibresource{software.bib}
\addbibresource{sample-base.bib}
%</acmsmall-biblatex|sigconf-biblatex>
-
-%<*manuscript|acmsmall|acmsmall-submission|acmsmall-biblatex|acmlarge|acmtog|sigconf|sigconf-biblatex|authordraft|sigplan|sigchi|sigchi-a|acmsmall-conf|sigconf-i13n>
+%<*manuscript|acmsmall|acmsmall-submission|acmsmall-biblatex|acmlarge|acmtog|sigconf|sigconf-biblatex|authordraft|sigplan|sigchi|sigchi-a|acmsmall-conf|sigconf-i13n|acmcp>
%%
%% end of the preamble, start of the body of the document source.
@@ -157,11 +170,11 @@
%% "authornote" and "authornotemark" commands
%% used to denote shared contribution to the research.
\author{Ben Trovato}
-\authornote{Both authors contributed equally to this research.}
+%<!acmcp>\authornote{Both authors contributed equally to this research.}
\email{trovato@corporation.com}
\orcid{1234-5678-9012}
\author{G.K.M. Tobin}
-\authornotemark[1]
+%<!acmcp>\authornotemark[1]
\email{webmaster@marysville-ohio.com}
\affiliation{%
\institution{Institute for Clarity in Documentation}
@@ -235,6 +248,27 @@
%% the author to define a more concise list
%% of authors' names for this purpose.
\renewcommand{\shortauthors}{Trovato et al.}
+%</manuscript|acmsmall|acmsmall-submission|acmsmall-biblatex|acmlarge|acmtog|sigconf|sigconf-biblatex|authordraft|sigplan|sigchi|sigchi-a|acmsmall-conf|sigconf-i13n|acmcp>
+%<*acmcp>
+%%
+%% Article type: Research, Review, Discussion, Invited or position
+\acmArticleType{Review}
+%%
+%% Links to code and data
+\acmCodeLink{https://github.com/borisveytsman/acmart}
+\acmDataLink{htps://zenodo.org/link}
+%%
+%%
+%% Sometimes the addresses are too long to fit on the page. In this
+%% case uncomment the lines below and fill them accodingly.
+%%
+%% \authorsaddresses{Corresponding author: Ben Trovato,
+%% \href{mailto:trovato@corporation.com}{trovato@corporation.com};
+%% Institute for Clarity in Documentation, P.O. Box 1212, Dublin,
+%% Ohio, USA, 43017-6221}
+%%
+%</acmcp>
+%<*manuscript|acmsmall|acmsmall-submission|acmsmall-biblatex|acmlarge|acmtog|sigconf|sigconf-biblatex|authordraft|sigplan|sigchi|sigchi-a|acmsmall-conf|sigconf-i13n>
%%
%% The abstract is a short summary of the work to be presented in the
@@ -315,6 +349,8 @@
\ccsdesc{Computer systems organization~Robotics}
\ccsdesc[100]{Networks~Network reliability}
+%</manuscript|acmsmall|acmsmall-submission|acmsmall-biblatex|acmlarge|acmtog|sigconf|sigconf-biblatex|authordraft|sigplan|sigchi|sigchi-a|acmsmall-conf|sigconf-i13n>
+%<*manuscript|acmsmall|acmsmall-submission|acmsmall-biblatex|acmlarge|acmtog|sigconf|sigconf-biblatex|authordraft|sigplan|sigchi|sigchi-a|acmsmall-conf|sigconf-i13n|acmcp>
%%
%% Keywords. The author(s) should pick words that accurately describe
%% the work being presented. Separate the keywords with commas.
@@ -326,7 +362,7 @@
%<sigconf-i13n> neuronale Netze, Blickerkennung, Textklassifizierung}
%<sigconf-i13n> \translatedkeywords{spanish}{conjuntos de datos,
%<sigconf-i13n> redes neuronales, detección de mirada, etiquetado de texto}
-%</manuscript|acmsmall|acmsmall-submission|acmsmall-biblatex|acmlarge|acmtog|sigconf|sigconf-biblatex|authordraft|sigplan|sigchi|sigchi-a|acmsmall-conf|sigconf-i13n>
+%</manuscript|acmsmall|acmsmall-submission|acmsmall-biblatex|acmlarge|acmtog|sigconf|sigconf-biblatex|authordraft|sigplan|sigchi|sigchi-a|acmsmall-conf|sigconf-i13n|acmcp>
%<*sigconf|authordraft|sigplan|acmsmall-conf|sigconf-i13n>
%% A "teaser" image appears between the author and affiliation
%% information and the body of the document, and typically spans the
@@ -341,6 +377,10 @@
%</sigconf|authordraft|sigplan|acmsmall-conf|sigconf-i13n>
%<*manuscript|acmsmall|acmsmall-submission|acmsmall-biblatex|acmlarge|acmtog|sigconf|sigconf-biblatex|authordraft|sigplan|sigchi|sigchi-a|acmsmall-conf|sigconf-i13n>
+\received{20 February 2007}
+\received[revised]{12 March 2009}
+\received[accepted]{5 June 2009}
+
%%
%% This command processes the author and affiliation and title
%% information and builds the first part of the formatted document.
@@ -1217,3 +1257,29 @@ a numbered list of URLs with an optional brief description of the content found
\end{document}
%</acmengage>
+%<*acmcp>
+
+\maketitle
+
+
+\section{Problem statement}
+
+In this document we discuss how to write an ACM article.
+
+\section{Methods}
+
+This document provides \LaTeX\ templates for the article.
+
+\section{Results}
+
+We hope the resulting templates help the reader to write ACM papers
+and proceedings.
+
+\section{Significance}
+
+This document is important for anybody wanting to comply with the
+requirements of ACM publishing.
+
+
+\end{document}
+%</acmcp> \ No newline at end of file
diff --git a/macros/latex/contrib/acmart/samples/samples.ins b/macros/latex/contrib/acmart/samples/samples.ins
index f2331d1088..57ab5d7c41 100644
--- a/macros/latex/contrib/acmart/samples/samples.ins
+++ b/macros/latex/contrib/acmart/samples/samples.ins
@@ -21,6 +21,7 @@
\file{sample-sigplan.tex}{\from{samples.dtx}{sigplan}}
\file{sample-acmsmall-conf.tex}{\from{samples.dtx}{acmsmall-conf}}
\file{sample-sigconf-i13n.tex}{\from{samples.dtx}{sigconf-i13n}}
- \file{sample-acmengage.tex}{\from{samples.dtx}{acmengage}}
+ \file{sample-acmengage.tex}{\from{samples.dtx}{acmengage}}
+ \file{sample-acmcp.tex}{\from{samples.dtx}{acmcp}}
}
diff --git a/macros/latex/contrib/glossaries-extra/CHANGES b/macros/latex/contrib/glossaries-extra/CHANGES
index daf9358685..eda7e84503 100644
--- a/macros/latex/contrib/glossaries-extra/CHANGES
+++ b/macros/latex/contrib/glossaries-extra/CHANGES
@@ -1,3 +1,338 @@
+1.49 (pending):
+
+ * Rollback to v1.48 available.
+
+ * glossaries-extra.sty:
+
+ - Case-changing support now tries to detect new mfirstuc.sty v2.08
+ commands (which use LaTeX3). If available, mappings will be established for
+ \makefirstuc. For the best support, ensure you have
+ mfirstuc v2.08 and glossaries v4.50 when they become available.
+
+ - long form commands like \glsxtrlong now set \glsxtrifwasfirstuse
+ to \@firstoftwo to simulate first use for the post-link hook.
+ This is implemented by the new command \glsxtrsetlongfirstuse
+ To restore the original behaviour, redefine this command:
+
+ \renewcommand{\glsxtrsetlongfirstuse}[1]{%
+ \letcs\glsxtrifwasfirstuse{@secondoftwo}%
+ }
+
+ - new hook to implement retainfirstuseperiod attribute:
+ \glsxtrdiscardperiodretainfirstuse
+
+ Note that the retainfirstuseperiod attribute behaves slightly differently.
+ Now the period will only be discarded if it follows subsequent
+ use of commands like \gls or the short commands like
+ \glsxtrshort (not for commands like \glsuseri).
+ To restore the original behaviour:
+
+ \renewcommand*{\glsxtrdiscardperiodretainfirstuse}[3]{%
+ \glsxtrifwasfirstuse{#3}{\glsxtrifperiod{#2}{#3}}%
+ }
+
+ - The definition of \glsdefaultshortaccess has been restored to
+ the original definition provided by glossaries-accsupp.sty. If
+ you want the definition that was introduced to glossaries-extra v1.42
+ you need to do:
+
+ \renewcommand{\glsdefaultshortaccess}[2]{#1 (#2)}
+
+ - entry counting now has associated conditional \ifglsresetcurrcount
+ which determines whether or not to set the counter back to 0
+ when the first use flag is reset. (Issue #205
+ https://www.dickimaw-books.com/bugtracker.php?key=205)
+
+ The default is now \glsresetcurrcountfalse. This changes the
+ behaviour from older versions, but makes more sense with the
+ \cgls commands. If the previous behaviour is required use
+ \glsresetcurrcounttrue
+
+ - Fixed bug #194 (setting mathrel category gives ordinary spacing
+ instead of mathrel spacing)
+ https://www.dickimaw-books.com/bugtracker.php?key=194
+
+ This issue was caused by the grouping in \glslinkwrcontent so
+ this command now simply does its argument to avoid this issue.
+
+ The indexing whatsit is now encapsulated with \glsencapwrcontent,
+ which adds grouping to help prevent spacing issues.
+
+ To revert back to the previous behaviour:
+
+ \renewcommand*{\glslinkwrcontent}[1]{{#1}}
+ \renewcommand*{\glsencapwrcontent}[1]{#1}
+
+ Note that \glsencapwrcontent has also been added to
+ glossaries.sty v4.50 so is defined with \providecommand in
+ glossaries-extra.sty
+
+ - added support for bib2gls v3.0 `group-level` option
+ (hierarchical letter groups). New command (only supported by
+ \printunsrtglossary and \printunsrtinnerglossary):
+
+ \glssubgroupheading
+
+ If you need this setting for styles provided with
+ glossaries.sty, use the stylemods option to patch those styles
+ to include this command.
+
+ - \printunsrtglossary now has extra commands that may be
+ referenced in \printunsrtglossaryentryprocesshook:
+
+ \glscurrententrylevel
+ \glscurrentrootentry
+ \glscurrenttoplevelentry
+
+ - \print...glossary set of commands have new options:
+ preamble and postamble
+
+ - \printunsrtglossary new option : flatten
+
+ - added starred version of \glsxtrcopytoglossary
+
+ - \glsxtrenablerecordcount now adjusts the shortcut commands \ab,
+ \ac etc to use \rgls etc
+
+ - new commands:
+
+ \GlsXtrSetPlusModifier
+ \GlsXtrSetStarModifier
+ \GlsXtrIfInGlossary
+ \setupglslink
+ \setupglsadd
+ \glsxtrseelists \glsxtrseelistsencap \glsxtrseelistsdelim
+ \glsxtrtaggedlist \glsxtrtaggedlistsep
+ \glsentryindexcount \glsifindexed
+ \glsaddallunindexed \glsxtrnoidxgroups
+ \printunsrtglossaryunitpostskip
+ \glsxtrAddCounterRecordHook
+ \glsxtrnewglslink \glsxtrnewglsdisp
+ \glsxtraliashook
+ \GlsXtrStandaloneEntryPdfName
+ \GlsXtrStandaloneEntryHeadName
+ \GlsXtrStandaloneEntryPdfOther
+ \GlsXtrStandaloneEntryHeadOther
+ \GlsXtrUnsetBufferEnableRepeatLocal
+ \GlsXtrResetLocalBuffer
+ \GlsXtrClearUnsetBuffer
+
+ - added check for \GetTitleStringDisableCommands to patch
+ for \glsxtrtitleorpdforheading
+
+ - new placeholder commands for post-link hooks:
+
+ \glsxtrifwasglslike, \glsxtrifwasglslikeandfirstuse,
+ \glsxtrifwassubsequentuse, \glsxtrifallcaps,
+ \glsxtrcurrentfield, \glsxtrifwassubsequentorshort
+
+ - extra values for shortcuts option: acother and abother
+
+ - new user-level command \glsxtraddunusedxrefs in the definition of
+ \glsxtraddallcrossrefs
+
+ - added postunset, preunset and prereset \gls options
+
+ - added innertextformat \gls option and associated commands:
+
+ \glsxtrgenentrytextfmt
+ \glsxtrdefaultentrytextfmt
+ \glsxtrattrentrytextfmt
+ \glsaccessfmt...
+
+ - new attributes: encapinnerfmt, encapnocase, encapnocaseinnerfmt
+
+ - new commands for appending to the set of default \gls options:
+
+ \GlsXtrAppToDefaultGlsOpts
+ \GlsXtrPreToDefaultGlsOpts
+
+ - abbreviation style code has been moved into a separate file
+ glossaries-extra-abbrstyles.def which is automatically input
+ by glossaries-extra.sty
+
+ - new helper commands for abbreviation styles:
+
+ \glsxtrshortformat
+ \glsxtrshortplformat
+ \Glsxtrshortformat
+ \Glsxtrshortplformat
+
+ \glsxtrlongformat
+ \glsxtrlongplformat
+ \Glsxtrlongformat
+ \Glsxtrlongplformat
+
+ \glsxtrlongshortformat
+ \glsxtrlongshortplformat
+ \Glsxtrlongshortformat
+ \Glsxtrlongshortplformat
+
+ \glsxtrshortlongformat
+ \glsxtrshortlongplformat
+ \Glsxtrshortlongformat
+ \Glsxtrshortlongplformat
+
+ \glsxtrfootnotelongformat
+ \glsxtrfootnotelongplformat
+ \glsxtrfootnotepostlongformat
+
+ \glsxtrrevert
+ \glsxtrdefaultrevert
+ \glsxtrscrevert
+ \glsxtrscuserrevert
+ \glsxtrsconlyrevert
+ \glsxtrsmrevert
+ \glsxtremrevert
+
+ - debug=showwrgloss now also shows the wrglossary counter if
+ indexcounter has been set
+
+ - made \glsxtrdopostpunc robust
+
+ - added support for \glsindexingsetting (new to glossaries.sty v4.50)
+
+ - record option: test for \inputencodingname switched to
+ \ifdefvoid and UTF-8 assumed if void.
+
+ - new package option 'bibglsaux'
+
+ - support for glossaries-prefix with abbreviations:
+
+ \pglsxtrshort, \pglsxtrshortpl, \pglsxtrlong, \pglsxtrlongpl
+ \pglsfmtshort, \pglsfmtshortpl, \pglsfmtlong, \pglsfmtlongpl
+
+ and sentence-case and all-caps versions
+
+ - bug fix: indexcounter with record=nameref shows the wrglossary
+ value instead of the page number
+
+ - bug fix: \GlsXtrDualBackLink showing label not text if dual
+ field not set
+
+ - bug fix #206: default shortaccess is using UTF-16BE
+ https://www.dickimaw-books.com/bugtracker.php?key=206
+
+ - bug fix: shortplural and longplural in optional argument of
+ \newabbreviation ignore attributes
+
+ - bug fix: markwords and markshortwords attribute not working
+ correctly for plurals
+
+ - bug fix: some abbreviation styles had incorrect capitalisation
+ for \Gls...
+
+ - bug fix: corrected name of longpluralaccess field
+
+ - bug fix #192: Undefined control sequences with \mgls and bib2gls
+ https://www.dickimaw-books.com/bugtracker.php?key=192
+
+ - bug fix #193: \Glsxtrhiername fails with child entries
+ https://www.dickimaw-books.com/bugtracker.php?key=193
+
+ - bug fix #171: issue with base options passed if glossaries.sty
+ already loaded
+ https://www.dickimaw-books.com/bugtracker.php?key=171
+
+ - bug fix: corrected spelling of \GlsXtrLetField
+
+ - bug fix: don't fallback on loclist field if \GlsXtrLocationField has
+ been changed (since this indicates that the given field is intended and
+ should be left blank if not set).
+
+ - bug fix: entry counting not working with docdef=restricted
+
+ - bug fix: corrected spelling of \ifglshasshort in \glssetcombinedsepnarrow
+ \glssetcombinedsepabbrvnone and \glssetcombinedsepabbrvnbsp
+
+ - bug fix: corrected arguments to \GlsXtrStandaloneEntryOther
+ within the definition of \@glsxtrglossentryother
+
+ * glossaries-extra-stylemods.sty:
+
+ - added new sub-group command \glssubgroupheading to styles.
+
+ * glossary-bookindex.sty:
+
+ - added new sub-group command \glssubgroupheading to styles.
+
+ - new commands to adjust the style:
+
+ \glsxtrbookindexpregroupskip
+ \glsxtrbookindexpostgroupskip
+ \glsxtrbookindexpresubgroupskip
+ \glsxtrbookindexpostsubgroupskip
+ \glsxtrbookindexformatsubheader
+ \glsxtrbookindexsubbookmark
+
+ * glossary-longextra.sty:
+
+ - added new sub-group command \glssubgroupheading to styles.
+
+ - new command to adjust the style:
+
+ \glslongextraSubGroupHeading
+
+ - new styles: long-sym-desc, long-desc-sym, abbr-short-long,
+ abbr-long-short and associated commands
+
+ * glossary-topic.sty:
+
+ - added new sub-group command \glssubgroupheading to styles.
+
+ - new command to adjust the style:
+
+ \glstopicSubGroupHeading
+
+ * glossary-table.sty: new package
+
+ * glossaries-extra-bib2gls.sty:
+
+ - new command for use with record=nameref and indexcounter:
+
+ \glsxtrwrglossarylocfmt
+
+ - new commands defined or used by \glsxtrdisplaylocnameref:
+
+ \glsxtrsetactualanchor
+ \glsxtrlocationanchor
+ \glsxtrrecentanchor
+ \glsxtractualanchor
+ \glsxtrtitlednamereflink
+
+ - new conditional for the prefix label fallback (\dgls etc):
+ \ifGlsXtrPrefixLabelFallbackLast
+
+ - \dgls etc will now record all possible prefixes when there's no
+ match to assist document build on the first run.
+
+ - new commands: \dglsfield, \dGlsfield, \dGLSfield, \newdglsfield
+ and \newdglsfieldlike
+
+ - added General Latin subset rules:
+
+ \glsxtrGeneralLatinAtoMrules
+ \glsxtrGeneralLatinNtoZrules
+ \glsxtrGeneralLatinAtoGrules
+ \glsxtrGeneralLatinHtoMrules
+ \glsxtrGeneralLatinNtoSrules
+ \glsxtrGeneralLatinTtoZrules
+
+ - subdivided \glsxtrgeneralpuncIrules into:
+
+ \glsxtrgeneralpuncmarksrules
+ \glsxtrgeneralpuncaccentsrules
+ \glsxtrgeneralpuncquoterules
+ \glsxtrgeneralpuncbracketrules
+ \glsxtrgeneralpuncsignrules
+
+ - added shortcut rules:
+
+ \glsxtrIgnorableRules
+ \glsxtrGeneralInitRules
+
+ - new command: \IfTeXParserLib
+
1.48 (2021-11-22):
* glossaries-extra.sty:
diff --git a/macros/latex/contrib/glossaries-extra/DEPENDS.txt b/macros/latex/contrib/glossaries-extra/DEPENDS.txt
new file mode 100644
index 0000000000..64bda12952
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/DEPENDS.txt
@@ -0,0 +1 @@
+glossaries
diff --git a/macros/latex/contrib/glossaries-extra/README b/macros/latex/contrib/glossaries-extra/README
index 5203fbbbbb..c9b495d713 100644
--- a/macros/latex/contrib/glossaries-extra/README
+++ b/macros/latex/contrib/glossaries-extra/README
@@ -1,4 +1,4 @@
-LaTeX Package : glossaries-extra v1.48 (2021-11-22)
+LaTeX Package : glossaries-extra v1.49 (2022-10-14)
Author : Nicola Talbot
https://www.dickimaw-books.com/contact
@@ -9,7 +9,7 @@ This material is subject to the LaTeX Project Public License.
See http://www.ctan.org/license/lppl1.3
for the details of that license.
-Copyright 2015-2021 Nicola Talbot
+Copyright 2015-2022 Nicola Talbot
DESCRIPTION
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-code.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-code.pdf
index bcdfc7ef18..1a23d1b437 100644
--- a/macros/latex/contrib/glossaries-extra/glossaries-extra-code.pdf
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-code.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example001.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example001.pdf
new file mode 100644
index 0000000000..beeafaa532
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example001.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example001.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example001.png
new file mode 100644
index 0000000000..b2c9dec5a6
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example001.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example001.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example001.tex
new file mode 100644
index 0000000000..5d549467ac
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example001.tex
@@ -0,0 +1,19 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 1 Multiple abbreviation styles
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-short-sc}
+\setabbreviationstyle[genus]{long-only-short-only}
+\setabbreviationstyle[common]{short-nolong}
+\newabbreviation{xml}{xml}{extensible markup language}
+\newabbreviation[category={genus}]{clostridium}{C.}{Clostridium}
+\newabbreviation[category={genus}]{myristica}{M.}{Myristica}
+\newabbreviation[category={common}]{html}{HTML}{hypertext markup language} \newabbreviation[category={title}]{dr}{Dr}{Doctor}
+\begin{document}
+First use: \gls{xml}, \gls{clostridium}, \gls{myristica}, \gls{html}, \gls{dr}.
+
+Next use: \gls{xml}, \gls{clostridium}, \gls{myristica}, \gls{html}, \gls{dr}.
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example002.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example002.pdf
new file mode 100644
index 0000000000..5a004b8f47
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example002.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example002.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example002.png
new file mode 100644
index 0000000000..8894bc8c90
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example002.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example002.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example002.tex
new file mode 100644
index 0000000000..41c2d77e9d
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example002.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 2 \newabbreviation vs \newacronym vs \newglossaryentry
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage{glossaries-extra}
+\makeglossaries
+\newglossaryentry{sample}{name={sample},description={an example}}
+\newabbreviation{xml}{XML}{extensible markup language}
+\newacronym{nasa}{NASA}{National Aeronautics and Space Administration}
+\begin{document}
+First use: \gls{sample}, \gls{xml} and \gls{nasa}. Next use: \gls{sample}, \gls{xml} and \gls{nasa}.
+\printglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example003.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example003.pdf
new file mode 100644
index 0000000000..c4ca6cd712
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example003.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example003.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example003.png
new file mode 100644
index 0000000000..90dfcb9606
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example003.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example003.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example003.tex
new file mode 100644
index 0000000000..01a06f3664
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example003.tex
@@ -0,0 +1,29 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 3 @abbreviation vs @acronym vs @entry
+% arara: pdflatex
+% arara: bib2gls
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\begin{filecontents*}{\jobname.bib}
+@entry{sample,
+name={sample},
+description={an example}
+}
+@abbreviation{xml,
+short={XML},
+long={extensible markup language}
+}
+@acronym{nasa,
+short={NASA},
+long={National Aeronautics and Space Administration}
+}
+\end{filecontents*}
+\usepackage[record]{glossaries-extra}
+\GlsXtrLoadResources
+\begin{document}
+First use: \gls{sample}, \gls{xml} and \gls{nasa}.
+Next use: \gls{sample}, \gls{xml} and \gls{nasa}.
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example004.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example004.pdf
new file mode 100644
index 0000000000..71905cdb50
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example004.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example004.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example004.png
new file mode 100644
index 0000000000..2e00cc94a9
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example004.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example004.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example004.tex
new file mode 100644
index 0000000000..324476d772
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example004.tex
@@ -0,0 +1,36 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 4 Referencing an abbreviation (with hyperref)
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\makeglossaries
+\newabbreviation{svm}{SVM}{support vector machine}
+\newabbreviation{html}{HTML}{hypertext markup language}
+
+\begin{document}
+\tableofcontents
+\section{Introducing the \glsfmtlong{svm}}
+First use: \gls{svm}.
+Next use: \gls{svm}.
+
+\section{Introducing \gls{html} (incorrect)}
+First use (not!): \gls{html}.
+Next use: \gls{html}.
+
+\glsreset{html}
+\section{Introducing \glsxtrshort{html} (incorrect)}
+First use: \gls{html}.
+Next use: \gls{html}.
+
+
+\glsreset{html}
+\section{Introducing \glsfmtshort{html}}
+First use: \gls{html}.
+Next use: \gls{html}.
+\printglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example005.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example005.pdf
new file mode 100644
index 0000000000..f39ab462d8
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example005.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example005.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example005.png
new file mode 100644
index 0000000000..8bee699e51
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example005.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example005.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example005.tex
new file mode 100644
index 0000000000..5504a318ef
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example005.tex
@@ -0,0 +1,20 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 5 First use of \gls vs \glsxtrfull vs \glsfirst
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[20pt]{extarticle}
+\pagestyle{empty}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{footnote}
+\newabbreviation{nasa}{NASA}{National Aeronautics and Space Administration}
+
+\begin{document}
+\gls{nasa}['s] space exploration\ldots
+
+
+\glsxtrfull{nasa}['s] space exploration\ldots
+
+
+\glsfirst{nasa}['s] space exploration\ldots
+
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example006.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example006.pdf
new file mode 100644
index 0000000000..cadd9bd28c
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example006.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example006.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example006.png
new file mode 100644
index 0000000000..d4d1ebe740
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example006.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example006.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example006.tex
new file mode 100644
index 0000000000..0a87f40585
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example006.tex
@@ -0,0 +1,30 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 6 Tagging abbreviation initials
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage{glossaries-extra}
+\makeglossaries
+\GlsXtrEnableInitialTagging{acronym,abbreviation}{\itag}
+\setabbreviationstyle[acronym]{short-nolong-desc}
+\newacronym
+[description={a system for detecting the location and speed of ships, aircraft, etc, through the use of radio waves}% description of this term
+ ]
+ {radar}% identifying label
+ {radar}% short form
+ {\itag{ra}dio \itag{d}etection \itag{a}nd \itag{r}anging}
+
+\newabbreviation{xml}{XML}
+ {e\itag{x}tensible \itag{m}arkup \itag{l}anguage}
+
+\newabbreviation[category={other}]{tne}{TNE}
+ {\itag{t}agging \itag{n}ot \itag{e}nabled}
+\begin{document}
+First use: \gls{radar}, \gls{xml}, \gls{tne}.
+
+Long form only: \glsxtrlong{radar}, \glsxtrlong{xml}, \glsxtrlong{tne}.
+\printglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example007.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example007.pdf
new file mode 100644
index 0000000000..631ef09efe
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example007.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example007.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example007.png
new file mode 100644
index 0000000000..de32cd1c69
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example007.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example007.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example007.tex
new file mode 100644
index 0000000000..45c9bd75b4
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example007.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 7 Category without an associated abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[20pt]{extarticle}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-short-sc}
+\newabbreviation{html}{html}{hypertext markup language}
+\setabbreviationstyle[acronym]{footnote}
+\newacronym{radar}{radar}{radio detection and ranging}
+\newacronym[category=latin]{ibid}{ibid}{ibidem}
+\begin{document}
+\gls{html}, \gls{radar} and \gls{ibid}.
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example008.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example008.pdf
new file mode 100644
index 0000000000..4e327f2418
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example008.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example008.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example008.png
new file mode 100644
index 0000000000..09eb9aad87
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example008.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example008.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example008.tex
new file mode 100644
index 0000000000..dd75ad00cd
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example008.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 8 The short-nolong abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-nolong}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example009.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example009.pdf
new file mode 100644
index 0000000000..1c362ea347
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example009.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example009.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example009.png
new file mode 100644
index 0000000000..182a85582e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example009.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example009.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example009.tex
new file mode 100644
index 0000000000..6dca3b45f5
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example009.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 9 The short-nolong-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-nolong-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example010.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example010.pdf
new file mode 100644
index 0000000000..7240db3049
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example010.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example010.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example010.png
new file mode 100644
index 0000000000..392eafacfb
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example010.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example010.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example010.tex
new file mode 100644
index 0000000000..962f0e7f8f
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example010.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 10 The nolong-short abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{nolong-short}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example011.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example011.pdf
new file mode 100644
index 0000000000..46b9895ec4
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example011.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example011.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example011.png
new file mode 100644
index 0000000000..d2df475ab0
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example011.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example011.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example011.tex
new file mode 100644
index 0000000000..cd1bdfe861
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example011.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 11 The short-sc-nolong abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-sc-nolong}
+\newabbreviation{ex}{shrt fm}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example012.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example012.pdf
new file mode 100644
index 0000000000..c5e9fb1fca
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example012.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example012.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example012.png
new file mode 100644
index 0000000000..ad9eda1fe7
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example012.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example012.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example012.tex
new file mode 100644
index 0000000000..e703863be1
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example012.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 12 The short-sc-nolong-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-sc-nolong-desc}
+\newabbreviation[description={sample description}]
+{ex}{shrt fm}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example013.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example013.pdf
new file mode 100644
index 0000000000..a256a8a616
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example013.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example013.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example013.png
new file mode 100644
index 0000000000..6490212f62
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example013.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example013.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example013.tex
new file mode 100644
index 0000000000..4bc973467e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example013.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 13 The nolong-short-sc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{nolong-short-sc}
+\newabbreviation{ex}{shrt fm}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example014.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example014.pdf
new file mode 100644
index 0000000000..259d9a8221
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example014.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example014.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example014.png
new file mode 100644
index 0000000000..83bf0c57b2
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example014.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example014.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example014.tex
new file mode 100644
index 0000000000..ef6b395253
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example014.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 14 The short-sm-nolong abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+
+\usepackage{relsize}\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-sm-nolong}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example015.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example015.pdf
new file mode 100644
index 0000000000..96eb6c0e21
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example015.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example015.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example015.png
new file mode 100644
index 0000000000..d4cd379397
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example015.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example015.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example015.tex
new file mode 100644
index 0000000000..f7846f3d9b
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example015.tex
@@ -0,0 +1,18 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 15 The short-sm-nolong-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+
+\usepackage{relsize}\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-sm-nolong-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example016.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example016.pdf
new file mode 100644
index 0000000000..80df8c8b31
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example016.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example016.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example016.png
new file mode 100644
index 0000000000..b6d8722497
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example016.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example016.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example016.tex
new file mode 100644
index 0000000000..5320a1d21e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example016.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 16 The nolong-short-sm abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+
+\usepackage{relsize}\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{nolong-short-sm}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example017.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example017.pdf
new file mode 100644
index 0000000000..4739c7eae9
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example017.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example017.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example017.png
new file mode 100644
index 0000000000..95688379e4
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example017.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example017.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example017.tex
new file mode 100644
index 0000000000..f7896e313c
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example017.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 17 The short-em-nolong abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-em-nolong}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example018.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example018.pdf
new file mode 100644
index 0000000000..0c3e102f40
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example018.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example018.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example018.png
new file mode 100644
index 0000000000..73889ad297
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example018.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example018.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example018.tex
new file mode 100644
index 0000000000..bcf4175e03
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example018.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 18 The short-em-nolong-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-em-nolong-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example019.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example019.pdf
new file mode 100644
index 0000000000..ac6b498ddb
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example019.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example019.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example019.png
new file mode 100644
index 0000000000..45c88c49d1
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example019.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example019.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example019.tex
new file mode 100644
index 0000000000..9101105407
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example019.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 19 The nolong-short-em abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{nolong-short-em}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example020.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example020.pdf
new file mode 100644
index 0000000000..9c8da858d2
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example020.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example020.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example020.png
new file mode 100644
index 0000000000..ae5adbf1f3
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example020.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example020.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example020.tex
new file mode 100644
index 0000000000..d8b9ec59f5
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example020.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 20 The long-noshort-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-noshort-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example021.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example021.pdf
new file mode 100644
index 0000000000..ee7b40bd7e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example021.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example021.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example021.png
new file mode 100644
index 0000000000..2711dc0db7
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example021.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example021.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example021.tex
new file mode 100644
index 0000000000..eef9975670
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example021.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 21 The long-noshort abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-noshort}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example022.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example022.pdf
new file mode 100644
index 0000000000..4ab251b4c1
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example022.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example022.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example022.png
new file mode 100644
index 0000000000..be66d9ef25
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example022.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example022.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example022.tex
new file mode 100644
index 0000000000..b76fee1b27
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example022.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 22 The long-noshort-sc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-noshort-sc}
+\newabbreviation{ex}{shrt fm}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example023.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example023.pdf
new file mode 100644
index 0000000000..02d5877ccf
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example023.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example023.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example023.png
new file mode 100644
index 0000000000..142bc3c4e8
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example023.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example023.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example023.tex
new file mode 100644
index 0000000000..f433b9e323
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example023.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 23 The long-noshort-sc-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-noshort-sc-desc}
+\newabbreviation[description={sample description}]
+{ex}{shrt fm}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example024.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example024.pdf
new file mode 100644
index 0000000000..9d4ebe8c8e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example024.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example024.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example024.png
new file mode 100644
index 0000000000..cbbb369897
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example024.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example024.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example024.tex
new file mode 100644
index 0000000000..f63c0c8979
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example024.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 24 The long-noshort-sm abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+
+\usepackage{relsize}\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-noshort-sm}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example025.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example025.pdf
new file mode 100644
index 0000000000..d20f79aa0f
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example025.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example025.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example025.png
new file mode 100644
index 0000000000..e5de999bc0
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example025.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example025.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example025.tex
new file mode 100644
index 0000000000..f6b69654a9
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example025.tex
@@ -0,0 +1,18 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 25 The long-noshort-sm-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+
+\usepackage{relsize}\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-noshort-sm-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example026.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example026.pdf
new file mode 100644
index 0000000000..3f0535e48c
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example026.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example026.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example026.png
new file mode 100644
index 0000000000..3082227e33
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example026.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example026.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example026.tex
new file mode 100644
index 0000000000..6374c047c1
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example026.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 26 The long-noshort-em abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-noshort-em}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example027.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example027.pdf
new file mode 100644
index 0000000000..709919e564
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example027.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example027.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example027.png
new file mode 100644
index 0000000000..0306a4980c
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example027.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example027.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example027.tex
new file mode 100644
index 0000000000..52399703dc
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example027.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 27 The long-noshort-em-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-noshort-em-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example028.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example028.pdf
new file mode 100644
index 0000000000..2034f71582
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example028.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example028.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example028.png
new file mode 100644
index 0000000000..bb89ef3dac
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example028.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example028.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example028.tex
new file mode 100644
index 0000000000..4b12a371d8
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example028.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 28 The long-em-noshort-em abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-em-noshort-em}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example029.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example029.pdf
new file mode 100644
index 0000000000..2f7946ae1b
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example029.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example029.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example029.png
new file mode 100644
index 0000000000..3fc9a53525
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example029.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example029.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example029.tex
new file mode 100644
index 0000000000..c20cad7556
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example029.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 29 The long-em-noshort-em-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-em-noshort-em-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example030.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example030.pdf
new file mode 100644
index 0000000000..64cb6796c0
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example030.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example030.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example030.png
new file mode 100644
index 0000000000..97cf28052b
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example030.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example030.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example030.tex
new file mode 100644
index 0000000000..cb8d4fa639
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example030.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 30 The long-short abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-short}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example031.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example031.pdf
new file mode 100644
index 0000000000..cb57c26255
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example031.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example031.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example031.png
new file mode 100644
index 0000000000..9a237f7460
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example031.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example031.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example031.tex
new file mode 100644
index 0000000000..acd39ec7bc
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example031.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 31 The long-short-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-short-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example032.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example032.pdf
new file mode 100644
index 0000000000..f16ab6eec2
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example032.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example032.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example032.png
new file mode 100644
index 0000000000..ab51d19054
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example032.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example032.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example032.tex
new file mode 100644
index 0000000000..9f7f0b05b4
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example032.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 32 The long-short-sc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-short-sc}
+\newabbreviation{ex}{shrt fm}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example033.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example033.pdf
new file mode 100644
index 0000000000..5820ca2130
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example033.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example033.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example033.png
new file mode 100644
index 0000000000..16c2f6589f
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example033.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example033.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example033.tex
new file mode 100644
index 0000000000..edca28a268
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example033.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 33 The long-short-sc-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-short-sc-desc}
+\newabbreviation[description={sample description}]
+{ex}{shrt fm}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example034.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example034.pdf
new file mode 100644
index 0000000000..cfab11d0c9
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example034.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example034.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example034.png
new file mode 100644
index 0000000000..674c9bd32d
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example034.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example034.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example034.tex
new file mode 100644
index 0000000000..2c2c545999
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example034.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 34 The long-short-sm abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+
+\usepackage{relsize}\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-short-sm}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example035.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example035.pdf
new file mode 100644
index 0000000000..b46053eaf4
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example035.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example035.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example035.png
new file mode 100644
index 0000000000..97ea5cc2d7
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example035.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example035.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example035.tex
new file mode 100644
index 0000000000..6c4f85c72a
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example035.tex
@@ -0,0 +1,18 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 35 The long-short-sm-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+
+\usepackage{relsize}\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-short-sm-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example036.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example036.pdf
new file mode 100644
index 0000000000..2acbe9b527
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example036.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example036.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example036.png
new file mode 100644
index 0000000000..9b581c839b
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example036.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example036.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example036.tex
new file mode 100644
index 0000000000..693b3479d8
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example036.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 36 The long-short-em abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-short-em}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example037.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example037.pdf
new file mode 100644
index 0000000000..cdc1baf4af
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example037.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example037.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example037.png
new file mode 100644
index 0000000000..6baf3bd4ab
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example037.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example037.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example037.tex
new file mode 100644
index 0000000000..983a615989
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example037.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 37 The long-short-em-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-short-em-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example038.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example038.pdf
new file mode 100644
index 0000000000..4e789d7066
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example038.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example038.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example038.png
new file mode 100644
index 0000000000..91886419b6
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example038.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example038.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example038.tex
new file mode 100644
index 0000000000..476e652d72
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example038.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 38 The long-em-short-em abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-em-short-em}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example039.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example039.pdf
new file mode 100644
index 0000000000..30cc360fa4
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example039.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example039.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example039.png
new file mode 100644
index 0000000000..6570501ac5
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example039.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example039.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example039.tex
new file mode 100644
index 0000000000..ae4f57b281
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example039.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 39 The long-em-short-em-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-em-short-em-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example040.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example040.pdf
new file mode 100644
index 0000000000..a50960c8c9
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example040.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example040.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example040.png
new file mode 100644
index 0000000000..657d7a15f1
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example040.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example040.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example040.tex
new file mode 100644
index 0000000000..bab0eacfd3
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example040.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 40 The long-short-user abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-short-user}
+\newabbreviation[user1={extra info}]{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example041.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example041.pdf
new file mode 100644
index 0000000000..af065fab48
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example041.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example041.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example041.png
new file mode 100644
index 0000000000..91b935f0ce
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example041.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example041.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example041.tex
new file mode 100644
index 0000000000..c3520ca37e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example041.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 41 The long-short-user-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-short-user-desc}
+\newabbreviation[description={sample description},
+user1={extra info}]{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example042.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example042.pdf
new file mode 100644
index 0000000000..ab047ff468
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example042.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example042.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example042.png
new file mode 100644
index 0000000000..d19431015b
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example042.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example042.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example042.tex
new file mode 100644
index 0000000000..8ae7c5dbd1
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example042.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 42 The long-postshort-user abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-postshort-user}
+\newabbreviation[user1={extra info}]{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example043.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example043.pdf
new file mode 100644
index 0000000000..f4b87fecb3
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example043.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example043.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example043.png
new file mode 100644
index 0000000000..c6a1b48a60
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example043.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example043.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example043.tex
new file mode 100644
index 0000000000..1b8b91ce0a
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example043.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 43 The long-postshort-user-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-postshort-user-desc}
+\newabbreviation[description={sample description},
+user1={extra info}]{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example044.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example044.pdf
new file mode 100644
index 0000000000..ce1bb6b95c
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example044.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example044.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example044.png
new file mode 100644
index 0000000000..4044ebc889
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example044.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example044.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example044.tex
new file mode 100644
index 0000000000..148ec44884
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example044.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 44 The long-postshort-sc-user abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-postshort-sc-user}
+\newabbreviation[user1={extra info}]{ex}{shrt fm}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example045.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example045.pdf
new file mode 100644
index 0000000000..66a3a0869b
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example045.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example045.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example045.png
new file mode 100644
index 0000000000..1de4f96e35
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example045.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example045.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example045.tex
new file mode 100644
index 0000000000..058466ac7f
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example045.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 45 The long-postshort-sc-user-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-postshort-sc-user-desc}
+\newabbreviation[description={sample description},
+user1={extra info}]{ex}{shrt fm}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example046.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example046.pdf
new file mode 100644
index 0000000000..04f34def96
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example046.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example046.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example046.png
new file mode 100644
index 0000000000..c9d0303520
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example046.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example046.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example046.tex
new file mode 100644
index 0000000000..d8bf202302
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example046.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 46 The short-long abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-long}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example047.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example047.pdf
new file mode 100644
index 0000000000..47d5de099e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example047.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example047.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example047.png
new file mode 100644
index 0000000000..80af1a2842
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example047.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example047.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example047.tex
new file mode 100644
index 0000000000..ca17dd35be
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example047.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 47 The short-long-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-long-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example048.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example048.pdf
new file mode 100644
index 0000000000..5fca559352
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example048.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example048.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example048.png
new file mode 100644
index 0000000000..11f53edc41
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example048.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example048.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example048.tex
new file mode 100644
index 0000000000..a1dc5c86de
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example048.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 48 The short-sc-long abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-sc-long}
+\newabbreviation{ex}{shrt fm}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example049.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example049.pdf
new file mode 100644
index 0000000000..25c68b9e35
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example049.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example049.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example049.png
new file mode 100644
index 0000000000..6abd840445
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example049.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example049.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example049.tex
new file mode 100644
index 0000000000..ee746bc0c4
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example049.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 49 The short-sc-long-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-sc-long-desc}
+\newabbreviation[description={sample description}]
+{ex}{shrt fm}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example050.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example050.pdf
new file mode 100644
index 0000000000..839ad2c89e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example050.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example050.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example050.png
new file mode 100644
index 0000000000..831e6f646a
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example050.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example050.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example050.tex
new file mode 100644
index 0000000000..54abe46f01
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example050.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 50 The short-sm-long abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+
+\usepackage{relsize}\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-sm-long}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example051.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example051.pdf
new file mode 100644
index 0000000000..ae21addf72
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example051.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example051.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example051.png
new file mode 100644
index 0000000000..2f900429e9
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example051.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example051.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example051.tex
new file mode 100644
index 0000000000..bc77696e44
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example051.tex
@@ -0,0 +1,18 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 51 The short-sm-long-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+
+\usepackage{relsize}\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-sm-long-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example052.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example052.pdf
new file mode 100644
index 0000000000..022d58ed0f
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example052.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example052.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example052.png
new file mode 100644
index 0000000000..6d4b2ede30
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example052.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example052.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example052.tex
new file mode 100644
index 0000000000..a0a409457f
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example052.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 52 The short-em-long abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-em-long}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example053.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example053.pdf
new file mode 100644
index 0000000000..495cdf2c12
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example053.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example053.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example053.png
new file mode 100644
index 0000000000..e9913ea640
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example053.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example053.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example053.tex
new file mode 100644
index 0000000000..61179732bf
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example053.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 53 The short-em-long-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-em-long-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example054.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example054.pdf
new file mode 100644
index 0000000000..95784fb5ef
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example054.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example054.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example054.png
new file mode 100644
index 0000000000..c150b3b5a2
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example054.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example054.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example054.tex
new file mode 100644
index 0000000000..4afda2e6d8
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example054.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 54 The short-em-long-em abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-em-long-em}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example055.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example055.pdf
new file mode 100644
index 0000000000..6b48d01dd0
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example055.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example055.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example055.png
new file mode 100644
index 0000000000..7554decfac
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example055.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example055.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example055.tex
new file mode 100644
index 0000000000..47f6f0a039
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example055.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 55 The short-em-long-em-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-em-long-em-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example056.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example056.pdf
new file mode 100644
index 0000000000..afdd8bc9e6
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example056.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example056.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example056.png
new file mode 100644
index 0000000000..12c7c9008d
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example056.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example056.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example056.tex
new file mode 100644
index 0000000000..1980ed3572
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example056.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 56 The short-long-user abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-long-user}
+\newabbreviation[user1={extra info}]{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example057.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example057.pdf
new file mode 100644
index 0000000000..56d0888d1a
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example057.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example057.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example057.png
new file mode 100644
index 0000000000..63f9939e4e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example057.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example057.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example057.tex
new file mode 100644
index 0000000000..b61d9a7e3e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example057.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 57 The short-long-user-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-long-user-desc}
+\newabbreviation[description={sample description},
+user1={extra info}]{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example058.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example058.pdf
new file mode 100644
index 0000000000..71193bf7f3
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example058.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example058.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example058.png
new file mode 100644
index 0000000000..76e774613e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example058.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example058.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example058.tex
new file mode 100644
index 0000000000..de31e14870
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example058.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 58 The short-postlong-user abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-postlong-user}
+\newabbreviation[user1={extra info}]{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example059.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example059.pdf
new file mode 100644
index 0000000000..05d9ccc565
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example059.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example059.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example059.png
new file mode 100644
index 0000000000..12900b4d7b
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example059.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example059.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example059.tex
new file mode 100644
index 0000000000..de98b1ff25
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example059.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 59 The short-postlong-user-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-postlong-user-desc}
+\newabbreviation[description={sample description},
+user1={extra info}]{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example060.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example060.pdf
new file mode 100644
index 0000000000..c69595841d
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example060.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example060.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example060.png
new file mode 100644
index 0000000000..f79e9f2e85
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example060.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example060.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example060.tex
new file mode 100644
index 0000000000..04f1c1e36a
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example060.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 60 The long-hyphen-short-hyphen abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\glssetcategoryattributes{abbreviation}{markwords,markshortwords}{true}
+\setabbreviationstyle{long-hyphen-short-hyphen}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example061.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example061.pdf
new file mode 100644
index 0000000000..156a167070
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example061.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example061.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example061.png
new file mode 100644
index 0000000000..a791e00b08
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example061.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example061.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example061.tex
new file mode 100644
index 0000000000..320588615b
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example061.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 61 The long-hyphen-postshort-hyphen abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\glssetcategoryattributes{abbreviation}{markwords,markshortwords}{true}
+\setabbreviationstyle{long-hyphen-postshort-hyphen}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example062.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example062.pdf
new file mode 100644
index 0000000000..110fbb0a48
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example062.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example062.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example062.png
new file mode 100644
index 0000000000..5640bb9ab8
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example062.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example062.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example062.tex
new file mode 100644
index 0000000000..574a86b0e1
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example062.tex
@@ -0,0 +1,18 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 62 The long-hyphen-short-hyphen-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\glssetcategoryattributes{abbreviation}{markwords,markshortwords}{true}
+\setabbreviationstyle{long-hyphen-short-hyphen-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example063.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example063.pdf
new file mode 100644
index 0000000000..06bb62fbb2
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example063.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example063.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example063.png
new file mode 100644
index 0000000000..7a3589773a
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example063.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example063.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example063.tex
new file mode 100644
index 0000000000..863eb2dc5f
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example063.tex
@@ -0,0 +1,18 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 63 The long-hyphen-postshort-hyphen-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\glssetcategoryattributes{abbreviation}{markwords,markshortwords}{true}
+\setabbreviationstyle{long-hyphen-postshort-hyphen-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example064.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example064.pdf
new file mode 100644
index 0000000000..2e5cb7d837
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example064.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example064.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example064.png
new file mode 100644
index 0000000000..aa08a268e0
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example064.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example064.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example064.tex
new file mode 100644
index 0000000000..711b0394f3
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example064.tex
@@ -0,0 +1,18 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 64 The long-hyphen-noshort-desc-noreg abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\glssetcategoryattributes{abbreviation}{markwords,markshortwords}{true}
+\setabbreviationstyle{long-hyphen-noshort-desc-noreg}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example065.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example065.pdf
new file mode 100644
index 0000000000..d2dc6d280f
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example065.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example065.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example065.png
new file mode 100644
index 0000000000..6d809378fc
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example065.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example065.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example065.tex
new file mode 100644
index 0000000000..9048eaac20
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example065.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 65 The long-hyphen-noshort-noreg abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\glssetcategoryattributes{abbreviation}{markwords,markshortwords}{true}
+\setabbreviationstyle{long-hyphen-noshort-noreg}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example066.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example066.pdf
new file mode 100644
index 0000000000..614f0a6adf
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example066.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example066.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example066.png
new file mode 100644
index 0000000000..1b77002ea7
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example066.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example066.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example066.tex
new file mode 100644
index 0000000000..c3f322f62b
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example066.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 66 The short-hyphen-long-hyphen abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\glssetcategoryattributes{abbreviation}{markwords,markshortwords}{true}
+\setabbreviationstyle{short-hyphen-long-hyphen}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example067.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example067.pdf
new file mode 100644
index 0000000000..3e4271cd8a
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example067.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example067.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example067.png
new file mode 100644
index 0000000000..5f5e00333f
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example067.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example067.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example067.tex
new file mode 100644
index 0000000000..0bbcbcdbf5
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example067.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 67 The short-hyphen-postlong-hyphen abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\glssetcategoryattributes{abbreviation}{markwords,markshortwords}{true}
+\setabbreviationstyle{short-hyphen-postlong-hyphen}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example068.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example068.pdf
new file mode 100644
index 0000000000..a550a73ded
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example068.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example068.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example068.png
new file mode 100644
index 0000000000..ccac0dbca8
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example068.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example068.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example068.tex
new file mode 100644
index 0000000000..926397ae24
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example068.tex
@@ -0,0 +1,18 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 68 The short-hyphen-long-hyphen-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\glssetcategoryattributes{abbreviation}{markwords,markshortwords}{true}
+\setabbreviationstyle{short-hyphen-long-hyphen-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example069.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example069.pdf
new file mode 100644
index 0000000000..d2f29cabfa
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example069.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example069.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example069.png
new file mode 100644
index 0000000000..99a99df35b
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example069.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example069.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example069.tex
new file mode 100644
index 0000000000..5cc621732b
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example069.tex
@@ -0,0 +1,18 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 69 The short-hyphen-postlong-hyphen-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\glssetcategoryattributes{abbreviation}{markwords,markshortwords}{true}
+\setabbreviationstyle{short-hyphen-postlong-hyphen-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example070.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example070.pdf
new file mode 100644
index 0000000000..49dcf49e2c
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example070.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example070.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example070.png
new file mode 100644
index 0000000000..2984668afb
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example070.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example070.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example070.tex
new file mode 100644
index 0000000000..4e541ce75a
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example070.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 70 The long-only-short-only abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-only-short-only}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example071.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example071.pdf
new file mode 100644
index 0000000000..2bffb40ded
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example071.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example071.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example071.png
new file mode 100644
index 0000000000..c8fab5c286
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example071.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example071.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example071.tex
new file mode 100644
index 0000000000..34f2d9a202
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example071.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 71 The long-only-short-only-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-only-short-only-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example072.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example072.pdf
new file mode 100644
index 0000000000..b43c957edf
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example072.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example072.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example072.png
new file mode 100644
index 0000000000..786eedbfc1
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example072.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example072.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example072.tex
new file mode 100644
index 0000000000..fd17223672
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example072.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 72 The long-only-short-sc-only abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-only-short-sc-only}
+\newabbreviation{ex}{shrt fm}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example073.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example073.pdf
new file mode 100644
index 0000000000..9867f108f8
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example073.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example073.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example073.png
new file mode 100644
index 0000000000..77f8db782c
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example073.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example073.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example073.tex
new file mode 100644
index 0000000000..c62c8ebc46
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example073.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 73 The long-only-short-sc-only-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[11pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-only-short-sc-only-desc}
+\newabbreviation[description={sample description}]
+{ex}{shrt fm}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example074.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example074.pdf
new file mode 100644
index 0000000000..a9760afe6f
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example074.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example074.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example074.png
new file mode 100644
index 0000000000..fff841590d
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example074.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example074.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example074.tex
new file mode 100644
index 0000000000..737bf0e604
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example074.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 74 The short-footnote abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[20pt]{extarticle}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-footnote}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example075.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example075.pdf
new file mode 100644
index 0000000000..2defe83920
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example075.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example075.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example075.png
new file mode 100644
index 0000000000..a9e2ad056f
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example075.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example075.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example075.tex
new file mode 100644
index 0000000000..84eee2dc68
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example075.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 75 The short-footnote-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[20pt]{extarticle}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-footnote-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example076.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example076.pdf
new file mode 100644
index 0000000000..cdc2d9e2f2
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example076.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example076.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example076.png
new file mode 100644
index 0000000000..6d6bfb6960
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example076.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example076.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example076.tex
new file mode 100644
index 0000000000..29fad9cabf
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example076.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 76 The short-postfootnote abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[20pt]{extarticle}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-postfootnote}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example077.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example077.pdf
new file mode 100644
index 0000000000..0230694b46
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example077.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example077.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example077.png
new file mode 100644
index 0000000000..9375f0e16c
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example077.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example077.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example077.tex
new file mode 100644
index 0000000000..5a21ecd142
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example077.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 77 The short-postfootnote-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[20pt]{extarticle}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-postfootnote-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example078.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example078.pdf
new file mode 100644
index 0000000000..e03e9672b4
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example078.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example078.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example078.png
new file mode 100644
index 0000000000..c69ba01cab
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example078.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example078.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example078.tex
new file mode 100644
index 0000000000..f8ae6ac373
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example078.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 78 The short-sc-footnote abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[20pt]{extarticle}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-sc-footnote}
+\newabbreviation{ex}{shrt fm}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example079.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example079.pdf
new file mode 100644
index 0000000000..85753c2b04
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example079.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example079.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example079.png
new file mode 100644
index 0000000000..b9c66f8d56
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example079.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example079.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example079.tex
new file mode 100644
index 0000000000..979779f41d
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example079.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 79 The short-sc-footnote-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[20pt]{extarticle}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-sc-footnote-desc}
+\newabbreviation[description={sample description}]
+{ex}{shrt fm}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example080.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example080.pdf
new file mode 100644
index 0000000000..da5ffb52ce
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example080.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example080.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example080.png
new file mode 100644
index 0000000000..23927d13b2
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example080.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example080.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example080.tex
new file mode 100644
index 0000000000..43254ff34d
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example080.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 80 The short-sc-postfootnote abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[20pt]{extarticle}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-sc-postfootnote}
+\newabbreviation{ex}{shrt fm}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example081.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example081.pdf
new file mode 100644
index 0000000000..9fa9014fc7
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example081.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example081.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example081.png
new file mode 100644
index 0000000000..fddc53e100
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example081.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example081.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example081.tex
new file mode 100644
index 0000000000..14fe04e713
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example081.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 81 The short-sc-postfootnote-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[20pt]{extarticle}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-sc-postfootnote-desc}
+\newabbreviation[description={sample description}]
+{ex}{shrt fm}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example082.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example082.pdf
new file mode 100644
index 0000000000..bfc1a918a8
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example082.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example082.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example082.png
new file mode 100644
index 0000000000..00883d0852
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example082.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example082.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example082.tex
new file mode 100644
index 0000000000..874b8af0c8
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example082.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 82 The short-sm-footnote abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[20pt]{extarticle}
+\pagestyle{empty}
+
+\usepackage{relsize}\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-sm-footnote}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example083.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example083.pdf
new file mode 100644
index 0000000000..d75e1f2cb6
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example083.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example083.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example083.png
new file mode 100644
index 0000000000..b6615941c6
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example083.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example083.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example083.tex
new file mode 100644
index 0000000000..359bdff947
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example083.tex
@@ -0,0 +1,18 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 83 The short-sm-footnote-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[20pt]{extarticle}
+\pagestyle{empty}
+
+\usepackage{relsize}\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-sm-footnote-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example084.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example084.pdf
new file mode 100644
index 0000000000..c371e39c94
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example084.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example084.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example084.png
new file mode 100644
index 0000000000..c0f1ae3b76
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example084.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example084.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example084.tex
new file mode 100644
index 0000000000..8dba064f2d
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example084.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 84 The short-sm-postfootnote abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[20pt]{extarticle}
+\pagestyle{empty}
+
+\usepackage{relsize}\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-sm-postfootnote}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example085.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example085.pdf
new file mode 100644
index 0000000000..3249f1fb5c
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example085.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example085.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example085.png
new file mode 100644
index 0000000000..52250d4313
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example085.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example085.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example085.tex
new file mode 100644
index 0000000000..064a1edba6
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example085.tex
@@ -0,0 +1,18 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 85 The short-sm-postfootnote-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[20pt]{extarticle}
+\pagestyle{empty}
+
+\usepackage{relsize}\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-sm-postfootnote-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example086.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example086.pdf
new file mode 100644
index 0000000000..f61b0fb96e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example086.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example086.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example086.png
new file mode 100644
index 0000000000..4ed5a27774
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example086.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example086.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example086.tex
new file mode 100644
index 0000000000..7704ec1137
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example086.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 86 The short-em-footnote abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[20pt]{extarticle}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-em-footnote}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example087.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example087.pdf
new file mode 100644
index 0000000000..1e06ee5fa6
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example087.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example087.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example087.png
new file mode 100644
index 0000000000..de0c28f1b5
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example087.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example087.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example087.tex
new file mode 100644
index 0000000000..22acff097a
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example087.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 87 The short-em-footnote-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[20pt]{extarticle}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-em-footnote-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example088.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example088.pdf
new file mode 100644
index 0000000000..c38838d94e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example088.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example088.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example088.png
new file mode 100644
index 0000000000..0150546990
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example088.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example088.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example088.tex
new file mode 100644
index 0000000000..19bce2abe3
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example088.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 88 The short-em-postfootnote abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[20pt]{extarticle}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-em-postfootnote}
+\newabbreviation{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example089.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example089.pdf
new file mode 100644
index 0000000000..41fadcdfbe
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example089.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example089.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example089.png
new file mode 100644
index 0000000000..656a09472a
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example089.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example089.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example089.tex
new file mode 100644
index 0000000000..5928e80805
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example089.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 89 The short-em-postfootnote-desc abbreviation style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[20pt]{extarticle}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{short-em-postfootnote-desc}
+\newabbreviation[description={sample description}]
+{ex}{SHRT FM}{long form}
+\begin{document}
+First: \gls{ex}[-insert]. Next: \gls{ex}[-insert].
+Full: \glsxtrfull{ex}[-insert]. First plural: \glspl[prereset]{ex}[-insert].
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example090.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example090.pdf
new file mode 100644
index 0000000000..651c791060
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example090.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example090.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example090.png
new file mode 100644
index 0000000000..a56e6de9e8
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example090.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example090.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example090.tex
new file mode 100644
index 0000000000..f3312d5079
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example090.tex
@@ -0,0 +1,15 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 90 Illustrating the prereset option
+% Label: ex:prereset
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage {glossaries-extra}
+\glsdefpostlink {general}{\glsxtrpostlinkAddDescOnFirstUse }
+ \newglossaryentry {sample}{name={sample},
+ first={sample first use},
+ description={an example}}
+\begin{document}
+Text field: \glstext {sample}. \par First use: \gls {sample}. Next use: \gls {sample}. \par Force reset: \gls [prereset]{sample}. Used? \ifglsused {sample}{Yes}{No}. \par Force reset: \glstext [prereset]{sample}. Used? \ifglsused {sample}{Yes}{No}.
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example091.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example091.pdf
new file mode 100644
index 0000000000..43a1db6bf4
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example091.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example091.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example091.png
new file mode 100644
index 0000000000..8a7eee3e8f
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example091.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example091.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example091.tex
new file mode 100644
index 0000000000..dc213add18
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example091.tex
@@ -0,0 +1,15 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 91 Combining prereset and preunset
+% Label: ex:preresetpreunset
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage {glossaries-extra}
+\glsdefpostlink {general}{\glsxtrpostlinkAddDescOnFirstUse }
+ \newglossaryentry {sample}{name={sample},
+ first={sample first use},
+ description={an example}}
+\begin{document}
+\gls {sample}. Used? \ifglsused {sample}{Yes}{No}. \par {\glsfirst [preunset=local,prereset=global]{sample}. Used? \ifglsused {sample}{Yes}{No}. } \par Used? \ifglsused {sample}{Yes}{No}. \par {\gls [preunset=local,prereset=global]{sample}. Used? \ifglsused {sample}{Yes}{No}. } \par Used? \ifglsused {sample}{Yes}{No}.
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example092.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example092.pdf
new file mode 100644
index 0000000000..180fd12247
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example092.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example092.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example092.png
new file mode 100644
index 0000000000..a5df22506e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example092.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example092.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example092.tex
new file mode 100644
index 0000000000..9c6229cd54
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example092.tex
@@ -0,0 +1,29 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 92 References in section headings (simplistic approach)
+% arara: pdflatex
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+
+
+\glsdefpostlink{general}{\glsxtrpostlinkAddDescOnFirstUse}
+
+
+\newglossaryentry{sample}{name={sample},description={an example}}
+\newglossaryentry{alpha}{name={\ensuremath{\alpha}},description={alpha}}
+\begin{document}
+\tableofcontents
+\section{\texorpdfstring{\Glsentrytext{sample} and \glsentrytext{alpha}}{Sample and alpha}}
+
+
+First use: \gls{sample} and \gls{alpha}.
+
+
+Next use: \gls{sample} and \gls{alpha}.
+
+
+\printunsrtglossary
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example093.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example093.pdf
new file mode 100644
index 0000000000..b4336afcf0
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example093.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example093.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example093.png
new file mode 100644
index 0000000000..974c16cf4c
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example093.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example093.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example093.tex
new file mode 100644
index 0000000000..944eee90f4
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example093.tex
@@ -0,0 +1,25 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 93 References in section headings using \glsfmttext
+% arara: pdflatex
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+
+
+\glsdefpostlink{general}{\glsxtrpostlinkAddDescOnFirstUse}
+
+
+\newglossaryentry{sample}{name={sample},description={an example}}
+\newglossaryentry{alpha}{name={\ensuremath{\alpha}},description={alpha}}
+\begin{document}
+\tableofcontents \section{\Glsfmttext{sample} and \glsfmttext{alpha}}
+
+First use: \gls{sample} and \gls{alpha}.
+
+Next use: \gls{sample} and \gls{alpha}.
+
+\printunsrtglossary
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example094.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example094.pdf
new file mode 100644
index 0000000000..2f219630b0
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example094.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example094.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example094.png
new file mode 100644
index 0000000000..c4d86c5f78
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example094.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example094.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example094.tex
new file mode 100644
index 0000000000..368809c15a
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example094.tex
@@ -0,0 +1,23 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 94 Reference with hyperlink in section headings
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+
+
+\pagestyle{headings}
+\glssetcategoryattribute{general}{headuc}{true}
+\glsdefpostlink{general}{\glsxtrpostlinkAddDescOnFirstUse}
+
+
+\newglossaryentry{sample}{name={sample},description={an example}}
+\renewcommand{\glsxtrtitleopts}{}
+\begin{document}
+\section{\Glsfmttext{sample}}
+First use: \gls{sample}. Next use: \gls{sample}.
+
+\printunsrtglossary
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example095.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example095.pdf
new file mode 100644
index 0000000000..b09010b946
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example095.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example095.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example095.png
new file mode 100644
index 0000000000..b6d061ad86
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example095.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example095.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example095.tex
new file mode 100644
index 0000000000..c764dc2505
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example095.tex
@@ -0,0 +1,22 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 95 Nested link text with \glspl
+% arara: pdflatex
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-em-short-em}
+\newabbreviation{html}{HTML}{hypertext markup language}
+\newabbreviation{ssi}{SSI}{server-side includes}
+\newabbreviation{shtml}{SHTML}{\glsps{html} enabled \glsps{ssi}}
+\begin{document}
+\tableofcontents
+\section{\glsfmtlong{shtml}}
+First use: \gls{shtml}, \gls{html}, \gls{ssi}.
+
+Next use: \gls{shtml}, \gls{html}, \gls{ssi}.
+
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example096.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example096.pdf
new file mode 100644
index 0000000000..f2df4ffc1b
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example096.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example096.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example096.png
new file mode 100644
index 0000000000..abb3a84e21
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example096.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example096.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example096.tex
new file mode 100644
index 0000000000..c346bc46bc
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example096.tex
@@ -0,0 +1,32 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 96 Link text styles: outer, middle, inner, hyperlinks and post-link hook
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[14pt]{extarticle}
+\pagestyle{empty}
+ \usepackage{courier}
+\usepackage[T1]{fontenc}
+\usepackage{xcolor}
+\usepackage{soul}
+\usepackage[colorlinks]{hyperref}
+\usepackage[nogroupskip]{glossaries-extra}
+% outer formatting:
+\renewcommand{\glstextformat}[1]{\texttt{#1}}
+% middle formatting:
+\renewcommand{\glsxtrregularfont}[1]{\textbf{#1}}
+\renewcommand{\glsxtrabbreviationfont}[1]{\textit{#1}}
+% inner formatting:
+\renewcommand{\glsxtrdefaultentrytextfmt}[1]{\hl{#1}}
+% post-link hook for 'general' category:
+\glsdefpostlink{general}{\glsxtrpostlinkAddDescOnFirstUse}
+% define entries:
+\newglossaryentry{sample}{name={sample},description={an example}}
+\newabbreviation{html}{HTML}{hypertext markup language}
+\newacronym{nasa}{NASA}{National Aeronautics and Space Administration}
+\begin{document}
+ First use: \gls{sample}, \gls{html}, \gls{nasa}.
+
+Next use: \gls{sample}, \gls{html}, \gls{nasa}.
+
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example097.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example097.pdf
new file mode 100644
index 0000000000..28a941ae93
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example097.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example097.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example097.png
new file mode 100644
index 0000000000..12259d1bb8
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example097.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example097.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example097.tex
new file mode 100644
index 0000000000..ee0aee587e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example097.tex
@@ -0,0 +1,36 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 97 Link text styles: outer, middle, inner, hyperlinks and post-link hooks (custom and abbreviation style)
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[14pt]{extarticle}
+\pagestyle{empty}
+ \usepackage{courier}
+\usepackage[T1]{fontenc}
+\usepackage{xcolor}
+\usepackage{soul}
+\usepackage[colorlinks]{hyperref}
+\usepackage[nogroupskip]{glossaries-extra}
+% outer formatting:
+\renewcommand{\glstextformat}[1]{\texttt{#1}}
+% middle formatting:
+\renewcommand{\glsxtrregularfont}[1]{\textbf{#1}}
+\renewcommand{\glsxtrabbreviationfont}[1]{\textit{#1}}
+% inner formatting:
+\renewcommand{\glsxtrdefaultentrytextfmt}[1]{\hl{#1}}
+% post-link hook for 'general' category:
+\glsdefpostlink{general}{\glsxtrifwasfirstuse{ (\glsentrydesc{\glslabel})}{}}
+% this style sets the post-link hook for 'abbreviation' category:
+\setabbreviationstyle{long-postshort-user}
+% this style sets the post-link hook for 'acronym' category:
+\setabbreviationstyle[acronym]{short-postfootnote}
+% define entries:
+\newglossaryentry{sample}{name={sample},description={an example}}
+\newabbreviation{html}{HTML}{hypertext markup language}
+\newacronym{nasa}{NASA}{National Aeronautics and Space Administration}
+\begin{document}
+ First use: \gls{sample}, \gls{html}, \gls{nasa}.
+
+Next use: \gls{sample}, \gls{html}, \gls{nasa}.
+
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example098.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example098.pdf
new file mode 100644
index 0000000000..f26e9105a0
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example098.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example098.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example098.png
new file mode 100644
index 0000000000..8dd7af1a4f
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example098.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example098.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example098.tex
new file mode 100644
index 0000000000..861abe452f
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example098.tex
@@ -0,0 +1,18 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 98 Changing the outer text format
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\glsdefpostlink{general}{ (\glsentrydesc{\glslabel})}
+\newglossaryentry{sample}{name={sample},description={an example}}
+\newcommand{\strong}[1]{\textbf{\color{green}#1}} \renewcommand{\glstextformat}[1]{\emph{#1}}
+\begin{document}
+\gls{sample}[-insert]. \strong{\gls{sample}[-insert]}.
+
+\glssetcategoryattribute{general}{textformat}{strong} \gls{sample}[-insert]. \gls[hyperoutside=false]{sample}[-insert].
+
+\gls[textformat=textsf]{sample}[-insert].
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example099.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example099.pdf
new file mode 100644
index 0000000000..4fa00c00bc
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example099.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example099.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example099.png
new file mode 100644
index 0000000000..52e9fe57db
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example099.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example099.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example099.tex
new file mode 100644
index 0000000000..eb576a0b9c
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example099.tex
@@ -0,0 +1,10 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 99 Middle formatting
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage{glossaries-extra} \newglossaryentry{sample}{name={sample},description={an example}} \newabbreviation{html}{HTML}{hypertext markup language} \newacronym{radar}{radar}{radio detection and ranging} \renewcommand{\glsxtrregularfont}[1]{\emph{#1}} \renewcommand{\glsxtrabbreviationfont}[1]{\textbf{#1}}
+\begin{document}
+\gls{sample}, \gls{html}, \gls{radar}.
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example100.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example100.pdf
new file mode 100644
index 0000000000..6c77f964a7
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example100.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example100.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example100.png
new file mode 100644
index 0000000000..e009eb0a4e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example100.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example100.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example100.tex
new file mode 100644
index 0000000000..a202be71b8
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example100.tex
@@ -0,0 +1,20 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 100 Inner formatting
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+% requires glossaries.sty v4.50+ and mfirstuc v2.08+
+ \usepackage{soul}
+\usepackage{glossaries-extra}
+\renewcommand{\glssentencecase}[1]{\MFUsentencecase{#1}}
+\newacronym{radar}{radar}{radio detection and ranging}
+\begin{document}
+\Gls[innertextformat=fbox]{radar}['s] system\ldots
+
+\Gls[innertextformat=so]{radar}['s] system\ldots
+
+\fbox{\Gls{radar}['s]} system\ldots
+
+\so{\mbox{\Gls{radar}['s]}} system\ldots
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example101.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example101.pdf
new file mode 100644
index 0000000000..497f724633
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example101.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example101.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example101.png
new file mode 100644
index 0000000000..9ffa50f3a6
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example101.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example101.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example101.tex
new file mode 100644
index 0000000000..b95fb5061c
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example101.tex
@@ -0,0 +1,12 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 101 Category post-link hook
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage{glossaries-extra}
+\glsdefpostlink{general}{*}
+\newglossaryentry{sample}{name={sample},symbol={X},description={an example}}
+\begin{document}
+\Gls{sample}, \glstext{sample}, \glsdesc{sample} and \glssymbol{sample}.
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example102.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example102.pdf
new file mode 100644
index 0000000000..b556aec09e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example102.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example102.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example102.png
new file mode 100644
index 0000000000..999117474e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example102.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example102.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example102.tex
new file mode 100644
index 0000000000..96f0e2fe6c
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example102.tex
@@ -0,0 +1,12 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 102 Category post-link hook with punctuation lookahead
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage{glossaries-extra}
+\glsdefpostlink{general}{\glsxtrdopostpunc{*}}
+\newglossaryentry{sample}{name={sample},symbol={X},description={an example}}
+\begin{document}
+\Gls{sample}, \glstext{sample}, (\glsdesc{sample}) and \glssymbol{sample}.
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example103.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example103.pdf
new file mode 100644
index 0000000000..b46d86bdab
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example103.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example103.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example103.png
new file mode 100644
index 0000000000..6f0556fc2c
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example103.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example103.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example103.tex
new file mode 100644
index 0000000000..9dfbd82717
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example103.tex
@@ -0,0 +1,20 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 103 Category post-link hooks
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage{glossaries-extra}
+\glsdefpostlink{general}{\glsxtrpostlinkAddDescOnFirstUse}
+\glsdefpostlink{symbol}{\glsxtrpostlinkAddSymbolOnFirstUse}
+\glsdefpostlink{number}{\glsxtrpostlinkAddSymbolDescOnFirstUse}
+\newglossaryentry{sample}{name={sample},description={an example}}
+\newglossaryentry{alpha}{name={alpha},symbol={\ensuremath{\alpha}},
+description={a symbol},category={symbol}}
+\newglossaryentry{pi}{name={pi},symbol={\ensuremath{\pi}},
+description={a constant},category={number}}
+\begin{document}
+First use: \gls{sample}, \gls{alpha}, \gls{pi}.
+
+Next use: \gls{sample}, \gls{alpha}, \gls{pi}.
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example104.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example104.pdf
new file mode 100644
index 0000000000..97d66ae96c
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example104.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example104.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example104.png
new file mode 100644
index 0000000000..5df4885507
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example104.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example104.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example104.tex
new file mode 100644
index 0000000000..9981b7f2cf
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example104.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 104 Location list ordering (makeindex)
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage{glossaries-extra}
+\makeglossaries
+\newglossaryentry{sample}{name={sample},description={an example}}
+\begin{document}
+\gls[thevalue=Z]{sample} (Z), \gls[thevalue=4]{sample} (4),
+\gls[thevalue=xi]{sample} (xi), \gls[thevalue=2]{sample} (2),
+\gls[thevalue=iii]{sample} (iii), \gls[thevalue=A]{sample} (A).
+\printglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example105.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example105.pdf
new file mode 100644
index 0000000000..de5530e488
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example105.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example105.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example105.png
new file mode 100644
index 0000000000..555fe901a9
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example105.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example105.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example105.tex
new file mode 100644
index 0000000000..8ae4cbc4e5
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example105.tex
@@ -0,0 +1,21 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 105 Location list ordering (bib2gls)
+% arara: pdflatex
+% arara: bib2gls
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\begin{filecontents*}{\jobname.bib}
+@entry{sample,name={sample},description={an example}}
+\end{filecontents*}
+\usepackage[record]{glossaries-extra}
+\GlsXtrLoadResources
+\begin{document}
+\gls[thevalue=Z]{sample} (Z), \gls[thevalue=4]{sample} (4),
+\gls[thevalue=xi]{sample} (xi), \gls[thevalue=2]{sample} (2),
+\gls[thevalue=iii]{sample} (iii), \gls[thevalue=A]{sample} (A).
+
+
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example106.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example106.pdf
new file mode 100644
index 0000000000..5c74fefe5f
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example106.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example106.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example106.png
new file mode 100644
index 0000000000..f96e1e7bdb
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example106.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example106.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example106.tex
new file mode 100644
index 0000000000..58342294e8
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example106.tex
@@ -0,0 +1,32 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 106 Cross-references (autoseeindex=true)
+% Label: ex:autoseeindextrue
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage [colorlinks]{hyperref}
+\usepackage [nostyles,stylemods=bookindex,style=bookindex]
+{glossaries-extra}
+\makeglossaries
+\newglossaryentry {pumpkin}{name={pumpkin},description={}}
+\newglossaryentry {cucumber}{name={cucumber},description={}}
+\newglossaryentry {melon}{name={melon},description={}}
+\newglossaryentry {gourd}{name={gourd},description={},
+see={pumpkin,cucumber,melon}}
+\newglossaryentry {cucurbit}{name={cucurbit},description={},
+see={gourd}}
+\newglossaryentry {courgette}{name={courgette},description={}}
+\newglossaryentry {marrow}{name={marrow},description={},
+seealso={courgette}}
+\newglossaryentry {zucchini}{name={zucchini},description={},
+alias={courgette}}
+\newglossaryentry {broccoli}{name={broccoli},description={}}
+\newglossaryentry {cauliflower}{name={cauliflower},description={}, seealso={broccoli}}
+
+\begin{document}
+ This document is only discussing \glspl {courgette} (baby \glspl {marrow}, also called a \gls {zucchini}), \glspl {pumpkin} and \glspl {melon}.
+\printglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example107.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example107.pdf
new file mode 100644
index 0000000000..29dd217845
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example107.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example107.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example107.png
new file mode 100644
index 0000000000..9772c6f8e2
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example107.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example107.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example107.tex
new file mode 100644
index 0000000000..a72db9adbf
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example107.tex
@@ -0,0 +1,32 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 107 Cross-references (autoseeindex=false)
+% Label: ex:autoseeindexfalse
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage [colorlinks]{hyperref}
+\usepackage [autoseeindex=false,nostyles,stylemods=bookindex,style=bookindex]
+{glossaries-extra}
+\makeglossaries
+\newglossaryentry {pumpkin}{name={pumpkin},description={}}
+\newglossaryentry {cucumber}{name={cucumber},description={}}
+\newglossaryentry {melon}{name={melon},description={}}
+\newglossaryentry {gourd}{name={gourd},description={},
+see={pumpkin,cucumber,melon}}
+\newglossaryentry {cucurbit}{name={cucurbit},description={},
+see={gourd}}
+\newglossaryentry {courgette}{name={courgette},description={}}
+\newglossaryentry {marrow}{name={marrow},description={},
+seealso={courgette}}
+\newglossaryentry {zucchini}{name={zucchini},description={},
+alias={courgette}}
+\newglossaryentry {broccoli}{name={broccoli},description={}}
+\newglossaryentry {cauliflower}{name={cauliflower},description={}, seealso={broccoli}}
+
+\begin{document}
+ This document is only discussing \glspl {courgette} (baby \glspl {marrow}, also called a \gls {zucchini}), \glspl {pumpkin} and \glspl {melon}.
+\printglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example108.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example108.pdf
new file mode 100644
index 0000000000..ff0b2f0146
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example108.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example108.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example108.png
new file mode 100644
index 0000000000..3da47d29f9
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example108.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example108.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example108.tex
new file mode 100644
index 0000000000..8d95154d6c
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example108.tex
@@ -0,0 +1,34 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 108 Cross-references (autoseeindex=false and post-name hook)
+% Label: ex:autoseeindexfalsepostname
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage [colorlinks]{hyperref}
+\usepackage [autoseeindex=false,nostyles,
+stylemods=bookindex,style=bookindex]{glossaries-extra}
+\makeglossaries
+\newglossaryentry {pumpkin}{name={pumpkin},description={}}
+\newglossaryentry {cucumber}{name={cucumber},description={}}
+\newglossaryentry {melon}{name={melon},description={}}
+\newglossaryentry {gourd}{name={gourd},description={},
+see={pumpkin,cucumber,melon}}
+\newglossaryentry {cucurbit}{name={cucurbit},description={},
+see={gourd}}
+\newglossaryentry {courgette}{name={courgette},description={}}
+\newglossaryentry {marrow}{name={marrow},description={},
+seealso={courgette}}
+\newglossaryentry {zucchini}{name={zucchini},description={},
+alias={courgette}}
+\newglossaryentry {broccoli}{name={broccoli},description={}}
+\newglossaryentry {cauliflower}{name={cauliflower},description={}, seealso={broccoli}}
+\glsdefpostname {general}{\glsxtrseelists {\glscurrententrylabel }}
+
+\begin{document}
+ This document is only discussing \glspl {courgette} (baby \glspl {marrow}, also called a \gls {zucchini}), \glspl {pumpkin} and \glspl {melon}.
+\printglossaries
+
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example109.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example109.pdf
new file mode 100644
index 0000000000..fc03f19639
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example109.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example109.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example109.png
new file mode 100644
index 0000000000..3b251a5dfb
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example109.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example109.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example109.tex
new file mode 100644
index 0000000000..cb32d5d0aa
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example109.tex
@@ -0,0 +1,30 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 109 Cross-references (no see, seealso or alias)
+% Label: ex:noxrfields
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage [colorlinks]{hyperref}
+\usepackage [nostyles,stylemods=bookindex,style=bookindex]{glossaries-extra}
+\makeglossaries
+\newglossaryentry {pumpkin}{name={pumpkin},description={}}
+\newglossaryentry {cucumber}{name={cucumber},description={}}
+\newglossaryentry {melon}{name={melon},description={}}
+\newglossaryentry {gourd}{name={gourd},description={}}
+\newglossaryentry {cucurbit}{name={cucurbit},description={}}
+\newglossaryentry {courgette}{name={courgette},description={}}
+\newglossaryentry {marrow}{name={marrow},description={}}
+\newglossaryentry {zucchini}{name={zucchini},description={}}
+\newglossaryentry {broccoli}{name={broccoli},description={}}
+\newglossaryentry {cauliflower}{name={cauliflower},description={}}
+\glssee {gourd}{pumpkin,melon,courgette}
+\glssee {zucchini}{courgette}
+\GlsXtrSetField {zucchini}{alias}{courgette}
+
+\begin{document}
+ This document is only discussing \glspl {courgette} (baby \glspl {marrow}, also called a \gls {zucchini}), \glspl {pumpkin} and \glspl {melon}.
+\printglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example110.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example110.pdf
new file mode 100644
index 0000000000..28112e2f71
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example110.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example110.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example110.png
new file mode 100644
index 0000000000..e781a416cf
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example110.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example110.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example110.tex
new file mode 100644
index 0000000000..4320040cfa
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example110.tex
@@ -0,0 +1,28 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 110 Cross-references (bib2gls)
+% arara: pdflatex
+% arara: bib2gls: { group: on }
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\begin{filecontents*}{\jobname.bib}
+% Encoding: UTF-8
+@index{pumpkin, name = {pumpkin}}
+@index{cucumber, name = {cucumber}}
+@index{melon, name = {melon}}
+@index{gourd, see = {pumpkin,cucumber,melon}, name = {gourd}}
+@index{cucurbit, see = {gourd}, name = {cucurbit}}
+@index{courgette, name = {courgette}}
+@index{marrow, name = {marrow}, seealso = {courgette}}
+@index{zucchini, name = {zucchini}, alias = {courgette}}
+@index{broccoli, name = {broccoli}}
+@index{cauliflower, name = {cauliflower}, seealso = {broccoli} }
+\end{filecontents*}
+\usepackage[colorlinks]{hyperref}
+\usepackage[record,nostyles,stylemods=bookindex,style=bookindex]{glossaries-extra}
+\GlsXtrLoadResources[src=\jobname]
+\begin{document}
+ This document is only discussing \glspl{courgette} (baby \glspl{marrow}, also called a \gls{zucchini}), \glspl{pumpkin} and \glspl{melon}.
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example111.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example111.pdf
new file mode 100644
index 0000000000..8694ba16b1
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example111.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example111.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example111.png
new file mode 100644
index 0000000000..fd4a7b1f78
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example111.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example111.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example111.tex
new file mode 100644
index 0000000000..97e8318bd3
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example111.tex
@@ -0,0 +1,28 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 111 Cross-references (bib2gls and selection=recorded and deps and see)
+% arara: pdflatex
+% arara: bib2gls: { group: on }
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\begin{filecontents*}{\jobname.bib}
+% Encoding: UTF-8
+@index{pumpkin, name = {pumpkin}}
+@index{cucumber, name = {cucumber}}
+@index{melon, name = {melon}}
+@index{gourd, see = {pumpkin,cucumber,melon}, name = {gourd}}
+@index{cucurbit, see = {gourd}, name = {cucurbit}}
+@index{courgette, name = {courgette}}
+@index{marrow, name = {marrow}, seealso = {courgette}}
+@index{zucchini, name = {zucchini}, alias = {courgette}}
+@index{broccoli, name = {broccoli}}
+@index{cauliflower, name = {cauliflower}, seealso = {broccoli} }
+\end{filecontents*}
+\usepackage[colorlinks]{hyperref}
+\usepackage[record,nostyles,stylemods=bookindex,style=bookindex]{glossaries-extra}
+\GlsXtrLoadResources[src=\jobname,selection={recorded and deps and see}]
+\begin{document}
+ This document is only discussing \glspl{courgette} (baby \glspl{marrow}, also called a \gls{zucchini}), \glspl{pumpkin} and \glspl{melon}.
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example112.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example112.pdf
new file mode 100644
index 0000000000..bf8555f1eb
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example112.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example112.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example112.png
new file mode 100644
index 0000000000..2b755be66a
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example112.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example112.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example112.tex
new file mode 100644
index 0000000000..cbc76b091b
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example112.tex
@@ -0,0 +1,28 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 112 Cross-references (bib2gls and selection=recorded and deps and see, prune-xr)
+% arara: pdflatex
+% arara: bib2gls: { group: on }
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\begin{filecontents*}{\jobname.bib}
+% Encoding: UTF-8
+@index{pumpkin, name = {pumpkin}}
+@index{cucumber, name = {cucumber}}
+@index{melon, name = {melon}}
+@index{gourd, see = {pumpkin,cucumber,melon}, name = {gourd}}
+@index{cucurbit, see = {gourd}, name = {cucurbit}}
+@index{courgette, name = {courgette}}
+@index{marrow, name = {marrow}, seealso = {courgette}}
+@index{zucchini, name = {zucchini}, alias = {courgette}}
+@index{broccoli, name = {broccoli}}
+@index{cauliflower, name = {cauliflower}, seealso = {broccoli} }
+\end{filecontents*}
+\usepackage[colorlinks]{hyperref}
+\usepackage[record,nostyles,stylemods=bookindex,style=bookindex]{glossaries-extra}
+\GlsXtrLoadResources[src=\jobname,selection={recorded and deps and see},prune-xr]
+\begin{document}
+ This document is only discussing \glspl{courgette} (baby \glspl{marrow}, also called a \gls{zucchini}), \glspl{pumpkin} and \glspl{melon}.
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example113.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example113.pdf
new file mode 100644
index 0000000000..2a5717a9cb
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example113.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example113.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example113.png
new file mode 100644
index 0000000000..da4d9ef8bd
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example113.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example113.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example113.tex
new file mode 100644
index 0000000000..a7ba18aa7a
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example113.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 113 Resetting the first use flag (\glsreset)
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage{glossaries-extra}
+\newabbreviation{html}{HTML}{hypertext markup language}
+\begin{document}
+\begin{abstract}
+ This abstract mentions \gls{html}.
+ \end{abstract}
+ Some casual reference to \gls{html}.
+ \section{Web Pages}
+ \glsreset{html}This section is all about \gls{html}.
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example114.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example114.pdf
new file mode 100644
index 0000000000..c8a38bc592
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example114.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example114.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example114.png
new file mode 100644
index 0000000000..a731fd1fae
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example114.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example114.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example114.tex
new file mode 100644
index 0000000000..85fec7079f
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example114.tex
@@ -0,0 +1,19 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 114 Local unset
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage{glossaries-extra}
+\newabbreviation{html}{HTML}{hypertext markup language}
+\begin{document}
+{% local scope
+ \gls[local]{html}.
+ Used? \ifglsused{html}{Yes}{No}.
+ }% end scope
+
+
+Used? \ifglsused{html}{Yes}{No}.
+
+\gls[postunset=none]{html}. Used? \ifglsused{html}{Yes}{No}.
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115-page1.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115-page1.png
new file mode 100644
index 0000000000..72ac0e36ae
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115-page1.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115-page2.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115-page2.png
new file mode 100644
index 0000000000..095500d692
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115-page2.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115-page3.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115-page3.png
new file mode 100644
index 0000000000..1d6e991a82
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115-page3.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115-page4.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115-page4.png
new file mode 100644
index 0000000000..a29541e8b5
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115-page4.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115.pdf
new file mode 100644
index 0000000000..bace3f5381
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115.tex
new file mode 100644
index 0000000000..100e99413e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example115.tex
@@ -0,0 +1,29 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 115 Abbreviations with beamer (unset buffering)
+% arara: pdflatex
+% arara: pdflatex
+\documentclass[12pt]{beamer}
+\pagestyle{empty}
+\usepackage{glossaries-extra}
+\newabbreviation{svm}{SVM}{support vector machine}
+\newabbreviation{html}{HTML}{hypertext markup language}
+\begin{document}
+\begin{frame}
+ \frametitle{Frame 1}
+ \begin{itemize}
+ \item \gls{html} and \gls{html}
+ \end{itemize}
+ \end{frame}
+\GlsXtrStartUnsetBuffering
+\GlsXtrUnsetBufferEnableRepeatLocal
+\begin{frame}
+\GlsXtrResetLocalBuffer
+ \frametitle{Frame 2}
+ \begin{itemize}
+ \item<+-> \gls{svm} and \gls{svm}
+ \item<+-> \gls{svm} and \gls{html}
+ \end{itemize}
+\end{frame}
+\GlsXtrStopUnsetBuffering
+\frame{\printunsrtglossaries}
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example116.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example116.pdf
new file mode 100644
index 0000000000..dbd6aaa142
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example116.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example116.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example116.png
new file mode 100644
index 0000000000..526f2c468b
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example116.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example116.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example116.tex
new file mode 100644
index 0000000000..ddcdf0053e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example116.tex
@@ -0,0 +1,21 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 116 Buffering first use unsets with \mbox
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage{soul}
+\usepackage{glossaries-extra}
+
+
+\newabbreviation{html}{HTML}{hypertext markup language}
+\begin{document}
+\GlsXtrStartUnsetBuffering
+\ul{Some text about \mbox{\gls{html}}.
+Next use: \mbox{\gls{html}}.}
+\GlsXtrStopUnsetBuffering
+
+
+Next use: \gls{html}.
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example117.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example117.pdf
new file mode 100644
index 0000000000..e26d37e7b7
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example117.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example117.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example117.png
new file mode 100644
index 0000000000..ba2aee1ee5
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example117.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example117.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example117.tex
new file mode 100644
index 0000000000..1252cd3561
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example117.tex
@@ -0,0 +1,38 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 117 Alternatives to buffering
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage{soul}
+\usepackage{glossaries-extra}
+
+
+\newabbreviation{html}{HTML}{hypertext markup language}
+% custom command to expand content before using \ul:
+ \newrobustcmd{\xpul}[1]{\GlsXtrExpandedFmt{\ul}{#1}}
+
+
+\begin{document}
+First approach (inner formatting):
+{% scope
+ \renewcommand{\glsxtrdefaultentrytextfmt}[1]{\ul{#1}}%
+ \ul{Some text about \protect\gls{html}.
+ Next use: \protect\gls{html}}
+}
+
+
+Next use: \gls{html}.
+
+
+Second approach (middle formatting with expanded link text):
+\glsresetall
+{% scope
+ \renewcommand{\glsxtrabbreviationfont}[1]{\xpul{#1}}%
+ \renewcommand{\glsxtrregularfont}[1]{\xpul{#1}}%
+ \ul{Some text about \protect\gls{html}. Next use: \gls{html}.}
+}
+
+Next use: \gls{html}.
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example118.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example118.pdf
new file mode 100644
index 0000000000..8998770dc4
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example118.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example118.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example118.png
new file mode 100644
index 0000000000..b116f8db82
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example118.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example118.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example118.tex
new file mode 100644
index 0000000000..6e24c3a7cb
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example118.tex
@@ -0,0 +1,38 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 118 Foreign language field encapsulation
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[main=british,brazilian,ngerman]{babel}
+\usepackage{glossaries-extra}
+\setabbreviationstyle{long-short-user}
+\newabbreviation
+[user1={Associação Brasileria de Normas Técnicas},
+user2={pt-BR}
+]
+{abnt}{ABNT}{Brazilian National Standards Organization}
+
+
+\newabbreviation
+[user1={Deutsches Institut für Normung e.V.},
+user2={de-DE-1996}]
+{din}{DIN}{German Institute for Standardization}
+
+
+\newabbreviation{tug}{TUG}{\TeX\ User Group}
+
+
+\renewcommand*{\glsxtruserparen}[2]{%
+\glsxtrfullsep{#2}%
+\glsxtrparen
+{#1%
+\ifglshasfield{\glsxtruserfield}{#2}%
+{, \emph{\GlsXtrForeignText{#2}{\glscurrentfieldvalue}}}%
+{}%
+}%
+}
+\begin{document}
+ \gls{abnt}, \gls{din}, \gls{tug}.
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example119.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example119.pdf
new file mode 100644
index 0000000000..abcb138537
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example119.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example119.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example119.png
new file mode 100644
index 0000000000..134e407961
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example119.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example119.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example119.tex
new file mode 100644
index 0000000000..dbe5e81d8d
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example119.tex
@@ -0,0 +1,58 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 119 Storing a formatting command in a field
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[T1]{fontenc}
+\usepackage{amsmath}
+\usepackage[colorlinks]{hyperref}
+\usepackage[postdot,style=index]{glossaries-extra}
+
+
+\makeglossaries
+
+
+\newcommand*{\mtx}[1]{\boldsymbol{#1}}
+\newcommand*{\mtxinv}[1]{\mtx{#1}\sp{-1}}
+
+
+\newglossaryentry{matrix}{%
+name={matrix},
+symbol={\ensuremath{\mtx{M}}},
+plural={matrices},
+user1={mtx},
+description={rectangular array of values}
+}
+
+
+\newglossaryentry{identitymatrix}{%
+name={identity matrix},
+symbol={\ensuremath{\mtx{I}}},
+plural={identity matrices},
+description={a diagonal matrix with all diagonal elements equal to
+1 and all other elements equal to 0}
+}
+
+\newglossaryentry{matrixinv}{%
+name={matrix inverse},
+symbol={\ensuremath{\mtxinv{M}}},
+user1={mtxinv},
+description={a square \gls{matrix} such that
+$\mtx{M}\mtxinv{M}=\glssymbol{identitymatrix}$}
+}
+
+\begin{document}
+A \gls{matrix} is denoted \glssymbol{matrix}.
+The inverse is denoted \glssymbol{matrixinv}.
+\[
+\glsxtrfmt{matrix}{A}
+\glsxtrfmt{matrixinv}{A}
+=
+\glssymbol{identitymatrix}
+\]
+Compare $\glsxtrfmt{matrix}{A}[_0]$
+with $\glsxtrfmt*{matrix}{A}[_0]$. \printglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example120.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example120.pdf
new file mode 100644
index 0000000000..ef5df39f80
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example120.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example120.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example120.png
new file mode 100644
index 0000000000..bec47ab750
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example120.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example120.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example120.tex
new file mode 100644
index 0000000000..a20ad70cc5
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example120.tex
@@ -0,0 +1,25 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 120 Formatting lists contained in field values
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref}
+\usepackage[autoseeindex=false]{glossaries-extra}
+\newglossaryentry{example}{name=example,description={},
+see={another1,another2}}
+\newglossaryentry{another1}{name={another one},description={}}
+\newglossaryentry{another2}{name={another two},description={}}
+
+\begin{document}
+\glsxtrapptocsvfield{example}{animals}{duck}
+\glsxtrapptocsvfield{example}{animals}{albatross}
+\glsxtrapptocsvfield{example}{animals}{arara}
+Animal list: \glsxtrfieldformatcsvlist{example}{animals}.
+
+
+See list: \glsxtrifhasfield{see}{example}{\glsxtrseelist{\glscurrentfieldvalue}}{not set}.
+
+
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example121.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example121.pdf
new file mode 100644
index 0000000000..9bf95ecff5
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example121.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example121.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example121.png
new file mode 100644
index 0000000000..6589261777
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example121.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example121.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example121.tex
new file mode 100644
index 0000000000..7f75162810
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example121.tex
@@ -0,0 +1,22 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 121 Entry counting according to category
+% arara: pdflatex
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\makeglossaries
+\GlsXtrEnableEntryCounting{abbreviation}{1}
+\newabbreviation{css}{CSS}{cascading style sheet}
+\newabbreviation{html}{HTML}{hypertext markup language}
+\newglossaryentry{sample}{name={sample},description={an example}}
+
+\begin{document}
+First use: \gls{css}, \gls{html} and \gls{sample}.
+Next use: \gls{html}.
+\printglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example122.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example122.pdf
new file mode 100644
index 0000000000..769812e76d
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example122.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example122.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example122.png
new file mode 100644
index 0000000000..007de9a19e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example122.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example122.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example122.tex
new file mode 100644
index 0000000000..34af7412bf
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example122.tex
@@ -0,0 +1,36 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 122 Entry unit counting (per section) according to category
+% arara: pdflatex
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+\GlsXtrEnableEntryUnitCounting{abbreviation}{2}{section}
+\makeglossaries
+% category=abbreviation:
+\newabbreviation{html}{HTML}{hypertext markup language}
+\newabbreviation{css}{CSS}{cascading style sheet}
+% category=general:
+\newglossaryentry{sample}{name={sample},description={an example}}
+
+\begin{document}
+\section{Sample}
+
+Used once: \gls{html}.
+
+Used three times: \gls{css} and \gls{css} and \gls{css}.
+
+Used once: \gls{sample}.
+
+\section{Another Sample}
+
+Used once: \gls{css}.
+
+Used twice: \gls{html} and \gls{html}.
+
+\printglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example123-page1.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example123-page1.png
new file mode 100644
index 0000000000..acc0bb52fd
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example123-page1.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example123-page2.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example123-page2.png
new file mode 100644
index 0000000000..d773219fee
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example123-page2.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example123.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example123.pdf
new file mode 100644
index 0000000000..b2f69e245f
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example123.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example123.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example123.tex
new file mode 100644
index 0000000000..b4dce2def3
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example123.tex
@@ -0,0 +1,35 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 123 Enabling unit counting to hook into hyperlink setting
+% arara: pdflatex
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+
+
+\makeglossaries
+
+
+\GlsXtrEnableEntryUnitCounting{general}{0}{page}
+
+
+\newglossaryentry{sample}{name={sample},description={an example}}
+
+
+\renewcommand*{\glslinkcheckfirsthyperhook}{%
+ \ifnum\glsentrycurrcount\glslabel>0
+ \setupglslink{hyper=false}%
+ \fi
+}
+\begin{document}
+A \gls{sample} entry. Next use: \gls{sample}.
+
+\newpage
+Next page: \gls{sample}. Again: \gls{sample}.
+
+\printglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example124.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example124.pdf
new file mode 100644
index 0000000000..90c3960088
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example124.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example124.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example124.png
new file mode 100644
index 0000000000..7291604f11
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example124.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example124.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example124.tex
new file mode 100644
index 0000000000..fab7428ff3
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example124.tex
@@ -0,0 +1,42 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 124 Link counting used to selectively suppress hyperlinks
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref}
+\usepackage{glossaries-extra}
+
+\makeglossaries
+
+\renewcommand*{\glslinkpresetkeys}{%
+ \ifnum\GlsXtrLinkCounterValue{\glslabel}>1
+ \setupglslink{hyper=false}%
+\fi }
+
+\GlsXtrEnableLinkCounting{general}
+
+\newglossaryentry{sample1}{name={sample1},description={an example}}
+\newglossaryentry{sample2}{name={sample2},description={another example}}
+
+\newabbreviation{ex}{ex}{example}
+
+
+\begin{document}
+\section{Sample Section}
+
+
+\Gls{sample1}, \gls{sample2} and \gls{ex}.
+\Glstext{sample1} and \gls{ex} again.
+
+
+\section{Another Sample Section}
+
+
+\Gls{sample1}, \gls{sample2} and \gls{ex}.
+
+
+\printglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example125.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example125.pdf
new file mode 100644
index 0000000000..e3ad2c2a0d
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example125.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example125.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example125.png
new file mode 100644
index 0000000000..1115bfa055
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example125.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example125.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example125.tex
new file mode 100644
index 0000000000..450451c4ec
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example125.tex
@@ -0,0 +1,47 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 125 Multi-entries: hierarchical
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref}
+\usepackage[stylemods=bookindex,style=bookindex]{glossaries-extra}
+
+
+\makeglossaries
+
+
+\newcommand{\latinname}[1]{\emph{#1}}
+\glssetcategoriesattributes
+ {genus,species}{textformat,glossnamefont}{latinname}
+
+
+\setabbreviationstyle[genus]{long-only-short-only-desc}
+\newabbreviation
+ [category={genus},description={}]
+ {clostridium}{C.}{Clostridium}
+
+
+\newglossaryentry{botulinum}{name={botulinum},category={species},
+ description={},parent={clostridium}}
+\newglossaryentry{perfringens}{name={perfringens},category={species},
+ description={},parent={clostridium}}
+\newglossaryentry{tetani}{name={tetani},category={species},
+ description={},parent={clostridium}}
+
+
+\multiglossaryentry{cbot}{clostridium,botulinum}
+\multiglossaryentry{cperf}{clostridium,perfringens}
+\multiglossaryentry{ctet}{clostridium,tetani}
+
+
+\multiglossaryentrysetup{indexothers=false,hyper=allmain}
+\begin{document}
+First use: \mgls{cbot}, \mgls{cperf}, \mgls{ctet}.
+
+
+Next use: \mgls{cbot}, \mgls{cperf}, \mgls{ctet}.
+\printglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example126.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example126.pdf
new file mode 100644
index 0000000000..fc17c5aece
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example126.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example126.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example126.png
new file mode 100644
index 0000000000..f356257c32
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example126.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example126.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example126.tex
new file mode 100644
index 0000000000..b2f609bbd8
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example126.tex
@@ -0,0 +1,47 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 126 Multi-entries: hierarchical with first-use suffix
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref}
+\usepackage[stylemods=bookindex,style=bookindex]{glossaries-extra}
+
+
+\makeglossaries
+
+
+\newcommand{\latinname}[1]{\emph{#1}}
+\glssetcategoriesattributes
+ {genus,species}{textformat,glossnamefont}{latinname}
+
+
+\setabbreviationstyle[genus]{long-only-short-only-desc}
+\newabbreviation
+ [category={genus},description={}]
+ {clostridium}{C.}{Clostridium}
+
+
+\newglossaryentry{botulinum}{name={botulinum},category={species},
+ description={},parent={clostridium}}
+\newglossaryentry{perfringens}{name={perfringens},category={species},
+ description={},parent={clostridium}}
+\newglossaryentry{tetani}{name={tetani},category={species},
+ description={},parent={clostridium}}
+
+
+\multiglossaryentry[firstsuffix=botulism]{cbot}{clostridium,botulinum}
+\multiglossaryentry[firstsuffix=gas gangrene]{cperf}{clostridium,perfringens}
+\multiglossaryentry[firstsuffix=tetanus]{ctet}{clostridium,tetani}
+
+
+\multiglossaryentrysetup{indexothers=false,hyper=allmain}
+\begin{document}
+First use: \mgls{cbot}, \mgls{cperf}, \mgls{ctet}.
+
+
+Next use: \mgls{cbot}, \mgls{cperf}, \mgls{ctet}.
+\printglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example127.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example127.pdf
new file mode 100644
index 0000000000..083a1b7be2
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example127.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example127.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example127.png
new file mode 100644
index 0000000000..5e80a30e8f
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example127.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example127.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example127.tex
new file mode 100644
index 0000000000..14675745b0
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example127.tex
@@ -0,0 +1,56 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 127 Multi-entries: hierarchical with category suffix
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref}
+\usepackage[stylemods=bookindex,style=bookindex]{glossaries-extra}
+
+
+\makeglossaries
+
+
+\newcommand{\latinname}[1]{\emph{#1}}
+\glssetcategoriesattributes
+ {genus,species}{textformat,glossnamefont}{latinname}
+
+
+\setabbreviationstyle[genus]{long-only-short-only-desc}
+\newabbreviation
+ [category={genus},description={}]
+ {clostridium}{C.}{Clostridium}
+
+
+\newglossaryentry{botulinum}{name={botulinum},category={species},
+ user1={botulism},
+ description={},parent={clostridium}}
+\newglossaryentry{perfringens}{name={perfringens},category={species},
+ user1={gas gangrene},
+ description={},parent={clostridium}}
+\newglossaryentry{tetani}{name={tetani},category={species},
+ user1={tetanus},
+ description={},parent={clostridium}}
+
+
+\mglsdefcategorysuffix{bacteria}{%
+\mglsisfirstuse
+ {\glsxtrifhasfield{useri}{\mglslastelementlabel}{ (\glscurrentfieldvalue)}{}}%
+ {}%
+}
+
+\multiglossaryentry[category=bacteria]{cbot}{clostridium,botulinum}
+\multiglossaryentry[category=bacteria]{cperf}{clostridium,perfringens}
+\multiglossaryentry[category=bacteria]{ctet}{clostridium,tetani}
+
+
+\multiglossaryentrysetup{indexothers=false,hyper=allmain}
+\begin{document}
+First use: \mgls{cbot}, \mgls{cperf}, \mgls{ctet}.
+
+
+Next use: \mgls{cbot}, \mgls{cperf}, \mgls{ctet}.
+\printglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example128.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example128.pdf
new file mode 100644
index 0000000000..183c2342ad
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example128.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example128.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example128.png
new file mode 100644
index 0000000000..8a7d0c138a
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example128.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example128.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example128.tex
new file mode 100644
index 0000000000..d5a0d59ee3
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example128.tex
@@ -0,0 +1,55 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 128 Multi-entries: separators
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref}
+\usepackage[stylemods=bookindex,style=bookindex]{glossaries-extra}
+
+\makeglossaries
+
+\newcommand{\latinname}[1]{\emph{#1}}
+\glssetcategoriesattributes
+ {genus,species}{textformat,glossnamefont}{latinname}
+
+
+% multi-entry category attributes:
+\glssetcategoryattribute{genus}{combinedfirstsepfirst}{\space}
+\glssetcategoryattribute{genus}{combinedfirstsep}{\space}
+\glssetcategoryattribute{genus}{combinedsepfirst}{~}
+\glssetcategoryattribute{genus}{combinedsep}{\relax}
+
+
+\setabbreviationstyle[genus]{long-only-short-only-desc}
+\newabbreviation
+ [category={genus},description={}]
+ {clostridium}{C.}{Clostridium}
+
+\setabbreviationstyle[species]{long-only-short-only-desc}
+
+
+\newabbreviation[category={species},
+ description={},parent={clostridium}]{botulinum}{bot.}{botulinum}
+\newabbreviation[category={species},
+ description={},parent={clostridium}]{perfringens}{per.}{perfringens}
+\newabbreviation[category={species},
+ description={},parent={clostridium}]{tetani}{tet.}{tetani}
+\glssetcategoriesattributes{species}{discardperiod,retainfirstuseperiod}{true}
+
+
+\multiglossaryentry{cbot}{clostridium,botulinum}
+\multiglossaryentry{cperf}{clostridium,perfringens}
+\multiglossaryentry{ctet}{clostridium,tetani}
+
+
+\multiglossaryentrysetup{indexothers=false,hyper=allmain}
+\begin{document}
+First use: \mgls{cbot}, \mgls{cperf}, \mgls{ctet}.
+
+
+Next use: \mgls{cbot}, \mgls{cperf}, \mgls{ctet}.
+\printglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example129.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example129.pdf
new file mode 100644
index 0000000000..d6c8dd0ec2
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example129.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example129.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example129.png
new file mode 100644
index 0000000000..327487e2a4
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example129.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example129.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example129.tex
new file mode 100644
index 0000000000..c26ad44ecb
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example129.tex
@@ -0,0 +1,38 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 129 Multi-entries: skipping elements
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref} \usepackage[stylemods,style=long]{glossaries-extra}
+
+\makeglossaries
+
+\setabbreviationstyle{long-short-sc} \newabbreviation{ssi}{ssi}{server-side includes} \newabbreviation{html}{html}{hypertext markup language}
+
+\setabbreviationstyle[combinedabbrv]{long-only-short-sc-only} \newabbreviation [category={combinedabbrv}, description={\glsxtrshort{ssi} enabled \glsxtrshort{html}}] {shtml-frag}{shtml}{enabled}
+
+\glssetcategoryattribute{combinedabbrv}{multioptions}
+ {usedskipothers,firstsuffix={\glsxtrshort{\mglslastmainlabel}}}
+
+
+\multiglossaryentry [category=combinedabbrv] {shtml}[shtml-frag]{ssi,shtml-frag,html}
+\begin{document}
+Individual elements first use: \gls{ssi} and \gls{html}.
+
+Individual elements next use: \gls{ssi} and \gls{html}.
+
+Multi-entry first use: \mgls{shtml}.
+
+Multi-entry next use: \mgls{shtml}.
+
+Resetting all\glsresetall\mglsreset{shtml}:
+
+Multi-entry first use: \mgls{shtml}.
+
+Multi-entry next use: \mgls{shtml}.
+
+Individual elements: \gls{ssi} and \gls{html}. \printglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example130.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example130.pdf
new file mode 100644
index 0000000000..303e001567
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example130.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example130.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example130.png
new file mode 100644
index 0000000000..7fce74fd70
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example130.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example130.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example130.tex
new file mode 100644
index 0000000000..74f480535f
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example130.tex
@@ -0,0 +1,54 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 130 Multi-entries: skipping elements (unsetting others)
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref}
+\usepackage[stylemods,style=long]{glossaries-extra}
+
+\makeglossaries
+
+
+\setabbreviationstyle{long-short-sc}
+\newabbreviation{ssi}{ssi}{server-side includes}
+\newabbreviation{html}{html}{hypertext markup language}
+
+\setabbreviationstyle[combinedabbrv]{long-only-short-sc-only}
+\newabbreviation
+ [category={combinedabbrv},
+ description={\glsxtrshort{ssi} enabled \glsxtrshort{html}}]
+ {shtml-frag}{shtml}{enabled}
+
+\glssetcategoryattribute{combinedabbrv}{multioptions}
+ {%
+ hyper={notmainfirst},
+ mglsopts={presetlocal,unsetothers,others={local}},
+ usedskipothers={,}
+ firstsuffix={{}}{\glsxtrshort{\mglslastmainlabel}}
+}
+
+
+\multiglossaryentry
+ [category=combinedabbrv]
+ {shtml}[shtml-frag]{ssi,shtml-frag,html}
+\begin{document}
+Individual elements first use: \gls{ssi} and \gls{html}.
+
+Individual elements next use: \gls{ssi} and \gls{html}.
+
+Multi-entry first use: \mgls{shtml}.
+
+Multi-entry next use: \mgls{shtml}.
+
+Resetting all\glsresetall\mglsreset{shtml}:
+
+Multi-entry first use: \mgls{shtml}.
+
+Multi-entry next use: \mgls{shtml}.
+
+Individual elements: \gls{ssi} and \gls{html}.
+\printglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example131.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example131.pdf
new file mode 100644
index 0000000000..b5bab2ba80
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example131.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example131.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example131.png
new file mode 100644
index 0000000000..56055a0011
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example131.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example131.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example131.tex
new file mode 100644
index 0000000000..96558df711
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example131.tex
@@ -0,0 +1,85 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 131 Multi-entries: skipping elements (prefix and post-link hooks)
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref}
+\usepackage[stylemods,style=long]{glossaries-extra}
+
+
+\makeglossaries
+
+
+\setabbreviationstyle{long-postshort-sc-user}
+
+
+\newabbreviation{ssi}{ssi}{server-side includes}
+\newabbreviation{html}{html}{hypertext markup language}
+
+
+\newrobustcmd{\combinedpre}[1]{\glsps{#1}}
+\newrobustcmd{\combinedpost}[1]{\glsps{#1}}
+
+
+\newabbreviation{shtml}{shtml}
+{{}\combinedpre{ssi} enabled \combinedpost{html}}
+
+
+\glssetcategoryattribute{combinedabbrv}{multioptions}
+ {%
+ mpostlinkelement=main,
+ usedskipothers
+ }
+
+
+\multiglossaryentry
+ [category=combinedabbrv]
+ {shtml}[shtml]{ssi,shtml,html}
+
+
+\mglsdefcategoryprefix{combinedabbrv}{%
+ \renewcommand{\combinedpre}[1]{\ignorespaces}%
+ \renewcommand{\combinedpost}[1]{\unskip}%
+}
+\begin{document}
+Individual elements first use: \gls{ssi} and \gls{html}.
+
+
+Individual elements next use: \gls{ssi} and \gls{html}.
+
+
+Multi-entry first use: \mgls{shtml}.
+
+
+Multi-entry next use: \mgls{shtml}.
+
+
+Individual entry first use: \gls{shtml}.
+
+
+Resetting all\glsresetall\mglsresetall:
+
+
+Multi-entry first use: \mgls{shtml}.
+
+
+Multi-entry next use: \mgls{shtml}.
+
+
+Individual elements: \gls{ssi} and \gls{html}.
+
+
+Resetting all\glsresetall\mglsresetall:
+
+
+Individual entry first use: \gls{shtml}.
+
+
+Multi-entry first use: \mgls{shtml}. (Wrong!)
+
+
+\printglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example132.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example132.pdf
new file mode 100644
index 0000000000..bcb52e03b3
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example132.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example132.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example132.png
new file mode 100644
index 0000000000..bb1e65c2cd
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example132.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example132.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example132.tex
new file mode 100644
index 0000000000..01e7913afa
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example132.tex
@@ -0,0 +1,19 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 132 Changing the target prefix
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref}
+\usepackage[showtargets=annoteleft,style=tree]{glossaries-extra}
+\newglossaryentry{sample}{name={sample},
+ description={an example description that references \gls{another}}}
+\newglossaryentry{another}{name={another},
+ description={some other example description that references \gls{sample}}}
+\begin{document}
+Link to glossary 1: \gls{sample}.
+
+Link to glossary 2: \gls[prefix={other-}]{sample}.
+\printunsrtglossary
+\printunsrtglossary[prefix=other-]
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example133.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example133.pdf
new file mode 100644
index 0000000000..4f4ec3e03e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example133.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example133.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example133.png
new file mode 100644
index 0000000000..bddb94d7ab
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example133.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example133.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example133.tex
new file mode 100644
index 0000000000..e778d38b79
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example133.tex
@@ -0,0 +1,19 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 133 Prepending to the target prefix for just the entry item
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref}
+\usepackage[showtargets=annoteleft,style=tree]{glossaries-extra}
+\newglossaryentry{sample}{name={sample},
+ description={an example description that references \gls{another}}}
+\newglossaryentry{another}{name={another},
+ description={some other example description that references \gls{sample}}}
+\begin{document}
+Link to glossary 1: \gls{sample}.
+
+Link to glossary 2: \gls[prefix={other-glo:}]{sample}.
+\printunsrtglossary
+\printunsrtglossary[targetnameprefix=other-]
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example134.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example134.pdf
new file mode 100644
index 0000000000..68ac2c3fa7
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example134.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example134.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example134.png
new file mode 100644
index 0000000000..2c31dec65c
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example134.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example134.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example134.tex
new file mode 100644
index 0000000000..606781b6ab
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example134.tex
@@ -0,0 +1,13 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 134 Displaying unsorted glossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[style=treegroup]{glossaries-extra}
+\newglossaryentry{ant}{name={ant},description={}}
+\newglossaryentry{gazelle}{name={gazelle},description={}}
+
+\begin{document}
+\printunsrtglossary
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example135.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example135.pdf
new file mode 100644
index 0000000000..4d3ac7b1db
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example135.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example135.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example135.png
new file mode 100644
index 0000000000..d343575e7f
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example135.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example135.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example135.tex
new file mode 100644
index 0000000000..fded851f16
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example135.tex
@@ -0,0 +1,13 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 135 Displaying unsorted glossaries with stylemods
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[stylemods,style=treegroup]{glossaries-extra}
+\newglossaryentry{ant}{name={ant},description={}}
+\newglossaryentry{gazelle}{name={gazelle},description={}}
+
+\begin{document}
+\printunsrtglossary
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example136.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example136.pdf
new file mode 100644
index 0000000000..d5c2d76d9d
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example136.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example136.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example136.png
new file mode 100644
index 0000000000..c3153aba47
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example136.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example136.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example136.tex
new file mode 100644
index 0000000000..1f4ffb0242
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example136.tex
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 136 Displaying unsorted glossaries with different group settings
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[stylemods,style=treegroup]{glossaries-extra}
+\newglossaryentry{ant}{name={ant},description={}}
+\newglossaryentry{gazelle}{name={gazelle},description={}}
+
+\begin{document}
+\twocolumn\printunsrtglossary[title={Glossary 1}]
+\glsxtrnoidxgroups
+\printunsrtglossary[title={Glossary 2}]
+\newpage \printunsrtglossary[groups=false,title={Glossary 3}]
+\printunsrtglossary[style=tree,nogroupskip,title={Glossary 4}]
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example137.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example137.pdf
new file mode 100644
index 0000000000..15eedea6a1
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example137.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example137.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example137.png
new file mode 100644
index 0000000000..3d5004fc07
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example137.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example137.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example137.tex
new file mode 100644
index 0000000000..66afb492d3
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example137.tex
@@ -0,0 +1,27 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 137 Displaying unsorted glossaries with a copied list
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[stylemods=bookindex,style=bookindex]{glossaries-extra}
+\newglossaryentry{waterfowl}{name={waterfowl},description={}}
+\newglossaryentry{ant}{name={ant},description={}}
+\newglossaryentry{adder}{name={adder},description={}}
+\newglossaryentry{duck}{name={duck},parent={waterfowl},description={}}
+\newglossaryentry{zebra}{name={zebra},description={}}
+\newglossaryentry{aardvark}{name={aardvark},description={}}
+\newglossaryentry{gazelle}{name={gazelle},description={}}
+\newglossaryentry{mallard}{name={mallard},parent={duck},description={}}
+
+
+\newglossary*{another}{Another Glossary}
+\glsxtrcopytoglossary{mallard}{another}
+\glsxtrcopytoglossary{aardvark}{another}
+\glsxtrcopytoglossary{zebra}{another}
+\glsxtrcopytoglossary{ant}{another}
+\glsxtrcopytoglossary{duck}{another}
+\begin{document}
+\printunsrtglossary
+\printunsrtglossary[type=another]
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example138.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example138.pdf
new file mode 100644
index 0000000000..b05e385be9
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example138.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example138.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example138.png
new file mode 100644
index 0000000000..34cef766a0
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example138.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example138.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example138.tex
new file mode 100644
index 0000000000..cae7f406e3
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example138.tex
@@ -0,0 +1,48 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 138 Displaying unsorted glossaries with custom groups
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[record,stylemods=bookindex,style=bookindex]{glossaries-extra}
+
+
+\glsxtrsetgrouptitle{group1label}{Group 1}
+\glsxtrsetgrouptitle{group2label}{Group 2}
+\glsxtrsetgrouptitle{group3label}{Group 3}
+\glsxtrsetgrouptitle{group4label}{Group 4}
+
+
+\newglossaryentry{waterfowl}{name={waterfowl},description={},
+ group={group1label}}
+\newglossaryentry{ant}{name={ant},description={},
+ group={group1label}}
+\GlsXtrSetField{ant}{secondarygroup}{group4label}
+\newglossaryentry{adder}{name={adder},description={},
+ group={group2label}}
+\newglossaryentry{duck}{name={duck},parent={waterfowl},
+ description={},group={group4label}}
+\GlsXtrSetField{duck}{secondarygroup}{group2label}
+\newglossaryentry{zebra}{name={zebra},description={},
+ group={group2label}}
+\GlsXtrSetField{zebra}{secondarygroup}{group3label}
+\newglossaryentry{aardvark}{name={aardvark},description={},
+ group={group2label}}
+\GlsXtrSetField{aardvark}{secondarygroup}{group1label}
+\newglossaryentry{gazelle}{name={gazelle},description={},
+ group={group1label}}
+\newglossaryentry{mallard}{name={mallard},parent={duck},
+ description={},group={group2label}} \GlsXtrSetField{mallard}{secondarygroup}{group3label}
+
+
+\newglossary*{another}{Another Glossary}
+\glsxtrcopytoglossary{mallard}{another}
+\glsxtrcopytoglossary{aardvark}{another}
+\glsxtrcopytoglossary{zebra}{another}
+\glsxtrcopytoglossary{ant}{another}
+\glsxtrcopytoglossary{duck}{another}
+\setglossarypreamble[another]{\renewcommand{\glsxtrgroupfield}{secondarygroup}}
+\begin{document}
+\printunsrtglossary
+\printunsrtglossary[type=another]
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example139.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example139.pdf
new file mode 100644
index 0000000000..63625902b9
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example139.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example139.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example139.png
new file mode 100644
index 0000000000..e42fbd5533
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example139.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example139.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example139.tex
new file mode 100644
index 0000000000..e1c6126b29
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example139.tex
@@ -0,0 +1,52 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 139 Displaying unsorted glossaries with custom groups and sub-group headings
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[record,stylemods=bookindex,style=bookindex]{glossaries-extra}
+
+
+\glsxtrsetgrouptitle{group1label}{Group 1}
+\glsxtrsetgrouptitle{group2label}{Group 2}
+\glsxtrsetgrouptitle{group3label}{Group 3}
+\glsxtrsetgrouptitle{group4label}{Group 4}
+
+
+\newglossaryentry{waterfowl}{name={waterfowl},description={},
+ group={group1label}}
+\newglossaryentry{ant}{name={ant},description={},
+ group={group1label}}
+\GlsXtrSetField{ant}{secondarygroup}{group4label}
+\newglossaryentry{adder}{name={adder},description={},
+ group={group2label}}
+\newglossaryentry{duck}{name={duck},parent={waterfowl},
+ description={},group={group4label}}
+\GlsXtrSetField{duck}{secondarygroup}{group2label}
+\newglossaryentry{zebra}{name={zebra},description={},
+ group={group2label}}
+\GlsXtrSetField{zebra}{secondarygroup}{group3label}
+\newglossaryentry{aardvark}{name={aardvark},description={},
+ group={group2label}}
+\GlsXtrSetField{aardvark}{secondarygroup}{group1label}
+\newglossaryentry{gazelle}{name={gazelle},description={},
+ group={group1label}}
+\newglossaryentry{mallard}{name={mallard},parent={duck},
+ description={},group={group2label}} \GlsXtrSetField{mallard}{secondarygroup}{group3label}
+
+
+\newglossary*{another}{Another Glossary}
+\glsxtrcopytoglossary{mallard}{another}
+\glsxtrcopytoglossary{aardvark}{another}
+\glsxtrcopytoglossary{zebra}{another}
+\glsxtrcopytoglossary{ant}{another}
+\glsxtrcopytoglossary{duck}{another}
+\setglossarypreamble[another]{\renewcommand{\glsxtrgroupfield}{secondarygroup}}
+\begin{document}
+\renewcommand*{\glsxtraddgroup}[2]{#2}
+\printunsrtglossary
+\renewcommand*{\glsxtraddgroup}[2]{%
+ \ifnum\glscurrententrylevel<2 #2\fi
+}
+\printunsrtglossary[type=another]
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example140.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example140.pdf
new file mode 100644
index 0000000000..5c56d9a144
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example140.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example140.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example140.png
new file mode 100644
index 0000000000..c86fdc80de
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example140.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example140.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example140.tex
new file mode 100644
index 0000000000..498c5b9451
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example140.tex
@@ -0,0 +1,31 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 140 Displaying sorted glossaries with groups using bib2gls
+% arara: pdflatex
+% arara: bib2gls: { group: on }
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\begin{filecontents*}{animalfamilies.bib}
+@index{waterfowl,user1={Anseriformes}}
+@index{ant,user1={Formicidae}}
+@index{adder,user1={Vipera berus}}
+@index{duck,parent={waterfowl},user1={Anatidae}}
+@index{zebra,user1={Hippotigris}}
+@index{aardvark,user1={Orycteropus afer}}
+@index{gazelle,user1={Gazella}}
+@index{mallard,parent={duck},user1={Anas platyrhynchos}}
+\end{filecontents*}
+\usepackage[record,stylemods=bookindex,style=bookindex]{glossaries-extra}
+\newglossary*{another}{Another Glossary}
+\GlsXtrLoadResources[selection=all,% select all entries
+ src={animalfamilies},% identify bib file(s)
+ sort=en-GB,% sort method
+ secondary={la:user1:another}% sort again and copy to `another'
+ ]
+\glsdefpostname{index}{
+ (\emph{\glsentryuseri{\glscurrententrylabel}})}
+\begin{document}
+\printunsrtglossary
+\printunsrtglossary[type=another]
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example141.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example141.pdf
new file mode 100644
index 0000000000..823e463068
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example141.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example141.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example141.png
new file mode 100644
index 0000000000..b5e311f9e0
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example141.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example141.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example141.tex
new file mode 100644
index 0000000000..a71ff91a3f
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example141.tex
@@ -0,0 +1,19 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 141 Filtering by category
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[style=index]{glossaries-extra}
+ \newglossaryentry{ant}{name={ant},description={}}
+ \newglossaryentry{pi}{name={\ensuremath{\pi}},description={},
+ category={symbol}}
+\newglossaryentry{aardvark}{name={aardvark},description={}}
+\begin{document}
+\renewcommand{\printunsrtglossaryentryprocesshook}[1]{%
+ \glsifcategory{#1}{symbol}%
+ {\printunsrtglossaryskipentry}%
+ {}%
+ }
+\printunsrtglossary
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example142.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example142.pdf
new file mode 100644
index 0000000000..b77baf12c6
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example142.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example142.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example142.png
new file mode 100644
index 0000000000..9d15c50305
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example142.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example142.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example142.tex
new file mode 100644
index 0000000000..c41f508990
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example142.tex
@@ -0,0 +1,20 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 142 Inner glossaries using printunsrtglossarywrap
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage{glossaries-extra}
+\newglossaryentry{ant}{name={ant},description={}}
+\newglossaryentry{bee}{name={bee},description={}}
+\newignoredglossary*{other}
+\newglossaryentry{duck}{type={other},name={duck},description={}}
+\newglossaryentry{goose}{type={other},name={goose},description={}}
+\begin{document}
+\begin{printunsrtglossarywrap}[style=index]
+\glstreeitem First Glossary
+\printunsrtinnerglossary[leveloffset=1]{}{}
+\glstreeitem Second Glossary
+\printunsrtinnerglossary[type=other,leveloffset=1]{}{}
+\end{printunsrtglossarywrap}
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example143.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example143.pdf
new file mode 100644
index 0000000000..6c30a3675d
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example143.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example143.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example143.png
new file mode 100644
index 0000000000..abb54b2f79
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example143.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example143.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example143.tex
new file mode 100644
index 0000000000..cfbf372ebe
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example143.tex
@@ -0,0 +1,36 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 143 Nested glossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage{fontawesome}
+\usepackage[style=tree]{glossaries-extra}
+\newglossaryentry{pictograph}{name={pictograph},
+ description={picture or symbol representing a word or phrase}}
+\newglossaryentry{mathgreek}{name={Greek symbol},
+ description={mathematical constants or functions}}
+\newignoredglossary*{pictograph}
+\newignoredglossary*{mathgreek}
+\newglossaryentry{cut}{type={pictograph},
+ name={\faCut},
+ description={cut}}
+\newglossaryentry{paste}{type={pictograph},
+ name={\faPaste}, description={paste}}
+\newglossaryentry{alpha}{type={mathgreek},
+ name={\ensuremath{\alpha}},
+ description={alpha}}
+\newglossaryentry{beta}{type={mathgreek},
+ name={\ensuremath{\beta}},
+ description={beta}}
+\begin{document}
+\newcommand{\nestedhandler}[1]{%
+ \glsxtrunsrtdo{#1}%
+ \ifglossaryexists*{#1}%
+ {%
+ \printunsrtinnerglossary[type={#1},leveloffset={++1},groups=false]{}{}%
+ }%
+ {}%
+}
+\printunsrtglossary*{\let\printunsrtglossaryhandler\nestedhandler}
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example144.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example144.pdf
new file mode 100644
index 0000000000..58364762bb
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example144.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example144.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example144.png
new file mode 100644
index 0000000000..e85380a572
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example144.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example144.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example144.tex
new file mode 100644
index 0000000000..ad31c065ee
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example144.tex
@@ -0,0 +1,36 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 144 Sub-glossary for a given counter value
+% arara: pdflatex
+% arara: bib2gls
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\begin{filecontents*}{\jobname.bib}
+@symbol{pi,name={\ensuremath{\pi}},
+description={ratio of the length of the circumference of a circle to its diameter}}
+@symbol{root2,name={\ensuremath{\surd2}},
+description={Pythagoras' constant}}
+@symbol{zeta3,name={\ensuremath{\zeta(3)}},
+description={Ap\'ery's constant}}
+@symbol{zero,name={0},
+description={nothing or nil}}
+@symbol{one,name={1},
+description={single entity, unity}}
+\end{filecontents*}
+\usepackage[record,stylemods,style=index]{glossaries-extra}
+ \GlsXtrRecordCounter{section}
+ \GlsXtrLoadResources[src={\jobname},
+ symbol-sort-fallback=description
+]
+\begin{document}
+\section{Sample}
+\printunsrtglossaryunit{section}
+This section discusses \gls{pi}, \gls{root2} and \gls{zeta3}.
+
+\section{Another Sample}
+\printunsrtglossaryunit{section}
+This section discusses \gls{one}, \gls{pi} and \gls{zero}.
+
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example145.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example145.pdf
new file mode 100644
index 0000000000..6c5d11c914
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example145.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example145.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example145.png
new file mode 100644
index 0000000000..9b87991c30
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example145.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example145.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example145.tex
new file mode 100644
index 0000000000..36f1df0122
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example145.tex
@@ -0,0 +1,48 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 145 Sub-glossary for a given counter value ordered by use in the section
+% arara: pdflatex
+% arara: bib2gls
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\begin{filecontents*}{\jobname.bib}
+@symbol{pi,name={\ensuremath{\pi}},
+description={ratio of the length of the circumference of a circle to its diameter}}
+@symbol{root2,name={\ensuremath{\surd2}},
+description={Pythagoras' constant}}
+@symbol{zeta3,name={\ensuremath{\zeta(3)}},
+description={Ap\'ery's constant}}
+@symbol{zero,name={0},
+description={nothing or nil}}
+@symbol{one,name={1},
+description={single entity, unity}}
+\end{filecontents*}
+\usepackage[record,stylemods,style=index]{glossaries-extra}
+ \GlsXtrRecordCounter{section}
+ \GlsXtrLoadResources[src={\jobname},
+ symbol-sort-fallback=description
+]
+
+\renewcommand{\glsxtrAddCounterRecordHook}[3]{%
+ \provideignoredglossary{#2.#3}%
+ \glsxtrcopytoglossary*{#1}{#2.#3}%
+}
+
+\newcommand{\minigloss}{%
+ \printunsrtglossary*[type=section.\thesection,
+ target=false]
+ {\renewcommand*{\glossarysection}[2][]{}}
+ \printunsrtglossaryunitpostskip
+}
+\begin{document}
+\section{Sample}
+\minigloss
+This section discusses \gls{pi}, \gls{root2} and \gls{zeta3}.
+
+\section{Another Sample}
+\minigloss
+This section discusses \gls{one}, \gls{pi} and \gls{zero}.
+
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example146.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example146.pdf
new file mode 100644
index 0000000000..8887fefe12
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example146.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example146.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example146.png
new file mode 100644
index 0000000000..863a32f882
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example146.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example146.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example146.tex
new file mode 100644
index 0000000000..a3951e291f
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example146.tex
@@ -0,0 +1,18 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 146 The bookindex style
+% arara: pdflatex
+% arara: bib2gls: { group: on }
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[record,nostyles,stylemods=bookindex,style=bookindex]{glossaries-extra}
+\GlsXtrLoadResources[src=example-glossaries-xr,
+ selection={recorded and deps and see not also}
+]
+\begin{document}
+\glsaddeach{lorem,amet,adipiscing,placerat,arcu,vulputate}
+\glsaddeach[thevalue=2]{arcu,consectetuer,donec,augue}
+\glsaddeach[thevalue=3]{arcu,lorem,nulla}
+\printunsrtglossary
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example147.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example147.pdf
new file mode 100644
index 0000000000..1d255e0537
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example147.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example147.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example147.png
new file mode 100644
index 0000000000..fe03c5aa70
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example147.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example147.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example147.tex
new file mode 100644
index 0000000000..b839f01e86
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example147.tex
@@ -0,0 +1,54 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 147 The topic style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage{fontawesome}
+\usepackage[postdot,stylemods=topic,style=topic]{glossaries-extra}
+\newglossaryentry{pictograph}{name={pictograph},
+ description={picture or symbol representing a word or phrase}}
+\newglossaryentry{copy}{parent={pictograph},
+ name={\faCopy},
+ description={copy}}
+\newglossaryentry{cut}{parent={pictograph},
+ name={\faCut},
+ description={cut}}
+\newglossaryentry{edit}{parent={pictograph},
+ name={\faEdit}, description={edit}} \newglossaryentry{paste}{parent={pictograph},
+ name={\faPaste}, description={paste}}
+
+\newglossaryentry{symbols}{name={Symbols},
+ description={mathematical constants or functions}}
+\newglossaryentry{constant}{parent={symbols},
+ name={constant},
+ description={a fixed quantity or numerical value}}
+\newglossaryentry{pi}{parent={constant},
+ name={\ensuremath{\pi}},
+ description={ratio of the length of the circumference of a circle to its diameter}}
+\newglossaryentry{root2}{parent={constant},
+ name={\ensuremath{\surd2}},
+ description={Pythagoras' constant}}
+\newglossaryentry{function}{parent={symbols},
+ name={function},
+ description={a rule that assigns a value to every element of the domain}}
+\newglossaryentry{cosx}{parent={function},
+ name={\ensuremath{\cos(x)}},
+ description={cosine}}
+\newglossaryentry{lnx}{parent={function},
+ name={\ensuremath{\ln(x)}},
+ description={natural logarithm}}
+\newglossaryentry{parameter}{parent={symbols},
+ name={parameter},
+ description={a constant or variable that distinguishes a specific form}}
+\newglossaryentry{x}{parent={parameter},
+ name={\ensuremath{x}},
+ description={the abscissa value}}
+\newglossaryentry{y}{parent={parameter},
+ name={\ensuremath{y}},
+ description={the ordinate value}} \newglossaryentry{z}{parent={parameter},
+ name={\ensuremath{z}},
+ description={the applicate value}}
+\begin{document}
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example148.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example148.pdf
new file mode 100644
index 0000000000..42d9147ff3
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example148.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example148.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example148.png
new file mode 100644
index 0000000000..4385a555d7
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example148.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example148.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example148.tex
new file mode 100644
index 0000000000..1fb75164c5
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example148.tex
@@ -0,0 +1,54 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 148 The topicmcols style
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage{fontawesome}
+\usepackage[postdot,stylemods=topic,style=topicmcols]{glossaries-extra}
+\newglossaryentry{pictograph}{name={pictograph},
+ description={picture or symbol representing a word or phrase}}
+\newglossaryentry{copy}{parent={pictograph},
+ name={\faCopy},
+ description={copy}}
+\newglossaryentry{cut}{parent={pictograph},
+ name={\faCut},
+ description={cut}}
+\newglossaryentry{edit}{parent={pictograph},
+ name={\faEdit}, description={edit}} \newglossaryentry{paste}{parent={pictograph},
+ name={\faPaste}, description={paste}}
+
+\newglossaryentry{symbols}{name={Symbols},
+ description={mathematical constants or functions}}
+\newglossaryentry{constant}{parent={symbols},
+ name={constant},
+ description={a fixed quantity or numerical value}}
+\newglossaryentry{pi}{parent={constant},
+ name={\ensuremath{\pi}},
+ description={ratio of the length of the circumference of a circle to its diameter}}
+\newglossaryentry{root2}{parent={constant},
+ name={\ensuremath{\surd2}},
+ description={Pythagoras' constant}}
+\newglossaryentry{function}{parent={symbols},
+ name={function},
+ description={a rule that assigns a value to every element of the domain}}
+\newglossaryentry{cosx}{parent={function},
+ name={\ensuremath{\cos(x)}},
+ description={cosine}}
+\newglossaryentry{lnx}{parent={function},
+ name={\ensuremath{\ln(x)}},
+ description={natural logarithm}}
+\newglossaryentry{parameter}{parent={symbols},
+ name={parameter},
+ description={a constant or variable that distinguishes a specific form}}
+\newglossaryentry{x}{parent={parameter},
+ name={\ensuremath{x}},
+ description={the abscissa value}}
+\newglossaryentry{y}{parent={parameter},
+ name={\ensuremath{y}},
+ description={the ordinate value}} \newglossaryentry{z}{parent={parameter},
+ name={\ensuremath{z}},
+ description={the applicate value}}
+\begin{document}
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example149.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example149.pdf
new file mode 100644
index 0000000000..afde316fb5
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example149.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example149.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example149.png
new file mode 100644
index 0000000000..a4c978d935
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example149.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example149.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example149.tex
new file mode 100644
index 0000000000..187cf336a8
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example149.tex
@@ -0,0 +1,56 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 149 The topicmcols style with the widest name set
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage{fontawesome}
+\usepackage[postdot,stylemods=topic,style=topicmcols]{glossaries-extra}
+\newglossaryentry{pictograph}{name={pictograph},
+ description={picture or symbol representing a word or phrase}}
+\newglossaryentry{copy}{parent={pictograph},
+ name={\faCopy},
+ description={copy}}
+\newglossaryentry{cut}{parent={pictograph},
+ name={\faCut},
+ description={cut}}
+\newglossaryentry{edit}{parent={pictograph},
+ name={\faEdit}, description={edit}} \newglossaryentry{paste}{parent={pictograph},
+ name={\faPaste}, description={paste}}
+
+\newglossaryentry{symbols}{name={Symbols},
+ description={mathematical constants or functions}}
+\newglossaryentry{constant}{parent={symbols},
+ name={constant},
+ description={a fixed quantity or numerical value}}
+\newglossaryentry{pi}{parent={constant},
+ name={\ensuremath{\pi}},
+ description={ratio of the length of the circumference of a circle to its diameter}}
+\newglossaryentry{root2}{parent={constant},
+ name={\ensuremath{\surd2}},
+ description={Pythagoras' constant}}
+\newglossaryentry{function}{parent={symbols},
+ name={function},
+ description={a rule that assigns a value to every element of the domain}}
+\newglossaryentry{cosx}{parent={function},
+ name={\ensuremath{\cos(x)}},
+ description={cosine}}
+\newglossaryentry{lnx}{parent={function},
+ name={\ensuremath{\ln(x)}},
+ description={natural logarithm}}
+\newglossaryentry{parameter}{parent={symbols},
+ name={parameter},
+ description={a constant or variable that distinguishes a specific form}}
+\newglossaryentry{x}{parent={parameter},
+ name={\ensuremath{x}},
+ description={the abscissa value}}
+\newglossaryentry{y}{parent={parameter},
+ name={\ensuremath{y}},
+ description={the ordinate value}} \newglossaryentry{z}{parent={parameter},
+ name={\ensuremath{z}},
+ description={the applicate value}}
+\glssetwidest[1]{parameter}
+\glssetwidest[2]{\glsentryname{cosine}}
+\begin{document}
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example150.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example150.pdf
new file mode 100644
index 0000000000..d6f317a541
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example150.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example150.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example150.png
new file mode 100644
index 0000000000..60a8af9831
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example150.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example150.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example150.tex
new file mode 100644
index 0000000000..f356ede815
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example150.tex
@@ -0,0 +1,27 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 150 Two entries per row with \printunsrttable
+% arara: pdflatex
+% arara: bib2gls
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[record,stylemods=table,subentrycounter]{glossaries-extra}
+
+\GlsXtrLoadResources[
+ % entries in example-glossaries-childnoname.bib:
+ src=example-glossaries-childnoname,
+ selection=all,
+ save-child-count=]
+
+\begin{document}
+\printunsrttable
+[
+ block-style=name,par=ragged,
+ preamble={Some preamble text},
+ postamble={Some postamble text},
+ init={%
+ \let\glsnamefont\textbf \def\glstablenameheader{Summary}%
+ }
+]
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example151.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example151.pdf
new file mode 100644
index 0000000000..d1020a7387
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example151.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example151.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example151.png
new file mode 100644
index 0000000000..7b9a544e3c
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example151.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example151.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example151.tex
new file mode 100644
index 0000000000..fb5cc6cd7d
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example151.tex
@@ -0,0 +1,85 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 151 Using bib2gls: one resource set
+% arara: pdflatex
+% arara: bib2gls
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\begin{filecontents*}{terms.bib}
+@entry{bird,
+ name={bird},
+ description={feathered animal},
+ see={[see also]duck,goose}
+}
+
+@entry{duck,
+ name={duck},
+ description={a waterbird with short legs}
+}
+
+@entry{goose,
+ name="goose",
+ plural="geese",
+ description={a waterbird with a long neck}
+}
+\end{filecontents*}
+\begin{filecontents*}{abbrvs.bib}
+@string{ssi={server-side includes}}
+@string{html={hypertext markup language}}
+
+@abbreviation{shtml,
+ short="shtml",
+ long= ssi # " enabled " # html,
+ description={a combination of \gls{html} and \gls{ssi}}
+}
+
+@abbreviation{html,
+ short ="html",
+ long = html,
+ description={a markup language for creating web pages}
+}
+
+@abbreviation{ssi,
+ short="ssi",
+ long = ssi,
+ description={a simple interpreted server-side scripting language}
+}
+
+@abbreviation{xml,
+ short={xml}, long={extensible markup language}, description={a simple text-base format for representing structured information} }
+\end{filecontents*}
+\begin{filecontents*}{symbols.bib}
+@preamble{"\providecommand{\mtx}[1]{\boldsymbol{#1}}"}
+
+@symbol{M,
+ name={\ensuremath{\mtx{M}}},
+ description={a matrix}
+}
+
+@symbol{v,
+ name={\ensuremath{\vec{v}}},
+ description={a vector}
+}
+
+@symbol{S,
+ name={\ensuremath{\mathcal{S}}},
+ description={a set}
+}
+\end{filecontents*}
+\usepackage[record]{glossaries-extra}
+
+\setabbreviationstyle{long-short-sc-desc}
+
+\GlsXtrLoadResources[src={terms,abbrvs,symbols}]
+
+
+\begin{document}
+\gls{bird}
+
+\gls{shtml}
+
+\gls{M}
+
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example152.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example152.pdf
new file mode 100644
index 0000000000..fa389883d8
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example152.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example152.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example152.png
new file mode 100644
index 0000000000..800abcfae2
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example152.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example152.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example152.tex
new file mode 100644
index 0000000000..d883276530
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example152.tex
@@ -0,0 +1,85 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 152 Using bib2gls: multiple resource sets
+% arara: pdflatex
+% arara: bib2gls
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\begin{filecontents*}{terms.bib}
+@entry{bird,
+ name={bird},
+ description={feathered animal},
+ see={[see also]duck,goose}
+}
+
+@entry{duck,
+ name={duck},
+ description={a waterbird with short legs}
+}
+
+@entry{goose,
+ name="goose",
+ plural="geese",
+ description={a waterbird with a long neck}
+}\end{filecontents*}
+\begin{filecontents*}{abbrvs.bib}
+@string{ssi={server-side includes}}
+@string{html={hypertext markup language}}
+
+@abbreviation{shtml,
+ short="shtml",
+ long= ssi # " enabled " # html,
+ description={a combination of \gls{html} and \gls{ssi}}
+}
+
+@abbreviation{html,
+ short ="html",
+ long = html,
+ description={a markup language for creating web pages}
+}
+
+@abbreviation{ssi,
+ short="ssi",
+ long = ssi,
+ description={a simple interpreted server-side scripting language}
+}
+
+@abbreviation{xml,
+ short={xml}, long={extensible markup language}, description={a simple text-base format for representing structured information} }\end{filecontents*}
+\begin{filecontents*}{symbols.bib}
+@preamble{"\providecommand{\mtx}[1]{\boldsymbol{#1}}"}
+
+@symbol{M,
+ name={\ensuremath{\mtx{M}}},
+ description={a matrix}
+}
+
+@symbol{v,
+ name={\ensuremath{\vec{v}}},
+ description={a vector}
+}
+
+@symbol{S,
+ name={\ensuremath{\mathcal{S}}},
+ description={a set}
+}
+\end{filecontents*}
+\usepackage[record,abbreviations,symbols]{glossaries-extra}
+
+\setabbreviationstyle{long-short-sc-desc}
+
+\GlsXtrLoadResources[src=terms,sort=en-GB,type=main]
+
+\GlsXtrLoadResources [src=abbrvs,sort=letter-nocase,type=abbreviations]
+
+\GlsXtrLoadResources [src=symbols,sort=use,type=symbols]
+\begin{document}
+\gls{bird}
+
+\gls{shtml}
+
+\gls{M}
+
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example153.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example153.pdf
new file mode 100644
index 0000000000..da42bb03e2
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example153.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example153.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example153.png
new file mode 100644
index 0000000000..df7d07ff64
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example153.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example153.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example153.tex
new file mode 100644
index 0000000000..a1b159a344
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example153.tex
@@ -0,0 +1,90 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 153 Using bib2gls: sub-blocks
+% arara: pdflatex
+% arara: bib2gls: { group: on }
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\begin{filecontents*}{terms.bib}
+@entry{bird,
+ name={bird},
+ description={feathered animal},
+ see={[see also]duck,goose}
+}
+
+@entry{duck,
+ name={duck},
+ description={a waterbird with short legs}
+}
+
+@entry{goose,
+ name="goose",
+ plural="geese",
+ description={a waterbird with a long neck}
+}\end{filecontents*}
+\begin{filecontents*}{abbrvs.bib}
+@string{ssi={server-side includes}}
+@string{html={hypertext markup language}}
+
+@abbreviation{shtml,
+ short="shtml",
+ long= ssi # " enabled " # html,
+ description={a combination of \gls{html} and \gls{ssi}}
+}
+
+@abbreviation{html,
+ short ="html",
+ long = html,
+ description={a markup language for creating web pages}
+}
+
+@abbreviation{ssi,
+ short="ssi",
+ long = ssi,
+ description={a simple interpreted server-side scripting language}
+}
+
+@abbreviation{xml,
+ short={xml}, long={extensible markup language}, description={a simple text-base format for representing structured information} }\end{filecontents*}
+\begin{filecontents*}{symbols.bib}
+@preamble{"\providecommand{\mtx}[1]{\boldsymbol{#1}}"}
+
+@symbol{M,
+ name={\ensuremath{\mtx{M}}},
+ description={a matrix}
+}
+
+@symbol{v,
+ name={\ensuremath{\vec{v}}},
+ description={a vector}
+}
+
+@symbol{S,
+ name={\ensuremath{\mathcal{S}}},
+ description={a set}
+}
+\end{filecontents*}
+\usepackage[record,style=indexgroup]{glossaries-extra}
+
+\setabbreviationstyle{long-short-sc-desc}
+
+\GlsXtrLoadResources
+ [src={abbrvs},sort=letter-nocase,type=main,
+ group={abbreviations}]
+\glsxtrsetgrouptitle{abbreviations}{Abbreviations}
+
+\GlsXtrLoadResources
+ [src={symbols},sort=use,type=main,group=symbols]
+\glsxtrsetgrouptitle{symbols}{Abbreviations}
+
+\GlsXtrLoadResources[src={terms},sort=en-GB,type=main]
+\begin{document}
+\gls{bird}
+
+\gls{shtml}
+
+\gls{M}
+
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example154.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example154.pdf
new file mode 100644
index 0000000000..c70cc48dc3
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example154.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example154.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example154.png
new file mode 100644
index 0000000000..cafa8b3fa0
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example154.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example154.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example154.tex
new file mode 100644
index 0000000000..82a639a533
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example154.tex
@@ -0,0 +1,92 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 154 Using bib2gls: record counting
+% arara: pdflatex
+% arara: bib2gls: { recordcount: on }
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\begin{filecontents*}{terms.bib}
+@entry{bird,
+ name={bird},
+ description={feathered animal},
+ see={[see also]duck,goose}
+}
+
+@entry{duck,
+ name={duck},
+ description={a waterbird with short legs}
+}
+
+@entry{goose,
+ name="goose",
+ plural="geese",
+ description={a waterbird with a long neck}
+}
+\end{filecontents*}
+\begin{filecontents*}{abbrvs.bib}
+@string{ssi={server-side includes}}
+@string{html={hypertext markup language}}
+
+@abbreviation{shtml,
+ short="shtml",
+ long= ssi # " enabled " # html,
+ description={a combination of \gls{html} and \gls{ssi}}
+}
+
+@abbreviation{html,
+ short ="html",
+ long = html,
+ description={a markup language for creating web pages}
+}
+
+@abbreviation{ssi,
+ short="ssi",
+ long = ssi,
+ description={a simple interpreted server-side scripting language}
+}
+
+@abbreviation{xml,
+ short={xml}, long={extensible markup language}, description={a simple text-base format for representing structured information} }
+\end{filecontents*}
+\begin{filecontents*}{symbols.bib}
+@preamble{"\providecommand{\mtx}[1]{\boldsymbol{#1}}"}
+
+@symbol{M,
+ name={\ensuremath{\mtx{M}}},
+ description={a matrix}
+}
+
+@symbol{v,
+ name={\ensuremath{\vec{v}}},
+ description={a vector}
+}
+
+@symbol{S,
+ name={\ensuremath{\mathcal{S}}},
+ description={a set}
+}
+\end{filecontents*}
+\usepackage[colorlinks]{hyperref}
+\usepackage[record]{glossaries-extra}
+
+\newignoredglossary{ignored}
+\setabbreviationstyle{long-short-sc-desc}
+
+\GlsXtrLoadResources[
+ src={terms,abbrvs,symbols},
+ trigger-type=ignored,
+ category={same as entry}
+]
+
+\glsxtrenablerecordcount
+\GlsXtrSetRecordCountAttribute{symbol,abbreviation}{1}
+
+\glsdefpostlink{entry}{\glsxtrpostlinkAddDescOnFirstUse}
+\glsdefpostlink{symbol}{\glsxtrpostlinkAddDescOnFirstUse}
+\begin{document}
+\gls{M}, \gls{ssi}, \gls{bird}, \gls{html},
+\gls{M}, \gls{html}.
+
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example155-page1.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example155-page1.png
new file mode 100644
index 0000000000..17c5c63215
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example155-page1.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example155-page2.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example155-page2.png
new file mode 100644
index 0000000000..5fbe52b9af
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example155-page2.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example155-page3.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example155-page3.png
new file mode 100644
index 0000000000..f32f370d14
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example155-page3.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example155.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example155.pdf
new file mode 100644
index 0000000000..af581116d7
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example155.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example155.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example155.tex
new file mode 100644
index 0000000000..edc379d3b7
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example155.tex
@@ -0,0 +1,62 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 155 Using bib2gls: unit record counting
+% arara: pdflatex
+% arara: bib2gls: { recordcountunit: on }
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{scrreport}
+\pagestyle{empty}
+\begin{filecontents*}{abbrvs.bib}
+@string{ssi={server-side includes}}
+@string{html={hypertext markup language}}
+
+@abbreviation{shtml,
+ short="shtml",
+ long= ssi # " enabled " # html,
+ description={a combination of \gls{html} and \gls{ssi}}
+}
+
+@abbreviation{html,
+ short ="html",
+ long = html,
+ description={a markup language for creating web pages}
+}
+
+@abbreviation{ssi,
+ short="ssi",
+ long = ssi,
+ description={a simple interpreted server-side scripting language}
+}
+
+@abbreviation{xml,
+ short={xml}, long={extensible markup language}, description={a simple text-base format for representing structured information} }
+\end{filecontents*}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage[record,postdot]{glossaries-extra}
+
+\renewcommand{\chapterpagestyle}{empty}% to assist cropping
+\setabbreviationstyle{long-short-sc-desc}
+
+\GlsXtrLoadResources[src={abbrvs}]
+
+\preto{\chapter}{\glsresetall}
+\glsxtrenablerecordcount
+\GlsXtrSetRecordCountAttribute{abbreviation}{1}
+
+\renewcommand{\glslinkpresetkeys}{%
+ \glsadd[format=glsignore,counter=chapter]{\glslabel}}
+
+\renewcommand*{\glsxtrrecordtriggervalue}[1]{%
+ \GlsXtrLocationRecordCount{#1}{chapter}{\theHchapter}%
+}
+\begin{document}
+\chapter{First} \gls{html}. \gls{html}. \gls{html}. \gls{ssi}.
+
+\chapter{Second} \gls{html}. \gls{ssi}. \gls{ssi}. \gls{xml}.
+
+\renewcommand*{\printunsrtglossaryentryprocesshook}[1]{%
+ \glsxtrifhasfield*{location}{#1}{}{\printunsrtglossaryskipentry}%
+}
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example156-page1.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example156-page1.png
new file mode 100644
index 0000000000..acf931e38d
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example156-page1.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example156-page2.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example156-page2.png
new file mode 100644
index 0000000000..bd25c92edf
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example156-page2.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example156-page3.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example156-page3.png
new file mode 100644
index 0000000000..3c14163220
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example156-page3.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example156.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example156.pdf
new file mode 100644
index 0000000000..24b0c992a4
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example156.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example156.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example156.tex
new file mode 100644
index 0000000000..3045a11de4
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example156.tex
@@ -0,0 +1,65 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 156 Using bib2gls: unit record counting mini-glossary
+% arara: pdflatex
+% arara: bib2gls: { recordcountunit: on }
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{scrreport}
+\pagestyle{empty}
+\begin{filecontents*}{abbrvs.bib}
+@string{ssi={server-side includes}}
+@string{html={hypertext markup language}}
+
+@abbreviation{shtml,
+ short="shtml",
+ long= ssi # " enabled " # html,
+ description={a combination of \gls{html} and \gls{ssi}}
+}
+
+@abbreviation{html,
+ short ="html",
+ long = html,
+ description={a markup language for creating web pages}
+}
+
+@abbreviation{ssi,
+ short="ssi",
+ long = ssi,
+ description={a simple interpreted server-side scripting language}
+}
+
+@abbreviation{xml,
+ short={xml}, long={extensible markup language}, description={a simple text-base format for representing structured information} }
+\end{filecontents*}
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+\usepackage[record,postdot,stylemods=longextra]{glossaries-extra}
+
+\renewcommand{\chapterpagestyle}{empty}% to assist cropping
+\setabbreviationstyle{long-short-sc-desc}
+
+\newcommand*{\bibglssetlocationrecordcount}[4]{%
+ \GlsXtrSetField{#1}{recordcount.#2.#3}{#4}%
+ \provideignoredglossary{minigloss.#2.#3}%
+ \glsxtrcopytoglossary{#1}{minigloss.#2.#3}%
+}
+
+\GlsXtrLoadResources[src={abbrvs}]
+
+\renewcommand{\glslinkpresetkeys}{%
+ \glsadd[format=glsignore,counter=chapter]{\glslabel}}
+\newcommand{\minigloss}{%
+ \printunsrtglossary*[style=abbr-short-long,type=minigloss.chapter.\theHchapter,groups=false,target=false]%
+ {\renewcommand{\glossarysection}[2][]{}%
+ \renewcommand{\glslongextraShortLongTabularHeader}{\toprule}%
+}}
+\begin{document}
+\chapter{First} \minigloss \gls{html}. \gls{html}. \gls{html}. \gls{ssi}.
+
+\chapter{Second} \minigloss \gls{html}. \gls{ssi}. \gls{ssi}. \gls{xml}.
+
+\renewcommand*{\printunsrtglossaryentryprocesshook}[1]{%
+ \glsxtrifhasfield*{location}{#1}{}{\printunsrtglossaryskipentry}%
+}
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example157.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example157.pdf
new file mode 100644
index 0000000000..49e80317eb
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example157.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example157.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example157.png
new file mode 100644
index 0000000000..8adda6efa9
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example157.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example157.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example157.tex
new file mode 100644
index 0000000000..874f349739
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example157.tex
@@ -0,0 +1,31 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 157 Using bib2gls: simple custom sort rule
+% arara: pdflatex
+% arara: bib2gls: { group : on }
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\begin{filecontents*}{animals.bib}
+@index{bee}
+@index{lion}
+@index{ant}
+@index{cow}
+@index{goose}
+@index{zebu}
+@index{egret}
+@index{elk}
+@index{llama}
+@index{lynx}
+@index{bat}
+\end{filecontents*}
+\usepackage[record,nostyles,stylemods=bookindex,style=bookindex]
+ {glossaries-extra}
+
+\newcommand{\bibglssetlastgrouptitle}[2]{%
+ \glsxtrsetgrouptitle{#1#2}{Other}%
+} \GlsXtrLoadResources[src=animals,selection=all,
+ sort=custom,sort-rule={ < a,A < b,B < e,E < l,L < ll,Ll,LL < z,Z}]
+\begin{document}
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example158.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example158.pdf
new file mode 100644
index 0000000000..1892a4bb4d
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example158.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example158.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example158.png
new file mode 100644
index 0000000000..202418fb4a
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example158.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example158.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example158.tex
new file mode 100644
index 0000000000..658402f439
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example158.tex
@@ -0,0 +1,29 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 158 Using bib2gls: dual backlinks
+% arara: pdflatex
+% arara: bib2gls
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\begin{filecontents*}{\jobname.bib}
+@dualindexsymbol{L,
+ name={Lagrangian function},
+ symbol={\ensuremath{L}},
+ description={a function of generalized co-ordinates}
+}
+\end{filecontents*}
+\usepackage[colorlinks]{hyperref}
+\usepackage[record,symbols,nostyles,stylemods={tree,bookindex}]{glossaries-extra}
+\GlsXtrLoadResources[src=\jobname,
+ dual-type=symbols,dual-field
+]
+\glsdefpostlink{index}{\glsxtrpostlinkAddSymbolOnFirstUse}
+\glsdefpostname{index}{%
+ \ifglshassymbol{\glscurrententrylabel}
+ { (\GlsXtrDualBackLink{\glsentrysymbol{\glscurrententrylabel}}{\glscurrententrylabel})}{}}
+\begin{document}
+Primary: \gls{L}.
+\printunsrtglossary[type=symbols,style=tree]
+\printunsrtglossary[title=Index,style=bookindex]
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example159.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example159.pdf
new file mode 100644
index 0000000000..9cc1608575
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example159.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example159.png b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example159.png
new file mode 100644
index 0000000000..a9d5a0f4e1
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example159.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example159.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example159.tex
new file mode 100644
index 0000000000..c51bcd502e
--- /dev/null
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual-examples/glossaries-extra-manual-example159.tex
@@ -0,0 +1,36 @@
+% This file is embedded in glossaries-extra-manual.pdf
+% Example 159 Using bib2gls: dual entry label prefixes
+% arara: pdflatex
+% arara: bib2gls
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\begin{filecontents*}{\jobname.bib}
+@index{duck}
+@dualindexabbreviation{svm,
+ short={SVM},
+ long={support vector machine}
+}
+ @dualindexsymbol{pi,
+ symbol={\ensuremath{\pi}},
+ description={ratio of a circle's circumference to its diameter}
+}
+\end{filecontents*}
+\usepackage{hyperref}
+\usepackage[record,abbreviations,symbols]{glossaries-extra}
+
+\newcommand{\bibglsnewdualindexsymbolsecondary}[5]{%
+ \longnewglossaryentry*{#1}{name={#3},category={symbol},
+ type={symbols},symbol={#4},#2}{#5}%
+}
+
+\GlsXtrLoadResources[src=\jobname,
+ combine-dual-locations=primary]
+\glsxtraddlabelprefix{dual.}
+\glsxtraddlabelprefix{}
+\begin{document}
+First use: \dgls{duck}, \dgls{svm}, \dgls{pi}.
+Next use: \dgls{duck}, \dgls{svm}, \dgls{pi}.
+\printunsrtglossaries
+\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual.html b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual.html
index 20c77bfc86..f2dbd41eb3 100644
--- a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual.html
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual.html
@@ -1,35596 +1,24365 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!--http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd-->
-<html xmlns="http://www.w3.org/1999/xhtml"
->
-<head><title></title>
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="TeX4ht (https://tug.org/tex4ht/)" />
-<meta name="originator" content="TeX4ht (https://tug.org/tex4ht/)" />
-<!-- xhtml,fn-in,css-in,uni-html4,utf8 -->
-<meta name="src" content="glossaries-extra-manual.tex" />
-
-<style type="text/css">
-<!--
-
-/* start css.sty */
-.cmmi-5{font-size:50%;font-style: italic;}
-.cmmi-10{font-style: italic;}
-.cmr-17{font-size:170%;}
-.cmr-12{font-size:120%;}
-.cmr-8{font-size:80%;}
-.cmtt-12{font-size:120%;font-family: monospace,monospace;}
-.cmtt-12{font-family: monospace,monospace;}
-.cmtt-12{font-family: monospace,monospace;}
-.cmtt-12{font-family: monospace,monospace;}
-.cmtt-12{font-family: monospace,monospace;}
-.cmbx-10{ font-weight: bold;}
-.cmss-10{ font-family: sans-serif;}
-.cmss-10{ font-family: sans-serif;}
-.cmss-10{ font-family: sans-serif;}
-.cmss-10{ font-family: sans-serif;}
-.cmtt-10{font-family: monospace,monospace;}
-.cmtt-10{font-family: monospace,monospace;}
-.cmtt-10{font-family: monospace,monospace;}
-.cmtt-10{font-family: monospace,monospace;}
-.cmtt-10{font-family: monospace,monospace;}
-.cmssbx-10{ font-family: sans-serif; font-weight: bold;}
-.cmssbx-10{ font-family: sans-serif; font-weight: bold;}
-.cmssbx-10{ font-family: sans-serif; font-weight: bold;}
-.cmssbx-10{ font-family: sans-serif; font-weight: bold;}
-.cmr-9{font-size:90%;}
-.cmss-8{font-size:80%; font-family: sans-serif;}
-.cmss-8{ font-family: sans-serif;}
-.cmss-8{ font-family: sans-serif;}
-.cmss-8{ font-family: sans-serif;}
-.cmtt-9{font-size:90%;font-family: monospace,monospace;}
-.cmtt-9{font-family: monospace,monospace;}
-.cmtt-9{font-family: monospace,monospace;}
-.cmtt-9{font-family: monospace,monospace;}
-.cmtt-9{font-family: monospace,monospace;}
-.cmti-10{ font-style: italic;}
-.cmitt-10{font-family: monospace,monospace; font-style: italic;}
-.cmmi-9{font-size:90%;font-style: italic;}
-.cmssi-10{ font-family: sans-serif; font-style: oblique;}
-.cmssi-10{ font-family: sans-serif; font-style: oblique;}
-.cmssi-10{ font-family: sans-serif; font-style: oblique;}
-.cmssi-10{ font-family: sans-serif; font-style: oblique;}
-.cmtt-8{font-size:80%;font-family: monospace,monospace;}
-.cmtt-8{font-family: monospace,monospace;}
-.cmtt-8{font-family: monospace,monospace;}
-.cmtt-8{font-family: monospace,monospace;}
-.cmtt-8{font-family: monospace,monospace;}
-.cmti-8{font-size:80%; font-style: italic;}
-.small-caps{font-variant: small-caps; }
-p{margin-top:0;margin-bottom:0}
-p.indent{text-indent:0;}
-p + p{margin-top:1em;}
-p + div, p + pre {margin-top:1em;}
-div + p, pre + p {margin-top:1em;}
-a { overflow-wrap: break-word; word-wrap: break-word; word-break: break-word; hyphens: auto; }
-@media print {div.crosslinks {visibility:hidden;}}
-a img { border-top: 0; border-left: 0; border-right: 0; }
-center { margin-top:1em; margin-bottom:1em; }
-td center { margin-top:0em; margin-bottom:0em; }
-.Canvas { position:relative; }
-img.math{vertical-align:middle;}
-div.par-math-display, div.math-display{text-align:center;}
-li p.indent { text-indent: 0em }
-li p:first-child{ margin-top:0em; }
-li p:last-child, li div:last-child { margin-bottom:0.5em; }
-li p~ul:last-child, li p~ol:last-child{ margin-bottom:0.5em; }
-.enumerate1 {list-style-type:decimal;}
-.enumerate2 {list-style-type:lower-alpha;}
-.enumerate3 {list-style-type:lower-roman;}
-.enumerate4 {list-style-type:upper-alpha;}
-div.newtheorem { margin-bottom: 2em; margin-top: 2em;}
-.obeylines-h,.obeylines-v {white-space: nowrap; }
-div.obeylines-v p { margin-top:0; margin-bottom:0; }
-.overline{ text-decoration:overline; }
-.overline img{ border-top: 1px solid black; }
-td.displaylines {text-align:center; white-space:nowrap;}
-.centerline {text-align:center;}
-.rightline {text-align:right;}
-pre.verbatim {font-family: monospace,monospace; text-align:left; clear:both; }
-.fbox {padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; }
-div.fbox {display:table}
-div.center div.fbox {text-align:center; clear:both; padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; }
-div.minipage{width:100%;}
-div.center, div.center div.center {text-align: center; margin-left:1em; margin-right:1em;}
-div.center div {text-align: left;}
-div.flushright, div.flushright div.flushright {text-align: right;}
-div.flushright div {text-align: left;}
-div.flushleft {text-align: left;}
-.underline{ text-decoration:underline; }
-.underline img{ border-bottom: 1px solid black; margin-bottom:1pt; }
-.framebox-c, .framebox-l, .framebox-r { padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; }
-.framebox-c {text-align:center;}
-.framebox-l {text-align:left;}
-.framebox-r {text-align:right;}
-span.thank-mark{ vertical-align: super }
-span.footnote-mark sup.textsuperscript, span.footnote-mark a sup.textsuperscript{ font-size:80%; }
-div.footnotes{border-top:solid 1px black; border-bottom:solid 1px black; padding-bottom:1ex; padding-top:0.5ex; margin-right:15%; margin-top:2ex; font-style:italic; font-size:85%;}
-div.footnotes p{margin-top:0; margin-bottom:0; text-indent:0;}
-div.tabular, div.center div.tabular {text-align: center; margin-top:0.5em; margin-bottom:0.5em; }
-table.tabular td p{margin-top:0em;}
-table.tabular {margin-left: auto; margin-right: auto;}
-td p:first-child{ margin-top:0em; }
-td p:last-child{ margin-bottom:0em; }
-div.td00{ margin-left:0pt; margin-right:0pt; }
-div.td01{ margin-left:0pt; margin-right:5pt; }
-div.td10{ margin-left:5pt; margin-right:0pt; }
-div.td11{ margin-left:5pt; margin-right:5pt; }
-table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; }
-td.td00{ padding-left:0pt; padding-right:0pt; }
-td.td01{ padding-left:0pt; padding-right:5pt; }
-td.td10{ padding-left:5pt; padding-right:0pt; }
-td.td11{ padding-left:5pt; padding-right:5pt; }
-table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; }
-.hline hr, .cline hr{ height : 0px; margin:0px; }
-.hline td, .cline td{ padding: 0; }
-.hline hr, .cline hr{border:none;border-top:1px solid black;}
-.tabbing-right {text-align:right;}
-div.float, div.figure {margin-left: auto; margin-right: auto;}
-div.float img {text-align:center;}
-div.figure img {text-align:center;}
-.marginpar,.reversemarginpar {width:20%; float:right; text-align:left; margin-left:auto; margin-top:0.5em; font-size:85%; text-decoration:underline;}
-.marginpar p,.reversemarginpar p{margin-top:0.4em; margin-bottom:0.4em;}
-.reversemarginpar{float:left;}
-table.equation {width:100%;}
-.equation td{text-align:center; }
-td.equation { margin-top:1em; margin-bottom:1em; }
-td.equation-label { width:5%; text-align:center; }
-td.eqnarray4 { width:5%; white-space: normal; }
-td.eqnarray2 { width:5%; }
-table.eqnarray-star, table.eqnarray {width:100%;}
-div.eqnarray{text-align:center;}
-div.array {text-align:center;}
-div.pmatrix {text-align:center;}
-table.pmatrix {width:100%;}
-span.pmatrix img{vertical-align:middle;}
-div.pmatrix {text-align:center;}
-table.pmatrix {width:100%;}
-span.bar-css {text-decoration:overline;}
-img.cdots{vertical-align:middle;}
-.partToc a, .partToc, .likepartToc a, .likepartToc {line-height: 200%; font-weight:bold; font-size:110%;}
-.chapterToc a, .chapterToc, .likechapterToc a, .likechapterToc, .appendixToc a, .appendixToc {line-height: 200%; font-weight:bold;}
-.index-item, .index-subitem, .index-subsubitem {display:block}
-div.caption {text-indent:-2em; margin-left:3em; margin-right:1em; text-align:left;}
-div.caption span.id{font-weight: bold; white-space: nowrap; }
-h1.partHead{text-align: center}
-p.bibitem { text-indent: -2em; margin-left: 2em; margin-top:0.6em; margin-bottom:0.6em; }
-p.bibitem-p { text-indent: 0em; margin-left: 2em; margin-top:0.6em; margin-bottom:0.6em; }
-.paragraphHead, .likeparagraphHead { margin-top:2em; font-weight: bold;}
-.subparagraphHead, .likesubparagraphHead { font-weight: bold;}
-.verse{white-space:nowrap; margin-left:2em}
-div.maketitle {text-align:center;}
-h2.titleHead{text-align:center;}
-div.maketitle{ margin-bottom: 2em; }
-div.author, div.date {text-align:center;}
-div.thanks{text-align:left; margin-left:10%; font-size:85%; font-style:italic; }
-h1.partHead{text-align: center}
-div.abstract p {margin-left:5%; margin-right:5%;}
-div.abstract {width:100%;}
-.abstracttitle{text-align:center;margin-bottom:1em;}
-.alltt P { margin-bottom : 0em; margin-top : 0em; }
-.alltt { margin-bottom : 1em; margin-top : 1em; font-family:monospace,monospace; }
-.uline{ text-decoration:underline; }
-.uuline{ text-decoration:underline; }
-span.sout {text-decoration: line-through }
-span.xout {text-decoration: line-through }
-span.uwave {text-decoration:underline }
-.equation td{text-align:center; }
-.equation-star td{text-align:center; }
-table.equation-star { width:100%; }
-table.equation { width:100%; }
-table.align, table.alignat, table.xalignat, table.xxalignat, table.flalign {width:95%; margin-left:5%; white-space: nowrap;}
-table.align-star, table.alignat-star, table.xalignat-star, table.flalign-star {margin-left:auto; margin-right:auto; white-space: nowrap;}
-td.align-label { width:5%; text-align:center; }
-td.align-odd { text-align:right; padding-right:0.3em;}
-td.align-even { text-align:left; padding-right:0.6em;}
-table.multline, table.multline-star {width:100%;}
-td.gather {text-align:center; }
-table.gather {width:100%;}
-div.gather-star {text-align:center;}
-table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; }
-div.longtable{text-align:center;}
-table.longtable{margin-left:auto; margin-right: auto;}
-.supertabular {text-align:center}
-.warningsymbol { color: red; font-weight: bold;}
-div.important { border : solid red; }
-div.verbatim { font-family: monospace; white-space: nowrap; text-align:left; clear:both; padding-top: 2ex; padding-bottom: 2ex;}
-span.HoLogo-XeLaTeX span.HoLogo-Xe{margin-right:-.13em;}
-span.HoLogo-Xe span.HoLogo-e{position:relative;top:.5ex;left-margin:-.1em;}
-span.HoLogo-LaTeX span.HoLogo-a{position:relative;top:-.5ex;margin-left:-.36em;margin-right:-.15em;font-size:85%;}
-span.HoLogo-TeX span.HoLogo-e{position:relative;top:.5ex;margin-left:-.1667em;margin-right:-.125em;}
-a span.HoLogo-TeX span.HoLogo-e{text-decoration:none;}
-/* end css.sty */
-
-
--->
-</style>
-</head><body
->
-<!--l. 250--><p class="noindent" ><a
- id="top"></a>
-</p><!--l. 250--><p class="indent" >
-
-
-
-</p><!--l. 250--><p class="indent" >
-
-
-
-</p>
-<div class="center"
->
-<!--l. 250--><p class="noindent" >
-</p><!--l. 250--><p class="noindent" ><span
-class="cmr-17">glossaries-extra.sty v1.48: an extension to the</span>
-<span
-class="cmr-17">glossaries package</span>
-</p>
-<div class="tabular"> <table id="TBL-1" class="tabular"
-
-><colgroup id="TBL-1-1g"><col
-id="TBL-1-1" /></colgroup><tr
- style="vertical-align:baseline;" id="TBL-1-1-"><td style="white-space:nowrap; text-align:center;" id="TBL-1-1-1"
-class="td11"> <span
-class="cmr-12">Nicola L.C. Talbot </span></td>
-</tr><tr
-class="vspace" style="font-size:10.0pt"><td
->&nbsp;</td></tr><tr
- style="vertical-align:baseline;" id="TBL-1-2-"><td style="white-space:nowrap; text-align:center;" id="TBL-1-2-1"
-class="td11"> <span
-class="cmr-12">Dickimaw Books </span></td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-1-3-"><td style="white-space:nowrap; text-align:center;" id="TBL-1-3-1"
-class="td11"><a
-href="http://www.dickimaw-books.com/" class="url" ><span
-class="cmtt-12">http://www.dickimaw-books.com/</span></a></td></tr></table>
-</div>
-<!--l. 250--><p class="noindent" ><span
-class="cmr-12">2021-11-22</span></p></div>
- <div
-class="abstract"
->
-<!--l. 252--><p class="indent" >
-
-
-
-</p>
- <h3 class="abstracttitle">
-<span
-class="cmbx-10">Abstract</span>
-</h3> The <span
-class="cmss-10">glossaries-extra </span>package is an extension to the <span
-class="cmss-10">glossaries </span>package, providing
-additional features. Some of the features provided by this package are only available
-with <span
-class="cmss-10">glossaries </span>version 4.19 (or above). This document assumes familiarity with the
-<span
-class="cmss-10">glossaries </span>package.
-<!--l. 259--><p class="noindent" >The file <span
-class="cmtt-10">example-glossaries-xr.tex </span>contains dummy entries with cross-references
-that may be used for creating minimal working examples for testing the
-<span
-class="cmss-10">glossaries-extra </span>package. (The base <span
-class="cmss-10">glossaries </span>package provides additional files, but
-this one needs <span
-class="cmss-10">glossaries-extra</span>.) There are equivalent <span
-class="cmtt-10">.bib </span>files for use with
-<a
- id="dx1-2"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a>.
-</p><!--l. 267--><p class="indent" > <span
-class="cmbx-10">The </span><span
-class="cmssbx-10">glossaries-extra </span><span
-class="cmbx-10">package uses a different set of defaults to the base</span>
-<span
-class="cmssbx-10">glossaries </span><span
-class="cmbx-10">package. </span>See the Introduction for more details.
-</p><!--l. 269--><p class="indent" >
-
-
-
-</p>
- </div>
-<!--l. 271--><p class="indent" > <div class="important" title="Important Note"> Since <span
-class="cmss-10">glossaries-extra </span>internally loads the <span
-class="cmss-10">glossaries </span>package, you also need to have
-<span
-class="cmss-10">glossaries </span>installed and all the packages that <span
-class="cmss-10">glossaries </span>depends on (including, but not
-limited to, <span
-class="cmss-10">tracklang</span><a
- id="dx1-3"></a>, <span
-class="cmss-10">mfirstuc</span><a
- id="dx1-4"></a>, <span
-class="cmss-10">etoolbox</span><a
- id="dx1-5"></a>, <span
-class="cmss-10">xkeyval</span><a
- id="dx1-6"></a> (at least version dated 2006/11/18),
-<span
-class="cmss-10">textcase</span><a
- id="dx1-7"></a>, <span
-class="cmss-10">xfor</span><a
- id="dx1-8"></a>, <span
-class="cmss-10">datatool-base</span><a
- id="dx1-9"></a> and <span
-class="cmss-10">amsgen</span><a
- id="dx1-10"></a>. These packages are all available in the
-current TeX&#x00A0;Live and MikTeX&#x00A0;distributions. If any of them are missing, please
-update your TeX&#x00A0;distribution using your update manager. (For help on this see, for
-example, <a
-href="http://tex.stackexchange.com/questions/55437/how-do-i-update-my-tex-distribution" >How do I update my TeX&#x00A0;distribution?</a> or <a
-href="http://tex.stackexchange.com/questions/14925/updating-tex-on-linux" >Updating TeX&#x00A0;on Linux</a>.)
-</div>
-</p><!--l. 286--><p class="noindent" >
-</p><!--l. 288--><p class="indent" > Additional resources: </p>
- <ul class="itemize1">
- <li class="itemize">The <span
-class="cmss-10">glossaries-extra </span>documented code <a
-href="http://mirrors.ctan.org/macros/latex/contrib/glossaries-extra/glossaries-extra-code.pdf" >glossaries-extra-code.pdf</a>.
- </li>
- <li class="itemize">The <a
-href="http://www.dickimaw-books.com/gallery/#glossaries-extra" ><span
-class="cmss-10">glossaries-extra </span>gallery</a>.
- </li>
- <li class="itemize"><span
-class="cmss-10">glossaries-extra </span>and <a
- id="dx1-11"></a><span
-class="cmtt-10">bib2gls</span>: An Introductory Guide.
- (<a
-href="http://mirrors.ctan.org/support/bib2gls/bib2gls-begin.pdf" ><span
-class="cmtt-10">bib2gls-begin.pdf</span></a>).
- </li>
- <li class="itemize"><a
-href="https://www.dickimaw-books.com/latex/buildglossaries/" >Incorporating makeglossaries or makeglossaries-lite or bib2gls into the
- document build</a>.
- </li>
- <li class="itemize">The <a
-href="http://www.dickimaw-books.com/software/bib2gls" ><span
-class="cmtt-10">bib2gls</span></a> application.
- </li>
- <li class="itemize">The base <a
-href="https://ctan.org/pkg/glossaries" ><span
-class="cmss-10">glossaries</span></a> package.</li></ul>
-
-
-
- <h2 class="likechapterHead"><a
- id="x1-1000"></a>Contents</h2>
- <div class="tableofcontents">
- <span class="chapterToc" >1 <a
-href="#sec:intro" id="QQ2-1-2">Introduction</a></span>
-<br /> &#x00A0;<span class="sectionToc" >1.1 <a
-href="#sec:defaults" id="QQ2-1-3">Package Defaults</a></span>
-<br /> &#x00A0;<span class="sectionToc" >1.2 <a
-href="#sec:pkgopts" id="QQ2-1-4">New or Modified Package Options</a></span>
-<br /> <span class="chapterToc" >2 <a
-href="#sec:modifications" id="QQ2-1-5">Modifications to Existing Commands and Styles</a></span>
-<br /> &#x00A0;<span class="sectionToc" >2.1 <a
-href="#sec:definingentries" id="QQ2-1-6">Defining Entries</a></span>
-<br /> &#x00A0;<span class="sectionToc" >2.2 <a
-href="#sec:wrglossary" id="QQ2-1-7">Entry Indexing</a></span>
-<br /> &#x00A0;<span class="sectionToc" >2.3 <a
-href="#sec:see" id="QQ2-1-8">Cross-References (&#8220;see&#8221; and &#8220;see also&#8221;)</a></span>
-<br /> &#x00A0;<span class="sectionToc" >2.4 <a
-href="#sec:entryfmtmods" id="QQ2-1-9">Entry Display Style Modifications</a></span>
-<br /> &#x00A0;<span class="sectionToc" >2.5 <a
-href="#sec:entrycountmods" id="QQ2-1-10">Entry Counting Modifications</a></span>
-<br /> &#x00A0;<span class="sectionToc" >2.6 <a
-href="#sec:glsunset" id="QQ2-1-11">First Use Flag</a></span>
-<br /> &#x00A0;<span class="sectionToc" >2.7 <a
-href="#sec:plurals" id="QQ2-1-12">Plurals</a></span>
-<br /> &#x00A0;<span class="sectionToc" >2.8 <a
-href="#sec:nested" id="QQ2-1-13">Nested Links</a></span>
-<br /> &#x00A0;<span class="sectionToc" >2.9 <a
-href="#sec:acronymmods" id="QQ2-1-14">Acronym Style Modifications</a></span>
-<br /> &#x00A0;<span class="sectionToc" >2.10 <a
-href="#sec:glossaries" id="QQ2-1-16">Glossaries</a></span>
-<br /> &#x00A0;<span class="sectionToc" >2.11 <a
-href="#sec:glosstylemods" id="QQ2-1-17">Glossary Style Modifications</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >2.11.1 <a
-href="#sec:stylehooks" id="QQ2-1-18">Style Hooks</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >2.11.2 <a
-href="#sec:glosstylenumlist" id="QQ2-1-19">Number List</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >2.11.3 <a
-href="#sec:stylemods" id="QQ2-1-20">The glossaries-extra-stylemods Package</a></span>
-<br /> <span class="chapterToc" >3 <a
-href="#sec:newglossarystyles" id="QQ2-1-24">New Glossary Styles</a></span>
-<br /> &#x00A0;<span class="sectionToc" >3.1 <a
-href="#sec:bookindex" id="QQ2-1-25">glossary-bookindex package</a></span>
-<br /> &#x00A0;<span class="sectionToc" >3.2 <a
-href="#sec:longextra" id="QQ2-1-26">glossary-longextra package</a></span>
-<br /> &#x00A0;<span class="sectionToc" >3.3 <a
-href="#sec:topic" id="QQ2-1-27">glossary-topic package</a></span>
-<br /> <span class="chapterToc" >4 <a
-href="#sec:abbreviations" id="QQ2-1-28">Abbreviations</a></span>
-<br /> &#x00A0;<span class="sectionToc" >4.1 <a
-href="#sec:tagging" id="QQ2-1-29">Tagging Initials</a></span>
-<br /> &#x00A0;<span class="sectionToc" >4.2 <a
-href="#sec:abbrstyle" id="QQ2-1-30">Abbreviation Styles</a></span>
-<br /> &#x00A0;<span class="sectionToc" >4.3 <a
-href="#sec:abbrshortcuts" id="QQ2-1-31">Shortcut Commands</a></span>
-<br /> &#x00A0;<span class="sectionToc" >4.4 <a
-href="#sec:predefabbrvstyles" id="QQ2-1-33">Predefined Abbreviation Styles</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >4.4.1 <a
-href="#sec:predefregabbrvstyles" id="QQ2-1-34">Predefined Abbreviation Styles that Set the Regular Attribute</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >4.4.2 <a
-href="#sec:predefnonregabbrvstyles" id="QQ2-1-35">Predefined Abbreviation Styles that Don&#8217;t Set the Regular Attribute</a></span>
-<br /> &#x00A0;<span class="sectionToc" >4.5 <a
-href="#sec:newabbrvstyle" id="QQ2-1-36">Defining New Abbreviation Styles</a></span>
-<br /> <span class="chapterToc" >5 <a
-href="#sec:headtitle" id="QQ2-1-37">Entries in Sectioning Titles, Headers, Captions and Contents</a></span>
-<br /> &#x00A0;<span class="sectionToc" >5.1 <a
-href="#sec:simplisticapproach" id="QQ2-1-38">Simplistic Approach</a></span>
-<br /> &#x00A0;<span class="sectionToc" >5.2 <a
-href="#sec:headingcommands" id="QQ2-1-39">New Commands Designed for Chapter/Section Headings</a></span>
-<br /> <span class="chapterToc" >6 <a
-href="#sec:multientries" id="QQ2-1-40">Multi (or Compound) Entries</a></span>
-<br /> &#x00A0;<span class="sectionToc" >6.1 <a
-href="#sec:mglsexamples" id="QQ2-1-41">Examples</a></span>
-
-
-
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >6.1.1 <a
-href="#sec:mglsexhier" id="QQ2-1-42">Example: Hierarchical</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >6.1.2 <a
-href="#sec:mglsexsuffix" id="QQ2-1-43">Example: Suffix</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >6.1.3 <a
-href="#sec:mglsexcatsuffix" id="QQ2-1-44">Example: Category Suffix</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >6.1.4 <a
-href="#sec:mglsexsep" id="QQ2-1-45">Example: Separators</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >6.1.5 <a
-href="#sec:exskipfirstsuffix" id="QQ2-1-46">Example: Skipping Elements (Fragment Element)</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >6.1.6 <a
-href="#sec:exskippostlink" id="QQ2-1-47">Example: Skipping Elements (Prefix and Post-Link Hooks)</a></span>
-<br /> &#x00A0;<span class="sectionToc" >6.2 <a
-href="#sec:mglsmain" id="QQ2-1-48">Main and Other Elements</a></span>
-<br /> &#x00A0;<span class="sectionToc" >6.3 <a
-href="#sec:mglsfixes" id="QQ2-1-49">Prefixes and Suffixes</a></span>
-<br /> &#x00A0;<span class="sectionToc" >6.4 <a
-href="#sec:mglssep" id="QQ2-1-50">Separators</a></span>
-<br /> &#x00A0;<span class="sectionToc" >6.5 <a
-href="#sec:mglselementhooks" id="QQ2-1-51">mgls Element Hooks</a></span>
-<br /> &#x00A0;<span class="sectionToc" >6.6 <a
-href="#sec:mglspostlinkhook" id="QQ2-1-52">Post-Link Hook</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >6.6.1 <a
-href="#sec:mglspostlinkhooklastelement" id="QQ2-1-53">Last Element</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >6.6.2 <a
-href="#sec:mglspostlinkhookmainelement" id="QQ2-1-54">Main Element</a></span>
-<br /> &#x00A0;<span class="sectionToc" >6.7 <a
-href="#sec:mglsfirstuse" id="QQ2-1-55">Multi-Entry First Use</a></span>
-<br /> &#x00A0;<span class="sectionToc" >6.8 <a
-href="#sec:multiglscategory" id="QQ2-1-56">Multi-Entry Category</a></span>
-<br /> &#x00A0;<span class="sectionToc" >6.9 <a
-href="#sec:multiglsoptions" id="QQ2-1-57">Multi-Entry Settings</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >6.9.1 <a
-href="#sec:multiglsoptionsindexing" id="QQ2-1-58">Indexing</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >6.9.2 <a
-href="#sec:multiglsoptionsencap" id="QQ2-1-59">Location Formats (Encaps)</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >6.9.3 <a
-href="#sec:multiglsoptionspostlink" id="QQ2-1-60">Post-Link Hooks</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >6.9.4 <a
-href="#sec:multiglsoptionsfixes" id="QQ2-1-61">Prefixes and Suffixes</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >6.9.5 <a
-href="#sec:multiglsoptionsskip" id="QQ2-1-62">Skipping Elements</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >6.9.6 <a
-href="#sec:multiglsoptionsgeneral" id="QQ2-1-63">General</a></span>
-<br /> &#x00A0;<span class="sectionToc" >6.10 <a
-href="#sec:mglsopts" id="QQ2-1-64">mgls Options</a></span>
-<br /> &#x00A0;<span class="sectionToc" >6.11 <a
-href="#sec:mglslike" id="QQ2-1-65">Variants of mgls</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >6.11.1 <a
-href="#sec:mglsbasic" id="QQ2-1-66">gls-like</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >6.11.2 <a
-href="#sec:mglsabbrv" id="QQ2-1-67">Abbreviations</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >6.11.3 <a
-href="#sec:mglsotherfields" id="QQ2-1-68">Other Fields</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >6.11.4 <a
-href="#sec:mpgls" id="QQ2-1-69">Support for glossaries-prefix (pgls)</a></span>
-<br /> &#x00A0;<span class="sectionToc" >6.12 <a
-href="#sec:msee" id="QQ2-1-70">Cross-References</a></span>
-<br /> &#x00A0;<span class="sectionToc" >6.13 <a
-href="#sec:multiextras" id="QQ2-1-71">Additional Commands</a></span>
-<br /> &#x00A0;<span class="sectionToc" >6.14 <a
-href="#sec:mbib2gls" id="QQ2-1-72">bib2gls</a></span>
-<br /> <span class="chapterToc" >7 <a
-href="#sec:categories" id="QQ2-1-73">Categories</a></span>
-<br /> <span class="chapterToc" >8 <a
-href="#sec:countref" id="QQ2-1-74">Counting References</a></span>
-<br /> &#x00A0;<span class="sectionToc" >8.1 <a
-href="#sec:entrycount" id="QQ2-1-75">Entry Counting (First Use Flag)</a></span>
-<br /> &#x00A0;<span class="sectionToc" >8.2 <a
-href="#sec:linkcount" id="QQ2-1-76">Link Counting</a></span>
-<br /> <span class="chapterToc" >9 <a
-href="#sec:autoindex" id="QQ2-1-77">Auto-Indexing</a></span>
-<br /> <span class="chapterToc" >10 <a
-href="#sec:bib2gls" id="QQ2-1-78">bib2gls: Managing Reference Databases</a></span>
-<br /> &#x00A0;<span class="sectionToc" >10.1 <a
-href="#sec:bib2glsselection" id="QQ2-1-79">Selection</a></span>
-<br /> &#x00A0;<span class="sectionToc" >10.2 <a
-href="#sec:bib2glssortprint" id="QQ2-1-80">Sorting and Displaying the Glossary</a></span>
-<br /> &#x00A0;<span class="sectionToc" >10.3 <a
-href="#sec:bib2glssty" id="QQ2-1-81">The glossaries-extra-bib2gls package</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >10.3.1 <a
-href="#sec:supplocations" id="QQ2-1-82">Supplemental Locations</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >10.3.2 <a
-href="#sec:recordnameref" id="QQ2-1-83">Nameref Record</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >10.3.3 <a
-href="#sec:resourcecommands" id="QQ2-1-84">Helper Commands for Resource Options</a></span>
-<br /> &#x00A0;<span class="sectionToc" >10.4 <a
-href="#sec:bib2glssupplementarycommands" id="QQ2-1-85">Supplementary Commands</a></span>
-<br /> &#x00A0;<span class="sectionToc" >10.5 <a
-href="#sec:recordcount" id="QQ2-1-86">Record Counting</a></span>
-<br /> <span class="chapterToc" >11 <a
-href="#sec:miscnew" id="QQ2-1-87">Miscellaneous New Commands</a></span>
-
-
-
-<br /> &#x00A0;<span class="sectionToc" >11.1 <a
-href="#sec:fields" id="QQ2-1-88">Entry Fields</a></span>
-<br /> &#x00A0;<span class="sectionToc" >11.2 <a
-href="#sec:printunsrt" id="QQ2-1-89">Display All Entries Without Sorting or Indexing</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >11.2.1 <a
-href="#sec:printunsrthooks" id="QQ2-1-90">Hooks</a></span>
-<br /> &#x00A0;&#x00A0;<span class="subsectionToc" >11.2.2 <a
-href="#sec:printunsrtfilter" id="QQ2-1-91">Filtering</a></span>
-<br /> &#x00A0;<span class="sectionToc" >11.3 <a
-href="#sec:printunsrtinner" id="QQ2-1-92">Partial Glossaries</a></span>
-<br /> &#x00A0;<span class="sectionToc" >11.4 <a
-href="#sec:glossentry" id="QQ2-1-93">Standalone Entry Items</a></span>
-<br /> &#x00A0;<span class="sectionToc" >11.5 <a
-href="#sec:alias" id="QQ2-1-94">Entry Aliases</a></span>
-<br /> <span class="chapterToc" >12 <a
-href="#sec:onthefly" id="QQ2-1-95">On-the-Fly Document Definitions</a></span>
-<br /> <span class="chapterToc" >13 <a
-href="#sec:supplemental" id="QQ2-1-96">Supplemental Packages</a></span>
-<br /> &#x00A0;<span class="sectionToc" >13.1 <a
-href="#sec:prefix" id="QQ2-1-97">Prefixes or Determiners</a></span>
-<br /> &#x00A0;<span class="sectionToc" >13.2 <a
-href="#sec:accsupp" id="QQ2-1-98">Accessibility Support</a></span>
-<br /> <span class="chapterToc" >14 <a
-href="#sec:samples" id="QQ2-1-99">Sample Files</a></span>
-<br /> <span class="chapterToc" >15 <a
-href="#sec:lang" id="QQ2-1-100">Multi-Lingual Support</a></span>
-<br /> <span class="chapterToc" > <a
-href="#glossary">Glossary</a></span>
- </div>
-
-
-
-<!--l. 313--><p class="indent" > <div class="chapter"><h2 class="chapterHead">1. <a
- id="sec:intro"></a>Introduction</h2>
-</p><!--l. 316--><p class="indent" > The <span
-class="cmss-10">glossaries </span>package is a flexible package, but it&#8217;s also a heavy-weight package
-that uses a lot of resources. As package developer, I&#8217;m caught between those users
-who complain about the drawbacks of a heavy-weight package with a large user
-manual and those users who want more features (which necessarily adds to the
-package weight and manual size).
-</p><!--l. 323--><p class="indent" > The <span
-class="cmss-10">glossaries-extra </span>package is an attempt to provide a&#x00A0;compromise for this
-conflict. Version 4.22 of the <span
-class="cmss-10">glossaries </span>package is the last version to incorporate new
-features.<span class="footnote-mark"><a
-href="#fn1x1" id="fn1x1-bk"><sup class="textsuperscript">1.1</sup></a></span><a
- id="x1-2001f1"></a>
-Future versions of <span
-class="cmss-10">glossaries </span>will just be bug fixes. New features will instead be added
-to <span
-class="cmss-10">glossaries-extra</span>. This means that the base <span
-class="cmss-10">glossaries </span>package won&#8217;t increase in terms
-of package loading time and allocation of resources, but those users who do want
-extra features available will have more of a chance of getting their feature requests
-accepted.
-</p>
-<!--l. 337--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">1.1 </span> <a
- id="sec:defaults"></a>Package Defaults</h3>
-<!--l. 340--><p class="noindent" >I&#8217;m not happy with some of the default settings assumed by the <span
-class="cmss-10">glossaries </span>package,
-and, judging from code I&#8217;ve seen, other users also seem unhappy with them, as
-certain package options are often used in questions posted on various sites. I can&#8217;t
-change the default behaviour of <span
-class="cmss-10">glossaries </span>as it would break backward compatibility,
-but since <span
-class="cmss-10">glossaries-extra </span>is a separate package, I have decided to implement some of
-these commonly-used options by default. You can switch them back if they&#8217;re not
-appropriate.
-</p><!--l. 350--><p class="indent" > The new defaults are: </p>
- <ul class="itemize1">
- <li class="itemize"><a
-href="#styopt.toc"><span
-class="cmss-10">toc</span></a><span
-class="cmss-10">=true</span><a
- id="dx1-3001"></a> (add the glossaries to the table of contents). Use <a
-href="#styopt.toc"><span
-class="cmss-10">toc</span></a><span
-class="cmss-10">=false</span><a
- id="dx1-3002"></a> to
- switch this back off.
- </li>
- <li class="itemize"><a
-href="#styopt.nopostdot"><span
-class="cmss-10">nopostdot</span></a><span
-class="cmss-10">=true</span><a
- id="dx1-3003"></a> (suppress the terminating full stop after the description
- in the glossary). Use <a
-href="#styopt.nopostdot"><span
-class="cmss-10">nopostdot</span></a><span
-class="cmss-10">=false</span><a
- id="dx1-3004"></a> or just <a
-href="#styopt.postdot"><span
-class="cmss-10">postdot</span></a><a
- id="dx1-3005"></a> to restore the
- terminating full stop (period).
- </li>
- <li class="itemize"><a
-href="#styopt.noredefwarn"><span
-class="cmss-10">noredefwarn</span></a><span
-class="cmss-10">=true</span><a
- id="dx1-3006"></a> (suppress the warnings that occur when the <span
-class="cmss-10">theglossary</span><a
- id="dx1-3007"></a><a
- id="dx1-3008"></a>
- environment and <span
-class="cmtt-10">\printglossary </span>are redefined while <span
-class="cmss-10">glossaries </span>is
- loading). To restore the warnings, use <a
-href="#styopt.noredefwarn"><span
-class="cmss-10">noredefwarn</span></a><span
-class="cmss-10">=false</span><a
- id="dx1-3009"></a>. Note that this
- won&#8217;t have any effect if the <span
-class="cmss-10">glossaries </span>package has already been loaded
- before you use the <span
-class="cmss-10">glossaries-extra </span>package.
- </li>
- <li class="itemize">If <span
-class="cmss-10">babel</span><a
- id="dx1-3010"></a> has been loaded, the <a
-href="#styopt.translate"><span
-class="cmss-10">translate</span></a><span
-class="cmss-10">=babel</span><a
- id="dx1-3011"></a> option is switched on. To
- revert to using the <span
-class="cmss-10">translator</span><a
- id="dx1-3012"></a> interface, use <a
-href="#styopt.translate"><span
-class="cmss-10">translate</span></a><span
-class="cmss-10">=true</span><a
- id="dx1-3013"></a>. There is no
- change to the default if <span
-class="cmss-10">babel</span><a
- id="dx1-3014"></a> hasn&#8217;t been loaded.
-
-
-
- </li>
- <li class="itemize">The default style used by <span
-class="cmtt-10">\newacronym</span><a
- id="dx1-3015"></a> is <a
-href="#abbrstyle.short-nolong"><span
-class="cmss-10">short-nolong</span></a><a
- id="dx1-3016"></a>. (That is, the long
- form is not shown on <a
- id="dx1-3017"></a><a
-href="#glo:firstuse">first use</a>.)
- </li></ul>
-<!--l. 378--><p class="indent" > The examples below illustrate the difference in explicit package options between
-<span
-class="cmss-10">glossaries </span>and <span
-class="cmss-10">glossaries-extra</span>. There may be other differences resulting from
-modifications to commands provided by <span
-class="cmss-10">glossaries </span>(see <a
-href="#sec:modifications"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2</span>
-</a><a
-href="#sec:modifications">Modifications to Existing Commands and Styles<!--tex4ht:ref: sec:modifications --></a>).
-</p><!--l. 384--><p class="indent" >
- </p><ol class="enumerate1" >
- <li
- class="enumerate" id="x1-3019x1">Basic defaults:
-
-
-
- <pre class="verbatim" id="verbatim-1">
- \documentclass{article}
- \usepackage{glossaries-extra}
-</pre>
- <!--l. 389--><p class="nopar" > This is like:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-2">
- \documentclass{article}
- \usepackage[toc,nopostdot]{glossaries}
- \usepackage{glossaries-extra}
-</pre>
- <!--l. 395--><p class="nopar" >
- </p></li>
- <li
- class="enumerate" id="x1-3021x2">Language defaults:
-
-
-
- <pre class="verbatim" id="verbatim-3">
- \documentclass[british]{article}
- \usepackage{babel}
- \usepackage{glossaries-extra}
-</pre>
- <!--l. 402--><p class="nopar" > This is like:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-4">
- \documentclass[british]{article}
- \usepackage{babel}
- \usepackage[toc,nopostdot,translate=babel]{glossaries}
- \usepackage{glossaries-extra}
-</pre>
- <!--l. 409--><p class="nopar" >
- </p></li>
- <li
- class="enumerate" id="x1-3023x3">Combined with <span
-class="cmss-10">memoir</span><a
- id="dx1-3024"></a>
-
-
-
- <pre class="verbatim" id="verbatim-5">
- \documentclass{memoir}
- \usepackage{glossaries-extra}
-</pre>
- <!--l. 415--><p class="nopar" > This is like:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-6">
- \documentclass{memoir}
- \usepackage[toc,nopostdot,noredefwarn]{glossaries}
- \usepackage{glossaries-extra}
-</pre>
- <!--l. 421--><p class="nopar" > <span
-class="cmti-10">However</span>
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-7">
- \documentclass{memoir}
- \usepackage{glossaries}
- \usepackage{glossaries-extra}
-</pre>
- <!--l. 427--><p class="nopar" > This is like:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-8">
- \documentclass{memoir}
- \usepackage[toc,nopostdot]{glossaries}
- \usepackage{glossaries-extra}
-</pre>
- <!--l. 433--><p class="nopar" > Since by the time <span
-class="cmss-10">glossaries-extra </span>has been loaded, <span
-class="cmss-10">glossaries </span>has already
- redefined <span
-class="cmss-10">memoir</span><a
- id="dx1-3025"></a>&#8217;s glossary-related commands.
- </p></li>
- <li
- class="enumerate" id="x1-3027x4">Abbreviations are defined with <span
-class="cmtt-10">\newabbreviation</span>:
-
-
-
- <pre class="verbatim" id="verbatim-9">
- \usepackage{glossaries-extra}
- \newabbreviation{svm}{SVM}{support&#x00A0;vector&#x00A0;machine}
- \begin{document}
- First&#x00A0;use:&#x00A0;\gls{svm}.&#x00A0;Explicit&#x00A0;full&#x00A0;form:&#x00A0;\glsxtrfull{svm}.
- \end{document}
-</pre>
- <!--l. 445--><p class="nopar" > This is the closest to:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-10">
- \usepackage{glossaries}
- \newacronym{svm}{SVM}{support&#x00A0;vector&#x00A0;machine}
- \begin{document}
- First&#x00A0;use:&#x00A0;\gls{svm}.&#x00A0;Explicit&#x00A0;full&#x00A0;form:&#x00A0;\acrfull{svm}.
- \end{document}
-</pre>
- <!--l. 453--><p class="nopar" > If you want to continue using <span
-class="cmtt-10">\newacronym </span>then you will need to change the
- style for the <span
-class="cmss-10">acronym</span><a
- id="dx1-3028"></a> category:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-11">
- \usepackage{glossaries-extra}
- \setabbreviationstyle[acronym]{long-short}
- \newacronym{svm}{SVM}{support&#x00A0;vector&#x00A0;machine}
- \begin{document}
- First&#x00A0;use:&#x00A0;\gls{svm}.&#x00A0;Explicit&#x00A0;full&#x00A0;form:&#x00A0;\glsxtrfull{svm}.
- \end{document}
-</pre>
- <!--l. 463--><p class="nopar" ></p></li></ol>
-<!--l. 466--><p class="indent" > Another noticeable change is that by default <span
-class="cmtt-10">\printglossary </span>will now display
-information text in the document if the external glossary file doesn&#8217;t exist. This is
-explanatory text to help new users who can&#8217;t work out what to do next to complete
-the document build. Once the document is set up correctly and the external files have
-been generated, this text will disappear.
-</p><!--l. 473--><p class="indent" > This change is mostly likely to be noticed by users with one or more
-redundant empty glossaries who ignore transcript messages, explicitly use
-<a
- id="dx1-3029"></a><a
-href="#glo:makeindex"><span
-class="cmtt-10">makeindex</span></a>/<a
- id="dx1-3030"></a><a
-href="#glo:xindy"><span
-class="cmtt-10">xindy</span></a> on just the non-empty glossary (or glossaries) and use the iterative
-<span
-class="cmtt-10">\printglossaries</span><a
- id="dx1-3031"></a> command instead of <span
-class="cmtt-10">\printglossary</span><a
- id="dx1-3032"></a>. For example, consider the
-following:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-12">
-\documentclass{article}
-\usepackage[acronym]{glossaries}
-\makeglossaries
-\newacronym{laser}{laser}{light&#x00A0;amplification&#x00A0;by&#x00A0;stimulated
-emission&#x00A0;of&#x00A0;radiation}
-\begin{document}
-\gls{laser}
-\printglossaries
-\end{document}
-</pre>
-<!--l. 497--><p class="nopar" > The above document will only display the list of acronyms at the place where
-<span
-class="cmtt-10">\printglossaries</span><a
- id="dx1-3033"></a> occurs. However it will also attempt to input the <span
-class="cmtt-10">.gls </span>file
-associated with the <span
-class="cmtt-10">main </span>glossary.
-</p><!--l. 503--><p class="indent" > If you use <a
- id="dx1-3034"></a><a
-href="#glo:makeglossaries"><span
-class="cmtt-10">makeglossaries</span></a>, you&#8217;ll get the warning message:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-13">
-Warning:&#x00A0;File&#x00A0;'test.glo'&#x00A0;is&#x00A0;empty.
-Have&#x00A0;you&#x00A0;used&#x00A0;any&#x00A0;entries&#x00A0;defined&#x00A0;in&#x00A0;glossary&#x00A0;'main'?
-Remember&#x00A0;to&#x00A0;use&#x00A0;package&#x00A0;option&#x00A0;'nomain'&#x00A0;if&#x00A0;you
-don't&#x00A0;want&#x00A0;to&#x00A0;use&#x00A0;the&#x00A0;main&#x00A0;glossary.
-</pre>
-<!--l. 509--><p class="nopar" > (where the original file is called <span
-class="cmtt-10">test.tex</span>) but if you simply call <a
- id="dx1-3035"></a><a
-href="#glo:makeindex"><span
-class="cmtt-10">makeindex</span></a> directly
-to generate the <span
-class="cmtt-10">.acr </span>file (without attempting to create the <span
-class="cmtt-10">.gls </span>file) then the
-transcript file will always contain the message:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-14">
-No&#x00A0;file&#x00A0;test.gls.
-</pre>
-<!--l. 516--><p class="nopar" > This doesn&#8217;t occur with <a
- id="dx1-3036"></a><a
-href="#glo:makeglossaries"><span
-class="cmtt-10">makeglossaries</span></a> as it will create the <span
-class="cmtt-10">.gls </span>file containing
-the single command <span
-class="cmtt-10">\null</span>.
-</p><!--l. 520--><p class="indent" > If you simply change from <span
-class="cmss-10">glossaries </span>to <span
-class="cmss-10">glossaries-extra </span>in this document, you&#8217;ll
-find a change in the resulting PDF if you don&#8217;t use <a
- id="dx1-3037"></a><span
-class="cmtt-10">makeglossaries </span>and you only
-generate the <span
-class="cmtt-10">.acr </span>file with <a
- id="dx1-3038"></a><a
-href="#glo:makeindex"><span
-class="cmtt-10">makeindex</span></a>.
-</p><!--l. 525--><p class="indent" > The transcript file will still contain the message about the missing <span
-class="cmtt-10">.gls</span>, but now
-you&#8217;ll also see information in the actual PDF document. The simplest remedy is to
-follow the advice inserted into the document at that point, which is to add the
-<a
-href="#styopt.nomain"><span
-class="cmss-10">nomain</span></a><a
- id="dx1-3039"></a> package option:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-15">
-\documentclass{article}
-\usepackage[nomain,acronym,postdot]{glossaries-extra}
-\makeglossaries
-\setabbreviationstyle[acronym]{long-short}
-\newacronym{laser}{laser}{light&#x00A0;amplification&#x00A0;by&#x00A0;stimulated
-emission&#x00A0;of&#x00A0;radiation}
-\begin{document}
-\gls{laser}
-\printglossaries
-\end{document}
-</pre>
-<!--l. 549--><p class="nopar" > (Note the need to set the acronym style using <span
-class="cmtt-10">\setabbreviationstyle</span>
-before <span
-class="cmtt-10">\newacronym</span>. See <a
-href="#sec:abbreviations"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">4</span> </a><a
-href="#sec:abbreviations">Abbreviations<!--tex4ht:ref: sec:abbreviations --></a> for further
-details.)
-</p><!--l. 554--><p class="noindent" >
-</p>
-<!--l. 554--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">1.2 </span> <a
- id="sec:pkgopts"></a>New or Modified Package Options</h3>
-<!--l. 557--><p class="noindent" >If you haven&#8217;t already loaded <span
-class="cmss-10">glossaries</span>, you can use any of the package options
-provided by <span
-class="cmss-10">glossaries </span>when you load <span
-class="cmss-10">glossaries-extra </span>and they will automatically be
-passed to <span
-class="cmss-10">glossaries </span>(which <span
-class="cmss-10">glossaries-extra </span>will load). If <span
-class="cmss-10">glossaries </span>has already
-been loaded, then those options will be passed to <span
-class="cmtt-10">\setupglossaries</span><a
- id="dx1-4001"></a>, but
-remember that not all of the <span
-class="cmss-10">glossaries </span>package options may be used in that
-command.
-</p><!--l. 565--><p class="indent" > <div class="important" title="Important Note"> This section only lists options that are either unrecognised by the <span
-class="cmss-10">glossaries</span>
-package or are a modified version of options of the same name provided by <span
-class="cmss-10">glossaries</span>.
-See the <span
-class="cmss-10">glossaries </span>user manual for details about the unmodified options.
-</div>
-</p><!--l. 571--><p class="noindent" >
-</p><!--l. 573--><p class="indent" > The new and modified options provided by <span
-class="cmss-10">glossaries-extra </span>are described
-below:
-
-
-
- </p><dl class="description"><dt class="description">
-<a
- id="styopt.debug"></a><span
-class="cmssbx-10">debug</span><a
- id="dx1-4002"></a> </dt><dd
-class="description">The <span
-class="cmss-10">glossaries </span>package has a <span
-class="cmss-10">debug </span>option that allows the values <span
-class="cmss-10">false</span>,
- <span
-class="cmss-10">true </span>and <span
-class="cmss-10">showtargets</span>. The <a
-href="#styopt.debug"><span
-class="cmss-10">debug</span></a><span
-class="cmss-10">=showtargets</span><a
- id="dx1-4003"></a> option was introduced to
- <span
-class="cmss-10">glossaries </span>v4.32, so if you want to use this option with <span
-class="cmss-10">glossaries-extra </span>you
- must make sure that your version of <span
-class="cmss-10">glossaries </span>supports it.
- <!--l. 586--><p class="noindent" >The <span
-class="cmss-10">glossaries-extra </span>package extends this option to provide the additional
- values <a
-href="#styopt.debug"><span
-class="cmss-10">debug</span></a><span
-class="cmss-10">=showwrgloss</span><a
- id="dx1-4004"></a> and <a
-href="#styopt.debug"><span
-class="cmss-10">debug</span></a><span
-class="cmss-10">=all</span><a
- id="dx1-4005"></a>.
- </p><!--l. 590--><p class="noindent" >The <a
-href="#styopt.debug"><span
-class="cmss-10">debug</span></a><span
-class="cmss-10">=showwrgloss</span><a
- id="dx1-4006"></a> option implements <a
-href="#styopt.debug"><span
-class="cmss-10">debug</span></a><span
-class="cmss-10">=true</span><a
- id="dx1-4007"></a> and uses
- </p><!--l. 592--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-4008"></a> <span
-class="cmtt-10">\glsxtrwrglossmark </span></div><hr>
- </p><!--l. 594--><p class="noindent" >
- to show a mark <span
-class="cmsy-10">&#x22C5; </span>just before the write operation performed by the
- indexing commands. If you use <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=hybrid</span><a
- id="dx1-4009"></a> there will be a mark
- for the write operation to the <span
-class="cmtt-10">.aux </span>file for <a
- id="dx1-4010"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> and a mark for
- the write operation to the associated glossary file for <a
- id="dx1-4011"></a><a
-href="#glo:makeindex"><span
-class="cmtt-10">makeindex</span></a> or
- <a
- id="dx1-4012"></a><a
-href="#glo:xindy"><span
-class="cmtt-10">xindy</span></a>.
- </p><!--l. 602--><p class="noindent" >The <a
-href="#styopt.debug"><span
-class="cmss-10">debug</span></a><span
-class="cmss-10">=all</span><a
- id="dx1-4013"></a> option implements both <a
-href="#styopt.debug"><span
-class="cmss-10">debug</span></a><span
-class="cmss-10">=showtargets</span><a
- id="dx1-4014"></a> and
- <a
-href="#styopt.debug"><span
-class="cmss-10">debug</span></a><span
-class="cmss-10">=showwrgloss</span><a
- id="dx1-4015"></a>.
- </p></dd><dt class="description">
-<a
- id="styopt.showtargets"></a><span
-class="cmssbx-10">showtargets</span><a
- id="dx1-4016"></a> </dt><dd
-class="description">This implements <a
-href="#styopt.debug"><span
-class="cmss-10">debug</span></a><span
-class="cmss-10">=showtargets</span><a
- id="dx1-4017"></a> and can also adjust the way the
- targets are shown. By default, any links that occur in TeX&#8217;s &#8220;outer&#8221; mode are
- placed in the margin according to <span
-class="cmtt-10">\glsshowtargetouter</span><a
- id="dx1-4018"></a> (provided by the base
- <span
-class="cmss-10">glossaries </span>package). This can lead to the &#8220;too many floats&#8221; error if there are
- multiple instances of commands like <span
-class="cmtt-10">\gls </span>in a single line. This option
- provides a way of changing this to an in-line annotation. Available
- values:
- <dl class="description"><dt class="description">
- <span
-class="cmssbx-10">left</span> </dt><dd
-class="description">A marker is placed to the left of the link/target and a marginal note
- is used in outer mode;
- </dd><dt class="description">
- <span
-class="cmssbx-10">right</span> </dt><dd
-class="description">A marker is placed to the right of the link/target and a marginal
- note is used in outer mode;
- </dd><dt class="description">
- <span
-class="cmssbx-10">innerleft</span> </dt><dd
-class="description">A marker and annotation are placed to the left of the link/target
- in all modes;
- </dd><dt class="description">
- <span
-class="cmssbx-10">innerright</span> </dt><dd
-class="description">A marker and annotation are placed to the right of the
- link/target in all modes;
- </dd><dt class="description">
- <span
-class="cmssbx-10">annoteleft</span> </dt><dd
-class="description">Markers are placed on either side of the link/target and the
- annotation is on the left;
-
-
-
- </dd><dt class="description">
- <span
-class="cmssbx-10">annoteright</span> </dt><dd
-class="description">Markers are placed on either side of the link/target and the
- annotation is on the right.</dd></dl>
- </dd><dt class="description">
-<a
- id="styopt.postdot"></a><span
-class="cmssbx-10">postdot</span><a
- id="dx1-4019"></a> </dt><dd
-class="description">(New to version 1.12.) This option is just a shortcut for <a
-href="#styopt.nopostdot"><span
-class="cmss-10">nopostdot</span></a><span
-class="cmss-10">=false</span><a
- id="dx1-4020"></a>.
- </dd><dt class="description">
-<a
- id="styopt.postpunc"></a><span
-class="cmssbx-10">postpunc</span><a
- id="dx1-4021"></a> </dt><dd
-class="description">(New to version 1.21.) This option sets the post-description punctuation to
- the given value. For example: <span
-class="cmss-10">postpunc=; </span>does
-
-
-
- <pre class="verbatim" id="verbatim-16">
- \renewcommand{\glspostdescription}{;}
-</pre>
- <!--l. 636--><p class="nopar" > The value may also be one of the following keywords:
- </p><dl class="description"><dt class="description">
- <span
-class="cmtt-10">comma</span><span
-class="cmbx-10">:</span> </dt><dd
-class="description"><a
-href="#styopt.postpunc"><span
-class="cmss-10">postpunc</span></a><span
-class="cmss-10">=comma</span><a
- id="dx1-4022"></a> is equivalent to
-
-
-
- <pre class="verbatim" id="verbatim-17">
- \renewcommand{\glspostdescription}{,}
-</pre>
- <!--l. 643--><p class="nopar" >
- </p></dd><dt class="description">
- <span
-class="cmtt-10">dot</span><span
-class="cmbx-10">:</span> </dt><dd
-class="description"><a
-href="#styopt.postpunc"><span
-class="cmss-10">postpunc</span></a><span
-class="cmss-10">=dot</span><a
- id="dx1-4023"></a> is equivalent to
-
-
-
- <pre class="verbatim" id="verbatim-18">
- \renewcommand{\glspostdescription}{.\spacefactor\sfcode`\.&#x00A0;}
-</pre>
- <!--l. 649--><p class="nopar" >
- </p></dd><dt class="description">
- <span
-class="cmtt-10">none</span><span
-class="cmbx-10">:</span> </dt><dd
-class="description"><a
-href="#styopt.postpunc"><span
-class="cmss-10">postpunc</span></a><span
-class="cmss-10">=none</span><a
- id="dx1-4024"></a> is equivalent to
-
-
-
- <pre class="verbatim" id="verbatim-19">
- \renewcommand{\glspostdescription}{}
-</pre>
- <!--l. 655--><p class="nopar" ></p></dd></dl>
- <!--l. 657--><p class="noindent" >The default definition is
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-20">
- \newcommand*{\glspostdescription}{%
- &#x00A0;&#x00A0;\ifglsnopostdot\else.\spacefactor\sfcode`\.&#x00A0;\fi
- }
-</pre>
- <!--l. 662--><p class="nopar" > where the conditional is determined by the <a
-href="#styopt.nopostdot"><span
-class="cmss-10">nopostdot</span></a><a
- id="dx1-4025"></a> package option.
- The <a
-href="#styopt.postpunc"><span
-class="cmss-10">postpunc</span></a><a
- id="dx1-4026"></a> option removes the conditional from the definition of
- <span
-class="cmtt-10">\glspostdescription</span>. The package options <a
-href="#styopt.nopostdot"><span
-class="cmss-10">nopostdot</span></a><a
- id="dx1-4027"></a> and <a
-href="#styopt.postdot"><span
-class="cmss-10">postdot</span></a><a
- id="dx1-4028"></a> will restore
- the original definition of <span
-class="cmtt-10">\glspostdescription</span>.
- </p><!--l. 669--><p class="noindent" >The <span
-class="cmss-10">glossaries-extra-stylemods</span><a
- id="dx1-4029"></a> package adjusts the predefined styles
- that had a hard-coded <span
-class="cmtt-10">\space </span>before the <a
- id="dx1-4030"></a><a
-href="#glo:numberlist">number list</a> so that they use
- <span
-class="cmtt-10">\glsxtrprelocation </span>instead (which is defined to <span
-class="cmtt-10">\space</span>). You can therefore
- redefine this command in combination with <a
-href="#styopt.postpunc"><span
-class="cmss-10">postpunc</span></a><a
- id="dx1-4031"></a> to alter the separator
- before the <a
- id="dx1-4032"></a>number list. For example, to have a comma followed by
- <span
-class="cmtt-10">\hfil</span>:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-21">
- \usepackage[postpunc=comma,stylemods]{glossaries-extra}
- \renewcommand{\glsxtrprelocation}{\hfil}
-</pre>
- <!--l. 679--><p class="nopar" > Be careful with doing this as it will look odd if the <a
- id="dx1-4033"></a><a
-href="#glo:numberlist">number list</a> is missing.
- (With <a
- id="dx1-4034"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> you can instead redefine <span
-class="cmtt-10">\glsxtrprelocation </span>to do nothing
- and set the location prefixes with <span
-class="cmtt-10">loc-prefix </span>which will only apply if the entry
- has a <a
- id="dx1-4035"></a>number list.)
- </p></dd><dt class="description">
-<a
- id="styopt.prefix"></a><span
-class="cmssbx-10">prefix</span><a
- id="dx1-4036"></a> </dt><dd
-class="description">Load the <span
-class="cmss-10">glossaries-prefix</span><a
- id="dx1-4037"></a> package (if not already loaded).
- </dd><dt class="description">
-<a
- id="styopt.accsupp"></a><span
-class="cmssbx-10">accsupp</span><a
- id="dx1-4038"></a> </dt><dd
-class="description">Load the <span
-class="cmss-10">glossaries-accsupp</span><a
- id="dx1-4039"></a> package (if not already loaded).
- <!--l. 692--><p class="noindent" ><div class="important" title="Important Note"> The <span
-class="cmss-10">glossaries-accsupp</span><a
- id="dx1-4040"></a> package is still experimental and so accessibility features
- are liable to change. </div>
- </p><!--l. 695--><p class="noindent" >
- </p><!--l. 697--><p class="noindent" >If you want to define styles that can interface with the accessibility support
- provided by <span
-class="cmss-10">glossaries-accsupp</span><a
- id="dx1-4041"></a> use the <span
-class="cmtt-10">\glsaccess</span>&#x27E8;<span
-class="cmitt-10">xxx</span>&#x27E9; type of commands
- instead of <span
-class="cmtt-10">\glsentry</span>&#x27E8;<span
-class="cmitt-10">xxx</span>&#x27E9; (for example, <span
-class="cmtt-10">\glsaccesstext</span><a
- id="dx1-4042"></a> instead of
- <span
-class="cmtt-10">\glsentrytext</span><a
- id="dx1-4043"></a>). If <span
-class="cmss-10">glossaries-accsupp</span><a
- id="dx1-4044"></a> hasn&#8217;t been loaded those commands are
- equivalent (for example, <span
-class="cmtt-10">\glsaccesstext </span>just does <span
-class="cmtt-10">\glsentrytext</span>) but if it
- has been loaded, then the <span
-class="cmtt-10">\glsaccess</span>&#x27E8;<span
-class="cmitt-10">xxx</span>&#x27E9; commands will add the accessibility
- information. (See <a
-href="#sec:accsupp"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">13.2</span> </a><a
-href="#sec:accsupp">Accessibility Support<!--tex4ht:ref: sec:accsupp --></a> for further
- details.)
- </p><!--l. 707--><p class="noindent" >Note that the <a
-href="#styopt.accsupp"><span
-class="cmss-10">accsupp</span></a><a
- id="dx1-4045"></a> option can only be used as a&#x00A0;package option (and can&#8217;t
- be set with <span
-class="cmtt-10">\glossariesextrasetup</span><a
- id="dx1-4046"></a>) since the <span
-class="cmss-10">glossaries-accsupp</span><a
- id="dx1-4047"></a> package must
- be loaded before <span
-class="cmss-10">glossaries-extra </span>if it&#8217;s required.
- </p></dd><dt class="description">
-<a
- id="styopt.stylemods"></a><span
-class="cmssbx-10">stylemods</span><a
- id="dx1-4048"></a> </dt><dd
-class="description">This is a &#x27E8;<span
-class="cmti-10">key</span>&#x27E9;=&#x27E8;<span
-class="cmti-10">value</span>&#x27E9; option used to load the <span
-class="cmss-10">glossaries-extra-stylemods</span><a
- id="dx1-4049"></a>
- package. The value may be a comma-separated list of options to pass to that
- package. (Remember to group &#x27E8;<span
-class="cmti-10">value</span>&#x27E9; if it contains any commas.) The value may
- be omitted if no options need to be passed. See <a
-href="#sec:glosstylemods"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.11</span> </a><a
-href="#sec:glosstylemods">Glossary
- Style Modifications<!--tex4ht:ref: sec:glosstylemods --></a> for further details. There are two special keyword values:
- <a
-href="#styopt.stylemods"><span
-class="cmss-10">stylemods</span></a><span
-class="cmss-10">=default</span><a
- id="dx1-4050"></a> (equivalent to omitting the value) and <a
-href="#styopt.stylemods"><span
-class="cmss-10">stylemods</span></a><span
-class="cmss-10">=all</span><a
- id="dx1-4051"></a>, which
- loads all the predefined styles.
- </dd><dt class="description">
-<a
- id="styopt.undefaction"></a><span
-class="cmssbx-10">undefaction</span><a
- id="dx1-4052"></a> </dt><dd
-class="description">This is a &#x27E8;<span
-class="cmti-10">key</span>&#x27E9;=&#x27E8;<span
-class="cmti-10">value</span>&#x27E9; option, which has two allowed values: <span
-class="cmss-10">warn </span>and
-
-
-
- <span
-class="cmss-10">error</span>. This indicates what to do if an undefined glossary entry is referenced. The
- default behaviour is <a
-href="#styopt.undefaction"><span
-class="cmss-10">undefaction</span></a><span
-class="cmss-10">=error</span><a
- id="dx1-4053"></a>, which produces an error message (the
- default for <span
-class="cmss-10">glossaries</span>). You can switch this to a warning message (and ??
- appearing in the text) with <a
-href="#styopt.undefaction"><span
-class="cmss-10">undefaction</span></a><span
-class="cmss-10">=warn</span><a
- id="dx1-4054"></a>.
- <!--l. 732--><p class="noindent" ><div class="important" title="Important Note"> Undefined entries can&#8217;t be picked up by any commands that iterate
- over a glossary list. This includes <span
-class="cmtt-10">\forglsentries</span><a
- id="dx1-4055"></a> and <span
-class="cmtt-10">\glsaddall</span><a
- id="dx1-4056"></a>.
- </div>
- </p><!--l. 736--><p class="noindent" >
- </p><!--l. 738--><p class="noindent" >Note that <span
-class="cmtt-10">\ifglsused</span><a
- id="dx1-4057"></a> will display ?? in the document text with <a
-href="#styopt.undefaction"><span
-class="cmss-10">undefaction</span></a><span
-class="cmss-10">=warn</span><a
- id="dx1-4058"></a>
- if the entry hasn&#8217;t been defined, as the underlying boolean variable
- doesn&#8217;t exist and so is neither true nor false. (There will also be a
- warning in the transcript.) See <a
-href="#sec:glsunset"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.6</span> </a><a
-href="#sec:glsunset">First Use Flag<!--tex4ht:ref: sec:glsunset --></a> for further
- details.
- </p></dd><dt class="description">
-<a
- id="styopt.indexcrossrefs"></a><span
-class="cmssbx-10">indexcrossrefs</span><a
- id="dx1-4059"></a> </dt><dd
-class="description">This is a boolean option. If <span
-class="cmss-10">true</span>, this will automatically index any
- cross-referenced entries that haven&#8217;t been marked as used at the end of the
- document. Note that this necessarily adds to the overall document build time,
- especially if you have defined a large number of entries, so this defaults to <span
-class="cmss-10">false</span>,
- but it will be automatically switched on if you use the <span
-class="cmss-10">see</span><a
- id="dx1-4060"></a> or <span
-class="cmss-10">seealso</span><a
- id="dx1-4061"></a> keys
- in any entries (unless <a
-href="#styopt.autoseeindex"><span
-class="cmss-10">autoseeindex</span></a><span
-class="cmss-10">=false</span><a
- id="dx1-4062"></a>). To force it off, even if you
- use the <span
-class="cmss-10">see</span><a
- id="dx1-4063"></a> or <span
-class="cmss-10">seealso</span><a
- id="dx1-4064"></a> key, you need to explicitly set <a
-href="#styopt.indexcrossrefs"><span
-class="cmss-10">indexcrossrefs</span></a><a
- id="dx1-4065"></a> to
- <span
-class="cmss-10">false</span>.
- <!--l. 756--><p class="noindent" >Note that <a
- id="dx1-4066"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> can automatically find dependent entries when it
- parses the <span
-class="cmtt-10">.bib </span>source file. The <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><a
- id="dx1-4067"></a> option automatically implements
- <a
-href="#styopt.indexcrossrefs"><span
-class="cmss-10">indexcrossrefs</span></a><span
-class="cmss-10">=false</span><a
- id="dx1-4068"></a>.
- </p></dd><dt class="description">
-<a
- id="styopt.autoseeindex"></a><span
-class="cmssbx-10">autoseeindex</span><a
- id="dx1-4069"></a> </dt><dd
-class="description"> (New to v1.16.) This is a boolean option. If true (default), this makes
- the <span
-class="cmss-10">see</span><a
- id="dx1-4070"></a> and <span
-class="cmss-10">seealso</span><a
- id="dx1-4071"></a> keys automatically index the cross-reference when an entry
- is defined. If false, the value of those keys will still be stored in their
- corresponding fields (and can be accessed using commands like <span
-class="cmtt-10">\glsxtrusesee</span>
- and <span
-class="cmtt-10">\glsxtruseseealso</span>) but cross-reference won&#8217;t be automatically
- indexed.
- <!--l. 770--><p class="noindent" >Note that the <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=only</span><a
- id="dx1-4072"></a> option automatically implements <a
-href="#styopt.autoseeindex"><span
-class="cmss-10">autoseeindex</span></a><span
-class="cmss-10">=false</span><a
- id="dx1-4073"></a>.
- </p><!--l. 773--><p class="noindent" >For example, if an entry is defined as
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-22">
- \newglossaryentry{foo}{name={foo},description={},see={bar,baz}}
-</pre>
- <!--l. 776--><p class="nopar" > then with <span
-class="cmtt-10">autoseeindex=true</span>, this is equivalent to
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-23">
- \newglossaryentry{foo}{name={foo},description={}}
- \glssee{foo}{bar,baz}
- \glossariesextrasetup{indexcrossrefs=true}
- \GlsXtrSetField{foo}{see}{bar,baz}
-</pre>
- <!--l. 783--><p class="nopar" > but with <span
-class="cmtt-10">autoseeindex=false</span>, this is equivalent to
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-24">
- \newglossaryentry{foo}{name={foo},description={}}
- \GlsXtrSetField{foo}{see}{bar,baz}
-</pre>
- <!--l. 788--><p class="nopar" > Note that <a
-href="#styopt.indexcrossrefs"><span
-class="cmss-10">indexcrossrefs</span></a><a
- id="dx1-4074"></a> isn&#8217;t automatically implemented by the presence of the
- <span
-class="cmss-10">see</span><a
- id="dx1-4075"></a> key when <a
-href="#styopt.autoseeindex"><span
-class="cmss-10">autoseeindex</span></a><a
- id="dx1-4076"></a> is false.
- </p><!--l. 793--><p class="noindent" >It&#8217;s therefore possible to remove the cross-references from the location lists and
- set their position within the glossary style.
- </p><!--l. 796--><p class="noindent" >Another method of preventing the automatic indexing is to define the entries
- before the external indexing files have been opened with <span
-class="cmtt-10">\makeglossaries</span>.
- Since the appropriate file isn&#8217;t open, the information can&#8217;t be written to it.
- This will need the package option <span
-class="cmss-10">seenoindex=ignore </span>(provided by <span
-class="cmss-10">glossaries</span>) to
- prevent an error occurring.
- </p></dd><dt class="description">
-<a
- id="styopt.record"></a><span
-class="cmssbx-10">record</span><a
- id="dx1-4077"></a> </dt><dd
-class="description">(New to v1.08.) This is a &#x27E8;<span
-class="cmti-10">key</span>&#x27E9;=&#x27E8;<span
-class="cmti-10">value</span>&#x27E9; option provided for the benefit of
- <a
- id="dx1-4078"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> (see <a
-href="#sec:bib2gls"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">10</span> </a><a
-href="#sec:bib2gls">bib2gls: Managing Reference Databases<!--tex4ht:ref: sec:bib2gls --></a>). If you
- want to use <a
- id="dx1-4079"></a><span
-class="cmtt-10">bib2gls</span>, the recommended setting is <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=nameref</span><a
- id="dx1-4080"></a> if you have
- hyperlinks and <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=only</span><a
- id="dx1-4081"></a> if you don&#8217;t have hyperlinks.
- <!--l. 809--><p class="noindent" >The option may only be set in the preamble and can&#8217;t be used after
- <span
-class="cmtt-10">\GlsXtrLoadResources</span>. If the value is missing <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=only</span><a
- id="dx1-4082"></a> is assumed.
- Permitted values:
- </p><dl class="description"><dt class="description">
- <span
-class="cmssbx-10">off</span> </dt><dd
-class="description">This is the default setting. The indexing is performed as normal using
- either <span
-class="cmtt-10">\makeglossaries </span>or <span
-class="cmtt-10">\makenoidxglossaries</span>. This setting
- implements <a
-href="#styopt.undefaction"><span
-class="cmss-10">undefaction</span></a><span
-class="cmss-10">=error</span><a
- id="dx1-4083"></a>.
- </dd><dt class="description">
- <span
-class="cmssbx-10">only</span> </dt><dd
-class="description">The indexing (recording) is performed by
- <a
- id="dx1-4084"></a><span
-class="cmtt-10">bib2gls </span>(see <a
-href="#sec:bib2gls"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">10</span> </a><a
-href="#sec:bib2gls">bib2gls: Managing Reference Databases<!--tex4ht:ref: sec:bib2gls --></a>).
- Neither <span
-class="cmtt-10">\makeglossaries </span>nor <span
-class="cmtt-10">\makenoidxglossaries </span>is permitted.
- This setting implements <a
-href="#styopt.undefaction"><span
-class="cmss-10">undefaction</span></a><span
-class="cmss-10">=warn</span><a
- id="dx1-4085"></a> and automatically loads
- the supplementary <span
-class="cmss-10">glossaries-extra-bib2gls</span><a
- id="dx1-4086"></a> package. (There should be
- no need to explicitly load <span
-class="cmss-10">glossaries-extra-bib2gls</span><a
- id="dx1-4087"></a>.)
- <!--l. 824--><p class="noindent" >The glossaries should be displayed using <span
-class="cmtt-10">\printunsrtglossary </span>(or
- <span
-class="cmtt-10">\printunsrtglossaries</span>).
- </p><!--l. 827--><p class="noindent" >The document build process is (assuming the file is called <span
-class="cmtt-10">myDoc.tex</span>):
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-25">
- pdflatex&#x00A0;myDoc
- bib2gls&#x00A0;myDoc
- pdflatex&#x00A0;myDoc
-</pre>
- <!--l. 833--><p class="nopar" > If you want letter groups you will need the <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">--group</span></span></span> or <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">-g</span></span></span> switch when
- invoking <a
- id="dx1-4088"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a>:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-26">
- pdflatex&#x00A0;myDoc
- bib2gls&#x00A0;-g&#x00A0;myDoc
- pdflatex&#x00A0;myDoc
-</pre>
- <!--l. 840--><p class="nopar" >
- </p><!--l. 842--><p class="noindent" >Note that <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=only</span><a
- id="dx1-4089"></a> will prevent the <span
-class="cmss-10">see</span><a
- id="dx1-4090"></a> from automatically
- implementing <span
-class="cmtt-10">\glssee</span>. (<a
- id="dx1-4091"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> deals with the <span
-class="cmss-10">see</span><a
- id="dx1-4092"></a> field.) You
- may explicitly use <span
-class="cmtt-10">\glssee </span>in the document, but <a
- id="dx1-4093"></a><span
-class="cmtt-10">bib2gls </span>will
- ignore the cross-reference if the <span
-class="cmss-10">see</span><a
- id="dx1-4094"></a> field was already set for that
- entry.
- </p><!--l. 848--><p class="noindent" >The <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=only</span><a
- id="dx1-4095"></a> option will automatically set the <span
-class="cmss-10">glossaries </span>package&#8217;s
- <a
-href="#styopt.sort"><span
-class="cmss-10">sort</span></a><span
-class="cmss-10">=none</span><a
- id="dx1-4096"></a> option if available. (That option value was only introduced to
- <span
-class="cmss-10">glossaries </span>v4.30.)
- </p></dd><dt class="description">
- <span
-class="cmssbx-10">nameref</span> </dt><dd
-class="description">(New to v1.37 and requires <a
- id="dx1-4097"></a><span
-class="cmtt-10">bib2gls </span>v1.8+.) This option is like
- <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=only</span><a
- id="dx1-4098"></a> but additionally records the current label information given by
- <span
-class="cmtt-10">\@currentlabel </span>and <span
-class="cmtt-10">\@currentHref</span>, and provides a more reliable way of
- saving the <span
-class="cmtt-10">\theH</span>&#x27E8;<span
-class="cmti-10">counter</span>&#x27E9; for the given location. This option requires
- <span
-class="cmss-10">hyperref</span><a
- id="dx1-4099"></a> otherwise it will fall back on the usual location records.
- Remember that <span
-class="cmtt-10">\@currentHref </span>is always globally updated whenever
- <span
-class="cmtt-10">\refstepcounter </span>is used, but <span
-class="cmtt-10">\@currentlabel </span>isn&#8217;t. This can cause some
- undesired side-effects with some settings. Remember also that the
- <a
-href="#styopt.indexcounter"><span
-class="cmss-10">indexcounter</span></a><a
- id="dx1-4100"></a> option increments the associated counter every time an entry
- is indexed, which affects this option. See <a
-href="#sec:recordnameref"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">10.3.2</span> </a><a
-href="#sec:recordnameref">Nameref
- Record<!--tex4ht:ref: sec:recordnameref --></a> for further details.
- <!--l. 866--><p class="noindent" >This option is best used with <a
-href="#styopt.counter"><span
-class="cmss-10">counter</span></a><span
-class="cmss-10">=chapter</span><a
- id="dx1-4101"></a> or <a
-href="#styopt.counter"><span
-class="cmss-10">counter</span></a><span
-class="cmss-10">=section</span><a
- id="dx1-4102"></a> if you
- want the title included in the location list. If the indexing counter is the
- default <span
-class="cmss-10">page</span><a
- id="dx1-4103"></a>, only the location number is shown. Similarly for
- <a
-href="#styopt.counter"><span
-class="cmss-10">counter</span></a><span
-class="cmss-10">=equation</span><a
- id="dx1-4104"></a> (or <a
-href="#styopt.equations"><span
-class="cmss-10">equations</span></a><span
-class="cmss-10">=true</span><a
- id="dx1-4105"></a>).
- </p></dd><dt class="description">
- <span
-class="cmssbx-10">alsoindex</span> </dt><dd
-class="description">Deprecated synonym of <span
-class="cmss-10">hybrid</span>.
- </dd><dt class="description">
- <span
-class="cmssbx-10">hybrid</span> </dt><dd
-class="description">This is a hybrid setting that uses <a
- id="dx1-4106"></a><span
-class="cmtt-10">bib2gls </span>to fetch entry information
- from <span
-class="cmtt-10">.bib </span>files, but uses <a
- id="dx1-4107"></a><a
-href="#glo:makeindex"><span
-class="cmtt-10">makeindex</span></a> or <a
- id="dx1-4108"></a><a
-href="#glo:xindy"><span
-class="cmtt-10">xindy</span></a> to create the glossary files
- (which are input with <span
-class="cmtt-10">\printglossary</span><a
- id="dx1-4109"></a>). Note that this requires a slower
- and more complicated build process (see below).
- <!--l. 881--><p class="noindent" >This hybrid approach is provided for the rare instances where an existing
- <a
- id="dx1-4110"></a><span
-class="cmtt-10">xindy </span>rule or module is too complicated to convert to a <a
- id="dx1-4111"></a><span
-class="cmtt-10">bib2gls </span>rule but
- the entries need to be fetched from a <span
-class="cmtt-10">bib</span><a
- id="dx1-4112"></a> file. There&#8217;s no benefit in using
- this option with <a
- id="dx1-4113"></a><span
-class="cmtt-10">makeindex</span>.
-
-
-
- </p><!--l. 886--><p class="noindent" ><div class="important" title="Important Note"> Since it&#8217;s redundant to make <a
- id="dx1-4114"></a><span
-class="cmtt-10">bib2gls </span>also sort, use <span
-class="cmtt-10">sort=none </span>in
- <span
-class="cmtt-10">\GlsXtrLoadResources </span>for a faster build. </div>
- </p><!--l. 889--><p class="noindent" >
- </p><!--l. 891--><p class="noindent" >This option must be used with <span
-class="cmtt-10">\makeglossaries</span><a
- id="dx1-4115"></a> but not with its optional
- argument. This option should not be used with <span
-class="cmtt-10">\makenoidxglossaries</span>.
- You may need to change the transcript file used by <a
- id="dx1-4116"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> to avoid a
- clash with the transcript file used by <a
- id="dx1-4117"></a><a
-href="#glo:makeindex"><span
-class="cmtt-10">makeindex</span></a> or <a
- id="dx1-4118"></a><a
-href="#glo:xindy"><span
-class="cmtt-10">xindy</span></a>. (This can be
- done with <a
- id="dx1-4119"></a><span
-class="cmtt-10">bib2gls</span>&#8217;s <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">--log-file</span></span></span> or <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">-t</span></span></span> option.)
- </p><!--l. 898--><p class="noindent" >Each glossary should be displayed using <span
-class="cmtt-10">\printglossary </span>(or
- <span
-class="cmtt-10">\printglossaries </span>for all of them). This option is expected to be used
- with <a
- id="dx1-4120"></a><span
-class="cmtt-10">bib2gls</span>&#8217;s <span
-class="cmtt-10">sort=none </span>setting and so <span
-class="cmss-10">glossaries-extra-bib2gls</span><a
- id="dx1-4121"></a> is not
- automatically loaded.
- </p><!--l. 903--><p class="noindent" >The document build process is (assuming the file is called <span
-class="cmtt-10">myDoc.tex</span>):
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-27">
- pdflatex&#x00A0;myDoc
- bib2gls&#x00A0;myDoc
- pdflatex&#x00A0;myDoc
- makeglossaries&#x00A0;myDoc
- pdflatex&#x00A0;myDoc
-</pre>
- <!--l. 911--><p class="nopar" > Note that, in this case, it&#8217;s redundant to call <a
- id="dx1-4122"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> with the <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">--group</span></span></span>
- or <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">-g</span></span></span> switch as <a
- id="dx1-4123"></a><a
-href="#glo:makeindex"><span
-class="cmtt-10">makeindex</span></a>/<a
- id="dx1-4124"></a><a
-href="#glo:xindy"><span
-class="cmtt-10">xindy</span></a> will insert the group heading
- information into the corresponding glossary file. (If you want
- <a
- id="dx1-4125"></a><span
-class="cmtt-10">bib2gls </span>to form the letter groups then this hybrid method is
- inappropriate.)</p></dd></dl>
- <!--l. 919--><p class="noindent" >With the recording on (<a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=only</span><a
- id="dx1-4126"></a>, <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=nameref</span><a
- id="dx1-4127"></a> or <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=hybrid</span><a
- id="dx1-4128"></a>), any of
- the commands that would typically index the entry (such as <span
-class="cmtt-10">\gls</span>, <span
-class="cmtt-10">\glstext </span>or
- <span
-class="cmtt-10">\glsadd</span>) will add a <span
-class="cmtt-10">\glsxtr@record </span>entry to the <span
-class="cmtt-10">.aux </span>file. <a
- id="dx1-4129"></a><span
-class="cmtt-10">bib2gls </span>can then
- read these lines to find out which entries have been used. (Remember that
- commands like <span
-class="cmtt-10">\glsentryname </span>don&#8217;t index, so any use of these commands
- won&#8217;t add a corresponding <span
-class="cmtt-10">\glsxtr@record </span>entry to the <span
-class="cmtt-10">.aux </span>file.)
- See <a
-href="#sec:bib2gls"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">10</span> </a><a
-href="#sec:bib2gls">bib2gls: Managing Reference Databases<!--tex4ht:ref: sec:bib2gls --></a> for further
- details.
- </p><!--l. 929--><p class="noindent" >The hybrid method additionally performs the standard indexing action that&#8217;s
- required for <a
- id="dx1-4130"></a><span
-class="cmtt-10">makeindex </span>or <a
- id="dx1-4131"></a><span
-class="cmtt-10">xindy </span>to work.
- </p></dd><dt class="description">
-<a
- id="styopt.equations"></a><span
-class="cmssbx-10">equations</span><a
- id="dx1-4132"></a> </dt><dd
-class="description">(New to v1.37.) This option will cause the default location counter to
- automatically switch to <span
-class="cmss-10">equation</span><a
- id="dx1-4133"></a> when inside a numbered equation
- environment, such as <span
-class="cmss-10">equation</span><a
- id="dx1-4134"></a><a
- id="dx1-4135"></a> or <span
-class="cmss-10">align</span><a
- id="dx1-4136"></a><a
- id="dx1-4137"></a>. The counter can be explicitly overridden
- with <span
-class="cmss-10">counter</span><a
- id="dx1-4138"></a> in the optional arguments of commands like <span
-class="cmtt-10">\glslink </span>or <span
-class="cmtt-10">\gls </span>as
- usual.
- </dd><dt class="description">
-<a
- id="styopt.floats"></a><span
-class="cmssbx-10">floats</span><a
- id="dx1-4139"></a> </dt><dd
-class="description">(New to v1.37.) This option will cause the default location counter to
- automatically switch to the corresponding counter when inside a floating
- environment, such as <span
-class="cmss-10">figure</span><a
- id="dx1-4140"></a><a
- id="dx1-4141"></a> or <span
-class="cmss-10">table</span><a
- id="dx1-4142"></a><a
- id="dx1-4143"></a>. The counter can be explicitly overridden
- with <span
-class="cmss-10">counter</span><a
- id="dx1-4144"></a> in the optional arguments of commands like <span
-class="cmtt-10">\glslink </span>or <span
-class="cmtt-10">\gls </span>as
- usual. Remember that within floats it&#8217;s the <span
-class="cmtt-10">\caption </span>command that actually
- uses <span
-class="cmtt-10">\refstepcounter</span>, so indexing before the caption will result in the wrong
- reference. The commands for use in captions and sections, such as
- <span
-class="cmtt-10">\glsfmttext </span>and <span
-class="cmtt-10">\glsfmtshort</span>, don&#8217;t index. (See <a
-href="#sec:headtitle"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">5</span>
- </a><a
-href="#sec:headtitle">Entries in Sectioning Titles, Headers, Captions and Contents<!--tex4ht:ref: sec:headtitle --></a>). You may
- want to consider using <span
-class="cmtt-10">\glsadd </span>after the caption (not before). For
- example:
-
-
-
- <pre class="verbatim" id="verbatim-28">
- \begin{figure}[htbp]
- &#x00A0;&#x00A0;\centering
- &#x00A0;&#x00A0;\includegraphics{example-image}
- &#x00A0;&#x00A0;\caption{Sample&#x00A0;\glsfmttext{foobar}&#x00A0;figure}
- &#x00A0;&#x00A0;\glsadd{foobar}
- \end{figure}
-</pre>
- <!--l. 958--><p class="nopar" >
- </p></dd><dt class="description">
-<a
- id="styopt.indexcounter"></a><span
-class="cmssbx-10">indexcounter</span><a
- id="dx1-4145"></a> </dt><dd
-class="description">(New to v1.29.) This option (which doesn&#8217;t take a value) is primarily
- intended for use with <a
- id="dx1-4146"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> (v1.4+) and <span
-class="cmss-10">hyperref</span><a
- id="dx1-4147"></a>. It can be used
- with <a
- id="dx1-4148"></a><a
-href="#glo:makeindex"><span
-class="cmtt-10">makeindex</span></a> or <a
- id="dx1-4149"></a><a
-href="#glo:xindy"><span
-class="cmtt-10">xindy</span></a> but it will interfere with the <a
- id="dx1-4150"></a><a
-href="#glo:numberlist">number list</a>
- collation, so you won&#8217;t have ranges and you&#8217;ll have duplicate page numbers
- present (but each page number will link to the relevant part of the page
- where the indexing occurred). This option automatically implements
- <a
-href="#styopt.counter"><span
-class="cmss-10">counter</span></a><span
-class="cmss-10">=wrglossary</span><a
- id="dx1-4151"></a>.
- <!--l. 969--><p class="noindent" ><div class="important" title="Important Note"> This option works by incrementing <span
-class="cmss-10">wrglossary</span><a
- id="dx1-4152"></a> and adding <span
-class="cmtt-10">\label</span><a
- id="dx1-4153"></a>. This can
- cause a problem if the indexing occurs in an <span
-class="cmss-10">equation</span><a
- id="dx1-4154"></a><a
- id="dx1-4155"></a> environment as <span
-class="cmss-10">amsmath</span><a
- id="dx1-4156"></a>
- forbids multiple occurrences of <span
-class="cmtt-10">\label </span>(resulting in the &#8220;Multiple <span
-class="cmtt-10">\label</span>&#8217;s&#8221;
- error). It&#8217;s best to change the counter to <span
-class="cmss-10">page</span><a
- id="dx1-4157"></a> or <span
-class="cmss-10">equation</span><a
- id="dx1-4158"></a> when in maths mode
- with this option. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-29">
- \renewcommand{\glslinkpresetkeys}{%
- &#x00A0;\ifmmode&#x00A0;\setkeys{glslink}{counter=equation}\fi}
- \renewcommand{\glsaddpresetkeys}{%
- &#x00A0;\ifmmode&#x00A0;\setkeys{glossadd}{counter=equation}\fi}
-</pre>
- <!--l. 982--><p class="nopar" > </div>
- </p><!--l. 983--><p class="noindent" >
- </p><!--l. 985--><p class="noindent" >By default (with <span
-class="cmss-10">hyperref</span><a
- id="dx1-4159"></a>), the page numbers in <a
- id="dx1-4160"></a><a
-href="#glo:numberlist">number lists</a> link back to the
- top of the relevant page (provided the format uses <span
-class="cmtt-10">\glshypernumber</span>). The
- <a
-href="#styopt.indexcounter"><span
-class="cmss-10">indexcounter</span></a><a
- id="dx1-4161"></a> option is designed to link back to the place within the page where
- the indexing occurred. It does this by creating a new counter (called <span
-class="cmss-10">wrglossary</span><a
- id="dx1-4162"></a>)
- that&#8217;s incremented with <span
-class="cmtt-10">\refstepcounter </span>every time an entry is indexed (but
- not via cross-referencing commands, such as <span
-class="cmtt-10">\glssee</span>). A <span
-class="cmtt-10">\label </span>is placed
- immediately after the increment command allowing the back-referenced to be
- obtained with <span
-class="cmtt-10">\pageref</span>. The location, as seen by the indexing application, is
- the value of the <span
-class="cmss-10">wrglossary</span><a
- id="dx1-4163"></a> counter but this value is substituted with the page
- reference when <a
- id="dx1-4164"></a>number list is typeset. Since the counter is used by all
- entries and is incremented every time any indexing occurs, neither
- <a
- id="dx1-4165"></a><a
-href="#glo:makeindex"><span
-class="cmtt-10">makeindex</span></a> nor <a
- id="dx1-4166"></a><a
-href="#glo:xindy"><span
-class="cmtt-10">xindy</span></a> can correctly collate the lists. For example, if the first
- term to be referenced is indexed three times on page&#x00A0;5 without any
- intervening terms then the actual locations obtained from <span
-class="cmss-10">wrglossary</span><a
- id="dx1-4167"></a>
- will be 1, 2 and 3, which <a
- id="dx1-4168"></a><span
-class="cmtt-10">xindy </span>and <a
- id="dx1-4169"></a><span
-class="cmtt-10">makeindex </span>will try to form into
- the range 1&#8211;3, but they should actually all simply appear as page&#x00A0;5,
- whereas it can actually end up with 5&#8211;5. Conversely, a range may not be
- formed where it would naturally occur if just the <span
-class="cmss-10">page</span><a
- id="dx1-4170"></a> counter was
- used.
- </p><!--l. 1009--><p class="noindent" >Since <a
- id="dx1-4171"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> is designed specifically to work with <span
-class="cmss-10">glossaries-extra</span>,
- <a
- id="dx1-4172"></a><span
-class="cmtt-10">bib2gls </span>(v1.4+) will check for <span
-class="cmss-10">wrglossary</span><a
- id="dx1-4173"></a> locations. If the default
- <span
-class="cmtt-10">--merge-wrglossary-records </span>is on, then any records for the same page
- for a given entry will be merged. In the above example with three
- references on page&#x00A0;5, only a single record for page&#x00A0;5 for that entry will be
- added to the <a
- id="dx1-4174"></a>number list and it will link back to the first instance on
- that page. Whereas if you use the <span
-class="cmtt-10">--no-merge-wrglossary-records</span>
- switch, the <a
- id="dx1-4175"></a>number list will contain three instance of page&#x00A0;5, with
- each linking to the corresponding place on that page. In both cases,
- consecutive pages can form ranges, but it may look strange in the second
- case.
- </p><!--l. 1022--><p class="noindent" >See the <a
- id="dx1-4176"></a><span
-class="cmtt-10">bib2gls </span>documentation for the <span
-class="cmtt-10">save-index-counter </span>resource option
- for more details.
-
-
-
- </p></dd><dt class="description">
-<a
- id="styopt.docdef"></a><span
-class="cmssbx-10">docdef</span><a
- id="dx1-4177"></a> </dt><dd
-class="description">This option governs the use of <span
-class="cmtt-10">\newglossaryentry</span>. It was originally a
- boolean option, but as from version 1.06, it can now take one of the following
- values (if the value is omitted, <span
-class="cmss-10">true </span>is assumed):
- <ul class="itemize1">
- <li class="itemize"><a
-href="#styopt.docdef"><span
-class="cmss-10">docdef</span></a><span
-class="cmss-10">=false</span><a
- id="dx1-4178"></a>: <span
-class="cmtt-10">\newglossaryentry</span><a
- id="dx1-4179"></a> is not permitted in the <span
-class="cmss-10">document</span><a
- id="dx1-4180"></a><a
- id="dx1-4181"></a>
- environment (default).
- </li>
- <li class="itemize"><a
-href="#styopt.docdef"><span
-class="cmss-10">docdef</span></a><span
-class="cmss-10">=true</span><a
- id="dx1-4182"></a>: <span
-class="cmtt-10">\newglossaryentry </span>behaves as it does in the base
- <span
-class="cmss-10">glossaries </span>package. That is, where its use is permitted in the <span
-class="cmss-10">document</span><a
- id="dx1-4183"></a><a
- id="dx1-4184"></a>
- environment, it uses the <span
-class="cmtt-10">.glsdefs </span>temporary file to store the entry
- definitions so that on the next LaTeX&#x00A0;run the entries are defined at
- the beginning of the <span
-class="cmss-10">document</span><a
- id="dx1-4185"></a><a
- id="dx1-4186"></a> environment. This allows the entry
- information to be referenced in the glossary, even if the glossary
- occurs before <span
-class="cmtt-10">\newglossaryentry</span>. (For example, when the glossary
- is displayed in the front matter.) This method of saving the definitions
- for the next LaTeX&#x00A0;run has drawbacks that are detailed in the
- <span
-class="cmss-10">glossaries </span>user manual.
- <!--l. 1047--><p class="noindent" >Remember that if <span
-class="cmtt-10">\newglossaryentry </span>wouldn&#8217;t be allowed in the
- <span
-class="cmss-10">document</span><a
- id="dx1-4187"></a><a
- id="dx1-4188"></a> environment with the base <span
-class="cmss-10">glossaries </span>package, then it still
- won&#8217;t be allowed with <a
-href="#styopt.docdefs"><span
-class="cmss-10">docdefs</span></a><span
-class="cmss-10">=true</span><a
- id="dx1-4189"></a>. If your glossaries occur at the
- end of the document, consider using <a
-href="#styopt.docdef"><span
-class="cmss-10">docdef</span></a><span
-class="cmss-10">=restricted</span><a
- id="dx1-4190"></a> instead.
- </p></li>
- <li class="itemize"><a
-href="#styopt.docdef"><span
-class="cmss-10">docdef</span></a><span
-class="cmss-10">=restricted</span><a
- id="dx1-4191"></a>: (new to version 1.06) <span
-class="cmtt-10">\newglossaryentry</span><a
- id="dx1-4192"></a> is
- permitted in the <span
-class="cmss-10">document</span><a
- id="dx1-4193"></a><a
- id="dx1-4194"></a> environment without using the <span
-class="cmtt-10">.glsdefs</span>
- file. This means that all entries must be defined before the glossary
- is displayed, but it avoids the complications associated with saving
- the entry details in a temporary file. You will still need to take
- care about any changes made to characters that are required by
- the &#x27E8;<span
-class="cmti-10">key</span>&#x27E9;=&#x27E8;<span
-class="cmti-10">value</span>&#x27E9; mechanism (that is, the comma and equal sign) and
- any <a
- id="dx1-4195"></a><a
-href="#glo:makeindex"><span
-class="cmtt-10">makeindex</span></a> or <a
- id="dx1-4196"></a><a
-href="#glo:xindy"><span
-class="cmtt-10">xindy</span></a> character that occurs in the <span
-class="cmss-10">sort</span><a
- id="dx1-4197"></a> key or
- label. If any of those characters are made active in the document,
- then it can cause problems with the entry definition. This option
- will allow <span
-class="cmtt-10">\newglossaryentry </span>to be used in the document with
- <span
-class="cmtt-10">\makenoidxglossaries</span>, but note that <span
-class="cmtt-10">\longnewglossaryentry</span>
- remains a preamble-only command.
- <!--l. 1070--><p class="noindent" >With this option, if an entry appears in the glossary before it has been
- defined, an error will occur (or a warning if the <a
-href="#styopt.undefaction"><span
-class="cmss-10">undefaction</span></a><span
-class="cmss-10">=warn</span><a
- id="dx1-4198"></a>
- option is used.) If you edit your document and either remove an entry
- or change its label, you may need to delete the document&#8217;s temporary
- files (such as the <span
-class="cmtt-10">.aux </span>and <span
-class="cmtt-10">.gls </span>files).
- </p></li>
- <li class="itemize"><a
-href="#styopt.docdef"><span
-class="cmss-10">docdef</span></a><span
-class="cmss-10">=atom</span><a
- id="dx1-4199"></a>: (new to version 1.34) This option behaves like
-
-
-
- <a
-href="#styopt.docdef"><span
-class="cmss-10">docdef</span></a><span
-class="cmss-10">=restricted</span><a
- id="dx1-4200"></a> but creates the <span
-class="cmtt-10">.glsdefs </span>file for <a
-href="https://atom.io/packages/autocomplete-glossaries" >atom&#8217;s
- autocomplete support</a>. This file isn&#8217;t input by <span
-class="cmss-10">glossaries-extra </span>and
- so associated problems with the use of this file are avoided, but it
- allows the autocomplete support to find the labels in the file. As
- with <a
-href="#styopt.docdef"><span
-class="cmss-10">docdef</span></a><span
-class="cmss-10">=restricted</span><a
- id="dx1-4201"></a>, entries may be defined in the preamble or
- anywhere in the document, but they may only be referenced after
- they have been defined. Entries must be defined before the associated
- glossary is displayed.
- <!--l. 1089--><p class="noindent" >If you need a list of all entry labels for the use of an editor or helper
- script you may also want to consider the package options <a
-href="#styopt.writeglslabels"><span
-class="cmss-10">writeglslabels</span></a><a
- id="dx1-4202"></a>
- and <a
-href="#styopt.writeglslabelnames"><span
-class="cmss-10">writeglslabelnames</span></a><a
- id="dx1-4203"></a> provided by the base <span
-class="cmss-10">glossaries</span><a
- id="dx1-4204"></a> package. Note
- that with these options and <a
-href="#styopt.docdef"><span
-class="cmss-10">docdef</span></a><span
-class="cmss-10">=atom</span><a
- id="dx1-4205"></a>, only the entry labels visible
- to LaTeX&#x00A0;can be saved. So if you are using <a
- id="dx1-4206"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> you will only
- get the labels of the entries that are selected by <a
- id="dx1-4207"></a><span
-class="cmtt-10">bib2gls</span>.
-</p>
- </li></ul>
- <!--l. 1099--><p class="noindent" >The <span
-class="cmss-10">glossaries </span>package allows <span
-class="cmtt-10">\newglossaryentry </span>within the <span
-class="cmss-10">document</span><a
- id="dx1-4208"></a><a
- id="dx1-4209"></a>
- environment (when used with <a
- id="dx1-4210"></a><a
-href="#glo:makeindex"><span
-class="cmtt-10">makeindex</span></a> or <a
- id="dx1-4211"></a><a
-href="#glo:xindy"><span
-class="cmtt-10">xindy</span></a>) but the user manual warns
- against this usage. By default the <span
-class="cmss-10">glossaries-extra </span>package <span
-class="cmti-10">prohibits </span>this, only
- allowing definitions within the preamble. If you are really determined to define
- entries in the <span
-class="cmss-10">document</span><a
- id="dx1-4212"></a><a
- id="dx1-4213"></a> environment, despite all the associated drawbacks, you
- can restore this with <a
-href="#styopt.docdef"><span
-class="cmss-10">docdef</span></a><span
-class="cmss-10">=true</span><a
- id="dx1-4214"></a>. Note that this doesn&#8217;t change the
- prohibitions that the <span
-class="cmss-10">glossaries </span>package has in certain circumstances (for
- example, when using &#8220;option&#x00A0;1&#8221;). See the <span
-class="cmss-10">glossaries </span>user manual for
- further details. A better option if document definitions are required
- is <a
-href="#styopt.docdef"><span
-class="cmss-10">docdef</span></a><span
-class="cmss-10">=restricted</span><a
- id="dx1-4215"></a>. Only use <a
-href="#styopt.docdef"><span
-class="cmss-10">docdef</span></a><span
-class="cmss-10">=true</span><a
- id="dx1-4216"></a> if document definitions
- are necessary and one or more of the glossaries occurs in the front
- matter.
- </p><!--l. 1116--><p class="noindent" >This option affects commands that internally use <span
-class="cmtt-10">\newglossaryentry</span>, such as
- <span
-class="cmtt-10">\newabbreviation</span>, but not the &#8220;on-the-fly&#8221; commands described in
- <a
-href="#sec:onthefly"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">12</span> </a><a
-href="#sec:onthefly">On-the-Fly Document Definitions<!--tex4ht:ref: sec:onthefly --></a>.
- </p></dd><dt class="description">
-<a
- id="styopt.nomissingglstext"></a><span
-class="cmssbx-10">nomissingglstext</span><a
- id="dx1-4217"></a> </dt><dd
-class="description">This is a boolean option. If true, this will suppress the
- warning written to the transcript and the warning text that will appear
- in the document if the external glossary files haven&#8217;t been generated
- due to an incomplete document build. However, it&#8217;s probably simpler
- just to fix whatever has caused the failure to build the external file or
- files.
- </dd><dt class="description">
-<a
- id="styopt.abbreviations"></a><span
-class="cmssbx-10">abbreviations</span><a
- id="dx1-4218"></a> </dt><dd
-class="description">This option has no value and can&#8217;t be cancelled. If used, it will
- automatically create a new glossary with the label <span
-class="cmtt-10">abbreviations </span>and
- redefines <span
-class="cmtt-10">\glsxtrabbrvtype </span>to this label. (The file extensions are <span
-class="cmtt-10">glg-abr</span><a
- id="dx1-4219"></a>,
- <span
-class="cmtt-10">gls-abr</span><a
- id="dx1-4220"></a> and <span
-class="cmtt-10">glo-abr</span><a
- id="dx1-4221"></a>.) In addition, this option defines a shortcut
-
-
-
- command
- <!--l. 1136--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-4222"></a> <span
-class="cmtt-10">\printabbreviations[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
- </p><!--l. 1138--><p class="noindent" >
- which is equivalent to </p><div class="alltt">
- <div class="obeylines-v">
- <span
-class="cmtt-10">\printglossary[type=\glsxtrabbrvtype,</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]</span>
-</div>
- </div> If <span
-class="cmss-10">glossaries-extra-bib2gls</span><a
- id="dx1-4223"></a> is also loaded then this option will additionally
- provide:
- <!--l. 1145--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-4224"></a> <span
-class="cmtt-10">\printunsrtabbreviations[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
- </p><!--l. 1147--><p class="noindent" >
- which uses <span
-class="cmtt-10">\printunsrtglossary</span><a
- id="dx1-4225"></a>.
- </p><!--l. 1150--><p class="noindent" >The title of the new glossary is given by
- </p><!--l. 1151--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-4226"></a> <span
-class="cmtt-10">\abbreviationsname </span></div><hr>
- </p><!--l. 1153--><p class="noindent" >
- If this command is already defined, it&#8217;s left unchanged. Otherwise it&#8217;s defined to
- &#8220;Abbreviations&#8221; if <span
-class="cmss-10">babel</span><a
- id="dx1-4227"></a> hasn&#8217;t been loaded or <span
-class="cmtt-10">\acronymname </span>if <span
-class="cmss-10">babel</span><a
- id="dx1-4228"></a> has
- been loaded. However, if you&#8217;re using <span
-class="cmss-10">babel</span><a
- id="dx1-4229"></a> it&#8217;s likely you will need
- to change this. (See <a
-href="#sec:lang"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">15</span> </a><a
-href="#sec:lang">Multi-Lingual Support<!--tex4ht:ref: sec:lang --></a> for further
- details.)
- </p><!--l. 1160--><p class="noindent" ><div class="important" title="Important Note"> If you don&#8217;t use the <a
-href="#styopt.abbreviations"><span
-class="cmss-10">abbreviations</span></a><a
- id="dx1-4230"></a> package option, the <span
-class="cmtt-10">\abbreviationsname</span>
- command won&#8217;t be defined (unless it&#8217;s defined by an included language file).
- </div>
- </p><!--l. 1164--><p class="noindent" >
- </p><!--l. 1166--><p class="noindent" >If the <a
-href="#styopt.abbreviations"><span
-class="cmss-10">abbreviations</span></a><a
- id="dx1-4231"></a> option is used and the <a
-href="#styopt.acronym"><span
-class="cmss-10">acronym</span></a><a
- id="dx1-4232"></a> option provided by the
- <span
-class="cmss-10">glossaries </span>package hasn&#8217;t been used, then <span
-class="cmtt-10">\acronymtype</span><a
- id="dx1-4233"></a> will be set to
- <span
-class="cmtt-10">\glsxtrabbrvtype</span><a
- id="dx1-4234"></a> so that acronyms defined with <span
-class="cmtt-10">\newacronym</span><a
- id="dx1-4235"></a> can be added
- to the list of abbreviations. If you want acronyms in the <span
-class="cmtt-10">main </span>glossary and
- other abbreviations in the <span
-class="cmtt-10">abbreviations </span>glossary then you will need to
- redefine <span
-class="cmtt-10">\acronymtype </span>to <span
-class="cmtt-10">main</span>:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-30">
- \renewcommand*{\acronymtype}{main}
-</pre>
- <!--l. 1176--><p class="nopar" >
- </p><!--l. 1178--><p class="noindent" >Note that there are no analogous options to the <span
-class="cmss-10">glossaries </span>package&#8217;s <a
-href="#styopt.acronymlists"><span
-class="cmss-10">acronymlists</span></a><a
- id="dx1-4236"></a>
- option (or associated commands) as the abbreviation mechanism is handled
- differently with <span
-class="cmss-10">glossaries-extra</span>.
- </p></dd><dt class="description">
-<a
- id="styopt.symbols"></a><span
-class="cmssbx-10">symbols</span><a
- id="dx1-4237"></a> </dt><dd
-class="description">This is passed to <span
-class="cmss-10">glossaries </span>but will additionally define
- <!--l. 1185--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-4238"></a> <span
-class="cmtt-10">\glsxtrnewsymbol[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">symbol</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
- </p><!--l. 1187--><p class="noindent" >
- which is equivalent to </p><div class="alltt">
- <div class="obeylines-v">
- <span
-class="cmtt-10">\newglossaryentry{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">name={</span>&#x27E8;<span
-class="cmitt-10">symbol</span>&#x27E9;<span
-class="cmtt-10">},</span>
- <br /><span
-class="cmtt-10">&#x00A0;sort={</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">},type=symbols,category=symbol,</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmsy-10">}</span>
-</div>
- </div> Note that the <span
-class="cmss-10">sort</span><a
- id="dx1-4239"></a> key is set to the &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; not the &#x27E8;<span
-class="cmti-10">symbol</span>&#x27E9; as the symbol will
- likely contain commands.
- <!--l. 1196--><p class="noindent" >If <span
-class="cmss-10">glossaries-extra-bib2gls</span><a
- id="dx1-4240"></a> is also loaded then this option will additionally
- provide:
- </p><!--l. 1198--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-4241"></a> <span
-class="cmtt-10">\printunsrtsymbols[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
- </p><!--l. 1200--><p class="noindent" >
- which uses <span
-class="cmtt-10">\printunsrtglossary</span><a
- id="dx1-4242"></a>.
- </p></dd><dt class="description">
-<a
- id="styopt.numbers"></a><span
-class="cmssbx-10">numbers</span><a
- id="dx1-4243"></a> </dt><dd
-class="description">This is passed to <span
-class="cmss-10">glossaries </span>but will additionally define
- <!--l. 1205--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-4244"></a> <span
-class="cmtt-10">\glsxtrnewnumber[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">number</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
- </p><!--l. 1207--><p class="noindent" >
- which is equivalent to </p><div class="alltt">
- <div class="obeylines-v">
- <span
-class="cmtt-10">\newglossaryentry{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">name={</span>&#x27E8;<span
-class="cmitt-10">number</span>&#x27E9;<span
-class="cmtt-10">},</span>
- <br /><span
-class="cmtt-10">&#x00A0;sort={</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">},type=numbers,category=number,</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmsy-10">}</span>
-
-
-
-</div>
- </div>
- <!--l. 1214--><p class="noindent" >If <span
-class="cmss-10">glossaries-extra-bib2gls</span><a
- id="dx1-4245"></a> is also loaded then this option will additionally
- provide:
- </p><!--l. 1216--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-4246"></a> <span
-class="cmtt-10">\printunsrtnumbers[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
- </p><!--l. 1218--><p class="noindent" >
- which uses <span
-class="cmtt-10">\printunsrtglossary</span><a
- id="dx1-4247"></a>.
- </p></dd><dt class="description">
-<a
- id="styopt.acronyms"></a><span
-class="cmssbx-10">acronyms</span><a
- id="dx1-4248"></a> <span
-class="cmbx-10">(or </span><a
- id="styopt.acronym"></a><span
-class="cmssbx-10">acronym</span><a
- id="dx1-4249"></a><span
-class="cmbx-10">)</span> </dt><dd
-class="description">This is passed to <span
-class="cmss-10">glossaries </span>but if <span
-class="cmss-10">glossaries-extra-bib2gls</span><a
- id="dx1-4250"></a> is
- also loaded then this option will additionally provide:
- <!--l. 1225--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-4251"></a> <span
-class="cmtt-10">\printunsrtacronyms[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
- </p><!--l. 1227--><p class="noindent" >
- which uses <span
-class="cmtt-10">\printunsrtglossary</span><a
- id="dx1-4252"></a>.
- </p><!--l. 1230--><p class="noindent" ><div class="important" title="Important Note"> This option defines a new glossary with the label <span
-class="cmtt-10">acronym </span>not <span
-class="cmtt-10">acronyms</span>. You
- may find it easier to reference it with the command <span
-class="cmtt-10">\acronymtype</span><a
- id="dx1-4253"></a>.
- </div>
- </p><!--l. 1234--><p class="noindent" >
- </p></dd><dt class="description">
-<a
- id="styopt.index"></a><span
-class="cmssbx-10">index</span><a
- id="dx1-4254"></a> </dt><dd
-class="description">This is passed to <span
-class="cmss-10">glossaries </span>but if <span
-class="cmss-10">glossaries-extra-bib2gls</span><a
- id="dx1-4255"></a> is also loaded then this
- option will additionally provide:
- <!--l. 1240--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-4256"></a> <span
-class="cmtt-10">\printunsrtindex[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
- </p><!--l. 1242--><p class="noindent" >
- which uses <span
-class="cmtt-10">\printunsrtglossary</span><a
- id="dx1-4257"></a>.
- </p></dd><dt class="description">
-<a
- id="styopt.shortcuts"></a><span
-class="cmssbx-10">shortcuts</span><a
- id="dx1-4258"></a> </dt><dd
-class="description">Unlike the <span
-class="cmss-10">glossaries </span>package option of the same name, this option isn&#8217;t
- boolean but has multiple values:
- <ul class="itemize1">
- <li class="itemize"><a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><span
-class="cmss-10">=acronyms</span><a
- id="dx1-4259"></a> (or <a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><span
-class="cmss-10">=acro</span><a
- id="dx1-4260"></a>): set the shortcuts provided
- by the <span
-class="cmss-10">glossaries </span>package for acronyms (such as <span
-class="cmtt-10">\ac</span>). Note that the
- short and long forms don&#8217;t use <span
-class="cmtt-10">\glsxtrshort </span>and <span
-class="cmtt-10">\glsxtrlong </span>but
- use the original <span
-class="cmtt-10">\acrshort </span>and <span
-class="cmtt-10">\acrlong</span>, which don&#8217;t recognise
- multiple abbreviation styles. The better option with <span
-class="cmss-10">glossaries-extra</span>
- is <a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><span
-class="cmss-10">=ac</span><a
- id="dx1-4261"></a>.
- </li>
- <li class="itemize"><a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><span
-class="cmss-10">=ac</span><a
- id="dx1-4262"></a>: set the shortcuts provided by the <span
-class="cmss-10">glossaries </span>package for
- acronyms (such as <span
-class="cmtt-10">\ac</span>) but uses the <span
-class="cmss-10">glossaries-extra </span>interface (such
- as <span
-class="cmtt-10">\glsxtrshort </span>rather than <span
-class="cmtt-10">\acrshort</span>). In this case <span
-class="cmtt-10">\ac </span>is defined
- as <span
-class="cmtt-10">\cgls </span>rather than <span
-class="cmtt-10">\gls</span>.
-
-
-
- </li>
- <li class="itemize"><a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><span
-class="cmss-10">=abbreviations</span><a
- id="dx1-4263"></a> (or <a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><span
-class="cmss-10">=abbr</span><a
- id="dx1-4264"></a>): set the abbreviation
- shortcuts provided by <span
-class="cmss-10">glossaries-extra</span>. (See <a
-href="#sec:abbrshortcuts"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">4.3</span>
- </a><a
-href="#sec:abbrshortcuts">Shortcut Commands<!--tex4ht:ref: sec:abbrshortcuts --></a>.) These settings don&#8217;t switch on the acronym
- shortcuts provided by the <span
-class="cmss-10">glossaries </span>package.
- </li>
- <li class="itemize"><a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><span
-class="cmss-10">=other</span><a
- id="dx1-4265"></a>: set the &#8220;other&#8221; shortcut commands, but not the shortcut
- commands for abbreviations or the acronym shortcuts provided by
- <span
-class="cmss-10">glossaries</span>. The &#8220;other&#8221; shortcuts are:
- <ul class="itemize2">
- <li class="itemize"><span
-class="cmtt-10">\newentry</span><a
- id="dx1-4266"></a> equivalent to <span
-class="cmtt-10">\newglossaryentry</span><a
- id="dx1-4267"></a>
- </li>
- <li class="itemize"><span
-class="cmtt-10">\newsym</span><a
- id="dx1-4268"></a> equivalent to <span
-class="cmtt-10">\glsxtrnewsymbol</span><a
- id="dx1-4269"></a> (see the <a
-href="#styopt.symbols"><span
-class="cmss-10">symbols</span></a><a
- id="dx1-4270"></a>
- option).
- </li>
- <li class="itemize"><span
-class="cmtt-10">\newnum</span><a
- id="dx1-4271"></a> equivalent to <span
-class="cmtt-10">\glsxtrnewnumber</span><a
- id="dx1-4272"></a> (see the <a
-href="#styopt.numbers"><span
-class="cmss-10">numbers</span></a><a
- id="dx1-4273"></a>
- option).</li></ul>
- </li>
- <li class="itemize"><a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><span
-class="cmss-10">=all</span><a
- id="dx1-4274"></a> (or <a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><span
-class="cmss-10">=true</span><a
- id="dx1-4275"></a>): implements <a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><span
-class="cmss-10">=ac</span><a
- id="dx1-4276"></a>,
- <a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><span
-class="cmss-10">=abbreviations</span><a
- id="dx1-4277"></a> and <a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><span
-class="cmss-10">=other</span><a
- id="dx1-4278"></a>.
- </li>
- <li class="itemize"><a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><span
-class="cmss-10">=none</span><a
- id="dx1-4279"></a> (or <a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><span
-class="cmss-10">=false</span><a
- id="dx1-4280"></a>): don&#8217;t define any of the shortcut
- commands (default).
- </li></ul>
- <!--l. 1291--><p class="noindent" >Note that multiple invocations of the <a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><a
- id="dx1-4281"></a> option <span
-class="cmti-10">within the same option</span>
- <span
-class="cmti-10">list </span>will override each other.
-</p>
- </dd></dl>
-<!--l. 1296--><p class="indent" > After the <span
-class="cmss-10">glossaries-extra </span>package has been loaded, you can set available options
-using
-</p><!--l. 1298--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-4282"></a> <span
-class="cmtt-10">\glossariesextrasetup{</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 1300--><p class="noindent" >
-The <a
-href="#styopt.abbreviations"><span
-class="cmss-10">abbreviations</span></a><a
- id="dx1-4283"></a> and <a
-href="#styopt.docdef"><span
-class="cmss-10">docdef</span></a><a
- id="dx1-4284"></a> options may only be used in the preamble. Additionally,
-<a
-href="#styopt.docdef"><span
-class="cmss-10">docdef</span></a><a
- id="dx1-4285"></a> can&#8217;t be used after <span
-class="cmtt-10">\makenoidxglossaries</span><a
- id="dx1-4286"></a>.
-
-
-
-</p>
-<!--l. 1305--><p class="indent" > </div>
-</p><!--l. 1305--><p class="noindent" ><a
-href="#top">Top</a><div class="chapter"><h2 class="chapterHead">2. <a
- id="sec:modifications"></a>Modifications to Existing Commands and Styles</h2>
-</p>
-<!--l. 1308--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.1 </span> <a
- id="sec:definingentries"></a>Defining Entries</h3>
-<!--l. 1311--><p class="noindent" >The <span
-class="cmss-10">glossaries </span>package provides <span
-class="cmtt-10">\nopostdesc</span><a
- id="dx1-6001"></a> which may be used in the <span
-class="cmss-10">description</span><a
- id="dx1-6002"></a> to
-suppress the post-description hook. The <span
-class="cmss-10">glossaries-extra </span>package provides another
-command
-</p><!--l. 1315--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-6003"></a> <span
-class="cmtt-10">\glsxtrnopostpunc </span></div><hr>
-</p><!--l. 1317--><p class="noindent" >
-which has a similar function but only suppresses the post-description punctuation. It
-doesn&#8217;t suppress the use of <span
-class="cmtt-10">\glsxtrpostdescription </span>which allows the use of
-category-dependent post-description hooks. (Note that the punctuation,
-which is in the original base hook <span
-class="cmtt-10">\glspostdescription</span>, comes after the
-extended post-description hook <span
-class="cmtt-10">\glsxtrpostdescription </span>not before.) The
-post-description hook can counter-act the effect of <span
-class="cmtt-10">\glsxtrnopostpunc</span>
-using
-</p><!--l. 1326--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-6004"></a> <span
-class="cmtt-10">\glsxtrrestorepostpunc </span></div><hr>
-</p><!--l. 1328--><p class="noindent" >
-These commands have no effect outside of the glossary (except with standalone
-entries that use <span
-class="cmtt-10">\glsxtractivatenopost </span>and <span
-class="cmtt-10">\glspostdescription</span>, see
-<a
-href="#sec:glossentry"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">11.4</span> </a><a
-href="#sec:glossentry">Standalone Entry Items<!--tex4ht:ref: sec:glossentry --></a>).
-</p><!--l. 1333--><p class="indent" > The commands used by <span
-class="cmss-10">glossaries </span>to automatically produce an error if an entry is
-undefined (such as <span
-class="cmtt-10">\glsdoifexists</span><a
- id="dx1-6005"></a>) are changed to take the <a
-href="#styopt.undefaction"><span
-class="cmss-10">undefaction</span></a><a
- id="dx1-6006"></a> option into
-account.
-</p><!--l. 1337--><p class="indent" > The <span
-class="cmtt-10">\newglossaryentry </span>command has three new keys: </p>
- <ul class="itemize1">
- <li class="itemize"><span
-class="cmss-10">category</span><a
- id="dx1-6007"></a>, which sets the category label for the given entry. By default this
- is <span
-class="cmtt-10">general</span>. See <a
-href="#sec:categories"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">7</span> </a><a
-href="#sec:categories">Categories<!--tex4ht:ref: sec:categories --></a> for further information about
- categories.
- </li>
- <li class="itemize"><span
-class="cmss-10">alias</span><a
- id="dx1-6008"></a>, which allows an entry to be alias to another entry. See <a
-href="#sec:alias"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">11.5</span>
- </a><a
-href="#sec:alias">Entry Aliases<!--tex4ht:ref: sec:alias --></a> for further details.
- </li>
- <li class="itemize"><span
-class="cmss-10">seealso</span><a
- id="dx1-6009"></a>, which performs much like <span
-class="cmss-10">see</span><a
- id="dx1-6010"></a>, but allows for separate &#8220;see&#8221; and
- &#8220;see also&#8221; treatment. See <a
-href="#sec:see"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.3</span> </a><a
-href="#sec:see">Cross-References (&#8220;see&#8221; and &#8220;see
- also&#8221;)<!--tex4ht:ref: sec:see --></a> for further details.</li></ul>
-<!--l. 1349--><p class="noindent" >This apply to all entry defining commands (such as <span
-class="cmtt-10">\newabbreviation</span>).
-</p><!--l. 1352--><p class="indent" > The test file <span
-class="cmtt-10">example-glossaries-xr.tex </span>contains dummy entries with a
-mixture of <span
-class="cmss-10">see</span><a
- id="dx1-6011"></a>, <span
-class="cmss-10">alias</span><a
- id="dx1-6012"></a> and <span
-class="cmss-10">seealso</span><a
- id="dx1-6013"></a> keys for use with minimal working examples.
-There are also <span
-class="cmtt-10">example-glossaries-*.bib </span>files that correspond to each
-<span
-class="cmtt-10">example-glossaries-*.tex </span>file for testing <a
- id="dx1-6014"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a>.
-
-
-
-</p><!--l. 1359--><p class="indent" > The <span
-class="cmtt-10">\longnewglossaryentry </span>command now has a starred version (as from v1.12)
-that doesn&#8217;t automatically insert
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-31">
-\leavevmode\unskip\nopostdesc
-</pre>
-<!--l. 1363--><p class="nopar" > at the end of the description field.
-</p><!--l. 1365--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-6015"></a> <span
-class="cmtt-10">\longnewglossaryentry*{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">description</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 1367--><p class="noindent" >
-The <span
-class="cmss-10">descriptionplural</span><a
- id="dx1-6016"></a> key is left unset unless explicitly set in &#x27E8;<span
-class="cmti-10">options</span>&#x27E9;.
-</p><!--l. 1371--><p class="indent" > The unstarred version no longer hard-codes the above code (which removes
-trailing space and suppresses the post-description hook) but instead uses:
-</p><!--l. 1374--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-6017"></a> <span
-class="cmtt-10">\glsxtrpostlongdescription </span></div><hr>
-</p><!--l. 1376--><p class="noindent" >
-This can be redefined to allow the post-description hook to work but retain the
-<span
-class="cmtt-10">\unskip </span>part if required. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-32">
-\renewcommand*{\glsxtrpostlongdescription}{\leavevmode\unskip}
-</pre>
-<!--l. 1382--><p class="nopar" > This will discarded unwanted trailing space at the end of the description but won&#8217;t
-suppress the post-description hook.
-</p><!--l. 1386--><p class="indent" > The unstarred version also alters the base <span
-class="cmss-10">glossaries</span><a
- id="dx1-6018"></a> package&#8217;s treatment of the
-<span
-class="cmss-10">descriptionplural</span><a
- id="dx1-6019"></a> key. Since a plural description doesn&#8217;t make much sense for
-multi-paragraph descriptions, the default behaviour with <span
-class="cmss-10">glossaries-extra</span><a
- id="dx1-6020"></a>&#8217;s
-<span
-class="cmtt-10">\longnewglossaryentry </span>is to simply leave the plural description unset
-unless explicitly set using the <span
-class="cmss-10">descriptionplural</span><a
- id="dx1-6021"></a> key. The <span
-class="cmss-10">glossaries.sty </span>version
-of this command sets the description&#8217;s plural form to the same as the
-singular.<span class="footnote-mark"><a
-href="#fn1x2" id="fn1x2-bk"><sup class="textsuperscript">2.1</sup></a></span><a
- id="x1-6022f1"></a>
-</p><!--l. 1401--><p class="indent" > Note that this modified unstarred version doesn&#8217;t append <span
-class="cmtt-10">\glsxtrpostlongdescription</span>
-to the description&#8217;s plural form.
-</p><!--l. 1404--><p class="indent" > The <span
-class="cmtt-10">\newterm</span><a
- id="dx1-6028"></a> command (defined through the <a
-href="#styopt.index"><span
-class="cmss-10">index</span></a><a
- id="dx1-6029"></a> package option) is modified
-so that the category defaults to <span
-class="cmss-10">index</span><a
- id="dx1-6030"></a>. The <span
-class="cmtt-10">\newacronym</span><a
- id="dx1-6031"></a> command is modified to use
-the new abbreviation interface provided by <span
-class="cmss-10">glossaries-extra</span>. (See <a
-href="#sec:abbreviations"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">4</span>
-</a><a
-href="#sec:abbreviations">Abbreviations<!--tex4ht:ref: sec:abbreviations --></a>.)
-</p><!--l. 1410--><p class="indent" > The <span
-class="cmtt-10">\makeglossaries </span>command now has an optional argument.
-</p><!--l. 1411--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-6032"></a> <span
-class="cmtt-10">\makeglossaries[</span>&#x27E8;<span
-class="cmitt-10">list</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 1413--><p class="noindent" >
-If &#x27E8;<span
-class="cmti-10">list</span>&#x27E9; is empty, <span
-class="cmtt-10">\makeglossaries </span>behaves as per its original definition in the
-<span
-class="cmss-10">glossaries </span>package, otherwise &#x27E8;<span
-class="cmti-10">list</span>&#x27E9; can be a comma-separated list of glossaries that
-need processing with an external indexing application.
-</p><!--l. 1419--><p class="indent" > This command is not permitted with the <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=only</span><a
- id="dx1-6033"></a> package option. Without
-the optional argument, it&#8217;s required with <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=hybrid</span><a
- id="dx1-6034"></a>. With the optional argument,
-it&#8217;s only permitted with the default <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=off</span><a
- id="dx1-6035"></a>.
-</p><!--l. 1424--><p class="indent" > It should then be possible to use <span
-class="cmtt-10">\printglossary </span>for those glossaries listed in &#x27E8;<span
-class="cmti-10">list</span>&#x27E9;
-and <span
-class="cmtt-10">\printnoidxglossary </span>for the other glossaries. (See the accompanying file
-<span
-class="cmtt-10">sample-mixedsort.tex </span>for an example.)
-</p><!--l. 1429--><p class="indent" > <div class="important" title="Important Note"> If you use the optional argument &#x27E8;<span
-class="cmti-10">list</span>&#x27E9;, you can&#8217;t define entries in the document
-(even with the <a
-href="#styopt.docdef"><span
-class="cmss-10">docdef</span></a><a
- id="dx1-6036"></a> option). </div>
-</p><!--l. 1432--><p class="noindent" >
-</p><!--l. 1434--><p class="indent" > You will need at least version 2.20 of <a
- id="dx1-6037"></a><a
-href="#glo:makeglossaries"><span
-class="cmtt-10">makeglossaries</span></a> or at least version 1.3 of
-the Lua alternative <a
- id="dx1-6038"></a><a
-href="#glo:makeglossaries-lite.lua"><span
-class="cmtt-10">makeglossaries-lite</span><a
- id="dx1-6039"></a></a> (both distributed with <span
-class="cmss-10">glossaries </span>v4.27) to
-allow for this use of <span
-class="cmtt-10">\makeglossaries[</span>&#x27E8;<span
-class="cmti-10">list</span>&#x27E9;<span
-class="cmtt-10">]</span>. Alternatively, use the <a
-href="#styopt.automake"><span
-class="cmss-10">automake</span></a><a
- id="dx1-6040"></a>
-option.
-</p><!--l. 1440--><p class="noindent" >
-</p>
-
-
-
-<!--l. 1440--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.2 </span> <a
- id="sec:wrglossary"></a>Entry Indexing</h3>
-<!--l. 1443--><p class="noindent" >As from version 1.31, there is a new command like <span
-class="cmtt-10">\glsadd </span>where the mandatory
-argument is a comma-separated list of labels:
-</p><!--l. 1446--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-7001"></a> <span
-class="cmtt-10">\glsaddeach[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">list</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 1448--><p class="noindent" >
-This simply iterates over &#x27E8;<span
-class="cmti-10">list</span>&#x27E9; and does <span
-class="cmtt-10">\glsadd[</span>&#x27E8;<span
-class="cmti-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span>for each entry in the
-list.
-</p><!--l. 1452--><p class="indent" > As from version 1.37, you can make commands like <span
-class="cmtt-10">\gls </span>or <span
-class="cmtt-10">\glslink</span>
-automatically use <span
-class="cmtt-10">\glsadd </span>with specific options when a given format is used
-(identified with <span
-class="cmtt-10">format={</span>&#x27E8;<span
-class="cmitt-10">format</span>&#x27E9;<span
-class="cmtt-10">} </span>in the optional argument of the corresponding
-<span
-class="cmtt-10">\gls</span>, <span
-class="cmtt-10">\glslink </span>etc).
-</p><!--l. 1457--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-7002"></a> <span
-class="cmtt-10">\GlsXtrAutoAddOnFormat[</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">format list</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">glsadd options</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 1459--><p class="noindent" >
-The optional argument &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; defaults to <span
-class="cmtt-10">\glslabel </span>and indicates the label to use in
-<span
-class="cmtt-10">\glsadd </span>and so needs to be expandable. The &#x27E8;<span
-class="cmti-10">format list</span>&#x27E9; is a comma-separated list of
-format values that will trigger the automated adding. The &#x27E8;<span
-class="cmti-10">glsadd options</span>&#x27E9; are
-the options to pass to <span
-class="cmtt-10">\glsadd </span>with <span
-class="cmtt-10">format={</span>&#x27E8;<span
-class="cmitt-10">format</span>&#x27E9;<span
-class="cmtt-10">} </span>prepended to the
-list.
-</p><!--l. 1467--><p class="indent" > For example, with:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-33">
-\GlsXtrAutoAddOnFormat{hyperbf}{counter=chapter}
-</pre>
-<!--l. 1470--><p class="nopar" > then <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls[format=hyperbf]{sample}</span></span></span> will be equivalent to
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-34">
-\glsadd[format=hyperbf,counter=chapter]{sample}\gls[format=hyperbf]{sample}
-</pre>
-<!--l. 1474--><p class="nopar" > Note that the explicit range markers will prevent a match unless you include
-them in &#x27E8;<span
-class="cmti-10">format list</span>&#x27E9; (in which case, be sure to add both the start and end
-formats).
-</p><!--l. 1479--><p class="indent" > Here&#8217;s another example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-35">
-\GlsXtrAutoAddOnFormat[dual.\glslabel]{hyperbf}{}
-</pre>
-<!--l. 1482--><p class="nopar" > In this case <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls[format=hyperbf]{sample}</span></span></span> will now be equivalent to:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-36">
-\glsadd[format=hyperbf]{dual.sample}\gls[format=hyperbf]{sample}
-</pre>
-<!--l. 1487--><p class="nopar" >
-</p><!--l. 1489--><p class="indent" > <div class="important" title="Important Note"> <span
-class="cmtt-10">\GlsXtrAutoAddOnFormat </span>is not applied to <span
-class="cmtt-10">\glsadd </span>as it could cause an infinite
-loop. </div>
-</p><!--l. 1492--><p class="noindent" >
-</p><!--l. 1494--><p class="indent" > The <span
-class="cmss-10">glossaries-extra </span>package provides extra keys for commands like <span
-class="cmtt-10">\gls </span>and
-<span
-class="cmtt-10">\glstext</span>:
- </p><dl class="description"><dt class="description">
-<span
-class="cmssbx-10">noindex</span><a
- id="dx1-7003"></a> </dt><dd
-class="description">This is a boolean key. If true, this suppresses the indexing. (That is,
- it prevents <span
-class="cmtt-10">\gls </span>or whatever from adding a line to the external glossary
- file.) This is more useful than the <a
-href="#styopt.indexonlyfirst"><span
-class="cmss-10">indexonlyfirst</span></a><a
- id="dx1-7004"></a> package option provided
- by <span
-class="cmss-10">glossaries</span>, as the <a
- id="dx1-7005"></a><a
-href="#glo:firstuse">first use</a> might not be the most pertinent use. (If you
- want to apply <a
-href="#styopt.indexonlyfirst"><span
-class="cmss-10">indexonlyfirst</span></a><a
- id="dx1-7006"></a> to selected entries, rather than all of them,
- you can use the <a
-href="#catattr.indexonlyfirst"><span
-class="cmss-10">indexonlyfirst</span></a><a
- id="dx1-7007"></a> attribute, see <a
-href="#sec:categories"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">7</span> </a><a
-href="#sec:categories">Categories<!--tex4ht:ref: sec:categories --></a>
- for further details.) Note that the <span
-class="cmss-10">noindex</span><a
- id="dx1-7008"></a> key isn&#8217;t available for <span
-class="cmtt-10">\glsadd</span><a
- id="dx1-7009"></a>
- (and <span
-class="cmtt-10">\glsaddall</span><a
- id="dx1-7010"></a>) since the whole purpose of that command is to index
- an entry.
- </dd><dt class="description">
-<span
-class="cmssbx-10">wrgloss</span><a
- id="dx1-7011"></a> </dt><dd
-class="description">(New to v1.14.) This is may only take the values <span
-class="cmss-10">before </span>or <span
-class="cmss-10">after</span>. By
- default, commands that both index and display link text (such as <span
-class="cmtt-10">\gls</span>,
- <span
-class="cmtt-10">\glstext </span>and <span
-class="cmtt-10">\glslink</span>), perform the indexing before the link text as the
- indexing creates a whatsit that can cause problems if it occurs after the
- link text. However, it may be that in some cases (such as long phrases) you
- may actually want the indexing performed after the link text. In this case
- you can use <span
-class="cmtt-10">wrgloss=after </span>for specific instances. Note that this option
- doesn&#8217;t have an effect if the indexing has been suppressed through other
- settings (such as <span
-class="cmss-10">noindex</span><a
- id="dx1-7012"></a>).
- <!--l. 1524--><p class="noindent" >The default value is set up using
- </p><!--l. 1525--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-7013"></a> <span
-class="cmtt-10">\glsxtrinitwrgloss </span></div><hr>
- </p><!--l. 1527--><p class="noindent" >
- which is defined as:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-37">
- \newcommand*{\glsxtrinitwrgloss}{%
- &#x00A0;\glsifattribute{\glslabel}{wrgloss}{after}%
- &#x00A0;{%
- &#x00A0;&#x00A0;&#x00A0;\glsxtrinitwrglossbeforefalse
- &#x00A0;}%
- &#x00A0;{%
- &#x00A0;&#x00A0;&#x00A0;\glsxtrinitwrglossbeforetrue
- &#x00A0;}%
- }
-</pre>
- <!--l. 1539--><p class="nopar" > This sets the conditional
- </p><!--l. 1542--><p class="noindent" ><hr><div title="Definition"><span
-class="cmtt-10">\ifglsxtrinitwrgloss</span><a
- id="dx1-7014"></a> </div><hr>
- </p><!--l. 1543--><p class="noindent" >
- which is used to determine where to perform the indexing.
- </p><!--l. 1546--><p class="noindent" >This means you can set the <a
-href="#catattr.wrgloss"><span
-class="cmss-10">wrgloss</span></a><a
- id="dx1-7015"></a> attribute to <span
-class="cmss-10">after </span>to automatically use this
- as the default for entries with that category attribute. (Note that adding
- <span
-class="cmss-10">wrgloss</span><a
- id="dx1-7016"></a> to the default options in <span
-class="cmtt-10">\GlsXtrSetDefaultGlsOpts</span><a
- id="dx1-7017"></a> will override
- <span
-class="cmtt-10">\glsxtrinitwrgloss</span>.)
- </p></dd><dt class="description">
-<span
-class="cmssbx-10">hyperoutside</span><a
- id="dx1-7018"></a> </dt><dd
-class="description">(New to v1.21.) This is a boolean key. The default is <span
-class="cmtt-10">hyperoutside=true</span>,
- which puts the hyperlink outside <span
-class="cmtt-10">\glstextformat</span>, so that commands like <span
-class="cmtt-10">\gls</span>
- will effectively do <div class="alltt">
- <div class="obeylines-v">
- <span
-class="cmtt-10">\hyperlink{</span>&#x27E8;<span
-class="cmitt-10">target</span>&#x27E9;<span
-class="cmtt-10">}</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">\glstextformat{</span>&#x27E8;<span
-class="cmitt-10">link</span><span
-class="cmitt-10">&#x00A0;text</span>&#x27E9;<span
-class="cmtt-10">}</span><span
-class="cmsy-10">}</span>
-</div>
- </div> This is the same behaviour as with the base <span
-class="cmss-10">glossaries </span>package. With
- <span
-class="cmtt-10">hyperoutside=false</span>, <span
-class="cmtt-10">\hyperlink </span>is placed inside the argument of
- <span
-class="cmtt-10">\glstextformat</span>: <div class="alltt">
- <div class="obeylines-v">
- <span
-class="cmtt-10">\glstextformat</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">\hyperlink{</span>&#x27E8;<span
-class="cmitt-10">target</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">link</span><span
-class="cmitt-10">&#x00A0;text</span>&#x27E9;<span
-class="cmtt-10">}</span><span
-class="cmsy-10">}</span>
-</div>
- </div> You can use the <a
-href="#catattr.hyperoutside"><span
-class="cmss-10">hyperoutside</span></a><a
- id="dx1-7019"></a> category attribute to set the default for a
- given category. This can be combined with the use of the <a
-href="#catattr.textformat"><span
-class="cmss-10">textformat</span></a><a
- id="dx1-7020"></a>
- attribute to counteract any interference caused by <span
-class="cmtt-10">\hyperlink</span>. For
- example:
-
-
-
- <pre class="verbatim" id="verbatim-38">
- \glssetcategoryattribute{mathrelation}{hyperoutside}{false}
-</pre>
- <!--l. 1573--><p class="nopar" > will set <span
-class="cmtt-10">hyperoutside=false </span>for all entries that are assigned to the category
- <span
-class="cmtt-10">mathrelation </span>and
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-39">
- \glssetcategoryattribute{mathrelation}{textformat}{mathrel}
-</pre>
- <!--l. 1578--><p class="nopar" > will use <span
-class="cmtt-10">\mathrel </span>instead of <span
-class="cmtt-10">\glstextformat </span>resulting in: </p><div class="alltt">
- <div class="obeylines-v">
- <span
-class="cmtt-10">\mathrel</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">\hyperlink{</span>&#x27E8;<span
-class="cmitt-10">target</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">link</span><span
-class="cmitt-10">&#x00A0;text</span>&#x27E9;<span
-class="cmtt-10">}</span><span
-class="cmsy-10">}</span>
-</div>
- </div> for entries with the <span
-class="cmss-10">category</span><a
- id="dx1-7021"></a> key set to <span
-class="cmtt-10">mathrelation</span>.
- </dd><dt class="description">
-<span
-class="cmssbx-10">textformat</span><a
- id="dx1-7022"></a> </dt><dd
-class="description">This key must have a control sequence name as its value. The command
- formed from this name must exist and must take one argument. (Use <span
-class="cmtt-10">relax </span>for
- default behaviour.) If set, this overrides the <a
-href="#catattr.textformat"><span
-class="cmss-10">textformat</span></a><a
- id="dx1-7023"></a> attribute and
- <span
-class="cmtt-10">\glstextformat</span>. See the <span
-class="cmss-10">soul</span><a
- id="dx1-7024"></a> example in <a
-href="#sec:glsunset"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.6</span> </a><a
-href="#sec:glsunset">First Use
- Flag<!--tex4ht:ref: sec:glsunset --></a>.
- </dd><dt class="description">
-<span
-class="cmssbx-10">prefix</span><a
- id="dx1-7025"></a> </dt><dd
-class="description">Locally redefines <span
-class="cmtt-10">\glolinkprefix</span><a
- id="dx1-7026"></a> to the given value. It should match the
- prefix for the desired glossary.
- </dd><dt class="description">
-<span
-class="cmssbx-10">thevalue</span><a
- id="dx1-7027"></a> </dt><dd
-class="description">Explicitly set the location to this value (see below).
- </dd><dt class="description">
-<span
-class="cmssbx-10">theHvalue</span><a
- id="dx1-7028"></a> </dt><dd
-class="description">Set the corresponding hyperlink location (see below).
- </dd></dl>
-<!--l. 1605--><p class="indent" > You can set the default options used by <span
-class="cmtt-10">\glslink</span><a
- id="dx1-7029"></a>, <span
-class="cmtt-10">\gls</span><a
- id="dx1-7030"></a> etc with:
-</p><!--l. 1607--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-7031"></a> <span
-class="cmtt-10">\GlsXtrSetDefaultGlsOpts{</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 1609--><p class="noindent" >
-For example, if you mostly don&#8217;t want to index entries then you can do:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-40">
-\GlsXtrSetDefaultGlsOpts{noindex}
-</pre>
-<!--l. 1614--><p class="nopar" > and then use, for example, <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls[noindex=false]{sample}</span></span></span> when you actually want
-the location added to the <a
- id="dx1-7032"></a><a
-href="#glo:numberlist">number list</a>. These defaults may be overridden by other
-settings (such as category attributes) in addition to any settings passed in the option
-argument of commands like <span
-class="cmtt-10">\glslink </span>and <span
-class="cmtt-10">\gls</span>.
-</p><!--l. 1621--><p class="indent" > Note that if you don&#8217;t want <span
-class="cmti-10">any </span>indexing, just omit <span
-class="cmtt-10">\makeglossaries </span>and
-<span
-class="cmtt-10">\printglossaries </span>(or analogous commands). If you want to adjust the
-default for <span
-class="cmss-10">wrgloss</span><a
- id="dx1-7033"></a>, it&#8217;s better to do this by redefining <span
-class="cmtt-10">\glsxtrinitwrgloss</span><a
- id="dx1-7034"></a>
-instead.
-</p><!--l. 1627--><p class="indent" > <div class="important" title="Important Note"> <span
-class="cmtt-10">\GlsXtrSetDefaultGlsOpts </span>doesn&#8217;t affect <span
-class="cmtt-10">\glsadd</span>. </div>
-</p><!--l. 1629--><p class="noindent" >
-</p><!--l. 1631--><p class="indent" > If you want to change the default value of <span
-class="cmss-10">format</span><a
- id="dx1-7035"></a>, you can instead use:
-</p><!--l. 1633--><p class="indent" > <hr><div title="Definition"> <span
-class="cmtt-10">\GlsXtrSetDefaultNumberFormat{</span>&#x27E8;<span
-class="cmti-10">format</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 1635--><p class="noindent" >
-This has the advantage of also working for <span
-class="cmtt-10">\glsadd</span>. For example, if you
-want all locations in the back matter to appear in italic (unless explicitly
-overridden):
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-41">
-\backmatter
-\GlsXtrSetDefaultNumberFormat{hyperit}
-</pre>
-<!--l. 1642--><p class="nopar" >
-</p><!--l. 1644--><p class="indent" > Commands like <span
-class="cmtt-10">\gls</span><a
- id="dx1-7036"></a> have star (<span
-class="cmtt-10">*</span>) and plus (<span
-class="cmtt-10">+</span>) modifiers as a short cut for
-<span
-class="cmtt-10">hyper=false </span>and <span
-class="cmtt-10">hyper=true</span>. The <span
-class="cmss-10">glossaries-extra </span>package provides a way to add a
-third modifier, if required, using
-</p><!--l. 1648--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-7037"></a> <span
-class="cmtt-10">\GlsXtrSetAltModifier{</span>&#x27E8;<span
-class="cmitt-10">char</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 1650--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">char</span>&#x27E9; is the character used as the modifier and &#x27E8;<span
-class="cmti-10">options</span>&#x27E9; is the default set of
-options (which may be overridden). Note that &#x27E8;<span
-class="cmti-10">char</span>&#x27E9; must be a single character (not a
-UTF-8 character, unless you are using <span class="HoLogo-XeLaTeX"><span class="HoLogo-Xe">X<span class="HoLogo-e">&#x018e;</span></span><span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span></span>&#x00A0;or Lua<span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span>).
-</p><!--l. 1657--><p class="indent" > <div class="important" title="Important Note"> When choosing the character &#x27E8;<span
-class="cmti-10">char</span>&#x27E9; take care of any changes in category code.
-</div>
-</p><!--l. 1660--><p class="noindent" >
-</p><!--l. 1662--><p class="indent" > Example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-42">
-\GlsXtrSetAltModifier{!}{noindex}
-</pre>
-<!--l. 1665--><p class="nopar" > This means that <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls!{sample}</span></span></span> will be equivalent to <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls[noindex]{sample}</span></span></span>. It&#8217;s
-not possible to mix modifiers. For example, if you want to do
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-43">
-\gls[noindex,hyper=false]{sample}
-</pre>
-<!--l. 1671--><p class="nopar" > you can use <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls*[noindex]{sample}</span></span></span> or <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls![hyper=false]{sample}</span></span></span> but you
-can&#8217;t combine the <span
-class="cmtt-10">* </span>and <span
-class="cmtt-10">! </span>modifiers.
-</p><!--l. 1676--><p class="indent" > There is a new hook that&#8217;s used each time indexing information is written to the
-external glossary files:
-</p><!--l. 1678--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-7038"></a> <span
-class="cmtt-10">\glsxtrdowrglossaryhook{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 1680--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; is the entry&#8217;s label. This does nothing by default but may be redefined.
-(See, for example, the accompanying sample file <span
-class="cmtt-10">sample-indexhook.tex</span>, which uses
-this hook to determine which entries haven&#8217;t been indexed.)
-</p><!--l. 1687--><p class="indent" > There&#8217;s also a new hook (from v1.26) that&#8217;s used immediately before the options
-are set by the <span
-class="cmtt-10">\gls</span>-like and <span
-class="cmtt-10">\glstext</span>-like commands:
-</p><!--l. 1690--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-7039"></a> <span
-class="cmtt-10">\glslinkpresetkeys </span></div><hr>
-</p><!--l. 1692--><p class="noindent" >
-(The base package provides <span
-class="cmtt-10">\glslinkpostsetkeys</span><a
- id="dx1-7040"></a> that&#8217;s used immediately after the
-options are set.)
-</p><!--l. 1696--><p class="indent" > As from version 1.30 there are also similar hooks for <span
-class="cmtt-10">\glsadd</span>:
-</p><!--l. 1697--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-7041"></a> <span
-class="cmtt-10">\glsaddpresetkeys </span></div><hr>
-</p><!--l. 1699--><p class="noindent" >
-and
-</p><!--l. 1701--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-7042"></a> <span
-class="cmtt-10">\glsaddpostsetkeys </span></div><hr>
-</p><!--l. 1703--><p class="noindent" >
-For example, to default to using the <span
-class="cmss-10">equation</span><a
- id="dx1-7043"></a> counter in maths mode:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-44">
-\renewcommand{\glslinkpresetkeys}{%
-&#x00A0;\ifmmode&#x00A0;\setkeys{glslink}{counter=equation}\fi}
-\renewcommand{\glsaddpresetkeys}{%
-&#x00A0;\ifmmode&#x00A0;\setkeys{glossadd}{counter=equation}\fi}
-</pre>
-<!--l. 1711--><p class="nopar" > In this case, the counter can be overridden with an explicit use of <span
-class="cmss-10">counter</span><a
- id="dx1-7044"></a> in the
-optional argument of <span
-class="cmtt-10">\gls </span>or <span
-class="cmtt-10">\glsadd</span>. (As from version 1.37, a simpler method is to
-just use the <a
-href="#styopt.equations"><span
-class="cmss-10">equations</span></a><a
- id="dx1-7045"></a> package option.)
-</p><!--l. 1717--><p class="indent" > Alternatively, to enforce this (overriding the option argument):
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-45">
-\renewcommand{\glslinkpostsetkeys}{%
-&#x00A0;\ifmmode&#x00A0;\setkeys{glslink}{counter=equation}\fi}
-\renewcommand{\glsaddpostsetkeys}{%
-&#x00A0;\ifmmode&#x00A0;\setkeys{glossadd}{counter=equation}\fi}
-</pre>
-<!--l. 1724--><p class="nopar" >
-</p><!--l. 1726--><p class="indent" > As from version 1.14, there are two new keys for <span
-class="cmtt-10">\glsadd</span>: <span
-class="cmss-10">thevalue</span><a
- id="dx1-7046"></a> and <span
-class="cmss-10">theHvalue</span><a
- id="dx1-7047"></a>.
-These keys are designed for manually adding explicit locations rather than obtaining
-the value from the associated counter. As from version 1.19, these two keys are also
-available for commands like <span
-class="cmtt-10">\gls </span>and <span
-class="cmtt-10">\glslink</span>. The <span
-class="cmss-10">thevalue</span><a
- id="dx1-7048"></a> keys is intended
-primarily for adding locations in supplementary material that can&#8217;t be obtained from
-a counter.
-</p><!--l. 1735--><p class="indent" > The principle key <span
-class="cmss-10">thevalue</span><a
- id="dx1-7049"></a> is for the location value. The other key <span
-class="cmss-10">theHvalue</span><a
- id="dx1-7050"></a> can
-be used to extract a prefix value for the first argument of commands like
-<span
-class="cmtt-10">\glsnoidxdisplayloc</span><a
- id="dx1-7051"></a>. Its value must be in the format &#x27E8;<span
-class="cmti-10">prefix</span>&#x27E9;&#x27E8;<span
-class="cmti-10">location</span>&#x27E9;. In general,
-there&#8217;s little need for this key as the prefix is typically associated with a counter that
-can be used to form hypertargets.
-</p><!--l. 1743--><p class="indent" > <div class="important" title="Important Note"> If you use <span
-class="cmss-10">thevalue</span><a
- id="dx1-7052"></a>, you must make sure that you use an indexing application
-that will accept the given value. </div>
-</p><!--l. 1746--><p class="noindent" >
-</p><!--l. 1748--><p class="indent" > For example, <span
-class="cmtt-10">makeindex</span><a
- id="dx1-7053"></a> will only accept locations in the form [&#x27E8;<span
-class="cmti-10">num</span>&#x27E9;&#x27E8;<span
-class="cmti-10">sep</span>&#x27E9;]*&#x27E8;<span
-class="cmti-10">num</span>&#x27E9;
-where &#x27E8;<span
-class="cmti-10">num</span>&#x27E9; is an arabic number (0, 1, &#x2026;), roman numeral (i, ii, &#x2026;&#x00A0;or I, II, &#x2026;) or a
-character from a, &#x2026;, z or A, &#x2026;, Z, and [&#x27E8;<span
-class="cmti-10">num</span>&#x27E9;&#x27E8;<span
-class="cmti-10">sep</span>&#x27E9;]* indicates zero or more
-instances of a number followed by the recognised separator character (set
-with <span
-class="cmtt-10">\glsSetCompositor</span>). This means that <span
-class="cmtt-10">makeindex</span><a
- id="dx1-7054"></a> won&#8217;t accept, for
-example,
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-46">
-\glsadd[thevalue={Supplementary&#x00A0;Material}]{sample}
-</pre>
-<!--l. 1758--><p class="nopar" > This location value will be accepted by <a
- id="dx1-7055"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a>, since it will allow any location and
-will only try forming ranges if the location matches any of its numerical patterns.
-In the case of <span
-class="cmtt-10">xindy</span><a
- id="dx1-7056"></a>, you&#8217;ll need to add a rule that can match the value.
-If you&#8217;re using <span
-class="cmss-10">hyperref</span><a
- id="dx1-7057"></a>, you may need to use the <span
-class="cmss-10">format</span><a
- id="dx1-7058"></a> key to prevent a
-hyperlink if one can&#8217;t naturally be formed from the prefix, counter and location
-value.
-</p><!--l. 1767--><p class="indent" > For example, suppose the file <span
-class="cmtt-10">suppl.tex </span>contains:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-47">
-\documentclass{article}
-\usepackage{glossaries-extra}
-\newglossaryentry{sample}{name={sample},description={an&#x00A0;example}}
-\renewcommand{\thepage}{S.\arabic{page}}
-\begin{document}
-First&#x00A0;page.
-\newpage
-\gls{sample}.
-\end{document}
-</pre>
-<!--l. 1782--><p class="nopar" > This has an entry on page S.2. Suppose another document wants to include this
-location in the glossary. Then this can be done by setting <span
-class="cmss-10">thevalue</span><a
- id="dx1-7059"></a> to <span
-class="cmtt-10">S.2</span>. For
-example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-48">
-\documentclass{article}
-\usepackage{glossaries-extra}
-\makeglossaries
-\newglossaryentry{sample}{name={sample},description={an&#x00A0;example}}
-\begin{document}
-Some&#x00A0;\gls{sample}&#x00A0;text.
-\printglossaries
-\glsadd[thevalue={S.2}]{sample}
-\end{document}
-</pre>
-<!--l. 1801--><p class="nopar" > This location value will be accepted by <span
-class="cmtt-10">makeindex</span><a
- id="dx1-7060"></a> as it&#8217;s in the form &#x27E8;<span
-class="cmti-10">num</span>&#x27E9;&#x27E8;<span
-class="cmti-10">sep</span>&#x27E9;&#x27E8;<span
-class="cmti-10">num</span>&#x27E9;.
-</p><!--l. 1805--><p class="indent" > If you want hyperlinks, things are more complicated. First you need to set the
-<a
-href="#catattr.externallocation"><span
-class="cmss-10">externallocation</span></a><a
- id="dx1-7061"></a> attribute to the location of the PDF file. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-49">
-\glssetcategoryattribute{supplemental}{externallocation}{suppl.pdf}
-\newglossaryentry{sample}{category=supplemental,
-&#x00A0;name={sample},description={an&#x00A0;example}}
-</pre>
-<!--l. 1813--><p class="nopar" > Next you need to add <span
-class="cmtt-10">glsxtrsupphypernumber </span>as the format:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-50">
-\glsadd[thevalue={S.2},format=glsxtrsupphypernumber]{sample}
-</pre>
-<!--l. 1817--><p class="nopar" > Both documents will need to use the <span
-class="cmss-10">hyperref</span><a
- id="dx1-7062"></a> package. Remember that the counter
-used for the location also needs to match. If <span
-class="cmtt-10">\theH</span>&#x27E8;<span
-class="cmti-10">counter</span>&#x27E9; is defined in the other
-document and doesn&#8217;t match in the referencing document, then you need to use
-<span
-class="cmss-10">theHvalue</span><a
- id="dx1-7063"></a> to set the appropriate value. See the accompanying sample files
-<span
-class="cmtt-10">sample-suppl-hyp.tex </span>and <span
-class="cmtt-10">sample-suppl-main-hyp.tex </span>for an example that uses
-<span
-class="cmss-10">hyperref</span><a
- id="dx1-7064"></a>.
-</p><!--l. 1827--><p class="indent" > <div class="important" title="Important Note"> The hyperlink for the supplementary location may or <span
-class="cmti-10">may not </span>take you to the
-relevant place in the external PDF file <span
-class="cmti-10">depending on your PDF viewer</span>. Some may not
-support external links, and some may take you to the first page or last visited page.
-</div>
-</p><!--l. 1832--><p class="noindent" >
-</p><!--l. 1834--><p class="indent" > For example, if both <span
-class="cmtt-10">sample-suppl-hyp.pdf </span>and <span
-class="cmtt-10">sample-suppl-main-hyp.pdf</span>
-are in the same directory, then viewing <span
-class="cmtt-10">sample-suppl-main-hyp.pdf </span>in Evince will
-take you to the correct location in the linked document (when you click on the S.2
-external link), but Okular will take you to the top of the first page of the linked
-document.
-</p><!--l. 1841--><p class="indent" > This method can only be used where there is one external source for the
-designated category (identified by the <a
-href="#catattr.externallocation"><span
-class="cmss-10">externallocation</span></a><a
- id="dx1-7065"></a> attribute). For multiple
-sources, you need to use <a
- id="dx1-7066"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> version 1.7+, which is the better method in
-general as it can automatically fetch the relevant locations from the <span
-class="cmtt-10">.aux </span>files
-of the designated external documents without the need to explicitly use
-<span
-class="cmtt-10">\glsadd</span>.
-</p><!--l. 1849--><p class="noindent" >
-</p>
-<!--l. 1849--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.3 </span> <a
- id="sec:see"></a>Cross-References (&#8220;see&#8221; and &#8220;see also&#8221;)</h3>
-<!--l. 1852--><p class="noindent" >The value of the <span
-class="cmss-10">see</span><a
- id="dx1-8001"></a> key is now saved as a field. This isn&#8217;t the case with
-<span
-class="cmss-10">glossaries</span>, where the <span
-class="cmss-10">see</span><a
- id="dx1-8002"></a> value is simply used to directly write a line to the
-corresponding glossary file and is then discarded. This is why the <span
-class="cmss-10">see</span><a
- id="dx1-8003"></a> key
-can&#8217;t be used before <span
-class="cmtt-10">\makeglossaries</span><a
- id="dx1-8004"></a> (since the file hasn&#8217;t been opened
-yet).
-</p><!--l. 1860--><p class="indent" > This modification allows <span
-class="cmss-10">glossaries-extra </span>to provide
-</p><!--l. 1861--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-8005"></a> <span
-class="cmtt-10">\glsxtraddallcrossrefs </span></div><hr>
-</p><!--l. 1863--><p class="noindent" >
-which is used at the end of the document to automatically add any unused
-cross-references unless the package option <a
-href="#styopt.indexcrossrefs"><span
-class="cmss-10">indexcrossrefs</span></a><a
- id="dx1-8006"></a> was set to false.
-
-
-
-</p><!--l. 1868--><p class="indent" > Note that even though the <span
-class="cmss-10">see</span><a
- id="dx1-8007"></a> key will now work for entries defined in the
-<span
-class="cmss-10">document</span><a
- id="dx1-8008"></a><a
- id="dx1-8009"></a> environment, it&#8217;s still best to define entries in the preamble, and
-the <span
-class="cmss-10">see</span><a
- id="dx1-8010"></a> key still can&#8217;t perform any indexing before the file has been opened
-by <span
-class="cmtt-10">\makeglossaries</span>. Note that <span
-class="cmss-10">glossaries </span>v4.24 introduced the <a
-href="#styopt.seenoindex"><span
-class="cmss-10">seenoindex</span></a><a
- id="dx1-8011"></a>
-package option, which can be used to suppress the error when the <span
-class="cmss-10">see</span><a
- id="dx1-8012"></a> key
-is used before <span
-class="cmtt-10">\makeglossaries</span>, so <a
-href="#styopt.seenoindex"><span
-class="cmss-10">seenoindex</span></a><span
-class="cmss-10">=ignore</span><a
- id="dx1-8013"></a> will allow the <span
-class="cmss-10">see</span><a
- id="dx1-8014"></a>
-value to be stored even though it may not be possible to index it at that
-point.
-</p><!--l. 1879--><p class="indent" > As from version 1.06, you can display the cross-referenced information for a given
-entry using
-</p><!--l. 1881--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-8015"></a> <span
-class="cmtt-10">\glsxtrusesee{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 1883--><p class="noindent" >
-This internally uses
-</p><!--l. 1885--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-8016"></a> <span
-class="cmtt-10">\glsxtruseseeformat{</span>&#x27E8;<span
-class="cmitt-10">tag</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">xr list</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 1887--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">tag</span>&#x27E9; and &#x27E8;<span
-class="cmti-10">xr list</span>&#x27E9; are obtained from the value of the entry&#8217;s <span
-class="cmss-10">see</span><a
- id="dx1-8017"></a> field (if
-non-empty). By default, this just does <span
-class="cmtt-10">\glsseeformat[</span>&#x27E8;<span
-class="cmti-10">tag</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmti-10">xr list</span>&#x27E9;<span
-class="cmtt-10">}</span><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">{}</span></span></span>,
-which is how the cross-reference is displayed in the <a
- id="dx1-8018"></a><a
-href="#glo:numberlist">number list</a>. Note that
-<span
-class="cmtt-10">\glsxtrusesee </span>does nothing if the <span
-class="cmss-10">see</span><a
- id="dx1-8019"></a> field hasn&#8217;t been set for the entry given by
-&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;.
-</p><!--l. 1896--><p class="indent" > As with the base <span
-class="cmss-10">glossaries</span><a
- id="dx1-8020"></a> package, <span
-class="cmtt-10">\glsseeformat </span>is defined to do <span
-class="cmtt-10">\emph{</span>&#x27E8;<span
-class="cmitt-10">tag</span>&#x27E9;<span
-class="cmtt-10">}</span>
-<span
-class="cmtt-10">\glsseelist{</span>&#x27E8;<span
-class="cmitt-10">xr list</span>&#x27E9;<span
-class="cmtt-10">}</span>. The third argument is always ignored and is present for
-<span
-class="cmtt-10">makeindex</span><a
- id="dx1-8021"></a>, which always requires a final argument to encapsulate the associated
-location. The command
-</p><!--l. 1902--><p class="indent" > <hr><div title="Definition"><span
-class="cmtt-10">\glsseelist</span><a
- id="dx1-8022"></a><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">xr list</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 1903--><p class="noindent" >
-used to iterate over the list of cross-reference labels is also unchanged from
-the base <span
-class="cmss-10">glossaries</span><a
- id="dx1-8023"></a> package, with each item in the list formatted according
-to:
-</p><!--l. 1908--><p class="indent" > <hr><div title="Definition"><span
-class="cmtt-10">\glsseeitem</span><a
- id="dx1-8024"></a><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 1909--><p class="noindent" >
-This is defined by the <span
-class="cmss-10">glossaries</span><a
- id="dx1-8025"></a> package to: </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\glshyperlink[\glsseeitemformat{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div>
-</div> So the actual formatting for each cross-referenced entry is performed by
-<span
-class="cmtt-10">\glsseeitemformat</span><a
- id="dx1-8026"></a>, which is redefined by <span
-class="cmss-10">glossaries-extra</span><a
- id="dx1-8027"></a>, as described in
-<a
-href="#sec:modifications"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2</span> </a><a
-href="#sec:modifications">Modifications to Existing Commands and Styles<!--tex4ht:ref: sec:modifications --></a>. This now
-displays the value of the <span
-class="cmss-10">text</span><a
- id="dx1-8028"></a> field for abbreviations and the value of the <span
-class="cmss-10">name</span><a
- id="dx1-8029"></a> field
-otherwise. There&#8217;s no indication of the entry hierarchy, which could confuse
-the reader. Therefore, as from <span
-class="cmss-10">glossaries-extra</span><a
- id="dx1-8030"></a> v1.37, there are some new
-commands that include the hierarchical information. You may prefer to
-redefine <span
-class="cmtt-10">\glsseeitemformat </span>to use one of this if you have sub-entries. For
-example:
-
-
-
- <pre class="verbatim" id="verbatim-51">
-\renewcommand*{\glsseeitemformat}[1]{\glsxtrhiername{#1}}
-</pre>
-<!--l. 1927--><p class="nopar" >
-</p><!--l. 1929--><p class="indent" > The <span
-class="cmss-10">glossaries </span>package provides
-</p><!--l. 1930--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-8031"></a> <span
-class="cmtt-10">\glsseeitemformat{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 1932--><p class="noindent" >
-to format items in a cross-reference list (identified with the <span
-class="cmss-10">see</span><a
- id="dx1-8032"></a> key or <span
-class="cmtt-10">\glssee</span>). This
-was originally defined to use <span
-class="cmtt-10">\glsentryname{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span>since it makes more sense for the
-cross-reference to match the way the term appears in the glossary. Unfortunately this
-caused a problem when the <span
-class="cmss-10">name</span><a
- id="dx1-8033"></a> field was sanitized, which used to be the default
-setting, so <span
-class="cmss-10">glossaries </span>v3.0 changed the default definition of this command to
-use <span
-class="cmtt-10">\glsentrytext </span>instead. Since the <span
-class="cmss-10">name</span><a
- id="dx1-8034"></a> and <span
-class="cmss-10">text</span><a
- id="dx1-8035"></a> field are quite often
-the same, this change usually doesn&#8217;t have a noticeable effect. However,
-now that the <span
-class="cmss-10">name</span><a
- id="dx1-8036"></a> field is no longer sanitized (following the redesign of
-<span
-class="cmss-10">glossaries </span>v4.0) it makes more sense to restore this command to its original
-behaviour, but to take account of abbreviations <span
-class="cmss-10">glossaries-extra </span>redefines this
-as:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-52">
-\renewcommand*{\glsseeitemformat}[1]{%
-&#x00A0;\ifglshasshort{\glslabel}{\glsfmttext{#1}}{\glsfmtname{#1}}%
+ <!DOCTYPE html>
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta name="generator" content="TeX Parser Library">
+ <title>glossaries-extra.sty v1.49:
+an extension to the glossaries package</title>
+<style type="text/css">
+#main {margin-left: 5%; margin-right: 15%}
+div.tomain {position: absolute; left: 0pt; width: 5%; text-align: right; font-size: x-small;}
+div.tomain a {text-decoration: none;}
+div.labellink {display: inline; font-size: x-small; margin-left: 1em; margin-right: 1em;}
+div.marginleft {position: absolute; left: 0pt; width: 5%;}
+div.marginright {position: absolute; right: 0pt; width: 15%;}
+div.displaymath { display: block; text-align: center; }
+span.eqno { float: right; }
+div.table { display: block; text-align: center; }
+table.tabular-cm
+{
+ display: inline-table;
+ border-collapse: collapse;
+ align: center;
+ vertical-align: middle;
+}
+table.tabular-cb
+{
+ display: inline-table;
+ border-collapse: collapse;
+ align: center;
+ vertical-align: bottom;
+}
+table.tabular-ct
+{
+ display: inline-table;
+ border-collapse: collapse;
+ align: center;
+ vertical-align: top;
+}
+table.tabular-lm
+{
+ display: inline-table;
+ border-collapse: collapse;
+ align: left;
+ vertical-align: middle;
+}
+table.tabular-lb
+{
+ display: inline-table;
+ border-collapse: collapse;
+ align: left;
+ vertical-align: bottom;
+}
+table.tabular-lt
+{
+ display: inline-table;
+ border-collapse: collapse;
+ align: left;
+ vertical-align: top;
+}
+table.tabular-rm
+{
+ display: inline-table;
+ border-collapse: collapse;
+ align: right;
+ vertical-align: middle;
}
-</pre>
-<!--l. 1951--><p class="nopar" > (Note that as from <span
-class="cmss-10">glossaries-extra </span>version 1.42, this now uses <span
-class="cmtt-10">\glsfmttext </span>and
-<span
-class="cmtt-10">\glsfmtname </span>instead of just referencing the <span
-class="cmss-10">text</span><a
- id="dx1-8037"></a> and <span
-class="cmss-10">name</span><a
- id="dx1-8038"></a> fields. This helps to ensure
-that any formatting is correctly applied.)
-</p><!--l. 1957--><p class="indent" > If you want to restore the <span
-class="cmss-10">glossaries </span>v3.0+ definition just do:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-53">
-\renewcommand*{\glsseeitemformat}[1]{\glsentrytext{#1}}
-</pre>
-<!--l. 1960--><p class="nopar" >
-</p><!--l. 1962--><p class="indent" > The <span
-class="cmss-10">glossaries-extra</span><a
- id="dx1-8039"></a> package provides <span
-class="cmtt-10">\glsxtrhiername</span><a
- id="dx1-8040"></a> and its case-changing
-variants that may be used within the definition of <span
-class="cmtt-10">\glsseeitemformat </span>if required.
-These display the hierarchy for sub-entries rather than just the name, which may be
-more helpful in cross-references.
-</p><!--l. 1967--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-8041"></a> <span
-class="cmtt-10">\glsxtrhiername{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 1969--><p class="noindent" >
-performs a recursive action:
- </p><ol class="enumerate1" >
- <li
- class="enumerate" id="x1-8043x1">If the entry given by &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; has a parent, then <span
-class="cmtt-10">\glsxtrhiername{</span>&#x27E8;<span
-class="cmti-10">parent</span>
- <span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span>is done followed by <span
-class="cmtt-10">\glsxtrhiernamesep </span>then:
- </li>
- <li
- class="enumerate" id="x1-8045x2">If the entry given by &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; is an abbreviation (that is, it has the <span
-class="cmss-10">short</span><a
- id="dx1-8046"></a> field
- set) then the short form is displayed (using <span
-class="cmtt-10">\glsfmtshort</span>) otherwise the
- name is displayed (using <span
-class="cmtt-10">\glsfmtname</span>).</li></ol>
-<!--l. 1980--><p class="noindent" >The first step above is skipped if the entry doesn&#8217;t have a parent. Each level is separated
-by:
-</p><!--l. 1982--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-8047"></a> <span
-class="cmtt-10">\glsxtrhiernamesep </span></div><hr>
-</p><!--l. 1984--><p class="noindent" >
-which defaults to &#8220; <span
-class="cmmi-9">&#x22B3; </span>&#8221;. This can be redefined as appropriate.
-</p><!--l. 1988--><p class="indent" > There are some case-changing variants:
-</p><!--l. 1989--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-8048"></a> <span
-class="cmtt-10">\Glsxtrhiername{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 1991--><p class="noindent" >
-The top-level has the first letter changed to upper case (either <span
-class="cmtt-10">\Glsfmtshort </span>or
-<span
-class="cmtt-10">\Glsfmtname</span>). There&#8217;s no case-change for sub-entries.
-</p><!--l. 1996--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-8049"></a> <span
-class="cmtt-10">\GlsXtrhiername{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 1998--><p class="noindent" >
-All levels have the first letter changed to upper case (either <span
-class="cmtt-10">\Glsfmtshort </span>or
-<span
-class="cmtt-10">\Glsfmtname</span>).
-</p><!--l. 2002--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-8050"></a> <span
-class="cmtt-10">\GLSxtrhiername{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2004--><p class="noindent" >
-The top-level is converted to upper case (either <span
-class="cmtt-10">\GLSfmtshort </span>or <span
-class="cmtt-10">\GLSfmtname</span>).
-There&#8217;s no case-change for sub-entries.
-</p><!--l. 2009--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-8051"></a> <span
-class="cmtt-10">\GLSXTRhiername{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2011--><p class="noindent" >
-All levels are converted to upper case (either <span
-class="cmtt-10">\GLSfmtshort </span>or <span
-class="cmtt-10">\GLSfmtname</span>).
-
-
-
-</p><!--l. 2015--><p class="indent" > Suppose you want to suppress the <a
- id="dx1-8052"></a>number list using <a
-href="#styopt.nonumberlist"><span
-class="cmss-10">nonumberlist</span></a><a
- id="dx1-8053"></a>. This
-will automatically prevent the cross-references from being displayed. The
-<a
-href="#styopt.seeautonumberlist"><span
-class="cmss-10">seeautonumberlist</span></a><a
- id="dx1-8054"></a> package option will automatically enable the <a
- id="dx1-8055"></a>number list for entries
-that have the <span
-class="cmss-10">see</span><a
- id="dx1-8056"></a> key set, but this will also show the rest of the <a
- id="dx1-8057"></a>number
-list.
-</p><!--l. 2022--><p class="indent" > Another approach in this situation is to use the post description hook
-with <span
-class="cmtt-10">\glsxtrusesee </span>to append the cross-reference after the description. For
-example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-54">
-\renewcommand*{\glsxtrpostdescgeneral}{%
-&#x00A0;\ifglshasfield{see}{\glscurrententrylabel}
-&#x00A0;{,&#x00A0;\glsxtrusesee{\glscurrententrylabel}}%
-&#x00A0;{}%
+table.tabular-rb
+{
+ display: inline-table;
+ border-collapse: collapse;
+ align: right;
+ vertical-align: bottom;
}
-</pre>
-<!--l. 2031--><p class="nopar" > Now the cross-references can appear even though the <a
- id="dx1-8058"></a><a
-href="#glo:numberlist">number list</a> has been
-suppressed.
-</p><!--l. 2035--><p class="indent" > As from v1.16, there&#8217;s a separate <span
-class="cmss-10">seealso</span><a
- id="dx1-8059"></a> key. Unlike <span
-class="cmss-10">see</span><a
- id="dx1-8060"></a>, this doesn&#8217;t have an
-optional part for the textual tag. The syntax <span
-class="cmtt-10">seealso={</span>&#x27E8;<span
-class="cmitt-10">xr-labels</span>&#x27E9;<span
-class="cmtt-10">} </span>works in
-much the same way as using <span
-class="cmtt-10">see=[\seealsoname]{</span>&#x27E8;<span
-class="cmitt-10">xr-labels</span>&#x27E9;<span
-class="cmtt-10">} </span>but the
-information is stored in a separate field. If you need a different tag, use the <span
-class="cmss-10">see</span><a
- id="dx1-8061"></a> key
-instead (or redefine <span
-class="cmtt-10">\seealsoname </span>or <span
-class="cmtt-10">\glsxtruseseealsoformat</span>, described
-below).
-</p><!--l. 2043--><p class="indent" > You can display the formatted list of cross-references stored in the <span
-class="cmss-10">seealso</span><a
- id="dx1-8062"></a> key
-using:
-</p><!--l. 2045--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-8063"></a> <span
-class="cmtt-10">\glsxtruseseealso{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2047--><p class="noindent" >
-This works in much the same way as <span
-class="cmtt-10">\glsxtrusesee </span>but it internally uses
-</p><!--l. 2050--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-8064"></a> <span
-class="cmtt-10">\glsxtruseseealsoformat{</span>&#x27E8;<span
-class="cmitt-10">xr list</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2052--><p class="noindent" >
-For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-55">
-\renewcommand*{\glsxtrpostdescgeneral}{%
-&#x00A0;\ifglshasfield{see}{\glscurrententrylabel}
-&#x00A0;{,&#x00A0;\glsxtrusesee{\glscurrententrylabel}}%
-&#x00A0;{}%
-&#x00A0;\ifglshasfield{seealso}{\glscurrententrylabel}
-&#x00A0;{&#x00A0;(\glsxtruseseealso{\glscurrententrylabel})}%
-&#x00A0;{}%
+table.tabular-rt
+{
+ display: inline-table;
+ border-collapse: collapse;
+ align: right;
+ vertical-align: top;
}
-</pre>
-<!--l. 2063--><p class="nopar" >
-</p><!--l. 2065--><p class="indent" > The <span
-class="cmss-10">alias</span><a
- id="dx1-8065"></a> key only contains a single label not a list, but if you want to ensure
-consistent formatting with <span
-class="cmtt-10">\glsxtrusesee </span>and <span
-class="cmtt-10">\glsxtruseseealso </span>you can use
-(from v1.42):
-</p><!--l. 2068--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-8066"></a> <span
-class="cmtt-10">\glsxtrusealias{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2070--><p class="noindent" >
-</p><!--l. 2072--><p class="indent" > The actual unformatted comma-separated list &#x27E8;<span
-class="cmti-10">xr-list</span>&#x27E9; stored in the <span
-class="cmss-10">seealso</span><a
- id="dx1-8067"></a> field
-can be accessed with:
-</p><!--l. 2074--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-8068"></a> <span
-class="cmtt-10">\glsxtrseealsolabels{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2076--><p class="noindent" >
-This will just expand to the &#x27E8;<span
-class="cmti-10">xr-labels</span>&#x27E9; provided in the value of the <span
-class="cmss-10">seealso</span><a
- id="dx1-8069"></a> key. There&#8217;s
-no corresponding command to access the <span
-class="cmss-10">see</span><a
- id="dx1-8070"></a> field. If you really need to access it, you
-can use commands like <span
-class="cmtt-10">\glsxtrfielduse</span>, but remember that it may start with
-<span
-class="cmtt-10">[</span>&#x27E8;<span
-class="cmti-10">tag</span>&#x27E9;<span
-class="cmtt-10">]</span>, so it can&#8217;t be automatically treated as a simple comma-separated
-list.
-</p><!--l. 2084--><p class="indent" > As mentioned above, the base <span
-class="cmss-10">glossaries </span>package provides <span
-class="cmtt-10">\glsseelist</span><a
- id="dx1-8071"></a>, which
-requires a comma-separated list of labels as the argument. The argument isn&#8217;t fully
-expanded, so it&#8217;s not suitable to use, for example, <span
-class="cmtt-10">\glsxtrseealsolabels{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span>as
-the argument. For convenience, <span
-class="cmss-10">glossaries-extra </span>provides
-</p><!--l. 2089--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-8072"></a> <span
-class="cmtt-10">\glsxtrseelist{</span>&#x27E8;<span
-class="cmitt-10">xr list</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2091--><p class="noindent" >
-which fully expands its argument and passes it to <span
-class="cmtt-10">\glsseelist</span>.
-</p><!--l. 2094--><p class="indent" > As from v1.47, <span
-class="cmss-10">glossaries-extra </span>redefines <span
-class="cmtt-10">\glsseelist </span>to make it more flexible.
-The base package provides <span
-class="cmtt-10">\glsseeitem{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span>which is used to format each element
-in the list and <span
-class="cmtt-10">\glsseelastsep </span>for the separator between the final two items
-(<span
-class="cmtt-10">\glsseesep </span>is used between the other items). The modifications provide two
-additional commands:
-</p><!--l. 2100--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-8073"></a> <span
-class="cmtt-10">\glsseefirstitem{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2102--><p class="noindent" >
-This defaults to <span
-class="cmtt-10">\glsseeitem{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span>and is used to format the first label in the
-list.
-</p><!--l. 2105--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-8074"></a> <span
-class="cmtt-10">\glsseelastoxfordsep </span></div><hr>
-
-
-
-</p><!--l. 2107--><p class="noindent" >
-This defaults to <span
-class="cmtt-10">\glsseelastsep </span>and is used if the list consists of three or more
-labels.
-</p><!--l. 2111--><p class="indent" > The <span
-class="cmss-10">seealso</span><a
- id="dx1-8075"></a> key implements the automatic indexing using
-</p><!--l. 2112--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-8076"></a> <span
-class="cmtt-10">\glsxtrindexseealso{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">xr list</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2114--><p class="noindent" >
-which just does </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\glssee[\seealsoname]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">xr</span><span
-class="cmitt-10">&#x00A0;list</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div>
-</div> unless the <a
-href="#styopt.xindy"><span
-class="cmss-10">xindy</span></a><a
- id="dx1-8077"></a> option is used with <span
-class="cmss-10">glossaries</span><a
- id="dx1-8078"></a> v4.30+, in which case a distinct
-<span
-class="cmtt-10">seealso </span>cross-reference class is used instead.
-<!--l. 2123--><p class="indent" > The command that produces this &#8220;see also&#8221; text is
-</p><!--l. 2124--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-8079"></a> <span
-class="cmtt-10">\seealsoname </span></div><hr>
-</p><!--l. 2126--><p class="noindent" >
-If <span
-class="cmtt-10">\alsoname</span><a
- id="dx1-8080"></a> (provided by language packages) is defined then <span
-class="cmtt-10">\seealsoname </span>will
-simply be defined to <span
-class="cmtt-10">\alsoname </span>otherwise it will be defined to <span
-class="cmtt-10">see also</span>.
-</p><!--l. 2131--><p class="indent" > The language-sensitive <span
-class="cmtt-10">\alsoname </span>is used by general indexing packages, such as
-<span
-class="cmss-10">makeidx</span><a
- id="dx1-8081"></a>, so if you redefine <span
-class="cmtt-10">\alsoname </span>the change will apply to normal indexes as well
-as glossaries. If you only want to change the text produced by the <span
-class="cmss-10">seealso</span><a
- id="dx1-8082"></a> key
-without affecting general indexing (with <span
-class="cmtt-10">\index</span>) then redefine <span
-class="cmtt-10">\seealsoname</span>
-instead.
-</p><!--l. 2138--><p class="noindent" >
-</p>
-<!--l. 2138--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.4 </span> <a
- id="sec:entryfmtmods"></a>Entry Display Style Modifications</h3>
-<!--l. 2141--><p class="noindent" >Recall from the <span
-class="cmss-10">glossaries </span>package that commands such as <span
-class="cmtt-10">\gls </span>display text at
-that point in the document (optionally with a hyperlink to the relevant
-line in the glossary). This text is referred to as the &#8220;<a
- id="dx1-9001"></a><a
-href="#glo:linktext">link-text</a>&#8221; regardless of
-whether or not it actually has a hyperlink. The actual text and the way
-it&#8217;s displayed depends on the command used (such as <span
-class="cmtt-10">\gls</span>) and the entry
-format.
-</p><!--l. 2148--><p class="indent" > The default entry format (<span
-class="cmtt-10">\glsentryfmt</span><a
- id="dx1-9002"></a>) used in the <a
- id="dx1-9003"></a>link-text by commands like
-<span
-class="cmtt-10">\gls</span><a
- id="dx1-9004"></a>, <span
-class="cmtt-10">\glsxtrfull</span><a
- id="dx1-9005"></a>, <span
-class="cmtt-10">\glsxtrshort</span><a
- id="dx1-9006"></a> and <span
-class="cmtt-10">\glsxtrlong</span><a
- id="dx1-9007"></a> (but not commands like
-<span
-class="cmtt-10">\glslink</span><a
- id="dx1-9008"></a>, <span
-class="cmtt-10">\glsfirst</span><a
- id="dx1-9009"></a> and <span
-class="cmtt-10">\glstext</span>) is changed by <span
-class="cmss-10">glossaries-extra </span>to test for regular
-entries, which are determined as follows:
-</p>
- <ul class="itemize1">
- <li class="itemize">If an entry is assigned to a category that has the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-9010"></a> attribute set
- (see <a
-href="#sec:categories"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">7</span> </a><a
-href="#sec:categories">Categories<!--tex4ht:ref: sec:categories --></a>), the entry is considered a&#x00A0;regular entry,
-
-
-
- even if it has a&#x00A0;value for the <span
-class="cmss-10">short</span><a
- id="dx1-9011"></a> key. In this case <span
-class="cmtt-10">\glsentryfmt</span>
- uses <span
-class="cmtt-10">\glsgenentryfmt</span><a
- id="dx1-9012"></a> (provided by <span
-class="cmss-10">glossaries</span>), which uses the <span
-class="cmss-10">first</span><a
- id="dx1-9013"></a> (or
- <span
-class="cmss-10">firstplural</span><a
- id="dx1-9014"></a>) value on <a
- id="dx1-9015"></a><a
-href="#glo:firstuse">first use</a> and the <span
-class="cmss-10">text</span><a
- id="dx1-9016"></a> (or <span
-class="cmss-10">plural</span><a
- id="dx1-9017"></a>) value on subsequent
- use.
- </li>
- <li class="itemize">An entry that doesn&#8217;t have a&#x00A0;value for the <span
-class="cmss-10">short</span><a
- id="dx1-9018"></a> key is assumed to
- be a&#x00A0;regular entry, even if the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-9019"></a> attribute isn&#8217;t set to &#8220;true&#8221;
- (since it can&#8217;t be an abbreviation without the short form). In this case
- <span
-class="cmtt-10">\glsentryfmt </span>uses <span
-class="cmtt-10">\glsgenentryfmt</span><a
- id="dx1-9020"></a>.
- </li>
- <li class="itemize">If an entry does has a&#x00A0;value for the <span
-class="cmss-10">short</span><a
- id="dx1-9021"></a> key and hasn&#8217;t been marked
- as a&#x00A0;regular entry through the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-9022"></a> attribute, it&#8217;s not considered
- a regular entry. In this case <span
-class="cmtt-10">\glsentryfmt </span>uses <span
-class="cmtt-10">\glsxtrgenabbrvfmt</span><a
- id="dx1-9023"></a>
- (defined by <span
-class="cmss-10">glossaries-extra</span>) which is governed by the abbreviation style
- (see <a
-href="#sec:abbrstyle"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">4.2</span> </a><a
-href="#sec:abbrstyle">Abbreviation Styles<!--tex4ht:ref: sec:abbrstyle --></a>).
- </li></ul>
-<!--l. 2179--><p class="indent" > This means that entries with a short form can be treated as regular entries rather
-than abbreviations if it&#8217;s more appropriate for the desired style.
-</p><!--l. 2183--><p class="indent" > As from version 1.04, <span
-class="cmtt-10">\glsentryfmt</span><a
- id="dx1-9024"></a> now puts <span
-class="cmtt-10">\glsgenentry</span><a
- id="dx1-9025"></a> in the argument of
-the new command
-</p><!--l. 2185--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-9026"></a> <span
-class="cmtt-10">\glsxtrregularfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2187--><p class="noindent" >
-This just does its argument &#x27E8;<span
-class="cmti-10">text</span>&#x27E9; by default. This means that if you want regular
-entries in a different font but don&#8217;t want that font to apply to abbreviations, then
-you can redefine <span
-class="cmtt-10">\glsxtrregularfont</span>. This is more precise than changing
-<span
-class="cmtt-10">\glstextformat</span><a
- id="dx1-9027"></a> which is applied to all linking commands for all entries, unless
-overridden by the <a
-href="#catattr.textformat"><span
-class="cmss-10">textformat</span></a><a
- id="dx1-9028"></a> attribute.
-</p><!--l. 2196--><p class="indent" > For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-56">
-\renewcommand*{\glsxtrregularfont}[1]{\textsf{#1}}
-</pre>
-<!--l. 2199--><p class="nopar" > You can access the label through <span
-class="cmtt-10">\glslabel</span>. For example, you can query the
-category:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-57">
-\renewcommand*{\glsxtrregularfont}[1]{%
-&#x00A0;\glsifcategory{\glslabel}{general}{\textsf{#1}}{#1}}
-</pre>
-<!--l. 2205--><p class="nopar" > or query the category attribute, for example, provide a custom attribute called
-<span
-class="cmtt-10">font</span>:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-58">
-\glssetcategoryattribute{general}{font}{sf}
-\renewcommand*{\glsxtrregularfont}[1]{%
-&#x00A0;\glsifattribute{\glslabel}{font}{sf}{\textsf{#1}}{#1}}
-</pre>
-<!--l. 2213--><p class="nopar" > As from version 1.21, it&#8217;s simpler to just do, for example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-59">
-\glssetcategoryattribute{general}{textformat}{textsf}
-</pre>
-<!--l. 2217--><p class="nopar" > without redefining <span
-class="cmtt-10">\glsxtrregularfont</span>.
-</p><!--l. 2220--><p class="indent" > As from version 1.30, there is also a command for abbreviations that encapsulates
-<span
-class="cmtt-10">\glsxtrgenabbrvfmt</span>:
-</p><!--l. 2222--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-9029"></a> <span
-class="cmtt-10">\glsxtrabbreviationfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2224--><p class="noindent" >
-This also just does its argument by default. Font changes made by abbreviation styles
-are within &#x27E8;<span
-class="cmti-10">text</span>&#x27E9;.
-</p><!--l. 2228--><p class="indent" > The <span
-class="cmtt-10">\glspostlinkhook </span>provided by the <span
-class="cmss-10">glossaries </span>package to insert information
-after the <a
- id="dx1-9030"></a><a
-href="#glo:linktext">link-text</a> produced by commands like <span
-class="cmtt-10">\gls </span>and <span
-class="cmtt-10">\glstext </span>is redefined
-to
-</p><!--l. 2231--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-9031"></a> <span
-class="cmtt-10">\glsxtrpostlinkhook </span></div><hr>
-</p><!--l. 2233--><p class="noindent" >
-This command will discard a following full stop (period) if the <a
-href="#catattr.discardperiod"><span
-class="cmss-10">discardperiod</span></a><a
- id="dx1-9032"></a> attribute
-is set to &#8220;true&#8221; for the current entry&#8217;s category. It will also do
-</p><!--l. 2237--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-9033"></a> <span
-class="cmtt-10">\glsxtrpostlink </span></div><hr>
-</p><!--l. 2239--><p class="noindent" >
-if a full stop hasn&#8217;t be discarded and
-</p><!--l. 2241--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-9034"></a> <span
-class="cmtt-10">\glsxtrpostlinkendsentence </span></div><hr>
-</p><!--l. 2243--><p class="noindent" >
-if a full stop has been discarded.
-</p><!--l. 2246--><p class="indent" > It may be that you want to check some other setting (rather than a category
-attribute) to determine whether or not to discard a following full stop. In which case
-you can redefine:
-</p><!--l. 2249--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-9035"></a> <span
-class="cmtt-10">\glsxtrifcustomdiscardperiod{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2251--><p class="noindent" >
-You can access the field&#8217;s label using <span
-class="cmtt-10">\glslabel</span>. This command should do &#x27E8;<span
-class="cmti-10">true</span>&#x27E9; if the
-post-link hook should check if a period follows and &#x27E8;<span
-class="cmti-10">false</span>&#x27E9; otherwise. The default
-definition is simply:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-60">
-\newcommand*{\glsxtrifcustomdiscardperiod}[2]{#2}
-</pre>
-<!--l. 2258--><p class="nopar" > which means that no additional checks are performed. (Only the recognised category
-attributes will be checked.)
-</p><!--l. 2262--><p class="indent" > <div class="important" title="Important Note"> Avoid the use of <span
-class="cmtt-10">\gls</span>-like and <span
-class="cmtt-10">\glstext</span>-like commands within the
-post-link hook as they will cause interference. Consider using commands like
-<span
-class="cmtt-10">\glsentrytext</span>, <span
-class="cmtt-10">\glsaccesstext </span>or <span
-class="cmtt-10">\glsxtrp </span>(<a
-href="#sec:nested"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.8</span> </a><a
-href="#sec:nested">Nested Links<!--tex4ht:ref: sec:nested --></a>) instead.
-</div>
-</p><!--l. 2267--><p class="noindent" >
-</p><!--l. 2269--><p class="indent" > By default <span
-class="cmtt-10">\glsxtrpostlink </span>just does <span
-class="cmtt-10">\glsxtrpostlink</span>&#x27E8;<span
-class="cmti-10">category</span>&#x27E9;<a
- id="dx1-9036"></a>&#x00A0;if
-it exists, where &#x27E8;<span
-class="cmti-10">category</span>&#x27E9; is the category label for the current entry. (For
-example, for the <span
-class="cmss-10">general</span><a
- id="dx1-9037"></a> category, <span
-class="cmtt-10">\glsxtrpostlinkgeneral </span>if it has been
-defined.)
-</p><!--l. 2274--><p class="indent" > You can define the post-link hook command using <span
-class="cmtt-10">\newcommand</span>, for
-example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-61">
-\newcommand*{\glsxtrpostlinkgeneral}{%
-&#x00A0;\glsxtrpostlinkAddDescOnFirstUse
+table.tabular-m
+{
+ display: inline-table;
+ border-collapse: collapse;
+ vertical-align: middle;
}
-</pre>
-<!--l. 2280--><p class="nopar" > or, as from v1.31, you can use
-</p><!--l. 2282--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-9038"></a> <span
-class="cmtt-10">\glsdefpostlink{</span>&#x27E8;<span
-class="cmitt-10">category</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">definition</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2284--><p class="noindent" >
-This is simply a shortcut for: </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\csdef</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">glsxtrpostlink</span>&#x27E8;<span
-class="cmitt-10">category</span>&#x27E9;<span
-class="cmsy-10">}</span><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">definition</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div>
-</div> Note that it doesn&#8217;t check if the command has already been defined.
-<!--l. 2292--><p class="indent" > The sentence-ending hook is slightly more complicated. If the command
-<span
-class="cmtt-10">\glsxtrpostlink</span>&#x27E8;<span
-class="cmti-10">category</span>&#x27E9;<a
- id="dx1-9039"></a>&#x00A0;is defined the hook will do that and then insert a
-full stop with the space factor adjusted to match the end of sentence. If
-<span
-class="cmtt-10">\glsxtrpostlink</span>&#x27E8;<span
-class="cmti-10">category</span>&#x27E9;<a
- id="dx1-9040"></a>&#x00A0;hasn&#8217;t been defined, the space factor is adjusted to match
-the end of sentence. This means that if you have, for example, an entry that ends
-with a full stop, a redundant following full stop will be discarded and the space factor
-adjusted (in case the entry is in uppercase) unless the entry is followed by additional
-material, in which case the following full stop is no longer redundant and needs to be
-reinserted.
-</p><!--l. 2305--><p class="indent" > There are some convenient commands you might want to use when customizing
-the post-<a
- id="dx1-9041"></a><a
-href="#glo:linktext">link-text</a> category hooks:
-</p><!--l. 2307--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-9042"></a> <span
-class="cmtt-10">\glsxtrpostlinkAddDescOnFirstUse </span></div><hr>
-</p><!--l. 2309--><p class="noindent" >
-This will add the description in parentheses on <a
- id="dx1-9043"></a><a
-href="#glo:firstuse">first use</a>.
-</p><!--l. 2312--><p class="indent" > For example, suppose you want to append the description in parentheses on <a
- id="dx1-9044"></a>first
-use for entries in the <span
-class="cmss-10">symbol</span><a
- id="dx1-9045"></a> category:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-62">
-\newcommand*{\glsxtrpostlinksymbol}{%
-&#x00A0;&#x00A0;\glsxtrpostlinkAddDescOnFirstUse
+table.tabular-b
+{
+ display: inline-table;
+ border-collapse: collapse;
+ vertical-align: bottom;
}
-</pre>
-<!--l. 2319--><p class="nopar" >
-</p><!--l. 2321--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-9046"></a> <span
-class="cmtt-10">\glsxtrpostlinkAddSymbolOnFirstUse </span></div><hr>
-</p><!--l. 2323--><p class="noindent" >
-This will append the symbol (if defined) in parentheses on <a
- id="dx1-9047"></a><a
-href="#glo:firstuse">first use</a>. (Does nothing if
-the symbol hasn&#8217;t been set.)
-</p><!--l. 2327--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-9048"></a> <span
-class="cmtt-10">\glsxtrpostlinkAddSymbolDescOnFirstUse </span></div><hr>
-</p><!--l. 2329--><p class="noindent" >
-(New to v1.31.) On <a
- id="dx1-9049"></a>first use, this will append <span
-class="cmtt-10">\space</span>(&#x27E8;<span
-class="cmti-10">symbol</span>&#x27E9;, &#x27E8;<span
-class="cmti-10">description</span>&#x27E9;) if the
-symbol is defined otherwise it just appends <span
-class="cmtt-10">\space</span>(&#x27E8;<span
-class="cmti-10">description</span>&#x27E9;).
-</p><!--l. 2335--><p class="indent" > If you want to provide your own custom format be aware that you can&#8217;t use
-<span
-class="cmtt-10">\ifglsused</span><a
- id="dx1-9050"></a> within the post-<a
- id="dx1-9051"></a><a
-href="#glo:linktext">link-text</a> hook as by this point the <a
- id="dx1-9052"></a><a
-href="#glo:firstuseflag">first use flag</a> will have
-been unset. Instead you can use
-</p><!--l. 2338--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-9053"></a> <span
-class="cmtt-10">\glsxtrifwasfirstuse{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2340--><p class="noindent" >
-This will do &#x27E8;<span
-class="cmti-10">true</span>&#x27E9; if the last used entry was the <a
- id="dx1-9054"></a>first use for that entry, otherwise it
-will do &#x27E8;<span
-class="cmti-10">false</span>&#x27E9;. (Requires at least <span
-class="cmss-10">glossaries </span>v4.19 to work properly.) This command is
-locally set by commands like <span
-class="cmtt-10">\gls</span>, so don&#8217;t rely on it outside of the post-<a
- id="dx1-9055"></a>link-text
-hook.
-</p><!--l. 2348--><p class="indent" > <div class="important" title="Important Note"> Note that commands like <span
-class="cmtt-10">\glsfirst</span><a
- id="dx1-9056"></a> and <span
-class="cmtt-10">\glsxtrfull</span><a
- id="dx1-9057"></a> fake <a
- id="dx1-9058"></a>first use for the
-benefit of the post-<a
- id="dx1-9059"></a>link-text hooks by setting <span
-class="cmtt-10">\glsxtrifwasfirstuse </span>to
-<span
-class="cmtt-10">\@firstoftwo</span>. (Although, depending on the styles in use, they may not exactly
-match the text produced by <span
-class="cmtt-10">\gls</span><a
- id="dx1-9060"></a>-like commands on <a
- id="dx1-9061"></a>first use.) However, the
-<a
-href="#abbrstyle.short-postfootnote"><span
-class="cmss-10">short-postfootnote</span></a><a
- id="dx1-9062"></a> style alters <span
-class="cmtt-10">\glsxtrfull </span>so that it fakes non-<a
- id="dx1-9063"></a>first use otherwise
-the inline full format would include the footnote, which is inappropriate.
-</div>
-</p><!--l. 2357--><p class="noindent" >
-</p><!--l. 2359--><p class="indent" > For example, if you want to place the description in a footnote after the <a
- id="dx1-9064"></a>link-text
-on <a
- id="dx1-9065"></a>first use for the <span
-class="cmss-10">general</span><a
- id="dx1-9066"></a> category:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-63">
-\newcommand*{\glsxtrpostlinkgeneral}{%
-&#x00A0;&#x00A0;\glsxtrifwasfirstuse{\footnote{\glsentrydesc{\glslabel}}}{}%
+table.tabular-t
+{
+ display: inline-table;
+ border-collapse: collapse;
+ vertical-align: top;
}
-</pre>
-<!--l. 2365--><p class="nopar" >
-</p><!--l. 2367--><p class="indent" > The <a
-href="#abbrstyle.short-postfootnote"><span
-class="cmss-10">short-postfootnote</span></a><a
- id="dx1-9067"></a> abbreviation style uses the post-<a
- id="dx1-9068"></a><a
-href="#glo:linktext">link-text</a> hook to place the
-footnote after trailing punctuation characters.
-</p><!--l. 2372--><p class="noindent" >
-</p>
-<!--l. 2372--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.5 </span> <a
- id="sec:entrycountmods"></a>Entry Counting Modifications</h3>
-<!--l. 2375--><p class="noindent" >If you are using <a
- id="dx1-10001"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> you may find it more convenient to use the record count
-commands described in <a
-href="#sec:bib2gls"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">10</span> </a><a
-href="#sec:bib2gls">bib2gls: Managing Reference Databases<!--tex4ht:ref: sec:bib2gls --></a>
-instead.
-</p><!--l. 2379--><p class="indent" > The <span
-class="cmtt-10">\glsenableentrycount</span><a
- id="dx1-10002"></a> command is modified to allow for the <a
-href="#catattr.entrycount"><span
-class="cmss-10">entrycount</span></a><a
- id="dx1-10003"></a>
-attribute. This means that you not only need to enable entry counting with
-<span
-class="cmtt-10">\glsenableentrycount</span>, but you also need to set the appropriate attribute (see
-<a
-href="#sec:categories"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">7</span> </a><a
-href="#sec:categories">Categories<!--tex4ht:ref: sec:categories --></a>).
-</p><!--l. 2385--><p class="indent" > For example, instead of just doing:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-64">
-\glsenableentrycount
-</pre>
-<!--l. 2388--><p class="nopar" > you now need to do:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-65">
-\glsenableentrycount
-\glssetcategoryattribute{abbreviation}{entrycount}{1}
-</pre>
-<!--l. 2393--><p class="nopar" > This will enable the entry counting for entries in the <span
-class="cmss-10">abbreviation</span><a
- id="dx1-10004"></a> category, but any
-entries assigned to other categories will be unchanged.
-</p><!--l. 2398--><p class="indent" > Further information about entry counting, including the new per-unit feature, is
-described in <a
-href="#sec:entrycount"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">8.1</span> </a><a
-href="#sec:entrycount">Entry Counting (First Use Flag)<!--tex4ht:ref: sec:entrycount --></a>.
-</p><!--l. 2401--><p class="noindent" >
-</p>
-<!--l. 2401--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.6 </span> <a
- id="sec:glsunset"></a>First Use Flag</h3>
-<!--l. 2404--><p class="noindent" >The <span
-class="cmss-10">glossaries </span>package provides
-</p><!--l. 2406--><p class="indent" > <hr><div title="Definition"><span
-class="cmtt-10">\ifglsused</span><a
- id="dx1-11001"></a><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2407--><p class="noindent" >
-to determine whether or not an entry has been used. This requires the entry to have
-been defined. If the entry is undefined, then the underlying boolean variable doesn&#8217;t
-exist and so is neither true nor false. This command will produce an error with the
-default <a
-href="#styopt.undefaction"><span
-class="cmss-10">undefaction</span></a><span
-class="cmss-10">=error</span><a
- id="dx1-11002"></a> mode and a warning with <a
-href="#styopt.undefaction"><span
-class="cmss-10">undefaction</span></a><span
-class="cmss-10">=warn</span><a
- id="dx1-11003"></a> and, where
-appropriate, displays ?? in the document text to denote an undefined reference.
-With both modes, neither &#x27E8;<span
-class="cmti-10">true</span>&#x27E9; nor &#x27E8;<span
-class="cmti-10">false</span>&#x27E9; will be performed if &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; doesn&#8217;t
-exist.
-</p><!--l. 2418--><p class="indent" > The <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><a
- id="dx1-11004"></a> option automatically implements <a
-href="#styopt.undefaction"><span
-class="cmss-10">undefaction</span></a><span
-class="cmss-10">=warn</span><a
- id="dx1-11005"></a> since no entries
-will be defined until they have been selected by <a
- id="dx1-11006"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a>. In this case, you may prefer
-to use:
-</p><!--l. 2422--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-11007"></a> <span
-class="cmtt-10">\GlsXtrIfUnusedOrUndefined{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2424--><p class="noindent" >
-(new to v1.34) which does &#x27E8;<span
-class="cmti-10">true</span>&#x27E9; if the entry given by &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; is undefined or if
-the entry is marked as unused. Remember that neither <span
-class="cmtt-10">\ifglsused </span>nor
-<span
-class="cmtt-10">\GlsXtrIfUnusedOrUndefined </span>should be used in the post-link hook as the <a
- id="dx1-11008"></a><a
-href="#glo:firstuseflag">first use
-flag</a> will have already been unset before the hook is performed. (Instead,
-<span
-class="cmtt-10">\glsxtrifwasfirstuse</span><a
- id="dx1-11009"></a> should be used, see <a
-href="#sec:entryfmtmods"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.4</span> </a><a
-href="#sec:entryfmtmods">Entry Display
-Style Modifications<!--tex4ht:ref: sec:entryfmtmods --></a>.)
-</p><!--l. 2433--><p class="indent" > There are two new commands provided with version 1.31+:
-</p><!--l. 2434--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-11010"></a> <span
-class="cmtt-10">\glslocalreseteach{</span>&#x27E8;<span
-class="cmitt-10">list</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2436--><p class="noindent" >
-and
-</p><!--l. 2438--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-11011"></a> <span
-class="cmtt-10">\glslocalunseteach{</span>&#x27E8;<span
-class="cmitt-10">list</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2440--><p class="noindent" >
-These behave like <span
-class="cmtt-10">\glslocalreset </span>and <span
-class="cmtt-10">\glslocalunset </span>but the argument is a
-comma-separated list of labels.
-
-
-
-</p><!--l. 2444--><p class="indent" > The internal command used by <span
-class="cmtt-10">\glsunset </span>is modified first to allow for the
-changing in entry counting, described above, but also to allow for buffering pending
-unsets when commands like <span
-class="cmtt-10">\gls </span>are used in a context where changing a boolean
-variable can cause things to go wrong. One example of this is using <span
-class="cmtt-10">\gls </span>in one of
-the commands provided with the <a
- id="dx1-11012"></a>package. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-66">
-\ul{Some&#x00A0;text&#x00A0;about&#x00A0;\gls{html}.}
-</pre>
-<!--l. 2453--><p class="nopar" > This causes the confusing error:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-67">
-Glossary&#x00A0;entry&#x00A0;`{html}'&#x00A0;has&#x00A0;not&#x00A0;been&#x00A0;defined.
-</pre>
-<!--l. 2457--><p class="nopar" > The simplest workaround is to put <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls{html}</span></span></span> inside the argument of <span
-class="cmtt-10">\mbox</span>. For
-example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-68">
-\ul{Some&#x00A0;text&#x00A0;about&#x00A0;\mbox{\gls{html}}.}
-</pre>
-<!--l. 2462--><p class="nopar" > This can work provided it&#8217;s not the first use of this entry. It if is, then unsetting the
-first use flag causes a problem and results in the error:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-69">
-!&#x00A0;Package&#x00A0;soul&#x00A0;Error:&#x00A0;Reconstruction&#x00A0;failed.
-</pre>
-<!--l. 2468--><p class="nopar" > The <span
-class="cmss-10">glossaries-extra </span>package provides a way of temporarily switching off <span
-class="cmtt-10">\glsunset</span>
-so that it just makes a note of the entry&#8217;s label but doesn&#8217;t actually perform the
-change:
-</p><!--l. 2472--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-11013"></a> <span
-class="cmtt-10">\GlsXtrStartUnsetBuffering </span></div><hr>
-</p><!--l. 2474--><p class="noindent" >
-The unstarred version doesn&#8217;t check for duplicates, so the internal list may
-end up with multiple occurrences of the same label. The starred version
-only adds a label to the internal list if it&#8217;s not already in it. Note that this
-buffering only applies to the global <span
-class="cmtt-10">\glsunset </span>and does not affect the local
-<span
-class="cmtt-10">\glslocalunset</span>.
-</p><!--l. 2482--><p class="indent" > Later you can restore <span
-class="cmtt-10">\glsunset </span>and unset all buffered labels using:
-</p><!--l. 2484--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-11014"></a> <span
-class="cmtt-10">\GlsXtrStopUnsetBuffering </span></div><hr>
-</p><!--l. 2486--><p class="noindent" >
-The starred form <span
-class="cmtt-10">\GlsXtrStopUnsetBuffering* </span>uses <span
-class="cmtt-10">\glslocalunset </span>instead. For
-example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-70">
-\documentclass{article}
-\usepackage[T1]{fontenc}
-\usepackage{soul}
-\usepackage{glossaries-extra}
-\newabbreviation{html}{HTML}{hypertext&#x00A0;markup&#x00A0;language}
-\begin{document}
-\GlsXtrStartUnsetBuffering
-\ul{Some&#x00A0;text&#x00A0;about&#x00A0;\mbox{\gls{html}}.}
-\GlsXtrStopUnsetBuffering
-Next&#x00A0;use:&#x00A0;\gls{html}.
-\end{document}
-</pre>
-<!--l. 2505--><p class="nopar" > Before you stop the unset buffering, you can iterate over the current buffer
-using
-</p><!--l. 2508--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-11015"></a> <span
-class="cmtt-10">\GlsXtrForUnsetBufferedList{</span>&#x27E8;<span
-class="cmitt-10">cs</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2510--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">cs</span>&#x27E9; is a control sequence that takes a single argument (which is the entry label).
-This is best used with the starred version <span
-class="cmtt-10">\GlsXtrStartUnsetBuffering* </span>to avoid
-duplicates.
-</p><!--l. 2515--><p class="indent" > You can discard the buffer and restore <span
-class="cmtt-10">\glsunset </span>to its normal behaviour with
-(new to v1.42):
-</p><!--l. 2517--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-11016"></a> <span
-class="cmtt-10">\GlsXtrDiscardUnsetBuffering </span></div><hr>
-</p><!--l. 2519--><p class="noindent" >
-</p><!--l. 2521--><p class="indent" > <div class="important" title="Important Note"> Note that since the change in the first use flag now doesn&#8217;t occur until
-<span
-class="cmtt-10">\GlsXtrStopUnsetBuffering</span>, multiple references of the same term within the
-buffering zone will always be treated as first use (if the term wasn&#8217;t used before the
-buffering started). </div>
-</p><!--l. 2527--><p class="noindent" >
-</p><!--l. 2529--><p class="indent" > There can still be a problem here as content within <span
-class="cmtt-10">\mbox </span>can&#8217;t break across a
-line so you may end up with an overfull line or excessive white space within the
-paragraph.
-</p><!--l. 2533--><p class="indent" > An alternative is to use <span
-class="cmtt-10">\protect</span>:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-71">
-\GlsXtrStartUnsetBuffering
-\ul{Some&#x00A0;text&#x00A0;about&#x00A0;\protect\gls{html}.}
-\GlsXtrStopUnsetBuffering
-</pre>
-<!--l. 2538--><p class="nopar" > but the formatting (underlining in this example) won&#8217;t be applied. Another
-possibility is:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-72">
-\usepackage[T1]{fontenc}
-\usepackage{soul}
-\usepackage{glossaries-extra}
-\newabbreviation{html}{HTML}{hypertext&#x00A0;markup&#x00A0;language}
-\newrobustcmd{\gul}[1]{%
-&#x00A0;&#x00A0;{%
-&#x00A0;&#x00A0;&#x00A0;\def\glsxtrabbreviationfont##1{\GlsXtrExpandedFmt{\ul}{##1}}%
-&#x00A0;&#x00A0;&#x00A0;\def\glsxtrregularfont##1{\GlsXtrExpandedFmt{\ul}{##1}}%
-&#x00A0;&#x00A0;&#x00A0;#1%
-&#x00A0;&#x00A0;}%
+table.tabular-l
+{
+ display: inline-table;
+ border-collapse: collapse;
+ align: left;
}
-\begin{document}
-\ul{Some&#x00A0;text&#x00A0;about&#x00A0;}\gls[textformat=gul]{html}.
-Next&#x00A0;use:&#x00A0;\gls{html}.
-\end{document}
-</pre>
-<!--l. 2561--><p class="nopar" > This moves <span
-class="cmtt-10">\gls </span>outside of <span
-class="cmtt-10">\ul </span>and uses <span
-class="cmss-10">textformat</span><a
- id="dx1-11017"></a> to locally change the formatting
-command used by <span
-class="cmtt-10">\gls </span>(which is normally given by <span
-class="cmtt-10">\glstextformat </span>or the
-<a
-href="#catattr.textformat"><span
-class="cmss-10">textformat</span></a><a
- id="dx1-11018"></a> attribute) to a custom command <span
-class="cmtt-10">\gul</span>, which locally changes the regular
-font and the default abbreviation font to use <span
-class="cmtt-10">\ul</span>. It then uses
-</p><!--l. 2568--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-11019"></a> <span
-class="cmtt-10">\GlsXtrExpandedFmt{</span>&#x27E8;<span
-class="cmitt-10">cs</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2570--><p class="noindent" >
-which (protected) fully expands &#x27E8;<span
-class="cmti-10">text</span>&#x27E9; before applying &#x27E8;<span
-class="cmti-10">cs</span>&#x27E9;, which must be a control
-sequence that takes a single argument. This allows <span
-class="cmtt-10">\ul </span>to move much further inside
-and increases its chances of working. It can still break if &#x27E8;<span
-class="cmti-10">text</span>&#x27E9; expands to
-something that <span
-class="cmtt-10">\ul </span>can&#8217;t deal with. For example, if an abbreviation style is used
-that contains complex formatting or if the field value contains problematic
-content.
-</p><!--l. 2580--><p class="noindent" >
-</p>
-<!--l. 2580--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.7 </span> <a
- id="sec:plurals"></a>Plurals</h3>
-<!--l. 2583--><p class="noindent" >Some languages, such as English, have a general rule that plurals are formed from
-the singular with a suffix appended. This isn&#8217;t an absolute rule. There are
-plenty of exceptions (for example, geese, children, churches, elves, fairies,
-sheep). The <span
-class="cmss-10">glossaries</span><a
- id="dx1-12001"></a> package allows the <span
-class="cmss-10">plural</span><a
- id="dx1-12002"></a> key to be optional when
-defining entries. In some cases a plural may not make any sense (for example,
-
-
-
-the term is a symbol) and in some cases the plural may be identical to the
-singular.
-</p><!--l. 2592--><p class="indent" > To make life easier for languages where the majority of plurals can simply be
-formed by appending a suffix to the singular, the <span
-class="cmss-10">glossaries</span><a
- id="dx1-12003"></a> package lets the <span
-class="cmss-10">plural</span><a
- id="dx1-12004"></a>
-field default to the value of the <span
-class="cmss-10">text</span><a
- id="dx1-12005"></a> field with <span
-class="cmtt-10">\glspluralsuffix</span><a
- id="dx1-12006"></a> appended. This
-command is defined to be just the letter &#8220;s&#8221;. This means that the majority of terms
-don&#8217;t need to have the <span
-class="cmss-10">plural</span><a
- id="dx1-12007"></a> supplied as well, and you only need to use it for the
-exceptions.
-</p><!--l. 2601--><p class="indent" > For languages that don&#8217;t have this general rule, the <span
-class="cmss-10">plural</span><a
- id="dx1-12008"></a> field will always need to
-be supplied, where needed.
-</p><!--l. 2604--><p class="indent" > There are other plural fields, such as <span
-class="cmss-10">firstplural</span><a
- id="dx1-12009"></a>, <span
-class="cmss-10">longplural</span><a
- id="dx1-12010"></a> and <span
-class="cmss-10">shortplural</span><a
- id="dx1-12011"></a>. Again, if
-you are using a language that doesn&#8217;t have a simple suffix rule, you&#8217;ll have to
-supply the plural forms if you need them (and if a plural makes sense in the
-context).
-</p><!--l. 2610--><p class="indent" > If these fields are omitted, the <span
-class="cmss-10">glossaries</span><a
- id="dx1-12012"></a> package follows these rules: </p>
- <ul class="itemize1">
- <li class="itemize">If <span
-class="cmss-10">firstplural</span><a
- id="dx1-12013"></a> is missing, then <span
-class="cmtt-10">\glspluralsuffix </span>is appended to the <span
-class="cmss-10">first</span><a
- id="dx1-12014"></a>
- field, if that field has been supplied. If the <span
-class="cmss-10">first</span><a
- id="dx1-12015"></a> field hasn&#8217;t been supplied
- but the <span
-class="cmss-10">plural</span><a
- id="dx1-12016"></a> field has been supplied, then the <span
-class="cmss-10">firstplural</span><a
- id="dx1-12017"></a> field defaults to
- the <span
-class="cmss-10">plural</span><a
- id="dx1-12018"></a> field. If the <span
-class="cmss-10">plural</span><a
- id="dx1-12019"></a> field hasn&#8217;t been supplied, then both the <span
-class="cmss-10">plural</span><a
- id="dx1-12020"></a>
- and <span
-class="cmss-10">firstplural</span><a
- id="dx1-12021"></a> fields default to the <span
-class="cmss-10">text</span><a
- id="dx1-12022"></a> field (or <span
-class="cmss-10">name</span><a
- id="dx1-12023"></a>, if no <span
-class="cmss-10">text</span><a
- id="dx1-12024"></a> field) with
- <span
-class="cmtt-10">\glspluralsuffix </span>appended.
- </li>
- <li class="itemize">If the <span
-class="cmss-10">longplural</span><a
- id="dx1-12025"></a> field is missing, then <span
-class="cmtt-10">\glspluralsuffix </span>is appended to
- the <span
-class="cmss-10">long</span><a
- id="dx1-12026"></a> field, if the <span
-class="cmss-10">long</span><a
- id="dx1-12027"></a> field has been supplied.
- </li>
- <li class="itemize">If the <span
-class="cmss-10">shortplural</span><a
- id="dx1-12028"></a> field is missing then, <span
-class="cmti-10">with the base </span><span
-class="cmssi-10">glossaries</span><a
- id="dx1-12029"></a> <span
-class="cmti-10">acronym</span>
- <span
-class="cmti-10">mechanism</span>, <span
-class="cmtt-10">\acrpluralsuffix</span><a
- id="dx1-12030"></a> is appended to the <span
-class="cmss-10">short</span><a
- id="dx1-12031"></a> field.
- </li></ul>
-<!--l. 2633--><p class="indent" > This <span
-class="cmti-10">last case is changed </span>with <span
-class="cmss-10">glossaries-extra</span>. With this extension package, the
-<span
-class="cmss-10">shortplural</span><a
- id="dx1-12032"></a> field defaults to the <span
-class="cmss-10">short</span><a
- id="dx1-12033"></a> field with <span
-class="cmtt-10">\abbrvpluralsuffix</span><a
- id="dx1-12034"></a> appended
-unless overridden by category attributes. This suffix command is set by the
-abbreviation styles. This means that every time an abbreviation style is
-implemented, <span
-class="cmtt-10">\abbrvpluralsuffix </span>is redefined. In most cases its redefined to
-use
-</p><!--l. 2641--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-12035"></a> <span
-class="cmtt-10">\glsxtrabbrvpluralsuffix </span></div><hr>
-</p><!--l. 2643--><p class="noindent" >
-which defaults to just <span
-class="cmtt-10">\glspluralsuffix</span>. Some of the abbreviation styles have their
-own command for the plural suffix, such as <span
-class="cmtt-10">\glsxtrscsuffix</span>, so if you want to
-completely strip all the plural suffixes used for abbreviations then you need to
-redefine <span
-class="cmtt-10">\glsxtrabbrvpluralsuffix </span><span
-class="cmti-10">not </span><span
-class="cmtt-10">\abbrvpluralsuffix</span>, which changes with
-the style. Redefining <span
-class="cmtt-10">\acrpluralsuffix </span>will have no affect, since it&#8217;s not used by the
-new abbreviation mechanism.
-
-
-
-</p><!--l. 2653--><p class="indent" > If you require a mixture (for example, in a multilingual document), there are two
-attributes that affect the short plural suffix formation. The first is <a
-href="#catattr.aposplural"><span
-class="cmss-10">aposplural</span></a><a
- id="dx1-12036"></a> which
-uses the suffix
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-73">
-'\abbrvpluralsuffix
-</pre>
-<!--l. 2658--><p class="nopar" > That is, an apostrophe followed by <span
-class="cmtt-10">\abbrvpluralsuffix </span>is appended. The second
-attribute is <a
-href="#catattr.noshortplural"><span
-class="cmss-10">noshortplural</span></a><a
- id="dx1-12037"></a> which suppresses the suffix and simply sets <span
-class="cmss-10">shortplural</span><a
- id="dx1-12038"></a> to the
-same as <span
-class="cmss-10">short</span><a
- id="dx1-12039"></a>.
-</p><!--l. 2664--><p class="noindent" >
-</p>
-<!--l. 2664--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.8 </span> <a
- id="sec:nested"></a>Nested Links</h3>
-<!--l. 2667--><p class="noindent" >Complications arise when you use <span
-class="cmtt-10">\gls</span><a
- id="dx1-13001"></a> in the value of the <span
-class="cmss-10">name</span><a
- id="dx1-13002"></a> field (or <span
-class="cmss-10">text</span><a
- id="dx1-13003"></a> or <span
-class="cmss-10">first</span><a
- id="dx1-13004"></a>
-fields, if set). This tends to occur with abbreviations that extend other abbreviations.
-For example, SHTML is an abbreviation for SSI enabled HTML, where SSI is an
-abbreviation for Server Side Includes and HTML is an abbreviation for Hypertext
-Markup Language.
-</p><!--l. 2675--><p class="indent" > Things can go wrong if we try the following with the <span
-class="cmss-10">glossaries </span>package:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-74">
-\newacronym{ssi}{SSI}{Server&#x00A0;Side&#x00A0;Includes}
-\newacronym{html}{HTML}{Hypertext&#x00A0;Markup&#x00A0;Language}
-\newacronym{shtml}{S\gls{html}}{\gls{ssi}&#x00A0;enabled&#x00A0;\gls{html}}
-</pre>
-<!--l. 2681--><p class="nopar" >
-</p><!--l. 2683--><p class="indent" > The main problems are:
- </p><ol class="enumerate1" >
- <li
- class="enumerate" id="x1-13006x1"><a
- id="itm:nestedfirstucprob"></a> The first letter upper casing commands, such as <span
-class="cmtt-10">\Gls</span><a
- id="dx1-13007"></a>, won&#8217;t work for the
- <span
-class="cmtt-10">shtml </span>entry on <a
- id="dx1-13008"></a><a
-href="#glo:firstuse">first use</a> if the long form is displayed before the short
- form (which is the default abbreviation style). This will attempt to
- do
-
-
-
- <pre class="verbatim" id="verbatim-75">
- \gls{\uppercase&#x00A0;ssi}&#x00A0;enabled&#x00A0;\gls{html}
-</pre>
- <!--l. 2691--><p class="nopar" > which just doesn&#8217;t work. Grouping the <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls{ssi}</span></span></span> doesn&#8217;t work either as this
- will effectively try to do
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-76">
- \uppercase{\gls{ssi}}&#x00A0;enabled&#x00A0;\gls{html}
-</pre>
- <!--l. 2696--><p class="nopar" > This will upper case the label <span
-class="cmtt-10">ssi </span>so the entry won&#8217;t be recognised.
- This problem will also occur if you use the all capitals version, such as
- <span
-class="cmtt-10">\GLS</span><a
- id="dx1-13009"></a>.
- </p></li>
- <li
- class="enumerate" id="x1-13011x2"><a
- id="itm:nonexpandprob"></a> The long and abbreviated forms accessed through <span
-class="cmtt-10">\glsentrylong</span><a
- id="dx1-13012"></a> and
- <span
-class="cmtt-10">\glsentryshort</span><a
- id="dx1-13013"></a> are no longer expandable and so can&#8217;t be used be used in
- contexts that require this, such as PDF bookmarks.
- </li>
- <li
- class="enumerate" id="x1-13015x3"><a
- id="itm:nestedsortprob"></a> The nested commands may end up in the <span
-class="cmss-10">sort</span><a
- id="dx1-13016"></a> key, which will confuse the
- indexing.
- </li>
- <li
- class="enumerate" id="x1-13018x4"><a
- id="itm:inconsistentfirstuseprob"></a> The <span
-class="cmtt-10">shtml </span>entry produces inconsistent results depending on whether the <span
-class="cmtt-10">ssi</span>
- or <span
-class="cmtt-10">html </span>entries have been used. Suppose both <span
-class="cmtt-10">ssi </span>and <span
-class="cmtt-10">html </span>are used before
- <span
-class="cmtt-10">shtml</span>. For example:
-
-
-
- <pre class="verbatim" id="verbatim-77">
- This&#x00A0;section&#x00A0;discusses&#x00A0;\gls{ssi},&#x00A0;\gls{html}&#x00A0;and&#x00A0;\gls{shtml}.
-</pre>
- <!--l. 2715--><p class="nopar" > This produces:
- </p><blockquote class="quote">
- <!--l. 2718--><p class="noindent" >This section discusses server side includes (SSI), hypertext
- markup language (HTML) and SSI enabled HTML (SHTML).</p></blockquote>
- <!--l. 2721--><p class="noindent" >So the <a
- id="dx1-13019"></a><a
-href="#glo:firstuse">first use</a> of the <span
-class="cmtt-10">shtml </span>entry produces &#8220;SSI enabled HTML (SHTML)&#8221;.
- </p><!--l. 2724--><p class="noindent" >Now let&#8217;s suppose the <span
-class="cmtt-10">html </span>entry is used before the <span
-class="cmtt-10">shtml </span>but the <span
-class="cmtt-10">ssi </span>entry is
- used after the <span
-class="cmtt-10">shtml </span>entry, for example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-78">
- The&#x00A0;sample&#x00A0;files&#x00A0;are&#x00A0;either&#x00A0;\gls{html}&#x00A0;or&#x00A0;\gls{shtml},&#x00A0;but&#x00A0;let's
- first&#x00A0;discuss&#x00A0;\gls{ssi}.
-</pre>
- <!--l. 2730--><p class="nopar" > This produces:
- </p><blockquote class="quote">
- <!--l. 2733--><p class="noindent" >The sample files are either hypertext markup language (HTML)
- or server side includes (SSI) enabled HTML (SHTML), but let&#8217;s
- first discuss SSI.</p></blockquote>
- <!--l. 2738--><p class="noindent" >So the <a
- id="dx1-13020"></a><a
-href="#glo:firstuse">first use</a> of the <span
-class="cmtt-10">shtml </span>entry now produces &#8220;server side includes (SSI)
- enabled HTML (SHTML)&#8221;, which looks a bit strange.
- </p><!--l. 2742--><p class="noindent" >Now let&#8217;s suppose the <span
-class="cmtt-10">shtml </span>entry is used before (or without) the other two
- entries:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-79">
- This&#x00A0;article&#x00A0;is&#x00A0;an&#x00A0;introduction&#x00A0;to&#x00A0;\gls{shtml}.
-</pre>
- <!--l. 2746--><p class="nopar" > This produces:
- </p><blockquote class="quote">
- <!--l. 2749--><p class="noindent" >This article is an introduction to server side includes (SSI)
- enabled hypertext markup language (HTML) (SHTML).</p></blockquote>
- <!--l. 2752--><p class="noindent" >So the <a
- id="dx1-13021"></a><a
-href="#glo:firstuse">first use</a> of the <span
-class="cmtt-10">shtml </span>entry now produces &#8220;server side includes (SSI)
- enabled hypertext markup language (HTML) (SHTML)&#8221;, which is even more
- strange.
- </p><!--l. 2756--><p class="noindent" >This is all aggravated by setting the style using the <span
-class="cmss-10">glossaries </span>package&#8217;s
- <span
-class="cmtt-10">\setacronymstyle</span>. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-80">
- \setacronymstyle{long-short}
-</pre>
- <!--l. 2761--><p class="nopar" > as this references the label through the use of <span
-class="cmtt-10">\glslabel </span>when displaying the
- long and short forms, but this value changes with each use of <span
-class="cmtt-10">\gls</span>, so
- instead of displaying &#8220;(SHTML)&#8221; at the end of the <a
- id="dx1-13022"></a><a
-href="#glo:firstuse">first use</a>, it now
- displays &#8220;(HTML)&#8221;, since <span
-class="cmtt-10">\glslabel </span>has been changed to <span
-class="cmtt-10">html </span>by
- <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls{html}</span></span></span>.
- </p><!--l. 2769--><p class="noindent" >Another oddity occurs if you reset the <span
-class="cmtt-10">html </span>entry between uses of the <span
-class="cmtt-10">shtml</span>
- entry. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-81">
- \gls{shtml}&#x00A0;...&#x00A0;\glsreset{html}\gls{shtml}
-</pre>
- <!--l. 2773--><p class="nopar" > The next use of <span
-class="cmtt-10">shtml </span>produces &#8220;Shypertext markup language (HTML)&#8221;,
- which is downright weird.
- </p><!--l. 2777--><p class="noindent" >Even without this, the short form has nested formatting commands, which
- amount to <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\acronymfont{S\acronymfont{HTML}}</span></span></span>. This may not be a problem
- for some styles, but if you use one of the &#8220;sm&#8221; styles (that use <span
-class="cmtt-10">\textsmaller</span><a
- id="dx1-13023"></a>),
- this will produce an odd result.
- </p></li>
- <li
- class="enumerate" id="x1-13025x5"><a
- id="itm:indexingprob"></a> Each time the <span
-class="cmtt-10">shtml </span>entry is used, the <span
-class="cmtt-10">html </span>entry will also be indexed and
- marked as used, and on <a
- id="dx1-13026"></a><a
-href="#glo:firstuse">first use</a> this will happen to both the <span
-class="cmtt-10">ssi </span>and <span
-class="cmtt-10">html</span>
- entries. This kind of duplication in the location list isn&#8217;t usually particularly
- helpful to the reader.
- </li>
- <li
- class="enumerate" id="x1-13028x6"><a
- id="itm:nestedhyplinkprob"></a> If <span
-class="cmss-10">hyperref</span><a
- id="dx1-13029"></a> is in use, you&#8217;ll get nested hyperlinks and there&#8217;s no consistent way
- of dealing with this across the available PDF viewers. If on the <a
- id="dx1-13030"></a>first
- use case, the user clicks on the &#8220;HTML&#8221; part of the &#8220;SSI enabled
- HTML (SHTML)&#8221; link, they may be directed to the HTML entry
- in the glossary or they may be directed to the SHTML entry in the
- glossary.
- </li></ol>
-<!--l. 2798--><p class="indent" > For these reasons it&#8217;s better to use the simple expandable commands like
-<span
-class="cmtt-10">\glsentrytext</span><a
- id="dx1-13031"></a> or <span
-class="cmtt-10">\glsentryshort</span><a
- id="dx1-13032"></a> in the definition of other entries (although that
-doesn&#8217;t fix the first problem).
-</p><!--l. 2802--><p class="indent" > Alternatively use something like:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-82">
-\newacronym
-&#x00A0;[description={\acrshort{ssi}&#x00A0;enabled&#x00A0;\acrshort{html}}]
-&#x00A0;{shtml}{SHTML}{SSI&#x00A0;enabled&#x00A0;HTML}
-</pre>
-<!--l. 2807--><p class="nopar" > with <span
-class="cmss-10">glossaries </span>or:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-83">
-\newabbreviation
-&#x00A0;[description={\glsxtrshort{ssi}&#x00A0;enabled&#x00A0;\glsxtrshort{html}}]
-&#x00A0;{shtml}{SHTML}{SSI&#x00A0;enabled&#x00A0;HTML}
-</pre>
-<!--l. 2813--><p class="nopar" > with <span
-class="cmss-10">glossaries-extra</span>. This fixes all the above listed problems (as long as you don&#8217;t
-use <span
-class="cmtt-10">\glsdesc</span><a
- id="dx1-13033"></a>). Note that replacing <span
-class="cmtt-10">\gls </span>with <span
-class="cmtt-10">\acrshort </span>in the original example
-may fix the <a
- id="dx1-13034"></a><a
-href="#glo:firstuse">first use</a> issue, but it doesn&#8217;t fix any of the other problems listed
-above.
-</p><!--l. 2820--><p class="indent" > If it&#8217;s simply that you want to use the abbreviation font, you can use
-<span
-class="cmtt-10">\glsabbrvfont</span>:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-84">
-\setabbreviationstyle{long-short-sc}
-\newabbreviation{ssi}{ssi}{server-side&#x00A0;includes}
-\newabbreviation{html}{html}{hypertext&#x00A0;markup&#x00A0;language}
-\newabbreviation{shtml}{shtml}{\glsabbrvfont{ssi}&#x00A0;enabled
-\glsabbrvfont{html}}
-</pre>
-<!--l. 2829--><p class="nopar" > This will pick up the font style setting of the outer entry (shtml, in the above case).
-This isn&#8217;t a problem in the above example as all the abbreviations use the same
-style.
-</p><!--l. 2834--><p class="indent" > If the term can simply be treated as a series of previously defined entries, then
-consider using multi-entries (or compound sets). See <a
-href="#sec:multientries"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6</span> </a><a
-href="#sec:multientries">Multi (or
-Compound) Entries<!--tex4ht:ref: sec:multientries --></a> for further details.
-</p><!--l. 2838--><p class="indent" > However, if you&#8217;re really determined to use <span
-class="cmtt-10">\gls</span><a
- id="dx1-13035"></a> in a field that may be included
-within some <a
- id="dx1-13036"></a><a
-href="#glo:linktext">link-text</a>, <span
-class="cmss-10">glossaries-extra </span>patches internals used by the linking commands
-so that if <span
-class="cmtt-10">\gls </span>(or plural or case changing variants) occurs in the <a
- id="dx1-13037"></a>link-text it will
-behave as though you used <span
-class="cmtt-10">\glstext</span><a
- id="dx1-13038"></a><span
-class="cmtt-10">[hyper=false,noindex] </span>instead. Grouping is
-also added so that, for example, when <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls{shtml}</span></span></span> is used for the first time the long
-form
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-85">
-\gls{ssi}&#x00A0;enabled&#x00A0;\gls{html}
-</pre>
-<!--l. 2849--><p class="nopar" > is treated as
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-86">
-{\glstext[hyper=false,noindex]{ssi}}&#x00A0;enabled
-{\glstext[hyper=false,noindex]{html}}
-</pre>
-<!--l. 2854--><p class="nopar" > This overcomes problems&#x00A0;<a
-href="#itm:inconsistentfirstuseprob">4<!--tex4ht:ref: itm:inconsistentfirstuseprob --></a>, <a
-href="#itm:indexingprob">5<!--tex4ht:ref: itm:indexingprob --></a> and <a
-href="#itm:nestedhyplinkprob">6<!--tex4ht:ref: itm:nestedhyplinkprob --></a> listed above, but still doesn&#8217;t fix problems&#x00A0;<a
-href="#itm:nestedfirstucprob">1<!--tex4ht:ref: itm:nestedfirstucprob --></a>
-and <a
-href="#itm:nonexpandprob">2<!--tex4ht:ref: itm:nonexpandprob --></a>. Problem&#x00A0;<a
-href="#itm:nestedsortprob">3<!--tex4ht:ref: itm:nestedsortprob --></a> usually won&#8217;t be an issue as most abbreviation styles set the <span
-class="cmss-10">sort</span><a
- id="dx1-13039"></a>
-key to the short form, so using these commands in the long form but not the short
-form will only affect entries with a style that sorts according to the long form (such
-as <a
-href="#abbrstyle.long-noshort-desc"><span
-class="cmss-10">long-noshort-desc</span></a><a
- id="dx1-13040"></a>).
-</p><!--l. 2865--><p class="indent" > Additionally, any instance of the long form commands, such as <span
-class="cmtt-10">\glsxtrlong</span><a
- id="dx1-13041"></a> or
-<span
-class="cmtt-10">\acrlong</span><a
- id="dx1-13042"></a> will be temporarily redefined to just use </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmsy-10">{</span><span
-class="cmtt-10">\glsentrylong</span><a
- id="dx1-13043"></a><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmsy-10">}</span>
-</div>
-</div> (or case-changing versions). Similarly the short form commands, such as
-<span
-class="cmtt-10">\glsxtrshort</span><a
- id="dx1-13044"></a> or <span
-class="cmtt-10">\acrshort</span><a
- id="dx1-13045"></a> will use <span
-class="cmtt-10">\glsentryshort</span><a
- id="dx1-13046"></a> in the argument of either
-<span
-class="cmtt-10">\glsabbrvfont </span>(for <span
-class="cmtt-10">\glsxtrshort</span>) or <span
-class="cmtt-10">\acronymfont </span>(for <span
-class="cmtt-10">\acrshort</span>). So if the
-<span
-class="cmtt-10">shtml </span>entry had instead been defined as:
-
-
-
- <pre class="verbatim" id="verbatim-87">
-\newacronym{shtml}{SHTML}{\acrshort{ssi}&#x00A0;enabled&#x00A0;\acrshort{html}}
-</pre>
-<!--l. 2878--><p class="nopar" > then (using the <a
-href="#abbrstyle.long-short"><span
-class="cmss-10">long-short</span></a><a
- id="dx1-13047"></a> style) the <a
- id="dx1-13048"></a><a
-href="#glo:firstuse">first use</a> will be like
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-88">
-{\acronymfont{\glsentryshort{ssi}}}&#x00A0;enabled
-{\acronymfont{\glsentryshort{html}}}&#x00A0;(SHTML)
-</pre>
-<!--l. 2884--><p class="nopar" > whereas if the entry is defined as:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-89">
-\newabbreviation{shtml}{SHTML}{\glsxtrshort{ssi}&#x00A0;enabled
-\glsxtrshort{html}}
-</pre>
-<!--l. 2889--><p class="nopar" > then the <a
- id="dx1-13049"></a><a
-href="#glo:firstuse">first use</a> will be like:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-90">
-{\glsabbrvfont{\glsentryshort{ssi}}}&#x00A0;enabled
-{\glsabbrvfont{\glsentryshort{html}}}&#x00A0;(SHTML)
-</pre>
-<!--l. 2894--><p class="nopar" > Note that the first optional argument of <span
-class="cmtt-10">\acrshort </span>or <span
-class="cmtt-10">\glsxtrshort </span>is ignored in
-this context. (The final optional argument will be inserted, if present.) The
-abbreviation style that governs <span
-class="cmtt-10">\glsabbrvfont</span><a
- id="dx1-13050"></a> will be set for <span
-class="cmtt-10">\glsxtrshort</span><a
- id="dx1-13051"></a>. Note
-that <span
-class="cmtt-10">\acrshort </span>doesn&#8217;t set the abbreviation style.
-</p><!--l. 2902--><p class="indent" > Alternatively you can use:
-</p><!--l. 2903--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-13052"></a> <span
-class="cmtt-10">\glsxtrp{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2905--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">field</span>&#x27E9; is the field label and corresponds to a command in the form <span
-class="cmtt-10">\gls</span>&#x27E8;<span
-class="cmti-10">field</span>&#x27E9;
-(e.g.&#x00A0;<span
-class="cmtt-10">\glstext</span>) or in the form <span
-class="cmtt-10">\glsxtr</span>&#x27E8;<span
-class="cmti-10">field</span>&#x27E9; (e.g.&#x00A0;<span
-class="cmtt-10">\glsxtrshort</span>).
-</p><!--l. 2910--><p class="indent" > There&#8217;s a shortcut command for the most common fields:
-</p><!--l. 2911--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-13053"></a> <span
-class="cmtt-10">\glsps{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2913--><p class="noindent" >
-which is equivalent to <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrp{short}</span></span></span><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>, and
-</p><!--l. 2915--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-13054"></a> <span
-class="cmtt-10">\glspt{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2917--><p class="noindent" >
-which is equivalent to <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrp{text}</span></span></span><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>.
-</p><!--l. 2920--><p class="indent" > The <span
-class="cmtt-10">\glsxtrp </span>command behaves much like the <span
-class="cmtt-10">\glsfmt</span>&#x27E8;<span
-class="cmti-10">field</span>&#x27E9; commands described
-in <a
-href="#sec:headtitle"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">5</span> </a><a
-href="#sec:headtitle">Entries in Sectioning Titles, Headers, Captions and Contents<!--tex4ht:ref: sec:headtitle --></a> but
-the post-link hook is also suppressed and extra grouping is added. It automatically
-sets <span
-class="cmss-10">hyper</span><a
- id="dx1-13055"></a> to <span
-class="cmtt-10">false </span>and <span
-class="cmss-10">noindex</span><a
- id="dx1-13056"></a> to <span
-class="cmtt-10">true</span>. If you want to change this, you can
-use
-</p><!--l. 2927--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-13057"></a> <span
-class="cmtt-10">\glsxtrsetpopts{</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2929--><p class="noindent" >
-For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-91">
-\glsxtrsetpopts{hyper=false}
-</pre>
-<!--l. 2933--><p class="nopar" > will just switch off the hyperlinks but not the indexing. Be careful using
-this command or you can end up back to the original problem of nested
-links.
-</p><!--l. 2938--><p class="indent" > The hyper link is re-enabled within glossaries. This is done through the
-command:
-</p><!--l. 2940--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-13058"></a> <span
-class="cmtt-10">\glossxtrsetpopts </span></div><hr>
-</p><!--l. 2942--><p class="noindent" >
-which by default just does
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-92">
-\glsxtrsetpopts{noindex}
-</pre>
-<!--l. 2946--><p class="nopar" > You can redefine this if you want to adjust the setting when <span
-class="cmtt-10">\glsxtrp </span>is used in the
-glossary. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-93">
-\renewcommand{\glossxtrsetpopts}{\glsxtrsetpopts{noindex=false}}
-</pre>
-<!--l. 2951--><p class="nopar" >
-</p><!--l. 2953--><p class="indent" > For example,
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-94">
-\glsxtrp{short}{ssi}
-</pre>
-<!--l. 2956--><p class="nopar" > is equivalent to
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-95">
-{\let\glspostlinkhook\relax
-&#x00A0;\glsxtrshort[hyper=false,noindex]{ssi}[]%
+table.tabular-c
+{
+ display: inline-table;
+ border-collapse: collapse;
+ align: center;
}
-</pre>
-<!--l. 2962--><p class="nopar" > in the main body of the document or
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-96">
-{\let\glspostlinkhook\relax
-&#x00A0;\glsxtrshort[noindex]{ssi}[]%
+table.tabular-r
+{
+ display: inline-table;
+ border-collapse: collapse;
+ align: right;
}
-</pre>
-<!--l. 2968--><p class="nopar" > inside the glossary. (Note the post-link hook is locally disabled.)
-</p><!--l. 2971--><p class="indent" > If <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrp{short}{ssi}</span></span></span> occurs in a sectioning mark, it&#8217;s equivalent
-to
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-97">
-{\glsxtrheadshort{ssi}}
-</pre>
-<!--l. 2975--><p class="nopar" > (which recognises the <a
-href="#catattr.headuc"><span
-class="cmss-10">headuc</span></a><a
- id="dx1-13059"></a> attribute.)
-</p><!--l. 2978--><p class="indent" > If <span
-class="cmss-10">hyperref</span><a
- id="dx1-13060"></a> has been loaded, then the bookmark will use <span
-class="cmtt-10">\glsentry</span>&#x27E8;<span
-class="cmti-10">field</span>&#x27E9;
-(<span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsentryshort{ssi}</span></span></span> in the above example).
-</p><!--l. 2982--><p class="indent" > There are similar commands
-</p><!--l. 2983--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-13061"></a> <span
-class="cmtt-10">\Glsxtrp{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2985--><p class="noindent" >
-for first letter upper case and
-</p><!--l. 2987--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-13062"></a> <span
-class="cmtt-10">\GLSxtrp{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 2989--><p class="noindent" >
-for all upper case.
-</p><!--l. 2992--><p class="indent" > <div class="important" title="Important Note"> If you use any of the case-changing commands, such as <span
-class="cmtt-10">\Gls</span><a
- id="dx1-13063"></a> or <span
-class="cmtt-10">\Glstext</span><a
- id="dx1-13064"></a>, (either
-all caps or first letter upper casing) don&#8217;t use any of the linking commands, such as
-<span
-class="cmtt-10">\gls</span><a
- id="dx1-13065"></a> or <span
-class="cmtt-10">\glstext</span><a
- id="dx1-13066"></a>, in the definition of entries for any of the fields that may be used
-by those case-changing commands. </div>
-</p><!--l. 2998--><p class="noindent" >
-</p><!--l. 3000--><p class="indent" > You can, with care, protect against issue&#x00A0;<a
-href="#itm:nestedfirstucprob">1<!--tex4ht:ref: itm:nestedfirstucprob --></a> by inserting an empty group at the
-start if the long form starts with a command that breaks the first letter uppercasing
-commands like <span
-class="cmtt-10">\Gls</span>, but you still won&#8217;t be able to use the all caps commands, such
-as <span
-class="cmtt-10">\GLS</span>.
-</p><!--l. 3006--><p class="indent" > If you <span
-class="cmti-10">really need </span>nested commands, the safest method is
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-98">
-\newabbreviation{shtml}{shtml}{{}\glsxtrp{short}{ssi}&#x00A0;enabled
-\glsxtrp{short}{html}}
-</pre>
-<!--l. 3010--><p class="nopar" > but be aware that it may have some unexpected results occasionally.
-</p><!--l. 3013--><p class="indent" > Example document:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-99">
-\documentclass{report}
-\usepackage[utf8]{inputenc}
-\usepackage[T1]{fontenc}
-\usepackage{slantsc}
-\usepackage[colorlinks]{hyperref}
-\usepackage[nopostdot=false]{glossaries-extra}
-\makeglossaries
-\setabbreviationstyle{long-short-sc}
-\newabbreviation{ssi}{ssi}{server-side&#x00A0;includes}
-\newabbreviation{html}{html}{hypertext&#x00A0;markup&#x00A0;language}
-\newabbreviation{shtml}{shtml}{{}\glsps{ssi}&#x00A0;enabled&#x00A0;{}\glsps{html}}
-\pagestyle{headings}
-\glssetcategoryattribute{abbreviation}{headuc}{true}
-\glssetcategoryattribute{abbreviation}{glossdesc}{title}
-\begin{document}
-\tableofcontents
-\chapter{\glsfmtfull{shtml}}
-First&#x00A0;use:&#x00A0;\gls{shtml},&#x00A0;\gls{ssi}&#x00A0;and&#x00A0;\gls{html}.
-Next&#x00A0;use:&#x00A0;\gls{shtml},&#x00A0;\gls{ssi}&#x00A0;and&#x00A0;\gls{html}.
-\newpage
-Next&#x00A0;page.
-\printglossaries
-\end{document}
-</pre>
-<!--l. 3051--><p class="nopar" >
-</p><!--l. 3053--><p class="noindent" >
-</p>
-<!--l. 3053--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.9 </span> <a
- id="sec:acronymmods"></a>Acronym Style Modifications</h3>
-<!--l. 3056--><p class="noindent" >The <span
-class="cmss-10">glossaries-extra </span>package provides a new way of dealing with abbreviations and
-
-
-
-redefines <span
-class="cmtt-10">\newacronym</span><a
- id="dx1-14001"></a> to use <span
-class="cmtt-10">\newabbreviation </span>(see <a
-href="#sec:abbreviations"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">4</span>
-</a><a
-href="#sec:abbreviations">Abbreviations<!--tex4ht:ref: sec:abbreviations --></a>). The simplest way to update a document that uses <span
-class="cmtt-10">\newacronym </span>from
-<span
-class="cmss-10">glossaries </span>to <span
-class="cmss-10">glossaries-extra </span>is do just add
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-100">
-\setabbreviationstyle[acronym]{long-short}
-</pre>
-<!--l. 3064--><p class="nopar" > before you define any entries. If you have used commands like <span
-class="cmtt-10">\acrshort</span><a
- id="dx1-14002"></a>, <span
-class="cmtt-10">\acrlong</span><a
- id="dx1-14003"></a>
-and <span
-class="cmtt-10">\acrfull</span><a
- id="dx1-14004"></a>, you need to substitute them with <span
-class="cmtt-10">\glsxtrshort</span><a
- id="dx1-14005"></a>, <span
-class="cmtt-10">\glsxtrlong</span><a
- id="dx1-14006"></a> and
-<span
-class="cmtt-10">\glsxtrfull</span><a
- id="dx1-14007"></a>. (This includes plural and case-changing forms.) Your text editor&#8217;s
-search and replace function should help with this. If you have used the <a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><a
- id="dx1-14008"></a>
-package option then use <a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><span
-class="cmss-10">=ac</span><a
- id="dx1-14009"></a> in order to continue using the shortcut
-commands like <span
-class="cmtt-10">\ac</span><a
- id="dx1-14010"></a>. With this setting, <span
-class="cmtt-10">\acs</span><a
- id="dx1-14011"></a> will use <span
-class="cmtt-10">\glsxtrshort</span><a
- id="dx1-14012"></a> instead of
-<span
-class="cmtt-10">\acrshort</span><a
- id="dx1-14013"></a> etc.
-</p><!--l. 3075--><p class="indent" > For example, the following document using just <span
-class="cmss-10">glossaries</span>
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-101">
-\documentclass{article}
-\usepackage[acronym,nopostdot,toc]{glossaries}
-\makeglossaries
-\setacronymstyle{long-short}
-\newacronym{html}{HTML}{hypertext&#x00A0;markup&#x00A0;language}
-\begin{document}
-\gls{html}
-\printglossaries
-\end{document}
-</pre>
-<!--l. 3086--><p class="nopar" > can be easily adapted to use <span
-class="cmss-10">glossaries-extra</span>:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-102">
-\documentclass{article}
-\usepackage[acronym]{glossaries-extra}
-\makeglossaries
-\setabbreviationstyle[acronym]{long-short}
-\newacronym{html}{HTML}{hypertext&#x00A0;markup&#x00A0;language}
-\begin{document}
-\gls{html}
-\printglossaries
-\end{document}
-</pre>
-<!--l. 3098--><p class="nopar" > Table&#x00A0;<a
-href="#tab:acrabbrvstyles">2.1<!--tex4ht:ref: tab:acrabbrvstyles --></a> lists the nearest equivalent <span
-class="cmss-10">glossaries-extra </span>abbreviation styles for the
-predefined acronym styles provided by <span
-class="cmss-10">glossaries</span>, but note that the new styles use
-different formatting commands. See <a
-href="#sec:predefabbrvstyles"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">4.4</span> </a><a
-href="#sec:predefabbrvstyles">Predefined
-Abbreviation Styles<!--tex4ht:ref: sec:predefabbrvstyles --></a> for further details.
-</p>
- <div class="table">
-
-
-
-<!--l. 3105--><p class="indent" > <a
- id="tab:acrabbrvstyles"></a></p><hr class="float" /><div class="float"
->
-
-
-
- <div class="caption"
-><span class="id">Table&#x00A0;2.1: </span><span
-class="content">Old Acronym Styles <span
-class="cmtt-10">\setacronymstyle{</span>&#x27E8;<span
-class="cmti-10">old-style-name</span>&#x27E9;<span
-class="cmtt-10">} </span>Verses
-New Abbreviation Styles <span
-class="cmtt-10">\setabbreviationstyle[</span>&#x27E8;<span
-class="cmti-10">category</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmti-10">new-style-name</span>&#x27E9;<span
-class="cmtt-10">}</span></span></div><!--tex4ht:label?: x1-140141 -->
-<div class="tabular"> <table id="TBL-2" class="tabular"
+pre { white-space: pre-wrap; }
+div.figure { display: block; text-align: center; }
+div.caption { display: block; text-align: center; }
+div.marginpar { float: right; }
+div.abstract { display: block; margin-right: 4em; margin-left: 4em;}
+div.title { display: block; text-align: center; font-size: x-large;}
+div.author { display: block; text-align: center; font-size: large;}
+div.date { display: block; text-align: center; font-size: medium;}
+div.bibliography { display: block; margin-left: 4em; }
+div.bibitem { display: inline; float: left; text-indent: -3em; }
+span.numberline { display: inline-block; width: 3em; }
+.toc-subsection span.numberline { display: inline-block; width: 3em; }
+.toc-subsubsection span.numberline { display: inline-block; width: 4em; }
+.toc-paragraph span.numberline { display: inline-block; width: 5em; }
+.toc-subparagraph span.numberline { display: inline-block; width: 6em; }
+nav ul { list-style-type: none; }
+.toc-part { padding-left: 0em; padding-bottom: 1ex; padding-top: 1ex; font-weight: bold; font-size: large;}
+.toc-chapter { padding-left: 0em; padding-bottom: .25ex; padding-top: .25ex; font-weight: bold; }
+.toc-section { padding-left: .5em; }
+.toc-subsection { padding-left: 1.5em; }
+.toc-subsubsection { padding-left: 2em; }
+.toc-paragraph { padding-left: 2.5em; }
+.toc-subparagraph { padding-left: 3em; }
+.part { font-size: x-large; font-weight: bold; }
+div.bigskip { padding-left: 0pt; padding-right: 0pt; padding-top: 0pt; padding-bottom: 2ex;}
+div.medskip { padding-left: 0pt; padding-right: 0pt; padding-top: 0pt; padding-bottom: 1ex;}
+div.smallskip { padding-left: 0pt; padding-right: 0pt; padding-top: 0pt; padding-bottom: .5ex;}
+span.quad { padding-left: 0pt; padding-right: 1em; padding-top: 0pt; padding-bottom: 0pt;}
+span.qquad { padding-left: 0pt; padding-right: 2em; padding-top: 0pt; padding-bottom: 0pt;}
+.displaylist { display: block; list-style-type: none; }
+.inlinelist { display: inline; }
+dl.inlinetitle dt { display: inline-block; margin-left: 0; margin-right: 1em;}
+dl.inlinetitle dd { display: inline; margin: 0; }
+dl.inlinetitle dd::after { display: block; content: ''; }
+dl.inlineblock dt { display: inline-block; margin-left: 0; margin-right: 1em;}
+dl.inlineblock dd { display: inline; margin: 0; }
+dl.inlineblock dd::after { display: block; content: ''; }
+.clearfix::after { content: ""; clear: both; display: table; }
+span.inlineitem { margin-right: .5em; margin-left: .5em; }
+span.numitem { float: left; margin-left: -3em; text-align: right; min-width: 2.5em; }
+span.bulletitem { float: left; margin-left: -1em; }
+span.descitem { font: normal; font-weight: bold; }
+div.indexspace { min-height: 2ex; }
+.cell-noborder-nosep-r {border-top: none; border-right: none; border-left: none; padding-left: 0px; padding-right: 0px; text-align: right; }
+.cell-noborder-bothsep-l {border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; padding-right: 6.000000pt; text-align: left; }
+.cell-noborder-bothsep-r {border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; padding-right: 6.000000pt; text-align: right; }
+.cell-noborder-bothsep-halfwidth {border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 50.000000%; padding-right: 6.000000pt; text-align: left; }
+.cell-noborder-nosep-l {border-top: none; border-right: none; border-left: none; padding-left: 0px; padding-right: 0px; text-align: left; }
+.cell-noborder-rightsep-l {border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; padding-right: 0px; text-align: left; }
+.cell-noborder-leftsep-r {border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; padding-right: 0px; text-align: right; }
+.cell-noborder-bothsep-c {border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; padding-right: 6.000000pt; text-align: center; }
+.cell-noborder-bothsep-eightypc {border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 80.000000%; padding-right: 6.000000pt; text-align: left; }
+.cell-noborder-rightsep-c {border-top: none; border-right: none; border-left: none; padding-left: 0px; padding-right: 6.000000pt; text-align: center; }
+.cell-noborder-bothsep-threequarterwidth {border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 75.000000%; padding-right: 6.000000pt; text-align: left; }
+.cell-noborder-rightsep-r {border-top: none; border-right: none; border-left: none; padding-left: 0px; padding-right: 6.000000pt; text-align: right; }
+.cell-noborder-bothsep-quarterwidth {border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 25.000000%; padding-right: 6.000000pt; text-align: left; }
+.cell-noborder-rightsep-c {border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; padding-right: 0px; text-align: center; }
+.cell-noborder-rightsep-l {border-top: none; border-right: none; border-left: none; padding-left: 0px; padding-right: 6.000000pt; text-align: left; }
+.cell-noborder-nosep-c {border-top: none; border-right: none; border-left: none; padding-left: 0px; padding-right: 0px; text-align: center; }
+span.mbox {border-style: none; }
+span.frame {border-style: solid; border-width: 1.000000pt; padding: 0.000000pt; }
+span.boxed {text-align: center; vertical-align: middle; border-style: solid; border-width: 2.000000pt; padding: 0.000000pt; width: 1.000000em; height: 1.000000em; display: inline-block; }
+span.circled {text-align: center; vertical-align: middle; border-style: solid; border-width: 2.000000pt; padding: 1.000000pt; border-radius: 5000.000000%;width: 1.000000em; height: 1.000000em; display: inline-block; }
+span.overlapped {text-align: center; border-style: none; padding: 0.000000pt; width: 1.000000em; height: 1.000000em; display: inline-block; }
+span.overlapper {text-align: center; border-style: none; padding: 0.000000pt; margin-left: -1.000000em; width: 1.000000em; height: 1.000000em; display: inline-block; }
+span.overlappertop {text-align: center; vertical-align: top; border-style: none; padding: 0.000000pt; margin-left: -1.000000em; width: 1.000000em; height: 1.000000em; display: inline-block; }
+span.partialoverlapper {text-align: center; border-style: none; padding: 0.000000pt; margin-left: -0.750000em; width: 1.000000em; height: 1.000000em; display: inline-block; }
+span.quarterleft {text-align: center; vertical-align: middle; border-style: none; padding: 0.000000pt; transform: rotate(-90.000000deg); -ms-transform: rotate(-90.000000deg); -webkit-transform: rotate(-90.000000deg); display: inline-block; }
+span.quarterright {text-align: center; vertical-align: middle; border-style: none; padding: 0.000000pt; transform: rotate(90.000000deg); -ms-transform: rotate(90.000000deg); -webkit-transform: rotate(90.000000deg); display: inline-block; }
+span.eighthleft {text-align: center; vertical-align: middle; border-style: none; padding: 0.000000pt; transform: rotate(-45.000000deg); -ms-transform: rotate(-45.000000deg); -webkit-transform: rotate(-45.000000deg); display: inline-block; }
+span.eighthright {text-align: center; vertical-align: middle; border-style: none; padding: 0.000000pt; transform: rotate(45.000000deg); -ms-transform: rotate(45.000000deg); -webkit-transform: rotate(45.000000deg); display: inline-block; }
+span.halfturn {text-align: center; vertical-align: middle; border-style: none; padding: 0.000000pt; transform: rotate(180.000000deg); -ms-transform: rotate(180.000000deg); -webkit-transform: rotate(180.000000deg); display: inline-block; }
+span.fwsdisabledicon {border-style: none; color: gray; }
+span.fwsactiveicon {border-style: none; color: green; }
+span.glsshowtargetfonttext {font-family: monospace; font-size: x-small; border-style: none; }
+dfn { font-style: normal; font-weight: bold; } a { text-decoration: none; } a:hover { text-decoration: underline; } div.tablefns { border-top: solid; } div.example { border-bottom: solid silver; padding: 20px; } div.example div.title { font-weight: bold; font-size: large; }
+div.sidenote {font-size: x-small; float: right; border-style: none; }
+span.advantage {border-style: none; color: green; }
+span.disadvantage {border-style: none; color: red; }
+strong.strong {font-weight: bold; border-style: none; }
+em.booktitle {font-style: italic; font-variant: normal; border-style: none; }
+code.code {font-family: monospace; border-style: none; }
+code.cmd {font-family: monospace; border-style: none; }
+span.cmdfmt {font-family: monospace; border-style: none; }
+span.comment {border-style: none; color: rgb(94,94,94); }
+code.csfmt {font-family: monospace; border-style: none; color: rgb(84,111,26); }
+span.csfmtfont {font-family: monospace; border-style: none; }
+span.csfmtcolourfont {font-family: monospace; border-style: none; color: rgb(84,111,26); }
+span.appfmt {font-family: monospace; border-style: none; }
+span.styfmt {font-family: monospace; border-style: none; }
+span.clsfmt {font-family: monospace; border-style: none; }
+span.envfmt {font-family: monospace; border-style: none; }
+span.optfmt {font-family: monospace; border-style: none; }
+span.csoptfmt {font-family: monospace; border-style: none; color: rgb(104,34,139); }
+span.styoptfmt {font-family: monospace; border-style: none; color: rgb(104,34,139); }
+span.clsoptfmt {font-family: monospace; border-style: none; }
+span.ctrfmt {font-family: monospace; border-style: none; }
+span.filefmt {font-family: monospace; border-style: none; }
+span.extfmt {font-family: monospace; border-style: none; }
+span.deprecatedorbannedfmt {border-style: none; color: rgb(204,0,0); }
+span.summarylocfmt {font-style: italic; font-variant: normal; border-style: none; }
+span.menufmt {font-family: monospace; border-style: none; }
+code.cbeg {font-family: monospace; border-style: none; }
+code.cend {font-family: monospace; border-style: none; }
+span.termslocfmt {font-style: italic; font-variant: normal; border-style: none; }
+span.crossreftag {font-style: italic; font-variant: normal; border-style: none; }
+div.crossref {border-style: none; margin-left: 1.000000em; }
+span.longargfmt {font-family: monospace; border-style: none; }
+span.shortargfmt {font-family: monospace; border-style: none; }
+span.qt {border-style: none; }
+code.qtt {font-family: monospace; border-style: none; }
+em.metainner {font-style: italic; font-variant: normal; border-style: none; }
+span.meta {font-family: serif; border-style: none; color: black; }
+em.initvalnotefmtinner {font-style: italic; font-variant: normal; border-style: none; }
+span.initvalnotefmt {font-family: serif; border-style: none; color: black; }
+span.summarytag {font-style: italic; font-variant: normal; border-style: none; }
+div.importanttitle {text-align: right; border-style: none; color: red; }
+div.important {border-style: solid; border-color: red; border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(255,235,235); }
+div.warningtitle {text-align: right; border-style: none; color: red; }
+div.warning {border-style: solid; border-color: red; border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(255,235,235); }
+div.informationtitle {text-align: right; border-style: none; color: rgb(0,128,128); }
+div.information {border-style: solid; border-color: rgb(0,128,128); border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(240,255,255); }
+div.pinnedboxtitle {text-align: right; border-style: none; color: black; }
+div.pinnedbox {border-style: solid; border-color: black; border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(255,255,191); }
+div.terminaltitle {text-align: right; border-style: none; color: black; }
+pre.terminal {font-family: monospace; border-style: solid; border-color: black; border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(250,250,250); }
+div.transcripttitle {text-align: right; border-style: none; color: black; }
+pre.transcript {font-family: monospace; border-style: solid; border-color: black; border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(250,250,250); }
+div.ctrboxtitle {text-align: right; border-style: none; color: black; }
+div.ctrbox {border-style: solid; border-color: black; border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(255,255,191); }
+div.codeboxtitle {text-align: right; border-style: none; color: black; }
+pre.codebox {font-family: monospace; border-style: solid; border-color: black; border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(250,250,250); }
+div.resultboxtitle {text-align: right; border-style: none; color: black; }
+div.resultbox {border-style: solid; border-color: black; border-width: 2.000000pt; padding: 2.000000pt; }
+div.badcodeboxtitle {text-align: right; border-style: none; color: black; }
+pre.badcodebox {font-family: monospace; border-style: solid; border-color: black; border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(250,250,250); }
+div.unicodeboxtitle {text-align: right; border-style: none; color: black; }
+pre.unicodebox {font-family: monospace; border-style: solid; border-color: black; border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(250,250,250); }
+pre.compactcodebox {font-family: monospace; border-style: solid; border-color: black; border-width: 1.000000pt; padding: 2.000000pt; background-color: rgb(250,250,250); }
+pre.sidebysidecode {font-family: monospace; font-size: small; vertical-align: top; border-style: solid; border-color: black; border-width: 1.000000pt; padding: 2.000000pt; margin-right: 3.000000%; margin-top: 0.000000pt; background-color: rgb(250,250,250); width: 47.000000%; display: inline-block; }
+div.sidebysideresult {vertical-align: top; border-style: solid; border-color: black; border-width: 1.000000pt; padding: 2.000000pt; margin-top: 0.000000pt; width: 47.000000%; display: inline-block; }
+div.defnbox {border-style: solid; border-color: black; border-width: 1.000000pt; padding: 2.000000pt; background-color: rgb(255,255,191); }
+div.optionsummarybox {border-style: solid; border-color: black; border-width: 1.000000pt; padding: 2.000000pt; background-color: rgb(255,255,191); }
+div.optionvaluesummarybox {border-style: none; margin-left: 40.000000pt; }
+span.floatrightbox {float: right; border-style: none; }
+div.noteBox {border-style: none; }
+div.settingsboxtitle {text-align: right; border-style: none; color: black; }
+div.settingsbox {border-style: solid; border-color: black; border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(255,255,227); }
+div.optionvalueboxtitle {text-align: right; border-style: none; color: black; }
+div.optionvaluebox {border-style: solid; border-color: black; border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(255,255,245); }
+div.nlctuserguideidx0 {border-style: none; margin-left: 0.000000pt; }
+div.nlctuserguideidx1 {border-style: none; margin-left: 20.000000pt; }
+div.nlctuserguideidx2 {border-style: none; margin-left: 40.000000pt; }
+div.nlctusernavbox {border-style: none; }
+div.abstractheader {font-weight: bold; text-align: center; border-style: none; }
+div.filedef {font-family: monospace; text-align: left; border-style: none; }
+div.tablefn {font-size: x-small; border-style: none; }
+div.tablefns {text-align: left; border-style: none; width: 80.000000%; }
+code.fieldfmt {font-family: monospace; border-style: none; color: rgb(82,139,139); }
+code.entryfmt {font-family: monospace; border-style: none; color: rgb(54,100,139); }
+span.acrstylefmt {font-family: sans-serif; border-style: none; }
+span.abbrstylefmt {font-family: sans-serif; border-style: none; color: rgb(0,0,139); }
+span.glostylefmt {font-family: sans-serif; border-style: none; }
+span.catattrfmt {font-family: sans-serif; border-style: none; color: rgb(85,26,139); }
+</style>
+</head>
+<body>
+<div id="main">
+ <header><div class="title"><span class="styfmt">glossaries-extra.sty</span> v1.49: an extension to the <span class="styfmt">glossaries</span> package</div><!-- end of title --><div class="author">Nicola L.C. Talbot<br>
+
+ Dickimaw Books<br>
+
+ <a href="https://www.dickimaw-books.com/">dickimaw-books.com</a></div><!-- end of author --><div class="date">2022-10-14 </div><!-- end of date --></header><p>
+<p>
+
+<div class="abstract"><div class="abstractheader">Abstract</div><!-- end of abstractheader -->
+ The <a id="wrglossary.1"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package is an extension to the <a id="wrglossary.2"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, providing additional features. In particular, it provides a completely different abbreviation mechanism. You will need at least <a id="wrglossary.3"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> version 4.19, but it is best to update both packages at the same time, if new releases are available for both of them. </div><!-- end of abstract -->
+<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+The <a id="wrglossary.4"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package uses a different set of defaults to the base <a id="wrglossary.5"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. This means that if you simply replace <a id="wrglossary.6"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> with <a id="wrglossary.7"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> in an existing document, there may be some differences in the PDF, and you may encounter errors. See §<a href="#sec:defaults">1.1</a> for more details. </div><!-- end of warning -->
+<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+This document assumes some familiarity with the <a id="wrglossary.8"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. If you are new to <a id="wrglossary.9"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>, you may prefer to start with the following:
+<ul class="displaylist">
+ <li><span class="bulletitem">•</span><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/glossariesbegin.html">The <span class="styfmt">glossaries</span> package: a guide for beginners</a> <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div><a href="https://www.tug.org/texdoc/">texdoc</a> glossariesbegin</pre><p>
+<li><span class="bulletitem">•</span><a href="http://mirrors.ctan.org/support/bib2gls/bib2gls-begin.pdf"><span class="styfmt">glossaries-extra</span> and <span class="appfmt">bib2gls</span>: an introductory guide</a> <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div><a href="https://www.tug.org/texdoc/">texdoc</a> bib2gls-begin</pre>
+</ul>
+ </div><!-- end of information -->
+<p>
+<nav class="toc">
+<section id="toc"><!-- start of section toc --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->Contents<div class="labellink"><a href="#toc">[link]</a></div></h1><!-- end of chapter header -->
+
+<ul>
+<li class="toc-chapter"><a href="#sec:listofexamples">List of Examples</a></li><!-- end of toc-chapter -->
+
+<li class="toc-part"><a href="#part.I"><span class="numberline">I</span>User Guide</a></li><!-- end of toc-part -->
+
+<li class="toc-chapter"><a href="#sec:intro"><span class="numberline">1</span>Introduction</a></li><!-- end of toc-chapter -->
+
+<ul>
+<li class="toc-section"><a href="#sec:defaults"><span class="numberline">1.1</span>Package Defaults</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:examplediffs"><span class="numberline">1.2</span>Example Differences Between <span class="styfmt">glossaries</span> and <span class="styfmt">glossaries-extra</span></a></li><!-- end of toc-section -->
+
+<ul>
+<li class="toc-subsection"><a href="#sec:examplediffsbasic"><span class="numberline">1.2.1</span>Basic defaults</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:examplediffslang"><span class="numberline">1.2.2</span>Language defaults</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:examplediffsmemoir"><span class="numberline">1.2.3</span>Combined with <span class="clsfmt">memoir</span></a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:examplediffsabbrv"><span class="numberline">1.2.4</span>Abbreviations</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:examplediffprintgloss"><span class="numberline">1.2.5</span>Glossary Mid-Build Placeholder (<code class="csfmt">\printglossary</code>)</a></li><!-- end of toc-subsection -->
+</ul>
+<li class="toc-section"><a href="#sec:reading"><span class="numberline">1.3</span>Further Reading</a></li><!-- end of toc-section -->
+</ul>
+<li class="toc-chapter"><a href="#sec:pkgopts"><span class="numberline">2</span>Package Options</a></li><!-- end of toc-chapter -->
+
+<ul>
+<li class="toc-section"><a href="#sec:gloslistopts"><span class="numberline">2.1</span>Glossary Lists</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:glosstyleopts"><span class="numberline">2.2</span>Glossary Style Options</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:otherpkgopts"><span class="numberline">2.3</span>Loading Other Packages</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:refindexopts"><span class="numberline">2.4</span>Entry Definitions, References and Indexing</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:debuggingopts"><span class="numberline">2.5</span>Debugging</a></li><!-- end of toc-section -->
+</ul>
+<li class="toc-chapter"><a href="#sec:newentry"><span class="numberline">3</span>Defining Entries</a></li><!-- end of toc-chapter -->
+
+<ul>
+<li class="toc-section"><a href="#sec:newentrydefs"><span class="numberline">3.1</span>Command Definitions</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:newkeys"><span class="numberline">3.2</span>Glossary Entry Keys</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:plurals"><span class="numberline">3.3</span>Plurals</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:alias"><span class="numberline">3.4</span>Entry Aliases</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:setfields"><span class="numberline">3.5</span>Setting or Updating Fields</a></li><!-- end of toc-section -->
+</ul>
+<li class="toc-chapter"><a href="#sec:abbreviations"><span class="numberline">4</span>Abbreviations</a></li><!-- end of toc-chapter -->
+
+<ul>
+<li class="toc-section"><a href="#sec:newabbr"><span class="numberline">4.1</span>Defining Abbreviations</a></li><!-- end of toc-section -->
+
+<ul>
+<li class="toc-subsection"><a href="#sec:abbrvfieldslongshort"><span class="numberline">4.1.1</span>Abbreviation Fields: <span style="font-family: monospace; ">long</span> and <span style="font-family: monospace; ">short</span></a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:abbrvfieldslongshortpl"><span class="numberline">4.1.2</span>Abbreviation Fields: <span style="font-family: monospace; ">longplural</span> and <span style="font-family: monospace; ">shortplural</span></a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:abbrvfieldsnamedesc"><span class="numberline">4.1.3</span>Abbreviation Fields: <span style="font-family: monospace; ">name</span> and <span style="font-family: monospace; ">description</span></a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:abbrvfieldstype"><span class="numberline">4.1.4</span>Abbreviation Fields: <span style="font-family: monospace; ">type</span></a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:abbrvgeneralhooks"><span class="numberline">4.1.5</span>General Hooks</a></li><!-- end of toc-subsection -->
+</ul>
+<li class="toc-section"><a href="#sec:abbrvmakeindexvsbib2gls"><span class="numberline">4.2</span>Examples: <span style="font-family: monospace; ">makeindex</span> vs <span style="font-family: monospace; ">bib2gls</span></a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:abbrvfieldrefs"><span class="numberline">4.3</span>Referencing (Using) Abbreviations</a></li><!-- end of toc-section -->
+
+<ul>
+<li class="toc-subsection"><a href="#sec:abbrprefixes"><span class="numberline">4.3.1</span>Prefixes</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:abbrshortcuts"><span class="numberline">4.3.2</span>Abbreviation Shortcut Commands</a></li><!-- end of toc-subsection -->
+</ul>
+<li class="toc-section"><a href="#sec:tagging"><span class="numberline">4.4</span>Tagging Initials</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:abbrstyle"><span class="numberline">4.5</span>Abbreviation Styles</a></li><!-- end of toc-section -->
+
+<ul>
+<li class="toc-subsection"><a href="#sec:predefabbrstyles"><span class="numberline">4.5.1</span>Predefined Abbreviation Styles</a></li><!-- end of toc-subsection -->
+
+<ul>
+<li class="toc-subsubsection"><a href="#sec:predefregabbrvstyles"><span class="numberline">4.5.1.1</span>Regular Styles</a></li><!-- end of toc-subsubsection -->
+
+<ul>
+<li class="toc-paragraph"><a href="#sec:predefregabbrvstylesshort"><span class="numberline">4.5.1.1.1</span>Short Styles</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#sec:predefregabbrvstyleslong"><span class="numberline">4.5.1.1.2</span>Long Styles</a></li><!-- end of toc-paragraph -->
+</ul>
+<li class="toc-subsubsection"><a href="#sec:predefnonregabbrvstyles"><span class="numberline">4.5.1.2</span>Non-Regular Styles</a></li><!-- end of toc-subsubsection -->
+
+<ul>
+<li class="toc-paragraph"><a href="#sec:predefnonregabbrvstyleslongshort"><span class="numberline">4.5.1.2.1</span>Long (Short) Styles</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#sec:predefnonregabbrvstyleslongshortuser"><span class="numberline">4.5.1.2.2</span>Long (Short, User) Styles</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#sec:predefnonregabbrvstylesshortlong"><span class="numberline">4.5.1.2.3</span>Short (Long) Styles</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#sec:predefnonregabbrvstylesshortlonguser"><span class="numberline">4.5.1.2.4</span>Short (Long, User) Styles</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#sec:predefnonregabbrvstyleshyphen"><span class="numberline">4.5.1.2.5</span>Hyphen Styles</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#sec:predefnonregabbrvstylesonly"><span class="numberline">4.5.1.2.6</span>Only Styles</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#sec:predefnonregabbrvstylesfootnote"><span class="numberline">4.5.1.2.7</span>Footnote Styles</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#sec:predefnonregabbrvstylesshort"><span class="numberline">4.5.1.2.8</span>Short Styles</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#sec:predefnonregabbrvstyleslong"><span class="numberline">4.5.1.2.9</span>Long Styles</a></li><!-- end of toc-paragraph -->
+</ul>
+<li class="toc-subsubsection"><a href="#sec:abbrvcmds"><span class="numberline">4.5.1.3</span>Formatting Commands and Hooks</a></li><!-- end of toc-subsubsection -->
+
+<ul>
+<li class="toc-paragraph"><a href="#sec:abbrvcmdsgeneral"><span class="numberline">4.5.1.3.1</span>General</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#sec:abbrvcmdsparen"><span class="numberline">4.5.1.3.2</span>Parenthetical Styles</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#sec:abbrvcmdsuser"><span class="numberline">4.5.1.3.3</span>User Styles</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#sec:abbrvcmdsfootnote"><span class="numberline">4.5.1.3.4</span>Footnote Styles</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#sec:abbrvcmdsnolong"><span class="numberline">4.5.1.3.5</span>No-Long Styles</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#sec:abbrvcmdsnoshort"><span class="numberline">4.5.1.3.6</span>No-Short Styles</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#sec:abbrvcmdshyphen"><span class="numberline">4.5.1.3.7</span>Hyphen Styles</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#sec:abbrvcmdsonly"><span class="numberline">4.5.1.3.8</span>Only Styles</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#sec:abbrvcmdsfonts"><span class="numberline">4.5.1.3.9</span>Fonts</a></li><!-- end of toc-paragraph -->
+</ul></ul>
+<li class="toc-subsection"><a href="#sec:advancedabbrstylecmds"><span class="numberline">4.5.2</span>Advanced Style Commands</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:newabbrvstyle"><span class="numberline">4.5.3</span>Defining New Abbreviation Styles</a></li><!-- end of toc-subsection -->
+
+<ul>
+<li class="toc-subsubsection"><a href="#sec:abbrstyleinit"><span class="numberline">4.5.3.1</span>Style Initialisation Hooks</a></li><!-- end of toc-subsubsection -->
+
+<li class="toc-subsubsection"><a href="#sec:abbrstylefmts"><span class="numberline">4.5.3.2</span>Style Formatting Commands</a></li><!-- end of toc-subsubsection -->
+
+<ul>
+<li class="toc-paragraph"><a href="#paragraph.4.5.3.2.1"><span class="numberline">4.5.3.2.1</span>Suffix and Fonts</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#paragraph.4.5.3.2.2"><span class="numberline">4.5.3.2.2</span>First Use Display Format</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#paragraph.4.5.3.2.3"><span class="numberline">4.5.3.2.3</span>Subsequent Use Display Format</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#paragraph.4.5.3.2.4"><span class="numberline">4.5.3.2.4</span>Inline Full Format</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#paragraph.4.5.3.2.5"><span class="numberline">4.5.3.2.5</span>Wrapper Commands</a></li><!-- end of toc-paragraph -->
+</ul></ul></ul>
+<li class="toc-section"><a href="#sec:acrorevert"><span class="numberline">4.6</span>Restoring Base Acronym Mechanism</a></li><!-- end of toc-section -->
+</ul>
+<li class="toc-chapter"><a href="#sec:glsref"><span class="numberline">5</span>Referencing (Using) Entries</a></li><!-- end of toc-chapter -->
+
+<ul>
+<li class="toc-section"><a href="#sec:glsopts"><span class="numberline">5.1</span>Options</a></li><!-- end of toc-section -->
+
+<ul>
+<li class="toc-subsection"><a href="#sec:defaultglsopts"><span class="numberline">5.1.1</span>Setting Up Defaults</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:xtrglsopts"><span class="numberline">5.1.2</span>Additional Options</a></li><!-- end of toc-subsection -->
+</ul>
+<li class="toc-section"><a href="#sec:casechange"><span class="numberline">5.2</span>Case Changing</a></li><!-- end of toc-section -->
+
+<ul>
+<li class="toc-subsection"><a href="#sec:firstuc"><span class="numberline">5.2.1</span>Sentence Case Commands</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:lowercase"><span class="numberline">5.2.2</span>Lower Case</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:uppercase"><span class="numberline">5.2.3</span>Upper Case</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:titlecase"><span class="numberline">5.2.4</span>Title Case</a></li><!-- end of toc-subsection -->
+</ul>
+<li class="toc-section"><a href="#sec:headtitle"><span class="numberline">5.3</span>Entries in Sectioning Titles, Headers, Captions and Contents</a></li><!-- end of toc-section -->
+
+<ul>
+<li class="toc-subsection"><a href="#sec:simplisticapproach"><span class="numberline">5.3.1</span>Simplistic Approach</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:headingcommands"><span class="numberline">5.3.2</span>New Commands Designed for Chapter/Section Headings or Captions</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:headingsadvanced"><span class="numberline">5.3.3</span>Advanced Commands</a></li><!-- end of toc-subsection -->
+</ul>
+<li class="toc-section"><a href="#sec:nested"><span class="numberline">5.4</span>Nested Links</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:entryfmtmods"><span class="numberline">5.5</span>Adjusting the Text Style</a></li><!-- end of toc-section -->
+
+<ul>
+<li class="toc-subsection"><a href="#sec:glstextformat"><span class="numberline">5.5.1</span>Outer Formatting</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:middleformat"><span class="numberline">5.5.2</span>Middle Formatting</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:innertextformat"><span class="numberline">5.5.3</span>Inner Formatting</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:postlinkhook"><span class="numberline">5.5.4</span>Post Link Hook</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:entryfmt"><span class="numberline">5.5.5</span>Entry Format Style</a></li><!-- end of toc-subsection -->
+</ul>
+<li class="toc-section"><a href="#sec:hyper"><span class="numberline">5.6</span>Hyperlinks</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:labelprefixes"><span class="numberline">5.7</span>Label Prefixes</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:wrglossary"><span class="numberline">5.8</span>Indexing</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:xr"><span class="numberline">5.9</span>Cross-Referencing</a></li><!-- end of toc-section -->
+
+<ul>
+<li class="toc-subsection"><a href="#sec:seenoindex"><span class="numberline">5.9.1</span>Entries that may not be required</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:getsee"><span class="numberline">5.9.2</span>Accessing the Cross-Referencing Fields</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:glssee"><span class="numberline">5.9.3</span>Cross-Reference Indexing</a></li><!-- end of toc-subsection -->
+</ul>
+<li class="toc-section"><a href="#sec:glsunset"><span class="numberline">5.10</span>First Use Flag</a></li><!-- end of toc-section -->
+
+<ul>
+<li class="toc-subsection"><a href="#sec:unsetbuffer"><span class="numberline">5.10.1</span>Buffering Unsets</a></li><!-- end of toc-subsection -->
+</ul>
+<li class="toc-section"><a href="#sec:getfields"><span class="numberline">5.11</span>Accessing Fields</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#section.5.12"><span class="numberline">5.12</span>Encapsulation (Formatting) Based on Field Values</a></li><!-- end of toc-section -->
+
+<ul>
+<li class="toc-subsection"><a href="#sec:foreignfield"><span class="numberline">5.12.1</span>Foreign Language Field</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:glsxtrfmt"><span class="numberline">5.12.2</span>Associated Entry Format</a></li><!-- end of toc-subsection -->
+</ul>
+<li class="toc-section"><a href="#sec:csvfields"><span class="numberline">5.13</span>Comma-Separated Lists</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:listfields"><span class="numberline">5.14</span>List Fields</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:fieldconditionals"><span class="numberline">5.15</span>Field Conditionals</a></li><!-- end of toc-section -->
+</ul>
+<li class="toc-chapter"><a href="#sec:countref"><span class="numberline">6</span>Counting References</a></li><!-- end of toc-chapter -->
+
+<ul>
+<li class="toc-section"><a href="#sec:entrycount"><span class="numberline">6.1</span>Entry Counting (First Use Flag)</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:linkcount"><span class="numberline">6.2</span>Link Counting</a></li><!-- end of toc-section -->
+</ul>
+<li class="toc-chapter"><a href="#sec:multientries"><span class="numberline">7</span>Multi (or Compound) Entries</a></li><!-- end of toc-chapter -->
+
+<ul>
+<li class="toc-section"><a href="#sec:mglsexamples"><span class="numberline">7.1</span>Examples</a></li><!-- end of toc-section -->
+
+<ul>
+<li class="toc-subsection"><a href="#sec:mglsexhier"><span class="numberline">7.1.1</span>Example: Hierarchical</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:mglsexsuffix"><span class="numberline">7.1.2</span>Example: Suffix</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:mglsexcatsuffix"><span class="numberline">7.1.3</span>Example: Category Suffix</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:mglsexsep"><span class="numberline">7.1.4</span>Example: Separators</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:exskipfirstsuffix"><span class="numberline">7.1.5</span>Example: Skipping Elements (Fragment Element)</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:exskippostlink"><span class="numberline">7.1.6</span>Example: Skipping Elements (Prefix and Post-Link Hooks)</a></li><!-- end of toc-subsection -->
+</ul>
+<li class="toc-section"><a href="#sec:mglsmain"><span class="numberline">7.2</span>Main and Other Elements</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:mglsfixes"><span class="numberline">7.3</span>Prefixes and Suffixes</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:mglssep"><span class="numberline">7.4</span>Separators</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:mglselementhooks"><span class="numberline">7.5</span><code class="csfmt">\mgls</code> Element Hooks</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:mglspostlinkhook"><span class="numberline">7.6</span>Post-Link Hook</a></li><!-- end of toc-section -->
+
+<ul>
+<li class="toc-subsection"><a href="#sec:mglspostlinkhooklastelement"><span class="numberline">7.6.1</span>Last Element</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:mglspostlinkhookmainelement"><span class="numberline">7.6.2</span>Main Element</a></li><!-- end of toc-subsection -->
+</ul>
+<li class="toc-section"><a href="#sec:mglsfirstuse"><span class="numberline">7.7</span>Multi-Entry First Use</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:multiglscategory"><span class="numberline">7.8</span>Multi-Entry Category</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:multiglsoptions"><span class="numberline">7.9</span>Multi-Entry Settings</a></li><!-- end of toc-section -->
+
+<ul>
+<li class="toc-subsection"><a href="#sec:multiglsoptionsindexing"><span class="numberline">7.9.1</span>Indexing</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:multiglsoptionsencap"><span class="numberline">7.9.2</span>Location Formats (Encaps)</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:multiglsoptionspostlink"><span class="numberline">7.9.3</span>Post-Link Hooks</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:multiglsoptionsfixes"><span class="numberline">7.9.4</span>Prefixes and Suffixes</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:multiglsoptionsskip"><span class="numberline">7.9.5</span>Skipping Elements</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:multiglsoptionsgeneral"><span class="numberline">7.9.6</span>General</a></li><!-- end of toc-subsection -->
+</ul>
+<li class="toc-section"><a href="#sec:mglsopts"><span class="numberline">7.10</span><code class="csfmt">\mgls</code> Options</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:mglslike"><span class="numberline">7.11</span>Variants of <code class="csfmt">\mgls</code></a></li><!-- end of toc-section -->
+
+<ul>
+<li class="toc-subsection"><a href="#sec:mglsbasic"><span class="numberline">7.11.1</span><code class="csfmt">\gls</code>-like</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:mglsabbrv"><span class="numberline">7.11.2</span>Abbreviations</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:mglsotherfields"><span class="numberline">7.11.3</span>Other Fields</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:mpgls"><span class="numberline">7.11.4</span>Support for <span class="styfmt">glossaries-prefix</span> (<code class="csfmt">\pgls</code>)</a></li><!-- end of toc-subsection -->
+</ul>
+<li class="toc-section"><a href="#sec:msee"><span class="numberline">7.12</span>Cross-References</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:multiextras"><span class="numberline">7.13</span>Additional Commands</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:mbib2gls"><span class="numberline">7.14</span><span class="appfmt">bib2gls</span></a></li><!-- end of toc-section -->
+</ul>
+<li class="toc-chapter"><a href="#sec:glossaries"><span class="numberline">8</span>Defining and Displaying Glossaries</a></li><!-- end of toc-chapter -->
+
+<ul>
+<li class="toc-section"><a href="#sec:glspageref"><span class="numberline">8.1</span>Entry Page Reference</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:glospreamble"><span class="numberline">8.2</span>Glossary Preamble</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:printglossopts"><span class="numberline">8.3</span>Options</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:printunsrt"><span class="numberline">8.4</span>Displaying a Glossary Without Sorting or Indexing</a></li><!-- end of toc-section -->
+
+<ul>
+<li class="toc-subsection"><a href="#sec:printunsrtgroups"><span class="numberline">8.4.1</span>Groups and Hierarchy</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:printunsrtlocations"><span class="numberline">8.4.2</span>Location Lists</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:printunsrtadvanced"><span class="numberline">8.4.3</span>Advanced Commands</a></li><!-- end of toc-subsection -->
+
+<ul>
+<li class="toc-subsubsection"><a href="#sec:printunsrtinner"><span class="numberline">8.4.3.1</span>Inner Glossaries</a></li><!-- end of toc-subsubsection -->
+
+<li class="toc-subsubsection"><a href="#sec:printunsrtunit"><span class="numberline">8.4.3.2</span>Per-Unit Glossaries</a></li><!-- end of toc-subsubsection -->
+</ul></ul>
+<li class="toc-section"><a href="#sec:glossentry"><span class="numberline">8.5</span>Standalone Entry Items</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:glosstylemods"><span class="numberline">8.6</span>Glossary Style Modifications</a></li><!-- end of toc-section -->
+
+<ul>
+<li class="toc-subsection"><a href="#sec:postnamehooks"><span class="numberline">8.6.1</span>Post-Name Hooks</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:postdeschooks"><span class="numberline">8.6.2</span>Post-Description Hooks</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:glosstylenumlist"><span class="numberline">8.6.3</span>Number (Location) List</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:glosgroups"><span class="numberline">8.6.4</span>Indexing Groups</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:stylemods"><span class="numberline">8.6.5</span><span class="styfmt">glossaries-extra-stylemods</span></a></li><!-- end of toc-subsection -->
+
+<ul>
+<li class="toc-subsubsection"><a href="#sec:stylemodsinline"><span class="numberline">8.6.5.1</span>Inline Style</a></li><!-- end of toc-subsubsection -->
+
+<li class="toc-subsubsection"><a href="#sec:stylemodstab"><span class="numberline">8.6.5.2</span>Tabular Styles</a></li><!-- end of toc-subsubsection -->
+
+<li class="toc-subsubsection"><a href="#sec:stylemodslist"><span class="numberline">8.6.5.3</span>List Styles</a></li><!-- end of toc-subsubsection -->
+
+<li class="toc-subsubsection"><a href="#sec:stylemodstree"><span class="numberline">8.6.5.4</span>Tree Styles</a></li><!-- end of toc-subsubsection -->
+</ul></ul>
+<li class="toc-section"><a href="#sec:newglossarystyles"><span class="numberline">8.7</span>New Glossary Styles</a></li><!-- end of toc-section -->
+
+<ul>
+<li class="toc-subsection"><a href="#sec:bookindex"><span class="numberline">8.7.1</span><span class="styfmt">glossary-bookindex</span> package</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:longextra"><span class="numberline">8.7.2</span><span class="styfmt">glossary-longextra</span> package</a></li><!-- end of toc-subsection -->
+
+<ul>
+<li class="toc-subsubsection"><a href="#sec:longextranamedesc"><span class="numberline">8.7.2.1</span>Name and Description Only</a></li><!-- end of toc-subsubsection -->
+
+<li class="toc-subsubsection"><a href="#sec:longextranamesymdesc"><span class="numberline">8.7.2.2</span>Name, Symbol and Description Only</a></li><!-- end of toc-subsubsection -->
+
+<li class="toc-subsubsection"><a href="#sec:longextranamedescloc"><span class="numberline">8.7.2.3</span>Name, Description and Location Only</a></li><!-- end of toc-subsubsection -->
+
+<li class="toc-subsubsection"><a href="#sec:longextranamedescsymloc"><span class="numberline">8.7.2.4</span>Name, Description, Symbol and Location</a></li><!-- end of toc-subsubsection -->
+
+<li class="toc-subsubsection"><a href="#sec:longextrasymdesc"><span class="numberline">8.7.2.5</span>Symbol and Description Only</a></li><!-- end of toc-subsubsection -->
+
+<li class="toc-subsubsection"><a href="#sec:longextraabbr"><span class="numberline">8.7.2.6</span>Abbreviations Only</a></li><!-- end of toc-subsubsection -->
+</ul>
+<li class="toc-subsection"><a href="#sec:topic"><span class="numberline">8.7.3</span><span class="styfmt">glossary-topic</span> package</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:table"><span class="numberline">8.7.4</span><span class="styfmt">glossary-table</span> package</a></li><!-- end of toc-subsection -->
+</ul></ul>
+<li class="toc-chapter"><a href="#sec:accsupp"><span class="numberline">9</span>Accessibility Support</a></li><!-- end of toc-chapter -->
+
+<ul>
+<li class="toc-section"><a href="#sec:accessabbr"><span class="numberline">9.1</span>Abbreviations</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:glsaccessfield"><span class="numberline">9.2</span>Accessibility Wrappers</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:glsaccessfmtfield"><span class="numberline">9.3</span>Inner Formatting Wrappers</a></li><!-- end of toc-section -->
+</ul>
+<li class="toc-chapter"><a href="#sec:categories"><span class="numberline">10</span>Categories</a></li><!-- end of toc-chapter -->
+
+<ul>
+<li class="toc-section"><a href="#sec:knowncategories"><span class="numberline">10.1</span>Known Categories</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:attributes"><span class="numberline">10.2</span>Attributes</a></li><!-- end of toc-section -->
+
+<ul>
+<li class="toc-subsection"><a href="#sec:knownattributes"><span class="numberline">10.2.1</span>Known Attributes</a></li><!-- end of toc-subsection -->
+
+<ul>
+<li class="toc-subsubsection"><a href="#sec:abbrattr"><span class="numberline">10.2.1.1</span>Abbreviation Attributes</a></li><!-- end of toc-subsubsection -->
+
+<li class="toc-subsubsection"><a href="#sec:glsoptsattr"><span class="numberline">10.2.1.2</span>Attributes that Alter <code class="csfmt">\glslink</code> Options</a></li><!-- end of toc-subsubsection -->
+
+<li class="toc-subsubsection"><a href="#sec:glossattr"><span class="numberline">10.2.1.3</span>Glossary Attributes</a></li><!-- end of toc-subsubsection -->
+
+<li class="toc-subsubsection"><a href="#sec:otherattr"><span class="numberline">10.2.1.4</span>Other Attributes</a></li><!-- end of toc-subsubsection -->
+</ul>
+<li class="toc-subsection"><a href="#sec:attributecmds"><span class="numberline">10.2.2</span>Accessing and Setting Attributes</a></li><!-- end of toc-subsection -->
+</ul></ul>
+<li class="toc-chapter"><a href="#sec:bib2gls"><span class="numberline">11</span><span class="appfmt">bib2gls</span>: Managing Reference Databases</a></li><!-- end of toc-chapter -->
+
+<ul>
+<li class="toc-section"><a href="#sec:bib2glsindexing"><span class="numberline">11.1</span>Indexing (Recording)</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:bib2glsselection"><span class="numberline">11.2</span>Selection</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:bib2glssortprint"><span class="numberline">11.3</span>Sorting and Displaying the Glossary</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:recordcount"><span class="numberline">11.4</span>Record Counting</a></li><!-- end of toc-section -->
+
+<ul>
+<li class="toc-subsection"><a href="#sec:unitrecordcount"><span class="numberline">11.4.1</span>Unit Record Counting</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:unitrecordcountminigloss"><span class="numberline">11.4.2</span>Mini-Glossaries</a></li><!-- end of toc-subsection -->
+</ul>
+<li class="toc-section"><a href="#sec:bib2glssty"><span class="numberline">11.5</span>The <span class="styfmt">glossaries-extra-bib2gls</span> package</a></li><!-- end of toc-section -->
+
+<ul>
+<li class="toc-subsection"><a href="#sec:printunsrtshortcuts"><span class="numberline">11.5.1</span>Displaying Glossaries</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:resourcecommands"><span class="numberline">11.5.2</span>Helper Commands for Resource Options</a></li><!-- end of toc-subsection -->
+
+<ul>
+<li class="toc-subsubsection"><a href="#sec:customsort"><span class="numberline">11.5.2.1</span>Custom Sort</a></li><!-- end of toc-subsubsection -->
+
+<ul>
+<li class="toc-paragraph"><a href="#sec:bib2glscustomsortnonletters"><span class="numberline">11.5.2.1.1</span>Non-Letters</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#sec:bib2glscustomsortlatin"><span class="numberline">11.5.2.1.2</span>Latin Letters</a></li><!-- end of toc-paragraph -->
+
+<li class="toc-paragraph"><a href="#sec:bib2glscustomsortmathgreek"><span class="numberline">11.5.2.1.3</span>Math Greek</a></li><!-- end of toc-paragraph -->
+</ul></ul>
+<li class="toc-subsection"><a href="#sec:glstexcmds"><span class="numberline">11.5.3</span>Commands Used Within Resource Files</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:bib2glshier"><span class="numberline">11.5.4</span>Hierarchy</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:supplocations"><span class="numberline">11.5.5</span>Supplemental Locations</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:recordnameref"><span class="numberline">11.5.6</span>Nameref Records</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:dgls"><span class="numberline">11.5.7</span>Dual Entry Commands</a></li><!-- end of toc-subsection -->
+
+<li class="toc-subsection"><a href="#sec:bib2glssupplementarycommands"><span class="numberline">11.5.8</span>Supplementary Commands</a></li><!-- end of toc-subsection -->
+</ul></ul>
+<li class="toc-chapter"><a href="#sec:autoindex"><span class="numberline">12</span>Auto-Indexing</a></li><!-- end of toc-chapter -->
+
+<li class="toc-chapter"><a href="#sec:onthefly"><span class="numberline">13</span>On-the-Fly Document Definitions</a></li><!-- end of toc-chapter -->
+
+<li class="toc-chapter"><a href="#sec:extrafiles"><span class="numberline">14</span>Supplementary Files</a></li><!-- end of toc-chapter -->
+
+<ul>
+<li class="toc-section"><a href="#sec:exampleglossariesfiles"><span class="numberline">14.1</span>Dummy Files for Testing</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:samples"><span class="numberline">14.2</span>Sample Files</a></li><!-- end of toc-section -->
+</ul>
+<li class="toc-chapter"><a href="#sec:lang"><span class="numberline">15</span>Multi-Lingual Support</a></li><!-- end of toc-chapter -->
+
+<li class="toc-part"><a href="#part.II"><span class="numberline">II</span>Summaries and Index</a></li><!-- end of toc-part -->
+
+<li class="toc-chapter"><a href="#symbols">Symbols</a></li><!-- end of toc-chapter -->
+
+<li class="toc-chapter"><a href="#glossary">Terms</a></li><!-- end of toc-chapter -->
+
+<li class="toc-chapter"><a href="#sec:gloskeys">Glossary Entry Keys Summary</a></li><!-- end of toc-chapter -->
+
+<li class="toc-chapter"><a href="#idx.glosfield-optionsummary">Glossary Entry Fields Summary</a></li><!-- end of toc-chapter -->
+
+<li class="toc-chapter"><a href="#idx.glsopt-optionsummary"><span style="font-family: monospace; ">\Gls</span>-Like and <span style="font-family: monospace; ">\Glstext</span>-Like Options Summary</a></li><!-- end of toc-chapter -->
+
+<li class="toc-chapter"><a href="#idx.mglsopt-optionsummary">Multi-Entry Set Options Summary</a></li><!-- end of toc-chapter -->
+
+<li class="toc-chapter"><a href="#idx.printglossopt-optionsummary">Print [Unsrt|noidx] Glossary Options Summary</a></li><!-- end of toc-chapter -->
+
+<li class="toc-chapter"><a href="#idx.abbrvstyle-optionsummary">Abbreviation Styles Summary</a></li><!-- end of toc-chapter -->
+
+<li class="toc-chapter"><a href="#idx.glossarystyle-optionsummary">Glossary Styles Summary</a></li><!-- end of toc-chapter -->
+
+<li class="toc-chapter"><a href="#cmdsummary">Command Summary</a></li><!-- end of toc-chapter -->
+
+<ul>
+<li class="toc-section"><a href="#summary.index@">Command Summary: @</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index6553600">Command Summary: A</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index6619136">Command Summary: B</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index6684672">Command Summary: C</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index6750208">Command Summary: D</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index6815744">Command Summary: E</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index6881280">Command Summary: F</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index6946816">Command Summary: G</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index7012352">Command Summary: Glo</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index7077888">Command Summary: Gls</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index7143424">Command Summary: Glsxtr</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index7208960">Command Summary: H</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index7274496">Command Summary: I</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index7405568">Command Summary: K</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index7471104">Command Summary: L</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index7536640">Command Summary: M</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index7602176">Command Summary: N</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index7667712">Command Summary: O</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index7733248">Command Summary: P</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index7864320">Command Summary: R</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index7929856">Command Summary: S</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index7995392">Command Summary: T</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index8060928">Command Summary: U</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index8192000">Command Summary: W</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index8257536">Command Summary: X</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#summary.index8388608">Command Summary: Z</a></li><!-- end of toc-section -->
+</ul>
+<li class="toc-chapter"><a href="#envsummary">Environment Summary</a></li><!-- end of toc-chapter -->
+
+<li class="toc-chapter"><a href="#styoptsummary">Package Option Summary</a></li><!-- end of toc-chapter -->
+
+<li class="toc-chapter"><a href="#index">Index</a></li><!-- end of toc-chapter -->
+ </ul></nav><!-- end of toc -->
+</section><!-- end of section toc -->
+
+<section id="sec:listofexamples"><!-- start of section sec:listofexamples --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->List of Examples<div class="labellink"><a href="#sec:listofexamples">[link]</a></div></h1><!-- end of chapter header -->
+<div class="loe">
+<div class="toc-example"><a href="#ex:multiabbrvstyles"><span class="numberline">1</span>Multiple abbreviation styles</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#example.2"><span class="numberline">2</span><code class="csfmt">\newabbreviation</code> vs <code class="csfmt">\newacronym</code> vs <code class="csfmt">\newglossaryentry</code></a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#example.3"><span class="numberline">3</span><code class="code">@abbreviation</code> vs <code class="code">@acronym</code> vs <code class="code">@entry</code></a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrhyper"><span class="numberline">4</span>Referencing an abbreviation (with <span class="styfmt">hyperref</span>)</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:glsVSfullVSfirst"><span class="numberline">5</span>First use of <code class="csfmt">\gls</code> vs <code class="csfmt">\glsxtrfull</code> vs <code class="csfmt">\glsfirst</code></a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:tagging"><span class="numberline">6</span>Tagging abbreviation initials</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:fallbackabbrstyle"><span class="numberline">7</span>Category without an associated abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-nolong"><span class="numberline">8</span>The <span class="optfmt">short-nolong</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-nolong-desc"><span class="numberline">9</span>The <span class="optfmt">short-nolong-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylenolong-short"><span class="numberline">10</span>The <span class="optfmt">nolong-short</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-sc-nolong"><span class="numberline">11</span>The <span class="optfmt">short-sc-nolong</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-sc-nolong-desc"><span class="numberline">12</span>The <span class="optfmt">short-sc-nolong-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylenolong-short-sc"><span class="numberline">13</span>The <span class="optfmt">nolong-short-sc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-sm-nolong"><span class="numberline">14</span>The <span class="optfmt">short-sm-nolong</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-sm-nolong-desc"><span class="numberline">15</span>The <span class="optfmt">short-sm-nolong-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylenolong-short-sm"><span class="numberline">16</span>The <span class="optfmt">nolong-short-sm</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-em-nolong"><span class="numberline">17</span>The <span class="optfmt">short-em-nolong</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-em-nolong-desc"><span class="numberline">18</span>The <span class="optfmt">short-em-nolong-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylenolong-short-em"><span class="numberline">19</span>The <span class="optfmt">nolong-short-em</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-noshort-desc"><span class="numberline">20</span>The <span class="optfmt">long-noshort-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-noshort"><span class="numberline">21</span>The <span class="optfmt">long-noshort</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-noshort-sc"><span class="numberline">22</span>The <span class="optfmt">long-noshort-sc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-noshort-sc-desc"><span class="numberline">23</span>The <span class="optfmt">long-noshort-sc-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-noshort-sm"><span class="numberline">24</span>The <span class="optfmt">long-noshort-sm</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-noshort-sm-desc"><span class="numberline">25</span>The <span class="optfmt">long-noshort-sm-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-noshort-em"><span class="numberline">26</span>The <span class="optfmt">long-noshort-em</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-noshort-em-desc"><span class="numberline">27</span>The <span class="optfmt">long-noshort-em-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-em-noshort-em"><span class="numberline">28</span>The <span class="optfmt">long-em-noshort-em</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-em-noshort-em-desc"><span class="numberline">29</span>The <span class="optfmt">long-em-noshort-em-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-short"><span class="numberline">30</span>The <span class="optfmt">long-short</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-short-desc"><span class="numberline">31</span>The <span class="optfmt">long-short-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-short-sc"><span class="numberline">32</span>The <span class="optfmt">long-short-sc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-short-sc-desc"><span class="numberline">33</span>The <span class="optfmt">long-short-sc-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-short-sm"><span class="numberline">34</span>The <span class="optfmt">long-short-sm</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-short-sm-desc"><span class="numberline">35</span>The <span class="optfmt">long-short-sm-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-short-em"><span class="numberline">36</span>The <span class="optfmt">long-short-em</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-short-em-desc"><span class="numberline">37</span>The <span class="optfmt">long-short-em-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-em-short-em"><span class="numberline">38</span>The <span class="optfmt">long-em-short-em</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-em-short-em-desc"><span class="numberline">39</span>The <span class="optfmt">long-em-short-em-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-short-user"><span class="numberline">40</span>The <span class="optfmt">long-short-user</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-short-user-desc"><span class="numberline">41</span>The <span class="optfmt">long-short-user-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-postshort-user"><span class="numberline">42</span>The <span class="optfmt">long-postshort-user</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-postshort-user-desc"><span class="numberline">43</span>The <span class="optfmt">long-postshort-user-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-postshort-sc-user"><span class="numberline">44</span>The <span class="optfmt">long-postshort-sc-user</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-postshort-sc-user-desc"><span class="numberline">45</span>The <span class="optfmt">long-postshort-sc-user-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-long"><span class="numberline">46</span>The <span class="optfmt">short-long</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-long-desc"><span class="numberline">47</span>The <span class="optfmt">short-long-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-sc-long"><span class="numberline">48</span>The <span class="optfmt">short-sc-long</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-sc-long-desc"><span class="numberline">49</span>The <span class="optfmt">short-sc-long-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-sm-long"><span class="numberline">50</span>The <span class="optfmt">short-sm-long</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-sm-long-desc"><span class="numberline">51</span>The <span class="optfmt">short-sm-long-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-em-long"><span class="numberline">52</span>The <span class="optfmt">short-em-long</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-em-long-desc"><span class="numberline">53</span>The <span class="optfmt">short-em-long-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-em-long-em"><span class="numberline">54</span>The <span class="optfmt">short-em-long-em</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-em-long-em-desc"><span class="numberline">55</span>The <span class="optfmt">short-em-long-em-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-long-user"><span class="numberline">56</span>The <span class="optfmt">short-long-user</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-long-user-desc"><span class="numberline">57</span>The <span class="optfmt">short-long-user-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-postlong-user"><span class="numberline">58</span>The <span class="optfmt">short-postlong-user</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-postlong-user-desc"><span class="numberline">59</span>The <span class="optfmt">short-postlong-user-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-hyphen-short-hyphen"><span class="numberline">60</span>The <span class="optfmt">long-hyphen-short-hyphen</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-hyphen-postshort-hyphen"><span class="numberline">61</span>The <span class="optfmt">long-hyphen-postshort-hyphen</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-hyphen-short-hyphen-desc"><span class="numberline">62</span>The <span class="optfmt">long-hyphen-short-hyphen-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-hyphen-postshort-hyphen-desc"><span class="numberline">63</span>The <span class="optfmt">long-hyphen-postshort-hyphen-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-hyphen-noshort-desc-noreg"><span class="numberline">64</span>The <span class="optfmt">long-hyphen-noshort-desc-noreg</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-hyphen-noshort-noreg"><span class="numberline">65</span>The <span class="optfmt">long-hyphen-noshort-noreg</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-hyphen-long-hyphen"><span class="numberline">66</span>The <span class="optfmt">short-hyphen-long-hyphen</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-hyphen-postlong-hyphen"><span class="numberline">67</span>The <span class="optfmt">short-hyphen-postlong-hyphen</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-hyphen-long-hyphen-desc"><span class="numberline">68</span>The <span class="optfmt">short-hyphen-long-hyphen-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-hyphen-postlong-hyphen-desc"><span class="numberline">69</span>The <span class="optfmt">short-hyphen-postlong-hyphen-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-only-short-only"><span class="numberline">70</span>The <span class="optfmt">long-only-short-only</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-only-short-only-desc"><span class="numberline">71</span>The <span class="optfmt">long-only-short-only-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-only-short-sc-only"><span class="numberline">72</span>The <span class="optfmt">long-only-short-sc-only</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstylelong-only-short-sc-only-desc"><span class="numberline">73</span>The <span class="optfmt">long-only-short-sc-only-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-footnote"><span class="numberline">74</span>The <span class="optfmt">short-footnote</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-footnote-desc"><span class="numberline">75</span>The <span class="optfmt">short-footnote-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-postfootnote"><span class="numberline">76</span>The <span class="optfmt">short-postfootnote</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-postfootnote-desc"><span class="numberline">77</span>The <span class="optfmt">short-postfootnote-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-sc-footnote"><span class="numberline">78</span>The <span class="optfmt">short-sc-footnote</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-sc-footnote-desc"><span class="numberline">79</span>The <span class="optfmt">short-sc-footnote-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-sc-postfootnote"><span class="numberline">80</span>The <span class="optfmt">short-sc-postfootnote</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-sc-postfootnote-desc"><span class="numberline">81</span>The <span class="optfmt">short-sc-postfootnote-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-sm-footnote"><span class="numberline">82</span>The <span class="optfmt">short-sm-footnote</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-sm-footnote-desc"><span class="numberline">83</span>The <span class="optfmt">short-sm-footnote-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-sm-postfootnote"><span class="numberline">84</span>The <span class="optfmt">short-sm-postfootnote</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-sm-postfootnote-desc"><span class="numberline">85</span>The <span class="optfmt">short-sm-postfootnote-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-em-footnote"><span class="numberline">86</span>The <span class="optfmt">short-em-footnote</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-em-footnote-desc"><span class="numberline">87</span>The <span class="optfmt">short-em-footnote-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-em-postfootnote"><span class="numberline">88</span>The <span class="optfmt">short-em-postfootnote</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:abbrvstyleshort-em-postfootnote-desc"><span class="numberline">89</span>The <span class="optfmt">short-em-postfootnote-desc</span> abbreviation style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:prereset"><span class="numberline">90</span>Illustrating the <span class="optfmt">prereset</span> option</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:preresetpreunset"><span class="numberline">91</span>Combining <span class="optfmt">prereset</span> and <span class="optfmt">preunset</span></a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:simpleseccmds"><span class="numberline">92</span>References in section headings (simplistic approach)</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:glsfmttext"><span class="numberline">93</span>References in section headings using <code class="csfmt">\glsfmttext</code></a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:glslinkinsechead"><span class="numberline">94</span>Reference with hyperlink in section headings</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:nestedlinkglspl"><span class="numberline">95</span>Nested link text with <code class="csfmt">\glspl</code></a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:linktextstyles"><span class="numberline">96</span>Link text styles: outer, middle, inner, hyperlinks and post-link hook</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:linktextstylescustom"><span class="numberline">97</span>Link text styles: outer, middle, inner, hyperlinks and post-link hooks (custom and abbreviation style)</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:textformat"><span class="numberline">98</span>Changing the outer text format</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:middleformat"><span class="numberline">99</span>Middle formatting</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:innerformat"><span class="numberline">100</span>Inner formatting</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:catpostlink"><span class="numberline">101</span>Category post-link hook</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:catpostlinkpunc"><span class="numberline">102</span>Category post-link hook with punctuation lookahead</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:catpostlinkfirstuse"><span class="numberline">103</span>Category post-link hooks</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:mkidxloclistorder"><span class="numberline">104</span>Location list ordering (<span class="appfmt">makeindex</span>)</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:b2gloclistorder"><span class="numberline">105</span>Location list ordering (<span class="appfmt">bib2gls</span>)</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:autoseeindextrue"><span class="numberline">106</span>Cross-references (<span class="optfmt">autoseeindex=true</span>)</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:autoseeindexfalse"><span class="numberline">107</span>Cross-references (<span class="optfmt">autoseeindex=false</span>)</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:autoseeindexfalsepostname"><span class="numberline">108</span>Cross-references (<span class="optfmt">autoseeindex=false</span> and post-name hook)</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:noxrfields"><span class="numberline">109</span>Cross-references (no <span class="optfmt">see</span>, <span class="optfmt">seealso</span> or <span class="optfmt">alias</span>)</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:recordedanddeps"><span class="numberline">110</span>Cross-references (<span class="appfmt">bib2gls</span>)</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:recordedanddepsandsee"><span class="numberline">111</span>Cross-references (<span class="appfmt">bib2gls</span> and <span class="optfmt">selection=recorded and deps and see</span>)</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:recordedanddepsandseeprune"><span class="numberline">112</span>Cross-references (<span class="appfmt">bib2gls</span> and <span class="optfmt">selection=recorded and deps and see</span>, <span class="optfmt">prune-xr</span>)</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:glsreset"><span class="numberline">113</span>Resetting the first use flag (<code class="csfmt">\glsreset</code>)</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:glslocalunset"><span class="numberline">114</span>Local unset</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:unsetbeamer"><span class="numberline">115</span>Abbreviations with <span class="clsfmt">beamer</span> (unset buffering)</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:bufferingmbox"><span class="numberline">116</span>Buffering first use unsets with <code class="csfmt">\mbox</code></a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:protectinnertextformat"><span class="numberline">117</span>Alternatives to buffering</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:foreignlangfmt"><span class="numberline">118</span>Foreign language field encapsulation</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:glsxtrfmt"><span class="numberline">119</span>Storing a formatting command in a field</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:fieldformatcsv"><span class="numberline">120</span>Formatting lists contained in field values</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:catentrycount"><span class="numberline">121</span>Entry counting according to category</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:catunitentrycount"><span class="numberline">122</span>Entry unit counting (per section) according to category</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:unitentrycounthyper"><span class="numberline">123</span>Enabling unit counting to hook into hyperlink setting</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:linkcount"><span class="numberline">124</span>Link counting used to selectively suppress hyperlinks</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:multientryhier"><span class="numberline">125</span>Multi-entries: hierarchical</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:multientryhierfirstusesuffix"><span class="numberline">126</span>Multi-entries: hierarchical with first-use suffix</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:multientryhiercatsuffix"><span class="numberline">127</span>Multi-entries: hierarchical with category suffix</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:multientrysep"><span class="numberline">128</span>Multi-entries: separators</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:multientryskip"><span class="numberline">129</span>Multi-entries: skipping elements</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:multientryskipunsetothers"><span class="numberline">130</span>Multi-entries: skipping elements (unsetting others)</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:multientryskipprefixpostlink"><span class="numberline">131</span>Multi-entries: skipping elements (prefix and post-link hooks)</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:targetprefixes"><span class="numberline">132</span>Changing the target prefix</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:targetprefixname"><span class="numberline">133</span>Prepending to the target prefix for just the entry item</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:printunsrt"><span class="numberline">134</span>Displaying unsorted glossaries</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:printunsrtstylemods"><span class="numberline">135</span>Displaying unsorted glossaries with <span class="optfmt">stylemods</span></a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:printunsrtgroup"><span class="numberline">136</span>Displaying unsorted glossaries with different group settings</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:unsrtcopygrp"><span class="numberline">137</span>Displaying unsorted glossaries with a copied list</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:unsrtcustomgrp"><span class="numberline">138</span>Displaying unsorted glossaries with custom groups</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:unsrtcustomsubgrp"><span class="numberline">139</span>Displaying unsorted glossaries with custom groups and sub-group headings</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:bib2glsgrp"><span class="numberline">140</span>Displaying sorted glossaries with groups using <span class="appfmt">bib2gls</span></a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:filterbycat"><span class="numberline">141</span>Filtering by category</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:unsrtwrap"><span class="numberline">142</span>Inner glossaries using <span class="envfmt">printunsrtglossarywrap</span></a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:nested"><span class="numberline">143</span>Nested glossaries</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:minigloss"><span class="numberline">144</span>Sub-glossary for a given counter value</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:minigloss2"><span class="numberline">145</span>Sub-glossary for a given counter value ordered by use in the section</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:bookindex"><span class="numberline">146</span>The <span class="optfmt">bookindex</span> style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:topicstyle"><span class="numberline">147</span>The <span class="optfmt">topic</span> style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:topicmcolsstyle"><span class="numberline">148</span>The <span class="optfmt">topicmcols</span> style</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:topicmcolsstylewidest"><span class="numberline">149</span>The <span class="optfmt">topicmcols</span> style with the widest name set</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:table"><span class="numberline">150</span>Two entries per row with <code class="csfmt">\printunsrttable</code></a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:bib2gls"><span class="numberline">151</span>Using <span class="appfmt">bib2gls</span>: one resource set</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:bib2glsmultiresources"><span class="numberline">152</span>Using <span class="appfmt">bib2gls</span>: multiple resource sets</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:bib2glssubblocks"><span class="numberline">153</span>Using <span class="appfmt">bib2gls</span>: sub-blocks</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:bib2glsrecordcounting"><span class="numberline">154</span>Using <span class="appfmt">bib2gls</span>: record counting</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:bib2glsunitrecordcounting"><span class="numberline">155</span>Using <span class="appfmt">bib2gls</span>: unit record counting</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:recordcountminigloss"><span class="numberline">156</span>Using <span class="appfmt">bib2gls</span>: unit record counting mini-glossary</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:bib2glscustomsort"><span class="numberline">157</span>Using <span class="appfmt">bib2gls</span>: simple custom sort rule</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:bib2glsdualbacklinks"><span class="numberline">158</span>Using <span class="appfmt">bib2gls</span>: dual backlinks</a></div><!-- end of toc-example -->
+
+<div class="toc-example"><a href="#ex:bib2glsduallabelprefixes"><span class="numberline">159</span>Using <span class="appfmt">bib2gls</span>: dual entry label prefixes</a></div><!-- end of toc-example -->
+</div><!-- end of loe --><p>
+
+</section><!-- end of section sec:listofexamples -->
+
+<section id="part.I"><!-- start of section part.I --><div class="tomain"><a href="#main">[top]</a></div>
+<div class="part"><!-- start of part header -->I. User Guide<div class="labellink"><a href="#part.I">[link]</a></div></div><!-- end of part header -->
+<p>
+
+</section><!-- end of section part.I -->
+
+<section id="sec:intro"><!-- start of section sec:intro --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->1. Introduction<div class="labellink"><a href="#sec:intro">[link]</a></div></h1><!-- end of chapter header -->
+<p>
+The <a id="wrglossary.10"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package is a flexible package, but it’s also a heavy-weight package that uses a lot of resources. As package developer, I’m caught between those users who complain about the drawbacks of a heavy-weight package with a large user manual and those users who want more features (which necessarily adds to the package weight and manual size).<p>
+The <a id="wrglossary.11"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package is an attempt to provide a compromise for this conflict. Version 4.22 of the <a id="wrglossary.12"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package is the last version to incorporate any major new features. Future versions of <a id="wrglossary.13"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> will mostly just be bug fixes. New features will instead be added to <span class="styfmt">glossaries-extra</span>. This means that the base <span class="styfmt">glossaries</span> package won’t increase in terms of package loading time and allocation of resources, but those users who do want extra features available will have more of a chance of getting their feature requests accepted.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Some of the commands provided by the base <a id="wrglossary.14"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package are incompatible with <a id="wrglossary.15"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. These are marked with <a id="wrglossary.16"></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a> in this document. </div><!-- end of important -->
+<p>
+The <a id="wrglossary.17"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package internally loads the <a id="wrglossary.18"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. As a general rule, it’s better to defer loading the base <a id="wrglossary.19"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package to <a id="wrglossary.20"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> rather than loading the two packages separately.<p>
+
+</section><!-- end of section sec:intro -->
+
+<section id="sec:defaults"><!-- start of section sec:defaults --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->1.1. Package Defaults<div class="labellink"><a href="#sec:defaults">[link]</a></div></h2><!-- end of section header -->
+<p>
+I’m not happy with some of the default settings assumed by the <a id="wrglossary.21"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, and, judging from code I’ve seen, other users also seem unhappy with them, as certain package options are often used in questions posted on various sites. I can’t change the default behaviour of <a id="wrglossary.22"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> as it would break backward compatibility, but since <a id="wrglossary.23"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> is a separate package, I have decided to implement some of these commonly-used options by default. You can switch them back if they’re not appropriate.<p>
+The new defaults are:
+<ul class="displaylist">
+ <li><span class="bulletitem">•</span><a id="wrglossary.24"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=true</span> (add the glossaries to the table of contents). Use <a id="wrglossary.25"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=false</span> to switch this back off.<p>
+<li><span class="bulletitem">•</span><a id="wrglossary.26"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=true</span> (suppress the terminating <a id="wrglossary.27"></a><a href="#glo:idx.fullstop">full stop</a> after the description in the <a id="wrglossary.28"></a><a href="#glo:dual.glossary">glossary</a>). Use <a id="wrglossary.29"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=false</span> or just <a id="wrglossary.30"></a><a href="#glo:opt.postdot"><span class="styoptfmt">postdot</span></a> to restore the terminating <a id="wrglossary.31"></a><a href="#glo:idx.fullstop">full stop</a>. Alternatively, if you are interested in switching to <a id="wrglossary.32"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, you can instruct <a id="wrglossary.33"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to insert it with the <a id="wrglossary.34"></a><a href="#glo:opt.resource.post-description-dot"><span class="csoptfmt">post-description-dot</span></a> option.<p>
+<li><span class="bulletitem">•</span><a id="wrglossary.35"></a><a href="#glo:opt.noredefwarn"><span class="styoptfmt">noredefwarn</span></a> (suppress the warnings that occur when the <a id="wrglossary.36"></a><a href="#glo:env.theglossary"><span class="envfmt">theglossary</span></a> environment and <a id="wrglossary.37"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> are redefined while <a id="wrglossary.38"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> is loading). Note that this won’t have any effect if the <a id="wrglossary.39"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package has already been loaded before you load the <a id="wrglossary.40"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package.<p>
+<li><span class="bulletitem">•</span>If <a id="wrglossary.41"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> has been loaded, the <a id="wrglossary.42"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span> option is switched on. To revert to using the <a id="wrglossary.43"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> interface, use <a id="wrglossary.44"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=true</span>. There is no change to the default if <a id="wrglossary.45"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> hasn’t been loaded.<p>
+<li><span class="bulletitem">•</span>The default style used by <a id="wrglossary.46"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> is <a id="wrglossary.47"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a>. (That is, the long form is not shown on <a id="wrglossary.48"></a><a href="#glo:dual.firstuse">first use</a>.) To revert back to <span class="qt">“<span class="meta">〈<em class="metainner">long</em>〉</span> (<span class="meta">〈<em class="metainner">short</em>〉</span>)”</span> on <a id="wrglossary.49"></a><a href="#glo:dual.firstuse">first use</a> do: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.50"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>[<a id="wrglossary.51"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a>]{<a id="wrglossary.52"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a>}
+</pre> In the above example, <a id="wrglossary.53"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> refers to the <a id="wrglossary.54"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> <a id="wrglossary.55"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> not the <a id="wrglossary.56"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> acronym style of the same name. See §<a href="#sec:abbreviations">4</a> for further details.<p>
+
+</ul>
+<p>
+
+</section><!-- end of section sec:defaults -->
+
+<section id="sec:examplediffs"><!-- start of section sec:examplediffs --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->1.2. Example Differences Between <span class="styfmt">glossaries</span> and <span class="styfmt">glossaries-extra</span><div class="labellink"><a href="#sec:examplediffs">[link]</a></div></h2><!-- end of section header -->
+<p>
+The examples below illustrate the difference in explicit package options between <a id="wrglossary.57"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> and <a id="wrglossary.58"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. There may be other differences resulting from modifications to commands provided by <a id="wrglossary.59"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>.<p>
+
+</section><!-- end of section sec:examplediffs -->
+
+<section id="sec:examplediffsbasic"><!-- start of section sec:examplediffsbasic --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->1.2.1. Basic defaults<div class="labellink"><a href="#sec:examplediffsbasic">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+</pre> This is like: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.60"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a>,<a id="wrglossary.61"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a>]{glossaries}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+</pre><p>
+
+</section><!-- end of section sec:examplediffsbasic -->
+
+<section id="sec:examplediffslang"><!-- start of section sec:examplediffslang --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->1.2.2. Language defaults<div class="labellink"><a href="#sec:examplediffslang">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>[british]{article}
+<code class="cmd">\usepackage</code>{<a id="wrglossary.62"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+</pre> This is like: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>[british]{article}
+<code class="cmd">\usepackage</code>{<a id="wrglossary.63"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.64"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a>,<a id="wrglossary.65"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a>,<a id="wrglossary.66"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span>]{glossaries}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+</pre><p>
+
+</section><!-- end of section sec:examplediffslang -->
+
+<section id="sec:examplediffsmemoir"><!-- start of section sec:examplediffsmemoir --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->1.2.3. Combined with <span class="clsfmt">memoir</span><div class="labellink"><a href="#sec:examplediffsmemoir">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{<a id="wrglossary.67"></a><a href="#glo:cls.memoir"><span class="clsfmt">memoir</span></a>}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+</pre> This is like: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{<a id="wrglossary.68"></a><a href="#glo:cls.memoir"><span class="clsfmt">memoir</span></a>}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.69"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a>,<a id="wrglossary.70"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a>,<a id="wrglossary.71"></a><a href="#glo:opt.noredefwarn"><span class="styoptfmt">noredefwarn</span></a>]{glossaries}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+</pre> <span style="font-style: italic; font-variant: normal; ">However</span> <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{<a id="wrglossary.72"></a><a href="#glo:cls.memoir"><span class="clsfmt">memoir</span></a>}
+<code class="cmd">\usepackage</code>{glossaries}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+</pre> This is like: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{<a id="wrglossary.73"></a><a href="#glo:cls.memoir"><span class="clsfmt">memoir</span></a>}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.74"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=false</span>,<a id="wrglossary.75"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=false</span>]{glossaries}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+</pre> Since by the time <a id="wrglossary.76"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> has been loaded, the base <a id="wrglossary.77"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package has already redefined <a id="wrglossary.78"></a><a href="#glo:cls.memoir"><span class="clsfmt">memoir</span>’s</a> <a id="wrglossary.79"></a><a href="#glo:dual.glossary">glossary</a>-related commands.<p>
+
+</section><!-- end of section sec:examplediffsmemoir -->
+
+<section id="sec:examplediffsabbrv"><!-- start of section sec:examplediffsabbrv --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->1.2.4. Abbreviations<div class="labellink"><a href="#sec:examplediffsabbrv">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+Abbreviations are defined with <a id="wrglossary.80"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>{glossaries-extra}
+<a id="wrglossary.81"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{svm}{SVM}{support vector machine}
+<code class="cbeg">\begin{document}</code>
+First use: <a id="wrglossary.82"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{svm}. Explicit full form: <a id="wrglossary.83"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{svm}.
+<code class="cend">\end{document}</code>
+</pre> This is the closest match to: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>{glossaries}
+<a id="wrglossary.84"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{svm}{SVM}{support vector machine}
+<code class="cbeg">\begin{document}</code>
+First use: <a id="wrglossary.85"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{svm}. Explicit full form: <a id="wrglossary.86"></a><a href="#glo:acrfull"><code class="csfmt">\acrfull</code></a>{svm}.
+<code class="cend">\end{document}</code>
+</pre> If you want to continue using <a id="wrglossary.87"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> then you will need to change the style for the <a id="wrglossary.88"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a> <a id="wrglossary.89"></a><a href="#glo:idx.category">category</a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>{glossaries-extra}
+<a id="wrglossary.90"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>[<a id="wrglossary.91"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a>]{<a id="wrglossary.92"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a>}
+<a id="wrglossary.93"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{svm}{SVM}{support vector machine}
+<code class="cbeg">\begin{document}</code>
+First use: <a id="wrglossary.94"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{svm}. Explicit full form: <a id="wrglossary.95"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{svm}.
+<code class="cend">\end{document}</code>
+</pre><p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Don’t use commands like <a id="wrglossary.96"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a> or <a id="wrglossary.97"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> with abbreviations. See §<a href="#sec:abbreviations">4</a> for further details. </div><!-- end of important -->
+<p>
+
+</section><!-- end of section sec:examplediffsabbrv -->
+
+<section id="sec:examplediffprintgloss"><!-- start of section sec:examplediffprintgloss --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->1.2.5. Glossary Mid-Build Placeholder (<code class="csfmt">\printglossary</code>)<div class="labellink"><a href="#sec:examplediffprintgloss">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+Another noticeable change with <a id="wrglossary.98"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> is that by default <a id="wrglossary.99"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> will now display information text in the document if the external <a id="wrglossary.100"></a><a href="#glo:dual.glossary">glossary</a> file doesn’t exist. This is explanatory text to help new users who can’t work out what to do next to complete the document build. Once the document is set up correctly and the external files have been generated, this text will disappear.<p>
+This change is mostly likely to be noticed by users with one or more redundant empty glossaries who ignore transcript messages, explicitly use <a id="wrglossary.101"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.102"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> on just the non-empty <a id="wrglossary.103"></a><a href="#glo:dual.glossary">glossary</a> (or <a id="wrglossary.104"></a><a href="#glo:dual.glossary">glossaries</a>) and use the iterative <a id="wrglossary.105"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a> command instead of <a id="wrglossary.106"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>. For example, consider the following: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.107"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>]{glossaries}
+<a id="wrglossary.108"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.109"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{laser}{laser}{light amplification by stimulated
+emission of radiation}
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.110"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{laser}
+<a id="wrglossary.111"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> The above document will only display the list of acronyms at the place where <a id="wrglossary.112"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a> occurs. However it will also attempt to input the <a id="wrglossary.113"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a> file associated with the <code class="code">main</code> <a id="wrglossary.114"></a><a href="#glo:dual.glossary">glossary</a>.<p>
+If you use <a id="wrglossary.115"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, you’ll get the warning message: <pre class="transcript"><div class="transcripttitle"><a href="#glo:sym.transcript"><span title="Transcript" class="icon">🔎</span></a></div>Warning: File 'test.glo' is empty.
+Have you used any entries defined in glossary 'main'?
+Remember to use package option 'nomain' if you
+don't want to use the main glossary.
+</pre> (where the original file is called <span class="filefmt">test.tex</span>) but if you simply call <a id="wrglossary.116"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> directly to generate the <a id="wrglossary.117"></a><a href="#glo:ext.acr"><span class="extfmt">acr</span></a> file (without attempting to create the <a id="wrglossary.118"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a> file) then the transcript file will always contain the message: <pre class="transcript"><div class="transcripttitle"><a href="#glo:sym.transcript"><span title="Transcript" class="icon">🔎</span></a></div>No file test.gls.
+</pre> This doesn’t occur with <a id="wrglossary.119"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> as it will create the <a id="wrglossary.120"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a> file containing the single command <a id="wrglossary.121"></a><a href="#glo:null"><code class="csfmt">\null</code></a>.<p>
+If you simply change from <a id="wrglossary.122"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> to <a id="wrglossary.123"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> in this document, you’ll find a change in the resulting PDF if you don’t use <a id="wrglossary.124"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> and you only generate the <a id="wrglossary.125"></a><a href="#glo:ext.acr"><span class="extfmt">acr</span></a> file with <a id="wrglossary.126"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>.<p>
+The transcript file will still contain the message about the missing <a id="wrglossary.127"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a>, but now you’ll also see information in the actual PDF document. The simplest remedy is to follow the advice inserted into the document at that point, which is to add the <a id="wrglossary.128"></a><a href="#glo:opt.nomain"><span class="styoptfmt">nomain</span></a> package option: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.129"></a><a href="#glo:opt.nomain"><span class="styoptfmt">nomain</span></a>,<a id="wrglossary.130"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>,<a id="wrglossary.131"></a><a href="#glo:opt.postdot"><span class="styoptfmt">postdot</span></a>]{glossaries-extra}
+<a id="wrglossary.132"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.133"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>[<a id="wrglossary.134"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a>]{<a id="wrglossary.135"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a>}
+<a id="wrglossary.136"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{laser}{laser}{light amplification by stimulated
+emission of radiation}
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.137"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{laser}
+<a id="wrglossary.138"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> <div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+Note the need to set the acronym style using <a id="wrglossary.139"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a> before <a id="wrglossary.140"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>. See §<a href="#sec:abbreviations">4</a> for further details. </div><!-- end of information -->
+<p>
+
+</section><!-- end of section sec:examplediffprintgloss -->
+
+<section id="sec:reading"><!-- start of section sec:reading --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->1.3. Further Reading<div class="labellink"><a href="#sec:reading">[link]</a></div></h2><!-- end of section header -->
+<p>
+The following documents and web pages are also available:
+<ul class="displaylist">
+ <li><span class="bulletitem">•</span><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries-extra/glossaries-extra-code.pdf">The <span class="styfmt">glossaries-extra</span> documented code</a> <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div><a href="https://www.tug.org/texdoc/">texdoc</a> glossaries-extra-code</pre><p>
+<li><span class="bulletitem">•</span><a href="https://www.dickimaw-books.com/gallery">Gallery: <span class="styfmt">glossaries</span>, <span class="styfmt">glossaries-extra</span> and <span class="appfmt">bib2gls</span></a>.<p>
+<li><span class="bulletitem">•</span><a href="https://www.dickimaw-books.com/faq.php">FAQs: <span class="styfmt">glossaries</span>, <span class="styfmt">glossaries-extra</span> and <span class="appfmt">bib2gls</span></a>.<p>
+<li><span class="bulletitem">•</span><a href="https://www.dickimaw-books.com/latex/buildglossaries/">Incorporating <span class="appfmt">makeglossaries</span> or <span class="appfmt">makeglossaries-lite</span> or <span class="appfmt">bib2gls</span> into the document build</a>.<p>
+<li><span class="bulletitem">•</span><a href="https://ctan.org/pkg/bib2gls">The <span class="appfmt">bib2gls</span> application</a>.<p>
+<li><span class="bulletitem">•</span><a href="https://ctan.org/pkg/glossaries">The <span class="styfmt">glossaries</span> package</a>.<p>
+
+</ul>
+<p>
+
+</section><!-- end of section sec:reading -->
+
+<section id="sec:pkgopts"><!-- start of section sec:pkgopts --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->2. Package Options<div class="labellink"><a href="#sec:pkgopts">[link]</a></div></h1><!-- end of chapter header -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.141"></a><code class="code"><code class="cmd">\usepackage</code>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<dfn id="glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></dfn>}</code></div><!-- end of pinnedbox -->
+ This chapter describes the package options provided by <a id="wrglossary.142"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> that are either not defined by the base <a id="wrglossary.143"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package or are modified by <a id="wrglossary.144"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. You can additionally pass the base package options to <a id="wrglossary.145"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. For example, instead of: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.146"></a><a href="#glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></a>]{glossaries}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.147"></a><a href="#glo:opt.abbreviations"><span class="styoptfmt">abbreviations</span></a>]{glossaries-extra}
+</pre> you can simply do: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.148"></a><a href="#glo:opt.abbreviations"><span class="styoptfmt">abbreviations</span></a>,<a id="wrglossary.149"></a><a href="#glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></a>]{glossaries-extra}
+</pre><p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+It’s better not to load the <a id="wrglossary.150"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package first. Leave <a id="wrglossary.151"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> to load it, where possible, to allow for a smoother integration between the two packages. </div><!-- end of information -->
+<p>
+After <a id="wrglossary.152"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> has been loaded, some of the <a id="wrglossary.153"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package options may be changed with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.154"></a><code class="code"><dfn id="glo:glossariesextrasetup"><code class="csfmt">\glossariesextrasetup</code></dfn>{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">options</em>〉</span> are the same as the relevant package option.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Certain options can only be supplied as package options since the settings need to be known while <a id="wrglossary.155"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> is loading. </div><!-- end of important -->
+<p>
+To change the base <a id="wrglossary.156"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s options (that may be changed after the package has loaded), continue to use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.157"></a><code class="code"><dfn id="glo:setupglossaries"><code class="csfmt">\setupglossaries</code></dfn>{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ but don’t use any of the options listed here in that command.<p>
+
+</section><!-- end of section sec:pkgopts -->
+
+<section id="sec:gloslistopts"><!-- start of section sec:gloslistopts --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->2.1. Glossary Lists<div class="labellink"><a href="#sec:gloslistopts">[link]</a></div></h2><!-- end of section header -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.158"></a><code class="code"><dfn id="glo:opt.nomissingglstext"><span class="styoptfmt">nomissingglstext</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ If true, this will suppress the warning written to the transcript and the warning text that will appear in the document if the external glossary files haven’t been generated due to an incomplete document build. However, it’s probably simpler just to fix whatever has caused the failure to build the external file or files.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.159"></a><code class="code"><dfn id="glo:opt.abbreviations"><span class="styoptfmt">abbreviations</span></dfn></code></div><!-- end of settingsbox -->
+ This option has no value and can’t be cancelled. If used, it will automatically create a new glossary with the label <code class="code">abbreviations</code> and redefines <a id="wrglossary.160"></a><a href="#glo:glsxtrabbrvtype"><code class="csfmt">\glsxtrabbrvtype</code></a> to this label. (The file extensions are <a id="wrglossary.161"></a><a href="#glo:ext.glg-abr"><span class="extfmt">glg-abr</span></a>, <a id="wrglossary.162"></a><a href="#glo:ext.gls-abr"><span class="extfmt">gls-abr</span></a> and <a id="wrglossary.163"></a><a href="#glo:ext.glo-abr"><span class="extfmt">glo-abr</span></a>.) In addition, this option defines a shortcut command: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.164"></a><code class="code"><dfn id="glo:printabbreviations"><code class="csfmt">\printabbreviations</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ which is equivalent to: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.165"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>[<a id="wrglossary.166"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.167"></a><a href="#glo:glsxtrabbrvtype"><code class="csfmt">\glsxtrabbrvtype</code></a></span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]
+</pre> If <a id="wrglossary.168"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> is also loaded then this option will additionally provide <a id="wrglossary.169"></a><a href="#glo:printunsrtabbreviations"><code class="csfmt">\printunsrtabbreviations</code></a> which uses <a id="wrglossary.170"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> instead.<p>
+The title of the new glossary is given by <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.171"></a><code class="code"><dfn id="glo:abbreviationsname"><code class="csfmt">\abbreviationsname</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>Abbreviations</span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ If this command is already defined, it’s left unchanged. Otherwise it’s defined to <span class="qt">“Abbreviations”</span> if <a id="wrglossary.172"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> hasn’t been loaded or <a id="wrglossary.173"></a><a href="#glo:acronymname"><code class="csfmt">\acronymname</code></a> if <a id="wrglossary.174"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> has been loaded. However, if you’re using <a id="wrglossary.175"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> it’s likely you will need to change this. (See §<a href="#sec:lang">15</a> for further details.)<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+If you don’t use the <a id="wrglossary.176"></a><a href="#glo:opt.abbreviations"><span class="styoptfmt">abbreviations</span></a> package option, the <a id="wrglossary.177"></a><a href="#glo:abbreviationsname"><code class="csfmt">\abbreviationsname</code></a> command won’t be defined (unless it’s defined by an included language file). </div><!-- end of information -->
+<p>
+If the <a id="wrglossary.178"></a><a href="#glo:opt.abbreviations"><span class="styoptfmt">abbreviations</span></a> option is used and the <a id="wrglossary.179"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> option provided by the <a id="wrglossary.180"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package hasn’t been used, then <a id="wrglossary.181"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> will be set to <a id="wrglossary.182"></a><a href="#glo:glsxtrabbrvtype"><code class="csfmt">\glsxtrabbrvtype</code></a> so that acronyms defined with <a id="wrglossary.183"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> can be added to the list of abbreviations. If you want acronyms in the <code class="code">main</code> glossary and other abbreviations in the <code class="code">abbreviations</code> glossary then you will need to redefine <a id="wrglossary.184"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> to <code class="code">main</code>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.185"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>}{main}
+</pre><p>
+Note that there are no analogous options to the <a id="wrglossary.186"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s <a id="wrglossary.187"></a><a href="#glo:opt.acronymlists"><span class="styoptfmt">acronymlists</span></a> option (or associated commands) as the abbreviation mechanism is handled differently with <a id="wrglossary.188"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.189"></a><code class="code"><dfn id="glo:opt.symbols"><span class="styoptfmt">symbols</span></dfn></code></div><!-- end of settingsbox -->
+ This is passed to the base <a id="wrglossary.190"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, but <a id="wrglossary.191"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> will additionally define: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.192"></a><code class="code"><dfn id="glo:glsxtrnewsymbol"><code class="csfmt">\glsxtrnewsymbol</code></dfn>[<span class="meta">〈<em class="metainner">key=value list</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">sym</em>〉</span>}</code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ which is equivalent to: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.193"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<a id="wrglossary.194"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<span class="meta">〈<em class="metainner">symbol</em>〉</span>}</span>,
+ <a id="wrglossary.195"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</span>,<a id="wrglossary.196"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={symbols}</span>,<a id="wrglossary.197"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={symbol}</span>,
+<span class="meta">〈<em class="metainner">options</em>〉</span>}
+</pre> Note that the <a id="wrglossary.198"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key is set to the <span class="meta">〈<em class="metainner">entry-label</em>〉</span> not the <span class="meta">〈<em class="metainner">symbol</em>〉</span> as the symbol will likely contain commands. If this isn’t appropriate, you can override it by using the <a id="wrglossary.199"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key in the optional argument.<p>
+This option also sets the <a id="wrglossary.200"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">true</code> for the <a id="wrglossary.201"></a><a href="#glo:opt.cat.symbol"><span class="csoptfmt">symbol</span></a> category and provides the <a id="wrglossary.202"></a><a href="#glo:dual.catpostdeschook">category post-description hook</a>: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.203"></a><code class="code"><dfn id="glo:glsxtrpostdescsymbol"><code class="csfmt">\glsxtrpostdescsymbol</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">empty</em></span></span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+<p>
+If <a id="wrglossary.204"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> is also loaded then this option will additionally provide <a id="wrglossary.205"></a><a href="#glo:printunsrtsymbols"><code class="csfmt">\printunsrtsymbols</code></a> which uses <a id="wrglossary.206"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.207"></a><code class="code"><dfn id="glo:opt.numbers"><span class="styoptfmt">numbers</span></dfn></code></div><!-- end of settingsbox -->
+ This is passed to the base <a id="wrglossary.208"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package but <a id="wrglossary.209"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> will additionally define: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.210"></a><code class="code"><dfn id="glo:glsxtrnewnumber"><code class="csfmt">\glsxtrnewnumber</code></dfn>[<span class="meta">〈<em class="metainner">key=value list</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">num</em>〉</span>}</code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ which is equivalent to: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.211"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<a id="wrglossary.212"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<span class="meta">〈<em class="metainner">number</em>〉</span>}</span>,
+ <a id="wrglossary.213"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</span>,<a id="wrglossary.214"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={numbers}</span>,<a id="wrglossary.215"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={number}</span>,
+<span class="meta">〈<em class="metainner">options</em>〉</span>}
+</pre> Note that the <a id="wrglossary.216"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key is set to the <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. If this isn’t appropriate, you can override it by using the <a id="wrglossary.217"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key in the optional argument.<p>
+This option also sets the <a id="wrglossary.218"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">true</code> for the <a id="wrglossary.219"></a><a href="#glo:opt.cat.number"><span class="csoptfmt">number</span></a> category and provides the <a id="wrglossary.220"></a><a href="#glo:dual.catpostdeschook">category post-description hook</a>: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.221"></a><code class="code"><dfn id="glo:glsxtrpostdescnumber"><code class="csfmt">\glsxtrpostdescnumber</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">empty</em></span></span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+<p>
+If <a id="wrglossary.222"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> is also loaded then this option will additionally provide <a id="wrglossary.223"></a><a href="#glo:printunsrtnumbers"><code class="csfmt">\printunsrtnumbers</code></a> which uses <a id="wrglossary.224"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.225"></a><code class="code"><dfn id="glo:opt.acronyms"><span class="styoptfmt">acronyms</span></dfn></code></div><!-- end of settingsbox -->
+ This is passed to the base <a id="wrglossary.226"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package (which defines <a id="wrglossary.227"></a><a href="#glo:printacronyms"><code class="csfmt">\printacronyms</code></a> and creates a new glossary with the label <code class="code">acronym</code>) but if <a id="wrglossary.228"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> is loaded then this option will additionally provide <a id="wrglossary.229"></a><a href="#glo:printunsrtacronyms"><code class="csfmt">\printunsrtacronyms</code></a> which uses <a id="wrglossary.230"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>.<p>
+As with the base <a id="wrglossary.231"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, this option redefines <a id="wrglossary.232"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> to <code class="code">acronym</code>. Note that this option doesn’t change <a id="wrglossary.233"></a><a href="#glo:glsxtrabbrvtype"><code class="csfmt">\glsxtrabbrvtype</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.234"></a><code class="code"><dfn id="glo:opt.acronym"><span class="styoptfmt">acronym</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ If <a id="wrglossary.235"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a><span class="optfmt">=true</span>, this behaves like <a id="wrglossary.236"></a><a href="#glo:opt.acronyms"><span class="styoptfmt">acronyms</span></a>. Note that <a id="wrglossary.237"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a><span class="optfmt">=false</span> won’t work if the base <a id="wrglossary.238"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package was loaded before <a id="wrglossary.239"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.240"></a><code class="code"><dfn id="glo:opt.index"><span class="styoptfmt">index</span></dfn></code></div><!-- end of settingsbox -->
+ This is passed to the base <a id="wrglossary.241"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package but if <a id="wrglossary.242"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> is loaded then this option will additionally provide <a id="wrglossary.243"></a><a href="#glo:printunsrtindex"><code class="csfmt">\printunsrtindex</code></a> which uses <a id="wrglossary.244"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>.<p>
+The base package <a id="wrglossary.245"></a><a href="#glo:opt.index"><span class="styoptfmt">index</span></a> option also defines: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.246"></a><code class="code"><dfn id="glo:newterm"><code class="csfmt">\newterm</code></dfn>[<span class="meta">〈<em class="metainner">key=value list</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ This definition is modified by <a id="wrglossary.247"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> to additionally set the <a id="wrglossary.248"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> to <a id="wrglossary.249"></a><a href="#glo:opt.cat.index"><span class="csoptfmt">index</span></a> and sets the <a id="wrglossary.250"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> to discard the <a id="wrglossary.251"></a><a href="#glo:dual.postdeschook">post-description hook</a> (<a id="wrglossary.252"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>) but retain <a id="wrglossary.253"></a><a href="#glo:glsxtrpostdescription"><code class="csfmt">\glsxtrpostdescription</code></a> so that the <a id="wrglossary.254"></a><a href="#glo:dual.catpostdeschook">category post-description hook</a> can still be applied.<p>
+This option also sets the <a id="wrglossary.255"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">true</code> for the <a id="wrglossary.256"></a><a href="#glo:opt.cat.index"><span class="csoptfmt">index</span></a> category and defines an associated <a id="wrglossary.257"></a><a href="#glo:dual.catpostdeschook">category post-description hook</a>: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.258"></a><code class="code"><dfn id="glo:glsxtrpostdescindex"><code class="csfmt">\glsxtrpostdescindex</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">empty</em></span></span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+<p>
+
+</section><!-- end of section sec:gloslistopts -->
+
+<section id="sec:glosstyleopts"><!-- start of section sec:glosstyleopts --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->2.2. Glossary Style Options<div class="labellink"><a href="#sec:glosstyleopts">[link]</a></div></h2><!-- end of section header -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.259"></a><code class="code"><dfn id="glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This option is provided by <a id="wrglossary.260"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> where it simply alters a corresponding conditional that’s used inside <a id="wrglossary.261"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a> to determine whether or not to insert a <a id="wrglossary.262"></a><a href="#glo:idx.fullstop">full stop</a>.<p>
+The <a id="wrglossary.263"></a><a href="#glo:opt.postpunc"><span class="styoptfmt">postpunc</span></a> option (see below) redefines <a id="wrglossary.264"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a>, so the <a id="wrglossary.265"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a> option is modified by <a id="wrglossary.266"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> to reset the hook back to its original definition to counteract any use of the <a id="wrglossary.267"></a><a href="#glo:opt.postpunc"><span class="styoptfmt">postpunc</span></a> option.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+This option will have no effect if the <a id="wrglossary.268"></a><a href="#glo:idx.glossarystyle">glossary style</a> doesn’t include <a id="wrglossary.269"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a>. (Use <a id="wrglossary.270"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a> to ensure that all the predefined styles that show the description have this hook added.) </div><!-- end of important -->
+<p>
+If you are using <a id="wrglossary.271"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, you may prefer to use the <a id="wrglossary.272"></a><a href="#glo:opt.resource.post-description-dot"><span class="csoptfmt">post-description-dot</span></a> resource option.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.273"></a><code class="code"><dfn id="glo:opt.postdot"><span class="styoptfmt">postdot</span></dfn></code></div><!-- end of settingsbox -->
+ This is a shortcut for <a id="wrglossary.274"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=false</span>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.275"></a><code class="code"><dfn id="glo:opt.postpunc"><span class="styoptfmt">postpunc</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code></div><!-- end of settingsbox -->
+ This option redefines <a id="wrglossary.276"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a> to display the required punctuation. Note that this means the hook will no longer check for the <a id="wrglossary.277"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a> conditional.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+This option will have no effect if the <a id="wrglossary.278"></a><a href="#glo:idx.glossarystyle">glossary style</a> doesn’t include <a id="wrglossary.279"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a>. (Use <a id="wrglossary.280"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a> to ensure that all the predefined styles that show the description have this hook added.) </div><!-- end of important -->
+<p>
+The <a id="wrglossary.281"></a><a href="#glo:opt.postpunc"><span class="styoptfmt">postpunc</span></a> value may either be the required punctuation or one of the following keywords:<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.282"></a><a id="wrglossary.283"></a><a href="#glo:opt.postpunc"><span class="styoptfmt">postpunc</span></a>=<code class="code"><dfn id="glo:optval.postpunc.dot"><span class="optfmt">dot</span></dfn></code></div><!-- end of optionvaluebox -->
+ This redefines <a id="wrglossary.284"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a> to use a <a id="wrglossary.285"></a><a href="#glo:idx.fullstop">full stop</a> but also adjusts the space factor. This isn’t exactly the same as <a id="wrglossary.286"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=false</span> since it removes the conditional from <a id="wrglossary.287"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a>. If you are using <a id="wrglossary.288"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, you may prefer to use the <a id="wrglossary.289"></a><a href="#glo:opt.resource.post-description-dot"><span class="csoptfmt">post-description-dot</span></a> resource option.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.290"></a><a id="wrglossary.291"></a><a href="#glo:opt.postpunc"><span class="styoptfmt">postpunc</span></a>=<code class="code"><dfn id="glo:optval.postpunc.comma"><span class="optfmt">comma</span></dfn></code></div><!-- end of optionvaluebox -->
+ This redefines <a id="wrglossary.292"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a> to a comma.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.293"></a><a id="wrglossary.294"></a><a href="#glo:opt.postpunc"><span class="styoptfmt">postpunc</span></a>=<code class="code"><dfn id="glo:optval.postpunc.none"><span class="optfmt">none</span></dfn></code></div><!-- end of optionvaluebox -->
+ This redefines <a id="wrglossary.295"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a> to do nothing. This isn’t exactly the same as <a id="wrglossary.296"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=true</span> since it removes the conditional from <a id="wrglossary.297"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.298"></a><code class="code"><dfn id="glo:opt.stylemods"><span class="styoptfmt">stylemods</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>default</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ Loads the <a id="wrglossary.299"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> package (see §<a href="#sec:stylemods">8.6.5</a>), which patches the styles provided with the base <a id="wrglossary.300"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package so that they all use <a id="wrglossary.301"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a>. Extra hooks are also provided to make them easier to customize. The value may be one of the following:<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.302"></a><a id="wrglossary.303"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a>=<code class="code"><dfn id="glo:optval.stylemods.all"><span class="optfmt">all</span></dfn></code></div><!-- end of optionvaluebox -->
+ Loads all styles that are provided by both <a id="wrglossary.304"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> and <a id="wrglossary.305"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.306"></a><a id="wrglossary.307"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a>=<code class="code"><dfn id="glo:optval.stylemods.default"><span class="optfmt">default</span></dfn></code></div><!-- end of optionvaluebox -->
+ Patches all the predefined styles that have been loaded, without loading any extra styles. This will typically be all the styles that are usually loaded by <a id="wrglossary.308"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> (for example, <a id="wrglossary.309"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> and <a id="wrglossary.310"></a><a href="#glo:opt.glostyle.long"><span class="glostylefmt">long</span></a>). Package options such as <a id="wrglossary.311"></a><a href="#glo:opt.nolist"><span class="styoptfmt">nolist</span></a> will alter which styles are loaded. In the case of <a id="wrglossary.312"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>, no styles will be loaded, so none of them will be patched.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+It’s pointless using both <a id="wrglossary.313"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a><span class="optfmt">=</span><a id="wrglossary.314"></a><a href="#glo:optval.stylemods.default"><span class="optfmt">default</span></a> and <a id="wrglossary.315"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>. Any <a id="wrglossary.316"></a><a href="#glo:idx.glossarystyle">glossary style</a> packages that are subsequently loaded won’t be patched. </div><!-- end of information -->
+<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.317"></a><a id="wrglossary.318"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a>=<code class="code"><dfn id="glo:optval.stylemods.list"><span class="meta">〈<em class="metainner">list</em>〉</span></dfn></code></div><!-- end of optionvaluebox -->
+ For each element <span class="meta">〈<em class="metainner">tag</em>〉</span> in <span class="meta">〈<em class="metainner">list</em>〉</span>, the corresponding package <span class="styfmt">glossary-<span class="meta">〈<em class="metainner">tag</em>〉</span></span> will be loaded. You can use this in combination with <a id="wrglossary.319"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a> to only load the particular style package or packages that you require (without loading the full set of defaults). For example, <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.320"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>,<a id="wrglossary.321"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a><span class="optfmt">={bookindex,longextra}</span>,
+ <a id="wrglossary.322"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=bookindex</span>]{<a id="wrglossary.323"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>}
+</pre> This prevents the base <a id="wrglossary.324"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package from loading the default set of styles, but loads <a id="wrglossary.325"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a>, <a id="wrglossary.326"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> and <a id="wrglossary.327"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a>, and then sets the default style to <a id="wrglossary.328"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a>.<p>
+
+</section><!-- end of section sec:glosstyleopts -->
+
+<section id="sec:otherpkgopts"><!-- start of section sec:otherpkgopts --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->2.3. Loading Other Packages<div class="labellink"><a href="#sec:otherpkgopts">[link]</a></div></h2><!-- end of section header -->
+<p>
+Some options listed in other sections, such as the <a id="wrglossary.329"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a> and <a id="wrglossary.330"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a> options, also load supplementary packages.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.331"></a><code class="code"><dfn id="glo:opt.prefix"><span class="styoptfmt">prefix</span></dfn></code></div><!-- end of settingsbox -->
+ Loads the <a id="wrglossary.332"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a> package (if not already loaded).<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.333"></a><code class="code"><dfn id="glo:opt.accsupp"><span class="styoptfmt">accsupp</span></dfn></code></div><!-- end of settingsbox -->
+ Loads the <a id="wrglossary.334"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> package (if not already loaded). This option can only be used as a package option (not in <a id="wrglossary.335"></a><a href="#glo:glossariesextrasetup"><code class="csfmt">\glossariesextrasetup</code></a>) as <a id="wrglossary.336"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> needs to know whether or not to provide accessibility support while it’s loading.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The <a id="wrglossary.337"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> package is still experimental and so accessibility features are liable to change. </div><!-- end of important -->
+<p>
+If you want to define styles that can interface with the accessibility support provided by <a id="wrglossary.338"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> use the <code class="csfmt">\glsaccess<span class="meta">〈<em class="metainner">xxx</em>〉</span></code> type of commands instead of <code class="csfmt">\glsentry<span class="meta">〈<em class="metainner">xxx</em>〉</span></code> (for example, <a id="wrglossary.339"></a><a href="#glo:glsaccesstext"><code class="csfmt">\glsaccesstext</code></a> instead of <a id="wrglossary.340"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a>). If <a id="wrglossary.341"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> hasn’t been loaded those commands are equivalent (for example, <a id="wrglossary.342"></a><a href="#glo:glsaccesstext"><code class="csfmt">\glsaccesstext</code></a> just does <a id="wrglossary.343"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a>) but if it has been loaded, then the <code class="csfmt">\glsaccess<span class="meta">〈<em class="metainner">xxx</em>〉</span></code> commands will add the accessibility information. See §<a href="#sec:accsupp">9</a> for further details.<p>
+
+</section><!-- end of section sec:otherpkgopts -->
+
+<section id="sec:refindexopts"><!-- start of section sec:refindexopts --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->2.4. Entry Definitions, References and Indexing<div class="labellink"><a href="#sec:refindexopts">[link]</a></div></h2><!-- end of section header -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.344"></a><code class="code"><dfn id="glo:opt.undefaction"><span class="styoptfmt">undefaction</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>error</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This indicates what to do if an undefined <a id="wrglossary.345"></a><a href="#glo:dual.glossary">glossary</a> entry is referenced.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Undefined entries can’t be picked up by any commands that iterate over a <a id="wrglossary.346"></a><a href="#glo:dual.glossary">glossary</a> list. This includes <a id="wrglossary.347"></a><a href="#glo:forglsentries"><code class="csfmt">\forglsentries</code></a> and <a id="wrglossary.348"></a><a href="#glo:glsaddall"><code class="csfmt">\glsaddall</code></a>. </div><!-- end of important -->
+<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.349"></a><a id="wrglossary.350"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a>=<code class="code"><dfn id="glo:optval.undefaction.error"><span class="optfmt">error</span></dfn></code></div><!-- end of optionvaluebox -->
+ Produces an error message for undefined <a id="wrglossary.351"></a><a href="#glo:dual.glossary">glossary</a> entries.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.352"></a><a id="wrglossary.353"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a>=<code class="code"><dfn id="glo:optval.undefaction.warn"><span class="optfmt">warn</span></dfn></code></div><!-- end of optionvaluebox -->
+ Only produces a warning message for undefined <a id="wrglossary.354"></a><a href="#glo:dual.glossary">glossary</a> entries. The place where the entry has been referenced will be marked with <a id="wrglossary.355"></a><a href="#glo:idx.unknowntag"><code class="code">??</code></a> (as with undefined labels or citations). The unknown marker is produced with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.356"></a><code class="code"><dfn id="glo:glsxtrundeftag"><code class="csfmt">\glsxtrundeftag</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>??</span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This defaults to two question marks.<p>
+Note that <a id="wrglossary.357"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a> will only display <a id="wrglossary.358"></a><a href="#glo:idx.unknowntag"><code class="code">??</code></a> in the document text with <a id="wrglossary.359"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=</span><a id="wrglossary.360"></a><a href="#glo:optval.undefaction.warn"><span class="optfmt">warn</span></a> if the entry hasn’t been defined, as the underlying boolean variable doesn’t exist and so is neither true nor false. (There will also be a warning in the transcript.) You may prefer to use <a id="wrglossary.361"></a><a href="#glo:GlsXtrIfUnusedOrUndefined"><code class="csfmt">\GlsXtrIfUnusedOrUndefined</code></a> instead. See §<a href="#sec:glsunset">5.10</a> for further details.<p>
+If you want to write a custom command that needs to generate a warning or error for an undefined reference, you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.362"></a><code class="code"><dfn id="glo:glsxtrundefaction"><code class="csfmt">\glsxtrundefaction</code></dfn>{<span class="meta">〈<em class="metainner">message</em>〉</span>}{<span class="meta">〈<em class="metainner">additional help</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This will produce the unknown marker if used within the document environment. Depending on the <a id="wrglossary.363"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a>, <a id="wrglossary.364"></a><a href="#glo:glsxtrundefaction"><code class="csfmt">\glsxtrundefaction</code></a> will either create an error with the given <span class="meta">〈<em class="metainner">message</em>〉</span> and <span class="meta">〈<em class="metainner">additional help</em>〉</span> or will create a warning with the given <span class="meta">〈<em class="metainner">message</em>〉</span>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.365"></a><code class="code"><dfn id="glo:opt.docdef"><span class="styoptfmt">docdef</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This setting governs where <a id="wrglossary.366"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> can be used (preamble-only or anywhere before the first <a id="wrglossary.367"></a><a href="#glo:dual.glossary">glossary</a> or anywhere within the document).<p>
+Commands like <a id="wrglossary.368"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> and <a id="wrglossary.369"></a><a href="#glo:glsxtrnewsymbol"><code class="csfmt">\glsxtrnewsymbol</code></a> that internally use <a id="wrglossary.370"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> are also governed by this option. Other commands, such as <a id="wrglossary.371"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a> are always preamble-only.<p>
+With just the base <a id="wrglossary.372"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, <a id="wrglossary.373"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is allowed in the <a id="wrglossary.374"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment as long as you haven’t used <a id="wrglossary.375"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a>. There are, however, problems that can occur when entries are defined within the <a id="wrglossary.376"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment (see the <a id="wrglossary.377"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> documentation for further details). To encourage preamble-only use, the <a id="wrglossary.378"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package prohibits the use of <a id="wrglossary.379"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> within the <a id="wrglossary.380"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment by default, but if you really want this you can use this package option to allow it.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+Note that in the case of <a id="wrglossary.381"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, all entry data is originally defined in <a id="wrglossary.382"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files. The entry definitions (using commands like <a id="wrglossary.383"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a> and <a id="wrglossary.384"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>) are written to the <a id="wrglossary.385"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> files that are input in the preamble. </div><!-- end of information -->
+<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.386"></a><a id="wrglossary.387"></a><a href="#glo:opt.docdef"><span class="styoptfmt">docdef</span></a>=<code class="code"><dfn id="glo:optval.docdef.false"><span class="optfmt">false</span></dfn></code></div><!-- end of optionvaluebox -->
+ Prohibits the use of <a id="wrglossary.388"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> within the <a id="wrglossary.389"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment. All entries must be defined in the preamble.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.390"></a><a id="wrglossary.391"></a><a href="#glo:opt.docdef"><span class="styoptfmt">docdef</span></a>=<code class="code"><dfn id="glo:optval.docdef.true"><span class="optfmt">true</span></dfn></code></div><!-- end of optionvaluebox -->
+ Permits the use of <a id="wrglossary.392"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> in the <a id="wrglossary.393"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment provided <a id="wrglossary.394"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> hasn’t been used (as per the base <a id="wrglossary.395"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package). This will create a temporary <a id="wrglossary.396"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file that contains the entry definitions so that they can be available on the next LaTeX run at the beginning of the document to allow any <a id="wrglossary.397"></a><a href="#glo:dual.glossary">glossaries</a> in the front matter to display correctly.<p>
+If all your <a id="wrglossary.398"></a><a href="#glo:dual.glossary">glossaries</a> occur at the end of the document, consider using <a id="wrglossary.399"></a><a href="#glo:opt.docdef"><span class="styoptfmt">docdef</span></a><span class="optfmt">=</span><a id="wrglossary.400"></a><a href="#glo:optval.docdef.restricted"><span class="optfmt">restricted</span></a> instead.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.401"></a><a id="wrglossary.402"></a><a href="#glo:opt.docdef"><span class="styoptfmt">docdef</span></a>=<code class="code"><dfn id="glo:optval.docdef.restricted"><span class="optfmt">restricted</span></dfn></code></div><!-- end of optionvaluebox -->
+ Permits the use of <a id="wrglossary.403"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> in the <a id="wrglossary.404"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment provided the entry definitions all occur before the first <a id="wrglossary.405"></a><a href="#glo:dual.glossary">glossary</a> is displayed.<p>
+This avoids the need for the <a id="wrglossary.406"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file. You will still need to take care about any changes made to the category code of characters that are required by the <span class="meta">〈<em class="metainner">key</em>〉</span>=<span class="meta">〈<em class="metainner">value</em>〉</span> mechanism (that is, the comma and equal sign) and any <a id="wrglossary.407"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.408"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> special character that occurs in the <a id="wrglossary.409"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key or label. If any of those characters are made active in the document (for example, through <a id="wrglossary.410"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> shortcuts), then it can cause problems with the entry definition.<p>
+This option will allow <a id="wrglossary.411"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> to be used in the document with <a id="wrglossary.412"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a>, but note that <a id="wrglossary.413"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a> remains a preamble-only command.<p>
+With this option, if an entry appears in the glossary before it has been defined, an error will occur (or a warning if the <a id="wrglossary.414"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=</span><a id="wrglossary.415"></a><a href="#glo:optval.undefaction.warn"><span class="optfmt">warn</span></a> option is used). If you edit your document and either remove an entry or change its label, you may need to delete the document’s temporary files (such as the <a id="wrglossary.416"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> and <a id="wrglossary.417"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a> files).<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.418"></a><a id="wrglossary.419"></a><a href="#glo:opt.docdef"><span class="styoptfmt">docdef</span></a>=<code class="code"><dfn id="glo:optval.docdef.atom"><span class="optfmt">atom</span></dfn></code></div><!-- end of optionvaluebox -->
+ This option behaves like <a id="wrglossary.420"></a><a href="#glo:opt.docdef"><span class="styoptfmt">docdef</span></a><span class="optfmt">=</span><a id="wrglossary.421"></a><a href="#glo:optval.docdef.restricted"><span class="optfmt">restricted</span></a> but creates the <a id="wrglossary.422"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file for <a href="https://atom.io/packages/autocomplete-glossaries">atom’s autocomplete support</a>. This file isn’t input by <a id="wrglossary.423"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and so associated problems with the use of this file are avoided, but it allows the autocomplete support to find the labels in the file.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+A <a href="https://www.dickimaw-books.com/bugtracker.php?key=173">bug fix</a> in <a id="wrglossary.424"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.47 has changed the format of the <a id="wrglossary.425"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file slightly. </div><!-- end of important -->
+<p>
+As with <a id="wrglossary.426"></a><a href="#glo:opt.docdef"><span class="styoptfmt">docdef</span></a><span class="optfmt">=</span><a id="wrglossary.427"></a><a href="#glo:optval.docdef.restricted"><span class="optfmt">restricted</span></a>, entries may be defined in the preamble or anywhere in the document, but they may only be referenced after they have been defined. Entries must be defined before the associated glossary is displayed.<p>
+If you need a list of all entry labels for the use of an editor or helper script you may also want to consider the package options <a id="wrglossary.428"></a><a href="#glo:opt.writeglslabels"><span class="styoptfmt">writeglslabels</span></a> and <a id="wrglossary.429"></a><a href="#glo:opt.writeglslabelnames"><span class="styoptfmt">writeglslabelnames</span></a> provided by the base <a id="wrglossary.430"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. Note that with these options and with <a id="wrglossary.431"></a><a href="#glo:opt.docdef"><span class="styoptfmt">docdef</span></a><span class="optfmt">=</span><a id="wrglossary.432"></a><a href="#glo:optval.docdef.atom"><span class="optfmt">atom</span></a>, only the entry labels that are visible to LaTeX can be saved. So if you are using <a id="wrglossary.433"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> you will only get the labels of the entries that have already been selected by <a id="wrglossary.434"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. The <a id="wrglossary.435"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files can be found by parsing the <a id="wrglossary.436"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file for <a id="wrglossary.437"></a><a href="#glo:glsxtr@resource"><code class="csfmt">\glsxtr@resource</code></a> (listed in the <a id="wrglossary.438"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a> option or <a id="wrglossary.439"></a><a href="#glo:jobname"><code class="csfmt">\jobname</code></a><span class="filefmt">.bib</span> if <a id="wrglossary.440"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a> is missing).<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.441"></a><code class="code"><dfn id="glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></dfn>={<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">initial: </span>none</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ Unlike the base <a id="wrglossary.442"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package option of the same name, this option isn’t boolean but has multiple values.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+Multiple invocations of the <a id="wrglossary.443"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a> option <span style="font-style: italic; font-variant: normal; ">within the same option list</span> will override each other. Since these options define commands, the action can’t be undone with a later <a id="wrglossary.444"></a><a href="#glo:glossariesextrasetup"><code class="csfmt">\glossariesextrasetup</code></a>. </div><!-- end of information -->
+<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.445"></a><a id="wrglossary.446"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a>=<code class="code"><dfn id="glo:optval.shortcuts.ac"><span class="optfmt">ac</span></dfn></code></div><!-- end of optionvaluebox -->
+ Set the shortcut commands provided by the base <a id="wrglossary.447"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package for acronyms (such as <a id="wrglossary.448"></a><a href="#glo:ac"><code class="csfmt">\ac</code></a>) but use the <a id="wrglossary.449"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> abbreviation commands, such as <a id="wrglossary.450"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> and <a id="wrglossary.451"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a>, instead of the analogous base commands, such as <a id="wrglossary.452"></a><a href="#glo:acrshort"><code class="csfmt">\acrshort</code></a> and <a id="wrglossary.453"></a><a href="#glo:acrlong"><code class="csfmt">\acrlong</code></a>. See §<a href="#sec:abbrshortcuts">4.3.2</a> for further details.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.454"></a><a id="wrglossary.455"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a>=<code class="code"><dfn id="glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></dfn></code></div><!-- end of optionvaluebox -->
+ Sets the abbreviation shortcuts (see §<a href="#sec:abbrshortcuts">4.3.2</a>). This setting doesn’t switch on the acronym shortcuts provided by the base <a id="wrglossary.456"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.457"></a><a id="wrglossary.458"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a>=<code class="code"><dfn id="glo:optval.shortcuts.abbr"><span class="optfmt">abbr</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a></span><span class="clearfix"></span></div><!-- end of optionvaluebox -->
+ Synonym for <a id="wrglossary.459"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.460"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a>.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.461"></a><a id="wrglossary.462"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a>=<code class="code"><dfn id="glo:optval.shortcuts.other"><span class="optfmt">other</span></dfn></code></div><!-- end of optionvaluebox -->
+ Implements the other (non-abbreviation) shortcut commands: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.463"></a><code class="code"><dfn id="glo:newentry"><code class="csfmt">\newentry</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ A synonym for <a id="wrglossary.464"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.465"></a><code class="code"><dfn id="glo:newsym"><code class="csfmt">\newsym</code></dfn>[<span class="meta">〈<em class="metainner">key=value list</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">sym</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ A synonym for <a id="wrglossary.466"></a><a href="#glo:glsxtrnewsymbol"><code class="csfmt">\glsxtrnewsymbol</code></a> (provided that the <a id="wrglossary.467"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a> package option is also used).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.468"></a><code class="code"><dfn id="glo:newnum"><code class="csfmt">\newnum</code></dfn>[<span class="meta">〈<em class="metainner">key=value list</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">num</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ A synonym for <a id="wrglossary.469"></a><a href="#glo:glsxtrnewnumber"><code class="csfmt">\glsxtrnewnumber</code></a> (provided that the <a id="wrglossary.470"></a><a href="#glo:opt.numbers"><span class="styoptfmt">numbers</span></a> package option is also used).<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.471"></a><a id="wrglossary.472"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a>=<code class="code"><dfn id="glo:optval.shortcuts.acother"><span class="optfmt">acother</span></dfn></code></div><!-- end of optionvaluebox -->
+ Implements <a id="wrglossary.473"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.474"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> and <a id="wrglossary.475"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=other</span>.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.476"></a><a id="wrglossary.477"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a>=<code class="code"><dfn id="glo:optval.shortcuts.abother"><span class="optfmt">abother</span></dfn></code></div><!-- end of optionvaluebox -->
+ Implements <a id="wrglossary.478"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.479"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> and <a id="wrglossary.480"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=other</span>.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.481"></a><a id="wrglossary.482"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a>=<code class="code"><dfn id="glo:optval.shortcuts.all"><span class="optfmt">all</span></dfn></code></div><!-- end of optionvaluebox -->
+ Implements <a id="wrglossary.483"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.484"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a>, <a id="wrglossary.485"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.486"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> and <a id="wrglossary.487"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=other</span>.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.488"></a><a id="wrglossary.489"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a>=<code class="code"><dfn id="glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></dfn></code></div><!-- end of optionvaluebox -->
+ Sets the shortcuts provided by the base <a id="wrglossary.490"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package for acronyms (such as <a id="wrglossary.491"></a><a href="#glo:ac"><code class="csfmt">\ac</code></a>). See the <a id="wrglossary.492"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package documentation for further details.<p>
+Note that the short and long forms (<a id="wrglossary.493"></a><a href="#glo:acs"><code class="csfmt">\acs</code></a> and <a id="wrglossary.494"></a><a href="#glo:acl"><code class="csfmt">\acl</code></a>) don’t use <a id="wrglossary.495"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> and <a id="wrglossary.496"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> but use the original <a id="wrglossary.497"></a><a href="#glo:acrshort"><code class="csfmt">\acrshort</code></a> and <a id="wrglossary.498"></a><a href="#glo:acrlong"><code class="csfmt">\acrlong</code></a>, which aren’t compatible with the <a id="wrglossary.499"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> abbreviation mechanism. The better option is to use <a id="wrglossary.500"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.501"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+Don’t use <a id="wrglossary.502"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.503"></a><a href="#glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></a> unless you have reverted <a id="wrglossary.504"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> back to the base <a id="wrglossary.505"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s acronym mechanism. See §<a href="#sec:acrorevert">4.6</a> for further details. </div><!-- end of information -->
+<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.506"></a><a id="wrglossary.507"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a>=<code class="code"><dfn id="glo:optval.shortcuts.acro"><span class="optfmt">acro</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></a></span><span class="clearfix"></span></div><!-- end of optionvaluebox -->
+ Synonym for <a id="wrglossary.508"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.509"></a><a href="#glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></a>.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.510"></a><a id="wrglossary.511"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a>=<code class="code"><dfn id="glo:optval.shortcuts.true"><span class="optfmt">true</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:optval.shortcuts.all"><span class="optfmt">all</span></a></span><span class="clearfix"></span></div><!-- end of optionvaluebox -->
+ This setting is provided by the base <a id="wrglossary.512"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. With <a id="wrglossary.513"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> it’s equivalent to <a id="wrglossary.514"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.515"></a><a href="#glo:optval.shortcuts.all"><span class="optfmt">all</span></a>.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.516"></a><a id="wrglossary.517"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a>=<code class="code"><dfn id="glo:optval.shortcuts.false"><span class="optfmt">false</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:optval.shortcuts.all"><span class="optfmt">all</span></a></span><span class="clearfix"></span></div><!-- end of optionvaluebox -->
+ This setting is provided by the base <a id="wrglossary.518"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. With <a id="wrglossary.519"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> it’s equivalent to <a id="wrglossary.520"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.521"></a><a href="#glo:optval.shortcuts.none"><span class="optfmt">none</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.522"></a><code class="code"><dfn id="glo:opt.indexcrossrefs"><span class="styoptfmt">indexcrossrefs</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">varies</em></span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This is a boolean option that governs whether or not to automatically index any cross-referenced entries that haven’t been marked as used at the end of the document. These are entries that are identified in one of the cross-referencing fields (<a id="wrglossary.523"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> and <a id="wrglossary.524"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a>) of another used entry as opposed to entries that have the cross-referencing fields set.<p>
+Since entries with the <a id="wrglossary.525"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> key are intended as synonyms for another term, the target is expected to be indexed so entries with the <a id="wrglossary.526"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> key set aren’t affected by this option.<p>
+For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.527"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{courgette}{<a id="wrglossary.528"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={courgette}</span>,
+ <a id="wrglossary.529"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={small vegetable marrow}</span>}
+<a id="wrglossary.530"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{marrow}{<a id="wrglossary.531"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={marrow}</span>,
+ <a id="wrglossary.532"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={long gourd with green skin}</span>,
+ <a id="wrglossary.533"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a><span class="optfmt">={courgette}</span>}
+</pre> Suppose that <span class="qt">“marrow”</span> is indexed (so that it appears in the glossary with the cross-reference to <span class="qt">“courgette”</span>) but if courgette isn’t indexed anywhere in the document (using commands like <a id="wrglossary.534"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or <a id="wrglossary.535"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>) then there will be a broken cross-reference in the marrow <a id="wrglossary.536"></a><a href="#glo:dual.locationlist">location list</a> pointing to courgette, which doesn’t appear in the glossary. With <a id="wrglossary.537"></a><a href="#glo:opt.indexcrossrefs"><span class="styoptfmt">indexcrossrefs</span></a><span class="optfmt">=</span><a id="wrglossary.538"></a><a href="#glo:optval.indexcrossrefs.true"><span class="optfmt">true</span></a>, the courgette entry will be indexed at the end of the document using <a id="wrglossary.539"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> with <a id="wrglossary.540"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=glsxtrunusedformat</span>, which corresponds to the command <a id="wrglossary.541"></a><a href="#glo:glsxtrunusedformat"><code class="csfmt">\glsxtrunusedformat</code></a>.<p>
+Note that this special format <a id="wrglossary.542"></a><a href="#glo:glsxtrunusedformat"><code class="csfmt">\glsxtrunusedformat</code></a> simply does <a id="wrglossary.543"></a><a href="#glo:unskip"><code class="csfmt">\unskip</code></a> and ignores its argument, which creates a blank location. If any of the cross-referenced entries have been indexed but haven’t been marked as used (for example, with <a id="wrglossary.544"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>) then this will cause a spurious comma in the <a id="wrglossary.545"></a><a href="#glo:dual.locationlist">location list</a>. This is a limitation of the way that <a id="wrglossary.546"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.547"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> work as they are general purpose indexing applications which require locations. If you have entries with cross-references, you may want to consider switching to <a id="wrglossary.548"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> instead.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+Note that <a id="wrglossary.549"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can automatically find dependent entries when it parses the <a id="wrglossary.550"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> source file, so the <a id="wrglossary.551"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a> option automatically implements <a id="wrglossary.552"></a><a href="#glo:opt.indexcrossrefs"><span class="styoptfmt">indexcrossrefs</span></a><span class="optfmt">=</span><a id="wrglossary.553"></a><a href="#glo:optval.indexcrossrefs.false"><span class="optfmt">false</span></a>. </div><!-- end of information -->
+<p>
+This function is implemented by code added to the end document hook that determines whether or not to use the command <a id="wrglossary.554"></a><a href="#glo:glsxtraddallcrossrefs"><code class="csfmt">\glsxtraddallcrossrefs</code></a>. This command iterates over all entries in all glossaries, which adds to the overall document build time, especially if you have defined a large number of entries, so this defaults to <a id="wrglossary.555"></a><a href="#glo:opt.indexcrossrefs"><span class="styoptfmt">indexcrossrefs</span></a><span class="optfmt">=</span><a id="wrglossary.556"></a><a href="#glo:optval.indexcrossrefs.false"><span class="optfmt">false</span></a>, but it will be automatically switched on if you use the <a id="wrglossary.557"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> or <a id="wrglossary.558"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> keys in any entries. See also §<a href="#sec:xr">5.9</a>.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.559"></a><a id="wrglossary.560"></a><a href="#glo:opt.indexcrossrefs"><span class="styoptfmt">indexcrossrefs</span></a>=<code class="code"><dfn id="glo:optval.indexcrossrefs.true"><span class="optfmt">true</span></dfn></code></div><!-- end of optionvaluebox -->
+ Enables this setting.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.561"></a><a id="wrglossary.562"></a><a href="#glo:opt.indexcrossrefs"><span class="styoptfmt">indexcrossrefs</span></a>=<code class="code"><dfn id="glo:optval.indexcrossrefs.false"><span class="optfmt">false</span></dfn></code></div><!-- end of optionvaluebox -->
+ Disables this setting even if the <a id="wrglossary.563"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> or <a id="wrglossary.564"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> key is present in any entries.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.565"></a><code class="code"><dfn id="glo:opt.autoseeindex"><span class="styoptfmt">autoseeindex</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This is a boolean option that governs whether or not the <a id="wrglossary.566"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> and <a id="wrglossary.567"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> keys should automatically index the cross-reference when an entry is defined (see §<a href="#sec:xr">5.9</a>).<p>
+With the base <a id="wrglossary.568"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, the <a id="wrglossary.569"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key was provided as a shortcut for <a id="wrglossary.570"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.571"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{courgette}{<a id="wrglossary.572"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={courgette}</span>,
+ <a id="wrglossary.573"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={small vegetable marrow}</span>}
+<a id="wrglossary.574"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{zucchini}{<a id="wrglossary.575"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={zucchini}</span>,
+ <a id="wrglossary.576"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,
+ <a id="wrglossary.577"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={courgette}</span>}
+</pre> is equivalent to: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.578"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{courgette}{<a id="wrglossary.579"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={courgette}</span>,
+ <a id="wrglossary.580"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={small vegetable marrow}</span>}
+<a id="wrglossary.581"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{zucchini}{<a id="wrglossary.582"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={zucchini}</span>,
+ <a id="wrglossary.583"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.584"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>{zucchini}{courgette}
+</pre> This was designed for documents where only entries that are actually used in the document are defined and ensures that the cross-reference is included in the <a id="wrglossary.585"></a><a href="#glo:dual.glossary">glossary</a>, even though it may not be referenced anywhere in the document. However, it becomes problematic if neither entry is required in the document.<p>
+The <a id="wrglossary.586"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package modifies the action of the <a id="wrglossary.587"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key so that it also saves the value and will only perform the automated <a id="wrglossary.588"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a> if <a id="wrglossary.589"></a><a href="#glo:opt.autoseeindex"><span class="styoptfmt">autoseeindex</span></a><span class="optfmt">=</span><a id="wrglossary.590"></a><a href="#glo:optval.autoseeindex.true"><span class="optfmt">true</span></a>. Similarly for the <a id="wrglossary.591"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> key.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+Note that the <a id="wrglossary.592"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a> option automatically implements <a id="wrglossary.593"></a><a href="#glo:opt.autoseeindex"><span class="styoptfmt">autoseeindex</span></a><span class="optfmt">=</span><a id="wrglossary.594"></a><a href="#glo:optval.autoseeindex.false"><span class="optfmt">false</span></a> as the corresponding action can be implemented with <a id="wrglossary.595"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span>’s</a> <a id="wrglossary.596"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a> option. </div><!-- end of information -->
+<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.597"></a><a id="wrglossary.598"></a><a href="#glo:opt.autoseeindex"><span class="styoptfmt">autoseeindex</span></a>=<code class="code"><dfn id="glo:optval.autoseeindex.true"><span class="optfmt">true</span></dfn></code></div><!-- end of optionvaluebox -->
+ Enables automatic indexing using <a id="wrglossary.599"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a> for the <a id="wrglossary.600"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key (as per the base <a id="wrglossary.601"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package) and <a id="wrglossary.602"></a><a href="#glo:glsxtrindexseealso"><code class="csfmt">\glsxtrindexseealso</code></a> for the <a id="wrglossary.603"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> key.<p>
+For example, if an entry is defined as <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.604"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{foo}{<a id="wrglossary.605"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={foo}</span>,
+ <a id="wrglossary.606"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,<a id="wrglossary.607"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={bar,baz}</span>}
+</pre> then, with <a id="wrglossary.608"></a><a href="#glo:opt.autoseeindex"><span class="styoptfmt">autoseeindex</span></a><span class="optfmt">=</span><a id="wrglossary.609"></a><a href="#glo:optval.autoseeindex.true"><span class="optfmt">true</span></a> and the default <a id="wrglossary.610"></a><a href="#glo:opt.indexcrossrefs"><span class="styoptfmt">indexcrossrefs</span></a> setting, this is equivalent to <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.611"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{foo}{<a id="wrglossary.612"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={foo}</span>,<a id="wrglossary.613"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.614"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>{foo}{bar,baz}
+<a id="wrglossary.615"></a><a href="#glo:glossariesextrasetup"><code class="csfmt">\glossariesextrasetup</code></a>{<a id="wrglossary.616"></a><a href="#glo:opt.indexcrossrefs"><span class="styoptfmt">indexcrossrefs</span></a><span class="optfmt">=</span><a id="wrglossary.617"></a><a href="#glo:optval.indexcrossrefs.true"><span class="optfmt">true</span></a>}
+<a id="wrglossary.618"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>{foo}{see}{bar,baz}
+</pre><p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.619"></a><a id="wrglossary.620"></a><a href="#glo:opt.autoseeindex"><span class="styoptfmt">autoseeindex</span></a>=<code class="code"><dfn id="glo:optval.autoseeindex.false"><span class="optfmt">false</span></dfn></code></div><!-- end of optionvaluebox -->
+ The value of the <a id="wrglossary.621"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> and <a id="wrglossary.622"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> keys will be stored in their corresponding fields (and can be accessed using commands like <a id="wrglossary.623"></a><a href="#glo:glsxtrusesee"><code class="csfmt">\glsxtrusesee</code></a> and <a id="wrglossary.624"></a><a href="#glo:glsxtruseseealso"><code class="csfmt">\glsxtruseseealso</code></a>) but the cross-reference won’t be automatically <a id="wrglossary.625"></a><a href="#glo:@@glslabel@indexing">indexed</a>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+Note that <a id="wrglossary.626"></a><a href="#glo:opt.indexcrossrefs"><span class="styoptfmt">indexcrossrefs</span></a> isn’t automatically implemented by the presence of the <a id="wrglossary.627"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key when <a id="wrglossary.628"></a><a href="#glo:opt.autoseeindex"><span class="styoptfmt">autoseeindex</span></a> is false. </div><!-- end of information -->
+<p>
+For example, if an entry is defined as <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.629"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{foo}{<a id="wrglossary.630"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={foo}</span>,
+ <a id="wrglossary.631"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,<a id="wrglossary.632"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={bar,baz}</span>}
+</pre> then, with <a id="wrglossary.633"></a><a href="#glo:opt.autoseeindex"><span class="styoptfmt">autoseeindex</span></a><span class="optfmt">=</span><a id="wrglossary.634"></a><a href="#glo:optval.autoseeindex.false"><span class="optfmt">false</span></a> and the default <a id="wrglossary.635"></a><a href="#glo:opt.indexcrossrefs"><span class="styoptfmt">indexcrossrefs</span></a> setting, this is equivalent to <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.636"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{foo}{<a id="wrglossary.637"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={foo}</span>,
+ <a id="wrglossary.638"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.639"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>{foo}{see}{bar,baz}
+</pre><p>
+It’s therefore possible with this option to remove the cross-references from the location lists and set their position within the <a id="wrglossary.640"></a><a href="#glo:idx.glossarystyle">glossary style</a>.<p>
+Another method of preventing the automatic indexing is to define the entries before the external indexing files have been opened with <a id="wrglossary.641"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>. Since the appropriate file isn’t open, the information can’t be written to it. This will need the package option <a id="wrglossary.642"></a><a href="#glo:opt.seenoindex"><span class="styoptfmt">seenoindex</span></a><span class="optfmt">=ignore</span> to prevent an error occurring.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.643"></a><code class="code"><dfn id="glo:opt.record"><span class="styoptfmt">record</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>only; <span class="summarytag">initial: </span>off</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This setting indicates whether or not <a id="wrglossary.644"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> is required.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+This option can only be set in the preamble and can’t be used after <a id="wrglossary.645"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a> or <a id="wrglossary.646"></a><a href="#glo:glsxtrresourcefile"><code class="csfmt">\glsxtrresourcefile</code></a>. </div><!-- end of information -->
+<p>
+With the recording setting on (<a id="wrglossary.647"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.648"></a><a href="#glo:optval.record.only"><span class="optfmt">only</span></a>, <a id="wrglossary.649"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.650"></a><a href="#glo:optval.record.nameref"><span class="optfmt">nameref</span></a> or <a id="wrglossary.651"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.652"></a><a href="#glo:optval.record.hybrid"><span class="optfmt">hybrid</span></a>), any of the commands that would typically index the entry (such as <a id="wrglossary.653"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>, <a id="wrglossary.654"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> or <a id="wrglossary.655"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>) will add a <a id="wrglossary.656"></a><a href="#glo:@@glslabel@indexing">record</a> to the <a id="wrglossary.657"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file. <a id="wrglossary.658"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can then read this information to find out which entries have been used. (Remember that commands like <a id="wrglossary.659"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a> don’t index, so any use of these commands won’t add a corresponding <a id="wrglossary.660"></a><a href="#glo:@@glslabel@indexing">record</a>.) See §<a href="#sec:bib2gls">11</a> for further details.<p>
+The hybrid method additionally performs the standard indexing action that’s required for <a id="wrglossary.661"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.662"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> to work, but this can’t be done until <a id="wrglossary.663"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> has created the <a id="wrglossary.664"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> files that provide the entry definitions. In general, it’s best to avoid the hybrid method.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.665"></a><a id="wrglossary.666"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>=<code class="code"><dfn id="glo:optval.record.off"><span class="optfmt">off</span></dfn></code></div><!-- end of optionvaluebox -->
+ Indexing is performed as per the base <a id="wrglossary.667"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package using either <a id="wrglossary.668"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> or <a id="wrglossary.669"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a>. This setting implements <a id="wrglossary.670"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=</span><a id="wrglossary.671"></a><a href="#glo:optval.undefaction.error"><span class="optfmt">error</span></a>.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.672"></a><a id="wrglossary.673"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>=<code class="code"><dfn id="glo:optval.record.only"><span class="optfmt">only</span></dfn></code></div><!-- end of optionvaluebox -->
+ <a id="wrglossary.674"></a><a href="#glo:indexing">indexing (or recording)</a> is performed by adding <a id="wrglossary.675"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> <a id="wrglossary.676"></a><a href="#glo:@@glslabel@indexing">records</a> in the <a id="wrglossary.677"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file. Neither <a id="wrglossary.678"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> nor <a id="wrglossary.679"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> is permitted. Use <a id="wrglossary.680"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a> (or <a id="wrglossary.681"></a><a href="#glo:glsxtrresourcefile"><code class="csfmt">\glsxtrresourcefile</code></a>) to set up <a id="wrglossary.682"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> <a id="wrglossary.683"></a><a href="#glo:idx.resourceopt">resource options</a>. Glossaries should be displayed with the <a id="wrglossary.684"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>, such as <a id="wrglossary.685"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>.<p>
+This setting implements <a id="wrglossary.686"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=</span><a id="wrglossary.687"></a><a href="#glo:optval.undefaction.warn"><span class="optfmt">warn</span></a>, <a id="wrglossary.688"></a><a href="#glo:opt.autoseeindex"><span class="styoptfmt">autoseeindex</span></a><span class="optfmt">=</span><a id="wrglossary.689"></a><a href="#glo:optval.autoseeindex.false"><span class="optfmt">false</span></a>, <a id="wrglossary.690"></a><a href="#glo:opt.indexcrossrefs"><span class="styoptfmt">indexcrossrefs</span></a><span class="optfmt">=</span><a id="wrglossary.691"></a><a href="#glo:optval.indexcrossrefs.false"><span class="optfmt">false</span></a> <a id="wrglossary.692"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.693"></a><a href="#glo:optval.sort.none"><span class="optfmt">none</span></a>, and automatically loads the supplementary <a id="wrglossary.694"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> package. (There should be no need to explicitly load <a id="wrglossary.695"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a>.)<p>
+This option also defines the <a id="wrglossary.696"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a> and <a id="wrglossary.697"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a> keys that are set by <a id="wrglossary.698"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to provide the <a id="wrglossary.699"></a><a href="#glo:dual.locationlist">location list</a> and <a id="wrglossary.700"></a><a href="#glo:idx.group">group</a> information required by the <a id="wrglossary.701"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>.<p>
+The document build process is (assuming the file is called <span class="filefmt">myDoc.tex</span>): <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
+bib2gls myDoc
+pdflatex myDoc
+</pre> If you want letter <a id="wrglossary.702"></a><a href="#glo:idx.group">groups</a> you will need the <a id="wrglossary.703"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> or <a id="wrglossary.704"></a><a href="#glo:switch.group"><span class="shortargfmt">-g</span></a> switch when invoking <a id="wrglossary.705"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
+bib2gls <a id="wrglossary.706"></a><a href="#glo:switch.group"><span class="shortargfmt">-g</span></a> myDoc
+pdflatex myDoc
+</pre><p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Note that this setting will prevent the <a id="wrglossary.707"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> from automatically implementing <a id="wrglossary.708"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>. (<a id="wrglossary.709"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> deals with the <a id="wrglossary.710"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> field.) You may explicitly use <a id="wrglossary.711"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a> in the document, but <a id="wrglossary.712"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> will ignore the cross-reference if the <a id="wrglossary.713"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> field was already set for that entry. </div><!-- end of important -->
+<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.714"></a><a id="wrglossary.715"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>=<code class="code"><dfn id="glo:optval.record.nameref"><span class="optfmt">nameref</span></dfn></code></div><!-- end of optionvaluebox -->
+ As <a id="wrglossary.716"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.717"></a><a href="#glo:optval.record.only"><span class="optfmt">only</span></a> but uses nameref <a id="wrglossary.718"></a><a href="#glo:@@glslabel@indexing">records</a>, which include the current label information given by <a id="wrglossary.719"></a><a href="#glo:@currentlabel"><code class="csfmt">\@currentlabel</code></a> and <a id="wrglossary.720"></a><a href="#glo:@currentHref"><code class="csfmt">\@currentHref</code></a>. This means that the title can be included in the <a id="wrglossary.721"></a><a href="#glo:dual.entrylocation">entry locations</a>, if available. This setting also supports location hypertargets that don’t follow a simple <span class="meta">〈<em class="metainner">h-prefix</em>〉</span><span class="meta">〈<em class="metainner"><a id="wrglossary.722"></a><a href="#glo:@@glslabel@locationcounter">the-counter</a></em>〉</span> format, which can’t be used with other indexing options.<p>
+See §<a href="#sec:recordnameref">11.5.6</a> for further details of this option.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+This option requires <a id="wrglossary.723"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>, otherwise it will fall back on the usual location <a id="wrglossary.724"></a><a href="#glo:@@glslabel@indexing">records</a>. </div><!-- end of information -->
+<p>
+Note that <a id="wrglossary.725"></a><a href="#glo:@currentHref"><code class="csfmt">\@currentHref</code></a> is always globally updated whenever <a id="wrglossary.726"></a><a href="#glo:refstepcounter"><code class="csfmt">\refstepcounter</code></a> is used, but <a id="wrglossary.727"></a><a href="#glo:@currentlabel"><code class="csfmt">\@currentlabel</code></a> isn’t. This can cause some undesired side-effects with some settings. Remember also that the <a id="wrglossary.728"></a><a href="#glo:opt.indexcounter"><span class="styoptfmt">indexcounter</span></a> option increments the associated counter every time an entry is <a id="wrglossary.729"></a><a href="#glo:@@glslabel@indexing">indexed</a>, which affects this option. If the <a id="wrglossary.730"></a><a href="#glo:dual.locationcounter">location counter</a> is the default <a id="wrglossary.731"></a><a href="#glo:ctr.page"><span class="ctrfmt">page</span></a>, only the <a id="wrglossary.732"></a><a href="#glo:@@glslabel@entrylocation">location</a> number is shown.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.733"></a><a id="wrglossary.734"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>=<code class="code"><dfn id="glo:optval.record.alsoindex"><span class="optfmt">alsoindex</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:optval.record.hybrid"><span class="optfmt">hybrid</span></a> <a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></span><span class="clearfix"></span></div><!-- end of optionvaluebox -->
+ Deprecated synonym of <a id="wrglossary.735"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.736"></a><a href="#glo:optval.record.hybrid"><span class="optfmt">hybrid</span></a>.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.737"></a><a id="wrglossary.738"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>=<code class="code"><dfn id="glo:optval.record.hybrid"><span class="optfmt">hybrid</span></dfn></code></div><!-- end of optionvaluebox -->
+ This is a hybrid setting that uses <a id="wrglossary.739"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to fetch entry information from <a id="wrglossary.740"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files, but uses <a id="wrglossary.741"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.742"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> to create the <a id="wrglossary.743"></a><a href="#glo:dual.glossary">glossary</a> files (which are input with <a id="wrglossary.744"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>). Note that this requires a slower and more complicated build process (see below).<p>
+This hybrid approach is provided for the rare instances where an existing <a id="wrglossary.745"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> rule or module is too complicated to convert to a <a id="wrglossary.746"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> rule but the entries need to be fetched from a <a id="wrglossary.747"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file. There’s no benefit in using this option with <a id="wrglossary.748"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>.<p>
+This setting does not load <a id="wrglossary.749"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a>, as <a id="wrglossary.750"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> is only being used to fetch the entry definitions.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+Since it’s redundant to make <a id="wrglossary.751"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> also sort and collate locations (in addition to <a id="wrglossary.752"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> performing these tasks), use the resource options <a id="wrglossary.753"></a><a href="#glo:opt.resource.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=none</span> and <a id="wrglossary.754"></a><a href="#glo:opt.resource.save-locations"><span class="csoptfmt">save-locations</span></a><span class="optfmt">=false</span> for a faster build. Many of the other <a id="wrglossary.755"></a><a href="#glo:idx.resourceopt">resource options</a> are likely to be irrelevant. </div><!-- end of information -->
+<p>
+This setting must be used with <a id="wrglossary.756"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> but not with its optional argument. Each <a id="wrglossary.757"></a><a href="#glo:dual.glossary">glossary</a> should be displayed using <a id="wrglossary.758"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> (or <a id="wrglossary.759"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a> for all of them).<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+This setting should not be used with <a id="wrglossary.760"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a>. </div><!-- end of important -->
+<p>
+You may need to change the transcript file used by <a id="wrglossary.761"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to avoid a clash with <a id="wrglossary.762"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span>’s</a> transcript file. This can be done with <a id="wrglossary.763"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span>’s</a> <a id="wrglossary.764"></a><a href="#glo:switch.log-file"><span class="longargfmt">--log-file</span></a> or <a id="wrglossary.765"></a><a href="#glo:switch.log-file"><span class="shortargfmt">-t</span></a> option.<p>
+The document build process is (assuming the file is called <span class="filefmt">myDoc.tex</span>): <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
+bib2gls myDoc
+pdflatex myDoc
+makeglossaries myDoc
+pdflatex myDoc
+</pre> Note that, in this case, it’s redundant to call <a id="wrglossary.766"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> with the <a id="wrglossary.767"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> or <a id="wrglossary.768"></a><a href="#glo:switch.group"><span class="shortargfmt">-g</span></a> switch as <a id="wrglossary.769"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> will insert the group heading information into the corresponding <a id="wrglossary.770"></a><a href="#glo:dual.glossary">glossary</a> file.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+If you want <a id="wrglossary.771"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to form the letter groups then this hybrid method is inappropriate. </div><!-- end of information -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.772"></a><code class="code"><dfn id="glo:opt.bibglsaux"><span class="styoptfmt">bibglsaux</span></dfn>=<span class="meta">〈<em class="metainner">basename</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">empty</em></span></span><span class="clearfix"></span><p>
+<div class="noteBox">requires <a id="wrglossary.773"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v3.0+</div><!-- end of noteBox -->
+</div><!-- end of settingsbox -->
+<p>
+Alternatively, this setting can be implemented with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.774"></a><code class="code"><dfn id="glo:glsxtrsetbibglsaux"><code class="csfmt">\glsxtrsetbibglsaux</code></dfn>{<span class="meta">〈<em class="metainner">basename</em>〉</span>}</code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+<p>
+This option should only be used once. If used again no new file will be created. If the <span class="meta">〈<em class="metainner">basename</em>〉</span> value is empty, <a id="wrglossary.775"></a><a href="#glo:@@glslabel@indexing">records</a> will be written to the normal <a id="wrglossary.776"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file.<p>
+A document containing many <a id="wrglossary.777"></a><a href="#glo:@@glslabel@indexing">records</a> can result in a large <a id="wrglossary.778"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file with information that’s only relevant to <a id="wrglossary.779"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. This option will create a new file called <span class="filefmt"></span><span class="meta">〈<em class="metainner">basename</em>〉</span><span class="filefmt">.aux</span> that will be used to store the <a id="wrglossary.780"></a><a href="#glo:@@glslabel@indexing">records</a>. The file will be skipped by LaTeX but will be picked up by <a id="wrglossary.781"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v3.0+ when it inputs the main <a id="wrglossary.782"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file. Note that this creates an extra write register.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+You should still supply the main <a id="wrglossary.783"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file when you run <a id="wrglossary.784"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> as <span class="filefmt"></span><span class="meta">〈<em class="metainner">basename</em>〉</span><span class="filefmt">.aux</span> will only contain the <a id="wrglossary.785"></a><a href="#glo:@@glslabel@indexing">records</a> and not the other information that <a id="wrglossary.786"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> requires (such as the <a id="wrglossary.787"></a><a href="#glo:idx.resourceopt">resource options</a>). </div><!-- end of important -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.788"></a><code class="code"><dfn id="glo:opt.equations"><span class="styoptfmt">equations</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This setting will cause the default <a id="wrglossary.789"></a><a href="#glo:dual.locationcounter">location counter</a> to automatically switch to <a id="wrglossary.790"></a><a href="#glo:ctr.equation"><span class="ctrfmt">equation</span></a> when inside a numbered equation environment, such as <a id="wrglossary.791"></a><a href="#glo:env.equation"><span class="envfmt">equation</span></a> or <a id="wrglossary.792"></a><a href="#glo:env.align"><span class="envfmt">align</span></a>. The counter can be explicitly overridden with the <a id="wrglossary.793"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a> <a id="wrglossary.794"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> option</a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.795"></a><code class="code"><dfn id="glo:opt.floats"><span class="styoptfmt">floats</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This setting will cause the default <a id="wrglossary.796"></a><a href="#glo:dual.locationcounter">location counter</a> to automatically switch to the corresponding counter when inside a floating environment, such as <a id="wrglossary.797"></a><a href="#glo:env.figure"><span class="envfmt">figure</span></a> or <a id="wrglossary.798"></a><a href="#glo:env.table"><span class="envfmt">table</span></a>. The counter can be explicitly overridden with the <a id="wrglossary.799"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a> <a id="wrglossary.800"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> option</a>.<p>
+Remember that within floats it’s the <a id="wrglossary.801"></a><a href="#glo:caption"><code class="csfmt">\caption</code></a> command that actually uses <a id="wrglossary.802"></a><a href="#glo:refstepcounter"><code class="csfmt">\refstepcounter</code></a>, so indexing before the caption will result in the wrong reference. The commands for use in captions and sections, such as <a id="wrglossary.803"></a><a href="#glo:glsfmttext"><code class="csfmt">\glsfmttext</code></a> and <a id="wrglossary.804"></a><a href="#glo:glsfmtshort"><code class="csfmt">\glsfmtshort</code></a>, don’t index. (See §<a href="#sec:headtitle">5.3</a>). You may want to consider using <a id="wrglossary.805"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> after the caption (not before). For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cbeg">\begin{figure}</code>[htbp]
+ <code class="cmd">\centering</code>
+ <code class="cmd">\includegraphics</code>{example-image}
+ <a id="wrglossary.806"></a><a href="#glo:caption"><code class="csfmt">\caption</code></a>{Sample <a id="wrglossary.807"></a><a href="#glo:glsfmttext"><code class="csfmt">\glsfmttext</code></a>{foobar} figure}
+ <a id="wrglossary.808"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>{foobar}
+<code class="cend">\end{figure}</code>
+</pre><p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.809"></a><code class="code"><dfn id="glo:opt.indexcounter"><span class="styoptfmt">indexcounter</span></dfn></code></div><!-- end of settingsbox -->
+ This option defines the <a id="wrglossary.810"></a><a href="#glo:dual.indexing">indexing</a> counter: <div class="ctrbox"><div class="ctrboxtitle"><a href="#glo:sym.counter"><span title="Counter" class="icon">№</span></a></div><!-- end of ctrboxtitle -->
+<a id="wrglossary.811"></a><code class="code"><dfn id="glo:ctr.wrglossary"><span class="ctrfmt">wrglossary</span></dfn></code></div><!-- end of ctrbox -->
+ which is incremented every time an entry is <a id="wrglossary.812"></a><a href="#glo:@@glslabel@indexing">indexed</a>. This option automatically implements <a id="wrglossary.813"></a><a href="#glo:opt.counter"><span class="styoptfmt">counter</span></a><span class="optfmt">=wrglossary</span>. This means that each <a id="wrglossary.814"></a><a href="#glo:@@glslabel@entrylocation">location</a> will link to the relevant part of the page where the <a id="wrglossary.815"></a><a href="#glo:dual.indexing">indexing</a> occurred (instead of to the top of the page). See the <a id="wrglossary.816"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> documentation for the <a id="wrglossary.817"></a><a href="#glo:opt.resource.save-index-counter"><span class="csoptfmt">save-index-counter</span></a> resource option for more details.<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+This option is primarily intended for use with <a id="wrglossary.818"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> (v1.4+) and <a id="wrglossary.819"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>. It can be used with <a id="wrglossary.820"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.821"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, but it will interfere with the <a id="wrglossary.822"></a><a href="#glo:dual.locationlist">location list</a> collation, so you won’t have ranges and you’ll have duplicate page numbers present. </div><!-- end of warning -->
+<p>
+This option works by incrementing <a id="wrglossary.823"></a><a href="#glo:ctr.wrglossary"><span class="ctrfmt">wrglossary</span></a> with <a id="wrglossary.824"></a><a href="#glo:refstepcounter"><code class="csfmt">\refstepcounter</code></a> and adding <a id="wrglossary.825"></a><a href="#glo:label"><code class="csfmt">\label</code></a>. This can cause a problem if the <a id="wrglossary.826"></a><a href="#glo:dual.indexing">indexing</a> occurs in an <a id="wrglossary.827"></a><a href="#glo:env.equation"><span class="envfmt">equation</span></a> environment as <a id="wrglossary.828"></a><a href="#glo:pkg.amsmath"><span class="styfmt">amsmath</span></a> forbids multiple occurrences of <a id="wrglossary.829"></a><a href="#glo:label"><code class="csfmt">\label</code></a> (resulting in the <span class="qt">“Multiple <a id="wrglossary.830"></a><a href="#glo:label"><code class="csfmt">\label</code></a>’s”</span> error). It’s best to change the counter to <a id="wrglossary.831"></a><a href="#glo:ctr.page"><span class="ctrfmt">page</span></a> or <a id="wrglossary.832"></a><a href="#glo:ctr.equation"><span class="ctrfmt">equation</span></a> when in maths mode with this option. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.833"></a><a href="#glo:glslinkpresetkeys"><code class="csfmt">\glslinkpresetkeys</code></a>}{<span class="comment">% </span>
+ <code class="cmd">\ifmmode</code> <a id="wrglossary.834"></a><a href="#glo:setupglslink"><code class="csfmt">\setupglslink</code></a>{<a id="wrglossary.835"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a><span class="optfmt">=page</span>}<code class="cmd">\fi</code>}
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.836"></a><a href="#glo:glsaddpresetkeys"><code class="csfmt">\glsaddpresetkeys</code></a>}{<span class="comment">% </span>
+ <code class="cmd">\ifmmode</code> <a id="wrglossary.837"></a><a href="#glo:setupglsadd"><code class="csfmt">\setupglsadd</code></a>{<a id="wrglossary.838"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a><span class="optfmt">=page</span>}<code class="cmd">\fi</code>}
+</pre><p>
+
+</section><!-- end of section sec:refindexopts -->
+
+<section id="sec:debuggingopts"><!-- start of section sec:debuggingopts --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->2.5. Debugging<div class="labellink"><a href="#sec:debuggingopts">[link]</a></div></h2><!-- end of section header -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.839"></a><code class="code"><dfn id="glo:opt.debug"><span class="styoptfmt">debug</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ Enables debugging information for draft documents. This option is defined by the base <a id="wrglossary.840"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, but is extended by <a id="wrglossary.841"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> to provide additional settings. If no value is provided, <a id="wrglossary.842"></a><a href="#glo:optval.debug.true"><span class="optfmt">true</span></a> is assumed. The following values are available:<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.843"></a><a id="wrglossary.844"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a>=<code class="code"><dfn id="glo:optval.debug.false"><span class="optfmt">false</span></dfn></code></div><!-- end of optionvaluebox -->
+ This setting is provided by the <a id="wrglossary.845"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package and is the default. This switches off all debugging commands.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.846"></a><a id="wrglossary.847"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a>=<code class="code"><dfn id="glo:optval.debug.true"><span class="optfmt">true</span></dfn></code></div><!-- end of optionvaluebox -->
+ This setting is provided by the <a id="wrglossary.848"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package and switches on logging information if an entry is <a id="wrglossary.849"></a><a href="#glo:@@glslabel@indexing">indexed</a> before the relevant <a id="wrglossary.850"></a><a href="#glo:dual.indexing">indexing</a> files have been opened (only applicable with <a id="wrglossary.851"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.852"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>). This option is extended by <a id="wrglossary.853"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> to also display the label of unknown entries before the <a id="wrglossary.854"></a><a href="#glo:idx.unknowntag"><code class="code">??</code></a> marker. <div style="text-align: center; border-style: none; "><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
+<p>
+<pre class="sidebysidecode">
+<code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.855"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a>]
+{glossaries-extra}
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.856"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{example}
+<code class="cend">\end{document}</code>
+</pre><div class="sidebysideresult"><span class="glsshowtargetfonttext">[example]</span><a id="wrglossary.857"></a><a href="#glo:idx.unknowntag">??</a> </div><p>
+ This uses <a id="wrglossary.858"></a><a href="#glo:glsshowtargetfonttext"><code class="csfmt">\glsshowtargetfonttext</code></a> for the annotation, which is provided by <a id="wrglossary.859"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>. <div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.860"></a><a id="wrglossary.861"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a>=<code class="code"><dfn id="glo:optval.debug.showaccsupp"><span class="optfmt">showaccsupp</span></dfn></code></div><!-- end of optionvaluebox -->
+ Provided by <a id="wrglossary.862"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>, this setting shows accessibility information (<a id="wrglossary.863"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a>).<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.864"></a><a id="wrglossary.865"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a>=<code class="code"><dfn id="glo:optval.debug.all"><span class="optfmt">all</span></dfn></code></div><!-- end of optionvaluebox -->
+ Implements all debugging options.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.866"></a><a id="wrglossary.867"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a>=<code class="code"><dfn id="glo:optval.debug.showwrgloss"><span class="optfmt">showwrgloss</span></dfn></code></div><!-- end of optionvaluebox -->
+ This setting is only available with <a id="wrglossary.868"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. This implements <a id="wrglossary.869"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.870"></a><a href="#glo:optval.debug.true"><span class="optfmt">true</span></a> and shows a marker (·) just before the write operation is performed by indexing commands. With <a id="wrglossary.871"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.872"></a><a href="#glo:optval.record.hybrid"><span class="optfmt">hybrid</span></a> there will be two marks: one for the write operation to the <a id="wrglossary.873"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and one for the associated <a id="wrglossary.874"></a><a href="#glo:dual.glossary">glossary</a> file used by <a id="wrglossary.875"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.876"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. The marker is produced with the command: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.877"></a><code class="code"><dfn id="glo:glsxtrwrglossmark"><code class="csfmt">\glsxtrwrglossmark</code></dfn></code></div><!-- end of pinnedbox -->
+<p>
+If the <a id="wrglossary.878"></a><a href="#glo:opt.indexcounter"><span class="styoptfmt">indexcounter</span></a> option has been used, this setting will also mark where the <a id="wrglossary.879"></a><a href="#glo:ctr.wrglossary"><span class="ctrfmt">wrglossary</span></a> counter has been incremented. The marker is produced with the command: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.880"></a><code class="code"><dfn id="glo:glsxtrwrglosscountermark"><code class="csfmt">\glsxtrwrglosscountermark</code></dfn>{<span class="meta">〈<em class="metainner">number</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This marker is also inserted before the location in the definition of <a id="wrglossary.881"></a><a href="#glo:glsxtrwrglossarylocfmt"><code class="csfmt">\glsxtrwrglossarylocfmt</code></a>.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.882"></a><a id="wrglossary.883"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a>=<code class="code"><dfn id="glo:optval.debug.showtargets"><span class="optfmt">showtargets</span></dfn></code></div><!-- end of optionvaluebox -->
+ This setting is provided by <a id="wrglossary.884"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> and displays the hyperlink target names whenever any <a id="wrglossary.885"></a><a href="#glo:dual.glossary">glossary</a>-related commands create a hyperlink or hypertarget (for example, <a id="wrglossary.886"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>, <a id="wrglossary.887"></a><a href="#glo:glstarget"><code class="csfmt">\glstarget</code></a> or <a id="wrglossary.888"></a><a href="#glo:glshypernumber"><code class="csfmt">\glshypernumber</code></a>). The default is to use marginal notes in TeX’s <span class="qt">“outer”</span> mode and inline annotations for <span class="qt">“inner”</span> or maths modes. This uses <a id="wrglossary.889"></a><a href="#glo:glsshowtargetinner"><code class="csfmt">\glsshowtargetinner</code></a> for inner and maths annotations and <a id="wrglossary.890"></a><a href="#glo:glsshowtargetouter"><code class="csfmt">\glsshowtargetouter</code></a> for the outer annotation.<p>
+If there are many targets within a single paragraph this can lead to <span class="qt">“too many floats”</span>, so <a id="wrglossary.891"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> provides a new package option <a id="wrglossary.892"></a><a href="#glo:opt.showtargets"><span class="styoptfmt">showtargets</span></a> that can be used to easily switch to inline annotations for outer mode (rather than having to redefine <a id="wrglossary.893"></a><a href="#glo:glsshowtargetouter"><code class="csfmt">\glsshowtargetouter</code></a>).<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.894"></a><code class="code"><dfn id="glo:opt.showtargets"><span class="styoptfmt">showtargets</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code></div><!-- end of settingsbox -->
+ Automatically implements <a id="wrglossary.895"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.896"></a><a href="#glo:optval.debug.showtargets"><span class="optfmt">showtargets</span></a> and adjusts the annotations according to the <span class="meta">〈<em class="metainner">value</em>〉</span>. The <a id="wrglossary.897"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides supplementary commands to support this option.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.898"></a><code class="code"><dfn id="glo:glsxtrshowtargetouter"><code class="csfmt">\glsxtrshowtargetouter</code></dfn>{<span class="meta">〈<em class="metainner">target-name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Formats annotations in outer mode. This is initially <a id="wrglossary.899"></a><a href="#glo:glsshowtargetouter"><code class="csfmt">\glsshowtargetouter</code></a> to match <a id="wrglossary.900"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.901"></a><a href="#glo:optval.debug.showtargets"><span class="optfmt">showtargets</span></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.902"></a><code class="code"><dfn id="glo:glsxtrshowtargetinner"><code class="csfmt">\glsxtrshowtargetinner</code></dfn>{<span class="meta">〈<em class="metainner">target-name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Formats annotations in inner mode. This is initially <a id="wrglossary.903"></a><a href="#glo:glsshowtargetinner"><code class="csfmt">\glsshowtargetinner</code></a> to match <a id="wrglossary.904"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.905"></a><a href="#glo:optval.debug.showtargets"><span class="optfmt">showtargets</span></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.906"></a><code class="code"><dfn id="glo:glsshowtargetinnersymleft"><code class="csfmt">\glsshowtargetinnersymleft</code></dfn>{name}</code></div><!-- end of pinnedbox -->
+ Shows the left annotation and marker. This uses the left symbol marker: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.907"></a><code class="code"><dfn id="glo:glsxtrshowtargetsymbolleft"><code class="csfmt">\glsxtrshowtargetsymbolleft</code></dfn></code></div><!-- end of pinnedbox -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.908"></a><code class="code"><dfn id="glo:glsshowtargetinnersymright"><code class="csfmt">\glsshowtargetinnersymright</code></dfn>{name}</code></div><!-- end of pinnedbox -->
+ Shows the right marker and annotation. This uses the right symbol marker: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.909"></a><code class="code"><dfn id="glo:glsxtrshowtargetsymbolright"><code class="csfmt">\glsxtrshowtargetsymbolright</code></dfn></code></div><!-- end of pinnedbox -->
+<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.910"></a><a id="wrglossary.911"></a><a href="#glo:opt.showtargets"><span class="styoptfmt">showtargets</span></a>=<code class="code"><dfn id="glo:optval.showtargets.left"><span class="optfmt">left</span></dfn></code></div><!-- end of optionvaluebox -->
+ A marker is placed to the left of the link/target and a marginal note is used in outer mode.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.912"></a><a id="wrglossary.913"></a><a href="#glo:opt.showtargets"><span class="styoptfmt">showtargets</span></a>=<code class="code"><dfn id="glo:optval.showtargets.right"><span class="optfmt">right</span></dfn></code></div><!-- end of optionvaluebox -->
+ A marker is placed to the right of the link/target and a marginal note is used in outer mode.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.914"></a><a id="wrglossary.915"></a><a href="#glo:opt.showtargets"><span class="styoptfmt">showtargets</span></a>=<code class="code"><dfn id="glo:optval.showtargets.innerleft"><span class="optfmt">innerleft</span></dfn></code></div><!-- end of optionvaluebox -->
+ A marker and annotation are placed to the left of the link/target in all modes.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.916"></a><a id="wrglossary.917"></a><a href="#glo:opt.showtargets"><span class="styoptfmt">showtargets</span></a>=<code class="code"><dfn id="glo:optval.showtargets.innerright"><span class="optfmt">innerright</span></dfn></code></div><!-- end of optionvaluebox -->
+ A marker and annotation are placed to the right of the link/target in all modes.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.918"></a><a id="wrglossary.919"></a><a href="#glo:opt.showtargets"><span class="styoptfmt">showtargets</span></a>=<code class="code"><dfn id="glo:optval.showtargets.annoteleft"><span class="optfmt">annoteleft</span></dfn></code></div><!-- end of optionvaluebox -->
+ Markers are placed on either side of the link/target with the annotation on the left in all modes.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.920"></a><a id="wrglossary.921"></a><a href="#glo:opt.showtargets"><span class="styoptfmt">showtargets</span></a>=<code class="code"><dfn id="glo:optval.showtargets.annoteright"><span class="optfmt">annoteright</span></dfn></code></div><!-- end of optionvaluebox -->
+ Markers are placed on either side of the link/target with the annotation on the right in all modes.<p>
+
+</section><!-- end of section sec:debuggingopts -->
+
+<section id="sec:newentry"><!-- start of section sec:newentry --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->3. Defining Entries<div class="labellink"><a href="#sec:newentry">[link]</a></div></h1><!-- end of chapter header -->
+<p>
+The base <a id="wrglossary.922"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package provides commands, such as <a id="wrglossary.923"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>, to define entries. The <a id="wrglossary.924"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides some additional commands, described in §<a href="#sec:newentrydefs">3.1</a>. For abbreviations, see §<a href="#sec:abbreviations">4</a>. If you use <a id="wrglossary.925"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, it will write command definitions within the <a id="wrglossary.926"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file. See the <a id="wrglossary.927"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for further information about those commands.<p>
+The <a id="wrglossary.928"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> user manual warns against using commands such as <a id="wrglossary.929"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> within <a id="wrglossary.930"></a><a href="#glo:dual.field">field</a> values. However, if you really need this, the <a id="wrglossary.931"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides <a id="wrglossary.932"></a><a href="#glo:glsxtrp"><code class="csfmt">\glsxtrp</code></a> (see §<a href="#sec:nested">5.4</a>). Alternatively, you may want to consider multi (compound) entries instead (see §<a href="#sec:multientries">7</a>).<p>
+
+</section><!-- end of section sec:newentry -->
+
+<section id="sec:newentrydefs"><!-- start of section sec:newentrydefs --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->3.1. Command Definitions<div class="labellink"><a href="#sec:newentrydefs">[link]</a></div></h2><!-- end of section header -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.933"></a><code class="code"><dfn id="glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">key=value list</em>〉</span>}{<span class="meta">〈<em class="metainner">description</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is provided by the base <a id="wrglossary.934"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package to cater for entries with descriptions that contain paragraph breaks. (The <span class="meta">〈<em class="metainner">key</em>〉</span>=<span class="meta">〈<em class="metainner">value</em>〉</span> interface doesn’t support paragraph breaks in the value.) The base package only provides an unstarred version of this command, which automatically inserts <a id="wrglossary.935"></a><a href="#glo:leavevmode"><code class="csfmt">\leavevmode</code></a><a id="wrglossary.936"></a><a href="#glo:unskip"><code class="csfmt">\unskip</code></a><a id="wrglossary.937"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a> at the end of the description. The <a id="wrglossary.938"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package replaces this with a single command: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.939"></a><code class="code"><dfn id="glo:glsxtrpostlongdescription"><code class="csfmt">\glsxtrpostlongdescription</code></dfn></code></div><!-- end of pinnedbox -->
+ which has the same effect, but can be redefined if required.<p>
+The <a id="wrglossary.940"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides a starred form: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.941"></a><code class="code"><dfn id="glo:longnewglossaryentry*"><code class="csfmt">\longnewglossaryentry*</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">key=value list</em>〉</span>}{<span class="meta">〈<em class="metainner">description</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This doesn’t insert the hook at the end of the description.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+For a general purpose post-description hook, see §<a href="#sec:postdeschooks">8.6.2</a>. </div><!-- end of information -->
+<p>
+Additionally, the <a id="wrglossary.942"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a> package option provides <a id="wrglossary.943"></a><a href="#glo:glsxtrnewsymbol"><code class="csfmt">\glsxtrnewsymbol</code></a>, and the <a id="wrglossary.944"></a><a href="#glo:opt.numbers"><span class="styoptfmt">numbers</span></a> package option provides <a id="wrglossary.945"></a><a href="#glo:glsxtrnewnumber"><code class="csfmt">\glsxtrnewnumber</code></a>. See §<a href="#sec:gloslistopts">2.1</a> for further details.<p>
+
+</section><!-- end of section sec:newentrydefs -->
+
+<section id="sec:newkeys"><!-- start of section sec:newkeys --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->3.2. Glossary Entry Keys<div class="labellink"><a href="#sec:newkeys">[link]</a></div></h2><!-- end of section header -->
+<p>
+ In addition to the <a id="wrglossary.946"></a><a href="#glo:idx.gloskey">glossary entry keys</a> provided by the base <a id="wrglossary.947"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package (summarised in §<a href="#sec:gloskeys">II</a>) the <a id="wrglossary.948"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides:<p>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.949"></a><code class="code"><dfn id="glo:opt.gloskey.category"><span class="csoptfmt">category</span></dfn>=<span class="meta">〈<em class="metainner">category-label</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>general</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ Assigns the <a id="wrglossary.950"></a><a href="#glo:idx.category">category</a> label. This should not contain any special or active characters as it’s used to form command names. See §<a href="#sec:categories">10</a> for further details.<p>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.951"></a><code class="code"><dfn id="glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></dfn>={<span class="meta">〈<em class="metainner">xr-list</em>〉</span>}</code></div><!-- end of settingsbox -->
+ This key is analogous to the <a id="wrglossary.952"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key but the tag is always given by <a id="wrglossary.953"></a><a href="#glo:seealsoname"><code class="csfmt">\seealsoname</code></a>. The value <span class="meta">〈<em class="metainner">xr-list</em>〉</span> should be a comma-separated list of entry labels. As with the <a id="wrglossary.954"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key, this key automatically indexes the cross-reference by default. The cross-reference will be displayed in the <a id="wrglossary.955"></a><a href="#glo:dual.locationlist">location list</a> using <a id="wrglossary.956"></a><a href="#glo:glsxtruseseealsoformat"><code class="csfmt">\glsxtruseseealsoformat</code></a> (see §<a href="#sec:xr">5.9</a>). Use <a id="wrglossary.957"></a><a href="#glo:opt.autoseeindex"><span class="styoptfmt">autoseeindex</span></a><span class="optfmt">=</span><a id="wrglossary.958"></a><a href="#glo:optval.autoseeindex.false"><span class="optfmt">false</span></a> to prevent the automatic <a id="wrglossary.959"></a><a href="#glo:dual.indexing">indexing</a>. (With <a id="wrglossary.960"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, adjust the <a id="wrglossary.961"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a> criteria.)<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+With just the base <a id="wrglossary.962"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, the <a id="wrglossary.963"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key simply performs this automated indexing. With <a id="wrglossary.964"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> the value is also saved. Similarly with the <a id="wrglossary.965"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> key. The value isn’t saved with explicit use of <a id="wrglossary.966"></a><a href="#glo:glsxtrindexseealso"><code class="csfmt">\glsxtrindexseealso</code></a> or <a id="wrglossary.967"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>. </div><!-- end of important -->
+<p>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.968"></a><code class="code"><dfn id="glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></dfn>={<span class="meta">〈<em class="metainner">xr-label</em>〉</span>}</code></div><!-- end of settingsbox -->
+ This is similar to the <a id="wrglossary.969"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key but the value can only be a single entry label. In addition to automatically <a id="wrglossary.970"></a><a href="#glo:dual.indexing">indexing</a> the cross-reference, this command will cause the entry with this key to have hyperlinks go to the aliased entry when referenced with commands like <a id="wrglossary.971"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. Whenever the entry is <a id="wrglossary.972"></a><a href="#glo:@@glslabel@indexing">indexed</a> with commands like <a id="wrglossary.973"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>, the <a id="wrglossary.974"></a><a href="#glo:dual.indexing">indexing</a> will be performed on the target entry (the <a id="wrglossary.975"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> value). See §<a href="#sec:xr">5.9</a> for further details.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Any entry that has a <a id="wrglossary.976"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a>, <a id="wrglossary.977"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> or <a id="wrglossary.978"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> key set will be added to the glossary by default when using <a id="wrglossary.979"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.980"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. If you don’t want this behaviour, use the <a id="wrglossary.981"></a><a href="#glo:opt.autoseeindex"><span class="styoptfmt">autoseeindex</span></a><span class="optfmt">=false</span> package option and implement a <a id="wrglossary.982"></a><a href="#glo:dual.postdeschook">post-description hook</a> to insert the cross-reference. Alternatively, consider switching to <a id="wrglossary.983"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. </div><!-- end of important -->
+<p>
+If you use <a id="wrglossary.984"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> (see §<a href="#sec:bib2gls">11</a>) then most of the <a id="wrglossary.985"></a><a href="#glo:idx.gloskey">glossary entry keys</a> can be used as analogous fields in the <a id="wrglossary.986"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file. For example, instead of writing the following code in your <a id="wrglossary.987"></a><a href="#glo:ext.tex"><span class="extfmt">tex</span></a> file: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.988"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{duck}{<a id="wrglossary.989"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
+ <a id="wrglossary.990"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird with webbed feet}</span>}
+<a id="wrglossary.991"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{svm}{SVM}{support vector machine}
+</pre> You would write the following in a <a id="wrglossary.992"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="code">@entry</code>{duck,
+ <a id="wrglossary.993"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
+ <a id="wrglossary.994"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird with webbed feet}</span>
+}
+<code class="code">@abbreviation</code>{svm,
+ <a id="wrglossary.995"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a><span class="optfmt">={SVM}</span>,
+ <a id="wrglossary.996"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a><span class="optfmt">={support vector machine}</span>,
+}
+</pre><p>
+There are, however, some keys that are considered <a id="wrglossary.997"></a><a href="#glo:@@glslabel@bib2glsinternalfield">internal fields</a> by <a id="wrglossary.998"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, in that they are defined as keys by <a id="wrglossary.999"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and may be assigned in the <a id="wrglossary.1000"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file that’s input by <a id="wrglossary.1001"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>, but they should not be used in the <a id="wrglossary.1002"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files.<p>
+For example, the <a id="wrglossary.1003"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key (which is recommended with <a id="wrglossary.1004"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> where the <a id="wrglossary.1005"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> contains symbols) should not be used in the <a id="wrglossary.1006"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file. Instead, use the <a id="wrglossary.1007"></a><a href="#glo:opt.resource.sort-field"><span class="csoptfmt">sort-field</span></a> resource option or the system of sort fallbacks to choose the most appropriate field to obtain the sort value (see <a href="https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-sorting">Gallery: Sorting</a>). The <a id="wrglossary.1008"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a> and <a id="wrglossary.1009"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a> keys are also considered <a id="wrglossary.1010"></a><a href="#glo:@@glslabel@bib2glsinternalfield">internal fields</a> and are only applicable with the <a id="wrglossary.1011"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+The <a id="wrglossary.1012"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a> and <a id="wrglossary.1013"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a> keys are defined by the <a id="wrglossary.1014"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.1015"></a><a href="#glo:optval.record.only"><span class="optfmt">only</span></a> and <a id="wrglossary.1016"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.1017"></a><a href="#glo:optval.record.nameref"><span class="optfmt">nameref</span></a> options and are only applicable with the <a id="wrglossary.1018"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>. </div><!-- end of information -->
+<p>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1019"></a><code class="code"><dfn id="glo:opt.gloskey.group"><span class="csoptfmt">group</span></dfn>={<span class="meta">〈<em class="metainner">group-label</em>〉</span>}</code></div><!-- end of settingsbox -->
+ This key is used by <a id="wrglossary.1020"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> within the <a id="wrglossary.1021"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file to set the <a id="wrglossary.1022"></a><a href="#glo:idx.group">group</a> label. This label is typically a by-product of the sorting method (see §<a href="#sec:glosgroups">8.6.4</a>). If it is explicitly set without reference to the order it can result in fragmented groups, see <a href="https://www.dickimaw-books.com/gallery/index.php?label=logicaldivisions">Gallery: Logical Glossary Divisions (type vs group vs parent)</a>. The group title can be set with <a id="wrglossary.1023"></a><a href="#glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></a>. You will need to invoke <a id="wrglossary.1024"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> with the <a id="wrglossary.1025"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> (or <a id="wrglossary.1026"></a><a href="#glo:switch.group"><span class="shortargfmt">-g</span></a>) switch to ensure that this key is set, when required.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Letter <a id="wrglossary.1027"></a><a href="#glo:idx.group">groups</a> are a consequence of sorting, not the other way around. </div><!-- end of important -->
+<p>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1028"></a><code class="code"><dfn id="glo:opt.gloskey.location"><span class="csoptfmt">location</span></dfn>={<span class="meta">〈<em class="metainner">location-list</em>〉</span>}</code></div><!-- end of settingsbox -->
+ Used by <a id="wrglossary.1029"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to store the formatted <a id="wrglossary.1030"></a><a href="#glo:dual.locationlist">location list</a>. The unformatted <a id="wrglossary.1031"></a><a href="#glo:@@glslabel@internalfield">internal location list</a> is stored in the <a id="wrglossary.1032"></a><a href="#glo:opt.glosfield.loclist"><span class="csoptfmt">loclist</span></a> field, as with <a id="wrglossary.1033"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>.<p>
+With the <a id="wrglossary.1034"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>, if the <a id="wrglossary.1035"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a> field isn’t set, then it will try the <a id="wrglossary.1036"></a><a href="#glo:opt.glosfield.loclist"><span class="csoptfmt">loclist</span></a> field instead, using the same method as <a id="wrglossary.1037"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a> to display the <a id="wrglossary.1038"></a><a href="#glo:@@glslabel@entrylocation">locations</a>. If you don’t want locations with <a id="wrglossary.1039"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, either use <a id="wrglossary.1040"></a><a href="#glo:opt.printgloss.nonumberlist"><span class="csoptfmt">nonumberlist</span></a> or use the <a id="wrglossary.1041"></a><a href="#glo:opt.resource.save-locations"><span class="csoptfmt">save-locations</span></a><span class="optfmt">=false</span> resource option.<p>
+The base <a id="wrglossary.1042"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package provides <a id="wrglossary.1043"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a> and <a id="wrglossary.1044"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a> to allow custom keys to be defined. The <a id="wrglossary.1045"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package additionally provides:<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1046"></a><code class="code"><dfn id="glo:glsxtrprovidestoragekey"><code class="csfmt">\glsxtrprovidestoragekey</code></dfn>{<span class="meta">〈<em class="metainner">key</em>〉</span>}{<span class="meta">〈<em class="metainner">default value</em>〉</span>}{<span class="meta">〈<em class="metainner">no link cs</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.1047"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a> but does nothing if the key has already been defined. As with <a id="wrglossary.1048"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>, the starred version switches on field expansion for the given key (provided that it hasn’t already been defined).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1049"></a><code class="code"><dfn id="glo:glsxtrifkeydefined"><code class="csfmt">\glsxtrifkeydefined</code></dfn>{<span class="meta">〈<em class="metainner">key</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Tests if the given key has been defined as a <a id="wrglossary.1050"></a><a href="#glo:idx.gloskey">glossary entry key</a>.<p>
+
+</section><!-- end of section sec:newkeys -->
+
+<section id="sec:plurals"><!-- start of section sec:plurals --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->3.3. Plurals<div class="labellink"><a href="#sec:plurals">[link]</a></div></h2><!-- end of section header -->
+<p>
+Some languages, such as English, have a general rule that plurals are formed from the singular with a suffix appended. This isn’t an absolute rule. There are plenty of exceptions (for example, geese, children, churches, elves, fairies, sheep). The <a id="wrglossary.1051"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package allows the <a id="wrglossary.1052"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> key to be optional when defining entries. In some cases a plural may not make any sense (for example, the term is a symbol) and in some cases the plural may be identical to the singular.<p>
+To make life easier for languages where the majority of plurals can simply be formed by appending a suffix to the singular, the <a id="wrglossary.1053"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package lets the <a id="wrglossary.1054"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> field default to the value of the <a id="wrglossary.1055"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field with <a id="wrglossary.1056"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a> appended. This command is defined to be just the letter <span class="qt">“s”</span>. This means that the majority of terms don’t need to have the <a id="wrglossary.1057"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> supplied as well, and you only need to use it for the exceptions.<p>
+For languages that don’t have this general rule, the <a id="wrglossary.1058"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> field will always need to be supplied, where needed.<p>
+There are other plural fields, such as <a id="wrglossary.1059"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a>, <a id="wrglossary.1060"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> and <a id="wrglossary.1061"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a>. Again, if you are using a language that doesn’t have a simple suffix rule, you’ll have to supply the plural forms if you need them (and if a plural makes sense in the context).<p>
+If these fields are omitted, the <a id="wrglossary.1062"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package follows these rules:
+<ul class="displaylist">
+ <li><span class="bulletitem">•</span>If <a id="wrglossary.1063"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> is missing, then <a id="wrglossary.1064"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a> is appended to the <a id="wrglossary.1065"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> field, if that field has been supplied. If the <a id="wrglossary.1066"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> field hasn’t been supplied but the <a id="wrglossary.1067"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> field has been supplied, then the <a id="wrglossary.1068"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> field defaults to the <a id="wrglossary.1069"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> field. If the <a id="wrglossary.1070"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> field hasn’t been supplied, then both the <a id="wrglossary.1071"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> and <a id="wrglossary.1072"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> fields default to the <a id="wrglossary.1073"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field (or <a id="wrglossary.1074"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, if no <a id="wrglossary.1075"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field) with <a id="wrglossary.1076"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a> appended.<p>
+<li><span class="bulletitem">•</span>If the <a id="wrglossary.1077"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> field is missing, then <a id="wrglossary.1078"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a> is appended to the <a id="wrglossary.1079"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> field, if the <a id="wrglossary.1080"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> field has been supplied.<p>
+<li><span class="bulletitem">•</span>If the <a id="wrglossary.1081"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> field is missing then, <span style="font-style: italic; font-variant: normal; ">with the base <a id="wrglossary.1082"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> acronym mechanism</span>, <a id="wrglossary.1083"></a><a href="#glo:acrpluralsuffix"><code class="csfmt">\acrpluralsuffix</code></a> is appended to the <a id="wrglossary.1084"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> field.<p>
+
+</ul>
+<p>
+The <span style="font-style: italic; font-variant: normal; ">last case is changed</span> with <a id="wrglossary.1085"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. With this extension package, the <a id="wrglossary.1086"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> field defaults to the <a id="wrglossary.1087"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> field with <a id="wrglossary.1088"></a><a href="#glo:abbrvpluralsuffix"><code class="csfmt">\abbrvpluralsuffix</code></a> appended unless overridden by category attributes. This suffix command is set by the abbreviation styles. This means that every time an abbreviation style is implemented, <a id="wrglossary.1089"></a><a href="#glo:abbrvpluralsuffix"><code class="csfmt">\abbrvpluralsuffix</code></a> is redefined, see §<a href="#sec:abbrvfieldslongshortpl">4.1.2</a> for further details.<p>
+
+</section><!-- end of section sec:plurals -->
+
+<section id="sec:alias"><!-- start of section sec:alias --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->3.4. Entry Aliases<div class="labellink"><a href="#sec:alias">[link]</a></div></h2><!-- end of section header -->
+<p>
+An entry can be made an alias of another entry using the <a id="wrglossary.1090"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> key. The value should be the label of the other term. There’s no check for the other’s existence when the aliased entry is defined. This is to allow the possibility of defining the other entry after the aliased entry. (For example, when used with <a id="wrglossary.1091"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1092"></a><code class="code"><dfn id="glo:glsxtraliashook"><code class="csfmt">\glsxtraliashook</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This hook is implemented when an entry is defined with the <a id="wrglossary.1093"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> key set. It does nothing by default. The value of the <a id="wrglossary.1094"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> field can be obtained with <code class="code"><a id="wrglossary.1095"></a><a href="#glo:glsxtralias"><code class="csfmt">\glsxtralias</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>.<p>
+If an entry <span class="meta">〈<em class="metainner">entry-1</em>〉</span> is made an alias of <span class="meta">〈<em class="metainner">entry-2</em>〉</span> then:
+<ul class="displaylist">
+ <li><span class="bulletitem">•</span>If the <a id="wrglossary.1096"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> field wasn’t provided when <span class="meta">〈<em class="metainner">entry-1</em>〉</span> was defined, the <a id="wrglossary.1097"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> key will automatically trigger <pre class="compactcodebox"><a id="wrglossary.1098"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>{<span class="meta">〈<em class="metainner">entry-1</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-2</em>〉</span>}
+</pre><p>
+<li><span class="bulletitem">•</span>If the <a id="wrglossary.1099"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> package has been loaded then <code class="code"><a id="wrglossary.1100"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{<span class="meta">〈<em class="metainner">entry-1</em>〉</span>}</code> will link to <span class="meta">〈<em class="metainner">entry-2</em>〉</span>’s target. (Unless the <a id="wrglossary.1101"></a><a href="#glo:opt.catattr.targeturl"><span class="csoptfmt">targeturl</span></a> attribute has been set for <span class="meta">〈<em class="metainner">entry-1</em>〉</span>’s category.)<p>
+<li><span class="bulletitem">•</span>With <a id="wrglossary.1102"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.1103"></a><a href="#glo:optval.record.off"><span class="optfmt">off</span></a> or <a id="wrglossary.1104"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.1105"></a><a href="#glo:optval.record.hybrid"><span class="optfmt">hybrid</span></a>, the <a id="wrglossary.1106"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a> setting will automatically be triggered when referencing <span class="meta">〈<em class="metainner">entry-1</em>〉</span> with commands like <a id="wrglossary.1107"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or <a id="wrglossary.1108"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>. This prevents <span class="meta">〈<em class="metainner">entry-1</em>〉</span> from having a <a id="wrglossary.1109"></a><a href="#glo:dual.locationlist">location list</a> (aside from the cross-reference added with <a id="wrglossary.1110"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>) unless it’s been explicitly indexed with <a id="wrglossary.1111"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> or if the indexing has been explicitly set using <a id="wrglossary.1112"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a><span class="optfmt">=false</span>. See §<a href="#sec:glssee">5.9.3</a> for adjusting the indexing hook.<p>
+Note that with <a id="wrglossary.1113"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.1114"></a><a href="#glo:optval.record.only"><span class="optfmt">only</span></a>, the <a id="wrglossary.1115"></a><a href="#glo:dual.locationlist">location list</a> for aliased entries is controlled with <a id="wrglossary.1116"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span>’s</a> settings.
+</ul>
+<p>
+The value of the <a id="wrglossary.1117"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> field can be accessed with <a id="wrglossary.1118"></a><a href="#glo:glsxtralias"><code class="csfmt">\glsxtralias</code></a> (see §<a href="#sec:getsee">5.9.2</a>).<p>
+
+</section><!-- end of section sec:alias -->
+
+<section id="sec:setfields"><!-- start of section sec:setfields --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->3.5. Setting or Updating Fields<div class="labellink"><a href="#sec:setfields">[link]</a></div></h2><!-- end of section header -->
+<p>
+See §<a href="#sec:getfields">5.11</a> for accessing field values and §<a href="#sec:fieldconditionals">5.15</a> for testing field values.<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+Modifications to fields only have an effect from that point onwards and may be localised to the current scope. If you are using <a id="wrglossary.1119"></a><a href="#glo:opt.docdef"><span class="styoptfmt">docdef</span></a><span class="optfmt">=</span><a id="wrglossary.1120"></a><a href="#glo:optval.docdef.true"><span class="optfmt">true</span></a>, any changes to the field values won’t be saved in the <a id="wrglossary.1121"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file. </div><!-- end of warning -->
+<p>
+Some of these commands are subtly different from each other. For example, <a id="wrglossary.1122"></a><a href="#glo:glsfielddef"><code class="csfmt">\glsfielddef</code></a> (provided by the base <a id="wrglossary.1123"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package), <a id="wrglossary.1124"></a><a href="#glo:glsxtrdeffield"><code class="csfmt">\glsxtrdeffield</code></a> and <a id="wrglossary.1125"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a> all assign a value to a field, but <a id="wrglossary.1126"></a><a href="#glo:glsfielddef"><code class="csfmt">\glsfielddef</code></a> requires that both the entry and the field exists (so it can’t be used to set an unknown <a id="wrglossary.1127"></a><a href="#glo:dual.internalfield">internal field</a>), <a id="wrglossary.1128"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a> requires that the entry exists (so it can be used to set an <a id="wrglossary.1129"></a><a href="#glo:dual.internalfield">internal field</a> that doesn’t have an associated key provided that the entry has been defined), and <a id="wrglossary.1130"></a><a href="#glo:glsxtrdeffield"><code class="csfmt">\glsxtrdeffield</code></a> doesn’t perform any existence checks (which means that it can be used to assign <a id="wrglossary.1131"></a><a href="#glo:dual.internalfield">internal fields</a> before the entry is actually defined).<p>
+The commands described in this section don’t require the <a id="wrglossary.1132"></a><a href="#glo:dual.field">field</a> to have an associated <a id="wrglossary.1133"></a><a href="#glo:idx.gloskey">glossary entry key</a>, so you need to be careful not to misspell the field labels.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+Assigning or changing fields using the commands described here won’t alter related fields. For example, if you use the <a id="wrglossary.1134"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> key but not the <a id="wrglossary.1135"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> key when you define an entry with <a id="wrglossary.1136"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>, the <a id="wrglossary.1137"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> key will automatically be set as well, but if you change the value of the <a id="wrglossary.1138"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field after the entry has been defined, the <a id="wrglossary.1139"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> field won’t be changed. Particular care is required if the field contributes in some way to the <a id="wrglossary.1140"></a><a href="#glo:dual.indexing">indexing</a> information, as this information is typically initialised when the entry is first defined. This includes the <a id="wrglossary.1141"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> and <a id="wrglossary.1142"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> keys, which should not be changed after the entry has been defined. </div><!-- end of information -->
+<p>
+With <a id="wrglossary.1143"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, entries aren’t defined on the first LaTeX run. This means that commands that test for existence will produce a warning and (within the <a id="wrglossary.1144"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment) the <a id="wrglossary.1145"></a><a href="#glo:idx.unknowntag"><code class="code">??</code></a> unknown marker. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.1146"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>]{glossaries-extra}
+<a id="wrglossary.1147"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.1148"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">=myentries</span>,<a id="wrglossary.1149"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">=all</span>]
+<code class="cbeg">\begin{document}</code>
+Defining info
+<a id="wrglossary.1150"></a><a href="#glo:glsxtrdeffield"><code class="csfmt">\glsxtrdeffield</code></a>{sample}{info}{some information}.
+Defining note
+<a id="wrglossary.1151"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>{sample}{note}{some note}.
+
+Info: <a id="wrglossary.1152"></a><a href="#glo:glsxtrusefield"><code class="csfmt">\glsxtrusefield</code></a>{sample}{info}.
+Note: <a id="wrglossary.1153"></a><a href="#glo:glsxtrusefield"><code class="csfmt">\glsxtrusefield</code></a>{sample}{note}.
+<code class="cend">\end{document}</code>
+</pre> On the first LaTeX run, this produces: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+Defining info . Defining note <a id="wrglossary.1154"></a><a href="#glo:idx.unknowntag">??</a>.<p>
+Info: some information. Note: . </div><!-- end of resultbox -->
+ At this point the <code class="code">sample</code> entry hasn’t been defined, so referencing it in <a id="wrglossary.1155"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a> results in a warning and the double question mark <a id="wrglossary.1156"></a><a href="#glo:idx.unknowntag"><code class="code">??</code></a> unknown marker in the text. The field (<code class="code">note</code>) isn’t saved, so nothing is shown when the field is referenced with <a id="wrglossary.1157"></a><a href="#glo:glsxtrusefield"><code class="csfmt">\glsxtrusefield</code></a>. Whereas <a id="wrglossary.1158"></a><a href="#glo:glsxtrdeffield"><code class="csfmt">\glsxtrdeffield</code></a> does save the field with the label <code class="code">info</code> associated with the label <code class="code">sample</code>, even though the <code class="code">sample</code> entry hasn’t actually been defined. The field can then be later obtained with <a id="wrglossary.1159"></a><a href="#glo:glsxtrusefield"><code class="csfmt">\glsxtrusefield</code></a>. Once <a id="wrglossary.1160"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> has been run, the <code class="code">sample</code> entry should now have its definition in the <a id="wrglossary.1161"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file, which is loaded by <a id="wrglossary.1162"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a> and the <code class="code">note</code> field can be set.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1163"></a><code class="code"><dfn id="glo:glsxtrdeffield"><code class="csfmt">\glsxtrdeffield</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.1164"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span></a>’s <a id="wrglossary.1165"></a><a href="#glo:csdef"><code class="csfmt">\csdef</code></a> command to locally set the <a id="wrglossary.1166"></a><a href="#glo:dual.field">field</a> given by its <a id="wrglossary.1167"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a> <span class="meta">〈<em class="metainner">field-label</em>〉</span> to <span class="meta">〈<em class="metainner">value</em>〉</span> for the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. No existence check is performed.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1168"></a><code class="code"><dfn id="glo:glsxtredeffield"><code class="csfmt">\glsxtredeffield</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.1169"></a><a href="#glo:glsxtrdeffield"><code class="csfmt">\glsxtrdeffield</code></a> but (protected) fully expands the value before assigning it to the field.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1170"></a><code class="code"><dfn id="glo:glsxtrapptocsvfield"><code class="csfmt">\glsxtrapptocsvfield</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">element</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is designed for fields that should contain comma-separated lists. If the field hasn’t been defined, this behaves like <a id="wrglossary.1171"></a><a href="#glo:glsxtrdeffield"><code class="csfmt">\glsxtrdeffield</code></a> otherwise it will append a comma followed by <span class="meta">〈<em class="metainner">element</em>〉</span> (unexpanded) to the field value. No existence check is performed. This field can be iterated over using <a id="wrglossary.1172"></a><a href="#glo:glsxtrforcsvfield"><code class="csfmt">\glsxtrforcsvfield</code></a> or formatted using <a id="wrglossary.1173"></a><a href="#glo:glsxtrfieldformatcsvlist"><code class="csfmt">\glsxtrfieldformatcsvlist</code></a>. See §<a href="#sec:csvfields">5.13</a> for further details.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1174"></a><code class="code"><dfn id="glo:glsxtrfieldlistadd"><code class="csfmt">\glsxtrfieldlistadd</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Appends the given value to the given entry’s field (identified using the <a id="wrglossary.1175"></a><a href="#glo:@@glslabel@internalfieldlabel">field’s internal label</a>) using <a id="wrglossary.1176"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <a id="wrglossary.1177"></a><a href="#glo:listcsadd"><code class="csfmt">\listcsadd</code></a>. The field value can later be iterated over using <a id="wrglossary.1178"></a><a href="#glo:glsxtrfielddolistloop"><code class="csfmt">\glsxtrfielddolistloop</code></a> or <a id="wrglossary.1179"></a><a href="#glo:glsxtrfieldforlistloop"><code class="csfmt">\glsxtrfieldforlistloop</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1180"></a><code class="code"><dfn id="glo:glsxtrfieldlistgadd"><code class="csfmt">\glsxtrfieldlistgadd</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but uses <a id="wrglossary.1181"></a><a href="#glo:listcsgadd"><code class="csfmt">\listcsgadd</code></a> to make a global change.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1182"></a><code class="code"><dfn id="glo:glsxtrfieldlisteadd"><code class="csfmt">\glsxtrfieldlisteadd</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but uses <a id="wrglossary.1183"></a><a href="#glo:listcseadd"><code class="csfmt">\listcseadd</code></a> to expand the value.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1184"></a><code class="code"><dfn id="glo:glsxtrfieldlistxadd"><code class="csfmt">\glsxtrfieldlistxadd</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but uses <a id="wrglossary.1185"></a><a href="#glo:listcsxadd"><code class="csfmt">\listcsxadd</code></a> to make a global change.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1186"></a><code class="code"><dfn id="glo:glsxtrsetfieldifexists"><code class="csfmt">\glsxtrsetfieldifexists</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">code</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is used by the commands <a id="wrglossary.1187"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>, <a id="wrglossary.1188"></a><a href="#glo:gGlsXtrSetField"><code class="csfmt">\gGlsXtrSetField</code></a>, <a id="wrglossary.1189"></a><a href="#glo:xGlsXtrSetField"><code class="csfmt">\xGlsXtrSetField</code></a>, <a id="wrglossary.1190"></a><a href="#glo:eGlsXtrSetField"><code class="csfmt">\eGlsXtrSetField</code></a>, <a id="wrglossary.1191"></a><a href="#glo:GlsXtrLetField"><code class="csfmt">\GlsXtrLetField</code></a>, <a id="wrglossary.1192"></a><a href="#glo:csGlsXtrLetField"><code class="csfmt">\csGlsXtrLetField</code></a> and <a id="wrglossary.1193"></a><a href="#glo:GlsXtrLetFieldToField"><code class="csfmt">\GlsXtrLetFieldToField</code></a> to produce an error (or warning with <a id="wrglossary.1194"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=</span><a id="wrglossary.1195"></a><a href="#glo:optval.undefaction.warn"><span class="optfmt">warn</span></a>) if the entry doesn’t exist. This can be redefined to add extra checks (for example, to prohibit changing certain fields).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1196"></a><code class="code"><dfn id="glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.1197"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span></a>’s <a id="wrglossary.1198"></a><a href="#glo:csdef"><code class="csfmt">\csdef</code></a> command to locally set the <a id="wrglossary.1199"></a><a href="#glo:dual.field">field</a> given by its <a id="wrglossary.1200"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a> <span class="meta">〈<em class="metainner">field-label</em>〉</span> to <span class="meta">〈<em class="metainner">value</em>〉</span> for the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>.<p>
+This command is written to the <a id="wrglossary.1201"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file by <a id="wrglossary.1202"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to set fields that don’t have a corresponding key.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1203"></a><code class="code"><dfn id="glo:gGlsXtrSetField"><code class="csfmt">\gGlsXtrSetField</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.1204"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a> but uses a global assignment.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1205"></a><code class="code"><dfn id="glo:eGlsXtrSetField"><code class="csfmt">\eGlsXtrSetField</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.1206"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a> but (protected) fully expands the value first.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1207"></a><code class="code"><dfn id="glo:xGlsXtrSetField"><code class="csfmt">\xGlsXtrSetField</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.1208"></a><a href="#glo:eGlsXtrSetField"><code class="csfmt">\eGlsXtrSetField</code></a> but uses a global assignment.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1209"></a><code class="code"><dfn id="glo:GlsXtrLetField"><code class="csfmt">\GlsXtrLetField</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.1210"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span></a>’s <a id="wrglossary.1211"></a><a href="#glo:cslet"><code class="csfmt">\cslet</code></a> command to locally set the <a id="wrglossary.1212"></a><a href="#glo:dual.field">field</a> given by its <a id="wrglossary.1213"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a> <span class="meta">〈<em class="metainner">field-label</em>〉</span> to <span class="meta">〈<em class="metainner">cs</em>〉</span> for the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1214"></a><code class="code"><dfn id="glo:csGlsXtrLetField"><code class="csfmt">\csGlsXtrLetField</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">cs-name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.1215"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span></a>’s <a id="wrglossary.1216"></a><a href="#glo:csletcs"><code class="csfmt">\csletcs</code></a> command to locally set the <a id="wrglossary.1217"></a><a href="#glo:dual.field">field</a> given by its <a id="wrglossary.1218"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a> <span class="meta">〈<em class="metainner">field-label</em>〉</span> to the control sequence given by <span class="meta">〈<em class="metainner">cs-name</em>〉</span> for the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1219"></a><code class="code"><dfn id="glo:GlsXtrLetFieldToField"><code class="csfmt">\GlsXtrLetFieldToField</code></dfn>{<span class="meta">〈<em class="metainner">entry1-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field1-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry2-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field2-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This assigns the field identified by its <a id="wrglossary.1220"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a> <span class="meta">〈<em class="metainner">field1-label</em>〉</span> for the entry identified by <span class="meta">〈<em class="metainner">entry1-label</em>〉</span> to the value of the <a id="wrglossary.1221"></a><a href="#glo:dual.field">field</a> identified by <span class="meta">〈<em class="metainner">field2-label</em>〉</span> for the entry identified by <span class="meta">〈<em class="metainner">entry2-label</em>〉</span><p>
+
+</section><!-- end of section sec:setfields -->
+
+<section id="sec:abbreviations"><!-- start of section sec:abbreviations --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->4. Abbreviations<div class="labellink"><a href="#sec:abbreviations">[link]</a></div></h1><!-- end of chapter header -->
+<p>
+The acronym mechanism implemented by the base <a id="wrglossary.1222"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package is insufficiently flexible for some documents. The <a id="wrglossary.1223"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides a completely different mechanism to deal with abbreviations in a more flexible manner. The two methods are incompatible. However, the <a id="wrglossary.1224"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides predefined styles that emulate the appearance of the styles provided by the base package. If you have previously used just the base <a id="wrglossary.1225"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, consult Table <a href="#tab:acrabbrvstyles">4.2</a> for the closest matching abbreviation style.<p>
+
+</section><!-- end of section sec:abbreviations -->
+
+<section id="sec:newabbr"><!-- start of section sec:newabbr --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->4.1. Defining Abbreviations<div class="labellink"><a href="#sec:newabbr">[link]</a></div></h2><!-- end of section header -->
+<p>
+Abbreviations are defined using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1226"></a><code class="code"><dfn id="glo:newabbreviation"><code class="csfmt">\newabbreviation</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">short</em>〉</span>}{<span class="meta">〈<em class="metainner">long</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">entry-label</em>〉</span> is the entry’s label (used in commands like <a id="wrglossary.1227"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>), <span class="meta">〈<em class="metainner">short</em>〉</span> is the short form (the abbreviation) and <span class="meta">〈<em class="metainner">long</em>〉</span> is the long form (what the abbreviation is short for). The optional argument <span class="meta">〈<em class="metainner">options</em>〉</span> may be used to set additional keys (as per the <a id="wrglossary.1228"></a><a href="#glo:@@glslabel@gloskey">options list</a> in <a id="wrglossary.1229"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>), such as <a id="wrglossary.1230"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> or <a id="wrglossary.1231"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a>.<p>
+This command internally uses <a id="wrglossary.1232"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> and sets the <a id="wrglossary.1233"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> to <a id="wrglossary.1234"></a><a href="#glo:glsxtrabbrvtype"><code class="csfmt">\glsxtrabbrvtype</code></a> and the <a id="wrglossary.1235"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> to <a id="wrglossary.1236"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a>. The category (see §<a href="#sec:categories">10</a>) determines the abbreviation style. The style for a particular category is set using <a id="wrglossary.1237"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>. If the optional argument is omitted, the <a id="wrglossary.1238"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a> category is assumed (see §<a href="#sec:abbrstyle">4.5</a> for further details).<p>
+The following example document sets up three different abbreviation styles: <a id="wrglossary.1239"></a><a href="#glo:opt.abbrstyle.long-short-sc"><span class="abbrstylefmt">long-short-sc</span></a> for the <a id="wrglossary.1240"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a> category, <a id="wrglossary.1241"></a><a href="#glo:opt.abbrstyle.long-only-short-only"><span class="abbrstylefmt">long-only-short-only</span></a> for the custom <code class="code">genus</code> category, and <a id="wrglossary.1242"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a> for the custom <code class="code">common</code> category. Note that the custom <code class="code">title</code> category doesn’t have an associated style. <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1243"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.1244"></a><a href="#glo:opt.abbrstyle.long-short-sc"><span class="abbrstylefmt">long-short-sc</span></a>}
+<a id="wrglossary.1245"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>[genus]{<a id="wrglossary.1246"></a><a href="#glo:opt.abbrstyle.long-only-short-only"><span class="abbrstylefmt">long-only-short-only</span></a>}
+<a id="wrglossary.1247"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>[common]{<a id="wrglossary.1248"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a>}
+<a id="wrglossary.1249"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{xml}{xml}{extensible markup language}
+<a id="wrglossary.1250"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.1251"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={genus}</span>]{clostridium}{C.}{Clostridium}
+<a id="wrglossary.1252"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.1253"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={genus}</span>]{myristica}{M.}{Myristica}
+<a id="wrglossary.1254"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.1255"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={common}</span>]{html}{HTML}{hypertext markup language}
+<a id="wrglossary.1256"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.1257"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={title}</span>]{dr}{Dr}{Doctor}
+<code class="cbeg">\begin{document}</code>
+First use: <a id="wrglossary.1258"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{xml}, <a id="wrglossary.1259"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{clostridium}, <a id="wrglossary.1260"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{myristica},
+<a id="wrglossary.1261"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}, <a id="wrglossary.1262"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{dr}.
+
+Next use: <a id="wrglossary.1263"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{xml}, <a id="wrglossary.1264"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{clostridium}, <a id="wrglossary.1265"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{myristica},
+<a id="wrglossary.1266"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}, <a id="wrglossary.1267"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{dr}.
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:multiabbrvstyles"></a>Example 1: Multiple abbreviation styles <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example001.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example001.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example001.png" type="image/png" width="388" height="42">Example document with multiple abbreviation styles.</object> </div><!-- end of resultbox -->
+<p>
+If the category doesn’t have an associated style, the style for the <a id="wrglossary.1268"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a> category will be used, as with the <code class="code">dr</code> entry above, which uses the <a id="wrglossary.1269"></a><a href="#glo:opt.abbrstyle.long-short-sc"><span class="abbrstylefmt">long-short-sc</span></a> style because no style has been associated with its custom <code class="code">title</code> category.<p>
+There are two categories that have an abbreviation style set by default: <a id="wrglossary.1270"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a> and <a id="wrglossary.1271"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a>. These are initialised as follows: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1272"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.1273"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a>}
+<a id="wrglossary.1274"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>[<a id="wrglossary.1275"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a>]{<a id="wrglossary.1276"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short</span></a>}
+</pre> This means that abbreviations defined with the default <a id="wrglossary.1277"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a> category will show the long form followed by the short form in parentheses on <a id="wrglossary.1278"></a><a href="#glo:dual.firstuse">first use</a>, and those defined with the <a id="wrglossary.1279"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> set to <a id="wrglossary.1280"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a> will only show the short form (that is, the long form won’t be shown on <a id="wrglossary.1281"></a><a href="#glo:dual.firstuse">first use</a>).<p>
+To make it easier to migrate a file containing entries defined with <a id="wrglossary.1282"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>, the <a id="wrglossary.1283"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package redefines <a id="wrglossary.1284"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> to do: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1285"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.1286"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a>=<a id="wrglossary.1287"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>,<a id="wrglossary.1288"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a>=<a id="wrglossary.1289"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a>,<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">short</em>〉</span>}{<span class="meta">〈<em class="metainner">long</em>〉</span>}
+</pre> Note that this sets the <a id="wrglossary.1290"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> to <a id="wrglossary.1291"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a>, which means that any abbreviations defined with <a id="wrglossary.1292"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> will use the <a id="wrglossary.1293"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short</span></a> style by default. If you want to use a different style, you need to set the abbreviation style for the <a id="wrglossary.1294"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a> category. For example, to use the <a id="wrglossary.1295"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> style: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1296"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>[<a id="wrglossary.1297"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a>]{<a id="wrglossary.1298"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a>}
+</pre> This must be placed before the first instance of <a id="wrglossary.1299"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+You can’t use <a id="wrglossary.1300"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a> with <a id="wrglossary.1301"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. </div><!-- end of information -->
+<p>
+If you have defined any acronym styles with <a id="wrglossary.1302"></a><a href="#glo:newacronymstyle"><code class="csfmt">\newacronymstyle</code></a>, you will have to migrate them over to <a id="wrglossary.1303"></a><a href="#glo:newabbreviationstyle"><code class="csfmt">\newabbreviationstyle</code></a>. However, most of the predefined abbreviation styles are flexible enough to adapt to common abbreviation formats. It is possible to revert <a id="wrglossary.1304"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> back to using the base <a id="wrglossary.1305"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s acronym mechanism (§<a href="#sec:acrorevert">4.6</a>), but it should generally not be necessary.<p>
+Terms defined with <a id="wrglossary.1306"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> (and <a id="wrglossary.1307"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>) can be referenced in the main document text using commands like <a id="wrglossary.1308"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. (If you want to use shortcut commands like <a id="wrglossary.1309"></a><a href="#glo:ac"><code class="csfmt">\ac</code></a>, use the <a id="wrglossary.1310"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.1311"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> package option.) Remember that you can use the <a id="wrglossary.1312"></a><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a> and <a id="wrglossary.1313"></a><a href="#glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></a> options to reset or unset the <a id="wrglossary.1314"></a><a href="#glo:dual.firstuseflag">first use flag</a> (see §<a href="#sec:glsunset">5.10</a>). Alternatively, you can use the commands described in §<a href="#sec:abbrvfieldrefs">4.3</a>. For headings and captions, see §<a href="#sec:headingcommands">5.3.2</a>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Avoid using <a id="wrglossary.1315"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a>, <a id="wrglossary.1316"></a><a href="#glo:glsfirstplural"><code class="csfmt">\glsfirstplural</code></a>, <a id="wrglossary.1317"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> and <a id="wrglossary.1318"></a><a href="#glo:glsplural"><code class="csfmt">\glsplural</code></a> with abbreviations. Many of the abbreviation styles are too complex to work with these commands (particularly the case-changing variants or with the <span class="meta">〈<em class="metainner">insert</em>〉</span> final optional argument or with <a id="wrglossary.1319"></a><a href="#glo:opt.glsopt.innertextformat"><span class="csoptfmt">innertextformat</span></a>). Instead, use commands like <a id="wrglossary.1320"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>, <a id="wrglossary.1321"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>, <a id="wrglossary.1322"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> and <a id="wrglossary.1323"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>. </div><!-- end of important -->
+<p>
+
+</section><!-- end of section sec:newabbr -->
+
+<section id="sec:abbrvfieldslongshort"><!-- start of section sec:abbrvfieldslongshort --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->4.1.1. Abbreviation Fields: <span class="optfmt">long</span> and <span class="optfmt">short</span><div class="labellink"><a href="#sec:abbrvfieldslongshort">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+The <span class="meta">〈<em class="metainner">short</em>〉</span> and <span class="meta">〈<em class="metainner">long</em>〉</span> arguments are internally assigned with the <a id="wrglossary.1324"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> and <a id="wrglossary.1325"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> keys (so don’t use those keys in <span class="meta">〈<em class="metainner">options</em>〉</span>), but the short and long values may first be modified by category attributes, such as <a id="wrglossary.1326"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a> or <a id="wrglossary.1327"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a>. As with other entries, avoid nested links (see §<a href="#sec:nested">5.4</a>). This means avoid using the <a id="wrglossary.1328"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.1329"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands within <span class="meta">〈<em class="metainner">short</em>〉</span> and <span class="meta">〈<em class="metainner">long</em>〉</span>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+If an abbreviation can be formed by combining other entries, consider using the multi (compound) entry function (see §<a href="#sec:multientries">7</a>). </div><!-- end of information -->
+<p>
+
+</section><!-- end of section sec:abbrvfieldslongshort -->
+
+<section id="sec:abbrvfieldslongshortpl"><!-- start of section sec:abbrvfieldslongshortpl --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->4.1.2. Abbreviation Fields: <span class="optfmt">longplural</span> and <span class="optfmt">shortplural</span><div class="labellink"><a href="#sec:abbrvfieldslongshortpl">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+The <a id="wrglossary.1330"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> key defaults to <span class="meta">〈<em class="metainner">long</em>〉</span><a id="wrglossary.1331"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a> and the <a id="wrglossary.1332"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> key defaults to <span class="meta">〈<em class="metainner">short</em>〉</span><a id="wrglossary.1333"></a><a href="#glo:abbrvpluralsuffix"><code class="csfmt">\abbrvpluralsuffix</code></a>. The <a id="wrglossary.1334"></a><a href="#glo:opt.catattr.aposplural"><span class="csoptfmt">aposplural</span></a> attribute will instead set the <a id="wrglossary.1335"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> to <code class="code"><span class="meta">〈<em class="metainner">short</em>〉</span>'<a id="wrglossary.1336"></a><a href="#glo:abbrvpluralsuffix"><code class="csfmt">\abbrvpluralsuffix</code></a></code> and the <a id="wrglossary.1337"></a><a href="#glo:opt.catattr.noshortplural"><span class="csoptfmt">noshortplural</span></a> attribute will set <a id="wrglossary.1338"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> to just <span class="meta">〈<em class="metainner">short</em>〉</span> (see §<a href="#sec:categories">10</a>). If these values are not appropriate, you will need to explicitly set the <a id="wrglossary.1339"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> and <a id="wrglossary.1340"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> keys in <span class="meta">〈<em class="metainner">options</em>〉</span>.<p>
+The short plural suffix <a id="wrglossary.1341"></a><a href="#glo:abbrvpluralsuffix"><code class="csfmt">\abbrvpluralsuffix</code></a> is redefined by the abbreviation style. Some styles, such as the <a id="wrglossary.1342"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> style, simply redefine <a id="wrglossary.1343"></a><a href="#glo:abbrvpluralsuffix"><code class="csfmt">\abbrvpluralsuffix</code></a> to just: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1344"></a><code class="code"><dfn id="glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ which is defined to <a id="wrglossary.1345"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a>.<p>
+Some styles, such as the <a id="wrglossary.1346"></a><a href="#glo:opt.abbrstyle.long-short-sc"><span class="abbrstylefmt">long-short-sc</span></a> style, redefine <a id="wrglossary.1347"></a><a href="#glo:abbrvpluralsuffix"><code class="csfmt">\abbrvpluralsuffix</code></a> to include code to counteract the formatting of the abbreviation.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+If you want to change the default short plural suffix, you need to redefine <a id="wrglossary.1348"></a><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a> not <a id="wrglossary.1349"></a><a href="#glo:abbrvpluralsuffix"><code class="csfmt">\abbrvpluralsuffix</code></a>. If you don’t want the suffix added, then set the <a id="wrglossary.1350"></a><a href="#glo:opt.catattr.noshortplural"><span class="csoptfmt">noshortplural</span></a> attribute to <code class="code">true</code>. </div><!-- end of information -->
+<p>
+
+</section><!-- end of section sec:abbrvfieldslongshortpl -->
+
+<section id="sec:abbrvfieldsnamedesc"><!-- start of section sec:abbrvfieldsnamedesc --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->4.1.3. Abbreviation Fields: <span class="optfmt">name</span> and <span class="optfmt">description</span><div class="labellink"><a href="#sec:abbrvfieldsnamedesc">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+The <a id="wrglossary.1351"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key is set according to the abbreviation style. There should not be any need to explicitly set it. Some styles require the <a id="wrglossary.1352"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> key to be set in <span class="meta">〈<em class="metainner">options</em>〉</span>, but other styles will set the <a id="wrglossary.1353"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> to the long form.<p>
+
+</section><!-- end of section sec:abbrvfieldsnamedesc -->
+
+<section id="sec:abbrvfieldstype"><!-- start of section sec:abbrvfieldstype --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->4.1.4. Abbreviation Fields: <span class="optfmt">type</span><div class="labellink"><a href="#sec:abbrvfieldstype">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+Abbreviations can be assigned to a particular <a id="wrglossary.1354"></a><a href="#glo:dual.glossary">glossary</a> using the <a id="wrglossary.1355"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> key in <span class="meta">〈<em class="metainner">options</em>〉</span>. The default for <a id="wrglossary.1356"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> is: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1357"></a><code class="code"><dfn id="glo:glsxtrabbrvtype"><code class="csfmt">\glsxtrabbrvtype</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This is initialised to <a id="wrglossary.1358"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a> (the default glossary), but the <a id="wrglossary.1359"></a><a href="#glo:opt.abbreviations"><span class="styoptfmt">abbreviations</span></a> package option will redefine it to <code class="code">abbreviations</code>.<p>
+The default <a id="wrglossary.1360"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> for <a id="wrglossary.1361"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> is: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1362"></a><code class="code"><dfn id="glo:acronymtype"><code class="csfmt">\acronymtype</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This is initialised to <a id="wrglossary.1363"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>, but the <a id="wrglossary.1364"></a><a href="#glo:opt.acronyms"><span class="styoptfmt">acronyms</span></a> package option will redefine it to <code class="code">acronym</code>.<p>
+
+</section><!-- end of section sec:abbrvfieldstype -->
+
+<section id="sec:abbrvgeneralhooks"><!-- start of section sec:abbrvgeneralhooks --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->4.1.5. General Hooks<div class="labellink"><a href="#sec:abbrvgeneralhooks">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+The following are general purpose hooks used within <a id="wrglossary.1365"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>. Note that there are additional hooks that are used by the abbreviation styles (see §<a href="#sec:abbrstyleinit">4.5.3.1</a>).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1366"></a><code class="code"><dfn id="glo:glsxtrnewabbrevpresetkeyhook"><code class="csfmt">\glsxtrnewabbrevpresetkeyhook</code></dfn>{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">short</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This hook is provided for further customisation, if required. It’s implemented before the entry is defined (before the <a id="wrglossary.1367"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> and <a id="wrglossary.1368"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> keys supplied in <span class="meta">〈<em class="metainner">options</em>〉</span> are parsed). Does nothing by default. The arguments are a legacy throwback to old versions that didn’t have <a id="wrglossary.1369"></a><a href="#glo:glsxtrorgshort"><code class="csfmt">\glsxtrorgshort</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1370"></a><code class="code"><dfn id="glo:newabbreviationhook"><code class="csfmt">\newabbreviationhook</code></dfn></code></div><!-- end of pinnedbox -->
+ This hook is performed just before the entry is defined. Does nothing by default.<p>
+
+</section><!-- end of section sec:abbrvgeneralhooks -->
+
+<section id="sec:abbrvmakeindexvsbib2gls"><!-- start of section sec:abbrvmakeindexvsbib2gls --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->4.2. Examples: <span class="appfmt">makeindex</span> vs <span class="appfmt">bib2gls</span><div class="labellink"><a href="#sec:abbrvmakeindexvsbib2gls">[link]</a></div></h2><!-- end of section header -->
+<p>
+Example document using <a id="wrglossary.1371"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+<a id="wrglossary.1372"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.1373"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.1374"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.1375"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+<a id="wrglossary.1376"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{xml}{XML}{extensible markup language}
+<a id="wrglossary.1377"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{nasa}{NASA}{National Aeronautics and Space Administration}
+<code class="cbeg">\begin{document}</code>
+First use: <a id="wrglossary.1378"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}, <a id="wrglossary.1379"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{xml} and <a id="wrglossary.1380"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{nasa}.
+Next use: <a id="wrglossary.1381"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}, <a id="wrglossary.1382"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{xml} and <a id="wrglossary.1383"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{nasa}.
+<a id="wrglossary.1384"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="example.2"></a>Example 2: <code class="cmd">\newabbreviation</code> vs <code class="cmd">\newacronym</code> vs <code class="cmd">\newglossaryentry</code> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example002.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example002.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example002.png" type="image/png" width="388" height="152">Example document illustrating the difference between <code class="cmd">\newabbreviation</code>, <code class="cmd">\newacronym</code> and <code class="cmd">\newglossaryentry</code>.</object> </div><!-- end of resultbox -->
+ Note that the long form of NASA isn’t displayed on the <a id="wrglossary.1385"></a><a href="#glo:dual.firstuse">first use</a> of <code class="code"><a id="wrglossary.1386"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{nasa}</code>. This is because the <a id="wrglossary.1387"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a> category uses the <a id="wrglossary.1388"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short</span></a> style by default.<p>
+In the above example, all entries are placed in the main (default) glossary. The package options <a id="wrglossary.1389"></a><a href="#glo:opt.abbreviations"><span class="styoptfmt">abbreviations</span></a> and <a id="wrglossary.1390"></a><a href="#glo:opt.acronyms"><span class="styoptfmt">acronyms</span></a> can be used to split them off into separate glossaries.<p>
+If you use <a id="wrglossary.1391"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the analogous <a id="wrglossary.1392"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> entry types are <code class="code">@abbreviation</code> and <code class="code">@acronym</code>. The above example can be rewritten to use <a id="wrglossary.1393"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cbeg">\begin{filecontents*}</code>{<a id="wrglossary.1394"></a><a href="#glo:jobname"><code class="csfmt">\jobname</code></a>.bib}
+<code class="code">@entry</code>{sample,
+ <a id="wrglossary.1395"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,
+ <a id="wrglossary.1396"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>
+}
+<code class="code">@abbreviation</code>{xml,
+ <a id="wrglossary.1397"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a><span class="optfmt">={XML}</span>,
+ <a id="wrglossary.1398"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a><span class="optfmt">={extensible markup language}</span>
+}
+<code class="code">@acronym</code>{nasa,
+ <a id="wrglossary.1399"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a><span class="optfmt">={NASA}</span>,
+ <a id="wrglossary.1400"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a><span class="optfmt">={National Aeronautics and Space Administration}</span>
+}
+<code class="cend">\end{filecontents*}</code>
+<code class="cmd">\usepackage</code>[<a id="wrglossary.1401"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>]{glossaries-extra}
+<a id="wrglossary.1402"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>
+<code class="cbeg">\begin{document}</code>
+First use: <a id="wrglossary.1403"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}, <a id="wrglossary.1404"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{xml} and <a id="wrglossary.1405"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{nasa}.
+Next use: <a id="wrglossary.1406"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}, <a id="wrglossary.1407"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{xml} and <a id="wrglossary.1408"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{nasa}.
+<a id="wrglossary.1409"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="example.3"></a>Example 3: <code class="code">@abbreviation</code> vs <code class="code">@acronym</code> vs <code class="code">@entry</code> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example003.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example003.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example003.png" type="image/png" width="388" height="142">Example document illustrating the difference between <code class="code">@abbreviation</code>, <code class="code">@acronym</code> and <code class="code">@entry</code>.</object> </div><!-- end of resultbox -->
+<p>
+
+</section><!-- end of section sec:abbrvmakeindexvsbib2gls -->
+
+<section id="sec:abbrvfieldrefs"><!-- start of section sec:abbrvfieldrefs --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->4.3. Referencing (Using) Abbreviations<div class="labellink"><a href="#sec:abbrvfieldrefs">[link]</a></div></h2><!-- end of section header -->
+<p>
+Since <a id="wrglossary.1410"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> internally uses <a id="wrglossary.1411"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>, you can reference abbreviations with the <a id="wrglossary.1412"></a><a href="#glo:glslike"><code class="csfmt">\gls</code>-like</a> commands as with other entries. Remember that you can use the <a id="wrglossary.1413"></a><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a> and <a id="wrglossary.1414"></a><a href="#glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></a> options to reset or unset the <a id="wrglossary.1415"></a><a href="#glo:dual.firstuseflag">first use flag</a> (see §<a href="#sec:glsunset">5.10</a>).<p>
+In general it’s best not to use <a id="wrglossary.1416"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a>, <a id="wrglossary.1417"></a><a href="#glo:glsfirstplural"><code class="csfmt">\glsfirstplural</code></a>, <a id="wrglossary.1418"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>, <a id="wrglossary.1419"></a><a href="#glo:glsplural"><code class="csfmt">\glsplural</code></a> or their case-changing variants as many of the abbreviation styles are too complicated for those commands. If you specifically want the full form, use <a id="wrglossary.1420"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> with <a id="wrglossary.1421"></a><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a> or use <a id="wrglossary.1422"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>. If you specifically want the short form for a particular instance, use <a id="wrglossary.1423"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> with <a id="wrglossary.1424"></a><a href="#glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></a> or use <a id="wrglossary.1425"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>. If you only want the long form for a particular instance, use <a id="wrglossary.1426"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a>.<p>
+If you never want the short form with <a id="wrglossary.1427"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>, use one of the <span class="qt">“noshort”</span> styles, such as <a id="wrglossary.1428"></a><a href="#glo:opt.abbrstyle.long-noshort"><span class="abbrstylefmt">long-noshort</span></a>. If you never want the long form with <a id="wrglossary.1429"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>, use one of the <span class="qt">“nolong”</span> styles, such as <a id="wrglossary.1430"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+If you need to use abbreviations in headings or captions, use commands like <a id="wrglossary.1431"></a><a href="#glo:glsfmtshort"><code class="csfmt">\glsfmtshort</code></a> and <a id="wrglossary.1432"></a><a href="#glo:glsfmtlong"><code class="csfmt">\glsfmtlong</code></a> (see §<a href="#sec:headingcommands">5.3.2</a>). Commands like <a id="wrglossary.1433"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a> are likely to contain non-expandable content. </div><!-- end of information -->
+<p>
+Example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+<a id="wrglossary.1434"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.1435"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{svm}{SVM}{support vector machine}
+<a id="wrglossary.1436"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{html}{HTML}{hypertext markup language}
+
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.1437"></a><a href="#glo:tableofcontents"><code class="csfmt">\tableofcontents</code></a>
+<code class="cmd">\section</code>{Introducing the <a id="wrglossary.1438"></a><a href="#glo:glsfmtlong"><code class="csfmt">\glsfmtlong</code></a>{svm}}
+First use: <a id="wrglossary.1439"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{svm}.
+Next use: <a id="wrglossary.1440"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{svm}.
+
+<code class="cmd">\section</code>{Introducing <a id="wrglossary.1441"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html} (incorrect)}
+First use (not!): <a id="wrglossary.1442"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+Next use: <a id="wrglossary.1443"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+
+<a id="wrglossary.1444"></a><a href="#glo:glsreset"><code class="csfmt">\glsreset</code></a>{html}
+<code class="cmd">\section</code>{Introducing <a id="wrglossary.1445"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>{html} (incorrect)}
+First use: <a id="wrglossary.1446"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+Next use: <a id="wrglossary.1447"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+
+<a id="wrglossary.1448"></a><a href="#glo:glsreset"><code class="csfmt">\glsreset</code></a>{html}
+<code class="cmd">\section</code>{Introducing <a id="wrglossary.1449"></a><a href="#glo:glsfmtshort"><code class="csfmt">\glsfmtshort</code></a>{html}}
+First use: <a id="wrglossary.1450"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+Next use: <a id="wrglossary.1451"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+
+<a id="wrglossary.1452"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrhyper"></a>Example 4: Referencing an abbreviation (with <span class="styfmt">hyperref</span>) <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example004.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example004.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example004.png" type="image/png" width="389" height="507">Example document illustrating referencing an abbreviation (with hyperref).</object> </div><!-- end of resultbox -->
+ In the above example, compare the first section heading (which references an abbreviation with <a id="wrglossary.1453"></a><a href="#glo:glsfmtlong"><code class="csfmt">\glsfmtlong</code></a>) with the second section heading (which references an abbreviation with <a id="wrglossary.1454"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>). Note that the <a id="wrglossary.1455"></a><a href="#glo:dual.firstuse">first use</a> of the <code class="code">html</code> entry actually occurs in the table of contents, which results in the full form showing in the table of contents, but only the abbreviation is shown in the actual section 2 heading. The PDF bookmark shows the entry label (<code class="code">html</code>) not the abbreviation (HTML). There is also a nested link for section 2 in the table of contents. In some PDF viewers (such as Okular), this will lead to section 2 but, in others (such as Evince), it will lead to the HTML entry target in the glossary. Similarly for section 3.<p>
+As with the base <a id="wrglossary.1456"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, the unformatted short and long forms can be obtained with <a id="wrglossary.1457"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a> and <a id="wrglossary.1458"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a> or, for the plural forms, <a id="wrglossary.1459"></a><a href="#glo:glsentryshortpl"><code class="csfmt">\glsentryshortpl</code></a> and <a id="wrglossary.1460"></a><a href="#glo:glsentrylongpl"><code class="csfmt">\glsentrylongpl</code></a>. These are analogous to commands like <a id="wrglossary.1461"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a> and may be used in expandable contexts. The sentence case versions (<a id="wrglossary.1462"></a><a href="#glo:Glsentryshort"><code class="csfmt">\Glsentryshort</code></a>, <a id="wrglossary.1463"></a><a href="#glo:Glsentrylong"><code class="csfmt">\Glsentrylong</code></a>, <a id="wrglossary.1464"></a><a href="#glo:Glsentryshort"><code class="csfmt">\Glsentryshort</code></a>, and <a id="wrglossary.1465"></a><a href="#glo:Glsentrylong"><code class="csfmt">\Glsentrylong</code></a>) are all robust in <a id="wrglossary.1466"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.49 and lower. As from <a id="wrglossary.1467"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50, they can expand in PDF bookmarks, but outside of PDF bookmarks they will expand to a robust internal command.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Don’t use the base <a id="wrglossary.1468"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s acronym commands, such as <a id="wrglossary.1469"></a><a href="#glo:acrshort"><code class="csfmt">\acrshort</code></a>. These aren’t compatible with <a id="wrglossary.1470"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>. </div><!-- end of important -->
+<p>
+Each abbreviation style has a <a id="wrglossary.1471"></a><a href="#glo:dual.displayfullform">display full form</a>, which is the format produced with the <a id="wrglossary.1472"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.1473"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>, and an <a id="wrglossary.1474"></a><a href="#glo:dual.inlinefullform">inline full form</a>, which is the format produced by <a id="wrglossary.1475"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>. For some styles, such as <a id="wrglossary.1476"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a>, the <a id="wrglossary.1477"></a><a href="#glo:@@glslabel@displayfullform">display</a> and <a id="wrglossary.1478"></a><a href="#glo:@@glslabel@inlinefullform">inline</a> forms are identical. <p>
+The example below demonstrates the difference between the <a id="wrglossary.1479"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.1480"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> compared with the <a id="wrglossary.1481"></a><a href="#glo:dual.inlinefullform">inline full form</a> for the <a id="wrglossary.1482"></a><a href="#glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">footnote</span></a> abbreviation style. The example also uses <a id="wrglossary.1483"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a> to demonstrate that it produces an undesirable result with the selected abbreviation style. <div style="text-align: center; border-style: none; "><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
+<p>
+<pre class="sidebysidecode">
+<a id="wrglossary.1484"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{footnote}
+<a id="wrglossary.1485"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{nasa}{NASA}{National Aeronautics and Space
+Administration}
+
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.1486"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{nasa}['s] space
+exploration<code class="cmd">\ldots</code>
+
+<a id="wrglossary.1487"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{nasa}['s] space
+exploration<code class="cmd">\ldots</code>
+
+<a id="wrglossary.1488"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a>{nasa}['s] space
+exploration<code class="cmd">\ldots</code>
+<code class="cend">\end{document}</code>
+</pre><div class="sidebysideresult"><a id="ex:glsVSfullVSfirst"></a>Example 5: First use of <code class="cmd">\gls</code> vs <code class="cmd">\glsxtrfull</code> vs <code class="cmd">\glsfirst</code> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example005.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example005.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example005.png" type="image/png" width="468" height="544">Example document illustrating the difference between the first use of <code class="cmd">\gls</code> compared with <code class="cmd">\glsxtrfull</code> and <code class="cmd">\glsfirst</code>.</object> </div><p>
+ In the above, the <a id="wrglossary.1489"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.1490"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> puts the long form in the footnote but correctly inserts the final optional argument before the footnote marker. The <a id="wrglossary.1491"></a><a href="#glo:dual.inlinefullform">inline full form</a> (obtained with <a id="wrglossary.1492"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>) doesn’t use a footnote, but instead shows the long form in parentheses after the short form. The insert material is correctly placed after the short form. Compare this with the final line, which uses <a id="wrglossary.1493"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a>. This shows the long form in the footnote, but the inserted material can’t be shifted before the footnote marker, which results in the strange <span class="qt">“NASA²’s”</span>.<p>
+The following commands are included in the set of <a id="wrglossary.1494"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands. They have the <a id="wrglossary.1495"></a><a href="#glo:@@glslabel@glsopt">same options</a> as <a id="wrglossary.1496"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> and don’t change the <a id="wrglossary.1497"></a><a href="#glo:dual.firstuseflag">first use flag</a>. They will index (unless <a id="wrglossary.1498"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a> is used), create a hyperlink (if enabled), and use the <a id="wrglossary.1499"></a><a href="#glo:dual.postlinkhook">post-link hook</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1500"></a><code class="code"><dfn id="glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1501"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1502"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1503"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Displays the short form using the abbreviation style’s formatting.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1504"></a><code class="code"><dfn id="glo:Glsxtrshort"><code class="csfmt">\Glsxtrshort</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1505"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1506"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1507"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.1508"></a><a href="#glo:idx.sentencecase">sentence case</a> version.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1509"></a><code class="code"><dfn id="glo:GLSxtrshort"><code class="csfmt">\GLSxtrshort</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1510"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1511"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1512"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.1513"></a><a href="#glo:idx.allcaps">all caps</a> version.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1514"></a><code class="code"><dfn id="glo:glsxtrshortpl"><code class="csfmt">\glsxtrshortpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1515"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1516"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1517"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Displays the short plural form using the abbreviation style’s formatting.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1518"></a><code class="code"><dfn id="glo:Glsxtrshortpl"><code class="csfmt">\Glsxtrshortpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1519"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1520"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1521"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.1522"></a><a href="#glo:idx.sentencecase">sentence case</a> version.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1523"></a><code class="code"><dfn id="glo:GLSxtrshortpl"><code class="csfmt">\GLSxtrshortpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1524"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1525"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1526"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.1527"></a><a href="#glo:idx.allcaps">all caps</a> version.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1528"></a><code class="code"><dfn id="glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1529"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1530"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1531"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Displays the long form using the abbreviation style’s formatting. As from v1.49, this command simulates <a id="wrglossary.1532"></a><a href="#glo:dual.firstuse">first use</a> by defining <a id="wrglossary.1533"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a> to do its first argument. This is done via the command: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1534"></a><code class="code"><dfn id="glo:glsxtrsetlongfirstuse"><code class="csfmt">\glsxtrsetlongfirstuse</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which is defined as: <pre class="compactcodebox"><code class="cmd">\newcommand</code>{<a id="wrglossary.1535"></a><a href="#glo:glsxtrsetlongfirstuse"><code class="csfmt">\glsxtrsetlongfirstuse</code></a>}[1]{<span class="comment">% </span>
+ <code class="cmd">\let</code><a id="wrglossary.1536"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a><a id="wrglossary.1537"></a><a href="#glo:@firstoftwo"><code class="csfmt">\@firstoftwo</code></a><span class="comment">% </span>
+}
+</pre> This command takes the entry label as the argument, which is ignored by default.<p>
+To restore the original behaviour, redefine this command as follows: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.1538"></a><a href="#glo:glsxtrsetlongfirstuse"><code class="csfmt">\glsxtrsetlongfirstuse</code></a>}[1]{<span class="comment">% </span>
+ <code class="cmd">\letcs</code><a id="wrglossary.1539"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a>{@secondoftwo}<span class="comment">% </span>
+}
+</pre> This command is also used by the case-changing and plural variants listed below.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1540"></a><code class="code"><dfn id="glo:Glsxtrlong"><code class="csfmt">\Glsxtrlong</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1541"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1542"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1543"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.1544"></a><a href="#glo:idx.sentencecase">sentence case</a> version.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1545"></a><code class="code"><dfn id="glo:GLSxtrlong"><code class="csfmt">\GLSxtrlong</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1546"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1547"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1548"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.1549"></a><a href="#glo:idx.allcaps">all caps</a> version.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1550"></a><code class="code"><dfn id="glo:glsxtrlongpl"><code class="csfmt">\glsxtrlongpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1551"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1552"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1553"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Displays the long plural form using the abbreviation style’s formatting.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1554"></a><code class="code"><dfn id="glo:Glsxtrlongpl"><code class="csfmt">\Glsxtrlongpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1555"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1556"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1557"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.1558"></a><a href="#glo:idx.sentencecase">sentence case</a> version.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1559"></a><code class="code"><dfn id="glo:GLSxtrlongpl"><code class="csfmt">\GLSxtrlongpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1560"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1561"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1562"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.1563"></a><a href="#glo:idx.allcaps">all caps</a> version.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1564"></a><code class="code"><dfn id="glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1565"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1566"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1567"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Displays the <a id="wrglossary.1568"></a><a href="#glo:dual.inlinefullform">inline full form</a> using the abbreviation style’s formatting. Depending on the style, this may not be the same as the text produced with the <a id="wrglossary.1569"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.1570"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1571"></a><code class="code"><dfn id="glo:Glsxtrfull"><code class="csfmt">\Glsxtrfull</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1572"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1573"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1574"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.1575"></a><a href="#glo:idx.sentencecase">sentence case</a> version.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1576"></a><code class="code"><dfn id="glo:GLSxtrfull"><code class="csfmt">\GLSxtrfull</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1577"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1578"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1579"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.1580"></a><a href="#glo:idx.allcaps">all caps</a> version.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1581"></a><code class="code"><dfn id="glo:glsxtrfullpl"><code class="csfmt">\glsxtrfullpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1582"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1583"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1584"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Displays the <a id="wrglossary.1585"></a><a href="#glo:@@glslabel@inlinefullform">inline full plural form</a> using the abbreviation style’s formatting. Depending on the style, this may not be the same as the text produced with the <a id="wrglossary.1586"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.1587"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1588"></a><code class="code"><dfn id="glo:Glsxtrfullpl"><code class="csfmt">\Glsxtrfullpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1589"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1590"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1591"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.1592"></a><a href="#glo:idx.sentencecase">sentence case</a> version.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1593"></a><code class="code"><dfn id="glo:GLSxtrfullpl"><code class="csfmt">\GLSxtrfullpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1594"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1595"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1596"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.1597"></a><a href="#glo:idx.allcaps">all caps</a> version.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1598"></a><code class="code"><dfn id="glo:glsxtrsetupfulldefs"><code class="csfmt">\glsxtrsetupfulldefs</code></dfn></code></div><!-- end of pinnedbox -->
+ This hook is used within <a id="wrglossary.1599"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>, <a id="wrglossary.1600"></a><a href="#glo:glsxtrfullpl"><code class="csfmt">\glsxtrfullpl</code></a> and the case-changing variations to initialise <a id="wrglossary.1601"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a> in case it’s required in the <a id="wrglossary.1602"></a><a href="#glo:dual.postlinkhook">post-link hook</a>. The default definition is to simulate <a id="wrglossary.1603"></a><a href="#glo:dual.firstuse">first use</a>. Note that changing this can cause unexpected results with abbreviation styles that set the <a id="wrglossary.1604"></a><a href="#glo:dual.postlinkhook">post-link hook</a>, such as <a id="wrglossary.1605"></a><a href="#glo:opt.abbrstyle.short-postlong-user"><span class="abbrstylefmt">short-postlong-user</span></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1606"></a><code class="code"><dfn id="glo:glsxtrfullsaveinsert"><code class="csfmt">\glsxtrfullsaveinsert</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This hook is used within <a id="wrglossary.1607"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>, <a id="wrglossary.1608"></a><a href="#glo:glsxtrfullpl"><code class="csfmt">\glsxtrfullpl</code></a> and the case-changing variations to initialise the <a id="wrglossary.1609"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a> placeholder. The default definition is to use <a id="wrglossary.1610"></a><a href="#glo:glsxtrsaveinsert"><code class="csfmt">\glsxtrsaveinsert</code></a>. If the insert isn’t saved, it can’t be used within the <a id="wrglossary.1611"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the <a id="wrglossary.1612"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> etc. This affects the behaviour of the <span class="qt">“post-hyphen”</span> abbreviation styles, such as <a id="wrglossary.1613"></a><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen"><span class="abbrstylefmt">long-hyphen-postshort-hyphen</span></a>.<p>
+
+</section><!-- end of section sec:abbrvfieldrefs -->
+
+<section id="sec:abbrprefixes"><!-- start of section sec:abbrprefixes --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->4.3.1. Prefixes<div class="labellink"><a href="#sec:abbrprefixes">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+If you are using the <a id="wrglossary.1614"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a> package (which can be loaded via the <a id="wrglossary.1615"></a><a href="#glo:opt.prefix"><span class="styoptfmt">prefix</span></a> package option), then there are commands similar to <a id="wrglossary.1616"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> and <a id="wrglossary.1617"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> that insert the corresponding prefix and separator at the front if the short or long form, if the prefix has been set and is non-empty. In all cases, the separator is <a id="wrglossary.1618"></a><a href="#glo:glsprefixsep"><code class="csfmt">\glsprefixsep</code></a>, as with <a id="wrglossary.1619"></a><a href="#glo:pgls"><code class="csfmt">\pgls</code></a>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+These commands require <a id="wrglossary.1620"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>. </div><!-- end of important -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1621"></a><code class="code"><dfn id="glo:pglsxtrshort"><code class="csfmt">\pglsxtrshort</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1622"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1623"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1624"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.1625"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> but inserts the <a id="wrglossary.1626"></a><a href="#glo:opt.gloskey.prefix"><span class="csoptfmt">prefix</span></a> field and separator, if the <a id="wrglossary.1627"></a><a href="#glo:opt.gloskey.prefix"><span class="csoptfmt">prefix</span></a> value is set and non-empty.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1628"></a><code class="code"><dfn id="glo:Pglsxtrshort"><code class="csfmt">\Pglsxtrshort</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1629"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1630"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1631"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.1632"></a><a href="#glo:pglsxtrshort"><code class="csfmt">\pglsxtrshort</code></a> but <a id="wrglossary.1633"></a><a href="#glo:idx.sentencecase">sentence case</a>. Note the initial <span class="qt">“P”</span> in the command name, which matches <a id="wrglossary.1634"></a><a href="#glo:Pgls"><code class="csfmt">\Pgls</code></a> (similarly for the other prefix <a id="wrglossary.1635"></a><a href="#glo:idx.sentencecase">sentence case</a> commands).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1636"></a><code class="code"><dfn id="glo:PGLSxtrshort"><code class="csfmt">\PGLSxtrshort</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1637"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1638"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1639"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.1640"></a><a href="#glo:pglsxtrshort"><code class="csfmt">\pglsxtrshort</code></a> but <a id="wrglossary.1641"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1642"></a><code class="code"><dfn id="glo:pglsxtrshortpl"><code class="csfmt">\pglsxtrshortpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1643"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1644"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1645"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.1646"></a><a href="#glo:glsxtrshortpl"><code class="csfmt">\glsxtrshortpl</code></a> but inserts the <a id="wrglossary.1647"></a><a href="#glo:opt.gloskey.prefixplural"><span class="csoptfmt">prefixplural</span></a> field and separator, if the <a id="wrglossary.1648"></a><a href="#glo:opt.gloskey.prefixplural"><span class="csoptfmt">prefixplural</span></a> value is set and non-empty.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1649"></a><code class="code"><dfn id="glo:Pglsxtrshortpl"><code class="csfmt">\Pglsxtrshortpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1650"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1651"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1652"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.1653"></a><a href="#glo:pglsxtrshortpl"><code class="csfmt">\pglsxtrshortpl</code></a> but <a id="wrglossary.1654"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1655"></a><code class="code"><dfn id="glo:PGLSxtrshortpl"><code class="csfmt">\PGLSxtrshortpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1656"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1657"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1658"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.1659"></a><a href="#glo:pglsxtrshortpl"><code class="csfmt">\pglsxtrshortpl</code></a> but <a id="wrglossary.1660"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1661"></a><code class="code"><dfn id="glo:pglsxtrlong"><code class="csfmt">\pglsxtrlong</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1662"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1663"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1664"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.1665"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> but inserts the <a id="wrglossary.1666"></a><a href="#glo:opt.gloskey.prefixfirst"><span class="csoptfmt">prefixfirst</span></a> field and separator, if the <a id="wrglossary.1667"></a><a href="#glo:opt.gloskey.prefixfirst"><span class="csoptfmt">prefixfirst</span></a> value is set and non-empty.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1668"></a><code class="code"><dfn id="glo:Pglsxtrlong"><code class="csfmt">\Pglsxtrlong</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1669"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1670"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1671"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.1672"></a><a href="#glo:pglsxtrlong"><code class="csfmt">\pglsxtrlong</code></a> but <a id="wrglossary.1673"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1674"></a><code class="code"><dfn id="glo:PGLSxtrlong"><code class="csfmt">\PGLSxtrlong</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1675"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1676"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1677"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.1678"></a><a href="#glo:pglsxtrlong"><code class="csfmt">\pglsxtrlong</code></a> but <a id="wrglossary.1679"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1680"></a><code class="code"><dfn id="glo:pglsxtrlongpl"><code class="csfmt">\pglsxtrlongpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1681"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1682"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1683"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.1684"></a><a href="#glo:glsxtrlongpl"><code class="csfmt">\glsxtrlongpl</code></a> but inserts the <a id="wrglossary.1685"></a><a href="#glo:opt.gloskey.prefixfirstplural"><span class="csoptfmt">prefixfirstplural</span></a> field and separator, if the <a id="wrglossary.1686"></a><a href="#glo:opt.gloskey.prefixfirstplural"><span class="csoptfmt">prefixfirstplural</span></a> value is set and non-empty.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1687"></a><code class="code"><dfn id="glo:Pglsxtrlongpl"><code class="csfmt">\Pglsxtrlongpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1688"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1689"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1690"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.1691"></a><a href="#glo:pglsxtrlongpl"><code class="csfmt">\pglsxtrlongpl</code></a> but <a id="wrglossary.1692"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1693"></a><code class="code"><dfn id="glo:PGLSxtrlongpl"><code class="csfmt">\PGLSxtrlongpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.1694"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.1695"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.1696"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.1697"></a><a href="#glo:pglsxtrlongpl"><code class="csfmt">\pglsxtrlongpl</code></a> but <a id="wrglossary.1698"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+
+</section><!-- end of section sec:abbrprefixes -->
+
+<section id="sec:abbrshortcuts"><!-- start of section sec:abbrshortcuts --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->4.3.2. Abbreviation Shortcut Commands<div class="labellink"><a href="#sec:abbrshortcuts">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+The abbreviation shortcut commands can be enabled using the <a id="wrglossary.1699"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.1700"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option (or <a id="wrglossary.1701"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.1702"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbr</span></a> or <a id="wrglossary.1703"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.1704"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a>). The provided shortcut commands listed in Table <a href="#tab:abbrshortcuts">4.1</a>. Note that <a id="wrglossary.1705"></a><a href="#glo:glsxtrenablerecordcount"><code class="csfmt">\glsxtrenablerecordcount</code></a> will switch the shortcuts that use the <a id="wrglossary.1706"></a><a href="#glo:cgls"><code class="csfmt">\cgls</code></a>-like commands to the corresponding <a id="wrglossary.1707"></a><a href="#glo:rgls"><code class="csfmt">\rgls</code></a>-like command.<p>
+<div class="table"> <table class="tabular-c">
+<caption id="tab:abbrshortcuts">Table&nbsp;1: Abbreviation Shortcut Commands</caption><tr style=""><th class="cell-noborder-bothsep-l">Shortcut </th>
+<td class="cell-noborder-bothsep-l"> <span style="font-weight: bold; ">Shortcut </span></td>
+<td class="cell-noborder-bothsep-l"> <span style="font-weight: bold; ">Equivalent Command</span></td>
+</tr><tr style=""><th class="cell-noborder-bothsep-l">(<a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a>) </th>
+<td class="cell-noborder-bothsep-l"> <span style="font-weight: bold; ">(<a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a>)</span></td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:ab"><code class="csfmt">\ab</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:ac"><code class="csfmt">\ac</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:cgls"><code class="csfmt">\cgls</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:abp"><code class="csfmt">\abp</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:acp"><code class="csfmt">\acp</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:cglspl"><code class="csfmt">\cglspl</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:as"><code class="csfmt">\as</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:acs"><code class="csfmt">\acs</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:asp"><code class="csfmt">\asp</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:acsp"><code class="csfmt">\acsp</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:glsxtrshortpl"><code class="csfmt">\glsxtrshortpl</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:al"><code class="csfmt">\al</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:acl"><code class="csfmt">\acl</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:alp"><code class="csfmt">\alp</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:aclp"><code class="csfmt">\aclp</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:glsxtrlongpl"><code class="csfmt">\glsxtrlongpl</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:af"><code class="csfmt">\af</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:acf"><code class="csfmt">\acf</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:afp"><code class="csfmt">\afp</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:acfp"><code class="csfmt">\acfp</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:glsxtrfullpl"><code class="csfmt">\glsxtrfullpl</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:Ab"><code class="csfmt">\Ab</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:Ac"><code class="csfmt">\Ac</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:cgls"><code class="csfmt">\cgls</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:Abp"><code class="csfmt">\Abp</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:Acp"><code class="csfmt">\Acp</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:cglspl"><code class="csfmt">\cglspl</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:As"><code class="csfmt">\As</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:Acs"><code class="csfmt">\Acs</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:Glsxtrshort"><code class="csfmt">\Glsxtrshort</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:Asp"><code class="csfmt">\Asp</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:Acsp"><code class="csfmt">\Acsp</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:Glsxtrshortpl"><code class="csfmt">\Glsxtrshortpl</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:Al"><code class="csfmt">\Al</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:Acl"><code class="csfmt">\Acl</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:Glsxtrlong"><code class="csfmt">\Glsxtrlong</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:Alp"><code class="csfmt">\Alp</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:Aclp"><code class="csfmt">\Aclp</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:Glsxtrlongpl"><code class="csfmt">\Glsxtrlongpl</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:Af"><code class="csfmt">\Af</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:Acf"><code class="csfmt">\Acf</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:Glsxtrfull"><code class="csfmt">\Glsxtrfull</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:Afp"><code class="csfmt">\Afp</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:Acfp"><code class="csfmt">\Acfp</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:Glsxtrfullpl"><code class="csfmt">\Glsxtrfullpl</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:AB"><code class="csfmt">\AB</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:AC"><code class="csfmt">\AC</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:cGLS"><code class="csfmt">\cGLS</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:ABP"><code class="csfmt">\ABP</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:ACP"><code class="csfmt">\ACP</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:cGLSpl"><code class="csfmt">\cGLSpl</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:AS"><code class="csfmt">\AS</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:ACS"><code class="csfmt">\ACS</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:GLSxtrshort"><code class="csfmt">\GLSxtrshort</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:ASP"><code class="csfmt">\ASP</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:ACSP"><code class="csfmt">\ACSP</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:GLSxtrshortpl"><code class="csfmt">\GLSxtrshortpl</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:AL"><code class="csfmt">\AL</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:ACL"><code class="csfmt">\ACL</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:GLSxtrlong"><code class="csfmt">\GLSxtrlong</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:ALP"><code class="csfmt">\ALP</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:ACLP"><code class="csfmt">\ACLP</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:GLSxtrlongpl"><code class="csfmt">\GLSxtrlongpl</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:AF"><code class="csfmt">\AF</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:ACF"><code class="csfmt">\ACF</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:GLSxtrfull"><code class="csfmt">\GLSxtrfull</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:AFP"><code class="csfmt">\AFP</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <dfn id="glo:ACFP"><code class="csfmt">\ACFP</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:GLSxtrfullpl"><code class="csfmt">\GLSxtrfullpl</code></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><dfn id="glo:newabbr"><code class="csfmt">\newabbr</code></dfn> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:newabbr"><code class="csfmt">\newabbr</code></a> </td>
+<td class="cell-noborder-bothsep-l"> <a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> </td>
+</tr></table>
+ </div><p>
+
+</section><!-- end of section sec:abbrshortcuts -->
+
+<section id="sec:tagging"><!-- start of section sec:tagging --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->4.4. Tagging Initials<div class="labellink"><a href="#sec:tagging">[link]</a></div></h2><!-- end of section header -->
+<p>
+Initial tagging allows you to highlight the initials that form the abbreviation when the long form is shown in the glossary.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1708"></a><code class="code"><dfn id="glo:GlsXtrEnableInitialTagging"><code class="csfmt">\GlsXtrEnableInitialTagging</code></dfn>{<span class="meta">〈<em class="metainner">categories</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+<a id="wrglossary.1709"></a><a href="#glo:GlsXtrEnableInitialTagging"><code class="csfmt">\GlsXtrEnableInitialTagging</code></a> must be placed before the abbreviations are defined. </div><!-- end of information -->
+<p>
+This command (robustly) defines <span class="meta">〈<em class="metainner">cs</em>〉</span> (a control sequence) to accept a single argument, which is the letter (or letters) that needs to be tagged. The normal behaviour of <span class="meta">〈<em class="metainner">cs</em>〉</span> within the document is to simply do its argument, but in the glossary it’s activated for those categories that have the <a id="wrglossary.1710"></a><a href="#glo:opt.catattr.tagging"><span class="csoptfmt">tagging</span></a> attribute set to <span class="qt">“true”</span>. For those cases it will use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1711"></a><code class="code"><dfn id="glo:glsxtrtagfont"><code class="csfmt">\glsxtrtagfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command defaults to <code class="code"><a id="wrglossary.1712"></a><a href="#glo:underline"><code class="csfmt">\underline</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code> but may be redefined as required.<p>
+The control sequence <span class="meta">〈<em class="metainner">cs</em>〉</span> can’t already be defined when used with the unstarred version of <a id="wrglossary.1713"></a><a href="#glo:GlsXtrEnableInitialTagging"><code class="csfmt">\GlsXtrEnableInitialTagging</code></a> for safety reasons. The starred version will overwrite any previous definition of <span class="meta">〈<em class="metainner">cs</em>〉</span>. As with redefining any commands, ensure that you don’t redefine something important.<p>
+The first argument of <a id="wrglossary.1714"></a><a href="#glo:GlsXtrEnableInitialTagging"><code class="csfmt">\GlsXtrEnableInitialTagging</code></a> is a comma-separated list of category names. The <a id="wrglossary.1715"></a><a href="#glo:opt.catattr.tagging"><span class="csoptfmt">tagging</span></a> attribute will automatically be set to <code class="code">true</code> for those categories. You can later set this attribute for other categories (see §<a href="#sec:categories">10</a>) but this must be done before the glossary is displayed.<p>
+For example, the following uses initial tagging for both the <a id="wrglossary.1716"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a> and <a id="wrglossary.1717"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a> categories. The custom command <code class="csfmt">\itag</code> is defined as the tagging command. <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1718"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.1719"></a><a href="#glo:GlsXtrEnableInitialTagging"><code class="csfmt">\GlsXtrEnableInitialTagging</code></a>{<a id="wrglossary.1720"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a>,<a id="wrglossary.1721"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a>}{<code class="cmd">\itag</code>}
+<a id="wrglossary.1722"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>[<a id="wrglossary.1723"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a>]{<a id="wrglossary.1724"></a><a href="#glo:opt.abbrstyle.short-nolong-desc"><span class="abbrstylefmt">short-nolong-desc</span></a>}
+<a id="wrglossary.1725"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>
+ [description={a system for detecting the location and
+ speed of ships, aircraft, etc, through the use of radio
+ waves}<span class="comment">% description of this term</span>
+ ]
+ {radar}<span class="comment">% identifying label</span>
+ {radar}<span class="comment">% short form</span>
+ {<code class="cmd">\itag</code>{ra}dio <code class="cmd">\itag</code>{d}etection <code class="cmd">\itag</code>{a}nd <code class="cmd">\itag</code>{r}anging}
+
+<a id="wrglossary.1726"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{xml}{XML}
+ {e<code class="cmd">\itag</code>{x}tensible <code class="cmd">\itag</code>{m}arkup <code class="cmd">\itag</code>{l}anguage}
+
+<a id="wrglossary.1727"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.1728"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={other}</span>]{tne}{TNE}
+ {<code class="cmd">\itag</code>{t}agging <code class="cmd">\itag</code>{n}ot <code class="cmd">\itag</code>{e}nabled}
+
+<code class="cbeg">\begin{document}</code>
+First use: <a id="wrglossary.1729"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{radar}, <a id="wrglossary.1730"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{xml}, <a id="wrglossary.1731"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{tne}.
+
+Long form only: <a id="wrglossary.1732"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a>{radar}, <a id="wrglossary.1733"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a>{xml}, <a id="wrglossary.1734"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a>{tne}.
+<a id="wrglossary.1735"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:tagging"></a>Example 6: Tagging abbreviation initials <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example006.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example006.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example006.png" type="image/png" width="389" height="196">Example document illustrating the use of <code class="cmd">\GlsXtrEnableInitialTagging</code> to tag initial letters that form the abbreviation.</object> </div><!-- end of resultbox -->
+ The underlining of the tagged letters only occurs in the glossary and then only for entries with the <a id="wrglossary.1736"></a><a href="#glo:opt.catattr.tagging"><span class="csoptfmt">tagging</span></a> attribute set.<p>
+
+</section><!-- end of section sec:tagging -->
+
+<section id="sec:abbrstyle"><!-- start of section sec:abbrstyle --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->4.5. Abbreviation Styles<div class="labellink"><a href="#sec:abbrstyle">[link]</a></div></h2><!-- end of section header -->
+<p>
+The style for a particular category is set using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1737"></a><code class="code"><dfn id="glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></dfn>[<span class="meta">〈<em class="metainner">category</em>〉</span>]{<span class="meta">〈<em class="metainner">style-name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If the <span class="meta">〈<em class="metainner">category</em>〉</span> is omitted, <a id="wrglossary.1738"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a> is assumed. Remember that <a id="wrglossary.1739"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> sets the <a id="wrglossary.1740"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> to <a id="wrglossary.1741"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a> so with <a id="wrglossary.1742"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> you need to change the style with: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1743"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>[<a id="wrglossary.1744"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a>]{<span class="meta">〈<em class="metainner">style-name</em>〉</span>}
+</pre><p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The abbreviation style must be set before the abbreviation with the corresponding category is defined. If you are using <a id="wrglossary.1745"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the style must be set before <a id="wrglossary.1746"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>. </div><!-- end of important -->
+<p>
+The style associated with the <a id="wrglossary.1747"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a> category will be used if an abbreviation is defined with a category that doesn’t have an associated style.<p>
+Once you have defined an abbreviation with a given category, you can’t subsequently change the style for that category. You can’t have more than one style per category. The default style for the <a id="wrglossary.1748"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a> category is <a id="wrglossary.1749"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> and the default style for the <a id="wrglossary.1750"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a> category is <a id="wrglossary.1751"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a>.<p>
+In the example below, the custom <code class="code">latin</code> category doesn’t have an associated abbreviation style, so it uses the style assigned to the <a id="wrglossary.1752"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a> category, not the <a id="wrglossary.1753"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a> category. The only reason that the <span class="qt">“radar”</span> abbreviation (defined with <a id="wrglossary.1754"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>) uses the style associated with the <a id="wrglossary.1755"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a> category is because the default definition of <a id="wrglossary.1756"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> sets <a id="wrglossary.1757"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={<a id="wrglossary.1758"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a>}</span>. <div style="text-align: center; border-style: none; "><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
+<p>
+<pre class="sidebysidecode">
+<code class="cmd">\usepackage</code>[T1]{fontenc}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+<a id="wrglossary.1759"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{long-short-sc}
+<a id="wrglossary.1760"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{html}{html}{hypertext markup language}
+<a id="wrglossary.1761"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>[<a id="wrglossary.1762"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a>]{footnote}
+<a id="wrglossary.1763"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{radar}{radar}{radio detection and ranging}
+<a id="wrglossary.1764"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>[<a id="wrglossary.1765"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={latin}</span>]{ibid}{ibid}{ibidem}
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.1766"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}, <a id="wrglossary.1767"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{radar} and <a id="wrglossary.1768"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ibid}.
+<a id="wrglossary.1769"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre><div class="sidebysideresult"><a id="ex:fallbackabbrstyle"></a>Example 7: Category without an associated abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example007.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example007.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example007.png" type="image/png" width="468" height="544">Example document that has an abbreviation with a category that doesn’t have an associated abbreviation style.</object> </div><p>
+<p>
+
+</section><!-- end of section sec:abbrstyle -->
+
+<section id="sec:predefabbrstyles"><!-- start of section sec:predefabbrstyles --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->4.5.1. Predefined Abbreviation Styles<div class="labellink"><a href="#sec:predefabbrstyles">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+There are two types of abbreviation styles: those that treat the abbreviation as a regular entry (so that <a id="wrglossary.1770"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> uses <a id="wrglossary.1771"></a><a href="#glo:glsgenentryfmt"><code class="csfmt">\glsgenentryfmt</code></a> and is encapsulated with <a id="wrglossary.1772"></a><a href="#glo:glsxtrregularfont"><code class="csfmt">\glsxtrregularfont</code></a>) and those that don’t treat the abbreviation as a regular entry (so that <a id="wrglossary.1773"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> uses <a id="wrglossary.1774"></a><a href="#glo:glsxtrgenabbrvfmt"><code class="csfmt">\glsxtrgenabbrvfmt</code></a> and is encapsulated with <a id="wrglossary.1775"></a><a href="#glo:glsxtrabbreviationfont"><code class="csfmt">\glsxtrabbreviationfont</code></a>). See §<a href="#sec:entryfmt">5.5.5</a> for further details of those commands.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+The non-regular abbreviation styles allow for more complex formats than the regular styles. </div><!-- end of information -->
+<p>
+The regular entry abbreviation styles set the <a id="wrglossary.1776"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">true</code> for the category assigned to each abbreviation with that style. This means that on <a id="wrglossary.1777"></a><a href="#glo:dual.firstuse">first use</a>, <a id="wrglossary.1778"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> uses the value of the <a id="wrglossary.1779"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> field and on subsequent use <a id="wrglossary.1780"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> uses the value of the <a id="wrglossary.1781"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field (and analogously for the plural and case-changing versions).<p>
+The non-regular abbreviation styles don’t set the <a id="wrglossary.1782"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute, unless it has already been set, in which case it will be changed to <code class="code">false</code>. The <a id="wrglossary.1783"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> and <a id="wrglossary.1784"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> fields (and their plural forms) are set, but they aren’t used by commands like <a id="wrglossary.1785"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>, which instead use formatting commands, such as <a id="wrglossary.1786"></a><a href="#glo:glsxtrfullformat"><code class="csfmt">\glsxtrfullformat</code></a> and <a id="wrglossary.1787"></a><a href="#glo:glsxtrsubsequentfmt"><code class="csfmt">\glsxtrsubsequentfmt</code></a>, which are defined by the style.<p>
+In both cases, the <a id="wrglossary.1788"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.1789"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> may not match the text produced by <a id="wrglossary.1790"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a> (and likewise for the plural and case-changing versions).<p>
+The <a id="wrglossary.1791"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> and <a id="wrglossary.1792"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> fields are set as appropriate and may be accessed through commands like <a id="wrglossary.1793"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> and <a id="wrglossary.1794"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a>. These may appear slightly differently to the way the short or long form is displayed within <a id="wrglossary.1795"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>, depending on the style.<p>
+The sample file <a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries-extra/samples/sample-abbr-styles.pdf"><span class="filefmt">sample-abbr-styles.pdf</span></a> demonstrates all predefined styles described here.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+For the <span class="qt">“sc”</span> styles that use <a id="wrglossary.1796"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a>, be careful about your choice of fonts as some only have limited support. For example, you may not be able to combine bold and small-caps. If you’re using pdfLaTeX, I recommend that you at least use the <a id="wrglossary.1797"></a><a href="#glo:pkg.fontenc"><span class="styfmt">fontenc</span></a> package with the <span class="optfmt">T1</span> option or something similar. </div><!-- end of important -->
+<p>
+The predefined styles have helper commands to make it easier to modify the format. These are described in §<a href="#sec:abbrvcmds">4.5.1.3</a>.<p>
+Table <a href="#tab:acrabbrvstyles">4.2</a> lists the nearest equivalent <a id="wrglossary.1798"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> abbreviation styles for the predefined acronym styles provided by <a id="wrglossary.1799"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>, but note that the new styles use different formatting commands.<p>
+<div class="table"> <table class="tabular-c">
+<caption id="tab:acrabbrvstyles">Table&nbsp;2: Base Acronym Styles <code class="csfmt">\setacronymstyle</code>{<span class="meta">〈<em class="metainner">base-style-name</em>〉</span>} Verses New Abbreviation Styles <code class="csfmt">\setabbreviationstyle</code>[<span class="meta">〈<em class="metainner">category</em>〉</span>]{<span class="meta">〈<em class="metainner">new-style-name</em>〉</span>}</caption><tr style=""><th class="cell-noborder-bothsep-l">Base Style Name </th>
+<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 7000.000000%; padding-right: 6.000000pt; text-align: left; "> <span style="font-weight: bold; ">New Style Name</span></td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><a href="#glo:opt.acrstyle.long-sc-short"><span class="acrstylefmt">long-sc-short</span></a> </td>
+<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 7000.000000%; padding-right: 6.000000pt; text-align: left; "> <a href="#glo:opt.abbrstyle.long-short-sc"><span class="abbrstylefmt">long-short-sc</span></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><a href="#glo:opt.acrstyle.long-sm-short"><span class="acrstylefmt">long-sm-short</span></a> </td>
+<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 7000.000000%; padding-right: 6.000000pt; text-align: left; "> <a href="#glo:opt.abbrstyle.long-short-sm"><span class="abbrstylefmt">long-short-sm</span></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><a href="#glo:opt.acrstyle.long-sp-short"><span class="acrstylefmt">long-sp-short</span></a> </td>
+<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 7000.000000%; padding-right: 6.000000pt; text-align: left; "> <a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> <br>with <code class="code"><span class="cmdfmt">\renewcommand</span>{<a href="#glo:glsxtrfullsep"><code class="csfmt">\glsxtrfullsep</code></a>}{<a href="#glo:glsabspace"><code class="csfmt">\glsabspace</code></a>}</code></td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><a href="#glo:opt.acrstyle.short-long"><span class="acrstylefmt">short-long</span></a> </td>
+<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 7000.000000%; padding-right: 6.000000pt; text-align: left; "> <a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><a href="#glo:opt.acrstyle.sc-short-long"><span class="acrstylefmt">sc-short-long</span></a> </td>
+<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 7000.000000%; padding-right: 6.000000pt; text-align: left; "> <a href="#glo:opt.abbrstyle.short-sc-long"><span class="abbrstylefmt">short-sc-long</span></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><a href="#glo:opt.acrstyle.sm-short-long"><span class="acrstylefmt">sm-short-long</span></a> </td>
+<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 7000.000000%; padding-right: 6.000000pt; text-align: left; "> <a href="#glo:opt.abbrstyle.short-sm-long"><span class="abbrstylefmt">short-sm-long</span></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><a href="#glo:opt.acrstyle.long-short-desc"><span class="acrstylefmt">long-short-desc</span></a> </td>
+<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 7000.000000%; padding-right: 6.000000pt; text-align: left; "> <a href="#glo:opt.abbrstyle.long-short-desc"><span class="abbrstylefmt">long-short-desc</span></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><a href="#glo:opt.acrstyle.long-sc-short-desc"><span class="acrstylefmt">long-sc-short-desc</span></a> </td>
+<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 7000.000000%; padding-right: 6.000000pt; text-align: left; "> <a href="#glo:opt.abbrstyle.long-short-sc-desc"><span class="abbrstylefmt">long-short-sc-desc</span></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><a href="#glo:opt.acrstyle.long-sm-short-desc"><span class="acrstylefmt">long-sm-short-desc</span></a> </td>
+<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 7000.000000%; padding-right: 6.000000pt; text-align: left; "> <a href="#glo:opt.abbrstyle.long-short-sm-desc"><span class="abbrstylefmt">long-short-sm-desc</span></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><a href="#glo:opt.acrstyle.long-sp-short-desc"><span class="acrstylefmt">long-sp-short-desc</span></a> </td>
+<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 7000.000000%; padding-right: 6.000000pt; text-align: left; "> <a href="#glo:opt.abbrstyle.long-short-desc"><span class="abbrstylefmt">long-short-desc</span></a> <br>with <code class="code"><span class="cmdfmt">\renewcommand</span>{<a href="#glo:glsxtrfullsep"><code class="csfmt">\glsxtrfullsep</code></a>}{<a href="#glo:glsabspace"><code class="csfmt">\glsabspace</code></a>}</code></td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><a href="#glo:opt.acrstyle.short-long-desc"><span class="acrstylefmt">short-long-desc</span></a> </td>
+<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 7000.000000%; padding-right: 6.000000pt; text-align: left; "> <a href="#glo:opt.abbrstyle.short-long-desc"><span class="abbrstylefmt">short-long-desc</span></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><a href="#glo:opt.acrstyle.sc-short-long-desc"><span class="acrstylefmt">sc-short-long-desc</span></a> </td>
+<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 7000.000000%; padding-right: 6.000000pt; text-align: left; "> <a href="#glo:opt.abbrstyle.short-sc-long-desc"><span class="abbrstylefmt">short-sc-long-desc</span></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><a href="#glo:opt.acrstyle.sm-short-long-desc"><span class="acrstylefmt">sm-short-long-desc</span></a> </td>
+<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 7000.000000%; padding-right: 6.000000pt; text-align: left; "> <a href="#glo:opt.abbrstyle.short-sm-long-desc"><span class="abbrstylefmt">short-sm-long-desc</span></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><a href="#glo:opt.acrstyle.dua"><span class="acrstylefmt">dua</span></a> </td>
+<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 7000.000000%; padding-right: 6.000000pt; text-align: left; "> <a href="#glo:opt.abbrstyle.long-noshort"><span class="abbrstylefmt">long-noshort</span></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><a href="#glo:opt.acrstyle.dua-desc"><span class="acrstylefmt">dua-desc</span></a> </td>
+<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 7000.000000%; padding-right: 6.000000pt; text-align: left; "> <a href="#glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><a href="#glo:opt.acrstyle.footnote"><span class="acrstylefmt">footnote</span></a> </td>
+<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 7000.000000%; padding-right: 6.000000pt; text-align: left; "> <a href="#glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">short-footnote</span></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><a href="#glo:opt.acrstyle.footnote-sc"><span class="acrstylefmt">footnote-sc</span></a> </td>
+<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 7000.000000%; padding-right: 6.000000pt; text-align: left; "> <a href="#glo:opt.abbrstyle.short-sc-footnote"><span class="abbrstylefmt">short-sc-footnote</span></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><a href="#glo:opt.acrstyle.footnote-sm"><span class="acrstylefmt">footnote-sm</span></a> </td>
+<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 7000.000000%; padding-right: 6.000000pt; text-align: left; "> <a href="#glo:opt.abbrstyle.short-sm-footnote"><span class="abbrstylefmt">short-sm-footnote</span></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><a href="#glo:opt.acrstyle.footnote-desc"><span class="acrstylefmt">footnote-desc</span></a> </td>
+<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 7000.000000%; padding-right: 6.000000pt; text-align: left; "> <a href="#glo:opt.abbrstyle.short-footnote-desc"><span class="abbrstylefmt">short-footnote-desc</span></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><a href="#glo:opt.acrstyle.footnote-sc-desc"><span class="acrstylefmt">footnote-sc-desc</span></a> </td>
+<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 7000.000000%; padding-right: 6.000000pt; text-align: left; "> <a href="#glo:opt.abbrstyle.short-sc-footnote-desc"><span class="abbrstylefmt">short-sc-footnote-desc</span></a> </td>
+</tr><tr style=""><td class="cell-noborder-bothsep-l"><a href="#glo:opt.acrstyle.footnote-sm-desc"><span class="acrstylefmt">footnote-sm-desc</span></a> </td>
+<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 7000.000000%; padding-right: 6.000000pt; text-align: left; "> <a href="#glo:opt.abbrstyle.short-sm-footnote-desc"><span class="abbrstylefmt">short-sm-footnote-desc</span></a> </td>
+</tr></table>
+ </div><p>
+The example documents used to illustrate the predefined styles in the sub-sections below are all in the form (document class and options may vary): <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>[T1]{fontenc}
+<code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+<a id="wrglossary.1800"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<span class="meta">〈<em class="metainner">style-name</em>〉</span>}
+<a id="wrglossary.1801"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{ex}{<span class="meta">〈<em class="metainner">short</em>〉</span>}{long form}
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.1802"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.1803"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.1804"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+<a id="wrglossary.1805"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> where <span class="meta">〈<em class="metainner">style-name</em>〉</span> is the name of the abbreviation style, <span class="meta">〈<em class="metainner">short</em>〉</span> is either <span class="qt">“SHRT FM”</span> or (for the <a id="wrglossary.1806"></a><a href="#glo:idx.smallcaps">small caps</a> examples) <span class="qt">“shrt fm”</span>. The styles that require the <a id="wrglossary.1807"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> or <a id="wrglossary.1808"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key to be set will include that in <span class="meta">〈<em class="metainner">options</em>〉</span> otherwise the optional argument of <a id="wrglossary.1809"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> will be omitted. The examples with a style that requires <a id="wrglossary.1810"></a><a href="#glo:textsmaller"><code class="csfmt">\textsmaller</code></a> will load <a id="wrglossary.1811"></a><a href="#glo:pkg.relsize"><span class="styfmt">relsize</span></a>. The <span class="qt">“hyphen”</span> styles set the <a id="wrglossary.1812"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a> and <a id="wrglossary.1813"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a> attributes. Note that <a id="wrglossary.1814"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> is loaded with the <span class="optfmt">colorlinks</span> option, so the hyperlink text will be red.<p>
+The naming scheme for abbreviation styles is as follows:
+<ul class="displaylist">
+ <li><span class="bulletitem">•</span><span class="meta">〈<em class="metainner">field1</em>〉</span>[<code class="code">-</code><span class="meta">〈<em class="metainner">modifier1</em>〉</span>]<code class="code">-</code>[post]<span class="meta">〈<em class="metainner">field2</em>〉</span>[<code class="code">-</code><span class="meta">〈<em class="metainner">modifier2</em>〉</span>][<code class="code">-user</code>]<p>
+This is for the parenthetical styles. The <code class="code">-</code><span class="meta">〈<em class="metainner">modifier</em>〉</span> parts may be omitted. These styles display <span class="meta">〈<em class="metainner">field1</em>〉</span> followed by <span class="meta">〈<em class="metainner">field2</em>〉</span> in parentheses. If <span class="meta">〈<em class="metainner">field1</em>〉</span> or <span class="meta">〈<em class="metainner">field2</em>〉</span> starts with <span class="qt">“no”</span> then that element is omitted from the <a id="wrglossary.1815"></a><a href="#glo:@@glslabel@displayfullform">display style</a> (no parenthetical part) but is included in the <a id="wrglossary.1816"></a><a href="#glo:@@glslabel@inlinefullform">inline style</a>.<p>
+If <code class="code">post</code> is present then <span class="meta">〈<em class="metainner">field2</em>〉</span> is placed after the <a id="wrglossary.1817"></a><a href="#glo:linktext">link text</a> using the <a id="wrglossary.1818"></a><a href="#glo:dual.postlinkhook">post-link hook</a>. Note that this will use the singular form of <span class="meta">〈<em class="metainner">field2</em>〉</span> by default, even if <a id="wrglossary.1819"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> is used. The corresponding non-post style will use the matching form for <span class="meta">〈<em class="metainner">field2</em>〉</span>.<p>
+If the <code class="code">-</code><span class="meta">〈<em class="metainner">modifier</em>〉</span> part is present and is one of <code class="code">sc</code>, <code class="code">sm</code> or <code class="code">em</code>, then the field has a font changing command applied to it.<p>
+The modifier <code class="code">-only</code> indicates that field is only present according to whether or not the entry has been used.<p>
+The modifier <code class="code">-hyphen</code> indicates the style will substitute inter-word spaces (that have been marked up with the <a id="wrglossary.1820"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a> or <a id="wrglossary.1821"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a> attributes) will be changed to spaces if the inserted material starts with a hyphen (but not for the set of <a id="wrglossary.1822"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> and <a id="wrglossary.1823"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> commands).<p>
+If the <code class="code">-user</code> part is present, then the value of the field given by <a id="wrglossary.1824"></a><a href="#glo:glsxtruserfield"><code class="csfmt">\glsxtruserfield</code></a> (<a id="wrglossary.1825"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a>), if set, is inserted into the parenthetical material.<p>
+Examples:
+<ul class="displaylist">
+ <li><span class="bulletitem">&#x2013;</span><a id="wrglossary.1826"></a><a href="#glo:opt.abbrstyle.long-noshort-sc"><span class="abbrstylefmt">long-noshort-sc</span></a>: <span class="meta">〈<em class="metainner">field1</em>〉</span> is the long form, the short form is set in <a id="wrglossary.1827"></a><a href="#glo:idx.smallcaps">small caps</a> but omitted in the display style. <li><span class="bulletitem">&#x2013;</span><a id="wrglossary.1828"></a><a href="#glo:opt.abbrstyle.long-em-short-em"><span class="abbrstylefmt">long-em-short-em</span></a>: both the long form and the short form are emphasized. The short form is in parentheses. <li><span class="bulletitem">&#x2013;</span><a id="wrglossary.1829"></a><a href="#glo:opt.abbrstyle.long-short-em"><span class="abbrstylefmt">long-short-em</span></a>: the short form is emphasized but not the long form. The short form is in parentheses. <li><span class="bulletitem">&#x2013;</span><a id="wrglossary.1830"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a>: if the <a id="wrglossary.1831"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key has been set, this produces the style <span class="meta">〈<em class="metainner">long</em>〉</span> (<span class="meta">〈<em class="metainner">short</em>〉</span>, <span class="meta">〈<em class="metainner">user1</em>〉</span>) otherwise it just produces <span class="meta">〈<em class="metainner">long</em>〉</span> (<span class="meta">〈<em class="metainner">short</em>〉</span>).<p>
+<li><span class="bulletitem">&#x2013;</span><a id="wrglossary.1832"></a><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen"><span class="abbrstylefmt">long-hyphen-postshort-hyphen</span></a>: the short form and the inserted material (provided by the final optional argument of commands like <a id="wrglossary.1833"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>) is moved to the post-link hook. The long form is formatted according to <a id="wrglossary.1834"></a><a href="#glo:glslonghyphenfont"><code class="csfmt">\glslonghyphenfont</code></a> (or <a id="wrglossary.1835"></a><a href="#glo:glsfirstlonghyphenfont"><code class="csfmt">\glsfirstlonghyphenfont</code></a> on first use). The short form is formatted according to <a id="wrglossary.1836"></a><a href="#glo:glsabbrvhyphenfont"><code class="csfmt">\glsabbrvhyphenfont</code></a> (or <a id="wrglossary.1837"></a><a href="#glo:glsfirstabbrvhyphenfont"><code class="csfmt">\glsfirstabbrvhyphenfont</code></a> on first use).
+</ul>
+<p>
+<li><span class="bulletitem">•</span><span class="meta">〈<em class="metainner">style</em>〉</span><code class="code">-noreg</code><p>
+Some styles set the <a id="wrglossary.1838"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute. In some cases, there’s a version of the style that doesn’t set this attribute. For example, <a id="wrglossary.1839"></a><a href="#glo:opt.abbrstyle.long-em-noshort-em"><span class="abbrstylefmt">long-em-noshort-em</span></a> sets the <a id="wrglossary.1840"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute. The <a id="wrglossary.1841"></a><a href="#glo:opt.abbrstyle.long-em-noshort-em-noreg"><span class="abbrstylefmt">long-em-noshort-em-noreg</span></a> style is a minor variation of that style that sets the attribute to <code class="code">false</code>.<p>
+There are a few <span class="qt">“noshort”</span> styles, such as <a id="wrglossary.1842"></a><a href="#glo:opt.abbrstyle.long-hyphen-noshort-noreg"><span class="abbrstylefmt">long-hyphen-noshort-noreg</span></a>, where there isn’t a corresponding regular version. This is because the style won’t work properly with the <a id="wrglossary.1843"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute set, but the naming scheme is maintained for consistency with the other <span class="qt">“noshort”</span> styles.<p>
+<li><span class="bulletitem">•</span><span class="meta">〈<em class="metainner">field1</em>〉</span>[<code class="code">-</code><span class="meta">〈<em class="metainner">modifier1</em>〉</span>]<code class="code">-</code>[<code class="code">post</code>]<code class="code">footnote</code><p>
+The display style uses <span class="meta">〈<em class="metainner">field1</em>〉</span> followed by a footnote with the other field in it. If <code class="code">post</code> is present then the footnote is placed after the <a id="wrglossary.1844"></a><a href="#glo:linktext">link text</a> using the post-link hook. The inline style does <span class="meta">〈<em class="metainner">field1</em>〉</span> followed by the other field in parentheses.<p>
+If <code class="code">-</code><span class="meta">〈<em class="metainner">modifier1</em>〉</span> is present, <span class="meta">〈<em class="metainner">field1</em>〉</span> has a font-changing command applied to it.<p>
+Examples:
+<ul class="displaylist">
+ <li><span class="bulletitem">&#x2013;</span><a id="wrglossary.1845"></a><a href="#glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">short-footnote</span></a>: short form in the text with the long form in the footnote. <li><span class="bulletitem">&#x2013;</span><a id="wrglossary.1846"></a><a href="#glo:opt.abbrstyle.short-sc-postfootnote"><span class="abbrstylefmt">short-sc-postfootnote</span></a>: short form in smallcaps with the long form in the footnote outside of the <a id="wrglossary.1847"></a><a href="#glo:linktext">link text</a>.
+</ul>
+<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Take care with the footnote styles. Remember that there are some situations where <a id="wrglossary.1848"></a><a href="#glo:footnote"><code class="csfmt">\footnote</code></a> doesn’t work. </div><!-- end of important -->
+<p>
+<li><span class="bulletitem">•</span><span class="meta">〈<em class="metainner">style</em>〉</span><code class="code">-desc</code><p>
+Like <span class="meta">〈<em class="metainner">style</em>〉</span> but the <a id="wrglossary.1849"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> key must be provided when defining abbreviations with this style.<p>
+Examples:
+<ul class="displaylist">
+<p>
+<li><span class="bulletitem">&#x2013;</span><a id="wrglossary.1850"></a><a href="#glo:opt.abbrstyle.short-long-desc"><span class="abbrstylefmt">short-long-desc</span></a>: like <a id="wrglossary.1851"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a> but requires a description. <li><span class="bulletitem">&#x2013;</span><a id="wrglossary.1852"></a><a href="#glo:opt.abbrstyle.short-em-footnote-desc"><span class="abbrstylefmt">short-em-footnote-desc</span></a>: like <a id="wrglossary.1853"></a><a href="#glo:opt.abbrstyle.short-em-footnote"><span class="abbrstylefmt">short-em-footnote</span></a> but requires a description.
+</ul>
-><colgroup id="TBL-2-1g"><col
-id="TBL-2-1" /><col
-id="TBL-2-2" /></colgroup><tr
- style="vertical-align:baseline;" id="TBL-2-1-"><td style="white-space:normal; text-align:left;" id="TBL-2-1-1"
-class="td01"><!--l. 3112--><p class="noindent" ><span
-class="cmbx-10">Old Style Name</span> </p></td><td style="white-space:normal; text-align:left;" id="TBL-2-1-2"
-class="td10"><!--l. 3113--><p class="noindent" ><span
-class="cmbx-10">New Style Name</span> </p></td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-2-2-"><td style="white-space:normal; text-align:left;" id="TBL-2-2-1"
-class="td01"><!--l. 3114--><p class="noindent" ><span
-class="cmss-10">long-sc-short</span><a
- id="dx1-14015"></a> </p></td><td style="white-space:normal; text-align:left;" id="TBL-2-2-2"
-class="td10"><!--l. 3114--><p class="noindent" ><a
-href="#abbrstyle.long-short-sc"><span
-class="cmss-10">long-short-sc</span></a><a
- id="dx1-14016"></a> </p></td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-2-3-"><td style="white-space:normal; text-align:left;" id="TBL-2-3-1"
-class="td01"><!--l. 3115--><p class="noindent" ><span
-class="cmss-10">long-sm-short</span><a
- id="dx1-14017"></a> </p></td><td style="white-space:normal; text-align:left;" id="TBL-2-3-2"
-class="td10"><!--l. 3115--><p class="noindent" ><a
-href="#abbrstyle.long-short-sm"><span
-class="cmss-10">long-short-sm</span></a><a
- id="dx1-14018"></a> </p></td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-2-4-"><td style="white-space:normal; text-align:left;" id="TBL-2-4-1"
-class="td01"><!--l. 3116--><p class="noindent" ><span
-class="cmss-10">long-sp-short</span><a
- id="dx1-14019"></a> </p></td><td style="white-space:normal; text-align:left;" id="TBL-2-4-2"
-class="td10"><!--l. 3116--><p class="noindent" ><a
-href="#abbrstyle.long-short"><span
-class="cmss-10">long-short</span></a><a
- id="dx1-14020"></a> <br
-class="newline" />with <span
-class="cmtt-10">\renewcommand</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">\glsxtrfullsep</span><span
-class="cmsy-10">}</span><span
-class="cmtt-10">[1]</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">\glsacspace</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">#1</span><span
-class="cmsy-10">}}</span> </p> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-2-5-"><td style="white-space:normal; text-align:left;" id="TBL-2-5-1"
-class="td01"><!--l. 3118--><p class="noindent" ><span
-class="cmss-10">short-long</span><a
- id="dx1-14021"></a> </p></td><td style="white-space:normal; text-align:left;" id="TBL-2-5-2"
-class="td10"><!--l. 3118--><p class="noindent" ><a
-href="#abbrstyle.short-long"><span
-class="cmss-10">short-long</span></a><a
- id="dx1-14022"></a> </p></td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-2-6-"><td style="white-space:normal; text-align:left;" id="TBL-2-6-1"
-class="td01"><!--l. 3119--><p class="noindent" ><span
-class="cmss-10">sc-short-long</span><a
- id="dx1-14023"></a> </p></td><td style="white-space:normal; text-align:left;" id="TBL-2-6-2"
-class="td10"><!--l. 3119--><p class="noindent" ><a
-href="#abbrstyle.short-sc-long"><span
-class="cmss-10">short-sc-long</span></a><a
- id="dx1-14024"></a> </p></td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-2-7-"><td style="white-space:normal; text-align:left;" id="TBL-2-7-1"
-class="td01"><!--l. 3120--><p class="noindent" ><span
-class="cmss-10">sm-short-long</span><a
- id="dx1-14025"></a> </p></td><td style="white-space:normal; text-align:left;" id="TBL-2-7-2"
-class="td10"><!--l. 3120--><p class="noindent" ><a
-href="#abbrstyle.short-sm-long"><span
-class="cmss-10">short-sm-long</span></a><a
- id="dx1-14026"></a> </p></td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-2-8-"><td style="white-space:normal; text-align:left;" id="TBL-2-8-1"
-class="td01"><!--l. 3121--><p class="noindent" ><span
-class="cmss-10">long-short-desc</span><a
- id="dx1-14027"></a> </p></td><td style="white-space:normal; text-align:left;" id="TBL-2-8-2"
-class="td10"><!--l. 3121--><p class="noindent" ><a
-href="#abbrstyle.long-short-desc"><span
-class="cmss-10">long-short-desc</span></a><a
- id="dx1-14028"></a> </p></td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-2-9-"><td style="white-space:normal; text-align:left;" id="TBL-2-9-1"
-class="td01"><!--l. 3122--><p class="noindent" ><span
-class="cmss-10">long-sc-short-desc</span><a
- id="dx1-14029"></a> </p></td><td style="white-space:normal; text-align:left;" id="TBL-2-9-2"
-class="td10"><!--l. 3122--><p class="noindent" ><a
-href="#abbrstyle.long-short-sc-desc"><span
-class="cmss-10">long-short-sc-desc</span></a><a
- id="dx1-14030"></a> </p></td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-2-10-"><td style="white-space:normal; text-align:left;" id="TBL-2-10-1"
-class="td01"><!--l. 3123--><p class="noindent" ><span
-class="cmss-10">long-sm-short-desc</span><a
- id="dx1-14031"></a> </p></td><td style="white-space:normal; text-align:left;" id="TBL-2-10-2"
-class="td10"><!--l. 3123--><p class="noindent" ><a
-href="#abbrstyle.long-short-sm-desc"><span
-class="cmss-10">long-short-sm-desc</span></a><a
- id="dx1-14032"></a> </p></td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-2-11-"><td style="white-space:normal; text-align:left;" id="TBL-2-11-1"
-class="td01"><!--l. 3124--><p class="noindent" ><span
-class="cmss-10">long-sp-short-desc</span><a
- id="dx1-14033"></a> </p></td><td style="white-space:normal; text-align:left;" id="TBL-2-11-2"
-class="td10"><!--l. 3124--><p class="noindent" ><a
-href="#abbrstyle.long-short-desc"><span
-class="cmss-10">long-short-desc</span></a><a
- id="dx1-14034"></a> <br
-class="newline" />with <span
-class="cmtt-10">\renewcommand</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">\glsxtrfullsep</span><span
-class="cmsy-10">}</span><span
-class="cmtt-10">[1]</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">\glsacspace</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">#1</span><span
-class="cmsy-10">}}</span> </p> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-2-12-"><td style="white-space:normal; text-align:left;" id="TBL-2-12-1"
-class="td01"><!--l. 3126--><p class="noindent" ><span
-class="cmss-10">short-long-desc</span><a
- id="dx1-14035"></a> </p></td><td style="white-space:normal; text-align:left;" id="TBL-2-12-2"
-class="td10"><!--l. 3126--><p class="noindent" ><a
-href="#abbrstyle.short-long-desc"><span
-class="cmss-10">short-long-desc</span></a><a
- id="dx1-14036"></a> </p></td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-2-13-"><td style="white-space:normal; text-align:left;" id="TBL-2-13-1"
-class="td01"><!--l. 3127--><p class="noindent" ><span
-class="cmss-10">sc-short-long-desc</span><a
- id="dx1-14037"></a> </p></td><td style="white-space:normal; text-align:left;" id="TBL-2-13-2"
-class="td10"><!--l. 3127--><p class="noindent" ><a
-href="#abbrstyle.short-sc-long-desc"><span
-class="cmss-10">short-sc-long-desc</span></a><a
- id="dx1-14038"></a> </p></td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-2-14-"><td style="white-space:normal; text-align:left;" id="TBL-2-14-1"
-class="td01"><!--l. 3128--><p class="noindent" ><span
-class="cmss-10">sm-short-long-desc</span><a
- id="dx1-14039"></a> </p></td><td style="white-space:normal; text-align:left;" id="TBL-2-14-2"
-class="td10"><!--l. 3128--><p class="noindent" ><a
-href="#abbrstyle.short-sm-long-desc"><span
-class="cmss-10">short-sm-long-desc</span></a><a
- id="dx1-14040"></a> </p></td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-2-15-"><td style="white-space:normal; text-align:left;" id="TBL-2-15-1"
-class="td01"><!--l. 3129--><p class="noindent" ><span
-class="cmss-10">dua</span><a
- id="dx1-14041"></a> </p></td><td style="white-space:normal; text-align:left;" id="TBL-2-15-2"
-class="td10"><!--l. 3129--><p class="noindent" ><a
-href="#abbrstyle.long-noshort"><span
-class="cmss-10">long-noshort</span></a><a
- id="dx1-14042"></a> </p></td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-2-16-"><td style="white-space:normal; text-align:left;" id="TBL-2-16-1"
-class="td01"><!--l. 3130--><p class="noindent" ><span
-class="cmss-10">dua-desc</span><a
- id="dx1-14043"></a> </p></td><td style="white-space:normal; text-align:left;" id="TBL-2-16-2"
-class="td10"><!--l. 3130--><p class="noindent" ><a
-href="#abbrstyle.long-noshort-desc"><span
-class="cmss-10">long-noshort-desc</span></a><a
- id="dx1-14044"></a> </p></td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-2-17-"><td style="white-space:normal; text-align:left;" id="TBL-2-17-1"
-class="td01"><!--l. 3131--><p class="noindent" ><span
-class="cmss-10">footnote</span><a
- id="dx1-14045"></a> </p></td><td style="white-space:normal; text-align:left;" id="TBL-2-17-2"
-class="td10"><!--l. 3131--><p class="noindent" ><a
-href="#abbrstyle.short-footnote"><span
-class="cmss-10">short-footnote</span></a><a
- id="dx1-14046"></a> </p></td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-2-18-"><td style="white-space:normal; text-align:left;" id="TBL-2-18-1"
-class="td01"><!--l. 3132--><p class="noindent" ><span
-class="cmss-10">footnote-sc</span><a
- id="dx1-14047"></a> </p></td><td style="white-space:normal; text-align:left;" id="TBL-2-18-2"
-class="td10"><!--l. 3132--><p class="noindent" ><a
-href="#abbrstyle.short-sc-footnote"><span
-class="cmss-10">short-sc-footnote</span></a><a
- id="dx1-14048"></a> </p></td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-2-19-"><td style="white-space:normal; text-align:left;" id="TBL-2-19-1"
-class="td01"><!--l. 3133--><p class="noindent" ><span
-class="cmss-10">footnote-sm</span><a
- id="dx1-14049"></a> </p></td><td style="white-space:normal; text-align:left;" id="TBL-2-19-2"
-class="td10"><!--l. 3133--><p class="noindent" ><a
-href="#abbrstyle.short-sm-footnote"><span
-class="cmss-10">short-sm-footnote</span></a><a
- id="dx1-14050"></a> </p></td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-2-20-"><td style="white-space:normal; text-align:left;" id="TBL-2-20-1"
-class="td01"><!--l. 3134--><p class="noindent" ><span
-class="cmss-10">footnote-desc</span><a
- id="dx1-14051"></a> </p></td><td style="white-space:normal; text-align:left;" id="TBL-2-20-2"
-class="td10"><!--l. 3134--><p class="noindent" ><a
-href="#abbrstyle.short-footnote-desc"><span
-class="cmss-10">short-footnote-desc</span></a><a
- id="dx1-14052"></a> </p></td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-2-21-"><td style="white-space:normal; text-align:left;" id="TBL-2-21-1"
-class="td01"><!--l. 3135--><p class="noindent" ><span
-class="cmss-10">footnote-sc-desc</span><a
- id="dx1-14053"></a> </p></td><td style="white-space:normal; text-align:left;" id="TBL-2-21-2"
-class="td10"><!--l. 3135--><p class="noindent" ><a
-href="#abbrstyle.short-sc-footnote-desc"><span
-class="cmss-10">short-sc-footnote-desc</span></a><a
- id="dx1-14054"></a> </p></td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-2-22-"><td style="white-space:normal; text-align:left;" id="TBL-2-22-1"
-class="td01"><!--l. 3136--><p class="noindent" ><span
-class="cmss-10">footnote-sm-desc</span><a
- id="dx1-14055"></a> </p></td><td style="white-space:normal; text-align:left;" id="TBL-2-22-2"
-class="td10"><!--l. 3136--><p class="noindent" ><a
-href="#abbrstyle.short-sm-footnote-desc"><span
-class="cmss-10">short-sm-footnote-desc</span></a><a
- id="dx1-14056"></a> </p></td></tr></table></div>
-
-
-
- </div><hr class="endfloat" />
- </div>
-<!--l. 3140--><p class="indent" > The reason for introducing the new style of abbreviation commands provided by
-<span
-class="cmss-10">glossaries-extra </span>is because the original acronym commands provided by <span
-class="cmss-10">glossaries </span>are
-too restrictive to work with the internal modifications made by <span
-class="cmss-10">glossaries-extra</span>.
-However, if you really want to restore the generic acronym function provided by
-<span
-class="cmss-10">glossaries </span>you can use
-</p><!--l. 3147--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-14057"></a> <span
-class="cmtt-10">\RestoreAcronyms </span></div><hr>
-</p><!--l. 3149--><p class="noindent" >
-(before any use of <span
-class="cmtt-10">\newacronym</span>).
-</p><!--l. 3152--><p class="indent" > <span
-class="cmtt-10">\RestoreAcronyms </span>should not be used in combination with the newer
-<span
-class="cmss-10">glossaries-extra </span>abbreviations. Don&#8217;t combine old and new style entries with the same
-<span
-class="cmss-10">type</span><a
- id="dx1-14058"></a>. The original <span
-class="cmss-10">glossaries </span>acronym mechanism doesn&#8217;t work well with the newer
-<span
-class="cmss-10">glossaries-extra </span>commands.
-</p><!--l. 3158--><p class="indent" > <div class="important" title="Important Note"> If you use <span
-class="cmtt-10">\RestoreAcronyms</span>, don&#8217;t use any of the commands provided by
-<span
-class="cmss-10">glossaries-extra </span>intended for abbreviations (such as <span
-class="cmtt-10">\glsxtrshort</span><a
- id="dx1-14059"></a> or <span
-class="cmtt-10">\glsfmtshort</span><a
- id="dx1-14060"></a>)
-with entries defined via <span
-class="cmtt-10">\newacronym</span><a
- id="dx1-14061"></a> as it will cause unexpected results.
-</div>
-</p><!--l. 3164--><p class="noindent" >
-</p><!--l. 3166--><p class="indent" > In general, there&#8217;s rarely any need for <span
-class="cmtt-10">\RestoreAcronyms</span>. If you have a document
-that uses <span
-class="cmtt-10">\newacronymstyle</span><a
- id="dx1-14062"></a>, then it&#8217;s best to either stick with just <span
-class="cmss-10">glossaries </span>for that
-document or define an equivalent abbreviation style with <span
-class="cmtt-10">\newabbreviationstyle</span><a
- id="dx1-14063"></a>.
-(See <a
-href="#sec:newabbrvstyle"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">4.5</span> </a><a
-href="#sec:newabbrvstyle">Defining New Abbreviation Styles<!--tex4ht:ref: sec:newabbrvstyle --></a> for further
-details.)
-</p><!--l. 3173--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-14064"></a> <span
-class="cmtt-10">\glsacspace{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3175--><p class="noindent" >
-The space command <span
-class="cmtt-10">\glsacspace </span>used by the <span
-class="cmss-10">long-sp-short</span><a
- id="dx1-14065"></a> acronym style provided
-by <span
-class="cmss-10">glossaries </span>is modified so that it uses
-</p><!--l. 3179--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-14066"></a> <span
-class="cmtt-10">\glsacspacemax </span></div><hr>
-</p><!--l. 3181--><p class="noindent" >
-instead of the hard-coded 3em. This is a command not a length and so can be
-changed using <span
-class="cmtt-10">\renewcommand</span>.
-</p><!--l. 3185--><p class="indent" > Any of the new abbreviation styles that use <span
-class="cmtt-10">\glsxtrfullsep</span><a
- id="dx1-14067"></a> (such as <a
-href="#abbrstyle.long-short"><span
-class="cmss-10">long-short</span></a><a
- id="dx1-14068"></a>)
-can easily be changed to use <span
-class="cmtt-10">\glsacspace </span>with
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-103">
-\renewcommand*{\glsxtrfullsep}[1]{\glsacspace{#1}}
-</pre>
-<!--l. 3190--><p class="nopar" >
-</p><!--l. 3192--><p class="indent" > The <a
- id="dx1-14069"></a><a
-href="#glo:firstuse">first use</a> acronym font command
-</p><!--l. 3193--><p class="indent" > <hr><div title="Definition"> <span
-class="cmtt-10">\firstacronymfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3195--><p class="noindent" >
-is redefined to use the <a
- id="dx1-14070"></a>first use abbreviation font command <span
-class="cmtt-10">\glsfirstabbrvfont</span><a
- id="dx1-14071"></a>.
-This will be reset if you use <span
-class="cmtt-10">\RestoreAcronyms</span>.
-</p><!--l. 3200--><p class="indent" > The subsequent use acronym font command
-</p><!--l. 3201--><p class="indent" > <hr><div title="Definition"> <span
-class="cmtt-10">\acronymfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3203--><p class="noindent" >
-is redefined to use the subsequent use abbreviation font command <span
-class="cmtt-10">\glsabbrvfont</span><a
- id="dx1-14072"></a>.
-This will be reset if you use <span
-class="cmtt-10">\RestoreAcronyms</span>.
-</p>
-<!--l. 3208--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.10 </span> <a
- id="sec:glossaries"></a>Glossaries</h3>
-<!--l. 3211--><p class="noindent" >The <span
-class="cmtt-10">\newignoredglossary</span><a
- id="dx1-15001"></a><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmti-10">type</span>&#x27E9;<span
-class="cmtt-10">} </span>command now (as from v1.11) has a starred
-version that doesn&#8217;t automatically switch off the hyperlinks. This starred version may
-be used with the <a
-href="#catattr.targeturl"><span
-class="cmss-10">targeturl</span></a><a
- id="dx1-15002"></a> attribute to create a link to an external URL. (See
-<a
-href="#sec:categories"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">7</span> </a><a
-href="#sec:categories">Categories<!--tex4ht:ref: sec:categories --></a> for further details.) As from v1.12 both the starred and
-unstarred version check that the glossary doesn&#8217;t already exist. (The <span
-class="cmss-10">glossaries</span>
-package omits this check.)
-</p><!--l. 3220--><p class="indent" > You can now provide an ignored glossary with:
-</p><!--l. 3221--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-15003"></a> <span
-class="cmtt-10">\provideignoredglossary{</span>&#x27E8;<span
-class="cmitt-10">type</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3223--><p class="noindent" >
-which will only define the glossary if it doesn&#8217;t already exist. This also has a starred
-version that doesn&#8217;t automatically switch off hyperlinks.
-</p><!--l. 3228--><p class="indent" > The individual glossary displaying commands <span
-class="cmtt-10">\printglossary</span><a
- id="dx1-15004"></a>, <span
-class="cmtt-10">\printnoidxglossary</span><a
- id="dx1-15005"></a>
-and <span
-class="cmtt-10">\printunsrtglossary </span>have extra keys:
-</p>
- <ul class="itemize1">
- <li class="itemize"><span
-class="cmss-10">target</span><a
- id="dx1-15006"></a>. This is a boolean key which can be used to switch off the automatic
- hypertarget for each entry. Unlike <span
-class="cmtt-10">\glsdisablehyper </span>this doesn&#8217;t switch
- off hyperlinks, so any cross-references within the glossary won&#8217;t be affected.
- This is a way of avoiding duplicate target warnings if a glossary needs to
- be displayed multiple times.
-
-
-
- </li>
- <li class="itemize"><span
-class="cmss-10">targetnameprefix</span><a
- id="dx1-15007"></a><span
-class="cmtt-10">={</span>&#x27E8;<span
-class="cmti-10">prefix</span>&#x27E9;<span
-class="cmtt-10">}</span>. Another way of avoiding duplicate target names is to
- set a prefix used for the names. Unlike changing <span
-class="cmtt-10">\glolinkprefix </span>this doesn&#8217;t
- affect any hyperlinks (such as those created with <span
-class="cmtt-10">\gls</span>).
- <!--l. 3244--><p class="noindent" ><div class="important" title="Important Note"> This doesn&#8217;t include the navigation hyper group targets in styles such as
- <span
-class="cmss-10">listhypergroup</span><a
- id="dx1-15008"></a>. The link name for these is given by <span
-class="cmtt-10">\glsnavhyperlinkname</span><a
- id="dx1-15009"></a>.
- </div>
- </p><!--l. 3248--><p class="noindent" >
- </p></li>
- <li class="itemize"><span
-class="cmss-10">prefix</span><a
- id="dx1-15010"></a><span
-class="cmtt-10">={</span>&#x27E8;<span
-class="cmti-10">prefix</span>&#x27E9;<span
-class="cmtt-10">}</span>. If you do actually want to locally change <span
-class="cmtt-10">\glolinkprefix</span>, you
- can use the <span
-class="cmss-10">prefix</span><a
- id="dx1-15011"></a> key instead. You need to use the matching <span
-class="cmss-10">prefix</span><a
- id="dx1-15012"></a> key in
- commands like <span
-class="cmtt-10">\gls</span>.
- </li>
- <li class="itemize"><span
-class="cmss-10">label</span><a
- id="dx1-15013"></a><span
-class="cmtt-10">={</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>. Labels the glossary with <span
-class="cmtt-10">\label{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span>and also defines
- <span
-class="cmtt-10">\@currentlabelname </span>to the glossary&#8217;s TOC title (to provide text for
- <span
-class="cmtt-10">\nameref</span>). You can also set the label before the glossary using:
- <!--l. 3262--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-15014"></a> <span
-class="cmtt-10">\glsxtrsetglossarylabel{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
- </p><!--l. 3264--><p class="noindent" >
- but take care of duplicate labels if it&#8217;s not scoped.
- </p></li>
- <li class="itemize"><span
-class="cmss-10">groups</span><a
- id="dx1-15015"></a>. This is a boolean key (new to v1.44) designed for use with
- <span
-class="cmtt-10">\printunsrtglossary </span>(and other <span
-class="cmtt-10">\printunsrt</span><span
-class="cmtt-10">&#x2026; </span>variations). It has no effect
- with <span
-class="cmtt-10">\printglossary </span>and <span
-class="cmtt-10">\printnoidxglossary</span>.
- <!--l. 3273--><p class="noindent" >If true (default), group formation (group header and group skip) will be
- attempted if the <span
-class="cmss-10">group</span><a
- id="dx1-15016"></a> key has been defined and set. Note that some styles
- ignore the header and group skip commands so there may not be a noticeable
- difference in those cases. If this key is set to false, no group formation will
- occur so there won&#8217;t be any group markup to separate letter groups so
- there will be no visual separation regardless of style or the group skip
- setting.
- </p></li>
- <li class="itemize"><span
-class="cmss-10">leveloffset</span><a
- id="dx1-15017"></a>. This key (new to v1.44) is designed for use with <span
-class="cmtt-10">\printunsrtglossary</span>
- (and other <span
-class="cmtt-10">\printunsrt</span><span
-class="cmtt-10">&#x2026; </span>variations). It has no effect with <span
-class="cmtt-10">\printglossary</span>
- and <span
-class="cmtt-10">\printnoidxglossary</span>.
- <!--l. 3287--><p class="noindent" >The value may either be a simple integer &#x27E8;<span
-class="cmti-10">n</span>&#x27E9; to indicate assignment or in the
- form <span
-class="cmtt-10">++</span>&#x27E8;<span
-class="cmitt-10">n</span>&#x27E9; to indicate an increment. This will locally assign or increment the
- level offset. The default value is&#x00A0;0. This will cause entries to be displayed as
- though their hierarchical level is <span
-class="cmmi-10">N </span>more than it would normally be (where <span
-class="cmmi-10">N </span>is
- the level offset). For example, a top-level entry (that is, an entry without a
- parent) would normally have a hierarchical level of&#x00A0;0. With a level offset of&#x00A0;1,
-
-
-
- it would be treated by the glossary style as though it was actually a
- level&#x00A0;1 entry. (Remember that some styles don&#8217;t support hierarchical
- glossaries.)
- </p><!--l. 3298--><p class="noindent" >Note that the group formation (if supported) will still occur between entries
- that don&#8217;t have a parent, regardless of the level offset. This can cause odd
- results but can be switched off with <span
-class="cmss-10">groups</span><a
- id="dx1-15018"></a>. See <a
-href="https://dickimaw-books.com/gallery/index.php?label=bib2gls-inner" >Gallery: Inner or Nested
- Glossaries</a> for an example.</p></li></ul>
-<!--l. 3305--><p class="noindent" >
-</p>
-<!--l. 3305--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.11 </span> <a
- id="sec:glosstylemods"></a>Glossary Style Modifications</h3>
-<!--l. 3308--><p class="noindent" >The <span
-class="cmss-10">glossaries-extra-stylemods</span><a
- id="dx1-16001"></a> package (more conveniently loaded through the
-<span
-class="cmss-10">glossaries-extra </span><a
-href="#styopt.stylemods"><span
-class="cmss-10">stylemods</span></a><a
- id="dx1-16002"></a> option) modifies some of the predefined styles that are
-provided with the <span
-class="cmss-10">glossaries </span>package. These modifications are described in more detail
-in <a
-href="#sec:stylemods"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.11.3</span> </a><a
-href="#sec:stylemods">The glossaries-extra-stylemods Package<!--tex4ht:ref: sec:stylemods --></a>.
-</p><!--l. 3315--><p class="indent" > The <span
-class="cmss-10">glossaries</span><a
- id="dx1-16003"></a> package tries to determine the group title from its label by first
-checking if <span
-class="cmtt-10">\</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">groupname </span>exists. If it doesn&#8217;t exist, then the title is assumed to be
-the same as the label. For example, when typesetting the &#8220;A&#8221; letter group, <span
-class="cmss-10">glossaries</span><a
- id="dx1-16004"></a>
-first checks if <span
-class="cmtt-10">\Agroupname </span>exists. This could potentially cause conflict with another
-package that may have some other meaning for <span
-class="cmtt-10">\Agroupname</span>, so <span
-class="cmss-10">glossaries-extra</span><a
- id="dx1-16005"></a> first
-checks for the existence of the internal command <span
-class="cmtt-10">\glsxtr@grouptitle@</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;
-which shouldn&#8217;t clash with another package. You can set the group title
-using
-</p><!--l. 3327--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-16006"></a> <span
-class="cmtt-10">\glsxtrsetgrouptitle{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">title</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3329--><p class="noindent" >
-For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-104">
-\glsxtrsetgrouptitle{A}{A&#x00A0;(a)}
-</pre>
-<!--l. 3333--><p class="nopar" > This uses a global assignment. If you need to scope the change you can
-use
-</p><!--l. 3336--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-16007"></a> <span
-class="cmtt-10">\glsxtrlocalsetgrouptitle{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">title</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3338--><p class="noindent" >
-</p><!--l. 3340--><p class="noindent" >
-</p>
-<!--l. 3340--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">2.11.1 </span> <a
- id="sec:stylehooks"></a>Style Hooks</h4>
-<!--l. 3343--><p class="noindent" >The commands <span
-class="cmtt-10">\glossentryname</span><a
- id="dx1-17001"></a> and <span
-class="cmtt-10">\glossentrydesc</span><a
- id="dx1-17002"></a> are modified to take into
-account the <a
-href="#catattr.glossname"><span
-class="cmss-10">glossname</span></a><a
- id="dx1-17003"></a>, <a
-href="#catattr.glossnamefont"><span
-class="cmss-10">glossnamefont</span></a><a
- id="dx1-17004"></a>, <a
-href="#catattr.glossdesc"><span
-class="cmss-10">glossdesc</span></a><a
- id="dx1-17005"></a> and <a
-href="#catattr.glossdescfont"><span
-class="cmss-10">glossdescfont</span></a><a
- id="dx1-17006"></a> attributes (see
-<a
-href="#sec:categories"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">7</span> </a><a
-href="#sec:categories">Categories<!--tex4ht:ref: sec:categories --></a>). This means you can make simple font or case-changing
-modifications to the name and description without defining a new glossary
-style.
-</p><!--l. 3350--><p class="indent" > (New to version 1.42.) The command <span
-class="cmtt-10">\glossentrysymbol</span><a
- id="dx1-17007"></a> is modified to take into
-account the <a
-href="#catattr.glosssymbolfont"><span
-class="cmss-10">glosssymbolfont</span></a><a
- id="dx1-17008"></a> attribute. Note that, unlike the above, there&#8217;s no
-corresponding attribute to change the case as it&#8217;s usually not appropriate to change
-the case of a symbol (and for some symbols, such as pictographs, there&#8217;s no concept
-of case). If <span
-class="cmtt-10">\texorpdfstring</span><a
- id="dx1-17009"></a> has been defined <span
-class="cmtt-10">\glossentrysymbol</span><a
- id="dx1-17010"></a> will be defined to
-do: </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\texorpdfstring</span><a
- id="dx1-17011"></a><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">TeX</span><span
-class="cmitt-10">&#x00A0;code</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">PDF</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div>
-</div> The &#x27E8;<span
-class="cmti-10">TeX</span><span
-class="cmti-10">&#x00A0;code</span>&#x27E9; part is robust and deals with the actual typesetting of the symbol.
-The &#x27E8;<span
-class="cmti-10">PDF</span>&#x27E9; part is simply:
-<!--l. 3363--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-17012"></a> <span
-class="cmtt-10">\glsentrypdfsymbol{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3365--><p class="noindent" >
-which is defined to just do <span
-class="cmtt-10">\glsentrysymbol{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>. The chances are that the code
-in the <span
-class="cmss-10">symbol</span><a
- id="dx1-17013"></a> key won&#8217;t be valid in the PDF bookmarks, so you can redefine
-<span
-class="cmtt-10">\glsentrypdfsymbol </span>to use a more appropriate field. (If you do redefine this
-command, remember that it needs to fully expand.)
-</p><!--l. 3372--><p class="indent" > For example, if you are using <span
-class="cmss-10">glossaries-accsupp</span><a
- id="dx1-17014"></a>, you could use the <span
-class="cmss-10">symbolaccess</span><a
- id="dx1-17015"></a>
-field:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-105">
-\renewcommand{\glsentrypdfsymbol}[1]{\glsentrysymbolaccess{#1}}
-</pre>
-<!--l. 3376--><p class="nopar" > Alternatively, if you are using <a
- id="dx1-17016"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> you can use the TeX&#x00A0;parser library to
-interpret a copy of the <span
-class="cmss-10">symbol</span><a
- id="dx1-17017"></a> field and use that. For example, with the resource
-options:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-106">
-&#x00A0;&#x00A0;replicate-fields={symbol=user1},
-&#x00A0;&#x00A0;interpret-fields={user1}
-</pre>
-<!--l. 3383--><p class="nopar" > This stores the interpreted value of the symbol in the <span
-class="cmss-10">user1</span><a
- id="dx1-17018"></a> field, so you can then
-do:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-107">
-\renewcommand{\glsentrypdfsymbol}[1]{\glsentryuseri{#1}}
-</pre>
-<!--l. 3388--><p class="nopar" > (You may need <span class="HoLogo-XeLaTeX"><span class="HoLogo-Xe">X<span class="HoLogo-e">&#x018e;</span></span><span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span></span>&#x00A0;or Lua<span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span>&#x00A0;with this method.) This allows
-<span
-class="cmtt-10">\glossentrysymbol </span>to be used in a section heading with standalone definitions.
-</p><!--l. 3393--><p class="indent" > If you want to adapt a style to use another field instead of <span
-class="cmss-10">name</span><a
- id="dx1-17019"></a>, you can
-use
-</p><!--l. 3395--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-17020"></a> <span
-class="cmtt-10">\glossentrynameother{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3397--><p class="noindent" >
-This behaves just like <span
-class="cmtt-10">\glossentryname </span>(that is, it obeys the <a
-href="#catattr.glossname"><span
-class="cmss-10">glossname</span></a><a
- id="dx1-17021"></a> attribute,
-uses either the <a
-href="#catattr.glossnamefont"><span
-class="cmss-10">glossnamefont</span></a><a
- id="dx1-17022"></a> attribute or <span
-class="cmtt-10">\glsnamefont </span>to format the text, and uses
-the post-name hook) but it uses the given &#x27E8;<span
-class="cmti-10">field</span>&#x27E9; instead of <span
-class="cmss-10">name</span><a
- id="dx1-17023"></a>. The &#x27E8;<span
-class="cmti-10">field</span>&#x27E9;
-argument must be the internal field name (for example <span
-class="cmtt-10">desc </span>rather than
-<span
-class="cmtt-10">description</span>). See the key to field mappings table in the <span
-class="cmss-10">glossaries </span>user
-manual.
-</p><!--l. 3406--><p class="indent" > There is a hook after <span
-class="cmtt-10">\glossentryname</span><a
- id="dx1-17024"></a> and <span
-class="cmtt-10">\Glossentryname</span><a
- id="dx1-17025"></a>:
-</p><!--l. 3408--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-17026"></a> <span
-class="cmtt-10">\glsxtrpostnamehook{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3410--><p class="noindent" >
-By default this checks the <a
-href="#catattr.indexname"><span
-class="cmss-10">indexname</span></a><a
- id="dx1-17027"></a> attribute. If the attribute exists for the
-category to which the label belongs, then the name is automatically indexed
-using
-</p><!--l. 3415--><p class="indent" > <hr><div title="Definition"><span
-class="cmtt-10">\glsxtrdoautoindexname</span><a
- id="dx1-17028"></a><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">indexname</span><span
-class="cmsy-10">} </span></div><hr>
-</p><!--l. 3416--><p class="noindent" >
-See <a
-href="#sec:autoindex"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">9</span> </a><a
-href="#sec:autoindex">Auto-Indexing<!--tex4ht:ref: sec:autoindex --></a> for further details.
-</p><!--l. 3420--><p class="indent" > As from version 1.04, the post-name hook <span
-class="cmtt-10">\glsxtrpostnamehook </span>will also use
-<span
-class="cmtt-10">\glsxtrpostname</span>&#x27E8;<span
-class="cmti-10">category</span>&#x27E9; if it exists. You can use <span
-class="cmtt-10">\glscurrententrylabel</span><a
- id="dx1-17029"></a> to
-obtain the entry label with the definition of this command. For example,
-suppose you are using a glossary style the doesn&#8217;t display the symbol, you can
-insert the symbol after the name for a particular category, say, the &#8220;symbol&#8221;
-category:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-108">
-\newcommand*{\glsxtrpostnamesymbol}{\space
-&#x00A0;(\glsentrysymbol{\glscurrententrylabel})}
-</pre>
-<!--l. 3431--><p class="nopar" > For convenience, as from v1.31, you can use
-</p><!--l. 3433--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-17030"></a> <span
-class="cmtt-10">\glsdefpostname{</span>&#x27E8;<span
-class="cmitt-10">category</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">definition</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3435--><p class="noindent" >
-This is simply a shortcut for: </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\csdef</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">glsxtrpostname</span>&#x27E8;<span
-class="cmitt-10">category</span>&#x27E9;<span
-class="cmsy-10">}</span><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">definition</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div>
-</div> Note that it doesn&#8217;t check if the command has already been defined.
-<!--l. 3442--><p class="indent" > As from version 1.25, the post-name hook also does
-</p><!--l. 3443--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-17031"></a> <span
-class="cmtt-10">\glsextrapostnamehook{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3445--><p class="noindent" >
-(before <span
-class="cmtt-10">\glsxtrpostname</span>&#x27E8;<span
-class="cmti-10">category</span>&#x27E9;) to allow for additional non-category related code.
-This does nothing by default.
-</p><!--l. 3450--><p class="indent" > The post-description code used within the glossary is modified so that it also
-does
-</p><!--l. 3452--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-17032"></a> <span
-class="cmtt-10">\glsxtrpostdescription </span></div><hr>
-</p><!--l. 3454--><p class="noindent" >
-This occurs before the original <span
-class="cmtt-10">\glspostdescription</span>, so if the <a
-href="#styopt.nopostdot"><span
-class="cmss-10">nopostdot</span></a><span
-class="cmss-10">=false</span><a
- id="dx1-17033"></a>
-option is used, it will be inserted before the terminating full stop.
-</p><!--l. 3459--><p class="indent" > This new command will do <span
-class="cmtt-10">\glsxtrpostdesc</span>&#x27E8;<span
-class="cmitt-10">category</span>&#x27E9; if it exists, where
-&#x27E8;<span
-class="cmti-10">category</span>&#x27E9; is the category label associated with the current entry. For example
-<span
-class="cmtt-10">\glsxtrpostdescgeneral </span>for entries with the category set to <span
-class="cmss-10">general</span><a
- id="dx1-17034"></a> or
-<span
-class="cmtt-10">\glsxtrpostdescacronym </span>for entries with the category set to <span
-class="cmss-10">acronym</span><a
- id="dx1-17035"></a>. For
-convenience, as from v1.31, you can use
-</p><!--l. 3466--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-17036"></a> <span
-class="cmtt-10">\glsdefpostdesc{</span>&#x27E8;<span
-class="cmitt-10">category</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">definition</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3468--><p class="noindent" >
-This is simply a shortcut for: </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\csdef</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">glsxtrpostdesc</span>&#x27E8;<span
-class="cmitt-10">category</span>&#x27E9;<span
-class="cmsy-10">}</span><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">definition</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div>
-</div> Note that it doesn&#8217;t check if the command has already been defined.
-<!--l. 3475--><p class="indent" > Since both <span
-class="cmtt-10">\glossentry </span>and <span
-class="cmtt-10">\subglossentry </span>set
-</p><!--l. 3476--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-17037"></a> <span
-class="cmtt-10">\glscurrententrylabel </span></div><hr>
-
-
-
-</p><!--l. 3478--><p class="noindent" >
-to the label for the current entry, you can use this within the definition of these
-post-description hooks if you need to reference the label.
-</p><!--l. 3483--><p class="indent" > For example, suppose you want to insert the plural form in brackets after the
-description in the glossary, but only for entries in the <span
-class="cmss-10">general</span><a
- id="dx1-17038"></a> category, then you could
-do:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-109">
-\renewcommand{\glsxtrpostdescgeneral}{\space
-&#x00A0;(plural:&#x00A0;\glsentryplural{\glscurrententrylabel})}
-</pre>
-<!--l. 3489--><p class="nopar" > This means you don&#8217;t have to define a custom glossary style, which you may find
-more complicated. (It also allows more flexibility if you decide to change the
-underlying glossary style.)
-</p><!--l. 3494--><p class="indent" > <div class="important" title="Important Note"> This feature can&#8217;t be used for glossary styles that ignore <span
-class="cmtt-10">\glspostdescription </span>or if
-you redefine <span
-class="cmtt-10">\glspostdescription </span>without including <span
-class="cmtt-10">\glsxtrpostdescription</span>.
-(For example, if you redefine <span
-class="cmtt-10">\glspostdescription </span>to do nothing instead of using
-the <a
-href="#styopt.nopostdot"><span
-class="cmss-10">nopostdot</span></a><a
- id="dx1-17039"></a> option to suppress the terminating full stop.) See <a
-href="#sec:stylemods"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.11.3</span> </a><a
-href="#sec:stylemods">The
-glossaries-extra-stylemods Package<!--tex4ht:ref: sec:stylemods --></a> to patch the predefined styles provided by
-<span
-class="cmss-10">glossaries </span>that are missing <span
-class="cmtt-10">\glspostdescription</span>. </div>
-</p><!--l. 3503--><p class="noindent" >
-</p><!--l. 3505--><p class="noindent" >
-</p>
-<!--l. 3505--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">2.11.2 </span> <a
- id="sec:glosstylenumlist"></a>Number List</h4>
-<!--l. 3508--><p class="noindent" >The <a
- id="dx1-18001"></a><a
-href="#glo:numberlist">number list</a> is now placed inside the argument of
-</p><!--l. 3509--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-18002"></a> <span
-class="cmtt-10">\GlsXtrFormatLocationList{</span>&#x27E8;<span
-class="cmitt-10">number list</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3511--><p class="noindent" >
-This is internally used by <span
-class="cmtt-10">\glossaryentrynumbers</span>. The <a
-href="#styopt.nonumberlist"><span
-class="cmss-10">nonumberlist</span></a><a
- id="dx1-18003"></a> option
-redefines <span
-class="cmtt-10">\glossaryentrynumbers </span>so that it doesn&#8217;t display the <a
- id="dx1-18004"></a>number list, but it
-still saves the <a
- id="dx1-18005"></a>number list in case it&#8217;s required.
-</p><!--l. 3517--><p class="indent" > <div class="important" title="Important Note"> If you want to suppress the <a
- id="dx1-18006"></a>number list always use the <a
-href="#styopt.nonumberlist"><span
-class="cmss-10">nonumberlist</span></a><a
- id="dx1-18007"></a> option
-instead of redefining <span
-class="cmtt-10">\glossaryentrynumbers </span>to do nothing. </div>
-</p><!--l. 3521--><p class="noindent" >
-</p><!--l. 3523--><p class="indent" > For example, to change the font for the entire <a
- id="dx1-18008"></a>number list redefine
-<span
-class="cmtt-10">\GlsXtrFormatLocationList </span>as appropriate. Don&#8217;t modify <span
-class="cmtt-10">\glossaryentrynumbers</span>.
-</p><!--l. 3527--><p class="indent" > Sometimes users like to insert &#8220;page&#8221; or &#8220;pages&#8221; in front of the <a
- id="dx1-18009"></a>number list. This
-is quite fiddly to do with the base <span
-class="cmss-10">glossaries </span>package, but <span
-class="cmss-10">glossaries-extra </span>provides a
-way of doing this. First you need to enable this option and specify the text to display
-using:
-</p><!--l. 3532--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-18010"></a> <span
-class="cmtt-10">\GlsXtrEnablePreLocationTag{</span>&#x27E8;<span
-class="cmitt-10">page</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">pages</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3534--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">page</span>&#x27E9; is the text to display if the <a
- id="dx1-18011"></a>number list only contains a single location and
-&#x27E8;<span
-class="cmti-10">pages</span>&#x27E9; is the text to display otherwise. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-110">
-\GlsXtrEnablePreLocationTag{Page:&#x00A0;}{Pages:&#x00A0;}
-</pre>
-<!--l. 3540--><p class="nopar" > An extra run is required when using this command.
-</p><!--l. 3543--><p class="indent" > <div class="important" title="Important Note"> Use <span
-class="cmtt-10">glsignore </span>not <span
-class="cmtt-10">@gobble </span>as the format if you want to suppress the page
-number (and only index the entry once). </div>
-</p><!--l. 3546--><p class="noindent" >
-</p><!--l. 3548--><p class="indent" > See the accompanying sample file <span
-class="cmtt-10">sample-pages.tex</span>.
-</p><!--l. 3550--><p class="indent" > Note that <a
- id="dx1-18012"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> can be instructed to insert a prefix at the start of non-empty
-location lists, which can be used as an alternative to <span
-class="cmtt-10">\GlsXtrEnablePreLocationTag</span>.
-</p><!--l. 3554--><p class="indent" > <a
- id="dx1-18013"></a><a
-href="#glo:locationlist">Location lists</a> displayed with <span
-class="cmtt-10">\printnoidxglossary </span>internally use
-</p><!--l. 3556--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-18014"></a> <span
-class="cmtt-10">\glsnoidxdisplayloc{</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">counter</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">format</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3558--><p class="noindent" >
-This command is provided by <span
-class="cmss-10">glossaries</span>, but is modified by <span
-class="cmss-10">glossaries-extra </span>to check
-for the start and end range formation identifiers <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">(</span></span></span> and <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">)</span></span></span> which are discarded to
-obtain the actual control sequence name that forms the location formatting
-command.
-</p><!--l. 3565--><p class="indent" > If the range identifiers aren&#8217;t present, this just uses
-</p><!--l. 3566--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-18015"></a> <span
-class="cmtt-10">\glsxtrdisplaysingleloc{</span>&#x27E8;<span
-class="cmitt-10">format</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3568--><p class="noindent" >
-otherwise it uses
-</p><!--l. 3570--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-18016"></a> <span
-class="cmtt-10">\glsxtrdisplaystartloc{</span>&#x27E8;<span
-class="cmitt-10">format</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3572--><p class="noindent" >
-for the start of a range (where the identifier has been stripped from &#x27E8;<span
-class="cmti-10">format</span>&#x27E9;)
-or
-</p><!--l. 3575--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-18017"></a> <span
-class="cmtt-10">\glsxtrdisplayendloc{</span>&#x27E8;<span
-class="cmitt-10">format</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3577--><p class="noindent" >
-for the end of a range (where the identifier has been stripped from &#x27E8;<span
-class="cmti-10">format</span>&#x27E9;).
-</p><!--l. 3581--><p class="indent" > By default the start range command saves the format in
-</p><!--l. 3582--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-18018"></a> <span
-class="cmtt-10">\glsxtrlocrangefmt </span></div><hr>
-</p><!--l. 3584--><p class="noindent" >
-and does <spacer type=vertical size=10><span class="obeylines-h">
- <br /><span
-class="cmtt-10">\glsxtrdisplaysingleloc{</span>&#x27E8;<span
-class="cmti-10">format</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmti-10">location</span>&#x27E9;<span
-class="cmtt-10">}</span>
- <br /><spacer type=vertical size=10></span>
-(If the format is empty, it will be replaced with <span
-class="cmtt-10">glsnumberformat</span>.)
-</p><!--l. 3592--><p class="indent" > The end command checks that the format matches the start of the range,
-does
-</p><!--l. 3594--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-18019"></a> <span
-class="cmtt-10">\glsxtrdisplayendlochook{</span>&#x27E8;<span
-class="cmitt-10">format</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3596--><p class="noindent" >
-(which does nothing by default), followed by <spacer type=vertical size=10><span class="obeylines-h">
- <br /><span
-class="cmtt-10">\glsxtrdisplaysingleloc{</span>&#x27E8;<span
-class="cmti-10">format</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmti-10">location</span>&#x27E9;<span
-class="cmtt-10">}</span>
-
-
-
- <br /><spacer type=vertical size=10></span>
-and then sets <span
-class="cmtt-10">\glsxtrlocrangefmt </span>to empty.
-</p><!--l. 3603--><p class="indent" > This means that the list
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-111">
-\glsnoidxdisplayloc{}{page}{(textbf}{1},
-\glsnoidxdisplayloc{}{page}{textbf}{1},
-\glsnoidxdisplayloc{}{page}{)textbf}{1}.
-</pre>
-<!--l. 3608--><p class="nopar" > doesn&#8217;t display any differently from
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-112">
-\glsnoidxdisplayloc{}{page}{textbf}{1},
-\glsnoidxdisplayloc{}{page}{textbf}{1},
-\glsnoidxdisplayloc{}{page}{textbf}{1}.
-</pre>
-<!--l. 3614--><p class="nopar" > but it does make it easier to define your own custom list handler that can
-accommodate the ranges.
-</p><!--l. 3618--><p class="noindent" >
-</p>
-<!--l. 3618--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">2.11.3 </span> <a
- id="sec:stylemods"></a>The glossaries-extra-stylemods Package</h4>
-<!--l. 3621--><p class="noindent" >As from v1.02, <span
-class="cmss-10">glossaries-extra </span>now includes the package <span
-class="cmss-10">glossaries-extra-stylemods</span><a
- id="dx1-19001"></a> that
-will redefine the predefined styles to include the post-description hook (for those that
-are missing it). You will need to make sure the styles have already been defined
-before loading <span
-class="cmss-10">glossaries-extra</span>. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-113">
-\usepackage{glossaries-extra}
-\usepackage{glossary-longragged}
-\usepackage{glossaries-extra-stylemods}
-</pre>
-<!--l. 3630--><p class="nopar" > Alternatively you can load <span
-class="cmtt-10">glossary-</span>&#x27E8;<span
-class="cmti-10">name</span>&#x27E9;<span
-class="cmtt-10">.sty </span>at the same time by passing &#x27E8;<span
-class="cmti-10">name</span>&#x27E9;
-as a package option to <span
-class="cmss-10">glossaries-extra-stylemods</span><a
- id="dx1-19002"></a>. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-114">
-\usepackage{glossaries-extra}
-\usepackage[longragged]{glossaries-extra-stylemods}
-</pre>
-<!--l. 3638--><p class="nopar" > Another option is to use the <a
-href="#styopt.stylemods"><span
-class="cmss-10">stylemods</span></a><a
- id="dx1-19003"></a> key when you load <span
-class="cmss-10">glossaries-extra</span>. You can
-omit a value if you only want to use the predefined styles that are automatically
-loaded by <span
-class="cmss-10">glossaries </span>(for example, the <span
-class="cmss-10">long3col</span><a
- id="dx1-19004"></a> style):
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-115">
-\usepackage[style=long3col,stylemods]{glossaries-extra}
-</pre>
-<!--l. 3645--><p class="nopar" > Or the value of <a
-href="#styopt.stylemods"><span
-class="cmss-10">stylemods</span></a><a
- id="dx1-19005"></a> may be a comma-separated list of the style package
-identifiers. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-116">
-\usepackage[style=mcoltree,stylemods=mcols]{glossaries-extra}
-</pre>
-<!--l. 3650--><p class="nopar" > Remember to group the value if it contains any commas:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-117">
-\usepackage[stylemods={mcols,longbooktabs}]{glossaries-extra}
-</pre>
-<!--l. 3654--><p class="nopar" >
-</p>
-<!--l. 3656--><p class="noindent" ><span class="paragraphHead"><a
- id="x1-200002.11.3"></a><span
-class="cmbx-10">Inline Style</span></span>
- Note that the <span
-class="cmss-10">inline</span><a
- id="dx1-20001"></a> style is dealt with slightly differently. The original definition
-provided by the <span
-class="cmss-10">glossary-inline</span><a
- id="dx1-20002"></a> package uses <span
-class="cmtt-10">\glspostdescription </span>at the end of the
-glossary (not after each entry description) within the definition of <span
-class="cmtt-10">\glspostinline</span>.
-The style modification changes this so that <span
-class="cmtt-10">\glspostinline </span>just does a full stop
-followed by space factor adjustment, and the description <span
-class="cmtt-10">\glsinlinedescformat </span>and
-sub-entry description formats <span
-class="cmtt-10">\glsinlinesubdescformat </span>are redefined to include
-<span
-class="cmtt-10">\glsxtrpostdescription </span>(not <span
-class="cmtt-10">\glspostdescription</span>). This means that the
-modified <span
-class="cmss-10">inline</span><a
- id="dx1-20003"></a> style isn&#8217;t affected by the <a
-href="#styopt.nopostdot"><span
-class="cmss-10">nopostdot</span></a><a
- id="dx1-20004"></a> option, but the post-description
-category hook can still be used.
-</p>
-<!--l. 3672--><p class="noindent" ><span class="paragraphHead"><a
- id="x1-210002.11.3"></a><span
-class="cmbx-10">Tabular Styles</span></span>
- The <span
-class="cmss-10">tabular</span><a
- id="dx1-21001"></a><a
- id="dx1-21002"></a>-like styles, such as <span
-class="cmss-10">long</span><a
- id="dx1-21003"></a> are adjusted so that the <span
-class="cmtt-10">\ifglsnogroupskip</span><a
- id="dx1-21004"></a>
-conditional (set with <a
-href="#styopt.nogroupskip"><span
-class="cmss-10">nogroupskip</span></a><a
- id="dx1-21005"></a>) is moved outside of the definition of
-<span
-class="cmtt-10">\glsgroupskip </span>to avoid problems that cause an &#8220;Incomplete <span
-class="cmtt-10">\iftrue</span>&#8221; error with
-<span
-class="cmtt-10">\printunsrtglossary </span>and <span
-class="cmtt-10">\printnoidxglossary</span>. This means that if you want to
-change this conditional using <span
-class="cmtt-10">\setupglossaries </span>or using the <span
-class="cmss-10">nogroupskip</span><a
- id="dx1-21006"></a> option in
-<span
-class="cmtt-10">\printglossary</span>, <span
-class="cmtt-10">\printnoidxglossary </span>or <span
-class="cmtt-10">\printunsrtglossary</span>, you must also
-reset the glossary style.
-</p><!--l. 3685--><p class="indent" > As from version 1.21, the hard-coded <span
-class="cmtt-10">\space </span>before the <a
- id="dx1-21007"></a><a
-href="#glo:numberlist">number list</a> in many of
-the predefined styles is replaced with
-</p><!--l. 3688--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-21008"></a> <span
-class="cmtt-10">\glsxtrprelocation </span></div><hr>
-</p><!--l. 3690--><p class="noindent" >
-This just defaults to <span
-class="cmtt-10">\space </span>but may be redefined as required. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-118">
-\renewcommand{\glsxtrprelocation}{\dotfill}
-</pre>
-<!--l. 3695--><p class="nopar" >
-</p>
-<!--l. 3697--><p class="noindent" ><span class="paragraphHead"><a
- id="x1-220002.11.3"></a><span
-class="cmbx-10">List Styles</span></span>
- The <span
-class="cmss-10">list</span><a
- id="dx1-22001"></a> styles use
-</p><!--l. 3700--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22002"></a> <span
-class="cmtt-10">\glslistprelocation </span></div><hr>
-</p><!--l. 3702--><p class="noindent" >
-(which defaults to <span
-class="cmtt-10">\glsxtrprelocation</span>) for top-level items and
-</p><!--l. 3704--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22003"></a> <span
-class="cmtt-10">\glslistchildprelocation </span></div><hr>
-</p><!--l. 3706--><p class="noindent" >
-(which defaults to <span
-class="cmtt-10">\glslistprelocation</span>) for child items.
-</p><!--l. 3709--><p class="indent" > As from v1.31, the description (including the post-description hook) is governed
-by:
-</p><!--l. 3711--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22004"></a> <span
-class="cmtt-10">\glslistdesc{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3713--><p class="noindent" >
-for the <span
-class="cmss-10">list</span><a
- id="dx1-22005"></a> and <span
-class="cmss-10">altlist</span><a
- id="dx1-22006"></a> styles (but not the <span
-class="cmss-10">listdotted</span><a
- id="dx1-22007"></a> variations).
-</p><!--l. 3717--><p class="indent" > As from v1.47, the item is governed by:
-</p><!--l. 3718--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22008"></a> <span
-class="cmtt-10">\glslistitem{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3720--><p class="noindent" >
-The <span
-class="cmss-10">altlist</span><a
- id="dx1-22009"></a> styles use:
-</p><!--l. 3722--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22010"></a> <span
-class="cmtt-10">\glsaltlistitem{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3724--><p class="noindent" >
-which internally uses <span
-class="cmtt-10">\glslistitem</span>. The header item (for the list styles that should
-the group title) is governed by:
-</p><!--l. 3727--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22011"></a> <span
-class="cmtt-10">\glslistgroupheaderitem{</span>&#x27E8;<span
-class="cmitt-10">group-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">header code</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3729--><p class="noindent" >
-This ignores the &#x27E8;<span
-class="cmti-10">group-label</span>&#x27E9; by default and simply places the second argument in the
-optional argument of <span
-class="cmtt-10">\item</span>. The &#x27E8;<span
-class="cmti-10">header code</span>&#x27E9; is the formatted group title,
-possibly including a hypertarget. The spacing after the group item is given
-by:
-</p><!--l. 3734--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22012"></a> <span
-class="cmtt-10">\glslistgroupafterheader </span></div><hr>
-</p><!--l. 3736--><p class="noindent" >
-</p><!--l. 3738--><p class="indent" > For just the <span
-class="cmss-10">list</span><a
- id="dx1-22013"></a> style and its letter group variations (not the <span
-class="cmss-10">altlist</span><a
- id="dx1-22014"></a> or <span
-class="cmss-10">listdotted</span><a
- id="dx1-22015"></a>
-variations) the <a
- id="dx1-22016"></a><a
-href="#glo:numberlist">number list</a> for child entries is followed by
-</p><!--l. 3741--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22017"></a> <span
-class="cmtt-10">\glslistchildpostlocation </span></div><hr>
-</p><!--l. 3743--><p class="noindent" >
-which defaults to a full stop.
-
-
-
-</p><!--l. 3746--><p class="indent" > The default value of <span
-class="cmtt-10">\glslistdottedwidth</span><a
- id="dx1-22018"></a> is changed so that it&#8217;s set at the start
-of the document (if it hasn&#8217;t been changed in the preamble). This should
-take into account situations where <span
-class="cmtt-10">\hsize </span>isn&#8217;t set until the start of the
-document.
-</p><!--l. 3751--><p class="indent" > The separator between groups (if not <a
-href="#styopt.nogroupskip"><span
-class="cmss-10">nogroupskip</span></a><a
- id="dx1-22019"></a>) is now given by:
-</p><!--l. 3753--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22020"></a> <span
-class="cmtt-10">\glslistgroupskip </span></div><hr>
-</p><!--l. 3755--><p class="noindent" >
-This defaults to <span
-class="cmtt-10">\indexspace </span>with penalties to deter page breaks. This command
-isn&#8217;t used if <a
-href="#styopt.nogroupskip"><span
-class="cmss-10">nogroupskip</span></a><a
- id="dx1-22021"></a> is set.
-</p><!--l. 3760--><p class="indent" > The <span
-class="cmss-10">glossary-tree</span><a
- id="dx1-22022"></a> package introduced new commands in v4.22, <span
-class="cmtt-10">\glstreegroupheaderfmt</span><a
- id="dx1-22023"></a>
-and <span
-class="cmtt-10">\glstreenavigationfmt</span><a
- id="dx1-22024"></a>, which are used to format the letter group
-headings and the navigation elements for the appropriate styles. These two
-new commands are defined in terms of <span
-class="cmtt-10">\glstreenamefmt</span><a
- id="dx1-22025"></a> since that was
-the command originally used for the group headings and navigation. This
-now allows these different elements to be defined independently, but the
-most common redefinition is for <span
-class="cmtt-10">\glstreenamefmt </span>to remove the bold in
-the name. If the bold is still required for the group heading and navigation
-elements, then both other commands also need redefining. To simplify matters, if
-<span
-class="cmtt-10">\glstreenamefmt </span>has been defined, as from v1.31 <span
-class="cmss-10">glossaries-extra-stylemods</span><a
- id="dx1-22026"></a>
-defines:
-</p><!--l. 3773--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22027"></a> <span
-class="cmtt-10">\glstreedefaultnamefmt{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3775--><p class="noindent" >
-which simply does <span
-class="cmtt-10">\textbf{</span>&#x27E8;<span
-class="cmti-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span>and redefines <span
-class="cmtt-10">\glstreenamefmt</span>,
-<span
-class="cmtt-10">\glstreegroupheaderfmt </span>and <span
-class="cmtt-10">\glstreenavigationfmt </span>all in terms of
-<span
-class="cmtt-10">\glstreedefaultnamefmt</span>.
-</p><!--l. 3781--><p class="indent" > This means that if you want to change all three to use a particular style you only
-need to redefine <span
-class="cmtt-10">\glstreedefaultnamefmt</span>, but if you only want to redefine
-<span
-class="cmtt-10">\glstreenamefmt </span>without affecting the other two commands, then you now
-can.
-</p><!--l. 3787--><p class="indent" > The separator between groups without headers is given by:
-</p><!--l. 3788--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22028"></a> <span
-class="cmtt-10">\glstreegroupskip </span></div><hr>
-</p><!--l. 3790--><p class="noindent" >
-This defaults to just <span
-class="cmtt-10">\indexspace</span><a
- id="dx1-22029"></a> without penalties. This command isn&#8217;t
-used if <a
-href="#styopt.nogroupskip"><span
-class="cmss-10">nogroupskip</span></a><a
- id="dx1-22030"></a> is set. (The penalties introduced in v1.41 were moved to
-<span
-class="cmtt-10">\glstreeheadergroupskip </span>in v1.42 as they are inappropriate when there&#8217;s no
-header.)
-</p><!--l. 3796--><p class="indent" > The separator between groups with headers is now given by (as from
-v1.42):
-</p><!--l. 3797--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22031"></a> <span
-class="cmtt-10">\glstreegroupheaderskip </span></div><hr>
-</p><!--l. 3799--><p class="noindent" >
-This defaults to <span
-class="cmtt-10">\glstreegroupskip </span>with penalties to deter page breaks after the
-group heading.
-</p><!--l. 3803--><p class="indent" > The styles that display the group titles now use:
-</p><!--l. 3804--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22032"></a> <span
-class="cmtt-10">\glstreePreHeader{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">title</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3806--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; is the group label and &#x27E8;<span
-class="cmti-10">title</span>&#x27E9; is the group title. This does nothing by
-
-
-
-default and is inserted before the group title. You can redefine it to add the group
-title to the PDF bookmarks. For example, if the glossary title uses <span
-class="cmtt-10">\chapter</span>
-then:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-119">
-\renewcommand{\glstreePreHeader}[2]{%
-&#x00A0;\pdfbookmark[1]{#2}{\currentglossary.#1}%
+</ul>
+<p>
+Not all combinations that fit the above syntax are provided. Pre-version 1.04 styles that didn’t fit this naming scheme are either provided with a synonym (where the former name wasn’t ambiguous) or provided with a deprecated synonym (where the former name was confusing).<p>
+
+</section><!-- end of section sec:predefabbrstyles -->
+
+<section id="sec:predefregabbrvstyles"><!-- start of section sec:predefregabbrvstyles --><div class="tomain"><a href="#main">[top]</a></div>
+<h4><!-- start of subsubsection header -->4.5.1.1. Regular Styles<div class="labellink"><a href="#sec:predefregabbrvstyles">[link]</a></div></h4><!-- end of subsubsection header -->
+<p>
+The following abbreviation styles set the <a id="wrglossary.1854"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">true</code> for all categories that have abbreviations defined with any of these styles. This means that they are treated like ordinary entries and are encapsulated with <a id="wrglossary.1855"></a><a href="#glo:glsxtrregularfont"><code class="csfmt">\glsxtrregularfont</code></a> not <a id="wrglossary.1856"></a><a href="#glo:glsxtrabbreviationfont"><code class="csfmt">\glsxtrabbreviationfont</code></a>. The <a id="wrglossary.1857"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands are formatted according to <a id="wrglossary.1858"></a><a href="#glo:glsgenentryfmt"><code class="csfmt">\glsgenentryfmt</code></a>.<p>
+
+</section><!-- end of section sec:predefregabbrvstyles -->
+
+<section id="sec:predefregabbrvstylesshort"><!-- start of section sec:predefregabbrvstylesshort --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.1.1.1. Short Styles<div class="labellink"><a href="#sec:predefregabbrvstylesshort">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These styles only show the short form on both <a id="wrglossary.1859"></a><a href="#glo:dual.firstuse">first use</a> and <a id="wrglossary.1860"></a><a href="#glo:dual.subsequentuse">subsequent use</a>. See §<a href="#sec:abbrvcmdsgeneral">4.5.1.3.1</a> and §<a href="#sec:abbrvcmdsnolong">4.5.1.3.5</a> for style commands.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1861"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></dfn></code></div><!-- end of settingsbox -->
+ Only the short form is shown on <a id="wrglossary.1862"></a><a href="#glo:dual.firstuse">first use</a> of the <a id="wrglossary.1863"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands. The <a id="wrglossary.1864"></a><a href="#glo:dual.inlinefullform">inline full form</a> uses the same parenthetical style as <a id="wrglossary.1865"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a> (<a id="wrglossary.1866"></a><a href="#glo:glsxtrshortlongformat"><code class="csfmt">\glsxtrshortlongformat</code></a>). Font variations are available with <a id="wrglossary.1867"></a><a href="#glo:opt.abbrstyle.short-sc-nolong"><span class="abbrstylefmt">short-sc-nolong</span></a>, <a id="wrglossary.1868"></a><a href="#glo:opt.abbrstyle.short-sm-nolong"><span class="abbrstylefmt">short-sm-nolong</span></a> and <a id="wrglossary.1869"></a><a href="#glo:opt.abbrstyle.short-em-nolong"><span class="abbrstylefmt">short-em-nolong</span></a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1870"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.1871"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a>}<p>
+<a id="wrglossary.1872"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.1873"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.1874"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.1875"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.1876"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.1877"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-nolong"></a>Example 8: The <span class="optfmt">short-nolong</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example008.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example008.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example008.png" type="image/png" width="358" height="83">Example document demonstrating the short-nolong abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+The long form is formatted with <a id="wrglossary.1878"></a><a href="#glo:glslongdefaultfont"><code class="csfmt">\glslongdefaultfont</code></a> for the <a id="wrglossary.1879"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> set of commands.<p>
+The short form is formatted with <a id="wrglossary.1880"></a><a href="#glo:glsfirstabbrvdefaultfont"><code class="csfmt">\glsfirstabbrvdefaultfont</code></a> within the full form and with <a id="wrglossary.1881"></a><a href="#glo:glsabbrvdefaultfont"><code class="csfmt">\glsabbrvdefaultfont</code></a> for <a id="wrglossary.1882"></a><a href="#glo:dual.subsequentuse">subsequent use</a> and for the <a id="wrglossary.1883"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> set of commands.<p>
+The name is set to the short form (<a id="wrglossary.1884"></a><a href="#glo:glsxtrshortnolongname"><code class="csfmt">\glsxtrshortnolongname</code></a>) and the description is set to the unencapsulated long form.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1885"></a><code class="code"><dfn id="glo:opt.abbrstyle.short"><span class="abbrstylefmt">short</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a>; <span class="summarytag">alias: </span><span class="abbrstylefmt">short-nolong</span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A synonym for <a id="wrglossary.1886"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1887"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-nolong-desc"><span class="abbrstylefmt">short-nolong-desc</span></dfn></code></div><!-- end of settingsbox -->
+ As <a id="wrglossary.1888"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a> but the description must be supplied in the optional argument of <a id="wrglossary.1889"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>. Font variations are available with <a id="wrglossary.1890"></a><a href="#glo:opt.abbrstyle.short-sc-nolong-desc"><span class="abbrstylefmt">short-sc-nolong-desc</span></a>, <a id="wrglossary.1891"></a><a href="#glo:opt.abbrstyle.short-sm-nolong-desc"><span class="abbrstylefmt">short-sm-nolong-desc</span></a> and <a id="wrglossary.1892"></a><a href="#glo:opt.abbrstyle.short-em-nolong-desc"><span class="abbrstylefmt">short-em-nolong-desc</span></a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1893"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.1894"></a><a href="#glo:opt.abbrstyle.short-nolong-desc"><span class="abbrstylefmt">short-nolong-desc</span></a>}<p>
+<a id="wrglossary.1895"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.1896"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.1897"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.1898"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.1899"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.1900"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.1901"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-nolong-desc"></a>Example 9: The <span class="optfmt">short-nolong-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example009.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example009.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example009.png" type="image/png" width="358" height="83">Example document demonstrating the short-nolong-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+The name is set to the short form followed by the long form in parentheses (<a id="wrglossary.1902"></a><a href="#glo:glsxtrshortdescname"><code class="csfmt">\glsxtrshortdescname</code></a>), and the sort is set to just the short form.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1903"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-desc"><span class="abbrstylefmt">short-desc</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:opt.abbrstyle.short-nolong-desc"><span class="abbrstylefmt">short-nolong-desc</span></a>; <span class="summarytag">alias: </span><span class="abbrstylefmt">short-nolong-desc</span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A synonym for <a id="wrglossary.1904"></a><a href="#glo:opt.abbrstyle.short-nolong-desc"><span class="abbrstylefmt">short-nolong-desc</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1905"></a><code class="code"><dfn id="glo:opt.abbrstyle.nolong-short"><span class="abbrstylefmt">nolong-short</span></dfn></code></div><!-- end of settingsbox -->
+ The same as <a id="wrglossary.1906"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a> except for the <a id="wrglossary.1907"></a><a href="#glo:dual.inlinefullform">inline full form</a>, which shows the same parenthetical style as <a id="wrglossary.1908"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> (<a id="wrglossary.1909"></a><a href="#glo:glsxtrlongshortformat"><code class="csfmt">\glsxtrlongshortformat</code></a>). Font variations are available with <a id="wrglossary.1910"></a><a href="#glo:opt.abbrstyle.nolong-short-sc"><span class="abbrstylefmt">nolong-short-sc</span></a>, <a id="wrglossary.1911"></a><a href="#glo:opt.abbrstyle.nolong-short-sm"><span class="abbrstylefmt">nolong-short-sm</span></a> and <a id="wrglossary.1912"></a><a href="#glo:opt.abbrstyle.nolong-short-em"><span class="abbrstylefmt">nolong-short-em</span></a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1913"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.1914"></a><a href="#glo:opt.abbrstyle.nolong-short"><span class="abbrstylefmt">nolong-short</span></a>}<p>
+<a id="wrglossary.1915"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.1916"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.1917"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.1918"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.1919"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.1920"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylenolong-short"></a>Example 10: The <span class="optfmt">nolong-short</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example010.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example010.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example010.png" type="image/png" width="358" height="83">Example document demonstrating the nolong-short abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1921"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-sc-nolong"><span class="abbrstylefmt">short-sc-nolong</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.1922"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a> but it uses <a id="wrglossary.1923"></a><a href="#glo:glsxtrscsuffix"><code class="csfmt">\glsxtrscsuffix</code></a>, <a id="wrglossary.1924"></a><a href="#glo:glsabbrvscfont"><code class="csfmt">\glsabbrvscfont</code></a> and <a id="wrglossary.1925"></a><a href="#glo:glsfirstabbrvscfont"><code class="csfmt">\glsfirstabbrvscfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1926"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.1927"></a><a href="#glo:opt.abbrstyle.short-sc-nolong"><span class="abbrstylefmt">short-sc-nolong</span></a>}<p>
+<a id="wrglossary.1928"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{shrt fm}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.1929"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.1930"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.1931"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.1932"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.1933"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-sc-nolong"></a>Example 11: The <span class="optfmt">short-sc-nolong</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example011.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example011.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example011.png" type="image/png" width="358" height="83">Example document demonstrating the short-sc-nolong abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1934"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-sc"><span class="abbrstylefmt">short-sc</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:opt.abbrstyle.short-sc-nolong"><span class="abbrstylefmt">short-sc-nolong</span></a>; <span class="summarytag">alias: </span><span class="abbrstylefmt">short-sc-nolong</span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A synonym for <a id="wrglossary.1935"></a><a href="#glo:opt.abbrstyle.short-sc-nolong"><span class="abbrstylefmt">short-sc-nolong</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1936"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-sc-nolong-desc"><span class="abbrstylefmt">short-sc-nolong-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.1937"></a><a href="#glo:opt.abbrstyle.short-nolong-desc"><span class="abbrstylefmt">short-nolong-desc</span></a> but it uses <a id="wrglossary.1938"></a><a href="#glo:glsxtrscsuffix"><code class="csfmt">\glsxtrscsuffix</code></a>, <a id="wrglossary.1939"></a><a href="#glo:glsabbrvscfont"><code class="csfmt">\glsabbrvscfont</code></a> and <a id="wrglossary.1940"></a><a href="#glo:glsfirstabbrvscfont"><code class="csfmt">\glsfirstabbrvscfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1941"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.1942"></a><a href="#glo:opt.abbrstyle.short-sc-nolong-desc"><span class="abbrstylefmt">short-sc-nolong-desc</span></a>}<p>
+<a id="wrglossary.1943"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.1944"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{shrt fm}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.1945"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.1946"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.1947"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.1948"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.1949"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-sc-nolong-desc"></a>Example 12: The <span class="optfmt">short-sc-nolong-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example012.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example012.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example012.png" type="image/png" width="358" height="83">Example document demonstrating the short-sc-nolong-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1950"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-sc-desc"><span class="abbrstylefmt">short-sc-desc</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:opt.abbrstyle.short-sc-nolong-desc"><span class="abbrstylefmt">short-sc-nolong-desc</span></a>; <span class="summarytag">alias: </span><span class="abbrstylefmt">short-sc-nolong-desc</span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A synonym for <a id="wrglossary.1951"></a><a href="#glo:opt.abbrstyle.short-sc-nolong-desc"><span class="abbrstylefmt">short-sc-nolong-desc</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1952"></a><code class="code"><dfn id="glo:opt.abbrstyle.nolong-short-sc"><span class="abbrstylefmt">nolong-short-sc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.1953"></a><a href="#glo:opt.abbrstyle.nolong-short"><span class="abbrstylefmt">nolong-short</span></a> but it uses <a id="wrglossary.1954"></a><a href="#glo:glsxtrscsuffix"><code class="csfmt">\glsxtrscsuffix</code></a>, <a id="wrglossary.1955"></a><a href="#glo:glsabbrvscfont"><code class="csfmt">\glsabbrvscfont</code></a> and <a id="wrglossary.1956"></a><a href="#glo:glsfirstabbrvscfont"><code class="csfmt">\glsfirstabbrvscfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1957"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.1958"></a><a href="#glo:opt.abbrstyle.nolong-short-sc"><span class="abbrstylefmt">nolong-short-sc</span></a>}<p>
+<a id="wrglossary.1959"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{shrt fm}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.1960"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.1961"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.1962"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.1963"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.1964"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylenolong-short-sc"></a>Example 13: The <span class="optfmt">nolong-short-sc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example013.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example013.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example013.png" type="image/png" width="358" height="83">Example document demonstrating the nolong-short-sc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1965"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-sm-nolong"><span class="abbrstylefmt">short-sm-nolong</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.1966"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a> but it uses <a id="wrglossary.1967"></a><a href="#glo:glsxtrsmsuffix"><code class="csfmt">\glsxtrsmsuffix</code></a>, <a id="wrglossary.1968"></a><a href="#glo:glsabbrvsmfont"><code class="csfmt">\glsabbrvsmfont</code></a> and <a id="wrglossary.1969"></a><a href="#glo:glsfirstabbrvsmfont"><code class="csfmt">\glsfirstabbrvsmfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1970"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.1971"></a><a href="#glo:opt.abbrstyle.short-sm-nolong"><span class="abbrstylefmt">short-sm-nolong</span></a>}<p>
+<a id="wrglossary.1972"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.1973"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.1974"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.1975"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.1976"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.1977"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-sm-nolong"></a>Example 14: The <span class="optfmt">short-sm-nolong</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example014.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example014.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example014.png" type="image/png" width="358" height="83">Example document demonstrating the short-sm-nolong abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1978"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-sm"><span class="abbrstylefmt">short-sm</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:opt.abbrstyle.short-sm-nolong"><span class="abbrstylefmt">short-sm-nolong</span></a>; <span class="summarytag">alias: </span><span class="abbrstylefmt">short-sm-nolong</span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A synonym for <a id="wrglossary.1979"></a><a href="#glo:opt.abbrstyle.short-sm-nolong"><span class="abbrstylefmt">short-sm-nolong</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1980"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-sm-nolong-desc"><span class="abbrstylefmt">short-sm-nolong-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.1981"></a><a href="#glo:opt.abbrstyle.short-nolong-desc"><span class="abbrstylefmt">short-nolong-desc</span></a> but it uses <a id="wrglossary.1982"></a><a href="#glo:glsxtrsmsuffix"><code class="csfmt">\glsxtrsmsuffix</code></a>, <a id="wrglossary.1983"></a><a href="#glo:glsabbrvsmfont"><code class="csfmt">\glsabbrvsmfont</code></a> and <a id="wrglossary.1984"></a><a href="#glo:glsfirstabbrvsmfont"><code class="csfmt">\glsfirstabbrvsmfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1985"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.1986"></a><a href="#glo:opt.abbrstyle.short-sm-nolong-desc"><span class="abbrstylefmt">short-sm-nolong-desc</span></a>}<p>
+<a id="wrglossary.1987"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.1988"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.1989"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.1990"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.1991"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.1992"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.1993"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-sm-nolong-desc"></a>Example 15: The <span class="optfmt">short-sm-nolong-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example015.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example015.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example015.png" type="image/png" width="358" height="83">Example document demonstrating the short-sm-nolong-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1994"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-sm-desc"><span class="abbrstylefmt">short-sm-desc</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:opt.abbrstyle.short-sm-nolong-desc"><span class="abbrstylefmt">short-sm-nolong-desc</span></a>; <span class="summarytag">alias: </span><span class="abbrstylefmt">short-sm-nolong-desc</span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A synonym for <a id="wrglossary.1995"></a><a href="#glo:opt.abbrstyle.short-sm-nolong-desc"><span class="abbrstylefmt">short-sm-nolong-desc</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1996"></a><code class="code"><dfn id="glo:opt.abbrstyle.nolong-short-sm"><span class="abbrstylefmt">nolong-short-sm</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.1997"></a><a href="#glo:opt.abbrstyle.nolong-short"><span class="abbrstylefmt">nolong-short</span></a> but it uses <a id="wrglossary.1998"></a><a href="#glo:glsxtrsmsuffix"><code class="csfmt">\glsxtrsmsuffix</code></a>, <a id="wrglossary.1999"></a><a href="#glo:glsabbrvsmfont"><code class="csfmt">\glsabbrvsmfont</code></a> and <a id="wrglossary.2000"></a><a href="#glo:glsfirstabbrvsmfont"><code class="csfmt">\glsfirstabbrvsmfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2001"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2002"></a><a href="#glo:opt.abbrstyle.nolong-short-sm"><span class="abbrstylefmt">nolong-short-sm</span></a>}<p>
+<a id="wrglossary.2003"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2004"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2005"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2006"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2007"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2008"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylenolong-short-sm"></a>Example 16: The <span class="optfmt">nolong-short-sm</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example016.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example016.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example016.png" type="image/png" width="358" height="83">Example document demonstrating the nolong-short-sm abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2009"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-em-nolong"><span class="abbrstylefmt">short-em-nolong</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2010"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a> but it uses <a id="wrglossary.2011"></a><a href="#glo:glsxtremsuffix"><code class="csfmt">\glsxtremsuffix</code></a>, <a id="wrglossary.2012"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a> and <a id="wrglossary.2013"></a><a href="#glo:glsfirstabbrvemfont"><code class="csfmt">\glsfirstabbrvemfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2014"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2015"></a><a href="#glo:opt.abbrstyle.short-em-nolong"><span class="abbrstylefmt">short-em-nolong</span></a>}<p>
+<a id="wrglossary.2016"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2017"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2018"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2019"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2020"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2021"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-em-nolong"></a>Example 17: The <span class="optfmt">short-em-nolong</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example017.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example017.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example017.png" type="image/png" width="358" height="83">Example document demonstrating the short-em-nolong abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2022"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-em"><span class="abbrstylefmt">short-em</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:opt.abbrstyle.short-em-nolong"><span class="abbrstylefmt">short-em-nolong</span></a>; <span class="summarytag">alias: </span><span class="abbrstylefmt">short-em-nolong</span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A synonym for <a id="wrglossary.2023"></a><a href="#glo:opt.abbrstyle.short-em-nolong"><span class="abbrstylefmt">short-em-nolong</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2024"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-em-nolong-desc"><span class="abbrstylefmt">short-em-nolong-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2025"></a><a href="#glo:opt.abbrstyle.short-nolong-desc"><span class="abbrstylefmt">short-nolong-desc</span></a> but it uses <a id="wrglossary.2026"></a><a href="#glo:glsxtremsuffix"><code class="csfmt">\glsxtremsuffix</code></a>, <a id="wrglossary.2027"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a> and <a id="wrglossary.2028"></a><a href="#glo:glsfirstabbrvemfont"><code class="csfmt">\glsfirstabbrvemfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2029"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2030"></a><a href="#glo:opt.abbrstyle.short-em-nolong-desc"><span class="abbrstylefmt">short-em-nolong-desc</span></a>}<p>
+<a id="wrglossary.2031"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2032"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2033"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2034"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2035"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2036"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2037"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-em-nolong-desc"></a>Example 18: The <span class="optfmt">short-em-nolong-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example018.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example018.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example018.png" type="image/png" width="358" height="83">Example document demonstrating the short-em-nolong-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2038"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-em-desc"><span class="abbrstylefmt">short-em-desc</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:opt.abbrstyle.short-em-nolong-desc"><span class="abbrstylefmt">short-em-nolong-desc</span></a>; <span class="summarytag">alias: </span><span class="abbrstylefmt">short-em-nolong-desc</span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A synonym for <a id="wrglossary.2039"></a><a href="#glo:opt.abbrstyle.short-em-nolong-desc"><span class="abbrstylefmt">short-em-nolong-desc</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2040"></a><code class="code"><dfn id="glo:opt.abbrstyle.nolong-short-em"><span class="abbrstylefmt">nolong-short-em</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2041"></a><a href="#glo:opt.abbrstyle.nolong-short"><span class="abbrstylefmt">nolong-short</span></a> but it uses <a id="wrglossary.2042"></a><a href="#glo:glsxtremsuffix"><code class="csfmt">\glsxtremsuffix</code></a>, <a id="wrglossary.2043"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a> and <a id="wrglossary.2044"></a><a href="#glo:glsfirstabbrvemfont"><code class="csfmt">\glsfirstabbrvemfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2045"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2046"></a><a href="#glo:opt.abbrstyle.nolong-short-em"><span class="abbrstylefmt">nolong-short-em</span></a>}<p>
+<a id="wrglossary.2047"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2048"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2049"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2050"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2051"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2052"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylenolong-short-em"></a>Example 19: The <span class="optfmt">nolong-short-em</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example019.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example019.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example019.png" type="image/png" width="358" height="83">Example document demonstrating the nolong-short-em abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+
+</section><!-- end of section sec:predefregabbrvstylesshort -->
+
+<section id="sec:predefregabbrvstyleslong"><!-- start of section sec:predefregabbrvstyleslong --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.1.1.2. Long Styles<div class="labellink"><a href="#sec:predefregabbrvstyleslong">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These styles only show the long form on both <a id="wrglossary.2053"></a><a href="#glo:dual.firstuse">first use</a> and <a id="wrglossary.2054"></a><a href="#glo:dual.subsequentuse">subsequent use</a>. See §<a href="#sec:abbrvcmdsgeneral">4.5.1.3.1</a> and §<a href="#sec:abbrvcmdsnoshort">4.5.1.3.6</a> for style commands.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2055"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></dfn></code></div><!-- end of settingsbox -->
+ Only the long form is shown on <a id="wrglossary.2056"></a><a href="#glo:dual.firstuse">first use</a> and <a id="wrglossary.2057"></a><a href="#glo:dual.subsequentuse">subsequent use</a> of the <a id="wrglossary.2058"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands (<a id="wrglossary.2059"></a><a href="#glo:glsxtrlongformat"><code class="csfmt">\glsxtrlongformat</code></a>). The <a id="wrglossary.2060"></a><a href="#glo:dual.inlinefullform">inline full form</a> uses the same parenthetical style as <a id="wrglossary.2061"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> (<a id="wrglossary.2062"></a><a href="#glo:glsxtrlongshortformat"><code class="csfmt">\glsxtrlongshortformat</code></a>). Font variations are available with <a id="wrglossary.2063"></a><a href="#glo:opt.abbrstyle.long-noshort-sc-desc"><span class="abbrstylefmt">long-noshort-sc-desc</span></a>, <a id="wrglossary.2064"></a><a href="#glo:opt.abbrstyle.long-noshort-sm-desc"><span class="abbrstylefmt">long-noshort-sm-desc</span></a> and <a id="wrglossary.2065"></a><a href="#glo:opt.abbrstyle.long-noshort-em-desc"><span class="abbrstylefmt">long-noshort-em-desc</span></a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2066"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2067"></a><a href="#glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></a>}<p>
+<a id="wrglossary.2068"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2069"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2070"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2071"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2072"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2073"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2074"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-noshort-desc"></a>Example 20: The <span class="optfmt">long-noshort-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example020.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example020.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example020.png" type="image/png" width="358" height="83">Example document demonstrating the long-noshort-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+The long form is formatted with <a id="wrglossary.2075"></a><a href="#glo:glsfirstlongdefaultfont"><code class="csfmt">\glsfirstlongdefaultfont</code></a> on <a id="wrglossary.2076"></a><a href="#glo:dual.firstuse">first use</a> and <a id="wrglossary.2077"></a><a href="#glo:glslongdefaultfont"><code class="csfmt">\glslongdefaultfont</code></a> for <a id="wrglossary.2078"></a><a href="#glo:dual.subsequentuse">subsequent use</a> and for the <a id="wrglossary.2079"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> set of commands.<p>
+The short form is formatted with <a id="wrglossary.2080"></a><a href="#glo:glsfirstabbrvdefaultfont"><code class="csfmt">\glsfirstabbrvdefaultfont</code></a> within the <a id="wrglossary.2081"></a><a href="#glo:dual.inlinefullform">inline full form</a> and with <a id="wrglossary.2082"></a><a href="#glo:glsabbrvdefaultfont"><code class="csfmt">\glsabbrvdefaultfont</code></a> for the <a id="wrglossary.2083"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> set of commands.<p>
+The name is set to the long form (<a id="wrglossary.2084"></a><a href="#glo:glsxtrlongnoshortdescname"><code class="csfmt">\glsxtrlongnoshortdescname</code></a>) and the description must be supplied.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2085"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-desc"><span class="abbrstylefmt">long-desc</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></a>; <span class="summarytag">alias: </span><span class="abbrstylefmt">long-noshort-desc</span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A synonym for <a id="wrglossary.2086"></a><a href="#glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2087"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-noshort"><span class="abbrstylefmt">long-noshort</span></dfn></code></div><!-- end of settingsbox -->
+ This is like <a id="wrglossary.2088"></a><a href="#glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></a> but the name is set to the short form (<a id="wrglossary.2089"></a><a href="#glo:glsxtrlongnoshortname"><code class="csfmt">\glsxtrlongnoshortname</code></a>) and the description is set to the unencapsulated long form.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2090"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2091"></a><a href="#glo:opt.abbrstyle.long-noshort"><span class="abbrstylefmt">long-noshort</span></a>}<p>
+<a id="wrglossary.2092"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2093"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2094"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2095"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2096"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2097"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-noshort"></a>Example 21: The <span class="optfmt">long-noshort</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example021.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example021.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example021.png" type="image/png" width="358" height="83">Example document demonstrating the long-noshort abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2098"></a><code class="code"><dfn id="glo:opt.abbrstyle.long"><span class="abbrstylefmt">long</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:opt.abbrstyle.long-noshort"><span class="abbrstylefmt">long-noshort</span></a>; <span class="summarytag">alias: </span><span class="abbrstylefmt">long-noshort</span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A synonym for <a id="wrglossary.2099"></a><a href="#glo:opt.abbrstyle.long-noshort"><span class="abbrstylefmt">long-noshort</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2100"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-noshort-sc"><span class="abbrstylefmt">long-noshort-sc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2101"></a><a href="#glo:opt.abbrstyle.long-noshort"><span class="abbrstylefmt">long-noshort</span></a> but it uses <a id="wrglossary.2102"></a><a href="#glo:glsxtrscsuffix"><code class="csfmt">\glsxtrscsuffix</code></a>, <a id="wrglossary.2103"></a><a href="#glo:glsabbrvscfont"><code class="csfmt">\glsabbrvscfont</code></a> and <a id="wrglossary.2104"></a><a href="#glo:glsfirstabbrvscfont"><code class="csfmt">\glsfirstabbrvscfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2105"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2106"></a><a href="#glo:opt.abbrstyle.long-noshort-sc"><span class="abbrstylefmt">long-noshort-sc</span></a>}<p>
+<a id="wrglossary.2107"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{shrt fm}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2108"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2109"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2110"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2111"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2112"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-noshort-sc"></a>Example 22: The <span class="optfmt">long-noshort-sc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example022.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example022.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example022.png" type="image/png" width="358" height="83">Example document demonstrating the long-noshort-sc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2113"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-noshort-sc-desc"><span class="abbrstylefmt">long-noshort-sc-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2114"></a><a href="#glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></a> but it uses <a id="wrglossary.2115"></a><a href="#glo:glsxtrscsuffix"><code class="csfmt">\glsxtrscsuffix</code></a>, <a id="wrglossary.2116"></a><a href="#glo:glsabbrvscfont"><code class="csfmt">\glsabbrvscfont</code></a> and <a id="wrglossary.2117"></a><a href="#glo:glsfirstabbrvscfont"><code class="csfmt">\glsfirstabbrvscfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2118"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2119"></a><a href="#glo:opt.abbrstyle.long-noshort-sc-desc"><span class="abbrstylefmt">long-noshort-sc-desc</span></a>}<p>
+<a id="wrglossary.2120"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2121"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{shrt fm}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2122"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2123"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2124"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2125"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2126"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-noshort-sc-desc"></a>Example 23: The <span class="optfmt">long-noshort-sc-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example023.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example023.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example023.png" type="image/png" width="358" height="83">Example document demonstrating the long-noshort-sc-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2127"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-noshort-sm"><span class="abbrstylefmt">long-noshort-sm</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2128"></a><a href="#glo:opt.abbrstyle.long-noshort"><span class="abbrstylefmt">long-noshort</span></a> but it uses <a id="wrglossary.2129"></a><a href="#glo:glsxtrsmsuffix"><code class="csfmt">\glsxtrsmsuffix</code></a>, <a id="wrglossary.2130"></a><a href="#glo:glsabbrvsmfont"><code class="csfmt">\glsabbrvsmfont</code></a> and <a id="wrglossary.2131"></a><a href="#glo:glsfirstabbrvsmfont"><code class="csfmt">\glsfirstabbrvsmfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2132"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2133"></a><a href="#glo:opt.abbrstyle.long-noshort-sm"><span class="abbrstylefmt">long-noshort-sm</span></a>}<p>
+<a id="wrglossary.2134"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2135"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2136"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2137"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2138"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2139"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-noshort-sm"></a>Example 24: The <span class="optfmt">long-noshort-sm</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example024.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example024.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example024.png" type="image/png" width="358" height="83">Example document demonstrating the long-noshort-sm abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2140"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-noshort-sm-desc"><span class="abbrstylefmt">long-noshort-sm-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2141"></a><a href="#glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></a> but it uses <a id="wrglossary.2142"></a><a href="#glo:glsxtrsmsuffix"><code class="csfmt">\glsxtrsmsuffix</code></a>, <a id="wrglossary.2143"></a><a href="#glo:glsabbrvsmfont"><code class="csfmt">\glsabbrvsmfont</code></a> and <a id="wrglossary.2144"></a><a href="#glo:glsfirstabbrvsmfont"><code class="csfmt">\glsfirstabbrvsmfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2145"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2146"></a><a href="#glo:opt.abbrstyle.long-noshort-sm-desc"><span class="abbrstylefmt">long-noshort-sm-desc</span></a>}<p>
+<a id="wrglossary.2147"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2148"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2149"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2150"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2151"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2152"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2153"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-noshort-sm-desc"></a>Example 25: The <span class="optfmt">long-noshort-sm-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example025.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example025.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example025.png" type="image/png" width="358" height="83">Example document demonstrating the long-noshort-sm-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2154"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-noshort-em"><span class="abbrstylefmt">long-noshort-em</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2155"></a><a href="#glo:opt.abbrstyle.long-noshort"><span class="abbrstylefmt">long-noshort</span></a> but it uses <a id="wrglossary.2156"></a><a href="#glo:glsxtremsuffix"><code class="csfmt">\glsxtremsuffix</code></a>, <a id="wrglossary.2157"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a> and <a id="wrglossary.2158"></a><a href="#glo:glsfirstabbrvemfont"><code class="csfmt">\glsfirstabbrvemfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2159"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2160"></a><a href="#glo:opt.abbrstyle.long-noshort-em"><span class="abbrstylefmt">long-noshort-em</span></a>}<p>
+<a id="wrglossary.2161"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2162"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2163"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2164"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2165"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2166"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-noshort-em"></a>Example 26: The <span class="optfmt">long-noshort-em</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example026.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example026.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example026.png" type="image/png" width="358" height="83">Example document demonstrating the long-noshort-em abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2167"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-noshort-em-desc"><span class="abbrstylefmt">long-noshort-em-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2168"></a><a href="#glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></a> but it uses <a id="wrglossary.2169"></a><a href="#glo:glsxtremsuffix"><code class="csfmt">\glsxtremsuffix</code></a>, <a id="wrglossary.2170"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a> and <a id="wrglossary.2171"></a><a href="#glo:glsfirstabbrvemfont"><code class="csfmt">\glsfirstabbrvemfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2172"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2173"></a><a href="#glo:opt.abbrstyle.long-noshort-em-desc"><span class="abbrstylefmt">long-noshort-em-desc</span></a>}<p>
+<a id="wrglossary.2174"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2175"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2176"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2177"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2178"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2179"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2180"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-noshort-em-desc"></a>Example 27: The <span class="optfmt">long-noshort-em-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example027.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example027.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example027.png" type="image/png" width="358" height="83">Example document demonstrating the long-noshort-em-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2181"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-em-noshort-em"><span class="abbrstylefmt">long-em-noshort-em</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2182"></a><a href="#glo:opt.abbrstyle.long-noshort"><span class="abbrstylefmt">long-noshort</span></a> but it uses <a id="wrglossary.2183"></a><a href="#glo:glsxtremsuffix"><code class="csfmt">\glsxtremsuffix</code></a>, <a id="wrglossary.2184"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a>, <a id="wrglossary.2185"></a><a href="#glo:glsfirstabbrvemfont"><code class="csfmt">\glsfirstabbrvemfont</code></a>, <a id="wrglossary.2186"></a><a href="#glo:glslongemfont"><code class="csfmt">\glslongemfont</code></a> and <a id="wrglossary.2187"></a><a href="#glo:glsfirstlongemfont"><code class="csfmt">\glsfirstlongemfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>). This emphasizes both the long and short forms.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2188"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2189"></a><a href="#glo:opt.abbrstyle.long-em-noshort-em"><span class="abbrstylefmt">long-em-noshort-em</span></a>}<p>
+<a id="wrglossary.2190"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2191"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2192"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2193"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2194"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2195"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-em-noshort-em"></a>Example 28: The <span class="optfmt">long-em-noshort-em</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example028.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example028.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example028.png" type="image/png" width="358" height="83">Example document demonstrating the long-em-noshort-em abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2196"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-em-noshort-em-desc"><span class="abbrstylefmt">long-em-noshort-em-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2197"></a><a href="#glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></a> but it uses <a id="wrglossary.2198"></a><a href="#glo:glsxtremsuffix"><code class="csfmt">\glsxtremsuffix</code></a>, <a id="wrglossary.2199"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a>, <a id="wrglossary.2200"></a><a href="#glo:glsfirstabbrvemfont"><code class="csfmt">\glsfirstabbrvemfont</code></a>, <a id="wrglossary.2201"></a><a href="#glo:glslongemfont"><code class="csfmt">\glslongemfont</code></a> and <a id="wrglossary.2202"></a><a href="#glo:glsfirstlongemfont"><code class="csfmt">\glsfirstlongemfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>). This emphasizes both the long and short forms.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2203"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2204"></a><a href="#glo:opt.abbrstyle.long-em-noshort-em-desc"><span class="abbrstylefmt">long-em-noshort-em-desc</span></a>}<p>
+<a id="wrglossary.2205"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2206"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2207"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2208"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2209"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2210"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2211"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-em-noshort-em-desc"></a>Example 29: The <span class="optfmt">long-em-noshort-em-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example029.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example029.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example029.png" type="image/png" width="358" height="83">Example document demonstrating the long-em-noshort-em-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+
+</section><!-- end of section sec:predefregabbrvstyleslong -->
+
+<section id="sec:predefnonregabbrvstyles"><!-- start of section sec:predefnonregabbrvstyles --><div class="tomain"><a href="#main">[top]</a></div>
+<h4><!-- start of subsubsection header -->4.5.1.2. Non-Regular Styles<div class="labellink"><a href="#sec:predefnonregabbrvstyles">[link]</a></div></h4><!-- end of subsubsection header -->
+<p>
+The following abbreviation styles will set the <a id="wrglossary.2212"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">false</code> if it has previously been set. If it hasn’t already been set, it’s left unset. Other attributes may also be set, depending on the style.<p>
+The non-regular styles are too complicated to use <a id="wrglossary.2213"></a><a href="#glo:glsgenentryfmt"><code class="csfmt">\glsgenentryfmt</code></a> as the display style (with the <a id="wrglossary.2214"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands). Instead they use <a id="wrglossary.2215"></a><a href="#glo:glsxtrgenabbrvfmt"><code class="csfmt">\glsxtrgenabbrvfmt</code></a>. This means that these styles won’t work if you provide your own custom display style (using <a id="wrglossary.2216"></a><a href="#glo:defglsentryfmt"><code class="csfmt">\defglsentryfmt</code></a>) that doesn’t check for the <a id="wrglossary.2217"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute. <p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Avoid using <a id="wrglossary.2218"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a>, <a id="wrglossary.2219"></a><a href="#glo:glsfirstplural"><code class="csfmt">\glsfirstplural</code></a>, <a id="wrglossary.2220"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> and <a id="wrglossary.2221"></a><a href="#glo:glsplural"><code class="csfmt">\glsplural</code></a> (or their case-changing variants) with these styles. There are also some styles that can be problematic with <a id="wrglossary.2222"></a><a href="#glo:GLSname"><code class="csfmt">\GLSname</code></a>. </div><!-- end of important -->
+<p>
+
+</section><!-- end of section sec:predefnonregabbrvstyles -->
+
+<section id="sec:predefnonregabbrvstyleslongshort"><!-- start of section sec:predefnonregabbrvstyleslongshort --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.1.2.1. Long (Short) Styles<div class="labellink"><a href="#sec:predefnonregabbrvstyleslongshort">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These styles show the long form followed by the short form in parentheses on <a id="wrglossary.2223"></a><a href="#glo:dual.firstuse">first use</a>. On <a id="wrglossary.2224"></a><a href="#glo:dual.subsequentuse">subsequent use</a> only the short form is shown. See §<a href="#sec:abbrvcmdsgeneral">4.5.1.3.1</a> and §<a href="#sec:abbrvcmdsparen">4.5.1.3.2</a> for style commands.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2225"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></dfn></code></div><!-- end of settingsbox -->
+ The <span class="meta">〈<em class="metainner">insert</em>〉</span> is placed after the long form on <a id="wrglossary.2226"></a><a href="#glo:dual.firstuse">first use</a> of the <a id="wrglossary.2227"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands and after the short form on <a id="wrglossary.2228"></a><a href="#glo:dual.subsequentuse">subsequent use</a>. The <a id="wrglossary.2229"></a><a href="#glo:dual.inlinefullform">inline full form</a> is the same as the <a id="wrglossary.2230"></a><a href="#glo:dual.displayfullform">display full form</a> (<a id="wrglossary.2231"></a><a href="#glo:glsxtrlongshortformat"><code class="csfmt">\glsxtrlongshortformat</code></a>). Font variations are available with <a id="wrglossary.2232"></a><a href="#glo:opt.abbrstyle.long-short-sc"><span class="abbrstylefmt">long-short-sc</span></a>, <a id="wrglossary.2233"></a><a href="#glo:opt.abbrstyle.long-short-sm"><span class="abbrstylefmt">long-short-sm</span></a>, <a id="wrglossary.2234"></a><a href="#glo:opt.abbrstyle.long-short-em"><span class="abbrstylefmt">long-short-em</span></a> and <a id="wrglossary.2235"></a><a href="#glo:opt.abbrstyle.long-em-short-em"><span class="abbrstylefmt">long-em-short-em</span></a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2236"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2237"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a>}<p>
+<a id="wrglossary.2238"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2239"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2240"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2241"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2242"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2243"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-short"></a>Example 30: The <span class="optfmt">long-short</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example030.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example030.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example030.png" type="image/png" width="359" height="84">Example document demonstrating the long-short abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+The long form is formatted with <a id="wrglossary.2244"></a><a href="#glo:glsfirstlongdefaultfont"><code class="csfmt">\glsfirstlongdefaultfont</code></a> within the full form and with <a id="wrglossary.2245"></a><a href="#glo:glslongdefaultfont"><code class="csfmt">\glslongdefaultfont</code></a> for the <a id="wrglossary.2246"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> set of commands.<p>
+The short form is formatted with <a id="wrglossary.2247"></a><a href="#glo:glsfirstabbrvdefaultfont"><code class="csfmt">\glsfirstabbrvdefaultfont</code></a> within the full form and with <a id="wrglossary.2248"></a><a href="#glo:glsabbrvdefaultfont"><code class="csfmt">\glsabbrvdefaultfont</code></a> for <a id="wrglossary.2249"></a><a href="#glo:dual.subsequentuse">subsequent use</a> and for the <a id="wrglossary.2250"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> set of commands.<p>
+The name is set to the short form (<a id="wrglossary.2251"></a><a href="#glo:glsxtrlongshortname"><code class="csfmt">\glsxtrlongshortname</code></a>) and the description is set to the unencapsulated long form.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2252"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-short-desc"><span class="abbrstylefmt">long-short-desc</span></dfn></code></div><!-- end of settingsbox -->
+ As <a id="wrglossary.2253"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> but the description must be supplied in the optional argument of <a id="wrglossary.2254"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>. Font variations are available with <a id="wrglossary.2255"></a><a href="#glo:opt.abbrstyle.long-short-sc-desc"><span class="abbrstylefmt">long-short-sc-desc</span></a>, <a id="wrglossary.2256"></a><a href="#glo:opt.abbrstyle.long-short-sm-desc"><span class="abbrstylefmt">long-short-sm-desc</span></a>, <a id="wrglossary.2257"></a><a href="#glo:opt.abbrstyle.long-short-em-desc"><span class="abbrstylefmt">long-short-em-desc</span></a> and <a id="wrglossary.2258"></a><a href="#glo:opt.abbrstyle.long-em-short-em-desc"><span class="abbrstylefmt">long-em-short-em-desc</span></a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2259"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2260"></a><a href="#glo:opt.abbrstyle.long-short-desc"><span class="abbrstylefmt">long-short-desc</span></a>}<p>
+<a id="wrglossary.2261"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2262"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2263"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2264"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2265"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2266"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2267"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-short-desc"></a>Example 31: The <span class="optfmt">long-short-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example031.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example031.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example031.png" type="image/png" width="359" height="84">Example document demonstrating the long-short-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+The name and sort are set to the long form followed by the short form in parentheses (<a id="wrglossary.2268"></a><a href="#glo:glsxtrlongshortdescname"><code class="csfmt">\glsxtrlongshortdescname</code></a> and <a id="wrglossary.2269"></a><a href="#glo:glsxtrlongshortdescsort"><code class="csfmt">\glsxtrlongshortdescsort</code></a>).<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2270"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-short-sc"><span class="abbrstylefmt">long-short-sc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2271"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> but it uses <a id="wrglossary.2272"></a><a href="#glo:glsxtrscsuffix"><code class="csfmt">\glsxtrscsuffix</code></a>, <a id="wrglossary.2273"></a><a href="#glo:glsabbrvscfont"><code class="csfmt">\glsabbrvscfont</code></a> and <a id="wrglossary.2274"></a><a href="#glo:glsfirstabbrvscfont"><code class="csfmt">\glsfirstabbrvscfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2275"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2276"></a><a href="#glo:opt.abbrstyle.long-short-sc"><span class="abbrstylefmt">long-short-sc</span></a>}<p>
+<a id="wrglossary.2277"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{shrt fm}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2278"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2279"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2280"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2281"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2282"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-short-sc"></a>Example 32: The <span class="optfmt">long-short-sc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example032.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example032.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example032.png" type="image/png" width="359" height="84">Example document demonstrating the long-short-sc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2283"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-short-sc-desc"><span class="abbrstylefmt">long-short-sc-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2284"></a><a href="#glo:opt.abbrstyle.long-short-desc"><span class="abbrstylefmt">long-short-desc</span></a> but it uses <a id="wrglossary.2285"></a><a href="#glo:glsxtrscsuffix"><code class="csfmt">\glsxtrscsuffix</code></a>, <a id="wrglossary.2286"></a><a href="#glo:glsabbrvscfont"><code class="csfmt">\glsabbrvscfont</code></a> and <a id="wrglossary.2287"></a><a href="#glo:glsfirstabbrvscfont"><code class="csfmt">\glsfirstabbrvscfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2288"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2289"></a><a href="#glo:opt.abbrstyle.long-short-sc-desc"><span class="abbrstylefmt">long-short-sc-desc</span></a>}<p>
+<a id="wrglossary.2290"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2291"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{shrt fm}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2292"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2293"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2294"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2295"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2296"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-short-sc-desc"></a>Example 33: The <span class="optfmt">long-short-sc-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example033.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example033.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example033.png" type="image/png" width="359" height="84">Example document demonstrating the long-short-sc-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2297"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-short-sm"><span class="abbrstylefmt">long-short-sm</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2298"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> but it uses <a id="wrglossary.2299"></a><a href="#glo:glsxtrsmsuffix"><code class="csfmt">\glsxtrsmsuffix</code></a>, <a id="wrglossary.2300"></a><a href="#glo:glsabbrvsmfont"><code class="csfmt">\glsabbrvsmfont</code></a> and <a id="wrglossary.2301"></a><a href="#glo:glsfirstabbrvsmfont"><code class="csfmt">\glsfirstabbrvsmfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2302"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2303"></a><a href="#glo:opt.abbrstyle.long-short-sm"><span class="abbrstylefmt">long-short-sm</span></a>}<p>
+<a id="wrglossary.2304"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2305"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2306"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2307"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2308"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2309"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-short-sm"></a>Example 34: The <span class="optfmt">long-short-sm</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example034.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example034.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example034.png" type="image/png" width="359" height="84">Example document demonstrating the long-short-sm abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2310"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-short-sm-desc"><span class="abbrstylefmt">long-short-sm-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2311"></a><a href="#glo:opt.abbrstyle.long-short-desc"><span class="abbrstylefmt">long-short-desc</span></a> but it uses <a id="wrglossary.2312"></a><a href="#glo:glsxtrsmsuffix"><code class="csfmt">\glsxtrsmsuffix</code></a>, <a id="wrglossary.2313"></a><a href="#glo:glsabbrvsmfont"><code class="csfmt">\glsabbrvsmfont</code></a> and <a id="wrglossary.2314"></a><a href="#glo:glsfirstabbrvsmfont"><code class="csfmt">\glsfirstabbrvsmfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2315"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2316"></a><a href="#glo:opt.abbrstyle.long-short-sm-desc"><span class="abbrstylefmt">long-short-sm-desc</span></a>}<p>
+<a id="wrglossary.2317"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2318"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2319"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2320"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2321"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2322"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2323"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-short-sm-desc"></a>Example 35: The <span class="optfmt">long-short-sm-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example035.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example035.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example035.png" type="image/png" width="359" height="84">Example document demonstrating the long-short-sm-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2324"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-short-em"><span class="abbrstylefmt">long-short-em</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2325"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> but it uses <a id="wrglossary.2326"></a><a href="#glo:glsxtremsuffix"><code class="csfmt">\glsxtremsuffix</code></a>, <a id="wrglossary.2327"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a> and <a id="wrglossary.2328"></a><a href="#glo:glsfirstabbrvemfont"><code class="csfmt">\glsfirstabbrvemfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2329"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2330"></a><a href="#glo:opt.abbrstyle.long-short-em"><span class="abbrstylefmt">long-short-em</span></a>}<p>
+<a id="wrglossary.2331"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2332"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2333"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2334"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2335"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2336"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-short-em"></a>Example 36: The <span class="optfmt">long-short-em</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example036.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example036.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example036.png" type="image/png" width="359" height="84">Example document demonstrating the long-short-em abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2337"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-short-em-desc"><span class="abbrstylefmt">long-short-em-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2338"></a><a href="#glo:opt.abbrstyle.long-short-desc"><span class="abbrstylefmt">long-short-desc</span></a> but it uses <a id="wrglossary.2339"></a><a href="#glo:glsxtremsuffix"><code class="csfmt">\glsxtremsuffix</code></a>, <a id="wrglossary.2340"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a> and <a id="wrglossary.2341"></a><a href="#glo:glsfirstabbrvemfont"><code class="csfmt">\glsfirstabbrvemfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2342"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2343"></a><a href="#glo:opt.abbrstyle.long-short-em-desc"><span class="abbrstylefmt">long-short-em-desc</span></a>}<p>
+<a id="wrglossary.2344"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2345"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2346"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2347"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2348"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2349"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2350"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-short-em-desc"></a>Example 37: The <span class="optfmt">long-short-em-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example037.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example037.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example037.png" type="image/png" width="359" height="84">Example document demonstrating the long-short-em-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2351"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-em-short-em"><span class="abbrstylefmt">long-em-short-em</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2352"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> but it uses <a id="wrglossary.2353"></a><a href="#glo:glsxtremsuffix"><code class="csfmt">\glsxtremsuffix</code></a>, <a id="wrglossary.2354"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a> and <a id="wrglossary.2355"></a><a href="#glo:glsfirstabbrvemfont"><code class="csfmt">\glsfirstabbrvemfont</code></a>, <a id="wrglossary.2356"></a><a href="#glo:glsfirstlongemfont"><code class="csfmt">\glsfirstlongemfont</code></a> and <a id="wrglossary.2357"></a><a href="#glo:glslongemfont"><code class="csfmt">\glslongemfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>). That is, both the long and short forms are emphasized.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2358"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2359"></a><a href="#glo:opt.abbrstyle.long-em-short-em"><span class="abbrstylefmt">long-em-short-em</span></a>}<p>
+<a id="wrglossary.2360"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2361"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2362"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2363"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2364"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2365"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-em-short-em"></a>Example 38: The <span class="optfmt">long-em-short-em</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example038.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example038.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example038.png" type="image/png" width="360" height="84">Example document demonstrating the long-em-short-em abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2366"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-em-short-em-desc"><span class="abbrstylefmt">long-em-short-em-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2367"></a><a href="#glo:opt.abbrstyle.long-short-desc"><span class="abbrstylefmt">long-short-desc</span></a> but it uses <a id="wrglossary.2368"></a><a href="#glo:glsxtremsuffix"><code class="csfmt">\glsxtremsuffix</code></a>, <a id="wrglossary.2369"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a> and <a id="wrglossary.2370"></a><a href="#glo:glsfirstabbrvemfont"><code class="csfmt">\glsfirstabbrvemfont</code></a>, <a id="wrglossary.2371"></a><a href="#glo:glsfirstlongemfont"><code class="csfmt">\glsfirstlongemfont</code></a> and <a id="wrglossary.2372"></a><a href="#glo:glslongemfont"><code class="csfmt">\glslongemfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>). That is, both the long and short forms are emphasized.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2373"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2374"></a><a href="#glo:opt.abbrstyle.long-em-short-em-desc"><span class="abbrstylefmt">long-em-short-em-desc</span></a>}<p>
+<a id="wrglossary.2375"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2376"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2377"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2378"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2379"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2380"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2381"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-em-short-em-desc"></a>Example 39: The <span class="optfmt">long-em-short-em-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example039.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example039.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example039.png" type="image/png" width="360" height="84">Example document demonstrating the long-em-short-em-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+
+</section><!-- end of section sec:predefnonregabbrvstyleslongshort -->
+
+<section id="sec:predefnonregabbrvstyleslongshortuser"><!-- start of section sec:predefnonregabbrvstyleslongshortuser --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.1.2.2. Long (Short, User) Styles<div class="labellink"><a href="#sec:predefnonregabbrvstyleslongshortuser">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These styles are like the long (short) styles in §<a href="#sec:predefnonregabbrvstyleslongshort">4.5.1.2.1</a> but additional content can be supplied in the field identified by <a id="wrglossary.2382"></a><a href="#glo:glsxtruserfield"><code class="csfmt">\glsxtruserfield</code></a>, which will be placed in the parenthetical content on <a id="wrglossary.2383"></a><a href="#glo:dual.firstuse">first use</a> (if set). The <a id="wrglossary.2384"></a><a href="#glo:dual.inlinefullform">inline full form</a> is the same as the <a id="wrglossary.2385"></a><a href="#glo:dual.displayfullform">display full form</a>.<p>
+These styles use the commands <a id="wrglossary.2386"></a><a href="#glo:glsxtrusersuffix"><code class="csfmt">\glsxtrusersuffix</code></a>, <a id="wrglossary.2387"></a><a href="#glo:glsabbrvuserfont"><code class="csfmt">\glsabbrvuserfont</code></a>, <a id="wrglossary.2388"></a><a href="#glo:glsfirstabbrvuserfont"><code class="csfmt">\glsfirstabbrvuserfont</code></a>, <a id="wrglossary.2389"></a><a href="#glo:glslonguserfont"><code class="csfmt">\glslonguserfont</code></a> and <a id="wrglossary.2390"></a><a href="#glo:glsfirstlonguserfont"><code class="csfmt">\glsfirstlonguserfont</code></a> (except where noted). See §<a href="#sec:abbrvcmdsgeneral">4.5.1.3.1</a> and §<a href="#sec:abbrvcmdsuser">4.5.1.3.3</a> for style commands.<p>
+If you need to change the font, you can redefine the associated commands (listed above). However, since <a id="wrglossary.2391"></a><a href="#glo:idx.smallcaps">small caps</a> are awkward because the short plural suffix needs to counteract the <a id="wrglossary.2392"></a><a href="#glo:idx.smallcaps">small caps</a>, <a id="wrglossary.2393"></a><a href="#glo:idx.smallcaps">small caps</a> versions are provided.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2394"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2395"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> but it includes the additional content in the parentheses on <a id="wrglossary.2396"></a><a href="#glo:dual.firstuse">first use</a> or the <a id="wrglossary.2397"></a><a href="#glo:dual.inlinefullform">inline full form</a>. The description is obtained from <a id="wrglossary.2398"></a><a href="#glo:glsuserdescription"><code class="csfmt">\glsuserdescription</code></a>, which can be redefined to include the additional information, if required.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2399"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2400"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a>}<p>
+<a id="wrglossary.2401"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2402"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={extra info}</span>]{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2403"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2404"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2405"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2406"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2407"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-short-user"></a>Example 40: The <span class="optfmt">long-short-user</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example040.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example040.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example040.png" type="image/png" width="358" height="97">Example document demonstrating the long-short-user abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2408"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-short-user-desc"><span class="abbrstylefmt">long-short-user-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2409"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a> but the description must be supplied. The name is obtained from <a id="wrglossary.2410"></a><a href="#glo:glsxtrlongshortuserdescname"><code class="csfmt">\glsxtrlongshortuserdescname</code></a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2411"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2412"></a><a href="#glo:opt.abbrstyle.long-short-user-desc"><span class="abbrstylefmt">long-short-user-desc</span></a>}<p>
+<a id="wrglossary.2413"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2414"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>,<br><a id="wrglossary.2415"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={extra info}</span>]{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2416"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2417"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2418"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2419"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2420"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-short-user-desc"></a>Example 41: The <span class="optfmt">long-short-user-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example041.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example041.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example041.png" type="image/png" width="358" height="98">Example document demonstrating the long-short-user-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+This style is incompatible with <a id="wrglossary.2421"></a><a href="#glo:GLSname"><code class="csfmt">\GLSname</code></a>. </div><!-- end of important -->
+<p>
+If you need to use <a id="wrglossary.2422"></a><a href="#glo:GLSname"><code class="csfmt">\GLSname</code></a> with this style, you’ll have to redefine <a id="wrglossary.2423"></a><a href="#glo:glsxtrlongshortuserdescname"><code class="csfmt">\glsxtrlongshortuserdescname</code></a> so that the field name doesn’t include the entry label. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<a id="wrglossary.2424"></a><a href="#glo:glsxtrlongshortuserdescname"><code class="csfmt">\glsxtrlongshortuserdescname</code></a>}{%
+ <code class="cmd">\protect</code><a id="wrglossary.2425"></a><a href="#glo:glslonguserfont"><code class="csfmt">\glslonguserfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.2426"></a><a href="#glo:glslongtok"><code class="csfmt">\glslongtok</code></a>}%
+ <code class="cmd">\space</code>(<code class="cmd">\protect</code><a id="wrglossary.2427"></a><a href="#glo:glsabbrvuserfont"><code class="csfmt">\glsabbrvuserfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.2428"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a>})%
}
-</pre>
-<!--l. 3816--><p class="nopar" > will insert section-level bookmarks. The use of <span
-class="cmtt-10">\currentglossary </span>helps to provide
-unique bookmark labels in the event of multiple glossaries.
-</p><!--l. 3821--><p class="indent" > The <span
-class="cmss-10">glossary-tree</span><a
- id="dx1-22033"></a> package provides the commands
-</p><!--l. 3822--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22034"></a> <span
-class="cmtt-10">\glstreepredesc </span></div><hr>
-</p><!--l. 3824--><p class="noindent" >
-and
-</p><!--l. 3826--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22035"></a> <span
-class="cmtt-10">\glstreechildpredesc </span></div><hr>
-</p><!--l. 3828--><p class="noindent" >
-(which both default to a space) and uses them in the <span
-class="cmss-10">tree</span><a
- id="dx1-22036"></a>-like styles, but not for the
-<span
-class="cmss-10">alttree</span><a
- id="dx1-22037"></a> style. The <span
-class="cmss-10">glossaries-extra-stylemods</span><a
- id="dx1-22038"></a> package modifies the <span
-class="cmss-10">alttree</span><a
- id="dx1-22039"></a> style so that it
-has equivalent hooks:
-</p><!--l. 3833--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22040"></a> <span
-class="cmtt-10">\glsalttreepredesc </span></div><hr>
-</p><!--l. 3835--><p class="noindent" >
-and
-</p><!--l. 3837--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22041"></a> <span
-class="cmtt-10">\glsalttreechildpredesc </span></div><hr>
-</p><!--l. 3839--><p class="noindent" >
-These do nothing by default.
-</p><!--l. 3842--><p class="indent" > The <span
-class="cmss-10">index</span><a
- id="dx1-22042"></a>-like and <span
-class="cmss-10">tree</span><a
- id="dx1-22043"></a>-like styles insert the pre-<a
- id="dx1-22044"></a><a
-href="#glo:numberlist">number list</a> space with
-</p><!--l. 3844--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22045"></a> <span
-class="cmtt-10">\glstreeprelocation </span></div><hr>
-</p><!--l. 3846--><p class="noindent" >
-(which defaults to <span
-class="cmtt-10">\glsxtrprelocation</span>) for top-level items and
-</p><!--l. 3848--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22046"></a> <span
-class="cmtt-10">\glstreechildprelocation </span></div><hr>
-</p><!--l. 3850--><p class="noindent" >
-(which defaults to <span
-class="cmtt-10">\glstreeprelocation</span>) for child items.
-</p><!--l. 3853--><p class="indent" > As from version 1.31, the <span
-class="cmss-10">glossaries-extra-stylemods </span>package also provides:
-</p><!--l. 3855--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22047"></a> <span
-class="cmtt-10">\glstreenonamedesc{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3857--><p class="noindent" >
-which is used by the <span
-class="cmss-10">treenoname</span><a
- id="dx1-22048"></a> styles to display the pre-description separator, the
-description and the post-description hook. Similarly for the symbol:
-</p><!--l. 3861--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22049"></a> <span
-class="cmtt-10">\glstreenonamesymbol{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3863--><p class="noindent" >
-The above are just used for top-level entries. Child entries don&#8217;t have the name or
-symbol displayed for the <span
-class="cmss-10">treenoname</span><a
- id="dx1-22050"></a> styles, so there&#8217;s only a command for the child
-description:
-</p><!--l. 3867--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22051"></a> <span
-class="cmtt-10">\glstreenonamechilddesc{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3869--><p class="noindent" >
-
-
-
-</p><!--l. 3871--><p class="indent" > For the <span
-class="cmss-10">tree</span><a
- id="dx1-22052"></a> styles (but not the <span
-class="cmss-10">treenoname</span><a
- id="dx1-22053"></a> or <span
-class="cmss-10">alttree</span><a
- id="dx1-22054"></a> styles), the description is
-displayed using:
-</p><!--l. 3873--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22055"></a> <span
-class="cmtt-10">\glstreedesc{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3875--><p class="noindent" >
-and the symbol with:
-</p><!--l. 3877--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22056"></a> <span
-class="cmtt-10">\glstreesymbol{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3879--><p class="noindent" >
-Again the above two commands are just for top-level entries. The child entries
-use:
-</p><!--l. 3882--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22057"></a> <span
-class="cmtt-10">\glstreechilddesc{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3884--><p class="noindent" >
-for the description and
-</p><!--l. 3886--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22058"></a> <span
-class="cmtt-10">\glstreechildsymbol{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3888--><p class="noindent" >
-for the symbol. As from version 1.41, there are now wrapper commands
-for <span
-class="cmtt-10">\glstreedesc </span>and <span
-class="cmtt-10">\glstreechilddesc </span>that check for the description
-and symbol to determine what separator to use before the page list. These
-are:
-</p><!--l. 3894--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22059"></a> <span
-class="cmtt-10">\glstreeDescLoc{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3896--><p class="noindent" >
-for top-level entries and
-</p><!--l. 3898--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22060"></a> <span
-class="cmtt-10">\glstreeChildDescLoc{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3900--><p class="noindent" >
-for sub-entries.
-</p><!--l. 3903--><p class="indent" > If either the symbol or description is present these will use <span
-class="cmtt-10">\glstreeprelocation</span>
-or <span
-class="cmtt-10">\glstreechildprelocation</span>, respectively. Otherwise, both will use (from
-v1.42):
-</p><!--l. 3906--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22061"></a> <span
-class="cmtt-10">\glstreeNoDescSymbolPreLocation </span></div><hr>
-</p><!--l. 3908--><p class="noindent" >
-The default is a space. This means that you could have, say, a comma followed by a
-space for terms that are simply an alias, but just have a space for terms that have a
-description that ends with a full stop (or that just have a symbol without a
-description) where the comma would be inappropriate.
-</p><!--l. 3915--><p class="indent" > Note that version 1.42 has corrected an error that was introduced to v1.41 that
-caused the name to run into the location list if there was no symbol and no
-description.
-</p><!--l. 3919--><p class="indent" > As from version 1.05, the <span
-class="cmss-10">glossaries-extra-stylemods </span>package provides some
-additional commands for use with the <span
-class="cmss-10">alttree</span><a
- id="dx1-22062"></a> style to make it easier to modify. These
-commands are only defined if the <span
-class="cmss-10">glossary-tree</span><a
- id="dx1-22063"></a> package has already been loaded,
-which is typically the case unless the <a
-href="#styopt.notree"><span
-class="cmss-10">notree</span></a><a
- id="dx1-22064"></a> option has been used when loading
-<span
-class="cmss-10">glossaries</span>.
-</p><!--l. 3927--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22065"></a> <span
-class="cmtt-10">\gglssetwidest[</span>&#x27E8;<span
-class="cmitt-10">level</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">name</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3929--><p class="noindent" >
-(New to version 1.21.) This is like <span
-class="cmtt-10">\glssetwidest </span>(provided by <span
-class="cmss-10">glossary-tree</span><a
- id="dx1-22066"></a>) but
-performs a global assignment.
-</p><!--l. 3934--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22067"></a> <span
-class="cmtt-10">\eglssetwidest[</span>&#x27E8;<span
-class="cmitt-10">level</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">name</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-
-
-
-</p><!--l. 3936--><p class="noindent" >
-This is like <span
-class="cmtt-10">\glssetwidest </span>but performs a protected expansion on &#x27E8;<span
-class="cmti-10">name</span>&#x27E9;. This has a
-localised effect. For a global setting, use
-</p><!--l. 3940--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22068"></a> <span
-class="cmtt-10">\xglssetwidest[</span>&#x27E8;<span
-class="cmitt-10">level</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">name</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3942--><p class="noindent" >
-The following only set the value if &#x27E8;<span
-class="cmti-10">name</span>&#x27E9; is wider than the current value (new to
-version 1.23). Local update:
-</p><!--l. 3945--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22069"></a> <span
-class="cmtt-10">\glsupdatewidest[</span>&#x27E8;<span
-class="cmitt-10">level</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">name</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3947--><p class="noindent" >
-Global update:
-</p><!--l. 3949--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22070"></a> <span
-class="cmtt-10">\gglsupdatewidest[</span>&#x27E8;<span
-class="cmitt-10">level</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">name</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3951--><p class="noindent" >
-Locale update (expands &#x27E8;<span
-class="cmti-10">name</span>&#x27E9;):
-</p><!--l. 3953--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22071"></a> <span
-class="cmtt-10">\eglsupdatewidest[</span>&#x27E8;<span
-class="cmitt-10">level</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">name</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3955--><p class="noindent" >
-Global update (expands &#x27E8;<span
-class="cmti-10">name</span>&#x27E9;):
-</p><!--l. 3957--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22072"></a> <span
-class="cmtt-10">\xglsupdatewidest[</span>&#x27E8;<span
-class="cmitt-10">level</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">name</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3959--><p class="noindent" >
-</p><!--l. 3962--><p class="indent" > The widest entry value can later be retrieved using
-</p><!--l. 3963--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22073"></a> <span
-class="cmtt-10">\glsgetwidestname </span></div><hr>
-</p><!--l. 3965--><p class="noindent" >
-for the top-level entries and
-</p><!--l. 3967--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22074"></a> <span
-class="cmtt-10">\glsgetwidestsubname{</span>&#x27E8;<span
-class="cmitt-10">level</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 3969--><p class="noindent" >
-for sub-entries, where &#x27E8;<span
-class="cmti-10">level</span>&#x27E9; is the level number.
-</p><!--l. 3972--><p class="indent" > Note that if you are using <a
- id="dx1-22075"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a>, you can use the resource option <span
-class="cmtt-10">set-widest</span>
-which will try to determine the widest name of all the selected entries. This isn&#8217;t
-guaranteed to work as it may depend on fonts or commands that <a
- id="dx1-22076"></a><span
-class="cmtt-10">bib2gls</span>
-can&#8217;t replicate, but it should be suitable for names that just consist of text,
-and can be more efficient than iterating over all the defined entries using
-TeX.
-</p><!--l. 3980--><p class="indent" > The command <span
-class="cmtt-10">\glsfindwidesttoplevelname </span>provided by <span
-class="cmss-10">glossary-tree</span><a
- id="dx1-22077"></a> has a
-CamelCase synonym:
-</p><!--l. 3982--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22078"></a> <span
-class="cmtt-10">\glsFindWidestTopLevelName[</span>&#x27E8;<span
-class="cmitt-10">glossary list</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 3984--><p class="noindent" >
-Similar commands are also provided:
-</p><!--l. 3986--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22079"></a> <span
-class="cmtt-10">\glsFindWidestUsedTopLevelName[</span>&#x27E8;<span
-class="cmitt-10">glossary list</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 3988--><p class="noindent" >
-This has an additional check that the entry has been used. Naturally this is only
-useful if the glossaries that use the <span
-class="cmss-10">alttree</span><a
- id="dx1-22080"></a> style occur at the end of the document.
-This command should be placed just before the start of the glossary. (Alternatively,
-place it at the end of the document and save the value in the auxiliary file for the
-next run.)
-</p><!--l. 3996--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22081"></a> <span
-class="cmtt-10">\glsFindWidestUsedAnyName[</span>&#x27E8;<span
-class="cmitt-10">glossary list</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-
-
-
-</p><!--l. 3998--><p class="noindent" >
-This is like the previous command but if doesn&#8217;t check the <span
-class="cmss-10">parent</span><a
- id="dx1-22082"></a> key. This is useful if
-all levels should have the same width for the name.
-</p><!--l. 4003--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22083"></a> <span
-class="cmtt-10">\glsFindWidestAnyName[</span>&#x27E8;<span
-class="cmitt-10">glossary list</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 4005--><p class="noindent" >
-This is like the previous command but doesn&#8217;t check if the entry has been
-used.
-</p><!--l. 4009--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22084"></a> <span
-class="cmtt-10">\glsFindWidestUsedLevelTwo[</span>&#x27E8;<span
-class="cmitt-10">glossary list</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 4011--><p class="noindent" >
-This is like <span
-class="cmtt-10">\glsFindWidestUsedTopLevelName </span>but also sets the first two sub-levels
-as well. Any entry that has a great-grandparent is ignored.
-</p><!--l. 4016--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22085"></a> <span
-class="cmtt-10">\glsFindWidestLevelTwo[</span>&#x27E8;<span
-class="cmitt-10">glossary list</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 4018--><p class="noindent" >
-This is like the previous command but doesn&#8217;t check if the entry has been
-used.
-</p><!--l. 4022--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22086"></a> <span
-class="cmtt-10">\glsFindWidestUsedAnyNameSymbol[</span>&#x27E8;<span
-class="cmitt-10">glossary list</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">register</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 4025--><p class="noindent" >
-This is like <span
-class="cmtt-10">\glsFindWidestUsedAnyName </span>but also measures the symbol. The length
-of the widest symbol is stored in &#x27E8;<span
-class="cmti-10">register</span>&#x27E9;.
-</p><!--l. 4030--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22087"></a> <span
-class="cmtt-10">\glsFindWidestAnyNameSymbol[</span>&#x27E8;<span
-class="cmitt-10">glossary list</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">register</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4032--><p class="noindent" >
-This is like the previous command but it doesn&#8217;t check if the entry has been
-used.
-</p><!--l. 4036--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22088"></a> <span
-class="cmtt-10">\glsFindWidestUsedAnyNameSymbolLocation[</span>&#x27E8;<span
-class="cmitt-10">glossary list</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">symbol</span>
-<span
-class="cmitt-10">register</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location register</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4039--><p class="noindent" >
-This is like <span
-class="cmtt-10">\glsFindWidestUsedAnyNameSymbol </span>but also measures the <a
- id="dx1-22089"></a><a
-href="#glo:numberlist">number list</a>.
-This requires <span
-class="cmtt-10">\glsentrynumberlist</span><a
- id="dx1-22090"></a> (see the <span
-class="cmss-10">glossaries </span>user manual). The length of
-the widest symbol is stored in &#x27E8;<span
-class="cmti-10">symbol register</span>&#x27E9; and the length of the widest <a
- id="dx1-22091"></a>number
-list is stored in &#x27E8;<span
-class="cmti-10">location register</span>&#x27E9;.
-</p><!--l. 4047--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22092"></a> <span
-class="cmtt-10">\glsFindWidestAnyNameSymbolLocation[</span>&#x27E8;<span
-class="cmitt-10">glossary list</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">symbol</span>
-<span
-class="cmitt-10">register</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location register</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4050--><p class="noindent" >
-This is like the previous command but it doesn&#8217;t check if the entry has been
-used.
-</p><!--l. 4054--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22093"></a> <span
-class="cmtt-10">\glsFindWidestUsedAnyNameLocation[</span>&#x27E8;<span
-class="cmitt-10">glossary list</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">register</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 4057--><p class="noindent" >
-This is like <span
-class="cmtt-10">\glsFindWidestUsedAnyNameSymbolLocation </span>but doesn&#8217;t measure the
-symbol. The length of the widest <a
- id="dx1-22094"></a>number list is stored in &#x27E8;<span
-class="cmti-10">register</span>&#x27E9;.
-</p><!--l. 4062--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22095"></a> <span
-class="cmtt-10">\glsFindWidestAnyNameLocation[</span>&#x27E8;<span
-class="cmitt-10">glossary list</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">register</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4065--><p class="noindent" >
-This is like the previous command but doesn&#8217;t check if the entry has been
-used.
-</p><!--l. 4069--><p class="indent" > The layout of the symbol, description and <a
- id="dx1-22096"></a>number list is governed by
-
-
-
-</p><!--l. 4071--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22097"></a> <span
-class="cmtt-10">\glsxtralttreeSymbolDescLocation{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">number list</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4073--><p class="noindent" >
-for top-level entries and
-</p><!--l. 4075--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22098"></a> <span
-class="cmtt-10">\glsxtralttreeSubSymbolDescLocation{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">number list</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4077--><p class="noindent" >
-for sub-entries.
-</p><!--l. 4080--><p class="indent" > There is now a user level command that performs the initialisation for the <span
-class="cmss-10">alttree</span><a
- id="dx1-22099"></a>
-style:
-</p><!--l. 4082--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22100"></a> <span
-class="cmtt-10">\glsxtralttreeInit </span></div><hr>
-</p><!--l. 4084--><p class="noindent" >
-</p><!--l. 4086--><p class="indent" > The paragraph indent for subsequent paragraphs in multi-paragraph descriptions
-is provided by the length
-</p><!--l. 4088--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22101"></a> <span
-class="cmtt-10">\glsxtrAltTreeIndent </span></div><hr>
-</p><!--l. 4090--><p class="noindent" >
-</p><!--l. 4092--><p class="indent" > For additional commands that are available with the <span
-class="cmss-10">alttree</span><a
- id="dx1-22102"></a> style,
-see the documented code (<span
-class="cmtt-10">glossaries-extra-code.pdf</span>). See also the
-accompanying sample files <span
-class="cmtt-10">sample-alttree.tex</span>, <span
-class="cmtt-10">sample-alttree-sym.tex </span>and
-<span
-class="cmtt-10">sample-alttree-marginpar.tex</span>.
-
-
-
-</p>
-<!--l. 4099--><p class="indent" > </div>
-</p><!--l. 4099--><p class="noindent" ><a
-href="#top">Top</a><div class="chapter"><h2 class="chapterHead">3. <a
- id="sec:newglossarystyles"></a>New Glossary Styles</h2>
-</p><!--l. 4102--><p class="indent" > The <span
-class="cmss-10">glossaries-extra </span>package comes with some new styles. The associated style
-package needs to be loaded. This can be done with <span
-class="cmtt-10">\usepackage </span>but it&#8217;s simpler to
-use the <a
-href="#styopt.stylemods"><span
-class="cmss-10">stylemods</span></a><a
- id="dx1-23001"></a> option.
-</p>
-<!--l. 4107--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">3.1 </span> <a
- id="sec:bookindex"></a>glossary-bookindex package</h3>
-<!--l. 4110--><p class="noindent" >As from v1.21, <span
-class="cmss-10">glossaries-extra </span>has a new supplementary package <span
-class="cmss-10">glossary-bookindex</span><a
- id="dx1-24001"></a>
-which provides the glossary style <span
-class="cmss-10">bookindex</span><a
- id="dx1-24002"></a>. This is very similar to the <span
-class="cmss-10">mcolindexgroup</span><a
- id="dx1-24003"></a>
-style but is designed for indexes, so by default only the name and location list
-are displayed. You can either load this package explicitly and then set the
-style:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-120">
-\usepackage{glossaries-extra}
-\usepackage{glossary-bookindex}
-\setglossarystyle{bookindex}
-</pre>
-<!--l. 4120--><p class="nopar" > or use both the <a
-href="#styopt.stylemods"><span
-class="cmss-10">stylemods</span></a><a
- id="dx1-24004"></a> and <span
-class="cmss-10">style</span><a
- id="dx1-24005"></a> options:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-121">
-\usepackage[stylemods=bookindex,style=bookindex]{glossaries-extra}
-</pre>
-<!--l. 4124--><p class="nopar" > The <span
-class="cmss-10">bookindex</span><a
- id="dx1-24006"></a> style only supports a maximum hierarchical level of 2 (top-level,
-level&#x00A0;1 and level&#x00A0;2). It&#8217;s primarily designed for use with <a
- id="dx1-24007"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a>. It may be used
-with other indexing options, but some features may not be present and UTF-8
-characters may cause a problem with non-Unicode engines in letter group
-headings or PDF bookmarks. (<a
- id="dx1-24008"></a><span
-class="cmtt-10">bib2gls </span>uses numeric identifies by default to
-avoid these problems. If numbers show up in the group headings instead of
-the appropriate characters, check that you have used the <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><a
- id="dx1-24009"></a> package
-option.)
-</p><!--l. 4135--><p class="indent" > The number of columns is given by
-</p><!--l. 4136--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24010"></a> <span
-class="cmtt-10">\glsxtrbookindexcols </span></div><hr>
-</p><!--l. 4138--><p class="noindent" >
-which defaults to 2.
-</p><!--l. 4141--><p class="indent" > This style uses the <span
-class="cmss-10">multicols</span><a
- id="dx1-24011"></a><a
- id="dx1-24012"></a> environment. If the command
-</p><!--l. 4143--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24013"></a> <span
-class="cmtt-10">\glsxtrbookindexcolspread </span></div><hr>
-</p><!--l. 4145--><p class="noindent" >
-isn&#8217;t empty then it&#8217;s supplied as the optional argument following <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\begin{multicols}</span></span></span>
-<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmti-10">n</span>&#x27E9;<span
-class="cmtt-10">}</span>. You can switch from <span
-class="cmss-10">multicols</span><a
- id="dx1-24014"></a><a
- id="dx1-24015"></a> to <span
-class="cmss-10">multicols*</span><a
- id="dx1-24016"></a><a
- id="dx1-24017"></a> by redefining
-</p><!--l. 4149--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24018"></a> <span
-class="cmtt-10">\glsxtrbookindexmulticolsenv </span></div><hr>
-</p><!--l. 4151--><p class="noindent" >
-For example
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-122">
-\renewcommand{\glsxtrbookindexmulticolsenv}{multicols*}
-</pre>
-<!--l. 4155--><p class="nopar" >
-</p><!--l. 4157--><p class="indent" > Each top-level entry is displayed using
-</p><!--l. 4158--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24019"></a> <span
-class="cmtt-10">\glsxtrbookindexname{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4160--><p class="noindent" >
-where the entry is identified by &#x27E8;<span
-class="cmti-10">label</span>&#x27E9;. This just does <span
-class="cmtt-10">\glossentryname{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span>by
-default. For example, if you want the symbol to be included:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-123">
-\renewcommand*{\glsxtrbookindexname}[1]{%
-&#x00A0;\glossentryname{#1}%
-&#x00A0;\ifglshassymbol{#1}{\space&#x00A0;(\glossentrysymbol{#1})}{}%
+</pre><p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2429"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-postshort-user"><span class="abbrstylefmt">long-postshort-user</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2430"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a> but the parenthetical material is placed in the <a id="wrglossary.2431"></a><a href="#glo:dual.postlinkhook">post-link hook</a>. Note that, unlike <a id="wrglossary.2432"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a>, the plural form isn’t used in the parenthetical material. If you require this, you will need to redefine <a id="wrglossary.2433"></a><a href="#glo:glsxtrpostusershortformat"><code class="csfmt">\glsxtrpostusershortformat</code></a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2434"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2435"></a><a href="#glo:opt.abbrstyle.long-postshort-user"><span class="abbrstylefmt">long-postshort-user</span></a>}<p>
+<a id="wrglossary.2436"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2437"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={extra info}</span>]{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2438"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2439"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2440"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2441"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2442"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-postshort-user"></a>Example 42: The <span class="optfmt">long-postshort-user</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example042.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example042.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example042.png" type="image/png" width="358" height="97">Example document demonstrating the long-postshort-user abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2443"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-postshort-user-desc"><span class="abbrstylefmt">long-postshort-user-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2444"></a><a href="#glo:opt.abbrstyle.long-postshort-user"><span class="abbrstylefmt">long-postshort-user</span></a> but the description must be supplied. The name is obtained from <a id="wrglossary.2445"></a><a href="#glo:glsxtrlongshortuserdescname"><code class="csfmt">\glsxtrlongshortuserdescname</code></a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2446"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2447"></a><a href="#glo:opt.abbrstyle.long-postshort-user-desc"><span class="abbrstylefmt">long-postshort-user-desc</span></a>}<p>
+<a id="wrglossary.2448"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2449"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>,<br><a id="wrglossary.2450"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={extra info}</span>]{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2451"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2452"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2453"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2454"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2455"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-postshort-user-desc"></a>Example 43: The <span class="optfmt">long-postshort-user-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example043.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example043.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example043.png" type="image/png" width="358" height="98">Example document demonstrating the long-postshort-user-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+This style is incompatible with <a id="wrglossary.2456"></a><a href="#glo:GLSname"><code class="csfmt">\GLSname</code></a>. </div><!-- end of important -->
+<p>
+If you need to use <a id="wrglossary.2457"></a><a href="#glo:GLSname"><code class="csfmt">\GLSname</code></a> with this style, you’ll have to redefine <a id="wrglossary.2458"></a><a href="#glo:glsxtrshortlonguserdescname"><code class="csfmt">\glsxtrshortlonguserdescname</code></a> so that the field name doesn’t include the entry label, as for <a id="wrglossary.2459"></a><a href="#glo:opt.abbrstyle.long-short-user-desc"><span class="abbrstylefmt">long-short-user-desc</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2460"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-postshort-sc-user"><span class="abbrstylefmt">long-postshort-sc-user</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2461"></a><a href="#glo:opt.abbrstyle.long-postshort-user"><span class="abbrstylefmt">long-postshort-user</span></a> but it uses <a id="wrglossary.2462"></a><a href="#glo:glsxtrscusersuffix"><code class="csfmt">\glsxtrscusersuffix</code></a>, <a id="wrglossary.2463"></a><a href="#glo:glsabbrvscuserfont"><code class="csfmt">\glsabbrvscuserfont</code></a> and <a id="wrglossary.2464"></a><a href="#glo:glsfirstabbrvscuserfont"><code class="csfmt">\glsfirstabbrvscuserfont</code></a>. The name value is obtained from <a id="wrglossary.2465"></a><a href="#glo:glsxtrlongshortscusername"><code class="csfmt">\glsxtrlongshortscusername</code></a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2466"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2467"></a><a href="#glo:opt.abbrstyle.long-postshort-sc-user"><span class="abbrstylefmt">long-postshort-sc-user</span></a>}<p>
+<a id="wrglossary.2468"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2469"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={extra info}</span>]{ex}{shrt fm}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2470"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2471"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2472"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2473"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2474"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-postshort-sc-user"></a>Example 44: The <span class="optfmt">long-postshort-sc-user</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example044.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example044.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example044.png" type="image/png" width="358" height="97">Example document demonstrating the long-postshort-sc-user abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2475"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-postshort-sc-user-desc"><span class="abbrstylefmt">long-postshort-sc-user-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2476"></a><a href="#glo:opt.abbrstyle.long-postshort-sc-user"><span class="abbrstylefmt">long-postshort-sc-user</span></a> but the description must be supplied. The name is obtained from <a id="wrglossary.2477"></a><a href="#glo:glsxtrlongshortuserdescname"><code class="csfmt">\glsxtrlongshortuserdescname</code></a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2478"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2479"></a><a href="#glo:opt.abbrstyle.long-postshort-sc-user-desc"><span class="abbrstylefmt">long-postshort-sc-user-desc</span></a>}<p>
+<a id="wrglossary.2480"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2481"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>,<br><a id="wrglossary.2482"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={extra info}</span>]{ex}{shrt fm}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2483"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2484"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2485"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2486"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2487"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-postshort-sc-user-desc"></a>Example 45: The <span class="optfmt">long-postshort-sc-user-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example045.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example045.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example045.png" type="image/png" width="358" height="98">Example document demonstrating the long-postshort-sc-user-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+This style is incompatible with <a id="wrglossary.2488"></a><a href="#glo:GLSname"><code class="csfmt">\GLSname</code></a>. </div><!-- end of important -->
+<p>
+If you need to use <a id="wrglossary.2489"></a><a href="#glo:GLSname"><code class="csfmt">\GLSname</code></a> with this style, you’ll have to redefine <a id="wrglossary.2490"></a><a href="#glo:glsxtrlongshortscuserdescname"><code class="csfmt">\glsxtrlongshortscuserdescname</code></a> so that the field name doesn’t include the entry label.<p>
+
+</section><!-- end of section sec:predefnonregabbrvstyleslongshortuser -->
+
+<section id="sec:predefnonregabbrvstylesshortlong"><!-- start of section sec:predefnonregabbrvstylesshortlong --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.1.2.3. Short (Long) Styles<div class="labellink"><a href="#sec:predefnonregabbrvstylesshortlong">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These styles show the short form followed by the long form in parentheses on <a id="wrglossary.2491"></a><a href="#glo:dual.firstuse">first use</a>. On <a id="wrglossary.2492"></a><a href="#glo:dual.subsequentuse">subsequent use</a> only the short form is shown. See §<a href="#sec:abbrvcmdsgeneral">4.5.1.3.1</a> and §<a href="#sec:abbrvcmdsparen">4.5.1.3.2</a> for style commands.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2493"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></dfn></code></div><!-- end of settingsbox -->
+<p>
+The <span class="meta">〈<em class="metainner">insert</em>〉</span> is placed after the short form on <a id="wrglossary.2494"></a><a href="#glo:dual.firstuse">first use</a> and <a id="wrglossary.2495"></a><a href="#glo:dual.subsequentuse">subsequent use</a> of the <a id="wrglossary.2496"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands. The <a id="wrglossary.2497"></a><a href="#glo:dual.inlinefullform">inline full form</a> is the same as the <a id="wrglossary.2498"></a><a href="#glo:dual.displayfullform">display full form</a> (<a id="wrglossary.2499"></a><a href="#glo:glsxtrshortlongformat"><code class="csfmt">\glsxtrshortlongformat</code></a>). Font variations are available with <a id="wrglossary.2500"></a><a href="#glo:opt.abbrstyle.short-sc-long"><span class="abbrstylefmt">short-sc-long</span></a>, <a id="wrglossary.2501"></a><a href="#glo:opt.abbrstyle.short-sm-long"><span class="abbrstylefmt">short-sm-long</span></a>, <a id="wrglossary.2502"></a><a href="#glo:opt.abbrstyle.short-em-long"><span class="abbrstylefmt">short-em-long</span></a> and <a id="wrglossary.2503"></a><a href="#glo:opt.abbrstyle.short-em-long-em"><span class="abbrstylefmt">short-em-long-em</span></a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2504"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2505"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a>}<p>
+<a id="wrglossary.2506"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2507"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2508"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2509"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2510"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2511"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-long"></a>Example 46: The <span class="optfmt">short-long</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example046.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example046.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example046.png" type="image/png" width="358" height="84">Example document demonstrating the short-long abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+The long form is formatted with <a id="wrglossary.2512"></a><a href="#glo:glsfirstlongdefaultfont"><code class="csfmt">\glsfirstlongdefaultfont</code></a> within the full form and with <a id="wrglossary.2513"></a><a href="#glo:glslongdefaultfont"><code class="csfmt">\glslongdefaultfont</code></a> for the <a id="wrglossary.2514"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> set of commands.<p>
+The short form is formatted with <a id="wrglossary.2515"></a><a href="#glo:glsfirstabbrvdefaultfont"><code class="csfmt">\glsfirstabbrvdefaultfont</code></a> within the full form and with <a id="wrglossary.2516"></a><a href="#glo:glsabbrvdefaultfont"><code class="csfmt">\glsabbrvdefaultfont</code></a> for <a id="wrglossary.2517"></a><a href="#glo:dual.subsequentuse">subsequent use</a> and for the <a id="wrglossary.2518"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> set of commands.<p>
+The name is set to the short form (<a id="wrglossary.2519"></a><a href="#glo:glsxtrlongshortname"><code class="csfmt">\glsxtrlongshortname</code></a>) and the description is set to the unencapsulated long form.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2520"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-long-desc"><span class="abbrstylefmt">short-long-desc</span></dfn></code></div><!-- end of settingsbox -->
+ As <a id="wrglossary.2521"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a> but the description must be supplied in the optional argument of <a id="wrglossary.2522"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>. Font variations are available with <a id="wrglossary.2523"></a><a href="#glo:opt.abbrstyle.short-sc-long-desc"><span class="abbrstylefmt">short-sc-long-desc</span></a>, <a id="wrglossary.2524"></a><a href="#glo:opt.abbrstyle.short-sm-long-desc"><span class="abbrstylefmt">short-sm-long-desc</span></a>, <a id="wrglossary.2525"></a><a href="#glo:opt.abbrstyle.short-em-long-desc"><span class="abbrstylefmt">short-em-long-desc</span></a> and <a id="wrglossary.2526"></a><a href="#glo:opt.abbrstyle.short-em-long-em-desc"><span class="abbrstylefmt">short-em-long-em-desc</span></a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2527"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2528"></a><a href="#glo:opt.abbrstyle.short-long-desc"><span class="abbrstylefmt">short-long-desc</span></a>}<p>
+<a id="wrglossary.2529"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2530"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2531"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2532"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2533"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2534"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2535"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-long-desc"></a>Example 47: The <span class="optfmt">short-long-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example047.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example047.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example047.png" type="image/png" width="358" height="84">Example document demonstrating the short-long-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+The name is set to the short form followed by the long form in parentheses (<a id="wrglossary.2536"></a><a href="#glo:glsxtrshortlongdescname"><code class="csfmt">\glsxtrshortlongdescname</code></a>), and the sort is set to just the short form (<a id="wrglossary.2537"></a><a href="#glo:glsxtrshortlongdescsort"><code class="csfmt">\glsxtrshortlongdescsort</code></a>).<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2538"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-sc-long"><span class="abbrstylefmt">short-sc-long</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2539"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a> but it uses <a id="wrglossary.2540"></a><a href="#glo:glsxtrscsuffix"><code class="csfmt">\glsxtrscsuffix</code></a>, <a id="wrglossary.2541"></a><a href="#glo:glsabbrvscfont"><code class="csfmt">\glsabbrvscfont</code></a> and <a id="wrglossary.2542"></a><a href="#glo:glsfirstabbrvscfont"><code class="csfmt">\glsfirstabbrvscfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2543"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2544"></a><a href="#glo:opt.abbrstyle.short-sc-long"><span class="abbrstylefmt">short-sc-long</span></a>}<p>
+<a id="wrglossary.2545"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{shrt fm}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2546"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2547"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2548"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2549"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2550"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-sc-long"></a>Example 48: The <span class="optfmt">short-sc-long</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example048.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example048.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example048.png" type="image/png" width="359" height="84">Example document demonstrating the short-sc-long abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2551"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-sc-long-desc"><span class="abbrstylefmt">short-sc-long-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2552"></a><a href="#glo:opt.abbrstyle.short-long-desc"><span class="abbrstylefmt">short-long-desc</span></a> but it uses <a id="wrglossary.2553"></a><a href="#glo:glsxtrscsuffix"><code class="csfmt">\glsxtrscsuffix</code></a>, <a id="wrglossary.2554"></a><a href="#glo:glsabbrvscfont"><code class="csfmt">\glsabbrvscfont</code></a> and <a id="wrglossary.2555"></a><a href="#glo:glsfirstabbrvscfont"><code class="csfmt">\glsfirstabbrvscfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2556"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2557"></a><a href="#glo:opt.abbrstyle.short-sc-long-desc"><span class="abbrstylefmt">short-sc-long-desc</span></a>}<p>
+<a id="wrglossary.2558"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2559"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{shrt fm}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2560"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2561"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2562"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2563"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2564"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-sc-long-desc"></a>Example 49: The <span class="optfmt">short-sc-long-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example049.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example049.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example049.png" type="image/png" width="359" height="84">Example document demonstrating the short-sc-long-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2565"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-sm-long"><span class="abbrstylefmt">short-sm-long</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2566"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a> but it uses <a id="wrglossary.2567"></a><a href="#glo:glsxtrsmsuffix"><code class="csfmt">\glsxtrsmsuffix</code></a>, <a id="wrglossary.2568"></a><a href="#glo:glsabbrvsmfont"><code class="csfmt">\glsabbrvsmfont</code></a> and <a id="wrglossary.2569"></a><a href="#glo:glsfirstabbrvsmfont"><code class="csfmt">\glsfirstabbrvsmfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2570"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2571"></a><a href="#glo:opt.abbrstyle.short-sm-long"><span class="abbrstylefmt">short-sm-long</span></a>}<p>
+<a id="wrglossary.2572"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2573"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2574"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2575"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2576"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2577"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-sm-long"></a>Example 50: The <span class="optfmt">short-sm-long</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example050.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example050.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example050.png" type="image/png" width="359" height="84">Example document demonstrating the short-sm-long abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2578"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-sm-long-desc"><span class="abbrstylefmt">short-sm-long-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2579"></a><a href="#glo:opt.abbrstyle.short-long-desc"><span class="abbrstylefmt">short-long-desc</span></a> but it uses <a id="wrglossary.2580"></a><a href="#glo:glsxtrsmsuffix"><code class="csfmt">\glsxtrsmsuffix</code></a>, <a id="wrglossary.2581"></a><a href="#glo:glsabbrvsmfont"><code class="csfmt">\glsabbrvsmfont</code></a> and <a id="wrglossary.2582"></a><a href="#glo:glsfirstabbrvsmfont"><code class="csfmt">\glsfirstabbrvsmfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2583"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2584"></a><a href="#glo:opt.abbrstyle.short-sm-long-desc"><span class="abbrstylefmt">short-sm-long-desc</span></a>}<p>
+<a id="wrglossary.2585"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2586"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2587"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2588"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2589"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2590"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2591"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-sm-long-desc"></a>Example 51: The <span class="optfmt">short-sm-long-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example051.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example051.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example051.png" type="image/png" width="359" height="84">Example document demonstrating the short-sm-long-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2592"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-em-long"><span class="abbrstylefmt">short-em-long</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2593"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a> but it uses <a id="wrglossary.2594"></a><a href="#glo:glsxtremsuffix"><code class="csfmt">\glsxtremsuffix</code></a>, <a id="wrglossary.2595"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a> and <a id="wrglossary.2596"></a><a href="#glo:glsfirstabbrvemfont"><code class="csfmt">\glsfirstabbrvemfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2597"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2598"></a><a href="#glo:opt.abbrstyle.short-em-long"><span class="abbrstylefmt">short-em-long</span></a>}<p>
+<a id="wrglossary.2599"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2600"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2601"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2602"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2603"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2604"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-em-long"></a>Example 52: The <span class="optfmt">short-em-long</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example052.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example052.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example052.png" type="image/png" width="358" height="97">Example document demonstrating the short-em-long abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2605"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-em-long-desc"><span class="abbrstylefmt">short-em-long-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2606"></a><a href="#glo:opt.abbrstyle.short-long-desc"><span class="abbrstylefmt">short-long-desc</span></a> but it uses <a id="wrglossary.2607"></a><a href="#glo:glsxtremsuffix"><code class="csfmt">\glsxtremsuffix</code></a>, <a id="wrglossary.2608"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a> and <a id="wrglossary.2609"></a><a href="#glo:glsfirstabbrvemfont"><code class="csfmt">\glsfirstabbrvemfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2610"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2611"></a><a href="#glo:opt.abbrstyle.short-em-long-desc"><span class="abbrstylefmt">short-em-long-desc</span></a>}<p>
+<a id="wrglossary.2612"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2613"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2614"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2615"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2616"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2617"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2618"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-em-long-desc"></a>Example 53: The <span class="optfmt">short-em-long-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example053.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example053.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example053.png" type="image/png" width="358" height="98">Example document demonstrating the short-em-long-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2619"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-em-long-em"><span class="abbrstylefmt">short-em-long-em</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2620"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a> but it uses <a id="wrglossary.2621"></a><a href="#glo:glsxtremsuffix"><code class="csfmt">\glsxtremsuffix</code></a>, <a id="wrglossary.2622"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a> and <a id="wrglossary.2623"></a><a href="#glo:glsfirstabbrvemfont"><code class="csfmt">\glsfirstabbrvemfont</code></a>, <a id="wrglossary.2624"></a><a href="#glo:glsfirstlongemfont"><code class="csfmt">\glsfirstlongemfont</code></a> and <a id="wrglossary.2625"></a><a href="#glo:glslongemfont"><code class="csfmt">\glslongemfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>). That is, both the long and short forms are emphasized.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2626"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2627"></a><a href="#glo:opt.abbrstyle.short-em-long-em"><span class="abbrstylefmt">short-em-long-em</span></a>}<p>
+<a id="wrglossary.2628"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2629"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2630"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2631"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2632"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2633"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-em-long-em"></a>Example 54: The <span class="optfmt">short-em-long-em</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example054.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example054.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example054.png" type="image/png" width="358" height="97">Example document demonstrating the short-em-long-em abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2634"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-em-long-em-desc"><span class="abbrstylefmt">short-em-long-em-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2635"></a><a href="#glo:opt.abbrstyle.short-long-desc"><span class="abbrstylefmt">short-long-desc</span></a> but it uses <a id="wrglossary.2636"></a><a href="#glo:glsxtremsuffix"><code class="csfmt">\glsxtremsuffix</code></a>, <a id="wrglossary.2637"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a> and <a id="wrglossary.2638"></a><a href="#glo:glsfirstabbrvemfont"><code class="csfmt">\glsfirstabbrvemfont</code></a>, <a id="wrglossary.2639"></a><a href="#glo:glsfirstlongemfont"><code class="csfmt">\glsfirstlongemfont</code></a> and <a id="wrglossary.2640"></a><a href="#glo:glslongemfont"><code class="csfmt">\glslongemfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>). That is, both the long and short forms are emphasized.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2641"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2642"></a><a href="#glo:opt.abbrstyle.short-em-long-em-desc"><span class="abbrstylefmt">short-em-long-em-desc</span></a>}<p>
+<a id="wrglossary.2643"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2644"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2645"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2646"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2647"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2648"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2649"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-em-long-em-desc"></a>Example 55: The <span class="optfmt">short-em-long-em-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example055.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example055.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example055.png" type="image/png" width="358" height="98">Example document demonstrating the short-em-long-em-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+
+</section><!-- end of section sec:predefnonregabbrvstylesshortlong -->
+
+<section id="sec:predefnonregabbrvstylesshortlonguser"><!-- start of section sec:predefnonregabbrvstylesshortlonguser --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.1.2.4. Short (Long, User) Styles<div class="labellink"><a href="#sec:predefnonregabbrvstylesshortlonguser">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These styles are like the short (long) styles in §<a href="#sec:predefnonregabbrvstylesshortlong">4.5.1.2.3</a> but additional content can be supplied in the field identified by <a id="wrglossary.2650"></a><a href="#glo:glsxtruserfield"><code class="csfmt">\glsxtruserfield</code></a>, which will be placed in the parenthetical content on <a id="wrglossary.2651"></a><a href="#glo:dual.firstuse">first use</a> (if set). The <a id="wrglossary.2652"></a><a href="#glo:dual.inlinefullform">inline full form</a> is the same as the <a id="wrglossary.2653"></a><a href="#glo:dual.displayfullform">display full form</a>.<p>
+These styles use the commands <a id="wrglossary.2654"></a><a href="#glo:glsxtrusersuffix"><code class="csfmt">\glsxtrusersuffix</code></a>, <a id="wrglossary.2655"></a><a href="#glo:glsabbrvuserfont"><code class="csfmt">\glsabbrvuserfont</code></a>, <a id="wrglossary.2656"></a><a href="#glo:glsfirstabbrvuserfont"><code class="csfmt">\glsfirstabbrvuserfont</code></a>, <a id="wrglossary.2657"></a><a href="#glo:glslonguserfont"><code class="csfmt">\glslonguserfont</code></a> and <a id="wrglossary.2658"></a><a href="#glo:glsfirstlonguserfont"><code class="csfmt">\glsfirstlonguserfont</code></a> (except where noted). See §<a href="#sec:abbrvcmdsgeneral">4.5.1.3.1</a> and §<a href="#sec:abbrvcmdsuser">4.5.1.3.3</a> for style commands.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2659"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-long-user"><span class="abbrstylefmt">short-long-user</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2660"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a> but it includes the additional content in the parentheses on <a id="wrglossary.2661"></a><a href="#glo:dual.firstuse">first use</a> or the <a id="wrglossary.2662"></a><a href="#glo:dual.inlinefullform">inline full form</a>.<p>
+The description is obtained from <a id="wrglossary.2663"></a><a href="#glo:glsuserdescription"><code class="csfmt">\glsuserdescription</code></a>, which can be redefined to include the additional information, if required.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2664"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2665"></a><a href="#glo:opt.abbrstyle.short-long-user"><span class="abbrstylefmt">short-long-user</span></a>}<p>
+<a id="wrglossary.2666"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2667"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={extra info}</span>]{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2668"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2669"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2670"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2671"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2672"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-long-user"></a>Example 56: The <span class="optfmt">short-long-user</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example056.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example056.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example056.png" type="image/png" width="358" height="97">Example document demonstrating the short-long-user abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2673"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-long-user-desc"><span class="abbrstylefmt">short-long-user-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2674"></a><a href="#glo:opt.abbrstyle.short-long-user"><span class="abbrstylefmt">short-long-user</span></a> but the description must be provided. The name is obtained from <a id="wrglossary.2675"></a><a href="#glo:glsxtrshortlonguserdescname"><code class="csfmt">\glsxtrshortlonguserdescname</code></a> and the sort value is obtained from <a id="wrglossary.2676"></a><a href="#glo:glsxtrshortlongdescsort"><code class="csfmt">\glsxtrshortlongdescsort</code></a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2677"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2678"></a><a href="#glo:opt.abbrstyle.short-long-user-desc"><span class="abbrstylefmt">short-long-user-desc</span></a>}<p>
+<a id="wrglossary.2679"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2680"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>,<br><a id="wrglossary.2681"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={extra info}</span>]{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2682"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2683"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2684"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2685"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2686"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-long-user-desc"></a>Example 57: The <span class="optfmt">short-long-user-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example057.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example057.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example057.png" type="image/png" width="358" height="98">Example document demonstrating the short-long-user-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+This style is incompatible with <a id="wrglossary.2687"></a><a href="#glo:GLSname"><code class="csfmt">\GLSname</code></a>. </div><!-- end of important -->
+<p>
+If you need to use <a id="wrglossary.2688"></a><a href="#glo:GLSname"><code class="csfmt">\GLSname</code></a> with this style, you’ll have to redefine <a id="wrglossary.2689"></a><a href="#glo:glsxtrshortlonguserdescname"><code class="csfmt">\glsxtrshortlonguserdescname</code></a> so that the field name doesn’t include the entry label. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<a id="wrglossary.2690"></a><a href="#glo:glsxtrlongshortuserdescname"><code class="csfmt">\glsxtrlongshortuserdescname</code></a>}{%
+ <code class="cmd">\protect</code><a id="wrglossary.2691"></a><a href="#glo:glsabbrvuserfont"><code class="csfmt">\glsabbrvuserfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.2692"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a>}%
+ <code class="cmd">\space</code>(<code class="cmd">\protect</code><a id="wrglossary.2693"></a><a href="#glo:glslonguserfont"><code class="csfmt">\glslonguserfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.2694"></a><a href="#glo:glslongtok"><code class="csfmt">\glslongtok</code></a>})%
}
-</pre>
-<!--l. 4169--><p class="nopar" > or if you want the description (if set):
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-124">
-\renewcommand*{\glsxtrbookindexname}[1]{%
-&#x00A0;\glossentryname{#1}%
-&#x00A0;\ifglshasdesc{#1}{\space&#x00A0;\glossentrydesc{#1}\glspostdescription}{}%
+</pre><p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2695"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-postlong-user"><span class="abbrstylefmt">short-postlong-user</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2696"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a> but it includes the additional content in the parentheses on <a id="wrglossary.2697"></a><a href="#glo:dual.firstuse">first use</a> or the <a id="wrglossary.2698"></a><a href="#glo:dual.inlinefullform">inline full form</a>. The parenthetical content is placed in the <a id="wrglossary.2699"></a><a href="#glo:dual.postlinkhook">post-link hook</a> which can avoid overly long hyperlinks.<p>
+The description is obtained from <a id="wrglossary.2700"></a><a href="#glo:glsuserdescription"><code class="csfmt">\glsuserdescription</code></a>, which can be redefined to include the additional information, if required.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2701"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2702"></a><a href="#glo:opt.abbrstyle.short-postlong-user"><span class="abbrstylefmt">short-postlong-user</span></a>}<p>
+<a id="wrglossary.2703"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2704"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={extra info}</span>]{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2705"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2706"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2707"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2708"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2709"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-postlong-user"></a>Example 58: The <span class="optfmt">short-postlong-user</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example058.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example058.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example058.png" type="image/png" width="358" height="97">Example document demonstrating the short-postlong-user abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2710"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-postlong-user-desc"><span class="abbrstylefmt">short-postlong-user-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2711"></a><a href="#glo:opt.abbrstyle.short-postlong-user"><span class="abbrstylefmt">short-postlong-user</span></a> but the description must be provided. The name is obtained from <a id="wrglossary.2712"></a><a href="#glo:glsxtrshortlonguserdescname"><code class="csfmt">\glsxtrshortlonguserdescname</code></a>. The sort value is the short form.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2713"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2714"></a><a href="#glo:opt.abbrstyle.short-postlong-user-desc"><span class="abbrstylefmt">short-postlong-user-desc</span></a>}<p>
+<a id="wrglossary.2715"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2716"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>,<br><a id="wrglossary.2717"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={extra info}</span>]{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2718"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2719"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2720"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2721"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2722"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-postlong-user-desc"></a>Example 59: The <span class="optfmt">short-postlong-user-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example059.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example059.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example059.png" type="image/png" width="358" height="98">Example document demonstrating the short-postlong-user-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+This style is incompatible with <a id="wrglossary.2723"></a><a href="#glo:GLSname"><code class="csfmt">\GLSname</code></a>. </div><!-- end of important -->
+<p>
+If you need to use <a id="wrglossary.2724"></a><a href="#glo:GLSname"><code class="csfmt">\GLSname</code></a> with this style, you’ll have to redefine <a id="wrglossary.2725"></a><a href="#glo:glsxtrshortlonguserdescname"><code class="csfmt">\glsxtrshortlonguserdescname</code></a> so that the field name doesn’t include the entry label, as for <a id="wrglossary.2726"></a><a href="#glo:opt.abbrstyle.short-long-user-desc"><span class="abbrstylefmt">short-long-user-desc</span></a>.<p>
+
+</section><!-- end of section sec:predefnonregabbrvstylesshortlonguser -->
+
+<section id="sec:predefnonregabbrvstyleshyphen"><!-- start of section sec:predefnonregabbrvstyleshyphen --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.1.2.5. Hyphen Styles<div class="labellink"><a href="#sec:predefnonregabbrvstyleshyphen">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These styles test if the inserted material start with a hyphen. See §<a href="#sec:abbrvcmdsgeneral">4.5.1.3.1</a>, §<a href="#sec:abbrvcmdsparen">4.5.1.3.2</a> and §<a href="#sec:abbrvcmdshyphen">4.5.1.3.7</a> for style commands.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+These styles are designed to be used with the <a id="wrglossary.2727"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a> attribute and (if the short form has spaces) the <a id="wrglossary.2728"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a> attribute. If the inserted material starts with a hyphen, the spaces will be replaced with hyphens. This replacement won’t take place if the corresponding attribute wasn’t used to mark the inter-word spaces. </div><!-- end of information -->
+<p>
+Note that <a id="wrglossary.2729"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> and <a id="wrglossary.2730"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> (and their plural and case-changing variants) don’t perform the inter-word space substitution. The <a id="wrglossary.2731"></a><a href="#glo:dual.inlinefullform">inline full form</a> is slightly different from the <a id="wrglossary.2732"></a><a href="#glo:dual.displayfullform">display full form</a> for the <span class="qt">“post”</span> styles.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2733"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-hyphen-short-hyphen"><span class="abbrstylefmt">long-hyphen-short-hyphen</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2734"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> but checks the inserted material for a leading hyphen. The description is the long form encapsulated with <a id="wrglossary.2735"></a><a href="#glo:glslonghyphenfont"><code class="csfmt">\glslonghyphenfont</code></a>. The name is obtained from <a id="wrglossary.2736"></a><a href="#glo:glsxtrlongshortname"><code class="csfmt">\glsxtrlongshortname</code></a>, and the sort value is obtained from <a id="wrglossary.2737"></a><a href="#glo:glsxtrlonghyphenshortsort"><code class="csfmt">\glsxtrlonghyphenshortsort</code></a>. The <a id="wrglossary.2738"></a><a href="#glo:dual.inlinefullform">inline full form</a> is the same as the <a id="wrglossary.2739"></a><a href="#glo:dual.displayfullform">display full form</a>. <p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2740"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2741"></a><a href="#glo:opt.abbrstyle.long-hyphen-short-hyphen"><span class="abbrstylefmt">long-hyphen-short-hyphen</span></a>}<p>
+<a id="wrglossary.2742"></a><a href="#glo:glssetcategoryattributes"><code class="csfmt">\glssetcategoryattributes</code></a>{<a id="wrglossary.2743"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a>}{<a id="wrglossary.2744"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a>,<a id="wrglossary.2745"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a>}{true}<br><a id="wrglossary.2746"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2747"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2748"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2749"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2750"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2751"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-hyphen-short-hyphen"></a>Example 60: The <span class="optfmt">long-hyphen-short-hyphen</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example060.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example060.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example060.png" type="image/png" width="359" height="97">Example document demonstrating the long-hyphen-short-hyphen abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2752"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-hyphen-postshort-hyphen"><span class="abbrstylefmt">long-hyphen-postshort-hyphen</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2753"></a><a href="#glo:opt.abbrstyle.long-hyphen-short-hyphen"><span class="abbrstylefmt">long-hyphen-short-hyphen</span></a> but places the insert and parenthetical material in the <a id="wrglossary.2754"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the <a id="wrglossary.2755"></a><a href="#glo:dual.displayfullform">display full form</a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2756"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2757"></a><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen"><span class="abbrstylefmt">long-hyphen-postshort-hyphen</span></a>}<p>
+<a id="wrglossary.2758"></a><a href="#glo:glssetcategoryattributes"><code class="csfmt">\glssetcategoryattributes</code></a>{<a id="wrglossary.2759"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a>}{<a id="wrglossary.2760"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a>,<a id="wrglossary.2761"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a>}{true}<br><a id="wrglossary.2762"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2763"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2764"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2765"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2766"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2767"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-hyphen-postshort-hyphen"></a>Example 61: The <span class="optfmt">long-hyphen-postshort-hyphen</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example061.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example061.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example061.png" type="image/png" width="359" height="97">Example document demonstrating the long-hyphen-postshort-hyphen abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+Note that the <a id="wrglossary.2768"></a><a href="#glo:dual.inlinefullform">inline full form</a> (<a id="wrglossary.2769"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>) doesn’t show the insert in the <a id="wrglossary.2770"></a><a href="#glo:dual.postlinkhook">post-link hook</a>, but instead places it at the end of the <a id="wrglossary.2771"></a><a href="#glo:dual.linktext">link text</a>. This is because only the <a id="wrglossary.2772"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands (not the <a id="wrglossary.2773"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands) set the placeholder <a id="wrglossary.2774"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a> to the supplied insert. If you want the insert to show in the parenthetical part of the <a id="wrglossary.2775"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the <a id="wrglossary.2776"></a><a href="#glo:dual.inlinefullform">inline full form</a> you need to redefine <a id="wrglossary.2777"></a><a href="#glo:glsxtrfullsaveinsert"><code class="csfmt">\glsxtrfullsaveinsert</code></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.2778"></a><a href="#glo:glsxtrfullsaveinsert"><code class="csfmt">\glsxtrfullsaveinsert</code></a>}[2]{<code class="cmd">\def</code><a id="wrglossary.2779"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a>{#2}}
+</pre><p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2780"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-hyphen-short-hyphen-desc"><span class="abbrstylefmt">long-hyphen-short-hyphen-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2781"></a><a href="#glo:opt.abbrstyle.long-hyphen-short-hyphen"><span class="abbrstylefmt">long-hyphen-short-hyphen</span></a> but the description must be supplied. The name is obtained from <a id="wrglossary.2782"></a><a href="#glo:glsxtrlongshortdescname"><code class="csfmt">\glsxtrlongshortdescname</code></a>, and the sort value is obtained from <a id="wrglossary.2783"></a><a href="#glo:glsxtrlongshortdescsort"><code class="csfmt">\glsxtrlongshortdescsort</code></a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2784"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2785"></a><a href="#glo:opt.abbrstyle.long-hyphen-short-hyphen-desc"><span class="abbrstylefmt">long-hyphen-short-hyphen-desc</span></a>}<p>
+<a id="wrglossary.2786"></a><a href="#glo:glssetcategoryattributes"><code class="csfmt">\glssetcategoryattributes</code></a>{<a id="wrglossary.2787"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a>}{<a id="wrglossary.2788"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a>,<a id="wrglossary.2789"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a>}{true}<br><a id="wrglossary.2790"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2791"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2792"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2793"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2794"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2795"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2796"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-hyphen-short-hyphen-desc"></a>Example 62: The <span class="optfmt">long-hyphen-short-hyphen-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example062.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example062.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example062.png" type="image/png" width="359" height="98">Example document demonstrating the long-hyphen-short-hyphen-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2797"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-hyphen-postshort-hyphen-desc"><span class="abbrstylefmt">long-hyphen-postshort-hyphen-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2798"></a><a href="#glo:opt.abbrstyle.long-hyphen-short-hyphen-desc"><span class="abbrstylefmt">long-hyphen-short-hyphen-desc</span></a> but places the insert and parenthetical material in the <a id="wrglossary.2799"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the <a id="wrglossary.2800"></a><a href="#glo:dual.displayfullform">display full form</a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2801"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2802"></a><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen-desc"><span class="abbrstylefmt">long-hyphen-postshort-hyphen-desc</span></a>}<p>
+<a id="wrglossary.2803"></a><a href="#glo:glssetcategoryattributes"><code class="csfmt">\glssetcategoryattributes</code></a>{<a id="wrglossary.2804"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a>}{<a id="wrglossary.2805"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a>,<a id="wrglossary.2806"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a>}{true}<br><a id="wrglossary.2807"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2808"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2809"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2810"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2811"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2812"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2813"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-hyphen-postshort-hyphen-desc"></a>Example 63: The <span class="optfmt">long-hyphen-postshort-hyphen-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example063.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example063.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example063.png" type="image/png" width="359" height="98">Example document demonstrating the long-hyphen-postshort-hyphen-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+Note that as with the <a id="wrglossary.2814"></a><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen"><span class="abbrstylefmt">long-hyphen-postshort-hyphen</span></a> style, the insert isn’t included in the <a id="wrglossary.2815"></a><a href="#glo:dual.postlinkhook">post-link hook</a> by default for the <a id="wrglossary.2816"></a><a href="#glo:dual.inlinefullform">inline full form</a>. If you want the insert to show in the <a id="wrglossary.2817"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the <a id="wrglossary.2818"></a><a href="#glo:dual.inlinefullform">inline full form</a> you need to redefine <a id="wrglossary.2819"></a><a href="#glo:glsxtrfullsaveinsert"><code class="csfmt">\glsxtrfullsaveinsert</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2820"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-hyphen-noshort-desc-noreg"><span class="abbrstylefmt">long-hyphen-noshort-desc-noreg</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2821"></a><a href="#glo:opt.abbrstyle.long-noshort-desc-noreg"><span class="abbrstylefmt">long-noshort-desc-noreg</span></a> but checks the inserted material for a leading hyphen. The description must be supplied. The name is obtained from <a id="wrglossary.2822"></a><a href="#glo:glsxtrlongnoshortdescname"><code class="csfmt">\glsxtrlongnoshortdescname</code></a>, and the sort value is obtained from <a id="wrglossary.2823"></a><a href="#glo:glsxtrlonghyphennoshortdescsort"><code class="csfmt">\glsxtrlonghyphennoshortdescsort</code></a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2824"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2825"></a><a href="#glo:opt.abbrstyle.long-hyphen-noshort-desc-noreg"><span class="abbrstylefmt">long-hyphen-noshort-desc-noreg</span></a>}<p>
+<a id="wrglossary.2826"></a><a href="#glo:glssetcategoryattributes"><code class="csfmt">\glssetcategoryattributes</code></a>{<a id="wrglossary.2827"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a>}{<a id="wrglossary.2828"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a>,<a id="wrglossary.2829"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a>}{true}<br><a id="wrglossary.2830"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2831"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2832"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2833"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2834"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2835"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2836"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-hyphen-noshort-desc-noreg"></a>Example 64: The <span class="optfmt">long-hyphen-noshort-desc-noreg</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example064.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example064.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example064.png" type="image/png" width="358" height="83">Example document demonstrating the long-hyphen-noshort-desc-noreg abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2837"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-hyphen-noshort-noreg"><span class="abbrstylefmt">long-hyphen-noshort-noreg</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2838"></a><a href="#glo:opt.abbrstyle.long-noshort-noreg"><span class="abbrstylefmt">long-noshort-noreg</span></a> but checks the inserted material for a leading hyphen. The description is set to the unencapsulated long form. The name is obtained from <a id="wrglossary.2839"></a><a href="#glo:glsxtrlongnoshortname"><code class="csfmt">\glsxtrlongnoshortname</code></a>, and the sort value is obtained from <a id="wrglossary.2840"></a><a href="#glo:glsxtrlonghyphennoshortsort"><code class="csfmt">\glsxtrlonghyphennoshortsort</code></a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2841"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2842"></a><a href="#glo:opt.abbrstyle.long-hyphen-noshort-noreg"><span class="abbrstylefmt">long-hyphen-noshort-noreg</span></a>}<p>
+<a id="wrglossary.2843"></a><a href="#glo:glssetcategoryattributes"><code class="csfmt">\glssetcategoryattributes</code></a>{<a id="wrglossary.2844"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a>}{<a id="wrglossary.2845"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a>,<a id="wrglossary.2846"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a>}{true}<br><a id="wrglossary.2847"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2848"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2849"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2850"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2851"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2852"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-hyphen-noshort-noreg"></a>Example 65: The <span class="optfmt">long-hyphen-noshort-noreg</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example065.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example065.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example065.png" type="image/png" width="358" height="83">Example document demonstrating the long-hyphen-noshort-noreg abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2853"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-hyphen-long-hyphen"><span class="abbrstylefmt">short-hyphen-long-hyphen</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2854"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a> but checks the inserted material for a leading hyphen. The description is the long form encapsulated with <a id="wrglossary.2855"></a><a href="#glo:glslonghyphenfont"><code class="csfmt">\glslonghyphenfont</code></a>. The name is obtained from <a id="wrglossary.2856"></a><a href="#glo:glsxtrshortlongname"><code class="csfmt">\glsxtrshortlongname</code></a> and the sort value is obtained from <a id="wrglossary.2857"></a><a href="#glo:glsxtrshorthyphenlongsort"><code class="csfmt">\glsxtrshorthyphenlongsort</code></a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2858"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2859"></a><a href="#glo:opt.abbrstyle.short-hyphen-long-hyphen"><span class="abbrstylefmt">short-hyphen-long-hyphen</span></a>}<p>
+<a id="wrglossary.2860"></a><a href="#glo:glssetcategoryattributes"><code class="csfmt">\glssetcategoryattributes</code></a>{<a id="wrglossary.2861"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a>}{<a id="wrglossary.2862"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a>,<a id="wrglossary.2863"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a>}{true}<br><a id="wrglossary.2864"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2865"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2866"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2867"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2868"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2869"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-hyphen-long-hyphen"></a>Example 66: The <span class="optfmt">short-hyphen-long-hyphen</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example066.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example066.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example066.png" type="image/png" width="359" height="97">Example document demonstrating the short-hyphen-long-hyphen abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2870"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-hyphen-postlong-hyphen"><span class="abbrstylefmt">short-hyphen-postlong-hyphen</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2871"></a><a href="#glo:opt.abbrstyle.short-hyphen-long-hyphen"><span class="abbrstylefmt">short-hyphen-long-hyphen</span></a> but the insert and parenthetical material are placed in the <a id="wrglossary.2872"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the <a id="wrglossary.2873"></a><a href="#glo:dual.displayfullform">display full form</a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2874"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2875"></a><a href="#glo:opt.abbrstyle.short-hyphen-postlong-hyphen"><span class="abbrstylefmt">short-hyphen-postlong-hyphen</span></a>}<p>
+<a id="wrglossary.2876"></a><a href="#glo:glssetcategoryattributes"><code class="csfmt">\glssetcategoryattributes</code></a>{<a id="wrglossary.2877"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a>}{<a id="wrglossary.2878"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a>,<a id="wrglossary.2879"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a>}{true}<br><a id="wrglossary.2880"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2881"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2882"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2883"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2884"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2885"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-hyphen-postlong-hyphen"></a>Example 67: The <span class="optfmt">short-hyphen-postlong-hyphen</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example067.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example067.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example067.png" type="image/png" width="359" height="97">Example document demonstrating the short-hyphen-postlong-hyphen abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+Note that as with the <a id="wrglossary.2886"></a><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen"><span class="abbrstylefmt">long-hyphen-postshort-hyphen</span></a> style, the insert isn’t included in the <a id="wrglossary.2887"></a><a href="#glo:dual.postlinkhook">post-link hook</a> by default for the <a id="wrglossary.2888"></a><a href="#glo:dual.inlinefullform">inline full form</a>. If you want the insert to show in the <a id="wrglossary.2889"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the <a id="wrglossary.2890"></a><a href="#glo:dual.inlinefullform">inline full form</a> you need to redefine <a id="wrglossary.2891"></a><a href="#glo:glsxtrfullsaveinsert"><code class="csfmt">\glsxtrfullsaveinsert</code></a> (as described above, for the <a id="wrglossary.2892"></a><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen"><span class="abbrstylefmt">long-hyphen-postshort-hyphen</span></a> style).<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2893"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-hyphen-long-hyphen-desc"><span class="abbrstylefmt">short-hyphen-long-hyphen-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2894"></a><a href="#glo:opt.abbrstyle.short-hyphen-long-hyphen"><span class="abbrstylefmt">short-hyphen-long-hyphen</span></a> but the description must be supplied. The name is obtained from <a id="wrglossary.2895"></a><a href="#glo:glsxtrshortlongdescname"><code class="csfmt">\glsxtrshortlongdescname</code></a>, and the sort is obtained from <a id="wrglossary.2896"></a><a href="#glo:glsxtrshortlongdescsort"><code class="csfmt">\glsxtrshortlongdescsort</code></a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2897"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2898"></a><a href="#glo:opt.abbrstyle.short-hyphen-long-hyphen-desc"><span class="abbrstylefmt">short-hyphen-long-hyphen-desc</span></a>}<p>
+<a id="wrglossary.2899"></a><a href="#glo:glssetcategoryattributes"><code class="csfmt">\glssetcategoryattributes</code></a>{<a id="wrglossary.2900"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a>}{<a id="wrglossary.2901"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a>,<a id="wrglossary.2902"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a>}{true}<br><a id="wrglossary.2903"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2904"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2905"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2906"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2907"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2908"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2909"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-hyphen-long-hyphen-desc"></a>Example 68: The <span class="optfmt">short-hyphen-long-hyphen-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example068.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example068.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example068.png" type="image/png" width="359" height="98">Example document demonstrating the short-hyphen-long-hyphen-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2910"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-hyphen-postlong-hyphen-desc"><span class="abbrstylefmt">short-hyphen-postlong-hyphen-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.2911"></a><a href="#glo:opt.abbrstyle.short-hyphen-long-hyphen-desc"><span class="abbrstylefmt">short-hyphen-long-hyphen-desc</span></a> but the insert and parenthetical material are placed in the <a id="wrglossary.2912"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the <a id="wrglossary.2913"></a><a href="#glo:dual.displayfullform">display full form</a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2914"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2915"></a><a href="#glo:opt.abbrstyle.short-hyphen-postlong-hyphen-desc"><span class="abbrstylefmt">short-hyphen-postlong-hyphen-desc</span></a>}<p>
+<a id="wrglossary.2916"></a><a href="#glo:glssetcategoryattributes"><code class="csfmt">\glssetcategoryattributes</code></a>{<a id="wrglossary.2917"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a>}{<a id="wrglossary.2918"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a>,<a id="wrglossary.2919"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a>}{true}<br><a id="wrglossary.2920"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2921"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2922"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2923"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2924"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2925"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2926"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstyleshort-hyphen-postlong-hyphen-desc"></a>Example 69: The <span class="optfmt">short-hyphen-postlong-hyphen-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example069.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example069.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example069.png" type="image/png" width="359" height="98">Example document demonstrating the short-hyphen-postlong-hyphen-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+Note that as with the <a id="wrglossary.2927"></a><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen"><span class="abbrstylefmt">long-hyphen-postshort-hyphen</span></a> style, the insert isn’t included in the <a id="wrglossary.2928"></a><a href="#glo:dual.postlinkhook">post-link hook</a> by default for the <a id="wrglossary.2929"></a><a href="#glo:dual.inlinefullform">inline full form</a>. If you want the insert to show in the <a id="wrglossary.2930"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the <a id="wrglossary.2931"></a><a href="#glo:dual.inlinefullform">inline full form</a> you need to redefine <a id="wrglossary.2932"></a><a href="#glo:glsxtrfullsaveinsert"><code class="csfmt">\glsxtrfullsaveinsert</code></a> (as described above, for the <a id="wrglossary.2933"></a><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen"><span class="abbrstylefmt">long-hyphen-postshort-hyphen</span></a> style).<p>
+
+</section><!-- end of section sec:predefnonregabbrvstyleshyphen -->
+
+<section id="sec:predefnonregabbrvstylesonly"><!-- start of section sec:predefnonregabbrvstylesonly --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.1.2.6. Only Styles<div class="labellink"><a href="#sec:predefnonregabbrvstylesonly">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These styles only show the long form on <a id="wrglossary.2934"></a><a href="#glo:dual.firstuse">first use</a> and only show the short form on <a id="wrglossary.2935"></a><a href="#glo:dual.subsequentuse">subsequent use</a>. The <a id="wrglossary.2936"></a><a href="#glo:dual.inlinefullform">inline full form</a> is the same as the <a id="wrglossary.2937"></a><a href="#glo:dual.displayfullform">display full form</a>. See §<a href="#sec:abbrvcmdsgeneral">4.5.1.3.1</a>, §<a href="#sec:abbrvcmdsparen">4.5.1.3.2</a> and §<a href="#sec:abbrvcmdsonly">4.5.1.3.8</a> for style commands.<p>
+The <a id="wrglossary.2938"></a><a href="#glo:dual.inlinefullform">inline full form</a> uses a parenthetical style with the long form followed by the short form in parentheses.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2939"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-only-short-only"><span class="abbrstylefmt">long-only-short-only</span></dfn></code></div><!-- end of settingsbox -->
+ The name is obtained from <a id="wrglossary.2940"></a><a href="#glo:glsxtronlyname"><code class="csfmt">\glsxtronlyname</code></a> and the sort value is just the short form. The description is the long form encapsulated with <a id="wrglossary.2941"></a><a href="#glo:glslongonlyfont"><code class="csfmt">\glslongonlyfont</code></a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2942"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2943"></a><a href="#glo:opt.abbrstyle.long-only-short-only"><span class="abbrstylefmt">long-only-short-only</span></a>}<p>
+<a id="wrglossary.2944"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2945"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2946"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2947"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2948"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2949"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-only-short-only"></a>Example 70: The <span class="optfmt">long-only-short-only</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example070.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example070.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example070.png" type="image/png" width="358" height="83">Example document demonstrating the long-only-short-only abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2950"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-only-short-only-desc"><span class="abbrstylefmt">long-only-short-only-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This is like <a id="wrglossary.2951"></a><a href="#glo:opt.abbrstyle.long-only-short-only"><span class="abbrstylefmt">long-only-short-only</span></a> but the description must be supplied. The name is obtained from <a id="wrglossary.2952"></a><a href="#glo:glsxtronlydescname"><code class="csfmt">\glsxtronlydescname</code></a> and the sort is obtained from <a id="wrglossary.2953"></a><a href="#glo:glsxtronlydescsort"><code class="csfmt">\glsxtronlydescsort</code></a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2954"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2955"></a><a href="#glo:opt.abbrstyle.long-only-short-only-desc"><span class="abbrstylefmt">long-only-short-only-desc</span></a>}<p>
+<a id="wrglossary.2956"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2957"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2958"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2959"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2960"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2961"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2962"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-only-short-only-desc"></a>Example 71: The <span class="optfmt">long-only-short-only-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example071.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example071.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example071.png" type="image/png" width="358" height="83">Example document demonstrating the long-only-short-only-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2963"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-only-short-sc-only"><span class="abbrstylefmt">long-only-short-sc-only</span></dfn></code></div><!-- end of settingsbox -->
+ This is like <a id="wrglossary.2964"></a><a href="#glo:opt.abbrstyle.long-only-short-only"><span class="abbrstylefmt">long-only-short-only</span></a> but uses <a id="wrglossary.2965"></a><a href="#glo:idx.smallcaps">small caps</a>. The name is obtained from <a id="wrglossary.2966"></a><a href="#glo:glsxtrsconlyname"><code class="csfmt">\glsxtrsconlyname</code></a>, and it uses <a id="wrglossary.2967"></a><a href="#glo:glsabbrvsconlyfont"><code class="csfmt">\glsabbrvsconlyfont</code></a>, <a id="wrglossary.2968"></a><a href="#glo:glsfirstabbrvsconlyfont"><code class="csfmt">\glsfirstabbrvsconlyfont</code></a> and <a id="wrglossary.2969"></a><a href="#glo:glsxtrsconlysuffix"><code class="csfmt">\glsxtrsconlysuffix</code></a> for the abbreviation fonts and plural suffix.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2970"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2971"></a><a href="#glo:opt.abbrstyle.long-only-short-sc-only"><span class="abbrstylefmt">long-only-short-sc-only</span></a>}<p>
+<a id="wrglossary.2972"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{shrt fm}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2973"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2974"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2975"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2976"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2977"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-only-short-sc-only"></a>Example 72: The <span class="optfmt">long-only-short-sc-only</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example072.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example072.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example072.png" type="image/png" width="358" height="83">Example document demonstrating the long-only-short-sc-only abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2978"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-only-short-sc-only-desc"><span class="abbrstylefmt">long-only-short-sc-only-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This is like <a id="wrglossary.2979"></a><a href="#glo:opt.abbrstyle.long-only-short-only-desc"><span class="abbrstylefmt">long-only-short-only-desc</span></a> but uses <a id="wrglossary.2980"></a><a href="#glo:idx.smallcaps">small caps</a>. The name is obtained from <a id="wrglossary.2981"></a><a href="#glo:glsxtrsconlydescname"><code class="csfmt">\glsxtrsconlydescname</code></a>, and the sort is obtained from <a id="wrglossary.2982"></a><a href="#glo:glsxtrsconlydescsort"><code class="csfmt">\glsxtrsconlydescsort</code></a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2983"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.2984"></a><a href="#glo:opt.abbrstyle.long-only-short-sc-only-desc"><span class="abbrstylefmt">long-only-short-sc-only-desc</span></a>}<p>
+<a id="wrglossary.2985"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.2986"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{shrt fm}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.2987"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.2988"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.2989"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.2990"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.2991"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:abbrvstylelong-only-short-sc-only-desc"></a>Example 73: The <span class="optfmt">long-only-short-sc-only-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example073.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example073.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example073.png" type="image/png" width="358" height="83">Example document demonstrating the long-only-short-sc-only-desc abbreviation style.</object> </div><!-- end of resultbox -->
+<p>
+
+</section><!-- end of section sec:predefnonregabbrvstylesonly -->
+
+<section id="sec:predefnonregabbrvstylesfootnote"><!-- start of section sec:predefnonregabbrvstylesfootnote --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.1.2.7. Footnote Styles<div class="labellink"><a href="#sec:predefnonregabbrvstylesfootnote">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These styles show the short form (<a id="wrglossary.2992"></a><a href="#glo:glsxtrshortformat"><code class="csfmt">\glsxtrshortformat</code></a>) with the long form as a footnote on <a id="wrglossary.2993"></a><a href="#glo:dual.firstuse">first use</a>. On <a id="wrglossary.2994"></a><a href="#glo:dual.subsequentuse">subsequent use</a> only the short form is shown. See §<a href="#sec:abbrvcmdsgeneral">4.5.1.3.1</a> and §<a href="#sec:abbrvcmdsfootnote">4.5.1.3.4</a> for style commands.<p>
+The <a id="wrglossary.2995"></a><a href="#glo:dual.inlinefullform">inline full form</a> uses the same parenthetical style as <a id="wrglossary.2996"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a> (<a id="wrglossary.2997"></a><a href="#glo:glsxtrshortlongformat"><code class="csfmt">\glsxtrshortlongformat</code></a>). Font variations are available with <a id="wrglossary.2998"></a><a href="#glo:opt.abbrstyle.short-sc-footnote"><span class="abbrstylefmt">short-sc-footnote</span></a>, <a id="wrglossary.2999"></a><a href="#glo:opt.abbrstyle.short-sm-footnote"><span class="abbrstylefmt">short-sm-footnote</span></a> and <a id="wrglossary.3000"></a><a href="#glo:opt.abbrstyle.short-em-footnote"><span class="abbrstylefmt">short-em-footnote</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3001"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">short-footnote</span></dfn></code></div><!-- end of settingsbox -->
+ The <span class="meta">〈<em class="metainner">insert</em>〉</span> is placed after the short form on <a id="wrglossary.3002"></a><a href="#glo:dual.firstuse">first use</a> and <a id="wrglossary.3003"></a><a href="#glo:dual.subsequentuse">subsequent use</a> of the <a id="wrglossary.3004"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands.<p>
+<div style="text-align: center; border-style: none; "><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
+<p>
+<pre class="sidebysidecode">
+<a id="wrglossary.3005"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.3006"></a><a href="#glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">short-footnote</span></a>}<p>
+<a id="wrglossary.3007"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.3008"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.3009"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.3010"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.3011"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.3012"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre><div class="sidebysideresult"><a id="ex:abbrvstyleshort-footnote"></a>Example 74: The <span class="optfmt">short-footnote</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example074.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example074.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example074.png" type="image/png" width="468" height="544">Example document demonstrating the short-footnote abbreviation style.</object> </div><p>
+<p>
+The long form is formatted with <a id="wrglossary.3013"></a><a href="#glo:glsfirstlongfootnotefont"><code class="csfmt">\glsfirstlongfootnotefont</code></a> within the full form and with <a id="wrglossary.3014"></a><a href="#glo:glslongfootnotefont"><code class="csfmt">\glslongfootnotefont</code></a> for the <a id="wrglossary.3015"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> set of commands.<p>
+The short form is formatted with <a id="wrglossary.3016"></a><a href="#glo:glsfirstabbrvdefaultfont"><code class="csfmt">\glsfirstabbrvdefaultfont</code></a> within the full form and with <a id="wrglossary.3017"></a><a href="#glo:glsabbrvdefaultfont"><code class="csfmt">\glsabbrvdefaultfont</code></a> for <a id="wrglossary.3018"></a><a href="#glo:dual.subsequentuse">subsequent use</a> and for the <a id="wrglossary.3019"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> set of commands.<p>
+The name is set to the short form (<a id="wrglossary.3020"></a><a href="#glo:glsxtrfootnotename"><code class="csfmt">\glsxtrfootnotename</code></a>) and the description is set to the unencapsulated long form.<p>
+This style automatically sets the <a id="wrglossary.3021"></a><a href="#glo:opt.catattr.nohyperfirst"><span class="csoptfmt">nohyperfirst</span></a> attribute to <code class="code">true</code> for the entry’s category.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3022"></a><code class="code"><dfn id="glo:opt.abbrstyle.footnote"><span class="abbrstylefmt">footnote</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">short-footnote</span></a>; <span class="summarytag">alias: </span><span class="abbrstylefmt">short-footnote</span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A synonym for <a id="wrglossary.3023"></a><a href="#glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">short-footnote</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3024"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-footnote-desc"><span class="abbrstylefmt">short-footnote-desc</span></dfn></code></div><!-- end of settingsbox -->
+ As <a id="wrglossary.3025"></a><a href="#glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">short-footnote</span></a> but the description must be supplied in the optional argument of <a id="wrglossary.3026"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>.<p>
+<div style="text-align: center; border-style: none; "><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
+<p>
+<pre class="sidebysidecode">
+<a id="wrglossary.3027"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.3028"></a><a href="#glo:opt.abbrstyle.short-footnote-desc"><span class="abbrstylefmt">short-footnote-desc</span></a>}<p>
+<a id="wrglossary.3029"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.3030"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.3031"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.3032"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.3033"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.3034"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.3035"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre><div class="sidebysideresult"><a id="ex:abbrvstyleshort-footnote-desc"></a>Example 75: The <span class="optfmt">short-footnote-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example075.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example075.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example075.png" type="image/png" width="468" height="544">Example document demonstrating the short-footnote-desc abbreviation style.</object> </div><p>
+<p>
+The name is set to the short form followed by the long form in parentheses (<a id="wrglossary.3036"></a><a href="#glo:glsxtrfootnotedescname"><code class="csfmt">\glsxtrfootnotedescname</code></a>), and the sort is set to just the short form (<a id="wrglossary.3037"></a><a href="#glo:glsxtrfootnotedescsort"><code class="csfmt">\glsxtrfootnotedescsort</code></a>).<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3038"></a><code class="code"><dfn id="glo:opt.abbrstyle.footnote-desc"><span class="abbrstylefmt">footnote-desc</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:opt.abbrstyle.short-footnote-desc"><span class="abbrstylefmt">short-footnote-desc</span></a>; <span class="summarytag">alias: </span><span class="abbrstylefmt">short-footnote-desc</span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A synonym for <a id="wrglossary.3039"></a><a href="#glo:opt.abbrstyle.short-footnote-desc"><span class="abbrstylefmt">short-footnote-desc</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3040"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></dfn></code></div><!-- end of settingsbox -->
+ Similar to <a id="wrglossary.3041"></a><a href="#glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">short-footnote</span></a> but the footnote command is placed in the <a id="wrglossary.3042"></a><a href="#glo:dual.postlinkhook">post-link hook</a>. This avoids the problem of nested hyperlinks caused by the footnote marker hyperlink being inside the <a id="wrglossary.3043"></a><a href="#glo:dual.linktext">link text</a> (which is why the <a id="wrglossary.3044"></a><a href="#glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">short-footnote</span></a> style switches on the <a id="wrglossary.3045"></a><a href="#glo:opt.catattr.nohyperfirst"><span class="csoptfmt">nohyperfirst</span></a> attribute). Using the <a id="wrglossary.3046"></a><a href="#glo:dual.postlinkhook">post-link hook</a> makes it possible to check for following punctuation so that the footnote marker can be shifted after the punctuation character.<p>
+<div style="text-align: center; border-style: none; "><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
+<p>
+<pre class="sidebysidecode">
+<a id="wrglossary.3047"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.3048"></a><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></a>}<p>
+<a id="wrglossary.3049"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.3050"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.3051"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.3052"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.3053"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.3054"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre><div class="sidebysideresult"><a id="ex:abbrvstyleshort-postfootnote"></a>Example 76: The <span class="optfmt">short-postfootnote</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example076.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example076.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example076.png" type="image/png" width="468" height="544">Example document demonstrating the short-postfootnote abbreviation style.</object> </div><p>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3055"></a><code class="code"><dfn id="glo:opt.abbrstyle.postfootnote"><span class="abbrstylefmt">postfootnote</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></a>; <span class="summarytag">alias: </span><span class="abbrstylefmt">short-postfootnote</span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A synonym for <a id="wrglossary.3056"></a><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3057"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-postfootnote-desc"><span class="abbrstylefmt">short-postfootnote-desc</span></dfn></code></div><!-- end of settingsbox -->
+ Similar to <a id="wrglossary.3058"></a><a href="#glo:opt.abbrstyle.short-footnote-desc"><span class="abbrstylefmt">short-footnote-desc</span></a> but the footnote command is placed in the <a id="wrglossary.3059"></a><a href="#glo:dual.postlinkhook">post-link hook</a> as with <a id="wrglossary.3060"></a><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></a>.<p>
+<div style="text-align: center; border-style: none; "><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
+<p>
+<pre class="sidebysidecode">
+<a id="wrglossary.3061"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.3062"></a><a href="#glo:opt.abbrstyle.short-postfootnote-desc"><span class="abbrstylefmt">short-postfootnote-desc</span></a>}<p>
+<a id="wrglossary.3063"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.3064"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.3065"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.3066"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.3067"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.3068"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.3069"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre><div class="sidebysideresult"><a id="ex:abbrvstyleshort-postfootnote-desc"></a>Example 77: The <span class="optfmt">short-postfootnote-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example077.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example077.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example077.png" type="image/png" width="468" height="544">Example document demonstrating the short-postfootnote-desc abbreviation style.</object> </div><p>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3070"></a><code class="code"><dfn id="glo:opt.abbrstyle.postfootnote-desc"><span class="abbrstylefmt">postfootnote-desc</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:opt.abbrstyle.short-postfootnote-desc"><span class="abbrstylefmt">short-postfootnote-desc</span></a>; <span class="summarytag">alias: </span><span class="abbrstylefmt">short-postfootnote-desc</span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A synonym for <a id="wrglossary.3071"></a><a href="#glo:opt.abbrstyle.short-postfootnote-desc"><span class="abbrstylefmt">short-postfootnote-desc</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3072"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-sc-footnote"><span class="abbrstylefmt">short-sc-footnote</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.3073"></a><a href="#glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">short-footnote</span></a> but it uses <a id="wrglossary.3074"></a><a href="#glo:glsxtrscsuffix"><code class="csfmt">\glsxtrscsuffix</code></a>, <a id="wrglossary.3075"></a><a href="#glo:glsabbrvscfont"><code class="csfmt">\glsabbrvscfont</code></a> and <a id="wrglossary.3076"></a><a href="#glo:glsfirstabbrvscfont"><code class="csfmt">\glsfirstabbrvscfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<div style="text-align: center; border-style: none; "><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
+<p>
+<pre class="sidebysidecode">
+<a id="wrglossary.3077"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.3078"></a><a href="#glo:opt.abbrstyle.short-sc-footnote"><span class="abbrstylefmt">short-sc-footnote</span></a>}<p>
+<a id="wrglossary.3079"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{shrt fm}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.3080"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.3081"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.3082"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.3083"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.3084"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre><div class="sidebysideresult"><a id="ex:abbrvstyleshort-sc-footnote"></a>Example 78: The <span class="optfmt">short-sc-footnote</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example078.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example078.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example078.png" type="image/png" width="468" height="544">Example document demonstrating the short-sc-footnote abbreviation style.</object> </div><p>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3085"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-sc-footnote-desc"><span class="abbrstylefmt">short-sc-footnote-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.3086"></a><a href="#glo:opt.abbrstyle.short-footnote-desc"><span class="abbrstylefmt">short-footnote-desc</span></a> but it uses <a id="wrglossary.3087"></a><a href="#glo:glsxtrscsuffix"><code class="csfmt">\glsxtrscsuffix</code></a>, <a id="wrglossary.3088"></a><a href="#glo:glsabbrvscfont"><code class="csfmt">\glsabbrvscfont</code></a> and <a id="wrglossary.3089"></a><a href="#glo:glsfirstabbrvscfont"><code class="csfmt">\glsfirstabbrvscfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<div style="text-align: center; border-style: none; "><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
+<p>
+<pre class="sidebysidecode">
+<a id="wrglossary.3090"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.3091"></a><a href="#glo:opt.abbrstyle.short-sc-footnote-desc"><span class="abbrstylefmt">short-sc-footnote-desc</span></a>}<p>
+<a id="wrglossary.3092"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.3093"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{shrt fm}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.3094"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.3095"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.3096"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.3097"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.3098"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre><div class="sidebysideresult"><a id="ex:abbrvstyleshort-sc-footnote-desc"></a>Example 79: The <span class="optfmt">short-sc-footnote-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example079.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example079.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example079.png" type="image/png" width="468" height="544">Example document demonstrating the short-sc-footnote-desc abbreviation style.</object> </div><p>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3099"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-sc-postfootnote"><span class="abbrstylefmt">short-sc-postfootnote</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.3100"></a><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></a> but it uses <a id="wrglossary.3101"></a><a href="#glo:glsxtrscsuffix"><code class="csfmt">\glsxtrscsuffix</code></a>, <a id="wrglossary.3102"></a><a href="#glo:glsabbrvscfont"><code class="csfmt">\glsabbrvscfont</code></a> and <a id="wrglossary.3103"></a><a href="#glo:glsfirstabbrvscfont"><code class="csfmt">\glsfirstabbrvscfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<div style="text-align: center; border-style: none; "><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
+<p>
+<pre class="sidebysidecode">
+<a id="wrglossary.3104"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.3105"></a><a href="#glo:opt.abbrstyle.short-sc-postfootnote"><span class="abbrstylefmt">short-sc-postfootnote</span></a>}<p>
+<a id="wrglossary.3106"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{shrt fm}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.3107"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.3108"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.3109"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.3110"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.3111"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre><div class="sidebysideresult"><a id="ex:abbrvstyleshort-sc-postfootnote"></a>Example 80: The <span class="optfmt">short-sc-postfootnote</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example080.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example080.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example080.png" type="image/png" width="468" height="544">Example document demonstrating the short-sc-postfootnote abbreviation style.</object> </div><p>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3112"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-sc-postfootnote-desc"><span class="abbrstylefmt">short-sc-postfootnote-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.3113"></a><a href="#glo:opt.abbrstyle.short-postfootnote-desc"><span class="abbrstylefmt">short-postfootnote-desc</span></a> but it uses <a id="wrglossary.3114"></a><a href="#glo:glsxtrscsuffix"><code class="csfmt">\glsxtrscsuffix</code></a>, <a id="wrglossary.3115"></a><a href="#glo:glsabbrvscfont"><code class="csfmt">\glsabbrvscfont</code></a> and <a id="wrglossary.3116"></a><a href="#glo:glsfirstabbrvscfont"><code class="csfmt">\glsfirstabbrvscfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<div style="text-align: center; border-style: none; "><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
+<p>
+<pre class="sidebysidecode">
+<a id="wrglossary.3117"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.3118"></a><a href="#glo:opt.abbrstyle.short-sc-postfootnote-desc"><span class="abbrstylefmt">short-sc-postfootnote-desc</span></a>}<p>
+<a id="wrglossary.3119"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.3120"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{shrt fm}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.3121"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.3122"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.3123"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.3124"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.3125"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre><div class="sidebysideresult"><a id="ex:abbrvstyleshort-sc-postfootnote-desc"></a>Example 81: The <span class="optfmt">short-sc-postfootnote-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example081.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example081.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example081.png" type="image/png" width="468" height="544">Example document demonstrating the short-sc-postfootnote-desc abbreviation style.</object> </div><p>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3126"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-sm-footnote"><span class="abbrstylefmt">short-sm-footnote</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.3127"></a><a href="#glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">short-footnote</span></a> but it uses <a id="wrglossary.3128"></a><a href="#glo:glsxtrsmsuffix"><code class="csfmt">\glsxtrsmsuffix</code></a>, <a id="wrglossary.3129"></a><a href="#glo:glsabbrvsmfont"><code class="csfmt">\glsabbrvsmfont</code></a> and <a id="wrglossary.3130"></a><a href="#glo:glsfirstabbrvsmfont"><code class="csfmt">\glsfirstabbrvsmfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<div style="text-align: center; border-style: none; "><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
+<p>
+<pre class="sidebysidecode">
+<a id="wrglossary.3131"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.3132"></a><a href="#glo:opt.abbrstyle.short-sm-footnote"><span class="abbrstylefmt">short-sm-footnote</span></a>}<p>
+<a id="wrglossary.3133"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.3134"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.3135"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.3136"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.3137"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.3138"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre><div class="sidebysideresult"><a id="ex:abbrvstyleshort-sm-footnote"></a>Example 82: The <span class="optfmt">short-sm-footnote</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example082.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example082.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example082.png" type="image/png" width="468" height="544">Example document demonstrating the short-sm-footnote abbreviation style.</object> </div><p>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3139"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-sm-footnote-desc"><span class="abbrstylefmt">short-sm-footnote-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.3140"></a><a href="#glo:opt.abbrstyle.short-footnote-desc"><span class="abbrstylefmt">short-footnote-desc</span></a> but it uses <a id="wrglossary.3141"></a><a href="#glo:glsxtrsmsuffix"><code class="csfmt">\glsxtrsmsuffix</code></a>, <a id="wrglossary.3142"></a><a href="#glo:glsabbrvsmfont"><code class="csfmt">\glsabbrvsmfont</code></a> and <a id="wrglossary.3143"></a><a href="#glo:glsfirstabbrvsmfont"><code class="csfmt">\glsfirstabbrvsmfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<div style="text-align: center; border-style: none; "><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
+<p>
+<pre class="sidebysidecode">
+<a id="wrglossary.3144"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.3145"></a><a href="#glo:opt.abbrstyle.short-sm-footnote-desc"><span class="abbrstylefmt">short-sm-footnote-desc</span></a>}<p>
+<a id="wrglossary.3146"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.3147"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.3148"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.3149"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.3150"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.3151"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.3152"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre><div class="sidebysideresult"><a id="ex:abbrvstyleshort-sm-footnote-desc"></a>Example 83: The <span class="optfmt">short-sm-footnote-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example083.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example083.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example083.png" type="image/png" width="468" height="544">Example document demonstrating the short-sm-footnote-desc abbreviation style.</object> </div><p>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3153"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-sm-postfootnote"><span class="abbrstylefmt">short-sm-postfootnote</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.3154"></a><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></a> but it uses <a id="wrglossary.3155"></a><a href="#glo:glsxtrsmsuffix"><code class="csfmt">\glsxtrsmsuffix</code></a>, <a id="wrglossary.3156"></a><a href="#glo:glsabbrvsmfont"><code class="csfmt">\glsabbrvsmfont</code></a> and <a id="wrglossary.3157"></a><a href="#glo:glsfirstabbrvsmfont"><code class="csfmt">\glsfirstabbrvsmfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<div style="text-align: center; border-style: none; "><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
+<p>
+<pre class="sidebysidecode">
+<a id="wrglossary.3158"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.3159"></a><a href="#glo:opt.abbrstyle.short-sm-postfootnote"><span class="abbrstylefmt">short-sm-postfootnote</span></a>}<p>
+<a id="wrglossary.3160"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.3161"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.3162"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.3163"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.3164"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.3165"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre><div class="sidebysideresult"><a id="ex:abbrvstyleshort-sm-postfootnote"></a>Example 84: The <span class="optfmt">short-sm-postfootnote</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example084.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example084.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example084.png" type="image/png" width="468" height="544">Example document demonstrating the short-sm-postfootnote abbreviation style.</object> </div><p>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3166"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-sm-postfootnote-desc"><span class="abbrstylefmt">short-sm-postfootnote-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.3167"></a><a href="#glo:opt.abbrstyle.short-postfootnote-desc"><span class="abbrstylefmt">short-postfootnote-desc</span></a> but it uses <a id="wrglossary.3168"></a><a href="#glo:glsxtrsmsuffix"><code class="csfmt">\glsxtrsmsuffix</code></a>, <a id="wrglossary.3169"></a><a href="#glo:glsabbrvsmfont"><code class="csfmt">\glsabbrvsmfont</code></a> and <a id="wrglossary.3170"></a><a href="#glo:glsfirstabbrvsmfont"><code class="csfmt">\glsfirstabbrvsmfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<div style="text-align: center; border-style: none; "><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
+<p>
+<pre class="sidebysidecode">
+<a id="wrglossary.3171"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.3172"></a><a href="#glo:opt.abbrstyle.short-sm-postfootnote-desc"><span class="abbrstylefmt">short-sm-postfootnote-desc</span></a>}<p>
+<a id="wrglossary.3173"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.3174"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.3175"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.3176"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.3177"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.3178"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.3179"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre><div class="sidebysideresult"><a id="ex:abbrvstyleshort-sm-postfootnote-desc"></a>Example 85: The <span class="optfmt">short-sm-postfootnote-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example085.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example085.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example085.png" type="image/png" width="468" height="544">Example document demonstrating the short-sm-postfootnote-desc abbreviation style.</object> </div><p>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3180"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-em-footnote"><span class="abbrstylefmt">short-em-footnote</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.3181"></a><a href="#glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">short-footnote</span></a> but it uses <a id="wrglossary.3182"></a><a href="#glo:glsxtremsuffix"><code class="csfmt">\glsxtremsuffix</code></a>, <a id="wrglossary.3183"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a> and <a id="wrglossary.3184"></a><a href="#glo:glsfirstabbrvemfont"><code class="csfmt">\glsfirstabbrvemfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<div style="text-align: center; border-style: none; "><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
+<p>
+<pre class="sidebysidecode">
+<a id="wrglossary.3185"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.3186"></a><a href="#glo:opt.abbrstyle.short-em-footnote"><span class="abbrstylefmt">short-em-footnote</span></a>}<p>
+<a id="wrglossary.3187"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.3188"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.3189"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.3190"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.3191"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.3192"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre><div class="sidebysideresult"><a id="ex:abbrvstyleshort-em-footnote"></a>Example 86: The <span class="optfmt">short-em-footnote</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example086.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example086.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example086.png" type="image/png" width="471" height="544">Example document demonstrating the short-em-footnote abbreviation style.</object> </div><p>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3193"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-em-footnote-desc"><span class="abbrstylefmt">short-em-footnote-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.3194"></a><a href="#glo:opt.abbrstyle.short-footnote-desc"><span class="abbrstylefmt">short-footnote-desc</span></a> but it uses <a id="wrglossary.3195"></a><a href="#glo:glsxtremsuffix"><code class="csfmt">\glsxtremsuffix</code></a>, <a id="wrglossary.3196"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a> and <a id="wrglossary.3197"></a><a href="#glo:glsfirstabbrvemfont"><code class="csfmt">\glsfirstabbrvemfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<div style="text-align: center; border-style: none; "><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
+<p>
+<pre class="sidebysidecode">
+<a id="wrglossary.3198"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.3199"></a><a href="#glo:opt.abbrstyle.short-em-footnote-desc"><span class="abbrstylefmt">short-em-footnote-desc</span></a>}<p>
+<a id="wrglossary.3200"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.3201"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.3202"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.3203"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.3204"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.3205"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.3206"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre><div class="sidebysideresult"><a id="ex:abbrvstyleshort-em-footnote-desc"></a>Example 87: The <span class="optfmt">short-em-footnote-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example087.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example087.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example087.png" type="image/png" width="471" height="544">Example document demonstrating the short-em-footnote-desc abbreviation style.</object> </div><p>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3207"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-em-postfootnote"><span class="abbrstylefmt">short-em-postfootnote</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.3208"></a><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></a> but it uses <a id="wrglossary.3209"></a><a href="#glo:glsxtremsuffix"><code class="csfmt">\glsxtremsuffix</code></a>, <a id="wrglossary.3210"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a> and <a id="wrglossary.3211"></a><a href="#glo:glsfirstabbrvemfont"><code class="csfmt">\glsfirstabbrvemfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<div style="text-align: center; border-style: none; "><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
+<p>
+<pre class="sidebysidecode">
+<a id="wrglossary.3212"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.3213"></a><a href="#glo:opt.abbrstyle.short-em-postfootnote"><span class="abbrstylefmt">short-em-postfootnote</span></a>}<p>
+<a id="wrglossary.3214"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.3215"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.3216"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.3217"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.3218"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.3219"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre><div class="sidebysideresult"><a id="ex:abbrvstyleshort-em-postfootnote"></a>Example 88: The <span class="optfmt">short-em-postfootnote</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example088.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example088.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example088.png" type="image/png" width="471" height="544">Example document demonstrating the short-em-postfootnote abbreviation style.</object> </div><p>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3220"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-em-postfootnote-desc"><span class="abbrstylefmt">short-em-postfootnote-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like <a id="wrglossary.3221"></a><a href="#glo:opt.abbrstyle.short-postfootnote-desc"><span class="abbrstylefmt">short-postfootnote-desc</span></a> but it uses <a id="wrglossary.3222"></a><a href="#glo:glsxtremsuffix"><code class="csfmt">\glsxtremsuffix</code></a>, <a id="wrglossary.3223"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a> and <a id="wrglossary.3224"></a><a href="#glo:glsfirstabbrvemfont"><code class="csfmt">\glsfirstabbrvemfont</code></a> (see §<a href="#sec:abbrvcmdsfonts">4.5.1.3.9</a>).<p>
+<div style="text-align: center; border-style: none; "><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
+<p>
+<pre class="sidebysidecode">
+<a id="wrglossary.3225"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.3226"></a><a href="#glo:opt.abbrstyle.short-em-postfootnote-desc"><span class="abbrstylefmt">short-em-postfootnote-desc</span></a>}<p>
+<a id="wrglossary.3227"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.3228"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample description}</span>]<br>{ex}{SHRT FM}{long form}<p>
+<code class="cbeg">\begin{document}</code>
+First: <a id="wrglossary.3229"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert]. Next: <a id="wrglossary.3230"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}[-insert].
+Full: <a id="wrglossary.3231"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>{ex}[-insert].
+First plural: <a id="wrglossary.3232"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[prereset]{ex}[-insert].<br><a id="wrglossary.3233"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><br><code class="cend">\end{document}</code>
+</pre><div class="sidebysideresult"><a id="ex:abbrvstyleshort-em-postfootnote-desc"></a>Example 89: The <span class="optfmt">short-em-postfootnote-desc</span> abbreviation style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example089.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example089.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example089.png" type="image/png" width="471" height="544">Example document demonstrating the short-em-postfootnote-desc abbreviation style.</object> </div><p>
+<p>
+
+</section><!-- end of section sec:predefnonregabbrvstylesfootnote -->
+
+<section id="sec:predefnonregabbrvstylesshort"><!-- start of section sec:predefnonregabbrvstylesshort --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.1.2.8. Short Styles<div class="labellink"><a href="#sec:predefnonregabbrvstylesshort">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These styles only show the short form on both <a id="wrglossary.3234"></a><a href="#glo:dual.firstuse">first use</a> and <a id="wrglossary.3235"></a><a href="#glo:dual.subsequentuse">subsequent use</a>. See §<a href="#sec:abbrvcmdsgeneral">4.5.1.3.1</a> and §<a href="#sec:abbrvcmdsnolong">4.5.1.3.5</a> for style commands. They are essentially identical to the corresponding regular style listed in §<a href="#sec:predefnonregabbrvstylesshort">4.5.1.2.8</a> except that they change the <a id="wrglossary.3236"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">false</code>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3237"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-nolong-noreg"><span class="abbrstylefmt">short-nolong-noreg</span></dfn></code></div><!-- end of settingsbox -->
+ This style is a non-regular version of the <a id="wrglossary.3238"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a> style.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3239"></a><code class="code"><dfn id="glo:opt.abbrstyle.short-nolong-desc-noreg"><span class="abbrstylefmt">short-nolong-desc-noreg</span></dfn></code></div><!-- end of settingsbox -->
+ This style is a non-regular version of the <a id="wrglossary.3240"></a><a href="#glo:opt.abbrstyle.short-nolong-desc"><span class="abbrstylefmt">short-nolong-desc</span></a> style.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3241"></a><code class="code"><dfn id="glo:opt.abbrstyle.nolong-short-noreg"><span class="abbrstylefmt">nolong-short-noreg</span></dfn></code></div><!-- end of settingsbox -->
+ This style is a non-regular version of the <a id="wrglossary.3242"></a><a href="#glo:opt.abbrstyle.nolong-short"><span class="abbrstylefmt">nolong-short</span></a> style.<p>
+
+</section><!-- end of section sec:predefnonregabbrvstylesshort -->
+
+<section id="sec:predefnonregabbrvstyleslong"><!-- start of section sec:predefnonregabbrvstyleslong --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.1.2.9. Long Styles<div class="labellink"><a href="#sec:predefnonregabbrvstyleslong">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These styles only show the long form on both <a id="wrglossary.3243"></a><a href="#glo:dual.firstuse">first use</a> and <a id="wrglossary.3244"></a><a href="#glo:dual.subsequentuse">subsequent use</a>. See §<a href="#sec:abbrvcmdsgeneral">4.5.1.3.1</a> and §<a href="#sec:abbrvcmdsnoshort">4.5.1.3.6</a> for style commands. They are essentially identical to the corresponding regular style listed in §<a href="#sec:predefnonregabbrvstyleslong">4.5.1.2.9</a> except that they change the <a id="wrglossary.3245"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">false</code>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3246"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-noshort-desc-noreg"><span class="abbrstylefmt">long-noshort-desc-noreg</span></dfn></code></div><!-- end of settingsbox -->
+ This style is a non-regular version of the <a id="wrglossary.3247"></a><a href="#glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></a> style.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3248"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-noshort-noreg"><span class="abbrstylefmt">long-noshort-noreg</span></dfn></code></div><!-- end of settingsbox -->
+ This style is a non-regular version of the <a id="wrglossary.3249"></a><a href="#glo:opt.abbrstyle.long-noshort"><span class="abbrstylefmt">long-noshort</span></a> style.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3250"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-em-noshort-em-noreg"><span class="abbrstylefmt">long-em-noshort-em-noreg</span></dfn></code></div><!-- end of settingsbox -->
+ This style is a non-regular version of the <a id="wrglossary.3251"></a><a href="#glo:opt.abbrstyle.long-em-noshort-em"><span class="abbrstylefmt">long-em-noshort-em</span></a> style.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3252"></a><code class="code"><dfn id="glo:opt.abbrstyle.long-em-noshort-em-desc-noreg"><span class="abbrstylefmt">long-em-noshort-em-desc-noreg</span></dfn></code></div><!-- end of settingsbox -->
+ This style is a non-regular version of the <a id="wrglossary.3253"></a><a href="#glo:opt.abbrstyle.long-em-noshort-em-desc"><span class="abbrstylefmt">long-em-noshort-em-desc</span></a> style.<p>
+
+</section><!-- end of section sec:predefnonregabbrvstyleslong -->
+
+<section id="sec:abbrvcmds"><!-- start of section sec:abbrvcmds --><div class="tomain"><a href="#main">[top]</a></div>
+<h4><!-- start of subsubsection header -->4.5.1.3. Formatting Commands and Hooks<div class="labellink"><a href="#sec:abbrvcmds">[link]</a></div></h4><!-- end of subsubsection header -->
+<p>
+These commands are used by the predefined abbreviation styles. These are considered user commands, which you can redefine to customize the style.<p>
+
+</section><!-- end of section sec:abbrvcmds -->
+
+<section id="sec:abbrvcmdsgeneral"><!-- start of section sec:abbrvcmdsgeneral --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.1.3.1. General<div class="labellink"><a href="#sec:abbrvcmdsgeneral">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These commands apply to all styles.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3254"></a><code class="code"><dfn id="glo:ifglsxtrinsertinside"><code class="csfmt">\ifglsxtrinsertinside</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\iffalse</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This conditional is used to determine whether the <span class="meta">〈<em class="metainner">insert</em>〉</span> part should go inside or outside of the style’s font formatting commands. The default setting is false.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3255"></a><code class="code"><dfn id="glo:glsxtrinsertinsidetrue"><code class="csfmt">\glsxtrinsertinsidetrue</code></dfn></code></div><!-- end of pinnedbox -->
+ Set the insert inside conditional to true.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3256"></a><code class="code"><dfn id="glo:glsxtrinsertinsidefalse"><code class="csfmt">\glsxtrinsertinsidefalse</code></dfn></code></div><!-- end of pinnedbox -->
+ Set the insert inside conditional to false.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3257"></a><code class="code"><dfn id="glo:glsxtrparen"><code class="csfmt">\glsxtrparen</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Used for parenthetical content in the <a id="wrglossary.3258"></a><a href="#glo:dual.inlinefullform">inline full form</a> and also, for some styles, the <a id="wrglossary.3259"></a><a href="#glo:dual.displayfullform">display full form</a>. Note that this formats the opening and closing parentheses according to the <a id="wrglossary.3260"></a><a href="#glo:dual.innerformatting">inner formatting</a>, but not the argument, which should already incorporate it. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.3261"></a><a href="#glo:glsxtrparen"><code class="csfmt">\glsxtrparen</code></a>}[1]{%
+ <a id="wrglossary.3262"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a>{(}#1<a id="wrglossary.3263"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a>{)}}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3264"></a><code class="code"><dfn id="glo:glsxtrfullsep"><code class="csfmt">\glsxtrfullsep</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Separator placed before <a id="wrglossary.3265"></a><a href="#glo:glsxtrparen"><code class="csfmt">\glsxtrparen</code></a>. This is a space by default, but it includes the <a id="wrglossary.3266"></a><a href="#glo:dual.innerformatting">inner formatting</a>. The argument (the entry label) is ignored by default: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.3267"></a><a href="#glo:glsxtrfullsep"><code class="csfmt">\glsxtrfullsep</code></a>}[1]{<a id="wrglossary.3268"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a>{ }}
+</pre> You can redefine this to use <a id="wrglossary.3269"></a><a href="#glo:glsabspace"><code class="csfmt">\glsabspace</code></a> if you want to have a non-breakable space if the short form is less than <a id="wrglossary.3270"></a><a href="#glo:glsacspacemax"><code class="csfmt">\glsacspacemax</code></a> in width. (You can use <a id="wrglossary.3271"></a><a href="#glo:glsacspace"><code class="csfmt">\glsacspace</code></a> instead, but note that <a id="wrglossary.3272"></a><a href="#glo:glsacspace"><code class="csfmt">\glsacspace</code></a> doesn’t incorporate the <a id="wrglossary.3273"></a><a href="#glo:dual.innerformatting">inner formatting</a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3274"></a><code class="code"><dfn id="glo:glsabbrvdefaultfont"><code class="csfmt">\glsabbrvdefaultfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Abbreviation font command used by styles that don’t have specific font markup (for example, <a id="wrglossary.3275"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> but not <a id="wrglossary.3276"></a><a href="#glo:opt.abbrstyle.long-em-short-em"><span class="abbrstylefmt">long-em-short-em</span></a>). This just does its argument.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3277"></a><code class="code"><dfn id="glo:glsfirstabbrvdefaultfont"><code class="csfmt">\glsfirstabbrvdefaultfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ <a id="wrglossary.3278"></a><a href="#glo:dual.firstuse">First use</a> abbreviation font command used by styles that don’t have specific font markup. This is defined to just use <a id="wrglossary.3279"></a><a href="#glo:glsabbrvdefaultfont"><code class="csfmt">\glsabbrvdefaultfont</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3280"></a><code class="code"><dfn id="glo:glsxtrdefaultrevert"><code class="csfmt">\glsxtrdefaultrevert</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is the default definition of <a id="wrglossary.3281"></a><a href="#glo:glsxtrrevert"><code class="csfmt">\glsxtrrevert</code></a> used by styles that don’t have specific font markup. If you redefine <a id="wrglossary.3282"></a><a href="#glo:glsabbrvdefaultfont"><code class="csfmt">\glsabbrvdefaultfont</code></a>, you will need to redefine <a id="wrglossary.3283"></a><a href="#glo:glsxtrdefaultrevert"><code class="csfmt">\glsxtrdefaultrevert</code></a> as applicable.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3284"></a><code class="code"><dfn id="glo:glslongdefaultfont"><code class="csfmt">\glslongdefaultfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Long form font command used by styles that don’t have specific font markup. This just does its argument.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3285"></a><code class="code"><dfn id="glo:glsfirstlongdefaultfont"><code class="csfmt">\glsfirstlongdefaultfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ <a id="wrglossary.3286"></a><a href="#glo:dual.firstuse">First use</a> long form font command used by styles that don’t have specific font markup. This is defined to just use <a id="wrglossary.3287"></a><a href="#glo:glslongdefaultfont"><code class="csfmt">\glslongdefaultfont</code></a>.<p>
+
+</section><!-- end of section sec:abbrvcmdsgeneral -->
+
+<section id="sec:abbrvcmdsparen"><!-- start of section sec:abbrvcmdsparen --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.1.3.2. Parenthetical Styles<div class="labellink"><a href="#sec:abbrvcmdsparen">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These commands apply to the parenthetical styles, such as <a id="wrglossary.3288"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3289"></a><code class="code"><dfn id="glo:glsxtrlongshortname"><code class="csfmt">\glsxtrlongshortname</code></dfn></code></div><!-- end of pinnedbox -->
+ This command should expand to the value of the <a id="wrglossary.3290"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key for styles like <a id="wrglossary.3291"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a>. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3292"></a><a href="#glo:glsxpabbrvfont"><code class="csfmt">\glsxpabbrvfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3293"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a>}{<a id="wrglossary.3294"></a><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a>}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3295"></a><code class="code"><dfn id="glo:glsxtrlongshortdescsort"><code class="csfmt">\glsxtrlongshortdescsort</code></dfn></code></div><!-- end of pinnedbox -->
+ This command should expand to the sort value used by styles such as <a id="wrglossary.3296"></a><a href="#glo:opt.abbrstyle.long-short-desc"><span class="abbrstylefmt">long-short-desc</span></a>. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3297"></a><a href="#glo:expandonce"><code class="csfmt">\expandonce</code></a><a id="wrglossary.3298"></a><a href="#glo:glsxtrorglong"><code class="csfmt">\glsxtrorglong</code></a><code class="cmd">\space</code> (<a id="wrglossary.3299"></a><a href="#glo:expandonce"><code class="csfmt">\expandonce</code></a><a id="wrglossary.3300"></a><a href="#glo:glsxtrorgshort"><code class="csfmt">\glsxtrorgshort</code></a>)
+</pre> Note that this uses the original <span class="meta">〈<em class="metainner">long</em>〉</span> and <span class="meta">〈<em class="metainner">short</em>〉</span> values supplied to <a id="wrglossary.3301"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+This command is irrelevant with the <a id="wrglossary.3302"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>. </div><!-- end of information -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3303"></a><code class="code"><dfn id="glo:glsxtrlongshortdescname"><code class="csfmt">\glsxtrlongshortdescname</code></dfn></code></div><!-- end of pinnedbox -->
+ This command should expand to the name value used by styles such as <a id="wrglossary.3304"></a><a href="#glo:opt.abbrstyle.long-short-desc"><span class="abbrstylefmt">long-short-desc</span></a>. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3305"></a><a href="#glo:glsxplongfont"><code class="csfmt">\glsxplongfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3306"></a><a href="#glo:glslongtok"><code class="csfmt">\glslongtok</code></a>}{<a id="wrglossary.3307"></a><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a>}%
+<code class="cmd">\protect</code><a id="wrglossary.3308"></a><a href="#glo:glsxtrfullsep"><code class="csfmt">\glsxtrfullsep</code></a>{<code class="cmd">\the</code><a id="wrglossary.3309"></a><a href="#glo:glslabeltok"><code class="csfmt">\glslabeltok</code></a>}%
+<code class="cmd">\protect</code><a id="wrglossary.3310"></a><a href="#glo:glsxtrparen"><code class="csfmt">\glsxtrparen</code></a>
+ {<a id="wrglossary.3311"></a><a href="#glo:glsxpabbrvfont"><code class="csfmt">\glsxpabbrvfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3312"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a>}{<a id="wrglossary.3313"></a><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a>}}
+</pre> This essentially expands to <span class="meta">〈<em class="metainner">long</em>〉</span> (<span class="meta">〈<em class="metainner">short</em>〉</span>) but includes the style font changing commands, the inner text formatting, and accessibility support.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3314"></a><code class="code"><dfn id="glo:glsxtrshortlongname"><code class="csfmt">\glsxtrshortlongname</code></dfn></code></div><!-- end of pinnedbox -->
+ This command should expand to the value of the <a id="wrglossary.3315"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key for styles like <a id="wrglossary.3316"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a>. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3317"></a><a href="#glo:glsxpabbrvfont"><code class="csfmt">\glsxpabbrvfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3318"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a>}{<a id="wrglossary.3319"></a><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a>}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3320"></a><code class="code"><dfn id="glo:glsxtrshortlongdescsort"><code class="csfmt">\glsxtrshortlongdescsort</code></dfn></code></div><!-- end of pinnedbox -->
+ This command should expand to the value of the <a id="wrglossary.3321"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key for styles like <a id="wrglossary.3322"></a><a href="#glo:opt.abbrstyle.short-long-desc"><span class="abbrstylefmt">short-long-desc</span></a>. The default definition is just <code class="code"><a id="wrglossary.3323"></a><a href="#glo:expandonce"><code class="csfmt">\expandonce</code></a><a id="wrglossary.3324"></a><a href="#glo:glsxtrorgshort"><code class="csfmt">\glsxtrorgshort</code></a></code>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+This command is irrelevant with the <a id="wrglossary.3325"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>. </div><!-- end of information -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3326"></a><code class="code"><dfn id="glo:glsxtrshortlongdescname"><code class="csfmt">\glsxtrshortlongdescname</code></dfn></code></div><!-- end of pinnedbox -->
+ This command should expand to the value of the <a id="wrglossary.3327"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key for styles like <a id="wrglossary.3328"></a><a href="#glo:opt.abbrstyle.short-long-desc"><span class="abbrstylefmt">short-long-desc</span></a>. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3329"></a><a href="#glo:glsxpabbrvfont"><code class="csfmt">\glsxpabbrvfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3330"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a>}{<a id="wrglossary.3331"></a><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a>}%
+<code class="cmd">\protect</code><a id="wrglossary.3332"></a><a href="#glo:glsxtrfullsep"><code class="csfmt">\glsxtrfullsep</code></a>{<code class="cmd">\the</code><a id="wrglossary.3333"></a><a href="#glo:glslabeltok"><code class="csfmt">\glslabeltok</code></a>}%
+<code class="cmd">\protect</code><a id="wrglossary.3334"></a><a href="#glo:glsxtrparen"><code class="csfmt">\glsxtrparen</code></a>
+ <a id="wrglossary.3335"></a><a href="#glo:glsxplongfont"><code class="csfmt">\glsxplongfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3336"></a><a href="#glo:glslongtok"><code class="csfmt">\glslongtok</code></a>}{<a id="wrglossary.3337"></a><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a>}
+</pre><p>
+
+</section><!-- end of section sec:abbrvcmdsparen -->
+
+<section id="sec:abbrvcmdsuser"><!-- start of section sec:abbrvcmdsuser --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.1.3.3. User Styles<div class="labellink"><a href="#sec:abbrvcmdsuser">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These commands apply to the <span class="qt">“user”</span> styles, such as <a id="wrglossary.3338"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3339"></a><code class="code"><dfn id="glo:glsxtruserfield"><code class="csfmt">\glsxtruserfield</code></dfn></code></div><!-- end of pinnedbox -->
+ This command should expand to the <a id="wrglossary.3340"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a> of the field used to store the additional information that should be shown in the parenthetical material on <a id="wrglossary.3341"></a><a href="#glo:dual.firstuse">first use</a>. The default is <code class="code">useri</code>, which corresponds to the <a id="wrglossary.3342"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3343"></a><code class="code"><dfn id="glo:glsxtruserparensep"><code class="csfmt">\glsxtruserparensep</code></dfn></code></div><!-- end of pinnedbox -->
+ The separator used within the parenthetical content. This defaults to a comma followed by a space.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3344"></a><code class="code"><dfn id="glo:glsxtruserfieldfmt"><code class="csfmt">\glsxtruserfieldfmt</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Used to encapsulate the value of the field given by <a id="wrglossary.3345"></a><a href="#glo:glsxtruserfield"><code class="csfmt">\glsxtruserfield</code></a> within <a id="wrglossary.3346"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a> and <a id="wrglossary.3347"></a><a href="#glo:GLSxtruserparen"><code class="csfmt">\GLSxtruserparen</code></a>. This simply does its argument by default.<p>
+The <a id="wrglossary.3348"></a><a href="#glo:dual.innerformatting">inner formatting</a> with both <a id="wrglossary.3349"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a> and <a id="wrglossary.3350"></a><a href="#glo:GLSxtruserparen"><code class="csfmt">\GLSxtruserparen</code></a>, and the case-change with the latter, will be included in the argument of <a id="wrglossary.3351"></a><a href="#glo:glsxtruserfieldfmt"><code class="csfmt">\glsxtruserfieldfmt</code></a>.<p>
+For example, to emphasize the user value and separate it with a semi-colon instead of a comma: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.3352"></a><a href="#glo:glsxtruserparensep"><code class="csfmt">\glsxtruserparensep</code></a>}{; }
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.3353"></a><a href="#glo:glsxtruserfieldfmt"><code class="csfmt">\glsxtruserfieldfmt</code></a>}[1]{<code class="cmd">\emph</code>{#1}}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3354"></a><code class="code"><dfn id="glo:glsabbrvuserfont"><code class="csfmt">\glsabbrvuserfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Formatting for the <span class="qt">“user”</span> short form. This defaults to <a id="wrglossary.3355"></a><a href="#glo:glsabbrvdefaultfont"><code class="csfmt">\glsabbrvdefaultfont</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3356"></a><code class="code"><dfn id="glo:glsfirstabbrvuserfont"><code class="csfmt">\glsfirstabbrvuserfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Formatting for the <span class="qt">“user”</span> short form shown on <a id="wrglossary.3357"></a><a href="#glo:dual.firstuse">first use</a>. This defaults to <a id="wrglossary.3358"></a><a href="#glo:glsabbrvuserfont"><code class="csfmt">\glsabbrvuserfont</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3359"></a><code class="code"><dfn id="glo:glsxtrusersuffix"><code class="csfmt">\glsxtrusersuffix</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Short plural suffix used by the <span class="qt">“user”</span> styles. This defaults to <a id="wrglossary.3360"></a><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3361"></a><code class="code"><dfn id="glo:glslonguserfont"><code class="csfmt">\glslonguserfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Formatting for the <span class="qt">“user”</span> long form. This defaults to <a id="wrglossary.3362"></a><a href="#glo:glsabbrvdefaultfont"><code class="csfmt">\glsabbrvdefaultfont</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3363"></a><code class="code"><dfn id="glo:glsfirstlonguserfont"><code class="csfmt">\glsfirstlonguserfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Formatting for the <span class="qt">“user”</span> short form shown on <a id="wrglossary.3364"></a><a href="#glo:dual.firstuse">first use</a>. This defaults to <a id="wrglossary.3365"></a><a href="#glo:glslonguserfont"><code class="csfmt">\glslonguserfont</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3366"></a><code class="code"><dfn id="glo:glsabbrvscuserfont"><code class="csfmt">\glsabbrvscuserfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Formatting for the <span class="qt">“sc-user”</span> short form. This uses <a id="wrglossary.3367"></a><a href="#glo:glsabbrvscfont"><code class="csfmt">\glsabbrvscfont</code></a>, which in turn uses <a id="wrglossary.3368"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a> to apply a <a id="wrglossary.3369"></a><a href="#glo:idx.smallcaps">small caps</a> style, so your document font needs to support it.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+<a id="wrglossary.3370"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a> uses small capital glyphs for <a id="wrglossary.3371"></a><a href="#glo:idx.lowercase">lowercase</a> characters. <a id="wrglossary.3372"></a><a href="#glo:idx.uppercase">Uppercase</a> characters show as normal capitals. This means that you need to use <a id="wrglossary.3373"></a><a href="#glo:idx.lowercase">lowercase</a> characters in the abbreviation. </div><!-- end of information -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3374"></a><code class="code"><dfn id="glo:glsfirstabbrvscuserfont"><code class="csfmt">\glsfirstabbrvscuserfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Formatting for the <span class="qt">“sc-user”</span> short form shown on <a id="wrglossary.3375"></a><a href="#glo:dual.firstuse">first use</a>. This defaults to <a id="wrglossary.3376"></a><a href="#glo:glsabbrvscuserfont"><code class="csfmt">\glsabbrvscuserfont</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3377"></a><code class="code"><dfn id="glo:glsxtrscuserrevert"><code class="csfmt">\glsxtrscuserrevert</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Counteracts the effect of <a id="wrglossary.3378"></a><a href="#glo:glsabbrvscuserfont"><code class="csfmt">\glsabbrvscuserfont</code></a>. The default is <a id="wrglossary.3379"></a><a href="#glo:glsxtrscrevert"><code class="csfmt">\glsxtrscrevert</code></a>. If you redefine <a id="wrglossary.3380"></a><a href="#glo:glsabbrvscuserfont"><code class="csfmt">\glsabbrvscuserfont</code></a>, you will need to redefine <a id="wrglossary.3381"></a><a href="#glo:glsxtrscuserrevert"><code class="csfmt">\glsxtrscuserrevert</code></a> as applicable.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3382"></a><code class="code"><dfn id="glo:glsxtrscusersuffix"><code class="csfmt">\glsxtrscusersuffix</code></dfn></code></div><!-- end of pinnedbox -->
+ Short plural suffix used by the <span class="qt">“sc-user”</span> styles. This defaults to <a id="wrglossary.3383"></a><a href="#glo:glsxtrscsuffix"><code class="csfmt">\glsxtrscsuffix</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3384"></a><code class="code"><dfn id="glo:glsuserdescription"><code class="csfmt">\glsuserdescription</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The description field is set to this, where the <span class="meta">〈<em class="metainner">text</em>〉</span> argument is the long form, for the <span class="qt">“user”</span> styles where the description is set by default. This is defined to ignore its second argument: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.3385"></a><a href="#glo:glsuserdescription"><code class="csfmt">\glsuserdescription</code></a>}[2]{<a id="wrglossary.3386"></a><a href="#glo:glslonguserfont"><code class="csfmt">\glslonguserfont</code></a>{#1}}
+</pre> If you want to include the information contained in the field identified by <a id="wrglossary.3387"></a><a href="#glo:glsxtruserfield"><code class="csfmt">\glsxtruserfield</code></a>, the second argument provides a way of accessing that field without relying on the <a id="wrglossary.3388"></a><a href="#glo:glscurrententrylabel"><code class="csfmt">\glscurrententrylabel</code></a> placeholder. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.3389"></a><a href="#glo:glsuserdescription"><code class="csfmt">\glsuserdescription</code></a>}[2]{%
+ <a id="wrglossary.3390"></a><a href="#glo:glslonguserfont"><code class="csfmt">\glslonguserfont</code></a>{#1}%
+ <a id="wrglossary.3391"></a><a href="#glo:ifglshasfield"><code class="csfmt">\ifglshasfield</code></a>{<a id="wrglossary.3392"></a><a href="#glo:glsxtruserfield"><code class="csfmt">\glsxtruserfield</code></a>}{#2}%
+ {, <a id="wrglossary.3393"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a>}%
+ {}%
}
-</pre>
-<!--l. 4176--><p class="nopar" > (which picks up the post-description hook).
-</p><!--l. 4179--><p class="indent" > Alternatively you can use the <span
-class="cmtt-10">\glsxtrpostname</span>&#x27E8;<span
-class="cmitt-10">category</span>&#x27E9; hook to append
-information after the name according to the entry&#8217;s category.
-</p><!--l. 4183--><p class="indent" > Sub-entries are displayed using
-</p><!--l. 4184--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24020"></a> <span
-class="cmtt-10">\glsxtrbookindexsubname{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4186--><p class="noindent" >
-which just defaults to <span
-class="cmtt-10">\glsxtrbookindexname{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>.
-</p><!--l. 4189--><p class="indent" > The separator used before the location list for top-level entries is given
-by
-</p><!--l. 4191--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24021"></a> <span
-class="cmtt-10">\glsxtrbookindexprelocation{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4193--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; is the entry&#8217;s label. This checks if the <span
-class="cmtt-10">location </span>field has been set. If it
-has, it does
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-125">
-,\glsxtrprelocation
-</pre>
-<!--l. 4199--><p class="nopar" > otherwise it just does <span
-class="cmtt-10">\glsxtrprelocation </span>(which defaults to <span
-class="cmtt-10">\space</span>). If you&#8217;re not
-using <a
- id="dx1-24022"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a>, the <span
-class="cmss-10">location</span><a
- id="dx1-24023"></a> field won&#8217;t be set.
-</p><!--l. 4204--><p class="indent" > The separator used before the location list for sub-entries is given by
-</p><!--l. 4206--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24024"></a> <span
-class="cmtt-10">\glsxtrbookindexsubprelocation{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4208--><p class="noindent" >
-which defaults to <span
-class="cmtt-10">\glsxtrbookindexprelocation{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>.
-</p><!--l. 4211--><p class="indent" > The actual location list is encapsulated with:
-</p><!--l. 4212--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24025"></a> <span
-class="cmtt-10">\glsxtrbookindexlocation{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location list</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4214--><p class="noindent" >
-for top-level entries and
-</p><!--l. 4216--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24026"></a> <span
-class="cmtt-10">\glsxtrbookindexsublocation{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location list</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4218--><p class="noindent" >
-for sub-entries. These both just do &#x27E8;<span
-class="cmti-10">location list</span>&#x27E9; by default.
-</p><!--l. 4221--><p class="indent" > The separator used between a top-level parent and child entry is given
-by
-</p><!--l. 4223--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24027"></a> <span
-class="cmtt-10">\glsxtrbookindexparentchildsep </span></div><hr>
-</p><!--l. 4225--><p class="noindent" >
-This defaults to <span
-class="cmtt-10">\nopagebreak</span>.
-</p><!--l. 4228--><p class="indent" > The separator used between a sub-level parent and child entry is given
-by
-</p><!--l. 4230--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24028"></a> <span
-class="cmtt-10">\glsxtrbookindexparentsubchildsep </span></div><hr>
-</p><!--l. 4232--><p class="noindent" >
-This defaults to <span
-class="cmtt-10">\glsxtrbookindexparentchildsep</span>.
-</p><!--l. 4235--><p class="indent" > The separator between top-level entries is given by
-</p><!--l. 4236--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24029"></a> <span
-class="cmtt-10">\glsxtrbookindexbetween{</span>&#x27E8;<span
-class="cmitt-10">label1</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label2</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4238--><p class="noindent" >
-This comes after the entry given by &#x27E8;<span
-class="cmti-10">label1</span>&#x27E9;, if the entry has no children, or after the
-last descendent otherwise, so it always comes immediately before the entry given by
-&#x27E8;<span
-class="cmti-10">label2</span>&#x27E9; unless the entry occurs at the start of a group. This does nothing by
-default.
-</p><!--l. 4245--><p class="indent" > The separator between two level&#x00A0;1 entries is given by
-</p><!--l. 4246--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24030"></a> <span
-class="cmtt-10">\glsxtrbookindexsubbetween{</span>&#x27E8;<span
-class="cmitt-10">label1</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label2</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4248--><p class="noindent" >
-</p><!--l. 4250--><p class="indent" > The separator between two level&#x00A0;2 entries is given by
-</p><!--l. 4251--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24031"></a> <span
-class="cmtt-10">\glsxtrbookindexsubsubbetween{</span>&#x27E8;<span
-class="cmitt-10">label1</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label2</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4253--><p class="noindent" >
-At the end of each letter group, the following hooks are done in order:
-</p><!--l. 4256--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24032"></a> <span
-class="cmtt-10">\glsxtrbookindexsubsubatendgroup{</span>&#x27E8;<span
-class="cmitt-10">sub-sub-label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-
-
-
-</p><!--l. 4258--><p class="noindent" >
-</p><!--l. 4259--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24033"></a> <span
-class="cmtt-10">\glsxtrbookindexsubatendgroup{</span>&#x27E8;<span
-class="cmitt-10">sub-label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4261--><p class="noindent" >
-</p><!--l. 4262--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24034"></a> <span
-class="cmtt-10">\glsxtrbookindexatendgroup{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4264--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">sub-sub-label</span>&#x27E9; is the label of the last level&#x00A0;2 entry, &#x27E8;<span
-class="cmti-10">sub-label</span>&#x27E9; is the label of the
-last level&#x00A0;1 entry and &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; is the label of the last level&#x00A0;0 entry.
-</p><!--l. 4270--><p class="indent" > For example, the resource option <span
-class="cmtt-10">seealso=omit </span>instructs <a
- id="dx1-24035"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> to omit the
-<span
-class="cmtt-10">seealso </span>cross-reference from the location list. (The <span
-class="cmtt-10">see </span>cross-reference will still be
-added unless you also have <span
-class="cmtt-10">see=omit</span>.) The <span
-class="cmtt-10">seealso </span>cross-reference can instead be
-appended after the child entries using:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-126">
-\renewcommand{\glsxtrbookindexatendgroup}[1]{%
-&#x00A0;&#x00A0;\glsxtrifhasfield{seealso}{#1}{\glstreesubitem\glsxtruseseealso{#1}}{}%
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3394"></a><code class="code"><dfn id="glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If the field given by <a id="wrglossary.3395"></a><a href="#glo:glsxtruserfield"><code class="csfmt">\glsxtruserfield</code></a> has been set, this essentially does: <pre class="compactcodebox"><a id="wrglossary.3396"></a><a href="#glo:glsxtrfullsep"><code class="csfmt">\glsxtrfullsep</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}<a id="wrglossary.3397"></a><a href="#glo:glsxtrparen"><code class="csfmt">\glsxtrparen</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>, <span class="meta">〈<em class="metainner">user-value</em>〉</span>}
+</pre> otherwise it does: <pre class="compactcodebox"><a id="wrglossary.3398"></a><a href="#glo:glsxtrfullsep"><code class="csfmt">\glsxtrfullsep</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}<a id="wrglossary.3399"></a><a href="#glo:glsxtrparen"><code class="csfmt">\glsxtrparen</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}
+</pre> It’s a little more complicated than this as the definition includes the <a id="wrglossary.3400"></a><a href="#glo:dual.innerformatting">inner formatting</a> around the comma and the field value (<span class="meta">〈<em class="metainner">user-value</em>〉</span>). The comma separator is given by <a id="wrglossary.3401"></a><a href="#glo:glsxtruserparensep"><code class="csfmt">\glsxtruserparensep</code></a>, and the field value is encapsulated with <a id="wrglossary.3402"></a><a href="#glo:glsxtruserfieldfmt"><code class="csfmt">\glsxtruserfieldfmt</code></a> (with the <a id="wrglossary.3403"></a><a href="#glo:dual.innerformatting">inner formatting</a> inside).<p>
+If you redefine this command, you will also need to redefine the following one in a similar manner.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3404"></a><code class="code"><dfn id="glo:GLSxtruserparen"><code class="csfmt">\GLSxtruserparen</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but the content of the field given by <a id="wrglossary.3405"></a><a href="#glo:glsxtruserfield"><code class="csfmt">\glsxtruserfield</code></a> is converted to <a id="wrglossary.3406"></a><a href="#glo:idx.allcaps">all caps</a>. Note that simply applying an <a id="wrglossary.3407"></a><a href="#glo:idx.uppercase">uppercase</a> command to <a id="wrglossary.3408"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a> can fail as it can cause the label to be converted to <a id="wrglossary.3409"></a><a href="#glo:idx.allcaps">all caps</a>, which is the reason why a separate command to internally perform the case-change is provided.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3410"></a><code class="code"><dfn id="glo:glsxtrlongshortuserdescname"><code class="csfmt">\glsxtrlongshortuserdescname</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the value for the <a id="wrglossary.3411"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key for styles like <a id="wrglossary.3412"></a><a href="#glo:opt.abbrstyle.long-short-user-desc"><span class="abbrstylefmt">long-short-user-desc</span></a>. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\protect</code><a id="wrglossary.3413"></a><a href="#glo:glslonguserfont"><code class="csfmt">\glslonguserfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3414"></a><a href="#glo:glslongtok"><code class="csfmt">\glslongtok</code></a>}%
+<code class="cmd">\protect</code><a id="wrglossary.3415"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a>
+{<code class="cmd">\protect</code><a id="wrglossary.3416"></a><a href="#glo:glsabbrvuserfont"><code class="csfmt">\glsabbrvuserfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3417"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a>}}{<code class="cmd">\the</code><a id="wrglossary.3418"></a><a href="#glo:glslabeltok"><code class="csfmt">\glslabeltok</code></a>}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3419"></a><code class="code"><dfn id="glo:glsxtrlongshortscusername"><code class="csfmt">\glsxtrlongshortscusername</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the value for the <a id="wrglossary.3420"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key for styles like <a id="wrglossary.3421"></a><a href="#glo:opt.abbrstyle.long-postshort-sc-user"><span class="abbrstylefmt">long-postshort-sc-user</span></a> styles where the description is automatically set. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\protect</code><a id="wrglossary.3422"></a><a href="#glo:glsabbrvscuserfont"><code class="csfmt">\glsabbrvscuserfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3423"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a>}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3424"></a><code class="code"><dfn id="glo:glsxtrlongshortscuserdescname"><code class="csfmt">\glsxtrlongshortscuserdescname</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the value for the <a id="wrglossary.3425"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key for styles like <a id="wrglossary.3426"></a><a href="#glo:opt.abbrstyle.long-postshort-sc-user-desc"><span class="abbrstylefmt">long-postshort-sc-user-desc</span></a>. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\protect</code><a id="wrglossary.3427"></a><a href="#glo:glslonguserfont"><code class="csfmt">\glslonguserfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3428"></a><a href="#glo:glslongtok"><code class="csfmt">\glslongtok</code></a>}%
+<code class="cmd">\protect</code><a id="wrglossary.3429"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a>
+{<code class="cmd">\protect</code><a id="wrglossary.3430"></a><a href="#glo:glsabbrvscuserfont"><code class="csfmt">\glsabbrvscuserfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3431"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a>}}{<code class="cmd">\the</code><a id="wrglossary.3432"></a><a href="#glo:glslabeltok"><code class="csfmt">\glslabeltok</code></a>}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3433"></a><code class="code"><dfn id="glo:glsxtrshortlonguserdescname"><code class="csfmt">\glsxtrshortlonguserdescname</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the value for the <a id="wrglossary.3434"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key for styles like <a id="wrglossary.3435"></a><a href="#glo:opt.abbrstyle.short-long-user-desc"><span class="abbrstylefmt">short-long-user-desc</span></a>. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\protect</code><a id="wrglossary.3436"></a><a href="#glo:glsabbrvuserfont"><code class="csfmt">\glsabbrvuserfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3437"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a>}%
+<code class="cmd">\protect</code><a id="wrglossary.3438"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a>
+ {<code class="cmd">\protect</code><a id="wrglossary.3439"></a><a href="#glo:glslonguserfont"><code class="csfmt">\glslonguserfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3440"></a><a href="#glo:glslongpltok"><code class="csfmt">\glslongpltok</code></a>}}%
+ {<code class="cmd">\the</code><a id="wrglossary.3441"></a><a href="#glo:glslabeltok"><code class="csfmt">\glslabeltok</code></a>}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3442"></a><code class="code"><dfn id="glo:glsxtruserlongshortformat"><code class="csfmt">\glsxtruserlongshortformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is used on the <a id="wrglossary.3443"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.3444"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or with <a id="wrglossary.3445"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> by styles like <a id="wrglossary.3446"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a> to format the long form followed by the short form (with optional user information) in parentheses. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.3447"></a><a href="#glo:glsxtruserlongshortformat"><code class="csfmt">\glsxtruserlongshortformat</code></a>}[4]{%
+ <a id="wrglossary.3448"></a><a href="#glo:glsxtrlongformat"><code class="csfmt">\glsxtrlongformat</code></a>{#1}{#2}{#3}%
+ <a id="wrglossary.3449"></a><a href="#glo:glsxtrusershortformat"><code class="csfmt">\glsxtrusershortformat</code></a>{#1}{#4}%
}
-\renewcommand{\glsxtrbookindexbetween}[2]{%
-&#x00A0;&#x00A0;\glsxtrbookindexatendgroup{#1}%
-}%
-\renewcommand{\glsxtrbookindexsubatendgroup}[1]{%
-&#x00A0;&#x00A0;\glsxtrifhasfield{seealso}{#1}{\glstreesubsubitem\glsxtruseseealso{#1}}{}%
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3450"></a><code class="code"><dfn id="glo:Glsxtruserlongshortformat"><code class="csfmt">\Glsxtruserlongshortformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but for <a id="wrglossary.3451"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3452"></a><code class="code"><dfn id="glo:GLSxtruserlongshortformat"><code class="csfmt">\GLSxtruserlongshortformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but for <a id="wrglossary.3453"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3454"></a><code class="code"><dfn id="glo:glsxtruserlongshortplformat"><code class="csfmt">\glsxtruserlongshortplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is used on the <a id="wrglossary.3455"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.3456"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> or with <a id="wrglossary.3457"></a><a href="#glo:glsxtrfullpl"><code class="csfmt">\glsxtrfullpl</code></a> by styles like <a id="wrglossary.3458"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a> to format the plural long form followed by the plural short form (with optional user information) in parentheses. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.3459"></a><a href="#glo:glsxtruserlongshortplformat"><code class="csfmt">\glsxtruserlongshortplformat</code></a>}[4]{%
+ <a id="wrglossary.3460"></a><a href="#glo:glsxtrlongplformat"><code class="csfmt">\glsxtrlongplformat</code></a>{#1}{#2}{#3}%
+ <a id="wrglossary.3461"></a><a href="#glo:glsxtrusershortplformat"><code class="csfmt">\glsxtrusershortplformat</code></a>{#1}{#4}%
}
-\renewcommand{\glsxtrbookindexsubbetween}[2]{%
-&#x00A0;&#x00A0;\glsxtrbookindexsubatendgroup{#1}%
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3462"></a><code class="code"><dfn id="glo:Glsxtruserlongshortplformat"><code class="csfmt">\Glsxtruserlongshortplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but for <a id="wrglossary.3463"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3464"></a><code class="code"><dfn id="glo:GLSxtruserlongshortplformat"><code class="csfmt">\GLSxtruserlongshortplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but for <a id="wrglossary.3465"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3466"></a><code class="code"><dfn id="glo:glsxtrusershortlongformat"><code class="csfmt">\glsxtrusershortlongformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is used on the <a id="wrglossary.3467"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.3468"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or with <a id="wrglossary.3469"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> by styles like <a id="wrglossary.3470"></a><a href="#glo:opt.abbrstyle.short-long-user"><span class="abbrstylefmt">short-long-user</span></a> to format the short form followed by the long form (with optional user information) in parentheses. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.3471"></a><a href="#glo:glsxtrusershortlongformat"><code class="csfmt">\glsxtrusershortlongformat</code></a>}[4]{%
+ <a id="wrglossary.3472"></a><a href="#glo:glsxtrshortformat"><code class="csfmt">\glsxtrshortformat</code></a>{#1}{#2}{#3}%
+ <a id="wrglossary.3473"></a><a href="#glo:glsxtruserlongformat"><code class="csfmt">\glsxtruserlongformat</code></a>{#1}{#4}%
}
-\renewcommand{\glsxtrbookindexsubsubatendgroup}[1]{%
-&#x00A0;&#x00A0;\glsxtrifhasfield{seealso}{#1}%
-&#x00A0;&#x00A0;{\glstreeitem\hspace*{40pt}\glsxtruseseealso{#1}}{}%
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3474"></a><code class="code"><dfn id="glo:Glsxtrusershortlongformat"><code class="csfmt">\Glsxtrusershortlongformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but for <a id="wrglossary.3475"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3476"></a><code class="code"><dfn id="glo:GLSxtrusershortlongformat"><code class="csfmt">\GLSxtrusershortlongformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but for <a id="wrglossary.3477"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3478"></a><code class="code"><dfn id="glo:glsxtrusershortlongplformat"><code class="csfmt">\glsxtrusershortlongplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is used on the <a id="wrglossary.3479"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.3480"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> or with <a id="wrglossary.3481"></a><a href="#glo:glsxtrfullpl"><code class="csfmt">\glsxtrfullpl</code></a> by styles like <a id="wrglossary.3482"></a><a href="#glo:opt.abbrstyle.short-long-user"><span class="abbrstylefmt">short-long-user</span></a> to format the plural short form followed by the plural long form (with optional user information) in parentheses. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.3483"></a><a href="#glo:glsxtrusershortlongplformat"><code class="csfmt">\glsxtrusershortlongplformat</code></a>}[4]{%
+ <a id="wrglossary.3484"></a><a href="#glo:glsxtrshortplformat"><code class="csfmt">\glsxtrshortplformat</code></a>{#1}{#2}{#3}%
+ <a id="wrglossary.3485"></a><a href="#glo:glsxtruserlongplformat"><code class="csfmt">\glsxtruserlongplformat</code></a>{#1}{#4}%
}
-\renewcommand{\glsxtrbookindexsubsubbetween}[2]{%
-&#x00A0;&#x00A0;\glsxtrbookindexsubsubatendgroup{#1}%
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3486"></a><code class="code"><dfn id="glo:Glsxtrusershortlongplformat"><code class="csfmt">\Glsxtrusershortlongplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but for <a id="wrglossary.3487"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3488"></a><code class="code"><dfn id="glo:GLSxtrusershortlongplformat"><code class="csfmt">\GLSxtrusershortlongplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but for <a id="wrglossary.3489"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3490"></a><code class="code"><dfn id="glo:glsxtrusershortformat"><code class="csfmt">\glsxtrusershortformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Used to format the singular short form in parentheses (with <a id="wrglossary.3491"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a>) on the <a id="wrglossary.3492"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.3493"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or <a id="wrglossary.3494"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> or with <a id="wrglossary.3495"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> or <a id="wrglossary.3496"></a><a href="#glo:Glsxtrfull"><code class="csfmt">\Glsxtrfull</code></a> for styles like <a id="wrglossary.3497"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a>. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.3498"></a><a href="#glo:glsxtrusershortformat"><code class="csfmt">\glsxtrusershortformat</code></a>}[2]{%
+ <a id="wrglossary.3499"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a>{<a id="wrglossary.3500"></a><a href="#glo:glsxtrshortformat"><code class="csfmt">\glsxtrshortformat</code></a>{#1}{}{#2}}{#1}%
}
-</pre>
-<!--l. 4300--><p class="nopar" > This uses <span
-class="cmtt-10">\glstreesubitem </span>and <span
-class="cmtt-10">\glstreesubsubitem </span>to indent the cross-reference
-according to the next level down, so the cross-reference for a top-level entry is aligned
-with the sub-entries, and a level&#x00A0;1 entry has its cross-reference aligned with
-sub-sub-entries. In the event that a level&#x00A0;2 entry has a cross-reference, this is
-indented a bit further (but it won&#8217;t be aligned with any deeper level as the <span
-class="cmss-10">bookindex</span><a
- id="dx1-24036"></a>
-style only supports a maximum of two sub-levels).
-</p><!--l. 4311--><p class="indent" > The <span
-class="cmss-10">bookindex</span><a
- id="dx1-24037"></a> style uses group headings. (If you use <a
- id="dx1-24038"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> remember to invoke
-it with the <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">--group</span></span></span> or <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">-g</span></span></span> switch.) The heading will use
-</p><!--l. 4314--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24039"></a> <span
-class="cmtt-10">\glsxtrbookindexbookmark{</span>&#x27E8;<span
-class="cmitt-10">group title</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">name</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4316--><p class="noindent" >
-If <span
-class="cmtt-10">\pdfbookmark </span>has been defined, this will use that command to bookmark the
-group title. If <a
-href="#styopt.section"><span
-class="cmss-10">section</span></a><span
-class="cmss-10">=chapter</span><a
- id="dx1-24040"></a> is set (default if chapters are defined) then this
-uses level&#x00A0;1 otherwise it uses level&#x00A0;2. You can redefine this command if this
-isn&#8217;t appropriate. If <span
-class="cmtt-10">\pdfbookmark </span>hasn&#8217;t been defined, this command does
-nothin.
-</p><!--l. 4324--><p class="indent" > The group heading is formatted according to
-</p><!--l. 4325--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24041"></a> <span
-class="cmtt-10">\glsxtrbookindexformatheader{</span>&#x27E8;<span
-class="cmitt-10">group title</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4327--><p class="noindent" >
-which is defined as
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-127">
-\newcommand*{\glsxtrbookindexformatheader}[1]{%
-&#x00A0;&#x00A0;\par{\centering\glstreegroupheaderfmt{#1}\par}%
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3501"></a><code class="code"><dfn id="glo:glsxtrusershortplformat"><code class="csfmt">\glsxtrusershortplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.3502"></a><a href="#glo:glsxtrusershortformat"><code class="csfmt">\glsxtrusershortformat</code></a> but for the <a id="wrglossary.3503"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.3504"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> or with <a id="wrglossary.3505"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> for styles like <a id="wrglossary.3506"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a>. This has a similar definition to the above but with <a id="wrglossary.3507"></a><a href="#glo:glsxtrshortplformat"><code class="csfmt">\glsxtrshortplformat</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3508"></a><code class="code"><dfn id="glo:GLSxtrusershortformat"><code class="csfmt">\GLSxtrusershortformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.3509"></a><a href="#glo:glsxtrusershortformat"><code class="csfmt">\glsxtrusershortformat</code></a> but is used with the <a id="wrglossary.3510"></a><a href="#glo:idx.allcaps">all caps</a> <a id="wrglossary.3511"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a> or <a id="wrglossary.3512"></a><a href="#glo:GLSxtrfull"><code class="csfmt">\GLSxtrfull</code></a>. This uses <a id="wrglossary.3513"></a><a href="#glo:GLSxtruserparen"><code class="csfmt">\GLSxtruserparen</code></a> instead of <a id="wrglossary.3514"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3515"></a><code class="code"><dfn id="glo:GLSxtrusershortplformat"><code class="csfmt">\GLSxtrusershortplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.3516"></a><a href="#glo:glsxtrusershortplformat"><code class="csfmt">\glsxtrusershortplformat</code></a> but is used with the <a id="wrglossary.3517"></a><a href="#glo:idx.allcaps">all caps</a> <a id="wrglossary.3518"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a> or <a id="wrglossary.3519"></a><a href="#glo:GLSxtrfullpl"><code class="csfmt">\GLSxtrfullpl</code></a>. This uses <a id="wrglossary.3520"></a><a href="#glo:GLSxtruserparen"><code class="csfmt">\GLSxtruserparen</code></a> instead of <a id="wrglossary.3521"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3522"></a><code class="code"><dfn id="glo:glsxtrpostusershortformat"><code class="csfmt">\glsxtrpostusershortformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Used in the <a id="wrglossary.3523"></a><a href="#glo:dual.postlinkhook">post-link hook</a> to format the short form in parentheses for styles like <a id="wrglossary.3524"></a><a href="#glo:opt.abbrstyle.long-postshort-user"><span class="abbrstylefmt">long-postshort-user</span></a>. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.3525"></a><a href="#glo:glsxtrpostusershortformat"><code class="csfmt">\glsxtrpostusershortformat</code></a>}[2]{%
+ <a id="wrglossary.3526"></a><a href="#glo:glsxtrifallcaps"><code class="csfmt">\glsxtrifallcaps</code></a>
+ {<a id="wrglossary.3527"></a><a href="#glo:GLSxtrusershortformat"><code class="csfmt">\GLSxtrusershortformat</code></a>{#1}{#2}}%
+ {<a id="wrglossary.3528"></a><a href="#glo:glsxtrusershortformat"><code class="csfmt">\glsxtrusershortformat</code></a>{#1}{#2}}%
}
-</pre>
-<!--l. 4333--><p class="nopar" > where <span
-class="cmtt-10">\glstreegroupheaderfmt </span>is provided by the <span
-class="cmss-10">glossary-tree</span><a
- id="dx1-24042"></a> package, which is
-automatically loaded. Note that the entry names aren&#8217;t encapsulated with
-<span
-class="cmtt-10">\glstreenamefmt</span>.
-</p><!--l. 4339--><p class="indent" > The <span
-class="cmss-10">glossary-bookindex</span><a
- id="dx1-24043"></a> package provides some supplementary commands that
-aren&#8217;t used by default, but may be used when adjusting the style. These commands
-should only be used within one of the <span
-class="cmtt-10">\print</span><span
-class="cmtt-10">&#x2026;glossary </span>commands. (That is, they
-should only be used in glossary styles.)
-</p><!--l. 4344--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24044"></a> <span
-class="cmtt-10">\glsxtrbookindexmarkentry{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4346--><p class="noindent" >
-This writes information to the <span
-class="cmtt-10">.aux </span>file that can be read on the next run to obtain
-the first and last entry on each page of the glossary.
-</p><!--l. 4351--><p class="indent" > You can display the first entry associated with the current page using:
-</p><!--l. 4353--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24045"></a> <span
-class="cmtt-10">\glsxtrbookindexfirstmark </span></div><hr>
-</p><!--l. 4355--><p class="noindent" >
-and the last entry associated with the current page using:
-</p><!--l. 4358--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24046"></a> <span
-class="cmtt-10">\glsxtrbookindexlastmark </span></div><hr>
-</p><!--l. 4360--><p class="noindent" >
-These do nothing if there are no entries marked on the current page (or if the
-document build isn&#8217;t up to date).
-</p><!--l. 4364--><p class="indent" > The entry is formatted using:
-</p><!--l. 4365--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24047"></a> <span
-class="cmtt-10">\glsxtrbookindexfirstmarkfmt{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4367--><p class="noindent" >
-for the first instance and
-</p><!--l. 4369--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-24048"></a> <span
-class="cmtt-10">\glsxtrbookindexlastmarkfmt{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4371--><p class="noindent" >
-for the last.
-</p><!--l. 4374--><p class="indent" > These commands are designed for use in page headers or footers where the page
-number is stable. For example, <span
-class="cmtt-10">\glsxtrbookindexname </span>can be redefined to mark the
-current entry:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-128">
-\renewcommand{\glsxtrbookindexname}[1]{%
-&#x00A0;&#x00A0;\glsxtrbookindexmarkentry{#1}%
-&#x00A0;&#x00A0;\glossentryname{#1}%
+</pre> Note that this doesn’t check if the plural form was used. If you require this, you will need to redefined this command to include <a id="wrglossary.3529"></a><a href="#glo:glsifplural"><code class="csfmt">\glsifplural</code></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.3530"></a><a href="#glo:glsxtrpostusershortformat"><code class="csfmt">\glsxtrpostusershortformat</code></a>}[2]{%
+ <a id="wrglossary.3531"></a><a href="#glo:glsifplural"><code class="csfmt">\glsifplural</code></a>
+ {%
+ <a id="wrglossary.3532"></a><a href="#glo:glsxtrifallcaps"><code class="csfmt">\glsxtrifallcaps</code></a>
+ {<a id="wrglossary.3533"></a><a href="#glo:GLSxtrusershortplformat"><code class="csfmt">\GLSxtrusershortplformat</code></a>{#1}{#2}}%
+ {<a id="wrglossary.3534"></a><a href="#glo:glsxtrusershortplformat"><code class="csfmt">\glsxtrusershortplformat</code></a>{#1}{#2}}%
+ }%
+ {%
+ <a id="wrglossary.3535"></a><a href="#glo:glsxtrifallcaps"><code class="csfmt">\glsxtrifallcaps</code></a>
+ {<a id="wrglossary.3536"></a><a href="#glo:GLSxtrusershortformat"><code class="csfmt">\GLSxtrusershortformat</code></a>{#1}{#2}}%
+ {<a id="wrglossary.3537"></a><a href="#glo:glsxtrusershortformat"><code class="csfmt">\glsxtrusershortformat</code></a>{#1}{#2}}%
+ }%
}
-</pre>
-<!--l. 4382--><p class="nopar" > If you only want to mark the top-level entries, remember to redefine
-<span
-class="cmtt-10">\glsxtrbookindexsubname </span>as it defaults to <span
-class="cmtt-10">\glsxtrbookindexname</span>:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-129">
-\renewcommand{\glsxtrbookindexsubname}[1]{%
-&#x00A0;&#x00A0;\glossentryname{#1}%
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3538"></a><code class="code"><dfn id="glo:glsxtruserlongformat"><code class="csfmt">\glsxtruserlongformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Used to format the singular long form in parentheses (with <a id="wrglossary.3539"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a>) on the <a id="wrglossary.3540"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.3541"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or <a id="wrglossary.3542"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> or with <a id="wrglossary.3543"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> for styles like <a id="wrglossary.3544"></a><a href="#glo:opt.abbrstyle.short-long-user"><span class="abbrstylefmt">short-long-user</span></a>. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.3545"></a><a href="#glo:glsxtruserlongformat"><code class="csfmt">\glsxtruserlongformat</code></a>}[2]{%
+ <a id="wrglossary.3546"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a>{<a id="wrglossary.3547"></a><a href="#glo:glsxtrlongformat"><code class="csfmt">\glsxtrlongformat</code></a>{#1}{}{#2}}{#1}%
}
-</pre>
-<!--l. 4390--><p class="nopar" >
-</p><!--l. 4392--><p class="indent" > Then if you&#8217;re using <span
-class="cmss-10">fancyhdr</span><a
- id="dx1-24049"></a> you can set the page style to show the first and last
-entry for the current page with:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-130">
-&#x00A0;&#x00A0;\pagestyle{fancy}%
-&#x00A0;&#x00A0;\lhead{\thepage}%
-&#x00A0;&#x00A0;\lfoot{\glsxtrbookindexfirstmark}%
-&#x00A0;&#x00A0;\cfoot{}%
-&#x00A0;&#x00A0;\rfoot{\glsxtrbookindexlastmark}%
-</pre>
-<!--l. 4400--><p class="nopar" >
-</p><!--l. 4402--><p class="noindent" >
-</p>
-<!--l. 4402--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">3.2 </span> <a
- id="sec:longextra"></a>glossary-longextra package</h3>
-<!--l. 4405--><p class="noindent" >As from version 1.37, the <span
-class="cmss-10">glossaries-extra </span>package comes with the supplementary
-package <span
-class="cmss-10">glossary-longextra</span><a
- id="dx1-25001"></a> that provides additional styles, listed below, that use the
-<span
-class="cmss-10">longtable</span><a
- id="dx1-25002"></a><a
- id="dx1-25003"></a> environment. If you know that your glossary won&#8217;t span more than a page
-and you need to use it in a context that&#8217;s incompatible with <span
-class="cmss-10">longtable</span><a
- id="dx1-25004"></a><a
- id="dx1-25005"></a>, you can
-instead setup these styles to use <span
-class="cmss-10">tabular</span><a
- id="dx1-25006"></a><a
- id="dx1-25007"></a> instead. In order to do this you must
-use
-</p><!--l. 4412--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25008"></a> <span
-class="cmtt-10">\GlsLongExtraUseTabulartrue </span></div><hr>
-</p><!--l. 4414--><p class="noindent" >
-<span
-class="cmti-10">before the style is set</span>. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-131">
-\GlsLongExtraUseTabulartrue
-\setglossarystyle{long-name-desc}
-</pre>
-<!--l. 4419--><p class="nopar" > or
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-132">
-\GlsLongExtraUseTabulartrue
-\printunsrtglossary[style={long-name-desc}]
-</pre>
-<!--l. 4424--><p class="nopar" > If you use this setting, you can change the default vertical alignment with:
-</p><!--l. 4427--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25009"></a> <span
-class="cmtt-10">\glslongextraTabularVAlign </span></div><hr>
-</p><!--l. 4429--><p class="noindent" >
-The default definition is <span
-class="cmtt-10">c</span>.
-</p><!--l. 4432--><p class="indent" > The column titles are formatted according to:
-</p><!--l. 4433--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25010"></a> <span
-class="cmtt-10">\glslongextraHeaderFmt{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4435--><p class="noindent" >
-which simply does <span
-class="cmtt-10">\textbf{</span>&#x27E8;<span
-class="cmti-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span>by default.
-</p><!--l. 4438--><p class="indent" > The name column has the title given by <span
-class="cmtt-10">\entryname</span><a
- id="dx1-25011"></a> and the column alignment is
-given by:
-</p><!--l. 4440--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25012"></a> <span
-class="cmtt-10">\glslongextraNameAlign </span></div><hr>
-</p><!--l. 4442--><p class="noindent" >
-which expands to <span
-class="cmtt-10">l </span>(left) by default.
-</p><!--l. 4445--><p class="indent" > The symbol column (where applicable) has the title given by <span
-class="cmtt-10">\symbolname</span><a
- id="dx1-25013"></a> and
-the column alignment is given by:
-</p><!--l. 4447--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25014"></a> <span
-class="cmtt-10">\glslongextraSymbolAlign </span></div><hr>
-</p><!--l. 4449--><p class="noindent" >
-which expands to <span
-class="cmtt-10">c </span>(centred) by default.
-</p><!--l. 4452--><p class="indent" > The location list column (where applicable) has the title given by <span
-class="cmtt-10">\pagelistname</span><a
- id="dx1-25015"></a>
-and the column alignment is given by:
-</p><!--l. 4454--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25016"></a> <span
-class="cmtt-10">\glslongextraLocationAlign </span></div><hr>
-</p><!--l. 4456--><p class="noindent" >
-which expands to
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-133">
-&#x003E;{\raggedright}p{\glspagelistwidth}
-</pre>
-<!--l. 4460--><p class="nopar" > by default. (Ragged-right paragraph, <span
-class="cmtt-10">\glspagelistwidth</span><a
- id="dx1-25017"></a> is defined in <span
-class="cmss-10">glossary-long</span><a
- id="dx1-25018"></a>,
-which is automatically loaded.)
-</p><!--l. 4464--><p class="indent" > The description column has the title given by <span
-class="cmtt-10">\descriptionname</span><a
- id="dx1-25019"></a> and the column
-alignment is given by:
-</p><!--l. 4466--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25020"></a> <span
-class="cmtt-10">\glslongextraDescAlign </span></div><hr>
-</p><!--l. 4468--><p class="noindent" >
-which expands to
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-134">
-&#x003E;{\raggedright}p{\glsdescwidth}
-</pre>
-<!--l. 4472--><p class="nopar" > by default. (Ragged-right paragraph, <span
-class="cmtt-10">\glsdescwidth</span><a
- id="dx1-25021"></a> is defined in <span
-class="cmss-10">glossary-long</span><a
- id="dx1-25022"></a>,
-which is automatically loaded.)
-</p><!--l. 4476--><p class="indent" > Unlike the long styles provided by the base <span
-class="cmss-10">glossaries </span>package, these new styles try
-to determine the value of <span
-class="cmtt-10">\glsdescwidth </span>at the start of the glossary according to the
-number of columns provided by the style. The calculations are performed by the
-following commands:
-</p><!--l. 4481--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25023"></a> <span
-class="cmtt-10">\glslongextraSetDescWidth </span></div><hr>
-</p><!--l. 4483--><p class="noindent" >
-This is used by the styles that have a name and description column. The value of
-<span
-class="cmtt-10">\glsdescwidth </span>is computed as:
-</p>
- <div class="math-display" >
-<img
-src="glossaries-extra-manual0x.png" alt="\glsdescwidth = \linewidth- 4\tabcolsep- W
-" class="math-display" /></div>
-<!--l. 4489--><p class="indent" > where <span
-class="cmmi-10">W </span>is a guess at the width of the name column. This is first set to the width
-of the name column header: </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\settowidth{</span>&#x27E8;<span
-class="cmitt-10">width</span>&#x27E9;<span
-class="cmtt-10">}</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">\glslongextraHeaderFmt\entryname</span><span
-class="cmsy-10">}</span>
-</div>
-</div> If any names in that column are larger than this, then you need to specify the widest
-name using:
-<!--l. 4496--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25024"></a> <span
-class="cmtt-10">\glslongextraSetWidest{</span>&#x27E8;<span
-class="cmitt-10">widest name</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4498--><p class="noindent" >
-or
-</p><!--l. 4500--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25025"></a> <span
-class="cmtt-10">\glslongextraUpdateWidest{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4502--><p class="noindent" >
-These work like the analogous commands <span
-class="cmtt-10">\glssetwidest </span>and <span
-class="cmtt-10">\glsupdatewidest</span>
-provided with the <span
-class="cmss-10">alttree</span><a
- id="dx1-25026"></a> style, but in this case there&#8217;s no hierarchy. The default
-widest name is obtained from the <span
-class="cmss-10">alttree</span><a
- id="dx1-25027"></a> top-level name if set, otherwise it&#8217;s empty,
-
-
-
-so you can use <a
- id="dx1-25028"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span>&#8217;s</a> <span
-class="cmtt-10">set-widest </span>option. If you have the entry counter enabled,
-you will need to include this with the name for the extra material to be taken into
-account.
-</p><!--l. 4512--><p class="indent" > The name isn&#8217;t shown for child entries by default, but if you change this and you
-want to use <a
- id="dx1-25029"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span>&#8217;s</a> <span
-class="cmtt-10">set-widest </span>option (for <a
- id="dx1-25030"></a><span
-class="cmtt-10">bib2gls </span>v1.8+) then you need to
-redefine:
-</p><!--l. 4516--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25031"></a> <span
-class="cmtt-10">\glslongextraUpdateWidestChild{</span>&#x27E8;<span
-class="cmitt-10">level</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4518--><p class="noindent" >
-This does nothing by default, but if you are including the child names then you need
-to redefine this command:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-135">
-\renewcommand{\glslongextraUpdateWidestChild}[2]{%
-&#x00A0;\glslongextraUpdateWidest{#2}%
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3548"></a><code class="code"><dfn id="glo:GLSxtruserlongformat"><code class="csfmt">\GLSxtruserlongformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.3549"></a><a href="#glo:glsxtruserlongformat"><code class="csfmt">\glsxtruserlongformat</code></a> but <a id="wrglossary.3550"></a><a href="#glo:idx.allcaps">all caps</a>. This uses <a id="wrglossary.3551"></a><a href="#glo:GLSxtruserparen"><code class="csfmt">\GLSxtruserparen</code></a> instead of <a id="wrglossary.3552"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3553"></a><code class="code"><dfn id="glo:glsxtruserlongplformat"><code class="csfmt">\glsxtruserlongplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.3554"></a><a href="#glo:glsxtruserlongformat"><code class="csfmt">\glsxtruserlongformat</code></a> but for the <a id="wrglossary.3555"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.3556"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> or with <a id="wrglossary.3557"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> for styles like <a id="wrglossary.3558"></a><a href="#glo:opt.abbrstyle.short-long-user"><span class="abbrstylefmt">short-long-user</span></a>. This has a similar definition to <a id="wrglossary.3559"></a><a href="#glo:glsxtruserlongformat"><code class="csfmt">\glsxtruserlongformat</code></a> but with <a id="wrglossary.3560"></a><a href="#glo:glsxtrlongplformat"><code class="csfmt">\glsxtrlongplformat</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3561"></a><code class="code"><dfn id="glo:GLSxtruserlongplformat"><code class="csfmt">\GLSxtruserlongplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.3562"></a><a href="#glo:glsxtruserlongplformat"><code class="csfmt">\glsxtruserlongplformat</code></a> but <a id="wrglossary.3563"></a><a href="#glo:idx.allcaps">all caps</a>. This uses <a id="wrglossary.3564"></a><a href="#glo:GLSxtruserparen"><code class="csfmt">\GLSxtruserparen</code></a> instead of <a id="wrglossary.3565"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3566"></a><code class="code"><dfn id="glo:glsxtrpostuserlongformat"><code class="csfmt">\glsxtrpostuserlongformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Used in the <a id="wrglossary.3567"></a><a href="#glo:dual.postlinkhook">post-link hook</a> to format the long form in parentheses for styles like <a id="wrglossary.3568"></a><a href="#glo:opt.abbrstyle.short-postlong-user"><span class="abbrstylefmt">short-postlong-user</span></a>. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.3569"></a><a href="#glo:glsxtrpostuserlongformat"><code class="csfmt">\glsxtrpostuserlongformat</code></a>}[2]{%
+ <a id="wrglossary.3570"></a><a href="#glo:glsxtrifallcaps"><code class="csfmt">\glsxtrifallcaps</code></a>
+ {<a id="wrglossary.3571"></a><a href="#glo:GLSxtruserlongformat"><code class="csfmt">\GLSxtruserlongformat</code></a>{#1}{#2}}%
+ {<a id="wrglossary.3572"></a><a href="#glo:glsxtruserlongformat"><code class="csfmt">\glsxtruserlongformat</code></a>{#1}{#2}}%
}
-</pre>
-<!--l. 4525--><p class="nopar" >
-</p><!--l. 4527--><p class="indent" > If you prefer to set an explicit width for the description column then you need to
-redefine <span
-class="cmtt-10">\glslongextraSetDescWidth</span>. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-136">
-\renewcommand{\glslongextraSetDescWidth}{%
-&#x00A0;&#x00A0;\setlength{\glsdescwidth}{0.6\linewidth}%
+</pre> Note that, as with <a id="wrglossary.3573"></a><a href="#glo:glsxtrpostusershortformat"><code class="csfmt">\glsxtrpostusershortformat</code></a>, this doesn’t check if the plural form was used. If you require this, you will need to redefined this command to include <a id="wrglossary.3574"></a><a href="#glo:glsifplural"><code class="csfmt">\glsifplural</code></a>.<p>
+
+</section><!-- end of section sec:abbrvcmdsuser -->
+
+<section id="sec:abbrvcmdsfootnote"><!-- start of section sec:abbrvcmdsfootnote --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.1.3.4. Footnote Styles<div class="labellink"><a href="#sec:abbrvcmdsfootnote">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These commands are only used by the footnote styles.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3575"></a><code class="code"><dfn id="glo:glsxtrfootnotename"><code class="csfmt">\glsxtrfootnotename</code></dfn></code></div><!-- end of pinnedbox -->
+ This command should expand to the value of the <a id="wrglossary.3576"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3577"></a><a href="#glo:glsxpabbrvfont"><code class="csfmt">\glsxpabbrvfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3578"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a>}{<a id="wrglossary.3579"></a><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a>}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3580"></a><code class="code"><dfn id="glo:glsxtrfootnotedescname"><code class="csfmt">\glsxtrfootnotedescname</code></dfn></code></div><!-- end of pinnedbox -->
+ This command should expand to the value of the <a id="wrglossary.3581"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key for styles like <a id="wrglossary.3582"></a><a href="#glo:opt.abbrstyle.short-footnote-desc"><span class="abbrstylefmt">footnote-desc</span></a>. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3583"></a><a href="#glo:glsxpabbrvfont"><code class="csfmt">\glsxpabbrvfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3584"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a>}{<a id="wrglossary.3585"></a><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a>}%
+<code class="cmd">\protect</code><a id="wrglossary.3586"></a><a href="#glo:glsxtrfullsep"><code class="csfmt">\glsxtrfullsep</code></a>{<code class="cmd">\the</code><a id="wrglossary.3587"></a><a href="#glo:glslabeltok"><code class="csfmt">\glslabeltok</code></a>}%
+<code class="cmd">\protect</code><a id="wrglossary.3588"></a><a href="#glo:glsxtrparen"><code class="csfmt">\glsxtrparen</code></a>
+ {<a id="wrglossary.3589"></a><a href="#glo:glsxplongfont"><code class="csfmt">\glsxplongfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3590"></a><a href="#glo:glslongtok"><code class="csfmt">\glslongtok</code></a>}{<a id="wrglossary.3591"></a><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a>}}%
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3592"></a><code class="code"><dfn id="glo:glsxtrfootnotedescsort"><code class="csfmt">\glsxtrfootnotedescsort</code></dfn></code></div><!-- end of pinnedbox -->
+ This command should expand to the value of the <a id="wrglossary.3593"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key for styles like <a id="wrglossary.3594"></a><a href="#glo:opt.abbrstyle.short-footnote-desc"><span class="abbrstylefmt">footnote-desc</span></a>. The default definition is simply <code class="code"><span class="cmdfmt">\the</span><a id="wrglossary.3595"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a></code>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+This command is irrelevant with the <a id="wrglossary.3596"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>. </div><!-- end of information -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3597"></a><code class="code"><dfn id="glo:glslongfootnotefont"><code class="csfmt">\glslongfootnotefont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The formatting command used for the long form in the footnote styles. The default is to simply use <a id="wrglossary.3598"></a><a href="#glo:glslongdefaultfont"><code class="csfmt">\glslongdefaultfont</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3599"></a><code class="code"><dfn id="glo:glsfirstlongfootnotefont"><code class="csfmt">\glsfirstlongfootnotefont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The formatting command used for the <a id="wrglossary.3600"></a><a href="#glo:dual.firstuse">first use</a> long form in the footnote styles. The default is to simply use <a id="wrglossary.3601"></a><a href="#glo:glslongfootnotefont"><code class="csfmt">\glslongfootnotefont</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3602"></a><code class="code"><dfn id="glo:glsxtrabbrvfootnote"><code class="csfmt">\glsxtrabbrvfootnote</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The command that produces the footnote. The default definition ignores the first argument: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.3603"></a><a href="#glo:glsxtrabbrvfootnote"><code class="csfmt">\glsxtrabbrvfootnote</code></a>}[2]{<a id="wrglossary.3604"></a><a href="#glo:footnote"><code class="csfmt">\footnote</code></a>{#2}}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3605"></a><code class="code"><dfn id="glo:glsxtrfootnotelongformat"><code class="csfmt">\glsxtrfootnotelongformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is used within the footnote to display the long form formatted with <span class="meta">〈<em class="metainner">fmt-cs</em>〉</span> for the footnote styles on <a id="wrglossary.3606"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.3607"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>, <a id="wrglossary.3608"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> and <a id="wrglossary.3609"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a>. The default definition is simply: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.3610"></a><a href="#glo:glsxtrfootnotelongformat"><code class="csfmt">\glsxtrfootnotelongformat</code></a>}[2]{%
+ <a id="wrglossary.3611"></a><a href="#glo:glsxtrlongformat"><code class="csfmt">\glsxtrlongformat</code></a>{#1}{}{#2}%
}
-</pre>
-<!--l. 4534--><p class="nopar" >
-</p><!--l. 4536--><p class="indent" > The styles that have a name, symbol and description, <span
-class="cmtt-10">\glsdescwidth </span>is set
-with:
-</p><!--l. 4538--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25032"></a> <span
-class="cmtt-10">\glslongextraSymSetDescWidth </span></div><hr>
-</p><!--l. 4540--><p class="noindent" >
-This first uses <span
-class="cmtt-10">\glslongextraSetDescWidth </span>and then subtracts 2<span
-class="cmtt-10">\tabcolsep </span>and
-the width of the symbol column header from <span
-class="cmtt-10">\glsdescwidth</span>. This assumes that the
-symbol column header is larger than any of the symbols. If this isn&#8217;t appropriate then
-you can redefine this command. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-137">
-\renewcommand{\glslongextraSymSetDescWidth}{%
-&#x00A0;&#x00A0;\glslongextraSetDescWidth
-&#x00A0;&#x00A0;\addtolength{\glsdescwidth}{-3cm}%
+</pre> For example, if the footnote should start with an <a id="wrglossary.3612"></a><a href="#glo:idx.uppercase">uppercase</a> letter then simply redefine this to use <a id="wrglossary.3613"></a><a href="#glo:Glsxtrlongformat"><code class="csfmt">\Glsxtrlongformat</code></a> instead: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.3614"></a><a href="#glo:glsxtrfootnotelongformat"><code class="csfmt">\glsxtrfootnotelongformat</code></a>}[2]{%
+ <a id="wrglossary.3615"></a><a href="#glo:Glsxtrlongformat"><code class="csfmt">\Glsxtrlongformat</code></a>{#1}{}{#2}%
}
-</pre>
-<!--l. 4551--><p class="nopar" > or
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-138">
-\renewcommand{\glslongextraSymSetDescWidth}{%
-&#x00A0;&#x00A0;\setlength{\glsdescwidth}{.5\linewidth}%
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3616"></a><code class="code"><dfn id="glo:glsxtrfootnotelongplformat"><code class="csfmt">\glsxtrfootnotelongplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is used within the footnote to display the plural long form formatted with <span class="meta">〈<em class="metainner">fmt-cs</em>〉</span> for the footnote styles on <a id="wrglossary.3617"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.3618"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>, <a id="wrglossary.3619"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a> and <a id="wrglossary.3620"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a>. The default definition is simply: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.3621"></a><a href="#glo:glsxtrfootnotelongplformat"><code class="csfmt">\glsxtrfootnotelongplformat</code></a>}[2]{%
+ <a id="wrglossary.3622"></a><a href="#glo:glsxtrlongplformat"><code class="csfmt">\glsxtrlongplformat</code></a>{#1}{}{#2}%
}
-</pre>
-<!--l. 4557--><p class="nopar" >
-</p><!--l. 4559--><p class="indent" > For the styles that have a name, description and location column, <span
-class="cmtt-10">\glsdescwidth</span>
-is set using:
-</p><!--l. 4561--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25033"></a> <span
-class="cmtt-10">\glslongextraLocSetDescWidth </span></div><hr>
-</p><!--l. 4563--><p class="noindent" >
-This uses <span
-class="cmtt-10">\glslongextraSetDescWidth </span>and then subtracts 2<span
-class="cmtt-10">\tabcolsep </span>and
-<span
-class="cmtt-10">\glspagelistwidth </span>from <span
-class="cmtt-10">\glsdescwidth</span>. You can redefine this command to set
-both <span
-class="cmtt-10">\glsdescwidth </span>and <span
-class="cmtt-10">\glspagelistwidth </span>if appropriate.
-</p><!--l. 4569--><p class="indent" > For the styles that have a name, description, symbol and location column,
-<span
-class="cmtt-10">\glsdescwidth </span>is set using:
-</p><!--l. 4571--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25034"></a> <span
-class="cmtt-10">\glslongextraSymLocSetDescWidth </span></div><hr>
-</p><!--l. 4573--><p class="noindent" >
-This uses <span
-class="cmtt-10">\glslongextraSymSetDescWidth </span>and then subtracts 2<span
-class="cmtt-10">\tabcolsep </span>and
-<span
-class="cmtt-10">\glspagelistwidth </span>from <span
-class="cmtt-10">\glsdescwidth</span>. Again, you can redefine this command to
-explicitly set both lengths.
-</p><!--l. 4579--><p class="indent" > In all cases, the top-level name is formatted according to:
-</p><!--l. 4580--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25035"></a> <span
-class="cmtt-10">\glslongextraNameFmt{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4582--><p class="noindent" >
-This does </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\glsentryitem{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}\glstarget{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">\glossentryname{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span><span
-class="cmsy-10">}</span>
-</div>
-</div> which includes the entry counter (if enabled), the target and the post-name
-link.
-<!--l. 4589--><p class="indent" > The top-level description is formatted according to:
-</p><!--l. 4590--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25036"></a> <span
-class="cmtt-10">\glslongextraDescFmt{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4592--><p class="noindent" >
-This does <span
-class="cmtt-10">\glossentrydesc{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span>followed by the post-description hook.
-</p><!--l. 4596--><p class="indent" > The styles that have a symbol column format the symbol using:
-</p><!--l. 4597--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25037"></a> <span
-class="cmtt-10">\glslongextraSymbolFmt{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4599--><p class="noindent" >
-This just does <span
-class="cmtt-10">\glossentrysymbol{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>.
-</p><!--l. 4602--><p class="indent" > The styles that have a location list column format the list using:
-</p><!--l. 4603--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25038"></a> <span
-class="cmtt-10">\glslongextraLocationFmt{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">locations</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4605--><p class="noindent" >
-This just does &#x27E8;<span
-class="cmti-10">locations</span>&#x27E9; and ignores the label.
-
-
-
-</p><!--l. 4608--><p class="indent" > The child entries have their name formatted according to:
-</p><!--l. 4609--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25039"></a> <span
-class="cmtt-10">\glslongextraSubNameFmt{</span>&#x27E8;<span
-class="cmitt-10">level</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4611--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">level</span>&#x27E9; is the hierarchical level. This defaults to: </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\glssubentryitem{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}\glstarget{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">\strut</span><span
-class="cmsy-10">}</span>
-</div>
-</div> This includes the sub-entry counter (if enabled) and the target but doesn&#8217;t show the
-name. The child description is formatted according to:
-<!--l. 4618--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25040"></a> <span
-class="cmtt-10">\glslongextraSubDescFmt{</span>&#x27E8;<span
-class="cmitt-10">level</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4620--><p class="noindent" >
-which defaults to just <span
-class="cmtt-10">\glslongextraDescFmt{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</p><!--l. 4623--><p class="indent" > The child symbol is formatted (where appropriate) according to:
-</p><!--l. 4624--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25041"></a> <span
-class="cmtt-10">\glslongextraSubSymbolFmt{</span>&#x27E8;<span
-class="cmitt-10">level</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4626--><p class="noindent" >
-This just does <span
-class="cmtt-10">\glslongextraSymbolFmt{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span>by default.
-</p><!--l. 4629--><p class="indent" > The styles that have a location list column format the list for child entries
-using:
-</p><!--l. 4631--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25042"></a> <span
-class="cmtt-10">\glslongextraSubLocationFmt</span>&#x27E8;<span
-class="cmitt-10">level</span>&#x27E9;<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">locations</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4633--><p class="noindent" >
-This just does &#x27E8;<span
-class="cmti-10">locations</span>&#x27E9; and ignores the level and label.
-</p><!--l. 4636--><p class="indent" > The letter group headings are formatted according to:
-</p><!--l. 4637--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-25043"></a> <span
-class="cmtt-10">\glslongextraGroupHeading{</span>&#x27E8;<span
-class="cmitt-10">n</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4639--><p class="noindent" >
-which does nothing by default. The first argument &#x27E8;<span
-class="cmti-10">n</span>&#x27E9; is the number of columns in the
-table. The second argument &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; is the group label (not the title, although they may
-happen to be the same).
-</p><!--l. 4645--><p class="indent" > This can be redefined to show the group heading. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-139">
-\renewcommand*{\glslongextraGroupHeading}[2]{%
-&#x00A0;&#x00A0;\glsxtrgetgrouptitle{#2}{\thisgrptitle}%
-&#x00A0;&#x00A0;\glslongextraHeaderFmt{\thisgrptitle}%
-&#x00A0;&#x00A0;\tabularnewline
-&#x00A0;&#x00A0;\noalign{\vskip\normalbaselineskip}%
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3623"></a><code class="code"><dfn id="glo:glsxtrpostfootnotelongformat"><code class="csfmt">\glsxtrpostfootnotelongformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is used for the <span class="qt">“postfootnote”</span> styles. This is simply defined to do <a id="wrglossary.3624"></a><a href="#glo:glsxtrfootnotelongformat"><code class="csfmt">\glsxtrfootnotelongformat</code></a>. Note that there’s no plural equivalent as the <span class="qt">“postfootnote”</span> styles don’t check if the plural command (<a id="wrglossary.3625"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> etc) was used.<p>
+
+</section><!-- end of section sec:abbrvcmdsfootnote -->
+
+<section id="sec:abbrvcmdsnolong"><!-- start of section sec:abbrvcmdsnolong --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.1.3.5. No-Long Styles<div class="labellink"><a href="#sec:abbrvcmdsnolong">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These commands are used by the <span class="qt">“nolong”</span> styles.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3626"></a><code class="code"><dfn id="glo:glsxtrshortnolongname"><code class="csfmt">\glsxtrshortnolongname</code></dfn></code></div><!-- end of pinnedbox -->
+ This command should expand to the value of the <a id="wrglossary.3627"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key for styles like <a id="wrglossary.3628"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a>. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3629"></a><a href="#glo:glsxpabbrvfont"><code class="csfmt">\glsxpabbrvfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3630"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a>}{<a id="wrglossary.3631"></a><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a>}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3632"></a><code class="code"><dfn id="glo:glsxtrshortdescname"><code class="csfmt">\glsxtrshortdescname</code></dfn></code></div><!-- end of pinnedbox -->
+ This command should expand to the value of the <a id="wrglossary.3633"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key for styles like <a id="wrglossary.3634"></a><a href="#glo:opt.abbrstyle.short-nolong-desc"><span class="abbrstylefmt">short-nolong-desc</span></a>. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3635"></a><a href="#glo:glsxpabbrvfont"><code class="csfmt">\glsxpabbrvfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3636"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a>}{<a id="wrglossary.3637"></a><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a>}%
+<code class="cmd">\protect</code><a id="wrglossary.3638"></a><a href="#glo:glsxtrfullsep"><code class="csfmt">\glsxtrfullsep</code></a>{<code class="cmd">\the</code><a id="wrglossary.3639"></a><a href="#glo:glslabeltok"><code class="csfmt">\glslabeltok</code></a>}%
+<code class="cmd">\protect</code><a id="wrglossary.3640"></a><a href="#glo:glsxtrparen"><code class="csfmt">\glsxtrparen</code></a>
+ {<a id="wrglossary.3641"></a><a href="#glo:glsxplongfont"><code class="csfmt">\glsxplongfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3642"></a><a href="#glo:glslongtok"><code class="csfmt">\glslongtok</code></a>}{<a id="wrglossary.3643"></a><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a>}}%
+</pre><p>
+
+</section><!-- end of section sec:abbrvcmdsnolong -->
+
+<section id="sec:abbrvcmdsnoshort"><!-- start of section sec:abbrvcmdsnoshort --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.1.3.6. No-Short Styles<div class="labellink"><a href="#sec:abbrvcmdsnoshort">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These commands are used by the <span class="qt">“noshort”</span> styles.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3644"></a><code class="code"><dfn id="glo:glsxtrlongnoshortdescname"><code class="csfmt">\glsxtrlongnoshortdescname</code></dfn></code></div><!-- end of pinnedbox -->
+ This command should expand to the value of the <a id="wrglossary.3645"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key for styles like <a id="wrglossary.3646"></a><a href="#glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></a>. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3647"></a><a href="#glo:glsxplongfont"><code class="csfmt">\glsxplongfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3648"></a><a href="#glo:glslongtok"><code class="csfmt">\glslongtok</code></a>}{<a id="wrglossary.3649"></a><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a>}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3650"></a><code class="code"><dfn id="glo:glsxtrlongnoshortname"><code class="csfmt">\glsxtrlongnoshortname</code></dfn></code></div><!-- end of pinnedbox -->
+ This command should expand to the value of the <a id="wrglossary.3651"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key for styles like <a id="wrglossary.3652"></a><a href="#glo:opt.abbrstyle.long-noshort"><span class="abbrstylefmt">long-noshort</span></a>. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3653"></a><a href="#glo:glsxpabbrvfont"><code class="csfmt">\glsxpabbrvfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3654"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a>}{<a id="wrglossary.3655"></a><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a>}
+</pre><p>
+
+</section><!-- end of section sec:abbrvcmdsnoshort -->
+
+<section id="sec:abbrvcmdshyphen"><!-- start of section sec:abbrvcmdshyphen --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.1.3.7. Hyphen Styles<div class="labellink"><a href="#sec:abbrvcmdshyphen">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These are commands used by the <span class="qt">“hyphen”</span> styles. They are designed to work with the <a id="wrglossary.3656"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a> and <a id="wrglossary.3657"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a> attributes.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3658"></a><code class="code"><dfn id="glo:glsabbrvhyphenfont"><code class="csfmt">\glsabbrvhyphenfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The formatting command used for the short form in the hyphen styles. The default is to simply use <a id="wrglossary.3659"></a><a href="#glo:glsabbrvdefaultfont"><code class="csfmt">\glsabbrvdefaultfont</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3660"></a><code class="code"><dfn id="glo:glsfirstabbrvhyphenfont"><code class="csfmt">\glsfirstabbrvhyphenfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The formatting command used for the short form in the hyphen styles on <a id="wrglossary.3661"></a><a href="#glo:dual.firstuse">first use</a>. The default is to simply use <a id="wrglossary.3662"></a><a href="#glo:glsabbrvhyphenfont"><code class="csfmt">\glsabbrvhyphenfont</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3663"></a><code class="code"><dfn id="glo:glslonghyphenfont"><code class="csfmt">\glslonghyphenfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The formatting command used for the long form in the hyphen styles. The default is to simply use <a id="wrglossary.3664"></a><a href="#glo:glslongdefaultfont"><code class="csfmt">\glslongdefaultfont</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3665"></a><code class="code"><dfn id="glo:glsfirstlonghyphenfont"><code class="csfmt">\glsfirstlonghyphenfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The formatting command used for the long form in the hyphen styles on <a id="wrglossary.3666"></a><a href="#glo:dual.firstuse">first use</a>. The default is to simply use <a id="wrglossary.3667"></a><a href="#glo:glslonghyphenfont"><code class="csfmt">\glslonghyphenfont</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3668"></a><code class="code"><dfn id="glo:glsxtrhyphensuffix"><code class="csfmt">\glsxtrhyphensuffix</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Short plural suffix used by the <span class="qt">“hyphen”</span> styles. This defaults to <a id="wrglossary.3669"></a><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3670"></a><code class="code"><dfn id="glo:glsxtrlonghyphenshortsort"><code class="csfmt">\glsxtrlonghyphenshortsort</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the sort value for the styles like <a id="wrglossary.3671"></a><a href="#glo:opt.abbrstyle.long-hyphen-short-hyphen"><span class="abbrstylefmt">long-hyphen-short-hyphen</span></a>. This defaults to the original short value (<a id="wrglossary.3672"></a><a href="#glo:glsxtrorgshort"><code class="csfmt">\glsxtrorgshort</code></a>). This command is irrelevant with the <a id="wrglossary.3673"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3674"></a><code class="code"><dfn id="glo:glsxtrshorthyphenlongsort"><code class="csfmt">\glsxtrshorthyphenlongsort</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the sort value for the styles like <a id="wrglossary.3675"></a><a href="#glo:opt.abbrstyle.short-hyphen-long-hyphen"><span class="abbrstylefmt">short-hyphen-long-hyphen</span></a>. This defaults to the original short value (<a id="wrglossary.3676"></a><a href="#glo:glsxtrorgshort"><code class="csfmt">\glsxtrorgshort</code></a>). This command is irrelevant with the <a id="wrglossary.3677"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3678"></a><code class="code"><dfn id="glo:glsxtrlonghyphennoshortsort"><code class="csfmt">\glsxtrlonghyphennoshortsort</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the sort value for the styles like <a id="wrglossary.3679"></a><a href="#glo:opt.abbrstyle.long-hyphen-noshort-noreg"><span class="abbrstylefmt">long-hyphen-noshort-noreg</span></a>. This defaults to the original short value (<a id="wrglossary.3680"></a><a href="#glo:glsxtrorgshort"><code class="csfmt">\glsxtrorgshort</code></a>). This command is irrelevant with the <a id="wrglossary.3681"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3682"></a><code class="code"><dfn id="glo:glsxtrlonghyphennoshortdescsort"><code class="csfmt">\glsxtrlonghyphennoshortdescsort</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the sort value for the styles like <a id="wrglossary.3683"></a><a href="#glo:opt.abbrstyle.long-hyphen-noshort-desc-noreg"><span class="abbrstylefmt">long-hyphen-noshort-desc-noreg</span></a>. This defaults to the original long value (<a id="wrglossary.3684"></a><a href="#glo:glsxtrorglong"><code class="csfmt">\glsxtrorglong</code></a>). This command is irrelevant with the <a id="wrglossary.3685"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3686"></a><code class="code"><dfn id="glo:glsxtrlonghyphenshort"><code class="csfmt">\glsxtrlonghyphenshort</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">long</em>〉</span>}{<span class="meta">〈<em class="metainner">short</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Formats the long and short form for the full or <a id="wrglossary.3687"></a><a href="#glo:dual.firstuse">first use</a> <a id="wrglossary.3688"></a><a href="#glo:opt.abbrstyle.long-hyphen-short-hyphen"><span class="abbrstylefmt">long-hyphen-short-hyphen</span></a> style. This uses <a id="wrglossary.3689"></a><a href="#glo:glsxtrifhyphenstart"><code class="csfmt">\glsxtrifhyphenstart</code></a> to test if the <span class="meta">〈<em class="metainner">insert</em>〉</span> starts with a hyphen. If it does, <a id="wrglossary.3690"></a><a href="#glo:glsxtrwordsep"><code class="csfmt">\glsxtrwordsep</code></a> is locally set to <a id="wrglossary.3691"></a><a href="#glo:glsxtrwordsephyphen"><code class="csfmt">\glsxtrwordsephyphen</code></a> to replace the inter-word spaces with hyphens. The short form is placed in parentheses with <a id="wrglossary.3692"></a><a href="#glo:glsxtrparen"><code class="csfmt">\glsxtrparen</code></a>, preceded by the <a id="wrglossary.3693"></a><a href="#glo:glsxtrfullsep"><code class="csfmt">\glsxtrfullsep</code></a> separator. The <span class="meta">〈<em class="metainner">insert</em>〉</span> is placed after both the long and the short form.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3694"></a><code class="code"><dfn id="glo:GLSxtrlonghyphenshort"><code class="csfmt">\GLSxtrlonghyphenshort</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">long</em>〉</span>}{<span class="meta">〈<em class="metainner">short</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but the <span class="meta">〈<em class="metainner">insert</em>〉</span> is converted to <a id="wrglossary.3695"></a><a href="#glo:idx.allcaps">all caps</a>. The <span class="meta">〈<em class="metainner">short</em>〉</span> and <span class="meta">〈<em class="metainner">long</em>〉</span> arguments should be supplied as <a id="wrglossary.3696"></a><a href="#glo:idx.allcaps">all caps</a>. Note that it’s not possible to simply do <a id="wrglossary.3697"></a><a href="#glo:glsxtrlonghyphenshort"><code class="csfmt">\glsxtrlonghyphenshort</code></a> with <code class="code"><a id="wrglossary.3698"></a><a href="#glo:MakeUppercase"><code class="csfmt">\MakeUppercase</code></a>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code> as the argument as this will interfere with the check to determine if <span class="meta">〈<em class="metainner">insert</em>〉</span> starts with a hyphen.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3699"></a><code class="code"><dfn id="glo:glsxtrlonghyphennoshort"><code class="csfmt">\glsxtrlonghyphennoshort</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">long</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Formats the long form for the full or <a id="wrglossary.3700"></a><a href="#glo:dual.firstuse">first use</a> <a id="wrglossary.3701"></a><a href="#glo:opt.abbrstyle.long-hyphen-noshort-desc-noreg"><span class="abbrstylefmt">long-hyphen-noshort-desc-noreg</span></a> style. This uses <a id="wrglossary.3702"></a><a href="#glo:glsxtrifhyphenstart"><code class="csfmt">\glsxtrifhyphenstart</code></a> to test if the <span class="meta">〈<em class="metainner">insert</em>〉</span> starts with a hyphen. If it does, <a id="wrglossary.3703"></a><a href="#glo:glsxtrwordsep"><code class="csfmt">\glsxtrwordsep</code></a> is locally set to <a id="wrglossary.3704"></a><a href="#glo:glsxtrwordsephyphen"><code class="csfmt">\glsxtrwordsephyphen</code></a> to replace the inter-word spaces with hyphens. The <span class="meta">〈<em class="metainner">insert</em>〉</span> is placed after the long form.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3705"></a><code class="code"><dfn id="glo:GLSxtrlonghyphennoshort"><code class="csfmt">\GLSxtrlonghyphennoshort</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">long</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but converts <span class="meta">〈<em class="metainner">insert</em>〉</span> to <a id="wrglossary.3706"></a><a href="#glo:idx.allcaps">all caps</a>. The <span class="meta">〈<em class="metainner">long</em>〉</span> argument should already be in <a id="wrglossary.3707"></a><a href="#glo:idx.allcaps">all caps</a>. Note that it’s not possible to simply do <a id="wrglossary.3708"></a><a href="#glo:glsxtrlonghyphennoshort"><code class="csfmt">\glsxtrlonghyphennoshort</code></a> with <code class="code"><a id="wrglossary.3709"></a><a href="#glo:MakeUppercase"><code class="csfmt">\MakeUppercase</code></a>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code> as the argument as this will interfere with the check to determine if <span class="meta">〈<em class="metainner">insert</em>〉</span> starts with a hyphen.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3710"></a><code class="code"><dfn id="glo:glsxtrlonghyphen"><code class="csfmt">\glsxtrlonghyphen</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">long</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Formats the long form for the full or <a id="wrglossary.3711"></a><a href="#glo:dual.firstuse">first use</a> <a id="wrglossary.3712"></a><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen"><span class="abbrstylefmt">long-hyphen-postshort-hyphen</span></a> style. This is similar to the above, but the <span class="meta">〈<em class="metainner">insert</em>〉</span> argument is only used to check if it starts with a hyphen. The actual <span class="meta">〈<em class="metainner">insert</em>〉</span> is placed in the <a id="wrglossary.3713"></a><a href="#glo:dual.postlinkhook">post-link hook</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3714"></a><code class="code"><dfn id="glo:xpglsxtrposthyphenshort"><code class="csfmt">\xpglsxtrposthyphenshort</code></dfn></code></div><!-- end of pinnedbox -->
+ This command is used in the <a id="wrglossary.3715"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the <a id="wrglossary.3716"></a><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen"><span class="abbrstylefmt">long-hyphen-postshort-hyphen</span></a> style on <a id="wrglossary.3717"></a><a href="#glo:dual.firstuse">first use</a>. It expands the placeholder commands (<a id="wrglossary.3718"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a> and <a id="wrglossary.3719"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a>) and uses <a id="wrglossary.3720"></a><a href="#glo:GLSxtrposthyphenshort"><code class="csfmt">\GLSxtrposthyphenshort</code></a> for <a id="wrglossary.3721"></a><a href="#glo:idx.allcaps">all caps</a> or <a id="wrglossary.3722"></a><a href="#glo:glsxtrposthyphenshort"><code class="csfmt">\glsxtrposthyphenshort</code></a> otherwise. Note that this doesn’t show the plural by default. If you require the plural form, you need to redefine this to add a check with <a id="wrglossary.3723"></a><a href="#glo:glsifplural"><code class="csfmt">\glsifplural</code></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.3724"></a><a href="#glo:xpglsxtrposthyphenshort"><code class="csfmt">\xpglsxtrposthyphenshort</code></a>}{%
+ <a id="wrglossary.3725"></a><a href="#glo:glsifplural"><code class="csfmt">\glsifplural</code></a>
+ {%
+ <a id="wrglossary.3726"></a><a href="#glo:glsxtrifallcaps"><code class="csfmt">\glsxtrifallcaps</code></a>
+ {%
+ <a id="wrglossary.3727"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a><a id="wrglossary.3728"></a><a href="#glo:GLSxtrposthyphenshortpl"><code class="csfmt">\GLSxtrposthyphenshortpl</code></a><a id="wrglossary.3729"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a><a id="wrglossary.3730"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>
+ <a id="wrglossary.3731"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a>{<a id="wrglossary.3732"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a>}%
+ }%
+ {%
+ <a id="wrglossary.3733"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a><a id="wrglossary.3734"></a><a href="#glo:glsxtrposthyphenshortpl"><code class="csfmt">\glsxtrposthyphenshortpl</code></a><a id="wrglossary.3735"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a><a id="wrglossary.3736"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>
+ <a id="wrglossary.3737"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a>{<a id="wrglossary.3738"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a>}%
+ }%
+ }%
+ {%
+ <a id="wrglossary.3739"></a><a href="#glo:glsxtrifallcaps"><code class="csfmt">\glsxtrifallcaps</code></a>
+ {%
+ <a id="wrglossary.3740"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a><a id="wrglossary.3741"></a><a href="#glo:GLSxtrposthyphenshort"><code class="csfmt">\GLSxtrposthyphenshort</code></a><a id="wrglossary.3742"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a><a id="wrglossary.3743"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>
+ <a id="wrglossary.3744"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a>{<a id="wrglossary.3745"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a>}%
+ }%
+ {%
+ <a id="wrglossary.3746"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a><a id="wrglossary.3747"></a><a href="#glo:glsxtrposthyphenshort"><code class="csfmt">\glsxtrposthyphenshort</code></a><a id="wrglossary.3748"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a><a id="wrglossary.3749"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>
+ <a id="wrglossary.3750"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a>{<a id="wrglossary.3751"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a>}%
+ }%
+ }%
}
-</pre>
-<!--l. 4653--><p class="nopar" > This ignores the first argument and just puts the group title in the first column
-formatted according to <span
-class="cmtt-10">\glslongextraHeaderFmt </span>(to match the column
-header).
-</p><!--l. 4658--><p class="indent" > Remember that you can also adjust the styles through category attributes. The
-name column&#8217;s title is given by <span
-class="cmtt-10">\entryname</span>, the description column&#8217;s title is given by
-<span
-class="cmtt-10">\descriptionname </span>and (where present) the symbol column&#8217;s title is given by
-<span
-class="cmtt-10">\symbolname</span>, as for the other long styles that have headers.
- </p><dl class="description"><dt class="description">
- </dt><dd
-class="description"><span
-class="cmss-10">long-name-desc</span><a
- id="dx1-25044"></a> This is like the <span
-class="cmss-10">longragged-booktabs</span><a
- id="dx1-25045"></a> style but doesn&#8217;t show the
- location list (regardless of the <a
-href="#styopt.nonumberlist"><span
-class="cmss-10">nonumberlist</span></a><a
- id="dx1-25046"></a> option). The name is shown in
- the first column and the description in the second.
- <!--l. 4671--><p class="noindent" >The symbol is not displayed. The header row is produced with:
- </p><!--l. 4673--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25047"></a> <span
-class="cmtt-10">\glslongextraNameDescHeader </span></div><hr>
- </p><!--l. 4675--><p class="noindent" >
- This essentially uses the same code as for <span
-class="cmss-10">longragged-booktabs</span><a
- id="dx1-25048"></a> but makes it
- easier to adjust the header without having to define a new style. This is defined
- as:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-140">
- \glslongextraNameDescTabularHeader\endhead
- \glslongextraNameDescTabularFooter\endfoot
-</pre>
- <!--l. 4682--><p class="nopar" > where:
- </p><!--l. 4684--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25049"></a> <span
-class="cmtt-10">\glslongextraNameDescTabularHeader </span></div><hr>
- </p><!--l. 4686--><p class="noindent" >
- sets up the header and
- </p><!--l. 4688--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25050"></a> <span
-class="cmtt-10">\glslongextraNameDescTabularFooter </span></div><hr>
- </p><!--l. 4690--><p class="noindent" >
- sets up the footer. If you have setup the <span
-class="cmss-10">tabular</span><a
- id="dx1-25051"></a><a
- id="dx1-25052"></a> version of this style then the
- above two commands are used at the start and end of the <span
-class="cmss-10">tabular</span><a
- id="dx1-25053"></a><a
- id="dx1-25054"></a> environment
- (and <span
-class="cmtt-10">\glslongextraNameDescHeader </span>isn&#8217;t used).
- </p><!--l. 4696--><p class="noindent" >For example, to simply remove the header and footer (for the default <span
-class="cmss-10">longtable</span><a
- id="dx1-25055"></a><a
- id="dx1-25056"></a>
- version of the style):
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-141">
- \renewcommand{\glslongextraNameDescHeader}{}
-</pre>
- <!--l. 4700--><p class="nopar" > Or to change the name alignment to centred:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-142">
- \renewcommand{\glslongextraNameAlign}{c}
-</pre>
- <!--l. 4704--><p class="nopar" >
- </p></dd><dt class="description">
- </dt><dd
-class="description"><span
-class="cmss-10">long-name-desc-loc</span><a
- id="dx1-25057"></a> This is like the <span
-class="cmss-10">long-name-desc</span><a
- id="dx1-25058"></a> style but has a third column for
- the location list. The <span
-class="cmss-10">longtable</span><a
- id="dx1-25059"></a><a
- id="dx1-25060"></a> header is given by:
- <!--l. 4709--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25061"></a> <span
-class="cmtt-10">\glslongextraNameDescLocationHeader </span></div><hr>
- </p><!--l. 4711--><p class="noindent" >
- which similarly defined in terms of the commands used for the <span
-class="cmss-10">tabular</span><a
- id="dx1-25062"></a><a
- id="dx1-25063"></a>
- version:
- </p><!--l. 4714--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25064"></a> <span
-class="cmtt-10">\glslongextraNameDescLocationTabularHeader </span></div><hr>
- </p><!--l. 4716--><p class="noindent" >
- and
- </p><!--l. 4718--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25065"></a> <span
-class="cmtt-10">\glslongextraNameDescLocationTabularFooter </span></div><hr>
- </p><!--l. 4720--><p class="noindent" >
- </p></dd><dt class="description">
- </dt><dd
-class="description"><span
-class="cmss-10">long-desc-name</span><a
- id="dx1-25066"></a> This is like the <span
-class="cmss-10">long-name-desc</span><a
- id="dx1-25067"></a> style but swaps the columns. Note
- that if the entry counter is displayed it will appear at the start of the
- second column by default. The <span
-class="cmss-10">longtable</span><a
- id="dx1-25068"></a><a
- id="dx1-25069"></a> header is formatted according
- to:
- <!--l. 4727--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25070"></a> <span
-class="cmtt-10">\glslongextraDescNameHeader </span></div><hr>
- </p><!--l. 4729--><p class="noindent" >
- which similarly defined in terms of the commands used for the <span
-class="cmss-10">tabular</span><a
- id="dx1-25071"></a><a
- id="dx1-25072"></a>
- version:
- </p><!--l. 4732--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25073"></a> <span
-class="cmtt-10">\glslongextraDescNameTabularHeader </span></div><hr>
- </p><!--l. 4734--><p class="noindent" >
- and
- </p><!--l. 4736--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25074"></a> <span
-class="cmtt-10">\glslongextraDescNameTabularFooter </span></div><hr>
- </p><!--l. 4738--><p class="noindent" >
- </p></dd><dt class="description">
- </dt><dd
-class="description"><span
-class="cmss-10">long-loc-desc-name</span><a
- id="dx1-25075"></a> This has three columns containing the location list,
- description and name. The <span
-class="cmss-10">longtable</span><a
- id="dx1-25076"></a><a
- id="dx1-25077"></a> header is formatted according
- to:
-
-
-
- <!--l. 4744--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25078"></a> <span
-class="cmtt-10">\glslongextraLocationDescNameHeader </span></div><hr>
- </p><!--l. 4746--><p class="noindent" >
- which similarly defined in terms of the commands used for the <span
-class="cmss-10">tabular</span><a
- id="dx1-25079"></a><a
- id="dx1-25080"></a>
- version:
- </p><!--l. 4749--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25081"></a> <span
-class="cmtt-10">\glslongextraLocationDescNameTabularHeader </span></div><hr>
- </p><!--l. 4751--><p class="noindent" >
- and
- </p><!--l. 4753--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25082"></a> <span
-class="cmtt-10">\glslongextraLocationDescNameTabularFooter </span></div><hr>
- </p><!--l. 4755--><p class="noindent" >
- </p></dd><dt class="description">
- </dt><dd
-class="description"><span
-class="cmss-10">long-name-desc-sym</span><a
- id="dx1-25083"></a> This is has three columns, with the name in the first, the
- description in the second and the symbol in the third.
- <!--l. 4761--><p class="noindent" >The <span
-class="cmss-10">longtable</span><a
- id="dx1-25084"></a><a
- id="dx1-25085"></a> header row is produced with:
- </p><!--l. 4762--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25086"></a> <span
-class="cmtt-10">\glslongextraNameDescSymHeader </span></div><hr>
- </p><!--l. 4764--><p class="noindent" >
- which similarly defined in terms of the commands used for the <span
-class="cmss-10">tabular</span><a
- id="dx1-25087"></a><a
- id="dx1-25088"></a>
- version:
- </p><!--l. 4767--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25089"></a> <span
-class="cmtt-10">\glslongextraNameDescSymTabularHeader </span></div><hr>
- </p><!--l. 4769--><p class="noindent" >
- and
- </p><!--l. 4771--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25090"></a> <span
-class="cmtt-10">\glslongextraNameDescSymTabularFooter </span></div><hr>
- </p><!--l. 4773--><p class="noindent" >
- </p></dd><dt class="description">
- </dt><dd
-class="description"><span
-class="cmss-10">long-name-desc-sym-loc</span><a
- id="dx1-25091"></a> This is has four columns, with the name in the first, the
- description in the second, the symbol in the third and the location list in the
- fourth.
- <!--l. 4779--><p class="noindent" >The <span
-class="cmss-10">longtable</span><a
- id="dx1-25092"></a><a
- id="dx1-25093"></a> header row is produced with:
- </p><!--l. 4780--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25094"></a> <span
-class="cmtt-10">\glslongextraNameDescSymLocationHeader </span></div><hr>
- </p><!--l. 4782--><p class="noindent" >
- which similarly defined in terms of the commands used for the <span
-class="cmss-10">tabular</span><a
- id="dx1-25095"></a><a
- id="dx1-25096"></a>
- version:
- </p><!--l. 4785--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25097"></a> <span
-class="cmtt-10">\glslongextraNameDescSymLocationTabularHeader </span></div><hr>
- </p><!--l. 4787--><p class="noindent" >
- and
- </p><!--l. 4789--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25098"></a> <span
-class="cmtt-10">\glslongextraNameDescSymLocationTabularFooter </span></div><hr>
- </p><!--l. 4791--><p class="noindent" >
-
-
-
- </p></dd><dt class="description">
- </dt><dd
-class="description"><span
-class="cmss-10">long-name-sym-desc</span><a
- id="dx1-25099"></a> This is like the <span
-class="cmss-10">long-name-desc-sym</span><a
- id="dx1-25100"></a> but the second and third
- column are swapped. The <span
-class="cmss-10">longtable</span><a
- id="dx1-25101"></a><a
- id="dx1-25102"></a> header row is given by:
- <!--l. 4796--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25103"></a> <span
-class="cmtt-10">\glslongextraNameSymDescHeader </span></div><hr>
- </p><!--l. 4798--><p class="noindent" >
- which similarly defined in terms of the commands used for the <span
-class="cmss-10">tabular</span><a
- id="dx1-25104"></a><a
- id="dx1-25105"></a>
- version:
- </p><!--l. 4801--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25106"></a> <span
-class="cmtt-10">\glslongextraNameSymDescTabularHeader </span></div><hr>
- </p><!--l. 4803--><p class="noindent" >
- and
- </p><!--l. 4805--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25107"></a> <span
-class="cmtt-10">\glslongextraNameSymDescTabularFooter </span></div><hr>
- </p><!--l. 4807--><p class="noindent" >
- </p></dd><dt class="description">
- </dt><dd
-class="description"><span
-class="cmss-10">long-name-sym-desc-loc</span><a
- id="dx1-25108"></a> This is like the <span
-class="cmss-10">long-name-desc-sym-loc</span><a
- id="dx1-25109"></a> but the second and
- third column are swapped. The <span
-class="cmss-10">longtable</span><a
- id="dx1-25110"></a><a
- id="dx1-25111"></a> header row is given by:
- <!--l. 4812--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25112"></a> <span
-class="cmtt-10">\glslongextraNameSymDescLocationHeader </span></div><hr>
- </p><!--l. 4814--><p class="noindent" >
- which similarly defined in terms of the commands used for the <span
-class="cmss-10">tabular</span><a
- id="dx1-25113"></a><a
- id="dx1-25114"></a>
- version:
- </p><!--l. 4817--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25115"></a> <span
-class="cmtt-10">\glslongextraNameSymDescLocationTabularHeader </span></div><hr>
- </p><!--l. 4819--><p class="noindent" >
- and
- </p><!--l. 4821--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25116"></a> <span
-class="cmtt-10">\glslongextraNameSymDescLocationTabularFooter </span></div><hr>
- </p><!--l. 4823--><p class="noindent" >
- </p></dd><dt class="description">
- </dt><dd
-class="description"><span
-class="cmss-10">long-sym-desc-name</span><a
- id="dx1-25117"></a> This has the symbol in the first column, the description in the
- second and the name in the third. The <span
-class="cmss-10">longtable</span><a
- id="dx1-25118"></a><a
- id="dx1-25119"></a> header row is given
- by:
- <!--l. 4828--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25120"></a> <span
-class="cmtt-10">\glslongextraSymDescNameHeader </span></div><hr>
- </p><!--l. 4830--><p class="noindent" >
- which similarly defined in terms of the commands used for the <span
-class="cmss-10">tabular</span><a
- id="dx1-25121"></a><a
- id="dx1-25122"></a>
- version:
- </p><!--l. 4833--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25123"></a> <span
-class="cmtt-10">\glslongextraSymDescNameTabularHeader </span></div><hr>
- </p><!--l. 4835--><p class="noindent" >
- and
- </p><!--l. 4837--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25124"></a> <span
-class="cmtt-10">\glslongextraSymDescNameTabularFooter </span></div><hr>
- </p><!--l. 4839--><p class="noindent" >
-
-
-
- </p></dd><dt class="description">
- </dt><dd
-class="description"><span
-class="cmss-10">long-loc-sym-desc-name</span><a
- id="dx1-25125"></a> This has the location list in the first column, symbol in the
- second column, the description in the third and the name in the fourth. The
- <span
-class="cmss-10">longtable</span><a
- id="dx1-25126"></a><a
- id="dx1-25127"></a> header row is given by:
- <!--l. 4845--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25128"></a> <span
-class="cmtt-10">\glslongextraLocationSymDescNameHeader </span></div><hr>
- </p><!--l. 4847--><p class="noindent" >
- which similarly defined in terms of the commands used for the <span
-class="cmss-10">tabular</span><a
- id="dx1-25129"></a><a
- id="dx1-25130"></a>
- version:
- </p><!--l. 4850--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25131"></a> <span
-class="cmtt-10">\glslongextraLocationSymDescNameTabularHeader </span></div><hr>
- </p><!--l. 4852--><p class="noindent" >
- and
- </p><!--l. 4854--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25132"></a> <span
-class="cmtt-10">\glslongextraLocationSymDescNameTabularFooter </span></div><hr>
- </p><!--l. 4856--><p class="noindent" >
- </p></dd><dt class="description">
- </dt><dd
-class="description"><span
-class="cmss-10">long-desc-sym-name</span><a
- id="dx1-25133"></a> This has the description in the first column, the symbol in the
- second and the name in the third. The <span
-class="cmss-10">longtable</span><a
- id="dx1-25134"></a><a
- id="dx1-25135"></a> header row is given
- by:
- <!--l. 4861--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25136"></a> <span
-class="cmtt-10">\glslongextraDescSymNameHeader </span></div><hr>
- </p><!--l. 4863--><p class="noindent" >
- which similarly defined in terms of the commands used for the <span
-class="cmss-10">tabular</span><a
- id="dx1-25137"></a><a
- id="dx1-25138"></a>
- version:
- </p><!--l. 4866--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25139"></a> <span
-class="cmtt-10">\glslongextraDescSymNameTabularHeader </span></div><hr>
- </p><!--l. 4868--><p class="noindent" >
- and
- </p><!--l. 4870--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25140"></a> <span
-class="cmtt-10">\glslongextraDescSymNameTabularFooter </span></div><hr>
- </p><!--l. 4872--><p class="noindent" >
- </p></dd><dt class="description">
- </dt><dd
-class="description"><span
-class="cmss-10">long-loc-desc-sym-name</span><a
- id="dx1-25141"></a> This has the location list in the first column, the description
- in the second column, the symbol in the third and the name in the fourth. The
- <span
-class="cmss-10">longtable</span><a
- id="dx1-25142"></a><a
- id="dx1-25143"></a> header row is given by:
- <!--l. 4878--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25144"></a> <span
-class="cmtt-10">\glslongextraLocationDescSymNameHeader </span></div><hr>
- </p><!--l. 4880--><p class="noindent" >
- which similarly defined in terms of the commands used for the <span
-class="cmss-10">tabular</span><a
- id="dx1-25145"></a><a
- id="dx1-25146"></a>
- version:
- </p><!--l. 4883--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25147"></a> <span
-class="cmtt-10">\glslongextraLocationDescSymNameTabularHeader </span></div><hr>
- </p><!--l. 4885--><p class="noindent" >
- and
-
-
-
- </p><!--l. 4887--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-25148"></a> <span
-class="cmtt-10">\glslongextraLocationDescSymNameTabularFooter </span></div><hr>
- </p><!--l. 4889--><p class="noindent" >
-</p>
- </dd></dl>
-<!--l. 4893--><p class="noindent" >
-</p>
-<!--l. 4893--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">3.3 </span> <a
- id="sec:topic"></a>glossary-topic package</h3>
-<!--l. 4896--><p class="noindent" >As from version 1.40, the <span
-class="cmss-10">glossaries-extra </span>package comes with the supplementary
-package <span
-class="cmss-10">glossary-topic</span><a
- id="dx1-26001"></a> that provides glossary styles designed for hierarchical glossaries
-where the top-level entries are topic titles. This package automatically loads the
-<span
-class="cmss-10">multicols</span><a
- id="dx1-26002"></a> package. If the <span
-class="cmss-10">glossary-tree</span><a
- id="dx1-26003"></a> package is also loaded then commands like
-<span
-class="cmtt-10">\glssetwidest </span>can be used on these styles in much the same way as for the <span
-class="cmss-10">alttree</span><a
- id="dx1-26004"></a>
-style. If a widest value isn&#8217;t set then these styles behave more like the <span
-class="cmss-10">tree</span><a
- id="dx1-26005"></a>
-style.
- </p><dl class="description"><dt class="description">
-<span
-class="cmssbx-10">topic</span><a
- id="dx1-26006"></a> </dt><dd
-class="description">This style is similar to the <span
-class="cmss-10">tree</span><a
- id="dx1-26007"></a> style but the indentation doesn&#8217;t start until
- the second sub-item level. The top-level entries have the name displayed
- in a larger font with the description following in a new paragraph. This
- style doesn&#8217;t support the <a
-href="#styopt.nogroupskip"><span
-class="cmss-10">nogroupskip</span></a><a
- id="dx1-26008"></a> setting.
- </dd><dt class="description">
-<span
-class="cmssbx-10">topicmcols</span><a
- id="dx1-26009"></a> </dt><dd
-class="description">This style is like the <span
-class="cmss-10">topic</span><a
- id="dx1-26010"></a> style but the sub-entries are placed inside a
- <span
-class="cmss-10">multicols</span><a
- id="dx1-26011"></a><a
- id="dx1-26012"></a> environment. The environment name is supplied in the value of the
- command:
- <!--l. 4916--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-26013"></a> <span
-class="cmtt-10">\glstopicColsEnv </span></div><hr>
- </p><!--l. 4918--><p class="noindent" >
- You can change this to the starred form. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-143">
- \renewcommand{\glstopicColsEnv}{multicols*}
-</pre>
- <!--l. 4922--><p class="nopar" > The number of columns is given by the command:
- </p><!--l. 4924--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-26014"></a> <span
-class="cmtt-10">\glstopicCols </span></div><hr>
- </p><!--l. 4926--><p class="noindent" >
- The default value is 2.</p></dd></dl>
-<!--l. 4929--><p class="noindent" >Both styles use the following commands.
-</p><!--l. 4930--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-26015"></a> <span
-class="cmtt-10">\glstopicParIndent </span></div><hr>
-</p><!--l. 4932--><p class="noindent" >
-This command is a length that&#8217;s used for the paragraph indentation in any
-multi-paragraph description for top-level entries, but not for the first paragraph (at
-the start of the description) which isn&#8217;t indented.
-</p><!--l. 4938--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-26016"></a> <span
-class="cmtt-10">\glstopicSubIndent </span></div><hr>
-</p><!--l. 4940--><p class="noindent" >
-This command is a length that&#8217;s used to calculate the hanging indentation for
-sub-entries. The level&#x00A0;1 sub-entries don&#8217;t indent the name. Level&#x00A0;<span
-class="cmmi-10">n </span>sub-entries have
-the name indented by (<span
-class="cmmi-10">n</span><span
-class="cmsy-10">- </span>1)<span
-class="cmsy-10">&#x00D7;</span><span
-class="cmtt-10">\glstopicSubIndent</span>. The hanging indent depends on
-whether or not a widest name has been set for the level.
-</p><!--l. 4947--><p class="indent" > As from v1.46, there is also a length for additional indentation used
-in the second paragraph onwards for child entries with multi-paragraph
-descriptions:
-</p><!--l. 4950--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-26017"></a> <span
-class="cmtt-10">\glstopicSubItemParIndent </span></div><hr>
-</p><!--l. 4952--><p class="noindent" >
-This is initialised to <span
-class="cmtt-10">\parindent</span><a
- id="dx1-26018"></a> when <span
-class="cmss-10">glossary-topic</span><a
- id="dx1-26019"></a> is loaded.
-</p><!--l. 4956--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-26020"></a> <span
-class="cmtt-10">\glstopicInit </span></div><hr>
-</p><!--l. 4958--><p class="noindent" >
-Hook used at the start of the glossary. Does nothing by default.
-</p><!--l. 4961--><p class="indent" > Although the styles don&#8217;t support letter groups by default, if you have many
-topics (top-level entries) and you feel that it would help the reader to divide them up
-into headed letter groups, you can redefine:
-</p><!--l. 4965--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-26021"></a> <span
-class="cmtt-10">\glstopicGroupHeading{</span>&#x27E8;<span
-class="cmitt-10">group label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4967--><p class="noindent" >
-This does nothing by default. If you want to redefine it, you can fetch the
-title corresponding to the group label with <span
-class="cmtt-10">\glsxtrgetgrouptitle</span>. For
-example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-144">
-\renewcommand*{\glstopicGroupHeading}[1]{%
-&#x00A0;&#x00A0;\glsxtrgetgrouptitle{#1}{\thisgrptitle}%
-&#x00A0;&#x00A0;\section*{\thisgrptitle}%
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3752"></a><code class="code"><dfn id="glo:glsxtrposthyphenshort"><code class="csfmt">\glsxtrposthyphenshort</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If <span class="meta">〈<em class="metainner">insert</em>〉</span> starts with a hyphen, <a id="wrglossary.3753"></a><a href="#glo:glsxtrwordsep"><code class="csfmt">\glsxtrwordsep</code></a> is locally set to <a id="wrglossary.3754"></a><a href="#glo:glsxtrwordsephyphen"><code class="csfmt">\glsxtrwordsephyphen</code></a> to replace the inter-word spaces with hyphens. The <span class="meta">〈<em class="metainner">insert</em>〉</span> encapsulated with <a id="wrglossary.3755"></a><a href="#glo:glsfirstlonghyphenfont"><code class="csfmt">\glsfirstlonghyphenfont</code></a> is then done (to complete the long form, which has already been displayed with <a id="wrglossary.3756"></a><a href="#glo:glsxtrlonghyphen"><code class="csfmt">\glsxtrlonghyphen</code></a> in the <a id="wrglossary.3757"></a><a href="#glo:dual.linktext">link text</a>). Then the short form followed by the <span class="meta">〈<em class="metainner">insert</em>〉</span> is placed in parentheses (with <a id="wrglossary.3758"></a><a href="#glo:glsxtrparen"><code class="csfmt">\glsxtrparen</code></a> preceded by <a id="wrglossary.3759"></a><a href="#glo:glsxtrfullsep"><code class="csfmt">\glsxtrfullsep</code></a>).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3760"></a><code class="code"><dfn id="glo:GLSxtrposthyphenshort"><code class="csfmt">\GLSxtrposthyphenshort</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.3761"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3762"></a><code class="code"><dfn id="glo:glsxtrposthyphenshortpl"><code class="csfmt">\glsxtrposthyphenshortpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.3763"></a><a href="#glo:glsxtrposthyphenshort"><code class="csfmt">\glsxtrposthyphenshort</code></a> but plural.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3764"></a><code class="code"><dfn id="glo:GLSxtrposthyphenshortpl"><code class="csfmt">\GLSxtrposthyphenshortpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.3765"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3766"></a><code class="code"><dfn id="glo:xpglsxtrposthyphensubsequent"><code class="csfmt">\xpglsxtrposthyphensubsequent</code></dfn></code></div><!-- end of pinnedbox -->
+ This command is used in the <a id="wrglossary.3767"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the <a id="wrglossary.3768"></a><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen"><span class="abbrstylefmt">long-hyphen-postshort-hyphen</span></a> style on <a id="wrglossary.3769"></a><a href="#glo:dual.subsequentuse">subsequent use</a>. It expands the placeholder commands (<a id="wrglossary.3770"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a> and <a id="wrglossary.3771"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a>) and uses <a id="wrglossary.3772"></a><a href="#glo:GLSxtrposthyphensubsequent"><code class="csfmt">\GLSxtrposthyphensubsequent</code></a> for <a id="wrglossary.3773"></a><a href="#glo:idx.allcaps">all caps</a> or <a id="wrglossary.3774"></a><a href="#glo:glsxtrposthyphensubsequent"><code class="csfmt">\glsxtrposthyphensubsequent</code></a> otherwise.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3775"></a><code class="code"><dfn id="glo:glsxtrposthyphensubsequent"><code class="csfmt">\glsxtrposthyphensubsequent</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is used in the <a id="wrglossary.3776"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the <a id="wrglossary.3777"></a><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen"><span class="abbrstylefmt">long-hyphen-postshort-hyphen</span></a> style on <a id="wrglossary.3778"></a><a href="#glo:dual.subsequentuse">subsequent use</a>. Only the <span class="meta">〈<em class="metainner">insert</em>〉</span> is done.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3779"></a><code class="code"><dfn id="glo:GLSxtrposthyphensubsequent"><code class="csfmt">\GLSxtrposthyphensubsequent</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.3780"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3781"></a><code class="code"><dfn id="glo:glsxtrshorthyphenlong"><code class="csfmt">\glsxtrshorthyphenlong</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">short</em>〉</span>}{<span class="meta">〈<em class="metainner">long</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Formats the short and long form for the full or <a id="wrglossary.3782"></a><a href="#glo:dual.firstuse">first use</a> <a id="wrglossary.3783"></a><a href="#glo:opt.abbrstyle.short-hyphen-long-hyphen"><span class="abbrstylefmt">short-hyphen-long-hyphen</span></a> style. Similar to <a id="wrglossary.3784"></a><a href="#glo:glsxtrlonghyphenshort"><code class="csfmt">\glsxtrlonghyphenshort</code></a> but the short and long forms are swapped.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3785"></a><code class="code"><dfn id="glo:GLSxtrshorthyphenlong"><code class="csfmt">\GLSxtrshorthyphenlong</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">short</em>〉</span>}{<span class="meta">〈<em class="metainner">long</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but the <span class="meta">〈<em class="metainner">insert</em>〉</span> is converted to <a id="wrglossary.3786"></a><a href="#glo:idx.allcaps">all caps</a>. The <span class="meta">〈<em class="metainner">short</em>〉</span> and <span class="meta">〈<em class="metainner">long</em>〉</span> arguments should be supplied as <a id="wrglossary.3787"></a><a href="#glo:idx.allcaps">all caps</a>. Note that it’s not possible to simply do <a id="wrglossary.3788"></a><a href="#glo:glsxtrshorthyphenlong"><code class="csfmt">\glsxtrshorthyphenlong</code></a> with <code class="code"><a id="wrglossary.3789"></a><a href="#glo:MakeUppercase"><code class="csfmt">\MakeUppercase</code></a>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code> as the argument as this will interfere with the check to determine if <span class="meta">〈<em class="metainner">insert</em>〉</span> starts with a hyphen.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3790"></a><code class="code"><dfn id="glo:glsxtrshorthyphen"><code class="csfmt">\glsxtrshorthyphen</code></dfn>{<span class="meta">〈<em class="metainner">short</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Formats the short form for the full or <a id="wrglossary.3791"></a><a href="#glo:dual.firstuse">first use</a> <a id="wrglossary.3792"></a><a href="#glo:opt.abbrstyle.short-hyphen-postlong-hyphen"><span class="abbrstylefmt">short-hyphen-postlong-hyphen</span></a> style. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument is only used to check if it starts with a hyphen. The actual <span class="meta">〈<em class="metainner">insert</em>〉</span> is placed in the <a id="wrglossary.3793"></a><a href="#glo:dual.postlinkhook">post-link hook</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3794"></a><code class="code"><dfn id="glo:xpglsxtrposthyphenlong"><code class="csfmt">\xpglsxtrposthyphenlong</code></dfn></code></div><!-- end of pinnedbox -->
+ This command is used in the <a id="wrglossary.3795"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the <a id="wrglossary.3796"></a><a href="#glo:opt.abbrstyle.short-hyphen-postlong-hyphen"><span class="abbrstylefmt">short-hyphen-postlong-hyphen</span></a> style on <a id="wrglossary.3797"></a><a href="#glo:dual.firstuse">first use</a>. It expands the placeholder commands (<a id="wrglossary.3798"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a> and <a id="wrglossary.3799"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a>) and uses <a id="wrglossary.3800"></a><a href="#glo:GLSxtrposthyphenlong"><code class="csfmt">\GLSxtrposthyphenlong</code></a> for <a id="wrglossary.3801"></a><a href="#glo:idx.allcaps">all caps</a> or <a id="wrglossary.3802"></a><a href="#glo:glsxtrposthyphenlong"><code class="csfmt">\glsxtrposthyphenlong</code></a> otherwise. Note that this doesn’t show the plural by default. If you require the plural form, you need to redefine this to add a check with <a id="wrglossary.3803"></a><a href="#glo:glsifplural"><code class="csfmt">\glsifplural</code></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.3804"></a><a href="#glo:xpglsxtrposthyphenlong"><code class="csfmt">\xpglsxtrposthyphenlong</code></a>}{%
+ <a id="wrglossary.3805"></a><a href="#glo:glsifplural"><code class="csfmt">\glsifplural</code></a>
+ {%
+ <a id="wrglossary.3806"></a><a href="#glo:glsxtrifallcaps"><code class="csfmt">\glsxtrifallcaps</code></a>
+ {%
+ <a id="wrglossary.3807"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a><a id="wrglossary.3808"></a><a href="#glo:GLSxtrposthyphenlongpl"><code class="csfmt">\GLSxtrposthyphenlongpl</code></a><a id="wrglossary.3809"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a><a id="wrglossary.3810"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>
+ <a id="wrglossary.3811"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a>{<a id="wrglossary.3812"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a>}%
+ }%
+ {%
+ <a id="wrglossary.3813"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a><a id="wrglossary.3814"></a><a href="#glo:glsxtrposthyphenlongpl"><code class="csfmt">\glsxtrposthyphenlongpl</code></a><a id="wrglossary.3815"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a><a id="wrglossary.3816"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>
+ <a id="wrglossary.3817"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a>{<a id="wrglossary.3818"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a>}%
+ }%
+ }%
+ {%
+ <a id="wrglossary.3819"></a><a href="#glo:glsxtrifallcaps"><code class="csfmt">\glsxtrifallcaps</code></a>
+ {%
+ <a id="wrglossary.3820"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a><a id="wrglossary.3821"></a><a href="#glo:GLSxtrposthyphenlong"><code class="csfmt">\GLSxtrposthyphenlong</code></a><a id="wrglossary.3822"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a><a id="wrglossary.3823"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>
+ <a id="wrglossary.3824"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a>{<a id="wrglossary.3825"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a>}%
+ }%
+ {%
+ <a id="wrglossary.3826"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a><a id="wrglossary.3827"></a><a href="#glo:glsxtrposthyphenlong"><code class="csfmt">\glsxtrposthyphenlong</code></a><a id="wrglossary.3828"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a><a id="wrglossary.3829"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>
+ <a id="wrglossary.3830"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a>{<a id="wrglossary.3831"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a>}%
+ }%
+ }%
}
-</pre>
-<!--l. 4976--><p class="nopar" > Remember that if you use <a
- id="dx1-26022"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a>, you will need the <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">--group</span></span></span> (or <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">-g</span></span></span>) switch to
-support this.
-</p><!--l. 4980--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-26023"></a> <span
-class="cmtt-10">\glstopicItem{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location list</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4982--><p class="noindent" >
-Used to format the name, symbol, description and location list for the top-level
-entries. This starts with a paragraph break followed by:
-</p><!--l. 4986--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-26024"></a> <span
-class="cmtt-10">\glstopicPreSkip </span></div><hr>
-</p><!--l. 4988--><p class="noindent" >
-which defaults to <span
-class="cmtt-10">\medskip</span>. There is then a hook:
-</p><!--l. 4990--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-26025"></a> <span
-class="cmtt-10">\glstopicMarker{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4992--><p class="noindent" >
-which does nothing by default, but may be redefined. For example, to add a line to
-the table of contents. The name and symbol are set in the form of a title
-using:
-</p><!--l. 4997--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-26026"></a> <span
-class="cmtt-10">\glstopicTitle{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 4999--><p class="noindent" >
-This uses <span
-class="cmtt-10">\Glossentryname </span>which converts the first letter to upper case. If there&#8217;s a
-symbol, this is added in parentheses. Both name and symbol (if present) are
-encapsulated by
-</p><!--l. 5003--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-26027"></a> <span
-class="cmtt-10">\glstopicTitleFont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5005--><p class="noindent" >
-This uses a bold, large font by default.
-</p><!--l. 5008--><p class="indent" > If the entry has the description key set (tested with <span
-class="cmtt-10">\ifglshasdesc</span>) then a
-paragraph break is inserted followed by:
-</p><!--l. 5010--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-26028"></a> <span
-class="cmtt-10">\glstopicMidSkip </span></div><hr>
-</p><!--l. 5012--><p class="noindent" >
-which defaults to <span
-class="cmtt-10">\smallskip</span>. This is followed by the description which is formatted
-according to:
-</p><!--l. 5015--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-26029"></a> <span
-class="cmtt-10">\glstopicDesc{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5017--><p class="noindent" >
-This just does <span
-class="cmtt-10">\Glossentrydesc{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span>followed by the post-description
-hook.
-</p><!--l. 5021--><p class="indent" > A paragraph break followed by:
-</p><!--l. 5022--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-26030"></a> <span
-class="cmtt-10">\glstopicPostSkip </span></div><hr>
-</p><!--l. 5024--><p class="noindent" >
-comes next regardless of whether or not the description was displayed. This defaults
-to <span
-class="cmtt-10">\smallskip</span>. This is then followed by:
-
-
-
-</p><!--l. 5028--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-26031"></a> <span
-class="cmtt-10">\glstopicLoc{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location list</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5030--><p class="noindent" >
-which may be used to display the location list, but does nothing by default.
-</p><!--l. 5034--><p class="indent" > The sub-entries first set up the paragraph and hanging indentations using:
-</p><!--l. 5036--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-26032"></a> <span
-class="cmtt-10">\glstopicAssignSubIndent{</span>&#x27E8;<span
-class="cmitt-10">level</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5038--><p class="noindent" >
-This uses:
-</p><!--l. 5040--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-26033"></a> <span
-class="cmtt-10">\glstopicAssignWidest{</span>&#x27E8;<span
-class="cmitt-10">level</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5042--><p class="noindent" >
-to determine if a widest name has been set for the given level.
-</p><!--l. 5045--><p class="indent" > The sub-entry has its information displayed using:
-</p><!--l. 5046--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-26034"></a> <span
-class="cmtt-10">\glstopicSubItem{</span>&#x27E8;<span
-class="cmitt-10">level</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5048--><p class="noindent" >
-This encapsulates the name with:
-</p><!--l. 5050--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-26035"></a> <span
-class="cmtt-10">\glstopicSubNameFont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5052--><p class="noindent" >
-By default this just uses <span
-class="cmtt-10">\textbf</span>. This is followed by:
-</p><!--l. 5054--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-26036"></a> <span
-class="cmtt-10">\glstopicSubItemSep </span></div><hr>
-</p><!--l. 5056--><p class="noindent" >
-which defaults to <span
-class="cmtt-10">\quad</span>. The name and separator are passed in the &#x27E8;<span
-class="cmti-10">text</span>&#x27E9; argument
-of:
-</p><!--l. 5059--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-26037"></a> <span
-class="cmtt-10">\glstopicSubItemBox{</span>&#x27E8;<span
-class="cmitt-10">level</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5061--><p class="noindent" >
-If a widest name was set for the given level, this will put &#x27E8;<span
-class="cmti-10">text</span>&#x27E9; inside a box of that
-width otherwise it just does &#x27E8;<span
-class="cmti-10">text</span>&#x27E9;.
-</p><!--l. 5066--><p class="indent" > This is followed by the symbol in parentheses if set. Then, if the description is set,
-the description and post-description hook are displayed followed by:
-</p><!--l. 5069--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-26038"></a> <span
-class="cmtt-10">\glstopicSubPreLocSep </span></div><hr>
-</p><!--l. 5071--><p class="noindent" >
-(This command isn&#8217;t used if the description isn&#8217;t set.)
-</p><!--l. 5074--><p class="indent" > Finally the location list is displayed using:
-</p><!--l. 5075--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-26039"></a> <span
-class="cmtt-10">\glstopicSubLoc{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5077--><p class="noindent" >
-which just does &#x27E8;<span
-class="cmti-10">location</span>&#x27E9; by default.
-
-
-
-</p>
-<!--l. 5080--><p class="indent" > </div>
-</p><!--l. 5080--><p class="noindent" ><a
-href="#top">Top</a><div class="chapter"><h2 class="chapterHead">4. <a
- id="sec:abbreviations"></a>Abbreviations</h2>
-</p><!--l. 5083--><p class="indent" > The new abbreviation system provided by <span
-class="cmss-10">glossaries-extra </span>is more flexible
-than the acronym handling provided by the base <span
-class="cmss-10">glossaries </span>package. The
-<span
-class="cmss-10">glossaries-extra </span>package modifies the underlying formatting used by <span
-class="cmtt-10">\gls </span>(and its
-variants) so that terms that are recognised as abbreviations can have their
-formatting dealt with by the style. You therefore need to select an abbreviation
-style that ensures that <span
-class="cmtt-10">\gls </span>(and its variants) displays the desired output.
-See the file <a
-href="http://mirrors.ctan.org/macros/latex/contrib/glossaries-extra/samples/sample-abbr-styles.pdf" >sample-abbr-styles.pdf</a> for samples of all provided abbreviation
-styles.
-</p><!--l. 5095--><p class="indent" > <div class="important" title="Important Note"> Don&#8217;t use <span
-class="cmtt-10">\glsfirst</span><a
- id="dx1-27001"></a>, <span
-class="cmtt-10">\Glsfirst</span><a
- id="dx1-27002"></a> or <span
-class="cmtt-10">\GLSfirst</span><a
- id="dx1-27003"></a> with abbreviations as they aren&#8217;t
-flexible enough to handle some abbreviation styles and unexpected results may occur.
-(To a lesser degree, this also applies to <span
-class="cmtt-10">\glstext</span><a
- id="dx1-27004"></a> etc.) Use commands like
-<span
-class="cmtt-10">\glsfmttext</span>, <span
-class="cmtt-10">\glsfmtshort </span>or <span
-class="cmtt-10">\glsfmtlong </span>in section headings or captions instead
-of <span
-class="cmtt-10">\gls</span>. If you don&#8217;t want the full form to show on first use of <span
-class="cmtt-10">\gls </span>use one of the
-&#8220;nolong&#8221; or &#8220;noshort&#8221; styles. </div>
-</p><!--l. 5104--><p class="noindent" >
-</p><!--l. 5106--><p class="indent" > This lack of flexibility in <span
-class="cmtt-10">\glsfirst </span>can be demonstrated with the following
-document:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-145">
-\documentclass{article}
-\usepackage{glossaries-extra}
-\setabbreviationstyle{footnote}
-\newabbreviation{ex}{EX}{Example}
-\begin{document}
-Compare&#x00A0;\gls{ex}['s]&#x00A0;with&#x00A0;\glsfirst{ex}['s].
-\end{document}
-</pre>
-<!--l. 5118--><p class="nopar" > The <a
- id="dx1-27005"></a><a
-href="#glo:firstuse">first use</a> <span
-class="cmtt-10">\gls </span>has the footnote marker after the inserted material &#8220;EX&#8217;s<sup class="textsuperscript"><span
-class="cmr-9">1</span></sup>&#8221; but
-<span
-class="cmtt-10">\glsfirst </span>has it before the inserted material &#8220;EX<sup class="textsuperscript"><span
-class="cmr-9">1</span></sup>&#8217;s&#8221; which is inappropriate. Note
-that if the style is changed to <a
-href="#abbrstyle.postfootnote"><span
-class="cmss-10">postfootnote</span></a><a
- id="dx1-27006"></a>, the footnote marker appears after the
-inserted material as <span
-class="cmtt-10">\footnote</span><a
- id="dx1-27007"></a> is in the post-link hook.
-</p><!--l. 5126--><p class="indent" > There are some instances where <span
-class="cmtt-10">\glstext </span>can be useful. It&#8217;s used internally by
-<span
-class="cmtt-10">\glsfmttext</span><a
- id="dx1-27008"></a>, which in turn is used by <span
-class="cmtt-10">\glsseelistformat</span><a
- id="dx1-27009"></a> if the entry has a
-short form. If <span
-class="cmtt-10">\glsfmtshort </span>is used, this enforces the short form, but if
-<span
-class="cmtt-10">\glsfmttext </span>is used, then the long form will be used for the &#8220;noshort&#8221; styles, which
-is more appropriate. In this particular situation, there&#8217;s no need to worry
-about inserted material as the final optional argument isn&#8217;t supported by
-<span
-class="cmtt-10">\glsfmttext</span>.
-</p><!--l. 5135--><p class="indent" > Abbreviations include acronyms (words formed from initial letters, such as
-&#8220;laser&#8221;), initialisms (initial letters of a phrase, such as &#8220;html&#8221;, that aren&#8217;t
-pronounced as words) and contractions (where parts of words are omitted, often
-replaced by an apostrophe, such as &#8220;don&#8217;t&#8221;). The &#8220;acronym&#8221; code provided by the
-<span
-class="cmss-10">glossaries </span>package is misnamed as it&#8217;s more often than not used for initialisms instead.
-Acronyms tend not to be <span
-class="cmti-10">expanded </span>on <a
- id="dx1-27010"></a>first use (although they may need
-to be <span
-class="cmti-10">described </span>for readers unfamiliar with the term). They are therefore
-more like a regular term, which may or may not require a description in the
-glossary.
-</p><!--l. 5147--><p class="indent" > The <span
-class="cmss-10">glossaries-extra </span>package corrects this misnomer, and provides better
-abbreviation handling, with
-</p><!--l. 5149--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-27011"></a> <span
-class="cmtt-10">\newabbreviation[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">short</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">long</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5151--><p class="noindent" >
-</p><!--l. 5153--><p class="indent" > This sets the <span
-class="cmss-10">category</span><a
- id="dx1-27012"></a> key to <span
-class="cmtt-10">abbreviation </span>by default, but that value may
-be overridden in &#x27E8;<span
-class="cmti-10">options</span>&#x27E9;. The category may have attributes that modify
-the way abbreviations are defined. For example, the <a
-href="#catattr.insertdots"><span
-class="cmss-10">insertdots</span></a><a
- id="dx1-27013"></a> attribute
-will automatically insert full stops (periods) into &#x27E8;<span
-class="cmti-10">short</span>&#x27E9; or the <a
-href="#catattr.noshortplural"><span
-class="cmss-10">noshortplural</span></a><a
- id="dx1-27014"></a>
-attribute will set the default value of the <span
-class="cmss-10">shortplural</span><a
- id="dx1-27015"></a> key to just &#x27E8;<span
-class="cmti-10">short</span>&#x27E9; (without
-appending the plural suffix). See <a
-href="#sec:categories"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">7</span> </a><a
-href="#sec:categories">Categories<!--tex4ht:ref: sec:categories --></a> for further
-details.
-</p><!--l. 5163--><p class="indent" > See <a
-href="#sec:nested"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.8</span> </a><a
-href="#sec:nested">Nested Links<!--tex4ht:ref: sec:nested --></a> regarding the pitfalls of using commands like <span
-class="cmtt-10">\gls</span><a
- id="dx1-27016"></a>
-
-
-
-or <span
-class="cmtt-10">\glsxtrshort</span><a
- id="dx1-27017"></a> within &#x27E8;<span
-class="cmti-10">short</span>&#x27E9; or &#x27E8;<span
-class="cmti-10">long</span>&#x27E9;.
-</p><!--l. 5167--><p class="indent" > <div class="important" title="Important Note"> Make sure that you set the category attributes before defining new abbreviations
-or they may not be correctly applied. </div>
-</p><!--l. 5170--><p class="noindent" >
-</p><!--l. 5172--><p class="indent" > The <span
-class="cmtt-10">\newacronym</span><a
- id="dx1-27018"></a> command provided by the <span
-class="cmss-10">glossaries </span>package is redefined by
-<span
-class="cmss-10">glossaries-extra </span>to use <span
-class="cmtt-10">\newabbreviation </span>with the <span
-class="cmss-10">category</span><a
- id="dx1-27019"></a> set to <span
-class="cmtt-10">acronym </span>(see also
-<a
-href="#sec:acronymmods"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.9</span> </a><a
-href="#sec:acronymmods">Acronym Style Modifications<!--tex4ht:ref: sec:acronymmods --></a>) so
-</p><!--l. 5176--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-27020"></a> <span
-class="cmtt-10">\newacronym[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">short</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">long</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5178--><p class="noindent" >
-is
-now
-equivalent
-to
-<spacer type=vertical size=10><span class="obeylines-h">
-<br /><span
-class="cmtt-10">\newabbreviation[type=\acronymtype,category=acronym,</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]</span>
-<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>
-<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">short</span>&#x27E9;<span
-class="cmtt-10">}</span>
-<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">long</span>&#x27E9;<span
-class="cmtt-10">}</span>
-<br /><spacer type=vertical size=10></span>
-</p><!--l. 5185--><p class="indent" > The <span
-class="cmtt-10">\newabbreviation </span>command is superficially similar to the <span
-class="cmss-10">glossaries</span>
-package&#8217;s <span
-class="cmtt-10">\newacronym </span>but you can apply different styles to different categories. The
-default style is <a
-href="#abbrstyle.short-nolong"><span
-class="cmss-10">short-nolong</span></a><a
- id="dx1-27021"></a> for entries in the <span
-class="cmss-10">acronym</span><a
- id="dx1-27022"></a> category and <a
-href="#abbrstyle.short-long"><span
-class="cmss-10">short-long</span></a><a
- id="dx1-27023"></a> for
-entries in the <span
-class="cmss-10">abbreviation</span><a
- id="dx1-27024"></a> category. (These aren&#8217;t the same as the acronym
-styles provided by the <span
-class="cmss-10">glossaries </span>package, although they may produce similar
-results.)
-</p><!--l. 5195--><p class="indent" > The way the abbreviations are displayed by commands like <span
-class="cmtt-10">\gls </span>varies according
-to the abbreviation style. The styles are set according to the entry&#8217;s category so,
-unlike the base <span
-class="cmss-10">glossaries </span>package, you can have different abbreviation styles within
-the same glossary.
-</p><!--l. 5201--><p class="indent" > There are two types of full forms. The display full form, which is used on
-<a
- id="dx1-27025"></a><a
-href="#glo:firstuse">first use</a> by commands like <span
-class="cmtt-10">\gls</span><a
- id="dx1-27026"></a> and the inline full form, which is used by
-commands like <span
-class="cmtt-10">\glsxtrfull</span><a
- id="dx1-27027"></a>. For some of the abbreviation styles, such as
-<a
-href="#abbrstyle.long-short"><span
-class="cmss-10">long-short</span></a><a
- id="dx1-27028"></a>, the display and inline forms are the same. In the case of styles
-such as <a
-href="#abbrstyle.short-nolong"><span
-class="cmss-10">short-nolong</span></a><a
- id="dx1-27029"></a> or <a
-href="#abbrstyle.short-footnote"><span
-class="cmss-10">short-footnote</span></a><a
- id="dx1-27030"></a>, the display and inline full forms are
-different.
-</p><!--l. 5208--><p class="indent" > These formatting commands aren&#8217;t stored in the <span
-class="cmss-10">short</span><a
- id="dx1-27031"></a>, <span
-class="cmss-10">shortplural</span><a
- id="dx1-27032"></a>, <span
-class="cmss-10">long</span><a
- id="dx1-27033"></a> or
-<span
-class="cmss-10">longplural</span><a
- id="dx1-27034"></a> fields, which means they won&#8217;t be used within commands like
-<span
-class="cmtt-10">\glsentryshort </span>(but they are used within commands like <span
-class="cmtt-10">\glsxtrshort </span>and
-<span
-class="cmtt-10">\glsfmtshort</span>). Note that <span
-class="cmtt-10">\glsxtrlong</span><a
- id="dx1-27035"></a> and the case-changing variants don&#8217;t use
-<span
-class="cmtt-10">\glsfirstlongfont</span>.
-</p><!--l. 5216--><p class="indent" > You can apply the formatting command used for the short form to some arbitrary
-text using
-
-
-
-</p><!--l. 5218--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-27036"></a> <span
-class="cmtt-10">\glsuseabbrvfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">category</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5220--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">category</span>&#x27E9; is the category label that identifies the abbreviation style. Similarly
-for the formatting command use by the long form:
-</p><!--l. 5224--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-27037"></a> <span
-class="cmtt-10">\glsuselongfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">category</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5226--><p class="noindent" >
-</p><!--l. 5228--><p class="indent" > You can&#8217;t use the acronym commands provided by the base package with the new
-abbreviations provided by the <span
-class="cmss-10">glossaries-extra </span>package. The style commands that
-replace <span
-class="cmtt-10">\setacronymstyle</span>, <span
-class="cmtt-10">\acrshort </span>etc are described in <a
-href="#sec:abbrstyle"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">4.2</span>
-</a><a
-href="#sec:abbrstyle">Abbreviation Styles<!--tex4ht:ref: sec:abbrstyle --></a>. The <a
-href="#styopt.acronymlists"><span
-class="cmss-10">acronymlists</span></a><a
- id="dx1-27038"></a> package option and associated commands
-aren&#8217;t supported. The <span
-class="cmtt-10">\forallacronyms</span><a
- id="dx1-27039"></a> command, which iterates over all acronym
-lists, should be replaced with:
-</p><!--l. 5235--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-27040"></a> <span
-class="cmtt-10">\forallabbreviationlists{</span>&#x27E8;<span
-class="cmitt-10">cs</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">body</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5237--><p class="noindent" >
-</p>
-<!--l. 5239--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">4.1 </span> <a
- id="sec:tagging"></a>Tagging Initials</h3>
-<!--l. 5242--><p class="noindent" >If you would like to tag the initial letters in the long form such that those letters are
-underlined in the glossary but not in the main part of the document, you can
-use
-</p><!--l. 5245--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-28001"></a> <span
-class="cmtt-10">\GlsXtrEnableInitialTagging{</span>&#x27E8;<span
-class="cmitt-10">categories</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">cs</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5247--><p class="noindent" >
-before you define your abbreviations.
-</p><!--l. 5250--><p class="indent" > This command (robustly) defines &#x27E8;<span
-class="cmti-10">cs</span>&#x27E9; (a control sequence) to accept a single
-argument, which is the letter (or letters) that needs to be tagged. The normal
-behaviour of this command within the document is to simply do its argument, but in
-the glossary it&#8217;s activated for those categories that have the <a
-href="#catattr.tagging"><span
-class="cmss-10">tagging</span></a><a
- id="dx1-28002"></a> attribute set to
-&#8220;true&#8221;. For those cases it will use
-</p><!--l. 5257--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-28003"></a> <span
-class="cmtt-10">\glsxtrtagfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5259--><p class="noindent" >
-This command defaults to <span
-class="cmtt-10">\underline</span><a
- id="dx1-28004"></a><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmti-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span>but may be redefined as required.
-</p><!--l. 5263--><p class="indent" > The control sequence &#x27E8;<span
-class="cmti-10">cs</span>&#x27E9; can&#8217;t already be defined when used with the unstarred
-version of <span
-class="cmtt-10">\GlsXtrEnableInitialTagging </span>for safety reasons. The starred
-version will overwrite any previous definition of &#x27E8;<span
-class="cmti-10">cs</span>&#x27E9;. As with redefining any
-commands, ensure that you don&#8217;t redefine something important. In fact, just
-forget the existence of the starred version and let&#8217;s pretend I didn&#8217;t mention
-it.
-</p><!--l. 5272--><p class="indent" > The first argument of <span
-class="cmtt-10">\GlsXtrEnableInitialTagging </span>is a comma-separated
-list of category names. The <a
-href="#catattr.tagging"><span
-class="cmss-10">tagging</span></a><a
- id="dx1-28005"></a> attribute will automatically be set for
-those categories. You can later set this attribute for other categories (see
-<a
-href="#sec:categories"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">7</span> </a><a
-href="#sec:categories">Categories<!--tex4ht:ref: sec:categories --></a>) but this must be done before the glossary is
-displayed.
-</p><!--l. 5279--><p class="indent" > The accompanying sample file <span
-class="cmtt-10">sample-mixtures.tex </span>uses initial tagging for both
-
-
-
-the <span
-class="cmss-10">acronym</span><a
- id="dx1-28006"></a> and <span
-class="cmss-10">abbreviation</span><a
- id="dx1-28007"></a> categories:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-146">
-\GlsXtrEnableInitialTagging{acronym,abbreviation}{\itag}
-</pre>
-<!--l. 5284--><p class="nopar" > This defines the command <span
-class="cmtt-10">\itag </span>which can be used in the definitions. For
-example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-147">
-\newacronym
-&#x00A0;[description={a&#x00A0;system&#x00A0;for&#x00A0;detecting&#x00A0;the&#x00A0;location&#x00A0;and
-&#x00A0;speed&#x00A0;of&#x00A0;ships,&#x00A0;aircraft,&#x00A0;etc,&#x00A0;through&#x00A0;the&#x00A0;use&#x00A0;of&#x00A0;radio
-&#x00A0;waves}%&#x00A0;description&#x00A0;of&#x00A0;this&#x00A0;term
-&#x00A0;]
-&#x00A0;{radar}%&#x00A0;identifying&#x00A0;label
-&#x00A0;{radar}%&#x00A0;short&#x00A0;form&#x00A0;(i.e.&#x00A0;the&#x00A0;word)
-&#x00A0;{\itag{ra}dio&#x00A0;\itag{d}etection&#x00A0;\itag{a}nd&#x00A0;\itag{r}anging}
-\newabbreviation{xml}{XML}
-&#x00A0;{e\itag{x}tensible&#x00A0;\itag{m}arkup&#x00A0;\itag{l}anguage}
-</pre>
-<!--l. 5299--><p class="nopar" > The underlining of the tagged letters only occurs in the glossary and then only for
-entries with the <a
-href="#catattr.tagging"><span
-class="cmss-10">tagging</span></a><a
- id="dx1-28008"></a> attribute set.
-</p><!--l. 5304--><p class="noindent" >
-</p>
-<!--l. 5304--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">4.2 </span> <a
- id="sec:abbrstyle"></a>Abbreviation Styles</h3>
-<!--l. 5307--><p class="noindent" >The abbreviation style must be set before abbreviations are defined using:
-</p><!--l. 5309--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-29001"></a> <span
-class="cmtt-10">\setabbreviationstyle[</span>&#x27E8;<span
-class="cmitt-10">category</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">style-name</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5311--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">style-name</span>&#x27E9; is the name of the style and &#x27E8;<span
-class="cmti-10">category</span>&#x27E9; is the category label
-(<span
-class="cmtt-10">abbreviation </span>by default). New abbreviations will pick up the current style
-according to their given category. If there is no style set for the category, the fallback
-is the style for the <span
-class="cmtt-10">abbreviation </span>category. Some styles may automatically
-modify one or more of the attributes associated with the given category. For
-example, the <a
-href="#abbrstyle.long-noshort"><span
-class="cmss-10">long-noshort</span></a><a
- id="dx1-29002"></a> and <a
-href="#abbrstyle.short-nolong"><span
-class="cmss-10">short-nolong</span></a><a
- id="dx1-29003"></a> styles set the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-29004"></a> attribute to
-<span
-class="cmtt-10">true</span>.
-</p><!--l. 5322--><p class="indent" > <div class="important" title="Important Note"> If you want to apply different styles to groups of abbreviations, assign a
-different category to each group and set the style for the given category.
-</div>
-</p><!--l. 5326--><p class="noindent" >
-</p><!--l. 5328--><p class="indent" > Note that <span
-class="cmtt-10">\setacronymstyle</span><a
- id="dx1-29005"></a> is disabled by <span
-class="cmss-10">glossaries-extra</span>. Use </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\setabbreviationstyle[acronym]{</span>&#x27E8;<span
-class="cmitt-10">style-name</span>&#x27E9;<span
-class="cmtt-10">}</span>
-
-
-
-</div>
-</div> instead. The original acronym interface can be restored with <span
-class="cmtt-10">\RestoreAcronyms</span><a
- id="dx1-29006"></a> (see
-<a
-href="#sec:acronymmods"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.9</span> </a><a
-href="#sec:acronymmods">Acronym Style Modifications<!--tex4ht:ref: sec:acronymmods --></a>). However the original acronym
-interface is incompatible with all the commands described here.
-<!--l. 5338--><p class="indent" > Abbreviations can be used with the standard <span
-class="cmss-10">glossaries </span>commands, such as <span
-class="cmtt-10">\gls</span><a
- id="dx1-29007"></a>,
-but don&#8217;t use the acronym commands like <span
-class="cmtt-10">\acrshort</span><a
- id="dx1-29008"></a> (which use <span
-class="cmtt-10">\acronymfont</span><a
- id="dx1-29009"></a>).
-The short form can be produced with:
-</p><!--l. 5342--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-29010"></a> <span
-class="cmtt-10">\glsxtrshort[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 5344--><p class="noindent" >
-(Use this instead of <span
-class="cmtt-10">\acrshort</span><a
- id="dx1-29011"></a>.)
-</p><!--l. 5347--><p class="indent" > The long form can be produced with
-</p><!--l. 5348--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-29012"></a> <span
-class="cmtt-10">\glsxtrlong[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 5350--><p class="noindent" >
-(Use this instead of <span
-class="cmtt-10">\acrlong</span><a
- id="dx1-29013"></a>.)
-</p><!--l. 5353--><p class="indent" > The <span
-class="cmti-10">inline </span>full form can be produced with
-</p><!--l. 5354--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-29014"></a> <span
-class="cmtt-10">\glsxtrfull[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 5356--><p class="noindent" >
-(This this instead of <span
-class="cmtt-10">\acrfull</span><a
- id="dx1-29015"></a>.)
-</p><!--l. 5359--><p class="indent" > <div class="important" title="Important Note"> In general, it&#8217;s best not to use commands like <span
-class="cmtt-10">\glsfirst</span><a
- id="dx1-29016"></a> for abbreviations,
-especially if you use the &#x27E8;<span
-class="cmti-10">insert</span>&#x27E9; optional argument. Use either <span
-class="cmtt-10">\gls </span>(possibly with a
-reset) or <span
-class="cmtt-10">\glsxtrfull</span>. </div>
-</p><!--l. 5364--><p class="noindent" >
-</p><!--l. 5366--><p class="indent" > As mentioned earlier, the inline full form may not necessarily match the format
-used on <a
- id="dx1-29017"></a><a
-href="#glo:firstuse">first use</a> with <span
-class="cmtt-10">\gls</span>. For example, the <a
-href="#abbrstyle.short-nolong"><span
-class="cmss-10">short-nolong</span></a><a
- id="dx1-29018"></a> style only displays the
-short form on <a
- id="dx1-29019"></a>first use, but the full form will display the long form followed by the
-short form in parentheses.
-</p><!--l. 5373--><p class="indent" > <div class="important" title="Important Note"> If you want to use an abbreviation in a chapter or section title, use the
-commands described in <a
-href="#sec:headtitle"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">5</span> </a><a
-href="#sec:headtitle">Entries in Sectioning Titles, Headers,
-Captions and Contents<!--tex4ht:ref: sec:headtitle --></a> instead. </div>
-</p><!--l. 5377--><p class="noindent" >
-</p><!--l. 5379--><p class="indent" > The arguments &#x27E8;<span
-class="cmti-10">options</span>&#x27E9;, &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; and &#x27E8;<span
-class="cmti-10">insert</span>&#x27E9; are the same as for commands such as
-<span
-class="cmtt-10">\glstext</span>. There are also analogous case-changing commands:
-</p><!--l. 5383--><p class="indent" > First letter upper case short form:
-</p><!--l. 5384--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-29020"></a> <span
-class="cmtt-10">\Glsxtrshort[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 5386--><p class="noindent" >
-</p><!--l. 5388--><p class="indent" > First letter upper case long form:
-</p><!--l. 5389--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-29021"></a> <span
-class="cmtt-10">\Glsxtrlong[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 5391--><p class="noindent" >
-</p><!--l. 5393--><p class="indent" > First letter upper case inline full form:
-</p><!--l. 5394--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-29022"></a> <span
-class="cmtt-10">\Glsxtrfull[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 5396--><p class="noindent" >
-</p><!--l. 5398--><p class="indent" > All upper case short form:
-
-
-
-</p><!--l. 5399--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-29023"></a> <span
-class="cmtt-10">\GLSxtrshort[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 5401--><p class="noindent" >
-</p><!--l. 5403--><p class="indent" > All upper case long form:
-</p><!--l. 5404--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-29024"></a> <span
-class="cmtt-10">\GLSxtrlong[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 5406--><p class="noindent" >
-</p><!--l. 5408--><p class="indent" > All upper case inline full form:
-</p><!--l. 5409--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-29025"></a> <span
-class="cmtt-10">\GLSxtrfull[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 5411--><p class="noindent" >
-</p><!--l. 5413--><p class="indent" > Plural forms are also available.
-</p><!--l. 5415--><p class="indent" > Short form plurals:
-</p><!--l. 5416--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-29026"></a> <span
-class="cmtt-10">\glsxtrshortpl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 5418--><p class="noindent" >
-</p><!--l. 5419--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-29027"></a> <span
-class="cmtt-10">\Glsxtrshortpl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 5421--><p class="noindent" >
-</p><!--l. 5422--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-29028"></a> <span
-class="cmtt-10">\GLSxtrshortpl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 5424--><p class="noindent" >
-</p><!--l. 5426--><p class="indent" > Long form plurals:
-</p><!--l. 5427--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-29029"></a> <span
-class="cmtt-10">\glsxtrlongpl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 5429--><p class="noindent" >
-</p><!--l. 5430--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-29030"></a> <span
-class="cmtt-10">\Glsxtrlongpl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 5432--><p class="noindent" >
-</p><!--l. 5433--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-29031"></a> <span
-class="cmtt-10">\GLSxtrlongpl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 5435--><p class="noindent" >
-</p><!--l. 5437--><p class="indent" > Full form plurals:
-</p><!--l. 5438--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-29032"></a> <span
-class="cmtt-10">\glsxtrfullpl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 5440--><p class="noindent" >
-</p><!--l. 5441--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-29033"></a> <span
-class="cmtt-10">\Glsxtrfullpl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 5443--><p class="noindent" >
-</p><!--l. 5444--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-29034"></a> <span
-class="cmtt-10">\GLSxtrfullpl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 5446--><p class="noindent" >
-</p><!--l. 5448--><p class="indent" > <div class="important" title="Important Note"> Be careful about using <span
-class="cmtt-10">\glsentryfull</span>, <span
-class="cmtt-10">\Glsentryfull</span>, <span
-class="cmtt-10">\glsentryfullpl </span>and
-<span
-class="cmtt-10">\Glsentryfullpl</span>. These commands will use the currently applied style rather
-than the style in use when the entry was defined. If you have mixed styles,
-you&#8217;ll need to use <span
-class="cmtt-10">\glsxtrfull</span><a
- id="dx1-29035"></a> instead. Similarly for <span
-class="cmtt-10">\glsentryshort </span>etc.
-
-
-
-</div>
-</p><!--l. 5454--><p class="noindent" >
-</p><!--l. 5456--><p class="noindent" >
-</p>
-<!--l. 5456--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">4.3 </span> <a
- id="sec:abbrshortcuts"></a>Shortcut Commands</h3>
-<!--l. 5459--><p class="noindent" >The abbreviation shortcut commands can be enabled using the <a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><span
-class="cmss-10">=abbreviations</span><a
- id="dx1-30001"></a>
-package option (or <a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><span
-class="cmss-10">=abbr</span><a
- id="dx1-30002"></a>) or <a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><span
-class="cmss-10">=ac</span><a
- id="dx1-30003"></a>. (You can use both settings at the
-same time.) The provided shortcut commands listed in <a
-href="#tab:abbrshortcuts">table&#x00A0;<span
-class="cmbx-10">4.1</span></a>.
-</p>
- <div class="table">
-
-
-
-<!--l. 5466--><p class="indent" > <a
- id="tab:abbrshortcuts"></a></p><hr class="float" /><div class="float"
->
-
-
-
- <div class="caption"
-><span class="id">Table&#x00A0;4.1: </span><span
-class="content">Abbreviation Shortcut Commands</span></div><!--tex4ht:label?: x1-300041 -->
-<div class="tabular"> <table id="TBL-3" class="tabular"
-
-><colgroup id="TBL-3-1g"><col
-id="TBL-3-1" /><col
-id="TBL-3-2" /><col
-id="TBL-3-3" /></colgroup><tr
- style="vertical-align:baseline;" id="TBL-3-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-1-1"
-class="td11"><span
-class="cmbx-10">Shortcut </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-1-2"
-class="td11"><span
-class="cmbx-10">Shortcut </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-1-3"
-class="td11"><span
-class="cmbx-10">Equivalent Command</span></td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-2-1"
-class="td11"><span
-class="cmbx-10">(</span><a
-href="#styopt.shortcuts"><span
-class="cmssbx-10">shortcuts</span></a><span
-class="cmssbx-10">=abbreviations</span><a
- id="dx1-30005"></a><span
-class="cmbx-10">)</span></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-2-2"
-class="td11"><span
-class="cmbx-10">(</span><a
-href="#styopt.shortcuts"><span
-class="cmssbx-10">shortcuts</span></a><span
-class="cmssbx-10">=ac</span><a
- id="dx1-30006"></a><span
-class="cmbx-10">)</span></td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-3-1"
-class="td11"><span
-class="cmtt-10">\ab</span><a
- id="dx1-30007"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-3-2"
-class="td11"><span
-class="cmtt-10">\ac</span><a
- id="dx1-30008"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-3-3"
-class="td11"><span
-class="cmtt-10">\cgls</span><a
- id="dx1-30009"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-4-1"
-class="td11"><span
-class="cmtt-10">\abp</span><a
- id="dx1-30010"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-4-2"
-class="td11"><span
-class="cmtt-10">\acp</span><a
- id="dx1-30011"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-4-3"
-class="td11"><span
-class="cmtt-10">\cglspl</span><a
- id="dx1-30012"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-5-1"
-class="td11"><span
-class="cmtt-10">\as</span><a
- id="dx1-30013"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-5-2"
-class="td11"><span
-class="cmtt-10">\acs</span><a
- id="dx1-30014"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-5-3"
-class="td11"><span
-class="cmtt-10">\glsxtrshort</span><a
- id="dx1-30015"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-6-1"
-class="td11"><span
-class="cmtt-10">\asp</span><a
- id="dx1-30016"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-6-2"
-class="td11"><span
-class="cmtt-10">\acsp</span><a
- id="dx1-30017"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-6-3"
-class="td11"><span
-class="cmtt-10">\glsxtrshortpl</span><a
- id="dx1-30018"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-7-1"
-class="td11"><span
-class="cmtt-10">\al</span><a
- id="dx1-30019"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-7-2"
-class="td11"><span
-class="cmtt-10">\acl</span><a
- id="dx1-30020"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-7-3"
-class="td11"><span
-class="cmtt-10">\glsxtrlong</span><a
- id="dx1-30021"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-8-1"
-class="td11"><span
-class="cmtt-10">\alp</span><a
- id="dx1-30022"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-8-2"
-class="td11"><span
-class="cmtt-10">\aclp</span><a
- id="dx1-30023"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-8-3"
-class="td11"><span
-class="cmtt-10">\glsxtrlongpl</span><a
- id="dx1-30024"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-9-1"
-class="td11"><span
-class="cmtt-10">\af</span><a
- id="dx1-30025"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-9-2"
-class="td11"><span
-class="cmtt-10">\acf</span><a
- id="dx1-30026"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-9-3"
-class="td11"><span
-class="cmtt-10">\glsxtrfull</span><a
- id="dx1-30027"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-10-1"
-class="td11"><span
-class="cmtt-10">\afp</span><a
- id="dx1-30028"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-10-2"
-class="td11"><span
-class="cmtt-10">\acfp</span><a
- id="dx1-30029"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-10-3"
-class="td11"><span
-class="cmtt-10">\glsxtrfullpl</span><a
- id="dx1-30030"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-11-1"
-class="td11"><span
-class="cmtt-10">\Ab</span><a
- id="dx1-30031"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-11-2"
-class="td11"><span
-class="cmtt-10">\Ac</span><a
- id="dx1-30032"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-11-3"
-class="td11"><span
-class="cmtt-10">\cgls</span><a
- id="dx1-30033"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-12-1"
-class="td11"><span
-class="cmtt-10">\Abp</span><a
- id="dx1-30034"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-12-2"
-class="td11"><span
-class="cmtt-10">\Acp</span><a
- id="dx1-30035"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-12-3"
-class="td11"><span
-class="cmtt-10">\cglspl</span><a
- id="dx1-30036"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-13-1"
-class="td11"><span
-class="cmtt-10">\As</span><a
- id="dx1-30037"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-13-2"
-class="td11"><span
-class="cmtt-10">\Acs</span><a
- id="dx1-30038"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-13-3"
-class="td11"><span
-class="cmtt-10">\Glsxtrshort</span><a
- id="dx1-30039"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-14-1"
-class="td11"><span
-class="cmtt-10">\Asp</span><a
- id="dx1-30040"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-14-2"
-class="td11"><span
-class="cmtt-10">\Acsp</span><a
- id="dx1-30041"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-14-3"
-class="td11"><span
-class="cmtt-10">\Glsxtrshortpl</span><a
- id="dx1-30042"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-15-1"
-class="td11"><span
-class="cmtt-10">\Al</span><a
- id="dx1-30043"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-15-2"
-class="td11"><span
-class="cmtt-10">\Acl</span><a
- id="dx1-30044"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-15-3"
-class="td11"><span
-class="cmtt-10">\Glsxtrlong</span><a
- id="dx1-30045"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-16-1"
-class="td11"><span
-class="cmtt-10">\Alp</span><a
- id="dx1-30046"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-16-2"
-class="td11"><span
-class="cmtt-10">\Aclp</span><a
- id="dx1-30047"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-16-3"
-class="td11"><span
-class="cmtt-10">\Glsxtrlongpl</span><a
- id="dx1-30048"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-17-1"
-class="td11"><span
-class="cmtt-10">\Af</span><a
- id="dx1-30049"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-17-2"
-class="td11"><span
-class="cmtt-10">\Acf</span><a
- id="dx1-30050"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-17-3"
-class="td11"><span
-class="cmtt-10">\Glsxtrfull</span><a
- id="dx1-30051"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-18-1"
-class="td11"><span
-class="cmtt-10">\Afp</span><a
- id="dx1-30052"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-18-2"
-class="td11"><span
-class="cmtt-10">\Acfp</span><a
- id="dx1-30053"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-18-3"
-class="td11"><span
-class="cmtt-10">\Glsxtrfullpl</span><a
- id="dx1-30054"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-19-1"
-class="td11"><span
-class="cmtt-10">\AB</span><a
- id="dx1-30055"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-19-2"
-class="td11"><span
-class="cmtt-10">\AC</span><a
- id="dx1-30056"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-19-3"
-class="td11"><span
-class="cmtt-10">\cGLS</span><a
- id="dx1-30057"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-20-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-20-1"
-class="td11"><span
-class="cmtt-10">\ABP</span><a
- id="dx1-30058"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-20-2"
-class="td11"><span
-class="cmtt-10">\ACP</span><a
- id="dx1-30059"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-20-3"
-class="td11"><span
-class="cmtt-10">\cGLSpl</span><a
- id="dx1-30060"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-21-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-21-1"
-class="td11"><span
-class="cmtt-10">\AS</span><a
- id="dx1-30061"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-21-2"
-class="td11"><span
-class="cmtt-10">\ACS</span><a
- id="dx1-30062"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-21-3"
-class="td11"><span
-class="cmtt-10">\GLSxtrshort</span><a
- id="dx1-30063"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-22-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-22-1"
-class="td11"><span
-class="cmtt-10">\ASP</span><a
- id="dx1-30064"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-22-2"
-class="td11"><span
-class="cmtt-10">\ACSP</span><a
- id="dx1-30065"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-22-3"
-class="td11"><span
-class="cmtt-10">\GLSxtrshortpl</span><a
- id="dx1-30066"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-23-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-23-1"
-class="td11"><span
-class="cmtt-10">\AL</span><a
- id="dx1-30067"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-23-2"
-class="td11"><span
-class="cmtt-10">\ACL</span><a
- id="dx1-30068"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-23-3"
-class="td11"><span
-class="cmtt-10">\GLSxtrlong</span><a
- id="dx1-30069"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-24-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-24-1"
-class="td11"><span
-class="cmtt-10">\ALP</span><a
- id="dx1-30070"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-24-2"
-class="td11"><span
-class="cmtt-10">\ACLP</span><a
- id="dx1-30071"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-24-3"
-class="td11"><span
-class="cmtt-10">\GLSxtrlongpl</span><a
- id="dx1-30072"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-25-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-25-1"
-class="td11"><span
-class="cmtt-10">\AF</span><a
- id="dx1-30073"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-25-2"
-class="td11"><span
-class="cmtt-10">\ACF</span><a
- id="dx1-30074"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-25-3"
-class="td11"><span
-class="cmtt-10">\GLSxtrfull</span><a
- id="dx1-30075"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-26-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-26-1"
-class="td11"><span
-class="cmtt-10">\AFP</span><a
- id="dx1-30076"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-26-2"
-class="td11"><span
-class="cmtt-10">\ACFP</span><a
- id="dx1-30077"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-26-3"
-class="td11"><span
-class="cmtt-10">\GLSxtrfullpl</span><a
- id="dx1-30078"></a> </td>
-</tr><tr
- style="vertical-align:baseline;" id="TBL-3-27-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-27-1"
-class="td11"><span
-class="cmtt-10">\newabbr</span><a
- id="dx1-30079"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-27-2"
-class="td11"><span
-class="cmtt-10">\newabbr</span><a
- id="dx1-30080"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-27-3"
-class="td11"><span
-class="cmtt-10">\newabbreviation</span><a
- id="dx1-30081"></a> </td></tr></table></div>
-
-
-
- </div><hr class="endfloat" />
- </div>
-<!--l. 5504--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">4.4 </span> <a
- id="sec:predefabbrvstyles"></a>Predefined Abbreviation Styles</h3>
-<!--l. 5507--><p class="noindent" >There are two types of abbreviation styles: those that treat the abbreviation as a
-regular entry (so that <span
-class="cmtt-10">\gls</span><a
- id="dx1-31001"></a> uses <span
-class="cmtt-10">\glsgenentryfmt</span><a
- id="dx1-31002"></a>) and those that don&#8217;t treat the
-abbreviation as a regular entry (so that <span
-class="cmtt-10">\gls</span><a
- id="dx1-31003"></a> uses <span
-class="cmtt-10">\glsxtrgenabbrvfmt</span><a
- id="dx1-31004"></a>).
-</p><!--l. 5512--><p class="indent" > The regular entry abbreviation styles set the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-31005"></a> attribute to &#8220;true&#8221; for the
-category assigned to each abbreviation with that style. This means that on <a
- id="dx1-31006"></a><a
-href="#glo:firstuse">first use</a>,
-<span
-class="cmtt-10">\gls</span><a
- id="dx1-31007"></a> uses the value of the <span
-class="cmss-10">first</span><a
- id="dx1-31008"></a> field and on subsequent use <span
-class="cmtt-10">\gls</span><a
- id="dx1-31009"></a> uses the value of the
-<span
-class="cmss-10">text</span><a
- id="dx1-31010"></a> field (and analogously for the plural and case-changing versions). The <span
-class="cmss-10">short</span><a
- id="dx1-31011"></a> and
-<span
-class="cmss-10">long</span><a
- id="dx1-31012"></a> fields are set as appropriate and may be accessed through commands like
-<span
-class="cmtt-10">\glsxtrshort</span><a
- id="dx1-31013"></a>.
-</p><!--l. 5521--><p class="indent" > The other abbreviation styles don&#8217;t modify the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-31014"></a> attribute. The <span
-class="cmss-10">first</span><a
- id="dx1-31015"></a>
-and <span
-class="cmss-10">text</span><a
- id="dx1-31016"></a> fields (and their plural forms) are set and can be accessed through
-commands like <span
-class="cmtt-10">\glsfirst</span>, but they aren&#8217;t used by commands like <span
-class="cmtt-10">\gls</span><a
- id="dx1-31017"></a>, which
-instead use the short form (stored in the <span
-class="cmss-10">short</span><a
- id="dx1-31018"></a> key) and the display full
-format (through commands like <span
-class="cmtt-10">\glsxtrfullformat</span><a
- id="dx1-31019"></a> that are defined by the
-style).
-</p><!--l. 5529--><p class="indent" > In both cases, the <a
- id="dx1-31020"></a>first use of <span
-class="cmtt-10">\gls</span><a
- id="dx1-31021"></a> may not match the text produced by
-<span
-class="cmtt-10">\glsfirst</span><a
- id="dx1-31022"></a> (and likewise for the plural and case-changing versions).
-</p><!--l. 5533--><p class="indent" > The sample file <span
-class="cmtt-10">sample-abbr-styles.tex </span>demonstrates all predefined styles
-described here.
-</p><!--l. 5536--><p class="indent" > <div class="important" title="Important Note"> For the &#8220;sc&#8221; styles that use <span
-class="cmtt-10">\textsc</span><a
- id="dx1-31023"></a>, be careful about your choice of fonts as
-some only have limited support. For example, you may not be able to combine bold
-and small-caps. I recommend that you at least use the <span
-class="cmss-10">fontenc</span><a
- id="dx1-31024"></a> package with the <span
-class="cmss-10">T1</span>
-option or something similar. </div>
-</p><!--l. 5542--><p class="noindent" >
-</p><!--l. 5544--><p class="indent" > Many of the styles have helper commands in the form <span
-class="cmtt-10">\glsxtr...name </span>and
-<span
-class="cmtt-10">\glsxtr...sort </span>that are expanded within the <span
-class="cmss-10">name</span><a
- id="dx1-31025"></a> and <span
-class="cmss-10">sort</span><a
- id="dx1-31026"></a> fields when the
-abbreviation is defined. These commands may use the helper token registers available
-within <span
-class="cmtt-10">\newabbreviation</span>, such as <span
-class="cmtt-10">\glsshorttok</span><a
- id="dx1-31027"></a>. The contents of a register can be
-accessed with <span
-class="cmtt-10">\the</span><a
- id="dx1-31028"></a>&#x27E8;<span
-class="cmti-10">register</span>&#x27E9;. It&#8217;s essential that these expand when the abbreviation is
-defined so don&#8217;t hide them behind no-expandable content if you redefine these helper
-commands.
-</p><!--l. 5553--><p class="indent" > The parenthetical styles, such as <a
-href="#abbrstyle.long-short"><span
-class="cmss-10">long-short</span></a><a
- id="dx1-31029"></a>, use
-</p><!--l. 5555--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31030"></a> <span
-class="cmtt-10">\glsxtrparen{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5557--><p class="noindent" >
-to set the parenthetical material. This just puts parentheses around the text:
-(&#x27E8;<span
-class="cmti-10">text</span>&#x27E9;).
-</p><!--l. 5561--><p class="indent" > The basic abbreviation styles, such as <a
-href="#abbrstyle.long-short"><span
-class="cmss-10">long-short</span></a><a
- id="dx1-31031"></a> and <a
-href="#abbrstyle.short-long"><span
-class="cmss-10">short-long</span></a><a
- id="dx1-31032"></a> use
-</p><!--l. 5563--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31033"></a> <span
-class="cmtt-10">\glsabbrvdefaultfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-
-
-
-</p><!--l. 5565--><p class="noindent" >
-for the short form. This just does &#x27E8;<span
-class="cmti-10">text</span>&#x27E9; by default. (That is, no font change is
-applied.) On first use,
-</p><!--l. 5568--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31034"></a> <span
-class="cmtt-10">\glsfirstabbrvdefaultfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5570--><p class="noindent" >
-is used instead. By default, this just does <span
-class="cmtt-10">\glsabbrvdefaultfont</span>. The long form is
-formatted according to
-</p><!--l. 5573--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31035"></a> <span
-class="cmtt-10">\glslongdefaultfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5575--><p class="noindent" >
-which again just does &#x27E8;<span
-class="cmti-10">text</span>&#x27E9; (no font change). On first use,
-</p><!--l. 5577--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31036"></a> <span
-class="cmtt-10">\glsfirstlongdefaultfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5579--><p class="noindent" >
-is used instead. This just does <span
-class="cmtt-10">\glslongdefaultfont</span>. The plural suffix used for the
-short form is given by
-</p><!--l. 5582--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31037"></a> <span
-class="cmtt-10">\glsxtrabbrvpluralsuffix </span></div><hr>
-</p><!--l. 5584--><p class="noindent" >
-which defaults to <span
-class="cmtt-10">\glspluralsuffix</span><a
- id="dx1-31038"></a>.
-</p><!--l. 5587--><p class="indent" > The small-cap styles, such as <a
-href="#abbrstyle.long-short-sc"><span
-class="cmss-10">long-short-sc</span></a><a
- id="dx1-31039"></a> and <a
-href="#abbrstyle.short-sc-long"><span
-class="cmss-10">short-sc-long</span></a><a
- id="dx1-31040"></a>, use
-</p><!--l. 5589--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31041"></a> <span
-class="cmtt-10">\glsabbrvscfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5591--><p class="noindent" >
-which uses <span
-class="cmtt-10">\textsc</span>.<span class="footnote-mark"><a
-href="#fn1x4" id="fn1x4-bk"><sup class="textsuperscript">4.1</sup></a></span><a
- id="x1-31042f1"></a>
-On first use
-</p><!--l. 5597--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31043"></a> <span
-class="cmtt-10">\glsfirstabbrvscfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5599--><p class="noindent" >
-is used instead. This uses <span
-class="cmtt-10">\glsabbrvscfont </span>by default. So redefine, <span
-class="cmtt-10">\glsabbrvscfont</span>
-to change first and subsequent uses or <span
-class="cmtt-10">\glsfirstabbrvscfont </span>to change just the
-first use.
-</p><!--l. 5604--><p class="indent" > The long form for the small-cap styles uses <span
-class="cmtt-10">\glslongdefaultfont </span>or
-<span
-class="cmtt-10">\glsfirstlongdefaultfont</span>, as with the basic style. The suffix is given
-by
-</p><!--l. 5607--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31044"></a> <span
-class="cmtt-10">\glsxtrscsuffix </span></div><hr>
-</p><!--l. 5609--><p class="noindent" >
-This is defined as
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-148">
-\newcommand*{\glsxtrscsuffix}{\glstextup{\glsxtrabbrvpluralsuffix}}
-</pre>
-<!--l. 5613--><p class="nopar" > The <span
-class="cmtt-10">\glstextup</span><a
- id="dx1-31045"></a> command is provided by <span
-class="cmss-10">glossaries </span>and is used to switch off
-the small caps font for the suffix. If you override the default short plural
-using the <span
-class="cmss-10">shortplural</span><a
- id="dx1-31046"></a> key when you define the abbreviation you will need to
-make the appropriate adjustment if necessary. (Remember that the default
-plural suffix behaviour can be modified through the use of the <a
-href="#catattr.aposplural"><span
-class="cmss-10">aposplural</span></a><a
- id="dx1-31047"></a>
-and <a
-href="#catattr.noshortplural"><span
-class="cmss-10">noshortplural</span></a><a
- id="dx1-31048"></a> attributes. See <a
-href="#sec:categories"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">7</span> </a><a
-href="#sec:categories">Categories<!--tex4ht:ref: sec:categories --></a> for further
-details.)
-</p><!--l. 5624--><p class="indent" > The small styles, such as <a
-href="#abbrstyle.long-short-sm"><span
-class="cmss-10">long-short-sm</span></a><a
- id="dx1-31049"></a> and <a
-href="#abbrstyle.short-sm-long"><span
-class="cmss-10">short-sm-long</span></a><a
- id="dx1-31050"></a>, use
-</p><!--l. 5626--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31051"></a> <span
-class="cmtt-10">\glsabbrvsmfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5628--><p class="noindent" >
-which uses <span
-class="cmtt-10">\textsmaller</span>. (This requires the <span
-class="cmss-10">relsizes</span><a
- id="dx1-31052"></a> package, which isn&#8217;t loaded by
-<span
-class="cmss-10">glossaries-extra</span>, so must be loaded explicitly.) On first use
-</p><!--l. 5633--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31053"></a> <span
-class="cmtt-10">\glsfirstabbrvsmfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5635--><p class="noindent" >
-is used instead. This uses <span
-class="cmtt-10">\glsabbrvsmfont </span>by default.
-</p><!--l. 5638--><p class="indent" > The long form for the smaller styles uses <span
-class="cmtt-10">\glslongdefaultfont </span>or
-<span
-class="cmtt-10">\glsfirstlongdefaultfont</span>, as with the basic style. The suffix is given
-by
-</p><!--l. 5641--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31054"></a> <span
-class="cmtt-10">\glsxtrsmsuffix </span></div><hr>
-</p><!--l. 5643--><p class="noindent" >
-which defaults to just <span
-class="cmtt-10">\glsxtrabbrvpluralsuffix</span>.
-</p><!--l. 5646--><p class="indent" > The &#8220;short-em&#8221; (emphasize short) styles, such as <a
-href="#abbrstyle.long-short-em"><span
-class="cmss-10">long-short-em</span></a><a
- id="dx1-31055"></a> or <a
-href="#abbrstyle.short-em-long"><span
-class="cmss-10">short-em-long</span></a><a
- id="dx1-31056"></a>,
-use
-</p><!--l. 5648--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31057"></a> <span
-class="cmtt-10">\glsabbrvemfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5650--><p class="noindent" >
-On first use
-</p><!--l. 5652--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31058"></a> <span
-class="cmtt-10">\glsfirstabbrvemfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5654--><p class="noindent" >
-is used instead. This uses <span
-class="cmtt-10">\glsabbrvemfont </span>by default. The suffix is given
-by
-</p><!--l. 5657--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31059"></a> <span
-class="cmtt-10">\glsxtremsuffix </span></div><hr>
-</p><!--l. 5659--><p class="noindent" >
-which defaults to just <span
-class="cmtt-10">\glsxtrabbrvpluralsuffix</span>. The long form is as for the basic
-style unless the style is a &#8220;long-em&#8221; style.
-</p><!--l. 5664--><p class="indent" > The &#8220;long-em&#8221; (emphasize long) styles, such as <a
-href="#abbrstyle.long-em-short-em"><span
-class="cmss-10">long-em-short-em</span></a><a
- id="dx1-31060"></a> or <a
-href="#abbrstyle.short-em-long-em"><span
-class="cmss-10">short-em-long-em</span></a><a
- id="dx1-31061"></a>,
-use
-</p><!--l. 5666--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31062"></a> <span
-class="cmtt-10">\glsfirstlongemfont{</span>&#x27E8;<span
-class="cmitt-10">long-form</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5668--><p class="noindent" >
-instead of <span
-class="cmtt-10">\glsfirstlongdefaultfont{</span>&#x27E8;<span
-class="cmti-10">long-form</span>&#x27E9;<span
-class="cmtt-10">} </span>and
-
-
-
-</p><!--l. 5670--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31063"></a> <span
-class="cmtt-10">\glslongemfont{</span>&#x27E8;<span
-class="cmitt-10">long-form</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5672--><p class="noindent" >
-instead of <span
-class="cmtt-10">\glslongdefaultfont{</span>&#x27E8;<span
-class="cmti-10">long-form</span>&#x27E9;<span
-class="cmtt-10">}</span>. The first form <span
-class="cmtt-10">\glsfirstlongemfont</span>
-is initialised to use <span
-class="cmtt-10">\glslongemfont</span>.
-</p><!--l. 5676--><p class="indent" > The user styles have similar commands:
-</p><!--l. 5677--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31064"></a> <span
-class="cmtt-10">\glsabbrvuserfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5679--><p class="noindent" >
-for the short form,
-</p><!--l. 5681--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31065"></a> <span
-class="cmtt-10">\glsfirstabbrvuserfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5683--><p class="noindent" >
-for the first use short form,
-</p><!--l. 5685--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31066"></a> <span
-class="cmtt-10">\glslonguserfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5687--><p class="noindent" >
-for the long form,
-</p><!--l. 5689--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31067"></a> <span
-class="cmtt-10">\glsfirstlonguserfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5691--><p class="noindent" >
-for the first use long form, and
-</p><!--l. 5693--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31068"></a> <span
-class="cmtt-10">\glsxtrusersuffix </span></div><hr>
-</p><!--l. 5695--><p class="noindent" >
-for the short plural suffix.
-</p><!--l. 5698--><p class="indent" > Similarly for the hyphen styles:
-</p><!--l. 5699--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31069"></a> <span
-class="cmtt-10">\glsabbrvhyphenfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5701--><p class="noindent" >
-for the short form,
-</p><!--l. 5703--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31070"></a> <span
-class="cmtt-10">\glsfirstabbrvhyphenfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5705--><p class="noindent" >
-for the first use short form,
-</p><!--l. 5707--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31071"></a> <span
-class="cmtt-10">\glslonghyphenfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5709--><p class="noindent" >
-for the long form,
-</p><!--l. 5711--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31072"></a> <span
-class="cmtt-10">\glsfirstlonghyphenfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5713--><p class="noindent" >
-for the first use long form, and
-</p><!--l. 5715--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31073"></a> <span
-class="cmtt-10">\glsxtrhyphensuffix </span></div><hr>
-</p><!--l. 5717--><p class="noindent" >
-for the short plural suffix.
-</p><!--l. 5720--><p class="indent" > Similarly for the &#8220;only&#8221; styles, such as <a
-href="#abbrstyle.long-only-short-only"><span
-class="cmss-10">long-only-short-only</span></a><a
- id="dx1-31074"></a>:
-</p><!--l. 5722--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31075"></a> <span
-class="cmtt-10">\glsabbrvonlyfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5724--><p class="noindent" >
-for the short form,
-</p><!--l. 5726--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31076"></a> <span
-class="cmtt-10">\glsfirstabbrvonlyfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5728--><p class="noindent" >
-for the first use short form,
-</p><!--l. 5730--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31077"></a> <span
-class="cmtt-10">\glslongonlyfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5732--><p class="noindent" >
-for the long form,
-
-
-
-</p><!--l. 5734--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31078"></a> <span
-class="cmtt-10">\glsfirstlongonlyfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5736--><p class="noindent" >
-for the first use long form, and
-</p><!--l. 5738--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31079"></a> <span
-class="cmtt-10">\glsxtronlysuffix </span></div><hr>
-</p><!--l. 5740--><p class="noindent" >
-for the short plural suffix.
-</p><!--l. 5743--><p class="indent" > The &#8220;short-sc-only&#8221; styles, such as <a
-href="#abbrstyle.long-only-short-sc-only"><span
-class="cmss-10">long-only-short-sc-only</span></a><a
- id="dx1-31080"></a>:
-</p><!--l. 5745--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31081"></a> <span
-class="cmtt-10">\glsabbrvsconlyfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5747--><p class="noindent" >
-for the short form (which uses <span
-class="cmtt-10">\glsabbrvscfont</span><a
- id="dx1-31082"></a>), and
-</p><!--l. 5749--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31083"></a> <span
-class="cmtt-10">\glsfirstabbrvsconlyfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5751--><p class="noindent" >
-which uses <span
-class="cmtt-10">\glsabbrvsconlyfont</span><a
- id="dx1-31084"></a>. The short plural suffix is obtained from:
-</p><!--l. 5754--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31085"></a> <span
-class="cmtt-10">\glsxtrsconlysuffix </span></div><hr>
-</p><!--l. 5756--><p class="noindent" >
-This uses <span
-class="cmtt-10">\glsxtrscsuffix</span><a
- id="dx1-31086"></a>. For other font types, use the one of &#8220;short-only&#8221; styles
-and redefine <span
-class="cmtt-10">\glsabbrvonlyfont </span>as required. (The smallcaps style is a special case
-as its plural suffix is awkward.)
-</p><!--l. 5762--><p class="indent" > The &#8220;postshort-sc-user&#8221; styles, such as <a
-href="#abbrstyle.long-postshort-sc-user"><span
-class="cmss-10">long-postshort-sc-user</span></a><a
- id="dx1-31087"></a>:
-</p><!--l. 5764--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31088"></a> <span
-class="cmtt-10">\glsabbrvscuserfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5766--><p class="noindent" >
-for the short form (which uses <span
-class="cmtt-10">\glsabbrvscfont</span><a
- id="dx1-31089"></a>), and
-</p><!--l. 5768--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31090"></a> <span
-class="cmtt-10">\glsfirstabbrvscuserfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5770--><p class="noindent" >
-which uses <span
-class="cmtt-10">\glsabbrvscuserfont</span><a
- id="dx1-31091"></a>. The short plural suffix is obtained from:
-</p><!--l. 5773--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31092"></a> <span
-class="cmtt-10">\glsxtrscusersuffix </span></div><hr>
-</p><!--l. 5775--><p class="noindent" >
-This uses <span
-class="cmtt-10">\glsxtrscsuffix</span><a
- id="dx1-31093"></a>.
-</p><!--l. 5778--><p class="indent" > Note that by default inserted material (provided in the final optional argument of
-commands like <span
-class="cmtt-10">\gls</span>), is placed outside the font command in the predefined styles. To
-move it inside, use:
-</p><!--l. 5781--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31094"></a> <span
-class="cmtt-10">\glsxtrinsertinsidetrue </span></div><hr>
-</p><!--l. 5783--><p class="noindent" >
-This applies to all the predefined styles. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-149">
-\setabbreviationstyle{long-short}
-\renewcommand*{\glsfirstlongdefaultfont}[1]{\emph{#1}}
-\glsxtrinsertinsidetrue
-</pre>
-<!--l. 5789--><p class="nopar" > This will make the long form and the inserted text emphasized, whereas the default
-(without <span
-class="cmtt-10">\glsxtrinsertinsidetrue</span>) would place the inserted text outside of the
-emphasized font.
-</p><!--l. 5794--><p class="indent" > Note that for some styles, such as the <a
-href="#abbrstyle.short-long"><span
-class="cmss-10">short-long</span></a><a
- id="dx1-31095"></a>, the inserted text would be
-placed inside the font command for the short form (rather than the long form in the
-above example).
-</p><!--l. 5798--><p class="indent" > Remember that <span
-class="cmtt-10">\textsc </span>renders <span
-class="cmti-10">lowercase </span>letters as small capitals. Uppercase
-letters are rendered as normal uppercase letters, so if you specify the short form in
-uppercase, you won&#8217;t get small capitals unless you redefine <span
-class="cmtt-10">\glsabbrvscfont </span>to
-convert its argument to lowercase. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-150">
-\renewcommand*{\glsabbrvscfont}[1]{\textsc{\MakeLowercase{#1}}}
-</pre>
-<!--l. 5805--><p class="nopar" >
-</p><!--l. 5807--><p class="indent" > If you want to easily switch between the &#8220;sc&#8221; and &#8220;sm&#8221; styles, you may find it
-easier to redefine this command to convert case:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-151">
-\renewcommand*{\glsabbrvscfont}[1]{\textsc{\MakeTextLowercase{#1}}}
-\renewcommand*{\glsabbrvsmfont}[1]{\textsmaller{\MakeTextUppercase{#1}}}
-</pre>
-<!--l. 5813--><p class="nopar" >
-</p><!--l. 5815--><p class="indent" > Some of the styles use
-</p><!--l. 5816--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31096"></a> <span
-class="cmtt-10">\glsxtrfullsep{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5818--><p class="noindent" >
-as a separator between the long and short forms. This is defined as a space by
-default, but may be changed as required. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-152">
-\renewcommand*{\glsxtrfullsep}[1]{~}
-</pre>
-<!--l. 5823--><p class="nopar" > or
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-153">
-\renewcommand*{\glsxtrfullsep}[1]{\glsacspace{#1}}
-</pre>
-<!--l. 5827--><p class="nopar" >
-</p><!--l. 5829--><p class="indent" > The new naming scheme for abbreviation styles is as follows: </p>
- <ul class="itemize1">
- <li class="itemize">&#x27E8;<span
-class="cmti-10">field1</span>&#x27E9;[<span
-class="cmtt-10">-</span>&#x27E8;<span
-class="cmti-10">modifier1</span>&#x27E9;]<span
-class="cmtt-10">-</span>[post]&#x27E8;<span
-class="cmti-10">field2</span>&#x27E9;[<span
-class="cmtt-10">-</span>&#x27E8;<span
-class="cmti-10">modifier2</span>&#x27E9;][<span
-class="cmtt-10">-user</span>]
- <!--l. 5834--><p class="noindent" >This is for the parenthetical styles. The <span
-class="cmtt-10">-</span>&#x27E8;<span
-class="cmti-10">modifier</span>&#x27E9; parts may be omitted.
- These styles display &#x27E8;<span
-class="cmti-10">field1</span>&#x27E9; followed by &#x27E8;<span
-class="cmti-10">field2</span>&#x27E9; in parentheses. If &#x27E8;<span
-class="cmti-10">field1</span>&#x27E9; or
- &#x27E8;<span
-class="cmti-10">field2</span>&#x27E9; starts with &#8220;no&#8221; then that element is omitted from the display style
- (no parenthetical part) but is included in the inline style.
- </p><!--l. 5840--><p class="noindent" >If the <span
-class="cmtt-10">-</span>&#x27E8;<span
-class="cmti-10">modifier</span>&#x27E9; part is present, then the field has a font changing command
- applied to it. The special modifier <span
-class="cmtt-10">-only </span>indicates that field is only present
- according to whether or not the entry has been used.
- </p><!--l. 5845--><p class="noindent" >If <span
-class="cmtt-10">post </span>is present then &#x27E8;<span
-class="cmti-10">field2</span>&#x27E9; is placed after the <a
- id="dx1-31097"></a><a
-href="#glo:linktext">link-text</a> using the
- post-link hook.
- </p><!--l. 5848--><p class="noindent" >If the <span
-class="cmtt-10">-user </span>part is present, then the <span
-class="cmss-10">user1</span><a
- id="dx1-31098"></a> value, if provided, is inserted
- into the parenthetical material . (The field used for the inserted material
- may be changed.)
- </p><!--l. 5852--><p class="noindent" >Examples: </p>
- <ul class="itemize2">
- <li class="itemize"><a
-href="#abbrstyle.long-noshort-sc"><span
-class="cmss-10">long-noshort-sc</span></a><a
- id="dx1-31099"></a>: &#x27E8;<span
-class="cmti-10">field1</span>&#x27E9; is the long form, the short form is set in
- smallcaps but omitted in the display style.
- </li>
- <li class="itemize"><a
-href="#abbrstyle.long-em-short-em"><span
-class="cmss-10">long-em-short-em</span></a><a
- id="dx1-31100"></a>: both the long form and the short form are
- emphasized. The short form is in parentheses.
- </li>
- <li class="itemize"><a
-href="#abbrstyle.long-short-em"><span
-class="cmss-10">long-short-em</span></a><a
- id="dx1-31101"></a>: the short form is emphasized but not the long form.
- The short form is in parentheses.
- </li>
- <li class="itemize"><a
-href="#abbrstyle.long-short-user"><span
-class="cmss-10">long-short-user</span></a><a
- id="dx1-31102"></a>: if the <span
-class="cmss-10">user1</span><a
- id="dx1-31103"></a> key has been set, this produces the style
- &#x27E8;<span
-class="cmti-10">long</span>&#x27E9; (&#x27E8;<span
-class="cmti-10">short</span>&#x27E9;, &#x27E8;<span
-class="cmti-10">user1</span>&#x27E9;) otherwise it just produces &#x27E8;<span
-class="cmti-10">long</span>&#x27E9; (&#x27E8;<span
-class="cmti-10">short</span>&#x27E9;).
- </li>
- <li class="itemize"><a
-href="#abbrstyle.long-hyphen-postshort-hyphen"><span
-class="cmss-10">long-hyphen-postshort-hyphen</span></a><a
- id="dx1-31104"></a>: the short form and the inserted
- material (provided by the final optional argument of commands like
- <span
-class="cmtt-10">\gls</span>) is moved to the post-link hook. The long form is formatted
- according to <span
-class="cmtt-10">\glslonghyphenfont </span>(or <span
-class="cmtt-10">\glsfirstlonghyphenfont</span>
- on first use). The short form is formatted according to
- <span
-class="cmtt-10">\glsabbrvhyphenfont </span>(or <span
-class="cmtt-10">\glsfirstabbrvhyphenfont </span>on first
- use).</li></ul>
-
-
-
- </li>
- <li class="itemize">&#x27E8;<span
-class="cmti-10">style</span>&#x27E9;<span
-class="cmtt-10">-noreg</span>
- <!--l. 5876--><p class="noindent" >Some styles set the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-31105"></a> attribute. In some cases, there&#8217;s a version of the
- style that doesn&#8217;t set this attribute. For example, <a
-href="#abbrstyle.long-em-noshort-em"><span
-class="cmss-10">long-em-noshort-em</span></a><a
- id="dx1-31106"></a> sets the
- <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-31107"></a> attribute. The <a
-href="#abbrstyle.long-em-noshort-em-noreg"><span
-class="cmss-10">long-em-noshort-em-noreg</span></a><a
- id="dx1-31108"></a> style is a minor variation that
- style that doesn&#8217;t set the attribute.
- </p><!--l. 5883--><p class="noindent" >There are a few &#8220;noshort&#8221; styles, such as <a
-href="#abbrstyle.long-hyphen-noshort-noreg"><span
-class="cmss-10">long-hyphen-noshort-noreg</span></a><a
- id="dx1-31109"></a>, that have
- &#8220;-noreg&#8221; version without a regular version. This is because the style won&#8217;t work
- properly with the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-31110"></a> set, but the naming scheme is maintained for
- consistency with the other &#8220;noshort&#8221; styles.
- </p></li>
- <li class="itemize">&#x27E8;<span
-class="cmti-10">field1</span>&#x27E9;[<span
-class="cmtt-10">-</span>&#x27E8;<span
-class="cmti-10">modifier1</span>&#x27E9;]<span
-class="cmtt-10">-</span>[<span
-class="cmtt-10">post</span>]<span
-class="cmtt-10">footnote</span>
- <!--l. 5893--><p class="noindent" >The display style uses &#x27E8;<span
-class="cmti-10">field1</span>&#x27E9; followed by a footnote with the other field in it. If
- <span
-class="cmtt-10">post </span>is present then the footnote is placed after the <a
- id="dx1-31111"></a><a
-href="#glo:linktext">link-text</a> using the
- post-link hook. The inline style does &#x27E8;<span
-class="cmti-10">field1</span>&#x27E9; followed by the other field in
- parentheses.
- </p><!--l. 5899--><p class="noindent" >If <span
-class="cmtt-10">-</span>&#x27E8;<span
-class="cmti-10">modifier1</span>&#x27E9; is present, &#x27E8;<span
-class="cmti-10">field1</span>&#x27E9; has a font-changing command applied to
- it.
- </p><!--l. 5902--><p class="noindent" >Examples: </p>
- <ul class="itemize2">
- <li class="itemize"><a
-href="#abbrstyle.short-footnote"><span
-class="cmss-10">short-footnote</span></a><a
- id="dx1-31112"></a>: short form in the text with the long form in the
- footnote.
- </li>
- <li class="itemize"><a
-href="#abbrstyle.short-sc-postfootnote"><span
-class="cmss-10">short-sc-postfootnote</span></a><a
- id="dx1-31113"></a>: short form in smallcaps with the long form in
- the footnote outside of the <a
- id="dx1-31114"></a>link-text.</li></ul>
- <!--l. 5910--><p class="noindent" ><div class="important" title="Important Note"> Take care with the footnote styles. Remember that there are some situations
- where <span
-class="cmtt-10">\footnote</span><a
- id="dx1-31115"></a> doesn&#8217;t work. </div>
- </p><!--l. 5913--><p class="noindent" >
- </p></li>
- <li class="itemize">&#x27E8;<span
-class="cmti-10">style</span>&#x27E9;<span
-class="cmtt-10">-desc</span>
- <!--l. 5917--><p class="noindent" >Like &#x27E8;<span
-class="cmti-10">style</span>&#x27E9; but the <span
-class="cmss-10">description</span><a
- id="dx1-31116"></a> key must be provided when defining abbreviations
- with this style.
- </p><!--l. 5920--><p class="noindent" >Examples: </p>
- <ul class="itemize2">
- <li class="itemize"><a
-href="#abbrstyle.short-long-desc"><span
-class="cmss-10">short-long-desc</span></a><a
- id="dx1-31117"></a>: like <a
-href="#abbrstyle.short-long"><span
-class="cmss-10">short-long</span></a><a
- id="dx1-31118"></a> but requires a description.
- </li>
- <li class="itemize"><a
-href="#abbrstyle.short-em-footnote-desc"><span
-class="cmss-10">short-em-footnote-desc</span></a><a
- id="dx1-31119"></a>: like <a
-href="#abbrstyle.short-em-footnote"><span
-class="cmss-10">short-em-footnote</span></a><a
- id="dx1-31120"></a> but requires a
- description.</li></ul>
-
-
-
- </li></ul>
-<!--l. 5930--><p class="indent" > Not all combinations that fit the above syntax are provided. Pre-version 1.04
-styles that didn&#8217;t fit this naming scheme are either provided with a synonym (where
-the former name wasn&#8217;t ambiguous) or provided with a deprecated synonym (where
-the former name was confusing). The deprecated style names generate a warning
-using:
-</p><!--l. 5936--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-31121"></a> <span
-class="cmtt-10">\GlsXtrWarnDeprecatedAbbrStyle{</span>&#x27E8;<span
-class="cmitt-10">old-name</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">new-name</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 5938--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">old-name</span>&#x27E9; is the deprecated name and &#x27E8;<span
-class="cmti-10">new-name</span>&#x27E9; is the preferred name. You
-can suppress these warnings by redefining this command to do nothing.
-</p><!--l. 5944--><p class="noindent" >
-</p>
-<!--l. 5944--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">4.4.1 </span> <a
- id="sec:predefregabbrvstyles"></a>Predefined Abbreviation Styles that Set the Regular Attribute</h4>
-<!--l. 5947--><p class="noindent" >The following abbreviation styles set the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-32001"></a> attribute to &#8220;true&#8221; for all categories
-that have abbreviations defined with any of these styles.
- </p><dl class="description"><dt class="description">
-<a
- id="abbrstyle.short-nolong"></a><span
-class="cmssbx-10">short-nolong</span><a
- id="dx1-32002"></a> </dt><dd
-class="description">This only displays the short form on <a
- id="dx1-32003"></a><a
-href="#glo:firstuse">first use</a>. The <span
-class="cmss-10">name</span><a
- id="dx1-32004"></a> is set to the
- short form through the command
- <!--l. 5955--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-32005"></a> <span
-class="cmtt-10">\glsxtrshortnolongname </span></div><hr>
- </p><!--l. 5957--><p class="noindent" >
- (Similarly for the other <span
-class="cmtt-10">short</span>&#x27E8;<span
-class="cmti-10">modifier</span>&#x27E9;<span
-class="cmtt-10">-nolong</span>&#x27E8;<span
-class="cmti-10">modifier</span>&#x27E9; styles, unless indicated
- otherwise.) This command is expanded as the entry is defined, so any
- redefinition must be done before <span
-class="cmtt-10">\newabbreviation </span>(or <span
-class="cmtt-10">\newacronym</span>) for it to
- take effect. Make sure to <span
-class="cmtt-10">\protect </span>any formatting commands (or anything else
- that shouldn&#8217;t be expanded).
- </p><!--l. 5966--><p class="noindent" >The <span
-class="cmss-10">description</span><a
- id="dx1-32006"></a> is set to the long form. The inline full form displays &#x27E8;<span
-class="cmti-10">short</span>&#x27E9;
- (&#x27E8;<span
-class="cmti-10">long</span>&#x27E9;). The long form on its own can be displayed through commands like
- <span
-class="cmtt-10">\glsxtrlong</span><a
- id="dx1-32007"></a>.
- </p></dd><dt class="description">
-<a
- id="abbrstyle.short"></a><span
-class="cmssbx-10">short</span><a
- id="dx1-32008"></a> </dt><dd
-class="description">A synonym for <a
-href="#abbrstyle.short-nolong"><span
-class="cmss-10">short-nolong</span></a><a
- id="dx1-32009"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.nolong-short"></a><span
-class="cmssbx-10">nolong-short</span><a
- id="dx1-32010"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-nolong"><span
-class="cmss-10">short-nolong</span></a><a
- id="dx1-32011"></a> but the inline full form displays &#x27E8;<span
-class="cmti-10">long</span>&#x27E9; (&#x27E8;<span
-class="cmti-10">short</span>&#x27E9;).
- </dd><dt class="description">
-<a
- id="abbrstyle.short-sc-nolong"></a><span
-class="cmssbx-10">short-sc-nolong</span><a
- id="dx1-32012"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-nolong"><span
-class="cmss-10">short-nolong</span></a><a
- id="dx1-32013"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvscfont</span><a
- id="dx1-32014"></a> (which defaults to <span
-class="cmtt-10">\textsc</span>).
- </dd><dt class="description">
-<a
- id="abbrstyle.short-sc"></a><span
-class="cmssbx-10">short-sc</span><a
- id="dx1-32015"></a> </dt><dd
-class="description">A synonym for <a
-href="#abbrstyle.short-sc-nolong"><span
-class="cmss-10">short-sc-nolong</span></a><a
- id="dx1-32016"></a>
-
-
-
- </dd><dt class="description">
-<a
- id="abbrstyle.nolong-short-sc"></a><span
-class="cmssbx-10">nolong-short-sc</span><a
- id="dx1-32017"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-sc-nolong"><span
-class="cmss-10">short-sc-nolong</span></a><a
- id="dx1-32018"></a> but the inline full form displays &#x27E8;<span
-class="cmti-10">long</span>&#x27E9; (&#x27E8;<span
-class="cmti-10">short</span>&#x27E9;).
- The name is still obtained from <span
-class="cmtt-10">\glsxtrshortnolongname </span>(similarly for the
- other styles in the form <span
-class="cmtt-10">nolong</span>&#x27E8;<span
-class="cmti-10">modifier</span>&#x27E9;<span
-class="cmtt-10">-short</span>&#x27E8;<span
-class="cmti-10">modifier</span>&#x27E9; unless indicated
- otherwise).
- </dd><dt class="description">
-<a
- id="abbrstyle.short-sm-nolong"></a><span
-class="cmssbx-10">short-sm-nolong</span><a
- id="dx1-32019"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-nolong"><span
-class="cmss-10">short-nolong</span></a><a
- id="dx1-32020"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvsmfont</span><a
- id="dx1-32021"></a> (which defaults to <span
-class="cmtt-10">\textsmaller</span>).
- </dd><dt class="description">
-<a
- id="abbrstyle.short-sm"></a><span
-class="cmssbx-10">short-sm</span><a
- id="dx1-32022"></a> </dt><dd
-class="description">A synonym for <a
-href="#abbrstyle.short-sm-nolong"><span
-class="cmss-10">short-sm-nolong</span></a><a
- id="dx1-32023"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.nolong-short-sm"></a><span
-class="cmssbx-10">nolong-short-sm</span><a
- id="dx1-32024"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-sm-nolong"><span
-class="cmss-10">short-sm-nolong</span></a><a
- id="dx1-32025"></a> but the inline full form displays &#x27E8;<span
-class="cmti-10">long</span>&#x27E9;
- (&#x27E8;<span
-class="cmti-10">short</span>&#x27E9;).
- </dd><dt class="description">
-<a
- id="abbrstyle.short-em-nolong"></a><span
-class="cmssbx-10">short-em-nolong</span><a
- id="dx1-32026"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-nolong"><span
-class="cmss-10">short-nolong</span></a><a
- id="dx1-32027"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvemfont</span><a
- id="dx1-32028"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-em"></a><span
-class="cmssbx-10">short-em</span><a
- id="dx1-32029"></a> </dt><dd
-class="description">A synonym for <a
-href="#abbrstyle.short-em-nolong"><span
-class="cmss-10">short-em-nolong</span></a><a
- id="dx1-32030"></a>
- </dd><dt class="description">
-<a
- id="abbrstyle.nolong-short-em"></a><span
-class="cmssbx-10">nolong-short-em</span><a
- id="dx1-32031"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-em-nolong"><span
-class="cmss-10">short-em-nolong</span></a><a
- id="dx1-32032"></a> but the inline full form displays &#x27E8;<span
-class="cmti-10">long</span>&#x27E9;
- (&#x27E8;<span
-class="cmti-10">short</span>&#x27E9;).
- </dd><dt class="description">
-<a
- id="abbrstyle.short-nolong-desc"></a><span
-class="cmssbx-10">short-nolong-desc</span><a
- id="dx1-32033"></a> </dt><dd
-class="description">Like the <a
-href="#abbrstyle.short-nolong"><span
-class="cmss-10">short-nolong</span></a><a
- id="dx1-32034"></a> style, but the <span
-class="cmss-10">name</span><a
- id="dx1-32035"></a> is set to the full form
- obtained by expanding
- <!--l. 6013--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-32036"></a> <span
-class="cmtt-10">\glsxtrshortdescname </span></div><hr>
- </p><!--l. 6015--><p class="noindent" >
- (Similarly for the other <span
-class="cmtt-10">short</span>&#x27E8;<span
-class="cmti-10">modifier</span>&#x27E9;<span
-class="cmtt-10">-nolong</span>&#x27E8;<span
-class="cmti-10">modifier</span>&#x27E9;<span
-class="cmtt-10">-desc </span>styles, unless
- indicated otherwise.) This command is expanded when the entry is defined, so
- <span
-class="cmtt-10">\protect </span>fragile and formatting commands and only redefine this command
- before <span
-class="cmtt-10">\newabbreviation </span>(or <span
-class="cmtt-10">\newacronym</span>).
- </p><!--l. 6022--><p class="noindent" >The <span
-class="cmss-10">description</span><a
- id="dx1-32037"></a> must be supplied by the user. You may prefer to use
- the <a
-href="#abbrstyle.short-nolong"><span
-class="cmss-10">short-nolong</span></a><a
- id="dx1-32038"></a> style with the post-description hook set to display
- the long form and override the <span
-class="cmss-10">description</span><a
- id="dx1-32039"></a> key. (See the sample file
- <span
-class="cmtt-10">sample-acronym-desc.tex</span>.)
- </p></dd><dt class="description">
-<a
- id="abbrstyle.short-desc"></a><span
-class="cmssbx-10">short-desc</span><a
- id="dx1-32040"></a> </dt><dd
-class="description">A synonym for <a
-href="#abbrstyle.short-nolong-desc"><span
-class="cmss-10">short-nolong-desc</span></a><a
- id="dx1-32041"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-sc-nolong-desc"></a><span
-class="cmssbx-10">short-sc-nolong-desc</span><a
- id="dx1-32042"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-nolong"><span
-class="cmss-10">short-nolong</span></a><a
- id="dx1-32043"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvscfont</span><a
- id="dx1-32044"></a> (which defaults to <span
-class="cmtt-10">\textsc</span>).
-
-
-
- </dd><dt class="description">
-<a
- id="abbrstyle.short-sc-desc"></a><span
-class="cmssbx-10">short-sc-desc</span><a
- id="dx1-32045"></a> </dt><dd
-class="description">A synonym for <a
-href="#abbrstyle.short-sc-nolong-desc"><span
-class="cmss-10">short-sc-nolong-desc</span></a><a
- id="dx1-32046"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-sm-nolong-desc"></a><span
-class="cmssbx-10">short-sm-nolong-desc</span><a
- id="dx1-32047"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-nolong-desc"><span
-class="cmss-10">short-nolong-desc</span></a><a
- id="dx1-32048"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvsmfont</span><a
- id="dx1-32049"></a> (which defaults to <span
-class="cmtt-10">\textsmaller</span>).
- </dd><dt class="description">
-<a
- id="abbrstyle.short-sm-desc"></a><span
-class="cmssbx-10">short-sm-desc</span><a
- id="dx1-32050"></a> </dt><dd
-class="description">A synonym for <a
-href="#abbrstyle.short-sm-nolong-desc"><span
-class="cmss-10">short-sm-nolong-desc</span></a><a
- id="dx1-32051"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-em-nolong-desc"></a><span
-class="cmssbx-10">short-em-nolong-desc</span><a
- id="dx1-32052"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-nolong-desc"><span
-class="cmss-10">short-nolong-desc</span></a><a
- id="dx1-32053"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvemfont</span><a
- id="dx1-32054"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-em-desc"></a><span
-class="cmssbx-10">short-em-desc</span><a
- id="dx1-32055"></a> </dt><dd
-class="description">A synonym for <a
-href="#abbrstyle.short-em-nolong-desc"><span
-class="cmss-10">short-em-nolong-desc</span></a><a
- id="dx1-32056"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.long-noshort-desc"></a><span
-class="cmssbx-10">long-noshort-desc</span><a
- id="dx1-32057"></a> </dt><dd
-class="description">This style only displays the long form, regardless of first or
- subsequent use of commands <span
-class="cmtt-10">\gls</span><a
- id="dx1-32058"></a>. The short form may be accessed
- through commands like <span
-class="cmtt-10">\glsxtrshort</span><a
- id="dx1-32059"></a>. The inline full form displays &#x27E8;<span
-class="cmti-10">long</span>&#x27E9;
- (&#x27E8;<span
-class="cmti-10">short</span>&#x27E9;).
- <!--l. 6058--><p class="noindent" >The <span
-class="cmss-10">sort</span><a
- id="dx1-32060"></a> key are set to the long form. The <span
-class="cmss-10">name</span><a
- id="dx1-32061"></a> key is also set to the long form,
- but this is done by expanding
- </p><!--l. 6061--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-32062"></a> <span
-class="cmtt-10">\glsxtrlongnoshortdescname </span></div><hr>
- </p><!--l. 6063--><p class="noindent" >
- (Similarly for the other <span
-class="cmtt-10">long</span>&#x27E8;<span
-class="cmti-10">modifier</span>&#x27E9;<span
-class="cmtt-10">-noshort</span>&#x27E8;<span
-class="cmti-10">modifier</span>&#x27E9;<span
-class="cmtt-10">-desc </span>styles, unless
- indicated otherwise.) This command should only be redefined before
- abbreviations are defined, and any fragile or formatting commands within it
- need protecting.
- </p><!--l. 6069--><p class="noindent" >The <span
-class="cmss-10">description</span><a
- id="dx1-32063"></a> must be provided by the user. The predefined glossary styles
- won&#8217;t display the short form. You can use the post-description hook to
- automatically append the short form to the description. The inline full form
- will display &#x27E8;<span
-class="cmti-10">long</span>&#x27E9; (&#x27E8;<span
-class="cmti-10">short</span>&#x27E9;).
- </p></dd><dt class="description">
-<a
- id="abbrstyle.long-desc"></a><span
-class="cmssbx-10">long-desc</span><a
- id="dx1-32064"></a> </dt><dd
-class="description">A synonym for <a
-href="#abbrstyle.long-noshort-desc"><span
-class="cmss-10">long-noshort-desc</span></a><a
- id="dx1-32065"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.long-noshort-sc-desc"></a><span
-class="cmssbx-10">long-noshort-sc-desc</span><a
- id="dx1-32066"></a> </dt><dd
-class="description">Like the <a
-href="#abbrstyle.long-noshort-desc"><span
-class="cmss-10">long-noshort-desc</span></a><a
- id="dx1-32067"></a> style but the short form (accessed
- through commands like <span
-class="cmtt-10">\glsxtrshort</span><a
- id="dx1-32068"></a>) use <span
-class="cmtt-10">\glsabbrvscfont</span><a
- id="dx1-32069"></a>. (This style was
- originally called <span
-class="cmss-10">long-desc-sc</span><a
- id="dx1-32070"></a>. Renamed in version 1.04, but original name
- retained as a deprecated synonym for backward-compatibility.)
- </dd><dt class="description">
-<a
- id="abbrstyle.long-noshort-sm-desc"></a><span
-class="cmssbx-10">long-noshort-sm-desc</span><a
- id="dx1-32071"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.long-noshort-desc"><span
-class="cmss-10">long-noshort-desc</span></a><a
- id="dx1-32072"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvsmfont</span><a
- id="dx1-32073"></a>. (This style was originally called <span
-class="cmss-10">long-desc-sm</span><a
- id="dx1-32074"></a>. Renamed in
- version 1.04, but original name retained as a deprecated synonym for
- backward-compatibility.)
-
-
-
- </dd><dt class="description">
-<a
- id="abbrstyle.long-noshort-em-desc"></a><span
-class="cmssbx-10">long-noshort-em-desc</span><a
- id="dx1-32075"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.long-noshort-desc"><span
-class="cmss-10">long-noshort-desc</span></a><a
- id="dx1-32076"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvemfont</span><a
- id="dx1-32077"></a>. The long form isn&#8217;t emphasized. (This style was originally
- called <span
-class="cmss-10">long-desc-em</span><a
- id="dx1-32078"></a>. Renamed in version 1.04, but original name retained as a
- deprecated synonym for backward-compatibility.)
- </dd><dt class="description">
-<a
- id="abbrstyle.long-em-noshort-em-desc"></a><span
-class="cmssbx-10">long-em-noshort-em-desc</span><a
- id="dx1-32079"></a> </dt><dd
-class="description">New to version 1.04, like <a
-href="#abbrstyle.long-noshort-desc"><span
-class="cmss-10">long-noshort-desc</span></a><a
- id="dx1-32080"></a> but
- redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use <span
-class="cmtt-10">\glsabbrvemfont</span><a
- id="dx1-32081"></a>. The long form uses
- <span
-class="cmtt-10">\glsfirstlongemfont</span><a
- id="dx1-32082"></a> and <span
-class="cmtt-10">\glslongemfont</span><a
- id="dx1-32083"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.long-noshort"></a><span
-class="cmssbx-10">long-noshort</span><a
- id="dx1-32084"></a> </dt><dd
-class="description">This style doesn&#8217;t really make sense if you don&#8217;t use the short form
- anywhere in the document, but is provided for completeness. This is
- like the <a
-href="#abbrstyle.long-noshort-desc"><span
-class="cmss-10">long-noshort-desc</span></a><a
- id="dx1-32085"></a> style, but the <span
-class="cmss-10">sort</span><a
- id="dx1-32086"></a> key is set to the short
- form. The <span
-class="cmss-10">name</span><a
- id="dx1-32087"></a> key is also set to the short form, but this is done by
- expanding
- <!--l. 6110--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-32088"></a> <span
-class="cmtt-10">\glsxtrlongnoshortname </span></div><hr>
- </p><!--l. 6112--><p class="noindent" >
- (Similarly for other <span
-class="cmtt-10">long</span>&#x27E8;<span
-class="cmti-10">modifier</span>&#x27E9;<span
-class="cmtt-10">-noshort</span>&#x27E8;<span
-class="cmti-10">modifier</span>&#x27E9; styles, unless indicated
- otherwise.) This command should only be redefined before abbreviations are
- defined, and fragile or formatting commands should be protected.
- </p><!--l. 6119--><p class="noindent" >The <span
-class="cmss-10">description</span><a
- id="dx1-32089"></a> is set to the long form.
- </p></dd><dt class="description">
-<a
- id="abbrstyle.long"></a><span
-class="cmssbx-10">long</span><a
- id="dx1-32090"></a> </dt><dd
-class="description">A synonym for <a
-href="#abbrstyle.long-noshort"><span
-class="cmss-10">long-noshort</span></a><a
- id="dx1-32091"></a>
- </dd><dt class="description">
-<a
- id="abbrstyle.long-noshort-sc"></a><span
-class="cmssbx-10">long-noshort-sc</span><a
- id="dx1-32092"></a> </dt><dd
-class="description">Like the <a
-href="#abbrstyle.long-noshort"><span
-class="cmss-10">long-noshort</span></a><a
- id="dx1-32093"></a> style but the short form (accessed through
- commands like <span
-class="cmtt-10">\glsxtrshort</span><a
- id="dx1-32094"></a>) use <span
-class="cmtt-10">\glsabbrvscfont</span><a
- id="dx1-32095"></a>. (This style was originally
- called <span
-class="cmss-10">long-sc</span><a
- id="dx1-32096"></a>. Renamed in version 1.04, but original name retained as a
- deprecated synonym for backward-compatibility.)
- </dd><dt class="description">
-<a
- id="abbrstyle.long-noshort-sm"></a><span
-class="cmssbx-10">long-noshort-sm</span><a
- id="dx1-32097"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.long-noshort"><span
-class="cmss-10">long-noshort</span></a><a
- id="dx1-32098"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvsmfont</span><a
- id="dx1-32099"></a>. (This style was originally called <span
-class="cmss-10">long-sm</span><a
- id="dx1-32100"></a>. Renamed in
- version 1.04, but original name retained as a deprecated synonym for
- backward-compatibility.)
- </dd><dt class="description">
-<a
- id="abbrstyle.long-noshort-em"></a><span
-class="cmssbx-10">long-noshort-em</span><a
- id="dx1-32101"></a> </dt><dd
-class="description">This style is like <a
-href="#abbrstyle.long-noshort"><span
-class="cmss-10">long-noshort</span></a><a
- id="dx1-32102"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvemfont</span><a
- id="dx1-32103"></a>. The long form isn&#8217;t emphasized. (This style was originally
- called <span
-class="cmss-10">long-em</span><a
- id="dx1-32104"></a>. Renamed in version 1.04, but original name retained as a
- deprecated synonym for backward-compatibility.)
- </dd><dt class="description">
-<a
- id="abbrstyle.long-em-noshort-em"></a><span
-class="cmssbx-10">long-em-noshort-em</span><a
- id="dx1-32105"></a> </dt><dd
-class="description">New to version 1.04, this style is like <a
-href="#abbrstyle.long-noshort"><span
-class="cmss-10">long-noshort</span></a><a
- id="dx1-32106"></a> but redefines
-
-
-
- <span
-class="cmtt-10">\glsabbrvfont </span>to use <span
-class="cmtt-10">\glsabbrvemfont</span><a
- id="dx1-32107"></a>, <span
-class="cmtt-10">\glsfirstlongfont </span>to use
- <span
-class="cmtt-10">\glsfirstlongemfont </span>and <span
-class="cmtt-10">\glslongfont </span>to use <span
-class="cmtt-10">\glslongemfont</span>. The short
- form isn&#8217;t used by commands like <span
-class="cmtt-10">\gls</span><a
- id="dx1-32108"></a>, but can be obtained using
- <span
-class="cmtt-10">\glsxtrshort</span><a
- id="dx1-32109"></a>. The related style <a
- id="abbrstyle.long-em-noshort-em-noreg"></a><span
-class="cmss-10">long-em-noshort-em-noreg</span><a
- id="dx1-32110"></a> doesn&#8217;t set the
- <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-32111"></a> attribute.
- </dd></dl>
-<!--l. 6156--><p class="noindent" >
-</p>
-<!--l. 6156--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">4.4.2 </span> <a
- id="sec:predefnonregabbrvstyles"></a>Predefined Abbreviation Styles that Don&#8217;t Set the Regular Attribute</h4>
-<!--l. 6159--><p class="noindent" >The following abbreviation styles will set the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-33001"></a> attribute to &#8220;false&#8221; if it has
-previously been set. If it hasn&#8217;t already been set, it&#8217;s left unset. Other attributes may
-also be set, depending on the style.
- </p><dl class="description"><dt class="description">
-<a
- id="abbrstyle.long-short"></a><span
-class="cmssbx-10">long-short</span><a
- id="dx1-33002"></a> </dt><dd
-class="description">On <a
- id="dx1-33003"></a><a
-href="#glo:firstuse">first use</a>, this style uses the format &#x27E8;<span
-class="cmti-10">long</span>&#x27E9; (&#x27E8;<span
-class="cmti-10">short</span>&#x27E9;). The inline and
- display full forms are the same. The <span
-class="cmss-10">sort</span><a
- id="dx1-33004"></a> key is set to the short form. The <span
-class="cmss-10">name</span><a
- id="dx1-33005"></a>
- is also set to the short form through
- <!--l. 6170--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33006"></a> <span
-class="cmtt-10">\glsxtrlongshortname </span></div><hr>
- </p><!--l. 6172--><p class="noindent" >
- (Similarly for other <span
-class="cmtt-10">long</span>&#x27E8;<span
-class="cmti-10">modifier</span>&#x27E9;<span
-class="cmtt-10">-short</span>&#x27E8;<span
-class="cmti-10">modifier</span>&#x27E9; styles, unless indicated
- otherwise.) Any redefinition of this command must come before the
- abbreviations are defined as it expands on definition. Make sure you protect
- any commands that shouldn&#8217;t be expanded. The long form can be referenced
- with <span
-class="cmtt-10">\the\glslongtok </span>and the short form can be referenced with
- <span
-class="cmtt-10">\the\glsshorttok</span>.
- </p><!--l. 6182--><p class="noindent" >The <span
-class="cmss-10">description</span><a
- id="dx1-33007"></a> is set to the long form. The long and short forms are separated
- by <span
-class="cmtt-10">\glsxtrfullsep</span>. If you want to insert material within the parentheses
- (such as a&#x00A0;translation), try the <a
-href="#abbrstyle.long-short-user"><span
-class="cmss-10">long-short-user</span></a><a
- id="dx1-33008"></a> style.
- </p></dd><dt class="description">
-<a
- id="abbrstyle.long-short-sc"></a><span
-class="cmssbx-10">long-short-sc</span><a
- id="dx1-33009"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.long-short"><span
-class="cmss-10">long-short</span></a><a
- id="dx1-33010"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use <span
-class="cmtt-10">\glsabbrvscfont</span><a
- id="dx1-33011"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.long-short-sm"></a><span
-class="cmssbx-10">long-short-sm</span><a
- id="dx1-33012"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.long-short"><span
-class="cmss-10">long-short</span></a><a
- id="dx1-33013"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use <span
-class="cmtt-10">\glsabbrvsmfont</span><a
- id="dx1-33014"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.long-short-em"></a><span
-class="cmssbx-10">long-short-em</span><a
- id="dx1-33015"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.long-short"><span
-class="cmss-10">long-short</span></a><a
- id="dx1-33016"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use <span
-class="cmtt-10">\glsabbrvemfont</span><a
- id="dx1-33017"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.long-em-short-em"></a><span
-class="cmssbx-10">long-em-short-em</span><a
- id="dx1-33018"></a> </dt><dd
-class="description">New to version 1.04, this style is like <a
-href="#abbrstyle.long-short-em"><span
-class="cmss-10">long-short-em</span></a><a
- id="dx1-33019"></a> but redefines
- <span
-class="cmtt-10">\glsfirstlongfont </span>to use <span
-class="cmtt-10">\glsfirstlongemfont</span><a
- id="dx1-33020"></a>.
-
-
-
- </dd><dt class="description">
-<a
- id="abbrstyle.long-only-short-only"></a><span
-class="cmssbx-10">long-only-short-only</span><a
- id="dx1-33021"></a> </dt><dd
-class="description">New to version 1.17, this style only shows the long form on first
- use and only shows the short form on subsequent use. The inline full form
- <span
-class="cmtt-10">\glsxtrfull </span>shows the long form followed by the short form in parentheses.
- The <span
-class="cmss-10">name</span><a
- id="dx1-33022"></a> field is obtained from
- <!--l. 6209--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33023"></a> <span
-class="cmtt-10">\glsxtronlyname </span></div><hr>
- </p><!--l. 6211--><p class="noindent" >
- Any redefinition of this command must come before the abbreviations
- are defined as it expands on definition. Make sure you protect any
- commands that shouldn&#8217;t be expanded. The long form can be referenced
- with <span
-class="cmtt-10">\the\glslongtok </span>and the short form can be referenced with
- <span
-class="cmtt-10">\the\glsshorttok</span>.
- </p></dd><dt class="description">
-<a
- id="abbrstyle.long-only-short-sc-only"></a><span
-class="cmssbx-10">long-only-short-sc-only</span><a
- id="dx1-33024"></a> </dt><dd
-class="description">
- <!--l. 6220--><p class="noindent" >New to version 1.48, this is like <a
-href="#abbrstyle.long-only-short-only"><span
-class="cmss-10">long-only-short-only</span></a><a
- id="dx1-33025"></a> but uses smallcaps for the
- short form. The name is obtained from:
- </p><!--l. 6222--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33026"></a> <span
-class="cmtt-10">\glsxtrsconlyname </span></div><hr>
- </p><!--l. 6224--><p class="noindent" >
- </p></dd><dt class="description">
-<a
- id="abbrstyle.long-only-short-only-desc"></a><span
-class="cmssbx-10">long-only-short-only-desc</span><a
- id="dx1-33027"></a> </dt><dd
-class="description">New to version 1.17, this style is like <a
-href="#abbrstyle.long-only-short-only"><span
-class="cmss-10">long-only-short-only</span></a><a
- id="dx1-33028"></a>
- but the user must supply the description. The <span
-class="cmss-10">name</span><a
- id="dx1-33029"></a> field is obtained
- from
- <!--l. 6230--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33030"></a> <span
-class="cmtt-10">\glsxtronlydescname </span></div><hr>
- </p><!--l. 6232--><p class="noindent" >
- The sort value is obtained from:
- </p><!--l. 6234--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33031"></a> <span
-class="cmtt-10">\glsxtronlydescsort </span></div><hr>
- </p><!--l. 6236--><p class="noindent" >
- </p><!--l. 6238--><p class="noindent" >Any redefinition of these commands must come before the abbreviations
- are defined as it expands on definition. Make sure you protect any
- commands that shouldn&#8217;t be expanded. The long form can be referenced
- with <span
-class="cmtt-10">\the\glslongtok </span>and the short form can be referenced with
- <span
-class="cmtt-10">\the\glsshorttok</span>.
- </p></dd><dt class="description">
-<a
- id="abbrstyle.long-only-short-sc-only-desc"></a><span
-class="cmssbx-10">long-only-short-sc-only-desc</span><a
- id="dx1-33032"></a> </dt><dd
-class="description">New to version 1.48, this style is like
- <a
-href="#abbrstyle.long-only-short-only-desc"><span
-class="cmss-10">long-only-short-only-desc</span></a><a
- id="dx1-33033"></a> but it uses smallcaps for the short form. The name is
- obtained from:
- <!--l. 6249--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33034"></a> <span
-class="cmtt-10">\glsxtrsconlydescname </span></div><hr>
-
-
-
- </p><!--l. 6251--><p class="noindent" >
- This defaults to <span
-class="cmtt-10">\glsxtronlydescname</span>.
- </p><!--l. 6254--><p class="noindent" >The sort value is obtained from:
- </p><!--l. 6255--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33035"></a> <span
-class="cmtt-10">\glsxtrsconlydescsort </span></div><hr>
- </p><!--l. 6257--><p class="noindent" >
- This defaults to <span
-class="cmtt-10">\glsxtronlydescsort</span>.
- </p></dd><dt class="description">
-<a
- id="abbrstyle.long-em-noshort-em-noreg"></a><span
-class="cmssbx-10">long-em-noshort-em-noreg</span><a
- id="dx1-33036"></a> </dt><dd
-class="description">New to version 1.17, this style is like <a
-href="#abbrstyle.long-em-noshort-em"><span
-class="cmss-10">long-em-noshort-em</span></a><a
- id="dx1-33037"></a>
- but doesn&#8217;t set the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-33038"></a> attribute.
- </dd><dt class="description">
-<a
- id="abbrstyle.long-short-user"></a><span
-class="cmssbx-10">long-short-user</span><a
- id="dx1-33039"></a> </dt><dd
-class="description">This style was introduced in version 1.04. It&#8217;s like the <a
-href="#abbrstyle.long-short"><span
-class="cmss-10">long-short</span></a><a
- id="dx1-33040"></a> style
- but additional information can be inserted into the parenthetical material. This
- checks the value of the field given by
- <!--l. 6270--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33041"></a> <span
-class="cmtt-10">\glsxtruserfield </span></div><hr>
- </p><!--l. 6272--><p class="noindent" >
- (which defaults to <span
-class="cmtt-10">useri</span>) using <span
-class="cmtt-10">\ifglshasfield</span><a
- id="dx1-33042"></a> (provided by <span
-class="cmss-10">glossaries</span>). If the
- field hasn&#8217;t been set, the style behaves like the <a
-href="#abbrstyle.long-short"><span
-class="cmss-10">long-short</span></a><a
- id="dx1-33043"></a> style and produces
- &#x27E8;<span
-class="cmti-10">long</span>&#x27E9; (&#x27E8;<span
-class="cmti-10">short</span>&#x27E9;) but if the field has been set, the contents of that field are inserted
- within the parentheses in the form &#x27E8;<span
-class="cmti-10">long</span>&#x27E9; (&#x27E8;<span
-class="cmti-10">short</span>&#x27E9;, &#x27E8;<span
-class="cmti-10">field-value</span>&#x27E9;). The format is
- governed by
- </p><!--l. 6280--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33044"></a> <span
-class="cmtt-10">\glsxtruserparen{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
- </p><!--l. 6282--><p class="noindent" >
- where &#x27E8;<span
-class="cmti-10">text</span>&#x27E9; is the short form (for the <a
-href="#abbrstyle.long-short-user"><span
-class="cmss-10">long-short-user</span></a><a
- id="dx1-33045"></a> style) or the long form (for
- the <a
-href="#abbrstyle.short-long-user"><span
-class="cmss-10">short-long-user</span></a><a
- id="dx1-33046"></a> style). This command first inserts a space using
- <span
-class="cmtt-10">\glsxtrfullsep </span>and then the parenthetical content (using <span
-class="cmtt-10">\glsxtrparen</span><a
- id="dx1-33047"></a>).
- The <span
-class="cmss-10">description</span><a
- id="dx1-33048"></a> is set to
- </p><!--l. 6289--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33049"></a> <span
-class="cmtt-10">\glsuserdescription{</span>&#x27E8;<span
-class="cmitt-10">long</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
- </p><!--l. 6291--><p class="noindent" >
- The default definition ignores the &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; and encapsulates &#x27E8;<span
-class="cmti-10">long</span>&#x27E9; with
- <span
-class="cmtt-10">\glslonguserfont</span>.
- </p><!--l. 6295--><p class="noindent" >The <span
-class="cmss-10">name</span><a
- id="dx1-33050"></a> is obtained by expanding <span
-class="cmtt-10">\glsxtrlongshortname </span>(see above). The
- &#x27E8;<span
-class="cmti-10">text</span>&#x27E9; argument includes the font formatting command, <span
-class="cmtt-10">\glsfirstabbrvfont</span>
- <span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmti-10">short</span>&#x27E9;<span
-class="cmtt-10">} </span>in the case of the <a
-href="#abbrstyle.long-short-user"><span
-class="cmss-10">long-short-user</span></a><a
- id="dx1-33051"></a> style and <span
-class="cmtt-10">\glsfirstlongfont{</span>&#x27E8;<span
-class="cmti-10">long</span>&#x27E9;<span
-class="cmtt-10">}</span>
- in the case of the <a
-href="#abbrstyle.short-long-user"><span
-class="cmss-10">short-long-user</span></a><a
- id="dx1-33052"></a> style.
- </p><!--l. 6303--><p class="noindent" >For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-154">
- \setabbreviationstyle[acronym]{long-short-user}
- \newacronym{tug}{TUG}{\TeX\&#x00A0;User&#x00A0;Group}
- \newacronym
- &#x00A0;[user1={German&#x00A0;Speaking&#x00A0;\TeX\&#x00A0;User&#x00A0;Group}]
- &#x00A0;{dante}{DANTE}{Deutschsprachige&#x00A0;Anwendervereinigung&#x00A0;\TeX\&#x00A0;e.V}
-</pre>
- <!--l. 6313--><p class="nopar" > On first use, <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls{tug}</span></span></span> will appear as:
- </p><blockquote class="quote">
- <!--l. 6316--><p class="noindent" >TeX&#x00A0;User Group (TUG)</p></blockquote>
- <!--l. 6318--><p class="noindent" >whereas <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls{dante}</span></span></span> will appear as:
- </p><blockquote class="quote">
- <!--l. 6320--><p class="noindent" >Deutschsprachige Anwendervereinigung TeX&#x00A0;e.V (DANTE,
- German Speaking TeX&#x00A0;User Group)</p></blockquote>
- <!--l. 6323--><p class="noindent" >The short form is formatted according to
- </p><!--l. 6324--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33053"></a> <span
-class="cmtt-10">\glsabbrvuserfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
- </p><!--l. 6326--><p class="noindent" >
- and the plural suffix is given by
- </p><!--l. 6328--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33054"></a> <span
-class="cmtt-10">\glsxtrusersuffix </span></div><hr>
- </p><!--l. 6330--><p class="noindent" >
- </p><!--l. 6332--><p class="noindent" >These may be redefined as appropriate. For example, if you want a&#x00A0;smallcaps
- style, you can just set these commands to those used by the <a
-href="#abbrstyle.long-short-sc"><span
-class="cmss-10">long-short-sc</span></a><a
- id="dx1-33055"></a>
- style:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-155">
- \renewcommand{\glsabbruserfont}[1]{\glsabbrvscfont{#1}}
- \renewcommand{\glsxtrusersuffix}{\glsxtrscsuffix}
-</pre>
- <!--l. 6338--><p class="nopar" >
- </p></dd><dt class="description">
-<a
- id="abbrstyle.long-noshort-noreg"></a><span
-class="cmssbx-10">long-noshort-noreg</span><a
- id="dx1-33056"></a> </dt><dd
-class="description">This style is like <a
-href="#abbrstyle.long-noshort"><span
-class="cmss-10">long-noshort</span></a><a
- id="dx1-33057"></a> but it doesn&#8217;t set the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-33058"></a>
- attribute.
- </dd><dt class="description">
-<a
- id="abbrstyle.long-noshort-desc-noreg"></a><span
-class="cmssbx-10">long-noshort-desc-noreg</span><a
- id="dx1-33059"></a> </dt><dd
-class="description">This style is like <a
-href="#abbrstyle.long-noshort-desc"><span
-class="cmss-10">long-noshort-desc</span></a><a
- id="dx1-33060"></a> but it doesn&#8217;t set the
- <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-33061"></a> attribute.
- </dd><dt class="description">
-<a
- id="abbrstyle.long-short-desc"></a><span
-class="cmssbx-10">long-short-desc</span><a
- id="dx1-33062"></a> </dt><dd
-class="description">On <a
- id="dx1-33063"></a><a
-href="#glo:firstuse">first use</a>, this style uses the format &#x27E8;<span
-class="cmti-10">long</span>&#x27E9; (&#x27E8;<span
-class="cmti-10">short</span>&#x27E9;). The
- inline and display full forms are the same. The <span
-class="cmss-10">name</span><a
- id="dx1-33064"></a> is set to the full
- form. The <span
-class="cmss-10">sort</span><a
- id="dx1-33065"></a> key is set to &#x27E8;<span
-class="cmti-10">long</span>&#x27E9; (&#x27E8;<span
-class="cmti-10">short</span>&#x27E9;). Before version 1.04, this was
- incorrectly set to the short form. If you want to revert back to this you can
- redefine
- <!--l. 6355--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33066"></a> <span
-class="cmtt-10">\glsxtrlongshortdescsort </span></div><hr>
- </p><!--l. 6357--><p class="noindent" >
- For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-156">
- \renewcommand*{\glsxtrlongshortdescsort}{\the\glsshorttok}
-</pre>
- <!--l. 6361--><p class="nopar" > The <span
-class="cmss-10">description</span><a
- id="dx1-33067"></a> must be supplied by the user. The long and short
- forms are separated by <span
-class="cmtt-10">\glsxtrfullsep</span>. The <span
-class="cmss-10">name</span><a
- id="dx1-33068"></a> field is obtained
- from
- </p><!--l. 6365--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33069"></a> <span
-class="cmtt-10">\glsxtrlongshortdescname </span></div><hr>
- </p><!--l. 6367--><p class="noindent" >
- (Similarly for other <span
-class="cmtt-10">long</span>&#x27E8;<span
-class="cmti-10">modifier</span>&#x27E9;<span
-class="cmtt-10">-short</span>&#x27E8;<span
-class="cmti-10">modifier</span>&#x27E9;<span
-class="cmtt-10">-desc </span>styles, unless indicated
- otherwise.) Any redefinition of this command must come before the
- abbreviations are defined as it expands on definition. Make sure you protect
- any commands that shouldn&#8217;t be expanded. The long form can be referenced
- with <span
-class="cmtt-10">\the\glslongtok </span>and the short form can be referenced with
- <span
-class="cmtt-10">\the\glsshorttok</span>.
- </p></dd><dt class="description">
-<a
- id="abbrstyle.long-short-sc-desc"></a><span
-class="cmssbx-10">long-short-sc-desc</span><a
- id="dx1-33070"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.long-short-desc"><span
-class="cmss-10">long-short-desc</span></a><a
- id="dx1-33071"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvscfont</span><a
- id="dx1-33072"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.long-short-sm-desc"></a><span
-class="cmssbx-10">long-short-sm-desc</span><a
- id="dx1-33073"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.long-short-desc"><span
-class="cmss-10">long-short-desc</span></a><a
- id="dx1-33074"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvsmfont</span><a
- id="dx1-33075"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.long-short-em-desc"></a><span
-class="cmssbx-10">long-short-em-desc</span><a
- id="dx1-33076"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.long-short-desc"><span
-class="cmss-10">long-short-desc</span></a><a
- id="dx1-33077"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvemfont</span><a
- id="dx1-33078"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.long-em-short-em-desc"></a><span
-class="cmssbx-10">long-em-short-em-desc</span><a
- id="dx1-33079"></a> </dt><dd
-class="description">New to version 1.04, this style is like <a
-href="#abbrstyle.long-short-em-desc"><span
-class="cmss-10">long-short-em-desc</span></a><a
- id="dx1-33080"></a> but
- redefines <span
-class="cmtt-10">\glsfirstlongfont </span>to use <span
-class="cmtt-10">\glsfirstlongemfont</span><a
- id="dx1-33081"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.long-em-noshort-em-desc-noreg"></a><span
-class="cmssbx-10">long-em-noshort-em-desc-noreg</span><a
- id="dx1-33082"></a> </dt><dd
-class="description">New to version 1.17, this style is like
- <a
-href="#abbrstyle.long-em-noshort-em-desc"><span
-class="cmss-10">long-em-noshort-em-desc</span></a><a
- id="dx1-33083"></a> but doesn&#8217;t set the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-33084"></a> attribute.
- </dd><dt class="description">
-<a
- id="abbrstyle.long-short-user-desc"></a><span
-class="cmssbx-10">long-short-user-desc</span><a
- id="dx1-33085"></a> </dt><dd
-class="description">New to version 1.04, this style is like a&#x00A0;cross between the
- <a
-href="#abbrstyle.long-short-desc"><span
-class="cmss-10">long-short-desc</span></a><a
- id="dx1-33086"></a> style and the <a
-href="#abbrstyle.long-short-user"><span
-class="cmss-10">long-short-user</span></a><a
- id="dx1-33087"></a> style. The display and
- inline forms are as for <a
-href="#abbrstyle.long-short-user"><span
-class="cmss-10">long-short-user</span></a><a
- id="dx1-33088"></a> and the <span
-class="cmss-10">name</span><a
- id="dx1-33089"></a> key is obtained
- from
- <!--l. 6405--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33090"></a> <span
-class="cmtt-10">\glsxtrlongshortuserdescname </span></div><hr>
-
-
-
- </p><!--l. 6407--><p class="noindent" >
- Again, this should only be redefined before <span
-class="cmtt-10">\newabbreviation </span>(or
- <span
-class="cmtt-10">\newacronym</span>), and fragile and formatting commands need protecting.
- </p><!--l. 6411--><p class="noindent" >The <span
-class="cmss-10">description</span><a
- id="dx1-33091"></a> key must be supplied in the optional argument of
- <span
-class="cmtt-10">\newabbreviation </span>(or <span
-class="cmtt-10">\newacronym</span>). The <span
-class="cmss-10">sort</span><a
- id="dx1-33092"></a> key is set to &#x27E8;<span
-class="cmti-10">long</span>&#x27E9; (&#x27E8;<span
-class="cmti-10">short</span>&#x27E9;) as per
- the <a
-href="#abbrstyle.long-short-desc"><span
-class="cmss-10">long-short-desc</span></a><a
- id="dx1-33093"></a> style.
- </p></dd><dt class="description">
-<a
- id="abbrstyle.short-nolong-noreg"></a><span
-class="cmssbx-10">short-nolong-noreg</span><a
- id="dx1-33094"></a> </dt><dd
-class="description">This is like <a
-href="#abbrstyle.short-nolong"><span
-class="cmss-10">short-nolong</span></a><a
- id="dx1-33095"></a> but doesn&#8217;t set the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-33096"></a> attribute.
- </dd><dt class="description">
-<a
- id="abbrstyle.nolong-short-noreg"></a><span
-class="cmssbx-10">nolong-short-noreg</span><a
- id="dx1-33097"></a> </dt><dd
-class="description">This is like <a
-href="#abbrstyle.nolong-short"><span
-class="cmss-10">nolong-short</span></a><a
- id="dx1-33098"></a> but doesn&#8217;t set the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-33099"></a> attribute.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-long"></a><span
-class="cmssbx-10">short-long</span><a
- id="dx1-33100"></a> </dt><dd
-class="description">On <a
- id="dx1-33101"></a><a
-href="#glo:firstuse">first use</a>, this style uses the format &#x27E8;<span
-class="cmti-10">short</span>&#x27E9; (&#x27E8;<span
-class="cmti-10">long</span>&#x27E9;). The inline and
- display full forms are the same. The <span
-class="cmss-10">name</span><a
- id="dx1-33102"></a> and <span
-class="cmss-10">sort</span><a
- id="dx1-33103"></a> keys are set to the
- short form. The <span
-class="cmss-10">description</span><a
- id="dx1-33104"></a> is set to the long form. The short and long
- forms are separated by <span
-class="cmtt-10">\glsxtrfullsep</span>. If you want to insert material
- within the parentheses (such as a&#x00A0;translation), try the <a
-href="#abbrstyle.short-long-user"><span
-class="cmss-10">short-long-user</span></a><a
- id="dx1-33105"></a>
- style.
- <!--l. 6434--><p class="noindent" >The <span
-class="cmss-10">name</span><a
- id="dx1-33106"></a> field is obtained from
- </p><!--l. 6435--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33107"></a> <span
-class="cmtt-10">\glsxtrshortlongname </span></div><hr>
- </p><!--l. 6437--><p class="noindent" >
- (Similarly for other <span
-class="cmtt-10">short</span>&#x27E8;<span
-class="cmti-10">modifier</span>&#x27E9;<span
-class="cmtt-10">-long</span>&#x27E8;<span
-class="cmti-10">modifier</span>&#x27E9; styles, unless indicated
- otherwise.) Any redefinition of this command must come before the
- abbreviations are defined as it expands on definition. Make sure you protect
- any commands that shouldn&#8217;t be expanded. The long form can be referenced
- with <span
-class="cmtt-10">\the\glslongtok </span>and the short form can be referenced with
- <span
-class="cmtt-10">\the\glsshorttok</span>.
- </p></dd><dt class="description">
-<a
- id="abbrstyle.short-sc-long"></a><span
-class="cmssbx-10">short-sc-long</span><a
- id="dx1-33108"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-long"><span
-class="cmss-10">short-long</span></a><a
- id="dx1-33109"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use <span
-class="cmtt-10">\glsabbrvscfont</span><a
- id="dx1-33110"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-sm-long"></a><span
-class="cmssbx-10">short-sm-long</span><a
- id="dx1-33111"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-long"><span
-class="cmss-10">short-long</span></a><a
- id="dx1-33112"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use <span
-class="cmtt-10">\glsabbrvsmfont</span><a
- id="dx1-33113"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-em-long"></a><span
-class="cmssbx-10">short-em-long</span><a
- id="dx1-33114"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-long"><span
-class="cmss-10">short-long</span></a><a
- id="dx1-33115"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use <span
-class="cmtt-10">\glsabbrvemfont</span><a
- id="dx1-33116"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-em-long-em"></a><span
-class="cmssbx-10">short-em-long-em</span><a
- id="dx1-33117"></a> </dt><dd
-class="description">New to version 1.04, this style is like <a
-href="#abbrstyle.short-em-long"><span
-class="cmss-10">short-em-long</span></a><a
- id="dx1-33118"></a> but redefines
- <span
-class="cmtt-10">\glsfirstlongfont </span>to use <span
-class="cmtt-10">\glsfirstlongemfont</span><a
- id="dx1-33119"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-long-user"></a><span
-class="cmssbx-10">short-long-user</span><a
- id="dx1-33120"></a> </dt><dd
-class="description">New to version 1.04. This style is like the <a
-href="#abbrstyle.long-short-user"><span
-class="cmss-10">long-short-user</span></a><a
- id="dx1-33121"></a> style but
- with the long and short forms switched. The parenthetical material is governed
- by the same command <span
-class="cmtt-10">\glsxtruserparen</span><a
- id="dx1-33122"></a>, but the first argument supplied to it
-
-
-
- is the long form instead of the short form. The <span
-class="cmss-10">name</span><a
- id="dx1-33123"></a> field is obtained by
- expanding
- <!--l. 6471--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33124"></a> <span
-class="cmtt-10">\glsxtrshortlongname </span></div><hr>
- </p><!--l. 6473--><p class="noindent" >
- Again, this should only be redefined before <span
-class="cmtt-10">\newabbreviation </span>(or
- <span
-class="cmtt-10">\newacronym</span>) and commands that should be expanded need to be protected.
- The <span
-class="cmss-10">description</span><a
- id="dx1-33125"></a> is set to <span
-class="cmtt-10">\glsuserdescription{</span>&#x27E8;<span
-class="cmti-10">long</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>.
- </p></dd><dt class="description">
-<a
- id="abbrstyle.short-nolong-desc-noreg"></a><span
-class="cmssbx-10">short-nolong-desc-noreg</span><a
- id="dx1-33126"></a> </dt><dd
-class="description">This style is like <a
-href="#abbrstyle.short-nolong-desc"><span
-class="cmss-10">short-nolong-desc</span></a><a
- id="dx1-33127"></a> but it doesn&#8217;t set the
- <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-33128"></a> attribute.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-long-desc"></a><span
-class="cmssbx-10">short-long-desc</span><a
- id="dx1-33129"></a> </dt><dd
-class="description">On <a
- id="dx1-33130"></a><a
-href="#glo:firstuse">first use</a>, this style uses the format &#x27E8;<span
-class="cmti-10">short</span>&#x27E9; (&#x27E8;<span
-class="cmti-10">long</span>&#x27E9;). The
- inline and display full forms are the same. The <span
-class="cmss-10">name</span><a
- id="dx1-33131"></a> is set to the full
- form. The <span
-class="cmss-10">description</span><a
- id="dx1-33132"></a> must be supplied by the user. The short and long
- forms are separated by <span
-class="cmtt-10">\glsxtrfullsep</span>. The <span
-class="cmss-10">name</span><a
- id="dx1-33133"></a> field is obtained
- from
- <!--l. 6490--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33134"></a> <span
-class="cmtt-10">\glsxtrshortlongdescname </span></div><hr>
- </p><!--l. 6492--><p class="noindent" >
- (Similarly for other <span
-class="cmtt-10">short</span>&#x27E8;<span
-class="cmti-10">modifier</span>&#x27E9;<span
-class="cmtt-10">-long</span>&#x27E8;<span
-class="cmti-10">modifier</span>&#x27E9;<span
-class="cmtt-10">-desc </span>styles, unless indicated
- otherwise.) Any redefinition of this command must come before the
- abbreviations are defined as it expands on definition. Make sure you protect
- any commands that shouldn&#8217;t be expanded. The long form can be referenced
- with <span
-class="cmtt-10">\the\glslongtok </span>and the short form can be referenced with
- <span
-class="cmtt-10">\the\glsshorttok</span>.
- </p></dd><dt class="description">
-<a
- id="abbrstyle.short-sc-long-desc"></a><span
-class="cmssbx-10">short-sc-long-desc</span><a
- id="dx1-33135"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-long-desc"><span
-class="cmss-10">short-long-desc</span></a><a
- id="dx1-33136"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvscfont</span><a
- id="dx1-33137"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-sm-long-desc"></a><span
-class="cmssbx-10">short-sm-long-desc</span><a
- id="dx1-33138"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-long-desc"><span
-class="cmss-10">short-long-desc</span></a><a
- id="dx1-33139"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvsmfont</span><a
- id="dx1-33140"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-em-long-desc"></a><span
-class="cmssbx-10">short-em-long-desc</span><a
- id="dx1-33141"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-long-desc"><span
-class="cmss-10">short-long-desc</span></a><a
- id="dx1-33142"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvemfont</span><a
- id="dx1-33143"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-em-long-em-desc"></a><span
-class="cmssbx-10">short-em-long-em-desc</span><a
- id="dx1-33144"></a> </dt><dd
-class="description">New to version 1.04, this style is like <a
-href="#abbrstyle.short-em-long-desc"><span
-class="cmss-10">short-em-long-desc</span></a><a
- id="dx1-33145"></a> but
- redefines <span
-class="cmtt-10">\glsfirstlongfont </span>to use <span
-class="cmtt-10">\glsfirstlongemfont</span><a
- id="dx1-33146"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-long-user-desc"></a><span
-class="cmssbx-10">short-long-user-desc</span><a
- id="dx1-33147"></a> </dt><dd
-class="description">New to version 1.04, this style is like a&#x00A0;cross between the
- <a
-href="#abbrstyle.short-long-desc"><span
-class="cmss-10">short-long-desc</span></a><a
- id="dx1-33148"></a> style and the <a
-href="#abbrstyle.short-long-user"><span
-class="cmss-10">short-long-user</span></a><a
- id="dx1-33149"></a> style. The display and
- inline forms are as for <a
-href="#abbrstyle.short-long-user"><span
-class="cmss-10">short-long-user</span></a><a
- id="dx1-33150"></a>, but the <span
-class="cmss-10">name</span><a
- id="dx1-33151"></a> key is obtained
- from
-
-
-
- <!--l. 6524--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33152"></a> <span
-class="cmtt-10">\glsxtrshortlonguserdescname </span></div><hr>
- </p><!--l. 6526--><p class="noindent" >
- Again, this should only be redefined before <span
-class="cmtt-10">\newabbreviation </span>(or
- <span
-class="cmtt-10">\newacronym</span>), and fragile and formatting commands need protecting.
- </p><!--l. 6530--><p class="noindent" >The <span
-class="cmss-10">description</span><a
- id="dx1-33153"></a> key must be supplied in the optional argument of
- <span
-class="cmtt-10">\newabbreviation </span>(or <span
-class="cmtt-10">\newacronym</span>).
- </p></dd><dt class="description">
-<a
- id="abbrstyle.short-footnote"></a><span
-class="cmssbx-10">short-footnote</span><a
- id="dx1-33154"></a> </dt><dd
-class="description">On <a
- id="dx1-33155"></a><a
-href="#glo:firstuse">first use</a>, this style displays the short form with the long form as
- a footnote. This style automatically sets the <a
-href="#catattr.nohyperfirst"><span
-class="cmss-10">nohyperfirst</span></a><a
- id="dx1-33156"></a> attribute to &#8220;true&#8221; for
- the supplied category, so the <a
- id="dx1-33157"></a>first use won&#8217;t be hyperlinked (but the footnote
- marker may be, if the <span
-class="cmss-10">hyperref</span><a
- id="dx1-33158"></a> package is used).
- <!--l. 6541--><p class="noindent" >The inline full form uses the &#x27E8;<span
-class="cmti-10">short</span>&#x27E9; (&#x27E8;<span
-class="cmti-10">long</span>&#x27E9;) style. The <span
-class="cmss-10">name</span><a
- id="dx1-33159"></a> is set to the short
- form. The <span
-class="cmss-10">description</span><a
- id="dx1-33160"></a> is set to the long form. The <span
-class="cmss-10">name</span><a
- id="dx1-33161"></a> key is obtained by
- expanding:
- </p><!--l. 6545--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33162"></a> <span
-class="cmtt-10">\glsxtrfootnotename </span></div><hr>
- </p><!--l. 6547--><p class="noindent" >
- (Similarly for other <span
-class="cmtt-10">short</span>&#x27E8;<span
-class="cmitt-10">modifier</span>&#x27E9;<span
-class="cmtt-10">-</span>&#x27E8;<span
-class="cmitt-10">modifier</span>&#x27E9;<span
-class="cmtt-10">footnote </span>styles, unless
- indicated otherwise.) Again, this command should only be redefined before
- <span
-class="cmtt-10">\newabbreviation </span>(or <span
-class="cmtt-10">\newacronym</span>), and fragile or formatting commands
- should be protected from expansion.
- </p><!--l. 6554--><p class="noindent" >As from version 1.05, all the footnote styles use:
- </p><!--l. 6555--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33163"></a> <span
-class="cmtt-10">\glsfirstlongfootnotefont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
- </p><!--l. 6557--><p class="noindent" >
- to format the long form on <a
- id="dx1-33164"></a>first use or for the full form and
- </p><!--l. 6559--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33165"></a> <span
-class="cmtt-10">\glslongfootnotefont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
- </p><!--l. 6561--><p class="noindent" >
- to format the long form elsewhere (for example, when used with <span
-class="cmtt-10">\glsxtrlong</span>).
- </p><!--l. 6565--><p class="noindent" >As from version 1.07, all the footnote styles use:
- </p><!--l. 6566--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33166"></a> <span
-class="cmtt-10">\glsxtrabbrvfootnote{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">long</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
- </p><!--l. 6568--><p class="noindent" >
- By default, this just does <span
-class="cmtt-10">\footnote</span><a
- id="dx1-33167"></a><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmti-10">long</span>&#x27E9;<span
-class="cmtt-10">} </span>(the first argument is ignored). For
- example, to make the footnote text link to the relevant place in the
- glossary:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-157">
- \renewcommand{\glsxtrabbrvfootnote}[2]{%
- &#x00A0;&#x00A0;\footnote{\glshyperlink[#2]{#1}}%
- }
-</pre>
- <!--l. 6576--><p class="nopar" > or to include the short form with a hyperlink:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-158">
- \renewcommand{\glsxtrabbrvfootnote}[2]{%
- &#x00A0;&#x00A0;\footnote{\glshyperlink[\glsfmtshort{#1}]{#1}:&#x00A0;#2}%
- }
-</pre>
- <!--l. 6582--><p class="nopar" > Note that I haven&#8217;t used commands like <span
-class="cmtt-10">\glsxtrshort </span>to avoid interference
- (see <a
-href="#sec:entryfmtmods"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.4</span> </a><a
-href="#sec:entryfmtmods">Entry Display Style Modifications<!--tex4ht:ref: sec:entryfmtmods --></a> and <a
-href="#sec:nested"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.8</span>
- </a><a
-href="#sec:nested">Nested Links<!--tex4ht:ref: sec:nested --></a>).
- </p></dd><dt class="description">
-<a
- id="abbrstyle.footnote"></a><span
-class="cmssbx-10">footnote</span><a
- id="dx1-33168"></a> </dt><dd
-class="description">A synonym for <a
-href="#abbrstyle.short-footnote"><span
-class="cmss-10">short-footnote</span></a><a
- id="dx1-33169"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-sc-footnote"></a><span
-class="cmssbx-10">short-sc-footnote</span><a
- id="dx1-33170"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-footnote"><span
-class="cmss-10">short-footnote</span></a><a
- id="dx1-33171"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvscfont</span><a
- id="dx1-33172"></a>. (This style was originally called <span
-class="cmss-10">footnote-sc</span><a
- id="dx1-33173"></a>. Renamed in
- version 1.04, but original name retained as a deprecated synonym for
- backward-compatibility.)
- </dd><dt class="description">
-<a
- id="abbrstyle.short-sc-footnote"></a><span
-class="cmssbx-10">short-sc-footnote</span><a
- id="dx1-33174"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-footnote"><span
-class="cmss-10">short-footnote</span></a><a
- id="dx1-33175"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvsmfont</span><a
- id="dx1-33176"></a>. (This style was originally called <span
-class="cmss-10">footnote-sm</span><a
- id="dx1-33177"></a>. Renamed in
- version 1.04, but original name retained as a deprecated synonym for
- backward-compatibility.)
- </dd><dt class="description">
-<a
- id="abbrstyle.short-em-footnote"></a><span
-class="cmssbx-10">short-em-footnote</span><a
- id="dx1-33178"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-footnote"><span
-class="cmss-10">short-footnote</span></a><a
- id="dx1-33179"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvemfont</span><a
- id="dx1-33180"></a>. (This style was originally called <span
-class="cmss-10">footnote-em</span><a
- id="dx1-33181"></a>. Renamed in
- version 1.04, but original name retained as a deprecated synonym for
- backward-compatibility.)
- </dd><dt class="description">
-<a
- id="abbrstyle.short-footnote-desc"></a><span
-class="cmssbx-10">short-footnote-desc</span><a
- id="dx1-33182"></a> </dt><dd
-class="description">(New to v1.42.) This is similar to <a
-href="#abbrstyle.short-footnote"><span
-class="cmss-10">short-footnote</span></a><a
- id="dx1-33183"></a>, but the
- <span
-class="cmss-10">description</span><a
- id="dx1-33184"></a> must be supplied by the user. The <span
-class="cmss-10">name</span><a
- id="dx1-33185"></a> field is obtained
- from:
- <!--l. 6616--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33186"></a> <span
-class="cmtt-10">\glsxtrfootnotedescname </span></div><hr>
- </p><!--l. 6618--><p class="noindent" >
- which defaults to &#x27E8;<span
-class="cmti-10">short</span>&#x27E9; followed by &#x27E8;<span
-class="cmti-10">long</span>&#x27E9; in parentheses, and the <span
-class="cmss-10">sort</span><a
- id="dx1-33187"></a> field is
- obtained from:
- </p><!--l. 6621--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33188"></a> <span
-class="cmtt-10">\glsxtrfootnotedescsort </span></div><hr>
- </p><!--l. 6623--><p class="noindent" >
- which defaults to just the short form. (Similarly for other
- <span
-class="cmtt-10">short</span>&#x27E8;<span
-class="cmti-10">modifier</span>&#x27E9;<span
-class="cmtt-10">-[post]footnote-desc </span>styles, unless indicated otherwise.)
-
-
-
- </p><!--l. 6628--><p class="noindent" >Any redefinition of these commands must come before the abbreviations
- are defined as it expands on definition. Make sure you protect any
- commands that shouldn&#8217;t be expanded. The long form can be referenced
- with <span
-class="cmtt-10">\the\glslongtok </span>and the short form can be referenced with
- <span
-class="cmtt-10">\the\glsshorttok</span>.
- </p></dd><dt class="description">
-<a
- id="abbrstyle.footnote-desc"></a><span
-class="cmssbx-10">footnote-desc</span><a
- id="dx1-33189"></a> </dt><dd
-class="description">A synonym for <a
-href="#abbrstyle.short-footnote-desc"><span
-class="cmss-10">short-footnote-desc</span></a><a
- id="dx1-33190"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-sc-footnote-desc"></a><span
-class="cmssbx-10">short-sc-footnote-desc</span><a
- id="dx1-33191"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-footnote-desc"><span
-class="cmss-10">short-footnote-desc</span></a><a
- id="dx1-33192"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvscfont</span><a
- id="dx1-33193"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-sm-footnote-desc"></a><span
-class="cmssbx-10">short-sm-footnote-desc</span><a
- id="dx1-33194"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-footnote-desc"><span
-class="cmss-10">short-footnote-desc</span></a><a
- id="dx1-33195"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvsmfont</span><a
- id="dx1-33196"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-em-footnote-desc"></a><span
-class="cmssbx-10">short-em-footnote-desc</span><a
- id="dx1-33197"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-footnote-desc"><span
-class="cmss-10">short-footnote-desc</span></a><a
- id="dx1-33198"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvemfont</span><a
- id="dx1-33199"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-postfootnote"></a><span
-class="cmssbx-10">short-postfootnote</span><a
- id="dx1-33200"></a> </dt><dd
-class="description">This is similar to the <a
-href="#abbrstyle.short-footnote"><span
-class="cmss-10">short-footnote</span></a><a
- id="dx1-33201"></a> style but doesn&#8217;t modify the
- category attribute. Instead it changes <span
-class="cmtt-10">\glsxtrpostlink</span>&#x27E8;<span
-class="cmti-10">category</span>&#x27E9;<a
- id="dx1-33202"></a>&#x00A0;to insert the
- footnote after the <a
- id="dx1-33203"></a><a
-href="#glo:linktext">link-text</a> on <a
- id="dx1-33204"></a><a
-href="#glo:firstuse">first use</a>. This will also defer the footnote
- until after any following punctuation character that&#8217;s recognised by
- <span
-class="cmtt-10">\glsxtrifnextpunc</span><a
- id="dx1-33205"></a>.
- <!--l. 6657--><p class="noindent" >The inline full form uses the &#x27E8;<span
-class="cmti-10">short</span>&#x27E9; (&#x27E8;<span
-class="cmti-10">long</span>&#x27E9;) style. The <span
-class="cmss-10">name</span><a
- id="dx1-33206"></a> is set to the short
- form. The <span
-class="cmss-10">description</span><a
- id="dx1-33207"></a> is set to the long form. Note that this style will change
- <span
-class="cmtt-10">\glsxtrfull </span>(and its variants) so that it fakes non-<a
- id="dx1-33208"></a>first use. (Otherwise the
- footnote would appear after the inline form.)
- </p></dd><dt class="description">
-<a
- id="abbrstyle.postfootnote"></a><span
-class="cmssbx-10">postfootnote</span><a
- id="dx1-33209"></a> </dt><dd
-class="description">A synonym for <a
-href="#abbrstyle.short-postfootnote"><span
-class="cmss-10">short-postfootnote</span></a><a
- id="dx1-33210"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-sc-postfootnote"></a><span
-class="cmssbx-10">short-sc-postfootnote</span><a
- id="dx1-33211"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-postfootnote"><span
-class="cmss-10">short-postfootnote</span></a><a
- id="dx1-33212"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvscfont</span><a
- id="dx1-33213"></a>. (This style was originally called <span
-class="cmss-10">postfootnote-sc</span><a
- id="dx1-33214"></a>. Renamed in
- version 1.04, but original name retained as a deprecated synonym for
- backward-compatibility.)
- </dd><dt class="description">
-<a
- id="abbrstyle.short-sm-postfootnote"></a><span
-class="cmssbx-10">short-sm-postfootnote</span><a
- id="dx1-33215"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-postfootnote"><span
-class="cmss-10">short-postfootnote</span></a><a
- id="dx1-33216"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvsmfont</span><a
- id="dx1-33217"></a>. (This style was originally called <span
-class="cmss-10">postfootnote-sm</span><a
- id="dx1-33218"></a>. Renamed
- in version 1.04, but original name retained as a deprecated synonym for
- backward-compatibility.)
-
-
-
- </dd><dt class="description">
-<a
- id="abbrstyle.short-em-postfootnote"></a><span
-class="cmssbx-10">short-em-postfootnote</span><a
- id="dx1-33219"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-postfootnote"><span
-class="cmss-10">short-postfootnote</span></a><a
- id="dx1-33220"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont </span>to use
- <span
-class="cmtt-10">\glsabbrvemfont</span><a
- id="dx1-33221"></a>. (This style was originally called <span
-class="cmss-10">postfootnote-em</span><a
- id="dx1-33222"></a>. Renamed
- in version 1.04, but original name retained as a deprecated synonym for
- backward-compatibility.)
- </dd><dt class="description">
-<a
- id="abbrstyle.short-postfootnote-desc"></a><span
-class="cmssbx-10">short-postfootnote-desc</span><a
- id="dx1-33223"></a> </dt><dd
-class="description">(New to v1.42.) This is similar to <a
-href="#abbrstyle.short-postfootnote"><span
-class="cmss-10">short-postfootnote</span></a><a
- id="dx1-33224"></a>, but
- the <span
-class="cmss-10">description</span><a
- id="dx1-33225"></a> must be supplied by the user. The <span
-class="cmss-10">name</span><a
- id="dx1-33226"></a> and <span
-class="cmss-10">sort</span><a
- id="dx1-33227"></a> are set as for
- <a
-href="#abbrstyle.short-footnote-desc"><span
-class="cmss-10">short-footnote-desc</span></a><a
- id="dx1-33228"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.postfootnote-desc"></a><span
-class="cmssbx-10">postfootnote-desc</span><a
- id="dx1-33229"></a> </dt><dd
-class="description">A synonym for <a
-href="#abbrstyle.short-postfootnote-desc"><span
-class="cmss-10">short-postfootnote-desc</span></a><a
- id="dx1-33230"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-sc-postfootnote-desc"></a><span
-class="cmssbx-10">short-sc-postfootnote-desc</span><a
- id="dx1-33231"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-postfootnote-desc"><span
-class="cmss-10">short-postfootnote-desc</span></a><a
- id="dx1-33232"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont</span>
- to use <span
-class="cmtt-10">\glsabbrvscfont</span><a
- id="dx1-33233"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-sm-postfootnote-desc"></a><span
-class="cmssbx-10">short-sm-postfootnote-desc</span><a
- id="dx1-33234"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-postfootnote-desc"><span
-class="cmss-10">short-postfootnote-desc</span></a><a
- id="dx1-33235"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont</span>
- to use <span
-class="cmtt-10">\glsabbrvsmfont</span><a
- id="dx1-33236"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-em-postfootnote-desc"></a><span
-class="cmssbx-10">short-em-postfootnote-desc</span><a
- id="dx1-33237"></a> </dt><dd
-class="description">Like <a
-href="#abbrstyle.short-postfootnote-desc"><span
-class="cmss-10">short-postfootnote-desc</span></a><a
- id="dx1-33238"></a> but redefines <span
-class="cmtt-10">\glsabbrvfont</span>
- to use <span
-class="cmtt-10">\glsabbrvemfont</span><a
- id="dx1-33239"></a>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-postlong-user"></a><span
-class="cmssbx-10">short-postlong-user</span><a
- id="dx1-33240"></a> </dt><dd
-class="description">This style was introduced in version 1.12. It&#8217;s like the
- <a
-href="#abbrstyle.short-long-user"><span
-class="cmss-10">short-long-user</span></a><a
- id="dx1-33241"></a> style but defers the parenthetical material to after the link-text.
- This means that you don&#8217;t have such a long hyperlink (which can cause
- problems for the DVI LaTeX&#x00A0;format) and it also means that the user supplied
- material can include a hyperlink to another location. The <span
-class="cmss-10">name</span><a
- id="dx1-33242"></a> key is obtained
- from <span
-class="cmtt-10">\glsxtrshortlongname</span>.
- </dd><dt class="description">
-<a
- id="abbrstyle.short-postlong-user-desc"></a><span
-class="cmssbx-10">short-postlong-user-desc</span><a
- id="dx1-33243"></a> </dt><dd
-class="description">This style was introduced in version 1.12. It&#8217;s like the
- above <a
-href="#abbrstyle.short-postlong-user"><span
-class="cmss-10">short-postlong-user</span></a><a
- id="dx1-33244"></a> style but the <span
-class="cmss-10">description</span><a
- id="dx1-33245"></a> must be specified. The <span
-class="cmss-10">name</span><a
- id="dx1-33246"></a>
- is obtained from <span
-class="cmtt-10">\glsxtrshortlonguserdescname</span>.
- </dd><dt class="description">
-<a
- id="abbrstyle.long-postshort-user"></a><span
-class="cmssbx-10">long-postshort-user</span><a
- id="dx1-33247"></a> </dt><dd
-class="description">This style was introduced in version 1.12. It&#8217;s like the
- above <a
-href="#abbrstyle.short-postlong-user"><span
-class="cmss-10">short-postlong-user</span></a><a
- id="dx1-33248"></a> style but the long form is shown first and
- the short form is in the parenthetical material (as for <a
-href="#abbrstyle.long-short-user"><span
-class="cmss-10">long-short-user</span></a><a
- id="dx1-33249"></a>)
- style.
- </dd><dt class="description">
-<a
- id="abbrstyle.long-postshort-user-desc"></a><span
-class="cmssbx-10">long-postshort-user-desc</span><a
- id="dx1-33250"></a> </dt><dd
-class="description">This style was introduced in version 1.12. It&#8217;s like the
- above <a
-href="#abbrstyle.long-postshort-user"><span
-class="cmss-10">long-postshort-user</span></a><a
- id="dx1-33251"></a> style but the <span
-class="cmss-10">description</span><a
- id="dx1-33252"></a> must be specified. The <span
-class="cmss-10">name</span><a
- id="dx1-33253"></a>
- is obtained from <span
-class="cmtt-10">\glsxtrlongshortuserdescname</span>.
-
-
-
- </dd><dt class="description">
-<a
- id="abbrstyle.long-postshort-sc-user"></a><span
-class="cmssbx-10">long-postshort-sc-user</span><a
- id="dx1-33254"></a> </dt><dd
-class="description">This style (new to v1.48) is like <a
-href="#abbrstyle.long-postshort-user"><span
-class="cmss-10">long-postshort-user</span></a><a
- id="dx1-33255"></a> but uses
- smallcaps for the short form.
- </dd><dt class="description">
-<a
- id="abbrstyle.long-postshort-sc-user-desc"></a><span
-class="cmssbx-10">long-postshort-sc-user-desc</span><a
- id="dx1-33256"></a> </dt><dd
-class="description">This style (new to v1.48) is like <a
-href="#abbrstyle.long-postshort-user-desc"><span
-class="cmss-10">long-postshort-user-desc</span></a><a
- id="dx1-33257"></a>
- but uses smallcaps for the short form.
- </dd><dt class="description">
-<a
- id="abbrstyle.long-hyphen-short-hyphen"></a><span
-class="cmssbx-10">long-hyphen-short-hyphen</span><a
- id="dx1-33258"></a> </dt><dd
-class="description">This style (new to v1.17) is designed to work
- with the <a
-href="#catattr.markwords"><span
-class="cmss-10">markwords</span></a><a
- id="dx1-33259"></a> category attribute. The full form is formatted
- using
- <!--l. 6748--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33260"></a> <span
-class="cmtt-10">\glsxtrlonghyphenshort{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">long</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">short</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
- </p><!--l. 6750--><p class="noindent" >
- where &#x27E8;<span
-class="cmti-10">insert</span>&#x27E9; is the inserted material provided in the final optional argument of
- commands like <span
-class="cmtt-10">\insert</span>. If &#x27E8;<span
-class="cmti-10">insert</span>&#x27E9; start with a hyphen, then this locally
- redefines <span
-class="cmtt-10">\glsxtrwordsep</span><a
- id="dx1-33261"></a> to a hyphen, which means that if the <a
-href="#catattr.markwords"><span
-class="cmss-10">markwords</span></a><a
- id="dx1-33262"></a>
- attribute is set then the long form will become hyphenated. (If this attribute
- isn&#8217;t set, there&#8217;s no alteration to the way the long form is displayed.) The <span
-class="cmss-10">name</span><a
- id="dx1-33263"></a>
- key is obtained from <span
-class="cmtt-10">\glsxtrlongshortname</span>.
- </p><!--l. 6760--><p class="noindent" >Unlike the other &#x27E8;<span
-class="cmti-10">long</span>&#x27E9; (&#x27E8;<span
-class="cmti-10">short</span>&#x27E9;) type of styles, such as <a
-href="#abbrstyle.long-short"><span
-class="cmss-10">long-short</span></a><a
- id="dx1-33264"></a>, this style also
- repeats the insertion in the parenthetical part, so that the first use form
- is:
- </p><blockquote class="quote">
- <!--l. 6765--><p class="noindent" ><span
-class="cmtt-10">\glsfirstlonghyphenfont{</span>&#x27E8;<span
-class="cmti-10">long</span>&#x27E9;<span
-class="cmtt-10">}</span>&#x27E8;<span
-class="cmti-10">insert</span>&#x27E9;
- (<span
-class="cmtt-10">\glsfirstabbrvhyphenfont{</span>&#x27E8;<span
-class="cmti-10">short</span>&#x27E9;<span
-class="cmtt-10">}</span>&#x27E8;<span
-class="cmti-10">insert</span>&#x27E9;)</p></blockquote>
- <!--l. 6768--><p class="noindent" >The space before the parenthetical material is actually given by
- <span
-class="cmtt-10">\glsxtrfullsep{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span>which defaults to a space. The &#x27E8;<span
-class="cmti-10">insert</span>&#x27E9; may be
- moved into the formatting commands according to the conditional
- <span
-class="cmtt-10">\ifglsxtrinsertinside</span>.
- </p><!--l. 6773--><p class="noindent" >For example, if <span
-class="cmtt-10">ip </span>is defined using:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-159">
- \glssetcategoryattribute{english}{markwords}{true}
- \setabbreviationstyle[english]{long-hyphen-short-hyphen}
- \newabbreviation[category=english]{ip}{IP}{Internet&#x00A0;Protocol}
-</pre>
- <!--l. 6778--><p class="nopar" > then
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-160">
- \gls{ip}[-Adressen]
-</pre>
- <!--l. 6782--><p class="nopar" > will do
- </p><blockquote class="quote">
- <!--l. 6785--><p class="noindent" >Internet-Protocol-Adressen (IP-Adressen)</p></blockquote>
- <!--l. 6787--><p class="noindent" >on first use, whereas
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-161">
- \gls{ip}[&#x00A0;Address]
-</pre>
- <!--l. 6790--><p class="nopar" > will do
- </p><blockquote class="quote">
- <!--l. 6793--><p class="noindent" >Internet Protocol Address (IP Address)</p></blockquote>
- <!--l. 6795--><p class="noindent" >on first use.
- </p><!--l. 6797--><p class="noindent" ><div class="important" title="Important Note"> Note that the hyphenation isn&#8217;t applied when using commands like
- <span
-class="cmtt-10">\glsxtrlong</span>. This means that
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-162">
- \glsxtrlong{ip}[-Adressen]
-</pre>
- <!--l. 6802--><p class="nopar" > will do
- </p><blockquote class="quote">
- <!--l. 6805--><p class="noindent" >Internet Protocol-Adressen</p></blockquote>
- </div>
- <!--l. 6807--><p class="noindent" >
- </p><!--l. 6809--><p class="noindent" >If the <a
-href="#catattr.markwords"><span
-class="cmss-10">markwords</span></a><a
- id="dx1-33265"></a> attribute hadn&#8217;t been set, then the first use of
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-163">
- \gls{ip}[-Adressen]
-</pre>
- <!--l. 6813--><p class="nopar" > would do
- </p><blockquote class="quote">
- <!--l. 6816--><p class="noindent" >Internet Protocol-Adressen (IP-Adressen)</p></blockquote>
- <!--l. 6818--><p class="noindent" >instead.
- </p><!--l. 6820--><p class="noindent" ><div class="important" title="Important Note"> If the inserted material &#x27E8;<span
-class="cmti-10">insert</span>&#x27E9; is likely to contain commands like <span
-class="cmtt-10">\gls</span>,
- then use <a
-href="#abbrstyle.long-hyphen-postshort-hyphen"><span
-class="cmss-10">long-hyphen-postshort-hyphen</span></a><a
- id="dx1-33266"></a> instead to avoid nested links.
- </div>
- </p><!--l. 6824--><p class="noindent" >
- </p><!--l. 6826--><p class="noindent" >If you want the short version in small-caps, you can just redefine
- <span
-class="cmtt-10">\glsabbrvhyphenfont </span>and <span
-class="cmtt-10">\glsxtrhyphensuffix </span>to use the small-caps
- versions. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-164">
- \renewcommand{\glsabbrvhyphenfont}{\glsabbrvscfont}
- \renewcommand{\glsxtrhyphensuffix}{\glsxtrscsuffix}
-</pre>
- <!--l. 6832--><p class="nopar" > Similarly for other font-changing variations.
- </p></dd><dt class="description">
-<a
- id="abbrstyle.long-hyphen-noshort-desc-noreg"></a><span
-class="cmssbx-10">long-hyphen-noshort-desc-noreg</span><a
- id="dx1-33267"></a> </dt><dd
-class="description">New to version 1.17, this style is like
- <a
-href="#abbrstyle.long-hyphen-short-hyphen-desc"><span
-class="cmss-10">long-hyphen-short-hyphen-desc</span></a><a
- id="dx1-33268"></a> except that the parenthetical part is omitted and
- the long form is displayed on subsequent use. The short form can be accessed
- with <span
-class="cmtt-10">\glsxtrshort </span>but just uses the default abbreviation font. There&#8217;s
- no regular version of this style as the regular form doesn&#8217;t have the
- flexibility to deal with the hyphen switch. The <span
-class="cmss-10">name</span><a
- id="dx1-33269"></a> is obtained from
- <span
-class="cmtt-10">\glsxtrlongnoshortdescname</span>.
- </dd><dt class="description">
-<a
- id="abbrstyle.long-hyphen-noshort-noreg"></a><span
-class="cmssbx-10">long-hyphen-noshort-noreg</span><a
- id="dx1-33270"></a> </dt><dd
-class="description">New to version 1.17, this style is like
- <a
-href="#abbrstyle.long-hyphen-noshort-desc-noreg"><span
-class="cmss-10">long-hyphen-noshort-desc-noreg</span></a><a
- id="dx1-33271"></a> but the name is set to the short form and the
- description is set to the long form.
- </dd><dt class="description">
-<a
- id="abbrstyle.long-hyphen-short-hyphen-desc"></a><span
-class="cmssbx-10">long-hyphen-short-hyphen-desc</span><a
- id="dx1-33272"></a> </dt><dd
-class="description">
- <!--l. 6853--><p class="noindent" >New to version 1.17. This is similar to <a
-href="#abbrstyle.long-hyphen-short-hyphen"><span
-class="cmss-10">long-hyphen-short-hyphen</span></a><a
- id="dx1-33273"></a> but the user
- supplies the description. The <span
-class="cmss-10">name</span><a
- id="dx1-33274"></a> is obtained from <span
-class="cmtt-10">\glsxtrlongshortdescname</span>.
- </p></dd><dt class="description">
-<a
- id="abbrstyle.long-hyphen-postshort-hyphen"></a><span
-class="cmssbx-10">long-hyphen-postshort-hyphen</span><a
- id="dx1-33275"></a> </dt><dd
-class="description">
- <!--l. 6860--><p class="noindent" >New to version 1.17. This is similar to <a
-href="#abbrstyle.long-hyphen-short-hyphen"><span
-class="cmss-10">long-hyphen-short-hyphen</span></a><a
- id="dx1-33276"></a> but the
- inserted and parenthetical material are moved to the post-link hook. On first
- use, <span
-class="cmtt-10">\gls{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmti-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span>will do <spacer type=vertical size=10><span class="obeylines-h">
- <br /><span
-class="cmtt-10">\glsxtrlonghyphen{</span>&#x27E8;<span
-class="cmti-10">long</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmti-10">insert</span>&#x27E9;<span
-class="cmtt-10">}\glsxtrposthyphenshort</span>
- <span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>&#x27E8;<span
-class="cmti-10">insert</span>&#x27E9;
- <br /><spacer type=vertical size=10></span>
- where
- </p><!--l. 6868--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33277"></a> <span
-class="cmtt-10">\glsxtrposthyphenshort{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9; </div><hr>
- </p><!--l. 6870--><p class="noindent" >
- is in the post-link hook. This uses the format: <spacer type=vertical size=10><span class="obeylines-h">
- <br />&#x27E8;<span
-class="cmti-10">insert</span>&#x27E9; (<span
-class="cmtt-10">\glsfirstabbrvhyphenfont{</span>&#x27E8;<span
-class="cmti-10">short</span>&#x27E9;<span
-class="cmtt-10">}</span>&#x27E8;<span
-class="cmti-10">isnert</span>&#x27E9;)
- <br /><spacer type=vertical size=10></span>
-
-
-
- </p><!--l. 6876--><p class="noindent" ><div class="important" title="Important Note"> The singular short form is always used here, even with <span
-class="cmtt-10">\glspl</span>. (Unlike
- <a
-href="#abbrstyle.long-hyphen-long-hyphen"><span
-class="cmss-10">long-hyphen-long-hyphen</span></a><a
- id="dx1-33278"></a>.) </div>
- </p><!--l. 6879--><p class="noindent" >
- </p><!--l. 6881--><p class="noindent" >The part in the link-text on first use:
- </p><!--l. 6882--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33279"></a> <span
-class="cmtt-10">\glsxtrlonghyphen{</span>&#x27E8;<span
-class="cmitt-10">long</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
- </p><!--l. 6884--><p class="noindent" >
- checks if &#x27E8;<span
-class="cmti-10">insert</span>&#x27E9; starts with a hyphen. If it does, then <span
-class="cmtt-10">\glsxtrwordsep </span>is locally
- redefined to a hyphen. This command only uses &#x27E8;<span
-class="cmti-10">insert</span>&#x27E9; to test if it starts with a
- hyphen. The actual insertion code isn&#8217;t typeset until the post-link hook and it&#8217;s
- also localised, which means that you can use commands like <span
-class="cmtt-10">\gls </span>in &#x27E8;<span
-class="cmti-10">insert</span>&#x27E9; for
- this style without causing nested hyperlinks, but only for commands like
- <span
-class="cmtt-10">\gls</span>.
- </p><!--l. 6893--><p class="noindent" ><div class="important" title="Important Note"> Don&#8217;t use <span
-class="cmtt-10">\gls </span>in the &#x27E8;<span
-class="cmti-10">insert</span>&#x27E9; part for commands like <span
-class="cmtt-10">\glsxtrfull</span>,
- <span
-class="cmtt-10">\glsxtrshort </span>or <span
-class="cmtt-10">\glsxtrlong</span>. </div>
- </p><!--l. 6896--><p class="noindent" >
- </p><!--l. 6898--><p class="noindent" >The inline full display format used by commands like <span
-class="cmtt-10">\glsxtrfull</span>
- behaves differently to the first use of <span
-class="cmtt-10">\gls </span>with this style. It&#8217;s better
- to use <span
-class="cmtt-10">\glsreset{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}\gls{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span>if you want to ensure the full
- format.
- </p></dd><dt class="description">
-<a
- id="abbrstyle.long-hyphen-postshort-hyphen-desc"></a><span
-class="cmssbx-10">long-hyphen-postshort-hyphen-desc</span><a
- id="dx1-33280"></a> </dt><dd
-class="description">
- <!--l. 6905--><p class="noindent" >New to version 1.17. This is similar to <a
-href="#abbrstyle.long-hyphen-postshort-hyphen"><span
-class="cmss-10">long-hyphen-postshort-hyphen</span></a><a
- id="dx1-33281"></a>
- but the user supplies the description. The <span
-class="cmss-10">name</span><a
- id="dx1-33282"></a> is obtained from
- <span
-class="cmtt-10">\glsxtrlongshortdescname</span>.
- </p></dd><dt class="description">
-<a
- id="abbrstyle.short-hyphen-long-hyphen"></a><span
-class="cmssbx-10">short-hyphen-long-hyphen</span><a
- id="dx1-33283"></a> </dt><dd
-class="description">This style (new to v1.17) is like <a
-href="#abbrstyle.long-hyphen-short-hyphen"><span
-class="cmss-10">long-hyphen-short-hyphen</span></a><a
- id="dx1-33284"></a>,
- except that the short form is displayed first followed by the long form in
- parentheses. The full form is formatted using
- <!--l. 6915--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33285"></a> <span
-class="cmtt-10">\glsxtrshorthyphenlong{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">short</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">long</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
- </p><!--l. 6917--><p class="noindent" >
- which behaves in an analogous way to <span
-class="cmtt-10">\glsxtrlonghyphenshort</span>. The <span
-class="cmss-10">name</span><a
- id="dx1-33286"></a> is
- obtained from <span
-class="cmtt-10">\glsxtrshortlongname</span>.
- </p></dd><dt class="description">
-<a
- id="abbrstyle.short-hyphen-long-hyphen-desc"></a><span
-class="cmssbx-10">short-hyphen-long-hyphen-desc</span><a
- id="dx1-33287"></a> </dt><dd
-class="description">
- <!--l. 6923--><p class="noindent" >New to version 1.17. This is similar to <a
-href="#abbrstyle.short-hyphen-long-hyphen"><span
-class="cmss-10">short-hyphen-long-hyphen</span></a><a
- id="dx1-33288"></a> but the user
- supplies the description. The <span
-class="cmss-10">name</span><a
- id="dx1-33289"></a> is obtained from <span
-class="cmtt-10">\glsxtrshortlongdescname</span>.
-
-
-
- </p></dd><dt class="description">
-<a
- id="abbrstyle.short-hyphen-postlong-hyphen"></a><span
-class="cmssbx-10">short-hyphen-postlong-hyphen</span><a
- id="dx1-33290"></a> </dt><dd
-class="description">This style (new to v1.17) is like
- <a
-href="#abbrstyle.long-hyphen-postshort-hyphen"><span
-class="cmss-10">long-hyphen-postshort-hyphen</span></a><a
- id="dx1-33291"></a>, but the short form is displayed first followed by
- the long form in parentheses. On first use, <span
-class="cmtt-10">\gls{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmti-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span>will do
- <spacer type=vertical size=10><span class="obeylines-h">
- <br /><span
-class="cmtt-10">\glsxtrshorthyphen{</span>&#x27E8;<span
-class="cmti-10">short</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmti-10">insert</span>&#x27E9;<span
-class="cmtt-10">}\glsxtrposthyphenlong</span>
- <span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>&#x27E8;<span
-class="cmti-10">insert</span>&#x27E9;
- <br /><spacer type=vertical size=10></span>
- where
- <!--l. 6938--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-33292"></a> <span
-class="cmtt-10">\glsxtrposthyphenlong{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9; </div><hr>
- </p><!--l. 6940--><p class="noindent" >
- is in the post-link hook. These commands behave in an analogous manner to
- those used with <a
-href="#abbrstyle.long-hyphen-postshort-hyphen"><span
-class="cmss-10">long-hyphen-postshort-hyphen</span></a><a
- id="dx1-33293"></a>. The <span
-class="cmss-10">name</span><a
- id="dx1-33294"></a> is obtained from
- <span
-class="cmtt-10">\glsxtrshortlongname</span>.
- </p><!--l. 6945--><p class="noindent" ><div class="important" title="Important Note"> Don&#8217;t use <span
-class="cmtt-10">\gls </span>in the &#x27E8;<span
-class="cmti-10">insert</span>&#x27E9; part for commands like <span
-class="cmtt-10">\glsxtrfull</span>,
- <span
-class="cmtt-10">\glsxtrshort </span>or <span
-class="cmtt-10">\glsxtrlong</span>. </div>
- </p><!--l. 6948--><p class="noindent" >
- </p><!--l. 6950--><p class="noindent" >The inline full display format used by commands like <span
-class="cmtt-10">\glsxtrfull</span>
- behaves differently to the first use of <span
-class="cmtt-10">\gls </span>with this style. It&#8217;s better
- to use <span
-class="cmtt-10">\glsreset{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}\gls{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span>if you want to ensure the full
- format.
- </p></dd><dt class="description">
-<a
- id="abbrstyle.short-hyphen-postlong-hyphen-desc"></a><span
-class="cmssbx-10">short-hyphen-postlong-hyphen-desc</span><a
- id="dx1-33295"></a> </dt><dd
-class="description">
- <!--l. 6957--><p class="noindent" >New to version 1.17. This is similar to <a
-href="#abbrstyle.short-hyphen-postlong-hyphen"><span
-class="cmss-10">short-hyphen-postlong-hyphen</span></a><a
- id="dx1-33296"></a>
- but the user supplies the description. The <span
-class="cmss-10">name</span><a
- id="dx1-33297"></a> is obtained from
- <span
-class="cmtt-10">\glsxtrshortlongdescname</span>.
-</p>
- </dd></dl>
-<!--l. 6964--><p class="noindent" >
-</p>
-<!--l. 6964--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">4.5 </span> <a
- id="sec:newabbrvstyle"></a>Defining New Abbreviation Styles</h3>
-<!--l. 6967--><p class="noindent" >New abbreviation styles may be defined using:
-</p><!--l. 6968--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34001"></a> <span
-class="cmtt-10">\newabbreviationstyle{</span>&#x27E8;<span
-class="cmitt-10">name</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">setup</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">fmts</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 6970--><p class="noindent" >
-</p><!--l. 6971--><p class="noindent" >where &#x27E8;<span
-class="cmti-10">name</span>&#x27E9; is the name of the new style (as used in the mandatory argument of
-<span
-class="cmtt-10">\setabbreviationstyle</span><a
- id="dx1-34002"></a>). This is similar but not identical to the <span
-class="cmss-10">glossaries </span>package&#8217;s
-<span
-class="cmtt-10">\newacronymstyle</span><a
- id="dx1-34003"></a> command.
-
-
-
-</p><!--l. 6978--><p class="indent" > <div class="important" title="Important Note"> You can&#8217;t use styles defined by <span
-class="cmtt-10">\newacronymstyle </span>with <span
-class="cmss-10">glossaries-extra</span>
-unless you have reverted <span
-class="cmtt-10">\newacronym</span><a
- id="dx1-34004"></a> back to its generic definition from
-<span
-class="cmss-10">glossaries </span>(using <span
-class="cmtt-10">\RestoreAcronyms</span><a
- id="dx1-34005"></a>). The acronym styles from the <span
-class="cmss-10">glossaries</span>
-package can&#8217;t be used with abbreviations defined with <span
-class="cmtt-10">\newabbreviation</span>.
-</div>
-</p><!--l. 6985--><p class="noindent" >
-</p><!--l. 6987--><p class="indent" > The &#x27E8;<span
-class="cmti-10">setup</span>&#x27E9; argument deals with the way the entry is defined and may
-set attributes for the given abbreviation category. This argument should
-redefine
-</p><!--l. 6990--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34006"></a> <span
-class="cmtt-10">\CustomAbbreviationFields </span></div><hr>
-</p><!--l. 6992--><p class="noindent" >
-to set the entry fields including the <span
-class="cmss-10">name</span><a
- id="dx1-34007"></a> (defaults to the short form if omitted),
-<span
-class="cmss-10">sort</span><a
- id="dx1-34008"></a>, <span
-class="cmss-10">first</span><a
- id="dx1-34009"></a>, <span
-class="cmss-10">firstplural</span><a
- id="dx1-34010"></a>. Other fields may also be set, such as <span
-class="cmss-10">text</span><a
- id="dx1-34011"></a>, <span
-class="cmss-10">plural</span><a
- id="dx1-34012"></a> and
-<span
-class="cmss-10">description</span><a
- id="dx1-34013"></a>.
-</p><!--l. 6999--><p class="indent" > <div class="important" title="Important Note"> <span
-class="cmtt-10">\CustomAbbreviationFields </span>is expanded by <span
-class="cmtt-10">\newabbreviation </span>so take care to
-protect commands that shouldn&#8217;t be expanded. </div>
-</p><!--l. 7002--><p class="noindent" >
-</p><!--l. 7004--><p class="indent" > For example, the <a
-href="#abbrstyle.long-short"><span
-class="cmss-10">long-short</span></a><a
- id="dx1-34014"></a> style has the following in &#x27E8;<span
-class="cmti-10">setup</span>&#x27E9;:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-165">
-&#x00A0;&#x00A0;\renewcommand*{\CustomAbbreviationFields}{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;name={\protect\glsabbrvfont{\the\glsshorttok}},
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;sort={\the\glsshorttok},
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;first={\protect\glsfirstlongfont{\the\glslongtok}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;\protect\glsxtrfullsep{\the\glslabeltok}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glsxtrparen{\protect\glsfirstabbrvfont{\the\glsshorttok}}},%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;firstplural={\protect\glsfirstlongfont{\the\glslongpltok}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;\protect\glsxtrfullsep{\the\glslabeltok}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glsxtrparen{\protect\glsfirstabbrvfont{\the\glsshortpltok}}},%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;plural={\protect\glsabbrvfont{\the\glsshortpltok}},%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;description={\the\glslongtok}}%
-</pre>
-<!--l. 7018--><p class="nopar" > Note that the <span
-class="cmss-10">first</span><a
- id="dx1-34015"></a> and <span
-class="cmss-10">firstplural</span><a
- id="dx1-34016"></a> are set even though they&#8217;re not used by
-<span
-class="cmtt-10">\gls</span>.
-</p><!--l. 7022--><p class="indent" > The basic styles, such as <a
-href="#abbrstyle.long-short"><span
-class="cmss-10">long-short</span></a><a
- id="dx1-34017"></a>, use commands like <span
-class="cmtt-10">\glsabbrvfont </span>(which are
-redefined whenever the style formatting is set) within <span
-class="cmtt-10">\CustomAbbreviationFields</span>.
-Other styles, such as <a
-href="#abbrstyle.long-em-short-em"><span
-class="cmss-10">long-em-short-em</span></a><a
- id="dx1-34018"></a> directly use their own custom commands, such
-as <span
-class="cmtt-10">\glsabbrvemfont</span>. With these styles, commands like <span
-class="cmtt-10">\glsabbrvfont </span>still need to
-be defined as appropriate in the &#x27E8;<span
-class="cmti-10">fmts</span>&#x27E9; argument even if they&#8217;re not used within
-<span
-class="cmtt-10">\CustomAbbreviationFields</span>.
-</p><!--l. 7031--><p class="indent" > The &#x27E8;<span
-class="cmti-10">setup</span>&#x27E9; argument may also redefine
-</p><!--l. 7032--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34019"></a> <span
-class="cmtt-10">\GlsXtrPostNewAbbreviation </span></div><hr>
-</p><!--l. 7034--><p class="noindent" >
-which can be used to assign attributes. (This will automatically be initialised to do
-nothing.)
-</p><!--l. 7038--><p class="indent" > For example, the <a
-href="#abbrstyle.short-footnote"><span
-class="cmss-10">short-footnote</span></a><a
- id="dx1-34020"></a> includes the following in &#x27E8;<span
-class="cmti-10">setup</span>&#x27E9;:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-166">
-&#x00A0;&#x00A0;\renewcommand*{\GlsXtrPostNewAbbreviation}{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glssetattribute{\the\glslabeltok}{nohyperfirst}{true}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glshasattribute{\the\glslabeltok}{regular}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glssetattribute{\the\glslabeltok}{regular}{false}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;{}%
-&#x00A0;&#x00A0;}%
-</pre>
-<!--l. 7049--><p class="nopar" > This sets the <a
-href="#catattr.nohyperfirst"><span
-class="cmss-10">nohyperfirst</span></a><a
- id="dx1-34021"></a> attribute to &#8220;true&#8221;. It also unsets the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-34022"></a> attribute if it
-has previously been set. Note that the <a
-href="#catattr.nohyperfirst"><span
-class="cmss-10">nohyperfirst</span></a><a
- id="dx1-34023"></a> attribute doesn&#8217;t get unset by
-other styles, so take care not to switch styles for the same category.
-</p><!--l. 7056--><p class="indent" > You can access the short, long, short plural and long plural values through the
-following token registers.
-</p><!--l. 7059--><p class="indent" > Short value (defined by <span
-class="cmss-10">glossaries</span>):
-</p><!--l. 7060--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34024"></a> <span
-class="cmtt-10">\glsshorttok </span></div><hr>
-</p><!--l. 7062--><p class="noindent" >
-</p><!--l. 7064--><p class="indent" > Short plural value (defined by <span
-class="cmss-10">glossaries-extra</span>):
-</p><!--l. 7065--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34025"></a> <span
-class="cmtt-10">\glsshortpltok </span></div><hr>
-</p><!--l. 7067--><p class="noindent" >
-(This may be the default value or, if provided, the value provided by the user
-through the <span
-class="cmss-10">shortplural</span><a
- id="dx1-34026"></a> key in the optional argument of <span
-class="cmtt-10">\newabbreviation</span><a
- id="dx1-34027"></a>.)
-</p><!--l. 7072--><p class="indent" > Long value (defined by <span
-class="cmss-10">glossaries</span>):
-</p><!--l. 7073--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34028"></a> <span
-class="cmtt-10">\glslongtok </span></div><hr>
-</p><!--l. 7075--><p class="noindent" >
-</p><!--l. 7077--><p class="indent" > Long plural value (defined by <span
-class="cmss-10">glossaries-extra</span>):
-</p><!--l. 7078--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34029"></a> <span
-class="cmtt-10">\glslongpltok </span></div><hr>
-</p><!--l. 7080--><p class="noindent" >
-(This may be the default value or, if provided, the value provided by the user
-through the <span
-class="cmss-10">longplural</span><a
- id="dx1-34030"></a> key in the optional argument of <span
-class="cmtt-10">\newabbreviation</span><a
- id="dx1-34031"></a>.)
-</p><!--l. 7085--><p class="indent" > The short or long values may be modified by attributes (such as <a
-href="#catattr.markwords"><span
-class="cmss-10">markwords</span></a><a
- id="dx1-34032"></a>). The
-above registers reflect the modification. If you want to access the original
-(unmodified) short or long form (as provided in the final two arguments of
-<span
-class="cmtt-10">\newabbreviation</span>), then use the commands:
-</p><!--l. 7090--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34033"></a> <span
-class="cmtt-10">\glsxtrorgshort </span></div><hr>
-</p><!--l. 7092--><p class="noindent" >
-for the short form and
-</p><!--l. 7094--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34034"></a> <span
-class="cmtt-10">\glsxtrorglong </span></div><hr>
-</p><!--l. 7096--><p class="noindent" >
-for the long form. (These may be useful for the <span
-class="cmss-10">sort</span><a
- id="dx1-34035"></a> key to avoid any formatting that
-
-
-
-may be added by the attribute setting.)
-</p><!--l. 7100--><p class="indent" > There are two other registers available that are defined by <span
-class="cmss-10">glossaries</span>:
-</p><!--l. 7103--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34036"></a> <span
-class="cmtt-10">\glslabeltok </span></div><hr>
-</p><!--l. 7105--><p class="noindent" >
-which contains the entry&#8217;s label and
-</p><!--l. 7107--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34037"></a> <span
-class="cmtt-10">\glskeylisttok </span></div><hr>
-</p><!--l. 7109--><p class="noindent" >
-which contains the values provided in the optional argument of <span
-class="cmtt-10">\newabbreviation</span><a
- id="dx1-34038"></a>.
-</p><!--l. 7113--><p class="indent" > Remember put <span
-class="cmtt-10">\the </span>in front of the register command as in the examples above.
-The category label can be access through the command (not a register):
-</p><!--l. 7116--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34039"></a> <span
-class="cmtt-10">\glscategorylabel </span></div><hr>
-</p><!--l. 7118--><p class="noindent" >
-This may be used inside the definition of <span
-class="cmtt-10">\GlsXtrPostNewAbbreviation</span>.
-</p><!--l. 7122--><p class="indent" > If you want to base a style on an existing style, you can use
-</p><!--l. 7123--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34040"></a> <span
-class="cmtt-10">\GlsXtrUseAbbrStyleSetup{</span>&#x27E8;<span
-class="cmitt-10">name</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7125--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">name</span>&#x27E9; is the name of the existing style. For example, the <a
-href="#abbrstyle.long-noshort-sc-desc"><span
-class="cmss-10">long-noshort-sc-desc</span></a><a
- id="dx1-34041"></a>
-style simply does
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-167">
-\GlsXtrUseAbbrStyleSetup{long-noshort-desc}
-</pre>
-<!--l. 7130--><p class="nopar" > within &#x27E8;<span
-class="cmti-10">setup</span>&#x27E9;.
-</p><!--l. 7133--><p class="indent" > The &#x27E8;<span
-class="cmti-10">fmts</span>&#x27E9; argument deals with the way the entry is displayed in the document.
-This argument should redefine the following commands.
-</p><!--l. 7137--><p class="indent" > The default suffix for the plural short form (if not overridden by the <span
-class="cmss-10">shortplural</span><a
- id="dx1-34042"></a>
-key):
-</p><!--l. 7139--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34043"></a> <span
-class="cmtt-10">\abbrvpluralsuffix </span></div><hr>
-</p><!--l. 7141--><p class="noindent" >
-(Note that this isn&#8217;t used for the plural long form, which just uses the regular
-<span
-class="cmtt-10">\glspluralsuffix</span>.)
-</p><!--l. 7145--><p class="indent" > The font used for the short form on <a
- id="dx1-34044"></a><a
-href="#glo:firstuse">first use</a> or in the full forms:
-</p><!--l. 7146--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34045"></a> <span
-class="cmtt-10">\glsfirstabbrvfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7148--><p class="noindent" >
-</p><!--l. 7150--><p class="indent" > The font used for the short form on subsequent use or through commands like
-<span
-class="cmtt-10">\glsxtrshort</span><a
- id="dx1-34046"></a>:
-</p><!--l. 7152--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34047"></a> <span
-class="cmtt-10">\glsabbrvfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7154--><p class="noindent" >
-</p><!--l. 7156--><p class="indent" > The font used for the long form on <a
- id="dx1-34048"></a>first use or in the full forms:
-</p><!--l. 7157--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34049"></a> <span
-class="cmtt-10">\glsfirstlongfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7159--><p class="noindent" >
-</p><!--l. 7161--><p class="indent" > The font used for the long form in commands like <span
-class="cmtt-10">\glsxtrlong </span>use:
-</p><!--l. 7163--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34050"></a> <span
-class="cmtt-10">\glslongfont{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7165--><p class="noindent" >
-</p><!--l. 7167--><p class="indent" > Display full form singular no case-change (used by <span
-class="cmtt-10">\gls</span><a
- id="dx1-34051"></a> on <a
- id="dx1-34052"></a>first use for
-abbreviations without the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-34053"></a> attribute set):
-</p><!--l. 7170--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34054"></a> <span
-class="cmtt-10">\glsxtrfullformat{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7172--><p class="noindent" >
-</p><!--l. 7174--><p class="indent" > Display full form singular first letter converted to upper case (used by <span
-class="cmtt-10">\Gls</span><a
- id="dx1-34055"></a> on
-<a
- id="dx1-34056"></a>first use for abbreviations without the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-34057"></a> attribute set):
-</p><!--l. 7177--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34058"></a> <span
-class="cmtt-10">\Glsxtrfullformat{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7179--><p class="noindent" >
-</p><!--l. 7181--><p class="indent" > Display full form plural no case-change (used by <span
-class="cmtt-10">\glspl</span><a
- id="dx1-34059"></a> on <a
- id="dx1-34060"></a>first use for
-abbreviations without the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-34061"></a> attribute set):
-</p><!--l. 7184--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34062"></a> <span
-class="cmtt-10">\glsxtrfullplformat{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-
-
-
-</p><!--l. 7186--><p class="noindent" >
-</p><!--l. 7188--><p class="indent" > Display full form plural first letter converted to upper case (used by <span
-class="cmtt-10">\Glspl</span><a
- id="dx1-34063"></a> on
-<a
- id="dx1-34064"></a><a
-href="#glo:firstuse">first use</a> for abbreviations without the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-34065"></a> attribute set):
-</p><!--l. 7191--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34066"></a> <span
-class="cmtt-10">\Glsxtrfullplformat{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7193--><p class="noindent" >
-</p><!--l. 7195--><p class="indent" > In addition &#x27E8;<span
-class="cmti-10">fmts</span>&#x27E9; may also redefine the following commands that govern the inline
-full formats. If the style doesn&#8217;t redefine them, they will default to the same as the
-display full forms.
-</p><!--l. 7199--><p class="indent" > Inline singular no case-change (used by <span
-class="cmtt-10">\glsentryfull</span><a
- id="dx1-34067"></a>, <span
-class="cmtt-10">\glsxtrfull</span><a
- id="dx1-34068"></a> and
-<span
-class="cmtt-10">\GLSxtrfull</span><a
- id="dx1-34069"></a>):
-</p><!--l. 7201--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34070"></a> <span
-class="cmtt-10">\glsxtrinlinefullformat{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7203--><p class="noindent" >
-</p><!--l. 7205--><p class="indent" > Inline singular first letter converted to upper case (used by <span
-class="cmtt-10">\Glsentryfull</span><a
- id="dx1-34071"></a> and
-<span
-class="cmtt-10">\Glsxtrfull</span><a
- id="dx1-34072"></a>):
-</p><!--l. 7207--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34073"></a> <span
-class="cmtt-10">\Glsxtrinlinefullformat{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7209--><p class="noindent" >
-</p><!--l. 7211--><p class="indent" > Inline plural no case-change (used by <span
-class="cmtt-10">\glsentryfullpl</span><a
- id="dx1-34074"></a>, <span
-class="cmtt-10">\glsxtrfullpl</span><a
- id="dx1-34075"></a> and
-<span
-class="cmtt-10">\GLSxtrfullpl</span><a
- id="dx1-34076"></a>):
-</p><!--l. 7213--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34077"></a> <span
-class="cmtt-10">\glsxtrinlinefullplformat{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7215--><p class="noindent" >
-</p><!--l. 7217--><p class="indent" > Inline plural first letter converted to upper case (used by <span
-class="cmtt-10">\Glsentryfullpl</span><a
- id="dx1-34078"></a> and
-<span
-class="cmtt-10">\Glsxtrfullpl</span><a
- id="dx1-34079"></a>):
-</p><!--l. 7219--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34080"></a> <span
-class="cmtt-10">\Glsxtrinlinefullplformat{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7221--><p class="noindent" >
-</p><!--l. 7223--><p class="indent" > (New to version 1.17.) You can also modify the way the subsequent use is
-formatted by redefining the following four commands, but these won&#8217;t be used for
-abbreviations with the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-34081"></a> attribute set. If the style doesn&#8217;t redefine these
-commands, the default values are used.
-</p><!--l. 7229--><p class="indent" > Singular with no case-change:
-</p><!--l. 7230--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34082"></a> <span
-class="cmtt-10">\glsxtrsubsequentfmt{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7232--><p class="noindent" >
-</p><!--l. 7234--><p class="indent" > Singular with first letter upper case:
-</p><!--l. 7235--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34083"></a> <span
-class="cmtt-10">\Glsxtrsubsequentfmt{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7237--><p class="noindent" >
-</p><!--l. 7239--><p class="indent" > Plural with no case-change:
-</p><!--l. 7240--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34084"></a> <span
-class="cmtt-10">\glsxtrsubsequentplfmt{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7242--><p class="noindent" >
-
-
-
-</p><!--l. 7244--><p class="indent" > Plural with first letter upper case:
-</p><!--l. 7245--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34085"></a> <span
-class="cmtt-10">\Glsxtrsubsequentplfmt{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7247--><p class="noindent" >
-</p><!--l. 7249--><p class="indent" > If you want to provide support for <span
-class="cmss-10">glossaries-accsupp</span><a
- id="dx1-34086"></a> use the following
-<span
-class="cmtt-10">\glsaccess</span>&#x27E8;<span
-class="cmitt-10">xxx</span>&#x27E9; commands (<a
-href="#sec:accsupp"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">13.2</span> </a><a
-href="#sec:accsupp">Accessibility Support<!--tex4ht:ref: sec:accsupp --></a>) within the
-definitions of <span
-class="cmtt-10">\glsxtrfullformat </span>etc instead of the analogous <span
-class="cmtt-10">\glsentry</span>&#x27E8;<span
-class="cmti-10">xxx</span>&#x27E9;
-commands. (If you don&#8217;t use <span
-class="cmss-10">glossaries-accsupp</span><a
- id="dx1-34087"></a>, they will just do the corresponding
-<span
-class="cmtt-10">\glsentry</span>&#x27E8;<span
-class="cmti-10">xxx</span>&#x27E9; command.)
-</p><!--l. 7257--><p class="indent" > For example, the <a
-href="#abbrstyle.short-long"><span
-class="cmss-10">short-long</span></a><a
- id="dx1-34088"></a> style has the following in &#x27E8;<span
-class="cmti-10">fmts</span>&#x27E9;:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-168">
-&#x00A0;&#x00A0;\renewcommand*{\abbrvpluralsuffix}{\glsxtrabbrvpluralsuffix}%
-&#x00A0;&#x00A0;\renewcommand*{\glsabbrvfont}[1]{\glsabbrvdefaultfont{##1}}%
-&#x00A0;&#x00A0;\renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvdefaultfont{##1}}%
-&#x00A0;&#x00A0;\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
-&#x00A0;&#x00A0;\renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
-&#x00A0;&#x00A0;\renewcommand*{\glsxtrfullformat}[2]{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glsfirstabbrvfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\ifglsxtrinsertinside\else##2\fi
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glsxtrfullsep{##1}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glsxtrparen{\glsfirstlongfont{\glsaccesslong{##1}}}%
-&#x00A0;&#x00A0;}%
-&#x00A0;&#x00A0;\renewcommand*{\glsxtrfullplformat}[2]{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glsfirstabbrvfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\ifglsxtrinsertinside\else##2\fi
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glsxtrfullsep{##1}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glsxtrparen{\glsfirstlongfont{\glsaccesslongpl{##1}}}%
-&#x00A0;&#x00A0;}%
-&#x00A0;&#x00A0;\renewcommand*{\Glsxtrfullformat}[2]{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glsfirstabbrvfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glsxtrparen{\glsfirstlongfont{\glsaccesslong{##1}}}%
-&#x00A0;&#x00A0;}%
-&#x00A0;&#x00A0;\renewcommand*{\Glsxtrfullplformat}[2]{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glsfirstabbrvfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;\ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glsxtrparen{\glsfirstlongfont{\glsaccesslongpl{##1}}}%
-&#x00A0;&#x00A0;}%
-</pre>
-<!--l. 7287--><p class="nopar" > Since the inline full commands aren&#8217;t redefined, they default to the same as the
-display versions.
-</p><!--l. 7291--><p class="indent" > If you want to base a style on an existing style, you can use
-</p><!--l. 7292--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-34089"></a> <span
-class="cmtt-10">\GlsXtrUseAbbrStyleFmts{</span>&#x27E8;<span
-class="cmitt-10">name</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7294--><p class="noindent" >
-within &#x27E8;<span
-class="cmti-10">fmts</span>&#x27E9;, where &#x27E8;<span
-class="cmti-10">name</span>&#x27E9; is the name of the existing style. For example, the
-<a
-href="#abbrstyle.long-short-desc"><span
-class="cmss-10">long-short-desc</span></a><a
- id="dx1-34090"></a> style has the following in &#x27E8;<span
-class="cmti-10">fmts</span>&#x27E9;:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-169">
-&#x00A0;&#x00A0;\GlsXtrUseAbbrStyleFmts{long-short}%
-</pre>
-<!--l. 7300--><p class="nopar" >
-</p><!--l. 7302--><p class="indent" > Here&#8217;s an example of an abbreviation style that&#8217;s based on <a
-href="#abbrstyle.long-short"><span
-class="cmss-10">long-short</span></a><a
- id="dx1-34091"></a> that displays
-the short form within <span
-class="cmtt-10">\textsf</span>:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-170">
-\newabbreviationstyle
-{custom-sf}%&#x00A0;label
-{%&#x00A0;setup
-&#x00A0;&#x00A0;\GlsXtrUseAbbrStyleSetup{short-long}%
-}%
-{%&#x00A0;fmts
-&#x00A0;&#x00A0;\GlsXtrUseAbbrStyleFmts{short-long}%
-&#x00A0;&#x00A0;\renewcommand*{\glsabbrvfont}[1]{\textsf{##1}}%
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3832"></a><code class="code"><dfn id="glo:glsxtrposthyphenlong"><code class="csfmt">\glsxtrposthyphenlong</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is used in the <a id="wrglossary.3833"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the <a id="wrglossary.3834"></a><a href="#glo:opt.abbrstyle.short-hyphen-postlong-hyphen"><span class="abbrstylefmt">short-hyphen-postlong-hyphen</span></a> style on <a id="wrglossary.3835"></a><a href="#glo:dual.firstuse">first use</a>. Similar to <a id="wrglossary.3836"></a><a href="#glo:glsxtrposthyphenshort"><code class="csfmt">\glsxtrposthyphenshort</code></a> but shows the long form instead of the short form.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3837"></a><code class="code"><dfn id="glo:GLSxtrposthyphenlong"><code class="csfmt">\GLSxtrposthyphenlong</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.3838"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3839"></a><code class="code"><dfn id="glo:glsxtrposthyphenlongpl"><code class="csfmt">\glsxtrposthyphenlongpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.3840"></a><a href="#glo:glsxtrposthyphenlong"><code class="csfmt">\glsxtrposthyphenlong</code></a> but plural.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3841"></a><code class="code"><dfn id="glo:GLSxtrposthyphenlongpl"><code class="csfmt">\GLSxtrposthyphenlongpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.3842"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+
+</section><!-- end of section sec:abbrvcmdshyphen -->
+
+<section id="sec:abbrvcmdsonly"><!-- start of section sec:abbrvcmdsonly --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.1.3.8. Only Styles<div class="labellink"><a href="#sec:abbrvcmdsonly">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These are commands used by the <span class="qt">“only”</span> styles, such as <a id="wrglossary.3843"></a><a href="#glo:opt.abbrstyle.long-only-short-only"><span class="abbrstylefmt">long-only-short-only</span></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3844"></a><code class="code"><dfn id="glo:glsabbrvonlyfont"><code class="csfmt">\glsabbrvonlyfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The formatting command used for the short form in the only styles. The default is to simply use <a id="wrglossary.3845"></a><a href="#glo:glsabbrvdefaultfont"><code class="csfmt">\glsabbrvdefaultfont</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3846"></a><code class="code"><dfn id="glo:glsfirstabbrvonlyfont"><code class="csfmt">\glsfirstabbrvonlyfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The formatting command used for the short form in the only styles on <a id="wrglossary.3847"></a><a href="#glo:dual.firstuse">first use</a>. The default is to simply use <a id="wrglossary.3848"></a><a href="#glo:glsabbrvonlyfont"><code class="csfmt">\glsabbrvonlyfont</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3849"></a><code class="code"><dfn id="glo:glslongonlyfont"><code class="csfmt">\glslongonlyfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The formatting command used for the long form in the only styles. The default is to simply use <a id="wrglossary.3850"></a><a href="#glo:glslongdefaultfont"><code class="csfmt">\glslongdefaultfont</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3851"></a><code class="code"><dfn id="glo:glsfirstlongonlyfont"><code class="csfmt">\glsfirstlongonlyfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The formatting command used for the long form in the only styles on <a id="wrglossary.3852"></a><a href="#glo:dual.firstuse">first use</a>. The default is to simply use <a id="wrglossary.3853"></a><a href="#glo:glslongonlyfont"><code class="csfmt">\glslongonlyfont</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3854"></a><code class="code"><dfn id="glo:glsxtronlysuffix"><code class="csfmt">\glsxtronlysuffix</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Short plural suffix used by the <span class="qt">“only”</span> styles. This defaults to <a id="wrglossary.3855"></a><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3856"></a><code class="code"><dfn id="glo:glsabbrvsconlyfont"><code class="csfmt">\glsabbrvsconlyfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The formatting command used for the short form in the <span class="qt">“sc-only”</span> styles. The default is to simply use <a id="wrglossary.3857"></a><a href="#glo:glsabbrvscfont"><code class="csfmt">\glsabbrvscfont</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3858"></a><code class="code"><dfn id="glo:glsfirstabbrvsconlyfont"><code class="csfmt">\glsfirstabbrvsconlyfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The formatting command used for the short form in the <span class="qt">“sc-only”</span> styles on <a id="wrglossary.3859"></a><a href="#glo:dual.firstuse">first use</a>. The default is to simply use <a id="wrglossary.3860"></a><a href="#glo:glsabbrvsconlyfont"><code class="csfmt">\glsabbrvsconlyfont</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3861"></a><code class="code"><dfn id="glo:glsxtrsconlyrevert"><code class="csfmt">\glsxtrsconlyrevert</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Counteracts the effect of <a id="wrglossary.3862"></a><a href="#glo:glsabbrvsconlyfont"><code class="csfmt">\glsabbrvsconlyfont</code></a>. The default is <a id="wrglossary.3863"></a><a href="#glo:glsxtrscrevert"><code class="csfmt">\glsxtrscrevert</code></a>. If you redefine <a id="wrglossary.3864"></a><a href="#glo:glsabbrvsconlyfont"><code class="csfmt">\glsabbrvsconlyfont</code></a>, you will need to redefine <a id="wrglossary.3865"></a><a href="#glo:glsxtrsconlyrevert"><code class="csfmt">\glsxtrsconlyrevert</code></a> as applicable.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3866"></a><code class="code"><dfn id="glo:glsxtrsconlysuffix"><code class="csfmt">\glsxtrsconlysuffix</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsxtrscsuffix"><code class="csfmt">\glsxtrscsuffix</code></a></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Short plural suffix used by the <span class="qt">“sc-only”</span> styles. This defaults to <a id="wrglossary.3867"></a><a href="#glo:glsxtrscsuffix"><code class="csfmt">\glsxtrscsuffix</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3868"></a><code class="code"><dfn id="glo:glsxtronlyname"><code class="csfmt">\glsxtronlyname</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the value for the <a id="wrglossary.3869"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key for the <span class="qt">“only”</span> styles. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\protect</code><a id="wrglossary.3870"></a><a href="#glo:glsabbrvonlyfont"><code class="csfmt">\glsabbrvonlyfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3871"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a>}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3872"></a><code class="code"><dfn id="glo:glsxtronlydescname"><code class="csfmt">\glsxtronlydescname</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the value for the <a id="wrglossary.3873"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key for the <span class="qt">“only”</span> styles where the description should be described, such as <a id="wrglossary.3874"></a><a href="#glo:opt.abbrstyle.long-only-short-only-desc"><span class="abbrstylefmt">long-only-short-only-desc</span></a>. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\protect</code><a id="wrglossary.3875"></a><a href="#glo:glslongfont"><code class="csfmt">\glslongfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3876"></a><a href="#glo:glslongtok"><code class="csfmt">\glslongtok</code></a>}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3877"></a><code class="code"><dfn id="glo:glsxtronlydescsort"><code class="csfmt">\glsxtronlydescsort</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the value for the <a id="wrglossary.3878"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key for the <span class="qt">“only”</span> styles where the description should be described, such as <a id="wrglossary.3879"></a><a href="#glo:opt.abbrstyle.long-only-short-only-desc"><span class="abbrstylefmt">long-only-short-only-desc</span></a>. The default definition is <code class="code"><span class="cmdfmt">\the</span><a id="wrglossary.3880"></a><a href="#glo:glslongtok"><code class="csfmt">\glslongtok</code></a></code>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+This command is irrelevant with the <a id="wrglossary.3881"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>. </div><!-- end of information -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3882"></a><code class="code"><dfn id="glo:glsxtrsconlyname"><code class="csfmt">\glsxtrsconlyname</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the value for the <a id="wrglossary.3883"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key for the <span class="qt">“sc-only”</span> styles. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\protect</code><a id="wrglossary.3884"></a><a href="#glo:glsabbrvsconlyfont"><code class="csfmt">\glsabbrvsconlyfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.3885"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a>}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3886"></a><code class="code"><dfn id="glo:glsxtrsconlydescname"><code class="csfmt">\glsxtrsconlydescname</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the value for the <a id="wrglossary.3887"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key for the <span class="qt">“sc-only”</span> styles where the description should be described. The default definition is to simply use <a id="wrglossary.3888"></a><a href="#glo:glsxtronlydescname"><code class="csfmt">\glsxtronlydescname</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3889"></a><code class="code"><dfn id="glo:glsxtrsconlydescsort"><code class="csfmt">\glsxtrsconlydescsort</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the value for the <a id="wrglossary.3890"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key for the <span class="qt">“sc-only”</span> styles where the description should be described, such as <a id="wrglossary.3891"></a><a href="#glo:opt.abbrstyle.long-only-short-only-desc"><span class="abbrstylefmt">long-only-short-only-desc</span></a>. The default definition is to simply use <a id="wrglossary.3892"></a><a href="#glo:glsxtronlydescsort"><code class="csfmt">\glsxtronlydescsort</code></a>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+This command is irrelevant with the <a id="wrglossary.3893"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>. </div><!-- end of information -->
+<p>
+
+</section><!-- end of section sec:abbrvcmdsonly -->
+
+<section id="sec:abbrvcmdsfonts"><!-- start of section sec:abbrvcmdsfonts --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.1.3.9. Fonts<div class="labellink"><a href="#sec:abbrvcmdsfonts">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These are commands used by styles that use a particular font shape or size, identified by one of the following two-letter tags: <span class="qt">“sc”</span> (<a id="wrglossary.3894"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a>), <span class="qt">“sm”</span> (<a id="wrglossary.3895"></a><a href="#glo:textsmaller"><code class="csfmt">\textsmaller</code></a>) or <span class="qt">“em”</span> (<a id="wrglossary.3896"></a><a href="#glo:emph"><code class="csfmt">\emph</code></a>).<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+For the <span class="qt">“sc-user”</span> styles, see §<a href="#sec:abbrvcmdsuser">4.5.1.3.3</a>. For the <span class="qt">“sc-only”</span> styles, see §<a href="#sec:abbrvcmdsonly">4.5.1.3.8</a>. </div><!-- end of information -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3897"></a><code class="code"><dfn id="glo:glsabbrvscfont"><code class="csfmt">\glsabbrvscfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Formatting for the <span class="qt">“sc”</span> short form. This uses <a id="wrglossary.3898"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a> to apply a <a id="wrglossary.3899"></a><a href="#glo:idx.smallcaps">small caps</a> style, so your document font needs to support it.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+<a id="wrglossary.3900"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a> uses small capital glyphs for <a id="wrglossary.3901"></a><a href="#glo:idx.lowercase">lowercase</a> characters. <a id="wrglossary.3902"></a><a href="#glo:idx.uppercase">Uppercase</a> characters show as normal capitals. This means that you need to use <a id="wrglossary.3903"></a><a href="#glo:idx.lowercase">lowercase</a> characters in the abbreviation. </div><!-- end of information -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3904"></a><code class="code"><dfn id="glo:glsfirstabbrvscfont"><code class="csfmt">\glsfirstabbrvscfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Formatting for the <span class="qt">“sc”</span> short form shown on <a id="wrglossary.3905"></a><a href="#glo:dual.firstuse">first use</a>. This defaults to <a id="wrglossary.3906"></a><a href="#glo:glsabbrvscfont"><code class="csfmt">\glsabbrvscfont</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3907"></a><code class="code"><dfn id="glo:glsxtrscrevert"><code class="csfmt">\glsxtrscrevert</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Counteracts the effect of <a id="wrglossary.3908"></a><a href="#glo:glsabbrvscfont"><code class="csfmt">\glsabbrvscfont</code></a>. This defaults to <a id="wrglossary.3909"></a><a href="#glo:glstextup"><code class="csfmt">\glstextup</code></a>. If you redefine <a id="wrglossary.3910"></a><a href="#glo:glsabbrvscfont"><code class="csfmt">\glsabbrvscfont</code></a>, you will need to redefine <a id="wrglossary.3911"></a><a href="#glo:glsxtrscrevert"><code class="csfmt">\glsxtrscrevert</code></a> as applicable.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3912"></a><code class="code"><dfn id="glo:glsxtrscsuffix"><code class="csfmt">\glsxtrscsuffix</code></dfn></code></div><!-- end of pinnedbox -->
+ Short plural suffix used by the <span class="qt">“sc”</span> styles. This needs to counteract the smallcaps, so it’s defined as: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\protect</code><a id="wrglossary.3913"></a><a href="#glo:glstextup"><code class="csfmt">\glstextup</code></a><a id="wrglossary.3914"></a><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a>
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3915"></a><code class="code"><dfn id="glo:glsabbrvsmfont"><code class="csfmt">\glsabbrvsmfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Formatting for the <span class="qt">“sm”</span> short form. This uses <a id="wrglossary.3916"></a><a href="#glo:textsmaller"><code class="csfmt">\textsmaller</code></a>, which is defined by the <a id="wrglossary.3917"></a><a href="#glo:pkg.relsize"><span class="styfmt">relsize</span></a> package. You will need to load that package if you want to use any of the <span class="qt">“sm”</span> styles.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+<a id="wrglossary.3918"></a><a href="#glo:textsmaller"><code class="csfmt">\textsmaller</code></a> reduces the font size, so if you want to use it to simulate <a id="wrglossary.3919"></a><a href="#glo:idx.smallcaps">small caps</a>, you need to use <a id="wrglossary.3920"></a><a href="#glo:idx.uppercase">uppercase</a> characters in the abbreviation. </div><!-- end of information -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3921"></a><code class="code"><dfn id="glo:glsfirstabbrvsmfont"><code class="csfmt">\glsfirstabbrvsmfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Formatting for the <span class="qt">“sm”</span> short form shown on <a id="wrglossary.3922"></a><a href="#glo:dual.firstuse">first use</a>. This defaults to <a id="wrglossary.3923"></a><a href="#glo:glsabbrvsmfont"><code class="csfmt">\glsabbrvsmfont</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3924"></a><code class="code"><dfn id="glo:glsxtrsmrevert"><code class="csfmt">\glsxtrsmrevert</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Counteracts the effect of <a id="wrglossary.3925"></a><a href="#glo:glsabbrvsmfont"><code class="csfmt">\glsabbrvsmfont</code></a>. This defaults to <a id="wrglossary.3926"></a><a href="#glo:textlarger"><code class="csfmt">\textlarger</code></a>. If you redefine <a id="wrglossary.3927"></a><a href="#glo:glsabbrvsmfont"><code class="csfmt">\glsabbrvsmfont</code></a>, you will need to redefine <a id="wrglossary.3928"></a><a href="#glo:glsxtrsmrevert"><code class="csfmt">\glsxtrsmrevert</code></a> as applicable.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3929"></a><code class="code"><dfn id="glo:glsxtrsmsuffix"><code class="csfmt">\glsxtrsmsuffix</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Short plural suffix used by the <span class="qt">“sm”</span> styles. This defaults to <a id="wrglossary.3930"></a><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3931"></a><code class="code"><dfn id="glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Formatting for the <span class="qt">“em”</span> short form. This uses <a id="wrglossary.3932"></a><a href="#glo:emph"><code class="csfmt">\emph</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3933"></a><code class="code"><dfn id="glo:glsfirstabbrvemfont"><code class="csfmt">\glsfirstabbrvemfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Formatting for the <span class="qt">“em”</span> short form shown on <a id="wrglossary.3934"></a><a href="#glo:dual.firstuse">first use</a>. This defaults to <a id="wrglossary.3935"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3936"></a><code class="code"><dfn id="glo:glsxtremrevert"><code class="csfmt">\glsxtremrevert</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Counteracts the effect of <a id="wrglossary.3937"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a>. This defaults to <a id="wrglossary.3938"></a><a href="#glo:textup"><code class="csfmt">\textup</code></a>. If you redefine <a id="wrglossary.3939"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a>, you will need to redefine <a id="wrglossary.3940"></a><a href="#glo:glsxtremrevert"><code class="csfmt">\glsxtremrevert</code></a> as applicable.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3941"></a><code class="code"><dfn id="glo:glsxtremsuffix"><code class="csfmt">\glsxtremsuffix</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Short plural suffix used by the <span class="qt">“em”</span> styles. This defaults to <a id="wrglossary.3942"></a><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3943"></a><code class="code"><dfn id="glo:glslongemfont"><code class="csfmt">\glslongemfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Formatting for the <span class="qt">“em”</span> long form. This uses <a id="wrglossary.3944"></a><a href="#glo:emph"><code class="csfmt">\emph</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3945"></a><code class="code"><dfn id="glo:glsfirstlongemfont"><code class="csfmt">\glsfirstlongemfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Formatting for the <span class="qt">“em”</span> short form shown on <a id="wrglossary.3946"></a><a href="#glo:dual.firstuse">first use</a>. This defaults to <a id="wrglossary.3947"></a><a href="#glo:glslongemfont"><code class="csfmt">\glslongemfont</code></a>.<p>
+
+</section><!-- end of section sec:abbrvcmdsfonts -->
+
+<section id="sec:advancedabbrstylecmds"><!-- start of section sec:advancedabbrstylecmds --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->4.5.2. Advanced Style Commands<div class="labellink"><a href="#sec:advancedabbrstylecmds">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+These commands should typically not be needed in a document, but are provided for advanced users. See §<a href="#sec:abbrvcmds">4.5.1.3</a> for commands to adjust the predefined abbreviation styles.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3948"></a><code class="code"><dfn id="glo:glssetabbrvfmt"><code class="csfmt">\glssetabbrvfmt</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Sets the current formatting commands (§<a href="#sec:abbrstylefmts">4.5.3.2</a>) associated with the abbreviation style associated with the given category. That is, the command redefinitions provided in the third argument (<span class="meta">〈<em class="metainner">display definitions</em>〉</span>) of <a id="wrglossary.3949"></a><a href="#glo:newabbreviationstyle"><code class="csfmt">\newabbreviationstyle</code></a> are applied.<p>
+If no abbreviation style has been set for the given category, the style associated with the <a id="wrglossary.3950"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a> category is used.<p>
+This command is used:
+<ul class="displaylist">
+ <li><span class="bulletitem">•</span>At the start of <a id="wrglossary.3951"></a><a href="#glo:glsentryfmt"><code class="csfmt">\glsentryfmt</code></a> if the current entry has the <a id="wrglossary.3952"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> field set. This ensures that the <a id="wrglossary.3953"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands use the appropriate formatting.<p>
+<li><span class="bulletitem">•</span>At the start of <a id="wrglossary.3954"></a><a href="#glo:glsxtrassignfieldfont"><code class="csfmt">\glsxtrassignfieldfont</code></a> if the current entry has the <a id="wrglossary.3955"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> field set. This ensures that the <a id="wrglossary.3956"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands use the appropriate formatting (where possible).<p>
+<li><span class="bulletitem">•</span>At the start of <a id="wrglossary.3957"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>, <a id="wrglossary.3958"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a>, <a id="wrglossary.3959"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> and their plural and case-changing variants.<p>
+<li><span class="bulletitem">•</span>At the start of <a id="wrglossary.3960"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a>, <a id="wrglossary.3961"></a><a href="#glo:glossentrynameother"><code class="csfmt">\glossentrynameother</code></a>, <a id="wrglossary.3962"></a><a href="#glo:glossentrydesc"><code class="csfmt">\glossentrydesc</code></a>, <a id="wrglossary.3963"></a><a href="#glo:Glossentrydesc"><code class="csfmt">\Glossentrydesc</code></a>, <a id="wrglossary.3964"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a> and <a id="wrglossary.3965"></a><a href="#glo:Glossentrysymbol"><code class="csfmt">\Glossentrysymbol</code></a>.
+</ul>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3966"></a><code class="code"><dfn id="glo:glsuseabbrvfont"><code class="csfmt">\glsuseabbrvfont</code></dfn>{<span class="meta">〈<em class="metainner">style-name</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ A robust command that applies the abbreviation font for the given category to the supplied text.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3967"></a><code class="code"><dfn id="glo:glsuselongfont"><code class="csfmt">\glsuselongfont</code></dfn>{<span class="meta">〈<em class="metainner">style-name</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ A robust command that applies the long font for the given category to the supplied text.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3968"></a><code class="code"><dfn id="glo:GlsXtrUseAbbrStyleSetup"><code class="csfmt">\GlsXtrUseAbbrStyleSetup</code></dfn>{<span class="meta">〈<em class="metainner">style-name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This implements the given abbreviation style’s setup code. Note that this expects the placeholder macros and token registers to be set. This may be used in the <span class="meta">〈<em class="metainner">setup</em>〉</span> of <a id="wrglossary.3969"></a><a href="#glo:newabbreviationstyle"><code class="csfmt">\newabbreviationstyle</code></a> to inherit the setup code of a related style.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3970"></a><code class="code"><dfn id="glo:GlsXtrUseAbbrStyleFmts"><code class="csfmt">\GlsXtrUseAbbrStyleFmts</code></dfn>{<span class="meta">〈<em class="metainner">style-name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This implements the given abbreviation style’s display definitions code. This may be used in the <span class="meta">〈<em class="metainner">display definitions</em>〉</span> of <a id="wrglossary.3971"></a><a href="#glo:newabbreviationstyle"><code class="csfmt">\newabbreviationstyle</code></a> to inherit the formatting of a related style.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3972"></a><code class="code"><dfn id="glo:xpglsxtrpostabbrvfootnote"><code class="csfmt">\xpglsxtrpostabbrvfootnote</code></dfn></code></div><!-- end of pinnedbox -->
+ This is used by styles like <a id="wrglossary.3973"></a><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">postfootnote</span></a> to ensure that the label and inner and outer formatting are expanded before being passed to <a id="wrglossary.3974"></a><a href="#glo:glsxtrpostabbrvfootnote"><code class="csfmt">\glsxtrpostabbrvfootnote</code></a>, otherwise they may lose their definitions before the footnote text is typeset.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3975"></a><code class="code"><dfn id="glo:glsxtrpostabbrvfootnote"><code class="csfmt">\glsxtrpostabbrvfootnote</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-code</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is used by the footnote styles that defer the footnote to the <a id="wrglossary.3976"></a><a href="#glo:dual.postlinkhook">post-link hook</a>. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newrobustcmd</code>*{<a id="wrglossary.3977"></a><a href="#glo:glsxtrpostabbrvfootnote"><code class="csfmt">\glsxtrpostabbrvfootnote</code></a>}[2]{%
+ <a id="wrglossary.3978"></a><a href="#glo:glsxtrabbrvfootnote"><code class="csfmt">\glsxtrabbrvfootnote</code></a>{#1}%
+ {#2<a id="wrglossary.3979"></a><a href="#glo:glsxtrpostfootnotelongformat"><code class="csfmt">\glsxtrpostfootnotelongformat</code></a>{#1}{<a id="wrglossary.3980"></a><a href="#glo:glsfirstlongfootnotefont"><code class="csfmt">\glsfirstlongfootnotefont</code></a>}}%
}
-</pre>
-<!--l. 7315--><p class="nopar" > Note that this wouldn&#8217;t work if it was instead based on one of the modified versions
-such as <a
-href="#abbrstyle.short-sc-long"><span
-class="cmss-10">short-sc-long</span></a><a
- id="dx1-34092"></a> as they explicitly use their own formatting commands, such as
-<span
-class="cmtt-10">\glsabbrvemfont</span>. The base styles, such as <a
-href="#abbrstyle.short-long"><span
-class="cmss-10">short-long</span></a><a
- id="dx1-34093"></a>, use the more generic
-<span
-class="cmtt-10">\glsabbrvfont </span>etc which makes them easier to adapt than the modified
-styles.
-</p><!--l. 7323--><p class="indent" > For further details, see the &#8220;Abbreviations&#8221; section in the documented code
-(<span
-class="cmtt-10">glossaries-extra-code.pdf</span>).
-
-
-
-</p>
-<!--l. 7326--><p class="indent" > </div>
-</p><!--l. 7326--><p class="noindent" ><a
-href="#top">Top</a><div class="chapter"><h2 class="chapterHead">5. <a
- id="sec:headtitle"></a>Entries in Sectioning Titles, Headers, Captions and Contents</h2>
-</p><!--l. 7329--><p class="indent" > The <span
-class="cmss-10">glossaries </span>user manual cautions against using commands like <span
-class="cmtt-10">\gls </span>in chapter
-or section titles. The principle problems are: </p>
- <ul class="itemize1">
- <li class="itemize">if you have a table of contents, the <a
- id="dx1-35001"></a><a
-href="#glo:firstuseflag">first use flag</a> will be unset in the contents
- rather than later in the document;
- </li>
- <li class="itemize">if you have the location lists displayed in the glossary, unwanted locations
- will be added to it corresponding to the table of contents (if present) and
- every page that contains the entry in the page header (if the page style in
- use adds the chapter or section title to the header);
- </li>
- <li class="itemize">if the page style in use adds the chapter or section title to the header and
- attempts to convert it to upper case, the entry label (in the argument
- of <span
-class="cmtt-10">\gls </span>etc) will be converted to upper case and the entry won&#8217;t be
- recognised;
- </li>
- <li class="itemize">if you use <span
-class="cmss-10">hyperref</span><a
- id="dx1-35002"></a>, commands like <span
-class="cmtt-10">\gls </span>can&#8217;t be expanded to a simple
- string and only the label will appear in the PDF bookmark (with a warning
- from <span
-class="cmss-10">hyperref</span><a
- id="dx1-35003"></a>);
- </li>
- <li class="itemize">if you use <span
-class="cmss-10">hyperref</span><a
- id="dx1-35004"></a>, you will end up with nested hyperlinks in the table of
- contents.</li></ul>
-<!--l. 7350--><p class="noindent" >Similar problems can also occur with captions (except for the page header and bookmark
-issues).
-</p>
-<!--l. 7353--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">5.1 </span> <a
- id="sec:simplisticapproach"></a>Simplistic Approach</h3>
-<!--l. 7356--><p class="noindent" >To get around all these problems, the <span
-class="cmss-10">glossaries </span>user manual recommends
-using the expandable non-hyperlink commands, such as <span
-class="cmtt-10">\glsentrytext</span><a
- id="dx1-36001"></a>
-(for regular entries) or <span
-class="cmtt-10">\glsentryshort</span><a
- id="dx1-36002"></a> (for abbreviations). This is the
-simplest solution, but doesn&#8217;t allow for special formatting that&#8217;s applied to
-the entry through commands like <span
-class="cmtt-10">\glstext </span>or <span
-class="cmtt-10">\glsxtrshort</span>. This means
-that if, for example, you are using one of the abbreviation styles that uses
-<span
-class="cmtt-10">\textsc</span><a
- id="dx1-36003"></a> then the short form displayed with <span
-class="cmtt-10">\glsentryshort </span>won&#8217;t use
-small caps. If you only have one abbreviation style in use, you can explicitly
-enclose <span
-class="cmtt-10">\glsentryshort{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span>in the argument of <span
-class="cmtt-10">\glsabbrvfont</span>, like
-this:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-171">
-\chapter{A&#x00A0;Chapter&#x00A0;about&#x00A0;\glsabbrvfont{\glsentryshort{html}}}
-</pre>
-<!--l. 7369--><p class="nopar" > Or, if you are using <span
-class="cmss-10">hyperref</span><a
- id="dx1-36004"></a>:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-172">
-\chapter{A&#x00A0;Chapter&#x00A0;about
-\texorpdfstring{\glsabbrvfont{\glsentryshort{html}}}{\glsentryshort{html}}}
-</pre>
-<!--l. 7374--><p class="nopar" >
-</p><!--l. 7376--><p class="indent" > Since this is a bit cumbersome, you might want to define a new command to do
-this for you. However, if you have mixed styles this won&#8217;t work as commands like
-<span
-class="cmtt-10">\gls </span>and <span
-class="cmtt-10">\glsxtrshort </span>redefine <span
-class="cmtt-10">\glsabbrvfont </span>to match the entry&#8217;s style before
-displaying it. In this case, the above example doesn&#8217;t take into account the shifting
-definitions of <span
-class="cmtt-10">\glsabbrvfont </span>and will use whatever happens to be the last
-abbreviation style in use. More complicated solutions interfere with the upper casing
-used by the standard page styles that display the chapter or section title in the page
-header using <span
-class="cmtt-10">\MakeUppercase</span><a
- id="dx1-36005"></a>.
-</p><!--l. 7387--><p class="indent" > The <span
-class="cmss-10">glossaries-extra </span>package tries to resolve this by modifying <span
-class="cmtt-10">\markright</span><a
- id="dx1-36006"></a> and
-<span
-class="cmtt-10">\markboth</span><a
- id="dx1-36007"></a> and <span
-class="cmtt-10">\@starttoc</span>. If you don&#8217;t like this change, you can restore their
-former definitions using
-</p><!--l. 7390--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-36008"></a> <span
-class="cmtt-10">\glsxtrRevertMarks </span></div><hr>
-</p><!--l. 7392--><p class="noindent" >
-If you only want to restore <span
-class="cmtt-10">\@starttoc </span>you can use:
-</p><!--l. 7394--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-36009"></a> <span
-class="cmtt-10">\glsxtrRevertTocMarks </span></div><hr>
-</p><!--l. 7396--><p class="noindent" >
-If you restore the header or table of contents commands, you&#8217;ll have to use the
-<span
-class="cmss-10">glossaries </span>manual&#8217;s recommendations of either simply using <span
-class="cmtt-10">\glsentryshort </span>(as
-above) or use the sectioning command&#8217;s option argument to provide an alternative
-for the table of contents and page header. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-173">
-\chapter[A&#x00A0;Chapter&#x00A0;about&#x00A0;\glsentryshort{html}]{A&#x00A0;Chapter&#x00A0;about&#x00A0;\gls{html}}
-</pre>
-<!--l. 7403--><p class="nopar" > Alternatively, you need to find a way to insert <span
-class="cmtt-10">\glsxtrmarkhook </span>and <span
-class="cmtt-10">\@glsxtrinmark</span>
-at the start of the header or table of contents either scoped or afterwards cancelled
-with <span
-class="cmtt-10">\@glsxtrnotinmark </span>and <span
-class="cmtt-10">\glsxtrrestoremarkhook</span>.
-</p><!--l. 7409--><p class="indent" > If you don&#8217;t revert the mark commands back with <span
-class="cmtt-10">\glsxtrRevertMarks</span>, you can
-use the commands described below in the argument of sectioning commands. You can
-still use them even if the mark commands have been reverted, but only where they
-don&#8217;t conflict with the page style.
-</p><!--l. 7415--><p class="noindent" >
-</p>
-<!--l. 7415--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">5.2 </span> <a
- id="sec:headingcommands"></a>New Commands Designed for Chapter/Section Headings</h3>
-<!--l. 7418--><p class="noindent" >The commands listed below are designed for use in chapter or section headings.
-There are still limitations, but they provide a better solution. They all use
-<span
-class="cmtt-10">\texorpdfstring</span><a
- id="dx1-37001"></a> if <span
-class="cmss-10">hyperref</span><a
- id="dx1-37002"></a> has been loaded so that the expandable non-formatted
-version is added to the PDF bookmarks. Note that since the commands that convert
-the first letter to upper case aren&#8217;t expandable, the non-case-changing version is used
-for the bookmarks. If the required field contains non-expandable (robust or fragile)
-commands that cause a problem for the bookmarks then <span
-class="cmtt-10">\texorpdfstring</span><a
- id="dx1-37003"></a> will be
-needed as appropriate in that field. (Take care if the field has its value expanded
-before being assigned.)
-</p><!--l. 7430--><p class="indent" > These commands essentially behave as though you have used <span
-class="cmtt-10">\glsxtrshort</span>,
-<span
-class="cmtt-10">\glstext </span>etc with the options <span
-class="cmss-10">noindex</span><a
- id="dx1-37004"></a> and <span
-class="cmss-10">hyper=false</span><a
- id="dx1-37005"></a>. The text produced won&#8217;t be
-converted to upper case in the page headings by default. If you want the text
-converted to upper case you need to set the <a
-href="#catattr.headuc"><span
-class="cmss-10">headuc</span></a><a
- id="dx1-37006"></a> attribute to &#8220;true&#8221; for the
-appropriate category.
-</p><!--l. 7438--><p class="indent" > <div class="important" title="Important Note"> If you use one of the <span
-class="cmtt-10">\textsc</span><a
- id="dx1-37007"></a> styles, be aware that the default fonts don&#8217;t
-provide bold small-caps or italic small-caps. This means that if the chapter
-or section title style uses bold, this may override the small-caps setting,
-in which case the abbreviation will just appear as lower case bold. If the
-heading style uses italic, the abbreviation may appear in upright small-caps,
-<span
-class="cmti-10">even if you have set the </span><a
-href="#catattr.headuc"><span
-class="cmssi-10">headuc</span></a><a
- id="dx1-37008"></a> <span
-class="cmti-10">attribute </span>since the all-capitals form still uses
-<span
-class="cmtt-10">\glsabbrvfont</span>. You may want to consider using the <span
-class="cmss-10">slantsc</span><a
- id="dx1-37009"></a> package in this case.
-</div>
-</p><!--l. 7449--><p class="noindent" >
-</p><!--l. 7451--><p class="indent" > Display the short form:
-</p><!--l. 7452--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37010"></a> <span
-class="cmtt-10">\glsfmtshort{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-
-
-
-</p><!--l. 7454--><p class="noindent" >
-</p><!--l. 7456--><p class="indent" > Display the plural short form:
-</p><!--l. 7457--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37011"></a> <span
-class="cmtt-10">\glsfmtshortpl{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7459--><p class="noindent" >
-</p><!--l. 7461--><p class="indent" > First letter upper case singular short form:
-</p><!--l. 7462--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37012"></a> <span
-class="cmtt-10">\Glsfmtshort{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7464--><p class="noindent" >
-(No case-change applied to PDF bookmarks.)
-</p><!--l. 7467--><p class="indent" > First letter upper case plural short form:
-</p><!--l. 7468--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37013"></a> <span
-class="cmtt-10">\Glsfmtshortpl{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7470--><p class="noindent" >
-(No case-change applied to PDF bookmarks.)
-</p><!--l. 7473--><p class="indent" > All caps singular short form:
-</p><!--l. 7474--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37014"></a> <span
-class="cmtt-10">\GLSfmtshort{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7476--><p class="noindent" >
-(No case-change applied to PDF bookmarks.)
-</p><!--l. 7479--><p class="indent" > All caps plural short form:
-</p><!--l. 7480--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37015"></a> <span
-class="cmtt-10">\Glsfmtshortpl{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7482--><p class="noindent" >
-(No case-change applied to PDF bookmarks.)
-</p><!--l. 7485--><p class="indent" > Display the long form:
-</p><!--l. 7486--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37016"></a> <span
-class="cmtt-10">\glsfmtlong{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7488--><p class="noindent" >
-</p><!--l. 7490--><p class="indent" > Display the plural long form:
-</p><!--l. 7491--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37017"></a> <span
-class="cmtt-10">\glsfmtlongpl{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7493--><p class="noindent" >
-</p><!--l. 7495--><p class="indent" > First letter upper case singular long form:
-</p><!--l. 7496--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37018"></a> <span
-class="cmtt-10">\Glsfmtlong{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7498--><p class="noindent" >
-(No case-change applied to PDF bookmarks.)
-</p><!--l. 7501--><p class="indent" > First letter upper case plural long form:
-</p><!--l. 7502--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37019"></a> <span
-class="cmtt-10">\Glsfmtlongpl{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7504--><p class="noindent" >
-(No case-change applied to PDF bookmarks.)
-</p><!--l. 7507--><p class="indent" > All caps singular long form:
-</p><!--l. 7508--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37020"></a> <span
-class="cmtt-10">\GLSfmtlong{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7510--><p class="noindent" >
-(No case-change applied to PDF bookmarks.)
-</p><!--l. 7513--><p class="indent" > All caps plural long form:
-</p><!--l. 7514--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37021"></a> <span
-class="cmtt-10">\GLSfmtlongpl{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7516--><p class="noindent" >
-(No case-change applied to PDF bookmarks.)
-
-
-
-</p><!--l. 7519--><p class="indent" > There are similar commands for the full form, but note that these use the <span
-class="cmti-10">inline</span>
-full form, which may be different from the full form used by <span
-class="cmtt-10">\gls</span>. The PDF version
-has to be a simple fully expandable command, so one of two commands that are
-unrelated to the style is used instead:
-</p><!--l. 7524--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37022"></a> <span
-class="cmtt-10">\glspdffmtfull{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7526--><p class="noindent" >
-for the singular form or:
-</p><!--l. 7528--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37023"></a> <span
-class="cmtt-10">\glspdffmtfullpl{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7530--><p class="noindent" >
-for the full form. These simply do the long form followed by the short form in
-parentheses.
-</p><!--l. 7534--><p class="indent" > Display the full form:
-</p><!--l. 7535--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37024"></a> <span
-class="cmtt-10">\glsfmtfull{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7537--><p class="noindent" >
-</p><!--l. 7539--><p class="indent" > Display the plural full form:
-</p><!--l. 7540--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37025"></a> <span
-class="cmtt-10">\glsfmtfullpl{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7542--><p class="noindent" >
-</p><!--l. 7544--><p class="indent" > First letter upper case singular full form:
-</p><!--l. 7545--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37026"></a> <span
-class="cmtt-10">\Glsfmtfull{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7547--><p class="noindent" >
-(No case-change applied to PDF bookmarks.)
-</p><!--l. 7550--><p class="indent" > First letter upper case plural full form:
-</p><!--l. 7551--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37027"></a> <span
-class="cmtt-10">\Glsfmtfullpl{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7553--><p class="noindent" >
-(No case-change applied to PDF bookmarks.)
-</p><!--l. 7556--><p class="indent" > All caps singular full form:
-</p><!--l. 7557--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37028"></a> <span
-class="cmtt-10">\GLSfmtfull{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7559--><p class="noindent" >
-(No case-change applied to PDF bookmarks.)
-</p><!--l. 7562--><p class="indent" > All caps plural full form:
-</p><!--l. 7563--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37029"></a> <span
-class="cmtt-10">\GLSfmtfullpl{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7565--><p class="noindent" >
-(No case-change applied to PDF bookmarks.)
-</p><!--l. 7568--><p class="indent" > There are also equivalent commands for the value of the <span
-class="cmss-10">text</span><a
- id="dx1-37030"></a> field:
-</p><!--l. 7570--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37031"></a> <span
-class="cmtt-10">\glsfmttext{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7572--><p class="noindent" >
-</p><!--l. 7574--><p class="indent" > First letter converted to upper case:
-</p><!--l. 7575--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37032"></a> <span
-class="cmtt-10">\Glsfmttext{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7577--><p class="noindent" >
-(No case-change applied to PDF bookmarks.)
-</p><!--l. 7580--><p class="indent" > All caps:
-</p><!--l. 7581--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37033"></a> <span
-class="cmtt-10">\GLSfmttext{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-
-
-
-</p><!--l. 7583--><p class="noindent" >
-(No case-change applied to PDF bookmarks.)
-</p><!--l. 7586--><p class="indent" > The plural equivalents:
-</p><!--l. 7587--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37034"></a> <span
-class="cmtt-10">\glsfmtplural{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7589--><p class="noindent" >
-First letter upper case:
-</p><!--l. 7591--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37035"></a> <span
-class="cmtt-10">\Glsfmtplural{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7593--><p class="noindent" >
-and all caps:
-</p><!--l. 7595--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37036"></a> <span
-class="cmtt-10">\GLSfmtplural{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7597--><p class="noindent" >
-</p><!--l. 7599--><p class="indent" > Likewise for the value of the <span
-class="cmss-10">name</span><a
- id="dx1-37037"></a> field:
-</p><!--l. 7601--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37038"></a> <span
-class="cmtt-10">\glsfmtname{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7603--><p class="noindent" >
-</p><!--l. 7605--><p class="indent" > First letter converted to upper case:
-</p><!--l. 7606--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37039"></a> <span
-class="cmtt-10">\Glsfmtname{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7608--><p class="noindent" >
-(No case-change applied to PDF bookmarks.)
-</p><!--l. 7611--><p class="indent" > All caps:
-</p><!--l. 7612--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37040"></a> <span
-class="cmtt-10">\GLSfmtname{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7614--><p class="noindent" >
-(No case-change applied to PDF bookmarks.)
-</p><!--l. 7617--><p class="indent" > Similarly for the value of the <span
-class="cmss-10">first</span><a
- id="dx1-37041"></a> field:
-</p><!--l. 7619--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37042"></a> <span
-class="cmtt-10">\glsfmtfirst{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7621--><p class="noindent" >
-</p><!--l. 7623--><p class="indent" > First letter converted to upper case:
-</p><!--l. 7624--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37043"></a> <span
-class="cmtt-10">\Glsfmtfirst{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7626--><p class="noindent" >
-(No case-change applied to PDF bookmarks.)
-</p><!--l. 7629--><p class="indent" > All caps:
-</p><!--l. 7630--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37044"></a> <span
-class="cmtt-10">\GLSfmtfirst{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7632--><p class="noindent" >
-(No case-change applied to PDF bookmarks.)
-</p><!--l. 7635--><p class="indent" > The plural equivalents:
-</p><!--l. 7636--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37045"></a> <span
-class="cmtt-10">\glsfmtfirstpl{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7638--><p class="noindent" >
-First letter upper case:
-</p><!--l. 7640--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37046"></a> <span
-class="cmtt-10">\Glsfmtfirstpl{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7642--><p class="noindent" >
-and all caps:
-</p><!--l. 7644--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-37047"></a> <span
-class="cmtt-10">\GLSfmtfirstpl{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7646--><p class="noindent" >
-
-
-
-
-
-
-</p>
-<!--l. 7648--><p class="indent" > </div>
-</p><!--l. 7648--><p class="noindent" ><a
-href="#top">Top</a><div class="chapter"><h2 class="chapterHead">6. <a
- id="sec:multientries"></a>Multi (or Compound) Entries</h2>
-</p><!--l. 7651--><p class="indent" > Nested entries (where the entry definition references other entries) are discussed
-in <a
-href="#sec:nested"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.8</span> </a><a
-href="#sec:nested">Nested Links<!--tex4ht:ref: sec:nested --></a>. This chapter deals with occasions where a term or
-phrase may consist of multiple sub-terms that are independently defined. (Examples
-in <a
-href="#sec:exskipfirstsuffix"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.1.5</span> </a><a
-href="#sec:exskipfirstsuffix">Example: Skipping Elements (Fragment Element)<!--tex4ht:ref: sec:exskipfirstsuffix --></a> and
-<a
-href="#sec:exskippostlink"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.1.6</span> </a><a
-href="#sec:exskippostlink">Example: Skipping Elements (Prefix and Post-Link Hooks)<!--tex4ht:ref: sec:exskippostlink --></a>
-provide workarounds for nested entries.)
-</p><!--l. 7659--><p class="indent" > For example, the names of bacteria, such as <span
-class="cmti-10">Clostridium botulinum </span>and
-<span
-class="cmti-10">Clostridium perfringens</span>, are made up of the genus (for example, <span
-class="cmti-10">Clostridium</span>) and
-the species (for example, <span
-class="cmti-10">botulinum </span>or <span
-class="cmti-10">perfringens</span>). The genus is often abbreviated
-after <a
- id="dx1-38001"></a><a
-href="#glo:firstuse">first use</a>. For example, <span
-class="cmti-10">C. botulinum</span>. However, if the name is defined as a
-single term consisting of both the genus and species then it&#8217;s not possible
-to apply the abbreviation when a different species with the same genus is
-used.
-</p><!--l. 7669--><p class="indent" > Consider the following document:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-174">
-\documentclass{article}
-\usepackage{glossaries-extra}
-\setabbreviationstyle{long-only-short-only}
-\newabbreviation{cbot}{C.&#x00A0;botulinum}{Clostridium&#x00A0;botulinum}
-\newabbreviation{cperf}{C.&#x00A0;perfringens}{Clostridium&#x00A0;perfringens}
-\begin{document}
-\gls{cbot},&#x00A0;\gls{cbot},&#x00A0;\gls{cperf}.
-\end{document}
-</pre>
-<!--l. 7679--><p class="nopar" > The result is: <spacer type=vertical size=10><span class="obeylines-h">
- <br />Clostridium botulinum, C. botulinum, Clostridium perfringens.
- <br /><spacer type=vertical size=10></span>
-However, it should more typically be: <spacer type=vertical size=10><span class="obeylines-h">
- <br />Clostridium botulinum, C. botulinum, C. perfringens.
- <br /><spacer type=vertical size=10></span>
-In this case, the genus should actually be a separate definition:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-175">
-\documentclass{article}
-\usepackage{glossaries-extra}
-\setabbreviationstyle{long-only-short-only}
-\newabbreviation{clostridium}{C.}{Clostridium}
-\newglossaryentry{botulinum}{name={botulinum},description={}}
-\newglossaryentry{perfringens}{name=perfringens,description={}}
-\begin{document}
-\gls{clostridium}&#x00A0;\gls{botulinum},
-\gls{clostridium}&#x00A0;\gls{botulinum},
-\gls{clostridium}&#x00A0;\gls{perfringens}.
-\end{document}
-</pre>
-<!--l. 7701--><p class="nopar" > This is quite awkward to write. This chapter describes how to provide a shortcut
-for this kind of construct. Each term should be defined as normal (as in
-the above example), and a &#8220;multi-entry&#8221; label is then defined with the list
-of labels of the entries that need to be referenced. This is done with the
-command:
-</p><!--l. 7707--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-38002"></a> <span
-class="cmtt-10">\multiglossaryentry[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">main label</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label list</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 7710--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">multi-label</span>&#x27E9; is the new label and &#x27E8;<span
-class="cmti-10">label list</span>&#x27E9; is the list of labels (corresponding to
-entries that have already been defined).
-</p><!--l. 7715--><p class="indent" > The &#x27E8;<span
-class="cmti-10">main label</span>&#x27E9; may be omitted, in which case the main label will be assumed to
-be the final element in &#x27E8;<span
-class="cmti-10">label list</span>&#x27E9;. If &#x27E8;<span
-class="cmti-10">main label</span>&#x27E9; is present, it must also be listed in &#x27E8;<span
-class="cmti-10">label</span>
-<span
-class="cmti-10">list</span>&#x27E9;. This is described in more detail in <a
-href="#sec:mglsmain"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.2</span> </a><a
-href="#sec:mglsmain">Main and Other
-Elements<!--tex4ht:ref: sec:mglsmain --></a>.
-</p><!--l. 7721--><p class="indent" > The &#x27E8;<span
-class="cmti-10">options</span>&#x27E9; are a comma-separated list of options to override the current settings
-and are described in <a
-href="#sec:multiglsoptions"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.9</span> </a><a
-href="#sec:multiglsoptions">Multi-Entry Settings<!--tex4ht:ref: sec:multiglsoptions --></a>.
-</p><!--l. 7724--><p class="indent" > The earlier example can now be modified to include the following:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-176">
-\multiglossaryentry{cbot}{clostridium,botulinum}
-\multiglossaryentry{cperf}{clostridium,perfringens}
-</pre>
-<!--l. 7728--><p class="nopar" > These commands must come after the definitions of <span
-class="cmtt-10">clostridium</span>, <span
-class="cmtt-10">botulinum </span>and
-<span
-class="cmtt-10">perfringens</span>.
-</p><!--l. 7732--><p class="indent" > Once defined, a multi-entry set can be referenced using commands like:
-</p><!--l. 7733--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-38003"></a> <span
-class="cmtt-10">\mgls[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 7735--><p class="noindent" >
-This command essentially does <span
-class="cmtt-10">\gls{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span>for each item in the &#x27E8;<span
-class="cmti-10">label list</span>&#x27E9; (with
-separators, see <a
-href="#sec:mglssep"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.4</span> </a><a
-href="#sec:mglssep">Separators<!--tex4ht:ref: sec:mglssep --></a>). If the final optional argument &#x27E8;<span
-class="cmti-10">insert</span>&#x27E9; is
-provided, it will be applied to the final (non-skipped) element in the list. So the
-document body in the above example, can be rewritten as:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-177">
-\mgls{cbot},&#x00A0;\mgls{cbot},&#x00A0;\mgls{cperf}.
-</pre>
-<!--l. 7744--><p class="nopar" >
-</p><!--l. 7746--><p class="indent" > There are some variants of <span
-class="cmtt-10">\mgls </span>listed in <a
-href="#sec:mglslike"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.11</span> </a><a
-href="#sec:mglslike">Variants of mgls<!--tex4ht:ref: sec:mglslike --></a>. The
-available &#x27E8;<span
-class="cmti-10">options</span>&#x27E9; are listed in <a
-href="#sec:mglsopts"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.10</span> </a><a
-href="#sec:mglsopts">mgls Options<!--tex4ht:ref: sec:mglsopts --></a>. They are applied after
-the <span
-class="cmtt-10">\multiglossaryentry </span>options and will override settings for the individual
-entries.
-</p><!--l. 7751--><p class="indent" > <div class="important" title="Important Note"> You can&#8217;t use &#x27E8;<span
-class="cmti-10">multi-label</span>&#x27E9; in commands like <span
-class="cmtt-10">\gls </span>as this label represents a set of
-entry labels not a single entry. </div>
-</p><!--l. 7754--><p class="noindent" >
-</p><!--l. 7756--><p class="indent" > The <span
-class="cmtt-10">\multiglossaryentry </span>command will generate an error if the label has
-already been defined as a multi-entry. To do nothing if a multi-entry already exists,
-use:
-</p><!--l. 7759--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-38004"></a> <span
-class="cmtt-10">\providemultiglossaryentry[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">main label</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>
-<span
-class="cmitt-10">list</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7762--><p class="noindent" >
-Notes and associated commands applying to <span
-class="cmtt-10">\multiglossaryentry </span>also apply to
-<span
-class="cmtt-10">\providemultiglossaryentry </span>unless otherwise stated.
-</p><!--l. 7767--><p class="indent" > <div class="important" title="Important Note"> <span
-class="cmtt-10">\multiglossaryentry </span>may be placed anywhere after the &#x27E8;<span
-class="cmti-10">label list</span>&#x27E9; entries have
-been defined. A multi-entry label can&#8217;t be referenced (with commands like <span
-class="cmtt-10">\mgls</span>)
-before it has been defined. </div>
-</p><!--l. 7771--><p class="noindent" >
-</p><!--l. 7773--><p class="indent" > There is limited support for <a
-href="#styopt.docdef"><span
-class="cmss-10">docdef</span></a><span
-class="cmss-10">=true</span><a
- id="dx1-38005"></a>. The multi-entry definition can be picked
-up from the <span
-class="cmtt-10">aux</span><a
- id="dx1-38006"></a> file on the next run to allow cross-references in any glossaries that
-occur at the start of the document. Any changes made with commands like
-<span
-class="cmtt-10">\mglsSetMain </span>won&#8217;t be carried over to the next run.
-</p><!--l. 7779--><p class="indent" > By default <span
-class="cmtt-10">\multiglossaryentry </span>will be localised to the current scope. If you
-want to globally define a multi-entry you need to first switch on global definitions
-with:
-</p><!--l. 7782--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-38007"></a> <span
-class="cmtt-10">\multiglossaryentryglobaltrue </span></div><hr>
-</p><!--l. 7784--><p class="noindent" >
-To switch back to local definitions use:
-</p><!--l. 7786--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-38008"></a> <span
-class="cmtt-10">\multiglossaryentryglobalfalse </span></div><hr>
-</p><!--l. 7788--><p class="noindent" >
-</p><!--l. 7790--><p class="indent" > If you want to change the multi-entry options (locally) you can use:
-</p><!--l. 7791--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-38009"></a> <span
-class="cmtt-10">\mglsSetOptions{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">new-options</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7793--><p class="noindent" >
-This removes the original options. If you want to (locally) append to the existing
-options, use:
-
-
-
-</p><!--l. 7796--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-38010"></a> <span
-class="cmtt-10">\mglsAddOptions{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">new-options</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 7798--><p class="noindent" >
-</p><!--l. 7800--><p class="indent" > Note that <span
-class="cmtt-10">\multiglossaryentry </span>doesn&#8217;t make any adjustments to the
-component entries. You will need to use the <span
-class="cmss-10">parent</span><a
- id="dx1-38011"></a> key when you define the entries
-if you want a hierarchical structure in your glossary. (See the example in
-<a
-href="#sec:mglsexhier"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.1.1</span> </a><a
-href="#sec:mglsexhier">Example: Hierarchical<!--tex4ht:ref: sec:mglsexhier --></a>.)
-</p><!--l. 7805--><p class="indent" > If you don&#8217;t want the other elements in the glossary, you can suppress the
-indexing with <span
-class="cmss-10">indexothers=false </span>(<a
-href="#sec:multiglsoptionsindexing"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.9.1</span> </a><a
-href="#sec:multiglsoptionsindexing">Indexing<!--tex4ht:ref: sec:multiglsoptionsindexing --></a>) or put
-them in an ignored glossary. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-178">
-\newignoredglossary{common}
-\newabbreviation[type=common]{clostridium}{C.}{Clostridium}
-</pre>
-<!--l. 7812--><p class="nopar" >
-</p><!--l. 7814--><p class="indent" > The &#x27E8;<span
-class="cmti-10">multi-label</span>&#x27E9; can&#8217;t be used in commands like <span
-class="cmtt-10">\gls </span>since the label refers to a set
-of entry labels not to an individual entry. Similarly, an individual entry label can&#8217;t be
-used in commands like <span
-class="cmtt-10">\mgls</span>. It is possible (although potentially confusing) to use
-the same label for a multi-entry as for an individual entry (see the example in
-<a
-href="#sec:exskippostlink"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.1.6</span> </a><a
-href="#sec:exskippostlink">Example: Skipping Elements (Prefix and Post-Link Hooks)<!--tex4ht:ref: sec:exskippostlink --></a>).
-Context will determine which is meant, except in the case of the cross-referencing
-fields (<span
-class="cmss-10">see</span><a
- id="dx1-38012"></a>, <span
-class="cmss-10">seealso</span><a
- id="dx1-38013"></a> and <span
-class="cmss-10">alias</span><a
- id="dx1-38014"></a>) where the cross-referenced label will first be tested if it&#8217;s
-a known multi-entry label.
-</p><!--l. 7826--><p class="indent" > If you don&#8217;t want to have to keep track of which labels refer to multi-entries and
-which refer to individual entries you can use:
-</p><!--l. 7828--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-38015"></a> <span
-class="cmtt-10">\GlsXtrMglsOrGls{</span>&#x27E8;<span
-class="cmitt-10">mgls cs</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">gls cs</span>&#x27E9;<span
-class="cmtt-10">}</span>&#x27E8;<span
-class="cmitt-10">modifier</span>&#x27E9;<span
-class="cmtt-10">[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">]</span>
-</div><hr>
-</p><!--l. 7831--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">mgls cs</span>&#x27E9; is the <span
-class="cmtt-10">\mgls</span>-like command to use if &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; has been defined as a
-multi-entry and &#x27E8;<span
-class="cmti-10">gls cs</span>&#x27E9; is the <span
-class="cmtt-10">\gls</span>-like command to use otherwise. The &#x27E8;<span
-class="cmti-10">modifier</span>&#x27E9; may
-be omitted, otherwise it is the modifier that may be used with <span
-class="cmtt-10">\mgls </span>or <span
-class="cmtt-10">\gls </span>(<span
-class="cmtt-10">*</span>, <span
-class="cmtt-10">+</span>
-or the character identified with <span
-class="cmtt-10">\GlsXtrSetAltModifier</span><a
- id="dx1-38016"></a>). The modifier
-and remaining options are passed to the relevant command (&#x27E8;<span
-class="cmti-10">mgls cs</span>&#x27E9; or &#x27E8;<span
-class="cmti-10">gls</span>
-<span
-class="cmti-10">cs</span>&#x27E9;).
-</p><!--l. 7841--><p class="indent" > You may prefer to define your own shortcut commands for common combinations.
-For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-179">
-\newcommand{\ac}{\GlsXtrMglsOrGls{\mgls}{\gls}}
-\newcommand{\acpl}{\GlsXtrMglsOrGls{\mglsmainpl}{\glspl}}
-\newcommand{\Ac}{\GlsXtrMglsOrGls{\Mgls}{\Gls}}
-\newcommand{\Acpl}{\GlsXtrMglsOrGls{\Mglsmainpl}{\Glspl}}
-</pre>
-<!--l. 7848--><p class="nopar" >
-</p>
-<!--l. 7850--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6.1 </span> <a
- id="sec:mglsexamples"></a>Examples</h3>
-<!--l. 7853--><p class="noindent" >
-</p>
-<!--l. 7853--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">6.1.1 </span> <a
- id="sec:mglsexhier"></a>Example: Hierarchical</h4>
-<!--l. 7856--><p class="noindent" >Bacteria names are represented by the genus (for example, Clostridium) followed by
-the species (for example, botulinum). This example has the genus as a parent of the
-species.
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-180">
-\documentclass{article}
-\usepackage[colorlinks]{hyperref}
-\usepackage[stylemods=bookindex,style=bookindex]{glossaries-extra}
-\makeglossaries
-\newcommand{\latinname}[1]{\emph{#1}}
-\glssetcategoriesattributes
-&#x00A0;{genus,species}{textformat,glossnamefont}{latinname}
-\setabbreviationstyle[genus]{long-only-short-only-desc}
-\newabbreviation
-&#x00A0;[category=genus,description={}]
-&#x00A0;{clostridium}{C.}{Clostridium}
-\newglossaryentry{botulinum}{name=botulinum,category=species,
-&#x00A0;&#x00A0;description={},parent=clostridium}
-\newglossaryentry{perfringens}{name=perfringens,category=species,
-&#x00A0;&#x00A0;description={},parent=clostridium}
-\newglossaryentry{tetani}{name=tetani,category=species,
-&#x00A0;&#x00A0;description={},parent=clostridium}
-\multiglossaryentry{cbot}{clostridium,botulinum}
-\multiglossaryentry{cperf}{clostridium,perfringens}
-\multiglossaryentry{ctet}{clostridium,tetani}
-\multiglossaryentrysetup{indexothers=false,hyper=allmain}
-\begin{document}
-First&#x00A0;use:
-\mgls{cbot},&#x00A0;\mgls{cperf},&#x00A0;\mgls{ctet}.
-Next&#x00A0;use:
-\mgls{cbot},&#x00A0;\mgls{cperf},&#x00A0;\mgls{ctet}.
-\printglossaries
-\end{document}
-</pre>
-<!--l. 7897--><p class="nopar" > This suppresses the indexing of the non-main elements (in this case, the genus).
-However the genus is included in the glossary (without a <a
- id="dx1-40001"></a><a
-href="#glo:numberlist">number list</a>) because it&#8217;s the
-parent of the species (which are indexed).
-</p><!--l. 7903--><p class="indent" > The <span
-class="cmss-10">hyper=allmain </span>option makes the entire content of each <span
-class="cmtt-10">\mgls </span>a hyperlink to
-the main entry in the glossary. The resulting document text (before the glossary)
-is:
-
-
-
- </p><blockquote class="quote">
- <!--l. 7907--><p class="noindent" >First use: <span
-class="cmti-10">Clostridium botulinum</span>, <span
-class="cmti-10">C. perfringens</span>, <span
-class="cmti-10">C. tetani</span>.
- </p><!--l. 7910--><p class="noindent" >Next use: <span
-class="cmti-10">C. botulinum</span>, <span
-class="cmti-10">C. perfringens</span>, <span
-class="cmti-10">C. tetani</span>.</p></blockquote>
-<!--l. 7914--><p class="noindent" >
-</p>
-<!--l. 7914--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">6.1.2 </span> <a
- id="sec:mglsexsuffix"></a>Example: Suffix</h4>
-<!--l. 7917--><p class="noindent" >This example has a minor modification to the previous one. In this case the
-multi-entries are defined with a suffix:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-181">
-\multiglossaryentry[firstsuffix=botulism]{cbot}{clostridium,botulinum}
-\multiglossaryentry[firstsuffix={gas&#x00A0;gangrene}]{cperf}{clostridium,perfringens}
-\multiglossaryentry[firstsuffix=tetanus]{ctet}{clostridium,tetani}
-</pre>
-<!--l. 7923--><p class="nopar" > The rest of the document is as in <a
-href="#sec:mglsexhier"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.1.1</span> </a><a
-href="#sec:mglsexhier">Example: Hierarchical<!--tex4ht:ref: sec:mglsexhier --></a>. The
-document text is now:
- </p><blockquote class="quote">
- <!--l. 7927--><p class="noindent" >First use: <span
-class="cmti-10">Clostridium botulinum </span>(botulism), <span
-class="cmti-10">C. perfringens </span>(gas
- gangrene), <span
-class="cmti-10">C. tetani </span>(tetanus).
- </p><!--l. 7931--><p class="noindent" >Next use: <span
-class="cmti-10">C. botulinum</span>, <span
-class="cmti-10">C. perfringens</span>, <span
-class="cmti-10">C. tetani</span>.</p></blockquote>
-<!--l. 7935--><p class="noindent" >
-</p>
-<!--l. 7935--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">6.1.3 </span> <a
- id="sec:mglsexcatsuffix"></a>Example: Category Suffix</h4>
-<!--l. 7938--><p class="noindent" >This is an alternative to the previous example. Instead of storing the extra
-information in the <span
-class="cmss-10">firstsuffix </span>key, the information is stored in the <span
-class="cmss-10">user1</span><a
- id="dx1-42001"></a> key of the last
-element (the species). A category suffix is used to look up the field and append
-it.
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-182">
-\newglossaryentry{botulinum}{name=botulinum,category=species,
-&#x00A0;&#x00A0;user1={botulism},
-&#x00A0;&#x00A0;description={},parent=clostridium}
-\newglossaryentry{perfringens}{name=perfringens,category=species,
-&#x00A0;&#x00A0;user1={gas&#x00A0;gangrene},
-&#x00A0;&#x00A0;description={},parent=clostridium}
-\newglossaryentry{tetani}{name=tetani,category=species,
-&#x00A0;&#x00A0;user1={tetanus},
-&#x00A0;&#x00A0;description={},parent=clostridium}
-\mglsdefcategorysuffix{bacteria}{%
-&#x00A0;\mglsisfirstuse
-&#x00A0;{\glsxtrifhasfield{useri}{\mglslastelementlabel}{&#x00A0;(\glscurrentfieldvalue)}{}}%
-&#x00A0;{}%
+</pre> The second argument will be the expansion of <a id="wrglossary.3981"></a><a href="#glo:glsxtrassignlinktextfmt"><code class="csfmt">\glsxtrassignlinktextfmt</code></a>, to allow the <a id="wrglossary.3982"></a><a href="#glo:dual.innerformatting">inner formatting</a> to be picked up, if required.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3983"></a><code class="code"><dfn id="glo:glsxtrifhyphenstart"><code class="csfmt">\glsxtrifhyphenstart</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is used by the hyphen styles to determine if the insert material starts with a hyphen. Does <span class="meta">〈<em class="metainner">true</em>〉</span> if <span class="meta">〈<em class="metainner">text</em>〉</span> starts with a hyphen otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3984"></a><code class="code"><dfn id="glo:GlsXtrWarnDeprecatedAbbrStyle"><code class="csfmt">\GlsXtrWarnDeprecatedAbbrStyle</code></dfn>{<span class="meta">〈<em class="metainner">old-name</em>〉</span>}{<span class="meta">〈<em class="metainner">new-name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is used to generate a warning (with <a id="wrglossary.3985"></a><a href="#glo:GlossariesExtraWarning"><code class="csfmt">\GlossariesExtraWarning</code></a>) if a deprecated abbreviation style is used.<p>
+
+</section><!-- end of section sec:advancedabbrstylecmds -->
+
+<section id="sec:newabbrvstyle"><!-- start of section sec:newabbrvstyle --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->4.5.3. Defining New Abbreviation Styles<div class="labellink"><a href="#sec:newabbrvstyle">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+If none of the predefined styles suit your requirements, you can define your own custom style using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3986"></a><code class="code"><dfn id="glo:newabbreviationstyle"><code class="csfmt">\newabbreviationstyle</code></dfn>{<span class="meta">〈<em class="metainner">style-name</em>〉</span>}{<span class="meta">〈<em class="metainner">setup</em>〉</span>}{<span class="meta">〈<em class="metainner">display definitions</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The first argument is the style name. This is used internally to form control sequences, so the name shouldn’t contain any special characters.<p>
+The second argument sets up the information that’s required when an abbreviation is defined (which is why the style must be set before the abbreviations with that style are defined). The relevant commands for this argument are listed in §<a href="#sec:abbrstyleinit">4.5.3.1</a>.<p>
+The third argument defines the commands that determine how the display style (<a id="wrglossary.3987"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>) and the inline style (<a id="wrglossary.3988"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>) are formatted. The relevant commands for this argument are listed in §<a href="#sec:abbrstylefmts">4.5.3.2</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3989"></a><code class="code"><dfn id="glo:renewabbreviationstyle"><code class="csfmt">\renewabbreviationstyle</code></dfn>{<span class="meta">〈<em class="metainner">style-name</em>〉</span>}{<span class="meta">〈<em class="metainner">setup</em>〉</span>}{<span class="meta">〈<em class="metainner">display definitions</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Redefines an existing abbreviation style.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3990"></a><code class="code"><dfn id="glo:letabbreviationstyle"><code class="csfmt">\letabbreviationstyle</code></dfn>{<span class="meta">〈<em class="metainner">new style</em>〉</span>}{<span class="meta">〈<em class="metainner">existing style</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Defines a synonym of an existing abbreviation style.<p>
+
+</section><!-- end of section sec:newabbrvstyle -->
+
+<section id="sec:abbrstyleinit"><!-- start of section sec:abbrstyleinit --><div class="tomain"><a href="#main">[top]</a></div>
+<h4><!-- start of subsubsection header -->4.5.3.1. Style Initialisation Hooks<div class="labellink"><a href="#sec:abbrstyleinit">[link]</a></div></h4><!-- end of subsubsection header -->
+<p>
+The style initialisation hooks should be placed in the second argument (<span class="meta">〈<em class="metainner">setup</em>〉</span>) of <a id="wrglossary.3991"></a><a href="#glo:newabbreviationstyle"><code class="csfmt">\newabbreviationstyle</code></a>. They ensure that all the fields are correctly initialised when the entry is defined with the underlying <a id="wrglossary.3992"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> command. They may also be used to set category attributes.<p>
+The following is prepended to <span class="meta">〈<em class="metainner">setup</em>〉</span> to initialise the final hook: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.3993"></a><a href="#glo:GlsXtrPostNewAbbreviation"><code class="csfmt">\GlsXtrPostNewAbbreviation</code></a>}{}
+</pre><p>
+When an entry is defined with <a id="wrglossary.3994"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>, the following steps are performed:
+<ol class="displaylist">
+ <li><span class="numitem">1.</span>Token registers are initialised to the information provided in the arguments of <a id="wrglossary.3995"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>: <a id="wrglossary.3996"></a><a href="#glo:glskeylisttok"><code class="csfmt">\glskeylisttok</code></a>, <a id="wrglossary.3997"></a><a href="#glo:glslabeltok"><code class="csfmt">\glslabeltok</code></a>, <a id="wrglossary.3998"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a> and <a id="wrglossary.3999"></a><a href="#glo:glslongtok"><code class="csfmt">\glslongtok</code></a>.<p>
+<li><span class="numitem">2.</span>The commands <a id="wrglossary.4000"></a><a href="#glo:glsxtrorgkeylist"><code class="csfmt">\glsxtrorgkeylist</code></a>, <a id="wrglossary.4001"></a><a href="#glo:glsxtrorgshort"><code class="csfmt">\glsxtrorgshort</code></a> and <a id="wrglossary.4002"></a><a href="#glo:glsxtrorglong"><code class="csfmt">\glsxtrorglong</code></a> are defined to the options, short and long values supplied to <a id="wrglossary.4003"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>. (The <a id="wrglossary.4004"></a><a href="#glo:glskeylisttok"><code class="csfmt">\glskeylisttok</code></a> <a id="wrglossary.4005"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a> and <a id="wrglossary.4006"></a><a href="#glo:glslongtok"><code class="csfmt">\glslongtok</code></a> token registers may be changed before the entry is actually defined. These commands may be used to obtain the original values.)<p>
+<li><span class="numitem">3.</span><a id="wrglossary.4007"></a><a href="#glo:ExtraCustomAbbreviationFields"><code class="csfmt">\ExtraCustomAbbreviationFields</code></a> is initialised to do nothing.<p>
+<li><span class="numitem">4.</span>Accessibility settings are initialised, if required. These redefine <a id="wrglossary.4008"></a><a href="#glo:ExtraCustomAbbreviationFields"><code class="csfmt">\ExtraCustomAbbreviationFields</code></a> to set the accessibility fields.<p>
+<li><span class="numitem">5.</span>The command <a id="wrglossary.4009"></a><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a> is defined to <code class="code">abbreviation</code>.<p>
+<li><span class="numitem">6.</span>The options list is parsed for the following keys: <a id="wrglossary.4010"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> and, if accessibility is enabled, <a id="wrglossary.4011"></a><a href="#glo:opt.gloskey.access"><span class="csoptfmt">access</span></a>, <a id="wrglossary.4012"></a><a href="#glo:opt.gloskey.textaccess"><span class="csoptfmt">textaccess</span></a>, <a id="wrglossary.4013"></a><a href="#glo:opt.gloskey.pluralaccess"><span class="csoptfmt">pluralaccess</span></a>, <a id="wrglossary.4014"></a><a href="#glo:opt.gloskey.firstaccess"><span class="csoptfmt">firstaccess</span></a>, <a id="wrglossary.4015"></a><a href="#glo:opt.gloskey.firstpluralaccess"><span class="csoptfmt">firstpluralaccess</span></a>, <a id="wrglossary.4016"></a><a href="#glo:opt.gloskey.shortaccess"><span class="csoptfmt">shortaccess</span></a>, <a id="wrglossary.4017"></a><a href="#glo:opt.gloskey.shortpluralaccess"><span class="csoptfmt">shortpluralaccess</span></a>, <a id="wrglossary.4018"></a><a href="#glo:opt.gloskey.longaccess"><span class="csoptfmt">longaccess</span></a>, and <a id="wrglossary.4019"></a><a href="#glo:opt.gloskey.longpluralaccess"><span class="csoptfmt">longpluralaccess</span></a>.<p>
+<li><span class="numitem">7.</span>The abbreviation style is applied for the category given by <a id="wrglossary.4020"></a><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a> (which may have been changed when the options were parsed in the previous step) or the fallback if no abbreviation style is associated with that category. This performs both the <span class="meta">〈<em class="metainner">setup</em>〉</span> and <span class="meta">〈<em class="metainner">display definitions</em>〉</span> provided when the style was defined with <a id="wrglossary.4021"></a><a href="#glo:newabbreviationstyle"><code class="csfmt">\newabbreviationstyle</code></a>.<p>
+<li><span class="numitem">8.</span>The long plural form is initialised to its default value (<span class="meta">〈<em class="metainner">long</em>〉</span><a id="wrglossary.4022"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a>).<p>
+<li><span class="numitem">9.</span>The <a id="wrglossary.4023"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a> attribute, if set, is implemented for the singular long form. It will also mark the entry as having a description with formatting (using <a id="wrglossary.4024"></a><a href="#glo:glsexclapplyinnerfmtfield"><code class="csfmt">\glsexclapplyinnerfmtfield</code></a>).<p>
+<li><span class="numitem">10.</span>The <a id="wrglossary.4025"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a> attribute is implemented, if set, otherwise the <a id="wrglossary.4026"></a><a href="#glo:opt.catattr.insertdots"><span class="csoptfmt">insertdots</span></a> attribute is implemented, if set, for the singular short form.<p>
+<li><span class="numitem">11.</span>The <a id="wrglossary.4027"></a><a href="#glo:opt.catattr.aposplural"><span class="csoptfmt">aposplural</span></a> attribute is implemented, if set, otherwise the <a id="wrglossary.4028"></a><a href="#glo:opt.catattr.noshortplural"><span class="csoptfmt">noshortplural</span></a> attribute is implemented, if set. This step will set the default short plural.<p>
+<li><span class="numitem">12.</span><a id="wrglossary.4029"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a> is updated to reflect any changes.<p>
+<li><span class="numitem">13.</span>The <a id="wrglossary.4030"></a><a href="#glo:glsxtrnewabbrevpresetkeyhook"><code class="csfmt">\glsxtrnewabbrevpresetkeyhook</code></a> hook is performed.<p>
+<li><span class="numitem">14.</span>The options list is parsed for the <a id="wrglossary.4031"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> and <a id="wrglossary.4032"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> keys. The <a id="wrglossary.4033"></a><a href="#glo:glskeylisttok"><code class="csfmt">\glskeylisttok</code></a> token is updated to only include the remaining keys that haven’t yet been processed.<p>
+<li><span class="numitem">15.</span>The <a id="wrglossary.4034"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a> attribute, if set, is implemented for the plural long form.<p>
+<li><span class="numitem">16.</span>The <a id="wrglossary.4035"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a> attribute, if set, otherwise the <a id="wrglossary.4036"></a><a href="#glo:opt.catattr.insertdots"><span class="csoptfmt">insertdots</span></a> attribute, if set, is implemented for the plural short form.<p>
+<li><span class="numitem">17.</span>The <a id="wrglossary.4037"></a><a href="#glo:glsshortpltok"><code class="csfmt">\glsshortpltok</code></a> and <a id="wrglossary.4038"></a><a href="#glo:glslongpltok"><code class="csfmt">\glslongpltok</code></a> registers are set.<p>
+<li><span class="numitem">18.</span><a id="wrglossary.4039"></a><a href="#glo:newabbreviationhook"><code class="csfmt">\newabbreviationhook</code></a> performed.<p>
+<li><span class="numitem">19.</span>The entry is defined using <a id="wrglossary.4040"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> with the key value list: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4041"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.4042"></a><a href="#glo:glsxtrabbrvtype"><code class="csfmt">\glsxtrabbrvtype</code></a>}</span>,
+<a id="wrglossary.4043"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={abbreviation}</span>,
+<a id="wrglossary.4044"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a><span class="optfmt">={<code class="cmd">\the</code><a id="wrglossary.4045"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a>}</span>,
+<a id="wrglossary.4046"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a><span class="optfmt">={<code class="cmd">\the</code><a id="wrglossary.4047"></a><a href="#glo:glsshortpltok"><code class="csfmt">\glsshortpltok</code></a>}</span>,
+<a id="wrglossary.4048"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a><span class="optfmt">={<code class="cmd">\the</code><a id="wrglossary.4049"></a><a href="#glo:glslongtok"><code class="csfmt">\glslongtok</code></a>}</span>,
+<a id="wrglossary.4050"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a><span class="optfmt">={<code class="cmd">\the</code><a id="wrglossary.4051"></a><a href="#glo:glslongpltok"><code class="csfmt">\glslongpltok</code></a>}</span>,
+<a id="wrglossary.4052"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\the</code><a id="wrglossary.4053"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a>}</span>,
+<a id="wrglossary.4054"></a><a href="#glo:CustomAbbreviationFields"><code class="csfmt">\CustomAbbreviationFields</code></a>,
+<a id="wrglossary.4055"></a><a href="#glo:ExtraCustomAbbreviationFields"><code class="csfmt">\ExtraCustomAbbreviationFields</code></a>
+<code class="cmd">\the</code><a id="wrglossary.4056"></a><a href="#glo:glskeylisttok"><code class="csfmt">\glskeylisttok</code></a>
+</pre><p>
+<li><span class="numitem">20.</span>Add the <a id="wrglossary.4057"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, <a id="wrglossary.4058"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a>, <a id="wrglossary.4059"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a>, <a id="wrglossary.4060"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> and <a id="wrglossary.4061"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> keys to the list of <a id="wrglossary.4062"></a><a href="#glo:dual.innerformatting">inner formatting</a> exclusions, as they include formatting commands.<p>
+<li><span class="numitem">21.</span>Final hook <a id="wrglossary.4063"></a><a href="#glo:GlsXtrPostNewAbbreviation"><code class="csfmt">\GlsXtrPostNewAbbreviation</code></a> performed.
+</ol>
+<p>
+Note that when these hooks (except the last) are used, the entry hasn’t yet been defined. However, some information will have already been picked up from the arguments of <a id="wrglossary.4064"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>. These can be accessed in the hooks using the following (but make sure they are fully expanded): <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4065"></a><code class="code"><dfn id="glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the entry’s category label.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4066"></a><code class="code"><dfn id="glo:glskeylisttok"><code class="csfmt">\glskeylisttok</code></dfn></code></div><!-- end of pinnedbox -->
+ A token register that contains the options that were passed to <a id="wrglossary.4067"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> with pre-processed options removed. Use <code class="code"><span class="cmdfmt">\the</span><a id="wrglossary.4068"></a><a href="#glo:glskeylisttok"><code class="csfmt">\glskeylisttok</code></a></code> to expand it.<p>
+The original option list, as supplied to <a id="wrglossary.4069"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>, can be obtained with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4070"></a><code class="code"><dfn id="glo:glsxtrorgkeylist"><code class="csfmt">\glsxtrorgkeylist</code></dfn></code></div><!-- end of pinnedbox -->
+ (Not a token register.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4071"></a><code class="code"><dfn id="glo:glslabeltok"><code class="csfmt">\glslabeltok</code></dfn></code></div><!-- end of pinnedbox -->
+ A token register that contains the entry’s label. Use <code class="code"><span class="cmdfmt">\the</span><a id="wrglossary.4072"></a><a href="#glo:glslabeltok"><code class="csfmt">\glslabeltok</code></a></code> to expand it.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4073"></a><code class="code"><dfn id="glo:glsshorttok"><code class="csfmt">\glsshorttok</code></dfn></code></div><!-- end of pinnedbox -->
+ A token register that contains the short form (which may have been modified after being passed to <a id="wrglossary.4074"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>). Use <code class="code"><span class="cmdfmt">\the</span><a id="wrglossary.4075"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a></code> to expand it.<p>
+The original short form, as supplied to <a id="wrglossary.4076"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>, can be obtained with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4077"></a><code class="code"><dfn id="glo:glsxtrorgshort"><code class="csfmt">\glsxtrorgshort</code></dfn></code></div><!-- end of pinnedbox -->
+ (Not a token register.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4078"></a><code class="code"><dfn id="glo:glsshortpltok"><code class="csfmt">\glsshortpltok</code></dfn></code></div><!-- end of pinnedbox -->
+ A token register that contains the short plural form (which may have been obtained from the short form or modified after being passed to <a id="wrglossary.4079"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>). Use <code class="code"><span class="cmdfmt">\the</span><a id="wrglossary.4080"></a><a href="#glo:glsshortpltok"><code class="csfmt">\glsshortpltok</code></a></code> to expand it.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4081"></a><code class="code"><dfn id="glo:glslongtok"><code class="csfmt">\glslongtok</code></dfn></code></div><!-- end of pinnedbox -->
+ A token register that contains the long form (which may have been modified after being passed to <a id="wrglossary.4082"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>). Use <code class="code"><span class="cmdfmt">\the</span><a id="wrglossary.4083"></a><a href="#glo:glslongtok"><code class="csfmt">\glslongtok</code></a></code> to expand it.<p>
+The original long form, as supplied to <a id="wrglossary.4084"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>, can be obtained with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4085"></a><code class="code"><dfn id="glo:glsxtrorglong"><code class="csfmt">\glsxtrorglong</code></dfn></code></div><!-- end of pinnedbox -->
+ (Not a token register.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4086"></a><code class="code"><dfn id="glo:glslongpltok"><code class="csfmt">\glslongpltok</code></dfn></code></div><!-- end of pinnedbox -->
+ A token register that contains the long plural form (which may have been obtained from the long form or modified after being passed to <a id="wrglossary.4087"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>). Use <code class="code"><span class="cmdfmt">\the</span><a id="wrglossary.4088"></a><a href="#glo:glslongpltok"><code class="csfmt">\glslongpltok</code></a></code> to expand it.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4089"></a><code class="code"><dfn id="glo:ExtraCustomAbbreviationFields"><code class="csfmt">\ExtraCustomAbbreviationFields</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to additional field definitions for the entry. This is used to add the accessibility fields (such as <a id="wrglossary.4090"></a><a href="#glo:opt.gloskey.shortaccess"><span class="csoptfmt">shortaccess</span></a>), if enabled. The abbreviation style may append (<a id="wrglossary.4091"></a><a href="#glo:appto"><code class="csfmt">\appto</code></a>) or prepend (<a id="wrglossary.4092"></a><a href="#glo:preto"><code class="csfmt">\preto</code></a>) additional information, if required, to this hook.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+If you alter this hook, make sure that you include the trailing comma after each <code class="code"><span class="meta">〈<em class="metainner">key</em>〉</span>={value}</code>, including the last one. </div><!-- end of important -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4093"></a><code class="code"><dfn id="glo:CustomAbbreviationFields"><code class="csfmt">\CustomAbbreviationFields</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the default field definitions for the entry. Take care to protect any commands that shouldn’t be expanded. The comma may be omitted from the final <code class="code"><span class="meta">〈<em class="metainner">key</em>〉</span>={value}</code>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4094"></a><code class="code"><dfn id="glo:GlsXtrPostNewAbbreviation"><code class="csfmt">\GlsXtrPostNewAbbreviation</code></dfn></code></div><!-- end of pinnedbox -->
+ A hook that’s used after the entry has been defined (at the end of <a id="wrglossary.4095"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>). This can be used to set category attributes, define the <a id="wrglossary.4096"></a><a href="#glo:dual.postlinkhook">post-link hook</a>, or mark the entry as having a complex style (with <a id="wrglossary.4097"></a><a href="#glo:glsxtrsetcomplexstyle"><code class="csfmt">\glsxtrsetcomplexstyle</code></a>).<p>
+For example, the <a id="wrglossary.4098"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> abbreviation style includes the following in <span class="meta">〈<em class="metainner">setup</em>〉</span>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.4099"></a><a href="#glo:GlsXtrPostNewAbbreviation"><code class="csfmt">\GlsXtrPostNewAbbreviation</code></a>}{%
+ <a id="wrglossary.4100"></a><a href="#glo:glsxtrsetcomplexstyle"><code class="csfmt">\glsxtrsetcomplexstyle</code></a>{<code class="cmd">\the</code><a id="wrglossary.4101"></a><a href="#glo:glslabeltok"><code class="csfmt">\glslabeltok</code></a>}{3}%
+ <a id="wrglossary.4102"></a><a href="#glo:glshasattribute"><code class="csfmt">\glshasattribute</code></a>{<code class="cmd">\the</code><a id="wrglossary.4103"></a><a href="#glo:glslabeltok"><code class="csfmt">\glslabeltok</code></a>}{regular}%
+ {%
+ <a id="wrglossary.4104"></a><a href="#glo:glssetattribute"><code class="csfmt">\glssetattribute</code></a>{<code class="cmd">\the</code><a id="wrglossary.4105"></a><a href="#glo:glslabeltok"><code class="csfmt">\glslabeltok</code></a>}{regular}{false}%
+ }%
+ {}%
}
-\multiglossaryentry[category=bacteria]{cbot}{clostridium,botulinum}
-\multiglossaryentry[category=bacteria]{cperf}{clostridium,perfringens}
-\multiglossaryentry[category=bacteria]{ctet}{clostridium,tetani}
-</pre>
-<!--l. 7963--><p class="nopar" > The result is the same as the previous example.
-</p><!--l. 7966--><p class="noindent" >
-</p>
-<!--l. 7966--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">6.1.4 </span> <a
- id="sec:mglsexsep"></a>Example: Separators</h4>
-<!--l. 7969--><p class="noindent" >The first example (<a
-href="#sec:mglsexhier"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.1.1</span> </a><a
-href="#sec:mglsexhier">Example: Hierarchical<!--tex4ht:ref: sec:mglsexhier --></a>) can be modified so that
-the species are also abbreviations. In this case, the separators are modified to
-suppress the space (<span
-class="cmtt-10">\relax</span>) if both the genus and species are abbreviated, or to use
-a non-breaking space <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">~</span></span></span> between the genus short form (shown on subsequent use) and
-the species long form (shown on first use). If the genus is showing the long form (first
-use) then a normal space is used.
-</p><!--l. 7977--><p class="indent" > Note that the separator attributes apply to the category of the element before the
-separator (not to the multi-entry category).
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-183">
-\glssetcategoryattribute{genus}{combinedfirstsepfirst}{\space}
-\glssetcategoryattribute{genus}{combinedfirstsep}{\space}
-\glssetcategoryattribute{genus}{combinedsepfirst}{~}
-\glssetcategoryattribute{genus}{combinedsep}{\relax}
-\setabbreviationstyle[species]{long-only-short-only-desc}
-\newabbreviation[category=species,
-&#x00A0;&#x00A0;description={},parent=clostridium]{botulinum}{bot.}{botulinum}
-\newabbreviation[category=species,
-&#x00A0;&#x00A0;description={},parent=clostridium]{perfringens}{per.}{perfringens}
-\newabbreviation[,category=species,
-&#x00A0;&#x00A0;description={},parent=clostridium]{tetani}{tet.}{tetani}
-</pre>
-<!--l. 7993--><p class="nopar" > This will cause a double dot at the end of the second sentence, which can be
-suppressed using the <a
-href="#catattr.discardperiod"><span
-class="cmss-10">discardperiod</span></a><a
- id="dx1-43001"></a> and <a
-href="#catattr.retainfirstuseperiod"><span
-class="cmss-10">retainfirstuseperiod</span></a><a
- id="dx1-43002"></a> attributes.
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-184">
-\glssetcategoriesattributes{species}{discardperiod,retainfirstuseperiod}{true}
-</pre>
-<!--l. 7999--><p class="nopar" > This works because the final element&#8217;s post-link hook is transferred to the
-multi-entry post-link hook, which can detect the sentence terminating period. If the
-post-link hook settings are changed, for example, to <span
-class="cmss-10">postlinks=all,mpostlink=false</span>
-then the feature won&#8217;t work as the final element&#8217;s post-link hook can&#8217;t detect the
-period (because <span
-class="cmtt-10">\gls </span>is embedded too deeply inside the internal workings of
-<span
-class="cmtt-10">\mgls</span>).
-</p><!--l. 8008--><p class="indent" > The result is:
- </p><blockquote class="quote">
- <!--l. 8010--><p class="noindent" >First use: Clostridium botulinum, C.&#x00A0;perfringens, C.&#x00A0;tetani.
- </p><!--l. 8012--><p class="noindent" >Next use: C.bot., C.per., C.tet.</p></blockquote>
-<!--l. 8015--><p class="noindent" >
-</p>
-<!--l. 8015--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">6.1.5 </span> <a
- id="sec:exskipfirstsuffix"></a>Example: Skipping Elements (Fragment Element)</h4>
-<!--l. 8018--><p class="noindent" >This example is an alternative way of dealing with nested links (see <a
-href="#sec:nested"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.8</span>
-</a><a
-href="#sec:nested">Nested Links<!--tex4ht:ref: sec:nested --></a>).
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-185">
-\documentclass{article}
-\usepackage[colorlinks]{hyperref}
-\usepackage[stylemods,style=long]{glossaries-extra}
-\makeglossaries
-\setabbreviationstyle{long-short-sc}
-\newabbreviation{ssi}{ssi}{server-side&#x00A0;includes}
-\newabbreviation{html}{html}{hypertext&#x00A0;markup&#x00A0;language}
-\setabbreviationstyle[combinedabbrv]{long-only-short-sc-only}
-\newabbreviation
-&#x00A0;[category=combinedabbrv,
-&#x00A0;&#x00A0;description={\glsxtrshort{ssi}&#x00A0;enabled&#x00A0;\glsxtrshort{html}}]
-&#x00A0;{shtml-frag}{shtml}{enabled}
-\glssetcategoryattribute{combinedabbrv}{multioptions}
-&#x00A0;{usedskipothers,firstsuffix={\glsxtrshort{\mglslastmainlabel}}}
-\multiglossaryentry
-&#x00A0;[category={combinedabbrv}]
-&#x00A0;{shtml}[shtml-frag]{ssi,shtml-frag,html}
-\begin{document}
-Individual&#x00A0;elements&#x00A0;first&#x00A0;use:&#x00A0;\gls{ssi}&#x00A0;and&#x00A0;\gls{html}.
-Individual&#x00A0;elements&#x00A0;next&#x00A0;use:&#x00A0;\gls{ssi}&#x00A0;and&#x00A0;\gls{html}.
-Multi-entry&#x00A0;first&#x00A0;use:&#x00A0;\mgls{shtml}.
-Multi-entry&#x00A0;next&#x00A0;use:&#x00A0;\mgls{shtml}.
-Resetting&#x00A0;all\glsresetall\mglsreset{shtml}:
-Multi-entry&#x00A0;first&#x00A0;use:&#x00A0;\mgls{shtml}.
-Multi-entry&#x00A0;next&#x00A0;use:&#x00A0;\mgls{shtml}.
-Individual&#x00A0;elements:&#x00A0;\gls{ssi}&#x00A0;and&#x00A0;\gls{html}.
-\printglossaries
-\end{document}
-</pre>
-<!--l. 8063--><p class="nopar" > This uses the <a
-href="#catattr.multioptions"><span
-class="cmss-10">multioptions</span></a><a
- id="dx1-44001"></a> attribute to skip &#8220;other&#8221; elements on subsequent use. The
-problematic abbreviation (SHTML) is defined as a fragment that simply expands to
-
-
-
-&#8220;enabled&#8221; on first use. Note that the description has to be supplied for the
-glossary.
-</p><!--l. 8069--><p class="indent" > The above produces (underlining added to mark the hyperlinks):
- </p><blockquote class="quote">
- <!--l. 8071--><p class="noindent" >Individual elements first use: server-side includes (<span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">s</span><span
-class="small-caps">i</span></span>) and hypertext
- markup language (<span
-class="cmcsc-10"><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>).
- </p><!--l. 8074--><p class="noindent" >Individual elements next use: <span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">s</span><span
-class="small-caps">i</span></span> and <span
-class="cmcsc-10"><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>.
- </p><!--l. 8077--><p class="noindent" >Multi-entry first use: <span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">s</span><span
-class="small-caps">i</span></span> enabled <span
-class="cmcsc-10"><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span> (<span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>).
- </p><!--l. 8080--><p class="noindent" >Multi-entry next use: <span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>.
- </p><!--l. 8082--><p class="noindent" >Resetting all:
- </p><!--l. 8084--><p class="noindent" >Multi-entry first use: server-side includes (<span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">s</span><span
-class="small-caps">i</span></span>) enabled hypertext
- markup language (<span
-class="cmcsc-10"><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>) (<span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>).
- </p><!--l. 8088--><p class="noindent" >Multi-entry next use: <span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>.
- </p><!--l. 8090--><p class="noindent" >Individual elements: <span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">s</span><span
-class="small-caps">i</span></span> and <span
-class="cmcsc-10"><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>.</p></blockquote>
-<!--l. 8092--><p class="noindent" >The key difference here from the example using <span
-class="cmtt-10">\glsps </span>at the end of <a
-href="#sec:nested"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.8</span>
-</a><a
-href="#sec:nested">Nested Links<!--tex4ht:ref: sec:nested --></a> is that the individual elements hyperlink to their respective entries in
-the glossary on first use of <span
-class="cmtt-10">\mgls</span>.
-</p><!--l. 8096--><p class="indent" > The problem is that with the <a
-href="#styopt.colorlinks"><span
-class="cmss-10">colorlinks</span></a><a
- id="dx1-44002"></a> package option, it&#8217;s not obvious where the
-hyperlinks start and end. The suffix (<span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>) will hyperlink to the &#8220;shtml&#8221; entry in
-the glossary, so the &#8220;enabled&#8221; hyperlink is redundant. The simplest fix for this is to
-add <span
-class="cmss-10">hyper=notmainfirst </span>to the option list, which will prevent &#8220;enabled&#8221; from being a
-hyperlink.
-</p><!--l. 8103--><p class="indent" > Another problem occurs where <span
-class="cmtt-10">\mgls </span>is used before the individual elements
-are used, which leads to their full expansion with a confusing amount of
-parentheses. A simple solution is to use the option <span
-class="cmss-10">mglsopts=unsetothers</span>,
-which will unset the other (not-main) elements first. This can be localised
-with <span
-class="cmss-10">presetlocal </span>but <span
-class="cmtt-10">\gls </span>will then unset the <a
- id="dx1-44003"></a><a
-href="#glo:firstuseflag">first use flag</a> globally, which
-means that the other elements won&#8217;t show the full form when they are first
-used on their on after <span
-class="cmtt-10">\mgls</span>. This can be switched to a local unset with
-<span
-class="cmss-10">others=local</span>.
-</p><!--l. 8113--><p class="indent" > The complete set of options are now:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-186">
-\glssetcategoryattribute{combinedabbrv}{multioptions}
-&#x00A0;{%
-&#x00A0;&#x00A0;hyper=notmainfirst,
-&#x00A0;&#x00A0;mglsopts={presetlocal,unsetothers,others={local}},
-&#x00A0;&#x00A0;usedskipothers,
-&#x00A0;&#x00A0;firstsuffix={\glsxtrshort{\mglslastmainlabel}}
-&#x00A0;}
-</pre>
-<!--l. 8122--><p class="nopar" > This now produces (underlining added to mark the hyperlinks):
- </p><blockquote class="quote">
- <!--l. 8125--><p class="noindent" >Individual elements first use: server-side includes (<span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">s</span><span
-class="small-caps">i</span></span>) and hypertext
- markup language (<span
-class="cmcsc-10"><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>).
- </p><!--l. 8128--><p class="noindent" >Individual elements next use: <span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">s</span><span
-class="small-caps">i</span></span> and <span
-class="cmcsc-10"><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>.
- </p><!--l. 8131--><p class="noindent" >Multi-entry first use: <span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">s</span><span
-class="small-caps">i</span></span> enabled <span
-class="cmcsc-10"><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span> (<span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>).
- </p><!--l. 8134--><p class="noindent" >Multi-entry next use: <span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>.
- </p><!--l. 8136--><p class="noindent" >Resetting all:
- </p><!--l. 8138--><p class="noindent" >Multi-entry first use: <span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">s</span><span
-class="small-caps">i</span></span> enabled <span
-class="cmcsc-10"><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span> (<span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>).
- </p><!--l. 8142--><p class="noindent" >Multi-entry next use: <span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>.
- </p><!--l. 8144--><p class="noindent" >Individual elements: server-side includes (<span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">s</span><span
-class="small-caps">i</span></span>) and hypertext markup
- language (<span
-class="cmcsc-10"><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>).</p></blockquote>
-<!--l. 8147--><p class="noindent" >This method still has two main drawbacks: the description must be added manually and
-the long form can&#8217;t be accessed with <span
-class="cmtt-10">\glsxtrlong</span>. The next example provides an
-alternative approach.
-</p><!--l. 8151--><p class="noindent" >
-</p>
-<!--l. 8151--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">6.1.6 </span> <a
- id="sec:exskippostlink"></a>Example: Skipping Elements (Prefix and Post-Link Hooks)</h4>
-<!--l. 8154--><p class="noindent" >This is a modified version of the previous example. In this case, the main element
-isn&#8217;t a fragment and also happens to have the same label as the multi-entry set.
-(<span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mgls{shtml}</span></span></span> references the multi-entry label and <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls{shtml}</span></span></span> references the
-individual entry.)
-</p><!--l. 8160--><p class="indent" > In this case, the nested parts are marked up with custom commands:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-187">
-\newrobustcmd{\combinedpre}[1]{\glsps{#1}}
-\newrobustcmd{\combinedpost}[1]{\glsps{#1}}
-\newabbreviation{shtml}{shtml}
-{{}\combinedpre{ssi}&#x00A0;enabled&#x00A0;\combinedpost{html}}
-</pre>
-<!--l. 8167--><p class="nopar" > This means that it&#8217;s no longer necessary to manually insert the description and the
-long form can be accessed as usual with <span
-class="cmtt-10">\glsxtrshort</span><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">{shtml}</span></span></span>. Note that it is
-necessary to define the custom commands robustly otherwise they will need to be
-protected against premature expansion:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-188">
-\newcommand{\combinedpre}[1]{\glsps{#1}}
-\newcommand{\combinedpost}[1]{\glsps{#1}}
-\newabbreviation{shtml}{shtml}
-{{}\protect\combinedpre{ssi}&#x00A0;enabled&#x00A0;\protect\combinedpost{html}}
-</pre>
-<!--l. 8179--><p class="nopar" > In both cases, an initial empty group is added to guard against any first letter
-uppercase commands, such as <span
-class="cmtt-10">\Glsxtrlong</span>.
-</p><!--l. 8183--><p class="indent" > The abbreviations all use the <a
-href="#abbrstyle.long-postshort-sc-user"><span
-class="cmss-10">long-postshort-sc-user</span></a><a
- id="dx1-45001"></a> style, which places the short
-form in the post-link hook on <a
- id="dx1-45002"></a><a
-href="#glo:firstuse">first use</a>. The <span
-class="cmtt-10">\gls </span>post-link hook for the main element
-can be transferred to the <span
-class="cmtt-10">\mgls </span>post-link using:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-189">
-mpostlinkelement=main
-</pre>
-<!--l. 8189--><p class="nopar" > All elements have their individual post-link hooks suppressed by default. As in
-the previous example, the other elements can be skipped on subsequent
-use:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-190">
-usedskipothers
-</pre>
-<!--l. 8195--><p class="nopar" > Within <span
-class="cmtt-10">\mgls</span>, the nested content needs to be suppressed, which can be done by
-redefining the custom commands. This can be done in the multi-entry prefix. Since
-the entire content of <span
-class="cmtt-10">\mgls </span>(except for the final multi-entry post-link hook) occurs
-inside a group, this redefinition will be localised.
-</p><!--l. 8202--><p class="indent" > The complete document is as follows:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-191">
-\documentclass{article}
-\usepackage[colorlinks]{hyperref}
-\usepackage[stylemods,style=long]{glossaries-extra}
-\makeglossaries
-\setabbreviationstyle{long-postshort-sc-user}
-\newabbreviation{ssi}{ssi}{server-side&#x00A0;includes}
-\newabbreviation{html}{html}{hypertext&#x00A0;markup&#x00A0;language}
-\newrobustcmd{\combinedpre}[1]{\glsps{#1}}
-\newrobustcmd{\combinedpost}[1]{\glsps{#1}}
-\newabbreviation{shtml}{shtml}
-{{}\combinedpre{ssi}&#x00A0;enabled&#x00A0;\combinedpost{html}}
-\glssetcategoryattribute{combinedabbrv}{multioptions}
-&#x00A0;{%
-&#x00A0;&#x00A0;mpostlinkelement=main,
-&#x00A0;&#x00A0;usedskipothers
-&#x00A0;}
-\multiglossaryentry
-&#x00A0;[category={combinedabbrv}]
-&#x00A0;{shtml}[shtml]{ssi,shtml,html}
-\mglsdefcategoryprefix{combinedabbrv}{%
-&#x00A0;\renewcommand{\combinedpre}[1]{\ignorespaces}%
-&#x00A0;\renewcommand{\combinedpost}[1]{\unskip}%
+</pre> Note that in the above, the commands within the definition of <a id="wrglossary.4106"></a><a href="#glo:GlsXtrPostNewAbbreviation"><code class="csfmt">\GlsXtrPostNewAbbreviation</code></a> are all expanded when that hook is used. However, if this hook defines other commands or hooks that will be used later, then make sure that the definitions of those commands use the inner hook’s own placeholder commands.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+Remember that the <a id="wrglossary.4107"></a><a href="#glo:dual.postlinkhook">post-link hook</a> uses <a id="wrglossary.4108"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a> to reference the current label. Don’t use <a id="wrglossary.4109"></a><a href="#glo:glslabeltok"><code class="csfmt">\glslabeltok</code></a> as that will contain the label of the last abbreviation to be defined. </div><!-- end of information -->
+<p>
+For example, the <a id="wrglossary.4110"></a><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen"><span class="abbrstylefmt">long-hyphen-postshort-hyphen</span></a> style has: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.4111"></a><a href="#glo:GlsXtrPostNewAbbreviation"><code class="csfmt">\GlsXtrPostNewAbbreviation</code></a>}{%
+ <a id="wrglossary.4112"></a><a href="#glo:glsexclapplyinnerfmtfield"><code class="csfmt">\glsexclapplyinnerfmtfield</code></a>{<code class="cmd">\the</code><a id="wrglossary.4113"></a><a href="#glo:glslabeltok"><code class="csfmt">\glslabeltok</code></a>}{desc}%
+ <a id="wrglossary.4114"></a><a href="#glo:csdef"><code class="csfmt">\csdef</code></a>{glsxtrpostlink<a id="wrglossary.4115"></a><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a>}{%
+ <a id="wrglossary.4116"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a>
+ {%
+ <a id="wrglossary.4117"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a><a id="wrglossary.4118"></a><a href="#glo:glsxtrposthyphenshort"><code class="csfmt">\glsxtrposthyphenshort</code></a><a id="wrglossary.4119"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a><a id="wrglossary.4120"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>
+ <a id="wrglossary.4121"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a>{<a id="wrglossary.4122"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a>}%
+ }%
+ {%
+ <a id="wrglossary.4123"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a><a id="wrglossary.4124"></a><a href="#glo:glsxtrposthyphensubsequent"><code class="csfmt">\glsxtrposthyphensubsequent</code></a><a id="wrglossary.4125"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a><a id="wrglossary.4126"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>
+ <a id="wrglossary.4127"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a>{<a id="wrglossary.4128"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a>}%
+ }%
+ }%
+ <a id="wrglossary.4129"></a><a href="#glo:glshasattribute"><code class="csfmt">\glshasattribute</code></a>{<code class="cmd">\the</code><a id="wrglossary.4130"></a><a href="#glo:glslabeltok"><code class="csfmt">\glslabeltok</code></a>}{regular}%
+ {%
+ <a id="wrglossary.4131"></a><a href="#glo:glssetattribute"><code class="csfmt">\glssetattribute</code></a>{<code class="cmd">\the</code><a id="wrglossary.4132"></a><a href="#glo:glslabeltok"><code class="csfmt">\glslabeltok</code></a>}{regular}{false}%
+ }%
+ {}%
}
-\begin{document}
-Individual&#x00A0;elements&#x00A0;first&#x00A0;use:&#x00A0;\gls{ssi}&#x00A0;and&#x00A0;\gls{html}.
-Individual&#x00A0;elements&#x00A0;next&#x00A0;use:&#x00A0;\gls{ssi}&#x00A0;and&#x00A0;\gls{html}.
-Multi-entry&#x00A0;first&#x00A0;use:&#x00A0;\mgls{shtml}.
-Multi-entry&#x00A0;next&#x00A0;use:&#x00A0;\mgls{shtml}.
-Individual&#x00A0;entry&#x00A0;first&#x00A0;use:&#x00A0;\gls{shtml}.
-Resetting&#x00A0;all\glsresetall\mglsresetall:
-
-
-
-Multi-entry&#x00A0;first&#x00A0;use:&#x00A0;\mgls{shtml}.
-Multi-entry&#x00A0;next&#x00A0;use:&#x00A0;\mgls{shtml}.
-Individual&#x00A0;elements:&#x00A0;\gls{ssi}&#x00A0;and&#x00A0;\gls{html}.
-Resetting&#x00A0;all\glsresetall\mglsresetall:
-Individual&#x00A0;entry&#x00A0;first&#x00A0;use:&#x00A0;\gls{shtml}.
-Multi-entry&#x00A0;first&#x00A0;use:&#x00A0;\mgls{shtml}.&#x00A0;(Wrong!)
-\printglossaries
-\end{document}
-</pre>
-<!--l. 8264--><p class="nopar" > This now produces (underlining added to mark the hyperlinks):
- </p><blockquote class="quote">
- <!--l. 8267--><p class="noindent" >Individual elements first use: server-side includes (<span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">s</span><span
-class="small-caps">i</span></span>) and hypertext
- markup language (<span
-class="cmcsc-10"><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>).
- </p><!--l. 8270--><p class="noindent" >Individual elements next use: <span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">s</span><span
-class="small-caps">i</span></span> and <span
-class="cmcsc-10"><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>.
- </p><!--l. 8273--><p class="noindent" >Multi-entry first use: <span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">s</span><span
-class="small-caps">i</span></span> enabled <span
-class="cmcsc-10"><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span> (<span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>).
- </p><!--l. 8276--><p class="noindent" >Multi-entry next use: <span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>.
- </p><!--l. 8278--><p class="noindent" >Individual entry first use: <span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>.
- </p><!--l. 8280--><p class="noindent" >Resetting all:
- </p><!--l. 8282--><p class="noindent" >Multi-entry first use: server-side includes enabled hypertext markup
- language (<span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>).
- </p><!--l. 8285--><p class="noindent" >Multi-entry next use: <span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>.
- </p><!--l. 8287--><p class="noindent" >Individual elements: <span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">s</span><span
-class="small-caps">i</span></span> and <span
-class="cmcsc-10"><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>.
- </p><!--l. 8289--><p class="noindent" >Resetting all:
- </p><!--l. 8291--><p class="noindent" >Individual entry first use: <span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">s</span><span
-class="small-caps">i</span></span> enabled <span
-class="cmcsc-10"><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span> (<span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>).
- </p><!--l. 8294--><p class="noindent" >Multi-entry first use: server-side includes <span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span> hypertext markup
- language. (Wrong!)</p></blockquote>
-<!--l. 8297--><p class="noindent" >Note the last two paragraphs, which highlights what happens if <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls{shtml}</span></span></span> is used
-before <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mgls{shtml}</span></span></span> when neither of the other elements (<span
-class="cmtt-10">ssi </span>and <span
-class="cmtt-10">html</span>) have been
-used. The final instance of <span
-class="cmtt-10">\mgls </span>has produced the wrong result. This is because it&#8217;s
-the first use of the multi-entry <span
-class="cmtt-10">shtml </span>but not the first use of the individual entry
-<span
-class="cmtt-10">shtml</span>.
-</p><!--l. 8304--><p class="indent" > One way around this is to modify the prefix to ensure that the main element&#8217;s
-<a
- id="dx1-45003"></a><a
-href="#glo:firstuseflag">first use flag</a> matches the multi-entry&#8217;s first use flag:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-192">
-\mglsdefcategoryprefix{combinedabbrv}{%
-&#x00A0;\renewcommand{\combinedpre}[1]{\ignorespaces}%
-&#x00A0;\renewcommand{\combinedpost}[1]{\unskip}%
-&#x00A0;\mglsisfirstuse
-&#x00A0;{\glslocalreset{\mglscurrentmainlabel}}%
-&#x00A0;{\glslocalunset{\mglscurrentmainlabel}}%
+</pre> In the above, <a id="wrglossary.4133"></a><a href="#glo:glslabeltok"><code class="csfmt">\glslabeltok</code></a> and <a id="wrglossary.4134"></a><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a> are used in the parts that will be expanded at the end of <a id="wrglossary.4135"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>, but <a id="wrglossary.4136"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a> and <a id="wrglossary.4137"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a> are used in the definition of the <a id="wrglossary.4138"></a><a href="#glo:dual.postlinkhook">post-link hook</a>, which won’t be expanded until the entry is referenced in the document with a command such as <a id="wrglossary.4139"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. (The use of <a id="wrglossary.4140"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a> is included to assist <a id="wrglossary.4141"></a><a href="#glo:opt.glsopt.innertextformat"><span class="csoptfmt">innertextformat</span></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4142"></a><code class="code"><dfn id="glo:glsxtrsetcomplexstyle"><code class="csfmt">\glsxtrsetcomplexstyle</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">n</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command should go in the definition of <a id="wrglossary.4143"></a><a href="#glo:GlsXtrPostNewAbbreviation"><code class="csfmt">\GlsXtrPostNewAbbreviation</code></a> to indicate that the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> has an abbreviation style that is complex. The second argument <span class="meta">〈<em class="metainner">n</em>〉</span> should be numeric and indicates why it doesn’t work with <a id="wrglossary.4144"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a>, <a id="wrglossary.4145"></a><a href="#glo:Glsfirst"><code class="csfmt">\Glsfirst</code></a>, <a id="wrglossary.4146"></a><a href="#glo:GLSfirst"><code class="csfmt">\GLSfirst</code></a>, <a id="wrglossary.4147"></a><a href="#glo:glsfirstplural"><code class="csfmt">\glsfirstplural</code></a>, <a id="wrglossary.4148"></a><a href="#glo:Glsfirstplural"><code class="csfmt">\Glsfirstplural</code></a> or <a id="wrglossary.4149"></a><a href="#glo:GLSfirstplural"><code class="csfmt">\GLSfirstplural</code></a>: 1 (all caps doesn’t work), 2 (all caps and insert doesn’t work), 3 (insert doesn’t work).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4150"></a><code class="code"><dfn id="glo:glsfirstinnerfmtabbrvfont"><code class="csfmt">\glsfirstinnerfmtabbrvfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is a robust command that applies both <a id="wrglossary.4151"></a><a href="#glo:glsfirstabbrvfont"><code class="csfmt">\glsfirstabbrvfont</code></a> and the inner formatting command <a id="wrglossary.4152"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a>. This is used by the following command.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4153"></a><code class="code"><dfn id="glo:glsfirstxpabbrvfont"><code class="csfmt">\glsfirstxpabbrvfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">category</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If the <a id="wrglossary.4154"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a> attribute is true, this does <code class="code"><span class="cmdfmt">\protect</span><a id="wrglossary.4155"></a><a href="#glo:glsfirstabbrvfont"><code class="csfmt">\glsfirstabbrvfont</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code> otherwise it does <code class="code"><a id="wrglossary.4156"></a><a href="#glo:glsfirstinnerfmtabbrvfont"><code class="csfmt">\glsfirstinnerfmtabbrvfont</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code>.<p>
+This command is designed to be used within <a id="wrglossary.4157"></a><a href="#glo:CustomAbbreviationFields"><code class="csfmt">\CustomAbbreviationFields</code></a> to set the <a id="wrglossary.4158"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> and <a id="wrglossary.4159"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> keys, so it needs to partially expand within <a id="wrglossary.4160"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>. For example, the <a id="wrglossary.4161"></a><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">postfootnote</span></a> includes the following lines in the definition of <a id="wrglossary.4162"></a><a href="#glo:CustomAbbreviationFields"><code class="csfmt">\CustomAbbreviationFields</code></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4163"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a><span class="optfmt">={<a id="wrglossary.4164"></a><a href="#glo:glsfirstxpabbrvfont"><code class="csfmt">\glsfirstxpabbrvfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.4165"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a>}{<a id="wrglossary.4166"></a><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a>}}</span>,%
+<a id="wrglossary.4167"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a><span class="optfmt">={<a id="wrglossary.4168"></a><a href="#glo:glsfirstxpabbrvfont"><code class="csfmt">\glsfirstxpabbrvfont</code></a>{<code class="cmd">\the</code><a id="wrglossary.4169"></a><a href="#glo:glsshortpltok"><code class="csfmt">\glsshortpltok</code></a>}{<a id="wrglossary.4170"></a><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a>}}</span>,
+</pre> This will be expanded before being passed to <a id="wrglossary.4171"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>. If the <a id="wrglossary.4172"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a> attribute is true, this will end up as: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4173"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a><span class="optfmt">={<code class="cmd">\protect</code><a id="wrglossary.4174"></a><a href="#glo:glsfirstabbrvfont"><code class="csfmt">\glsfirstabbrvfont</code></a>{<span class="meta">〈<em class="metainner">short</em>〉</span>}}</span>,%
+<a id="wrglossary.4175"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a><span class="optfmt">={<code class="cmd">\protect</code><a id="wrglossary.4176"></a><a href="#glo:glsfirstabbrvfont"><code class="csfmt">\glsfirstabbrvfont</code></a>{<span class="meta">〈<em class="metainner">shortpl</em>〉</span>}}</span>
+</pre> otherwise it will end up as: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4177"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a><span class="optfmt">={<a id="wrglossary.4178"></a><a href="#glo:glsfirstinnerfmtabbrvfont"><code class="csfmt">\glsfirstinnerfmtabbrvfont</code></a>{<span class="meta">〈<em class="metainner">short</em>〉</span>}}</span>,%
+<a id="wrglossary.4179"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a><span class="optfmt">={<a id="wrglossary.4180"></a><a href="#glo:glsfirstinnerfmtabbrvfont"><code class="csfmt">\glsfirstinnerfmtabbrvfont</code></a>{<span class="meta">〈<em class="metainner">shortpl</em>〉</span>}}</span>,%
+</pre> where <span class="meta">〈<em class="metainner">short</em>〉</span> and <span class="meta">〈<em class="metainner">shortpl</em>〉</span> are, respectively, the values in the <a id="wrglossary.4181"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a> and <a id="wrglossary.4182"></a><a href="#glo:glsshortpltok"><code class="csfmt">\glsshortpltok</code></a> registers.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+The placeholder registers and macros (such as <a id="wrglossary.4183"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a> and <a id="wrglossary.4184"></a><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a>) must be expanded before being passed to <a id="wrglossary.4185"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> as their values are unreliable outside of <a id="wrglossary.4186"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>. </div><!-- end of information -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4187"></a><code class="code"><dfn id="glo:glsinnerfmtabbrvfont"><code class="csfmt">\glsinnerfmtabbrvfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is a robust command that applies both <a id="wrglossary.4188"></a><a href="#glo:glsabbrvfont"><code class="csfmt">\glsabbrvfont</code></a> and the inner formatting command <a id="wrglossary.4189"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a>. This is used by the following command.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4190"></a><code class="code"><dfn id="glo:glsxpabbrvfont"><code class="csfmt">\glsxpabbrvfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">category</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If the <a id="wrglossary.4191"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a> attribute is true, this does <code class="code"><span class="cmdfmt">\protect</span><a id="wrglossary.4192"></a><a href="#glo:glsabbrvfont"><code class="csfmt">\glsabbrvfont</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code> otherwise it does <code class="code"><a id="wrglossary.4193"></a><a href="#glo:glsinnerfmtabbrvfont"><code class="csfmt">\glsinnerfmtabbrvfont</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code>. This command is designed for the <a id="wrglossary.4194"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, <a id="wrglossary.4195"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> and <a id="wrglossary.4196"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> keys within <a id="wrglossary.4197"></a><a href="#glo:CustomAbbreviationFields"><code class="csfmt">\CustomAbbreviationFields</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4198"></a><code class="code"><dfn id="glo:glsfirstinnerfmtlongfont"><code class="csfmt">\glsfirstinnerfmtlongfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is a robust command that applies both <a id="wrglossary.4199"></a><a href="#glo:glsfirstlongfont"><code class="csfmt">\glsfirstlongfont</code></a> and the inner formatting command <a id="wrglossary.4200"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a>. This is used by the following command.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4201"></a><code class="code"><dfn id="glo:glsfirstxplongfont"><code class="csfmt">\glsfirstxplongfont</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If the <a id="wrglossary.4202"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a> attribute is true, this does <code class="code"><span class="cmdfmt">\protect</span><a id="wrglossary.4203"></a><a href="#glo:glsfirstlongfont"><code class="csfmt">\glsfirstlongfont</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code> otherwise it does <code class="code"><a id="wrglossary.4204"></a><a href="#glo:glsfirstinnerfmtlongfont"><code class="csfmt">\glsfirstinnerfmtlongfont</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code>. This command is designed for the <a id="wrglossary.4205"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> and <a id="wrglossary.4206"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> keys within <a id="wrglossary.4207"></a><a href="#glo:CustomAbbreviationFields"><code class="csfmt">\CustomAbbreviationFields</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4208"></a><code class="code"><dfn id="glo:glsinnerfmtlongfont"><code class="csfmt">\glsinnerfmtlongfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is a robust command that applies both <a id="wrglossary.4209"></a><a href="#glo:glslongfont"><code class="csfmt">\glslongfont</code></a> and the inner formatting command <a id="wrglossary.4210"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a>. This is used by the following command.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4211"></a><code class="code"><dfn id="glo:glsxplongfont"><code class="csfmt">\glsxplongfont</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If the <a id="wrglossary.4212"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a> attribute is true, this does <code class="code"><span class="cmdfmt">\protect</span><a id="wrglossary.4213"></a><a href="#glo:glslongfont"><code class="csfmt">\glslongfont</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code> otherwise it does <code class="code"><a id="wrglossary.4214"></a><a href="#glo:glsinnerfmtlongfont"><code class="csfmt">\glsinnerfmtlongfont</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code>. This command is designed for the <a id="wrglossary.4215"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, <a id="wrglossary.4216"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> and <a id="wrglossary.4217"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> keys within <a id="wrglossary.4218"></a><a href="#glo:CustomAbbreviationFields"><code class="csfmt">\CustomAbbreviationFields</code></a> (if they should include the long form in their value, such as the <a id="wrglossary.4219"></a><a href="#glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></a> style).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4220"></a><code class="code"><dfn id="glo:glsxtrAccSuppAbbrSetNoLongAttrs"><code class="csfmt">\glsxtrAccSuppAbbrSetNoLongAttrs</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If accessibility support has been enabled with <a id="wrglossary.4221"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>, this command will initialise support for the <a id="wrglossary.4222"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, <a id="wrglossary.4223"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a>, <a id="wrglossary.4224"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a>, <a id="wrglossary.4225"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> and <a id="wrglossary.4226"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> fields for the given category (using <a id="wrglossary.4227"></a><a href="#glo:glsxtrprovideaccsuppcmd"><code class="csfmt">\glsxtrprovideaccsuppcmd</code></a>). The <a id="wrglossary.4228"></a><a href="#glo:opt.catattr.nameshortaccess"><span class="csoptfmt">nameshortaccess</span></a>, <a id="wrglossary.4229"></a><a href="#glo:opt.catattr.firstshortaccess"><span class="csoptfmt">firstshortaccess</span></a> and <a id="wrglossary.4230"></a><a href="#glo:opt.catattr.textshortaccess"><span class="csoptfmt">textshortaccess</span></a> attributes are set to <code class="code">true</code>. (Does nothing if accessibility support has not been enabled.)<p>
+This command is provided for abbreviation styles where the <a id="wrglossary.4231"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, <a id="wrglossary.4232"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> and <a id="wrglossary.4233"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> are just the formatted abbreviation. The <a id="wrglossary.4234"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> field may just be the long form or may be a combination of short and long.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4235"></a><code class="code"><dfn id="glo:glsxtrAccSuppAbbrSetNameLongAttrs"><code class="csfmt">\glsxtrAccSuppAbbrSetNameLongAttrs</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If accessibility support has been enabled with <a id="wrglossary.4236"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>, this command will initialise support for the <a id="wrglossary.4237"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a>, <a id="wrglossary.4238"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a>, <a id="wrglossary.4239"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> and <a id="wrglossary.4240"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> fields for the given category (using <a id="wrglossary.4241"></a><a href="#glo:glsxtrprovideaccsuppcmd"><code class="csfmt">\glsxtrprovideaccsuppcmd</code></a>). The <a id="wrglossary.4242"></a><a href="#glo:opt.catattr.firstshortaccess"><span class="csoptfmt">firstshortaccess</span></a> and <a id="wrglossary.4243"></a><a href="#glo:opt.catattr.textshortaccess"><span class="csoptfmt">textshortaccess</span></a> attributes are set to <code class="code">true</code>. (Does nothing if accessibility support has not been enabled.)<p>
+This command is provided for abbreviation styles where the <a id="wrglossary.4244"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> and <a id="wrglossary.4245"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> are just the formatted abbreviation. The <a id="wrglossary.4246"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field may just be the long form or may be a combination of short and long.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4247"></a><code class="code"><dfn id="glo:glsxtrAccSuppAbbrSetFirstLongAttrs"><code class="csfmt">\glsxtrAccSuppAbbrSetFirstLongAttrs</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If accessibility support has been enabled with <a id="wrglossary.4248"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>, this command will initialise support for the <a id="wrglossary.4249"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, <a id="wrglossary.4250"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> and <a id="wrglossary.4251"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> fields for the given category (using <a id="wrglossary.4252"></a><a href="#glo:glsxtrprovideaccsuppcmd"><code class="csfmt">\glsxtrprovideaccsuppcmd</code></a>). The <a id="wrglossary.4253"></a><a href="#glo:opt.catattr.nameshortaccess"><span class="csoptfmt">nameshortaccess</span></a> and <a id="wrglossary.4254"></a><a href="#glo:opt.catattr.textshortaccess"><span class="csoptfmt">textshortaccess</span></a> attributes are set to <code class="code">true</code>. (Does nothing if accessibility support has not been enabled.)<p>
+This command is provided for abbreviation styles where the <a id="wrglossary.4255"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> and <a id="wrglossary.4256"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> are just the formatted abbreviation. The <a id="wrglossary.4257"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> field may just be the long form or may be a combination of short and long.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4258"></a><code class="code"><dfn id="glo:glsxtrAccSuppAbbrSetTextShortAttrs"><code class="csfmt">\glsxtrAccSuppAbbrSetTextShortAttrs</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If accessibility support has been enabled with <a id="wrglossary.4259"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>, this command will initialise support for the <a id="wrglossary.4260"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> and <a id="wrglossary.4261"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> fields for the given category (using <a id="wrglossary.4262"></a><a href="#glo:glsxtrprovideaccsuppcmd"><code class="csfmt">\glsxtrprovideaccsuppcmd</code></a>). The <a id="wrglossary.4263"></a><a href="#glo:opt.catattr.textshortaccess"><span class="csoptfmt">textshortaccess</span></a> attribute is set to <code class="code">true</code>. (Does nothing if accessibility support has not been enabled.)<p>
+This command is provided for abbreviation styles where the <a id="wrglossary.4264"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> is just the formatted abbreviation. The <a id="wrglossary.4265"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> and <a id="wrglossary.4266"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> fields may just be the long form or may be a combination of short and long. The <a id="wrglossary.4267"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> may also be short but followed by the long form in the description.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4268"></a><code class="code"><dfn id="glo:glsxtrAccSuppAbbrSetNameShortAttrs"><code class="csfmt">\glsxtrAccSuppAbbrSetNameShortAttrs</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If accessibility support has been enabled with <a id="wrglossary.4269"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>, this command will initialise support for the <a id="wrglossary.4270"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field for the given category (using <a id="wrglossary.4271"></a><a href="#glo:glsxtrprovideaccsuppcmd"><code class="csfmt">\glsxtrprovideaccsuppcmd</code></a>). The <a id="wrglossary.4272"></a><a href="#glo:opt.catattr.nameshortaccess"><span class="csoptfmt">nameshortaccess</span></a> attribute is set to <code class="code">true</code>. (Does nothing if accessibility support has not been enabled.)<p>
+This command is provided for abbreviation styles where only the <a id="wrglossary.4273"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> is just the formatted abbreviation. The <a id="wrglossary.4274"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> and <a id="wrglossary.4275"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> fields may just be the long form or may be a combination of short and long.<p>
+
+</section><!-- end of section sec:abbrstyleinit -->
+
+<section id="sec:abbrstylefmts"><!-- start of section sec:abbrstylefmts --><div class="tomain"><a href="#main">[top]</a></div>
+<h4><!-- start of subsubsection header -->4.5.3.2. Style Formatting Commands<div class="labellink"><a href="#sec:abbrstylefmts">[link]</a></div></h4><!-- end of subsubsection header -->
+<p>
+The final <span class="meta">〈<em class="metainner">display definitions</em>〉</span> argument of <a id="wrglossary.4276"></a><a href="#glo:newabbreviationstyle"><code class="csfmt">\newabbreviationstyle</code></a> should contain the redefinitions of the style commands listed here that are used to format abbreviations.<p>
+Whenever an abbreviation style is activated with commands like <a id="wrglossary.4277"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>, <a id="wrglossary.4278"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> or <a id="wrglossary.4279"></a><a href="#glo:glssetabbrvfmt"><code class="csfmt">\glssetabbrvfmt</code></a>, <span class="meta">〈<em class="metainner">display definitions</em>〉</span> are implemented.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+If you simply want to adjust the formatting of one of the predefined styles, you should redefine the associated commands listed in §<a href="#sec:abbrvcmds">4.5.1.3</a>. </div><!-- end of important -->
+<p>
+The following initialisation is always prepended to <span class="meta">〈<em class="metainner">display definitions</em>〉</span> so you can omit them if the default is appropriate for your style: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.4280"></a><a href="#glo:glsxtrinlinefullformat"><code class="csfmt">\glsxtrinlinefullformat</code></a>}{<a id="wrglossary.4281"></a><a href="#glo:glsxtrfullformat"><code class="csfmt">\glsxtrfullformat</code></a>}%
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.4282"></a><a href="#glo:Glsxtrinlinefullformat"><code class="csfmt">\Glsxtrinlinefullformat</code></a>}{<a id="wrglossary.4283"></a><a href="#glo:Glsxtrfullformat"><code class="csfmt">\Glsxtrfullformat</code></a>}%
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.4284"></a><a href="#glo:GLSxtrinlinefullformat"><code class="csfmt">\GLSxtrinlinefullformat</code></a>}{<a id="wrglossary.4285"></a><a href="#glo:GLSxtrfullformat"><code class="csfmt">\GLSxtrfullformat</code></a>}%
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.4286"></a><a href="#glo:glsxtrinlinefullplformat"><code class="csfmt">\glsxtrinlinefullplformat</code></a>}{<a id="wrglossary.4287"></a><a href="#glo:glsxtrfullplformat"><code class="csfmt">\glsxtrfullplformat</code></a>}%
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.4288"></a><a href="#glo:Glsxtrinlinefullplformat"><code class="csfmt">\Glsxtrinlinefullplformat</code></a>}{<a id="wrglossary.4289"></a><a href="#glo:Glsxtrfullplformat"><code class="csfmt">\Glsxtrfullplformat</code></a>}%
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.4290"></a><a href="#glo:GLSxtrinlinefullplformat"><code class="csfmt">\GLSxtrinlinefullplformat</code></a>}{<a id="wrglossary.4291"></a><a href="#glo:GLSxtrfullplformat"><code class="csfmt">\GLSxtrfullplformat</code></a>}%
+<code class="cmd">\let</code><a id="wrglossary.4292"></a><a href="#glo:glsxtrsubsequentfmt"><code class="csfmt">\glsxtrsubsequentfmt</code></a><a id="wrglossary.4293"></a><a href="#glo:glsxtrdefaultsubsequentfmt"><code class="csfmt">\glsxtrdefaultsubsequentfmt</code></a>
+<code class="cmd">\let</code><a id="wrglossary.4294"></a><a href="#glo:glsxtrsubsequentplfmt"><code class="csfmt">\glsxtrsubsequentplfmt</code></a><a id="wrglossary.4295"></a><a href="#glo:glsxtrdefaultsubsequentplfmt"><code class="csfmt">\glsxtrdefaultsubsequentplfmt</code></a>
+<code class="cmd">\let</code><a id="wrglossary.4296"></a><a href="#glo:Glsxtrsubsequentfmt"><code class="csfmt">\Glsxtrsubsequentfmt</code></a><a id="wrglossary.4297"></a><a href="#glo:Glsxtrdefaultsubsequentfmt"><code class="csfmt">\Glsxtrdefaultsubsequentfmt</code></a>
+<code class="cmd">\let</code><a id="wrglossary.4298"></a><a href="#glo:Glsxtrsubsequentplfmt"><code class="csfmt">\Glsxtrsubsequentplfmt</code></a><a id="wrglossary.4299"></a><a href="#glo:Glsxtrdefaultsubsequentplfmt"><code class="csfmt">\Glsxtrdefaultsubsequentplfmt</code></a>
+<code class="cmd">\let</code><a id="wrglossary.4300"></a><a href="#glo:GLSxtrsubsequentfmt"><code class="csfmt">\GLSxtrsubsequentfmt</code></a><a id="wrglossary.4301"></a><a href="#glo:GLSxtrdefaultsubsequentfmt"><code class="csfmt">\GLSxtrdefaultsubsequentfmt</code></a>
+<code class="cmd">\let</code><a id="wrglossary.4302"></a><a href="#glo:GLSxtrsubsequentplfmt"><code class="csfmt">\GLSxtrsubsequentplfmt</code></a><a id="wrglossary.4303"></a><a href="#glo:GLSxtrdefaultsubsequentplfmt"><code class="csfmt">\GLSxtrdefaultsubsequentplfmt</code></a>
+</pre> In the event that any styles omit defining the newer <a id="wrglossary.4304"></a><a href="#glo:GLSxtrfullformat"><code class="csfmt">\GLSxtrfullformat</code></a> or <a id="wrglossary.4305"></a><a href="#glo:GLSxtrfullplformat"><code class="csfmt">\GLSxtrfullplformat</code></a>, these are also initialised to defaults but ideally they should have their definitions provided.<p>
+The minimal set of commands that should have their definitions provided are the abbreviation plural suffix (<a id="wrglossary.4306"></a><a href="#glo:abbrvpluralsuffix"><code class="csfmt">\abbrvpluralsuffix</code></a>) the <a id="wrglossary.4307"></a><a href="#glo:dual.displayfullform">display full forms</a>: <a id="wrglossary.4308"></a><a href="#glo:glsxtrfullformat"><code class="csfmt">\glsxtrfullformat</code></a>, <a id="wrglossary.4309"></a><a href="#glo:glsxtrfullplformat"><code class="csfmt">\glsxtrfullplformat</code></a> and their case-changing variants.<p>
+The <a id="wrglossary.4310"></a><a href="#glo:dual.inlinefullform">inline full form</a> commands only need to be provided if they behave differently from the <a id="wrglossary.4311"></a><a href="#glo:dual.displayfullform">display full form</a>. The subsequent use commands only need to be provided if the default (only show the short form) isn’t suitable.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The content of <span class="meta">〈<em class="metainner">display definitions</em>〉</span> is placed within the definition of an internal control sequence, so remember to use <code class="code">##</code> instead of <code class="code">#</code> to reference command parameters. </div><!-- end of important -->
+<p>
+
+</section><!-- end of section sec:abbrstylefmts -->
+
+<section id="paragraph.4.5.3.2.1"><!-- start of section paragraph.4.5.3.2.1 --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.3.2.1. Suffix and Fonts<div class="labellink"><a href="#paragraph.4.5.3.2.1">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These are the generic suffix and font commands that vary according to the abbreviation style. The style should provide the appropriate definitions. The suffix should always be provided. The font commands are only required if the style applies any font formatting to either the long or short form.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4312"></a><code class="code"><dfn id="glo:abbrvpluralsuffix"><code class="csfmt">\abbrvpluralsuffix</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ The plural suffix for the short form. For example, the <a id="wrglossary.4313"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> style defines this to just use <a id="wrglossary.4314"></a><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a>, but the smallcaps styles, such as <a id="wrglossary.4315"></a><a href="#glo:opt.abbrstyle.long-short-sc"><span class="abbrstylefmt">long-short-sc</span></a> define this to <a id="wrglossary.4316"></a><a href="#glo:glsxtrscsuffix"><code class="csfmt">\glsxtrscsuffix</code></a> in order to counteract the small caps font.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4317"></a><code class="code"><dfn id="glo:glsfirstabbrvfont"><code class="csfmt">\glsfirstabbrvfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The font formatting command for the short form on <a id="wrglossary.4318"></a><a href="#glo:dual.firstuse">first use</a>. For example, the <a id="wrglossary.4319"></a><a href="#glo:opt.abbrstyle.long-short-sc"><span class="abbrstylefmt">long-short-sc</span></a> style has: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*<a id="wrglossary.4320"></a><a href="#glo:glsfirstabbrvfont"><code class="csfmt">\glsfirstabbrvfont</code></a>[1]{<a id="wrglossary.4321"></a><a href="#glo:glsfirstabbrvscfont"><code class="csfmt">\glsfirstabbrvscfont</code></a>{##1}}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4322"></a><code class="code"><dfn id="glo:glsabbrvfont"><code class="csfmt">\glsabbrvfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The font formatting command for the short form. For example, the <a id="wrglossary.4323"></a><a href="#glo:opt.abbrstyle.long-short-sc"><span class="abbrstylefmt">long-short-sc</span></a> style has: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*<a id="wrglossary.4324"></a><a href="#glo:glsabbrvfont"><code class="csfmt">\glsabbrvfont</code></a>[1]{<a id="wrglossary.4325"></a><a href="#glo:glsabbrvscfont"><code class="csfmt">\glsabbrvscfont</code></a>{##1}}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4326"></a><code class="code"><dfn id="glo:glsxtrrevert"><code class="csfmt">\glsxtrrevert</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is designed to counteract the effect of <a id="wrglossary.4327"></a><a href="#glo:glsabbrvfont"><code class="csfmt">\glsabbrvfont</code></a> if, for some reason, it shouldn’t be applied to part of the abbreviation. For example, you may prefer not to have digits reduced with the smaller (<span class="qt">“sm”</span>) styles.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4328"></a><code class="code"><dfn id="glo:glsfirstlongfont"><code class="csfmt">\glsfirstlongfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The font formatting command for the long form on <a id="wrglossary.4329"></a><a href="#glo:dual.firstuse">first use</a>. For example, the <a id="wrglossary.4330"></a><a href="#glo:opt.abbrstyle.long-short-sc"><span class="abbrstylefmt">long-short-sc</span></a> style has: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.4331"></a><a href="#glo:glsfirstlongfont"><code class="csfmt">\glsfirstlongfont</code></a>}[1]{<a id="wrglossary.4332"></a><a href="#glo:glsfirstlongdefaultfont"><code class="csfmt">\glsfirstlongdefaultfont</code></a>{##1}}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4333"></a><code class="code"><dfn id="glo:glslongfont"><code class="csfmt">\glslongfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The font formatting command for the long form. For example, the <a id="wrglossary.4334"></a><a href="#glo:opt.abbrstyle.long-short-sc"><span class="abbrstylefmt">long-short-sc</span></a> style has: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.4335"></a><a href="#glo:glslongfont"><code class="csfmt">\glslongfont</code></a>}[1]{<a id="wrglossary.4336"></a><a href="#glo:glslongdefaultfont"><code class="csfmt">\glslongdefaultfont</code></a>{##1}}
+</pre><p>
+
+</section><!-- end of section paragraph.4.5.3.2.1 -->
+
+<section id="paragraph.4.5.3.2.2"><!-- start of section paragraph.4.5.3.2.2 --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.3.2.2. First Use Display Format<div class="labellink"><a href="#paragraph.4.5.3.2.2">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These commands always need to be provided.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4337"></a><code class="code"><dfn id="glo:glsxtrfullformat"><code class="csfmt">\glsxtrfullformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The singular <a id="wrglossary.4338"></a><a href="#glo:dual.displayfullform">display full form</a> used on the <a id="wrglossary.4339"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.4340"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4341"></a><code class="code"><dfn id="glo:glsxtrfullplformat"><code class="csfmt">\glsxtrfullplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The plural <a id="wrglossary.4342"></a><a href="#glo:dual.displayfullform">display full form</a> used on the <a id="wrglossary.4343"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.4344"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4345"></a><code class="code"><dfn id="glo:Glsxtrfullformat"><code class="csfmt">\Glsxtrfullformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The <a id="wrglossary.4346"></a><a href="#glo:idx.sentencecase">sentence case</a> singular <a id="wrglossary.4347"></a><a href="#glo:dual.displayfullform">display full form</a> used on the <a id="wrglossary.4348"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.4349"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4350"></a><code class="code"><dfn id="glo:Glsxtrfullplformat"><code class="csfmt">\Glsxtrfullplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The <a id="wrglossary.4351"></a><a href="#glo:idx.sentencecase">sentence case</a> plural <a id="wrglossary.4352"></a><a href="#glo:dual.displayfullform">display full form</a> used on the <a id="wrglossary.4353"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.4354"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4355"></a><code class="code"><dfn id="glo:GLSxtrfullformat"><code class="csfmt">\GLSxtrfullformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The <a id="wrglossary.4356"></a><a href="#glo:idx.allcaps">all caps</a> singular <a id="wrglossary.4357"></a><a href="#glo:dual.displayfullform">display full form</a> used on the <a id="wrglossary.4358"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.4359"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4360"></a><code class="code"><dfn id="glo:GLSxtrfullplformat"><code class="csfmt">\GLSxtrfullplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The <a id="wrglossary.4361"></a><a href="#glo:idx.allcaps">all caps</a> plural <a id="wrglossary.4362"></a><a href="#glo:dual.displayfullform">display full form</a> used on the <a id="wrglossary.4363"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.4364"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a>.<p>
+
+</section><!-- end of section paragraph.4.5.3.2.2 -->
+
+<section id="paragraph.4.5.3.2.3"><!-- start of section paragraph.4.5.3.2.3 --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.3.2.3. Subsequent Use Display Format<div class="labellink"><a href="#paragraph.4.5.3.2.3">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These commands only need to be provided if the <a id="wrglossary.4365"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands don’t simply show the short form.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4366"></a><code class="code"><dfn id="glo:glsxtrsubsequentfmt"><code class="csfmt">\glsxtrsubsequentfmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The singular form for <a id="wrglossary.4367"></a><a href="#glo:dual.subsequentuse">subsequent use</a> of <a id="wrglossary.4368"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4369"></a><code class="code"><dfn id="glo:glsxtrsubsequentplfmt"><code class="csfmt">\glsxtrsubsequentplfmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The plural form for <a id="wrglossary.4370"></a><a href="#glo:dual.subsequentuse">subsequent use</a> of <a id="wrglossary.4371"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4372"></a><code class="code"><dfn id="glo:Glsxtrsubsequentfmt"><code class="csfmt">\Glsxtrsubsequentfmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The <a id="wrglossary.4373"></a><a href="#glo:idx.sentencecase">sentence case</a> singular form for <a id="wrglossary.4374"></a><a href="#glo:dual.subsequentuse">subsequent use</a> of <a id="wrglossary.4375"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4376"></a><code class="code"><dfn id="glo:Glsxtrsubsequentplfmt"><code class="csfmt">\Glsxtrsubsequentplfmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The <a id="wrglossary.4377"></a><a href="#glo:idx.sentencecase">sentence case</a> plural form for <a id="wrglossary.4378"></a><a href="#glo:dual.subsequentuse">subsequent use</a> of <a id="wrglossary.4379"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4380"></a><code class="code"><dfn id="glo:GLSxtrsubsequentfmt"><code class="csfmt">\GLSxtrsubsequentfmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The <a id="wrglossary.4381"></a><a href="#glo:idx.allcaps">all caps</a> singular form for <a id="wrglossary.4382"></a><a href="#glo:dual.subsequentuse">subsequent use</a> of <a id="wrglossary.4383"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4384"></a><code class="code"><dfn id="glo:GLSxtrsubsequentplfmt"><code class="csfmt">\GLSxtrsubsequentplfmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The <a id="wrglossary.4385"></a><a href="#glo:idx.allcaps">all caps</a> plural form for <a id="wrglossary.4386"></a><a href="#glo:dual.subsequentuse">subsequent use</a> of <a id="wrglossary.4387"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a>.<p>
+The defaults all show the short form and insert encapsulated with the <a id="wrglossary.4388"></a><a href="#glo:dual.innerformatting">inner formatting</a> <a id="wrglossary.4389"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a> and <a id="wrglossary.4390"></a><a href="#glo:glsabbrvfont"><code class="csfmt">\glsabbrvfont</code></a>. The purpose of the <a id="wrglossary.4391"></a><a href="#glo:dual.innerformatting">inner formatting</a> is to get it as close as possible to the actual text so <a id="wrglossary.4392"></a><a href="#glo:glsabbrvfont"><code class="csfmt">\glsabbrvfont</code></a> is placed outside of <a id="wrglossary.4393"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a>.<p>
+The <a id="wrglossary.4394"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a> attribute complicates matters as it inserts <a id="wrglossary.4395"></a><a href="#glo:glsxtrword"><code class="csfmt">\glsxtrword</code></a> and <a id="wrglossary.4396"></a><a href="#glo:glsxtrwordsep"><code class="csfmt">\glsxtrwordsep</code></a> into the actual field value. In that case, the <a id="wrglossary.4397"></a><a href="#glo:dual.innerformatting">inner formatting</a> is within <a id="wrglossary.4398"></a><a href="#glo:glsxtrword"><code class="csfmt">\glsxtrword</code></a> and <a id="wrglossary.4399"></a><a href="#glo:glsxtrwordsep"><code class="csfmt">\glsxtrwordsep</code></a>, so only the insert material needs to be formatted.<p>
+If a custom style doesn’t need to support <a id="wrglossary.4400"></a><a href="#glo:opt.glsopt.innertextformat"><span class="csoptfmt">innertextformat</span></a> or <a id="wrglossary.4401"></a><a href="#glo:ifglsxtrinsertinside"><code class="csfmt">\ifglsxtrinsertinside</code></a>, it can reduce the complexity by omitting the <a id="wrglossary.4402"></a><a href="#glo:dual.innerformatting">inner formatting</a> and conditionals, but this lack of support should be documented if the style is made generally available.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4403"></a><code class="code"><dfn id="glo:glsxtrdefaultsubsequentfmt"><code class="csfmt">\glsxtrdefaultsubsequentfmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The default singular form for <a id="wrglossary.4404"></a><a href="#glo:dual.subsequentuse">subsequent use</a> of <a id="wrglossary.4405"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4406"></a><code class="code"><dfn id="glo:glsxtrdefaultsubsequentplfmt"><code class="csfmt">\glsxtrdefaultsubsequentplfmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The default plural form for <a id="wrglossary.4407"></a><a href="#glo:dual.subsequentuse">subsequent use</a> of <a id="wrglossary.4408"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4409"></a><code class="code"><dfn id="glo:Glsxtrdefaultsubsequentfmt"><code class="csfmt">\Glsxtrdefaultsubsequentfmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The default <a id="wrglossary.4410"></a><a href="#glo:idx.sentencecase">sentence case</a> singular form for <a id="wrglossary.4411"></a><a href="#glo:dual.subsequentuse">subsequent use</a> of <a id="wrglossary.4412"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4413"></a><code class="code"><dfn id="glo:Glsxtrdefaultsubsequentplfmt"><code class="csfmt">\Glsxtrdefaultsubsequentplfmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The default <a id="wrglossary.4414"></a><a href="#glo:idx.sentencecase">sentence case</a> plural form for <a id="wrglossary.4415"></a><a href="#glo:dual.subsequentuse">subsequent use</a> of <a id="wrglossary.4416"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4417"></a><code class="code"><dfn id="glo:GLSxtrdefaultsubsequentfmt"><code class="csfmt">\GLSxtrdefaultsubsequentfmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The default <a id="wrglossary.4418"></a><a href="#glo:idx.allcaps">all caps</a> singular form for <a id="wrglossary.4419"></a><a href="#glo:dual.subsequentuse">subsequent use</a> of <a id="wrglossary.4420"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4421"></a><code class="code"><dfn id="glo:GLSxtrdefaultsubsequentplfmt"><code class="csfmt">\GLSxtrdefaultsubsequentplfmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The default <a id="wrglossary.4422"></a><a href="#glo:idx.allcaps">all caps</a> plural form for <a id="wrglossary.4423"></a><a href="#glo:dual.subsequentuse">subsequent use</a> of <a id="wrglossary.4424"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a>.<p>
+
+</section><!-- end of section paragraph.4.5.3.2.3 -->
+
+<section id="paragraph.4.5.3.2.4"><!-- start of section paragraph.4.5.3.2.4 --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.3.2.4. Inline Full Format<div class="labellink"><a href="#paragraph.4.5.3.2.4">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These commands only need to be provided if the <a id="wrglossary.4425"></a><a href="#glo:dual.inlinefullform">inline full form</a> is different from the <a id="wrglossary.4426"></a><a href="#glo:dual.displayfullform">display full form</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4427"></a><code class="code"><dfn id="glo:glsxtrinlinefullformat"><code class="csfmt">\glsxtrinlinefullformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The singular full form of <a id="wrglossary.4428"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4429"></a><code class="code"><dfn id="glo:glsxtrinlinefullplformat"><code class="csfmt">\glsxtrinlinefullplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The plural full form of <a id="wrglossary.4430"></a><a href="#glo:glsxtrfullpl"><code class="csfmt">\glsxtrfullpl</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4431"></a><code class="code"><dfn id="glo:Glsxtrinlinefullformat"><code class="csfmt">\Glsxtrinlinefullformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The <a id="wrglossary.4432"></a><a href="#glo:idx.sentencecase">sentence case</a> singular full form of <a id="wrglossary.4433"></a><a href="#glo:Glsxtrfull"><code class="csfmt">\Glsxtrfull</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4434"></a><code class="code"><dfn id="glo:Glsxtrinlinefullplformat"><code class="csfmt">\Glsxtrinlinefullplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The <a id="wrglossary.4435"></a><a href="#glo:idx.sentencecase">sentence case</a> plural full form of <a id="wrglossary.4436"></a><a href="#glo:Glsxtrfullpl"><code class="csfmt">\Glsxtrfullpl</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4437"></a><code class="code"><dfn id="glo:GLSxtrinlinefullformat"><code class="csfmt">\GLSxtrinlinefullformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The <a id="wrglossary.4438"></a><a href="#glo:idx.allcaps">all caps</a> singular full form of <a id="wrglossary.4439"></a><a href="#glo:GLSxtrfull"><code class="csfmt">\GLSxtrfull</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4440"></a><code class="code"><dfn id="glo:GLSxtrinlinefullplformat"><code class="csfmt">\GLSxtrinlinefullplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The <a id="wrglossary.4441"></a><a href="#glo:idx.allcaps">all caps</a> plural full form of <a id="wrglossary.4442"></a><a href="#glo:GLSxtrfullpl"><code class="csfmt">\GLSxtrfullpl</code></a>.<p>
+
+</section><!-- end of section paragraph.4.5.3.2.4 -->
+
+<section id="paragraph.4.5.3.2.5"><!-- start of section paragraph.4.5.3.2.5 --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->4.5.3.2.5. Wrapper Commands<div class="labellink"><a href="#paragraph.4.5.3.2.5">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+These are commands that can be used in the definitions of the above to ensure that the appropriate accessibility fields and inner formatting is supported.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4443"></a><code class="code"><dfn id="glo:glsxtrlongformat"><code class="csfmt">\glsxtrlongformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is used in the definition of <a id="wrglossary.4444"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> in some of the predefined abbreviation styles to format the <a id="wrglossary.4445"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> value of the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> with the command <span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>, which should take one argument.<p>
+Accessibility support is implemented with <a id="wrglossary.4446"></a><a href="#glo:glsaccesslong"><code class="csfmt">\glsaccesslong</code></a> if the <a id="wrglossary.4447"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a> attribute is true otherwise with <a id="wrglossary.4448"></a><a href="#glo:glsaccessfmtlong"><code class="csfmt">\glsaccessfmtlong</code></a> using <a id="wrglossary.4449"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a> for the <a id="wrglossary.4450"></a><a href="#glo:dual.innerformatting">inner formatting</a>.<p>
+This is then encapsulated (including or excluding the <span class="meta">〈<em class="metainner">insert</em>〉</span>, according to <a id="wrglossary.4451"></a><a href="#glo:ifglsxtrinsertinside"><code class="csfmt">\ifglsxtrinsertinside</code></a>) with <span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>. If the <span class="meta">〈<em class="metainner">insert</em>〉</span> content needs to be placed outside of <span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>, it will be individually encapsulated with the <a id="wrglossary.4452"></a><a href="#glo:dual.innerformatting">inner formatting</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4453"></a><code class="code"><dfn id="glo:Glsxtrlongformat"><code class="csfmt">\Glsxtrlongformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4454"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4455"></a><code class="code"><dfn id="glo:GLSxtrlongformat"><code class="csfmt">\GLSxtrlongformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4456"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4457"></a><code class="code"><dfn id="glo:glsxtrlongplformat"><code class="csfmt">\glsxtrlongplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.4458"></a><a href="#glo:glsxtrlongformat"><code class="csfmt">\glsxtrlongformat</code></a>, but for the <a id="wrglossary.4459"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> field.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4460"></a><code class="code"><dfn id="glo:Glsxtrlongplformat"><code class="csfmt">\Glsxtrlongplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4461"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4462"></a><code class="code"><dfn id="glo:GLSxtrlongplformat"><code class="csfmt">\GLSxtrlongplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4463"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4464"></a><code class="code"><dfn id="glo:glsxtrlongformatgrp"><code class="csfmt">\glsxtrlongformatgrp</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.4465"></a><a href="#glo:glsxtrlongformat"><code class="csfmt">\glsxtrlongformat</code></a>, but adds grouping around <span class="meta">〈<em class="metainner">insert</em>〉</span> (with the <a id="wrglossary.4466"></a><a href="#glo:dual.innerformatting">inner formatting</a> inside the group).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4467"></a><code class="code"><dfn id="glo:Glsxtrlongformatgrp"><code class="csfmt">\Glsxtrlongformatgrp</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4468"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4469"></a><code class="code"><dfn id="glo:GLSxtrlongformatgrp"><code class="csfmt">\GLSxtrlongformatgrp</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4470"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4471"></a><code class="code"><dfn id="glo:glsxtrlongplformatgrp"><code class="csfmt">\glsxtrlongplformatgrp</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.4472"></a><a href="#glo:glsxtrlongplformat"><code class="csfmt">\glsxtrlongplformat</code></a>, but adds grouping around <span class="meta">〈<em class="metainner">insert</em>〉</span> (with the <a id="wrglossary.4473"></a><a href="#glo:dual.innerformatting">inner formatting</a> inside the group).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4474"></a><code class="code"><dfn id="glo:Glsxtrlongplformatgrp"><code class="csfmt">\Glsxtrlongplformatgrp</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4475"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4476"></a><code class="code"><dfn id="glo:GLSxtrlongplformatgrp"><code class="csfmt">\GLSxtrlongplformatgrp</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4477"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4478"></a><code class="code"><dfn id="glo:glsxtrshortformat"><code class="csfmt">\glsxtrshortformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is used in the definition of <a id="wrglossary.4479"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> and in some of the predefined abbreviation styles to format the <a id="wrglossary.4480"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> value of the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> with the command <span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>, which should take one argument.<p>
+Accessibility support is implemented with <a id="wrglossary.4481"></a><a href="#glo:glsaccessshort"><code class="csfmt">\glsaccessshort</code></a> if the <a id="wrglossary.4482"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a> attribute is true otherwise with <a id="wrglossary.4483"></a><a href="#glo:glsaccessfmtshort"><code class="csfmt">\glsaccessfmtshort</code></a> using <a id="wrglossary.4484"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a> for the <a id="wrglossary.4485"></a><a href="#glo:dual.innerformatting">inner formatting</a>.<p>
+This is then encapsulated (including or excluding the <span class="meta">〈<em class="metainner">insert</em>〉</span>, according to <a id="wrglossary.4486"></a><a href="#glo:ifglsxtrinsertinside"><code class="csfmt">\ifglsxtrinsertinside</code></a>) with <span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>. If the <span class="meta">〈<em class="metainner">insert</em>〉</span> content needs to be placed outside of <span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>, it will be individually encapsulated with the <a id="wrglossary.4487"></a><a href="#glo:dual.innerformatting">inner formatting</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4488"></a><code class="code"><dfn id="glo:Glsxtrshortformat"><code class="csfmt">\Glsxtrshortformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4489"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4490"></a><code class="code"><dfn id="glo:GLSxtrshortformat"><code class="csfmt">\GLSxtrshortformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4491"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4492"></a><code class="code"><dfn id="glo:glsxtrshortplformat"><code class="csfmt">\glsxtrshortplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.4493"></a><a href="#glo:glsxtrshortformat"><code class="csfmt">\glsxtrshortformat</code></a>, but for the <a id="wrglossary.4494"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> field.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4495"></a><code class="code"><dfn id="glo:Glsxtrshortplformat"><code class="csfmt">\Glsxtrshortplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4496"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4497"></a><code class="code"><dfn id="glo:GLSxtrshortplformat"><code class="csfmt">\GLSxtrshortplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4498"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4499"></a><code class="code"><dfn id="glo:glsxtrshortformatgrp"><code class="csfmt">\glsxtrshortformatgrp</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.4500"></a><a href="#glo:glsxtrshortformat"><code class="csfmt">\glsxtrshortformat</code></a>, but adds grouping around <span class="meta">〈<em class="metainner">insert</em>〉</span> (with the <a id="wrglossary.4501"></a><a href="#glo:dual.innerformatting">inner formatting</a> inside the group).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4502"></a><code class="code"><dfn id="glo:Glsxtrshortformatgrp"><code class="csfmt">\Glsxtrshortformatgrp</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4503"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4504"></a><code class="code"><dfn id="glo:GLSxtrshortformatgrp"><code class="csfmt">\GLSxtrshortformatgrp</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4505"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4506"></a><code class="code"><dfn id="glo:glsxtrshortplformatgrp"><code class="csfmt">\glsxtrshortplformatgrp</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.4507"></a><a href="#glo:glsxtrshortplformat"><code class="csfmt">\glsxtrshortplformat</code></a>, but adds grouping around <span class="meta">〈<em class="metainner">insert</em>〉</span> (with the <a id="wrglossary.4508"></a><a href="#glo:dual.innerformatting">inner formatting</a> inside the group).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4509"></a><code class="code"><dfn id="glo:Glsxtrshortplformatgrp"><code class="csfmt">\Glsxtrshortplformatgrp</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4510"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4511"></a><code class="code"><dfn id="glo:GLSxtrshortplformatgrp"><code class="csfmt">\GLSxtrshortplformatgrp</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4512"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4513"></a><code class="code"><dfn id="glo:glsxtrlongshortformat"><code class="csfmt">\glsxtrlongshortformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ A shortcut designed for <span class="meta">〈<em class="metainner">long</em>〉</span> (<span class="meta">〈<em class="metainner">short</em>〉</span>) styles. This is defined as: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4514"></a><a href="#glo:glsxtrlongformat"><code class="csfmt">\glsxtrlongformat</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}<a id="wrglossary.4515"></a><a href="#glo:glsxtrfullsep"><code class="csfmt">\glsxtrfullsep</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}<a id="wrglossary.4516"></a><a href="#glo:glsxtrparen"><code class="csfmt">\glsxtrparen</code></a>{<span class="meta">〈<em class="metainner"><a id="wrglossary.4517"></a><a href="#glo:glsxtrshortformat"><code class="csfmt">\glsxtrshortformat</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</em>〉</span>}</pre> Note that the <span class="meta">〈<em class="metainner">insert</em>〉</span> is only placed after the long form.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4518"></a><code class="code"><dfn id="glo:Glsxtrlongshortformat"><code class="csfmt">\Glsxtrlongshortformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4519"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4520"></a><code class="code"><dfn id="glo:GLSxtrlongshortformat"><code class="csfmt">\GLSxtrlongshortformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4521"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4522"></a><code class="code"><dfn id="glo:glsxtrlongshortplformat"><code class="csfmt">\glsxtrlongshortplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.4523"></a><a href="#glo:glsxtrlongshortformat"><code class="csfmt">\glsxtrlongshortformat</code></a> but uses the plural versions <a id="wrglossary.4524"></a><a href="#glo:glsxtrlongplformat"><code class="csfmt">\glsxtrlongplformat</code></a> and <a id="wrglossary.4525"></a><a href="#glo:glsxtrshortplformat"><code class="csfmt">\glsxtrshortplformat</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4526"></a><code class="code"><dfn id="glo:Glsxtrlongshortplformat"><code class="csfmt">\Glsxtrlongshortplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4527"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4528"></a><code class="code"><dfn id="glo:GLSxtrlongshortplformat"><code class="csfmt">\GLSxtrlongshortplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4529"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4530"></a><code class="code"><dfn id="glo:glsxtrshortlongformat"><code class="csfmt">\glsxtrshortlongformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ A shortcut designed for <span class="meta">〈<em class="metainner">short</em>〉</span> (<span class="meta">〈<em class="metainner">long</em>〉</span>) styles. This is defined as: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4531"></a><a href="#glo:glsxtrshortformat"><code class="csfmt">\glsxtrshortformat</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}<a id="wrglossary.4532"></a><a href="#glo:glsxtrfullsep"><code class="csfmt">\glsxtrfullsep</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}<a id="wrglossary.4533"></a><a href="#glo:glsxtrparen"><code class="csfmt">\glsxtrparen</code></a>{<span class="meta">〈<em class="metainner"><a id="wrglossary.4534"></a><a href="#glo:glsxtrlongformat"><code class="csfmt">\glsxtrlongformat</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}</em>〉</span>}</pre> Note that the <span class="meta">〈<em class="metainner">insert</em>〉</span> is only placed after the short form.<p>
+The syntax is the same as for <a id="wrglossary.4535"></a><a href="#glo:glsxtrlongshortformat"><code class="csfmt">\glsxtrlongshortformat</code></a> even though <a id="wrglossary.4536"></a><a href="#glo:glsxtrlongformat"><code class="csfmt">\glsxtrlongformat</code></a> and <a id="wrglossary.4537"></a><a href="#glo:glsxtrshortformat"><code class="csfmt">\glsxtrshortformat</code></a> are flipped within the definition.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4538"></a><code class="code"><dfn id="glo:Glsxtrshortlongformat"><code class="csfmt">\Glsxtrshortlongformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4539"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4540"></a><code class="code"><dfn id="glo:GLSxtrshortlongformat"><code class="csfmt">\GLSxtrshortlongformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4541"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4542"></a><code class="code"><dfn id="glo:glsxtrshortlongplformat"><code class="csfmt">\glsxtrshortlongplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.4543"></a><a href="#glo:glsxtrshortlongformat"><code class="csfmt">\glsxtrshortlongformat</code></a> but uses the plural versions <a id="wrglossary.4544"></a><a href="#glo:glsxtrshortplformat"><code class="csfmt">\glsxtrshortplformat</code></a> and <a id="wrglossary.4545"></a><a href="#glo:glsxtrlongplformat"><code class="csfmt">\glsxtrlongplformat</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4546"></a><code class="code"><dfn id="glo:Glsxtrshortlongplformat"><code class="csfmt">\Glsxtrshortlongplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4547"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4548"></a><code class="code"><dfn id="glo:GLSxtrshortlongplformat"><code class="csfmt">\GLSxtrshortlongplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above, but <a id="wrglossary.4549"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+
+</section><!-- end of section paragraph.4.5.3.2.5 -->
+
+<section id="sec:acrorevert"><!-- start of section sec:acrorevert --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->4.6. Restoring Base Acronym Mechanism<div class="labellink"><a href="#sec:acrorevert">[link]</a></div></h2><!-- end of section header -->
+<p>
+It’s possible to revert <a id="wrglossary.4550"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> back to the definition provided by the base <a id="wrglossary.4551"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. However, if you do this, you will lose all the abbreviation features provided by <a id="wrglossary.4552"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Where possible, avoid this. If you’re simply trying to make the long form appear on <a id="wrglossary.4553"></a><a href="#glo:dual.firstuse">first use</a> with <a id="wrglossary.4554"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>, set the abbreviation style using: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4555"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>[acronym]{long-short}
+</pre> </div><!-- end of important -->
+<p>
+If you really need to use the original base <a id="wrglossary.4556"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s acronym mechanism, it’s better to stick with just <a id="wrglossary.4557"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> and not use <a id="wrglossary.4558"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. However, it may be that you need to use a <a id="wrglossary.4559"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> feature, such as <a id="wrglossary.4560"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>, but you have a custom acronym style that you can’t implement using the <a id="wrglossary.4561"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> abbreviation mechanism. This is a rare edge case for unusual formats, as it should be possible to implement most common abbreviation formats using the predefined styles.<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+Unpredictable results will occur if <a id="wrglossary.4562"></a><a href="#glo:RestoreAcronyms"><code class="csfmt">\RestoreAcronyms</code></a> or <a id="wrglossary.4563"></a><a href="#glo:MakeAcronymsAbbreviations"><code class="csfmt">\MakeAcronymsAbbreviations</code></a> are used after abbreviations or acronyms have been defined. </div><!-- end of warning -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4564"></a><code class="code"><dfn id="glo:RestoreAcronyms"><code class="csfmt">\RestoreAcronyms</code></dfn></code></div><!-- end of pinnedbox -->
+ Restores <a id="wrglossary.4565"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> back to the original base <a id="wrglossary.4566"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> interface. Note that this doesn’t affect <a id="wrglossary.4567"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>. It also sets the <a id="wrglossary.4568"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute for the <a id="wrglossary.4569"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a> category to <code class="code">false</code> and sets the acronym style to <code class="code">long-short</code> (which is the default for the base package).<p>
+The display style for each <a id="wrglossary.4570"></a><a href="#glo:dual.glossary">glossary</a> identified in the acronym lists is switched to the default acronym display style.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4571"></a><code class="code"><dfn id="glo:MakeAcronymsAbbreviations"><code class="csfmt">\MakeAcronymsAbbreviations</code></dfn></code></div><!-- end of pinnedbox -->
+ Counteracts <a id="wrglossary.4572"></a><a href="#glo:RestoreAcronyms"><code class="csfmt">\RestoreAcronyms</code></a>.<p>
+
+</section><!-- end of section sec:acrorevert -->
+
+<section id="sec:glsref"><!-- start of section sec:glsref --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->5. Referencing (Using) Entries<div class="labellink"><a href="#sec:glsref">[link]</a></div></h1><!-- end of chapter header -->
+<p>
+Entries can be referenced using the <a id="wrglossary.4573"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.4574"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands, as described in the base <a id="wrglossary.4575"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> manual. There are some additional commands provided by <a id="wrglossary.4576"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>:
+<ul class="displaylist">
+ <li><span class="bulletitem">•</span>abbreviation commands, such as <a id="wrglossary.4577"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> (see §<a href="#sec:abbreviations">4</a>); <li><span class="bulletitem">•</span>commands for use in captions or section headings, such as <a id="wrglossary.4578"></a><a href="#glo:glsfmttext"><code class="csfmt">\glsfmttext</code></a> (see §<a href="#sec:headingcommands">5.3.2</a>); <li><span class="bulletitem">•</span>commands, such as <a id="wrglossary.4579"></a><a href="#glo:glsxtrp"><code class="csfmt">\glsxtrp</code></a>, designed for use within fields to help mitigate the problems of nesting (see §<a href="#sec:nested">5.4</a>); <li><span class="bulletitem">•</span>commands, such as <a id="wrglossary.4580"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>, that are designed for referencing multi (or compound) entries (see §<a href="#sec:multientries">7</a>); <li><span class="bulletitem">•</span>commands, such as <a id="wrglossary.4581"></a><a href="#glo:glsaccessname"><code class="csfmt">\glsaccessname</code></a>, used to incorporate accessibility support (see §<a href="#sec:glsaccessfield">9.2</a>); <li><span class="bulletitem">•</span>commands, such as <a id="wrglossary.4582"></a><a href="#glo:dgls"><code class="csfmt">\dgls</code></a>, that are designed for <a id="wrglossary.4583"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span>’s</a> dual entries (see §<a href="#sec:dgls">11.5.7</a>); <li><span class="bulletitem">•</span>commands, such as <a id="wrglossary.4584"></a><a href="#glo:rgls"><code class="csfmt">\rgls</code></a>, that depend on the number of entry records (see §<a href="#sec:recordcount">11.4</a>).
+</ul>
+ Additionally, the entry counting commands, such as <a id="wrglossary.4585"></a><a href="#glo:cgls"><code class="csfmt">\cgls</code></a>, provided by the base <a id="wrglossary.4586"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package are modified by <a id="wrglossary.4587"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> (see §<a href="#sec:entrycount">6.1</a>).<p>
+The <a id="wrglossary.4588"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands are designed to produce text at that point in the document (the <a id="wrglossary.4589"></a><a href="#glo:dual.linktext">link text</a>, §<a href="#sec:entryfmtmods">5.5</a>), index the entry (to ensure that it appears in the glossary, §<a href="#sec:wrglossary">5.8</a>) and unset the <a id="wrglossary.4590"></a><a href="#glo:dual.firstuseflag">first use flag</a> (which can alter the <a id="wrglossary.4591"></a><a href="#glo:dual.linktext">link text</a>, §<a href="#sec:glsunset">5.10</a>). Additional information can be appended automatically with the <a id="wrglossary.4592"></a><a href="#glo:dual.postlinkhook">post-link hook</a> (§<a href="#sec:postlinkhook">5.5.4</a>). The <a id="wrglossary.4593"></a><a href="#glo:dual.linktext">link text</a> is given by the entry style (see §<a href="#sec:entryfmt">5.5.5</a>) or by the final argument of <a id="wrglossary.4594"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a>.<p>
+The <a id="wrglossary.4595"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands are designed to produce text at that point in the document (the <a id="wrglossary.4596"></a><a href="#glo:dual.linktext">link text</a>, §<a href="#sec:entryfmtmods">5.5</a>) and index the entry (to ensure that it appears in the glossary, §<a href="#sec:wrglossary">5.8</a>). Additional information can be appended automatically with the <a id="wrglossary.4597"></a><a href="#glo:dual.postlinkhook">post-link hook</a> (§<a href="#sec:postlinkhook">5.5.4</a>). The <a id="wrglossary.4598"></a><a href="#glo:dual.linktext">link text</a> is determined by the calling command. For example, the corresponding field value (possibly encapsulated with <a id="wrglossary.4599"></a><a href="#glo:glsxtrregularfont"><code class="csfmt">\glsxtrregularfont</code></a> and the inner formatting) for commands like <a id="wrglossary.4600"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> or the final argument of <a id="wrglossary.4601"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a>.<p>
+The <a id="wrglossary.4602"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.4603"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands can all be used with a star (<code class="code">*</code>) or plus (<code class="code">+</code>) modifier. The star modifier automatically implements <a id="wrglossary.4604"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span> (disables the hyperlink) and the plus modifier automatically implements <a id="wrglossary.4605"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=true</span> (forces the hyperlink on, if supported).<p>
+With <a id="wrglossary.4606"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, it’s possible to define an additional modifier for your own use with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4607"></a><code class="code"><dfn id="glo:GlsXtrSetAltModifier"><code class="csfmt">\GlsXtrSetAltModifier</code></dfn>{<span class="meta">〈<em class="metainner">token</em>〉</span>}{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The <span class="meta">〈<em class="metainner">token</em>〉</span> must be a single token, so a multi-byte <a id="wrglossary.4608"></a><a href="#glo:dual.utf8">UTF-8</a> character will required a native Unicode engine (XeLaTeX or LuaLaTeX). For example, the following: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4609"></a><a href="#glo:GlsXtrSetAltModifier"><code class="csfmt">\GlsXtrSetAltModifier</code></a>{!}{<a id="wrglossary.4610"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=glsignore</span>}
+</pre> means that <code class="code"><a id="wrglossary.4611"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>!{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> will be equivalent to <code class="code"><a id="wrglossary.4612"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.4613"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=glsignore</span>]{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code>.<p>
+It’s also possible to redefine the star and plus modifiers: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4614"></a><code class="code"><dfn id="glo:GlsXtrSetStarModifier"><code class="csfmt">\GlsXtrSetStarModifier</code></dfn>{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This sets the options to use for the star modifier. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4615"></a><code class="code"><dfn id="glo:GlsXtrSetPlusModifier"><code class="csfmt">\GlsXtrSetPlusModifier</code></dfn>{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This sets the options to use for the plus modifier. For example, the following: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4616"></a><a href="#glo:GlsXtrSetPlusModifier"><code class="csfmt">\GlsXtrSetPlusModifier</code></a>{<a id="wrglossary.4617"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a>}
+</pre> means that the star modifier will now suppress <a id="wrglossary.4618"></a><a href="#glo:dual.indexing">indexing</a> instead of switching on the hyperlink.<p>
+The <a id="wrglossary.4619"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.4620"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands have a complicated internal structure, which can be viewed as a series of layers. The outermost common layer is: <pre class="compactcodebox"><span class="comment">% save settings</span>
+<span class="comment">% initialise options, see §<a href="#sec:glsopts">5.1</a></span>
+<a id="wrglossary.4621"></a><a href="#glo:glslinkwrcontent"><code class="csfmt">\glslinkwrcontent</code></a>{<span class="meta">〈<em class="metainner">index &amp; fmt content</em>〉</span>}
+<span class="comment">% restore settings</span>
+<span class="comment">% <a id="wrglossary.4622"></a><a href="#glo:dual.postlinkhook">post-link hook</a>, see §<a href="#sec:postlinkhook">5.5.4</a></span>
+</pre> The <span class="meta">〈<em class="metainner">index &amp; fmt content</em>〉</span> consists of the <a id="wrglossary.4623"></a><a href="#glo:dual.indexing">indexing</a> (see §<a href="#sec:wrglossary">5.8</a>) and the (possibly hyperlinked) formatted text, see §<a href="#sec:entryfmtmods">5.5</a>. The <span class="meta">〈<em class="metainner">index &amp; fmt content</em>〉</span> code is encapsulated with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4624"></a><code class="code"><dfn id="glo:glslinkwrcontent"><code class="csfmt">\glslinkwrcontent</code></dfn>{<span class="meta">〈<em class="metainner">code</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ In v1.48, this was added to scope the <a id="wrglossary.4625"></a><a href="#glo:dual.linktext">link text</a> and <a id="wrglossary.4626"></a><a href="#glo:dual.indexing">indexing</a> code, which helped to prevent unwanted spacing caused by the <a id="wrglossary.4627"></a><a href="#glo:dual.whatsit">whatsit</a> and also helped to prevent some setting leakage, in the event of nesting (see §<a href="#sec:nested">5.4</a>), but this caused spacing issues when used in math mode, so from v1.49 this command now simply does its argument. The <a id="wrglossary.4628"></a><a href="#glo:dual.whatsit">whatsit</a> is now scoped with <a id="wrglossary.4629"></a><a href="#glo:glsencapwrcontent"><code class="csfmt">\glsencapwrcontent</code></a> instead.<p>
+The <a id="wrglossary.4630"></a><a href="#glo:glsxtrp"><code class="csfmt">\glsxtrp</code></a> command, designed for nested use, deals with the problem by suppressing the <a id="wrglossary.4631"></a><a href="#glo:dual.postlinkhook">post-link hook</a> and adding an outer group. For example, <code class="code"><a id="wrglossary.4632"></a><a href="#glo:glsxtrp"><code class="csfmt">\glsxtrp</code></a>{short}{html}</code> behaves like: <pre class="compactcodebox">{<a id="wrglossary.4633"></a><a href="#glo:let"><code class="csfmt">\let</code></a><a id="wrglossary.4634"></a><a href="#glo:glspostlinkhook"><code class="csfmt">\glspostlinkhook</code></a><a id="wrglossary.4635"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a>
+ <a id="wrglossary.4636"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>[noindex,nohyper]{html}}
+</pre><p>
+Depending on the settings (the <a id="wrglossary.4637"></a><a href="#glo:opt.glsopt.wrgloss"><span class="csoptfmt">wrgloss</span></a> option or the <a id="wrglossary.4638"></a><a href="#glo:opt.catattr.wrgloss"><span class="csoptfmt">wrgloss</span></a> attribute), the indexing may come before the text: <pre class="compactcodebox"><a id="wrglossary.4639"></a><a href="#glo:glslinkwrcontent"><code class="csfmt">\glslinkwrcontent</code></a>{<span class="meta">〈<em class="metainner">index</em>〉</span><span class="meta">〈<em class="metainner">fmt content</em>〉</span>}
+</pre> or after the text: <pre class="compactcodebox"><a id="wrglossary.4640"></a><a href="#glo:glslinkwrcontent"><code class="csfmt">\glslinkwrcontent</code></a>{<span class="meta">〈<em class="metainner">fmt content</em>〉</span><span class="meta">〈<em class="metainner">index</em>〉</span>}
+</pre> or may be suppressed with <a id="wrglossary.4641"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a>: <pre class="compactcodebox"><a id="wrglossary.4642"></a><a href="#glo:glslinkwrcontent"><code class="csfmt">\glslinkwrcontent</code></a>{<span class="meta">〈<em class="metainner">fmt content</em>〉</span>}
+</pre> The <span class="meta">〈<em class="metainner">fmt content</em>〉</span> part is described in §<a href="#sec:entryfmtmods">5.5</a>. The <span class="meta">〈<em class="metainner">index</em>〉</span> part is the actual <a id="wrglossary.4643"></a><a href="#glo:dual.indexing">indexing</a> (see §<a href="#sec:wrglossary">5.8</a>) but also increments the index count, if applicable. Both the associated <a id="wrglossary.4644"></a><a href="#glo:dual.whatsit">whatsit</a> and increment are encapsulated with <a id="wrglossary.4645"></a><a href="#glo:glsencapwrcontent"><code class="csfmt">\glsencapwrcontent</code></a>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Avoid using <a id="wrglossary.4646"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>, <a id="wrglossary.4647"></a><a href="#glo:glsplural"><code class="csfmt">\glsplural</code></a>, <a id="wrglossary.4648"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a> and <a id="wrglossary.4649"></a><a href="#glo:glsfirstplural"><code class="csfmt">\glsfirstplural</code></a> (and their case-changing variants) with entries that have been defined with <a id="wrglossary.4650"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>. Some of the abbreviation styles are too complicated to work with those commands. Instead, use commands like <a id="wrglossary.4651"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>, <a id="wrglossary.4652"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> or use <a id="wrglossary.4653"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> with the <a id="wrglossary.4654"></a><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a> or <a id="wrglossary.4655"></a><a href="#glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></a> options. </div><!-- end of important -->
+<p>
+The base <a id="wrglossary.4656"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package provides a way to adjust the formatting of the <a id="wrglossary.4657"></a><a href="#glo:dual.linktext">link text</a> for the <a id="wrglossary.4658"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands according to the glossary type with <a id="wrglossary.4659"></a><a href="#glo:defglsentryfmt"><code class="csfmt">\defglsentryfmt</code></a>. The <a id="wrglossary.4660"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package changes the default entry formatting (§<a href="#sec:entryfmt">5.5.5</a>) and provides additional ways of modifying the displayed content (§<a href="#sec:entryfmtmods">5.5</a>).<p>
+The heading commands (described in §<a href="#sec:headtitle">5.3</a>) are designed to prevent indexing or changes to the <a id="wrglossary.4661"></a><a href="#glo:dual.firstuseflag">first use flag</a> if they appear in the table of contents (or list of figures, etc) or if they appear in the page header.<p>
+Although the base <a id="wrglossary.4662"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package warns against nested <a id="wrglossary.4663"></a><a href="#glo:dual.linktext">link text</a>, the <a id="wrglossary.4664"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides <a id="wrglossary.4665"></a><a href="#glo:glsxtrp"><code class="csfmt">\glsxtrp</code></a> which can be used instead of <a id="wrglossary.4666"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> in field values to overcome some of the associated problems. See §<a href="#sec:nested">5.4</a> for further details.<p>
+If you need to simply access a <a id="wrglossary.4667"></a><a href="#glo:dual.field">field</a> value without any formatting, see §<a href="#sec:getfields">5.11</a>. (See §<a href="#sec:setfields">3.5</a> to set <a id="wrglossary.4668"></a><a href="#glo:dual.field">field</a> values.) If you want to encapsulate the value with the appropriate accessibility tag, see §<a href="#sec:glsaccessfield">9.2</a>.<p>
+Commands such as <a id="wrglossary.4669"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> (see §<a href="#sec:wrglossary">5.8</a>) and <a id="wrglossary.4670"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a> (see §<a href="#sec:xr">5.9</a>) are designed to only index (to ensure the entry appears in the glossary) without producing any text or changing the <a id="wrglossary.4671"></a><a href="#glo:dual.firstuseflag">first use flag</a>.<p>
+The <a id="wrglossary.4672"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a>, <a id="wrglossary.4673"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> and <a id="wrglossary.4674"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> commands all have an initial optional argument that can be used to override the default actions. Some options are only applicable for particular subsets of referencing commands. For example, <a id="wrglossary.4675"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a> is pointless for <a id="wrglossary.4676"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> since the sole purpose of that command is to index. Whereas <a id="wrglossary.4677"></a><a href="#glo:opt.glsopt.types"><span class="csoptfmt">types</span></a> is only available with <a id="wrglossary.4678"></a><a href="#glo:glsaddall"><code class="csfmt">\glsaddall</code></a>.<p>
+
+</section><!-- end of section sec:glsref -->
+
+<section id="sec:glsopts"><!-- start of section sec:glsopts --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->5.1. Options<div class="labellink"><a href="#sec:glsopts">[link]</a></div></h2><!-- end of section header -->
+<p>
+<a id="wrglossary.4679"></a>Some options are provided by the base <a id="wrglossary.4680"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, but there are some additional options provided by <a id="wrglossary.4681"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, which are listed in §<a href="#sec:xtrglsopts">5.1.2</a>. Below, <span class="meta">〈<em class="metainner">option-list</em>〉</span> indicates the options that are passed in the optional argument of the calling command (such as <a id="wrglossary.4682"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>).<p>
+The order that the options are applied is:
+<ol class="displaylist">
+ <li><span class="numitem">1.</span><a id="wrglossary.4683"></a><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a>, <a id="wrglossary.4684"></a><a href="#glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></a> and <a id="wrglossary.4685"></a><a href="#glo:opt.glsopt.postunset"><span class="csoptfmt">postunset</span></a> options are initialised by <a id="wrglossary.4686"></a><a href="#glo:glsinitreunsets"><code class="csfmt">\glsinitreunsets</code></a>; <li><span class="numitem">2.</span><a id="wrglossary.4687"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a> is initialised by <a id="wrglossary.4688"></a><a href="#glo:glsxtrchecknohyperfirst"><code class="csfmt">\glsxtrchecknohyperfirst</code></a> (<a id="wrglossary.4689"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a>-like only); <li><span class="numitem">3.</span><a id="wrglossary.4690"></a><a href="#glo:opt.glsopt.wrgloss"><span class="csoptfmt">wrgloss</span></a> option is initialised by <a id="wrglossary.4691"></a><a href="#glo:glsxtrinitwrgloss"><code class="csfmt">\glsxtrinitwrgloss</code></a> (not implemented by <a id="wrglossary.4692"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> or <a id="wrglossary.4693"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a>); <li><span class="numitem">4.</span><a id="wrglossary.4694"></a><a href="#glo:opt.glsopt.hyperoutside"><span class="csoptfmt">hyperoutside</span></a> option is initialised by <a id="wrglossary.4695"></a><a href="#glo:glsxtrinithyperoutside"><code class="csfmt">\glsxtrinithyperoutside</code></a> (not implemented by <a id="wrglossary.4696"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> or <a id="wrglossary.4697"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a>); <li><span class="numitem">5.</span>initialise <a id="wrglossary.4698"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a><span class="optfmt">=false</span> (not <a id="wrglossary.4699"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>); <li><span class="numitem">6.</span>options identified by <a id="wrglossary.4700"></a><a href="#glo:GlsXtrSetDefaultGlsOpts"><code class="csfmt">\GlsXtrSetDefaultGlsOpts</code></a>, <a id="wrglossary.4701"></a><a href="#glo:GlsXtrAppToDefaultGlsOpts"><code class="csfmt">\GlsXtrAppToDefaultGlsOpts</code></a> or <a id="wrglossary.4702"></a><a href="#glo:GlsXtrPreToDefaultGlsOpts"><code class="csfmt">\GlsXtrPreToDefaultGlsOpts</code></a> (not implemented by <a id="wrglossary.4703"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>); <li><span class="numitem">7.</span>(<a id="wrglossary.4704"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a> only) options provided in <a id="wrglossary.4705"></a><a href="#glo:GlsXtrFmtDefaultOptions"><code class="csfmt">\GlsXtrFmtDefaultOptions</code></a>; <li><span class="numitem">8.</span>(<a id="wrglossary.4706"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> only) the <a id="wrglossary.4707"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a> package option, <a id="wrglossary.4708"></a><a href="#glo:opt.catattr.nohyperfirst"><span class="csoptfmt">nohyperfirst</span></a> attribute and <a id="wrglossary.4709"></a><a href="#glo:opt.catattr.nohypernext"><span class="csoptfmt">nohypernext</span></a> attributes are checked to determine if the <a id="wrglossary.4710"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a> option should be switched off (tests followed by <a id="wrglossary.4711"></a><a href="#glo:glslinkcheckfirsthyperhook"><code class="csfmt">\glslinkcheckfirsthyperhook</code></a>); <li><span class="numitem">9.</span><a id="wrglossary.4712"></a><a href="#glo:glslinkpresetkeys"><code class="csfmt">\glslinkpresetkeys</code></a> (not implemented by <a id="wrglossary.4713"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> or <a id="wrglossary.4714"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a>); <li><span class="numitem">10.</span>(<a id="wrglossary.4715"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> only) <a id="wrglossary.4716"></a><a href="#glo:glsaddpresetkeys"><code class="csfmt">\glsaddpresetkeys</code></a>; <li><span class="numitem">11.</span><span class="meta">〈<em class="metainner">option-list</em>〉</span>; <li><span class="numitem">12.</span><a id="wrglossary.4717"></a><a href="#glo:glslinkpostsetkeys"><code class="csfmt">\glslinkpostsetkeys</code></a> (provided by the base <a id="wrglossary.4718"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, not implemented by <a id="wrglossary.4719"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> or <a id="wrglossary.4720"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a>); <li><span class="numitem">13.</span>(<a id="wrglossary.4721"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> only) <a id="wrglossary.4722"></a><a href="#glo:glsaddpostsetkeys"><code class="csfmt">\glsaddpostsetkeys</code></a>.
+</ol>
+<p>
+
+</section><!-- end of section sec:glsopts -->
+
+<section id="sec:defaultglsopts"><!-- start of section sec:defaultglsopts --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->5.1.1. Setting Up Defaults<div class="labellink"><a href="#sec:defaultglsopts">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+You can (locally) set your preferred default options for the <a id="wrglossary.4723"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.4724"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4725"></a><code class="code"><dfn id="glo:GlsXtrSetDefaultGlsOpts"><code class="csfmt">\GlsXtrSetDefaultGlsOpts</code></dfn>{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The <span class="meta">〈<em class="metainner">options</em>〉</span> may be any options that you can pass to those commands. These options also apply to <a id="wrglossary.4726"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a> but not to <a id="wrglossary.4727"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+Note that multiple instances of <a id="wrglossary.4728"></a><a href="#glo:GlsXtrSetDefaultGlsOpts"><code class="csfmt">\GlsXtrSetDefaultGlsOpts</code></a> will override each other. </div><!-- end of information -->
+<p>
+If you want to add to the existing options, you can use one of the following commands (both may be scoped).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4729"></a><code class="code"><dfn id="glo:GlsXtrAppToDefaultGlsOpts"><code class="csfmt">\GlsXtrAppToDefaultGlsOpts</code></dfn>{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Appends <span class="meta">〈<em class="metainner">options</em>〉</span> to the list of default options.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4730"></a><code class="code"><dfn id="glo:GlsXtrPreToDefaultGlsOpts"><code class="csfmt">\GlsXtrPreToDefaultGlsOpts</code></dfn>{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Prepends <span class="meta">〈<em class="metainner">options</em>〉</span> to the list of default options.<p>
+For example, to prevent indexing in the front matter and back matter but not in the main matter: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4731"></a><a href="#glo:frontmatter"><code class="csfmt">\frontmatter</code></a>
+<a id="wrglossary.4732"></a><a href="#glo:GlsXtrSetDefaultGlsOpts"><code class="csfmt">\GlsXtrSetDefaultGlsOpts</code></a>{<a id="wrglossary.4733"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a>}
+…<a id="wrglossary.4734"></a><a href="#glo:mainmatter"><code class="csfmt">\mainmatter</code></a>
+<a id="wrglossary.4735"></a><a href="#glo:GlsXtrSetDefaultGlsOpts"><code class="csfmt">\GlsXtrSetDefaultGlsOpts</code></a>{}
+…<a id="wrglossary.4736"></a><a href="#glo:backmatter"><code class="csfmt">\backmatter</code></a>
+<a id="wrglossary.4737"></a><a href="#glo:GlsXtrSetDefaultGlsOpts"><code class="csfmt">\GlsXtrSetDefaultGlsOpts</code></a>{<a id="wrglossary.4738"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a>}
+</pre> Note that <a id="wrglossary.4739"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a><span class="optfmt">=false</span> is now set before the options given in <a id="wrglossary.4740"></a><a href="#glo:GlsXtrSetDefaultGlsOpts"><code class="csfmt">\GlsXtrSetDefaultGlsOpts</code></a> to ensure that the setting is correctly initialised, so as from v1.49 you can simply set an empty options list to reset the default. Prior to v1.49, it was necessary to ensure that the <a id="wrglossary.4741"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a> key was always present in the options list to avoid instability. So for pre v1.49, the line after <a id="wrglossary.4742"></a><a href="#glo:mainmatter"><code class="csfmt">\mainmatter</code></a> in the above would need to be: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4743"></a><a href="#glo:GlsXtrSetDefaultGlsOpts"><code class="csfmt">\GlsXtrSetDefaultGlsOpts</code></a>{<a id="wrglossary.4744"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a><span class="optfmt">=false</span>}
+</pre><p>
+The default <a id="wrglossary.4745"></a><a href="#glo:dual.locationencap">location encap</a> is <a id="wrglossary.4746"></a><a href="#glo:glsnumberformat"><span class="csfmtcolourfont">glsnumberformat</span></a> but can be changed (locally) with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4747"></a><code class="code"><dfn id="glo:GlsXtrSetDefaultNumberFormat"><code class="csfmt">\GlsXtrSetDefaultNumberFormat</code></dfn>{<span class="meta">〈<em class="metainner">encap</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This can be overridden by explicitly setting the <a id="wrglossary.4748"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a> key.<p>
+The default options for <a id="wrglossary.4749"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a> only are given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4750"></a><code class="code"><dfn id="glo:GlsXtrFmtDefaultOptions"><code class="csfmt">\GlsXtrFmtDefaultOptions</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>noindex</span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This command should simply expand to the required list of options. These options are set after any options given in <a id="wrglossary.4751"></a><a href="#glo:GlsXtrSetDefaultGlsOpts"><code class="csfmt">\GlsXtrSetDefaultGlsOpts</code></a> and before <span class="meta">〈<em class="metainner">option-list</em>〉</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4752"></a><code class="code"><dfn id="glo:glslinkpresetkeys"><code class="csfmt">\glslinkpresetkeys</code></dfn></code></div><!-- end of pinnedbox -->
+ This hook is performed after any settings provided in <a id="wrglossary.4753"></a><a href="#glo:GlsXtrSetDefaultGlsOpts"><code class="csfmt">\GlsXtrSetDefaultGlsOpts</code></a> but before <span class="meta">〈<em class="metainner">option-list</em>〉</span>. This hook also applies to <a id="wrglossary.4754"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a> but not to <a id="wrglossary.4755"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>.<p>
+Note that <a id="wrglossary.4756"></a><a href="#glo:glslinkpostsetkeys"><code class="csfmt">\glslinkpostsetkeys</code></a>, provided by the base <a id="wrglossary.4757"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, is performed after <span class="meta">〈<em class="metainner">option-list</em>〉</span> is processed. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4758"></a><code class="code"><dfn id="glo:glsaddpresetkeys"><code class="csfmt">\glsaddpresetkeys</code></dfn></code></div><!-- end of pinnedbox -->
+ This hook, which is only used by <a id="wrglossary.4759"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>, is performed before <span class="meta">〈<em class="metainner">option-list</em>〉</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4760"></a><code class="code"><dfn id="glo:glsaddpostsetkeys"><code class="csfmt">\glsaddpostsetkeys</code></dfn></code></div><!-- end of pinnedbox -->
+ This hook, which is only used by <a id="wrglossary.4761"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>, is performed after <span class="meta">〈<em class="metainner">option-list</em>〉</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4762"></a><code class="code"><dfn id="glo:glsinitreunsets"><code class="csfmt">\glsinitreunsets</code></dfn></code></div><!-- end of pinnedbox -->
+ This hook initialises the pre unset/reset options to: <a id="wrglossary.4763"></a><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a><span class="optfmt">=none</span> and <a id="wrglossary.4764"></a><a href="#glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></a><span class="optfmt">=none</span>. It also initialises the <a id="wrglossary.4765"></a><a href="#glo:opt.glsopt.postunset"><span class="csoptfmt">postunset</span></a> setting to perform the post-unset (where applicable) but it will retain the current local/global setting.<p>
+This hook will also implement the local repeat unset feature of <a id="wrglossary.4766"></a><a href="#glo:GlsXtrUnsetBufferEnableRepeatLocal"><code class="csfmt">\GlsXtrUnsetBufferEnableRepeatLocal</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4767"></a><code class="code"><dfn id="glo:glsxtrchecknohyperfirst"><code class="csfmt">\glsxtrchecknohyperfirst</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This hook is only used by <a id="wrglossary.4768"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a>, <a id="wrglossary.4769"></a><a href="#glo:glsfirstplural"><code class="csfmt">\glsfirstplural</code></a> and their case-changing variants. The hook will implement <a id="wrglossary.4770"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span> if the <a id="wrglossary.4771"></a><a href="#glo:opt.catattr.nohyperfirst"><span class="csoptfmt">nohyperfirst</span></a> attribute is set to <code class="code">true</code>. <p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4772"></a><code class="code"><dfn id="glo:glsxtrinitwrgloss"><code class="csfmt">\glsxtrinitwrgloss</code></dfn></code></div><!-- end of pinnedbox -->
+ This hook initialises the default setting of the <a id="wrglossary.4773"></a><a href="#glo:opt.glsopt.wrgloss"><span class="csoptfmt">wrgloss</span></a> option. If the <a id="wrglossary.4774"></a><a href="#glo:opt.catattr.wrgloss"><span class="csoptfmt">wrgloss</span></a> attribute is set to <code class="code">after</code> then this implements <a id="wrglossary.4775"></a><a href="#glo:opt.glsopt.wrgloss"><span class="csoptfmt">wrgloss</span></a><span class="optfmt">=after</span> otherwise it implements <a id="wrglossary.4776"></a><a href="#glo:opt.glsopt.wrgloss"><span class="csoptfmt">wrgloss</span></a><span class="optfmt">=before</span>. This setting can subsequently be overridden by <a id="wrglossary.4777"></a><a href="#glo:GlsXtrSetDefaultGlsOpts"><code class="csfmt">\GlsXtrSetDefaultGlsOpts</code></a>, <a id="wrglossary.4778"></a><a href="#glo:glslinkpresetkeys"><code class="csfmt">\glslinkpresetkeys</code></a>, the <span class="meta">〈<em class="metainner">option-list</em>〉</span> argument or <a id="wrglossary.4779"></a><a href="#glo:glslinkpostsetkeys"><code class="csfmt">\glslinkpostsetkeys</code></a>. This hook also applies to <a id="wrglossary.4780"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a> but not to <a id="wrglossary.4781"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>.<p>
+If you prefer to have the default to place the <a id="wrglossary.4782"></a><a href="#glo:dual.indexing">indexing</a> after the <a id="wrglossary.4783"></a><a href="#glo:dual.linktext">link text</a>, you can redefine this hook as follows: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.4784"></a><a href="#glo:glsxtrinitwrgloss"><code class="csfmt">\glsxtrinitwrgloss</code></a>}{%
+ <a id="wrglossary.4785"></a><a href="#glo:glsifattribute"><code class="csfmt">\glsifattribute</code></a>{<a id="wrglossary.4786"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}{<a id="wrglossary.4787"></a><a href="#glo:opt.catattr.wrgloss"><span class="csoptfmt">wrgloss</span></a>}{before}%
+ %
+ <a id="wrglossary.4788"></a><a href="#glo:glsxtrinitwrglossbeforetrue"><code class="csfmt">\glsxtrinitwrglossbeforetrue</code></a>
+ %
+ %
+ <a id="wrglossary.4789"></a><a href="#glo:glsxtrinitwrglossbeforefalse"><code class="csfmt">\glsxtrinitwrglossbeforefalse</code></a>
+ %
}
-</pre>
-<!--l. 8315--><p class="nopar" >
-</p><!--l. 8317--><p class="indent" > The <a
-href="#styopt.showtargets"><span
-class="cmss-10">showtargets</span></a><span
-class="cmss-10">=annoteleft</span><a
- id="dx1-45004"></a> option can be used to mark up the links
-with the targets. For example, the first instance of <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mgls{shtml}</span></span></span> will show
-as:
- </p><blockquote class="quote">
- <!--l. 8324--><p class="noindent" >Multi-entry first use: <span
-class="cmtt-8">[glo:ssi]</span><span
-class="cmmi-5">&#x22B3;</span><span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">s</span><span
-class="small-caps">i</span></span><span
-class="cmmi-5">&#x22B2; </span><span
-class="cmtt-8">[glo:shtml]</span><span
-class="cmmi-5">&#x22B3;</span>enabled<span
-class="cmmi-5">&#x22B2;</span>
- <span
-class="cmtt-8">[glo:html]</span><span
-class="cmmi-5">&#x22B3;</span><span
-class="cmcsc-10"><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span><span
-class="cmmi-5">&#x22B2; </span>(<span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>).</p></blockquote>
-<!--l. 8328--><p class="noindent" >Each entry has an individual hyperlink to its own glossary item, which may be
-confusing. This can be made clearer by suppressing the main element link on first use
-with:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-193">
-hyper=notmainfirst
-</pre>
-<!--l. 8333--><p class="nopar" > (as in the previous example), and adjusting the abbreviation style so that the
-parenthetical content in the post-link hook has a hyperlink:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-194">
-\renewcommand*{\glsxtruserparen}[2]{%
-&#x00A0;&#x00A0;\glsxtrfullsep{#2}%
-&#x00A0;&#x00A0;\glsxtrparen
-&#x00A0;&#x00A0;&#x00A0;{\glshyperlink[#1]{#2}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\ifglshasfield{\glsxtruserfield}{#2}{,&#x00A0;\glscurrentfieldvalue}{}%
-&#x00A0;&#x00A0;&#x00A0;}%
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4790"></a><code class="code"><dfn id="glo:glsxtrinithyperoutside"><code class="csfmt">\glsxtrinithyperoutside</code></dfn></code></div><!-- end of pinnedbox -->
+ This hook initialises the default setting of the <a id="wrglossary.4791"></a><a href="#glo:opt.glsopt.hyperoutside"><span class="csoptfmt">hyperoutside</span></a> option. If the <a id="wrglossary.4792"></a><a href="#glo:opt.catattr.hyperoutside"><span class="csoptfmt">hyperoutside</span></a> attribute is set to <code class="code">false</code> then this implements <a id="wrglossary.4793"></a><a href="#glo:opt.glsopt.hyperoutside"><span class="csoptfmt">hyperoutside</span></a><span class="optfmt">=false</span> otherwise it implements <a id="wrglossary.4794"></a><a href="#glo:opt.glsopt.hyperoutside"><span class="csoptfmt">hyperoutside</span></a><span class="optfmt">=true</span>. This setting can subsequently be overridden by <a id="wrglossary.4795"></a><a href="#glo:GlsXtrSetDefaultGlsOpts"><code class="csfmt">\GlsXtrSetDefaultGlsOpts</code></a>, <a id="wrglossary.4796"></a><a href="#glo:glslinkpresetkeys"><code class="csfmt">\glslinkpresetkeys</code></a>, the <span class="meta">〈<em class="metainner">option-list</em>〉</span> argument or <a id="wrglossary.4797"></a><a href="#glo:glslinkpostsetkeys"><code class="csfmt">\glslinkpostsetkeys</code></a>. This hook also applies to <a id="wrglossary.4798"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a> but not to <a id="wrglossary.4799"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>.<p>
+Within any of the hooks that are used by the <a id="wrglossary.4800"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a>, <a id="wrglossary.4801"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> or <a id="wrglossary.4802"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a> commands, you can set options using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4803"></a><code class="code"><dfn id="glo:setupglslink"><code class="csfmt">\setupglslink</code></dfn>{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<p>
+Within any of the hooks that are used by <a id="wrglossary.4804"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>, you can set options with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4805"></a><code class="code"><dfn id="glo:setupglsadd"><code class="csfmt">\setupglsadd</code></dfn>{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<p>
+
+</section><!-- end of section sec:defaultglsopts -->
+
+<section id="sec:xtrglsopts"><!-- start of section sec:xtrglsopts --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->5.1.2. Additional Options<div class="labellink"><a href="#sec:xtrglsopts">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+Options for the <a id="wrglossary.4806"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.4807"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands that are provided by the base <a id="wrglossary.4808"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package also apply to new commands like <a id="wrglossary.4809"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a> and <a id="wrglossary.4810"></a><a href="#glo:glsfmttext"><code class="csfmt">\glsfmttext</code></a>. In addition, the options below are provided by <a id="wrglossary.4811"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. Note that some options, such as <a id="wrglossary.4812"></a><a href="#glo:opt.glsopt.postunset"><span class="csoptfmt">postunset</span></a>, only apply to the <a id="wrglossary.4813"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands. Options that relate to the hyperlink, formatting, <a id="wrglossary.4814"></a><a href="#glo:dual.firstuseflag">first use flag</a> or whether/where (<a id="wrglossary.4815"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a>/<a id="wrglossary.4816"></a><a href="#glo:opt.glsopt.wrgloss"><span class="csoptfmt">wrgloss</span></a>) to perform <a id="wrglossary.4817"></a><a href="#glo:dual.indexing">indexing</a> aren’t available for <a id="wrglossary.4818"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.4819"></a><code class="code"><dfn id="glo:opt.glsopt.hyperoutside"><span class="csoptfmt">hyperoutside</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This boolean option determines whether the hyperlink should be inside or outside of <a id="wrglossary.4820"></a><a href="#glo:glstextformat"><code class="csfmt">\glstextformat</code></a> (see §<a href="#sec:glstextformat">5.5.1</a>). If true, the <a id="wrglossary.4821"></a><a href="#glo:dual.linktext">link text</a> is encapsulated as: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><span class="meta">〈<em class="metainner">hyperlink-cs</em>〉</span>{<span class="meta">〈<em class="metainner">target</em>〉</span>}{<a id="wrglossary.4822"></a><a href="#glo:glstextformat"><code class="csfmt">\glstextformat</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}}
+</pre> otherwise it’s encapsulated as: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4823"></a><a href="#glo:glstextformat"><code class="csfmt">\glstextformat</code></a>{<span class="meta">〈<em class="metainner">hyperlink-cs</em>〉</span>{<span class="meta">〈<em class="metainner">target</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}}
+</pre> where <span class="meta">〈<em class="metainner">hyperlink-cs</em>〉</span> is the command that generates the hyperlink (if enabled).<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.4824"></a><code class="code"><dfn id="glo:opt.glsopt.textformat"><span class="csoptfmt">textformat</span></dfn>=<span class="meta">〈<em class="metainner">csname</em>〉</span></code></div><!-- end of settingsbox -->
+ The value of this key should be the name of a control sequence (without the leading backslash). If this option is set, the given control sequence will be used instead of <a id="wrglossary.4825"></a><a href="#glo:glstextformat"><code class="csfmt">\glstextformat</code></a> to encapsulate the <a id="wrglossary.4826"></a><a href="#glo:dual.linktext">link text</a>. Note that this control sequence should take a single argument (the <a id="wrglossary.4827"></a><a href="#glo:dual.linktext">link text</a>). See §<a href="#sec:glstextformat">5.5.1</a> for further details.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+This option will override the <a id="wrglossary.4828"></a><a href="#glo:opt.catattr.textformat"><span class="csoptfmt">textformat</span></a> attribute. </div><!-- end of information -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.4829"></a><code class="code"><dfn id="glo:opt.glsopt.innertextformat"><span class="csoptfmt">innertextformat</span></dfn>=<span class="meta">〈<em class="metainner">csname</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>glsxtrdefaultentrytextfmt</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ The value of this key should be the name of a control sequence (without the leading backslash). The command <a id="wrglossary.4830"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a> (which shouldn’t be redefined) is assigned to this control sequence at the start of the <a id="wrglossary.4831"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.4832"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands. This command is used within the predefined abbreviation styles and within <a id="wrglossary.4833"></a><a href="#glo:glsgenentryfmt"><code class="csfmt">\glsgenentryfmt</code></a> to encapsulate the entry field values.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+Custom styles that don’t use <a id="wrglossary.4834"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a> won’t support this key. See §<a href="#sec:innertextformat">5.5.3</a> for further details. </div><!-- end of information -->
+<p>
+Some formatting commands require direct access to the actual text or else the content has to be placed inside a box (which inhibits line-breaking). These commands won’t work with <a id="wrglossary.4835"></a><a href="#glo:opt.glsopt.textformat"><span class="csoptfmt">textformat</span></a> as the text is usually too deeply embedded. This option provides a way of using those problematic commands, however there’s still no guarantee that they will work (for example, in the case of custom styles or where the field value itself contains commands).<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.4836"></a><code class="code"><dfn id="glo:opt.glsopt.postunset"><span class="csoptfmt">postunset</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>global; <span class="summarytag">initial: </span>global</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This option only applies to the <a id="wrglossary.4837"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands and indicates whether or not to unset the <a id="wrglossary.4838"></a><a href="#glo:dual.firstuseflag">first use flag</a> after the <a id="wrglossary.4839"></a><a href="#glo:dual.linktext">link text</a>. It may take one of three values: <span class="optfmt">global</span> (behaves like <a id="wrglossary.4840"></a><a href="#glo:opt.glsopt.local"><span class="csoptfmt">local</span></a><span class="optfmt">=false</span>), <span class="optfmt">local</span> (behaves like <a id="wrglossary.4841"></a><a href="#glo:opt.glsopt.local"><span class="csoptfmt">local</span></a><span class="optfmt">=true</span>) or <span class="optfmt">none</span> (doesn’t unset the <a id="wrglossary.4842"></a><a href="#glo:dual.firstuseflag">first use flag</a> after the <a id="wrglossary.4843"></a><a href="#glo:dual.firstuse">first use</a>). See §<a href="#sec:glsunset">5.10</a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.4844"></a><code class="code"><dfn id="glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>local; <span class="summarytag">initial: </span>none</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This option may take one of three values: <span class="optfmt">none</span> (no reset), <span class="optfmt">local</span> or <span class="optfmt">global</span>. This option (if not <span class="optfmt">none</span>) will reset the <a id="wrglossary.4845"></a><a href="#glo:dual.firstuseflag">first use flag</a> before the <a id="wrglossary.4846"></a><a href="#glo:dual.linktext">link text</a> and additionally change <a id="wrglossary.4847"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a> so that it indicates that this was the <a id="wrglossary.4848"></a><a href="#glo:dual.firstuse">first use</a> of the entry. See §<a href="#sec:glsunset">5.10</a>.<p>
+Note that this is different from using <a id="wrglossary.4849"></a><a href="#glo:glslocalreset"><code class="csfmt">\glslocalreset</code></a> or <a id="wrglossary.4850"></a><a href="#glo:glsreset"><code class="csfmt">\glsreset</code></a> before the <a id="wrglossary.4851"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands. Normally <a id="wrglossary.4852"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> and <a id="wrglossary.4853"></a><a href="#glo:glsplural"><code class="csfmt">\glsplural</code></a> will define <a id="wrglossary.4854"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a> so that it indicates that this was not the <a id="wrglossary.4855"></a><a href="#glo:dual.firstuse">first use</a> of the entry (regardless of whether or not the entry has actually been used).<p>
+For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4856"></a><a href="#glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></a>{general}{<a id="wrglossary.4857"></a><a href="#glo:glsxtrpostlinkAddDescOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddDescOnFirstUse</code></a>}
+<a id="wrglossary.4858"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.4859"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,
+ <a id="wrglossary.4860"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a><span class="optfmt">={sample first use}</span>,<a id="wrglossary.4861"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+<code class="cbeg">\begin{document}</code>
+Text field: <a id="wrglossary.4862"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>{sample}.
+
+First use: <a id="wrglossary.4863"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}. Next use: <a id="wrglossary.4864"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}.
+
+Force reset: <a id="wrglossary.4865"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[prereset]{sample}.
+Used? <a id="wrglossary.4866"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{sample}{Yes}{No}.
+
+Force reset: <a id="wrglossary.4867"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>[prereset]{sample}.
+Used? <a id="wrglossary.4868"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{sample}{Yes}{No}.
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:prereset"></a>Example 90: Illustrating the <span class="optfmt">prereset</span> option <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example090.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example090.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example090.png" type="image/png" width="304" height="56">Example document illustrating the use of the prereset option.</object> </div><!-- end of resultbox -->
+ Note that <a id="wrglossary.4869"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> unsets the <a id="wrglossary.4870"></a><a href="#glo:dual.firstuseflag">first use flag</a> (unless <a id="wrglossary.4871"></a><a href="#glo:opt.glsopt.postunset"><span class="csoptfmt">postunset</span></a><span class="optfmt">=none</span>), so the sample entry is marked as used afterwards, but <a id="wrglossary.4872"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> doesn’t alter the <a id="wrglossary.4873"></a><a href="#glo:dual.firstuseflag">first use flag</a>, after the <a id="wrglossary.4874"></a><a href="#glo:dual.linktext">link text</a> so the sample entry is still marked as unused afterwards.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.4875"></a><code class="code"><dfn id="glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>local; <span class="summarytag">initial: </span>none</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This option may take one of three values: <span class="optfmt">none</span> (no unset), <span class="optfmt">local</span> or <span class="optfmt">global</span>. This option (if not <span class="optfmt">none</span>) will unset the <a id="wrglossary.4876"></a><a href="#glo:dual.firstuseflag">first use flag</a> before the <a id="wrglossary.4877"></a><a href="#glo:dual.linktext">link text</a> and additionally change <a id="wrglossary.4878"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a> so that it indicates that this wasn’t the <a id="wrglossary.4879"></a><a href="#glo:dual.firstuse">first use</a> of the entry. See §<a href="#sec:glsunset">5.10</a>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+The <a id="wrglossary.4880"></a><a href="#glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></a> key is always performed after the <a id="wrglossary.4881"></a><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a> key. </div><!-- end of information -->
+<p>
+Note the effect of using a global reset but a local unset in the example below. Both options are performed, but the unset locally overrides the global reset. <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4882"></a><a href="#glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></a>{general}{<a id="wrglossary.4883"></a><a href="#glo:glsxtrpostlinkAddDescOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddDescOnFirstUse</code></a>}
+<a id="wrglossary.4884"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.4885"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,
+ <a id="wrglossary.4886"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a><span class="optfmt">={sample first use}</span>,<a id="wrglossary.4887"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.4888"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}. Used? <a id="wrglossary.4889"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{sample}{Yes}{No}.
+
+{<a id="wrglossary.4890"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a>[preunset=local,prereset=global]{sample}.
+Used? <a id="wrglossary.4891"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{sample}{Yes}{No}.
}
-</pre>
-<!--l. 8345--><p class="nopar" >
-</p><!--l. 8347--><p class="indent" > The remaining problem is how to deal with the possibility that <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mgls{shtml}</span></span></span>
-may come before the <a
- id="dx1-45005"></a><a
-href="#glo:firstuse">first use</a> of the other elements. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-195">
-Multi-entry&#x00A0;first&#x00A0;use:&#x00A0;\mgls{shtml}.
-Individual&#x00A0;elements:&#x00A0;\gls{ssi}&#x00A0;and&#x00A0;\gls{html}.
-</pre>
-<!--l. 8354--><p class="nopar" > This leads to:
- </p><blockquote class="quote">
- <!--l. 8357--><p class="noindent" >Multi-entry first use: server-side includes enabled hypertext markup
- language (<span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>).
- </p><!--l. 8360--><p class="noindent" >Individual elements: <span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">s</span><span
-class="small-caps">i</span> </span>and <span
-class="cmcsc-10"><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>.</p></blockquote>
-<!--l. 8362--><p class="noindent" >This means that the abbreviations <span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">s</span><span
-class="small-caps">i</span> </span>and <span
-class="cmcsc-10"><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span> </span>aren&#8217;t explained in the document text.
-One way around this is to only locally unset the other element <a
- id="dx1-45006"></a><a
-href="#glo:firstuseflag">first use
-flags</a>:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-196">
-\glssetcategoryattribute{combinedabbrv}{multioptions}
-&#x00A0;{%
-&#x00A0;&#x00A0;hyper=notmainfirst,
-&#x00A0;&#x00A0;mpostlinkelement=main,
-&#x00A0;&#x00A0;usedskipothers,
-&#x00A0;&#x00A0;mglsopts={others={local}}
-&#x00A0;}
-</pre>
-<!--l. 8373--><p class="nopar" > With the above setting, the following:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-197">
-\glsresetall\mglsresetall
-Multi-entry&#x00A0;first&#x00A0;use:&#x00A0;\mgls{shtml}.
-Multi-entry&#x00A0;next&#x00A0;use:&#x00A0;\mgls{shtml}.
-Individual&#x00A0;elements:&#x00A0;\gls{ssi}&#x00A0;and&#x00A0;\gls{html}.
-</pre>
-<!--l. 8383--><p class="nopar" > will now produce:
- </p><blockquote class="quote">
- <!--l. 8386--><p class="noindent" >Multi-entry first use: server-side includes enabled hypertext markup
- language (<span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>).
- </p><!--l. 8389--><p class="noindent" >Multi-entry next use: <span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>.
- </p><!--l. 8391--><p class="noindent" >Individual elements: server-side includes (<span
-class="cmcsc-10"><span
-class="small-caps">s</span><span
-class="small-caps">s</span><span
-class="small-caps">i</span></span>) and hypertext markup
- language (<span
-class="cmcsc-10"><span
-class="small-caps">h</span><span
-class="small-caps">t</span><span
-class="small-caps">m</span><span
-class="small-caps">l</span></span>).</p></blockquote>
-<!--l. 8395--><p class="noindent" >
-</p>
-<!--l. 8395--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6.2 </span> <a
- id="sec:mglsmain"></a>Main and Other Elements</h3>
-<!--l. 8398--><p class="noindent" >The list of labels provided in the final argument of <span
-class="cmtt-10">\multiglossaryentry</span>
-consists of a main element and all the other elements. If the main element isn&#8217;t
-identified in the optional argument, it&#8217;s assumed to be the final element in the
-list.
-</p><!--l. 8403--><p class="indent" > The main element allows you to determine which target to use if you want the
-entire content of <span
-class="cmtt-10">\mgls </span>to be a single hyperlink. You can also use the settings
-described in <a
-href="#sec:multiglsoptions"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.9</span> </a><a
-href="#sec:multiglsoptions">Multi-Entry Settings<!--tex4ht:ref: sec:multiglsoptions --></a> to only index the main
-element.
-</p><!--l. 8408--><p class="indent" > You can change the main element using:
-</p><!--l. 8409--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-46001"></a> <span
-class="cmtt-10">\mglsSetMain{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">new-main-label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 8411--><p class="noindent" >
-The new main label provided in the second argument must be in the list
-corresponding to &#x27E8;<span
-class="cmti-10">multi-label</span>&#x27E9;. This change is locally applied to the current scope.
-Note that if you are using <a
- id="dx1-46002"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a>, this change in the document can&#8217;t be
-detected.
-</p><!--l. 8417--><p class="indent" > The main element can also be used to identify which element should be displayed
-in the plural with <span
-class="cmtt-10">\mglsmainpl</span>. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-198">
-\newglossaryentry{great}{name={great},description={}}
-\newglossaryentry{little}{name={little},description={}}
-\newglossaryentry{grebe}{name={grebe},description={}}
-\multiglossaryentry{greatgrebe}{great,grebe}
-\multiglossaryentry{littlegrebe}{little,grebe}
-</pre>
-<!--l. 8426--><p class="nopar" > In the above, two multi-entries are defined: <span
-class="cmtt-10">greatgrebe </span>and <span
-class="cmtt-10">littlegrebe</span>. In both
-cases the main element is <span
-class="cmtt-10">grebe </span>(the last element). Using <span
-class="cmtt-10">\mglspl </span>will show the
-plural for all elements, but using <span
-class="cmtt-10">\mglsmainpl </span>will only use the plural for the main
-element (grebe). For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-199">
-Plural&#x00A0;all:&#x00A0;\mglspl{greatgrebe},&#x00A0;\mglspl{littlegrebe}.
-Plural&#x00A0;main:&#x00A0;\mglsmainpl{greatgrebe},&#x00A0;\mglsmainpl{littlegrebe}.
-</pre>
-<!--l. 8435--><p class="nopar" > produces: <spacer type=vertical size=10><span class="obeylines-h">
- <br />Plural all: greats grebes, littles grebes.
- <br />Plural main: great grebes, little grebes.
- <br /><spacer type=vertical size=10></span>
-</p><!--l. 8442--><p class="noindent" >
-</p>
-<!--l. 8442--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6.3 </span> <a
- id="sec:mglsfixes"></a>Prefixes and Suffixes</h3>
-<!--l. 8445--><p class="noindent" >A multi-entry may have associated prefixes and suffixes. These are scoped and are
-placed outside of the hyperlinks and encapsulating commands. They are not affected
-by case-changing commands, such as <span
-class="cmtt-10">\Mgls</span>. If you want a prefix to obey
-case-changing, use the <span
-class="cmtt-10">\mpgls</span>-like commands instead (<a
-href="#sec:mpgls"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.11.4</span> </a><a
-href="#sec:mpgls">Support for
-glossaries-prefix (pgls)<!--tex4ht:ref: sec:mpgls --></a>).
-</p><!--l. 8452--><p class="indent" > The prefix is inserted with:
-</p><!--l. 8453--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-47001"></a> <span
-class="cmtt-10">\mglsprefix </span></div><hr>
-</p><!--l. 8455--><p class="noindent" >
-The default definition is:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-200">
-\newcommand*{\mglsprefix}{%
-&#x00A0;\ifdefempty\mglscurrentcategory
-&#x00A0;{\mglscurrentprefix}%
-&#x00A0;{%
-&#x00A0;&#x00A0;&#x00A0;\mglshascategoryprefix{\mglscurrentcategory}%
-&#x00A0;&#x00A0;&#x00A0;{\mglsusecategoryprefix{\mglscurrentcategory}}%
-&#x00A0;&#x00A0;&#x00A0;{\mglscurrentprefix}%
-&#x00A0;}%
+
+Used? <a id="wrglossary.4892"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{sample}{Yes}{No}.
+
+{<a id="wrglossary.4893"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[preunset=local,prereset=global]{sample}.
+Used? <a id="wrglossary.4894"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{sample}{Yes}{No}.
}
-</pre>
-<!--l. 8467--><p class="nopar" > This will insert the current prefix unless there is prefix command associated with the
-current category.
-</p><!--l. 8471--><p class="indent" > The suffix is inserted with:
-</p><!--l. 8472--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-47002"></a> <span
-class="cmtt-10">\mglssuffix </span></div><hr>
-</p><!--l. 8474--><p class="noindent" >
-The command is defined as follows:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-201">
-\newcommand*{\mglssuffix}{%
-&#x00A0;\ifdefempty\mglscurrentcategory
-&#x00A0;{\ifdefempty{\mglscurrentsuffix}{}{\space(\mglscurrentsuffix)}}%
-&#x00A0;{%
-&#x00A0;&#x00A0;&#x00A0;\mglshascategorysuffix{\mglscurrentcategory}%
-&#x00A0;&#x00A0;&#x00A0;{\mglsusecategorysuffix{\mglscurrentcategory}}%
-&#x00A0;&#x00A0;&#x00A0;{\ifdefempty{\mglscurrentsuffix}{}{\space(\mglscurrentsuffix)}}%
-&#x00A0;}%
+
+Used? <a id="wrglossary.4895"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{sample}{Yes}{No}.
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:preresetpreunset"></a>Example 91: Combining <span class="optfmt">prereset</span> and <span class="optfmt">preunset</span> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example091.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example091.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example091.png" type="image/png" width="216" height="68">Example document illustrating the use of the prereset and preunset options.</object> </div><!-- end of resultbox -->
+ Remember that <a id="wrglossary.4896"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> globally unsets the <a id="wrglossary.4897"></a><a href="#glo:dual.firstuseflag">first use flag</a> (unless changed with <a id="wrglossary.4898"></a><a href="#glo:opt.glsopt.postunset"><span class="csoptfmt">postunset</span></a>), which counteracts <a id="wrglossary.4899"></a><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a><span class="optfmt">=global</span>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.4900"></a><code class="code"><dfn id="glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This is a boolean option that determines whether or not to suppress the normal <a id="wrglossary.4901"></a><a href="#glo:dual.indexing">indexing</a>. For example, to prevent any <a id="wrglossary.4902"></a><a href="#glo:@@glslabel@entrylocation">locations</a> in the front matter or back matter appearing in the glossary: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4903"></a><a href="#glo:frontmatter"><code class="csfmt">\frontmatter</code></a>
+<a id="wrglossary.4904"></a><a href="#glo:GlsXtrSetDefaultGlsOpts"><code class="csfmt">\GlsXtrSetDefaultGlsOpts</code></a>{<a id="wrglossary.4905"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a>}
+…<a id="wrglossary.4906"></a><a href="#glo:mainmatter"><code class="csfmt">\mainmatter</code></a>
+<a id="wrglossary.4907"></a><a href="#glo:GlsXtrSetDefaultGlsOpts"><code class="csfmt">\GlsXtrSetDefaultGlsOpts</code></a>{<a id="wrglossary.4908"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a><span class="optfmt">=false</span>}
+…<a id="wrglossary.4909"></a><a href="#glo:backmatter"><code class="csfmt">\backmatter</code></a>
+<a id="wrglossary.4910"></a><a href="#glo:GlsXtrSetDefaultGlsOpts"><code class="csfmt">\GlsXtrSetDefaultGlsOpts</code></a>{<a id="wrglossary.4911"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a>}
+</pre> Note that if you are using auto-indexing (see §<a href="#sec:autoindex">12</a>), <a id="wrglossary.4912"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a><span class="optfmt">=false</span> will also suppress the auto-indexing.<p>
+If you are using <a id="wrglossary.4913"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, you may want to consider instead using <a id="wrglossary.4914"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=glsignore</span> to create an ignored <a id="wrglossary.4915"></a><a href="#glo:@@glslabel@entrylocation">location</a> that ensures the entry is selected without adding a <a id="wrglossary.4916"></a><a href="#glo:@@glslabel@entrylocation">location</a> to the <a id="wrglossary.4917"></a><a href="#glo:dual.locationlist">location list</a>. (Don’t use this method for the other <a id="wrglossary.4918"></a><a href="#glo:dual.indexing">indexing</a> methods as you’ll end up with invisible <a id="wrglossary.4919"></a><a href="#glo:@@glslabel@entrylocation">locations</a> with spurious commas in your <a id="wrglossary.4920"></a><a href="#glo:dual.locationlist">location lists</a>.)<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.4921"></a><code class="code"><dfn id="glo:opt.glsopt.wrgloss"><span class="csoptfmt">wrgloss</span></dfn>=<span class="meta">〈<em class="metainner">position</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>before</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This option may take one of two values, <span class="optfmt">before</span> or <span class="optfmt">after</span>, which indicate whether the <a id="wrglossary.4922"></a><a href="#glo:dual.indexing">indexing</a> should occur before or after the <a id="wrglossary.4923"></a><a href="#glo:dual.linktext">link text</a>. The <a id="wrglossary.4924"></a><a href="#glo:dual.indexing">indexing</a> creates a <a id="wrglossary.4925"></a><a href="#glo:dual.whatsit">whatsit</a> that can interfere with spacing or cause other problems. The other thing to consider is where the <a id="wrglossary.4926"></a><a href="#glo:dual.linktext">link text</a> is long, such as a phrase or full form of an abbreviation, that may be split by a page break. You will need to decide if you want the <a id="wrglossary.4927"></a><a href="#glo:dual.indexing">indexing</a> before the <a id="wrglossary.4928"></a><a href="#glo:dual.linktext">link text</a>, so that the <a id="wrglossary.4929"></a><a href="#glo:@@glslabel@entrylocation">location</a> is at the end of the page where the text starts, or if you want the <a id="wrglossary.4930"></a><a href="#glo:dual.indexing">indexing</a> after the <a id="wrglossary.4931"></a><a href="#glo:dual.linktext">link text</a>, so that the <a id="wrglossary.4932"></a><a href="#glo:@@glslabel@entrylocation">location</a> is at the start of the next page where the text ends.<p>
+This option corresponds to a conditional: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4933"></a><code class="code"><dfn id="glo:ifglsxtrinitwrglossbefore"><code class="csfmt">\ifglsxtrinitwrglossbefore</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\iftrue</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ The hook <a id="wrglossary.4934"></a><a href="#glo:glsxtrinitwrgloss"><code class="csfmt">\glsxtrinitwrgloss</code></a> sets this conditional according to whether or not the <a id="wrglossary.4935"></a><a href="#glo:opt.catattr.wrgloss"><span class="csoptfmt">wrgloss</span></a> attribute has been set to <code class="code">after</code>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.4936"></a><a href="#glo:glsxtrinitwrgloss"><code class="csfmt">\glsxtrinitwrgloss</code></a>}{<span class="comment">% </span>
+ <a id="wrglossary.4937"></a><a href="#glo:glsifattribute"><code class="csfmt">\glsifattribute</code></a>{<a id="wrglossary.4938"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}{wrgloss}{after}<span class="comment">% </span>
+ {<a id="wrglossary.4939"></a><a href="#glo:glsxtrinitwrglossbeforefalse"><code class="csfmt">\glsxtrinitwrglossbeforefalse</code></a>}<span class="comment">% </span>
+ {<a id="wrglossary.4940"></a><a href="#glo:glsxtrinitwrglossbeforetrue"><code class="csfmt">\glsxtrinitwrglossbeforetrue</code></a>}<span class="comment">% </span>
}
-</pre>
-<!--l. 8486--><p class="nopar" > If there is a suffix associated with the current category, that will be used, otherwise
-if the current suffix isn&#8217;t empty this inserts a space followed by the current suffix in
-parentheses. You can access the label of the last (non-skipped) element with
-<span
-class="cmtt-10">\mglslastelementlabel</span><a
- id="dx1-47003"></a>.
-</p><!--l. 8493--><p class="indent" > Note that in both cases the category corresponds to the multi-entry category (see
-<a
-href="#sec:multiglscategory"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.8</span> </a><a
-href="#sec:multiglscategory">Multi-Entry Category<!--tex4ht:ref: sec:multiglscategory --></a>).
-</p><!--l. 8496--><p class="indent" > To define a category-dependent prefix, use:
-</p><!--l. 8497--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-47004"></a> <span
-class="cmtt-10">\mglsdefcategoryprefix{</span>&#x27E8;<span
-class="cmitt-10">category</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">definition</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 8499--><p class="noindent" >
-You can reference the current prefix with <span
-class="cmtt-10">\mglscurrentprefix</span>.
-</p><!--l. 8502--><p class="indent" > To define a category-dependent suffix, use:
-</p><!--l. 8503--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-47005"></a> <span
-class="cmtt-10">\mglsdefcategorysuffix{</span>&#x27E8;<span
-class="cmitt-10">category</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">definition</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 8505--><p class="noindent" >
-You can reference the current suffix with <span
-class="cmtt-10">\mglscurrentsuffix</span>.
-</p><!--l. 8508--><p class="indent" > The default definition of <span
-class="cmtt-10">\mglsprefix </span>tests if there is a category prefix
-using:
-</p><!--l. 8510--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-47006"></a> <span
-class="cmtt-10">\glshascategoryprefix{</span>&#x27E8;<span
-class="cmitt-10">category</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 8512--><p class="noindent" >
-The category prefix is used with:
-</p><!--l. 8514--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-47007"></a> <span
-class="cmtt-10">\glsusecategoryprefix{</span>&#x27E8;<span
-class="cmitt-10">category</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 8516--><p class="noindent" >
-</p><!--l. 8518--><p class="indent" > The default definition of <span
-class="cmtt-10">\mglssuffix </span>tests if there is a category suffix
-using:
-</p><!--l. 8520--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-47008"></a> <span
-class="cmtt-10">\glshascategorysuffix{</span>&#x27E8;<span
-class="cmitt-10">category</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 8522--><p class="noindent" >
-The category suffix is used with:
-</p><!--l. 8524--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-47009"></a> <span
-class="cmtt-10">\glsusecategorysuffix{</span>&#x27E8;<span
-class="cmitt-10">category</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 8526--><p class="noindent" >
-</p><!--l. 8528--><p class="indent" > The current prefix <span
-class="cmtt-10">\mglscurrentprefix </span>and <span
-class="cmtt-10">\mglscurrentsuffix </span>are obtained
-as follows: </p>
-
-
-
- <ul class="itemize1">
- <li class="itemize">if this is the first use of the multi-entry (<a
-href="#sec:mglsfirstuse"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.7</span> </a><a
-href="#sec:mglsfirstuse">Multi-Entry
- First Use<!--tex4ht:ref: sec:mglsfirstuse --></a>) then the &#x27E8;<span
-class="cmti-10">prefix</span>&#x27E9; is set to the value of the <span
-class="cmss-10">firstprefix </span>option and
- the &#x27E8;<span
-class="cmti-10">suffix</span>&#x27E9; is set to the value of the <span
-class="cmss-10">firstsuffix </span>option;
- </li>
- <li class="itemize">otherwise the &#x27E8;<span
-class="cmti-10">prefix</span>&#x27E9; is set to the value of the <span
-class="cmss-10">usedprefix </span>option and the
- &#x27E8;<span
-class="cmti-10">suffix</span>&#x27E9; is set to the value of the <span
-class="cmss-10">usedsuffix </span>option.</li></ul>
-<!--l. 8540--><p class="indent" > <div class="important" title="Important Note"> The prefix and suffix (if set) are placed outside of the hyperlink and text
-formatting encapsulator. They are not affected by case-changing commands such as
-<span
-class="cmtt-10">\Mgls </span>or <span
-class="cmtt-10">\MGLS</span>. </div>
-</p><!--l. 8544--><p class="noindent" >
-</p><!--l. 8546--><p class="indent" > For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-202">
-\setabbreviationstyle{long-only-short-only}
-\newabbreviation{clostridium}{C.}{Clostridium}
-\newglossaryentry{botulinum}{name=botulinum,description={}}
-\multiglossaryentry[firstsuffix=botulism]
-&#x00A0;{cbot}{clostridium,botulinum}
-</pre>
-<!--l. 8554--><p class="nopar" > On first use, this produces (assuming the &#8220;clostridum&#8221; element hasn&#8217;t been used
-previously):
- </p><blockquote class="quote">
- <!--l. 8558--><p class="noindent" >Clostridium botulinum (botulism).</p></blockquote>
-<!--l. 8560--><p class="noindent" >On subsequent use, this produces:
- </p><blockquote class="quote">
- <!--l. 8562--><p class="noindent" >C. botulinum.</p></blockquote>
-<!--l. 8565--><p class="noindent" >
-</p>
-<!--l. 8565--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6.4 </span> <a
- id="sec:mglssep"></a>Separators</h3>
-<!--l. 8568--><p class="noindent" >The separators between each instance of <span
-class="cmtt-10">\gls </span>are given by the following
-commands, which all take two arguments. The first argument is the label of
-the previous element. The second argument is the label of the following
-element.
-</p><!--l. 8572--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-48001"></a> <span
-class="cmtt-10">\glscombinedsep{</span>&#x27E8;<span
-class="cmitt-10">prev label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">next label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 8574--><p class="noindent" >
-This is inserted between two entries that have both been marked as used. The default
-definition is:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-203">
-\newcommand*{\glscombinedsep}[2]{%
-&#x00A0;&#x00A0;\glshasattribute{#1}{combinedsep}%
-&#x00A0;&#x00A0;{\glsgetattribute{#1}{combinedsep}}%
-&#x00A0;&#x00A0;{&#x00A0;}%
+</pre><p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.4941"></a><code class="code"><dfn id="glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></dfn>=<span class="meta">〈<em class="metainner">location</em>〉</span></code></div><!-- end of settingsbox -->
+ Sets the <a id="wrglossary.4942"></a><a href="#glo:dual.entrylocation">entry location</a> to the given value instead of obtaining it from the <a id="wrglossary.4943"></a><a href="#glo:dual.locationcounter">location counter</a>. If you are using <a id="wrglossary.4944"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> you may also need to set the location’s hypertarget with <a id="wrglossary.4945"></a><a href="#glo:opt.glsopt.theHvalue"><span class="csoptfmt">theHvalue</span></a>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+This option is primarily intended for use with <a id="wrglossary.4946"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to supply <a id="wrglossary.4947"></a><a href="#glo:@@glslabel@entrylocation">locations</a> that don’t have an associated counter within the document, such as an external location. If you want to automatically add locations from a supplemental document to an entry’s <a id="wrglossary.4948"></a><a href="#glo:dual.locationlist">location list</a>, you can use the <a id="wrglossary.4949"></a><a href="#glo:opt.resource.supplemental-locations"><span class="csoptfmt">supplemental-locations</span></a> resource option. See the <a id="wrglossary.4950"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for further details. </div><!-- end of information -->
+<p>
+For example, to <a id="wrglossary.4951"></a><a href="#glo:@@glslabel@indexing">index</a> a <a id="wrglossary.4952"></a><a href="#glo:@@glslabel@entrylocation">location</a> in a supplementary document: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4953"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>[<a id="wrglossary.4954"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a><span class="optfmt">={Suppl.<code class="cmd">\ </code>2.45}</span>]{sample}
+</pre> This will add <span class="qt">“Suppl. 2.45”</span> to the <a id="wrglossary.4955"></a><a href="#glo:dual.locationlist">location list</a> for the <span class="qt">“sample”</span> entry.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Note that the value must conform to the <a id="wrglossary.4956"></a><a href="#glo:dual.indexingapp">indexing application’s</a> location syntax. For <a id="wrglossary.4957"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, this is limited to <code class="code">Roman</code>, <code class="code">roman</code>, <code class="code">arabic</code>, <code class="code">alph</code> and <code class="code">Alph</code>. With <a id="wrglossary.4958"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, the location syntax must be defined in the <a id="wrglossary.4959"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> module (standard location syntaxes are supplied by default). There’s no restriction on the location syntax for <a id="wrglossary.4960"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, although if it can’t deduce a numerical value it won’t be able to form a range. </div><!-- end of important -->
+<p>
+If you want a hyperlink to an external file, you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.4961"></a><code class="code"><dfn id="glo:glsxtrsupphypernumber"><code class="csfmt">\glsxtrsupphypernumber</code></dfn>{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ as the formatting command for the <a id="wrglossary.4962"></a><a href="#glo:dual.locationencap">location encap</a>. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4963"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>[<a id="wrglossary.4964"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a><span class="optfmt">=S.2</span>,<a id="wrglossary.4965"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=glsxtrsupphypernumber</span>]{sample}
+</pre> The path to the external file needs to be set in the <a id="wrglossary.4966"></a><a href="#glo:opt.catattr.externallocation"><span class="csoptfmt">externallocation</span></a> category attribute.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+The hyperlink for the supplementary location may or <span style="font-style: italic; font-variant: normal; ">may not</span> take you to the relevant place in the external PDF file <span style="font-style: italic; font-variant: normal; ">depending on your PDF viewer</span>. Some may not support external links, and some may take you to the first page or last visited page. </div><!-- end of information -->
+<p>
+For example, if both <span class="filefmt">sample-suppl-hyp.pdf</span> and <span class="filefmt">sample-suppl-main-hyp.pdf</span> are in the same directory, then viewing <span class="filefmt">sample-suppl-main-hyp.pdf</span> in Evince will take you to the correct location in the linked document (when you click on the S.2 external link), but Okular will take you to the top of the first page of the linked document.<p>
+This method can only be used where there is one external source for the designated category (identified by the <a id="wrglossary.4967"></a><a href="#glo:opt.catattr.externallocation"><span class="csoptfmt">externallocation</span></a> attribute). For multiple sources, you need to use <a id="wrglossary.4968"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v1.7+, which is the better method in general as it can automatically fetch the relevant locations from the <a id="wrglossary.4969"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> files of the designated external documents without the need to explicitly use <a id="wrglossary.4970"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.4971"></a><code class="code"><dfn id="glo:opt.glsopt.theHvalue"><span class="csoptfmt">theHvalue</span></dfn>=<span class="meta">〈<em class="metainner">the-H-value</em>〉</span></code></div><!-- end of settingsbox -->
+ Sets the hypertarget corresponding to the <a id="wrglossary.4972"></a><a href="#glo:@@glslabel@entrylocation">location</a>, which will be used if the <a id="wrglossary.4973"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a> supports hyperlinks. This is analogous to <a id="wrglossary.4974"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span>’s</a> <a id="wrglossary.4975"></a><a href="#glo:theHcounter"><code class="csfmt">\the<span class="meta">〈<em class="metainner">counter-name</em>〉</span></code></a> that provides the hypertarget for a reference to <a id="wrglossary.4976"></a><a href="#glo:thecounter"><code class="csfmt">\the<span class="meta">〈<em class="metainner">counter-name</em>〉</span></code></a>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+This option is primarily intended for use with the <a id="wrglossary.4977"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a> option. </div><!-- end of information -->
+<p>
+Unless you are using <a id="wrglossary.4978"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.4979"></a><a href="#glo:optval.record.nameref"><span class="optfmt">nameref</span></a>, you must ensure that it’s possible to form <span class="meta">〈<em class="metainner">the-H-value</em>〉</span> from <span class="meta">〈<em class="metainner">h-prefix</em>〉</span><span class="meta">〈<em class="metainner">thevalue</em>〉</span> for some <span class="meta">〈<em class="metainner">h-prefix</em>〉</span> (where <span class="meta">〈<em class="metainner">thevalue</em>〉</span> is given by <a id="wrglossary.4980"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a> or the value of the <a id="wrglossary.4981"></a><a href="#glo:@@glslabel@entrylocation">location</a> counter). This restriction is due to the limitations imposed by <a id="wrglossary.4982"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.4983"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.4984"></a><code class="code"><dfn id="glo:opt.glsopt.prefix"><span class="csoptfmt">prefix</span></dfn>=<span class="meta">〈<em class="metainner">link-prefix</em>〉</span></code></div><!-- end of settingsbox -->
+ This option locally redefines <a id="wrglossary.4985"></a><a href="#glo:glolinkprefix"><code class="csfmt">\glolinkprefix</code></a> to <span class="meta">〈<em class="metainner">link-prefix</em>〉</span>. If you are using <a id="wrglossary.4986"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> to redisplay a list (possibly in a different order) then you will need some way of changing the entry targets to avoid duplicate hyperlink targets. One way of achieving this is to redefine <a id="wrglossary.4987"></a><a href="#glo:glolinkprefix"><code class="csfmt">\glolinkprefix</code></a> for the subsequent lists. You will then need to use the <a id="wrglossary.4988"></a><a href="#glo:opt.glsopt.prefix"><span class="csoptfmt">prefix</span></a> option in commands like <a id="wrglossary.4989"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> to ensure that the hyperlink for the <a id="wrglossary.4990"></a><a href="#glo:dual.linktext">link text</a> points to the desired list.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+This option is intended for use with the <a id="wrglossary.4991"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> and <a id="wrglossary.4992"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a> (which is used by <a id="wrglossary.4993"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>). The other <a id="wrglossary.4994"></a><a href="#glo:dual.indexing">indexing</a> methods don’t support repeated lists. </div><!-- end of information -->
+ <a id="wrglossary.4995"></a><p>
+
+</section><!-- end of section sec:xtrglsopts -->
+
+<section id="sec:casechange"><!-- start of section sec:casechange --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->5.2. Case Changing<div class="labellink"><a href="#sec:casechange">[link]</a></div></h2><!-- end of section header -->
+<p>
+Case-changing commands, such as <a id="wrglossary.4996"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> and <a id="wrglossary.4997"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a>, perform the conversion using commands provided by <a id="wrglossary.4998"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>. The underlying commands provided by <a id="wrglossary.4999"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> were redesigned in v2.08 to use the newer, better case-changing commands available with the LaTeX3 kernel. The base <a id="wrglossary.5000"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package v4.50 and <a id="wrglossary.5001"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49 were developed concurrently with <a id="wrglossary.5002"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08 to take advantage of the new features. Version 1.49 of <a id="wrglossary.5003"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> was also developed concurrently with <a id="wrglossary.5004"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v3.0 which, in turn, was developed alongside version 0.9.2.7b of the TeX parser library.<p>
+It’s not possible to upload all these new versions at the same time, so it will be necessary to stagger their deployment. The new case-changing features will work best when all these new versions are installed. In the interim, a reduced feature set will be used.<p>
+
+</section><!-- end of section sec:casechange -->
+
+<section id="sec:firstuc"><!-- start of section sec:firstuc --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->5.2.1. Sentence Case Commands<div class="labellink"><a href="#sec:firstuc">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+Both the base <a id="wrglossary.5005"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package and the <a id="wrglossary.5006"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provide <a id="wrglossary.5007"></a><a href="#glo:idx.sentencecase">sentence case</a> commands, which convert the first letter to <a id="wrglossary.5008"></a><a href="#glo:idx.uppercase">uppercase</a>. These are provided for situations where an entry is referenced at the start of a sentence. Sentence-casing is also implemented when the attributes <a id="wrglossary.5009"></a><a href="#glo:opt.catattr.glossname"><span class="csoptfmt">glossname</span></a> or <a id="wrglossary.5010"></a><a href="#glo:opt.catattr.glossdesc"><span class="csoptfmt">glossdesc</span></a> are set to <code class="code">firstuc</code>.<p>
+The case conversion is performed using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5011"></a><code class="code"><dfn id="glo:glssentencecase"><code class="csfmt">\glssentencecase</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The default definition uses <a id="wrglossary.5012"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>, which is provided by the <a id="wrglossary.5013"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> package. This was originally part of the base <a id="wrglossary.5014"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, but was split into a separately distributed package in 2015. Back then, there was no expandable sentence-case command. There was also a problem with referencing entries where <a id="wrglossary.5015"></a><a href="#glo:dual.linktext">link text</a> was encapsulated with a text-block command (which occurs, in particular, with acronym and abbreviation styles). The first letter of the text-block command’s argument needed to be obtained, which resulted in some trickery that proved problematic with <a id="wrglossary.5016"></a><a href="#glo:dual.utf8">UTF-8</a>.<p>
+The LaTeX3 kernel now provides a suitable expandable command that works with <a id="wrglossary.5017"></a><a href="#glo:dual.utf8">UTF-8</a>, and <a id="wrglossary.5018"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+ provides <a id="wrglossary.5019"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> that directly interfaces with it. If an older version of <a id="wrglossary.5020"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> is installed, <a id="wrglossary.5021"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ and <a id="wrglossary.5022"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+ will provide <a id="wrglossary.5023"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>. You can use this in expandable contents. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\section</code>{<a id="wrglossary.5024"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.5025"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a>{label}}}
+</pre> However, in the above example, it’s simpler to do: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\section</code>{<a id="wrglossary.5026"></a><a href="#glo:Glsfmttext"><code class="csfmt">\Glsfmttext</code></a>{label}}
+</pre> If <a id="wrglossary.5027"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> has been loaded, <code class="code"><a id="wrglossary.5028"></a><a href="#glo:Glsfmttext"><code class="csfmt">\Glsfmttext</code></a>{label}</code> will now expand to: <pre class="compactcodebox"><a id="wrglossary.5029"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.5030"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a>{label}}
+</pre> in the PDF bookmark.<p>
+Internally, <a id="wrglossary.5031"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> now uses <a id="wrglossary.5032"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> to perform the case conversion, but it still parses its argument to determine if it starts with <code class="code"><span class="meta">〈<em class="metainner">cs</em>〉</span>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code>. This means that with <a id="wrglossary.5033"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+, you now don’t have to worry about <a id="wrglossary.5034"></a><a href="#glo:dual.utf8">UTF-8</a> characters occurring at the start of the text.<p>
+For example, with <a id="wrglossary.5035"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.07 you would need to do something like: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.5036"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elite}{<a id="wrglossary.5037"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={{é}lite}</span>,
+ <a id="wrglossary.5038"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={...}</span>}
+</pre> in order for <code class="code"><a id="wrglossary.5039"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{elite}</code> to work. Whereas with <a id="wrglossary.5040"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08, you can now simply do: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.5041"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elite}{<a id="wrglossary.5042"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={élite}</span>,
+ <a id="wrglossary.5043"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={...}</span>}
+</pre> (As from <a id="wrglossary.5044"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.47, it should be possible to use <a id="wrglossary.5045"></a><a href="#glo:dual.utf8">UTF-8</a> characters in the label as well.)<p>
+Whilst you can redefine <a id="wrglossary.5046"></a><a href="#glo:glssentencecase"><code class="csfmt">\glssentencecase</code></a> to use <a id="wrglossary.5047"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> directly (without using <a id="wrglossary.5048"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> as an intermediary), this may result in content being expanded that wouldn’t have been expanded previously. In particularly, if <span class="meta">〈<em class="metainner">cs</em>〉</span> isn’t robust and expands to content that includes labels then the case-change can fail. You also won’t be able to take advantage of the blockers and mappings that are only recognised as such by <a id="wrglossary.5049"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. If you use <a id="wrglossary.5050"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> instead, blockers and mappings will be treated as exclusions, which are likely to result in unwanted side-effects.<p>
+Both <a id="wrglossary.5051"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> and <a id="wrglossary.5052"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> recognise exclusions. These are text-block commands which take a single mandatory argument that needs to be skipped. For example, in the following <code class="code"><a id="wrglossary.5053"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>{example}</code> needs to be skipped: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.5054"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.5055"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>{example}some text}
+</pre> Exclusions are identified with <a id="wrglossary.5056"></a><a href="#glo:MFUexcl"><code class="csfmt">\MFUexcl</code></a>. If you have an older version of <a id="wrglossary.5057"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>, this won’t be defined, so <a id="wrglossary.5058"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ and <a id="wrglossary.5059"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+ provide: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5060"></a><code class="code"><dfn id="glo:glsmfuexcl"><code class="csfmt">\glsmfuexcl</code></dfn>{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This will use <a id="wrglossary.5061"></a><a href="#glo:MFUexcl"><code class="csfmt">\MFUexcl</code></a> with <a id="wrglossary.5062"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+. With older versions, a definition will be provided that works with <a id="wrglossary.5063"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>, but exclusions won’t be recognised by <a id="wrglossary.5064"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>.<p>
+As from <a id="wrglossary.5065"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50, <a id="wrglossary.5066"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> will be identified as an exclusion (via <a id="wrglossary.5067"></a><a href="#glo:glsmfuexcl"><code class="csfmt">\glsmfuexcl</code></a>), but the optional argument will cause a problem if present. See the <a id="wrglossary.5068"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+ manual for a workaround. Note that commands such as <a id="wrglossary.5069"></a><a href="#glo:glsaddall"><code class="csfmt">\glsaddall</code></a> and <a id="wrglossary.5070"></a><a href="#glo:glsaddeach"><code class="csfmt">\glsaddeach</code></a> aren’t identified as exclusions as they aren’t expected to occur in text that may require a case-change.<p>
+With glossary entry references, there are commands that take a label as the argument, which shouldn’t have any case-changed applied, but also shouldn’t be skipped. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.5071"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<a id="wrglossary.5072"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a>{example} something}
+</pre> In this situation, there shouldn’t be any case-change as <a id="wrglossary.5073"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a> already implements a case-change. This type of command is referred to as a blocker in the <a id="wrglossary.5074"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> manual, as it indicates a command that should prevent any case-change if it’s encountered at the start of the text. Blockers are identified with <a id="wrglossary.5075"></a><a href="#glo:MFUblocker"><code class="csfmt">\MFUblocker</code></a>. If you have an older version of <a id="wrglossary.5076"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>, this won’t be defined, so <a id="wrglossary.5077"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ and <a id="wrglossary.5078"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+ provide: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5079"></a><code class="code"><dfn id="glo:glsmfublocker"><code class="csfmt">\glsmfublocker</code></dfn>{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This will use <a id="wrglossary.5080"></a><a href="#glo:MFUblocker"><code class="csfmt">\MFUblocker</code></a> with <a id="wrglossary.5081"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+. With older versions, it will simply use <a id="wrglossary.5082"></a><a href="#glo:glsmfuexcl"><code class="csfmt">\glsmfuexcl</code></a> which will instead identify the command as an exclusion and won’t be recognised by <a id="wrglossary.5083"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. See the <a id="wrglossary.5084"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+ manual for further information about blockers.<p>
+As from <a id="wrglossary.5085"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+, commands like <a id="wrglossary.5086"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a> will be identified as blockers using <a id="wrglossary.5087"></a><a href="#glo:glsmfublocker"><code class="csfmt">\glsmfublocker</code></a>, and <a id="wrglossary.5088"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> now identifies similar commands, such as <a id="wrglossary.5089"></a><a href="#glo:rGLS"><code class="csfmt">\rGLS</code></a> as blockers.<p>
+Finally, there are mappings. These are commands that should be substituted with another command, which is expected to perform the case-change. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.5090"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<a id="wrglossary.5091"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{example} something}
+</pre> This shouldn’t skip or block <a id="wrglossary.5092"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> but instead should convert the text to: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.5093"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{example} something
+</pre> This is implemented by adding a mapping from <a id="wrglossary.5094"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> to <a id="wrglossary.5095"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>. Mappings are added using <a id="wrglossary.5096"></a><a href="#glo:MFUaddmap"><code class="csfmt">\MFUaddmap</code></a>. If you have an older version of <a id="wrglossary.5097"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>, this won’t be defined, so <a id="wrglossary.5098"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ and <a id="wrglossary.5099"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+ provide: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5100"></a><code class="code"><dfn id="glo:glsmfuaddmap"><code class="csfmt">\glsmfuaddmap</code></dfn>{<span class="meta">〈<em class="metainner">cs1</em>〉</span>}{<span class="meta">〈<em class="metainner">cs2</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This will use <a id="wrglossary.5101"></a><a href="#glo:MFUaddmap"><code class="csfmt">\MFUaddmap</code></a> with <a id="wrglossary.5102"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+. With older versions, it will simply use <a id="wrglossary.5103"></a><a href="#glo:glsmfuexcl"><code class="csfmt">\glsmfuexcl</code></a> which will instead identify the command as an exclusion and won’t be recognised by <a id="wrglossary.5104"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. See the <a id="wrglossary.5105"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+ manual for further information about mappings.<p>
+As from <a id="wrglossary.5106"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+, commands like <a id="wrglossary.5107"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> will be mapped to the appropriate <a id="wrglossary.5108"></a><a href="#glo:idx.sentencecase">sentence case</a> command using <a id="wrglossary.5109"></a><a href="#glo:glsmfuaddmap"><code class="csfmt">\glsmfuaddmap</code></a>, and <a id="wrglossary.5110"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> now identifies similar mappings, such as <a id="wrglossary.5111"></a><a href="#glo:rgls"><code class="csfmt">\rgls</code></a> mapped to <a id="wrglossary.5112"></a><a href="#glo:rGls"><code class="csfmt">\rGls</code></a>.<p>
+In order to integrate the full set of features provided by <a id="wrglossary.5113"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+, you will need both <a id="wrglossary.5114"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ and <a id="wrglossary.5115"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+.<p>
+
+</section><!-- end of section sec:firstuc -->
+
+<section id="sec:lowercase"><!-- start of section sec:lowercase --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->5.2.2. Lower Case<div class="labellink"><a href="#sec:lowercase">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5116"></a><code class="code"><dfn id="glo:glslowercase"><code class="csfmt">\glslowercase</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is defined by <a id="wrglossary.5117"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ to use the LaTeX3 command to convert to <a id="wrglossary.5118"></a><a href="#glo:idx.lowercase">lowercase</a>. If an older version of <a id="wrglossary.5119"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> is present, then this command will be provided by <a id="wrglossary.5120"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> but it will be defined to use <a id="wrglossary.5121"></a><a href="#glo:MakeTextLowercase"><code class="csfmt">\MakeTextLowercase</code></a> instead. This command is primarily provided for use with <a id="wrglossary.5122"></a><a href="#glo:idx.smallcaps">small caps</a> styles to convert an abbreviation to <a id="wrglossary.5123"></a><a href="#glo:idx.lowercase">lowercase</a>, but isn’t actually used anywhere by default.<p>
+
+</section><!-- end of section sec:lowercase -->
+
+<section id="sec:uppercase"><!-- start of section sec:uppercase --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->5.2.3. Upper Case<div class="labellink"><a href="#sec:uppercase">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5124"></a><code class="code"><dfn id="glo:glsuppercase"><code class="csfmt">\glsuppercase</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is defined by <a id="wrglossary.5125"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ to use the LaTeX3 command to convert to <a id="wrglossary.5126"></a><a href="#glo:idx.uppercase">uppercase</a> (<a id="wrglossary.5127"></a><a href="#glo:idx.allcaps">all caps</a>). If an older version of <a id="wrglossary.5128"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> is present, then this command will be provided by <a id="wrglossary.5129"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> but it will be defined to just use <a id="wrglossary.5130"></a><a href="#glo:mfirstucMakeUppercase"><code class="csfmt">\mfirstucMakeUppercase</code></a>, which is provided by <a id="wrglossary.5131"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>. This command is used by <a id="wrglossary.5132"></a><a href="#glo:idx.allcaps">all caps</a> commands such as <a id="wrglossary.5133"></a><a href="#glo:GLSxtrusefield"><code class="csfmt">\GLSxtrusefield</code></a>.<p>
+
+</section><!-- end of section sec:uppercase -->
+
+<section id="sec:titlecase"><!-- start of section sec:titlecase --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->5.2.4. Title Case<div class="labellink"><a href="#sec:titlecase">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5134"></a><code class="code"><dfn id="glo:glscapitalisewords"><code class="csfmt">\glscapitalisewords</code></dfn>{<span class="meta">〈<em class="metainner">content</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is defined by <a id="wrglossary.5135"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.48 to use <a id="wrglossary.5136"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a> to convert to <a id="wrglossary.5137"></a><a href="#glo:idx.titlecase">title case</a>. If you experience any errors with <a id="wrglossary.5138"></a><a href="#glo:idx.titlecase">title case</a> commands, such as <a id="wrglossary.5139"></a><a href="#glo:glsentrytitlecase"><code class="csfmt">\glsentrytitlecase</code></a>, or attributes such as <a id="wrglossary.5140"></a><a href="#glo:opt.catattr.glossdesc"><span class="csoptfmt">glossdesc</span></a> then try redefining this command to use <code class="code"><a id="wrglossary.5141"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a>*</code> instead. See the <a id="wrglossary.5142"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> manual for further details.<p>
+
+</section><!-- end of section sec:titlecase -->
+
+<section id="sec:headtitle"><!-- start of section sec:headtitle --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->5.3. Entries in Sectioning Titles, Headers, Captions and Contents<div class="labellink"><a href="#sec:headtitle">[link]</a></div></h2><!-- end of section header -->
+<p>
+The <a id="wrglossary.5143"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> user manual cautions against using commands like <a id="wrglossary.5144"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> in chapter or section titles. The principle problems are:
+<ul class="displaylist">
+ <li><span class="bulletitem">•</span>if you have a table of contents, the <a id="wrglossary.5145"></a><a href="#glo:dual.firstuseflag">first use flag</a> will be unset in the contents rather than later in the document;<p>
+<li><span class="bulletitem">•</span>if you have the <a id="wrglossary.5146"></a><a href="#glo:dual.locationlist">location lists</a> displayed in the <a id="wrglossary.5147"></a><a href="#glo:dual.glossary">glossary</a>, unwanted <a id="wrglossary.5148"></a><a href="#glo:@@glslabel@entrylocation">locations</a> will be added to it corresponding to the table of contents (if present) and every page that contains the entry in the page header (if the page style in use adds the chapter or section title to the header);<p>
+<li><span class="bulletitem">•</span>if the page style in use adds the chapter or section title to the header and attempts to convert it to <a id="wrglossary.5149"></a><a href="#glo:idx.uppercase">uppercase</a>, the entry label (in the argument of <a id="wrglossary.5150"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> etc) will be converted to <a id="wrglossary.5151"></a><a href="#glo:idx.uppercase">uppercase</a> and the entry won’t be recognised;<p>
+<li><span class="bulletitem">•</span>if you use <a id="wrglossary.5152"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>, commands like <a id="wrglossary.5153"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> can’t be expanded to a simple string and only the label will appear in the PDF bookmark (with a warning from <a id="wrglossary.5154"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>);<p>
+<li><span class="bulletitem">•</span>if you use <a id="wrglossary.5155"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>, you will end up with nested hyperlinks in the table of contents.
+</ul>
+ Similar problems can also occur with captions (except for the page header and bookmark issues).<p>
+The <a id="wrglossary.5156"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package tries to resolve the header problem by modifying <a id="wrglossary.5157"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a>, <a id="wrglossary.5158"></a><a href="#glo:markboth"><code class="csfmt">\markboth</code></a> and <a id="wrglossary.5159"></a><a href="#glo:@starttoc"><code class="csfmt">\@starttoc</code></a>. If this causes unwanted side-effects, you can restore their former definitions using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5160"></a><code class="code"><dfn id="glo:glsxtrRevertMarks"><code class="csfmt">\glsxtrRevertMarks</code></dfn></code></div><!-- end of pinnedbox -->
+ This will revert <a id="wrglossary.5161"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a>, <a id="wrglossary.5162"></a><a href="#glo:markboth"><code class="csfmt">\markboth</code></a> and <a id="wrglossary.5163"></a><a href="#glo:@starttoc"><code class="csfmt">\@starttoc</code></a> back to the definitions in effect when <a id="wrglossary.5164"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> was loaded. Alternatively, you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5165"></a><code class="code"><dfn id="glo:glsxtrRevertTocMarks"><code class="csfmt">\glsxtrRevertTocMarks</code></dfn></code></div><!-- end of pinnedbox -->
+ This will only revert <a id="wrglossary.5166"></a><a href="#glo:@starttoc"><code class="csfmt">\@starttoc</code></a>.<p>
+If you use <a id="wrglossary.5167"></a><a href="#glo:glsxtrRevertMarks"><code class="csfmt">\glsxtrRevertMarks</code></a> or <a id="wrglossary.5168"></a><a href="#glo:glsxtrRevertTocMarks"><code class="csfmt">\glsxtrRevertTocMarks</code></a>, you will need to employ the simplistic approach, described in §<a href="#sec:simplisticapproach">5.3.1</a>, which is the method recommended by the <a id="wrglossary.5169"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> user manual. Otherwise, you can use the commands described in §<a href="#sec:headingcommands">5.3.2</a>, which provide a better solution.<p>
+
+</section><!-- end of section sec:headtitle -->
+
+<section id="sec:simplisticapproach"><!-- start of section sec:simplisticapproach --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->5.3.1. Simplistic Approach<div class="labellink"><a href="#sec:simplisticapproach">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+To get around all these problems, the <a id="wrglossary.5170"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> user manual recommends using the expandable non-hyperlink commands, such as <a id="wrglossary.5171"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a> (for regular entries) or <a id="wrglossary.5172"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a> (for abbreviations). This is the simplest solution, but doesn’t allow for special formatting that’s applied to the entry through commands like <a id="wrglossary.5173"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> or <a id="wrglossary.5174"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>.<p>
+For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+
+<code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+
+<a id="wrglossary.5175"></a><a href="#glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></a>{general}{<a id="wrglossary.5176"></a><a href="#glo:glsxtrpostlinkAddDescOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddDescOnFirstUse</code></a>}
+
+<a id="wrglossary.5177"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.5178"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,
+ <a id="wrglossary.5179"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+<a id="wrglossary.5180"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.5181"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\alpha</code>}}</span>,<a id="wrglossary.5182"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={alpha}</span>}
+
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.5183"></a><a href="#glo:tableofcontents"><code class="csfmt">\tableofcontents</code></a>
+<code class="cmd">\section</code>{<a id="wrglossary.5184"></a><a href="#glo:texorpdfstring"><code class="csfmt">\texorpdfstring</code></a>{<a id="wrglossary.5185"></a><a href="#glo:Glsentrytext"><code class="csfmt">\Glsentrytext</code></a>{sample}
+ and <a id="wrglossary.5186"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a>{alpha}}{Sample and alpha}}
+
+First use: <a id="wrglossary.5187"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample} and <a id="wrglossary.5188"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
+
+Next use: <a id="wrglossary.5189"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample} and <a id="wrglossary.5190"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
+
+<a id="wrglossary.5191"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:simpleseccmds"></a>Example 92: References in section headings (simplistic approach) <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example092.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example092.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example092.png" type="image/png" width="388" height="244">Example document that uses a simplistic approach to referencing entries in section titles.</object> </div><!-- end of resultbox -->
+ This solves some problems: it avoids nested links in the table of contents, the <a id="wrglossary.5192"></a><a href="#glo:dual.firstuseflag">first use flag</a> isn’t prematurely unset and the PDF bookmarks has a reasonable substitution, but it still isn’t a complete solution as the above document will fail if the page style is changed to <code class="code">headings</code> and a page break is inserted before the section (after <a id="wrglossary.5193"></a><a href="#glo:tableofcontents"><code class="csfmt">\tableofcontents</code></a>), which will lead to the error: <pre class="transcript"><div class="transcripttitle"><a href="#glo:sym.transcript"><span title="Transcript" class="icon">🔎</span></a></div>Glossary entry `SAMPLE' has not been defined.
+</pre> This is because the case-change applied to the header converts the label <span class="qt">“sample”</span> to <span class="qt">“SAMPLE”</span>, which doesn’t correspond to a defined entry. (This can now be avoided with <a id="wrglossary.5194"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+.)<p>
+If the case conversion is applied by, then the case-change can be prevented by encapsulating the label with <a id="wrglossary.5195"></a><a href="#glo:NoCaseChange"><code class="csfmt">\NoCaseChange</code></a>, but this ends up quite complicated. This is actually what the commands describe in §<a href="#sec:headingcommands">5.3.2</a> do when they are in a heading. This allows for older versions of <a id="wrglossary.5196"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> that don’t recognise exclusions. See §<a href="#sec:casechange">5.2</a> for further details.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+The <a id="wrglossary.5197"></a><a href="#glo:NoCaseChange"><code class="csfmt">\NoCaseChange</code></a> command was originally provided by the <a id="wrglossary.5198"></a><a href="#glo:pkg.textcase"><span class="styfmt">textcase</span></a> package to prevent <a id="wrglossary.5199"></a><a href="#glo:MakeTextUppercase"><code class="csfmt">\MakeTextUppercase</code></a> from applying a case-change. The functionality of the <a id="wrglossary.5200"></a><a href="#glo:pkg.textcase"><span class="styfmt">textcase</span></a> package has now been absorbed into the LaTeX kernel, which means that as from 2022, <a id="wrglossary.5201"></a><a href="#glo:pkg.textcase"><span class="styfmt">textcase</span></a> is deprecated and <a id="wrglossary.5202"></a><a href="#glo:NoCaseChange"><code class="csfmt">\NoCaseChange</code></a> is defined by the kernel. </div><!-- end of information -->
+<p>
+
+</section><!-- end of section sec:simplisticapproach -->
+
+<section id="sec:headingcommands"><!-- start of section sec:headingcommands --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->5.3.2. New Commands Designed for Chapter/Section Headings or Captions<div class="labellink"><a href="#sec:headingcommands">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+This section is irrelevant if you use <a id="wrglossary.5203"></a><a href="#glo:glsxtrRevertMarks"><code class="csfmt">\glsxtrRevertMarks</code></a> to restore the definitions of <a id="wrglossary.5204"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a>, <a id="wrglossary.5205"></a><a href="#glo:markboth"><code class="csfmt">\markboth</code></a> and <a id="wrglossary.5206"></a><a href="#glo:@starttoc"><code class="csfmt">\@starttoc</code></a>. If you use <a id="wrglossary.5207"></a><a href="#glo:glsxtrRevertTocMarks"><code class="csfmt">\glsxtrRevertTocMarks</code></a>, then this section is only applicable to <a id="wrglossary.5208"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a> and <a id="wrglossary.5209"></a><a href="#glo:markboth"><code class="csfmt">\markboth</code></a>.<p>
+The commands listed here are provided for use within captions or section headings. They are designed to overcome some of the problems illustrated in the previous section. Note that they only have a single argument, the entry label. There are no optional arguments. Below, <span class="qt">“header”</span> refers to page header text added with <a id="wrglossary.5210"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a> or <a id="wrglossary.5211"></a><a href="#glo:markboth"><code class="csfmt">\markboth</code></a>, and <span class="qt">“contents”</span> refers to the table of contents or any other <span class="qt">“list of”</span> that uses <a id="wrglossary.5212"></a><a href="#glo:@starttoc"><code class="csfmt">\@starttoc</code></a>, such as the list of figures.<p>
+Each command <code class="csfmt">\glsfmt<span class="meta">〈<em class="metainner">field</em>〉</span></code> (such as <a id="wrglossary.5213"></a><a href="#glo:glsfmttext"><code class="csfmt">\glsfmttext</code></a> or <a id="wrglossary.5214"></a><a href="#glo:glsfmtshort"><code class="csfmt">\glsfmtshort</code></a>) behaves like an analogous <code class="csfmt">\gls<span class="meta">〈<em class="metainner">field</em>〉</span></code> or <code class="csfmt">\glsxtr<span class="meta">〈<em class="metainner">field</em>〉</span></code> command (such as <a id="wrglossary.5215"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> or <a id="wrglossary.5216"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>) but with the options <a id="wrglossary.5217"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a> and <a id="wrglossary.5218"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span> and no insert. When they occur within a header, they are protected from having any case-change applied (which will interfere with the entry label). Since this means they won’t appear in <a id="wrglossary.5219"></a><a href="#glo:idx.allcaps">all caps</a> in the header, the <a id="wrglossary.5220"></a><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a> attribute may be set to use the <a id="wrglossary.5221"></a><a href="#glo:idx.allcaps">all caps</a> <code class="csfmt">\GLS<span class="meta">〈<em class="metainner">field</em>〉</span></code> or <code class="csfmt">\GLSxtr<span class="meta">〈<em class="metainner">field</em>〉</span></code> instead (such as <a id="wrglossary.5222"></a><a href="#glo:GLStext"><code class="csfmt">\GLStext</code></a> or <a id="wrglossary.5223"></a><a href="#glo:GLSxtrshort"><code class="csfmt">\GLSxtrshort</code></a>).<p>
+There is currently only support for the <a id="wrglossary.5224"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, <a id="wrglossary.5225"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a>, <a id="wrglossary.5226"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a>, <a id="wrglossary.5227"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a>, <a id="wrglossary.5228"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a>, <a id="wrglossary.5229"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a>, <a id="wrglossary.5230"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a>, <a id="wrglossary.5231"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a>, and <a id="wrglossary.5232"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> fields, and also limited support for the full form of abbreviations. For other fields, you will need to follow the recommendation of the <a id="wrglossary.5233"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> manual (as discussed above in §<a href="#sec:simplisticapproach">5.3.1</a>).<p>
+The previous example can be rewritten as follows: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+
+<code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+
+<a id="wrglossary.5234"></a><a href="#glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></a>{general}{<a id="wrglossary.5235"></a><a href="#glo:glsxtrpostlinkAddDescOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddDescOnFirstUse</code></a>}
+
+<a id="wrglossary.5236"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.5237"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.5238"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+<a id="wrglossary.5239"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.5240"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\alpha</code>}}</span>,
+ <a id="wrglossary.5241"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={alpha}</span>}
+
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.5242"></a><a href="#glo:tableofcontents"><code class="csfmt">\tableofcontents</code></a>
+<code class="cmd">\section</code>{<a id="wrglossary.5243"></a><a href="#glo:Glsfmttext"><code class="csfmt">\Glsfmttext</code></a>{sample} and <a id="wrglossary.5244"></a><a href="#glo:glsfmttext"><code class="csfmt">\glsfmttext</code></a>{alpha}}
+
+First use: <a id="wrglossary.5245"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample} and <a id="wrglossary.5246"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
+
+Next use: <a id="wrglossary.5247"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample} and <a id="wrglossary.5248"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
+
+<a id="wrglossary.5249"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:glsfmttext"></a>Example 93: References in section headings using <code class="cmd">\glsfmttext</code> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example093.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example093.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example093.png" type="image/png" width="388" height="244">Example document that references entries in section titles.</object> </div><!-- end of resultbox -->
+ Note that this still results in <span class="qt">“Token not allowed in a PDF string”</span> warnings from <a id="wrglossary.5250"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>. This is due to the maths shift and <code class="csfmt">\alpha</code>, and is something that would also occur if the section title explicitly contained <code class="code">$<span class="cmdfmt">\alpha</span>$</code>. If this is likely to happen, the issue can be solved by placing <a id="wrglossary.5251"></a><a href="#glo:texorpdfstring"><code class="csfmt">\texorpdfstring</code></a> within the field value. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.5252"></a><a href="#glo:glsnoexpandfields"><code class="csfmt">\glsnoexpandfields</code></a>
+<a id="wrglossary.5253"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.5254"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={alpha}</span>,
+ <a id="wrglossary.5255"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.5256"></a><a href="#glo:texorpdfstring"><code class="csfmt">\texorpdfstring</code></a>{<code class="cmd">\ensuremath</code>{<code class="cmd">\alpha</code>}}{alpha}}</span>}
+</pre> Note the need to prevent field expansion with <a id="wrglossary.5257"></a><a href="#glo:glsnoexpandfields"><code class="csfmt">\glsnoexpandfields</code></a>, otherwise <a id="wrglossary.5258"></a><a href="#glo:texorpdfstring"><code class="csfmt">\texorpdfstring</code></a> will be prematurely expanded while the entry is being defined.<p>
+The options <a id="wrglossary.5259"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a> and <a id="wrglossary.5260"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span> are hard-coded when the commands listed below, such as <a id="wrglossary.5261"></a><a href="#glo:glsfmtshort"><code class="csfmt">\glsfmtshort</code></a>, occur in the header or contents, but within the actual section title or caption in the document text, those options are obtained from: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5262"></a><code class="code"><dfn id="glo:glsxtrtitleopts"><code class="csfmt">\glsxtrtitleopts</code></dfn></code></div><!-- end of pinnedbox -->
+ This simply expands to the option list. For example, you may actually want a hyperlink and <a id="wrglossary.5263"></a><a href="#glo:dual.indexing">indexing</a> to occur in the document body, in which case redefine <a id="wrglossary.5264"></a><a href="#glo:glsxtrtitleopts"><code class="csfmt">\glsxtrtitleopts</code></a> to do nothing: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+
+<code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+
+<a id="wrglossary.5265"></a><a href="#glo:pagestyle"><code class="csfmt">\pagestyle</code></a>{headings}
+<a id="wrglossary.5266"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{general}{headuc}{true}
+<a id="wrglossary.5267"></a><a href="#glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></a>{general}{<a id="wrglossary.5268"></a><a href="#glo:glsxtrpostlinkAddDescOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddDescOnFirstUse</code></a>}
+
+<a id="wrglossary.5269"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.5270"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.5271"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.5272"></a><a href="#glo:glsxtrtitleopts"><code class="csfmt">\glsxtrtitleopts</code></a>}{}
+
+<code class="cbeg">\begin{document}</code>
+<code class="cmd">\section</code>{<a id="wrglossary.5273"></a><a href="#glo:Glsfmttext"><code class="csfmt">\Glsfmttext</code></a>{sample}}
+First use: <a id="wrglossary.5274"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}.
+Next use: <a id="wrglossary.5275"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}.
+<a id="wrglossary.5276"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:glslinkinsechead"></a>Example 94: Reference with hyperlink in section headings <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example094.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example094.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example094.png" type="image/png" width="388" height="141">Example document that references an entry with a hyperlink in a section title.</object> </div><!-- end of resultbox -->
+<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5277"></a><code class="code"><dfn id="glo:glsfmtshort"><code class="csfmt">\glsfmtshort</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5278"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> but expands to just <a id="wrglossary.5279"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5280"></a><code class="code"><dfn id="glo:Glsfmtshort"><code class="csfmt">\Glsfmtshort</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5281"></a><a href="#glo:Glsxtrshort"><code class="csfmt">\Glsxtrshort</code></a> but expands to: <pre class="compactcodebox"><a id="wrglossary.5282"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.5283"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}}
+</pre> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5284"></a><code class="code"><dfn id="glo:GLSfmtshort"><code class="csfmt">\GLSfmtshort</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5285"></a><a href="#glo:GLSxtrshort"><code class="csfmt">\GLSxtrshort</code></a> but expands to just <a id="wrglossary.5286"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5287"></a><code class="code"><dfn id="glo:pglsfmtshort"><code class="csfmt">\pglsfmtshort</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.5288"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.5289"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.5290"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.5291"></a><a href="#glo:glsfmtshort"><code class="csfmt">\glsfmtshort</code></a> but inserts the <a id="wrglossary.5292"></a><a href="#glo:opt.gloskey.prefix"><span class="csoptfmt">prefix</span></a> field and separator, if the <a id="wrglossary.5293"></a><a href="#glo:opt.gloskey.prefix"><span class="csoptfmt">prefix</span></a> value is set and non-empty. Provided for use with <a id="wrglossary.5294"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5295"></a><code class="code"><dfn id="glo:Pglsfmtshort"><code class="csfmt">\Pglsfmtshort</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.5296"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.5297"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.5298"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.5299"></a><a href="#glo:pglsfmtshort"><code class="csfmt">\pglsfmtshort</code></a> but <a id="wrglossary.5300"></a><a href="#glo:idx.sentencecase">sentence case</a>. Note the initial <span class="qt">“P”</span> in the command name, which matches <a id="wrglossary.5301"></a><a href="#glo:Pgls"><code class="csfmt">\Pgls</code></a> (similarly for the other prefix <a id="wrglossary.5302"></a><a href="#glo:idx.sentencecase">sentence case</a> commands).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5303"></a><code class="code"><dfn id="glo:PGLSfmtshort"><code class="csfmt">\PGLSfmtshort</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.5304"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.5305"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.5306"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.5307"></a><a href="#glo:pglsfmtshort"><code class="csfmt">\pglsfmtshort</code></a> but <a id="wrglossary.5308"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5309"></a><code class="code"><dfn id="glo:glsfmtshortpl"><code class="csfmt">\glsfmtshortpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5310"></a><a href="#glo:glsxtrshortpl"><code class="csfmt">\glsxtrshortpl</code></a> but expands to just <a id="wrglossary.5311"></a><a href="#glo:glsentryshortpl"><code class="csfmt">\glsentryshortpl</code></a> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5312"></a><code class="code"><dfn id="glo:Glsfmtshortpl"><code class="csfmt">\Glsfmtshortpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5313"></a><a href="#glo:Glsxtrshortpl"><code class="csfmt">\Glsxtrshortpl</code></a> but expands to: <pre class="compactcodebox"><a id="wrglossary.5314"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.5315"></a><a href="#glo:glsentryshortpl"><code class="csfmt">\glsentryshortpl</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}}
+</pre> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5316"></a><code class="code"><dfn id="glo:GLSfmtshortpl"><code class="csfmt">\GLSfmtshortpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5317"></a><a href="#glo:GLSxtrshortpl"><code class="csfmt">\GLSxtrshortpl</code></a> but expands to just <a id="wrglossary.5318"></a><a href="#glo:glsentryshortpl"><code class="csfmt">\glsentryshortpl</code></a> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5319"></a><code class="code"><dfn id="glo:pglsfmtshortpl"><code class="csfmt">\pglsfmtshortpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.5320"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.5321"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.5322"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.5323"></a><a href="#glo:glsfmtshortpl"><code class="csfmt">\glsfmtshortpl</code></a> but inserts the <a id="wrglossary.5324"></a><a href="#glo:opt.gloskey.prefixplural"><span class="csoptfmt">prefixplural</span></a> field and separator, if the <a id="wrglossary.5325"></a><a href="#glo:opt.gloskey.prefixplural"><span class="csoptfmt">prefixplural</span></a> value is set and non-empty. Provided for use with <a id="wrglossary.5326"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5327"></a><code class="code"><dfn id="glo:Pglsfmtshortpl"><code class="csfmt">\Pglsfmtshortpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.5328"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.5329"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.5330"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.5331"></a><a href="#glo:pglsfmtshortpl"><code class="csfmt">\pglsfmtshortpl</code></a> but <a id="wrglossary.5332"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5333"></a><code class="code"><dfn id="glo:PGLSfmtshortpl"><code class="csfmt">\PGLSfmtshortpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.5334"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.5335"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.5336"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.5337"></a><a href="#glo:pglsfmtshortpl"><code class="csfmt">\pglsfmtshortpl</code></a> but <a id="wrglossary.5338"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5339"></a><code class="code"><dfn id="glo:glsfmtlong"><code class="csfmt">\glsfmtlong</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5340"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> but expands to just <a id="wrglossary.5341"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5342"></a><code class="code"><dfn id="glo:Glsfmtlong"><code class="csfmt">\Glsfmtlong</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5343"></a><a href="#glo:Glsxtrlong"><code class="csfmt">\Glsxtrlong</code></a> but expands to: <pre class="compactcodebox"><a id="wrglossary.5344"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.5345"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}}
+</pre> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5346"></a><code class="code"><dfn id="glo:GLSfmtlong"><code class="csfmt">\GLSfmtlong</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5347"></a><a href="#glo:GLSxtrlong"><code class="csfmt">\GLSxtrlong</code></a> but expands to just <a id="wrglossary.5348"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5349"></a><code class="code"><dfn id="glo:pglsfmtlong"><code class="csfmt">\pglsfmtlong</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.5350"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.5351"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.5352"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.5353"></a><a href="#glo:glsfmtlong"><code class="csfmt">\glsfmtlong</code></a> but inserts the <a id="wrglossary.5354"></a><a href="#glo:opt.gloskey.prefixfirst"><span class="csoptfmt">prefixfirst</span></a> field and separator, if the <a id="wrglossary.5355"></a><a href="#glo:opt.gloskey.prefixfirst"><span class="csoptfmt">prefixfirst</span></a> value is set and non-empty. Provided for use with <a id="wrglossary.5356"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5357"></a><code class="code"><dfn id="glo:Pglsfmtlong"><code class="csfmt">\Pglsfmtlong</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.5358"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.5359"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.5360"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.5361"></a><a href="#glo:pglsfmtlong"><code class="csfmt">\pglsfmtlong</code></a> but <a id="wrglossary.5362"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5363"></a><code class="code"><dfn id="glo:PGLSfmtlong"><code class="csfmt">\PGLSfmtlong</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.5364"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.5365"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.5366"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.5367"></a><a href="#glo:pglsfmtlong"><code class="csfmt">\pglsfmtlong</code></a> but <a id="wrglossary.5368"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5369"></a><code class="code"><dfn id="glo:glsfmtlongpl"><code class="csfmt">\glsfmtlongpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5370"></a><a href="#glo:glsxtrlongpl"><code class="csfmt">\glsxtrlongpl</code></a> but expands to just <a id="wrglossary.5371"></a><a href="#glo:glsentrylongpl"><code class="csfmt">\glsentrylongpl</code></a> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5372"></a><code class="code"><dfn id="glo:Glsfmtlongpl"><code class="csfmt">\Glsfmtlongpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5373"></a><a href="#glo:Glsxtrlongpl"><code class="csfmt">\Glsxtrlongpl</code></a> but expands to: <pre class="compactcodebox"><a id="wrglossary.5374"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.5375"></a><a href="#glo:glsentrylongpl"><code class="csfmt">\glsentrylongpl</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}}
+</pre> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5376"></a><code class="code"><dfn id="glo:GLSfmtlongpl"><code class="csfmt">\GLSfmtlongpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5377"></a><a href="#glo:GLSxtrlongpl"><code class="csfmt">\GLSxtrlongpl</code></a> but expands to just <a id="wrglossary.5378"></a><a href="#glo:glsentrylongpl"><code class="csfmt">\glsentrylongpl</code></a> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5379"></a><code class="code"><dfn id="glo:pglsfmtlongpl"><code class="csfmt">\pglsfmtlongpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.5380"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.5381"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.5382"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.5383"></a><a href="#glo:glsfmtlongpl"><code class="csfmt">\glsfmtlongpl</code></a> but inserts the <a id="wrglossary.5384"></a><a href="#glo:opt.gloskey.prefixfirstplural"><span class="csoptfmt">prefixfirstplural</span></a> field and separator, if the <a id="wrglossary.5385"></a><a href="#glo:opt.gloskey.prefixfirstplural"><span class="csoptfmt">prefixfirstplural</span></a> value is set and non-empty. Provided for use with <a id="wrglossary.5386"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5387"></a><code class="code"><dfn id="glo:Pglsfmtlongpl"><code class="csfmt">\Pglsfmtlongpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.5388"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.5389"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.5390"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.5391"></a><a href="#glo:pglsfmtlongpl"><code class="csfmt">\pglsfmtlongpl</code></a> but <a id="wrglossary.5392"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5393"></a><code class="code"><dfn id="glo:PGLSfmtlongpl"><code class="csfmt">\PGLSfmtlongpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.5394"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.5395"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.5396"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ As <a id="wrglossary.5397"></a><a href="#glo:pglsfmtlongpl"><code class="csfmt">\pglsfmtlongpl</code></a> but <a id="wrglossary.5398"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<p>
+The full form is slightly different as it doesn’t correspond to an individual <a id="wrglossary.5399"></a><a href="#glo:dual.field">field</a> but instead is formed from a combination of the short and long <a id="wrglossary.5400"></a><a href="#glo:dual.field">fields</a> (the order depending on the abbreviation style). Since it’s too complicated to simply expand to the appropriate style, a simple expandable command is provided for the PDF bookmarks: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5401"></a><code class="code"><dfn id="glo:glspdffmtfull"><code class="csfmt">\glspdffmtfull</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This just expands to the long form followed by the short form in parentheses: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.5402"></a><a href="#glo:glspdffmtfull"><code class="csfmt">\glspdffmtfull</code></a>}[1]{<a id="wrglossary.5403"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a>{#1}
+ (<a id="wrglossary.5404"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a>{#1})}
+</pre> You will need to redefine this if you require the short form first. There is an analogous command for the plural: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5405"></a><code class="code"><dfn id="glo:glspdffmtfullpl"><code class="csfmt">\glspdffmtfullpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This has a similar definition to <a id="wrglossary.5406"></a><a href="#glo:glspdffmtfull"><code class="csfmt">\glspdffmtfull</code></a> but uses <a id="wrglossary.5407"></a><a href="#glo:glsentrylongpl"><code class="csfmt">\glsentrylongpl</code></a> and <a id="wrglossary.5408"></a><a href="#glo:glsentryshortpl"><code class="csfmt">\glsentryshortpl</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5409"></a><code class="code"><dfn id="glo:glsfmtfull"><code class="csfmt">\glsfmtfull</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5410"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> but expands to just <a id="wrglossary.5411"></a><a href="#glo:glspdffmtfull"><code class="csfmt">\glspdffmtfull</code></a> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5412"></a><code class="code"><dfn id="glo:Glsfmtfull"><code class="csfmt">\Glsfmtfull</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5413"></a><a href="#glo:Glsxtrfull"><code class="csfmt">\Glsxtrfull</code></a> but expands to: <pre class="compactcodebox"><a id="wrglossary.5414"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.5415"></a><a href="#glo:glspdffmtfull"><code class="csfmt">\glspdffmtfull</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}}
+</pre> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5416"></a><code class="code"><dfn id="glo:GLSfmtfull"><code class="csfmt">\GLSfmtfull</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5417"></a><a href="#glo:GLSxtrfull"><code class="csfmt">\GLSxtrfull</code></a> but expands to just <a id="wrglossary.5418"></a><a href="#glo:glspdffmtfull"><code class="csfmt">\glspdffmtfull</code></a> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5419"></a><code class="code"><dfn id="glo:glsfmtfullpl"><code class="csfmt">\glsfmtfullpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5420"></a><a href="#glo:glsxtrfullpl"><code class="csfmt">\glsxtrfullpl</code></a> but expands to just <a id="wrglossary.5421"></a><a href="#glo:glspdffmtfullpl"><code class="csfmt">\glspdffmtfullpl</code></a> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5422"></a><code class="code"><dfn id="glo:Glsfmtfullpl"><code class="csfmt">\Glsfmtfullpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5423"></a><a href="#glo:Glsxtrfullpl"><code class="csfmt">\Glsxtrfullpl</code></a> but expands to: <pre class="compactcodebox"><a id="wrglossary.5424"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.5425"></a><a href="#glo:glspdffmtfullpl"><code class="csfmt">\glspdffmtfullpl</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}}
+</pre> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5426"></a><code class="code"><dfn id="glo:GLSfmtfullpl"><code class="csfmt">\GLSfmtfullpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5427"></a><a href="#glo:GLSxtrfull"><code class="csfmt">\GLSxtrfull</code></a> but expands to just <a id="wrglossary.5428"></a><a href="#glo:glspdffmtfull"><code class="csfmt">\glspdffmtfull</code></a> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5429"></a><code class="code"><dfn id="glo:glsfmtname"><code class="csfmt">\glsfmtname</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5430"></a><a href="#glo:glsname"><code class="csfmt">\glsname</code></a> but expands to just <a id="wrglossary.5431"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5432"></a><code class="code"><dfn id="glo:Glsfmtname"><code class="csfmt">\Glsfmtname</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5433"></a><a href="#glo:Glsname"><code class="csfmt">\Glsname</code></a> but expands to: <pre class="compactcodebox"><a id="wrglossary.5434"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.5435"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}}
+</pre> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5436"></a><code class="code"><dfn id="glo:GLSfmtname"><code class="csfmt">\GLSfmtname</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5437"></a><a href="#glo:GLSname"><code class="csfmt">\GLSname</code></a> but expands to just <a id="wrglossary.5438"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5439"></a><code class="code"><dfn id="glo:glsfmttext"><code class="csfmt">\glsfmttext</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5440"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> but expands to just <a id="wrglossary.5441"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5442"></a><code class="code"><dfn id="glo:Glsfmttext"><code class="csfmt">\Glsfmttext</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5443"></a><a href="#glo:Glstext"><code class="csfmt">\Glstext</code></a> but expands to: <pre class="compactcodebox"><a id="wrglossary.5444"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.5445"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}}
+</pre> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5446"></a><code class="code"><dfn id="glo:GLSfmttext"><code class="csfmt">\GLSfmttext</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5447"></a><a href="#glo:GLStext"><code class="csfmt">\GLStext</code></a> but expands to just <a id="wrglossary.5448"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5449"></a><code class="code"><dfn id="glo:glsfmtplural"><code class="csfmt">\glsfmtplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5450"></a><a href="#glo:glsplural"><code class="csfmt">\glsplural</code></a> but expands to just <a id="wrglossary.5451"></a><a href="#glo:glsentryplural"><code class="csfmt">\glsentryplural</code></a> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5452"></a><code class="code"><dfn id="glo:Glsfmtplural"><code class="csfmt">\Glsfmtplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5453"></a><a href="#glo:Glsplural"><code class="csfmt">\Glsplural</code></a> but expands to: <pre class="compactcodebox"><a id="wrglossary.5454"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.5455"></a><a href="#glo:glsentryplural"><code class="csfmt">\glsentryplural</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}}
+</pre> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5456"></a><code class="code"><dfn id="glo:GLSfmtplural"><code class="csfmt">\GLSfmtplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5457"></a><a href="#glo:GLSplural"><code class="csfmt">\GLSplural</code></a> but expands to just <a id="wrglossary.5458"></a><a href="#glo:glsentryplural"><code class="csfmt">\glsentryplural</code></a> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5459"></a><code class="code"><dfn id="glo:glsfmtfirst"><code class="csfmt">\glsfmtfirst</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5460"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a> but expands to just <a id="wrglossary.5461"></a><a href="#glo:glsentryfirst"><code class="csfmt">\glsentryfirst</code></a> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5462"></a><code class="code"><dfn id="glo:Glsfmtfirst"><code class="csfmt">\Glsfmtfirst</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5463"></a><a href="#glo:Glsfirst"><code class="csfmt">\Glsfirst</code></a> but expands to: <pre class="compactcodebox"><a id="wrglossary.5464"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.5465"></a><a href="#glo:glsentryfirst"><code class="csfmt">\glsentryfirst</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}}
+</pre> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5466"></a><code class="code"><dfn id="glo:GLSfmtfirst"><code class="csfmt">\GLSfmtfirst</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5467"></a><a href="#glo:GLSfirst"><code class="csfmt">\GLSfirst</code></a> but expands to just <a id="wrglossary.5468"></a><a href="#glo:glsentryfirst"><code class="csfmt">\glsentryfirst</code></a> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5469"></a><code class="code"><dfn id="glo:glsfmtfirstpl"><code class="csfmt">\glsfmtfirstpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5470"></a><a href="#glo:glsfirstplural"><code class="csfmt">\glsfirstplural</code></a> but expands to just <a id="wrglossary.5471"></a><a href="#glo:glsentryfirstplural"><code class="csfmt">\glsentryfirstplural</code></a> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5472"></a><code class="code"><dfn id="glo:Glsfmtfirstpl"><code class="csfmt">\Glsfmtfirstpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5473"></a><a href="#glo:Glsfirstplural"><code class="csfmt">\Glsfirstplural</code></a> but expands to: <pre class="compactcodebox"><a id="wrglossary.5474"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.5475"></a><a href="#glo:glsentryfirstplural"><code class="csfmt">\glsentryfirstplural</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}}
+</pre> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5476"></a><code class="code"><dfn id="glo:GLSfmtfirstpl"><code class="csfmt">\GLSfmtfirstpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This normally behaves like <a id="wrglossary.5477"></a><a href="#glo:GLSfirstplural"><code class="csfmt">\GLSfirstplural</code></a> but expands to just <a id="wrglossary.5478"></a><a href="#glo:glsentryfirstplural"><code class="csfmt">\glsentryfirstplural</code></a> in PDF bookmarks and is adjusted when appearing in the header or contents.<p>
+
+</section><!-- end of section sec:headingcommands -->
+
+<section id="sec:headingsadvanced"><!-- start of section sec:headingsadvanced --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->5.3.3. Advanced Commands<div class="labellink"><a href="#sec:headingsadvanced">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+This section is intended for advanced users and package developers. </div><!-- end of information -->
+<p>
+The commands described here are irrelevant if you use <a id="wrglossary.5479"></a><a href="#glo:glsxtrRevertMarks"><code class="csfmt">\glsxtrRevertMarks</code></a> to restore the definitions of <a id="wrglossary.5480"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a>, <a id="wrglossary.5481"></a><a href="#glo:markboth"><code class="csfmt">\markboth</code></a> and <a id="wrglossary.5482"></a><a href="#glo:@starttoc"><code class="csfmt">\@starttoc</code></a>. If you use <a id="wrglossary.5483"></a><a href="#glo:glsxtrRevertTocMarks"><code class="csfmt">\glsxtrRevertTocMarks</code></a>, then this section is only applicable to <a id="wrglossary.5484"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a> and <a id="wrglossary.5485"></a><a href="#glo:markboth"><code class="csfmt">\markboth</code></a>.<p>
+If you need to know whether or not some code is inside a header or contents list, you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5486"></a><code class="code"><dfn id="glo:glsxtrifinmark"><code class="csfmt">\glsxtrifinmark</code></dfn>{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does <span class="meta">〈<em class="metainner">true</em>〉</span> if the command occurs within <a id="wrglossary.5487"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a>, <a id="wrglossary.5488"></a><a href="#glo:markboth"><code class="csfmt">\markboth</code></a> or <a id="wrglossary.5489"></a><a href="#glo:@starttoc"><code class="csfmt">\@starttoc</code></a> otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>.<p>
+If you need to know whether or not some code is inside a contents list (but not the header), you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5490"></a><code class="code"><dfn id="glo:glsxtrifintoc"><code class="csfmt">\glsxtrifintoc</code></dfn>{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does <span class="meta">〈<em class="metainner">true</em>〉</span> if the command occurs within <a id="wrglossary.5491"></a><a href="#glo:@starttoc"><code class="csfmt">\@starttoc</code></a> otherwise it does <span class="meta">〈<em class="metainner">false</em>〉</span>. (The modified definition of <a id="wrglossary.5492"></a><a href="#glo:@starttoc"><code class="csfmt">\@starttoc</code></a> sets <a id="wrglossary.5493"></a><a href="#glo:glsxtrifintoc"><code class="csfmt">\glsxtrifintoc</code></a> to <a id="wrglossary.5494"></a><a href="#glo:@firstoftwo"><code class="csfmt">\@firstoftwo</code></a> at the start and to <a id="wrglossary.5495"></a><a href="#glo:@secondoftwo"><code class="csfmt">\@secondoftwo</code></a> at the end.)<p>
+If you need to know whether or not some code is in the PDF bookmarks or heading, you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5496"></a><code class="code"><dfn id="glo:glsxtrtitleorpdforheading"><code class="csfmt">\glsxtrtitleorpdforheading</code></dfn>{<span class="meta">〈<em class="metainner">title</em>〉</span>}{<span class="meta">〈<em class="metainner">PDF bookmarks</em>〉</span>}{<span class="meta">〈<em class="metainner">heading</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does the applicable argument depending on whether the command occurs within a title/caption or PDF bookmark or heading.<p>
+If this command occurs within the <a id="wrglossary.5497"></a><a href="#glo:ext.toc"><span class="extfmt">toc</span></a> file, it will do its <span class="meta">〈<em class="metainner">heading</em>〉</span> argument but if <a id="wrglossary.5498"></a><a href="#glo:glsxtrtitleorpdforheading"><code class="csfmt">\glsxtrtitleorpdforheading</code></a> expands while it’s being written to the <a id="wrglossary.5499"></a><a href="#glo:ext.toc"><span class="extfmt">toc</span></a> file, then it will expand to <span class="meta">〈<em class="metainner">title</em>〉</span>. This can be illustrated in the following document: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{report}
+<code class="cmd">\usepackage</code>{lipsum}
+<code class="cmd">\usepackage</code>{hyperref}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+<code class="cmd">\pagestyle</code>{headings}
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.5500"></a><a href="#glo:tableofcontents"><code class="csfmt">\tableofcontents</code></a>
+<code class="cmd">\chapter</code>{<a id="wrglossary.5501"></a><a href="#glo:glsxtrtitleorpdforheading"><code class="csfmt">\glsxtrtitleorpdforheading</code></a>{Title}{PDF}{Heading}
+<a id="wrglossary.5502"></a><a href="#glo:glsxtrifinmark"><code class="csfmt">\glsxtrifinmark</code></a>{in mark}{not in mark}}
+<code class="cmd">\lipsum</code>
+<code class="cmd">\chapter</code>{<code class="cmd">\protect</code><a id="wrglossary.5503"></a><a href="#glo:glsxtrtitleorpdforheading"><code class="csfmt">\glsxtrtitleorpdforheading</code></a>{Title}{PDF}{Heading}
+<code class="cmd">\protect</code><a id="wrglossary.5504"></a><a href="#glo:glsxtrifinmark"><code class="csfmt">\glsxtrifinmark</code></a>{in mark}{not in mark}}
+<code class="cmd">\lipsum</code>
+<code class="cend">\end{document}</code>
+</pre> In the first case, <a id="wrglossary.5505"></a><a href="#glo:glsxtrtitleorpdforheading"><code class="csfmt">\glsxtrtitleorpdforheading</code></a> expands as it’s being written to the <a id="wrglossary.5506"></a><a href="#glo:ext.toc"><span class="extfmt">toc</span></a> file, so it expands to <span class="qt">“Title”</span>. In the second case, <a id="wrglossary.5507"></a><a href="#glo:glsxtrtitleorpdforheading"><code class="csfmt">\glsxtrtitleorpdforheading</code></a> is protected so that command is written to the <a id="wrglossary.5508"></a><a href="#glo:ext.toc"><span class="extfmt">toc</span></a> file. On the next LaTeX, when the table of contents is displayed, this command will expand to <span class="qt">“Heading”</span>, because it’s in the <a id="wrglossary.5509"></a><a href="#glo:ext.toc"><span class="extfmt">toc</span></a> file. Similarly, in the first case, <a id="wrglossary.5510"></a><a href="#glo:glsxtrifinmark"><code class="csfmt">\glsxtrifinmark</code></a> will expand to <span class="qt">“not in mark”</span> as it’s written to the <a id="wrglossary.5511"></a><a href="#glo:ext.toc"><span class="extfmt">toc</span></a> file, but in the second case it’s expansion is prevented, so it will expand to <span class="qt">“in mark”</span> in the table of contents.<p>
+If <a id="wrglossary.5512"></a><a href="#glo:pkg.gettitlestring"><span class="styfmt">gettitlestring</span></a> has been loaded (used by <a id="wrglossary.5513"></a><a href="#glo:pkg.nameref"><span class="styfmt">nameref</span></a> to provide <a id="wrglossary.5514"></a><a href="#glo:nameref"><code class="csfmt">\nameref</code></a>) then adjustments for both <a id="wrglossary.5515"></a><a href="#glo:glsxtrtitleorpdforheading"><code class="csfmt">\glsxtrtitleorpdforheading</code></a> and <a id="wrglossary.5516"></a><a href="#glo:glsxtrifinmark"><code class="csfmt">\glsxtrifinmark</code></a> will be added to <a id="wrglossary.5517"></a><a href="#glo:GetTitleStringDisableCommands"><code class="csfmt">\GetTitleStringDisableCommands</code></a>, but bear in mind that you will need to use the following for it to have an effect: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.5518"></a><a href="#glo:GetTitleStringSetup"><code class="csfmt">\GetTitleStringSetup</code></a>{expand}
+</pre><p>
+The commands described in §<a href="#sec:headingcommands">5.3.2</a>, such as <a id="wrglossary.5519"></a><a href="#glo:glsfmtshort"><code class="csfmt">\glsfmtshort</code></a>, are essentially defined as: <pre class="compactcodebox"><a id="wrglossary.5520"></a><a href="#glo:texorpdfstring"><code class="csfmt">\texorpdfstring</code></a>
+ {<code class="cmd">\glsxtrtitle<span class="meta">〈<em class="metainner">field</em>〉</span></code>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}}<span class="comment">% title</span>
+ {<code class="cmd">\glsentry<span class="meta">〈<em class="metainner">field</em>〉</span></code>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}}<span class="comment">% bookmark</span>
+</pre> If <a id="wrglossary.5521"></a><a href="#glo:texorpdfstring"><code class="csfmt">\texorpdfstring</code></a> isn’t defined, then the definition is: <pre class="compactcodebox"><code class="cmd">\glsxtrtitle<span class="meta">〈<em class="metainner">field</em>〉</span></code>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}
+</pre> For example, <a id="wrglossary.5522"></a><a href="#glo:glsfmtshort"><code class="csfmt">\glsfmtshort</code></a> is defined as (with <a id="wrglossary.5523"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>): <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.5524"></a><a href="#glo:glsfmtshort"><code class="csfmt">\glsfmtshort</code></a>}[1]{%
+ <a id="wrglossary.5525"></a><a href="#glo:texorpdfstring"><code class="csfmt">\texorpdfstring</code></a>{<a id="wrglossary.5526"></a><a href="#glo:glsxtrtitleshort"><code class="csfmt">\glsxtrtitleshort</code></a>{#1}}{<a id="wrglossary.5527"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a>{#1}}%
}
-</pre>
-<!--l. 8583--><p class="nopar" > This will use the <a
-href="#catattr.combinedsep"><span
-class="cmss-10">combinedsep</span></a><a
- id="dx1-48002"></a> attribute for the &#x27E8;<span
-class="cmti-10">prev label</span>&#x27E9;&#8217;s category, if set. Otherwise
-this just does a space. Note that this ignores the second argument.
-</p><!--l. 8588--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-48003"></a> <span
-class="cmtt-10">\glscombinedfirstsep{</span>&#x27E8;<span
-class="cmitt-10">prev label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">next label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 8590--><p class="noindent" >
-This is inserted between two entries where only the next entry has been marked as
-used. The default definition is:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-204">
-\newcommand*{\glscombinedfirstsep}[2]{%
-&#x00A0;\glshasattribute{#1}{combinedfirstsep}%
-&#x00A0;{\glsgetattribute{#1}{combinedfirstsep}}%
-&#x00A0;{\glscombinedsep{#1}{#2}}%
+</pre> This ensures that <a id="wrglossary.5528"></a><a href="#glo:glsfmtshort"><code class="csfmt">\glsfmtshort</code></a> expands to just <a id="wrglossary.5529"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a> within the PDF bookmarks. Provided the field value doesn’t contain any problematic commands, this allows the actual value to be added to the bookmarks.<p>
+Unfortunately the case-changing commands can’t expand and therefore aren’t appropriate for the bookmarks (which need to be a PDF string). This means that the <a id="wrglossary.5530"></a><a href="#glo:idx.sentencecase">sentence case</a> and <a id="wrglossary.5531"></a><a href="#glo:idx.allcaps">all caps</a> commands also use the unmodified field value for the bookmark. For example, <a id="wrglossary.5532"></a><a href="#glo:Glsfmtshort"><code class="csfmt">\Glsfmtshort</code></a> is defined as: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.5533"></a><a href="#glo:Glsfmtshort"><code class="csfmt">\Glsfmtshort</code></a>}[1]{%
+ <a id="wrglossary.5534"></a><a href="#glo:texorpdfstring"><code class="csfmt">\texorpdfstring</code></a>{<a id="wrglossary.5535"></a><a href="#glo:Glsxtrtitleshort"><code class="csfmt">\Glsxtrtitleshort</code></a>{#1}}{<a id="wrglossary.5536"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a>{#1}}%
}
-</pre>
-<!--l. 8599--><p class="nopar" > This will use the <a
-href="#catattr.combinedfirstsep"><span
-class="cmss-10">combinedfirstsep</span></a><a
- id="dx1-48004"></a> attribute for &#x27E8;<span
-class="cmti-10">prev label</span>&#x27E9;&#8217;s category, if set. If that
-attribute isn&#8217;t set, <span
-class="cmtt-10">\glscombinedsep </span>is used.
-</p><!--l. 8604--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-48005"></a> <span
-class="cmtt-10">\glscombinedsepfirst{</span>&#x27E8;<span
-class="cmitt-10">prev label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">next label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 8606--><p class="noindent" >
-This is inserted between two entries where only the previous entry has been marked
-as used. The default definition is:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-205">
-\newcommand*{\glscombinedsepfirst}[2]{%
-&#x00A0;\glshasattribute{#1}{combinedsepfirst}%
-&#x00A0;{\glsgetattribute{#1}{combinedsepfirst}}%
-&#x00A0;{\glscombinedsep{#1}{#2}}%
+</pre><p>
+The <code class="csfmt">\glsxtrtitle<span class="meta">〈<em class="metainner">field</em>〉</span></code> set of commands all default to the corresponding <a id="wrglossary.5537"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> command with the options given by <a id="wrglossary.5538"></a><a href="#glo:glsxtrtitleopts"><code class="csfmt">\glsxtrtitleopts</code></a> and an empty insert final argument. These title commands are redefined by <a id="wrglossary.5539"></a><a href="#glo:glsxtrmarkhook"><code class="csfmt">\glsxtrmarkhook</code></a> to the corresponding <code class="csfmt">\glsxtrhead<span class="meta">〈<em class="metainner">field</em>〉</span></code> command. These <span class="qt">“head”</span> commands use <a id="wrglossary.5540"></a><a href="#glo:NoCaseChange"><code class="csfmt">\NoCaseChange</code></a> to prevent interference from page headers that convert to <a id="wrglossary.5541"></a><a href="#glo:idx.allcaps">all caps</a> (which can inappropriately convert the entry label to <a id="wrglossary.5542"></a><a href="#glo:idx.allcaps">all caps</a>). Instead, the <a id="wrglossary.5543"></a><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a> attribute needs to be set to <code class="code">true</code> to use the appropriate <a id="wrglossary.5544"></a><a href="#glo:idx.allcaps">all caps</a> command. A shortcut command is provided to test for this attribute: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5545"></a><code class="code"><dfn id="glo:glsxtrifheaduc"><code class="csfmt">\glsxtrifheaduc</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is defined as: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.5546"></a><a href="#glo:glsxtrifheaduc"><code class="csfmt">\glsxtrifheaduc</code></a>}[3]{%
+ <a id="wrglossary.5547"></a><a href="#glo:glsxtrifintoc"><code class="csfmt">\glsxtrifintoc</code></a>{#3}{<a id="wrglossary.5548"></a><a href="#glo:glsifattribute"><code class="csfmt">\glsifattribute</code></a>{#1}{<a id="wrglossary.5549"></a><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a>}{true}{#2}{#3}}%
}
-</pre>
-<!--l. 8615--><p class="nopar" > This will use the <a
-href="#catattr.combinedsepfirst"><span
-class="cmss-10">combinedsepfirst</span></a><a
- id="dx1-48006"></a> attribute for &#x27E8;<span
-class="cmti-10">prev label</span>&#x27E9;&#8217;s category, if set. If that
-attribute isn&#8217;t set, <span
-class="cmtt-10">\glscombinedsep </span>is used.
-</p><!--l. 8620--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-48007"></a> <span
-class="cmtt-10">\glscombinedfirstsepfirst{</span>&#x27E8;<span
-class="cmitt-10">prev label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">next label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 8622--><p class="noindent" >
-This is inserted between two entries where both have been marked as used. The
-default definition is:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-206">
-\newcommand*{\glscombinedfirstsepfirst}[2]{%
-&#x00A0;\glshasattribute{#1}{combinedfirstsepfirst}%
-&#x00A0;{\glsgetattribute{#1}{combinedfirstsepfirst}}%
-&#x00A0;{\glscombinedsep{#1}{#2}}%
+</pre> Since the header commands also end up in the contents, where the <a id="wrglossary.5550"></a><a href="#glo:idx.allcaps">all caps</a> conversion should not be applied, the definition includes <a id="wrglossary.5551"></a><a href="#glo:glsxtrifintoc"><code class="csfmt">\glsxtrifintoc</code></a> to skip the check in the contents.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5552"></a><code class="code"><dfn id="glo:glsxtrtitleshort"><code class="csfmt">\glsxtrtitleshort</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The normal behaviour of <a id="wrglossary.5553"></a><a href="#glo:glsfmtshort"><code class="csfmt">\glsfmtshort</code></a>. This is redefined by <a id="wrglossary.5554"></a><a href="#glo:glsxtrmarkhook"><code class="csfmt">\glsxtrmarkhook</code></a> to <a id="wrglossary.5555"></a><a href="#glo:glsxtrheadshort"><code class="csfmt">\glsxtrheadshort</code></a>. The default is: <pre class="compactcodebox"><a id="wrglossary.5556"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>[<a id="wrglossary.5557"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a>,<a id="wrglossary.5558"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[]
+</pre> (This is performed indirectly via an internal command that ensures that <a id="wrglossary.5559"></a><a href="#glo:glsxtrtitleopts"><code class="csfmt">\glsxtrtitleopts</code></a> is expanded before being passed in the optional argument.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5560"></a><code class="code"><dfn id="glo:glsxtrheadshort"><code class="csfmt">\glsxtrheadshort</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Used to display the short form in the page header. This is defined as: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.5561"></a><a href="#glo:glsxtrheadshort"><code class="csfmt">\glsxtrheadshort</code></a>}[1]{%
+ <code class="cmd">\protect</code><a id="wrglossary.5562"></a><a href="#glo:NoCaseChange"><code class="csfmt">\NoCaseChange</code></a>
+ {%
+ <a id="wrglossary.5563"></a><a href="#glo:glsifattribute"><code class="csfmt">\glsifattribute</code></a>{#1}{<a id="wrglossary.5564"></a><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a>}{true}%
+ {%
+ <a id="wrglossary.5565"></a><a href="#glo:GLSxtrshort"><code class="csfmt">\GLSxtrshort</code></a>[<a id="wrglossary.5566"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a>,<a id="wrglossary.5567"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span>]{#1}[]%
+ }%
+ {%
+ <a id="wrglossary.5568"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>[<a id="wrglossary.5569"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a>,<a id="wrglossary.5570"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span>]{#1}[]%
+ }%
+ }%
}
-</pre>
-<!--l. 8631--><p class="nopar" > This will use the <a
-href="#catattr.combinedfirstsepfirst"><span
-class="cmss-10">combinedfirstsepfirst</span></a><a
- id="dx1-48008"></a> attribute for &#x27E8;<span
-class="cmti-10">prev label</span>&#x27E9;&#8217;s category, if set. If that
-attribute isn&#8217;t set, <span
-class="cmtt-10">\glscombinedsep </span>is used.
-</p><!--l. 8636--><p class="indent" > These commands may be redefined as required. For example, to have no space
-between two elements that have both been marked as used and are both
-abbreviations (disregarding category attributes):
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-207">
-\renewcommand*{\glscombinedfirstsepfirst}[2]{%
-&#x00A0;\ifglshasshort{#1}{\ifglshasshort{#2}{}{\space}}{\space}%
+</pre> The <a id="wrglossary.5571"></a><a href="#glo:idx.sentencecase">sentence case</a> commands also check the <a id="wrglossary.5572"></a><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a> attribute.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5573"></a><code class="code"><dfn id="glo:Glsxtrtitleshort"><code class="csfmt">\Glsxtrtitleshort</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The normal behaviour of <a id="wrglossary.5574"></a><a href="#glo:Glsfmtshort"><code class="csfmt">\Glsfmtshort</code></a>. This is redefined by <a id="wrglossary.5575"></a><a href="#glo:glsxtrmarkhook"><code class="csfmt">\glsxtrmarkhook</code></a> to <a id="wrglossary.5576"></a><a href="#glo:Glsxtrheadshort"><code class="csfmt">\Glsxtrheadshort</code></a>. The default is: <pre class="compactcodebox"><a id="wrglossary.5577"></a><a href="#glo:Glsxtrshort"><code class="csfmt">\Glsxtrshort</code></a>[<a id="wrglossary.5578"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a>,<a id="wrglossary.5579"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[]
+</pre> (Again, this is performed indirectly via an internal command that ensures that <a id="wrglossary.5580"></a><a href="#glo:glsxtrtitleopts"><code class="csfmt">\glsxtrtitleopts</code></a> is expanded before being passed in the optional argument.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5581"></a><code class="code"><dfn id="glo:Glsxtrheadshort"><code class="csfmt">\Glsxtrheadshort</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Used to display the <a id="wrglossary.5582"></a><a href="#glo:idx.sentencecase">sentence case</a> short form in the page header. This is defined as: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.5583"></a><a href="#glo:Glsxtrheadshort"><code class="csfmt">\Glsxtrheadshort</code></a>}[1]{%
+ <code class="cmd">\protect</code><a id="wrglossary.5584"></a><a href="#glo:NoCaseChange"><code class="csfmt">\NoCaseChange</code></a>
+ {%
+ <a id="wrglossary.5585"></a><a href="#glo:glsifattribute"><code class="csfmt">\glsifattribute</code></a>{#1}{<a id="wrglossary.5586"></a><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a>}{true}%
+ {%
+ <a id="wrglossary.5587"></a><a href="#glo:GLSxtrshort"><code class="csfmt">\GLSxtrshort</code></a>[<a id="wrglossary.5588"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a>,<a id="wrglossary.5589"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span>]{#1}[]%
+ }%
+ {%
+ <a id="wrglossary.5590"></a><a href="#glo:Glsxtrshort"><code class="csfmt">\Glsxtrshort</code></a>[<a id="wrglossary.5591"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a>,<a id="wrglossary.5592"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span>]{#1}[]%
+ }%
+ }%
}
-</pre>
-<!--l. 8644--><p class="nopar" >
-</p><!--l. 8646--><p class="indent" > There are some commands for redefining the above separators to common
-combinations.
-</p><!--l. 8649--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-48009"></a> <span
-class="cmtt-10">\glssetcombinedsepabbrvnbsp </span></div><hr>
-</p><!--l. 8651--><p class="noindent" >
-This does the following:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-208">
-\renewcommand*{\glscombinedsep}[2]{%
-&#x00A0;\glshasattribute{#1}{combinedsep}%
-&#x00A0;{\glsgetattribute{#1}{combinedsep}}%
-&#x00A0;{\ifhasshort{#1}{~}{&#x00A0;}}%
-}%
-\renewcommand*{\glscombinedsepfirst}[2]{%
-&#x00A0;\glshasattribute{##1}{combinedsepfirst}%
-&#x00A0;{\glsgetattribute{##1}{combinedsepfirst}}%
-&#x00A0;{\ifhasshort{#1}{~}{&#x00A0;}}%
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5593"></a><code class="code"><dfn id="glo:GLSxtrtitleshort"><code class="csfmt">\GLSxtrtitleshort</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The normal behaviour of <a id="wrglossary.5594"></a><a href="#glo:GLSfmtshort"><code class="csfmt">\GLSfmtshort</code></a>. This is redefined by <a id="wrglossary.5595"></a><a href="#glo:glsxtrmarkhook"><code class="csfmt">\glsxtrmarkhook</code></a> to <a id="wrglossary.5596"></a><a href="#glo:GLSxtrheadshort"><code class="csfmt">\GLSxtrheadshort</code></a>. The default uses <a id="wrglossary.5597"></a><a href="#glo:GLSxtrshort"><code class="csfmt">\GLSxtrshort</code></a> in a similar way to <a id="wrglossary.5598"></a><a href="#glo:glsxtrtitleshort"><code class="csfmt">\glsxtrtitleshort</code></a> and <a id="wrglossary.5599"></a><a href="#glo:Glsxtrtitleshort"><code class="csfmt">\Glsxtrtitleshort</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5600"></a><code class="code"><dfn id="glo:GLSxtrheadshort"><code class="csfmt">\GLSxtrheadshort</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Used to display the <a id="wrglossary.5601"></a><a href="#glo:idx.allcaps">all caps</a> short form in the page header. In this case, there’s no need to check to the <a id="wrglossary.5602"></a><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a> attribute, but the label needs to be protected from any potential case-change: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.5603"></a><a href="#glo:GLSxtrheadshort"><code class="csfmt">\GLSxtrheadshort</code></a>}[1]{%
+ <code class="cmd">\protect</code><a id="wrglossary.5604"></a><a href="#glo:NoCaseChange"><code class="csfmt">\NoCaseChange</code></a>
+ {%
+ <a id="wrglossary.5605"></a><a href="#glo:GLSxtrshort"><code class="csfmt">\GLSxtrshort</code></a>[<a id="wrglossary.5606"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a>,<a id="wrglossary.5607"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span>]{#1}[]%
+ }%
+}
+</pre><p>
+All the similar commands listed below are defined in an analogous way, except for the <a id="wrglossary.5608"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a> commands, where only the <a id="wrglossary.5609"></a><a href="#glo:idx.sentencecase">sentence case</a> title version is provided. This is because commands like <a id="wrglossary.5610"></a><a href="#glo:Pglsfmtshort"><code class="csfmt">\Pglsfmtshort</code></a> have to determine whether or not to use <a id="wrglossary.5611"></a><a href="#glo:glsfmtshort"><code class="csfmt">\glsfmtshort</code></a> or <a id="wrglossary.5612"></a><a href="#glo:Glsfmtshort"><code class="csfmt">\Glsfmtshort</code></a> depending on whether or not the prefix has been set. Whereas commands like <a id="wrglossary.5613"></a><a href="#glo:pglsfmtshort"><code class="csfmt">\pglsfmtshort</code></a> simply need to insert the prefix and separator if set and then use the corresponding <a id="wrglossary.5614"></a><a href="#glo:glsfmtshort"><code class="csfmt">\glsfmtshort</code></a>. <p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5615"></a><code class="code"><dfn id="glo:Pglsxtrtitleshort"><code class="csfmt">\Pglsxtrtitleshort</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ The normal behaviour of <a id="wrglossary.5616"></a><a href="#glo:Pglsfmtshort"><code class="csfmt">\Pglsfmtshort</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5617"></a><code class="code"><dfn id="glo:Pglsxtrtitleshortpl"><code class="csfmt">\Pglsxtrtitleshortpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ The normal behaviour of <a id="wrglossary.5618"></a><a href="#glo:Pglsfmtshortpl"><code class="csfmt">\Pglsfmtshortpl</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5619"></a><code class="code"><dfn id="glo:Pglsxtrtitlelong"><code class="csfmt">\Pglsxtrtitlelong</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ The normal behaviour of <a id="wrglossary.5620"></a><a href="#glo:Pglsfmtlong"><code class="csfmt">\Pglsfmtlong</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5621"></a><code class="code"><dfn id="glo:Pglsxtrtitlelongpl"><code class="csfmt">\Pglsxtrtitlelongpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ The normal behaviour of <a id="wrglossary.5622"></a><a href="#glo:Pglsfmtlongpl"><code class="csfmt">\Pglsfmtlongpl</code></a>.<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5623"></a><code class="code"><dfn id="glo:glsxtrtitleshortpl"><code class="csfmt">\glsxtrtitleshortpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title plural short form. (Normal behaviour of <a id="wrglossary.5624"></a><a href="#glo:glsfmtshortpl"><code class="csfmt">\glsfmtshortpl</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5625"></a><code class="code"><dfn id="glo:glsxtrheadshortpl"><code class="csfmt">\glsxtrheadshortpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header plural short form. (The behaviour of <a id="wrglossary.5626"></a><a href="#glo:glsfmtshortpl"><code class="csfmt">\glsfmtshortpl</code></a> when it occurs in a header.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5627"></a><code class="code"><dfn id="glo:Glsxtrtitleshortpl"><code class="csfmt">\Glsxtrtitleshortpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title plural <a id="wrglossary.5628"></a><a href="#glo:idx.sentencecase">sentence case</a> short form. (Normal behaviour of <a id="wrglossary.5629"></a><a href="#glo:Glsfmtshortpl"><code class="csfmt">\Glsfmtshortpl</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5630"></a><code class="code"><dfn id="glo:Glsxtrheadshortpl"><code class="csfmt">\Glsxtrheadshortpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header plural <a id="wrglossary.5631"></a><a href="#glo:idx.sentencecase">sentence case</a> short form. (The behaviour of <a id="wrglossary.5632"></a><a href="#glo:Glsfmtshortpl"><code class="csfmt">\Glsfmtshortpl</code></a> when it occurs in a header.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5633"></a><code class="code"><dfn id="glo:GLSxtrtitleshortpl"><code class="csfmt">\GLSxtrtitleshortpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title plural <a id="wrglossary.5634"></a><a href="#glo:idx.allcaps">all caps</a> short form. (Normal behaviour of <a id="wrglossary.5635"></a><a href="#glo:GLSfmtshortpl"><code class="csfmt">\GLSfmtshortpl</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5636"></a><code class="code"><dfn id="glo:GLSxtrheadshortpl"><code class="csfmt">\GLSxtrheadshortpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header plural <a id="wrglossary.5637"></a><a href="#glo:idx.allcaps">all caps</a> short form. (The behaviour of <a id="wrglossary.5638"></a><a href="#glo:GLSfmtshortpl"><code class="csfmt">\GLSfmtshortpl</code></a> when it occurs in a header.)<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5639"></a><code class="code"><dfn id="glo:glsxtrtitlelong"><code class="csfmt">\glsxtrtitlelong</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title long form. (Normal behaviour of <a id="wrglossary.5640"></a><a href="#glo:glsfmtlong"><code class="csfmt">\glsfmtlong</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5641"></a><code class="code"><dfn id="glo:glsxtrheadlong"><code class="csfmt">\glsxtrheadlong</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header long form. (The behaviour of <a id="wrglossary.5642"></a><a href="#glo:glsfmtlong"><code class="csfmt">\glsfmtlong</code></a> when it occurs in a header.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5643"></a><code class="code"><dfn id="glo:Glsxtrtitlelong"><code class="csfmt">\Glsxtrtitlelong</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title <a id="wrglossary.5644"></a><a href="#glo:idx.sentencecase">sentence case</a> long form. (Normal behaviour of <a id="wrglossary.5645"></a><a href="#glo:Glsfmtlong"><code class="csfmt">\Glsfmtlong</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5646"></a><code class="code"><dfn id="glo:Glsxtrheadlong"><code class="csfmt">\Glsxtrheadlong</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header <a id="wrglossary.5647"></a><a href="#glo:idx.sentencecase">sentence case</a> long form. (The behaviour of <a id="wrglossary.5648"></a><a href="#glo:Glsfmtlong"><code class="csfmt">\Glsfmtlong</code></a> when it occurs in a header.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5649"></a><code class="code"><dfn id="glo:GLSxtrtitlelong"><code class="csfmt">\GLSxtrtitlelong</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title <a id="wrglossary.5650"></a><a href="#glo:idx.allcaps">all caps</a> long form. (Normal behaviour of <a id="wrglossary.5651"></a><a href="#glo:GLSfmtlong"><code class="csfmt">\GLSfmtlong</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5652"></a><code class="code"><dfn id="glo:GLSxtrheadlong"><code class="csfmt">\GLSxtrheadlong</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header <a id="wrglossary.5653"></a><a href="#glo:idx.allcaps">all caps</a> long form. (The behaviour of <a id="wrglossary.5654"></a><a href="#glo:GLSfmtlong"><code class="csfmt">\GLSfmtlong</code></a> when it occurs in a header.)<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5655"></a><code class="code"><dfn id="glo:glsxtrtitlelongpl"><code class="csfmt">\glsxtrtitlelongpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title plural long form. (Normal behaviour of <a id="wrglossary.5656"></a><a href="#glo:glsfmtlongpl"><code class="csfmt">\glsfmtlongpl</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5657"></a><code class="code"><dfn id="glo:glsxtrheadlongpl"><code class="csfmt">\glsxtrheadlongpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header plural long form. (The behaviour of <a id="wrglossary.5658"></a><a href="#glo:glsfmtlongpl"><code class="csfmt">\glsfmtlongpl</code></a> when it occurs in a header.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5659"></a><code class="code"><dfn id="glo:Glsxtrtitlelongpl"><code class="csfmt">\Glsxtrtitlelongpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title plural <a id="wrglossary.5660"></a><a href="#glo:idx.sentencecase">sentence case</a> long form. (Normal behaviour of <a id="wrglossary.5661"></a><a href="#glo:Glsfmtlongpl"><code class="csfmt">\Glsfmtlongpl</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5662"></a><code class="code"><dfn id="glo:Glsxtrheadlongpl"><code class="csfmt">\Glsxtrheadlongpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header plural <a id="wrglossary.5663"></a><a href="#glo:idx.sentencecase">sentence case</a> long form. (The behaviour of <a id="wrglossary.5664"></a><a href="#glo:Glsfmtlongpl"><code class="csfmt">\Glsfmtlongpl</code></a> when it occurs in a header.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5665"></a><code class="code"><dfn id="glo:GLSxtrtitlelongpl"><code class="csfmt">\GLSxtrtitlelongpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title plural <a id="wrglossary.5666"></a><a href="#glo:idx.allcaps">all caps</a> long form. (Normal behaviour of <a id="wrglossary.5667"></a><a href="#glo:GLSfmtlongpl"><code class="csfmt">\GLSfmtlongpl</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5668"></a><code class="code"><dfn id="glo:GLSxtrheadlongpl"><code class="csfmt">\GLSxtrheadlongpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header plural <a id="wrglossary.5669"></a><a href="#glo:idx.allcaps">all caps</a> long form. (The behaviour of <a id="wrglossary.5670"></a><a href="#glo:GLSfmtlongpl"><code class="csfmt">\GLSfmtlongpl</code></a> when it occurs in a header.)<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5671"></a><code class="code"><dfn id="glo:glsxtrtitlefull"><code class="csfmt">\glsxtrtitlefull</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title full form. (Normal behaviour of <a id="wrglossary.5672"></a><a href="#glo:glsfmtfull"><code class="csfmt">\glsfmtfull</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5673"></a><code class="code"><dfn id="glo:glsxtrheadfull"><code class="csfmt">\glsxtrheadfull</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header full form. (The behaviour of <a id="wrglossary.5674"></a><a href="#glo:glsfmtfull"><code class="csfmt">\glsfmtfull</code></a> when it occurs in a header.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5675"></a><code class="code"><dfn id="glo:Glsxtrtitlefull"><code class="csfmt">\Glsxtrtitlefull</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title <a id="wrglossary.5676"></a><a href="#glo:idx.sentencecase">sentence case</a> full form. (Normal behaviour of <a id="wrglossary.5677"></a><a href="#glo:Glsfmtfull"><code class="csfmt">\Glsfmtfull</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5678"></a><code class="code"><dfn id="glo:Glsxtrheadfull"><code class="csfmt">\Glsxtrheadfull</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header <a id="wrglossary.5679"></a><a href="#glo:idx.sentencecase">sentence case</a> full form. (The behaviour of <a id="wrglossary.5680"></a><a href="#glo:Glsfmtfull"><code class="csfmt">\Glsfmtfull</code></a> when it occurs in a header.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5681"></a><code class="code"><dfn id="glo:GLSxtrtitlefull"><code class="csfmt">\GLSxtrtitlefull</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title <a id="wrglossary.5682"></a><a href="#glo:idx.allcaps">all caps</a> full form. (Normal behaviour of <a id="wrglossary.5683"></a><a href="#glo:GLSfmtfull"><code class="csfmt">\GLSfmtfull</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5684"></a><code class="code"><dfn id="glo:GLSxtrheadfull"><code class="csfmt">\GLSxtrheadfull</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header <a id="wrglossary.5685"></a><a href="#glo:idx.allcaps">all caps</a> full form. (The behaviour of <a id="wrglossary.5686"></a><a href="#glo:GLSfmtfull"><code class="csfmt">\GLSfmtfull</code></a> when it occurs in a header.)<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5687"></a><code class="code"><dfn id="glo:glsxtrtitlefullpl"><code class="csfmt">\glsxtrtitlefullpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title plural full form. (Normal behaviour of <a id="wrglossary.5688"></a><a href="#glo:glsfmtfullpl"><code class="csfmt">\glsfmtfullpl</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5689"></a><code class="code"><dfn id="glo:glsxtrheadfullpl"><code class="csfmt">\glsxtrheadfullpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header plural full form. (The behaviour of <a id="wrglossary.5690"></a><a href="#glo:glsfmtfullpl"><code class="csfmt">\glsfmtfullpl</code></a> when it occurs in a header.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5691"></a><code class="code"><dfn id="glo:Glsxtrtitlefullpl"><code class="csfmt">\Glsxtrtitlefullpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title plural <a id="wrglossary.5692"></a><a href="#glo:idx.sentencecase">sentence case</a> full form. (Normal behaviour of <a id="wrglossary.5693"></a><a href="#glo:Glsfmtfullpl"><code class="csfmt">\Glsfmtfullpl</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5694"></a><code class="code"><dfn id="glo:Glsxtrheadfullpl"><code class="csfmt">\Glsxtrheadfullpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header plural <a id="wrglossary.5695"></a><a href="#glo:idx.sentencecase">sentence case</a> full form. (The behaviour of <a id="wrglossary.5696"></a><a href="#glo:Glsfmtfullpl"><code class="csfmt">\Glsfmtfullpl</code></a> when it occurs in a header.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5697"></a><code class="code"><dfn id="glo:GLSxtrtitlefullpl"><code class="csfmt">\GLSxtrtitlefullpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title plural <a id="wrglossary.5698"></a><a href="#glo:idx.allcaps">all caps</a> full form. (Normal behaviour of <a id="wrglossary.5699"></a><a href="#glo:GLSfmtfullpl"><code class="csfmt">\GLSfmtfullpl</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5700"></a><code class="code"><dfn id="glo:GLSxtrheadfullpl"><code class="csfmt">\GLSxtrheadfullpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header plural <a id="wrglossary.5701"></a><a href="#glo:idx.allcaps">all caps</a> full form. (The behaviour of <a id="wrglossary.5702"></a><a href="#glo:GLSfmtfullpl"><code class="csfmt">\GLSfmtfullpl</code></a> when it occurs in a header.)<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5703"></a><code class="code"><dfn id="glo:glsxtrtitlename"><code class="csfmt">\glsxtrtitlename</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title <a id="wrglossary.5704"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field. (Normal behaviour of <a id="wrglossary.5705"></a><a href="#glo:glsfmtname"><code class="csfmt">\glsfmtname</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5706"></a><code class="code"><dfn id="glo:glsxtrheadname"><code class="csfmt">\glsxtrheadname</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header <a id="wrglossary.5707"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field. (The behaviour of <a id="wrglossary.5708"></a><a href="#glo:glsfmtname"><code class="csfmt">\glsfmtname</code></a> when it occurs in a header.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5709"></a><code class="code"><dfn id="glo:Glsxtrtitlename"><code class="csfmt">\Glsxtrtitlename</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title <a id="wrglossary.5710"></a><a href="#glo:idx.sentencecase">sentence case</a> <a id="wrglossary.5711"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field. (Normal behaviour of <a id="wrglossary.5712"></a><a href="#glo:Glsfmtname"><code class="csfmt">\Glsfmtname</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5713"></a><code class="code"><dfn id="glo:Glsxtrheadname"><code class="csfmt">\Glsxtrheadname</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header <a id="wrglossary.5714"></a><a href="#glo:idx.sentencecase">sentence case</a> <a id="wrglossary.5715"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field. (The behaviour of <a id="wrglossary.5716"></a><a href="#glo:Glsfmtname"><code class="csfmt">\Glsfmtname</code></a> when it occurs in a header.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5717"></a><code class="code"><dfn id="glo:GLSxtrtitlename"><code class="csfmt">\GLSxtrtitlename</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title <a id="wrglossary.5718"></a><a href="#glo:idx.allcaps">all caps</a> <a id="wrglossary.5719"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field. (Normal behaviour of <a id="wrglossary.5720"></a><a href="#glo:GLSfmtname"><code class="csfmt">\GLSfmtname</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5721"></a><code class="code"><dfn id="glo:GLSxtrheadname"><code class="csfmt">\GLSxtrheadname</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header <a id="wrglossary.5722"></a><a href="#glo:idx.allcaps">all caps</a> <a id="wrglossary.5723"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field. (The behaviour of <a id="wrglossary.5724"></a><a href="#glo:GLSfmtname"><code class="csfmt">\GLSfmtname</code></a> when it occurs in a header.)<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5725"></a><code class="code"><dfn id="glo:glsxtrtitletext"><code class="csfmt">\glsxtrtitletext</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title <a id="wrglossary.5726"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field. (Normal behaviour of <a id="wrglossary.5727"></a><a href="#glo:glsfmttext"><code class="csfmt">\glsfmttext</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5728"></a><code class="code"><dfn id="glo:glsxtrheadtext"><code class="csfmt">\glsxtrheadtext</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header <a id="wrglossary.5729"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field. (The behaviour of <a id="wrglossary.5730"></a><a href="#glo:glsfmttext"><code class="csfmt">\glsfmttext</code></a> when it occurs in a header.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5731"></a><code class="code"><dfn id="glo:Glsxtrtitletext"><code class="csfmt">\Glsxtrtitletext</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title <a id="wrglossary.5732"></a><a href="#glo:idx.sentencecase">sentence case</a> <a id="wrglossary.5733"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field. (Normal behaviour of <a id="wrglossary.5734"></a><a href="#glo:Glsfmttext"><code class="csfmt">\Glsfmttext</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5735"></a><code class="code"><dfn id="glo:Glsxtrheadtext"><code class="csfmt">\Glsxtrheadtext</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header <a id="wrglossary.5736"></a><a href="#glo:idx.sentencecase">sentence case</a> <a id="wrglossary.5737"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field. (The behaviour of <a id="wrglossary.5738"></a><a href="#glo:Glsfmttext"><code class="csfmt">\Glsfmttext</code></a> when it occurs in a header.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5739"></a><code class="code"><dfn id="glo:GLSxtrtitletext"><code class="csfmt">\GLSxtrtitletext</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title <a id="wrglossary.5740"></a><a href="#glo:idx.allcaps">all caps</a> <a id="wrglossary.5741"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field. (Normal behaviour of <a id="wrglossary.5742"></a><a href="#glo:GLSfmttext"><code class="csfmt">\GLSfmttext</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5743"></a><code class="code"><dfn id="glo:GLSxtrheadtext"><code class="csfmt">\GLSxtrheadtext</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header <a id="wrglossary.5744"></a><a href="#glo:idx.allcaps">all caps</a> <a id="wrglossary.5745"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field. (The behaviour of <a id="wrglossary.5746"></a><a href="#glo:GLSfmttext"><code class="csfmt">\GLSfmttext</code></a> when it occurs in a header.)<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5747"></a><code class="code"><dfn id="glo:glsxtrtitleplural"><code class="csfmt">\glsxtrtitleplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title <a id="wrglossary.5748"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> field. (Normal behaviour of <a id="wrglossary.5749"></a><a href="#glo:glsfmtplural"><code class="csfmt">\glsfmtplural</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5750"></a><code class="code"><dfn id="glo:glsxtrheadplural"><code class="csfmt">\glsxtrheadplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header <a id="wrglossary.5751"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> field. (The behaviour of <a id="wrglossary.5752"></a><a href="#glo:glsfmtplural"><code class="csfmt">\glsfmtplural</code></a> when it occurs in a header.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5753"></a><code class="code"><dfn id="glo:Glsxtrtitleplural"><code class="csfmt">\Glsxtrtitleplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title <a id="wrglossary.5754"></a><a href="#glo:idx.sentencecase">sentence case</a> <a id="wrglossary.5755"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> field. (Normal behaviour of <a id="wrglossary.5756"></a><a href="#glo:Glsfmtplural"><code class="csfmt">\Glsfmtplural</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5757"></a><code class="code"><dfn id="glo:Glsxtrheadplural"><code class="csfmt">\Glsxtrheadplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header <a id="wrglossary.5758"></a><a href="#glo:idx.sentencecase">sentence case</a> <a id="wrglossary.5759"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> field. (The behaviour of <a id="wrglossary.5760"></a><a href="#glo:Glsfmtplural"><code class="csfmt">\Glsfmtplural</code></a> when it occurs in a header.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5761"></a><code class="code"><dfn id="glo:GLSxtrtitleplural"><code class="csfmt">\GLSxtrtitleplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title <a id="wrglossary.5762"></a><a href="#glo:idx.allcaps">all caps</a> <a id="wrglossary.5763"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> field. (Normal behaviour of <a id="wrglossary.5764"></a><a href="#glo:GLSfmtplural"><code class="csfmt">\GLSfmtplural</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5765"></a><code class="code"><dfn id="glo:GLSxtrheadplural"><code class="csfmt">\GLSxtrheadplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header <a id="wrglossary.5766"></a><a href="#glo:idx.allcaps">all caps</a> <a id="wrglossary.5767"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> field. (The behaviour of <a id="wrglossary.5768"></a><a href="#glo:GLSfmtplural"><code class="csfmt">\GLSfmtplural</code></a> when it occurs in a header.)<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5769"></a><code class="code"><dfn id="glo:glsxtrtitlefirst"><code class="csfmt">\glsxtrtitlefirst</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title <a id="wrglossary.5770"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> field. (Normal behaviour of <a id="wrglossary.5771"></a><a href="#glo:glsfmtfirst"><code class="csfmt">\glsfmtfirst</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5772"></a><code class="code"><dfn id="glo:glsxtrheadfirst"><code class="csfmt">\glsxtrheadfirst</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header <a id="wrglossary.5773"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> field. (The behaviour of <a id="wrglossary.5774"></a><a href="#glo:glsfmtfirst"><code class="csfmt">\glsfmtfirst</code></a> when it occurs in a header.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5775"></a><code class="code"><dfn id="glo:Glsxtrtitlefirst"><code class="csfmt">\Glsxtrtitlefirst</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title <a id="wrglossary.5776"></a><a href="#glo:idx.sentencecase">sentence case</a> <a id="wrglossary.5777"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> field. (Normal behaviour of <a id="wrglossary.5778"></a><a href="#glo:Glsfmtfirst"><code class="csfmt">\Glsfmtfirst</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5779"></a><code class="code"><dfn id="glo:Glsxtrheadfirst"><code class="csfmt">\Glsxtrheadfirst</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header <a id="wrglossary.5780"></a><a href="#glo:idx.sentencecase">sentence case</a> <a id="wrglossary.5781"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> field. (The behaviour of <a id="wrglossary.5782"></a><a href="#glo:Glsfmtfirst"><code class="csfmt">\Glsfmtfirst</code></a> when it occurs in a header.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5783"></a><code class="code"><dfn id="glo:GLSxtrtitlefirst"><code class="csfmt">\GLSxtrtitlefirst</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title <a id="wrglossary.5784"></a><a href="#glo:idx.allcaps">all caps</a> <a id="wrglossary.5785"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> field. (Normal behaviour of <a id="wrglossary.5786"></a><a href="#glo:GLSfmtfirst"><code class="csfmt">\GLSfmtfirst</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5787"></a><code class="code"><dfn id="glo:GLSxtrheadfirst"><code class="csfmt">\GLSxtrheadfirst</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header <a id="wrglossary.5788"></a><a href="#glo:idx.allcaps">all caps</a> <a id="wrglossary.5789"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> field. (The behaviour of <a id="wrglossary.5790"></a><a href="#glo:GLSfmtfirst"><code class="csfmt">\GLSfmtfirst</code></a> when it occurs in a header.)<p>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5791"></a><code class="code"><dfn id="glo:glsxtrtitlefirstplural"><code class="csfmt">\glsxtrtitlefirstplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title <a id="wrglossary.5792"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> field. (Normal behaviour of <a id="wrglossary.5793"></a><a href="#glo:glsfmtfirstpl"><code class="csfmt">\glsfmtfirstpl</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5794"></a><code class="code"><dfn id="glo:glsxtrheadfirstplural"><code class="csfmt">\glsxtrheadfirstplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header <a id="wrglossary.5795"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> field. (The behaviour of <a id="wrglossary.5796"></a><a href="#glo:glsfmtfirstpl"><code class="csfmt">\glsfmtfirstpl</code></a> when it occurs in a header.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5797"></a><code class="code"><dfn id="glo:Glsxtrtitlefirstplural"><code class="csfmt">\Glsxtrtitlefirstplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title <a id="wrglossary.5798"></a><a href="#glo:idx.sentencecase">sentence case</a> <a id="wrglossary.5799"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> field. (Normal behaviour of <a id="wrglossary.5800"></a><a href="#glo:Glsfmtfirstpl"><code class="csfmt">\Glsfmtfirstpl</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5801"></a><code class="code"><dfn id="glo:Glsxtrheadfirstplural"><code class="csfmt">\Glsxtrheadfirstplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header <a id="wrglossary.5802"></a><a href="#glo:idx.sentencecase">sentence case</a> <a id="wrglossary.5803"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> field. (The behaviour of <a id="wrglossary.5804"></a><a href="#glo:Glsfmtfirstpl"><code class="csfmt">\Glsfmtfirstpl</code></a> when it occurs in a header.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5805"></a><code class="code"><dfn id="glo:GLSxtrtitlefirstplural"><code class="csfmt">\GLSxtrtitlefirstplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The title <a id="wrglossary.5806"></a><a href="#glo:idx.allcaps">all caps</a> <a id="wrglossary.5807"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> field. (Normal behaviour of <a id="wrglossary.5808"></a><a href="#glo:GLSfmtfirstpl"><code class="csfmt">\GLSfmtfirstpl</code></a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5809"></a><code class="code"><dfn id="glo:GLSxtrheadfirstplural"><code class="csfmt">\GLSxtrheadfirstplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The header <a id="wrglossary.5810"></a><a href="#glo:idx.allcaps">all caps</a> <a id="wrglossary.5811"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> field. (The behaviour of <a id="wrglossary.5812"></a><a href="#glo:GLSfmtfirstpl"><code class="csfmt">\GLSfmtfirstpl</code></a> when it occurs in a header.)<p>
+The definitions of <a id="wrglossary.5813"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a>, <a id="wrglossary.5814"></a><a href="#glo:markboth"><code class="csfmt">\markboth</code></a> and <a id="wrglossary.5815"></a><a href="#glo:@starttoc"><code class="csfmt">\@starttoc</code></a> are saved (using <a id="wrglossary.5816"></a><a href="#glo:let"><code class="csfmt">\let</code></a>) when <a id="wrglossary.5817"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> loads. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5818"></a><code class="code"><dfn id="glo:@glsxtr@org@markright"><code class="csfmt">\@glsxtr@org@markright</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The previous definition of <a id="wrglossary.5819"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5820"></a><code class="code"><dfn id="glo:@glsxtr@org@markboth"><code class="csfmt">\@glsxtr@org@markboth</code></dfn>{<span class="meta">〈<em class="metainner">left text</em>〉</span>}{<span class="meta">〈<em class="metainner">right text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The previous definition of <a id="wrglossary.5821"></a><a href="#glo:markboth"><code class="csfmt">\markboth</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5822"></a><code class="code"><dfn id="glo:@glsxtr@org@@starttoc"><code class="csfmt">\@glsxtr@org@@starttoc</code></dfn>{<span class="meta">〈<em class="metainner">toc</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The previous definition of <a id="wrglossary.5823"></a><a href="#glo:@starttoc"><code class="csfmt">\@starttoc</code></a>.<p>
+The <a id="wrglossary.5824"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> definitions of <a id="wrglossary.5825"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a>, <a id="wrglossary.5826"></a><a href="#glo:markboth"><code class="csfmt">\markboth</code></a> and <a id="wrglossary.5827"></a><a href="#glo:@starttoc"><code class="csfmt">\@starttoc</code></a> all start and end with hooks that redefine commands that are sensitive to being in the header or contents. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5828"></a><code class="code"><dfn id="glo:glsxtrmarkhook"><code class="csfmt">\glsxtrmarkhook</code></dfn></code></div><!-- end of pinnedbox -->
+ This saves the original definitions and redefines the sensitive commands. This includes <a id="wrglossary.5829"></a><a href="#glo:MakeUppercase"><code class="csfmt">\MakeUppercase</code></a> which is <a id="wrglossary.5830"></a><a href="#glo:let"><code class="csfmt">\let</code></a> to <a id="wrglossary.5831"></a><a href="#glo:MakeTextUppercase"><code class="csfmt">\MakeTextUppercase</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5832"></a><code class="code"><dfn id="glo:@glsxtrinmark"><code class="csfmt">\@glsxtrinmark</code></dfn></code></div><!-- end of pinnedbox -->
+ This redefines <a id="wrglossary.5833"></a><a href="#glo:glsxtrifinmark"><code class="csfmt">\glsxtrifinmark</code></a> to just do its first argument (<span class="meta">〈<em class="metainner">true</em>〉</span>). <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5834"></a><code class="code"><dfn id="glo:@glsxtrnotinmark"><code class="csfmt">\@glsxtrnotinmark</code></dfn></code></div><!-- end of pinnedbox -->
+ This redefines <a id="wrglossary.5835"></a><a href="#glo:glsxtrifinmark"><code class="csfmt">\glsxtrifinmark</code></a> to just do its second argument (<span class="meta">〈<em class="metainner">false</em>〉</span>). <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5836"></a><code class="code"><dfn id="glo:glsxtrrestoremarkhook"><code class="csfmt">\glsxtrrestoremarkhook</code></dfn></code></div><!-- end of pinnedbox -->
+ This restores the sensitive commands to the saved definitions. (For use where grouping will cause interference.) For example, <a id="wrglossary.5837"></a><a href="#glo:markboth"><code class="csfmt">\markboth</code></a> is redefined as: <pre class="compactcodebox"><code class="cmd">\renewcommand</code>*{<a id="wrglossary.5838"></a><a href="#glo:markboth"><code class="csfmt">\markboth</code></a>}[2]{%
+ <a id="wrglossary.5839"></a><a href="#glo:glsxtrmarkhook"><code class="csfmt">\glsxtrmarkhook</code></a>
+ <a id="wrglossary.5840"></a><a href="#glo:@glsxtr@org@markboth"><code class="csfmt">\@glsxtr@org@markboth</code></a>
+ {<a id="wrglossary.5841"></a><a href="#glo:@glsxtrinmark"><code class="csfmt">\@glsxtrinmark</code></a>#1<a id="wrglossary.5842"></a><a href="#glo:@glsxtrnotinmark"><code class="csfmt">\@glsxtrnotinmark</code></a>}%
+ {<a id="wrglossary.5843"></a><a href="#glo:@glsxtrinmark"><code class="csfmt">\@glsxtrinmark</code></a>#2<a id="wrglossary.5844"></a><a href="#glo:@glsxtrnotinmark"><code class="csfmt">\@glsxtrnotinmark</code></a>}%
+ <a id="wrglossary.5845"></a><a href="#glo:glsxtrrestoremarkhook"><code class="csfmt">\glsxtrrestoremarkhook</code></a>
+}
+</pre><p>
+
+</section><!-- end of section sec:headingsadvanced -->
+
+<section id="sec:nested"><!-- start of section sec:nested --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->5.4. Nested Links<div class="labellink"><a href="#sec:nested">[link]</a></div></h2><!-- end of section header -->
+<p>
+Complications arise when you use the <a id="wrglossary.5846"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands in the value of the <a id="wrglossary.5847"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field (or <a id="wrglossary.5848"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> or <a id="wrglossary.5849"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> fields, if set). This tends to occur with abbreviations that extend other abbreviations. For example, SHTML is an abbreviation for SSI enabled HTML, where SSI is an abbreviation for Server Side Includes and HTML is an abbreviation for Hypertext Markup Language.<p>
+For example, things can go wrong if the following is used with the <a id="wrglossary.5850"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package: <pre class="badcodebox"><div class="badcodeboxtitle"><a href="#glo:sym.badcode"><span title="Problematic Input" class="icon"><span class="overlapped">🖹</span><span class="overlapper"><span class="deprecatedorbannedfmt">🛇</span></span></span></a></div><a id="wrglossary.5851"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{ssi}{SSI}{Server Side Includes}
+<a id="wrglossary.5852"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{html}{HTML}{Hypertext Markup Language}
+<a id="wrglossary.5853"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{shtml}{S<a id="wrglossary.5854"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}}{<a id="wrglossary.5855"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi} enabled <a id="wrglossary.5856"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}}
+</pre><p>
+The main problems are:
+<ol class="displaylist">
+ <li><span class="numitem">1.</span><a id="itm:nestedfirstucprob"></a> With older versions of <a id="wrglossary.5857"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> and <a id="wrglossary.5858"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>, the <a id="wrglossary.5859"></a><a href="#glo:idx.sentencecase">sentence case</a> commands, such as <a id="wrglossary.5860"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>, won’t work for the <code class="code">shtml</code> entry on <a id="wrglossary.5861"></a><a href="#glo:dual.firstuse">first use</a> if the long form is displayed before the short form (which is the default abbreviation style). This will attempt to do <pre class="compactcodebox"><a id="wrglossary.5862"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{<a id="wrglossary.5863"></a><a href="#glo:uppercase"><code class="csfmt">\uppercase</code></a> ssi} enabled <a id="wrglossary.5864"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}
+</pre> which just doesn’t work. Grouping the <code class="code"><a id="wrglossary.5865"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi}</code> doesn’t work either as this will effectively try to do: <pre class="compactcodebox"><a id="wrglossary.5866"></a><a href="#glo:uppercase"><code class="csfmt">\uppercase</code></a>{<a id="wrglossary.5867"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi}} enabled <a id="wrglossary.5868"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}
+</pre> This will upper case the label <code class="code">ssi</code> so the entry won’t be recognised. This problem will also occur if you use the <a id="wrglossary.5869"></a><a href="#glo:idx.allcaps">all caps</a> version, such as <code class="code"><a id="wrglossary.5870"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a>{shtml}</code>.<p>
+With <a id="wrglossary.5871"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+ and <a id="wrglossary.5872"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v1.49+, this issue should now be resolved for <a id="wrglossary.5873"></a><a href="#glo:idx.sentencecase">sentence case</a> where <code class="code"><a id="wrglossary.5874"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi}</code> will be mapped to <code class="code"><a id="wrglossary.5875"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{ssi}</code> within <code class="code"><a id="wrglossary.5876"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{shtml}</code>. The <a id="wrglossary.5877"></a><a href="#glo:idx.allcaps">all caps</a> command <code class="code"><a id="wrglossary.5878"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a>{shtml}</code> will treat <a id="wrglossary.5879"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> as an exclusion and so won’t perform a case-change. See §<a href="#sec:casechange">5.2</a> for further details.<p>
+<li><span class="numitem">2.</span><a id="itm:nonexpandprob"></a> The long and abbreviated forms accessed through <a id="wrglossary.5880"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a> and <a id="wrglossary.5881"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a> are no longer expandable and so can’t be used be used in contexts that require this, such as PDF bookmarks.<p>
+<li><span class="numitem">3.</span><a id="itm:nestedsortprob"></a> The nested commands may end up in the <a id="wrglossary.5882"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key, which will confuse the indexing.<p>
+<li><span class="numitem">4.</span><a id="itm:inconsistentfirstuseprob"></a> The <code class="code">shtml</code> entry produces inconsistent results depending on whether the <code class="code">ssi</code> or <code class="code">html</code> entries have been used. Suppose both <code class="code">ssi</code> and <code class="code">html</code> are used before <code class="code">shtml</code>. For example: <div style="text-align: center; border-style: none; "><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
+<p>
+<pre class="sidebysidecode">
+This section discusses
+<a id="wrglossary.5883"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi}, <a id="wrglossary.5884"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html} and
+<a id="wrglossary.5885"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{shtml}.
+</pre><div class="sidebysideresult">This section discusses server side includes (SSI), hypertext markup language (HTML) and SSI enabled HTML (SHTML). </div><p>
+ In the above, the <a id="wrglossary.5886"></a><a href="#glo:dual.firstuse">first use</a> of the <code class="code">shtml</code> entry produces <span class="qt">“SSI enabled HTML (SHTML)”</span>.<p>
+Now let’s suppose the <code class="code">html</code> entry is used before the <code class="code">shtml</code> but the <code class="code">ssi</code> entry is used after the <code class="code">shtml</code> entry, for example: <div style="text-align: center; border-style: none; "><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
+<p>
+<pre class="sidebysidecode">
+The sample files are
+either <a id="wrglossary.5887"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html} or
+<a id="wrglossary.5888"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{shtml}, but let's
+first discuss <a id="wrglossary.5889"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi}.
+</pre><div class="sidebysideresult">The sample files are either hypertext markup language (HTML) or server side includes (SSI) enabled HTML (SHTML), but let’s first discuss SSI. </div><p>
+ In this case, the <a id="wrglossary.5890"></a><a href="#glo:dual.firstuse">first use</a> of the <code class="code">shtml</code> entry now produces <span class="qt">“server side includes (SSI) enabled HTML (SHTML)”</span>, which looks a bit cumbersome.<p>
+Now let’s suppose the <code class="code">shtml</code> entry is used before (or without) the other two entries: <div style="text-align: center; border-style: none; "><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
+<p>
+<pre class="sidebysidecode">
+This article is an introduction
+to <a id="wrglossary.5891"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{shtml}.
+</pre><div class="sidebysideresult">This article is an introduction to server side includes (SSI) enabled hypertext markup language (HTML) (SHTML). </div><p>
+ Now the <a id="wrglossary.5892"></a><a href="#glo:dual.firstuse">first use</a> of the <code class="code">shtml</code> entry produces <span class="qt">“server side includes (SSI) enabled hypertext markup language (HTML) (SHTML)”</span>, which looks strange.<p>
+This is all aggravated when using just the base <a id="wrglossary.5893"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package when the acronym style is set with <a id="wrglossary.5894"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>. For example: <pre class="compactcodebox"><a id="wrglossary.5895"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.5896"></a><a href="#glo:opt.acrstyle.long-short"><span class="acrstylefmt">long-short</span></a>}
+</pre> as this references the label through the use of <a id="wrglossary.5897"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a> when displaying the long and short forms, but this value changes with each use of <a id="wrglossary.5898"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>, so instead of displaying <span class="qt">“(SHTML)”</span> at the end of the <a id="wrglossary.5899"></a><a href="#glo:firstuse">first use</a>, it now displays <span class="qt">“(HTML)”</span>, since <a id="wrglossary.5900"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a> has been changed to <code class="code">html</code> by <code class="code"><a id="wrglossary.5901"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}</code>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+In v1.48, the <a id="wrglossary.5902"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package added grouping with <a id="wrglossary.5903"></a><a href="#glo:glslinkwrcontent"><code class="csfmt">\glslinkwrcontent</code></a>, which scoped the <a id="wrglossary.5904"></a><a href="#glo:dual.linktext">link text</a>. Unfortunately this grouping caused problems in math mode and had to be removed in v1.49. You can redefine <a id="wrglossary.5905"></a><a href="#glo:glslinkwrcontent"><code class="csfmt">\glslinkwrcontent</code></a> to put the grouping back, but it still won’t scope the definitions of the placeholder commands, such as <a id="wrglossary.5906"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>, which need to be outside of this scope for the benefit of the <a id="wrglossary.5907"></a><a href="#glo:dual.postlinkhook">post-link hook</a>. </div><!-- end of information -->
+<p>
+Another oddity occurs if you reset the <code class="code">html</code> entry between uses of the <code class="code">shtml</code> entry. For example: <pre class="compactcodebox"><a id="wrglossary.5908"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{shtml} ... <a id="wrglossary.5909"></a><a href="#glo:glsreset"><code class="csfmt">\glsreset</code></a>{html}<a id="wrglossary.5910"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{shtml}
+</pre> The next use of <code class="code">shtml</code> produces <span class="qt">“Shypertext markup language (HTML)”</span>, which is downright weird. (This is a result of the short form being set to <code class="code">S<a id="wrglossary.5911"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}</code>, but <code class="code"><a id="wrglossary.5912"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}</code> is showing the full form.)<p>
+Even without this, the short form has nested formatting commands, which amount to <code class="code"><a id="wrglossary.5913"></a><a href="#glo:acronymfont"><code class="csfmt">\acronymfont</code></a>{S<a id="wrglossary.5914"></a><a href="#glo:acronymfont"><code class="csfmt">\acronymfont</code></a>{HTML}}</code>. This may not be a problem for some styles, but if you use one of the <span class="qt">“sm”</span> styles (that use <a id="wrglossary.5915"></a><a href="#glo:textsmaller"><code class="csfmt">\textsmaller</code></a>), this will produce an odd result.<p>
+<li><span class="numitem">5.</span><a id="itm:indexingprob"></a> Each time the <code class="code">shtml</code> entry is used, the <code class="code">html</code> entry will also be indexed and marked as used, and on <a id="wrglossary.5916"></a><a href="#glo:dual.firstuse">first use</a> this will happen to both the <code class="code">ssi</code> and <code class="code">html</code> entries. This kind of duplication in the location list isn’t usually particularly helpful to the reader.<p>
+<li><span class="numitem">6.</span><a id="itm:nestedhyplinkprob"></a> If <a id="wrglossary.5917"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> is in use, you’ll get nested hyperlinks and there’s no consistent way of dealing with this across the available PDF viewers. If on the <a id="wrglossary.5918"></a><a href="#glo:dual.firstuse">first use</a> case, the user clicks on the <span class="qt">“HTML”</span> part of the <span class="qt">“SSI enabled HTML (SHTML)”</span> link, they may be directed to the HTML entry in the glossary or they may be directed to the SHTML entry in the glossary.<p>
+
+</ol>
+<p>
+For these reasons, with just the base <a id="wrglossary.5919"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, it’s better to use the simple expandable commands like <a id="wrglossary.5920"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a> or <a id="wrglossary.5921"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a> in the definition of other entries.<p>
+The <a id="wrglossary.5922"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides two other ways of dealing with these problems:
+<ol class="displaylist">
+ <li><span class="numitem">1.</span>If the term can simply be treated as a series of previously defined entries, then consider using multi-entries (or compound sets), as described in §<a href="#sec:multientries">7</a>. This deals with all the issues, including case-changing.<p>
+<li><span class="numitem">2.</span>Use the partially-expandable <a id="wrglossary.5923"></a><a href="#glo:glsxtrp"><code class="csfmt">\glsxtrp</code></a>, described below.
+</ol>
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5924"></a><code class="code"><dfn id="glo:glsxtrp"><code class="csfmt">\glsxtrp</code></dfn>{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">field</em>〉</span> is the <a id="wrglossary.5925"></a><a href="#glo:dual.internalfieldlabel">internal field label</a>. <p>
+This command partially expands, so it will expand to just the <a id="wrglossary.5926"></a><a href="#glo:dual.field">field</a> value if it occurs in the PDF bookmarks. Otherwise it will behave much like the commands described in §<a href="#sec:headingcommands">5.3.2</a>, but with additional outer scoping and the <a id="wrglossary.5927"></a><a href="#glo:dual.postlinkhook">post-link hook</a> is suppressed.<p>
+Rather than testing the existence of the given field, this tests the existence of <code class="csfmt">\gls<span class="meta">〈<em class="metainner">field</em>〉</span></code> or <code class="csfmt">\glsxtr<span class="meta">〈<em class="metainner">field</em>〉</span></code>, which means that it may be confused if the <span class="meta">〈<em class="metainner">field</em>〉</span> argument is set to something that isn’t a field but happens to match either of those command names (such as <code class="code">full</code>).<p>
+Note that, as with commands like <a id="wrglossary.5928"></a><a href="#glo:glsfmtshort"><code class="csfmt">\glsfmtshort</code></a>, there’s no optional argument. The default settings are <a id="wrglossary.5929"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a> and <a id="wrglossary.5930"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span>. You can change this with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5931"></a><code class="code"><dfn id="glo:glsxtrsetpopts"><code class="csfmt">\glsxtrsetpopts</code></dfn>{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The argument should be the new default options.<p>
+At the start of each glossary, the default options are locally changed with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5932"></a><code class="code"><dfn id="glo:glossxtrsetpopts"><code class="csfmt">\glossxtrsetpopts</code></dfn></code></div><!-- end of pinnedbox -->
+ This is defined as: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.5933"></a><a href="#glo:glossxtrsetpopts"><code class="csfmt">\glossxtrsetpopts</code></a>}{%
+ <a id="wrglossary.5934"></a><a href="#glo:glsxtrsetpopts"><code class="csfmt">\glsxtrsetpopts</code></a>{noindex}%
+}
+</pre> This allows hyperlinks for any instance of <a id="wrglossary.5935"></a><a href="#glo:glsxtrp"><code class="csfmt">\glsxtrp</code></a> that occurs in the name or description, where it shouldn’t be problematic.<p>
+There are some shortcut commands for the most common fields: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5936"></a><code class="code"><dfn id="glo:glsps"><code class="csfmt">\glsps</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which is equivalent to <code class="code"><a id="wrglossary.5937"></a><a href="#glo:glsxtrp"><code class="csfmt">\glsxtrp</code></a>{short}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>, and <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5938"></a><code class="code"><dfn id="glo:glspt"><code class="csfmt">\glspt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which is equivalent to <code class="code"><a id="wrglossary.5939"></a><a href="#glo:glsxtrp"><code class="csfmt">\glsxtrp</code></a>{text}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>.<p>
+There are also <a id="wrglossary.5940"></a><a href="#glo:idx.sentencecase">sentence case</a> and <a id="wrglossary.5941"></a><a href="#glo:idx.allcaps">all caps</a> versions. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5942"></a><code class="code"><dfn id="glo:Glsxtrp"><code class="csfmt">\Glsxtrp</code></dfn>{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This uses the corresponding <a id="wrglossary.5943"></a><a href="#glo:idx.sentencecase">sentence case</a> command <code class="csfmt">\Gls<span class="meta">〈<em class="metainner">field</em>〉</span></code> or <code class="csfmt">\Glsxtr<span class="meta">〈<em class="metainner">field</em>〉</span></code>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.5944"></a><code class="code"><dfn id="glo:GLSxtrp"><code class="csfmt">\GLSxtrp</code></dfn>{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This uses the corresponding <a id="wrglossary.5945"></a><a href="#glo:idx.allcaps">all caps</a> command <code class="csfmt">\GLS<span class="meta">〈<em class="metainner">field</em>〉</span></code> or <code class="csfmt">\GLSxtr<span class="meta">〈<em class="metainner">field</em>〉</span></code>.<p>
+For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+<a id="wrglossary.5946"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{long-em-short-em}
+<a id="wrglossary.5947"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{html}{HTML}{hypertext markup language}
+<a id="wrglossary.5948"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ssi}{SSI}{server-side includes}
+<a id="wrglossary.5949"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{shtml}{SHTML}{<a id="wrglossary.5950"></a><a href="#glo:glsps"><code class="csfmt">\glsps</code></a>{html} enabled
+<a id="wrglossary.5951"></a><a href="#glo:glsps"><code class="csfmt">\glsps</code></a>{ssi}}
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.5952"></a><a href="#glo:tableofcontents"><code class="csfmt">\tableofcontents</code></a>
+<code class="cmd">\section</code>{<a id="wrglossary.5953"></a><a href="#glo:glsfmtlong"><code class="csfmt">\glsfmtlong</code></a>{shtml}}
+First use: <a id="wrglossary.5954"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{shtml}, <a id="wrglossary.5955"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}, <a id="wrglossary.5956"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi}.
+
+Next use: <a id="wrglossary.5957"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{shtml}, <a id="wrglossary.5958"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}, <a id="wrglossary.5959"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi}.
+
+<a id="wrglossary.5960"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:nestedlinkglspl"></a>Example 95: Nested link text with <code class="cmd">\glspl</code> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example095.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example095.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example095.png" type="image/png" width="391" height="281">Example document illustrating an entry that references other entries within one of its fields.</object> </div><!-- end of resultbox -->
+<p>
+The way that this works is as follows:
+<ul class="displaylist">
+ <li><span class="bulletitem">•</span><code class="code"><a id="wrglossary.5961"></a><a href="#glo:glsfmtlong"><code class="csfmt">\glsfmtlong</code></a>{shtml}</code> expands to <code class="code"><a id="wrglossary.5962"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a>{shtml}</code> within the PDF bookmarks, which expands to the value of the <a id="wrglossary.5963"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> field: <pre class="compactcodebox"><a id="wrglossary.5964"></a><a href="#glo:glsps"><code class="csfmt">\glsps</code></a>{html} enabled <a id="wrglossary.5965"></a><a href="#glo:glsps"><code class="csfmt">\glsps</code></a>{ssi}
+</pre> This means that <a id="wrglossary.5966"></a><a href="#glo:glsps"><code class="csfmt">\glsps</code></a> (within the PDF bookmarks) in turn expands to <a id="wrglossary.5967"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a>. So the bookmark text (which can’t contain any formatting commands) ends up as <span class="qt">“HTML enabled SSI”</span>.<p>
+<li><span class="bulletitem">•</span><code class="code"><a id="wrglossary.5968"></a><a href="#glo:glsfmtlong"><code class="csfmt">\glsfmtlong</code></a>{shtml}</code> essentially behaves like <a id="wrglossary.5969"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a>, but with the <a id="wrglossary.5970"></a><a href="#glo:dual.indexing">indexing</a> and hyperlink suppressed. The <a id="wrglossary.5971"></a><a href="#glo:dual.linktext">link text</a> is the value of the <a id="wrglossary.5972"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> field encapsulated with the abbreviation style’s formatting command (<a id="wrglossary.5973"></a><a href="#glo:glslongemfont"><code class="csfmt">\glslongemfont</code></a> in this case): <pre class="compactcodebox"><a id="wrglossary.5974"></a><a href="#glo:glslongemfont"><code class="csfmt">\glslongemfont</code></a>{<a id="wrglossary.5975"></a><a href="#glo:glsps"><code class="csfmt">\glsps</code></a>{html} enabled <a id="wrglossary.5976"></a><a href="#glo:glsps"><code class="csfmt">\glsps</code></a>{ssi}}
+</pre> This then becomes: <pre class="compactcodebox"><a id="wrglossary.5977"></a><a href="#glo:glslongemfont"><code class="csfmt">\glslongemfont</code></a>{{<a id="wrglossary.5978"></a><a href="#glo:let"><code class="csfmt">\let</code></a><a id="wrglossary.5979"></a><a href="#glo:glspostlinkhook"><code class="csfmt">\glspostlinkhook</code></a><a id="wrglossary.5980"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a>
+ <a id="wrglossary.5981"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>{html}} enabled
+{<a id="wrglossary.5982"></a><a href="#glo:let"><code class="csfmt">\let</code></a><a id="wrglossary.5983"></a><a href="#glo:glspostlinkhook"><code class="csfmt">\glspostlinkhook</code></a><a id="wrglossary.5984"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a>
+ <a id="wrglossary.5985"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>{ssi}}}
+</pre> Note the grouping and localised suppression of the <a id="wrglossary.5986"></a><a href="#glo:dual.postlinkhook">post-link hook</a>.
+</ul>
+<p>
+Note that in the above example, with older versions of <a id="wrglossary.5987"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> and <a id="wrglossary.5988"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>, it’s not possible to use <code class="code"><a id="wrglossary.5989"></a><a href="#glo:Glsxtrlong"><code class="csfmt">\Glsxtrlong</code></a>{shtml}</code> or similar. The problem here is that it will attempt to do: <pre class="compactcodebox"><a id="wrglossary.5990"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<a id="wrglossary.5991"></a><a href="#glo:glsps"><code class="csfmt">\glsps</code></a>{html} enabled <a id="wrglossary.5992"></a><a href="#glo:glsps"><code class="csfmt">\glsps</code></a>{ssi}}
+</pre> This will essentially end up as: <pre class="compactcodebox"><a id="wrglossary.5993"></a><a href="#glo:glsps"><code class="csfmt">\glsps</code></a>{<a id="wrglossary.5994"></a><a href="#glo:uppercase"><code class="csfmt">\uppercase</code></a> html} enabled <a id="wrglossary.5995"></a><a href="#glo:glsps"><code class="csfmt">\glsps</code></a>{ssi}
+</pre> which doesn’t work. If you want to protect against automated case-changes, such as using the <a id="wrglossary.5996"></a><a href="#glo:opt.catattr.glossdesc"><span class="csoptfmt">glossdesc</span></a> attribute, insert an empty brace at the start: <pre class="compactcodebox"><a id="wrglossary.5997"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{shtml}{SHTML}{{}<a id="wrglossary.5998"></a><a href="#glo:glsps"><code class="csfmt">\glsps</code></a>{html} enabled
+<a id="wrglossary.5999"></a><a href="#glo:glsps"><code class="csfmt">\glsps</code></a>{ssi}}
+</pre> Alternatively, upgrade to <a id="wrglossary.6000"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+ and <a id="wrglossary.6001"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+. See §<a href="#sec:casechange">5.2</a>.<p>
+
+</section><!-- end of section sec:nested -->
+
+<section id="sec:entryfmtmods"><!-- start of section sec:entryfmtmods --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->5.5. Adjusting the Text Style<div class="labellink"><a href="#sec:entryfmtmods">[link]</a></div></h2><!-- end of section header -->
+<p>
+The <a id="wrglossary.6002"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.6003"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands produce text that’s essentially formatted either as (<a id="wrglossary.6004"></a><a href="#glo:opt.glsopt.hyperoutside"><span class="csoptfmt">hyperoutside</span></a><span class="optfmt">=true</span>): <pre class="compactcodebox"><span class="meta">〈<em class="metainner">hyper-cs</em>〉</span>{<span class="meta">〈<em class="metainner">target</em>〉</span>}{<span class="meta">〈<em class="metainner">textformat-cs</em>〉</span>{<span class="meta">〈<em class="metainner">content</em>〉</span>}}<span class="meta">〈<em class="metainner">post-link hook</em>〉</span>
+</pre> or (<a id="wrglossary.6005"></a><a href="#glo:opt.glsopt.hyperoutside"><span class="csoptfmt">hyperoutside</span></a><span class="optfmt">=false</span>): <pre class="compactcodebox"><span class="meta">〈<em class="metainner">textformat-cs</em>〉</span>{<span class="meta">〈<em class="metainner">hyper-cs</em>〉</span>{<span class="meta">〈<em class="metainner">target</em>〉</span>}{<span class="meta">〈<em class="metainner">content</em>〉</span>}}<span class="meta">〈<em class="metainner">post-link hook</em>〉</span>
+</pre> If hyperlinks are enabled then <span class="meta">〈<em class="metainner">hyper-cs</em>〉</span> creates the hyperlink based on <span class="meta">〈<em class="metainner">target</em>〉</span> with the hyperlink text given by the second argument. If hyperlinks aren’t enabled then <span class="meta">〈<em class="metainner">hyper-cs</em>〉</span> ignores the <span class="meta">〈<em class="metainner">target</em>〉</span> argument and simply does the second argument.<p>
+The <span class="meta">〈<em class="metainner">content</em>〉</span> part is the <a id="wrglossary.6006"></a><a href="#glo:dual.linktext">link text</a>, which includes the final optional <span class="meta">〈<em class="metainner">insert</em>〉</span> (if supplied). The actual content depends on the command used (for example, <a id="wrglossary.6007"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or <a id="wrglossary.6008"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>). The <a id="wrglossary.6009"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands all use the entry display style associated with the entry’s <a id="wrglossary.6010"></a><a href="#glo:dual.glossary">glossary</a> type, (see §<a href="#sec:entryfmt">5.5.5</a>). The <a id="wrglossary.6011"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands set the <span class="meta">〈<em class="metainner">content</em>〉</span> to the corresponding field value with the insert appended, all encapsulated with the inner formatting (see §<a href="#sec:innertextformat">5.5.3</a>), with appropriate case-changing, if required.<p>
+The abbreviation commands (<a id="wrglossary.6012"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>, <a id="wrglossary.6013"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a>, <a id="wrglossary.6014"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> etc) are considered part of the set of <a id="wrglossary.6015"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands, but the content is set according to the abbreviation style (see §<a href="#sec:abbrstyle">4.5</a>).<p>
+The commands <a id="wrglossary.6016"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a> and <a id="wrglossary.6017"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a> both have the content part explicitly set in their final argument. There’s no insert optional argument as it can simply be included in the content part. The difference between them is that <a id="wrglossary.6018"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a> is considered a <a id="wrglossary.6019"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> command (it unsets the <a id="wrglossary.6020"></a><a href="#glo:dual.firstuseflag">first use flag</a>, §<a href="#sec:glsunset">5.10</a>, and uses the entry display style, §<a href="#sec:entryfmt">5.5.5</a>), whereas <a id="wrglossary.6021"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a> is considered a <a id="wrglossary.6022"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> command.<p>
+The <span class="meta">〈<em class="metainner">post-link hook</em>〉</span> part is described in §<a href="#sec:postlinkhook">5.5.4</a>.<p>
+The <span class="meta">〈<em class="metainner">textformat-cs</em>〉</span> command is the <span style="font-style: italic; font-variant: normal; ">outer</span> formatting command, described in §<a href="#sec:glstextformat">5.5.1</a>. This doesn’t include the <a id="wrglossary.6023"></a><a href="#glo:dual.postlinkhook">post-link hook</a>. If you want to include the <a id="wrglossary.6024"></a><a href="#glo:dual.postlinkhook">post-link hook</a> then you need to encapsulate the entire <a id="wrglossary.6025"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.6026"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> command (including the final optional argument, if present, and following punctuation, if the <a id="wrglossary.6027"></a><a href="#glo:dual.postlinkhook">post-link hook</a> looks ahead for punctuation).<p>
+Some sensitive formatting commands need to have the actual text in their argument (or else have the argument in an unbreakable box). The <span class="meta">〈<em class="metainner">content</em>〉</span> part is usually too complicated for these commands. To help support this type of command, there is also an <a id="wrglossary.6028"></a><a href="#glo:@@glslabel@innerformatting">inner format</a>, which is described in §<a href="#sec:innertextformat">5.5.3</a>. In general, unless you require one of these sensitive commands, avoid setting the inner text format as it requires support from the underlying style (either the entry format style or the abbreviation style), which may not be available.<p>
+The following example document is ugly, but demonstrates the outer formatting (<span style="font-family: monospace; ">typewriter</span> font), middle formatting (<span style="font-weight: bold; ">bold</span> for regular entries and <span style="font-style: italic; font-variant: normal; ">italic</span> for abbreviations), inner formatting (highlighted in yellow), hyperlinks (red), and the <a id="wrglossary.6029"></a><a href="#glo:dual.catpostlinkhook">category post-link hook</a> (the description follows in parentheses for general entries on <a id="wrglossary.6030"></a><a href="#glo:dual.firstuse">first use</a>). <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>{courier}
+<code class="cmd">\usepackage</code>[T1]{fontenc}
+<code class="cmd">\usepackage</code>{xcolor}
+<code class="cmd">\usepackage</code>{soul}
+<code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.6031"></a><a href="#glo:opt.nogroupskip"><span class="styoptfmt">nogroupskip</span></a>]{glossaries-extra}
+<span class="comment">% outer formatting:</span>
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.6032"></a><a href="#glo:glstextformat"><code class="csfmt">\glstextformat</code></a>}[1]{<code class="cmd">\texttt</code>{#1}}
+<span class="comment">% middle formatting:</span>
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.6033"></a><a href="#glo:glsxtrregularfont"><code class="csfmt">\glsxtrregularfont</code></a>}[1]{<code class="cmd">\textbf</code>{#1}}
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.6034"></a><a href="#glo:glsxtrabbreviationfont"><code class="csfmt">\glsxtrabbreviationfont</code></a>}[1]{<code class="cmd">\textit</code>{#1}}
+<span class="comment">% inner formatting:</span>
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.6035"></a><a href="#glo:glsxtrdefaultentrytextfmt"><code class="csfmt">\glsxtrdefaultentrytextfmt</code></a>}[1]{<code class="cmd">\hl</code>{#1}}
+<span class="comment">% post-link hook for 'general' category:</span>
+<a id="wrglossary.6036"></a><a href="#glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></a>{<a id="wrglossary.6037"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>}{<a id="wrglossary.6038"></a><a href="#glo:glsxtrpostlinkAddDescOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddDescOnFirstUse</code></a>}
+<span class="comment">% define entries:</span>
+<a id="wrglossary.6039"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.6040"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.6041"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+<a id="wrglossary.6042"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{html}{HTML}{hypertext markup language}
+<a id="wrglossary.6043"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{nasa}{NASA}{National Aeronautics and Space Administration}
+<code class="cbeg">\begin{document}</code>
+First use: <a id="wrglossary.6044"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}, <a id="wrglossary.6045"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}, <a id="wrglossary.6046"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{nasa}.
+
+Next use: <a id="wrglossary.6047"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}, <a id="wrglossary.6048"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}, <a id="wrglossary.6049"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{nasa}.
+<a id="wrglossary.6050"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> This produces: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:linktextstyles"></a>Example 96: Link text styles: outer, middle, inner, hyperlinks and post-link hook <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example096.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example096.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example096.png" type="image/png" width="437" height="186">An example document that illustrates the outer, middle and inner formatting, hyperlinks and a category post-link hook.</object> </div><!-- end of resultbox -->
+ Note that the hyperlink, outer and middle formatting aren’t applied to the <a id="wrglossary.6051"></a><a href="#glo:dual.postlinkhook">post-link hook</a>. The <a id="wrglossary.6052"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a> category has the <a id="wrglossary.6053"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a> abbreviation style, which sets the <a id="wrglossary.6054"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to true. This means that the NASA entry uses the regular middle format (<a id="wrglossary.6055"></a><a href="#glo:glsxtrregularfont"><code class="csfmt">\glsxtrregularfont</code></a>) not the abbreviation middle format (<a id="wrglossary.6056"></a><a href="#glo:glsxtrabbreviationfont"><code class="csfmt">\glsxtrabbreviationfont</code></a>).<p>
+If you have a formatting command that needs to have its argument fully-expanded before being applied, you may be able to use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6057"></a><code class="code"><dfn id="glo:GlsXtrExpandedFmt"><code class="csfmt">\GlsXtrExpandedFmt</code></dfn>{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">content</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This fully-expands <span class="meta">〈<em class="metainner">content</em>〉</span> and does <code class="code"><span class="meta">〈<em class="metainner">cs</em>〉</span>{<span class="meta">〈<em class="metainner">expanded-content</em>〉</span>}</code>, where <span class="meta">〈<em class="metainner">cs</em>〉</span> is a command that takes a single argument. For example, to use <a id="wrglossary.6058"></a><a href="#glo:pkg.soul"><span class="styfmt">soul</span>’s</a> underlining command <a id="wrglossary.6059"></a><a href="#glo:ul"><code class="csfmt">\ul</code></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.6060"></a><a href="#glo:glsxtrregularfont"><code class="csfmt">\glsxtrregularfont</code></a>}[1]{<a id="wrglossary.6061"></a><a href="#glo:GlsXtrExpandedFmt"><code class="csfmt">\GlsXtrExpandedFmt</code></a>{#1}}
+</pre> (See Example <a href="#ex:protectinnertextformat">117</a>.) This isn’t guaranteed to work as the <a id="wrglossary.6062"></a><a href="#glo:dual.linktext">link text</a> may contain fragile content.<p>
+The inner formatting can be unpredictable. For example, abbreviation styles are complicated and so the inner formatting command is included in some of the field values, such as the <a id="wrglossary.6063"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, which is why the abbreviation name is highlighted in the <a id="wrglossary.6064"></a><a href="#glo:dual.glossary">glossary</a>. In the above example, the inner formatting is included in the <a id="wrglossary.6065"></a><a href="#glo:dual.catpostlinkhook">category post-link hook</a>, but only because <a id="wrglossary.6066"></a><a href="#glo:glsxtrpostlinkAddDescOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddDescOnFirstUse</code></a> is designed to include it. If the <a id="wrglossary.6067"></a><a href="#glo:dual.catpostlinkhook">category post-link hook</a> was simply defined as: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.6068"></a><a href="#glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></a>{general}{%
+ <a id="wrglossary.6069"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a>{ (<a id="wrglossary.6070"></a><a href="#glo:glsentrydesc"><code class="csfmt">\glsentrydesc</code></a>{<a id="wrglossary.6071"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>})}{}}
+</pre> then the inner formatting won’t be applied, since it’s not included in the hook. This is demonstrated in a slightly modified version of the above document (initial part of preamble that deals with loading packages and redefining formatting commands as before): <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><span class="comment">% post-link hook for 'general' category:</span>
+<a id="wrglossary.6072"></a><a href="#glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></a>{general}{%
+ <a id="wrglossary.6073"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a>{ (<a id="wrglossary.6074"></a><a href="#glo:glsentrydesc"><code class="csfmt">\glsentrydesc</code></a>{<a id="wrglossary.6075"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>})}{}}
+<span class="comment">% this style sets the post-link hook for 'abbreviation' category:</span>
+<a id="wrglossary.6076"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.6077"></a><a href="#glo:opt.abbrstyle.long-postshort-user"><span class="abbrstylefmt">long-postshort-user</span></a>}
+<span class="comment">% this style sets the post-link hook for 'acronym' category:</span>
+<a id="wrglossary.6078"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>[<a id="wrglossary.6079"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a>]{<a id="wrglossary.6080"></a><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></a>}
+<span class="comment">% define entries:</span>
+<a id="wrglossary.6081"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.6082"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.6083"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+<a id="wrglossary.6084"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{html}{HTML}{hypertext markup language}
+<a id="wrglossary.6085"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{nasa}{NASA}{National Aeronautics and Space Administration}
+<code class="cbeg">\begin{document}</code>
+First use: <a id="wrglossary.6086"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}, <a id="wrglossary.6087"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}, <a id="wrglossary.6088"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{nasa}.
+
+Next use: <a id="wrglossary.6089"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}, <a id="wrglossary.6090"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}, <a id="wrglossary.6091"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{nasa}.
+<a id="wrglossary.6092"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> This produces: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:linktextstylescustom"></a>Example 97: Link text styles: outer, middle, inner, hyperlinks and post-link hooks (custom and abbreviation style) <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example097.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example097.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example097.png" type="image/png" width="437" height="540">An example document that illustrates the outer, middle and inner formatting, and hyperlinks, with a custom category post-link hook and abbreviation style that sets the category post-link hook.</object> </div><!-- end of resultbox -->
+ The <span class="qt">“post”</span> abbreviation styles put some content into the <a id="wrglossary.6093"></a><a href="#glo:dual.postlinkhook">post-link hook</a> and provide support for the inner formatting. The above example sets the abbreviation style to <a id="wrglossary.6094"></a><a href="#glo:opt.abbrstyle.long-postshort-user"><span class="abbrstylefmt">long-postshort-user</span></a>. This sets up the <a id="wrglossary.6095"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the associated category (<a id="wrglossary.6096"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a>, in this case) to show the parenthetical material. Be aware that this will override any previous definition of that hook. This style supports the inner formatting (so the parenthetical material is highlighted).<p>
+Similarly, the <a id="wrglossary.6097"></a><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></a> style is applied to the <a id="wrglossary.6098"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a> category, and sets the <a id="wrglossary.6099"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for that category (which looks head for punctuation). The inner formatting is applied to the footnote text but not the marker.<p>
+The <a id="wrglossary.6100"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the <a id="wrglossary.6101"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a> category is now much simpler and doesn’t include support for the inner formatting, so it’s not highlighted.<p>
+None of the post-link content is incorporated into the hyperlink, outer or middle formatting.<p>
+In general, it’s better to adjust the abbreviation’s style commands (see §<a href="#sec:abbrvcmds">4.5.1.3</a>) rather than use the middle or inner formatting if abbreviations need to be displayed in a particular font.<p>
+
+</section><!-- end of section sec:entryfmtmods -->
+
+<section id="sec:glstextformat"><!-- start of section sec:glstextformat --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->5.5.1. Outer Formatting<div class="labellink"><a href="#sec:glstextformat">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+By default, the outer formatting is produced with <a id="wrglossary.6102"></a><a href="#glo:glstextformat"><code class="csfmt">\glstextformat</code></a>, which is defined by the base <a id="wrglossary.6103"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. However it can be replaced by the <a id="wrglossary.6104"></a><a href="#glo:opt.catattr.textformat"><span class="csoptfmt">textformat</span></a> category attribute or by the <a id="wrglossary.6105"></a><a href="#glo:opt.glsopt.textformat"><span class="csoptfmt">textformat</span></a> option. The order of precedence (not cumulative) is: the option supplied to the <a id="wrglossary.6106"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> or <a id="wrglossary.6107"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> command, the category attribute, <a id="wrglossary.6108"></a><a href="#glo:glstextformat"><code class="csfmt">\glstextformat</code></a>. <p>
+For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+<a id="wrglossary.6109"></a><a href="#glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></a>{general}{ (<a id="wrglossary.6110"></a><a href="#glo:glsentrydesc"><code class="csfmt">\glsentrydesc</code></a>{<a id="wrglossary.6111"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>})}
+<a id="wrglossary.6112"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.6113"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.6114"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+<code class="cmd">\newcommand</code>{<code class="cmd">\strong</code>}[1]{<code class="cmd">\textbf</code>{<code class="cmd">\color</code>{green}#1}}
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.6115"></a><a href="#glo:glstextformat"><code class="csfmt">\glstextformat</code></a>}[1]{<code class="cmd">\emph</code>{#1}}
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.6116"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}[-insert]. <code class="cmd">\strong</code>{<a id="wrglossary.6117"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}[-insert]}.
+
+<a id="wrglossary.6118"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{<a id="wrglossary.6119"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>}{<a id="wrglossary.6120"></a><a href="#glo:opt.catattr.textformat"><span class="csoptfmt">textformat</span></a>}{strong}
+<a id="wrglossary.6121"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}[-insert].
+<a id="wrglossary.6122"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.6123"></a><a href="#glo:opt.glsopt.hyperoutside"><span class="csoptfmt">hyperoutside</span></a><span class="optfmt">=false</span>]{sample}[-insert].
+
+<a id="wrglossary.6124"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.6125"></a><a href="#glo:opt.glsopt.textformat"><span class="csoptfmt">textformat</span></a><span class="optfmt">=textsf</span>]{sample}[-insert].
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:textformat"></a>Example 98: Changing the outer text format <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example098.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example098.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example098.png" type="image/png" width="316" height="42">Example document illustrating the difference between <code class="cmd">\glstextformat</code>, the <span class="optfmt">textformat</span> category attribute, and the <span class="optfmt">textformat</span> option.</object> </div><!-- end of resultbox -->
+ The red text colour is from the hyperlink (red is the default with <a id="wrglossary.6126"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span>’s</a> <span class="optfmt">colorlinks</span> option). The green from the custom <code class="csfmt">\strong</code> command is cancelled by the hyperlink colour change when the hyperlink is inside <code class="csfmt">\strong</code>.<p>
+After the <a id="wrglossary.6127"></a><a href="#glo:opt.catattr.textformat"><span class="csoptfmt">textformat</span></a> attribute is set, the <a id="wrglossary.6128"></a><a href="#glo:glstextformat"><code class="csfmt">\glstextformat</code></a> command isn’t used, which is why the remaining lines don’t have any italic. The final line uses the <a id="wrglossary.6129"></a><a href="#glo:opt.glsopt.textformat"><span class="csoptfmt">textformat</span></a> option, which overrides the <a id="wrglossary.6130"></a><a href="#glo:opt.catattr.textformat"><span class="csoptfmt">textformat</span></a> attribute, so neither <a id="wrglossary.6131"></a><a href="#glo:glstextformat"><code class="csfmt">\glstextformat</code></a> nor the custom <code class="csfmt">\strong</code> are used.<p>
+Note that the only time that the <a id="wrglossary.6132"></a><a href="#glo:dual.postlinkhook">post-link hook</a> is included in the formatting is when the entire <a id="wrglossary.6133"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> command has been encapsulated.<p>
+
+</section><!-- end of section sec:glstextformat -->
+
+<section id="sec:middleformat"><!-- start of section sec:middleformat --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->5.5.2. Middle Formatting<div class="labellink"><a href="#sec:middleformat">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+The middle formatting comes between the outer formatting (§<a href="#sec:glstextformat">5.5.1</a> above) and the <a id="wrglossary.6134"></a><a href="#glo:dual.innerformatting">inner formatting</a> (§<a href="#sec:innertextformat">5.5.3</a> below).<p>
+The middle formatting is implemented by the entry format style (§<a href="#sec:entryfmt">5.5.5</a>) for the <a id="wrglossary.6135"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands or is initialised by <a id="wrglossary.6136"></a><a href="#glo:glsxtrassignfieldfont"><code class="csfmt">\glsxtrassignfieldfont</code></a> for the <a id="wrglossary.6137"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands.<p>
+If you provide your own custom entry format style you will need to add support for the middle formatting, if required.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6138"></a><code class="code"><dfn id="glo:glsxtrregularfont"><code class="csfmt">\glsxtrregularfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The command to use for regular entries. This is initialised to just do its argument.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6139"></a><code class="code"><dfn id="glo:glsxtrabbreviationfont"><code class="csfmt">\glsxtrabbreviationfont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The command to use for abbreviations that considered non-regular entries.<p>
+The following document has a regular entry (sample), a regular abbreviation (radar, which uses <a id="wrglossary.6140"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a> the default <a id="wrglossary.6141"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a> style), and a non-regular abbreviation (HTML, which uses <a id="wrglossary.6142"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> the default <a id="wrglossary.6143"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a> style): <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.6144"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.6145"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.6146"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+<a id="wrglossary.6147"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{html}{HTML}{hypertext markup language}
+<a id="wrglossary.6148"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{radar}{radar}{radio detection and ranging}
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.6149"></a><a href="#glo:glsxtrregularfont"><code class="csfmt">\glsxtrregularfont</code></a>}[1]{<code class="cmd">\emph</code>{#1}}
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.6150"></a><a href="#glo:glsxtrabbreviationfont"><code class="csfmt">\glsxtrabbreviationfont</code></a>}[1]{<code class="cmd">\textbf</code>{#1}}
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.6151"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}, <a id="wrglossary.6152"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}, <a id="wrglossary.6153"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{radar}.
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:middleformat"></a>Example 99: Middle formatting <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example099.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example099.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example099.png" type="image/png" width="299" height="13">Example document illustrating middle formatting applied with <code class="cmd">\glsxtrregularfont</code> for regular entries and <code class="cmd">\glsxtrabbreviationfont</code> for non-regular abbreviations.</object> </div><!-- end of resultbox -->
+ Note that even though radar is an abbreviation, it’s considered a regular entry because it uses a regular style.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6154"></a><code class="code"><dfn id="glo:glsxtrassignfieldfont"><code class="csfmt">\glsxtrassignfieldfont</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is used by all the <a id="wrglossary.6155"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands to initialise the internal command used to encapsulate the field value. This will either be set to <a id="wrglossary.6156"></a><a href="#glo:glsxtrregularfont"><code class="csfmt">\glsxtrregularfont</code></a> (for regular entries) or <a id="wrglossary.6157"></a><a href="#glo:@firstofone"><code class="csfmt">\@firstofone</code></a> otherwise.<p>
+Note that this doesn’t use <a id="wrglossary.6158"></a><a href="#glo:glsxtrabbreviationfont"><code class="csfmt">\glsxtrabbreviationfont</code></a> as non-regular abbreviations are too complicated to work with <a id="wrglossary.6159"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>, <a id="wrglossary.6160"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a>, <a id="wrglossary.6161"></a><a href="#glo:glsplural"><code class="csfmt">\glsplural</code></a>, <a id="wrglossary.6162"></a><a href="#glo:glsfirstplural"><code class="csfmt">\glsfirstplural</code></a> or their case-changing variants. Instead, use the <a id="wrglossary.6163"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands or the abbreviation commands, such as <a id="wrglossary.6164"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>.<p>
+
+</section><!-- end of section sec:middleformat -->
+
+<section id="sec:innertextformat"><!-- start of section sec:innertextformat --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->5.5.3. Inner Formatting<div class="labellink"><a href="#sec:innertextformat">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+If you want to format the <a id="wrglossary.6165"></a><a href="#glo:dual.linktext">link text</a>, the best method is to either use the outer formatting or encapsulate the entire <a id="wrglossary.6166"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> or <a id="wrglossary.6167"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> command, as described in §<a href="#sec:glstextformat">5.5.1</a>. However, there are some sensitive commands that don’t work if the command argument doesn’t simply contain text.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+Sometimes the issue may occur when the sensitive command that needs to encapsulate <a id="wrglossary.6168"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> doesn’t like boolean variables being changed (which occurs when the <a id="wrglossary.6169"></a><a href="#glo:dual.firstuseflag">first use flag</a> is unset). If this is the case, you may want to consider buffering as an alternative (see §<a href="#sec:unsetbuffer">5.10.1</a>). </div><!-- end of information -->
+<p>
+For example, if the sample document from §<a href="#sec:glstextformat">5.5.1</a> is adjusted to include the <a id="wrglossary.6170"></a><a href="#glo:pkg.soul"><span class="styfmt">soul</span></a> package and the following line is added to the document: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.6171"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.6172"></a><a href="#glo:opt.glsopt.textformat"><span class="csoptfmt">textformat</span></a><span class="optfmt">=hl</span>]{sample}
+</pre> then the document build will fail with the error: <blockquote> ! Package soul Error: Reconstruction failed. </blockquote> Once solution is to do the following instead: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.6173"></a><a href="#glo:hl"><code class="csfmt">\hl</code></a>{<a id="wrglossary.6174"></a><a href="#glo:mbox"><code class="csfmt">\mbox</code></a>{<a id="wrglossary.6175"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}}}
+</pre> This will now work, but the box will prevent hyphenation, so it’s only useful if the <a id="wrglossary.6176"></a><a href="#glo:dual.linktext">link text</a> is short, such as a symbol. If the <a id="wrglossary.6177"></a><a href="#glo:dual.linktext">link text</a> is long (such as a phrase or the <a id="wrglossary.6178"></a><a href="#glo:dual.firstuse">first use</a> of an abbreviation), this method can produce undesirable results with overfull or underfull lines.<p>
+The <a id="wrglossary.6179"></a><a href="#glo:dual.innerformatting">inner formatting</a> is designed to provide a workaround, but it must be implemented deep within the entry style formatting. This means that if you provide your own custom style, you will need to add the appropriate commands if you want that style to support inner formatting. You may also need to switch to using <a id="wrglossary.6180"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> instead of <a id="wrglossary.6181"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> if any of the <a id="wrglossary.6182"></a><a href="#glo:idx.sentencecase">sentence case</a> commands are required: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.6183"></a><a href="#glo:glssentencecase"><code class="csfmt">\glssentencecase</code></a>}[1]{<a id="wrglossary.6184"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{#1}}
+</pre> Although there’s no guarantee that this will work for some particularly problematic formatting commands.<p>
+With the default entry style, the above example can be changed to: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.6185"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.6186"></a><a href="#glo:opt.glsopt.innertextformat"><span class="csoptfmt">innertextformat</span></a><span class="optfmt">=hl</span>]{sample}
+</pre><p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+The inner formatting may be split up in order to move them into the arguments of internal commands, such as those used for case-changing. This can result in unwanted side-effects. </div><!-- end of warning -->
+<p>
+The following uses <a id="wrglossary.6187"></a><a href="#glo:fbox"><code class="csfmt">\fbox</code></a> (which draws a frame around its argument) and <a id="wrglossary.6188"></a><a href="#glo:pkg.soul"><span class="styfmt">soul</span>’s</a> <a id="wrglossary.6189"></a><a href="#glo:so"><code class="csfmt">\so</code></a> (which spaces out the letters): <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><span class="comment">% requires glossaries.sty v4.50+ and mfirstuc v2.08+</span>
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.6190"></a><a href="#glo:glssentencecase"><code class="csfmt">\glssentencecase</code></a>}[1]{<a id="wrglossary.6191"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{#1}}
+<a id="wrglossary.6192"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{radar}{radar}{radio detection and ranging}
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.6193"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>[<a id="wrglossary.6194"></a><a href="#glo:opt.glsopt.innertextformat"><span class="csoptfmt">innertextformat</span></a><span class="optfmt">=fbox</span>]{radar}['s] system<code class="cmd">\ldots</code>
+
+<a id="wrglossary.6195"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>[<a id="wrglossary.6196"></a><a href="#glo:opt.glsopt.innertextformat"><span class="csoptfmt">innertextformat</span></a><span class="optfmt">=so</span>]{radar}['s] system<code class="cmd">\ldots</code>
+
+<a id="wrglossary.6197"></a><a href="#glo:fbox"><code class="csfmt">\fbox</code></a>{<a id="wrglossary.6198"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{radar}['s]} system<code class="cmd">\ldots</code>
+
+<a id="wrglossary.6199"></a><a href="#glo:so"><code class="csfmt">\so</code></a>{<a id="wrglossary.6200"></a><a href="#glo:mbox"><code class="csfmt">\mbox</code></a>{<a id="wrglossary.6201"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{radar}['s]}} system<code class="cmd">\ldots</code>
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:innerformat"></a>Example 100: Inner formatting <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example100.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example100.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example100.png" type="image/png" width="106" height="58">Example document illustrating inner formatting.</object> </div><!-- end of resultbox -->
+ Note the fragmentation of the inner formatting. The use of <a id="wrglossary.6202"></a><a href="#glo:mbox"><code class="csfmt">\mbox</code></a> in the final line prevents an error but the letters aren’t spaced out. The only way to deal with this case is to use <a id="wrglossary.6203"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a> or <a id="wrglossary.6204"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a> with the text explicitly written: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.6205"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a>{radar}{<a id="wrglossary.6206"></a><a href="#glo:so"><code class="csfmt">\so</code></a>{Radar's}} system<code class="cmd">\ldots</code>
+</pre><p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+The above example requires <a id="wrglossary.6207"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+. </div><!-- end of warning -->
+<p>
+Below are the commands used to support inner formatting.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6208"></a><code class="code"><dfn id="glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></dfn></code></div><!-- end of pinnedbox -->
+ This is the command that’s used to encapsulate any content that should have the <a id="wrglossary.6209"></a><a href="#glo:dual.innerformatting">inner formatting</a> applied. It should not be redefined within the document as it’s initialised within the <a id="wrglossary.6210"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.6211"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands. It’s used within <a id="wrglossary.6212"></a><a href="#glo:glsgenentryfmt"><code class="csfmt">\glsgenentryfmt</code></a> and included in the helper commands used by the predefined abbreviation styles.<p>
+Sometimes it may be necessary to include <a id="wrglossary.6213"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a> within the actual field value to ensure that it’s as close as possible to the text. This is performed automatically when an entry is defined if the <a id="wrglossary.6214"></a><a href="#glo:opt.catattr.encapinnerfmt"><span class="csoptfmt">encapinnerfmt</span></a> or <a id="wrglossary.6215"></a><a href="#glo:opt.catattr.encapnocaseinnerfmt"><span class="csoptfmt">encapnocaseinnerfmt</span></a> attributes are set. Note that even in this case, fragmentation will occur with <a id="wrglossary.6216"></a><a href="#glo:idx.sentencecase">sentence case</a> commands like <a id="wrglossary.6217"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> or with the insert optional argument, as in the above example with <a id="wrglossary.6218"></a><a href="#glo:fbox"><code class="csfmt">\fbox</code></a> and <a id="wrglossary.6219"></a><a href="#glo:so"><code class="csfmt">\so</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6220"></a><code class="code"><dfn id="glo:glsxtrdefaultentrytextfmt"><code class="csfmt">\glsxtrdefaultentrytextfmt</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is the default command that <a id="wrglossary.6221"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a> will be <a id="wrglossary.6222"></a><a href="#glo:let"><code class="csfmt">\let</code></a> to within the <a id="wrglossary.6223"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.6224"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands before their options are processed. This simply does its argument but may be redefined. (See Example <a href="#ex:protectinnertextformat">117</a>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6225"></a><code class="code"><dfn id="glo:glsxtrattrentrytextfmt"><code class="csfmt">\glsxtrattrentrytextfmt</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command applies formatting according to whether or not the <a id="wrglossary.6226"></a><a href="#glo:opt.catattr.innertextformat"><span class="csoptfmt">innertextformat</span></a> attribute is set. It isn’t used by default as it should rarely be needed and increases complexity. However, if you would like to provide support for the <a id="wrglossary.6227"></a><a href="#glo:opt.catattr.innertextformat"><span class="csoptfmt">innertextformat</span></a> attribute, you can redefine <a id="wrglossary.6228"></a><a href="#glo:glsxtrdefaultentrytextfmt"><code class="csfmt">\glsxtrdefaultentrytextfmt</code></a> to use <a id="wrglossary.6229"></a><a href="#glo:glsxtrattrentrytextfmt"><code class="csfmt">\glsxtrattrentrytextfmt</code></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.6230"></a><a href="#glo:glsxtrdefaultentrytextfmt"><code class="csfmt">\glsxtrdefaultentrytextfmt</code></a>}{<a id="wrglossary.6231"></a><a href="#glo:glsxtrattrentrytextfmt"><code class="csfmt">\glsxtrattrentrytextfmt</code></a>}
+</pre><p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+This command expects the entry label to be stored in <a id="wrglossary.6232"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a> (from which it obtains the category label). </div><!-- end of information -->
+<p>
+The <a id="wrglossary.6233"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands use <a id="wrglossary.6234"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a> within <a id="wrglossary.6235"></a><a href="#glo:glsgenentryfmt"><code class="csfmt">\glsgenentryfmt</code></a> for regular entries or within the abbreviation style commands for non-regular abbreviations (see §<a href="#sec:entryfmt">5.5.5</a>).<p>
+The <a id="wrglossary.6236"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands all essentially perform the following steps:
+<ol class="displaylist">
+ <li><span class="numitem">1.</span>Initialise the middle formatting command <span class="meta">〈<em class="metainner">field-font-cs</em>〉</span> used for encapsulating the field with <a id="wrglossary.6237"></a><a href="#glo:glsxtrassignfieldfont"><code class="csfmt">\glsxtrassignfieldfont</code></a> (see §<a href="#sec:middleformat">5.5.2</a>).<p>
+<li><span class="numitem">2.</span>If <a id="wrglossary.6238"></a><a href="#glo:glsifapplyinnerfmtfield"><code class="csfmt">\glsifapplyinnerfmtfield</code></a> indicates that the field value should be encapsulated by <a id="wrglossary.6239"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a>, then this essentially does (or appropriate case-change equivalent): <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><span class="meta">〈<em class="metainner">field-font-cs</em>〉</span>{<code class="cmd">\glsaccessfmt<span class="meta">〈<em class="metainner">field</em>〉</span></code>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<a id="wrglossary.6240"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">internal-field</em>〉</span>}}
+</pre> otherwise it does: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><span class="meta">〈<em class="metainner">field-font-cs</em>〉</span>{<code class="cmd">\glsaccess<span class="meta">〈<em class="metainner">field</em>〉</span></code>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}<a id="wrglossary.6241"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}}
+</pre> (See §<a href="#sec:accsupp">9</a> for the <span class="qt">“access”</span> commands.)
+</ol>
+<p>
+For example, the <a id="wrglossary.6242"></a><a href="#glo:dual.linktext">link text</a> for <a id="wrglossary.6243"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.6244"></a><a href="#glo:glsifapplyinnerfmtfield"><code class="csfmt">\glsifapplyinnerfmtfield</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{text}%
+{%
+ <span class="meta">〈<em class="metainner">field-font-cs</em>〉</span>{<a id="wrglossary.6245"></a><a href="#glo:glsaccessfmttext"><code class="csfmt">\glsaccessfmttext</code></a>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<a id="wrglossary.6246"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}}%
}%
-\renewcommand*{\glscombinedfirstsep}[2]{%
-&#x00A0;\glshasattribute{#1}{combinedfirstsep}%
-&#x00A0;{\glsgetattribute{#1}{combinedfirstsep}}%
-&#x00A0;{&#x00A0;}%
+{%
+ <span class="meta">〈<em class="metainner">field-font-cs</em>〉</span>{<a id="wrglossary.6247"></a><a href="#glo:glsaccesstext"><code class="csfmt">\glsaccesstext</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}<a id="wrglossary.6248"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}}%
+}
+</pre> The <code class="csfmt">\glsaccessfmt<span class="meta">〈<em class="metainner">field</em>〉</span></code> commands internally use <a id="wrglossary.6249"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a> to apply the <a id="wrglossary.6250"></a><a href="#glo:dual.innerformatting">inner formatting</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6251"></a><code class="code"><dfn id="glo:glsifapplyinnerfmtfield"><code class="csfmt">\glsifapplyinnerfmtfield</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">internal-field</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This determines whether or not the field identified by its <a id="wrglossary.6252"></a><a href="#glo:dual.internalfieldlabel">internal field label</a> for the given entry should have its value encapsulated by the <a id="wrglossary.6253"></a><a href="#glo:dual.innerformatting">inner formatting</a> command. False indicates that the field value already contains the <a id="wrglossary.6254"></a><a href="#glo:dual.innerformatting">inner formatting</a> command.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6255"></a><code class="code"><dfn id="glo:glsexclapplyinnerfmtfield"><code class="csfmt">\glsexclapplyinnerfmtfield</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">internal-field</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Locally adds the given field identified by its <a id="wrglossary.6256"></a><a href="#glo:dual.internalfieldlabel">internal field label</a> to the exclusion list for the given entry.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6257"></a><code class="code"><dfn id="glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">internal-field</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command applies the formatting command <span class="meta">〈<em class="metainner">cs</em>〉</span> (which takes one argument) to the entry’s field value identified by the given <a id="wrglossary.6258"></a><a href="#glo:dual.internalfieldlabel">internal field label</a>, including <span class="meta">〈<em class="metainner">insert</em>〉</span> appended. This ensures that the internal control sequence used to store the field’s value is expanded before <span class="meta">〈<em class="metainner">cs</em>〉</span> is applied.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6259"></a><code class="code"><dfn id="glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">internal-field</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.6260"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6261"></a><code class="code"><dfn id="glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">internal-field</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.6262"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+
+</section><!-- end of section sec:innertextformat -->
+
+<section id="sec:postlinkhook"><!-- start of section sec:postlinkhook --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->5.5.4. Post Link Hook<div class="labellink"><a href="#sec:postlinkhook">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+The <a id="wrglossary.6263"></a><a href="#glo:dual.postlinkhook">post-link hook</a> is a convenient way of automatically appending content after each instant of the <a id="wrglossary.6264"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.6265"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands. The simplest method of implementing this is with the <a id="wrglossary.6266"></a><a href="#glo:dual.catpostlinkhook">category post-link hook</a>, which is only applied to entries that have the given category. For example, the following will place an asterisk (*) after all entries with the default <a id="wrglossary.6267"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a> category: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.6268"></a><a href="#glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></a>{<a id="wrglossary.6269"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>}{*}
+<a id="wrglossary.6270"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.6271"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.6272"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={X}</span>,
+ <a id="wrglossary.6273"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.6274"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{sample}, <a id="wrglossary.6275"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>{sample}, <a id="wrglossary.6276"></a><a href="#glo:glsdesc"><code class="csfmt">\glsdesc</code></a>{sample}
+and <a id="wrglossary.6277"></a><a href="#glo:glssymbol"><code class="csfmt">\glssymbol</code></a>{sample}.
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:catpostlink"></a>Example 101: Category post-link hook <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example101.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example101.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example101.png" type="image/png" width="206" height="13">Example document illustrating a simple category post-link hook.</object> </div><!-- end of resultbox -->
+ Typically, the <a id="wrglossary.6278"></a><a href="#glo:dual.catpostlinkhook">category post-link hook</a> is more likely to include some conditional, such as to only insert text on <a id="wrglossary.6279"></a><a href="#glo:dual.firstuse">first use</a>. For example, <a id="wrglossary.6280"></a><a href="#glo:glsxtrpostlinkAddDescOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddDescOnFirstUse</code></a> can be used to insert the description in parentheses after the <a id="wrglossary.6281"></a><a href="#glo:dual.firstuse">first use</a>.<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+The <span class="qt">“post”</span> abbreviation styles all set the <a id="wrglossary.6282"></a><a href="#glo:dual.catpostlinkhook">category post-link hook</a>, which will overwrite any previous definition for the abbreviation’s category. </div><!-- end of warning -->
+<p>
+Within the <a id="wrglossary.6283"></a><a href="#glo:dual.postlinkhook">post-link hook</a>, you can use the placeholder commands, such as <a id="wrglossary.6284"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a> (see §<a href="#sec:entryfmt">5.5.5</a>), but note that you can’t use <a id="wrglossary.6285"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a> to determine whether or not the entry has been used, since the <a id="wrglossary.6286"></a><a href="#glo:dual.postlinkhook">post-link hook</a> comes after the entry has been unset. Instead, use <a id="wrglossary.6287"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a>. Additional commands provided for use within the <a id="wrglossary.6288"></a><a href="#glo:dual.postlinkhook">post-link hooks</a> are described in this section.<p>
+The <a id="wrglossary.6289"></a><a href="#glo:dual.postlinkhook">post-link hook</a> is implemented with <a id="wrglossary.6290"></a><a href="#glo:glspostlinkhook"><code class="csfmt">\glspostlinkhook</code></a>, which is defined by the base <a id="wrglossary.6291"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. It’s used at the end of the <a id="wrglossary.6292"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.6293"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands. The original base definition does nothing, but <a id="wrglossary.6294"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> redefines this: <pre class="compactcodebox"><code class="cmd">\renewcommand</code>*{<a id="wrglossary.6295"></a><a href="#glo:glspostlinkhook"><code class="csfmt">\glspostlinkhook</code></a>}{%
+ <a id="wrglossary.6296"></a><a href="#glo:ifglsentryexists"><code class="csfmt">\ifglsentryexists</code></a>{<a id="wrglossary.6297"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}{<a id="wrglossary.6298"></a><a href="#glo:glsxtrpostlinkhook"><code class="csfmt">\glsxtrpostlinkhook</code></a>}{}%
+}
+</pre> This uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6299"></a><code class="code"><dfn id="glo:glsxtrpostlinkhook"><code class="csfmt">\glsxtrpostlinkhook</code></dfn></code></div><!-- end of pinnedbox -->
+ which is the main <a id="wrglossary.6300"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> <a id="wrglossary.6301"></a><a href="#glo:dual.postlinkhook">post-link hook</a>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+If you are migrating over from only using the base <a id="wrglossary.6302"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package and you have redefined <a id="wrglossary.6303"></a><a href="#glo:glspostlinkhook"><code class="csfmt">\glspostlinkhook</code></a>, consider moving your modifications to the <a id="wrglossary.6304"></a><a href="#glo:dual.catpostlinkhook">category post-link hook</a> or prepend to <a id="wrglossary.6305"></a><a href="#glo:glsxtrpostlink"><code class="csfmt">\glsxtrpostlink</code></a>, as some attributes and abbreviation styles rely on the features provided by <a id="wrglossary.6306"></a><a href="#glo:glsxtrpostlinkhook"><code class="csfmt">\glsxtrpostlinkhook</code></a>. </div><!-- end of important -->
+<p>
+The main <a id="wrglossary.6307"></a><a href="#glo:dual.postlinkhook">post-link hook</a> is defined as: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.6308"></a><a href="#glo:glsxtrpostlinkhook"><code class="csfmt">\glsxtrpostlinkhook</code></a>}{%
+ <a id="wrglossary.6309"></a><a href="#glo:glsxtrdiscardperiod"><code class="csfmt">\glsxtrdiscardperiod</code></a>{<a id="wrglossary.6310"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}%
+ {<a id="wrglossary.6311"></a><a href="#glo:glsxtrpostlinkendsentence"><code class="csfmt">\glsxtrpostlinkendsentence</code></a>}%
+ {<a id="wrglossary.6312"></a><a href="#glo:glsxtrifcustomdiscardperiod"><code class="csfmt">\glsxtrifcustomdiscardperiod</code></a>
+ {<a id="wrglossary.6313"></a><a href="#glo:glsxtrifperiod"><code class="csfmt">\glsxtrifperiod</code></a>{<a id="wrglossary.6314"></a><a href="#glo:glsxtrpostlinkendsentence"><code class="csfmt">\glsxtrpostlinkendsentence</code></a>}{<a id="wrglossary.6315"></a><a href="#glo:glsxtrpostlink"><code class="csfmt">\glsxtrpostlink</code></a>}}%
+ {<a id="wrglossary.6316"></a><a href="#glo:glsxtrpostlink"><code class="csfmt">\glsxtrpostlink</code></a>}%
+ }%
+}
+</pre> This checks if a following <a id="wrglossary.6317"></a><a href="#glo:idx.fullstop">full stop</a> needs to be discarded and does the inner <a id="wrglossary.6318"></a><a href="#glo:dual.postlinkhook">post-link hook</a> <a id="wrglossary.6319"></a><a href="#glo:glsxtrpostlink"><code class="csfmt">\glsxtrpostlink</code></a>. Note that <a id="wrglossary.6320"></a><a href="#glo:glsxtrdiscardperiod"><code class="csfmt">\glsxtrdiscardperiod</code></a> and <a id="wrglossary.6321"></a><a href="#glo:glsxtrifperiod"><code class="csfmt">\glsxtrifperiod</code></a> look ahead for a following token, so if you need to modify this command, insert your custom code at the start or add it to the <a id="wrglossary.6322"></a><a href="#glo:dual.catpostlinkhook">category post-link hook</a> instead.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6323"></a><code class="code"><dfn id="glo:glsxtrdiscardperiod"><code class="csfmt">\glsxtrdiscardperiod</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">discarded</em>〉</span>}{<span class="meta">〈<em class="metainner">no discard</em>〉</span>}<span class="meta">〈<em class="metainner">token</em>〉</span></code></div><!-- end of pinnedbox -->
+ This discards <span class="meta">〈<em class="metainner">token</em>〉</span> if it’s a <a id="wrglossary.6324"></a><a href="#glo:idx.fullstop">full stop</a> and the entry’s <a id="wrglossary.6325"></a><a href="#glo:idx.categoryattribute">category attributes</a> indicate that a <a id="wrglossary.6326"></a><a href="#glo:idx.fullstop">full stop</a> should be discarded (such as <a id="wrglossary.6327"></a><a href="#glo:opt.catattr.discardperiod"><span class="csoptfmt">discardperiod</span></a>). If the punctuation character is discarded, this will then do <span class="meta">〈<em class="metainner">discarded</em>〉</span>, otherwise it will do <span class="meta">〈<em class="metainner">no discard</em>〉</span> and process <span class="meta">〈<em class="metainner">token</em>〉</span> as usual. If the <a id="wrglossary.6328"></a><a href="#glo:opt.catattr.retainfirstuseperiod"><span class="csoptfmt">retainfirstuseperiod</span></a> attribute is set, then the following command is used to determine whether or not to discard <span class="meta">〈<em class="metainner">token</em>〉</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6329"></a><code class="code"><dfn id="glo:glsxtrdiscardperiodretainfirstuse"><code class="csfmt">\glsxtrdiscardperiodretainfirstuse</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">discarded</em>〉</span>}{<span class="meta">〈<em class="metainner">no discard</em>〉</span>}<span class="meta">〈<em class="metainner">token</em>〉</span></code></div><!-- end of pinnedbox -->
+ This was introduced in v1.49 and is defined as: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.6330"></a><a href="#glo:glsxtrdiscardperiodretainfirstuse"><code class="csfmt">\glsxtrdiscardperiodretainfirstuse</code></a>}[3]{<span class="comment">% </span>
+ <a id="wrglossary.6331"></a><a href="#glo:glsxtrifwassubsequentorshort"><code class="csfmt">\glsxtrifwassubsequentorshort</code></a>{<a id="wrglossary.6332"></a><a href="#glo:glsxtrifperiod"><code class="csfmt">\glsxtrifperiod</code></a>{#2}{#3}}{#3}<span class="comment">% </span>
+}
+</pre> This will only discard the <a id="wrglossary.6333"></a><a href="#glo:idx.fullstop">full stop</a> if it follows the <a id="wrglossary.6334"></a><a href="#glo:dual.subsequentuse">subsequent use</a> of a <a id="wrglossary.6335"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> command or if it follows one of the <a id="wrglossary.6336"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> set of commands. Note that this has a different effect from pre v1.49 with the <a id="wrglossary.6337"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands, but it’s more appropriate since it’s typically only the short form that requires the period to be discarded. To restore the original behaviour: <pre class="compactcodebox"><code class="cmd">\renewcommand</code>*{<a id="wrglossary.6338"></a><a href="#glo:glsxtrdiscardperiodretainfirstuse"><code class="csfmt">\glsxtrdiscardperiodretainfirstuse</code></a>}[3]{<span class="comment">% </span>
+ <a id="wrglossary.6339"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a>{#3}{<a id="wrglossary.6340"></a><a href="#glo:glsxtrifperiod"><code class="csfmt">\glsxtrifperiod</code></a>{#2}{#3}}<span class="comment">% </span>
+}
+</pre><p>
+If you want your own custom code to determine whether or not to check for a period (instead of using known category attributes), you can redefine: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6341"></a><code class="code"><dfn id="glo:glsxtrifcustomdiscardperiod"><code class="csfmt">\glsxtrifcustomdiscardperiod</code></dfn>{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">initial: </span><span class="meta">〈<em class="metainner">false</em>〉</span></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This should expand to <span class="meta">〈<em class="metainner">true</em>〉</span> if a check should be performed, otherwise it should expand to <span class="meta">〈<em class="metainner">false</em>〉</span>. The default definition simply does <span class="meta">〈<em class="metainner">false</em>〉</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6342"></a><code class="code"><dfn id="glo:glsxtrpostlinkendsentence"><code class="csfmt">\glsxtrpostlinkendsentence</code></dfn></code></div><!-- end of pinnedbox -->
+ This is done if a <a id="wrglossary.6343"></a><a href="#glo:idx.fullstop">full stop</a> is discarded. If there is a <a id="wrglossary.6344"></a><a href="#glo:dual.catpostlinkhook">category post-link hook</a> for the entry’s category, that hook is performed (<a id="wrglossary.6345"></a><a href="#glo:glsxtrpostlinkcat"><code class="csfmt">\glsxtrpostlink<span class="meta">〈<em class="metainner">category</em>〉</span></code></a> not <a id="wrglossary.6346"></a><a href="#glo:glsxtrpostlink"><code class="csfmt">\glsxtrpostlink</code></a>) and the <a id="wrglossary.6347"></a><a href="#glo:idx.fullstop">full stop</a> is put back followed by a space factor adjustment. Otherwise, just the space factor adjustment is done.<p>
+The test to determine whether or not <span class="meta">〈<em class="metainner">token</em>〉</span> is a <a id="wrglossary.6348"></a><a href="#glo:idx.fullstop">full stop</a> is determined by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6349"></a><code class="code"><dfn id="glo:glsxtrifperiod"><code class="csfmt">\glsxtrifperiod</code></dfn>{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}<span class="meta">〈<em class="metainner">token</em>〉</span></code></div><!-- end of pinnedbox -->
+<p>
+It may be useful to test for other punctuation characters. For example, styles such as <a id="wrglossary.6350"></a><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></a> will move the footnote after certain punctuation characters. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6351"></a><code class="code"><dfn id="glo:glsxtrifnextpunc"><code class="csfmt">\glsxtrifnextpunc</code></dfn>{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does <span class="meta">〈<em class="metainner">true</em>〉</span> if it’s followed by one of the set of recognised punctuation characters, otherwise it does false. The set is initialised to <code class="code">.,:;?!</code> (<a id="wrglossary.6352"></a><a href="#glo:idx.fullstop">full stop</a>, comma, colon, semi-colon, question mark, and exclamation mark).<p>
+A convenient way of moving code after the punctuation character is to use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6353"></a><code class="code"><dfn id="glo:glsxtrdopostpunc"><code class="csfmt">\glsxtrdopostpunc</code></dfn>{<span class="meta">〈<em class="metainner">code</em>〉</span>}<span class="meta">〈<em class="metainner">token</em>〉</span></code></div><!-- end of pinnedbox -->
+ If <span class="meta">〈<em class="metainner">token</em>〉</span> is a recognised punctuation character, this will place <span class="meta">〈<em class="metainner">code</em>〉</span> after the token, otherwise it will be placed before the token.<p>
+The earlier example can be adapted to put the asterisk after following punctuation: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.6354"></a><a href="#glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></a>{<a id="wrglossary.6355"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>}{<a id="wrglossary.6356"></a><a href="#glo:glsxtrdopostpunc"><code class="csfmt">\glsxtrdopostpunc</code></a>{*}}
+<a id="wrglossary.6357"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.6358"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.6359"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={X}</span>,
+ <a id="wrglossary.6360"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.6361"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{sample}, <a id="wrglossary.6362"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>{sample},
+(<a id="wrglossary.6363"></a><a href="#glo:glsdesc"><code class="csfmt">\glsdesc</code></a>{sample}) and <a id="wrglossary.6364"></a><a href="#glo:glssymbol"><code class="csfmt">\glssymbol</code></a>{sample}.
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:catpostlinkpunc"></a>Example 102: Category post-link hook with punctuation lookahead <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example102.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example102.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example102.png" type="image/png" width="215" height="13">Example document illustrating a category post-link hook that transfers content after a following punctuation character.</object> </div><!-- end of resultbox -->
+ Note that the asterisk isn’t moved after the closing parenthesis. This is because that character isn’t included in the default list.<p>
+You can add additional punctuation marks with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6365"></a><code class="code"><dfn id="glo:glsxtraddpunctuationmark"><code class="csfmt">\glsxtraddpunctuationmark</code></dfn>{<span class="meta">〈<em class="metainner">token(s)</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ You may list multiple characters at the same time to add a batch, but don’t add any separators (including spaces).<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Note that each character must be a single token, which means a single-byte character for pdfLaTeX. Multi-byte characters (<a id="wrglossary.6366"></a><a href="#glo:dual.utf8">UTF-8</a>) will required a native Unicode engine (XeLaTeX or LuaLaTeX). </div><!-- end of important -->
+<p>
+For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.6367"></a><a href="#glo:glsxtraddpunctuationmark"><code class="csfmt">\glsxtraddpunctuationmark</code></a>{-'/}
+</pre> This adds three extra punctuation marks (hyphen, apostrophe and slash). Note that this doesn’t allow for closing double-quotes and will break <code class="code">''</code> (double apostrophe sequence for a closing double-quote) if found. The following will only work with XeLaTeX or LuaLaTeX: <pre class="unicodebox"><div class="unicodeboxtitle"><a href="#glo:sym.unicode"><span title="Unicode Input" class="icon"><span class="overlapped">🗋</span><span class="overlapper">U</span></span></a></div><code class="cmd">\usepackage</code>{fontspec}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+<a id="wrglossary.6368"></a><a href="#glo:glsxtraddpunctuationmark"><code class="csfmt">\glsxtraddpunctuationmark</code></a>{<span style="font-family: serif; ">”</span>}
+</pre><p>
+You can set the list with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6369"></a><code class="code"><dfn id="glo:glsxtrsetpunctuationmarks"><code class="csfmt">\glsxtrsetpunctuationmarks</code></dfn>{<span class="meta">〈<em class="metainner">token list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This will remove the default set as well as any additional characters. As above, each character must be a single token with no separators in the list. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.6370"></a><a href="#glo:glsxtrsetpunctuationmarks"><code class="csfmt">\glsxtrsetpunctuationmarks</code></a>{.?!}
+</pre> This sets the list to just three punctuation characters (so comma, colon, and semi-colon are no longer recognised).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6371"></a><code class="code"><dfn id="glo:glsxtrpostlink"><code class="csfmt">\glsxtrpostlink</code></dfn></code></div><!-- end of pinnedbox -->
+ This does the <a id="wrglossary.6372"></a><a href="#glo:dual.catpostlinkhook">category post-link hook</a> (or nothing if it hasn’t been defined): <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.6373"></a><a href="#glo:glsxtrpostlink"><code class="csfmt">\glsxtrpostlink</code></a>}{%
+ <code class="cmd">\csuse</code>{glsxtrpostlink<a id="wrglossary.6374"></a><a href="#glo:glscategory"><code class="csfmt">\glscategory</code></a>{<a id="wrglossary.6375"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}}%
+}
+</pre> Customisation is best performed within the <a id="wrglossary.6376"></a><a href="#glo:dual.catpostlinkhook">category post-link hook</a>, which can be defined (or redefined) with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6377"></a><code class="code"><dfn id="glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">definition</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The first argument is the category label and the second is the code to perform. Note that this doesn’t check if the hook has already been defined for the category. The hook is a command in the form <a id="wrglossary.6378"></a><a href="#glo:glsxtrpostlinkcat"><code class="csfmt">\glsxtrpostlink<span class="meta">〈<em class="metainner">category</em>〉</span></code></a>. If the category label only consists of letters, you can also use <a id="wrglossary.6379"></a><a href="#glo:newcommand"><code class="csfmt">\newcommand</code></a> or <a id="wrglossary.6380"></a><a href="#glo:renewcommand"><code class="csfmt">\renewcommand</code></a> instead.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6381"></a><code class="code"><dfn id="glo:glspretopostlink"><code class="csfmt">\glspretopostlink</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">code</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Similar to the above but prepends <span class="meta">〈<em class="metainner">code</em>〉</span> to the associated hook (or simply defines it, if the hook doesn’t already exist).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6382"></a><code class="code"><dfn id="glo:glsapptopostlink"><code class="csfmt">\glsapptopostlink</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">code</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Similar to the above but appends <span class="meta">〈<em class="metainner">code</em>〉</span> to the associated hook.<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+Take care not to choose category labels that will cause a conflict. For example, <code class="code">endsentence</code> and <code class="code">hook</code> will conflict with the commands <a id="wrglossary.6383"></a><a href="#glo:glsxtrpostlinkendsentence"><code class="csfmt">\glsxtrpostlinkendsentence</code></a> and <a id="wrglossary.6384"></a><a href="#glo:glsxtrpostlinkhook"><code class="csfmt">\glsxtrpostlinkhook</code></a>. </div><!-- end of warning -->
+<p>
+If you want code in the <a id="wrglossary.6385"></a><a href="#glo:dual.postlinkhook">post-link hook</a> that’s not dependent on the category, consider prepending it to <a id="wrglossary.6386"></a><a href="#glo:glsxtrpostlink"><code class="csfmt">\glsxtrpostlink</code></a> or <a id="wrglossary.6387"></a><a href="#glo:glsxtrpostlinkhook"><code class="csfmt">\glsxtrpostlinkhook</code></a>. Don’t append it to <a id="wrglossary.6388"></a><a href="#glo:glsxtrpostlinkhook"><code class="csfmt">\glsxtrpostlinkhook</code></a> otherwise it will interfere with the punctuation lookahead.<p>
+For convenience, some commands are provided that may be of use in the <a id="wrglossary.6389"></a><a href="#glo:dual.catpostlinkhook">category post-link hook</a>:<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6390"></a><code class="code"><dfn id="glo:glsxtrpostlinkAddDescOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddDescOnFirstUse</code></dfn></code></div><!-- end of pinnedbox -->
+ This will add the <a id="wrglossary.6391"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> in parentheses if the hook follows the <a id="wrglossary.6392"></a><a href="#glo:dual.firstuse">first use</a> of the entry. This incorporates the inner formatting and description accessibility support, if provided.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6393"></a><code class="code"><dfn id="glo:glsxtrpostlinkAddSymbolOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddSymbolOnFirstUse</code></dfn></code></div><!-- end of pinnedbox -->
+ This will add the <a id="wrglossary.6394"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> in parentheses if that field is set and the hook follows the <a id="wrglossary.6395"></a><a href="#glo:dual.firstuse">first use</a> of the entry. This incorporates the inner formatting and symbol accessibility support, if provided.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6396"></a><code class="code"><dfn id="glo:glsxtrpostlinkAddSymbolDescOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddSymbolDescOnFirstUse</code></dfn></code></div><!-- end of pinnedbox -->
+ This will add the <a id="wrglossary.6397"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a>, if that field is set, and the <a id="wrglossary.6398"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> (both within the same set of parentheses), if the hook follows the <a id="wrglossary.6399"></a><a href="#glo:dual.firstuse">first use</a> of the entry. This incorporates the inner formatting and accessibility support, if provided. The separator between the symbol and description is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6400"></a><code class="code"><dfn id="glo:glsxtrpostlinkSymbolDescSep"><code class="csfmt">\glsxtrpostlinkSymbolDescSep</code></dfn></code></div><!-- end of pinnedbox -->
+ The default is a comma followed by a space.<p>
+For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.6401"></a><a href="#glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></a>{<a id="wrglossary.6402"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>}{<a id="wrglossary.6403"></a><a href="#glo:glsxtrpostlinkAddDescOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddDescOnFirstUse</code></a>}
+<a id="wrglossary.6404"></a><a href="#glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></a>{<a id="wrglossary.6405"></a><a href="#glo:opt.cat.symbol"><span class="csoptfmt">symbol</span></a>}{<a id="wrglossary.6406"></a><a href="#glo:glsxtrpostlinkAddSymbolOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddSymbolOnFirstUse</code></a>}
+<a id="wrglossary.6407"></a><a href="#glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></a>{<a id="wrglossary.6408"></a><a href="#glo:opt.cat.number"><span class="csoptfmt">number</span></a>}{<a id="wrglossary.6409"></a><a href="#glo:glsxtrpostlinkAddSymbolDescOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddSymbolDescOnFirstUse</code></a>}
+<a id="wrglossary.6410"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.6411"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.6412"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+<a id="wrglossary.6413"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.6414"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={alpha}</span>,<a id="wrglossary.6415"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\alpha</code>}}</span>,
+ <a id="wrglossary.6416"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a symbol}</span>,<a id="wrglossary.6417"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={<a id="wrglossary.6418"></a><a href="#glo:opt.cat.symbol"><span class="csoptfmt">symbol</span></a>}</span>}
+<a id="wrglossary.6419"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{pi}{<a id="wrglossary.6420"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={pi}</span>,<a id="wrglossary.6421"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\pi</code>}}</span>,
+ <a id="wrglossary.6422"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a constant}</span>,<a id="wrglossary.6423"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={<a id="wrglossary.6424"></a><a href="#glo:opt.cat.number"><span class="csoptfmt">number</span></a>}</span>}
+<code class="cbeg">\begin{document}</code>
+First use: <a id="wrglossary.6425"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}, <a id="wrglossary.6426"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}, <a id="wrglossary.6427"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{pi}.
+
+Next use: <a id="wrglossary.6428"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}, <a id="wrglossary.6429"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}, <a id="wrglossary.6430"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{pi}.
+<code class="cend">\end{document}</code>
+</pre> This produces: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:catpostlinkfirstuse"></a>Example 103: Category post-link hooks <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example103.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example103.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example103.png" type="image/png" width="316" height="27">Example document that uses category post-link hooks to append additional information after the link text on first use.</object> </div><!-- end of resultbox -->
+<p>
+The following commands are also provided for use in the <a id="wrglossary.6431"></a><a href="#glo:dual.postlinkhook">post-link hook</a>:<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6432"></a><code class="code"><dfn id="glo:glsxtrcurrentfield"><code class="csfmt">\glsxtrcurrentfield</code></dfn></code></div><!-- end of pinnedbox -->
+ This expands to empty if the calling command isn’t associated with one specific field (such as <a id="wrglossary.6433"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a>, the <a id="wrglossary.6434"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands, the <a id="wrglossary.6435"></a><a href="#glo:dual.inlinefullform">inline full form</a> commands) otherwise it will expand to the name of the key associated with the <span style="font-style: italic; font-variant: normal; ">singular</span> form of the command. For example, this command will expand to <code class="code">text</code> for both <a id="wrglossary.6436"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> and <a id="wrglossary.6437"></a><a href="#glo:glsplural"><code class="csfmt">\glsplural</code></a>, to <code class="code">description</code> for both <a id="wrglossary.6438"></a><a href="#glo:glsdesc"><code class="csfmt">\glsdesc</code></a> and <a id="wrglossary.6439"></a><a href="#glo:glsdescplural"><code class="csfmt">\glsdescplural</code></a>, and to <code class="code">short</code> for both <a id="wrglossary.6440"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> and <a id="wrglossary.6441"></a><a href="#glo:glsxtrshortpl"><code class="csfmt">\glsxtrshortpl</code></a>. Whereas it will expand to nothing for both <a id="wrglossary.6442"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> and <a id="wrglossary.6443"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6444"></a><code class="code"><dfn id="glo:glsxtrifwasglslike"><code class="csfmt">\glsxtrifwasglslike</code></dfn>{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This expands to <span class="meta">〈<em class="metainner">true</em>〉</span> if the calling command was a <a id="wrglossary.6445"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> command and to <span class="meta">〈<em class="metainner">false</em>〉</span> otherwise.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6446"></a><code class="code"><dfn id="glo:glsxtrifwasglslikeandfirstuse"><code class="csfmt">\glsxtrifwasglslikeandfirstuse</code></dfn>{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This expands to <span class="meta">〈<em class="metainner">true</em>〉</span> if the calling command was a <a id="wrglossary.6447"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> command and was the <a id="wrglossary.6448"></a><a href="#glo:dual.firstuse">first use</a> otherwise it expands to <span class="meta">〈<em class="metainner">false</em>〉</span>. This is simply a shortcut command that uses both <a id="wrglossary.6449"></a><a href="#glo:glsxtrifwasglslike"><code class="csfmt">\glsxtrifwasglslike</code></a> and <a id="wrglossary.6450"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6451"></a><code class="code"><dfn id="glo:glsxtrifwassubsequentuse"><code class="csfmt">\glsxtrifwassubsequentuse</code></dfn>{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This expands to <span class="meta">〈<em class="metainner">true</em>〉</span> if the calling command was a <a id="wrglossary.6452"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> command and was the <a id="wrglossary.6453"></a><a href="#glo:dual.subsequentuse">subsequent use</a> otherwise it expands to <span class="meta">〈<em class="metainner">false</em>〉</span>. This is simply a shortcut command that uses both <a id="wrglossary.6454"></a><a href="#glo:glsxtrifwasglslike"><code class="csfmt">\glsxtrifwasglslike</code></a> and <a id="wrglossary.6455"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6456"></a><code class="code"><dfn id="glo:glsxtrifwassubsequentorshort"><code class="csfmt">\glsxtrifwassubsequentorshort</code></dfn>{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This expands to <span class="meta">〈<em class="metainner">true</em>〉</span> if the calling command was a <a id="wrglossary.6457"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> command and was the <a id="wrglossary.6458"></a><a href="#glo:dual.subsequentuse">subsequent use</a> or if the calling command set <a id="wrglossary.6459"></a><a href="#glo:glsxtrcurrentfield"><code class="csfmt">\glsxtrcurrentfield</code></a> to <code class="code">short</code>. Otherwise it expands to <span class="meta">〈<em class="metainner">false</em>〉</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6460"></a><code class="code"><dfn id="glo:glsxtrifallcaps"><code class="csfmt">\glsxtrifallcaps</code></dfn>{<span class="meta">〈<em class="metainner">all caps</em>〉</span>}{<span class="meta">〈<em class="metainner">not all caps</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This simply does: <pre class="compactcodebox"><a id="wrglossary.6461"></a><a href="#glo:glscapscase"><code class="csfmt">\glscapscase</code></a>{<span class="meta">〈<em class="metainner">not all caps</em>〉</span>}{<span class="meta">〈<em class="metainner">not all caps</em>〉</span>}{<span class="meta">〈<em class="metainner">all caps</em>〉</span>}
+</pre> It’s not usually necessary for the <a id="wrglossary.6462"></a><a href="#glo:dual.postlinkhook">post-link hook</a> to differentiate between no case-change and <a id="wrglossary.6463"></a><a href="#glo:idx.sentencecase">sentence case</a>, so this provides a convenient shortcut if only the <a id="wrglossary.6464"></a><a href="#glo:idx.allcaps">all caps</a> case needs to be different.<p>
+It’s possible you may also want to reference the inserted material. For the <a id="wrglossary.6465"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands, this can be obtained with the placeholder <a id="wrglossary.6466"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a>, but it’s not normally set by the <a id="wrglossary.6467"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands, which don’t use the entry format style (§<a href="#sec:entryfmt">5.5.5</a>) and instead incorporate the inserted material at the end of the <a id="wrglossary.6468"></a><a href="#glo:dual.linktext">link text</a>. If you want the <a id="wrglossary.6469"></a><a href="#glo:dual.postlinkhook">post-link hook</a> to be able to access the inserted material for the <a id="wrglossary.6470"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands, you must first save it, by redefining the following:<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6471"></a><code class="code"><dfn id="glo:glsxtrsaveinsert"><code class="csfmt">\glsxtrsaveinsert</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is used by the <a id="wrglossary.6472"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands to initialise <a id="wrglossary.6473"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a>. The default is: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.6474"></a><a href="#glo:glsxtrsaveinsert"><code class="csfmt">\glsxtrsaveinsert</code></a>}[2]{<code class="cmd">\def</code><a id="wrglossary.6475"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a>{}}
+</pre> For example, to always save the insert: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.6476"></a><a href="#glo:glsxtrsaveinsert"><code class="csfmt">\glsxtrsaveinsert</code></a>}[2]{<code class="cmd">\def</code><a id="wrglossary.6477"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a>{#2}}
+</pre> The first argument can be used to conditionally assign the insert. For example, the following will only save it for entries with the <a id="wrglossary.6478"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a> category: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.6479"></a><a href="#glo:glsxtrsaveinsert"><code class="csfmt">\glsxtrsaveinsert</code></a>}[2]{%
+ <a id="wrglossary.6480"></a><a href="#glo:glsifcategory"><code class="csfmt">\glsifcategory</code></a>{#1}{<a id="wrglossary.6481"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>}{<code class="cmd">\def</code><a id="wrglossary.6482"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a>{#2}}{<code class="cmd">\def</code><a id="wrglossary.6483"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a>{}}%
+}
+</pre><p>
+If you only want to save the insert for the <a id="wrglossary.6484"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> set of commands, you can redefine <a id="wrglossary.6485"></a><a href="#glo:glsxtrfullsaveinsert"><code class="csfmt">\glsxtrfullsaveinsert</code></a> instead (see §<a href="#sec:abbrvfieldrefs">4.3</a>).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6486"></a><code class="code"><dfn id="glo:glsxtrassignlinktextfmt"><code class="csfmt">\glsxtrassignlinktextfmt</code></dfn></code></div><!-- end of pinnedbox -->
+ This contains the assignments required to ensure that <a id="wrglossary.6487"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>, <a id="wrglossary.6488"></a><a href="#glo:glstextformat"><code class="csfmt">\glstextformat</code></a> and <a id="wrglossary.6489"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a> have the definitions they had within the <a id="wrglossary.6490"></a><a href="#glo:dual.linktext">link text</a>. They would ordinarily still have those definitions within the <a id="wrglossary.6491"></a><a href="#glo:dual.postlinkhook">post-link hook</a>, but if, for example, the hook contains content that may be deferred, such as a footnote, then judicious use and expansion of <a id="wrglossary.6492"></a><a href="#glo:glsxtrassignlinktextfmt"><code class="csfmt">\glsxtrassignlinktextfmt</code></a> can allow the deferred code to pick up the label, outer and inner formatting.<p>
+For example, the <a id="wrglossary.6493"></a><a href="#glo:dual.postlinkhook">post-link hook</a> might contain: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.6494"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a><a id="wrglossary.6495"></a><a href="#glo:footnote"><code class="csfmt">\footnote</code></a><a id="wrglossary.6496"></a><a href="#glo:expandafter"><code class="csfmt">\expandafter</code></a>
+ {<a id="wrglossary.6497"></a><a href="#glo:glsxtrassignlinktextfmt"><code class="csfmt">\glsxtrassignlinktextfmt</code></a><a id="wrglossary.6498"></a><a href="#glo:glstextformat"><code class="csfmt">\glstextformat</code></a>{%
+ <a id="wrglossary.6499"></a><a href="#glo:Glsaccessfmtdesc"><code class="csfmt">\Glsaccessfmtdesc</code></a>{}{<a id="wrglossary.6500"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a>}{<a id="wrglossary.6501"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}}.}
+</pre><p>
+
+</section><!-- end of section sec:postlinkhook -->
+
+<section id="sec:entryfmt"><!-- start of section sec:entryfmt --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->5.5.5. Entry Format Style<div class="labellink"><a href="#sec:entryfmt">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+This section is for advanced users. Minor modifications can be made by adjusting the outer formatting (§<a href="#sec:glstextformat">5.5.1</a>), the <a id="wrglossary.6502"></a><a href="#glo:dual.postlinkhook">post-link hook</a> (§<a href="#sec:postlinkhook">5.5.4</a>) or the abbreviation style commands (§<a href="#sec:abbrvcmds">4.5.1.3</a>). </div><!-- end of information -->
+<p>
+The <a id="wrglossary.6503"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands have the <a id="wrglossary.6504"></a><a href="#glo:dual.linktext">link text</a> set to the entry format style corresponding to the entry’s glossary <a id="wrglossary.6505"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a>. This can be changed with <a id="wrglossary.6506"></a><a href="#glo:defglsentryfmt"><code class="csfmt">\defglsentryfmt</code></a>, but the default style is given by <a id="wrglossary.6507"></a><a href="#glo:glsentryfmt"><code class="csfmt">\glsentryfmt</code></a>, which is defined by the base <a id="wrglossary.6508"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. This uses the placeholder commands to determine the appropriate text. These are described in the <a id="wrglossary.6509"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> manual, but to recap they are: <a id="wrglossary.6510"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a> (the entry’s label), <a id="wrglossary.6511"></a><a href="#glo:glscustomtext"><code class="csfmt">\glscustomtext</code></a> (text provided by <a id="wrglossary.6512"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a> or empty otherwise), <a id="wrglossary.6513"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a> (supplied in the final optional argument except for <a id="wrglossary.6514"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a>, empty by default), <a id="wrglossary.6515"></a><a href="#glo:glsifplural"><code class="csfmt">\glsifplural</code></a>, and <a id="wrglossary.6516"></a><a href="#glo:glscapscase"><code class="csfmt">\glscapscase</code></a>.<p>
+The <a id="wrglossary.6517"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package redefines <a id="wrglossary.6518"></a><a href="#glo:glsentryfmt"><code class="csfmt">\glsentryfmt</code></a> to test whether or not the entry is an abbreviation and, if so, whether or not the entry should be treated as a regular entry: <pre class="compactcodebox"><code class="cmd">\renewcommand</code>*{<a id="wrglossary.6519"></a><a href="#glo:glsentryfmt"><code class="csfmt">\glsentryfmt</code></a>}{%
+ <a id="wrglossary.6520"></a><a href="#glo:ifglshasshort"><code class="csfmt">\ifglshasshort</code></a>{<a id="wrglossary.6521"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}
+ {<a id="wrglossary.6522"></a><a href="#glo:glssetabbrvfmt"><code class="csfmt">\glssetabbrvfmt</code></a>{<a id="wrglossary.6523"></a><a href="#glo:glscategory"><code class="csfmt">\glscategory</code></a>{<a id="wrglossary.6524"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}}}{}%
+ <a id="wrglossary.6525"></a><a href="#glo:glsifregular"><code class="csfmt">\glsifregular</code></a>{<a id="wrglossary.6526"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}%
+ {<a id="wrglossary.6527"></a><a href="#glo:glsxtrregularfont"><code class="csfmt">\glsxtrregularfont</code></a>{<a id="wrglossary.6528"></a><a href="#glo:glsgenentryfmt"><code class="csfmt">\glsgenentryfmt</code></a>}}%
+ {%
+ <a id="wrglossary.6529"></a><a href="#glo:ifglshasshort"><code class="csfmt">\ifglshasshort</code></a>{<a id="wrglossary.6530"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}%
+ {<a id="wrglossary.6531"></a><a href="#glo:glsxtrabbreviationfont"><code class="csfmt">\glsxtrabbreviationfont</code></a>{<a id="wrglossary.6532"></a><a href="#glo:glsxtrgenabbrvfmt"><code class="csfmt">\glsxtrgenabbrvfmt</code></a>}}%
+ {<a id="wrglossary.6533"></a><a href="#glo:glsxtrregularfont"><code class="csfmt">\glsxtrregularfont</code></a>{<a id="wrglossary.6534"></a><a href="#glo:glsgenentryfmt"><code class="csfmt">\glsgenentryfmt</code></a>}}%
+ }%
+}
+</pre> This uses <a id="wrglossary.6535"></a><a href="#glo:ifglshasshort"><code class="csfmt">\ifglshasshort</code></a> to determine whether or not the entry is an abbreviation. If it is, then <a id="wrglossary.6536"></a><a href="#glo:glssetabbrvfmt"><code class="csfmt">\glssetabbrvfmt</code></a> is used to setup the abbreviation style commands for the entry’s category.<p>
+Then there’s a check (with <a id="wrglossary.6537"></a><a href="#glo:glsifregular"><code class="csfmt">\glsifregular</code></a>) to determine whether or not the entry should be treated as a regular entry. Note that if the <a id="wrglossary.6538"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute hasn’t been set to <code class="code">true</code>, the entry will still be treated as a regular entry if it doesn’t have the <a id="wrglossary.6539"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> field set.<p>
+Regular entries are formatted according to: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6540"></a><code class="code"><dfn id="glo:glsgenentryfmt"><code class="csfmt">\glsgenentryfmt</code></dfn></code></div><!-- end of pinnedbox -->
+ This is the generic regular entry format. It’s encapsulated with <a id="wrglossary.6541"></a><a href="#glo:glsxtrregularfont"><code class="csfmt">\glsxtrregularfont</code></a>, but note that if the entry is an abbreviation, it will still use the abbreviation style formatting commands, which are contained within the <a id="wrglossary.6542"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a>, <a id="wrglossary.6543"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a>, <a id="wrglossary.6544"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> and <a id="wrglossary.6545"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> field values.<p>
+The generic regular entry format <a id="wrglossary.6546"></a><a href="#glo:glsgenentryfmt"><code class="csfmt">\glsgenentryfmt</code></a> is provided by the base <a id="wrglossary.6547"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, but is redefined by <a id="wrglossary.6548"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> to support inner formatting (§<a href="#sec:innertextformat">5.5.3</a>) and accessibility (§<a href="#sec:accsupp">9</a>), if required.<p>
+Abbreviations that aren’t considered regular, are formatted according to: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6549"></a><code class="code"><dfn id="glo:glsxtrgenabbrvfmt"><code class="csfmt">\glsxtrgenabbrvfmt</code></dfn></code></div><!-- end of pinnedbox -->
+ This is the generic non-regular abbreviation format. It’s encapsulated with <a id="wrglossary.6550"></a><a href="#glo:glsxtrabbreviationfont"><code class="csfmt">\glsxtrabbreviationfont</code></a>. Unlike <a id="wrglossary.6551"></a><a href="#glo:glsgenentryfmt"><code class="csfmt">\glsgenentryfmt</code></a> this doesn’t reference the <a id="wrglossary.6552"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a>, <a id="wrglossary.6553"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a>, <a id="wrglossary.6554"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> or <a id="wrglossary.6555"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> fields, but instead uses the abbreviation formatting commands <a id="wrglossary.6556"></a><a href="#glo:glsxtrfullformat"><code class="csfmt">\glsxtrfullformat</code></a>, <a id="wrglossary.6557"></a><a href="#glo:glsxtrsubsequentfmt"><code class="csfmt">\glsxtrsubsequentfmt</code></a> and their plural and case-changing variants.<p>
+If you want to define your own custom entry format, you will need to consider whether or not your format should support regular and non-regular abbreviation styles. Further detail can be found in the documented code: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div><a href="https://www.tug.org/texdoc/">texdoc</a> glossaries-extra-code</pre><p>
+
+</section><!-- end of section sec:entryfmt -->
+
+<section id="sec:hyper"><!-- start of section sec:hyper --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->5.6. Hyperlinks<div class="labellink"><a href="#sec:hyper">[link]</a></div></h2><!-- end of section header -->
+<p>
+The <a id="wrglossary.6558"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.6559"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands will automatically create a hyperlink by default, if <a id="wrglossary.6560"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> has been loaded (before <a id="wrglossary.6561"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>/<a id="wrglossary.6562"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>). The hyperlink can be switched off with <a id="wrglossary.6563"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span> but will also be switched off if the entry was assigned to an <a id="wrglossary.6564"></a><a href="#glo:dual.ignoredglossary">ignored glossary</a> that was defined with the unstarred <a id="wrglossary.6565"></a><a href="#glo:newignoredglossary"><code class="csfmt">\newignoredglossary</code></a>.<p>
+The <a id="wrglossary.6566"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a><span class="optfmt">=false</span> package option and the category attributes <a id="wrglossary.6567"></a><a href="#glo:opt.catattr.nohyper"><span class="csoptfmt">nohyper</span></a>, <a id="wrglossary.6568"></a><a href="#glo:opt.catattr.nohyperfirst"><span class="csoptfmt">nohyperfirst</span></a> and <a id="wrglossary.6569"></a><a href="#glo:opt.catattr.nohypernext"><span class="csoptfmt">nohypernext</span></a> can also be used to automatically switch off the hyperlink. See also the <a id="wrglossary.6570"></a><a href="#glo:opt.glsopt.hyperoutside"><span class="csoptfmt">hyperoutside</span></a> option that determines whether the hyperlink should be inside or outside of the outer formatting.<p>
+The hyperlink target is usually created by <a id="wrglossary.6571"></a><a href="#glo:glstarget"><code class="csfmt">\glstarget</code></a> which is used by all the predefined <a id="wrglossary.6572"></a><a href="#glo:idx.glossarystyle">glossary styles</a> by the standalone commands, such as <a id="wrglossary.6573"></a><a href="#glo:GlsXtrStandaloneEntryName"><code class="csfmt">\GlsXtrStandaloneEntryName</code></a>.<p>
+The target for an entry with the label <span class="meta">〈<em class="metainner">entry-label</em>〉</span> is in the form <span class="meta">〈<em class="metainner">prefix</em>〉</span><span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The <span class="meta">〈<em class="metainner">prefix</em>〉</span> is normally <a id="wrglossary.6574"></a><a href="#glo:glolinkprefix"><code class="csfmt">\glolinkprefix</code></a> but may be changed with the <a id="wrglossary.6575"></a><a href="#glo:opt.printgloss.prefix"><span class="csoptfmt">prefix</span></a> option when displaying the <a id="wrglossary.6576"></a><a href="#glo:dual.glossary">glossary</a>.<p>
+The target can also be changed to a link to an external file with the <a id="wrglossary.6577"></a><a href="#glo:opt.catattr.targeturl"><span class="csoptfmt">targeturl</span></a> category attribute.<p>
+
+</section><!-- end of section sec:hyper -->
+
+<section id="sec:labelprefixes"><!-- start of section sec:labelprefixes --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->5.7. Label Prefixes<div class="labellink"><a href="#sec:labelprefixes">[link]</a></div></h2><!-- end of section header -->
+<p>
+It’s possible that you may want to prefix labels to ensure uniqueness. For example, this manual references both the <a id="wrglossary.6578"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> command and the <a id="wrglossary.6579"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> Perl script. They are both defined as <a id="wrglossary.6580"></a><a href="#glo:dual.glossary">glossary</a> entries, but they can’t both have the label <code class="code">makeglossaries</code>. This manual uses <a id="wrglossary.6581"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> and is quite complicated, but a simplified version is as follows: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<code class="cmd">\csfmt</code>}[1]{<code class="cmd">\texttt</code>{\#1}}
+<code class="cmd">\newcommand</code>{<code class="cmd">\appfmt</code>}[1]{<code class="cmd">\texttt</code>{#1}}
+<a id="wrglossary.6582"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{cs.makeglossaries}{<a id="wrglossary.6583"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\csfmt</code>{makeglossaries}}</span>,
+ <a id="wrglossary.6584"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.6585"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{app.makeglossaries}{<a id="wrglossary.6586"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\appfmt</code>{makeglossaries}}</span>,
+ <a id="wrglossary.6587"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+</pre> So the label <code class="code">cs.makeglossaries</code> refers to <a id="wrglossary.6588"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> and <code class="code">app.makeglossaries</code> refers to <a id="wrglossary.6589"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. If you have a lot of prefixes like this, you may prefer to have a command that automatically adds the prefix. For example, <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<code class="cmd">\cs</code>}[2][]{<a id="wrglossary.6590"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[#1]{cs.#2}}
+</pre> The problem with this is that the custom command <code class="csfmt">\cs</code> doesn’t allow for the <a id="wrglossary.6591"></a><a href="#glo:idx.mod.star">*</a>, <a id="wrglossary.6592"></a><a href="#glo:idx.mod.plus">+</a> and <a id="wrglossary.6593"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> modifiers (such as <code class="code"><a id="wrglossary.6594"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>*</code> or <code class="code"><a id="wrglossary.6595"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>+</code>). Instead you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6596"></a><code class="code"><dfn id="glo:glsxtrnewgls"><code class="csfmt">\glsxtrnewgls</code></dfn>[<span class="meta">〈<em class="metainner">default-options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which defines the command <pre class="compactcodebox"><span class="meta">〈<em class="metainner">cs</em>〉</span><span class="meta">〈<em class="metainner">modifier</em>〉</span>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]
+</pre> that behaves like <pre class="compactcodebox"><a id="wrglossary.6597"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a><span class="meta">〈<em class="metainner">modifier</em>〉</span>[<span class="meta">〈<em class="metainner">default options</em>〉</span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span><span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]
+</pre> For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.6598"></a><a href="#glo:glsxtrnewgls"><code class="csfmt">\glsxtrnewgls</code></a>{cs.}{<code class="cmd">\cs</code>}
+</pre> or (to default to no hyperlinks) <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.6599"></a><a href="#glo:glsxtrnewgls"><code class="csfmt">\glsxtrnewgls</code></a>[<a id="wrglossary.6600"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span>]{sym.}{<code class="cmd">\cs</code>}
+</pre> now you can use <code class="code"><span class="cmdfmt">\cs</span>+{M}</code> to behave like <code class="code"><a id="wrglossary.6601"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>+{cs.M}</code>.<p>
+If you also want the plural and <a id="wrglossary.6602"></a><a href="#glo:idx.sentencecase">sentence case</a> versions you can use <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6603"></a><code class="code"><dfn id="glo:glsxtrnewglslike"><code class="csfmt">\glsxtrnewglslike</code></dfn>[<span class="meta">〈<em class="metainner">default-options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.6604"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>-like cs</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.6605"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>-like cs</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.6606"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>-like cs</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.6607"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a>-like cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.6608"></a><a href="#glo:glsxtrnewglslike"><code class="csfmt">\glsxtrnewglslike</code></a>[<a id="wrglossary.6609"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span>]{idx.}{<code class="cmd">\idx</code>}{<code class="cmd">\idxpl</code>}{<code class="cmd">\Idx</code>}{<code class="cmd">\Idxpl</code>}
+</pre> For the <a id="wrglossary.6610"></a><a href="#glo:idx.allcaps">all caps</a> versions: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6611"></a><code class="code"><dfn id="glo:glsxtrnewGLSlike"><code class="csfmt">\glsxtrnewGLSlike</code></dfn>[<span class="meta">〈<em class="metainner">default-options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.6612"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a>-like cs</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.6613"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a>-like cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.6614"></a><a href="#glo:glsxtrnewGLSlike"><code class="csfmt">\glsxtrnewGLSlike</code></a>[<a id="wrglossary.6615"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span>]{idx.}{<code class="cmd">\IDX</code>}{<code class="cmd">\IDXpl</code>}
+</pre><p>
+For commands that require the link text to be specified, you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6616"></a><code class="code"><dfn id="glo:glsxtrnewglslink"><code class="csfmt">\glsxtrnewglslink</code></dfn>[<span class="meta">〈<em class="metainner">default-options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which defines <code class="code"><span class="meta">〈<em class="metainner">cs</em>〉</span>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code> to behave like <code class="code"><a id="wrglossary.6617"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a>[<span class="meta">〈<em class="metainner">default-options</em>〉</span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span><span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code>, or <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6618"></a><code class="code"><dfn id="glo:glsxtrnewglsdisp"><code class="csfmt">\glsxtrnewglsdisp</code></dfn>[<span class="meta">〈<em class="metainner">default-options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which defines <code class="code"><span class="meta">〈<em class="metainner">cs</em>〉</span>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code> to behave like <code class="code"><a id="wrglossary.6619"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a>[<span class="meta">〈<em class="metainner">default-options</em>〉</span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span><span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code>.<p>
+If you are using <a id="wrglossary.6620"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, it can pick up the custom commands that are defined using the above, so it can detect dependencies when it parses fields such as <a id="wrglossary.6621"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a>. If you provide your own custom command with just <a id="wrglossary.6622"></a><a href="#glo:newcommand"><code class="csfmt">\newcommand</code></a> that has syntax that starts with [<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}, then you can notify <a id="wrglossary.6623"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6624"></a><code class="code"><dfn id="glo:glsxtridentifyglslike"><code class="csfmt">\glsxtridentifyglslike</code></dfn>{<span class="meta">〈<em class="metainner">label-prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">label-prefix</em>〉</span> is the prefix to apply to the label that’s passed to the command <span class="meta">〈<em class="metainner">cs</em>〉</span>. The information is written to the <a id="wrglossary.6625"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file so that <a id="wrglossary.6626"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can add the given command to those it looks for when searching for dependencies.<p>
+Another possibility when using <a id="wrglossary.6627"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> is to set up known label prefixes, see §<a href="#sec:dgls">11.5.7</a> for further details.<p>
+If you use <a id="wrglossary.6628"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> with record counting, there are commands to <a id="wrglossary.6629"></a><a href="#glo:glsxtrnewgls"><code class="csfmt">\glsxtrnewgls</code></a> for <a id="wrglossary.6630"></a><a href="#glo:rgls"><code class="csfmt">\rgls</code></a>: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6631"></a><code class="code"><dfn id="glo:glsxtrnewrgls"><code class="csfmt">\glsxtrnewrgls</code></dfn>[<span class="meta">〈<em class="metainner">default-options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ and for <a id="wrglossary.6632"></a><a href="#glo:rgls"><code class="csfmt">\rgls</code></a>, <a id="wrglossary.6633"></a><a href="#glo:rglspl"><code class="csfmt">\rglspl</code></a>, <a id="wrglossary.6634"></a><a href="#glo:rGls"><code class="csfmt">\rGls</code></a> and <a id="wrglossary.6635"></a><a href="#glo:rGlspl"><code class="csfmt">\rGlspl</code></a>: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6636"></a><code class="code"><dfn id="glo:glsxtrnewrglslike"><code class="csfmt">\glsxtrnewrglslike</code></dfn>[<span class="meta">〈<em class="metainner">default-options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.6637"></a><a href="#glo:rgls"><code class="csfmt">\rgls</code></a>-like cs</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.6638"></a><a href="#glo:rglspl"><code class="csfmt">\rglspl</code></a>-like cs</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.6639"></a><a href="#glo:rGls"><code class="csfmt">\rGls</code></a>-like cs</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.6640"></a><a href="#glo:rGlspl"><code class="csfmt">\rGlspl</code></a>-like cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ and for <a id="wrglossary.6641"></a><a href="#glo:idx.allcaps">all caps</a>: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6642"></a><code class="code"><dfn id="glo:glsxtrnewrGLSlike"><code class="csfmt">\glsxtrnewrGLSlike</code></dfn>[<span class="meta">〈<em class="metainner">default-options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.6643"></a><a href="#glo:rGLS"><code class="csfmt">\rGLS</code></a>-like cs</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.6644"></a><a href="#glo:rGLSpl"><code class="csfmt">\rGLSpl</code></a>-like cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<p>
+Defining commands in this manner (rather than simply using <code class="csfmt">\newcommand</code>) also allows the command to be identified as a <a id="wrglossary.6645"></a><a href="#glo:idx.sentencecase">sentence case</a> blocker to prevent the label from being converted or, in the case of <a id="wrglossary.6646"></a><a href="#glo:glsxtrnewglslike"><code class="csfmt">\glsxtrnewglslike</code></a> and <a id="wrglossary.6647"></a><a href="#glo:glsxtrnewrglslike"><code class="csfmt">\glsxtrnewrglslike</code></a>, as a mapping. See §<a href="#sec:casechange">5.2</a> for further details.<p>
+
+</section><!-- end of section sec:labelprefixes -->
+
+<section id="sec:wrglossary"><!-- start of section sec:wrglossary --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->5.8. Indexing<div class="labellink"><a href="#sec:wrglossary">[link]</a></div></h2><!-- end of section header -->
+<p>
+<a id="wrglossary.6648"></a><a href="#glo:dual.indexing">Indexing</a> is normally performed implicitly by the <a id="wrglossary.6649"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.6650"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands, but this action can be prevented, such as by using the option <a id="wrglossary.6651"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a><span class="optfmt">=true</span>. These commands also generate text (the <a id="wrglossary.6652"></a><a href="#glo:dual.linktext">link text</a>, §<a href="#sec:entryfmtmods">5.5</a>). If you want to simply index an entry (to ensure that an entry is shown in the <a id="wrglossary.6653"></a><a href="#glo:dual.glossary">glossary</a>) without producing any text then you can use <a id="wrglossary.6654"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>. <a id="wrglossary.6655"></a><a href="#glo:dual.indexing">Indexing</a> is also performed by cross-referencing commands, such as <a id="wrglossary.6656"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>. In the case of <a id="wrglossary.6657"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, <a id="wrglossary.6658"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a> simply behaves like <a id="wrglossary.6659"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> with a special format and the <a id="wrglossary.6660"></a><a href="#glo:@@glslabel@entrylocation">location</a> set to Z (which pushes it to the end of the <a id="wrglossary.6661"></a><a href="#glo:dual.locationlist">location list</a>). Entries in <a id="wrglossary.6662"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a> can only be <a id="wrglossary.6663"></a><a href="#glo:@@glslabel@indexing">indexed</a> with <a id="wrglossary.6664"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>.<p>
+If you want <span style="font-style: italic; font-variant: normal; ">all</span> defined entries to appear in the <a id="wrglossary.6665"></a><a href="#glo:dual.glossary">glossary</a>, regardless of whether or not they have been used in the document, then you can use <a id="wrglossary.6666"></a><a href="#glo:glsaddall"><code class="csfmt">\glsaddall</code></a> or <a id="wrglossary.6667"></a><a href="#glo:glsaddallunused"><code class="csfmt">\glsaddallunused</code></a> (both provided by the base <a id="wrglossary.6668"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package). These both iterate over all entries (in all non-<a id="wrglossary.6669"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a>). In the first case (<a id="wrglossary.6670"></a><a href="#glo:glsaddall"><code class="csfmt">\glsaddall</code></a>), every entry is <a id="wrglossary.6671"></a><a href="#glo:@@glslabel@indexing">indexed</a> with the <a id="wrglossary.6672"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> options provided in the optional argument of <a id="wrglossary.6673"></a><a href="#glo:glsaddall"><code class="csfmt">\glsaddall</code></a>. In the second case (<a id="wrglossary.6674"></a><a href="#glo:glsaddallunused"><code class="csfmt">\glsaddallunused</code></a>), only those entries that haven’t been marked as <a id="wrglossary.6675"></a><a href="#glo:@@glslabel@firstuseflag">used</a> so far will be indexed using <code class="code"><a id="wrglossary.6676"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>[<a id="wrglossary.6677"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=glsignore</span>]{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code>. See the <a id="wrglossary.6678"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> manual for further details of those commands.<p>
+The <a id="wrglossary.6679"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides a similar command: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6680"></a><code class="code"><dfn id="glo:glsaddallunindexed"><code class="csfmt">\glsaddallunindexed</code></dfn>[<span class="meta">〈<em class="metainner">glossary types</em>〉</span>]</code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.6681"></a><a href="#glo:glsaddallunused"><code class="csfmt">\glsaddallunused</code></a> but indexes all entries that haven’t been <a id="wrglossary.6682"></a><a href="#glo:@@glslabel@indexing">indexed</a> so far (again using the option <a id="wrglossary.6683"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=glsignore</span>). This is preferable to <a id="wrglossary.6684"></a><a href="#glo:glsaddallunused"><code class="csfmt">\glsaddallunused</code></a> if you have to reset the <a id="wrglossary.6685"></a><a href="#glo:dual.firstuseflag">first use flag</a> for any entries. As with <a id="wrglossary.6686"></a><a href="#glo:glsaddallunused"><code class="csfmt">\glsaddallunused</code></a>, if this command is required, it should be placed near the end of the document. Indexing any entries after either of these commands are used will cause spurious commas in the <a id="wrglossary.6687"></a><a href="#glo:dual.locationlist">location lists</a>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Iterative commands such as <a id="wrglossary.6688"></a><a href="#glo:glsaddall"><code class="csfmt">\glsaddall</code></a>, <a id="wrglossary.6689"></a><a href="#glo:glsaddallunused"><code class="csfmt">\glsaddallunused</code></a> and <a id="wrglossary.6690"></a><a href="#glo:glsaddallunindexed"><code class="csfmt">\glsaddallunindexed</code></a> should not be used with <a id="wrglossary.6691"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. Use the <a id="wrglossary.6692"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">=all</span> option instead. </div><!-- end of important -->
+<p>
+If you want to index a specific subset of entries, rather than all entries for a given glossary, you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6693"></a><code class="code"><dfn id="glo:glsaddeach"><code class="csfmt">\glsaddeach</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry label list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does <code class="code"><a id="wrglossary.6694"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code> for each entry in the comma-separated <span class="meta">〈<em class="metainner">entry label list</em>〉</span>. This command may be used with <a id="wrglossary.6695"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, although it may be simpler to adjust the selection criteria or use filtering.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6696"></a><code class="code"><dfn id="glo:GlsXtrAutoAddOnFormat"><code class="csfmt">\GlsXtrAutoAddOnFormat</code></dfn>[<span class="meta">〈<em class="metainner">entry-label</em>〉</span>]{<span class="meta">〈<em class="metainner">format list</em>〉</span>}{<span class="meta">〈<em class="metainner">glsadd options</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This will make the <a id="wrglossary.6697"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.6698"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands automatically use <code class="code"><a id="wrglossary.6699"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>[<span class="meta">〈<em class="metainner">glsadd options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code> whenever a <a id="wrglossary.6700"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> or <a id="wrglossary.6701"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> command is used for the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> when the <a id="wrglossary.6702"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a> matches one of the formats in the comma-separated <span class="meta">〈<em class="metainner">format list</em>〉</span><p>
+The optional argument <span class="meta">〈<em class="metainner">label</em>〉</span> defaults to <a id="wrglossary.6703"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a> (which will match <span class="meta">〈<em class="metainner">entry-label</em>〉</span> that was used with <a id="wrglossary.6704"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> etc) and indicates the entry label to use in <a id="wrglossary.6705"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> and so needs to be expandable. The <span class="meta">〈<em class="metainner">format list</em>〉</span> is a comma-separated list of format values that will trigger the automated adding. The <span class="meta">〈<em class="metainner">glsadd options</em>〉</span> are the options to pass to <a id="wrglossary.6706"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> with <a id="wrglossary.6707"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">={format}</span> prepended to the list.<p>
+For example, with: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.6708"></a><a href="#glo:GlsXtrAutoAddOnFormat"><code class="csfmt">\GlsXtrAutoAddOnFormat</code></a>{hyperbf}{<a id="wrglossary.6709"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a><span class="optfmt">=chapter</span>}
+</pre> then <code class="code"><a id="wrglossary.6710"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.6711"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=hyperbf</span>]{sample}</code> will be equivalent to: <pre class="compactcodebox"><a id="wrglossary.6712"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>[<a id="wrglossary.6713"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=hyperbf</span>,<a id="wrglossary.6714"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a><span class="optfmt">=chapter</span>]{sample}<a id="wrglossary.6715"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.6716"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=hyperbf</span>]{sample}
+</pre> Note that the explicit range markers will prevent a match unless you include them in <span class="meta">〈<em class="metainner">format list</em>〉</span> (in which case, be sure to add both the start and end formats).<p>
+Here’s another example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.6717"></a><a href="#glo:GlsXtrAutoAddOnFormat"><code class="csfmt">\GlsXtrAutoAddOnFormat</code></a>[dual.<a id="wrglossary.6718"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>]{hyperbf}{}
+</pre> In this case <code class="code"><a id="wrglossary.6719"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.6720"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=hyperbf</span>]{sample}</code> will now be equivalent to: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.6721"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>[<a id="wrglossary.6722"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=hyperbf</span>]{dual.sample}<a id="wrglossary.6723"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.6724"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=hyperbf</span>]{sample}
+</pre><p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+<a id="wrglossary.6725"></a><a href="#glo:GlsXtrAutoAddOnFormat"><code class="csfmt">\GlsXtrAutoAddOnFormat</code></a> is not applied to <a id="wrglossary.6726"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> as it could cause an infinite loop. </div><!-- end of important -->
+<p>
+In the context of <a id="wrglossary.6727"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> and <a id="wrglossary.6728"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, <a id="wrglossary.6729"></a><a href="#glo:dual.indexing">indexing</a> refers to the mechanism used to ensure that an entry is included in its associated glossary. (If you also want to use <a id="wrglossary.6730"></a><a href="#glo:index"><code class="csfmt">\index</code></a>, see §<a href="#sec:autoindex">12</a>.) This includes any entries that simply cross-reference another entry. The default is to use <a id="wrglossary.6731"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, which is a general purpose <a id="wrglossary.6732"></a><a href="#glo:dual.indexingapp">indexing application</a>. Each time an entry is <a id="wrglossary.6733"></a><a href="#glo:@@glslabel@indexing">indexed</a>, a line is added to an associated file that contains the <a id="wrglossary.6734"></a><a href="#glo:dual.indexing">indexing</a> information, which includes the sort value, the <a id="wrglossary.6735"></a><a href="#glo:@@glslabel@hierarchicallevel">hierarchical information</a> (if the entry has a parent) and an associated <a id="wrglossary.6736"></a><a href="#glo:@@glslabel@entrylocation">location</a> (the page number, by default). This information is used to sort the entries and collate the <a id="wrglossary.6737"></a><a href="#glo:@@glslabel@entrylocation">locations</a> into a compact <a id="wrglossary.6738"></a><a href="#glo:dual.locationlist">location list</a>. The <a id="wrglossary.6739"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> package option switches to using <a id="wrglossary.6740"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> syntax, but the process is much the same.<p>
+Since both <a id="wrglossary.6741"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.6742"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> are general purpose <a id="wrglossary.6743"></a><a href="#glo:dual.indexingapp">indexing applications</a> they require an associated <a id="wrglossary.6744"></a><a href="#glo:@@glslabel@entrylocation">location</a> (or a cross-reference) since indexes are typically used to lookup the <a id="wrglossary.6745"></a><a href="#glo:@@glslabel@entrylocation">locations</a> in the document where the term occurs. Although <a id="wrglossary.6746"></a><a href="#glo:dual.glossary">glossaries</a> are similar to indexes they can simply be used to provide brief summaries of each term without any <a id="wrglossary.6747"></a><a href="#glo:@@glslabel@entrylocation">locations</a>. The way that <a id="wrglossary.6748"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.6749"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> work means that valid <a id="wrglossary.6750"></a><a href="#glo:@@glslabel@entrylocation">locations</a> (that is, <a id="wrglossary.6751"></a><a href="#glo:@@glslabel@entrylocation">locations</a> that conform to <a id="wrglossary.6752"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.6753"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> syntax) must be supplied even if no <a id="wrglossary.6754"></a><a href="#glo:dual.locationlist">location list</a> is required. If an invalid <a id="wrglossary.6755"></a><a href="#glo:@@glslabel@entrylocation">location</a> is used, an error will occur during the <a id="wrglossary.6756"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.6757"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> step in the build process, even if the <a id="wrglossary.6758"></a><a href="#glo:@@glslabel@entrylocation">location</a> will eventually be ignored when typesetting the <a id="wrglossary.6759"></a><a href="#glo:dual.glossary">glossary</a>.<p>
+All <a id="wrglossary.6760"></a><a href="#glo:dual.locationlist">location lists</a> can be suppressed with the <a id="wrglossary.6761"></a><a href="#glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></a> option (which simply discards the <a id="wrglossary.6762"></a><a href="#glo:dual.locationlist">location list</a> for each entry), but there are occasions where only some <a id="wrglossary.6763"></a><a href="#glo:@@glslabel@entrylocation">locations</a> need to be suppressed. The main way of hiding a <a id="wrglossary.6764"></a><a href="#glo:@@glslabel@entrylocation">location</a> is to encapsulate the <a id="wrglossary.6765"></a><a href="#glo:@@glslabel@entrylocation">location</a> with a command that does nothing. The <a id="wrglossary.6766"></a><a href="#glo:glsignore"><code class="csfmt">\glsignore</code></a> command is used for this purpose (<a id="wrglossary.6767"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=glsignore</span>). However, it’s important to remember that even though the <a id="wrglossary.6768"></a><a href="#glo:@@glslabel@entrylocation">location</a> isn’t shown, it’s still present in the <a id="wrglossary.6769"></a><a href="#glo:dual.locationlist">location list</a>. This means that you will end up with spurious commas if there’s more than one item in the <a id="wrglossary.6770"></a><a href="#glo:dual.locationlist">location list</a>.<p>
+The <span class="qt">“noidx”</span> method similarly writes indexing information, but in this case the information is written to the <a id="wrglossary.6771"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file. Again, empty locations can cause spurious commas in the <a id="wrglossary.6772"></a><a href="#glo:dual.locationlist">location lists</a>.<p>
+The only method that recognises <a id="wrglossary.6773"></a><a href="#glo:glsignore"><code class="csfmt">\glsignore</code></a> as a special <span class="qt">“<a id="wrglossary.6774"></a><a href="#glo:dual.ignoredlocation">ignored location</a>”</span> is <a id="wrglossary.6775"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, where this format will trigger the entry’s selection but won’t add the <a id="wrglossary.6776"></a><a href="#glo:dual.ignoredlocation">ignored location</a> to the <a id="wrglossary.6777"></a><a href="#glo:dual.locationlist">location list</a>. This avoids the problem of spurious commas caused by invisible locations.<p>
+The <a id="wrglossary.6778"></a><a href="#glo:@@glslabel@entrylocation">location</a> corresponds to a counter. The default is the <a id="wrglossary.6779"></a><a href="#glo:ctr.page"><span class="ctrfmt">page</span></a> counter, but may be changed with the <a id="wrglossary.6780"></a><a href="#glo:opt.counter"><span class="styoptfmt">counter</span></a> package option, the <span class="meta">〈<em class="metainner">counter</em>〉</span> optional argument of <a id="wrglossary.6781"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>, the <a id="wrglossary.6782"></a><a href="#glo:opt.gloskey.counter"><span class="csoptfmt">counter</span></a> key when defining an entry, or the <a id="wrglossary.6783"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a> option when <a id="wrglossary.6784"></a><a href="#glo:dual.indexing">indexing</a> an entry.<p>
+Note that <a id="wrglossary.6785"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v3.0+ converts an empty <a id="wrglossary.6786"></a><a href="#glo:@@glslabel@entrylocation">location</a> (which can occur when the <a id="wrglossary.6787"></a><a href="#glo:dual.locationcounter">location counter</a> is 0 and should be formatted as a Roman numeral) to an <a id="wrglossary.6788"></a><a href="#glo:dual.ignoredlocation">ignored location</a>. For example, if you use <a id="wrglossary.6789"></a><a href="#glo:opt.counter"><span class="styoptfmt">counter</span></a><span class="optfmt">=<a id="wrglossary.6790"></a><a href="#glo:ctr.part"><span class="ctrfmt">part</span></a></span> but have <a id="wrglossary.6791"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> before the first <a id="wrglossary.6792"></a><a href="#glo:part"><code class="csfmt">\part</code></a>. An empty <a id="wrglossary.6793"></a><a href="#glo:@@glslabel@entrylocation">location</a> will trigger an error with <a id="wrglossary.6794"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.6795"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+Since no entries are defined on the first LaTeX run with <a id="wrglossary.6796"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, there’s no way of determining the entry’s <a id="wrglossary.6797"></a><a href="#glo:dual.glossary">glossary</a> <a id="wrglossary.6798"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> or of finding if the entry’s <a id="wrglossary.6799"></a><a href="#glo:opt.gloskey.counter"><span class="csoptfmt">counter</span></a> key has been set. This means that if the counter has been assigned to either the entry’s <a id="wrglossary.6800"></a><a href="#glo:dual.glossary">glossary</a> or to the entry itself, the <a id="wrglossary.6801"></a><a href="#glo:dual.locationcounter">location counter</a> can’t be implemented until the entry has been defined. A second build is required to ensure that the <a id="wrglossary.6802"></a><a href="#glo:@@glslabel@entrylocation">locations</a> use the correct counter. </div><!-- end of warning -->
+<p>
+The <a id="wrglossary.6803"></a><a href="#glo:dual.locationcounter">location counter</a> must expand to syntax that’s recognised by the <a id="wrglossary.6804"></a><a href="#glo:dual.indexingapp">indexing application</a>. This is very restrictive with <a id="wrglossary.6805"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, which only recognises Western Arabic (<a id="wrglossary.6806"></a><a href="#glo:arabic"><code class="csfmt">\arabic</code></a>), <a id="wrglossary.6807"></a><a href="#glo:idx.lowercase">lowercase</a> Roman numerals (<a id="wrglossary.6808"></a><a href="#glo:roman"><code class="csfmt">\roman</code></a>), <a id="wrglossary.6809"></a><a href="#glo:idx.uppercase">uppercase</a> Roman numerals (<a id="wrglossary.6810"></a><a href="#glo:Roman"><code class="csfmt">\Roman</code></a>), <a id="wrglossary.6811"></a><a href="#glo:idx.lowercase">lowercase</a> Basic Latin (<a id="wrglossary.6812"></a><a href="#glo:alph"><code class="csfmt">\alph</code></a>) and <a id="wrglossary.6813"></a><a href="#glo:idx.uppercase">uppercase</a> Basic Latin (<a id="wrglossary.6814"></a><a href="#glo:Alph"><code class="csfmt">\Alph</code></a>), with optionally a separator (hyphen by default). With <a id="wrglossary.6815"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, the syntax must be defined (see the <a id="wrglossary.6816"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> manual for further details).<p>
+There’s no restriction on the location syntax with <a id="wrglossary.6817"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. The only limitation is that if <a id="wrglossary.6818"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can’t determine an associated numeric value according to its location parser, it won’t form ranges. This means that with <a id="wrglossary.6819"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, you can set arbitrary text as the <a id="wrglossary.6820"></a><a href="#glo:@@glslabel@entrylocation">location</a> (that’s not related to a counter) with <a id="wrglossary.6821"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a>. You can also use <a id="wrglossary.6822"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a> with <a id="wrglossary.6823"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.6824"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, but only if the value matches the required <a id="wrglossary.6825"></a><a href="#glo:@@glslabel@entrylocation">location</a> syntax.<p>
+Both <a id="wrglossary.6826"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.6827"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> order the <a id="wrglossary.6828"></a><a href="#glo:@@glslabel@entrylocation">locations</a> in the <a id="wrglossary.6829"></a><a href="#glo:dual.locationlist">location lists</a>. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.6830"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.6831"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.6832"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.6833"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.6834"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.6835"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a><span class="optfmt">=Z</span>]{sample} (Z), <a id="wrglossary.6836"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.6837"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a><span class="optfmt">=4</span>]{sample} (4),
+<a id="wrglossary.6838"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.6839"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a><span class="optfmt">=xi</span>]{sample} (xi), <a id="wrglossary.6840"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.6841"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a><span class="optfmt">=2</span>]{sample} (2),
+<a id="wrglossary.6842"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.6843"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a><span class="optfmt">=iii</span>]{sample} (iii), <a id="wrglossary.6844"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.6845"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a><span class="optfmt">=A</span>]{sample} (A).
+
+<a id="wrglossary.6846"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:mkidxloclistorder"></a>Example 104: Location list ordering (<span class="appfmt">makeindex</span>) <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example104.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example104.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example104.png" type="image/png" width="388" height="79">Example document with contrived locations that result in an ordered location list consisting of iii, xi, 2, 4, A, Z.</object> </div><!-- end of resultbox -->
+<p>
+With <a id="wrglossary.6847"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, the <a id="wrglossary.6848"></a><a href="#glo:dual.locationlist">location list</a> is grouped into the different number formats (<a id="wrglossary.6849"></a><a href="#glo:roman"><code class="csfmt">\roman</code></a>, <a id="wrglossary.6850"></a><a href="#glo:arabic"><code class="csfmt">\arabic</code></a> and <a id="wrglossary.6851"></a><a href="#glo:Alph"><code class="csfmt">\Alph</code></a>), with each group ordered numerically. The same result can be produced with <a id="wrglossary.6852"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> by adding the <a id="wrglossary.6853"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> package option to the above example.<p>
+With <a id="wrglossary.6854"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the <a id="wrglossary.6855"></a><a href="#glo:dual.locationlist">location list</a> is always in order of <a id="wrglossary.6856"></a><a href="#glo:dual.indexing">indexing</a>. The above example document can be converted to use <a id="wrglossary.6857"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> as follows: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cbeg">\begin{filecontents*}</code>{<code class="cmd">\jobname</code>.bib}
+<code class="code">@entry</code>{sample,<a id="wrglossary.6858"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.6859"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+<code class="cend">\end{filecontents*}</code>
+<code class="cmd">\usepackage</code>[<a id="wrglossary.6860"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>]{glossaries-extra}
+<a id="wrglossary.6861"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.6862"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.6863"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a><span class="optfmt">=Z</span>]{sample} (Z), <a id="wrglossary.6864"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.6865"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a><span class="optfmt">=4</span>]{sample} (4),
+<a id="wrglossary.6866"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.6867"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a><span class="optfmt">=xi</span>]{sample} (xi), <a id="wrglossary.6868"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.6869"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a><span class="optfmt">=2</span>]{sample} (2),
+<a id="wrglossary.6870"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.6871"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a><span class="optfmt">=iii</span>]{sample} (iii), <a id="wrglossary.6872"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.6873"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a><span class="optfmt">=A</span>]{sample} (A).
+<a id="wrglossary.6874"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:b2gloclistorder"></a>Example 105: Location list ordering (<span class="appfmt">bib2gls</span>) <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example105.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example105.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example105.png" type="image/png" width="388" height="79">Example document with contrived locations that result in a location list consisting of Z, 4, xi, 2, ii, A, which corresponds to the record order.</object> </div><!-- end of resultbox -->
+ This example is contrived. For most documents, the order of <a id="wrglossary.6875"></a><a href="#glo:dual.indexing">indexing</a> will likely match the desired <a id="wrglossary.6876"></a><a href="#glo:dual.locationlist">location list</a> order.<p>
+Another important difference between <a id="wrglossary.6877"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> and the other indexing methods is the treatment of cross-references identified by the cross-reference keys <a id="wrglossary.6878"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a>, <a id="wrglossary.6879"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> and <a id="wrglossary.6880"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a>. With <a id="wrglossary.6881"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the cross-referencing information is picked up when <a id="wrglossary.6882"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> parses the <a id="wrglossary.6883"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file and is used to establish dependencies, which ensures that when entries with cross-references are selected, their cross-referenced entries will also be selected.<p>
+With the other methods, cross-references are added to an entry’s <a id="wrglossary.6884"></a><a href="#glo:dual.locationlist">location list</a> by <a id="wrglossary.6885"></a><a href="#glo:dual.indexing">indexing</a> the entry with a special format. The <a id="wrglossary.6886"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a>, <a id="wrglossary.6887"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> and <a id="wrglossary.6888"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> keys automatically trigger this <a id="wrglossary.6889"></a><a href="#glo:dual.indexing">indexing</a> unless <a id="wrglossary.6890"></a><a href="#glo:opt.autoseeindex"><span class="styoptfmt">autoseeindex</span></a><span class="optfmt">=false</span>. See §<a href="#sec:xr">5.9</a> for further details.<p>
+Every time an entry is <a id="wrglossary.6891"></a><a href="#glo:@@glslabel@indexing">indexed</a>, the following hook is also used: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6892"></a><code class="code"><dfn id="glo:glsxtrdowrglossaryhook"><code class="csfmt">\glsxtrdowrglossaryhook</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does nothing by default. The argument is the entry’s label.<p>
+The <a id="wrglossary.6893"></a><a href="#glo:dual.indexing">indexing</a> code is encapsulated with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6894"></a><code class="code"><dfn id="glo:glsencapwrcontent"><code class="csfmt">\glsencapwrcontent</code></dfn>{<span class="meta">〈<em class="metainner">code</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This adds grouping, which helps to prevent spacing issues caused by the <a id="wrglossary.6895"></a><a href="#glo:dual.whatsit">whatsit</a> that’s created by the <a id="wrglossary.6896"></a><a href="#glo:dual.indexing">indexing</a>.<p>
+The base <a id="wrglossary.6897"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package always performs the <a id="wrglossary.6898"></a><a href="#glo:dual.indexing">indexing</a> before the <a id="wrglossary.6899"></a><a href="#glo:dual.linktext">link text</a> for the <a id="wrglossary.6900"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.6901"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands. This means that if a page break occurs in the middle of the <a id="wrglossary.6902"></a><a href="#glo:dual.linktext">link text</a>, the <a id="wrglossary.6903"></a><a href="#glo:@@glslabel@entrylocation">location</a> will refer to the page number at the start of the <a id="wrglossary.6904"></a><a href="#glo:dual.linktext">link text</a> (assuming the default <a id="wrglossary.6905"></a><a href="#glo:ctr.page"><span class="ctrfmt">page</span></a> <a id="wrglossary.6906"></a><a href="#glo:dual.locationcounter">location counter</a>). With <a id="wrglossary.6907"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, you can use the option <a id="wrglossary.6908"></a><a href="#glo:opt.glsopt.wrgloss"><span class="csoptfmt">wrgloss</span></a><span class="optfmt">=after</span> to have the <a id="wrglossary.6909"></a><a href="#glo:dual.indexing">indexing</a> occur after the <a id="wrglossary.6910"></a><a href="#glo:dual.linktext">link text</a>. The <a id="wrglossary.6911"></a><a href="#glo:opt.catattr.wrgloss"><span class="csoptfmt">wrgloss</span></a> attribute can also be used. The default setting is initialised with <a id="wrglossary.6912"></a><a href="#glo:glsxtrinitwrgloss"><code class="csfmt">\glsxtrinitwrgloss</code></a> (see §<a href="#sec:defaultglsopts">5.1.1</a>).<p>
+Every time an entry is <a id="wrglossary.6913"></a><a href="#glo:@@glslabel@indexing">indexed</a>, an <a id="wrglossary.6914"></a><a href="#glo:dual.internalfield">internal field</a> associated with the entry’s label is globally updated to keep a count of the number of times the entry has been <a id="wrglossary.6915"></a><a href="#glo:@@glslabel@indexing">indexed</a>. The value can be accessed with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6916"></a><code class="code"><dfn id="glo:glsentryindexcount"><code class="csfmt">\glsentryindexcount</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command will expand to 0 if the entry hasn’t been <a id="wrglossary.6917"></a><a href="#glo:@@glslabel@indexing">indexed</a> or hasn’t been defined. To test if the value is greater than 0 (that is, to test if the entry has been <a id="wrglossary.6918"></a><a href="#glo:@@glslabel@indexing">indexed</a> yet), use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6919"></a><code class="code"><dfn id="glo:glsifindexed"><code class="csfmt">\glsifindexed</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This expands to <span class="meta">〈<em class="metainner">true</em>〉</span> if the entry is defined and has been <a id="wrglossary.6920"></a><a href="#glo:@@glslabel@indexing">indexed</a>, otherwise it expands to <span class="meta">〈<em class="metainner">false</em>〉</span>. No warning or error occurs if the entry hasn’t been defined.<p>
+Note that the index count is a running total. This is not the same as the <a id="wrglossary.6921"></a><a href="#glo:@@glslabel@indexing">record</a> count saved by <a id="wrglossary.6922"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span>’s</a> <a id="wrglossary.6923"></a><a href="#glo:switch.record-count"><span class="longargfmt">--record-count</span></a> switch, which represents the total number of <a id="wrglossary.6924"></a><a href="#glo:@@glslabel@indexing">records</a> for the given entry from the previous LaTeX run.<p>
+The base <a id="wrglossary.6925"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package defines: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6926"></a><code class="code"><dfn id="glo:glswriteentry"><code class="csfmt">\glswriteentry</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">code</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command conditionally writes the indexing code (supplied by the second argument <span class="meta">〈<em class="metainner">code</em>〉</span>). The original definition simply tests whether or not the <a id="wrglossary.6927"></a><a href="#glo:opt.indexonlyfirst"><span class="styoptfmt">indexonlyfirst</span></a> setting is on. The <a id="wrglossary.6928"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package redefines this command to perform additional checks to determine whether or not the <a id="wrglossary.6929"></a><a href="#glo:dual.indexing">indexing</a> code should be performed.<p>
+The modified definition uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6930"></a><code class="code"><dfn id="glo:glsxtrifindexing"><code class="csfmt">\glsxtrifindexing</code></dfn>{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ to test the <a id="wrglossary.6931"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a> setting. This does <span class="meta">〈<em class="metainner">false</em>〉</span> if <a id="wrglossary.6932"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a><span class="optfmt">=true</span>, otherwise it does <span class="meta">〈<em class="metainner">true</em>〉</span>. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.6933"></a><code class="code"><dfn id="glo:ifglsindexonlyfirst"><code class="csfmt">\ifglsindexonlyfirst</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\iffalse</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This is a conditional that corresponds to the <a id="wrglossary.6934"></a><a href="#glo:opt.indexonlyfirst"><span class="styoptfmt">indexonlyfirst</span></a> package option. <a id="wrglossary.6935"></a><a href="#glo:dual.firstuse">First use</a> is tested using <a id="wrglossary.6936"></a><a href="#glo:GlsXtrIfUnusedOrUndefined"><code class="csfmt">\GlsXtrIfUnusedOrUndefined</code></a> rather than <a id="wrglossary.6937"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>. The <a id="wrglossary.6938"></a><a href="#glo:opt.catattr.indexonlyfirst"><span class="csoptfmt">indexonlyfirst</span></a> attribute is also tested. If the <span class="qt">“index only first”</span> setting is on and the entry has been <a id="wrglossary.6939"></a><a href="#glo:@@glslabel@firstuseflag">used</a>, <span class="meta">〈<em class="metainner">code</em>〉</span> isn’t performed but auto-indexing via <a id="wrglossary.6940"></a><a href="#glo:glsxtrdoautoindexname"><code class="csfmt">\glsxtrdoautoindexname</code></a> is still performed (see §<a href="#sec:autoindex">12</a>).<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+Since no entries are defined on the first LaTeX run with <a id="wrglossary.6941"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, there’s no way of keeping track of whether or not an entry has been used or what its <a id="wrglossary.6942"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> is, which is required to query the <a id="wrglossary.6943"></a><a href="#glo:opt.catattr.indexonlyfirst"><span class="csoptfmt">indexonlyfirst</span></a> attribute, so for the first document build all instances will be <a id="wrglossary.6944"></a><a href="#glo:@@glslabel@indexing">indexed</a>. A second build is required for the <span class="qt">“index only first”</span> feature. </div><!-- end of warning -->
+<p>
+
+</section><!-- end of section sec:wrglossary -->
+
+<section id="sec:xr"><!-- start of section sec:xr --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->5.9. Cross-Referencing<div class="labellink"><a href="#sec:xr">[link]</a></div></h2><!-- end of section header -->
+<p>
+The base <a id="wrglossary.6945"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package only provides the <a id="wrglossary.6946"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key, which automatically <a id="wrglossary.6947"></a><a href="#glo:@@glslabel@indexing">indexes</a> the cross-reference using <a id="wrglossary.6948"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>. The value of this key isn’t saved and can’t be accessed later. (The key was simply provided as a shortcut.) The <a id="wrglossary.6949"></a><a href="#glo:dual.indexing">indexing</a> ensures that the cross-reference is shown in the <a id="wrglossary.6950"></a><a href="#glo:dual.locationlist">location list</a>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The auto-indexing feature of the <a id="wrglossary.6951"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key was intended as a shortcut where only entries required in the document are defined. If you want to have a large file containing entries that may or may not be required in the document, then using <a id="wrglossary.6952"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a>, <a id="wrglossary.6953"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> or <a id="wrglossary.6954"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> can cause unwanted entries to appear in the glossary. In this case, see §<a href="#sec:seenoindex">5.9.1</a>. </div><!-- end of important -->
+<p>
+The <a id="wrglossary.6955"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package saves the value of the <a id="wrglossary.6956"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key and additionally provides the <a id="wrglossary.6957"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> and <a id="wrglossary.6958"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> keys that perform similar functions. The values of the <a id="wrglossary.6959"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a>, <a id="wrglossary.6960"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> and <a id="wrglossary.6961"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> keys can all be accessed at a later point in the document.<p>
+If an entry with a cross-reference has been included in the glossary, there’s no guarantee that the cross-referenced entry will also be included. It won’t be included if it hasn’t been indexed anywhere in the document. You can use the <a id="wrglossary.6962"></a><a href="#glo:opt.indexcrossrefs"><span class="styoptfmt">indexcrossrefs</span></a> package option to search for cross-references that require <a id="wrglossary.6963"></a><a href="#glo:dual.indexing">indexing</a> at the end of the document, but note that this can be time-consuming if you have a large number of entries. <p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+With <a id="wrglossary.6964"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> you can simply change the selection criteria (<a id="wrglossary.6965"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">={recorded and deps and see}</span> or <a id="wrglossary.6966"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">={recorded and deps and see not also}</span>) to ensure that all cross-referenced entries are included even if they haven’t been <a id="wrglossary.6967"></a><a href="#glo:@@glslabel@indexing">indexed</a> in the document. </div><!-- end of information -->
+<p>
+Example (<a id="wrglossary.6968"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> and <a id="wrglossary.6969"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> keys): <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.6970"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{pumpkin}{<a id="wrglossary.6971"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={pumpkin}</span>,<a id="wrglossary.6972"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.6973"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{cucumber}{<a id="wrglossary.6974"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={cucumber}</span>,<a id="wrglossary.6975"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.6976"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{melon}{<a id="wrglossary.6977"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={melon}</span>,<a id="wrglossary.6978"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.6979"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{gourd}{<a id="wrglossary.6980"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={gourd}</span>,<a id="wrglossary.6981"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,
+ <a id="wrglossary.6982"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={pumpkin,cucumber,melon}</span>}
+<a id="wrglossary.6983"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{courgette}{<a id="wrglossary.6984"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={courgette}</span>,<a id="wrglossary.6985"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.6986"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{marrow}{<a id="wrglossary.6987"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={marrow}</span>,<a id="wrglossary.6988"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,
+ <a id="wrglossary.6989"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a><span class="optfmt">={courgette}</span>}
+</pre> When the <code class="code">gourd</code> entry is defined, the cross-reference will automatically be <a id="wrglossary.6990"></a><a href="#glo:@@glslabel@indexing">indexed</a> using <a id="wrglossary.6991"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>. This means that the <code class="code">gourd</code> entry will appear in the glossary, regardless of whether or not it is used in the document, with <span class="qt">“<span style="font-style: italic; font-variant: normal; ">see</span> pumpkin, cucumber &amp; melon”</span> in the <a id="wrglossary.6992"></a><a href="#glo:dual.locationlist">location list</a>. If <code class="code">gourd</code> is also <a id="wrglossary.6993"></a><a href="#glo:@@glslabel@indexing">indexed</a> in the document, then those <a id="wrglossary.6994"></a><a href="#glo:@@glslabel@entrylocation">locations</a> will also be added to the gourd’s <a id="wrglossary.6995"></a><a href="#glo:dual.locationlist">location list</a>.<p>
+The cross-referenced entries (pumpkin, cucumber and melon) will only appear in the glossary if they are also <a id="wrglossary.6996"></a><a href="#glo:@@glslabel@indexing">indexed</a> in the document. This can be implemented automatically with <a id="wrglossary.6997"></a><a href="#glo:opt.indexcrossrefs"><span class="styoptfmt">indexcrossrefs</span></a>.<p>
+The <a id="wrglossary.6998"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> key in the <code class="code">marrow</code> entry functions in much the same way, but it is <a id="wrglossary.6999"></a><a href="#glo:@@glslabel@indexing">indexed</a> with <a id="wrglossary.7000"></a><a href="#glo:glsxtrindexseealso"><code class="csfmt">\glsxtrindexseealso</code></a>. This means that the <code class="code">marrow</code> entry will have <span class="qt">“<span style="font-style: italic; font-variant: normal; ">see also</span> courgette”</span> in its <a id="wrglossary.7001"></a><a href="#glo:dual.locationlist">location list</a>.<p>
+The <a id="wrglossary.7002"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key may optionally start with [<span class="meta">〈<em class="metainner">tag</em>〉</span>] to replace the default <a id="wrglossary.7003"></a><a href="#glo:seename"><code class="csfmt">\seename</code></a> tag with <span class="meta">〈<em class="metainner">tag</em>〉</span>. The <a id="wrglossary.7004"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> key doesn’t permit this. For example, the following is permitted: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.7005"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{gourd}{<a id="wrglossary.7006"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={gourd}</span>,<a id="wrglossary.7007"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,
+ <a id="wrglossary.7008"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={[related topics]pumpkin,cucumber,melon}</span>}
+</pre> but you can’t replace <a id="wrglossary.7009"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> with <a id="wrglossary.7010"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> in the above as it would assume that the first label in the list is <code class="code">[related topics]pumpkin</code> which is incorrect. The tag would have to be removed: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.7011"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{gourd}{<a id="wrglossary.7012"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={gourd}</span>,<a id="wrglossary.7013"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,
+ <a id="wrglossary.7014"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a><span class="optfmt">={pumpkin,cucumber,melon}</span>}
+</pre> (You could then redefine <a id="wrglossary.7015"></a><a href="#glo:seealsoname"><code class="csfmt">\seealsoname</code></a> to <code class="code">related topics</code>, if required or redefine <a id="wrglossary.7016"></a><a href="#glo:glsxtruseseealsoformat"><code class="csfmt">\glsxtruseseealsoformat</code></a> as applicable.)<p>
+Example (<a id="wrglossary.7017"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> key): <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.7018"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{zucchini}{<a id="wrglossary.7019"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={zucchini}</span>,<a id="wrglossary.7020"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,
+ <a id="wrglossary.7021"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a><span class="optfmt">={courgette}</span>}
+</pre> When the <code class="code">zucchini</code> entry is defined, the <a id="wrglossary.7022"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> key will automatically <a id="wrglossary.7023"></a><a href="#glo:@@glslabel@indexing">index</a> zucchini with <code class="code"><a id="wrglossary.7024"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>{zucchini}{courgette}</code>. This means that the <code class="code">zucchini</code> entry will be present in the glossary with <span class="qt">“<span style="font-style: italic; font-variant: normal; ">see</span> courgette”</span> in the <a id="wrglossary.7025"></a><a href="#glo:dual.locationlist">location list</a>. If the <code class="code">zucchini</code> entry is referenced in the document using a command like <a id="wrglossary.7026"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>, then the hyperlink (if enabled) will go to the <code class="code">courgette</code> entry (not the <code class="code">zucchini</code> entry) but the <code class="code">zucchini</code> entry won’t be indexed.<p>
+If you want the <code class="code">zucchini</code> entry <a id="wrglossary.7027"></a><a href="#glo:@@glslabel@entrylocation">locations</a> added to the <code class="code">courgette</code> entry, you can redefine <a id="wrglossary.7028"></a><a href="#glo:glsxtrsetaliasnoindex"><code class="csfmt">\glsxtrsetaliasnoindex</code></a> (see §<a href="#sec:glssee">5.9.3</a>) or, with <a id="wrglossary.7029"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, use the <a id="wrglossary.7030"></a><a href="#glo:opt.resource.alias-loc"><span class="csoptfmt">alias-loc</span></a><span class="optfmt">=transfer</span> setting.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+With <a id="wrglossary.7031"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, cross-references are selected according to the <a id="wrglossary.7032"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a> criteria. See the <a id="wrglossary.7033"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> manual for further details. </div><!-- end of information -->
+<p>
+
+</section><!-- end of section sec:xr -->
+
+<section id="sec:seenoindex"><!-- start of section sec:seenoindex --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->5.9.1. Entries that may not be required<div class="labellink"><a href="#sec:seenoindex">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+If you have a file containing a large number of entry definitions shared across multiple documents, then the use of the <a id="wrglossary.7034"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a>, <a id="wrglossary.7035"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> or <a id="wrglossary.7036"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> key can cause unwanted entries to appear in the document. This can be demonstrated as follows. Suppose the file <span class="filefmt">myentries.tex</span> contains: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.7037"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{pumpkin}{<a id="wrglossary.7038"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={pumpkin}</span>,<a id="wrglossary.7039"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.7040"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{cucumber}{<a id="wrglossary.7041"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={cucumber}</span>,<a id="wrglossary.7042"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.7043"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{melon}{<a id="wrglossary.7044"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={melon}</span>,<a id="wrglossary.7045"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.7046"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{gourd}{<a id="wrglossary.7047"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={gourd}</span>,<a id="wrglossary.7048"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,
+ <a id="wrglossary.7049"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={pumpkin,cucumber,melon}</span>}
+<a id="wrglossary.7050"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{cucurbit}{<a id="wrglossary.7051"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={cucurbit}</span>,<a id="wrglossary.7052"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,
+ <a id="wrglossary.7053"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={gourd}</span>}
+<a id="wrglossary.7054"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{courgette}{<a id="wrglossary.7055"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={courgette}</span>,<a id="wrglossary.7056"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.7057"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{marrow}{<a id="wrglossary.7058"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={marrow}</span>,<a id="wrglossary.7059"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,
+ <a id="wrglossary.7060"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a><span class="optfmt">={courgette}</span>}
+<a id="wrglossary.7061"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{zucchini}{<a id="wrglossary.7062"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={zucchini}</span>,<a id="wrglossary.7063"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,
+ <a id="wrglossary.7064"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a><span class="optfmt">={courgette}</span>}
+<a id="wrglossary.7065"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{broccoli}{<a id="wrglossary.7066"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={broccoli}</span>,<a id="wrglossary.7067"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.7068"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{cauliflower}{<a id="wrglossary.7069"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={cauliflower}</span>,<a id="wrglossary.7070"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,
+ <a id="wrglossary.7071"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a><span class="optfmt">={broccoli}</span>}
+</pre> Some of these entries have a cross-reference key set, but not all of these entries are required in the document: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.7072"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>,<a id="wrglossary.7073"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a><span class="optfmt">=bookindex</span>,<a id="wrglossary.7074"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=bookindex</span>]
+ {glossaries-extra}
+<a id="wrglossary.7075"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.7076"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>{myentries}
+<code class="cbeg">\begin{document}</code>
+This document is only discussing <a id="wrglossary.7077"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{courgette} (baby
+<a id="wrglossary.7078"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{marrow}, also called a <a id="wrglossary.7079"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{zucchini}),
+<a id="wrglossary.7080"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{pumpkin} and <a id="wrglossary.7081"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{melon}.
+<a id="wrglossary.7082"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:autoseeindextrue"></a>Example 106: Cross-references (<span class="optfmt">autoseeindex=true</span>) <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example106.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example106.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example106.png" type="image/png" width="389" height="230">Example document illustrating the cross-referencing fields with the default auto-indexing of the cross-referenced terms.</object> </div><!-- end of resultbox -->
+ Note that the glossary includes cucurbit and gourd, which aren’t referenced in the document. They could be useful as a redirect for the reader, but the gourd entry cross-references the cucumber entry, which isn’t included in the glossary, so the hyperlink target is undefined. The cauliflower entry has also been included in the glossary, but in this case it’s not useful for the reader as neither cauliflower nor broccoli (which it cross-references) are mentioned in the document. As with the cucumber cross-reference, the broccoli cross-reference hyperlink target is undefined.<p>
+There are a number of methods to address some of these problems. The first method has the cross-referencing keys in the <a id="wrglossary.7083"></a><a href="#glo:ext.tex"><span class="extfmt">tex</span></a> file (as above), but disables the auto-indexing: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.7084"></a><a href="#glo:opt.autoseeindex"><span class="styoptfmt">autoseeindex</span></a><span class="optfmt">=false</span>,<a id="wrglossary.7085"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>,<a id="wrglossary.7086"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a><span class="optfmt">=bookindex</span>,
+ <a id="wrglossary.7087"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=bookindex</span>]{glossaries-extra}
+<a id="wrglossary.7088"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.7089"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>{myentries}
+<code class="cbeg">\begin{document}</code>
+This document is only discussing <a id="wrglossary.7090"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{courgette} (baby
+<a id="wrglossary.7091"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{marrow}, also called a <a id="wrglossary.7092"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{zucchini}),
+<a id="wrglossary.7093"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{pumpkin} and <a id="wrglossary.7094"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{melon}.
+<a id="wrglossary.7095"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:autoseeindexfalse"></a>Example 107: Cross-references (<span class="optfmt">autoseeindex=false</span>) <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example107.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example107.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example107.png" type="image/png" width="389" height="158">Example document illustrating the cross-referencing fields without the auto-indexing of the cross-referenced terms.</object> </div><!-- end of resultbox -->
+ This doesn’t show the zucchini entry or any of the cross-references in the <a id="wrglossary.7096"></a><a href="#glo:dual.glossary">glossary</a> because the information hasn’t been added to the <a id="wrglossary.7097"></a><a href="#glo:dual.indexing">indexing</a> files. One way around this is to insert the cross-reference in a <a id="wrglossary.7098"></a><a href="#glo:dual.postdeschook">post-description hook</a>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.7099"></a><a href="#glo:opt.autoseeindex"><span class="styoptfmt">autoseeindex</span></a><span class="optfmt">=false</span>,<a id="wrglossary.7100"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>,<a id="wrglossary.7101"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a><span class="optfmt">=bookindex</span>,
+ <a id="wrglossary.7102"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=bookindex</span>]{glossaries-extra}
+<a id="wrglossary.7103"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.7104"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>{myentries}
+<a id="wrglossary.7105"></a><a href="#glo:glsdefpostdesc"><code class="csfmt">\glsdefpostdesc</code></a>{general}{<span class="comment">% </span>
+ <a id="wrglossary.7106"></a><a href="#glo:glsxtrseelists"><code class="csfmt">\glsxtrseelists</code></a>{<a id="wrglossary.7107"></a><a href="#glo:glscurrententrylabel"><code class="csfmt">\glscurrententrylabel</code></a>}<span class="comment">% </span>
+}
+<code class="cbeg">\begin{document}</code>
+This document is only discussing
+<a id="wrglossary.7108"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{courgette} (baby <a id="wrglossary.7109"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{marrow},
+also called a <a id="wrglossary.7110"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{zucchini}),
+<a id="wrglossary.7111"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{pumpkin} and <a id="wrglossary.7112"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{melon}.
+<a id="wrglossary.7113"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:autoseeindexfalsepostname"></a>Example 108: Cross-references (<span class="optfmt">autoseeindex=false</span> and post-name hook) <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example108.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example108.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example108.png" type="image/png" width="389" height="158">Example document illustrating the cross-referencing fields without the auto-indexing of the cross-referenced terms but using the post-name hook.</object> </div><!-- end of resultbox -->
+<p>
+However, this still doesn’t solve the problem that the zucchini entry isn’t included in the glossary. It needs to be indexed, but <a id="wrglossary.7114"></a><a href="#glo:dual.indexing">indexing</a> has been suppressed. Firstly, because the automatic <a id="wrglossary.7115"></a><a href="#glo:dual.indexing">indexing</a> triggered by the <a id="wrglossary.7116"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> key has been suppressed with <a id="wrglossary.7117"></a><a href="#glo:opt.autoseeindex"><span class="styoptfmt">autoseeindex</span></a><span class="optfmt">=false</span>, and, secondly, because the presence of the <a id="wrglossary.7118"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> key automatically suppresses <a id="wrglossary.7119"></a><a href="#glo:dual.indexing">indexing</a> with the <a id="wrglossary.7120"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.7121"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands. This doesn’t cause a problem for the zucchini hyperlink, since the target is courgette (obtained from the <a id="wrglossary.7122"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> key).<p>
+The second method is to not use those keys in the entry definitions and use <a id="wrglossary.7123"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a> or <a id="wrglossary.7124"></a><a href="#glo:glsxtrindexseealso"><code class="csfmt">\glsxtrindexseealso</code></a> within the document. For example, the file <span class="filefmt">myentries.tex</span> now contains: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.7125"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{pumpkin}{<a id="wrglossary.7126"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={pumpkin}</span>,<a id="wrglossary.7127"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.7128"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{cucumber}{<a id="wrglossary.7129"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={cucumber}</span>,<a id="wrglossary.7130"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.7131"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{melon}{<a id="wrglossary.7132"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={melon}</span>,<a id="wrglossary.7133"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.7134"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{gourd}{<a id="wrglossary.7135"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={gourd}</span>,<a id="wrglossary.7136"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.7137"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{cucurbit}{<a id="wrglossary.7138"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={cucurbit}</span>,<a id="wrglossary.7139"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.7140"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{courgette}{<a id="wrglossary.7141"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={courgette}</span>,<a id="wrglossary.7142"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.7143"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{marrow}{<a id="wrglossary.7144"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={marrow}</span>,<a id="wrglossary.7145"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.7146"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{zucchini}{<a id="wrglossary.7147"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={zucchini}</span>,<a id="wrglossary.7148"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.7149"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{broccoli}{<a id="wrglossary.7150"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={broccoli}</span>,<a id="wrglossary.7151"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.7152"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{cauliflower}{<a id="wrglossary.7153"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={cauliflower}</span>,<a id="wrglossary.7154"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+</pre> The document: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.7155"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>,<a id="wrglossary.7156"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a><span class="optfmt">=bookindex</span>,<a id="wrglossary.7157"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=bookindex</span>]
+ {glossaries-extra}
+<a id="wrglossary.7158"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.7159"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>{myentries}
+<a id="wrglossary.7160"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>{gourd}{pumpkin,melon,courgette}
+<a id="wrglossary.7161"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>{zucchini}{courgette}
+<a id="wrglossary.7162"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>{zucchini}{alias}{courgette}
+<code class="cbeg">\begin{document}</code>
+This document is only discussing <a id="wrglossary.7163"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{courgette} (baby
+<a id="wrglossary.7164"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{marrow}, also called a <a id="wrglossary.7165"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{zucchini}),
+<a id="wrglossary.7166"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{pumpkin} and <a id="wrglossary.7167"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{melon}.
+<a id="wrglossary.7168"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:noxrfields"></a>Example 109: Cross-references (no <span class="optfmt">see</span>, <span class="optfmt">seealso</span> or <span class="optfmt">alias</span>) <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example109.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example109.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example109.png" type="image/png" width="389" height="215">Example document illustrating cross-references without using the see, seealso or alias keys.</object> </div><!-- end of resultbox -->
+ Note that aliases require the <a id="wrglossary.7169"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> field to be set. In this case, I’ve set it with <a id="wrglossary.7170"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>. The gourd and zucchini entries have been included in the glossary because they were added with <a id="wrglossary.7171"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>. The other entries are in the glossary because they were indexed when referenced with <a id="wrglossary.7172"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or <a id="wrglossary.7173"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>.<p>
+Since cucumber isn’t required in the document, I haven’t included it in the cross-reference list for gourd. This method is flexible as it allows the cross-referencing to vary between documents. For example, another document may instead have: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.7174"></a><a href="#glo:glsxtrindexseealso"><code class="csfmt">\glsxtrindexseealso</code></a>{pumpkin}{courgette,melon}
+<a id="wrglossary.7175"></a><a href="#glo:glsxtrindexseealso"><code class="csfmt">\glsxtrindexseealso</code></a>{melon}{pumpkin,courgette}
+<a id="wrglossary.7176"></a><a href="#glo:glsxtrindexseealso"><code class="csfmt">\glsxtrindexseealso</code></a>{courgette}{pumpkin,melon}
+</pre><p>
+The third method is to switch to <a id="wrglossary.7177"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. The file <span class="filefmt">myentries.tex</span> can be converted to <span class="filefmt">myentries.bib</span> using: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div><a id="wrglossary.7178"></a><a href="#glo:app.convertgls2bib"><span class="appfmt">convertgls2bib</span></a> <a id="wrglossary.7179"></a><a href="#glo:switch.index-conversion"><span class="longargfmt">--index-conversion</span></a> myentries.tex myentries.bib
+</pre> I’ve used the option <a id="wrglossary.7180"></a><a href="#glo:switch.index-conversion"><span class="longargfmt">--index-conversion</span></a> (or <a id="wrglossary.7181"></a><a href="#glo:switch.index-conversion"><span class="shortargfmt">-i</span></a>) which will use <code class="code">@index</code> instead of <code class="code">@entry</code> for entries that have an empty description (which is the case in this example). This creates the file <span class="filefmt">myentries.bib</span>, which contains the following (space compacted): <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><span class="comment">% Encoding: UTF-8</span>
+@index{pumpkin, <a id="wrglossary.7182"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={pumpkin}</span>}
+@index{cucumber, <a id="wrglossary.7183"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={cucumber}</span>}
+@index{melon, <a id="wrglossary.7184"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={melon}</span>}
+@index{gourd, <a id="wrglossary.7185"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={pumpkin,cucumber,melon}</span>, <a id="wrglossary.7186"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={gourd}</span>}
+@index{cucurbit, <a id="wrglossary.7187"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={gourd}</span>, <a id="wrglossary.7188"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={cucurbit}</span>}
+@index{courgette, <a id="wrglossary.7189"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={courgette}</span>}
+@index{marrow, <a id="wrglossary.7190"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={marrow}</span>, <a id="wrglossary.7191"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a><span class="optfmt">={courgette}</span>}
+@index{zucchini, <a id="wrglossary.7192"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={zucchini}</span>, <a id="wrglossary.7193"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a><span class="optfmt">={courgette}</span>}
+@index{broccoli, <a id="wrglossary.7194"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={broccoli}</span>}
+@index{cauliflower, <a id="wrglossary.7195"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={cauliflower}</span>, <a id="wrglossary.7196"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a><span class="optfmt">={broccoli}</span>}
+</pre> The earlier example <a href="#ex:autoseeindextrue">106</a> on page <a href="#ex:autoseeindextrue">268</a> can be rewritten as: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.7197"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>,<a id="wrglossary.7198"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>,<a id="wrglossary.7199"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a><span class="optfmt">=bookindex</span>,<a id="wrglossary.7200"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=bookindex</span>]
+ {glossaries-extra}
+<a id="wrglossary.7201"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.7202"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">=myentries</span>]
+<code class="cbeg">\begin{document}</code>
+This document is only discussing <a id="wrglossary.7203"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{courgette} (baby
+<a id="wrglossary.7204"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{marrow}, also called a <a id="wrglossary.7205"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{zucchini}),
+<a id="wrglossary.7206"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{pumpkin} and <a id="wrglossary.7207"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{melon}.
+<a id="wrglossary.7208"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> In order to support letter <a id="wrglossary.7209"></a><a href="#glo:idx.group">groups</a>, <a id="wrglossary.7210"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> needs to be invoked with the <a id="wrglossary.7211"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> switch. The result is: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:recordedanddeps"></a>Example 110: Cross-references (<span class="appfmt">bib2gls</span>) <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example110.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example110.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example110.png" type="image/png" width="389" height="180">Example document illustrating the cross-referencing fields with bib2gls and selection=recorded and deps.</object> </div><!-- end of resultbox -->
+ This uses the default <a id="wrglossary.7212"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">={recorded and deps}</span>, which selects entries that have <a id="wrglossary.7213"></a><a href="#glo:@@glslabel@indexing">records</a>, and their dependencies. Records correspond to the usual indexing performed by the <a id="wrglossary.7214"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a>, <a id="wrglossary.7215"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> or <a id="wrglossary.7216"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> commands. With <a id="wrglossary.7217"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the cross-referencing fields don’t trigger an index but identify dependencies.<p>
+Note that the above doesn’t include the gourd entry (which cross-references entries that have been indexed). The selection criteria can be changed to also include unrecorded entries that cross-reference selected entries. There are two options to choose from: <a id="wrglossary.7218"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">={recorded and deps and see}</span>, which will apply to all cross-reference fields (<a id="wrglossary.7219"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a>, <a id="wrglossary.7220"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> and <a id="wrglossary.7221"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a>, or <a id="wrglossary.7222"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">={recorded and deps and see not also}</span>, which doesn’t consider the <a id="wrglossary.7223"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> field.<p>
+Changing the <a id="wrglossary.7224"></a><a href="#glo:idx.resourceopt">resource options</a> in the above example to: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.7225"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.7226"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">=myentries</span>,
+ <a id="wrglossary.7227"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">={recorded and deps and see}</span>]
+</pre> results in: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:recordedanddepsandsee"></a>Example 111: Cross-references (<span class="appfmt">bib2gls</span> and <span class="optfmt">selection=recorded and deps and see</span>) <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example111.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example111.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example111.png" type="image/png" width="389" height="230">Example document illustrating the cross-referencing fields with bib2gls and selection=recorded and deps and see.</object> </div><!-- end of resultbox -->
+ This now includes the gourd entry because it cross-references pumpkin and melon, which have been <a id="wrglossary.7228"></a><a href="#glo:@@glslabel@indexing">recorded</a> in the document. The cucurbit entry is also included because it cross-references the (now selected) gourd entry. Note that the cucumber entry has been selected because the gourd entry depends on it. This means there are no broken links in the glossary, but it looks a bit odd as the cucumber entry has no <a id="wrglossary.7229"></a><a href="#glo:dual.locationlist">location list</a>. As from <a id="wrglossary.7230"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v3.0, this can be removed with one of the cross-reference pruning options, such as <a id="wrglossary.7231"></a><a href="#glo:opt.resource.prune-xr"><span class="csoptfmt">prune-xr</span></a>. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.7232"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.7233"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">=myentries</span>,
+ <a id="wrglossary.7234"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">={recorded and deps and see}</span>,<a id="wrglossary.7235"></a><a href="#glo:opt.resource.prune-xr"><span class="csoptfmt">prune-xr</span></a>]
+</pre> results in: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:recordedanddepsandseeprune"></a>Example 112: Cross-references (<span class="appfmt">bib2gls</span> and <span class="optfmt">selection=recorded and deps and see</span>, <span class="optfmt">prune-xr</span>) <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example112.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example112.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example112.png" type="image/png" width="389" height="215">Example document illustrating the cross-referencing fields with bib2gls and selection=recorded and deps and see and pruning.</object> </div><!-- end of resultbox -->
+ This has removed the unnecessary cucumber from the gourd’s <a id="wrglossary.7236"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> list, and so cucumber doesn’t get selected.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+See the <a id="wrglossary.7237"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for further details on the cross-reference selection and pruning options. </div><!-- end of information -->
+<p>
+
+</section><!-- end of section sec:seenoindex -->
+
+<section id="sec:getsee"><!-- start of section sec:getsee --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->5.9.2. Accessing the Cross-Referencing Fields<div class="labellink"><a href="#sec:getsee">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+If you have switched off the indexing of the cross-reference fields (with <a id="wrglossary.7238"></a><a href="#glo:opt.autoseeindex"><span class="styoptfmt">autoseeindex</span></a><span class="optfmt">=false</span>) or want to suppress the <a id="wrglossary.7239"></a><a href="#glo:dual.locationlist">location lists</a>, then you can adjust the glossary style or hooks to include the cross-references since they won’t be shown otherwise.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7240"></a><code class="code"><dfn id="glo:glsxtrseelists"><code class="csfmt">\glsxtrseelists</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> has the <a id="wrglossary.7241"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a>, <a id="wrglossary.7242"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> or <a id="wrglossary.7243"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> fields set, this will display the cross reference according to <a id="wrglossary.7244"></a><a href="#glo:glsxtruseseeformat"><code class="csfmt">\glsxtruseseeformat</code></a> (for <a id="wrglossary.7245"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> and <a id="wrglossary.7246"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a>) or <a id="wrglossary.7247"></a><a href="#glo:glsxtruseseealsoformat"><code class="csfmt">\glsxtruseseealsoformat</code></a> (for <a id="wrglossary.7248"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a>). If any of these fields are set, the list is encapsulated with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7249"></a><code class="code"><dfn id="glo:glsxtrseelistsencap"><code class="csfmt">\glsxtrseelistsencap</code></dfn>{<span class="meta">〈<em class="metainner">content</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This simply does a space followed by <span class="meta">〈<em class="metainner">content</em>〉</span>. If more than one of the fields are set (not recommended), then they will be displayed in the order: <a id="wrglossary.7250"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a>, <a id="wrglossary.7251"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> and <a id="wrglossary.7252"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a>. The entire set will be encapsulated with <a id="wrglossary.7253"></a><a href="#glo:glsxtrseelistsencap"><code class="csfmt">\glsxtrseelistsencap</code></a> and each sub-list will be separated with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7254"></a><code class="code"><dfn id="glo:glsxtrseelistsdelim"><code class="csfmt">\glsxtrseelistsdelim</code></dfn></code></div><!-- end of pinnedbox -->
+ which defaults to a comma followed by a space.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7255"></a><code class="code"><dfn id="glo:glsxtrusesee"><code class="csfmt">\glsxtrusesee</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> has the <a id="wrglossary.7256"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> field set, this will display the cross reference according to <a id="wrglossary.7257"></a><a href="#glo:glsxtruseseeformat"><code class="csfmt">\glsxtruseseeformat</code></a>, otherwise this does nothing. An error (or warning with <a id="wrglossary.7258"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=</span><a id="wrglossary.7259"></a><a href="#glo:optval.undefaction.warn"><span class="optfmt">warn</span></a>) will occur if the entry hasn’t been defined.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7260"></a><code class="code"><dfn id="glo:glsxtrusealias"><code class="csfmt">\glsxtrusealias</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.7261"></a><a href="#glo:glsxtrusesee"><code class="csfmt">\glsxtrusesee</code></a> but for the <a id="wrglossary.7262"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> field.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7263"></a><code class="code"><dfn id="glo:glsxtruseseealso"><code class="csfmt">\glsxtruseseealso</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> has the <a id="wrglossary.7264"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> field set, this will display the cross reference according to <a id="wrglossary.7265"></a><a href="#glo:glsxtruseseealsoformat"><code class="csfmt">\glsxtruseseealsoformat</code></a>, otherwise this does nothing. An error (or warning with <a id="wrglossary.7266"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=</span><a id="wrglossary.7267"></a><a href="#glo:optval.undefaction.warn"><span class="optfmt">warn</span></a>) will occur if the entry hasn’t been defined.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7268"></a><code class="code"><dfn id="glo:glsxtralias"><code class="csfmt">\glsxtralias</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This expands to the value of the <a id="wrglossary.7269"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> field (which should be a single entry label) or empty if the field isn’t set. If the entry isn’t defined, this command will expand to <a id="wrglossary.7270"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a> (without any error or warning). If you want to first test if the field is set, you can use <a id="wrglossary.7271"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7272"></a><code class="code"><dfn id="glo:glsxtrseealsolabels"><code class="csfmt">\glsxtrseealsolabels</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This expands to the value of the <a id="wrglossary.7273"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> field (which should be a comma-separated list of entry labels) or empty if the field isn’t set. If the entry isn’t defined, this command will expand to <a id="wrglossary.7274"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a> (without any error or warning). If you want to first test if the field is set, you can use <a id="wrglossary.7275"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7276"></a><code class="code"><dfn id="glo:glsxtruseseealsoformat"><code class="csfmt">\glsxtruseseealsoformat</code></dfn>{<span class="meta">〈<em class="metainner">csv-list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is used to format a <span class="qt">“see also”</span> cross-reference. This is simply defined to do: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.7277"></a><a href="#glo:glsseeformat"><code class="csfmt">\glsseeformat</code></a>[<a id="wrglossary.7278"></a><a href="#glo:seealsoname"><code class="csfmt">\seealsoname</code></a>]{<span class="meta">〈<em class="metainner">csv-list</em>〉</span>}{<span class="meta">〈<em class="metainner"></em>〉</span>}
+</pre><p>
+
+</section><!-- end of section sec:getsee -->
+
+<section id="sec:glssee"><!-- start of section sec:glssee --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->5.9.3. Cross-Reference Indexing<div class="labellink"><a href="#sec:glssee">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+If you are using <a id="wrglossary.7279"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, see the <a id="wrglossary.7280"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for information about the <a id="wrglossary.7281"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a>, <a id="wrglossary.7282"></a><a href="#glo:opt.resource.see"><span class="csoptfmt">see</span></a>, <a id="wrglossary.7283"></a><a href="#glo:opt.resource.seealso"><span class="csoptfmt">seealso</span></a>, <a id="wrglossary.7284"></a><a href="#glo:opt.resource.alias"><span class="csoptfmt">alias</span></a>, <a id="wrglossary.7285"></a><a href="#glo:opt.resource.alias-loc"><span class="csoptfmt">alias-loc</span></a> options. </div><!-- end of information -->
+<p>
+The actual <a id="wrglossary.7286"></a><a href="#glo:dual.indexing">indexing</a> of the <a id="wrglossary.7287"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> key is performed with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7288"></a><code class="code"><dfn id="glo:glsxtrindexseealso"><code class="csfmt">\glsxtrindexseealso</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">xr-list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which is analogous to <a id="wrglossary.7289"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>. As with <a id="wrglossary.7290"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>, this can also be used explicitly.<p>
+With <a id="wrglossary.7291"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, <a id="wrglossary.7292"></a><a href="#glo:glsxtrindexseealso"><code class="csfmt">\glsxtrindexseealso</code></a> simply does: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.7293"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>[<a id="wrglossary.7294"></a><a href="#glo:seealsoname"><code class="csfmt">\seealsoname</code></a>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">xr-list</em>〉</span>}
+</pre> With <a id="wrglossary.7295"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, <a id="wrglossary.7296"></a><a href="#glo:glsxtrindexseealso"><code class="csfmt">\glsxtrindexseealso</code></a> behaves in an analogous way, using the appropriate cross-referencing markup.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7297"></a><code class="code"><dfn id="glo:glsxtrsetaliasnoindex"><code class="csfmt">\glsxtrsetaliasnoindex</code></dfn></code></div><!-- end of pinnedbox -->
+ This hook is used within the <a id="wrglossary.7298"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.7299"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands to automatically switch off the <a id="wrglossary.7300"></a><a href="#glo:dual.indexing">indexing</a> for aliases. (The hook is performed after the options set by <a id="wrglossary.7301"></a><a href="#glo:GlsXtrSetDefaultGlsOpts"><code class="csfmt">\GlsXtrSetDefaultGlsOpts</code></a>.)<p>
+By default, this hook just sets <a id="wrglossary.7302"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a><span class="optfmt">=true</span>. If you would like to add <a id="wrglossary.7303"></a><a href="#glo:@@glslabel@entrylocation">locations</a> to the aliased <a id="wrglossary.7304"></a><a href="#glo:dual.locationlist">location list</a> then you can redefine it to use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7305"></a><code class="code"><dfn id="glo:glsxtrindexaliased"><code class="csfmt">\glsxtrindexaliased</code></dfn></code></div><!-- end of pinnedbox -->
+ For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.7306"></a><a href="#glo:glsxtrsetaliasnoindex"><code class="csfmt">\glsxtrsetaliasnoindex</code></a>}{<a id="wrglossary.7307"></a><a href="#glo:glsxtrindexaliased"><code class="csfmt">\glsxtrindexaliased</code></a>}
+</pre> Note that this needs <a id="wrglossary.7308"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a><span class="optfmt">=false</span> to ensure the <a id="wrglossary.7309"></a><a href="#glo:dual.indexing">indexing</a> takes place so don’t simply append <a id="wrglossary.7310"></a><a href="#glo:glsxtrindexaliased"><code class="csfmt">\glsxtrindexaliased</code></a> to the definition of <a id="wrglossary.7311"></a><a href="#glo:glsxtrsetaliasnoindex"><code class="csfmt">\glsxtrsetaliasnoindex</code></a>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+Don’t use the above hooks with <a id="wrglossary.7312"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> as this function is disabled with <a id="wrglossary.7313"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.7314"></a><a href="#glo:optval.record.only"><span class="optfmt">only</span></a> and <a id="wrglossary.7315"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.7316"></a><a href="#glo:optval.record.nameref"><span class="optfmt">nameref</span></a>. Use the <a id="wrglossary.7317"></a><a href="#glo:opt.resource.alias-loc"><span class="csoptfmt">alias-loc</span></a> resource option instead. </div><!-- end of information -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7318"></a><code class="code"><dfn id="glo:glsxtraddallcrossrefs"><code class="csfmt">\glsxtraddallcrossrefs</code></dfn></code></div><!-- end of pinnedbox -->
+ This is used at the end of the document if <a id="wrglossary.7319"></a><a href="#glo:opt.indexcrossrefs"><span class="styoptfmt">indexcrossrefs</span></a><span class="optfmt">=true</span> to automatically index any cross-references (identified in the <a id="wrglossary.7320"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a>, <a id="wrglossary.7321"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> and <a id="wrglossary.7322"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> fields). This command iterates over all entries in all glossaries and, if an entry has been marked as used, does: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7323"></a><code class="code"><dfn id="glo:glsxtraddunusedxrefs"><code class="csfmt">\glsxtraddunusedxrefs</code></dfn></code></div><!-- end of pinnedbox -->
+ which indexes any labels identified in the cross-reference fields of the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> that haven’t been marked as used. <p>
+This can be time consuming if there are a large number of entries defined. If this is the case, you may want to consider switching to <a id="wrglossary.7324"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> and use either <a id="wrglossary.7325"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">={recorded and deps and see}</span> or <a id="wrglossary.7326"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">={recorded and deps and see not also}</span>.<p>
+There should be no need to use <a id="wrglossary.7327"></a><a href="#glo:glsxtraddallcrossrefs"><code class="csfmt">\glsxtraddallcrossrefs</code></a> explicitly, but you may want to redefine it to only iterate over specific glossaries. The unused entries are indexed using the <a id="wrglossary.7328"></a><a href="#glo:glsxtrunusedformat"><span class="csfmtcolourfont">glsxtrunusedformat</span></a> format.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7329"></a><code class="code"><dfn id="glo:glsxtrunusedformat"><code class="csfmt">\glsxtrunusedformat</code></dfn>{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This ignores its argument (the <a id="wrglossary.7330"></a><a href="#glo:@@glslabel@entrylocation">location</a>) and just does <a id="wrglossary.7331"></a><a href="#glo:unskip"><code class="csfmt">\unskip</code></a>.<p>
+
+</section><!-- end of section sec:glssee -->
+
+<section id="sec:glsunset"><!-- start of section sec:glsunset --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->5.10. First Use Flag<div class="labellink"><a href="#sec:glsunset">[link]</a></div></h2><!-- end of section header -->
+<p>
+Each entry has an associated <a id="wrglossary.7332"></a><a href="#glo:dual.firstuseflag">first use flag</a> (a conditional or boolean variable), which determines whether or not the entry has been marked as <span class="qt">“used”</span>. Unsetting this flag means that the entry is marked as used. Resetting the flag means that the entry is marked as unused.<p>
+The <a id="wrglossary.7333"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands (which are the principle method of referencing an entry) all mark the entry as used after the <a id="wrglossary.7334"></a><a href="#glo:dual.linktext">link text</a> is displayed but before the <a id="wrglossary.7335"></a><a href="#glo:dual.postlinkhook">post-link hook</a> is used.<p>
+The purpose of this is to allow for additional information that needs to be shown when a term first appears in a document. For example, an abbreviation may need to have its full form shown on the instance. However, there are some cases where that additional information may need to be shown again or where the literal first instance of the term may need to be in its terse form. For example, if the term is used in the front matter.<p>
+If any <a id="wrglossary.7336"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands (which are robust) are used in section headings or captions, they can end up in the table of contents or corresponding <span class="qt">“list of …”</span> (such as the list of figures). This can cause the <a id="wrglossary.7337"></a><a href="#glo:dual.firstuseflag">first use flag</a> to be unset too soon. For these situations, use the commands described in §<a href="#sec:headtitle">5.3</a> instead.<p>
+The base <a id="wrglossary.7338"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package provides commands to explicitly unset or reset the <a id="wrglossary.7339"></a><a href="#glo:dual.firstuseflag">first use flag</a> either locally (confined to the current scope) or globally. These commands are: <a id="wrglossary.7340"></a><a href="#glo:glsunset"><code class="csfmt">\glsunset</code></a> (global unset), <a id="wrglossary.7341"></a><a href="#glo:glslocalunset"><code class="csfmt">\glslocalunset</code></a> (local unset), <a id="wrglossary.7342"></a><a href="#glo:glsreset"><code class="csfmt">\glsreset</code></a> (global reset) and <a id="wrglossary.7343"></a><a href="#glo:glslocalreset"><code class="csfmt">\glslocalreset</code></a> (local reset).<p>
+The <a id="wrglossary.7344"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package adds hooks to the above commands. These do nothing by default, but are modified by <a id="wrglossary.7345"></a><a href="#glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></a> and <a id="wrglossary.7346"></a><a href="#glo:glsenableentryunitcount"><code class="csfmt">\glsenableentryunitcount</code></a> to perform the count increment or reset (see §<a href="#sec:entrycount">6.1</a>).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7347"></a><code class="code"><dfn id="glo:glsxtrpostunset"><code class="csfmt">\glsxtrpostunset</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This hook is added to <a id="wrglossary.7348"></a><a href="#glo:glsunset"><code class="csfmt">\glsunset</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7349"></a><code class="code"><dfn id="glo:glsxtrpostlocalunset"><code class="csfmt">\glsxtrpostlocalunset</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This hook is added to <a id="wrglossary.7350"></a><a href="#glo:glslocalunset"><code class="csfmt">\glslocalunset</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7351"></a><code class="code"><dfn id="glo:glsxtrpostreset"><code class="csfmt">\glsxtrpostreset</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This hook is added to <a id="wrglossary.7352"></a><a href="#glo:glsreset"><code class="csfmt">\glsreset</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7353"></a><code class="code"><dfn id="glo:glsxtrpostlocalreset"><code class="csfmt">\glsxtrpostlocalreset</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This hook is added to <a id="wrglossary.7354"></a><a href="#glo:glslocalreset"><code class="csfmt">\glslocalreset</code></a>.<p>
+The base package also provides commands to unset or reset all entries or all entries within particular glossaries: <a id="wrglossary.7355"></a><a href="#glo:glsunsetall"><code class="csfmt">\glsunsetall</code></a> and <a id="wrglossary.7356"></a><a href="#glo:glsresetall"><code class="csfmt">\glsresetall</code></a>. For example, if you don’t want the <a id="wrglossary.7357"></a><a href="#glo:dual.firstuse">first use</a> in the front matter, you can unset all entries at the start of the front matter and reset them at the start of the main matter. <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\frontmatter</code><a id="wrglossary.7358"></a><a href="#glo:glsunsetall"><code class="csfmt">\glsunsetall</code></a>
+…<code class="cmd">\mainmatter</code><a id="wrglossary.7359"></a><a href="#glo:glsresetall"><code class="csfmt">\glsresetall</code></a>
+</pre><p>
+With <a id="wrglossary.7360"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> you can unset a specific subset of entries. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7361"></a><code class="code"><dfn id="glo:glslocalunseteach"><code class="csfmt">\glslocalunseteach</code></dfn>{<span class="meta">〈<em class="metainner">entry-labels</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Locally unsets each entry in the given comma-separated list of entry labels. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7362"></a><code class="code"><dfn id="glo:glslocalreseteach"><code class="csfmt">\glslocalreseteach</code></dfn>{<span class="meta">〈<em class="metainner">entry-labels</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Locally resets each entry in the given comma-separated list of entry labels.<p>
+You can test if an entry has been marked as used with <a id="wrglossary.7363"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a> (but take care if you are using <a id="wrglossary.7364"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> or the <a id="wrglossary.7365"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=warn</span> option, see below). This command allows the entry display style to vary the <a id="wrglossary.7366"></a><a href="#glo:dual.linktext">link text</a> according to whether or not the entry has been marked as used. However, it can’t be used within the <a id="wrglossary.7367"></a><a href="#glo:dual.postlinkhook">post-link hook</a> as by that time, the <a id="wrglossary.7368"></a><a href="#glo:dual.firstuseflag">first use flag</a> will have already been unset.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+See the <a id="wrglossary.7369"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> user manual for further details of the above commands. </div><!-- end of information -->
+<p>
+For example, in the following document the <span class="qt">“html”</span> entry is first used in the abstract, which shows both the long and the short form, but it would be helpful for the full form to be reshown in the main section about web pages. This is achieved by resetting the <a id="wrglossary.7370"></a><a href="#glo:dual.firstuseflag">first use flag</a>. <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.7371"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{html}{HTML}{hypertext markup language}
+<code class="cbeg">\begin{document}</code>
+ <code class="cbeg">\begin{abstract}</code>
+ This abstract mentions <a id="wrglossary.7372"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+ <code class="cend">\end{abstract}</code>
+ Some casual reference to <a id="wrglossary.7373"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+ <code class="cmd">\section</code>{Web Pages}
+ <a id="wrglossary.7374"></a><a href="#glo:glsreset"><code class="csfmt">\glsreset</code></a>{html}This section is all about <a id="wrglossary.7375"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:glsreset"></a>Example 113: Resetting the first use flag (<code class="cmd">\glsreset</code>) <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example113.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example113.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example113.png" type="image/png" width="339" height="124">Example document illustrating the use of <code class="cmd">\glsreset</code>.</object> </div><!-- end of resultbox -->
+ In the above example, an alternative is to use <a id="wrglossary.7376"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> where you particularly want the full form, but some abbreviation styles have a different expansion with the <a id="wrglossary.7377"></a><a href="#glo:@@glslabel@inlinefullform">inline</a> <a id="wrglossary.7378"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> form compared with the <a id="wrglossary.7379"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.7380"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>.<p>
+The <a id="wrglossary.7381"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides the options <a id="wrglossary.7382"></a><a href="#glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></a> and <a id="wrglossary.7383"></a><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a>, which can be used to unset or reset the <a id="wrglossary.7384"></a><a href="#glo:dual.firstuseflag">first use flag</a> before the <a id="wrglossary.7385"></a><a href="#glo:dual.linktext">link text</a>. This means that in the above example, the line: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.7386"></a><a href="#glo:glsreset"><code class="csfmt">\glsreset</code></a>{html}This section is all about <a id="wrglossary.7387"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+</pre> can be replaced with: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>This section is all about <a id="wrglossary.7388"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.7389"></a><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a>]{html}.
+</pre><p>
+As mentioned above, the <a id="wrglossary.7390"></a><a href="#glo:dual.firstuseflag">first use flag</a> is unset before the <a id="wrglossary.7391"></a><a href="#glo:dual.postlinkhook">post-link hook</a>, so <a id="wrglossary.7392"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a> isn’t helpful in the <a id="wrglossary.7393"></a><a href="#glo:dual.postlinkhook">post-link hook</a>. Instead, you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7394"></a><code class="code"><dfn id="glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></dfn>{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is initialised by the <a id="wrglossary.7395"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands according to the value of the <a id="wrglossary.7396"></a><a href="#glo:dual.firstuseflag">first use flag</a> before the <a id="wrglossary.7397"></a><a href="#glo:dual.linktext">link text</a>. It’s also initialised by the <a id="wrglossary.7398"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands: not according to the value of the <a id="wrglossary.7399"></a><a href="#glo:dual.firstuseflag">first use flag</a> but according to whether or not the <a id="wrglossary.7400"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> command emulates <a id="wrglossary.7401"></a><a href="#glo:dual.firstuse">first use</a>. <p>
+For example, <a id="wrglossary.7402"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> will define <a id="wrglossary.7403"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a> to do its first argument if the <a id="wrglossary.7404"></a><a href="#glo:dual.firstuseflag">first use flag</a> indicates the entry hasn’t yet been used, otherwise it will define <a id="wrglossary.7405"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a> to do its second argument. Whereas <a id="wrglossary.7406"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a> will always define <a id="wrglossary.7407"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a> to do its first argument (unless used with <a id="wrglossary.7408"></a><a href="#glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></a>) and <a id="wrglossary.7409"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> will always define <a id="wrglossary.7410"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a> to do its second argument (unless used with <a id="wrglossary.7411"></a><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a>), regardless of the state of the <a id="wrglossary.7412"></a><a href="#glo:dual.firstuseflag">first use flag</a>.<p>
+The <a id="wrglossary.7413"></a><a href="#glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></a> and <a id="wrglossary.7414"></a><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a> options will additionally redefine <a id="wrglossary.7415"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a> to match the option. See §<a href="#sec:postlinkhook">5.5.4</a> for further details about the <a id="wrglossary.7416"></a><a href="#glo:dual.postlinkhook">post-link hook</a>.<p>
+If you want to check if the calling command was both the <a id="wrglossary.7417"></a><a href="#glo:dual.firstuse">first use</a> and it was a <a id="wrglossary.7418"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> command, you can use: <a id="wrglossary.7419"></a><a href="#glo:glsxtrifwasglslikeandfirstuse"><code class="csfmt">\glsxtrifwasglslikeandfirstuse</code></a>.<p>
+The unset function performed by the <a id="wrglossary.7420"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands before the <a id="wrglossary.7421"></a><a href="#glo:dual.postlinkhook">post-link hook</a> uses the global <a id="wrglossary.7422"></a><a href="#glo:glsunset"><code class="csfmt">\glsunset</code></a> by default. If you want <a id="wrglossary.7423"></a><a href="#glo:glslocalunset"><code class="csfmt">\glslocalunset</code></a> instead, you can use the <a id="wrglossary.7424"></a><a href="#glo:opt.glsopt.local"><span class="csoptfmt">local</span></a> option (provided by the base <a id="wrglossary.7425"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package) or <a id="wrglossary.7426"></a><a href="#glo:opt.glsopt.postunset"><span class="csoptfmt">postunset</span></a><span class="optfmt">=local</span>. To prevent the <a id="wrglossary.7427"></a><a href="#glo:dual.firstuseflag">first use flag</a> from being unset after the <a id="wrglossary.7428"></a><a href="#glo:dual.linktext">link text</a>, use <a id="wrglossary.7429"></a><a href="#glo:opt.glsopt.postunset"><span class="csoptfmt">postunset</span></a><span class="optfmt">=none</span>.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.7430"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{html}{HTML}{hypertext markup language}
+<code class="cbeg">\begin{document}</code>
+{% local scope
+<a id="wrglossary.7431"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.7432"></a><a href="#glo:opt.glsopt.local"><span class="csoptfmt">local</span></a>]{html}. Used? <a id="wrglossary.7433"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{html}{Yes}{No}.
+}% end scope
+
+Used? <a id="wrglossary.7434"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{html}{Yes}{No}.
+
+<a id="wrglossary.7435"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.7436"></a><a href="#glo:opt.glsopt.postunset"><span class="csoptfmt">postunset</span></a><span class="optfmt">=none</span>]{html}. Used? <a id="wrglossary.7437"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{html}{Yes}{No}.
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:glslocalunset"></a>Example 114: Local unset <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example114.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example114.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example114.png" type="image/png" width="253" height="42">Example document illustrating locally unsetting the first use flag.</object> </div><!-- end of resultbox -->
+<p>
+If you are using the <a id="wrglossary.7438"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=warn</span> option (which is automatically implemented by the <a id="wrglossary.7439"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a> option), the <a id="wrglossary.7440"></a><a href="#glo:dual.firstuseflag">first use flag</a> is undefined and so is neither true nor false, in which case <a id="wrglossary.7441"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a> will trigger an error or warning and do neither. In this situation, you may need to use the following command instead.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7442"></a><code class="code"><dfn id="glo:GlsXtrIfUnusedOrUndefined"><code class="csfmt">\GlsXtrIfUnusedOrUndefined</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does <span class="meta">〈<em class="metainner">true</em>〉</span> if the entry hasn’t been defined or hasn’t been marked as <a id="wrglossary.7443"></a><a href="#glo:firstuseflag">used</a>, otherwise does <span class="meta">〈<em class="metainner">true</em>〉</span>. Note that this command will generate an error or warning (according to <a id="wrglossary.7444"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a>) if the entry hasn’t been defined, but will still do <span class="meta">〈<em class="metainner">true</em>〉</span>. This is more useful than <a id="wrglossary.7445"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a> with <a id="wrglossary.7446"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> where the entries are never defined on the first LaTeX run.<p>
+
+</section><!-- end of section sec:glsunset -->
+
+<section id="sec:unsetbuffer"><!-- start of section sec:unsetbuffer --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->5.10.1. Buffering Unsets<div class="labellink"><a href="#sec:unsetbuffer">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+Sometimes commands like <a id="wrglossary.7447"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> are used in a context where changing a boolean variable can cause things to go wrong. The outer, middle and inner formatting (see §<a href="#sec:entryfmtmods">5.5</a>) can be used to change the font for the <a id="wrglossary.7448"></a><a href="#glo:dual.linktext">link text</a>, but it may be that the <a id="wrglossary.7449"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> command occurs within a block of text that needs to be encapsulated by such a command.<p>
+One example of this is using <a id="wrglossary.7450"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> in one of the commands provided with the <a id="wrglossary.7451"></a><a href="#glo:pkg.soul"><span class="styfmt">soul</span></a> package. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.7452"></a><a href="#glo:ul"><code class="csfmt">\ul</code></a>{Some text about <a id="wrglossary.7453"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.}
+</pre> This causes the confusing error: <pre class="transcript"><div class="transcripttitle"><a href="#glo:sym.transcript"><span title="Transcript" class="icon">🔎</span></a></div>Glossary entry `{html}' has not been defined.
+</pre> The simplest workaround is to put <code class="code"><a id="wrglossary.7454"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}</code> inside the argument of <a id="wrglossary.7455"></a><a href="#glo:mbox"><code class="csfmt">\mbox</code></a>. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.7456"></a><a href="#glo:ul"><code class="csfmt">\ul</code></a>{Some text about <a id="wrglossary.7457"></a><a href="#glo:mbox"><code class="csfmt">\mbox</code></a>{<a id="wrglossary.7458"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}}.}
+</pre> This can work provided it’s not the <a id="wrglossary.7459"></a><a href="#glo:dual.firstuse">first use</a> of this entry. It if is, then unsetting the <a id="wrglossary.7460"></a><a href="#glo:dual.firstuseflag">first use flag</a> causes a problem and results in the error: <pre class="transcript"><div class="transcripttitle"><a href="#glo:sym.transcript"><span title="Transcript" class="icon">🔎</span></a></div>! Package soul Error: Reconstruction failed.
+</pre> The <a id="wrglossary.7461"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides a way of temporarily switching off <a id="wrglossary.7462"></a><a href="#glo:glsunset"><code class="csfmt">\glsunset</code></a> so that it just makes a note of the entry’s label but doesn’t actually perform the change. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7463"></a><code class="code"><dfn id="glo:GlsXtrStartUnsetBuffering"><code class="csfmt">\GlsXtrStartUnsetBuffering</code></dfn></code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This starts the buffering. The unstarred version doesn’t check for duplicates, so the internal list may end up with multiple occurrences of the same label. The starred version only adds a label to the internal list if it’s not already in it. If you are using entry counting (see §<a href="#sec:entrycount">6.1</a>) the unstarred version is preferable to ensure the entry count is correct.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Buffering only applies to the global <a id="wrglossary.7464"></a><a href="#glo:glsunset"><code class="csfmt">\glsunset</code></a> and does not affect the local <a id="wrglossary.7465"></a><a href="#glo:glslocalunset"><code class="csfmt">\glslocalunset</code></a>. </div><!-- end of important -->
+<p>
+The buffer can be locally cleared with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7466"></a><code class="code"><dfn id="glo:GlsXtrClearUnsetBuffer"><code class="csfmt">\GlsXtrClearUnsetBuffer</code></dfn></code></div><!-- end of pinnedbox -->
+ This doesn’t stop buffering. It will simply discard the labels that have been buffered so far.<p>
+In order to restore the normal behaviour of <a id="wrglossary.7467"></a><a href="#glo:glsunset"><code class="csfmt">\glsunset</code></a>, the buffering must be stopped or discarded. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7468"></a><code class="code"><dfn id="glo:GlsXtrStopUnsetBuffering"><code class="csfmt">\GlsXtrStopUnsetBuffering</code></dfn></code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This stops the buffering, restores <a id="wrglossary.7469"></a><a href="#glo:glsunset"><code class="csfmt">\glsunset</code></a>, and unsets all the buffered labels. The starred form uses <a id="wrglossary.7470"></a><a href="#glo:glslocalunset"><code class="csfmt">\glslocalunset</code></a> to unset the buffered labels. <p>
+Before you stop the unset buffering, you can iterate over the current buffer. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7471"></a><code class="code"><dfn id="glo:GlsXtrForUnsetBufferedList"><code class="csfmt">\GlsXtrForUnsetBufferedList</code></dfn>{<span class="meta">〈<em class="metainner">handler-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This iterates over the currently buffered list of entry labels and performs <code class="code"><code class="csfmt">\<span class="meta">〈<em class="metainner">handler-cs</em>〉</span></code>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code> for each label, where <span class="meta">〈<em class="metainner">cs</em>〉</span> is a control sequence that takes a single argument. This is best used with the starred version of <a id="wrglossary.7472"></a><a href="#glo:GlsXtrStartUnsetBuffering"><code class="csfmt">\GlsXtrStartUnsetBuffering</code>*</a> to avoid duplicates.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7473"></a><code class="code"><dfn id="glo:GlsXtrDiscardUnsetBuffering"><code class="csfmt">\GlsXtrDiscardUnsetBuffering</code></dfn></code></div><!-- end of pinnedbox -->
+ This discards the buffer and restores <a id="wrglossary.7474"></a><a href="#glo:glsunset"><code class="csfmt">\glsunset</code></a> to its normal behaviour.<p>
+It’s possible to locally unset entries before use (analogous to <a id="wrglossary.7475"></a><a href="#glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></a><span class="optfmt">=local</span>) if the entry has already been encountered in the buffer. This will still be problematic for situations where changing a conditional causes a problem, but may be useful in some situations. This feature is enabled with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7476"></a><code class="code"><dfn id="glo:GlsXtrUnsetBufferEnableRepeatLocal"><code class="csfmt">\GlsXtrUnsetBufferEnableRepeatLocal</code></dfn></code></div><!-- end of pinnedbox -->
+ This may be placed before or after <a id="wrglossary.7477"></a><a href="#glo:GlsXtrStartUnsetBuffering"><code class="csfmt">\GlsXtrStartUnsetBuffering</code></a> but the locally collected list of unused entries will be cleared at the start of each instance of <a id="wrglossary.7478"></a><a href="#glo:GlsXtrStartUnsetBuffering"><code class="csfmt">\GlsXtrStartUnsetBuffering</code></a>. It will also be cleared by <a id="wrglossary.7479"></a><a href="#glo:GlsXtrClearUnsetBuffer"><code class="csfmt">\GlsXtrClearUnsetBuffer</code></a>. All entries that have been marked as unused can be reset with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7480"></a><code class="code"><dfn id="glo:GlsXtrResetLocalBuffer"><code class="csfmt">\GlsXtrResetLocalBuffer</code></dfn></code></div><!-- end of pinnedbox -->
+ This will perform a local reset on all the entries in the <span class="qt">“not used”</span> list and do <a id="wrglossary.7481"></a><a href="#glo:GlsXtrClearUnsetBuffer"><code class="csfmt">\GlsXtrClearUnsetBuffer</code></a>.<p>
+This feature can be switched off with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7482"></a><code class="code"><dfn id="glo:GlsXtrUnsetBufferDisableRepeatLocal"><code class="csfmt">\GlsXtrUnsetBufferDisableRepeatLocal</code></dfn></code></div><!-- end of pinnedbox -->
+ It’s disabled by default.<p>
+The way this feature works is as follows (while buffering is active):
+<ol class="displaylist">
+ <li><span class="numitem">1.</span>Each time an entry is referenced with a <a id="wrglossary.7483"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> command, the <a id="wrglossary.7484"></a><a href="#glo:glsinitreunsets"><code class="csfmt">\glsinitreunsets</code></a> hook checks if the current entry (identified by <a id="wrglossary.7485"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>) has been added to the buffer. (Bear in mind that the label is added to the buffer after the <a id="wrglossary.7486"></a><a href="#glo:dual.linktext">link text</a> when <a id="wrglossary.7487"></a><a href="#glo:glsunset"><code class="csfmt">\glsunset</code></a> is used.)<p>
+
+<ol class="displaylist">
+ <li><span class="numitem">(a)</span>If it has been added to the buffer, then this is an indication that the entry has already been used within the buffer zone (that is, an attempt has been made to globally unset the <a id="wrglossary.7488"></a><a href="#glo:dual.firstuseflag">first use flag</a>). A local unset is then performed, which is essentially equivalent to using the <a id="wrglossary.7489"></a><a href="#glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></a><span class="optfmt">=local</span> option, so the reference will behave like <a id="wrglossary.7490"></a><a href="#glo:dual.subsequentuse">subsequent use</a>.<p>
+<li><span class="numitem">(b)</span>If it hasn’t been added to the buffer, then this is an indication that the entry hasn’t already been used within the buffer zone, but it may or may not have been used before the buffering started. If the <a id="wrglossary.7491"></a><a href="#glo:dual.firstuseflag">first use flag</a> indicates that the entry hasn’t been used, the entry’s label will be added to the <span class="qt">“not used”</span> list. The reference will behave like <a id="wrglossary.7492"></a><a href="#glo:dual.firstuse">first use</a>, but the unset won’t be performed afterwards (because buffering is in progress).
+</ol>
+<p>
+<li><span class="numitem">2.</span>The entries that are in the <span class="qt">“not used”</span> list can be locally reset and both the buffer and the <span class="qt">“not used”</span> list can be cleared with <a id="wrglossary.7493"></a><a href="#glo:GlsXtrClearUnsetBuffer"><code class="csfmt">\GlsXtrClearUnsetBuffer</code></a>.
+</ol>
+ Note that this approach can’t be used for situations where the change in conditional causes a problem, but it can be used in situations where the content of an environment or command is repeatedly processed, which upsets the <a id="wrglossary.7494"></a><a href="#glo:dual.firstuseflag">first use flag</a>.<p>
+For example, consider the following <a id="wrglossary.7495"></a><a href="#glo:cls.beamer"><span class="clsfmt">beamer</span></a> document: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{beamer}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+<a id="wrglossary.7496"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{svm}{SVM}{support vector machine}
+<a id="wrglossary.7497"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{html}{HTML}{hypertext markup language}
+<code class="cbeg">\begin{document}</code>
+<code class="cbeg">\begin{frame}</code>
+ <code class="cmd">\frametitle</code>{Frame 1}
+ <code class="cbeg">\begin{itemize}</code>
+ <code class="cmd">\item</code> <a id="wrglossary.7498"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html} and <a id="wrglossary.7499"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}
+ <code class="cend">\end{itemize}</code>
+<code class="cend">\end{frame}</code>
+<code class="cbeg">\begin{frame}</code>
+ <code class="cmd">\frametitle</code>{Frame 2}
+ <code class="cbeg">\begin{itemize}</code>
+ <code class="cmd">\item</code>&lt;+-&gt; <a id="wrglossary.7500"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{svm} and <a id="wrglossary.7501"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{svm}
+ <code class="cmd">\item</code>&lt;+-&gt; <a id="wrglossary.7502"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{svm} and <a id="wrglossary.7503"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}
+ <code class="cend">\end{itemize}</code>
+<code class="cend">\end{frame}</code>
+<code class="cmd">\frame</code>{<a id="wrglossary.7504"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>}
+<code class="cend">\end{document}</code>
+</pre> The first page isn’t a problem as the frame doesn’t have overlays. The first reference of the <span class="qt">“html”</span> entry shows the full form and the next shows just the short form. The second page (which is the first of the overlays of the second frame) correctly shows the full form of the <span class="qt">“svm”</span> entry for the first reference and the short form for the second reference, but on the third page (the second of the overlays) now has all instances of <span class="qt">“svm”</span> showing as <a id="wrglossary.7505"></a><a href="#glo:dual.subsequentuse">subsequent use</a> (just the short form).<p>
+I could put <a id="wrglossary.7506"></a><a href="#glo:glslocalresetall"><code class="csfmt">\glslocalresetall</code></a> at the start of the frame, but that would reset the <span class="qt">“html”</span> entry as well. Another workaround is to locally reset the first <span class="qt">“svm”</span> entry with <a id="wrglossary.7507"></a><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a>local, but that defeats the point of the <a id="wrglossary.7508"></a><a href="#glo:dual.firstuseflag">first use flag</a>, which is intended to keep track of whether or not you have used an entry so that you don’t have to.<p>
+The frame can be placed inside a buffering zone: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.7509"></a><a href="#glo:GlsXtrStartUnsetBuffering"><code class="csfmt">\GlsXtrStartUnsetBuffering</code></a>
+<code class="cbeg">\begin{frame}</code>
+ <code class="cmd">\frametitle</code>{Frame 2}
+ <code class="cbeg">\begin{itemize}</code>
+ <code class="cmd">\item</code>&lt;+-&gt; <a id="wrglossary.7510"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{svm} and <a id="wrglossary.7511"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{svm}
+ <code class="cmd">\item</code>&lt;+-&gt; <a id="wrglossary.7512"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{svm} and <a id="wrglossary.7513"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}
+ <code class="cend">\end{itemize}</code>
+<code class="cend">\end{frame}</code>
+<a id="wrglossary.7514"></a><a href="#glo:GlsXtrStopUnsetBuffering"><code class="csfmt">\GlsXtrStopUnsetBuffering</code></a>
+</pre> This ensures that the <a id="wrglossary.7515"></a><a href="#glo:dual.firstuseflag">first use flag</a> isn’t reset until after the frame, but it means that all references to the <span class="qt">“svm”</span> entry on both the second and third page show the full form.<p>
+The <span class="qt">“repeat local”</span> function can be used so that repeated references for the same entry can be locally unset before use. This can be enabled with <a id="wrglossary.7516"></a><a href="#glo:GlsXtrUnsetBufferEnableRepeatLocal"><code class="csfmt">\GlsXtrUnsetBufferEnableRepeatLocal</code></a> which fixes the second page, but not the third page, which shows all references to <span class="qt">“svm”</span> as the short form. What’s needed is to locally reset and entries that are in the frame but haven’t yet been used (<span class="qt">“svm”</span>, in this case) at the start of the frame with <a id="wrglossary.7517"></a><a href="#glo:GlsXtrResetLocalBuffer"><code class="csfmt">\GlsXtrResetLocalBuffer</code></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.7518"></a><a href="#glo:GlsXtrStartUnsetBuffering"><code class="csfmt">\GlsXtrStartUnsetBuffering</code></a>
+<a id="wrglossary.7519"></a><a href="#glo:GlsXtrUnsetBufferEnableRepeatLocal"><code class="csfmt">\GlsXtrUnsetBufferEnableRepeatLocal</code></a>
+<code class="cbeg">\begin{frame}</code>
+<a id="wrglossary.7520"></a><a href="#glo:GlsXtrResetLocalBuffer"><code class="csfmt">\GlsXtrResetLocalBuffer</code></a>
+ <code class="cmd">\frametitle</code>{Frame 2}
+ <code class="cbeg">\begin{itemize}</code>
+ <code class="cmd">\item</code>&lt;+-&gt; <a id="wrglossary.7521"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{svm} and <a id="wrglossary.7522"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{svm}
+ <code class="cmd">\item</code>&lt;+-&gt; <a id="wrglossary.7523"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{svm} and <a id="wrglossary.7524"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}
+ <code class="cend">\end{itemize}</code>
+<code class="cend">\end{frame}</code>
+<a id="wrglossary.7525"></a><a href="#glo:GlsXtrStopUnsetBuffering"><code class="csfmt">\GlsXtrStopUnsetBuffering</code></a>
+</pre> Note that on the first overlay, the buffer and <span class="qt">“not used”</span> list are both empty. On the second overlay, the buffer contains the <span class="qt">“svm”</span> and <span class="qt">“html”</span> labels and the <span class="qt">“not used”</span> list just contains the <span class="qt">“svm”</span> label. The reset performed by <a id="wrglossary.7526"></a><a href="#glo:GlsXtrResetLocalBuffer"><code class="csfmt">\GlsXtrResetLocalBuffer</code></a> will reset <span class="qt">“svm”</span> and then clear both the buffer and the <span class="qt">“not used”</span> list. This means that the first <span class="qt">“svm”</span> reference is once again considered <a id="wrglossary.7527"></a><a href="#glo:dual.firstuse">first use</a> and it will once again be added to the <span class="qt">“not used”</span> list (so that it would be reset again if there was a third overlay). <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:unsetbeamer"></a>Example 115: Abbreviations with <span class="clsfmt">beamer</span> (unset buffering) <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example115.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example115.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example115-page1.png" type="image/png" width="363" height="272">Page 1. An example document that uses beamer with buffering.</object><object data="glossaries-extra-manual-examples/glossaries-extra-manual-example115-page2.png" type="image/png" width="363" height="272">Page 2. An example document that uses beamer with buffering.</object><object data="glossaries-extra-manual-examples/glossaries-extra-manual-example115-page3.png" type="image/png" width="363" height="272">Page 3. An example document that uses beamer with buffering.</object><object data="glossaries-extra-manual-examples/glossaries-extra-manual-example115-page4.png" type="image/png" width="363" height="272">Page 4. An example document that uses beamer with buffering.</object> </div><!-- end of resultbox -->
+ This is quite cumbersome, but these commands could potentially be added to hooks at the start and end of problematic environments (but the buffering needs to be started and ended outside of the repeated content).<p>
+The following example uses <a id="wrglossary.7528"></a><a href="#glo:mbox"><code class="csfmt">\mbox</code></a> to protect <a id="wrglossary.7529"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> within the buffer zone: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+
+<code class="cmd">\usepackage</code>[T1]{fontenc}
+<code class="cmd">\usepackage</code>{soul}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+
+<a id="wrglossary.7530"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{html}{HTML}{hypertext markup language}
+
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.7531"></a><a href="#glo:GlsXtrStartUnsetBuffering"><code class="csfmt">\GlsXtrStartUnsetBuffering</code></a>
+<a id="wrglossary.7532"></a><a href="#glo:ul"><code class="csfmt">\ul</code></a>{Some text about <a id="wrglossary.7533"></a><a href="#glo:mbox"><code class="csfmt">\mbox</code></a>{<a id="wrglossary.7534"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}}.
+Next use: <a id="wrglossary.7535"></a><a href="#glo:mbox"><code class="csfmt">\mbox</code></a>{<a id="wrglossary.7536"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}}.}
+<a id="wrglossary.7537"></a><a href="#glo:GlsXtrStopUnsetBuffering"><code class="csfmt">\GlsXtrStopUnsetBuffering</code></a>
+
+Next use: <a id="wrglossary.7538"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+<code class="cend">\end{document}</code>
+</pre> This produces: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:bufferingmbox"></a>Example 116: Buffering first use unsets with <code class="cmd">\mbox</code> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example116.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example116.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example116.png" type="image/png" width="468" height="25">Example document that uses buffering to defer unsetting the first use flag unset in problematic contexts. The use of box creates an overly long line.</object> </div><!-- end of resultbox -->
+ Note that the use of <a id="wrglossary.7539"></a><a href="#glo:mbox"><code class="csfmt">\mbox</code></a> prevents line-breaking and the second instance of <code class="code"><a id="wrglossary.7540"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}</code> is treated as <a id="wrglossary.7541"></a><a href="#glo:dual.firstuse">first use</a>. <p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+Note that since the change in the <a id="wrglossary.7542"></a><a href="#glo:dual.firstuseflag">first use flag</a> now doesn’t occur until <a id="wrglossary.7543"></a><a href="#glo:GlsXtrStopUnsetBuffering"><code class="csfmt">\GlsXtrStopUnsetBuffering</code></a>, multiple references of the same term within the buffering zone will always be treated as <a id="wrglossary.7544"></a><a href="#glo:dual.firstuse">first use</a> (if the term wasn’t used before the buffering started). </div><!-- end of warning -->
+<p>
+Other alternatives include using <a id="wrglossary.7545"></a><a href="#glo:protect"><code class="csfmt">\protect</code></a> and inner formatting (see §<a href="#sec:innertextformat">5.5.3</a> for limitations) or middle formatting (see §<a href="#sec:middleformat">5.5.2</a>) with <a id="wrglossary.7546"></a><a href="#glo:GlsXtrExpandedFmt"><code class="csfmt">\GlsXtrExpandedFmt</code></a> (which can’t be used with fragile <a id="wrglossary.7547"></a><a href="#glo:dual.linktext">link text</a>). Both approaches are demonstrated in the following example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+
+<code class="cmd">\usepackage</code>[T1]{fontenc}
+<code class="cmd">\usepackage</code>{soul}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+
+<a id="wrglossary.7548"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{html}{HTML}{hypertext markup language}
+<span class="comment">% custom command to expand content before using <a id="wrglossary.7549"></a><a href="#glo:ul"><code class="csfmt">\ul</code></a>:</span>
+<code class="cmd">\newrobustcmd</code>{<code class="cmd">\xpul</code>}[1]{<a id="wrglossary.7550"></a><a href="#glo:GlsXtrExpandedFmt"><code class="csfmt">\GlsXtrExpandedFmt</code></a>{<a id="wrglossary.7551"></a><a href="#glo:ul"><code class="csfmt">\ul</code></a>}{#1}}
+
+<code class="cbeg">\begin{document}</code>
+First approach (inner formatting):
+{% scope
+ <code class="cmd">\renewcommand</code>{<a id="wrglossary.7552"></a><a href="#glo:glsxtrdefaultentrytextfmt"><code class="csfmt">\glsxtrdefaultentrytextfmt</code></a>}[1]{<a id="wrglossary.7553"></a><a href="#glo:ul"><code class="csfmt">\ul</code></a>{#1}}%
+ <a id="wrglossary.7554"></a><a href="#glo:ul"><code class="csfmt">\ul</code></a>{Some text about <a id="wrglossary.7555"></a><a href="#glo:protect"><code class="csfmt">\protect</code></a><a id="wrglossary.7556"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+ Next use: <a id="wrglossary.7557"></a><a href="#glo:protect"><code class="csfmt">\protect</code></a><a id="wrglossary.7558"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}}
+}
+
+Next use: <a id="wrglossary.7559"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+
+Second approach (middle formatting with expanded link text):
+<a id="wrglossary.7560"></a><a href="#glo:glsresetall"><code class="csfmt">\glsresetall</code></a>
+{% scope
+ <code class="cmd">\renewcommand</code>{<a id="wrglossary.7561"></a><a href="#glo:glsxtrabbreviationfont"><code class="csfmt">\glsxtrabbreviationfont</code></a>}[1]{<code class="cmd">\xpul</code>{#1}}%
+ <code class="cmd">\renewcommand</code>{<a id="wrglossary.7562"></a><a href="#glo:glsxtrregularfont"><code class="csfmt">\glsxtrregularfont</code></a>}[1]{<code class="cmd">\xpul</code>{#1}}%
+ <a id="wrglossary.7563"></a><a href="#glo:ul"><code class="csfmt">\ul</code></a>{Some text about <a id="wrglossary.7564"></a><a href="#glo:protect"><code class="csfmt">\protect</code></a><a id="wrglossary.7565"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+ Next use: <a id="wrglossary.7566"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.}
+}
+
+Next use: <a id="wrglossary.7567"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+<code class="cend">\end{document}</code>
+</pre> This produces: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:protectinnertextformat"></a>Example 117: Alternatives to buffering <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example117.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example117.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example117.png" type="image/png" width="390" height="83">Example document illustrating inner and middle formatting alternatives to unset buffering where entries are referenced within sensitive formatting commands.</object> </div><!-- end of resultbox -->
+<p>
+The change in the <a id="wrglossary.7568"></a><a href="#glo:dual.firstuseflag">first use flag</a> isn’t the only content within the <a id="wrglossary.7569"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands that can cause a problem. The <a id="wrglossary.7570"></a><a href="#glo:dual.whatsit">whatsit</a> caused by <a id="wrglossary.7571"></a><a href="#glo:dual.indexing">indexing</a> can also be problematic. Buffering can also be used to help with that situation. Indexing can be switched off at the start of the buffering and <a id="wrglossary.7572"></a><a href="#glo:GlsXtrForUnsetBufferedList"><code class="csfmt">\GlsXtrForUnsetBufferedList</code></a> can be used to perform the indexing outside of the problematic content. Note that this can cause a problem if the <a id="wrglossary.7573"></a><a href="#glo:@@glslabel@entrylocation">location</a> changes (for example, if a page break occurs within the buffering zone).<p>
+Buffering can also be used to simply gather the labels that have been referenced with a <a id="wrglossary.7574"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> command in order to, for example, display a <a id="wrglossary.7575"></a><a href="#glo:idx.mini-glossary">mini-glossary</a> at the end of the block. See for example, <a href="https://www.dickimaw-books.com/gallery/index.php?label=minigloss">Gallery: Mini-Glossary</a>.<p>
+
+</section><!-- end of section sec:unsetbuffer -->
+
+<section id="sec:getfields"><!-- start of section sec:getfields --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->5.11. Accessing Fields<div class="labellink"><a href="#sec:getfields">[link]</a></div></h2><!-- end of section header -->
+<p>
+See §<a href="#sec:setfields">3.5</a> for setting fields after an entry has been defined, §<a href="#sec:csvfields">5.13</a> for fields that contain comma-separated lists or whose values may be contained within comma-separated lists, §<a href="#sec:getsee">5.9.2</a> for cross-referencing fields (<a id="wrglossary.7576"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a>, <a id="wrglossary.7577"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> and <a id="wrglossary.7578"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a>), and §<a href="#sec:fieldconditionals">5.15</a> for testing field values. See also the base <a id="wrglossary.7579"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s commands, such as <a id="wrglossary.7580"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a> and <a id="wrglossary.7581"></a><a href="#glo:glsletentryfield"><code class="csfmt">\glsletentryfield</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7582"></a><code class="code"><dfn id="glo:glsxtrusefield"><code class="csfmt">\glsxtrusefield</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This expands to the value of the <a id="wrglossary.7583"></a><a href="#glo:dual.field">field</a> (identified by its <a id="wrglossary.7584"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a> <span class="meta">〈<em class="metainner">field-label</em>〉</span>) for the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. Expands to <a id="wrglossary.7585"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a> if the <a id="wrglossary.7586"></a><a href="#glo:dual.field">field</a> or entry are undefined.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7587"></a><code class="code"><dfn id="glo:Glsxtrusefield"><code class="csfmt">\Glsxtrusefield</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.7588"></a><a href="#glo:glsxtrusefield"><code class="csfmt">\glsxtrusefield</code></a> but converts the first character to <a id="wrglossary.7589"></a><a href="#glo:idx.uppercase">uppercase</a> using <a id="wrglossary.7590"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> (provided by <a id="wrglossary.7591"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>) which is robust. If <a id="wrglossary.7592"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> is loaded, <code class="code"><a id="wrglossary.7593"></a><a href="#glo:Glsxtrusefield"><code class="csfmt">\Glsxtrusefield</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code> will use the expandable: <pre class="compactcodebox"><a id="wrglossary.7594"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.7595"></a><a href="#glo:glsxtrusefield"><code class="csfmt">\glsxtrusefield</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}}
+</pre> in a PDF bookmark.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7596"></a><code class="code"><dfn id="glo:GLSxtrusefield"><code class="csfmt">\GLSxtrusefield</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.7597"></a><a href="#glo:glsxtrusefield"><code class="csfmt">\glsxtrusefield</code></a> but converts the field value to <a id="wrglossary.7598"></a><a href="#glo:idx.uppercase">uppercase</a>. See §<a href="#sec:uppercase">5.2.3</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7599"></a><code class="code"><dfn id="glo:glsxtrfieldtitlecase"><code class="csfmt">\glsxtrfieldtitlecase</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.7600"></a><a href="#glo:glsxtrusefield"><code class="csfmt">\glsxtrusefield</code></a> but converts the field value to <a id="wrglossary.7601"></a><a href="#glo:idx.titlecase">title case</a>. This internally uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7602"></a><code class="code"><dfn id="glo:glsxtrfieldtitlecasecs"><code class="csfmt">\glsxtrfieldtitlecasecs</code></dfn>{<span class="meta">〈<em class="metainner">content</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This converts <span class="meta">〈<em class="metainner">content</em>〉</span> to <a id="wrglossary.7603"></a><a href="#glo:idx.titlecase">title case</a> (expanding the first token once). If <a id="wrglossary.7604"></a><a href="#glo:glscapitalisewords"><code class="csfmt">\glscapitalisewords</code></a> has been defined, that will be used, otherwise <a id="wrglossary.7605"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a> will be used.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7606"></a><code class="code"><dfn id="glo:glsxtrentryparentname"><code class="csfmt">\glsxtrentryparentname</code></dfn>{<span class="meta">〈<em class="metainner">entry-name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Expands to the entry’s parent <a id="wrglossary.7607"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> if defined. Expands to nothing if the entry doesn’t have a parent or if the entry isn’t defined. If you simply require the parent label then use <a id="wrglossary.7608"></a><a href="#glo:glsentryparent"><code class="csfmt">\glsentryparent</code></a> or, to first test if the entry has a parent, either use <a id="wrglossary.7609"></a><a href="#glo:ifglshasparent"><code class="csfmt">\ifglshasparent</code></a> or use <a id="wrglossary.7610"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a> with the field label set to <code class="code">parent</code>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7611"></a><code class="code"><dfn id="glo:glsxtrhiername"><code class="csfmt">\glsxtrhiername</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Displays the hierarchical name for the given entry. The cross-reference format <a id="wrglossary.7612"></a><a href="#glo:glsseeitemformat"><code class="csfmt">\glsseeitemformat</code></a> may be redefined to use this command to show the hierarchy, if required. <p>
+This command has a recursive definition. If the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> has a parent, then this command will do <code class="code"><a id="wrglossary.7613"></a><a href="#glo:glsxtrhiername"><code class="csfmt">\glsxtrhiername</code></a>{<span class="meta">〈<em class="metainner">parent-label</em>〉</span>}</code> for the entry’s parent and will then do the separator <a id="wrglossary.7614"></a><a href="#glo:glsxtrhiernamesep"><code class="csfmt">\glsxtrhiernamesep</code></a>.<p>
+Then, regardless of whether or not the entry has a parent, it will do <code class="code"><a id="wrglossary.7615"></a><a href="#glo:glsfmttext"><code class="csfmt">\glsfmttext</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>, if the entry is an abbreviation (see §<a href="#sec:examplediffsabbrv">1.2.4</a>), or <code class="code"><a id="wrglossary.7616"></a><a href="#glo:glsfmtname"><code class="csfmt">\glsfmtname</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code> otherwise. <p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+If <a id="wrglossary.7617"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> is loaded, <a id="wrglossary.7618"></a><a href="#glo:glsxtrhiername"><code class="csfmt">\glsxtrhiername</code></a> will behave as <a id="wrglossary.7619"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a> in a PDF bookmark. </div><!-- end of information -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7620"></a><code class="code"><dfn id="glo:glsxtrhiernamesep"><code class="csfmt">\glsxtrhiernamesep</code></dfn></code></div><!-- end of pinnedbox -->
+ Separator symbol ( ◁ ) used between each name in commands like <a id="wrglossary.7621"></a><a href="#glo:glsxtrhiername"><code class="csfmt">\glsxtrhiername</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7622"></a><code class="code"><dfn id="glo:Glsxtrhiername"><code class="csfmt">\Glsxtrhiername</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.7623"></a><a href="#glo:glsxtrhiername"><code class="csfmt">\glsxtrhiername</code></a> but the first name in the list has its first character converted to <a id="wrglossary.7624"></a><a href="#glo:idx.uppercase">uppercase</a> using <a id="wrglossary.7625"></a><a href="#glo:Glsfmttext"><code class="csfmt">\Glsfmttext</code></a> or <a id="wrglossary.7626"></a><a href="#glo:Glsfmtname"><code class="csfmt">\Glsfmtname</code></a> (<a id="wrglossary.7627"></a><a href="#glo:idx.sentencecase">sentence case</a>). If <a id="wrglossary.7628"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> is loaded, <a id="wrglossary.7629"></a><a href="#glo:Glsxtrhiername"><code class="csfmt">\Glsxtrhiername</code></a> will expand to: <pre class="compactcodebox"><a id="wrglossary.7630"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.7631"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}}
+</pre> in a PDF bookmark. The <a id="wrglossary.7632"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> mapping from <a id="wrglossary.7633"></a><a href="#glo:glsxtrhiername"><code class="csfmt">\glsxtrhiername</code></a> to <a id="wrglossary.7634"></a><a href="#glo:Glsxtrhiername"><code class="csfmt">\Glsxtrhiername</code></a> is set with <a id="wrglossary.7635"></a><a href="#glo:glsmfuaddmap"><code class="csfmt">\glsmfuaddmap</code></a>, if supported.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7636"></a><code class="code"><dfn id="glo:GlsXtrhiername"><code class="csfmt">\GlsXtrhiername</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.7637"></a><a href="#glo:glsxtrhiername"><code class="csfmt">\glsxtrhiername</code></a> but each name in the list has its first character converted to <a id="wrglossary.7638"></a><a href="#glo:idx.uppercase">uppercase</a> using <a id="wrglossary.7639"></a><a href="#glo:Glsfmttext"><code class="csfmt">\Glsfmttext</code></a> or <a id="wrglossary.7640"></a><a href="#glo:Glsfmtname"><code class="csfmt">\Glsfmtname</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7641"></a><code class="code"><dfn id="glo:GLSxtrhiername"><code class="csfmt">\GLSxtrhiername</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.7642"></a><a href="#glo:glsxtrhiername"><code class="csfmt">\glsxtrhiername</code></a> but the first name in the list is converted to <a id="wrglossary.7643"></a><a href="#glo:idx.uppercase">uppercase</a> using <a id="wrglossary.7644"></a><a href="#glo:GLSfmttext"><code class="csfmt">\GLSfmttext</code></a> or <a id="wrglossary.7645"></a><a href="#glo:GLSfmtname"><code class="csfmt">\GLSfmtname</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7646"></a><code class="code"><dfn id="glo:GLSXTRhiername"><code class="csfmt">\GLSXTRhiername</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.7647"></a><a href="#glo:glsxtrhiername"><code class="csfmt">\glsxtrhiername</code></a> but each name in the list is converted to <a id="wrglossary.7648"></a><a href="#glo:idx.uppercase">uppercase</a> using <a id="wrglossary.7649"></a><a href="#glo:GLSfmttext"><code class="csfmt">\GLSfmttext</code></a> or <a id="wrglossary.7650"></a><a href="#glo:GLSfmtname"><code class="csfmt">\GLSfmtname</code></a> (<a id="wrglossary.7651"></a><a href="#glo:idx.allcaps">all caps</a>).<p>
+
+</section><!-- end of section sec:getfields -->
+
+<section id="section.5.12"><!-- start of section section.5.12 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->5.12. Encapsulation (Formatting) Based on Field Values<div class="labellink"><a href="#section.5.12">[link]</a></div></h2><!-- end of section header -->
+<p>
+These commands assume that a given entry has a special purpose field that’s used to store information on how to format text.<p>
+
+</section><!-- end of section section.5.12 -->
+
+<section id="sec:foreignfield"><!-- start of section sec:foreignfield --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->5.12.1. Foreign Language Field<div class="labellink"><a href="#sec:foreignfield">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7652"></a><code class="code"><dfn id="glo:GlsXtrForeignTextField"><code class="csfmt">\GlsXtrForeignTextField</code></dfn></code></div><!-- end of pinnedbox -->
+ This command should expand to the <a id="wrglossary.7653"></a><a href="#glo:dual.internalfieldlabel">internal field label</a> used to store a language tag (such as <code class="code">en-GB</code> or <code class="code">de-CH-1996</code>). The default value is <code class="code">userii</code> (which corresponds to the <a id="wrglossary.7654"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a> key).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7655"></a><code class="code"><dfn id="glo:GlsXtrForeignText"><code class="csfmt">\GlsXtrForeignText</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> has the field identified by <a id="wrglossary.7656"></a><a href="#glo:GlsXtrForeignTextField"><code class="csfmt">\GlsXtrForeignTextField</code></a> set, then this command will encapsulate <span class="meta">〈<em class="metainner">text</em>〉</span> according to the language tag stored in that field.<p>
+This uses <a id="wrglossary.7657"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span>’s</a> interface to determine the language label that corresponds to the language tag. If the language label can be determined, the <span class="meta">〈<em class="metainner">text</em>〉</span> will be encapsulated with <a id="wrglossary.7658"></a><a href="#glo:foreignlanguage"><code class="csfmt">\foreignlanguage</code></a> otherwise just <span class="meta">〈<em class="metainner">text</em>〉</span> is done.<p>
+If <a id="wrglossary.7659"></a><a href="#glo:foreignlanguage"><code class="csfmt">\foreignlanguage</code></a> isn’t defined (that is, there’s no language support for the document), this command simply does <span class="meta">〈<em class="metainner">text</em>〉</span>. If an old version of <a id="wrglossary.7660"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> is used, this command issues a warning and just does <span class="meta">〈<em class="metainner">text</em>〉</span>.<p>
+If <a id="wrglossary.7661"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> can’t determine the corresponding language label to use with <a id="wrglossary.7662"></a><a href="#glo:foreignlanguage"><code class="csfmt">\foreignlanguage</code></a>, then a warning is issued with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7663"></a><code class="code"><dfn id="glo:GlsXtrUnknownDialectWarning"><code class="csfmt">\GlsXtrUnknownDialectWarning</code></dfn>{<span class="meta">〈<em class="metainner">locale</em>〉</span>}{<span class="meta">〈<em class="metainner">root language</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">locale</em>〉</span> is the language tag supplied in the given field value and <span class="meta">〈<em class="metainner">root language</em>〉</span> is the root language that <a id="wrglossary.7664"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> has inferred from the tag.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+<a id="wrglossary.7665"></a><a href="#glo:GlsXtrForeignText"><code class="csfmt">\GlsXtrForeignText</code></a> requires <a id="wrglossary.7666"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> v1.3.6+. </div><!-- end of information -->
+<p>
+For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[main=british,brazilian,ngerman]{babel}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+<a id="wrglossary.7667"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.7668"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a>}
+<a id="wrglossary.7669"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>
+ [<a id="wrglossary.7670"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={Associação Brasileria de Normas Técnicas}</span>,
+ <a id="wrglossary.7671"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a><span class="optfmt">={pt-BR}</span>
+ ]
+ {abnt}{ABNT}{Brazilian National Standards Organization}
+
+<a id="wrglossary.7672"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>
+ [<a id="wrglossary.7673"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={Deutsches Institut für Normung e.V.}</span>,
+ <a id="wrglossary.7674"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a><span class="optfmt">={de-DE-1996}</span>]
+ {din}{DIN}{German Institute for Standardization}
+
+<a id="wrglossary.7675"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{tug}{TUG}{<code class="cmd">\TeX</code><code class="cmd">\ </code>User Group}
+
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.7676"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a>}[2]{%
+ <a id="wrglossary.7677"></a><a href="#glo:glsxtrfullsep"><code class="csfmt">\glsxtrfullsep</code></a>{#2}%
+ <a id="wrglossary.7678"></a><a href="#glo:glsxtrparen"><code class="csfmt">\glsxtrparen</code></a>
+ {#1%
+ <a id="wrglossary.7679"></a><a href="#glo:ifglshasfield"><code class="csfmt">\ifglshasfield</code></a>{<a id="wrglossary.7680"></a><a href="#glo:glsxtruserfield"><code class="csfmt">\glsxtruserfield</code></a>}{#2}%
+ {, <code class="cmd">\emph</code>{<a id="wrglossary.7681"></a><a href="#glo:GlsXtrForeignText"><code class="csfmt">\GlsXtrForeignText</code></a>{#2}{<a id="wrglossary.7682"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a>}}}%
+ {}%
+ }%
+}
+
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.7683"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{abnt}, <a id="wrglossary.7684"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{din}, <a id="wrglossary.7685"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{tug}.
+<a id="wrglossary.7686"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> This produces: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:foreignlangfmt"></a>Example 118: Foreign language field encapsulation <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example118.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example118.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example118.png" type="image/png" width="389" height="167">Example document illustrating fields containing different languages that need encapsulating with the relevant language command.</object> </div><!-- end of resultbox -->
+<p>
+
+</section><!-- end of section sec:foreignfield -->
+
+<section id="sec:glsxtrfmt"><!-- start of section sec:glsxtrfmt --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->5.12.2. Associated Entry Format<div class="labellink"><a href="#sec:glsxtrfmt">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+An entry may have a particular formatting style associated with it (rather than a more general category-wide format). This needs to be provided by a text-block command that takes a single argument. The name (without the leading backslash) should be stored in the field identified by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7687"></a><code class="code"><dfn id="glo:GlsXtrFmtField"><code class="csfmt">\GlsXtrFmtField</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>useri</span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This command should expand to the <a id="wrglossary.7688"></a><a href="#glo:dual.internalfieldlabel">internal field label</a> used to store the formatting command’s control sequence name. The default value is <code class="code">useri</code> (which corresponds to the <a id="wrglossary.7689"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7690"></a><code class="code"><dfn id="glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command behaves like: <pre class="compactcodebox"><a id="wrglossary.7691"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-link-text</em>〉</span>}
+</pre> where the <a id="wrglossary.7692"></a><a href="#glo:dual.linktext">link text</a> <span class="meta">〈<em class="metainner">fmt-link-text</em>〉</span> is formatted according to: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7693"></a><code class="code"><dfn id="glo:glsxtrfmtdisplay"><code class="csfmt">\glsxtrfmtdisplay</code></dfn>{<span class="meta">〈<em class="metainner">csname</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The default definition simply does <code class="code"><span class="cmdfmt">\<span class="meta">〈<em class="metainner">csname</em>〉</span></span>{<span class="meta">〈<em class="metainner">text</em>〉</span>}<span class="meta">〈<em class="metainner">insert</em>〉</span></code> where the control sequence name <span class="meta">〈<em class="metainner">csname</em>〉</span> is obtained from the field given by <a id="wrglossary.7694"></a><a href="#glo:GlsXtrFmtField"><code class="csfmt">\GlsXtrFmtField</code></a>. If the field hasn’t been set, <a id="wrglossary.7695"></a><a href="#glo:@firstofone"><code class="csfmt">\@firstofone</code></a> is used (which simply does its argument). The unstarred version assumes an empty <span class="meta">〈<em class="metainner">insert</em>〉</span>. The default <a id="wrglossary.7696"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a> options are given by <a id="wrglossary.7697"></a><a href="#glo:GlsXtrFmtDefaultOptions"><code class="csfmt">\GlsXtrFmtDefaultOptions</code></a>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+The <a id="wrglossary.7698"></a><a href="#glo:dual.postlinkhook">post-link hook</a> is suppressed with <a id="wrglossary.7699"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a>. </div><!-- end of information -->
+<p>
+If you don’t want the complexity of <a id="wrglossary.7700"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a>, a partially expandable command is provided that may be used in section headings: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7701"></a><code class="code"><dfn id="glo:glsxtrentryfmt"><code class="csfmt">\glsxtrentryfmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If <a id="wrglossary.7702"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> has been loaded, this will expand to: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7703"></a><code class="code"><dfn id="glo:glsxtrpdfentryfmt"><code class="csfmt">\glsxtrpdfentryfmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ within the PDF bookmarks, which just does <span class="meta">〈<em class="metainner">text</em>〉</span>. Otherwise <a id="wrglossary.7704"></a><a href="#glo:glsxtrentryfmt"><code class="csfmt">\glsxtrentryfmt</code></a> will format <span class="meta">〈<em class="metainner">text</em>〉</span> according to the control sequence name identified in the field given by <a id="wrglossary.7705"></a><a href="#glo:GlsXtrFmtField"><code class="csfmt">\GlsXtrFmtField</code></a> (or <code class="code">@firstofone</code>, if not set). For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>[T1]{fontenc}
+<code class="cmd">\usepackage</code>{amsmath}
+<code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.7706"></a><a href="#glo:opt.postdot"><span class="styoptfmt">postdot</span></a>,<a id="wrglossary.7707"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.7708"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a></span>]{glossaries-extra}
+<a id="wrglossary.7709"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<code class="cmd">\newcommand</code>*{<code class="cmd">\mtx</code>}[1]{<code class="cmd">\boldsymbol</code>{#1}}
+<code class="cmd">\newcommand</code>*{<code class="cmd">\mtxinv</code>}[1]{<code class="cmd">\mtx</code>{#1}<code class="cmd">\sp</code>{-1}}
+
+<a id="wrglossary.7710"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{matrix}{%
+ <a id="wrglossary.7711"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={matrix}</span>,
+ <a id="wrglossary.7712"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\mtx</code>{M}}}</span>,
+ <a id="wrglossary.7713"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a><span class="optfmt">={matrices}</span>,
+ <a id="wrglossary.7714"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={mtx}</span>,<span class="comment">% corresponds to <code class="cmd">\mtx</code></span>
+ <a id="wrglossary.7715"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={rectangular array of values}</span>
+}
+
+<a id="wrglossary.7716"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{identitymatrix}{%
+ <a id="wrglossary.7717"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={identity matrix}</span>,
+ <a id="wrglossary.7718"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\mtx</code>{I}}}</span>,
+ <a id="wrglossary.7719"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a><span class="optfmt">={identity matrices}</span>,
+ <a id="wrglossary.7720"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a diagonal matrix with all diagonal elements equal to 1 and all other elements equal to 0}</span>
+}
+
+<a id="wrglossary.7721"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{matrixinv}{%
+ <a id="wrglossary.7722"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={matrix inverse}</span>,
+ <a id="wrglossary.7723"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\mtxinv</code>{M}}}</span>,
+ <a id="wrglossary.7724"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={mtxinv}</span>,<span class="comment">% corresponds to <code class="cmd">\mtxinv</code></span>
+ <a id="wrglossary.7725"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a square <a id="wrglossary.7726"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{matrix} such that $<code class="cmd">\mtx</code>{M}<code class="cmd">\mtxinv</code>{M}=<a id="wrglossary.7727"></a><a href="#glo:glssymbol"><code class="csfmt">\glssymbol</code></a>{identitymatrix}$}</span>
+}
+<code class="cbeg">\begin{document}</code>
+A <a id="wrglossary.7728"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{matrix} is denoted <a id="wrglossary.7729"></a><a href="#glo:glssymbol"><code class="csfmt">\glssymbol</code></a>{matrix}.
+The inverse is denoted <a id="wrglossary.7730"></a><a href="#glo:glssymbol"><code class="csfmt">\glssymbol</code></a>{matrixinv}.
+<code class="cmd">\[</code>
+ <a id="wrglossary.7731"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a>{matrix}{A} <a id="wrglossary.7732"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a>{matrixinv}{A}
+ = <a id="wrglossary.7733"></a><a href="#glo:glssymbol"><code class="csfmt">\glssymbol</code></a>{identitymatrix}
+<code class="cmd">\]</code>
+Compare $<a id="wrglossary.7734"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a>{matrix}{A}[_0]$
+with $<a id="wrglossary.7735"></a><a href="#glo:glsxtrfmt*"><code class="csfmt">\glsxtrfmt*</code></a>{matrix}{A}[_0]$.
+<code class="cmd">\printglossaries</code>
+<code class="cend">\end{document}</code>
+</pre> This produces: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:glsxtrfmt"></a>Example 119: Storing a formatting command in a field <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example119.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example119.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example119.png" type="image/png" width="389" height="187">Example document that uses a field to store the formatting command associated with the glossary entry.</object> </div><!-- end of resultbox -->
+ Note the difference between using <a id="wrglossary.7736"></a><a href="#glo:glsxtrfmt*"><code class="csfmt">\glsxtrfmt*</code></a> vs <a id="wrglossary.7737"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a>.<p>
+There are also <a id="wrglossary.7738"></a><a href="#glo:idx.sentencecase">sentence case</a> versions of the above commands: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7739"></a><code class="code"><dfn id="glo:Glsxtrfmt"><code class="csfmt">\Glsxtrfmt</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is simply a shortcut for: <pre class="compactcodebox"><a id="wrglossary.7740"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<a id="wrglossary.7741"></a><a href="#glo:glssentencecase"><code class="csfmt">\glssentencecase</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}}
+</pre> Similarly for the starred form: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7742"></a><code class="code"><dfn id="glo:Glsxtrfmt*"><code class="csfmt">\Glsxtrfmt*</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code></div><!-- end of pinnedbox -->
+ which is a shortcut for: <pre class="compactcodebox"><a id="wrglossary.7743"></a><a href="#glo:glsxtrfmt*"><code class="csfmt">\glsxtrfmt*</code></a>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<a id="wrglossary.7744"></a><a href="#glo:glssentencecase"><code class="csfmt">\glssentencecase</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7745"></a><code class="code"><dfn id="glo:Glsxtrentryfmt"><code class="csfmt">\Glsxtrentryfmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is a shortcut for <pre class="compactcodebox"><a id="wrglossary.7746"></a><a href="#glo:glsxtrentryfmt"><code class="csfmt">\glsxtrentryfmt</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<a id="wrglossary.7747"></a><a href="#glo:glssentencecase"><code class="csfmt">\glssentencecase</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}}
+</pre> but uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7748"></a><code class="code"><dfn id="glo:Glsxtrpdfentryfmt"><code class="csfmt">\Glsxtrpdfentryfmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ for the PDF bookmarks. This uses <a id="wrglossary.7749"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> to perform the case-change, which is expandable.<p>
+If you are writing <a id="wrglossary.7750"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a> or <a id="wrglossary.7751"></a><a href="#glo:glsxtrentryfmt"><code class="csfmt">\glsxtrentryfmt</code></a> explicitly in the document text, you can, of course, enter the appropriate case in <span class="meta">〈<em class="metainner">text</em>〉</span> directly. The purpose of providing the <a id="wrglossary.7752"></a><a href="#glo:idx.sentencecase">sentence case</a> commands is to enable a mapping to be setup with <a id="wrglossary.7753"></a><a href="#glo:MFUaddmap"><code class="csfmt">\MFUaddmap</code></a> in the event that <a id="wrglossary.7754"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a> or <a id="wrglossary.7755"></a><a href="#glo:glsxtrentryfmt"><code class="csfmt">\glsxtrentryfmt</code></a> occur at the start of content, such as another entry’s description, that will have <a id="wrglossary.7756"></a><a href="#glo:idx.sentencecase">sentence case</a> automatically applied. This will require <a id="wrglossary.7757"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+ to support the mapping. See the <a id="wrglossary.7758"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> manual for further details.<p>
+
+</section><!-- end of section sec:glsxtrfmt -->
+
+<section id="sec:csvfields"><!-- start of section sec:csvfields --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->5.13. Comma-Separated Lists<div class="labellink"><a href="#sec:csvfields">[link]</a></div></h2><!-- end of section header -->
+<p>
+These commands are for field values that are comma-separated lists (for example, the field has been constructed with <a id="wrglossary.7759"></a><a href="#glo:glsxtrapptocsvfield"><code class="csfmt">\glsxtrapptocsvfield</code></a>) or for testing if field values are contained within comma-separated lists.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+If you are using <a id="wrglossary.7760"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, you can sort field values that contain a comma-separated list of labels (such as the <a id="wrglossary.7761"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> or <a id="wrglossary.7762"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> field) with the <a id="wrglossary.7763"></a><a href="#glo:opt.resource.sort-label-list"><span class="csoptfmt">sort-label-list</span></a> option (provided <a id="wrglossary.7764"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can access those fields). See the <a id="wrglossary.7765"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> manual for further details. </div><!-- end of information -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7766"></a><code class="code"><dfn id="glo:glsseelist"><code class="csfmt">\glsseelist</code></dfn>{<span class="meta">〈<em class="metainner">csv-list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is provided by the base <a id="wrglossary.7767"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package to format the entry labels in <a id="wrglossary.7768"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> cross-reference list. (It’s used internally by <a id="wrglossary.7769"></a><a href="#glo:glsseeformat"><code class="csfmt">\glsseeformat</code></a>, which adds the <span style="font-style: italic; font-variant: normal; ">see</span> prefix.) It may also be used for any comma-separated list of entry labels. Note that the argument isn’t expanded. If expansion is required, use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7770"></a><code class="code"><dfn id="glo:glsxtrseelist"><code class="csfmt">\glsxtrseelist</code></dfn>{<span class="meta">〈<em class="metainner">csv-list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This fully expands its argument and passes the result to <a id="wrglossary.7771"></a><a href="#glo:glsseelist"><code class="csfmt">\glsseelist</code></a>. With just the base <a id="wrglossary.7772"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, each item is encapsulated with <a id="wrglossary.7773"></a><a href="#glo:glsseeitem"><code class="csfmt">\glsseeitem</code></a>. The <a id="wrglossary.7774"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package redefines <a id="wrglossary.7775"></a><a href="#glo:glsseelist"><code class="csfmt">\glsseelist</code></a> to make it more flexible and provides additional commands to further customize the formatting.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7776"></a><code class="code"><dfn id="glo:glsxtrtaggedlist"><code class="csfmt">\glsxtrtaggedlist</code></dfn>{<span class="meta">〈<em class="metainner">singular tag</em>〉</span>}{<span class="meta">〈<em class="metainner">plural tag</em>〉</span>}{<span class="meta">〈<em class="metainner">label prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">csv-list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is a similar command that has an initial tag inserted before the start of the list. If the list only contains one element, the <span class="meta">〈<em class="metainner">singular tag</em>〉</span> is used. If the list contains more than one element, the <span class="meta">〈<em class="metainner">plural tag</em>〉</span> is used. The separator between the tag and the list is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7777"></a><code class="code"><dfn id="glo:glsxtrtaggedlistsep"><code class="csfmt">\glsxtrtaggedlistsep</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\space</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ The separators between the elements of the list and the formatting of each list element is as for <a id="wrglossary.7778"></a><a href="#glo:glsseelist"><code class="csfmt">\glsseelist</code></a> (see below). If the list is empty, nothing is displayed. The <span class="meta">〈<em class="metainner">label prefix</em>〉</span> is inserted before the current item in the list to form the entry label.<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+Spaces in <span class="meta">〈<em class="metainner">csv-list</em>〉</span> are significant. Avoid unwanted leading or trailing spaces and empty labels. </div><!-- end of warning -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7779"></a><code class="code"><dfn id="glo:glsseeitemformat"><code class="csfmt">\glsseeitemformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The base <a id="wrglossary.7780"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package just uses <a id="wrglossary.7781"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a> or <a id="wrglossary.7782"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a> in this command. The <a id="wrglossary.7783"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package redefines this so that it does: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.7784"></a><a href="#glo:ifglshasshort"><code class="csfmt">\ifglshasshort</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<a id="wrglossary.7785"></a><a href="#glo:glsfmttext"><code class="csfmt">\glsfmttext</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}}
+{<a id="wrglossary.7786"></a><a href="#glo:glsfmtname"><code class="csfmt">\glsfmtname</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}}
+</pre> Note that the use of <a id="wrglossary.7787"></a><a href="#glo:glsfmttext"><code class="csfmt">\glsfmttext</code></a> rather than <a id="wrglossary.7788"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a> allows the abbreviation style to be used.<p>
+With <a id="wrglossary.7789"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, the first item in <a id="wrglossary.7790"></a><a href="#glo:glsseelist"><code class="csfmt">\glsseelist</code></a> will be encapsulated with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7791"></a><code class="code"><dfn id="glo:glsseefirstitem"><code class="csfmt">\glsseefirstitem</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The default definition is simply <code class="code"><a id="wrglossary.7792"></a><a href="#glo:glsseeitem"><code class="csfmt">\glsseeitem</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code> but can be redefined, for example to convert the first character to <a id="wrglossary.7793"></a><a href="#glo:idx.uppercase">uppercase</a> if <a id="wrglossary.7794"></a><a href="#glo:idx.sentencecase">sentence case</a> is required.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+If the label corresponds to a multi-entry, <a id="wrglossary.7795"></a><a href="#glo:mglsseefirstitem"><code class="csfmt">\mglsseefirstitem</code></a> will be used instead (see §<a href="#sec:msee">7.12</a>). Similarly, <a id="wrglossary.7796"></a><a href="#glo:mglsseeitem"><code class="csfmt">\mglsseeitem</code></a> will be used instead of <a id="wrglossary.7797"></a><a href="#glo:glsseeitem"><code class="csfmt">\glsseeitem</code></a> for a multi-entry label. </div><!-- end of information -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7798"></a><code class="code"><dfn id="glo:glsseesep"><code class="csfmt">\glsseesep</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>,␣</span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This is used between each entry in the list, except between the final pair.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7799"></a><code class="code"><dfn id="glo:glsseelastsep"><code class="csfmt">\glsseelastsep</code></dfn></code></div><!-- end of pinnedbox -->
+ This is used between the penultimate and final item in the list. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\space</code><a id="wrglossary.7800"></a><a href="#glo:andname"><code class="csfmt">\andname</code></a><code class="cmd">\space</code>
+</pre><p>
+With <a id="wrglossary.7801"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, if there are at least three elements in the list, the separator between the final two elements will be given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7802"></a><code class="code"><dfn id="glo:glsseelastoxfordsep"><code class="csfmt">\glsseelastoxfordsep</code></dfn></code></div><!-- end of pinnedbox -->
+ This just defaults to <a id="wrglossary.7803"></a><a href="#glo:glsseelastsep"><code class="csfmt">\glsseelastsep</code></a> but may be redefined to include a comma, if preferred.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7804"></a><code class="code"><dfn id="glo:glsxtrforcsvfield"><code class="csfmt">\glsxtrforcsvfield</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">handler cs</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This iterates over the comma-separated list stored in the given <a id="wrglossary.7805"></a><a href="#glo:dual.field">field</a> (identified by its <a id="wrglossary.7806"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a>) for the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> and performs <code class="code"><span class="meta">〈<em class="metainner">handler cs</em>〉</span>{<span class="meta">〈<em class="metainner">element</em>〉</span>}</code> for each element of the list. This command uses <a id="wrglossary.7807"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a> so the complete list can be obtained with <a id="wrglossary.7808"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a>. Does nothing if the field hasn’t been set or the entry hasn’t been defined. The unstarred version adds implicit grouping. The starred version doesn’t.<p>
+It’s possible to prematurely break the loop at the end of the current iteration with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7809"></a><code class="code"><dfn id="glo:glsxtrendfor"><code class="csfmt">\glsxtrendfor</code></dfn></code></div><!-- end of pinnedbox -->
+ If nested within another command that also uses <a id="wrglossary.7810"></a><a href="#glo:@for"><code class="csfmt">\@for</code></a>, use the unstarred version to localise the break. This command is simply set to <a id="wrglossary.7811"></a><a href="#glo:@endfortrue"><code class="csfmt">\@endfortrue</code></a>, which is provided by the <a id="wrglossary.7812"></a><a href="#glo:pkg.xfor"><span class="styfmt">xfor</span></a> package.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7813"></a><code class="code"><dfn id="glo:glsxtrfieldformatcsvlist"><code class="csfmt">\glsxtrfieldformatcsvlist</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This formats the comma-separated list stored in the given <a id="wrglossary.7814"></a><a href="#glo:dual.field">field</a> (identified by its <a id="wrglossary.7815"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a>) for the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> using <a id="wrglossary.7816"></a><a href="#glo:pkg.datatool-base"><span class="styfmt">datatool-base</span>’s</a> <a id="wrglossary.7817"></a><a href="#glo:DTLformatlist"><code class="csfmt">\DTLformatlist</code></a>. This command uses <a id="wrglossary.7818"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a> so the complete list can be obtained with <a id="wrglossary.7819"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a>. This adds implicit grouping. There is no starred version.<p>
+The following demonstrates the difference between <a id="wrglossary.7820"></a><a href="#glo:glsseelist"><code class="csfmt">\glsseelist</code></a> (which specifically requires a list of labels) and <a id="wrglossary.7821"></a><a href="#glo:glsxtrfieldformatcsvlist"><code class="csfmt">\glsxtrfieldformatcsvlist</code></a> (which formats an arbitrary list): <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.7822"></a><a href="#glo:opt.autoseeindex"><span class="styoptfmt">autoseeindex</span></a><span class="optfmt">=false</span>]{glossaries-extra}
+<a id="wrglossary.7823"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{example}{<a id="wrglossary.7824"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={example}</span>,<a id="wrglossary.7825"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,
+ <a id="wrglossary.7826"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={another1,another2}</span>}
+<a id="wrglossary.7827"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{another1}{<a id="wrglossary.7828"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={another one}</span>,<a id="wrglossary.7829"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.7830"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{another2}{<a id="wrglossary.7831"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={another two}</span>,<a id="wrglossary.7832"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.7833"></a><a href="#glo:glsxtrapptocsvfield"><code class="csfmt">\glsxtrapptocsvfield</code></a>{example}{animals}{duck}
+<a id="wrglossary.7834"></a><a href="#glo:glsxtrapptocsvfield"><code class="csfmt">\glsxtrapptocsvfield</code></a>{example}{animals}{albatross}
+<a id="wrglossary.7835"></a><a href="#glo:glsxtrapptocsvfield"><code class="csfmt">\glsxtrapptocsvfield</code></a>{example}{animals}{arara}
+Animal list: <a id="wrglossary.7836"></a><a href="#glo:glsxtrfieldformatcsvlist"><code class="csfmt">\glsxtrfieldformatcsvlist</code></a>{example}{animals}
+
+See list: <a id="wrglossary.7837"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a>{see}{example}
+ {<a id="wrglossary.7838"></a><a href="#glo:glsxtrseelist"><code class="csfmt">\glsxtrseelist</code></a>{<a id="wrglossary.7839"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a>}}{not set}.
+
+<a id="wrglossary.7840"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> There’s no <a id="wrglossary.7841"></a><a href="#glo:dual.indexing">indexing</a> in this document so I’ve used <a id="wrglossary.7842"></a><a href="#glo:opt.autoseeindex"><span class="styoptfmt">autoseeindex</span></a><span class="optfmt">=false</span> to avoid an error. This means there’s no cross-reference list in the glossary but, as demonstrated, the <span class="qt">“see”</span> list can be reproduced in the document. The result is: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:fieldformatcsv"></a>Example 120: Formatting lists contained in field values <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example120.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example120.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example120.png" type="image/png" width="206" height="149">Example document that uses two different methods of sorting fields that contain a comma-separated list.</object> </div><!-- end of resultbox -->
+ This first constructs a comma-separated list in a custom <a id="wrglossary.7843"></a><a href="#glo:dual.internalfield">internal field</a> with the label <code class="code">animals</code>. There’s no associated key that can be used in <a id="wrglossary.7844"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>. In this case, the <a id="wrglossary.7845"></a><a href="#glo:dual.field">field</a> could simply be set in one command. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.7846"></a><a href="#glo:glsxtrdeffield"><code class="csfmt">\glsxtrdeffield</code></a>{example}{animals}{duck,albatross,arara}
+</pre> The main reason for providing <a id="wrglossary.7847"></a><a href="#glo:glsxtrapptocsvfield"><code class="csfmt">\glsxtrapptocsvfield</code></a> is for the benefit of <a id="wrglossary.7848"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, as it sometimes has to construct a field value list while it’s writing the <a id="wrglossary.7849"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file, but there may be other uses in complex documents that construct field values through some custom function.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7850"></a><code class="code"><dfn id="glo:GlsXtrIfValueInFieldCsvList"><code class="csfmt">\GlsXtrIfValueInFieldCsvList</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This does <span class="meta">〈<em class="metainner">true</em>〉</span> if the comma-separated list stored in the given <a id="wrglossary.7851"></a><a href="#glo:dual.field">field</a> (identified by its <a id="wrglossary.7852"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a>) contains the given <span class="meta">〈<em class="metainner">value</em>〉</span> (using <a id="wrglossary.7853"></a><a href="#glo:DTLifinlist"><code class="csfmt">\DTLifinlist</code></a> provided by <a id="wrglossary.7854"></a><a href="#glo:pkg.datatool-base"><span class="styfmt">datatool-base</span></a>) or <span class="meta">〈<em class="metainner">false</em>〉</span> if the value isn’t in the list or if the field hasn’t been set or the entry hasn’t been defined. The unstarred version adds implicit grouping. The starred version doesn’t. <p>
+This command internally uses <a id="wrglossary.7855"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a>, so take care if it’s nested. Within <span class="meta">〈<em class="metainner">false</em>〉</span>, you can test if <a id="wrglossary.7856"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a> is empty or undefined. If it’s defined but not empty, then the field has been set but doesn’t contain <span class="meta">〈<em class="metainner">value</em>〉</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7857"></a><code class="code"><dfn id="glo:GlsXtrIfFieldValueInCsvList"><code class="csfmt">\GlsXtrIfFieldValueInCsvList</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">csv-list</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This command is essentially the other way around to the above. In this case, the comma-separated list is provided in the argument <span class="meta">〈<em class="metainner">csv-list</em>〉</span> and the search value is the field’s value. This does <span class="meta">〈<em class="metainner">true</em>〉</span> if the value is found in <span class="meta">〈<em class="metainner">csv-list</em>〉</span> or <span class="meta">〈<em class="metainner">false</em>〉</span> if the value isn’t in <span class="meta">〈<em class="metainner">csv-list</em>〉</span> or the field isn’t set or the entry hasn’t been defined. The unstarred version adds implicit grouping. The starred version doesn’t. Again, this command internally uses <a id="wrglossary.7858"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a>, so you can test <a id="wrglossary.7859"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a> in <span class="meta">〈<em class="metainner">false</em>〉</span> to determine whether or not the field has been set.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7860"></a><code class="code"><dfn id="glo:xGlsXtrIfValueInFieldCsvList"><code class="csfmt">\xGlsXtrIfValueInFieldCsvList</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.7861"></a><a href="#glo:GlsXtrIfValueInFieldCsvList"><code class="csfmt">\GlsXtrIfValueInFieldCsvList</code></a> but fully expands <span class="meta">〈<em class="metainner">value</em>〉</span> first.<p>
+
+</section><!-- end of section sec:csvfields -->
+
+<section id="sec:listfields"><!-- start of section sec:listfields --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->5.14. List Fields<div class="labellink"><a href="#sec:listfields">[link]</a></div></h2><!-- end of section header -->
+<p>
+Comma-separated list fields are covered in §<a href="#sec:csvfields">5.13</a>. The commands in this section are for fields that store <a id="wrglossary.7862"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span></a> internal lists. Elements can be appended to these fields using commands <a id="wrglossary.7863"></a><a href="#glo:glsxtrfieldlistadd"><code class="csfmt">\glsxtrfieldlistadd</code></a>, described in §<a href="#sec:setfields">3.5</a>. The commands listed below provide an easy interface to iterate over the field values. See the <a id="wrglossary.7864"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span></a> documentation for further details about internal lists.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7865"></a><code class="code"><dfn id="glo:glsxtrfieldformatlist"><code class="csfmt">\glsxtrfieldformatlist</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Formats the list using the same separators as used by <a id="wrglossary.7866"></a><a href="#glo:pkg.datatool"><span class="styfmt">datatool</span>’s</a> <a id="wrglossary.7867"></a><a href="#glo:DTLformatlist"><code class="csfmt">\DTLformatlist</code></a>. This internally uses <a id="wrglossary.7868"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <a id="wrglossary.7869"></a><a href="#glo:forlistcsloop"><code class="csfmt">\forlistcsloop</code></a> with the same handler macro as used with <a id="wrglossary.7870"></a><a href="#glo:DTLformatlist"><code class="csfmt">\DTLformatlist</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7871"></a><code class="code"><dfn id="glo:glsxtrfielddolistloop"><code class="csfmt">\glsxtrfielddolistloop</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.7872"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <a id="wrglossary.7873"></a><a href="#glo:dolistcsloop"><code class="csfmt">\dolistcsloop</code></a>, which uses the command <code class="csfmt">\do</code> as the handler.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7874"></a><code class="code"><dfn id="glo:glsxtrfieldforlistloop"><code class="csfmt">\glsxtrfieldforlistloop</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">handler-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.7875"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <a id="wrglossary.7876"></a><a href="#glo:forlistcsloop"><code class="csfmt">\forlistcsloop</code></a>, which uses the <span class="meta">〈<em class="metainner">handler-cs</em>〉</span> as the handler.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7877"></a><code class="code"><dfn id="glo:glsxtrfieldifinlist"><code class="csfmt">\glsxtrfieldifinlist</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">item</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.7878"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <a id="wrglossary.7879"></a><a href="#glo:ifinlistcs"><code class="csfmt">\ifinlistcs</code></a> to test if <span class="meta">〈<em class="metainner">item</em>〉</span> is in the list.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7880"></a><code class="code"><dfn id="glo:glsxtrfieldxifinlist"><code class="csfmt">\glsxtrfieldxifinlist</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">item</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.7881"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <a id="wrglossary.7882"></a><a href="#glo:xifinlistcs"><code class="csfmt">\xifinlistcs</code></a> to test if <span class="meta">〈<em class="metainner">item</em>〉</span> is in the list.<p>
+
+</section><!-- end of section sec:listfields -->
+
+<section id="sec:fieldconditionals"><!-- start of section sec:fieldconditionals --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->5.15. Field Conditionals<div class="labellink"><a href="#sec:fieldconditionals">[link]</a></div></h2><!-- end of section header -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7883"></a><code class="code"><dfn id="glo:GlsXtrIfFieldUndef"><code class="csfmt">\GlsXtrIfFieldUndef</code></dfn>{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Tests if the given <a id="wrglossary.7884"></a><a href="#glo:dual.field">field</a> (identified by its <a id="wrglossary.7885"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a>) is undefined for the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the entry doesn’t exists or if entry exists but the field hasn’t been set. Does <span class="meta">〈<em class="metainner">false</em>〉</span> if the field has been set, even if it has been set to empty. Unlike <a id="wrglossary.7886"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a> there is no grouping or starred version and no assignment of <a id="wrglossary.7887"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a>. This is simply a shortcut that internally uses <a id="wrglossary.7888"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <a id="wrglossary.7889"></a><a href="#glo:ifcsundef"><code class="csfmt">\ifcsundef</code></a>. The base <a id="wrglossary.7890"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package provides a similar command <a id="wrglossary.7891"></a><a href="#glo:ifglsfieldvoid"><code class="csfmt">\ifglsfieldvoid</code></a>, which uses <a id="wrglossary.7892"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <a id="wrglossary.7893"></a><a href="#glo:ifcsvoid"><code class="csfmt">\ifcsvoid</code></a> instead.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7894"></a><code class="code"><dfn id="glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></dfn>{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This tests if the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> has the <a id="wrglossary.7895"></a><a href="#glo:dual.field">field</a> identified by its <a id="wrglossary.7896"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a> <span class="meta">〈<em class="metainner">field-label</em>〉</span> set. This is like <a id="wrglossary.7897"></a><a href="#glo:ifglshasfield"><code class="csfmt">\ifglshasfield</code></a> but doesn’t produce a warning if the entry or field doesn’t exist. <p>
+This command first assigns <a id="wrglossary.7898"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a> to the field value. If this is defined and not empty, <span class="meta">〈<em class="metainner">true</em>〉</span> is done otherwise <span class="meta">〈<em class="metainner">false</em>〉</span> is done. You can test <a id="wrglossary.7899"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a> within <span class="meta">〈<em class="metainner">false</em>〉</span> to find out whether it’s undefined or empty using <a id="wrglossary.7900"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span></a>’s commands, such as <a id="wrglossary.7901"></a><a href="#glo:ifundef"><code class="csfmt">\ifundef</code></a> or <a id="wrglossary.7902"></a><a href="#glo:ifdefempty"><code class="csfmt">\ifdefempty</code></a>.<p>
+The unstarred version adds implicit grouping to make nesting easier. The starred version doesn’t (to make assignments easier).<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+If you are simply displaying the value of the field (for example, in the <a id="wrglossary.7903"></a><a href="#glo:dual.postdeschook">post-description hook</a>) then use the unstarred version. If you are making an assignment based on the value of the field, then use the starred version. </div><!-- end of information -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7904"></a><code class="code"><dfn id="glo:GlsXtrIfFieldCmpNum"><code class="csfmt">\GlsXtrIfFieldCmpNum</code></dfn>{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">op</em>〉</span>}{<span class="meta">〈<em class="metainner">number</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This command should only be used with fields that contain integer values. It internally uses <a id="wrglossary.7905"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a> (the starred or unstarred version, to match the starred or unstarred version of <a id="wrglossary.7906"></a><a href="#glo:GlsXtrIfFieldEqStr"><code class="csfmt">\GlsXtrIfFieldEqStr</code></a>) and tests if <a id="wrglossary.7907"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a> is equal to (<span class="meta">〈<em class="metainner">op</em>〉</span> is <code class="code">=</code>), less than (<span class="meta">〈<em class="metainner">op</em>〉</span> is <code class="code">&lt;</code>) or greater than (<span class="meta">〈<em class="metainner">op</em>〉</span> is <code class="code">&gt;</code>) the given number <span class="meta">〈<em class="metainner">number</em>〉</span>. If the field is empty or undefined, <a id="wrglossary.7908"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a> will be set to <code class="code">0</code>. Remember that the unstarred version adds implicit grouping.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7909"></a><code class="code"><dfn id="glo:GlsXtrIfFieldEqNum"><code class="csfmt">\GlsXtrIfFieldEqNum</code></dfn>{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">number</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This is a shortcut that uses <a id="wrglossary.7910"></a><a href="#glo:GlsXtrIfFieldCmpNum"><code class="csfmt">\GlsXtrIfFieldCmpNum</code></a> with <span class="meta">〈<em class="metainner">op</em>〉</span> set to <code class="code">=</code>. The unstarred version adds implicit grouping.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7911"></a><code class="code"><dfn id="glo:GlsXtrIfFieldNonZero"><code class="csfmt">\GlsXtrIfFieldNonZero</code></dfn>{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This is a shortcut that uses <a id="wrglossary.7912"></a><a href="#glo:GlsXtrIfFieldCmpNum"><code class="csfmt">\GlsXtrIfFieldCmpNum</code></a> with <span class="meta">〈<em class="metainner">op</em>〉</span> set to <code class="code">=</code> and the final two arguments swapped. (So it’s true if the field value is not zero.) The unstarred version adds implicit grouping.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7913"></a><code class="code"><dfn id="glo:GlsXtrIfFieldEqStr"><code class="csfmt">\GlsXtrIfFieldEqStr</code></dfn>{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This internally uses <a id="wrglossary.7914"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a> (the starred or unstarred version, to match the starred or unstarred version of <a id="wrglossary.7915"></a><a href="#glo:GlsXtrIfFieldEqStr"><code class="csfmt">\GlsXtrIfFieldEqStr</code></a>) and tests if <a id="wrglossary.7916"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a> is equal to <span class="meta">〈<em class="metainner">value</em>〉</span>. Remember that the unstarred version adds implicit grouping.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7917"></a><code class="code"><dfn id="glo:GlsXtrIfFieldEqXpStr"><code class="csfmt">\GlsXtrIfFieldEqXpStr</code></dfn>{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.7918"></a><a href="#glo:GlsXtrIfFieldEqStr"><code class="csfmt">\GlsXtrIfFieldEqStr</code></a> but expands the string before the comparison. This also has an starred version that doesn’t add implicit grouping.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7919"></a><code class="code"><dfn id="glo:GlsXtrIfXpFieldEqXpStr"><code class="csfmt">\GlsXtrIfXpFieldEqXpStr</code></dfn>{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.7920"></a><a href="#glo:GlsXtrIfFieldEqStr"><code class="csfmt">\GlsXtrIfFieldEqStr</code></a> but expands both the field value and the string before the comparison. This also has an starred version that doesn’t add implicit grouping.<p>
+
+</section><!-- end of section sec:fieldconditionals -->
+
+<section id="sec:countref"><!-- start of section sec:countref --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->6. Counting References<div class="labellink"><a href="#sec:countref">[link]</a></div></h1><!-- end of chapter header -->
+<p>
+There are three basic ways of counting entry references:
+<ol class="displaylist">
+ <li><span class="numitem">1.</span>Counting the total number of times <a id="wrglossary.7921"></a><a href="#glo:glsunset"><code class="csfmt">\glsunset</code></a> is used (<a id="wrglossary.7922"></a><a href="#glo:glsreset"><code class="csfmt">\glsreset</code></a> resets the count unless <a id="wrglossary.7923"></a><a href="#glo:glsresetcurrcountfalse"><code class="csfmt">\glsresetcurrcountfalse</code></a> and is best avoided). This is provided by the base <a id="wrglossary.7924"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package and is intended for documents where the term should be displayed differently if it’s only been used a certain number of times. The information has to be written to the <a id="wrglossary.7925"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file so that it’s available on the next LaTeX run.<p>
+This method is extended by <a id="wrglossary.7926"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and is described in §<a href="#sec:entrycount">6.1</a>. This method relies on the document only using the <a id="wrglossary.7927"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands and is inappropriate with <a id="wrglossary.7928"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>.<p>
+<li><span class="numitem">2.</span>Counting the total number of records. This method is only available with <a id="wrglossary.7929"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> and is intended for documents where the term should be displayed differently if it’s only been <a id="wrglossary.7930"></a><a href="#glo:@@glslabel@indexing">recorded</a> (<a id="wrglossary.7931"></a><a href="#glo:@@glslabel@indexing">indexed</a>) a certain number of times. This is a more efficient method than entry counting. See §<a href="#sec:recordcount">11.4</a> for further details.<p>
+<li><span class="numitem">3.</span>Counting the number of times the <a id="wrglossary.7932"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> or <a id="wrglossary.7933"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands are used. Unlike the other two methods, this just provides a running total rather than the total from the previous LaTeX run. This method is intended to make it more convenient to work with hooks like <a id="wrglossary.7934"></a><a href="#glo:glslinkcheckfirsthyperhook"><code class="csfmt">\glslinkcheckfirsthyperhook</code></a>, <a id="wrglossary.7935"></a><a href="#glo:glslinkpostsetkeys"><code class="csfmt">\glslinkpostsetkeys</code></a> or <a id="wrglossary.7936"></a><a href="#glo:glslinkpresetkeys"><code class="csfmt">\glslinkpresetkeys</code></a>. See §<a href="#sec:linkcount">6.2</a> for further details.
+</ol>
+<p>
+
+</section><!-- end of section sec:countref -->
+
+<section id="sec:entrycount"><!-- start of section sec:entrycount --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->6.1. Entry Counting (First Use Flag)<div class="labellink"><a href="#sec:entrycount">[link]</a></div></h2><!-- end of section header -->
+<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+If you are using <a id="wrglossary.7937"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, you need to use record counting instead (see §<a href="#sec:recordcount">11.4</a>). </div><!-- end of information -->
+<p>
+Entry counting is provided by the base <a id="wrglossary.7938"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package and is enabled with <a id="wrglossary.7939"></a><a href="#glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></a>. This keeps a count of the number of times an entry is marked as used, which is done by hooking into the unset and reset commands (see §<a href="#sec:glsunset">5.10</a>). The current running total can be obtained with <a id="wrglossary.7940"></a><a href="#glo:glsentrycurrcount"><code class="csfmt">\glsentrycurrcount</code></a>. The total from the end of the previous LaTeX run can be obtained with <a id="wrglossary.7941"></a><a href="#glo:glsentryprevcount"><code class="csfmt">\glsentryprevcount</code></a>.<p>
+Since entry counting relies on the <a id="wrglossary.7942"></a><a href="#glo:dual.firstuseflag">first use flag</a>, it doesn’t take the <a id="wrglossary.7943"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands into account. <p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+Entry counting is incompatible with <a id="wrglossary.7944"></a><a href="#glo:opt.docdef"><span class="styoptfmt">docdef</span></a><span class="optfmt">=</span><a id="wrglossary.7945"></a><a href="#glo:optval.docdef.true"><span class="optfmt">true</span></a>. </div><!-- end of warning -->
+<p>
+The <a id="wrglossary.7946"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package modifies <a id="wrglossary.7947"></a><a href="#glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></a> to allow for the <a id="wrglossary.7948"></a><a href="#glo:opt.catattr.entrycount"><span class="csoptfmt">entrycount</span></a> attribute. This means that you not only need to enable entry counting with <a id="wrglossary.7949"></a><a href="#glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></a>, but you also need to set the <a id="wrglossary.7950"></a><a href="#glo:opt.catattr.entrycount"><span class="csoptfmt">entrycount</span></a> attribute (see below).<p>
+Prior to v1.49, the associated counter was reset back to 0 when the <a id="wrglossary.7951"></a><a href="#glo:dual.firstuseflag">first use flag</a> is reset. This behaviour is now only implemented if the following conditional is true: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7952"></a><code class="code"><dfn id="glo:ifglsresetcurrcount"><code class="csfmt">\ifglsresetcurrcount</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\iffalse</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ To (locally) change this conditional to true use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7953"></a><code class="code"><dfn id="glo:glsresetcurrcounttrue"><code class="csfmt">\glsresetcurrcounttrue</code></dfn></code></div><!-- end of pinnedbox -->
+ To (locally) change this conditional to false use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7954"></a><code class="code"><dfn id="glo:glsresetcurrcountfalse"><code class="csfmt">\glsresetcurrcountfalse</code></dfn></code></div><!-- end of pinnedbox -->
+ As from v1.49, the default is now false. Note that this conditional is also available with <a id="wrglossary.7955"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Remember that entry counting only counts the number of times an entry is used by commands that change the <a id="wrglossary.7956"></a><a href="#glo:dual.firstuseflag">first use flag</a>. (That is, all those commands that mark the entry as having been used.) There are many commands that don’t modify this flag and they won’t contribute to the entry use count. </div><!-- end of important -->
+<p>
+With just the base <a id="wrglossary.7957"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, the associated entry counting commands, such as <a id="wrglossary.7958"></a><a href="#glo:cgls"><code class="csfmt">\cgls</code></a>, are only available when entry counting has been activated with <a id="wrglossary.7959"></a><a href="#glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></a>. Whereas with <a id="wrglossary.7960"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, those commands are always available but behave in the same way as the corresponding <a id="wrglossary.7961"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands if entry counting hasn’t been activated. The commands provided by the <a id="wrglossary.7962"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a> options, such as <a id="wrglossary.7963"></a><a href="#glo:ac"><code class="csfmt">\ac</code></a> are defined to use <a id="wrglossary.7964"></a><a href="#glo:cgls"><code class="csfmt">\cgls</code></a> instead of <a id="wrglossary.7965"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> etc so you can use them either with or without entry counting.<p>
+In order to activate entry counting with <a id="wrglossary.7966"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, you not only need to use <a id="wrglossary.7967"></a><a href="#glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></a> but also need to specify the trigger value.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7968"></a><code class="code"><dfn id="glo:GlsXtrEnableEntryCounting"><code class="csfmt">\GlsXtrEnableEntryCounting</code></dfn>{<span class="meta">〈<em class="metainner">category-list</em>〉</span>}{<span class="meta">〈<em class="metainner">trigger-value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is provided as a shortcut to activate entry counting and assign the trigger value. This command performs the following:
+<ul class="displaylist">
+ <li><span class="bulletitem">•</span>enables entry counting with <a id="wrglossary.7969"></a><a href="#glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></a>; <li><span class="bulletitem">•</span>redefines the <a id="wrglossary.7970"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands to do the equivalent <a id="wrglossary.7971"></a><a href="#glo:cgls"><code class="csfmt">\cgls</code></a> commands (so you don’t need to keep track of which entries have entry counting enabled); <li><span class="bulletitem">•</span>sets the <a id="wrglossary.7972"></a><a href="#glo:opt.catattr.entrycount"><span class="csoptfmt">entrycount</span></a> attribute to <span class="meta">〈<em class="metainner">trigger-value</em>〉</span> for all the supplied categories; <li><span class="bulletitem">•</span>disables the unit counting command (which is incompatible).
+</ul>
+ If you want to have different trigger values for different categories, you can set the <a id="wrglossary.7973"></a><a href="#glo:opt.catattr.entrycount"><span class="csoptfmt">entrycount</span></a> attribute afterwards for the other category. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.7974"></a><a href="#glo:GlsXtrEnableEntryCounting"><code class="csfmt">\GlsXtrEnableEntryCounting</code></a>{<a id="wrglossary.7975"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a>,<a id="wrglossary.7976"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a>}{1}
+<a id="wrglossary.7977"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{<a id="wrglossary.7978"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>}{2}
+</pre> If you use <a id="wrglossary.7979"></a><a href="#glo:GlsXtrEnableEntryCounting"><code class="csfmt">\GlsXtrEnableEntryCounting</code></a> multiple times, the repeated instances will simply set the <a id="wrglossary.7980"></a><a href="#glo:opt.catattr.entrycount"><span class="csoptfmt">entrycount</span></a> attribute for the listed categories. So the above can also be written as: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.7981"></a><a href="#glo:GlsXtrEnableEntryCounting"><code class="csfmt">\GlsXtrEnableEntryCounting</code></a>{<a id="wrglossary.7982"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a>,<a id="wrglossary.7983"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a>}{1}
+<a id="wrglossary.7984"></a><a href="#glo:GlsXtrEnableEntryCounting"><code class="csfmt">\GlsXtrEnableEntryCounting</code></a>{<a id="wrglossary.7985"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>}{2}
+</pre><p>
+The commands like <a id="wrglossary.7986"></a><a href="#glo:cgls"><code class="csfmt">\cgls</code></a> behave like the corresponding <a id="wrglossary.7987"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> command if the entry count at the end of the previous run was more than a trigger value. With just the base <a id="wrglossary.7988"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, this trigger value is 1. With <a id="wrglossary.7989"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> you can specify a different value.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The appropriate trigger value must be set for the required category or categories. </div><!-- end of important -->
+<p>
+As with the <a id="wrglossary.7990"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands, the <a id="wrglossary.7991"></a><a href="#glo:cgls"><code class="csfmt">\cgls</code></a> set of commands may also be used with the star (<code class="code">*</code>) or plus (<code class="code">+</code>) modifiers or the modifier given by <a id="wrglossary.7992"></a><a href="#glo:GlsXtrSetAltModifier"><code class="csfmt">\GlsXtrSetAltModifier</code></a>.<p>
+If the entry count at the end of the previous run doesn’t exceed the trigger value, the corresponding formatting command is used instead. For example, <a id="wrglossary.7993"></a><a href="#glo:cgls"><code class="csfmt">\cgls</code></a> will use <a id="wrglossary.7994"></a><a href="#glo:cglsformat"><code class="csfmt">\cglsformat</code></a>. The complete set of commands are: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.7995"></a><code class="code"><dfn id="glo:cgls"><code class="csfmt">\cgls</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.7996"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.7997"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.7998"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ If the trigger value has been supplied for the entry’s category and is exceeded, this behaves like <a id="wrglossary.7999"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> otherwise it uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8000"></a><code class="code"><dfn id="glo:cglsformat"><code class="csfmt">\cglsformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is redefined by <a id="wrglossary.8001"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> to test whether or not the entry has the <a id="wrglossary.8002"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute set or is an abbreviation: <pre class="compactcodebox"><code class="cmd">\renewcommand</code>*{<a id="wrglossary.8003"></a><a href="#glo:cglsformat"><code class="csfmt">\cglsformat</code></a>}[2]{%
+ <a id="wrglossary.8004"></a><a href="#glo:glsifregular"><code class="csfmt">\glsifregular</code></a>{#1}{<a id="wrglossary.8005"></a><a href="#glo:glsentryfirst"><code class="csfmt">\glsentryfirst</code></a>{#1}}%
+ {<a id="wrglossary.8006"></a><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a>{#1}{<a id="wrglossary.8007"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a>{#1}}{<a id="wrglossary.8008"></a><a href="#glo:glsentryfirst"><code class="csfmt">\glsentryfirst</code></a>{#1}}}#2%
+}
+</pre> This show the first use value if the entry is regular otherwise it will show the long form. The insert is appended at the end.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8009"></a><code class="code"><dfn id="glo:cglspl"><code class="csfmt">\cglspl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.8010"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.8011"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.8012"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ If the trigger value has been supplied for the entry’s category and is exceeded, this behaves like <a id="wrglossary.8013"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> otherwise it uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8014"></a><code class="code"><dfn id="glo:cglsplformat"><code class="csfmt">\cglsplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.8015"></a><a href="#glo:cglsformat"><code class="csfmt">\cglsformat</code></a> but uses the plural commands.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8016"></a><code class="code"><dfn id="glo:cGls"><code class="csfmt">\cGls</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.8017"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.8018"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.8019"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ If the trigger value has been supplied for the entry’s category and is exceeded, this behaves like <a id="wrglossary.8020"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> otherwise it uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8021"></a><code class="code"><dfn id="glo:cGlsformat"><code class="csfmt">\cGlsformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.8022"></a><a href="#glo:cglsformat"><code class="csfmt">\cglsformat</code></a> but uses the <a id="wrglossary.8023"></a><a href="#glo:idx.sentencecase">sentence case</a> commands.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8024"></a><code class="code"><dfn id="glo:cGlspl"><code class="csfmt">\cGlspl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.8025"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.8026"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.8027"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ If the trigger value has been supplied for the entry’s category and is exceeded, this behaves like <a id="wrglossary.8028"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a> otherwise it uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8029"></a><code class="code"><dfn id="glo:cGlsplformat"><code class="csfmt">\cGlsplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.8030"></a><a href="#glo:cglsformat"><code class="csfmt">\cglsformat</code></a> but uses the plural <a id="wrglossary.8031"></a><a href="#glo:idx.sentencecase">sentence case</a> commands.<p>
+The <a id="wrglossary.8032"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides some additional commands:<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8033"></a><code class="code"><dfn id="glo:cGLS"><code class="csfmt">\cGLS</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.8034"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.8035"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.8036"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ If the trigger value has been supplied for the entry’s category and is exceeded, this behaves like <a id="wrglossary.8037"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a> otherwise it uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8038"></a><code class="code"><dfn id="glo:cGLSformat"><code class="csfmt">\cGLSformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This simply uses <a id="wrglossary.8039"></a><a href="#glo:cglsformat"><code class="csfmt">\cglsformat</code></a> converted to <a id="wrglossary.8040"></a><a href="#glo:idx.uppercase">uppercase</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8041"></a><code class="code"><dfn id="glo:cGLSpl"><code class="csfmt">\cGLSpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.8042"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.8043"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.8044"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ If the trigger value has been supplied for the entry’s category and is exceeded, this behaves like <a id="wrglossary.8045"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a> otherwise it uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8046"></a><code class="code"><dfn id="glo:cGLSplformat"><code class="csfmt">\cGLSplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This simply uses <a id="wrglossary.8047"></a><a href="#glo:cglsplformat"><code class="csfmt">\cglsplformat</code></a> converted to <a id="wrglossary.8048"></a><a href="#glo:idx.uppercase">uppercase</a>.<p>
+The test to determine whether or not an entry trips the trigger value is performed by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8049"></a><code class="code"><dfn id="glo:glsxtrifcounttrigger"><code class="csfmt">\glsxtrifcounttrigger</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This obtains the trigger value from the entry’s <a id="wrglossary.8050"></a><a href="#glo:opt.catattr.entrycount"><span class="csoptfmt">entrycount</span></a> attribute.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Since these commands require information from the previous LaTeX run, and extra LaTeX call must be added to the build process (before the relevant <a id="wrglossary.8051"></a><a href="#glo:dual.indexingapp">indexing application</a>). </div><!-- end of important -->
+<p>
+For example, in the following document the trigger value is set to 1. The CSS entry is only used once (which doesn’t exceed the trigger). The HTML entry is used twice (which does exceed the trigger). The sample entry is only used once, but entry counting hasn’t been enabled on its category (the default <a id="wrglossary.8052"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>).<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+<a id="wrglossary.8053"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.8054"></a><a href="#glo:GlsXtrEnableEntryCounting"><code class="csfmt">\GlsXtrEnableEntryCounting</code></a>{<a id="wrglossary.8055"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a>}{1}
+<a id="wrglossary.8056"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{css}{CSS}{cascading style sheet}
+<a id="wrglossary.8057"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{html}{HTML}{hypertext markup language}
+<a id="wrglossary.8058"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.8059"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.8060"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+<code class="cbeg">\begin{document}</code>
+First use: <a id="wrglossary.8061"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{css}, <a id="wrglossary.8062"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html} and <a id="wrglossary.8063"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}.
+Next use: <a id="wrglossary.8064"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+<a id="wrglossary.8065"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> If the document is saved in a file called <span class="filefmt">myDoc.tex</span> then the build process is: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
+pdflatex myDoc
+makeglossaries myDoc
+pdflatex myDoc
+</pre> Note the second LaTeX call before <a id="wrglossary.8066"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. The result is shown below: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:catentrycount"></a>Example 121: Entry counting according to category <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example121.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example121.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example121.png" type="image/png" width="389" height="123">Example document illustrating entry counting.</object> </div><!-- end of resultbox -->
+ Note that the CSS entry only shows the long form, doesn’t appear in the glossary and doesn’t have a hyperlink. This is because the total count from the previous LaTeX run doesn’t exceed the value (1, in this case) that triggers the normal behaviour of <a id="wrglossary.8067"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. The HTML entry has a total count of 2 from the previous LaTeX run, so it’s displayed as normal with the full form on <a id="wrglossary.8068"></a><a href="#glo:dual.firstuse">first use</a> and has a hyperlink to its entry in the glossary.<p>
+The sample entry is only used once, but it has the default <a id="wrglossary.8069"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a> category, which doesn’t have the <a id="wrglossary.8070"></a><a href="#glo:opt.catattr.entrycount"><span class="csoptfmt">entrycount</span></a> attribute set.<p>
+Note that if the build process only had one LaTeX call before running <a id="wrglossary.8071"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, the HTML entry would also not appear in the glossary. This is because on the first LaTeX run, the total from the previous run is 0 (because there’s no information in the <a id="wrglossary.8072"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file).<p>
+The <a id="wrglossary.8073"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package also provides the ability to count per sectional unit instead: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8074"></a><code class="code"><dfn id="glo:glsenableentryunitcount"><code class="csfmt">\glsenableentryunitcount</code></dfn></code></div><!-- end of pinnedbox -->
+<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+It’s not possible to enable both document-wide entry counting (<a id="wrglossary.8075"></a><a href="#glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></a>) and unit entry counting (<a id="wrglossary.8076"></a><a href="#glo:glsenableentryunitcount"><code class="csfmt">\glsenableentryunitcount</code></a>). </div><!-- end of important -->
+<p>
+The unit entry counting provides separate totals for each section unit. As above, this uses the <a id="wrglossary.8077"></a><a href="#glo:opt.catattr.entrycount"><span class="csoptfmt">entrycount</span></a> attribute to provide the trigger value but also requires the <a id="wrglossary.8078"></a><a href="#glo:opt.catattr.unitcount"><span class="csoptfmt">unitcount</span></a> attribute, which should be set to the name of the appropriate counter, such as <a id="wrglossary.8079"></a><a href="#glo:ctr.section"><span class="ctrfmt">section</span></a> or <a id="wrglossary.8080"></a><a href="#glo:ctr.chapter"><span class="ctrfmt">chapter</span></a>.<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+Due to the asynchronous nature of TeX’s output routine, discrepancies will occur in page spanning paragraphs if you use the <a id="wrglossary.8081"></a><a href="#glo:ctr.page"><span class="ctrfmt">page</span></a> counter. </div><!-- end of warning -->
+<p>
+As before, there is a command provided to enable the feature and set the corresponding attributes at the same time: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8082"></a><code class="code"><dfn id="glo:GlsXtrEnableEntryUnitCounting"><code class="csfmt">\GlsXtrEnableEntryUnitCounting</code></dfn>{<span class="meta">〈<em class="metainner">category-list</em>〉</span>}{<span class="meta">〈<em class="metainner">trigger-value</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command performs the following:
+<ul class="displaylist">
+ <li><span class="bulletitem">•</span>enables unit entry counting with <a id="wrglossary.8083"></a><a href="#glo:glsenableentryunitcount"><code class="csfmt">\glsenableentryunitcount</code></a>; <li><span class="bulletitem">•</span>redefines the <a id="wrglossary.8084"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands to do the equivalent <a id="wrglossary.8085"></a><a href="#glo:cgls"><code class="csfmt">\cgls</code></a> commands (so you don’t need to keep track of which entries have entry counting enabled); <li><span class="bulletitem">•</span>sets the <a id="wrglossary.8086"></a><a href="#glo:opt.catattr.entrycount"><span class="csoptfmt">entrycount</span></a> attribute to the supplied trigger for all the supplied categories; <li><span class="bulletitem">•</span>sets the <a id="wrglossary.8087"></a><a href="#glo:opt.catattr.unitcount"><span class="csoptfmt">unitcount</span></a> attribute to the supplied counter for all the supplied categories; <li><span class="bulletitem">•</span>disables the document-wide counting command (which is incompatible).
+</ul>
+ If you use <a id="wrglossary.8088"></a><a href="#glo:GlsXtrEnableEntryUnitCounting"><code class="csfmt">\GlsXtrEnableEntryUnitCounting</code></a> multiple times, the repeated instances will simply set the <a id="wrglossary.8089"></a><a href="#glo:opt.catattr.entrycount"><span class="csoptfmt">entrycount</span></a> and <a id="wrglossary.8090"></a><a href="#glo:opt.catattr.unitcount"><span class="csoptfmt">unitcount</span></a> attributes for the listed categories.<p>
+The counter value is used as part of a label, which means that <a id="wrglossary.8091"></a><a href="#glo:thecounter"><code class="csfmt">\the<span class="meta">〈<em class="metainner">counter-name</em>〉</span></code></a> needs to be expandable. Since <a id="wrglossary.8092"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> also has a similar requirement and provides <a id="wrglossary.8093"></a><a href="#glo:theHcounter"><code class="csfmt">\the<span class="meta">〈<em class="metainner">counter-name</em>〉</span></code></a> as an expandable alternative, <a id="wrglossary.8094"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> will use <a id="wrglossary.8095"></a><a href="#glo:theHcounter"><code class="csfmt">\the<span class="meta">〈<em class="metainner">counter-name</em>〉</span></code></a> if it exists otherwise it will use <a id="wrglossary.8096"></a><a href="#glo:thecounter"><code class="csfmt">\the<span class="meta">〈<em class="metainner">counter-name</em>〉</span></code></a>.<p>
+The commands for accessing the totals, <a id="wrglossary.8097"></a><a href="#glo:glsentrycurrcount"><code class="csfmt">\glsentrycurrcount</code></a> and <a id="wrglossary.8098"></a><a href="#glo:glsentryprevcount"><code class="csfmt">\glsentryprevcount</code></a> have different definitions with unit entry counting and will expand to the total for the current unit. The overall totals can be obtained with additional commands: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8099"></a><code class="code"><dfn id="glo:glsentryprevtotalcount"><code class="csfmt">\glsentryprevtotalcount</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This expands to the overall total from the previous LaTeX run.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8100"></a><code class="code"><dfn id="glo:glsentryprevmaxcount"><code class="csfmt">\glsentryprevmaxcount</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This expands to the maximum per-unit total from the previous LaTeX run.<p>
+For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+
+<a id="wrglossary.8101"></a><a href="#glo:GlsXtrEnableEntryUnitCounting"><code class="csfmt">\GlsXtrEnableEntryUnitCounting</code></a>{<a id="wrglossary.8102"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a>}{2}{section}
+
+<a id="wrglossary.8103"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<span class="comment">% <a id="wrglossary.8104"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={abbreviation}</span>:</span>
+<a id="wrglossary.8105"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{html}{HTML}{hypertext markup language}
+<a id="wrglossary.8106"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{css}{CSS}{cascading style sheet}
+
+<span class="comment">% <a id="wrglossary.8107"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={general}</span>:</span>
+<a id="wrglossary.8108"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.8109"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.8110"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={sample}</span>}
+
+<code class="cbeg">\begin{document}</code>
+<code class="cmd">\section</code>{Sample}
+
+Used once: <a id="wrglossary.8111"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+
+Used three times: <a id="wrglossary.8112"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{css} and <a id="wrglossary.8113"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{css} and <a id="wrglossary.8114"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{css}.
+
+Used once: <a id="wrglossary.8115"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}.
+
+<code class="cmd">\section</code>{Another Sample}
+
+Used once: <a id="wrglossary.8116"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{css}.
+
+Used twice: <a id="wrglossary.8117"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html} and <a id="wrglossary.8118"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+
+<a id="wrglossary.8119"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> As before, if the document is in a file called <span class="filefmt">myDoc.tex</span> then the build process is: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
+pdflatex myDoc
+makeglossaries myDoc
+pdflatex myDoc
+</pre> The result is: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:catunitentrycount"></a>Example 122: Entry unit counting (per section) according to category <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example122.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example122.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example122.png" type="image/png" width="388" height="247">Example document illustrating entry unit counting (per section).</object> </div><!-- end of resultbox -->
+ In this document, the CSS entry is used three times in the first section. This is more than the trigger value of 2, so <code class="code"><a id="wrglossary.8120"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{css}</code> is expanded on <a id="wrglossary.8121"></a><a href="#glo:dual.firstuse">first use</a> with the short form used on subsequent use, and the CSS entries in that section are added to the glossary. In the second section, the CSS entry is only used once, which trips the suppression trigger, so in that section, the long form is used and <code class="code"><a id="wrglossary.8122"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{css}</code> doesn’t get a line added to the glossary file.<p>
+The HTML entry is used a total of three times, but the expansion and indexing suppression trigger is tripped in both sections because the per-unit total (1 for the first section and 2 for the second chapter) is less than or equal to the trigger value.<p>
+The sample entry has only been used once, but it doesn’t trip the indexing suppression because it’s in the <a id="wrglossary.8123"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a> category, which hasn’t been listed in <a id="wrglossary.8124"></a><a href="#glo:GlsXtrEnableEntryUnitCounting"><code class="csfmt">\GlsXtrEnableEntryUnitCounting</code></a>.<p>
+The per-unit entry counting can be used for other purposes. In the following example document, the trigger value is set to zero, which means the index suppression won’t be triggered, but the unit entry count is used to automatically suppress the hyperlink for commands like <a id="wrglossary.8125"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> by modifying the <a id="wrglossary.8126"></a><a href="#glo:glslinkcheckfirsthyperhook"><code class="csfmt">\glslinkcheckfirsthyperhook</code></a> which is used at the end of the macro the determines whether or not to suppress the hyperlink.<p>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+<a id="wrglossary.8127"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.8128"></a><a href="#glo:GlsXtrEnableEntryUnitCounting"><code class="csfmt">\GlsXtrEnableEntryUnitCounting</code></a>{<a id="wrglossary.8129"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>}{0}{page}
+<a id="wrglossary.8130"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.8131"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.8132"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.8133"></a><a href="#glo:glslinkcheckfirsthyperhook"><code class="csfmt">\glslinkcheckfirsthyperhook</code></a>}{%
+ <code class="cmd">\ifnum</code><a id="wrglossary.8134"></a><a href="#glo:glsentrycurrcount"><code class="csfmt">\glsentrycurrcount</code></a><a id="wrglossary.8135"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>&gt;0
+ <a id="wrglossary.8136"></a><a href="#glo:setupglslink"><code class="csfmt">\setupglslink</code></a>{hyper=false}%
+ <code class="cmd">\fi</code>
+}
+
+<code class="cbeg">\begin{document}</code>
+
+A <a id="wrglossary.8137"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample} entry. Next use: <a id="wrglossary.8138"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}.
+
+<code class="cmd">\newpage</code>
+Next page: <a id="wrglossary.8139"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}. Again: <a id="wrglossary.8140"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}.
+
+<a id="wrglossary.8141"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> This only produces a hyperlink for the first instance of <code class="code"><a id="wrglossary.8142"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}</code> on each page. <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:unitentrycounthyper"></a>Example 123: Enabling unit counting to hook into hyperlink setting <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example123.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example123.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example123-page1.png" type="image/png" width="178" height="12">Page 1. Example document that demonstrates how to automatically switch off the hyperlink using unit counting.</object><object data="glossaries-extra-manual-examples/glossaries-extra-manual-example123-page2.png" type="image/png" width="198" height="78">Page 2. Example document that demonstrates how to automatically switch off the hyperlink using unit counting.</object> </div><!-- end of resultbox -->
+<p>
+The earlier warning about using the <a id="wrglossary.8143"></a><a href="#glo:ctr.page"><span class="ctrfmt">page</span></a> counter still applies. If the first instance of <a id="wrglossary.8144"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> occurs at the top of the page within a paragraph that started on the previous page, then the count will continue from the previous page.<p>
+
+</section><!-- end of section sec:entrycount -->
+
+<section id="sec:linkcount"><!-- start of section sec:linkcount --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->6.2. Link Counting<div class="labellink"><a href="#sec:linkcount">[link]</a></div></h2><!-- end of section header -->
+<p>
+As from version 1.26, an alternative method of entry counting is to count the number of times the <a id="wrglossary.8145"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> or <a id="wrglossary.8146"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands are used. (The <span class="qt">“link”</span> in this method’s name refers to the use of the internal command <code class="csfmt">\@gls@link</code> not to <a id="wrglossary.8147"></a><a href="#glo:hyperlink"><code class="csfmt">\hyperlink</code></a> although <code class="csfmt">\@gls@link</code> may use <a id="wrglossary.8148"></a><a href="#glo:hyperlink"><code class="csfmt">\hyperlink</code></a> when displaying the <a id="wrglossary.8149"></a><a href="#glo:dual.linktext">link text</a>.)<p>
+To enable link counting use the preamble-only command: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8150"></a><code class="code"><dfn id="glo:GlsXtrEnableLinkCounting"><code class="csfmt">\GlsXtrEnableLinkCounting</code></dfn>[<span class="meta">〈<em class="metainner">parent counter</em>〉</span>]{<span class="meta">〈<em class="metainner">categories</em>〉</span>}</code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">categories</em>〉</span> is a list of category labels. The optional argument <span class="meta">〈<em class="metainner">parent counter</em>〉</span> may be used to identify a parent counter (which must already be defined). If present, the associated link counter will be reset when the parent counter is incremented. This command automatically sets the <a id="wrglossary.8151"></a><a href="#glo:opt.catattr.linkcount"><span class="csoptfmt">linkcount</span></a> attribute for the given categories. If the optional argument is present, it also sets the <a id="wrglossary.8152"></a><a href="#glo:opt.catattr.linkcountmaster"><span class="csoptfmt">linkcountmaster</span></a> attribute.<p>
+When enabled, the <a id="wrglossary.8153"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.8154"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands will increment the associated counter using <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8155"></a><code class="code"><dfn id="glo:glsxtrinclinkcounter"><code class="csfmt">\glsxtrinclinkcounter</code></dfn>{<span class="meta">〈<em class="metainner">counter</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This just does <code class="code"><a id="wrglossary.8156"></a><a href="#glo:stepcounter"><code class="csfmt">\stepcounter</code></a>{<span class="meta">〈<em class="metainner">counter</em>〉</span>}</code> by default but if you need <a id="wrglossary.8157"></a><a href="#glo:refstepcounter"><code class="csfmt">\refstepcounter</code></a> instead, just redefine this command: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8158"></a><a href="#glo:renewcommand"><code class="csfmt">\renewcommand</code></a>*{<a id="wrglossary.8159"></a><a href="#glo:glsxtrinclinkcounter"><code class="csfmt">\glsxtrinclinkcounter</code></a>}[1]{<a id="wrglossary.8160"></a><a href="#glo:refstepcounter"><code class="csfmt">\refstepcounter</code></a>{#1}}
+</pre><p>
+You can access the internal count register using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8161"></a><code class="code"><dfn id="glo:GlsXtrLinkCounterValue"><code class="csfmt">\GlsXtrLinkCounterValue</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">label</em>〉</span> is the entry’s label. This will expand to 0 if the register hasn’t been defined.<p>
+It’s also possible to access the display value (<a id="wrglossary.8162"></a><a href="#glo:thecounter"><code class="csfmt">\the<span class="meta">〈<em class="metainner">counter</em>〉</span></code></a>) using <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8163"></a><code class="code"><dfn id="glo:GlsXtrTheLinkCounter"><code class="csfmt">\GlsXtrTheLinkCounter</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ (This will expand to 0 if the counter hasn’t been defined.)<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+In order to conserve resources, the counter is only defined when it first needs to be incremented so terms that have been defined but haven’t been used in the document won’t have the associated count register allocated. </div><!-- end of important -->
+<p>
+You can test if the counter has been defined using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8164"></a><code class="code"><dfn id="glo:GlsXtrIfLinkCounterDef"><code class="csfmt">\GlsXtrIfLinkCounterDef</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This expands to <span class="meta">〈<em class="metainner">true</em>〉</span> if the link counter associated with the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> has been defined, otherwise expands to <span class="meta">〈<em class="metainner">false</em>〉</span>.<p>
+The counter name can be obtained using <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8165"></a><code class="code"><dfn id="glo:GlsXtrLinkCounterName"><code class="csfmt">\GlsXtrLinkCounterName</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This simply expands to the counter name associated with the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> without any check for existence. For example, to change the display command (<a id="wrglossary.8166"></a><a href="#glo:thecounter"><code class="csfmt">\the<span class="meta">〈<em class="metainner">counter</em>〉</span></code></a>) using <a id="wrglossary.8167"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8168"></a><a href="#glo:csdef"><code class="csfmt">\csdef</code></a>{the<a id="wrglossary.8169"></a><a href="#glo:GlsXtrLinkCounterName"><code class="csfmt">\GlsXtrLinkCounterName</code></a>{duck}}%
+ {<a id="wrglossary.8170"></a><a href="#glo:Roman"><code class="csfmt">\Roman</code></a>{<a id="wrglossary.8171"></a><a href="#glo:GlsXtrLinkCounterName"><code class="csfmt">\GlsXtrLinkCounterName</code></a>{duck}}}
+</pre><p>
+This is useful if you just want to change the display for specific entries but isn’t convenient if you want to change the display for all entries. Instead, it’s simpler to redefine <a id="wrglossary.8172"></a><a href="#glo:GlsXtrTheLinkCounter"><code class="csfmt">\GlsXtrTheLinkCounter</code></a>. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.8173"></a><a href="#glo:GlsXtrTheLinkCounter"><code class="csfmt">\GlsXtrTheLinkCounter</code></a>}[1]{%
+ <a id="wrglossary.8174"></a><a href="#glo:GlsXtrIfLinkCounterDef"><code class="csfmt">\GlsXtrIfLinkCounterDef</code></a>{#1}%
+ {<a id="wrglossary.8175"></a><a href="#glo:Roman"><code class="csfmt">\Roman</code></a>{<a id="wrglossary.8176"></a><a href="#glo:GlsXtrLinkCounterName"><code class="csfmt">\GlsXtrLinkCounterName</code></a>{#1}}}%
+ {0}%
+}
+</pre> In both cases, the redefinition should be implemented after <a id="wrglossary.8177"></a><a href="#glo:GlsXtrEnableLinkCounting"><code class="csfmt">\GlsXtrEnableLinkCounting</code></a>.<p>
+Here’s an example document that uses link counting to disable the hyperlink after the first reference. This redefines <a id="wrglossary.8178"></a><a href="#glo:glslinkpresetkeys"><code class="csfmt">\glslinkpresetkeys</code></a> (which is used by both <a id="wrglossary.8179"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> and <a id="wrglossary.8180"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>) instead of <a id="wrglossary.8181"></a><a href="#glo:glslinkcheckfirsthyperhook"><code class="csfmt">\glslinkcheckfirsthyperhook</code></a> (which is used by <a id="wrglossary.8182"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> but not by <a id="wrglossary.8183"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>). <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+
+<code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+
+<a id="wrglossary.8184"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.8185"></a><a href="#glo:glslinkpresetkeys"><code class="csfmt">\glslinkpresetkeys</code></a>}{%
+ <code class="cmd">\ifnum</code><a id="wrglossary.8186"></a><a href="#glo:GlsXtrLinkCounterValue"><code class="csfmt">\GlsXtrLinkCounterValue</code></a>{<a id="wrglossary.8187"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}&gt;1
+ <a id="wrglossary.8188"></a><a href="#glo:setupglslink"><code class="csfmt">\setupglslink</code></a>{<a id="wrglossary.8189"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span>}%
+ <code class="cmd">\fi</code>
+}
+
+<a id="wrglossary.8190"></a><a href="#glo:GlsXtrEnableLinkCounting"><code class="csfmt">\GlsXtrEnableLinkCounting</code></a>{<a id="wrglossary.8191"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>}
+
+<a id="wrglossary.8192"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample1}{<a id="wrglossary.8193"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample1}</span>,<a id="wrglossary.8194"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+<a id="wrglossary.8195"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample2}{<a id="wrglossary.8196"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample2}</span>,<a id="wrglossary.8197"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={another example}</span>}
+
+<a id="wrglossary.8198"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ex}{ex}{example}
+
+<code class="cbeg">\begin{document}</code>
+<code class="cmd">\section</code>{Sample Section}
+
+<a id="wrglossary.8199"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{sample1}, <a id="wrglossary.8200"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample2} and <a id="wrglossary.8201"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}.
+<a id="wrglossary.8202"></a><a href="#glo:Glstext"><code class="csfmt">\Glstext</code></a>{sample1} and <a id="wrglossary.8203"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex} again.
+
+<code class="cmd">\section</code>{Another Sample Section}
+
+<a id="wrglossary.8204"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{sample1}, <a id="wrglossary.8205"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample2} and <a id="wrglossary.8206"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex}.
+
+<a id="wrglossary.8207"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> The use of <a id="wrglossary.8208"></a><a href="#glo:glslinkpresetkeys"><code class="csfmt">\glslinkpresetkeys</code></a> means that the options can override this. For example <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8209"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.8210"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=true</span>]{sample1}
+</pre> (or simply <code class="code"><a id="wrglossary.8211"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>+{sample1}</code>) will override the <a id="wrglossary.8212"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span> setting in <a id="wrglossary.8213"></a><a href="#glo:glslinkpresetkeys"><code class="csfmt">\glslinkpresetkeys</code></a>. If <a id="wrglossary.8214"></a><a href="#glo:glslinkpostsetkeys"><code class="csfmt">\glslinkpostsetkeys</code></a> is used instead, the <a id="wrglossary.8215"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span> setting will override the setting provided in the optional argument. The resulting document is shown below: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:linkcount"></a>Example 124: Link counting used to selectively suppress hyperlinks <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example124.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example124.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example124.png" type="image/png" width="307" height="228">Example document that uses link counting to selectively suppress hyperlinks.</object> </div><!-- end of resultbox -->
+<p>
+The <a id="wrglossary.8216"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a> category doesn’t have the <a id="wrglossary.8217"></a><a href="#glo:opt.catattr.linkcount"><span class="csoptfmt">linkcount</span></a> attribute set (since it’s not listed in the argument of <a id="wrglossary.8218"></a><a href="#glo:GlsXtrEnableLinkCounting"><code class="csfmt">\GlsXtrEnableLinkCounting</code></a>). This means that <a id="wrglossary.8219"></a><a href="#glo:GlsXtrLinkCounterValue"><code class="csfmt">\GlsXtrLinkCounterValue</code></a> always expands to 0 for the abbreviation (<code class="code">ex</code>), so the inequality test: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\ifnum</code><a id="wrglossary.8220"></a><a href="#glo:GlsXtrLinkCounterValue"><code class="csfmt">\GlsXtrLinkCounterValue</code></a>{<a id="wrglossary.8221"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}&gt;1
+</pre> will always be false. This means that the abbreviation won’t have <a id="wrglossary.8222"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span> applied. If the test is changed to <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\ifnum</code><a id="wrglossary.8223"></a><a href="#glo:GlsXtrLinkCounterValue"><code class="csfmt">\GlsXtrLinkCounterValue</code></a>{<a id="wrglossary.8224"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}=1
+<code class="cmd">\else</code>
+ <a id="wrglossary.8225"></a><a href="#glo:setupglslink"><code class="csfmt">\setupglslink</code></a>{<a id="wrglossary.8226"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span>}%
+<code class="cmd">\fi</code>
+</pre> Then the abbreviation will always have <a id="wrglossary.8227"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span> applied.<p>
+To reset the counter every section use the optional argument to set the parent counter: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8228"></a><a href="#glo:GlsXtrEnableLinkCounting"><code class="csfmt">\GlsXtrEnableLinkCounting</code></a>[section]{<a id="wrglossary.8229"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>}
+</pre><p>
+
+</section><!-- end of section sec:linkcount -->
+
+<section id="sec:multientries"><!-- start of section sec:multientries --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->7. Multi (or Compound) Entries<div class="labellink"><a href="#sec:multientries">[link]</a></div></h1><!-- end of chapter header -->
+<p>
+Nested entries (where the entry definition references other entries) are discussed in §<a href="#sec:nested">5.4</a>. This chapter deals with occasions where a term or phrase may consist of multiple sub-terms that are independently defined. (Examples in §<a href="#sec:exskipfirstsuffix">7.1.5</a> and §<a href="#sec:exskippostlink">7.1.6</a> provide workarounds for nested entries.)<p>
+For example, the names of bacteria, such as <span style="font-style: italic; font-variant: normal; ">Clostridium botulinum</span> and <span style="font-style: italic; font-variant: normal; ">Clostridium perfringens</span>, are made up of the genus (for example, <span style="font-style: italic; font-variant: normal; ">Clostridium</span>) and the species (for example, <span style="font-style: italic; font-variant: normal; ">botulinum</span> or <span style="font-style: italic; font-variant: normal; ">perfringens</span>). The genus is often abbreviated after <a id="wrglossary.8230"></a><a href="#glo:firstuse">first use</a>. For example, <span style="font-style: italic; font-variant: normal; ">C. botulinum</span>. However, if the name is defined as a single term consisting of both the genus and species then it’s not possible to apply the abbreviation when a different species with the same genus is used. Consider the following document: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+<a id="wrglossary.8231"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.8232"></a><a href="#glo:opt.abbrstyle.long-only-short-only"><span class="abbrstylefmt">long-only-short-only</span></a>}
+<a id="wrglossary.8233"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{cbot}{C. botulinum}{Clostridium botulinum}
+<a id="wrglossary.8234"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{cperf}{C. perfringens}{Clostridium perfringens}
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.8235"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{cbot}, <a id="wrglossary.8236"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{cbot}, <a id="wrglossary.8237"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{cperf}.
+<code class="cend">\end{document}</code>
+</pre> The result is: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+Clostridium botulinum, C. botulinum, Clostridium perfringens. </div><!-- end of resultbox -->
+ However, it should more typically be: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+Clostridium botulinum, C. botulinum, C. perfringens. </div><!-- end of resultbox -->
+ In this case, the genus should actually be a separate definition: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>{glossaries-extra}
+<a id="wrglossary.8238"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.8239"></a><a href="#glo:opt.abbrstyle.long-only-short-only"><span class="abbrstylefmt">long-only-short-only</span></a>}
+<a id="wrglossary.8240"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{clostridium}{C.}{Clostridium}
+<a id="wrglossary.8241"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{botulinum}{<a id="wrglossary.8242"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={botulinum}</span>,<a id="wrglossary.8243"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.8244"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{perfringens}{<a id="wrglossary.8245"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={perfringens}</span>,<a id="wrglossary.8246"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.8247"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{clostridium} <a id="wrglossary.8248"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{botulinum},
+<a id="wrglossary.8249"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{clostridium} <a id="wrglossary.8250"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{botulinum},
+<a id="wrglossary.8251"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{clostridium} <a id="wrglossary.8252"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{perfringens}.
+<code class="cend">\end{document}</code>
+</pre><p>
+This is quite awkward to write. This chapter describes how to provide a shortcut for this kind of construct. Each term should be defined as normal (as in the above example), and a <span class="qt">“multi-entry”</span> label is then defined with the list of labels of the entries that need to be referenced.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8253"></a><code class="code"><dfn id="glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">main-label</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label-list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This defines a multi-entry set with the label <span class="meta">〈<em class="metainner">multi-label</em>〉</span>, consisting of the entries whose labels are listed in <span class="meta">〈<em class="metainner">entry-label-list</em>〉</span>, where the main entry (which must be present in <span class="meta">〈<em class="metainner">entry-label-list</em>〉</span>) is identified by <span class="meta">〈<em class="metainner">main-label</em>〉</span>. If <span class="meta">〈<em class="metainner">main-label</em>〉</span> is omitted, it’s assumed to be the final label in <span class="meta">〈<em class="metainner">entry-label-list</em>〉</span>. The main entry is described in more detail in §<a href="#sec:mglsmain">7.2</a>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The entries in <span class="meta">〈<em class="metainner">entry-label-list</em>〉</span> must already be defined (using commands like <a id="wrglossary.8254"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> or <a id="wrglossary.8255"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>). </div><!-- end of important -->
+<p>
+The <span class="meta">〈<em class="metainner">options</em>〉</span> are a comma-separated list of options to override the current settings and are described in §<a href="#sec:multiglsoptions">7.9</a>.<p>
+The earlier example can now be modified to include the following: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8256"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a>{cbot}{clostridium,botulinum}
+<a id="wrglossary.8257"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a>{cperf}{clostridium,perfringens}
+</pre> These commands must come after the <code class="code">clostridium</code>, <code class="code">botulinum</code> and <code class="code">perfringens</code> definitions.<p>
+Once defined, a multi-entry set can be referenced in the document using commands like: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8258"></a><code class="code"><dfn id="glo:mgls"><code class="csfmt">\mgls</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.8259"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.8260"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.8261"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This command essentially does <code class="code"><a id="wrglossary.8262"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> for each item in the <span class="meta">〈<em class="metainner">label list</em>〉</span> (with separators, see §<a href="#sec:mglssep">7.4</a>). If the final optional argument <span class="meta">〈<em class="metainner">insert</em>〉</span> is provided, it will be applied to the final (non-skipped) element in the list. So the document body in the above example, can be rewritten as: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8263"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{cbot}, <a id="wrglossary.8264"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{cbot}, <a id="wrglossary.8265"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{cperf}.
+</pre><p>
+There are some variants of <a id="wrglossary.8266"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> listed in §<a href="#sec:mglslike">7.11</a>. The available <span class="meta">〈<em class="metainner">options</em>〉</span> are listed in §<a href="#sec:mglsopts">7.10</a>. They are applied after the <a id="wrglossary.8267"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a> options and will override settings for the individual entries.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+You can’t use <span class="meta">〈<em class="metainner">multi-label</em>〉</span> in commands like <a id="wrglossary.8268"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> as this label represents a set of entry labels not a single entry. </div><!-- end of important -->
+<p>
+The <a id="wrglossary.8269"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a> command will generate an error if the label has already been defined as a multi-entry.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8270"></a><code class="code"><dfn id="glo:providemultiglossaryentry"><code class="csfmt">\providemultiglossaryentry</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">main-label</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label-list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does nothing if a multi-entry set with the given label has already been defined otherwise it will act like <a id="wrglossary.8271"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a>. Notes and associated commands applying to <a id="wrglossary.8272"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a> also apply to <a id="wrglossary.8273"></a><a href="#glo:providemultiglossaryentry"><code class="csfmt">\providemultiglossaryentry</code></a> unless otherwise stated.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+<a id="wrglossary.8274"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a> may be placed anywhere after the entries listed in <span class="meta">〈<em class="metainner">label list</em>〉</span> have been defined. A multi-entry label can’t be referenced (with commands like <a id="wrglossary.8275"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>) before it has been defined. </div><!-- end of important -->
+<p>
+There is limited support for <a id="wrglossary.8276"></a><a href="#glo:opt.docdef"><span class="styoptfmt">docdef</span></a><span class="optfmt">=true</span>. The multi-entry definition can be picked up from the <a id="wrglossary.8277"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file on the next run to allow cross-references in any glossaries that occur at the start of the document. Any changes made with commands like <a id="wrglossary.8278"></a><a href="#glo:mglsSetMain"><code class="csfmt">\mglsSetMain</code></a> won’t be carried over to the next run.<p>
+By default <a id="wrglossary.8279"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a> will be localised to the current scope. If you want to globally define a multi-entry you need to first switch on global definitions with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8280"></a><code class="code"><dfn id="glo:multiglossaryentryglobaltrue"><code class="csfmt">\multiglossaryentryglobaltrue</code></dfn></code></div><!-- end of pinnedbox -->
+ To switch back to local definitions use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8281"></a><code class="code"><dfn id="glo:multiglossaryentryglobalfalse"><code class="csfmt">\multiglossaryentryglobalfalse</code></dfn></code></div><!-- end of pinnedbox -->
+ You can test if this setting is on with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8282"></a><code class="code"><dfn id="glo:ifmultiglossaryentryglobal"><code class="csfmt">\ifmultiglossaryentryglobal</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\iffalse</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+<p>
+If you want to change the multi-entry options (locally) you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8283"></a><code class="code"><dfn id="glo:mglsSetOptions"><code class="csfmt">\mglsSetOptions</code></dfn>{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}{<span class="meta">〈<em class="metainner">new-options</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This removes the original options and replaces them with <span class="meta">〈<em class="metainner">new-options</em>〉</span>. If you want to (locally) append to the existing options, use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8284"></a><code class="code"><dfn id="glo:mglsAddOptions"><code class="csfmt">\mglsAddOptions</code></dfn>{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}{<span class="meta">〈<em class="metainner">new-options</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<p>
+Note that <a id="wrglossary.8285"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a> doesn’t make any adjustments to the component entries. You will need to use the <a id="wrglossary.8286"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> key when you define the entries if you want a hierarchical structure in your <a id="wrglossary.8287"></a><a href="#glo:dual.glossary">glossary</a>. (See the example in §<a href="#sec:mglsexhier">7.1.1</a>.)<p>
+If you don’t want the other elements in the glossary, you can suppress the indexing with <a id="wrglossary.8288"></a><a href="#glo:opt.mglsopt.indexothers"><span class="csoptfmt">indexothers</span></a><span class="optfmt">=false</span> (§<a href="#sec:multiglsoptionsindexing">7.9.1</a>) or put them in an ignored glossary. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8289"></a><a href="#glo:newignoredglossary"><code class="csfmt">\newignoredglossary</code></a>{common}
+<a id="wrglossary.8290"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.8291"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={common}</span>]{clostridium}{C.}{Clostridium}
+</pre><p>
+The <span class="meta">〈<em class="metainner">multi-label</em>〉</span> can’t be used in commands like <a id="wrglossary.8292"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> since the label refers to a set of entry labels not to an individual entry. Similarly, an individual entry label can’t be used in commands like <a id="wrglossary.8293"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>. It is possible (although potentially confusing) to use the same label for a multi-entry as for an individual entry (see the example in §<a href="#sec:exskippostlink">7.1.6</a>). Context will determine which is meant, except in the case of the cross-referencing fields (<a id="wrglossary.8294"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a>, <a id="wrglossary.8295"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> and <a id="wrglossary.8296"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a>) where the cross-referenced label will first be tested if it’s a known multi-entry label.<p>
+If you don’t want to have to keep track of which labels refer to multi-entries and which refer to individual entries you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8297"></a><code class="code"><dfn id="glo:GlsXtrMglsOrGls"><code class="csfmt">\GlsXtrMglsOrGls</code></dfn>{<span class="meta">〈<em class="metainner">mgls cs</em>〉</span>}{<span class="meta">〈<em class="metainner">gls cs</em>〉</span>}<span class="meta">〈<em class="metainner">modifier</em>〉</span>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">mgls cs</em>〉</span> is the <a id="wrglossary.8298"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>-like command to use if <span class="meta">〈<em class="metainner">label</em>〉</span> has been defined as a multi-entry and <span class="meta">〈<em class="metainner">gls cs</em>〉</span> is the <a id="wrglossary.8299"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> or <a id="wrglossary.8300"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> command to use otherwise. The <span class="meta">〈<em class="metainner">modifier</em>〉</span> may be omitted, otherwise it’s the modifier that may be used with <a id="wrglossary.8301"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> or <a id="wrglossary.8302"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> (asterisk <code class="code">*</code>, plus <code class="code">+</code> or the token identified with <a id="wrglossary.8303"></a><a href="#glo:GlsXtrSetAltModifier"><code class="csfmt">\GlsXtrSetAltModifier</code></a>). The modifier and remaining options are passed to the relevant command (<span class="meta">〈<em class="metainner">mgls cs</em>〉</span> or <span class="meta">〈<em class="metainner">gls cs</em>〉</span>).<p>
+You may prefer to define your own shortcut commands for common combinations. For example, (assuming these commands haven’t already been defined by the <a id="wrglossary.8304"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a> option): <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<a id="wrglossary.8305"></a><a href="#glo:ac"><code class="csfmt">\ac</code></a>}{<a id="wrglossary.8306"></a><a href="#glo:GlsXtrMglsOrGls"><code class="csfmt">\GlsXtrMglsOrGls</code></a>{<a id="wrglossary.8307"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>}{<a id="wrglossary.8308"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>}}
+<code class="cmd">\newcommand</code>{<a id="wrglossary.8309"></a><a href="#glo:acp"><code class="csfmt">\acp</code></a>}{<a id="wrglossary.8310"></a><a href="#glo:GlsXtrMglsOrGls"><code class="csfmt">\GlsXtrMglsOrGls</code></a>{<a id="wrglossary.8311"></a><a href="#glo:mglsmainpl"><code class="csfmt">\mglsmainpl</code></a>}{<a id="wrglossary.8312"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>}}
+<code class="cmd">\newcommand</code>{<a id="wrglossary.8313"></a><a href="#glo:Ac"><code class="csfmt">\Ac</code></a>}{<a id="wrglossary.8314"></a><a href="#glo:GlsXtrMglsOrGls"><code class="csfmt">\GlsXtrMglsOrGls</code></a>{<a id="wrglossary.8315"></a><a href="#glo:Mgls"><code class="csfmt">\Mgls</code></a>}{<a id="wrglossary.8316"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>}}
+<code class="cmd">\newcommand</code>{<a id="wrglossary.8317"></a><a href="#glo:Acp"><code class="csfmt">\Acp</code></a>}{<a id="wrglossary.8318"></a><a href="#glo:GlsXtrMglsOrGls"><code class="csfmt">\GlsXtrMglsOrGls</code></a>{<a id="wrglossary.8319"></a><a href="#glo:Mglsmainpl"><code class="csfmt">\Mglsmainpl</code></a>}{<a id="wrglossary.8320"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a>}}
+</pre><p>
+
+</section><!-- end of section sec:multientries -->
+
+<section id="sec:mglsexamples"><!-- start of section sec:mglsexamples --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->7.1. Examples<div class="labellink"><a href="#sec:mglsexamples">[link]</a></div></h2><!-- end of section header -->
+<p>
+
+</section><!-- end of section sec:mglsexamples -->
+
+<section id="sec:mglsexhier"><!-- start of section sec:mglsexhier --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->7.1.1. Example: Hierarchical<div class="labellink"><a href="#sec:mglsexhier">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+Bacteria names are represented by the genus (for example, Clostridium) followed by the species (for example, botulinum). This example has the genus as a parent of the species. <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+
+<code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.8321"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a><span class="optfmt">=bookindex</span>,<a id="wrglossary.8322"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.8323"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a></span>]{glossaries-extra}
+
+<a id="wrglossary.8324"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+
+<code class="cmd">\newcommand</code>{<code class="cmd">\latinname</code>}[1]{<code class="cmd">\emph</code>{#1}}
+<a id="wrglossary.8325"></a><a href="#glo:glssetcategoriesattributes"><code class="csfmt">\glssetcategoriesattributes</code></a>
+ {genus,species}{<a id="wrglossary.8326"></a><a href="#glo:opt.catattr.textformat"><span class="csoptfmt">textformat</span></a>,<a id="wrglossary.8327"></a><a href="#glo:opt.catattr.glossnamefont"><span class="csoptfmt">glossnamefont</span></a>}{latinname}
+
+<a id="wrglossary.8328"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>[genus]{<a id="wrglossary.8329"></a><a href="#glo:opt.abbrstyle.long-only-short-only-desc"><span class="abbrstylefmt">long-only-short-only-desc</span></a>}
+<a id="wrglossary.8330"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>
+ [<a id="wrglossary.8331"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={genus}</span>,<a id="wrglossary.8332"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>]
+ {clostridium}{C.}{Clostridium}
+
+<a id="wrglossary.8333"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{botulinum}{<a id="wrglossary.8334"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={botulinum}</span>,<a id="wrglossary.8335"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={species}</span>,
+ <a id="wrglossary.8336"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,<a id="wrglossary.8337"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={clostridium}</span>}
+<a id="wrglossary.8338"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{perfringens}{<a id="wrglossary.8339"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={perfringens}</span>,
+ <a id="wrglossary.8340"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={species}</span>,<a id="wrglossary.8341"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,<a id="wrglossary.8342"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={clostridium}</span>}
+<a id="wrglossary.8343"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{tetani}{<a id="wrglossary.8344"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={tetani}</span>,<a id="wrglossary.8345"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={species}</span>,
+ <a id="wrglossary.8346"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,<a id="wrglossary.8347"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={clostridium}</span>}
+
+<a id="wrglossary.8348"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a>{cbot}{clostridium,botulinum}
+<a id="wrglossary.8349"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a>{cperf}{clostridium,perfringens}
+<a id="wrglossary.8350"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a>{ctet}{clostridium,tetani}
+
+<a id="wrglossary.8351"></a><a href="#glo:multiglossaryentrysetup"><code class="csfmt">\multiglossaryentrysetup</code></a>{<a id="wrglossary.8352"></a><a href="#glo:opt.mglsopt.indexothers"><span class="csoptfmt">indexothers</span></a><span class="optfmt">=false</span>,<a id="wrglossary.8353"></a><a href="#glo:opt.mglsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=allmain</span>}
+
+<code class="cbeg">\begin{document}</code>
+First use: <a id="wrglossary.8354"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{cbot}, <a id="wrglossary.8355"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{cperf}, <a id="wrglossary.8356"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{ctet}.
+
+Next use: <a id="wrglossary.8357"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{cbot}, <a id="wrglossary.8358"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{cperf}, <a id="wrglossary.8359"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{ctet}.
+<a id="wrglossary.8360"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> This suppresses the indexing of the non-main elements (in this case, the genus). However the genus is included in the glossary (without a <a id="wrglossary.8361"></a><a href="#glo:locationlist">location list</a>) because it’s the parent of the species (which are indexed). <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:multientryhier"></a>Example 125: Multi-entries: hierarchical <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example125.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example125.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example125.png" type="image/png" width="323" height="126">Example document with hierarchical multi-entries.</object> </div><!-- end of resultbox -->
+<p>
+The <a id="wrglossary.8362"></a><a href="#glo:opt.mglsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=allmain</span> option makes the entire content of each <a id="wrglossary.8363"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> a hyperlink to the main entry in the glossary.<p>
+
+</section><!-- end of section sec:mglsexhier -->
+
+<section id="sec:mglsexsuffix"><!-- start of section sec:mglsexsuffix --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->7.1.2. Example: Suffix<div class="labellink"><a href="#sec:mglsexsuffix">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+This example has a minor modification to the previous one. In this case the multi-entries are defined with a suffix: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8364"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a>[<a id="wrglossary.8365"></a><a href="#glo:opt.mglsopt.firstsuffix"><span class="csoptfmt">firstsuffix</span></a><span class="optfmt">=botulism</span>]{cbot}{clostridium,botulinum}
+<a id="wrglossary.8366"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a>[<a id="wrglossary.8367"></a><a href="#glo:opt.mglsopt.firstsuffix"><span class="csoptfmt">firstsuffix</span></a><span class="optfmt">=gas gangrene</span>]{cperf}{clostridium,perfringens}
+<a id="wrglossary.8368"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a>[<a id="wrglossary.8369"></a><a href="#glo:opt.mglsopt.firstsuffix"><span class="csoptfmt">firstsuffix</span></a><span class="optfmt">=tetanus</span>]{ctet}{clostridium,tetani}
+</pre> The rest of the document is as in §<a href="#sec:mglsexhier">7.1.1</a>. <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:multientryhierfirstusesuffix"></a>Example 126: Multi-entries: hierarchical with first-use suffix <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example126.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example126.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example126.png" type="image/png" width="388" height="141">Example document with hierarchical multi-entries that have a first-use suffix.</object> </div><!-- end of resultbox -->
+<p>
+
+</section><!-- end of section sec:mglsexsuffix -->
+
+<section id="sec:mglsexcatsuffix"><!-- start of section sec:mglsexcatsuffix --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->7.1.3. Example: Category Suffix<div class="labellink"><a href="#sec:mglsexcatsuffix">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+This is an alternative to the previous example. Instead of storing the extra information in the <a id="wrglossary.8370"></a><a href="#glo:opt.mglsopt.firstsuffix"><span class="csoptfmt">firstsuffix</span></a> key, the information is stored in the <a id="wrglossary.8371"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key of the last element (the species). A category suffix is used to look up the field and append it. <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8372"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{botulinum}{<a id="wrglossary.8373"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={botulinum}</span>,<a id="wrglossary.8374"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={species}</span>,
+ <a id="wrglossary.8375"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={botulism}</span>,
+ <a id="wrglossary.8376"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,<a id="wrglossary.8377"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={clostridium}</span>}
+<a id="wrglossary.8378"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{perfringens}{<a id="wrglossary.8379"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={perfringens}</span>,<a id="wrglossary.8380"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={species}</span>,
+ <a id="wrglossary.8381"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={gas gangrene}</span>,
+ <a id="wrglossary.8382"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,<a id="wrglossary.8383"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={clostridium}</span>}
+<a id="wrglossary.8384"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{tetani}{<a id="wrglossary.8385"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={tetani}</span>,<a id="wrglossary.8386"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={species}</span>,
+ <a id="wrglossary.8387"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={tetanus}</span>,
+ <a id="wrglossary.8388"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,<a id="wrglossary.8389"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={clostridium}</span>}
+
+<a id="wrglossary.8390"></a><a href="#glo:mglsdefcategorysuffix"><code class="csfmt">\mglsdefcategorysuffix</code></a>{bacteria}{%
+ <a id="wrglossary.8391"></a><a href="#glo:mglsisfirstuse"><code class="csfmt">\mglsisfirstuse</code></a>
+ {<a id="wrglossary.8392"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a>{useri}{<a id="wrglossary.8393"></a><a href="#glo:mglslastelementlabel"><code class="csfmt">\mglslastelementlabel</code></a>}{ (<a id="wrglossary.8394"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a>)}}%
+ {}%
+}
+
+<a id="wrglossary.8395"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a>[category=bacteria]{cbot}{clostridium,botulinum}
+<a id="wrglossary.8396"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a>[category=bacteria]{cperf}{clostridium,perfringens}
+<a id="wrglossary.8397"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a>[category=bacteria]{ctet}{clostridium,tetani}
+</pre> The result is the same as the previous example. <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:multientryhiercatsuffix"></a>Example 127: Multi-entries: hierarchical with category suffix <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example127.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example127.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example127.png" type="image/png" width="388" height="141">Example document with hierarchical multi-entries that have a category suffix.</object> </div><!-- end of resultbox -->
+<p>
+
+</section><!-- end of section sec:mglsexcatsuffix -->
+
+<section id="sec:mglsexsep"><!-- start of section sec:mglsexsep --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->7.1.4. Example: Separators<div class="labellink"><a href="#sec:mglsexsep">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+The first example (§<a href="#sec:mglsexhier">7.1.1</a>) can be modified so that the species are also abbreviations. In this case, the separators are modified to suppress the space (<a id="wrglossary.8398"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a>) if both the genus and species are abbreviated, or to use a <a id="wrglossary.8399"></a><a href="#glo:idx.nbsp">non-breaking space (<code class="code">~</code>)</a> between the genus short form (shown on subsequent use) and the species long form (shown on <a id="wrglossary.8400"></a><a href="#glo:dual.firstuse">first use</a>). If the genus is showing the long form (<a id="wrglossary.8401"></a><a href="#glo:dual.firstuse">first use</a>) then a normal space is used.<p>
+Note that the separator attributes apply to the category of the element before the separator (not to the multi-entry category). <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8402"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{genus}{<a id="wrglossary.8403"></a><a href="#glo:opt.catattr.combinedfirstsepfirst"><span class="csoptfmt">combinedfirstsepfirst</span></a>}{<code class="cmd">\space</code>}
+<a id="wrglossary.8404"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{genus}{<a id="wrglossary.8405"></a><a href="#glo:opt.catattr.combinedfirstsep"><span class="csoptfmt">combinedfirstsep</span></a>}{<code class="cmd">\space</code>}
+<a id="wrglossary.8406"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{genus}{<a id="wrglossary.8407"></a><a href="#glo:opt.catattr.combinedsepfirst"><span class="csoptfmt">combinedsepfirst</span></a>}{<a id="wrglossary.8408"></a><a href="#glo:idx.nbsp"><span title="non-breaking space (\code{~})" class="icon"><code class="code">~</code></span></a>}
+<a id="wrglossary.8409"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{genus}{<a id="wrglossary.8410"></a><a href="#glo:opt.catattr.combinedsep"><span class="csoptfmt">combinedsep</span></a>}{<a id="wrglossary.8411"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a>}
+
+<a id="wrglossary.8412"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>[species]{<a id="wrglossary.8413"></a><a href="#glo:opt.abbrstyle.long-only-short-only-desc"><span class="abbrstylefmt">long-only-short-only-desc</span></a>}
+
+<a id="wrglossary.8414"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.8415"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={species}</span>,
+ <a id="wrglossary.8416"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,<a id="wrglossary.8417"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={clostridium}</span>]{botulinum}{bot.}{botulinum}
+<a id="wrglossary.8418"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.8419"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={species}</span>,
+ <a id="wrglossary.8420"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,<a id="wrglossary.8421"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={clostridium}</span>]{perfringens}{per.}{perfringens}
+<a id="wrglossary.8422"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>[<a id="wrglossary.8423"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={species}</span>,
+ <a id="wrglossary.8424"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,<a id="wrglossary.8425"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={clostridium}</span>]{tetani}{tet.}{tetani}
+</pre> This will cause a double dot at the end of the second sentence, which can be suppressed using the <a id="wrglossary.8426"></a><a href="#glo:opt.catattr.discardperiod"><span class="csoptfmt">discardperiod</span></a> and <a id="wrglossary.8427"></a><a href="#glo:opt.catattr.retainfirstuseperiod"><span class="csoptfmt">retainfirstuseperiod</span></a> attributes. <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8428"></a><a href="#glo:glssetcategoriesattributes"><code class="csfmt">\glssetcategoriesattributes</code></a>{species}{<a id="wrglossary.8429"></a><a href="#glo:opt.catattr.discardperiod"><span class="csoptfmt">discardperiod</span></a>,<a id="wrglossary.8430"></a><a href="#glo:opt.catattr.retainfirstuseperiod"><span class="csoptfmt">retainfirstuseperiod</span></a>}{true}
+</pre> This works because the final element’s <a id="wrglossary.8431"></a><a href="#glo:dual.postlinkhook">post-link hook</a> is transferred to the multi-entry post-link hook, which can detect the sentence terminating period. If the post-link hook settings are changed, for example, to <code class="code"><a id="wrglossary.8432"></a><a href="#glo:opt.mglsopt.postlinks"><span class="csoptfmt">postlinks</span></a><span class="optfmt">=all</span>,<a id="wrglossary.8433"></a><a href="#glo:opt.mglsopt.mpostlink"><span class="csoptfmt">mpostlink</span></a><span class="optfmt">=false</span></code> then the feature won’t work as the final element’s <a id="wrglossary.8434"></a><a href="#glo:dual.postlinkhook">post-link hook</a> can’t detect the period (because <a id="wrglossary.8435"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> is embedded too deeply inside the internal workings of <a id="wrglossary.8436"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>). <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:multientrysep"></a>Example 128: Multi-entries: separators <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example128.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example128.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example128.png" type="image/png" width="323" height="126">Example document demonstrating multi-entry separators.</object> </div><!-- end of resultbox -->
+<p>
+
+</section><!-- end of section sec:mglsexsep -->
+
+<section id="sec:exskipfirstsuffix"><!-- start of section sec:exskipfirstsuffix --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->7.1.5. Example: Skipping Elements (Fragment Element)<div class="labellink"><a href="#sec:exskipfirstsuffix">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+This example is an alternative way of dealing with nested links (see §<a href="#sec:nested">5.4</a>). <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+
+<code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.8437"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a>,<a id="wrglossary.8438"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.8439"></a><a href="#glo:opt.glostyle.long"><span class="glostylefmt">long</span></a></span>]{glossaries-extra}
+
+<a id="wrglossary.8440"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+
+<a id="wrglossary.8441"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.8442"></a><a href="#glo:opt.abbrstyle.long-short-sc"><span class="abbrstylefmt">long-short-sc</span></a>}
+<a id="wrglossary.8443"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ssi}{ssi}{server-side includes}
+<a id="wrglossary.8444"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{html}{html}{hypertext markup language}
+
+<a id="wrglossary.8445"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>[combinedabbrv]{<a id="wrglossary.8446"></a><a href="#glo:opt.abbrstyle.long-only-short-sc-only"><span class="abbrstylefmt">long-only-short-sc-only</span></a>}
+<a id="wrglossary.8447"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>
+ [<a id="wrglossary.8448"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={combinedabbrv}</span>,
+ <a id="wrglossary.8449"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={<a id="wrglossary.8450"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>{ssi} enabled <a id="wrglossary.8451"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>{html}}</span>]
+ {shtml-frag}{shtml}{enabled}
+
+<a id="wrglossary.8452"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{combinedabbrv}{multioptions}
+ {<a id="wrglossary.8453"></a><a href="#glo:opt.mglsopt.usedskipothers"><span class="csoptfmt">usedskipothers</span></a><span class="optfmt">=,</span><a id="wrglossary.8454"></a><a href="#glo:opt.mglsopt.firstsuffix"><span class="csoptfmt">firstsuffix</span></a><span class="optfmt">=<a id="wrglossary.8455"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>{<a id="wrglossary.8456"></a><a href="#glo:mglslastmainlabel"><code class="csfmt">\mglslastmainlabel</code></a>}</span>}
+
+<a id="wrglossary.8457"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a>
+ [<a id="wrglossary.8458"></a><a href="#glo:opt.mglsopt.category"><span class="csoptfmt">category</span></a><span class="optfmt">=combinedabbrv</span>]
+ {shtml}[shtml-frag]{ssi,shtml-frag,html}
+
+<code class="cbeg">\begin{document}</code>
+Individual elements first use: <a id="wrglossary.8459"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi} and <a id="wrglossary.8460"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>html.
+
+Individual elements next use: <a id="wrglossary.8461"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi} and <a id="wrglossary.8462"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+
+Multi-entry first use: <a id="wrglossary.8463"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{shtml}.
+
+Multi-entry next use: <a id="wrglossary.8464"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{shtml}.
+
+Resetting all<a id="wrglossary.8465"></a><a href="#glo:glsresetall"><code class="csfmt">\glsresetall</code></a><a id="wrglossary.8466"></a><a href="#glo:mglsreset"><code class="csfmt">\mglsreset</code></a>{shtml}:
+
+Multi-entry first use: <a id="wrglossary.8467"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{shtml}.
+
+Multi-entry next use: <a id="wrglossary.8468"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{shtml}.
+
+Individual elements: <a id="wrglossary.8469"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi} and <a id="wrglossary.8470"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+<a id="wrglossary.8471"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre><p>
+This uses the <a id="wrglossary.8472"></a><a href="#glo:opt.catattr.multioptions"><span class="csoptfmt">multioptions</span></a> attribute to skip <span class="qt">“other”</span> elements on subsequent use. The problematic abbreviation (SHTML) is defined as a fragment that simply expands to <span class="qt">“enabled”</span> on first use. Note that the description has to be supplied for the glossary. The resulting document is shown below. <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:multientryskip"></a>Example 129: Multi-entries: skipping elements <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example129.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example129.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example129.png" type="image/png" width="388" height="261">Example document demonstrating multi-entry sets with elements skipped.</object> </div><!-- end of resultbox -->
+<p>
+The key difference here from the example using <a id="wrglossary.8473"></a><a href="#glo:glsps"><code class="csfmt">\glsps</code></a> at the end of §<a href="#sec:nested">5.4</a> is that the individual elements hyperlink to their respective entries in the glossary on first use of <a id="wrglossary.8474"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>.<p>
+The problem is that with the <span class="optfmt">colorlinks</span> package option, it’s not obvious where the hyperlinks start and end. The suffix (<span style="font-style: normal; font-variant: small-caps; ">shtml</span>) will hyperlink to the <span class="qt">“shtml”</span> entry in the glossary, so the <span class="qt">“enabled”</span> hyperlink is redundant. The simplest fix for this is to add <a id="wrglossary.8475"></a><a href="#glo:opt.mglsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=notmainfirst</span> to the option list, which will prevent <span class="qt">“enabled”</span> from being a hyperlink.<p>
+Another problem occurs where <a id="wrglossary.8476"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> is used before the individual elements are used, which leads to their full expansion with a confusing amount of parentheses. A simple solution is to use the option <a id="wrglossary.8477"></a><a href="#glo:opt.mglsopt.mglsopts"><span class="csoptfmt">mglsopts</span></a><span class="optfmt">=unsetothers</span>, which will unset the other (not-main) elements first. This can be localised with <a id="wrglossary.8478"></a><a href="#glo:opt.mglsopt.presetlocal"><span class="csoptfmt">presetlocal</span></a> but <a id="wrglossary.8479"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> will then unset the <a id="wrglossary.8480"></a><a href="#glo:dual.firstuseflag">first use flag</a> globally, which means that the other elements won’t show the full form when they are first used on their on after <a id="wrglossary.8481"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>. This can be switched to a local unset with <a id="wrglossary.8482"></a><a href="#glo:opt.mglsopt.others"><span class="csoptfmt">others</span></a><span class="optfmt">=local</span>.<p>
+The complete set of options are now: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8483"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{combinedabbrv}{<a id="wrglossary.8484"></a><a href="#glo:opt.catattr.multioptions"><span class="csoptfmt">multioptions</span></a>}
+ {%
+ <a id="wrglossary.8485"></a><a href="#glo:opt.mglsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=notmainfirst</span>,
+ <a id="wrglossary.8486"></a><a href="#glo:opt.mglsopt.mglsopts"><span class="csoptfmt">mglsopts</span></a><span class="optfmt">=<a id="wrglossary.8487"></a><a href="#glo:opt.mglsopt.presetlocal"><span class="csoptfmt">presetlocal</span></a>,<a id="wrglossary.8488"></a><a href="#glo:opt.mglsopt.unsetothers"><span class="csoptfmt">unsetothers</span></a>,<a id="wrglossary.8489"></a><a href="#glo:opt.mglsopt.others"><span class="csoptfmt">others</span></a><span class="optfmt">=local</span></span>,
+ <a id="wrglossary.8490"></a><a href="#glo:opt.mglsopt.usedskipothers"><span class="csoptfmt">usedskipothers</span></a><span class="optfmt">=,</span>
+ <a id="wrglossary.8491"></a><a href="#glo:opt.mglsopt.firstsuffix"><span class="csoptfmt">firstsuffix</span></a><span class="optfmt">={</span>}<a id="wrglossary.8492"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>{<a id="wrglossary.8493"></a><a href="#glo:mglslastmainlabel"><code class="csfmt">\mglslastmainlabel</code></a>}
+ }
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:multientryskipunsetothers"></a>Example 130: Multi-entries: skipping elements (unsetting others) <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example130.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example130.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example130.png" type="image/png" width="388" height="261">Example document demonstrating multi-entry sets with elements skipped and unset.</object> </div><!-- end of resultbox -->
+<p>
+This method still has two main drawbacks: the description must be added manually and the long form can’t be accessed with <a id="wrglossary.8494"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a>. The next example provides an alternative approach.<p>
+
+</section><!-- end of section sec:exskipfirstsuffix -->
+
+<section id="sec:exskippostlink"><!-- start of section sec:exskippostlink --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->7.1.6. Example: Skipping Elements (Prefix and Post-Link Hooks)<div class="labellink"><a href="#sec:exskippostlink">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+This is a modified version of the previous example. In this case, the main element isn’t a fragment and also happens to have the same label as the multi-entry set. (<code class="code"><a id="wrglossary.8495"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{shtml}</code> references the multi-entry label and <code class="code"><a id="wrglossary.8496"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{shtml}</code> references the individual entry.)<p>
+In this case, the nested parts are marked up with custom commands: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newrobustcmd</code>{<code class="cmd">\combinedpre</code>}[1]{<a id="wrglossary.8497"></a><a href="#glo:glsps"><code class="csfmt">\glsps</code></a>{#1}}
+<code class="cmd">\newrobustcmd</code>{<code class="cmd">\combinedpost</code>}[1]{<a id="wrglossary.8498"></a><a href="#glo:glsps"><code class="csfmt">\glsps</code></a>{#1}}
+
+<a id="wrglossary.8499"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{shtml}{shtml}
+{{}<code class="cmd">\combinedpre</code>{ssi} enabled <code class="cmd">\combinedpost</code>{html}}
+</pre><p>
+This means that it’s no longer necessary to manually insert the description and the long form can be accessed as usual with <code class="code"><a id="wrglossary.8500"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>{shtml}</code>. Note that it is necessary to define the custom commands robustly otherwise they will need to be protected against premature expansion: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<code class="cmd">\combinedpre</code>}[1]{<a id="wrglossary.8501"></a><a href="#glo:glsps"><code class="csfmt">\glsps</code></a>{#1}}
+<code class="cmd">\newcommand</code>{<code class="cmd">\combinedpost</code>}[1]{<a id="wrglossary.8502"></a><a href="#glo:glsps"><code class="csfmt">\glsps</code></a>{#1}}
+
+<a id="wrglossary.8503"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{shtml}{shtml}
+{{}<a id="wrglossary.8504"></a><a href="#glo:protect"><code class="csfmt">\protect</code></a><code class="cmd">\combinedpre</code>{ssi} enabled <a id="wrglossary.8505"></a><a href="#glo:protect"><code class="csfmt">\protect</code></a><code class="cmd">\combinedpost</code>{html}}
+</pre> In both cases, an initial empty group is added to guard against any <a id="wrglossary.8506"></a><a href="#glo:idx.sentencecase">sentence case</a> commands, such as <a id="wrglossary.8507"></a><a href="#glo:Glsxtrlong"><code class="csfmt">\Glsxtrlong</code></a>.<p>
+The abbreviations all use the <a id="wrglossary.8508"></a><a href="#glo:opt.abbrstyle.long-postshort-sc-user"><span class="abbrstylefmt">long-postshort-sc-user</span></a> style, which places the short form in the post-link hook on <a id="wrglossary.8509"></a><a href="#glo:dual.firstuse">first use</a>. The <a id="wrglossary.8510"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> <a id="wrglossary.8511"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the main element can be transferred to the <a id="wrglossary.8512"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> post-link using: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8513"></a><a href="#glo:opt.mglsopt.mpostlinkelement"><span class="csoptfmt">mpostlinkelement</span></a><span class="optfmt">=main</span>
+</pre> All elements have their individual post-link hooks suppressed by default. As in the previous example, the other elements can be skipped on subsequent use: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8514"></a><a href="#glo:opt.mglsopt.usedskipothers"><span class="csoptfmt">usedskipothers</span></a>
+</pre><p>
+Within <a id="wrglossary.8515"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>, the nested content needs to be suppressed, which can be done by redefining the custom commands. This can be done in the multi-entry prefix. Since the entire content of <a id="wrglossary.8516"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> (except for the final multi-entry post-link hook) occurs inside a group, this redefinition will be localised.<p>
+The complete document is as follows: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+
+<code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.8517"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a>,<a id="wrglossary.8518"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.8519"></a><a href="#glo:opt.glostyle.long"><span class="glostylefmt">long</span></a></span>]{glossaries-extra}
+
+<a id="wrglossary.8520"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+
+<a id="wrglossary.8521"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.8522"></a><a href="#glo:opt.abbrstyle.long-postshort-sc-user"><span class="abbrstylefmt">long-postshort-sc-user</span></a>}
+
+<a id="wrglossary.8523"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ssi}{ssi}{server-side includes}
+<a id="wrglossary.8524"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{html}{html}{hypertext markup language}
+
+<code class="cmd">\newrobustcmd</code>{<code class="cmd">\combinedpre</code>}[1]{<a id="wrglossary.8525"></a><a href="#glo:glsps"><code class="csfmt">\glsps</code></a>{#1}}
+<code class="cmd">\newrobustcmd</code>{<code class="cmd">\combinedpost</code>}[1]{<a id="wrglossary.8526"></a><a href="#glo:glsps"><code class="csfmt">\glsps</code></a>{#1}}
+
+<code class="cmd">\newabbreviation</code>{shtml}{shtml}
+{{}<code class="cmd">\combinedpre</code>{ssi} enabled <code class="cmd">\combinedpost</code>{html}}
+
+<a id="wrglossary.8527"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{combinedabbrv}{<a id="wrglossary.8528"></a><a href="#glo:opt.catattr.multioptions"><span class="csoptfmt">multioptions</span></a>}
+ {%
+ <a id="wrglossary.8529"></a><a href="#glo:opt.mglsopt.mpostlinkelement"><span class="csoptfmt">mpostlinkelement</span></a><span class="optfmt">=main</span>,
+ <a id="wrglossary.8530"></a><a href="#glo:opt.mglsopt.usedskipothers"><span class="csoptfmt">usedskipothers</span></a>
+ }
+
+<a id="wrglossary.8531"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a>
+ [<a id="wrglossary.8532"></a><a href="#glo:opt.mglsopt.category"><span class="csoptfmt">category</span></a><span class="optfmt">=combinedabbrv</span>]
+ {shtml}[shtml]{ssi,shtml,html}
+
+<a id="wrglossary.8533"></a><a href="#glo:mglsdefcategoryprefix"><code class="csfmt">\mglsdefcategoryprefix</code></a>{combinedabbrv}{%
+ <code class="cmd">\renewcommand</code>{<code class="cmd">\combinedpre</code>}[1]{<code class="cmd">\ignorespaces</code>}%
+ <code class="cmd">\renewcommand</code>{<code class="cmd">\combinedpost</code>}[1]{<a id="wrglossary.8534"></a><a href="#glo:unskip"><code class="csfmt">\unskip</code></a>}%
+}
+
+<code class="cbeg">\begin{document}</code>
+Individual elements first use: <a id="wrglossary.8535"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi} and <a id="wrglossary.8536"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+
+Individual elements next use: <a id="wrglossary.8537"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi} and <a id="wrglossary.8538"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+
+Multi-entry first use: <a id="wrglossary.8539"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{shtml}.
+
+Multi-entry next use: <a id="wrglossary.8540"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{shtml}.
+
+Individual entry first use: <a id="wrglossary.8541"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{shtml}.
+
+Resetting all<a id="wrglossary.8542"></a><a href="#glo:glsresetall"><code class="csfmt">\glsresetall</code></a><a id="wrglossary.8543"></a><a href="#glo:mglsresetall"><code class="csfmt">\mglsresetall</code></a>:
+
+Multi-entry first use: <a id="wrglossary.8544"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{shtml}.
+
+Multi-entry next use: <a id="wrglossary.8545"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{shtml}.
+
+Individual elements: <a id="wrglossary.8546"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi} and <a id="wrglossary.8547"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+
+Resetting all<a id="wrglossary.8548"></a><a href="#glo:glsresetall"><code class="csfmt">\glsresetall</code></a><a id="wrglossary.8549"></a><a href="#glo:mglsresetall"><code class="csfmt">\mglsresetall</code></a>:
+
+Individual entry first use: <a id="wrglossary.8550"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{shtml}.
+
+Multi-entry first use: <a id="wrglossary.8551"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{shtml}. (Wrong!)
+
+<a id="wrglossary.8552"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> This now produces: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:multientryskipprefixpostlink"></a>Example 131: Multi-entries: skipping elements (prefix and post-link hooks) <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example131.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example131.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example131.png" type="image/png" width="388" height="333">Example document demonstrating multi-entry sets with elements skipped and prefix and post-link hooks.</object> </div><!-- end of resultbox -->
+ Note the last two paragraphs, which highlights what happens if <code class="code"><a id="wrglossary.8553"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{shtml}</code> is used before <code class="code"><a id="wrglossary.8554"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{shtml}</code> when neither of the other elements (<code class="code">ssi</code> and <code class="code">html</code>) have been used. The final instance of <a id="wrglossary.8555"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> has produced the wrong result. This is because it’s the first use of the multi-entry <code class="code">shtml</code> but not the first use of the individual entry <code class="code">shtml</code>.<p>
+One way around this is to modify the prefix to ensure that the main element’s <a id="wrglossary.8556"></a><a href="#glo:dual.firstuseflag">first use flag</a> matches the multi-entry’s first use flag: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8557"></a><a href="#glo:mglsdefcategoryprefix"><code class="csfmt">\mglsdefcategoryprefix</code></a>{combinedabbrv}{%
+ <code class="cmd">\renewcommand</code>{<code class="cmd">\combinedpre</code>}[1]{<code class="cmd">\ignorespaces</code>}%
+ <code class="cmd">\renewcommand</code>{<code class="cmd">\combinedpost</code>}[1]{<a id="wrglossary.8558"></a><a href="#glo:unskip"><code class="csfmt">\unskip</code></a>}%
+ <a id="wrglossary.8559"></a><a href="#glo:mglsisfirstuse"><code class="csfmt">\mglsisfirstuse</code></a>
+ {<a id="wrglossary.8560"></a><a href="#glo:glslocalreset"><code class="csfmt">\glslocalreset</code></a>{<a id="wrglossary.8561"></a><a href="#glo:mglscurrentmainlabel"><code class="csfmt">\mglscurrentmainlabel</code></a>}}%
+ {<a id="wrglossary.8562"></a><a href="#glo:glslocalunset"><code class="csfmt">\glslocalunset</code></a>{<a id="wrglossary.8563"></a><a href="#glo:mglscurrentmainlabel"><code class="csfmt">\mglscurrentmainlabel</code></a>}}%
+}
+</pre><p>
+The <a id="wrglossary.8564"></a><a href="#glo:opt.showtargets"><span class="styoptfmt">showtargets</span></a><span class="optfmt">=</span><a id="wrglossary.8565"></a><a href="#glo:optval.showtargets.annoteleft"><span class="optfmt">annoteleft</span></a> option can be used to mark up the links with the targets. For example, the first instance of <code class="code"><a id="wrglossary.8566"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{shtml}</code> will show as: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+Multi-entry first use: <span class="glsshowtargetfonttext">[glo:ssi]</span>◁<span style="font-style: normal; font-variant: small-caps; ">ssi</span>▷ <span class="glsshowtargetfonttext">[glo:shtml]</span>◁enabled▷ <span class="glsshowtargetfonttext">[glo:html]</span>◁<span style="font-style: normal; font-variant: small-caps; ">html</span>▷ (<span style="font-style: normal; font-variant: small-caps; ">shtml</span>). </div><!-- end of resultbox -->
+ Each entry has an individual hyperlink to its own glossary item, which may be confusing. This can be made clearer by suppressing the main element link on first use with: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8567"></a><a href="#glo:opt.mglsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=notmainfirst</span>
+</pre> (as in the previous example), and adjusting the abbreviation style so that the parenthetical content in the post-link hook has a hyperlink: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.8568"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a>}[2]{%
+ <a id="wrglossary.8569"></a><a href="#glo:glsxtrfullsep"><code class="csfmt">\glsxtrfullsep</code></a>{#2}%
+ <a id="wrglossary.8570"></a><a href="#glo:glsxtrparen"><code class="csfmt">\glsxtrparen</code></a>
+ {<a id="wrglossary.8571"></a><a href="#glo:glshyperlink"><code class="csfmt">\glshyperlink</code></a>[#1]{#2}%
+ <a id="wrglossary.8572"></a><a href="#glo:ifglshasfield"><code class="csfmt">\ifglshasfield</code></a>{<a id="wrglossary.8573"></a><a href="#glo:glsxtruserfield"><code class="csfmt">\glsxtruserfield</code></a>}{#2}{, <a id="wrglossary.8574"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a>}{}%
+ }%
+}
+</pre><p>
+The remaining problem is how to deal with the possibility that <code class="code"><a id="wrglossary.8575"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{shtml}</code> may come before the <a id="wrglossary.8576"></a><a href="#glo:dual.firstuse">first use</a> of the other elements. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>Multi-entry first use: <a id="wrglossary.8577"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{shtml}.
+
+Individual elements: <a id="wrglossary.8578"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>ssi and <a id="wrglossary.8579"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+</pre> This leads to: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+Multi-entry first use: server-side includes enabled hypertext markup language (<span style="font-style: normal; font-variant: small-caps; ">shtml</span>).<p>
+Individual elements: <span style="font-style: normal; font-variant: small-caps; ">ssi</span> and <span style="font-style: normal; font-variant: small-caps; ">html</span>. </div><!-- end of resultbox -->
+<p>
+This means that the abbreviations <span style="font-style: normal; font-variant: small-caps; ">ssi</span> and <span style="font-style: normal; font-variant: small-caps; ">html</span> aren’t explained in the document text. One way around this is to only locally unset the other element <a id="wrglossary.8580"></a><a href="#glo:dual.firstuseflag">first use flags</a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8581"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{combinedabbrv}{<a id="wrglossary.8582"></a><a href="#glo:opt.catattr.multioptions"><span class="csoptfmt">multioptions</span></a>}
+ {%
+ <a id="wrglossary.8583"></a><a href="#glo:opt.mglsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=notmainfirst</span>,
+ <a id="wrglossary.8584"></a><a href="#glo:opt.mglsopt.mpostlinkelement"><span class="csoptfmt">mpostlinkelement</span></a><span class="optfmt">=main</span>,
+ <a id="wrglossary.8585"></a><a href="#glo:opt.mglsopt.usedskipothers"><span class="csoptfmt">usedskipothers</span></a><span class="optfmt">=,</span>
+ <a id="wrglossary.8586"></a><a href="#glo:opt.mglsopt.mglsopts"><span class="csoptfmt">mglsopts</span></a><span class="optfmt">=<a id="wrglossary.8587"></a><a href="#glo:opt.mglsopt.others"><span class="csoptfmt">others</span></a><span class="optfmt">=local</span></span>
+ }
+</pre> With the above setting, the following: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8588"></a><a href="#glo:glsresetall"><code class="csfmt">\glsresetall</code></a><a id="wrglossary.8589"></a><a href="#glo:mglsresetall"><code class="csfmt">\mglsresetall</code></a>
+
+Multi-entry first use: <a id="wrglossary.8590"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{shtml}.
+
+Multi-entry next use: <a id="wrglossary.8591"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>{shtml}.
+
+Individual elements: <a id="wrglossary.8592"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi} and <a id="wrglossary.8593"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+</pre> will now produce: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+Multi-entry first use: server-side includes enabled hypertext markup language (<span style="font-style: normal; font-variant: small-caps; ">shtml</span>).<p>
+Multi-entry next use: <span style="font-style: normal; font-variant: small-caps; ">shtml</span>.<p>
+Individual elements: server-side includes (<span style="font-style: normal; font-variant: small-caps; ">ssi</span>) and hypertext markup language (<span style="font-style: normal; font-variant: small-caps; ">html</span>). </div><!-- end of resultbox -->
+<p>
+
+</section><!-- end of section sec:exskippostlink -->
+
+<section id="sec:mglsmain"><!-- start of section sec:mglsmain --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->7.2. Main and Other Elements<div class="labellink"><a href="#sec:mglsmain">[link]</a></div></h2><!-- end of section header -->
+<p>
+The list of labels provided in the final argument of <a id="wrglossary.8594"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a> consists of a main element and all the other elements. If the main element isn’t identified in the optional argument, it’s assumed to be the final element in the list.<p>
+The main element allows you to determine which target to use if you want the entire content of <a id="wrglossary.8595"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> to be a single hyperlink. You can also use the settings described in §<a href="#sec:multiglsoptions">7.9</a> to only index the main element.<p>
+You can change the main element using: <a id="wrglossary.8596"></a><a href="#glo:mglsSetMain"><code class="csfmt">\mglsSetMain</code></a> The new main label provided in the second argument must be in the list corresponding to <span class="meta">〈<em class="metainner">multi-label</em>〉</span>. This change is locally applied to the current scope. Note that if you are using <a id="wrglossary.8597"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, this change in the document can’t be detected.<p>
+The main element can also be used to identify which element should be displayed in the plural with <a id="wrglossary.8598"></a><a href="#glo:mglsmainpl"><code class="csfmt">\mglsmainpl</code></a>. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8599"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{great}{<a id="wrglossary.8600"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={great}</span>,<a id="wrglossary.8601"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.8602"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{little}{<a id="wrglossary.8603"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={little}</span>,<a id="wrglossary.8604"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.8605"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{grebe}{<a id="wrglossary.8606"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={grebe}</span>,<a id="wrglossary.8607"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+
+<a id="wrglossary.8608"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a>{greatgrebe}{great,grebe}
+<a id="wrglossary.8609"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a>{littlegrebe}{little,grebe}
+</pre> In the above, two multi-entries are defined: <code class="code">greatgrebe</code> and <code class="code">littlegrebe</code>. In both cases the main element is <code class="code">grebe</code> (the last element). Using <a id="wrglossary.8610"></a><a href="#glo:mglspl"><code class="csfmt">\mglspl</code></a> will show the plural for all elements, but using <a id="wrglossary.8611"></a><a href="#glo:mglsmainpl"><code class="csfmt">\mglsmainpl</code></a> will only use the plural for the main element (grebe). For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>Plural all: <a id="wrglossary.8612"></a><a href="#glo:mglspl"><code class="csfmt">\mglspl</code></a>{greatgrebe}, <a id="wrglossary.8613"></a><a href="#glo:mglspl"><code class="csfmt">\mglspl</code></a>{littlegrebe}.
+Plural main: <a id="wrglossary.8614"></a><a href="#glo:mglsmainpl"><code class="csfmt">\mglsmainpl</code></a>{greatgrebe}, <a id="wrglossary.8615"></a><a href="#glo:mglsmainpl"><code class="csfmt">\mglsmainpl</code></a>{littlegrebe}.
+</pre> produces: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+Plural all: greats grebes, littles grebes. Plural main: great grebes, little grebes. </div><!-- end of resultbox -->
+<p>
+
+</section><!-- end of section sec:mglsmain -->
+
+<section id="sec:mglsfixes"><!-- start of section sec:mglsfixes --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->7.3. Prefixes and Suffixes<div class="labellink"><a href="#sec:mglsfixes">[link]</a></div></h2><!-- end of section header -->
+<p>
+A multi-entry may have associated prefixes and suffixes. These are scoped and are placed outside of the hyperlinks and encapsulating commands. They are not affected by case-changing commands, such as <a id="wrglossary.8616"></a><a href="#glo:Mgls"><code class="csfmt">\Mgls</code></a>. If you want a prefix to obey case-changing, use the <a id="wrglossary.8617"></a><a href="#glo:mpgls"><code class="csfmt">\mpgls</code></a>-like commands instead (§<a href="#sec:mpgls">7.11.4</a>).<p>
+The prefix is inserted with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8618"></a><code class="code"><dfn id="glo:mglsprefix"><code class="csfmt">\mglsprefix</code></dfn></code></div><!-- end of pinnedbox -->
+ The default definition is: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.8619"></a><a href="#glo:mglsprefix"><code class="csfmt">\mglsprefix</code></a>}{%
+ <a id="wrglossary.8620"></a><a href="#glo:ifdefempty"><code class="csfmt">\ifdefempty</code></a><a id="wrglossary.8621"></a><a href="#glo:mglscurrentcategory"><code class="csfmt">\mglscurrentcategory</code></a>
+ {<a id="wrglossary.8622"></a><a href="#glo:mglscurrentprefix"><code class="csfmt">\mglscurrentprefix</code></a>}%
+ {%
+ <a id="wrglossary.8623"></a><a href="#glo:mglshascategoryprefix"><code class="csfmt">\mglshascategoryprefix</code></a>{<a id="wrglossary.8624"></a><a href="#glo:mglscurrentcategory"><code class="csfmt">\mglscurrentcategory</code></a>}%
+ {<a id="wrglossary.8625"></a><a href="#glo:mglsusecategoryprefix"><code class="csfmt">\mglsusecategoryprefix</code></a>{<a id="wrglossary.8626"></a><a href="#glo:mglscurrentcategory"><code class="csfmt">\mglscurrentcategory</code></a>}}%
+ {<a id="wrglossary.8627"></a><a href="#glo:mglscurrentprefix"><code class="csfmt">\mglscurrentprefix</code></a>}%
+ }%
+}
+</pre> This will insert the current prefix unless there is prefix command associated with the current category.<p>
+The suffix is inserted with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8628"></a><code class="code"><dfn id="glo:mglssuffix"><code class="csfmt">\mglssuffix</code></dfn></code></div><!-- end of pinnedbox -->
+ This command is defined as follows: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.8629"></a><a href="#glo:mglssuffix"><code class="csfmt">\mglssuffix</code></a>}{%
+ <a id="wrglossary.8630"></a><a href="#glo:ifdefempty"><code class="csfmt">\ifdefempty</code></a><a id="wrglossary.8631"></a><a href="#glo:mglscurrentcategory"><code class="csfmt">\mglscurrentcategory</code></a>
+ {<a id="wrglossary.8632"></a><a href="#glo:ifdefempty"><code class="csfmt">\ifdefempty</code></a><a id="wrglossary.8633"></a><a href="#glo:mglscurrentsuffix"><code class="csfmt">\mglscurrentsuffix</code></a>{}{<code class="cmd">\space</code>(<a id="wrglossary.8634"></a><a href="#glo:mglscurrentsuffix"><code class="csfmt">\mglscurrentsuffix</code></a>)}}%
+ {%
+ <a id="wrglossary.8635"></a><a href="#glo:mglshascategorysuffix"><code class="csfmt">\mglshascategorysuffix</code></a>{<a id="wrglossary.8636"></a><a href="#glo:mglscurrentcategory"><code class="csfmt">\mglscurrentcategory</code></a>}%
+ {<a id="wrglossary.8637"></a><a href="#glo:mglsusecategorysuffix"><code class="csfmt">\mglsusecategorysuffix</code></a>{<a id="wrglossary.8638"></a><a href="#glo:mglscurrentcategory"><code class="csfmt">\mglscurrentcategory</code></a>}}%
+ {<a id="wrglossary.8639"></a><a href="#glo:ifdefempty"><code class="csfmt">\ifdefempty</code></a>{<a id="wrglossary.8640"></a><a href="#glo:mglscurrentsuffix"><code class="csfmt">\mglscurrentsuffix</code></a>}{}{<code class="cmd">\space</code>(<a id="wrglossary.8641"></a><a href="#glo:mglscurrentsuffix"><code class="csfmt">\mglscurrentsuffix</code></a>)}}%
+ }%
+}
+</pre> If there is a suffix associated with the current category, that will be used, otherwise if the current suffix isn’t empty this inserts a space followed by the current suffix in parentheses. You can access the label of the last (non-skipped) element with <a id="wrglossary.8642"></a><a href="#glo:mglslastelementlabel"><code class="csfmt">\mglslastelementlabel</code></a>.<p>
+Note that in both cases the category corresponds to the multi-entry category (see §<a href="#sec:multiglscategory">7.8</a>).<p>
+To define a category-dependent prefix, use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8643"></a><code class="code"><dfn id="glo:mglsdefcategoryprefix"><code class="csfmt">\mglsdefcategoryprefix</code></dfn>{<span class="meta">〈<em class="metainner">category-label</em>〉</span>}{<span class="meta">〈<em class="metainner">definition</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ You can reference the current prefix with <a id="wrglossary.8644"></a><a href="#glo:mglscurrentprefix"><code class="csfmt">\mglscurrentprefix</code></a> within <span class="meta">〈<em class="metainner">definition</em>〉</span>.<p>
+To define a category-dependent suffix, use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8645"></a><code class="code"><dfn id="glo:mglsdefcategorysuffix"><code class="csfmt">\mglsdefcategorysuffix</code></dfn>{<span class="meta">〈<em class="metainner">category-label</em>〉</span>}{<span class="meta">〈<em class="metainner">definition</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ You can reference the current suffix with <a id="wrglossary.8646"></a><a href="#glo:mglscurrentsuffix"><code class="csfmt">\mglscurrentsuffix</code></a> within <span class="meta">〈<em class="metainner">definition</em>〉</span>.<p>
+The default definition of <a id="wrglossary.8647"></a><a href="#glo:mglsprefix"><code class="csfmt">\mglsprefix</code></a> tests if there is a category prefix using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8648"></a><code class="code"><dfn id="glo:mglshascategoryprefix"><code class="csfmt">\mglshascategoryprefix</code></dfn>{<span class="meta">〈<em class="metainner">category-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does <span class="meta">〈<em class="metainner">true</em>〉</span> if a prefix has been assigned to the given category, otherwise it does <span class="meta">〈<em class="metainner">false</em>〉</span>.<p>
+If you need to obtain the prefix for a particular category, you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8649"></a><code class="code"><dfn id="glo:mglsusecategoryprefix"><code class="csfmt">\mglsusecategoryprefix</code></dfn>{<span class="meta">〈<em class="metainner">category-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This expands to the prefix, if set, for the given category or to nothing otherwise.<p>
+The default definition of <a id="wrglossary.8650"></a><a href="#glo:mglssuffix"><code class="csfmt">\mglssuffix</code></a> tests if there is a category suffix using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8651"></a><code class="code"><dfn id="glo:mglshascategorysuffix"><code class="csfmt">\mglshascategorysuffix</code></dfn>{<span class="meta">〈<em class="metainner">category-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does <span class="meta">〈<em class="metainner">true</em>〉</span> if a suffix has been assigned to the given category, otherwise it does <span class="meta">〈<em class="metainner">false</em>〉</span>.<p>
+If you need to obtain the suffix for a particular category, you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8652"></a><code class="code"><dfn id="glo:mglsusecategorysuffix"><code class="csfmt">\mglsusecategorysuffix</code></dfn>{<span class="meta">〈<em class="metainner">category-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This expands to the suffix, if set, for the given category or to nothing otherwise.<p>
+The current prefix <a id="wrglossary.8653"></a><a href="#glo:mglscurrentprefix"><code class="csfmt">\mglscurrentprefix</code></a> and <a id="wrglossary.8654"></a><a href="#glo:mglscurrentsuffix"><code class="csfmt">\mglscurrentsuffix</code></a> are obtained as follows:
+<ul class="displaylist">
+ <li><span class="bulletitem">•</span>if this is the first use of the multi-entry (§<a href="#sec:mglsfirstuse">7.7</a>) then the <span class="meta">〈<em class="metainner">prefix</em>〉</span> is set to the value of the <a id="wrglossary.8655"></a><a href="#glo:opt.mglsopt.firstprefix"><span class="csoptfmt">firstprefix</span></a> option and the <span class="meta">〈<em class="metainner">suffix</em>〉</span> is set to the value of the <a id="wrglossary.8656"></a><a href="#glo:opt.mglsopt.firstsuffix"><span class="csoptfmt">firstsuffix</span></a> option; <li><span class="bulletitem">•</span>otherwise the <span class="meta">〈<em class="metainner">prefix</em>〉</span> is set to the value of the <a id="wrglossary.8657"></a><a href="#glo:opt.mglsopt.usedprefix"><span class="csoptfmt">usedprefix</span></a> option and the <span class="meta">〈<em class="metainner">suffix</em>〉</span> is set to the value of the <a id="wrglossary.8658"></a><a href="#glo:opt.mglsopt.usedsuffix"><span class="csoptfmt">usedsuffix</span></a> option.
+</ul>
+<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The prefix and suffix (if set) are placed outside of the hyperlink and text formatting encapsulator. They are not affected by case-changing commands such as <a id="wrglossary.8659"></a><a href="#glo:Mgls"><code class="csfmt">\Mgls</code></a> or <a id="wrglossary.8660"></a><a href="#glo:MGLS"><code class="csfmt">\MGLS</code></a>. </div><!-- end of important -->
+<p>
+For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8661"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.8662"></a><a href="#glo:opt.abbrstyle.long-only-short-only"><span class="abbrstylefmt">long-only-short-only</span></a>}
+<a id="wrglossary.8663"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{clostridium}{C.}{Clostridium}
+<a id="wrglossary.8664"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{botulinum}{<a id="wrglossary.8665"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={botulinum}</span>,<a id="wrglossary.8666"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+
+<a id="wrglossary.8667"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a>[<a id="wrglossary.8668"></a><a href="#glo:opt.mglsopt.firstsuffix"><span class="csoptfmt">firstsuffix</span></a><span class="optfmt">=botulism</span>]
+ {cbot}{clostridium,botulinum}
+</pre> On first use, this produces (assuming the <span class="qt">“clostridum”</span> element hasn’t been used previously): <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+Clostridium botulinum (botulism). </div><!-- end of resultbox -->
+ On subsequent use, this produces: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+C. botulinum. </div><!-- end of resultbox -->
+<p>
+
+</section><!-- end of section sec:mglsfixes -->
+
+<section id="sec:mglssep"><!-- start of section sec:mglssep --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->7.4. Separators<div class="labellink"><a href="#sec:mglssep">[link]</a></div></h2><!-- end of section header -->
+<p>
+The separators between each instance of <a id="wrglossary.8669"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> are given by the following commands, which all take two arguments. The first argument is the label of the previous element. The second argument is the label of the following element. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8670"></a><code class="code"><dfn id="glo:glscombinedsep"><code class="csfmt">\glscombinedsep</code></dfn>{<span class="meta">〈<em class="metainner">prev label</em>〉</span>}{<span class="meta">〈<em class="metainner">next label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is inserted between two entries that have both been marked as used. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.8671"></a><a href="#glo:glscombinedsep"><code class="csfmt">\glscombinedsep</code></a>}[2]{%
+ <a id="wrglossary.8672"></a><a href="#glo:glshasattribute"><code class="csfmt">\glshasattribute</code></a>{#1}{<a id="wrglossary.8673"></a><a href="#glo:opt.catattr.combinedsep"><span class="csoptfmt">combinedsep</span></a>}%
+ {<a id="wrglossary.8674"></a><a href="#glo:glsgetattribute"><code class="csfmt">\glsgetattribute</code></a>{#1}{<a id="wrglossary.8675"></a><a href="#glo:opt.catattr.combinedsep"><span class="csoptfmt">combinedsep</span></a>}}%
+ { }}
+</pre> This will use the <a id="wrglossary.8676"></a><a href="#glo:opt.catattr.combinedsep"><span class="csoptfmt">combinedsep</span></a> attribute for the <span class="meta">〈<em class="metainner">prev label</em>〉</span>’s category, if set. Otherwise this just does a space. Note that this ignores the second argument.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8677"></a><code class="code"><dfn id="glo:glscombinedfirstsep"><code class="csfmt">\glscombinedfirstsep</code></dfn>{<span class="meta">〈<em class="metainner">prev label</em>〉</span>}{<span class="meta">〈<em class="metainner">next label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is inserted between two entries where only the next entry has been marked as used. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.8678"></a><a href="#glo:glscombinedfirstsep"><code class="csfmt">\glscombinedfirstsep</code></a>}[2]{%
+ <a id="wrglossary.8679"></a><a href="#glo:glshasattribute"><code class="csfmt">\glshasattribute</code></a>{#1}{<a id="wrglossary.8680"></a><a href="#glo:opt.catattr.combinedfirstsep"><span class="csoptfmt">combinedfirstsep</span></a>}%
+ {<a id="wrglossary.8681"></a><a href="#glo:glsgetattribute"><code class="csfmt">\glsgetattribute</code></a>{#1}{<a id="wrglossary.8682"></a><a href="#glo:opt.catattr.combinedfirstsep"><span class="csoptfmt">combinedfirstsep</span></a>}}%
+ {<a id="wrglossary.8683"></a><a href="#glo:glscombinedsep"><code class="csfmt">\glscombinedsep</code></a>{#1}{#2}}%
+}
+</pre> This will use the <a id="wrglossary.8684"></a><a href="#glo:opt.catattr.combinedfirstsep"><span class="csoptfmt">combinedfirstsep</span></a> attribute for <span class="meta">〈<em class="metainner">prev label</em>〉</span>’s category, if set. If that attribute isn’t set, <a id="wrglossary.8685"></a><a href="#glo:glscombinedsep"><code class="csfmt">\glscombinedsep</code></a> is used.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8686"></a><code class="code"><dfn id="glo:glscombinedsepfirst"><code class="csfmt">\glscombinedsepfirst</code></dfn>{<span class="meta">〈<em class="metainner">prev label</em>〉</span>}{<span class="meta">〈<em class="metainner">next label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is inserted between two entries where only the previous entry has been marked as used. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.8687"></a><a href="#glo:glscombinedsepfirst"><code class="csfmt">\glscombinedsepfirst</code></a>}[2]{%
+ <a id="wrglossary.8688"></a><a href="#glo:glshasattribute"><code class="csfmt">\glshasattribute</code></a>{#1}{<a id="wrglossary.8689"></a><a href="#glo:opt.catattr.combinedsepfirst"><span class="csoptfmt">combinedsepfirst</span></a>}%
+ {<a id="wrglossary.8690"></a><a href="#glo:glsgetattribute"><code class="csfmt">\glsgetattribute</code></a>{#1}{<a id="wrglossary.8691"></a><a href="#glo:opt.catattr.combinedsepfirst"><span class="csoptfmt">combinedsepfirst</span></a>}}%
+ {<a id="wrglossary.8692"></a><a href="#glo:glscombinedsep"><code class="csfmt">\glscombinedsep</code></a>{#1}{#2}}%
+}
+</pre> This will use the <a id="wrglossary.8693"></a><a href="#glo:opt.catattr.combinedsepfirst"><span class="csoptfmt">combinedsepfirst</span></a> attribute for <span class="meta">〈<em class="metainner">prev label</em>〉</span>’s category, if set. If that attribute isn’t set, <a id="wrglossary.8694"></a><a href="#glo:glscombinedsep"><code class="csfmt">\glscombinedsep</code></a> is used.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8695"></a><code class="code"><dfn id="glo:glscombinedfirstsepfirst"><code class="csfmt">\glscombinedfirstsepfirst</code></dfn>{<span class="meta">〈<em class="metainner">prev label</em>〉</span>}{<span class="meta">〈<em class="metainner">next label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is inserted between two entries where both have been marked as used. The default definition is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.8696"></a><a href="#glo:glscombinedfirstsepfirst"><code class="csfmt">\glscombinedfirstsepfirst</code></a>}[2]{%
+ <a id="wrglossary.8697"></a><a href="#glo:glshasattribute"><code class="csfmt">\glshasattribute</code></a>{#1}{<a id="wrglossary.8698"></a><a href="#glo:opt.catattr.combinedfirstsepfirst"><span class="csoptfmt">combinedfirstsepfirst</span></a>}%
+ {<a id="wrglossary.8699"></a><a href="#glo:glsgetattribute"><code class="csfmt">\glsgetattribute</code></a>{#1}{<a id="wrglossary.8700"></a><a href="#glo:opt.catattr.combinedfirstsepfirst"><span class="csoptfmt">combinedfirstsepfirst</span></a>}}%
+ {<a id="wrglossary.8701"></a><a href="#glo:glscombinedsep"><code class="csfmt">\glscombinedsep</code></a>{#1}{#2}}%
+}
+</pre> This will use the <a id="wrglossary.8702"></a><a href="#glo:opt.catattr.combinedfirstsepfirst"><span class="csoptfmt">combinedfirstsepfirst</span></a> attribute for <span class="meta">〈<em class="metainner">prev label</em>〉</span>’s category, if set. If that attribute isn’t set, <a id="wrglossary.8703"></a><a href="#glo:glscombinedsep"><code class="csfmt">\glscombinedsep</code></a> is used.<p>
+These commands may be redefined as required. For example, to have no space between two elements that have both been marked as used and are both abbreviations (disregarding category attributes): <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.8704"></a><a href="#glo:glscombinedfirstsepfirst"><code class="csfmt">\glscombinedfirstsepfirst</code></a>}[2]{%
+ <a id="wrglossary.8705"></a><a href="#glo:ifglshasshort"><code class="csfmt">\ifglshasshort</code></a>{#1}{<a id="wrglossary.8706"></a><a href="#glo:ifglshasshort"><code class="csfmt">\ifglshasshort</code></a>{#2}{}{<code class="cmd">\space</code>}}{<code class="cmd">\space</code>}%
+}
+</pre><p>
+There are some commands for redefining the above separators to common combinations.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8707"></a><code class="code"><dfn id="glo:glssetcombinedsepabbrvnbsp"><code class="csfmt">\glssetcombinedsepabbrvnbsp</code></dfn></code></div><!-- end of pinnedbox -->
+ This does the following: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.8708"></a><a href="#glo:glscombinedsep"><code class="csfmt">\glscombinedsep</code></a>}[2]{%
+ <a id="wrglossary.8709"></a><a href="#glo:glshasattribute"><code class="csfmt">\glshasattribute</code></a>{#1}{<a id="wrglossary.8710"></a><a href="#glo:opt.catattr.combinedsep"><span class="csoptfmt">combinedsep</span></a>}%
+ {<a id="wrglossary.8711"></a><a href="#glo:glsgetattribute"><code class="csfmt">\glsgetattribute</code></a>{#1}{<a id="wrglossary.8712"></a><a href="#glo:opt.catattr.combinedsep"><span class="csoptfmt">combinedsep</span></a>}}%
+ {<a id="wrglossary.8713"></a><a href="#glo:ifglshasshort"><code class="csfmt">\ifglshasshort</code></a>{#1}{<a id="wrglossary.8714"></a><a href="#glo:idx.nbsp"><span title="non-breaking space (\code{~})" class="icon"><code class="code">~</code></span></a>}{ }}%
}%
-\renewcommand*{\glscombinedfirstsepfirst}[2]{%
-&#x00A0;&#x00A0;\glshasattribute{##1}{combinedfirstsepfirst}%
-&#x00A0;&#x00A0;{\glsgetattribute{##1}{combinedfirstsepfirst}}%
-&#x00A0;&#x00A0;{&#x00A0;}%
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.8715"></a><a href="#glo:glscombinedsepfirst"><code class="csfmt">\glscombinedsepfirst</code></a>}[2]{%
+ <a id="wrglossary.8716"></a><a href="#glo:glshasattribute"><code class="csfmt">\glshasattribute</code></a>{#1}{<a id="wrglossary.8717"></a><a href="#glo:opt.catattr.combinedsepfirst"><span class="csoptfmt">combinedsepfirst</span></a>}%
+ {<a id="wrglossary.8718"></a><a href="#glo:glsgetattribute"><code class="csfmt">\glsgetattribute</code></a>{#1}{<a id="wrglossary.8719"></a><a href="#glo:opt.catattr.combinedsepfirst"><span class="csoptfmt">combinedsepfirst</span></a>}}%
+ {<a id="wrglossary.8720"></a><a href="#glo:ifglshasshort"><code class="csfmt">\ifglshasshort</code></a>{#1}{<a id="wrglossary.8721"></a><a href="#glo:idx.nbsp"><span title="non-breaking space (\code{~})" class="icon"><code class="code">~</code></span></a>}{ }}%
}%
-</pre>
-<!--l. 8674--><p class="nopar" > This uses a non-breakable space <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">~</span></span></span> following an abbreviation (that has already been
-marked as used). Note that if the associated attributes are set the commands will
-behave according to the attribute.
-</p><!--l. 8680--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-48010"></a> <span
-class="cmtt-10">\glssetcombinedsepabbrvnone </span></div><hr>
-</p><!--l. 8682--><p class="noindent" >
-This does the following:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-209">
-\renewcommand*{\glscombinedsep}[2]{%
-&#x00A0;\glshasattribute{#1}{combinedsep}%
-&#x00A0;{\glsgetattribute{#1}{combinedsep}}%
-&#x00A0;{\ifhasshort{#1}{}{\ifhasshort{#2}{}{&#x00A0;}}}%
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.8722"></a><a href="#glo:glscombinedfirstsep"><code class="csfmt">\glscombinedfirstsep</code></a>}[2]{%
+ <a id="wrglossary.8723"></a><a href="#glo:glshasattribute"><code class="csfmt">\glshasattribute</code></a>{#1}{<a id="wrglossary.8724"></a><a href="#glo:opt.catattr.combinedfirstsep"><span class="csoptfmt">combinedfirstsep</span></a>}%
+ {<a id="wrglossary.8725"></a><a href="#glo:glsgetattribute"><code class="csfmt">\glsgetattribute</code></a>{#1}{<a id="wrglossary.8726"></a><a href="#glo:opt.catattr.combinedfirstsep"><span class="csoptfmt">combinedfirstsep</span></a>}}%
+ { }%
}%
-\renewcommand*{\glscombinedsepfirst}[2]{%
-&#x00A0;\glshasattribute{#1}{combinedsepfirst}%
-&#x00A0;{\glsgetattribute{#1}{combinedsepfirst}}%
-&#x00A0;{\ifhasshort{#1}{}{&#x00A0;}}%
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.8727"></a><a href="#glo:glscombinedfirstsepfirst"><code class="csfmt">\glscombinedfirstsepfirst</code></a>}[2]{%
+ <a id="wrglossary.8728"></a><a href="#glo:glshasattribute"><code class="csfmt">\glshasattribute</code></a>{#1}{<a id="wrglossary.8729"></a><a href="#glo:opt.catattr.combinedfirstsepfirst"><span class="csoptfmt">combinedfirstsepfirst</span></a>}%
+ {<a id="wrglossary.8730"></a><a href="#glo:glsgetattribute"><code class="csfmt">\glsgetattribute</code></a>{#1}{<a id="wrglossary.8731"></a><a href="#glo:opt.catattr.combinedfirstsepfirst"><span class="csoptfmt">combinedfirstsepfirst</span></a>}}%
+ { }%
+}
+</pre> This uses a <a id="wrglossary.8732"></a><a href="#glo:idx.nbsp">non-breaking space (<code class="code">~</code>)</a> following an abbreviation (that has already been marked as used). Note that if the associated attributes are set the commands will behave according to the attribute.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8733"></a><code class="code"><dfn id="glo:glssetcombinedsepabbrvnone"><code class="csfmt">\glssetcombinedsepabbrvnone</code></dfn></code></div><!-- end of pinnedbox -->
+ <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.8734"></a><a href="#glo:glscombinedsep"><code class="csfmt">\glscombinedsep</code></a>}[2]{%
+ <a id="wrglossary.8735"></a><a href="#glo:glshasattribute"><code class="csfmt">\glshasattribute</code></a>{#1}{<a id="wrglossary.8736"></a><a href="#glo:opt.catattr.combinedsep"><span class="csoptfmt">combinedsep</span></a>}%
+ {<a id="wrglossary.8737"></a><a href="#glo:glsgetattribute"><code class="csfmt">\glsgetattribute</code></a>{#1}{<a id="wrglossary.8738"></a><a href="#glo:opt.catattr.combinedsep"><span class="csoptfmt">combinedsep</span></a>}}%
+ {<a id="wrglossary.8739"></a><a href="#glo:ifglshasshort"><code class="csfmt">\ifglshasshort</code></a>{#1}{}{<a id="wrglossary.8740"></a><a href="#glo:ifglshasshort"><code class="csfmt">\ifglshasshort</code></a>{#2}{}{ }}}%
}%
-\renewcommand*{\glscombinedfirstsep}[2]{%
-&#x00A0;\glshasattribute{##1}{combinedfirstsep}%
-&#x00A0;{\glsgetattribute{##1}{combinedfirstsep}}%
-&#x00A0;{\ifhasshort{##2}{}{&#x00A0;}}%
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.8741"></a><a href="#glo:glscombinedsepfirst"><code class="csfmt">\glscombinedsepfirst</code></a>}[2]{%
+ <a id="wrglossary.8742"></a><a href="#glo:glshasattribute"><code class="csfmt">\glshasattribute</code></a>{#1}{<a id="wrglossary.8743"></a><a href="#glo:opt.catattr.combinedsepfirst"><span class="csoptfmt">combinedsepfirst</span></a>}%
+ {<a id="wrglossary.8744"></a><a href="#glo:glsgetattribute"><code class="csfmt">\glsgetattribute</code></a>{#1}{<a id="wrglossary.8745"></a><a href="#glo:opt.catattr.combinedsepfirst"><span class="csoptfmt">combinedsepfirst</span></a>}}%
+ {<a id="wrglossary.8746"></a><a href="#glo:ifglshasshort"><code class="csfmt">\ifglshasshort</code></a>{#1}{}{ }}%
}%
-\renewcommand*{\glscombinedfirstsepfirst}[2]{%
-&#x00A0;\glshasattribute{##1}{combinedfirstsepfirst}%
-&#x00A0;{\glsgetattribute{##1}{combinedfirstsepfirst}}%
-&#x00A0;{&#x00A0;}%
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.8747"></a><a href="#glo:glscombinedfirstsep"><code class="csfmt">\glscombinedfirstsep</code></a>}[2]{%
+ <a id="wrglossary.8748"></a><a href="#glo:glshasattribute"><code class="csfmt">\glshasattribute</code></a>{#1}{<a id="wrglossary.8749"></a><a href="#glo:opt.catattr.combinedfirstsep"><span class="csoptfmt">combinedfirstsep</span></a>}%
+ {<a id="wrglossary.8750"></a><a href="#glo:glsgetattribute"><code class="csfmt">\glsgetattribute</code></a>{#1}{<a id="wrglossary.8751"></a><a href="#glo:opt.catattr.combinedfirstsep"><span class="csoptfmt">combinedfirstsep</span></a>}}%
+ {<a id="wrglossary.8752"></a><a href="#glo:ifglshasshort"><code class="csfmt">\ifglshasshort</code></a>{#2}{}{ }}%
}%
-</pre>
-<!--l. 8705--><p class="nopar" > This does nothing if either element are abbreviations that have already been used.
-Note that if the associated attributes are set the commands will behave according to
-the attribute.
-</p><!--l. 8710--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-48011"></a> <span
-class="cmtt-10">\glssetcombinedsepnarrow{</span>&#x27E8;<span
-class="cmitt-10">width</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">narrow sep</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 8712--><p class="noindent" >
-This is rather more complicated as it measures a field value and uses &#x27E8;<span
-class="cmti-10">narrow</span>
-<span
-class="cmti-10">sep</span>&#x27E9; if the width is less than &#x27E8;<span
-class="cmti-10">width</span>&#x27E9;. The field value is determined as follows:
-</p>
- <ul class="itemize1">
- <li class="itemize">on <a
- id="dx1-48012"></a><a
-href="#glo:firstuse">first use</a> the <span
-class="cmss-10">long</span><a
- id="dx1-48013"></a> field is used if it is set otherwise the <span
-class="cmss-10">first</span><a
- id="dx1-48014"></a> field is used;
- </li>
- <li class="itemize">otherwise the <span
-class="cmss-10">short</span><a
- id="dx1-48015"></a> field is used if it is set otherwise the <span
-class="cmss-10">text</span><a
- id="dx1-48016"></a> field is used;</li></ul>
-<!--l. 8726--><p class="indent" > Note that this doesn&#8217;t take into account fonts, hooks, abbreviation styles or
-plural forms (e.g.&#x00A0;<span
-class="cmtt-10">\mglspl</span>) or other field references (e.g.&#x00A0;<span
-class="cmtt-10">\mglsname</span>). If the
-associated attributes are set the commands will behave according to the
-attribute.
-</p><!--l. 8731--><p class="noindent" >
-</p>
-
-
-
-<!--l. 8731--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6.5 </span> <a
- id="sec:mglselementhooks"></a>mgls Element Hooks</h3>
-<!--l. 8734--><p class="noindent" >The <span
-class="cmtt-10">\mgls</span>-like commands use the following hooks:
-</p><!--l. 8735--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-49001"></a> <span
-class="cmtt-10">\mglselementprehook </span></div><hr>
-</p><!--l. 8737--><p class="noindent" >
-This is done before each (non-skipped) element. (Default does nothing.)
-</p><!--l. 8739--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-49002"></a> <span
-class="cmtt-10">\mglselementposthook </span></div><hr>
-</p><!--l. 8741--><p class="noindent" >
-This is done after each (non-skipped) element. (Default does nothing.) Note that this is
-different from the normal entry post-link hook <span
-class="cmtt-10">\glspostlinkhook</span><a
- id="dx1-49003"></a>. If the individual
-entry post-link hook is enabled (see the <span
-class="cmss-10">postlinks </span>key in <a
-href="#sec:multiglsoptions"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.9</span>
-</a><a
-href="#sec:multiglsoptions">Multi-Entry Settings<!--tex4ht:ref: sec:multiglsoptions --></a>), this will go before <span
-class="cmtt-10">\mglselementposthook</span>.
-</p><!--l. 8748--><p class="indent" > The definitions of the following commands are scoped within the <span
-class="cmtt-10">\mgls</span>-like
-commands so they can&#8217;t be accessed elsewhere (including in the post-link hook, see
-<a
-href="#sec:mglspostlinkhook"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.6</span> </a><a
-href="#sec:mglspostlinkhook">Post-Link Hook<!--tex4ht:ref: sec:mglspostlinkhook --></a>). They may be used in the above hooks
-or in the separator commands (described in <a
-href="#sec:mglssep"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.4</span> </a><a
-href="#sec:mglssep">Separators<!--tex4ht:ref: sec:mglssep --></a>) or
-in the command used to encapsulate the entire content. They can also be
-used in the post-link hook (see <a
-href="#sec:entryfmtmods"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.4</span> </a><a
-href="#sec:entryfmtmods">Entry Display Style
-Modifications<!--tex4ht:ref: sec:entryfmtmods --></a>) to determine if an entry is being used within a <span
-class="cmtt-10">\mgls</span>-like
-command.
-</p><!--l. 8758--><p class="indent" > The multi-entry label is stored in:
-</p><!--l. 8759--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-49004"></a> <span
-class="cmtt-10">\mglscurrentmultilabel </span></div><hr>
-</p><!--l. 8761--><p class="noindent" >
-</p><!--l. 8763--><p class="indent" > The label of the main element:
-</p><!--l. 8764--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-49005"></a> <span
-class="cmtt-10">\mglscurrentmainlabel </span></div><hr>
-</p><!--l. 8766--><p class="noindent" >
-</p><!--l. 8768--><p class="indent" > The complete comma-separated list of elements:
-</p><!--l. 8769--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-49006"></a> <span
-class="cmtt-10">\mglscurrentlist </span></div><hr>
-</p><!--l. 8771--><p class="noindent" >
-</p><!--l. 8773--><p class="indent" > Multi-entry options:
-</p><!--l. 8774--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-49007"></a> <span
-class="cmtt-10">\mglscurrentoptions </span></div><hr>
-</p><!--l. 8776--><p class="noindent" >
-These are the options that were used when defining the multi-entry. This doesn&#8217;t
-include options set with <span
-class="cmtt-10">\multiglossaryentrysetup </span>or those passed to <span
-class="cmtt-10">\mgls </span>(or
-whichever variant is being used).
-</p><!--l. 8781--><p class="indent" > The current multi-entry category in effect is stored in:
-</p><!--l. 8782--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-49008"></a> <span
-class="cmtt-10">\mglscurrentcategory </span></div><hr>
-</p><!--l. 8784--><p class="noindent" >
-</p><!--l. 8786--><p class="indent" > The calling command control sequence name (e.g.&#x00A0;&#8220;mgls&#8221; or &#8220;mglspl&#8221;) can be
-obtained with:
-</p><!--l. 8788--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-49009"></a> <span
-class="cmtt-10">\glsxtrcurrentmglscsname </span></div><hr>
-</p><!--l. 8790--><p class="noindent" >
-
-
-
-</p><!--l. 8792--><p class="indent" > To test if the current multi-entry is the first use:
-</p><!--l. 8793--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-49010"></a> <span
-class="cmtt-10">\mglsisfirstuse{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 8795--><p class="noindent" >
-This does &#x27E8;<span
-class="cmti-10">true</span>&#x27E9; if this is the first use otherwise it does &#x27E8;<span
-class="cmti-10">false</span>&#x27E9;. Note that this
-applies to the multi-entry first use flag not the <a
- id="dx1-49011"></a><a
-href="#glo:firstuseflag">first use flags</a> of the individual
-elements.
-</p><!--l. 8801--><p class="indent" > At each iteration of the loop over the element list, the following commands are
-set, which can be accessed in hooks such as <span
-class="cmtt-10">\mglselementprehook </span>or in hooks used
-by the underlying <span
-class="cmtt-10">\gls </span>etc commands. For example, if <span
-class="cmtt-10">\mglscurrentlabel </span>is
-defined then <span
-class="cmtt-10">\gls </span>is being used inside <span
-class="cmtt-10">\mgls</span>.
-</p><!--l. 8807--><p class="indent" > The current element label:
-</p><!--l. 8808--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-49012"></a> <span
-class="cmtt-10">\mglscurrentlabel </span></div><hr>
-</p><!--l. 8810--><p class="noindent" >
-</p><!--l. 8812--><p class="indent" > This is a count register that is set to the element index:
-</p><!--l. 8813--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-49013"></a> <span
-class="cmtt-10">\mglselementindex </span></div><hr>
-</p><!--l. 8815--><p class="noindent" >
-</p><!--l. 8817--><p class="indent" > The current multi-entry prefix:
-</p><!--l. 8818--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-49014"></a> <span
-class="cmtt-10">\mglscurrentprefix </span></div><hr>
-</p><!--l. 8820--><p class="noindent" >
-</p><!--l. 8822--><p class="indent" > The current multi-entry suffix:
-</p><!--l. 8823--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-49015"></a> <span
-class="cmtt-10">\mglscurrentsuffix </span></div><hr>
-</p><!--l. 8825--><p class="noindent" >
-</p><!--l. 8827--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-49016"></a> <span
-class="cmtt-10">\mglsiflast{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 8829--><p class="noindent" >
-If this is the last iteration, does &#x27E8;<span
-class="cmti-10">true</span>&#x27E9; otherwise does &#x27E8;<span
-class="cmti-10">false</span>&#x27E9;. This takes the skip options
-into account, so the last iteration may not necessarily be when the element index is
-equal to the total number of elements.
-</p><!--l. 8835--><p class="noindent" >
-</p>
-<!--l. 8835--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6.6 </span> <a
- id="sec:mglspostlinkhook"></a>Post-Link Hook</h3>
-<!--l. 8838--><p class="noindent" >There is a hook that occurs at the end the <span
-class="cmtt-10">\mgls</span>-like commands according to the
-<span
-class="cmss-10">mpostlink </span>setting (see <a
-href="#sec:multiglsoptions"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.9</span> </a><a
-href="#sec:multiglsoptions">Multi-Entry Settings<!--tex4ht:ref: sec:multiglsoptions --></a>). The hook used
-depends on the <span
-class="cmss-10">mpostlinkelement </span>option. These hooks can&#8217;t access the commands
-described in <a
-href="#sec:mglselementhooks"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.5</span> </a><a
-href="#sec:mglselementhooks">mgls Element Hooks<!--tex4ht:ref: sec:mglselementhooks --></a> as the hook occurs
-outside of the scope in which they are defined.
-</p><!--l. 8845--><p class="indent" > The <span
-class="cmss-10">mpostlinkelement=custom </span>option uses:
-</p><!--l. 8846--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-50001"></a> <span
-class="cmtt-10">\mglscustompostlinkhook </span></div><hr>
-</p><!--l. 8848--><p class="noindent" >
-This does nothing by default.
-
-
-
-</p><!--l. 8851--><p class="indent" > The <span
-class="cmss-10">mpostlinkelement=last </span>option uses:
-</p><!--l. 8852--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-50002"></a> <span
-class="cmtt-10">\mglslastelementpostlinkhook </span></div><hr>
-</p><!--l. 8854--><p class="noindent" >
-which emulates the post-link hook of the last element.
-</p><!--l. 8857--><p class="indent" > The <span
-class="cmss-10">mpostlinkelement=main </span>option uses:
-</p><!--l. 8858--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-50003"></a> <span
-class="cmtt-10">\mglslastmainpostlinkhook </span></div><hr>
-</p><!--l. 8860--><p class="noindent" >
-which emulates the post-link hook of the main element.
-</p><!--l. 8863--><p class="indent" > The default settings <span
-class="cmss-10">postlinks=none,mpostlink=true,mpostlinkelementlast </span>will
-suppress the individual element post-link hooks (<span
-class="cmtt-10">\glspostlinkhook</span><a
- id="dx1-50004"></a>) and do the
-multi-entry post-link hook for the last element (<span
-class="cmtt-10">\mglslastelementpostlinkhook</span>).
-</p><!--l. 8869--><p class="indent" > If you have the final element&#8217;s post-link hook enabled and the multi-entry post-link
-hook enabled (for example, <span
-class="cmss-10">postlinks=all, mpostlink=true, mpostlinkelement=last</span>), the
-final element&#8217;s post-link hook will be done twice. Similarly for the main element with
-<span
-class="cmss-10">postlinks=all, mpostlink=true, mpostlinkelement=main</span>.
-</p><!--l. 8876--><p class="indent" > The following commands are available for use in these hooks and may also be
-used in <span
-class="cmtt-10">\mglssuffix</span><a
- id="dx1-50005"></a>.
-</p><!--l. 8879--><p class="indent" > The multi-entry label:
-</p><!--l. 8880--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-50006"></a> <span
-class="cmtt-10">\mglslastmultilabel </span></div><hr>
-</p><!--l. 8882--><p class="noindent" >
-</p><!--l. 8884--><p class="indent" > The multi-entry category (<a
-href="#sec:multiglscategory"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.8</span> </a><a
-href="#sec:multiglscategory">Multi-Entry Category<!--tex4ht:ref: sec:multiglscategory --></a>):
-</p><!--l. 8885--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-50007"></a> <span
-class="cmtt-10">\mglslastcategory </span></div><hr>
-</p><!--l. 8887--><p class="noindent" >
-This will be empty if no category was assigned.
-</p><!--l. 8890--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-50008"></a> <span
-class="cmtt-10">\mglswasfirstuse{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 8892--><p class="noindent" >
-If that was the first use of the multi-entry (<a
-href="#sec:mglsfirstuse"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.7</span> </a><a
-href="#sec:mglsfirstuse">Multi-Entry First Use<!--tex4ht:ref: sec:mglsfirstuse --></a>)
-this does &#x27E8;<span
-class="cmti-10">true</span>&#x27E9; otherwise it does &#x27E8;<span
-class="cmti-10">false</span>&#x27E9;.
-</p><!--l. 8896--><p class="noindent" >
-</p>
-<!--l. 8896--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">6.6.1 </span> <a
- id="sec:mglspostlinkhooklastelement"></a>Last Element</h4>
-<!--l. 8898--><p class="noindent" >The following commands relate to the last element.
-</p><!--l. 8900--><p class="indent" > The label of the last non-skipped element:
-</p><!--l. 8901--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-51001"></a> <span
-class="cmtt-10">\mglslastelementlabel </span></div><hr>
-</p><!--l. 8903--><p class="noindent" >
-If all elements were skipped or if the multi-entry wasn&#8217;t defined, this will be
-empty.
-</p><!--l. 8907--><p class="indent" > Test if the last element was skipped:
-</p><!--l. 8908--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-51002"></a> <span
-class="cmtt-10">\mglsiflastelementskipped{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 8910--><p class="noindent" >
-If the last element was skipped this does &#x27E8;<span
-class="cmti-10">true</span>&#x27E9; otherwise it does &#x27E8;<span
-class="cmti-10">false</span>&#x27E9;. If
-all elements were skipped or if the multi-entry wasn&#8217;t defined, this will do
-
-
-
-&#x27E8;<span
-class="cmti-10">true</span>&#x27E9;.
-</p><!--l. 8916--><p class="indent" > Test if the last element was its first use:
-</p><!--l. 8917--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-51003"></a> <span
-class="cmtt-10">\mglsiflastelementwasfirstuse{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 8919--><p class="noindent" >
-If the last non-skipped element was used for the first time this does &#x27E8;<span
-class="cmti-10">true</span>&#x27E9; otherwise it
-does &#x27E8;<span
-class="cmti-10">false</span>&#x27E9;. (Corresponds to <span
-class="cmtt-10">\glsxtrifwasfirstuse</span>.) If all elements were skipped or
-if the multi-entry wasn&#8217;t defined, this will do &#x27E8;<span
-class="cmti-10">true</span>&#x27E9;.
-</p><!--l. 8926--><p class="indent" > Test if the last element was plural:
-</p><!--l. 8927--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-51004"></a> <span
-class="cmtt-10">\mglsiflastelementwasplural{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 8929--><p class="noindent" >
-If the last non-skipped element had the plural form displayed, this does &#x27E8;<span
-class="cmti-10">true</span>&#x27E9;
-otherwise it does &#x27E8;<span
-class="cmti-10">false</span>&#x27E9;. (Corresponds to <span
-class="cmtt-10">\glsifplural</span>.) If all elements were skipped
-or if the multi-entry wasn&#8217;t defined, this will do &#x27E8;<span
-class="cmti-10">false</span>&#x27E9;.
-</p><!--l. 8936--><p class="indent" > Test if the last element was had any case-changing applied:
-</p><!--l. 8937--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-51005"></a> <span
-class="cmtt-10">\mglsiflastelementcapscase{</span>&#x27E8;<span
-class="cmitt-10">no-change</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">firstuc</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">all caps</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 8939--><p class="noindent" >
-Corresponds to <span
-class="cmtt-10">\glscapscase </span>of the last non-skipped element. If all elements were
-skipped or if the multi-entry wasn&#8217;t defined, this will do &#x27E8;<span
-class="cmti-10">no-change</span>&#x27E9;.
-</p><!--l. 8944--><p class="noindent" >
-</p>
-<!--l. 8944--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">6.6.2 </span> <a
- id="sec:mglspostlinkhookmainelement"></a>Main Element</h4>
-<!--l. 8946--><p class="noindent" >The following commands relate to the main element.
-</p><!--l. 8948--><p class="indent" > The label of the main element from the multi-entry that was just referenced:
-</p><!--l. 8950--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-52001"></a> <span
-class="cmtt-10">\mglslastmainlabel </span></div><hr>
-</p><!--l. 8952--><p class="noindent" >
-If the main element was skipped or if the multi-entry wasn&#8217;t defined, this will be
-empty. If this is the same as <span
-class="cmtt-10">\mglslastelementlabel </span>then the main element was the
-last element.
-</p><!--l. 8958--><p class="indent" > Test if the main element was skipped:
-</p><!--l. 8959--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-52002"></a> <span
-class="cmtt-10">\mglsiflastmainskipped{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 8961--><p class="noindent" >
-If the main element from the multi-entry that was just referenced was skipped this
-does &#x27E8;<span
-class="cmti-10">true</span>&#x27E9; otherwise it does &#x27E8;<span
-class="cmti-10">false</span>&#x27E9;. If the multi-entry wasn&#8217;t defined, this will do
-&#x27E8;<span
-class="cmti-10">true</span>&#x27E9;.
-</p><!--l. 8966--><p class="indent" > Test if the main element was its first use:
-</p><!--l. 8967--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-52003"></a> <span
-class="cmtt-10">\mglsiflastmainwasfirstuse{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 8969--><p class="noindent" >
-If the main element was used for the first time this does &#x27E8;<span
-class="cmti-10">true</span>&#x27E9; otherwise it does &#x27E8;<span
-class="cmti-10">false</span>&#x27E9;.
-(Corresponds to <span
-class="cmtt-10">\glsxtrifwasfirstuse</span>.) If the main element was skipped or if the
-multi-entry wasn&#8217;t defined, this will do &#x27E8;<span
-class="cmti-10">true</span>&#x27E9;.
-</p><!--l. 8976--><p class="indent" > Test if the main element was plural:
-</p><!--l. 8977--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-52004"></a> <span
-class="cmtt-10">\mglsiflastmainwasplural{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-
-
-
-</p><!--l. 8979--><p class="noindent" >
-If the main element from the multi-entry that was just referenced had its plural form
-displayed this does &#x27E8;<span
-class="cmti-10">true</span>&#x27E9; otherwise it does &#x27E8;<span
-class="cmti-10">false</span>&#x27E9;. (Corresponds to <span
-class="cmtt-10">\glsifplural</span>.) If
-the main element was skipped or if the multi-entry wasn&#8217;t defined, this will do
-&#x27E8;<span
-class="cmti-10">false</span>&#x27E9;.
-</p><!--l. 8986--><p class="indent" > Test if the main element was had any case-changing applied:
-</p><!--l. 8987--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-52005"></a> <span
-class="cmtt-10">\mglsiflastmaincapscase{</span>&#x27E8;<span
-class="cmitt-10">no-change</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">firstuc</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">all caps</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 8989--><p class="noindent" >
-Corresponds to <span
-class="cmtt-10">\glscapscase </span>of the main element from the multi-entry that was
-just referenced. If the main element was skipped or if the multi-entry wasn&#8217;t defined,
-this will do &#x27E8;<span
-class="cmti-10">no-change</span>&#x27E9;.
-</p><!--l. 8995--><p class="noindent" >
-</p>
-<!--l. 8995--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6.7 </span> <a
- id="sec:mglsfirstuse"></a>Multi-Entry First Use</h3>
-<!--l. 8998--><p class="noindent" >Each multi-entry set has an associated first use flag. This is independent of
-the <a
- id="dx1-53001"></a><a
-href="#glo:firstuseflag">first use flag</a> associated with the individual entries that make up the
-set. As with the <span
-class="cmtt-10">\gls</span>-like commands, <span
-class="cmtt-10">\mgls </span>unsets this flag. Unlike the
-<span
-class="cmtt-10">\glstext</span>-like commands, all the commands described in <a
-href="#sec:mglslike"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.11</span> </a><a
-href="#sec:mglslike">Variants
-of mgls<!--tex4ht:ref: sec:mglslike --></a> (including commands like <span
-class="cmtt-10">\mglsname</span>) unset this flag, even if the
-elements use commands like <span
-class="cmtt-10">\glsname </span>that don&#8217;t unset the entry&#8217;s <a
- id="dx1-53002"></a>first use
-flag.
-</p><!--l. 9007--><p class="indent" > You can determine whether or not a multi-entry set has been marked as used
-with:
-</p><!--l. 9009--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-53003"></a> <span
-class="cmtt-10">\ifmglsused{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9011--><p class="noindent" >
-You can (globally) unset the flag (mark the set as having been referenced)
-with:
-</p><!--l. 9014--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-53004"></a> <span
-class="cmtt-10">\mglsunset{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9016--><p class="noindent" >
-or reset it with:
-</p><!--l. 9018--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-53005"></a> <span
-class="cmtt-10">\mglsreset{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9020--><p class="noindent" >
-There are also local versions of these commands:
-</p><!--l. 9022--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-53006"></a> <span
-class="cmtt-10">\mglslocalunset{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9024--><p class="noindent" >
-and
-</p><!--l. 9026--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-53007"></a> <span
-class="cmtt-10">\mglslocalreset{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9028--><p class="noindent" >
-</p><!--l. 9030--><p class="indent" > To unset all multi-entries:
-</p><!--l. 9031--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-53008"></a> <span
-class="cmtt-10">\mglsunsetall </span></div><hr>
-</p><!--l. 9033--><p class="noindent" >
-To reset all multi-entries:
-
-
-
-</p><!--l. 9035--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-53009"></a> <span
-class="cmtt-10">\mglsresetall </span></div><hr>
-</p><!--l. 9037--><p class="noindent" >
-</p><!--l. 9039--><p class="indent" > Note that unsetting or resetting any of the individual element <a
- id="dx1-53010"></a><a
-href="#glo:firstuseflag">first use flags</a>
-doesn&#8217;t affect the multi-entry flag. Similarly, unsetting or resetting the multi-entry
-flag doesn&#8217;t affect the <a
- id="dx1-53011"></a>first use flags of the individual elements.
-</p><!--l. 9044--><p class="noindent" >
-</p>
-<!--l. 9044--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6.8 </span> <a
- id="sec:multiglscategory"></a>Multi-Entry Category</h3>
-<!--l. 9047--><p class="noindent" >A multi-entry set may have an associated category set using the <span
-class="cmss-10">category </span>key
-described in <a
-href="#sec:multiglsoptions"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.9</span> </a><a
-href="#sec:multiglsoptions">Multi-Entry Settings<!--tex4ht:ref: sec:multiglsoptions --></a>. This isn&#8217;t set by default,
-but if it is set the category may have attributes set in the usual way. The multi-entry
-category is independent of the individual entry categories. The following attribute is
-recognised by commands like <span
-class="cmtt-10">\mgls</span>:
- </p><dl class="description"><dt class="description">
-<a
- id="catattr.multioptions"></a><span
-class="cmssbx-10">multioptions</span><a
- id="dx1-54001"></a> </dt><dd
-class="description">default options to apply to any multi-entry set with the given
- category. These can be overridden by the first optional argument of
- <span
-class="cmtt-10">\multiglossaryentry </span>or by the <span
-class="cmss-10">setup </span>key in the first optional argument
- of commands like <span
-class="cmtt-10">\mgls</span>.
- </dd></dl>
-<!--l. 9064--><p class="indent" > Note that you can&#8217;t access the category or its attributes via the multi-entry label
-(for example, with <span
-class="cmtt-10">\glshasattribute</span>). If you need to access the current
-multi-entry&#8217;s category within any of the <span
-class="cmtt-10">\mgls</span>-like hooks (<a
-href="#sec:mglselementhooks"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.5</span>
-</a><a
-href="#sec:mglselementhooks">mgls Element Hooks<!--tex4ht:ref: sec:mglselementhooks --></a>), you can obtain the category with <span
-class="cmtt-10">\mglscurrentcategory </span>and
-use commands like <span
-class="cmtt-10">\glshascategoryattribute</span>.
-</p><!--l. 9071--><p class="noindent" >
-</p>
-<!--l. 9071--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6.9 </span> <a
- id="sec:multiglsoptions"></a>Multi-Entry Settings</h3>
-<!--l. 9074--><p class="noindent" >The settings that govern all multi-entries can be set using:
-</p><!--l. 9075--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-55001"></a> <span
-class="cmtt-10">\multiglossaryentrysetup{</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9077--><p class="noindent" >
-The &#x27E8;<span
-class="cmti-10">options</span>&#x27E9; are the same as for <span
-class="cmtt-10">\multiglossaryentry</span>. Options may also be set
-according to the multi-entry category attribute <a
-href="#catattr.multioptions"><span
-class="cmss-10">multioptions</span></a><a
- id="dx1-55002"></a>.
-</p><!--l. 9082--><p class="indent" > Whenever the <span
-class="cmtt-10">\mgls</span>-like commands are used, options are applied in the following
-order:
- </p><ol class="enumerate1" >
- <li
- class="enumerate" id="x1-55004x1">general options identified by <span
-class="cmtt-10">\multiglossaryentrysetup</span>;
-
-
-
- </li>
- <li
- class="enumerate" id="x1-55006x2">the category key is assigned if it&#8217;s in the general options,
- <span
-class="cmtt-10">\multiglossaryentry </span>or <span
-class="cmss-10">setup </span>key;
- </li>
- <li
- class="enumerate" id="x1-55008x3"><a
-href="#catattr.multioptions"><span
-class="cmss-10">multioptions</span></a><a
- id="dx1-55009"></a> category attribute (if set);
- </li>
- <li
- class="enumerate" id="x1-55011x4">any options provided in the first optional argument of
- <span
-class="cmtt-10">\multiglossaryentry</span>;
- </li>
- <li
- class="enumerate" id="x1-55013x5">any options provided in the <span
-class="cmss-10">setup </span>key in the first optional argument of the
- <span
-class="cmtt-10">\mgls</span>-like command.</li></ol>
-<!--l. 9099--><p class="indent" > These options are described below.
-</p><!--l. 9101--><p class="noindent" >
-</p>
-<!--l. 9101--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">6.9.1 </span> <a
- id="sec:multiglsoptionsindexing"></a>Indexing</h4>
- <dl class="description"><dt class="description">
-<span
-class="cmssbx-10">indexmain</span> </dt><dd
-class="description">This setting may take one of the following values:
- <dl class="description"><dt class="description">
- <span
-class="cmssbx-10">false</span> </dt><dd
-class="description">don&#8217;t index the main entry;
- </dd><dt class="description">
- <span
-class="cmssbx-10">true</span> </dt><dd
-class="description">index the main entry;
- </dd><dt class="description">
- <span
-class="cmssbx-10">first</span> </dt><dd
-class="description">only index the main entry if it&#8217;s the first use (of the main entry).</dd></dl>
- <!--l. 9113--><p class="noindent" >The default is <span
-class="cmss-10">true</span>.
- </p></dd><dt class="description">
-<span
-class="cmssbx-10">indexothers</span> </dt><dd
-class="description">This setting may take one of the following values:
- <dl class="description"><dt class="description">
- <span
-class="cmssbx-10">false</span> </dt><dd
-class="description">don&#8217;t index the other entries;
- </dd><dt class="description">
- <span
-class="cmssbx-10">true</span> </dt><dd
-class="description">index the other entries;
- </dd><dt class="description">
- <span
-class="cmssbx-10">first</span> </dt><dd
-class="description">only index the other entries if it&#8217;s the first use (of the non-main
- entry).</dd></dl>
- <!--l. 9123--><p class="noindent" >The default is <span
-class="cmss-10">first</span>.</p></dd></dl>
-
-
-
-<!--l. 9126--><p class="noindent" >
-</p>
-<!--l. 9126--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">6.9.2 </span> <a
- id="sec:multiglsoptionsencap"></a>Location Formats (Encaps)</h4>
- <dl class="description"><dt class="description">
-<span
-class="cmssbx-10">encapmain</span> </dt><dd
-class="description">This setting value should be the value to pass to <span
-class="cmss-10">format</span><a
- id="dx1-57001"></a> for the main
- entry. (The location encapsulator.) The default is <span
-class="cmtt-10">glsnumberformat</span>.
- </dd><dt class="description">
-<span
-class="cmssbx-10">encapothers</span> </dt><dd
-class="description">This setting value should be the value to pass to <span
-class="cmss-10">format</span><a
- id="dx1-57002"></a> for the
- other (not main) entries. (The location encapsulator.) The default is
- <span
-class="cmtt-10">glsnumberformat</span>.</dd></dl>
-<!--l. 9139--><p class="noindent" >
-</p>
-<!--l. 9139--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">6.9.3 </span> <a
- id="sec:multiglsoptionspostlink"></a>Post-Link Hooks</h4>
- <dl class="description"><dt class="description">
-<span
-class="cmssbx-10">postlinks</span> </dt><dd
-class="description">This setting determines whether or not to enable the individual
- element&#8217;s post-link hook (<span
-class="cmtt-10">\glspostlinkhook</span><a
- id="dx1-58001"></a>). The value may be one
- of:
- <dl class="description"><dt class="description">
- <span
-class="cmssbx-10">none</span> </dt><dd
-class="description">suppress the post-link hook for all elements;
- </dd><dt class="description">
- <span
-class="cmssbx-10">all</span> </dt><dd
-class="description">don&#8217;t suppress the post-link hook for all elements;
- </dd><dt class="description">
- <span
-class="cmssbx-10">notlast</span> </dt><dd
-class="description">only suppress the post-link hook for the last element;
- </dd><dt class="description">
- <span
-class="cmssbx-10">mainnotlast</span> </dt><dd
-class="description">suppress the post-link hook for all &#8220;other&#8221; (not main)
- elements and for the last element (so only the main element will have
- its post-link hook as long as it&#8217;s not the last element);
- </dd><dt class="description">
- <span
-class="cmssbx-10">mainonly</span> </dt><dd
-class="description">suppress the post-link hook for all &#8220;other&#8221; (not main) elements;
- </dd><dt class="description">
- <span
-class="cmssbx-10">othernotlast</span> </dt><dd
-class="description">suppress the post-link hook for the main element and for
- the last element (so only the other elements will have their post-link
- hook as long as the element isn&#8217;t the last one);
- </dd><dt class="description">
- <span
-class="cmssbx-10">otheronly</span> </dt><dd
-class="description">suppress the post-link hook for the main element.</dd></dl>
- <!--l. 9163--><p class="noindent" >The default is <span
-class="cmss-10">postlinks=none</span>.
-
-
-
- </p></dd><dt class="description">
-<span
-class="cmssbx-10">mpostlink</span> </dt><dd
-class="description">This setting determines whether or not to enable the multi-entry post-link
- hook (<a
-href="#sec:mglspostlinkhook"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.6</span> </a><a
-href="#sec:mglspostlinkhook">Post-Link Hook<!--tex4ht:ref: sec:mglspostlinkhook --></a>). The value may be one
- of:
- <dl class="description"><dt class="description">
- <span
-class="cmssbx-10">false</span> </dt><dd
-class="description">suppress the multi-entry post-link hook;
- </dd><dt class="description">
- <span
-class="cmssbx-10">true</span> </dt><dd
-class="description">enable the multi-entry post-link hook;
- </dd><dt class="description">
- <span
-class="cmssbx-10">firstonly</span> </dt><dd
-class="description">enable the multi-entry post-link hook only for the first use of the
- multi-entry;
- </dd><dt class="description">
- <span
-class="cmssbx-10">usedonly</span> </dt><dd
-class="description">enable the multi-entry post-link hook only for the subsequent
- (not first) use of the multi-entry.</dd></dl>
- <!--l. 9176--><p class="noindent" >The default is <span
-class="cmss-10">mpostlink=true</span>. If the value is omitted, <span
-class="cmss-10">true </span>is assumed.
- </p></dd><dt class="description">
-<span
-class="cmssbx-10">mpostlinkelement</span> </dt><dd
-class="description">This setting indicates which post-link hook should be used if the
- multi-entry post-link hook has been enabled. Allowed values:
- <dl class="description"><dt class="description">
- <span
-class="cmssbx-10">last</span> </dt><dd
-class="description">use <span
-class="cmtt-10">\mglslastelementpostlinkhook</span><a
- id="dx1-58002"></a> (that is, use the post-link hook
- for the last element);
- </dd><dt class="description">
- <span
-class="cmssbx-10">main</span> </dt><dd
-class="description">use <span
-class="cmtt-10">\mglslastmainpostlinkhook</span><a
- id="dx1-58003"></a> (that is, use the post-link hook
- for the main element);
- </dd><dt class="description">
- <span
-class="cmssbx-10">custom</span> </dt><dd
-class="description">use <span
-class="cmtt-10">\mglslastcustompostlinkhook</span><a
- id="dx1-58004"></a>.</dd></dl>
- </dd></dl>
-<!--l. 9190--><p class="noindent" >Note that some combinations may cause a repeated hook.
-</p><!--l. 9192--><p class="noindent" >
-</p>
-<!--l. 9192--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">6.9.4 </span> <a
- id="sec:multiglsoptionsfixes"></a>Prefixes and Suffixes</h4>
-<!--l. 9195--><p class="noindent" >See <a
-href="#sec:mglsfixes"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.3</span> </a><a
-href="#sec:mglsfixes">Prefixes and Suffixes<!--tex4ht:ref: sec:mglsfixes --></a> for more information on prefixes and
-suffixes. Note that the prefixes and suffixes are not affected by case-changing
-commands such as <span
-class="cmtt-10">\Mgls </span>or <span
-class="cmtt-10">\MGLS</span>. If you want a prefix to obey case-changing, use
-the <span
-class="cmtt-10">\mpgls</span>-like commands instead (<a
-href="#sec:mpgls"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.11.4</span> </a><a
-href="#sec:mpgls">Support for glossaries-prefix
-(pgls)<!--tex4ht:ref: sec:mpgls --></a>).
-
-
-
- </p><dl class="description"><dt class="description">
-<span
-class="cmbx-10">firstprefix</span> </dt><dd
-class="description">The prefix to use on first use of the multi-entry.
- </dd><dt class="description">
-<span
-class="cmbx-10">usedprefix</span> </dt><dd
-class="description">The prefix to use on subsequent use of the multi-entry.
- </dd><dt class="description">
-<span
-class="cmbx-10">firstsuffix</span> </dt><dd
-class="description">The suffix to use on first use of the multi-entry.
- </dd><dt class="description">
-<span
-class="cmbx-10">usedsuffix</span> </dt><dd
-class="description">The suffix to use on subsequent use of the multi-entry.</dd></dl>
-<!--l. 9216--><p class="noindent" >
-</p>
-<!--l. 9216--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">6.9.5 </span> <a
- id="sec:multiglsoptionsskip"></a>Skipping Elements</h4>
- <dl class="description"><dt class="description">
-<span
-class="cmssbx-10">firstskipmain</span> </dt><dd
-class="description">This is a boolean setting. If <span
-class="cmss-10">true</span>, the main element will be omitted
- on (multi-entry) first use.
- </dd><dt class="description">
-<span
-class="cmssbx-10">firstskipothers</span> </dt><dd
-class="description">This is a boolean setting. If <span
-class="cmss-10">true</span>, the other (non-main) elements
- will be omitted on (multi-entry) first use.
- </dd><dt class="description">
-<span
-class="cmssbx-10">usedskipmain</span> </dt><dd
-class="description">This is a boolean setting. If <span
-class="cmss-10">true</span>, the main element will be
- omitted on (multi-entry) subsequent use.
- </dd><dt class="description">
-<span
-class="cmssbx-10">usedskipothers</span> </dt><dd
-class="description">This is a boolean setting. If <span
-class="cmss-10">true</span>, the other (non-main) elements
- will be omitted on (multi-entry) subsequent use.
- </dd></dl>
-<!--l. 9236--><p class="noindent" >The skip options apply to the multi-entry first use flag not the individual element first
-use. See <a
-href="#sec:mglsfirstuse"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.7</span> </a><a
-href="#sec:mglsfirstuse">Multi-Entry First Use<!--tex4ht:ref: sec:mglsfirstuse --></a>.
-</p><!--l. 9239--><p class="indent" > Note that it is technically possible to set the skip options so that both the main
-and the other elements are skipped. However, by default, this will generate a warning
-and only the final optional argument (the &#x27E8;<span
-class="cmti-10">insert</span>&#x27E9;) will be displayed. There won&#8217;t
-be a loop over all elements so the commands set at each iteration, such as
-<span
-class="cmtt-10">\mglscurrentlabel</span>, won&#8217;t be defined.
-</p><!--l. 9246--><p class="indent" > The warning and the insertion of the &#x27E8;<span
-class="cmti-10">insert</span>&#x27E9; is done by:
-</p><!--l. 9248--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-60001"></a> <span
-class="cmtt-10">\glsxtrmglsWarnAllSkipped{</span>&#x27E8;<span
-class="cmitt-10">message</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">cs</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9250--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">message</span>&#x27E9; is the warning message and &#x27E8;<span
-class="cmti-10">cs</span>&#x27E9; is the control sequence that
-encapsulates the entire content (including hyperlink and the <span
-class="cmss-10">textformat </span>setting, if
-enabled).
-
-
-
-</p><!--l. 9255--><p class="indent" > If, for some particular reason, you want this scenario, you can redefine this
-command to omit the warning.
-</p><!--l. 9258--><p class="noindent" >
-</p>
-<!--l. 9258--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">6.9.6 </span> <a
- id="sec:multiglsoptionsgeneral"></a>General</h4>
- <dl class="description"><dt class="description">
-<span
-class="cmssbx-10">hyper</span> </dt><dd
-class="description">This setting may take one of the following values:
- <dl class="description"><dt class="description">
- <span
-class="cmssbx-10">none</span> </dt><dd
-class="description">no hyperlinks;
- </dd><dt class="description">
- <span
-class="cmssbx-10">allmain</span> </dt><dd
-class="description">encapsulate the entire content with a single hyperlink to the main
- entry&#8217;s target;
- </dd><dt class="description">
- <span
-class="cmssbx-10">mainonly</span> </dt><dd
-class="description">only hyperlink the main entry;
- </dd><dt class="description">
- <span
-class="cmssbx-10">individual</span> </dt><dd
-class="description">hyperlink each entry individually;
- </dd><dt class="description">
- <span
-class="cmssbx-10">otheronly</span> </dt><dd
-class="description">only hyperlink the other entries;
- </dd><dt class="description">
- <span
-class="cmssbx-10">notmainfirst</span> </dt><dd
-class="description">don&#8217;t hyperlink the main entry on multi-entry first use;
- </dd><dt class="description">
- <span
-class="cmssbx-10">nototherfirst</span> </dt><dd
-class="description">don&#8217;t hyperlink the other entries on multi-entry first use;
- </dd><dt class="description">
- <span
-class="cmssbx-10">notfirst</span> </dt><dd
-class="description">don&#8217;t hyperlink any entries on multi-entry first use.</dd></dl>
- <!--l. 9278--><p class="noindent" >The default is <span
-class="cmss-10">individual</span>.
- </p></dd><dt class="description">
-<span
-class="cmssbx-10">textformat</span> </dt><dd
-class="description">This setting value should be the control sequence name (without the
- leading backslash) of the command used to encapsulate the entire content. The
- default is <span
-class="cmtt-10">@firstofone</span>.
- </dd><dt class="description">
-<span
-class="cmssbx-10">category</span> </dt><dd
-class="description">The category to apply to the multi-entry. This is independent of
- the categories of each of the elements. The default is no category. See
- <a
-href="#sec:multiglscategory"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.8</span> </a><a
-href="#sec:multiglscategory">Multi-Entry Category<!--tex4ht:ref: sec:multiglscategory --></a>.
- </dd><dt class="description">
-<span
-class="cmssbx-10">mglsopts</span> </dt><dd
-class="description">Default options to pass to <span
-class="cmtt-10">\mgls</span>. Note that <span
-class="cmss-10">setup </span>can&#8217;t be used within this
- value.
- </dd></dl>
-
-
-
-<!--l. 9293--><p class="noindent" >
-</p>
-<!--l. 9293--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6.10 </span> <a
- id="sec:mglsopts"></a>mgls Options</h3>
-<!--l. 9296--><p class="noindent" >The &#x27E8;<span
-class="cmti-10">options</span>&#x27E9; for <span
-class="cmtt-10">\mgls </span>(and similar commands) are listed below. Any additional
-options provided will be appended to the <span
-class="cmss-10">all </span>value. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-210">
-\mgls[counter=chapter]{cbot}
-</pre>
-<!--l. 9301--><p class="nopar" > is equivalent to:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-211">
-\mgls[all={counter=chapter}]{cbot}
-</pre>
-<!--l. 9305--><p class="nopar" > Whereas:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-212">
-\mgls[counter=chapter,all={counter=section}]{cbot}
-</pre>
-<!--l. 9309--><p class="nopar" > is treated as:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-213">
-\mgls[all={counter=section,counter=chapter}]{cbot}
-</pre>
-<!--l. 9313--><p class="nopar" > which has the same effect as:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-214">
-\mgls[all={counter=chapter}]{cbot}
-</pre>
-<!--l. 9317--><p class="nopar" > (The descriptions below reference <span
-class="cmtt-10">\gls </span>which is used internally by <span
-class="cmtt-10">\mgls</span>. Replace
-this with <span
-class="cmtt-10">\glspl </span>etc as applicable for the variants, such as <span
-class="cmtt-10">\mglspl</span>.)
- </p><dl class="description"><dt class="description">
-<span
-class="cmssbx-10">setup</span> </dt><dd
-class="description">The value should be a list of any options that can be passed
- to <span
-class="cmtt-10">\multiglossaryentrysetup</span>. These options will override any
- conflicting options that were supplied to <span
-class="cmtt-10">\multiglossaryentry </span>or
- <span
-class="cmtt-10">\multiglossaryentrysetup</span>. Note that <span
-class="cmss-10">mgls </span>can&#8217;t be used within this
- value.
- </dd><dt class="description">
-<span
-class="cmssbx-10">all</span> </dt><dd
-class="description">The value should be a list of any options that can be passed to <span
-class="cmtt-10">\gls</span>. These
- options will be passed to each instance of <span
-class="cmtt-10">\gls </span>and will override any
- conflicting setting in <span
-class="cmss-10">setup</span>.
- </dd><dt class="description">
-<span
-class="cmssbx-10">main</span> </dt><dd
-class="description">The value should be a list of any options that can be passed to <span
-class="cmtt-10">\gls</span>.
- These options will be passed to the instance of <span
-class="cmtt-10">\gls </span>used for the main
- label and will override any conflicting setting in <span
-class="cmss-10">all</span>.
- </dd><dt class="description">
-<span
-class="cmssbx-10">others</span> </dt><dd
-class="description">The value should be a list of any options that can be passed to <span
-class="cmtt-10">\gls</span>.
- These options will be passed to each instance of <span
-class="cmtt-10">\gls </span>used for the other
- (not main) labels and will override any conflicting setting in <span
-class="cmss-10">all</span>.
- </dd><dt class="description">
-<span
-class="cmssbx-10">hyper</span> </dt><dd
-class="description">a boolean option to determine whether or not to use hyperlinks (if
- supported). This may cause a conflict with other options, but is essentially
- provided to allow the starred version of <span
-class="cmtt-10">\mgls </span>to switch off all hyperlinks.
- </dd><dt class="description">
-<span
-class="cmssbx-10">multiunset</span> </dt><dd
-class="description">This only applies to the multi-entry first use flag, described in
- <a
-href="#sec:mglsfirstuse"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.7</span> </a><a
-href="#sec:mglsfirstuse">Multi-Entry First Use<!--tex4ht:ref: sec:mglsfirstuse --></a>, not the <a
- id="dx1-62001"></a><a
-href="#glo:firstuseflag">first use flags</a> of the
- elements. The value may be one of:
- <dl class="description"><dt class="description">
- </dt><dd
-class="description"><span
-class="cmss-10">global </span>globally unset the flag (default);
- </dd><dt class="description">
- </dt><dd
-class="description"><span
-class="cmss-10">local </span>locally unset the flag;
- </dd><dt class="description">
- </dt><dd
-class="description"><span
-class="cmss-10">none </span>don&#8217;t unset the flag.</dd></dl>
-
-
-
- </dd><dt class="description">
-<span
-class="cmssbx-10">presetlocal</span> </dt><dd
-class="description">a boolean option that governs whether or not the following options
- should have a local or global effect. The default is <span
-class="cmss-10">presetlocal=false</span>
- (global).
- </dd><dt class="description">
-<span
-class="cmssbx-10">resetall</span> </dt><dd
-class="description">a boolean option to determine whether or not to reset all entries in &#x27E8;<span
-class="cmti-10">label list</span>&#x27E9;
- <span
-class="cmti-10">before </span>using <span
-class="cmtt-10">\gls</span>. This option refers to the individual entry&#8217;s <a
- id="dx1-62002"></a><a
-href="#glo:firstuseflag">first use flag</a> not
- the multi-set flag.
- </dd><dt class="description">
-<span
-class="cmssbx-10">resetmain</span> </dt><dd
-class="description">a boolean option to determine whether or not to reset the main entry
- <span
-class="cmti-10">before </span>using <span
-class="cmtt-10">\gls</span>. This option refers to the individual entry&#8217;s <a
- id="dx1-62003"></a>first use flag not
- the multi-set flag.
- </dd><dt class="description">
-<span
-class="cmssbx-10">resetothers</span> </dt><dd
-class="description">a boolean option to determine whether or not to reset the other (not
- main) entries <span
-class="cmti-10">before </span>using <span
-class="cmtt-10">\gls</span>. This option refers to the individual entry&#8217;s <a
- id="dx1-62004"></a>first
- use flag not the multi-set flag.
- </dd><dt class="description">
-<span
-class="cmssbx-10">unsetall</span> </dt><dd
-class="description">a boolean option to determine whether or not to unset all entries in &#x27E8;<span
-class="cmti-10">label list</span>&#x27E9;
- <span
-class="cmti-10">before </span>using <span
-class="cmtt-10">\gls</span>. This option refers to the individual entry&#8217;s <a
- id="dx1-62005"></a>first use flag not
- the multi-set flag.
- </dd><dt class="description">
-<span
-class="cmssbx-10">unsetmain</span> </dt><dd
-class="description">a boolean option to determine whether or not to unset the main entry
- <span
-class="cmti-10">before </span>using <span
-class="cmtt-10">\gls</span>. This option refers to the individual entry&#8217;s <a
- id="dx1-62006"></a>first use flag not
- the multi-set flag.
- </dd><dt class="description">
-<span
-class="cmssbx-10">unsetothers</span> </dt><dd
-class="description">a boolean option to determine whether or not to unset the other (not
- main) entries <span
-class="cmti-10">before </span>using <span
-class="cmtt-10">\gls</span>. This option refers to the individual entry&#8217;s <a
- id="dx1-62007"></a>first
- use flag not the multi-set flag.</dd></dl>
-<!--l. 9392--><p class="noindent" >The <span
-class="cmss-10">reset</span><span
-class="cmss-10">&#x2026; </span>options all use:
-</p><!--l. 9393--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-62008"></a> <span
-class="cmtt-10">\mglselementreset{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9395--><p class="noindent" >
-The <span
-class="cmss-10">unset</span><span
-class="cmss-10">&#x2026; </span>options all use:
-</p><!--l. 9397--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-62009"></a> <span
-class="cmtt-10">\mglselementunset{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9399--><p class="noindent" >
-These take the <span
-class="cmss-10">presetlocal </span>into account.
-</p><!--l. 9402--><p class="indent" > An alternative way of resetting the other elements is to use:
-</p><!--l. 9403--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-62010"></a> <span
-class="cmtt-10">\mglsunsetothers{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9405--><p class="noindent" >
-or for a local reset:
-</p><!--l. 9407--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-62011"></a> <span
-class="cmtt-10">\mglslocalunsetothers{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-
-
-
-</p><!--l. 9409--><p class="noindent" >
-</p><!--l. 9411--><p class="noindent" >
-</p>
-<!--l. 9411--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6.11 </span> <a
- id="sec:mglslike"></a>Variants of mgls</h3>
-<!--l. 9414--><p class="noindent" >The commands listed in this section all behave like <span
-class="cmtt-10">\mgls</span>. These (including <span
-class="cmtt-10">\mgls</span>
-itself) are collectively referred to as the <span
-class="cmtt-10">\mgls</span>-like commands. All commands unset
-the multi-entry first use flag (unless the <span
-class="cmss-10">multiunset=none </span>option is applied). Only
-those commands that use the <span
-class="cmtt-10">\gls</span>-like commands (such as <span
-class="cmtt-10">\gls </span>or <span
-class="cmtt-10">\glspl</span>) will
-unset the individual entry <a
- id="dx1-63001"></a><a
-href="#glo:firstuseflag">first use flag</a>.
-</p><!--l. 9421--><p class="noindent" >
-</p>
-<!--l. 9421--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">6.11.1 </span> <a
- id="sec:mglsbasic"></a>gls-like</h4>
-<!--l. 9424--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-64001"></a> <span
-class="cmtt-10">\mglspl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9426--><p class="noindent" >
-This uses <span
-class="cmtt-10">\glspl </span>instead of <span
-class="cmtt-10">\gls </span>for each entry.
-</p><!--l. 9429--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-64002"></a> <span
-class="cmtt-10">\mglsmainpl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9431--><p class="noindent" >
-This uses <span
-class="cmtt-10">\glspl </span>instead of <span
-class="cmtt-10">\gls </span>for the main entry and <span
-class="cmtt-10">\gls </span>for all the other
-entries.
-</p><!--l. 9435--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-64003"></a> <span
-class="cmtt-10">\Mgls[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9437--><p class="noindent" >
-This uses <span
-class="cmtt-10">\Gls </span>for the first entry and <span
-class="cmtt-10">\gls </span>for the other entries.
-</p><!--l. 9441--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-64004"></a> <span
-class="cmtt-10">\MGls[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9443--><p class="noindent" >
-This uses <span
-class="cmtt-10">\Gls </span>for all entries.
-</p><!--l. 9446--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-64005"></a> <span
-class="cmtt-10">\Mglspl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9448--><p class="noindent" >
-This uses <span
-class="cmtt-10">\Glspl </span>for the first entry and <span
-class="cmtt-10">\glspl </span>for the other entries.
-</p><!--l. 9452--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-64006"></a> <span
-class="cmtt-10">\Mglsmainpl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9454--><p class="noindent" >
-The first entry starts with an upper case. The plural form is used for the main
-entry.
-</p><!--l. 9458--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-64007"></a> <span
-class="cmtt-10">\MGlspl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9460--><p class="noindent" >
-This uses <span
-class="cmtt-10">\Glspl </span>for all entries.
-</p><!--l. 9463--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-64008"></a> <span
-class="cmtt-10">\MGlsmainpl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9465--><p class="noindent" >
-This uses <span
-class="cmtt-10">\Glspl </span>for the main entry and <span
-class="cmtt-10">\Gls </span>for all other entries.
-</p><!--l. 9468--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-64009"></a> <span
-class="cmtt-10">\MGLS[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-
-
-
-</p><!--l. 9470--><p class="noindent" >
-This uses <span
-class="cmtt-10">\GLS </span>instead of <span
-class="cmtt-10">\gls </span>for each entry.
-</p><!--l. 9473--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-64010"></a> <span
-class="cmtt-10">\MGLSpl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9475--><p class="noindent" >
-This uses <span
-class="cmtt-10">\GLSpl </span>instead of <span
-class="cmtt-10">\gls </span>for each entry.
-</p><!--l. 9478--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-64011"></a> <span
-class="cmtt-10">\MGLSmainpl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9480--><p class="noindent" >
-This uses all caps for all entries and <span
-class="cmtt-10">\GLSpl </span>for the main entry.
-</p><!--l. 9484--><p class="noindent" >
-</p>
-<!--l. 9484--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">6.11.2 </span> <a
- id="sec:mglsabbrv"></a>Abbreviations</h4>
-<!--l. 9487--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-65001"></a> <span
-class="cmtt-10">\mglsshort[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9489--><p class="noindent" >
-This will use <span
-class="cmtt-10">\glsxtrshort </span>for any entries that have the <span
-class="cmss-10">short</span><a
- id="dx1-65002"></a> key set and will use
-<span
-class="cmtt-10">\glstext </span>otherwise.
-</p><!--l. 9493--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-65003"></a> <span
-class="cmtt-10">\mglslong[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9495--><p class="noindent" >
-This will use <span
-class="cmtt-10">\glsxtrlong </span>for any entries that have the <span
-class="cmss-10">long</span><a
- id="dx1-65004"></a> key set and will use
-<span
-class="cmtt-10">\glstext </span>otherwise.
-</p><!--l. 9499--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-65005"></a> <span
-class="cmtt-10">\mglsfull[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9501--><p class="noindent" >
-This will use <span
-class="cmtt-10">\glsxtrfull </span>for any entries that have the <span
-class="cmss-10">short</span><a
- id="dx1-65006"></a> key set and will use
-<span
-class="cmtt-10">\glsfirst </span>otherwise.
-</p><!--l. 9505--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-65007"></a> <span
-class="cmtt-10">\Mglsshort[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9507--><p class="noindent" >
-As <span
-class="cmtt-10">\mglsshort </span>but with an initial capital on the first entry.
-</p><!--l. 9510--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-65008"></a> <span
-class="cmtt-10">\Mglslong[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9512--><p class="noindent" >
-As <span
-class="cmtt-10">\mglslong </span>but with an initial capital on the first entry.
-</p><!--l. 9515--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-65009"></a> <span
-class="cmtt-10">\Mglsfull[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9517--><p class="noindent" >
-As <span
-class="cmtt-10">\mglsfull </span>but with an initial capital on the first entry.
-</p><!--l. 9520--><p class="noindent" >
-</p>
-<!--l. 9520--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">6.11.3 </span> <a
- id="sec:mglsotherfields"></a>Other Fields</h4>
-<!--l. 9523--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-66001"></a> <span
-class="cmtt-10">\mglsname[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9525--><p class="noindent" >
-This uses <span
-class="cmtt-10">\glsname </span>instead of <span
-class="cmtt-10">\gls </span>for each entry.
-</p><!--l. 9528--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-66002"></a> <span
-class="cmtt-10">\MGlsname[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9530--><p class="noindent" >
-This uses <span
-class="cmtt-10">\Glsname </span>instead of <span
-class="cmtt-10">\gls </span>for each entry.
-
-
-
-</p><!--l. 9533--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-66003"></a> <span
-class="cmtt-10">\Mglsname[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9535--><p class="noindent" >
-This uses <span
-class="cmtt-10">\Glsname </span>instead of <span
-class="cmtt-10">\gls </span>for the first entry and <span
-class="cmtt-10">\glsname </span>for all the other
-entries.
-</p><!--l. 9539--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-66004"></a> <span
-class="cmtt-10">\mglssymbol[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9541--><p class="noindent" >
-This uses <span
-class="cmtt-10">\glssymbol </span>if the <span
-class="cmss-10">symbol</span><a
- id="dx1-66005"></a> key has been set otherwise it uses <span
-class="cmtt-10">\gls </span>for each
-element.
-</p><!--l. 9545--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-66006"></a> <span
-class="cmtt-10">\MGlssymbol[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9547--><p class="noindent" >
-This uses <span
-class="cmtt-10">\glssymbol </span>if the <span
-class="cmss-10">symbol</span><a
- id="dx1-66007"></a> key has been set otherwise it uses <span
-class="cmtt-10">\Gls </span>for each
-element. (Note that no case change is applied to the symbol as this usually isn&#8217;t
-appropriate.)
-</p><!--l. 9552--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-66008"></a> <span
-class="cmtt-10">\Mglssymbol[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9554--><p class="noindent" >
-As above, but <span
-class="cmtt-10">\Gls </span>is only used for the first element (if it doesn&#8217;t have the <span
-class="cmss-10">symbol</span><a
- id="dx1-66009"></a>
-key set).
-</p><!--l. 9558--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-66010"></a> <span
-class="cmtt-10">\mglsusefield[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9560--><p class="noindent" >
-Use <span
-class="cmtt-10">\glsdisp{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field value</span>&#x27E9;&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span>if the field given by:
-</p><!--l. 9563--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-66011"></a> <span
-class="cmtt-10">\mglsfield </span></div><hr>
-</p><!--l. 9565--><p class="noindent" >
-exists, otherwise use <span
-class="cmtt-10">\gls</span>. By default, this is <span
-class="cmtt-10">useri </span>(corresponding to the
-<span
-class="cmss-10">user1</span><a
- id="dx1-66012"></a> key). If you redefine <span
-class="cmtt-10">\mglsfield</span>, you will need to use the internal
-name.
-</p><!--l. 9570--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-66013"></a> <span
-class="cmtt-10">\Mglsusefield[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9572--><p class="noindent" >
-As <span
-class="cmtt-10">\mglsusefield </span>but the first element starts with an initial uppercase.
-</p><!--l. 9576--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-66014"></a> <span
-class="cmtt-10">\MGlsusefield[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9578--><p class="noindent" >
-As <span
-class="cmtt-10">\mglsusefield </span>but each element starts with an initial uppercase.
-</p><!--l. 9582--><p class="noindent" >You can use the pre-element hook <span
-class="cmtt-10">\mglselementprehook </span>to locally redefine
-<span
-class="cmtt-10">\mglsfirst</span>. Examples:
- </p><ol class="enumerate1" >
- <li
- class="enumerate" id="x1-66016x1">if the multi-category is &#8220;sample&#8221; then use the <span
-class="cmss-10">user2</span><a
- id="dx1-66017"></a> field otherwise use the <span
-class="cmss-10">user1</span><a
- id="dx1-66018"></a>
- field:
-
-
-
- <pre class="verbatim" id="verbatim-215">
- \renewcommand{\mglselementprehook}{%
- &#x00A0;&#x00A0;\ifdefstring{\mglscurrentcategory}{sample}%
- &#x00A0;&#x00A0;{\renewcommand{\mglsfield}{userii}}%
- &#x00A0;&#x00A0;{\renewcommand{\mglsfield}{useri}}%
- }
-</pre>
- <!--l. 9593--><p class="nopar" >
- </p></li>
- <li
- class="enumerate" id="x1-66020x2">if the element&#8217;s category is &#8220;sample&#8221; then use the <span
-class="cmss-10">user2</span><a
- id="dx1-66021"></a> field otherwise use the
- <span
-class="cmss-10">user1</span><a
- id="dx1-66022"></a> field:
-
-
-
- <pre class="verbatim" id="verbatim-216">
- \renewcommand{\mglselementprehook}{%
- &#x00A0;&#x00A0;\glsifcategory{\mglscurrentlabel}{sample}%
- &#x00A0;&#x00A0;{\renewcommand{\mglsfield}{userii}}%
- &#x00A0;&#x00A0;{\renewcommand{\mglsfield}{useri}}%
- }
-</pre>
- <!--l. 9603--><p class="nopar" >
- </p></li>
- <li
- class="enumerate" id="x1-66024x3">if either the multi-entry&#8217;s category or the element&#8217;s category has the
- custom attribute &#8220;mglsfield&#8221; set then use it otherwise use the <span
-class="cmss-10">user1</span><a
- id="dx1-66025"></a>
- field:
-
-
-
- <pre class="verbatim" id="verbatim-217">
- \renewcommand{\mglselementprehook}{%
- &#x00A0;\glshascategoryattribute{\mglscurrentcategory}{mglsfield}%
- &#x00A0;{\renewcommand{\mglsfield}{\glsgetcategoryattribute{\mglscurrentcategory}{mglsfield}}}%
- &#x00A0;{%
- &#x00A0;&#x00A0;&#x00A0;\glshasattribute{\mglscurrentlabel}{mglsfield}%
- &#x00A0;&#x00A0;&#x00A0;{\renewcommand{\mglsfield}{\glsgetattribute{\mglscurrentlabel}{mglsfield}}}%
- &#x00A0;&#x00A0;&#x00A0;{\renewcommand{\mglsfield}{useri}}%
- &#x00A0;}%
- }
-</pre>
- <!--l. 9618--><p class="nopar" ></p></li></ol>
-<!--l. 9621--><p class="noindent" >
-</p>
-<!--l. 9621--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">6.11.4 </span> <a
- id="sec:mpgls"></a>Support for glossaries-prefix (pgls)</h4>
-<!--l. 9624--><p class="noindent" >If you load the <span
-class="cmss-10">glossaries-prefix</span><a
- id="dx1-67001"></a> package (either after <span
-class="cmss-10">glossaries-extra</span>) or with the <a
-href="#styopt.prefix"><span
-class="cmss-10">prefix</span></a><a
- id="dx1-67002"></a>
-package option, then the following commands will use one of the <span
-class="cmtt-10">\pgls</span>-like
-commands provided by that package. (See the <span
-class="cmss-10">glossaries </span>user manual for further
-details.)
-</p><!--l. 9630--><p class="indent" > If the <span
-class="cmss-10">glossaries-prefix </span>package hasn&#8217;t been loaded then <span
-class="cmtt-10">\gls </span>(or analogous
-case-changing variant) will be used instead and a warning is issued. The warning can
-be removed by redefining the following to do nothing:
-</p><!--l. 9634--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-67003"></a> <span
-class="cmtt-10">\mpglsWarning </span></div><hr>
-</p><!--l. 9636--><p class="noindent" >
-</p><!--l. 9638--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-67004"></a> <span
-class="cmtt-10">\mpgls[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9640--><p class="noindent" >
-Uses <span
-class="cmtt-10">\pgls </span>for the first element and <span
-class="cmtt-10">\gls </span>for the remaining elements.
-</p><!--l. 9644--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-67005"></a> <span
-class="cmtt-10">\mpglspl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9646--><p class="noindent" >
-Uses <span
-class="cmtt-10">\pglspl </span>for the first element and <span
-class="cmtt-10">\glspl </span>for the remaining elements.
-</p><!--l. 9650--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-67006"></a> <span
-class="cmtt-10">\mpglsmainpl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9652--><p class="noindent" >
-Only uses the plural form for the main element. The first element uses the prefixing
-command (<span
-class="cmtt-10">\pgls </span>or <span
-class="cmtt-10">\pglspl</span>, depending on whether the first element is the main
-element).
-</p><!--l. 9657--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-67007"></a> <span
-class="cmtt-10">\Mpgls[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9659--><p class="noindent" >
-Uses <span
-class="cmtt-10">\Pgls </span>for the first element and <span
-class="cmtt-10">\gls </span>for the remaining elements.
-</p><!--l. 9663--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-67008"></a> <span
-class="cmtt-10">\Mpglsmainpl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-
-
-
-</p><!--l. 9665--><p class="noindent" >
-Only uses the plural form for the main element. The first element uses the first-letter
-uppercase prefixing command (<span
-class="cmtt-10">\Pgls </span>or <span
-class="cmtt-10">\Pglspl</span>, depending on whether the first
-element is the main element).
-</p><!--l. 9671--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-67009"></a> <span
-class="cmtt-10">\MPGls[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9673--><p class="noindent" >
-Uses <span
-class="cmtt-10">\Pgls </span>for the first element and <span
-class="cmtt-10">\Gls </span>for the remaining elements.
-</p><!--l. 9677--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-67010"></a> <span
-class="cmtt-10">\MPGlspl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9679--><p class="noindent" >
-Uses <span
-class="cmtt-10">\Pglspl </span>for the first element and <span
-class="cmtt-10">\Glspl </span>for the remaining elements.
-</p><!--l. 9683--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-67011"></a> <span
-class="cmtt-10">\MPGlsmainpl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9685--><p class="noindent" >
-Only uses the plural form for the main element. The first element uses the prefixing
-command (<span
-class="cmtt-10">\Pgls </span>or <span
-class="cmtt-10">\Pglspl</span>, depending on whether the first element is the main
-element). All elements are converted to first letter uppercase.
-</p><!--l. 9691--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-67012"></a> <span
-class="cmtt-10">\MPGLS[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9693--><p class="noindent" >
-Uses <span
-class="cmtt-10">\PGLS </span>for the first element and <span
-class="cmtt-10">\GLS </span>for the remaining elements.
-</p><!--l. 9697--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-67013"></a> <span
-class="cmtt-10">\MPGLSpl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9699--><p class="noindent" >
-Uses <span
-class="cmtt-10">\PGLSpl </span>for the first element and <span
-class="cmtt-10">\GLSpl </span>for the remaining elements.
-</p><!--l. 9703--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-67014"></a> <span
-class="cmtt-10">\MPGLSmainpl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 9705--><p class="noindent" >
-Only uses the plural form for the main element. All elements are converted to
-uppercase. The first element uses the prefixing command (<span
-class="cmtt-10">\PGLS </span>or <span
-class="cmtt-10">\PGLSpl</span>,
-depending on whether the first element is the main element).
-</p><!--l. 9711--><p class="noindent" >
-</p>
-<!--l. 9711--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6.12 </span> <a
- id="sec:msee"></a>Cross-References</h3>
-<!--l. 9714--><p class="noindent" >Multi-entry labels may be used in the cross-referencing keys <span
-class="cmss-10">see</span><a
- id="dx1-68001"></a> and <span
-class="cmss-10">seealso</span><a
- id="dx1-68002"></a>. The
-formatting command will use:
-</p><!--l. 9717--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-68003"></a> <span
-class="cmtt-10">\mglsseefirstitem{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9719--><p class="noindent" >
-for the first item in the list (if it&#8217;s a multi-entry) and
-</p><!--l. 9721--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-68004"></a> <span
-class="cmtt-10">\mglsseeitem{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9723--><p class="noindent" >
-for any subsequent items that are multi-entries. The default definition of
-<span
-class="cmtt-10">\mglsseeitem </span>is:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-218">
-\newcommand*{\mglsseeitem}[1]{%
-&#x00A0;\mglsname[all={noindex},setup={hyper=allmain}]{#1}%
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.8753"></a><a href="#glo:glscombinedfirstsepfirst"><code class="csfmt">\glscombinedfirstsepfirst</code></a>}[2]{%
+ <a id="wrglossary.8754"></a><a href="#glo:glshasattribute"><code class="csfmt">\glshasattribute</code></a>{#1}{<a id="wrglossary.8755"></a><a href="#glo:opt.catattr.combinedfirstsepfirst"><span class="csoptfmt">combinedfirstsepfirst</span></a>}%
+ {<a id="wrglossary.8756"></a><a href="#glo:glsgetattribute"><code class="csfmt">\glsgetattribute</code></a>{#1}{<a id="wrglossary.8757"></a><a href="#glo:opt.catattr.combinedfirstsepfirst"><span class="csoptfmt">combinedfirstsepfirst</span></a>}}%
+ { }%
}
-</pre>
-<!--l. 9730--><p class="nopar" > This switches off indexing, sets the hyperlink to encompass the entire multi-entry
-content and uses the <span
-class="cmss-10">name</span><a
- id="dx1-68005"></a> field. The default definition of <span
-class="cmtt-10">\mglsseefirstitem </span>is
-simply <span
-class="cmtt-10">\mglsseeitem</span>.
-</p><!--l. 9736--><p class="indent" > For example, to use the <span
-class="cmss-10">short</span><a
- id="dx1-68006"></a> or <span
-class="cmss-10">text</span><a
- id="dx1-68007"></a> fields:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-219">
-\renewcommand*{\mglsseeitem}[1]{%
-&#x00A0;\mglsshort[all={noindex},setup={hyper=allmain}]{#1}%
+</pre> This does nothing if either element are abbreviations that have already been used. Note that if the associated attributes are set the commands will behave according to the attribute.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8758"></a><code class="code"><dfn id="glo:glssetcombinedsepnarrow"><code class="csfmt">\glssetcombinedsepnarrow</code></dfn>{<span class="meta">〈<em class="metainner">width</em>〉</span>}{<span class="meta">〈<em class="metainner">narrow-sep</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is rather more complicated as it measures a field value and uses <span class="meta">〈<em class="metainner">narrow-sep</em>〉</span> if the width is less than <span class="meta">〈<em class="metainner">width</em>〉</span>. The field value is determined as follows:
+<ul class="displaylist">
+ <li><span class="bulletitem">•</span>on <a id="wrglossary.8759"></a><a href="#glo:dual.firstuse">first use</a> the <a id="wrglossary.8760"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> field is used if it is set otherwise the <a id="wrglossary.8761"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> field is used;<p>
+<li><span class="bulletitem">•</span>otherwise the <a id="wrglossary.8762"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> field is used if it is set otherwise the <a id="wrglossary.8763"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field is used;
+</ul>
+<p>
+Note that this doesn’t take into account fonts, hooks, abbreviation styles or plural forms (e.g. <a id="wrglossary.8764"></a><a href="#glo:mglspl"><code class="csfmt">\mglspl</code></a>) or other field references (e.g. <a id="wrglossary.8765"></a><a href="#glo:mglsname"><code class="csfmt">\mglsname</code></a>). If the associated attributes are set the commands will behave according to the attribute.<p>
+
+</section><!-- end of section sec:mglssep -->
+
+<section id="sec:mglselementhooks"><!-- start of section sec:mglselementhooks --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->7.5. <code class="csfmt">\mgls</code> Element Hooks<div class="labellink"><a href="#sec:mglselementhooks">[link]</a></div></h2><!-- end of section header -->
+<p>
+The <a id="wrglossary.8766"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>-like commands use the following hooks: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8767"></a><code class="code"><dfn id="glo:mglselementprehook"><code class="csfmt">\mglselementprehook</code></dfn></code></div><!-- end of pinnedbox -->
+ This is done before each (non-skipped) element. (Default does nothing.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8768"></a><code class="code"><dfn id="glo:mglselementposthook"><code class="csfmt">\mglselementposthook</code></dfn></code></div><!-- end of pinnedbox -->
+ This is done after each (non-skipped) element. (Default does nothing.) Note that this is different from the normal entry post-link hook <a id="wrglossary.8769"></a><a href="#glo:glspostlinkhook"><code class="csfmt">\glspostlinkhook</code></a>. If the individual entry post-link hook is enabled (see the <a id="wrglossary.8770"></a><a href="#glo:opt.mglsopt.postlinks"><span class="csoptfmt">postlinks</span></a> key in §<a href="#sec:multiglsoptions">7.9</a>), this will go before <a id="wrglossary.8771"></a><a href="#glo:mglselementposthook"><code class="csfmt">\mglselementposthook</code></a>.<p>
+The definitions of the following commands are scoped within the <a id="wrglossary.8772"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>-like commands so they can’t be accessed elsewhere (including in the post-link hook, see §<a href="#sec:mglspostlinkhook">7.6</a>). They may be used in the above hooks or in the separator commands (described in §<a href="#sec:mglssep">7.4</a>) or in the command used to encapsulate the entire content. They can also be used in the post-link hook (see §<a href="#sec:entryfmtmods">5.5</a>) to determine if an entry is being used within a <a id="wrglossary.8773"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>-like command.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8774"></a><code class="code"><dfn id="glo:mglscurrentmultilabel"><code class="csfmt">\mglscurrentmultilabel</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the multi-entry label.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8775"></a><code class="code"><dfn id="glo:mglscurrentmainlabel"><code class="csfmt">\mglscurrentmainlabel</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the label of the main element.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8776"></a><code class="code"><dfn id="glo:mglscurrentlist"><code class="csfmt">\mglscurrentlist</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the complete comma-separated list of elements.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8777"></a><code class="code"><dfn id="glo:mglscurrentoptions"><code class="csfmt">\mglscurrentoptions</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the options used when the multi-entry was defined. This doesn’t include options set with <a id="wrglossary.8778"></a><a href="#glo:multiglossaryentrysetup"><code class="csfmt">\multiglossaryentrysetup</code></a> or those passed to <a id="wrglossary.8779"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> (or whichever variant is being used).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8780"></a><code class="code"><dfn id="glo:mglscurrentcategory"><code class="csfmt">\mglscurrentcategory</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the multi-entry category current in effect.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8781"></a><code class="code"><dfn id="glo:glsxtrcurrentmglscsname"><code class="csfmt">\glsxtrcurrentmglscsname</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the control sequence name of the calling command (for example, <code class="code">mgls</code> or <code class="code">mglspl</code>).<p>
+To test if the current multi-entry is the first use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8782"></a><code class="code"><dfn id="glo:mglsisfirstuse"><code class="csfmt">\mglsisfirstuse</code></dfn>{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does <span class="meta">〈<em class="metainner">true</em>〉</span> if this is the first use otherwise it does <span class="meta">〈<em class="metainner">false</em>〉</span>. Note that this applies to the multi-entry first use flag not the <a id="wrglossary.8783"></a><a href="#glo:dual.firstuseflag">first use flags</a> of the individual elements.<p>
+At each iteration of the loop over the element list, the following commands are set, which can be accessed in hooks such as <a id="wrglossary.8784"></a><a href="#glo:mglselementprehook"><code class="csfmt">\mglselementprehook</code></a> or in hooks used by the underlying <a id="wrglossary.8785"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> etc commands. For example, if <a id="wrglossary.8786"></a><a href="#glo:mglscurrentlabel"><code class="csfmt">\mglscurrentlabel</code></a> is defined then <a id="wrglossary.8787"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> is being used inside <a id="wrglossary.8788"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8789"></a><code class="code"><dfn id="glo:mglscurrentlabel"><code class="csfmt">\mglscurrentlabel</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the current element label.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8790"></a><code class="code"><dfn id="glo:mglselementindex"><code class="csfmt">\mglselementindex</code></dfn></code></div><!-- end of pinnedbox -->
+ This is a count register that is set to the element index.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8791"></a><code class="code"><dfn id="glo:mglscurrentprefix"><code class="csfmt">\mglscurrentprefix</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the current multi-entry prefix.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8792"></a><code class="code"><dfn id="glo:mglscurrentsuffix"><code class="csfmt">\mglscurrentsuffix</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the current multi-entry suffix.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8793"></a><code class="code"><dfn id="glo:mglsiflast"><code class="csfmt">\mglsiflast</code></dfn>{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If this is the last iteration, does <span class="meta">〈<em class="metainner">true</em>〉</span> otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>. This takes the skip options into account, so the last iteration may not necessarily be when the element index is equal to the total number of elements.<p>
+
+</section><!-- end of section sec:mglselementhooks -->
+
+<section id="sec:mglspostlinkhook"><!-- start of section sec:mglspostlinkhook --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->7.6. Post-Link Hook<div class="labellink"><a href="#sec:mglspostlinkhook">[link]</a></div></h2><!-- end of section header -->
+<p>
+There is a hook that occurs at the end the <a id="wrglossary.8794"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>-like commands according to the <a id="wrglossary.8795"></a><a href="#glo:opt.mglsopt.mpostlink"><span class="csoptfmt">mpostlink</span></a> setting (see §<a href="#sec:multiglsoptions">7.9</a>). The hook used depends on the <a id="wrglossary.8796"></a><a href="#glo:opt.mglsopt.mpostlinkelement"><span class="csoptfmt">mpostlinkelement</span></a> option. These hooks can’t access the commands described in §<a href="#sec:mglselementhooks">7.5</a> as the hook occurs outside of the scope in which they are defined.<p>
+The <a id="wrglossary.8797"></a><a href="#glo:opt.mglsopt.mpostlinkelement"><span class="csoptfmt">mpostlinkelement</span></a><span class="optfmt">=custom</span> option uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8798"></a><code class="code"><dfn id="glo:mglscustompostlinkhook"><code class="csfmt">\mglscustompostlinkhook</code></dfn></code></div><!-- end of pinnedbox -->
+ This does nothing by default.<p>
+The <a id="wrglossary.8799"></a><a href="#glo:opt.mglsopt.mpostlinkelement"><span class="csoptfmt">mpostlinkelement</span></a><span class="optfmt">=last</span> option uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8800"></a><code class="code"><dfn id="glo:mglslastelementpostlinkhook"><code class="csfmt">\mglslastelementpostlinkhook</code></dfn></code></div><!-- end of pinnedbox -->
+ which emulates the post-link hook of the last element.<p>
+The <a id="wrglossary.8801"></a><a href="#glo:opt.mglsopt.mpostlinkelement"><span class="csoptfmt">mpostlinkelement</span></a><span class="optfmt">=main</span> option uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8802"></a><code class="code"><dfn id="glo:mglslastmainpostlinkhook"><code class="csfmt">\mglslastmainpostlinkhook</code></dfn></code></div><!-- end of pinnedbox -->
+ which emulates the post-link hook of the main element.<p>
+The default settings <code class="code"><a id="wrglossary.8803"></a><a href="#glo:opt.mglsopt.postlinks"><span class="csoptfmt">postlinks</span></a><span class="optfmt">=none</span>,
+<a id="wrglossary.8804"></a><a href="#glo:opt.mglsopt.mpostlink"><span class="csoptfmt">mpostlink</span></a><span class="optfmt">=true</span>, <a id="wrglossary.8805"></a><a href="#glo:opt.mglsopt.mpostlinkelement"><span class="csoptfmt">mpostlinkelement</span></a><span class="optfmt">=last</span></code> will suppress the individual element <a id="wrglossary.8806"></a><a href="#glo:dual.postlinkhook">post-link hooks</a> (<a id="wrglossary.8807"></a><a href="#glo:glspostlinkhook"><code class="csfmt">\glspostlinkhook</code></a>) and do the multi-entry post-link hook for the last element (<a id="wrglossary.8808"></a><a href="#glo:mglslastelementpostlinkhook"><code class="csfmt">\mglslastelementpostlinkhook</code></a>).<p>
+If you have the final element’s <a id="wrglossary.8809"></a><a href="#glo:dual.postlinkhook">post-link hook</a> enabled and the multi-entry post-link hook enabled (for example, <code class="code"><a id="wrglossary.8810"></a><a href="#glo:opt.mglsopt.postlinks"><span class="csoptfmt">postlinks</span></a><span class="optfmt">=all</span>, <a id="wrglossary.8811"></a><a href="#glo:opt.mglsopt.mpostlink"><span class="csoptfmt">mpostlink</span></a><span class="optfmt">=true</span>,
+<a id="wrglossary.8812"></a><a href="#glo:opt.mglsopt.mpostlinkelement"><span class="csoptfmt">mpostlinkelement</span></a><span class="optfmt">=last</span></code>), the final element’s <a id="wrglossary.8813"></a><a href="#glo:dual.postlinkhook">post-link hook</a> will be done twice. Similarly for the main element with <code class="code"><a id="wrglossary.8814"></a><a href="#glo:opt.mglsopt.postlinks"><span class="csoptfmt">postlinks</span></a><span class="optfmt">=all</span>, <a id="wrglossary.8815"></a><a href="#glo:opt.mglsopt.mpostlink"><span class="csoptfmt">mpostlink</span></a><span class="optfmt">=true</span>,
+<a id="wrglossary.8816"></a><a href="#glo:opt.mglsopt.mpostlinkelement"><span class="csoptfmt">mpostlinkelement</span></a><span class="optfmt">=main</span></code>.<p>
+The following commands are available for use in these hooks and may also be used in the definition of <a id="wrglossary.8817"></a><a href="#glo:mglssuffix"><code class="csfmt">\mglssuffix</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8818"></a><code class="code"><dfn id="glo:mglslastmultilabel"><code class="csfmt">\mglslastmultilabel</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the multi-entry label.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8819"></a><code class="code"><dfn id="glo:mglslastcategory"><code class="csfmt">\mglslastcategory</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the multi-entry category (see §<a href="#sec:multiglscategory">7.8</a>). This will be empty if no category was assigned.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8820"></a><code class="code"><dfn id="glo:mglswasfirstuse"><code class="csfmt">\mglswasfirstuse</code></dfn>{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If that was the first use of the multi-entry (see §<a href="#sec:mglsfirstuse">7.7</a>) this does <span class="meta">〈<em class="metainner">true</em>〉</span> otherwise it does <span class="meta">〈<em class="metainner">false</em>〉</span>.<p>
+
+</section><!-- end of section sec:mglspostlinkhook -->
+
+<section id="sec:mglspostlinkhooklastelement"><!-- start of section sec:mglspostlinkhooklastelement --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->7.6.1. Last Element<div class="labellink"><a href="#sec:mglspostlinkhooklastelement">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+ The following commands relate to the last element.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8821"></a><code class="code"><dfn id="glo:mglslastelementlabel"><code class="csfmt">\mglslastelementlabel</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the label of the last non-skipped element. If all elements were skipped or if the multi-entry wasn’t defined, this will be empty.<p>
+Test if the last element was skipped: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8822"></a><code class="code"><dfn id="glo:mglsiflastelementskipped"><code class="csfmt">\mglsiflastelementskipped</code></dfn>{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If the last element was skipped this does <span class="meta">〈<em class="metainner">true</em>〉</span> otherwise it does <span class="meta">〈<em class="metainner">false</em>〉</span>. If all elements were skipped or if the multi-entry wasn’t defined, this will do <span class="meta">〈<em class="metainner">true</em>〉</span>.<p>
+Test if the last element was its first use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8823"></a><code class="code"><dfn id="glo:mglsiflastelementwasfirstuse"><code class="csfmt">\mglsiflastelementwasfirstuse</code></dfn>{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If the last non-skipped element was used for the first time this does <span class="meta">〈<em class="metainner">true</em>〉</span> otherwise it does <span class="meta">〈<em class="metainner">false</em>〉</span>. (Corresponds to <a id="wrglossary.8824"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a>.) If all elements were skipped or if the multi-entry wasn’t defined, this will do <span class="meta">〈<em class="metainner">true</em>〉</span>.<p>
+Test if the last element was plural: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8825"></a><code class="code"><dfn id="glo:mglsiflastelementwasplural"><code class="csfmt">\mglsiflastelementwasplural</code></dfn>{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If the last non-skipped element had the plural form displayed, this does <span class="meta">〈<em class="metainner">true</em>〉</span> otherwise it does <span class="meta">〈<em class="metainner">false</em>〉</span>. (Corresponds to <a id="wrglossary.8826"></a><a href="#glo:glsifplural"><code class="csfmt">\glsifplural</code></a>.) If all elements were skipped or if the multi-entry wasn’t defined, this will do <span class="meta">〈<em class="metainner">false</em>〉</span>.<p>
+Test if the last element was had any case-changing applied: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8827"></a><code class="code"><dfn id="glo:mglsiflastelementcapscase"><code class="csfmt">\mglsiflastelementcapscase</code></dfn>{<span class="meta">〈<em class="metainner">no-change</em>〉</span>}{<span class="meta">〈<em class="metainner">firstuc</em>〉</span>}{<span class="meta">〈<em class="metainner">all caps</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Corresponds to <a id="wrglossary.8828"></a><a href="#glo:glscapscase"><code class="csfmt">\glscapscase</code></a> of the last non-skipped element. If all elements were skipped or if the multi-entry wasn’t defined, this will do <span class="meta">〈<em class="metainner">no-change</em>〉</span>.<p>
+
+</section><!-- end of section sec:mglspostlinkhooklastelement -->
+
+<section id="sec:mglspostlinkhookmainelement"><!-- start of section sec:mglspostlinkhookmainelement --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->7.6.2. Main Element<div class="labellink"><a href="#sec:mglspostlinkhookmainelement">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+ The following commands relate to the main element.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8829"></a><code class="code"><dfn id="glo:mglslastmainlabel"><code class="csfmt">\mglslastmainlabel</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the label of the main element from the multi-entry that was just referenced. If the main element was skipped or if the multi-entry wasn’t defined, this will be empty. If this is the same as <a id="wrglossary.8830"></a><a href="#glo:mglslastelementlabel"><code class="csfmt">\mglslastelementlabel</code></a> then the main element was the last element.<p>
+Test if the main element was skipped: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8831"></a><code class="code"><dfn id="glo:mglsiflastmainskipped"><code class="csfmt">\mglsiflastmainskipped</code></dfn>{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If the main element from the multi-entry that was just referenced was skipped this does <span class="meta">〈<em class="metainner">true</em>〉</span> otherwise it does <span class="meta">〈<em class="metainner">false</em>〉</span>. If the multi-entry wasn’t defined, this will do <span class="meta">〈<em class="metainner">true</em>〉</span>.<p>
+Test if the main element was its first use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8832"></a><code class="code"><dfn id="glo:mglsiflastmainwasfirstuse"><code class="csfmt">\mglsiflastmainwasfirstuse</code></dfn>{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If the main element was used for the first time this does <span class="meta">〈<em class="metainner">true</em>〉</span> otherwise it does <span class="meta">〈<em class="metainner">false</em>〉</span>. (Corresponds to <a id="wrglossary.8833"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a>.) If the main element was skipped or if the multi-entry wasn’t defined, this will do <span class="meta">〈<em class="metainner">true</em>〉</span>.<p>
+Test if the main element was plural: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8834"></a><code class="code"><dfn id="glo:mglsiflastmainwasplural"><code class="csfmt">\mglsiflastmainwasplural</code></dfn>{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If the main element from the multi-entry that was just referenced had its plural form displayed this does <span class="meta">〈<em class="metainner">true</em>〉</span> otherwise it does <span class="meta">〈<em class="metainner">false</em>〉</span>. (Corresponds to <a id="wrglossary.8835"></a><a href="#glo:glsifplural"><code class="csfmt">\glsifplural</code></a>.) If the main element was skipped or if the multi-entry wasn’t defined, this will do <span class="meta">〈<em class="metainner">false</em>〉</span>.<p>
+Test if the main element was had any case-changing applied: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8836"></a><code class="code"><dfn id="glo:mglsiflastmaincapscase"><code class="csfmt">\mglsiflastmaincapscase</code></dfn>{<span class="meta">〈<em class="metainner">no-change</em>〉</span>}{<span class="meta">〈<em class="metainner">firstuc</em>〉</span>}{<span class="meta">〈<em class="metainner">all caps</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Corresponds to <a id="wrglossary.8837"></a><a href="#glo:glscapscase"><code class="csfmt">\glscapscase</code></a> of the main element from the multi-entry that was just referenced. If the main element was skipped or if the multi-entry wasn’t defined, this will do <span class="meta">〈<em class="metainner">no-change</em>〉</span>.<p>
+
+</section><!-- end of section sec:mglspostlinkhookmainelement -->
+
+<section id="sec:mglsfirstuse"><!-- start of section sec:mglsfirstuse --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->7.7. Multi-Entry First Use<div class="labellink"><a href="#sec:mglsfirstuse">[link]</a></div></h2><!-- end of section header -->
+<p>
+Each multi-entry set has an associated first use flag. This is independent of the <a id="wrglossary.8838"></a><a href="#glo:dual.firstuseflag">first use flag</a> associated with the individual entries that make up the set. As with the <a id="wrglossary.8839"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands, <a id="wrglossary.8840"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> unsets this flag. Unlike the <a id="wrglossary.8841"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands, all the commands described in §<a href="#sec:mglslike">7.11</a> (including commands like <a id="wrglossary.8842"></a><a href="#glo:mglsname"><code class="csfmt">\mglsname</code></a>) unset this flag, even if the elements use commands like <a id="wrglossary.8843"></a><a href="#glo:glsname"><code class="csfmt">\glsname</code></a> that don’t unset the entry’s <a id="wrglossary.8844"></a><a href="#glo:dual.firstuseflag">first use flag</a>.<p>
+You can determine whether or not a multi-entry set has been marked as used with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8845"></a><code class="code"><dfn id="glo:ifmglsused"><code class="csfmt">\ifmglsused</code></dfn>{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does <span class="meta">〈<em class="metainner">true</em>〉</span> if the given multi-entry has been marked as used, otherwise it does <span class="meta">〈<em class="metainner">false</em>〉</span>.<p>
+You can (globally) unset the flag (mark the set as having been referenced) with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8846"></a><code class="code"><dfn id="glo:mglsunset"><code class="csfmt">\mglsunset</code></dfn>{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ or reset it with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8847"></a><code class="code"><dfn id="glo:mglsreset"><code class="csfmt">\mglsreset</code></dfn>{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ There are also local versions of these commands: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8848"></a><code class="code"><dfn id="glo:mglslocalunset"><code class="csfmt">\mglslocalunset</code></dfn>{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which locally unsets the flag and <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8849"></a><code class="code"><dfn id="glo:mglslocalreset"><code class="csfmt">\mglslocalreset</code></dfn>{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which locally resets the flag.<p>
+It’s also possible to unset or reset all multi-entries. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8850"></a><code class="code"><dfn id="glo:mglsunsetall"><code class="csfmt">\mglsunsetall</code></dfn></code></div><!-- end of pinnedbox -->
+ Unsets all multi-entries.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8851"></a><code class="code"><dfn id="glo:mglsresetall"><code class="csfmt">\mglsresetall</code></dfn></code></div><!-- end of pinnedbox -->
+ Resets all multi-entries.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Note that unsetting or resetting any of the individual element <a id="wrglossary.8852"></a><a href="#glo:dual.firstuseflag">first use flags</a> doesn’t affect the multi-entry flag. Similarly, unsetting or resetting the multi-entry flag doesn’t affect the <a id="wrglossary.8853"></a><a href="#glo:dual.firstuseflag">first use flags</a> of the individual elements. </div><!-- end of important -->
+<p>
+
+</section><!-- end of section sec:mglsfirstuse -->
+
+<section id="sec:multiglscategory"><!-- start of section sec:multiglscategory --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->7.8. Multi-Entry Category<div class="labellink"><a href="#sec:multiglscategory">[link]</a></div></h2><!-- end of section header -->
+<p>
+A multi-entry set may have an associated category set using the <a id="wrglossary.8854"></a><a href="#glo:opt.mglsopt.category"><span class="csoptfmt">category</span></a> key described in §<a href="#sec:multiglsoptions">7.9</a>. This isn’t set by default, but if it is set the category may have attributes set in the usual way. The multi-entry category is independent of the individual entry categories. The following attribute is recognised by commands like <a id="wrglossary.8855"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>:<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8856"></a><code class="code"><dfn id="glo:opt.catattr.multioptions"><span class="csoptfmt">multioptions</span></dfn>=<span class="meta">〈<em class="metainner">options</em>〉</span></code></div><!-- end of settingsbox -->
+ The value are the default options to apply to any multi-entry set with the given category. These can be overridden by the first optional argument of <a id="wrglossary.8857"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a> or by the <a id="wrglossary.8858"></a><a href="#glo:opt.mglsopt.setup"><span class="csoptfmt">setup</span></a> key in the first optional argument of commands like <a id="wrglossary.8859"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8860"></a><code class="code"><dfn id="glo:opt.catattr.combinedfirstsep"><span class="csoptfmt">combinedfirstsep</span></dfn>=<span class="meta">〈<em class="metainner">separator</em>〉</span></code></div><!-- end of settingsbox -->
+ The separator to use for <a id="wrglossary.8861"></a><a href="#glo:glscombinedfirstsep"><code class="csfmt">\glscombinedfirstsep</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8862"></a><code class="code"><dfn id="glo:opt.catattr.combinedfirstsepfirst"><span class="csoptfmt">combinedfirstsepfirst</span></dfn>=<span class="meta">〈<em class="metainner">separator</em>〉</span></code></div><!-- end of settingsbox -->
+ The separator to use for <a id="wrglossary.8863"></a><a href="#glo:glscombinedfirstsepfirst"><code class="csfmt">\glscombinedfirstsepfirst</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8864"></a><code class="code"><dfn id="glo:opt.catattr.combinedsepfirst"><span class="csoptfmt">combinedsepfirst</span></dfn>=<span class="meta">〈<em class="metainner">separator</em>〉</span></code></div><!-- end of settingsbox -->
+ The separator to use for <a id="wrglossary.8865"></a><a href="#glo:glscombinedsepfirst"><code class="csfmt">\glscombinedsepfirst</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8866"></a><code class="code"><dfn id="glo:opt.catattr.combinedsep"><span class="csoptfmt">combinedsep</span></dfn>=<span class="meta">〈<em class="metainner">separator</em>〉</span></code></div><!-- end of settingsbox -->
+ The separator to use for <a id="wrglossary.8867"></a><a href="#glo:glscombinedsep"><code class="csfmt">\glscombinedsep</code></a>.<p>
+Note that you can’t access the category or its attributes via the multi-entry label (for example, with <a id="wrglossary.8868"></a><a href="#glo:glshasattribute"><code class="csfmt">\glshasattribute</code></a>). If you need to access the current multi-entry’s category within any of the <a id="wrglossary.8869"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>-like hooks (§<a href="#sec:mglselementhooks">7.5</a>), you can obtain the category with <a id="wrglossary.8870"></a><a href="#glo:mglscurrentcategory"><code class="csfmt">\mglscurrentcategory</code></a> and use commands like <a id="wrglossary.8871"></a><a href="#glo:glshascategoryattribute"><code class="csfmt">\glshascategoryattribute</code></a>.<p>
+
+</section><!-- end of section sec:multiglscategory -->
+
+<section id="sec:multiglsoptions"><!-- start of section sec:multiglsoptions --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->7.9. Multi-Entry Settings<div class="labellink"><a href="#sec:multiglsoptions">[link]</a></div></h2><!-- end of section header -->
+<p>
+The settings that govern all multi-entries can be set using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8872"></a><code class="code"><dfn id="glo:multiglossaryentrysetup"><code class="csfmt">\multiglossaryentrysetup</code></dfn>{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The <span class="meta">〈<em class="metainner">options</em>〉</span> are the same as for <a id="wrglossary.8873"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a>.<p>
+Whenever the <a id="wrglossary.8874"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>-like commands are used, options are applied in the following order:
+<ol class="displaylist">
+ <li><span class="numitem">1.</span>general options identified by <a id="wrglossary.8875"></a><a href="#glo:multiglossaryentrysetup"><code class="csfmt">\multiglossaryentrysetup</code></a>;<p>
+<li><span class="numitem">2.</span>the category key is assigned if it’s in the general options, <a id="wrglossary.8876"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a> or <a id="wrglossary.8877"></a><a href="#glo:opt.mglsopt.setup"><span class="csoptfmt">setup</span></a> key;<p>
+<li><span class="numitem">3.</span><a id="wrglossary.8878"></a><a href="#glo:opt.catattr.multioptions"><span class="csoptfmt">multioptions</span></a> category attribute (if set);<p>
+<li><span class="numitem">4.</span>any options provided in the first optional argument of <a id="wrglossary.8879"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a>;<p>
+<li><span class="numitem">5.</span>any options provided in the <a id="wrglossary.8880"></a><a href="#glo:opt.mglsopt.setup"><span class="csoptfmt">setup</span></a> key in the first optional argument of the <a id="wrglossary.8881"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>-like command.
+</ol>
+<p>
+These options are described below.<p>
+
+</section><!-- end of section sec:multiglsoptions -->
+
+<section id="sec:multiglsoptionsindexing"><!-- start of section sec:multiglsoptionsindexing --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->7.9.1. Indexing<div class="labellink"><a href="#sec:multiglsoptionsindexing">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8882"></a><code class="code"><dfn id="glo:opt.mglsopt.indexmain"><span class="csoptfmt">indexmain</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This setting may take one of the following values:
+<dl class="inlinetitle">
+ <span class="optfmt">false</span> don’t index the main entry; <span class="optfmt">true</span> index the main entry; <span class="optfmt">first</span> only index the main entry if it’s the <a id="wrglossary.8883"></a><a href="#glo:dual.firstuse">first use</a> (of the main entry).
+</dl>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8884"></a><code class="code"><dfn id="glo:opt.mglsopt.indexothers"><span class="csoptfmt">indexothers</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This setting may take one of the following values:
+<dl class="inlinetitle">
+ <span class="optfmt">false</span> don’t index the other entries; <span class="optfmt">true</span> index the other entries; <span class="optfmt">first</span> only index the other entries if it’s the <a id="wrglossary.8885"></a><a href="#glo:dual.firstuse">first use</a> (of the non-main entry).
+</dl>
+<p>
+
+</section><!-- end of section sec:multiglsoptionsindexing -->
+
+<section id="sec:multiglsoptionsencap"><!-- start of section sec:multiglsoptionsencap --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->7.9.2. Location Formats (Encaps)<div class="labellink"><a href="#sec:multiglsoptionsencap">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8886"></a><code class="code"><dfn id="glo:opt.mglsopt.encapmain"><span class="csoptfmt">encapmain</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>glsnumberformat</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This setting value should be the value to pass to <a id="wrglossary.8887"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a> option (<a id="wrglossary.8888"></a><a href="#glo:dual.locationencap">location encap</a>) for the main entry.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8889"></a><code class="code"><dfn id="glo:opt.mglsopt.encapothers"><span class="csoptfmt">encapothers</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>glsnumberformat</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This setting value should be the value to pass to <a id="wrglossary.8890"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a> option (<a id="wrglossary.8891"></a><a href="#glo:dual.locationencap">location encap</a>) for the other (not main) entries. <p>
+
+</section><!-- end of section sec:multiglsoptionsencap -->
+
+<section id="sec:multiglsoptionspostlink"><!-- start of section sec:multiglsoptionspostlink --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->7.9.3. Post-Link Hooks<div class="labellink"><a href="#sec:multiglsoptionspostlink">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8892"></a><code class="code"><dfn id="glo:opt.mglsopt.postlinks"><span class="csoptfmt">postlinks</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>none</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This setting determines whether or not to enable the individual element’s <a id="wrglossary.8893"></a><a href="#glo:dual.postlinkhook">post-link hook</a>. The value may be one of:
+<dl class="inlinetitle">
+ <span class="optfmt">none</span> suppress the <a id="wrglossary.8894"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for all elements; <span class="optfmt">all</span> don’t suppress the <a id="wrglossary.8895"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for all elements; <span class="optfmt">notlast</span> only suppress the <a id="wrglossary.8896"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the last element; <span class="optfmt">mainnotlast</span> suppress the <a id="wrglossary.8897"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for all <span class="qt">“other”</span> (not main) elements and for the last element (so only the main element will have its <a id="wrglossary.8898"></a><a href="#glo:dual.postlinkhook">post-link hook</a> as long as it’s not the last element); <span class="optfmt">mainonly</span> suppress the <a id="wrglossary.8899"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for all <span class="qt">“other”</span> (not main) elements; <span class="optfmt">othernotlast</span> suppress the <a id="wrglossary.8900"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the main element and for the last element (so only the other elements will have their <a id="wrglossary.8901"></a><a href="#glo:dual.postlinkhook">post-link hook</a> as long as the element isn’t the last one); <span class="optfmt">otheronly</span> suppress the <a id="wrglossary.8902"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the main element.
+</dl>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8903"></a><code class="code"><dfn id="glo:opt.mglsopt.mpostlink"><span class="csoptfmt">mpostlink</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This setting determines whether or not to enable the multi-entry post-link hook (see §<a href="#sec:mglspostlinkhook">7.6</a>). The value may be one of:
+<dl class="inlinetitle">
+ <span class="optfmt">false</span> suppress the multi-entry post-link hook; <span class="optfmt">true</span> enable the multi-entry post-link hook; <span class="optfmt">firstonly</span> enable the multi-entry post-link hook only for the <a id="wrglossary.8904"></a><a href="#glo:dual.mfirstuse">first use</a> of the multi-entry; <span class="optfmt">usedonly</span> enable the multi-entry post-link hook only for the <a id="wrglossary.8905"></a><a href="#glo:dual.msubsequentuse">subsequent use</a> of the multi-entry.
+</dl>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8906"></a><code class="code"><dfn id="glo:opt.mglsopt.mpostlinkelement"><span class="csoptfmt">mpostlinkelement</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>last</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This setting indicates which post-link hook should be used if the multi-entry post-link hook has been enabled. Allowed values:
+<dl class="inlinetitle">
+ <span class="optfmt">last</span> use <a id="wrglossary.8907"></a><a href="#glo:mglslastelementpostlinkhook"><code class="csfmt">\mglslastelementpostlinkhook</code></a> (that is, use the <a id="wrglossary.8908"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the last element); <span class="optfmt">main</span> use <a id="wrglossary.8909"></a><a href="#glo:mglslastmainpostlinkhook"><code class="csfmt">\mglslastmainpostlinkhook</code></a> (that is, use the <a id="wrglossary.8910"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the main element); <span class="optfmt">custom</span> use <a id="wrglossary.8911"></a><a href="#glo:mglscustompostlinkhook"><code class="csfmt">\mglscustompostlinkhook</code></a>.
+</dl>
+<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+Some combinations may cause a repeated hook. </div><!-- end of warning -->
+<p>
+
+</section><!-- end of section sec:multiglsoptionspostlink -->
+
+<section id="sec:multiglsoptionsfixes"><!-- start of section sec:multiglsoptionsfixes --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->7.9.4. Prefixes and Suffixes<div class="labellink"><a href="#sec:multiglsoptionsfixes">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+See §<a href="#sec:mglsfixes">7.3</a> for more information on prefixes and suffixes. Note that the prefixes and suffixes are not affected by case-changing commands such as <a id="wrglossary.8912"></a><a href="#glo:Mgls"><code class="csfmt">\Mgls</code></a> or <a id="wrglossary.8913"></a><a href="#glo:MGLS"><code class="csfmt">\MGLS</code></a>. If you want a prefix to obey case-changing, use the <a id="wrglossary.8914"></a><a href="#glo:mpgls"><code class="csfmt">\mpgls</code></a>-like commands instead (see §<a href="#sec:mpgls">7.11.4</a>).<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8915"></a><code class="code"><dfn id="glo:opt.mglsopt.firstprefix"><span class="csoptfmt">firstprefix</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code></div><!-- end of settingsbox -->
+ The prefix to use on <a id="wrglossary.8916"></a><a href="#glo:dual.mfirstuse">first use</a> of the multi-entry.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8917"></a><code class="code"><dfn id="glo:opt.mglsopt.usedprefix"><span class="csoptfmt">usedprefix</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code></div><!-- end of settingsbox -->
+ The prefix to use on <a id="wrglossary.8918"></a><a href="#glo:dual.msubsequentuse">subsequent use</a> of the multi-entry.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8919"></a><code class="code"><dfn id="glo:opt.mglsopt.firstsuffix"><span class="csoptfmt">firstsuffix</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code></div><!-- end of settingsbox -->
+ The suffix to use on <a id="wrglossary.8920"></a><a href="#glo:dual.mfirstuse">first use</a> of the multi-entry.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8921"></a><code class="code"><dfn id="glo:opt.mglsopt.usedsuffix"><span class="csoptfmt">usedsuffix</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code></div><!-- end of settingsbox -->
+ The suffix to use on <a id="wrglossary.8922"></a><a href="#glo:dual.msubsequentuse">subsequent use</a> of the multi-entry.<p>
+
+</section><!-- end of section sec:multiglsoptionsfixes -->
+
+<section id="sec:multiglsoptionsskip"><!-- start of section sec:multiglsoptionsskip --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->7.9.5. Skipping Elements<div class="labellink"><a href="#sec:multiglsoptionsskip">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+The skip options apply to the multi-entry first use flag not the individual element first use. See §<a href="#sec:mglsfirstuse">7.7</a>. </div><!-- end of information -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8923"></a><code class="code"><dfn id="glo:opt.mglsopt.firstskipmain"><span class="csoptfmt">firstskipmain</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ If <span class="optfmt">true</span>, the main element will be omitted on (multi-entry) <a id="wrglossary.8924"></a><a href="#glo:dual.mfirstuse">first use</a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8925"></a><code class="code"><dfn id="glo:opt.mglsopt.firstskipothers"><span class="csoptfmt">firstskipothers</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ If <span class="optfmt">true</span>, the other (non-main) elements will be omitted on (multi-entry) <a id="wrglossary.8926"></a><a href="#glo:dual.mfirstuse">first use</a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8927"></a><code class="code"><dfn id="glo:opt.mglsopt.usedskipmain"><span class="csoptfmt">usedskipmain</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ If <span class="optfmt">true</span>, the main element will be omitted on (multi-entry) <a id="wrglossary.8928"></a><a href="#glo:dual.msubsequentuse">subsequent use</a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8929"></a><code class="code"><dfn id="glo:opt.mglsopt.usedskipothers"><span class="csoptfmt">usedskipothers</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ If <span class="optfmt">true</span>, the other (non-main) elements will be omitted on (multi-entry) <a id="wrglossary.8930"></a><a href="#glo:dual.msubsequentuse">subsequent use</a>.<p>
+Note that it is technically possible to set the skip options so that both the main and the other elements are skipped. However, by default, this will generate a warning and only the final optional argument (the <span class="meta">〈<em class="metainner">insert</em>〉</span>) will be displayed. There won’t be a loop over all elements so the commands set at each iteration, such as <a id="wrglossary.8931"></a><a href="#glo:mglscurrentlabel"><code class="csfmt">\mglscurrentlabel</code></a>, won’t be defined.<p>
+The warning and the insertion of the <span class="meta">〈<em class="metainner">insert</em>〉</span> is done by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.8932"></a><code class="code"><dfn id="glo:glsxtrmglsWarnAllSkipped"><code class="csfmt">\glsxtrmglsWarnAllSkipped</code></dfn>{<span class="meta">〈<em class="metainner">message</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">message</em>〉</span> is the warning message and <span class="meta">〈<em class="metainner">cs</em>〉</span> is the control sequence that encapsulates the entire content (including hyperlink and the <a id="wrglossary.8933"></a><a href="#glo:opt.mglsopt.textformat"><span class="csoptfmt">textformat</span></a> setting, if enabled).<p>
+If, for some particular reason, you want this scenario, you can redefine this command to omit the warning.<p>
+
+</section><!-- end of section sec:multiglsoptionsskip -->
+
+<section id="sec:multiglsoptionsgeneral"><!-- start of section sec:multiglsoptionsgeneral --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->7.9.6. General<div class="labellink"><a href="#sec:multiglsoptionsgeneral">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8934"></a><code class="code"><dfn id="glo:opt.mglsopt.multi.hyper">hyper</dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>individual</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This setting may take one of the following values:
+<dl class="inlinetitle">
+ <span class="optfmt">none</span> no hyperlinks; <span class="optfmt">allmain</span> encapsulate the entire content with a single hyperlink to the main entry’s target; <span class="optfmt">mainonly</span> only hyperlink the main entry; <span class="optfmt">individual</span> hyperlink each entry individually; <span class="optfmt">otheronly</span> only hyperlink the other entries; <span class="optfmt">notmainfirst</span> don’t hyperlink the main entry on <a id="wrglossary.8935"></a><a href="#glo:dual.mfirstuse">multi-entry first use</a>; <span class="optfmt">nototherfirst</span> don’t hyperlink the other entries on <a id="wrglossary.8936"></a><a href="#glo:dual.mfirstuse">multi-entry first use</a>; <span class="optfmt">notfirst</span> don’t hyperlink any entries on <a id="wrglossary.8937"></a><a href="#glo:dual.mfirstuse">multi-entry first use</a>.
+</dl>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8938"></a><code class="code"><dfn id="glo:opt.mglsopt.textformat"><span class="csoptfmt">textformat</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>@firstofone</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This setting value should be the control sequence name (without the leading backslash) of the command used to encapsulate the entire content.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8939"></a><code class="code"><dfn id="glo:opt.mglsopt.category"><span class="csoptfmt">category</span></dfn>=<span class="meta">〈<em class="metainner">category-label</em>〉</span></code></div><!-- end of settingsbox -->
+ The category to apply to the multi-entry. This is independent of the categories of each of the elements. The default is no category. See §<a href="#sec:multiglscategory">7.8</a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8940"></a><code class="code"><dfn id="glo:opt.mglsopt.mglsopts"><span class="csoptfmt">mglsopts</span></dfn>=<span class="meta">〈<em class="metainner">option list</em>〉</span></code></div><!-- end of settingsbox -->
+ Default options to pass to commands like <a id="wrglossary.8941"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>. Note that <a id="wrglossary.8942"></a><a href="#glo:opt.mglsopt.setup"><span class="csoptfmt">setup</span></a> can’t be used within this value.<p>
+
+</section><!-- end of section sec:multiglsoptionsgeneral -->
+
+<section id="sec:mglsopts"><!-- start of section sec:mglsopts --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->7.10. <code class="csfmt">\mgls</code> Options<div class="labellink"><a href="#sec:mglsopts">[link]</a></div></h2><!-- end of section header -->
+<p>
+The <span class="meta">〈<em class="metainner">options</em>〉</span> for <a id="wrglossary.8943"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> (and similar commands) are listed below. Any additional options provided will be appended to the <a id="wrglossary.8944"></a><a href="#glo:opt.mglsopt.all"><span class="csoptfmt">all</span></a> value. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8945"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>[<a id="wrglossary.8946"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a><span class="optfmt">=chapter</span>]{cbot}
+</pre> is equivalent to: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8947"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>[<a id="wrglossary.8948"></a><a href="#glo:opt.mglsopt.all"><span class="csoptfmt">all</span></a><span class="optfmt">=<a id="wrglossary.8949"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a><span class="optfmt">=chapter</span></span>]{cbot}
+</pre> Whereas: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8950"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>[<a id="wrglossary.8951"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a><span class="optfmt">=chapter</span>,<a id="wrglossary.8952"></a><a href="#glo:opt.mglsopt.all"><span class="csoptfmt">all</span></a><span class="optfmt">=<a id="wrglossary.8953"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a><span class="optfmt">=section</span></span>]{cbot}
+</pre> is treated as: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8954"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>[<a id="wrglossary.8955"></a><a href="#glo:opt.mglsopt.all"><span class="csoptfmt">all</span></a><span class="optfmt">=<a id="wrglossary.8956"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a><span class="optfmt">=section</span>,<a id="wrglossary.8957"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a><span class="optfmt">=chapter</span></span>]{cbot}
+</pre> which has the same effect as: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.8958"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>[<a id="wrglossary.8959"></a><a href="#glo:opt.mglsopt.all"><span class="csoptfmt">all</span></a><span class="optfmt">=<a id="wrglossary.8960"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a><span class="optfmt">=chapter</span></span>]{cbot}
+</pre><p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+The descriptions below reference <a id="wrglossary.8961"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> which is used internally by <a id="wrglossary.8962"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>. Replace this with <a id="wrglossary.8963"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> etc as applicable for the variants, such as <a id="wrglossary.8964"></a><a href="#glo:mglspl"><code class="csfmt">\mglspl</code></a>. </div><!-- end of information -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8965"></a><code class="code"><dfn id="glo:opt.mglsopt.setup"><span class="csoptfmt">setup</span></dfn>=<span class="meta">〈<em class="metainner">option list</em>〉</span></code></div><!-- end of settingsbox -->
+ The value should be a list of any options that can be passed to <a id="wrglossary.8966"></a><a href="#glo:multiglossaryentrysetup"><code class="csfmt">\multiglossaryentrysetup</code></a>. These options will override any conflicting options that were supplied to <a id="wrglossary.8967"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a> or <a id="wrglossary.8968"></a><a href="#glo:multiglossaryentrysetup"><code class="csfmt">\multiglossaryentrysetup</code></a>. Note that <a id="wrglossary.8969"></a><a href="#glo:opt.mglsopt.mglsopts"><span class="csoptfmt">mglsopts</span></a> can’t be used within this value.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8970"></a><code class="code"><dfn id="glo:opt.mglsopt.all"><span class="csoptfmt">all</span></dfn>=<span class="meta">〈<em class="metainner">option list</em>〉</span></code></div><!-- end of settingsbox -->
+ The value should be a list of any options that can be passed to <a id="wrglossary.8971"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. These options will be passed to each instance of <a id="wrglossary.8972"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> and will override any conflicting setting in <a id="wrglossary.8973"></a><a href="#glo:opt.mglsopt.setup"><span class="csoptfmt">setup</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8974"></a><code class="code"><dfn id="glo:opt.mglsopt.main"><span class="csoptfmt">main</span></dfn>=<span class="meta">〈<em class="metainner">option list</em>〉</span></code></div><!-- end of settingsbox -->
+ The value should be a list of any options that can be passed to <a id="wrglossary.8975"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. These options will be passed to the instance of <a id="wrglossary.8976"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> used for the main label and will override any conflicting setting in <a id="wrglossary.8977"></a><a href="#glo:opt.mglsopt.all"><span class="csoptfmt">all</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8978"></a><code class="code"><dfn id="glo:opt.mglsopt.others"><span class="csoptfmt">others</span></dfn>=<span class="meta">〈<em class="metainner">option list</em>〉</span></code></div><!-- end of settingsbox -->
+ The value should be a list of any options that can be passed to <a id="wrglossary.8979"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. These options will be passed to each instance of <a id="wrglossary.8980"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> used for the other (not main) labels and will override any conflicting setting in <a id="wrglossary.8981"></a><a href="#glo:opt.mglsopt.all"><span class="csoptfmt">all</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8982"></a><code class="code"><dfn id="glo:opt.mglsopt.hyper"><span class="csoptfmt">hyper</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A boolean option to determine whether or not to use hyperlinks (if supported). This may cause a conflict with other options, but is essentially provided to allow the starred version of <a id="wrglossary.8983"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> to switch off all hyperlinks.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8984"></a><code class="code"><dfn id="glo:opt.mglsopt.multiunset"><span class="csoptfmt">multiunset</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>global</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This only applies to the <a id="wrglossary.8985"></a><a href="#glo:dual.mfirstuseflag">multi-entry first use flag</a>, described in §<a href="#sec:mglsfirstuse">7.7</a>, not the <a id="wrglossary.8986"></a><a href="#glo:dual.firstuseflag">first use flags</a> of the elements. The value may be one of:
+<dl class="inlinetitle">
+ <span class="optfmt">global</span> globally unset the flag; <span class="optfmt">local</span> locally unset the flag; <span class="optfmt">none</span> don’t unset the flag.
+</dl>
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8987"></a><code class="code"><dfn id="glo:opt.mglsopt.presetlocal"><span class="csoptfmt">presetlocal</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A boolean option that governs whether or not the following options should have a local or global effect.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8988"></a><code class="code"><dfn id="glo:opt.mglsopt.resetall"><span class="csoptfmt">resetall</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A boolean option to determine whether or not to reset all elements <span style="font-style: italic; font-variant: normal; ">before</span> using <a id="wrglossary.8989"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. This option refers to the individual entry’s <a id="wrglossary.8990"></a><a href="#glo:dual.firstuseflag">first use flag</a> not the <a id="wrglossary.8991"></a><a href="#glo:dual.mfirstuseflag">multi-entry first use flag</a>. (This is similar to passing <a id="wrglossary.8992"></a><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a> to each <a id="wrglossary.8993"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> but it’s also applied to any skipped elements.)<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8994"></a><code class="code"><dfn id="glo:opt.mglsopt.resetmain"><span class="csoptfmt">resetmain</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A boolean option to determine whether or not to reset the main entry’s <a id="wrglossary.8995"></a><a href="#glo:dual.firstuseflag">first use flag</a> <span style="font-style: italic; font-variant: normal; ">before</span> using <a id="wrglossary.8996"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.8997"></a><code class="code"><dfn id="glo:opt.mglsopt.resetothers"><span class="csoptfmt">resetothers</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A boolean option to determine whether or not to reset the <a id="wrglossary.8998"></a><a href="#glo:dual.firstuseflag">first use flag</a> of all the other (not main) elements <span style="font-style: italic; font-variant: normal; ">before</span> using <a id="wrglossary.8999"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.9000"></a><code class="code"><dfn id="glo:opt.mglsopt.unsetall"><span class="csoptfmt">unsetall</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A boolean option to determine whether or not to unset all elements <span style="font-style: italic; font-variant: normal; ">before</span> using <a id="wrglossary.9001"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. This option refers to the individual entry’s <a id="wrglossary.9002"></a><a href="#glo:dual.firstuseflag">first use flag</a> not the <a id="wrglossary.9003"></a><a href="#glo:dual.mfirstuseflag">multi-entry first use flag</a>. (This is similar to passing <a id="wrglossary.9004"></a><a href="#glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></a> to each <a id="wrglossary.9005"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> but it’s also applied to any skipped elements.)<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.9006"></a><code class="code"><dfn id="glo:opt.mglsopt.unsetmain"><span class="csoptfmt">unsetmain</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A boolean option to determine whether or not to unset the main entry’s <a id="wrglossary.9007"></a><a href="#glo:dual.firstuseflag">first use flag</a> <span style="font-style: italic; font-variant: normal; ">before</span> using <a id="wrglossary.9008"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.9009"></a><code class="code"><dfn id="glo:opt.mglsopt.unsetothers"><span class="csoptfmt">unsetothers</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A boolean option to determine whether or not to unset the <a id="wrglossary.9010"></a><a href="#glo:dual.firstuseflag">first use flag</a> of all the other (not main) elements <span style="font-style: italic; font-variant: normal; ">before</span> using <a id="wrglossary.9011"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>.<p>
+The <span class="optfmt">reset…</span> options all use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9012"></a><code class="code"><dfn id="glo:mglselementreset"><code class="csfmt">\mglselementreset</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The <span class="optfmt">unset…</span> options all use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9013"></a><code class="code"><dfn id="glo:mglselementunset"><code class="csfmt">\mglselementunset</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ These take the <a id="wrglossary.9014"></a><a href="#glo:opt.mglsopt.presetlocal"><span class="csoptfmt">presetlocal</span></a> into account.<p>
+An alternative way of resetting the other elements is to use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9015"></a><code class="code"><dfn id="glo:mglsunsetothers"><code class="csfmt">\mglsunsetothers</code></dfn>{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ or for a local reset: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9016"></a><code class="code"><dfn id="glo:mglslocalunsetothers"><code class="csfmt">\mglslocalunsetothers</code></dfn>{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<p>
+
+</section><!-- end of section sec:mglsopts -->
+
+<section id="sec:mglslike"><!-- start of section sec:mglslike --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->7.11. Variants of <code class="csfmt">\mgls</code><div class="labellink"><a href="#sec:mglslike">[link]</a></div></h2><!-- end of section header -->
+<p>
+The commands listed in this section all behave like <a id="wrglossary.9017"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>. These (including <a id="wrglossary.9018"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> itself) are collectively referred to as the <a id="wrglossary.9019"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>-like commands. All commands unset the <a id="wrglossary.9020"></a><a href="#glo:dual.mfirstuseflag">multi-entry first use flag</a> (unless the <a id="wrglossary.9021"></a><a href="#glo:opt.mglsopt.multiunset"><span class="csoptfmt">multiunset</span></a><span class="optfmt">=none</span> option is applied). Only those commands that use the <a id="wrglossary.9022"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands (such as <a id="wrglossary.9023"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or <a id="wrglossary.9024"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>) will unset the individual entry’s <a id="wrglossary.9025"></a><a href="#glo:dual.firstuseflag">first use flag</a>.<p>
+
+</section><!-- end of section sec:mglslike -->
+
+<section id="sec:mglsbasic"><!-- start of section sec:mglsbasic --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->7.11.1. <code class="csfmt">\gls</code>-like<div class="labellink"><a href="#sec:mglsbasic">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9026"></a><code class="code"><dfn id="glo:mglspl"><code class="csfmt">\mglspl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9027"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9028"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9029"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.9030"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> instead of <a id="wrglossary.9031"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> for each entry.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9032"></a><code class="code"><dfn id="glo:mglsmainpl"><code class="csfmt">\mglsmainpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9033"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9034"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9035"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.9036"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> instead of <a id="wrglossary.9037"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> for the main entry and <a id="wrglossary.9038"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> for all the other entries.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9039"></a><code class="code"><dfn id="glo:Mgls"><code class="csfmt">\Mgls</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9040"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9041"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9042"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.9043"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> for the first entry and <a id="wrglossary.9044"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> for the other entries.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9045"></a><code class="code"><dfn id="glo:MGls"><code class="csfmt">\MGls</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9046"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9047"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9048"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.9049"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> for all entries.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9050"></a><code class="code"><dfn id="glo:Mglspl"><code class="csfmt">\Mglspl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9051"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9052"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9053"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.9054"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a> for the first entry and <a id="wrglossary.9055"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> for the remaining entries.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9056"></a><code class="code"><dfn id="glo:Mglsmainpl"><code class="csfmt">\Mglsmainpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9057"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9058"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9059"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ The first entry uses the appropriate <a id="wrglossary.9060"></a><a href="#glo:idx.sentencecase">sentence case</a> command. The plural form is used for the main entry. So, if the first entry is also the main entry, <a id="wrglossary.9061"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a> is used, otherwise <a id="wrglossary.9062"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> is used. For the remaining entries, <a id="wrglossary.9063"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> will be used if the entry is the main one, otherwise <a id="wrglossary.9064"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> will be used.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9065"></a><code class="code"><dfn id="glo:MGlspl"><code class="csfmt">\MGlspl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9066"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9067"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9068"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.9069"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a> for all entries.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9070"></a><code class="code"><dfn id="glo:MGlsmainpl"><code class="csfmt">\MGlsmainpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9071"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9072"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9073"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.9074"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a> for the main entry and <a id="wrglossary.9075"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> for the other entries.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9076"></a><code class="code"><dfn id="glo:MGLS"><code class="csfmt">\MGLS</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9077"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9078"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9079"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.9080"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a> for all entries.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9081"></a><code class="code"><dfn id="glo:MGLSpl"><code class="csfmt">\MGLSpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9082"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9083"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9084"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.9085"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a> instead of <a id="wrglossary.9086"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> for each entry.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9087"></a><code class="code"><dfn id="glo:MGLSmainpl"><code class="csfmt">\MGLSmainpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9088"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9089"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9090"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.9091"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a> for the main entry and <a id="wrglossary.9092"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a> for the others.<p>
+
+</section><!-- end of section sec:mglsbasic -->
+
+<section id="sec:mglsabbrv"><!-- start of section sec:mglsabbrv --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->7.11.2. Abbreviations<div class="labellink"><a href="#sec:mglsabbrv">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9093"></a><code class="code"><dfn id="glo:mglsshort"><code class="csfmt">\mglsshort</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9094"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9095"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9096"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This will use <a id="wrglossary.9097"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> for any entries that have the <a id="wrglossary.9098"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> field set and will use <a id="wrglossary.9099"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> otherwise.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9100"></a><code class="code"><dfn id="glo:mglslong"><code class="csfmt">\mglslong</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9101"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9102"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9103"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This will use <a id="wrglossary.9104"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> for any entries that have the <a id="wrglossary.9105"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> field set and will use <a id="wrglossary.9106"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> otherwise.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9107"></a><code class="code"><dfn id="glo:mglsfull"><code class="csfmt">\mglsfull</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9108"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9109"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9110"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This will use <a id="wrglossary.9111"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> for any entries that have the <a id="wrglossary.9112"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> field set and will use <a id="wrglossary.9113"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a> otherwise.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9114"></a><code class="code"><dfn id="glo:Mglsshort"><code class="csfmt">\Mglsshort</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9115"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9116"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9117"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.9118"></a><a href="#glo:mglsshort"><code class="csfmt">\mglsshort</code></a> but <a id="wrglossary.9119"></a><a href="#glo:idx.sentencecase">sentence case</a> for the first entry.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9120"></a><code class="code"><dfn id="glo:Mglslong"><code class="csfmt">\Mglslong</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9121"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9122"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9123"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.9124"></a><a href="#glo:mglslong"><code class="csfmt">\mglslong</code></a> but <a id="wrglossary.9125"></a><a href="#glo:idx.sentencecase">sentence case</a> for the first entry.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9126"></a><code class="code"><dfn id="glo:Mglsfull"><code class="csfmt">\Mglsfull</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9127"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9128"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9129"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.9130"></a><a href="#glo:mglsfull"><code class="csfmt">\mglsfull</code></a> but <a id="wrglossary.9131"></a><a href="#glo:idx.sentencecase">sentence case</a> for the first entry.<p>
+
+</section><!-- end of section sec:mglsabbrv -->
+
+<section id="sec:mglsotherfields"><!-- start of section sec:mglsotherfields --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->7.11.3. Other Fields<div class="labellink"><a href="#sec:mglsotherfields">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9132"></a><code class="code"><dfn id="glo:mglsname"><code class="csfmt">\mglsname</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9133"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9134"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9135"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.9136"></a><a href="#glo:glsname"><code class="csfmt">\glsname</code></a> for each entry.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9137"></a><code class="code"><dfn id="glo:Mglsname"><code class="csfmt">\Mglsname</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9138"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9139"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9140"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.9141"></a><a href="#glo:Glsname"><code class="csfmt">\Glsname</code></a> for the first entry and <a id="wrglossary.9142"></a><a href="#glo:glsname"><code class="csfmt">\glsname</code></a> for the remaining entries.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9143"></a><code class="code"><dfn id="glo:MGlsname"><code class="csfmt">\MGlsname</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9144"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9145"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9146"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.9147"></a><a href="#glo:Glsname"><code class="csfmt">\Glsname</code></a> for each entry.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9148"></a><code class="code"><dfn id="glo:mglssymbol"><code class="csfmt">\mglssymbol</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9149"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9150"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9151"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.9152"></a><a href="#glo:glssymbol"><code class="csfmt">\glssymbol</code></a> for each entry if the <a id="wrglossary.9153"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> field has been set, otherwise it uses <a id="wrglossary.9154"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9155"></a><code class="code"><dfn id="glo:MGlssymbol"><code class="csfmt">\MGlssymbol</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9156"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9157"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9158"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.9159"></a><a href="#glo:glssymbol"><code class="csfmt">\glssymbol</code></a> if the <a id="wrglossary.9160"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> field has been set otherwise it uses <a id="wrglossary.9161"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> for each element. (Note that no <a id="wrglossary.9162"></a><a href="#glo:idx.casechange">case change</a> is applied to the symbol as this usually isn’t appropriate.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9163"></a><code class="code"><dfn id="glo:Mglssymbol"><code class="csfmt">\Mglssymbol</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9164"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9165"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9166"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.9167"></a><a href="#glo:MGlssymbol"><code class="csfmt">\MGlssymbol</code></a>, but <a id="wrglossary.9168"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> is only used for the first element (if it doesn’t have the <a id="wrglossary.9169"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> field set).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9170"></a><code class="code"><dfn id="glo:mglsusefield"><code class="csfmt">\mglsusefield</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9171"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9172"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9173"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ If the field given by <a id="wrglossary.9174"></a><a href="#glo:mglsfield"><code class="csfmt">\mglsfield</code></a> exists for an element, <a id="wrglossary.9175"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a> will be used for that element, with the <a id="wrglossary.9176"></a><a href="#glo:dual.linktext">link text</a> obtained from the field value (followed by the <span class="meta">〈<em class="metainner">insert</em>〉</span>), otherwise <a id="wrglossary.9177"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> will be used.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9178"></a><code class="code"><dfn id="glo:mglsfield"><code class="csfmt">\mglsfield</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>useri</span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This command expands to the <a id="wrglossary.9179"></a><a href="#glo:dual.internalfieldlabel">internal field label</a> required by <a id="wrglossary.9180"></a><a href="#glo:mglsusefield"><code class="csfmt">\mglsusefield</code></a>. The default value is <code class="code">useri</code>, which corresponds to the <a id="wrglossary.9181"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9182"></a><code class="code"><dfn id="glo:Mglsusefield"><code class="csfmt">\Mglsusefield</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9183"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9184"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9185"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.9186"></a><a href="#glo:mglsusefield"><code class="csfmt">\mglsusefield</code></a> but <a id="wrglossary.9187"></a><a href="#glo:idx.sentencecase">sentence case</a> for the first element.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9188"></a><code class="code"><dfn id="glo:MGlsusefield"><code class="csfmt">\MGlsusefield</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9189"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9190"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9191"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.9192"></a><a href="#glo:mglsusefield"><code class="csfmt">\mglsusefield</code></a> but <a id="wrglossary.9193"></a><a href="#glo:idx.sentencecase">sentence case</a> for each element.<p>
+You can use the pre-element hook <a id="wrglossary.9194"></a><a href="#glo:mglselementprehook"><code class="csfmt">\mglselementprehook</code></a> to locally redefine <a id="wrglossary.9195"></a><a href="#glo:mglsfield"><code class="csfmt">\mglsfield</code></a>. Examples:
+<ol class="displaylist">
+ <li><span class="numitem">1.</span>if the multi-category is <span class="qt">“sample”</span> then use the <a id="wrglossary.9196"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a> field otherwise use the <a id="wrglossary.9197"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> field: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.9198"></a><a href="#glo:mglselementprehook"><code class="csfmt">\mglselementprehook</code></a>}{%
+ <code class="cmd">\ifdefstring</code>{<a id="wrglossary.9199"></a><a href="#glo:mglscurrentcategory"><code class="csfmt">\mglscurrentcategory</code></a>}{sample}%
+ {<code class="cmd">\renewcommand</code>{<a id="wrglossary.9200"></a><a href="#glo:mglsfield"><code class="csfmt">\mglsfield</code></a>}{userii}}%
+ {<code class="cmd">\renewcommand</code>{<a id="wrglossary.9201"></a><a href="#glo:mglsfield"><code class="csfmt">\mglsfield</code></a>}{useri}}%
}
-</pre>
-<!--l. 9741--><p class="nopar" >
-</p><!--l. 9743--><p class="indent" > A multi-entry label may also be used in the <span
-class="cmss-10">alias</span><a
- id="dx1-68008"></a> key. The hyperlink target will be
-the target for the main entry. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-220">
-\multiglossaryentry{cbot}{clostridium,botulinum}
-\newglossaryentry{botox}{name=botox,description={},alias={cbot}}
-</pre>
-<!--l. 9748--><p class="nopar" > In this case <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls{botox}</span></span></span> will hyperlink to the <span
-class="cmtt-10">botulinum </span>target.
-</p><!--l. 9752--><p class="indent" > <div class="important" title="Important Note"> Any multi-entries used in the cross-referencing keys must be defined before the
-glossary is displayed. There is some support for <a
-href="#styopt.docdef"><span
-class="cmss-10">docdef</span></a><span
-class="cmss-10">=true</span><a
- id="dx1-68009"></a> but not for the other
-<a
-href="#styopt.docdef"><span
-class="cmss-10">docdef</span></a><a
- id="dx1-68010"></a> settings. </div>
-</p><!--l. 9756--><p class="noindent" >
-</p><!--l. 9758--><p class="noindent" >
-</p>
-<!--l. 9758--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6.13 </span> <a
- id="sec:multiextras"></a>Additional Commands</h3>
-<!--l. 9761--><p class="noindent" >You can test if a label represents a multi-entry using:
-</p><!--l. 9762--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-69001"></a> <span
-class="cmtt-10">\glsxtrifmulti{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9764--><p class="noindent" >
-The following command will expand to the main entry label for the given multi-entry
-label:
-</p><!--l. 9767--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-69002"></a> <span
-class="cmtt-10">\glsxtrmultimain{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9769--><p class="noindent" >
-This will expand to nothing if the supplied &#x27E8;<span
-class="cmti-10">multi-label</span>&#x27E9; hasn&#8217;t been defined as a
-multi-entry. Similarly, for the complete label list:
-</p><!--l. 9773--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-69003"></a> <span
-class="cmtt-10">\glsxtrmultilist{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9775--><p class="noindent" >
-</p><!--l. 9777--><p class="indent" > To iterate over all the list of all elements:
-</p><!--l. 9778--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-69004"></a> <span
-class="cmtt-10">\mglsforelements{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">cs</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">body</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9780--><p class="noindent" >
-This defines &#x27E8;<span
-class="cmti-10">cs</span>&#x27E9; to the current element label on each iteration of the loop, which can
-be used to reference the label in &#x27E8;<span
-class="cmti-10">body</span>&#x27E9;. This internally uses <span
-class="cmtt-10">\@for </span>(patched by the <span
-class="cmss-10">xfor</span><a
- id="dx1-69005"></a>
-package).
-</p><!--l. 9786--><p class="indent" > There is a similar command that skips the main element:
-</p><!--l. 9787--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-69006"></a> <span
-class="cmtt-10">\mglsforotherelements{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">cs</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">body</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9789--><p class="noindent" >
-</p><!--l. 9791--><p class="indent" > The total number of elements can be obtained with:
-</p><!--l. 9792--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-69007"></a> <span
-class="cmtt-10">\glsxtrmultitotalelements{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9794--><p class="noindent" >
-This expands to the number, if &#x27E8;<span
-class="cmti-10">multi-label</span>&#x27E9; is defined, otherwise expands to
-nothing.
-
-
-
-</p><!--l. 9798--><p class="indent" > The index of the main element can be obtained with:
-</p><!--l. 9799--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-69008"></a> <span
-class="cmtt-10">\glsxtrmultimainindex{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9801--><p class="noindent" >
-This expands to the index, if &#x27E8;<span
-class="cmti-10">multi-label</span>&#x27E9; is defined, otherwise expands to nothing.
-Indexing starts from 1 for the first element. The index of the final non-main element
-can be obtained with:
-</p><!--l. 9806--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-69009"></a> <span
-class="cmtt-10">\glsxtrmultilastotherindex{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9808--><p class="noindent" >
-</p><!--l. 9810--><p class="indent" > The <span
-class="cmtt-10">\multiglossaryentry </span>command will write the label information to the <span
-class="cmtt-10">aux</span><a
- id="dx1-69010"></a>
-file using:
-</p><!--l. 9812--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-69011"></a> <span
-class="cmtt-10">\writemultiglossentry{</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">main-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">list</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 9814--><p class="noindent" >
-This is will write the following line to the <span
-class="cmtt-10">aux</span><a
- id="dx1-69012"></a> file:
-</p><!--l. 9817--><p class="indent" > <hr><div title="Definition"><span
-class="cmtt-10">\@glsxtr@multientry{</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">multi-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">main-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">list</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 9818--><p class="noindent" >
-This is provided to support <a
-href="#styopt.docdef"><span
-class="cmss-10">docdef</span></a><span
-class="cmss-10">=true</span><a
- id="dx1-69013"></a> and also for the benefit of any tools that
-require the information (such as <a
- id="dx1-69014"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> or autocompletion tools). If it&#8217;s
-not required and causes too much clutter, it can be disabled by redefining
-<span
-class="cmtt-10">\writemultiglossentry </span>to do nothing.
-</p><!--l. 9825--><p class="noindent" >
-</p>
-<!--l. 9825--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6.14 </span> <a
- id="sec:mbib2gls"></a>bib2gls</h3>
-<!--l. 9828--><p class="noindent" >In the <a
- id="dx1-70001"></a><span
-class="cmtt-10">bib2gls </span>v2.9+ user manual, these multi-entry sets are referred to as
-&#8220;compound entries&#8221; or &#8220;compound sets&#8221; to differentiate them from <a
- id="dx1-70002"></a><span
-class="cmtt-10">bib2gls</span>&#8217;s
-multi-entry types (such as <span
-class="cmtt-10">@dualentry</span>).
-</p><!--l. 9833--><p class="indent" > Each instance of one of the <span
-class="cmtt-10">\mgls</span>-like commands is written to the <span
-class="cmtt-10">aux</span><a
- id="dx1-70003"></a> file and so
-can be picked up by <a
- id="dx1-70004"></a><span
-class="cmtt-10">bib2gls </span>(at least version 2.9). The resource options can be used
-to determine whether or not to consider the other (non-main) elements to be
-dependent on the main element.
-</p><!--l. 9839--><p class="indent" > With <a
- id="dx1-70005"></a><span
-class="cmtt-10">bib2gls</span>, you can either define the compound entries in the document with
-<span
-class="cmtt-10">\multiglossaryentry </span>(or <span
-class="cmtt-10">\providemultiglossaryentry</span>) or you can use the
-<span
-class="cmtt-10">@compoundset </span>entry type in a <span
-class="cmtt-10">bib</span><a
- id="dx1-70006"></a> file. Whichever method you use, remember that
-the entries that form the elements of the set must be defined first. See the <a
- id="dx1-70007"></a><span
-class="cmtt-10">bib2gls</span>
-manual (v2.9+) for further details.
-</p><!--l. 9846--><p class="indent" > You can use the resource option <span
-class="cmss-10">compound-adjust-name </span>to replace the <span
-class="cmss-10">name</span><a
- id="dx1-70008"></a> field
-of the main entry to:
-</p><!--l. 9848--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-70009"></a> <span
-class="cmtt-10">\glsxtrmultientryadjustedname{</span>&#x27E8;<span
-class="cmitt-10">sublist1</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">name</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">sublist2</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 9850--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; is the label identifying the compound set, &#x27E8;<span
-class="cmti-10">name</span>&#x27E9; was the value of the
-
-
-
-<span
-class="cmss-10">name</span><a
- id="dx1-70010"></a> before adjustment, &#x27E8;<span
-class="cmti-10">sublist1</span>&#x27E9; is the sub-list of other element labels before the
-main element (empty if the main element is the first element in the list), and &#x27E8;<span
-class="cmti-10">sublist2</span>&#x27E9;
-is the sub-list of other elements after the main element (empty if the main label is the
-final element).
-</p><!--l. 9859--><p class="indent" > This command is defined in <span
-class="cmss-10">glossaries-extra-bib2gls</span><a
- id="dx1-70011"></a>, which is automatically loaded
-with <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=only</span><a
- id="dx1-70012"></a> and <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=nameref</span><a
- id="dx1-70013"></a>. Case-changing versions of this command are
-also available. First letter uppercase:
-</p><!--l. 9863--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-70014"></a> <span
-class="cmtt-10">\Glsxtrmultientryadjustedname{</span>&#x27E8;<span
-class="cmitt-10">sublist1</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">name</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">sublist2</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 9865--><p class="noindent" >
-Title case:
-</p><!--l. 9867--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-70015"></a> <span
-class="cmtt-10">\GlsXtrmultientryadjustedname{</span>&#x27E8;<span
-class="cmitt-10">sublist1</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">name</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">sublist2</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 9869--><p class="noindent" >
-All uppercase:
-</p><!--l. 9871--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-70016"></a> <span
-class="cmtt-10">\GLSxtrmultientryadjustedname{</span>&#x27E8;<span
-class="cmitt-10">sublist1</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">name</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">sublist2</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 9873--><p class="noindent" >
-</p><!--l. 9875--><p class="indent" > Note that this command doesn&#8217;t take the prefix or suffix into account (see
-<a
-href="#sec:mglsfixes"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.3</span> </a><a
-href="#sec:mglsfixes">Prefixes and Suffixes<!--tex4ht:ref: sec:mglsfixes --></a>).
-</p><!--l. 9878--><p class="indent" > The separator between each element in the sub-lists is produced with:
-</p><!--l. 9880--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-70017"></a> <span
-class="cmtt-10">\glsxtrmultientryadjustednamesep{</span>&#x27E8;<span
-class="cmitt-10">pre label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">post label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9882--><p class="noindent" >
-The default definition just uses <span
-class="cmtt-10">\glscombinedfirstsepfirst</span>.
-</p><!--l. 9885--><p class="indent" > The separator between the last element of &#x27E8;<span
-class="cmti-10">sublist1</span>&#x27E9; and the main element is
-produced with:
-</p><!--l. 9887--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-70018"></a> <span
-class="cmtt-10">\glsxtrmultientryadjustednamepresep{</span>&#x27E8;<span
-class="cmitt-10">pre label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">post label</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 9889--><p class="noindent" >
-Similarly for the separator between the main element and the first element of
-&#x27E8;<span
-class="cmti-10">sublist2</span>&#x27E9;:
-</p><!--l. 9892--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-70019"></a> <span
-class="cmtt-10">\glsxtrmultientryadjustednamepostsep{</span>&#x27E8;<span
-class="cmitt-10">pre label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">post label</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 9894--><p class="noindent" >
-These both default to <span
-class="cmtt-10">\glsxtrmultientryadjustednamesep</span>.
-</p><!--l. 9897--><p class="indent" > The &#x27E8;<span
-class="cmti-10">name</span>&#x27E9; is encapsulated with:
-</p><!--l. 9898--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-70020"></a> <span
-class="cmtt-10">\glsxtrmultientryadjustednamefmt{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9900--><p class="noindent" >
-This just does its argument by default. If &#x27E8;<span
-class="cmti-10">sublist1</span>&#x27E9; is empty for the first letter upper
-case version, then &#x27E8;<span
-class="cmti-10">name</span>&#x27E9; is encapsulated with:
-</p><!--l. 9904--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-70021"></a> <span
-class="cmtt-10">\Glsxtrmultientryadjustednamefmt{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9906--><p class="noindent" >
-This does <span
-class="cmtt-10">\makefirstuc</span><a
- id="dx1-70022"></a><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmti-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span>by default. For the title case version, the name is
-encapsulated with:
-</p><!--l. 9909--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-70023"></a> <span
-class="cmtt-10">\GlsXtrmultientryadjustednamefmt{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-
-
-
-</p><!--l. 9911--><p class="noindent" >
-This uses <span
-class="cmtt-10">\glscapitalisewords </span>(provided by <span
-class="cmss-10">glossaries </span>v4.48+) if defined or
-<span
-class="cmtt-10">\capitalisewords </span>otherwise. The all uppercase version uses:
-</p><!--l. 9915--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-70024"></a> <span
-class="cmtt-10">\GLSxtrmultientryadjustednamefmt{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9917--><p class="noindent" >
-This uses <span
-class="cmtt-10">\mfirstucMakeUppercase </span>by default.
-</p><!--l. 9920--><p class="indent" > Each element label in the sub-lists is encapsulated with:
-</p><!--l. 9921--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-70025"></a> <span
-class="cmtt-10">\glsxtrmultientryadjustednameother{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9923--><p class="noindent" >
-This does <span
-class="cmtt-10">\glsentryname{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span>by default. For the first letter uppercase
-version (where &#x27E8;<span
-class="cmti-10">sublist1</span>&#x27E9; isn&#8217;t empty), then the element label is encapsulated
-with:
-</p><!--l. 9928--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-70026"></a> <span
-class="cmtt-10">\Glsxtrmultientryadjustednameother{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9930--><p class="noindent" >
-This does <span
-class="cmtt-10">\Glsentryname{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span>by default. The title case version uses:
-</p><!--l. 9933--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-70027"></a> <span
-class="cmtt-10">\GlsXtrmultientryadjustednameother{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9935--><p class="noindent" >
-This does <span
-class="cmtt-10">\glsentrytitlecase</span><a
- id="dx1-70028"></a><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">{name}</span></span></span> by default. The all uppercase version
-uses:
-</p><!--l. 9939--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-70029"></a> <span
-class="cmtt-10">\GLSxtrmultientryadjustednameother{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9941--><p class="noindent" >
-This is defined as:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-221">
-\newcommand*{\GLSxtrmultientryadjustednameother}[1]{%
-&#x00A0;\mfirstucMakeUppercase{\glsentryname{#1}}}
-</pre>
-<!--l. 9946--><p class="nopar" >
-
-
-
-</p>
-<!--l. 9948--><p class="indent" > </div>
-</p><!--l. 9948--><p class="noindent" ><a
-href="#top">Top</a><div class="chapter"><h2 class="chapterHead">7. <a
- id="sec:categories"></a>Categories</h2>
-</p><!--l. 9951--><p class="indent" > Each entry defined by <span
-class="cmtt-10">\newglossaryentry</span><a
- id="dx1-71001"></a> (or commands that internally use it
-such as <span
-class="cmtt-10">\newabbreviation</span><a
- id="dx1-71002"></a>) is assigned a category through the <span
-class="cmss-10">category</span><a
- id="dx1-71003"></a> key. You may
-add any category that you like, but since the category is a label used in the creation
-of some control sequences, avoid problematic characters within the category label.
-(So take care if you have <span
-class="cmss-10">babel</span><a
- id="dx1-71004"></a> shorthands on that make some characters
-active.)
-</p><!--l. 9960--><p class="indent" > The use of categories can give you more control over the way entries are displayed
-in the text or glossary. Note that an entry&#8217;s category is independent of the glossary
-type. Be careful not to confuse <span
-class="cmss-10">category</span><a
- id="dx1-71005"></a> with <span
-class="cmss-10">type</span><a
- id="dx1-71006"></a>.
-</p><!--l. 9965--><p class="indent" > For multi-entry categories, see <a
-href="#sec:multiglscategory"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">6.8</span> </a><a
-href="#sec:multiglscategory">Multi-Entry Category<!--tex4ht:ref: sec:multiglscategory --></a>.
-</p><!--l. 9967--><p class="indent" > The default category assumed by <span
-class="cmtt-10">\newglossaryentry </span>is labelled <span
-class="cmss-10">general</span><a
- id="dx1-71007"></a>.
-Abbreviations defined with <span
-class="cmtt-10">\newabbreviation </span>have the category set to <span
-class="cmss-10">abbreviation</span><a
- id="dx1-71008"></a>
-by default. Abbreviations defined with <span
-class="cmtt-10">\newacronym </span>have the category set to
-<span
-class="cmss-10">acronym</span><a
- id="dx1-71009"></a> by default.
-</p><!--l. 9974--><p class="indent" > Additionally, if you have enabled <span
-class="cmtt-10">\newterm</span><a
- id="dx1-71010"></a> with the <a
-href="#styopt.index"><span
-class="cmss-10">index</span></a><a
- id="dx1-71011"></a> package option
-that command will set the category to <span
-class="cmss-10">index</span><a
- id="dx1-71012"></a> by default. If you have enabled
-<span
-class="cmtt-10">\glsxtrnewsymbol</span><a
- id="dx1-71013"></a> with the <a
-href="#styopt.symbols"><span
-class="cmss-10">symbols</span></a><a
- id="dx1-71014"></a> package option, that command will set the
-category to <span
-class="cmss-10">symbol</span><a
- id="dx1-71015"></a>. If you have enabled <span
-class="cmtt-10">\glsxtrnewnumber</span><a
- id="dx1-71016"></a> with the <a
-href="#styopt.numbers"><span
-class="cmss-10">numbers</span></a><a
- id="dx1-71017"></a> package
-option, that command will set the category to <span
-class="cmss-10">number</span><a
- id="dx1-71018"></a>.
-</p><!--l. 9982--><p class="indent" > You can obtain the category label for a given entry using
-</p><!--l. 9983--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-71019"></a> <span
-class="cmtt-10">\glscategory{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 9985--><p class="noindent" >
-This is equivalent to commands like <span
-class="cmtt-10">\glsentryname </span>and so may be used in an
-expandable context. No error is generated if the entry doesn&#8217;t exist.
-</p><!--l. 9990--><p class="indent" > You can test the category for a given entry using
-</p><!--l. 9991--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-71020"></a> <span
-class="cmtt-10">\glsifcategory{</span>&#x27E8;<span
-class="cmitt-10">entry-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">category-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true part</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false part</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 9994--><p class="noindent" >
-This is equivalent to </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\ifglsfieldeq</span><a
- id="dx1-71021"></a><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">entry-label</span>&#x27E9;<span
-class="cmtt-10">}</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">category</span><span
-class="cmsy-10">}</span><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">category-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>
-<br /><span
-class="cmitt-10">part</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span><span
-class="cmitt-10">&#x00A0;part</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div>
-</div> so any restrictions that apply to <span
-class="cmtt-10">\ifglsfieldeq </span>also apply to <span
-class="cmtt-10">\glsifcategory</span>.
-<!--l. 10003--><p class="indent" > Each category may have a set of attributes. For example, the <span
-class="cmss-10">general</span><a
- id="dx1-71022"></a> and <span
-class="cmss-10">acronym</span><a
- id="dx1-71023"></a>
-categories have the attribute <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-71024"></a> set to &#8220;true&#8221; to indicate that all entries with
-either of those categories are regular entries (as opposed to abbreviations).
-This attribute is accessed by <span
-class="cmtt-10">\glsentryfmt </span>to determine whether to use
-<span
-class="cmtt-10">\glsgenentryfmt </span>or <span
-class="cmtt-10">\glsxtrgenabbrvfmt</span>.
-</p><!--l. 10011--><p class="indent" > Other attributes recognised by <span
-class="cmss-10">glossaries-extra </span>are:
- </p><dl class="description"><dt class="description">
-
-
-
-<a
- id="catattr.nohyperfirst"></a><span
-class="cmssbx-10">nohyperfirst</span><a
- id="dx1-71025"></a> </dt><dd
-class="description">When using commands like <span
-class="cmtt-10">\gls</span><a
- id="dx1-71026"></a> this will automatically suppress the
- hyperlink on <a
- id="dx1-71027"></a><a
-href="#glo:firstuse">first use</a> for entries with a category that has this attribute set to
- &#8220;true&#8221;. (This settings can be overridden by explicitly setting the <span
-class="cmss-10">hyper</span><a
- id="dx1-71028"></a>
- key on or off in the optional argument of commands like <span
-class="cmtt-10">\gls</span>.) As
- from version 1.07, <span
-class="cmtt-10">\glsfirst</span>, <span
-class="cmtt-10">\Glsfirst</span>, <span
-class="cmtt-10">\GLSfirst </span>and their plural
- versions (which should ideally behave in a similar way to the <a
- id="dx1-71029"></a>first use of
- <span
-class="cmtt-10">\gls </span>or <span
-class="cmtt-10">\glspl</span>) now honour this attribute (but not the package-wide
- <a
-href="#styopt.hyperfirst"><span
-class="cmss-10">hyperfirst</span></a><span
-class="cmss-10">=false</span><a
- id="dx1-71030"></a> option, which matches the behaviour of <span
-class="cmss-10">glossaries</span><a
- id="dx1-71031"></a>). If you want
- commands like <span
-class="cmtt-10">\glsfirst </span>to ignore the <a
-href="#catattr.nohyperfirst"><span
-class="cmss-10">nohyperfirst</span></a><a
- id="dx1-71032"></a> attribute then just
- redefine
- <!--l. 10028--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-71033"></a> <span
-class="cmtt-10">\glsxtrchecknohyperfirst{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
- </p><!--l. 10030--><p class="noindent" >
- to do nothing.
- </p></dd><dt class="description">
-<a
- id="catattr.nohyper"></a><span
-class="cmssbx-10">nohyper</span><a
- id="dx1-71034"></a> </dt><dd
-class="description">When using commands like <span
-class="cmtt-10">\gls</span><a
- id="dx1-71035"></a> this will automatically suppress the
- hyperlink for entries with a category that has this attribute set to &#8220;true&#8221;. (This
- settings can be overridden by explicitly setting the <span
-class="cmss-10">hyper</span><a
- id="dx1-71036"></a> key on or off in the
- optional argument of commands like <span
-class="cmtt-10">\gls</span>.)
- </dd><dt class="description">
-<a
- id="catattr.indexonlyfirst"></a><span
-class="cmssbx-10">indexonlyfirst</span><a
- id="dx1-71037"></a> </dt><dd
-class="description">This is similar to the <a
-href="#styopt.indexonlyfirst"><span
-class="cmss-10">indexonlyfirst</span></a><a
- id="dx1-71038"></a> package option but only for entries
- that have a category with this attribute set to &#8220;true&#8221;.
- </dd><dt class="description">
-<a
- id="catattr.wrgloss"></a><span
-class="cmssbx-10">wrgloss</span><a
- id="dx1-71039"></a> </dt><dd
-class="description">When using commands like <span
-class="cmtt-10">\gls</span><a
- id="dx1-71040"></a>, if this attribute is set to &#8220;after&#8221;, it will
- automatically implement <span
-class="cmss-10">wrgloss</span><a
- id="dx1-71041"></a><span
-class="cmss-10">=after</span>. (New to v1.14.)
- </dd><dt class="description">
-<a
- id="catattr.discardperiod"></a><span
-class="cmssbx-10">discardperiod</span><a
- id="dx1-71042"></a> </dt><dd
-class="description">If set to &#8220;true&#8221;, the post-<a
- id="dx1-71043"></a><a
-href="#glo:linktext">link-text</a> hook will discard a&#x00A0;full stop
- (period) that follows <span
-class="cmti-10">non-plural </span>commands like <span
-class="cmtt-10">\gls </span>or <span
-class="cmtt-10">\glstext</span>. (Provided
- for entries such as abbreviations that end with a full stop.) This attribute is
- only applicable to entries defined using <span
-class="cmtt-10">\newabbreviation </span>(or <span
-class="cmtt-10">\newacronym </span>if
- it&#8217;s using <span
-class="cmtt-10">\newabbreviation</span>.) This attribute doesn&#8217;t apply to the accessibility
- fields.
- <!--l. 10057--><p class="noindent" >Note that this can cause a problem if you access a field that doesn&#8217;t end with a
- full stop. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-222">
- \newabbreviation
- &#x00A0;[user1={German&#x00A0;Speaking&#x00A0;\TeX\&#x00A0;User&#x00A0;Group}]
- &#x00A0;{dante}{DANTE&#x00A0;e.V.}{Deutschsprachige&#x00A0;Anwendervereinigung&#x00A0;\TeX\
- e.V.}
-</pre>
- <!--l. 10064--><p class="nopar" > Here the <span
-class="cmss-10">short</span><a
- id="dx1-71044"></a> and <span
-class="cmss-10">long</span><a
- id="dx1-71045"></a> fields end with a full stop, but the <span
-class="cmss-10">user1</span><a
- id="dx1-71046"></a> field doesn&#8217;t.
- The simplest solution in this situation is to put the sentence terminator in the
- final optional argument. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-223">
- \glsuseri{dante}[.]
-</pre>
- <!--l. 10071--><p class="nopar" > This will bring the punctuation character inside the <a
- id="dx1-71047"></a><a
-href="#glo:linktext">link-text</a> and it won&#8217;t be
- discarded.
- </p></dd><dt class="description">
-<a
- id="catattr.pluraldiscardperiod"></a><span
-class="cmssbx-10">pluraldiscardperiod</span><a
- id="dx1-71048"></a> </dt><dd
-class="description">If this attribute is set to &#8220;true&#8221; <span
-class="cmti-10">and </span>the <a
-href="#catattr.discardperiod"><span
-class="cmss-10">discardperiod</span></a><a
- id="dx1-71049"></a> attribute is
- set to &#8220;true&#8221;, this will behave as above for the plural commands like <span
-class="cmtt-10">\glspl </span>or
- <span
-class="cmtt-10">\glsplural</span>. This attribute is only applicable to entries defined using
- <span
-class="cmtt-10">\newabbreviation </span>(or <span
-class="cmtt-10">\newacronym </span>if it&#8217;s using <span
-class="cmtt-10">\newabbreviation</span>.)
- </dd><dt class="description">
-<a
- id="catattr.retainfirstuseperiod"></a><span
-class="cmssbx-10">retainfirstuseperiod</span><a
- id="dx1-71050"></a> </dt><dd
-class="description">If this attribute is set to &#8220;true&#8221; then the full stop won&#8217;t be
- discarded for <a
- id="dx1-71051"></a><a
-href="#glo:firstuse">first use</a> instances, even if <a
-href="#catattr.discardperiod"><span
-class="cmss-10">discardperiod</span></a><a
- id="dx1-71052"></a> or <a
-href="#catattr.pluraldiscardperiod"><span
-class="cmss-10">pluraldiscardperiod</span></a><a
- id="dx1-71053"></a> are
- set. This is useful for &#x27E8;<span
-class="cmti-10">short</span>&#x27E9; (&#x27E8;<span
-class="cmti-10">long</span>&#x27E9;) abbreviation styles where only the
- short form has a trailing full stop. This attribute is only applicable to
- entries defined using <span
-class="cmtt-10">\newabbreviation </span>(or <span
-class="cmtt-10">\newacronym </span>if it&#8217;s using
- <span
-class="cmtt-10">\newabbreviation</span>.) This attribute doesn&#8217;t apply to the accessibility
- fields.
- </dd><dt class="description">
-<a
- id="catattr.markwords"></a><span
-class="cmssbx-10">markwords</span><a
- id="dx1-71054"></a> </dt><dd
-class="description">If this attribute is set to &#8220;true&#8221; any entry defined using <span
-class="cmtt-10">\newabbreviation</span><a
- id="dx1-71055"></a>
- will automatically have spaces in the long form replaced with
- <!--l. 10095--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-71056"></a> <span
-class="cmtt-10">\glsxtrwordsep </span></div><hr>
- </p><!--l. 10097--><p class="noindent" >
- and each word is encapsulated with
- </p><!--l. 10099--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-71057"></a> <span
-class="cmtt-10">\glsxtrword{</span>&#x27E8;<span
-class="cmitt-10">word</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
- </p><!--l. 10101--><p class="noindent" >
- For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-224">
- \glssetcategoryattribute{abbreviation}{markwords}{true}
- \newabbreviation{ip}{IP}{Internet&#x00A0;Protocol}
-</pre>
- <!--l. 10106--><p class="nopar" > is essentially the same as
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-225">
- \newabbreviation{ip}{IP}
- {\glsxtrword{Internet}\glsxtrwordsep\glsxtrword{Protocol}}
-</pre>
- <!--l. 10111--><p class="nopar" > The &#8220;hyphen&#8221; styles, such as <a
-href="#abbrstyle.long-hyphen-short-hyphen"><span
-class="cmss-10">long-hyphen-short-hyphen</span></a><a
- id="dx1-71058"></a>, take advantage of this
- markup. If the inserted material (provided in the final argument of commands
- like <span
-class="cmtt-10">\gls</span><a
- id="dx1-71059"></a>) starts with a hyphen then <span
-class="cmtt-10">\glsxtrwordsep </span>is locally redefined to a
- hyphen. (The default value is a space). Note that this only applies to
- commands like <span
-class="cmtt-10">\gls </span>and not like <span
-class="cmtt-10">\glsxtrlong</span>. You can provide your own
- localised switch, if required. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-226">
- \newcommand{\hyplong}[2][]{%
- &#x00A0;{\def\glsxtrwordsep{-}\glsxtrlong[#1]{#2}}}
-</pre>
- <!--l. 10123--><p class="nopar" >
- </p><!--l. 10125--><p class="noindent" >This setting will also adjust the long plural. This attribute is only applicable to
- entries defined using <span
-class="cmtt-10">\newabbreviation </span>(or <span
-class="cmtt-10">\newacronym </span>if it&#8217;s using
- <span
-class="cmtt-10">\newabbreviation</span>.)
- </p><!--l. 10129--><p class="noindent" ><div class="important" title="Important Note"> This setting may result in the <span
-class="cmtt-10">\glsxtrword </span>and <span
-class="cmtt-10">\glsxtrwordsep </span>markup
- ending up in the <span
-class="cmss-10">sort</span><a
- id="dx1-71060"></a> field, depending on the style in use. </div>
- </p><!--l. 10133--><p class="noindent" >
- </p></dd><dt class="description">
-<a
- id="catattr.markshortwords"></a><span
-class="cmssbx-10">markshortwords</span><a
- id="dx1-71061"></a> </dt><dd
-class="description">This is similar to <a
-href="#catattr.markwords"><span
-class="cmss-10">markwords</span></a><a
- id="dx1-71062"></a> but applies to the short form. (Only
- useful for abbreviations that contain spaces.) This attribute is only applicable
- to entries defined using <span
-class="cmtt-10">\newabbreviation </span>(or <span
-class="cmtt-10">\newacronym </span>if it&#8217;s using
- <span
-class="cmtt-10">\newabbreviation</span>.)
- <!--l. 10141--><p class="noindent" >This setting will only adjust the short plural if the <span
-class="cmss-10">shortplural</span><a
- id="dx1-71063"></a> key isn&#8217;t used.
- This setting will take precedence over <a
-href="#catattr.insertdots"><span
-class="cmss-10">insertdots</span></a><a
- id="dx1-71064"></a>.
- </p><!--l. 10145--><p class="noindent" ><div class="important" title="Important Note"> This setting may result in the <span
-class="cmtt-10">\glsxtrword </span>and <span
-class="cmtt-10">\glsxtrwordsep </span>markup
- ending up in the <span
-class="cmss-10">sort</span><a
- id="dx1-71065"></a> field, depending on the style in use. </div>
- </p><!--l. 10149--><p class="noindent" >
- </p></dd><dt class="description">
-<a
- id="catattr.insertdots"></a><span
-class="cmssbx-10">insertdots</span><a
- id="dx1-71066"></a> </dt><dd
-class="description">If this attribute is set to &#8220;true&#8221; any entry defined using <span
-class="cmtt-10">\newabbreviation</span><a
- id="dx1-71067"></a>
- will automatically have full stops (periods) inserted after each letter. The entry
- will be defined with those dots present as though they had been present in the
- &#x27E8;<span
-class="cmti-10">short</span>&#x27E9; argument of <span
-class="cmtt-10">\newabbreviation </span>(rather than inserting them every time
- the entry is used). The short plural form defaults to the new dotted version of
- the original &#x27E8;<span
-class="cmti-10">short</span>&#x27E9; form with the plural suffix appended. <span
-class="cmti-10">This setting is</span>
- <span
-class="cmti-10">incompatible with </span><a
-href="#catattr.markshortwords"><span
-class="cmssi-10">markshortwords</span></a><a
- id="dx1-71068"></a><span
-class="cmti-10">. </span>This attribute is only applicable to
- entries defined using <span
-class="cmtt-10">\newabbreviation </span>(or <span
-class="cmtt-10">\newacronym </span>if it&#8217;s using
- <span
-class="cmtt-10">\newabbreviation</span>.)
- <!--l. 10163--><p class="noindent" ><div class="important" title="Important Note"> If you explicitly override the short plural using the <span
-class="cmss-10">shortplural</span><a
- id="dx1-71069"></a> key, you must
- explicitly insert the dots yourself (since there&#8217;s no way for the code to
- determine if the plural has a suffix that shouldn&#8217;t be followed by a dot).
- </div>
- </p><!--l. 10169--><p class="noindent" >
-
-
-
- </p><!--l. 10171--><p class="noindent" >This attribute is best used with the <a
-href="#catattr.discardperiod"><span
-class="cmss-10">discardperiod</span></a><a
- id="dx1-71070"></a> attribute set to &#8220;true&#8221;.
- </p></dd><dt class="description">
-<a
- id="catattr.aposplural"></a><span
-class="cmssbx-10">aposplural</span><a
- id="dx1-71071"></a> </dt><dd
-class="description">If this attribute is set to &#8220;true&#8221;, <span
-class="cmtt-10">\newabbreviation</span><a
- id="dx1-71072"></a> will insert an
- apostrophe (&#8217;) before the plural suffix for the <span
-class="cmti-10">short </span>plural form (unless
- explicitly overridden with the <span
-class="cmss-10">shortplural</span><a
- id="dx1-71073"></a> key). The long plural form is
- unaffected by this setting. This setting overrides <a
-href="#catattr.noshortplural"><span
-class="cmss-10">noshortplural</span></a><a
- id="dx1-71074"></a>. This
- attribute is only applicable to entries defined using <span
-class="cmtt-10">\newabbreviation </span>(or
- <span
-class="cmtt-10">\newacronym </span>if it&#8217;s using <span
-class="cmtt-10">\newabbreviation</span>.) Check with your supervisor,
- publisher or editor if you want to use this attribute as this usage is
- controversial.
- </dd><dt class="description">
-<a
- id="catattr.noshortplural"></a><span
-class="cmssbx-10">noshortplural</span><a
- id="dx1-71075"></a> </dt><dd
-class="description">If this attribute is set to &#8220;true&#8221;, <span
-class="cmtt-10">\newabbreviation</span><a
- id="dx1-71076"></a> won&#8217;t append
- the plural suffix for the short plural form. This means the <span
-class="cmss-10">short</span><a
- id="dx1-71077"></a> and
- <span
-class="cmss-10">shortplural</span><a
- id="dx1-71078"></a> values will be the same unless explicitly overridden. <span
-class="cmti-10">This setting</span>
- <span
-class="cmti-10">is incompatible with </span><a
-href="#catattr.aposplural"><span
-class="cmssi-10">aposplural</span></a><a
- id="dx1-71079"></a><span
-class="cmti-10">. </span>This attribute is only applicable to
- entries defined using <span
-class="cmtt-10">\newabbreviation </span>(or <span
-class="cmtt-10">\newacronym </span>if it&#8217;s using
- <span
-class="cmtt-10">\newabbreviation</span>.)
- </dd><dt class="description">
-<a
- id="catattr.headuc"></a><span
-class="cmssbx-10">headuc</span><a
- id="dx1-71080"></a> </dt><dd
-class="description">If this attribute is set to &#8220;true&#8221;, commands like <span
-class="cmtt-10">\glsfmtshort</span><a
- id="dx1-71081"></a> will use the
- upper case version in the page headers.
- </dd><dt class="description">
-<a
- id="catattr.tagging"></a><span
-class="cmssbx-10">tagging</span><a
- id="dx1-71082"></a> </dt><dd
-class="description">If this attribute is set to &#8220;true&#8221;, the tagging command defined by
- <span
-class="cmtt-10">\GlsXtrEnableInitialTagging</span><a
- id="dx1-71083"></a> will be activated to use <span
-class="cmtt-10">\glsxtrtagfont</span><a
- id="dx1-71084"></a> in
- the glossary (see <a
-href="#sec:tagging"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">4.1</span> </a><a
-href="#sec:tagging">Tagging Initials<!--tex4ht:ref: sec:tagging --></a>).
- </dd><dt class="description">
-<a
- id="catattr.entrycount"></a><span
-class="cmssbx-10">entrycount</span><a
- id="dx1-71085"></a> </dt><dd
-class="description">Unlike the above attributes, this attribute isn&#8217;t boolean but instead must
- be an integer value and is used in combination with <span
-class="cmtt-10">\glsenableentrycount</span><a
- id="dx1-71086"></a>
- (see <a
-href="#sec:entrycountmods"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.5</span> </a><a
-href="#sec:entrycountmods">Entry Counting Modifications<!--tex4ht:ref: sec:entrycountmods --></a>). Leave blank or
- undefined for categories that shouldn&#8217;t have this facility enabled. The value of
- this attribute is used by <span
-class="cmtt-10">\glsxtrifcounttrigger</span><a
- id="dx1-71087"></a> to determine how commands
- such as <span
-class="cmtt-10">\cgls</span><a
- id="dx1-71088"></a> should behave.
- <!--l. 10211--><p class="noindent" >With <span
-class="cmss-10">glossaries</span>, commands like <span
-class="cmtt-10">\cgls </span>use <span
-class="cmtt-10">\cglsformat </span>only if the previous
- usage count for that entry was equal to&#x00A0;1. With <span
-class="cmss-10">glossaries-extra </span>the test is now
- for entries that have the <a
-href="#catattr.entrycount"><span
-class="cmss-10">entrycount</span></a><a
- id="dx1-71089"></a> attribute set and where the previous
- usage count for that entry is less than or equal to the value of that
- attribute.
- </p></dd><dt class="description">
-<a
- id="catattr.linkcount"></a><span
-class="cmssbx-10">linkcount</span><a
- id="dx1-71090"></a> </dt><dd
-class="description">This attribute is set to <span
-class="cmtt-10">true </span>by <span
-class="cmtt-10">\GlsXtrEnableLinkCounting</span><a
- id="dx1-71091"></a> (see
- <a
-href="#sec:linkcount"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">8.2</span> </a><a
-href="#sec:linkcount">Link Counting<!--tex4ht:ref: sec:linkcount --></a>).
- </dd><dt class="description">
-<a
- id="catattr.linkcountmaster"></a><span
-class="cmssbx-10">linkcountmaster</span><a
- id="dx1-71092"></a> </dt><dd
-class="description">This attribute is set to the name of the master counter by
-
-
-
- <span
-class="cmtt-10">\GlsXtrEnableLinkCounting</span><a
- id="dx1-71093"></a> if the optional argument is provided (see
- <a
-href="#sec:linkcount"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">8.2</span> </a><a
-href="#sec:linkcount">Link Counting<!--tex4ht:ref: sec:linkcount --></a>).
- </dd><dt class="description">
-<a
- id="catattr.glossdesc"></a><span
-class="cmssbx-10">glossdesc</span><a
- id="dx1-71094"></a> </dt><dd
-class="description">The <span
-class="cmtt-10">\glossentrydesc</span><a
- id="dx1-71095"></a> command (used in the predefined glossary styles) is
- modified by <span
-class="cmss-10">glossaries-extra </span>to check for this attribute. The attribute may have
- one of the following values:
- <ul class="itemize1">
- <li class="itemize"><span
-class="cmtt-10">firstuc</span>: the first letter of the description will be converted to upper
- case (using <span
-class="cmtt-10">\Glsentrydesc</span><a
- id="dx1-71096"></a>).
- </li>
- <li class="itemize"><span
-class="cmtt-10">title</span>: the description will be used in the argument of the title
- casing command. If you have at least <span
-class="cmss-10">glossaries </span>v4.48, the title
- casing is indirectly performed by <span
-class="cmtt-10">\glscapitalisewords</span>, which
- defaults to <span
-class="cmtt-10">\capitalisewords</span><a
- id="dx1-71097"></a> (provided by <span
-class="cmss-10">mfirstuc</span><a
- id="dx1-71098"></a>). You can either
- redefine <span
-class="cmtt-10">\glscapitalisewords </span>if you want the change to also affect
- <span
-class="cmtt-10">\glsentrytitlecase</span><a
- id="dx1-71099"></a> or if you only want the change to apply to the
- attribute case-changing then redefine:
- <!--l. 10243--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-71100"></a> <span
-class="cmtt-10">\glsxtrfieldtitlecasecs{</span>&#x27E8;<span
-class="cmitt-10">phrase cs</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
- </p><!--l. 10245--><p class="noindent" >
- For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-227">
- \newcommand*{\glsxtrfieldtitlecasecs}[1]{\xcapitalisefmtwords*{#1}}
-</pre>
- <!--l. 10249--><p class="nopar" > (Note that the argument to <span
-class="cmtt-10">\glsxtrfieldtitlecasecs </span>will be a control
- sequence whose replacement text is the entry&#8217;s description, which is why
- <span
-class="cmtt-10">\xcapitalisefmtwords </span>is needed instead of <span
-class="cmtt-10">\capitalisefmtwords</span>.)
-</p>
- </li></ul>
- <!--l. 10256--><p class="noindent" >Any other values of this attribute are ignored. Remember that there are design
- limitations for both the first letter uppercasing and the title casing commands.
- See the <span
-class="cmss-10">mfirstuc</span><a
- id="dx1-71101"></a> user manual for further details.
- </p></dd><dt class="description">
-<a
- id="catattr.glossdescfont"></a><span
-class="cmssbx-10">glossdescfont</span><a
- id="dx1-71102"></a> </dt><dd
-class="description">(New to version 1.04) In addition to the above, the modified
- <span
-class="cmtt-10">\glossentrydesc</span><a
- id="dx1-71103"></a> command also checks this attribute. If set, it should be the
- name of a control sequence (without the leading backslash) that takes one
- argument. This control sequence will be applied to the description text. For
- example:
-
-
-
- <pre class="verbatim" id="verbatim-228">
- \glssetcategoryattribute{general}{glossdescfont}{emph}
-</pre>
- <!--l. 10269--><p class="nopar" >
- </p></dd><dt class="description">
-<a
- id="catattr.glossname"></a><span
-class="cmssbx-10">glossname</span><a
- id="dx1-71104"></a> </dt><dd
-class="description">As <a
-href="#catattr.glossdesc"><span
-class="cmss-10">glossdesc</span></a><a
- id="dx1-71105"></a> but applies to <span
-class="cmtt-10">\glossentryname</span><a
- id="dx1-71106"></a>. Additionally, if this
- attribute is set to &#8220;uc&#8221; the name is converted to all capitals.
- </dd><dt class="description">
-<a
- id="catattr.indexname"></a><span
-class="cmssbx-10">indexname</span><a
- id="dx1-71107"></a> </dt><dd
-class="description">If set, the <span
-class="cmtt-10">\glsxtrpostnamehook </span>hook used at the end of <span
-class="cmtt-10">\glossentryname</span><a
- id="dx1-71108"></a>
- will index the entry using <span
-class="cmtt-10">\index</span><a
- id="dx1-71109"></a>. See <a
-href="#sec:autoindex"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">9</span> </a><a
-href="#sec:autoindex">Auto-Indexing<!--tex4ht:ref: sec:autoindex --></a> for
- further details.
- </dd><dt class="description">
-<a
- id="catattr.glossnamefont"></a><span
-class="cmssbx-10">glossnamefont</span><a
- id="dx1-71110"></a> </dt><dd
-class="description">(New to version 1.04) In addition to the above, the modified
- <span
-class="cmtt-10">\glossentryname</span><a
- id="dx1-71111"></a> command also checks this attribute. If set, it should be the
- name of a control sequence (without the leading backslash) that takes one
- argument. This control sequence will be applied to the name text. For
- example:
-
-
-
- <pre class="verbatim" id="verbatim-229">
- \glssetcategoryattribute{general}{glossnamefont}{emph}
-</pre>
- <!--l. 10289--><p class="nopar" > Note that this overrides <span
-class="cmtt-10">\glsnamefont </span>which will only be used if this attribute
- hasn&#8217;t been set.
- </p><!--l. 10293--><p class="noindent" >Remember that glossary styles may additionally apply a font change,
- such as the list styles which put the name in the optional argument of
- <span
-class="cmtt-10">\item</span>.
- </p></dd><dt class="description">
-<a
- id="catattr.glosssymbolfont"></a><span
-class="cmssbx-10">glosssymbolfont</span><a
- id="dx1-71112"></a> </dt><dd
-class="description">(New to version 1.42.) This is similar to <a
-href="#catattr.glossnamefont"><span
-class="cmss-10">glossnamefont</span></a><a
- id="dx1-71113"></a> and
- <a
-href="#catattr.glossdescfont"><span
-class="cmss-10">glossdescfont</span></a><a
- id="dx1-71114"></a> but is used by <span
-class="cmtt-10">\glossentrysymbol</span><a
- id="dx1-71115"></a>.
- </dd><dt class="description">
-<a
- id="catattr.textformat"></a><span
-class="cmssbx-10">textformat</span><a
- id="dx1-71116"></a> </dt><dd
-class="description">(New to version 1.21.) Commands like <span
-class="cmtt-10">\gls </span>and <span
-class="cmtt-10">\glstext </span>have the link
- text encapsulated in the argument of <span
-class="cmtt-10">\glstextformat </span>by default. If this
- attribute is set, the control sequence given by the attribute value will be used
- instead. As with the above, the attribute value should be the name (without
- the leading backslash) of a command that takes a single argument (the link
- text). Remember that the abbreviation styles may apply an additional font
- change.
- </dd><dt class="description">
-<a
- id="catattr.hyperoutside"></a><span
-class="cmssbx-10">hyperoutside</span><a
- id="dx1-71117"></a> </dt><dd
-class="description">(New to v1.21.) The attribute value may be <span
-class="cmtt-10">false</span>, <span
-class="cmtt-10">true </span>or unset. If
- unset, <span
-class="cmtt-10">true </span>is assumed. This indicates the default setting of the <span
-class="cmss-10">hyperoutside</span><a
- id="dx1-71118"></a>
- key, described in <a
-href="#sec:wrglossary"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.2</span> </a><a
-href="#sec:wrglossary">Entry Indexing<!--tex4ht:ref: sec:wrglossary --></a>.
- </dd><dt class="description">
-<a
- id="catattr.dualindex"></a><span
-class="cmssbx-10">dualindex</span><a
- id="dx1-71119"></a> </dt><dd
-class="description">If set, whenever a glossary entry has information written to the external
- glossary file through commands like <span
-class="cmtt-10">\gls</span><a
- id="dx1-71120"></a> and <span
-class="cmtt-10">\glsadd</span><a
- id="dx1-71121"></a>, a&#x00A0;corresponding line
- will be written to the indexing file using <span
-class="cmtt-10">\index</span><a
- id="dx1-71122"></a>. See <a
-href="#sec:autoindex"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">9</span>
- </a><a
-href="#sec:autoindex">Auto-Indexing<!--tex4ht:ref: sec:autoindex --></a> for further details.
- </dd><dt class="description">
-<a
- id="catattr.targeturl"></a><span
-class="cmssbx-10">targeturl</span><a
- id="dx1-71123"></a> </dt><dd
-class="description">If set, the hyperlink generated by commands like <span
-class="cmtt-10">\gls </span>will be set to the
- URL provided by this attributes value. For example:
-
-
-
- <pre class="verbatim" id="verbatim-230">
- \glssetcategoryattribute{general}{targeturl}{master-doc.pdf}
-</pre>
- <!--l. 10327--><p class="nopar" > (See also the accompanying sample file <span
-class="cmtt-10">sample-external.tex</span>.) If the URL
- contains awkward characters (such as <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">%</span></span></span> or <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">~</span></span></span>) remember that the base <span
-class="cmss-10">glossaries</span>
- package provides commands like <span
-class="cmtt-10">\glspercentchar</span><a
- id="dx1-71124"></a> and <span
-class="cmtt-10">\glstildechar </span>that
- expand to literal characters.
- </p><!--l. 10335--><p class="noindent" >If you want to a named anchor within the target URL (notionally adding
- <span
-class="cmtt-10">#</span>&#x27E8;<span
-class="cmti-10">name</span>&#x27E9; to the URL), then you also need to set <a
-href="#catattr.targetname"><span
-class="cmss-10">targetname</span></a><a
- id="dx1-71125"></a> to the anchor &#x27E8;<span
-class="cmti-10">name</span>&#x27E9;.
- You may use <span
-class="cmtt-10">\glslabel </span>within &#x27E8;<span
-class="cmti-10">name</span>&#x27E9; which is set by commands like <span
-class="cmtt-10">\gls </span>to
- the entry&#8217;s label.
- </p><!--l. 10341--><p class="noindent" >All the predefined glossary styles start each entry listing with <span
-class="cmtt-10">\glstarget</span>
- which sets the anchor to <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glolinkprefix\glslabel</span></span></span>, so if you want
- entries to link to glossaries in the URL given by <a
-href="#catattr.targeturl"><span
-class="cmss-10">targeturl</span></a><a
- id="dx1-71126"></a>, you can just
- do:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-231">
- \glssetcategoryattribute{general}{targetname}{\glolinkprefix\glslabel}
-</pre>
- <!--l. 10348--><p class="nopar" > (If the target document changed <span
-class="cmtt-10">\glolinkprefix </span>then you will need to adjust
- the above as appropriate.)
- </p><!--l. 10352--><p class="noindent" >If the anchor is in the form &#x27E8;<span
-class="cmti-10">name1</span>&#x27E9;<span
-class="cmtt-10">.</span>&#x27E8;<span
-class="cmti-10">name2</span>&#x27E9; then use <a
-href="#catattr.targetname"><span
-class="cmss-10">targetname</span></a><a
- id="dx1-71127"></a> for the &#x27E8;<span
-class="cmti-10">name2</span>&#x27E9;
- part and <a
-href="#catattr.targetcategory"><span
-class="cmss-10">targetcategory</span></a><a
- id="dx1-71128"></a> for the &#x27E8;<span
-class="cmti-10">name1</span>&#x27E9; part.
- </p><!--l. 10356--><p class="noindent" >For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-232">
- \glssetcategoryattribute{general}{targeturl}{master-doc.pdf}
- \glssetcategoryattribute{general}{targetcategory}{page}
- \glssetcategoryattribute{general}{targetname}{7}
-</pre>
- <!--l. 10361--><p class="nopar" > will cause all link text for <span
-class="cmtt-10">general </span>entries to link to <span
-class="cmtt-10">master-doc.pdf#page.7</span>
- (page 7 of that PDF).
- </p><!--l. 10365--><p class="noindent" >If you want a mixture in your document of entries that link to an internal
- glossary and entries that link to an external URL then you can use
- the starred form of <span
-class="cmtt-10">\newignoredglossary</span><a
- id="dx1-71129"></a> for the external list. For
- example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-233">
- \newignoredglossary*{external}
- \glssetcategoryattribute{external}{targeturl}{master-doc.pdf}
- \glssetcategoryattribute{general}{targetname}{\glolinkprefix\glslabel}
- \newglossaryentry{sample}{name={sample},description={local&#x00A0;example}}
- \newglossaryentry{sample2}{name={sample2},
- &#x00A0;&#x00A0;type=external,
- &#x00A0;&#x00A0;category=external,
- &#x00A0;&#x00A0;description={external&#x00A0;example}}
-</pre>
- <!--l. 10381--><p class="nopar" >
- </p></dd><dt class="description">
-<a
- id="catattr.externallocation"></a><span
-class="cmssbx-10">externallocation</span><a
- id="dx1-71130"></a> </dt><dd
-class="description">The value should be the file name of the target document when
- manually indexing an external location (see <a
-href="#sec:wrglossary"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.2</span> </a><a
-href="#sec:wrglossary">Entry Indexing<!--tex4ht:ref: sec:wrglossary --></a>).
- In general, it&#8217;s better to use <a
- id="dx1-71131"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> v1.7+ which can handle multiple external
- sources and doesn&#8217;t require this attribute.
- </dd></dl>
-<!--l. 10391--><p class="indent" > If a term is defined using <span
-class="cmtt-10">\newabbreviation</span><a
- id="dx1-71132"></a> and accessibility support has been
-supplied via the <a
-href="#styopt.accsupp"><span
-class="cmss-10">accsupp</span></a><a
- id="dx1-71133"></a> package option then the following attributes are also
-available. If <span
-class="cmss-10">shortaccess</span><a
- id="dx1-71134"></a> isn&#8217;t set its value will be obtained from:
-</p><!--l. 10395--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-71135"></a> <span
-class="cmtt-10">\glsdefaultshortaccess{</span>&#x27E8;<span
-class="cmitt-10">short</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">long</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10397--><p class="noindent" >
-This is defined by <span
-class="cmss-10">glossaries-accsupp</span><a
- id="dx1-71136"></a> to just do &#x27E8;<span
-class="cmti-10">long</span>&#x27E9; but <span
-class="cmss-10">glossaries-extra</span><a
- id="dx1-71137"></a> redefines it to
-do &#x27E8;<span
-class="cmti-10">long</span>&#x27E9; (&#x27E8;<span
-class="cmti-10">short</span>&#x27E9;). The <a
-href="#catattr.accessinsertdots"><span
-class="cmss-10">accessinsertdots</span></a><a
- id="dx1-71138"></a>, <a
-href="#catattr.accessaposplural"><span
-class="cmss-10">accessaposplural</span></a><a
- id="dx1-71139"></a> and <a
-href="#catattr.accessnoshortplural"><span
-class="cmss-10">accessnoshortplural</span></a><a
- id="dx1-71140"></a>
-attributes below refer to the &#x27E8;<span
-class="cmti-10">short</span>&#x27E9; form that&#8217;s passed to this command.
-</p><!--l. 10405--><p class="indent" > The following attributes are only applicable to entries defined using
-<span
-class="cmtt-10">\newabbreviation </span>(or <span
-class="cmtt-10">\newacronym </span>if it&#8217;s using <span
-class="cmtt-10">\newabbreviation</span>). They have no
-effect if the <a
-href="#styopt.accsupp"><span
-class="cmss-10">accsupp</span></a><a
- id="dx1-71141"></a> package option hasn&#8217;t been used.
- </p><dl class="description"><dt class="description">
-<a
- id="catattr.accessinsertdots"></a><span
-class="cmssbx-10">accessinsertdots</span><a
- id="dx1-71142"></a> </dt><dd
-class="description">If this attribute is set to &#8220;true&#8221; and the <span
-class="cmss-10">glossaries-accsupp</span><a
- id="dx1-71143"></a>
- package has been loaded (with the <a
-href="#styopt.accsupp"><span
-class="cmss-10">accsupp</span></a><a
- id="dx1-71144"></a> option), then this behaves
- like <a
-href="#catattr.insertdots"><span
-class="cmss-10">insertdots</span></a><a
- id="dx1-71145"></a> but for the &#x27E8;<span
-class="cmti-10">short</span>&#x27E9; part used in the <span
-class="cmss-10">shortaccess</span><a
- id="dx1-71146"></a> field instead
- of the <span
-class="cmss-10">short</span><a
- id="dx1-71147"></a> field. This setting will be overridden by an explicit use of
- the <span
-class="cmss-10">shortaccess</span><a
- id="dx1-71148"></a> key in the optional argument of <span
-class="cmtt-10">\newabbreviation </span>(or
- <span
-class="cmtt-10">\newacronym</span>).
- </dd><dt class="description">
-<a
- id="catattr.accessaposplural"></a><span
-class="cmssbx-10">accessaposplural</span><a
- id="dx1-71149"></a> </dt><dd
-class="description">This boolean attribute overrides <a
-href="#catattr.aposplural"><span
-class="cmss-10">aposplural</span></a><a
- id="dx1-71150"></a> for
-
-
-
- the <span
-class="cmss-10">shortpluralaccess</span><a
- id="dx1-71151"></a> key. Has no effect if there&#8217;s no accessibility support
- or if the <span
-class="cmss-10">shortaccess</span><a
- id="dx1-71152"></a> key hasn&#8217;t been set or if the <span
-class="cmss-10">shortpluralaccess</span><a
- id="dx1-71153"></a> key
- is explicitly set. If the <a
-href="#catattr.aposplural"><span
-class="cmss-10">aposplural</span></a><a
- id="dx1-71154"></a> is set and this attribute isn&#8217;t set and
- the <span
-class="cmss-10">shortaccess</span><a
- id="dx1-71155"></a> key is set, then the <a
-href="#catattr.aposplural"><span
-class="cmss-10">aposplural</span></a><a
- id="dx1-71156"></a> setting governs the default
- <span
-class="cmss-10">shortpluralaccess</span><a
- id="dx1-71157"></a> setting. If you want <a
-href="#catattr.aposplural"><span
-class="cmss-10">aposplural</span></a><a
- id="dx1-71158"></a> but don&#8217;t want it applied to
- the accessibility support, set the <a
-href="#catattr.accessaposplural"><span
-class="cmss-10">accessaposplural</span></a><a
- id="dx1-71159"></a> attribute to &#8220;false&#8221;. This
- attribute is only applicable to entries defined using <span
-class="cmtt-10">\newabbreviation </span>(or
- <span
-class="cmtt-10">\newacronym </span>if it&#8217;s using <span
-class="cmtt-10">\newabbreviation</span>.)
- </dd><dt class="description">
-<a
- id="catattr.accessnoshortplural"></a><span
-class="cmssbx-10">accessnoshortplural</span><a
- id="dx1-71160"></a> </dt><dd
-class="description">
- This boolean attribute overrides <a
-href="#catattr.noshortplural"><span
-class="cmss-10">noshortplural</span></a><a
- id="dx1-71161"></a> for the <span
-class="cmss-10">shortpluralaccess</span><a
- id="dx1-71162"></a> key.
- The same conditions apply as for <a
-href="#catattr.accessaposplural"><span
-class="cmss-10">accessaposplural</span></a><a
- id="dx1-71163"></a>. This attribute is only
- applicable to entries defined using <span
-class="cmtt-10">\newabbreviation </span>(or <span
-class="cmtt-10">\newacronym </span>if
- it&#8217;s using <span
-class="cmtt-10">\newabbreviation</span>.)
- </dd><dt class="description">
-<a
- id="catattr.nameshortaccess"></a><span
-class="cmssbx-10">nameshortaccess</span><a
- id="dx1-71164"></a> </dt><dd
-class="description">If this attribute is set to &#8220;true&#8221;, the <span
-class="cmss-10">access</span><a
- id="dx1-71165"></a> field (used for
- the <span
-class="cmss-10">name</span><a
- id="dx1-71166"></a> field&#8217;s accessibility support) automatically assigned if it&#8217;s not
- provided.
- </dd><dt class="description">
-<a
- id="catattr.textshortaccess"></a><span
-class="cmssbx-10">textshortaccess</span><a
- id="dx1-71167"></a> </dt><dd
-class="description">Like <span
-class="cmss-10">nameshortaccess</span><a
- id="dx1-71168"></a> but applies to the <span
-class="cmss-10">textaccess</span><a
- id="dx1-71169"></a> field
- automatically assigned if it&#8217;s not provided.
- </dd><dt class="description">
-<a
- id="catattr.firstshortaccess"></a><span
-class="cmssbx-10">firstshortaccess</span><a
- id="dx1-71170"></a> </dt><dd
-class="description">Like <span
-class="cmss-10">nameshortaccess</span><a
- id="dx1-71171"></a> but applies to the <span
-class="cmss-10">firstaccess</span><a
- id="dx1-71172"></a> field
- automatically assigned if it&#8217;s not provided.
- </dd><dt class="description">
-<a
- id="catattr.combinedfirstsep"></a><span
-class="cmssbx-10">combinedfirstsep</span><a
- id="dx1-71173"></a> </dt><dd
-class="description">The separator to use for <span
-class="cmtt-10">\glscombinefirstsep</span><a
- id="dx1-71174"></a>.
- </dd><dt class="description">
-<a
- id="catattr.combinedfirstsepfirst"></a><span
-class="cmssbx-10">combinedfirstsepfirst</span><a
- id="dx1-71175"></a> </dt><dd
-class="description">The separator to use for <span
-class="cmtt-10">\glscombinedfirstsepfirst</span><a
- id="dx1-71176"></a>.
- </dd><dt class="description">
-<a
- id="catattr.combinedsepfirst"></a><span
-class="cmssbx-10">combinedsepfirst</span><a
- id="dx1-71177"></a> </dt><dd
-class="description">The separator to use for <span
-class="cmtt-10">\glscombinesepfirst</span><a
- id="dx1-71178"></a>.
- </dd><dt class="description">
-<a
- id="catattr.combinedsep"></a><span
-class="cmssbx-10">combinedsep</span><a
- id="dx1-71179"></a> </dt><dd
-class="description">The separator to use for <span
-class="cmtt-10">\glscombinedsep</span><a
- id="dx1-71180"></a>.
- </dd></dl>
-<!--l. 10467--><p class="indent" > An attribute can be set using:
-</p><!--l. 10468--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-71181"></a> <span
-class="cmtt-10">\glssetcategoryattribute{</span>&#x27E8;<span
-class="cmitt-10">category-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">attribute-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">value</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 10470--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">category-label</span>&#x27E9; is the category label, &#x27E8;<span
-class="cmti-10">attribute-label</span>&#x27E9; is the attribute label
-and &#x27E8;<span
-class="cmti-10">value</span>&#x27E9; is the new value for the attribute. <span
-class="cmti-10">This will be localised to the</span>
-
-
-
-<span
-class="cmti-10">current scope. </span>If you want a global definition use the following command
-instead.
-</p><!--l. 10477--><p class="indent" > If you want to apply the same attribute to multiple categories then use:
-</p><!--l. 10479--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-71182"></a> <span
-class="cmtt-10">\glssetcategoriesattribute{</span>&#x27E8;<span
-class="cmitt-10">category-label list</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">attribute-label</span>&#x27E9;<span
-class="cmtt-10">}</span>
-<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">value</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10481--><p class="noindent" >
-<span
-class="cmti-10">This has a global effect.</span>
-</p><!--l. 10484--><p class="indent" > If you also want to set multiple attributes to the same value, then you can
-use:
-</p><!--l. 10486--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-71183"></a> <span
-class="cmtt-10">\glssetcategoriesattributes{</span>&#x27E8;<span
-class="cmitt-10">category-label list</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">attribute-label</span>
-<span
-class="cmitt-10">list</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">value</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10488--><p class="noindent" >
-<span
-class="cmti-10">This has a global effect.</span>
-</p><!--l. 10491--><p class="indent" > For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-234">
-\newcommand{\latinname}[1]{\emph{#1}}
-\glssetcategoriesattributes{genus,species}{textformat,glossnamefont}{latinname}
-</pre>
-<!--l. 10495--><p class="nopar" >
-</p><!--l. 10497--><p class="indent" > There is a shortcut version to set the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-71184"></a> attribute to &#8220;true&#8221;:
-</p><!--l. 10499--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-71185"></a> <span
-class="cmtt-10">\glssetregularcategory{</span>&#x27E8;<span
-class="cmitt-10">category-label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10501--><p class="noindent" >
-This internally uses <span
-class="cmtt-10">\glssetcategoryattribute </span>so it has a local effect.
-</p><!--l. 10505--><p class="indent" > If you need to lookup the category label for a particular entry, you can use the
-shortcut command:
-</p><!--l. 10507--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-71186"></a> <span
-class="cmtt-10">\glssetattribute{</span>&#x27E8;<span
-class="cmitt-10">entry-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">attribute-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">value</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10509--><p class="noindent" >
-This uses <span
-class="cmtt-10">\glssetcategoryattribute </span>with <span
-class="cmtt-10">\glscategory </span>to set the attribute. Note
-that this will affect all other entries that share this entry&#8217;s category.
-</p><!--l. 10514--><p class="indent" > The above use local assignments so they can be placed inside a group to limit
-their definition. As from v1.47, the value can be unset using:
-</p><!--l. 10516--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-71187"></a> <span
-class="cmtt-10">\glsunsetcategoryattribute{</span>&#x27E8;<span
-class="cmitt-10">category-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">attribute-label</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 10518--><p class="noindent" >
-</p><!--l. 10520--><p class="indent" > You can fetch the value of an attribute for a particular category using:
-</p><!--l. 10522--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-71188"></a> <span
-class="cmtt-10">\glsgetcategoryattribute{</span>&#x27E8;<span
-class="cmitt-10">category-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">attribute-label</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 10524--><p class="noindent" >
-Again there is a shortcut if you need to lookup the category label for a given
-entry:
-</p><!--l. 10527--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-71189"></a> <span
-class="cmtt-10">\glsgetattribute{</span>&#x27E8;<span
-class="cmitt-10">entry-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">attribute-label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10529--><p class="noindent" >
-</p><!--l. 10531--><p class="indent" > You can test if an attribute has been assigned to a given category using:
-</p><!--l. 10533--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-71190"></a> <span
-class="cmtt-10">\glshascategoryattribute{</span>&#x27E8;<span
-class="cmitt-10">category-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">attribute-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>
-<span
-class="cmitt-10">code</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false code</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10536--><p class="noindent" >
-This uses <span
-class="cmss-10">etoolbox</span><a
- id="dx1-71191"></a>&#8217;s <span
-class="cmtt-10">\ifcsvoid </span>and does &#x27E8;<span
-class="cmti-10">true code</span>&#x27E9; if the attribute has been set and
-isn&#8217;t blank and isn&#8217;t <span
-class="cmtt-10">\relax</span>. The shortcut if you need to lookup the category label
-from an entry is:
-</p><!--l. 10541--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-71192"></a> <span
-class="cmtt-10">\glshasattribute{</span>&#x27E8;<span
-class="cmitt-10">entry-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">attribute-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true code</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>
-<span
-class="cmitt-10">code</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10544--><p class="noindent" >
-</p><!--l. 10546--><p class="indent" > You can test the value of an attribute for a particular category using:
-
-
-
-</p><!--l. 10548--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-71193"></a> <span
-class="cmtt-10">\glsifcategoryattribute{</span>&#x27E8;<span
-class="cmitt-10">category-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">attribute-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">value</span>&#x27E9;<span
-class="cmtt-10">}</span>
-<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">true-part</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false-part</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10550--><p class="noindent" >
-This tests if the attribute (given by &#x27E8;<span
-class="cmti-10">attribute-label</span>&#x27E9;) for the category (given by
-&#x27E8;<span
-class="cmti-10">category-label</span>&#x27E9;) is set and equal to &#x27E8;<span
-class="cmti-10">value</span>&#x27E9;. If true, &#x27E8;<span
-class="cmti-10">true-part</span>&#x27E9; is done. If the attribute
-isn&#8217;t set or is set but isn&#8217;t equal to &#x27E8;<span
-class="cmti-10">value</span>&#x27E9;, &#x27E8;<span
-class="cmti-10">false part</span>&#x27E9; is done.
-</p><!--l. 10557--><p class="indent" > For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-235">
-\glsifcategoryattribute{general}{nohyper}{true}{NO&#x00A0;HYPER}{HYPER}
-</pre>
-<!--l. 10560--><p class="nopar" > This does &#8220;NO HYPER&#8221; if the <span
-class="cmss-10">general</span><a
- id="dx1-71194"></a> category has the <a
-href="#catattr.nohyper"><span
-class="cmss-10">nohyper</span></a><a
- id="dx1-71195"></a> attribute set to
-<span
-class="cmtt-10">true </span>otherwise if does &#8220;HYPER&#8221;.
-</p><!--l. 10565--><p class="indent" > With boolean-style attributes like <a
-href="#catattr.nohyper"><span
-class="cmss-10">nohyper</span></a><a
- id="dx1-71196"></a>, make sure you always test for <span
-class="cmtt-10">true</span>
-not <span
-class="cmtt-10">false </span>in case the attribute hasn&#8217;t been set.
-</p><!--l. 10568--><p class="indent" > Again there&#8217;s a shortcut if you need to lookup the category label from a particular
-entry:
-</p><!--l. 10570--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-71197"></a> <span
-class="cmtt-10">\glsifattribute{</span>&#x27E8;<span
-class="cmitt-10">entry-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">attribute-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">value</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true-part</span>&#x27E9;<span
-class="cmtt-10">}</span>
-<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">false-part</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10572--><p class="noindent" >
-</p><!--l. 10574--><p class="indent" > There&#8217;s also a shortcut to determine if a particular category has the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-71198"></a>
-attribute set to &#8220;true&#8221;:
-</p><!--l. 10576--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-71199"></a> <span
-class="cmtt-10">\glsifregularcategory{</span>&#x27E8;<span
-class="cmitt-10">category-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true-part</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false-part</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 10578--><p class="noindent" >
-Alternatively, if you need to lookup the category for a particular entry:
-</p><!--l. 10581--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-71200"></a> <span
-class="cmtt-10">\glsifregular{</span>&#x27E8;<span
-class="cmitt-10">entry-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true-part</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false-part</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10583--><p class="noindent" >
-Note that if the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-71201"></a> attribute hasn&#8217;t be set, the above do &#x27E8;<span
-class="cmti-10">false-part</span>&#x27E9;. There
-are also reverse commands that test if the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-71202"></a> attribute has been set to
-&#8220;false&#8221;:
-</p><!--l. 10587--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-71203"></a> <span
-class="cmtt-10">\glsifnotregularcategory{</span>&#x27E8;<span
-class="cmitt-10">category-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true-part</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false-part</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 10589--><p class="noindent" >
-or for a particular entry:
-</p><!--l. 10591--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-71204"></a> <span
-class="cmtt-10">\glsifnotregular{</span>&#x27E8;<span
-class="cmitt-10">entry-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true-part</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false-part</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10593--><p class="noindent" >
-Again, if the <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-71205"></a> attribute hasn&#8217;t been set, the above do &#x27E8;<span
-class="cmti-10">false-part</span>&#x27E9;, so these
-reverse commands aren&#8217;t logically opposite in the strict sense.
-</p><!--l. 10598--><p class="indent" > You can iterate through all entries with a given category using:
-</p><!--l. 10600--><p class="indent" > <hr><div title="Definition"><span
-class="cmtt-10">\glsforeachincategory[</span>&#x27E8;<span
-class="cmitt-10">glossary-labels</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">category-label</span>&#x27E9;<span
-class="cmtt-10">} {</span>&#x27E8;<span
-class="cmitt-10">glossary-cs</span>&#x27E9;<span
-class="cmtt-10">}</span>
-<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">label-cs</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">body</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10601--><p class="noindent" >
-This iterates through all entries in the glossaries identified by the comma-separated
-list &#x27E8;<span
-class="cmti-10">glossary-labels</span>&#x27E9; that have the category given by &#x27E8;<span
-class="cmti-10">category-label</span>&#x27E9; and performs &#x27E8;<span
-class="cmti-10">body</span>&#x27E9;
-for each match. Within &#x27E8;<span
-class="cmti-10">body</span>&#x27E9;, you can use &#x27E8;<span
-class="cmti-10">glossary-cs</span>&#x27E9; and &#x27E8;<span
-class="cmti-10">label-cs</span>&#x27E9; (which much be
-control sequences) to access the current glossary and entry label. If &#x27E8;<span
-class="cmti-10">glossary-labels</span>&#x27E9; is
-omitted, all glossaries are assumed.
-</p><!--l. 10611--><p class="indent" > Similarly, you can iterate through all entries that have a category with a given
-attribute using:
-
-
-
-</p><!--l. 10613--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-71206"></a> <span
-class="cmtt-10">\glsforeachwithattribute[</span>&#x27E8;<span
-class="cmitt-10">glossary-labels</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">attribute-label</span>&#x27E9;<span
-class="cmtt-10">}</span>
-<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">attribute-value</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">glossary-cs</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label-cs</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">body</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10615--><p class="noindent" >
-This will do &#x27E8;<span
-class="cmti-10">body</span>&#x27E9; for each entry that has a category with the attribute &#x27E8;<span
-class="cmti-10">attribute-label</span>&#x27E9;
-set to &#x27E8;<span
-class="cmti-10">attribute-value</span>&#x27E9;. The remaining arguments are as the previous command.
-</p><!--l. 10620--><p class="indent" > You can change the category for a particular entry using the standard glossary
-field changing commands, such as <span
-class="cmtt-10">\glsfielddef</span><a
- id="dx1-71207"></a>. Alternatively, you can
-use
-</p><!--l. 10623--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-71208"></a> <span
-class="cmtt-10">\glsxtrsetcategory{</span>&#x27E8;<span
-class="cmitt-10">entry-labels</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">category-label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10625--><p class="noindent" >
-This will change the category to &#x27E8;<span
-class="cmti-10">category-label</span>&#x27E9; for each entry listed in the
-comma-separated list &#x27E8;<span
-class="cmti-10">entry-labels</span>&#x27E9;. This command uses <span
-class="cmtt-10">\glsfieldxdef</span><a
- id="dx1-71209"></a> so it will
-expand &#x27E8;<span
-class="cmti-10">category-label</span>&#x27E9; and make the change global.
-</p><!--l. 10631--><p class="indent" > You can also change the category for all entries with a glossary or glossaries
-using:
-</p><!--l. 10633--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-71210"></a> <span
-class="cmtt-10">\glsxtrsetcategoryforall{</span>&#x27E8;<span
-class="cmitt-10">glossary-labels</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">category-label</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 10635--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">glossary-labels</span>&#x27E9; is a comma-separated list of glossary labels.
-
-
-
-</p>
-<!--l. 10639--><p class="indent" > </div>
-</p><!--l. 10639--><p class="noindent" ><a
-href="#top">Top</a><div class="chapter"><h2 class="chapterHead">8. <a
- id="sec:countref"></a>Counting References</h2>
-</p><!--l. 10642--><p class="indent" > There are three basic ways of counting entry references:
- </p><ol class="enumerate1" >
- <li
- class="enumerate" id="x1-72002x1">Counting the total number of times <span
-class="cmtt-10">\glsunset </span>is used (<span
-class="cmtt-10">\glsreset </span>resets
- the count and is best avoided). This is provided by the base <span
-class="cmss-10">glossaries</span>
- package and is intended for documents where the term should be displayed
- differently if it&#8217;s only been used a certain number of times. The information
- has to be written to the <span
-class="cmtt-10">.aux </span>file so that it&#8217;s available on the next
- LaTeX&#x00A0;run.
- <!--l. 10652--><p class="noindent" >This method is extended by <span
-class="cmss-10">glossaries-extra </span>and is described in
- <a
-href="#sec:entrycount"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">8.1</span> </a><a
-href="#sec:entrycount">Entry Counting (First Use Flag)<!--tex4ht:ref: sec:entrycount --></a>.
- </p></li>
- <li
- class="enumerate" id="x1-72004x2">Counting the total number of records. This method is only available with
- <a
- id="dx1-72005"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> and is intended for documents where the term should be displayed
- differently if it&#8217;s only been recorded (indexed) a certain number of times.
- See <a
-href="#sec:recordcount"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">10.5</span> </a><a
-href="#sec:recordcount">Record Counting<!--tex4ht:ref: sec:recordcount --></a> for further details.
- </li>
- <li
- class="enumerate" id="x1-72007x3">Counting the number of times the <span
-class="cmtt-10">\gls</span>-like or <span
-class="cmtt-10">\glstext</span>-like
- commands are used. (That is, those commands that internally use
- <span
-class="cmtt-10">\@gls@link</span>.) Unlike the other two methods, this just provides a
- running total rather than the total from the previous LaTeX&#x00A0;run.
- This method is intended to make it more convenient to work with
- hooks like <span
-class="cmtt-10">\glslinkcheckfirsthyperhook</span>, <span
-class="cmtt-10">\glslinkpostsetkeys </span>or
- <span
-class="cmtt-10">\glslinkpresetkeys</span>. See <a
-href="#sec:linkcount"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">8.2</span> </a><a
-href="#sec:linkcount">Link Counting<!--tex4ht:ref: sec:linkcount --></a> for further
- details.</li></ol>
-<!--l. 10671--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">8.1 </span> <a
- id="sec:entrycount"></a>Entry Counting (First Use Flag)</h3>
-<!--l. 10674--><p class="noindent" >As mentioned in <a
-href="#sec:entrycountmods"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.5</span> </a><a
-href="#sec:entrycountmods">Entry Counting Modifications<!--tex4ht:ref: sec:entrycountmods --></a>, <span
-class="cmss-10">glossaries-extra</span>
-modifies the <span
-class="cmtt-10">\glsenableentrycount</span><a
- id="dx1-73001"></a> command to allow for the <a
-href="#catattr.entrycount"><span
-class="cmss-10">entrycount</span></a><a
- id="dx1-73002"></a>
-attribute. This means that you not only need to enable entry counting with
-<span
-class="cmtt-10">\glsenableentrycount</span><a
- id="dx1-73003"></a>, but you also need to set the appropriate attribute (see
-<a
-href="#sec:categories"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">7</span> </a><a
-href="#sec:categories">Categories<!--tex4ht:ref: sec:categories --></a>).
-</p><!--l. 10681--><p class="indent" > <div class="important" title="Important Note"> Remember that entry counting only counts the number of times an entry is used
-by commands that change the <a
- id="dx1-73004"></a><a
-href="#glo:firstuseflag">first use flag</a>. (That is, all those commands
-that mark the entry as having been used.) There are many commands that
-don&#8217;t modify this flag and they won&#8217;t contribute to the entry use count.
-</div>
-</p><!--l. 10687--><p class="noindent" >
-</p><!--l. 10689--><p class="indent" > With <span
-class="cmss-10">glossaries-extra</span>, you may use <span
-class="cmtt-10">\cgls</span><a
- id="dx1-73005"></a> instead of <span
-class="cmtt-10">\gls</span><a
- id="dx1-73006"></a> even if you haven&#8217;t enabled
-entry counting. You will only get a warning if you use <span
-class="cmtt-10">\glsenableentrycount</span>
-
-
-
-without setting the <a
-href="#catattr.entrycount"><span
-class="cmss-10">entrycount</span></a><a
- id="dx1-73007"></a> attribute. (With <span
-class="cmss-10">glossaries</span>, commands like <span
-class="cmtt-10">\cgls</span><a
- id="dx1-73008"></a> will
-generate a warning if <span
-class="cmtt-10">\glsenableentrycount </span>hasn&#8217;t been used.) The abbreviation
-shortcut <span
-class="cmtt-10">\ab</span><a
- id="dx1-73009"></a> uses <span
-class="cmtt-10">\cgls </span>(see <a
-href="#sec:abbrshortcuts"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">4.3</span> </a><a
-href="#sec:abbrshortcuts">Shortcut Commands<!--tex4ht:ref: sec:abbrshortcuts --></a>). The
-acronym shortcut <span
-class="cmtt-10">\ac</span><a
- id="dx1-73010"></a> uses <span
-class="cmtt-10">\cgls </span>if it&#8217;s been defined with <a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><span
-class="cmss-10">=ac</span><a
- id="dx1-73011"></a> (or
-<a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><span
-class="cmss-10">=all</span><a
- id="dx1-73012"></a>) but uses <span
-class="cmtt-10">\gls </span>if it&#8217;s been defined with <a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><span
-class="cmss-10">=acronyms</span><a
- id="dx1-73013"></a> (or
-<a
-href="#styopt.shortcuts"><span
-class="cmss-10">shortcuts</span></a><span
-class="cmss-10">=acro</span><a
- id="dx1-73014"></a>).
-</p><!--l. 10702--><p class="indent" > All upper case versions (not provided by <span
-class="cmss-10">glossaries</span>) are also available:
-</p><!--l. 10704--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-73015"></a> <span
-class="cmtt-10">\cGLS[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 10706--><p class="noindent" >
-and
-</p><!--l. 10708--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-73016"></a> <span
-class="cmtt-10">\cGLSpl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 10710--><p class="noindent" >
-These are analogous to <span
-class="cmtt-10">\cgls </span>and <span
-class="cmtt-10">\cglspl </span>but they use
-</p><!--l. 10713--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-73017"></a> <span
-class="cmtt-10">\cGLSformat{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10715--><p class="noindent" >
-and
-</p><!--l. 10717--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-73018"></a> <span
-class="cmtt-10">\cGLSplformat{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10719--><p class="noindent" >
-which convert the analogous <span
-class="cmtt-10">\cglsformat </span>and <span
-class="cmtt-10">\cglsplformat </span>to upper
-case.
-</p><!--l. 10723--><p class="indent" > Just using <span
-class="cmss-10">glossaries</span>:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-236">
-\documentclass{article}
-\usepackage{glossaries}
-\makeglossaries
-\glsenableentrycount
-\newacronym{html}{HTML}{hypertext&#x00A0;markup&#x00A0;language}
-\newacronym{xml}{XML}{extensible&#x00A0;markup&#x00A0;language}
-\begin{document}
-Used&#x00A0;once:&#x00A0;\cgls{html}.
-Used&#x00A0;twice:&#x00A0;\cgls{xml}&#x00A0;and&#x00A0;\cgls{xml}.
-\printglossaries
-\end{document}
-</pre>
-<!--l. 10745--><p class="nopar" >
-</p><!--l. 10747--><p class="indent" > If you switch to <span
-class="cmss-10">glossaries-extra </span>you must set the <a
-href="#catattr.entrycount"><span
-class="cmss-10">entrycount</span></a><a
- id="dx1-73019"></a> attribute:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-237">
-\documentclass{article}
-\usepackage{glossaries-extra}
-\makeglossaries
-\glsenableentrycount
-\glssetcategoryattribute{abbreviation}{entrycount}{1}
-\newabbreviation{html}{HTML}{hypertext&#x00A0;markup&#x00A0;language}
-\newabbreviation{xml}{XML}{extensible&#x00A0;markup&#x00A0;language}
-\begin{document}
-Used&#x00A0;once:&#x00A0;\cgls{html}.
-Used&#x00A0;twice:&#x00A0;\cgls{xml}&#x00A0;and&#x00A0;\cgls{xml}.
-\printglossaries
-\end{document}
-</pre>
-<!--l. 10772--><p class="nopar" >
-</p><!--l. 10774--><p class="indent" > When activated with <span
-class="cmtt-10">\glsenableentrycount</span>, commands such as <span
-class="cmtt-10">\cgls</span><a
- id="dx1-73020"></a> now
-use
-</p><!--l. 10776--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-73021"></a> <span
-class="cmtt-10">\glsxtrifcounttrigger{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">trigger code</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">normal code</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10779--><p class="noindent" >
-to determine if the entry trips the entry count trigger. The &#x27E8;<span
-class="cmti-10">trigger code</span>&#x27E9; uses
-commands like <span
-class="cmtt-10">\cglsformat </span>and unsets the <a
- id="dx1-73022"></a><a
-href="#glo:firstuseflag">first use flag</a>. The &#x27E8;<span
-class="cmti-10">normal code</span>&#x27E9; is the
-code that would ordinarily be performed by whatever the equivalent command is (for
-example, <span
-class="cmtt-10">\cgls </span>will use <span
-class="cmtt-10">\cglsformat </span>in &#x27E8;<span
-class="cmti-10">trigger code</span>&#x27E9; but the usual <span
-class="cmtt-10">\gls </span>behaviour in
-&#x27E8;<span
-class="cmti-10">normal code</span>&#x27E9;).
-</p><!--l. 10788--><p class="indent" > The default definition is:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-238">
-\newcommand*{\glsxtrifcounttrigger}[3]{%
-&#x00A0;\glshasattribute{#1}{entrycount}%
-&#x00A0;{%
-&#x00A0;&#x00A0;&#x00A0;\ifnum\glsentryprevcount{#1}&#x003E;\glsgetattribute{#1}{entrycount}\relax
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;#3%
-&#x00A0;&#x00A0;&#x00A0;\else
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;#2%
-&#x00A0;&#x00A0;&#x00A0;\fi
-&#x00A0;}%
-&#x00A0;{#3}%
+</pre><p>
+<li><span class="numitem">2.</span>if the element’s category is <span class="qt">“sample”</span> then use the <a id="wrglossary.9202"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a> field otherwise use the <a id="wrglossary.9203"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> field: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.9204"></a><a href="#glo:mglselementprehook"><code class="csfmt">\mglselementprehook</code></a>}{%
+ <a id="wrglossary.9205"></a><a href="#glo:glsifcategory"><code class="csfmt">\glsifcategory</code></a>{<a id="wrglossary.9206"></a><a href="#glo:mglscurrentlabel"><code class="csfmt">\mglscurrentlabel</code></a>}{sample}%
+ {<code class="cmd">\renewcommand</code>{<a id="wrglossary.9207"></a><a href="#glo:mglsfield"><code class="csfmt">\mglsfield</code></a>}{userii}}%
+ {<code class="cmd">\renewcommand</code>{<a id="wrglossary.9208"></a><a href="#glo:mglsfield"><code class="csfmt">\mglsfield</code></a>}{useri}}%
}
-</pre>
-<!--l. 10801--><p class="nopar" > This means that if an entry is assigned to a category that has the <a
-href="#catattr.entrycount"><span
-class="cmss-10">entrycount</span></a><a
- id="dx1-73023"></a>
-attribute then the &#x27E8;<span
-class="cmti-10">trigger code</span>&#x27E9; will be used if the previous count value (the number of
-times the entry was used on the last run) is greater than the value of the
-attribute.
-</p><!--l. 10808--><p class="indent" > For example, to trigger normal use if the previous count value is greater than
-four:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-239">
-\glssetcategoryattribute{abbreviation}{entrycount}{4}
-</pre>
-<!--l. 10812--><p class="nopar" >
-</p><!--l. 10814--><p class="indent" > There is a convenient command provided to enable entry counting, set the
-<a
-href="#catattr.entrycount"><span
-class="cmss-10">entrycount</span></a><a
- id="dx1-73024"></a> attribute and redefine <span
-class="cmtt-10">\gls</span><a
- id="dx1-73025"></a>, etc to use <span
-class="cmtt-10">\cgls</span><a
- id="dx1-73026"></a> etc:
-</p><!--l. 10817--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-73027"></a> <span
-class="cmtt-10">\GlsXtrEnableEntryCounting{</span>&#x27E8;<span
-class="cmitt-10">categories</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">value</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10819--><p class="noindent" >
-The first argument &#x27E8;<span
-class="cmti-10">categories</span>&#x27E9; is a comma-separated list of categories. For each
-category, the <a
-href="#catattr.entrycount"><span
-class="cmss-10">entrycount</span></a><a
- id="dx1-73028"></a> attribute is set to &#x27E8;<span
-class="cmti-10">value</span>&#x27E9;. In addition, this does:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-240">
-\renewcommand*{\gls}{\cgls}%
-\renewcommand*{\Gls}{\cGls}%
-\renewcommand*{\glspl}{\cglspl}%
-\renewcommand*{\Glspl}{\cGlspl}%
-\renewcommand*{\GLS}{\cGLS}%
-\renewcommand*{\GLSpl}{\cGLSpl}%
-</pre>
-<!--l. 10830--><p class="nopar" > This makes it easier to enable entry-counting on existing documents.
-</p><!--l. 10834--><p class="indent" > If you use <span
-class="cmtt-10">\GlsXtrEnableEntryCounting </span>more than once, subsequent uses will
-just set the <a
-href="#catattr.entrycount"><span
-class="cmss-10">entrycount</span></a><a
- id="dx1-73029"></a> attribute for each listed category.
-</p><!--l. 10838--><p class="indent" > The above example document can then become:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-241">
-\documentclass{article}
-\usepackage{glossaries-extra}
-\makeglossaries
-\GlsXtrEnableEntryCounting{abbreviation}{1}
-\newabbreviation{html}{HTML}{hypertext&#x00A0;markup&#x00A0;language}
-\newabbreviation{xml}{XML}{extensible&#x00A0;markup&#x00A0;language}
-\begin{document}
-Used&#x00A0;once:&#x00A0;\gls{html}.
-Used&#x00A0;twice:&#x00A0;\gls{xml}&#x00A0;and&#x00A0;\gls{xml}.
-\printglossaries
-\end{document}
-</pre>
-<!--l. 10860--><p class="nopar" >
-</p><!--l. 10862--><p class="indent" > The standard entry-counting function describe above counts the number of times
-an entry has been marked as used throughout the document. (The reset commands
-will reset the total back to zero.) If you prefer to count per sectional-unit, you can
-use
-</p><!--l. 10867--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-73030"></a> <span
-class="cmtt-10">\GlsXtrEnableEntryUnitCounting{</span>&#x27E8;<span
-class="cmitt-10">categories</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">value</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">counter-name</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 10869--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">categories</span>&#x27E9; is a comma-separated list of categories to which this feature should
-be applied, &#x27E8;<span
-class="cmti-10">value</span>&#x27E9; is the trigger value and &#x27E8;<span
-class="cmti-10">counter-name</span>&#x27E9; is the name of the counter
-used by the sectional unit.
-</p><!--l. 10875--><p class="indent" > <div class="important" title="Important Note"> Due to the asynchronous nature of TeX&#8217;s output routine, discrepancies will occur
-in page spanning paragraphs if you use the <span
-class="cmss-10">page</span><a
- id="dx1-73031"></a> counter. </div>
-</p><!--l. 10879--><p class="noindent" >
-</p><!--l. 10881--><p class="indent" > Note that you can&#8217;t use both the document-wide counting and the per-unit
-counting in the same document.
-</p><!--l. 10884--><p class="indent" > The counter value is used as part of a label, which means that <span
-class="cmtt-10">\the</span>&#x27E8;<span
-class="cmti-10">counter-name</span>&#x27E9;
-needs to be expandable. Since <span
-class="cmss-10">hyperref</span><a
- id="dx1-73032"></a> also has a similar requirement and provides
-<span
-class="cmtt-10">\theH</span>&#x27E8;<span
-class="cmti-10">counter-name</span>&#x27E9; as an expandable alternative, <span
-class="cmss-10">glossaries-extra </span>will use
-<span
-class="cmtt-10">\theH</span>&#x27E8;<span
-class="cmti-10">counter-name</span>&#x27E9; if it exists otherwise it will use <span
-class="cmtt-10">\the</span>&#x27E8;<span
-class="cmti-10">counter-name</span>&#x27E9;.
-</p><!--l. 10891--><p class="indent" > The per-unit counting function uses two attributes: <a
-href="#catattr.entrycount"><span
-class="cmss-10">entrycount</span></a><a
- id="dx1-73033"></a> (as before) and
-
-
-
-<a
-href="#catattr.unitcount"><span
-class="cmss-10">unitcount</span></a><a
- id="dx1-73034"></a> (the name of the counter).
-</p><!--l. 10894--><p class="indent" > Both the original document-wide counting mechanism and the per-unit counting
-mechanism provide a command that can be used to access the current count value for
-this run:
-</p><!--l. 10897--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-73035"></a> <span
-class="cmtt-10">\glsentrycurrcount{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10899--><p class="noindent" >
-and the final value from the previous run:
-</p><!--l. 10901--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-73036"></a> <span
-class="cmtt-10">\glsentryprevcount{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10903--><p class="noindent" >
-In the case of the per-unit counting, this is the final value <span
-class="cmti-10">for the current unit</span>. In
-both commands &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; is the entry&#8217;s label.
-</p><!--l. 10908--><p class="indent" > The per-unit counting mechanism additionally provides:
-</p><!--l. 10909--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-73037"></a> <span
-class="cmtt-10">\glsentryprevtotalcount{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10911--><p class="noindent" >
-which gives the sum of all the per-unit totals from the previous run for the entry
-given by &#x27E8;<span
-class="cmti-10">label</span>&#x27E9;, and
-</p><!--l. 10914--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-73038"></a> <span
-class="cmtt-10">\glsentryprevmaxcount{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 10916--><p class="noindent" >
-which gives the maximum per-unit total from the previous run.
-</p><!--l. 10919--><p class="indent" > The above two commands are unavailable for the document-wide counting.
-</p><!--l. 10921--><p class="indent" > Example of per-unit counting, where the unit is the chapter:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-242">
-\documentclass{report}
-\usepackage{glossaries-extra}
-\GlsXtrEnableEntryUnitCounting{abbreviation}{2}{chapter}
-\makeglossaries
-\newabbreviation{html}{HTML}{hypertext&#x00A0;markup&#x00A0;language}
-\newabbreviation{css}{CSS}{cascading&#x00A0;style&#x00A0;sheet}
-\newglossaryentry{sample}{name={sample},description={sample}}
-\begin{document}
-\chapter{Sample}
-Used&#x00A0;once:&#x00A0;\gls{html}.
-Used&#x00A0;three&#x00A0;times:&#x00A0;\gls{css}&#x00A0;and&#x00A0;\gls{css}&#x00A0;and&#x00A0;\gls{css}.
-Used&#x00A0;once:&#x00A0;\gls{sample}.
-\chapter{Another&#x00A0;Sample}
-Used&#x00A0;once:&#x00A0;\gls{css}.
-Used&#x00A0;twice:&#x00A0;\gls{html}&#x00A0;and&#x00A0;\gls{html}.
-\printglossaries
-\end{document}
-</pre>
-<!--l. 10952--><p class="nopar" > In this document, the <span
-class="cmtt-10">css </span>entry is used three times in the first chapter. This is
-more than the trigger value of 2, so <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls{css}</span></span></span> is expanded on <a
- id="dx1-73039"></a><a
-href="#glo:firstuse">first use</a>
-with the short form used on subsequent use, and the <span
-class="cmtt-10">css </span>entries in that
-chapter are added to the glossary. In the second chapter, the <span
-class="cmtt-10">css </span>entry is
-only used once, which trips the suppression trigger, so in that chapter, the
-long form is used and <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls{css}</span></span></span> doesn&#8217;t get a line added to the glossary
-file.
-</p><!--l. 10963--><p class="indent" > The <span
-class="cmtt-10">html </span>is used a total of three times, but the expansion and indexing
-suppression trigger is tripped in both chapters because the per-unit total (1 for the
-first chapter and 2 for the second chapter) is less than or equal to the trigger
-value.
-</p><!--l. 10969--><p class="indent" > The <span
-class="cmtt-10">sample </span>entry has only been used once, but it doesn&#8217;t trip the indexing
-suppression because it&#8217;s in the <span
-class="cmss-10">general</span><a
- id="dx1-73040"></a> category, which hasn&#8217;t been listed in
-<span
-class="cmtt-10">\GlsXtrEnableEntryUnitCounting</span>.
-
-
-
-</p><!--l. 10974--><p class="indent" > The per-unit entry counting can be used for other purposes. In the following
-example document the trigger value is set to zero, which means the index suppression
-won&#8217;t be triggered, but the unit entry count is used to automatically suppress the
-hyperlink for commands like <span
-class="cmtt-10">\gls</span><a
- id="dx1-73041"></a> by modifying the hook
-</p><!--l. 10980--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-73042"></a> <span
-class="cmtt-10">\glslinkcheckfirsthyperhook </span></div><hr>
-</p><!--l. 10982--><p class="noindent" >
-which is used at the end of the macro the determines whether or not to suppress the
-hyperlink.
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-243">
-\documentclass{article}
-\usepackage[colorlinks]{hyperref}
-\usepackage{glossaries-extra}
-\makeglossaries
-\GlsXtrEnableEntryUnitCounting{general}{0}{page}
-\newglossaryentry{sample}{name={sample},description={an&#x00A0;example}}
-\renewcommand*{\glslinkcheckfirsthyperhook}{%
-&#x00A0;&#x00A0;\ifnum\glsentrycurrcount\glslabel&#x003E;0
-&#x00A0;&#x00A0;&#x00A0;\setkeys{glslink}{hyper=false}%
-&#x00A0;&#x00A0;\fi
+</pre><p>
+<li><span class="numitem">3.</span>if either the multi-entry’s category or the element’s category has the custom attribute <span class="qt">“mglsfield”</span> set then use it otherwise use the <a id="wrglossary.9209"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> field: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.9210"></a><a href="#glo:mglselementprehook"><code class="csfmt">\mglselementprehook</code></a>}{%
+ <a id="wrglossary.9211"></a><a href="#glo:glshascategoryattribute"><code class="csfmt">\glshascategoryattribute</code></a>{<a id="wrglossary.9212"></a><a href="#glo:mglscurrentcategory"><code class="csfmt">\mglscurrentcategory</code></a>}{mglsfield}%
+ {<code class="cmd">\renewcommand</code>{<a id="wrglossary.9213"></a><a href="#glo:mglsfield"><code class="csfmt">\mglsfield</code></a>}{<a id="wrglossary.9214"></a><a href="#glo:glsgetcategoryattribute"><code class="csfmt">\glsgetcategoryattribute</code></a>{<a id="wrglossary.9215"></a><a href="#glo:mglscurrentcategory"><code class="csfmt">\mglscurrentcategory</code></a>}{mglsfield}}}%
+ {%
+ <a id="wrglossary.9216"></a><a href="#glo:glshasattribute"><code class="csfmt">\glshasattribute</code></a>{<a id="wrglossary.9217"></a><a href="#glo:mglscurrentlabel"><code class="csfmt">\mglscurrentlabel</code></a>}{mglsfield}%
+ {<code class="cmd">\renewcommand</code>{<a id="wrglossary.9218"></a><a href="#glo:mglsfield"><code class="csfmt">\mglsfield</code></a>}{<a id="wrglossary.9219"></a><a href="#glo:glsgetattribute"><code class="csfmt">\glsgetattribute</code></a>{<a id="wrglossary.9220"></a><a href="#glo:mglscurrentlabel"><code class="csfmt">\mglscurrentlabel</code></a>}{mglsfield}}}%
+ {<code class="cmd">\renewcommand</code>{<a id="wrglossary.9221"></a><a href="#glo:mglsfield"><code class="csfmt">\mglsfield</code></a>}{useri}}%
+ }%
}
-\begin{document}
-A&#x00A0;\gls{sample}&#x00A0;entry.
-Next&#x00A0;use:&#x00A0;\gls{sample}.
-\newpage
-Next&#x00A0;page:&#x00A0;\gls{sample}.
-Again:&#x00A0;\gls{sample}.
-\printglossaries
-\end{document}
-</pre>
-<!--l. 11017--><p class="nopar" > This only produces a hyperlink for the first instance of <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls{sample}</span></span></span> on each
-page.
-</p><!--l. 11021--><p class="indent" > The earlier warning about using the <span
-class="cmss-10">page</span><a
- id="dx1-73043"></a> counter still applies. If the
-first instance of <span
-class="cmtt-10">\gls </span>occurs at the top of the page within a paragraph that
-started on the previous page, then the count will continue from the previous
-page.
-</p><!--l. 11026--><p class="noindent" >
-</p>
-<!--l. 11026--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">8.2 </span> <a
- id="sec:linkcount"></a>Link Counting</h3>
-<!--l. 11029--><p class="noindent" >As from version 1.26, an alternative method of entry counting is to count the number
-
-
-
-of times the <span
-class="cmtt-10">\gls</span>-like or <span
-class="cmtt-10">\glstext</span>-like commands are used. (The &#8220;link&#8221; in this
-method&#8217;s name refers to the use of the internal command <span
-class="cmtt-10">\@gls@link </span>not to
-<span
-class="cmtt-10">\hyperlink </span>although <span
-class="cmtt-10">\@gls@link </span>may use <span
-class="cmtt-10">\hyperlink </span>when displaying the
-<a
- id="dx1-74001"></a><a
-href="#glo:linktext">link-text</a>.)
-</p><!--l. 11036--><p class="indent" > To enable link counting use the preamble-only command:
-</p><!--l. 11037--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-74002"></a> <span
-class="cmtt-10">\GlsXtrEnableLinkCounting[</span>&#x27E8;<span
-class="cmitt-10">master counter</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">categories</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11039--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">categories</span>&#x27E9; is a list of category labels. The optional argument &#x27E8;<span
-class="cmti-10">master</span>
-<span
-class="cmti-10">counter</span>&#x27E9; may be used to identify a master counter (which must be defined). If
-present, the associated link counter will be reset when the master counter is
-incremented. This command automatically sets the <a
-href="#catattr.linkcount"><span
-class="cmss-10">linkcount</span></a><a
- id="dx1-74003"></a> attribute for the given
-categories. If the optional argument is present, it also sets the <a
-href="#catattr.linkcountmaster"><span
-class="cmss-10">linkcountmaster</span></a><a
- id="dx1-74004"></a>
-attribute.
-</p><!--l. 11048--><p class="indent" > When enabled, commands like <span
-class="cmtt-10">\gls </span>and <span
-class="cmtt-10">\glstext </span>increment the associated
-counter using
-</p><!--l. 11050--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-74005"></a> <span
-class="cmtt-10">\glsxtrinclinkcounter{</span>&#x27E8;<span
-class="cmitt-10">counter name</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11052--><p class="noindent" >
-This just does <span
-class="cmtt-10">\stepcounter{</span>&#x27E8;<span
-class="cmitt-10">counter name</span>&#x27E9;<span
-class="cmtt-10">} </span>by default but if you need
-<span
-class="cmtt-10">\refstepcounter </span>instead, just redefine this command:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-244">
-\renewcommand*{\glsxtrinclinkcounter}[1]{\refstepcounter{#1}}
-</pre>
-<!--l. 11058--><p class="nopar" >
-</p><!--l. 11060--><p class="indent" > You can access the internal count register using
-</p><!--l. 11061--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-74006"></a> <span
-class="cmtt-10">\GlsXtrLinkCounterValue{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11063--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; is the entry&#8217;s label. This will expand to 0 if the counter hasn&#8217;t been
-defined.
-</p><!--l. 11067--><p class="indent" > It&#8217;s also possible to access the display value (<span
-class="cmtt-10">\the</span>&#x27E8;<span
-class="cmti-10">counter</span>&#x27E9;) using
-</p><!--l. 11069--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-74007"></a> <span
-class="cmtt-10">\GlsXtrTheLinkCounter{</span>&#x27E8;<span
-class="cmitt-10">counter</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11071--><p class="noindent" >
-(This will expand to 0 if the counter hasn&#8217;t been defined.)
-</p><!--l. 11074--><p class="indent" > <div class="important" title="Important Note"> In order to conserve resources, the counter is only defined when it first
-needs to be incremented so terms that have been defined but haven&#8217;t been
-used in the document won&#8217;t have the associated count register allocated.
-</div>
-</p><!--l. 11079--><p class="noindent" >
-</p><!--l. 11081--><p class="indent" > You can test if the counter has been defined using:
-</p><!--l. 11082--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-74008"></a> <span
-class="cmtt-10">\GlsXtrIfLinkCounterDef{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11084--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; is the entry&#8217;s label.
-</p><!--l. 11087--><p class="indent" > The counter name can be obtained using
-</p><!--l. 11088--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-74009"></a> <span
-class="cmtt-10">\GlsXtrLinkCounterName{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11090--><p class="noindent" >
-This simply expands to the counter name associated with the entry given by &#x27E8;<span
-class="cmti-10">label</span>&#x27E9;
-without any check for existence. For example, to change the display command
-(<span
-class="cmtt-10">\the</span>&#x27E8;<span
-class="cmti-10">counter</span>&#x27E9;) using <span
-class="cmss-10">etoolbox</span><a
- id="dx1-74010"></a>:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-245">
-\csdef{the\GlsXtrLinkCounterName{duck}}{\Roman{\GlsXtrLinkCounterName{duck}}}
-</pre>
-<!--l. 11097--><p class="nopar" > This is useful if you just want to change the display for specific entries but isn&#8217;t
-convenient if you want to change the display for all entries. Instead, it&#8217;s simpler to
-redefine <span
-class="cmtt-10">\GlsXtrTheLinkCounter</span>. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-246">
-\renewcommand*{\GlsXtrTheLinkCounter}[1]{%
-&#x00A0;\GlsXtrIfLinkCounterDef{#1}%
-&#x00A0;{\Roman{\GlsXtrLinkCounterName{#1}}}%
-&#x00A0;{0}%
+</pre>
+</ol>
+<p>
+
+</section><!-- end of section sec:mglsotherfields -->
+
+<section id="sec:mpgls"><!-- start of section sec:mpgls --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->7.11.4. Support for <span class="styfmt">glossaries-prefix</span> (<code class="csfmt">\pgls</code>)<div class="labellink"><a href="#sec:mpgls">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+If you load the <a id="wrglossary.9222"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a> package (either after <a id="wrglossary.9223"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>) or with the <a id="wrglossary.9224"></a><a href="#glo:opt.prefix"><span class="styoptfmt">prefix</span></a> package option, then the following commands will use one of the <a id="wrglossary.9225"></a><a href="#glo:pgls"><code class="csfmt">\pgls</code></a>-like commands provided by that package. (See the <a id="wrglossary.9226"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> user manual for further details.)<p>
+If the <a id="wrglossary.9227"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a> package hasn’t been loaded then <a id="wrglossary.9228"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> (or analogous case-changing variant) will be used instead and a warning is issued with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9229"></a><code class="code"><dfn id="glo:mpglsWarning"><code class="csfmt">\mpglsWarning</code></dfn></code></div><!-- end of pinnedbox -->
+ This may be redefined to do nothing to remove the warning.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9230"></a><code class="code"><dfn id="glo:mpgls"><code class="csfmt">\mpgls</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9231"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9232"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9233"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Uses <a id="wrglossary.9234"></a><a href="#glo:pgls"><code class="csfmt">\pgls</code></a> for the first element and <a id="wrglossary.9235"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> for the remaining elements.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9236"></a><code class="code"><dfn id="glo:mpglspl"><code class="csfmt">\mpglspl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9237"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9238"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9239"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Uses <a id="wrglossary.9240"></a><a href="#glo:pglspl"><code class="csfmt">\pglspl</code></a> for the first element and <a id="wrglossary.9241"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> for the remaining elements.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9242"></a><code class="code"><dfn id="glo:mpglsmainpl"><code class="csfmt">\mpglsmainpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9243"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9244"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9245"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Only uses the plural form for the main element. The first element uses the prefixing command (<a id="wrglossary.9246"></a><a href="#glo:pgls"><code class="csfmt">\pgls</code></a> or <a id="wrglossary.9247"></a><a href="#glo:pglspl"><code class="csfmt">\pglspl</code></a>, depending on whether the first element is the main element).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9248"></a><code class="code"><dfn id="glo:Mpgls"><code class="csfmt">\Mpgls</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9249"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9250"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9251"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Uses <a id="wrglossary.9252"></a><a href="#glo:Pgls"><code class="csfmt">\Pgls</code></a> for the first element and <a id="wrglossary.9253"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> for the remaining elements.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9254"></a><code class="code"><dfn id="glo:Mpglsmainpl"><code class="csfmt">\Mpglsmainpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9255"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9256"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9257"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Only uses the plural form for the main element. The first element uses the <a id="wrglossary.9258"></a><a href="#glo:idx.sentencecase">sentence case</a> prefixing command (<a id="wrglossary.9259"></a><a href="#glo:Pgls"><code class="csfmt">\Pgls</code></a> or <a id="wrglossary.9260"></a><a href="#glo:Pglspl"><code class="csfmt">\Pglspl</code></a>, depending on whether the first element is the main element).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9261"></a><code class="code"><dfn id="glo:MPGls"><code class="csfmt">\MPGls</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9262"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9263"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9264"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Uses <a id="wrglossary.9265"></a><a href="#glo:Pgls"><code class="csfmt">\Pgls</code></a> for the first element and <a id="wrglossary.9266"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> for the remaining elements.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9267"></a><code class="code"><dfn id="glo:MPGlspl"><code class="csfmt">\MPGlspl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9268"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9269"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9270"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Uses <a id="wrglossary.9271"></a><a href="#glo:Pglspl"><code class="csfmt">\Pglspl</code></a> for the first element and <a id="wrglossary.9272"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a> for the remaining elements.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9273"></a><code class="code"><dfn id="glo:MPGlsmainpl"><code class="csfmt">\MPGlsmainpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9274"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9275"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9276"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Only uses the plural form for the main element. The first element uses the prefixing command (<a id="wrglossary.9277"></a><a href="#glo:Pgls"><code class="csfmt">\Pgls</code></a> or <a id="wrglossary.9278"></a><a href="#glo:Pglspl"><code class="csfmt">\Pglspl</code></a>, depending on whether the first element is the main element). All elements are use <a id="wrglossary.9279"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9280"></a><code class="code"><dfn id="glo:MPGLS"><code class="csfmt">\MPGLS</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9281"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9282"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9283"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Uses <a id="wrglossary.9284"></a><a href="#glo:PGLS"><code class="csfmt">\PGLS</code></a> for the first element and <a id="wrglossary.9285"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a> for the remaining elements.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9286"></a><code class="code"><dfn id="glo:MPGLSpl"><code class="csfmt">\MPGLSpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9287"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9288"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9289"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Uses <a id="wrglossary.9290"></a><a href="#glo:PGLSpl"><code class="csfmt">\PGLSpl</code></a> for the first element and <a id="wrglossary.9291"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a> for the remaining elements.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9292"></a><code class="code"><dfn id="glo:MPGLSmainpl"><code class="csfmt">\MPGLSmainpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.9293"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.9294"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.9295"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Only uses the plural form for the main element. All elements are converted to <a id="wrglossary.9296"></a><a href="#glo:idx.allcaps">all caps</a>. The first element uses the prefixing command (<a id="wrglossary.9297"></a><a href="#glo:PGLS"><code class="csfmt">\PGLS</code></a> or <a id="wrglossary.9298"></a><a href="#glo:PGLSpl"><code class="csfmt">\PGLSpl</code></a>, depending on whether the first element is the main element).<p>
+
+</section><!-- end of section sec:mpgls -->
+
+<section id="sec:msee"><!-- start of section sec:msee --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->7.12. Cross-References<div class="labellink"><a href="#sec:msee">[link]</a></div></h2><!-- end of section header -->
+<p>
+Multi-entry labels may be used in the cross-referencing keys <a id="wrglossary.9299"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> and <a id="wrglossary.9300"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a>. The formatting command will use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9301"></a><code class="code"><dfn id="glo:mglsseefirstitem"><code class="csfmt">\mglsseefirstitem</code></dfn>{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ for the first item in the list (if it’s a multi-entry) and <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9302"></a><code class="code"><dfn id="glo:mglsseeitem"><code class="csfmt">\mglsseeitem</code></dfn>{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ for any subsequent items that are multi-entries. The default definition of <a id="wrglossary.9303"></a><a href="#glo:mglsseeitem"><code class="csfmt">\mglsseeitem</code></a> is: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.9304"></a><a href="#glo:mglsseeitem"><code class="csfmt">\mglsseeitem</code></a>}[1]{%
+ <a id="wrglossary.9305"></a><a href="#glo:mglsname"><code class="csfmt">\mglsname</code></a>[<a id="wrglossary.9306"></a><a href="#glo:opt.mglsopt.all"><span class="csoptfmt">all</span></a><span class="optfmt">=noindex</span>,<a id="wrglossary.9307"></a><a href="#glo:opt.mglsopt.setup"><span class="csoptfmt">setup</span></a><span class="optfmt">={hyper=allmain}</span>]{#1}%
+}
+</pre> This switches off indexing, sets the hyperlink to encompass the entire multi-entry content and uses the <a id="wrglossary.9308"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field. The default definition of <a id="wrglossary.9309"></a><a href="#glo:mglsseefirstitem"><code class="csfmt">\mglsseefirstitem</code></a> is simply <a id="wrglossary.9310"></a><a href="#glo:mglsseeitem"><code class="csfmt">\mglsseeitem</code></a>.<p>
+For example, to use the <a id="wrglossary.9311"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> or <a id="wrglossary.9312"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> fields: <pre class="compactcodebox"><code class="cmd">\renewcommand</code>*{<a id="wrglossary.9313"></a><a href="#glo:mglsseeitem"><code class="csfmt">\mglsseeitem</code></a>}[1]{%
+ <a id="wrglossary.9314"></a><a href="#glo:mglsshort"><code class="csfmt">\mglsshort</code></a>[<a id="wrglossary.9315"></a><a href="#glo:opt.mglsopt.all"><span class="csoptfmt">all</span></a><span class="optfmt">=noindex</span>,<a id="wrglossary.9316"></a><a href="#glo:opt.mglsopt.setup"><span class="csoptfmt">setup</span></a><span class="optfmt">={hyper=allmain}</span>]{#1}%
+}
+</pre><p>
+A multi-entry label may also be used in the <a id="wrglossary.9317"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> key. The hyperlink target will be the target for the main entry. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.9318"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a>{cbot}{clostridium,botulinum}
+<a id="wrglossary.9319"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{botox}{<a id="wrglossary.9320"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={botox}</span>,<a id="wrglossary.9321"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,<a id="wrglossary.9322"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a><span class="optfmt">={cbot}</span>}
+</pre> In this case <code class="code"><a id="wrglossary.9323"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{botox}</code> will hyperlink to the <code class="code">botulinum</code> target.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Any multi-entries used in the cross-referencing keys must be defined before the glossary is displayed. There is some support for <a id="wrglossary.9324"></a><a href="#glo:opt.docdef"><span class="styoptfmt">docdef</span></a><span class="optfmt">=true</span> but not for the other <a id="wrglossary.9325"></a><a href="#glo:opt.docdef"><span class="styoptfmt">docdef</span></a> settings. </div><!-- end of important -->
+<p>
+
+</section><!-- end of section sec:msee -->
+
+<section id="sec:multiextras"><!-- start of section sec:multiextras --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->7.13. Additional Commands<div class="labellink"><a href="#sec:multiextras">[link]</a></div></h2><!-- end of section header -->
+<p>
+You can test if a label represents a multi-entry using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9326"></a><code class="code"><dfn id="glo:glsxtrifmulti"><code class="csfmt">\glsxtrifmulti</code></dfn>{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does <span class="meta">〈<em class="metainner">true</em>〉</span> if a multi-entry has been defined with the label <span class="meta">〈<em class="metainner">multi-label</em>〉</span> otherwise it does <span class="meta">〈<em class="metainner">false</em>〉</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9327"></a><code class="code"><dfn id="glo:glsxtrmultimain"><code class="csfmt">\glsxtrmultimain</code></dfn>{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Expands to the main entry label for the multi-entry identified by <span class="meta">〈<em class="metainner">multi-label</em>〉</span> or nothing if not defined.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9328"></a><code class="code"><dfn id="glo:glsxtrmultilist"><code class="csfmt">\glsxtrmultilist</code></dfn>{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Expands to the list of element labels for the multi-entry identified by <span class="meta">〈<em class="metainner">multi-label</em>〉</span> or nothing if not defined.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9329"></a><code class="code"><dfn id="glo:mglsforelements"><code class="csfmt">\mglsforelements</code></dfn>{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">body</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Iterates over all the list of element labels for the multi-entry identified by <span class="meta">〈<em class="metainner">multi-label</em>〉</span>. This defines <span class="meta">〈<em class="metainner">cs</em>〉</span> to the current element label on each iteration of the loop, which can be used to reference the label in <span class="meta">〈<em class="metainner">body</em>〉</span>. This internally uses <a id="wrglossary.9330"></a><a href="#glo:@for"><code class="csfmt">\@for</code></a> (patched by the <a id="wrglossary.9331"></a><a href="#glo:pkg.xfor"><span class="styfmt">xfor</span></a> package, which allows the loop to be broken).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9332"></a><code class="code"><dfn id="glo:mglsforotherelements"><code class="csfmt">\mglsforotherelements</code></dfn>{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">body</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.9333"></a><a href="#glo:mglsforelements"><code class="csfmt">\mglsforelements</code></a> but skips the main entry label.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9334"></a><code class="code"><dfn id="glo:glsxtrmultitotalelements"><code class="csfmt">\glsxtrmultitotalelements</code></dfn>{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Expands to the total number of elements in the given multi-entry or nothing if <span class="meta">〈<em class="metainner">multi-label</em>〉</span> hasn’t been defined.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9335"></a><code class="code"><dfn id="glo:glsxtrmultimainindex"><code class="csfmt">\glsxtrmultimainindex</code></dfn>{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Expands to the index of the main element in the given multi-entry or nothing if <span class="meta">〈<em class="metainner">multi-label</em>〉</span> hasn’t been defined. Indexing starts from 1 for the first element.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9336"></a><code class="code"><dfn id="glo:glsxtrmultilastotherindex"><code class="csfmt">\glsxtrmultilastotherindex</code></dfn>{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Expands to the index of the final non-main element in the given multi-entry or nothing if <span class="meta">〈<em class="metainner">multi-label</em>〉</span> hasn’t been defined.<p>
+The <a id="wrglossary.9337"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a> command will write the label information to the <a id="wrglossary.9338"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9339"></a><code class="code"><dfn id="glo:writemultiglossentry"><code class="csfmt">\writemultiglossentry</code></dfn>{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}{<span class="meta">〈<em class="metainner">main-label</em>〉</span>}{<span class="meta">〈<em class="metainner">list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is will write the following line to the <a id="wrglossary.9340"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9341"></a><code class="code"><dfn id="glo:@glsxtr@multientry"><code class="csfmt">\@glsxtr@multientry</code></dfn>{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}{<span class="meta">〈<em class="metainner">main-label</em>〉</span>}{<span class="meta">〈<em class="metainner">list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is provided to support <a id="wrglossary.9342"></a><a href="#glo:opt.docdef"><span class="styoptfmt">docdef</span></a><span class="optfmt">=true</span> and also for the benefit of any tools that require the information (such as <a id="wrglossary.9343"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> or autocompletion tools). If it’s not required and causes too much clutter, it can be disabled by redefining <a id="wrglossary.9344"></a><a href="#glo:writemultiglossentry"><code class="csfmt">\writemultiglossentry</code></a> to do nothing.<p>
+
+</section><!-- end of section sec:multiextras -->
+
+<section id="sec:mbib2gls"><!-- start of section sec:mbib2gls --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->7.14. <span class="appfmt">bib2gls</span><div class="labellink"><a href="#sec:mbib2gls">[link]</a></div></h2><!-- end of section header -->
+<p>
+In the <a id="wrglossary.9345"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v2.9+ user manual, these multi-entry sets are referred to as <span class="qt">“compound entries”</span> or <span class="qt">“compound sets”</span> to differentiate them from <a id="wrglossary.9346"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span>’s</a> multi-entry types (such as <code class="code">@dualentry</code>).<p>
+Each instance of one of the <a id="wrglossary.9347"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>-like commands is written to the <a id="wrglossary.9348"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and so can be picked up by <a id="wrglossary.9349"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> (at least version 2.9). The <a id="wrglossary.9350"></a><a href="#glo:idx.resourceopt">resource option</a> can be used to determine whether or not to consider the other (non-main) elements to be dependent on the main element.<p>
+With <a id="wrglossary.9351"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, you can either define the compound entries in the document with <a id="wrglossary.9352"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a> (or <a id="wrglossary.9353"></a><a href="#glo:providemultiglossaryentry"><code class="csfmt">\providemultiglossaryentry</code></a>) or you can use the <code class="code">@compoundset</code> entry type in a <a id="wrglossary.9354"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file. Whichever method you use, remember that the entries that form the elements of the set must be defined first. See the <a id="wrglossary.9355"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> manual (v2.9+) for further details.<p>
+You can use the resource option <a id="wrglossary.9356"></a><a href="#glo:opt.resource.compound-adjust-name"><span class="csoptfmt">compound-adjust-name</span></a> to replace the <a id="wrglossary.9357"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field of the main entry to: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9358"></a><code class="code"><dfn id="glo:glsxtrmultientryadjustedname"><code class="csfmt">\glsxtrmultientryadjustedname</code></dfn>{<span class="meta">〈<em class="metainner">sublist1</em>〉</span>}{<span class="meta">〈<em class="metainner">name</em>〉</span>}{<span class="meta">〈<em class="metainner">sublist2</em>〉</span>}{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">multi-label</em>〉</span> is the label identifying the compound set, <span class="meta">〈<em class="metainner">name</em>〉</span> was the value of the <a id="wrglossary.9359"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> before adjustment, <span class="meta">〈<em class="metainner">sublist1</em>〉</span> is the sub-list of other element labels before the main element (empty if the main element is the first element in the list), and <span class="meta">〈<em class="metainner">sublist2</em>〉</span> is the sub-list of other elements after the main element (empty if the main label is the final element).<p>
+This command is defined in <a id="wrglossary.9360"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a>, which is automatically loaded with <a id="wrglossary.9361"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.9362"></a><a href="#glo:optval.record.only"><span class="optfmt">only</span></a> and <a id="wrglossary.9363"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.9364"></a><a href="#glo:optval.record.nameref"><span class="optfmt">nameref</span></a>. Case-changing versions of this command are also available.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9365"></a><code class="code"><dfn id="glo:Glsxtrmultientryadjustedname"><code class="csfmt">\Glsxtrmultientryadjustedname</code></dfn>{<span class="meta">〈<em class="metainner">sublist1</em>〉</span>}{<span class="meta">〈<em class="metainner">name</em>〉</span>}{<span class="meta">〈<em class="metainner">sublist2</em>〉</span>}{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is a <a id="wrglossary.9366"></a><a href="#glo:idx.sentencecase">sentence case</a> version of <a id="wrglossary.9367"></a><a href="#glo:glsxtrmultientryadjustedname"><code class="csfmt">\glsxtrmultientryadjustedname</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9368"></a><code class="code"><dfn id="glo:GlsXtrmultientryadjustedname"><code class="csfmt">\GlsXtrmultientryadjustedname</code></dfn>{<span class="meta">〈<em class="metainner">sublist1</em>〉</span>}{<span class="meta">〈<em class="metainner">name</em>〉</span>}{<span class="meta">〈<em class="metainner">sublist2</em>〉</span>}{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is a <a id="wrglossary.9369"></a><a href="#glo:idx.titlecase">title case</a> version of <a id="wrglossary.9370"></a><a href="#glo:glsxtrmultientryadjustedname"><code class="csfmt">\glsxtrmultientryadjustedname</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9371"></a><code class="code"><dfn id="glo:GLSxtrmultientryadjustedname"><code class="csfmt">\GLSxtrmultientryadjustedname</code></dfn>{<span class="meta">〈<em class="metainner">sublist1</em>〉</span>}{<span class="meta">〈<em class="metainner">name</em>〉</span>}{<span class="meta">〈<em class="metainner">sublist2</em>〉</span>}{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is an <a id="wrglossary.9372"></a><a href="#glo:idx.allcaps">all caps</a> version of <a id="wrglossary.9373"></a><a href="#glo:glsxtrmultientryadjustedname"><code class="csfmt">\glsxtrmultientryadjustedname</code></a>.<p>
+Note that the above commands don’t take the prefix or suffix into account (see §<a href="#sec:mglsfixes">7.3</a>).<p>
+The separator between each element in the sub-lists is produced with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9374"></a><code class="code"><dfn id="glo:glsxtrmultientryadjustednamesep"><code class="csfmt">\glsxtrmultientryadjustednamesep</code></dfn>{<span class="meta">〈<em class="metainner">pre-label</em>〉</span>}{<span class="meta">〈<em class="metainner">post-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The default definition just uses <a id="wrglossary.9375"></a><a href="#glo:glscombinedfirstsepfirst"><code class="csfmt">\glscombinedfirstsepfirst</code></a>.<p>
+The separator between the last element of <span class="meta">〈<em class="metainner">sublist1</em>〉</span> and the main element is produced with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9376"></a><code class="code"><dfn id="glo:glsxtrmultientryadjustednamepresep"><code class="csfmt">\glsxtrmultientryadjustednamepresep</code></dfn>{<span class="meta">〈<em class="metainner">pre-label</em>〉</span>}{<span class="meta">〈<em class="metainner">post-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Similarly for the separator between the main element and the first element of <span class="meta">〈<em class="metainner">sublist2</em>〉</span>: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9377"></a><code class="code"><dfn id="glo:glsxtrmultientryadjustednamepostsep"><code class="csfmt">\glsxtrmultientryadjustednamepostsep</code></dfn>{<span class="meta">〈<em class="metainner">pre-label</em>〉</span>}{<span class="meta">〈<em class="metainner">post-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ These both default to <a id="wrglossary.9378"></a><a href="#glo:glsxtrmultientryadjustednamesep"><code class="csfmt">\glsxtrmultientryadjustednamesep</code></a>.<p>
+The <span class="meta">〈<em class="metainner">name</em>〉</span> is encapsulated with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9379"></a><code class="code"><dfn id="glo:glsxtrmultientryadjustednamefmt"><code class="csfmt">\glsxtrmultientryadjustednamefmt</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This just does its argument by default. If <span class="meta">〈<em class="metainner">sublist1</em>〉</span> is empty for the <a id="wrglossary.9380"></a><a href="#glo:idx.sentencecase">sentence case</a> version, then <span class="meta">〈<em class="metainner">name</em>〉</span> is encapsulated with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9381"></a><code class="code"><dfn id="glo:Glsxtrmultientryadjustednamefmt"><code class="csfmt">\Glsxtrmultientryadjustednamefmt</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does <a id="wrglossary.9382"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{text} by default. For the <a id="wrglossary.9383"></a><a href="#glo:idx.titlecase">title case</a> version, the name is encapsulated with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9384"></a><code class="code"><dfn id="glo:GlsXtrmultientryadjustednamefmt"><code class="csfmt">\GlsXtrmultientryadjustednamefmt</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.9385"></a><a href="#glo:glscapitalisewords"><code class="csfmt">\glscapitalisewords</code></a>, if defined, or <a id="wrglossary.9386"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a> otherwise. The <a id="wrglossary.9387"></a><a href="#glo:idx.allcaps">all caps</a> version uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9388"></a><code class="code"><dfn id="glo:GLSxtrmultientryadjustednamefmt"><code class="csfmt">\GLSxtrmultientryadjustednamefmt</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.9389"></a><a href="#glo:mfirstucMakeUppercase"><code class="csfmt">\mfirstucMakeUppercase</code></a> by default.<p>
+Each element label in the sub-lists is encapsulated with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9390"></a><code class="code"><dfn id="glo:glsxtrmultientryadjustednameother"><code class="csfmt">\glsxtrmultientryadjustednameother</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does <code class="code"><a id="wrglossary.9391"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> by default. For the <a id="wrglossary.9392"></a><a href="#glo:idx.sentencecase">sentence case</a> version (where <span class="meta">〈<em class="metainner">sublist1</em>〉</span> isn’t empty), then the element label is encapsulated with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9393"></a><code class="code"><dfn id="glo:Glsxtrmultientryadjustednameother"><code class="csfmt">\Glsxtrmultientryadjustednameother</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does <code class="code"><a id="wrglossary.9394"></a><a href="#glo:Glsentryname"><code class="csfmt">\Glsentryname</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> by default. The <a id="wrglossary.9395"></a><a href="#glo:idx.titlecase">title case</a> version uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9396"></a><code class="code"><dfn id="glo:GlsXtrmultientryadjustednameother"><code class="csfmt">\GlsXtrmultientryadjustednameother</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does <code class="code"><a id="wrglossary.9397"></a><a href="#glo:glsentrytitlecase"><code class="csfmt">\glsentrytitlecase</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}{name}</code> by default. The <a id="wrglossary.9398"></a><a href="#glo:idx.allcaps">all caps</a> version uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9399"></a><code class="code"><dfn id="glo:GLSxtrmultientryadjustednameother"><code class="csfmt">\GLSxtrmultientryadjustednameother</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is defined as: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.9400"></a><a href="#glo:GLSxtrmultientryadjustednameother"><code class="csfmt">\GLSxtrmultientryadjustednameother</code></a>}[1]{%
+ <a id="wrglossary.9401"></a><a href="#glo:mfirstucMakeUppercase"><code class="csfmt">\mfirstucMakeUppercase</code></a>{<a id="wrglossary.9402"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a>{#1}}}
+</pre><p>
+
+</section><!-- end of section sec:mbib2gls -->
+
+<section id="sec:glossaries"><!-- start of section sec:glossaries --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->8. Defining and Displaying Glossaries<div class="labellink"><a href="#sec:glossaries">[link]</a></div></h1><!-- end of chapter header -->
+<p>
+As with the base <a id="wrglossary.9403"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, you need to establish the indexing method in the preamble and use the appropriate <code class="csfmt">\print<span class="meta">〈<em class="metainner">…</em>〉</span>glossary</code> command. For example, to use the <span class="qt">“noidx”</span> method you need <a id="wrglossary.9404"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> in the preamble and <a id="wrglossary.9405"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a> in the document. Whereas if you want to use <a id="wrglossary.9406"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.9407"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, you need <a id="wrglossary.9408"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> in the preamble and <a id="wrglossary.9409"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> in the document. The <a id="wrglossary.9410"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides a hybrid approach: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9411"></a><code class="code"><dfn id="glo:makeglossaries"><code class="csfmt">\makeglossaries</code></dfn>[<span class="meta">〈<em class="metainner">types</em>〉</span>]</code></div><!-- end of pinnedbox -->
+ If the optional argument is present, then <span class="meta">〈<em class="metainner">types</em>〉</span> should be a comma-separated list of <a id="wrglossary.9412"></a><a href="#glo:dual.glossary">glossary</a> labels that should be processed by <a id="wrglossary.9413"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.9414"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> as per the normal behaviour of <a id="wrglossary.9415"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>. Any non-<a id="wrglossary.9416"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a> that are not listed in <span class="meta">〈<em class="metainner">types</em>〉</span> should be treated as though <a id="wrglossary.9417"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> was used. This means that the <a id="wrglossary.9418"></a><a href="#glo:dual.glossary">glossaries</a> listed in <span class="meta">〈<em class="metainner">types</em>〉</span> should be displayed using <a id="wrglossary.9419"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> and the other (non-<a id="wrglossary.9420"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a>) should be displayed with <a id="wrglossary.9421"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>. See <a id="wrglossary.9422"></a><a href="#glo:file.sample-mixedsort.tex"><span class="filefmt">sample-mixedsort.tex</span></a> for an example.<p>
+If the optional argument is omitted, it will be treated as per the original <a id="wrglossary.9423"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> provided by the base <a id="wrglossary.9424"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. If the optional argument is present, <a id="wrglossary.9425"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a> will be set to <code class="code">makeindex-noidx</code> or <code class="code">xindy-noidx</code>, depending on whether <a id="wrglossary.9426"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.9427"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be used.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+<a id="wrglossary.9428"></a><a href="#glo:dual.glossary">Glossaries</a> can’t be defined after <a id="wrglossary.9429"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>. This ensures that all the required <a id="wrglossary.9430"></a><a href="#glo:dual.indexing">indexing</a> files are opened. If you’re not using <a id="wrglossary.9431"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>, <a id="wrglossary.9432"></a><a href="#glo:dual.glossary">glossaries</a> need to be defined before any entries that should belong to them are defined. </div><!-- end of information -->
+<p>
+The base <a id="wrglossary.9433"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package provides <a id="wrglossary.9434"></a><a href="#glo:newignoredglossary"><code class="csfmt">\newignoredglossary</code></a> to define an <a id="wrglossary.9435"></a><a href="#glo:dual.ignoredglossary">ignored glossary</a> that doesn’t have any associated <a id="wrglossary.9436"></a><a href="#glo:dual.indexing">indexing</a> files. This will automatically switch off hyperlinks for any entries assigned to the <a id="wrglossary.9437"></a><a href="#glo:dual.glossary">glossary</a> (since there will be no target). With <a id="wrglossary.9438"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, it’s possible to have targets without using the <a id="wrglossary.9439"></a><a href="#glo:dual.indexing">indexing</a> methods provided by the base package. For example, it’s possible to have standalone entries (see §<a href="#sec:glossentry">8.5</a>) or targets can be created with <a id="wrglossary.9440"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>, so <a id="wrglossary.9441"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> provides a starred version. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9442"></a><code class="code"><dfn id="glo:newignoredglossary*"><code class="csfmt">\newignoredglossary*</code></dfn>{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This behaves like the unstarred version but doesn’t disable hyperlinks. The <a id="wrglossary.9443"></a><a href="#glo:dual.glossary">glossary</a> will still be omitted by iterative commands, such as <a id="wrglossary.9444"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>, and can’t be used with <a id="wrglossary.9445"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> or <a id="wrglossary.9446"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>. If you use an <a id="wrglossary.9447"></a><a href="#glo:dual.ignoredglossary">ignored glossary</a> with <a id="wrglossary.9448"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>, you will need to use the <a id="wrglossary.9449"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a> option to override the default title, if required.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9450"></a><code class="code"><dfn id="glo:provideignoredglossary"><code class="csfmt">\provideignoredglossary</code></dfn>{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.9451"></a><a href="#glo:newignoredglossary"><code class="csfmt">\newignoredglossary</code></a> but does nothing if the <a id="wrglossary.9452"></a><a href="#glo:dual.glossary">glossary</a> has already been defined.<p>
+With the <a id="wrglossary.9453"></a><a href="#glo:dual.indexing">indexing</a> options provided by the base <a id="wrglossary.9454"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, if you want a term to appear in more than one <a id="wrglossary.9455"></a><a href="#glo:dual.glossary">glossary</a>, it’s necessary to define a duplicate entry with a different label. With the <a id="wrglossary.9456"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>, the same entry can appear in multiple <a id="wrglossary.9457"></a><a href="#glo:dual.glossary">glossaries</a>. This can be done by simply copying the entry’s label to the required <a id="wrglossary.9458"></a><a href="#glo:dual.glossary">glossary</a> using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9459"></a><code class="code"><dfn id="glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">glossary-type</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This just adds the label to the target <a id="wrglossary.9460"></a><a href="#glo:dual.glossary">glossary’s</a> internal comma-separated list that commands like <a id="wrglossary.9461"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> iterate over. The unstarred version locally adds the label. The starred version performs a global change.<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+<a id="wrglossary.9462"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a> is not compatible with <a id="wrglossary.9463"></a><a href="#glo:opt.docdef"><span class="styoptfmt">docdef</span></a><span class="optfmt">=</span><a id="wrglossary.9464"></a><a href="#glo:optval.docdef.true"><span class="optfmt">true</span></a>. </div><!-- end of warning -->
+<p>
+Note that the <a id="wrglossary.9465"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> field will still be set to the original <a id="wrglossary.9466"></a><a href="#glo:dual.glossary">glossary</a>. This is considered the entry’s primary glossary. There’s no field that keeps track of the additional <a id="wrglossary.9467"></a><a href="#glo:dual.glossary">glossaries</a> the entry has been copied to.<p>
+If used with <a id="wrglossary.9468"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> or <a id="wrglossary.9469"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>, the entry will only be <a id="wrglossary.9470"></a><a href="#glo:@@glslabel@indexing">indexed</a> for its primary <a id="wrglossary.9471"></a><a href="#glo:dual.glossary">glossary</a>. It won’t show up in the other <a id="wrglossary.9472"></a><a href="#glo:dual.glossary">glossaries</a>, but will be found when using an iterative command, such as <a id="wrglossary.9473"></a><a href="#glo:glsaddall"><code class="csfmt">\glsaddall</code></a>, over the target <a id="wrglossary.9474"></a><a href="#glo:dual.glossary">glossary</a>.<p>
+The base <a id="wrglossary.9475"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package provides <a id="wrglossary.9476"></a><a href="#glo:forallglossaries"><code class="csfmt">\forallglossaries</code></a> to iterate over a list of <a id="wrglossary.9477"></a><a href="#glo:dual.glossary">glossaries</a> labels (all non-<a id="wrglossary.9478"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a> by default). This can also be used with <a id="wrglossary.9479"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> but <a id="wrglossary.9480"></a><a href="#glo:forallacronyms"><code class="csfmt">\forallacronyms</code></a> is only for <a id="wrglossary.9481"></a><a href="#glo:dual.glossary">glossaries</a> that have been declared as lists of acronyms, so it’s inappropriate with the <a id="wrglossary.9482"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package. Instead, you can use the analogous command: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9483"></a><code class="code"><dfn id="glo:forallabbreviationlists"><code class="csfmt">\forallabbreviationlists</code></dfn>{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">body</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Each instance of <a id="wrglossary.9484"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> will add the abbreviation’s associated <a id="wrglossary.9485"></a><a href="#glo:dual.glossary">glossary</a> (identified by the <a id="wrglossary.9486"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> key) to the internal list of labels (if not already added). Note that this won’t take into account any <a id="wrglossary.9487"></a><a href="#glo:dual.glossary">glossaries</a> that had abbreviations copied or moved to it.<p>
+
+</section><!-- end of section sec:glossaries -->
+
+<section id="sec:glspageref"><!-- start of section sec:glspageref --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->8.1. Entry Page Reference<div class="labellink"><a href="#sec:glspageref">[link]</a></div></h2><!-- end of section header -->
+<p>
+The base <a id="wrglossary.9488"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package provides <a id="wrglossary.9489"></a><a href="#glo:glsrefentry"><code class="csfmt">\glsrefentry</code></a>, which uses <a id="wrglossary.9490"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a> to reference the entry’s associated counter (enabled with <a id="wrglossary.9491"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> or <a id="wrglossary.9492"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a>, not the <a id="wrglossary.9493"></a><a href="#glo:dual.locationcounter">location counter</a>). The <a id="wrglossary.9494"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package additionally provides: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9495"></a><code class="code"><dfn id="glo:glsxtrpageref"><code class="csfmt">\glsxtrpageref</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This works in the same way but uses <a id="wrglossary.9496"></a><a href="#glo:pageref"><code class="csfmt">\pageref</code></a> instead of <a id="wrglossary.9497"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>. As with <a id="wrglossary.9498"></a><a href="#glo:glsrefentry"><code class="csfmt">\glsrefentry</code></a>, if the corresponding counter has not been enabled, this just does <code class="code"><a id="wrglossary.9499"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>.<p>
+
+</section><!-- end of section sec:glspageref -->
+
+<section id="sec:glospreamble"><!-- start of section sec:glospreamble --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->8.2. Glossary Preamble<div class="labellink"><a href="#sec:glospreamble">[link]</a></div></h2><!-- end of section header -->
+<p>
+The base package provides <a id="wrglossary.9500"></a><a href="#glo:glossarypreamble"><code class="csfmt">\glossarypreamble</code></a>, which is used at the start of the <a id="wrglossary.9501"></a><a href="#glo:dual.glossary">glossary</a>. By default, this will use the preamble associated with the current <a id="wrglossary.9502"></a><a href="#glo:dual.glossary">glossary</a>. If you redefine <a id="wrglossary.9503"></a><a href="#glo:glossarypreamble"><code class="csfmt">\glossarypreamble</code></a>, this will set the preamble for all glossaries. To set the preamble for a particular glossary, you can use <a id="wrglossary.9504"></a><a href="#glo:setglossarypreamble"><code class="csfmt">\setglossarypreamble</code></a>. With <a id="wrglossary.9505"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, you can additionally append to an existing preamble using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9506"></a><code class="code"><dfn id="glo:apptoglossarypreamble"><code class="csfmt">\apptoglossarypreamble</code></dfn>[<span class="meta">〈<em class="metainner">type</em>〉</span>]{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This (locally) appends <span class="meta">〈<em class="metainner">text</em>〉</span> to the preamble for the <a id="wrglossary.9507"></a><a href="#glo:dual.glossary">glossary</a> identified by <span class="meta">〈<em class="metainner">type</em>〉</span>. If <span class="meta">〈<em class="metainner">type</em>〉</span> is omitted, <a id="wrglossary.9508"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a> is assumed.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9509"></a><code class="code"><dfn id="glo:pretoglossarypreamble"><code class="csfmt">\pretoglossarypreamble</code></dfn>[<span class="meta">〈<em class="metainner">type</em>〉</span>]{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This (locally) prepends <span class="meta">〈<em class="metainner">text</em>〉</span> to the preamble for the <a id="wrglossary.9510"></a><a href="#glo:dual.glossary">glossary</a> identified by <span class="meta">〈<em class="metainner">type</em>〉</span>. If <span class="meta">〈<em class="metainner">type</em>〉</span> is omitted, <a id="wrglossary.9511"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a> is assumed.<p>
+
+</section><!-- end of section sec:glospreamble -->
+
+<section id="sec:printglossopts"><!-- start of section sec:printglossopts --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->8.3. Options<div class="labellink"><a href="#sec:printglossopts">[link]</a></div></h2><!-- end of section header -->
+<p>
+In addition to the <a id="wrglossary.9512"></a><a href="#glo:@@glslabel@printglossopt">options</a> available with <a id="wrglossary.9513"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>, the following options are also provided. Some of these listed here are specific to <a id="wrglossary.9514"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> and <a id="wrglossary.9515"></a><a href="#glo:env.printunsrtglossarywrap"><span class="envfmt">printunsrtglossarywrap</span></a>. Options provided by the base package that aren’t available for the <a id="wrglossary.9516"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> are identified below.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.9517"></a><code class="code"><dfn id="glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></dfn>=<span class="meta">〈<em class="metainner">method</em>〉</span></code></div><!-- end of settingsbox -->
+ This option is only available for <a id="wrglossary.9518"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>. The <a id="wrglossary.9519"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> and <a id="wrglossary.9520"></a><a href="#glo:printunsrtinnerglossary"><code class="csfmt">\printunsrtinnerglossary</code></a> commands simply iterate over the <a id="wrglossary.9521"></a><a href="#glo:dual.glossary">glossary’s</a> internal list in the order in which the entries have been added to that <a id="wrglossary.9522"></a><a href="#glo:dual.glossary">glossary</a>. If you are using <a id="wrglossary.9523"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, use the <a id="wrglossary.9524"></a><a href="#glo:opt.resource.sort"><span class="csoptfmt">sort</span></a> resource option instead.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.9525"></a><code class="code"><dfn id="glo:opt.printgloss.title"><span class="csoptfmt">title</span></dfn>=<span class="meta">〈<em class="metainner">text</em>〉</span></code></div><!-- end of settingsbox -->
+ This option is provided by the base <a id="wrglossary.9526"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package to override the default title for the <a id="wrglossary.9527"></a><a href="#glo:dual.glossary">glossary</a>. This option is also available for <a id="wrglossary.9528"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> and <a id="wrglossary.9529"></a><a href="#glo:env.printunsrtglossarywrap"><span class="envfmt">printunsrtglossarywrap</span></a> but not for <a id="wrglossary.9530"></a><a href="#glo:printunsrtinnerglossary"><code class="csfmt">\printunsrtinnerglossary</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.9531"></a><code class="code"><dfn id="glo:opt.printgloss.toctitle"><span class="csoptfmt">toctitle</span></dfn>=<span class="meta">〈<em class="metainner">text</em>〉</span></code></div><!-- end of settingsbox -->
+ This option is provided by the base <a id="wrglossary.9532"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package to override the default table of contents title for the <a id="wrglossary.9533"></a><a href="#glo:dual.glossary">glossary</a>. This option is also available for <a id="wrglossary.9534"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> and <a id="wrglossary.9535"></a><a href="#glo:env.printunsrtglossarywrap"><span class="envfmt">printunsrtglossarywrap</span></a> but not for <a id="wrglossary.9536"></a><a href="#glo:printunsrtinnerglossary"><code class="csfmt">\printunsrtinnerglossary</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.9537"></a><code class="code"><dfn id="glo:opt.printgloss.numberedsection"><span class="csoptfmt">numberedsection</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>nolabel; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This option is provided by the base <a id="wrglossary.9538"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package to indicate whether or not the section header used at the start of the <a id="wrglossary.9539"></a><a href="#glo:dual.glossary">glossary</a> should be numbered rather than unnumbered (and whether or not to automatically label the glossary with <code class="code"><a id="wrglossary.9540"></a><a href="#glo:label"><code class="csfmt">\label</code></a>{<a id="wrglossary.9541"></a><a href="#glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></a><span class="meta">〈<em class="metainner">glossary-type</em>〉</span>}</code>). The <a id="wrglossary.9542"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a> package option will change the default setting to match. This option is not available for <a id="wrglossary.9543"></a><a href="#glo:printunsrtinnerglossary"><code class="csfmt">\printunsrtinnerglossary</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.9544"></a><code class="code"><dfn id="glo:opt.printgloss.style"><span class="csoptfmt">style</span></dfn>=<span class="meta">〈<em class="metainner">style-name</em>〉</span></code></div><!-- end of settingsbox -->
+ This option is provided by the base <a id="wrglossary.9545"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package to set the <a id="wrglossary.9546"></a><a href="#glo:idx.glossarystyle">glossary style</a>. This option is not available for <a id="wrglossary.9547"></a><a href="#glo:printunsrtinnerglossary"><code class="csfmt">\printunsrtinnerglossary</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.9548"></a><code class="code"><dfn id="glo:opt.printgloss.label"><span class="csoptfmt">label</span></dfn>=<span class="meta">〈<em class="metainner">label</em>〉</span></code></div><!-- end of settingsbox -->
+ This option is provided by <a id="wrglossary.9549"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> to add <code class="code"><a id="wrglossary.9550"></a><a href="#glo:label"><code class="csfmt">\label</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> after the section header. This is essentially like <a id="wrglossary.9551"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a><span class="optfmt">=nameref</span> but you supply the label. This option is not available for <a id="wrglossary.9552"></a><a href="#glo:printunsrtinnerglossary"><code class="csfmt">\printunsrtinnerglossary</code></a>. Alternatively, you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9553"></a><code class="code"><dfn id="glo:glsxtrsetglossarylabel"><code class="csfmt">\glsxtrsetglossarylabel</code></dfn>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This will need to be scoped or changed between <a id="wrglossary.9554"></a><a href="#glo:dual.glossary">glossaries</a> or use a command in <span class="meta">〈<em class="metainner">label</em>〉</span> that expands differently for each <a id="wrglossary.9555"></a><a href="#glo:dual.glossary">glossary</a> to avoid duplicate labels.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.9556"></a><code class="code"><dfn id="glo:opt.printgloss.leveloffset"><span class="csoptfmt">leveloffset</span></dfn>=<span class="meta">〈<em class="metainner">offset</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>0</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This option sets or increments the <a id="wrglossary.9557"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> offset. If <span class="meta">〈<em class="metainner">offset</em>〉</span> starts with <code class="code">++</code> then the current offset is incremented by the given amount otherwise the current offset is set to <span class="meta">〈<em class="metainner">offset</em>〉</span>. For example, an entry with a normal <a id="wrglossary.9558"></a><a href="#glo:hierarchicallevel">hierarchical level</a> of 1 will be treated as though it has <a id="wrglossary.9559"></a><a href="#glo:hierarchicallevel">hierarchical level</a> 1+<span class="meta">〈<em class="metainner">offset</em>〉</span>. Note that the <a id="wrglossary.9560"></a><a href="#glo:idx.glossarystyle">glossary style</a> may not support the resulting <a id="wrglossary.9561"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a>. This option is only available for the <a id="wrglossary.9562"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> and the <a id="wrglossary.9563"></a><a href="#glo:env.printunsrtglossarywrap"><span class="envfmt">printunsrtglossarywrap</span></a> environment. See §<a href="#sec:printunsrtinner">8.4.3.1</a> for an example.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.9564"></a><code class="code"><dfn id="glo:opt.printgloss.flatten"><span class="csoptfmt">flatten</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ Treats all entries as though they have the same <a id="wrglossary.9565"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> (the value of <a id="wrglossary.9566"></a><a href="#glo:opt.printgloss.leveloffset"><span class="csoptfmt">leveloffset</span></a>). This option is only available for the <a id="wrglossary.9567"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> and the <a id="wrglossary.9568"></a><a href="#glo:env.printunsrtglossarywrap"><span class="envfmt">printunsrtglossarywrap</span></a> environment. Unlike the <a id="wrglossary.9569"></a><a href="#glo:opt.resource.flatten"><span class="csoptfmt">flatten</span></a> resource option, this option doesn’t actually remove the <a id="wrglossary.9570"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> field.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.9571"></a><code class="code"><dfn id="glo:opt.printgloss.groups"><span class="csoptfmt">groups</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This option is only applicable to the <a id="wrglossary.9572"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> and <a id="wrglossary.9573"></a><a href="#glo:env.printunsrtglossarywrap"><span class="envfmt">printunsrtglossarywrap</span></a>. If set to false, it will prevent <a id="wrglossary.9574"></a><a href="#glo:idx.group">groups</a> from being formed. If true (the default), <a id="wrglossary.9575"></a><a href="#glo:idx.group">groups</a> will only be formed if they are supported. See §<a href="#sec:printunsrt">8.4</a> for further details.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.9576"></a><code class="code"><dfn id="glo:opt.printgloss.prefix"><span class="csoptfmt">prefix</span></dfn>=<span class="meta">〈<em class="metainner">prefix</em>〉</span></code></div><!-- end of settingsbox -->
+ This option is provided by <a id="wrglossary.9577"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and simply redefines <a id="wrglossary.9578"></a><a href="#glo:glolinkprefix"><code class="csfmt">\glolinkprefix</code></a> to expand to <span class="meta">〈<em class="metainner">prefix</em>〉</span>. If hyperlinks are supported and the <a id="wrglossary.9579"></a><a href="#glo:idx.glossarystyle">glossary style</a> uses <a id="wrglossary.9580"></a><a href="#glo:glstarget"><code class="csfmt">\glstarget</code></a> to create the entry’s hypertarget, the target name is obtained from <code class="code"><a id="wrglossary.9581"></a><a href="#glo:glolinkprefix"><code class="csfmt">\glolinkprefix</code></a><span class="meta">〈<em class="metainner">entry-label</em>〉</span></code>. If you are displaying multiple <a id="wrglossary.9582"></a><a href="#glo:dual.glossary">glossaries</a> with shared entries (for example, using the <a id="wrglossary.9583"></a><a href="#glo:opt.resource.secondary"><span class="csoptfmt">secondary</span></a> resource option with <a id="wrglossary.9584"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>), then changing the prefix can avoid duplicate targets.<p>
+Note that this option will also affect the targets used by the <a id="wrglossary.9585"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.9586"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands. This means that if you have, for example, <a id="wrglossary.9587"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> in the description of an entry, then its hyperlink will go to that entry’s item in the current <a id="wrglossary.9588"></a><a href="#glo:dual.glossary">glossary</a>. Whereas referencing that entry outside of the <a id="wrglossary.9589"></a><a href="#glo:dual.glossary">glossary</a> will hyperlink to the <a id="wrglossary.9590"></a><a href="#glo:dual.glossary">glossary</a> that uses the prefix matching the setting at that point in the document. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.9591"></a><a href="#glo:opt.showtargets"><span class="styoptfmt">showtargets</span></a><span class="optfmt">=annoteleft</span>,<a id="wrglossary.9592"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.9593"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a></span>]{glossaries-extra}
+<a id="wrglossary.9594"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.9595"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,
+ <a id="wrglossary.9596"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example description that references <a id="wrglossary.9597"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{another}}</span>}
+<a id="wrglossary.9598"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{another}{<a id="wrglossary.9599"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={another}</span>,
+ <a id="wrglossary.9600"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={some other example description that references <a id="wrglossary.9601"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}}</span>}
+<code class="cbeg">\begin{document}</code>
+Link to glossary 1: <a id="wrglossary.9602"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}.
+
+Link to glossary 2: <a id="wrglossary.9603"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.9604"></a><a href="#glo:opt.glsopt.prefix"><span class="csoptfmt">prefix</span></a><span class="optfmt">=other-</span>]{sample}.
+<a id="wrglossary.9605"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>
+<a id="wrglossary.9606"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<a id="wrglossary.9607"></a><a href="#glo:opt.printgloss.prefix"><span class="csoptfmt">prefix</span></a><span class="optfmt">=other-</span>]
+<code class="cend">\end{document}</code>
+</pre> This uses the <a id="wrglossary.9608"></a><a href="#glo:opt.showtargets"><span class="styoptfmt">showtargets</span></a> package option to show the target names to the left of the hyperlink or hypertarget. The result is: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:targetprefixes"></a>Example 132: Changing the target prefix <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example132.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example132.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example132.png" type="image/png" width="421" height="265">Example document that illustrates two glossaries with different target prefixes.</object> </div><!-- end of resultbox -->
+ Within the main part of the document, the first reference to <span class="qt">“sample”</span> has a hyperlink to the first <a id="wrglossary.9609"></a><a href="#glo:dual.glossary">glossary</a> (with the target <code class="code">glo:sample</code>, which uses the default prefix), and the second reference has a hyperlink to the second <a id="wrglossary.9610"></a><a href="#glo:dual.glossary">glossary</a> (with the target <code class="code">other-sample</code>).<p>
+Within the <a id="wrglossary.9611"></a><a href="#glo:dual.glossary">glossaries</a>, the <a id="wrglossary.9612"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> references use the current <a id="wrglossary.9613"></a><a href="#glo:dual.glossary">glossary</a> prefix, so the target is in the same <a id="wrglossary.9614"></a><a href="#glo:dual.glossary">glossary</a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.9615"></a><code class="code"><dfn id="glo:opt.printgloss.targetnameprefix"><span class="csoptfmt">targetnameprefix</span></dfn>=<span class="meta">〈<em class="metainner">prefix</em>〉</span></code></div><!-- end of settingsbox -->
+ This is similar to the previous option but only affects the prefix for the entry item’s target and doesn’t change the prefix for any references contained within the <a id="wrglossary.9616"></a><a href="#glo:dual.glossary">glossary</a>. This <span style="font-style: italic; font-variant: normal; ">prepends</span> the given prefix to the default prefix.<p>
+If the above example is modified to: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>Link to glossary 1: <a id="wrglossary.9617"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}.
+
+Link to glossary 2: <a id="wrglossary.9618"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.9619"></a><a href="#glo:opt.glsopt.prefix"><span class="csoptfmt">prefix</span></a><span class="optfmt">=other-glo:</span>]{sample}.
+<a id="wrglossary.9620"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>
+<a id="wrglossary.9621"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<a id="wrglossary.9622"></a><a href="#glo:opt.printgloss.targetnameprefix"><span class="csoptfmt">targetnameprefix</span></a><span class="optfmt">=other-</span>]
+</pre> Then the result will be: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:targetprefixname"></a>Example 133: Prepending to the target prefix for just the entry item <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example133.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example133.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example133.png" type="image/png" width="421" height="265">Example document that illustrates two glossaries with different target prefixes using targetprefixname.</object> </div><!-- end of resultbox -->
+<p>
+Note that this has prepended <code class="code">other-</code> to the existing <code class="code">glo:</code> prefix. This is why the <a id="wrglossary.9623"></a><a href="#glo:opt.glsopt.prefix"><span class="csoptfmt">prefix</span></a> option in the second <a id="wrglossary.9624"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> reference had to be changed to match the appropriate hypertarget name. The <a id="wrglossary.9625"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> references in the second <a id="wrglossary.9626"></a><a href="#glo:dual.glossary">glossary</a> now point to the relevant line in the first <a id="wrglossary.9627"></a><a href="#glo:dual.glossary">glossary</a>.<p>
+It’s possible to combine <a id="wrglossary.9628"></a><a href="#glo:opt.printgloss.targetnameprefix"><span class="csoptfmt">targetnameprefix</span></a> with <a id="wrglossary.9629"></a><a href="#glo:opt.printgloss.prefix"><span class="csoptfmt">prefix</span></a><span class="optfmt">={}</span> but that will also affect the <a id="wrglossary.9630"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> references within the <a id="wrglossary.9631"></a><a href="#glo:dual.glossary">glossary</a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.9632"></a><code class="code"><dfn id="glo:opt.printgloss.target"><span class="csoptfmt">target</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This is a boolean option that can be used to switch off the automatic creation of the entry hypertargets but still allows hyperlinks within the <a id="wrglossary.9633"></a><a href="#glo:dual.glossary">glossary</a>. This can be used to prevent duplicate destinations for secondary <a id="wrglossary.9634"></a><a href="#glo:dual.glossary">glossaries</a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.9635"></a><code class="code"><dfn id="glo:opt.printgloss.preamble"><span class="csoptfmt">preamble</span></dfn>=<span class="meta">〈<em class="metainner">text</em>〉</span></code></div><!-- end of settingsbox -->
+ Redefines <a id="wrglossary.9636"></a><a href="#glo:glossarypreamble"><code class="csfmt">\glossarypreamble</code></a> to <span class="meta">〈<em class="metainner">text</em>〉</span>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.9637"></a><code class="code"><dfn id="glo:opt.printgloss.postamble"><span class="csoptfmt">postamble</span></dfn>=<span class="meta">〈<em class="metainner">text</em>〉</span></code></div><!-- end of settingsbox -->
+ Redefines <a id="wrglossary.9638"></a><a href="#glo:glossarypostamble"><code class="csfmt">\glossarypostamble</code></a> to <span class="meta">〈<em class="metainner">text</em>〉</span>.<p>
+
+</section><!-- end of section sec:printglossopts -->
+
+<section id="sec:printunsrt"><!-- start of section sec:printunsrt --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->8.4. Displaying a Glossary Without Sorting or Indexing<div class="labellink"><a href="#sec:printunsrt">[link]</a></div></h2><!-- end of section header -->
+<p>
+The base <a id="wrglossary.9639"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package provides two ways of displaying a <a id="wrglossary.9640"></a><a href="#glo:dual.glossary">glossary</a>, depending on the <a id="wrglossary.9641"></a><a href="#glo:dual.indexing">indexing</a> option: <a id="wrglossary.9642"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> (used with <a id="wrglossary.9643"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>) or <a id="wrglossary.9644"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a> (used with <a id="wrglossary.9645"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a>).<p>
+The <a id="wrglossary.9646"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides an alternative that doesn’t require sorting or <a id="wrglossary.9647"></a><a href="#glo:dual.indexing">indexing</a>. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9648"></a><code class="code"><dfn id="glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code></div><!-- end of pinnedbox -->
+ This behaves in a similar way to <a id="wrglossary.9649"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>, but it always lists all the defined entries for the given glossary in the order in which they were added to the glossary. Unlike <a id="wrglossary.9650"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>, you may use <a id="wrglossary.9651"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> with an <a id="wrglossary.9652"></a><a href="#glo:dual.ignoredglossary">ignored glossary</a>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The <a id="wrglossary.9653"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> and <a id="wrglossary.9654"></a><a href="#glo:env.printunsrtglossarywrap"><span class="envfmt">printunsrtglossarywrap</span></a> are not intended for use with <a id="wrglossary.9655"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> and <a id="wrglossary.9656"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a>. Mixing these different methods can result in unexpected behaviour. </div><!-- end of important -->
+<p>
+There is also a starred version which has a mandatory argument: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9657"></a><code class="code"><dfn id="glo:printunsrtglossary*"><code class="csfmt">\printunsrtglossary*</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">init-code</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is equivalent to: <pre class="compactcodebox"><code class="cmd">\begingroup</code>
+ <span class="meta">〈<em class="metainner">init-code</em>〉</span><a id="wrglossary.9658"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<span class="meta">〈<em class="metainner">options</em>〉</span>]
+<code class="cmd">\endgroup</code>
+</pre> There’s no significant difference between doing: <pre class="compactcodebox">{<span class="meta">〈<em class="metainner">init-code</em>〉</span><a id="wrglossary.9659"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<span class="meta">〈<em class="metainner">options</em>〉</span>]}
+</pre> and <pre class="compactcodebox"><a id="wrglossary.9660"></a><a href="#glo:printunsrtglossary*"><code class="csfmt">\printunsrtglossary*</code></a>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">init-code</em>〉</span>}
+</pre> Note that unlike <a id="wrglossary.9661"></a><a href="#glo:glossarypreamble"><code class="csfmt">\glossarypreamble</code></a>, the supplied <span class="meta">〈<em class="metainner">init-code</em>〉</span> is done before the <a id="wrglossary.9662"></a><a href="#glo:dual.glossary">glossary</a> header.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+If you want to use one of the <a id="wrglossary.9663"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>-like styles with <a id="wrglossary.9664"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>, make sure you load <a id="wrglossary.9665"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> which modifies the definition of <a id="wrglossary.9666"></a><a href="#glo:glsgroupskip"><code class="csfmt">\glsgroupskip</code></a> to avoid the <span class="qt">“Incomplete <code class="csfmt">\iftrue</code>”</span> error that may otherwise occur. </div><!-- end of important -->
+<p>
+As with <a id="wrglossary.9667"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> and <a id="wrglossary.9668"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>, there is also a command to print all non-<a id="wrglossary.9669"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a> in the order in which they were defined: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9670"></a><code class="code"><dfn id="glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></dfn></code></div><!-- end of pinnedbox -->
+<p>
+This means you now have the option to simply list all entries on the first LaTeX run without the need for a post-processor, however there will be no <a id="wrglossary.9671"></a><a href="#glo:dual.locationlist">location list</a> in this case, as that has to be set by a post-processor such as <a id="wrglossary.9672"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> (see §<a href="#sec:bib2gls">11</a>).<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+No attempt is made to gather hierarchical elements. If child entries aren’t defined immediately after their parent entry, they won’t be together in the <a id="wrglossary.9673"></a><a href="#glo:dual.glossary">glossary</a> when using <a id="wrglossary.9674"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>. </div><!-- end of warning -->
+<p>
+The way that <a id="wrglossary.9675"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> basically works is to iterate over every label in the <a id="wrglossary.9676"></a><a href="#glo:dual.glossary">glossary’s</a> internal label list and format each entry according to the way the <a id="wrglossary.9677"></a><a href="#glo:idx.glossarystyle">glossary style</a> would normally format the entry’s <a id="wrglossary.9678"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> (described in more detail in §<a href="#sec:printunsrtadvanced">8.4.3</a>). If a change in letter group is detected, the letter group heading and group skip will be inserted.<p>
+A label is appended to the <a id="wrglossary.9679"></a><a href="#glo:dual.glossary">glossary’s</a> internal label list whenever an entry is defined. This means that the list will normally be in order of definition, but it’s also possible to copy an entry’s label to another <a id="wrglossary.9680"></a><a href="#glo:dual.glossary">glossary’s</a> internal label list using <a id="wrglossary.9681"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a>, which can be used to provide a different order. A simple example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.9682"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.9683"></a><a href="#glo:opt.glostyle.treegroup"><span class="glostylefmt">treegroup</span></a></span>]{glossaries-extra}
+<a id="wrglossary.9684"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{ant}{<a id="wrglossary.9685"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={ant}</span>,<a id="wrglossary.9686"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.9687"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{gazelle}{<a id="wrglossary.9688"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={gazelle}</span>,<a id="wrglossary.9689"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.9690"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>
+<code class="cend">\end{document}</code>
+</pre> The document build only requires one LaTeX call in this case. <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:printunsrt"></a>Example 134: Displaying unsorted glossaries <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example134.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example134.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example134.png" type="image/png" width="73" height="115">Example document that doesn’t require any external indexing.</object> </div><!-- end of resultbox -->
+ Note the difference if the <a id="wrglossary.9691"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a> option is used: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.9692"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a>,<a id="wrglossary.9693"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.9694"></a><a href="#glo:opt.glostyle.treegroup"><span class="glostylefmt">treegroup</span></a></span>]{glossaries-extra}
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:printunsrtstylemods"></a>Example 135: Displaying unsorted glossaries with <span class="optfmt">stylemods</span> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example135.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example135.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example135.png" type="image/png" width="73" height="115">Example document that doesn’t require any external indexing using the stylemods option.</object> </div><!-- end of resultbox -->
+ In this case, the <a id="wrglossary.9695"></a><a href="#glo:idx.group">group</a> headings are now numbers instead of letters. The styles provided with <a id="wrglossary.9696"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and those modified by <a id="wrglossary.9697"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> are designed to assist integration with <a id="wrglossary.9698"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. Without these modifications, <a id="wrglossary.9699"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> behaves like the less sophisticated <a id="wrglossary.9700"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a> which checks if the label is an integer less than 256 and uses <a id="wrglossary.9701"></a><a href="#glo:char"><code class="csfmt">\char</code></a> to create the title (if no title has been provided).<p>
+If you really want to use <a id="wrglossary.9702"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> without <a id="wrglossary.9703"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> and you want letter <a id="wrglossary.9704"></a><a href="#glo:idx.group">groups</a> with <a id="wrglossary.9705"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a> without having to define all the titles, you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9706"></a><code class="code"><dfn id="glo:glsxtrnoidxgroups"><code class="csfmt">\glsxtrnoidxgroups</code></dfn></code></div><!-- end of pinnedbox -->
+ which will switch over to using the group titling method used with <a id="wrglossary.9707"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a> (which only supports <a id="wrglossary.9708"></a><a href="#glo:dual.ascii">ASCII</a>). This command is only available with <a id="wrglossary.9709"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.9710"></a><a href="#glo:optval.record.off"><span class="optfmt">off</span></a> and can’t be used with <a id="wrglossary.9711"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>.<p>
+If, conversely, you don’t want any <a id="wrglossary.9712"></a><a href="#glo:idx.group">groups</a> formed, regardless of the <a id="wrglossary.9713"></a><a href="#glo:idx.glossarystyle">glossary style</a>, you can disable them with <a id="wrglossary.9714"></a><a href="#glo:opt.printgloss.groups"><span class="csoptfmt">groups</span></a><span class="optfmt">=false</span>. The above example can be modified so that the document contains: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.9715"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<a id="wrglossary.9716"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a><span class="optfmt">={Glossary 1}</span>]
+<a id="wrglossary.9717"></a><a href="#glo:glsxtrnoidxgroups"><code class="csfmt">\glsxtrnoidxgroups</code></a>
+<a id="wrglossary.9718"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<a id="wrglossary.9719"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a><span class="optfmt">={Glossary 2}</span>]
+<a id="wrglossary.9720"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<a id="wrglossary.9721"></a><a href="#glo:opt.printgloss.groups"><span class="csoptfmt">groups</span></a><span class="optfmt">=false</span>,<a id="wrglossary.9722"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a><span class="optfmt">={Glossary 3}</span>]
+<a id="wrglossary.9723"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<a id="wrglossary.9724"></a><a href="#glo:opt.printgloss.style"><span class="csoptfmt">style</span></a><span class="optfmt">=tree</span>,<a id="wrglossary.9725"></a><a href="#glo:opt.printgloss.nogroupskip"><span class="csoptfmt">nogroupskip</span></a>,<a id="wrglossary.9726"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a><span class="optfmt">={Glossary 4}</span>]
+</pre> This repeats the same <a id="wrglossary.9727"></a><a href="#glo:dual.glossary">glossary</a>. The first is the same as the previous example. The second is the same as the example that didn’t use <a id="wrglossary.9728"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a>. The final two <a id="wrglossary.9729"></a><a href="#glo:dual.glossary">glossaries</a> have the <a id="wrglossary.9730"></a><a href="#glo:idx.group">groups</a> suppressed. Using <a id="wrglossary.9731"></a><a href="#glo:opt.printgloss.groups"><span class="csoptfmt">groups</span></a><span class="optfmt">=false</span> (Glossary 3) is more efficient than using <a id="wrglossary.9732"></a><a href="#glo:opt.printgloss.nogroupskip"><span class="csoptfmt">nogroupskip</span></a> and switching to a style that doesn’t show the header (Glossary 4).<p>
+I’ve also switched to two column mode to display the result in a more compact form. The first two glossaries are shown on the left and the last two are on the right: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:printunsrtgroup"></a>Example 136: Displaying unsorted glossaries with different group settings <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example136.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example136.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example136.png" type="image/png" width="288" height="255">Example document that doesn’t require any external indexing with different group settings.</object> </div><!-- end of resultbox -->
+<p>
+The <a id="wrglossary.9733"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> were designed for use with <a id="wrglossary.9734"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, which uses more complex alphanumeric <a id="wrglossary.9735"></a><a href="#glo:idx.group">group</a> labels to allow for greater customization and to avoid conflict where there are multiple <a id="wrglossary.9736"></a><a href="#glo:dual.glossary">glossaries</a> or <a id="wrglossary.9737"></a><a href="#glo:dual.hierarchicallevel">hierarchical levels</a> with potentially the same letter <a id="wrglossary.9738"></a><a href="#glo:idx.group">groups</a>.<p>
+The way that <a id="wrglossary.9739"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> works is to select entries from a <a id="wrglossary.9740"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file, according to the document requirements, sort the entries, and then write the entry definitions (with commands like <a id="wrglossary.9741"></a><a href="#glo:longnewglossaryentry*"><code class="csfmt">\longnewglossaryentry*</code></a> or <a id="wrglossary.9742"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>) in the <a id="wrglossary.9743"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> in the desired order, which is then input by <a id="wrglossary.9744"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>. This means that <a id="wrglossary.9745"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> will display the entries in that order since, from <a id="wrglossary.9746"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span>’s</a> point of view, that’s the order of definition.<p>
+While it is possible to use <a id="wrglossary.9747"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> without <a id="wrglossary.9748"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, as in the above example, for long or complex <a id="wrglossary.9749"></a><a href="#glo:dual.glossary">glossaries</a> it’s better to use <a id="wrglossary.9750"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> which can automatically assign appropriate titles to the <a id="wrglossary.9751"></a><a href="#glo:idx.group">groups</a>.<p>
+<a id="wrglossary.9752"></a><a href="#glo:idx.group">Groups</a> and hierarchy are discussed in more detail in §<a href="#sec:printunsrtgroups">8.4.1</a>. See §<a href="#sec:printunsrtlocations">8.4.2</a> for <a id="wrglossary.9753"></a><a href="#glo:dual.locationlist">location lists</a> and §<a href="#sec:printunsrtinner">8.4.3.1</a>. Advanced commands and further detail about the way <a id="wrglossary.9754"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> works are covered in §<a href="#sec:printunsrtadvanced">8.4.3</a>.<p>
+
+</section><!-- end of section sec:printunsrt -->
+
+<section id="sec:printunsrtgroups"><!-- start of section sec:printunsrtgroups --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->8.4.1. Groups and Hierarchy<div class="labellink"><a href="#sec:printunsrtgroups">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+See <a href="https://www.dickimaw-books.com/gallery/index.php?label=logicaldivisions">Gallery: Logical Glossary Divisions (type vs group vs parent)</a> for the difference between the <a id="wrglossary.9755"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a>, <a id="wrglossary.9756"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> and <a id="wrglossary.9757"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> fields. </div><!-- end of information -->
+<p>
+Here’s a longer example that uses <a id="wrglossary.9758"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a> to automatically load <a id="wrglossary.9759"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.9760"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a><span class="optfmt">=bookindex</span>,<a id="wrglossary.9761"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.9762"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a></span>]{glossaries-extra}
+<a id="wrglossary.9763"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{waterfowl}{<a id="wrglossary.9764"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={waterfowl}</span>,<a id="wrglossary.9765"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.9766"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{ant}{<a id="wrglossary.9767"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={ant}</span>,<a id="wrglossary.9768"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.9769"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{adder}{<a id="wrglossary.9770"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={adder}</span>,<a id="wrglossary.9771"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.9772"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{duck}{<a id="wrglossary.9773"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,<a id="wrglossary.9774"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={waterfowl}</span>,
+ <a id="wrglossary.9775"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.9776"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{zebra}{<a id="wrglossary.9777"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={zebra}</span>,<a id="wrglossary.9778"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.9779"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{aardvark}{<a id="wrglossary.9780"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={aardvark}</span>,<a id="wrglossary.9781"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.9782"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{gazelle}{<a id="wrglossary.9783"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={gazelle}</span>,<a id="wrglossary.9784"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.9785"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{mallard}{<a id="wrglossary.9786"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={mallard}</span>,<a id="wrglossary.9787"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={duck}</span>,
+ <a id="wrglossary.9788"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+
+<a id="wrglossary.9789"></a><a href="#glo:newglossary*"><code class="csfmt">\newglossary*</code></a>{another}{Another Glossary}
+<a id="wrglossary.9790"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a>{mallard}{another}
+<a id="wrglossary.9791"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a>{aardvark}{another}
+<a id="wrglossary.9792"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a>{zebra}{another}
+<a id="wrglossary.9793"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a>{ant}{another}
+<a id="wrglossary.9794"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a>{duck}{another}
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.9795"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>
+<a id="wrglossary.9796"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<a id="wrglossary.9797"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=another</span>]
+<code class="cend">\end{document}</code>
+</pre> Unlike the previous examples that defined the entries in alphabetical order, this example hasn’t used any logical order. Note, in particular, that the child entries <span class="qt">“duck”</span> and <span class="qt">“mallard”</span> (which have the <a id="wrglossary.9798"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> key set) have not been defined immediately after their parent.<p>
+The first <a id="wrglossary.9799"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> has the default <a id="wrglossary.9800"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=main</span> and lists all entries defined in the <code class="code">main</code> <a id="wrglossary.9801"></a><a href="#glo:dual.glossary">glossary</a>, in the order in which they were defined. The second <a id="wrglossary.9802"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> lists all entries in the custom <code class="code">another</code> <a id="wrglossary.9803"></a><a href="#glo:dual.glossary">glossary</a> and is in the order in which the entries were copied to that <a id="wrglossary.9804"></a><a href="#glo:dual.glossary">glossary</a>.<p>
+The document build again simply requires one LaTeX call. The result is shown in Example <a href="#ex:unsrtcopygrp">137</a>. <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:unsrtcopygrp"></a>Example 137: Displaying unsorted glossaries with a copied list <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example137.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example137.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example137.png" type="image/png" width="300" height="345">Example document that doesn’t require any external indexing that copies entries to another glossary. Entries are listed in order of definition with child entries indented, that results in a confusing list.</object> </div><!-- end of resultbox -->
+<p>
+There are some oddities in both lists. It’s the <a id="wrglossary.9805"></a><a href="#glo:idx.glossarystyle">glossary style</a> that determines the formatting of the entries according to the entry’s <a id="wrglossary.9806"></a><a href="#glo:hierarchicallevel">hierarchical level</a>, but it looks strange for the duck and mallard entries to be indented when they don’t follow after their parent entry.<p>
+As the internal loop within <a id="wrglossary.9807"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> iterates over each entry, it tries to determine which <a id="wrglossary.9808"></a><a href="#glo:@@glslabel@group">letter group</a> the entry belongs to. If it’s different from the <a id="wrglossary.9809"></a><a href="#glo:idx.group">group</a> for the previous entry (in the same hierarchical level), a <a id="wrglossary.9810"></a><a href="#glo:idx.group">group</a> header is added (which may or may not be displayed, depending on the <a id="wrglossary.9811"></a><a href="#glo:idx.glossarystyle">glossary style</a>). This means than an unordered list of entries, such as in the above example, may contain repeated headers.<p>
+The way that the <a id="wrglossary.9812"></a><a href="#glo:idx.group">group</a> is determined depends on whether or not the <a id="wrglossary.9813"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a> key has been defined. If it isn’t defined (the default), then the <a id="wrglossary.9814"></a><a href="#glo:idx.group">group</a> label is obtained from the <a id="wrglossary.9815"></a><a href="#glo:idx.uppercase">uppercase</a> character code of the first token of the <a id="wrglossary.9816"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key. If the token doesn’t have an <a id="wrglossary.9817"></a><a href="#glo:idx.uppercase">uppercase</a> character code (indicating that it’s not a letter) or if the sort value is empty then the label will be set to <code class="code">glssymbols</code> (which corresponds to the symbol <a id="wrglossary.9818"></a><a href="#glo:idx.group">group</a>). This is the same way that <a id="wrglossary.9819"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a> inserts <a id="wrglossary.9820"></a><a href="#glo:idx.group">groups</a>.<p>
+Remember that if the <a id="wrglossary.9821"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key hasn’t been set, it will be assigned automatically to the same value as the <a id="wrglossary.9822"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key (or with <a id="wrglossary.9823"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=use</span> or <a id="wrglossary.9824"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=def</span> to a numerical value). The <a id="wrglossary.9825"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key will be empty if you use <a id="wrglossary.9826"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=clear</span>. The <a id="wrglossary.9827"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=none</span> setting simply skips the pre-processing of the <a id="wrglossary.9828"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key (such as sanitizing).<p>
+For example, the ant entry doesn’t explicitly use the <a id="wrglossary.9829"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key, so the sort value is obtained from the <a id="wrglossary.9830"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key, which is set to <code class="code">ant</code>. The first token is <span class="qt">“a”</span>, which is a letter. The <a id="wrglossary.9831"></a><a href="#glo:idx.group">group’s</a> label is obtained from the letter’s <a id="wrglossary.9832"></a><a href="#glo:idx.uppercase">uppercase</a> character decimal code (65). There’s no associated title (which can be assigned with <a id="wrglossary.9833"></a><a href="#glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></a>), so the title is simply <span class="qt">“65”</span> (with <a id="wrglossary.9834"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a>, see earlier) or <span class="qt">“A”</span> (without <a id="wrglossary.9835"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a> or with <a id="wrglossary.9836"></a><a href="#glo:glsxtrnoidxgroups"><code class="csfmt">\glsxtrnoidxgroups</code></a>). <p>
+The ant entry is followed by <span class="qt">“adder”</span>. The same process determines that the <span class="qt">“adder”</span> <a id="wrglossary.9837"></a><a href="#glo:idx.group">group</a> label is also 65. There’s no change in the <a id="wrglossary.9838"></a><a href="#glo:idx.group">group</a> label from the previous entry (ant) so no header is inserted.<p>
+By default, this <a id="wrglossary.9839"></a><a href="#glo:idx.group">group</a> check is omitted for child entries, which is why no group header is inserted before duck or mallard. So the next entry to be checked for a <a id="wrglossary.9840"></a><a href="#glo:idx.group">group</a> is the zebra entry, which has the group label 90 (the decimal code for <span class="qt">“Z”</span>). Again there’s no title associated with that label so the title is simply the label.<p>
+The zebra entry is followed by aardvark which, following the same process, has the <a id="wrglossary.9841"></a><a href="#glo:idx.group">group</a> label 65. This is different from the previous group label (90) so a group header is inserted. This is why there are two <span class="qt">“90”</span> letter <a id="wrglossary.9842"></a><a href="#glo:idx.group">groups</a>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The <a id="wrglossary.9843"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> don’t order the entries. </div><!-- end of important -->
+<p>
+If the <a id="wrglossary.9844"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a> key has been defined (which is the case with <a id="wrglossary.9845"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.9846"></a><a href="#glo:optval.record.only"><span class="optfmt">only</span></a> and <a id="wrglossary.9847"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.9848"></a><a href="#glo:optval.record.nameref"><span class="optfmt">nameref</span></a>) then the <a id="wrglossary.9849"></a><a href="#glo:idx.group">group</a> <span style="font-style: italic; font-variant: normal; ">label</span> is obtained from the <a id="wrglossary.9850"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a> field. If the <a id="wrglossary.9851"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a> field is defined but empty then the entry will belong to the empty group. The value of the <a id="wrglossary.9852"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> field is now irrelevant.<p>
+So, simply adding the <a id="wrglossary.9853"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a> option to the above example document will cause the group headers to disappear. This is because the <a id="wrglossary.9854"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a> key will now be defined but is empty for each entry. Even with a style like <a id="wrglossary.9855"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a>, there won’t be any <a id="wrglossary.9856"></a><a href="#glo:idx.group">group</a> headers.<p>
+Provided the <a id="wrglossary.9857"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a> key has been defined, the field used to store the <a id="wrglossary.9858"></a><a href="#glo:idx.group">group</a> label is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9859"></a><code class="code"><dfn id="glo:glsxtrgroupfield"><code class="csfmt">\glsxtrgroupfield</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>group</span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This expands to <code class="code">group</code>, by default. However it’s possible to use a different field in which to store the group label, in which case <a id="wrglossary.9860"></a><a href="#glo:glsxtrgroupfield"><code class="csfmt">\glsxtrgroupfield</code></a> will need to be redefined. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>{<a id="wrglossary.9861"></a><a href="#glo:renewcommand"><code class="csfmt">\renewcommand</code></a>{<a id="wrglossary.9862"></a><a href="#glo:glsxtrgroupfield"><code class="csfmt">\glsxtrgroupfield</code></a>}{othergroup}<a id="wrglossary.9863"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>}
+</pre> or <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.9864"></a><a href="#glo:printunsrtglossary*"><code class="csfmt">\printunsrtglossary*</code></a>{<a id="wrglossary.9865"></a><a href="#glo:renewcommand"><code class="csfmt">\renewcommand</code></a>{<a id="wrglossary.9866"></a><a href="#glo:glsxtrgroupfield"><code class="csfmt">\glsxtrgroupfield</code></a>}{othergroup}}
+</pre> (but this still requires the <a id="wrglossary.9867"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a> key to be defined, even if it’s not being used to store the <a id="wrglossary.9868"></a><a href="#glo:idx.group">group</a> label). With <a id="wrglossary.9869"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the <a id="wrglossary.9870"></a><a href="#glo:opt.resource.secondary"><span class="csoptfmt">secondary</span></a> resource option (combined with <a id="wrglossary.9871"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a>) will store the <a id="wrglossary.9872"></a><a href="#glo:idx.group">group</a> label obtained from the secondary sort in the <a id="wrglossary.9873"></a><a href="#glo:opt.glosfield.secondarygroup"><span class="csoptfmt">secondarygroup</span></a> field and adds the redefinition of <a id="wrglossary.9874"></a><a href="#glo:glsxtrgroupfield"><code class="csfmt">\glsxtrgroupfield</code></a> to the associated <a id="wrglossary.9875"></a><a href="#glo:dual.glossary">glossary</a> preamble. This prevents it from clashing with the <a id="wrglossary.9876"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a> field in the event that the secondary sort method has produced a different set of <a id="wrglossary.9877"></a><a href="#glo:idx.group">groups</a> (which is likely).<p>
+The follow example document uses <a id="wrglossary.9878"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a> to create the <a id="wrglossary.9879"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a> key and assigns <a id="wrglossary.9880"></a><a href="#glo:idx.group">group</a> labels with associated titles. Note that the <a id="wrglossary.9881"></a><a href="#glo:opt.glosfield.secondarygroup"><span class="csoptfmt">secondarygroup</span></a> field doesn’t have an associated key, so it needs to be set with a field assignment command, such as <a id="wrglossary.9882"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>. <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.9883"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>,<a id="wrglossary.9884"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a><span class="optfmt">=bookindex</span>,<a id="wrglossary.9885"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.9886"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a></span>]{glossaries-extra}
+
+<a id="wrglossary.9887"></a><a href="#glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></a>{group1label}{Group 1}<br><a id="wrglossary.9888"></a><a href="#glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></a>{group2label}{Group 2}<br><a id="wrglossary.9889"></a><a href="#glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></a>{group3label}{Group 3}<br><a id="wrglossary.9890"></a><a href="#glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></a>{group4label}{Group 4}<br>
+<a id="wrglossary.9891"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{waterfowl}{<a id="wrglossary.9892"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={waterfowl}</span>,<a id="wrglossary.9893"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,<br> <a id="wrglossary.9894"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a><span class="optfmt">={group1label}</span>}<br><a id="wrglossary.9895"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{ant}{<a id="wrglossary.9896"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={ant}</span>,<a id="wrglossary.9897"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,<br> <a id="wrglossary.9898"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a><span class="optfmt">={group1label}</span>}<br><a id="wrglossary.9899"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>{ant}{<a id="wrglossary.9900"></a><a href="#glo:opt.glosfield.secondarygroup"><span class="csoptfmt">secondarygroup</span></a>}{group4label}<br><a id="wrglossary.9901"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{adder}{<a id="wrglossary.9902"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={adder}</span>,<a id="wrglossary.9903"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,<br> <a id="wrglossary.9904"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a><span class="optfmt">={group2label}</span>}<br><a id="wrglossary.9905"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{duck}{<a id="wrglossary.9906"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,<a id="wrglossary.9907"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={waterfowl}</span>,<br> <a id="wrglossary.9908"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,<a id="wrglossary.9909"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a><span class="optfmt">={group4label}</span>}<br><a id="wrglossary.9910"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>{duck}{<a id="wrglossary.9911"></a><a href="#glo:opt.glosfield.secondarygroup"><span class="csoptfmt">secondarygroup</span></a>}{group2label}<br><a id="wrglossary.9912"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{zebra}{<a id="wrglossary.9913"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={zebra}</span>,<a id="wrglossary.9914"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,<br> <a id="wrglossary.9915"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a><span class="optfmt">={group2label}</span>}<br><a id="wrglossary.9916"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>{zebra}{<a id="wrglossary.9917"></a><a href="#glo:opt.glosfield.secondarygroup"><span class="csoptfmt">secondarygroup</span></a>}{group3label}<br><a id="wrglossary.9918"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{aardvark}{<a id="wrglossary.9919"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={aardvark}</span>,<a id="wrglossary.9920"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,<br> <a id="wrglossary.9921"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a><span class="optfmt">={group2label}</span>}<br><a id="wrglossary.9922"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>{aardvark}{<a id="wrglossary.9923"></a><a href="#glo:opt.glosfield.secondarygroup"><span class="csoptfmt">secondarygroup</span></a>}{group1label}<br><a id="wrglossary.9924"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{gazelle}{<a id="wrglossary.9925"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={gazelle}</span>,<a id="wrglossary.9926"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,<br> <a id="wrglossary.9927"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a><span class="optfmt">={group1label}</span>}<br><a id="wrglossary.9928"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{mallard}{<a id="wrglossary.9929"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={mallard}</span>,<a id="wrglossary.9930"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={duck}</span>,<br> <a id="wrglossary.9931"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,<a id="wrglossary.9932"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a><span class="optfmt">={group2label}</span>}
+<a id="wrglossary.9933"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>{mallard}{<a id="wrglossary.9934"></a><a href="#glo:opt.glosfield.secondarygroup"><span class="csoptfmt">secondarygroup</span></a>}{group3label}<br>
+<a id="wrglossary.9935"></a><a href="#glo:newglossary*"><code class="csfmt">\newglossary*</code></a>{another}{Another Glossary}<br><a id="wrglossary.9936"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a>{mallard}{another}<br><a id="wrglossary.9937"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a>{aardvark}{another}<br><a id="wrglossary.9938"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a>{zebra}{another}<br><a id="wrglossary.9939"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a>{ant}{another}<br><a id="wrglossary.9940"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a>{duck}{another}<br><a id="wrglossary.9941"></a><a href="#glo:setglossarypreamble"><code class="csfmt">\setglossarypreamble</code></a>[another]{<code class="cmd">\renewcommand</code>{<a id="wrglossary.9942"></a><a href="#glo:glsxtrgroupfield"><code class="csfmt">\glsxtrgroupfield</code></a>}{secondarygroup}}
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.9943"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>
+<a id="wrglossary.9944"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<a id="wrglossary.9945"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=another</span>]
+<code class="cend">\end{document}</code>
+</pre> This is essentially mimicking the way that the <a id="wrglossary.9946"></a><a href="#glo:opt.resource.secondary"><span class="csoptfmt">secondary</span></a> resource option sets the <a id="wrglossary.9947"></a><a href="#glo:opt.glosfield.secondarygroup"><span class="csoptfmt">secondarygroup</span></a> field and adds the redefinition of <a id="wrglossary.9948"></a><a href="#glo:glsxtrgroupfield"><code class="csfmt">\glsxtrgroupfield</code></a> to the secondary <a id="wrglossary.9949"></a><a href="#glo:dual.glossary">glossary’s</a> preamble. (Although in this case, there’s no logical order.) The result is shown in Example <a href="#ex:unsrtcustomgrp">138</a>. <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:unsrtcustomgrp"></a>Example 138: Displaying unsorted glossaries with custom groups <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example138.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example138.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example138.png" type="image/png" width="318" height="302">Example document that doesn’t require any external indexing and has the group labels explicitly set.</object> </div><!-- end of resultbox -->
+<p>
+Note that even though the duck and mallard entries have the <a id="wrglossary.9950"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a> and <a id="wrglossary.9951"></a><a href="#glo:opt.glosfield.secondarygroup"><span class="csoptfmt">secondarygroup</span></a> fields set, there’s no group title for them in either <a id="wrglossary.9952"></a><a href="#glo:dual.glossary">glossary</a> because they are child entries.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9953"></a><code class="code"><dfn id="glo:glsxtraddgroup"><code class="csfmt">\glsxtraddgroup</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">code</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command will perform <span class="meta">〈<em class="metainner">code</em>〉</span> if the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> should have <a id="wrglossary.9954"></a><a href="#glo:idx.group">group</a> support (provided the <a id="wrglossary.9955"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a> field has been set). The default definition is: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.9956"></a><a href="#glo:glsxtraddgroup"><code class="csfmt">\glsxtraddgroup</code></a>}[2]{%
+ <a id="wrglossary.9957"></a><a href="#glo:ifglsxtrprintglossflatten"><code class="csfmt">\ifglsxtrprintglossflatten</code></a>
+ #2%
+ <code class="cmd">\else</code>
+ <a id="wrglossary.9958"></a><a href="#glo:ifglshasparent"><code class="csfmt">\ifglshasparent</code></a>{#1}{}{#2}%
+ <code class="cmd">\fi</code>
}
-</pre>
-<!--l. 11108--><p class="nopar" > In both cases, the redefinition should be implemented after <span
-class="cmtt-10">\GlsXtrEnableLinkCounting</span>.
-</p><!--l. 11112--><p class="indent" > Here&#8217;s an example document that uses link counting to disable the hyperlink after
-the first reference. This redefines <span
-class="cmtt-10">\glslinkpresetkeys</span><a
- id="dx1-74011"></a> (which is used by both <span
-class="cmtt-10">\gls</span>
-and <span
-class="cmtt-10">\glstext</span>) instead of <span
-class="cmtt-10">\glslinkcheckfirsthyperhook </span>(which is used by <span
-class="cmtt-10">\gls</span>
-but not by <span
-class="cmtt-10">\glstext</span>).
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-247">
-\documentclass{article}
-\usepackage[colorlinks]{hyperref}
-\usepackage{glossaries-extra}
-\makeglossaries
-\renewcommand*{\glslinkpresetkeys}{%
-&#x00A0;\ifnum\GlsXtrLinkCounterValue{\glslabel}&#x003E;1
-&#x00A0;&#x00A0;\setkeys{glslink}{hyper=false}%
-&#x00A0;\fi
+</pre> This means that only entries that don’t have a parent (with <a id="wrglossary.9959"></a><a href="#glo:opt.printgloss.flatten"><span class="csoptfmt">flatten</span></a><span class="optfmt">=false</span>) or any entry (with <a id="wrglossary.9960"></a><a href="#glo:opt.printgloss.flatten"><span class="csoptfmt">flatten</span></a><span class="optfmt">=true</span>) will have the <a id="wrglossary.9961"></a><a href="#glo:idx.group">group</a> check performed. With <a id="wrglossary.9962"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the <a id="wrglossary.9963"></a><a href="#glo:opt.resource.group-level"><span class="csoptfmt">group-level</span></a> will redefine <a id="wrglossary.9964"></a><a href="#glo:glsxtraddgroup"><code class="csfmt">\glsxtraddgroup</code></a> to always do <span class="meta">〈<em class="metainner">code</em>〉</span>, which means that all entries will have the <a id="wrglossary.9965"></a><a href="#glo:idx.group">group</a> check performed.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+If no group label has been provided no header will be added. </div><!-- end of important -->
+<p>
+The above document can be modified to show the sub-<a id="wrglossary.9966"></a><a href="#glo:idx.group">group</a> headings: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.9967"></a><a href="#glo:glsxtraddgroup"><code class="csfmt">\glsxtraddgroup</code></a>}[2]{#2}
+<a id="wrglossary.9968"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.9969"></a><a href="#glo:glsxtraddgroup"><code class="csfmt">\glsxtraddgroup</code></a>}[2]{%
+ <code class="cmd">\ifnum</code><a id="wrglossary.9970"></a><a href="#glo:glscurrententrylevel"><code class="csfmt">\glscurrententrylevel</code></a>&lt;2 #2<code class="cmd">\fi</code>}
+<a id="wrglossary.9971"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<a id="wrglossary.9972"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=another</span>]
+</pre> The result is shown in Example <a href="#ex:unsrtcustomsubgrp">139</a>. <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:unsrtcustomsubgrp"></a>Example 139: Displaying unsorted glossaries with custom groups and sub-group headings <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example139.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example139.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example139.png" type="image/png" width="318" height="324">Example document that doesn’t require any external indexing and has the group labels explicitly set with sub-group headings.</object> </div><!-- end of resultbox -->
+<p>
+Note that the mallard entry (which has <a id="wrglossary.9973"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> 2) has its group shown in the first <a id="wrglossary.9974"></a><a href="#glo:dual.glossary">glossary</a> (where the group is formed for all levels) but not in the second <a id="wrglossary.9975"></a><a href="#glo:dual.glossary">glossary</a> (where the redefinition of <a id="wrglossary.9976"></a><a href="#glo:glsxtraddgroup"><code class="csfmt">\glsxtraddgroup</code></a> restricts <a id="wrglossary.9977"></a><a href="#glo:idx.group">group</a> formation to just level 0 and level 1).<p>
+There’s a small visual distinction between the <a id="wrglossary.9978"></a><a href="#glo:idx.group">group</a> titles in different <a id="wrglossary.9979"></a><a href="#glo:dual.hierarchicallevel">hierarchical levels</a> in the above. The top-level (level 0) groups have the title centred, whereas the sub-groups have their titles indented by the same amount as the corresponding sub-entries. This is due to the <a id="wrglossary.9980"></a><a href="#glo:idx.glossarystyle">glossary style</a>. Other styles may use the same formatting for all <a id="wrglossary.9981"></a><a href="#glo:dual.hierarchicallevel">hierarchical levels</a>.<p>
+The <a id="wrglossary.9982"></a><a href="#glo:idx.glossarystyle">glossary styles</a> provided with <a id="wrglossary.9983"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and the base styles patched by <a id="wrglossary.9984"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> all redefine: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.9985"></a><code class="code"><dfn id="glo:glssubgroupheading"><code class="csfmt">\glssubgroupheading</code></dfn>{<span class="meta">〈<em class="metainner">previous level</em>〉</span>}{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">parent-label</em>〉</span>}{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ to format the sub-group headings in a manner applicable to the style. For example, styles that don’t show sub-entry names typically redefine this command to do nothing.<p>
+A default definition that simply does <code class="code"><a id="wrglossary.9986"></a><a href="#glo:glsgroupheading"><code class="csfmt">\glsgroupheading</code></a>{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}</code> is automatically initialised by <a id="wrglossary.9987"></a><a href="#glo:setglossarystyle"><code class="csfmt">\setglossarystyle</code></a> (via <a id="wrglossary.9988"></a><a href="#glo:glsxtrpreglossarystyle"><code class="csfmt">\glsxtrpreglossarystyle</code></a>) to allow for styles that don’t redefine this command. The first two arguments refer to the <a id="wrglossary.9989"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a>, where <span class="meta">〈<em class="metainner">previous level</em>〉</span> is the level of the previous <a id="wrglossary.9990"></a><a href="#glo:idx.group">group</a> and <span class="meta">〈<em class="metainner">level</em>〉</span> is the level of this new sub-<a id="wrglossary.9991"></a><a href="#glo:idx.group">group</a>. The <span class="meta">〈<em class="metainner">parent-label</em>〉</span> is the label of the current entry’s parent, where the current entry is the first entry of the sub-<a id="wrglossary.9992"></a><a href="#glo:idx.group">group</a> that immediately follows the heading.<p>
+The <a id="wrglossary.9993"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style defines <a id="wrglossary.9994"></a><a href="#glo:glssubgroupheading"><code class="csfmt">\glssubgroupheading</code></a> to use the style’s associated command <a id="wrglossary.9995"></a><a href="#glo:glsxtrbookindexformatsubheader"><code class="csfmt">\glsxtrbookindexformatsubheader</code></a>. This can be redefined as required. For example, the following uses the parent entry’s hierarchical information: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.9996"></a><a href="#glo:glsxtrbookindexformatsubheader"><code class="csfmt">\glsxtrbookindexformatsubheader</code></a>}[5]{%
+ <code class="cmd">\ifnum</code>#2&gt;1<a id="wrglossary.9997"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a>
+ <a id="wrglossary.9998"></a><a href="#glo:glstreesubsubitem"><code class="csfmt">\glstreesubsubitem</code></a><a id="wrglossary.9999"></a><a href="#glo:glstreegroupheaderfmt"><code class="csfmt">\glstreegroupheaderfmt</code></a>{<a id="wrglossary.10000"></a><a href="#glo:GlsXtrhiername"><code class="csfmt">\GlsXtrhiername</code></a>{#3} / #5}%
+ <code class="cmd">\else</code>
+ <a id="wrglossary.10001"></a><a href="#glo:glstreesubitem"><code class="csfmt">\glstreesubitem</code></a><a id="wrglossary.10002"></a><a href="#glo:glstreegroupheaderfmt"><code class="csfmt">\glstreegroupheaderfmt</code></a>{<a id="wrglossary.10003"></a><a href="#glo:GlsXtrhiername"><code class="csfmt">\GlsXtrhiername</code></a>{#3} / #5}%
+ <code class="cmd">\fi</code>
}
-\GlsXtrEnableLinkCounting{general}
-\newglossaryentry{sample1}{name={sample1},description={an&#x00A0;example}}
-\newglossaryentry{sample2}{name={sample2},description={another&#x00A0;example}}
-\newabbreviation{ex}{ex}{example}
-\begin{document}
-\section{Sample&#x00A0;Section}
-\Gls{sample1},&#x00A0;\gls{sample2}&#x00A0;and&#x00A0;\gls{ex}.
-\Glstext{sample1}&#x00A0;and&#x00A0;\gls{ex}&#x00A0;again.
-\section{Another&#x00A0;Sample&#x00A0;Section}
-\Gls{sample1},&#x00A0;\gls{sample2}&#x00A0;and&#x00A0;\gls{ex}.
-\printglossaries
-\end{document}
-</pre>
-<!--l. 11154--><p class="nopar" > The use of <span
-class="cmtt-10">\glslinkpresetkeys</span><a
- id="dx1-74012"></a> means that the options can override this. For
-example
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-248">
-\gls[hyper=true]{sample1}
-</pre>
-<!--l. 11159--><p class="nopar" > will override the <span
-class="cmtt-10">hyper=false </span>setting in <span
-class="cmtt-10">\glslinkpresetkeys</span><a
- id="dx1-74013"></a>. If <span
-class="cmtt-10">\glslinkpostsetkeys</span><a
- id="dx1-74014"></a>
-is used instead, the <span
-class="cmtt-10">hyper=false </span>setting will override the setting provided in the
-optional argument.
-</p><!--l. 11165--><p class="indent" > The <span
-class="cmss-10">abbreviation</span><a
- id="dx1-74015"></a> category doesn&#8217;t have the <a
-href="#catattr.linkcount"><span
-class="cmss-10">linkcount</span></a><a
- id="dx1-74016"></a> attribute set (since it&#8217;s not
-listed in the argument of <span
-class="cmtt-10">\GlsXtrEnableLinkCounting</span>). This means that
-<span
-class="cmtt-10">\GlsXtrLinkCounterValue </span>always expands to 0 for the abbreviation (<span
-class="cmtt-10">ex</span>), so the
-inequality test
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-249">
-\ifnum\GlsXtrLinkCounterValue{\glslabel}&#x003E;1
-</pre>
-<!--l. 11173--><p class="nopar" > will always be false. This means that the abbreviation won&#8217;t have <span
-class="cmtt-10">hyper=false</span>
-applied. If the test is changed to
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-250">
-\ifnum\GlsXtrLinkCounterValue{\glslabel}=1
-\else
-&#x00A0;\setkeys{glslink}{hyper=false}%
-\fi
-</pre>
-<!--l. 11181--><p class="nopar" > Then the abbreviation will always have <span
-class="cmtt-10">hyper=false </span>applied.
-</p><!--l. 11185--><p class="indent" > To reset the counter every section use the optional argument to set the master
-counter:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-251">
-\GlsXtrEnableLinkCounting[section]{general}
-</pre>
-<!--l. 11189--><p class="nopar" >
-
-
-
-</p>
-<!--l. 11191--><p class="indent" > </div>
-</p><!--l. 11191--><p class="noindent" ><a
-href="#top">Top</a><div class="chapter"><h2 class="chapterHead">9. <a
- id="sec:autoindex"></a>Auto-Indexing</h2>
-</p><!--l. 11194--><p class="indent" > It&#8217;s possible that you may also want a normal index as well as the glossary,
-and you may want entries to automatically be added to the index (as in
-this document). There are two attributes that govern this: <a
-href="#catattr.indexname"><span
-class="cmss-10">indexname</span></a><a
- id="dx1-75001"></a> and
-<a
-href="#catattr.dualindex"><span
-class="cmss-10">dualindex</span></a><a
- id="dx1-75002"></a>.
-</p><!--l. 11200--><p class="indent" > <div class="important" title="Important Note"> The auto-indexing is designed for <a
- id="dx1-75003"></a><a
-href="#glo:makeindex"><span
-class="cmtt-10">makeindex</span></a> syntax. If you&#8217;ve used the <a
-href="#styopt.xindy"><span
-class="cmss-10">xindy</span></a><a
- id="dx1-75004"></a>
-package option, the automatic escaping of <a
- id="dx1-75005"></a><a
-href="#glo:xindy"><span
-class="cmtt-10">xindy</span></a> special characters in the <span
-class="cmss-10">sort</span><a
- id="dx1-75006"></a> field
-may result in an incorrect sort value for the <span
-class="cmtt-10">\index </span>command used by the
-auto-indexing. Note also that <span
-class="cmtt-10">texindy</span><a
- id="dx1-75007"></a> has a fixed set of special characters
-(corresponding to <a
- id="dx1-75008"></a><span
-class="cmtt-10">makeindex</span>&#8217;s defaults) that can&#8217;t be customized. You may want
-to consider using <a
- id="dx1-75009"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> and its dual entries as an alternative approach.
-</div>
-</p><!--l. 11209--><p class="noindent" >
-</p><!--l. 11212--><p class="indent" > The <span
-class="cmtt-10">\glsxtrpostnamehook</span><a
- id="dx1-75010"></a> macro, used at the end of <span
-class="cmtt-10">\glossentryname</span><a
- id="dx1-75011"></a> and
-<span
-class="cmtt-10">\Glossentryname</span><a
- id="dx1-75012"></a>, checks the <a
-href="#catattr.indexname"><span
-class="cmss-10">indexname</span></a><a
- id="dx1-75013"></a> attribute for the category associated with
-that entry. Since <span
-class="cmtt-10">\glossentryname </span>is used in the default glossary styles, this
-makes a convenient way of automatically indexing each entry name at its
-location in the glossary without fiddling around with the value of the <span
-class="cmss-10">name</span><a
- id="dx1-75014"></a>
-key.
-</p><!--l. 11222--><p class="indent" > The internal macro used by the <span
-class="cmss-10">glossaries </span>package to write the information to the
-external glossary file is modified to check for the <a
-href="#catattr.dualindex"><span
-class="cmss-10">dualindex</span></a><a
- id="dx1-75015"></a> attribute.
-</p><!--l. 11226--><p class="indent" > In both cases, the indexing is done through
-</p><!--l. 11227--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-75016"></a> <span
-class="cmtt-10">\glsxtrdoautoindexname{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">attribute-label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11229--><p class="noindent" >
-This uses the standard <span
-class="cmtt-10">\index</span><a
- id="dx1-75017"></a> command with the sort value taken from the entry&#8217;s
-<span
-class="cmss-10">sort</span><a
- id="dx1-75018"></a> key and the actual value set to <span
-class="cmtt-10">\glsentryname{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>. As from v1.16, there are
-user-level commands available to change the sort and actual value used by the
-automated index.
-</p><!--l. 11236--><p class="indent" > The actual value is given by
-</p><!--l. 11237--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-75019"></a> <span
-class="cmtt-10">\glsxtrautoindexentry{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11239--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; is the entry&#8217;s label. The default definition is:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-252">
-\newcommand*{\glsxtrautoindexentry}[1]{\string\glsentryname{#1}}
-</pre>
-<!--l. 11244--><p class="nopar" > Note the use of <span
-class="cmtt-10">\string </span>to prevent <span
-class="cmtt-10">\glsentryname </span>from being expanded as it&#8217;s
-written to the index file.
-</p><!--l. 11248--><p class="indent" > The sort value is assigned using:
-</p><!--l. 11249--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-75020"></a> <span
-class="cmtt-10">\glsxtrautoindexassignsort{</span>&#x27E8;<span
-class="cmitt-10">cs</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11251--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; is the entry label and &#x27E8;<span
-class="cmti-10">cs</span>&#x27E9; is the command which needs to be set to the
-sort value. The default definition is:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-253">
-\newcommand*{\glsxtrautoindexassignsort}[2]{%
-&#x00A0;&#x00A0;\glsletentryfield{#1}{#2}{sort}%
+</pre><p>
+The above examples are contrived and demonstrate the need to define entries in a sensible order to achieve a sensible <a id="wrglossary.10004"></a><a href="#glo:dual.glossary">glossary</a> with <a id="wrglossary.10005"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>. If you want to use this approach to display a <a id="wrglossary.10006"></a><a href="#glo:dual.glossary">glossary</a>, you would need to make sure that you take care with the order that you define entries. This can be quite tedious for a large number of entries.<p>
+To switch to <a id="wrglossary.10007"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the entry data needs to be provided in a <a id="wrglossary.10008"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file. For example, the file <span class="filefmt">animalfamilies.bib</span> might contain: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="code">@index</code>{waterfowl,<a id="wrglossary.10009"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={Anseriformes}</span>}<br><code class="code">@index</code>{ant,<a id="wrglossary.10010"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={Formicidae}</span>}<br><code class="code">@index</code>{adder,<a id="wrglossary.10011"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={Vipera berus}</span>}<br><code class="code">@index</code>{duck,<a id="wrglossary.10012"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={waterfowl}</span>,<a id="wrglossary.10013"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={Anatidae}</span>}<br><code class="code">@index</code>{zebra,<a id="wrglossary.10014"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={Hippotigris}</span>}<br><code class="code">@index</code>{aardvark,<a id="wrglossary.10015"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={Orycteropus afer}</span>}<br><code class="code">@index</code>{gazelle,<a id="wrglossary.10016"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={Gazella}</span>}<br><code class="code">@index</code>{mallard,<a id="wrglossary.10017"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={duck}</span>,<a id="wrglossary.10018"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={Anas platyrhynchos}</span>}
+</pre> I’ve included some additional information stored in the <a id="wrglossary.10019"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> field that wasn’t in the earlier examples. The document needs to use the <a id="wrglossary.10020"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a> option and <a id="wrglossary.10021"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a> in order for it to work properly with <a id="wrglossary.10022"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.10023"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>,<a id="wrglossary.10024"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a><span class="optfmt">=bookindex</span>,<a id="wrglossary.10025"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=bookindex</span>]
+ {glossaries-extra}
+<a id="wrglossary.10026"></a><a href="#glo:newglossary*"><code class="csfmt">\newglossary*</code></a>{another}{Another Glossary}
+<a id="wrglossary.10027"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.10028"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">=all</span>,<span class="comment">% select all entries</span>
+ <a id="wrglossary.10029"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">={animalfamilies}</span>,<span class="comment">% identify bib file(s)</span>
+ <a id="wrglossary.10030"></a><a href="#glo:opt.resource.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=en-GB</span>,<span class="comment">% sort method</span>
+ <a id="wrglossary.10031"></a><a href="#glo:opt.resource.secondary"><span class="csoptfmt">secondary</span></a><span class="optfmt">={la:user1:another}</span><span class="comment">% sort again and copy to `another'</span>
+]
+<a id="wrglossary.10032"></a><a href="#glo:glsdefpostname"><code class="csfmt">\glsdefpostname</code></a>{<a id="wrglossary.10033"></a><a href="#glo:opt.cat.index"><span class="csoptfmt">index</span></a>}{
+ (<code class="cmd">\emph</code>{<a id="wrglossary.10034"></a><a href="#glo:glsentryuseri"><code class="csfmt">\glsentryuseri</code></a>{<a id="wrglossary.10035"></a><a href="#glo:glscurrententrylabel"><code class="csfmt">\glscurrententrylabel</code></a>}})}
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.10036"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>
+<a id="wrglossary.10037"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<a id="wrglossary.10038"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=another</span>]
+<code class="cend">\end{document}</code>
+</pre> If this code is saved in the file <span class="filefmt">myDoc.tex</span> then the build process is now: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
+bib2gls <a id="wrglossary.10039"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> myDoc
+pdflatex myDoc
+</pre> The <a id="wrglossary.10040"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> (or <a id="wrglossary.10041"></a><a href="#glo:switch.group"><span class="shortargfmt">-g</span></a>) switch is important as it instructs <a id="wrglossary.10042"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to set the <a id="wrglossary.10043"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a> field for the primary sort and the <a id="wrglossary.10044"></a><a href="#glo:opt.glosfield.secondarygroup"><span class="csoptfmt">secondarygroup</span></a> for the secondary sort. The primary sort will sort entries according to <code class="code">en-GB</code> (British English). This can simply be set to <code class="code">en</code> without a region. The secondary sort will resort the entries, but this time according to <code class="code">la</code> (Latin) using the <a id="wrglossary.10045"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key as the sort value. The entry labels will then be copied to the custom <code class="code">another</code> glossary.<p>
+The <a id="wrglossary.10046"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file created by <a id="wrglossary.10047"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> (which will then be input by <a id="wrglossary.10048"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a> on the subsequent LaTeX run) essentially contains the following code: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.10049"></a><a href="#glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></a>{6881280}{W}
+<a id="wrglossary.10050"></a><a href="#glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></a>{5832704}{G}
+<a id="wrglossary.10051"></a><a href="#glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></a>{5373952}{A}
+<a id="wrglossary.10052"></a><a href="#glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></a>{7077888}{Z}
+<a id="wrglossary.10053"></a><a href="#glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></a>{another5373952}{A}
+<a id="wrglossary.10054"></a><a href="#glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></a>{another5767168}{F}
+<a id="wrglossary.10055"></a><a href="#glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></a>{another6356992}{O}
+<a id="wrglossary.10056"></a><a href="#glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></a>{another5898240}{H}
+<a id="wrglossary.10057"></a><a href="#glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></a>{another6815744}{V}
+<a id="wrglossary.10058"></a><a href="#glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></a>{another5832704}{G}
+
+<a id="wrglossary.10059"></a><a href="#glo:longnewglossaryentry*"><code class="csfmt">\longnewglossaryentry*</code></a>{aardvark}{<a id="wrglossary.10060"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={aardvark}</span>,
+ <a id="wrglossary.10061"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={Orycteropus afer}</span>,<a id="wrglossary.10062"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a><span class="optfmt">={5373952}</span>}{}
+<a id="wrglossary.10063"></a><a href="#glo:longnewglossaryentry*"><code class="csfmt">\longnewglossaryentry*</code></a>{adder}{<a id="wrglossary.10064"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={adder}</span>,
+ <a id="wrglossary.10065"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={Vipera berus}</span>,<a id="wrglossary.10066"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a><span class="optfmt">={5373952}</span>}{}
+<a id="wrglossary.10067"></a><a href="#glo:longnewglossaryentry*"><code class="csfmt">\longnewglossaryentry*</code></a>{ant}{<a id="wrglossary.10068"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={ant}</span>,
+ <a id="wrglossary.10069"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={Formicidae}</span>,<a id="wrglossary.10070"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a><span class="optfmt">={5373952}</span>}{}
+<a id="wrglossary.10071"></a><a href="#glo:longnewglossaryentry*"><code class="csfmt">\longnewglossaryentry*</code></a>{gazelle}{<a id="wrglossary.10072"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={gazelle}</span>,
+ <a id="wrglossary.10073"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={Gazella}</span>,<a id="wrglossary.10074"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a><span class="optfmt">={5832704}</span>}{}
+<a id="wrglossary.10075"></a><a href="#glo:longnewglossaryentry*"><code class="csfmt">\longnewglossaryentry*</code></a>{waterfowl}{<a id="wrglossary.10076"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={waterfowl}</span>,
+ <a id="wrglossary.10077"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={Anseriformes}</span>,<a id="wrglossary.10078"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a><span class="optfmt">={6881280}</span>}{}
+<a id="wrglossary.10079"></a><a href="#glo:longnewglossaryentry*"><code class="csfmt">\longnewglossaryentry*</code></a>{duck}{<a id="wrglossary.10080"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
+ <a id="wrglossary.10081"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={waterfowl}</span>,<a id="wrglossary.10082"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={Anatidae}</span>,<a id="wrglossary.10083"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a><span class="optfmt">={}</span>}{}
+<a id="wrglossary.10084"></a><a href="#glo:longnewglossaryentry*"><code class="csfmt">\longnewglossaryentry*</code></a>{mallard}{<a id="wrglossary.10085"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={mallard}</span>,
+ <a id="wrglossary.10086"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={duck}</span>,<a id="wrglossary.10087"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={Anas platyrhynchos}</span>,<a id="wrglossary.10088"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a><span class="optfmt">={}</span>}{}
+<a id="wrglossary.10089"></a><a href="#glo:longnewglossaryentry*"><code class="csfmt">\longnewglossaryentry*</code></a>{zebra}{<a id="wrglossary.10090"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={zebra}</span>,
+ <a id="wrglossary.10091"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={Hippotigris}</span>,<a id="wrglossary.10092"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a><span class="optfmt">={7077888}</span>}{}
+
+<a id="wrglossary.10093"></a><a href="#glo:apptoglossarypreamble"><code class="csfmt">\apptoglossarypreamble</code></a>[another]
+ {<code class="cmd">\renewcommand</code>{<a id="wrglossary.10094"></a><a href="#glo:glsxtrgroupfield"><code class="csfmt">\glsxtrgroupfield</code></a>}{<a id="wrglossary.10095"></a><a href="#glo:opt.glosfield.secondarygroup"><span class="csoptfmt">secondarygroup</span></a>}}
+<a id="wrglossary.10096"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a>{waterfowl}{another}
+<a id="wrglossary.10097"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>{waterfowl}{<a id="wrglossary.10098"></a><a href="#glo:opt.glosfield.secondarygroup"><span class="csoptfmt">secondarygroup</span></a>}{another5373952}
+<a id="wrglossary.10099"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a>{duck}{another}
+<a id="wrglossary.10100"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a>{mallard}{another}
+<a id="wrglossary.10101"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a>{ant}{another}
+<a id="wrglossary.10102"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>{ant}{<a id="wrglossary.10103"></a><a href="#glo:opt.glosfield.secondarygroup"><span class="csoptfmt">secondarygroup</span></a>}{another5767168}
+<a id="wrglossary.10104"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a>{gazelle}{another}
+<a id="wrglossary.10105"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>{gazelle}{<a id="wrglossary.10106"></a><a href="#glo:opt.glosfield.secondarygroup"><span class="csoptfmt">secondarygroup</span></a>}{another5832704}
+<a id="wrglossary.10107"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a>{zebra}{another}
+<a id="wrglossary.10108"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>{zebra}{<a id="wrglossary.10109"></a><a href="#glo:opt.glosfield.secondarygroup"><span class="csoptfmt">secondarygroup</span></a>}{another5898240}
+<a id="wrglossary.10110"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a>{aardvark}{another}
+<a id="wrglossary.10111"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>{aardvark}{<a id="wrglossary.10112"></a><a href="#glo:opt.glosfield.secondarygroup"><span class="csoptfmt">secondarygroup</span></a>}{another6356992}
+<a id="wrglossary.10113"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a>{adder}{another}
+<a id="wrglossary.10114"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>{adder}{<a id="wrglossary.10115"></a><a href="#glo:opt.glosfield.secondarygroup"><span class="csoptfmt">secondarygroup</span></a>}{another6815744}
+</pre><p>
+It’s more complicated than this as helper commands are provided to make it easier to customize and the entries will all have <a id="wrglossary.10116"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={index}</span> since they were defined with <code class="code">@index</code>, but this is basically like the preamble in the earlier examples, except that the ordering and <a id="wrglossary.10117"></a><a href="#glo:idx.group">groups</a> are more logical. The result is shown in Example <a href="#ex:bib2glsgrp">140</a>.<p>
+<div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:bib2glsgrp"></a>Example 140: Displaying sorted glossaries with groups using <span class="appfmt">bib2gls</span> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example140.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example140.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example140.png" type="image/png" width="381" height="371">Example document that uses bib2gls to created a two differently sorted lists with the same entries.</object> </div><!-- end of resultbox -->
+<p>
+Note that the <a id="wrglossary.10118"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a> and <a id="wrglossary.10119"></a><a href="#glo:opt.glosfield.secondarygroup"><span class="csoptfmt">secondarygroup</span></a> fields haven’t been set for the child entries (duck and mallard). This is the default behaviour and it means that regardless of the definition you provide for <a id="wrglossary.10120"></a><a href="#glo:glsxtraddgroup"><code class="csfmt">\glsxtraddgroup</code></a>, sub-groups won’t be displayed. If you want those fields set for child entries, you need to use the <a id="wrglossary.10121"></a><a href="#glo:opt.resource.group-level"><span class="csoptfmt">group-level</span></a> resource option. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.10122"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.10123"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">=all</span>,<span class="comment">% select all entries</span>
+ <strong class="strong"><a id="wrglossary.10124"></a><a href="#glo:opt.resource.group-level"><span class="csoptfmt">group-level</span></a><span class="optfmt">={&lt;=1}</span>,<span class="comment">% <a id="wrglossary.10125"></a><a href="#glo:@@glslabel@hierarchicallevel">level</a> 0 and 1</span></strong>
+ <a id="wrglossary.10126"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">={animalfamilies}</span>,<span class="comment">% identify bib file(s)</span>
+ <a id="wrglossary.10127"></a><a href="#glo:opt.resource.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=en-GB</span>,<span class="comment">% sort method</span>
+ <a id="wrglossary.10128"></a><a href="#glo:opt.resource.secondary"><span class="csoptfmt">secondary</span></a><span class="optfmt">={la:user1:another}</span><span class="comment">% sort again and copy</span>
+]
+</pre><p>
+This will add support for level 0 (no parent) and level 1 (parent but no grandparent) entries. Deeper levels won’t have support. The <a id="wrglossary.10129"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> switch is still required.<p>
+
+</section><!-- end of section sec:printunsrtgroups -->
+
+<section id="sec:printunsrtlocations"><!-- start of section sec:printunsrtlocations --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->8.4.2. Location Lists<div class="labellink"><a href="#sec:printunsrtlocations">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+The <a id="wrglossary.10130"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> check for the existence of the <a id="wrglossary.10131"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a> and <a id="wrglossary.10132"></a><a href="#glo:opt.glosfield.loclist"><span class="csoptfmt">loclist</span></a> keys. These are both defined by the <a id="wrglossary.10133"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a> option. (The <a id="wrglossary.10134"></a><a href="#glo:opt.glosfield.loclist"><span class="csoptfmt">loclist</span></a> field is also used by <a id="wrglossary.10135"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> but isn’t defined as a key.)<p>
+The <a id="wrglossary.10136"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a> field (if set) should contain the formatted <a id="wrglossary.10137"></a><a href="#glo:dual.locationlist">location list</a>. This is checked first and used if not empty. Otherwise the <a id="wrglossary.10138"></a><a href="#glo:opt.glosfield.loclist"><span class="csoptfmt">loclist</span></a> field (if set) is used, but that will use the same method as <a id="wrglossary.10139"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a> to format, which doesn’t compact consecutive locations.<p>
+It’s possible to choose a different field for the formatted <a id="wrglossary.10140"></a><a href="#glo:dual.locationlist">location list</a> by redefining: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10141"></a><code class="code"><dfn id="glo:GlsXtrLocationField"><code class="csfmt">\GlsXtrLocationField</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>location</span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This should expand to the <a id="wrglossary.10142"></a><a href="#glo:dual.internalfieldlabel">internal field label</a>. If the field is not the default <a id="wrglossary.10143"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a> then the test for <a id="wrglossary.10144"></a><a href="#glo:opt.glosfield.loclist"><span class="csoptfmt">loclist</span></a> is omitted.<p>
+Whichever field is used, the formatted <a id="wrglossary.10145"></a><a href="#glo:dual.locationlist">location list</a> is passed to the appropriate <a id="wrglossary.10146"></a><a href="#glo:idx.glossarystyle">glossary style</a> command (<a id="wrglossary.10147"></a><a href="#glo:glossentry"><code class="csfmt">\glossentry</code></a> or <a id="wrglossary.10148"></a><a href="#glo:subglossentry"><code class="csfmt">\subglossentry</code></a>) encapsulated with <a id="wrglossary.10149"></a><a href="#glo:glossaryentrynumbers"><code class="csfmt">\glossaryentrynumbers</code></a>.<p>
+If there’s no location field or if the tested fields are empty, then an empty argument (with no <a id="wrglossary.10150"></a><a href="#glo:glossaryentrynumbers"><code class="csfmt">\glossaryentrynumbers</code></a> encapsulator) is passed to the <a id="wrglossary.10151"></a><a href="#glo:idx.glossarystyle">glossary style</a> command. In this case, the <a id="wrglossary.10152"></a><a href="#glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></a> option is redundant as there’s no <a id="wrglossary.10153"></a><a href="#glo:dual.locationlist">location list</a> to suppress.<p>
+
+</section><!-- end of section sec:printunsrtlocations -->
+
+<section id="sec:printunsrtadvanced"><!-- start of section sec:printunsrtadvanced --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->8.4.3. Advanced Commands<div class="labellink"><a href="#sec:printunsrtadvanced">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+To provide a better understanding of how filtered and inner glossaries work, it’s useful to understand the difference between <a id="wrglossary.10154"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> (used with <a id="wrglossary.10155"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.10156"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>) and <a id="wrglossary.10157"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> (used with <a id="wrglossary.10158"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>).<p>
+In the first case, <a id="wrglossary.10159"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.10160"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> is used to create a file that contains content in the form: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.10161"></a><a href="#glo:glossarysection"><code class="csfmt">\glossarysection</code></a>[<a id="wrglossary.10162"></a><a href="#glo:glossarytoctitle"><code class="csfmt">\glossarytoctitle</code></a>]{<a id="wrglossary.10163"></a><a href="#glo:glossarytitle"><code class="csfmt">\glossarytitle</code></a>}<span class="comment">% </span>
+<a id="wrglossary.10164"></a><a href="#glo:glossarypreamble"><code class="csfmt">\glossarypreamble</code></a>
+<code class="cbeg">\begin{<a id="wrglossary.10165"></a><a href="#glo:env.theglossary"><span class="envfmt">theglossary</span></a>}</code><a id="wrglossary.10166"></a><a href="#glo:glossaryheader"><code class="csfmt">\glossaryheader</code></a>
+<span class="meta">〈<em class="metainner">content</em>〉</span>
+<code class="cend">\end{<a id="wrglossary.10167"></a><a href="#glo:env.theglossary"><span class="envfmt">theglossary</span></a>}</code><a id="wrglossary.10168"></a><a href="#glo:glossarypostamble"><code class="csfmt">\glossarypostamble</code></a>
+</pre> where <span class="meta">〈<em class="metainner">content</em>〉</span> contains lines such as: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.10169"></a><a href="#glo:glsgroupheading"><code class="csfmt">\glsgroupheading</code></a>{<span class="meta">〈<em class="metainner">group label</em>〉</span>}<a id="wrglossary.10170"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a> <a id="wrglossary.10171"></a><a href="#glo:glsresetentrylist"><code class="csfmt">\glsresetentrylist</code></a>
+<a id="wrglossary.10172"></a><a href="#glo:glossentry"><code class="csfmt">\glossentry</code></a>{<span class="meta">〈<em class="metainner">entry label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}<span class="comment">% </span>
+<a id="wrglossary.10173"></a><a href="#glo:subglossentry"><code class="csfmt">\subglossentry</code></a>{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">entry label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}<span class="comment">% </span>
+</pre><p>
+The <a id="wrglossary.10174"></a><a href="#glo:idx.group">group</a> headings (see §<a href="#sec:printunsrtgroups">8.4.1</a>) are typeset using <a id="wrglossary.10175"></a><a href="#glo:glsgroupheading"><code class="csfmt">\glsgroupheading</code></a>. Top-level entries are typeset with <a id="wrglossary.10176"></a><a href="#glo:glossentry"><code class="csfmt">\glossentry</code></a> and child entries are typeset with <a id="wrglossary.10177"></a><a href="#glo:subglossentry"><code class="csfmt">\subglossentry</code></a> where <span class="meta">〈<em class="metainner">level</em>〉</span> indicates the <a id="wrglossary.10178"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a>. Both <a id="wrglossary.10179"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.10180"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> order the items so that the child entries are placed immediately after the corresponding parent entry.<p>
+The <a id="wrglossary.10181"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> command essentially does: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><span class="meta">〈<em class="metainner">Set default title and style.</em>〉</span>
+<code class="cmd">\bgroup</code>
+ <span class="meta">〈<em class="metainner">Initial setup.</em>〉</span>
+ <span class="meta">〈<em class="metainner">Input the file created by <a id="wrglossary.10182"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.10183"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.</em>〉</span>
+<code class="cmd">\egroup</code>
+</pre><p>
+The initial setup part sets the <a id="wrglossary.10184"></a><a href="#glo:idx.glossarystyle">glossary style</a> (which determines the definitions of <a id="wrglossary.10185"></a><a href="#glo:env.theglossary"><span class="envfmt">theglossary</span></a>, <a id="wrglossary.10186"></a><a href="#glo:glossaryheader"><code class="csfmt">\glossaryheader</code></a>, <a id="wrglossary.10187"></a><a href="#glo:glsgroupheading"><code class="csfmt">\glsgroupheading</code></a>, <a id="wrglossary.10188"></a><a href="#glo:glossentry"><code class="csfmt">\glossentry</code></a> and <a id="wrglossary.10189"></a><a href="#glo:subglossentry"><code class="csfmt">\subglossentry</code></a>), assigns the title (<a id="wrglossary.10190"></a><a href="#glo:glossarytitle"><code class="csfmt">\glossarytitle</code></a> and <a id="wrglossary.10191"></a><a href="#glo:glossarytoctitle"><code class="csfmt">\glossarytoctitle</code></a>) and defines <a id="wrglossary.10192"></a><a href="#glo:currentglossary"><code class="csfmt">\currentglossary</code></a>. (There is some other stuff done both before and after the file is input, but that’s not relevant here.)<p>
+In the case of <a id="wrglossary.10193"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, there isn’t a glossary file to input. Instead, <a id="wrglossary.10194"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> is used to create a file that contains the entry definitions, which is input in the document preamble (via <a id="wrglossary.10195"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>). The entries are defined in the required order and use internal <a id="wrglossary.10196"></a><a href="#glo:dual.field">fields</a> to store the indexing information (such as the <a id="wrglossary.10197"></a><a href="#glo:idx.group">group</a> label and <a id="wrglossary.10198"></a><a href="#glo:dual.locationlist">location lists</a>). Now <a id="wrglossary.10199"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> is used to display the glossary, which essentially does: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><span class="meta">〈<em class="metainner">Set default title and style.</em>〉</span>
+<code class="cmd">\bgroup</code>
+ <span class="meta">〈<em class="metainner">Initial setup.</em>〉</span>
+ <a id="wrglossary.10200"></a><a href="#glo:glossarysection"><code class="csfmt">\glossarysection</code></a>[<a id="wrglossary.10201"></a><a href="#glo:glossarytoctitle"><code class="csfmt">\glossarytoctitle</code></a>]{<a id="wrglossary.10202"></a><a href="#glo:glossarytitle"><code class="csfmt">\glossarytitle</code></a>}<span class="comment">% </span>
+ <a id="wrglossary.10203"></a><a href="#glo:glossarypreamble"><code class="csfmt">\glossarypreamble</code></a>
+ <span class="meta">〈<em class="metainner">Construct internal control sequence containing glossary content.</em>〉</span>
+ <span class="meta">〈<em class="metainner">Expand internal control sequence.</em>〉</span>
+ <a id="wrglossary.10204"></a><a href="#glo:glossarypostamble"><code class="csfmt">\glossarypostamble</code></a>
+<code class="cmd">\egroup</code>
+</pre><p>
+The <span class="meta">〈<em class="metainner">initial setup</em>〉</span> is the same as for <a id="wrglossary.10205"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>. The key difference here is that there’s no file containing the typeset <a id="wrglossary.10206"></a><a href="#glo:dual.glossary">glossary</a> that can be simply input. Instead it’s necessary to iterate over the <a id="wrglossary.10207"></a><a href="#glo:dual.glossary">glossary’s</a> internal label list. Some of the <a id="wrglossary.10208"></a><a href="#glo:idx.glossarystyle">glossary styles</a> use a <a id="wrglossary.10209"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>-like environment (such as <a id="wrglossary.10210"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>, which is used by the <a id="wrglossary.10211"></a><a href="#glo:opt.glostyle.long"><span class="glostylefmt">long</span></a> styles). It’s always problematic having a loop inside a <a id="wrglossary.10212"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a> context so <a id="wrglossary.10213"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> by-passes the problem by moving the loop outside of the <a id="wrglossary.10214"></a><a href="#glo:env.theglossary"><span class="envfmt">theglossary</span></a> environment. The command iterates over all entry labels (in the order in which they were added to the <a id="wrglossary.10215"></a><a href="#glo:dual.glossary">glossary</a>) and constructs an internal control sequence (<a id="wrglossary.10216"></a><dfn id="glo:@glsxtr@doglossary"><code class="csfmt">\@glsxtr@doglossary</code></dfn>), which ends up containing: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cbeg">\begin{<a id="wrglossary.10217"></a><a href="#glo:env.theglossary"><span class="envfmt">theglossary</span></a>}</code><a id="wrglossary.10218"></a><a href="#glo:glossaryheader"><code class="csfmt">\glossaryheader</code></a><a id="wrglossary.10219"></a><a href="#glo:glsresetentrylist"><code class="csfmt">\glsresetentrylist</code></a>
+<span class="meta">〈<em class="metainner">content</em>〉</span>
+<code class="cend">\end{<a id="wrglossary.10220"></a><a href="#glo:env.theglossary"><span class="envfmt">theglossary</span></a>}</code>
+</pre><p>
+The <span class="meta">〈<em class="metainner">content</em>〉</span> in this case is different as it doesn’t explicitly contain <a id="wrglossary.10221"></a><a href="#glo:glossentry"><code class="csfmt">\glossentry</code></a> and <a id="wrglossary.10222"></a><a href="#glo:subglossentry"><code class="csfmt">\subglossentry</code></a> but instead uses an internal handler that just takes the entry label as the argument. The <code class="code"><a id="wrglossary.10223"></a><a href="#glo:glsgroupheading"><code class="csfmt">\glsgroupheading</code></a>{<span class="meta">〈<em class="metainner">group label</em>〉</span>}</code> command is inserted whenever a top-level entry has the group field set to a label that’s different to the previous top-level entry’s group field (and, if supported, sub-groups are similarly inserted with <a id="wrglossary.10224"></a><a href="#glo:glssubgroupheading"><code class="csfmt">\glssubgroupheading</code></a>, see §<a href="#sec:printunsrtgroups">8.4.1</a>). So the content is in the form: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.10225"></a><a href="#glo:glsgroupheading"><code class="csfmt">\glsgroupheading</code></a>{<span class="meta">〈<em class="metainner">group label</em>〉</span>}<span class="comment">% </span>
+<code class="cmd">\<span class="meta">〈<em class="metainner">internal cs handler</em>〉</span></code>{<span class="meta">〈<em class="metainner">entry label</em>〉</span>}<span class="comment">% </span>
+<code class="cmd">\<span class="meta">〈<em class="metainner">internal cs handler</em>〉</span></code>{<span class="meta">〈<em class="metainner">entry label</em>〉</span>}<span class="comment">% </span>
+…<a id="wrglossary.10226"></a><a href="#glo:glsgroupheading"><code class="csfmt">\glsgroupheading</code></a>{<span class="meta">〈<em class="metainner">group label</em>〉</span>}<span class="comment">% </span>
+<code class="cmd">\<span class="meta">〈<em class="metainner">internal cs handler</em>〉</span></code>{<span class="meta">〈<em class="metainner">entry label</em>〉</span>}<span class="comment">% </span>
+<code class="cmd">\<span class="meta">〈<em class="metainner">internal cs handler</em>〉</span></code>{<span class="meta">〈<em class="metainner">entry label</em>〉</span>}<span class="comment">% </span>
+…</pre><p>
+There are hooks and commands available for use within those hooks that may be adjusted to customize the way the <a id="wrglossary.10227"></a><a href="#glo:dual.glossary">glossary</a> is displayed. These are described below.<p>
+At each iteration (while the <a id="wrglossary.10228"></a><a href="#glo:dual.glossary">glossary</a> content is being constructed), the following steps are performed:
+<ol class="displaylist">
+ <li><span class="numitem">1.</span>Store the current entry label in <a id="wrglossary.10229"></a><a href="#glo:glscurrententrylabel"><code class="csfmt">\glscurrententrylabel</code></a>. <li><span class="numitem">2.</span>If <a id="wrglossary.10230"></a><a href="#glo:glscurrententrylabel"><code class="csfmt">\glscurrententrylabel</code></a> is empty, skip this iteration. <li><span class="numitem">3.</span>Define placeholder commands: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10231"></a><code class="code"><dfn id="glo:glscurrententrylevel"><code class="csfmt">\glscurrententrylevel</code></dfn></code></div><!-- end of pinnedbox -->
+ This is set to the current entry’s <a id="wrglossary.10232"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> (taking <a id="wrglossary.10233"></a><a href="#glo:opt.printgloss.leveloffset"><span class="csoptfmt">leveloffset</span></a> and <a id="wrglossary.10234"></a><a href="#glo:opt.printgloss.flatten"><span class="csoptfmt">flatten</span></a> options into account); <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10235"></a><code class="code"><dfn id="glo:glscurrenttoplevelentry"><code class="csfmt">\glscurrenttoplevelentry</code></dfn></code></div><!-- end of pinnedbox -->
+ This is set to the current entry label if <a id="wrglossary.10236"></a><a href="#glo:glscurrententrylevel"><code class="csfmt">\glscurrententrylevel</code></a> is 0 (that is, it expands to the most recent top-level entry, allowing for <a id="wrglossary.10237"></a><a href="#glo:opt.printgloss.flatten"><span class="csoptfmt">flatten</span></a> and <a id="wrglossary.10238"></a><a href="#glo:opt.printgloss.leveloffset"><span class="csoptfmt">leveloffset</span></a>); <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10239"></a><code class="code"><dfn id="glo:glscurrentrootentry"><code class="csfmt">\glscurrentrootentry</code></dfn></code></div><!-- end of pinnedbox -->
+ This is set to the current entry label if <a id="wrglossary.10240"></a><a href="#glo:opt.printgloss.flatten"><span class="csoptfmt">flatten</span></a><span class="optfmt">=true</span> or if the current entry doesn’t have a parent (that is, it expands to the most recent top-level entry, allowing for <a id="wrglossary.10241"></a><a href="#glo:opt.printgloss.flatten"><span class="csoptfmt">flatten</span></a> but not <a id="wrglossary.10242"></a><a href="#glo:opt.printgloss.leveloffset"><span class="csoptfmt">leveloffset</span></a>). <li><span class="numitem">4.</span>Perform the entry process hook: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10243"></a><code class="code"><dfn id="glo:printunsrtglossaryentryprocesshook"><code class="csfmt">\printunsrtglossaryentryprocesshook</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does nothing by default. Within the definition of this hook, you may use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10244"></a><code class="code"><dfn id="glo:printunsrtglossaryskipentry"><code class="csfmt">\printunsrtglossaryskipentry</code></dfn></code></div><!-- end of pinnedbox -->
+ This will cause the remainder of the current iteration to be skipped, which will prevent the current entry from being shown in the <a id="wrglossary.10245"></a><a href="#glo:dual.glossary">glossary</a>. <li><span class="numitem">5.</span>If <a id="wrglossary.10246"></a><a href="#glo:opt.printgloss.groups"><span class="csoptfmt">groups</span></a><span class="optfmt">=true</span>, use <a id="wrglossary.10247"></a><a href="#glo:glsxtraddgroup"><code class="csfmt">\glsxtraddgroup</code></a> (see §<a href="#sec:printunsrtgroups">8.4.1</a>) to append the top-level group heading (<a id="wrglossary.10248"></a><a href="#glo:glsgroupheading"><code class="csfmt">\glsgroupheading</code></a>) or the sub-group heading (<a id="wrglossary.10249"></a><a href="#glo:glssubgroupheading"><code class="csfmt">\glssubgroupheading</code></a>) to <a id="wrglossary.10250"></a><a href="#glo:@glsxtr@doglossary"><code class="csfmt">\@glsxtr@doglossary</code></a>. <li><span class="numitem">6.</span>Append <code class="code"><span class="cmdfmt">\<span class="meta">〈<em class="metainner">internal cs handler</em>〉</span></span>{<span class="meta">〈<em class="metainner">entry label</em>〉</span>}</code> to <a id="wrglossary.10251"></a><a href="#glo:@glsxtr@doglossary"><code class="csfmt">\@glsxtr@doglossary</code></a>.
+</ol>
+<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+The placeholders <a id="wrglossary.10252"></a><a href="#glo:glscurrenttoplevelentry"><code class="csfmt">\glscurrenttoplevelentry</code></a> and <a id="wrglossary.10253"></a><a href="#glo:glscurrentrootentry"><code class="csfmt">\glscurrentrootentry</code></a> may not be an ancestor of the current entry. For example, if the <a id="wrglossary.10254"></a><a href="#glo:dual.glossary">glossary</a> doesn’t have child entries immediately following their parent entry. </div><!-- end of warning -->
+<p>
+Once the <a id="wrglossary.10255"></a><a href="#glo:dual.glossary">glossary</a> construction (<a id="wrglossary.10256"></a><a href="#glo:@glsxtr@doglossary"><code class="csfmt">\@glsxtr@doglossary</code></a>) has been completed, the following hook is performed: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10257"></a><code class="code"><dfn id="glo:printunsrtglossarypredoglossary"><code class="csfmt">\printunsrtglossarypredoglossary</code></dfn></code></div><!-- end of pinnedbox -->
+ This does nothing by default. You can redefine this to show the definition of <a id="wrglossary.10258"></a><a href="#glo:@glsxtr@doglossary"><code class="csfmt">\@glsxtr@doglossary</code></a> for debugging purposes: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.10259"></a><a href="#glo:printunsrtglossarypredoglossary"><code class="csfmt">\printunsrtglossarypredoglossary</code></a>}{<span class="comment">% </span>
+ <code class="cmd">\csshow</code>{@glsxtr@doglossary}}
+</pre> This will interrupt the LaTeX run and display the definition in the transcript.<p>
+The handler command <code class="code"><span class="cmdfmt">\<span class="meta">〈<em class="metainner">internal cs handler</em>〉</span></span></code> performs the following: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\protected@xdef</code><a id="wrglossary.10260"></a><a href="#glo:glscurrententrylabel"><code class="csfmt">\glscurrententrylabel</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}<span class="comment">% </span>
+<a id="wrglossary.10261"></a><a href="#glo:printunsrtglossaryhandler"><code class="csfmt">\printunsrtglossaryhandler</code></a><a id="wrglossary.10262"></a><a href="#glo:glscurrententrylabel"><code class="csfmt">\glscurrententrylabel</code></a>
+</pre> This stores the entry’s label in <a id="wrglossary.10263"></a><a href="#glo:glscurrententrylabel"><code class="csfmt">\glscurrententrylabel</code></a> (which allows it to be referenced in style hooks, such as the <a id="wrglossary.10264"></a><a href="#glo:dual.postnamehook">post-name hook</a> or <a id="wrglossary.10265"></a><a href="#glo:dual.postdeschook">post-description hook</a>). Note that it uses a global definition to avoid scoping issues caused with <a id="wrglossary.10266"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>-like styles. The main handling of the entry is performed by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10267"></a><code class="code"><dfn id="glo:printunsrtglossaryhandler"><code class="csfmt">\printunsrtglossaryhandler</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is simply defined to use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10268"></a><code class="code"><dfn id="glo:glsxtrunsrtdo"><code class="csfmt">\glsxtrunsrtdo</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This displays the entry according to the current <a id="wrglossary.10269"></a><a href="#glo:idx.glossarystyle">glossary style</a>, taking the <a id="wrglossary.10270"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> into account (as given by <a id="wrglossary.10271"></a><a href="#glo:glscurrententrylevel"><code class="csfmt">\glscurrententrylevel</code></a>).<p>
+The following are additional commands that may be useful in the above hooks. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10272"></a><code class="code"><dfn id="glo:glsxtriflabelinlist"><code class="csfmt">\glsxtriflabelinlist</code></dfn>{<span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">label-list</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the given label is in the given comma-separated list of labels, otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>. The label and list are fully expanded.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10273"></a><code class="code"><dfn id="glo:ifglsxtrprintglossflatten"><code class="csfmt">\ifglsxtrprintglossflatten</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\iffalse</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This conditional is set by the <a id="wrglossary.10274"></a><a href="#glo:opt.printgloss.flatten"><span class="csoptfmt">flatten</span></a> option and can be used to test if the option has been set.<p>
+For example, the following skips all entries that have the <a id="wrglossary.10275"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> set to <a id="wrglossary.10276"></a><a href="#glo:opt.cat.symbol"><span class="csoptfmt">symbol</span></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.10277"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=index</span>]{glossaries-extra}
+<a id="wrglossary.10278"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{ant}{<a id="wrglossary.10279"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={ant}</span>,<a id="wrglossary.10280"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.10281"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{pi}{<a id="wrglossary.10282"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\pi</code>}}</span>,<a id="wrglossary.10283"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,
+ <a id="wrglossary.10284"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={symbol}</span>}
+<a id="wrglossary.10285"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{aardvark}{<a id="wrglossary.10286"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={aardvark}</span>,<a id="wrglossary.10287"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.10288"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.10289"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\alpha</code>}}</span>,<a id="wrglossary.10290"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>,
+ <a id="wrglossary.10291"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={symbol}</span>}
+<code class="cbeg">\begin{document}</code>
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.10292"></a><a href="#glo:printunsrtglossaryentryprocesshook"><code class="csfmt">\printunsrtglossaryentryprocesshook</code></a>}[1]{%
+ <a id="wrglossary.10293"></a><a href="#glo:glsifcategory"><code class="csfmt">\glsifcategory</code></a>{#1}{symbol}%
+ {<a id="wrglossary.10294"></a><a href="#glo:printunsrtglossaryskipentry"><code class="csfmt">\printunsrtglossaryskipentry</code></a>}%
+ {}%
}
-</pre>
-<!--l. 11258--><p class="nopar" > After this macro is called, &#x27E8;<span
-class="cmti-10">cs</span>&#x27E9; is then processed to escape any of <span
-class="cmtt-10">makeindex</span><a
- id="dx1-75021"></a>&#8217;s special
-characters. Note that this escaping is only performed on the sort not on the actual
-value. The escaping of the sort value is performed by
-</p><!--l. 11263--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-75022"></a> <span
-class="cmtt-10">\glsxtrautoindexesc </span></div><hr>
-</p><!--l. 11265--><p class="noindent" >
-You can redefine this to do nothing if you want to omit the escaping. You may want
-to consider providing another field to obtain the appropriate sort value if the one
-provided in the <span
-class="cmss-10">sort</span><a
- id="dx1-75023"></a> field isn&#8217;t suitable (because it may already have had special
-characters escaped or it may be a numeric value in the case of sort by use or
-definition).
-</p><!--l. 11273--><p class="indent" > The command used to perform the actual indexing is:
-</p><!--l. 11274--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-75024"></a> <span
-class="cmtt-10">\glsxtrautoindex{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11276--><p class="noindent" >
-This just does <span
-class="cmtt-10">\index{</span>&#x27E8;<span
-class="cmti-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span>by default.
-</p><!--l. 11279--><p class="indent" > <div class="important" title="Important Note"> The entry&#8217;s <span
-class="cmss-10">parent</span><a
- id="dx1-75025"></a> field isn&#8217;t referenced in this automated indexing.
-</div>
-</p><!--l. 11282--><p class="noindent" >
-</p><!--l. 11284--><p class="indent" > For example, to index the value of the <span
-class="cmss-10">first</span><a
- id="dx1-75026"></a> key, instead of the <span
-class="cmss-10">name</span><a
- id="dx1-75027"></a> key:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-254">
-\renewcommand*{\glsxtrautoindexentry}[1]{\string\glsentryfirst{#1}}
-</pre>
-<!--l. 11288--><p class="nopar" > and if the sort value also needs to be set to the <span
-class="cmss-10">long</span><a
- id="dx1-75028"></a> field, if present, otherwise the
-<span
-class="cmss-10">sort</span><a
- id="dx1-75029"></a> field:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-255">
-\renewcommand*{\glsxtrautoindexassignsort}[2]{%
-&#x00A0;&#x00A0;\ifglshaslong{#2}%
-&#x00A0;&#x00A0;{\glsletentryfield{#1}{#2}{long}}%
-&#x00A0;&#x00A0;{\glsletentryfield{#1}{#2}{sort}}%
+<a id="wrglossary.10295"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:filterbycat"></a>Example 141: Filtering by category <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example141.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example141.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example141.png" type="image/png" width="73" height="54">Example document that displays a glossary with entries filtered by category.</object> </div><!-- end of resultbox -->
+<p>
+
+</section><!-- end of section sec:printunsrtadvanced -->
+
+<section id="sec:printunsrtinner"><!-- start of section sec:printunsrtinner --><div class="tomain"><a href="#main">[top]</a></div>
+<h4><!-- start of subsubsection header -->8.4.3.1. Inner Glossaries<div class="labellink"><a href="#sec:printunsrtinner">[link]</a></div></h4><!-- end of subsubsection header -->
+<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+See also <a href="https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-inner">Gallery: Inner or Nested Glossaries</a>. </div><!-- end of information -->
+<p>
+It’s possible you may want to combine multiple <a id="wrglossary.10296"></a><a href="#glo:dual.glossary">glossaries</a> sequentially, as sub-blocks of a single list. The inner part of <a id="wrglossary.10297"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> can be created with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10298"></a><code class="code"><dfn id="glo:printunsrtinnerglossary"><code class="csfmt">\printunsrtinnerglossary</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">pre-code</em>〉</span>}{<span class="meta">〈<em class="metainner">post-code</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This can’t be used on its own, as it only forms a fragment. It doesn’t include the section header, style initialisation, preamble, <a id="wrglossary.10299"></a><a href="#glo:env.theglossary"><span class="envfmt">theglossary</span></a> environment, header and postamble.<p>
+As with <a id="wrglossary.10300"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>, <a id="wrglossary.10301"></a><a href="#glo:printunsrtinnerglossary"><code class="csfmt">\printunsrtinnerglossary</code></a> constructs an internal control sequence containing the content, but it adds scoping to localise the effects of any supplied options. So it essentially does: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\begingroup</code>
+ <span class="meta">〈<em class="metainner">Initial setup (process options).</em>〉</span>
+ <span class="meta">〈<em class="metainner">pre-code</em>〉</span>
+ <span class="meta">〈<em class="metainner">Construct internal control sequence containing glossary content.</em>〉</span>
+ <span class="meta">〈<em class="metainner">Expand internal control sequence.</em>〉</span>
+ <span class="meta">〈<em class="metainner">post-code</em>〉</span>
+<code class="cmd">\endgroup</code>
+</pre><p>
+There are two ways this command may be used. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10302"></a><code class="code"><code class="cmd">\begin</code>{<dfn id="glo:env.printunsrtglossarywrap"><span class="envfmt">printunsrtglossarywrap</span></dfn>}[<span class="meta">〈<em class="metainner">options</em>〉</span>]<span class="meta">〈<em class="metainner">content</em>〉</span><code class="cend">\end{<span class="envfmt">printunsrtglossarywrap</span>}</code></code></div><!-- end of pinnedbox -->
+ The <a id="wrglossary.10303"></a><a href="#glo:env.printunsrtglossarywrap"><span class="envfmt">printunsrtglossarywrap</span></a> environment takes one optional argument that uses the same keys as <a id="wrglossary.10304"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> (see §<a href="#sec:printglossopts">8.3</a>). Note that in this case the <a id="wrglossary.10305"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a> key simply provides a title (if one has been assigned to that <a id="wrglossary.10306"></a><a href="#glo:dual.glossary">glossary</a>). It doesn’t indicate the content. There’s no point using both <a id="wrglossary.10307"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a> and <a id="wrglossary.10308"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a>.<p>
+The start of the environment sets up the glossary style and does the header: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><span class="meta">〈<em class="metainner">Set default title and style.</em>〉</span>
+<span class="meta">〈<em class="metainner">Initial setup.</em>〉</span>
+<a id="wrglossary.10309"></a><a href="#glo:glossarysection"><code class="csfmt">\glossarysection</code></a>[<a id="wrglossary.10310"></a><a href="#glo:glossarytoctitle"><code class="csfmt">\glossarytoctitle</code></a>]{<a id="wrglossary.10311"></a><a href="#glo:glossarytitle"><code class="csfmt">\glossarytitle</code></a>}<span class="comment">% </span>
+<a id="wrglossary.10312"></a><a href="#glo:glossarypreamble"><code class="csfmt">\glossarypreamble</code></a>
+<code class="cbeg">\begin{<a id="wrglossary.10313"></a><a href="#glo:env.theglossary"><span class="envfmt">theglossary</span></a>}</code><a id="wrglossary.10314"></a><a href="#glo:glossaryheader"><code class="csfmt">\glossaryheader</code></a><a id="wrglossary.10315"></a><a href="#glo:glsresetentrylist"><code class="csfmt">\glsresetentrylist</code></a>
+</pre> The end of this wrapper environment ends <a id="wrglossary.10316"></a><a href="#glo:env.theglossary"><span class="envfmt">theglossary</span></a> and does the postamble: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cend">\end{<a id="wrglossary.10317"></a><a href="#glo:env.theglossary"><span class="envfmt">theglossary</span></a>}</code><a id="wrglossary.10318"></a><a href="#glo:glossarypostamble"><code class="csfmt">\glossarypostamble</code></a>
+</pre><p>
+For example, the following has two <a id="wrglossary.10319"></a><a href="#glo:dual.glossary">glossaries</a> but displays them as inner <a id="wrglossary.10320"></a><a href="#glo:dual.glossary">glossaries</a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.10321"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{ant}{<a id="wrglossary.10322"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={ant}</span>,<a id="wrglossary.10323"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.10324"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{bee}{<a id="wrglossary.10325"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={bee}</span>,<a id="wrglossary.10326"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.10327"></a><a href="#glo:newignoredglossary*"><code class="csfmt">\newignoredglossary*</code></a>{other}
+<a id="wrglossary.10328"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{duck}{<a id="wrglossary.10329"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,<a id="wrglossary.10330"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.10331"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{goose}{<a id="wrglossary.10332"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={goose}</span>,<a id="wrglossary.10333"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<code class="cbeg">\begin{document}</code>
+<code class="cbeg">\begin{<a id="wrglossary.10334"></a><a href="#glo:env.printunsrtglossarywrap"><span class="envfmt">printunsrtglossarywrap</span></a>}</code>[<a id="wrglossary.10335"></a><a href="#glo:opt.printgloss.style"><span class="csoptfmt">style</span></a><span class="optfmt">=index</span>]
+<a id="wrglossary.10336"></a><a href="#glo:glstreeitem"><code class="csfmt">\glstreeitem</code></a> First Glossary
+<a id="wrglossary.10337"></a><a href="#glo:printunsrtinnerglossary"><code class="csfmt">\printunsrtinnerglossary</code></a>[<a id="wrglossary.10338"></a><a href="#glo:opt.printgloss.leveloffset"><span class="csoptfmt">leveloffset</span></a><span class="optfmt">=1</span>]{}{}
+<a id="wrglossary.10339"></a><a href="#glo:glstreeitem"><code class="csfmt">\glstreeitem</code></a> Second Glossary
+<a id="wrglossary.10340"></a><a href="#glo:printunsrtinnerglossary"><code class="csfmt">\printunsrtinnerglossary</code></a>[<a id="wrglossary.10341"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=other</span>,<a id="wrglossary.10342"></a><a href="#glo:opt.printgloss.leveloffset"><span class="csoptfmt">leveloffset</span></a><span class="optfmt">=1</span>]{}{}
+<code class="cend">\end{<a id="wrglossary.10343"></a><a href="#glo:env.printunsrtglossarywrap"><span class="envfmt">printunsrtglossarywrap</span></a>}</code>
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:unsrtwrap"></a>Example 142: Inner glossaries using <span class="envfmt">printunsrtglossarywrap</span> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example142.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example142.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example142.png" type="image/png" width="84" height="114">Example document illustrating two inner glossaries offset by 1 level.</object> </div><!-- end of resultbox -->
+<p>
+The other way that <a id="wrglossary.10344"></a><a href="#glo:printunsrtinnerglossary"><code class="csfmt">\printunsrtinnerglossary</code></a> can be used is within <a id="wrglossary.10345"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>. The handler function described in §<a href="#sec:printunsrtadvanced">8.4.3</a> that’s used to process each entry to be displayed in the <a id="wrglossary.10346"></a><a href="#glo:dual.glossary">glossary</a>, is defined as: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<a id="wrglossary.10347"></a><a href="#glo:printunsrtglossaryhandler"><code class="csfmt">\printunsrtglossaryhandler</code></a>}[1]{<a id="wrglossary.10348"></a><a href="#glo:glsxtrunsrtdo"><code class="csfmt">\glsxtrunsrtdo</code></a>{#1}}
+</pre><p>
+It’s possible to redefine this so that it also displays an inner glossary. The following example has the terms <span class="qt">“pictograph”</span> and <span class="qt">“Greek symbol”</span> in the <code class="code">main</code> glossary. Two <a id="wrglossary.10349"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a> are created (which don’t require a title) where the <a id="wrglossary.10350"></a><a href="#glo:dual.glossary">glossary</a> label matches an entry label in the <code class="code">main</code> <a id="wrglossary.10351"></a><a href="#glo:dual.glossary">glossary</a>. <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>{fontawesome}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.10352"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.10353"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a></span>]{glossaries-extra}
+<a id="wrglossary.10354"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{pictograph}{<a id="wrglossary.10355"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={pictograph}</span>,
+ <a id="wrglossary.10356"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={picture or symbol representing a word or phrase}</span>}
+<a id="wrglossary.10357"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{mathgreek}{<a id="wrglossary.10358"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={Greek symbol}</span>,
+ <a id="wrglossary.10359"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={mathematical constants or functions}</span>}
+<a id="wrglossary.10360"></a><a href="#glo:newignoredglossary*"><code class="csfmt">\newignoredglossary*</code></a>{pictograph}
+<a id="wrglossary.10361"></a><a href="#glo:newignoredglossary*"><code class="csfmt">\newignoredglossary*</code></a>{mathgreek}
+<a id="wrglossary.10362"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{cut}{<a id="wrglossary.10363"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={pictograph}</span>,
+ <a id="wrglossary.10364"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\faCut</code>}</span>,
+ <a id="wrglossary.10365"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={cut}</span>}
+<a id="wrglossary.10366"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>paste{<a id="wrglossary.10367"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={pictograph}</span>,
+<a id="wrglossary.10368"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\faPaste</code>}</span>,
+ <a id="wrglossary.10369"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={paste}</span>}
+<a id="wrglossary.10370"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.10371"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={mathgreek}</span>,
+ <a id="wrglossary.10372"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\alpha</code>}}</span>,
+ <a id="wrglossary.10373"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={alpha}</span>}
+<a id="wrglossary.10374"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{beta}{<a id="wrglossary.10375"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={mathgreek}</span>,
+ <a id="wrglossary.10376"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\beta</code>}}</span>,
+ <a id="wrglossary.10377"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={beta}</span>}
+<code class="cbeg">\begin{document}</code>
+<code class="cmd">\newcommand</code>{<code class="cmd">\nestedhandler</code>}[1]{%
+ <a id="wrglossary.10378"></a><a href="#glo:glsxtrunsrtdo"><code class="csfmt">\glsxtrunsrtdo</code></a>{#1}%
+ <a id="wrglossary.10379"></a><a href="#glo:ifglossaryexists"><code class="csfmt">\ifglossaryexists</code></a>*{#1}%
+ {%
+ <a id="wrglossary.10380"></a><a href="#glo:printunsrtinnerglossary"><code class="csfmt">\printunsrtinnerglossary</code></a>[<a id="wrglossary.10381"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">={#1}</span>,<a id="wrglossary.10382"></a><a href="#glo:opt.printgloss.leveloffset"><span class="csoptfmt">leveloffset</span></a><span class="optfmt">={++1}</span>,
+ <a id="wrglossary.10383"></a><a href="#glo:opt.printgloss.groups"><span class="csoptfmt">groups</span></a><span class="optfmt">=false</span>]{}{}%
+ }%
+ %
}
-</pre>
-<!--l. 11297--><p class="nopar" >
-</p><!--l. 11299--><p class="indent" > If the value of the attribute given by &#x27E8;<span
-class="cmti-10">attribute-label</span>&#x27E9; is &#8220;true&#8221;, no encap will be
-added, otherwise the encap will be the attribute value. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-256">
-\glssetcategoryattribute{general}{indexname}{textbf}
-</pre>
-<!--l. 11305--><p class="nopar" > will set the encap to <span
-class="cmtt-10">textbf </span>which will display the relevant page number in bold
-whereas
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-257">
-\glssetcategoryattribute{general}{dualindex}{true}
-</pre>
-<!--l. 11310--><p class="nopar" > won&#8217;t apply any formatting to the page number in the index.
-</p><!--l. 11313--><p class="indent" > <div class="important" title="Important Note"> The location used in the index will always be the page number not the counter
-used in the glossary. (Unless some other loaded package has modified the definition of
-<span
-class="cmtt-10">\index </span>to use some thing else.) </div>
-</p><!--l. 11318--><p class="noindent" >
-</p><!--l. 11320--><p class="indent" > By default the <span
-class="cmss-10">format</span><a
- id="dx1-75030"></a> key won&#8217;t be used with the <a
-href="#catattr.dualindex"><span
-class="cmss-10">dualindex</span></a><a
- id="dx1-75031"></a> attribute. You can
-allow the <span
-class="cmss-10">format</span><a
- id="dx1-75032"></a> key to override the attribute value by using the preamble-only
-command:
-</p><!--l. 11324--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-75033"></a> <span
-class="cmtt-10">\GlsXtrEnableIndexFormatOverride </span></div><hr>
-</p><!--l. 11326--><p class="noindent" >
-If you use this command and <span
-class="cmss-10">hyperref</span><a
- id="dx1-75034"></a> has been loaded, then the <span
-class="cmss-10">theindex</span><a
- id="dx1-75035"></a><a
- id="dx1-75036"></a>
-environment will be modified to redefine <span
-class="cmtt-10">\glshypernumber</span><a
- id="dx1-75037"></a> to allow formats that use
-that command.
-</p><!--l. 11331--><p class="indent" > <div class="important" title="Important Note"> The <a
-href="#catattr.dualindex"><span
-class="cmss-10">dualindex</span></a><a
- id="dx1-75038"></a> attribute will still be used on subsequent use even if the
-<a
-href="#catattr.indexonlyfirst"><span
-class="cmss-10">indexonlyfirst</span></a><a
- id="dx1-75039"></a> attribute (or <a
-href="#styopt.indexonlyfirst"><span
-class="cmss-10">indexonlyfirst</span></a><a
- id="dx1-75040"></a> package option) is set. However, the <a
-href="#catattr.dualindex"><span
-class="cmss-10">dualindex</span></a><a
- id="dx1-75041"></a>
-attribute will honour the <span
-class="cmss-10">noindex</span><a
- id="dx1-75042"></a> key. </div>
-</p><!--l. 11337--><p class="noindent" >
-</p><!--l. 11339--><p class="indent" > The <span
-class="cmtt-10">\glsxtrdoautoindexname </span>command will attempt to escape any of
-<span
-class="cmtt-10">\makeindex</span><a
- id="dx1-75043"></a>&#8217;s special characters, but there may be special cases where it fails, so take
-care. This assumes the default <a
- id="dx1-75044"></a><a
-href="#glo:makeindex"><span
-class="cmtt-10">makeindex</span></a> actual, level, quote and encap values
-(unless any of the commands <span
-class="cmtt-10">\actualchar</span><a
- id="dx1-75045"></a>, <span
-class="cmtt-10">\levelchar</span><a
- id="dx1-75046"></a>, <span
-class="cmtt-10">\quotechar</span><a
- id="dx1-75047"></a> or <span
-class="cmtt-10">\encapchar</span><a
- id="dx1-75048"></a>
-have been defined before <span
-class="cmss-10">glossaries-extra </span>is loaded).
-</p><!--l. 11347--><p class="indent" > If this isn&#8217;t the case, you can use the following preamble-only commands to set
-the correct characters.
-</p><!--l. 11349--><p class="indent" > <div class="important" title="Important Note"> Be very careful of possible shifting category codes! </div>
-</p><!--l. 11351--><p class="noindent" >
-</p><!--l. 11353--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-75049"></a> <span
-class="cmtt-10">\GlsXtrSetActualChar{</span>&#x27E8;<span
-class="cmitt-10">char</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11355--><p class="noindent" >
-Set the actual character to &#x27E8;<span
-class="cmti-10">char</span>&#x27E9;.
-</p><!--l. 11358--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-75050"></a> <span
-class="cmtt-10">\GlsXtrSetLevelChar{</span>&#x27E8;<span
-class="cmitt-10">char</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11360--><p class="noindent" >
-Set the level character to &#x27E8;<span
-class="cmti-10">char</span>&#x27E9;.
-</p><!--l. 11363--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-75051"></a> <span
-class="cmtt-10">\GlsXtrSetEscChar{</span>&#x27E8;<span
-class="cmitt-10">char</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11365--><p class="noindent" >
-Set the escape (quote) character to &#x27E8;<span
-class="cmti-10">char</span>&#x27E9;.
-</p><!--l. 11368--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-75052"></a> <span
-class="cmtt-10">\GlsXtrSetEncapChar{</span>&#x27E8;<span
-class="cmitt-10">char</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-
-
-
-</p><!--l. 11370--><p class="noindent" >
-Set the encap character to &#x27E8;<span
-class="cmti-10">char</span>&#x27E9;.
-
-
-
-</p>
-<!--l. 11373--><p class="indent" > </div>
-</p><!--l. 11373--><p class="noindent" ><a
-href="#top">Top</a><div class="chapter"><h2 class="chapterHead">10. <a
- id="sec:bib2gls"></a>bib2gls: Managing Reference Databases</h2>
-</p><!--l. 11376--><p class="indent" > There is a new command line application called <a
- id="dx1-76001"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a>, which works in much
-the same way as a combination of <span
-class="cmtt-10">bibtex </span>and <span
-class="cmtt-10">makeindex</span>/<span
-class="cmtt-10">xindy</span>. Instead of
-storing all your entry definitions in a <span
-class="cmtt-10">.tex </span>and loading them using <span
-class="cmtt-10">\input </span>or
-<span
-class="cmtt-10">\loadglsentries</span>, the entries can instead be stored in a <span
-class="cmtt-10">.bib </span>file and <a
- id="dx1-76002"></a><span
-class="cmtt-10">bib2gls </span>can
-selectively write the appropriate commands to a <span
-class="cmtt-10">.glstex </span>file which is loaded using
-<span
-class="cmtt-10">\glsxtrresourcefile </span>(or <span
-class="cmtt-10">\GlsXtrLoadResources</span>).
-</p><!--l. 11387--><p class="indent" > This means that you can use a reference managing system, such as JabRef, to
-maintain the database and it reduces the TeX&#x00A0;overhead by only defining the entries
-that are actually required in the document. If you currently have a <span
-class="cmtt-10">.tex </span>file that
-contains hundreds of definitions, but you only use a dozen or so in your
-document, then the build time is needlessly slowed by the unrequired definitions
-that occur when the file is input. (You can convert an existing <span
-class="cmtt-10">.tex </span>file
-containing glossary definitions to a <span
-class="cmtt-10">.bib </span>file using <span
-class="cmtt-10">convertgls2bib</span><a
- id="dx1-76003"></a>, supplied with
-<a
- id="dx1-76004"></a><span
-class="cmtt-10">bib2gls</span>.)
-</p><!--l. 11398--><p class="indent" > There are some new commands and options added to <span
-class="cmss-10">glossaries-extra </span>to help assist
-the integration of <a
- id="dx1-76005"></a><span
-class="cmtt-10">bib2gls </span>into the document build process.
-</p><!--l. 11402--><p class="indent" > This chapter just provides a general overview of <a
- id="dx1-76006"></a><span
-class="cmtt-10">bib2gls</span>. The full details and
-some sample documents are provided in the <a
- id="dx1-76007"></a><span
-class="cmtt-10">bib2gls </span><a
-href="http://mirrors.ctan.org/support/bib2gls/bib2gls.pdf" >manual</a>.
-</p><!--l. 11406--><p class="indent" > An example of the contents of <span
-class="cmtt-10">.bib </span>file that stores glossary entries that can be
-extracted with <a
- id="dx1-76008"></a><span
-class="cmtt-10">bib2gls</span>:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-258">
-@entry{bird,
-&#x00A0;&#x00A0;name={bird},
-&#x00A0;&#x00A0;description&#x00A0;=&#x00A0;{feathered&#x00A0;animal},
-&#x00A0;&#x00A0;see={[see&#x00A0;also]{duck,goose}}
+<a id="wrglossary.10384"></a><a href="#glo:printunsrtglossary*"><code class="csfmt">\printunsrtglossary*</code></a>{<code class="cmd">\let</code><a id="wrglossary.10385"></a><a href="#glo:printunsrtglossaryhandler"><code class="csfmt">\printunsrtglossaryhandler</code></a><code class="cmd">\nestedhandler</code>}
+<code class="cend">\end{document}</code>
+</pre><p>
+This creates a custom command <code class="csfmt">\nestedhandler</code> that can be used as the handler to create nested <a id="wrglossary.10386"></a><a href="#glo:dual.glossary">glossaries</a>. After each item in the glossary, if the entry’s label matches the label of a defined glossary, that glossary is displayed with its <a id="wrglossary.10387"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> incremented by 1, which creates the illusion of child entries. The resulting document is shown in Example <a href="#ex:nested">143</a>.<p>
+<div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:nested"></a>Example 143: Nested glossaries <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example143.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example143.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example143.png" type="image/png" width="313" height="124">Example document with a glossary that has inner glossaries.</object> </div><!-- end of resultbox -->
+<p>
+
+</section><!-- end of section sec:printunsrtinner -->
+
+<section id="sec:printunsrtunit"><!-- start of section sec:printunsrtunit --><div class="tomain"><a href="#main">[top]</a></div>
+<h4><!-- start of subsubsection header -->8.4.3.2. Per-Unit Glossaries<div class="labellink"><a href="#sec:printunsrtunit">[link]</a></div></h4><!-- end of subsubsection header -->
+<p>
+If you are using <a id="wrglossary.10388"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> then it’s possible to only list entries that match a particular counter value. For example, you may want a <a id="wrglossary.10389"></a><a href="#glo:idx.mini-glossary">mini-glossary</a> at the start of a section that only lists the entries that have been <a id="wrglossary.10390"></a><a href="#glo:@@glslabel@indexing">recorded</a> in that section. This can be done by using the handler to skip entries that don’t have a matching record. It can also be implemented with record counting, as shown in Example <a href="#ex:recordcountminigloss">156</a> in §<a href="#sec:recordcount">11.4</a>.<p>
+It’s also possible to make each <a id="wrglossary.10391"></a><a href="#glo:dual.indexing">indexing</a> instance automatically make a note of a particular counter using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10392"></a><code class="code"><dfn id="glo:GlsXtrRecordCounter"><code class="csfmt">\GlsXtrRecordCounter</code></dfn>{<span class="meta">〈<em class="metainner">counter-name</em>〉</span>}</code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ (This doesn’t correspond to a <a id="wrglossary.10393"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> <a id="wrglossary.10394"></a><a href="#glo:@@glslabel@indexing">record</a>. That’s dealt with by the indexing that comes first.)<p>
+This command may only be used in the preamble (with <a id="wrglossary.10395"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>) and indicates that whenever an entry is indexed, the following line should be added to the <a id="wrglossary.10396"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10397"></a><code class="code"><dfn id="glo:glsxtr@counterrecord"><code class="csfmt">\glsxtr@counterrecord</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">value</em>〉</span> is given by <a id="wrglossary.10398"></a><a href="#glo:thecounter"><code class="csfmt">\the<span class="meta">〈<em class="metainner">counter</em>〉</span></code></a>. On the next LaTeX run, this information is picked up from the <a id="wrglossary.10399"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and the information is added to the <a id="wrglossary.10400"></a><a href="#glo:opt.glosfield.record.counter"><span class="csoptfmt">record.<span class="meta">〈<em class="metainner">counter</em>〉</span></span></a> field (stored as an <a id="wrglossary.10401"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span></a> internal list). This internal command is only used in the <a id="wrglossary.10402"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and has a user-level hook: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10403"></a><code class="code"><dfn id="glo:glsxtrAddCounterRecordHook"><code class="csfmt">\glsxtrAddCounterRecordHook</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does nothing by default. If you want to redefined this, the redefinition must be placed in the document preamble before the <a id="wrglossary.10404"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file is input.<p>
+There are two ways of skipping an entry. The first is to redefine <a id="wrglossary.10405"></a><a href="#glo:printunsrtglossaryentryprocesshook"><code class="csfmt">\printunsrtglossaryentryprocesshook</code></a> to perform the test and use <a id="wrglossary.10406"></a><a href="#glo:printunsrtglossaryskipentry"><code class="csfmt">\printunsrtglossaryskipentry</code></a> to skip an unwanted entry (as illustrated earlier). The second is to perform the test in <a id="wrglossary.10407"></a><a href="#glo:printunsrtglossaryhandler"><code class="csfmt">\printunsrtglossaryhandler</code></a>. The first method is the better option for large lists that may contain group headers. The example below uses the second method.<p>
+The file <span class="filefmt">myentries.bib</span> contains the following: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="code">@symbol</code>{pi,<a id="wrglossary.10408"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\pi</code>}}</span>,<br><a id="wrglossary.10409"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={ratio of the length of the circumference of a circle to its diameter}</span>}<br><code class="code">@symbol</code>{root2,<a id="wrglossary.10410"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\surd</code>2}}</span>,<br><a id="wrglossary.10411"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={Pythagoras' constant}</span>}<br><code class="code">@symbol</code>{zeta3,<a id="wrglossary.10412"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\zeta</code>(3)}}</span>,<br><a id="wrglossary.10413"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={Ap<code class="cmd">\'</code>ery's constant}</span>}<br><code class="code">@symbol</code>{zero,<a id="wrglossary.10414"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={0}</span>,<br><a id="wrglossary.10415"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={nothing or nil}</span>}<br><code class="code">@symbol</code>{one,<a id="wrglossary.10416"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={1}</span>,<br><a id="wrglossary.10417"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={single entity, unity}</span>}
+</pre> The document redefines the handler to only show entries in the current section: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.10418"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>,<a id="wrglossary.10419"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a>,<a id="wrglossary.10420"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=index</span>]{glossaries-extra}
+<a id="wrglossary.10421"></a><a href="#glo:GlsXtrRecordCounter"><code class="csfmt">\GlsXtrRecordCounter</code></a>{<a id="wrglossary.10422"></a><a href="#glo:ctr.section"><span class="ctrfmt">section</span></a>}
+<a id="wrglossary.10423"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.10424"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">={myentries}</span>]
+<code class="cbeg">\begin{document}</code>
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.10425"></a><a href="#glo:printunsrtglossaryhandler"><code class="csfmt">\printunsrtglossaryhandler</code></a>}[1]{%
+ <a id="wrglossary.10426"></a><a href="#glo:glsxtrfieldxifinlist"><code class="csfmt">\glsxtrfieldxifinlist</code></a>{#1}{record.section}{<a id="wrglossary.10427"></a><a href="#glo:thecounter"><code class="csfmt">\thesection</code></a>}
+ {<a id="wrglossary.10428"></a><a href="#glo:glsxtrunsrtdo"><code class="csfmt">\glsxtrunsrtdo</code></a>{#1}}%
+ {}%
}
-@entry{duck,
-&#x00A0;&#x00A0;name={duck},
-&#x00A0;&#x00A0;description&#x00A0;=&#x00A0;{a&#x00A0;waterbird&#x00A0;with&#x00A0;short&#x00A0;legs}
+<code class="cmd">\section</code>{Sample}
+<a id="wrglossary.10429"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>
+This section discusses <a id="wrglossary.10430"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{pi}, <a id="wrglossary.10431"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{root2} and
+<a id="wrglossary.10432"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{zeta3}.
+
+<code class="cmd">\section</code>{Another Sample}
+<a id="wrglossary.10433"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>
+This section discusses <a id="wrglossary.10434"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{one}, <a id="wrglossary.10435"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{pi} and
+<a id="wrglossary.10436"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{zero}.
+<code class="cend">\end{document}</code>
+</pre> If the document is saved in the file <span class="filefmt">myDoc.tex</span> then the build process is: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
+bib2gls myDoc
+pdflatex myDoc
+</pre> The first LaTeX run adds the <a id="wrglossary.10437"></a><a href="#glo:@@glslabel@indexing">records</a> to the <a id="wrglossary.10438"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file for <a id="wrglossary.10439"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to pick up, but also adds the <a id="wrglossary.10440"></a><a href="#glo:glsxtr@counterrecord"><code class="csfmt">\glsxtr@counterrecord</code></a> lines (which <a id="wrglossary.10441"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> ignores) that setup the <a id="wrglossary.10442"></a><a href="#glo:opt.glosfield.record.counter"><code class="fieldfmt">record.section</code></a> list field for the given entry.<p>
+This means that <a id="wrglossary.10443"></a><a href="#glo:glsxtrfieldxifinlist"><code class="csfmt">\glsxtrfieldxifinlist</code></a> can be used to determine whether or not the current section number (<a id="wrglossary.10444"></a><a href="#glo:thecounter"><code class="csfmt">\thesection</code></a>) is in the list. If it is, then the entry is displayed in the current <a id="wrglossary.10445"></a><a href="#glo:idx.glossarystyle">glossary style</a> using the default <a id="wrglossary.10446"></a><a href="#glo:glsxtrunsrtdo"><code class="csfmt">\glsxtrunsrtdo</code></a>. Otherwise nothing is displayed.<p>
+The following command is provided that performs something similar: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10447"></a><code class="code"><dfn id="glo:printunsrtglossaryunit"><code class="csfmt">\printunsrtglossaryunit</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">counter-name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is equivalent to: <pre class="compactcodebox"><a id="wrglossary.10448"></a><a href="#glo:printunsrtglossary*"><code class="csfmt">\printunsrtglossary*</code></a>[<a id="wrglossary.10449"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.10450"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a></span>,#1]{<span class="comment">% </span>
+ <a id="wrglossary.10451"></a><a href="#glo:printunsrtglossaryunitsetup"><code class="csfmt">\printunsrtglossaryunitsetup</code></a>{#2}<span class="comment">% </span>
+}</pre> This initialises the hook via: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10452"></a><code class="code"><dfn id="glo:printunsrtglossaryunitsetup"><code class="csfmt">\printunsrtglossaryunitsetup</code></dfn>{<span class="meta">〈<em class="metainner">counter-name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is essentially does: <pre class="compactcodebox"><span class="comment">% redefine handler to only show entries with a match:</span>
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.10453"></a><a href="#glo:printunsrtglossaryhandler"><code class="csfmt">\printunsrtglossaryhandler</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.10454"></a><a href="#glo:glsxtrfieldxifinlist"><code class="csfmt">\glsxtrfieldxifinlist</code></a>{#1}{record.<span class="meta">〈<em class="metainner">counter-name</em>〉</span>}{<a id="wrglossary.10455"></a><a href="#glo:thecounter"><code class="csfmt">\the<span class="meta">〈<em class="metainner">counter-name</em>〉</span></code></a>}
+ {<a id="wrglossary.10456"></a><a href="#glo:glsxtrunsrtdo"><code class="csfmt">\glsxtrunsrtdo</code></a>{#1}}<span class="comment">% </span>
+ {}<span class="comment">% </span>
+}<span class="comment">% </span>
+<span class="meta">〈<em class="metainner">assign target name prefixes (see below)</em>〉</span>
+<span class="comment">% suppress section header:</span>
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.10457"></a><a href="#glo:glossarysection"><code class="csfmt">\glossarysection</code></a>}[2][]{}<span class="comment">% </span>
+<span class="comment">% append vertical space after the glossary:</span>
+<code class="cmd">\appto</code><a id="wrglossary.10458"></a><a href="#glo:glossarypostamble"><code class="csfmt">\glossarypostamble</code></a>{<a id="wrglossary.10459"></a><a href="#glo:printunsrtglossaryunitpostskip"><code class="csfmt">\printunsrtglossaryunitpostskip</code></a>}<span class="comment">% </span>
+</pre> This is more complicated than the original example as it also suppresses the glossary section header and modifies the target name prefix. Additionally, the following is appended to the end of the <a id="wrglossary.10460"></a><a href="#glo:dual.glossary">glossary</a>: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10461"></a><code class="code"><dfn id="glo:printunsrtglossaryunitpostskip"><code class="csfmt">\printunsrtglossaryunitpostskip</code></dfn></code></div><!-- end of pinnedbox -->
+ This simply does: <pre class="compactcodebox"><a id="wrglossary.10462"></a><a href="#glo:glspar"><code class="csfmt">\glspar</code></a><code class="cmd">\medskip</code><a id="wrglossary.10463"></a><a href="#glo:glspar"><code class="csfmt">\glspar</code></a>
+</pre> which creates a small vertical space. The target name prefix (<a id="wrglossary.10464"></a><a href="#glo:opt.printgloss.targetnameprefix"><span class="csoptfmt">targetnameprefix</span></a>) is assigned as follows. If <a id="wrglossary.10465"></a><a href="#glo:theHcounter"><code class="csfmt">\the<span class="meta">〈<em class="metainner">counter-name</em>〉</span></code></a> has been defined, the prefix is: <pre class="compactcodebox">record.<span class="meta">〈<em class="metainner">counter-name</em>〉</span>.<a id="wrglossary.10466"></a><a href="#glo:theHcounter"><code class="csfmt">\the<span class="meta">〈<em class="metainner">counter-name</em>〉</span></code></a>.<a id="wrglossary.10467"></a><a href="#glo:@gobble"><code class="csfmt">\@gobble</code></a>
+</pre> otherwise the prefix is: <pre class="compactcodebox">record.<span class="meta">〈<em class="metainner">counter-name</em>〉</span>.<a id="wrglossary.10468"></a><a href="#glo:thecounter"><code class="csfmt">\the<span class="meta">〈<em class="metainner">counter-name</em>〉</span></code></a>.<a id="wrglossary.10469"></a><a href="#glo:@gobble"><code class="csfmt">\@gobble</code></a>
+</pre> The use of <a id="wrglossary.10470"></a><a href="#glo:@gobble"><code class="csfmt">\@gobble</code></a> at the end discards <a id="wrglossary.10471"></a><a href="#glo:glolinkprefix"><code class="csfmt">\glolinkprefix</code></a>.<p>
+The above example can be rewritten using <a id="wrglossary.10472"></a><a href="#glo:printunsrtglossaryunit"><code class="csfmt">\printunsrtglossaryunit</code></a>. I’ve added <a id="wrglossary.10473"></a><a href="#glo:opt.resource.symbol-sort-fallback"><span class="csoptfmt">symbol-sort-fallback</span></a> to sort by the description and a full glossary at the end of the document. <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.10474"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>,<a id="wrglossary.10475"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a>,<a id="wrglossary.10476"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=index</span>]{glossaries-extra}
+<a id="wrglossary.10477"></a><a href="#glo:GlsXtrRecordCounter"><code class="csfmt">\GlsXtrRecordCounter</code></a>{<a id="wrglossary.10478"></a><a href="#glo:ctr.section"><span class="ctrfmt">section</span></a>}
+<a id="wrglossary.10479"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.10480"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">={myentries}</span>,
+ <a id="wrglossary.10481"></a><a href="#glo:opt.resource.symbol-sort-fallback"><span class="csoptfmt">symbol-sort-fallback</span></a><span class="optfmt">=<a id="wrglossary.10482"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a></span>
+]
+<code class="cbeg">\begin{document}</code>
+<code class="cmd">\section</code>{Sample}
+<a id="wrglossary.10483"></a><a href="#glo:printunsrtglossaryunit"><code class="csfmt">\printunsrtglossaryunit</code></a>{<a id="wrglossary.10484"></a><a href="#glo:ctr.section"><span class="ctrfmt">section</span></a>}
+This section discusses <a id="wrglossary.10485"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{pi}, <a id="wrglossary.10486"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{root2} and
+<a id="wrglossary.10487"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{zeta3}.
+
+<code class="cmd">\section</code>{Another Sample}
+<a id="wrglossary.10488"></a><a href="#glo:printunsrtglossaryunit"><code class="csfmt">\printunsrtglossaryunit</code></a>{<a id="wrglossary.10489"></a><a href="#glo:ctr.section"><span class="ctrfmt">section</span></a>}
+This section discusses <a id="wrglossary.10490"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{one}, <a id="wrglossary.10491"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{pi} and
+<a id="wrglossary.10492"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{zero}.
+
+<a id="wrglossary.10493"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> The build process is the same as before: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
+bib2gls myDoc
+pdflatex myDoc
+</pre> The resulting document is shown in Example <a href="#ex:minigloss">144</a>. Note that all glossaries show the <a id="wrglossary.10494"></a><a href="#glo:dual.locationlist">location lists</a>, which all contain the page number 1, since the example document is only one page long.<p>
+<div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:minigloss"></a>Example 144: Sub-glossary for a given counter value <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example144.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example144.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example144.png" type="image/png" width="354" height="331">Example document demonstrating a mini-glossary that only shows entries recorded in the current section.</object> </div><!-- end of resultbox -->
+<p>
+Other variations include creating a secondary <a id="wrglossary.10495"></a><a href="#glo:dual.glossary">glossary</a> that’s ordered differently for the <a id="wrglossary.10496"></a><a href="#glo:idx.mini-glossary">mini-glossaries</a>. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.10497"></a><a href="#glo:newignoredglossary*"><code class="csfmt">\newignoredglossary*</code></a>{glossary2}
+<a id="wrglossary.10498"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.10499"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">={<code class="cmd">\jobname</code>}</span>,
+ <a id="wrglossary.10500"></a><a href="#glo:opt.resource.symbol-sort-fallback"><span class="csoptfmt">symbol-sort-fallback</span></a><span class="optfmt">=<a id="wrglossary.10501"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a></span>,
+ <a id="wrglossary.10502"></a><a href="#glo:opt.resource.secondary"><span class="csoptfmt">secondary</span></a><span class="optfmt">=use:glossary2</span>
+]
+</pre> This orders the secondary glossary according to use (the first record for the entire document not for the given unit). The <a id="wrglossary.10503"></a><a href="#glo:idx.mini-glossary">mini-glossaries</a> will then need the <a id="wrglossary.10504"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a> option: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.10505"></a><a href="#glo:printunsrtglossaryunit"><code class="csfmt">\printunsrtglossaryunit</code></a>[<a id="wrglossary.10506"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=glossary2</span>]{<a id="wrglossary.10507"></a><a href="#glo:ctr.section"><span class="ctrfmt">section</span></a>}
+</pre><p>
+There is an alternative method that ensures the <a id="wrglossary.10508"></a><a href="#glo:idx.mini-glossary">mini-glossaries</a> are ordered by use within the section. This can be done by redefining <a id="wrglossary.10509"></a><a href="#glo:glsxtrAddCounterRecordHook"><code class="csfmt">\glsxtrAddCounterRecordHook</code></a> to create a <a id="wrglossary.10510"></a><a href="#glo:dual.glossary">glossary</a> for each unit (instead of using a secondary <a id="wrglossary.10511"></a><a href="#glo:dual.glossary">glossary</a>): <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.10512"></a><a href="#glo:glsxtrAddCounterRecordHook"><code class="csfmt">\glsxtrAddCounterRecordHook</code></a>}[3]{<span class="comment">% </span>
+ <a id="wrglossary.10513"></a><a href="#glo:provideignoredglossary"><code class="csfmt">\provideignoredglossary</code></a>{#2.#3}<span class="comment">% </span>
+ <a id="wrglossary.10514"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a>*{#1}{#2.#3}<span class="comment">% </span>
}
-@entry{goose,
-&#x00A0;&#x00A0;name="goose",
-&#x00A0;&#x00A0;plural="geese",
-&#x00A0;&#x00A0;description={a&#x00A0;waterbird&#x00A0;with&#x00A0;a&#x00A0;long&#x00A0;neck}
+</pre> (Remember this needs to be done in the preamble, before the <a id="wrglossary.10515"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file is input.)<p>
+This creates a <a id="wrglossary.10516"></a><a href="#glo:dual.glossary">glossary</a> with the label <code class="code"><span class="meta">〈<em class="metainner">counter</em>〉</span>.<span class="meta">〈<em class="metainner">value</em>〉</span></code>, if it’s not already defined, and adds the entry’s label to it. This means that this <a id="wrglossary.10517"></a><a href="#glo:dual.glossary">glossary</a> will only contain the entries for the matching <span class="meta">〈<em class="metainner">counter</em>〉</span> and <span class="meta">〈<em class="metainner">value</em>〉</span>, and the entry labels are in the order they were added to the <a id="wrglossary.10518"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file.<p>
+The <a id="wrglossary.10519"></a><a href="#glo:dual.glossary">glossary</a> needs to be set appropriately. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.10520"></a><a href="#glo:printunsrtglossaryunit"><code class="csfmt">\printunsrtglossaryunit</code></a>[<a id="wrglossary.10521"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=section.<a id="wrglossary.10522"></a><a href="#glo:thecounter"><code class="csfmt">\thesection</code></a></span>]{<a id="wrglossary.10523"></a><a href="#glo:ctr.section"><span class="ctrfmt">section</span></a>}
+</pre> There’s now no filtering required, but <a id="wrglossary.10524"></a><a href="#glo:printunsrtglossaryunit"><code class="csfmt">\printunsrtglossaryunit</code></a> is still useful as it automatically suppresses the section header, alters the hyperlink prefix and adds extra spacing after the glossary. However, if you prefer, you can simply do something like: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.10525"></a><a href="#glo:printunsrtglossary*"><code class="csfmt">\printunsrtglossary*</code></a>[<a id="wrglossary.10526"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=section.<a id="wrglossary.10527"></a><a href="#glo:thecounter"><code class="csfmt">\thesection</code></a></span>,
+ <a id="wrglossary.10528"></a><a href="#glo:opt.printgloss.target"><span class="csoptfmt">target</span></a><span class="optfmt">=false</span>]
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.10529"></a><a href="#glo:glossarysection"><code class="csfmt">\glossarysection</code></a>}[2][]{}
+<a id="wrglossary.10530"></a><a href="#glo:printunsrtglossaryunitpostskip"><code class="csfmt">\printunsrtglossaryunitpostskip</code></a>
+</pre> This is done in Example <a href="#ex:minigloss2">145</a>.<p>
+<div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:minigloss2"></a>Example 145: Sub-glossary for a given counter value ordered by use in the section <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example145.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example145.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example145.png" type="image/png" width="354" height="331">Example document demonstrating a mini-glossary that only shows entries recorded in the current section in the order they were recorded in that section.</object> </div><!-- end of resultbox -->
+<p>
+
+</section><!-- end of section sec:printunsrtunit -->
+
+<section id="sec:glossentry"><!-- start of section sec:glossentry --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->8.5. Standalone Entry Items<div class="labellink"><a href="#sec:glossentry">[link]</a></div></h2><!-- end of section header -->
+<p>
+It may be that you don’t want a list but would rather display entry details throughout the document. You can simply do <a id="wrglossary.10531"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a> followed by <a id="wrglossary.10532"></a><a href="#glo:glsentrydesc"><code class="csfmt">\glsentrydesc</code></a>. (Remember that if you don’t want a sorted list, use <a id="wrglossary.10533"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=none</span> or <a id="wrglossary.10534"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=clear</span> to skip the preprocessing of the <a id="wrglossary.10535"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> field.) For example, in the preamble provide a custom command to display the entry’s name and description: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<code class="cmd">\displayterm</code>}[1]{%
+ <code class="cmd">\par</code><code class="cmd">\medskip</code><code class="cmd">\par</code><code class="cmd">\noindent</code>
+ Definition: <a id="wrglossary.10536"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a>{#1}.<code class="cmd">\par</code>
+ <a id="wrglossary.10537"></a><a href="#glo:glsentrydesc"><code class="csfmt">\glsentrydesc</code></a>{#1}
+ <code class="cmd">\par</code><code class="cmd">\medskip</code>
}
-</pre>
-<!--l. 11425--><p class="nopar" >
-</p><!--l. 11427--><p class="indent" > The follow provides some abbreviations:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-259">
-@string{ssi={server-side&#x00A0;includes}}
-@string{html={hypertext&#x00A0;markup&#x00A0;language}}
-@abbreviation{shtml,
-&#x00A0;&#x00A0;short="shtml",
-&#x00A0;&#x00A0;long=&#x00A0;ssi&#x00A0;#&#x00A0;"&#x00A0;enabled&#x00A0;"&#x00A0;#&#x00A0;html,
-&#x00A0;&#x00A0;description={a&#x00A0;combination&#x00A0;of&#x00A0;\gls{html}&#x00A0;and&#x00A0;\gls{ssi}}
+</pre> define your entries, for example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.10538"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{function}{<a id="wrglossary.10539"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={function}</span>,
+ <a id="wrglossary.10540"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a relation or expression involving variables}</span>
}
-@abbreviation{html,
-&#x00A0;&#x00A0;short&#x00A0;="html",
-&#x00A0;&#x00A0;long&#x00A0;&#x00A0;=&#x00A0;html,
-&#x00A0;&#x00A0;description={a&#x00A0;markup&#x00A0;language&#x00A0;for&#x00A0;creating&#x00A0;web&#x00A0;pages}
+</pre> and then later in the text: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\displayterm</code>{function}
+</pre><p>
+However, if may be that you want to use <a id="wrglossary.10541"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> and have commands like <a id="wrglossary.10542"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> link back to the place where the term is described. Instead of using <a id="wrglossary.10543"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a> use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10544"></a><code class="code"><dfn id="glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">entry-label</em>〉</span> is the entry’s label.<p>
+This is designed to behave much like the way the name is displayed in the glossary. It performs the following:
+<ul class="displaylist">
+ <li><span class="bulletitem">•</span>Defines <a id="wrglossary.10545"></a><a href="#glo:glscurrententrylabel"><code class="csfmt">\glscurrententrylabel</code></a> to the entry’s label. This is usually done at the start of the glossary style commands <a id="wrglossary.10546"></a><a href="#glo:glossentry"><code class="csfmt">\glossentry</code></a> and <a id="wrglossary.10547"></a><a href="#glo:subglossentry"><code class="csfmt">\subglossentry</code></a> and may be used by hooks, such as the <a id="wrglossary.10548"></a><a href="#glo:dual.postnamehook">post-name hook</a>. Here the definition is localised so that it’s only available for use in <a id="wrglossary.10549"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a>.<p>
+<li><span class="bulletitem">•</span>Defines <a id="wrglossary.10550"></a><a href="#glo:currentglossary"><code class="csfmt">\currentglossary</code></a> to the entry’s glossary type. This is usually done at the start of commands like <a id="wrglossary.10551"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> and may be used by style hooks. Here the definition is localised so that it’s only available for use in <a id="wrglossary.10552"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a> and <a id="wrglossary.10553"></a><a href="#glo:glssubentryitem"><code class="csfmt">\glssubentryitem</code></a>. The value is obtained by fully expanding: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10554"></a><code class="code"><dfn id="glo:GlsXtrStandaloneGlossaryType"><code class="csfmt">\GlsXtrStandaloneGlossaryType</code></dfn></code></div><!-- end of pinnedbox -->
+ which defaults to the value of the <a id="wrglossary.10555"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> field for the current entry.<p>
+<li><span class="bulletitem">•</span>Increments and display the entry counters if the <a id="wrglossary.10556"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> or <a id="wrglossary.10557"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> package options are set. If the entry doesn’t have a parent, then this does: <pre class="compactcodebox"><a id="wrglossary.10558"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}
+</pre> otherwise it does: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10559"></a><code class="code"><dfn id="glo:GlsXtrStandaloneSubEntryItem"><code class="csfmt">\GlsXtrStandaloneSubEntryItem</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which defaults to <code class="code"><a id="wrglossary.10560"></a><a href="#glo:glssubentryitem"><code class="csfmt">\glssubentryitem</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code> if the entry has a parent but not a grandparent.<p>
+This reflects the behaviour of the predefined hierarchical styles. A bug in pre-version 1.31 used <a id="wrglossary.10561"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a> for all child levels, which doesn’t match the hierarchical glossary styles. If you want to restore this behaviour, just do: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.10562"></a><a href="#glo:GlsXtrStandaloneSubEntryItem"><code class="csfmt">\GlsXtrStandaloneSubEntryItem</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.10563"></a><a href="#glo:glssubentryitem"><code class="csfmt">\glssubentryitem</code></a>{#1}}
+</pre><p>
+<li><span class="bulletitem">•</span>Sets the hyper-target if supported (using <a id="wrglossary.10564"></a><a href="#glo:glstarget"><code class="csfmt">\glstarget</code></a>) and displays the entry name using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10565"></a><code class="code"><dfn id="glo:GlsXtrStandaloneEntryName"><code class="csfmt">\GlsXtrStandaloneEntryName</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which uses <code class="code"><a id="wrglossary.10566"></a><a href="#glo:glstarget"><code class="csfmt">\glstarget</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<a id="wrglossary.10567"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}}</code> by default. Remember that <a id="wrglossary.10568"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a> uses <a id="wrglossary.10569"></a><a href="#glo:glsnamefont"><code class="csfmt">\glsnamefont</code></a> or picks up the style from category attributes such as <a id="wrglossary.10570"></a><a href="#glo:opt.catattr.glossnamefont"><span class="csoptfmt">glossnamefont</span></a>.
+</ul>
+ If you have used <a id="wrglossary.10571"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a> or <a id="wrglossary.10572"></a><a href="#glo:glsxtrnopostpunc"><code class="csfmt">\glsxtrnopostpunc</code></a> in any of your description fields, you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10573"></a><code class="code"><dfn id="glo:glsxtractivatenopost"><code class="csfmt">\glsxtractivatenopost</code></dfn></code></div><!-- end of pinnedbox -->
+ to make these commands behave as they normally do within a glossary. This needs to be placed before: <pre class="compactcodebox"><a id="wrglossary.10574"></a><a href="#glo:glossentrydesc"><code class="csfmt">\glossentrydesc</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}<a id="wrglossary.10575"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a>
+</pre> and scoped. Note that <a id="wrglossary.10576"></a><a href="#glo:glsnonextpages"><code class="csfmt">\glsnonextpages</code></a> and <a id="wrglossary.10577"></a><a href="#glo:glsnextpages"><code class="csfmt">\glsnextpages</code></a> have no effect outside of the glossary and are not intended for use in a standalone context.<p>
+It’s also possible to select a different field (rather than using <a id="wrglossary.10578"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>): <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10579"></a><code class="code"><dfn id="glo:glsxtrglossentryother"><code class="csfmt">\glsxtrglossentryother</code></dfn>{<span class="meta">〈<em class="metainner">header</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The <span class="meta">〈<em class="metainner">field-label</em>〉</span> must be given using its <a id="wrglossary.10580"></a><a href="#glo:dual.internalfieldlabel">internal field label</a>. The <span class="meta">〈<em class="metainner">header</em>〉</span> argument is the code to pass to the third argument of <a id="wrglossary.10581"></a><a href="#glo:glsxtrtitleorpdforheading"><code class="csfmt">\glsxtrtitleorpdforheading</code></a>. It may be left empty in which case the default is determined as follows:
+<ul class="displaylist">
+ <li><span class="bulletitem">•</span>If <code class="csfmt">\glsxtrhead<span class="meta">〈<em class="metainner">field-label</em>〉</span></code> is defined (see §<a href="#sec:headingsadvanced">5.3.3</a>), then <span class="meta">〈<em class="metainner">header</em>〉</span> is <code class="csfmt">\glsxtrhead<span class="meta">〈<em class="metainner">field-label</em>〉</span></code>{entry-label}.<p>
+<li><span class="bulletitem">•</span>Otherwise <span class="meta">〈<em class="metainner">header</em>〉</span> is simply the field value.
+</ul>
+ The <a id="wrglossary.10582"></a><a href="#glo:glsxtrglossentryother"><code class="csfmt">\glsxtrglossentryother</code></a> command internally uses <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10583"></a><code class="code"><dfn id="glo:GlsXtrStandaloneEntryOther"><code class="csfmt">\GlsXtrStandaloneEntryOther</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ instead of <a id="wrglossary.10584"></a><a href="#glo:GlsXtrStandaloneEntryName"><code class="csfmt">\GlsXtrStandaloneEntryName</code></a>, which uses <code class="code"><a id="wrglossary.10585"></a><a href="#glo:glossentrynameother"><code class="csfmt">\glossentrynameother</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{field-label}</code> instead of <code class="code"><a id="wrglossary.10586"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>.<p>
+If you have loaded the <a id="wrglossary.10587"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> package (through the <a id="wrglossary.10588"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a> option) then accessibility support will be provided if there’s a corresponding command: <pre class="compactcodebox"><code class="cmd">\gls<span class="meta">〈<em class="metainner">field-label</em>〉</span>accessdisplay</code>{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}
+</pre> (for example, <a id="wrglossary.10589"></a><a href="#glo:glssymbolaccessdisplay"><code class="csfmt">\glssymbolaccessdisplay</code></a>).<p>
+This means that my custom command can be changed to: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<code class="cmd">\displayterm</code>}[1]{%
+ <code class="cmd">\par</code><code class="cmd">\medskip</code><code class="cmd">\par</code><code class="cmd">\noindent</code>
+ Definition: <a id="wrglossary.10590"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a>{#1}.<code class="cmd">\par</code>
+ <a id="wrglossary.10591"></a><a href="#glo:glsentrydesc"><code class="csfmt">\glsentrydesc</code></a>{#1}
+ <code class="cmd">\par</code><code class="cmd">\medskip</code>
}
-@abbreviation{ssi,
-&#x00A0;&#x00A0;short="ssi",
-&#x00A0;&#x00A0;long&#x00A0;=&#x00A0;ssi,
-&#x00A0;&#x00A0;description={a&#x00A0;simple&#x00A0;interpreted&#x00A0;server-side&#x00A0;scripting&#x00A0;language}
+</pre> If I want numbered definitions, then I can use the package options <a id="wrglossary.10592"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> or <a id="wrglossary.10593"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> and remove the colon: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<code class="cmd">\displayterm</code>}[1]{%
+ <code class="cmd">\par</code><code class="cmd">\medskip</code><code class="cmd">\par</code><code class="cmd">\noindent</code>
+ Definition <a id="wrglossary.10594"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a>{#1}.<code class="cmd">\par</code>
+ <a id="wrglossary.10595"></a><a href="#glo:glsentrydesc"><code class="csfmt">\glsentrydesc</code></a>{#1}
+ <code class="cmd">\par</code><code class="cmd">\medskip</code>
}
-</pre>
-<!--l. 11449--><p class="nopar" >
-</p><!--l. 11451--><p class="indent" > Here are some symbols:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-260">
-preamble{"\providecommand{\mtx}[1]{\boldsymbol{#1}}"}
-@symbol{M,
-&#x00A0;&#x00A0;name={$\mtx{M}$},
-&#x00A0;&#x00A0;text={\mtx{M}},
-&#x00A0;&#x00A0;description={a&#x00A0;matrix}
+</pre> The counter label uses a dot after the number by default but this can be changed to a colon: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.10596"></a><a href="#glo:glsentrycounterlabel"><code class="csfmt">\glsentrycounterlabel</code></a>}{<a id="wrglossary.10597"></a><a href="#glo:theglossaryentry"><code class="csfmt">\theglossaryentry</code></a>:<code class="cmd">\space</code>}
+</pre> It’s now possible to not only use <a id="wrglossary.10598"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> to link back to the definition but also use <a id="wrglossary.10599"></a><a href="#glo:glsrefentry"><code class="csfmt">\glsrefentry</code></a> to reference the counter and <a id="wrglossary.10600"></a><a href="#glo:glsxtrpageref"><code class="csfmt">\glsxtrpageref</code></a> to reference the page number.<p>
+If I want the description to behave more like it does in a glossary in need to make the following modification: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<code class="cmd">\displayterm</code>}[1]{%
+ <code class="cmd">\par</code><code class="cmd">\medskip</code><code class="cmd">\par</code><code class="cmd">\noindent</code>
+ Definition <a id="wrglossary.10601"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a>{#1}.<code class="cmd">\par</code>
+ <code class="cmd">\begingroup</code>
+ <a id="wrglossary.10602"></a><a href="#glo:glsxtractivatenopost"><code class="csfmt">\glsxtractivatenopost</code></a>
+ <a id="wrglossary.10603"></a><a href="#glo:glossentrydesc"><code class="csfmt">\glossentrydesc</code></a>{#1}<a id="wrglossary.10604"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a>
+ <code class="cmd">\endgroup</code>
+ <code class="cmd">\par</code><code class="cmd">\medskip</code>
}
-@symbol{v,
-&#x00A0;&#x00A0;name={$\vec{v}$},
-&#x00A0;&#x00A0;text={\vec{v}},
-&#x00A0;&#x00A0;description={a&#x00A0;vector}
+</pre> (Note the grouping to localise <a id="wrglossary.10605"></a><a href="#glo:glsxtractivatenopost"><code class="csfmt">\glsxtractivatenopost</code></a>.)<p>
+You can also use <a id="wrglossary.10606"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a> within section headings. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\section</code>{<a id="wrglossary.10607"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a>{function}}
+</pre><p>
+If <a id="wrglossary.10608"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a> occurs in a section title and <a id="wrglossary.10609"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> has been loaded, then <a id="wrglossary.10610"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a> will expand in the PDF bookmark as: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10611"></a><code class="code"><dfn id="glo:GlsXtrStandaloneEntryPdfName"><code class="csfmt">\GlsXtrStandaloneEntryPdfName</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This defaults to <code class="code"><a id="wrglossary.10612"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code> The page headers and table of contents will use <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10613"></a><code class="code"><dfn id="glo:GlsXtrStandaloneEntryHeadName"><code class="csfmt">\GlsXtrStandaloneEntryHeadName</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which defaults to <code class="code"><a id="wrglossary.10614"></a><a href="#glo:glsxtrheadname"><code class="csfmt">\glsxtrheadname</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>. For example, to ensure that the name is displayed in <a id="wrglossary.10615"></a><a href="#glo:idx.sentencecase">sentence case</a> in the title, PDF bookmarks and heading: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.10616"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{<a id="wrglossary.10617"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>}{<a id="wrglossary.10618"></a><a href="#glo:opt.catattr.glossname"><span class="csoptfmt">glossname</span></a>}{firstuc}
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.10619"></a><a href="#glo:GlsXtrStandaloneEntryPdfName"><code class="csfmt">\GlsXtrStandaloneEntryPdfName</code></a>}[1]{<a id="wrglossary.10620"></a><a href="#glo:Glsentryname"><code class="csfmt">\Glsentryname</code></a>{#1}}
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.10621"></a><a href="#glo:GlsXtrStandaloneEntryHeadName"><code class="csfmt">\GlsXtrStandaloneEntryHeadName</code></a>}[1]{<a id="wrglossary.10622"></a><a href="#glo:Glsentryname"><code class="csfmt">\Glsentryname</code></a>{#1}}
+</pre> Note that this requires <a id="wrglossary.10623"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ to ensure that <a id="wrglossary.10624"></a><a href="#glo:Glsentryname"><code class="csfmt">\Glsentryname</code></a> expands. An alternative is to use <a id="wrglossary.10625"></a><a href="#glo:Glsxtrusefield"><code class="csfmt">\Glsxtrusefield</code></a>.<p>
+If <a id="wrglossary.10626"></a><a href="#glo:glsxtrglossentryother"><code class="csfmt">\glsxtrglossentryother</code></a> occurs in a section title and <a id="wrglossary.10627"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> has been loaded, then <a id="wrglossary.10628"></a><a href="#glo:glsxtrglossentryother"><code class="csfmt">\glsxtrglossentryother</code></a> will expand in the PDF bookmark as: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10629"></a><code class="code"><dfn id="glo:GlsXtrStandaloneEntryPdfOther"><code class="csfmt">\GlsXtrStandaloneEntryPdfOther</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This defaults to the value of the given field. The page headers and table of contents will use the <span class="meta">〈<em class="metainner">header</em>〉</span> argument, if not empty, otherwise it will use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10630"></a><code class="code"><dfn id="glo:GlsXtrStandaloneEntryHeadOther"><code class="csfmt">\GlsXtrStandaloneEntryHeadOther</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does <code class="csfmt">\glsxtrhead<span class="meta">〈<em class="metainner">field-label</em>〉</span></code>, if it exists, or otherwise it just does the value of the given field (which can be obtained with <a id="wrglossary.10631"></a><a href="#glo:glsxtrusefield"><code class="csfmt">\glsxtrusefield</code></a>).<p>
+If you’re using a page style or table of contents that doesn’t use <a id="wrglossary.10632"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a> or <a id="wrglossary.10633"></a><a href="#glo:markboth"><code class="csfmt">\markboth</code></a> or <a id="wrglossary.10634"></a><a href="#glo:@starttoc"><code class="csfmt">\@starttoc</code></a> then you need to insert <a id="wrglossary.10635"></a><a href="#glo:glsxtrmarkhook"><code class="csfmt">\glsxtrmarkhook</code></a> and <a id="wrglossary.10636"></a><a href="#glo:@glsxtrinmark"><code class="csfmt">\@glsxtrinmark</code></a> at the start of the header or table of contents either scoped or afterwards cancelled with <a id="wrglossary.10637"></a><a href="#glo:@glsxtrnotinmark"><code class="csfmt">\@glsxtrnotinmark</code></a> and <a id="wrglossary.10638"></a><a href="#glo:glsxtrrestoremarkhook"><code class="csfmt">\glsxtrrestoremarkhook</code></a>, see §<a href="#sec:headingsadvanced">5.3.3</a>.<p>
+
+</section><!-- end of section sec:glossentry -->
+
+<section id="sec:glosstylemods"><!-- start of section sec:glosstylemods --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->8.6. Glossary Style Modifications<div class="labellink"><a href="#sec:glosstylemods">[link]</a></div></h2><!-- end of section header -->
+<p>
+The <a id="wrglossary.10639"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package redefines <a id="wrglossary.10640"></a><a href="#glo:setglossarystyle"><code class="csfmt">\setglossarystyle</code></a>, and it now includes a hook that’s performed before the style is set: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10641"></a><code class="code"><dfn id="glo:glsxtrpreglossarystyle"><code class="csfmt">\glsxtrpreglossarystyle</code></dfn></code></div><!-- end of pinnedbox -->
+ This allows for new style commands that aren’t provided by the base <a id="wrglossary.10642"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package to be initialised in the event that a style that doesn’t redefine them is used. The default definition is: <pre class="compactcodebox"><code class="cmd">\newcommand</code>{<a id="wrglossary.10643"></a><a href="#glo:glsxtrpreglossarystyle"><code class="csfmt">\glsxtrpreglossarystyle</code></a>}{<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.10644"></a><a href="#glo:glssubgroupheading"><code class="csfmt">\glssubgroupheading</code></a>}[4]{<a id="wrglossary.10645"></a><a href="#glo:glsgroupheading"><code class="csfmt">\glsgroupheading</code></a>{##4}}<span class="comment">% </span>
}
-@symbol{S,
-&#x00A0;&#x00A0;name={$\mathcal{S}$},
-&#x00A0;&#x00A0;text={\mathcal{S}},
-&#x00A0;&#x00A0;description={a&#x00A0;set}
+</pre> If you prefer a different default, you can redefine this command as appropriate.<p>
+The commands <a id="wrglossary.10646"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a> and <a id="wrglossary.10647"></a><a href="#glo:glossentrydesc"><code class="csfmt">\glossentrydesc</code></a> are modified to take into account the <a id="wrglossary.10648"></a><a href="#glo:opt.catattr.glossname"><span class="csoptfmt">glossname</span></a>, <a id="wrglossary.10649"></a><a href="#glo:opt.catattr.glossnamefont"><span class="csoptfmt">glossnamefont</span></a>, <a id="wrglossary.10650"></a><a href="#glo:opt.catattr.glossdesc"><span class="csoptfmt">glossdesc</span></a> and <a id="wrglossary.10651"></a><a href="#glo:opt.catattr.glossdescfont"><span class="csoptfmt">glossdescfont</span></a> attributes (see §<a href="#sec:categories">10</a>). This means you can make simple font or case-changing modifications to the name and description without defining a new glossary style.<p>
+The command <a id="wrglossary.10652"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a> is modified to take into account the <a id="wrglossary.10653"></a><a href="#glo:opt.catattr.glosssymbolfont"><span class="csoptfmt">glosssymbolfont</span></a> attribute. Note that, unlike the above, there’s no corresponding attribute to change the case as it’s usually not appropriate to change the case of a symbol (and for some symbols, such as pictographs, there’s no concept of case). If <a id="wrglossary.10654"></a><a href="#glo:texorpdfstring"><code class="csfmt">\texorpdfstring</code></a> has been defined <a id="wrglossary.10655"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a> will be defined to do: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.10656"></a><a href="#glo:texorpdfstring"><code class="csfmt">\texorpdfstring</code></a>{<span class="meta">〈<em class="metainner">TeX code</em>〉</span>}{<span class="meta">〈<em class="metainner">PDF</em>〉</span>}
+</pre> The <span class="meta">〈<em class="metainner">TeX code</em>〉</span> part is robust and deals with the actual typesetting of the symbol. The <span class="meta">〈<em class="metainner">PDF</em>〉</span> part is simply: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10657"></a><code class="code"><dfn id="glo:glsentrypdfsymbol"><code class="csfmt">\glsentrypdfsymbol</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which is defined to just do <code class="code"><a id="wrglossary.10658"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>. The chances are that the code in the <a id="wrglossary.10659"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> key won’t be valid in the PDF bookmarks, so you can redefine <a id="wrglossary.10660"></a><a href="#glo:glsentrypdfsymbol"><code class="csfmt">\glsentrypdfsymbol</code></a> to use a more appropriate field. (If you do redefine this command, remember that it needs to fully expand.)<p>
+For example, if you are using <a id="wrglossary.10661"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a>, you could use the <a id="wrglossary.10662"></a><a href="#glo:opt.gloskey.symbolaccess"><span class="csoptfmt">symbolaccess</span></a> field: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.10663"></a><a href="#glo:glsentrypdfsymbol"><code class="csfmt">\glsentrypdfsymbol</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.10664"></a><a href="#glo:glsentrysymbolaccess"><code class="csfmt">\glsentrysymbolaccess</code></a>{#1}}
+</pre> Alternatively, if you are using <a id="wrglossary.10665"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> you can use the TeX parser library to interpret a copy of the <a id="wrglossary.10666"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> field and use that. For example, with the <a id="wrglossary.10667"></a><a href="#glo:idx.resourceopt">resource options</a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.10668"></a><a href="#glo:opt.resource.replicate-fields"><span class="csoptfmt">replicate-fields</span></a><span class="optfmt">={<a id="wrglossary.10669"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a>=<a id="wrglossary.10670"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a>}</span>,
+<a id="wrglossary.10671"></a><a href="#glo:opt.resource.interpret-fields"><span class="csoptfmt">interpret-fields</span></a><span class="optfmt">=<a id="wrglossary.10672"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a></span>
+</pre> This copies the value of the <a id="wrglossary.10673"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> field to the <a id="wrglossary.10674"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> field (<a id="wrglossary.10675"></a><a href="#glo:opt.resource.replicate-fields"><span class="csoptfmt">replicate-fields</span></a>) and then replaces the value of the <a id="wrglossary.10676"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> field with its interpreted value (<a id="wrglossary.10677"></a><a href="#glo:opt.resource.interpret-fields"><span class="csoptfmt">interpret-fields</span></a>).<p>
+This means you can then do: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.10678"></a><a href="#glo:glsentrypdfsymbol"><code class="csfmt">\glsentrypdfsymbol</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.10679"></a><a href="#glo:glsentryuseri"><code class="csfmt">\glsentryuseri</code></a>{#1}}
+</pre> (You may need XeLaTeX or LuaLaTeX with this method.) This allows <a id="wrglossary.10680"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a> to be used in a section heading with standalone definitions. See the <a id="wrglossary.10681"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> manual for further details about the TeX interpreter.<p>
+If you want to adapt a style to use another field instead of <a id="wrglossary.10682"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10683"></a><code class="code"><dfn id="glo:glossentrynameother"><code class="csfmt">\glossentrynameother</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This behaves just like <a id="wrglossary.10684"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a> (that is, it obeys the <a id="wrglossary.10685"></a><a href="#glo:opt.catattr.glossname"><span class="csoptfmt">glossname</span></a> attribute, uses either the <a id="wrglossary.10686"></a><a href="#glo:opt.catattr.glossnamefont"><span class="csoptfmt">glossnamefont</span></a> attribute or <a id="wrglossary.10687"></a><a href="#glo:glsnamefont"><code class="csfmt">\glsnamefont</code></a> to format the text, and uses the <a id="wrglossary.10688"></a><a href="#glo:dual.postnamehook">post-name hook</a>) but the text is obtained from the field given <span class="meta">〈<em class="metainner">field-label</em>〉</span> instead of <a id="wrglossary.10689"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>. The <span class="meta">〈<em class="metainner">field-label</em>〉</span> argument must be the <a id="wrglossary.10690"></a><a href="#glo:dual.internalfieldlabel">internal field label</a> (for example <code class="code">desc</code> rather than <code class="code">description</code>).<p>
+
+</section><!-- end of section sec:glosstylemods -->
+
+<section id="sec:postnamehooks"><!-- start of section sec:postnamehooks --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->8.6.1. Post-Name Hooks<div class="labellink"><a href="#sec:postnamehooks">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+The <a id="wrglossary.10691"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package adds a hook to <a id="wrglossary.10692"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a> and <a id="wrglossary.10693"></a><a href="#glo:Glossentryname"><code class="csfmt">\Glossentryname</code></a> (which is used in <a id="wrglossary.10694"></a><a href="#glo:idx.glossarystyle">glossary styles</a> to display the entry’s name): <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10695"></a><code class="code"><dfn id="glo:glsxtrpostnamehook"><code class="csfmt">\glsxtrpostnamehook</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is the main <a id="wrglossary.10696"></a><a href="#glo:dual.postnamehook">post-name hook</a>, which implements additional hooks to allow for customisation. By default, <a id="wrglossary.10697"></a><a href="#glo:glsxtrpostnamehook"><code class="csfmt">\glsxtrpostnamehook</code></a> checks the <a id="wrglossary.10698"></a><a href="#glo:opt.catattr.indexname"><span class="csoptfmt">indexname</span></a> attribute. If the attribute exists for the category to which the entry belongs, then the name is automatically indexed using: <pre class="compactcodebox"><a id="wrglossary.10699"></a><a href="#glo:glsxtrdoautoindexname"><code class="csfmt">\glsxtrdoautoindexname</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<a id="wrglossary.10700"></a><a href="#glo:opt.catattr.indexname"><span class="csoptfmt">indexname</span></a>}
+</pre> See §<a href="#sec:autoindex">12</a> for further details.<p>
+The post-name hook <a id="wrglossary.10701"></a><a href="#glo:glsxtrpostnamehook"><code class="csfmt">\glsxtrpostnamehook</code></a> will also use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10702"></a><code class="code"><dfn id="glo:glsxtrpostnamecategory"><code class="csfmt">\glsxtrpostname<span class="meta">〈<em class="metainner">category</em>〉</span></code></dfn></code></div><!-- end of pinnedbox -->
+ if it exists. You can use <a id="wrglossary.10703"></a><a href="#glo:glscurrententrylabel"><code class="csfmt">\glscurrententrylabel</code></a> to obtain the entry label with the definition of this command. For example, suppose you are using a glossary style the doesn’t display the symbol, you can insert the symbol after the name for a particular category, say, the <span class="qt">“symbol”</span> category: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<code class="cmd">\glsxtrpostnamesymbol</code>}{<code class="cmd">\space</code>
+ (<a id="wrglossary.10704"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a>{<a id="wrglossary.10705"></a><a href="#glo:glscurrententrylabel"><code class="csfmt">\glscurrententrylabel</code></a>})}
+</pre> For convenience, you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10706"></a><code class="code"><dfn id="glo:glsdefpostname"><code class="csfmt">\glsdefpostname</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">definition</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is simply a shortcut for: <pre class="compactcodebox"><a id="wrglossary.10707"></a><a href="#glo:csdef"><code class="csfmt">\csdef</code></a>{<a id="wrglossary.10708"></a><a href="#glo:glsxtrpostnamecategory"><code class="csfmt">\glsxtrpostname<span class="meta">〈<em class="metainner">category</em>〉</span></code></a>}{<span class="meta">〈<em class="metainner">definition</em>〉</span>}
+</pre> Note that it doesn’t check if the command has already been defined.<p>
+The <a id="wrglossary.10709"></a><a href="#glo:dual.postnamehook">post-name hook</a> also does: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10710"></a><code class="code"><dfn id="glo:glsextrapostnamehook"><code class="csfmt">\glsextrapostnamehook</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ (before <a id="wrglossary.10711"></a><a href="#glo:glsxtrpostnamecategory"><code class="csfmt">\glsxtrpostname<span class="meta">〈<em class="metainner">category</em>〉</span></code></a>) to allow for additional non-category related code. This does nothing by default.<p>
+
+</section><!-- end of section sec:postnamehooks -->
+
+<section id="sec:postdeschooks"><!-- start of section sec:postdeschooks --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->8.6.2. Post-Description Hooks<div class="labellink"><a href="#sec:postdeschooks">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+The <a id="wrglossary.10712"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package provides the hook <a id="wrglossary.10713"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a>, which is placed after the description in some of the predefined styles. The <a id="wrglossary.10714"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> package modifies the predefined styles to ensure that they all use this hook. This provides a convenient way to make slight adjustments, such as appending content after the description, without having to define a custom glossary style.<p>
+The <a id="wrglossary.10715"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package redefines <a id="wrglossary.10716"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a> so that it includes the following hook:<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10717"></a><code class="code"><dfn id="glo:glsxtrpostdescription"><code class="csfmt">\glsxtrpostdescription</code></dfn></code></div><!-- end of pinnedbox -->
+ This new hook simply performs the <a id="wrglossary.10718"></a><a href="#glo:dual.catpostdeschook">category post-description hook</a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.10719"></a><a href="#glo:glsxtrpostdescription"><code class="csfmt">\glsxtrpostdescription</code></a>}{<span class="comment">% </span>
+ <code class="cmd">\csuse</code>{glsxtrpostdesc<a id="wrglossary.10720"></a><a href="#glo:glscategory"><code class="csfmt">\glscategory</code></a>{<a id="wrglossary.10721"></a><a href="#glo:glscurrententrylabel"><code class="csfmt">\glscurrententrylabel</code></a>}}<span class="comment">% </span>
}
-</pre>
-<!--l. 11472--><p class="nopar" >
-</p><!--l. 11474--><p class="indent" > To ensure that <a
- id="dx1-76009"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> can find out which entries have been used in the
-document, you need the <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><a
- id="dx1-76010"></a> package option:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-261">
-\usepackage[record]{glossaries-extra}
-</pre>
-<!--l. 11478--><p class="nopar" > If this option&#8217;s value is omitted (as above), the normal indexing will be switched off,
-since <a
- id="dx1-76011"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> can also sort the entries and collate the locations.
-</p><!--l. 11483--><p class="indent" > If you still want to use an indexing application (for example, you need a custom
-<a
- id="dx1-76012"></a><a
-href="#glo:xindy"><span
-class="cmtt-10">xindy</span></a> rule), then just use <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=hybrid</span><a
- id="dx1-76013"></a> and continue to use <span
-class="cmtt-10">\makeglossaries </span>and
-<span
-class="cmtt-10">\printglossary </span>(or <span
-class="cmtt-10">\printglossaries</span>), but you also need to instruct
-<a
- id="dx1-76014"></a><span
-class="cmtt-10">bib2gls </span>to omit sorting to save time and to prevent the <span
-class="cmss-10">sort</span><a
- id="dx1-76015"></a> key from being
-set.
-</p><!--l. 11490--><p class="indent" > The <span
-class="cmtt-10">.glstex </span>file created by <a
- id="dx1-76016"></a><span
-class="cmtt-10">bib2gls </span>is loaded using:
-</p><!--l. 11491--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-76017"></a> <span
-class="cmtt-10">\glsxtrresourcefile[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">filename</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11493--><p class="noindent" >
-(Don&#8217;t include the file extension in &#x27E8;<span
-class="cmti-10">filename</span>&#x27E9;.) There&#8217;s a shortcut version
-(recommended over the above) that sets &#x27E8;<span
-class="cmti-10">filename</span>&#x27E9; to use <span
-class="cmtt-10">\jobname</span>:
-</p><!--l. 11496--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-76018"></a> <span
-class="cmtt-10">\GlsXtrLoadResources[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 11498--><p class="noindent" >
-On the first use, this command is a shortcut for </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\glsxtrresourcefile[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">\jobname</span><span
-class="cmsy-10">}</span>
-</div>
-</div> On subsequent use,<span class="footnote-mark"><a
-href="#fn1x10" id="fn1x10-bk"><sup class="textsuperscript">10.1</sup></a></span><a
- id="x1-76019f1"></a>&#x00A0;this
-command is a shortcut for <div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\glsxtrresourcefile[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">\jobname-</span>&#x27E8;<span
-class="cmitt-10">n</span>&#x27E9;<span
-class="cmsy-10">}</span>
-</div>
-</div> where &#x27E8;<span
-class="cmti-10">n</span>&#x27E9; is the current value of
-<!--l. 11510--><p class="indent" > <hr><div title="Definition"><span
-class="cmtt-10">\glsxtrresourcecount </span></div><hr>
-</p><!--l. 11511--><p class="noindent" >
-which is incremented at the end of <span
-class="cmtt-10">\GlsXtrLoadResources</span>. Any advisory notes
-regarding <span
-class="cmtt-10">\glsxtrresourcefile </span>also apply to <span
-class="cmtt-10">\GlsXtrLoadResources</span>.
-</p><!--l. 11516--><p class="indent" > The <span
-class="cmtt-10">\glsxtrresourcefile </span>command writes the line </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\glsxtr@resource{</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">filename</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div>
-</div> to the <span
-class="cmtt-10">.aux </span>file and will input &#x27E8;<span
-class="cmti-10">filename</span>&#x27E9;<span
-class="cmtt-10">.glstex </span>if it
-exists.<span class="footnote-mark"><a
-href="#fn2x10" id="fn2x10-bk"><sup class="textsuperscript">10.2</sup></a></span><a
- id="x1-76020f2"></a>
-
-
-
-<!--l. 11526--><p class="indent" > Since the <span
-class="cmtt-10">.glstex </span>file won&#8217;t exist on the first LaTeX&#x00A0;run, the <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><a
- id="dx1-76021"></a> package
-option additionally switches on <a
-href="#styopt.undefaction"><span
-class="cmss-10">undefaction</span></a><span
-class="cmss-10">=warn</span><a
- id="dx1-76022"></a>. Any use of commands like <span
-class="cmtt-10">\gls </span>or
-<span
-class="cmtt-10">\glstext </span>will produce ?? in the document, since the entries are undefined at this
-point. Once <a
- id="dx1-76023"></a><span
-class="cmtt-10">bib2gls </span>has created the <span
-class="cmtt-10">.glstex </span>file the references should be resolved.
-This may cause a shift in the locations if the actual text produced once the entry is
-defined is significantly larger than the placeholder ?? (as this can alter the page
-breaking).
-</p><!--l. 11536--><p class="indent" > Note that as from v1.12, <span
-class="cmtt-10">\glsxtrresourcefile </span>temporarily switches the
-category code of <span
-class="cmtt-10">@ </span>to 11 (letter) while it reads the file to allow for any internal
-commands stored in the location field.
-</p>
-<!--l. 11541--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">10.1 </span> <a
- id="sec:bib2glsselection"></a>Selection</h3>
-<!--l. 11544--><p class="noindent" >The default behaviour is for <a
- id="dx1-77001"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> to select all entries that have a record in the
-<span
-class="cmtt-10">.aux </span>file, and any dependent entries (including parent and cross-references). The
-<span
-class="cmtt-10">glsignore </span>format (for example, <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls[format=glsignore]{duck}</span></span></span>) is recognised by
-<a
- id="dx1-77002"></a><span
-class="cmtt-10">bib2gls </span>as a special ignored record. This means that it will match the selection
-criteria but the record won&#8217;t be added to the location list. This means that you won&#8217;t
-get spurious commas in the location list (as can happen with the other indexing
-methods), so you can do, for example,
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-262">
-\GlsXtrSetDefaultNumberFormat{glsignore}
-</pre>
-<!--l. 11556--><p class="nopar" > at the start of the front matter and
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-263">
-\GlsXtrSetDefaultNumberFormat{glsnumberformat}
-</pre>
-<!--l. 11560--><p class="nopar" > at the start of the main matter to prevent any records in the front matter from
-occurring in the location lists.
-</p><!--l. 11564--><p class="indent" > <div class="important" title="Important Note"> Note that commands like <span
-class="cmtt-10">\glsaddall </span>and <span
-class="cmtt-10">\glsaddallunused </span>don&#8217;t
-work with <a
- id="dx1-77003"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> as the command has to iterate over the internal lists of
-defined entry labels, which will be empty on the first run and on subsequent
-runs will only contain those entries that have been selected by <a
- id="dx1-77004"></a><span
-class="cmtt-10">bib2gls</span>.
-</div>
-</p><!--l. 11569--><p class="noindent" >
-</p><!--l. 11571--><p class="indent" > If you want to add all entries to the glossary, you need to tell <a
- id="dx1-77005"></a><span
-class="cmtt-10">bib2gls </span>this in the
-options list. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-264">
-\GlsXtrLoadResources[src={terms},selection={all}]
-</pre>
-<!--l. 11576--><p class="nopar" > This will add all entries, regardless of whether or not they have any records in the
-<span
-class="cmtt-10">.aux </span>file. Those that don&#8217;t have any records will have an empty location list. See the
-<a
- id="dx1-77006"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> user manual for more details of this option.
-</p><!--l. 11582--><p class="noindent" >
-</p>
-<!--l. 11582--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">10.2 </span> <a
- id="sec:bib2glssortprint"></a>Sorting and Displaying the Glossary</h3>
-<!--l. 11585--><p class="noindent" >There are many sorting options provided by <a
- id="dx1-78001"></a><span
-class="cmtt-10">bib2gls</span>. The default is to sort
-according to the system locale. If the document has a language setting, you can use
-<span
-class="cmtt-10">sort=doc </span>to instruct <a
- id="dx1-78002"></a><span
-class="cmtt-10">bib2gls </span>to sort according to that. (The language tag obtained
-from <span
-class="cmss-10">tracklang</span><a
- id="dx1-78003"></a>&#8217;s interface is written to the <span
-class="cmtt-10">.aux </span>file.) For a multilingual document
-you need to explicitly set the locale using a well-formed language tag. For
-example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-265">
-\GlsXtrLoadResources[
-&#x00A0;&#x00A0;src=terms,&#x00A0;%&#x00A0;data&#x00A0;in&#x00A0;terms.bib
-&#x00A0;&#x00A0;sort=de-DE-1996&#x00A0;%&#x00A0;sort&#x00A0;according&#x00A0;to&#x00A0;this&#x00A0;locale
-]
-</pre>
-<!--l. 11598--><p class="nopar" > The locale-sensitive sort methods usually ignore most punctuation so for lists of
-symbols you may find it more appropriate to use one of the letter-base sort methods
-that sort according to the Unicode value of each character. Alternatively you can
-provide a custom rule. See the <a
- id="dx1-78004"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> manual for full details of all the available sort
-methods.
-</p><!--l. 11607--><p class="indent" > Since the <span
-class="cmtt-10">.glstex </span>file only defines those references required within the document
-(selected according to the <span
-class="cmtt-10">selection </span>option) and the definitions have been written in
-the order corresponding to <a
- id="dx1-78005"></a><span
-class="cmtt-10">bib2gls</span>&#8217;s sorted list, the glossaries can simply be
-displayed using <span
-class="cmtt-10">\printunsrtglossary </span>(or <span
-class="cmtt-10">\printunsrtglossaries</span>), described in
-<a
-href="#sec:printunsrt"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">11.2</span> </a><a
-href="#sec:printunsrt">Display All Entries Without Sorting or Indexing<!--tex4ht:ref: sec:printunsrt --></a>.
-</p><!--l. 11615--><p class="indent" > Suppose the <span
-class="cmtt-10">.bib </span>examples shown above have been stored in the files <span
-class="cmtt-10">terms.bib</span>,
-<span
-class="cmtt-10">abbrvs.bib </span>and <span
-class="cmtt-10">symbols.bib </span>which may either be in the current directory or on
-TeX&#8217;s path. Then the document might look like:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-266">
-\documentclass{article}
-\usepackage[record]{glossaries-extra}
-\setabbreviationstyle{long-short-desc}
-\GlsXtrLoadResources[src={terms,abbrvs,symbols}]
-\begin{document}
-\gls{bird}
-\gls{shtml}
-\gls{M}
-\printunsrtglossaries
-\end{document}
-</pre>
-<!--l. 11637--><p class="nopar" > The document build process (assuming the document is called <span
-class="cmtt-10">mydoc</span>) is:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-267">
-pdflatex&#x00A0;mydoc
-bib2gls&#x00A0;mydoc
-pdflatex&#x00A0;mydoc
-</pre>
-<!--l. 11644--><p class="nopar" > This creates a single glossary containing the entries: <span
-class="cmtt-10">bird</span>, <span
-class="cmtt-10">duck</span>, <span
-class="cmtt-10">goose</span>, <span
-class="cmtt-10">html</span>, <span
-class="cmtt-10">M</span>,
-<span
-class="cmtt-10">shtml </span>and <span
-class="cmtt-10">ssi </span>(in that order). The <span
-class="cmtt-10">bird</span>, <span
-class="cmtt-10">shtml </span>and <span
-class="cmtt-10">M </span>entries were added because
-<a
- id="dx1-78006"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> detected (from the <span
-class="cmtt-10">.aux </span>file) that they had been used in the document. The
-other entries were added because <a
- id="dx1-78007"></a><span
-class="cmtt-10">bib2gls </span>detected (from the <span
-class="cmtt-10">.bib </span>files) that they
-are referenced by the used entries. In the case of <span
-class="cmtt-10">duck </span>and <span
-class="cmtt-10">goose</span>, they are
-in the <span
-class="cmss-10">see</span><a
- id="dx1-78008"></a> field for <span
-class="cmtt-10">bird</span>. In the case of <span
-class="cmtt-10">ssi </span>and <span
-class="cmtt-10">html</span>, they are referenced
-in the <span
-class="cmss-10">description</span><a
- id="dx1-78009"></a> field of <span
-class="cmtt-10">shtml</span>. These cross-referenced entries won&#8217;t have
-a location list when the glossary is first displayed, but depending on how
-they are referenced, they may pick up a location list on the next document
-build.
-</p><!--l. 11661--><p class="indent" > The entries can be separated into different glossaries with different sort
-methods:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-268">
-\documentclass{article}
-\usepackage[record,abbreviations,symbols]{glossaries-extra}
-\setabbreviationstyle{long-short-desc}
-\GlsXtrLoadResources[src={terms},sort={en-GB},type=main]
-\GlsXtrLoadResources
-&#x00A0;[src={abbrvs},sort={letter-nocase},type=abbreviations]
-\GlsXtrLoadResources
-&#x00A0;[src={symbols},sort={use},type={symbols}]
-\begin{document}
-\gls{bird}
-\gls{shtml}
-\gls{M}
-\printunsrtglossaries
-\end{document}
-</pre>
-<!--l. 11687--><p class="nopar" >
-</p><!--l. 11689--><p class="indent" > Or you can have multiple instance of <span
-class="cmtt-10">\GlsXtrLoadResources </span>with the same
-<span
-class="cmtt-10">type</span>, which will produce a glossary with ordered sub-blocks. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-269">
-\documentclass{article}
-\usepackage[record,style=indexgroup]{glossaries-extra}
-\setabbreviationstyle{long-short-desc}
-\GlsXtrLoadResources
-&#x00A0;[src={abbrvs},sort={letter-nocase},type=main,
-&#x00A0;&#x00A0;group={Abbreviations}]
-\GlsXtrLoadResources
-&#x00A0;[src={symbols},sort={use},type=main,
-&#x00A0;&#x00A0;group={Symbols}]
-\GlsXtrLoadResources[src={terms},sort={en-GB},type=main]
-\begin{document}
-\gls{bird}
-\gls{shtml}
-\gls{M}
-\printunsrtglossaries
-\end{document}
-</pre>
-<!--l. 11718--><p class="nopar" > This will result in a glossary where the first group has the title &#8220;Abbreviations&#8221;, the
-second group has the title &#8220;Symbols&#8221; and then follow the usual letter groups. Note
-that for this example to work, you must run <a
- id="dx1-78010"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> with the <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">--group</span></span></span> (or <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">-g</span></span></span>)
-switch. For example, if the document is called <span
-class="cmtt-10">myDoc.tex</span>:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-270">
-pdflatex&#x00A0;myDoc
-bib2gls&#x00A0;-g&#x00A0;myDoc
-pdflatex&#x00A0;myDoc
-</pre>
-<!--l. 11729--><p class="nopar" > The value of the <span
-class="cmss-10">group</span><a
- id="dx1-78011"></a> field must always be a label. You can set the corresponding
-title with <span
-class="cmtt-10">\glsxtrsetgrouptitle </span>(see <a
-href="#sec:glosstylemods"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.11</span> </a><a
-href="#sec:glosstylemods">Glossary Style
-Modifications<!--tex4ht:ref: sec:glosstylemods --></a>). If no title is set then the label is used as the group title.
-</p><!--l. 11735--><p class="indent" > You can provide your own custom sort rule. For example, if you are using
-<span class="HoLogo-XeLaTeX"><span class="HoLogo-Xe">X<span class="HoLogo-e">&#x018e;</span></span><span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span></span>&#x00A0;or Lua<span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span>: </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\GlsXtrLoadResources[</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;src=terms,</span><span
-class="cmtt-10">&#x00A0;%</span><span
-class="cmtt-10">&#x00A0;entries</span><span
-class="cmtt-10">&#x00A0;in</span><span
-class="cmtt-10">&#x00A0;terms.bib</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;sort=custom,</span><span
-class="cmtt-10">&#x00A0;%</span><span
-class="cmtt-10">&#x00A0;custom</span><span
-class="cmtt-10">&#x00A0;sort</span><span
-class="cmtt-10">&#x00A0;rule</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;sort-rule=</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">%</span><span
-class="cmtt-10">&#x00A0;required</span><span
-class="cmtt-10">&#x00A0;with</span><span
-class="cmtt-10">&#x00A0;sort=custom</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;&aelig;;&AElig;</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;a;</span><span
-class="cmtt-10">&aacute;</span><span
-class="cmtt-10">;</span><span
-class="cmtt-10">å</span><span
-class="cmtt-10">;</span><span
-class="cmtt-10">&auml;</span><span
-class="cmtt-10">,</span><span
-class="cmtt-10">&Auml;</span><span
-class="cmtt-10">;</span><span
-class="cmtt-10">&Aacute;</span><span
-class="cmtt-10">;</span><span
-class="cmtt-10">Å</span><span
-class="cmtt-10">;</span><span
-class="cmtt-10">&Auml;</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;b,B</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;c;</span><span
-class="cmtt-10">&#263;</span><span
-class="cmtt-10">,C;</span><span
-class="cmtt-10">&#262;</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;d,D</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;e;</span><span
-class="cmtt-10">&eacute;</span><span
-class="cmtt-10">,E;</span><span
-class="cmtt-10">É</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;f,F</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;g,G</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;h,H</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;i;</span><span
-class="cmtt-10">í</span><span
-class="cmtt-10">,I;</span><span
-class="cmtt-10">Í</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;j,J</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;l;</span><span
-class="cmtt-10">&#322;,L;</span><span
-class="cmtt-10">&#321;</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;m,M</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;n,N</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;o;</span><span
-class="cmtt-10">ö</span><span
-class="cmtt-10">;&oslash;,O;</span><span
-class="cmtt-10">Ö</span><span
-class="cmtt-10">;Ø</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;p,P</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;q,Q</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;r,R</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;s;</span><span
-class="cmtt-10">&#347;</span><span
-class="cmtt-10">,S;</span><span
-class="cmtt-10">&#346;</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;t,T</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;u;</span><span
-class="cmtt-10">ú</span><span
-class="cmtt-10">,U;</span><span
-class="cmtt-10">Ú</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;v,V</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;w,W</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;x,X</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;y,Y</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;z;</span><span
-class="cmtt-10">&#380;</span><span
-class="cmtt-10">,Z;</span><span
-class="cmtt-10">&#379;</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmsy-10">}</span>
-<br /><span
-class="cmtt-10">]</span>
-</div>
-</div> Remember that if you are using <span
-class="cmss-10">inputenc</span><a
- id="dx1-78012"></a> then extended characters, such as &eacute; or &oslash;,
-are active and will expand when written to the <span
-class="cmtt-10">.aux </span>file. So with PDFLaTeX&#x00A0;the
-above would have to be changed to protect against expansion. Some of the
-options, including <span
-class="cmtt-10">sort-rule</span>, allow Unicode characters to be indicated in the
-format <span
-class="cmtt-10">\u</span>&#x27E8;<span
-class="cmti-10">hex</span>&#x27E9; (or <span
-class="cmtt-10">\u</span>&#x00A0;&#x27E8;<span
-class="cmti-10">hex</span>&#x27E9;) <span
-class="cmbx-10">in the </span><span
-class="cmtt-10">.aux </span><span
-class="cmbx-10">file</span>. <a
- id="dx1-78013"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> will recognise this as the
-character given by the hexadecimal value &#x27E8;<span
-class="cmti-10">hex</span>&#x27E9;. The <span
-class="cmtt-10">\u </span>also needs protection from
-expansion, so with a non-Unicode aware engine, the character &aelig;&#x00A0;needs to be
-written as <span
-class="cmtt-10">\string\uE6 </span>and so on. This is quite cumbersome, but you can
-use the shortcut <span
-class="cmtt-10">\glshex</span><a
- id="dx1-78014"></a> <span
-class="cmtt-10">E6 </span>instead, so the above needs to be written as:
-<div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\GlsXtrLoadResources[</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;src=terms,</span><span
-class="cmtt-10">&#x00A0;%</span><span
-class="cmtt-10">&#x00A0;entries</span><span
-class="cmtt-10">&#x00A0;in</span><span
-class="cmtt-10">&#x00A0;terms.bib</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;sort=custom,</span><span
-class="cmtt-10">&#x00A0;%</span><span
-class="cmtt-10">&#x00A0;custom</span><span
-class="cmtt-10">&#x00A0;sort</span><span
-class="cmtt-10">&#x00A0;rule</span>
-
-
-
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;sort-rule=</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">%</span><span
-class="cmtt-10">&#x00A0;required</span><span
-class="cmtt-10">&#x00A0;with</span><span
-class="cmtt-10">&#x00A0;sort=custom</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;\glshex</span><span
-class="cmtt-10">&#x00A0;E6;\glshex</span><span
-class="cmtt-10">&#x00A0;C6</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;a;\glshex</span><span
-class="cmtt-10">&#x00A0;E1;\glshex</span><span
-class="cmtt-10">&#x00A0;E5,\glshex</span><span
-class="cmtt-10">&#x00A0;E4,A;\glshex</span><span
-class="cmtt-10">&#x00A0;C1;\glshex</span><span
-class="cmtt-10">&#x00A0;C5;\glshex</span><span
-class="cmtt-10">&#x00A0;C4</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;b,B</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;c;\glshex</span><span
-class="cmtt-10">&#x00A0;0107,C;\glshex</span><span
-class="cmtt-10">&#x00A0;0106</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;d,D</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;e;\glshex</span><span
-class="cmtt-10">&#x00A0;E9,E;\glshex</span><span
-class="cmtt-10">&#x00A0;C9</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;f,F</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;g,G</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;h,H</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;i;\glshex</span><span
-class="cmtt-10">&#x00A0;ED,I;\glshex</span><span
-class="cmtt-10">&#x00A0;CD</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;j,J</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;l;\glshex</span><span
-class="cmtt-10">&#x00A0;0142,L;\glshex</span><span
-class="cmtt-10">&#x00A0;0141</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;m,M</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;n,N</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;o;\glshex</span><span
-class="cmtt-10">&#x00A0;F6;\glshex</span><span
-class="cmtt-10">&#x00A0;F8,O;\glshex</span><span
-class="cmtt-10">&#x00A0;D6;\glshex</span><span
-class="cmtt-10">&#x00A0;D8</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;p,P</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;q,Q</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;r,R</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;s;\glshex</span><span
-class="cmtt-10">&#x00A0;013F,S;\glshex</span><span
-class="cmtt-10">&#x00A0;015A</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;t,T</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;u;\glshex</span><span
-class="cmtt-10">&#x00A0;FA,U;\glshex</span><span
-class="cmtt-10">&#x00A0;DA</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;v,V</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;w,W</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;x,X</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;y,Y</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;&#x003C;</span><span
-class="cmtt-10">&#x00A0;z;\glshex</span><span
-class="cmtt-10">&#x00A0;017C,Z;\glshex</span><span
-class="cmtt-10">&#x00A0;017B</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmsy-10">}</span><span
-class="cmtt-10">]</span>
-</div>
-</div>
-<!--l. 11783--><p class="noindent" >
-</p>
-<!--l. 11783--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">10.3 </span> <a
- id="sec:bib2glssty"></a>The glossaries-extra-bib2gls package</h3>
-<!--l. 11786--><p class="noindent" >The package option <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=only</span><a
- id="dx1-79001"></a> (or simply <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><a
- id="dx1-79002"></a>) automatically loads the
-supplementary package <span
-class="cmss-10">glossaries-extra-bib2gls</span><a
- id="dx1-79003"></a>, which provides some commands that
-are specific to <a
- id="dx1-79004"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a>. The package isn&#8217;t loaded by <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=hybrid</span><a
- id="dx1-79005"></a> as that option is
-intended for sorting with <a
- id="dx1-79006"></a><a
-href="#glo:makeindex"><span
-class="cmtt-10">makeindex</span></a> or <a
- id="dx1-79007"></a><a
-href="#glo:xindy"><span
-class="cmtt-10">xindy</span></a> and it is expected that the sorting will
-be switched off (with the resource option <span
-class="cmtt-10">sort=none</span>).
-</p><!--l. 11795--><p class="indent" > If <span
-class="cmss-10">glossaries-extra-bib2gls</span><a
- id="dx1-79008"></a> is loaded via the <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><a
- id="dx1-79009"></a> package option then the check for
-associated language resource files (see <a
-href="#sec:lang"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">15</span> </a><a
-href="#sec:lang">Multi-Lingual Support<!--tex4ht:ref: sec:lang --></a>)
-will also search for the existence of <span
-class="cmtt-10">glossariesxtr-</span>&#x27E8;<span
-class="cmti-10">script</span>&#x27E9;<span
-class="cmtt-10">.ldf </span>for each
-document dialect (where &#x27E8;<span
-class="cmti-10">script</span>&#x27E9; is the four letter script identifier, such as
-<span
-class="cmtt-10">Latn</span>).
-</p><!--l. 11803--><p class="indent" > This package provides some shortcut commands that use <span
-class="cmtt-10">\printunsrtglossary</span><a
- id="dx1-79010"></a> if the
-relevant package option has defined the associated glossary: <span
-class="cmtt-10">\printunsrtabbreviations</span><a
- id="dx1-79011"></a>,
-<span
-class="cmtt-10">\printunsrtacronyms</span><a
- id="dx1-79012"></a>, <span
-class="cmtt-10">\printunsrtsymbols</span><a
- id="dx1-79013"></a>, <span
-class="cmtt-10">\printunsrtnumbers</span><a
- id="dx1-79014"></a> and
-<span
-class="cmtt-10">\printunsrtindex</span><a
- id="dx1-79015"></a>.
-</p><!--l. 11809--><p class="indent" > The <a
-href="#styopt.savenumberlist"><span
-class="cmss-10">savenumberlist</span></a><a
- id="dx1-79016"></a> package option doesn&#8217;t have any effect with <a
- id="dx1-79017"></a><span
-class="cmtt-10">bib2gls</span>.
-The location lists are saved by default, so <span
-class="cmss-10">glossaries-extra-bib2gls</span><a
- id="dx1-79018"></a> patches
-<span
-class="cmtt-10">\glsentrynumberlist</span><a
- id="dx1-79019"></a> and <span
-class="cmtt-10">\glsdisplaynumberlist</span><a
- id="dx1-79020"></a> to work with the <span
-class="cmss-10">location</span><a
- id="dx1-79021"></a>
-field
-</p><!--l. 11814--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-79022"></a> <span
-class="cmtt-10">\glsxtrprovidecommand{</span>&#x27E8;<span
-class="cmitt-10">cs</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">n</span>&#x27E9;<span
-class="cmtt-10">][</span>&#x27E8;<span
-class="cmitt-10">default</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">definition</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11816--><p class="noindent" >
-This command is intended for use in <span
-class="cmtt-10">@preamble</span>. It&#8217;s simply defined to
-<span
-class="cmtt-10">\providecommand </span>in <span
-class="cmss-10">glossaries-extra-bib2gls</span><a
- id="dx1-79023"></a> but <a
- id="dx1-79024"></a><span
-class="cmtt-10">bib2gls</span>&#8217;s interpreter treats it as
-<span
-class="cmtt-10">\renewcommand</span>. This means that you can override <a
- id="dx1-79025"></a><span
-class="cmtt-10">bib2gls</span>&#8217;s internal definition of a
-command without overriding the command definition in the document (if it&#8217;s already
-defined before the resource file is input). For example
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-271">
-@preamble{"\glsxtrprovidecommand{\int}{integral}"}
-</pre>
-<!--l. 11827--><p class="nopar" > This will force <a
- id="dx1-79026"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> to treat <span
-class="cmtt-10">\int </span>as the word &#8220;integral&#8221; to assist sorting but if
-this preamble code is written to the <span
-class="cmtt-10">.glstex </span>file (as it is by default) then it won&#8217;t
-override the current definition (provided by the kernel or redefined by a
-package).
-</p><!--l. 11834--><p class="indent" > The helper commands in the resource files are defined using <span
-class="cmtt-10">\providecommand</span>.
-For many of them, if you want to provide an alternative definition then you need to
-define the command before the resource file is loaded. There are a few that may be
-redefined afterwards but if you use <span
-class="cmtt-10">\renewcommand </span>then you will get an error on the
-first LaTeX&#x00A0;run when the <span
-class="cmtt-10">.glstex </span>file doesn&#8217;t exist. In this case, you may prefer to
-use:
-</p><!--l. 11841--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-79027"></a> <span
-class="cmtt-10">\glsrenewcommand{</span>&#x27E8;<span
-class="cmitt-10">cs</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">n</span>&#x27E9;<span
-class="cmtt-10">][</span>&#x27E8;<span
-class="cmitt-10">default</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">definition</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11843--><p class="noindent" >
-This behaves like <span
-class="cmtt-10">\renewcommand </span>but only generates a warning rather than an error
-if the command isn&#8217;t already defined so it won&#8217;t interrupt the document
-build.
-</p><!--l. 11848--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-79028"></a> <span
-class="cmtt-10">\GlsXtrIndexCounterLink{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11850--><p class="noindent" >
-If the <span
-class="cmtt-10">\hyperref</span><a
- id="dx1-79029"></a> command has been defined (that is, <span
-class="cmss-10">hyperref</span><a
- id="dx1-79030"></a> has been
-loaded before <span
-class="cmss-10">glossaries-extra</span>) then this command checks for the existence of
-the <span
-class="cmtt-10">indexcounter </span>field. If this field is set for the entry given by &#x27E8;<span
-class="cmti-10">label</span>&#x27E9;, this
-command does <span
-class="cmtt-10">\hyperref[wrglossary.</span>&#x27E8;<span
-class="cmitt-10">value</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">}</span>, where &#x27E8;<span
-class="cmti-10">value</span>&#x27E9; is the
-value of the <span
-class="cmtt-10">indexcounter </span>field. If the field isn&#8217;t set or if <span
-class="cmtt-10">\hyperref </span>hasn&#8217;t
-been defined, this just does &#x27E8;<span
-class="cmti-10">text</span>&#x27E9;. This command is provided for use with the
-<a
-href="#styopt.indexcounter"><span
-class="cmss-10">indexcounter</span></a><a
- id="dx1-79031"></a> package option combined with <a
- id="dx1-79032"></a><span
-class="cmtt-10">bib2gls</span>&#8217;s <span
-class="cmtt-10">save-index-counter</span>
-resource option. See the <a
- id="dx1-79033"></a><span
-class="cmtt-10">bib2gls </span>manual for further details (at least version
-1.4).
-</p><!--l. 11864--><p class="indent" > If you use the <span
-class="cmtt-10">set-widest </span>resource option, <a
- id="dx1-79034"></a><span
-class="cmtt-10">bib2gls </span>v1.8+ will now
-use:
-</p><!--l. 11866--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-79035"></a> <span
-class="cmtt-10">\glsxtrSetWidest{</span>&#x27E8;<span
-class="cmitt-10">type</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">level</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11868--><p class="noindent" >
-(if it has been defined) to set the widest name for the given glossary type and level.
-This allows for both the <span
-class="cmss-10">alttree</span><a
- id="dx1-79036"></a> style and the styles provided by <span
-class="cmss-10">glossary-longextra</span><a
- id="dx1-79037"></a>,
-which need to know the widest name.
-</p><!--l. 11874--><p class="indent" > If <a
- id="dx1-79038"></a><span
-class="cmtt-10">bib2gls </span>can&#8217;t determine the widest name (typically because the name field
-consists of commands that aren&#8217;t recognised by the interpreter) then <a
- id="dx1-79039"></a><span
-class="cmtt-10">bib2gls </span>v1.8+
-will now use:
-</p><!--l. 11877--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-79040"></a> <span
-class="cmtt-10">\glsxtrSetWidestFallback{</span>&#x27E8;<span
-class="cmitt-10">max depth</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">list</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11879--><p class="noindent" >
-(if defined). Currently the maximum hierarchical depth &#x27E8;<span
-class="cmti-10">max depth</span>&#x27E9; may only be 0 or
-2. This command requires commands provided by the <span
-class="cmss-10">glossaries-extra-stylemods</span><a
- id="dx1-79041"></a>
-
-
-
-package with the <span
-class="cmss-10">alttree</span><a
- id="dx1-79042"></a> style enabled. In this case, it may be simpler to just use
-<span
-class="cmtt-10">\glssetwidest</span><a
- id="dx1-79043"></a>.
-</p><!--l. 11886--><p class="noindent" >
-</p>
-<!--l. 11886--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">10.3.1 </span> <a
- id="sec:supplocations"></a>Supplemental Locations</h4>
-<!--l. 11889--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-80001"></a> <span
-class="cmtt-10">\glsxtrdisplaysupploc{</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">counter</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">format</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">src</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 11891--><p class="noindent" >
-This is used by <a
- id="dx1-80002"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> version 1.7+ for supplemental locations, instead of using
-<span
-class="cmtt-10">\glsxtrsupphypernumber </span>with the <a
-href="#catattr.externallocation"><span
-class="cmss-10">externallocation</span></a><a
- id="dx1-80003"></a> attribute. This command sets up
-the location counter and prefix (used in the formation of hyperlinks) and then
-uses
-</p><!--l. 11897--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-80004"></a> <span
-class="cmtt-10">\glsxtrmultisupplocation{</span>&#x27E8;<span
-class="cmitt-10">location</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">src</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">format</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11899--><p class="noindent" >
-to format the actual location (with an external hyperlink, if supported).
-</p><!--l. 11903--><p class="noindent" >
-</p>
-<!--l. 11903--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">10.3.2 </span> <a
- id="sec:recordnameref"></a>Nameref Record</h4>
-<!--l. 11906--><p class="noindent" >Normally locations are recorded in the <span
-class="cmtt-10">.aux </span>file in the form:
-</p><!--l. 11909--><p class="indent" > <hr><div title="Definition"><span
-class="cmtt-10">\glsxtr@record{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">counter</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">format</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 11910--><p class="noindent" >
-The <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=nameref</span><a
- id="dx1-81001"></a> option, which requires at least <a
- id="dx1-81002"></a><span
-class="cmtt-10">bib2gls </span>v1.8, instead
-uses:
-</p><!--l. 11914--><p class="indent" > <hr><div title="Definition"><span
-class="cmtt-10">\glsxtr@record@nameref{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">counter</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">format</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location</span>&#x27E9;<span
-class="cmtt-10">}</span>
-<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">title</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">href</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">hcounter</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11915--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">title</span>&#x27E9; is obtained from <span
-class="cmtt-10">\@currentlabelname </span>and &#x27E8;<span
-class="cmti-10">href </span>&#x27E9; is obtained from
-<span
-class="cmtt-10">\@currentHref</span>. These commands require <span
-class="cmss-10">hyperref</span><a
- id="dx1-81003"></a>. If they are undefined, &#x27E8;<span
-class="cmti-10">title</span>&#x27E9; and
-&#x27E8;<span
-class="cmti-10">href </span>&#x27E9; will be left empty and <a
- id="dx1-81004"></a><span
-class="cmtt-10">bib2gls </span>will treat it as a regular record.
-</p><!--l. 11922--><p class="indent" > <div class="important" title="Important Note"> Be careful with this option as &#x27E8;<span
-class="cmti-10">href </span>&#x27E9; will globally change on every instance of
-<span
-class="cmtt-10">\refstepcounter </span>but &#x27E8;<span
-class="cmti-10">title</span>&#x27E9; won&#8217;t necessarily change. It can therefore cause
-unexpected behaviour. </div>
-</p><!--l. 11926--><p class="noindent" >
-</p><!--l. 11928--><p class="indent" > The final argument &#x27E8;<span
-class="cmti-10">hcounter</span>&#x27E9; is obtained from <span
-class="cmtt-10">\theH</span>&#x27E8;<span
-class="cmti-10">counter</span>&#x27E9; which provides the
-partial target name associated with the indexing counter. With the original
-<a
- id="dx1-81005"></a><a
-href="#glo:makeindex"><span
-class="cmtt-10">makeindex</span></a>/<a
- id="dx1-81006"></a><a
-href="#glo:xindy"><span
-class="cmtt-10">xindy</span></a> approach, it&#8217;s not possible to include this information in the
-location, so the base <span
-class="cmss-10">glossaries</span><a
- id="dx1-81007"></a> package attempts to derive a prefix from which the
-&#x27E8;<span
-class="cmti-10">hcounter</span>&#x27E9; value can be reconstituted by appending the prefix. Unfortunately, not all
-definitions of <span
-class="cmtt-10">\theH</span>&#x27E8;<span
-class="cmti-10">counter</span>&#x27E9; are in the form &#x27E8;<span
-class="cmti-10">prefix</span>&#x27E9;<span
-class="cmtt-10">\the</span>&#x27E8;<span
-class="cmti-10">counter</span>&#x27E9; (most notably the
-
-
-
-<span
-class="cmss-10">equation</span><a
- id="dx1-81008"></a> counter with chapters) so this can fail.
-</p><!--l. 11939--><p class="indent" > Since <a
- id="dx1-81009"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> is customized specifically for use with <span
-class="cmss-10">glossaries-extra</span>, it&#8217;s now
-possible to save &#x27E8;<span
-class="cmti-10">hcounter</span>&#x27E9;, so the <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=nameref</span><a
- id="dx1-81010"></a> option does this. By providing both
-&#x27E8;<span
-class="cmti-10">href </span>&#x27E9; and &#x27E8;<span
-class="cmti-10">hcounter</span>&#x27E9;, you can determine which target you would rather use. The default
-is to use &#x27E8;<span
-class="cmti-10">hcounter</span>&#x27E9;, which will take you to the place where the corresponding counter
-was incremented with <span
-class="cmtt-10">\refstepcounter</span>. However, you may choose to switch to
-using the &#x27E8;<span
-class="cmti-10">href </span>&#x27E9; target, which will take you to the nearest target before the indexing
-took place.
-</p><!--l. 11950--><p class="indent" > With <a
- id="dx1-81011"></a><span
-class="cmtt-10">bib2gls </span>v1.8+, normal locations are displayed using:
-</p><!--l. 11952--><p class="indent" > <hr><div title="Definition"><span
-class="cmtt-10">\glsnoidxdisplayloc{</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">counter</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">format</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11953--><p class="noindent" >
-This is provided by the base <span
-class="cmss-10">glossaries</span><a
- id="dx1-81012"></a> package and is simply defined to do:
-</p><!--l. 11957--><p class="indent" > <hr><div title="Definition"><span
-class="cmtt-10">\setentrycounter[</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">counter</span>&#x27E9;<span
-class="cmtt-10">}\csuse{</span>&#x27E8;<span
-class="cmitt-10">format</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 11958--><p class="noindent" >
-Earlier versions of <a
- id="dx1-81013"></a><span
-class="cmtt-10">bib2gls </span>only used this in the <span
-class="cmss-10">loclist</span><a
- id="dx1-81014"></a> field and explicitly used
-<span
-class="cmtt-10">\setentrycounter </span>in the <span
-class="cmss-10">location</span><a
- id="dx1-81015"></a> field followed by <span
-class="cmtt-10">\</span>&#x27E8;<span
-class="cmti-10">format</span>&#x27E9;<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmti-10">location</span>&#x27E9;<span
-class="cmtt-10">}</span>, which follows
-the code that&#8217;s created with the default <a
-href="#styopt.makeindex"><span
-class="cmss-10">makeindex</span></a><a
- id="dx1-81016"></a> setting. The <span
-class="cmtt-10">\setentrycounter</span>
-command sets up the prefix needed for <span
-class="cmtt-10">\glshypernumber </span>to reform the target name
-from the given location.
-</p><!--l. 11968--><p class="indent" > The locations identified by <span
-class="cmtt-10">\glsxtr@record@nameref </span>are written by <a
- id="dx1-81017"></a><span
-class="cmtt-10">bib2gls </span>to
-the location list using:
-</p><!--l. 11970--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-81018"></a> <span
-class="cmtt-10">\glsxtrdisplaylocnameref{</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">counter</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">format</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location</span>&#x27E9;<span
-class="cmtt-10">}</span>
-<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">title</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">href</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">hcounter</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">file</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11972--><p class="noindent" >
-With normal internal locations, &#x27E8;<span
-class="cmti-10">file</span>&#x27E9; will always be empty. With supplemental
-locations, &#x27E8;<span
-class="cmti-10">file</span>&#x27E9; will be the external file reference.
-</p><!--l. 11977--><p class="indent" > The default definition is:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-272">
-\newcommand*{\glsxtrdisplaylocnameref}[8]{%
-&#x00A0;&#x00A0;\ifstrequal{#2}{equation}%
-&#x00A0;&#x00A0;{\glsxtrnamereflink{#3}{(#4)}{#2.#7}{#8}}%
-&#x00A0;&#x00A0;{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;\ifstrempty{#5}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glsxtrnamereflink{#3}{#4}{#2.#7}{#8}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;\ifstrequal{#2}{page}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;{\glsxtrnamereflink{#3}{#4}{#2.#7}{#8}}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;{\glsxtrnamereflink{#3}{#5}{#2.#7}{#8}}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;}%
-&#x00A0;&#x00A0;}%
+</pre> <p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+The punctuation that is automatically inserted with <a id="wrglossary.10722"></a><a href="#glo:opt.postdot"><span class="styoptfmt">postdot</span></a> or <a id="wrglossary.10723"></a><a href="#glo:opt.postpunc"><span class="styoptfmt">postpunc</span></a> is placed after <a id="wrglossary.10724"></a><a href="#glo:glsxtrpostdescription"><code class="csfmt">\glsxtrpostdescription</code></a>, not before. </div><!-- end of information -->
+<p>
+If you want to modify the hook for all entries (without affecting the <a id="wrglossary.10725"></a><a href="#glo:opt.postpunc"><span class="styoptfmt">postpunc</span></a> or <a id="wrglossary.10726"></a><a href="#glo:opt.postdot"><span class="styoptfmt">postdot</span></a> options), then redefine <a id="wrglossary.10727"></a><a href="#glo:glsxtrpostdescription"><code class="csfmt">\glsxtrpostdescription</code></a>. If you want to adjust this hook according to the entry’s category, then you can simply redefine the <a id="wrglossary.10728"></a><a href="#glo:dual.catpostdeschook">category post-description hook</a>. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10729"></a><code class="code"><dfn id="glo:glsxtrpostdesccategory"><code class="csfmt">\glsxtrpostdesc<span class="meta">〈<em class="metainner">category</em>〉</span></code></dfn></code></div><!-- end of pinnedbox -->
+ Some common <a id="wrglossary.10730"></a><a href="#glo:dual.catpostdeschook">category post-description hooks</a> are provided: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10731"></a><code class="code"><dfn id="glo:glsxtrpostdescgeneral"><code class="csfmt">\glsxtrpostdescgeneral</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">empty</em></span></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ The <a id="wrglossary.10732"></a><a href="#glo:dual.postdeschook">post-description hook</a> for the <a id="wrglossary.10733"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a> category.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10734"></a><code class="code"><dfn id="glo:glsxtrpostdescterm"><code class="csfmt">\glsxtrpostdescterm</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">empty</em></span></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ The <a id="wrglossary.10735"></a><a href="#glo:dual.postdeschook">post-description hook</a> for the <a id="wrglossary.10736"></a><a href="#glo:opt.cat.term"><span class="csoptfmt">term</span></a> category.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10737"></a><code class="code"><dfn id="glo:glsxtrpostdescacronym"><code class="csfmt">\glsxtrpostdescacronym</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">empty</em></span></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ The <a id="wrglossary.10738"></a><a href="#glo:dual.postdeschook">post-description hook</a> for the <a id="wrglossary.10739"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a> category.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10740"></a><code class="code"><dfn id="glo:glsxtrpostdescabbreviation"><code class="csfmt">\glsxtrpostdescabbreviation</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">empty</em></span></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ The <a id="wrglossary.10741"></a><a href="#glo:dual.postdeschook">post-description hook</a> for the <a id="wrglossary.10742"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a> category.<p>
+The above all do nothing by default. You can redefine them with <a id="wrglossary.10743"></a><a href="#glo:renewcommand"><code class="csfmt">\renewcommand</code></a> or use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10744"></a><code class="code"><dfn id="glo:glsdefpostdesc"><code class="csfmt">\glsdefpostdesc</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">definition</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This will define (or redefine) <a id="wrglossary.10745"></a><a href="#glo:glsxtrpostdesccategory"><code class="csfmt">\glsxtrpostdesc<span class="meta">〈<em class="metainner">category</em>〉</span></code></a>. The package options <a id="wrglossary.10746"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a>, <a id="wrglossary.10747"></a><a href="#glo:opt.numbers"><span class="styoptfmt">numbers</span></a> and <a id="wrglossary.10748"></a><a href="#glo:opt.index"><span class="styoptfmt">index</span></a> provide corresponding <a id="wrglossary.10749"></a><a href="#glo:dual.catpostdeschook">category post-description hooks</a>.<p>
+You can reference the current entry within these hooks using <a id="wrglossary.10750"></a><a href="#glo:glscurrententrylabel"><code class="csfmt">\glscurrententrylabel</code></a>, which is defined within the <a id="wrglossary.10751"></a><a href="#glo:dual.glossary">glossary</a> (any of the <code class="csfmt">\print…glossary</code> commands) and also within the standalone commands, such as <a id="wrglossary.10752"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10753"></a><code class="code"><dfn id="glo:glsxtrnopostpunc"><code class="csfmt">\glsxtrnopostpunc</code></dfn></code></div><!-- end of pinnedbox -->
+ Suppresses the post-description punctuation that is automatically inserted by package options <a id="wrglossary.10754"></a><a href="#glo:opt.postdot"><span class="styoptfmt">postdot</span></a> or <a id="wrglossary.10755"></a><a href="#glo:opt.postpunc"><span class="styoptfmt">postpunc</span></a>.<p>
+The <a id="wrglossary.10756"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package provides <a id="wrglossary.10757"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>, which may be used in the <a id="wrglossary.10758"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> to suppress the <a id="wrglossary.10759"></a><a href="#glo:dual.postdeschook">post-description hook</a> for that entry. This suppresses both the post-description punctuation and the additional <a id="wrglossary.10760"></a><a href="#glo:glsxtrpostdescription"><code class="csfmt">\glsxtrpostdescription</code></a> hook. If you only want to suppress to punctuation, then use <a id="wrglossary.10761"></a><a href="#glo:glsxtrnopostpunc"><code class="csfmt">\glsxtrnopostpunc</code></a> instead.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+The <a id="wrglossary.10762"></a><a href="#glo:dual.postdeschook">post-description hooks</a> are implemented by <a id="wrglossary.10763"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a> within the glossary style. If this command isn’t used in the style, then the additional hooks won’t be available. </div><!-- end of information -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10764"></a><code class="code"><dfn id="glo:glsxtrrestorepostpunc"><code class="csfmt">\glsxtrrestorepostpunc</code></dfn></code></div><!-- end of pinnedbox -->
+ If this command is placed in the definition of <a id="wrglossary.10765"></a><a href="#glo:glsxtrpostdescription"><code class="csfmt">\glsxtrpostdescription</code></a> or added to the <a id="wrglossary.10766"></a><a href="#glo:dual.catpostlinkhook">category post-link hook</a>, then it will counter-act any use of <a id="wrglossary.10767"></a><a href="#glo:glsxtrnopostpunc"><code class="csfmt">\glsxtrnopostpunc</code></a> to restore the post-description punctuation.<p>
+These commands have no effect outside of the glossary (except with standalone entries that use <a id="wrglossary.10768"></a><a href="#glo:glsxtractivatenopost"><code class="csfmt">\glsxtractivatenopost</code></a> and <a id="wrglossary.10769"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a>, see §<a href="#sec:glossentry">8.5</a>).<p>
+
+</section><!-- end of section sec:postdeschooks -->
+
+<section id="sec:glosstylenumlist"><!-- start of section sec:glosstylenumlist --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->8.6.3. Number (Location) List<div class="labellink"><a href="#sec:glosstylenumlist">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+The <a id="wrglossary.10770"></a><a href="#glo:dual.locationlist">location list</a> is now placed inside the argument of: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10771"></a><code class="code"><dfn id="glo:GlsXtrFormatLocationList"><code class="csfmt">\GlsXtrFormatLocationList</code></dfn>{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is internally used by <a id="wrglossary.10772"></a><a href="#glo:glossaryentrynumbers"><code class="csfmt">\glossaryentrynumbers</code></a>. The <a id="wrglossary.10773"></a><a href="#glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></a> option redefines <a id="wrglossary.10774"></a><a href="#glo:glossaryentrynumbers"><code class="csfmt">\glossaryentrynumbers</code></a> so that it doesn’t display the <a id="wrglossary.10775"></a><a href="#glo:locationlist">number list</a>, but it still saves the <a id="wrglossary.10776"></a><a href="#glo:locationlist">number list</a> in case it’s required. The desired font formatting for the <a id="wrglossary.10777"></a><a href="#glo:dual.locationlist">location list</a> can now more easily be set by redefining <a id="wrglossary.10778"></a><a href="#glo:GlsXtrFormatLocationList"><code class="csfmt">\GlsXtrFormatLocationList</code></a>, without interfering with <a id="wrglossary.10779"></a><a href="#glo:glossaryentrynumbers"><code class="csfmt">\glossaryentrynumbers</code></a>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+If you want to suppress the <a id="wrglossary.10780"></a><a href="#glo:locationlist">number list</a> always use the <a id="wrglossary.10781"></a><a href="#glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></a> option instead of redefining <a id="wrglossary.10782"></a><a href="#glo:glossaryentrynumbers"><code class="csfmt">\glossaryentrynumbers</code></a> to do nothing. </div><!-- end of important -->
+<p>
+Note that if you are using the <a id="wrglossary.10783"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> the <a id="wrglossary.10784"></a><a href="#glo:dual.locationlist">location list</a> will only be present if the appropriate field has been set (see §<a href="#sec:printunsrtlocations">8.4.2</a>). There’s no need to save locations with <a id="wrglossary.10785"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> or with <a id="wrglossary.10786"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a> because this is performed automatically (unlike <a id="wrglossary.10787"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> where the trick with <a id="wrglossary.10788"></a><a href="#glo:glossaryentrynumbers"><code class="csfmt">\glossaryentrynumbers</code></a> is required to capture the <a id="wrglossary.10789"></a><a href="#glo:dual.locationlist">location list</a>).<p>
+Sometimes users like to insert <span class="qt">“page”</span> or <span class="qt">“pages”</span> in front of the <a id="wrglossary.10790"></a><a href="#glo:dual.locationlist">location list</a>. This is quite fiddly to do with the base <a id="wrglossary.10791"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, but <a id="wrglossary.10792"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> provides a way of doing this. First you need to enable this option and specify the text to display using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10793"></a><code class="code"><dfn id="glo:GlsXtrEnablePreLocationTag"><code class="csfmt">\GlsXtrEnablePreLocationTag</code></dfn>{<span class="meta">〈<em class="metainner">page tag</em>〉</span>}{<span class="meta">〈<em class="metainner">pages tag</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">page tag</em>〉</span> is the text to display if the <a id="wrglossary.10794"></a><a href="#glo:dual.locationlist">location list</a> only contains a single location and <span class="meta">〈<em class="metainner">pages tag</em>〉</span> is the text to display otherwise. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.10795"></a><a href="#glo:GlsXtrEnablePreLocationTag"><code class="csfmt">\GlsXtrEnablePreLocationTag</code></a>{Page: }{Pages: }
+</pre> An extra run is required when using this command.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Use <a id="wrglossary.10796"></a><a href="#glo:glsignore"><span class="csfmtcolourfont">glsignore</span></a> not <a id="wrglossary.10797"></a><a href="#glo:@gobble"><span class="csfmtcolourfont">@gobble</span></a> as the format if you want to suppress the page number (and only index the entry once). </div><!-- end of important -->
+<p>
+See the accompanying sample file <a id="wrglossary.10798"></a><a href="#glo:file.sample-pages.tex"><span class="filefmt">sample-pages.tex</span></a> for an example.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+Note that <a id="wrglossary.10799"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> the <a id="wrglossary.10800"></a><a href="#glo:opt.resource.loc-prefix"><span class="csoptfmt">loc-prefix</span></a> resource option inserts a prefix at the start of non-empty location lists, which can be used as an alternative to <a id="wrglossary.10801"></a><a href="#glo:GlsXtrEnablePreLocationTag"><code class="csfmt">\GlsXtrEnablePreLocationTag</code></a>. There is also a corresponding <a id="wrglossary.10802"></a><a href="#glo:opt.resource.loc-suffix"><span class="csoptfmt">loc-suffix</span></a> option to provide a suffix. </div><!-- end of information -->
+<p>
+<a id="wrglossary.10803"></a><a href="#glo:dual.locationlist">Location lists</a> displayed with <a id="wrglossary.10804"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a> internally use: <a id="wrglossary.10805"></a><a href="#glo:glsnoidxdisplayloc"><code class="csfmt">\glsnoidxdisplayloc</code></a> This command is provided by <a id="wrglossary.10806"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>, but is modified by <a id="wrglossary.10807"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> to check for the start and end range formation identifiers ( and ) which are discarded to obtain the actual control sequence name that forms the location formatting command.<p>
+If the range identifiers aren’t present, this just uses <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10808"></a><code class="code"><dfn id="glo:glsxtrdisplaysingleloc"><code class="csfmt">\glsxtrdisplaysingleloc</code></dfn>{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ otherwise it uses <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10809"></a><code class="code"><dfn id="glo:glsxtrdisplaystartloc"><code class="csfmt">\glsxtrdisplaystartloc</code></dfn>{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ for the start of a range (where the identifier has been stripped from <span class="meta">〈<em class="metainner">format</em>〉</span>) or <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10810"></a><code class="code"><dfn id="glo:glsxtrdisplayendloc"><code class="csfmt">\glsxtrdisplayendloc</code></dfn>{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ for the end of a range (where the identifier has been stripped from <span class="meta">〈<em class="metainner">format</em>〉</span>).<p>
+By default the start range command saves the format in: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10811"></a><code class="code"><dfn id="glo:glsxtrlocrangefmt"><code class="csfmt">\glsxtrlocrangefmt</code></dfn></code></div><!-- end of pinnedbox -->
+ and does: <pre class="compactcodebox"><a id="wrglossary.10812"></a><a href="#glo:glsxtrdisplaysingleloc"><code class="csfmt">\glsxtrdisplaysingleloc</code></a>{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}
+</pre> (If the format is empty, it will be replaced with <code class="code">glsnumberformat</code>.)<p>
+The end command checks that the format matches the start of the range, does: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10813"></a><code class="code"><dfn id="glo:glsxtrdisplayendlochook"><code class="csfmt">\glsxtrdisplayendlochook</code></dfn></code></div><!-- end of pinnedbox -->
+ (which does nothing by default), followed by: <pre class="compactcodebox"><a id="wrglossary.10814"></a><a href="#glo:glsxtrdisplaysingleloc"><code class="csfmt">\glsxtrdisplaysingleloc</code></a>{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}
+</pre> and then sets <a id="wrglossary.10815"></a><a href="#glo:glsxtrlocrangefmt"><code class="csfmt">\glsxtrlocrangefmt</code></a> to empty.<p>
+This means that the list <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.10816"></a><a href="#glo:glsnoidxdisplayloc"><code class="csfmt">\glsnoidxdisplayloc</code></a>{}{page}{(textbf}{1},
+<a id="wrglossary.10817"></a><a href="#glo:glsnoidxdisplayloc"><code class="csfmt">\glsnoidxdisplayloc</code></a>{}{page}{textbf}{1},
+<a id="wrglossary.10818"></a><a href="#glo:glsnoidxdisplayloc"><code class="csfmt">\glsnoidxdisplayloc</code></a>{}{page}{)textbf}{1}.
+</pre> doesn’t display any differently from <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.10819"></a><a href="#glo:glsnoidxdisplayloc"><code class="csfmt">\glsnoidxdisplayloc</code></a>{}{page}{textbf}{1},
+<a id="wrglossary.10820"></a><a href="#glo:glsnoidxdisplayloc"><code class="csfmt">\glsnoidxdisplayloc</code></a>{}{page}{textbf}{1},
+<a id="wrglossary.10821"></a><a href="#glo:glsnoidxdisplayloc"><code class="csfmt">\glsnoidxdisplayloc</code></a>{}{page}{textbf}{1}.
+</pre> but it does make it easier to define your own custom list handler that can accommodate the ranges.<p>
+
+</section><!-- end of section sec:glosstylenumlist -->
+
+<section id="sec:glosgroups"><!-- start of section sec:glosgroups --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->8.6.4. Indexing Groups<div class="labellink"><a href="#sec:glosgroups">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+The letter or symbol or number <a id="wrglossary.10822"></a><a href="#glo:idx.group">groups</a> are a by-product of the <a id="wrglossary.10823"></a><a href="#glo:dual.indexingapp">indexing application</a>. These are usually determined during the sorting according to the first (significant) character of the sort value. If the first character is an alphabetical character, the group is a letter group, with the group label the same as the letter. If the sort value is numeric, the group is a number group, with the label <code class="code">glsnumbers</code>, otherwise the group is a symbol group with the label <code class="code">glssymbols</code>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+For the <a id="wrglossary.10824"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>, see §<a href="#sec:printunsrtgroups">8.4.1</a> for more details about how <a id="wrglossary.10825"></a><a href="#glo:idx.group">group</a> headers are inserted into the <a id="wrglossary.10826"></a><a href="#glo:dual.glossary">glossary</a>. Only those commands are able to support sub-<a id="wrglossary.10827"></a><a href="#glo:idx.group">groups</a>. </div><!-- end of information -->
+<p>
+With <a id="wrglossary.10828"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, the number group is automatically provided with the <a id="wrglossary.10829"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="optfmt">=glsnumbers</span> package option. It can be suppressed with <a id="wrglossary.10830"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="optfmt">={glsnumbers=false}</span> (see the base <a id="wrglossary.10831"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> user manual for further details).<p>
+With <a id="wrglossary.10832"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, group formation requires <a id="wrglossary.10833"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> (or <a id="wrglossary.10834"></a><a href="#glo:switch.group"><span class="shortargfmt">-g</span></a>). This setting is off by default to allow for a faster process where no groups are required. When this setting is on, there are additional groups, depending on the sort method. For example, if you use a date-time sort method, then you will have date-time groups.<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+Take care not to confusion <a id="wrglossary.10835"></a><a href="#glo:idx.group">groups</a> with hierarchy. See <a href="https://www.dickimaw-books.com/gallery/index.php?label=logicaldivisions">Gallery: Logical Glossary Divisions (type vs group vs parent)</a> for the difference between the <a id="wrglossary.10836"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a>, <a id="wrglossary.10837"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> and <a id="wrglossary.10838"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> fields. </div><!-- end of warning -->
+<p>
+The base <a id="wrglossary.10839"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package provides a simplistic way of assigning a title to a group to allow for the use of language-sensitive commands <a id="wrglossary.10840"></a><a href="#glo:glssymbolsgroupname"><code class="csfmt">\glssymbolsgroupname</code></a> and <a id="wrglossary.10841"></a><a href="#glo:glsnumbersgroupname"><code class="csfmt">\glsnumbersgroupname</code></a>, which correspond to the <code class="code">glssymbols</code> and <code class="code">glsnumbers</code> groups. The more flexible groups that can be created with <a id="wrglossary.10842"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> require a better approach that is less likely to cause a conflict.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10843"></a><code class="code"><dfn id="glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></dfn>{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}{<span class="meta">〈<em class="metainner">group-title</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Globally assigns the given title <span class="meta">〈<em class="metainner">group-title</em>〉</span> to the group identified by <span class="meta">〈<em class="metainner">group-label</em>〉</span>. This command is used implicitly within the <a id="wrglossary.10844"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file to assign titles to groups obtained by <a id="wrglossary.10845"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. Judicious definitions of the helper commands provided by <a id="wrglossary.10846"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can provide a more flexible way of assigning groups.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10847"></a><code class="code"><dfn id="glo:glsxtrlocalsetgrouptitle"><code class="csfmt">\glsxtrlocalsetgrouptitle</code></dfn>{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}{<span class="meta">〈<em class="metainner">group-title</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but the assignment is local.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10848"></a><code class="code"><dfn id="glo:glsxtrgetgrouptitle"><code class="csfmt">\glsxtrgetgrouptitle</code></dfn>{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Obtains the title corresponding to the group identified by <span class="meta">〈<em class="metainner">group-label</em>〉</span> and stores the result in <span class="meta">〈<em class="metainner">cs</em>〉</span>. This command first checks if a title has been assigned by <a id="wrglossary.10849"></a><a href="#glo:glsxtrgetgrouptitle"><code class="csfmt">\glsxtrgetgrouptitle</code></a> and then, for compatibility with the base <a id="wrglossary.10850"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, it will test for the existence of <code class="csfmt">\<span class="meta">〈<em class="metainner">group-label</em>〉</span>groupname</code> if <span class="meta">〈<em class="metainner">group-label</em>〉</span> is <code class="code">glssymbols</code> or <code class="code">glsnumbers</code> or a single character. If no title is obtained from any of these tests, then the title will be assumed to be the same as the label.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+The <a id="wrglossary.10851"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a> command has a slightly different method, which uses the character code so it’s not suitable with <a id="wrglossary.10852"></a><a href="#glo:dual.utf8">UTF-8</a>. In general, <a id="wrglossary.10853"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a> is best avoided, where possible, and is inappropriate for locale-sensitive sorting. </div><!-- end of information -->
+<p>
+
+</section><!-- end of section sec:glosgroups -->
+
+<section id="sec:stylemods"><!-- start of section sec:stylemods --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->8.6.5. <span class="styfmt">glossaries-extra-stylemods</span><div class="labellink"><a href="#sec:stylemods">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+The <a id="wrglossary.10854"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> package (more conveniently loaded through the <a id="wrglossary.10855"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> <a id="wrglossary.10856"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a> option) modifies some of the predefined styles that are provided with the <a id="wrglossary.10857"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Any styles loaded after <a id="wrglossary.10858"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> won’t be patched. </div><!-- end of important -->
+<p>
+The <a id="wrglossary.10859"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a> option may be provided without a value, in which case all currently defined styles will be patched. Alternatively, you can supply a comma-separated list as the value, which indicates that, for each <span class="meta">〈<em class="metainner">element</em>〉</span> in the list, the package <span class="styfmt">glossary-<span class="meta">〈<em class="metainner">element</em>〉</span></span> should be loaded and, if it’s a package provided with the base <a id="wrglossary.10860"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, patched. For example: <pre class="compactcodebox"><code class="cmd">\usepackage</code>{glossaries-extra}
+<code class="cmd">\usepackage</code>{glossary-longragged}
+<code class="cmd">\usepackage</code>{glossary-mcols}
+<code class="cmd">\usepackage</code>{glossaries-extra-stylemods}
+<a id="wrglossary.10861"></a><a href="#glo:setglossarystyle"><code class="csfmt">\setglossarystyle</code></a>{<a id="wrglossary.10862"></a><a href="#glo:opt.glostyle.mcolindex"><span class="glostylefmt">mcolindex</span></a>}
+</pre> is equivalent to: <pre class="compactcodebox"><code class="cmd">\usepackage</code>[<a id="wrglossary.10863"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a><span class="optfmt">={longragged,mcols}</span>,<a id="wrglossary.10864"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.10865"></a><a href="#glo:opt.glostyle.mcolindex"><span class="glostylefmt">mcolindex</span></a></span>]{glossaries-extra}
+</pre> You may prefer to combine <a id="wrglossary.10866"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a><span class="optfmt">=w</span>ith <a id="wrglossary.10867"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a> to reduce the overhead of loading unnecessary packages.<p>
+The <a id="wrglossary.10868"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> package adjusts the predefined styles so that they all use <a id="wrglossary.10869"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a> and replaces any hard-coded space before the <a id="wrglossary.10870"></a><a href="#glo:dual.locationlist">location list</a> with <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10871"></a><code class="code"><dfn id="glo:glsxtrprelocation"><code class="csfmt">\glsxtrprelocation</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\space</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ You can therefore redefine that command in combination with <a id="wrglossary.10872"></a><a href="#glo:opt.postpunc"><span class="styoptfmt">postpunc</span></a> to alter the separator before the <a id="wrglossary.10873"></a><a href="#glo:dual.locationlist">location list</a>. For example, to have a comma followed by <a id="wrglossary.10874"></a><a href="#glo:hfil"><code class="csfmt">\hfil</code></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.10875"></a><a href="#glo:opt.postpunc"><span class="styoptfmt">postpunc</span></a><span class="optfmt">=</span><a id="wrglossary.10876"></a><a href="#glo:optval.postpunc.comma"><span class="optfmt">comma</span></a>,<a id="wrglossary.10877"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a>]{glossaries-extra}
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.10878"></a><a href="#glo:glsxtrprelocation"><code class="csfmt">\glsxtrprelocation</code></a>}{<a id="wrglossary.10879"></a><a href="#glo:hfil"><code class="csfmt">\hfil</code></a>}
+</pre><p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+Be careful with doing this as it will look odd if the <a id="wrglossary.10880"></a><a href="#glo:locationlist">location list</a> is missing. </div><!-- end of warning -->
+<p>
+With <a id="wrglossary.10881"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> you can instead redefine <a id="wrglossary.10882"></a><a href="#glo:glsxtrprelocation"><code class="csfmt">\glsxtrprelocation</code></a> to do nothing and set the location prefixes with <a id="wrglossary.10883"></a><a href="#glo:opt.resource.loc-prefix"><span class="csoptfmt">loc-prefix</span></a> which will only apply if the entry has a <a id="wrglossary.10884"></a><a href="#glo:locationlist">location list</a>. Alternatively, you could redefine <a id="wrglossary.10885"></a><a href="#glo:glsxtrprelocation"><code class="csfmt">\glsxtrprelocation</code></a> to check if the <a id="wrglossary.10886"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a> field is set.<p>
+
+</section><!-- end of section sec:stylemods -->
+
+<section id="sec:stylemodsinline"><!-- start of section sec:stylemodsinline --><div class="tomain"><a href="#main">[top]</a></div>
+<h4><!-- start of subsubsection header -->8.6.5.1. Inline Style<div class="labellink"><a href="#sec:stylemodsinline">[link]</a></div></h4><!-- end of subsubsection header -->
+<p>
+The patched <a id="wrglossary.10887"></a><a href="#glo:opt.glostyle.inline"><span class="glostylefmt">inline</span></a> style is dealt with slightly differently. The original definition provided by the <a id="wrglossary.10888"></a><a href="#glo:pkg.glossary-inline"><span class="styfmt">glossary-inline</span></a> package uses <a id="wrglossary.10889"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a> at the end of the glossary (not after each entry description) within the definition of <a id="wrglossary.10890"></a><a href="#glo:glspostinline"><code class="csfmt">\glspostinline</code></a>. The style modification changes this so that <a id="wrglossary.10891"></a><a href="#glo:glspostinline"><code class="csfmt">\glspostinline</code></a> just does a full stop followed by space factor adjustment, and the description <a id="wrglossary.10892"></a><a href="#glo:glsinlinedescformat"><code class="csfmt">\glsinlinedescformat</code></a> and sub-entry description formats <a id="wrglossary.10893"></a><a href="#glo:glsinlinesubdescformat"><code class="csfmt">\glsinlinesubdescformat</code></a> are redefined to include <a id="wrglossary.10894"></a><a href="#glo:glsxtrpostdescription"><code class="csfmt">\glsxtrpostdescription</code></a> (not <a id="wrglossary.10895"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a>). This means that the modified <a id="wrglossary.10896"></a><a href="#glo:opt.glostyle.inline"><span class="glostylefmt">inline</span></a> style isn’t affected by the <a id="wrglossary.10897"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a> option, but the <a id="wrglossary.10898"></a><a href="#glo:dual.catpostdeschook">category post-description hook</a> can still be used.<p>
+
+</section><!-- end of section sec:stylemodsinline -->
+
+<section id="sec:stylemodstab"><!-- start of section sec:stylemodstab --><div class="tomain"><a href="#main">[top]</a></div>
+<h4><!-- start of subsubsection header -->8.6.5.2. Tabular Styles<div class="labellink"><a href="#sec:stylemodstab">[link]</a></div></h4><!-- end of subsubsection header -->
+<p>
+The <a id="wrglossary.10899"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>-like styles, such as <a id="wrglossary.10900"></a><a href="#glo:opt.glostyle.long"><span class="glostylefmt">long</span></a> are adjusted so that the <a id="wrglossary.10901"></a><a href="#glo:ifglsnogroupskip"><code class="csfmt">\ifglsnogroupskip</code></a> conditional (set with <a id="wrglossary.10902"></a><a href="#glo:opt.nogroupskip"><span class="styoptfmt">nogroupskip</span></a>) is moved outside of the definition of <a id="wrglossary.10903"></a><a href="#glo:glsgroupskip"><code class="csfmt">\glsgroupskip</code></a> to avoid problems that cause an <span class="qt">“Incomplete <code class="csfmt">\iftrue</code>”</span> error with <a id="wrglossary.10904"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> and <a id="wrglossary.10905"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>. This means that if you want to change this conditional using <a id="wrglossary.10906"></a><a href="#glo:setupglossaries"><code class="csfmt">\setupglossaries</code></a> or using the <a id="wrglossary.10907"></a><a href="#glo:opt.printgloss.nogroupskip"><span class="csoptfmt">nogroupskip</span></a> option in <a id="wrglossary.10908"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>, <a id="wrglossary.10909"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a> or <a id="wrglossary.10910"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>, you must also reset the <a id="wrglossary.10911"></a><a href="#glo:idx.glossarystyle">glossary style</a>.<p>
+
+</section><!-- end of section sec:stylemodstab -->
+
+<section id="sec:stylemodslist"><!-- start of section sec:stylemodslist --><div class="tomain"><a href="#main">[top]</a></div>
+<h4><!-- start of subsubsection header -->8.6.5.3. List Styles<div class="labellink"><a href="#sec:stylemodslist">[link]</a></div></h4><!-- end of subsubsection header -->
+<p>
+The <a id="wrglossary.10912"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> styles use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10913"></a><code class="code"><dfn id="glo:glslistprelocation"><code class="csfmt">\glslistprelocation</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsxtrprelocation"><code class="csfmt">\glsxtrprelocation</code></a></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ (which defaults to <a id="wrglossary.10914"></a><a href="#glo:glsxtrprelocation"><code class="csfmt">\glsxtrprelocation</code></a>) for top-level items and: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10915"></a><code class="code"><dfn id="glo:glslistchildprelocation"><code class="csfmt">\glslistchildprelocation</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glslistprelocation"><code class="csfmt">\glslistprelocation</code></a></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ (which defaults to <a id="wrglossary.10916"></a><a href="#glo:glslistprelocation"><code class="csfmt">\glslistprelocation</code></a>) for child items.<p>
+The description (including the post-description hook) is governed by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10917"></a><code class="code"><dfn id="glo:glslistdesc"><code class="csfmt">\glslistdesc</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ for the <a id="wrglossary.10918"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> and <a id="wrglossary.10919"></a><a href="#glo:opt.glostyle.altlist"><span class="glostylefmt">altlist</span></a> styles (but not the <a id="wrglossary.10920"></a><a href="#glo:opt.glostyle.listdotted"><span class="glostylefmt">listdotted</span></a> variations).<p>
+The hard-coded <code class="code"><a id="wrglossary.10921"></a><a href="#glo:item"><code class="csfmt">\item</code></a>[<span class="meta">〈<em class="metainner">target and name</em>〉</span>]</code> is replaced with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10922"></a><code class="code"><dfn id="glo:glslistitem"><code class="csfmt">\glslistitem</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The <a id="wrglossary.10923"></a><a href="#glo:opt.glostyle.altlist"><span class="glostylefmt">altlist</span></a> styles use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10924"></a><code class="code"><dfn id="glo:glsaltlistitem"><code class="csfmt">\glsaltlistitem</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which internally uses <a id="wrglossary.10925"></a><a href="#glo:glslistitem"><code class="csfmt">\glslistitem</code></a>. The header item (for the list styles that should the group title, such as <a id="wrglossary.10926"></a><a href="#glo:opt.glostyle.listgroup"><span class="glostylefmt">listgroup</span></a>) is governed by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10927"></a><code class="code"><dfn id="glo:glslistgroupheaderitem"><code class="csfmt">\glslistgroupheaderitem</code></dfn>{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}{<span class="meta">〈<em class="metainner">header code</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This ignores the <span class="meta">〈<em class="metainner">group-label</em>〉</span> by default and simply places the second argument in the optional argument of <a id="wrglossary.10928"></a><a href="#glo:item"><code class="csfmt">\item</code></a>. The <span class="meta">〈<em class="metainner">header code</em>〉</span> is the formatted group title, possibly including a hypertarget. The spacing after the group item is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10929"></a><code class="code"><dfn id="glo:glslistgroupafterheader"><code class="csfmt">\glslistgroupafterheader</code></dfn></code></div><!-- end of pinnedbox -->
+<p>
+For just the <a id="wrglossary.10930"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> style and its letter group variations (not the <a id="wrglossary.10931"></a><a href="#glo:opt.glostyle.altlist"><span class="glostylefmt">altlist</span></a> or <a id="wrglossary.10932"></a><a href="#glo:opt.glostyle.listdotted"><span class="glostylefmt">listdotted</span></a> variations) the <a id="wrglossary.10933"></a><a href="#glo:dual.locationlist">location list</a> for child entries is followed by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10934"></a><code class="code"><dfn id="glo:glslistchildpostlocation"><code class="csfmt">\glslistchildpostlocation</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>.</span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ which defaults to a <a id="wrglossary.10935"></a><a href="#glo:idx.fullstop">full stop</a>.<p>
+The default value of <a id="wrglossary.10936"></a><a href="#glo:glslistdottedwidth"><code class="csfmt">\glslistdottedwidth</code></a> is changed so that it’s set at the start of the document (if it hasn’t been changed in the preamble). This should take into account situations where <a id="wrglossary.10937"></a><a href="#glo:hsize"><code class="csfmt">\hsize</code></a> isn’t set until the start of the document.<p>
+The separator between groups (if not <a id="wrglossary.10938"></a><a href="#glo:opt.nogroupskip"><span class="styoptfmt">nogroupskip</span></a>) is now given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10939"></a><code class="code"><dfn id="glo:glslistgroupskip"><code class="csfmt">\glslistgroupskip</code></dfn></code></div><!-- end of pinnedbox -->
+ This defaults to <a id="wrglossary.10940"></a><a href="#glo:indexspace"><code class="csfmt">\indexspace</code></a> with penalties to deter page breaks. This command isn’t used if <a id="wrglossary.10941"></a><a href="#glo:opt.nogroupskip"><span class="styoptfmt">nogroupskip</span></a> is set.<p>
+
+</section><!-- end of section sec:stylemodslist -->
+
+<section id="sec:stylemodstree"><!-- start of section sec:stylemodstree --><div class="tomain"><a href="#main">[top]</a></div>
+<h4><!-- start of subsubsection header -->8.6.5.4. Tree Styles<div class="labellink"><a href="#sec:stylemodstree">[link]</a></div></h4><!-- end of subsubsection header -->
+<p>
+The group headings for styles like <a id="wrglossary.10942"></a><a href="#glo:opt.glostyle.treegroup"><span class="glostylefmt">treegroup</span></a> are formatted with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10943"></a><code class="code"><dfn id="glo:glstreegroupheaderfmt"><code class="csfmt">\glstreegroupheaderfmt</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The navigation elements for styles like <a id="wrglossary.10944"></a><a href="#glo:opt.glostyle.treehypergroup"><span class="glostylefmt">treehypergroup</span></a> is formatted with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10945"></a><code class="code"><dfn id="glo:glstreenavigationfmt"><code class="csfmt">\glstreenavigationfmt</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The above two commands are defined in terms of <a id="wrglossary.10946"></a><a href="#glo:glstreenamefmt"><code class="csfmt">\glstreenamefmt</code></a>, since that was the command originally used for the group headings and navigation. This now allows these different elements to be defined independently, but the most common redefinition is for <a id="wrglossary.10947"></a><a href="#glo:glstreenamefmt"><code class="csfmt">\glstreenamefmt</code></a> to remove the bold in the name. If the bold is still required for the group heading and navigation elements, then both other commands also need redefining. To simplify matters, all three commands have been defined to use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10948"></a><code class="code"><dfn id="glo:glstreedefaultnamefmt"><code class="csfmt">\glstreedefaultnamefmt</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This simply does <code class="code"><a id="wrglossary.10949"></a><a href="#glo:textbf"><code class="csfmt">\textbf</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code>.<p>
+This means that if you want to change all three to use a particular style you only need to redefine <a id="wrglossary.10950"></a><a href="#glo:glstreedefaultnamefmt"><code class="csfmt">\glstreedefaultnamefmt</code></a>, but if you only want to redefine <a id="wrglossary.10951"></a><a href="#glo:glstreenamefmt"><code class="csfmt">\glstreenamefmt</code></a> without affecting the other two commands, then you now can.<p>
+The separator between groups without headers is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10952"></a><code class="code"><dfn id="glo:glstreegroupskip"><code class="csfmt">\glstreegroupskip</code></dfn></code></div><!-- end of pinnedbox -->
+ This defaults to just <a id="wrglossary.10953"></a><a href="#glo:indexspace"><code class="csfmt">\indexspace</code></a> without penalties. This command isn’t used if <a id="wrglossary.10954"></a><a href="#glo:opt.nogroupskip"><span class="styoptfmt">nogroupskip</span></a> is set. (The penalties introduced in v1.41 were moved to <a id="wrglossary.10955"></a><a href="#glo:glstreegroupheaderskip"><code class="csfmt">\glstreegroupheaderskip</code></a> in v1.42 as they are inappropriate when there’s no header.)<p>
+The separator between groups with headers is now given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10956"></a><code class="code"><dfn id="glo:glstreegroupheaderskip"><code class="csfmt">\glstreegroupheaderskip</code></dfn></code></div><!-- end of pinnedbox -->
+ This defaults to <a id="wrglossary.10957"></a><a href="#glo:glstreegroupskip"><code class="csfmt">\glstreegroupskip</code></a> with penalties to deter page breaks after the group heading.<p>
+The styles that display the <a id="wrglossary.10958"></a><a href="#glo:idx.group">group</a> titles now use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10959"></a><code class="code"><dfn id="glo:glstreePreHeader"><code class="csfmt">\glstreePreHeader</code></dfn>{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}{<span class="meta">〈<em class="metainner">group-title</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does nothing by default and is inserted before the group title. You can redefine it to add the group title to the PDF bookmarks. For example, if the <a id="wrglossary.10960"></a><a href="#glo:dual.glossary">glossary</a> title uses <a id="wrglossary.10961"></a><a href="#glo:chapter"><code class="csfmt">\chapter</code></a> then: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.10962"></a><a href="#glo:glstreePreHeader"><code class="csfmt">\glstreePreHeader</code></a>}[2]{<span class="comment">% </span>
+ <a id="wrglossary.10963"></a><a href="#glo:pdfbookmark"><code class="csfmt">\pdfbookmark</code></a>[1]{#2}{<a id="wrglossary.10964"></a><a href="#glo:currentglossary"><code class="csfmt">\currentglossary</code></a>.#1}<span class="comment">% </span>
}
-</pre>
-<!--l. 11994--><p class="nopar" > which uses:
-</p><!--l. 11996--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-81019"></a> <span
-class="cmtt-10">\glsxtrnamereflink{</span>&#x27E8;<span
-class="cmitt-10">format</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">title</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">target</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">file</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 11998--><p class="noindent" >
-This ignores the &#x27E8;<span
-class="cmti-10">prefix</span>&#x27E9;, &#x27E8;<span
-class="cmti-10">counter</span>&#x27E9; and <span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmti-10">location</span>&#x27E9;<span
-class="cmtt-10">} </span>arguments and instead creates a
-hyperlink with the target name obtained from &#x27E8;<span
-class="cmti-10">target</span>&#x27E9; (and &#x27E8;<span
-class="cmti-10">file</span>&#x27E9;, if not empty).
-</p><!--l. 12002--><p class="indent" > Since pages and equations typically don&#8217;t have titles, the default definition of
-<span
-class="cmtt-10">\glsxtrdisplaylocnameref </span>checks the counter was used as the location. If it&#8217;s <span
-class="cmss-10">page</span><a
- id="dx1-81020"></a>
-or if &#x27E8;<span
-class="cmti-10">title</span>&#x27E9; is empty, then just the location is used as the hyperlink text. If the counter
-<span
-class="cmss-10">equation</span><a
- id="dx1-81021"></a>, then the text is the location in parentheses. Otherwise the text is obtained
-from &#x27E8;<span
-class="cmti-10">title</span>&#x27E9;.
-</p><!--l. 12009--><p class="indent" > If &#x27E8;<span
-class="cmti-10">file</span>&#x27E9; is empty an internal link is created with:
-</p><!--l. 12010--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-81022"></a> <span
-class="cmtt-10">\glsxtrfmtinternalnameref{</span>&#x27E8;<span
-class="cmitt-10">target</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">format</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">title</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 12012--><p class="noindent" >
-otherwise an external link is created with:
-</p><!--l. 12014--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-81023"></a> <span
-class="cmtt-10">\glsxtrfmtexternalnameref{</span>&#x27E8;<span
-class="cmitt-10">target</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">format</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">title</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">file</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 12016--><p class="noindent" >
-The &#x27E8;<span
-class="cmti-10">file</span>&#x27E9; argument is set by <a
- id="dx1-81024"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> for supplemental locations.
-</p><!--l. 12020--><p class="indent" > Here&#8217;s alternative definition that uses the &#x27E8;<span
-class="cmti-10">prefix</span>&#x27E9; and &#x27E8;<span
-class="cmti-10">counter</span>&#x27E9; to reform the
-target name (as <span
-class="cmtt-10">\glsnoidxdisplayloc</span>) but uses the &#x27E8;<span
-class="cmti-10">title</span>&#x27E9; as the hyperlink
-text:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-273">
-\renewcommand*{\glsxtrdisplaylocnameref}[7]{%
-&#x00A0;\glsxtrnamereflink{#3}{#5}{#6}{#7}%
+</pre> will insert section-level bookmarks. The use of <a id="wrglossary.10965"></a><a href="#glo:currentglossary"><code class="csfmt">\currentglossary</code></a> helps to provide unique bookmark labels in the event of multiple glossaries.<p>
+The <a id="wrglossary.10966"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a> package provides the commands <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10967"></a><code class="code"><dfn id="glo:glstreepredesc"><code class="csfmt">\glstreepredesc</code></dfn></code></div><!-- end of pinnedbox -->
+ and <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10968"></a><code class="code"><dfn id="glo:glstreechildpredesc"><code class="csfmt">\glstreechildpredesc</code></dfn></code></div><!-- end of pinnedbox -->
+ (which both default to a space) and uses them in the <a id="wrglossary.10969"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a>-like styles, but not for the <a id="wrglossary.10970"></a><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a> style. The <a id="wrglossary.10971"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> package modifies the <a id="wrglossary.10972"></a><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a> style so that it has equivalent hooks: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10973"></a><code class="code"><dfn id="glo:glsalttreepredesc"><code class="csfmt">\glsalttreepredesc</code></dfn></code></div><!-- end of pinnedbox -->
+ and <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10974"></a><code class="code"><dfn id="glo:glsalttreechildpredesc"><code class="csfmt">\glsalttreechildpredesc</code></dfn></code></div><!-- end of pinnedbox -->
+ These do nothing by default.<p>
+The <a id="wrglossary.10975"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a>-like and <a id="wrglossary.10976"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a>-like styles insert the pre-<a id="wrglossary.10977"></a><a href="#glo:dual.locationlist">location list</a> space with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10978"></a><code class="code"><dfn id="glo:glstreeprelocation"><code class="csfmt">\glstreeprelocation</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsxtrprelocation"><code class="csfmt">\glsxtrprelocation</code></a></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ (which defaults to <a id="wrglossary.10979"></a><a href="#glo:glsxtrprelocation"><code class="csfmt">\glsxtrprelocation</code></a>) for top-level items and <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10980"></a><code class="code"><dfn id="glo:glstreechildprelocation"><code class="csfmt">\glstreechildprelocation</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glstreeprelocation"><code class="csfmt">\glstreeprelocation</code></a></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ (which defaults to <a id="wrglossary.10981"></a><a href="#glo:glstreeprelocation"><code class="csfmt">\glstreeprelocation</code></a>) for child items.<p>
+The styles like <a id="wrglossary.10982"></a><a href="#glo:opt.glostyle.treenoname"><span class="glostylefmt">treenoname</span></a> use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10983"></a><code class="code"><dfn id="glo:glstreenonamedesc"><code class="csfmt">\glstreenonamedesc</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ to display the pre-description separator, the description and the post-description hook. Similarly for the symbol: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10984"></a><code class="code"><dfn id="glo:glstreenonamesymbol"><code class="csfmt">\glstreenonamesymbol</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The above are just used for top-level entries. Child entries don’t have the name or symbol displayed for the <a id="wrglossary.10985"></a><a href="#glo:opt.glostyle.treenoname"><span class="glostylefmt">treenoname</span></a> styles, so there’s only a command for the child description: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10986"></a><code class="code"><dfn id="glo:glstreenonamechilddesc"><code class="csfmt">\glstreenonamechilddesc</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<p>
+For the <a id="wrglossary.10987"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a> styles (but not the <a id="wrglossary.10988"></a><a href="#glo:opt.glostyle.treenoname"><span class="glostylefmt">treenoname</span></a> or <a id="wrglossary.10989"></a><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a> styles), the description is displayed using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10990"></a><code class="code"><dfn id="glo:glstreedesc"><code class="csfmt">\glstreedesc</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ and the symbol with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10991"></a><code class="code"><dfn id="glo:glstreesymbol"><code class="csfmt">\glstreesymbol</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Again the above two commands are just for top-level entries. The child entries use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10992"></a><code class="code"><dfn id="glo:glstreechilddesc"><code class="csfmt">\glstreechilddesc</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ for the description and <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10993"></a><code class="code"><dfn id="glo:glstreechildsymbol"><code class="csfmt">\glstreechildsymbol</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ for the symbol. There are now wrapper commands for <a id="wrglossary.10994"></a><a href="#glo:glstreedesc"><code class="csfmt">\glstreedesc</code></a> and <a id="wrglossary.10995"></a><a href="#glo:glstreechilddesc"><code class="csfmt">\glstreechilddesc</code></a> that check for the description and symbol to determine what separator to use before the page list: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10996"></a><code class="code"><dfn id="glo:glstreeDescLoc"><code class="csfmt">\glstreeDescLoc</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ for top-level entries and <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.10997"></a><code class="code"><dfn id="glo:glstreeChildDescLoc"><code class="csfmt">\glstreeChildDescLoc</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ for sub-entries.<p>
+If either the symbol or description is present these will use <a id="wrglossary.10998"></a><a href="#glo:glstreeprelocation"><code class="csfmt">\glstreeprelocation</code></a> or <a id="wrglossary.10999"></a><a href="#glo:glstreechildprelocation"><code class="csfmt">\glstreechildprelocation</code></a>, respectively. Otherwise, both will use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11000"></a><code class="code"><dfn id="glo:glstreeNoDescSymbolPreLocation"><code class="csfmt">\glstreeNoDescSymbolPreLocation</code></dfn></code></div><!-- end of pinnedbox -->
+ The default is a space. This means that you could have, say, a comma followed by a space for terms that are simply an alias, but just have a space for terms that have a description that ends with a full stop (or that just have a symbol without a description) where the comma would be inappropriate.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+Version 1.42 has corrected an error that was introduced to v1.41 that caused the name to run into the location list if there was no symbol and no description. </div><!-- end of information -->
+<p>
+There are some additional commands for use with the <a id="wrglossary.11001"></a><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a> style to make it easier to modify. These commands are only defined if the <a id="wrglossary.11002"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a> package has already been loaded, which is typically the case unless the <a id="wrglossary.11003"></a><a href="#glo:opt.notree"><span class="styoptfmt">notree</span></a> or <a id="wrglossary.11004"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a> option has been used when loading <a id="wrglossary.11005"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11006"></a><code class="code"><dfn id="glo:gglssetwidest"><code class="csfmt">\gglssetwidest</code></dfn>[<span class="meta">〈<em class="metainner">level</em>〉</span>]{<span class="meta">〈<em class="metainner">name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.11007"></a><a href="#glo:glssetwidest"><code class="csfmt">\glssetwidest</code></a> but performs a global assignment.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11008"></a><code class="code"><dfn id="glo:eglssetwidest"><code class="csfmt">\eglssetwidest</code></dfn>[<span class="meta">〈<em class="metainner">level</em>〉</span>]{<span class="meta">〈<em class="metainner">name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.11009"></a><a href="#glo:glssetwidest"><code class="csfmt">\glssetwidest</code></a> but expands <span class="meta">〈<em class="metainner">name</em>〉</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11010"></a><code class="code"><dfn id="glo:xglssetwidest"><code class="csfmt">\xglssetwidest</code></dfn>[<span class="meta">〈<em class="metainner">level</em>〉</span>]{<span class="meta">〈<em class="metainner">name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.11011"></a><a href="#glo:eglssetwidest"><code class="csfmt">\eglssetwidest</code></a> but performs a global assignment.<p>
+The following only set the value if <span class="meta">〈<em class="metainner">name</em>〉</span> is wider than the current value. Local update: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11012"></a><code class="code"><dfn id="glo:glsupdatewidest"><code class="csfmt">\glsupdatewidest</code></dfn>[<span class="meta">〈<em class="metainner">level</em>〉</span>]{<span class="meta">〈<em class="metainner">name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Global update: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11013"></a><code class="code"><dfn id="glo:gglsupdatewidest"><code class="csfmt">\gglsupdatewidest</code></dfn>[<span class="meta">〈<em class="metainner">level</em>〉</span>]{<span class="meta">〈<em class="metainner">name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Locale update (expands <span class="meta">〈<em class="metainner">name</em>〉</span>): <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11014"></a><code class="code"><dfn id="glo:eglsupdatewidest"><code class="csfmt">\eglsupdatewidest</code></dfn>[<span class="meta">〈<em class="metainner">level</em>〉</span>]{<span class="meta">〈<em class="metainner">name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Global update (expands <span class="meta">〈<em class="metainner">name</em>〉</span>): <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11015"></a><code class="code"><dfn id="glo:xglsupdatewidest"><code class="csfmt">\xglsupdatewidest</code></dfn>[<span class="meta">〈<em class="metainner">level</em>〉</span>]{<span class="meta">〈<em class="metainner">name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<p>
+The widest entry value can later be retrieved using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11016"></a><code class="code"><dfn id="glo:glsgetwidestname"><code class="csfmt">\glsgetwidestname</code></dfn></code></div><!-- end of pinnedbox -->
+ which expands to the widest top-level name and: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11017"></a><code class="code"><dfn id="glo:glsgetwidestsubname"><code class="csfmt">\glsgetwidestsubname</code></dfn>{<span class="meta">〈<em class="metainner">level</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ expands to either the widest name for the given <a id="wrglossary.11018"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> or to the widest top-level name, if no widest name set for <span class="meta">〈<em class="metainner">level</em>〉</span>.<p>
+Note that if you are using <a id="wrglossary.11019"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, you can use the resource option <a id="wrglossary.11020"></a><a href="#glo:opt.resource.set-widest"><span class="csoptfmt">set-widest</span></a> which will try to determine the widest name of all the selected entries. This isn’t guaranteed to work as it may depend on fonts or commands that <a id="wrglossary.11021"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can’t replicate, but it should be suitable for names that just consist of text, and can be more efficient than iterating over all the defined entries using TeX.<p>
+The command <a id="wrglossary.11022"></a><a href="#glo:glsfindwidesttoplevelname"><code class="csfmt">\glsfindwidesttoplevelname</code></a> provided by <a id="wrglossary.11023"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a> has a CamelCase synonym: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11024"></a><code class="code"><dfn id="glo:glsFindWidestTopLevelName"><code class="csfmt">\glsFindWidestTopLevelName</code></dfn></code></div><!-- end of pinnedbox -->
+ Similar commands are also provided. If the optional <span class="meta">〈<em class="metainner">glossary labels</em>〉</span> is omitted, the list of all non-<a id="wrglossary.11025"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a> is assumed. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11026"></a><code class="code"><dfn id="glo:glsFindWidestUsedTopLevelName"><code class="csfmt">\glsFindWidestUsedTopLevelName</code></dfn>[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]</code></div><!-- end of pinnedbox -->
+ This has an additional check that the entry has been <a id="wrglossary.11027"></a><a href="#glo:@@glslabel@firstuseflag">used</a>. Naturally this is only useful if the glossaries that use the <a id="wrglossary.11028"></a><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a> style occur at the end of the document. This command should be placed just before the start of the glossary. (Alternatively, place it at the end of the document and save the value in the auxiliary file for the next run.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11029"></a><code class="code"><dfn id="glo:glsFindWidestUsedAnyName"><code class="csfmt">\glsFindWidestUsedAnyName</code></dfn>[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]</code></div><!-- end of pinnedbox -->
+ This is like the previous command but if doesn’t check the <a id="wrglossary.11030"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> key. This is useful if all <a id="wrglossary.11031"></a><a href="#glo:dual.hierarchicallevel">hierarchical levels</a> should have the same width for the name.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11032"></a><code class="code"><dfn id="glo:glsFindWidestAnyName"><code class="csfmt">\glsFindWidestAnyName</code></dfn>[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]</code></div><!-- end of pinnedbox -->
+ This is like the previous command but doesn’t check if the entry has been used.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11033"></a><code class="code"><dfn id="glo:glsFindWidestUsedLevelTwo"><code class="csfmt">\glsFindWidestUsedLevelTwo</code></dfn>[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]</code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.11034"></a><a href="#glo:glsFindWidestUsedTopLevelName"><code class="csfmt">\glsFindWidestUsedTopLevelName</code></a> but also sets the first two sub-levels as well. Any entry that has a great-grandparent is ignored.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11035"></a><code class="code"><dfn id="glo:glsFindWidestLevelTwo"><code class="csfmt">\glsFindWidestLevelTwo</code></dfn>[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]</code></div><!-- end of pinnedbox -->
+ This is like the previous command but doesn’t check if the entry has been used.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11036"></a><code class="code"><dfn id="glo:glsFindWidestUsedAnyNameSymbol"><code class="csfmt">\glsFindWidestUsedAnyNameSymbol</code></dfn>[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]{<span class="meta">〈<em class="metainner">register</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.11037"></a><a href="#glo:glsFindWidestUsedAnyName"><code class="csfmt">\glsFindWidestUsedAnyName</code></a> but also measures the symbol. The length of the widest symbol is stored in <span class="meta">〈<em class="metainner">register</em>〉</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11038"></a><code class="code"><dfn id="glo:glsFindWidestAnyNameSymbol"><code class="csfmt">\glsFindWidestAnyNameSymbol</code></dfn>[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]{<span class="meta">〈<em class="metainner">register</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like the previous command but it doesn’t check if the entry has been used.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11039"></a><code class="code"><dfn id="glo:glsFindWidestUsedAnyNameSymbolLocation"><code class="csfmt">\glsFindWidestUsedAnyNameSymbolLocation</code></dfn>[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]{<span class="meta">〈<em class="metainner">register1</em>〉</span>}{<span class="meta">〈<em class="metainner">register2</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.11040"></a><a href="#glo:glsFindWidestUsedAnyNameSymbol"><code class="csfmt">\glsFindWidestUsedAnyNameSymbol</code></a> but also measures the <a id="wrglossary.11041"></a><a href="#glo:dual.locationlist">location list</a>. This requires <a id="wrglossary.11042"></a><a href="#glo:glsentrynumberlist"><code class="csfmt">\glsentrynumberlist</code></a>. The length of the widest symbol is stored in <span class="meta">〈<em class="metainner">register1</em>〉</span> and the length of the widest <a id="wrglossary.11043"></a><a href="#glo:dual.locationlist">location list</a> is stored in <span class="meta">〈<em class="metainner">register2</em>〉</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11044"></a><code class="code"><dfn id="glo:glsFindWidestAnyNameSymbolLocation"><code class="csfmt">\glsFindWidestAnyNameSymbolLocation</code></dfn>[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]{<span class="meta">〈<em class="metainner">register1</em>〉</span>}{<span class="meta">〈<em class="metainner">register2</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like the previous command but it doesn’t check if the entry has been used.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11045"></a><code class="code"><dfn id="glo:glsFindWidestUsedAnyNameLocation"><code class="csfmt">\glsFindWidestUsedAnyNameLocation</code></dfn>[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]{<span class="meta">〈<em class="metainner">register</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.11046"></a><a href="#glo:glsFindWidestUsedAnyNameSymbolLocation"><code class="csfmt">\glsFindWidestUsedAnyNameSymbolLocation</code></a> but doesn’t measure the symbol. The length of the widest <a id="wrglossary.11047"></a><a href="#glo:dual.locationlist">location list</a> is stored in <span class="meta">〈<em class="metainner">register</em>〉</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11048"></a><code class="code"><dfn id="glo:glsFindWidestAnyNameLocation"><code class="csfmt">\glsFindWidestAnyNameLocation</code></dfn>[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]{<span class="meta">〈<em class="metainner">register</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like the previous command but doesn’t check if the entry has been used.<p>
+The layout of the symbol, description and <a id="wrglossary.11049"></a><a href="#glo:dual.locationlist">location list</a> is governed by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11050"></a><code class="code"><dfn id="glo:glsxtralttreeSymbolDescLocation"><code class="csfmt">\glsxtralttreeSymbolDescLocation</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ for top-level entries and <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11051"></a><code class="code"><dfn id="glo:glsxtralttreeSubSymbolDescLocation"><code class="csfmt">\glsxtralttreeSubSymbolDescLocation</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ for sub-entries.<p>
+There is now a user level command that performs the initialisation for the <a id="wrglossary.11052"></a><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a> style: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11053"></a><code class="code"><dfn id="glo:glsxtralttreeInit"><code class="csfmt">\glsxtralttreeInit</code></dfn></code></div><!-- end of pinnedbox -->
+ The paragraph indent for subsequent paragraphs in multi-paragraph descriptions is provided by the length: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11054"></a><code class="code"><dfn id="glo:glsxtrAltTreeIndent"><code class="csfmt">\glsxtrAltTreeIndent</code></dfn></code></div><!-- end of pinnedbox -->
+<p>
+For additional commands that are available with the <a id="wrglossary.11055"></a><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a> style, see the documented code (<span class="filefmt">glossaries-extra-code.pdf</span>). See also the accompanying sample files <a id="wrglossary.11056"></a><a href="#glo:file.sample-alttree.tex"><span class="filefmt">sample-alttree.tex</span></a>, <a id="wrglossary.11057"></a><a href="#glo:file.sample-alttree-sym.tex"><span class="filefmt">sample-alttree-sym.tex</span></a> and <a id="wrglossary.11058"></a><a href="#glo:file.sample-alttree-marginpar.tex"><span class="filefmt">sample-alttree-marginpar.tex</span></a>.<p>
+
+</section><!-- end of section sec:stylemodstree -->
+
+<section id="sec:newglossarystyles"><!-- start of section sec:newglossarystyles --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->8.7. New Glossary Styles<div class="labellink"><a href="#sec:newglossarystyles">[link]</a></div></h2><!-- end of section header -->
+<p>
+The <a id="wrglossary.11059"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package comes with some new styles. The associated style package needs to be loaded. This can be done with <code class="csfmt">\usepackage</code> but it’s simpler to use the <a id="wrglossary.11060"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a> option. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.11061"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a><span class="optfmt">=bookindex</span>,<a id="wrglossary.11062"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=bookindex</span>]{glossaries-extra}
+</pre> If you don’t require any of the base styles, use <a id="wrglossary.11063"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a> (but note that some style packages automatically load another style package if it the style builds on an existing one).<p>
+
+</section><!-- end of section sec:newglossarystyles -->
+
+<section id="sec:bookindex"><!-- start of section sec:bookindex --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->8.7.1. <span class="styfmt">glossary-bookindex</span> package<div class="labellink"><a href="#sec:bookindex">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<a id="wrglossary.11064"></a><a id="wrglossary.11065"></a>The <a id="wrglossary.11066"></a><dfn id="glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></dfn> package provides the glossary style <a id="wrglossary.11067"></a><dfn id="glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></dfn>. This is very similar to the <a id="wrglossary.11068"></a><a href="#glo:opt.glostyle.mcolindexgroup"><span class="glostylefmt">mcolindexgroup</span></a> style but is designed for indexes, so by default only the name and location list are displayed. This style is demonstrated in Example <a href="#ex:bookindex">146</a> (using <a id="wrglossary.11069"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>). Note that some entries don’t have <a id="wrglossary.11070"></a><a href="#glo:dual.locationlist">location lists</a> because they weren’t <a id="wrglossary.11071"></a><a href="#glo:@@glslabel@indexing">recorded</a> in the document, but were included as dependencies. See §<a href="#sec:seenoindex">5.9.1</a> for dealing with cross-references that may not be required.<p>
+<div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:bookindex"></a>Example 146: The <span class="optfmt">bookindex</span> style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example146.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example146.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example146.png" type="image/png" width="335" height="350">Example document demonstrating the bookindex style.</object> </div><!-- end of resultbox -->
+<p>
+The <a id="wrglossary.11072"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style only supports a maximum <a id="wrglossary.11073"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> of 2 (top-level, level 1 and level 2). It’s primarily designed for use with <a id="wrglossary.11074"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. It may be used with other indexing options, but some features may not be present and <a id="wrglossary.11075"></a><a href="#glo:dual.utf8">UTF-8</a> characters may cause a problem with non-Unicode engines in letter group headings or PDF bookmarks. (<a id="wrglossary.11076"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> uses numeric identifies by default to avoid these problems, see §<a href="#sec:printunsrtgroups">8.4.1</a>.)<p>
+The number of columns is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11077"></a><code class="code"><dfn id="glo:glsxtrbookindexcols"><code class="csfmt">\glsxtrbookindexcols</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>2</span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ which defaults to 2.<p>
+This style uses the <a id="wrglossary.11078"></a><a href="#glo:env.multicols"><span class="envfmt">multicols</span></a> environment. If the command: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11079"></a><code class="code"><dfn id="glo:glsxtrbookindexcolspread"><code class="csfmt">\glsxtrbookindexcolspread</code></dfn></code></div><!-- end of pinnedbox -->
+ isn’t empty then it’s supplied as the optional argument following <code class="code"><code class="cbeg">\begin{multicols}</code>{<span class="meta">〈<em class="metainner">n</em>〉</span>}</code>. You can switch from <a id="wrglossary.11080"></a><a href="#glo:env.multicols"><span class="envfmt">multicols</span></a> to <a id="wrglossary.11081"></a><a href="#glo:env.multicols*"><span class="envfmt">multicols*</span></a> by redefining: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11082"></a><code class="code"><dfn id="glo:glsxtrbookindexmulticolsenv"><code class="csfmt">\glsxtrbookindexmulticolsenv</code></dfn></code></div><!-- end of pinnedbox -->
+ For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.11083"></a><a href="#glo:glsxtrbookindexmulticolsenv"><code class="csfmt">\glsxtrbookindexmulticolsenv</code></a>}{multicols*}
+</pre><p>
+Each top-level entry is displayed using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11084"></a><code class="code"><dfn id="glo:glsxtrbookindexname"><code class="csfmt">\glsxtrbookindexname</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This just does <code class="code"><a id="wrglossary.11085"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code> by default. For example, if you want the symbol to be included: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.11086"></a><a href="#glo:glsxtrbookindexname"><code class="csfmt">\glsxtrbookindexname</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.11087"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a>{#1}<span class="comment">% </span>
+ <a id="wrglossary.11088"></a><a href="#glo:ifglshassymbol"><code class="csfmt">\ifglshassymbol</code></a>{#1}{<code class="cmd">\space</code> (<a id="wrglossary.11089"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a>{#1})}{}<span class="comment">% </span>
}
-</pre>
-<!--l. 12027--><p class="nopar" > which uses:
-</p><!--l. 12029--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-81025"></a> <span
-class="cmtt-10">\glsxtrnameloclink{</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">counter</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">format</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">title</span>&#x27E9;<span
-class="cmtt-10">}</span>
-<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">file</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 12031--><p class="noindent" >
-This uses the same commands as <span
-class="cmtt-10">\glsxtrnamereflink </span>to produce the hyperlinks.
-</p><!--l. 12035--><p class="indent" > In both cases, the link is encapsulated with the text-block command whose
-name is given by &#x27E8;<span
-class="cmti-10">format</span>&#x27E9;, but <span
-class="cmtt-10">\glshypernumber </span>is first locally redefined to
-<span
-class="cmtt-10">\@firstofone </span>to prevent a conflict with the usual location hyperlink formation.
-This means that if the &#x27E8;<span
-class="cmti-10">format</span>&#x27E9; is <span
-class="cmtt-10">hyperbf </span>then it will simply behave like
-<span
-class="cmtt-10">textbf</span>.
-</p><!--l. 12042--><p class="indent" > For compactness, <a
- id="dx1-81026"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> merges normal records if the &#x27E8;<span
-class="cmti-10">prefix</span>&#x27E9;, &#x27E8;<span
-class="cmti-10">counter</span>&#x27E9; and
-&#x27E8;<span
-class="cmti-10">location</span>&#x27E9; all match. (An order of precedence can be provided for format conflicts.)
-With nameref records, you can use the <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">--merge-nameref-on</span></span></span> switch provided by
-<a
- id="dx1-81027"></a><span
-class="cmtt-10">bib2gls </span>v1.8+ to determine how to merge nameref records. This switch
-must be followed by one of the following keywords: <span
-class="cmtt-10">hcounter </span>(merge on
-&#x27E8;<span
-class="cmti-10">hcounter</span>&#x27E9;, default) <span
-class="cmtt-10">href </span>(merge on &#x27E8;<span
-class="cmti-10">href </span>&#x27E9;), <span
-class="cmtt-10">title </span>(merge on &#x27E8;<span
-class="cmti-10">title</span>&#x27E9;) and <span
-class="cmtt-10">location</span>
-(merge on &#x27E8;<span
-class="cmti-10">location</span>&#x27E9;, as regular records). In all cases, the &#x27E8;<span
-class="cmti-10">counter</span>&#x27E9; must also
-match.
-</p><!--l. 12053--><p class="noindent" >
-</p>
-<!--l. 12053--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">10.3.3 </span> <a
- id="sec:resourcecommands"></a>Helper Commands for Resource Options</h4>
-<!--l. 12056--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-82001"></a> <span
-class="cmtt-10">\glshex </span></div><hr>
-</p><!--l. 12058--><p class="noindent" >
-This is just defined as <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\string\u</span></span></span>, which is required when you need to indicate a
-Unicode character in the form <span
-class="cmtt-10">\u</span>&#x27E8;<span
-class="cmti-10">hex</span>&#x27E9; in some of the resource options (as illustrated
-above).
-</p><!--l. 12064--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-82002"></a> <span
-class="cmtt-10">\glscapturedgroup </span></div><hr>
-</p><!--l. 12066--><p class="noindent" >
-This is just defined as <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\string\$</span></span></span> and is used for the captured group reference in a
-replacement part of a regular expression substitution (requires at least <a
- id="dx1-82003"></a><span
-class="cmtt-10">bib2gls</span>
-version 1.5). For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-274">
-sort-replace={{([a-zA-Z])\string\.}{\glscapturedgroup1}}
-</pre>
-<!--l. 12072--><p class="nopar" > This only removes a full stop that follows any of the characters a,&#x2026;,z or
-A,&#x2026;,Z.
-</p><!--l. 12076--><p class="indent" > If you use the <span
-class="cmtt-10">save-child-count </span>resource option, you can test if the <span
-class="cmtt-10">childcount</span>
-field is non-zero using:
-</p><!--l. 12078--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82004"></a> <span
-class="cmtt-10">\GlsXtrIfHasNonZeroChildCount{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 12080--><p class="noindent" >
-This internally uses <span
-class="cmtt-10">\GlsXtrIfFieldNonZero </span>and will do &#x27E8;<span
-class="cmti-10">false</span>&#x27E9; if the field isn&#8217;t
-set. Within &#x27E8;<span
-class="cmti-10">true</span>&#x27E9; and &#x27E8;<span
-class="cmti-10">false</span>&#x27E9; you can use <span
-class="cmtt-10">\glscurrentfieldvalue </span>to access
-the value. (It will be 0 in &#x27E8;<span
-class="cmti-10">false</span>&#x27E9; if the field isn&#8217;t set.) As from v1.47, there
-is also a starred version which uses <span
-class="cmtt-10">\GlsXtrIfFieldNonZero* </span>(don&#8217;t add
-grouping).
-</p><!--l. 12089--><p class="indent" > A convenient shortcut for use in the <span
-class="cmtt-10">entry-type-aliases </span>setting:
-</p><!--l. 12091--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82005"></a> <span
-class="cmtt-10">\GlsXtrBibTeXEntryAliases </span></div><hr>
-</p><!--l. 12093--><p class="noindent" >
-This provides aliases for BibTeX&#8217;s standard entry types to <a
- id="dx1-82006"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span>&#8217;s</a> <span
-class="cmtt-10">@bibtexentry</span>
-entry type (requires at least <a
- id="dx1-82007"></a><span
-class="cmtt-10">bib2gls </span>version 1.4).
-</p><!--l. 12098--><p class="indent" > You may also want to provide storage keys for BibTeX&#8217;s standard fields rather
-than having to alias them all. This can be done with:
-</p><!--l. 12100--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82008"></a> <span
-class="cmtt-10">\GlsXtrProvideBibTeXFields </span></div><hr>
-</p><!--l. 12102--><p class="noindent" >
-Note that BibTeX&#8217;s <span
-class="cmtt-10">type </span>field clashes with the <span
-class="cmss-10">glossaries</span><a
- id="dx1-82009"></a> package&#8217;s <span
-class="cmss-10">type</span><a
- id="dx1-82010"></a> key, so
-this command provides the key <span
-class="cmtt-10">bibtextype </span>instead. You can alias it with
-<span
-class="cmtt-10">field-aliases=type=bibtextype </span>in the resource options. Each storage
-key is provided with a convenient command to access the value in the form
-<span
-class="cmtt-10">\glsxtrbib</span>&#x27E8;<span
-class="cmti-10">field</span>&#x27E9;. For example, <span
-class="cmtt-10">\glsxtrbibaddress</span>. The <span
-class="cmtt-10">bibtextype </span>field can be
-accessed with <span
-class="cmtt-10">\glsxtrbibtype</span>. Each of these commands takes the entry label as the
-sole argument.
-</p><!--l. 12113--><p class="indent" > The <span
-class="cmss-10">glossaries-extra-bib2gls</span><a
- id="dx1-82011"></a> package also provides definitions of the missing
-mathematical Greek commands: <span
-class="cmtt-10">\Alpha</span><a
- id="dx1-82012"></a>, <span
-class="cmtt-10">\Beta</span><a
- id="dx1-82013"></a>, <span
-class="cmtt-10">\Epsilon</span><a
- id="dx1-82014"></a>, <span
-class="cmtt-10">\Zeta</span><a
- id="dx1-82015"></a>, <span
-class="cmtt-10">\Eta</span><a
- id="dx1-82016"></a>, <span
-class="cmtt-10">\Iota</span><a
- id="dx1-82017"></a>,
-<span
-class="cmtt-10">\Kappa</span><a
- id="dx1-82018"></a>, <span
-class="cmtt-10">\Mu</span><a
- id="dx1-82019"></a>, <span
-class="cmtt-10">\Nu</span><a
- id="dx1-82020"></a>, <span
-class="cmtt-10">\Omicron</span><a
- id="dx1-82021"></a>, <span
-class="cmtt-10">\Rho</span><a
- id="dx1-82022"></a>, <span
-class="cmtt-10">\Tau</span><a
- id="dx1-82023"></a>, <span
-class="cmtt-10">\Chi</span><a
- id="dx1-82024"></a>, <span
-class="cmtt-10">\Digamma</span><a
- id="dx1-82025"></a>, <span
-class="cmtt-10">\omicron</span><a
- id="dx1-82026"></a>. These are all
-defined with <span
-class="cmtt-10">\providecommand</span>, so they won&#8217;t override any definitions provided by
-any package loaded before <span
-class="cmss-10">glossaries-extra</span><a
- id="dx1-82027"></a>. Since <a
- id="dx1-82028"></a><span
-class="cmtt-10">bib2gls</span>&#8217;s interpreter recognises
-these commands, using them instead of explicitly using the Latin characters with the
-same shape helps to keep the Greek symbols together when sorting. Similarly,
-if <span
-class="cmss-10">upgreek</span><a
- id="dx1-82029"></a> has been loaded, the missing upright Greek commands are also
-provided.
-</p><!--l. 12127--><p class="indent" > The remaining commands provide common rule blocks for use in the
-<span
-class="cmtt-10">sort-rule </span>resource option. If you want a rule for a specific locale, you can
-provide similar commands in a file called <span
-class="cmtt-10">glossariesxtr-</span>&#x27E8;<span
-class="cmti-10">tag</span>&#x27E9;<span
-class="cmtt-10">.ldf</span>, where &#x27E8;<span
-class="cmti-10">tag</span>&#x27E9;
-identifies the dialect, locale, region or root language. See the description of
-
-
-
-<span
-class="cmtt-10">\IfTrackedLanguageFileExists </span>in the <span
-class="cmss-10">tracklang</span><a
- id="dx1-82030"></a> documentation for further details.
-If this file is on TeX&#8217;s path and the <span
-class="cmss-10">tracklang</span><a
- id="dx1-82031"></a> package (automatically loaded by
-<span
-class="cmss-10">glossaries</span>) detects that the document has requested that language or locale, then the
-file will automatically be loaded. For example, if you want to provide a rule
-block for Welsh, then create a file called <span
-class="cmtt-10">glossariesxtr-welsh.ldf </span>that
-contains:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-275">
-\ProvidesGlossariesExtraLang{welsh}[2018/02/23&#x00A0;v1.0]
-\@ifpackageloaded{glossaries-extra-bib2gls}
-{
-&#x00A0;&#x00A0;\newcommand{\glsxtrWelshRules}{%
-&#x00A0;&#x00A0;&#x00A0;\glsxtrLatinA
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;b,B
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;c,C
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;ch,CH
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;d,D
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;dd,DD
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;\glsxtrLatinE
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;f,F
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;ff,FF
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;g,G
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;ng,NG
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;\glsxtrLatinH
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;\glsxtrLatinI
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;j,J
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;\glsxtrLatinL
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;ll,LL
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;\glsxtrLatinM
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;\glsxtrLatinN
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;\glsxtrLatinO
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;\glsxtrLatinP
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;ph,PH
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;r,R
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;rh,RH
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;\glsxtrLatinS
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;\glsxtrLatinT
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;th,TH
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;u,U
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;w,W
-&#x00A0;&#x00A0;&#x00A0;\string&#x003C;y,Y
-&#x00A0;&#x00A0;}
+</pre> or if you want the description (if set): <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.11090"></a><a href="#glo:glsxtrbookindexname"><code class="csfmt">\glsxtrbookindexname</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.11091"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a>{#1}<span class="comment">% </span>
+ <a id="wrglossary.11092"></a><a href="#glo:ifglshasdesc"><code class="csfmt">\ifglshasdesc</code></a>{#1}{<code class="cmd">\space</code> <a id="wrglossary.11093"></a><a href="#glo:glossentrydesc"><code class="csfmt">\glossentrydesc</code></a>{#1}<a id="wrglossary.11094"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a>}<span class="comment">% </span>
}
-{}%&#x00A0;glossaries-extra-bib2gls.sty&#x00A0;not&#x00A0;loaded
-</pre>
-<!--l. 12177--><p class="nopar" > (The use of <span
-class="cmtt-10">\string </span>is in case the <span
-class="cmtt-10">&#x003C; </span>character has been made active.) You can
-provide more than one rule-block per local, to allow for loanwords or foreign words.
-For example, you could provide <span
-class="cmtt-10">\glsxtrWelshIRules</span>, <span
-class="cmtt-10">\glsxtrWelshIIRules</span>
-etc.
-</p><!--l. 12184--><p class="indent" > If the rules are for a particular script (independent of language or region) then
-they can be provided in a file given by <span
-class="cmtt-10">glossariesxtr-</span>&#x27E8;<span
-class="cmti-10">script</span>&#x27E9;<span
-class="cmtt-10">.ldf </span>instead. For
-example, the file <span
-class="cmtt-10">glossariesxtr-Cyrl.ldf </span>could contain:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-276">
-\ProvidesGlossariesExtraLang{Cyrl}[2018/02/23&#x00A0;v1.0]
-\newcommand*{\glsxtrGeneralCyrillicIRules}{%
-&#x00A0;&#x00A0;%&#x00A0;Cyrillic&#x00A0;rules
+</pre> (which picks up the <a id="wrglossary.11095"></a><a href="#glo:dual.postdeschook">post-description hook</a>).<p>
+Alternatively you can use the <a id="wrglossary.11096"></a><a href="#glo:glsxtrpostnamecategory"><code class="csfmt">\glsxtrpostname<span class="meta">〈<em class="metainner">category</em>〉</span></code></a> hook to append information after the name according to the entry’s category.<p>
+Sub-entries are displayed using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11097"></a><code class="code"><dfn id="glo:glsxtrbookindexsubname"><code class="csfmt">\glsxtrbookindexsubname</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which just defaults to <code class="code"><a id="wrglossary.11098"></a><a href="#glo:glsxtrbookindexname"><code class="csfmt">\glsxtrbookindexname</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>.<p>
+The separator used before the <a id="wrglossary.11099"></a><a href="#glo:dual.locationlist">location list</a> for top-level entries is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11100"></a><code class="code"><dfn id="glo:glsxtrbookindexprelocation"><code class="csfmt">\glsxtrbookindexprelocation</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">entry-label</em>〉</span> is the entry’s label. This checks if the <a id="wrglossary.11101"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a> field has been set. If it has, it does: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>,<a id="wrglossary.11102"></a><a href="#glo:glsxtrprelocation"><code class="csfmt">\glsxtrprelocation</code></a>
+</pre> otherwise it just does <a id="wrglossary.11103"></a><a href="#glo:glsxtrprelocation"><code class="csfmt">\glsxtrprelocation</code></a> (which defaults to <code class="csfmt">\space</code>) with no comma. If you’re using <a id="wrglossary.11104"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> with <a id="wrglossary.11105"></a><a href="#glo:opt.resource.save-locations"><span class="csoptfmt">save-locations</span></a><span class="optfmt">=false</span>, the <a id="wrglossary.11106"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a> field won’t be set.<p>
+The separator used before the <a id="wrglossary.11107"></a><a href="#glo:dual.locationlist">location list</a> for sub-entries is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11108"></a><code class="code"><dfn id="glo:glsxtrbookindexsubprelocation"><code class="csfmt">\glsxtrbookindexsubprelocation</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which defaults to <code class="code"><a id="wrglossary.11109"></a><a href="#glo:glsxtrbookindexprelocation"><code class="csfmt">\glsxtrbookindexprelocation</code></a>{entry-label}</code>.<p>
+The actual location list is encapsulated with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11110"></a><code class="code"><dfn id="glo:glsxtrbookindexlocation"><code class="csfmt">\glsxtrbookindexlocation</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ for top-level entries and: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11111"></a><code class="code"><dfn id="glo:glsxtrbookindexsublocation"><code class="csfmt">\glsxtrbookindexsublocation</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ for sub-entries. These both just do <span class="meta">〈<em class="metainner">location list</em>〉</span> by default.<p>
+The separator used between a top-level parent and child entry is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11112"></a><code class="code"><dfn id="glo:glsxtrbookindexparentchildsep"><code class="csfmt">\glsxtrbookindexparentchildsep</code></dfn></code></div><!-- end of pinnedbox -->
+ This defaults to <code class="csfmt">\nopagebreak</code>.<p>
+The separator used between a sub-level parent and child entry is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11113"></a><code class="code"><dfn id="glo:glsxtrbookindexparentsubchildsep"><code class="csfmt">\glsxtrbookindexparentsubchildsep</code></dfn></code></div><!-- end of pinnedbox -->
+ This defaults to <a id="wrglossary.11114"></a><a href="#glo:glsxtrbookindexparentchildsep"><code class="csfmt">\glsxtrbookindexparentchildsep</code></a>.<p>
+The separator between top-level entries is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11115"></a><code class="code"><dfn id="glo:glsxtrbookindexbetween"><code class="csfmt">\glsxtrbookindexbetween</code></dfn>{<span class="meta">〈<em class="metainner">entry1-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry2-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This comes after the entry given by <span class="meta">〈<em class="metainner">entry1-label</em>〉</span>, if the entry has no children, or after the last descendent otherwise, so it always comes immediately before the entry given by <span class="meta">〈<em class="metainner">entry2-label</em>〉</span> unless the entry occurs at the start of a group. This does nothing by default.<p>
+The separator between two level 1 entries is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11116"></a><code class="code"><dfn id="glo:glsxtrbookindexsubbetween"><code class="csfmt">\glsxtrbookindexsubbetween</code></dfn>{<span class="meta">〈<em class="metainner">entry1-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry2-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<p>
+The separator between two level 2 entries is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11117"></a><code class="code"><dfn id="glo:glsxtrbookindexsubsubbetween"><code class="csfmt">\glsxtrbookindexsubsubbetween</code></dfn>{<span class="meta">〈<em class="metainner">entry1-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry2-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<p>
+At the end of each letter <a id="wrglossary.11118"></a><a href="#glo:idx.group">group</a>, the following hooks are done in order: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11119"></a><code class="code"><dfn id="glo:glsxtrbookindexsubsubatendgroup"><code class="csfmt">\glsxtrbookindexsubsubatendgroup</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">entry-label</em>〉</span> is the label of the last level 2 entry <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11120"></a><code class="code"><dfn id="glo:glsxtrbookindexsubatendgroup"><code class="csfmt">\glsxtrbookindexsubatendgroup</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">entry-label</em>〉</span> is the label of the last level 1 entry <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11121"></a><code class="code"><dfn id="glo:glsxtrbookindexatendgroup"><code class="csfmt">\glsxtrbookindexatendgroup</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">entry-label</em>〉</span> is the label of the last level 0 entry.<p>
+For example, the resource option <a id="wrglossary.11122"></a><a href="#glo:opt.resource.seealso"><span class="csoptfmt">seealso</span></a><span class="optfmt">=omit</span> instructs <a id="wrglossary.11123"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to omit the <a id="wrglossary.11124"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> cross-reference from the <a id="wrglossary.11125"></a><a href="#glo:dual.locationlist">location list</a>. (The <a id="wrglossary.11126"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> cross-reference will still be added unless you also have <a id="wrglossary.11127"></a><a href="#glo:opt.resource.see"><span class="csoptfmt">see</span></a><span class="optfmt">=omit</span>.) The <a id="wrglossary.11128"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> cross-reference can instead be appended after the child entries using: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.11129"></a><a href="#glo:glsxtrbookindexatendgroup"><code class="csfmt">\glsxtrbookindexatendgroup</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.11130"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a>{<a id="wrglossary.11131"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a>}{#1}<span class="comment">% </span>
+ {<a id="wrglossary.11132"></a><a href="#glo:glstreesubitem"><code class="csfmt">\glstreesubitem</code></a><a id="wrglossary.11133"></a><a href="#glo:glsxtruseseealso"><code class="csfmt">\glsxtruseseealso</code></a>{#1}}{}<span class="comment">% </span>
}
-\newcommand*{\glsxtrGeneralCyrillicIIRules}{%
-&#x00A0;&#x00A0;%&#x00A0;an&#x00A0;alternative&#x00A0;set&#x00A0;of&#x00A0;Cyrillic&#x00A0;rules
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.11134"></a><a href="#glo:glsxtrbookindexbetween"><code class="csfmt">\glsxtrbookindexbetween</code></a>}[2]{<span class="comment">% </span>
+ <a id="wrglossary.11135"></a><a href="#glo:glsxtrbookindexatendgroup"><code class="csfmt">\glsxtrbookindexatendgroup</code></a>{#1}<span class="comment">% </span>
}
-</pre>
-<!--l. 12196--><p class="nopar" > (Remember that the required document language scripts need to be tracked through
-the <span
-class="cmss-10">tracklang</span><a
- id="dx1-82032"></a> package, in order for these files to be automatically loaded. This
-essentially means ensuring you load the appropriate language package before
-<span
-class="cmss-10">tracklang</span><a
- id="dx1-82033"></a> is loaded by the base <span
-class="cmss-10">glossaries</span><a
- id="dx1-82034"></a> package or any other package that uses it.
-See the <span
-class="cmss-10">tracklang</span><a
- id="dx1-82035"></a> documentation for further details.)
-</p><!--l. 12204--><p class="indent" > Alternatively, if the rules are specific to a subject rather than a region or
-language, then you can provide a supplementary package. For example, if you have a
-package called, say, <span
-class="cmss-10">mapsymbols </span>that provides map symbols, then the file
-<span
-class="cmtt-10">mapsymbols.sty </span>might contain:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-277">
-\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{mapsymbols}
-&#x00A0;some&#x00A0;package&#x00A0;or&#x00A0;font&#x00A0;loading&#x00A0;stuff&#x00A0;here&#x00A0;to&#x00A0;provide
-&#x00A0;the&#x00A0;appropriate&#x00A0;symbols
-\newcommand{\Stadium}{...}
-\newcommand{\Battlefield}{...}
-\newcommand{\Harbour}{...}
-&#x00A0;etc
-&#x00A0;Provide&#x00A0;a&#x00A0;rule&#x00A0;block:
-\newcommand{\MapSymbolOrder}{%
-&#x00A0;\glshex&#x00A0;2694&#x00A0;%&#x00A0;crossed-swords&#x00A0;0x2694
-&#x00A0;\string&#x003C;&#x00A0;\glshex&#x00A0;2693&#x00A0;%&#x00A0;anchor&#x00A0;0x2693
-&#x00A0;\string&#x003C;&#x00A0;\glshex&#x00A0;26BD&#x00A0;%&#x00A0;football&#x00A0;0x26BD
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.11136"></a><a href="#glo:glsxtrbookindexsubatendgroup"><code class="csfmt">\glsxtrbookindexsubatendgroup</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.11137"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a>{<a id="wrglossary.11138"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a>}{#1}<span class="comment">% </span>
+ {<a id="wrglossary.11139"></a><a href="#glo:glstreesubsubitem"><code class="csfmt">\glstreesubsubitem</code></a><a id="wrglossary.11140"></a><a href="#glo:glsxtruseseealso"><code class="csfmt">\glsxtruseseealso</code></a>{#1}}{}<span class="comment">% </span>
}
-</pre>
-<!--l. 12225--><p class="nopar" > and the supplementary file <span
-class="cmtt-10">mapsymbols.bib </span>can provide the appropriate definitions
-for <a
- id="dx1-82036"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a>:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-278">
-@preamble{"\glsxtrprovidecommand{\Harbour}{\char"2693}
-\glsxtrprovidecommand{\Battlefield}{\char"2694}
-\glsxtrprovidecommand{\Stadium}{\char"26BD}"}
-</pre>
-<!--l. 12232--><p class="nopar" > Now both the preamble and rule block can be used in the resource set:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-279">
-\usepackage{mapsymbols}%&#x00A0;my&#x00A0;custom&#x00A0;package
-\usepackage[record]{glossaries-extra}
-\GlsXtrLoadResources[
-&#x00A0;&#x00A0;src={mapsymbols,%&#x00A0;&#x003C;---&#x00A0;my&#x00A0;custom&#x00A0;mapsymbols.bib
-&#x00A0;&#x00A0;&#x00A0;entries%&#x00A0;data&#x00A0;in&#x00A0;entries.bib
-&#x00A0;&#x00A0;},
-&#x00A0;&#x00A0;sort={custom},
-&#x00A0;&#x00A0;sort-rule={\glsxtrcontrolrules&#x00A0;%&#x00A0;control&#x00A0;codes
-&#x00A0;;\glsxtrspacerules&#x00A0;%&#x00A0;space&#x00A0;characters
-&#x00A0;;\glsxtrnonprintablerules&#x00A0;%&#x00A0;non-printable&#x00A0;characters
-&#x00A0;;\glsxtrcombiningdiacriticrules&#x00A0;%&#x00A0;combining&#x00A0;diacritics
-&#x00A0;,\glsxtrhyphenrules&#x00A0;%&#x00A0;hyphens
-&#x00A0;&#x003C;\glsxtrgeneralpuncrules&#x00A0;%&#x00A0;general&#x00A0;punctuation
-&#x00A0;&#x003C;\glsxtrdigitrules&#x00A0;%&#x00A0;0,&#x00A0;...,&#x00A0;9
-&#x00A0;&#x003C;\glsxtrfractionrules&#x00A0;%&#x00A0;fraction&#x00A0;symbols
-&#x00A0;&#x003C;\MapSymbolOrder&#x00A0;%&#x00A0;&#x003C;---&#x00A0;custom&#x00A0;map&#x00A0;symbols
-&#x00A0;&#x003C;\glsxtrMathItalicGreekIrules&#x00A0;%&#x00A0;math-greek&#x00A0;symbols
-&#x00A0;&#x003C;\glsxtrGeneralLatinIrules&#x00A0;%&#x00A0;Latin&#x00A0;letters
-&#x00A0;}
-]
-</pre>
-<!--l. 12257--><p class="nopar" >
-</p><!--l. 12259--><p class="indent" > The following commands are provided by <span
-class="cmss-10">glossaries-extra-bib2gls</span><a
- id="dx1-82037"></a>. They should be
-separated by the rule separator characters <span
-class="cmtt-10">;</span>&#x00A0;(semi-colon) or <span
-class="cmtt-10">,</span>&#x00A0;(comma) or
-<span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">&amp;</span></span></span>&#x00A0;(ampersand) or <span
-class="cmtt-10">&#x003C;</span>&#x00A0;(less than). See Java&#8217;s <a
-href="http://docs.oracle.com/javase/8/docs/api/java/text/RuleBasedCollator.html" >RuleBasedCollator</a> documentation for
-details of the rule syntax.
-</p><!--l. 12266--><p class="indent" > For example, the following will place the mathematical Greek symbols (<span
-class="cmtt-10">\alpha</span><a
- id="dx1-82038"></a>,
-<span
-class="cmtt-10">\Alpha</span><a
- id="dx1-82039"></a>, <span
-class="cmtt-10">\beta</span><a
- id="dx1-82040"></a>, <span
-class="cmtt-10">\Beta</span><a
- id="dx1-82041"></a> etc) in a block before Latin characters:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-280">
-sort-rule={\glsxtrcontrolrules
-&#x00A0;;\glsxtrspacerules
-&#x00A0;;\glsxtrnonprintablerules
-&#x00A0;;\glsxtrcombiningdiacriticrules
-&#x00A0;,\glsxtrhyphenrules
-&#x00A0;&#x003C;\glsxtrgeneralpuncrules
-&#x00A0;&#x003C;\glsxtrdigitrules
-&#x00A0;&#x003C;\glsxtrfractionrules
-&#x00A0;&#x003C;\glsxtrMathItalicGreekIrules
-&#x00A0;&#x003C;\glsxtrGeneralLatinIVrules
-&#x00A0;&#x003C;\glsxtrLatinAA
-&#x00A0;&#x003C;\glsxtrLatinOslash
+
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.11141"></a><a href="#glo:glsxtrbookindexsubbetween"><code class="csfmt">\glsxtrbookindexsubbetween</code></a>}[2]{<span class="comment">% </span>
+ <a id="wrglossary.11142"></a><a href="#glo:glsxtrbookindexsubatendgroup"><code class="csfmt">\glsxtrbookindexsubatendgroup</code></a>{#1}<span class="comment">% </span>
}
-</pre>
-<!--l. 12283--><p class="nopar" >
-</p><!--l. 12285--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82042"></a> <span
-class="cmtt-10">\glsxtrcontrolrules </span></div><hr>
-</p><!--l. 12287--><p class="noindent" >
-These are control characters that are usually placed at the start of a rule in the
-ignored section. They typically won&#8217;t occur in any sort values, but if they do they
-should normally be ignored.
-</p><!--l. 12292--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82043"></a> <span
-class="cmtt-10">\glsxtrspacerules </span></div><hr>
-</p><!--l. 12294--><p class="noindent" >
-These are space characters. They typically come after the control characters with the
-two blocks separated by a <span
-class="cmtt-10">;</span>&#x00A0;(semi-colon).
-</p><!--l. 12298--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82044"></a> <span
-class="cmtt-10">\glsxtrnonprintablerules </span></div><hr>
-</p><!--l. 12300--><p class="noindent" >
-These are non-printable characters (BOM, tabs, line feed and carriage return). They
-typically come after the spaces separated by a <span
-class="cmtt-10">;</span>&#x00A0;(semi-colon). These characters
-aren&#8217;t checked for by <a
- id="dx1-82045"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> when it determines whether or not to use the
-interpreter, so a&#x00A0;TAB or newline character may end up in the sort value if it wasn&#8217;t
-interpreted.
-</p><!--l. 12308--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82046"></a> <span
-class="cmtt-10">\glsxtrcombiningdiacriticrules </span></div><hr>
-</p><!--l. 12310--><p class="noindent" >
-These are combining diacritic marks which typically follow the space and
-non-printable blocks (separated by a semi-colon). This command is defined in terms
-of sub-block commands:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-281">
-\newcommand*{\glsxtrcombiningdiacriticrules}{%
-&#x00A0;\glsxtrcombiningdiacriticIrules\string;
-&#x00A0;\glsxtrcombiningdiacriticIIrules\string;
-&#x00A0;\glsxtrcombiningdiacriticIIIrules\string;
-&#x00A0;\glsxtrcombiningdiacriticIVrules
+
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.11143"></a><a href="#glo:glsxtrbookindexsubsubatendgroup"><code class="csfmt">\glsxtrbookindexsubsubatendgroup</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.11144"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a>{<a id="wrglossary.11145"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a>}{#1}<span class="comment">% </span>
+ {<a id="wrglossary.11146"></a><a href="#glo:glstreeitem"><code class="csfmt">\glstreeitem</code></a><code class="cmd">\hspace</code>*{40pt}<a id="wrglossary.11147"></a><a href="#glo:glsxtruseseealso"><code class="csfmt">\glsxtruseseealso</code></a>{#1}}{}<span class="comment">% </span>
}
-</pre>
-<!--l. 12321--><p class="nopar" > If you prefer, you can use the sub-blocks directly in your required ordered.
-</p><!--l. 12325--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82047"></a> <span
-class="cmtt-10">\glsxtrcombiningdiacriticIrules </span></div><hr>
-</p><!--l. 12327--><p class="noindent" >
-This contains the combining diacritics: acute, grave, breve, circumflex, caron, ring,
-vertical line above, diaeresis (umlaut), double acute, tilde, dot above, combining
-macron.
-</p><!--l. 12332--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82048"></a> <span
-class="cmtt-10">\glsxtrcombiningdiacriticIIrules </span></div><hr>
-</p><!--l. 12334--><p class="noindent" >
-This contains the combining diacritics: short solidus overlay, cedilla, ogonek, dot
-below, low line, overline, hook above, double vertical line above, double grave
-accent, candrabindu, inverted breve, turned comma above, comma above,
-reversed comma above, comma above right, grave accent below, acute accent
-below.
-</p><!--l. 12341--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82049"></a> <span
-class="cmtt-10">\glsxtrcombiningdiacriticIIIrules </span></div><hr>
-</p><!--l. 12343--><p class="noindent" >
-This contains the combining diacritics: left tack below, right tack below, left angle
-above, horn, left half ring below, up tack below, down tack below, plus sign below,
-minus sign below, palatalized hook below, retroflex hook below, diaresis below, ring
-below, comma below, vertical line below, bridge below, inverted double arch below,
-caron below, circumflex accent below, breve below, inverted breve below, tilde below,
-macron below, double low line, tilde overlay, short stroke overlay, long stroke overlay,
-long solidus overlay, right half ring below, inverted bridge below, square below,
-seagull below, x above, vertical tilde, double overline, Greek perispomeni, Greek
-dialytika tonos, Greek ypogegrammeni, double tilde, double inverted breve,
-Cyrillic titlo, Cyrillic palatalization, Cyrillic dasia pneumata, Cyrillic psili
-pneumata.
-</p><!--l. 12358--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82050"></a> <span
-class="cmtt-10">\glsxtrcombiningdiacriticIVrules </span></div><hr>
-</p><!--l. 12360--><p class="noindent" >
-This contains the combining diacritics: left harpoon above, right harpoon above, long
-vertical line overlay, short vertical line overlay, anticlockwise arrow above, clockwise
-arrow above, left arrow above, right arrow above, ring overlay, clockwise ring overlay,
-anticlockwise ring overlay, three dots above, four dots above, enclosing circle,
-enclosing square, enclosing diamond, enclosing circle backslash, left right arrow
-above.
-</p><!--l. 12370--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82051"></a> <span
-class="cmtt-10">\glsxtrhyphenrules </span></div><hr>
-
-
-
-</p><!--l. 12372--><p class="noindent" >
-This contains hyphens (including the minus sign 0x2212). This rule block typically
-comes after the diacritic rules separated by a comma.
-</p><!--l. 12377--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82052"></a> <span
-class="cmtt-10">\glsxtrgeneralpuncrules </span></div><hr>
-</p><!--l. 12379--><p class="noindent" >
-This contains punctuation characters. This rule block typically comes after the
-hyphen rules separated by a less than (<span
-class="cmtt-10">&#x003C;</span>). As with the combining diacritics, this
-command is defined in terms of sub-blocks which may be used directly instead if a
-different order is required:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-282">
-\newcommand*{\glsxtrgeneralpuncrules}{%
-&#x00A0;&#x00A0;\glsxtrgeneralpuncIrules
-&#x00A0;&#x00A0;\string&#x003C;\glsxtrcurrencyrules
-&#x00A0;&#x00A0;\string&#x003C;\glsxtrgeneralpuncIIrules
+
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.11148"></a><a href="#glo:glsxtrbookindexsubsubbetween"><code class="csfmt">\glsxtrbookindexsubsubbetween</code></a>}[2]{<span class="comment">% </span>
+ <a id="wrglossary.11149"></a><a href="#glo:glsxtrbookindexsubsubatendgroup"><code class="csfmt">\glsxtrbookindexsubsubatendgroup</code></a>{#1}<span class="comment">% </span>
}
-</pre>
-<!--l. 12391--><p class="nopar" >
-</p><!--l. 12393--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82053"></a> <span
-class="cmtt-10">\glsxtrgeneralpuncIrules </span></div><hr>
-</p><!--l. 12395--><p class="noindent" >
-This is the first punctuation sub-block containing: underscore, macron, comma,
-semi-colon, colon, exclamation mark, inverted exclamation mark, question
-mark, inverted question mark, solidus, full stop, acute accent, grave accent,
-circumflex accent, diaersis, tilde, middle dot, cedilla, straight apostrophe,
-straight double quote, left guillemet, right guillemet, left parenthesis, right
-parenthesis, left square bracket, right square bracket, left curly bracket, right
-curly bracket, section sign, pilcrow sign, copyright sign, registered sign, at
-sign.
-</p><!--l. 12406--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82054"></a> <span
-class="cmtt-10">\glsxtrcurrencyrules </span></div><hr>
-</p><!--l. 12408--><p class="noindent" >
-This sub-block contains some currency symbols: currency sign, Thai currency symbol
-baht, cent sign, colon sign, cruzeiro sign, dollar sign, dong sign, euro sign, French
-franc sign, lira sign, mill sign, naira sign, peseta sign, pound sign, rupee sign, new
-sheqel sign, won sign, yen sign.
-</p><!--l. 12415--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82055"></a> <span
-class="cmtt-10">\glsxtrgeneralpuncIIrules </span></div><hr>
-</p><!--l. 12417--><p class="noindent" >
-This sub-block contains some other punctuation symbols: asterisk, backslash,
-ampersand, hash sign, percent sign, plus sign, plus-minus sign, division sign,
-multiplication sign, less-than sign, equals sign, greater-than sign, not sign, vertical
-bar (pipe), broken bar, degree sign, micron sign.
-</p><!--l. 12424--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82056"></a> <span
-class="cmtt-10">\glsxtrdigitrules </span></div><hr>
-</p><!--l. 12426--><p class="noindent" >
-This rule block contains the Basic Latin digits (0, &#x2026;, 9) and the subscript and
-superscript digits (<sub class="textsubscript"><span
-class="cmr-9">0</span></sub> <sup class="textsuperscript"><span
-class="cmr-9">0</span></sup> etc) made equivalent to the corresponding Basic Latin digit.
-The digit block typically comes after the punctuation rules separated by a less than
-(<span
-class="cmtt-10">&#x003C;</span>).
-</p><!--l. 12434--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82057"></a> <span
-class="cmtt-10">\glsxtrBasicDigitrules </span></div><hr>
-</p><!--l. 12436--><p class="noindent" >
-This rule block contains just the Basic Latin digits (0, &#x2026;, 9).
-</p><!--l. 12439--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82058"></a> <span
-class="cmtt-10">\glsxtrSubScriptDigitrules </span></div><hr>
-</p><!--l. 12441--><p class="noindent" >
-This rule block contains just the subscript digits (<sub class="textsubscript"><span
-class="cmr-9">0</span></sub> &#x2026;&#x00A0;<sub class="textsubscript"><span
-class="cmr-9">9</span></sub>).
-</p><!--l. 12445--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82059"></a> <span
-class="cmtt-10">\glsxtrSuperScriptDigitrules </span></div><hr>
-
-
-
-</p><!--l. 12447--><p class="noindent" >
-This rule block contains just the superscript digits (<sup class="textsuperscript"><span
-class="cmr-9">0</span></sup> &#x2026;&#x00A0;<sup class="textsuperscript"><span
-class="cmr-9">9</span></sup>).
-</p><!--l. 12451--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82060"></a> <span
-class="cmtt-10">\glsxtrfractionrules </span></div><hr>
-</p><!--l. 12453--><p class="noindent" >
-This rule block contains vulgar fraction characters. The digit block typically comes
-after the digit rules separated by a less than (<span
-class="cmtt-10">&#x003C;</span>).
-</p><!--l. 12458--><p class="indent" > There are a number of Latin rule blocks. Some of these included extended
-characters or ligatures (such as &szlig;&#x00A0;or &#339;) but they don&#8217;t include accented
-characters. If you require a Latin rule block that includes accented characters,
-digraphs, trigraphs or other extended characters, then it&#8217;s best to provide similar
-commands in a <span
-class="cmtt-10">glossariesxtr-</span>&#x27E8;<span
-class="cmti-10">tag</span>&#x27E9;<span
-class="cmtt-10">.ldf </span>file for the particular language or
-region.
-</p><!--l. 12466--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82061"></a> <span
-class="cmtt-10">\glsxtrGeneralLatinIrules </span></div><hr>
-</p><!--l. 12468--><p class="noindent" >
-This is just the basic (non-extended) Latin alphabet with the superscript and
-subscript Latin letters (<sup class="textsuperscript"><span
-class="cmr-9">a</span></sup> <sub class="textsubscript"><span
-class="cmr-9">a</span></sub> etc) treated as the equivalent basic Latin letter. (If you
-don&#8217;t want the subscripts and superscripts included you can redefine <span
-class="cmtt-10">\glsxtrLatinA</span>
-etc to omit them.)
-</p><!--l. 12475--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82062"></a> <span
-class="cmtt-10">\glsxtrGeneralLatinIIrules </span></div><hr>
-</p><!--l. 12477--><p class="noindent" >
-This is like <span
-class="cmtt-10">\glsxtrGeneralLatinIrules </span>but it includes eth (Ð) between &#8216;D&#8217; and &#8216;E&#8217;
-and eszett (&szlig;) treated as &#8216;ss&#8217;.
-</p><!--l. 12481--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82063"></a> <span
-class="cmtt-10">\glsxtrGeneralLatinIIIrules </span></div><hr>
-</p><!--l. 12483--><p class="noindent" >
-This is like <span
-class="cmtt-10">\glsxtrGeneralLatinIrules </span>but it includes eth (Ð) between &#8216;D&#8217; and &#8216;E&#8217;
-and eszett (&szlig;) treated as &#8216;sz&#8217;.
-</p><!--l. 12487--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82064"></a> <span
-class="cmtt-10">\glsxtrGeneralLatinIVrules </span></div><hr>
-</p><!--l. 12489--><p class="noindent" >
-This is like <span
-class="cmtt-10">\glsxtrGeneralLatinIrules </span>but it includes eth (Ð) between &#8216;D&#8217; and &#8216;E&#8217;,
-ae-ligature (&aelig;) is treated as &#8216;ae&#8217;, oe-ligature (&#339;) is treated as &#8216;oe&#8217;, eszett (&szlig;) treated
-as &#8216;ss&#8217; and thorn (þ) is treated as &#8216;th&#8217;.
-</p><!--l. 12495--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82065"></a> <span
-class="cmtt-10">\glsxtrGeneralLatinVrules </span></div><hr>
-</p><!--l. 12497--><p class="noindent" >
-This is like <span
-class="cmtt-10">\glsxtrGeneralLatinIrules </span>but it includes eth (Ð) between &#8216;D&#8217; and &#8216;E&#8217;,
-eszett (&szlig;) treated as &#8216;ss&#8217; and thorn (þ) treated as &#8216;th&#8217;.
-</p><!--l. 12502--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82066"></a> <span
-class="cmtt-10">\glsxtrGeneralLatinVIrules </span></div><hr>
-</p><!--l. 12504--><p class="noindent" >
-This is like <span
-class="cmtt-10">\glsxtrGeneralLatinIrules </span>but it includes eth (Ð) between &#8216;D&#8217; and &#8216;E&#8217;,
-eszett (&szlig;) treated as &#8216;sz&#8217; and thorn (þ) treated as &#8216;th&#8217;.
-</p><!--l. 12509--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82067"></a> <span
-class="cmtt-10">\glsxtrGeneralLatinVIIrules </span></div><hr>
-</p><!--l. 12511--><p class="noindent" >
-This is like <span
-class="cmtt-10">\glsxtrGeneralLatinIrules </span>but it includes ae-ligature (&aelig;) between &#8216;A&#8217;
-and &#8216;B&#8217;, eth (Ð) between &#8216;D&#8217; and &#8216;E&#8217;, insular G (&#xA77D;) instead of &#8216;G&#8217;, oe-ligature between
-&#8216;O&#8217; and &#8216;P&#8217;, long&#x00A0;s (&#x017F;) equivalent to &#8216;s&#8217;, thorn (þ) between &#8216;T&#8217; and &#8216;U&#8217; and wynn (&#x01F7;)
-instead of W.
-</p><!--l. 12518--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82068"></a> <span
-class="cmtt-10">\glsxtrGeneralLatinVIIIrules </span></div><hr>
-
-
-
-</p><!--l. 12520--><p class="noindent" >
-This is like <span
-class="cmtt-10">\glsxtrGeneralLatinIrules </span>but ae-ligature (&aelig;) is treated as &#8216;ae&#8217;,
-oe-ligature (&#339;) is treated as &#8216;oe&#8217;, eszett (&szlig;) treated as &#8216;ss&#8217;, thorn (þ) is treated as &#8216;th&#8217;,
-Ø&#x00A0;is treated as &#8216;O&#8217; and &#8216;&#321;&#8217; is treated as &#8216;L&#8217;.
-</p><!--l. 12526--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82069"></a> <span
-class="cmtt-10">\glsxtrLatinA </span></div><hr>
-</p><!--l. 12528--><p class="noindent" >
-A mini-rule that just covers &#8216;A&#8217; but includes the sub- and superscript A.
-</p><!--l. 12532--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82070"></a> <span
-class="cmtt-10">\glsxtrLatinE </span></div><hr>
-</p><!--l. 12534--><p class="noindent" >
-A mini-rule that just covers &#8216;E&#8217; but includes the subscript E.
-</p><!--l. 12538--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82071"></a> <span
-class="cmtt-10">\glsxtrLatinH </span></div><hr>
-</p><!--l. 12540--><p class="noindent" >
-A mini-rule that just covers &#8216;H&#8217; but includes the subscript H.
-</p><!--l. 12544--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82072"></a> <span
-class="cmtt-10">\glsxtrLatinK </span></div><hr>
-</p><!--l. 12546--><p class="noindent" >
-A mini-rule that just covers &#8216;K&#8217; but includes the subscript K.
-</p><!--l. 12550--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82073"></a> <span
-class="cmtt-10">\glsxtrLatinI </span></div><hr>
-</p><!--l. 12552--><p class="noindent" >
-A mini-rule that just covers &#8216;I&#8217; but includes the superscript I.
-</p><!--l. 12556--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82074"></a> <span
-class="cmtt-10">\glsxtrLatinL </span></div><hr>
-</p><!--l. 12558--><p class="noindent" >
-A mini-rule that just covers &#8216;L&#8217; but includes the subscript L.
-</p><!--l. 12562--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82075"></a> <span
-class="cmtt-10">\glsxtrLatinM </span></div><hr>
-</p><!--l. 12564--><p class="noindent" >
-A mini-rule that just covers &#8216;M&#8217; but includes the subscript M.
-</p><!--l. 12568--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82076"></a> <span
-class="cmtt-10">\glsxtrLatinN </span></div><hr>
-</p><!--l. 12570--><p class="noindent" >
-A mini-rule that just covers &#8216;N&#8217; but includes the sub- and superscript N.
-</p><!--l. 12574--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82077"></a> <span
-class="cmtt-10">\glsxtrLatinO </span></div><hr>
-</p><!--l. 12576--><p class="noindent" >
-A mini-rule that just covers &#8216;O&#8217; but includes the sub- and superscript O.
-</p><!--l. 12580--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82078"></a> <span
-class="cmtt-10">\glsxtrLatinP </span></div><hr>
-</p><!--l. 12582--><p class="noindent" >
-A mini-rule that just covers &#8216;P&#8217; but includes the subscript P.
-</p><!--l. 12586--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82079"></a> <span
-class="cmtt-10">\glsxtrLatinS </span></div><hr>
-</p><!--l. 12588--><p class="noindent" >
-A mini-rule that just covers &#8216;S&#8217; but includes the subscript S.
-</p><!--l. 12592--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82080"></a> <span
-class="cmtt-10">\glsxtrLatinT </span></div><hr>
-</p><!--l. 12594--><p class="noindent" >
-A mini-rule that just covers &#8216;T&#8217; but includes the subscript T.
-</p><!--l. 12598--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82081"></a> <span
-class="cmtt-10">\glsxtrLatinX </span></div><hr>
-</p><!--l. 12600--><p class="noindent" >
-A mini-rule that just covers &#8216;X&#8217; but includes the subscript X.
-</p><!--l. 12604--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82082"></a> <span
-class="cmtt-10">\glsxtrLatinEszettSs </span></div><hr>
-</p><!--l. 12606--><p class="noindent" >
-A mini-rule that just covers eszett (&szlig;) and makes long&#x00A0;s (&#x017F;) followed by short &#8216;s&#8217;
-
-
-
-equivalent to &#8216;&szlig;&#8217;. (This is used in the above blocks that treat &#8216;&szlig;&#8217; as &#8216;ss&#8217;.)
-</p><!--l. 12611--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82083"></a> <span
-class="cmtt-10">\glsxtrLatinEszettSz </span></div><hr>
-</p><!--l. 12613--><p class="noindent" >
-A mini-rule that just covers eszett (&szlig;) and makes long&#x00A0;s (&#x017F;) followed by &#8216;z&#8217; equivalent
-to &#8216;&szlig;&#8217;. (This is used in the above blocks that treat &#8216;&szlig;&#8217; as &#8216;sz&#8217;.)
-</p><!--l. 12618--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82084"></a> <span
-class="cmtt-10">\glsxtrLatinEth </span></div><hr>
-</p><!--l. 12620--><p class="noindent" >
-A mini-rule for eth (Ð) so you don&#8217;t need to remember the Unicode values.
-</p><!--l. 12624--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82085"></a> <span
-class="cmtt-10">\glsxtrLatinThorn </span></div><hr>
-</p><!--l. 12626--><p class="noindent" >
-A mini-rule for thorn (þ) so you don&#8217;t need to remember the Unicode values.
-</p><!--l. 12630--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82086"></a> <span
-class="cmtt-10">\glsxtrLatinAELigature </span></div><hr>
-</p><!--l. 12632--><p class="noindent" >
-A mini-rule for ae-ligature (&aelig;) so you don&#8217;t need to remember the Unicode
-values.
-</p><!--l. 12636--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82087"></a> <span
-class="cmtt-10">\glsxtrLatinOELigature </span></div><hr>
-</p><!--l. 12638--><p class="noindent" >
-A mini-rule for oe-ligature (&#339;) so you don&#8217;t need to remember the Unicode
-values.
-</p><!--l. 12642--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82088"></a> <span
-class="cmtt-10">\glsxtrLatinOslash </span></div><hr>
-</p><!--l. 12644--><p class="noindent" >
-A mini-rule for &#8216;Ø&#8217; so you don&#8217;t need to remember the Unicode values.
-</p><!--l. 12648--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82089"></a> <span
-class="cmtt-10">\glsxtrLatinLslash </span></div><hr>
-</p><!--l. 12650--><p class="noindent" >
-A mini-rule for &#8216;&#321;&#8217; so you don&#8217;t need to remember the Unicode values.
-</p><!--l. 12654--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82090"></a> <span
-class="cmtt-10">\glsxtrLatinWynn </span></div><hr>
-</p><!--l. 12656--><p class="noindent" >
-A mini-rule for wynn (&#x01F7;) so you don&#8217;t need to remember the Unicode values.
-</p><!--l. 12660--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82091"></a> <span
-class="cmtt-10">\glsxtrLatinInsularG </span></div><hr>
-</p><!--l. 12662--><p class="noindent" >
-A mini-rule for insular G (&#xA77D;) so you don&#8217;t need to remember the Unicode
-values.
-</p><!--l. 12666--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82092"></a> <span
-class="cmtt-10">\glsxtrLatinSchwa </span></div><hr>
-</p><!--l. 12668--><p class="noindent" >
-A mini-rule that just covers schwa (&#x018F;) but includes the subscript schwa. (Not used in
-any of the provided Latin rule blocks described above.)
-</p><!--l. 12673--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82093"></a> <span
-class="cmtt-10">\glsxtrLatinAA </span></div><hr>
-</p><!--l. 12675--><p class="noindent" >
-A mini-rule for &#8216;Å&#8217; so you don&#8217;t need to remember the Unicode values. (Not used in
-any of the provided Latin rule blocks described above.)
-</p><!--l. 12680--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82094"></a> <span
-class="cmtt-10">\glsxtrMathGreekIrules </span></div><hr>
-</p><!--l. 12682--><p class="noindent" >
-A rule block for mathematical Greek (<span
-class="cmtt-10">\alpha</span><a
- id="dx1-82095"></a>, <span
-class="cmtt-10">\beta</span><a
- id="dx1-82096"></a> etc) and upright Greek
-(<span
-class="cmtt-10">\upalpha</span><a
- id="dx1-82097"></a>, etc, from the <span
-class="cmss-10">upgreek</span><a
- id="dx1-82098"></a> package) characters that includes digamma
-(<span
-class="cmtt-10">\digamma</span><a
- id="dx1-82099"></a> and <span
-class="cmtt-10">\Digamma</span><a
- id="dx1-82100"></a>) between epsilon and zeta. The upright and italic versions
-are gathered together into the same letter group.
-
-
-
-</p><!--l. 12689--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82101"></a> <span
-class="cmtt-10">\glsxtrMathGreekIIrules </span></div><hr>
-</p><!--l. 12691--><p class="noindent" >
-As <span
-class="cmtt-10">\glsxtrMathGreekIrules </span>but doesn&#8217;t include digamma.
-</p><!--l. 12694--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82102"></a> <span
-class="cmtt-10">\glsxtrMathUpGreekIrules </span></div><hr>
-</p><!--l. 12696--><p class="noindent" >
-A rule block for upright Greek (<span
-class="cmtt-10">\upalpha</span><a
- id="dx1-82103"></a>, etc, from the <span
-class="cmss-10">upgreek</span><a
- id="dx1-82104"></a> package)
-characters that includes digamma (<span
-class="cmtt-10">\digamma</span><a
- id="dx1-82105"></a> and <span
-class="cmtt-10">\Digamma</span><a
- id="dx1-82106"></a>) between epsilon and
-zeta.
-</p><!--l. 12702--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82107"></a> <span
-class="cmtt-10">\glsxtrMathUpGreekIIrules </span></div><hr>
-</p><!--l. 12704--><p class="noindent" >
-A rule block for upright Greek (<span
-class="cmtt-10">\upalpha</span><a
- id="dx1-82108"></a>, etc, from the <span
-class="cmss-10">upgreek</span><a
- id="dx1-82109"></a> package) that
-doesn&#8217;t include digamma.
-</p><!--l. 12708--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82110"></a> <span
-class="cmtt-10">\glsxtrMathItalicGreekIrules </span></div><hr>
-</p><!--l. 12710--><p class="noindent" >
-A rule block for mathematical Greek (<span
-class="cmtt-10">\alpha</span><a
- id="dx1-82111"></a>, <span
-class="cmtt-10">\Alpha</span><a
- id="dx1-82112"></a>, etc) characters that includes
-digamma (<span
-class="cmtt-10">\diagamma</span><a
- id="dx1-82113"></a> and <span
-class="cmtt-10">\Digamma</span><a
- id="dx1-82114"></a>) between epsilon and zeta. Note that even
-though the upper case <span
-class="cmtt-10">\Delta </span>etc are actually rendered upright by LaTeX, <a
- id="dx1-82115"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span>&#8217;s</a>
-interpreter treats them as italic to help keep them close to the lower case
-versions.
-</p><!--l. 12718--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82116"></a> <span
-class="cmtt-10">\glsxtrMathItalicGreekIIrules </span></div><hr>
-</p><!--l. 12720--><p class="noindent" >
-A rule block for mathematical Greek (<span
-class="cmtt-10">\alpha</span><a
- id="dx1-82117"></a>, <span
-class="cmtt-10">\Alpha</span><a
- id="dx1-82118"></a>, etc) characters that doesn&#8217;t
-include digamma.
-</p><!--l. 12724--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82119"></a> <span
-class="cmtt-10">\glsxtrMathItalicUpperGreekIrules </span></div><hr>
-</p><!--l. 12726--><p class="noindent" >
-A rule block for upper case mathematical Greek (<span
-class="cmtt-10">\Alpha</span><a
- id="dx1-82120"></a>, <span
-class="cmtt-10">\Beta</span><a
- id="dx1-82121"></a>, etc) characters that
-includes digamma (<span
-class="cmtt-10">\Digamma</span><a
- id="dx1-82122"></a>) between epsilon and zeta.
-</p><!--l. 12731--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82123"></a> <span
-class="cmtt-10">\glsxtrMathItalicUpperGreekIIrules </span></div><hr>
-</p><!--l. 12733--><p class="noindent" >
-A rule block for upper case mathematical Greek (<span
-class="cmtt-10">\Alpha</span><a
- id="dx1-82124"></a>, <span
-class="cmtt-10">\Beta</span><a
- id="dx1-82125"></a>, etc) characters that
-doesn&#8217;t include digamma.
-</p><!--l. 12737--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82126"></a> <span
-class="cmtt-10">\glsxtrMathItalicLowerGreekIrules </span></div><hr>
-</p><!--l. 12739--><p class="noindent" >
-A rule block for lower case mathematical Greek (<span
-class="cmtt-10">\alpha</span><a
- id="dx1-82127"></a>, <span
-class="cmtt-10">\beta</span><a
- id="dx1-82128"></a>, etc) characters that
-includes digamma (<span
-class="cmtt-10">\digamma</span><a
- id="dx1-82129"></a>) between epsilon and zeta.
-</p><!--l. 12744--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82130"></a> <span
-class="cmtt-10">\glsxtrMathItalicLowerGreekIIrules </span></div><hr>
-</p><!--l. 12746--><p class="noindent" >
-A rule block for lower case mathematical Greek (<span
-class="cmtt-10">\alpha</span><a
- id="dx1-82131"></a>, <span
-class="cmtt-10">\beta</span><a
- id="dx1-82132"></a>, etc) characters that
-doesn&#8217;t include digamma.
-</p><!--l. 12750--><p class="indent" > Additionally, there are commands in the form <span
-class="cmtt-10">\glsxtrUpAlpha</span>, <span
-class="cmtt-10">\glsxtrUpBeta</span>
-etc and <span
-class="cmtt-10">\glsxtrMathItalicAlpha</span>, <span
-class="cmtt-10">\glsxtrMathItalicBeta </span>etc that just cover the
-upper and lower case forms of a special Greek character (<span
-class="cmtt-10">\Upalpha</span>, <span
-class="cmtt-10">\upalpha </span>etc
-and <span
-class="cmtt-10">\Alpha</span>, <span
-class="cmtt-10">\alpha </span>etc) as well as the following:
-</p><!--l. 12757--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82133"></a> <span
-class="cmtt-10">\glsxtrMathItalicPartial </span></div><hr>
-</p><!--l. 12759--><p class="noindent" >
-The partial derivative symbol (<span
-class="cmmi-10">&#x2202;</span>).
-
-
-
-</p><!--l. 12762--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-82134"></a> <span
-class="cmtt-10">\glsxtrMathItalicNabla </span></div><hr>
-</p><!--l. 12764--><p class="noindent" >
-The nabla symbol (<span
-class="cmsy-10">&#x2207;</span>).
-</p><!--l. 12768--><p class="noindent" >
-</p>
-<!--l. 12768--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">10.4 </span> <a
- id="sec:bib2glssupplementarycommands"></a>Supplementary Commands</h3>
-<!--l. 12771--><p class="noindent" >These commands are provided by <span
-class="cmss-10">glossaries-extra </span>for use with <a
- id="dx1-83001"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a>.
-</p><!--l. 12774--><p class="indent" > The information provided with <span
-class="cmtt-10">\GlsXtrLoadResources </span>is written to the <span
-class="cmtt-10">.aux </span>file
-using </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\protected@write\@auxout</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">\glsxtrresourceinit</span><span
-class="cmsy-10">}</span><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">information</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div>
-</div> where &#x27E8;<span
-class="cmti-10">information</span>&#x27E9; is the information to pass to <a
- id="dx1-83002"></a><span
-class="cmtt-10">bib2gls</span>. The command in the
-second argument
-<!--l. 12781--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-83003"></a> <span
-class="cmtt-10">\glsxtrresourceinit </span></div><hr>
-</p><!--l. 12783--><p class="noindent" >
-may be used to temporarily redefine commands before the information is written to
-the file. This does nothing by default, but may be redefined to allow the use of short
-commands for convenience. For example, with:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-283">
-\renewcommand{\glsxtrresourceinit}{\let\u\glshex}
-</pre>
-<!--l. 12790--><p class="nopar" > you can just use, for example, <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\u</span><span
-class="cmtt-10">&#x00A0;E6</span></span></span> instead of <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\string\uE6</span></span></span> in the custom rule.
-This redefinition of <span
-class="cmtt-10">\u </span>is scoped so its original definition is restored after the write
-operation.
-</p><!--l. 12795--><p class="indent" > If you have multiple resource commands and you want a default set of options you
-can supply them in the definition of:
-</p><!--l. 12797--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-83004"></a> <span
-class="cmtt-10">\GlsXtrDefaultResourceOptions </span></div><hr>
-</p><!--l. 12799--><p class="noindent" >
-For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-284">
-\renewcommand{\GlsXtrDefaultResourceOptions}{selection=all}
-</pre>
-<!--l. 12803--><p class="nopar" > This should be done before the resource commands.
-</p><!--l. 12806--><p class="indent" > It&#8217;s possible to specify label prefixes. For example, modifying the earlier
-example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-285">
-\documentclass{article}
-\usepackage[record,style=indexgroup]{glossaries-extra}
-\setabbreviationstyle{long-short-desc}
-\GlsXtrLoadResources
-&#x00A0;[src={abbrvs},sort={letter-nocase},type=main,
-&#x00A0;&#x00A0;label-prefix={abr.},
-&#x00A0;&#x00A0;group={Abbreviations}]
-\GlsXtrLoadResources
-&#x00A0;[src={symbols},sort={use},type=main,
-&#x00A0;&#x00A0;label-prefix={sym.},
-&#x00A0;&#x00A0;group={Symbols}]
-\GlsXtrLoadResources[src={terms},sort={en-GB},type=main
-&#x00A0;&#x00A0;label-prefix={trm.}]
-\begin{document}
-\gls{trm.bird}
-\gls{abr.shtml}
-\gls{sym.M}
-\printunsrtglossaries
-\end{document}
-</pre>
-<!--l. 12837--><p class="nopar" > If you do something like this, you may find it more convenient to define custom
-commands that set the prefix. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-286">
-\newcommand*{\sym}[2][]{\gls[#1]{sym.#2}}
-</pre>
-<!--l. 12842--><p class="nopar" > The problem with this is that the custom command <span
-class="cmtt-10">\sym </span>doesn&#8217;t allow for modifiers
-(such as <span
-class="cmtt-10">\gls* </span>or <span
-class="cmtt-10">\gls+</span>). Instead you can use:
-</p><!--l. 12846--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-83005"></a> <span
-class="cmtt-10">\glsxtrnewgls[</span>&#x27E8;<span
-class="cmitt-10">default options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">cs</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 12848--><p class="noindent" >
-which defines the command &#x27E8;<span
-class="cmti-10">cs</span>&#x27E9; that behaves like </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\gls</span>&#x27E8;<span
-class="cmitt-10">modifier</span>&#x27E9;<span
-class="cmtt-10">[</span>&#x27E8;<span
-class="cmitt-10">default</span><span
-class="cmitt-10">&#x00A0;options</span>&#x27E9;<span
-class="cmtt-10">,</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]</span><span
-class="cmsy-10">{</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmsy-10">}</span><span
-class="cmtt-10">[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">]</span>
-</div>
-</div> For example:
-
-
-
- <pre class="verbatim" id="verbatim-287">
-\glsxtrnewgls{sym.}{\sym}
-</pre>
-<!--l. 12856--><p class="nopar" > or (to default to no hyperlinks)
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-288">
-\glsxtrnewgls[hyper=false]{sym.}{\sym}
-</pre>
-<!--l. 12860--><p class="nopar" > now you can use <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\sym+{M}</span></span></span> to behave like <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls+{sym.M}</span></span></span>.
-</p><!--l. 12863--><p class="indent" > If you also want the plural and first letter upper case versions you can
-use
-</p><!--l. 12865--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-83006"></a> <span
-class="cmtt-10">\glsxtrnewglslike[</span>&#x27E8;<span
-class="cmitt-10">default options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">\gls-like cs</span>&#x27E9;<span
-class="cmtt-10">}</span>
-<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">\glspl-like cs</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">\Gls-like cs</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">\Glspl-like cs</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 12868--><p class="noindent" >
-For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-289">
-\glsxtrnewglslike[hyper=false]{idx.}{\idx}{\idxpl}{\Idx}{\Idxpl}
-</pre>
-<!--l. 12872--><p class="nopar" > For the all caps versions:
-</p><!--l. 12874--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-83007"></a> <span
-class="cmtt-10">\glsxtrnewGLSlike[</span>&#x27E8;<span
-class="cmitt-10">default options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">\GLS-like cs</span>&#x27E9;<span
-class="cmtt-10">}</span>
-<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">\GLSpl-like cs</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 12877--><p class="noindent" >
-For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-290">
-\glsxtrnewGLSlike[hyper=false]{idx.}{\IDX}{\IDXpl}
-</pre>
-<!--l. 12881--><p class="nopar" >
-</p><!--l. 12883--><p class="indent" > There&#8217;s an analogous command for <span
-class="cmtt-10">\rgls</span>:
-</p><!--l. 12884--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-83008"></a> <span
-class="cmtt-10">\glsxtrnewrgls[</span>&#x27E8;<span
-class="cmitt-10">default options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">cs</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 12886--><p class="noindent" >
-and for <span
-class="cmtt-10">\rgls</span>, <span
-class="cmtt-10">\rglspl</span>, <span
-class="cmtt-10">\rGls </span>and <span
-class="cmtt-10">\rGlspl</span>:
-</p><!--l. 12889--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-83009"></a> <span
-class="cmtt-10">\glsxtrnewrglslike[</span>&#x27E8;<span
-class="cmitt-10">default options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">\rgls-like cs</span>&#x27E9;<span
-class="cmtt-10">}</span>
-<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">\rglspl-like cs</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">\rGls-like cs</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">\rGlspl-like cs</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 12893--><p class="noindent" >
-and for the all caps:
-</p><!--l. 12895--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-83010"></a> <span
-class="cmtt-10">\glsxtrnewrGLSlike[</span>&#x27E8;<span
-class="cmitt-10">default options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">\rGLS-like cs</span>&#x27E9;<span
-class="cmtt-10">}</span>
-<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">\rGLSpl-like cs</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 12898--><p class="noindent" >
-</p><!--l. 12900--><p class="indent" > If you provide your own custom command with just <span
-class="cmtt-10">\newcommand </span>that
-has syntax that starts with <span
-class="cmtt-10">[</span>&#x27E8;<span
-class="cmti-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>, then you can notify <a
- id="dx1-83011"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a>
-using:
-</p><!--l. 12903--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-83012"></a> <span
-class="cmtt-10">\glsxtridentifyglslike{</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">command</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 12905--><p class="noindent" >
-This writes information to the <span
-class="cmtt-10">.aux </span>file so that <a
- id="dx1-83013"></a><span
-class="cmtt-10">bib2gls </span>can search for the given
-command when looking for dependencies.
-</p><!--l. 12910--><p class="indent" > Another possibility is to set up known label prefixes, with each one identified
-by:
-</p><!--l. 12912--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-83014"></a> <span
-class="cmtt-10">\glsxtraddlabelprefix{</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 12914--><p class="noindent" >
-These should be listed in order of precedence. Since no entries are defined on the first
-LaTeX&#x00A0;run, the final prefix should be the fallback. You can prepend a prefix to the
-list using:
-</p><!--l. 12918--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-83015"></a> <span
-class="cmtt-10">\glsxtrprependlabelprefix{</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 12920--><p class="noindent" >
-which gives it the highest order of precedence.
-</p><!--l. 12923--><p class="indent" > The &#x27E8;<span
-class="cmti-10">prefix</span>&#x27E9; argument may be empty. You can clear the list with:
-</p><!--l. 12925--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-83016"></a> <span
-class="cmtt-10">\glsxtrclearlabelprefixes </span></div><hr>
-</p><!--l. 12927--><p class="noindent" >
-</p><!--l. 12929--><p class="indent" > You can test if a prefix is already in the list with:
-</p><!--l. 12930--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-83017"></a> <span
-class="cmtt-10">\glsxtrifinlabelprefixlist{</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 12932--><p class="noindent" >
-In general it&#8217;s best to avoid adding multiple instances of the same prefix, so you can
-check with this command before adding a prefix to the list. However, it can be useful
-
-
-
-to repeat a prefix at the end of the list so that it can be used as a fallback for entries
-that haven&#8217;t yet been defined.
-</p><!--l. 12939--><p class="indent" > With the list of possible prefixes set up (including an empty prefix if necessary),
-you can use:
-</p><!--l. 12941--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-83018"></a> <span
-class="cmtt-10">\dgls[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 12943--><p class="noindent" >
-which behaves like </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\gls[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]</span><span
-class="cmsy-10">{</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmsy-10">}</span><span
-class="cmtt-10">[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">]</span>
-</div>
-</div> where &#x27E8;<span
-class="cmti-10">prefix</span>&#x27E9; is the first prefix in the list such that &#x27E8;<span
-class="cmti-10">prefix</span>&#x27E9;&#x27E8;<span
-class="cmti-10">label</span>&#x27E9; matches a defined
-entry (or the last entry in the prefix list if none match).
-<!--l. 12952--><p class="indent" > There are also analogous commands for the plural and case-changing
-versions:
-</p><!--l. 12954--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-83019"></a> <span
-class="cmtt-10">\dglspl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 12956--><p class="noindent" >
-(uses <span
-class="cmtt-10">\glspl</span>),
-</p><!--l. 12958--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-83020"></a> <span
-class="cmtt-10">\dGls[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 12960--><p class="noindent" >
-(uses <span
-class="cmtt-10">\Gls</span>),
-</p><!--l. 12962--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-83021"></a> <span
-class="cmtt-10">\dGlspl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 12964--><p class="noindent" >
-(uses <span
-class="cmtt-10">\Glspl</span>),
-</p><!--l. 12966--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-83022"></a> <span
-class="cmtt-10">\dGLS[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 12968--><p class="noindent" >
-(uses <span
-class="cmtt-10">\GLS</span>),
-</p><!--l. 12970--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-83023"></a> <span
-class="cmtt-10">\dGLSpl[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 12972--><p class="noindent" >
-(uses <span
-class="cmtt-10">\GLSpl</span>),
-</p><!--l. 12974--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-83024"></a> <span
-class="cmtt-10">\dglslink[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 12976--><p class="noindent" >
-(uses <span
-class="cmtt-10">\glslink</span>),
-</p><!--l. 12978--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-83025"></a> <span
-class="cmtt-10">\dglsdisp[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 12980--><p class="noindent" >
-(uses <span
-class="cmtt-10">\glsdisp</span>).
-</p><!--l. 12983--><p class="indent" > These commands are essentially provided for a mixture of single and dual entries.
-Suppose the file <span
-class="cmtt-10">entries.bib </span>contains:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-291">
-@index{duck}
-@dualindexabbreviation{svm,
-&#x00A0;&#x00A0;short={SVM},
-&#x00A0;&#x00A0;long={support&#x00A0;vector&#x00A0;machine}
+</pre> This uses <a id="wrglossary.11150"></a><a href="#glo:glstreesubitem"><code class="csfmt">\glstreesubitem</code></a> and <a id="wrglossary.11151"></a><a href="#glo:glstreesubsubitem"><code class="csfmt">\glstreesubsubitem</code></a> to indent the cross-reference according to the next level down, so the cross-reference for a top-level entry is aligned with the sub-entries, and a level 1 entry has its cross-reference aligned with sub-sub-entries. In the event that a level 2 entry has a cross-reference, this is indented a bit further (but it won’t be aligned with any deeper level as the <a id="wrglossary.11152"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style only supports a maximum of two sub-levels).<p>
+The <a id="wrglossary.11153"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style uses group headings. (If you use <a id="wrglossary.11154"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> remember to invoke it with the <a id="wrglossary.11155"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> or <a id="wrglossary.11156"></a><a href="#glo:switch.group"><span class="shortargfmt">-g</span></a> switch, see §<a href="#sec:printunsrtgroups">8.4.1</a>.) The heading will use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11157"></a><code class="code"><dfn id="glo:glsxtrbookindexbookmark"><code class="csfmt">\glsxtrbookindexbookmark</code></dfn>{<span class="meta">〈<em class="metainner">group-title</em>〉</span>}{<span class="meta">〈<em class="metainner">bookmark-name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If <a id="wrglossary.11158"></a><a href="#glo:pdfbookmark"><code class="csfmt">\pdfbookmark</code></a> has been defined, this will use that command to bookmark the group title. If <a id="wrglossary.11159"></a><a href="#glo:opt.section"><span class="styoptfmt">section</span></a><span class="optfmt">=chapter</span> is set (default if chapters are defined) then this uses level 1 otherwise it uses level 2. You can redefine this command if this isn’t appropriate. If <a id="wrglossary.11160"></a><a href="#glo:pdfbookmark"><code class="csfmt">\pdfbookmark</code></a> hasn’t been defined, this command does nothing.<p>
+The group heading is formatted according to: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11161"></a><code class="code"><dfn id="glo:glsxtrbookindexformatheader"><code class="csfmt">\glsxtrbookindexformatheader</code></dfn>{<span class="meta">〈<em class="metainner">group-title</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which is defined as: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.11162"></a><a href="#glo:glsxtrbookindexformatheader"><code class="csfmt">\glsxtrbookindexformatheader</code></a>}[1]{<span class="comment">% </span>
+ <code class="cmd">\par</code>{<code class="cmd">\centering</code><a id="wrglossary.11163"></a><a href="#glo:glstreegroupheaderfmt"><code class="csfmt">\glstreegroupheaderfmt</code></a>{#1}<code class="cmd">\par</code>}<span class="comment">% </span>
}
-@dualindexsymbol{pi,
-&#x00A0;&#x00A0;symbol={\ensuremath{\pi}},
-&#x00A0;&#x00A0;description={ratio&#x00A0;of&#x00A0;a&#x00A0;circle's&#x00A0;circumference&#x00A0;to&#x00A0;its
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;diameter}
+</pre> where <a id="wrglossary.11164"></a><a href="#glo:glstreegroupheaderfmt"><code class="csfmt">\glstreegroupheaderfmt</code></a> is provided by the <a id="wrglossary.11165"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a> package, which is automatically loaded. Note that the entry names aren’t encapsulated with <a id="wrglossary.11166"></a><a href="#glo:glstreenamefmt"><code class="csfmt">\glstreenamefmt</code></a>.<p>
+The skip after a <a id="wrglossary.11167"></a><a href="#glo:idx.group">group</a> header is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11168"></a><code class="code"><dfn id="glo:glsxtrbookindexpregroupskip"><code class="csfmt">\glsxtrbookindexpregroupskip</code></dfn>{<span class="meta">〈<em class="metainner">skip</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The argument is the skip that would normally be inserted if there wasn’t a group header.<p>
+The <a id="wrglossary.11169"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> package provides some supplementary commands that aren’t used by default, but may be used when adjusting the style. These commands should only be used within one of the <code class="csfmt">\print…glossary</code> commands. (That is, they should only be used in <a id="wrglossary.11170"></a><a href="#glo:idx.glossarystyle">glossary styles</a> or in hooks.) <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11171"></a><code class="code"><dfn id="glo:glsxtrbookindexmarkentry"><code class="csfmt">\glsxtrbookindexmarkentry</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This writes information to the <a id="wrglossary.11172"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file that can be read on the next run to obtain the first and last entry on each page of the glossary.<p>
+You can display the first entry associated with the current page using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11173"></a><code class="code"><dfn id="glo:glsxtrbookindexfirstmark"><code class="csfmt">\glsxtrbookindexfirstmark</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ and the last entry associated with the current page using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11174"></a><code class="code"><dfn id="glo:glsxtrbookindexlastmark"><code class="csfmt">\glsxtrbookindexlastmark</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ These do nothing if there are no entries marked on the current page (or if the document build isn’t up to date).<p>
+The entry is formatted using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11175"></a><code class="code"><dfn id="glo:glsxtrbookindexfirstmarkfmt"><code class="csfmt">\glsxtrbookindexfirstmarkfmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ for the first instance and <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11176"></a><code class="code"><dfn id="glo:glsxtrbookindexlastmarkfmt"><code class="csfmt">\glsxtrbookindexlastmarkfmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ for the last.<p>
+These commands are designed for use in page headers or footers where the page number is stable. For example, <a id="wrglossary.11177"></a><a href="#glo:glsxtrbookindexname"><code class="csfmt">\glsxtrbookindexname</code></a> can be redefined to mark the current entry: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.11178"></a><a href="#glo:glsxtrbookindexname"><code class="csfmt">\glsxtrbookindexname</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.11179"></a><a href="#glo:glsxtrbookindexmarkentry"><code class="csfmt">\glsxtrbookindexmarkentry</code></a>{#1}<span class="comment">% </span>
+ <a id="wrglossary.11180"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a>{#1}<span class="comment">% </span>
}
-</pre>
-<!--l. 12996--><p class="nopar" > and suppose the document code is:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-292">
-\documentclass{article}
-\usepackage{hyperref}
-\usepackage[record,abbreviations,symbols]{glossaries-extra}
-\newcommand{\bibglsnewdualindexsymbolsecondary}[5]{%
-&#x00A0;\longnewglossaryentry*{#1}{name={#3},category={symbol},
-&#x00A0;&#x00A0;&#x00A0;type={symbols},symbol={#4},#2}{#5}%
+</pre> If you only want to mark the top-level entries, remember to redefine <a id="wrglossary.11181"></a><a href="#glo:glsxtrbookindexsubname"><code class="csfmt">\glsxtrbookindexsubname</code></a> as it defaults to <a id="wrglossary.11182"></a><a href="#glo:glsxtrbookindexname"><code class="csfmt">\glsxtrbookindexname</code></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.11183"></a><a href="#glo:renewcommand"><code class="csfmt">\renewcommand</code></a>{<a id="wrglossary.11184"></a><a href="#glo:glsxtrbookindexsubname"><code class="csfmt">\glsxtrbookindexsubname</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.11185"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a>{#1}<span class="comment">% </span>
}
-\GlsXtrLoadResources[src=entries]
-\begin{document}
-First&#x00A0;use:&#x00A0;\gls{duck},&#x00A0;\gls{svm},&#x00A0;\gls{pi}.
-Next&#x00A0;use:&#x00A0;\gls{duck},&#x00A0;\gls{svm},&#x00A0;\gls{pi}.
-\printunsrtglossaries
-\end{document}
-</pre>
-<!--l. 13015--><p class="nopar" > This uses the default empty primary prefix and <span
-class="cmtt-10">dual.</span>&#x00A0;for the dual prefix, so
-<span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls{svm}</span></span></span> is referencing the primary entry, which is (essentially) an <span
-class="cmtt-10">@index </span>type
-not an abbreviation. It therefore doesn&#8217;t follow the abbreviation style, and
-it also hyperlinks to the index not to the list of abbreviations. Similarly
-for <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls{pi}</span></span></span>, which references the primary <span
-class="cmtt-10">@index </span>entry rather than the
-symbol.
-</p><!--l. 13024--><p class="indent" > What&#8217;s really needed is:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-293">
-\gls{duck},&#x00A0;\gls{dual.svm},&#x00A0;\gls{dual.pi}.
-</pre>
-<!--l. 13027--><p class="nopar" > or with
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-294">
-\GlsXtrLoadResources[src=entries,
-&#x00A0;label-prefix={idx.},
-&#x00A0;dual-prefix={}
-]
-</pre>
-<!--l. 13034--><p class="nopar" > then only the entries without a dual need a prefix:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-295">
-\gls{idx.duck},&#x00A0;\gls{svm},&#x00A0;\gls{pi}.
-</pre>
-<!--l. 13038--><p class="nopar" > Using <span
-class="cmtt-10">\glsxtrnewglslike</span>, as earlier, this can be simplified to:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-296">
-\idx{duck},&#x00A0;\gls{svm},&#x00A0;\gls{pi}.
-</pre>
-<!--l. 13042--><p class="nopar" > but this requires remembering which terms have duals.
-</p><!--l. 13045--><p class="indent" > An alternative is to use <span
-class="cmtt-10">\dgls </span>instead:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-297">
-\documentclass{article}
-\usepackage{hyperref}
-\usepackage[record,abbreviations,symbols]{glossaries-extra}
-\newcommand{\bibglsnewdualindexsymbolsecondary}[5]{%
-&#x00A0;\longnewglossaryentry*{#1}{name={#3},category={symbol},
-&#x00A0;&#x00A0;&#x00A0;type={symbols},symbol={#4},#2}{#5}%
+</pre><p>
+Then if you’re using <a id="wrglossary.11186"></a><a href="#glo:pkg.fancyhdr"><span class="styfmt">fancyhdr</span></a> you can set the page style to show the first and last entry for the current page with: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\pagestyle</code>{fancy}<span class="comment">% </span>
+<code class="cmd">\lhead</code>{<a id="wrglossary.11187"></a><a href="#glo:thepage"><code class="csfmt">\thepage</code></a>}<span class="comment">% </span>
+<code class="cmd">\lfoot</code>{<a id="wrglossary.11188"></a><a href="#glo:glsxtrbookindexfirstmark"><code class="csfmt">\glsxtrbookindexfirstmark</code></a>}<span class="comment">% </span>
+<code class="cmd">\cfoot</code>{}<span class="comment">% </span>
+<code class="cmd">\rfoot</code>{<a id="wrglossary.11189"></a><a href="#glo:glsxtrbookindexlastmark"><code class="csfmt">\glsxtrbookindexlastmark</code></a>}<span class="comment">% </span>
+</pre> <a id="wrglossary.11190"></a><a id="wrglossary.11191"></a><p>
+
+</section><!-- end of section sec:bookindex -->
+
+<section id="sec:longextra"><!-- start of section sec:longextra --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->8.7.2. <span class="styfmt">glossary-longextra</span> package<div class="labellink"><a href="#sec:longextra">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<a id="wrglossary.11192"></a>The <a id="wrglossary.11193"></a><dfn id="glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></dfn> package provides additional <a id="wrglossary.11194"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>-like styles similar to those provided by <a id="wrglossary.11195"></a><a href="#glo:pkg.glossary-longbooktabs"><span class="styfmt">glossary-longbooktabs</span></a> (which is automatically loaded). These don’t support <a id="wrglossary.11196"></a><a href="#glo:dual.hierarchicallevel">hierarchical levels</a> except for homographs (level 1 entries with the same name as their parent).<p>
+By default, these styles use the <a id="wrglossary.11197"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> environment, but if you know that your <a id="wrglossary.11198"></a><a href="#glo:dual.glossary">glossary</a> won’t span more than a page and you need to use it in a context that’s incompatible with <a id="wrglossary.11199"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>, you can instead setup these styles to use <a id="wrglossary.11200"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a> instead. In order to do this you must use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11201"></a><code class="code"><dfn id="glo:GlsLongExtraUseTabulartrue"><code class="csfmt">\GlsLongExtraUseTabulartrue</code></dfn></code></div><!-- end of pinnedbox -->
+ <span style="font-style: italic; font-variant: normal; ">before the style is set</span>. If you later want to switch back to using <a id="wrglossary.11202"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> for another <a id="wrglossary.11203"></a><a href="#glo:dual.glossary">glossary</a>, use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11204"></a><code class="code"><dfn id="glo:GlsLongExtraUseTabularfalse"><code class="csfmt">\GlsLongExtraUseTabularfalse</code></dfn></code></div><!-- end of pinnedbox -->
+ (or scope <a id="wrglossary.11205"></a><a href="#glo:GlsLongExtraUseTabulartrue"><code class="csfmt">\GlsLongExtraUseTabulartrue</code></a>). Again, the style must be set after this change to the conditional is implemented. You can test this setting with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11206"></a><code class="code"><dfn id="glo:ifGlsLongExtraUseTabular"><code class="csfmt">\ifGlsLongExtraUseTabular</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\iffalse</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+<p>
+For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.11207"></a><a href="#glo:GlsLongExtraUseTabulartrue"><code class="csfmt">\GlsLongExtraUseTabulartrue</code></a>
+<a id="wrglossary.11208"></a><a href="#glo:setglossarystyle"><code class="csfmt">\setglossarystyle</code></a>{<a id="wrglossary.11209"></a><a href="#glo:opt.glostyle.long-name-desc"><span class="glostylefmt">long-name-desc</span></a>}
+</pre> or <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.11210"></a><a href="#glo:GlsLongExtraUseTabulartrue"><code class="csfmt">\GlsLongExtraUseTabulartrue</code></a>
+<a id="wrglossary.11211"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<a id="wrglossary.11212"></a><a href="#glo:opt.printgloss.style"><span class="csoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.11213"></a><a href="#glo:opt.glostyle.long-name-desc"><span class="glostylefmt">long-name-desc</span></a></span>]
+</pre> If you switch to <a id="wrglossary.11214"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>, the default vertical alignment is obtained from: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11215"></a><code class="code"><dfn id="glo:glslongextraTabularVAlign"><code class="csfmt">\glslongextraTabularVAlign</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>c</span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This should expand to one of: <code class="code">c</code> (centred), <code class="code">t</code> (top) or <code class="code">b</code> (bottom). The default is <code class="code">c</code>.<p>
+For either <a id="wrglossary.11216"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a> or <a id="wrglossary.11217"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>, the column titles are formatted according to: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11218"></a><code class="code"><dfn id="glo:glslongextraHeaderFmt"><code class="csfmt">\glslongextraHeaderFmt</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which simply does <code class="code"><span class="cmdfmt">\textbf</span>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code> by default. As with the <a id="wrglossary.11219"></a><a href="#glo:opt.glostyle.long"><span class="glostylefmt">long</span></a>-like styles, the header text for the columns are given by the language-sensitive commands: <a id="wrglossary.11220"></a><a href="#glo:entryname"><code class="csfmt">\entryname</code></a>, <a id="wrglossary.11221"></a><a href="#glo:descriptionname"><code class="csfmt">\descriptionname</code></a>, <a id="wrglossary.11222"></a><a href="#glo:symbolname"><code class="csfmt">\symbolname</code></a> and <a id="wrglossary.11223"></a><a href="#glo:pagelistname"><code class="csfmt">\pagelistname</code></a>.<p>
+Most styles show the <a id="wrglossary.11224"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> which, as with other predefined styles, also includes the entry item number (if <a id="wrglossary.11225"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> is on) and hypertarget anchor. These are all performed for top-level entries with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11226"></a><code class="code"><dfn id="glo:glslongextraNameFmt"><code class="csfmt">\glslongextraNameFmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.11227"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a>, so it supports the <a id="wrglossary.11228"></a><a href="#glo:dual.postnamehook">post-name hook</a> and associated attributes. Child entries are displayed with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11229"></a><code class="code"><dfn id="glo:glslongextraSubNameFmt"><code class="csfmt">\glslongextraSubNameFmt</code></dfn>{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This includes the sub-entry item number (if <a id="wrglossary.11230"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> is on) and the hypertarget anchor. The actual name isn’t shown by default.<p>
+The horizontal alignment for the name column is obtained with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11231"></a><code class="code"><dfn id="glo:glslongextraNameAlign"><code class="csfmt">\glslongextraNameAlign</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>l</span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This expands to <code class="code">l</code> by default.<p>
+For styles that show the <a id="wrglossary.11232"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a>, that’s formatted with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11233"></a><code class="code"><dfn id="glo:glslongextraDescFmt"><code class="csfmt">\glslongextraDescFmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ for top-level entries, which uses <a id="wrglossary.11234"></a><a href="#glo:glossentrydesc"><code class="csfmt">\glossentrydesc</code></a> and the <a id="wrglossary.11235"></a><a href="#glo:dual.postdeschook">post-description hook</a>, and <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11236"></a><code class="code"><dfn id="glo:glslongextraSubDescFmt"><code class="csfmt">\glslongextraSubDescFmt</code></dfn>{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ for child entries (which just uses <a id="wrglossary.11237"></a><a href="#glo:glslongextraDescFmt"><code class="csfmt">\glslongextraDescFmt</code></a>).<p>
+The horizontal alignment for the description column is obtained with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11238"></a><code class="code"><dfn id="glo:glslongextraDescAlign"><code class="csfmt">\glslongextraDescAlign</code></dfn></code></div><!-- end of pinnedbox -->
+ This expands to <code class="code">&gt;{<span class="cmdfmt">\raggedright</span>}p{<a id="wrglossary.11239"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a>}</code> by default. This means ragged-right paragraph style with width given by <a id="wrglossary.11240"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a>. (See the documentation for the <a id="wrglossary.11241"></a><a href="#glo:pkg.array"><span class="styfmt">array</span></a> package for information about this alignment syntax.) If a widest name has been set, <a id="wrglossary.11242"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a> will be calculated according to the best fit for the given style.<p>
+If you are using <a id="wrglossary.11243"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, you may be able to use the <a id="wrglossary.11244"></a><a href="#glo:opt.resource.set-widest"><span class="csoptfmt">set-widest</span></a> option, otherwise to set the widest name, use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11245"></a><code class="code"><dfn id="glo:glslongextraSetWidest"><code class="csfmt">\glslongextraSetWidest</code></dfn>{<span class="meta">〈<em class="metainner">widest-name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If you have already used <a id="wrglossary.11246"></a><a href="#glo:glssetwidest"><code class="csfmt">\glssetwidest</code></a> provided with the <a id="wrglossary.11247"></a><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a> style, the default widest name will be obtained from that, but note that only level 0 is supported for the <a id="wrglossary.11248"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> styles.<p>
+You can update the widest name with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11249"></a><code class="code"><dfn id="glo:glslongextraUpdateWidest"><code class="csfmt">\glslongextraUpdateWidest</code></dfn>{<span class="meta">〈<em class="metainner">name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.11250"></a><a href="#glo:glslongextraSetWidest"><code class="csfmt">\glslongextraSetWidest</code></a> but will only set the new value if it’s wider than the current widest name.<p>
+Although these styles don’t support hierarchy, the following is provided for child entries: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11251"></a><code class="code"><dfn id="glo:glslongextraUpdateWidestChild"><code class="csfmt">\glslongextraUpdateWidestChild</code></dfn>{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does nothing by default. If <a id="wrglossary.11252"></a><a href="#glo:glslongextraSubNameFmt"><code class="csfmt">\glslongextraSubNameFmt</code></a> is redefined to show the child name, then the above command will need to be redefined to use <a id="wrglossary.11253"></a><a href="#glo:glslongextraUpdateWidest"><code class="csfmt">\glslongextraUpdateWidest</code></a>.<p>
+For styles that show the <a id="wrglossary.11254"></a><a href="#glo:dual.locationlist">location list</a>, that’s formatted with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11255"></a><code class="code"><dfn id="glo:glslongextraLocationFmt"><code class="csfmt">\glslongextraLocationFmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ for top-level entries. Child <a id="wrglossary.11256"></a><a href="#glo:dual.locationlist">location lists</a> are formatted with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11257"></a><code class="code"><dfn id="glo:glslongextraSubLocationFmt"><code class="csfmt">\glslongextraSubLocationFmt</code></dfn>{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Both of these simply do the <span class="meta">〈<em class="metainner">location list</em>〉</span> argument.<p>
+The horizontal alignment for the <a id="wrglossary.11258"></a><a href="#glo:dual.locationlist">location list</a> column is obtained with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11259"></a><code class="code"><dfn id="glo:glslongextraLocationAlign"><code class="csfmt">\glslongextraLocationAlign</code></dfn></code></div><!-- end of pinnedbox -->
+ This expands to <code class="code">&gt;{<span class="cmdfmt">\raggedright</span>}p{<a id="wrglossary.11260"></a><a href="#glo:glspagelistwidth"><code class="csfmt">\glspagelistwidth</code></a>}</code> by default. This means ragged-right paragraph style with width given by <a id="wrglossary.11261"></a><a href="#glo:glspagelistwidth"><code class="csfmt">\glspagelistwidth</code></a>.<p>
+For styles that show the <a id="wrglossary.11262"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> (in addition to the <a id="wrglossary.11263"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>), that’s formatted with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11264"></a><code class="code"><dfn id="glo:glslongextraSymbolFmt"><code class="csfmt">\glslongextraSymbolFmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ for top-level entries. This simply uses <a id="wrglossary.11265"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a>. Child entries use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11266"></a><code class="code"><dfn id="glo:glslongextraSubSymbolFmt"><code class="csfmt">\glslongextraSubSymbolFmt</code></dfn>{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which uses <a id="wrglossary.11267"></a><a href="#glo:glslongextraSymbolFmt"><code class="csfmt">\glslongextraSymbolFmt</code></a>.<p>
+The horizontal alignment for the symbol column (except for the <a id="wrglossary.11268"></a><a href="#glo:opt.glostyle.long-sym-desc"><span class="glostylefmt">long-sym-desc</span></a> and <a id="wrglossary.11269"></a><a href="#glo:opt.glostyle.long-desc-sym"><span class="glostylefmt">long-desc-sym</span></a> styles) is obtained with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11270"></a><code class="code"><dfn id="glo:glslongextraSymbolAlign"><code class="csfmt">\glslongextraSymbolAlign</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>c</span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This expands to <code class="code">c</code> by default.<p>
+Top-level <a id="wrglossary.11271"></a><a href="#glo:idx.group">group</a> headings are formatted with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11272"></a><code class="code"><dfn id="glo:glslongextraGroupHeading"><code class="csfmt">\glslongextraGroupHeading</code></dfn>{<span class="meta">〈<em class="metainner">number columns</em>〉</span>}{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The first argument is the total number of columns in the table. For example, 2 for the <a id="wrglossary.11273"></a><a href="#glo:opt.glostyle.long-name-desc"><span class="glostylefmt">long-name-desc</span></a> style or 3 for the <a id="wrglossary.11274"></a><a href="#glo:opt.glostyle.long-name-sym-desc"><span class="glostylefmt">long-name-sym-desc</span></a> style. The second argument is the <a id="wrglossary.11275"></a><a href="#glo:idx.group">group’s</a> label (not the title). This command does nothing by default. (If you are using <a id="wrglossary.11276"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, remember that you need to use the <a id="wrglossary.11277"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> or <a id="wrglossary.11278"></a><a href="#glo:switch.group"><span class="shortargfmt">-g</span></a> switch to support <a id="wrglossary.11279"></a><a href="#glo:idx.group">groups</a>.)<p>
+Sub-level <a id="wrglossary.11280"></a><a href="#glo:idx.group">groups</a> are only supported with the <a id="wrglossary.11281"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> (see §<a href="#sec:printunsrtgroups">8.4.1</a>). When they are supported, the heading will be formatted with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11282"></a><code class="code"><dfn id="glo:glslongextraSubGroupHeading"><code class="csfmt">\glslongextraSubGroupHeading</code></dfn>{<span class="meta">〈<em class="metainner">number columns</em>〉</span>}{<span class="meta">〈<em class="metainner">prev group level</em>〉</span>}{<span class="meta">〈<em class="metainner">group level</em>〉</span>}{<span class="meta">〈<em class="metainner">parent-entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<p>
+The styles are sub-divided below into the set of elements that are shown in each column, which may consist of: <a id="wrglossary.11283"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, <a id="wrglossary.11284"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a>, <a id="wrglossary.11285"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> or <a id="wrglossary.11286"></a><a href="#glo:dual.locationlist">location list</a>. There will be blank cells if any of the corresponding fields have not been set or if the <a id="wrglossary.11287"></a><a href="#glo:dual.locationlist">location list</a> has been suppressed.<p>
+
+</section><!-- end of section sec:longextra -->
+
+<section id="sec:longextranamedesc"><!-- start of section sec:longextranamedesc --><div class="tomain"><a href="#main">[top]</a></div>
+<h4><!-- start of subsubsection header -->8.7.2.1. Name and Description Only<div class="labellink"><a href="#sec:longextranamedesc">[link]</a></div></h4><!-- end of subsubsection header -->
+<p>
+These styles don’t display the symbol or <a id="wrglossary.11288"></a><a href="#glo:dual.locationlist">location list</a>, regardless of whether or not they have been set. In each case, the style starts with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11289"></a><code class="code"><dfn id="glo:glslongextraSetDescWidth"><code class="csfmt">\glslongextraSetDescWidth</code></dfn></code></div><!-- end of pinnedbox -->
+ which updates <a id="wrglossary.11290"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a> according to the widest name, identified with <a id="wrglossary.11291"></a><a href="#glo:glslongextraSetWidest"><code class="csfmt">\glslongextraSetWidest</code></a>. The column header text is also taken into account. If a widest name hasn’t been set and the column header is shorter than one or more names, the description column may be too wide. The value of <a id="wrglossary.11292"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a> is calculated as <a id="wrglossary.11293"></a><a href="#glo:linewidth"><code class="csfmt">\linewidth</code></a>-4<a id="wrglossary.11294"></a><a href="#glo:tabcolsep"><code class="csfmt">\tabcolsep</code></a>-W, where W is the width of the widest name.<p>
+If you want to set <a id="wrglossary.11295"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a> to a specific value, then redefine <a id="wrglossary.11296"></a><a href="#glo:glslongextraSetDescWidth"><code class="csfmt">\glslongextraSetDescWidth</code></a> with the desired length assignment.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11297"></a><code class="code"><dfn id="glo:opt.glostyle.long-name-desc"><span class="glostylefmt">long-name-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This has two columns: the name on the left and the description on the right. The table header is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11298"></a><code class="code"><dfn id="glo:glslongextraNameDescTabularHeader"><code class="csfmt">\glslongextraNameDescTabularHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which shows the column headers with horizontal rules. The table footer is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11299"></a><code class="code"><dfn id="glo:glslongextraNameDescTabularFooter"><code class="csfmt">\glslongextraNameDescTabularFooter</code></dfn></code></div><!-- end of pinnedbox -->
+ which just does a horizontal rule. With <a id="wrglossary.11300"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>, the table header and footer are set with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11301"></a><code class="code"><dfn id="glo:glslongextraNameDescHeader"><code class="csfmt">\glslongextraNameDescHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which uses the above header and footer commands.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11302"></a><code class="code"><dfn id="glo:opt.glostyle.long-desc-name"><span class="glostylefmt">long-desc-name</span></dfn></code></div><!-- end of settingsbox -->
+ This has two columns: the name on the right and the description on the left. The table header is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11303"></a><code class="code"><dfn id="glo:glslongextraDescNameTabularHeader"><code class="csfmt">\glslongextraDescNameTabularHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which shows the column headers with horizontal rules. The table footer is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11304"></a><code class="code"><dfn id="glo:glslongextraDescNameTabularFooter"><code class="csfmt">\glslongextraDescNameTabularFooter</code></dfn></code></div><!-- end of pinnedbox -->
+ which just does a horizontal rule. With <a id="wrglossary.11305"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>, the table header and footer are set with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11306"></a><code class="code"><dfn id="glo:glslongextraDescNameHeader"><code class="csfmt">\glslongextraDescNameHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which uses the above header and footer commands.<p>
+
+</section><!-- end of section sec:longextranamedesc -->
+
+<section id="sec:longextranamesymdesc"><!-- start of section sec:longextranamesymdesc --><div class="tomain"><a href="#main">[top]</a></div>
+<h4><!-- start of subsubsection header -->8.7.2.2. Name, Symbol and Description Only<div class="labellink"><a href="#sec:longextranamesymdesc">[link]</a></div></h4><!-- end of subsubsection header -->
+<p>
+These styles don’t show the <a id="wrglossary.11307"></a><a href="#glo:dual.locationlist">location list</a>. In each case, the style starts with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11308"></a><code class="code"><dfn id="glo:glslongextraSymSetDescWidth"><code class="csfmt">\glslongextraSymSetDescWidth</code></dfn></code></div><!-- end of pinnedbox -->
+ which updates <a id="wrglossary.11309"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a> according to the widest name, identified with <a id="wrglossary.11310"></a><a href="#glo:glslongextraSetWidest"><code class="csfmt">\glslongextraSetWidest</code></a>. This starts by calculating <a id="wrglossary.11311"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a> with <a id="wrglossary.11312"></a><a href="#glo:glslongextraSetDescWidth"><code class="csfmt">\glslongextraSetDescWidth</code></a> and then subtracts the width of the symbol column header text (which is assumed to be the widest text in that column).<p>
+If you want to set <a id="wrglossary.11313"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a> to a specific value, then redefine <a id="wrglossary.11314"></a><a href="#glo:glslongextraSymSetDescWidth"><code class="csfmt">\glslongextraSymSetDescWidth</code></a> with the desired length assignment.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11315"></a><code class="code"><dfn id="glo:opt.glostyle.long-name-desc-sym"><span class="glostylefmt">long-name-desc-sym</span></dfn></code></div><!-- end of settingsbox -->
+ This has three columns: the name on the left, the description in the middle and the symbol on the right. The table header is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11316"></a><code class="code"><dfn id="glo:glslongextraNameDescSymTabularHeader"><code class="csfmt">\glslongextraNameDescSymTabularHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which shows the column headers with horizontal rules. The table footer is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11317"></a><code class="code"><dfn id="glo:glslongextraNameDescSymTabularFooter"><code class="csfmt">\glslongextraNameDescSymTabularFooter</code></dfn></code></div><!-- end of pinnedbox -->
+ which just does a horizontal rule. With <a id="wrglossary.11318"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>, the table header and footer are set with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11319"></a><code class="code"><dfn id="glo:glslongextraNameDescSymHeader"><code class="csfmt">\glslongextraNameDescSymHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which uses the above header and footer commands.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11320"></a><code class="code"><dfn id="glo:opt.glostyle.long-name-sym-desc"><span class="glostylefmt">long-name-sym-desc</span></dfn></code></div><!-- end of settingsbox -->
+ This has three columns: the name on the left, the symbol in the middle and the description on the right. The table header is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11321"></a><code class="code"><dfn id="glo:glslongextraNameSymDescTabularHeader"><code class="csfmt">\glslongextraNameSymDescTabularHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which shows the column headers with horizontal rules. The table footer is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11322"></a><code class="code"><dfn id="glo:glslongextraNameSymDescTabularFooter"><code class="csfmt">\glslongextraNameSymDescTabularFooter</code></dfn></code></div><!-- end of pinnedbox -->
+ which just does a horizontal rule. With <a id="wrglossary.11323"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>, the table header and footer are set with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11324"></a><code class="code"><dfn id="glo:glslongextraNameSymDescHeader"><code class="csfmt">\glslongextraNameSymDescHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which uses the above header and footer commands.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11325"></a><code class="code"><dfn id="glo:opt.glostyle.long-sym-desc-name"><span class="glostylefmt">long-sym-desc-name</span></dfn></code></div><!-- end of settingsbox -->
+ This has three columns: the name on the right, the description in the middle and the symbol on the left. The table header is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11326"></a><code class="code"><dfn id="glo:glslongextraSymDescNameTabularHeader"><code class="csfmt">\glslongextraSymDescNameTabularHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which shows the column headers with horizontal rules. The table footer is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11327"></a><code class="code"><dfn id="glo:glslongextraSymDescNameTabularFooter"><code class="csfmt">\glslongextraSymDescNameTabularFooter</code></dfn></code></div><!-- end of pinnedbox -->
+ which just does a horizontal rule. With <a id="wrglossary.11328"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>, the table header and footer are set with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11329"></a><code class="code"><dfn id="glo:glslongextraSymDescNameHeader"><code class="csfmt">\glslongextraSymDescNameHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which uses the above header and footer commands.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11330"></a><code class="code"><dfn id="glo:opt.glostyle.long-desc-sym-name"><span class="glostylefmt">long-desc-sym-name</span></dfn></code></div><!-- end of settingsbox -->
+ This has three columns: the name on the right, the symbol in the middle and the description on the left. The table header is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11331"></a><code class="code"><dfn id="glo:glslongextraDescSymNameTabularHeader"><code class="csfmt">\glslongextraDescSymNameTabularHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which shows the column headers with horizontal rules. The table footer is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11332"></a><code class="code"><dfn id="glo:glslongextraDescSymNameTabularFooter"><code class="csfmt">\glslongextraDescSymNameTabularFooter</code></dfn></code></div><!-- end of pinnedbox -->
+ which just does a horizontal rule. With <a id="wrglossary.11333"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>, the table header and footer are set with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11334"></a><code class="code"><dfn id="glo:glslongextraDescSymNameHeader"><code class="csfmt">\glslongextraDescSymNameHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which uses the above header and footer commands.<p>
+
+</section><!-- end of section sec:longextranamesymdesc -->
+
+<section id="sec:longextranamedescloc"><!-- start of section sec:longextranamedescloc --><div class="tomain"><a href="#main">[top]</a></div>
+<h4><!-- start of subsubsection header -->8.7.2.3. Name, Description and Location Only<div class="labellink"><a href="#sec:longextranamedescloc">[link]</a></div></h4><!-- end of subsubsection header -->
+<p>
+These styles don’t display the symbol, regardless of whether or not the <a id="wrglossary.11335"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> field has been set. In each case, the style starts with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11336"></a><code class="code"><dfn id="glo:glslongextraLocSetDescWidth"><code class="csfmt">\glslongextraLocSetDescWidth</code></dfn></code></div><!-- end of pinnedbox -->
+ which updates <a id="wrglossary.11337"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a> according to the widest name, identified with <a id="wrglossary.11338"></a><a href="#glo:glslongextraSetWidest"><code class="csfmt">\glslongextraSetWidest</code></a>. This starts by calculating <a id="wrglossary.11339"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a> with <a id="wrglossary.11340"></a><a href="#glo:glslongextraSetDescWidth"><code class="csfmt">\glslongextraSetDescWidth</code></a> and then subtracts 2<a id="wrglossary.11341"></a><a href="#glo:tabcolsep"><code class="csfmt">\tabcolsep</code></a>-<a id="wrglossary.11342"></a><a href="#glo:glspagelistwidth"><code class="csfmt">\glspagelistwidth</code></a>.<p>
+If you want to set <a id="wrglossary.11343"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a> to a specific value, then redefine <a id="wrglossary.11344"></a><a href="#glo:glslongextraLocSetDescWidth"><code class="csfmt">\glslongextraLocSetDescWidth</code></a> with the desired length assignment.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11345"></a><code class="code"><dfn id="glo:opt.glostyle.long-name-desc-loc"><span class="glostylefmt">long-name-desc-loc</span></dfn></code></div><!-- end of settingsbox -->
+ This has three columns: the name on the left, the description in the middle and the <a id="wrglossary.11346"></a><a href="#glo:dual.locationlist">location list</a> on the right. The table header is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11347"></a><code class="code"><dfn id="glo:glslongextraNameDescLocationTabularHeader"><code class="csfmt">\glslongextraNameDescLocationTabularHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which shows the column headers with horizontal rules. The table footer is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11348"></a><code class="code"><dfn id="glo:glslongextraNameDescLocationTabularFooter"><code class="csfmt">\glslongextraNameDescLocationTabularFooter</code></dfn></code></div><!-- end of pinnedbox -->
+ which just does a horizontal rule. With <a id="wrglossary.11349"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>, the table header and footer are set with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11350"></a><code class="code"><dfn id="glo:glslongextraNameDescLocationHeader"><code class="csfmt">\glslongextraNameDescLocationHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which uses the above header and footer commands.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11351"></a><code class="code"><dfn id="glo:opt.glostyle.long-loc-desc-name"><span class="glostylefmt">long-loc-desc-name</span></dfn></code></div><!-- end of settingsbox -->
+ This has three columns: the name on the right, the description in the middle and the <a id="wrglossary.11352"></a><a href="#glo:dual.locationlist">location list</a> on the left. The table header is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11353"></a><code class="code"><dfn id="glo:glslongextraLocationDescNameTabularHeader"><code class="csfmt">\glslongextraLocationDescNameTabularHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which shows the column headers with horizontal rules. The table footer is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11354"></a><code class="code"><dfn id="glo:glslongextraLocationDescNameTabularFooter"><code class="csfmt">\glslongextraLocationDescNameTabularFooter</code></dfn></code></div><!-- end of pinnedbox -->
+ which just does a horizontal rule. With <a id="wrglossary.11355"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>, the table header and footer are set with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11356"></a><code class="code"><dfn id="glo:glslongextraLocationDescNameHeader"><code class="csfmt">\glslongextraLocationDescNameHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which uses the above header and footer commands.<p>
+
+</section><!-- end of section sec:longextranamedescloc -->
+
+<section id="sec:longextranamedescsymloc"><!-- start of section sec:longextranamedescsymloc --><div class="tomain"><a href="#main">[top]</a></div>
+<h4><!-- start of subsubsection header -->8.7.2.4. Name, Description, Symbol and Location<div class="labellink"><a href="#sec:longextranamedescsymloc">[link]</a></div></h4><!-- end of subsubsection header -->
+<p>
+These styles show the name, description, symbol and <a id="wrglossary.11357"></a><a href="#glo:dual.locationlist">location list</a>. In each case, the style starts with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11358"></a><code class="code"><dfn id="glo:glslongextraSymLocSetDescWidth"><code class="csfmt">\glslongextraSymLocSetDescWidth</code></dfn></code></div><!-- end of pinnedbox -->
+ which updates <a id="wrglossary.11359"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a> according to the widest name, identified with <a id="wrglossary.11360"></a><a href="#glo:glslongextraSetWidest"><code class="csfmt">\glslongextraSetWidest</code></a>. This starts by calculating <a id="wrglossary.11361"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a> with <a id="wrglossary.11362"></a><a href="#glo:glslongextraSymSetDescWidth"><code class="csfmt">\glslongextraSymSetDescWidth</code></a> and then subtracts 2<a id="wrglossary.11363"></a><a href="#glo:tabcolsep"><code class="csfmt">\tabcolsep</code></a>-<a id="wrglossary.11364"></a><a href="#glo:glspagelistwidth"><code class="csfmt">\glspagelistwidth</code></a>.<p>
+If you want to set <a id="wrglossary.11365"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a> to a specific value, then redefine <a id="wrglossary.11366"></a><a href="#glo:glslongextraSymLocSetDescWidth"><code class="csfmt">\glslongextraSymLocSetDescWidth</code></a> with the desired length assignment.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11367"></a><code class="code"><dfn id="glo:opt.glostyle.long-name-desc-sym-loc"><span class="glostylefmt">long-name-desc-sym-loc</span></dfn></code></div><!-- end of settingsbox -->
+ This has four columns, from left to right: the name, description, symbol and the <a id="wrglossary.11368"></a><a href="#glo:dual.locationlist">location list</a>. The table header is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11369"></a><code class="code"><dfn id="glo:glslongextraNameDescSymLocationTabularHeader"><code class="csfmt">\glslongextraNameDescSymLocationTabularHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which shows the column headers with horizontal rules. The table footer is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11370"></a><code class="code"><dfn id="glo:glslongextraNameDescSymLocationTabularFooter"><code class="csfmt">\glslongextraNameDescSymLocationTabularFooter</code></dfn></code></div><!-- end of pinnedbox -->
+ which just does a horizontal rule. With <a id="wrglossary.11371"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>, the table header and footer are set with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11372"></a><code class="code"><dfn id="glo:glslongextraNameDescSymLocationHeader"><code class="csfmt">\glslongextraNameDescSymLocationHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which uses the above header and footer commands.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11373"></a><code class="code"><dfn id="glo:opt.glostyle.long-name-sym-desc-loc"><span class="glostylefmt">long-name-sym-desc-loc</span></dfn></code></div><!-- end of settingsbox -->
+ This has four columns, from left to right: the name, symbol, description and the <a id="wrglossary.11374"></a><a href="#glo:dual.locationlist">location list</a>. The table header is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11375"></a><code class="code"><dfn id="glo:glslongextraNameSymDescLocationTabularHeader"><code class="csfmt">\glslongextraNameSymDescLocationTabularHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which shows the column headers with horizontal rules. The table footer is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11376"></a><code class="code"><dfn id="glo:glslongextraNameSymDescLocationTabularFooter"><code class="csfmt">\glslongextraNameSymDescLocationTabularFooter</code></dfn></code></div><!-- end of pinnedbox -->
+ which just does a horizontal rule. With <a id="wrglossary.11377"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>, the table header and footer are set with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11378"></a><code class="code"><dfn id="glo:glslongextraNameSymDescLocationHeader"><code class="csfmt">\glslongextraNameSymDescLocationHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which uses the above header and footer commands.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11379"></a><code class="code"><dfn id="glo:opt.glostyle.long-loc-sym-desc-name"><span class="glostylefmt">long-loc-sym-desc-name</span></dfn></code></div><!-- end of settingsbox -->
+ This has four columns, from left to right: the <a id="wrglossary.11380"></a><a href="#glo:dual.locationlist">location list</a>, symbol, description and the name. The table header is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11381"></a><code class="code"><dfn id="glo:glslongextraLocationSymDescNameTabularHeader"><code class="csfmt">\glslongextraLocationSymDescNameTabularHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which shows the column headers with horizontal rules. The table footer is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11382"></a><code class="code"><dfn id="glo:glslongextraLocationSymDescNameTabularFooter"><code class="csfmt">\glslongextraLocationSymDescNameTabularFooter</code></dfn></code></div><!-- end of pinnedbox -->
+ which just does a horizontal rule. With <a id="wrglossary.11383"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>, the table header and footer are set with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11384"></a><code class="code"><dfn id="glo:glslongextraLocationSymDescNameHeader"><code class="csfmt">\glslongextraLocationSymDescNameHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which uses the above header and footer commands.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11385"></a><code class="code"><dfn id="glo:opt.glostyle.long-loc-desc-sym-name"><span class="glostylefmt">long-loc-desc-sym-name</span></dfn></code></div><!-- end of settingsbox -->
+ This has four columns, from left to right: the <a id="wrglossary.11386"></a><a href="#glo:dual.locationlist">location list</a>, description, symbol and the name. The table header is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11387"></a><code class="code"><dfn id="glo:glslongextraLocationDescSymNameTabularHeader"><code class="csfmt">\glslongextraLocationDescSymNameTabularHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which shows the column headers with horizontal rules. The table footer is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11388"></a><code class="code"><dfn id="glo:glslongextraLocationDescSymNameTabularFooter"><code class="csfmt">\glslongextraLocationDescSymNameTabularFooter</code></dfn></code></div><!-- end of pinnedbox -->
+ which just does a horizontal rule. With <a id="wrglossary.11389"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>, the table header and footer are set with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11390"></a><code class="code"><dfn id="glo:glslongextraLocationDescSymNameHeader"><code class="csfmt">\glslongextraLocationDescSymNameHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which uses the above header and footer commands.<p>
+
+</section><!-- end of section sec:longextranamedescsymloc -->
+
+<section id="sec:longextrasymdesc"><!-- start of section sec:longextrasymdesc --><div class="tomain"><a href="#main">[top]</a></div>
+<h4><!-- start of subsubsection header -->8.7.2.5. Symbol and Description Only<div class="labellink"><a href="#sec:longextrasymdesc">[link]</a></div></h4><!-- end of subsubsection header -->
+<p>
+These are two-column styles designed to show only the symbol and description. However, if the <a id="wrglossary.11391"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> isn’t set then the name will be used instead. If this occurs, you may need to change the width of the description column.<p>
+The horizontal alignment for the symbol column is obtained with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11392"></a><code class="code"><dfn id="glo:glslongextraSymbolNameAlign"><code class="csfmt">\glslongextraSymbolNameAlign</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>l</span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ which expands to <code class="code">l</code> by default. Note that this is different from the alignment used for styles like <a id="wrglossary.11393"></a><a href="#glo:opt.glostyle.long-name-sym-desc"><span class="glostylefmt">long-name-sym-desc</span></a>.<p>
+These styles have the entry item number (if <a id="wrglossary.11394"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> is on) and the hypertarget anchor (if enabled) in the symbol column since there’s no name shown (unless the symbol is missing). These are all performed by for top-level entries by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11395"></a><code class="code"><dfn id="glo:glslongextraSymbolTargetFmt"><code class="csfmt">\glslongextraSymbolTargetFmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The symbol is formatted according to <a id="wrglossary.11396"></a><a href="#glo:glslongextraSymbolFmt"><code class="csfmt">\glslongextraSymbolFmt</code></a>. Child entries use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11397"></a><code class="code"><dfn id="glo:glslongextraSubSymbolTargetFmt"><code class="csfmt">\glslongextraSubSymbolTargetFmt</code></dfn>{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Unlike <a id="wrglossary.11398"></a><a href="#glo:glslongextraSubNameFmt"><code class="csfmt">\glslongextraSubNameFmt</code></a> this shows the field value (formatted with <a id="wrglossary.11399"></a><a href="#glo:glslongextraSymbolFmt"><code class="csfmt">\glslongextraSymbolFmt</code></a>).<p>
+The following commands use the above if the <a id="wrglossary.11400"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> field is set, otherwise they show the name.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11401"></a><code class="code"><dfn id="glo:glslongextraSymbolOrName"><code class="csfmt">\glslongextraSymbolOrName</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Shows the symbol, if set, or the name otherwise, with the target. Child entries use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11402"></a><code class="code"><dfn id="glo:glslongextraSubSymbolOrName"><code class="csfmt">\glslongextraSubSymbolOrName</code></dfn>{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Shows the symbol with <a id="wrglossary.11403"></a><a href="#glo:glslongextraSubSymbolTargetFmt"><code class="csfmt">\glslongextraSubSymbolTargetFmt</code></a>, if set, or the name otherwise, with the target.<p>
+In each case, the style starts with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11404"></a><code class="code"><dfn id="glo:glslongextraSymNoNameSetDescWidth"><code class="csfmt">\glslongextraSymNoNameSetDescWidth</code></dfn></code></div><!-- end of pinnedbox -->
+ which calculates <a id="wrglossary.11405"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a> as <a id="wrglossary.11406"></a><a href="#glo:linewidth"><code class="csfmt">\linewidth</code></a>-4<a id="wrglossary.11407"></a><a href="#glo:tabcolsep"><code class="csfmt">\tabcolsep</code></a>-W, where W is the width of the symbol column header. Note that this assumes the content of the symbol column isn’t wider than the column header.<p>
+If you want to set <a id="wrglossary.11408"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a> to a specific value, then redefine <a id="wrglossary.11409"></a><a href="#glo:glslongextraSymNoNameSetDescWidth"><code class="csfmt">\glslongextraSymNoNameSetDescWidth</code></a> with the desired length assignment.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11410"></a><code class="code"><dfn id="glo:opt.glostyle.long-sym-desc"><span class="glostylefmt">long-sym-desc</span></dfn></code></div><!-- end of settingsbox -->
+ The symbol is in the left column (or the name, if the symbol isn’t set). The description is in the right. The <a id="wrglossary.11411"></a><a href="#glo:dual.locationlist">location list</a> isn’t shown. The table header is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11412"></a><code class="code"><dfn id="glo:glslongextraSymDescTabularHeader"><code class="csfmt">\glslongextraSymDescTabularHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which shows the column headers with horizontal rules. The table footer is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11413"></a><code class="code"><dfn id="glo:glslongextraSymDescTabularFooter"><code class="csfmt">\glslongextraSymDescTabularFooter</code></dfn></code></div><!-- end of pinnedbox -->
+ which just does a horizontal rule. With <a id="wrglossary.11414"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>, the table header and footer are set with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11415"></a><code class="code"><dfn id="glo:glslongextraSymDescHeader"><code class="csfmt">\glslongextraSymDescHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which uses the above header and footer commands.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11416"></a><code class="code"><dfn id="glo:opt.glostyle.long-desc-sym"><span class="glostylefmt">long-desc-sym</span></dfn></code></div><!-- end of settingsbox -->
+ The symbol is in the right column (or the name, if the symbol isn’t set). The description is in the left. The <a id="wrglossary.11417"></a><a href="#glo:dual.locationlist">location list</a> isn’t shown. The table header is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11418"></a><code class="code"><dfn id="glo:glslongextraDescSymTabularHeader"><code class="csfmt">\glslongextraDescSymTabularHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which shows the column headers with horizontal rules. The table footer is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11419"></a><code class="code"><dfn id="glo:glslongextraDescSymTabularFooter"><code class="csfmt">\glslongextraDescSymTabularFooter</code></dfn></code></div><!-- end of pinnedbox -->
+ which just does a horizontal rule. With <a id="wrglossary.11420"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>, the table header and footer are set with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11421"></a><code class="code"><dfn id="glo:glslongextraDescSymHeader"><code class="csfmt">\glslongextraDescSymHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which uses the above header and footer commands.<p>
+
+</section><!-- end of section sec:longextrasymdesc -->
+
+<section id="sec:longextraabbr"><!-- start of section sec:longextraabbr --><div class="tomain"><a href="#main">[top]</a></div>
+<h4><!-- start of subsubsection header -->8.7.2.6. Abbreviations Only<div class="labellink"><a href="#sec:longextraabbr">[link]</a></div></h4><!-- end of subsubsection header -->
+<p>
+These styles are designed for abbreviations. They display the short and long forms, rather than the name and description, although these may happen to match. They are primarily intended for <a id="wrglossary.11422"></a><a href="#glo:idx.mini-glossary">mini-glossaries</a> or similar summary lists.<p>
+Although these styles don’t show the name or description, they still use some of the name and description settings provided by <a id="wrglossary.11423"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a>. The column for the short form uses the same alignment as for the name columns (<a id="wrglossary.11424"></a><a href="#glo:glslongextraNameAlign"><code class="csfmt">\glslongextraNameAlign</code></a>). The column for the long form uses the same alignment as for the description columns (<a id="wrglossary.11425"></a><a href="#glo:glslongextraDescAlign"><code class="csfmt">\glslongextraDescAlign</code></a>) and has the width set to <a id="wrglossary.11426"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a>. However, the name and description formatting commands or attributes (such as <a id="wrglossary.11427"></a><a href="#glo:glsnamefont"><code class="csfmt">\glsnamefont</code></a>, <a id="wrglossary.11428"></a><a href="#glo:opt.catattr.glossnamefont"><span class="csoptfmt">glossnamefont</span></a> or <a id="wrglossary.11429"></a><a href="#glo:opt.catattr.glossname"><span class="csoptfmt">glossname</span></a>) aren’t used as the formatting is left to the abbreviation style. <p>
+If the <a id="wrglossary.11430"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> field hasn’t been set, the short column will show the name instead, and if the <a id="wrglossary.11431"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> field hasn’t been set, the long column will show the description instead (using the same commands as for styles like <a id="wrglossary.11432"></a><a href="#glo:opt.glostyle.long-name-desc"><span class="glostylefmt">long-name-desc</span></a>, which do use the associated formatting commands and attributes).<p>
+These styles use the following commands: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11433"></a><code class="code"><dfn id="glo:glslongextraShortHeader"><code class="csfmt">\glslongextraShortHeader</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:entryname"><code class="csfmt">\entryname</code></a></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ The header for the column showing the short form. This is defined as: <pre class="compactcodebox"><code class="cmd">\newcommand</code>{<a id="wrglossary.11434"></a><a href="#glo:glslongextraShortHeader"><code class="csfmt">\glslongextraShortHeader</code></a>}{<a id="wrglossary.11435"></a><a href="#glo:entryname"><code class="csfmt">\entryname</code></a>}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11436"></a><code class="code"><dfn id="glo:glslongextraLongHeader"><code class="csfmt">\glslongextraLongHeader</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:descriptionname"><code class="csfmt">\descriptionname</code></a></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ The header for the column showing the long form. This is defined as: <pre class="compactcodebox"><code class="cmd">\newcommand</code>{<a id="wrglossary.11437"></a><a href="#glo:glslongextraLongHeader"><code class="csfmt">\glslongextraLongHeader</code></a>}{<a id="wrglossary.11438"></a><a href="#glo:descriptionname"><code class="csfmt">\descriptionname</code></a>}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11439"></a><code class="code"><dfn id="glo:glslongextraShortTargetFmt"><code class="csfmt">\glslongextraShortTargetFmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This governs the way that the short form should be displayed, including the target. This is defined as: <pre class="compactcodebox"><code class="cmd">\newcommand</code>{<a id="wrglossary.11440"></a><a href="#glo:glslongextraShortTargetFmt"><code class="csfmt">\glslongextraShortTargetFmt</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.11441"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a>{#1}<a id="wrglossary.11442"></a><a href="#glo:glstarget"><code class="csfmt">\glstarget</code></a>{#1}{{<a id="wrglossary.11443"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>[<a id="wrglossary.11444"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a>,<a id="wrglossary.11445"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span>]{#1}}}<span class="comment">% </span>
+ <a id="wrglossary.11446"></a><a href="#glo:glsxtrpostnamehook"><code class="csfmt">\glsxtrpostnamehook</code></a>{#1}}
+</pre> Note that the <a id="wrglossary.11447"></a><a href="#glo:dual.postnamehook">post-name hook</a> is included.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11448"></a><code class="code"><dfn id="glo:glslongextraLongFmt"><code class="csfmt">\glslongextraLongFmt</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This governs the way that the long form should be displayed. This is defined as: <pre class="compactcodebox"><code class="cmd">\newcommand</code>{<a id="wrglossary.11449"></a><a href="#glo:glslongextraLongFmt"><code class="csfmt">\glslongextraLongFmt</code></a>}[1]{<span class="comment">% </span>
+ {<a id="wrglossary.11450"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a>[<a id="wrglossary.11451"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a>,<a id="wrglossary.11452"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a>false]{#1}}<a id="wrglossary.11453"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a>
}
-\GlsXtrLoadResources[src=entries]
-\glsxtraddlabelprefix{dual.}
-\glsxtraddlabelprefix{}
-\begin{document}
-First&#x00A0;use:&#x00A0;\dgls{duck},&#x00A0;\dgls{svm},&#x00A0;\dgls{pi}.
-Next&#x00A0;use:&#x00A0;\dgls{duck},&#x00A0;\dgls{svm},&#x00A0;\dgls{pi}.
-\printunsrtglossaries
-\end{document}
-</pre>
-<!--l. 13066--><p class="nopar" > On the first LaTeX&#x00A0;call (when the <span
-class="cmtt-10">.glstex </span>file doesn&#8217;t exist), neither <span
-class="cmtt-10">dual.svm </span>nor
-<span
-class="cmtt-10">svm </span>exists, so <span
-class="cmtt-10">\dgls </span>uses the last prefix (which is empty in this case). This means
-that on the first LaTeX&#x00A0;run, <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\dgls{svm}</span></span></span> behaves like <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls{svm}</span></span></span>, which adds a
-record for the primary <span
-class="cmtt-10">svm </span>entry. The default primary-dual dependency means that
-this will cause both the primary (<span
-class="cmtt-10">svm</span>) and dual (<span
-class="cmtt-10">dual.svm</span>) entry to be selected. The
-location will be added to the primary entry&#8217;s location list, unless overridden by
-resource options, such as <span
-class="cmtt-10">combine-dual-locations</span>.
-</p><!--l. 13078--><p class="indent" > Once <a
- id="dx1-83026"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> has been run and the <span
-class="cmtt-10">.glstex </span>file exists, then <span
-class="cmtt-10">dual.svm </span>exists.
-So <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\dgls{svm}</span></span></span> will again first try <span
-class="cmtt-10">dual.svm </span>(as <span
-class="cmtt-10">dual. </span>is the first in the
-list of label prefixes). That now exists, so <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\dgls{svm}</span></span></span> now behaves like
-<span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls{dual.svm}</span></span></span>, which follows the abbreviation style and hyperlinks to the list of
-abbreviations.
-</p><!--l. 13086--><p class="indent" > Similarly for the index-symbol combination <span
-class="cmtt-10">dual.pi </span>and <span
-class="cmtt-10">pi</span>. In the case of
-<span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\dgls{duck}</span></span></span>, the label <span
-class="cmtt-10">dual.duck </span>never exists, so that&#8217;s never selected. The empty
-prefix is the only one that matches, so <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\dgls{duck}</span></span></span> always behaves like
-<span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls{duck}</span></span></span>.
-</p><!--l. 13092--><p class="indent" > If you haven&#8217;t used <span
-class="cmtt-10">combine-dual-locations </span>an extra <a
- id="dx1-83027"></a><span
-class="cmtt-10">bib2gls</span>+LaTeX&#x00A0;run
-may be required to correct the location lists.
-</p><!--l. 13096--><p class="indent" > If you change the label prefixes, remember to update the corresponding
-<span
-class="cmtt-10">\glsxtraddlabelprefix{</span>&#x27E8;<span
-class="cmti-10">prefix</span>&#x27E9;<span
-class="cmtt-10">}</span>. If no prefixes have been added to the list (or if the
-list is cleared), just an empty prefix is assumed.
-</p><!--l. 13101--><p class="indent" > As from version 1.8, <a
- id="dx1-83028"></a><span
-class="cmtt-10">bib2gls </span>provides hooks that identify the label prefixes in the
-<span
-class="cmtt-10">.glstex </span>file: </p><div class="alltt">
-
-
-
-<div class="obeylines-v">
-<span
-class="cmtt-10">\bibglstertiaryprefixlabel</span><a
- id="dx1-83029"></a><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;<span
-class="cmtt-10">}</span>
-<br /><span
-class="cmtt-10">\bibglsdualprefixlabel</span><a
- id="dx1-83030"></a><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;<span
-class="cmtt-10">}</span>
-<br /><span
-class="cmtt-10">\bibglsprimaryprefixlabel</span><a
- id="dx1-83031"></a><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">prefix</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div>
-</div> These do nothing by default, but they can be defined before the resource file is
-loaded to set up the prefix list. For example:
-
-
-
- <pre class="verbatim" id="verbatim-298">
-\newcommand{\bibglsprimaryprefixlabel}[1]{\glsxtraddlabelprefix{#1}}
-\newcommand{\bibglsdualprefixlabel}[1]{\glsxtrprependlabelprefix{#1}}
-\GlsXtrLoadResources[src=entries]
-</pre>
-<!--l. 13115--><p class="nopar" > Remember that this will only have an effect once the <span
-class="cmtt-10">.glstex </span>file has been created.
-The prefix list will be empty on the first run (which is treated as a single empty
-prefix). If this isn&#8217;t a suitable fallback, it may be necessary to add one after all the
-resource commands:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-299">
-\newcommand{\bibglsprimaryprefixlabel}[1]{\glsxtraddlabelprefix{#1}}
-\newcommand{\bibglsdualprefixlabel}[1]{\glsxtrprependlabelprefix{#1}}
-\GlsXtrLoadResources[src=entries,label-prefix={idx.}]
-\glsxtraddlabelprefix{idx.}
-</pre>
-<!--l. 13126--><p class="nopar" > Although this rather defeats the purpose of using the hooks as you still have to keep
-track of the fallback prefix.
-</p><!--l. 13130--><p class="noindent" >
-</p>
-<!--l. 13130--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">10.5 </span> <a
- id="sec:recordcount"></a>Record Counting</h3>
-<!--l. 13133--><p class="noindent" >As from version 1.1 of <a
- id="dx1-84001"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a>, you can save the total record count for each entry by
-invoking <a
- id="dx1-84002"></a><span
-class="cmtt-10">bib2gls </span>with the <span
-class="cmtt-10">--record-count </span>or <span
-class="cmtt-10">--record-count-unit </span>switches.
-These options will ensure that when each entry is written to the <span
-class="cmtt-10">.glstex </span>file
-<a
- id="dx1-84003"></a><span
-class="cmtt-10">bib2gls </span>will additionally set the following internal fields for that entry:
-</p>
- <ul class="itemize1">
- <li class="itemize"><span
-class="cmtt-10">recordcount</span>: set to the total number of records found for the entry;
- </li>
- <li class="itemize"><span
-class="cmtt-10">recordcount.</span>&#x27E8;<span
-class="cmitt-10">counter</span>&#x27E9;: set to the total number of records found for the
- entry for the given counter.</li></ul>
-<!--l. 13145--><p class="noindent" >If <span
-class="cmtt-10">--record-count-unit </span>is used then additionally: </p>
- <ul class="itemize1">
- <li class="itemize"><span
-class="cmtt-10">recordcount.</span>&#x27E8;<span
-class="cmitt-10">counter</span>&#x27E9;<span
-class="cmtt-10">.</span>&#x27E8;<span
-class="cmitt-10">location</span>&#x27E9;: set to the total number of records
- found for the entry for the given counter with the given location.</li></ul>
-<!--l. 13151--><p class="noindent" >Only use the unit counting option if the locations don&#8217;t contain any special characters. If
-you really need it with locations that may contain formatting commands, then you
-can try redefining:
-</p><!--l. 13154--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-84004"></a> <span
-class="cmtt-10">\glsxtrdetoklocation{</span>&#x27E8;<span
-class="cmitt-10">location</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13156--><p class="noindent" >
-so that it detokenizes &#x27E8;<span
-class="cmti-10">location</span>&#x27E9; but take care when using <span
-class="cmtt-10">\GlsXtrLocationRecordCount</span>
-with commands like <span
-class="cmtt-10">\thepage </span>as they can end up becoming detokenized too
-early.
-</p><!--l. 13162--><p class="indent" > Note that the record count includes locations that <a
- id="dx1-84005"></a><span
-class="cmtt-10">bib2gls </span>discards, such as
-ignored records, duplicates and partial duplicates. It doesn&#8217;t include cross-reference
-records. For example, if <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls{bird}</span></span></span> is used twice on page&#x00A0;1, once on page&#x00A0;2 and
-fours times on page&#x00A0;3, and <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls[counter=section]{bird}</span></span></span> is used once in
-
-
-
-section&#x00A0;3, then the total record count (stored in the <span
-class="cmtt-10">recordcount </span>field) is
-2 + 1 + 4 + 1 = 8, the total for the <span
-class="cmtt-10">page </span>counter (stored in the <span
-class="cmtt-10">recordcount.page</span>
-field) is 2 + 1 + 4 = 7, and the total for the <span
-class="cmtt-10">section </span>counter (stored in the
-<span
-class="cmtt-10">recordcount.section </span>field) is 1.
-</p><!--l. 13174--><p class="indent" > With the unit counting on as well, the field <span
-class="cmtt-10">recordcount.page.1 </span>is set to
-2, <span
-class="cmtt-10">recordcount.page.2 </span>is set to 1, <span
-class="cmtt-10">recordcount.page.3 </span>is set to 4 and
-<span
-class="cmtt-10">recordcount.section.3 </span>is set to 1.
-</p><!--l. 13179--><p class="indent" > You can access these fields using the following commands which will expand to
-the field value if set or to 0 if unset:
-</p><!--l. 13181--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-84006"></a> <span
-class="cmtt-10">\GlsXtrTotalRecordCount{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13183--><p class="noindent" >
-This expands to the total record count for the entry given by &#x27E8;<span
-class="cmti-10">label</span>&#x27E9;.
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-300">
-\GlsXtrTotalRecordCount{bird}
-</pre>
-<!--l. 13188--><p class="nopar" > expands to 8.
-</p><!--l. 13191--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-84007"></a> <span
-class="cmtt-10">\GlsXtrRecordCount{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">counter</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13193--><p class="noindent" >
-This expands to the counter total for the entry given by &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; where &#x27E8;<span
-class="cmti-10">counter</span>&#x27E9; is the
-counter name. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-301">
-\GlsXtrRecordCount{bird}{page}
-</pre>
-<!--l. 13199--><p class="nopar" > expands to 7 and
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-302">
-\GlsXtrRecordCount{bird}{section}
-</pre>
-<!--l. 13203--><p class="nopar" > expands to 1.
-</p><!--l. 13206--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-84008"></a> <span
-class="cmtt-10">\GlsXtrLocationRecordCount{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">counter</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">location</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13208--><p class="noindent" >
-This expands to the total for the given location. For example
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-303">
-\GlsXtrLocationRecordCount{bird}{page}{3}
-</pre>
-<!--l. 13212--><p class="nopar" > expands to 4. Be careful about using <span
-class="cmtt-10">\thepage </span>in the &#x27E8;<span
-class="cmti-10">location</span>&#x27E9; part. Remember that
-due to TeX&#8217;s asynchronous output routine, <span
-class="cmtt-10">\thepage </span>may not be correct.
-</p><!--l. 13217--><p class="indent" > There are commands analogous to the entry counting commands like <span
-class="cmtt-10">\cgls</span>
-and <span
-class="cmtt-10">\cglsformat </span>that are triggered by the record count. These are listed
-below.
-</p><!--l. 13221--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-84009"></a> <span
-class="cmtt-10">\rgls</span>&#x27E8;<span
-class="cmitt-10">modifier</span>&#x27E9;<span
-class="cmtt-10">[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 13223--><p class="noindent" >
-</p><!--l. 13224--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-84010"></a> <span
-class="cmtt-10">\rglspl</span>&#x27E8;<span
-class="cmitt-10">modifier</span>&#x27E9;<span
-class="cmtt-10">[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 13226--><p class="noindent" >
-</p><!--l. 13227--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-84011"></a> <span
-class="cmtt-10">\rGls</span>&#x27E8;<span
-class="cmitt-10">modifier</span>&#x27E9;<span
-class="cmtt-10">[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 13229--><p class="noindent" >
-</p><!--l. 13230--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-84012"></a> <span
-class="cmtt-10">\rGlspl</span>&#x27E8;<span
-class="cmitt-10">modifier</span>&#x27E9;<span
-class="cmtt-10">[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 13232--><p class="noindent" >
-</p><!--l. 13233--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-84013"></a> <span
-class="cmtt-10">\rGLS</span>&#x27E8;<span
-class="cmitt-10">modifier</span>&#x27E9;<span
-class="cmtt-10">[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 13235--><p class="noindent" >
-</p><!--l. 13236--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-84014"></a> <span
-class="cmtt-10">\rGLSpl</span>&#x27E8;<span
-class="cmitt-10">modifier</span>&#x27E9;<span
-class="cmtt-10">[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 13238--><p class="noindent" >
-These commands check the <a
-href="#catattr.recordcount"><span
-class="cmss-10">recordcount</span></a><a
- id="dx1-84015"></a> attribute which, if set, should be a number.
-For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-304">
-\glssetcategoryattribute{abbreviation}{recordcount}{1}
-</pre>
-<!--l. 13243--><p class="nopar" > For convenience, you can use
-</p><!--l. 13245--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-84016"></a> <span
-class="cmtt-10">\GlsXtrSetRecordCountAttribute{</span>&#x27E8;<span
-class="cmitt-10">category list</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">n</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13247--><p class="noindent" >
-to set the <a
-href="#catattr.recordcount"><span
-class="cmss-10">recordcount</span></a><a
- id="dx1-84017"></a> attribute to &#x27E8;<span
-class="cmti-10">n</span>&#x27E9; for all the categories listed in &#x27E8;<span
-class="cmti-10">category</span>
-<span
-class="cmti-10">list</span>&#x27E9;.
-</p><!--l. 13251--><p class="indent" > The <span
-class="cmtt-10">\rgls</span>-like commands use
-</p><!--l. 13252--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-84018"></a> <span
-class="cmtt-10">\glsxtrifrecordtrigger{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">trigger code</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">normal</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13255--><p class="noindent" >
-to determine whether the <span
-class="cmtt-10">\rgls</span>-like command should behave like its <span
-class="cmtt-10">\gls</span>
-counterpart (&#x27E8;<span
-class="cmti-10">normal</span>&#x27E9;) or whether it should instead use &#x27E8;<span
-class="cmti-10">trigger code</span>&#x27E9;.
-</p><!--l. 13260--><p class="indent" > This command checks if the <a
-href="#catattr.recordcount"><span
-class="cmss-10">recordcount</span></a><a
- id="dx1-84019"></a> attribute is set. If not is just does
-&#x27E8;<span
-class="cmti-10">normal</span>&#x27E9;, otherwise it tests if
-</p><!--l. 13263--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-84020"></a> <span
-class="cmtt-10">\glsxtrrecordtriggervalue{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13265--><p class="noindent" >
-is greater than the value given in the <a
-href="#catattr.recordcount"><span
-class="cmss-10">recordcount</span></a><a
- id="dx1-84021"></a> attribute for that entry&#8217;s category.
-If true, this does &#x27E8;<span
-class="cmti-10">normal</span>&#x27E9; otherwise it does &#x27E8;<span
-class="cmti-10">trigger code</span>&#x27E9;. The default definition of the
-trigger value command is:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-305">
-\newcommand*{\glsxtrrecordtriggervalue}[1]{%
-&#x00A0;\GlsXtrTotalRecordCount{#1}%
+</pre> Note that the <a id="wrglossary.11454"></a><a href="#glo:dual.postdeschook">post-description hook</a> is included.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11455"></a><code class="code"><dfn id="glo:glslongextraSubShortTargetFmt"><code class="csfmt">\glslongextraSubShortTargetFmt</code></dfn>{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This governs the way that the short form for child entries should be displayed, including the target. This is defined as: <pre class="compactcodebox"><code class="cmd">\newcommand</code>{<a id="wrglossary.11456"></a><a href="#glo:glslongextraSubShortTargetFmt"><code class="csfmt">\glslongextraSubShortTargetFmt</code></a>}[2]{<span class="comment">% </span>
+ <a id="wrglossary.11457"></a><a href="#glo:glssubentryitem"><code class="csfmt">\glssubentryitem</code></a>{#2}<a id="wrglossary.11458"></a><a href="#glo:glstarget"><code class="csfmt">\glstarget</code></a>{#2}{{<a id="wrglossary.11459"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>[<a id="wrglossary.11460"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a>,<a id="wrglossary.11461"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span>]{#2}}}<span class="comment">% </span>
+ <a id="wrglossary.11462"></a><a href="#glo:glsxtrpostnamehook"><code class="csfmt">\glsxtrpostnamehook</code></a>{#2}}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11463"></a><code class="code"><dfn id="glo:glslongextraSubLongFmt"><code class="csfmt">\glslongextraSubLongFmt</code></dfn>{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This governs the way that the long form for child entries should be displayed. This is defined as: <pre class="compactcodebox"><code class="cmd">\newcommand</code>{<a id="wrglossary.11464"></a><a href="#glo:glslongextraSubLongFmt"><code class="csfmt">\glslongextraSubLongFmt</code></a>}[2]{<a id="wrglossary.11465"></a><a href="#glo:glslongextraLongFmt"><code class="csfmt">\glslongextraLongFmt</code></a>{#2}}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11466"></a><code class="code"><dfn id="glo:glslongextraShortNoNameSetDescWidth"><code class="csfmt">\glslongextraShortNoNameSetDescWidth</code></dfn></code></div><!-- end of pinnedbox -->
+ This is used to compute the value of <a id="wrglossary.11467"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a> and assumes that none of the short forms are wider than <a id="wrglossary.11468"></a><a href="#glo:glslongextraShortHeader"><code class="csfmt">\glslongextraShortHeader</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11469"></a><code class="code"><dfn id="glo:opt.glostyle.abbr-short-long"><span class="glostylefmt">abbr-short-long</span></dfn></code></div><!-- end of settingsbox -->
+ A two column style. The short form is in the left column. The long form is in the right. The <a id="wrglossary.11470"></a><a href="#glo:dual.locationlist">location list</a> isn’t shown.<p>
+The table header is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11471"></a><code class="code"><dfn id="glo:glslongextraShortLongTabularHeader"><code class="csfmt">\glslongextraShortLongTabularHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which shows the column headers with horizontal rules.<p>
+The table footer is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11472"></a><code class="code"><dfn id="glo:glslongextraShortLongTabularFooter"><code class="csfmt">\glslongextraShortLongTabularFooter</code></dfn></code></div><!-- end of pinnedbox -->
+ which just does a horizontal rule. With <a id="wrglossary.11473"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>, the table header and footer are set with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11474"></a><code class="code"><dfn id="glo:glslongextraShortLongHeader"><code class="csfmt">\glslongextraShortLongHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which uses the above header and footer commands.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11475"></a><code class="code"><dfn id="glo:opt.glostyle.abbr-long-short"><span class="glostylefmt">abbr-long-short</span></dfn></code></div><!-- end of settingsbox -->
+ A two column style. The short form is in the right column. The long form is in the left. The <a id="wrglossary.11476"></a><a href="#glo:dual.locationlist">location list</a> isn’t shown.<p>
+The table header is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11477"></a><code class="code"><dfn id="glo:glslongextraLongShortTabularHeader"><code class="csfmt">\glslongextraLongShortTabularHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which shows the column headers with horizontal rules.<p>
+The table footer is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11478"></a><code class="code"><dfn id="glo:glslongextraLongShortTabularFooter"><code class="csfmt">\glslongextraLongShortTabularFooter</code></dfn></code></div><!-- end of pinnedbox -->
+ which just does a horizontal rule. With <a id="wrglossary.11479"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>, the table header and footer are set with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11480"></a><code class="code"><dfn id="glo:glslongextraLongShortHeader"><code class="csfmt">\glslongextraLongShortHeader</code></dfn></code></div><!-- end of pinnedbox -->
+ which uses the above header and footer commands.<p>
+<a id="wrglossary.11481"></a><p>
+
+</section><!-- end of section sec:longextraabbr -->
+
+<section id="sec:topic"><!-- start of section sec:topic --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->8.7.3. <span class="styfmt">glossary-topic</span> package<div class="labellink"><a href="#sec:topic">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<a id="wrglossary.11482"></a>The <a id="wrglossary.11483"></a><dfn id="glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></dfn> package provides glossary styles designed for hierarchical <a id="wrglossary.11484"></a><a href="#glo:dual.glossary">glossaries</a> where the top-level entries are topic titles. This package automatically loads the <a id="wrglossary.11485"></a><a href="#glo:pkg.multicol"><span class="styfmt">multicol</span></a> package. If the <a id="wrglossary.11486"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a> package is also loaded then commands like <a id="wrglossary.11487"></a><a href="#glo:glssetwidest"><code class="csfmt">\glssetwidest</code></a> can be used on these styles in much the same way as for the <a id="wrglossary.11488"></a><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a> style. If a widest value isn’t set then these styles behave more like the <a id="wrglossary.11489"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a> style.<p>
+This package provides styles designed for <a id="wrglossary.11490"></a><a href="#glo:dual.glossary">glossaries</a> that are lists of topics. That is, the top-level entries are considered topic titles (which may or may not have an associated symbol or description) and the sub-entries are items within that topic. By default the <a id="wrglossary.11491"></a><a href="#glo:dual.locationlist">location list</a> isn’t shown for the top-level entries but is shown after the description for sub-entries (unless suppressed with <a id="wrglossary.11492"></a><a href="#glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></a> or <a id="wrglossary.11493"></a><a href="#glo:opt.resource.save-locations"><span class="csoptfmt">save-locations</span></a><span class="optfmt">=false</span>). <p>
+The following styles are provided: <div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11494"></a><code class="code"><dfn id="glo:opt.glostyle.topic"><span class="glostylefmt">topic</span></dfn></code></div><!-- end of settingsbox -->
+ This style is similar to the <a id="wrglossary.11495"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a> style but the indentation doesn’t start until the second sub-item level. The top-level entries have the name displayed in a larger font with the description following in a new paragraph (see Example <a href="#ex:topicstyle">147</a>). This style doesn’t support the <a id="wrglossary.11496"></a><a href="#glo:opt.nogroupskip"><span class="styoptfmt">nogroupskip</span></a> setting.<p>
+ <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:topicstyle"></a>Example 147: The <span class="optfmt">topic</span> style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example147.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example147.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example147.png" type="image/png" width="376" height="311">Example document demonstrating the topic style.</object> </div><!-- end of resultbox -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11497"></a><code class="code"><dfn id="glo:opt.glostyle.topicmcols"><span class="glostylefmt">topicmcols</span></dfn></code></div><!-- end of settingsbox -->
+ This style is like the <a id="wrglossary.11498"></a><a href="#glo:opt.glostyle.topic"><span class="glostylefmt">topic</span></a> style but the sub-entries are placed inside a <a id="wrglossary.11499"></a><a href="#glo:env.multicols"><span class="envfmt">multicols</span></a> environment (unlike styles such as <a id="wrglossary.11500"></a><a href="#glo:opt.glostyle.mcoltree"><span class="glostylefmt">mcoltree</span></a> where the entire glossary content is within a single <a id="wrglossary.11501"></a><a href="#glo:env.multicols"><span class="envfmt">multicols</span></a> environment). The environment name is supplied in the value of the command: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11502"></a><code class="code"><dfn id="glo:glstopicColsEnv"><code class="csfmt">\glstopicColsEnv</code></dfn></code></div><!-- end of pinnedbox -->
+ This defaults to <code class="code">multicols</code>. You can change this to the starred form. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.11503"></a><a href="#glo:glstopicColsEnv"><code class="csfmt">\glstopicColsEnv</code></a>}{multicols*}
+</pre> The number of columns is given by the command: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11504"></a><code class="code"><dfn id="glo:glstopicCols"><code class="csfmt">\glstopicCols</code></dfn></code></div><!-- end of pinnedbox -->
+ This expands to 2, by default. This style is demonstrated in Example <a href="#ex:topicmcolsstyle">148</a>.<p>
+<div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:topicmcolsstyle"></a>Example 148: The <span class="optfmt">topicmcols</span> style <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example148.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example148.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example148.png" type="image/png" width="390" height="290">Example document demonstrating the topicmcols style.</object> </div><!-- end of resultbox -->
+<p>
+Both styles can have a widest name set like the <a id="wrglossary.11505"></a><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a> style, using the commands provided by <a id="wrglossary.11506"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a> and <a id="wrglossary.11507"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> or with the <a id="wrglossary.11508"></a><a href="#glo:opt.resource.set-widest"><span class="csoptfmt">set-widest</span></a> resource option. If a widest name is set, then the sub-entry names will be placed in a box of the given width otherwise they won’t be placed in a box. In Example <a href="#ex:topicmcolsstylewidest">149</a>, the widest names have been set for level 1 and level 2 using: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.11509"></a><a href="#glo:glssetwidest"><code class="csfmt">\glssetwidest</code></a>[1]{parameter}
+<a id="wrglossary.11510"></a><a href="#glo:glssetwidest"><code class="csfmt">\glssetwidest</code></a>[2]{<a id="wrglossary.11511"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a>{cosine}}
+</pre> Note that this doesn’t change the indentation at the start of the level 2 items to match the width of the level 1 widest name.<p>
+<div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:topicmcolsstylewidest"></a>Example 149: The <span class="optfmt">topicmcols</span> style with the widest name set <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example149.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example149.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example149.png" type="image/png" width="389" height="304">Example document demonstrating the topicmcols style.</object> </div><!-- end of resultbox -->
+<p>
+Both of the above styles use the following commands. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11512"></a><code class="code"><dfn id="glo:glstopicParIndent"><code class="csfmt">\glstopicParIndent</code></dfn></code></div><!-- end of pinnedbox -->
+ This command is a length that’s used for the paragraph indentation in any multi-paragraph description for top-level entries, but not for the first paragraph (at the start of the description) which isn’t indented.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11513"></a><code class="code"><dfn id="glo:glstopicSubIndent"><code class="csfmt">\glstopicSubIndent</code></dfn></code></div><!-- end of pinnedbox -->
+ This command is a length that’s used to calculate the hanging indentation for sub-entries. The level 1 sub-entries don’t indent the name. Level n sub-entries have the name indented by (n-1)×<a id="wrglossary.11514"></a><a href="#glo:glstopicSubIndent"><code class="csfmt">\glstopicSubIndent</code></a>. The hanging indent depends on whether or not a widest name has been set for the level.<p>
+There is also a length for additional indentation used in the second paragraph onwards for child entries with multi-paragraph descriptions: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11515"></a><code class="code"><dfn id="glo:glstopicSubItemParIndent"><code class="csfmt">\glstopicSubItemParIndent</code></dfn></code></div><!-- end of pinnedbox -->
+ This is initialised to <a id="wrglossary.11516"></a><a href="#glo:parindent"><code class="csfmt">\parindent</code></a> when <a id="wrglossary.11517"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> is loaded.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11518"></a><code class="code"><dfn id="glo:glstopicInit"><code class="csfmt">\glstopicInit</code></dfn></code></div><!-- end of pinnedbox -->
+ This hook is used at the start of the glossary. It does nothing by default.<p>
+Although the styles don’t support letter <a id="wrglossary.11519"></a><a href="#glo:idx.group">groups</a> by default, if you have many topics (top-level entries) and you feel that it would help the reader to divide them up into headed letter groups, you can redefine: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11520"></a><code class="code"><dfn id="glo:glstopicGroupHeading"><code class="csfmt">\glstopicGroupHeading</code></dfn>{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does nothing by default. If you want to redefine it, you can fetch the title corresponding to the group label with <a id="wrglossary.11521"></a><a href="#glo:glsxtrgetgrouptitle"><code class="csfmt">\glsxtrgetgrouptitle</code></a>. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.11522"></a><a href="#glo:glstopicGroupHeading"><code class="csfmt">\glstopicGroupHeading</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.11523"></a><a href="#glo:glsxtrgetgrouptitle"><code class="csfmt">\glsxtrgetgrouptitle</code></a>{#1}{<code class="cmd">\thisgrptitle</code>}<span class="comment">% </span>
+ <code class="cmd">\section</code>*{<code class="cmd">\thisgrptitle</code>}<span class="comment">% </span>
}
-</pre>
-<!--l. 13274--><p class="nopar" > The &#x27E8;<span
-class="cmti-10">trigger code</span>&#x27E9; part writes a record with the <span
-class="cmss-10">format</span><a
- id="dx1-84022"></a> set to <span
-class="cmtt-10">glstriggerrecordformat</span>
-(which <a
- id="dx1-84023"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> v1.1+ recognises as a special type of ignored location format) and
-does &#x27E8;<span
-class="cmti-10">trigger format</span>&#x27E9;. Then it unsets the <a
- id="dx1-84024"></a><a
-href="#glo:firstuseflag">first use flag</a>. Note that it doesn&#8217;t implement
-the post-link hook. This ensures that the record count is correct on the next
-run.
-</p><!--l. 13283--><p class="indent" > The &#x27E8;<span
-class="cmti-10">trigger format</span>&#x27E9; depends on the <span
-class="cmtt-10">\rgls</span>-like command used and will be one of
-the following:
-</p><!--l. 13285--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-84025"></a> <span
-class="cmtt-10">\rglsformat{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13287--><p class="noindent" >
-</p><!--l. 13288--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-84026"></a> <span
-class="cmtt-10">\rglsplformat{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13290--><p class="noindent" >
-</p><!--l. 13291--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-84027"></a> <span
-class="cmtt-10">\rGlsformat{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13293--><p class="noindent" >
-</p><!--l. 13294--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-84028"></a> <span
-class="cmtt-10">\rGlsplformat{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13296--><p class="noindent" >
-</p><!--l. 13297--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-84029"></a> <span
-class="cmtt-10">\rGLSformat{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13299--><p class="noindent" >
-</p><!--l. 13300--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-84030"></a> <span
-class="cmtt-10">\rGLSplformat{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13302--><p class="noindent" >
-These all behave much like their <span
-class="cmtt-10">\cglsformat </span>counterparts. If the entry&#8217;s <a
-href="#catattr.regular"><span
-class="cmss-10">regular</span></a><a
- id="dx1-84031"></a>
-attribute is set or if the entry doesn&#8217;t have a long form, the first or first plural is
-used, otherwise the long or long plural form is used.
-</p><!--l. 13308--><p class="indent" > You can use
-</p><!--l. 13309--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-84032"></a> <span
-class="cmtt-10">\glsxtrenablerecordcount </span></div><hr>
-</p><!--l. 13311--><p class="noindent" >
-to redefine <span
-class="cmtt-10">\gls</span>, <span
-class="cmtt-10">\glspl</span>, <span
-class="cmtt-10">\Gls</span>, <span
-class="cmtt-10">\Glspl</span>, <span
-class="cmtt-10">\GLS</span>, <span
-class="cmtt-10">\GLSpl </span>to <span
-class="cmtt-10">\rgls</span>, <span
-class="cmtt-10">\rglspl</span>, <span
-class="cmtt-10">\rGls</span>,
-<span
-class="cmtt-10">\rGlspl</span>, <span
-class="cmtt-10">\rGLS</span>, <span
-class="cmtt-10">\rGLSpl</span>, respectively, for convenience.
-</p><!--l. 13316--><p class="indent" > If you don&#8217;t want the entries that use &#x27E8;<span
-class="cmti-10">trigger code</span>&#x27E9; to appear in the glossary, you
-need to use the resource option <span
-class="cmtt-10">trigger-type </span>to assign them to another glossary.
-For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-306">
-\documentclass{article}
-\usepackage[record]{glossaries-extra}
-\newignoredglossary{ignored}
-\GlsXtrLoadResources[
-&#x00A0;src=example-glossaries-acronym,
-&#x00A0;trigger-type=ignored,
-&#x00A0;category=abbreviation
+</pre> Remember that if you are using <a id="wrglossary.11524"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, you will need the <a id="wrglossary.11525"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> or <a id="wrglossary.11526"></a><a href="#glo:switch.group"><span class="shortargfmt">-g</span></a> switch to support <a id="wrglossary.11527"></a><a href="#glo:idx.group">groups</a> (see §<a href="#sec:printunsrtgroups">8.4.1</a>).<p>
+Sub-<a id="wrglossary.11528"></a><a href="#glo:idx.group">groups</a> are only available with <a id="wrglossary.11529"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> and the <a id="wrglossary.11530"></a><a href="#glo:opt.resource.group-level"><span class="csoptfmt">group-level</span></a> option. If they are supported, sub-group headings are formatted according to: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11531"></a><code class="code"><dfn id="glo:glstopicSubGroupHeading"><code class="csfmt">\glstopicSubGroupHeading</code></dfn>{<span class="meta">〈<em class="metainner">prev group level</em>〉</span>}{<span class="meta">〈<em class="metainner">group level</em>〉</span>}{<span class="meta">〈<em class="metainner">parent entry</em>〉</span>}{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This formats the sub-group heading. Note that unlike <a id="wrglossary.11532"></a><a href="#glo:glstopicGroupHeading"><code class="csfmt">\glstopicGroupHeading</code></a> this command does actually format the sub-group heading by default. This means that it you use <a id="wrglossary.11533"></a><a href="#glo:opt.resource.group-level"><span class="csoptfmt">group-level</span></a><span class="optfmt">=all</span>, the top-level groups won’t be displayed, but the sub-groups will be.<p>
+Top-level entries are formatted according to: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11534"></a><code class="code"><dfn id="glo:glstopicItem"><code class="csfmt">\glstopicItem</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This formats the name and (if provided) the symbol. The description (if set) will follow in a new paragraph. At the start of <a id="wrglossary.11535"></a><a href="#glo:glstopicItem"><code class="csfmt">\glstopicItem</code></a>, a vertical space is added with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11536"></a><code class="code"><dfn id="glo:glstopicPreSkip"><code class="csfmt">\glstopicPreSkip</code></dfn></code></div><!-- end of pinnedbox -->
+ which defaults to <code class="csfmt">\medskip</code>. There is then a hook: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11537"></a><code class="code"><dfn id="glo:glstopicMarker"><code class="csfmt">\glstopicMarker</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which does nothing by default, but may be redefined. For example, to add a line to the table of contents. The name and symbol are set in the form of a title using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11538"></a><code class="code"><dfn id="glo:glstopicTitle"><code class="csfmt">\glstopicTitle</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.11539"></a><a href="#glo:Glossentryname"><code class="csfmt">\Glossentryname</code></a> which uses <a id="wrglossary.11540"></a><a href="#glo:idx.sentencecase">sentence case</a>. If there’s a symbol, this is added in parentheses. Both name and symbol (if present) are encapsulated by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11541"></a><code class="code"><dfn id="glo:glstopicTitleFont"><code class="csfmt">\glstopicTitleFont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This uses a bold, large font by default.<p>
+If the entry has the description key set (tested with <a id="wrglossary.11542"></a><a href="#glo:ifglshasdesc"><code class="csfmt">\ifglshasdesc</code></a>) then a paragraph break is inserted followed by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11543"></a><code class="code"><dfn id="glo:glstopicMidSkip"><code class="csfmt">\glstopicMidSkip</code></dfn></code></div><!-- end of pinnedbox -->
+ which defaults to <code class="csfmt">\smallskip</code>. This is followed by the description which is formatted according to: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11544"></a><code class="code"><dfn id="glo:glstopicDesc"><code class="csfmt">\glstopicDesc</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This just does <code class="code"><a id="wrglossary.11545"></a><a href="#glo:Glossentrydesc"><code class="csfmt">\Glossentrydesc</code></a>{entry-label}</code> followed by the <a id="wrglossary.11546"></a><a href="#glo:dual.postdeschook">post-description hook</a>. There is then a paragraph break followed by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11547"></a><code class="code"><dfn id="glo:glstopicPostSkip"><code class="csfmt">\glstopicPostSkip</code></dfn></code></div><!-- end of pinnedbox -->
+ regardless of whether or not the description was displayed. This defaults to <code class="csfmt">\smallskip</code>. This is then followed by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11548"></a><code class="code"><dfn id="glo:glstopicLoc"><code class="csfmt">\glstopicLoc</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which may be used to display the <a id="wrglossary.11549"></a><a href="#glo:dual.locationlist">location list</a>, but does nothing by default.<p>
+The sub-entries first set up the paragraph and hanging indentations using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11550"></a><code class="code"><dfn id="glo:glstopicAssignSubIndent"><code class="csfmt">\glstopicAssignSubIndent</code></dfn>{<span class="meta">〈<em class="metainner">level</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11551"></a><code class="code"><dfn id="glo:glstopicAssignWidest"><code class="csfmt">\glstopicAssignWidest</code></dfn>{<span class="meta">〈<em class="metainner">level</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ to determine if a widest name has been set for the given level.<p>
+The sub-entry has its information displayed using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11552"></a><code class="code"><dfn id="glo:glstopicSubItem"><code class="csfmt">\glstopicSubItem</code></dfn>{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This encapsulates the name with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11553"></a><code class="code"><dfn id="glo:glstopicSubNameFont"><code class="csfmt">\glstopicSubNameFont</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ By default this just uses <code class="csfmt">\textbf</code>. This is followed by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11554"></a><code class="code"><dfn id="glo:glstopicSubItemSep"><code class="csfmt">\glstopicSubItemSep</code></dfn></code></div><!-- end of pinnedbox -->
+ which defaults to <code class="csfmt">\quad</code>. The name and separator are passed in the <span class="meta">〈<em class="metainner">text</em>〉</span> argument of: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11555"></a><code class="code"><dfn id="glo:glstopicSubItemBox"><code class="csfmt">\glstopicSubItemBox</code></dfn>{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If a widest name was set for the given level, this will put <span class="meta">〈<em class="metainner">text</em>〉</span> inside a box of that width otherwise it just does <span class="meta">〈<em class="metainner">text</em>〉</span>.<p>
+This is followed by the symbol in parentheses if set. Then, if the description is set, the description and <a id="wrglossary.11556"></a><a href="#glo:dual.postdeschook">post-description hook</a> are displayed followed by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11557"></a><code class="code"><dfn id="glo:glstopicSubPreLocSep"><code class="csfmt">\glstopicSubPreLocSep</code></dfn></code></div><!-- end of pinnedbox -->
+ (This command isn’t used if the description isn’t set.)<p>
+Finally the location list is displayed using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11558"></a><code class="code"><dfn id="glo:glstopicSubLoc"><code class="csfmt">\glstopicSubLoc</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which just does <span class="meta">〈<em class="metainner">location</em>〉</span> by default. <a id="wrglossary.11559"></a><p>
+
+</section><!-- end of section sec:topic -->
+
+<section id="sec:table"><!-- start of section sec:table --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->8.7.4. <span class="styfmt">glossary-table</span> package<div class="labellink"><a href="#sec:table">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<a id="wrglossary.11560"></a>The <a id="wrglossary.11561"></a><dfn id="glo:pkg.glossary-table"><span class="styfmt">glossary-table</span></dfn> package is new to version 1.49 and is still experimental. It automatically loads <a id="wrglossary.11562"></a><a href="#glo:pkg.glossary-longbooktabs"><span class="styfmt">glossary-longbooktabs</span></a>.<p>
+It doesn’t provide any general purpose styles, but instead provides one highly customized style <a id="wrglossary.11563"></a><dfn id="glo:opt.glostyle.table"><span class="glostylefmt">table</span></dfn> designed to work with a supplied command: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11564"></a><code class="code"><dfn id="glo:printunsrttable"><code class="csfmt">\printunsrttable</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code></div><!-- end of pinnedbox -->
+ The aim of this command is to show the glossary as a <a id="wrglossary.11565"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>, where the caption is what would normally be the glossary header (<a id="wrglossary.11566"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a>). What’s normally the table of contents title (<a id="wrglossary.11567"></a><a href="#glo:opt.printgloss.toctitle"><span class="csoptfmt">toctitle</span></a>) will be added to the list of tables instead.<p>
+This internally uses <a id="wrglossary.11568"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> with the style set to <a id="wrglossary.11569"></a><a href="#glo:opt.glostyle.table"><span class="glostylefmt">table</span></a> and is intended for use with <a id="wrglossary.11570"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. It supports up to 1 <a id="wrglossary.11571"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a>, but you will need the <a id="wrglossary.11572"></a><a href="#glo:opt.resource.save-child-count"><span class="csoptfmt">save-child-count</span></a> resource option if you want the level 1 sub-entries to show. Deeper level entries are omitted. If you want any additional filtering, you can redefine: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11573"></a><code class="code"><dfn id="glo:glstableiffilter"><code class="csfmt">\glstableiffilter</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command should do <span class="meta">〈<em class="metainner">true</em>〉</span> if the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> should be skipped, otherwise it should do <span class="meta">〈<em class="metainner">false</em>〉</span>. For example, the following will filter entries that have the category set to <a id="wrglossary.11574"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.11575"></a><a href="#glo:glstableiffilter"><code class="csfmt">\glstableiffilter</code></a>}[1]<span class="comment">% </span>
+ <a id="wrglossary.11576"></a><a href="#glo:glsifcategory"><code class="csfmt">\glsifcategory</code></a>{#1}{general}
+</pre> Note that if this command is redefined to do neither <span class="meta">〈<em class="metainner">true</em>〉</span> nor <span class="meta">〈<em class="metainner">false</em>〉</span> or does both, it will interfere with the width calculations if <a id="wrglossary.11577"></a><a href="#glo:opt.printunsrttab.par"><span class="csoptfmt">par</span></a> isn’t set to the default <a id="wrglossary.11578"></a><a href="#glo:opt.printunsrttab.par"><span class="csoptfmt">par</span></a><span class="optfmt">=false</span>.<p>
+Styles like <a id="wrglossary.11579"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> create a <a id="wrglossary.11580"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> with one entry per row. The <a id="wrglossary.11581"></a><a href="#glo:opt.glostyle.table"><span class="glostylefmt">table</span></a> style allows multiple entries per row. A <span class="qt">“block”</span> indicates a block of columns used to format one entry. One row of the table contains multiple blocks.<p>
+An extra field may be added with the <a id="wrglossary.11582"></a><a href="#glo:opt.printunsrttab.other"><span class="csoptfmt">other</span></a> key. If this value is empty, then no extra field will be added. Block styles that show the description will put this other field in before the description, in the same column as the description. Block styles that don’t show the description, will put the other field after the name, in the same column as the name. Some block styles, such as <a id="wrglossary.11583"></a><a href="#glo:optval.printunsrttab.block-style.symbol-name"><span class="optfmt">symbol-name</span></a> and <a id="wrglossary.11584"></a><a href="#glo:optval.printunsrttab.block-style.symbol-other"><span class="optfmt">symbol-other</span></a> put the other field in its own column.<p>
+The optional argument may have the options that can typically be passed to <a id="wrglossary.11585"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>, except that the <a id="wrglossary.11586"></a><a href="#glo:opt.printgloss.nogroupskip"><span class="csoptfmt">nogroupskip</span></a>, <a id="wrglossary.11587"></a><a href="#glo:opt.printgloss.nonumberlist"><span class="csoptfmt">nonumberlist</span></a> and <a id="wrglossary.11588"></a><a href="#glo:opt.printgloss.style"><span class="csoptfmt">style</span></a> options won’t have an effect. If you want the <a id="wrglossary.11589"></a><a href="#glo:dual.locationlist">location list</a>, it can simply be obtained from the <a id="wrglossary.11590"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a> field in the appropriate style hook.<p>
+Additionally, the following options may also be used.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11591"></a><code class="code"><dfn id="glo:opt.printunsrttab.blocks"><span class="csoptfmt">blocks</span></dfn>=<span class="meta">〈<em class="metainner">n</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>2</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ The value is the number of blocks in the table. The total number of columns in the table will be this value multiplied by the number of columns per block, which is determined by the block style. For example, the <a id="wrglossary.11592"></a><a href="#glo:optval.printunsrttab.block-style.name-desc"><span class="optfmt">name-desc</span></a> has two columns, so if there are three blocks then there will be a total of six columns.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11593"></a><code class="code"><dfn id="glo:opt.printunsrttab.header"><span class="csoptfmt">header</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A boolean option to determine whether or not to show the header row. The header text is produced with one of the following commands: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11594"></a><code class="code"><dfn id="glo:glstablenameheader"><code class="csfmt">\glstablenameheader</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the header for the name column. Just uses <a id="wrglossary.11595"></a><a href="#glo:entryname"><code class="csfmt">\entryname</code></a> by default.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11596"></a><code class="code"><dfn id="glo:glstabledescheader"><code class="csfmt">\glstabledescheader</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the header for the description column for block styles like <a id="wrglossary.11597"></a><a href="#glo:optval.printunsrttab.block-style.name-desc"><span class="optfmt">name-desc</span></a> and <a id="wrglossary.11598"></a><a href="#glo:optval.printunsrttab.block-style.name-symbol-desc"><span class="optfmt">name-symbol-desc</span></a>. Just uses <a id="wrglossary.11599"></a><a href="#glo:descriptionname"><code class="csfmt">\descriptionname</code></a> by default.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11600"></a><code class="code"><dfn id="glo:glstablesymbolheader"><code class="csfmt">\glstablesymbolheader</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the header for the symbol column for block styles like <a id="wrglossary.11601"></a><a href="#glo:optval.printunsrttab.block-style.name-symbol"><span class="optfmt">name-symbol</span></a> and <a id="wrglossary.11602"></a><a href="#glo:optval.printunsrttab.block-style.name-symbol-desc"><span class="optfmt">name-symbol-desc</span></a>. Just uses <a id="wrglossary.11603"></a><a href="#glo:symbolname"><code class="csfmt">\symbolname</code></a> by default.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11604"></a><code class="code"><dfn id="glo:glstableotherheader"><code class="csfmt">\glstableotherheader</code></dfn></code></div><!-- end of pinnedbox -->
+ Expands to the header for the other column. The default definition applies <a id="wrglossary.11605"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> to the other field label.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11606"></a><code class="code"><dfn id="glo:opt.printunsrttab.rules"><span class="csoptfmt">rules</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ A boolean option to determine whether or not to show the horizontal rules (provided by <a id="wrglossary.11607"></a><a href="#glo:pkg.booktabs"><span class="styfmt">booktabs</span></a>). If used with <a id="wrglossary.11608"></a><a href="#glo:opt.printunsrttab.header"><span class="csoptfmt">header</span></a><span class="optfmt">=true</span>, there will be a rule above and below the header row. If used with <a id="wrglossary.11609"></a><a href="#glo:opt.printunsrttab.header"><span class="csoptfmt">header</span></a><span class="optfmt">=false</span>, there will only be one rule at the top of the table. In both cases, there will be a rule at the bottom of the table.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11610"></a><code class="code"><dfn id="glo:opt.printunsrttab.blocksep"><span class="csoptfmt">blocksep</span></dfn>=<span class="meta">〈<em class="metainner">alignment spec</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>|</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ The value is inserted into the alignment specifier list between blocks. For example, the default value of the pipe character will insert a vertical line. Set this value to empty to remove it.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11611"></a><code class="code"><dfn id="glo:opt.printunsrttab.par"><span class="csoptfmt">par</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ Indicates whether or not the columns should be paragraphs. The value may be one of: <span class="optfmt">false</span>, <span class="optfmt">justified</span> or <span class="optfmt">ragged</span>. The default <a id="wrglossary.11612"></a><a href="#glo:opt.printunsrttab.par"><span class="csoptfmt">par</span></a><span class="optfmt">=false</span> will just use one of the column specifiers <code class="code">l</code>, <code class="code">r</code> or <code class="code">c</code>. The other values will use the <code class="code">p</code> specifier, in which case the column widths will be calculated.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11613"></a><code class="code"><dfn id="glo:opt.printunsrttab.other"><span class="csoptfmt">other</span></dfn>=<span class="meta">〈<em class="metainner">field-label</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">empty</em></span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This should be set to the <a id="wrglossary.11614"></a><a href="#glo:dual.internalfieldlabel">internal field label</a> of the other field or to empty if no other field should be included.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11615"></a><code class="code"><dfn id="glo:opt.printunsrttab.init"><span class="csoptfmt">init</span></dfn>={<span class="meta">〈<em class="metainner">code</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">empty</em></span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ The <span class="meta">〈<em class="metainner">code</em>〉</span> will be added shortly before <a id="wrglossary.11616"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> is called and any local changes will be scoped.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11617"></a><code class="code"><dfn id="glo:opt.printunsrttab.block-style"><span class="csoptfmt">block-style</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>name-desc</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ The block style, which may be one of the following:<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.11618"></a><a id="wrglossary.11619"></a><a href="#glo:opt.printunsrttab.block-style"><span class="csoptfmt">block-style</span></a>=<code class="code"><dfn id="glo:optval.printunsrttab.block-style.name-desc"><span class="optfmt">name-desc</span></dfn></code></div><!-- end of optionvaluebox -->
+ Blocks have two columns with the name in the first column of the block and the description in the second. This is the default style.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.11620"></a><a id="wrglossary.11621"></a><a href="#glo:opt.printunsrttab.block-style"><span class="csoptfmt">block-style</span></a>=<code class="code"><dfn id="glo:optval.printunsrttab.block-style.desc-name"><span class="optfmt">desc-name</span></dfn></code></div><!-- end of optionvaluebox -->
+ Blocks have two columns with the description in the first column of the block and the name in the second.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.11622"></a><a id="wrglossary.11623"></a><a href="#glo:opt.printunsrttab.block-style"><span class="csoptfmt">block-style</span></a>=<code class="code"><dfn id="glo:optval.printunsrttab.block-style.name-symbol"><span class="optfmt">name-symbol</span></dfn></code></div><!-- end of optionvaluebox -->
+ Blocks have two columns with the name in the first column of the block and the symbol in the second.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.11624"></a><a id="wrglossary.11625"></a><a href="#glo:opt.printunsrttab.block-style"><span class="csoptfmt">block-style</span></a>=<code class="code"><dfn id="glo:optval.printunsrttab.block-style.symbol-name"><span class="optfmt">symbol-name</span></dfn></code></div><!-- end of optionvaluebox -->
+ Blocks have two columns with the symbol in the first column of the block and the name in the second.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.11626"></a><a id="wrglossary.11627"></a><a href="#glo:opt.printunsrttab.block-style"><span class="csoptfmt">block-style</span></a>=<code class="code"><dfn id="glo:optval.printunsrttab.block-style.name-symbol-desc"><span class="optfmt">name-symbol-desc</span></dfn></code></div><!-- end of optionvaluebox -->
+ Blocks have three columns with the name in the first column of the block, the symbol in the second, and the description in the third.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.11628"></a><a id="wrglossary.11629"></a><a href="#glo:opt.printunsrttab.block-style"><span class="csoptfmt">block-style</span></a>=<code class="code"><dfn id="glo:optval.printunsrttab.block-style.name-desc-symbol"><span class="optfmt">name-desc-symbol</span></dfn></code></div><!-- end of optionvaluebox -->
+ Blocks have three columns with the name in the first column of the block, the description in the second, and the symbol in the third.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.11630"></a><a id="wrglossary.11631"></a><a href="#glo:opt.printunsrttab.block-style"><span class="csoptfmt">block-style</span></a>=<code class="code"><dfn id="glo:optval.printunsrttab.block-style.name"><span class="optfmt">name</span></dfn></code></div><!-- end of optionvaluebox -->
+ Blocks have one column with the name followed by the symbol and description in parentheses, if they have been set.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.11632"></a><a id="wrglossary.11633"></a><a href="#glo:opt.printunsrttab.block-style"><span class="csoptfmt">block-style</span></a>=<code class="code"><dfn id="glo:optval.printunsrttab.block-style.name-other"><span class="optfmt">name-other</span></dfn></code></div><!-- end of optionvaluebox -->
+ This is like <a id="wrglossary.11634"></a><a href="#glo:optval.printunsrttab.block-style.name-desc"><span class="optfmt">name-desc</span></a> but puts the other field in the second column. The description and symbol aren’t shown. Note that you will need to set the <a id="wrglossary.11635"></a><a href="#glo:opt.printunsrttab.other"><span class="csoptfmt">other</span></a> key to the required field, otherwise you will end up with an empty column.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.11636"></a><a id="wrglossary.11637"></a><a href="#glo:opt.printunsrttab.block-style"><span class="csoptfmt">block-style</span></a>=<code class="code"><dfn id="glo:optval.printunsrttab.block-style.other-name"><span class="optfmt">other-name</span></dfn></code></div><!-- end of optionvaluebox -->
+ This is like <a id="wrglossary.11638"></a><a href="#glo:optval.printunsrttab.block-style.desc-name"><span class="optfmt">desc-name</span></a> but puts the other field in the second column. The description and symbol aren’t shown. Note that you will need to set the <a id="wrglossary.11639"></a><a href="#glo:opt.printunsrttab.other"><span class="csoptfmt">other</span></a> key to the required field, otherwise you will end up with an empty column.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.11640"></a><a id="wrglossary.11641"></a><a href="#glo:opt.printunsrttab.block-style"><span class="csoptfmt">block-style</span></a>=<code class="code"><dfn id="glo:optval.printunsrttab.block-style.symbol-other"><span class="optfmt">symbol-other</span></dfn></code></div><!-- end of optionvaluebox -->
+ This is like <a id="wrglossary.11642"></a><a href="#glo:optval.printunsrttab.block-style.name-other"><span class="optfmt">name-other</span></a> but shows the symbol instead of the name.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.11643"></a><a id="wrglossary.11644"></a><a href="#glo:opt.printunsrttab.block-style"><span class="csoptfmt">block-style</span></a>=<code class="code"><dfn id="glo:optval.printunsrttab.block-style.other-symbol"><span class="optfmt">other-symbol</span></dfn></code></div><!-- end of optionvaluebox -->
+ This is like <a id="wrglossary.11645"></a><a href="#glo:optval.printunsrttab.block-style.other-name"><span class="optfmt">other-name</span></a> but shows the symbol instead of the name.<p>
+The block styles alter the way the <a id="wrglossary.11646"></a><a href="#glo:opt.glostyle.table"><span class="glostylefmt">table</span></a> style sets up the <a id="wrglossary.11647"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> environment and the way that the entries are formatted. The top level <a id="wrglossary.11648"></a><a href="#glo:idx.glossarystyle">glossary style</a> command <a id="wrglossary.11649"></a><a href="#glo:glossentry"><code class="csfmt">\glossentry</code></a> is defined to do the block according to the designated block style and then it will follow the block with the child entries, if the <a id="wrglossary.11650"></a><a href="#glo:opt.glosfield.childlist"><span class="csoptfmt">childlist</span></a> field has been set.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+The <a id="wrglossary.11651"></a><a href="#glo:subglossentry"><code class="csfmt">\subglossentry</code></a> command is redefined to do nothing, but it won’t be used as the child entries are all filtered out. If you don’t use the <a id="wrglossary.11652"></a><a href="#glo:opt.resource.save-child-count"><span class="csoptfmt">save-child-count</span></a> resource option, no child entries will be shown. There’s no recursive descent down the <a id="wrglossary.11653"></a><a href="#glo:dual.hierarchicallevel">hierarchical levels</a>. </div><!-- end of information -->
+<p>
+This means that the child entries will be listed at the end of the last column in the block. This can make the column quite wide. The child names aren’t displayed by default but supports the <a id="wrglossary.11654"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> option. The child entries are listed in a <a id="wrglossary.11655"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a> environment, which means they are contained in the same row as their parent and can’t be broken across a page.<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+The remaining commands are undocumented as they are liable to change. </div><!-- end of warning -->
+<p>
+The following example uses the <a id="wrglossary.11656"></a><a href="#glo:optval.printunsrttab.block-style.name"><span class="optfmt">name</span></a> block style, which only has one column per block. The name is followed by the description in parentheses (if set), which is then followed by the child list. I redefined <a id="wrglossary.11657"></a><a href="#glo:glsnamefont"><code class="csfmt">\glsnamefont</code></a> to make the name appear in bold, to highlight it. I’ve used the <a id="wrglossary.11658"></a><a href="#glo:opt.printunsrttab.par"><span class="csoptfmt">par</span></a><span class="optfmt">=ragged</span> option, otherwise the table will be too wide to fit the page. <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>
+ [<a id="wrglossary.11659"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>,<a id="wrglossary.11660"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a><span class="optfmt">=table</span>,<a id="wrglossary.11661"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a>]
+ {glossaries-extra}
+
+<a id="wrglossary.11662"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[
+ <span class="comment">% entries in <a id="wrglossary.11663"></a><a href="#glo:file.example-glossaries-childnoname.bib"><span class="filefmt">example-glossaries-childnoname.bib</span></a>:</span>
+ <a id="wrglossary.11664"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">=example-glossaries-childnoname</span>,
+ <a id="wrglossary.11665"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">=all</span>,
+ <a id="wrglossary.11666"></a><a href="#glo:opt.resource.save-child-count"><span class="csoptfmt">save-child-count</span></a><span class="optfmt">=]</span>
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.11667"></a><a href="#glo:printunsrttable"><code class="csfmt">\printunsrttable</code></a>
+ [
+ <a id="wrglossary.11668"></a><a href="#glo:opt.printunsrttab.block-style"><span class="csoptfmt">block-style</span></a><span class="optfmt">=name</span>,<a id="wrglossary.11669"></a><a href="#glo:opt.printunsrttab.par"><span class="csoptfmt">par</span></a><span class="optfmt">=ragged</span>,
+ <a id="wrglossary.11670"></a><a href="#glo:opt.printgloss.preamble"><span class="csoptfmt">preamble</span></a><span class="optfmt">={Some preamble text}</span>,
+ <a id="wrglossary.11671"></a><a href="#glo:opt.printgloss.postamble"><span class="csoptfmt">postamble</span></a><span class="optfmt">={Some postamble text}</span>,
+ <a id="wrglossary.11672"></a><a href="#glo:opt.printunsrttab.init"><span class="csoptfmt">init</span></a><span class="optfmt">={<span class="comment">% </span> <code class="cmd">\let</code><a id="wrglossary.11673"></a><a href="#glo:glsnamefont"><code class="csfmt">\glsnamefont</code></a><code class="cmd">\textbf</code> <code class="cmd">\def</code><a id="wrglossary.11674"></a><a href="#glo:glstablenameheader"><code class="csfmt">\glstablenameheader</code></a>{Summary}<span class="comment">% </span> }</span>
+ ]
+<code class="cend">\end{document}</code>
+</pre> This creates a table with two entries per row. <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:table"></a>Example 150: Two entries per row with <code class="cmd">\printunsrttable</code> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example150.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example150.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example150.png" type="image/png" width="402" height="399">Example document with a tabular glossary with two entries per row. The child list is in the same cell as the parent..</object> </div><!-- end of resultbox -->
+ Note that each row is as deep as the entry with the most children. So where a row has one column with two children and another with seven, the row is deep enough to accommodate the seven child entries, which leaves a gap below the smaller list of two children.<p>
+<a id="wrglossary.11675"></a><p>
+
+</section><!-- end of section sec:table -->
+
+<section id="sec:accsupp"><!-- start of section sec:accsupp --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->9. Accessibility Support<div class="labellink"><a href="#sec:accsupp">[link]</a></div></h1><!-- end of chapter header -->
+<p>
+The <a id="wrglossary.11676"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package comes with a supplementary package <a id="wrglossary.11677"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> that helps provide accessibility support. The <a id="wrglossary.11678"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides additional support, but only if the <a id="wrglossary.11679"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> package has already been loaded when the relevant commands are defined. The best and simplest way to do this is through the <a id="wrglossary.11680"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a> package option.<p>
+See the <a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/glossaries-user.html#sec:accsupp"><span class="qt">“Accessibility Support”</span></a> chapter in the <a id="wrglossary.11681"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> user guide for further information about <a id="wrglossary.11682"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a>.<p>
+
+</section><!-- end of section sec:accsupp -->
+
+<section id="sec:accessabbr"><!-- start of section sec:accessabbr --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->9.1. Abbreviations<div class="labellink"><a href="#sec:accessabbr">[link]</a></div></h2><!-- end of section header -->
+<p>
+The accessibility fields relating to abbreviations are <a id="wrglossary.11683"></a><a href="#glo:opt.gloskey.shortaccess"><span class="csoptfmt">shortaccess</span></a>, <a id="wrglossary.11684"></a><a href="#glo:opt.gloskey.shortpluralaccess"><span class="csoptfmt">shortpluralaccess</span></a>, <a id="wrglossary.11685"></a><a href="#glo:opt.gloskey.longaccess"><span class="csoptfmt">longaccess</span></a> and <a id="wrglossary.11686"></a><a href="#glo:opt.gloskey.longpluralaccess"><span class="csoptfmt">longpluralaccess</span></a>. These provide the replacement text for the corresponding <a id="wrglossary.11687"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a>, <a id="wrglossary.11688"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a>, <a id="wrglossary.11689"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> and <a id="wrglossary.11690"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> fields. The <a id="wrglossary.11691"></a><a href="#glo:opt.gloskey.access"><span class="csoptfmt">access</span></a> field provides the replacement text for the <a id="wrglossary.11692"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field.<p>
+Some of these accessibility fields are automatically assigned by <a id="wrglossary.11693"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> if they haven’t been set.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11694"></a><code class="code"><dfn id="glo:glsxtrassignactualsetup"><code class="csfmt">\glsxtrassignactualsetup</code></dfn></code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ This command is used to locally redefine common formatting commands so that they can be stripped to obtain only the text. You can add additional commands with <a id="wrglossary.11695"></a><a href="#glo:appto"><code class="csfmt">\appto</code></a>. For example, the following eccentric example has some strange styling in the abbreviation: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.11696"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{foo}{f<a id="wrglossary.11697"></a><a href="#glo:textsuperscript"><code class="csfmt">\textsuperscript</code></a>{o}<a id="wrglossary.11698"></a><a href="#glo:textsubscript"><code class="csfmt">\textsubscript</code></a>{o}}{furry old otters}
+</pre> If an accessibility field is being automatically assigned with text obtained from the short value, then the subscript and superscript commands will need to be stripped. These need to be locally redefined to just do their arguments: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.11699"></a><a href="#glo:appto"><code class="csfmt">\appto</code></a><a id="wrglossary.11700"></a><a href="#glo:glsxtrassignactualsetup"><code class="csfmt">\glsxtrassignactualsetup</code></a>{%
+ <a id="wrglossary.11701"></a><a href="#glo:letcs"><code class="csfmt">\letcs</code></a>{<a id="wrglossary.11702"></a><a href="#glo:textsuperscript"><code class="csfmt">\textsuperscript</code></a>}{@firstofone}%
+ <a id="wrglossary.11703"></a><a href="#glo:letcs"><code class="csfmt">\letcs</code></a>{<a id="wrglossary.11704"></a><a href="#glo:textsubscript"><code class="csfmt">\textsubscript</code></a>}{@firstofone}%
+}
+</pre><p>
+The attributes that specifically relate to accessibility in abbreviations are listed below. The <span class="qt">“actual short value”</span> means the value obtained from the <a id="wrglossary.11705"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> value after any markup commands have have locally redefined using <a id="wrglossary.11706"></a><a href="#glo:glsxtrassignactualsetup"><code class="csfmt">\glsxtrassignactualsetup</code></a>. The actual short value may then be modified by these attributes. Similarly, for the <span class="qt">“actual long value”</span>.<p>
+Finally, if <a id="wrglossary.11707"></a><a href="#glo:opt.gloskey.shortaccess"><span class="csoptfmt">shortaccess</span></a> hasn’t already been set, it will be set to: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.11708"></a><a href="#glo:glsdefaultshortaccess"><code class="csfmt">\glsdefaultshortaccess</code></a>{<span class="meta">〈<em class="metainner">actual long</em>〉</span>}{<span class="meta">〈<em class="metainner">actual short</em>〉</span>}
+</pre> (with <a id="wrglossary.11709"></a><a href="#glo:glsdefaultshortaccess"><code class="csfmt">\glsdefaultshortaccess</code></a> expanded). This command is provided by <a id="wrglossary.11710"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> and is defined to do just {<span class="meta">〈<em class="metainner">actual long</em>〉</span>}. It was redefined by <a id="wrglossary.11711"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42 to do <code class="code">{<span class="meta">〈<em class="metainner">actual long</em>〉</span>} ({<span class="meta">〈<em class="metainner">actual short</em>〉</span>})</code>, but has been reverted back to its original definition in v1.49.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11712"></a><code class="code"><dfn id="glo:opt.catattr.accessinsertdots"><span class="csoptfmt">accessinsertdots</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ If the <a id="wrglossary.11713"></a><a href="#glo:opt.gloskey.shortaccess"><span class="csoptfmt">shortaccess</span></a> key hasn’t been set then this attribute will be checked. If true, the actual short value will have dots inserted (as per <a id="wrglossary.11714"></a><a href="#glo:opt.catattr.insertdots"><span class="csoptfmt">insertdots</span></a>). Note that if this attribute hasn’t been set but <a id="wrglossary.11715"></a><a href="#glo:opt.catattr.insertdots"><span class="csoptfmt">insertdots</span></a> is true (and the <a id="wrglossary.11716"></a><a href="#glo:opt.gloskey.shortaccess"><span class="csoptfmt">shortaccess</span></a> key hasn’t been set), then the actual short value will also have dots inserted.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11717"></a><code class="code"><dfn id="glo:opt.catattr.accessaposplural"><span class="csoptfmt">accessaposplural</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ If the <a id="wrglossary.11718"></a><a href="#glo:opt.gloskey.shortpluralaccess"><span class="csoptfmt">shortpluralaccess</span></a> key hasn’t been set then this attribute will be checked. If true, the actual short plural value will have the apostrophe suffix (similar to <a id="wrglossary.11719"></a><a href="#glo:opt.catattr.aposplural"><span class="csoptfmt">aposplural</span></a> but using <a id="wrglossary.11720"></a><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a> instead of <a id="wrglossary.11721"></a><a href="#glo:abbrvpluralsuffix"><code class="csfmt">\abbrvpluralsuffix</code></a>). Note that if this attribute hasn’t been set but <a id="wrglossary.11722"></a><a href="#glo:opt.catattr.aposplural"><span class="csoptfmt">aposplural</span></a> is true (and the <a id="wrglossary.11723"></a><a href="#glo:opt.gloskey.shortpluralaccess"><span class="csoptfmt">shortpluralaccess</span></a> key hasn’t been set), then the actual short plural value will also have the apostrophe suffix.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11724"></a><code class="code"><dfn id="glo:opt.catattr.accessnoshortplural"><span class="csoptfmt">accessnoshortplural</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ If the <a id="wrglossary.11725"></a><a href="#glo:opt.gloskey.shortpluralaccess"><span class="csoptfmt">shortpluralaccess</span></a> key hasn’t been set and the <a id="wrglossary.11726"></a><a href="#glo:opt.catattr.accessaposplural"><span class="csoptfmt">accessaposplural</span></a> attribute hasn’t been set, then this attribute will be checked. If true, the actual short plural value will be the same as the singular (as <a id="wrglossary.11727"></a><a href="#glo:opt.catattr.noshortplural"><span class="csoptfmt">noshortplural</span></a>). Note that if this attribute hasn’t been set but <a id="wrglossary.11728"></a><a href="#glo:opt.catattr.noshortplural"><span class="csoptfmt">noshortplural</span></a> is true (and the <a id="wrglossary.11729"></a><a href="#glo:opt.gloskey.shortpluralaccess"><span class="csoptfmt">shortpluralaccess</span></a> key hasn’t been set), then the actual short plural value will also be the singular form.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11730"></a><code class="code"><dfn id="glo:opt.catattr.nameshortaccess"><span class="csoptfmt">nameshortaccess</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ If the <a id="wrglossary.11731"></a><a href="#glo:opt.gloskey.access"><span class="csoptfmt">access</span></a> key hasn’t been set and this attribute is true, then the <a id="wrglossary.11732"></a><a href="#glo:opt.gloskey.access"><span class="csoptfmt">access</span></a> field will be set to the same as the <a id="wrglossary.11733"></a><a href="#glo:opt.gloskey.shortaccess"><span class="csoptfmt">shortaccess</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11734"></a><code class="code"><dfn id="glo:opt.catattr.textshortaccess"><span class="csoptfmt">textshortaccess</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ If the <a id="wrglossary.11735"></a><a href="#glo:opt.gloskey.textaccess"><span class="csoptfmt">textaccess</span></a> key hasn’t been set and this attribute is true, then the <a id="wrglossary.11736"></a><a href="#glo:opt.gloskey.textaccess"><span class="csoptfmt">textaccess</span></a> field will be set to the same as the <a id="wrglossary.11737"></a><a href="#glo:opt.gloskey.shortaccess"><span class="csoptfmt">shortaccess</span></a>. Additionally, if the <a id="wrglossary.11738"></a><a href="#glo:opt.gloskey.pluralaccess"><span class="csoptfmt">pluralaccess</span></a> key hasn’t been set, then it will be set to the same as the <a id="wrglossary.11739"></a><a href="#glo:opt.gloskey.shortpluralaccess"><span class="csoptfmt">shortpluralaccess</span></a> value.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.11740"></a><code class="code"><dfn id="glo:opt.catattr.firstshortaccess"><span class="csoptfmt">firstshortaccess</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ If the <a id="wrglossary.11741"></a><a href="#glo:opt.gloskey.firstaccess"><span class="csoptfmt">firstaccess</span></a> key hasn’t been set and this attribute is true, then the <a id="wrglossary.11742"></a><a href="#glo:opt.gloskey.firstaccess"><span class="csoptfmt">firstaccess</span></a> field will be set to the same as the <a id="wrglossary.11743"></a><a href="#glo:opt.gloskey.shortaccess"><span class="csoptfmt">shortaccess</span></a>. Additionally, if the <a id="wrglossary.11744"></a><a href="#glo:opt.gloskey.firstpluralaccess"><span class="csoptfmt">firstpluralaccess</span></a> key hasn’t been set, then it will be set to the same as the <a id="wrglossary.11745"></a><a href="#glo:opt.gloskey.shortpluralaccess"><span class="csoptfmt">shortpluralaccess</span></a> value.<p>
+
+</section><!-- end of section sec:accessabbr -->
+
+<section id="sec:glsaccessfield"><!-- start of section sec:glsaccessfield --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->9.2. Accessibility Wrappers<div class="labellink"><a href="#sec:glsaccessfield">[link]</a></div></h2><!-- end of section header -->
+<p>
+The glossary style commands such as <a id="wrglossary.11746"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a> incorporate accessibility support by using the <code class="csfmt">\glsaccess<span class="meta">〈<em class="metainner">field</em>〉</span></code> commands instead of the corresponding <code class="csfmt">\glsentry<span class="meta">〈<em class="metainner">field</em>〉</span></code> commands.<p>
+If the <a id="wrglossary.11747"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> package hasn’t been loaded or if the relevant accessibility field hasn’t been set, these commands simply do the corresponding <code class="csfmt">\glsentry<span class="meta">〈<em class="metainner">field</em>〉</span></code> command.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11748"></a><code class="code"><dfn id="glo:glsaccessname"><code class="csfmt">\glsaccessname</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11749"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field encapsulated with <a id="wrglossary.11750"></a><a href="#glo:glsnameaccessdisplay"><code class="csfmt">\glsnameaccessdisplay</code></a> or just <a id="wrglossary.11751"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11752"></a><code class="code"><dfn id="glo:Glsaccessname"><code class="csfmt">\Glsaccessname</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11753"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11754"></a><code class="code"><dfn id="glo:GLSaccessname"><code class="csfmt">\GLSaccessname</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11755"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11756"></a><code class="code"><dfn id="glo:glsaccesstext"><code class="csfmt">\glsaccesstext</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11757"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field encapsulated with <a id="wrglossary.11758"></a><a href="#glo:glstextaccessdisplay"><code class="csfmt">\glstextaccessdisplay</code></a> or just <a id="wrglossary.11759"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11760"></a><code class="code"><dfn id="glo:Glsaccesstext"><code class="csfmt">\Glsaccesstext</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11761"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11762"></a><code class="code"><dfn id="glo:GLSaccesstext"><code class="csfmt">\GLSaccesstext</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11763"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11764"></a><code class="code"><dfn id="glo:glsaccessplural"><code class="csfmt">\glsaccessplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11765"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> field encapsulated with <a id="wrglossary.11766"></a><a href="#glo:glspluralaccessdisplay"><code class="csfmt">\glspluralaccessdisplay</code></a> or just <a id="wrglossary.11767"></a><a href="#glo:glsentryplural"><code class="csfmt">\glsentryplural</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11768"></a><code class="code"><dfn id="glo:Glsaccessplural"><code class="csfmt">\Glsaccessplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11769"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11770"></a><code class="code"><dfn id="glo:GLSaccessplural"><code class="csfmt">\GLSaccessplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11771"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11772"></a><code class="code"><dfn id="glo:glsaccessfirst"><code class="csfmt">\glsaccessfirst</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11773"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> field encapsulated with <a id="wrglossary.11774"></a><a href="#glo:glsfirstaccessdisplay"><code class="csfmt">\glsfirstaccessdisplay</code></a> or just <a id="wrglossary.11775"></a><a href="#glo:glsentryfirst"><code class="csfmt">\glsentryfirst</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11776"></a><code class="code"><dfn id="glo:Glsaccessfirst"><code class="csfmt">\Glsaccessfirst</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11777"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11778"></a><code class="code"><dfn id="glo:GLSaccessfirst"><code class="csfmt">\GLSaccessfirst</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11779"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11780"></a><code class="code"><dfn id="glo:glsaccessfirstplural"><code class="csfmt">\glsaccessfirstplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11781"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> field encapsulated with <a id="wrglossary.11782"></a><a href="#glo:glsfirstpluralaccessdisplay"><code class="csfmt">\glsfirstpluralaccessdisplay</code></a> or just <a id="wrglossary.11783"></a><a href="#glo:glsentryfirstplural"><code class="csfmt">\glsentryfirstplural</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11784"></a><code class="code"><dfn id="glo:Glsaccessfirstplural"><code class="csfmt">\Glsaccessfirstplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11785"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11786"></a><code class="code"><dfn id="glo:GLSaccessfirstplural"><code class="csfmt">\GLSaccessfirstplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11787"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11788"></a><code class="code"><dfn id="glo:glsaccesssymbol"><code class="csfmt">\glsaccesssymbol</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11789"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> field encapsulated with <a id="wrglossary.11790"></a><a href="#glo:glssymbolaccessdisplay"><code class="csfmt">\glssymbolaccessdisplay</code></a> or just <a id="wrglossary.11791"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11792"></a><code class="code"><dfn id="glo:Glsaccesssymbol"><code class="csfmt">\Glsaccesssymbol</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11793"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11794"></a><code class="code"><dfn id="glo:GLSaccesssymbol"><code class="csfmt">\GLSaccesssymbol</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11795"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11796"></a><code class="code"><dfn id="glo:glsaccesssymbolplural"><code class="csfmt">\glsaccesssymbolplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11797"></a><a href="#glo:opt.gloskey.symbolplural"><span class="csoptfmt">symbolplural</span></a> field encapsulated with <a id="wrglossary.11798"></a><a href="#glo:glssymbolpluralaccessdisplay"><code class="csfmt">\glssymbolpluralaccessdisplay</code></a> or just <a id="wrglossary.11799"></a><a href="#glo:glsentrysymbolplural"><code class="csfmt">\glsentrysymbolplural</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11800"></a><code class="code"><dfn id="glo:Glsaccesssymbolplural"><code class="csfmt">\Glsaccesssymbolplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11801"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11802"></a><code class="code"><dfn id="glo:GLSaccesssymbolplural"><code class="csfmt">\GLSaccesssymbolplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11803"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11804"></a><code class="code"><dfn id="glo:glsaccessdesc"><code class="csfmt">\glsaccessdesc</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11805"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> field encapsulated with <a id="wrglossary.11806"></a><a href="#glo:glsdescriptionaccessdisplay"><code class="csfmt">\glsdescriptionaccessdisplay</code></a> or just <a id="wrglossary.11807"></a><a href="#glo:glsentrydesc"><code class="csfmt">\glsentrydesc</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11808"></a><code class="code"><dfn id="glo:Glsaccessdesc"><code class="csfmt">\Glsaccessdesc</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11809"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11810"></a><code class="code"><dfn id="glo:GLSaccessdesc"><code class="csfmt">\GLSaccessdesc</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11811"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11812"></a><code class="code"><dfn id="glo:glsaccessdescplural"><code class="csfmt">\glsaccessdescplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11813"></a><a href="#glo:opt.gloskey.descriptionplural"><span class="csoptfmt">descriptionplural</span></a> field encapsulated with <a id="wrglossary.11814"></a><a href="#glo:glsdescriptionpluralaccessdisplay"><code class="csfmt">\glsdescriptionpluralaccessdisplay</code></a> or just <a id="wrglossary.11815"></a><a href="#glo:glsentrydescplural"><code class="csfmt">\glsentrydescplural</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11816"></a><code class="code"><dfn id="glo:Glsaccessdescplural"><code class="csfmt">\Glsaccessdescplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11817"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11818"></a><code class="code"><dfn id="glo:GLSaccessdescplural"><code class="csfmt">\GLSaccessdescplural</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11819"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11820"></a><code class="code"><dfn id="glo:glsaccessshort"><code class="csfmt">\glsaccessshort</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11821"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> field encapsulated with <a id="wrglossary.11822"></a><a href="#glo:glsshortaccessdisplay"><code class="csfmt">\glsshortaccessdisplay</code></a> or just <a id="wrglossary.11823"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11824"></a><code class="code"><dfn id="glo:Glsaccessshort"><code class="csfmt">\Glsaccessshort</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11825"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11826"></a><code class="code"><dfn id="glo:GLSaccessshort"><code class="csfmt">\GLSaccessshort</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11827"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11828"></a><code class="code"><dfn id="glo:glsaccessshortpl"><code class="csfmt">\glsaccessshortpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11829"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> field encapsulated with <a id="wrglossary.11830"></a><a href="#glo:glsshortpluralaccessdisplay"><code class="csfmt">\glsshortpluralaccessdisplay</code></a> or just <a id="wrglossary.11831"></a><a href="#glo:glsentryshortpl"><code class="csfmt">\glsentryshortpl</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11832"></a><code class="code"><dfn id="glo:Glsaccessshortpl"><code class="csfmt">\Glsaccessshortpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11833"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11834"></a><code class="code"><dfn id="glo:GLSaccessshortpl"><code class="csfmt">\GLSaccessshortpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11835"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11836"></a><code class="code"><dfn id="glo:glsaccesslong"><code class="csfmt">\glsaccesslong</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11837"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> field encapsulated with <a id="wrglossary.11838"></a><a href="#glo:glslongaccessdisplay"><code class="csfmt">\glslongaccessdisplay</code></a> or just <a id="wrglossary.11839"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11840"></a><code class="code"><dfn id="glo:Glsaccesslong"><code class="csfmt">\Glsaccesslong</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11841"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11842"></a><code class="code"><dfn id="glo:GLSaccesslong"><code class="csfmt">\GLSaccesslong</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11843"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11844"></a><code class="code"><dfn id="glo:glsaccesslongpl"><code class="csfmt">\glsaccesslongpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11845"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> field encapsulated with <a id="wrglossary.11846"></a><a href="#glo:glslongpluralaccessdisplay"><code class="csfmt">\glslongpluralaccessdisplay</code></a> or just <a id="wrglossary.11847"></a><a href="#glo:glsentrylongpl"><code class="csfmt">\glsentrylongpl</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11848"></a><code class="code"><dfn id="glo:Glsaccesslongpl"><code class="csfmt">\Glsaccesslongpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11849"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11850"></a><code class="code"><dfn id="glo:GLSaccesslongpl"><code class="csfmt">\GLSaccesslongpl</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11851"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11852"></a><code class="code"><dfn id="glo:glsaccessuseri"><code class="csfmt">\glsaccessuseri</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11853"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> field encapsulated with <a id="wrglossary.11854"></a><a href="#glo:glsuseriaccessdisplay"><code class="csfmt">\glsuseriaccessdisplay</code></a> or just <a id="wrglossary.11855"></a><a href="#glo:glsentryuseri"><code class="csfmt">\glsentryuseri</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11856"></a><code class="code"><dfn id="glo:Glsaccessuseri"><code class="csfmt">\Glsaccessuseri</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11857"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11858"></a><code class="code"><dfn id="glo:GLSaccessuseri"><code class="csfmt">\GLSaccessuseri</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11859"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11860"></a><code class="code"><dfn id="glo:glsaccessuserii"><code class="csfmt">\glsaccessuserii</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11861"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a> field encapsulated with <a id="wrglossary.11862"></a><a href="#glo:glsuseriiaccessdisplay"><code class="csfmt">\glsuseriiaccessdisplay</code></a> or just <a id="wrglossary.11863"></a><a href="#glo:glsentryuserii"><code class="csfmt">\glsentryuserii</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11864"></a><code class="code"><dfn id="glo:Glsaccessuserii"><code class="csfmt">\Glsaccessuserii</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11865"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11866"></a><code class="code"><dfn id="glo:GLSaccessuserii"><code class="csfmt">\GLSaccessuserii</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11867"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11868"></a><code class="code"><dfn id="glo:glsaccessuseriii"><code class="csfmt">\glsaccessuseriii</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11869"></a><a href="#glo:opt.gloskey.user3"><span class="csoptfmt">user3</span></a> field encapsulated with <a id="wrglossary.11870"></a><a href="#glo:glsuseriiiaccessdisplay"><code class="csfmt">\glsuseriiiaccessdisplay</code></a> or just <a id="wrglossary.11871"></a><a href="#glo:glsentryuseriii"><code class="csfmt">\glsentryuseriii</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11872"></a><code class="code"><dfn id="glo:Glsaccessuseriii"><code class="csfmt">\Glsaccessuseriii</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11873"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11874"></a><code class="code"><dfn id="glo:GLSaccessuseriii"><code class="csfmt">\GLSaccessuseriii</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11875"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11876"></a><code class="code"><dfn id="glo:glsaccessuseriv"><code class="csfmt">\glsaccessuseriv</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11877"></a><a href="#glo:opt.gloskey.user4"><span class="csoptfmt">user4</span></a> field encapsulated with <a id="wrglossary.11878"></a><a href="#glo:glsuserivaccessdisplay"><code class="csfmt">\glsuserivaccessdisplay</code></a> or just <a id="wrglossary.11879"></a><a href="#glo:glsentryuseriv"><code class="csfmt">\glsentryuseriv</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11880"></a><code class="code"><dfn id="glo:Glsaccessuseriv"><code class="csfmt">\Glsaccessuseriv</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11881"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11882"></a><code class="code"><dfn id="glo:GLSaccessuseriv"><code class="csfmt">\GLSaccessuseriv</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11883"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11884"></a><code class="code"><dfn id="glo:glsaccessuserv"><code class="csfmt">\glsaccessuserv</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11885"></a><a href="#glo:opt.gloskey.user5"><span class="csoptfmt">user5</span></a> field encapsulated with <a id="wrglossary.11886"></a><a href="#glo:glsuservaccessdisplay"><code class="csfmt">\glsuservaccessdisplay</code></a> or just <a id="wrglossary.11887"></a><a href="#glo:glsentryuserv"><code class="csfmt">\glsentryuserv</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11888"></a><code class="code"><dfn id="glo:Glsaccessuserv"><code class="csfmt">\Glsaccessuserv</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11889"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11890"></a><code class="code"><dfn id="glo:GLSaccessuserv"><code class="csfmt">\GLSaccessuserv</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11891"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11892"></a><code class="code"><dfn id="glo:glsaccessuservi"><code class="csfmt">\glsaccessuservi</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11893"></a><a href="#glo:opt.gloskey.user6"><span class="csoptfmt">user6</span></a> field encapsulated with <a id="wrglossary.11894"></a><a href="#glo:glsuserviaccessdisplay"><code class="csfmt">\glsuserviaccessdisplay</code></a> or just <a id="wrglossary.11895"></a><a href="#glo:glsentryuservi"><code class="csfmt">\glsentryuservi</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11896"></a><code class="code"><dfn id="glo:Glsaccessuservi"><code class="csfmt">\Glsaccessuservi</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11897"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11898"></a><code class="code"><dfn id="glo:GLSaccessuservi"><code class="csfmt">\GLSaccessuservi</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11899"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+
+</section><!-- end of section sec:glsaccessfield -->
+
+<section id="sec:glsaccessfmtfield"><!-- start of section sec:glsaccessfmtfield --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->9.3. Inner Formatting Wrappers<div class="labellink"><a href="#sec:glsaccessfmtfield">[link]</a></div></h2><!-- end of section header -->
+<p>
+These <code class="csfmt">\glsaccessfmt<span class="meta">〈<em class="metainner">field</em>〉</span></code> commands are similar to the corresponding <code class="csfmt">\glsaccess<span class="meta">〈<em class="metainner">field</em>〉</span></code> commands described above, but they format the field value using <a id="wrglossary.11900"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a>, <a id="wrglossary.11901"></a><a href="#glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></a> or <a id="wrglossary.11902"></a><a href="#glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></a> with the supplied <span class="meta">〈<em class="metainner">cs</em>〉</span> encapsulating command.<p>
+The default entry display style <a id="wrglossary.11903"></a><a href="#glo:glsgenentryfmt"><code class="csfmt">\glsgenentryfmt</code></a>, and the predefined abbreviation styles all incorporate accessibility support by using these commands in order to support the <a id="wrglossary.11904"></a><a href="#glo:dual.innerformatting">inner formatting</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11905"></a><code class="code"><dfn id="glo:glsaccessfmtname"><code class="csfmt">\glsaccessfmtname</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11906"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field formatted with <span class="meta">〈<em class="metainner">cs</em>〉</span> and, if accessibility support provided, encapsulated with <a id="wrglossary.11907"></a><a href="#glo:glsnameaccessdisplay"><code class="csfmt">\glsnameaccessdisplay</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11908"></a><code class="code"><dfn id="glo:Glsaccessfmtname"><code class="csfmt">\Glsaccessfmtname</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11909"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11910"></a><code class="code"><dfn id="glo:GLSaccessfmtname"><code class="csfmt">\GLSaccessfmtname</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11911"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11912"></a><code class="code"><dfn id="glo:glsaccessfmttext"><code class="csfmt">\glsaccessfmttext</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11913"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field formatted with <span class="meta">〈<em class="metainner">cs</em>〉</span> and, if accessibility support provided, encapsulated with <a id="wrglossary.11914"></a><a href="#glo:glstextaccessdisplay"><code class="csfmt">\glstextaccessdisplay</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11915"></a><code class="code"><dfn id="glo:Glsaccessfmttext"><code class="csfmt">\Glsaccessfmttext</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11916"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11917"></a><code class="code"><dfn id="glo:GLSaccessfmttext"><code class="csfmt">\GLSaccessfmttext</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11918"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11919"></a><code class="code"><dfn id="glo:glsaccessfmtplural"><code class="csfmt">\glsaccessfmtplural</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11920"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> field formatted with <span class="meta">〈<em class="metainner">cs</em>〉</span> and, if accessibility support provided, encapsulated with <a id="wrglossary.11921"></a><a href="#glo:glspluralaccessdisplay"><code class="csfmt">\glspluralaccessdisplay</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11922"></a><code class="code"><dfn id="glo:Glsaccessfmtplural"><code class="csfmt">\Glsaccessfmtplural</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11923"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11924"></a><code class="code"><dfn id="glo:GLSaccessfmtplural"><code class="csfmt">\GLSaccessfmtplural</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11925"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11926"></a><code class="code"><dfn id="glo:glsaccessfmtfirst"><code class="csfmt">\glsaccessfmtfirst</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11927"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> field formatted with <span class="meta">〈<em class="metainner">cs</em>〉</span> and, if accessibility support provided, encapsulated with <a id="wrglossary.11928"></a><a href="#glo:glsfirstaccessdisplay"><code class="csfmt">\glsfirstaccessdisplay</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11929"></a><code class="code"><dfn id="glo:Glsaccessfmtfirst"><code class="csfmt">\Glsaccessfmtfirst</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11930"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11931"></a><code class="code"><dfn id="glo:GLSaccessfmtfirst"><code class="csfmt">\GLSaccessfmtfirst</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11932"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11933"></a><code class="code"><dfn id="glo:glsaccessfmtfirstplural"><code class="csfmt">\glsaccessfmtfirstplural</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11934"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> field formatted with <span class="meta">〈<em class="metainner">cs</em>〉</span> and, if accessibility support provided, encapsulated with <a id="wrglossary.11935"></a><a href="#glo:glsfirstpluralaccessdisplay"><code class="csfmt">\glsfirstpluralaccessdisplay</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11936"></a><code class="code"><dfn id="glo:Glsaccessfmtfirstplural"><code class="csfmt">\Glsaccessfmtfirstplural</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11937"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11938"></a><code class="code"><dfn id="glo:GLSaccessfmtfirstplural"><code class="csfmt">\GLSaccessfmtfirstplural</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11939"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11940"></a><code class="code"><dfn id="glo:glsaccessfmtsymbol"><code class="csfmt">\glsaccessfmtsymbol</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11941"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> field formatted with <span class="meta">〈<em class="metainner">cs</em>〉</span> and, if accessibility support provided, encapsulated with <a id="wrglossary.11942"></a><a href="#glo:glssymbolaccessdisplay"><code class="csfmt">\glssymbolaccessdisplay</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11943"></a><code class="code"><dfn id="glo:Glsaccessfmtsymbol"><code class="csfmt">\Glsaccessfmtsymbol</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11944"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11945"></a><code class="code"><dfn id="glo:GLSaccessfmtsymbol"><code class="csfmt">\GLSaccessfmtsymbol</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11946"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11947"></a><code class="code"><dfn id="glo:glsaccessfmtsymbolplural"><code class="csfmt">\glsaccessfmtsymbolplural</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11948"></a><a href="#glo:opt.gloskey.symbolplural"><span class="csoptfmt">symbolplural</span></a> field formatted with <span class="meta">〈<em class="metainner">cs</em>〉</span> and, if accessibility support provided, encapsulated with <a id="wrglossary.11949"></a><a href="#glo:glssymbolpluralaccessdisplay"><code class="csfmt">\glssymbolpluralaccessdisplay</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11950"></a><code class="code"><dfn id="glo:Glsaccessfmtsymbolplural"><code class="csfmt">\Glsaccessfmtsymbolplural</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11951"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11952"></a><code class="code"><dfn id="glo:GLSaccessfmtsymbolplural"><code class="csfmt">\GLSaccessfmtsymbolplural</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11953"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11954"></a><code class="code"><dfn id="glo:glsaccessfmtdesc"><code class="csfmt">\glsaccessfmtdesc</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11955"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> field formatted with <span class="meta">〈<em class="metainner">cs</em>〉</span> and, if accessibility support provided, encapsulated with <a id="wrglossary.11956"></a><a href="#glo:glsdescriptionaccessdisplay"><code class="csfmt">\glsdescriptionaccessdisplay</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11957"></a><code class="code"><dfn id="glo:Glsaccessfmtdesc"><code class="csfmt">\Glsaccessfmtdesc</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11958"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11959"></a><code class="code"><dfn id="glo:GLSaccessfmtdesc"><code class="csfmt">\GLSaccessfmtdesc</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11960"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11961"></a><code class="code"><dfn id="glo:glsaccessfmtdescplural"><code class="csfmt">\glsaccessfmtdescplural</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11962"></a><a href="#glo:opt.gloskey.descriptionplural"><span class="csoptfmt">descriptionplural</span></a> field formatted with <span class="meta">〈<em class="metainner">cs</em>〉</span> and, if accessibility support provided, encapsulated with <a id="wrglossary.11963"></a><a href="#glo:glsdescriptionpluralaccessdisplay"><code class="csfmt">\glsdescriptionpluralaccessdisplay</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11964"></a><code class="code"><dfn id="glo:Glsaccessfmtdescplural"><code class="csfmt">\Glsaccessfmtdescplural</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11965"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11966"></a><code class="code"><dfn id="glo:GLSaccessfmtdescplural"><code class="csfmt">\GLSaccessfmtdescplural</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11967"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11968"></a><code class="code"><dfn id="glo:glsaccessfmtshort"><code class="csfmt">\glsaccessfmtshort</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11969"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> field formatted with <span class="meta">〈<em class="metainner">cs</em>〉</span> and, if accessibility support provided, encapsulated with <a id="wrglossary.11970"></a><a href="#glo:glsshortaccessdisplay"><code class="csfmt">\glsshortaccessdisplay</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11971"></a><code class="code"><dfn id="glo:Glsaccessfmtshort"><code class="csfmt">\Glsaccessfmtshort</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11972"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11973"></a><code class="code"><dfn id="glo:GLSaccessfmtshort"><code class="csfmt">\GLSaccessfmtshort</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11974"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11975"></a><code class="code"><dfn id="glo:glsaccessfmtshortpl"><code class="csfmt">\glsaccessfmtshortpl</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11976"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> field formatted with <span class="meta">〈<em class="metainner">cs</em>〉</span> and, if accessibility support provided, encapsulated with <a id="wrglossary.11977"></a><a href="#glo:glsshortpluralaccessdisplay"><code class="csfmt">\glsshortpluralaccessdisplay</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11978"></a><code class="code"><dfn id="glo:Glsaccessfmtshortpl"><code class="csfmt">\Glsaccessfmtshortpl</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11979"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11980"></a><code class="code"><dfn id="glo:GLSaccessfmtshortpl"><code class="csfmt">\GLSaccessfmtshortpl</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11981"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11982"></a><code class="code"><dfn id="glo:glsaccessfmtlong"><code class="csfmt">\glsaccessfmtlong</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11983"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> field formatted with <span class="meta">〈<em class="metainner">cs</em>〉</span> and, if accessibility support provided, encapsulated with <a id="wrglossary.11984"></a><a href="#glo:glslongaccessdisplay"><code class="csfmt">\glslongaccessdisplay</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11985"></a><code class="code"><dfn id="glo:Glsaccessfmtlong"><code class="csfmt">\Glsaccessfmtlong</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11986"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11987"></a><code class="code"><dfn id="glo:GLSaccessfmtlong"><code class="csfmt">\GLSaccessfmtlong</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11988"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11989"></a><code class="code"><dfn id="glo:glsaccessfmtlongpl"><code class="csfmt">\glsaccessfmtlongpl</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11990"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> field formatted with <span class="meta">〈<em class="metainner">cs</em>〉</span> and, if accessibility support provided, encapsulated with <a id="wrglossary.11991"></a><a href="#glo:glslongpluralaccessdisplay"><code class="csfmt">\glslongpluralaccessdisplay</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11992"></a><code class="code"><dfn id="glo:Glsaccessfmtlongpl"><code class="csfmt">\Glsaccessfmtlongpl</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11993"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11994"></a><code class="code"><dfn id="glo:GLSaccessfmtlongpl"><code class="csfmt">\GLSaccessfmtlongpl</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.11995"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11996"></a><code class="code"><dfn id="glo:glsaccessfmtuseri"><code class="csfmt">\glsaccessfmtuseri</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.11997"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> field formatted with <span class="meta">〈<em class="metainner">cs</em>〉</span> and, if accessibility support provided, encapsulated with <a id="wrglossary.11998"></a><a href="#glo:glsuseriaccessdisplay"><code class="csfmt">\glsuseriaccessdisplay</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.11999"></a><code class="code"><dfn id="glo:Glsaccessfmtuseri"><code class="csfmt">\Glsaccessfmtuseri</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.12000"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12001"></a><code class="code"><dfn id="glo:GLSaccessfmtuseri"><code class="csfmt">\GLSaccessfmtuseri</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.12002"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12003"></a><code class="code"><dfn id="glo:glsaccessfmtuserii"><code class="csfmt">\glsaccessfmtuserii</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.12004"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a> field formatted with <span class="meta">〈<em class="metainner">cs</em>〉</span> and, if accessibility support provided, encapsulated with <a id="wrglossary.12005"></a><a href="#glo:glsuseriiaccessdisplay"><code class="csfmt">\glsuseriiaccessdisplay</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12006"></a><code class="code"><dfn id="glo:Glsaccessfmtuserii"><code class="csfmt">\Glsaccessfmtuserii</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.12007"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12008"></a><code class="code"><dfn id="glo:GLSaccessfmtuserii"><code class="csfmt">\GLSaccessfmtuserii</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.12009"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12010"></a><code class="code"><dfn id="glo:glsaccessfmtuseriii"><code class="csfmt">\glsaccessfmtuseriii</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.12011"></a><a href="#glo:opt.gloskey.user3"><span class="csoptfmt">user3</span></a> field formatted with <span class="meta">〈<em class="metainner">cs</em>〉</span> and, if accessibility support provided, encapsulated with <a id="wrglossary.12012"></a><a href="#glo:glsuseriiiaccessdisplay"><code class="csfmt">\glsuseriiiaccessdisplay</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12013"></a><code class="code"><dfn id="glo:Glsaccessfmtuseriii"><code class="csfmt">\Glsaccessfmtuseriii</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.12014"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12015"></a><code class="code"><dfn id="glo:GLSaccessfmtuseriii"><code class="csfmt">\GLSaccessfmtuseriii</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.12016"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12017"></a><code class="code"><dfn id="glo:glsaccessfmtuseriv"><code class="csfmt">\glsaccessfmtuseriv</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.12018"></a><a href="#glo:opt.gloskey.user4"><span class="csoptfmt">user4</span></a> field formatted with <span class="meta">〈<em class="metainner">cs</em>〉</span> and, if accessibility support provided, encapsulated with <a id="wrglossary.12019"></a><a href="#glo:glsuserivaccessdisplay"><code class="csfmt">\glsuserivaccessdisplay</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12020"></a><code class="code"><dfn id="glo:Glsaccessfmtuseriv"><code class="csfmt">\Glsaccessfmtuseriv</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.12021"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12022"></a><code class="code"><dfn id="glo:GLSaccessfmtuseriv"><code class="csfmt">\GLSaccessfmtuseriv</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.12023"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12024"></a><code class="code"><dfn id="glo:glsaccessfmtuserv"><code class="csfmt">\glsaccessfmtuserv</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.12025"></a><a href="#glo:opt.gloskey.user5"><span class="csoptfmt">user5</span></a> field formatted with <span class="meta">〈<em class="metainner">cs</em>〉</span> and, if accessibility support provided, encapsulated with <a id="wrglossary.12026"></a><a href="#glo:glsuservaccessdisplay"><code class="csfmt">\glsuservaccessdisplay</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12027"></a><code class="code"><dfn id="glo:Glsaccessfmtuserv"><code class="csfmt">\Glsaccessfmtuserv</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.12028"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12029"></a><code class="code"><dfn id="glo:GLSaccessfmtuserv"><code class="csfmt">\GLSaccessfmtuserv</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.12030"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12031"></a><code class="code"><dfn id="glo:glsaccessfmtuservi"><code class="csfmt">\glsaccessfmtuservi</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This shows the <a id="wrglossary.12032"></a><a href="#glo:opt.gloskey.user6"><span class="csoptfmt">user6</span></a> field formatted with <span class="meta">〈<em class="metainner">cs</em>〉</span> and, if accessibility support provided, encapsulated with <a id="wrglossary.12033"></a><a href="#glo:glsuserviaccessdisplay"><code class="csfmt">\glsuserviaccessdisplay</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12034"></a><code class="code"><dfn id="glo:Glsaccessfmtuservi"><code class="csfmt">\Glsaccessfmtuservi</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.12035"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12036"></a><code class="code"><dfn id="glo:GLSaccessfmtuservi"><code class="csfmt">\GLSaccessfmtuservi</code></dfn>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As above but <a id="wrglossary.12037"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+
+</section><!-- end of section sec:glsaccessfmtfield -->
+
+<section id="sec:categories"><!-- start of section sec:categories --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->10. Categories<div class="labellink"><a href="#sec:categories">[link]</a></div></h1><!-- end of chapter header -->
+<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+For multi-entry categories, see §<a href="#sec:multiglscategory">7.8</a>. </div><!-- end of information -->
+<p>
+Each entry defined by <a id="wrglossary.12038"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> (or commands that internally use it such as <a id="wrglossary.12039"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>) is assigned a category through the <a id="wrglossary.12040"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> key. You may add any category that you like, but since the category is a label used in the creation of some control sequences, avoid problematic characters within the category label. (So take care if you have <a id="wrglossary.12041"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> shorthands on that make some characters active.)<p>
+The use of categories can give you more control over the way entries are displayed in the text or glossary. Note that an entry’s category is independent of the glossary type. Be careful not to confuse <a id="wrglossary.12042"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> with <a id="wrglossary.12043"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12044"></a><code class="code"><dfn id="glo:glscategory"><code class="csfmt">\glscategory</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Expands to the category of the given entry or does nothing if the entry doesn’t exist (analogous to <a id="wrglossary.12045"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a>).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12046"></a><code class="code"><dfn id="glo:glsifcategory"><code class="csfmt">\glsifcategory</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Tests if the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> has the <a id="wrglossary.12047"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> set to <span class="meta">〈<em class="metainner">category</em>〉</span>.<p>
+An entry may have its <a id="wrglossary.12048"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> field changed using commands such as <a id="wrglossary.12049"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a> (see §<a href="#sec:setfields">3.5</a>). In addition, the following commands are provided to batch set the <a id="wrglossary.12050"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> for a collection of entries.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12051"></a><code class="code"><dfn id="glo:glsxtrsetcategory"><code class="csfmt">\glsxtrsetcategory</code></dfn>{<span class="meta">〈<em class="metainner">entry-labels</em>〉</span>}{<span class="meta">〈<em class="metainner">category-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Globally sets the <a id="wrglossary.12052"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> field to the fully expanded <span class="meta">〈<em class="metainner">category-label</em>〉</span> for each entry listed in <span class="meta">〈<em class="metainner">entry-labels</em>〉</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12053"></a><code class="code"><dfn id="glo:glsxtrsetcategoryforall"><code class="csfmt">\glsxtrsetcategoryforall</code></dfn>{<span class="meta">〈<em class="metainner">glossary-labels</em>〉</span>}{<span class="meta">〈<em class="metainner">category-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Globally sets the <a id="wrglossary.12054"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> field to the fully expanded <span class="meta">〈<em class="metainner">category-label</em>〉</span> for each entry belonging to the <a id="wrglossary.12055"></a><a href="#glo:dual.glossary">glossaries</a> listed in <span class="meta">〈<em class="metainner">glossary-labels</em>〉</span>.<p>
+There are also some iterative commands available:<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12056"></a><code class="code"><dfn id="glo:glsforeachincategory"><code class="csfmt">\glsforeachincategory</code></dfn>[<span class="meta">〈<em class="metainner">glossary-types</em>〉</span>]{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">glossary-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">label-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">body</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This iterates through all entries in the <a id="wrglossary.12057"></a><a href="#glo:dual.glossary">glossaries</a> identified by the comma-separated list <span class="meta">〈<em class="metainner">glossary-labels</em>〉</span> that have the category given by <span class="meta">〈<em class="metainner">category-label</em>〉</span> and performs <span class="meta">〈<em class="metainner">body</em>〉</span> for each match. Within <span class="meta">〈<em class="metainner">body</em>〉</span>, you can use <span class="meta">〈<em class="metainner">glossary-cs</em>〉</span> and <span class="meta">〈<em class="metainner">label-cs</em>〉</span> (which much be control sequences) to access the current glossary and entry label. If <span class="meta">〈<em class="metainner">glossary-labels</em>〉</span> is omitted, all glossaries are assumed.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12058"></a><code class="code"><dfn id="glo:glsforeachwithattribute"><code class="csfmt">\glsforeachwithattribute</code></dfn>[<span class="meta">〈<em class="metainner">glossary-types</em>〉</span>]{<span class="meta">〈<em class="metainner">attribute-label</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute-value</em>〉</span>}{<span class="meta">〈<em class="metainner">glossary-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">label-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">body</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This iterates over all entries in the given list of <a id="wrglossary.12059"></a><a href="#glo:dual.glossary">glossaries</a> that have a category with the given <span class="meta">〈<em class="metainner">attribute-label</em>〉</span> set to <span class="meta">〈<em class="metainner">attribute-value</em>〉</span> and performs <span class="meta">〈<em class="metainner">body</em>〉</span> at each iteration. If <span class="meta">〈<em class="metainner">glossary-types</em>〉</span> is omitted, the list of all non-<a id="wrglossary.12060"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a> is assumed. The remaining arguments are as for <a id="wrglossary.12061"></a><a href="#glo:glsforeachincategory"><code class="csfmt">\glsforeachincategory</code></a>.<p>
+
+</section><!-- end of section sec:categories -->
+
+<section id="sec:knowncategories"><!-- start of section sec:knowncategories --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->10.1. Known Categories<div class="labellink"><a href="#sec:knowncategories">[link]</a></div></h2><!-- end of section header -->
+<p>
+These are the category labels that are set or referenced by <a id="wrglossary.12062"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12063"></a><code class="code"><dfn id="glo:opt.cat.general"><span class="csoptfmt">general</span></dfn></code></div><!-- end of settingsbox -->
+ The default category assumed by <a id="wrglossary.12064"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12065"></a><code class="code"><dfn id="glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></dfn></code></div><!-- end of settingsbox -->
+ The default category assumed by <a id="wrglossary.12066"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12067"></a><code class="code"><dfn id="glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></dfn></code></div><!-- end of settingsbox -->
+ The default category assumed by <a id="wrglossary.12068"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12069"></a><code class="code"><dfn id="glo:opt.cat.index"><span class="csoptfmt">index</span></dfn></code></div><!-- end of settingsbox -->
+ The default category assumed by <a id="wrglossary.12070"></a><a href="#glo:newterm"><code class="csfmt">\newterm</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12071"></a><code class="code"><dfn id="glo:opt.cat.symbol"><span class="csoptfmt">symbol</span></dfn></code></div><!-- end of settingsbox -->
+ The default category assumed by <a id="wrglossary.12072"></a><a href="#glo:glsxtrnewsymbol"><code class="csfmt">\glsxtrnewsymbol</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12073"></a><code class="code"><dfn id="glo:opt.cat.number"><span class="csoptfmt">number</span></dfn></code></div><!-- end of settingsbox -->
+ The default category assumed by <a id="wrglossary.12074"></a><a href="#glo:glsxtrnewnumber"><code class="csfmt">\glsxtrnewnumber</code></a>.<p>
+
+</section><!-- end of section sec:knowncategories -->
+
+<section id="sec:attributes"><!-- start of section sec:attributes --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->10.2. Attributes<div class="labellink"><a href="#sec:attributes">[link]</a></div></h2><!-- end of section header -->
+<p>
+Each category may have a set of attributes, where each attribute has an associated value for its given category. An entry’s attribute set corresponds to the attributes associated with the entry’s category.<p>
+As with the category, the attribute name is also a label. You can provide your own custom attributes, which you can set and access with the commands described in §<a href="#sec:attributecmds">10.2.2</a>.<p>
+
+</section><!-- end of section sec:attributes -->
+
+<section id="sec:knownattributes"><!-- start of section sec:knownattributes --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->10.2.1. Known Attributes<div class="labellink"><a href="#sec:knownattributes">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+This section lists attributes that <a id="wrglossary.12075"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> sets or accesses. If an attribute hasn’t been set, a default is assumed. For boolean attributes, the test may simply be to determine if the attribute has been set to <code class="code">true</code>, in which case any other value or a missing value will be interpreted as false. Conversely, the test may be to determine if the attribute has been set to <code class="code">false</code>, in which case any other value or a missing value will be interpreted as true.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+See §<a href="#sec:multiglscategory">7.8</a> for attributes relating to multi-entry categories. </div><!-- end of information -->
+<p>
+
+</section><!-- end of section sec:knownattributes -->
+
+<section id="sec:abbrattr"><!-- start of section sec:abbrattr --><div class="tomain"><a href="#main">[top]</a></div>
+<h4><!-- start of subsubsection header -->10.2.1.1. Abbreviation Attributes<div class="labellink"><a href="#sec:abbrattr">[link]</a></div></h4><!-- end of subsubsection header -->
+<p>
+See §<a href="#sec:accessabbr">9.1</a> for abbreviation accessibility attributes.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12076"></a><code class="code"><dfn id="glo:opt.catattr.regular"><span class="csoptfmt">regular</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ This attribute indicates whether or not an entry should be considered a regular entry. This enables <a id="wrglossary.12077"></a><a href="#glo:glsentryfmt"><code class="csfmt">\glsentryfmt</code></a> to determine whether to use <a id="wrglossary.12078"></a><a href="#glo:glsgenentryfmt"><code class="csfmt">\glsgenentryfmt</code></a> or <a id="wrglossary.12079"></a><a href="#glo:glsxtrgenabbrvfmt"><code class="csfmt">\glsxtrgenabbrvfmt</code></a>.<p>
+The <a id="wrglossary.12080"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a> and <a id="wrglossary.12081"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a> categories have the <a id="wrglossary.12082"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute automatically set to <code class="code">true</code>. Some abbreviation styles change this value.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12083"></a><code class="code"><dfn id="glo:opt.catattr.discardperiod"><span class="csoptfmt">discardperiod</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ If set to <span class="qt">“true”</span>, the <a id="wrglossary.12084"></a><a href="#glo:dual.postlinkhook">post-link hook</a> will discard a <a id="wrglossary.12085"></a><a href="#glo:idx.fullstop">full stop</a> that follows <span style="font-style: italic; font-variant: normal; ">non-plural</span> commands like <a id="wrglossary.12086"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or <a id="wrglossary.12087"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>(see §<a href="#sec:postlinkhook">5.5.4</a>).<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+This attribute doesn’t apply to the accessibility fields. See §<a href="#sec:accessabbr">9.1</a> for attributes related to accessibility support for abbreviations. </div><!-- end of information -->
+<p>
+Note that this can cause a problem if you access a field that doesn’t end with a full stop. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.12088"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>
+ [<a id="wrglossary.12089"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={German Speaking <code class="cmd">\TeX</code><code class="cmd">\ </code>User Group}</span>]
+ {dante}{DANTE e.V.}{Deutschsprachige Anwendervereinigung
+ <code class="cmd">\TeX</code><code class="cmd">\ </code>e.V.}
+</pre> Here the <a id="wrglossary.12090"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> and <a id="wrglossary.12091"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> fields end with a full stop, but the <a id="wrglossary.12092"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> field doesn’t. The simplest solution in this situation is to put the sentence terminator in the final optional argument. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.12093"></a><a href="#glo:glsuseri"><code class="csfmt">\glsuseri</code></a>{dante}[.]
+</pre> This will bring the punctuation character inside the <a id="wrglossary.12094"></a><a href="#glo:dual.linktext">link text</a> and it won’t be discarded.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12095"></a><code class="code"><dfn id="glo:opt.catattr.pluraldiscardperiod"><span class="csoptfmt">pluraldiscardperiod</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ If this attribute is set to <span class="qt">“true”</span> <span style="font-style: italic; font-variant: normal; ">and</span> the <a id="wrglossary.12096"></a><a href="#glo:opt.catattr.discardperiod"><span class="csoptfmt">discardperiod</span></a> attribute is set to <span class="qt">“true”</span>, this will behave as above for the plural commands like <a id="wrglossary.12097"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> or <a id="wrglossary.12098"></a><a href="#glo:glsplural"><code class="csfmt">\glsplural</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12099"></a><code class="code"><dfn id="glo:opt.catattr.retainfirstuseperiod"><span class="csoptfmt">retainfirstuseperiod</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ If this attribute is set to <span class="qt">“true”</span> then the discard is determined by <a id="wrglossary.12100"></a><a href="#glo:glsxtrdiscardperiodretainfirstuse"><code class="csfmt">\glsxtrdiscardperiodretainfirstuse</code></a>, regardless of the <a id="wrglossary.12101"></a><a href="#glo:opt.catattr.discardperiod"><span class="csoptfmt">discardperiod</span></a> or <a id="wrglossary.12102"></a><a href="#glo:opt.catattr.pluraldiscardperiod"><span class="csoptfmt">pluraldiscardperiod</span></a> attributes. This is useful for <span class="meta">〈<em class="metainner">short</em>〉</span> (<span class="meta">〈<em class="metainner">long</em>〉</span>) abbreviation styles where only the short form has a trailing <a id="wrglossary.12103"></a><a href="#glo:idx.fullstop">full stop</a>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+This attribute doesn’t apply to the accessibility fields. See §<a href="#sec:accessabbr">9.1</a> for attributes related to accessibility support for abbreviations. </div><!-- end of information -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12104"></a><code class="code"><dfn id="glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ If this attribute is set to <span class="qt">“true”</span> any entry defined using <a id="wrglossary.12105"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> will automatically have spaces in the long form replaced with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12106"></a><code class="code"><dfn id="glo:glsxtrwordsep"><code class="csfmt">\glsxtrwordsep</code></dfn></code></div><!-- end of pinnedbox -->
+ and each word is encapsulated with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12107"></a><code class="code"><dfn id="glo:glsxtrword"><code class="csfmt">\glsxtrword</code></dfn>{<span class="meta">〈<em class="metainner">word</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.12108"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{<a id="wrglossary.12109"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a>}{<a id="wrglossary.12110"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a>}{true}
+<a id="wrglossary.12111"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ip}{IP}{Internet Protocol}
+</pre> is essentially the same as <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.12112"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>{ip}{IP}
+{<a id="wrglossary.12113"></a><a href="#glo:glsxtrword"><code class="csfmt">\glsxtrword</code></a>{Internet}<a id="wrglossary.12114"></a><a href="#glo:glsxtrwordsep"><code class="csfmt">\glsxtrwordsep</code></a><a id="wrglossary.12115"></a><a href="#glo:glsxtrword"><code class="csfmt">\glsxtrword</code></a>{Protocol}}
+</pre> The <span class="qt">“hyphen”</span> styles, such as <a id="wrglossary.12116"></a><a href="#glo:opt.abbrstyle.long-hyphen-short-hyphen"><span class="abbrstylefmt">long-hyphen-short-hyphen</span></a>, take advantage of this markup. If the inserted material (provided in the final argument of <a id="wrglossary.12117"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands) starts with a hyphen then <a id="wrglossary.12118"></a><a href="#glo:glsxtrwordsep"><code class="csfmt">\glsxtrwordsep</code></a> is locally redefined to a hyphen. (The default value is a space). Note that this only applies to commands like <a id="wrglossary.12119"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> and not like <a id="wrglossary.12120"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a>. You can provide your own localised switch, if required. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<code class="cmd">\hyplong</code>}[2][]{%
+ {<code class="cmd">\def</code><a id="wrglossary.12121"></a><a href="#glo:glsxtrwordsep"><code class="csfmt">\glsxtrwordsep</code></a>{-}<a id="wrglossary.12122"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a>[#1]{#2}}}
+</pre><p>
+This setting will also adjust the long plural. This attribute is only applicable to entries defined using <a id="wrglossary.12123"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> (or <a id="wrglossary.12124"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> if it’s using <a id="wrglossary.12125"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>.)<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+This setting may result in the <a id="wrglossary.12126"></a><a href="#glo:glsxtrword"><code class="csfmt">\glsxtrword</code></a> and <a id="wrglossary.12127"></a><a href="#glo:glsxtrwordsep"><code class="csfmt">\glsxtrwordsep</code></a> markup ending up in the <a id="wrglossary.12128"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> field, depending on the style in use. </div><!-- end of important -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12129"></a><code class="code"><dfn id="glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ This is similar to <a id="wrglossary.12130"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a> but applies to the short form. (Only useful for abbreviations that contain spaces.) This attribute is only applicable to entries defined using <a id="wrglossary.12131"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> (or <a id="wrglossary.12132"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> if it’s using <a id="wrglossary.12133"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>.)<p>
+This setting will only adjust the short plural if the <a id="wrglossary.12134"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> key isn’t used. This setting will take precedence over <a id="wrglossary.12135"></a><a href="#glo:opt.catattr.insertdots"><span class="csoptfmt">insertdots</span></a>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+This setting may result in the <a id="wrglossary.12136"></a><a href="#glo:glsxtrword"><code class="csfmt">\glsxtrword</code></a> and <a id="wrglossary.12137"></a><a href="#glo:glsxtrwordsep"><code class="csfmt">\glsxtrwordsep</code></a> markup ending up in the <a id="wrglossary.12138"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> field, depending on the style in use. </div><!-- end of important -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12139"></a><code class="code"><dfn id="glo:opt.catattr.insertdots"><span class="csoptfmt">insertdots</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ If this attribute is set to <span class="qt">“true”</span> any entry defined using <a id="wrglossary.12140"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> will automatically have <a id="wrglossary.12141"></a><a href="#glo:idx.fullstop">full stops</a> inserted after each letter. The entry will be defined with those dots present as though they had been present in the <span class="meta">〈<em class="metainner">short</em>〉</span> argument of <a id="wrglossary.12142"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> (rather than inserting them every time the entry is used). The short plural form defaults to the new dotted version of the original <span class="meta">〈<em class="metainner">short</em>〉</span> form with the plural suffix appended. <span style="font-style: italic; font-variant: normal; ">This setting is incompatible with <a id="wrglossary.12143"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a>.</span> This attribute is only applicable to entries defined using <a id="wrglossary.12144"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> (or <a id="wrglossary.12145"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> if it’s using <a id="wrglossary.12146"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>.)<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+If you explicitly override the short plural using the <a id="wrglossary.12147"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> key, you must explicitly insert the dots yourself (since there’s no way for the code to determine if the plural has a suffix that shouldn’t be followed by a dot). </div><!-- end of important -->
+<p>
+This attribute is best used with the <a id="wrglossary.12148"></a><a href="#glo:opt.catattr.discardperiod"><span class="csoptfmt">discardperiod</span></a> attribute set to <span class="qt">“true”</span>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12149"></a><code class="code"><dfn id="glo:opt.catattr.aposplural"><span class="csoptfmt">aposplural</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ If this attribute is set to <span class="qt">“true”</span>, <a id="wrglossary.12150"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> will insert an apostrophe (’) before the plural suffix for the <span style="font-style: italic; font-variant: normal; ">short</span> plural form (unless explicitly overridden with the <a id="wrglossary.12151"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> key). The long plural form is unaffected by this setting. This setting overrides <a id="wrglossary.12152"></a><a href="#glo:opt.catattr.noshortplural"><span class="csoptfmt">noshortplural</span></a>. This attribute is only applicable to entries defined using <a id="wrglossary.12153"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> (or <a id="wrglossary.12154"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> if it’s using <a id="wrglossary.12155"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>.) Check with your supervisor, publisher or editor if you want to use this attribute as this usage is controversial.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12156"></a><code class="code"><dfn id="glo:opt.catattr.noshortplural"><span class="csoptfmt">noshortplural</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ If this attribute is set to <span class="qt">“true”</span>, <a id="wrglossary.12157"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> won’t append the plural suffix for the short plural form. This means the <a id="wrglossary.12158"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> and <a id="wrglossary.12159"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> values will be the same unless explicitly overridden. <span style="font-style: italic; font-variant: normal; ">This setting is incompatible with <a id="wrglossary.12160"></a><a href="#glo:opt.catattr.aposplural"><span class="csoptfmt">aposplural</span></a>.</span> This attribute is only applicable to entries defined using <a id="wrglossary.12161"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> (or <a id="wrglossary.12162"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> if it’s using <a id="wrglossary.12163"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>.)<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12164"></a><code class="code"><dfn id="glo:opt.catattr.tagging"><span class="csoptfmt">tagging</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ If this attribute is set to <span class="qt">“true”</span>, the tagging command defined by <a id="wrglossary.12165"></a><a href="#glo:GlsXtrEnableInitialTagging"><code class="csfmt">\GlsXtrEnableInitialTagging</code></a> will be activated to use <a id="wrglossary.12166"></a><a href="#glo:glsxtrtagfont"><code class="csfmt">\glsxtrtagfont</code></a> in the glossary (see §<a href="#sec:tagging">4.4</a>)<p>
+
+</section><!-- end of section sec:abbrattr -->
+
+<section id="sec:glsoptsattr"><!-- start of section sec:glsoptsattr --><div class="tomain"><a href="#main">[top]</a></div>
+<h4><!-- start of subsubsection header -->10.2.1.2. Attributes that Alter <code class="csfmt">\glslink</code> Options<div class="labellink"><a href="#sec:glsoptsattr">[link]</a></div></h4><!-- end of subsubsection header -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12167"></a><code class="code"><dfn id="glo:opt.catattr.nohyperfirst"><span class="csoptfmt">nohyperfirst</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ When used with the <a id="wrglossary.12168"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands, if this attribute is set to <code class="code">true</code>, this will automatically suppress the hyperlink on <a id="wrglossary.12169"></a><a href="#glo:dual.firstuse">first use</a>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+This settings can be overridden by explicitly setting the <a id="wrglossary.12170"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a> key on or off in the optional argument of the <a id="wrglossary.12171"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> command. </div><!-- end of information -->
+<p>
+As from version 1.07, <a id="wrglossary.12172"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a>, <a id="wrglossary.12173"></a><a href="#glo:Glsfirst"><code class="csfmt">\Glsfirst</code></a>, <a id="wrglossary.12174"></a><a href="#glo:GLSfirst"><code class="csfmt">\GLSfirst</code></a> and their plural versions (which should ideally behave in a similar way to the <a id="wrglossary.12175"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.12176"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or <a id="wrglossary.12177"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>) now honour this attribute (but not the package-wide <a id="wrglossary.12178"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a><span class="optfmt">=false</span> option, which matches the behaviour of <a id="wrglossary.12179"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>). If you want commands like <a id="wrglossary.12180"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a> to ignore the <a id="wrglossary.12181"></a><a href="#glo:opt.catattr.nohyperfirst"><span class="csoptfmt">nohyperfirst</span></a> attribute then just redefine <a id="wrglossary.12182"></a><a href="#glo:glsxtrchecknohyperfirst"><code class="csfmt">\glsxtrchecknohyperfirst</code></a> to do nothing.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12183"></a><code class="code"><dfn id="glo:opt.catattr.nohypernext"><span class="csoptfmt">nohypernext</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ If set to <code class="code">true</code>, this will automatically set <a id="wrglossary.12184"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span> on <a id="wrglossary.12185"></a><a href="#glo:dual.subsequentuse">subsequent use</a> when using the <a id="wrglossary.12186"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12187"></a><code class="code"><dfn id="glo:opt.catattr.nohyper"><span class="csoptfmt">nohyper</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ If set to <code class="code">true</code>, this will automatically set <a id="wrglossary.12188"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span> when using the <a id="wrglossary.12189"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> or <a id="wrglossary.12190"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12191"></a><code class="code"><dfn id="glo:opt.catattr.indexonlyfirst"><span class="csoptfmt">indexonlyfirst</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ This is similar to the <a id="wrglossary.12192"></a><a href="#glo:opt.indexonlyfirst"><span class="styoptfmt">indexonlyfirst</span></a> package option but only for entries that have a category with this attribute set to <span class="qt">“true”</span>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12193"></a><code class="code"><dfn id="glo:opt.catattr.wrgloss"><span class="csoptfmt">wrgloss</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code></div><!-- end of settingsbox -->
+ When using the <a id="wrglossary.12194"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> or <a id="wrglossary.12195"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands, this will automatically set <a id="wrglossary.12196"></a><a href="#glo:opt.glsopt.wrgloss"><span class="csoptfmt">wrgloss</span></a><span class="optfmt">=after</span> it this attribute is set to <span class="qt">“after”</span>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12197"></a><code class="code"><dfn id="glo:opt.catattr.textformat"><span class="csoptfmt">textformat</span></dfn>=<span class="meta">〈<em class="metainner">cs-name</em>〉</span></code></div><!-- end of settingsbox -->
+ The <a id="wrglossary.12198"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.12199"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands have the <a id="wrglossary.12200"></a><a href="#glo:dual.linktext">link text</a> encapsulated in the argument of <a id="wrglossary.12201"></a><a href="#glo:glstextformat"><code class="csfmt">\glstextformat</code></a> by default (the outer formatting, see §<a href="#sec:glstextformat">5.5.1</a>). If the <a id="wrglossary.12202"></a><a href="#glo:opt.catattr.textformat"><span class="csoptfmt">textformat</span></a> attribute is set, the control sequence given by the attribute value will be used instead. The attribute value should be the name (without the leading backslash) of a command that takes a single argument (the <a id="wrglossary.12203"></a><a href="#glo:dual.linktext">link text</a>). Remember that the abbreviation styles may apply an additional font change.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12204"></a><code class="code"><dfn id="glo:opt.catattr.hyperoutside"><span class="csoptfmt">hyperoutside</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ This boolean attribute may be <code class="code">false</code>, <code class="code">true</code> or unset. If unset, <code class="code">true</code> is assumed. This indicates the default setting of the <a id="wrglossary.12205"></a><a href="#glo:opt.glsopt.hyperoutside"><span class="csoptfmt">hyperoutside</span></a> option, described in §<a href="#sec:glsopts">5.1</a>.<p>
+
+</section><!-- end of section sec:glsoptsattr -->
+
+<section id="sec:glossattr"><!-- start of section sec:glossattr --><div class="tomain"><a href="#main">[top]</a></div>
+<h4><!-- start of subsubsection header -->10.2.1.3. Glossary Attributes<div class="labellink"><a href="#sec:glossattr">[link]</a></div></h4><!-- end of subsubsection header -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12206"></a><code class="code"><dfn id="glo:opt.catattr.glossdesc"><span class="csoptfmt">glossdesc</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code></div><!-- end of settingsbox -->
+ This attribute is checked by the <a id="wrglossary.12207"></a><a href="#glo:glossentrydesc"><code class="csfmt">\glossentrydesc</code></a> to determine whether or not to apply any <a id="wrglossary.12208"></a><a href="#glo:idx.casechange">case change</a>. The value may be one of:
+<dl>
+ <dt><span class="optfmt">firstuc</span></dt>
+
+<dd> Applies <a id="wrglossary.12209"></a><a href="#glo:idx.sentencecase">sentence case</a>. That is, the first letter of the description will be converted to <a id="wrglossary.12210"></a><a href="#glo:idx.uppercase">uppercase</a> (using <a id="wrglossary.12211"></a><a href="#glo:Glsentrydesc"><code class="csfmt">\Glsentrydesc</code></a>). </dd>
+<p>
+<dt><span class="optfmt">title</span></dt>
+
+<dd> Applies <a id="wrglossary.12212"></a><a href="#glo:idx.titlecase">title case</a>. If you have at least <a id="wrglossary.12213"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.48, the title casing is indirectly performed by <a id="wrglossary.12214"></a><a href="#glo:glscapitalisewords"><code class="csfmt">\glscapitalisewords</code></a>, which defaults to <a id="wrglossary.12215"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a> (provided by <a id="wrglossary.12216"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>). You can either redefine <a id="wrglossary.12217"></a><a href="#glo:glscapitalisewords"><code class="csfmt">\glscapitalisewords</code></a> if you want the change to also affect <a id="wrglossary.12218"></a><a href="#glo:glsentrytitlecase"><code class="csfmt">\glsentrytitlecase</code></a> or if you only want the change to apply to the attribute case-changing then redefine <a id="wrglossary.12219"></a><a href="#glo:glsxtrfieldtitlecasecs"><code class="csfmt">\glsxtrfieldtitlecasecs</code></a>. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.12220"></a><a href="#glo:glsxtrfieldtitlecasecs"><code class="csfmt">\glsxtrfieldtitlecasecs</code></a>}[1]{<a id="wrglossary.12221"></a><a href="#glo:xcapitalisefmtwords"><code class="csfmt">\xcapitalisefmtwords</code></a>*{#1}}
+</pre> (Note that the argument to <a id="wrglossary.12222"></a><a href="#glo:glsxtrfieldtitlecasecs"><code class="csfmt">\glsxtrfieldtitlecasecs</code></a> will be a control sequence whose replacement text is the entry’s description, which is why <a id="wrglossary.12223"></a><a href="#glo:xcapitalisefmtwords"><code class="csfmt">\xcapitalisefmtwords</code></a> is needed instead of <a id="wrglossary.12224"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a>.)<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+If an error occurs with this setting, try redefining <a id="wrglossary.12225"></a><a href="#glo:glsxtrfieldtitlecasecs"><code class="csfmt">\glsxtrfieldtitlecasecs</code></a> as shown above. </div><!-- end of warning -->
+ </dd>
+<p>
+
+</dl>
+ Any other values of this attribute are ignored. Remember that there are design limitations for both the <a id="wrglossary.12226"></a><a href="#glo:idx.sentencecase">sentence case</a> and the <a id="wrglossary.12227"></a><a href="#glo:idx.titlecase">title case</a> commands. See the <a id="wrglossary.12228"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> user manual for further details.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+If you are using <a id="wrglossary.12229"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, you can use the <a id="wrglossary.12230"></a><a href="#glo:opt.resource.description-case-change"><span class="csoptfmt">description-case-change</span></a> setting instead. </div><!-- end of information -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12231"></a><code class="code"><dfn id="glo:opt.catattr.glossdescfont"><span class="csoptfmt">glossdescfont</span></dfn>=<span class="meta">〈<em class="metainner">cs-name</em>〉</span></code></div><!-- end of settingsbox -->
+ If set, the value should be the name of a control sequence (without the leading backslash) that takes one argument. This control sequence will be applied by <a id="wrglossary.12232"></a><a href="#glo:glossentrydesc"><code class="csfmt">\glossentrydesc</code></a> to the description text. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.12233"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{<a id="wrglossary.12234"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>}{<a id="wrglossary.12235"></a><a href="#glo:opt.catattr.glossdescfont"><span class="csoptfmt">glossdescfont</span></a>}{emph}
+</pre><p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12236"></a><code class="code"><dfn id="glo:opt.catattr.glossname"><span class="csoptfmt">glossname</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code></div><!-- end of settingsbox -->
+ As <a id="wrglossary.12237"></a><a href="#glo:opt.catattr.glossdesc"><span class="csoptfmt">glossdesc</span></a> but applies to <a id="wrglossary.12238"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a>. Additionally, if this attribute is set to <span class="qt">“uc”</span> the name is converted to <a id="wrglossary.12239"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+If you are using <a id="wrglossary.12240"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, you can use the <a id="wrglossary.12241"></a><a href="#glo:opt.resource.name-case-change"><span class="csoptfmt">name-case-change</span></a> setting instead. </div><!-- end of information -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12242"></a><code class="code"><dfn id="glo:opt.catattr.indexname"><span class="csoptfmt">indexname</span></dfn>={<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of settingsbox -->
+ If set, the <a id="wrglossary.12243"></a><a href="#glo:dual.postnamehook">post-name hook</a> will index the entry using <a id="wrglossary.12244"></a><a href="#glo:index"><code class="csfmt">\index</code></a>. See §<a href="#sec:autoindex">12</a> for further details.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12245"></a><code class="code"><dfn id="glo:opt.catattr.glossnamefont"><span class="csoptfmt">glossnamefont</span></dfn>=<span class="meta">〈<em class="metainner">cs-name</em>〉</span></code></div><!-- end of settingsbox -->
+ As <a id="wrglossary.12246"></a><a href="#glo:opt.catattr.glossdescfont"><span class="csoptfmt">glossdescfont</span></a> but applies to <a id="wrglossary.12247"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a>. Note that this overrides <a id="wrglossary.12248"></a><a href="#glo:glsnamefont"><code class="csfmt">\glsnamefont</code></a> which will only be used if this attribute hasn’t been set.<p>
+Remember that <a id="wrglossary.12249"></a><a href="#glo:idx.glossarystyle">glossary styles</a> may additionally apply a font change, such as the list styles which put the name in the optional argument of <a id="wrglossary.12250"></a><a href="#glo:item"><code class="csfmt">\item</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12251"></a><code class="code"><dfn id="glo:opt.catattr.glosssymbolfont"><span class="csoptfmt">glosssymbolfont</span></dfn>=<span class="meta">〈<em class="metainner">cs-name</em>〉</span></code></div><!-- end of settingsbox -->
+ This is similar to <a id="wrglossary.12252"></a><a href="#glo:opt.catattr.glossnamefont"><span class="csoptfmt">glossnamefont</span></a> and <a id="wrglossary.12253"></a><a href="#glo:opt.catattr.glossdescfont"><span class="csoptfmt">glossdescfont</span></a> but is used by <a id="wrglossary.12254"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a>.<p>
+
+</section><!-- end of section sec:glossattr -->
+
+<section id="sec:otherattr"><!-- start of section sec:otherattr --><div class="tomain"><a href="#main">[top]</a></div>
+<h4><!-- start of subsubsection header -->10.2.1.4. Other Attributes<div class="labellink"><a href="#sec:otherattr">[link]</a></div></h4><!-- end of subsubsection header -->
+<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12255"></a><code class="code"><dfn id="glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ If this attribute is set to <span class="qt">“true”</span>, commands like <a id="wrglossary.12256"></a><a href="#glo:glsfmtshort"><code class="csfmt">\glsfmtshort</code></a> will use the upper case version in the page headers.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12257"></a><code class="code"><dfn id="glo:opt.catattr.entrycount"><span class="csoptfmt">entrycount</span></dfn>=<span class="meta">〈<em class="metainner">trigger-value</em>〉</span></code></div><!-- end of settingsbox -->
+ The value of this attribute (if set) must be an integer and is used in combination with <a id="wrglossary.12258"></a><a href="#glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></a> (see §<a href="#sec:entrycount">6.1</a>). Leave blank or undefined for categories that shouldn’t have this facility enabled. The value of this attribute is used by <a id="wrglossary.12259"></a><a href="#glo:glsxtrifcounttrigger"><code class="csfmt">\glsxtrifcounttrigger</code></a> to determine how commands such as <a id="wrglossary.12260"></a><a href="#glo:cgls"><code class="csfmt">\cgls</code></a> should behave.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12261"></a><code class="code"><dfn id="glo:opt.catattr.linkcount"><span class="csoptfmt">linkcount</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code></div><!-- end of settingsbox -->
+ This attribute is set to <code class="code">true</code> by <a id="wrglossary.12262"></a><a href="#glo:GlsXtrEnableLinkCounting"><code class="csfmt">\GlsXtrEnableLinkCounting</code></a> (see §<a href="#sec:linkcount">6.2</a>).<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12263"></a><code class="code"><dfn id="glo:opt.catattr.linkcountmaster"><span class="csoptfmt">linkcountmaster</span></dfn>=<span class="meta">〈<em class="metainner">counter-name</em>〉</span></code></div><!-- end of settingsbox -->
+ This attribute is set by <a id="wrglossary.12264"></a><a href="#glo:GlsXtrEnableLinkCounting"><code class="csfmt">\GlsXtrEnableLinkCounting</code></a> to the name of the counter that requires the link counter to be added to its reset list (see §<a href="#sec:linkcount">6.2</a>).<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12265"></a><code class="code"><dfn id="glo:opt.catattr.dualindex"><span class="csoptfmt">dualindex</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code></div><!-- end of settingsbox -->
+ If this attribute is set, whenever a glossary entry has information written to the external glossary file through commands like <a id="wrglossary.12266"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> and <a id="wrglossary.12267"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>, a corresponding line will be written to the indexing file using <a id="wrglossary.12268"></a><a href="#glo:index"><code class="csfmt">\index</code></a>. The value may be <code class="code">true</code> to simply enable this feature or the value may be the encap to use with <a id="wrglossary.12269"></a><a href="#glo:index"><code class="csfmt">\index</code></a>. See §<a href="#sec:autoindex">12</a> for further details.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12270"></a><code class="code"><dfn id="glo:opt.catattr.targeturl"><span class="csoptfmt">targeturl</span></dfn>=<span class="meta">〈<em class="metainner">url</em>〉</span></code></div><!-- end of settingsbox -->
+ If set, the hyperlink generated by commands like <a id="wrglossary.12271"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> will be set to the URL provided by this attribute’s value. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.12272"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{<a id="wrglossary.12273"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>}{<a id="wrglossary.12274"></a><a href="#glo:opt.catattr.targeturl"><span class="csoptfmt">targeturl</span></a>}{master-doc.pdf}
+</pre> (See also the accompanying sample file <a id="wrglossary.12275"></a><a href="#glo:file.sample-external.tex"><span class="filefmt">sample-external.tex</span></a>.) If the URL contains awkward characters (such as % or ~) remember that the base <a id="wrglossary.12276"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package provides commands like <a id="wrglossary.12277"></a><a href="#glo:glspercentchar"><code class="csfmt">\glspercentchar</code></a> and <a id="wrglossary.12278"></a><a href="#glo:glstildechar"><code class="csfmt">\glstildechar</code></a> that expand to literal characters.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12279"></a><code class="code"><dfn id="glo:opt.catattr.targetname"><span class="csoptfmt">targetname</span></dfn>=<span class="meta">〈<em class="metainner">anchor</em>〉</span></code></div><!-- end of settingsbox -->
+ If you want to a named anchor within the target URL (notionally adding <code class="code">#<span class="meta">〈<em class="metainner">name</em>〉</span></code> to the URL), then you also need to set <a id="wrglossary.12280"></a><a href="#glo:opt.catattr.targetname"><span class="csoptfmt">targetname</span></a> to the anchor <span class="meta">〈<em class="metainner">name</em>〉</span>. You may use <a id="wrglossary.12281"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a> within <span class="meta">〈<em class="metainner">name</em>〉</span> which is set by commands like <a id="wrglossary.12282"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> to the entry’s label.<p>
+All the predefined <a id="wrglossary.12283"></a><a href="#glo:idx.glossarystyle">glossary styles</a> start each entry listing with <a id="wrglossary.12284"></a><a href="#glo:glstarget"><code class="csfmt">\glstarget</code></a> which sets the anchor to <code class="code"><a id="wrglossary.12285"></a><a href="#glo:glolinkprefix"><code class="csfmt">\glolinkprefix</code></a><a id="wrglossary.12286"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a></code>, so if you want entries to link to glossaries in the URL given by <a id="wrglossary.12287"></a><a href="#glo:opt.catattr.targeturl"><span class="csoptfmt">targeturl</span></a>, you can just do: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.12288"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{<a id="wrglossary.12289"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>}{<a id="wrglossary.12290"></a><a href="#glo:opt.catattr.targetname"><span class="csoptfmt">targetname</span></a>}{<a id="wrglossary.12291"></a><a href="#glo:glolinkprefix"><code class="csfmt">\glolinkprefix</code></a><a id="wrglossary.12292"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}
+</pre> (If the target document changed <a id="wrglossary.12293"></a><a href="#glo:glolinkprefix"><code class="csfmt">\glolinkprefix</code></a> then you will need to adjust the above as appropriate.)<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12294"></a><code class="code"><dfn id="glo:opt.catattr.targetcategory"><span class="csoptfmt">targetcategory</span></dfn>=<span class="meta">〈<em class="metainner">anchor</em>〉</span></code></div><!-- end of settingsbox -->
+ If the anchor is in the form <code class="code"><span class="meta">〈<em class="metainner">name1</em>〉</span>.<span class="meta">〈<em class="metainner">name2</em>〉</span></code> then use <a id="wrglossary.12295"></a><a href="#glo:opt.catattr.targetname"><span class="csoptfmt">targetname</span></a> for the <span class="meta">〈<em class="metainner">name2</em>〉</span> part and <a id="wrglossary.12296"></a><a href="#glo:opt.catattr.targetcategory"><span class="csoptfmt">targetcategory</span></a> for the <span class="meta">〈<em class="metainner">name1</em>〉</span> part.<p>
+For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.12297"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{<a id="wrglossary.12298"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>}{<a id="wrglossary.12299"></a><a href="#glo:opt.catattr.targeturl"><span class="csoptfmt">targeturl</span></a>}{master-doc.pdf}
+<a id="wrglossary.12300"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{<a id="wrglossary.12301"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>}{<a id="wrglossary.12302"></a><a href="#glo:opt.catattr.targetcategory"><span class="csoptfmt">targetcategory</span></a>}{page}
+<a id="wrglossary.12303"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{<a id="wrglossary.12304"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>}{<a id="wrglossary.12305"></a><a href="#glo:opt.catattr.targetname"><span class="csoptfmt">targetname</span></a>}{7}
+</pre> will cause all link text for <a id="wrglossary.12306"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a> entries to link to <span class="filefmt">master-doc.pdf#page.7</span> (page 7 of that PDF).<p>
+If you want a mixture in your document of entries that link to an internal glossary and entries that link to an external URL then you can use <a id="wrglossary.12307"></a><a href="#glo:newignoredglossary*"><code class="csfmt">\newignoredglossary*</code></a> for the external list. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.12308"></a><a href="#glo:newignoredglossary*"><code class="csfmt">\newignoredglossary*</code></a>{external}
+
+<a id="wrglossary.12309"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{external}{<a id="wrglossary.12310"></a><a href="#glo:opt.catattr.targeturl"><span class="csoptfmt">targeturl</span></a>}{master-doc.pdf}
+<a id="wrglossary.12311"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{<a id="wrglossary.12312"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>}{<a id="wrglossary.12313"></a><a href="#glo:opt.catattr.targetname"><span class="csoptfmt">targetname</span></a>}{<a id="wrglossary.12314"></a><a href="#glo:glolinkprefix"><code class="csfmt">\glolinkprefix</code></a><a id="wrglossary.12315"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}
+
+<a id="wrglossary.12316"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.12317"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.12318"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={local example}</span>}
+
+<a id="wrglossary.12319"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample2}{<a id="wrglossary.12320"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample2}</span>,
+ <a id="wrglossary.12321"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={external}</span>,
+ <a id="wrglossary.12322"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={external}</span>,
+ <a id="wrglossary.12323"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={external example}</span>}
+</pre><p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.12324"></a><code class="code"><dfn id="glo:opt.catattr.externallocation"><span class="csoptfmt">externallocation</span></dfn>=<span class="meta">〈<em class="metainner">PDF filename</em>〉</span></code></div><!-- end of settingsbox -->
+ The value should be the file name of the target document when manually indexing an external location with <a id="wrglossary.12325"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a>. In general, it’s better to use <a id="wrglossary.12326"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v1.7+ which can handle multiple external sources and doesn’t require this attribute.<p>
+
+</section><!-- end of section sec:otherattr -->
+
+<section id="sec:attributecmds"><!-- start of section sec:attributecmds --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->10.2.2. Accessing and Setting Attributes<div class="labellink"><a href="#sec:attributecmds">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+Attributes can be set using the following commands:<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12327"></a><code class="code"><dfn id="glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Locally sets the given attribute to <span class="meta">〈<em class="metainner">value</em>〉</span> for the given category.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12328"></a><code class="code"><dfn id="glo:glssetcategoriesattribute"><code class="csfmt">\glssetcategoriesattribute</code></dfn>{<span class="meta">〈<em class="metainner">category list</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Globally sets the given attribute to <span class="meta">〈<em class="metainner">value</em>〉</span> for all the categories in the comma-separated list <span class="meta">〈<em class="metainner">category list</em>〉</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12329"></a><code class="code"><dfn id="glo:glssetcategoryattributes"><code class="csfmt">\glssetcategoryattributes</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute list</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Globally sets each attribute in the comma separated <span class="meta">〈<em class="metainner">attribute list</em>〉</span> to <span class="meta">〈<em class="metainner">value</em>〉</span> for the given <span class="meta">〈<em class="metainner">category</em>〉</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12330"></a><code class="code"><dfn id="glo:glssetcategoriesattributes"><code class="csfmt">\glssetcategoriesattributes</code></dfn>{<span class="meta">〈<em class="metainner">category list</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute list</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Globally sets each attribute in the comma separated <span class="meta">〈<em class="metainner">attribute list</em>〉</span> to <span class="meta">〈<em class="metainner">value</em>〉</span> for each category in the comma-separated list <span class="meta">〈<em class="metainner">category list</em>〉</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12331"></a><code class="code"><dfn id="glo:glssetattribute"><code class="csfmt">\glssetattribute</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Locally sets the given attribute to <span class="meta">〈<em class="metainner">value</em>〉</span> for the category associated with the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. This command can’t be used to assign an attribute for a multi-entry category.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12332"></a><code class="code"><dfn id="glo:glssetregularcategory"><code class="csfmt">\glssetregularcategory</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ A shortcut that sets the <a id="wrglossary.12333"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">true</code> for the given category using <a id="wrglossary.12334"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>.<p>
+An attribute can be locally unset using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12335"></a><code class="code"><dfn id="glo:glsunsetcategoryattribute"><code class="csfmt">\glsunsetcategoryattribute</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<p>
+Attribute values can be obtained with the following commands:<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12336"></a><code class="code"><dfn id="glo:glsgetcategoryattribute"><code class="csfmt">\glsgetcategoryattribute</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Expands to the value of the given attribute for the given category. Expands to nothing if the attribute hasn’t been set.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12337"></a><code class="code"><dfn id="glo:glsgetattribute"><code class="csfmt">\glsgetattribute</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Expands to the value of the given attribute for the category associated with the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. Expands to nothing if the attribute hasn’t been set. This command can’t be used to assign an attribute for a multi-entry category.<p>
+Attributes can be tested with the following commands.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12338"></a><code class="code"><dfn id="glo:glshascategoryattribute"><code class="csfmt">\glshascategoryattribute</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This uses <a id="wrglossary.12339"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <a id="wrglossary.12340"></a><a href="#glo:ifcsvoid"><code class="csfmt">\ifcsvoid</code></a> and does <span class="meta">〈<em class="metainner">true</em>〉</span> if the attribute has been set and isn’t blank and isn’t <a id="wrglossary.12341"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a> otherwise it does <span class="meta">〈<em class="metainner">false</em>〉</span>. <p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12342"></a><code class="code"><dfn id="glo:glshasattribute"><code class="csfmt">\glshasattribute</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.12343"></a><a href="#glo:glshascategoryattribute"><code class="csfmt">\glshascategoryattribute</code></a> but the category is obtained from the given entry. This command can’t be used to test an attribute associated with a multi-entry category.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12344"></a><code class="code"><dfn id="glo:glsifcategoryattribute"><code class="csfmt">\glsifcategoryattribute</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This tests if the given attribute for the given category is set and equal to <span class="meta">〈<em class="metainner">value</em>〉</span>. If true, <span class="meta">〈<em class="metainner">true</em>〉</span> is done. If the attribute isn’t set or is set but isn’t equal to <span class="meta">〈<em class="metainner">value</em>〉</span>, <span class="meta">〈<em class="metainner">false</em>〉</span> is done.<p>
+For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.12345"></a><a href="#glo:glsifcategoryattribute"><code class="csfmt">\glsifcategoryattribute</code></a>{<a id="wrglossary.12346"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>}{<a id="wrglossary.12347"></a><a href="#glo:opt.catattr.nohyper"><span class="csoptfmt">nohyper</span></a>}{true}{NO HYPER}{HYPER}
+</pre> This does <span class="qt">“NO HYPER”</span> if the <a id="wrglossary.12348"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a> category has the <a id="wrglossary.12349"></a><a href="#glo:opt.catattr.nohyper"><span class="csoptfmt">nohyper</span></a> attribute set to <code class="code">true</code> otherwise if does <span class="qt">“HYPER”</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12350"></a><code class="code"><dfn id="glo:glsifattribute"><code class="csfmt">\glsifattribute</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.12351"></a><a href="#glo:glsifcategoryattribute"><code class="csfmt">\glsifcategoryattribute</code></a> but the category is obtained from the given entry. This command can’t be used to test an attribute associated with a multi-entry category.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12352"></a><code class="code"><dfn id="glo:glsifregularcategory"><code class="csfmt">\glsifregularcategory</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ A shortcut that tests if the given category has the <a id="wrglossary.12353"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute set to <code class="code">true</code>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12354"></a><code class="code"><dfn id="glo:glsifnotregularcategory"><code class="csfmt">\glsifnotregularcategory</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ A shortcut that tests if the given category has the <a id="wrglossary.12355"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute set to <code class="code">false</code>.<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+If the <a id="wrglossary.12356"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute hasn’t been set, both <a id="wrglossary.12357"></a><a href="#glo:glsifregularcategory"><code class="csfmt">\glsifregularcategory</code></a> and <a id="wrglossary.12358"></a><a href="#glo:glsifnotregularcategory"><code class="csfmt">\glsifnotregularcategory</code></a> will do <span class="meta">〈<em class="metainner">false</em>〉</span>. The choice of command needs to be determined by what outcome should occur if the attribute hasn’t been set. </div><!-- end of warning -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12359"></a><code class="code"><dfn id="glo:glsifregular"><code class="csfmt">\glsifregular</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.12360"></a><a href="#glo:glsifregularcategory"><code class="csfmt">\glsifregularcategory</code></a> but the category is obtained from the given entry. This command can’t be used to test an attribute associated with a multi-entry category.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12361"></a><code class="code"><dfn id="glo:glsifnotregular"><code class="csfmt">\glsifnotregular</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.12362"></a><a href="#glo:glsifnotregularcategory"><code class="csfmt">\glsifnotregularcategory</code></a> but the category is obtained from the given entry. This command can’t be used to test an attribute associated with a multi-entry category.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12363"></a><code class="code"><dfn id="glo:glsifcategoryattributetrue"><code class="csfmt">\glsifcategoryattributetrue</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Expands to <span class="meta">〈<em class="metainner">true</em>〉</span> if the attribute is <code class="code">true</code> and <span class="meta">〈<em class="metainner">false</em>〉</span> otherwise. Expands to <span class="meta">〈<em class="metainner">false</em>〉</span> if there’s no such attribute for the given category.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12364"></a><code class="code"><dfn id="glo:glsifattributetrue"><code class="csfmt">\glsifattributetrue</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.12365"></a><a href="#glo:glsifcategoryattributetrue"><code class="csfmt">\glsifcategoryattributetrue</code></a> but the category is obtained from the given entry. Expands to <span class="meta">〈<em class="metainner">false</em>〉</span> if the entry isn’t defined. This command can’t be used to test an attribute associated with a multi-entry category.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12366"></a><code class="code"><dfn id="glo:glsifcategoryattributehasitem"><code class="csfmt">\glsifcategoryattributehasitem</code></dfn>{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}{<span class="meta">〈<em class="metainner">item</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the category has the attribute (whose value is a comma-separated list) contains the given item and <span class="meta">〈<em class="metainner">false</em>〉</span> otherwise. Does <span class="meta">〈<em class="metainner">false</em>〉</span> if there’s no such attribute for the given category. The item and list are expanded and passed to <a id="wrglossary.12367"></a><a href="#glo:pkg.datatool"><span class="styfmt">datatool</span>’s</a> <a id="wrglossary.12368"></a><a href="#glo:DTLifinlist"><code class="csfmt">\DTLifinlist</code></a> to perform the test.<p>
+
+</section><!-- end of section sec:attributecmds -->
+
+<section id="sec:bib2gls"><!-- start of section sec:bib2gls --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->11. <span class="appfmt">bib2gls</span>: Managing Reference Databases<div class="labellink"><a href="#sec:bib2gls">[link]</a></div></h1><!-- end of chapter header -->
+<p>
+<a id="wrglossary.12369"></a><p>
+The command line application <a id="wrglossary.12370"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> performs two functions in one:
+<ul class="displaylist">
+ <li><span class="bulletitem">•</span>selects entries according to <a id="wrglossary.12371"></a><a href="#glo:@@glslabel@indexing">records</a> found in the <a id="wrglossary.12372"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file (similar to BibTeX), <li><span class="bulletitem">•</span>hierarchically sorts entries and collates <a id="wrglossary.12373"></a><a href="#glo:dual.locationlist">location lists</a> (similar to <a id="wrglossary.12374"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.12375"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>).
+</ul>
+ Instead of storing all your entry definitions in a <a id="wrglossary.12376"></a><a href="#glo:ext.tex"><span class="extfmt">tex</span></a> and loading them using <a id="wrglossary.12377"></a><a href="#glo:input"><code class="csfmt">\input</code></a> or <a id="wrglossary.12378"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>, the entries can instead be stored in a <a id="wrglossary.12379"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file and <a id="wrglossary.12380"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can selectively write the appropriate commands to a <a id="wrglossary.12381"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file which is loaded using <a id="wrglossary.12382"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>.<p>
+This means that you can use a reference managing system to maintain the database and it reduces the TeX overhead by only defining the entries that are actually required in the document. If you currently have a <a id="wrglossary.12383"></a><a href="#glo:ext.tex"><span class="extfmt">tex</span></a> file that contains hundreds of definitions, but you only use a dozen or so in your document, then the build time is needlessly slowed by the unrequired definitions that occur when the file is input. (You can convert an existing <a id="wrglossary.12384"></a><a href="#glo:ext.tex"><span class="extfmt">tex</span></a> file containing glossary definitions to a <a id="wrglossary.12385"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file using <a id="wrglossary.12386"></a><a href="#glo:app.convertgls2bib"><span class="appfmt">convertgls2bib</span></a>, supplied with <a id="wrglossary.12387"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>.)<p>
+There are some new commands and options added to <a id="wrglossary.12388"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> to help assist the integration of <a id="wrglossary.12389"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> into the document build process.<p>
+This chapter just provides a general overview of <a id="wrglossary.12390"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. The full details and some sample documents are provided in the <a id="wrglossary.12391"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> <a href="http://mirrors.ctan.org/support/bib2gls/bib2gls.pdf">manual</a> <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div><a href="https://www.tug.org/texdoc/">texdoc</a> bib2gls</pre><p>
+<a id="examplebib"></a>An example of the contents of <a id="wrglossary.12392"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file that stores glossary entries that can be extracted with <a id="wrglossary.12393"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> called, say, <span class="filefmt">terms.bib</span>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="code">@entry</code>{bird,<br> <a id="wrglossary.12394"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={bird}</span>,<br> <a id="wrglossary.12395"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={feathered animal}</span>,<br> <a id="wrglossary.12396"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={[see also]duck,goose}</span><br>}
+
+<code class="code">@entry</code>{duck,<br> <a id="wrglossary.12397"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,<br> <a id="wrglossary.12398"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird with short legs}</span><br>}
+
+<code class="code">@entry</code>{goose,<br> <a id="wrglossary.12399"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>="goose",<br> <a id="wrglossary.12400"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a>="geese",<br> <a id="wrglossary.12401"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird with a long neck}</span><br>}</pre>The following provides some abbreviations in a file called, say, <span class="filefmt">abbrvs.bib</span>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="code">@string</code>{ssi={server-side includes}}<br><code class="code">@string</code>{html={hypertext markup language}}
+
+<code class="code">@abbreviation</code>{shtml,<br> <a id="wrglossary.12402"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a>="shtml",<br> <a id="wrglossary.12403"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a>= ssi # " enabled " # html,<br> <a id="wrglossary.12404"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a combination of <a id="wrglossary.12405"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html} and <a id="wrglossary.12406"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi}}</span><br>}
+
+<code class="code">@abbreviation</code>{html,<br> <a id="wrglossary.12407"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> ="html",<br> <a id="wrglossary.12408"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> = html,<br> <a id="wrglossary.12409"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a markup language for creating web pages}</span><br>}
+
+<code class="code">@abbreviation</code>{ssi,<br> <a id="wrglossary.12410"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a>="ssi",<br> <a id="wrglossary.12411"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> = ssi,<br> <a id="wrglossary.12412"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a simple interpreted server-side scripting language}</span><br>}
+<code class="code">@abbreviation</code>{xml,<br> <a id="wrglossary.12413"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a>={xml},
+<a id="wrglossary.12414"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a>={extensible markup language},
+<a id="wrglossary.12415"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a>={a simple text-base format for
+representing structured information}
+}</pre>The above defines <a id="wrglossary.12416"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> strings (with <code class="code">@string</code>) and uses string concatenation (with <code class="code">#</code>), which is a BibTeX feature. Another supported <a id="wrglossary.12417"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> feature is <code class="code">@preamble</code>, which may be used to provide command definitions.<p>
+Here are some symbols in a file called, say, <span class="filefmt">symbols.bib</span>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="code">@preamble</code>{"<code class="cmd">\providecommand</code>{<code class="cmd">\mtx</code>}[1]{<code class="cmd">\boldsymbol</code>{#1}}"}
+
+<code class="code">@symbol</code>{M,<br> <a id="wrglossary.12418"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\mtx</code>{M}}}</span>,<br> <a id="wrglossary.12419"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a matrix}</span><br>}
+
+<code class="code">@symbol</code>{v,<br> <a id="wrglossary.12420"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\vec</code>{v}}}</span>,<br> <a id="wrglossary.12421"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a vector}</span><br>}
+
+<code class="code">@symbol</code>{S,<br> <a id="wrglossary.12422"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\mathcal</code>{S}}}</span>,<br> <a id="wrglossary.12423"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a set}</span><br>}</pre><p>
+To ensure that <a id="wrglossary.12424"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can find out which entries have been used in the document, you need the <a id="wrglossary.12425"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a> package option: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.12426"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>]{glossaries-extra}
+</pre> If you are using <a id="wrglossary.12427"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>, you may prefer to use <a id="wrglossary.12428"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.12429"></a><a href="#glo:optval.record.nameref"><span class="optfmt">nameref</span></a>.<p>
+The <a id="wrglossary.12430"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file created by <a id="wrglossary.12431"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> is loaded using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12432"></a><code class="code"><dfn id="glo:glsxtrresourcefile"><code class="csfmt">\glsxtrresourcefile</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">basename</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">basename</em>〉</span> is the basename (without the extension) of the <a id="wrglossary.12433"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file. This command will redefine <a id="wrglossary.12434"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a> to <code class="code">bib2gls</code> (or <code class="code">bib2gls-xindy</code> or <code class="code">bib2gls-makeindex</code> if <a id="wrglossary.12435"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.12436"></a><a href="#glo:optval.record.hybrid"><span class="optfmt">hybrid</span></a>). There’s a shortcut version: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12437"></a><code class="code"><dfn id="glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code></div><!-- end of pinnedbox -->
+ This internally uses <a id="wrglossary.12438"></a><a href="#glo:glsxtrresourcefile"><code class="csfmt">\glsxtrresourcefile</code></a> and sets the <span class="meta">〈<em class="metainner">basename</em>〉</span> to <a id="wrglossary.12439"></a><a href="#glo:jobname"><code class="csfmt">\jobname</code></a> in the first instance and to <code class="code"><a id="wrglossary.12440"></a><a href="#glo:jobname"><code class="csfmt">\jobname</code></a>-<span class="meta">〈<em class="metainner">n</em>〉</span></code> on subsequent instances (where <span class="meta">〈<em class="metainner">n</em>〉</span> is incremented at the end of every <a id="wrglossary.12441"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>). For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[record]{glossaries-extra}
+<a id="wrglossary.12442"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.12443"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">={terms,moreterms}</span>]
+<a id="wrglossary.12444"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.12445"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">={symbols,constants}</span>]
+<a id="wrglossary.12446"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.12447"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">={abbreviations}</span>]
+</pre> is equivalent to: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[record]{glossaries-extra}
+<a id="wrglossary.12448"></a><a href="#glo:glsxtrresourcefile"><code class="csfmt">\glsxtrresourcefile</code></a>[<a id="wrglossary.12449"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">={terms,moreterms}</span>]{<a id="wrglossary.12450"></a><a href="#glo:jobname"><code class="csfmt">\jobname</code></a>}
+<a id="wrglossary.12451"></a><a href="#glo:glsxtrresourcefile"><code class="csfmt">\glsxtrresourcefile</code></a>[<a id="wrglossary.12452"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">={symbols,constants}</span>]{<a id="wrglossary.12453"></a><a href="#glo:jobname"><code class="csfmt">\jobname</code></a>-1}
+<a id="wrglossary.12454"></a><a href="#glo:glsxtrresourcefile"><code class="csfmt">\glsxtrresourcefile</code></a>[<a id="wrglossary.12455"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">={abbreviations}</span>]{<a id="wrglossary.12456"></a><a href="#glo:jobname"><code class="csfmt">\jobname</code></a>-2}
+</pre> If required, the value of <span class="meta">〈<em class="metainner">n</em>〉</span> is stored in the count register: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12457"></a><code class="code"><dfn id="glo:glsxtrresourcecount"><code class="csfmt">\glsxtrresourcecount</code></dfn></code></div><!-- end of pinnedbox -->
+ although there should be little need to use this.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+Since <a id="wrglossary.12458"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a> is more convenient to use than <a id="wrglossary.12459"></a><a href="#glo:glsxtrresourcefile"><code class="csfmt">\glsxtrresourcefile</code></a>, all examples use <a id="wrglossary.12460"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>. </div><!-- end of information -->
+<p>
+The <a id="wrglossary.12461"></a><a href="#glo:glsxtrresourcefile"><code class="csfmt">\glsxtrresourcefile</code></a> command writes the following to the <a id="wrglossary.12462"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12463"></a><code class="code"><dfn id="glo:glsxtr@resource"><code class="csfmt">\glsxtr@resource</code></dfn>{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">basename</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ and will input <span class="filefmt"></span><span class="meta">〈<em class="metainner">filename</em>〉</span><span class="filefmt">.glstex</span> if it exists. (Version 1.08 assumed <span class="filefmt"></span><span class="meta">〈<em class="metainner">filename</em>〉</span><span class="filefmt">.tex</span> but that’s potentially dangerous if, for example, <span class="meta">〈<em class="metainner">filename</em>〉</span> happens to be the same as <a id="wrglossary.12464"></a><a href="#glo:jobname"><code class="csfmt">\jobname</code></a>. The <a id="wrglossary.12465"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> extension was enforced by version 1.11.)<p>
+If you are using or developing a build system that needs to know which applications to run as part of the document build, you can search the <a id="wrglossary.12466"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> for for instances of <a id="wrglossary.12467"></a><a href="#glo:glsxtr@resource"><code class="csfmt">\glsxtr@resource</code></a>. For example, using <a id="wrglossary.12468"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>% arara: bib2gls if found("aux", "glsxtr@resource")
+</pre><p>
+Since the <a id="wrglossary.12469"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file won’t exist on the first LaTeX run, the <a id="wrglossary.12470"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a> package option additionally switches on <a id="wrglossary.12471"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=</span><a id="wrglossary.12472"></a><a href="#glo:optval.undefaction.warn"><span class="optfmt">warn</span></a>. Any use of commands like <a id="wrglossary.12473"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or <a id="wrglossary.12474"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> will produce <a id="wrglossary.12475"></a><a href="#glo:idx.unknowntag"><code class="code">??</code></a> in the document, since the entries are undefined at this point. Once <a id="wrglossary.12476"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> has created the <a id="wrglossary.12477"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file the references should be resolved. This may cause a shift in the locations if the actual text produced once the entry is defined is significantly larger than the placeholder <a id="wrglossary.12478"></a><a href="#glo:idx.unknowntag"><code class="code">??</code></a> (as this can alter the page breaking).<p>
+Note that as from v1.12, <a id="wrglossary.12479"></a><a href="#glo:glsxtrresourcefile"><code class="csfmt">\glsxtrresourcefile</code></a> temporarily switches the category code of <code class="code">@</code> to 11 (letter) while it reads the file to allow for any internal commands.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+The package options <a id="wrglossary.12480"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.12481"></a><a href="#glo:optval.record.only"><span class="optfmt">only</span></a> and <a id="wrglossary.12482"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.12483"></a><a href="#glo:optval.record.nameref"><span class="optfmt">nameref</span></a> automatically load <a id="wrglossary.12484"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a>, which provides additional commands that are useful with <a id="wrglossary.12485"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. Since they cover sorting and <a id="wrglossary.12486"></a><a href="#glo:dual.locationlist">location lists</a>, they’re not relevant with the <a id="wrglossary.12487"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.12488"></a><a href="#glo:optval.record.hybrid"><span class="optfmt">hybrid</span></a> option. </div><!-- end of information -->
+<p>
+These commands are provided by <a id="wrglossary.12489"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> for use with <a id="wrglossary.12490"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>.<p>
+The information provided with <a id="wrglossary.12491"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a> is written to the <a id="wrglossary.12492"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file using: <pre class="compactcodebox"><code class="cmd">\protected@write</code><code class="cmd">\@auxout</code>{<a id="wrglossary.12493"></a><a href="#glo:glsxtrresourceinit"><code class="csfmt">\glsxtrresourceinit</code></a>}{<span class="meta">〈<em class="metainner">information</em>〉</span>}
+</pre> where <span class="meta">〈<em class="metainner">information</em>〉</span> is the information to pass to <a id="wrglossary.12494"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. The command in the second argument: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12495"></a><code class="code"><dfn id="glo:glsxtrresourceinit"><code class="csfmt">\glsxtrresourceinit</code></dfn></code></div><!-- end of pinnedbox -->
+ may be used to temporarily redefine commands before the information is written to the file. This does nothing by default, but may be redefined to allow the use of short commands for convenience. For example, with: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.12496"></a><a href="#glo:glsxtrresourceinit"><code class="csfmt">\glsxtrresourceinit</code></a>}{<code class="cmd">\let</code><a id="wrglossary.12497"></a><a href="#glo:u"><code class="csfmt">\u</code></a><a id="wrglossary.12498"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a>}
+</pre> you can just use, for example, <code class="code"><a id="wrglossary.12499"></a><a href="#glo:u"><code class="csfmt">\u</code></a> E6</code> instead of <code class="code"><a id="wrglossary.12500"></a><a href="#glo:string"><code class="csfmt">\string</code></a><a id="wrglossary.12501"></a><a href="#glo:u"><code class="csfmt">\u</code></a>E6</code> in the custom rule. This redefinition of <a id="wrglossary.12502"></a><a href="#glo:u"><code class="csfmt">\u</code></a> is scoped so its original definition is restored after the write operation.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12503"></a><code class="code"><dfn id="glo:glsxtrMFUsave"><code class="csfmt">\glsxtrMFUsave</code></dfn></code></div><!-- end of pinnedbox -->
+ If you have <a id="wrglossary.12504"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+, this command will be used on the first instance of <a id="wrglossary.12505"></a><a href="#glo:glsxtrresourcefile"><code class="csfmt">\glsxtrresourcefile</code></a>, and will add <a id="wrglossary.12506"></a><a href="#glo:MFUsave"><code class="csfmt">\MFUsave</code></a> to the begin document hook and then disable itself. This is provided to help <a id="wrglossary.12507"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v3.0+ pick up any of <a id="wrglossary.12508"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span>’s</a> exclusions, blockers and mappings to assist with its <a id="wrglossary.12509"></a><a href="#glo:idx.sentencecase">sentence case</a> function. The assumption is that all exclusions, blockers and mappings will be set up in the preamble. If there are any within the <a id="wrglossary.12510"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment that you want <a id="wrglossary.12511"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to be aware of, redefine this command to do nothing before the first instance of <a id="wrglossary.12512"></a><a href="#glo:glsxtrresourcefile"><code class="csfmt">\glsxtrresourcefile</code></a> (or <a id="wrglossary.12513"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>) and use <a id="wrglossary.12514"></a><a href="#glo:MFUsaveatend"><code class="csfmt">\MFUsaveatend</code></a> instead.<p>
+If you have multiple resource commands and you want a default set of options you can supply them in the definition of: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12515"></a><code class="code"><dfn id="glo:GlsXtrDefaultResourceOptions"><code class="csfmt">\GlsXtrDefaultResourceOptions</code></dfn></code></div><!-- end of pinnedbox -->
+ For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.12516"></a><a href="#glo:GlsXtrDefaultResourceOptions"><code class="csfmt">\GlsXtrDefaultResourceOptions</code></a>}{<a id="wrglossary.12517"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">=all</span>}
+</pre> This should be done before the resource commands to which the options should apply.<p>
+
+</section><!-- end of section sec:bib2gls -->
+
+<section id="sec:bib2glsindexing"><!-- start of section sec:bib2glsindexing --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->11.1. Indexing (Recording)<div class="labellink"><a href="#sec:bib2glsindexing">[link]</a></div></h2><!-- end of section header -->
+<p>
+As with <a id="wrglossary.12518"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.12519"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, the <a id="wrglossary.12520"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.12521"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands automatically index, but the underlying <a id="wrglossary.12522"></a><a href="#glo:dual.indexing">indexing</a> mechanism is more like that used with <a id="wrglossary.12523"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a>. Each indexing instance creates a <a id="wrglossary.12524"></a><a href="#glo:@@glslabel@indexing">record</a> in the <a id="wrglossary.12525"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file, which <a id="wrglossary.12526"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can then pick up when it parses the <a id="wrglossary.12527"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file. Each record has an associated format (the <a id="wrglossary.12528"></a><a href="#glo:dual.locationencap">location encap</a>) which can be set with the <a id="wrglossary.12529"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a> key and an associated <a id="wrglossary.12530"></a><a href="#glo:dual.locationcounter">location counter</a> (as with the other indexing methods).<p>
+The formatted <a id="wrglossary.12531"></a><a href="#glo:dual.locationlist">location list</a> is stored in the <a id="wrglossary.12532"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a> field (unless <a id="wrglossary.12533"></a><a href="#glo:opt.resource.save-locations"><span class="csoptfmt">save-locations</span></a><span class="optfmt">=false</span>). Additionally, the individual locations are stored in the <a id="wrglossary.12534"></a><a href="#glo:opt.glosfield.loclist"><span class="csoptfmt">loclist</span></a> field as an <a id="wrglossary.12535"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span></a> internal list (as with <a id="wrglossary.12536"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a>). This may be used to pick out individual locations to avoid the complexity of parsing the formatted list.<p>
+See the <a id="wrglossary.12537"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> manual for information on how to separate the <a id="wrglossary.12538"></a><a href="#glo:dual.locationlist">location list</a> into groups associated with different counters.<p>
+
+</section><!-- end of section sec:bib2glsindexing -->
+
+<section id="sec:bib2glsselection"><!-- start of section sec:bib2glsselection --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->11.2. Selection<div class="labellink"><a href="#sec:bib2glsselection">[link]</a></div></h2><!-- end of section header -->
+<p>
+The default behaviour is for <a id="wrglossary.12539"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to select all entries that have a <a id="wrglossary.12540"></a><a href="#glo:@@glslabel@indexing">record</a> in the <a id="wrglossary.12541"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file, and any dependent entries (including parent and cross-references). The <code class="code">glsignore</code> format (for example, <code class="code"><a id="wrglossary.12542"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.12543"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=glsignore</span>]{duck}</code>) is recognised by <a id="wrglossary.12544"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> as a special <a id="wrglossary.12545"></a><a href="#glo:@@glslabel@ignoredlocation">ignored record</a>. This means that it will match the selection criteria but the record won’t be added to the location list. This means that you won’t get spurious commas in the <a id="wrglossary.12546"></a><a href="#glo:dual.locationlist">location list</a> (as can happen with the other <a id="wrglossary.12547"></a><a href="#glo:dual.indexing">indexing</a> methods), so you can do, for example, <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.12548"></a><a href="#glo:GlsXtrSetDefaultNumberFormat"><code class="csfmt">\GlsXtrSetDefaultNumberFormat</code></a>{glsignore}
+</pre> at the start of the front matter and <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.12549"></a><a href="#glo:GlsXtrSetDefaultNumberFormat"><code class="csfmt">\GlsXtrSetDefaultNumberFormat</code></a>{glsnumberformat}
+</pre> at the start of the main matter to prevent any records in the front matter from occurring in the <a id="wrglossary.12550"></a><a href="#glo:dual.locationlist">location lists</a>.<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+Commands like <a id="wrglossary.12551"></a><a href="#glo:glsaddall"><code class="csfmt">\glsaddall</code></a> and <a id="wrglossary.12552"></a><a href="#glo:glsaddallunused"><code class="csfmt">\glsaddallunused</code></a> don’t work with <a id="wrglossary.12553"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> as the command has to iterate over each <a id="wrglossary.12554"></a><a href="#glo:dual.glossary">glossary’s</a> internal lists of defined entry labels, which will be empty on the first run and on subsequent runs will only contain those entries that have been selected by <a id="wrglossary.12555"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. Use <a id="wrglossary.12556"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">=all</span> to select all entries instead. </div><!-- end of warning -->
+<p>
+The <a id="wrglossary.12557"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a> option indicates which entries should be selected from the <a id="wrglossary.12558"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files (listed in <a id="wrglossary.12559"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a>). For example, <a id="wrglossary.12560"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">=all</span> indicates to select all entries, regardless of whether or not the entries have been referenced in the document. This will lead to empty <a id="wrglossary.12561"></a><a href="#glo:dual.locationlist">location lists</a> for some (or all) entries. The default setting is <a id="wrglossary.12562"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">=recorded and deps</span>, which indicates to select all entries that have <a id="wrglossary.12563"></a><a href="#glo:@@glslabel@indexing">records</a> and any dependent entries. See the <a id="wrglossary.12564"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for more details of this option.<p>
+
+</section><!-- end of section sec:bib2glsselection -->
+
+<section id="sec:bib2glssortprint"><!-- start of section sec:bib2glssortprint --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->11.3. Sorting and Displaying the Glossary<div class="labellink"><a href="#sec:bib2glssortprint">[link]</a></div></h2><!-- end of section header -->
+<p>
+With <a id="wrglossary.12565"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.12566"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, the terms (read from the associated input file) are sorted and the code to typeset the <a id="wrglossary.12567"></a><a href="#glo:dual.glossary">glossary</a> is written to an output file, which is then input by <a id="wrglossary.12568"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>. With <a id="wrglossary.12569"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the entries supplied in the <a id="wrglossary.12570"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files are sorted and the entry definition code (<a id="wrglossary.12571"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a> or <a id="wrglossary.12572"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>) is written to the <a id="wrglossary.12573"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file in the order obtained by sorting. This means that the <a id="wrglossary.12574"></a><a href="#glo:dual.glossary">glossary’s</a> internal list is in the required order, so the <a id="wrglossary.12575"></a><a href="#glo:dual.glossary">glossary</a> can be displayed with <a id="wrglossary.12576"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> (see §<a href="#sec:printunsrt">8.4</a>).<p>
+The <a id="wrglossary.12577"></a><a href="#glo:dual.indexing">indexing</a> information, such as the <a id="wrglossary.12578"></a><a href="#glo:dual.locationlist">location list</a> or letter groups, is stored in fields such as <a id="wrglossary.12579"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a> or <a id="wrglossary.12580"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a> (where applicable), so the information can be included by <a id="wrglossary.12581"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>, but it means that the information is also available for use elsewhere in the document (so the <a id="wrglossary.12582"></a><a href="#glo:opt.savenumberlist"><span class="styoptfmt">savenumberlist</span></a> package option provided by <a id="wrglossary.12583"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> is redundant).<p>
+There are many sorting options provided by <a id="wrglossary.12584"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. The default is to sort according to the system locale. If the document has a language setting, you can use <a id="wrglossary.12585"></a><a href="#glo:opt.resource.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=doc</span> to instruct <a id="wrglossary.12586"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to sort according to that. (The language tag obtained from <a id="wrglossary.12587"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span>’s</a> interface is written to the <a id="wrglossary.12588"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file.) For a multilingual document you need to explicitly set the locale using a well-formed language tag. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.12589"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[
+ <a id="wrglossary.12590"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">=terms</span>, <span class="comment">% data in terms.bib</span>
+ <a id="wrglossary.12591"></a><a href="#glo:opt.resource.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=de-DE-1996</span> <span class="comment">% sort according to this locale</span>
]
-\glsxtrenablerecordcount
-\GlsXtrSetRecordCountAttribute{abbreviation}{1}
-\begin{document}
-\gls{lid}.&#x00A0;&#x00A0;\gls{stc}.&#x00A0;\gls{lid}.&#x00A0;&#x00A0;\gls{aeu}.
-\gls{upa}.&#x00A0;\gls{aeu}.
-\printunsrtglossaries
-\end{document}
-</pre>
-<!--l. 13342--><p class="nopar" > In the above, <span
-class="cmtt-10">stc </span>and <span
-class="cmtt-10">upa </span>both only have one record, so they are assigned to the
-<span
-class="cmtt-10">ignored </span>glossary instead of the <span
-class="cmtt-10">main </span>one.
-
-
-
-</p>
-<!--l. 13347--><p class="indent" > </div>
-</p><!--l. 13347--><p class="noindent" ><a
-href="#top">Top</a><div class="chapter"><h2 class="chapterHead">11. <a
- id="sec:miscnew"></a>Miscellaneous New Commands</h2>
-</p><!--l. 13350--><p class="indent" > The <span
-class="cmss-10">glossaries </span>package provides <span
-class="cmtt-10">\glsrefentry</span><a
- id="dx1-85001"></a> entry to cross-reference entries
-when used with the <a
-href="#styopt.entrycounter"><span
-class="cmss-10">entrycounter</span></a><a
- id="dx1-85002"></a> or <a
-href="#styopt.subentrycounter"><span
-class="cmss-10">subentrycounter</span></a><a
- id="dx1-85003"></a> options. The <span
-class="cmss-10">glossaries-extra</span>
-package provides a supplementary command
-</p><!--l. 13354--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-85004"></a> <span
-class="cmtt-10">\glsxtrpageref{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13356--><p class="noindent" >
-that works in the same way except that it uses <span
-class="cmtt-10">\pageref</span><a
- id="dx1-85005"></a> instead of <span
-class="cmtt-10">\ref</span><a
- id="dx1-85006"></a>.
-</p><!--l. 13360--><p class="indent" > You can copy an entry to another glossary using
-</p><!--l. 13361--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-85007"></a> <span
-class="cmtt-10">\glsxtrcopytoglossary{</span>&#x27E8;<span
-class="cmitt-10">entry-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">glossary-type</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13363--><p class="noindent" >
-This appends &#x27E8;<span
-class="cmti-10">entry-label</span>&#x27E9; to the end of the internal list for the glossary given by
-&#x27E8;<span
-class="cmti-10">glossary-type</span>&#x27E9;. Be careful if you use the <span
-class="cmss-10">hyperref</span><a
- id="dx1-85008"></a> package as this may cause duplicate
-hypertargets. You will need to change <span
-class="cmtt-10">\glolinkprefix </span>to another value or disable
-hyperlinks when you display the duplicate. Alternatively, use the new <span
-class="cmss-10">target</span><a
- id="dx1-85009"></a> key to
-switch off the targets:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-307">
-\printunsrtglossary[target=false]
-</pre>
-<!--l. 13373--><p class="nopar" >
-</p><!--l. 13375--><p class="indent" > The <span
-class="cmss-10">glossaries </span>package allows you to set preamble code for a given glossary
-type using <span
-class="cmtt-10">\setglossarypreamble</span>. This overrides any previous setting.
-With <span
-class="cmss-10">glossaries-extra </span>(as from v1.12) you can instead append to the preamble
-using
-</p><!--l. 13380--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-85010"></a> <span
-class="cmtt-10">\apptoglossarypreamble[</span>&#x27E8;<span
-class="cmitt-10">type</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">code</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13382--><p class="noindent" >
-or prepend using
-</p><!--l. 13384--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-85011"></a> <span
-class="cmtt-10">\pretoglossarypreamble[</span>&#x27E8;<span
-class="cmitt-10">type</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">code</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13386--><p class="noindent" >
-</p>
-<!--l. 13388--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">11.1 </span> <a
- id="sec:fields"></a>Entry Fields</h3>
-<!--l. 13391--><p class="noindent" >A field may now be used to store the name of a text-block command that takes a
-single argument. The field is given by
-</p><!--l. 13393--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86001"></a> <span
-class="cmtt-10">\GlsXtrFmtField </span></div><hr>
-</p><!--l. 13395--><p class="noindent" >
-The default value is <span
-class="cmtt-10">useri</span>. Note that the value must be the control sequence name
-<span
-class="cmti-10">without the initial backslash</span>.
-</p><!--l. 13400--><p class="indent" > For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-308">
-\newcommand*{\mtx}[1]{\boldsymbol{#1}}
-\newcommand*{\mtxinv}[1]{\mtx{#1}\sp{-1}}
-\newglossaryentry{matrix}{%
-&#x00A0;&#x00A0;name={matrix},
-&#x00A0;&#x00A0;symbol={\ensuremath{\mtx{M}}},
-&#x00A0;&#x00A0;plural={matrices},
-&#x00A0;&#x00A0;user1={mtx},
-&#x00A0;&#x00A0;description={rectangular&#x00A0;array&#x00A0;of&#x00A0;values}
+</pre> The locale-sensitive sort methods usually ignore most punctuation so for lists of symbols you may find it more appropriate to use one of the letter-base sort methods that sort according to the Unicode value of each character. Alternatively you can provide a custom rule. See the <a id="wrglossary.12592"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> manual for full details of all the available sort methods.<p>
+Suppose the <a id="wrglossary.12593"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> examples shown <a href="#examplebib">earlier</a> have been stored in the files <span class="filefmt">terms.bib</span>, <span class="filefmt">abbrvs.bib</span> and <span class="filefmt">symbols.bib</span> which may either be in the current directory or on TeX’s path. Then the document might look like: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+
+<code class="cmd">\usepackage</code>[record]{glossaries-extra}
+
+<a id="wrglossary.12594"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.12595"></a><a href="#glo:opt.abbrstyle.long-short-sc-desc"><span class="abbrstylefmt">long-short-sc-desc</span></a>}
+
+<a id="wrglossary.12596"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.12597"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">=terms,abbrvs,symbols</span>]
+
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.12598"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{bird}
+
+<a id="wrglossary.12599"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{shtml}
+
+<a id="wrglossary.12600"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{M}
+
+<a id="wrglossary.12601"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{printunsrtglossaries}
+<code class="cend">\end{document}</code>
+</pre> The document build process (assuming the document is called <span class="filefmt">mydoc</span>) is: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex mydoc
+bib2gls mydoc
+pdflatex mydoc
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:bib2gls"></a>Example 151: Using <span class="appfmt">bib2gls</span>: one resource set <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example151.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example151.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example151.png" type="image/png" width="391" height="311">Example document using bib2gls with one resource set.</object> </div><!-- end of resultbox -->
+ This creates a single glossary containing the entries: <code class="code">bird</code>, <code class="code">duck</code>, <code class="code">goose</code>, <code class="code">html</code>, <code class="code">M</code>, <code class="code">shtml</code> and <code class="code">ssi</code> (in that order). The <code class="code">bird</code>, <code class="code">shtml</code> and <code class="code">M</code> entries were added because <a id="wrglossary.12602"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> detected (from the <a id="wrglossary.12603"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file) that they had been used in the document. The other entries were added because <a id="wrglossary.12604"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> detected (from the <a id="wrglossary.12605"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files) that they are referenced by the used entries. In the case of <code class="code">duck</code> and <code class="code">goose</code>, they are in the <a id="wrglossary.12606"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> field for <code class="code">bird</code>. In the case of <code class="code">ssi</code> and <code class="code">html</code>, they are referenced in the <a id="wrglossary.12607"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> field of <code class="code">shtml</code>. These cross-referenced entries won’t have a <a id="wrglossary.12608"></a><a href="#glo:dual.locationlist">location list</a> when the <a id="wrglossary.12609"></a><a href="#glo:dual.glossary">glossary</a> is first displayed, but depending on how they are referenced, they may pick up a <a id="wrglossary.12610"></a><a href="#glo:dual.locationlist">location list</a> on the next document build. The <code class="code">xml</code> entry isn’t required at all, and so hasn’t been defined (from LaTeX’s point of view).<p>
+The entries can be separated into different glossaries with different sort methods: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.12611"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>,<a id="wrglossary.12612"></a><a href="#glo:opt.abbreviations"><span class="styoptfmt">abbreviations</span></a>,<a id="wrglossary.12613"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a>]{glossaries-extra}
+
+<a id="wrglossary.12614"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.12615"></a><a href="#glo:opt.abbrstyle.long-short-sc-desc"><span class="abbrstylefmt">long-short-sc-desc</span></a>}
+
+<a id="wrglossary.12616"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.12617"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">=terms</span>,<a id="wrglossary.12618"></a><a href="#glo:opt.resource.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=en-GB</span>,<a id="wrglossary.12619"></a><a href="#glo:opt.resource.type"><span class="csoptfmt">type</span></a><span class="optfmt">=main</span>]
+
+<a id="wrglossary.12620"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>
+ [<a id="wrglossary.12621"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">=abbrvs</span>,<a id="wrglossary.12622"></a><a href="#glo:opt.resource.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=letter-nocase</span>,<a id="wrglossary.12623"></a><a href="#glo:opt.resource.type"><span class="csoptfmt">type</span></a><span class="optfmt">=abbreviations</span>]
+
+<a id="wrglossary.12624"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>
+ [<a id="wrglossary.12625"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">=symbols</span>,<a id="wrglossary.12626"></a><a href="#glo:opt.resource.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=use</span>,<a id="wrglossary.12627"></a><a href="#glo:opt.resource.type"><span class="csoptfmt">type</span></a><span class="optfmt">=symbols</span>]
+
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.12628"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{bird}
+
+<a id="wrglossary.12629"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{shtml}
+
+<a id="wrglossary.12630"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{M}
+
+<a id="wrglossary.12631"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre><p>
+<div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:bib2glsmultiresources"></a>Example 152: Using <span class="appfmt">bib2gls</span>: multiple resource sets <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example152.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example152.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example152.png" type="image/png" width="391" height="395">Example document using bib2gls with multiple resource sets.</object> </div><!-- end of resultbox -->
+<p>
+Or you can have multiple instance of <a id="wrglossary.12632"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a> with the same <a id="wrglossary.12633"></a><a href="#glo:opt.resource.type"><span class="csoptfmt">type</span></a>, which will produce a <a id="wrglossary.12634"></a><a href="#glo:dual.glossary">glossary</a> with ordered sub-blocks. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.12635"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>,<a id="wrglossary.12636"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.12637"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a></span>]{glossaries-extra}
+
+<a id="wrglossary.12638"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.12639"></a><a href="#glo:opt.abbrstyle.long-short-sc-desc"><span class="abbrstylefmt">long-short-sc-desc</span></a>}
+
+<a id="wrglossary.12640"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>
+ [<a id="wrglossary.12641"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">=abbrvs</span>,<a id="wrglossary.12642"></a><a href="#glo:opt.resource.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=letter-nocase</span>,<a id="wrglossary.12643"></a><a href="#glo:opt.resource.type"><span class="csoptfmt">type</span></a><span class="optfmt">=main</span>,
+ <a id="wrglossary.12644"></a><a href="#glo:opt.resource.group"><span class="csoptfmt">group</span></a><span class="optfmt">=abbreviations</span>]
+<a id="wrglossary.12645"></a><a href="#glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></a>{abbreviations}{Abbreviations}
+
+<a id="wrglossary.12646"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>
+ [<a id="wrglossary.12647"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">=symbols</span>,<a id="wrglossary.12648"></a><a href="#glo:opt.resource.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=use</span>,<a id="wrglossary.12649"></a><a href="#glo:opt.resource.type"><span class="csoptfmt">type</span></a><span class="optfmt">=main</span>,
+ <a id="wrglossary.12650"></a><a href="#glo:opt.resource.group"><span class="csoptfmt">group</span></a><span class="optfmt">=symbols</span>]
+<a id="wrglossary.12651"></a><a href="#glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></a>{symbols}{Abbreviations}
+
+<a id="wrglossary.12652"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.12653"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">=terms</span>,<a id="wrglossary.12654"></a><a href="#glo:opt.resource.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=en-GB</span>,<a id="wrglossary.12655"></a><a href="#glo:opt.resource.type"><span class="csoptfmt">type</span></a><span class="optfmt">=main</span>]
+
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.12656"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{bird}
+
+<a id="wrglossary.12657"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{shtml}
+
+<a id="wrglossary.12658"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{M}
+
+<a id="wrglossary.12659"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> This sets the <a id="wrglossary.12660"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a> field for each resource set to the label given by the <a id="wrglossary.12661"></a><a href="#glo:opt.resource.group"><span class="csoptfmt">group</span></a> resource option.<p>
+This will result in a glossary where the first group has the label <code class="code">abbreviations</code> and title <span class="qt">“Abbreviations”</span>, the second group has the label <code class="code">symbols</code> and title <span class="qt">“Symbols”</span> and then follow the usual letter groups. Note that for this example to work, you must run <a id="wrglossary.12662"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> with the <a id="wrglossary.12663"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> (or <a id="wrglossary.12664"></a><a href="#glo:switch.group"><span class="shortargfmt">-g</span></a>) switch. For example, if the document is called <span class="filefmt">myDoc.tex</span>: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
+bib2gls <a id="wrglossary.12665"></a><a href="#glo:switch.group"><span class="shortargfmt">-g</span></a> myDoc
+pdflatex myDoc
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:bib2glssubblocks"></a>Example 153: Using <span class="appfmt">bib2gls</span>: sub-blocks <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example153.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example153.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example153.png" type="image/png" width="389" height="413">Example document using bib2gls with multiple resource sets for a single glossary to create a glossary with sub-blocks.</object> </div><!-- end of resultbox -->
+<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The value of the <a id="wrglossary.12666"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a> field must always be a label (so avoid special characters). You can set the corresponding title with <code class="code">glsxtrsetgrouptitle</code> (see §<a href="#sec:glosstylemods">8.6</a>). If no title is set then the label is used as the group title. </div><!-- end of important -->
+<p>
+You can provide your own custom sort rule. For example, if you are using XeLaTeX or LuaLaTeX: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.12667"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[
+ <a id="wrglossary.12668"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">={terms}</span>, <span class="comment">% entries in terms.bib</span>
+ <a id="wrglossary.12669"></a><a href="#glo:opt.resource.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=custom</span>, <span class="comment">% custom sort rule</span>
+ <a id="wrglossary.12670"></a><a href="#glo:opt.resource.sort-rule"><span class="csoptfmt">sort-rule</span></a><span class="optfmt">={<span class="comment">% required with sort=custom</span> &lt; æ;Æ &lt; a;á;å;ä,Ä;Á;Å;Ä &lt; b,B &lt; c;ć,C;Ć &lt; d,D &lt; e;é,E;É &lt; f,F &lt; g,G &lt; h,H &lt; i;í,I;Í &lt; j,J &lt; l;ł,L;Ł &lt; m,M &lt; n,N &lt; o;ö;ø,O;Ö;Ø &lt; p,P &lt; q,Q &lt; r,R &lt; s;ś,S;Ś &lt; t,T &lt; u;ú,U;Ú &lt; v,V &lt; w,W &lt; x,X &lt; y,Y &lt; z;ż,Z;Ż }</span>
+]
+</pre><p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+With old versions of the LaTeX kernel, <a id="wrglossary.12671"></a><a href="#glo:dual.utf8">UTF-8</a> characters, such as é or ø, will expand when written to the <a id="wrglossary.12672"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file. </div><!-- end of warning -->
+<p>
+Some of the options, including <a id="wrglossary.12673"></a><a href="#glo:opt.resource.sort-rule"><span class="csoptfmt">sort-rule</span></a>, allow Unicode characters to be indicated in the format <a id="wrglossary.12674"></a><a href="#glo:u"><code class="csfmt">\u</code></a><span class="meta">〈<em class="metainner">hex</em>〉</span> (or <a id="wrglossary.12675"></a><a href="#glo:u"><code class="csfmt">\u</code></a> <span class="meta">〈<em class="metainner">hex</em>〉</span>). <a id="wrglossary.12676"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> will recognise this as the character given by the hexadecimal value <span class="meta">〈<em class="metainner">hex</em>〉</span>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The <span class="meta">〈<em class="metainner">options</em>〉</span> provided to <a id="wrglossary.12677"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a> will expand as they are written to the <a id="wrglossary.12678"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file (unless protected). This includes <a id="wrglossary.12679"></a><a href="#glo:u"><code class="csfmt">\u</code></a>, so with a non-Unicode aware engine or where the document source is required to be <a id="wrglossary.12680"></a><a href="#glo:dual.ascii">ASCII</a>, the character æ needs to be written as <code class="code"><a id="wrglossary.12681"></a><a href="#glo:string"><code class="csfmt">\string</code></a><a id="wrglossary.12682"></a><a href="#glo:u"><code class="csfmt">\u</code></a> E6</code> and so on. Alternatively, use the shortcut <code class="code"><a id="wrglossary.12683"></a><a href="#glo:string"><code class="csfmt">\string</code></a><a id="wrglossary.12684"></a><a href="#glo:u"><code class="csfmt">\u</code></a> E6</code>. </div><!-- end of important -->
+<p>
+For example, the above can be rewritten as: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.12685"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[
+ <a id="wrglossary.12686"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">={terms}</span>, <span class="comment">% entries in terms.bib</span>
+ <a id="wrglossary.12687"></a><a href="#glo:opt.resource.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=custom</span>, <span class="comment">% custom sort rule</span>
+ <a id="wrglossary.12688"></a><a href="#glo:opt.resource.sort-rule"><span class="csoptfmt">sort-rule</span></a><span class="optfmt">={<span class="comment">% required with sort=custom</span> &lt; <a id="wrglossary.12689"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> E6;<a id="wrglossary.12690"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> C6 &lt; a;<a id="wrglossary.12691"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> E1;<a id="wrglossary.12692"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> E5,<a id="wrglossary.12693"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> E4,A;<a id="wrglossary.12694"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> C1;<a id="wrglossary.12695"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> C5;<a id="wrglossary.12696"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> C4 &lt; b,B &lt; c;<a id="wrglossary.12697"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> 0107,C;<a id="wrglossary.12698"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> 0106 &lt; d,D &lt; e;<a id="wrglossary.12699"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> E9,E;<a id="wrglossary.12700"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> C9 &lt; f,F &lt; g,G &lt; h,H &lt; i;<a id="wrglossary.12701"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> ED,I;<a id="wrglossary.12702"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> CD &lt; j,J &lt; l;<a id="wrglossary.12703"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> 0142,L;<a id="wrglossary.12704"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> 0141 &lt; m,M &lt; n,N &lt; o;<a id="wrglossary.12705"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> F6;<a id="wrglossary.12706"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> F8,O;<a id="wrglossary.12707"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> D6;<a id="wrglossary.12708"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> D8 &lt; p,P &lt; q,Q &lt; r,R &lt; s;<a id="wrglossary.12709"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> 013F,S;<a id="wrglossary.12710"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> 015A &lt; t,T &lt; u;<a id="wrglossary.12711"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> FA,U;<a id="wrglossary.12712"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> DA &lt; v,V &lt; w,W &lt; x,X &lt; y,Y &lt; z;<a id="wrglossary.12713"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> 017C,Z;<a id="wrglossary.12714"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> 017B }</span>
+]
+</pre><p>
+
+</section><!-- end of section sec:bib2glssortprint -->
+
+<section id="sec:recordcount"><!-- start of section sec:recordcount --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->11.4. Record Counting<div class="labellink"><a href="#sec:recordcount">[link]</a></div></h2><!-- end of section header -->
+<p>
+As from version 1.1 of <a id="wrglossary.12715"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, you can save the total record count for each entry by invoking <a id="wrglossary.12716"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> with the <a id="wrglossary.12717"></a><a href="#glo:switch.record-count"><span class="longargfmt">--record-count</span></a> or <a id="wrglossary.12718"></a><a href="#glo:switch.record-count-unit"><span class="longargfmt">--record-count-unit</span></a> switches. These options will ensure that when each entry is written to the <a id="wrglossary.12719"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file <a id="wrglossary.12720"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> will additionally set the following internal fields for that entry:
+<ul class="displaylist">
+ <li><span class="bulletitem">•</span><a id="wrglossary.12721"></a><a href="#glo:opt.glosfield.recordcount"><span class="csoptfmt">recordcount</span></a>: set to the total number of <a id="wrglossary.12722"></a><a href="#glo:@@glslabel@indexing">records</a> found for the entry; <li><span class="bulletitem">•</span><a id="wrglossary.12723"></a><a href="#glo:opt.glosfield.recordcount.counter"><span class="csoptfmt">recordcount.<span class="meta">〈<em class="metainner">counter</em>〉</span></span></a>: set to the total number of <a id="wrglossary.12724"></a><a href="#glo:@@glslabel@indexing">records</a> found for the entry for the given counter.
+</ul>
+ If <a id="wrglossary.12725"></a><a href="#glo:switch.record-count-unit"><span class="longargfmt">--record-count-unit</span></a> is used then additionally:
+<ul class="displaylist">
+ <li><span class="bulletitem">•</span><a id="wrglossary.12726"></a><a href="#glo:opt.glosfield.recordcount.counter.location"><span class="csoptfmt">recordcount.<span class="meta">〈<em class="metainner">counter</em>〉</span>.<span class="meta">〈<em class="metainner">location</em>〉</span></span></a>: set to the total number of <a id="wrglossary.12727"></a><a href="#glo:@@glslabel@indexing">records</a> found for the entry for the given counter with the given location.
+</ul>
+ Only use the unit counting option if the locations don’t contain any special characters. With <a id="wrglossary.12728"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> use <a id="wrglossary.12729"></a><a href="#glo:theHcounter"><code class="csfmt">\the<span class="meta">〈<em class="metainner">counter-name</em>〉</span></code></a> rather than <a id="wrglossary.12730"></a><a href="#glo:thecounter"><code class="csfmt">\the<span class="meta">〈<em class="metainner">counter-name</em>〉</span></code></a>. Otherwise, if you really need unit counting with locations that may contain formatting commands, then you can try redefining: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12731"></a><code class="code"><dfn id="glo:glsxtrdetoklocation"><code class="csfmt">\glsxtrdetoklocation</code></dfn>{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ so that it detokenizes <span class="meta">〈<em class="metainner">location</em>〉</span> but take care when using <a id="wrglossary.12732"></a><a href="#glo:GlsXtrLocationRecordCount"><code class="csfmt">\GlsXtrLocationRecordCount</code></a> with commands like <a id="wrglossary.12733"></a><a href="#glo:thepage"><code class="csfmt">\thepage</code></a> as they can end up becoming detokenized too early.<p>
+Note that the record count includes <a id="wrglossary.12734"></a><a href="#glo:@@glslabel@entrylocation">locations</a> that <a id="wrglossary.12735"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> discards, such as <a id="wrglossary.12736"></a><a href="#glo:@@glslabel@ignoredlocation">ignored records</a>, duplicates and partial duplicates (unless you filter them out with <a id="wrglossary.12737"></a><a href="#glo:switch.record-count-rule"><span class="longargfmt">--record-count-rule</span></a>). It doesn’t include cross-reference records. For example, suppose a document has an entry with the label <code class="code">bird</code> that is <a id="wrglossary.12738"></a><a href="#glo:@@glslabel@indexing">recorded</a> (<a id="wrglossary.12739"></a><a href="#glo:@@glslabel@indexing">indexed</a>) as follows:
+<dl class="inlinetitle">
+ Page 1 two (2) instances of <code class="code"><a id="wrglossary.12740"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{bird}</code>; Page 2 one (1) instance of <code class="code"><a id="wrglossary.12741"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{bird}</code>; Page 3 four (4) instances of <code class="code"><a id="wrglossary.12742"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{bird}</code>; Section 3 one (1) instance of <code class="code"><a id="wrglossary.12743"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.12744"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a><span class="optfmt">=section</span>]{bird}</code>.
+</dl>
+<p>
+Then the total record count (stored in the <a id="wrglossary.12745"></a><a href="#glo:opt.glosfield.recordcount"><span class="csoptfmt">recordcount</span></a> field) is 2+1+4+1=8, the total for the <a id="wrglossary.12746"></a><a href="#glo:ctr.page"><span class="ctrfmt">page</span></a> counter (stored in the <a id="wrglossary.12747"></a><a href="#glo:opt.glosfield.recordcount.counter"><span class="csoptfmt">recordcount.page</span></a> field) is 2+1+4=7, and the total for the <a id="wrglossary.12748"></a><a href="#glo:ctr.section"><span class="ctrfmt">section</span></a> counter (stored in the <a id="wrglossary.12749"></a><a href="#glo:opt.glosfield.recordcount.counter"><span class="csoptfmt">recordcount.section</span></a> field) is 1.<p>
+With the unit counting on as well, the following fields are assigned:
+<ul class="displaylist">
+ <li><span class="bulletitem">•</span><a id="wrglossary.12750"></a><a href="#glo:opt.glosfield.recordcount.counter.location"><span class="csoptfmt">recordcount.page.1</span></a> is set to 2; <li><span class="bulletitem">•</span><a id="wrglossary.12751"></a><a href="#glo:opt.glosfield.recordcount.counter.location"><span class="csoptfmt">recordcount.page.2</span></a> is set to 1; <li><span class="bulletitem">•</span><a id="wrglossary.12752"></a><a href="#glo:opt.glosfield.recordcount.counter.location"><span class="csoptfmt">recordcount.page.3</span></a> is set to 4; <li><span class="bulletitem">•</span><a id="wrglossary.12753"></a><a href="#glo:opt.glosfield.recordcount.counter.location"><span class="csoptfmt">recordcount.section.3</span></a> is set to 1.
+</ul>
+<p>
+You can access these fields using the following commands which will expand to the field value if set or to 0 if unset: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12754"></a><code class="code"><dfn id="glo:GlsXtrTotalRecordCount"><code class="csfmt">\GlsXtrTotalRecordCount</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This expands to the total record count for the entry given by <span class="meta">〈<em class="metainner">label</em>〉</span>. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.12755"></a><a href="#glo:GlsXtrTotalRecordCount"><code class="csfmt">\GlsXtrTotalRecordCount</code></a>{bird}
+</pre> expands to 8.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12756"></a><code class="code"><dfn id="glo:GlsXtrRecordCount"><code class="csfmt">\GlsXtrRecordCount</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This expands to the <a id="wrglossary.12757"></a><a href="#glo:@@glslabel@locationcounter">counter</a> total for the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> where <span class="meta">〈<em class="metainner">counter</em>〉</span> is the counter name. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.12758"></a><a href="#glo:GlsXtrRecordCount"><code class="csfmt">\GlsXtrRecordCount</code></a>{bird}{<a id="wrglossary.12759"></a><a href="#glo:ctr.page"><span class="ctrfmt">page</span></a>}
+</pre> expands to 7 and <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.12760"></a><a href="#glo:GlsXtrRecordCount"><code class="csfmt">\GlsXtrRecordCount</code></a>{bird}{<a id="wrglossary.12761"></a><a href="#glo:ctr.section"><span class="ctrfmt">section</span></a>}
+</pre> expands to 1.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12762"></a><code class="code"><dfn id="glo:GlsXtrLocationRecordCount"><code class="csfmt">\GlsXtrLocationRecordCount</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This expands to the total for the given <a id="wrglossary.12763"></a><a href="#glo:@@glslabel@entrylocation">location</a>. For example <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.12764"></a><a href="#glo:GlsXtrLocationRecordCount"><code class="csfmt">\GlsXtrLocationRecordCount</code></a>{bird}{<a id="wrglossary.12765"></a><a href="#glo:ctr.page"><span class="ctrfmt">page</span></a>}{3}
+</pre> expands to 4. Be careful about using <a id="wrglossary.12766"></a><a href="#glo:thepage"><code class="csfmt">\thepage</code></a> in the <span class="meta">〈<em class="metainner">location</em>〉</span> part. Remember that due to TeX’s asynchronous output routine, <a id="wrglossary.12767"></a><a href="#glo:thepage"><code class="csfmt">\thepage</code></a> may not be correct.<p>
+There are commands analogous to the entry counting commands like <a id="wrglossary.12768"></a><a href="#glo:cgls"><code class="csfmt">\cgls</code></a> and <a id="wrglossary.12769"></a><a href="#glo:cglsformat"><code class="csfmt">\cglsformat</code></a> that are triggered by the record count. These are listed below. The test to determine if the entry’s record count exceeds the trigger value (which should be stored in the <a id="wrglossary.12770"></a><a href="#glo:opt.catattr.recordcount"><span class="csoptfmt">recordcount</span></a> attribute) is obtained with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12771"></a><code class="code"><dfn id="glo:glsxtrifrecordtrigger"><code class="csfmt">\glsxtrifrecordtrigger</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If the <a id="wrglossary.12772"></a><a href="#glo:opt.catattr.recordcount"><span class="csoptfmt">recordcount</span></a> attribute is set and <span class="meta">〈<em class="metainner">total</em>〉</span> exceeds the value given by the <a id="wrglossary.12773"></a><a href="#glo:opt.catattr.recordcount"><span class="csoptfmt">recordcount</span></a> attribute, then this does <span class="meta">〈<em class="metainner">true</em>〉</span> otherwise it does <span class="meta">〈<em class="metainner">false</em>〉</span>. The <span class="meta">〈<em class="metainner">total</em>〉</span> is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12774"></a><code class="code"><dfn id="glo:glsxtrrecordtriggervalue"><code class="csfmt">\glsxtrrecordtriggervalue</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This should expand to the record count value that needs testing. The default definition is: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.12775"></a><a href="#glo:glsxtrrecordtriggervalue"><code class="csfmt">\glsxtrrecordtriggervalue</code></a>}[1]{%
+ <a id="wrglossary.12776"></a><a href="#glo:GlsXtrTotalRecordCount"><code class="csfmt">\GlsXtrTotalRecordCount</code></a>{#1}%
}
-\newglossaryentry{identitymatrix}{%
-&#x00A0;&#x00A0;name={identity&#x00A0;matrix},
-&#x00A0;&#x00A0;symbol={\ensuremath{\mtx{I}}},
-&#x00A0;&#x00A0;plural={identity&#x00A0;matrices},
-&#x00A0;&#x00A0;description={a&#x00A0;diagonal&#x00A0;matrix&#x00A0;with&#x00A0;all&#x00A0;diagonal&#x00A0;elements&#x00A0;equal&#x00A0;to
-1&#x00A0;and&#x00A0;all&#x00A0;other&#x00A0;elements&#x00A0;equal&#x00A0;to&#x00A0;0}
+</pre> This command may be redefined as appropriate. For example, it may be redefined to use <a id="wrglossary.12777"></a><a href="#glo:GlsXtrRecordCount"><code class="csfmt">\GlsXtrRecordCount</code></a> for a particular <a id="wrglossary.12778"></a><a href="#glo:dual.locationcounter">location counter</a> or to use <a id="wrglossary.12779"></a><a href="#glo:GlsXtrLocationRecordCount"><code class="csfmt">\GlsXtrLocationRecordCount</code></a> for a particular location.<p>
+The <a id="wrglossary.12780"></a><a href="#glo:opt.catattr.recordcount"><span class="csoptfmt">recordcount</span></a> attribute may be set with <a id="wrglossary.12781"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a> or can be set for each listed category with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12782"></a><code class="code"><dfn id="glo:GlsXtrSetRecordCountAttribute"><code class="csfmt">\GlsXtrSetRecordCountAttribute</code></dfn>{<span class="meta">〈<em class="metainner">category-list</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The value must be an integer.<p>
+Commands like <a id="wrglossary.12783"></a><a href="#glo:rgls"><code class="csfmt">\rgls</code></a> behave slightly differently to <a id="wrglossary.12784"></a><a href="#glo:cgls"><code class="csfmt">\cgls</code></a>. It’s necessary for the command to add a <a id="wrglossary.12785"></a><a href="#glo:@@glslabel@indexing">record</a> to the <a id="wrglossary.12786"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file in order for the entry to be selected and for the record count to be correct on the next <a id="wrglossary.12787"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>+LaTeX run (for the default <a id="wrglossary.12788"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">={recorded and deps}</span>). The trigger record is created with <a id="wrglossary.12789"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=glstriggerrecordformat</span>, which <a id="wrglossary.12790"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v1.1+ recognises as a special type of <a id="wrglossary.12791"></a><a href="#glo:dual.ignoredlocation">ignored location</a> format. This corresponds to the command: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12792"></a><code class="code"><dfn id="glo:glstriggerrecordformat"><code class="csfmt">\glstriggerrecordformat</code></dfn>{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ As with <a id="wrglossary.12793"></a><a href="#glo:glsignore"><code class="csfmt">\glsignore</code></a>, this command does nothing and is considered an ignored record (so it won’t appear in the <a id="wrglossary.12794"></a><a href="#glo:dual.locationlist">location list</a>), but it indicates to <a id="wrglossary.12795"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> that the entry must be selected and, if the <a id="wrglossary.12796"></a><a href="#glo:opt.resource.trigger-type"><span class="csoptfmt">trigger-type</span></a> option has been set, the entry will be assigned to the <a id="wrglossary.12797"></a><a href="#glo:opt.resource.trigger-type"><span class="csoptfmt">trigger-type</span></a> glossary.<p>
+For example, to assign the entry to an <a id="wrglossary.12798"></a><a href="#glo:dual.ignoredglossary">ignored glossary</a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.12799"></a><a href="#glo:newignoredglossary"><code class="csfmt">\newignoredglossary</code></a>{ignored}
+<a id="wrglossary.12800"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.12801"></a><a href="#glo:opt.resource.trigger-type"><span class="csoptfmt">trigger-type</span></a><span class="optfmt">=ignored</span>]
+</pre> This ensures that the entry is defined but it won’t show up the normal glossary.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+The <a id="wrglossary.12802"></a><a href="#glo:dual.postlinkhook">post-link hook</a> won’t be implemented if the record trigger is tripped. (That is, if the <a id="wrglossary.12803"></a><a href="#glo:rglsformat"><code class="csfmt">\rglsformat</code></a>-like command is used instead of the <a id="wrglossary.12804"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> command.) </div><!-- end of information -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12805"></a><code class="code"><dfn id="glo:rgls"><code class="csfmt">\rgls</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.12806"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.12807"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.12808"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ If the value has been supplied by the <a id="wrglossary.12809"></a><a href="#glo:opt.catattr.recordcount"><span class="csoptfmt">recordcount</span></a> attribute and is exceeded, this behaves like <a id="wrglossary.12810"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> otherwise it creates a trigger record and uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12811"></a><code class="code"><dfn id="glo:rglsformat"><code class="csfmt">\rglsformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This has the same definition as <a id="wrglossary.12812"></a><a href="#glo:cglsformat"><code class="csfmt">\cglsformat</code></a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12813"></a><code class="code"><dfn id="glo:rglspl"><code class="csfmt">\rglspl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.12814"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.12815"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.12816"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ If the value has been supplied by the <a id="wrglossary.12817"></a><a href="#glo:opt.catattr.recordcount"><span class="csoptfmt">recordcount</span></a> attribute and is exceeded, this behaves like <a id="wrglossary.12818"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> otherwise it creates a trigger record and uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12819"></a><code class="code"><dfn id="glo:rglsplformat"><code class="csfmt">\rglsplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which uses the appropriate plural fields.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12820"></a><code class="code"><dfn id="glo:rGls"><code class="csfmt">\rGls</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.12821"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.12822"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.12823"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ If the value has been supplied by the <a id="wrglossary.12824"></a><a href="#glo:opt.catattr.recordcount"><span class="csoptfmt">recordcount</span></a> attribute and is exceeded, this behaves like <a id="wrglossary.12825"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> otherwise it creates a trigger record and uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12826"></a><code class="code"><dfn id="glo:rGlsformat"><code class="csfmt">\rGlsformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which performs the appropriate case-change.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12827"></a><code class="code"><dfn id="glo:rGlspl"><code class="csfmt">\rGlspl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.12828"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.12829"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.12830"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ If the value has been supplied by the <a id="wrglossary.12831"></a><a href="#glo:opt.catattr.recordcount"><span class="csoptfmt">recordcount</span></a> attribute and is exceeded, this behaves like <a id="wrglossary.12832"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a> otherwise it creates a trigger record and uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12833"></a><code class="code"><dfn id="glo:rGlsplformat"><code class="csfmt">\rGlsplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which uses the appropriate plural fields and case-change.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12834"></a><code class="code"><dfn id="glo:rGLS"><code class="csfmt">\rGLS</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.12835"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.12836"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.12837"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ If the value has been supplied by the <a id="wrglossary.12838"></a><a href="#glo:opt.catattr.recordcount"><span class="csoptfmt">recordcount</span></a> attribute and is exceeded, this behaves like <a id="wrglossary.12839"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a> otherwise it creates a trigger record and uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12840"></a><code class="code"><dfn id="glo:rGLSformat"><code class="csfmt">\rGLSformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which performs the appropriate case-change.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12841"></a><code class="code"><dfn id="glo:rGLSpl"><code class="csfmt">\rGLSpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.12842"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.12843"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.12844"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ If the value has been supplied by the <a id="wrglossary.12845"></a><a href="#glo:opt.catattr.recordcount"><span class="csoptfmt">recordcount</span></a> attribute and is exceeded, this behaves like <a id="wrglossary.12846"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a> otherwise it creates a trigger record and uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12847"></a><code class="code"><dfn id="glo:rGLSplformat"><code class="csfmt">\rGLSplformat</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which uses the appropriate plural fields and case-change.<p>
+To make it easier to switch on record counting for an existing document, you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12848"></a><code class="code"><dfn id="glo:glsxtrenablerecordcount"><code class="csfmt">\glsxtrenablerecordcount</code></dfn></code></div><!-- end of pinnedbox -->
+ This redefines <a id="wrglossary.12849"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>, <a id="wrglossary.12850"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>, <a id="wrglossary.12851"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>, <a id="wrglossary.12852"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a>, <a id="wrglossary.12853"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a>, <a id="wrglossary.12854"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a> to <a id="wrglossary.12855"></a><a href="#glo:rgls"><code class="csfmt">\rgls</code></a>, <a id="wrglossary.12856"></a><a href="#glo:rglspl"><code class="csfmt">\rglspl</code></a>, <a id="wrglossary.12857"></a><a href="#glo:rGls"><code class="csfmt">\rGls</code></a>, <a id="wrglossary.12858"></a><a href="#glo:rGlspl"><code class="csfmt">\rGlspl</code></a>, <a id="wrglossary.12859"></a><a href="#glo:rGLS"><code class="csfmt">\rGLS</code></a>, <a id="wrglossary.12860"></a><a href="#glo:rGLSpl"><code class="csfmt">\rGLSpl</code></a>, respectively, for convenience. This command will also switch the shortcut commands such as <a id="wrglossary.12861"></a><a href="#glo:ac"><code class="csfmt">\ac</code></a> or <a id="wrglossary.12862"></a><a href="#glo:ab"><code class="csfmt">\ab</code></a>, if they have been enabled, from using the <a id="wrglossary.12863"></a><a href="#glo:cgls"><code class="csfmt">\cgls</code></a>-like commands to the corresponding <a id="wrglossary.12864"></a><a href="#glo:rgls"><code class="csfmt">\rgls</code></a> command.<p>
+For example, using the earlier <a id="examplebib"><span class="filefmt">terms.bib</span>, <span class="filefmt">abbrvs.bib</span> and <span class="filefmt">symbols.bib</span></a> example files: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+
+<code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.12865"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>]{glossaries-extra}
+
+<a id="wrglossary.12866"></a><a href="#glo:newignoredglossary"><code class="csfmt">\newignoredglossary</code></a>{ignored}
+
+<a id="wrglossary.12867"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.12868"></a><a href="#glo:opt.abbrstyle.long-short-sc-desc"><span class="abbrstylefmt">long-short-sc-desc</span></a>}
+<a id="wrglossary.12869"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[
+ <a id="wrglossary.12870"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">={terms,abbrvs,symbols}</span>,
+ <a id="wrglossary.12871"></a><a href="#glo:opt.resource.trigger-type"><span class="csoptfmt">trigger-type</span></a><span class="optfmt">=ignored</span>,
+ <a id="wrglossary.12872"></a><a href="#glo:opt.resource.category"><span class="csoptfmt">category</span></a><span class="optfmt">={same as entry}</span>
+]
+
+<a id="wrglossary.12873"></a><a href="#glo:glsxtrenablerecordcount"><code class="csfmt">\glsxtrenablerecordcount</code></a>
+<a id="wrglossary.12874"></a><a href="#glo:GlsXtrSetRecordCountAttribute"><code class="csfmt">\GlsXtrSetRecordCountAttribute</code></a>{<a id="wrglossary.12875"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>,<a id="wrglossary.12876"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a>}{1}
+
+<a id="wrglossary.12877"></a><a href="#glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></a>{entry}{<a id="wrglossary.12878"></a><a href="#glo:glsxtrpostlinkAddDescOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddDescOnFirstUse</code></a>}
+<a id="wrglossary.12879"></a><a href="#glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></a>{<a id="wrglossary.12880"></a><a href="#glo:opt.cat.symbol"><span class="csoptfmt">symbol</span></a>}{<a id="wrglossary.12881"></a><a href="#glo:glsxtrpostlinkAddDescOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddDescOnFirstUse</code></a>}
+
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.12882"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{bird}, <a id="wrglossary.12883"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi}, <a id="wrglossary.12884"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{bird}, <a id="wrglossary.12885"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html},
+<a id="wrglossary.12886"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{M}, <a id="wrglossary.12887"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}.
+
+<a id="wrglossary.12888"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> If the document is called <span class="filefmt">myDoc.tex</span>, then the build process is: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
+bib2gls <a id="wrglossary.12889"></a><a href="#glo:switch.record-count"><span class="longargfmt">--record-count</span></a> myDoc
+pdflatex myDoc
+</pre> The <a id="wrglossary.12890"></a><a href="#glo:opt.resource.category"><span class="csoptfmt">category</span></a><span class="optfmt">={same as entry}</span> resource option assigns the <a id="wrglossary.12891"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> field to the <a id="wrglossary.12892"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> entry type (without the initial <code class="code">@</code>). This means that the entries defined in <span class="filefmt">terms.bib</span> (with <code class="code">@entry</code>) have their <a id="wrglossary.12893"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> set to <code class="code">entry</code>, the entries defined in <span class="filefmt">abbrvs.bib</span> (with <code class="code">@abbreviation</code>) have their <a id="wrglossary.12894"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> set to <code class="code">abbreviation</code>, and the entries defined in <span class="filefmt">symbols.bib</span> (with <code class="code">@symbol</code>) have their <a id="wrglossary.12895"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> set to <code class="code">symbol</code>.<p>
+I’ve added <a id="wrglossary.12896"></a><a href="#glo:dual.postlinkhook">post-link hooks</a> to the <span class="csoptfmt">entry</span> and <span class="csoptfmt">symbol</span> categories to show the description on <a id="wrglossary.12897"></a><a href="#glo:dual.firstuse">first use</a> (but not for the <span class="csoptfmt">abbreviation</span> category). <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:bib2glsrecordcounting"></a>Example 154: Using <span class="appfmt">bib2gls</span>: record counting <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example154.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example154.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example154.png" type="image/png" width="389" height="244">Example document using bib2gls with multiple resource sets.</object> </div><!-- end of resultbox -->
+ In the above, <code class="code">ssi</code> and <code class="code">bird</code> only have one record. However, they have been treated differently. The <code class="code">ssi</code> entry is using <a id="wrglossary.12898"></a><a href="#glo:rglsformat"><code class="csfmt">\rglsformat</code></a> whereas the <code class="code">bird</code> entry is using the normal <a id="wrglossary.12899"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> behaviour. This is because the record counting hasn’t been applied to the custom <span class="csoptfmt">entry</span> category, whereas it has been applied to the <span class="csoptfmt">abbreviation</span> and <span class="csoptfmt">symbol</span> categories.<p>
+
+</section><!-- end of section sec:recordcount -->
+
+<section id="sec:unitrecordcount"><!-- start of section sec:unitrecordcount --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->11.4.1. Unit Record Counting<div class="labellink"><a href="#sec:unitrecordcount">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+If you want unit record counting you need to remember to invoke <a id="wrglossary.12900"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> with <a id="wrglossary.12901"></a><a href="#glo:switch.record-count-unit"><span class="longargfmt">--record-count-unit</span></a> and you will also need to redefine <a id="wrglossary.12902"></a><a href="#glo:glsxtrrecordtriggervalue"><code class="csfmt">\glsxtrrecordtriggervalue</code></a> appropriately. For example, suppose you want to reset all abbreviations at the start of each chapter, so that the full form is shown again, but only if the abbreviation isn’t used elsewhere in the chapter.<p>
+This would require records with the <a id="wrglossary.12903"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a> set to <a id="wrglossary.12904"></a><a href="#glo:ctr.chapter"><span class="ctrfmt">chapter</span></a>. This can be done with the <a id="wrglossary.12905"></a><a href="#glo:opt.counter"><span class="styoptfmt">counter</span></a> package option: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.12906"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>,<a id="wrglossary.12907"></a><a href="#glo:opt.counter"><span class="styoptfmt">counter</span></a><span class="optfmt">=<a id="wrglossary.12908"></a><a href="#glo:ctr.chapter"><span class="ctrfmt">chapter</span></a></span>]{glossaries-extra}
+</pre> However, this will have chapter numbers instead of page numbers in the <a id="wrglossary.12909"></a><a href="#glo:dual.locationlist">location lists</a>. If you don’t want <a id="wrglossary.12910"></a><a href="#glo:dual.locationlist">location lists</a> then this isn’t a problem. The list can simply be suppressed with <a id="wrglossary.12911"></a><a href="#glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></a>.<p>
+If you want page numbers in the <a id="wrglossary.12912"></a><a href="#glo:dual.locationlist">location lists</a> then you will need to <a id="wrglossary.12913"></a><a href="#glo:@@glslabel@indexing">record</a> each entry with both the <a id="wrglossary.12914"></a><a href="#glo:ctr.page"><span class="ctrfmt">page</span></a> and <a id="wrglossary.12915"></a><a href="#glo:ctr.chapter"><span class="ctrfmt">chapter</span></a> counters. This can be done with the hook that occurs before the <a id="wrglossary.12916"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> options are set: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.12917"></a><a href="#glo:glslinkpresetkeys"><code class="csfmt">\glslinkpresetkeys</code></a>}{<span class="comment">% </span>
+ <a id="wrglossary.12918"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>[<a id="wrglossary.12919"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=glsignore</span>,<a id="wrglossary.12920"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a><span class="optfmt">=<a id="wrglossary.12921"></a><a href="#glo:ctr.chapter"><span class="ctrfmt">chapter</span></a></span>]{<a id="wrglossary.12922"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}}
+</pre> Note that I’ve used the ignored location format to prevent the chapter number from being added to the <a id="wrglossary.12923"></a><a href="#glo:dual.locationlist">location list</a>. An alternative is to use the <a id="wrglossary.12924"></a><a href="#glo:opt.resource.loc-counters"><span class="csoptfmt">loc-counters</span></a><span class="optfmt">=<a id="wrglossary.12925"></a><a href="#glo:ctr.page"><span class="ctrfmt">page</span></a></span> resource option to only show the locations that use the <a id="wrglossary.12926"></a><a href="#glo:ctr.page"><span class="ctrfmt">page</span></a> counter.<p>
+The definition of <a id="wrglossary.12927"></a><a href="#glo:glsxtrrecordtriggervalue"><code class="csfmt">\glsxtrrecordtriggervalue</code></a> needs to be changed so that it uses the total for the given location. If <a id="wrglossary.12928"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> is used, you will need <a id="wrglossary.12929"></a><a href="#glo:theHcounter"><code class="csfmt">\theHchapter</code></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.12930"></a><a href="#glo:glsxtrrecordtriggervalue"><code class="csfmt">\glsxtrrecordtriggervalue</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.12931"></a><a href="#glo:GlsXtrLocationRecordCount"><code class="csfmt">\GlsXtrLocationRecordCount</code></a>{#1}{<a id="wrglossary.12932"></a><a href="#glo:ctr.chapter"><span class="ctrfmt">chapter</span></a>}{<a id="wrglossary.12933"></a><a href="#glo:theHcounter"><code class="csfmt">\theHchapter</code></a>}<span class="comment">% </span>
}
-\newglossaryentry{matrixinv}{%
-&#x00A0;&#x00A0;name={matrix&#x00A0;inverse},
-&#x00A0;&#x00A0;symbol={\ensuremath{\mtxinv{M}}},
-&#x00A0;&#x00A0;user1={mtxinv},
-&#x00A0;&#x00A0;description={a&#x00A0;square&#x00A0;\gls{matrix}&#x00A0;such&#x00A0;that
-&#x00A0;&#x00A0;&#x00A0;$\mtx{M}\mtxinv{M}=\glssymbol{identitymatrix}$}
+</pre> otherwise use <a id="wrglossary.12934"></a><a href="#glo:thecounter"><code class="csfmt">\thechapter</code></a>.<p>
+Consider the following (using the abbreviations defined in the earlier <span class="filefmt">abbrvs.bib</span>): <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cbeg">\begin{document}</code>
+<code class="cmd">\chapter</code>{First}
+<a id="wrglossary.12935"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}. <a id="wrglossary.12936"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}. <a id="wrglossary.12937"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}. <a id="wrglossary.12938"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi}.
+
+<code class="cmd">\chapter</code>{Second}
+<a id="wrglossary.12939"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}. <a id="wrglossary.12940"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi}. <a id="wrglossary.12941"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi}.
+<a id="wrglossary.12942"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{xml}.
+
+<a id="wrglossary.12943"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> Note that the <code class="code">xml</code> entry is only used once in the entire document, but it will still be added to the glossary.<p>
+The previous example used the <a id="wrglossary.12944"></a><a href="#glo:opt.resource.trigger-type"><span class="csoptfmt">trigger-type</span></a> resource option to move entries with the <a id="wrglossary.12945"></a><a href="#glo:glstriggerrecordformat"><span class="csfmtcolourfont">glstriggerrecordformat</span></a> encap (that is, they didn’t exceed the trigger value) to another glossary. Unfortunately, using that option in this case will move all three abbreviations to the <a id="wrglossary.12946"></a><a href="#glo:opt.resource.trigger-type"><span class="csoptfmt">trigger-type</span></a> glossary. The <code class="code">ssi</code> entry is only used once in the first chapter (but is used twice in the second chapter), and the <code class="code">html</code> is only used once in the second chapter (but is used three times in the first chapter). So all three will have <a id="wrglossary.12947"></a><a href="#glo:@@glslabel@indexing">records</a> in the <a id="wrglossary.12948"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file with the special <a id="wrglossary.12949"></a><a href="#glo:glstriggerrecordformat"><span class="csfmtcolourfont">glstriggerrecordformat</span></a> format.<p>
+A simple solution is to omit any entries that don’t have the <a id="wrglossary.12950"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a> field set when displaying the glossary: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.12951"></a><a href="#glo:printunsrtglossaryentryprocesshook"><code class="csfmt">\printunsrtglossaryentryprocesshook</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.12952"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a>*{<a id="wrglossary.12953"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a>}{#1}
+ {}{<a id="wrglossary.12954"></a><a href="#glo:printunsrtglossaryskipentry"><code class="csfmt">\printunsrtglossaryskipentry</code></a>}<span class="comment">% </span>
}
-</pre>
-<!--l. 13428--><p class="nopar" >
-</p><!--l. 13430--><p class="indent" > There are two commands provided that allow you to apply the command to an
-argument:
-</p><!--l. 13432--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86002"></a> <span
-class="cmtt-10">\glsxtrfmt[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13434--><p class="noindent" >
-This effectively does </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\glslink[</span>&#x27E8;<span
-class="cmitt-10">default-options</span>&#x27E9;<span
-class="cmtt-10">,</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">\glsxtrfmtdisplay</span>
-<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">cs</span><span
-class="cmitt-10">&#x00A0;name</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">}</span><span
-class="cmsy-10">{}}</span>
-</div>
-</div> where &#x27E8;<span
-class="cmti-10">cs name</span>&#x27E9; is the control sequence name supplied in the provided field, which
-must be defined to take a single required argument. Although it effectively acts like
-<span
-class="cmtt-10">\glslink </span>it misses out the post-link hook.
-<!--l. 13444--><p class="indent" > The default &#x27E8;<span
-class="cmti-10">default-options</span>&#x27E9; are given by
-
-
-
-</p><!--l. 13445--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86003"></a> <span
-class="cmtt-10">\GlsXtrFmtDefaultOptions </span></div><hr>
-</p><!--l. 13447--><p class="noindent" >
-This is defined as <span
-class="cmtt-10">noindex </span>but may be redefined as appropriate. Note that the
-replacement text of <span
-class="cmtt-10">\GlsXtrFmtDefaultOptions </span>is prepended to the optional
-argument of <span
-class="cmtt-10">\glslink</span>.
-</p><!--l. 13453--><p class="indent" > As from version 1.23, there&#8217;s also a starred version of this command that has a
-final optional argument:
-</p><!--l. 13455--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86004"></a> <span
-class="cmtt-10">\glsxtrfmt*[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">}[</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 13457--><p class="noindent" >
-Both the starred and unstarred versions use:
-</p><!--l. 13459--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86005"></a> <span
-class="cmtt-10">\glsxtrfmtdisplay{</span>&#x27E8;<span
-class="cmitt-10">cs name</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">insert</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13461--><p class="noindent" >
-within the link text. In the case of the unstarred version &#x27E8;<span
-class="cmti-10">insert</span>&#x27E9; will be empty. It will
-also be empty if the final option argument is missing from the starred form. If the
-entry given by &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; is undefined <span
-class="cmtt-10">\glsxtrfmt </span>and <span
-class="cmtt-10">\glsxtrfmt* </span>will issue an error (or
-warning if <a
-href="#styopt.undefaction"><span
-class="cmss-10">undefaction</span></a><span
-class="cmss-10">=warn</span><a
- id="dx1-86006"></a>). There won&#8217;t be a warning or error if the entry is
-defined by the given field is missing. In either case, (the entry is undefined or the field
-is missing) &#x27E8;<span
-class="cmti-10">cs name</span>&#x27E9; will be <span
-class="cmtt-10">@firstofone </span>otherwise it will be the field value. The
-default definition is:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-309">
-\newcommand{\glsxtrfmtdisplay}[3]{\csuse{#1}{#2}#3}
-</pre>
-<!--l. 13475--><p class="nopar" > which puts &#x27E8;<span
-class="cmti-10">text</span>&#x27E9; inside the argument of the control sequence and &#x27E8;<span
-class="cmti-10">insert</span>&#x27E9; outside it
-(but it will still be inside the link text).
-</p><!--l. 13480--><p class="indent" > <div class="important" title="Important Note"> Remember that nested links cause a problem so avoid using commands like <span
-class="cmtt-10">\gls</span>
-or <span
-class="cmtt-10">\glsxtrfmt </span>within &#x27E8;<span
-class="cmti-10">text</span>&#x27E9;. </div>
-</p><!--l. 13483--><p class="noindent" >
-</p><!--l. 13485--><p class="indent" > For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-310">
-\[
-&#x00A0;&#x00A0;\glsxtrfmt{matrix}{A}
-&#x00A0;&#x00A0;\glsxtrfmt{matrixinv}{A}
-&#x00A0;&#x00A0;=
-&#x00A0;&#x00A0;\glssymbol{identitymatrix}
-\]
-</pre>
-<!--l. 13493--><p class="nopar" > If the default options are set to <span
-class="cmtt-10">noindex </span>then <span
-class="cmtt-10">\glsxtrfmt </span>won&#8217;t index, but will
-create a hyperlink (if <span
-class="cmss-10">hyperref</span><a
- id="dx1-86007"></a> has been loaded). This can be changed so that it also
-suppresses the hyperlink:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-311">
-\renewcommand{\GlsXtrFmtDefaultOptions}{hyper=false,noindex}
-</pre>
-<!--l. 13500--><p class="nopar" >
-</p><!--l. 13502--><p class="indent" > Note that <span
-class="cmtt-10">\glsxtrfmt </span>won&#8217;t work with PDF bookmarks. Instead you can
-use
-</p><!--l. 13504--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86008"></a> <span
-class="cmtt-10">\glsxtrentryfmt{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13506--><p class="noindent" >
-If <span
-class="cmss-10">hyperref</span><a
- id="dx1-86009"></a> is used, this uses <span
-class="cmtt-10">\texorpdfstring </span>and will expand to
-</p><!--l. 13508--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86010"></a> <span
-class="cmtt-10">\glsxtrpdfentryfmt{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13510--><p class="noindent" >
-within the PDF bookmarks, but in the document it will do &#x27E8;<span
-class="cmti-10">cs</span>&#x27E9;<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmti-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span>if a control
-sequence name has been provided or just &#x27E8;<span
-class="cmti-10">text</span>&#x27E9; otherwise. The PDF bookmark version
-simply does &#x27E8;<span
-class="cmti-10">text</span>&#x27E9;. It may be redefined, but remember that it needs to expand
-fully.
-</p><!--l. 13517--><p class="indent" > The <span
-class="cmss-10">glossaries </span>package provides <span
-class="cmtt-10">\glsaddstoragekey </span>to add new keys. This
-command will cause an error if the key has already been defined. The <span
-class="cmss-10">glossaries-extra</span>
-package provides a supplementary command that will only define the key if it doesn&#8217;t
-already exist:
-</p><!--l. 13522--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86011"></a> <span
-class="cmtt-10">\glsxtrprovidestoragekey{</span>&#x27E8;<span
-class="cmitt-10">key</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">default</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">cs</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13524--><p class="noindent" >
-If the key has already been defined, it will still provide the command given in the
-third argument &#x27E8;<span
-class="cmti-10">cs</span>&#x27E9; (if it hasn&#8217;t already been defined). Unlike <span
-class="cmtt-10">\glsaddstoragekey</span>, &#x27E8;<span
-class="cmti-10">cs</span>&#x27E9;
-may be left empty if you&#8217;re happy to just use <span
-class="cmtt-10">\glsfieldfetch </span>to fetch the value of
-this new key.
-</p><!--l. 13530--><p class="indent" > You can test if a key has been provided with:
-</p><!--l. 13531--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86012"></a> <span
-class="cmtt-10">\glsxtrifkeydefined{</span>&#x27E8;<span
-class="cmitt-10">key</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13533--><p class="noindent" >
-This tests if &#x27E8;<span
-class="cmti-10">key</span>&#x27E9; is available for use in the &#x27E8;<span
-class="cmti-10">key</span>&#x27E9;= list in the second argument of
-<span
-class="cmtt-10">\newglossaryentry </span>(or the optional argument of commands like <span
-class="cmtt-10">\newabbreviation</span>).
-The corresponding field may not have been set for any of the entries if no default was
-provided.
-</p><!--l. 13541--><p class="indent" > There are now commands provided to set individual fields. Note that
-these only change the specified field, not any related values. For example,
-changing the value of the <span
-class="cmss-10">text</span><a
- id="dx1-86013"></a> field won&#8217;t update the <span
-class="cmss-10">plural</span><a
- id="dx1-86014"></a> field. There are also
-some fields that should really only be set when entries are defined (such as
-the <span
-class="cmss-10">parent</span><a
- id="dx1-86015"></a> field). Unexpected results may occur if they are subsequently
-changed.
-</p><!--l. 13549--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86016"></a> <span
-class="cmtt-10">\GlsXtrSetField{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">value</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13551--><p class="noindent" >
-Sets the field given by &#x27E8;<span
-class="cmti-10">field</span>&#x27E9; to &#x27E8;<span
-class="cmti-10">value</span>&#x27E9; for the entry given by &#x27E8;<span
-class="cmti-10">label</span>&#x27E9;. No expansion is
-performed. It&#8217;s not necessary for the field to have been defined as a key. You can
-access the value later with <span
-class="cmtt-10">\glsxtrusefield</span>. Note that <span
-class="cmtt-10">\glsxtrifkeydefined </span>only
-
-
-
-tests if a key has been defined for use with commands like <span
-class="cmtt-10">\newglossaryentry</span>. If a
-field without a corresponding key is assigned a value, the key remains undefined. This
-command is robust.
-</p><!--l. 13561--><p class="indent" > <span
-class="cmtt-10">\GlsXtrSetField </span>uses
-</p><!--l. 13562--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86017"></a> <span
-class="cmtt-10">\glsxtrsetfieldifexists{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">code</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13564--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; is the entry label and &#x27E8;<span
-class="cmti-10">code</span>&#x27E9; is the assignment code.
-</p><!--l. 13568--><p class="indent" > This command just uses <span
-class="cmtt-10">\glsdoifexists</span><a
- id="dx1-86018"></a><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmti-10">code</span>&#x27E9;<span
-class="cmtt-10">} </span>(ignoring the
-&#x27E8;<span
-class="cmti-10">field</span>&#x27E9; argument), so by default it causes an error if the entry doesn&#8217;t exist.
-This can be changed to a warning with <a
-href="#styopt.undefaction"><span
-class="cmss-10">undefaction</span></a><span
-class="cmss-10">=warn</span><a
- id="dx1-86019"></a>. You can redefine
-<span
-class="cmtt-10">\glsxtrsetfieldifexists </span>to simply do &#x27E8;<span
-class="cmti-10">code</span>&#x27E9; if you want to skip the existence check.
-Alternatively you can instead use
-</p><!--l. 13574--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86020"></a> <span
-class="cmtt-10">\glsxtrdeffield{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}</span>&#x27E8;<span
-class="cmitt-10">arguments</span>&#x27E9;<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">replacement text</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 13576--><p class="noindent" >
-This simply uses <span
-class="cmss-10">etoolbox</span><a
- id="dx1-86021"></a>&#8217;s <span
-class="cmtt-10">\csdef </span>without any checks. This command
-isn&#8217;t robust. There is also a version that uses <span
-class="cmtt-10">\protected@csedef</span>
-instead:<span class="footnote-mark"><a
-href="#fn1x11" id="fn1x11-bk"><sup class="textsuperscript">11.1</sup></a></span><a
- id="x1-86022f1"></a>
-</p><!--l. 13581--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86023"></a> <span
-class="cmtt-10">\glsxtredeffield{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}</span>&#x27E8;<span
-class="cmitt-10">arguments</span>&#x27E9;<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">replacement text</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 13583--><p class="noindent" >
-</p><!--l. 13585--><p class="indent" > The following command was added to <span
-class="cmss-10">glossaries-extra </span>v1.47 primarily for the
-convenience of <a
- id="dx1-86024"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a>:
-</p><!--l. 13587--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86025"></a> <span
-class="cmtt-10">\glsxtrapptocsvfield{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">value</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13589--><p class="noindent" >
-There&#8217;s no check for the existence of either the entry or the field. If the entry
-identified by &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; has the given field set then this command will append a comma
-followed by &#x27E8;<span
-class="cmti-10">value</span>&#x27E9; to the existing value, otherwise it will set the field to just &#x27E8;<span
-class="cmti-10">value</span>&#x27E9;.
-This uses <span
-class="cmtt-10">\csdef </span>or <span
-class="cmtt-10">\csappto </span>so the effect can be localised.
-</p><!--l. 13597--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86026"></a> <span
-class="cmtt-10">\gGlsXtrSetField{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">value</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13599--><p class="noindent" >
-As <span
-class="cmtt-10">\GlsXtrSetField </span>but globally.
-</p><!--l. 13602--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86027"></a> <span
-class="cmtt-10">\eGlsXtrSetField{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">value</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13604--><p class="noindent" >
-As <span
-class="cmtt-10">\GlsXtrSetField </span>but uses protected expansion.
-</p><!--l. 13607--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86028"></a> <span
-class="cmtt-10">\xGlsXtrSetField{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">value</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13609--><p class="noindent" >
-As <span
-class="cmtt-10">\gGlsXtrSetField </span>but uses protected expansion.
-</p><!--l. 13612--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86029"></a> <span
-class="cmtt-10">\GlsXtrLetField{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">cs</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13614--><p class="noindent" >
-Sets the field given by &#x27E8;<span
-class="cmti-10">field</span>&#x27E9; to the replacement text of &#x27E8;<span
-class="cmti-10">cs</span>&#x27E9; for the entry given by &#x27E8;<span
-class="cmti-10">label</span>&#x27E9;
-(using <span
-class="cmtt-10">\let</span>).
-</p><!--l. 13618--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86030"></a> <span
-class="cmtt-10">\csGlsXtrLetField{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">cs name</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13620--><p class="noindent" >
-As <span
-class="cmtt-10">\GlsXtrLetField </span>but the control sequence name is supplied instead.
-
-
-
-</p><!--l. 13624--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86031"></a> <span
-class="cmtt-10">\GlsXtrLetFieldToField{</span>&#x27E8;<span
-class="cmitt-10">label-1</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field-1</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label-2</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field-2</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 13626--><p class="noindent" >
-Sets the field given by &#x27E8;<span
-class="cmti-10">field-1</span>&#x27E9; for the entry given by &#x27E8;<span
-class="cmti-10">label-1</span>&#x27E9; to the field given by
-&#x27E8;<span
-class="cmti-10">field-2</span>&#x27E9; for the entry given by &#x27E8;<span
-class="cmti-10">label-2</span>&#x27E9;. There&#8217;s no check for the existence of &#x27E8;<span
-class="cmti-10">label-2</span>&#x27E9;,
-but <span
-class="cmtt-10">\glsxtrsetfieldifexists{</span>&#x27E8;<span
-class="cmti-10">label-1</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmti-10">field-1</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmti-10">code</span>&#x27E9;<span
-class="cmtt-10">} </span>is still used, as for
-<span
-class="cmtt-10">\GlsXtrSetField</span>.
-</p><!--l. 13634--><p class="indent" > The <span
-class="cmss-10">glossaries </span>package provides <span
-class="cmtt-10">\ifglshasfield</span><a
- id="dx1-86032"></a> to determine if a field has been
-set. The <span
-class="cmss-10">glossaries-extra </span>package provides a simpler version:
-</p><!--l. 13637--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86033"></a> <span
-class="cmtt-10">\glsxtrifhasfield{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13639--><p class="noindent" >
-(New to v1.19.) Note that in this case the &#x27E8;<span
-class="cmti-10">field</span>&#x27E9; must be the <span
-class="cmti-10">internal </span>field label (for
-example, <span
-class="cmtt-10">useri </span>rather than <span
-class="cmtt-10">user1</span>). Unlike <span
-class="cmtt-10">\ifglshasfield</span>, this version
-doesn&#8217;t complain if the entry (given by &#x27E8;<span
-class="cmti-10">label</span>&#x27E9;) or the field don&#8217;t exist and
-will simply do &#x27E8;<span
-class="cmti-10">false</span>&#x27E9;. If the field does exist for the given entry and it&#8217;s not
-empty, the &#x27E8;<span
-class="cmti-10">true</span>&#x27E9; part is done otherwise it does &#x27E8;<span
-class="cmti-10">false</span>&#x27E9;. Within &#x27E8;<span
-class="cmti-10">true</span>&#x27E9; you may
-use
-</p><!--l. 13648--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86034"></a> <span
-class="cmtt-10">\glscurrentfieldvalue </span></div><hr>
-</p><!--l. 13650--><p class="noindent" >
-to access the field value. This command includes grouping which scopes the &#x27E8;<span
-class="cmti-10">true</span>&#x27E9; and
-&#x27E8;<span
-class="cmti-10">false</span>&#x27E9; parts. The starred version
-</p><!--l. 13654--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86035"></a> <span
-class="cmtt-10">\glsxtrifhasfield*{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13656--><p class="noindent" >
-omits the implicit grouping.
-</p><!--l. 13659--><p class="indent" > <div class="important" title="Important Note"> Be careful of keys that use <span
-class="cmtt-10">\relax </span>as the default value (such as the <span
-class="cmss-10">symbol</span><a
- id="dx1-86036"></a>). Use
-<span
-class="cmtt-10">\ifglshassymbol </span>instead. </div>
-</p><!--l. 13662--><p class="noindent" >
-</p><!--l. 13664--><p class="indent" > There is also a version that simply uses <span
-class="cmtt-10">\ifcsundef</span>. It doesn&#8217;t save the field
-value, but can be used if you only need to check if the field is defined without
-accessing it:
-</p><!--l. 13667--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86037"></a> <span
-class="cmtt-10">\GlsXtrIfFieldUndef{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13669--><p class="noindent" >
-</p><!--l. 13671--><p class="indent" > <div class="important" title="Important Note"> There&#8217;s a difference between an undefined field and an unset field. An undefined
-field hasn&#8217;t been assigned any value (no associated internal control sequence
-has been defined). If a defined field has been defined to empty, then it&#8217;s
-considered unset. <span
-class="cmtt-10">\GlsXtrIfFieldUndef </span>implement &#x27E8;<span
-class="cmti-10">false</span>&#x27E9; for a defined but
-empty field whereas <span
-class="cmtt-10">\glsxtrifhasfield </span>and <span
-class="cmtt-10">\ifglshasfield </span>will implement
-&#x27E8;<span
-class="cmti-10">false</span>&#x27E9; a defined but empty field. Remember that any keys that may be used
-in <span
-class="cmtt-10">\newglossaryentry </span>will have a default value if not provided. In many
-cases, the default value is empty, so only use <span
-class="cmtt-10">\GlsXtrIfFieldUndef </span>for
-fields that can only be defined through commands like <span
-class="cmtt-10">\GlsXtrSetField</span>.
-</div>
-</p><!--l. 13684--><p class="noindent" >
-
-
-
-</p><!--l. 13686--><p class="indent" > You can test if a field value equals a string using
-</p><!--l. 13687--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86038"></a> <span
-class="cmtt-10">\GlsXtrIfFieldEqStr{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13689--><p class="noindent" >
-If the entry exists and has the given field set to the given text then this does &#x27E8;<span
-class="cmti-10">true</span>&#x27E9;
-otherwise it does &#x27E8;<span
-class="cmti-10">false</span>&#x27E9;. This uses <span
-class="cmtt-10">\glsxtrifhasfield </span>to test if the field exists and
-then compares the replacement text of <span
-class="cmtt-10">\glscurrentfieldvalue </span>with &#x27E8;<span
-class="cmti-10">text</span>&#x27E9; using
-<span
-class="cmss-10">etoolbox</span><a
- id="dx1-86039"></a>&#8217;s <span
-class="cmtt-10">\ifdefstring</span>. Version 1.39 introduced a starred form of this command,
-which uses the starred form of <span
-class="cmtt-10">\glsxtrifhasfield</span>.
-</p><!--l. 13699--><p class="indent" > As from version 1.31, there&#8217;s a similar command:
-</p><!--l. 13700--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86040"></a> <span
-class="cmtt-10">\GlsXtrIfFieldEqXpStr{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13702--><p class="noindent" >
-This is like <span
-class="cmtt-10">\GlsXtrIfFieldEqStr </span>but first (protected) fully expands &#x27E8;<span
-class="cmti-10">text</span>&#x27E9; (but not
-the field value). If you want to compare the (protected) full expansion of both the
-field value and &#x27E8;<span
-class="cmti-10">text</span>&#x27E9; use:
-</p><!--l. 13707--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86041"></a> <span
-class="cmtt-10">\GlsXtrIfXpFieldEqXpStr{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 13709--><p class="noindent" >
-Again, version 1.39 introduced a starred form of these commands, which use the
-starred form of <span
-class="cmtt-10">\glsxtrifhasfield</span>.
-</p><!--l. 13713--><p class="indent" > As from v1.42, you can test if the field value is contained in a comma-separated
-list with:
-</p><!--l. 13715--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86042"></a> <span
-class="cmtt-10">\GlsXtrIfFieldValueInCsvList{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">list</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 13717--><p class="noindent" >
-The unstarred version uses the unstarred form of <span
-class="cmtt-10">\glsxtrifhasfield </span>(which
-adds grouping so &#x27E8;<span
-class="cmti-10">true</span>&#x27E9; and &#x27E8;<span
-class="cmti-10">false</span>&#x27E9; will be localised). The starred version uses
-<span
-class="cmtt-10">\glsxtrifhasfield*</span>. If the field value (without expansion) is contained in &#x27E8;<span
-class="cmti-10">list</span>&#x27E9; then
-&#x27E8;<span
-class="cmti-10">true</span>&#x27E9; is done otherwise &#x27E8;<span
-class="cmti-10">false</span>&#x27E9; is done. If the field hasn&#8217;t been set &#x27E8;<span
-class="cmti-10">false</span>&#x27E9; is done. This
-internally uses <span
-class="cmtt-10">\DTLifinlist </span>provided by <span
-class="cmss-10">datatool-base</span><a
- id="dx1-86043"></a> which performs
-a one level expansion on &#x27E8;<span
-class="cmti-10">list</span>&#x27E9;. See the <span
-class="cmss-10">datatool</span><a
- id="dx1-86044"></a> documentation for further
-details.
-</p><!--l. 13729--><p class="indent" > This command is intended for fields that contain a label. For example, to test if
-the category is one of a set of labels:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-312">
-\GlsXtrIfFieldValueInCsvList{examplelabel}{category}%
-&#x00A0;{abbreviation,acronym}%&#x00A0;set&#x00A0;of&#x00A0;labels
-&#x00A0;{true&#x00A0;part}{false&#x00A0;part}
-</pre>
-<!--l. 13735--><p class="nopar" >
-</p><!--l. 13737--><p class="indent" > As from v1.31, if a field represents a numeric (integer) value, you can use the
-following two numeric tests. If the field is set, it must expand to an integer. You may
-use <span
-class="cmtt-10">\glscurrentfieldvalue </span>within &#x27E8;<span
-class="cmti-10">true</span>&#x27E9; or &#x27E8;<span
-class="cmti-10">false</span>&#x27E9; to access the actual value. Both
-&#x27E8;<span
-class="cmti-10">true</span>&#x27E9; and &#x27E8;<span
-class="cmti-10">false</span>&#x27E9; are scoped. If the field is undefined or empty, the value is assumed to
-be 0, and <span
-class="cmtt-10">\glscurrentfieldvalue </span>is set accordingly. As from version 1.39, these
-numeric tests have starred versions. The unstarred versions add implicit grouping.
-The starred versions don&#8217;t.
-</p><!--l. 13747--><p class="indent" > As from v1.47 there&#8217;s a similar command:
-</p><!--l. 13748--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86045"></a> <span
-class="cmtt-10">\GlsXtrIfValueInFieldCsvList{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">value</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 13750--><p class="noindent" >
-This is essentially the opposite situation where the list is stored in the given field and
-&#x27E8;<span
-class="cmti-10">value</span>&#x27E9; is the element to find in the list. Again the unstarred versions add implicit
-grouping. Note that the &#x27E8;<span
-class="cmti-10">value</span>&#x27E9; isn&#8217;t expanded. If you need it to be fully expanded
-before searching for it use:
-</p><!--l. 13756--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86046"></a> <span
-class="cmtt-10">\xGlsXtrIfValueInFieldCsvList{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">value</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 13758--><p class="noindent" >
-(To add a value to a field containing a comma-separated list, use <span
-class="cmtt-10">\glsxtrapptocsvfield</span>.
-To iterate over the field use <span
-class="cmtt-10">\glsxtrforcsvfield</span>.)
-</p><!--l. 13762--><p class="indent" > To test if the value is non-zero:
-</p><!--l. 13763--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86047"></a> <span
-class="cmtt-10">\GlsXtrIfFieldNonZero{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13765--><p class="noindent" >
-Alternatively, you can test if the field expands to a specific number using:
-</p><!--l. 13768--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86048"></a> <span
-class="cmtt-10">\GlsXtrIfFieldEqNum{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">n</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13770--><p class="noindent" >
-This does &#x27E8;<span
-class="cmti-10">true</span>&#x27E9; if the field value equals &#x27E8;<span
-class="cmti-10">n</span>&#x27E9; (using <span
-class="cmtt-10">\ifnum </span>for the comparison)
-otherwise it does &#x27E8;<span
-class="cmti-10">false</span>&#x27E9;. For a more general numeric comparison you can
-use:
-</p><!--l. 13775--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86049"></a> <span
-class="cmtt-10">\GlsXtrIfFieldCmpNum{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">comparison</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">n</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div><hr>
-</p><!--l. 13777--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">comparison</span>&#x27E9; is one of <span
-class="cmtt-10">=</span>, <span
-class="cmtt-10">&#x003C; </span>or <span
-class="cmtt-10">&#x003E;</span>.
-</p><!--l. 13781--><p class="indent" > The <span
-class="cmss-10">glossaries </span>package provides <span
-class="cmtt-10">\glsfieldfetch</span><a
- id="dx1-86050"></a> which can be used to fetch the
-value of the given field and store it in a control sequence. The <span
-class="cmss-10">glossaries-extra </span>package
-provides another way of accessing the field value:
-</p><!--l. 13785--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86051"></a> <span
-class="cmtt-10">\glsxtrusefield{</span>&#x27E8;<span
-class="cmitt-10">entry-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field-label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-
-
-
-</p><!--l. 13787--><p class="noindent" >
-This works in the same way as commands like <span
-class="cmtt-10">\glsentrytext </span>but the field label is
-specified in the first argument. Note that the &#x27E8;<span
-class="cmti-10">field-label</span>&#x27E9; corresponds to the internal
-field tag, which isn&#8217;t always the same as the key name. See Table&#x00A0;4.1 of the <span
-class="cmss-10">glossaries</span><a
- id="dx1-86052"></a>
-manual. No error occurs if the entry or field haven&#8217;t been defined. This command is
-not robust.
-</p><!--l. 13795--><p class="indent" > There is also a version that converts the first letter to uppercase (analogous to
-<span
-class="cmtt-10">\Glsentrytext</span>):
-</p><!--l. 13797--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86053"></a> <span
-class="cmtt-10">\Glsxtrusefield{</span>&#x27E8;<span
-class="cmitt-10">entry-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field-label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13799--><p class="noindent" >
-and, as from v1.37, a command that converts the entire value to upper case:
-</p><!--l. 13801--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86054"></a> <span
-class="cmtt-10">\GLSxtrusefield{</span>&#x27E8;<span
-class="cmitt-10">entry-label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field-label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13803--><p class="noindent" >
-</p><!--l. 13805--><p class="indent" > If you want to use a field to store a list that can be used as an <span
-class="cmss-10">etoolbox</span><a
- id="dx1-86055"></a> internal
-list, you can use the following command that adds an item to the field using
-<span
-class="cmss-10">etoolbox</span><a
- id="dx1-86056"></a>&#8217;s <span
-class="cmtt-10">\listcsadd</span>:
-</p><!--l. 13809--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86057"></a> <span
-class="cmtt-10">\glsxtrfieldlistadd{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">item</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13811--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; is the entry&#8217;s label, &#x27E8;<span
-class="cmti-10">field</span>&#x27E9; is the entry&#8217;s field and &#x27E8;<span
-class="cmti-10">item</span>&#x27E9; is the item to
-add. There are analogous commands that use <span
-class="cmtt-10">\listgadd</span>, <span
-class="cmtt-10">\listeadd </span>and
-<span
-class="cmtt-10">\listxadd</span>:
-</p><!--l. 13816--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86058"></a> <span
-class="cmtt-10">\glsxtrfieldlistgadd{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">item</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13818--><p class="noindent" >
-</p><!--l. 13819--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86059"></a> <span
-class="cmtt-10">\glsxtrfieldlisteadd{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">item</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13821--><p class="noindent" >
-</p><!--l. 13822--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86060"></a> <span
-class="cmtt-10">\glsxtrfieldlistxadd{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">item</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13824--><p class="noindent" >
-You can then iterate over the list using:
-</p><!--l. 13826--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86061"></a> <span
-class="cmtt-10">\glsxtrfielddolistloop{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13828--><p class="noindent" >
-or
-</p><!--l. 13830--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86062"></a> <span
-class="cmtt-10">\glsxtrfieldforlistloop{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">handler</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13832--><p class="noindent" >
-that internally use <span
-class="cmtt-10">\dolistcsloop </span>and <span
-class="cmtt-10">\forlistloop</span>, respectively. You can use
-<span
-class="cmtt-10">\listbreak</span><a
- id="dx1-86063"></a> to break out of the loop (see the <span
-class="cmss-10">etoolbox</span><a
- id="dx1-86064"></a> manual for further
-details).
-</p><!--l. 13837--><p class="indent" > For fields that contain comma-separated lists use <span
-class="cmtt-10">\glsxtrforcsvfield</span>
-instead.
-</p><!--l. 13840--><p class="indent" > New to v1.42:
-</p><!--l. 13841--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86065"></a> <span
-class="cmtt-10">\glsxtrfieldformatlist{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13843--><p class="noindent" >
-Like <span
-class="cmss-10">datatool-base</span><a
- id="dx1-86066"></a>&#8217;s <span
-class="cmtt-10">\DTLformatlist</span><a
- id="dx1-86067"></a>, this iterates over an (<span
-class="cmss-10">etoolbox</span><a
- id="dx1-86068"></a>) internal list and
-formats each item. Uses all the same helper commands as <span
-class="cmtt-10">\DTLformatlist </span>(the same
-
-
-
-list handler macro is used). Unlike the <span
-class="cmss-10">datatool-base</span><a
- id="dx1-86069"></a> command, this command has no
-starred version. Grouping is automatically applied.
-</p><!--l. 13850--><p class="indent" > For example, with <a
- id="dx1-86070"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span>&#8217;s</a> <span
-class="cmtt-10">save-child-count </span>resource option:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-313">
-\newcommand*{\listchildren}[1]{%
-&#x00A0;&#x00A0;\GlsXtrIfFieldNonZero{childcount}{#1}%
-&#x00A0;&#x00A0;{child&#x00A0;count:&#x00A0;\glscurrentfieldvalue;&#x00A0;children:
-&#x00A0;&#x00A0;&#x00A0;\let\DTLlistformatitem\glsfmtname
-&#x00A0;&#x00A0;&#x00A0;\glsxtrfieldformatlist{#1}{childlist}%
-&#x00A0;&#x00A0;}%
-&#x00A0;&#x00A0;{no&#x00A0;children}%
+<a id="wrglossary.12955"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>
+</pre> An alternative is to test the total record count, but remember that each entry is being <a id="wrglossary.12956"></a><a href="#glo:@@glslabel@indexing">recorded</a> twice: once with the <a id="wrglossary.12957"></a><a href="#glo:ctr.page"><span class="ctrfmt">page</span></a> counter and once with the <a id="wrglossary.12958"></a><a href="#glo:ctr.chapter"><span class="ctrfmt">chapter</span></a> counter, so the total count for the <code class="code">ssi</code> entry will be 2 not 1.<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+Take care not to strip entries from a <a id="wrglossary.12959"></a><a href="#glo:hierarchicallevel">hierarchical glossary</a> as it will break the hierarchy and will cause formatting problems in the glossary. </div><!-- end of warning -->
+<p>
+The complete document is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{scrreport}
+<code class="cmd">\usepackage</code>[T1]{fontenc}
+<code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.12960"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>,<a id="wrglossary.12961"></a><a href="#glo:opt.postdot"><span class="styoptfmt">postdot</span></a>]{glossaries-extra}
+
+<a id="wrglossary.12962"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.12963"></a><a href="#glo:opt.abbrstyle.long-short-sc-desc"><span class="abbrstylefmt">long-short-sc-desc</span></a>}
+
+<a id="wrglossary.12964"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.12965"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">={abbrvs}</span>]
+
+<code class="cmd">\preto</code>{<code class="cmd">\chapter</code>}{<a id="wrglossary.12966"></a><a href="#glo:glsresetall"><code class="csfmt">\glsresetall</code></a>}
+<a id="wrglossary.12967"></a><a href="#glo:glsxtrenablerecordcount"><code class="csfmt">\glsxtrenablerecordcount</code></a>
+<a id="wrglossary.12968"></a><a href="#glo:GlsXtrSetRecordCountAttribute"><code class="csfmt">\GlsXtrSetRecordCountAttribute</code></a>{abbreviation}{1}
+
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.12969"></a><a href="#glo:glslinkpresetkeys"><code class="csfmt">\glslinkpresetkeys</code></a>}{<span class="comment">% </span>
+ <a id="wrglossary.12970"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>[<a id="wrglossary.12971"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=glsignore</span>,<a id="wrglossary.12972"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a><span class="optfmt">=<a id="wrglossary.12973"></a><a href="#glo:ctr.chapter"><span class="ctrfmt">chapter</span></a></span>]{<a id="wrglossary.12974"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}}
+
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.12975"></a><a href="#glo:glsxtrrecordtriggervalue"><code class="csfmt">\glsxtrrecordtriggervalue</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.12976"></a><a href="#glo:GlsXtrLocationRecordCount"><code class="csfmt">\GlsXtrLocationRecordCount</code></a>{#1}{<a id="wrglossary.12977"></a><a href="#glo:ctr.chapter"><span class="ctrfmt">chapter</span></a>}{<a id="wrglossary.12978"></a><a href="#glo:thecounter"><code class="csfmt">\thechapter</code></a>}<span class="comment">% </span>
}
-</pre>
-<!--l. 13861--><p class="nopar" > For fields that contain a comma-separated list use <span
-class="cmtt-10">\glsxtrfieldformatcsvlist</span>
-instead.
-</p><!--l. 13865--><p class="indent" > There are also commands that use <span
-class="cmtt-10">\ifinlistcs</span>:
-</p><!--l. 13866--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86071"></a> <span
-class="cmtt-10">\glsxtrfieldifinlist{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">item</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13868--><p class="noindent" >
-and <span
-class="cmtt-10">\xifinlistcs</span>
-</p><!--l. 13870--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86072"></a> <span
-class="cmtt-10">\glsxtrfieldxifinlist{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">item</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13872--><p class="noindent" >
-</p><!--l. 13874--><p class="indent" > See the <span
-class="cmss-10">etoolbox</span><a
- id="dx1-86073"></a>&#8217;s user manual for further details of these commands, in particular
-the limitations of <span
-class="cmtt-10">\ifinlist</span>.
-</p><!--l. 13878--><p class="indent" > If the field has a comma-separated list value instead, you can iterate over it
-using:
-</p><!--l. 13880--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86074"></a> <span
-class="cmtt-10">\glsxtrforcsvfield{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">handler</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13882--><p class="noindent" >
-where again &#x27E8;<span
-class="cmti-10">handler</span>&#x27E9; is a control sequence that takes a single argument. Unlike the
-<span
-class="cmss-10">etoolbox</span><a
- id="dx1-86075"></a> loops, this doesn&#8217;t ignore empty elements nor does it discard leading /
-trailing spaces. Internally it uses <span
-class="cmtt-10">\@for </span>(modified by <span
-class="cmss-10">xfor</span><a
- id="dx1-86076"></a> which is automatically
-loaded by <span
-class="cmss-10">glossaries</span><a
- id="dx1-86077"></a>). The <span
-class="cmss-10">xfor</span><a
- id="dx1-86078"></a> package modifies the behaviour of <span
-class="cmtt-10">\@for </span>to allow the
-loop to be broken prematurely using <span
-class="cmtt-10">\@endfortrue</span>. The <span
-class="cmtt-10">\glsxtrforcsvfield</span>
-command locally defines a user level command:
-</p><!--l. 13892--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86079"></a> <span
-class="cmtt-10">\glsxtrendfor </span></div><hr>
-</p><!--l. 13894--><p class="noindent" >
-which is just a synonym for <span
-class="cmtt-10">\@endfortrue</span>.
-</p><!--l. 13897--><p class="indent" > The loop is performed within the true part of <span
-class="cmtt-10">\glsxtrifhasfield </span>so scoping is
-automatically applied. If you don&#8217;t want scoping use <span
-class="cmtt-10">\glsxtrforcsvfield* </span>which
-will use <span
-class="cmtt-10">\glsxtrifhasfield* </span>instead but take care if you nest these starred
-commands as unexpected results can occur without the scoping.
-</p><!--l. 13903--><p class="indent" > New to v1.42:
-</p><!--l. 13904--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86080"></a> <span
-class="cmtt-10">\glsxtrfieldformatcsvlist{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13906--><p class="noindent" >
-Like <span
-class="cmtt-10">\glsxtrfieldformatcsvlist </span>but for fields that contain comma-separated
-lists.
-
-
-
-</p><!--l. 13910--><p class="indent" > As from version 1.32, if the field given by
-</p><!--l. 13911--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86081"></a> <span
-class="cmtt-10">\GlsXtrForeignTextField </span></div><hr>
-</p><!--l. 13913--><p class="noindent" >
-(which defaults to <span
-class="cmtt-10">userii</span>) contains a locale tag, then
-</p><!--l. 13915--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86082"></a> <span
-class="cmtt-10">\GlsXtrForeignText{</span>&#x27E8;<span
-class="cmitt-10">entry label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13917--><p class="noindent" >
-can be used to encapsulate &#x27E8;<span
-class="cmti-10">text</span>&#x27E9; in <span
-class="cmtt-10">\foreignlanguage{</span>&#x27E8;<span
-class="cmti-10">dialect</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmti-10">text</span>&#x27E9;<span
-class="cmtt-10">} </span>where &#x27E8;<span
-class="cmti-10">dialect</span>&#x27E9; is
-obtained from the locale tag through <span
-class="cmss-10">tracklang</span><a
- id="dx1-86083"></a>&#8217;s <span
-class="cmtt-10">\GetTrackedDialectFromLanguageTag</span><a
- id="dx1-86084"></a>
-command. You need at least <span
-class="cmss-10">tracklang</span><a
- id="dx1-86085"></a> v1.3.6 for this to work properly. The &#x27E8;<span
-class="cmti-10">dialect</span>&#x27E9;
-must be one that&#8217;s tracked (which typically means that <span
-class="cmss-10">babel</span><a
- id="dx1-86086"></a> or <span
-class="cmss-10">polyglossia</span><a
- id="dx1-86087"></a> has been
-loaded with the appropriate setting for that language). If <span
-class="cmtt-10">\foreignlanguage </span>hasn&#8217;t
-been defined, this just does &#x27E8;<span
-class="cmti-10">text</span>&#x27E9;. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-314">
-\documentclass{article}
-\usepackage[main=british,brazilian,ngerman]{babel}
-\usepackage{glossaries-extra}
-\setabbreviationstyle{long-short-user}
-\newabbreviation
-&#x00A0;[user1={Associa\c{c}\~ao&#x00A0;Brasileria&#x00A0;de&#x00A0;Normas&#x00A0;T\'ecnicas},
-&#x00A0;&#x00A0;user2=&#x00A0;{pt-BR}
-&#x00A0;]
-&#x00A0;{abnt}{ABNT}{Brazilian&#x00A0;National&#x00A0;Standards&#x00A0;Organization}
-\newabbreviation
-&#x00A0;[user1={Deutsches&#x00A0;Institut&#x00A0;f\"ur&#x00A0;Normung&#x00A0;e.V.},
-&#x00A0;&#x00A0;user2={de-DE-1996}]
-&#x00A0;{din}{DIN}{German&#x00A0;Institute&#x00A0;for&#x00A0;Standardization}
-\renewcommand*{\glsxtruserparen}[2]{%
-&#x00A0;&#x00A0;\glsxtrfullsep{#2}%
-&#x00A0;&#x00A0;\glsxtrparen
-&#x00A0;&#x00A0;{#1%
-&#x00A0;&#x00A0;&#x00A0;\ifglshasfield{\glsxtruserfield}{#2}%
-&#x00A0;&#x00A0;&#x00A0;{,&#x00A0;\emph{\GlsXtrForeignText{#2}{\glscurrentfieldvalue}}}%
-&#x00A0;&#x00A0;&#x00A0;{}%
-&#x00A0;&#x00A0;}%
+<code class="cbeg">\begin{document}</code>
+<code class="cmd">\chapter</code>{First}
+<a id="wrglossary.12979"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}. <a id="wrglossary.12980"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}. <a id="wrglossary.12981"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}. <a id="wrglossary.12982"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi}.
+
+<code class="cmd">\chapter</code>{Second}
+<a id="wrglossary.12983"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}. <a id="wrglossary.12984"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi}. <a id="wrglossary.12985"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ssi}. <a id="wrglossary.12986"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{xml}.
+
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.12987"></a><a href="#glo:printunsrtglossaryentryprocesshook"><code class="csfmt">\printunsrtglossaryentryprocesshook</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.12988"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a>*{<a id="wrglossary.12989"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a>}{#1}
+ {}{<a id="wrglossary.12990"></a><a href="#glo:printunsrtglossaryskipentry"><code class="csfmt">\printunsrtglossaryskipentry</code></a>}<span class="comment">% </span>
}
-\begin{document}
-\gls{abnt},&#x00A0;\gls{din}.
-\end{document}
-</pre>
-<!--l. 13959--><p class="nopar" >
-</p><!--l. 13962--><p class="indent" > When using the <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><a
- id="dx1-86088"></a> option, in addition to recording the usual location, you can
-also record the current value of another counter at the same time using the
-preamble-only command:
-</p><!--l. 13965--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-86089"></a> <span
-class="cmtt-10">\GlsXtrRecordCounter{</span>&#x27E8;<span
-class="cmitt-10">counter name</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 13967--><p class="noindent" >
-For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-315">
-\usepackage[record]{glossaries-extra}
-\GlsXtrRecordCounter{section}
-</pre>
-<!--l. 13972--><p class="nopar" > Each time an entry is referenced with commands like <span
-class="cmtt-10">\gls </span>or <span
-class="cmtt-10">\glstext</span>,
-the <span
-class="cmtt-10">.aux </span>file will not only contain the <span
-class="cmtt-10">\glsxtr@record </span>command but also
-</p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\glsxtr@counterrecord{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">section</span><span
-class="cmsy-10">}</span><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">n</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div>
-</div> where &#x27E8;<span
-class="cmti-10">n</span>&#x27E9; is the current expansion of <span
-class="cmtt-10">\thesection </span>and &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; is the entry&#8217;s
-label. On the next run, when the <span
-class="cmtt-10">.aux </span>file is run, this command will do
-<div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\glsxtrfieldlistgadd{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">record.</span>&#x27E8;<span
-class="cmitt-10">counter</span>&#x27E9;<span
-class="cmsy-10">}</span><span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmitt-10">n</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div>
-</div> In the above example, if <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gls{bird}</span></span></span> is used in section&#x00A0;1.2 this would be
-
-
-
- <pre class="verbatim" id="verbatim-316">
-\glsxtrfieldlistgadd{bird}{record.section}{1.2}
-</pre>
-<!--l. 13989--><p class="nopar" > Note that there&#8217;s no key corresponding to this new <span
-class="cmtt-10">record.section </span>field, but its
-value can be accessed with <span
-class="cmtt-10">\glsxtrfielduse </span>or the list can be iterated over with
-<span
-class="cmtt-10">\glsxtrfielddolistloop </span>etc.
-</p><!--l. 13995--><p class="noindent" >
-</p>
-<!--l. 13995--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">11.2 </span> <a
- id="sec:printunsrt"></a>Display All Entries Without Sorting or Indexing</h3>
-<!--l. 13998--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-87001"></a> <span
-class="cmtt-10">\printunsrtglossary[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">] </span></div><hr>
-</p><!--l. 14000--><p class="noindent" >
-This behaves like <span
-class="cmtt-10">\printnoidxglossary </span>but never sorts the entries and
-always lists all the defined entries for the given glossary (and doesn&#8217;t require
-<span
-class="cmtt-10">\makenoidxglossaries</span>). If you want to use one of the <span
-class="cmss-10">tabular</span><a
- id="dx1-87002"></a><a
- id="dx1-87003"></a>-like styles with
-<span
-class="cmtt-10">\printunsrtglossary</span>, make sure you load <span
-class="cmss-10">glossaries-extra-stylemods</span><a
- id="dx1-87004"></a> which modifies
-the definition of <span
-class="cmtt-10">\glsgroupskip </span>to avoid the &#8220;Incomplete <span
-class="cmtt-10">\iftrue</span>&#8221; error that may
-otherwise occur.
-</p><!--l. 14010--><p class="noindent" >There&#8217;s also a starred form
-</p><!--l. 14011--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-87005"></a> <span
-class="cmtt-10">\printunsrtglossary*[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">code</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 14013--><p class="noindent" >
-which is equivalent to </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\begingroup</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span>&#x27E8;<span
-class="cmitt-10">code</span>&#x27E9;<span
-class="cmtt-10">\printunsrtglossary[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]%</span>
-<br /><span
-class="cmtt-10">\endgroup</span>
-</div>
-</div> Note that unlike <span
-class="cmtt-10">\glossarypreamble</span>, the supplied &#x27E8;<span
-class="cmti-10">code</span>&#x27E9; is done before the glossary
-header.
-<!--l. 14023--><p class="indent" > This means you now have the option to simply list all entries on the first
-LaTeX&#x00A0;run without the need for a post-processor, however there will be no <a
- id="dx1-87006"></a><a
-href="#glo:numberlist">number
-list</a> in this case, as that has to be set by a post-processor such as <a
- id="dx1-87007"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> (see
-<a
-href="#sec:bib2gls"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">10</span> </a><a
-href="#sec:bib2gls">bib2gls: Managing Reference Databases<!--tex4ht:ref: sec:bib2gls --></a>).
-</p><!--l. 14029--><p class="indent" > <div class="important" title="Important Note"> No attempt is made to gather hierarchical elements. If child entries aren&#8217;t defined
-immediately after their parent entry, they won&#8217;t be together in the glossary when
-using <span
-class="cmtt-10">\printunsrtglossary</span>. </div>
-</p><!--l. 14034--><p class="noindent" >
-
-
-
-</p><!--l. 14036--><p class="indent" > There&#8217;s a difference in behaviour depending on whether or not the <span
-class="cmss-10">group</span><a
- id="dx1-87008"></a> key is
-defined. If not defined (default), the group label will be formed from the first letter of
-the <span
-class="cmss-10">name</span><a
- id="dx1-87009"></a> field. The corresponding group title will be obtained as discussed in
-<a
-href="#sec:glosstylemods"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.11</span> </a><a
-href="#sec:glosstylemods">Glossary Style Modifications<!--tex4ht:ref: sec:glosstylemods --></a>. This can lead to an odd effect if
-you are using a style that separates letter groups when the ordering isn&#8217;t
-alphabetical.
-</p><!--l. 14044--><p class="indent" > If the <span
-class="cmss-10">group</span><a
- id="dx1-87010"></a> key is defined (which it is with the <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><a
- id="dx1-87011"></a> option) then the group label
-will be obtained from the value of that field. If the field is empty, <span
-class="cmti-10">no grouping is</span>
-<span
-class="cmti-10">performed</span>, even if the style supports it. (That is, there won&#8217;t be a header or a vertical
-separation.) If the <span
-class="cmss-10">group</span><a
- id="dx1-87012"></a> field is non-empty, then the corresponding title is obtained
-as described earlier.
-</p><!--l. 14052--><p class="indent" > In either case, if the <span
-class="cmss-10">groups</span><a
- id="dx1-87013"></a> option is set to false then no group formation will be
-performed.
-</p><!--l. 14055--><p class="indent" > If you want to use a different field for the group label, you can redefine
-</p><!--l. 14056--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-87014"></a> <span
-class="cmtt-10">\glsxtrgroupfield </span></div><hr>
-</p><!--l. 14058--><p class="noindent" >
-to the relevant internal field label, but the <span
-class="cmss-10">group</span><a
- id="dx1-87015"></a> <span
-class="cmti-10">key </span>must still be defined (through
-the <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><a
- id="dx1-87016"></a> option or with commands like <span
-class="cmtt-10">\glsaddstoragekey</span>) to ensure that
-<span
-class="cmtt-10">\printunsrtglossary </span>uses <span
-class="cmtt-10">\glsxtrgroupfield</span>. (This method is used by <a
- id="dx1-87017"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a>
-for secondary entries, which have the group label stored in the <span
-class="cmtt-10">secondarygroup</span>
-internal field.)
-</p><!--l. 14066--><p class="indent" > If you have any entries with the <span
-class="cmss-10">see</span><a
- id="dx1-87018"></a> key set, you will need the <span
-class="cmss-10">glossaries</span><a
- id="dx1-87019"></a> package
-option <a
-href="#styopt.seenoindex"><span
-class="cmss-10">seenoindex</span></a><span
-class="cmss-10">=ignore</span><a
- id="dx1-87020"></a> or <a
-href="#styopt.seenoindex"><span
-class="cmss-10">seenoindex</span></a><span
-class="cmss-10">=warn</span><a
- id="dx1-87021"></a> to prevent an error occurring from the
-automated <span
-class="cmtt-10">\glssee </span>normally triggered by this key. The <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=only</span><a
- id="dx1-87022"></a> package option
-will automatically deal with this.
-</p><!--l. 14073--><p class="indent" > For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-317">
-\documentclass{article}
-\usepackage{glossaries-extra}
-\newglossaryentry{zebra}{name={zebra},description={stripy&#x00A0;animal}}
-\newglossaryentry{ant}{name={ant},description={an&#x00A0;insect}}
-\begin{document}
-\gls{ant}&#x00A0;and&#x00A0;\gls{zebra}
-\printunsrtglossaries
-\end{document}
-</pre>
-<!--l. 14087--><p class="nopar" > In the above, zebra will be listed before ant as it was defined first.
-</p><!--l. 14091--><p class="indent" > If you allow document definitions with the <a
-href="#styopt.docdefs"><span
-class="cmss-10">docdefs</span></a><a
- id="dx1-87023"></a> option, the document will
-require a second LaTeX&#x00A0;run if the entries are defined after <span
-class="cmtt-10">\printunsrtglossary</span>.
-</p><!--l. 14095--><p class="indent" > The optional argument is as for <span
-class="cmtt-10">\printnoidxglossary </span>(except for the <span
-class="cmss-10">sort</span><a
- id="dx1-87024"></a> key,
-which isn&#8217;t available).
-</p><!--l. 14098--><p class="indent" > All glossaries may be displayed in the order of their definition using:
-</p><!--l. 14100--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-87025"></a> <span
-class="cmtt-10">\printunsrtglossaries </span></div><hr>
-</p><!--l. 14102--><p class="noindent" >
-which is analogous to <span
-class="cmtt-10">\printnoidxglossaries</span>. This just iterates over all defined
-glossaries (that aren&#8217;t on the ignored list) and does <span
-class="cmtt-10">\printunsrtglossary</span>[type=&#x27E8;<span
-class="cmti-10">type</span>&#x27E9;].
-</p><!--l. 14107--><p class="noindent" >
-</p>
-<!--l. 14107--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">11.2.1 </span> <a
- id="sec:printunsrthooks"></a>Hooks</h4>
-<!--l. 14110--><p class="noindent" >To avoid complications caused by <span
-class="cmss-10">tabular</span><a
- id="dx1-88001"></a><a
- id="dx1-88002"></a>-like glossary styles, <span
-class="cmtt-10">\printunsrtglossary</span>
-iterates over all entries in the selected glossary and appends the appropriate code to
-an internal command. Once the construction of this command is complete, then it&#8217;s
-performed to display the glossary. This puts the loop outside the style code. For
-convenience, there&#8217;s a hook used within the loop:
-</p><!--l. 14117--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-88003"></a> <span
-class="cmtt-10">\printunsrtglossaryentryprocesshook{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 14119--><p class="noindent" >
-This hook should not display any content, but may be used to perform calculations.
-For example, to calculate widths. Within this hook you can use:
-</p><!--l. 14123--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-88004"></a> <span
-class="cmtt-10">\printunsrtglossaryskipentry </span></div><hr>
-</p><!--l. 14125--><p class="noindent" >
-to skip the current entry. This will prevent the entry from being added to the internal
-command.
-
-
-
-</p><!--l. 14129--><p class="indent" > There&#8217;s another hook immediately before the internal command containing the
-glossary code is performed:
-</p><!--l. 14131--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-88005"></a> <span
-class="cmtt-10">\printunsrtglossarypredoglossary </span></div><hr>
-</p><!--l. 14133--><p class="noindent" >
-</p><!--l. 14135--><p class="indent" > The internal command uses
-</p><!--l. 14136--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-88006"></a> <span
-class="cmtt-10">\printunsrtglossaryhandler{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 14138--><p class="noindent" >
-to display each item in the list, where &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; is the current label.
-</p><!--l. 14141--><p class="indent" > By default the handler just does
-</p><!--l. 14142--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-88007"></a> <span
-class="cmtt-10">\glsxtrunsrtdo{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 14144--><p class="noindent" >
-which determines whether to use <span
-class="cmtt-10">\glossentry </span>or <span
-class="cmtt-10">\subglossentry </span>and checks the
-<span
-class="cmss-10">location</span><a
- id="dx1-88008"></a> and <span
-class="cmss-10">loclist</span><a
- id="dx1-88009"></a> fields for the <a
- id="dx1-88010"></a><a
-href="#glo:numberlist">number list</a>. If you want to use a different field to be
-used instead of <span
-class="cmss-10">location</span><a
- id="dx1-88011"></a> then redefine:
-</p><!--l. 14150--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-88012"></a> <span
-class="cmtt-10">\GlsXtrLocationField </span></div><hr>
-</p><!--l. 14152--><p class="noindent" >
-to the internal name of the desired field. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-318">
-\renewcommand{\GlsXtrLocationField}{primarylocation}
-</pre>
-<!--l. 14156--><p class="nopar" >
-</p><!--l. 14157--><p class="indent" > <div class="important" title="Important Note"> Note that if the given location field is undefined or unset, the handler will
-fallback on the <span
-class="cmss-10">loclist</span><a
- id="dx1-88013"></a> field. </div>
-</p><!--l. 14160--><p class="noindent" >
-You can instruct <a
- id="dx1-88014"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> to omit setting the <span
-class="cmss-10">loclist</span><a
- id="dx1-88015"></a> field with the resource option
-<span
-class="cmtt-10">--save-loclist=false </span>to prevent it from being used as a fallback.
-</p><!--l. 14165--><p class="noindent" >
-</p>
-<!--l. 14165--><p class="noindent" ><a
-href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">11.2.2 </span> <a
- id="sec:printunsrtfilter"></a>Filtering</h4>
-<!--l. 14168--><p class="noindent" >You can redefine the handler used by <span
-class="cmtt-10">\printunsrtglossary </span>if required. For
-example, you may want to filter entries according to the category label. You can test
-if a label is contained in a comma-separated list of labels using:
-</p><!--l. 14172--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-89001"></a> <span
-class="cmtt-10">\glsxtriflabelinlist{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label list</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">true</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">false</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 14174--><p class="noindent" >
-The &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; and &#x27E8;<span
-class="cmti-10">label list</span>&#x27E9; will be fully expanded.
-</p><!--l. 14177--><p class="indent" > <div class="important" title="Important Note"> If you redefine the handler to exclude entries, you may end up with an empty
-glossary. This could cause a problem for the list-based styles. </div>
-</p><!--l. 14181--><p class="noindent" >
-</p><!--l. 14183--><p class="indent" > For example, if the preamble includes:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-319">
-\usepackage[record,style=index]{glossaries-extra}
-\GlsXtrRecordCounter{section}
-</pre>
-<!--l. 14187--><p class="nopar" > then you can print the glossary but first redefine the handler to only select entries
-that include the current section number in the <span
-class="cmtt-10">record.section </span>field:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-320">
-\renewcommand{\printunsrtglossaryhandler}[1]{%
-&#x00A0;&#x00A0;\glsxtrfieldxifinlist{#1}{record.section}{\thesection}
-&#x00A0;&#x00A0;{\glsxtrunsrtdo{#1}}%
-&#x00A0;&#x00A0;{}%
+<a id="wrglossary.12991"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> If the document is in a file called <span class="filefmt">myDoc.tex</span> then the document build is: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
+bib2gls --record-count-unit myDoc
+pdflatex myDoc
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:bib2glsunitrecordcounting"></a>Example 155: Using <span class="appfmt">bib2gls</span>: unit record counting <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example155.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example155.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example155-page1.png" type="image/png" width="371" height="60">Page 1. Example document using bib2gls with unit records.</object><object data="glossaries-extra-manual-examples/glossaries-extra-manual-example155-page2.png" type="image/png" width="446" height="61">Page 2. Example document using bib2gls with unit records.</object><object data="glossaries-extra-manual-examples/glossaries-extra-manual-example155-page3.png" type="image/png" width="447" height="122">Page 3. Example document using bib2gls with unit records.</object> </div><!-- end of resultbox -->
+<p>
+
+</section><!-- end of section sec:unitrecordcount -->
+
+<section id="sec:unitrecordcountminigloss"><!-- start of section sec:unitrecordcountminigloss --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->11.4.2. Mini-Glossaries<div class="labellink"><a href="#sec:unitrecordcountminigloss">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+Record counting doesn’t have to be used with the <a id="wrglossary.12992"></a><a href="#glo:rgls"><code class="csfmt">\rgls</code></a> set of commands. When <a id="wrglossary.12993"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> writes the code to the <a id="wrglossary.12994"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file to save the record counting information, it does it with helper commands that it provides in the <a id="wrglossary.12995"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.12996"></a><code class="code"><dfn id="glo:bibglssettotalrecordcount"><code class="csfmt">\bibglssettotalrecordcount</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This sets the total record count and is defined in the <a id="wrglossary.12997"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file as: <pre class="compactcodebox"><code class="cmd">\providecommand</code>*{<a id="wrglossary.12998"></a><a href="#glo:bibglssettotalrecordcount"><code class="csfmt">\bibglssettotalrecordcount</code></a>}[2]{<span class="comment">% </span>
+ <a id="wrglossary.12999"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>{#1}{<a id="wrglossary.13000"></a><a href="#glo:opt.glosfield.recordcount"><span class="csoptfmt">recordcount</span></a>}{#2}<span class="comment">% </span>
}
-</pre>
-<!--l. 14197--><p class="nopar" >
-</p><!--l. 14199--><p class="indent" > Alternatively you can use the starred form of <span
-class="cmtt-10">\printunsrtglossary </span>which will
-localise the change:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-321">
-\printunsrtglossary*{%
-&#x00A0;&#x00A0;\renewcommand{\printunsrtglossaryhandler}[1]{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glsxtrfieldxifinlist{#1}{record.section}{\thesection}
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;{\glsxtrunsrtdo{#1}}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;{}%
-&#x00A0;&#x00A0;}%
+</pre> <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13001"></a><code class="code"><dfn id="glo:bibglssetrecordcount"><code class="csfmt">\bibglssetrecordcount</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This sets the total for the given counter and is defined as: <pre class="compactcodebox"><code class="cmd">\providecommand</code>*{<a id="wrglossary.13002"></a><a href="#glo:bibglssetrecordcount"><code class="csfmt">\bibglssetrecordcount</code></a>}[3]{<span class="comment">% </span>
+ <a id="wrglossary.13003"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>{#1}{<a id="wrglossary.13004"></a><a href="#glo:opt.glosfield.recordcount.counter"><span class="csoptfmt">recordcount.#2</span></a>}{#3}<span class="comment">% </span>
}
-</pre>
-<!--l. 14210--><p class="nopar" >
-</p><!--l. 14212--><p class="indent" > If you are using the <span
-class="cmss-10">hyperref</span><a
- id="dx1-89002"></a> package and want to display the same glossary more
-than once, you can also add a temporary redefinition of <span
-class="cmtt-10">\glolinkprefix </span>to avoid
-duplicate hypertarget names. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-322">
-\printunsrtglossary*{%
-&#x00A0;&#x00A0;\renewcommand{\printunsrtglossaryhandler}[1]{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glsxtrfieldxifinlist{#1}{record.section}{\thesection}
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;{\glsxtrunsrtdo{#1}}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;{}%
-&#x00A0;&#x00A0;}%
-&#x00A0;&#x00A0;\ifcsundef{theHsection}%
-&#x00A0;&#x00A0;{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\renewcommand*{\glolinkprefix}{record.\csuse{thesection}.}%
-&#x00A0;&#x00A0;}%
-&#x00A0;&#x00A0;{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\renewcommand*{\glolinkprefix}{record.\csuse{theHsection}.}%
-&#x00A0;&#x00A0;}%
+</pre> The following is only available with <a id="wrglossary.13005"></a><a href="#glo:switch.record-count-unit"><span class="longargfmt">--record-count-unit</span></a>: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13006"></a><code class="code"><dfn id="glo:bibglssetlocationrecordcount"><code class="csfmt">\bibglssetlocationrecordcount</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This sets the total for the given location and is defined as: <pre class="compactcodebox"><code class="cmd">\providecommand</code>*{<a id="wrglossary.13007"></a><a href="#glo:bibglssetlocationrecordcount"><code class="csfmt">\bibglssetlocationrecordcount</code></a>}[4]{<span class="comment">% </span>
+ <a id="wrglossary.13008"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>{#1}{<a id="wrglossary.13009"></a><a href="#glo:opt.glosfield.recordcount.counter.location"><span class="csoptfmt">recordcount.#2.<a id="wrglossary.13010"></a><a href="#glo:glsxtrdetoklocation"><code class="csfmt">\glsxtrdetoklocation</code></a>{#3}</span></a>}{#4}<span class="comment">% </span>
}
-</pre>
-<!--l. 14232--><p class="nopar" > Note that this will cause a problem if your descriptions contain commands like <span
-class="cmtt-10">\gls</span>
-that need to link an entry that doesn&#8217;t appear in the summary. In this case, it&#8217;s a
-better approach to use:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-323">
-\printunsrtglossary*{%
-&#x00A0;&#x00A0;\renewcommand{\printunsrtglossaryhandler}[1]{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glsxtrfieldxifinlist{#1}{record.section}{\thesection}
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;{\glsxtrunsrtdo{#1}}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;{}%
-&#x00A0;&#x00A0;}%
-&#x00A0;&#x00A0;\ifcsundef{theHsection}%
-&#x00A0;&#x00A0;{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\setkeys{printgloss}{targetnameprefix={record.\csuse{thesection}.}}%
-&#x00A0;&#x00A0;}%
-&#x00A0;&#x00A0;{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\setkeys{printgloss}{targetnameprefix={record.\csuse{theHsection}.}}%
-&#x00A0;&#x00A0;}%
+</pre><p>
+By defining one of more of these commands before the <a id="wrglossary.13011"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file is input, it’s possible to pick up the information, without the need to iterate over all entries later. For example, the following will create a <a id="wrglossary.13012"></a><a href="#glo:idx.mini-glossary">mini-glossary</a> for each particular location and populate it with entries that have a record for that location. <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.13013"></a><a href="#glo:bibglssetlocationrecordcount"><code class="csfmt">\bibglssetlocationrecordcount</code></a>}[4]{<span class="comment">% </span>
+ <a id="wrglossary.13014"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>{#1}{<a id="wrglossary.13015"></a><a href="#glo:opt.glosfield.recordcount.counter.location"><span class="csoptfmt">recordcount.#2.#3</span></a>}{#4}<span class="comment">% </span>
+ <a id="wrglossary.13016"></a><a href="#glo:provideignoredglossary"><code class="csfmt">\provideignoredglossary</code></a>{minigloss.#2.#3}<span class="comment">% </span>
+ <a id="wrglossary.13017"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a>{#1}minigloss.#2.#3<span class="comment">% </span>
}
-</pre>
-<!--l. 14252--><p class="nopar" >
-</p><!--l. 14254--><p class="indent" > If it&#8217;s a short summary at the start of a section, you might also want to suppress
-the glossary header and add some vertical space afterwards:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-324">
-\printunsrtglossary*{%
-&#x00A0;&#x00A0;\renewcommand{\printunsrtglossaryhandler}[1]{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glsxtrfieldxifinlist{#1}{record.section}{\thesection}
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;{\glsxtrunsrtdo{#1}}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;{}%
-&#x00A0;&#x00A0;}%
-&#x00A0;&#x00A0;\ifcsundef{theHsection}%
-&#x00A0;&#x00A0;{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\renewcommand*{\glolinkprefix}{record.\csuse{thesection}.}%
-&#x00A0;&#x00A0;}%
-&#x00A0;&#x00A0;{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\renewcommand*{\glolinkprefix}{record.\csuse{theHsection}.}%
-&#x00A0;&#x00A0;}%
-&#x00A0;&#x00A0;\renewcommand*{\glossarysection}[2][]{}%
-&#x00A0;&#x00A0;\appto\glossarypostamble{\glspar\medskip\glspar}%
+</pre> I’ve omitted <a id="wrglossary.13018"></a><a href="#glo:glsxtrdetoklocation"><code class="csfmt">\glsxtrdetoklocation</code></a> for clarity and because I’m confident the locations won’t be problematic. The <a id="wrglossary.13019"></a><a href="#glo:idx.mini-glossary">mini-glossary</a> can then be displayed at the start of the chapter with: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.13020"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<a id="wrglossary.13021"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=minigloss.chapter.<a id="wrglossary.13022"></a><a href="#glo:theHcounter"><code class="csfmt">\theHchapter</code></a></span>]
+</pre><p>
+The previous example can be altered to strip the <a id="wrglossary.13023"></a><a href="#glo:rgls"><code class="csfmt">\rgls</code></a> commands and instead add a <a id="wrglossary.13024"></a><a href="#glo:idx.mini-glossary">mini-glossary</a> at the start of each chapter (the redefinition of <a id="wrglossary.13025"></a><a href="#glo:glslinkpresetkeys"><code class="csfmt">\glslinkpresetkeys</code></a> remains to ensure there are locations with the <a id="wrglossary.13026"></a><a href="#glo:ctr.chapter"><span class="ctrfmt">chapter</span></a> counter). I’ve also provided a command to make it easier to display the <a id="wrglossary.13027"></a><a href="#glo:idx.mini-glossary">mini-glossaries</a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<code class="cmd">\minigloss</code>}{<span class="comment">% </span>
+ <a id="wrglossary.13028"></a><a href="#glo:printunsrtglossary*"><code class="csfmt">\printunsrtglossary*</code></a>[<a id="wrglossary.13029"></a><a href="#glo:opt.printgloss.style"><span class="csoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.13030"></a><a href="#glo:opt.glostyle.abbr-short-long"><span class="glostylefmt">abbr-short-long</span></a></span>,<a id="wrglossary.13031"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=minigloss.chapter.<a id="wrglossary.13032"></a><a href="#glo:theHcounter"><code class="csfmt">\theHchapter</code></a></span>,<a id="wrglossary.13033"></a><a href="#glo:opt.printgloss.groups"><span class="csoptfmt">groups</span></a><span class="optfmt">=false</span>,<a id="wrglossary.13034"></a><a href="#glo:opt.printgloss.target"><span class="csoptfmt">target</span></a><span class="optfmt">=false</span>]<span class="comment">% </span>
+ {<code class="cmd">\renewcommand</code>{<a id="wrglossary.13035"></a><a href="#glo:glossarysection"><code class="csfmt">\glossarysection</code></a>}[2][]{}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>{<a id="wrglossary.13036"></a><a href="#glo:glslongextraShortLongTabularHeader"><code class="csfmt">\glslongextraShortLongTabularHeader</code></a>}{<code class="cmd">\toprule</code>}<span class="comment">% </span>
+ }}
+</pre> The document build is the same.<p>
+<div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:recordcountminigloss"></a>Example 156: Using <span class="appfmt">bib2gls</span>: unit record counting mini-glossary <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example156.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example156.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example156-page1.png" type="image/png" width="407" height="120">Page 1. Example document using bib2gls to create a mini-glossary with unit records.</object><object data="glossaries-extra-manual-examples/glossaries-extra-manual-example156-page2.png" type="image/png" width="276" height="136">Page 2. Example document using bib2gls to create a mini-glossary with unit records.</object><object data="glossaries-extra-manual-examples/glossaries-extra-manual-example156-page3.png" type="image/png" width="447" height="122">Page 3. Example document using bib2gls to create a mini-glossary with unit records.</object> </div><!-- end of resultbox -->
+<p>
+
+</section><!-- end of section sec:unitrecordcountminigloss -->
+
+<section id="sec:bib2glssty"><!-- start of section sec:bib2glssty --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->11.5. The <span class="styfmt">glossaries-extra-bib2gls</span> package<div class="labellink"><a href="#sec:bib2glssty">[link]</a></div></h2><!-- end of section header -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13037"></a><code class="code"><code class="cmd">\usepackage</code>{<dfn id="glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></dfn>}</code><p>
+<div class="noteBox">automatically loaded with <code class="code"><code class="csfmt">\usepackage</code>[<a id="wrglossary.13038"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>]{glossaries-extra}</code> or <code class="code"><code class="csfmt">\usepackage</code>[<a id="wrglossary.13039"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.13040"></a><a href="#glo:optval.record.nameref"><span class="optfmt">nameref</span></a>]{glossaries-extra}</code></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ <a id="wrglossary.13041"></a>The package options <a id="wrglossary.13042"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.13043"></a><a href="#glo:optval.record.only"><span class="optfmt">only</span></a> (or simply <a id="wrglossary.13044"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>) and <a id="wrglossary.13045"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.13046"></a><a href="#glo:optval.record.nameref"><span class="optfmt">nameref</span></a> automatically loads the supplementary package <a id="wrglossary.13047"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a>, which provides some commands that are specific to <a id="wrglossary.13048"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, in particular to sorting and <a id="wrglossary.13049"></a><a href="#glo:dual.locationlist">location lists</a> which aren’t relevant with <a id="wrglossary.13050"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.13051"></a><a href="#glo:optval.record.hybrid"><span class="optfmt">hybrid</span></a>.<p>
+If <a id="wrglossary.13052"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> is loaded via the <a id="wrglossary.13053"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a> package option then the check for associated language files (see §<a href="#sec:lang">15</a>) will also search for the existence of <span class="filefmt">glossariesxtr-</span><span class="meta">〈<em class="metainner">script</em>〉</span><span class="filefmt">.ldf</span> for each document dialect (where <span class="meta">〈<em class="metainner">script</em>〉</span> is the four letter script identifier, such as <code class="code">Latn</code>).<p>
+
+</section><!-- end of section sec:bib2glssty -->
+
+<section id="sec:printunsrtshortcuts"><!-- start of section sec:printunsrtshortcuts --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->11.5.1. Displaying Glossaries<div class="labellink"><a href="#sec:printunsrtshortcuts">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<a id="wrglossary.13054"></a><a href="#glo:dual.glossary">Glossaries</a> are displayed with the <a id="wrglossary.13055"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> (see §<a href="#sec:printunsrt">8.4</a>). Some styles, such as <a id="wrglossary.13056"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a>, are customized for use with <a id="wrglossary.13057"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>.<p>
+The following commands are shortcuts that use <a id="wrglossary.13058"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>. However, they are only defined if a corresponding package option has been set <span style="font-style: italic; font-variant: normal; ">before</span> <a id="wrglossary.13059"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> is loaded. This means that the options must be passed as a package option, not using <a id="wrglossary.13060"></a><a href="#glo:glossariesextrasetup"><code class="csfmt">\glossariesextrasetup</code></a>, if the shortcut commands are required.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13061"></a><code class="code"><dfn id="glo:printunsrtabbreviations"><code class="csfmt">\printunsrtabbreviations</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ This shortcut is provided if the <a id="wrglossary.13062"></a><a href="#glo:opt.abbreviations"><span class="styoptfmt">abbreviations</span></a> package option has been used. This is a shortcut for: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.13063"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[type=abbreviations,<span class="meta">〈<em class="metainner">options</em>〉</span>]
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13064"></a><code class="code"><dfn id="glo:printunsrtacronyms"><code class="csfmt">\printunsrtacronyms</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ This shortcut is provided if the <a id="wrglossary.13065"></a><a href="#glo:opt.acronyms"><span class="styoptfmt">acronyms</span></a> (or <a id="wrglossary.13066"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>) package option has been used. This is a shortcut for: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.13067"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[type=<a id="wrglossary.13068"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>,<span class="meta">〈<em class="metainner">options</em>〉</span>]
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13069"></a><code class="code"><dfn id="glo:printunsrtsymbols"><code class="csfmt">\printunsrtsymbols</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ This shortcut is provided if the <a id="wrglossary.13070"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a> package option has been used. This is a shortcut for: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.13071"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[type=symbols,<span class="meta">〈<em class="metainner">options</em>〉</span>]
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13072"></a><code class="code"><dfn id="glo:printunsrtnumbers"><code class="csfmt">\printunsrtnumbers</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ This shortcut is provided if the <a id="wrglossary.13073"></a><a href="#glo:opt.numbers"><span class="styoptfmt">numbers</span></a> package option has been used. This is a shortcut for: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.13074"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[type=numbers,<span class="meta">〈<em class="metainner">options</em>〉</span>]
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13075"></a><code class="code"><dfn id="glo:printunsrtindex"><code class="csfmt">\printunsrtindex</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ This shortcut is provided if the <a id="wrglossary.13076"></a><a href="#glo:opt.index"><span class="styoptfmt">index</span></a> package option has been used. This is a shortcut for: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.13077"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[type=index,<span class="meta">〈<em class="metainner">options</em>〉</span>]
+</pre><p>
+
+</section><!-- end of section sec:printunsrtshortcuts -->
+
+<section id="sec:resourcecommands"><!-- start of section sec:resourcecommands --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->11.5.2. Helper Commands for Resource Options<div class="labellink"><a href="#sec:resourcecommands">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13078"></a><code class="code"><dfn id="glo:glshex"><code class="csfmt">\glshex</code></dfn><span class="meta">〈<em class="metainner">hex</em>〉</span></code></div><!-- end of pinnedbox -->
+ This simply expands to <code class="code"><a id="wrglossary.13079"></a><a href="#glo:string"><code class="csfmt">\string</code></a><a id="wrglossary.13080"></a><a href="#glo:u"><code class="csfmt">\u</code></a><span class="meta">〈<em class="metainner">hex</em>〉</span></code>, which is used to identify the Unicode character <span class="meta">〈<em class="metainner">hex</em>〉</span> in the value of some <a id="wrglossary.13081"></a><a href="#glo:idx.resourceopt">resource options</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13082"></a><code class="code"><dfn id="glo:glshashchar"><code class="csfmt">\glshashchar</code></dfn></code></div><!-- end of pinnedbox -->
+ This expands to a literal <a id="wrglossary.13083"></a><a href="#glo:idx.sym.hash"><code class="code">#</code></a> character (similar to <a id="wrglossary.13084"></a><a href="#glo:glsbackslash"><code class="csfmt">\glsbackslash</code></a>).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13085"></a><code class="code"><dfn id="glo:glscapturedgroup"><code class="csfmt">\glscapturedgroup</code></dfn><span class="meta">〈<em class="metainner">n</em>〉</span></code></div><!-- end of pinnedbox -->
+ This simply expands to <code class="code"><a id="wrglossary.13086"></a><a href="#glo:string"><code class="csfmt">\string</code></a><a id="wrglossary.13087"></a><a href="#glo:dollar"><code class="csfmt">\$</code></a><span class="meta">〈<em class="metainner">n</em>〉</span></code> which is used to indicate the <span class="meta">〈<em class="metainner">n</em>〉</span>th captured group in a regular expression replacement in the value of some <a id="wrglossary.13088"></a><a href="#glo:idx.resourceopt">resource options</a> (requires <a id="wrglossary.13089"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v1.5+), such as <a id="wrglossary.13090"></a><a href="#glo:opt.resource.sort-replace"><span class="csoptfmt">sort-replace</span></a>. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.13091"></a><a href="#glo:opt.resource.sort-replace"><span class="csoptfmt">sort-replace</span></a><span class="optfmt">={{([a-zA-Z])<a id="wrglossary.13092"></a><a href="#glo:string"><code class="csfmt">\string</code></a><code class="cmd">\.</code>}{<a id="wrglossary.13093"></a><a href="#glo:glscapturedgroup"><code class="csfmt">\glscapturedgroup</code></a>1}}</span>
+</pre> This removes a full stop that follows any of the characters a,…,z or A,…,Z.<p>
+A convenient shortcut for use in the <a id="wrglossary.13094"></a><a href="#glo:opt.resource.entry-type-aliases"><span class="csoptfmt">entry-type-aliases</span></a> setting: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13095"></a><code class="code"><dfn id="glo:GlsXtrBibTeXEntryAliases"><code class="csfmt">\GlsXtrBibTeXEntryAliases</code></dfn></code></div><!-- end of pinnedbox -->
+ This provides aliases for BibTeX’s standard entry types (such as <code class="code">@article</code> and <code class="code">@book</code>) to <a id="wrglossary.13096"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span>’s</a> <code class="code">@bibtexentry</code> entry type (requires <a id="wrglossary.13097"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v1.4+).<p>
+You may also want to provide storage keys for BibTeX’s standard fields rather than having to alias them all. This can be done with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13098"></a><code class="code"><dfn id="glo:GlsXtrProvideBibTeXFields"><code class="csfmt">\GlsXtrProvideBibTeXFields</code></dfn></code></div><!-- end of pinnedbox -->
+ This defines each BibTeX field, such as <code class="fieldfmt">author</code>, as a glossary entry key: <pre class="compactcodebox"><a id="wrglossary.13099"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>{address}{}{<a id="wrglossary.13100"></a><dfn id="glo:glsxtrbibaddress"><code class="csfmt">\glsxtrbibaddress</code></dfn>}%
+ <a id="wrglossary.13101"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>{author}{}{<a id="wrglossary.13102"></a><dfn id="glo:glsxtrbibauthor"><code class="csfmt">\glsxtrbibauthor</code></dfn>}%
+ <a id="wrglossary.13103"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>{booktitle}{}{<a id="wrglossary.13104"></a><dfn id="glo:glsxtrbibbooktitle"><code class="csfmt">\glsxtrbibbooktitle</code></dfn>}%
+ <a id="wrglossary.13105"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>{chapter}{}{<a id="wrglossary.13106"></a><dfn id="glo:glsxtrbibchapter"><code class="csfmt">\glsxtrbibchapter</code></dfn>}%
+ <a id="wrglossary.13107"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>{edition}{}{<a id="wrglossary.13108"></a><dfn id="glo:glsxtrbibedition"><code class="csfmt">\glsxtrbibedition</code></dfn>}%
+ <a id="wrglossary.13109"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>{howpublished}{}{<a id="wrglossary.13110"></a><dfn id="glo:glsxtrbibhowpublished"><code class="csfmt">\glsxtrbibhowpublished</code></dfn>}%
+ <a id="wrglossary.13111"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>{institution}{}{<a id="wrglossary.13112"></a><dfn id="glo:glsxtrbibinstitution"><code class="csfmt">\glsxtrbibinstitution</code></dfn>}%
+ <a id="wrglossary.13113"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>{journal}{}{<a id="wrglossary.13114"></a><dfn id="glo:glsxtrbibjournal"><code class="csfmt">\glsxtrbibjournal</code></dfn>}%
+ <a id="wrglossary.13115"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>{month}{}{<a id="wrglossary.13116"></a><dfn id="glo:glsxtrbibmonth"><code class="csfmt">\glsxtrbibmonth</code></dfn>}%
+ <a id="wrglossary.13117"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>{note}{}{<a id="wrglossary.13118"></a><dfn id="glo:glsxtrbibnote"><code class="csfmt">\glsxtrbibnote</code></dfn>}%
+ <a id="wrglossary.13119"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>{number}{}{<a id="wrglossary.13120"></a><dfn id="glo:glsxtrbibnumber"><code class="csfmt">\glsxtrbibnumber</code></dfn>}%
+ <a id="wrglossary.13121"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>{organization}{}{<a id="wrglossary.13122"></a><dfn id="glo:glsxtrbiborganization"><code class="csfmt">\glsxtrbiborganization</code></dfn>}%
+ <a id="wrglossary.13123"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>{pages}{}{<a id="wrglossary.13124"></a><dfn id="glo:glsxtrbibpages"><code class="csfmt">\glsxtrbibpages</code></dfn>}%
+ <a id="wrglossary.13125"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>{publisher}{}{<a id="wrglossary.13126"></a><dfn id="glo:glsxtrbibpublisher"><code class="csfmt">\glsxtrbibpublisher</code></dfn>}%
+ <a id="wrglossary.13127"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>{school}{}{<a id="wrglossary.13128"></a><dfn id="glo:glsxtrbibschool"><code class="csfmt">\glsxtrbibschool</code></dfn>}%
+ <a id="wrglossary.13129"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>{series}{}{<a id="wrglossary.13130"></a><dfn id="glo:glsxtrbibseries"><code class="csfmt">\glsxtrbibseries</code></dfn>}%
+ <a id="wrglossary.13131"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>{title}{}{<a id="wrglossary.13132"></a><dfn id="glo:glsxtrbibtitle"><code class="csfmt">\glsxtrbibtitle</code></dfn>}%
+ <a id="wrglossary.13133"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>{bibtextype}{}{<a id="wrglossary.13134"></a><dfn id="glo:glsxtrbibtype"><code class="csfmt">\glsxtrbibtype</code></dfn>}%
+ <a id="wrglossary.13135"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>{volume}{}{<a id="wrglossary.13136"></a><dfn id="glo:glsxtrbibvolume"><code class="csfmt">\glsxtrbibvolume</code></dfn>}%
+</pre> This command should be placed before the first <a id="wrglossary.13137"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>.<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+BibTeX’s <code class="fieldfmt">type</code> field clashes with the <a id="wrglossary.13138"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s <a id="wrglossary.13139"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> key, so this command provides the key <code class="fieldfmt">bibtextype</code> instead. You can alias it with <a id="wrglossary.13140"></a><a href="#glo:opt.resource.field-aliases"><span class="csoptfmt">field-aliases</span></a><span class="optfmt">={<a id="wrglossary.13141"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a>=<code class="fieldfmt">bibtextype</code>}</span> in the <a id="wrglossary.13142"></a><a href="#glo:idx.resourceopt">resource options</a>. </div><!-- end of warning -->
+<p>
+
+</section><!-- end of section sec:resourcecommands -->
+
+<section id="sec:customsort"><!-- start of section sec:customsort --><div class="tomain"><a href="#main">[top]</a></div>
+<h4><!-- start of subsubsection header -->11.5.2.1. Custom Sort<div class="labellink"><a href="#sec:customsort">[link]</a></div></h4><!-- end of subsubsection header -->
+<p>
+There are many locale alphabetical rules provided with <a id="wrglossary.13143"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, such as <a id="wrglossary.13144"></a><a href="#glo:opt.resource.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=de-1996</span> for German new orthography. However, it may be that your particular locale isn’t supported, or you want a rule that covers multiple scripts or non-alphabetic symbols.<p>
+The <a id="wrglossary.13145"></a><a href="#glo:opt.resource.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=custom</span> setting combined with <a id="wrglossary.13146"></a><a href="#glo:opt.resource.sort-rule"><span class="csoptfmt">sort-rule</span></a> provides a way to define your own sort rule. For example, suppose I have a file called <span class="filefmt">animals.bib</span> that contains: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="code">@index</code>{bee}<br><code class="code">@index</code>{lion}<br><code class="code">@index</code>{ant}<br><code class="code">@index</code>{cow}<br><code class="code">@index</code>{goose}<br><code class="code">@index</code>{zebu}<br><code class="code">@index</code>{egret}<br><code class="code">@index</code>{elk}<br><code class="code">@index</code>{llama}<br><code class="code">@index</code>{lynx}<br><code class="code">@index</code>{bat}</pre> Here’s a very limited rule that only recognises five letters: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.13147"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>,<a id="wrglossary.13148"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>,<a id="wrglossary.13149"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a><span class="optfmt">=bookindex</span>,<a id="wrglossary.13150"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.13151"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a></span>]
+{glossaries-extra}
+
+<code class="cmd">\newcommand</code>{<a id="wrglossary.13152"></a><a href="#glo:bibglssetlastgrouptitle"><code class="csfmt">\bibglssetlastgrouptitle</code></a>}[2]{%
+ <a id="wrglossary.13153"></a><a href="#glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></a>{#1#2}{Other}%
}
-</pre>
-<!--l. 14274--><p class="nopar" >
-</p><!--l. 14276--><p class="indent" > There&#8217;s a shortcut command that essentially does this:
-</p><!--l. 14277--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-89003"></a> <span
-class="cmtt-10">\printunsrtglossaryunit[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">counter name</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 14279--><p class="noindent" >
-The above example can simply be replaced with:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-325">
-\printunsrtglossaryunit{section}
-</pre>
-<!--l. 14283--><p class="nopar" >
-</p><!--l. 14285--><p class="indent" > This shortcut command is actually defined to use <span
-class="cmtt-10">\printunsrtglossary*</span>
-with
-</p><!--l. 14286--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-89004"></a> <span
-class="cmtt-10">\printunsrtglossaryunitsetup{</span>&#x27E8;<span
-class="cmitt-10">counter name</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 14288--><p class="noindent" >
-so if you want to just make some minor modifications you can do
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-326">
-\printunsrtglossary*{\printunsrtglossaryunitsetup{section}%
-&#x00A0;&#x00A0;\renewcommand*{\glossarysection}[2][]{\subsection*{Summary}}%
+<a id="wrglossary.13154"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.13155"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">=animals</span>,<a id="wrglossary.13156"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">=all</span>,
+ <a id="wrglossary.13157"></a><a href="#glo:opt.resource.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=custom</span>,<a id="wrglossary.13158"></a><a href="#glo:opt.resource.sort-rule"><span class="csoptfmt">sort-rule</span></a><span class="optfmt">={ &lt; a,A &lt; b,B &lt; e,E &lt; l,L &lt; ll,Ll,LL &lt; z,Z}</span>]
+
+<code class="cbeg">\begin{document}</code>
+<a id="wrglossary.13159"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> Any characters that aren’t included in the rule (such as <span class="qt">“c”</span> and <span class="qt">“g”</span>) are placed at the end. I’ve defined <a id="wrglossary.13160"></a><a href="#glo:bibglssetlastgrouptitle"><code class="csfmt">\bibglssetlastgrouptitle</code></a> to label that final group of characters <span class="qt">“Other”</span>. If the document is in a file called <span class="filefmt">myDoc.tex</span>, the build process is: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
+bib2gls <a id="wrglossary.13161"></a><a href="#glo:switch.group"><span class="shortargfmt">-g</span></a> myDoc
+pdflatex myDoc
+</pre> The result is: <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:bib2glscustomsort"></a>Example 157: Using <span class="appfmt">bib2gls</span>: simple custom sort rule <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example157.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example157.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example157.png" type="image/png" width="311" height="234">Example document that provides a simplistic custom sort rule.</object> </div><!-- end of resultbox -->
+ Note that <span class="qt">“egret”</span> has been placed after <span class="qt">“elk”</span>. This is because <span class="qt">“l”</span> is included in the rule but <span class="qt">“g”</span> isn’t. Whereas <span class="qt">“lynx”</span> comes before <span class="qt">“llama”</span> because there’s a separate <span class="qt">“ll”</span> group after the <span class="qt">“l”</span> group.<p>
+The commands listed below provide common rule blocks for use in the <a id="wrglossary.13162"></a><a href="#glo:opt.resource.sort-rule"><span class="csoptfmt">sort-rule</span></a> resource option. If you want a rule for a specific locale, you can provide similar commands in a file called <span class="filefmt">glossariesxtr-</span><span class="meta">〈<em class="metainner">tag</em>〉</span><span class="filefmt">.ldf</span>, where <span class="meta">〈<em class="metainner">tag</em>〉</span> identifies the dialect, locale, region or root language. See the description of <a id="wrglossary.13163"></a><a href="#glo:IfTrackedLanguageFileExists"><code class="csfmt">\IfTrackedLanguageFileExists</code></a> in the <a id="wrglossary.13164"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> documentation for further details. If this file is on TeX’s path and the <a id="wrglossary.13165"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> package (automatically loaded by <a id="wrglossary.13166"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>) detects that the document has requested that language or locale, then the file will automatically be loaded. For example, if you want to provide a rule block for Welsh, then create a file called <span class="filefmt">glossariesxtr-welsh.ldf</span> that contains: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.13167"></a><a href="#glo:ProvidesGlossariesExtraLang"><code class="csfmt">\ProvidesGlossariesExtraLang</code></a>{welsh}[2018/02/23 v1.0]
+
+<code class="cmd">\@ifpackageloaded</code>{glossaries-extra-bib2gls}
+{
+ <code class="cmd">\newcommand</code>{<code class="cmd">\glsxtrWelshRules</code>}{%
+ <a id="wrglossary.13168"></a><a href="#glo:glsxtrLatinA"><code class="csfmt">\glsxtrLatinA</code></a>
+ <a id="wrglossary.13169"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;b,B
+ <a id="wrglossary.13170"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;c,C
+ <a id="wrglossary.13171"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;ch,CH
+ <a id="wrglossary.13172"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;d,D
+ <a id="wrglossary.13173"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;dd,DD
+ <a id="wrglossary.13174"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;<a id="wrglossary.13175"></a><a href="#glo:glsxtrLatinE"><code class="csfmt">\glsxtrLatinE</code></a>
+ <a id="wrglossary.13176"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;f,F
+ <a id="wrglossary.13177"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;ff,FF
+ <a id="wrglossary.13178"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;g,G
+ <a id="wrglossary.13179"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;ng,NG
+ <a id="wrglossary.13180"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;<a id="wrglossary.13181"></a><a href="#glo:glsxtrLatinH"><code class="csfmt">\glsxtrLatinH</code></a>
+ <a id="wrglossary.13182"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;<a id="wrglossary.13183"></a><a href="#glo:glsxtrLatinI"><code class="csfmt">\glsxtrLatinI</code></a>
+ <a id="wrglossary.13184"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;j,J
+ <a id="wrglossary.13185"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;<a id="wrglossary.13186"></a><a href="#glo:glsxtrLatinL"><code class="csfmt">\glsxtrLatinL</code></a>
+ <a id="wrglossary.13187"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;ll,Ll,LL
+ <a id="wrglossary.13188"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;<a id="wrglossary.13189"></a><a href="#glo:glsxtrLatinM"><code class="csfmt">\glsxtrLatinM</code></a>
+ <a id="wrglossary.13190"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;<a id="wrglossary.13191"></a><a href="#glo:glsxtrLatinN"><code class="csfmt">\glsxtrLatinN</code></a>
+ <a id="wrglossary.13192"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;<a id="wrglossary.13193"></a><a href="#glo:glsxtrLatinO"><code class="csfmt">\glsxtrLatinO</code></a>
+ <a id="wrglossary.13194"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;<a id="wrglossary.13195"></a><a href="#glo:glsxtrLatinP"><code class="csfmt">\glsxtrLatinP</code></a>
+ <a id="wrglossary.13196"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;ph,PH
+ <a id="wrglossary.13197"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;r,R
+ <a id="wrglossary.13198"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;rh,RH
+ <a id="wrglossary.13199"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;<a id="wrglossary.13200"></a><a href="#glo:glsxtrLatinS"><code class="csfmt">\glsxtrLatinS</code></a>
+ <a id="wrglossary.13201"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;<a id="wrglossary.13202"></a><a href="#glo:glsxtrLatinT"><code class="csfmt">\glsxtrLatinT</code></a>
+ <a id="wrglossary.13203"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;th,TH
+ <a id="wrglossary.13204"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;u,U
+ <a id="wrglossary.13205"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;w,W
+ <a id="wrglossary.13206"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;y,Y
+ }
}
-</pre>
-<!--l. 14295--><p class="nopar" > which will start the list with a subsection header with the title &#8220;Summary&#8221;
-(overriding the glossary&#8217;s title).
-</p><!--l. 14299--><p class="indent" > Note that this shortcut command is only available with the <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><a
- id="dx1-89005"></a> (or
-<a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=hybrid</span><a
- id="dx1-89006"></a>) package option.
-</p><!--l. 14302--><p class="indent" > This temporary change in the hypertarget prefix means you need to explicitly use
-<span
-class="cmtt-10">\hyperlink </span>to create a link to it as commands like <span
-class="cmtt-10">\gls </span>will try to link to the target
-created with the default definition of <span
-class="cmtt-10">\gloslinkprefix</span>. This isn&#8217;t a problem if you
-want a primary glossary of all terms produced using just <span
-class="cmtt-10">\printunsrtglossary </span>(in
-the front or back matter) which can be the target for all glossary references and then
-just use <span
-class="cmtt-10">\printunsrtglossaryunit </span>for a quick summary at the start of a section
-etc.
-</p><!--l. 14312--><p class="noindent" >
-</p>
-<!--l. 14312--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">11.3 </span> <a
- id="sec:printunsrtinner"></a>Partial Glossaries</h3>
-<!--l. 14315--><p class="noindent" >It&#8217;s possible that you may require greater customisation over the way the glossary is
-displayed that can&#8217;t be simply achieved with the hooks or glossary styles. This
-section describes a command and environment provided to assist with this, but note
-that they aren&#8217;t compatible with tabular-like glossary styles, such as <span
-class="cmss-10">long</span><a
- id="dx1-90001"></a> or <span
-class="cmss-10">super</span><a
- id="dx1-90002"></a>,
-due to their complexity and internal scoping that interferes with alignment.
-You will also need to take care with list styles (provided in the <span
-class="cmss-10">glossary-list</span><a
- id="dx1-90003"></a>
-package).
-</p><!--l. 14325--><p class="indent" > To get a better understanding of how this works, it&#8217;s useful to consider how a
-glossary with <a
- id="dx1-90004"></a><a
-href="#glo:makeindex"><span
-class="cmtt-10">makeindex</span></a> works. Here&#8217;s a simple example document:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-327">
-\documentclass{article}
-\usepackage{glossaries}
-\makeglossaries
-\newglossaryentry{cabbage}{name={cabbage},
-&#x00A0;description={vegetable&#x00A0;with&#x00A0;thick&#x00A0;green&#x00A0;or&#x00A0;purple&#x00A0;leaves}}
-\newglossaryentry{broccoli}{name={broccoli},
-&#x00A0;description={vegetable&#x00A0;with&#x00A0;heads&#x00A0;of&#x00A0;small&#x00A0;green&#x00A0;or&#x00A0;purple&#x00A0;flower&#x00A0;buds}}
-\begin{document}
-\Gls{cabbage}&#x00A0;and&#x00A0;\gls{broccoli}.
-\printglossary
-\end{document}
-</pre>
-<!--l. 14346--><p class="nopar" > When the document is built, <a
- id="dx1-90005"></a><a
-href="#glo:makeindex"><span
-class="cmtt-10">makeindex</span></a> creates a file that contains: </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\glossarysection</span><a
- id="dx1-90006"></a><span
-class="cmtt-10">[\glossarytoctitle</span><a
- id="dx1-90007"></a><span
-class="cmtt-10">]{\glossarytitle</span><a
- id="dx1-90008"></a><span
-class="cmtt-10">}\glossarypreamble</span><a
- id="dx1-90009"></a>
-<br /><span
-class="cmtt-10">\begin{theglossary}\glossaryheader</span><a
- id="dx1-90010"></a>
-<br /><span
-class="cmtt-10">\glsgroupheading</span><a
- id="dx1-90011"></a><span
-class="cmtt-10">{B}\relax</span><span
-class="cmtt-10">&#x00A0;\glsresetentrylist</span><a
- id="dx1-90012"></a>
-<br /><span
-class="cmtt-10">\glossentry</span><a
- id="dx1-90013"></a><span
-class="cmtt-10">{broccoli}{</span>&#x27E8;<span
-class="cmitt-10">location</span><span
-class="cmitt-10">&#x00A0;list</span>&#x27E9;<span
-class="cmtt-10">}\glsgroupskip</span><a
- id="dx1-90014"></a>
-<br /><span
-class="cmtt-10">\glsgroupheading</span><a
- id="dx1-90015"></a><span
-class="cmtt-10">{C}\relax</span><span
-class="cmtt-10">&#x00A0;\glsresetentrylist</span><a
- id="dx1-90016"></a>
-<br /><span
-class="cmtt-10">\glossentry</span><a
- id="dx1-90017"></a><span
-class="cmtt-10">{cabbage}{</span>&#x27E8;<span
-class="cmitt-10">location</span><span
-class="cmitt-10">&#x00A0;list</span>&#x27E9;<span
-class="cmtt-10">}%</span>
-<br /><span
-class="cmtt-10">\end{theglossary}\glossarypostamble</span><a
- id="dx1-90018"></a>
-</div>
-</div> The <span
-class="cmtt-10">\printglossary </span>command defines the commands shown above after it&#8217;s
-detected the glossary type, the title and style. It then inputs the file.
-<!--l. 14362--><p class="indent" > The <span
-class="cmtt-10">\printunsrtglossary </span>command performs the same preliminary setup but
-there&#8217;s no file to input. Instead it then does the section heading (<span
-class="cmtt-10">\glossarysection</span>)
-and preamble (<span
-class="cmtt-10">\glossarypreamble</span>) and constructs a control sequence that contains
-<span
-class="cmtt-10">\begin{theglossary} </span>&#x27E8;<span
-class="cmti-10">content</span>&#x27E9; <span
-class="cmtt-10">\end{theglossary}</span>.
-</p><!--l. 14369--><p class="indent" > The letter group markup (<span
-class="cmtt-10">\glsgroupheading </span>and <span
-class="cmtt-10">\glsgroupskip</span>) is inserted
-whenever the group label changes between top-level entries. In this case, &#x27E8;<span
-class="cmti-10">content</span>&#x27E9;
-doesn&#8217;t explicitly contain <span
-class="cmtt-10">\glossentry </span>but uses a handler function instead. For
-example, instead of: </p><div class="alltt">
-
-
-
-<div class="obeylines-v">
-<span
-class="cmtt-10">\glossentry</span><a
- id="dx1-90019"></a><span
-class="cmtt-10">{broccoli}{</span>&#x27E8;<span
-class="cmitt-10">location</span><span
-class="cmitt-10">&#x00A0;list</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div>
-</div> the &#x27E8;<span
-class="cmti-10">content</span>&#x27E9; will contain: <div class="alltt">
-<div class="obeylines-v">
-&#x27E8;<span
-class="cmitt-10">internal</span><span
-class="cmitt-10">&#x00A0;handler</span>&#x27E9;<span
-class="cmtt-10">{broccoli}</span>
-</div>
-</div> This internal handler uses <span
-class="cmtt-10">\printunsrtglossaryhandler</span><a
- id="dx1-90020"></a> to determine the required
-information (location list, hierarchical level) that&#8217;s needed to typeset the entry (using
-<span
-class="cmtt-10">\glossentry </span>or <span
-class="cmtt-10">\subglossentry</span>).
-<!--l. 14387--><p class="indent" > <hr><div title="Definition"><span
-class="cmtt-10">\begin{printunsrtglossarywrap}[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]</span><br
-class="newline" />&#x27E8;<span
-class="cmitt-10">content</span>&#x27E9; <span
-class="cmtt-10">\end{printunsrtglossarywrap} </span></div><hr>
-</p><!--l. 14390--><p class="noindent" >
-The <span
-class="cmss-10">printunsrtglossarywrap</span><a
- id="dx1-90021"></a><a
- id="dx1-90022"></a> environment provides a wrapper in which you can
-place the actual glossary code. The optional argument is the same as for
-<span
-class="cmtt-10">\printunsrtglossary</span>, but note that in this case the <span
-class="cmss-10">type</span><a
- id="dx1-90023"></a> key simply provides the
-glossary title and doesn&#8217;t identify the content.
-</p><!--l. 14397--><p class="indent" > This environment essentially does: </p><div class="alltt">
-<div class="obeylines-v">
-&#x27E8;<span
-class="cmitt-10">initial</span><span
-class="cmitt-10">&#x00A0;setup</span>&#x27E9;
-<br /><span
-class="cmtt-10">\glossarysection</span><a
- id="dx1-90024"></a><span
-class="cmtt-10">[\glossarytoctitle</span><a
- id="dx1-90025"></a><span
-class="cmtt-10">]{\glossarytitle</span><a
- id="dx1-90026"></a><span
-class="cmtt-10">}\glossarypreamble</span><a
- id="dx1-90027"></a>
-<br /><span
-class="cmtt-10">\begin{theglossary}\glossaryheader</span><a
- id="dx1-90028"></a><span
-class="cmtt-10">\glsresetentrylist</span>
-<br />&#x27E8;<span
-class="cmitt-10">content</span>&#x27E9;
-<br /><span
-class="cmtt-10">\end{theglossary}\glossarypreamble</span>
-</div>
-</div> where &#x27E8;<span
-class="cmti-10">initial setup</span>&#x27E9; is much the same code as used by <span
-class="cmtt-10">\printglossary</span>
-and <span
-class="cmtt-10">\printunsrtglossary</span>. Most importantly, &#x27E8;<span
-class="cmti-10">initial setup</span>&#x27E9; sets the current
-glossary style, which determines the definition of <span
-class="cmss-10">theglossary</span><a
- id="dx1-90029"></a><a
- id="dx1-90030"></a>, <span
-class="cmtt-10">\glossentry </span>and
-<span
-class="cmtt-10">\subglossentry</span>.
-<!--l. 14411--><p class="indent" > Whilst it is possible to explicitly use the commands that create letter group
-headings and the handler within &#x27E8;<span
-class="cmti-10">content</span>&#x27E9;, it would be quite laborious and prone to
-error to do so for anything other than a very short list. This can be illustrated with
-the following silly example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-328">
-\begin{printunsrtglossarywrap}[style=indexgroup]%
-\glsgroupheading{W}%
-\gdef\glscurrententrylabel{cabbage}%
-\printunsrtglossaryhandler\glscurrententrylabel
-\glsgroupskip
-\glsgroupheading{Z}%
-\gdef\glscurrententrylabel{broccoli}%
-\printunsrtglossaryhandler\glscurrententrylabel
-\end{printunsrtglossarywrap}
-</pre>
-<!--l. 14426--><p class="nopar" > This trivial example will work with a tabular-like style, such as <span
-class="cmss-10">long</span><a
- id="dx1-90031"></a> (although the
-group headings will be ignored). A more practical example that uses a loop within
-&#x27E8;<span
-class="cmti-10">content</span>&#x27E9; won&#8217;t.
-</p><!--l. 14432--><p class="indent" > <hr><div title="Definition"><span
-class="cmtt-10">\printunsrtinnerglossary</span><a
- id="dx1-90032"></a><span
-class="cmtt-10">[</span>&#x27E8;<span
-class="cmitt-10">options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">pre-code</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">post-code</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 14433--><p class="noindent" >
-This command is provided for use within <span
-class="cmss-10">printunsrtglossarywrap</span><a
- id="dx1-90033"></a><a
- id="dx1-90034"></a>. The optional
-argument &#x27E8;<span
-class="cmti-10">options</span>&#x27E9; is similar to <span
-class="cmtt-10">\printunsrtglossary </span>but the following keys are
-unavailable: <span
-class="cmss-10">title</span><a
- id="dx1-90035"></a>, <span
-class="cmss-10">toctitle</span><a
- id="dx1-90036"></a>, <span
-class="cmss-10">style</span><a
- id="dx1-90037"></a>, <span
-class="cmss-10">numberedsection</span><a
- id="dx1-90038"></a> and <span
-class="cmss-10">label</span><a
- id="dx1-90039"></a>.
-</p><!--l. 14441--><p class="indent" > This will do: </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">&#x00A0;\begingroup</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;</span>&#x27E8;<span
-class="cmitt-10">initial</span><span
-class="cmitt-10">&#x00A0;setup</span>&#x27E9;
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;</span>&#x27E8;<span
-class="cmitt-10">pre-code</span>&#x27E9;
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;</span>&#x27E8;<span
-class="cmitt-10">content</span>&#x27E9;
-<br /><span
-class="cmtt-10">&#x00A0;</span><span
-class="cmtt-10">&#x00A0;</span>&#x27E8;<span
-class="cmitt-10">post-code</span>&#x27E9;
-<br /><span
-class="cmtt-10">&#x00A0;\endgroup</span>
-</div>
-</div> where &#x27E8;<span
-class="cmti-10">initial setup</span>&#x27E9; processes the options and assigns <span
-class="cmtt-10">\currentglossary</span><a
- id="dx1-90040"></a>, &#x27E8;<span
-class="cmti-10">pre-code</span>&#x27E9; is
-some preliminary code and &#x27E8;<span
-class="cmti-10">post-code</span>&#x27E9; is some final code before the end of the scoping.
-The &#x27E8;<span
-class="cmti-10">content</span>&#x27E9; is the sequence of code that <span
-class="cmtt-10">\printunsrtglossary </span>would normally
-insert within the <span
-class="cmss-10">theglossary</span><a
- id="dx1-90041"></a><a
- id="dx1-90042"></a> environment.
-<!--l. 14457--><p class="indent" > For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-329">
-\begin{printunsrtglossarywrap}[style=indexgroup]
-\printunsrtinnerglossary[type=main]{}{}
-\end{printunsrtglossarywrap}
-</pre>
-<!--l. 14462--><p class="nopar" > This produces a result very similar to that obtained with just:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-330">
-\printunsrtglossary[style=indexgroup,type=main]
-</pre>
-<!--l. 14466--><p class="nopar" > The first case is unsuitable for use with a tabular-style. It will also cause a
-problem with a list style when used with <a
- id="dx1-90043"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> (where the inner content
-will be empty on the first LaTeX&#x00A0;run which will cause a missing <span
-class="cmtt-10">\item</span>
-error).
-</p><!--l. 14472--><p class="indent" > This partial glossary command is more useful when you need to apply filtering
-(which can be set up in the &#x27E8;<span
-class="cmti-10">pre-code</span>&#x27E9; argument as in <span
-class="cmtt-10">\printunsrtglossary*</span>) or if
-you have multiple glossaries. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-331">
-\begin{printunsrtglossarywrap}[style=list]
-\item[Animals]
-\printunsrtinnerglossary[type=animal]{}{}
-\item[Vegetables]
-\printunsrtinnerglossary[type=vegetable]{}{}
-\item[Minerals]
-\printunsrtinnerglossary[type=mineral]{}{}
-\end{printunsrtglossarywrap}
-</pre>
-<!--l. 14485--><p class="nopar" > In this case, the <span
-class="cmss-10">list</span><a
- id="dx1-90044"></a> style doesn&#8217;t cause a problem as there will be three instances of
-<span
-class="cmtt-10">\item </span>on the first LaTeX&#x00A0;run.
-</p><!--l. 14489--><p class="indent" > Here&#8217;s another example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-332">
-\begin{printunsrtglossarywrap}[style=indexgroup]
-\glsgroupheading{animal}%
-\printunsrtinnerglossary[type=animal]{}{}
-\glsgroupskip
-\glsgroupheading{vegetable}%
-\printunsrtinnerglossary[type=vegetable]{}{}
-\glsgroupskip
-\glsgroupheading{mineral}%
-\printunsrtinnerglossary[type=mineral]{}{}
-\end{printunsrtglossarywrap}
-</pre>
-<!--l. 14501--><p class="nopar" > Note that in both of the above cases, the inner glossaries have been arranged
-manually (animal, then vegetable and then mineral).
-</p><!--l. 14505--><p class="indent" > It&#8217;s also possible to use <span
-class="cmtt-10">\printunsrtinnerglossary </span>within the handler
-function used by <span
-class="cmtt-10">\printunsrtglossary</span>. The internal scoping within
-<span
-class="cmtt-10">\printunsrtinnerglossary </span>helps to reduce interference.
-</p><!--l. 14510--><p class="indent" > This is a rather more complicated example that requires <a
- id="dx1-90045"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a>. Suppose I have
-a file called <span
-class="cmtt-10">topictitles.bib </span>that contains:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-333">
-@indexplural{animal}
-@indexplural{mineral}
-@indexplural{vegetable}
-</pre>
-<!--l. 14517--><p class="nopar" > And also a file called <span
-class="cmtt-10">topics.bib </span>that contains entries like:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-334">
-@entry{zebra,
-&#x00A0;&#x00A0;name={zebra},
-&#x00A0;&#x00A0;description={striped&#x00A0;African&#x00A0;horse},
-&#x00A0;&#x00A0;category={animal}
+{}<span class="comment">% glossaries-extra-bib2gls.sty not loaded</span>
+</pre> (The use of <a id="wrglossary.13207"></a><a href="#glo:string"><code class="csfmt">\string</code></a> is in case the <code class="code">&lt;</code> character has been made active.) You can provide more than one rule-block per local, to allow for loanwords or foreign words. For example, you could provide <code class="csfmt">\glsxtrWelshIRules</code>, <code class="csfmt">\glsxtrWelshIIRules</code> etc.<p>
+If the rules are for a particular script (independent of language or region) then they can be provided in a file given by <span class="filefmt">glossariesxtr-</span><span class="meta">〈<em class="metainner">script</em>〉</span><span class="filefmt">.ldf</span> instead. For example, the file <span class="filefmt">glossariesxtr-Cyrl.ldf</span> could contain: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.13208"></a><a href="#glo:ProvidesGlossariesExtraLang"><code class="csfmt">\ProvidesGlossariesExtraLang</code></a>{Cyrl}[2018/02/23 v1.0]
+<code class="cmd">\newcommand</code>*{<code class="cmd">\glsxtrGeneralCyrillicIRules</code>}{%
+ <span class="comment">% Cyrillic rules</span>
}
-@entry{broccoli,
-&#x00A0;&#x00A0;name={broccoli},
-&#x00A0;&#x00A0;description={vegetable&#x00A0;with&#x00A0;heads&#x00A0;of&#x00A0;small&#x00A0;green&#x00A0;or&#x00A0;purple&#x00A0;flower&#x00A0;buds},
-&#x00A0;&#x00A0;category={vegetable}
+<code class="cmd">\newcommand</code>*{<code class="cmd">\glsxtrGeneralCyrillicIIRules</code>}{%
+ <span class="comment">% an alternative set of Cyrillic rules</span>
}
-@entry{quartz,
-&#x00A0;&#x00A0;name={quartz},
-&#x00A0;&#x00A0;description={hard&#x00A0;mineral&#x00A0;consisting&#x00A0;of&#x00A0;silica},
-&#x00A0;&#x00A0;category={mineral}
+</pre> Remember that the required document language scripts need to be tracked through the <a id="wrglossary.13209"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> package, in order for these files to be automatically loaded. This essentially means ensuring you load the appropriate language package before <a id="wrglossary.13210"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> is loaded by the base <a id="wrglossary.13211"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package or any other package that uses it. See the <a id="wrglossary.13212"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> documentation for further details.<p>
+Alternatively, if the rules are specific to a subject rather than a region or language, then you can provide a supplementary package. For example, if you have a package called, say, <span class="styfmt">mapsymbols</span> that provides map symbols, then the file <span class="filefmt">mapsymbols.sty</span> might contain: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\ProvidesPackage</code>{mapsymbols}
+<span class="comment">% some package or font loading stuff here to provide</span>
+<span class="comment">% the appropriate symbols</span>
+<code class="cmd">\newcommand</code>{<code class="cmd">\Stadium</code>}{...}
+<code class="cmd">\newcommand</code>{<code class="cmd">\Battlefield</code>}{...}
+<code class="cmd">\newcommand</code>{<code class="cmd">\Harbour</code>}{...}
+<span class="comment">% etc</span>
+
+<span class="comment">% Provide a rule block:</span>
+<code class="cmd">\newcommand</code>{<code class="cmd">\MapSymbolOrder</code>}{%
+ <a id="wrglossary.13213"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> 2694 <span class="comment">% crossed-swords 0x2694</span>
+ <a id="wrglossary.13214"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt; <a id="wrglossary.13215"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> 2693 <span class="comment">% anchor 0x2693</span>
+ <a id="wrglossary.13216"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt; <a id="wrglossary.13217"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a> 26BD <span class="comment">% football 0x26BD</span>
}
-</pre>
-<!--l. 14538--><p class="nopar" > Note that the category labels in the second file match the entry labels in the first
-file.
-</p><!--l. 14542--><p class="indent" > The simplest way of creating a hierarchical glossary from this data is to input
-both files and copy the <span
-class="cmss-10">category</span><a
- id="dx1-90046"></a> field to the <span
-class="cmss-10">parent</span><a
- id="dx1-90047"></a> field:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-335">
-\GlsXtrLoadResources[src={topictitles,topics},
-&#x00A0;replicate-fields={category=parent}]
-</pre>
-<!--l. 14548--><p class="nopar" > The glossary can then simply be displayed with:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-336">
-\printunsrtglossary[style=indexgroup]
-</pre>
-<!--l. 14552--><p class="nopar" > This will now be ordered: animal (followed by animal child entries), mineral
-(followed by mineral child entries), vegetable (followed by vegetable child
-entries).
-</p><!--l. 14557--><p class="indent" > Suppose (for some strange reason) that I now need the ordering to be vegetable,
-mineral, animal (that is, reverse alphabetical) but the child entries still need to be in
-the normal alphabetical order.
-</p><!--l. 14561--><p class="indent" > It&#8217;s not possible to use different sort methods for different hierarchical levels with
-<a
- id="dx1-90048"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a>, but it is possible to simulate it.
-</p><!--l. 14565--><p class="indent" > Instead of making the entries within <span
-class="cmtt-10">topics.bib </span>children of the entries defined
-in <span
-class="cmtt-10">topictitles.bib</span>, I&#8217;m now going to create separate glossaries for each
-type:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-337">
-\newignoredglossary*{animal}
-\newignoredglossary*{mineral}
-\newignoredglossary*{vegetable}
-</pre>
-<!--l. 14572--><p class="nopar" > The entries in <span
-class="cmtt-10">topictitles.bib </span>go in the default main glossary and are sorted in
-reverse:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-338">
-\GlsXtrLoadResources[src=topictitles,type=main,selection=all,
-&#x00A0;sort=en-GB-reverse]
-</pre>
-<!--l. 14578--><p class="nopar" > Note that I&#8217;ve selected all entries in this example. It becomes more complicated with
-the default selection criteria. (See the <span
-class="cmtt-10">sample-nested.tex </span>example provided with
-<a
- id="dx1-90049"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> v2.3+.)
-</p><!--l. 14584--><p class="indent" > Now the entries in <span
-class="cmtt-10">topics.bib </span>are selected but the <span
-class="cmss-10">type</span><a
- id="dx1-90050"></a> field is set to the <span
-class="cmss-10">category</span><a
- id="dx1-90051"></a>
-field:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-339">
-\GlsXtrLoadResources[src=topics,type={same&#x00A0;as&#x00A0;category},selection=all,
-&#x00A0;sort=en-GB]
-</pre>
-<!--l. 14589--><p class="nopar" > The aim here is to use <span
-class="cmtt-10">\printunsrtglossary </span>to list all the entries in the main
-glossary (that is, all the topic titles) and use a handler that tests if there is a glossary
-that has the same label as the current entry label. If one exists, it&#8217;s then listed using
-<span
-class="cmtt-10">\printunsrtinnerglossary </span>with the level offset shifted to give a hierarchical
-appearance:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-340">
-\newcommand{\nestedhandler}[1]{%
-&#x00A0;&#x00A0;\glsxtrunsrtdo{#1}%
-&#x00A0;&#x00A0;\ifglossaryexists*{#1}%
-&#x00A0;&#x00A0;{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\printunsrtinnerglossary[type={#1},leveloffset=++1]{}{}%
-&#x00A0;&#x00A0;}%
-&#x00A0;&#x00A0;{}%
+</pre> and the supplementary file <span class="filefmt">mapsymbols.bib</span> can provide the appropriate definitions for <a id="wrglossary.13218"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="code">@preamble</code>{"<a id="wrglossary.13219"></a><a href="#glo:glsxtrprovidecommand"><code class="csfmt">\glsxtrprovidecommand</code></a>{<code class="cmd">\Harbour</code>}{<code class="cmd">\char</code>"2693}
+<a id="wrglossary.13220"></a><a href="#glo:glsxtrprovidecommand"><code class="csfmt">\glsxtrprovidecommand</code></a>{<code class="cmd">\Battlefield</code>}{<code class="cmd">\char</code>"2694}
+<a id="wrglossary.13221"></a><a href="#glo:glsxtrprovidecommand"><code class="csfmt">\glsxtrprovidecommand</code></a>{<code class="cmd">\Stadium</code>}{<code class="cmd">\char</code>"26BD}"}
+</pre> Now both the preamble and rule block can be used in the resource set: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>{mapsymbols}<span class="comment">% my custom package</span>
+<code class="cmd">\usepackage</code>[<a id="wrglossary.13222"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>]{glossaries-extra}
+
+<a id="wrglossary.13223"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[
+ <a id="wrglossary.13224"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">={mapsymbols,<span class="comment">% &lt;--- <span style="font-weight: bold; ">my custom mapsymbols.bib</span></span> entries<span class="comment">% data in entries.bib</span> }</span>,
+ <a id="wrglossary.13225"></a><a href="#glo:opt.resource.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=custom</span>,
+ <a id="wrglossary.13226"></a><a href="#glo:opt.resource.sort-rule"><span class="csoptfmt">sort-rule</span></a><span class="optfmt">={<a id="wrglossary.13227"></a><a href="#glo:glsxtrcontrolrules"><code class="csfmt">\glsxtrcontrolrules</code></a> <span class="comment">% control codes</span> ;<a id="wrglossary.13228"></a><a href="#glo:glsxtrspacerules"><code class="csfmt">\glsxtrspacerules</code></a> <span class="comment">% space characters</span> ;<a id="wrglossary.13229"></a><a href="#glo:glsxtrnonprintablerules"><code class="csfmt">\glsxtrnonprintablerules</code></a> <span class="comment">% non-printable characters</span> ;<a id="wrglossary.13230"></a><a href="#glo:glsxtrcombiningdiacriticrules"><code class="csfmt">\glsxtrcombiningdiacriticrules</code></a> <span class="comment">% combining diacritics</span> ,<a id="wrglossary.13231"></a><a href="#glo:glsxtrhyphenrules"><code class="csfmt">\glsxtrhyphenrules</code></a> <span class="comment">% hyphens</span> &lt;<a id="wrglossary.13232"></a><a href="#glo:glsxtrgeneralpuncrules"><code class="csfmt">\glsxtrgeneralpuncrules</code></a> <span class="comment">% general punctuation</span> &lt;<a id="wrglossary.13233"></a><a href="#glo:glsxtrdigitrules"><code class="csfmt">\glsxtrdigitrules</code></a> <span class="comment">% 0, ..., 9</span> &lt;<a id="wrglossary.13234"></a><a href="#glo:glsxtrfractionrules"><code class="csfmt">\glsxtrfractionrules</code></a> <span class="comment">% fraction symbols</span> &lt;<code class="cmd">\MapSymbolOrder</code> <span class="comment">% &lt;--- <span style="font-weight: bold; ">custom map symbols</span></span> &lt;<a id="wrglossary.13235"></a><a href="#glo:glsxtrMathItalicGreekIrules"><code class="csfmt">\glsxtrMathItalicGreekIrules</code></a> <span class="comment">% math-greek symbols</span> &lt;<a id="wrglossary.13236"></a><a href="#glo:glsxtrGeneralLatinIrules"><code class="csfmt">\glsxtrGeneralLatinIrules</code></a> <span class="comment">% Latin letters</span> }</span>
+]
+</pre> (As before, you may need to use <a id="wrglossary.13237"></a><a href="#glo:string"><code class="csfmt">\string</code></a> in front of characters like <code class="code">&lt;</code> if they have been made active.)<p>
+The following commands are provided by <a id="wrglossary.13238"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a>. They should be separated by the rule separator characters <code class="code">;</code> (semi-colon) or <code class="code">,</code> (comma) or & (ampersand) or <code class="code">&lt;</code> (less than). See Java’s <a href="http://docs.oracle.com/javase/8/docs/api/java/text/RuleBasedCollator.html">RuleBasedCollator</a> documentation for details of the rule syntax.<p>
+For example, the following will place the mathematical Greek symbols (<a id="wrglossary.13239"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>, <a id="wrglossary.13240"></a><a href="#glo:Alpha"><code class="csfmt">\Alpha</code></a>, <a id="wrglossary.13241"></a><a href="#glo:beta"><code class="csfmt">\beta</code></a>, <a id="wrglossary.13242"></a><a href="#glo:Beta"><code class="csfmt">\Beta</code></a> etc) in a block before Latin characters: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.13243"></a><a href="#glo:opt.resource.sort-rule"><span class="csoptfmt">sort-rule</span></a><span class="optfmt">={<a id="wrglossary.13244"></a><a href="#glo:glsxtrcontrolrules"><code class="csfmt">\glsxtrcontrolrules</code></a> ;<a id="wrglossary.13245"></a><a href="#glo:glsxtrspacerules"><code class="csfmt">\glsxtrspacerules</code></a> ;<a id="wrglossary.13246"></a><a href="#glo:glsxtrnonprintablerules"><code class="csfmt">\glsxtrnonprintablerules</code></a> ;<a id="wrglossary.13247"></a><a href="#glo:glsxtrcombiningdiacriticrules"><code class="csfmt">\glsxtrcombiningdiacriticrules</code></a> ,<a id="wrglossary.13248"></a><a href="#glo:glsxtrhyphenrules"><code class="csfmt">\glsxtrhyphenrules</code></a> &lt;<a id="wrglossary.13249"></a><a href="#glo:glsxtrgeneralpuncrules"><code class="csfmt">\glsxtrgeneralpuncrules</code></a> &lt;<a id="wrglossary.13250"></a><a href="#glo:glsxtrdigitrules"><code class="csfmt">\glsxtrdigitrules</code></a> &lt;<a id="wrglossary.13251"></a><a href="#glo:glsxtrfractionrules"><code class="csfmt">\glsxtrfractionrules</code></a> &lt;<a id="wrglossary.13252"></a><a href="#glo:glsxtrMathItalicGreekIrules"><code class="csfmt">\glsxtrMathItalicGreekIrules</code></a> &lt;<a id="wrglossary.13253"></a><a href="#glo:glsxtrGeneralLatinIVrules"><code class="csfmt">\glsxtrGeneralLatinIVrules</code></a> &lt;<a id="wrglossary.13254"></a><a href="#glo:glsxtrLatinAA"><code class="csfmt">\glsxtrLatinAA</code></a> &lt;<a id="wrglossary.13255"></a><a href="#glo:glsxtrLatinOslash"><code class="csfmt">\glsxtrLatinOslash</code></a> }</span>
+</pre><p>
+
+</section><!-- end of section sec:customsort -->
+
+<section id="sec:bib2glscustomsortnonletters"><!-- start of section sec:bib2glscustomsortnonletters --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->11.5.2.1.1. Non-Letters<div class="labellink"><a href="#sec:bib2glscustomsortnonletters">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13256"></a><code class="code"><dfn id="glo:glsxtrcontrolrules"><code class="csfmt">\glsxtrcontrolrules</code></dfn></code></div><!-- end of pinnedbox -->
+ These are control characters that are usually placed at the start of a rule in the ignored section. They typically won’t occur in any sort values, but if they do they should normally be ignored.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13257"></a><code class="code"><dfn id="glo:glsxtrspacerules"><code class="csfmt">\glsxtrspacerules</code></dfn></code></div><!-- end of pinnedbox -->
+ These are space characters. They typically come after the control characters with the two blocks separated by a <code class="code">;</code> (semi-colon).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13258"></a><code class="code"><dfn id="glo:glsxtrnonprintablerules"><code class="csfmt">\glsxtrnonprintablerules</code></dfn></code></div><!-- end of pinnedbox -->
+ These are non-printable characters (BOM, tabs, line feed and carriage return). They typically come after the spaces separated by a <code class="code">;</code> (semi-colon). These characters aren’t checked for by <a id="wrglossary.13259"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> when it determines whether or not to use the interpreter, so a TAB or newline character may end up in the sort value if it wasn’t interpreted.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13260"></a><code class="code"><dfn id="glo:glsxtrcombiningdiacriticrules"><code class="csfmt">\glsxtrcombiningdiacriticrules</code></dfn></code></div><!-- end of pinnedbox -->
+ These are combining diacritic marks which typically follow the space and non-printable blocks (separated by a semi-colon). This command is defined in terms of sub-block commands: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.13261"></a><a href="#glo:glsxtrcombiningdiacriticrules"><code class="csfmt">\glsxtrcombiningdiacriticrules</code></a>}{%
+ <a id="wrglossary.13262"></a><a href="#glo:glsxtrcombiningdiacriticIrules"><code class="csfmt">\glsxtrcombiningdiacriticIrules</code></a><a id="wrglossary.13263"></a><a href="#glo:string"><code class="csfmt">\string</code></a>;
+ <a id="wrglossary.13264"></a><a href="#glo:glsxtrcombiningdiacriticIIrules"><code class="csfmt">\glsxtrcombiningdiacriticIIrules</code></a><a id="wrglossary.13265"></a><a href="#glo:string"><code class="csfmt">\string</code></a>;
+ <a id="wrglossary.13266"></a><a href="#glo:glsxtrcombiningdiacriticIIIrules"><code class="csfmt">\glsxtrcombiningdiacriticIIIrules</code></a><a id="wrglossary.13267"></a><a href="#glo:string"><code class="csfmt">\string</code></a>;
+ <a id="wrglossary.13268"></a><a href="#glo:glsxtrcombiningdiacriticIVrules"><code class="csfmt">\glsxtrcombiningdiacriticIVrules</code></a>
}
-\printunsrtglossary*[type=main,style=index]{%
-&#x00A0;&#x00A0;\let\printunsrtglossaryhandler\nestedhandler
+</pre> If you prefer, you can use the sub-blocks directly in your required ordered.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13269"></a><code class="code"><dfn id="glo:glsxtrcombiningdiacriticIrules"><code class="csfmt">\glsxtrcombiningdiacriticIrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This contains the combining diacritics: acute, grave, breve, circumflex, caron, ring, vertical line above, diaeresis (umlaut), double acute, tilde, dot above, combining macron.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13270"></a><code class="code"><dfn id="glo:glsxtrcombiningdiacriticIIrules"><code class="csfmt">\glsxtrcombiningdiacriticIIrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This contains the combining diacritics: short solidus overlay, cedilla, ogonek, dot below, low line, overline, hook above, double vertical line above, double grave accent, candrabindu, inverted breve, turned comma above, comma above, reversed comma above, comma above right, grave accent below, acute accent below.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13271"></a><code class="code"><dfn id="glo:glsxtrcombiningdiacriticIIIrules"><code class="csfmt">\glsxtrcombiningdiacriticIIIrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This contains the combining diacritics: left tack below, right tack below, left angle above, horn, left half ring below, up tack below, down tack below, plus sign below, minus sign below, palatalized hook below, retroflex hook below, diaresis below, ring below, comma below, vertical line below, bridge below, inverted double arch below, caron below, circumflex accent below, breve below, inverted breve below, tilde below, macron below, double low line, tilde overlay, short stroke overlay, long stroke overlay, long solidus overlay, right half ring below, inverted bridge below, square below, seagull below, x above, vertical tilde, double overline, Greek perispomeni, Greek dialytika tonos, Greek ypogegrammeni, double tilde, double inverted breve, Cyrillic titlo, Cyrillic palatalization, Cyrillic dasia pneumata, Cyrillic psili pneumata.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13272"></a><code class="code"><dfn id="glo:glsxtrcombiningdiacriticIVrules"><code class="csfmt">\glsxtrcombiningdiacriticIVrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This contains the combining diacritics: left harpoon above, right harpoon above, long vertical line overlay, short vertical line overlay, anticlockwise arrow above, clockwise arrow above, left arrow above, right arrow above, ring overlay, clockwise ring overlay, anticlockwise ring overlay, three dots above, four dots above, enclosing circle, enclosing square, enclosing diamond, enclosing circle backslash, left right arrow above.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13273"></a><code class="code"><dfn id="glo:glsxtrhyphenrules"><code class="csfmt">\glsxtrhyphenrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This contains hyphens (including the minus sign 0x2212). This rule block typically comes after the diacritic rules separated by a comma.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13274"></a><code class="code"><dfn id="glo:glsxtrgeneralpuncrules"><code class="csfmt">\glsxtrgeneralpuncrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This contains punctuation characters. This rule block typically comes after the hyphen rules separated by a less than (<code class="code">&lt;</code>). As with the combining diacritics, this command is defined in terms of sub-blocks which may be used directly instead if a different order is required: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<a id="wrglossary.13275"></a><a href="#glo:glsxtrgeneralpuncrules"><code class="csfmt">\glsxtrgeneralpuncrules</code></a>}{%
+ <a id="wrglossary.13276"></a><a href="#glo:glsxtrgeneralpuncIrules"><code class="csfmt">\glsxtrgeneralpuncIrules</code></a>
+ <a id="wrglossary.13277"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;<a id="wrglossary.13278"></a><a href="#glo:glsxtrcurrencyrules"><code class="csfmt">\glsxtrcurrencyrules</code></a>
+ <a id="wrglossary.13279"></a><a href="#glo:string"><code class="csfmt">\string</code></a>&lt;<a id="wrglossary.13280"></a><a href="#glo:glsxtrgeneralpuncIIrules"><code class="csfmt">\glsxtrgeneralpuncIIrules</code></a>
}
-</pre>
-<!--l. 14609--><p class="nopar" >
-</p><!--l. 14611--><p class="indent" > I&#8217;ve used <span
-class="cmtt-10">\newignoredglossary* </span>as I don&#8217;t need to specify a title for any of those
-glossaries nor do I need to use those glossaries with <span
-class="cmtt-10">\printunsrtglossaries</span>. With
-<a
- id="dx1-90052"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a> v2.3+, I can omit the three <span
-class="cmtt-10">\newignoredglossary* </span>lines and use the
-<span
-class="cmtt-10">--provide-glossaries </span>switch which will make <a
- id="dx1-90053"></a><span
-class="cmtt-10">bib2gls </span>automatically provide
-any unknown glossaries (with <span
-class="cmtt-10">\provideignoredglossary</span>) in the <span
-class="cmtt-10">.glstex</span>
-file.
-</p><!--l. 14619--><p class="noindent" >
-</p>
-<!--l. 14619--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">11.4 </span> <a
- id="sec:glossentry"></a>Standalone Entry Items</h3>
-<!--l. 14622--><p class="noindent" >It may be that you don&#8217;t want a list but would rather display entry details
-throughout the document. You can simply do <span
-class="cmtt-10">\glsentryname </span>followed by
-<span
-class="cmtt-10">\glsentrydesc</span>. (Remember that if you don&#8217;t want a sorted list, use <a
-href="#styopt.sort"><span
-class="cmss-10">sort</span></a><span
-class="cmss-10">=none</span><a
- id="dx1-91001"></a> to
-skip the construction of the <span
-class="cmss-10">sort</span><a
- id="dx1-91002"></a> field.) For example, in the preamble provide a
-custom command:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-341">
-\newcommand{\displayterm}[1]{%
-&#x00A0;\par\medskip\par\noindent
-&#x00A0;Definition:&#x00A0;\glsentryname{#1}.\par
-&#x00A0;\glsentrydesc{#1}
-&#x00A0;\par\medskip
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13281"></a><code class="code"><dfn id="glo:glsxtrgeneralpuncIrules"><code class="csfmt">\glsxtrgeneralpuncIrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This is defined as: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.13282"></a><a href="#glo:glsxtrgeneralpuncIrules"><code class="csfmt">\glsxtrgeneralpuncIrules</code></a>}{<span class="comment">% </span>
+ <a id="wrglossary.13283"></a><a href="#glo:glsxtrgeneralpuncmarksrules"><code class="csfmt">\glsxtrgeneralpuncmarksrules</code></a>
+ <code class="cmd">\string</code>&lt;<a id="wrglossary.13284"></a><a href="#glo:glsxtrgeneralpuncaccentsrules"><code class="csfmt">\glsxtrgeneralpuncaccentsrules</code></a>
+ <code class="cmd">\string</code>&lt;<a id="wrglossary.13285"></a><a href="#glo:glsxtrgeneralpuncquoterules"><code class="csfmt">\glsxtrgeneralpuncquoterules</code></a>
+ <code class="cmd">\string</code>&lt;<a id="wrglossary.13286"></a><a href="#glo:glsxtrgeneralpuncbracketrules"><code class="csfmt">\glsxtrgeneralpuncbracketrules</code></a>
+ <code class="cmd">\string</code>&lt;<a id="wrglossary.13287"></a><a href="#glo:glsxtrgeneralpuncsignrules"><code class="csfmt">\glsxtrgeneralpuncsignrules</code></a>
}
-</pre>
-<!--l. 14636--><p class="nopar" > define your entries
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-342">
-\newglossaryentry{function}{name={function},
-&#x00A0;&#x00A0;description={a&#x00A0;relation&#x00A0;or&#x00A0;expression&#x00A0;involving&#x00A0;variables}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13288"></a><code class="code"><dfn id="glo:glsxtrgeneralpuncmarksrules"><code class="csfmt">\glsxtrgeneralpuncmarksrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This contains: underscore, macron, comma, semi-colon, colon, exclamation mark, inverted exclamation mark, question mark, inverted question mark, solidus, <a id="wrglossary.13289"></a><a href="#glo:idx.fullstop">full stop</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13290"></a><code class="code"><dfn id="glo:glsxtrgeneralpuncaccentsrules"><code class="csfmt">\glsxtrgeneralpuncaccentsrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This contains: acute accent, grave accent, circumflex accent, diaeresis, tilde, middle dot, cedilla.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13291"></a><code class="code"><dfn id="glo:glsxtrgeneralpuncquoterules"><code class="csfmt">\glsxtrgeneralpuncquoterules</code></dfn></code></div><!-- end of pinnedbox -->
+ This contains: straight apostrophe, straight double quote, left guillemet, right guillemet.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13292"></a><code class="code"><dfn id="glo:glsxtrgeneralpuncbracketrules"><code class="csfmt">\glsxtrgeneralpuncbracketrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This contains: left parenthesis, right parenthesis, left square bracket, right square bracket, left curly bracket, right curly bracket.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13293"></a><code class="code"><dfn id="glo:glsxtrgeneralpuncsignrules"><code class="csfmt">\glsxtrgeneralpuncsignrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This contains: section sign, pilcrow sign, copyright sign, registered sign, at sign.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13294"></a><code class="code"><dfn id="glo:glsxtrcurrencyrules"><code class="csfmt">\glsxtrcurrencyrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This sub-block contains some currency symbols: currency sign, Thai currency symbol baht, cent sign, colon sign, cruzeiro sign, dollar sign, dong sign, euro sign, French franc sign, lira sign, mill sign, naira sign, peseta sign, pound sign, rupee sign, new sheqel sign, won sign, yen sign.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13295"></a><code class="code"><dfn id="glo:glsxtrgeneralpuncIIrules"><code class="csfmt">\glsxtrgeneralpuncIIrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This sub-block contains some other punctuation symbols: asterisk, backslash, ampersand, hash sign, percent sign, plus sign, plus-minus sign, division sign, multiplication sign, less-than sign, equals sign, greater-than sign, not sign, vertical bar (pipe), broken bar, degree sign, micron sign.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13296"></a><code class="code"><dfn id="glo:glsxtrdigitrules"><code class="csfmt">\glsxtrdigitrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This rule block contains the Basic Latin digits (0, …, 9) and the subscript and superscript digits (₀ ⁰ etc) made equivalent to the corresponding Basic Latin digit. The digit block typically comes after the punctuation rules separated by a less than (<code class="code">&lt;</code>).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13297"></a><code class="code"><dfn id="glo:glsxtrBasicDigitrules"><code class="csfmt">\glsxtrBasicDigitrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This rule block contains just the Basic Latin digits (0, …, 9).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13298"></a><code class="code"><dfn id="glo:glsxtrSubScriptDigitrules"><code class="csfmt">\glsxtrSubScriptDigitrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This rule block contains just the subscript digits (₀ … ₉).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13299"></a><code class="code"><dfn id="glo:glsxtrSuperScriptDigitrules"><code class="csfmt">\glsxtrSuperScriptDigitrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This rule block contains just the superscript digits (⁰ … ⁹).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13300"></a><code class="code"><dfn id="glo:glsxtrfractionrules"><code class="csfmt">\glsxtrfractionrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This rule block contains vulgar fraction characters from the Unicode Number Forms block. The digit block typically comes after the digit rules separated by a less than (<code class="code">&lt;</code>).<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13301"></a><code class="code"><dfn id="glo:glsxtrIgnorableRules"><code class="csfmt">\glsxtrIgnorableRules</code></dfn></code></div><!-- end of pinnedbox -->
+ A shortcut that expands to the ignorable rules: <pre class="compactcodebox"><a id="wrglossary.13302"></a><a href="#glo:glsxtrcontrolrules"><code class="csfmt">\glsxtrcontrolrules</code></a>
+ ;<a id="wrglossary.13303"></a><a href="#glo:glsxtrspacerules"><code class="csfmt">\glsxtrspacerules</code></a>
+ ;<a id="wrglossary.13304"></a><a href="#glo:glsxtrnonprintablerules"><code class="csfmt">\glsxtrnonprintablerules</code></a>
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13305"></a><code class="code"><dfn id="glo:glsxtrGeneralInitRules"><code class="csfmt">\glsxtrGeneralInitRules</code></dfn></code></div><!-- end of pinnedbox -->
+ A shortcut that expands to common initial rules: <pre class="compactcodebox"><a id="wrglossary.13306"></a><a href="#glo:glsxtrIgnorableRules"><code class="csfmt">\glsxtrIgnorableRules</code></a>
+ ;<a id="wrglossary.13307"></a><a href="#glo:glsxtrcombiningdiacriticrules"><code class="csfmt">\glsxtrcombiningdiacriticrules</code></a>
+ ;<a id="wrglossary.13308"></a><a href="#glo:glsxtrhyphenrules"><code class="csfmt">\glsxtrhyphenrules</code></a>
+ &lt;<a id="wrglossary.13309"></a><a href="#glo:glsxtrgeneralpuncrules"><code class="csfmt">\glsxtrgeneralpuncrules</code></a>
+ &lt;<a id="wrglossary.13310"></a><a href="#glo:glsxtrdigitrules"><code class="csfmt">\glsxtrdigitrules</code></a>
+ &lt;<a id="wrglossary.13311"></a><a href="#glo:glsxtrfractionrules"><code class="csfmt">\glsxtrfractionrules</code></a>
+</pre> Note that this includes the combining diacritic rules, which won’t be appropriate for languages with accented characters.<p>
+There are a number of Latin rule blocks. Some of these included extended characters or ligatures (such as ß or œ) but they don’t include accented characters. If you require a Latin rule block that includes accented characters, digraphs, trigraphs or other extended characters, then it’s best to provide similar commands in a <span class="filefmt">glossariesxtr-</span><span class="meta">〈<em class="metainner">tag</em>〉</span><span class="filefmt">.ldf</span> file for the particular language or region.<p>
+
+</section><!-- end of section sec:bib2glscustomsortnonletters -->
+
+<section id="sec:bib2glscustomsortlatin"><!-- start of section sec:bib2glscustomsortlatin --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->11.5.2.1.2. Latin Letters<div class="labellink"><a href="#sec:bib2glscustomsortlatin">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13312"></a><code class="code"><dfn id="glo:glsxtrGeneralLatinIrules"><code class="csfmt">\glsxtrGeneralLatinIrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This is just the basic (non-extended) Latin alphabet with the superscript and subscript Latin letters (ª ₐ etc) treated as the equivalent basic Latin letter. (If you don’t want the subscripts and superscripts included you can redefine <a id="wrglossary.13313"></a><a href="#glo:glsxtrLatinA"><code class="csfmt">\glsxtrLatinA</code></a> etc to omit them.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13314"></a><code class="code"><dfn id="glo:glsxtrGeneralLatinIIrules"><code class="csfmt">\glsxtrGeneralLatinIIrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.13315"></a><a href="#glo:glsxtrGeneralLatinIrules"><code class="csfmt">\glsxtrGeneralLatinIrules</code></a> but it includes eth (Ð) between <span class="qt">“D”</span> and <span class="qt">“E”</span> and eszett (ß) treated as <span class="qt">“ss”</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13316"></a><code class="code"><dfn id="glo:glsxtrGeneralLatinIIIrules"><code class="csfmt">\glsxtrGeneralLatinIIIrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.13317"></a><a href="#glo:glsxtrGeneralLatinIrules"><code class="csfmt">\glsxtrGeneralLatinIrules</code></a> but it includes eth (Ð) between <span class="qt">“D”</span> and <span class="qt">“E”</span> and eszett (ß) treated as <span class="qt">“sz”</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13318"></a><code class="code"><dfn id="glo:glsxtrGeneralLatinIVrules"><code class="csfmt">\glsxtrGeneralLatinIVrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.13319"></a><a href="#glo:glsxtrGeneralLatinIrules"><code class="csfmt">\glsxtrGeneralLatinIrules</code></a> but it includes eth (Ð) between <span class="qt">“D”</span> and <span class="qt">“E”</span>, ae-ligature (æ) is treated as <span class="qt">“ae”</span>, oe-ligature (œ) is treated as <span class="qt">“oe”</span>, eszett (ß) treated as <span class="qt">“ss”</span> and thorn (þ) is treated as <span class="qt">“th”</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13320"></a><code class="code"><dfn id="glo:glsxtrGeneralLatinVrules"><code class="csfmt">\glsxtrGeneralLatinVrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.13321"></a><a href="#glo:glsxtrGeneralLatinIrules"><code class="csfmt">\glsxtrGeneralLatinIrules</code></a> but it includes eth (Ð) between <span class="qt">“D”</span> and <span class="qt">“E”</span>, eszett (ß) treated as <span class="qt">“ss”</span> and thorn (þ) treated as <span class="qt">“th”</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13322"></a><code class="code"><dfn id="glo:glsxtrGeneralLatinVIrules"><code class="csfmt">\glsxtrGeneralLatinVIrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.13323"></a><a href="#glo:glsxtrGeneralLatinIrules"><code class="csfmt">\glsxtrGeneralLatinIrules</code></a> but it includes eth (Ð) between <span class="qt">“D”</span> and <span class="qt">“E”</span>, eszett (ß) treated as <span class="qt">“sz”</span> and thorn (þ) treated as <span class="qt">“th”</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13324"></a><code class="code"><dfn id="glo:glsxtrGeneralLatinVIIrules"><code class="csfmt">\glsxtrGeneralLatinVIIrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.13325"></a><a href="#glo:glsxtrGeneralLatinIrules"><code class="csfmt">\glsxtrGeneralLatinIrules</code></a> but it includes ae-ligature (æ) between <span class="qt">“A”</span> and <span class="qt">“B”</span>, eth (Ð) between <span class="qt">“D”</span> and <span class="qt">“E”</span>, insular G (ᵹ) instead of <span class="qt">“G”</span>, oe-ligature (œ) between <span class="qt">“O”</span> and <span class="qt">“P”</span>, long s (ſ) equivalent to <span class="qt">“s”</span>, thorn (þ) between <span class="qt">“T”</span> and <span class="qt">“U”</span> and wynn (ƿ) instead of <span class="qt">“W”</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13326"></a><code class="code"><dfn id="glo:glsxtrGeneralLatinVIIIrules"><code class="csfmt">\glsxtrGeneralLatinVIIIrules</code></dfn></code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.13327"></a><a href="#glo:glsxtrGeneralLatinIrules"><code class="csfmt">\glsxtrGeneralLatinIrules</code></a> but ae-ligature (æ) is treated as <span class="qt">“ae”</span>, oe-ligature (œ) is treated as <span class="qt">“oe”</span>, eszett (ß) treated as <span class="qt">“ss”</span>, thorn (þ) is treated as <span class="qt">“th”</span>, Ø is treated as <span class="qt">“O”</span> and <span class="qt">“Ł”</span> is treated as <span class="qt">“L”</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13328"></a><code class="code"><dfn id="glo:glsxtrGeneralLatinAtoMrules"><code class="csfmt">\glsxtrGeneralLatinAtoMrules</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule subset of General Latin I rules that just covers A–M.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13329"></a><code class="code"><dfn id="glo:glsxtrGeneralLatinNtoZrules"><code class="csfmt">\glsxtrGeneralLatinNtoZrules</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule subset of General Latin I rules that just covers N–Z.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13330"></a><code class="code"><dfn id="glo:glsxtrGeneralLatinAtoGrules"><code class="csfmt">\glsxtrGeneralLatinAtoGrules</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule subset of General Latin I rules that just covers A–G.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13331"></a><code class="code"><dfn id="glo:glsxtrGeneralLatinHtoMrules"><code class="csfmt">\glsxtrGeneralLatinHtoMrules</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule subset of General Latin I rules that just covers H–M.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13332"></a><code class="code"><dfn id="glo:glsxtrGeneralLatinNtoSrules"><code class="csfmt">\glsxtrGeneralLatinNtoSrules</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule subset of General Latin I rules that just covers N–S.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13333"></a><code class="code"><dfn id="glo:glsxtrGeneralLatinTtoZrules"><code class="csfmt">\glsxtrGeneralLatinTtoZrules</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule subset of General Latin I rules that just covers T–Z.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13334"></a><code class="code"><dfn id="glo:glsxtrLatinA"><code class="csfmt">\glsxtrLatinA</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule that just covers <span class="qt">“A”</span> but includes the sub- and superscript A.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13335"></a><code class="code"><dfn id="glo:glsxtrLatinE"><code class="csfmt">\glsxtrLatinE</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule that just covers <span class="qt">“E”</span> but includes the subscript E.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13336"></a><code class="code"><dfn id="glo:glsxtrLatinH"><code class="csfmt">\glsxtrLatinH</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule that just covers <span class="qt">“H”</span> but includes the subscript H.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13337"></a><code class="code"><dfn id="glo:glsxtrLatinK"><code class="csfmt">\glsxtrLatinK</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule that just covers <span class="qt">“K”</span> but includes the subscript K.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13338"></a><code class="code"><dfn id="glo:glsxtrLatinI"><code class="csfmt">\glsxtrLatinI</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule that just covers <span class="qt">“I”</span> but includes the subscript I.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13339"></a><code class="code"><dfn id="glo:glsxtrLatinM"><code class="csfmt">\glsxtrLatinM</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule that just covers <span class="qt">“M”</span> but includes the subscript M.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13340"></a><code class="code"><dfn id="glo:glsxtrLatinN"><code class="csfmt">\glsxtrLatinN</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule that just covers <span class="qt">“N”</span> but includes the sub- and superscript N.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13341"></a><code class="code"><dfn id="glo:glsxtrLatinO"><code class="csfmt">\glsxtrLatinO</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule that just covers <span class="qt">“O”</span> but includes the sub- and superscript O.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13342"></a><code class="code"><dfn id="glo:glsxtrLatinP"><code class="csfmt">\glsxtrLatinP</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule that just covers <span class="qt">“P”</span> but includes the subscript P.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13343"></a><code class="code"><dfn id="glo:glsxtrLatinS"><code class="csfmt">\glsxtrLatinS</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule that just covers <span class="qt">“S”</span> but includes the subscript S.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13344"></a><code class="code"><dfn id="glo:glsxtrLatinT"><code class="csfmt">\glsxtrLatinT</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule that just covers <span class="qt">“T”</span> but includes the subscript T.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13345"></a><code class="code"><dfn id="glo:glsxtrLatinX"><code class="csfmt">\glsxtrLatinX</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule that just covers <span class="qt">“X”</span> but includes the subscript X.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13346"></a><code class="code"><dfn id="glo:glsxtrLatinEszettSs"><code class="csfmt">\glsxtrLatinEszettSs</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule that just covers eszett (ß) and makes <span class="qt">“ſs”</span> (long s followed by short s) equivalent to <span class="qt">“ß”</span>. (This is used in the above blocks that treat <span class="qt">“ß”</span> as <span class="qt">“ss”</span>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13347"></a><code class="code"><dfn id="glo:glsxtrLatinEszettSz"><code class="csfmt">\glsxtrLatinEszettSz</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule that just covers eszett (ß) and makes <span class="qt">“ſz”</span> (long s followed by z) equivalent to <span class="qt">“ß”</span>. (This is used in the above blocks that treat <span class="qt">“ß”</span> as <span class="qt">“sz”</span>.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13348"></a><code class="code"><dfn id="glo:glsxtrLatinEth"><code class="csfmt">\glsxtrLatinEth</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule for eth (Ð, ð) so you don’t need to remember the Unicode values.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13349"></a><code class="code"><dfn id="glo:glsxtrLatinThorn"><code class="csfmt">\glsxtrLatinThorn</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule for thorn (Þ, þ) so you don’t need to remember the Unicode values.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13350"></a><code class="code"><dfn id="glo:glsxtrLatinAELigature"><code class="csfmt">\glsxtrLatinAELigature</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule for ae-ligature (Æ, æ) so you don’t need to remember the Unicode values.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13351"></a><code class="code"><dfn id="glo:glsxtrLatinOELigature"><code class="csfmt">\glsxtrLatinOELigature</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule for oe-ligature (Œ, œ) so you don’t need to remember the Unicode values.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13352"></a><code class="code"><dfn id="glo:glsxtrLatinOslash"><code class="csfmt">\glsxtrLatinOslash</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule for o-slash (Ø, ø) so you don’t need to remember the Unicode values.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13353"></a><code class="code"><dfn id="glo:glsxtrLatinLslash"><code class="csfmt">\glsxtrLatinLslash</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule for l-slash (Ł, ł) so you don’t need to remember the Unicode values.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13354"></a><code class="code"><dfn id="glo:glsxtrLatinWynn"><code class="csfmt">\glsxtrLatinWynn</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule for wynn (Ƿ, ƿ) so you don’t need to remember the Unicode values.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13355"></a><code class="code"><dfn id="glo:glsxtrLatinInsularG"><code class="csfmt">\glsxtrLatinInsularG</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule for insular-G (Ᵹ, ᵹ) so you don’t need to remember the Unicode values.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13356"></a><code class="code"><dfn id="glo:glsxtrLatinSchwa"><code class="csfmt">\glsxtrLatinSchwa</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule for schwa (Ə, ə, <sup>ə</sup>) so you don’t need to remember the Unicode values. (Not used in any of the provided Latin rule blocks described above.)<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13357"></a><code class="code"><dfn id="glo:glsxtrLatinAA"><code class="csfmt">\glsxtrLatinAA</code></dfn></code></div><!-- end of pinnedbox -->
+ A mini-rule for <span class="qt">“a with ring above”</span> (Å, å) so you don’t need to remember the Unicode values. (Not used in any of the provided Latin rule blocks described above.)<p>
+
+</section><!-- end of section sec:bib2glscustomsortlatin -->
+
+<section id="sec:bib2glscustomsortmathgreek"><!-- start of section sec:bib2glscustomsortmathgreek --><div class="tomain"><a href="#main">[top]</a></div>
+<h5><!-- start of paragraph header -->11.5.2.1.3. Math Greek<div class="labellink"><a href="#sec:bib2glscustomsortmathgreek">[link]</a></div></h5><!-- end of paragraph header -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13358"></a><code class="code"><dfn id="glo:glsxtrMathGreekIrules"><code class="csfmt">\glsxtrMathGreekIrules</code></dfn></code></div><!-- end of pinnedbox -->
+ A rule block for mathematical Greek (<a id="wrglossary.13359"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>, <a id="wrglossary.13360"></a><a href="#glo:beta"><code class="csfmt">\beta</code></a> etc) and upright Greek (<a id="wrglossary.13361"></a><a href="#glo:upalpha"><code class="csfmt">\upalpha</code></a>, etc, from the <a id="wrglossary.13362"></a><a href="#glo:pkg.upgreek"><span class="styfmt">upgreek</span></a> package) characters that includes digamma (<a id="wrglossary.13363"></a><a href="#glo:digamma"><code class="csfmt">\digamma</code></a> and <a id="wrglossary.13364"></a><a href="#glo:Digamma"><code class="csfmt">\Digamma</code></a>) between epsilon and zeta. The upright and italic versions are gathered together into the same letter group.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13365"></a><code class="code"><dfn id="glo:glsxtrMathGreekIIrules"><code class="csfmt">\glsxtrMathGreekIIrules</code></dfn></code></div><!-- end of pinnedbox -->
+ As <a id="wrglossary.13366"></a><a href="#glo:glsxtrMathGreekIrules"><code class="csfmt">\glsxtrMathGreekIrules</code></a> but doesn’t include digamma.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13367"></a><code class="code"><dfn id="glo:glsxtrMathUpGreekIrules"><code class="csfmt">\glsxtrMathUpGreekIrules</code></dfn></code></div><!-- end of pinnedbox -->
+ A rule block for upright Greek (<a id="wrglossary.13368"></a><a href="#glo:upalpha"><code class="csfmt">\upalpha</code></a>, etc, from the <a id="wrglossary.13369"></a><a href="#glo:pkg.upgreek"><span class="styfmt">upgreek</span></a> package) characters that includes digamma (<a id="wrglossary.13370"></a><a href="#glo:digamma"><code class="csfmt">\digamma</code></a> and <a id="wrglossary.13371"></a><a href="#glo:Digamma"><code class="csfmt">\Digamma</code></a>) between epsilon and zeta.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13372"></a><code class="code"><dfn id="glo:glsxtrMathUpGreekIIrules"><code class="csfmt">\glsxtrMathUpGreekIIrules</code></dfn></code></div><!-- end of pinnedbox -->
+ A rule block for upright Greek (<a id="wrglossary.13373"></a><a href="#glo:upalpha"><code class="csfmt">\upalpha</code></a>, etc, from the <a id="wrglossary.13374"></a><a href="#glo:pkg.upgreek"><span class="styfmt">upgreek</span></a> package) that doesn’t include digamma.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13375"></a><code class="code"><dfn id="glo:glsxtrMathItalicGreekIrules"><code class="csfmt">\glsxtrMathItalicGreekIrules</code></dfn></code></div><!-- end of pinnedbox -->
+ A rule block for mathematical Greek (<a id="wrglossary.13376"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>, <a id="wrglossary.13377"></a><a href="#glo:Alpha"><code class="csfmt">\Alpha</code></a>, etc) characters that includes digamma (<a id="wrglossary.13378"></a><a href="#glo:digamma"><code class="csfmt">\digamma</code></a> and <a id="wrglossary.13379"></a><a href="#glo:Digamma"><code class="csfmt">\Digamma</code></a>) between epsilon and zeta. Note that even though the <a id="wrglossary.13380"></a><a href="#glo:idx.uppercase">uppercase</a> <a id="wrglossary.13381"></a><a href="#glo:Delta"><code class="csfmt">\Delta</code></a> etc are actually rendered upright by LaTeX, <a id="wrglossary.13382"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span>’s</a> interpreter treats them as italic to help keep them close to the <a id="wrglossary.13383"></a><a href="#glo:idx.lowercase">lowercase</a> versions.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13384"></a><code class="code"><dfn id="glo:glsxtrMathItalicGreekIIrules"><code class="csfmt">\glsxtrMathItalicGreekIIrules</code></dfn></code></div><!-- end of pinnedbox -->
+ A rule block for mathematical Greek (<a id="wrglossary.13385"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>, <a id="wrglossary.13386"></a><a href="#glo:Alpha"><code class="csfmt">\Alpha</code></a>, etc) characters that doesn’t include digamma.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13387"></a><code class="code"><dfn id="glo:glsxtrMathItalicUpperGreekIrules"><code class="csfmt">\glsxtrMathItalicUpperGreekIrules</code></dfn></code></div><!-- end of pinnedbox -->
+ A rule block for <a id="wrglossary.13388"></a><a href="#glo:idx.uppercase">uppercase</a> mathematical Greek (<a id="wrglossary.13389"></a><a href="#glo:Alpha"><code class="csfmt">\Alpha</code></a>, <a id="wrglossary.13390"></a><a href="#glo:Beta"><code class="csfmt">\Beta</code></a>, etc) characters that includes digamma (<a id="wrglossary.13391"></a><a href="#glo:Digamma"><code class="csfmt">\Digamma</code></a>) between epsilon and zeta.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13392"></a><code class="code"><dfn id="glo:glsxtrMathItalicUpperGreekIIrules"><code class="csfmt">\glsxtrMathItalicUpperGreekIIrules</code></dfn></code></div><!-- end of pinnedbox -->
+ A rule block for <a id="wrglossary.13393"></a><a href="#glo:idx.uppercase">uppercase</a> mathematical Greek (<a id="wrglossary.13394"></a><a href="#glo:Alpha"><code class="csfmt">\Alpha</code></a>, <a id="wrglossary.13395"></a><a href="#glo:Beta"><code class="csfmt">\Beta</code></a>, etc) characters that doesn’t include digamma.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13396"></a><code class="code"><dfn id="glo:glsxtrMathItalicLowerGreekIrules"><code class="csfmt">\glsxtrMathItalicLowerGreekIrules</code></dfn></code></div><!-- end of pinnedbox -->
+ A rule block for <a id="wrglossary.13397"></a><a href="#glo:idx.lowercase">lowercase</a> mathematical Greek (<a id="wrglossary.13398"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>, <a id="wrglossary.13399"></a><a href="#glo:beta"><code class="csfmt">\beta</code></a>, etc) characters that includes digamma (<a id="wrglossary.13400"></a><a href="#glo:digamma"><code class="csfmt">\digamma</code></a>) between epsilon and zeta.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13401"></a><code class="code"><dfn id="glo:glsxtrMathItalicLowerGreekIIrules"><code class="csfmt">\glsxtrMathItalicLowerGreekIIrules</code></dfn></code></div><!-- end of pinnedbox -->
+ A rule block for lower case mathematical Greek (<a id="wrglossary.13402"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>, <a id="wrglossary.13403"></a><a href="#glo:beta"><code class="csfmt">\beta</code></a>, etc) characters that doesn’t include digamma.<p>
+Additionally, there are commands that just cover the <a id="wrglossary.13404"></a><a href="#glo:idx.uppercase">uppercase</a> and <a id="wrglossary.13405"></a><a href="#glo:idx.lowercase">lowercase</a> forms of a special Greek character (<a id="wrglossary.13406"></a><a href="#glo:Upalpha"><code class="csfmt">\Upalpha</code></a>, <a id="wrglossary.13407"></a><a href="#glo:upalpha"><code class="csfmt">\upalpha</code></a> etc and <a id="wrglossary.13408"></a><a href="#glo:Alpha"><code class="csfmt">\Alpha</code></a>, <a id="wrglossary.13409"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a> etc): <a id="wrglossary.13410"></a><dfn id="glo:glsxtrUpAlpha"><code class="csfmt">\glsxtrUpAlpha</code></dfn>, <a id="wrglossary.13411"></a><dfn id="glo:glsxtrMathItalicAlpha"><code class="csfmt">\glsxtrMathItalicAlpha</code></dfn>, <a id="wrglossary.13412"></a><dfn id="glo:glsxtrUpBeta"><code class="csfmt">\glsxtrUpBeta</code></dfn>, <a id="wrglossary.13413"></a><dfn id="glo:glsxtrMathItalicBeta"><code class="csfmt">\glsxtrMathItalicBeta</code></dfn>, <a id="wrglossary.13414"></a><dfn id="glo:glsxtrUpGamma"><code class="csfmt">\glsxtrUpGamma</code></dfn>, <a id="wrglossary.13415"></a><dfn id="glo:glsxtrMathItalicGamma"><code class="csfmt">\glsxtrMathItalicGamma</code></dfn>, <a id="wrglossary.13416"></a><dfn id="glo:glsxtrUpDelta"><code class="csfmt">\glsxtrUpDelta</code></dfn>, <a id="wrglossary.13417"></a><dfn id="glo:glsxtrMathItalicDelta"><code class="csfmt">\glsxtrMathItalicDelta</code></dfn>, <a id="wrglossary.13418"></a><dfn id="glo:glsxtrUpEpsilon"><code class="csfmt">\glsxtrUpEpsilon</code></dfn>, <a id="wrglossary.13419"></a><dfn id="glo:glsxtrMathItalicEpsilon"><code class="csfmt">\glsxtrMathItalicEpsilon</code></dfn>, <a id="wrglossary.13420"></a><dfn id="glo:glsxtrUpDigamma"><code class="csfmt">\glsxtrUpDigamma</code></dfn>, <a id="wrglossary.13421"></a><dfn id="glo:glsxtrMathItalicDigamma"><code class="csfmt">\glsxtrMathItalicDigamma</code></dfn>, <a id="wrglossary.13422"></a><dfn id="glo:glsxtrUpZeta"><code class="csfmt">\glsxtrUpZeta</code></dfn>, <a id="wrglossary.13423"></a><dfn id="glo:glsxtrMathItalicZeta"><code class="csfmt">\glsxtrMathItalicZeta</code></dfn>, <a id="wrglossary.13424"></a><dfn id="glo:glsxtrUpEta"><code class="csfmt">\glsxtrUpEta</code></dfn>, <a id="wrglossary.13425"></a><dfn id="glo:glsxtrMathItalicEta"><code class="csfmt">\glsxtrMathItalicEta</code></dfn>, <a id="wrglossary.13426"></a><dfn id="glo:glsxtrUpTheta"><code class="csfmt">\glsxtrUpTheta</code></dfn>, <a id="wrglossary.13427"></a><dfn id="glo:glsxtrMathItalicTheta"><code class="csfmt">\glsxtrMathItalicTheta</code></dfn>, <a id="wrglossary.13428"></a><dfn id="glo:glsxtrUpIota"><code class="csfmt">\glsxtrUpIota</code></dfn>, <a id="wrglossary.13429"></a><dfn id="glo:glsxtrMathItalicIota"><code class="csfmt">\glsxtrMathItalicIota</code></dfn>, <a id="wrglossary.13430"></a><dfn id="glo:glsxtrUpKappa"><code class="csfmt">\glsxtrUpKappa</code></dfn>, <a id="wrglossary.13431"></a><dfn id="glo:glsxtrMathItalicKappa"><code class="csfmt">\glsxtrMathItalicKappa</code></dfn>, <a id="wrglossary.13432"></a><dfn id="glo:glsxtrUpLambda"><code class="csfmt">\glsxtrUpLambda</code></dfn>, <a id="wrglossary.13433"></a><dfn id="glo:glsxtrMathItalicLambda"><code class="csfmt">\glsxtrMathItalicLambda</code></dfn>, <a id="wrglossary.13434"></a><dfn id="glo:glsxtrUpMu"><code class="csfmt">\glsxtrUpMu</code></dfn>, <a id="wrglossary.13435"></a><dfn id="glo:glsxtrMathItalicMu"><code class="csfmt">\glsxtrMathItalicMu</code></dfn>, <a id="wrglossary.13436"></a><dfn id="glo:glsxtrUpNu"><code class="csfmt">\glsxtrUpNu</code></dfn>, <a id="wrglossary.13437"></a><dfn id="glo:glsxtrMathItalicNu"><code class="csfmt">\glsxtrMathItalicNu</code></dfn>, <a id="wrglossary.13438"></a><dfn id="glo:glsxtrUpXi"><code class="csfmt">\glsxtrUpXi</code></dfn>, <a id="wrglossary.13439"></a><dfn id="glo:glsxtrMathItalicXi"><code class="csfmt">\glsxtrMathItalicXi</code></dfn>, <a id="wrglossary.13440"></a><dfn id="glo:glsxtrUpOmicron"><code class="csfmt">\glsxtrUpOmicron</code></dfn>, <a id="wrglossary.13441"></a><dfn id="glo:glsxtrMathItalicOmicron"><code class="csfmt">\glsxtrMathItalicOmicron</code></dfn>, <a id="wrglossary.13442"></a><dfn id="glo:glsxtrUpPi"><code class="csfmt">\glsxtrUpPi</code></dfn>, <a id="wrglossary.13443"></a><dfn id="glo:glsxtrMathItalicPi"><code class="csfmt">\glsxtrMathItalicPi</code></dfn>, <a id="wrglossary.13444"></a><dfn id="glo:glsxtrUpRho"><code class="csfmt">\glsxtrUpRho</code></dfn>, <a id="wrglossary.13445"></a><dfn id="glo:glsxtrMathItalicRho"><code class="csfmt">\glsxtrMathItalicRho</code></dfn>, <a id="wrglossary.13446"></a><dfn id="glo:glsxtrUpSigma"><code class="csfmt">\glsxtrUpSigma</code></dfn>, <a id="wrglossary.13447"></a><dfn id="glo:glsxtrMathItalicSigma"><code class="csfmt">\glsxtrMathItalicSigma</code></dfn>, <a id="wrglossary.13448"></a><dfn id="glo:glsxtrUpTau"><code class="csfmt">\glsxtrUpTau</code></dfn>, <a id="wrglossary.13449"></a><dfn id="glo:glsxtrMathItalicTau"><code class="csfmt">\glsxtrMathItalicTau</code></dfn>, <a id="wrglossary.13450"></a><dfn id="glo:glsxtrUpUpsilon"><code class="csfmt">\glsxtrUpUpsilon</code></dfn>, <a id="wrglossary.13451"></a><dfn id="glo:glsxtrMathItalicUpsilon"><code class="csfmt">\glsxtrMathItalicUpsilon</code></dfn>, <a id="wrglossary.13452"></a><dfn id="glo:glsxtrUpPhi"><code class="csfmt">\glsxtrUpPhi</code></dfn>, <a id="wrglossary.13453"></a><dfn id="glo:glsxtrMathItalicPhi"><code class="csfmt">\glsxtrMathItalicPhi</code></dfn>, <a id="wrglossary.13454"></a><dfn id="glo:glsxtrUpChi"><code class="csfmt">\glsxtrUpChi</code></dfn>, <a id="wrglossary.13455"></a><dfn id="glo:glsxtrMathItalicChi"><code class="csfmt">\glsxtrMathItalicChi</code></dfn>, <a id="wrglossary.13456"></a><dfn id="glo:glsxtrUpPsi"><code class="csfmt">\glsxtrUpPsi</code></dfn>, <a id="wrglossary.13457"></a><dfn id="glo:glsxtrMathItalicPsi"><code class="csfmt">\glsxtrMathItalicPsi</code></dfn>, <a id="wrglossary.13458"></a><dfn id="glo:glsxtrUpOmega"><code class="csfmt">\glsxtrUpOmega</code></dfn>, and <a id="wrglossary.13459"></a><dfn id="glo:glsxtrMathItalicOmega"><code class="csfmt">\glsxtrMathItalicOmega</code></dfn>.<p>
+Additionally, there are commands for math italic partial differential ∂ (0x1D715) <a id="wrglossary.13460"></a><dfn id="glo:glsxtrMathItalicPartial"><code class="csfmt">\glsxtrMathItalicPartial</code></dfn> and nabla 𝛻 (0x1D6FB) <a id="wrglossary.13461"></a><dfn id="glo:glsxtrMathItalicNabla"><code class="csfmt">\glsxtrMathItalicNabla</code></dfn>.<p>
+
+</section><!-- end of section sec:bib2glscustomsortmathgreek -->
+
+<section id="sec:glstexcmds"><!-- start of section sec:glstexcmds --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->11.5.3. Commands Used Within Resource Files<div class="labellink"><a href="#sec:glstexcmds">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+A <a id="wrglossary.13462"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file will typically start with <a id="wrglossary.13463"></a><a href="#glo:glsnoexpandfields"><code class="csfmt">\glsnoexpandfields</code></a>, since supporting field expansion is only necessary where entry definitions may be programmatically performed within a loop or some other command. (This may be suppressed.)<p>
+If you use the <a id="wrglossary.13464"></a><a href="#glo:opt.resource.set-widest"><span class="csoptfmt">set-widest</span></a> resource option, <a id="wrglossary.13465"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v1.8+ will write the following command in the <a id="wrglossary.13466"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13467"></a><code class="code"><dfn id="glo:glsxtrSetWidest"><code class="csfmt">\glsxtrSetWidest</code></dfn>{<span class="meta">〈<em class="metainner">type</em>〉</span>}{<span class="meta">〈<em class="metainner">level</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This sets the widest name for the given <a id="wrglossary.13468"></a><a href="#glo:dual.glossary">glossary</a> type and <a id="wrglossary.13469"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a>. This supports both the <a id="wrglossary.13470"></a><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a> style and the styles provided by <a id="wrglossary.13471"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a>, which need to know the widest name.<p>
+If <a id="wrglossary.13472"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can’t determine the widest name (typically because the <a id="wrglossary.13473"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field consists of commands that aren’t recognised by the interpreter) then <a id="wrglossary.13474"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v1.8+ will write the following to the <a id="wrglossary.13475"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13476"></a><code class="code"><dfn id="glo:glsxtrSetWidestFallback"><code class="csfmt">\glsxtrSetWidestFallback</code></dfn>{<span class="meta">〈<em class="metainner">type</em>〉</span>}{<span class="meta">〈<em class="metainner">level</em>〉</span>}</code></div><!-- end of pinnedbox -->
+{max depth}{list} Currently the maximum hierarchical depth <span class="meta">〈<em class="metainner">max depth</em>〉</span> may only be 0 or 2. This command requires commands provided by the <a id="wrglossary.13477"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> package with the <a id="wrglossary.13478"></a><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a> style enabled. In this case, it may be simpler to just use <a id="wrglossary.13479"></a><a href="#glo:glssetwidest"><code class="csfmt">\glssetwidest</code></a>.<p>
+The <a id="wrglossary.13480"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> files may also contain instances of <a id="wrglossary.13481"></a><a href="#glo:glsxtrprovidestoragekey"><code class="csfmt">\glsxtrprovidestoragekey</code></a> to provide new <a id="wrglossary.13482"></a><a href="#glo:idx.gloskey">glossary entry keys</a> or <a id="wrglossary.13483"></a><a href="#glo:provideignoredglossary"><code class="csfmt">\provideignoredglossary</code></a> to provide <a id="wrglossary.13484"></a><a href="#glo:dual.glossary">glossaries</a> to ensure they are defined.<p>
+The <code class="csfmt">\bibgls…</code> commands provided by <a id="wrglossary.13485"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> are defined in the <a id="wrglossary.13486"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> files with <a id="wrglossary.13487"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a>. See the <a id="wrglossary.13488"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> manual for further details of those commands.<p>
+
+</section><!-- end of section sec:glstexcmds -->
+
+<section id="sec:bib2glshier"><!-- start of section sec:bib2glshier --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->11.5.4. Hierarchy<div class="labellink"><a href="#sec:bib2glshier">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+The <a id="wrglossary.13489"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> key identifies a parent entry (by its label), so determining if an entry has a parent can easily be achieved by testing if the <a id="wrglossary.13490"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> field has been set (using <a id="wrglossary.13491"></a><a href="#glo:ifglshasparent"><code class="csfmt">\ifglshasparent</code></a> or a command like <a id="wrglossary.13492"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a>).<p>
+The other way around, testing if an entry has any children, is much harder. The base <a id="wrglossary.13493"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package provides <a id="wrglossary.13494"></a><a href="#glo:ifglshaschildren"><code class="csfmt">\ifglshaschildren</code></a>, which is very inefficient as it has to iterate over all entries in the entry’s <a id="wrglossary.13495"></a><a href="#glo:dual.glossary">glossary</a> to determine which ones have a matching <a id="wrglossary.13496"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> field.<p>
+It’s much easier with <a id="wrglossary.13497"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, as there are <a id="wrglossary.13498"></a><a href="#glo:idx.resourceopt">resource options</a> available to save this information. The <a id="wrglossary.13499"></a><a href="#glo:opt.resource.save-child-count"><span class="csoptfmt">save-child-count</span></a> option saves the child count for each entry in the <a id="wrglossary.13500"></a><a href="#glo:opt.glosfield.childcount"><span class="csoptfmt">childcount</span></a> internal field. This total only includes the child entries that have been selected by the <a id="wrglossary.13501"></a><a href="#glo:dual.resourceset">resource set</a>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13502"></a><code class="code"><dfn id="glo:GlsXtrIfHasNonZeroChildCount"><code class="csfmt">\GlsXtrIfHasNonZeroChildCount</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ A shortcut that uses <a id="wrglossary.13503"></a><a href="#glo:GlsXtrIfFieldNonZero"><code class="csfmt">\GlsXtrIfFieldNonZero</code></a> to test if the value supplied in the <a id="wrglossary.13504"></a><a href="#glo:opt.glosfield.childcount"><span class="csoptfmt">childcount</span></a> field is non-zero. The starred form uses the starred form of <a id="wrglossary.13505"></a><a href="#glo:GlsXtrIfFieldNonZero"><code class="csfmt">\GlsXtrIfFieldNonZero</code></a>.<p>
+
+</section><!-- end of section sec:bib2glshier -->
+
+<section id="sec:supplocations"><!-- start of section sec:supplocations --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->11.5.5. Supplemental Locations<div class="labellink"><a href="#sec:supplocations">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+Locations in external documents can be manually added by explicitly setting <a id="wrglossary.13506"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a> when an entry is <a id="wrglossary.13507"></a><a href="#glo:@@glslabel@indexing">indexed</a>. However, this is a bit inconvenient so <a id="wrglossary.13508"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> provides a way to do this automatically. Both the main document and the supplemental document need to use the <a id="wrglossary.13509"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a> option, and the entries provided via <a id="wrglossary.13510"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a> in the main document must have the same labels as those in the supplementary document. The supplemental document is identified by the <a id="wrglossary.13511"></a><a href="#glo:opt.resource.supplemental-locations"><span class="csoptfmt">supplemental-locations</span></a> resource option. See the <a id="wrglossary.13512"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> manual for further details.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13513"></a><code class="code"><dfn id="glo:glsxtrdisplaysupploc"><code class="csfmt">\glsxtrdisplaysupploc</code></dfn>{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">src</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This is used by <a id="wrglossary.13514"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> version v1.7+ for supplemental locations, instead of using <a id="wrglossary.13515"></a><a href="#glo:glsxtrsupphypernumber"><code class="csfmt">\glsxtrsupphypernumber</code></a> with the <a id="wrglossary.13516"></a><a href="#glo:opt.catattr.externallocation"><span class="csoptfmt">externallocation</span></a> attribute. This command sets up the <a id="wrglossary.13517"></a><a href="#glo:dual.locationcounter">location counter</a> and prefix (used in the formation of hyperlinks) and then uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13518"></a><code class="code"><dfn id="glo:glsxtrmultisupplocation"><code class="csfmt">\glsxtrmultisupplocation</code></dfn>{<span class="meta">〈<em class="metainner">src</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}{<span class="meta">〈<em class="metainner">format</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ to format the actual <a id="wrglossary.13519"></a><a href="#glo:@@glslabel@entrylocation">location</a> (with an external hyperlink, if supported). The <span class="meta">〈<em class="metainner">format</em>〉</span> (the original <a id="wrglossary.13520"></a><a href="#glo:dual.locationencap">location encap</a>) is ignored by default.<p>
+
+</section><!-- end of section sec:supplocations -->
+
+<section id="sec:recordnameref"><!-- start of section sec:recordnameref --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->11.5.6. Nameref Records<div class="labellink"><a href="#sec:recordnameref">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+Nameref <a id="wrglossary.13521"></a><a href="#glo:@@glslabel@indexing">records</a> include the current title and hypertarget. These <a id="wrglossary.13522"></a><a href="#glo:@@glslabel@indexing">records</a> are enabled with <a id="wrglossary.13523"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.13524"></a><a href="#glo:optval.record.nameref"><span class="optfmt">nameref</span></a> and provide a more reliable way of saving the <a id="wrglossary.13525"></a><a href="#glo:@@glslabel@entrylocation">location</a> hypertarget, which can’t be obtained with <a id="wrglossary.13526"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.13527"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.<p>
+This option is best used with <a id="wrglossary.13528"></a><a href="#glo:opt.counter"><span class="styoptfmt">counter</span></a><span class="optfmt">=<a id="wrglossary.13529"></a><a href="#glo:ctr.chapter"><span class="ctrfmt">chapter</span></a></span> or <a id="wrglossary.13530"></a><a href="#glo:opt.counter"><span class="styoptfmt">counter</span></a><span class="optfmt">=<a id="wrglossary.13531"></a><a href="#glo:ctr.section"><span class="ctrfmt">section</span></a></span> if you want the title included in the location list. If the indexing counter is the default <a id="wrglossary.13532"></a><a href="#glo:ctr.page"><span class="ctrfmt">page</span></a>, only the <a id="wrglossary.13533"></a><a href="#glo:@@glslabel@entrylocation">location</a> number is shown. Similarly for <a id="wrglossary.13534"></a><a href="#glo:opt.counter"><span class="styoptfmt">counter</span></a><span class="optfmt">=<a id="wrglossary.13535"></a><a href="#glo:ctr.equation"><span class="ctrfmt">equation</span></a></span> (or <a id="wrglossary.13536"></a><a href="#glo:opt.equations"><span class="styoptfmt">equations</span></a><span class="optfmt">=true</span>).<p>
+Normally locations are <a id="wrglossary.13537"></a><a href="#glo:@@glslabel@indexing">recorded</a> in the <a id="wrglossary.13538"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file in the form: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13539"></a><code class="code"><dfn id="glo:glsxtr@record"><code class="csfmt">\glsxtr@record</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">h-prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">encap</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is similar to the command used with <a id="wrglossary.13540"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> and provides the same information about the <a id="wrglossary.13541"></a><a href="#glo:@@glslabel@entrylocation">location</a> and how to form the hypertarget as is passed to <a id="wrglossary.13542"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.13543"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. The <a id="wrglossary.13544"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.13545"></a><a href="#glo:optval.record.nameref"><span class="optfmt">nameref</span></a> option, which requires at least <a id="wrglossary.13546"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v1.8, instead uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13547"></a><code class="code"><dfn id="glo:glsxtr@record@nameref"><code class="csfmt">\glsxtr@record@nameref</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">h-prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">encap</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}{<span class="meta">〈<em class="metainner">current title</em>〉</span>}{<span class="meta">〈<em class="metainner">current anchor</em>〉</span>}{<span class="meta">〈<em class="metainner">the-h-counter</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">title</em>〉</span> is obtained from <a id="wrglossary.13548"></a><a href="#glo:@currentlabelname"><code class="csfmt">\@currentlabelname</code></a> and <span class="meta">〈<em class="metainner">href</em>〉</span> is obtained from <a id="wrglossary.13549"></a><a href="#glo:@currentHref"><code class="csfmt">\@currentHref</code></a>. These commands require <a id="wrglossary.13550"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>. If they are undefined, <span class="meta">〈<em class="metainner">title</em>〉</span> and <span class="meta">〈<em class="metainner">href</em>〉</span> will be left empty and <a id="wrglossary.13551"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> will treat it as a regular <a id="wrglossary.13552"></a><a href="#glo:@@glslabel@indexing">record</a>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Be careful with this option as <span class="meta">〈<em class="metainner">href</em>〉</span> will globally change on every instance of <a id="wrglossary.13553"></a><a href="#glo:refstepcounter"><code class="csfmt">\refstepcounter</code></a> but <span class="meta">〈<em class="metainner">title</em>〉</span> won’t necessarily change. It can therefore cause unexpected behaviour. </div><!-- end of important -->
+<p>
+The final argument <span class="meta">〈<em class="metainner">hcounter</em>〉</span> is obtained from <code class="csfmt">\theH</code><span class="meta">〈<em class="metainner">counter</em>〉</span> which provides the partial target name associated with the <a id="wrglossary.13554"></a><a href="#glo:dual.locationcounter">location counter</a>. With the original <a id="wrglossary.13555"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.13556"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> approach, it’s not possible to include this information in the location, so the base <a id="wrglossary.13557"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package attempts to derive a prefix from which the <span class="meta">〈<em class="metainner">hcounter</em>〉</span> value can be reconstituted by appending the prefix. Unfortunately, not all definitions of <code class="csfmt">\theH</code><span class="meta">〈<em class="metainner">counter</em>〉</span> are in the form <span class="meta">〈<em class="metainner">prefix</em>〉</span><a id="wrglossary.13558"></a><a href="#glo:thecounter"><code class="csfmt">\the<span class="meta">〈<em class="metainner">counter</em>〉</span></code></a> (most notably the <a id="wrglossary.13559"></a><a href="#glo:ctr.equation"><span class="ctrfmt">equation</span></a> counter with chapters) so this can fail.<p>
+Since <a id="wrglossary.13560"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> is customized specifically for use with <a id="wrglossary.13561"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, it’s now possible to save <span class="meta">〈<em class="metainner">hcounter</em>〉</span>, so the <a id="wrglossary.13562"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>nameref option does this. By providing both <span class="meta">〈<em class="metainner">href</em>〉</span> and <span class="meta">〈<em class="metainner">hcounter</em>〉</span>, you can determine which target you would rather use. The default is to use <span class="meta">〈<em class="metainner">hcounter</em>〉</span>, which will take you to the place where the corresponding counter was incremented with <a id="wrglossary.13563"></a><a href="#glo:refstepcounter"><code class="csfmt">\refstepcounter</code></a>. However, you may choose to switch to using the <span class="meta">〈<em class="metainner">href</em>〉</span> target, which will take you to the nearest target before the indexing took place.<p>
+With <a id="wrglossary.13564"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v1.8+, normal locations are displayed using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13565"></a><code class="code"><dfn id="glo:glsnoidxdisplayloc"><code class="csfmt">\glsnoidxdisplayloc</code></dfn>{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is provided by the base <a id="wrglossary.13566"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package and is simply defined to do: <pre class="compactcodebox"><a id="wrglossary.13567"></a><a href="#glo:setentrycounter"><code class="csfmt">\setentrycounter</code></a>[<span class="meta">〈<em class="metainner">prefix</em>〉</span>]{<span class="meta">〈<em class="metainner">counter</em>〉</span>}<code class="cmd">\csuse</code>{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}
+</pre> Earlier versions of <a id="wrglossary.13568"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> only used this in the <a id="wrglossary.13569"></a><a href="#glo:opt.glosfield.loclist"><span class="csoptfmt">loclist</span></a> field and explicitly used <a id="wrglossary.13570"></a><a href="#glo:setentrycounter"><code class="csfmt">\setentrycounter</code></a> in the <a id="wrglossary.13571"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a> field followed by <code class="csfmt">\</code><span class="meta">〈<em class="metainner">format</em>〉</span>{location}, which follows the code that’s created with the default <a id="wrglossary.13572"></a><a href="#glo:opt.makeindex"><span class="styoptfmt">makeindex</span></a> setting. The <a id="wrglossary.13573"></a><a href="#glo:setentrycounter"><code class="csfmt">\setentrycounter</code></a> command sets up the prefix needed for <a id="wrglossary.13574"></a><a href="#glo:glshypernumber"><code class="csfmt">\glshypernumber</code></a> to reform the target name from the given <a id="wrglossary.13575"></a><a href="#glo:@@glslabel@entrylocation">location</a>.<p>
+The <a id="wrglossary.13576"></a><a href="#glo:@@glslabel@entrylocation">locations</a> identified by <a id="wrglossary.13577"></a><a href="#glo:glsxtr@record@nameref"><code class="csfmt">\glsxtr@record@nameref</code></a> are written by <a id="wrglossary.13578"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to the <a id="wrglossary.13579"></a><a href="#glo:dual.locationlist">location list</a> using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13580"></a><code class="code"><dfn id="glo:glsxtrdisplaylocnameref"><code class="csfmt">\glsxtrdisplaylocnameref</code></dfn>{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}{<span class="meta">〈<em class="metainner">title</em>〉</span>}{<span class="meta">〈<em class="metainner">href</em>〉</span>}{<span class="meta">〈<em class="metainner">hcounter</em>〉</span>}{<span class="meta">〈<em class="metainner">file</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ With normal internal locations, <span class="meta">〈<em class="metainner">file</em>〉</span> will always be empty. With supplemental locations, <span class="meta">〈<em class="metainner">file</em>〉</span> will be the external file reference. If <a id="wrglossary.13581"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> hasn’t been loaded, this command behaves like <a id="wrglossary.13582"></a><a href="#glo:glsnoidxdisplayloc"><code class="csfmt">\glsnoidxdisplayloc</code></a>, so it will simply encapsulate the location with the given formatting command.<p>
+If <a id="wrglossary.13583"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> has been loaded, then <a id="wrglossary.13584"></a><a href="#glo:glsxtrdisplaylocnameref"><code class="csfmt">\glsxtrdisplaylocnameref</code></a> will try to work out the appropriate hyperlink anchor and text. The <span class="meta">〈<em class="metainner">prefix</em>〉</span> argument is redundant. It first defines the following commands: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13585"></a><code class="code"><dfn id="glo:glsxtrrecentanchor"><code class="csfmt">\glsxtrrecentanchor</code></dfn></code></div><!-- end of pinnedbox -->
+ This expands to the <span class="meta">〈<em class="metainner">href</em>〉</span> argument, which corresponds to the <a id="wrglossary.13586"></a><a href="#glo:@currentHref"><code class="csfmt">\@currentHref</code></a> value at the time the location was <a id="wrglossary.13587"></a><a href="#glo:@@glslabel@indexing">recorded</a>. If this is used as the anchor, the link will go to the most recent anchor before the record was created. This is more likely to match the given title, but won’t necessarily match the corresponding counter.<p>
+For example, if the record was created with <a id="wrglossary.13588"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a><span class="optfmt">=<a id="wrglossary.13589"></a><a href="#glo:ctr.section"><span class="ctrfmt">section</span></a></span> but occurred in a table caption, then <a id="wrglossary.13590"></a><a href="#glo:glsxtrrecentanchor"><code class="csfmt">\glsxtrrecentanchor</code></a> and the title will correspond to the table caption. If you have defined <a id="wrglossary.13591"></a><a href="#glo:glsxtrcounterlocfmt"><code class="csfmt">\glsxtrsectionlocfmt</code></a> to show the section number (see below), then this may cause some confusion if clicking on the section number leads to a table caption. However, it will lead to the closest location to where the record was created, which may be preferred.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13592"></a><code class="code"><dfn id="glo:glsxtrlocationanchor"><code class="csfmt">\glsxtrlocationanchor</code></dfn></code></div><!-- end of pinnedbox -->
+ This expands to the anchor that corresponds to the record’s <a id="wrglossary.13593"></a><a href="#glo:dual.locationcounter">location counter</a>, which is constructed from the <span class="meta">〈<em class="metainner">counter</em>〉</span> and <span class="meta">〈<em class="metainner">hcounter</em>〉</span> arguments.<p>
+In the above example with the <a id="wrglossary.13594"></a><a href="#glo:ctr.section"><span class="ctrfmt">section</span></a> counter, <span class="meta">〈<em class="metainner">hcounter</em>〉</span> will be the value of <a id="wrglossary.13595"></a><a href="#glo:theHcounter"><code class="csfmt">\theHsection</code></a> when the record was created, so the constructed anchor will be <code class="code">section.<span class="meta">〈<em class="metainner">hcounter</em>〉</span></code> which corresponds to the anchor at the start of the section. However, if you haven’t defined <a id="wrglossary.13596"></a><a href="#glo:glsxtrcounterlocfmt"><code class="csfmt">\glsxtrsectionlocfmt</code></a>, then the title will correspond to the table caption, which may be a little confusing.<p>
+The actual anchor used is obtained from the expansion of: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13597"></a><code class="code"><dfn id="glo:glsxtractualanchor"><code class="csfmt">\glsxtractualanchor</code></dfn></code></div><!-- end of pinnedbox -->
+ This is initialised to the value of <a id="wrglossary.13598"></a><a href="#glo:glsxtrlocationanchor"><code class="csfmt">\glsxtrlocationanchor</code></a> but may be changed by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13599"></a><code class="code"><dfn id="glo:glsxtrsetactualanchor"><code class="csfmt">\glsxtrsetactualanchor</code></dfn>{<span class="meta">〈<em class="metainner">counter</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The argument is the counter name, which may be used to set choose an alternative anchor depending on the counter. This command does nothing by default, which means that <a id="wrglossary.13600"></a><a href="#glo:glsxtrlocationanchor"><code class="csfmt">\glsxtrlocationanchor</code></a> will be used.<p>
+For example, to switch to <a id="wrglossary.13601"></a><a href="#glo:glsxtrrecentanchor"><code class="csfmt">\glsxtrrecentanchor</code></a> if the counter is <span class="ctrfmt">page</span>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.13602"></a><a href="#glo:glsxtrsetactualanchor"><code class="csfmt">\glsxtrsetactualanchor</code></a>}[1]{<span class="comment">% </span>
+ <code class="cmd">\ifstrequal</code>{#1}{page}
+ <code class="cmd">\let</code><a id="wrglossary.13603"></a><a href="#glo:glsxtractualanchor"><code class="csfmt">\glsxtractualanchor</code></a><a id="wrglossary.13604"></a><a href="#glo:glsxtrrecentanchor"><code class="csfmt">\glsxtrrecentanchor</code></a> }
+</pre><p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+If you are using <a id="wrglossary.13605"></a><a href="#glo:opt.indexcounter"><span class="styoptfmt">indexcounter</span></a> then the recent anchor will be the one created by the <a id="wrglossary.13606"></a><a href="#glo:ctr.wrglossary"><span class="ctrfmt">wrglossary</span></a> increment just before the <a id="wrglossary.13607"></a><a href="#glo:dual.indexing">indexing</a> occurs. This means that with <a id="wrglossary.13608"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a><span class="optfmt">=wrglossary</span>, the location anchor and recent anchor will be the same. With other counters, the recent anchor will be the closest anchor to the place where <a id="wrglossary.13609"></a><a href="#glo:dual.indexing">indexing</a> occurred. </div><!-- end of information -->
+<p>
+To allow for different formatting according to the counter name, <a id="wrglossary.13610"></a><a href="#glo:glsxtrdisplaylocnameref"><code class="csfmt">\glsxtrdisplaylocnameref</code></a> first checks for the existence of: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13611"></a><code class="code"><dfn id="glo:glsxtrcounterlocfmt"><code class="csfmt">\glsxtr<span class="meta">〈<em class="metainner">counter</em>〉</span>locfmt</code></dfn>{<span class="meta">〈<em class="metainner">location</em>〉</span>}{<span class="meta">〈<em class="metainner">title</em>〉</span>}</code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ If this command is defined, the location will be displayed using: <pre class="compactcodebox"><a id="wrglossary.13612"></a><a href="#glo:glsxtrnamereflink"><code class="csfmt">\glsxtrnamereflink</code></a>{<span class="meta">〈<em class="metainner">format</em>〉</span>}<a id="wrglossary.13613"></a><a href="#glo:glsxtrcounterlocfmt"><code class="csfmt">\glsxtr<span class="meta">〈<em class="metainner">counter</em>〉</span>locfmt</code></a>{<span class="meta">〈<em class="metainner">location</em>〉</span>}{<span class="meta">〈<em class="metainner">title</em>〉</span>}{<span class="meta">〈<em class="metainner">href</em>〉</span>}{<span class="meta">〈<em class="metainner">file</em>〉</span>}
+</pre> Note the above warning about the possible mismatch of the title with the anchor. For example, if the following is defined for the <a id="wrglossary.13614"></a><a href="#glo:ctr.section"><span class="ctrfmt">section</span></a> counter: <pre class="compactcodebox"><code class="cmd">\newcommand</code>{<a id="wrglossary.13615"></a><a href="#glo:glsxtrcounterlocfmt"><code class="csfmt">\glsxtrsectionlocfmt</code></a>}[2]{<code class="cmd">\S</code>#1 (#2)}
+</pre> then this could lead to the section number followed by the table caption. A more compact form that omits the title is better: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<a id="wrglossary.13616"></a><a href="#glo:glsxtrcounterlocfmt"><code class="csfmt">\glsxtrsectionlocfmt</code></a>}[2]{<code class="cmd">\S</code>#1}
+</pre><p>
+The following location formats are predefined. The <a id="wrglossary.13617"></a><a href="#glo:ctr.equation"><span class="ctrfmt">equation</span></a> counter: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13618"></a><code class="code"><dfn id="glo:glsxtrequationlocfmt"><code class="csfmt">\glsxtrequationlocfmt</code></dfn>{<span class="meta">〈<em class="metainner">location</em>〉</span>}{<span class="meta">〈<em class="metainner">title</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This simply expands to <code class="code">(<span class="meta">〈<em class="metainner">location</em>〉</span>)</code> since equations typically don’t have a title, but are usually enclosed in parentheses.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13619"></a><code class="code"><dfn id="glo:glsxtrwrglossarylocfmt"><code class="csfmt">\glsxtrwrglossarylocfmt</code></dfn>{<span class="meta">〈<em class="metainner">location</em>〉</span>}{<span class="meta">〈<em class="metainner">title</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is used when the <a id="wrglossary.13620"></a><a href="#glo:opt.indexcounter"><span class="styoptfmt">indexcounter</span></a> option creates records with the <a id="wrglossary.13621"></a><a href="#glo:ctr.wrglossary"><span class="ctrfmt">wrglossary</span></a> counter. This ensures that the page name is shown rather than the value of the <a id="wrglossary.13622"></a><a href="#glo:ctr.wrglossary"><span class="ctrfmt">wrglossary</span></a> counter.<p>
+If the corresponding <a id="wrglossary.13623"></a><a href="#glo:glsxtrcounterlocfmt"><code class="csfmt">\glsxtr<span class="meta">〈<em class="metainner">counter</em>〉</span>locfmt</code></a> hasn’t been defined, <a id="wrglossary.13624"></a><a href="#glo:glsxtrdisplaylocnameref"><code class="csfmt">\glsxtrdisplaylocnameref</code></a> will do one of the following:
+<ul class="displaylist">
+ <li><span class="bulletitem">•</span>if <span class="meta">〈<em class="metainner">title</em>〉</span> is empty or the counter is <a id="wrglossary.13625"></a><a href="#glo:ctr.page"><span class="ctrfmt">page</span></a>, <a id="wrglossary.13626"></a><a href="#glo:glsxtrnamereflink"><code class="csfmt">\glsxtrnamereflink</code></a> with the title set to the location;<p>
+<li><span class="bulletitem">•</span>otherwise it will do: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13627"></a><code class="code"><dfn id="glo:glsxtrtitlednamereflink"><code class="csfmt">\glsxtrtitlednamereflink</code></dfn>{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}{<span class="meta">〈<em class="metainner">title</em>〉</span>}{<span class="meta">〈<em class="metainner">file</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which uses <a id="wrglossary.13628"></a><a href="#glo:glsxtrnamereflink"><code class="csfmt">\glsxtrnamereflink</code></a> with the given <span class="meta">〈<em class="metainner">title</em>〉</span> and <a id="wrglossary.13629"></a><a href="#glo:glsxtrrecentanchor"><code class="csfmt">\glsxtrrecentanchor</code></a> as the anchor. This has a better chance of matching the title with the anchor, but it’s not guaranteed as some anchors are created without a title. This is defined as: <pre class="compactcodebox"><code class="cmd">\newcommand</code>{<a id="wrglossary.13630"></a><a href="#glo:glsxtrtitlednamereflink"><code class="csfmt">\glsxtrtitlednamereflink</code></a>}[4]{<span class="comment">% </span>
+ <a id="wrglossary.13631"></a><a href="#glo:glsxtrnamereflink"><code class="csfmt">\glsxtrnamereflink</code></a>{#1}{#2}{<a id="wrglossary.13632"></a><a href="#glo:glsxtrrecentanchor"><code class="csfmt">\glsxtrrecentanchor</code></a>}{#4}<span class="comment">% </span>
}
-</pre>
-<!--l. 14642--><p class="nopar" > and then later in the text:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-343">
-\displayterm{function}
-</pre>
-<!--l. 14646--><p class="nopar" >
-</p><!--l. 14648--><p class="indent" > However, if may be that you want to use <span
-class="cmss-10">hyperref</span><a
- id="dx1-91003"></a> and have commands like <span
-class="cmtt-10">\gls</span>
-link back to the place where the term is described. Instead of using <span
-class="cmtt-10">\glsentryname</span>
-use
-</p><!--l. 14652--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-91004"></a> <span
-class="cmtt-10">\glsxtrglossentry{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 14654--><p class="noindent" >
-where &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; is the entry&#8217;s label.
-</p><!--l. 14657--><p class="indent" > This is designed to behave much like the way the name is displayed in the
-glossary. It performs the following: </p>
- <ul class="itemize1">
- <li class="itemize">Defines <span
-class="cmtt-10">\glscurrententrylabel </span>to the entry&#8217;s label. This is usually
- done at the start of the glossary style commands <span
-class="cmtt-10">\glossentry </span>and
- <span
-class="cmtt-10">\subglossentry </span>and may be used by hooks, such as the post-name
- hooks. Here the definition is localised so that it&#8217;s only available for use in
- <span
-class="cmtt-10">\glossentryname</span>.
- </li>
- <li class="itemize">Defines <span
-class="cmtt-10">\currentglossary </span>to the entry&#8217;s glossary type. This is usually done at
- the start of commands like <span
-class="cmtt-10">\printglossary </span>and may be used by style hooks.
- Here the definition is localised so that it&#8217;s only available for use in
- <span
-class="cmtt-10">\glsentryitem </span>and <span
-class="cmtt-10">\glssubentryitem</span>. The value is obtained by fully
- expanding:
- <!--l. 14672--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-91005"></a> <span
-class="cmtt-10">\GlsXtrStandaloneGlossaryType </span></div><hr>
- </p><!--l. 14674--><p class="noindent" >
- which defaults to the value of the <span
-class="cmss-10">type</span><a
- id="dx1-91006"></a> field for the current entry.
- </p></li>
- <li class="itemize">Increments and display the entry counters if the <a
-href="#styopt.entrycounter"><span
-class="cmss-10">entrycounter</span></a><a
- id="dx1-91007"></a> or <a
-href="#styopt.subentrycounter"><span
-class="cmss-10">subentrycounter</span></a><a
- id="dx1-91008"></a>
- package options are set. If the entry doesn&#8217;t have a parent, then this
- does
- <ul class="itemize2">
- <li class="itemize"><span
-class="cmtt-10">\glsentryitem{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span></li></ul>
- <!--l. 14685--><p class="noindent" >otherwise it does (as from v1.31) </p>
- <ul class="itemize2">
- <li class="itemize"><span
-class="cmtt-10">\GlsXtrStandaloneSubEntryItem</span><a
- id="dx1-91009"></a>
- <span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span>which defaults to <span
-class="cmtt-10">\glssubentryitem{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span>if the entry has
- a parent but not a grandparent.</li></ul>
-
-
-
- <!--l. 14691--><p class="noindent" >This reflects the behaviour of the predefined hierarchical styles. A bug in
- pre-version&#x00A0;1.31 used <span
-class="cmtt-10">\glsentryitem </span>for all child levels, which doesn&#8217;t match
- the hierarchical glossary styles. If you want to restore this behaviour, just
- do:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-344">
- \renewcommand*{\GlsXtrStandaloneSubEntryItem}[1]{\glssubentryitem{#1}}
-</pre>
- <!--l. 14697--><p class="nopar" >
- </p></li>
- <li class="itemize">Sets the hyper-target if supported (using <span
-class="cmtt-10">\glstarget</span>) and displays the entry
- name using:
- <!--l. 14701--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-91010"></a> <span
-class="cmtt-10">\GlsXtrStandaloneEntryName{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
- </p><!--l. 14703--><p class="noindent" >
- which uses <span
-class="cmtt-10">\glstarget{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">\glossentryname{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span><span
-class="cmsy-10">} </span>by default.
- Remember that <span
-class="cmtt-10">\glossentryname </span>uses <span
-class="cmtt-10">\glsnamefont </span>or picks up the style
- from category attributes such as <a
-href="#catattr.glossnamefont"><span
-class="cmss-10">glossnamefont</span></a><a
- id="dx1-91011"></a>.</p></li></ul>
-<!--l. 14711--><p class="noindent" >If you have used <span
-class="cmtt-10">\nopostdesc</span><a
- id="dx1-91012"></a> or <span
-class="cmtt-10">\glsxtrnopostpunc</span><a
- id="dx1-91013"></a> in any of your description fields,
-you can use
-</p><!--l. 14713--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-91014"></a> <span
-class="cmtt-10">\glsxtractivatenopost </span></div><hr>
-</p><!--l. 14715--><p class="noindent" >
-to make these commands behave as they normally do within a glossary. This needs to
-be placed before </p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\glossentrydesc{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}\glspostdescription</span>
-</div>
-</div> and scoped. Note that <span
-class="cmtt-10">\glsnonextpages </span>and <span
-class="cmtt-10">\glsnextpages </span>have no effect outside
-of the glossary and are not intended for use in a standalone context.
-<!--l. 14725--><p class="indent" > It&#8217;s also possible to select a different field (rather than using <span
-class="cmss-10">name</span><a
- id="dx1-91015"></a>):
-</p><!--l. 14727--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-91016"></a> <span
-class="cmtt-10">\glsxtrglossentryother{</span>&#x27E8;<span
-class="cmitt-10">header</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 14729--><p class="noindent" >
-The &#x27E8;<span
-class="cmti-10">field</span>&#x27E9; must be given using its internal field label which may not be the same as
-the key used to set the field. See the key to field mappings table in the <span
-class="cmss-10">glossaries </span>user
-manual. The &#x27E8;<span
-class="cmti-10">header</span>&#x27E9; argument is the code to pass to the third argument of
-<span
-class="cmtt-10">\glsxtrtitleorpdforheading</span>. It may be left empty in which case the default is
-determined as follows: </p>
- <ul class="itemize1">
- <li class="itemize">If <span
-class="cmtt-10">\glsxtrhead</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9; is defined, then &#x27E8;<span
-class="cmti-10">header</span>&#x27E9; is <span
-class="cmtt-10">\glsxtrhead</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;
- <span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>.
- </li>
- <li class="itemize">Otherwise &#x27E8;<span
-class="cmti-10">header</span>&#x27E9; is simply the field value.</li></ul>
-
-
-
-<!--l. 14741--><p class="noindent" >The <span
-class="cmtt-10">\glsxtrglossentryother </span>command internally uses
-</p><!--l. 14742--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-91017"></a> <span
-class="cmtt-10">\GlsXtrStandaloneEntryOther{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 14744--><p class="noindent" >
-instead of <span
-class="cmtt-10">\GlsXtrStandaloneEntryName</span>, which uses <span
-class="cmtt-10">\glossentrynameother{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>
-<span
-class="cmtt-10">{</span>&#x27E8;<span
-class="cmti-10">field</span>&#x27E9;<span
-class="cmtt-10">} </span>instead of <span
-class="cmtt-10">\glossentryname{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>.
-</p><!--l. 14749--><p class="indent" > If you have loaded the <span
-class="cmss-10">glossaries-accsupp</span><a
- id="dx1-91018"></a> package (through the <a
-href="#styopt.accsupp"><span
-class="cmss-10">accsupp</span></a><a
- id="dx1-91019"></a> option)
-then accessibility support will be provided if there&#8217;s a corresponding command
-</p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\gls</span>&#x27E8;<span
-class="cmitt-10">field</span>&#x27E9;<span
-class="cmtt-10">accessdisplay{</span>&#x27E8;<span
-class="cmitt-10">text</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div>
-</div> (for example, <span
-class="cmtt-10">\glssymbolaccessdisplay</span>).
-<!--l. 14758--><p class="indent" > This means that my custom command can be changed to:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-345">
-\newcommand{\displayterm}[1]{%
-&#x00A0;\par\medskip\par\noindent
-&#x00A0;Definition:&#x00A0;\glsxtrglossentry{#1}.\par
-&#x00A0;\glsentrydesc{#1}
-&#x00A0;\par\medskip
+</pre> This shows the formatted title with the recent anchor. The location isn’t shown. If you would prefer to just show the location and use the anchor corresponding to the location counter: <pre class="compactcodebox"><code class="cmd">\renewcommand</code>{<a id="wrglossary.13633"></a><a href="#glo:glsxtrtitlednamereflink"><code class="csfmt">\glsxtrtitlednamereflink</code></a>}[4]{<span class="comment">% </span>
+ <a id="wrglossary.13634"></a><a href="#glo:glsxtrnamereflink"><code class="csfmt">\glsxtrnamereflink</code></a>{#1}{#2}{<a id="wrglossary.13635"></a><a href="#glo:glsxtrlocationanchor"><code class="csfmt">\glsxtrlocationanchor</code></a>}{#3}<span class="comment">% </span>
}
-</pre>
-<!--l. 14766--><p class="nopar" > If I want numbered definitions, then I can use the package options <span
-class="cmss-10">entrycounter</span><a
- id="dx1-91020"></a> or
-<span
-class="cmss-10">subentrycounter</span><a
- id="dx1-91021"></a> and remove the colon:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-346">
-\newcommand{\displayterm}[1]{%
-&#x00A0;\par\medskip\par\noindent
-&#x00A0;Definition&#x00A0;\glsxtrglossentry{#1}.\par
-&#x00A0;\glsentrydesc{#1}
-&#x00A0;\par\medskip
+</pre>
+</ul>
+<p>
+If <span class="meta">〈<em class="metainner">file</em>〉</span> is empty an internal link is created with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13636"></a><code class="code"><dfn id="glo:glsxtrfmtinternalnameref"><code class="csfmt">\glsxtrfmtinternalnameref</code></dfn>{<span class="meta">〈<em class="metainner">target</em>〉</span>}{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">file</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ otherwise an external link is created with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13637"></a><code class="code"><dfn id="glo:glsxtrfmtexternalnameref"><code class="csfmt">\glsxtrfmtexternalnameref</code></dfn>{<span class="meta">〈<em class="metainner">target</em>〉</span>}{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">title</em>〉</span>}{<span class="meta">〈<em class="metainner">file</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The <span class="meta">〈<em class="metainner">file</em>〉</span> argument is set by <a id="wrglossary.13638"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> for supplemental locations (obtained from <a id="wrglossary.13639"></a><a href="#glo:opt.resource.supplemental-locations"><span class="csoptfmt">supplemental-locations</span></a>).<p>
+The link is encapsulated with the text-block command whose name is given by <span class="meta">〈<em class="metainner">format</em>〉</span>, but <a id="wrglossary.13640"></a><a href="#glo:glshypernumber"><code class="csfmt">\glshypernumber</code></a> is first locally redefined to <a id="wrglossary.13641"></a><a href="#glo:@firstofone"><code class="csfmt">\@firstofone</code></a> to prevent a conflict with the usual <a id="wrglossary.13642"></a><a href="#glo:@@glslabel@entrylocation">location</a> hyperlink formation. This means that if the <span class="meta">〈<em class="metainner">format</em>〉</span> is <a id="wrglossary.13643"></a><a href="#glo:hyperbf"><code class="csfmt">\hyperbf</code></a> then it will simply behave like <a id="wrglossary.13644"></a><a href="#glo:textbf"><code class="csfmt">\textbf</code></a>.<p>
+The following command is provided but not used by default: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13645"></a><code class="code"><dfn id="glo:glsxtrnameloclink"><code class="csfmt">\glsxtrnameloclink</code></dfn>{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">file</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This creates a hyperlink to the target in the given external file obtained from the <span class="meta">〈<em class="metainner">prefix</em>〉</span>, <span class="meta">〈<em class="metainner">counter</em>〉</span> and <span class="meta">〈<em class="metainner">location</em>〉</span> but uses <span class="meta">〈<em class="metainner">text</em>〉</span> as the hyperlink text. As with regular indexing, this will fail if the target name can’t be formed by prefixing the location value.<p>
+For compactness, <a id="wrglossary.13646"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> merges normal records if the <span class="meta">〈<em class="metainner">prefix</em>〉</span>, <span class="meta">〈<em class="metainner">counter</em>〉</span> and <span class="meta">〈<em class="metainner">location</em>〉</span> all match. (An order of precedence can be provided for format conflicts.) With <span class="optfmt">nameref</span> records, you can use the <a id="wrglossary.13647"></a><a href="#glo:switch.merge-nameref-on"><span class="longargfmt">--merge-nameref-on</span></a> switch provided by <a id="wrglossary.13648"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v1.8+ to determine how to merge <span class="optfmt">nameref</span> records. This switch must be followed by one of the following keywords: <code class="code">hcounter</code> (merge on <span class="meta">〈<em class="metainner">hcounter</em>〉</span>, default) <code class="code">href</code> (merge on <span class="meta">〈<em class="metainner">href</em>〉</span>), <code class="code">title</code> (merge on <span class="meta">〈<em class="metainner">title</em>〉</span>) and <code class="code">location</code> (merge on <span class="meta">〈<em class="metainner">location</em>〉</span>, as regular records). In all cases, the <span class="meta">〈<em class="metainner">counter</em>〉</span> must also match.<p>
+
+</section><!-- end of section sec:recordnameref -->
+
+<section id="sec:dgls"><!-- start of section sec:dgls --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->11.5.7. Dual Entry Commands<div class="labellink"><a href="#sec:dgls">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+Dual entries can be defined with entry types like <code class="code">@dualentry</code> or <code class="code">@dualindexabbreviation</code>. A single entry definition within the <a id="wrglossary.13649"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file creates two dependent entries that may be referenced within the document and assigned to different <a id="wrglossary.13650"></a><a href="#glo:dual.glossary">glossaries</a>. The default <a id="wrglossary.13651"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">={recorded and deps}</span> will ensure that dependent entries are selected, even if they don’t have any <a id="wrglossary.13652"></a><a href="#glo:@@glslabel@indexing">records</a>. For example, the following <a id="wrglossary.13653"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> entry: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="code">@dualindexsymbol</code>{L,
+ <a id="wrglossary.13654"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={Lagrangian function}</span>,
+ <a id="wrglossary.13655"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{L}}</span>,
+ <a id="wrglossary.13656"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a function of generalized co-ordinates}</span>
}
-</pre>
-<!--l. 14777--><p class="nopar" > The counter label uses a dot after the number by default but this can be changed to
-a colon:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-347">
-\renewcommand*{\glsentrycounterlabel}{\theglossaryentry:\space}
-</pre>
-<!--l. 14782--><p class="nopar" > It&#8217;s now possible to not only use <span
-class="cmtt-10">\gls </span>to link back to the definition but also use
-<span
-class="cmtt-10">\glsrefentry </span>to reference the counter and <span
-class="cmtt-10">\glsxtrpageref </span>to reference the page
-number.
-</p><!--l. 14787--><p class="indent" > If I want the description to behave more like it does in a glossary in need to make
-the following modification:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-348">
-\newcommand{\displayterm}[1]{%
-&#x00A0;\par\medskip\par\noindent
-&#x00A0;Definition&#x00A0;\glsxtrglossentry{#1}.\par
-&#x00A0;\begingroup
-&#x00A0;&#x00A0;\glsxtractivatenopost
-&#x00A0;&#x00A0;\glossentrydesc{#1}\glspostdescription
-&#x00A0;\endgroup
-&#x00A0;\par\medskip
+</pre> is essentially like: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="code">@index</code>{L,
+ <a id="wrglossary.13657"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={Lagrangian function}</span>,
+ <a id="wrglossary.13658"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{L}}</span>,
+ <a id="wrglossary.13659"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a function of generalized co-ordinates}</span>
}
-</pre>
-<!--l. 14799--><p class="nopar" > (Note the grouping to localise <span
-class="cmtt-10">\glsxtractivatenopost</span>.)
-</p><!--l. 14802--><p class="indent" > You can also use <span
-class="cmtt-10">\glsxtrglossentry </span>within section headings. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-349">
-\section{\glsxtrglossentry{function}}
-</pre>
-<!--l. 14806--><p class="nopar" > This will use <span
-class="cmtt-10">\glsentryname </span>in PDF bookmarks (if <span
-class="cmtt-10">\texorpdfstring </span>is defined)
-and will use <span
-class="cmtt-10">\glsxtrheadname </span>in page headers and table of contents. (If you&#8217;re using
-a page style or table of contents that doesn&#8217;t use <span
-class="cmtt-10">\markright </span>or <span
-class="cmtt-10">\markbook </span>or
-<span
-class="cmtt-10">\@starttoc </span>then you need to insert <span
-class="cmtt-10">\glsxtrmarkhook </span>and <span
-class="cmtt-10">\@glsxtrinmark </span>at the
-start of the header or table of contents either scoped or afterwards cancelled with
-<span
-class="cmtt-10">\@glsxtrnotinmark </span>and <span
-class="cmtt-10">\glsxtrrestoremarkhook</span>.)
-</p><!--l. 14816--><p class="noindent" >
-</p>
-<!--l. 14816--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">11.5 </span> <a
- id="sec:alias"></a>Entry Aliases</h3>
-<!--l. 14819--><p class="noindent" >An entry can be made an alias of another entry using the <span
-class="cmss-10">alias</span><a
- id="dx1-92001"></a> key. The
-value should be the label of the other term. There&#8217;s no check for the other&#8217;s
-existence when the aliased entry is defined. This is to allow the possibility of
-defining the other entry after the aliased entry. (For example, when used with
-<a
- id="dx1-92002"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span></a>.)
-</p><!--l. 14826--><p class="indent" > If an entry &#x27E8;<span
-class="cmti-10">entry-1</span>&#x27E9; is made an alias of &#x27E8;<span
-class="cmti-10">entry-2</span>&#x27E9; then: </p>
- <ul class="itemize1">
- <li class="itemize">If the <span
-class="cmss-10">see</span><a
- id="dx1-92003"></a> field wasn&#8217;t provided when &#x27E8;<span
-class="cmti-10">entry-1</span>&#x27E9; was defined, the <span
-class="cmss-10">alias</span><a
- id="dx1-92004"></a> key will
- automatically trigger <div class="alltt">
- <div class="obeylines-v">
- <span
-class="cmtt-10">\glssee{</span>&#x27E8;<span
-class="cmitt-10">entry-1</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">entry-2</span>&#x27E9;<span
-class="cmtt-10">}</span>
-</div>
- </div>
- </li>
- <li class="itemize">If the <span
-class="cmss-10">hyperref</span><a
- id="dx1-92005"></a> package has been loaded then <span
-class="cmtt-10">\gls{</span>&#x27E8;<span
-class="cmti-10">entry-1</span>&#x27E9;<span
-class="cmtt-10">} </span>will link to
- &#x27E8;<span
-class="cmti-10">entry-2</span>&#x27E9;&#8217;s target. (Unless the <a
-href="#catattr.targeturl"><span
-class="cmss-10">targeturl</span></a><a
- id="dx1-92006"></a> attribute has been set for &#x27E8;<span
-class="cmti-10">entry-1</span>&#x27E9;&#8217;s
- category.)
- </li>
- <li class="itemize">With <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=off</span><a
- id="dx1-92007"></a> or <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=hybrid</span><a
- id="dx1-92008"></a>, the <span
-class="cmss-10">noindex</span><a
- id="dx1-92009"></a> setting will automatically
- be triggered when referencing &#x27E8;<span
-class="cmti-10">entry-1</span>&#x27E9; with commands like <span
-class="cmtt-10">\gls </span>or
- <span
-class="cmtt-10">\glstext</span>. This prevents &#x27E8;<span
-class="cmti-10">entry-1</span>&#x27E9; from have a <a
- id="dx1-92010"></a><a
-href="#glo:locationlist">location list</a> (aside from
- the cross-reference added with <span
-class="cmtt-10">\glssee</span>) unless it&#8217;s been explicitly
- indexed with <span
-class="cmtt-10">\glsadd </span>or if the indexing has been explicitly set using
- <span
-class="cmtt-10">noindex=false</span>.
-
-
-
- <!--l. 14845--><p class="noindent" >Note that with <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=only</span><a
- id="dx1-92011"></a>, the <a
- id="dx1-92012"></a>location list for aliased entries is controlled
- with <a
- id="dx1-92013"></a><span
-class="cmtt-10">bib2gls</span>&#8217;s settings.</p></li></ul>
-<!--l. 14849--><p class="indent" > The index suppression trigger is performed by
-</p><!--l. 14850--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-92014"></a> <span
-class="cmtt-10">\glsxtrsetaliasnoindex </span></div><hr>
-</p><!--l. 14852--><p class="noindent" >
-This is performed after the default options provided by <span
-class="cmtt-10">\GlsXtrSetDefaultGlsOpts</span><a
- id="dx1-92015"></a>
-have been set. With <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><span
-class="cmss-10">=only</span><a
- id="dx1-92016"></a>, <span
-class="cmtt-10">\glsxtrsetaliasnoindex </span>will default to do
-nothing.
-</p><!--l. 14858--><p class="indent" > Within the definition of <span
-class="cmtt-10">\glsxtrsetaliasnoindex </span>you can use
-</p><!--l. 14859--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-92017"></a> <span
-class="cmtt-10">\glsxtrindexaliased </span></div><hr>
-</p><!--l. 14861--><p class="noindent" >
-to index &#x27E8;<span
-class="cmti-10">entry-2</span>&#x27E9;.
-</p><!--l. 14864--><p class="indent" > The index suppression command can be redefined to index the main term instead.
-For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-350">
-\renewcommand{\glsxtrsetaliasnoindex}{%
-&#x00A0;\glsxtrindexaliased
-&#x00A0;\setkeys{glslink}{noindex}%
+<code class="code">@symbol</code>{dual.L,
+ <a id="wrglossary.13660"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{L}}</span>,
+ <a id="wrglossary.13661"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={Lagrangian function}</span>,
+ <a id="wrglossary.13662"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a function of generalized co-ordinates}</span>
}
-</pre>
-<!--l. 14871--><p class="nopar" >
-</p><!--l. 14873--><p class="indent" > The value of the <span
-class="cmss-10">alias</span><a
- id="dx1-92018"></a> field can be accessed using
-</p><!--l. 14874--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-92019"></a> <span
-class="cmtt-10">\glsxtralias{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 14876--><p class="noindent" >
-
-
-
-</p>
-<!--l. 14878--><p class="indent" > </div>
-</p><!--l. 14878--><p class="noindent" ><a
-href="#top">Top</a><div class="chapter"><h2 class="chapterHead">12. <a
- id="sec:onthefly"></a>On-the-Fly Document Definitions</h2>
-</p><!--l. 14881--><p class="indent" > <div class="important" title="Important Note"> The commands described here may superficially look like &#x27E8;<span
-class="cmti-10">word</span>&#x27E9;<span
-class="cmtt-10">\index{</span>&#x27E8;<span
-class="cmti-10">word</span>&#x27E9;<span
-class="cmtt-10">}</span>,
-but they behave rather differently. If you want to use <span
-class="cmtt-10">\index </span>then just use <span
-class="cmtt-10">\index</span>.
-</div>
-</p><!--l. 14886--><p class="noindent" >
-</p><!--l. 14888--><p class="indent" > The <span
-class="cmss-10">glossaries </span>package advises against defining entries in the <span
-class="cmss-10">document</span><a
- id="dx1-93001"></a><a
- id="dx1-93002"></a>
-environment. As mentioned in <a
-href="#sec:pkgopts"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">1.2</span> </a><a
-href="#sec:pkgopts">New or Modified Package Options<!--tex4ht:ref: sec:pkgopts --></a>
-above, this ability is disabled by default with <span
-class="cmss-10">glossaries-extra </span>but can be enabled using
-the <a
-href="#styopt.docdefs"><span
-class="cmss-10">docdefs</span></a><a
- id="dx1-93003"></a> package options.
-</p><!--l. 14894--><p class="indent" > Although this can be problematic, the <span
-class="cmss-10">glossaries-extra </span>package provides a way of
-defining and using entries within the <span
-class="cmss-10">document</span><a
- id="dx1-93004"></a><a
- id="dx1-93005"></a> environment without the tricks used
-with the <a
-href="#styopt.docdefs"><span
-class="cmss-10">docdefs</span></a><a
- id="dx1-93006"></a> option. <span
-class="cmti-10">There are limitations with this approach, so take care with it.</span>
-This function is disabled by default, but can be enabled using the preamble-only
-command:
-</p><!--l. 14900--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-93007"></a> <span
-class="cmtt-10">\GlsXtrEnableOnTheFly </span></div><hr>
-</p><!--l. 14902--><p class="noindent" >
-When used, this defines the commands described below.
-</p><!--l. 14905--><p class="indent" > <div class="important" title="Important Note"> The commands <span
-class="cmtt-10">\glsxtr</span>, <span
-class="cmtt-10">\glsxtrpl</span>, <span
-class="cmtt-10">\Glsxtr </span>and <span
-class="cmtt-10">\Glsxtrpl </span>can&#8217;t be used after
-the glossaries have been displayed (through <span
-class="cmtt-10">\printglossary</span><a
- id="dx1-93008"></a> etc). It&#8217;s best not to
-mix these commands with the standard glossary commands, such as <span
-class="cmtt-10">\gls </span>or there
-may be unexpected results. </div>
-</p><!--l. 14911--><p class="noindent" >
-</p><!--l. 14913--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-93009"></a> <span
-class="cmtt-10">\glsxtr[</span>&#x27E8;<span
-class="cmitt-10">gls-options</span>&#x27E9;<span
-class="cmtt-10">][</span>&#x27E8;<span
-class="cmitt-10">dfn-options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 14915--><p class="noindent" >
-If an entry with the label &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; has already been defined, this just does <span
-class="cmtt-10">\gls</span>
-<span
-class="cmtt-10">[</span>&#x27E8;<span
-class="cmti-10">gls-options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span>. If &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; hasn&#8217;t been defined, this will define the entry using:
-</p><div class="alltt">
-<div class="obeylines-v">
-<span
-class="cmtt-10">\newglossaryentry{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">name={</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">},</span>
-<br /><span
-class="cmtt-10">&#x00A0;category=\glsxtrcat,</span>
-<br /><span
-class="cmtt-10">&#x00A0;description=</span><span
-class="cmsy-10">{</span><span
-class="cmtt-10">\nopostdesc</span><span
-class="cmsy-10">}</span><span
-class="cmtt-10">,</span>
-<br /><span
-class="cmtt-10">&#x00A0;</span>&#x27E8;<span
-class="cmitt-10">dfn-options</span>&#x27E9;<span
-class="cmsy-10">}</span>
-</div>
-</div>
-<!--l. 14927--><p class="indent" > <div class="important" title="Important Note"> The &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; must contain any non-expandable commands, such as formatting
-commands or problematic characters. If the term requires any of these, they must be
-omitted from the &#x27E8;<span
-class="cmti-10">label</span>&#x27E9; and placed in the <span
-class="cmss-10">name</span><a
- id="dx1-93010"></a> key must be provided in the optional
-argument &#x27E8;<span
-class="cmti-10">dfn-options</span>&#x27E9;. </div>
-</p><!--l. 14933--><p class="noindent" >
-
-
-
-</p><!--l. 14935--><p class="indent" > The second optional argument &#x27E8;<span
-class="cmti-10">dfn-options</span>&#x27E9; should be empty if the entry has
-already been defined, since it&#8217;s too late for them. If it&#8217;s not empty, a&#x00A0;warning will be
-generated with
-</p><!--l. 14938--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-93011"></a> <span
-class="cmtt-10">\GlsXtrWarning{</span>&#x27E8;<span
-class="cmitt-10">dfn-options</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 14940--><p class="noindent" >
-</p><!--l. 14942--><p class="indent" > For example, this warning will be generated on the second instance of <span
-class="cmtt-10">\glsxtr</span>
-below:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-351">
-\glsxtr[][plural=geese]{goose}
-&#x00A0;...&#x00A0;later
-\glsxtr[][plural=geese]{goose}
-</pre>
-<!--l. 14948--><p class="nopar" >
-</p><!--l. 14950--><p class="indent" > If you are considering doing something like:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-352">
-\newcommand*{\goose}{\glsxtr[][plural=geese]{goose}}
-\renewcommand*{\GlsXtrWarning}[2]{}
-&#x00A0;...&#x00A0;later
-\goose\&#x00A0;some&#x00A0;more&#x00A0;text&#x00A0;here
-</pre>
-<!--l. 14956--><p class="nopar" > then don&#8217;t bother. It&#8217;s simpler and less problematic to just define the entries in the
-preamble with <span
-class="cmtt-10">\newglossaryentry</span><a
- id="dx1-93012"></a> and then use <span
-class="cmtt-10">\gls </span>in the document.
-</p><!--l. 14961--><p class="indent" > There are plural and case-changing alternatives to <span
-class="cmtt-10">\glsxtr</span>:
-</p><!--l. 14962--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-93013"></a> <span
-class="cmtt-10">\glsxtrpl[</span>&#x27E8;<span
-class="cmitt-10">gls-options</span>&#x27E9;<span
-class="cmtt-10">][</span>&#x27E8;<span
-class="cmitt-10">dfn-options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 14964--><p class="noindent" >
-This is like <span
-class="cmtt-10">\glsxtr </span>but uses <span
-class="cmtt-10">\glspl </span>instead of <span
-class="cmtt-10">\gls</span>.
-</p><!--l. 14967--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-93014"></a> <span
-class="cmtt-10">\Glsxtr[</span>&#x27E8;<span
-class="cmitt-10">gls-options</span>&#x27E9;<span
-class="cmtt-10">][</span>&#x27E8;<span
-class="cmitt-10">dfn-options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 14969--><p class="noindent" >
-This is like <span
-class="cmtt-10">\glsxtr </span>but uses <span
-class="cmtt-10">\Gls </span>instead of <span
-class="cmtt-10">\gls</span>.
-</p><!--l. 14972--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-93015"></a> <span
-class="cmtt-10">\Glsxtrpl[</span>&#x27E8;<span
-class="cmitt-10">gls-options</span>&#x27E9;<span
-class="cmtt-10">][</span>&#x27E8;<span
-class="cmitt-10">dfn-options</span>&#x27E9;<span
-class="cmtt-10">]{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 14974--><p class="noindent" >
-This is like <span
-class="cmtt-10">\glsxtr </span>but uses <span
-class="cmtt-10">\Glspl </span>instead of <span
-class="cmtt-10">\gls</span>.
-</p><!--l. 14977--><p class="indent" > If you use UTF-8 and don&#8217;t want the inconvenient of needing to use an
-ASCII-only label, then it&#8217;s better to use <span class="HoLogo-XeLaTeX"><span class="HoLogo-Xe">X<span class="HoLogo-e">&#x018e;</span></span><span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span></span>&#x00A0;or Lua<span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span>&#x00A0;instead of
-LaTeX&#x00A0;(or pdf<span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span>). If you really desperately want to use UTF-8 entry labels
-without switching to <span class="HoLogo-XeLaTeX"><span class="HoLogo-Xe">X<span class="HoLogo-e">&#x018e;</span></span><span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span></span>&#x00A0;or Lua<span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span>&#x00A0;then there is a starred version of
-<span
-class="cmtt-10">\GlsXtrEnableOnTheFly </span>that allows you to use UTF-8 characters in &#x27E8;<span
-class="cmti-10">label</span>&#x27E9;, but it&#8217;s
-experimental and may not work in some cases.
-</p><!--l. 14986--><p class="indent" > <div class="important" title="Important Note"> If you use the starred version of <span
-class="cmtt-10">\GlsXtrEnableOnTheFly </span>don&#8217;t use any
-commands in the &#x27E8;<span
-class="cmti-10">label</span>&#x27E9;, even if they expand to just text. </div>
-</p><!--l. 14990--><p class="noindent" >
-
-
-
-</p>
-<!--l. 14992--><p class="indent" > </div>
-</p><!--l. 14992--><p class="noindent" ><a
-href="#top">Top</a><div class="chapter"><h2 class="chapterHead">13. <a
- id="sec:supplemental"></a>Supplemental Packages</h2>
-</p><!--l. 14995--><p class="indent" > The <span
-class="cmss-10">glossaries </span>bundle provides additional support packages <span
-class="cmss-10">glossaries-prefix</span><a
- id="dx1-94001"></a> (for
-prefixing) and <span
-class="cmss-10">glossaries-accsupp</span><a
- id="dx1-94002"></a> (for accessibility support). These packages aren&#8217;t
-automatically loaded.
-</p>
-<!--l. 15000--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">13.1 </span> <a
- id="sec:prefix"></a>Prefixes or Determiners</h3>
-<!--l. 15003--><p class="noindent" >If prefixing is required, you can simply load <span
-class="cmss-10">glossaries-prefix</span><a
- id="dx1-95001"></a> after <span
-class="cmss-10">glossaries-extra</span>. For
-example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-353">
-\documentclass{article}
-\usepackage{glossaries-extra}
-\usepackage{glossaries-prefix}
-\makeglossaries
-\newabbreviation
-&#x00A0;[prefix={an\space},
-&#x00A0;prefixfirst={a~}]
-&#x00A0;{svm}{SVM}{support&#x00A0;vector&#x00A0;machine}
-\begin{document}
-First&#x00A0;use:&#x00A0;\pgls{svm}.
-Next&#x00A0;use:&#x00A0;\pgls{svm}.
-\printglossaries
-\end{document}
-</pre>
-<!--l. 15026--><p class="nopar" >
-</p><!--l. 15028--><p class="noindent" >
-</p>
-<!--l. 15028--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">13.2 </span> <a
- id="sec:accsupp"></a>Accessibility Support</h3>
-<!--l. 15031--><p class="noindent" ><div class="important" title="Important Note"> The <span
-class="cmss-10">glossaries-accsupp</span><a
- id="dx1-96001"></a> package is still experimental and so accessibility features are
-liable to change. </div>
-</p><!--l. 15034--><p class="noindent" >
-</p><!--l. 15036--><p class="noindent" >The <span
-class="cmss-10">glossaries-accsupp</span><a
- id="dx1-96002"></a> package needs to be loaded before <span
-class="cmss-10">glossaries-extra </span>or through
-the <a
-href="#styopt.accsupp"><span
-class="cmss-10">accsupp</span></a><a
- id="dx1-96003"></a> package option:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-354">
-\usepackage[accsupp]{glossaries-extra}
-</pre>
-<!--l. 15041--><p class="nopar" > If you don&#8217;t load <span
-class="cmss-10">glossaries-accsupp</span><a
- id="dx1-96004"></a> or you load <span
-class="cmss-10">glossaries-accsupp</span><a
- id="dx1-96005"></a> after <span
-class="cmss-10">glossaries-extra</span>
-the new <span
-class="cmtt-10">\glsaccess</span>&#x27E8;<span
-class="cmti-10">xxx</span>&#x27E9; commands described below will simply be equivalent to the
-corresponding <span
-class="cmtt-10">\glsentry</span>&#x27E8;<span
-class="cmti-10">xxx</span>&#x27E9; commands. Other accessibility features, such as the
-attributes used by <span
-class="cmtt-10">\newabbreviation</span><a
- id="dx1-96006"></a> also won&#8217;t work if <span
-class="cmss-10">glossaries-accsupp</span><a
- id="dx1-96007"></a> is loaded
-too late.
-</p><!--l. 15050--><p class="indent" > The following <span
-class="cmtt-10">\glsaccess</span>&#x27E8;<span
-class="cmti-10">xxx</span>&#x27E9; commands add accessibility information wrapped
-around the corresponding <span
-class="cmtt-10">\glsentry</span>&#x27E8;<span
-class="cmti-10">xxx</span>&#x27E9; commands. There is no check for existence
-of the entry nor do any of these commands add formatting, hyperlinks or indexing
-information.
-</p><!--l. 15055--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96008"></a> <span
-class="cmtt-10">\glsaccessname{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15057--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">name</span><a
- id="dx1-96009"></a> field for the entry identified by &#x27E8;<span
-class="cmti-10">label</span>&#x27E9;.
-</p><!--l. 15061--><p class="indent" > If the <span
-class="cmss-10">glossaries-accsupp</span><a
- id="dx1-96010"></a> package isn&#8217;t loaded, this is simply defined as:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-355">
-\newcommand*{\glsaccessname}[1]{\glsentryname{#1}}
-</pre>
-<!--l. 15065--><p class="nopar" > otherwise it&#8217;s defined as:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-356">
-\newcommand*{\glsaccessname}[1]{%
-&#x00A0;&#x00A0;\glsnameaccessdisplay
-&#x00A0;&#x00A0;{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glsentryname{#1}%
-&#x00A0;&#x00A0;}%
-&#x00A0;&#x00A0;{#1}%
+</pre> but additionally the two entries (the primary <code class="code">L</code> and the dual <code class="code">dual.L</code>) are dependent. The following document only references the primary entry, but the dependency ensures that that the dual is also selected: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.13663"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>,<a id="wrglossary.13664"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a>,<a id="wrglossary.13665"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>,
+ <a id="wrglossary.13666"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a><span class="optfmt">={tree,bookindex}</span>]{glossaries-extra}
+<a id="wrglossary.13667"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.13668"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">=entries</span>,<a id="wrglossary.13669"></a><a href="#glo:opt.resource.dual-type"><span class="csoptfmt">dual-type</span></a><span class="optfmt">=symbols</span>]
+<a id="wrglossary.13670"></a><a href="#glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></a>{index}{<a id="wrglossary.13671"></a><a href="#glo:glsxtrpostlinkAddDescOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddDescOnFirstUse</code></a>}
+<a id="wrglossary.13672"></a><a href="#glo:glsdefpostname"><code class="csfmt">\glsdefpostname</code></a>{index}{%
+ <a id="wrglossary.13673"></a><a href="#glo:ifglshassymbol"><code class="csfmt">\ifglshassymbol</code></a>{<a id="wrglossary.13674"></a><a href="#glo:glscurrententrylabel"><code class="csfmt">\glscurrententrylabel</code></a>}
+ { (<a id="wrglossary.13675"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a>{<a id="wrglossary.13676"></a><a href="#glo:glscurrententrylabel"><code class="csfmt">\glscurrententrylabel</code></a>})}{}}
+<code class="cbeg">\begin{document}</code>
+Primary: <a id="wrglossary.13677"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{L}.
+<a id="wrglossary.13678"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<a id="wrglossary.13679"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=symbols</span>,<a id="wrglossary.13680"></a><a href="#glo:opt.printgloss.style"><span class="csoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.13681"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a></span>]
+<a id="wrglossary.13682"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<a id="wrglossary.13683"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a><span class="optfmt">=Index</span>,<a id="wrglossary.13684"></a><a href="#glo:opt.printgloss.style"><span class="csoptfmt">style</span></a><span class="optfmt">=bookindex</span>]
+<code class="cend">\end{document}</code>
+</pre> The dependency ensures that the dual entry <code class="code">dual.L</code> is selected, and the <a id="wrglossary.13685"></a><a href="#glo:opt.resource.dual-type"><span class="csoptfmt">dual-type</span></a> setting adds the dual entry to the <code class="code">symbols</code> glossary (which was defined with the <a id="wrglossary.13686"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a> package option).<p>
+It may be useful to have a hyperlink from the entry in one <a id="wrglossary.13687"></a><a href="#glo:dual.glossary">glossary</a> to its dependent in the other <a id="wrglossary.13688"></a><a href="#glo:dual.glossary">glossary</a>. This can be achieved by instructing <a id="wrglossary.13689"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to save the label of the entry’s opposite using <a id="wrglossary.13690"></a><a href="#glo:opt.resource.dual-field"><span class="csoptfmt">dual-field</span></a>. The value of this <a id="wrglossary.13691"></a><a href="#glo:idx.resourceopt">resource option</a> indicates the field in which to save the label. If omitted, <code class="code">dual</code> is assumed. <p>
+The <a id="wrglossary.13692"></a><a href="#glo:idx.glossarystyle">glossary style</a> can then be adapted to check if the field has been set and, if so, to create a hyperlink. The following command is provided to assist with this: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13693"></a><code class="code"><dfn id="glo:GlsXtrDualBackLink"><code class="csfmt">\GlsXtrDualBackLink</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is defined as: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.13694"></a><a href="#glo:GlsXtrDualBackLink"><code class="csfmt">\GlsXtrDualBackLink</code></a>}[2]{%
+ <a id="wrglossary.13695"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a>{<a id="wrglossary.13696"></a><a href="#glo:GlsXtrDualField"><code class="csfmt">\GlsXtrDualField</code></a>}{#2}%
+ {<a id="wrglossary.13697"></a><a href="#glo:glshyperlink"><code class="csfmt">\glshyperlink</code></a>[#1]{<a id="wrglossary.13698"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a>}}%
+ {#1}%
}
-</pre>
-<!--l. 15075--><p class="nopar" > (<span
-class="cmtt-10">\glsnameaccessdisplay</span><a
- id="dx1-96011"></a> is defined by the <span
-class="cmss-10">glossaries-accsupp</span><a
- id="dx1-96012"></a> package.) The first
-letter upper case version is:
-</p><!--l. 15079--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96013"></a> <span
-class="cmtt-10">\Glsaccessname{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15081--><p class="noindent" >
-Without the <span
-class="cmss-10">glossaries-accsupp</span><a
- id="dx1-96014"></a> package this is just defined as:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-357">
-\newcommand*{\Glsaccessname}[1]{\Glsentryname{#1}}
-</pre>
-<!--l. 15086--><p class="nopar" > With the <span
-class="cmss-10">glossaries-accsupp</span><a
- id="dx1-96015"></a> package this is defined as:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-358">
-\newcommand*{\Glsaccessname}[1]{%
-&#x00A0;&#x00A0;\glsnameaccessdisplay
-&#x00A0;&#x00A0;{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\Glsentryname{#1}%
-&#x00A0;&#x00A0;}%
-&#x00A0;&#x00A0;{#1}%
+</pre> This obtains the field from: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13699"></a><code class="code"><dfn id="glo:GlsXtrDualField"><code class="csfmt">\GlsXtrDualField</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>dual</span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This expands to <code class="code">dual</code>, which is the default for <a id="wrglossary.13700"></a><a href="#glo:opt.resource.dual-field"><span class="csoptfmt">dual-field</span></a> if no value is supplied.<p>
+The above example can be adapted as follows: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[colorlinks]{hyperref}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.13701"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>,<a id="wrglossary.13702"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a>,<a id="wrglossary.13703"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>,<a id="wrglossary.13704"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a><span class="optfmt">={tree,bookindex}</span>]{glossaries-extra}
+<a id="wrglossary.13705"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.13706"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">=entries</span>, <a id="wrglossary.13707"></a><a href="#glo:opt.resource.dual-type"><span class="csoptfmt">dual-type</span></a><span class="optfmt">=symbols</span>,<a id="wrglossary.13708"></a><a href="#glo:opt.resource.dual-field"><span class="csoptfmt">dual-field</span></a>]
+<a id="wrglossary.13709"></a><a href="#glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></a>{index}{<a id="wrglossary.13710"></a><a href="#glo:glsxtrpostlinkAddSymbolOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddSymbolOnFirstUse</code></a>}
+<a id="wrglossary.13711"></a><a href="#glo:glsdefpostname"><code class="csfmt">\glsdefpostname</code></a>{index}{%
+ <a id="wrglossary.13712"></a><a href="#glo:ifglshassymbol"><code class="csfmt">\ifglshassymbol</code></a>{<a id="wrglossary.13713"></a><a href="#glo:glscurrententrylabel"><code class="csfmt">\glscurrententrylabel</code></a>}
+ { (<a id="wrglossary.13714"></a><a href="#glo:GlsXtrDualBackLink"><code class="csfmt">\GlsXtrDualBackLink</code></a>{<a id="wrglossary.13715"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a>{<a id="wrglossary.13716"></a><a href="#glo:glscurrententrylabel"><code class="csfmt">\glscurrententrylabel</code></a>}}{<a id="wrglossary.13717"></a><a href="#glo:glscurrententrylabel"><code class="csfmt">\glscurrententrylabel</code></a>})}{}}
+<code class="cbeg">\begin{document}</code>
+Primary: <a id="wrglossary.13718"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{L}.
+<a id="wrglossary.13719"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<a id="wrglossary.13720"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=symbols</span>,<a id="wrglossary.13721"></a><a href="#glo:opt.printgloss.style"><span class="csoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.13722"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a></span>]
+<a id="wrglossary.13723"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<a id="wrglossary.13724"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a><span class="optfmt">=Index</span>,<a id="wrglossary.13725"></a><a href="#glo:opt.printgloss.style"><span class="csoptfmt">style</span></a><span class="optfmt">=bookindex</span>]
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:bib2glsdualbacklinks"></a>Example 158: Using <span class="appfmt">bib2gls</span>: dual backlinks <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example158.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example158.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example158.png" type="image/png" width="319" height="146">Example document that has backlinks in the glossaries between the primary and dual entries.</object> </div><!-- end of resultbox -->
+ This checks if the <a id="wrglossary.13726"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> key has been set in both the <a id="wrglossary.13727"></a><a href="#glo:dual.catpostlinkhook">category post-link hook</a> and the <a id="wrglossary.13728"></a><a href="#glo:dual.catpostnamehook">category post-name hook</a> to append the symbol in parentheses. In addition, the <a id="wrglossary.13729"></a><a href="#glo:dual.catpostnamehook">category post-name hook</a> adds a link to the corresponding dual entry.<p>
+If you prefer instead to have the backlink on the <a id="wrglossary.13730"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> in both <a id="wrglossary.13731"></a><a href="#glo:dual.glossary">glossaries</a>, then this can more easily be achieved with a <a id="wrglossary.13732"></a><a href="#glo:idx.resourceopt">resource option</a> such as <a id="wrglossary.13733"></a><a href="#glo:opt.resource.dual-backlink"><span class="csoptfmt">dual-backlink</span></a>.<p>
+The commands described below were designed for use with <a id="wrglossary.13734"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span>’s</a> dual entries, but may also be used in other contexts where a label may potentially have a number of possible prefixes.<p>
+It’s possible to use commands like <a id="wrglossary.13735"></a><a href="#glo:glsxtrnewgls"><code class="csfmt">\glsxtrnewgls</code></a> to create <a id="wrglossary.13736"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands that automatically insert a label prefix (such as <code class="code">dual.</code> for dual entries). The commands described in this section provide a similar set of <a id="wrglossary.13737"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands that iterate over a set of possible prefixes until a match is found.<p>
+Each possible prefix (which may be empty) is identified by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13738"></a><code class="code"><dfn id="glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></dfn>{<span class="meta">〈<em class="metainner">label-prefix</em>〉</span>}</code></div><!-- end of pinnedbox -->
+{prefix} These should be listed in order of precedence.<p>
+You can prepend a prefix to the list using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13739"></a><code class="code"><dfn id="glo:glsxtrprependlabelprefix"><code class="csfmt">\glsxtrprependlabelprefix</code></dfn>{<span class="meta">〈<em class="metainner">label-prefix</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which gives it the highest order of precedence.<p>
+The list of known prefixes can be (locally) cleared with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13740"></a><code class="code"><dfn id="glo:glsxtrclearlabelprefixes"><code class="csfmt">\glsxtrclearlabelprefixes</code></dfn></code></div><!-- end of pinnedbox -->
+<p>
+You can test if a prefix is already in the list with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13741"></a><code class="code"><dfn id="glo:glsxtrifinlabelprefixlist"><code class="csfmt">\glsxtrifinlabelprefixlist</code></dfn>{<span class="meta">〈<em class="metainner">label-prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This does <span class="meta">〈<em class="metainner">true</em>〉</span> if the given prefix has been added to the list. No expansion is performed on <span class="meta">〈<em class="metainner">label-prefix</em>〉</span>.<p>
+In the event that there’s no match for any of the prefixes (which will occur on the first LaTeX run before the <a id="wrglossary.13742"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file has been created), the fallback is determined by the conditional: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13743"></a><code class="code"><dfn id="glo:ifGlsXtrPrefixLabelFallbackLast"><code class="csfmt">\ifGlsXtrPrefixLabelFallbackLast</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\iftrue</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ If true, this will fallback on the last prefix, otherwise it will fallback on the first. This conditional can be set to true with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13744"></a><code class="code"><dfn id="glo:GlsXtrPrefixLabelFallbackLasttrue"><code class="csfmt">\GlsXtrPrefixLabelFallbackLasttrue</code></dfn></code></div><!-- end of pinnedbox -->
+ and to false with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13745"></a><code class="code"><dfn id="glo:GlsXtrPrefixLabelFallbackLastfalse"><code class="csfmt">\GlsXtrPrefixLabelFallbackLastfalse</code></dfn></code></div><!-- end of pinnedbox -->
+ The default is true.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+As from v1.49, all possible matches will be <a id="wrglossary.13746"></a><a href="#glo:@@glslabel@indexing">recorded</a> using a special syntax if none are found. This ensures there will be at least one match on the first run. However, note that this requires <a id="wrglossary.13747"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v3.0+. </div><!-- end of information -->
+<p>
+In general it’s best to avoid adding multiple instances of the same prefix, so you can check with this command before adding a prefix to the list. However, it can be useful to repeat a prefix at the start or end of the list so that it can be used as a fallback for entries that haven’t yet been defined.<p>
+With the list of possible prefixes set up (including an empty prefix if necessary), you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13748"></a><code class="code"><dfn id="glo:dgls"><code class="csfmt">\dgls</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.13749"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.13750"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.13751"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ which behaves like <pre class="compactcodebox"><a id="wrglossary.13752"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span>{entry-label}}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]
+</pre> where <span class="meta">〈<em class="metainner">prefix</em>〉</span> is the first prefix in the list such that <span class="meta">〈<em class="metainner">prefix</em>〉</span><span class="meta">〈<em class="metainner">label</em>〉</span> matches a defined entry. This requires <a id="wrglossary.13753"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v3.0+ to work properly on the first LaTeX run (when no entries are defined).<p>
+There are also analogous commands for the plural and case-changing versions: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13754"></a><code class="code"><dfn id="glo:dglspl"><code class="csfmt">\dglspl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.13755"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.13756"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.13757"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ (uses <a id="wrglossary.13758"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>), <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13759"></a><code class="code"><dfn id="glo:dGls"><code class="csfmt">\dGls</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.13760"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.13761"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.13762"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ (uses <a id="wrglossary.13763"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>), <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13764"></a><code class="code"><dfn id="glo:dGlspl"><code class="csfmt">\dGlspl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.13765"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.13766"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.13767"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ (uses <a id="wrglossary.13768"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a>), <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13769"></a><code class="code"><dfn id="glo:dGLS"><code class="csfmt">\dGLS</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.13770"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.13771"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.13772"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ (uses <a id="wrglossary.13773"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a>), <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13774"></a><code class="code"><dfn id="glo:dGLSpl"><code class="csfmt">\dGLSpl</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.13775"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.13776"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.13777"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ (uses <a id="wrglossary.13778"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a>), <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13779"></a><code class="code"><dfn id="glo:dglslink"><code class="csfmt">\dglslink</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.13780"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.13781"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.13782"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ (uses <a id="wrglossary.13783"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a>), <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13784"></a><code class="code"><dfn id="glo:dGlslink"><code class="csfmt">\dGlslink</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.13785"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.13786"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.13787"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ (uses <a id="wrglossary.13788"></a><a href="#glo:Glslink"><code class="csfmt">\Glslink</code></a>), <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13789"></a><code class="code"><dfn id="glo:dglsdisp"><code class="csfmt">\dglsdisp</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.13790"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.13791"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.13792"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ (uses <a id="wrglossary.13793"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a>) and <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13794"></a><code class="code"><dfn id="glo:dGlsdisp"><code class="csfmt">\dGlsdisp</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.13795"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.13796"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.13797"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ (uses <a id="wrglossary.13798"></a><a href="#glo:Glsdisp"><code class="csfmt">\Glsdisp</code></a>).<p>
+If you want to use a specific field you can instead use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13799"></a><code class="code"><dfn id="glo:dglsfield"><code class="csfmt">\dglsfield</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.13800"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.13801"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.13802"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This will find the first match that has the given field set (that is, the field value has been defined and is not empty or <a id="wrglossary.13803"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a>). The field should be identified by its <a id="wrglossary.13804"></a><a href="#glo:dual.internalfieldlabel">internal field label</a>. There are also case-changing versions: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13805"></a><code class="code"><dfn id="glo:dGlsfield"><code class="csfmt">\dGlsfield</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.13806"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.13807"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.13808"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ which applies a <a id="wrglossary.13809"></a><a href="#glo:idx.sentencecase">sentence case</a> change and <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13810"></a><code class="code"><dfn id="glo:dGLSfield"><code class="csfmt">\dGLSfield</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.13811"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.13812"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.13813"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ which applies <a id="wrglossary.13814"></a><a href="#glo:idx.allcaps">all caps</a>. Note that at least one of the potential labels must have the given field set in order for the reference to be correctly resolved. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.13815"></a><a href="#glo:dglsfield"><code class="csfmt">\dglsfield</code></a>{pi}{symbol}
+</pre> If you find this a bit long-winded to type and you want to provide a shorter command that recognises the modifiers, then you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13816"></a><code class="code"><dfn id="glo:newdglsfield"><code class="csfmt">\newdglsfield</code></dfn>[<span class="meta">〈<em class="metainner">default-options</em>〉</span>]{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.13817"></a><a href="#glo:newdglsfield"><code class="csfmt">\newdglsfield</code></a>{symbol}{<code class="cmd">\sym</code>}
+<code class="cmd">\sym</code>{pi}
+</pre> If you also want <a id="wrglossary.13818"></a><a href="#glo:idx.sentencecase">sentence case</a> and <a id="wrglossary.13819"></a><a href="#glo:idx.allcaps">all caps</a> versions use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13820"></a><code class="code"><dfn id="glo:newdglsfieldlike"><code class="csfmt">\newdglsfieldlike</code></dfn>[<span class="meta">〈<em class="metainner">default-options</em>〉</span>]{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">Cs</em>〉</span>}{<span class="meta">〈<em class="metainner">CS</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">cs</em>〉</span> is the command without a case-change (which will use <a id="wrglossary.13821"></a><a href="#glo:dglsfield"><code class="csfmt">\dglsfield</code></a>), <span class="meta">〈<em class="metainner">Cs</em>〉</span> is the <a id="wrglossary.13822"></a><a href="#glo:idx.sentencecase">sentence case</a> command (which will use <a id="wrglossary.13823"></a><a href="#glo:dGlsfield"><code class="csfmt">\dGlsfield</code></a>) and <span class="meta">〈<em class="metainner">CS</em>〉</span> is the <a id="wrglossary.13824"></a><a href="#glo:idx.allcaps">all caps</a> command (which will use <a id="wrglossary.13825"></a><a href="#glo:dGLSfield"><code class="csfmt">\dGLSfield</code></a>). This will also use <a id="wrglossary.13826"></a><a href="#glo:glsmfuaddmap"><code class="csfmt">\glsmfuaddmap</code></a> and <a id="wrglossary.13827"></a><a href="#glo:glsmfublocker"><code class="csfmt">\glsmfublocker</code></a> to establish the <a id="wrglossary.13828"></a><a href="#glo:idx.sentencecase">sentence case</a> mapping from <span class="meta">〈<em class="metainner">cs</em>〉</span> to <span class="meta">〈<em class="metainner">Cs</em>〉</span> and block the <a id="wrglossary.13829"></a><a href="#glo:idx.casechange">case change</a> for <span class="meta">〈<em class="metainner">CS</em>〉</span>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+No expansion is performed on <span class="meta">〈<em class="metainner">default-options</em>〉</span> or <span class="meta">〈<em class="metainner">field</em>〉</span> while the new commands are being defined. </div><!-- end of information -->
+<p>
+This family of <a id="wrglossary.13830"></a><a href="#glo:dglsfield"><code class="csfmt">\dglsfield</code></a> commands all define: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13831"></a><code class="code"><dfn id="glo:dglsfieldcurrentfieldlabel"><code class="csfmt">\dglsfieldcurrentfieldlabel</code></dfn></code></div><!-- end of pinnedbox -->
+ This expands to the given field label.<p>
+If the requested field isn’t set (according to <a id="wrglossary.13832"></a><a href="#glo:ifcsvoid"><code class="csfmt">\ifcsvoid</code></a>) then the fallback field will be tried instead. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13833"></a><code class="code"><dfn id="glo:dglsfieldfallbackfieldlabel"><code class="csfmt">\dglsfieldfallbackfieldlabel</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This expands to the fallback field, which defaults to the <a id="wrglossary.13834"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field.<p>
+If you need to know whether the requested field or the fallback field was used, the following will be set to the actual field used. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13835"></a><code class="code"><dfn id="glo:dglsfieldactualfieldlabel"><code class="csfmt">\dglsfieldactualfieldlabel</code></dfn></code></div><!-- end of pinnedbox -->
+<p>
+For example, suppose the file <span class="filefmt">entries.bib</span> contains: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="code">@index</code>{duck}
+<code class="code">@dualindexabbreviation</code>{svm,
+ <a id="wrglossary.13836"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a><span class="optfmt">={SVM}</span>,
+ <a id="wrglossary.13837"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a><span class="optfmt">={support vector machine}</span>
}
-</pre>
-<!--l. 15096--><p class="nopar" >
-</p><!--l. 15098--><p class="indent" > The following commands are all defined in an analogous manner.
-</p><!--l. 15099--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96016"></a> <span
-class="cmtt-10">\glsaccesstext{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15101--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">text</span><a
- id="dx1-96017"></a> field.
-</p><!--l. 15104--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96018"></a> <span
-class="cmtt-10">\Glsaccesstext{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15106--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">text</span><a
- id="dx1-96019"></a> field with the first letter converted to upper
-case.
-</p><!--l. 15110--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96020"></a> <span
-class="cmtt-10">\glsaccessplural{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15112--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">plural</span><a
- id="dx1-96021"></a> field.
-</p><!--l. 15115--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96022"></a> <span
-class="cmtt-10">\Glsaccessplural{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15117--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">plural</span><a
- id="dx1-96023"></a> field with the first letter converted to upper
-case.
-</p><!--l. 15121--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96024"></a> <span
-class="cmtt-10">\glsaccessfirst{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15123--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">first</span><a
- id="dx1-96025"></a> field.
-</p><!--l. 15126--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96026"></a> <span
-class="cmtt-10">\Glsaccessfirst{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15128--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">first</span><a
- id="dx1-96027"></a> field with the first letter converted to upper
-case.
-</p><!--l. 15132--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96028"></a> <span
-class="cmtt-10">\glsaccessfirstplural{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15134--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">firstplural</span><a
- id="dx1-96029"></a> field.
-</p><!--l. 15137--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96030"></a> <span
-class="cmtt-10">\Glsaccessfirstplural{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15139--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">firstplural</span><a
- id="dx1-96031"></a> field with the first letter converted to upper
-case.
-</p><!--l. 15143--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96032"></a> <span
-class="cmtt-10">\glsaccesssymbol{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15145--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">symbol</span><a
- id="dx1-96033"></a> field.
-</p><!--l. 15148--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96034"></a> <span
-class="cmtt-10">\Glsaccesssymbol{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-
-
-
-</p><!--l. 15150--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">symbol</span><a
- id="dx1-96035"></a> field with the first letter converted to upper
-case.
-</p><!--l. 15154--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96036"></a> <span
-class="cmtt-10">\glsaccesssymbolplural{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15156--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">symbolplural</span><a
- id="dx1-96037"></a> field.
-</p><!--l. 15159--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96038"></a> <span
-class="cmtt-10">\Glsaccesssymbolplural{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15161--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">symbolplural</span><a
- id="dx1-96039"></a> field with the first letter converted to
-upper case.
-</p><!--l. 15165--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96040"></a> <span
-class="cmtt-10">\glsaccessdesc{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15167--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">description</span><a
- id="dx1-96041"></a> field.
-</p><!--l. 15170--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96042"></a> <span
-class="cmtt-10">\Glsaccessdesc{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15172--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">description</span><a
- id="dx1-96043"></a> field with the first letter converted to upper
-case.
-</p><!--l. 15176--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96044"></a> <span
-class="cmtt-10">\glsaccessdescplural{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15178--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">descriptionplural</span><a
- id="dx1-96045"></a> field.
-</p><!--l. 15181--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96046"></a> <span
-class="cmtt-10">\Glsaccessdescplural{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15183--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">descriptionplural</span><a
- id="dx1-96047"></a> field with the first letter converted to
-upper case.
-</p><!--l. 15187--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96048"></a> <span
-class="cmtt-10">\glsaccessshort{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15189--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">short</span><a
- id="dx1-96049"></a> field.
-</p><!--l. 15192--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96050"></a> <span
-class="cmtt-10">\Glsaccessshort{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15194--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">short</span><a
- id="dx1-96051"></a> field with the first letter converted to upper
-case.
-</p><!--l. 15198--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96052"></a> <span
-class="cmtt-10">\glsaccessshortpl{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15200--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">shortplural</span><a
- id="dx1-96053"></a> field.
-</p><!--l. 15203--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96054"></a> <span
-class="cmtt-10">\Glsaccessshortpl{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15205--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">shortplural</span><a
- id="dx1-96055"></a> field with the first letter converted to upper
-case.
-</p><!--l. 15209--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96056"></a> <span
-class="cmtt-10">\glsaccesslong{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15211--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">long</span><a
- id="dx1-96057"></a> field.
-</p><!--l. 15214--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96058"></a> <span
-class="cmtt-10">\Glsaccesslong{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15216--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">long</span><a
- id="dx1-96059"></a> field with the first letter converted to upper
-case.
-</p><!--l. 15220--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96060"></a> <span
-class="cmtt-10">\glsaccesslongpl{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-
-
-
-</p><!--l. 15222--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">longplural</span><a
- id="dx1-96061"></a> field.
-</p><!--l. 15225--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-96062"></a> <span
-class="cmtt-10">\Glsaccesslongpl{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15227--><p class="noindent" >
-This displays the value of the <span
-class="cmss-10">longplural</span><a
- id="dx1-96063"></a> field with the first letter converted to upper
-case.
-
-
-
-</p>
-<!--l. 15231--><p class="indent" > </div>
-</p><!--l. 15231--><p class="noindent" ><a
-href="#top">Top</a><div class="chapter"><h2 class="chapterHead">14. <a
- id="sec:samples"></a>Sample Files</h2>
-</p><!--l. 15234--><p class="indent" > The following sample files are provided with this package:
- </p><dl class="description"><dt class="description">
-<span
-class="cmbx-10">sample.tex</span> </dt><dd
-class="description">Simple sample file that uses one of the dummy files provided by
- the <span
-class="cmss-10">glossaries </span>package for testing.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-abbr-styles.tex</span> </dt><dd
-class="description">Demonstrates all predefined abbreviation styles.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-mixture.tex</span> </dt><dd
-class="description">General entries, acronyms and initialisms all treated
- differently.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-name-font</span> </dt><dd
-class="description">Categories and attributes are used to customize the way
- different entries appear.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-abbrv.tex</span> </dt><dd
-class="description">General abbreviations.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-acronym.tex</span> </dt><dd
-class="description">Acronyms aren&#8217;t initialisms and don&#8217;t expand on <a
- id="dx1-97001"></a><a
-href="#glo:firstuse">first
- use</a>.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-acronym-desc.tex</span> </dt><dd
-class="description">Acronyms that have a separate long form and
- description.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-crossref.tex</span> </dt><dd
-class="description">Unused entries that have been cross-referenced
- automatically are added at the end of the document.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-indexhook.tex</span> </dt><dd
-class="description">Use the index hook to track which entries have been
- indexed (and therefore find out which ones haven&#8217;t been indexed).
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-footnote.tex</span> </dt><dd
-class="description">Footnote abbreviation style that moves the footnote
- marker outside of the hyperlink generated by <span
-class="cmtt-10">\gls </span>and moves it after
- certain punctuation characters for neatness.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-undef.tex</span> </dt><dd
-class="description">Warn on undefined entries instead of generating an error.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-mixed-abbrv-styles.tex</span> </dt><dd
-class="description">Different abbreviation styles for different
- entries.
-
-
-
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-initialisms.tex</span> </dt><dd
-class="description">Automatically insert dots into initialisms.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-postdot.tex</span> </dt><dd
-class="description">Another initialisms example.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-postlink.tex</span> </dt><dd
-class="description">Automatically inserting text after the <a
- id="dx1-97002"></a><a
-href="#glo:linktext">link-text</a>
- produced by commands like <span
-class="cmtt-10">\gls </span>(outside of hyperlink, if present).
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-header.tex</span> </dt><dd
-class="description">Using entries in section/chapter headings.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-autoindex.tex</span> </dt><dd
-class="description">Using the <a
-href="#catattr.dualindex"><span
-class="cmss-10">dualindex</span></a><a
- id="dx1-97003"></a> and <a
-href="#catattr.indexname"><span
-class="cmss-10">indexname</span></a><a
- id="dx1-97004"></a> attributes to
- automatically add glossary entries to the index (in addition to the glossary
- <a
- id="dx1-97005"></a><a
-href="#glo:locationlist">location list</a>).
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-autoindex-hyp.tex</span> </dt><dd
-class="description">As previous but uses <span
-class="cmss-10">hyperref</span><a
- id="dx1-97006"></a>.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-nested.tex</span> </dt><dd
-class="description">Using <span
-class="cmtt-10">\gls</span><a
- id="dx1-97007"></a> within the value of the <span
-class="cmss-10">name</span><a
- id="dx1-97008"></a> key.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-entrycount.tex</span> </dt><dd
-class="description">Enable entry-use counting (only index if used more
- than <span
-class="cmmi-10">n </span>times, see <a
-href="#sec:entrycount"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">8.1</span> </a><a
-href="#sec:entrycount">Entry Counting (First Use Flag)<!--tex4ht:ref: sec:entrycount --></a>).
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-unitentrycount.tex</span> </dt><dd
-class="description">Enable use of per-unit entry-use counting
- (<a
-href="#sec:entrycount"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">8.1</span> </a><a
-href="#sec:entrycount">Entry Counting (First Use Flag)<!--tex4ht:ref: sec:entrycount --></a>).
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-onelink.tex</span> </dt><dd
-class="description">Using the per-unit entry counting (<a
-href="#sec:entrycount"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">8.1</span>
- </a><a
-href="#sec:entrycount">Entry Counting (First Use Flag)<!--tex4ht:ref: sec:entrycount --></a>) to only have one hyperlink per entry
- per page.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-linkcount.tex</span> </dt><dd
-class="description">Using link counting (<a
-href="#sec:linkcount"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">8.2</span> </a><a
-href="#sec:linkcount">Link Counting<!--tex4ht:ref: sec:linkcount --></a>)
- to only have one hyperlink per entry.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-pages.tex</span> </dt><dd
-class="description">Insert &#8220;page&#8221; or &#8220;pages&#8221; before the location list.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-altmodifier.tex</span> </dt><dd
-class="description">Set the default options for commands like <span
-class="cmtt-10">\gls </span>and
- add an alternative modifier.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-mixedsort.tex</span> </dt><dd
-class="description">Uses the optional argument of <span
-class="cmtt-10">\makeglossaries </span>to
- allow a mixture of <span
-class="cmtt-10">\printglossary </span>and <span
-class="cmtt-10">\printnoidxglossary</span>.
-
-
-
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-external.tex</span> </dt><dd
-class="description">Uses the <a
-href="#catattr.targeturl"><span
-class="cmss-10">targeturl</span></a><a
- id="dx1-97009"></a> attribute to allow for entries that
- should link to an external URL rather than to an internal glossary.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-fmt.tex</span> </dt><dd
-class="description">Provides text-block commands associated with entries in
- order to use <span
-class="cmtt-10">\glsxtrfmt</span>.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-alias.tex</span> </dt><dd
-class="description">Uses the <span
-class="cmss-10">alias</span><a
- id="dx1-97010"></a> key. (See <a
-href="#sec:alias"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">11.5</span> </a><a
-href="#sec:alias">Entry Aliases<!--tex4ht:ref: sec:alias --></a>.)
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-alttree.tex</span> </dt><dd
-class="description">Uses the <span
-class="cmss-10">glossaries-extra-stylemods</span><a
- id="dx1-97011"></a> package with the <span
-class="cmss-10">alttree</span><a
- id="dx1-97012"></a>
- style (see <a
-href="#sec:stylemods"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">2.11.3</span> </a><a
-href="#sec:stylemods">The glossaries-extra-stylemods Package<!--tex4ht:ref: sec:stylemods --></a>).
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-alttree-sym.tex</span> </dt><dd
-class="description">Another <span
-class="cmss-10">alttree</span><a
- id="dx1-97013"></a> example that measures the symbol
- widths.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-alttree-marginpar.tex</span> </dt><dd
-class="description">Another <span
-class="cmss-10">alttree</span><a
- id="dx1-97014"></a> example that puts the
- <a
- id="dx1-97015"></a><a
-href="#glo:numberlist">number list</a> in the margin.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-onthefly.tex</span> </dt><dd
-class="description">Using on-the-fly commands. Terms with accents must
- have the <span
-class="cmss-10">name</span><a
- id="dx1-97016"></a> key explicitly set.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-onthefly-xetex.tex</span> </dt><dd
-class="description">Using on-the-fly commands with <span class="HoLogo-XeLaTeX"><span class="HoLogo-Xe">X<span class="HoLogo-e">&#x018e;</span></span><span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span></span>.
- Terms with UTF-8 characters don&#8217;t need to have the <span
-class="cmss-10">name</span><a
- id="dx1-97017"></a> key explicitly
- set. Terms that contain commands must have the <span
-class="cmss-10">name</span><a
- id="dx1-97018"></a> key explicitly set
- with the commands removed from the label.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-onthefly-utf8.tex</span> </dt><dd
-class="description">Tries to emulate the previous sample file for use
- with LaTeX&#x00A0;through the starred version of <span
-class="cmtt-10">\GlsXtrEnableOnTheFly</span><a
- id="dx1-97019"></a>.
- This is a bit iffy and may not always work. Terms that contain commands
- must have the <span
-class="cmss-10">name</span><a
- id="dx1-97020"></a> key explicitly set with the commands removed from
- the label.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-accsupp.tex</span> </dt><dd
-class="description">Integrate <span
-class="cmss-10">glossaries-accsupp</span><a
- id="dx1-97021"></a>.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-prefix.tex</span> </dt><dd
-class="description">Integrate <span
-class="cmss-10">glossaries-prefix</span><a
- id="dx1-97022"></a>.
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-suppl-main.tex</span> </dt><dd
-class="description">Uses <span
-class="cmss-10">thevalue</span><a
- id="dx1-97023"></a> to reference a location in the
- supplementary file <span
-class="cmtt-10">sample-suppl.tex</span>.
-
-
-
- </dd><dt class="description">
-<span
-class="cmbx-10">sample-suppl-main-hyp.tex</span> </dt><dd
-class="description">A more complicated version to the above that
- uses the <span
-class="cmss-10">hyperref</span><a
- id="dx1-97024"></a> package to reference a location in the supplementary file
- <span
-class="cmtt-10">sample-suppl-hyp.tex</span>.
- </dd></dl>
-
-
-
-<!--l. 15366--><p class="indent" > </div>
-</p><!--l. 15366--><p class="noindent" ><a
-href="#top">Top</a><div class="chapter"><h2 class="chapterHead">15. <a
- id="sec:lang"></a>Multi-Lingual Support</h2>
-</p><!--l. 15369--><p class="indent" > There&#8217;s only one command provided by <span
-class="cmss-10">glossaries-extra </span>that you&#8217;re likely to want
-to change in your document and that&#8217;s <span
-class="cmtt-10">\abbreviationsname</span><a
- id="dx1-98001"></a> (<a
-href="#sec:pkgopts"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">1.2</span> </a><a
-href="#sec:pkgopts">New or
-Modified Package Options<!--tex4ht:ref: sec:pkgopts --></a>) if you use the <a
-href="#styopt.abbreviations"><span
-class="cmss-10">abbreviations</span></a><a
- id="dx1-98002"></a> package option to
-automatically create the glossary labelled <span
-class="cmtt-10">abbreviations</span>. If this command
-doesn&#8217;t already exist, it will be defined to &#8220;Abbreviations&#8221; if <span
-class="cmss-10">babel</span><a
- id="dx1-98003"></a> hasn&#8217;t
-been loaded, otherwise it will be defined as <span
-class="cmtt-10">\acronymname </span>(provided by
-<span
-class="cmss-10">glossaries</span>).
-</p><!--l. 15379--><p class="indent" > You can redefine it in the usual way. For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-359">
-\renewcommand*{\abbreviationsname}{List&#x00A0;of&#x00A0;Abbreviations}
-</pre>
-<!--l. 15382--><p class="nopar" > Or using <span
-class="cmss-10">babel</span><a
- id="dx1-98004"></a> or <span
-class="cmss-10">polyglossia</span><a
- id="dx1-98005"></a> captions hook:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-360">
-\appto\captionsenglish{%
-&#x00A0;\renewcommand*{\abbreviationsname}{List&#x00A0;of&#x00A0;Abbreviations}%
+<code class="code">@dualindexsymbol</code>{pi,
+ <a id="wrglossary.13838"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\pi</code>}}</span>,
+ description=ratio of a circle's circumference to its diameter
}
-</pre>
-<!--l. 15388--><p class="nopar" >
-</p><!--l. 15390--><p class="indent" > Alternatively you can use the <span
-class="cmss-10">title</span><a
- id="dx1-98006"></a> key when you print the list of abbreviations.
-For example:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-361">
-\printabbreviations[title={List&#x00A0;of&#x00A0;Abbreviations}]
-</pre>
-<!--l. 15394--><p class="nopar" > or
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-362">
-\printglossary[type=abbreviations,title={List&#x00A0;of&#x00A0;Abbreviations}]
-</pre>
-<!--l. 15398--><p class="nopar" >
-</p><!--l. 15400--><p class="indent" > The other fixed text commands are the diagnostic messages, which shouldn&#8217;t
-appear in the final draft of your document.
-</p><!--l. 15403--><p class="indent" > The <span
-class="cmss-10">glossaries-extra </span>package has the facility to load language modules (whose
-filename is in the form <span
-class="cmtt-10">glossariesxtr-</span>&#x27E8;<span
-class="cmti-10">language</span>&#x27E9;<span
-class="cmtt-10">.ldf</span>) if they exist, but won&#8217;t warn if
-they don&#8217;t. If <span
-class="cmss-10">glossaries-extra-bib2gls</span><a
- id="dx1-98007"></a> is loaded via the <a
-href="#styopt.record"><span
-class="cmss-10">record</span></a><a
- id="dx1-98008"></a> package option then the
-check for language resource files will additionally search for an associated language
-script file given by <span
-class="cmtt-10">glossariesxtr-</span>&#x27E8;<span
-class="cmti-10">script</span>&#x27E9;<span
-class="cmtt-10">.ldf </span>where &#x27E8;<span
-class="cmti-10">script</span>&#x27E9; is the four letter script
-identifier, such as <span
-class="cmtt-10">Latn</span>, associated with the given dialect. There&#8217;s no warning
-if the associated file isn&#8217;t found. The script file is loaded after the dialect
-file.
-</p><!--l. 15416--><p class="indent" > If you want to write your own language module, you just need to create a file
-called <span
-class="cmtt-10">glossariesxtr-</span>&#x27E8;<span
-class="cmti-10">lang</span>&#x27E9;<span
-class="cmtt-10">.ldf</span>, where &#x27E8;<span
-class="cmti-10">lang</span>&#x27E9; identifies the language or dialect (see
-the <span
-class="cmss-10">tracklang</span><a
- id="dx1-98009"></a> package). For example, <span
-class="cmtt-10">glossariesxtr-french.ldf</span>.
-</p><!--l. 15422--><p class="indent" > The simplest code for this file is:
-
-
-
-</p>
- <pre class="verbatim" id="verbatim-363">
-\ProvidesGlossariesExtraLang{french}[2015/12/09&#x00A0;v1.0]
-\newcommand*{\glossariesxtrcaptionsfrench}{%
-&#x00A0;\def\abbreviationsname{Abr\'eviations}%
+</pre> and suppose the document code is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>{hyperref}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.13839"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>,<a id="wrglossary.13840"></a><a href="#glo:opt.abbreviations"><span class="styoptfmt">abbreviations</span></a>,<a id="wrglossary.13841"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a>]{glossaries-extra}
+
+<code class="cmd">\newcommand</code>{<a id="wrglossary.13842"></a><a href="#glo:bibglsnewdualindexsymbolsecondary"><code class="csfmt">\bibglsnewdualindexsymbolsecondary</code></a>}[5]{%
+ <a id="wrglossary.13843"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>*{#1}{<a id="wrglossary.13844"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={#3}</span>,<a id="wrglossary.13845"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={symbol}</span>,
+ <a id="wrglossary.13846"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={symbols}</span>,<a id="wrglossary.13847"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={#4}</span>,#2}{#5}%
}
-\glossariesxtrcaptionsfrench
-\ifcsdef{captions\CurrentTrackedDialect}
-{%
-&#x00A0;&#x00A0;\csappto{captions\CurrentTrackedDialect}%
-&#x00A0;&#x00A0;{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glossariesxtrcaptionsfrench
-&#x00A0;&#x00A0;}%
-}%
-{%
-&#x00A0;&#x00A0;\ifcsdef{captions\CurrentTrackedLanguage}
-&#x00A0;&#x00A0;{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;\csappto{captions\CurrentTrackedLanguage}%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;{%
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;\glossariesxtrcaptionsfrench
-&#x00A0;&#x00A0;&#x00A0;&#x00A0;}%
-&#x00A0;&#x00A0;}%
-&#x00A0;&#x00A0;{}%
+
+<a id="wrglossary.13848"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.13849"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">=entries</span>]
+
+<code class="cbeg">\begin{document}</code>
+First use: <a id="wrglossary.13850"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck}, <a id="wrglossary.13851"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{svm}, <a id="wrglossary.13852"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{pi}.
+Next use: <a id="wrglossary.13853"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck}, <a id="wrglossary.13854"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{svm}, <a id="wrglossary.13855"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{pi}.
+<a id="wrglossary.13856"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> This uses the default empty primary prefix and <code class="code">dual.</code> for the dual prefix, so <code class="code"><a id="wrglossary.13857"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{svm}</code> is referencing the primary entry, which is (essentially) an <code class="code">@index</code> type not an abbreviation. It therefore doesn’t follow the abbreviation style, and it also hyperlinks to the index not to the list of abbreviations. Similarly for <code class="code"><a id="wrglossary.13858"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{pi}</code>, which references the primary <code class="code">@index</code> entry rather than the symbol.<p>
+What’s really needed is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.13859"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck}, <a id="wrglossary.13860"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{dual.svm}, <a id="wrglossary.13861"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{dual.pi}.
+</pre> or use <a id="wrglossary.13862"></a><a href="#glo:opt.resource.label-prefix"><span class="csoptfmt">label-prefix</span></a> and <a id="wrglossary.13863"></a><a href="#glo:opt.resource.dual-prefix"><span class="csoptfmt">dual-prefix</span></a> to set the label prefixes: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.13864"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.13865"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">=entries</span>,
+ <a id="wrglossary.13866"></a><a href="#glo:opt.resource.label-prefix"><span class="csoptfmt">label-prefix</span></a><span class="optfmt">={idx.}</span>,<a id="wrglossary.13867"></a><a href="#glo:opt.resource.dual-prefix"><span class="csoptfmt">dual-prefix</span></a><span class="optfmt">={}</span>
+]
+</pre> then only the entries without a dual need a prefix: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.13868"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{idx.duck}, <a id="wrglossary.13869"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{svm}, <a id="wrglossary.13870"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{pi}.
+</pre> Using <a id="wrglossary.13871"></a><a href="#glo:glsxtrnewgls"><code class="csfmt">\glsxtrnewgls</code></a> or <a id="wrglossary.13872"></a><a href="#glo:glsxtrnewglslike"><code class="csfmt">\glsxtrnewglslike</code></a> (see §<a href="#sec:labelprefixes">5.7</a>) to define the custom <code class="csfmt">\idx</code>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.13873"></a><a href="#glo:glsxtrnewgls"><code class="csfmt">\glsxtrnewgls</code></a>{idx.}{<code class="cmd">\idx</code>}
+</pre> the entry references can be simplified to: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\idx</code>{duck}, <a id="wrglossary.13874"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>svm, <a id="wrglossary.13875"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>pi.
+</pre> but this requires remembering which terms have duals.<p>
+An alternative is to use <a id="wrglossary.13876"></a><a href="#glo:dgls"><code class="csfmt">\dgls</code></a> instead: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.13877"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.13878"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">=entries</span>,
+ <a id="wrglossary.13879"></a><a href="#glo:opt.resource.combine-dual-locations"><span class="csoptfmt">combine-dual-locations</span></a><span class="optfmt">=primary</span>]
+
+<a id="wrglossary.13880"></a><a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a>{dual.}
+<a id="wrglossary.13881"></a><a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a>{}
+
+<code class="cbeg">\begin{document}</code>
+First use: <a id="wrglossary.13882"></a><a href="#glo:dgls"><code class="csfmt">\dgls</code></a>{duck}, <a id="wrglossary.13883"></a><a href="#glo:dgls"><code class="csfmt">\dgls</code></a>{svm}, <a id="wrglossary.13884"></a><a href="#glo:dgls"><code class="csfmt">\dgls</code></a>{pi}.
+Next use: <a id="wrglossary.13885"></a><a href="#glo:dgls"><code class="csfmt">\dgls</code></a>{duck}, <a id="wrglossary.13886"></a><a href="#glo:dgls"><code class="csfmt">\dgls</code></a>{svm}, <a id="wrglossary.13887"></a><a href="#glo:dgls"><code class="csfmt">\dgls</code></a>{pi}.
+<a id="wrglossary.13888"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>
+<code class="cend">\end{document}</code>
+</pre> <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:bib2glsduallabelprefixes"></a>Example 159: Using <span class="appfmt">bib2gls</span>: dual entry label prefixes <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example159.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-extra-manual-examples/glossaries-extra-manual-example159.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-extra-manual-examples/glossaries-extra-manual-example159.png" type="image/png" width="388" height="300">Example document that uses bib2gls’s dual entries with the primary and dual prefixes identified.</object> </div><!-- end of resultbox -->
+<p>
+On the first LaTeX call (when the <a id="wrglossary.13889"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file doesn’t exist), neither <code class="code">dual.svm</code> nor <code class="code">svm</code> exists, so <a id="wrglossary.13890"></a><a href="#glo:dgls"><code class="csfmt">\dgls</code></a> uses the last prefix (which is empty in this case). This means that on the first LaTeX run, <code class="code"><a id="wrglossary.13891"></a><a href="#glo:dgls"><code class="csfmt">\dgls</code></a>{svm}</code> behaves like <code class="code"><a id="wrglossary.13892"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{svm}</code>, which adds a record for the primary <code class="code">svm</code> entry. The default primary-dual dependency means that this will cause both the primary (<code class="code">svm</code>) and dual (<code class="code">dual.svm</code>) entry to be selected. The <a id="wrglossary.13893"></a><a href="#glo:@@glslabel@entrylocation">location</a> will be added to the primary entry’s <a id="wrglossary.13894"></a><a href="#glo:dual.locationlist">location list</a>, unless overridden by resource options, such as <a id="wrglossary.13895"></a><a href="#glo:opt.resource.combine-dual-locations"><span class="csoptfmt">combine-dual-locations</span></a>.<p>
+Once <a id="wrglossary.13896"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> has been run and the <a id="wrglossary.13897"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file exists, then <code class="code">dual.svm</code> exists. So <code class="code"><a id="wrglossary.13898"></a><a href="#glo:dgls"><code class="csfmt">\dgls</code></a>{svm}</code> will again first try <code class="code">dual.svm</code> (as <code class="code">dual.</code> is the first in the list of label prefixes). That now exists, so <code class="code"><a id="wrglossary.13899"></a><a href="#glo:dgls"><code class="csfmt">\dgls</code></a>{svm}</code> now behaves like <code class="code"><a id="wrglossary.13900"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{dual.svm}</code>, which follows the abbreviation style and hyperlinks to the list of abbreviations. Similarly for the index-symbol combination <code class="code">dual.pi</code> and <code class="code">pi</code>.<p>
+In the case of <code class="code"><a id="wrglossary.13901"></a><a href="#glo:dgls"><code class="csfmt">\dgls</code></a>{duck}</code>, which doesn’t have a dual, the label <code class="code">dual.duck</code> never exists, so that’s never selected. However, when there’s no match, such as when the <a id="wrglossary.13902"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file doesn’t exist, the duck entry will be <a id="wrglossary.13903"></a><a href="#glo:@@glslabel@indexing">recorded</a> with both the <code class="code">dual.</code> prefix and the empty prefix. This allows <a id="wrglossary.13904"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to test which prefix+label combination matches.<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+If you haven’t used <a id="wrglossary.13905"></a><a href="#glo:opt.resource.combine-dual-locations"><span class="csoptfmt">combine-dual-locations</span></a> an extra <a id="wrglossary.13906"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>+LaTeX run may be required to correct the location lists. </div><!-- end of warning -->
+<p>
+If you change the label prefixes, remember to update the corresponding <code class="code"><a id="wrglossary.13907"></a><a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a>{<span class="meta">〈<em class="metainner">label-prefix</em>〉</span>}</code>. If no prefixes have been added to the list (or if the list is cleared), just an empty prefix is assumed.<p>
+Note that <a id="wrglossary.13908"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v1.8+ provides hooks that identify the label prefixes in the <a id="wrglossary.13909"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file: <pre class="compactcodebox"><a id="wrglossary.13910"></a><dfn id="glo:bibglstertiaryprefixlabel"><code class="csfmt">\bibglstertiaryprefixlabel</code></dfn>{<span class="meta">〈<em class="metainner">label-prefix</em>〉</span>}
+<a id="wrglossary.13911"></a><dfn id="glo:bibglsdualprefixlabel"><code class="csfmt">\bibglsdualprefixlabel</code></dfn>{<span class="meta">〈<em class="metainner">label-prefix</em>〉</span>}
+<a id="wrglossary.13912"></a><dfn id="glo:bibglsprimaryprefixlabel"><code class="csfmt">\bibglsprimaryprefixlabel</code></dfn>{<span class="meta">〈<em class="metainner">label-prefix</em>〉</span>}
+</pre> These do nothing by default, but they can be defined before the resource file is loaded to set up the prefix list. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<a id="wrglossary.13913"></a><a href="#glo:bibglsprimaryprefixlabel"><code class="csfmt">\bibglsprimaryprefixlabel</code></a>}[1]{%
+ <a id="wrglossary.13914"></a><a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a>{#1}}
+<code class="cmd">\newcommand</code>{<a id="wrglossary.13915"></a><a href="#glo:bibglsdualprefixlabel"><code class="csfmt">\bibglsdualprefixlabel</code></a>}[1]{%
+ <a id="wrglossary.13916"></a><a href="#glo:glsxtrprependlabelprefix"><code class="csfmt">\glsxtrprependlabelprefix</code></a>{#1}}
+<a id="wrglossary.13917"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.13918"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">=entries</span>]
+</pre> Remember that this will only have an effect once the <a id="wrglossary.13919"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file has been created. The prefix list will be empty on the first run (which is treated as a single empty prefix). If this isn’t a suitable fallback, it may be necessary to add one after all the resource commands: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<a id="wrglossary.13920"></a><a href="#glo:bibglsprimaryprefixlabel"><code class="csfmt">\bibglsprimaryprefixlabel</code></a>}[1]{%
+ <a id="wrglossary.13921"></a><a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a>{#1}}
+<code class="cmd">\newcommand</code>{<a id="wrglossary.13922"></a><a href="#glo:bibglsdualprefixlabel"><code class="csfmt">\bibglsdualprefixlabel</code></a>}[1]{%
+ <a id="wrglossary.13923"></a><a href="#glo:glsxtrprependlabelprefix"><code class="csfmt">\glsxtrprependlabelprefix</code></a>{#1}}
+<a id="wrglossary.13924"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.13925"></a><a href="#glo:opt.resource.src"><span class="csoptfmt">src</span></a><span class="optfmt">=entries</span>,<a id="wrglossary.13926"></a><a href="#glo:opt.resource.label-prefix"><span class="csoptfmt">label-prefix</span></a><span class="optfmt">={idx.}</span>]
+<a id="wrglossary.13927"></a><a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a>{idx.}
+</pre> Although this rather defeats the purpose of using the hooks as you still have to keep track of the fallback prefix.<p>
+
+</section><!-- end of section sec:dgls -->
+
+<section id="sec:bib2glssupplementarycommands"><!-- start of section sec:bib2glssupplementarycommands --><div class="tomain"><a href="#main">[top]</a></div>
+<h3><!-- start of subsection header -->11.5.8. Supplementary Commands<div class="labellink"><a href="#sec:bib2glssupplementarycommands">[link]</a></div></h3><!-- end of subsection header -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13928"></a><code class="code"><dfn id="glo:glsdisplaynumberlist"><code class="csfmt">\glsdisplaynumberlist</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is provided by the base <a id="wrglossary.13929"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, but it requires hooking into the <a id="wrglossary.13930"></a><a href="#glo:dual.locationlist">location list</a> formatting within the <a id="wrglossary.13931"></a><a href="#glo:dual.glossary">glossary</a> to obtain the list. This information is more easily available with <a id="wrglossary.13932"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, which stores the formatted <a id="wrglossary.13933"></a><a href="#glo:dual.locationlist">location list</a> in the <a id="wrglossary.13934"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a> field, so <a id="wrglossary.13935"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> redefines this command to use that field value. Likewise for: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13936"></a><code class="code"><dfn id="glo:glsentrynumberlist"><code class="csfmt">\glsentrynumberlist</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which is redefined to simply do: <pre class="compactcodebox"><a id="wrglossary.13937"></a><a href="#glo:glsxtrusefield"><code class="csfmt">\glsxtrusefield</code></a>{#1}{<a id="wrglossary.13938"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a>}
+</pre><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13939"></a><code class="code"><dfn id="glo:IfTeXParserLib"><code class="csfmt">\IfTeXParserLib</code></dfn>{<span class="meta">〈<em class="metainner">TeX parser lib code</em>〉</span>}{<span class="meta">〈<em class="metainner">LaTeX code</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is defined by <a id="wrglossary.13940"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> to expand to <code class="code">LaTeX code</code>, but is defined by the TeX parser library used by <a id="wrglossary.13941"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span>’s</a> to expand to <code class="code">TeX parser lib code</code>. May be used in the <code class="code">@preamble</code> or in field values to provide <a id="wrglossary.13942"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> with alternative content.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13943"></a><code class="code"><dfn id="glo:glsxtrprovidecommand"><code class="csfmt">\glsxtrprovidecommand</code></dfn>{<span class="meta">〈<em class="metainner">cs</em>〉</span>}[<span class="meta">〈<em class="metainner">n</em>〉</span>][<span class="meta">〈<em class="metainner">default</em>〉</span>]{<span class="meta">〈<em class="metainner">definition</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This command is intended for use in <code class="code">@preamble</code>. It’s simply defined to <a id="wrglossary.13944"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a> in <a id="wrglossary.13945"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> but <a id="wrglossary.13946"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span>’s</a> interpreter treats it as <a id="wrglossary.13947"></a><a href="#glo:renewcommand"><code class="csfmt">\renewcommand</code></a>. This means that you can override <a id="wrglossary.13948"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span>’s</a> internal definition of a command without overriding the command definition in the document (if it’s already defined before the <a id="wrglossary.13949"></a><a href="#glo:dual.resourcefile">resource file</a> is input). For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="code">@preamble</code>{"<a id="wrglossary.13950"></a><a href="#glo:glsxtrprovidecommand"><code class="csfmt">\glsxtrprovidecommand</code></a>{<code class="cmd">\int</code>}{integral}"}
+</pre> This will force <a id="wrglossary.13951"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to treat <code class="csfmt">\int</code> as the word <span class="qt">“integral”</span> to assist sorting but if this preamble code is written to the <a id="wrglossary.13952"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file (as it is by default) then it won’t override the current definition (provided by the kernel or redefined by a package).<p>
+The helper commands in the <a id="wrglossary.13953"></a><a href="#glo:dual.resourcefile">resource files</a> are defined using <a id="wrglossary.13954"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a>. For many of them, if you want to provide an alternative definition then you need to define the command before the <a id="wrglossary.13955"></a><a href="#glo:dual.resourcefile">resource file</a> is loaded. There are a few that may be redefined afterwards but if you use <a id="wrglossary.13956"></a><a href="#glo:renewcommand"><code class="csfmt">\renewcommand</code></a> then you will get an error on the first LaTeX run when the <a id="wrglossary.13957"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file doesn’t exist. In this case, you may prefer to use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13958"></a><code class="code"><dfn id="glo:glsrenewcommand"><code class="csfmt">\glsrenewcommand</code></dfn>{<span class="meta">〈<em class="metainner">cs</em>〉</span>}[<span class="meta">〈<em class="metainner">n</em>〉</span>][<span class="meta">〈<em class="metainner">default</em>〉</span>]{<span class="meta">〈<em class="metainner">definition</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This behaves like <a id="wrglossary.13959"></a><a href="#glo:renewcommand"><code class="csfmt">\renewcommand</code></a> but only generates a warning rather than an error if the command isn’t already defined so it won’t interrupt the document build.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.13960"></a><code class="code"><dfn id="glo:GlsXtrIndexCounterLink"><code class="csfmt">\GlsXtrIndexCounterLink</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ For use with the <a id="wrglossary.13961"></a><a href="#glo:opt.indexcounter"><span class="styoptfmt">indexcounter</span></a> package option and the <a id="wrglossary.13962"></a><a href="#glo:opt.resource.save-index-counter"><span class="csoptfmt">save-index-counter</span></a> resource option. This command creates a hyperlink (if supported) to the target obtained from the <a id="wrglossary.13963"></a><a href="#glo:opt.glosfield.indexcounter"><span class="csoptfmt">indexcounter</span></a> field (which will be set in the <a id="wrglossary.13964"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file, if applicable).<p>
+If then <a id="wrglossary.13965"></a><a href="#glo:opt.glosfield.indexcounter"><span class="csoptfmt">indexcounter</span></a> field is set for the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>, this command does <code class="code"><a id="wrglossary.13966"></a><a href="#glo:hyperref"><code class="csfmt">\hyperref</code></a>[wrglossary.<span class="meta">〈<em class="metainner">value</em>〉</span>]{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code>, where <span class="meta">〈<em class="metainner">value</em>〉</span> is the value of the <a id="wrglossary.13967"></a><a href="#glo:opt.glosfield.indexcounter"><span class="csoptfmt">indexcounter</span></a> field. If the field isn’t set or if <a id="wrglossary.13968"></a><a href="#glo:hyperref"><code class="csfmt">\hyperref</code></a> hasn’t been defined, this just does <span class="meta">〈<em class="metainner">text</em>〉</span>. See the <a id="wrglossary.13969"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> manual (v1.4+) for further details. <p>
+The <a id="wrglossary.13970"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> package also provides definitions of the missing mathematical Greek commands: <a id="wrglossary.13971"></a><dfn id="glo:Alpha"><code class="csfmt">\Alpha</code></dfn>, <a id="wrglossary.13972"></a><dfn id="glo:Beta"><code class="csfmt">\Beta</code></dfn>, <a id="wrglossary.13973"></a><dfn id="glo:Epsilon"><code class="csfmt">\Epsilon</code></dfn>, <a id="wrglossary.13974"></a><dfn id="glo:Zeta"><code class="csfmt">\Zeta</code></dfn>, <a id="wrglossary.13975"></a><dfn id="glo:Eta"><code class="csfmt">\Eta</code></dfn>, <a id="wrglossary.13976"></a><dfn id="glo:Iota"><code class="csfmt">\Iota</code></dfn>, <a id="wrglossary.13977"></a><dfn id="glo:Kappa"><code class="csfmt">\Kappa</code></dfn>, <a id="wrglossary.13978"></a><dfn id="glo:Mu"><code class="csfmt">\Mu</code></dfn>, <a id="wrglossary.13979"></a><dfn id="glo:Nu"><code class="csfmt">\Nu</code></dfn>, <a id="wrglossary.13980"></a><dfn id="glo:Omicron"><code class="csfmt">\Omicron</code></dfn>, <a id="wrglossary.13981"></a><dfn id="glo:Rho"><code class="csfmt">\Rho</code></dfn>, <a id="wrglossary.13982"></a><dfn id="glo:Tau"><code class="csfmt">\Tau</code></dfn>, <a id="wrglossary.13983"></a><dfn id="glo:Chi"><code class="csfmt">\Chi</code></dfn>, <a id="wrglossary.13984"></a><dfn id="glo:Digamma"><code class="csfmt">\Digamma</code></dfn>, <a id="wrglossary.13985"></a><dfn id="glo:omicron"><code class="csfmt">\omicron</code></dfn>. These are all defined with <a id="wrglossary.13986"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a>, so they won’t override any definitions provided by any package loaded before <a id="wrglossary.13987"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. Since <a id="wrglossary.13988"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span>’s</a> interpreter recognises these commands, using them instead of explicitly using the Latin characters with the same shape helps to keep the Greek symbols together when sorting. Similarly, if <a id="wrglossary.13989"></a><a href="#glo:pkg.upgreek"><span class="styfmt">upgreek</span></a> has been loaded, the missing upright Greek commands are also provided: <a id="wrglossary.13990"></a><dfn id="glo:Upalpha"><code class="csfmt">\Upalpha</code></dfn>, <a id="wrglossary.13991"></a><dfn id="glo:Upbeta"><code class="csfmt">\Upbeta</code></dfn>, <a id="wrglossary.13992"></a><dfn id="glo:Upepsilon"><code class="csfmt">\Upepsilon</code></dfn>, <a id="wrglossary.13993"></a><dfn id="glo:Upzeta"><code class="csfmt">\Upzeta</code></dfn>, <a id="wrglossary.13994"></a><dfn id="glo:Upeta"><code class="csfmt">\Upeta</code></dfn>, <a id="wrglossary.13995"></a><dfn id="glo:Upiota"><code class="csfmt">\Upiota</code></dfn>, <a id="wrglossary.13996"></a><dfn id="glo:Upkappa"><code class="csfmt">\Upkappa</code></dfn>, <a id="wrglossary.13997"></a><dfn id="glo:Upmu"><code class="csfmt">\Upmu</code></dfn>, <a id="wrglossary.13998"></a><dfn id="glo:Upnu"><code class="csfmt">\Upnu</code></dfn>, <a id="wrglossary.13999"></a><dfn id="glo:Upomicron"><code class="csfmt">\Upomicron</code></dfn>, <a id="wrglossary.14000"></a><dfn id="glo:Uprho"><code class="csfmt">\Uprho</code></dfn>, <a id="wrglossary.14001"></a><dfn id="glo:Uptau"><code class="csfmt">\Uptau</code></dfn>, <a id="wrglossary.14002"></a><dfn id="glo:Upchi"><code class="csfmt">\Upchi</code></dfn>, <a id="wrglossary.14003"></a><dfn id="glo:upomicron"><code class="csfmt">\upomicron</code></dfn>.<p>
+<a id="wrglossary.14004"></a><a id="wrglossary.14005"></a><p>
+
+</section><!-- end of section sec:bib2glssupplementarycommands -->
+
+<section id="sec:autoindex"><!-- start of section sec:autoindex --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->12. Auto-Indexing<div class="labellink"><a href="#sec:autoindex">[link]</a></div></h1><!-- end of chapter header -->
+<p>
+It’s possible that you may also want a normal index as well as the glossary, and you may want entries to automatically be added to the index (as in this document). There are two attributes that govern this: <a id="wrglossary.14006"></a><a href="#glo:opt.catattr.indexname"><span class="csoptfmt">indexname</span></a> and <a id="wrglossary.14007"></a><a href="#glo:opt.catattr.dualindex"><span class="csoptfmt">dualindex</span></a>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The auto-indexing is designed for <a id="wrglossary.14008"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> syntax. If you’ve used the <a id="wrglossary.14009"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> package option, the automatic escaping of <a id="wrglossary.14010"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> special characters in the <a id="wrglossary.14011"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> field may result in an incorrect sort value for the <a id="wrglossary.14012"></a><a href="#glo:index"><code class="csfmt">\index</code></a> command used by the auto-indexing. Note also that <a id="wrglossary.14013"></a><a href="#glo:app.texindy"><span class="appfmt">texindy</span></a> has a fixed set of special characters (corresponding to <a id="wrglossary.14014"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span>’s</a> defaults) that can’t be customized. You may want to consider using <a id="wrglossary.14015"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> and its dual entries as an alternative approach. </div><!-- end of important -->
+<p>
+The <a id="wrglossary.14016"></a><a href="#glo:glsxtrpostnamehook"><code class="csfmt">\glsxtrpostnamehook</code></a> macro, used at the end of <a id="wrglossary.14017"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a> and <a id="wrglossary.14018"></a><a href="#glo:Glossentryname"><code class="csfmt">\Glossentryname</code></a>, checks the <a id="wrglossary.14019"></a><a href="#glo:opt.catattr.indexname"><span class="csoptfmt">indexname</span></a> attribute for the category associated with that entry. Since <a id="wrglossary.14020"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a> is used in the default glossary styles, this makes a convenient way of automatically indexing each entry name at its location in the glossary without fiddling around with the value of the <a id="wrglossary.14021"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key.<p>
+The internal macro used by the <a id="wrglossary.14022"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package to write the information to the external glossary file is modified to check for the <a id="wrglossary.14023"></a><a href="#glo:opt.catattr.dualindex"><span class="csoptfmt">dualindex</span></a> attribute.<p>
+In both cases, the indexing is done through: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14024"></a><code class="code"><dfn id="glo:glsxtrdoautoindexname"><code class="csfmt">\glsxtrdoautoindexname</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This uses the standard <a id="wrglossary.14025"></a><a href="#glo:index"><code class="csfmt">\index</code></a> command with the sort value taken from the entry’s <a id="wrglossary.14026"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key and the actual value set to <code class="code"><a id="wrglossary.14027"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>. There are user-level commands available to change the sort and actual value used by the automated index.<p>
+The actual value is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14028"></a><code class="code"><dfn id="glo:glsxtrautoindexentry"><code class="csfmt">\glsxtrautoindexentry</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">entry-label</em>〉</span> is the entry’s label. The default definition is: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.14029"></a><a href="#glo:glsxtrautoindexentry"><code class="csfmt">\glsxtrautoindexentry</code></a>}[1]{<a id="wrglossary.14030"></a><a href="#glo:string"><code class="csfmt">\string</code></a><a id="wrglossary.14031"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a>{#1}}
+</pre> Note the use of <a id="wrglossary.14032"></a><a href="#glo:string"><code class="csfmt">\string</code></a> to prevent <a id="wrglossary.14033"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a> from being expanded as it’s written to the index file.<p>
+The sort value is assigned using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14034"></a><code class="code"><dfn id="glo:glsxtrautoindexassignsort"><code class="csfmt">\glsxtrautoindexassignsort</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">entry-label</em>〉</span> is the entry label and <span class="meta">〈<em class="metainner">cs</em>〉</span> is the command which needs to be set to the sort value. The default definition is: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.14035"></a><a href="#glo:glsxtrautoindexassignsort"><code class="csfmt">\glsxtrautoindexassignsort</code></a>}[2]{%
+ <a id="wrglossary.14036"></a><a href="#glo:glsletentryfield"><code class="csfmt">\glsletentryfield</code></a>{#1}{#2}{<a id="wrglossary.14037"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a>}%
+}
+</pre> After this macro is called, <span class="meta">〈<em class="metainner">cs</em>〉</span> is then processed to escape any of <a id="wrglossary.14038"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span>’s</a> special characters. Note that this escaping is only performed on the sort not on the actual value. The escaping of the sort value is performed by <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14039"></a><code class="code"><dfn id="glo:glsxtrautoindexesc"><code class="csfmt">\glsxtrautoindexesc</code></dfn></code></div><!-- end of pinnedbox -->
+ You can redefine this to do nothing if you want to omit the escaping. You may want to consider providing another field to obtain the appropriate sort value if the one provided in the <a id="wrglossary.14040"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> field isn’t suitable (because it may already have had special characters escaped or it may be a numeric value in the case of sort by use or definition).<p>
+The command used to perform the actual indexing is: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14041"></a><code class="code"><dfn id="glo:glsxtrautoindex"><code class="csfmt">\glsxtrautoindex</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:index"><code class="csfmt">\index</code></a></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This just does <code class="code"><a id="wrglossary.14042"></a><a href="#glo:index"><code class="csfmt">\index</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code> by default.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The entry’s <a id="wrglossary.14043"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> field isn’t referenced in this automated indexing. </div><!-- end of important -->
+<p>
+For example, to index the value of the <a id="wrglossary.14044"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> key, instead of the <a id="wrglossary.14045"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.14046"></a><a href="#glo:glsxtrautoindexentry"><code class="csfmt">\glsxtrautoindexentry</code></a>}[1]{<a id="wrglossary.14047"></a><a href="#glo:string"><code class="csfmt">\string</code></a><a id="wrglossary.14048"></a><a href="#glo:glsentryfirst"><code class="csfmt">\glsentryfirst</code></a>{#1}}
+</pre> and if the sort value also needs to be set to the <a id="wrglossary.14049"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> field, if present, otherwise the <a id="wrglossary.14050"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> field: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.14051"></a><a href="#glo:glsxtrautoindexassignsort"><code class="csfmt">\glsxtrautoindexassignsort</code></a>}[2]{%
+ <a id="wrglossary.14052"></a><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a>{#2}%
+ {<a id="wrglossary.14053"></a><a href="#glo:glsletentryfield"><code class="csfmt">\glsletentryfield</code></a>{#1}{#2}{<a id="wrglossary.14054"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a>}}%
+ {<a id="wrglossary.14055"></a><a href="#glo:glsletentryfield"><code class="csfmt">\glsletentryfield</code></a>{#1}{#2}{<a id="wrglossary.14056"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a>}}%
}
-</pre>
-<!--l. 15448--><p class="nopar" >
-</p><!--l. 15450--><p class="indent" > You can adapt this for other languages by replacing all instances of the language
-identifier <span
-class="cmtt-10">french </span>and the translated text <span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">Abr\&#8217;eviations</span></span></span> as appropriate. You can
-also use the <span
-class="cmtt-10">.ldf </span>file to provide rule blocks for a particular language for use with
-<a
- id="dx1-98010"></a><a
-href="#glo:bib2gls"><span
-class="cmtt-10">bib2gls</span>&#8217;s</a> custom sort rule. See <a
-href="#sec:bib2glssty"><span
-class="tcrm-1000">&sect;</span><span
-class="cmbx-10">10.3</span> </a><a
-href="#sec:bib2glssty">The glossaries-extra-bib2gls
-package<!--tex4ht:ref: sec:bib2glssty --></a> for further details.
-</p><!--l. 15457--><p class="indent" > This <span
-class="cmtt-10">.ldf </span>file then needs to be put somewhere on TeX&#8217;s path so that it can be
-found by <span
-class="cmss-10">glossaries-extra</span>. You might also want to consider uploading it to CTAN so
-that it can be useful to others. (Please don&#8217;t send it to me. I already have more
-packages than I am able to maintain.)
-</p><!--l. 15463--><p class="indent" > If you additionally want to provide translations for the diagnostic messages used
-when a glossary is missing, you need to redefine the following commands:
-</p><!--l. 15466--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-98011"></a> <span
-class="cmtt-10">\GlsXtrNoGlsWarningHead{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">}{</span>&#x27E8;<span
-class="cmitt-10">file</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15468--><p class="noindent" >
-This produces the following text in English:
- </p><blockquote class="quote">
- <!--l. 15471--><p class="noindent" >This document is incomplete. The external file associated with the
- glossary &#8216;&#x27E8;<span
-class="cmti-10">label</span>&#x27E9;&#8217; (which should be called &#x27E8;<span
-class="cmitt-10">file</span>&#x27E9;) hasn&#8217;t been created.</p></blockquote>
-
-
-
-<!--l. 15474--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-98012"></a> <span
-class="cmtt-10">\GlsXtrNoGlsWarningEmptyStart </span></div><hr>
-</p><!--l. 15476--><p class="noindent" >
-This produces the following text in English:
- </p><blockquote class="quote">
- <!--l. 15479--><p class="noindent" >This has probably happened because there are no entries defined in
- this glossary.</p></blockquote>
-<!--l. 15482--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-98013"></a> <span
-class="cmtt-10">\GlsXtrNoGlsWarningEmptyMain </span></div><hr>
-</p><!--l. 15484--><p class="noindent" >
-This produces the following text in English:
- </p><blockquote class="quote">
- <!--l. 15487--><p class="noindent" >If you don&#8217;t want this glossary, add <span
-class="cmtt-10">nomain </span>to your package option
- list when you load <span
-class="cmtt-10">glossaries-extra.sty</span>. For example:</p></blockquote>
-<!--l. 15490--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-98014"></a> <span
-class="cmtt-10">\GlsXtrNoGlsWarningEmptyNotMain{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15492--><p class="noindent" >
-This produces the following text in English:
- </p><blockquote class="quote">
- <!--l. 15495--><p class="noindent" >Did you forget to use <span
-class="cmtt-10">type=</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9; when you defined your entries?
- If you tried to load entries into this glossary with <span
-class="cmtt-10">\loadglsentries</span>
- did you remember to use <span
-class="cmtt-10">[</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">] </span>as the optional argument? If you
- did, check that the definitions in the file you loaded all had the type
- set to <span
-class="cmtt-10">\glsdefaulttype</span>.</p></blockquote>
-<!--l. 15498--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-98015"></a> <span
-class="cmtt-10">\GlsXtrNoGlsWarningCheckFile{</span>&#x27E8;<span
-class="cmitt-10">file</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15500--><p class="noindent" >
-This produces the following text in English:
- </p><blockquote class="quote">
- <!--l. 15503--><p class="noindent" >Check the contents of the file &#x27E8;<span
-class="cmitt-10">file</span>&#x27E9;. If it&#8217;s empty, that means you
- haven&#8217;t indexed any of your entries in this glossary (using commands
- like <span
-class="cmtt-10">\gls </span>or <span
-class="cmtt-10">\glsadd</span>) so this list can&#8217;t be generated. If the file isn&#8217;t
- empty, the document build process hasn&#8217;t been completed.</p></blockquote>
-<!--l. 15506--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-98016"></a> <span
-class="cmtt-10">\GlsXtrNoGlsWarningMisMatch </span></div><hr>
-</p><!--l. 15508--><p class="noindent" >
-This produces the following text in English:
- </p><blockquote class="quote">
- <!--l. 15511--><p class="noindent" >You need
- to either replace <span
-class="cmtt-10">\makenoidxglossaries </span>with <span
-class="cmtt-10">\makeglossaries </span>or
- replace <span
-class="cmtt-10">\printglossary </span>(or <span
-class="cmtt-10">\printglossaries</span>)
- with <span
-class="cmtt-10">\printnoidxglossary </span>(or <span
-class="cmtt-10">\printnoidxglossaries</span>) and then
- rebuild this document.</p></blockquote>
-
-
-
-<!--l. 15514--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-98017"></a> <span
-class="cmtt-10">\GlsXtrNoGlsWarningNoOut{</span>&#x27E8;<span
-class="cmitt-10">file</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15516--><p class="noindent" >
-This produces the following text in English:
- </p><blockquote class="quote">
- <!--l. 15519--><p class="noindent" >The file &#x27E8;<span
-class="cmitt-10">file</span>&#x27E9; doesn&#8217;t exist. This most likely means you haven&#8217;t used
- <span
-class="cmtt-10">\makeglossaries </span>or you have used <span
-class="cmtt-10">\nofiles</span>. If this is just a draft
- version of the document, you can suppress this message using the
- <span
-class="cmtt-10">nomissingglstext </span>package option.</p></blockquote>
-<!--l. 15522--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-98018"></a> <span
-class="cmtt-10">\GlsXtrNoGlsWarningTail </span></div><hr>
-</p><!--l. 15524--><p class="noindent" >
-This produces the following text in English:
- </p><blockquote class="quote">
- <!--l. 15527--><p class="noindent" >This message will be removed once the problem has been fixed.</p></blockquote>
-<!--l. 15530--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-98019"></a> <span
-class="cmtt-10">\GlsXtrNoGlsWarningBuildInfo </span></div><hr>
-</p><!--l. 15532--><p class="noindent" >
-This is advice on how to generate the glossary files.
-</p><!--l. 15535--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-98020"></a> <span
-class="cmtt-10">\GlsXtrNoGlsWarningAutoMake{</span>&#x27E8;<span
-class="cmitt-10">label</span>&#x27E9;<span
-class="cmtt-10">} </span></div><hr>
-</p><!--l. 15537--><p class="noindent" >
-This is the message produced when the <a
-href="#styopt.automake"><span
-class="cmss-10">automake</span></a><a
- id="dx1-98021"></a> option is used, but the document
-needs a rerun or the shell escape setting doesn&#8217;t permit the execution of the
-external application. This command also generates a warning in the transcript
-file.
-</p><!--l. 15543--><p class="indent" > See the documented code (<span
-class="cmtt-10">glossaries-extra-code.pdf</span>) for further
-details.
-
-
-
-</p><!--l. 1--><p class="indent" > <a
- id="likesection.1"></a><a
- id="glossary"></a>
-
-
-
-</p>
-<!--l. 1--><p class="indent" > </div>
-</p><!--l. 1--><p class="noindent" ><a
-href="#top">Top</a></p><h2 class="likechapterHead"><a
- id="x1-9900015"></a>Glossary</h2>
- <dl class="description"><dt class="description">
-<a
- id="glo:bib2gls"></a><span
-class="cmtt-10">bib2gls</span><a
- id="dx1-99001"></a> </dt><dd
-class="description">A command line Java application that selects entries from a .bib file
- and converts them
- to glossary definitions (like <span
-class="cmtt-10">bibtex </span>but also performs hierarchical sorting
- and collation, thus omitting the need for <a
- id="dx1-99002"></a><a
-href="#glo:xindy"><span
-class="cmtt-10">xindy</span></a> or <a
- id="dx1-99003"></a><a
-href="#glo:makeindex"><span
-class="cmtt-10">makeindex</span></a>). Further
- details at: <a
-href="http://www.dickimaw-books.com/software/bib2gls/" class="url" ><span
-class="cmtt-10">http://www.dickimaw-books.com/software/bib2gls/</span></a>.
- </dd><dt class="description">
-<a
- id="glo:entrylocation"></a><span
-class="cmbx-10">entry location</span><a
- id="dx1-99004"></a> </dt><dd
-class="description">The location of the entry in the document. This defaults to
- the page number on which the entry appears. An entry may have multiple
- locations.
- </dd><dt class="description">
-<a
- id="glo:firstuse"></a><span
-class="cmbx-10">first use</span><a
- id="dx1-99005"></a> </dt><dd
-class="description">The first time a glossary entry is used (from the start of the document
- or after a reset) with one of the following commands: <span
-class="cmtt-10">\gls</span><a
- id="dx1-99006"></a>, <span
-class="cmtt-10">\Gls</span><a
- id="dx1-99007"></a>, <span
-class="cmtt-10">\GLS</span><a
- id="dx1-99008"></a>,
- <span
-class="cmtt-10">\glspl</span><a
- id="dx1-99009"></a>, <span
-class="cmtt-10">\Glspl</span><a
- id="dx1-99010"></a>, <span
-class="cmtt-10">\GLSpl</span><a
- id="dx1-99011"></a> or <span
-class="cmtt-10">\glsdisp</span><a
- id="dx1-99012"></a>.
- </dd><dt class="description">
-<a
- id="glo:firstuseflag"></a><span
-class="cmbx-10">first use flag</span><a
- id="dx1-99013"></a> </dt><dd
-class="description">A conditional that determines whether or not the entry has been
- used according to the rules of <a
- id="dx1-99014"></a><a
-href="#glo:firstuse">first use</a>.
- </dd><dt class="description">
-<a
- id="glo:firstusetext"></a><span
-class="cmbx-10">first use text</span><a
- id="dx1-99015"></a> </dt><dd
-class="description">The text that is displayed on <a
- id="dx1-99016"></a>first use, which is governed by the
- <span
-class="cmss-10">first</span><a
- id="dx1-99017"></a> and <span
-class="cmss-10">firstplural</span><a
- id="dx1-99018"></a> keys of <span
-class="cmtt-10">\newglossaryentry</span><a
- id="dx1-99019"></a>. (May be overridden by
- <span
-class="cmtt-10">\glsdisp</span><a
- id="dx1-99020"></a>.)
- </dd><dt class="description">
-<a
- id="glo:linktext"></a><span
-class="cmbx-10">link-text</span><a
- id="dx1-99021"></a> </dt><dd
-class="description">The text produced by commands such as <span
-class="cmtt-10">\gls</span><a
- id="dx1-99022"></a>. It may or may not
- have a hyperlink to the glossary.
- </dd><dt class="description">
-<a
- id="glo:locationlist"></a><span
-class="cmbx-10">location list</span><a
- id="dx1-99023"></a> </dt><dd
-class="description">A list of <a
- id="dx1-99024"></a><a
-href="#glo:entrylocation">entry locations</a>. See <a
- id="dx1-99025"></a><a
-href="#glo:numberlist">number list</a>.
- </dd><dt class="description">
-<a
- id="glo:makeglossaries"></a><span
-class="cmtt-10">makeglossaries</span><a
- id="dx1-99026"></a> </dt><dd
-class="description">A custom designed Perl script interface provided with the
- <span
-class="cmss-10">glossaries </span>package to run <a
- id="dx1-99027"></a><span
-class="cmtt-10">xindy </span>or <a
- id="dx1-99028"></a><span
-class="cmtt-10">makeindex </span>according to the document
- settings.
-
-
-
- </dd><dt class="description">
-<a
- id="glo:makeglossaries-lite.lua"></a><span
-class="cmtt-10">makeglossaries-lite</span><a
- id="dx1-99029"></a><a
- id="dx1-99030"></a> </dt><dd
-class="description">A custom designed Lua script interface to <a
- id="dx1-99031"></a><span
-class="cmtt-10">xindy </span>and
- <a
- id="dx1-99032"></a><span
-class="cmtt-10">makeindex </span>provided with the <span
-class="cmss-10">glossaries </span>package. This is a cut-down
- alternative to the Perl <span
-class="cmtt-10">makeglossaries </span>script. If you have Perl installed,
- use the Perl script instead. This script is distributed in the source code
- on CTAN with the file name <span
-class="cmtt-10">makeglossaries-lite.lua </span>but TeX Live
- on Unix-like systems creates a symbolic link called <span
-class="cmtt-10">makeglossaries-lite</span>
- (without the <span
-class="cmtt-10">.lua </span>extension) to the actual <span
-class="cmtt-10">makeglossaries-lite.lua</span>
- script, and TeX&#x00A0;distributions on Windows convert the script to an
- executable <span
-class="cmtt-10">makeglossaries-lite.exe</span>.
- </dd><dt class="description">
-<a
- id="glo:makeindex"></a><span
-class="cmtt-10">makeindex</span><a
- id="dx1-99033"></a> </dt><dd
-class="description">An indexing application.
- </dd><dt class="description">
-<a
- id="glo:numberlist"></a><span
-class="cmbx-10">number list</span><a
- id="dx1-99034"></a> </dt><dd
-class="description">A list of <a
- id="dx1-99035"></a><a
-href="#glo:entrylocation">entry locations</a> (also called a location list). The number
- list can be suppressed using the <a
-href="#styopt.nonumberlist"><span
-class="cmss-10">nonumberlist</span></a><a
- id="dx1-99036"></a> package option.
- </dd><dt class="description">
-<a
- id="glo:xindy"></a><span
-class="cmtt-10">xindy</span><a
- id="dx1-99037"></a> </dt><dd
-class="description">An flexible indexing application with multilingual support written in
- Perl.</dd></dl>
-
-
-
- <h2 class="likechapterHead"><a
- id="x1-10000015"></a>Index</h2>
-<!--l. 4--><p class="noindent" > <span
-class="cmbx-10">A</span>
-</p>
- <div class="theindex"><span class="index-item">abbreviation styles (deprecated):<br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">footnote-em</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33181" >1</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">footnote-sc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33173" >2</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">footnote-sm</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33177" >3</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-desc-em</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32078" >4</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-desc-sc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32070" >5</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-desc-sm</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32074" >6</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-em</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32104" >7</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-sc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32096" >8</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-sm</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32100" >9</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">postfootnote-em</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33222" >10</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">postfootnote-sc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33214" >11</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">postfootnote-sm</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33218" >12</a> <br /></span>
-<span class="index-item">abbreviation styles:<br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">footnote</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33168" >13</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">footnote-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33189" >14</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32090" >15</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32064" >16</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-em-noshort-em</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31106" >17</a>, <a
-href="glossaries-extra-manual.html#dx1-32105" >18</a>, <a
-href="glossaries-extra-manual.html#dx1-33037" >19</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-em-noshort-em-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32079" >20</a>, <a
-href="glossaries-extra-manual.html#dx1-33083" >21</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-em-noshort-em-desc-noreg</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33082" >22</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-em-noshort-em-noreg</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31108" >23</a>, <a
-href="glossaries-extra-manual.html#dx1-32110" >24</a>, <a
-href="glossaries-extra-manual.html#dx1-33036" >25</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-em-short-em</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31060" >26</a>, <a
-href="glossaries-extra-manual.html#dx1-31100" >27</a>, <a
-href="glossaries-extra-manual.html#dx1-33018" >28</a>, <a
-href="glossaries-extra-manual.html#dx1-34018" >29</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-em-short-em-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33079" >30</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-hyphen-long-hyphen</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33278" >31</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-hyphen-noshort-desc-noreg</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33267" >32</a>, <a
-href="glossaries-extra-manual.html#dx1-33271" >33</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-hyphen-noshort-noreg</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31109" >34</a>, <a
-href="glossaries-extra-manual.html#dx1-33270" >35</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-hyphen-postshort-hyphen</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31104" >36</a>, <a
-href="glossaries-extra-manual.html#dx1-33266" >37</a>, <a
-href="glossaries-extra-manual.html#dx1-33275" >38</a>, <a
-href="glossaries-extra-manual.html#dx1-33281" >39</a>, <a
-href="glossaries-extra-manual.html#dx1-33291" >40</a>, <a
-href="glossaries-extra-manual.html#dx1-33293" >41</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-hyphen-postshort-hyphen-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33280" >42</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-hyphen-short-hyphen</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33258" >43</a>, <a
-href="glossaries-extra-manual.html#dx1-33273" >44</a>, <a
-href="glossaries-extra-manual.html#dx1-33276" >45</a>, <a
-href="glossaries-extra-manual.html#dx1-33284" >46</a>, <a
-href="glossaries-extra-manual.html#dx1-71058" >47</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-hyphen-short-hyphen-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33268" >48</a>, <a
-href="glossaries-extra-manual.html#dx1-33272" >49</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-noshort</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14042" >50</a>, <a
-href="glossaries-extra-manual.html#dx1-29002" >51</a>, <a
-href="glossaries-extra-manual.html#dx1-32084" >52</a>, <a
-href="glossaries-extra-manual.html#dx1-32091" >53</a>, <a
-href="glossaries-extra-manual.html#dx1-32093" >54</a>, <a
-href="glossaries-extra-manual.html#dx1-32098" >55</a>, <a
-href="glossaries-extra-manual.html#dx1-32102" >56</a>, <a
-href="glossaries-extra-manual.html#dx1-32106" >57</a>, <a
-href="glossaries-extra-manual.html#dx1-33057" >58</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-noshort-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-13040" >59</a>, <a
-href="glossaries-extra-manual.html#dx1-14044" >60</a>, <a
-href="glossaries-extra-manual.html#dx1-32057" >61</a>, <a
-href="glossaries-extra-manual.html#dx1-32065" >62</a>, <a
-href="glossaries-extra-manual.html#dx1-32067" >63</a>, <a
-href="glossaries-extra-manual.html#dx1-32072" >64</a>, <a
-href="glossaries-extra-manual.html#dx1-32076" >65</a>, <a
-href="glossaries-extra-manual.html#dx1-32080" >66</a>, <a
-href="glossaries-extra-manual.html#dx1-32085" >67</a>, <a
-href="glossaries-extra-manual.html#dx1-33060" >68</a> <br /></span>
-
-
-
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-noshort-desc-noreg</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33059" >69</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-noshort-em</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32101" >70</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-noshort-em-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32075" >71</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-noshort-noreg</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33056" >72</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-noshort-sc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31099" >73</a>, <a
-href="glossaries-extra-manual.html#dx1-32092" >74</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-noshort-sc-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32066" >75</a>, <a
-href="glossaries-extra-manual.html#dx1-34041" >76</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-noshort-sm</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32097" >77</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-noshort-sm-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32071" >78</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-only-short-only</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31074" >79</a>, <a
-href="glossaries-extra-manual.html#dx1-33021" >80</a>, <a
-href="glossaries-extra-manual.html#dx1-33025" >81</a>, <a
-href="glossaries-extra-manual.html#dx1-33028" >82</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-only-short-only-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33027" >83</a>, <a
-href="glossaries-extra-manual.html#dx1-33033" >84</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-only-short-sc-only</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31080" >85</a>, <a
-href="glossaries-extra-manual.html#dx1-33024" >86</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-only-short-sc-only-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33032" >87</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-postshort-sc-user</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31087" >88</a>, <a
-href="glossaries-extra-manual.html#dx1-33254" >89</a>, <a
-href="glossaries-extra-manual.html#dx1-45001" >90</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-postshort-sc-user-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33256" >91</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-postshort-user</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33247" >92</a>, <a
-href="glossaries-extra-manual.html#dx1-33251" >93</a>, <a
-href="glossaries-extra-manual.html#dx1-33255" >94</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-postshort-user-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33250" >95</a>, <a
-href="glossaries-extra-manual.html#dx1-33257" >96</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-short</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-13047" >97</a>, <a
-href="glossaries-extra-manual.html#dx1-14020" >98</a>, <a
-href="glossaries-extra-manual.html#dx1-14068" >99</a>, <a
-href="glossaries-extra-manual.html#dx1-27028" >100</a>, <a
-href="glossaries-extra-manual.html#dx1-31029" >101</a>, <a
-href="glossaries-extra-manual.html#dx1-31031" >102</a>, <a
-href="glossaries-extra-manual.html#dx1-33002" >103</a>, <a
-href="glossaries-extra-manual.html#dx1-33010" >104</a>, <a
-href="glossaries-extra-manual.html#dx1-33013" >105</a>, <a
-href="glossaries-extra-manual.html#dx1-33016" >106</a>, <a
-href="glossaries-extra-manual.html#dx1-33040" >107</a>, <a
-href="glossaries-extra-manual.html#dx1-33043" >108</a>, <a
-href="glossaries-extra-manual.html#dx1-33264" >109</a>, <a
-href="glossaries-extra-manual.html#dx1-34014" >110</a>, <a
-href="glossaries-extra-manual.html#dx1-34017" >111</a>, <a
-href="glossaries-extra-manual.html#dx1-34091" >112</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-short-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14028" >113</a>, <a
-href="glossaries-extra-manual.html#dx1-14034" >114</a>, <a
-href="glossaries-extra-manual.html#dx1-33062" >115</a>, <a
-href="glossaries-extra-manual.html#dx1-33071" >116</a>, <a
-href="glossaries-extra-manual.html#dx1-33074" >117</a>, <a
-href="glossaries-extra-manual.html#dx1-33077" >118</a>, <a
-href="glossaries-extra-manual.html#dx1-33086" >119</a>, <a
-href="glossaries-extra-manual.html#dx1-33093" >120</a>, <a
-href="glossaries-extra-manual.html#dx1-34090" >121</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-short-em</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31055" >122</a>, <a
-href="glossaries-extra-manual.html#dx1-31101" >123</a>, <a
-href="glossaries-extra-manual.html#dx1-33015" >124</a>, <a
-href="glossaries-extra-manual.html#dx1-33019" >125</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-short-em-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33076" >126</a>, <a
-href="glossaries-extra-manual.html#dx1-33080" >127</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-short-sc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14016" >128</a>, <a
-href="glossaries-extra-manual.html#dx1-31039" >129</a>, <a
-href="glossaries-extra-manual.html#dx1-33009" >130</a>, <a
-href="glossaries-extra-manual.html#dx1-33055" >131</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-short-sc-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14030" >132</a>, <a
-href="glossaries-extra-manual.html#dx1-33070" >133</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-short-sm</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14018" >134</a>, <a
-href="glossaries-extra-manual.html#dx1-31049" >135</a>, <a
-href="glossaries-extra-manual.html#dx1-33012" >136</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-short-sm-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14032" >137</a>, <a
-href="glossaries-extra-manual.html#dx1-33073" >138</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-short-user</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31102" >139</a>, <a
-href="glossaries-extra-manual.html#dx1-33008" >140</a>, <a
-href="glossaries-extra-manual.html#dx1-33039" >141</a>, <a
-href="glossaries-extra-manual.html#dx1-33045" >142</a>, <a
-href="glossaries-extra-manual.html#dx1-33051" >143</a>, <a
-href="glossaries-extra-manual.html#dx1-33087" >144</a>, <a
-href="glossaries-extra-manual.html#dx1-33088" >145</a>, <a
-href="glossaries-extra-manual.html#dx1-33121" >146</a>, <a
-href="glossaries-extra-manual.html#dx1-33249" >147</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-short-user-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33085" >148</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">nolong-short</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32010" >149</a>, <a
-href="glossaries-extra-manual.html#dx1-33098" >150</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">nolong-short-em</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32031" >151</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">nolong-short-noreg</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33097" >152</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">nolong-short-sc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32017" >153</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">nolong-short-sm</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32024" >154</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">postfootnote</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-27006" >155</a>, <a
-href="glossaries-extra-manual.html#dx1-33209" >156</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">postfootnote-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33229" >157</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32008" >158</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32040" >159</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-em</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32029" >160</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-em-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32055" >161</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-em-footnote</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31120" >162</a>, <a
-href="glossaries-extra-manual.html#dx1-33178" >163</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-em-footnote-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31119" >164</a>, <a
-href="glossaries-extra-manual.html#dx1-33197" >165</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-em-long</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31056" >166</a>, <a
-href="glossaries-extra-manual.html#dx1-33114" >167</a>, <a
-href="glossaries-extra-manual.html#dx1-33118" >168</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-em-long-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33141" >169</a>, <a
-href="glossaries-extra-manual.html#dx1-33145" >170</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-em-long-em</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31061" >171</a>, <a
-href="glossaries-extra-manual.html#dx1-33117" >172</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-em-long-em-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33144" >173</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-em-nolong</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32026" >174</a>, <a
-href="glossaries-extra-manual.html#dx1-32030" >175</a>, <a
-href="glossaries-extra-manual.html#dx1-32032" >176</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-em-nolong-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32052" >177</a>, <a
-href="glossaries-extra-manual.html#dx1-32056" >178</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-em-postfootnote</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33219" >179</a> <br /></span>
-
-
-
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-em-postfootnote-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33237" >180</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-footnote</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14046" >181</a>, <a
-href="glossaries-extra-manual.html#dx1-27030" >182</a>, <a
-href="glossaries-extra-manual.html#dx1-31112" >183</a>, <a
-href="glossaries-extra-manual.html#dx1-33154" >184</a>, <a
-href="glossaries-extra-manual.html#dx1-33169" >185</a>, <a
-href="glossaries-extra-manual.html#dx1-33171" >186</a>, <a
-href="glossaries-extra-manual.html#dx1-33175" >187</a>, <a
-href="glossaries-extra-manual.html#dx1-33179" >188</a>, <a
-href="glossaries-extra-manual.html#dx1-33183" >189</a>, <a
-href="glossaries-extra-manual.html#dx1-33201" >190</a>, <a
-href="glossaries-extra-manual.html#dx1-34020" >191</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-footnote-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14052" >192</a>, <a
-href="glossaries-extra-manual.html#dx1-33182" >193</a>, <a
-href="glossaries-extra-manual.html#dx1-33190" >194</a>, <a
-href="glossaries-extra-manual.html#dx1-33192" >195</a>, <a
-href="glossaries-extra-manual.html#dx1-33195" >196</a>, <a
-href="glossaries-extra-manual.html#dx1-33198" >197</a>, <a
-href="glossaries-extra-manual.html#dx1-33228" >198</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-hyphen-long-hyphen</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33283" >199</a>, <a
-href="glossaries-extra-manual.html#dx1-33288" >200</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-hyphen-long-hyphen-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33287" >201</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-hyphen-postlong-hyphen</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33290" >202</a>, <a
-href="glossaries-extra-manual.html#dx1-33296" >203</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-hyphen-postlong-hyphen-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33295" >204</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-long</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14022" >205</a>, <a
-href="glossaries-extra-manual.html#dx1-27023" >206</a>, <a
-href="glossaries-extra-manual.html#dx1-31032" >207</a>, <a
-href="glossaries-extra-manual.html#dx1-31095" >208</a>, <a
-href="glossaries-extra-manual.html#dx1-31118" >209</a>, <a
-href="glossaries-extra-manual.html#dx1-33100" >210</a>, <a
-href="glossaries-extra-manual.html#dx1-33109" >211</a>, <a
-href="glossaries-extra-manual.html#dx1-33112" >212</a>, <a
-href="glossaries-extra-manual.html#dx1-33115" >213</a>, <a
-href="glossaries-extra-manual.html#dx1-34088" >214</a>, <a
-href="glossaries-extra-manual.html#dx1-34093" >215</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-long-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14036" >216</a>, <a
-href="glossaries-extra-manual.html#dx1-31117" >217</a>, <a
-href="glossaries-extra-manual.html#dx1-33129" >218</a>, <a
-href="glossaries-extra-manual.html#dx1-33136" >219</a>, <a
-href="glossaries-extra-manual.html#dx1-33139" >220</a>, <a
-href="glossaries-extra-manual.html#dx1-33142" >221</a>, <a
-href="glossaries-extra-manual.html#dx1-33148" >222</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-long-user</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33046" >223</a>, <a
-href="glossaries-extra-manual.html#dx1-33052" >224</a>, <a
-href="glossaries-extra-manual.html#dx1-33105" >225</a>, <a
-href="glossaries-extra-manual.html#dx1-33120" >226</a>, <a
-href="glossaries-extra-manual.html#dx1-33149" >227</a>, <a
-href="glossaries-extra-manual.html#dx1-33150" >228</a>, <a
-href="glossaries-extra-manual.html#dx1-33241" >229</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-long-user-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33147" >230</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-nolong</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-3016" >231</a>, <a
-href="glossaries-extra-manual.html#dx1-27021" >232</a>, <a
-href="glossaries-extra-manual.html#dx1-27029" >233</a>, <a
-href="glossaries-extra-manual.html#dx1-29003" >234</a>, <a
-href="glossaries-extra-manual.html#dx1-29018" >235</a>, <a
-href="glossaries-extra-manual.html#dx1-32002" >236</a>, <a
-href="glossaries-extra-manual.html#dx1-32009" >237</a>, <a
-href="glossaries-extra-manual.html#dx1-32011" >238</a>, <a
-href="glossaries-extra-manual.html#dx1-32013" >239</a>, <a
-href="glossaries-extra-manual.html#dx1-32020" >240</a>, <a
-href="glossaries-extra-manual.html#dx1-32027" >241</a>, <a
-href="glossaries-extra-manual.html#dx1-32034" >242</a>, <a
-href="glossaries-extra-manual.html#dx1-32038" >243</a>, <a
-href="glossaries-extra-manual.html#dx1-32043" >244</a>, <a
-href="glossaries-extra-manual.html#dx1-33095" >245</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-nolong-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32033" >246</a>, <a
-href="glossaries-extra-manual.html#dx1-32041" >247</a>, <a
-href="glossaries-extra-manual.html#dx1-32048" >248</a>, <a
-href="glossaries-extra-manual.html#dx1-32053" >249</a>, <a
-href="glossaries-extra-manual.html#dx1-33127" >250</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-nolong-desc-noreg</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33126" >251</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-nolong-noreg</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33094" >252</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-postfootnote</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-9062" >253</a>, <a
-href="glossaries-extra-manual.html#dx1-9067" >254</a>, <a
-href="glossaries-extra-manual.html#dx1-33200" >255</a>, <a
-href="glossaries-extra-manual.html#dx1-33210" >256</a>, <a
-href="glossaries-extra-manual.html#dx1-33212" >257</a>, <a
-href="glossaries-extra-manual.html#dx1-33216" >258</a>, <a
-href="glossaries-extra-manual.html#dx1-33220" >259</a>, <a
-href="glossaries-extra-manual.html#dx1-33224" >260</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-postfootnote-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33223" >261</a>, <a
-href="glossaries-extra-manual.html#dx1-33230" >262</a>, <a
-href="glossaries-extra-manual.html#dx1-33232" >263</a>, <a
-href="glossaries-extra-manual.html#dx1-33235" >264</a>, <a
-href="glossaries-extra-manual.html#dx1-33238" >265</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-postlong-user</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33240" >266</a>, <a
-href="glossaries-extra-manual.html#dx1-33244" >267</a>, <a
-href="glossaries-extra-manual.html#dx1-33248" >268</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-postlong-user-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33243" >269</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-sc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32015" >270</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-sc-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32045" >271</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-sc-footnote</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14048" >272</a>, <a
-href="glossaries-extra-manual.html#dx1-33170" >273</a>, <a
-href="glossaries-extra-manual.html#dx1-33174" >274</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-sc-footnote-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14054" >275</a>, <a
-href="glossaries-extra-manual.html#dx1-33191" >276</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-sc-long</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14024" >277</a>, <a
-href="glossaries-extra-manual.html#dx1-31040" >278</a>, <a
-href="glossaries-extra-manual.html#dx1-33108" >279</a>, <a
-href="glossaries-extra-manual.html#dx1-34092" >280</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-sc-long-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14038" >281</a>, <a
-href="glossaries-extra-manual.html#dx1-33135" >282</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-sc-nolong</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32012" >283</a>, <a
-href="glossaries-extra-manual.html#dx1-32016" >284</a>, <a
-href="glossaries-extra-manual.html#dx1-32018" >285</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-sc-nolong-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32042" >286</a>, <a
-href="glossaries-extra-manual.html#dx1-32046" >287</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-sc-postfootnote</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31113" >288</a>, <a
-href="glossaries-extra-manual.html#dx1-33211" >289</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-sc-postfootnote-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33231" >290</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-sm</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32022" >291</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-sm-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32050" >292</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-sm-footnote</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14050" >293</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-sm-footnote-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14056" >294</a>, <a
-href="glossaries-extra-manual.html#dx1-33194" >295</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-sm-long</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14026" >296</a>, <a
-href="glossaries-extra-manual.html#dx1-31050" >297</a>, <a
-href="glossaries-extra-manual.html#dx1-33111" >298</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-sm-long-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14040" >299</a>, <a
-href="glossaries-extra-manual.html#dx1-33138" >300</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-sm-nolong</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32019" >301</a>, <a
-href="glossaries-extra-manual.html#dx1-32023" >302</a>, <a
-href="glossaries-extra-manual.html#dx1-32025" >303</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-sm-nolong-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32047" >304</a>, <a
-href="glossaries-extra-manual.html#dx1-32051" >305</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-sm-postfootnote</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33215" >306</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short-sm-postfootnote-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33234" >307</a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\abbreviationsname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4226" ><span
-class="cmti-10">308</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\abbrvpluralsuffix</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34043" ><span
-class="cmti-10">309</span></a> <br /></span>
-<span class="index-item">acronym styles (glossaries):<br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">dua</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14041" >310</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">dua-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14043" >311</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">footnote</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14045" >312</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">footnote-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14051" >313</a> <br /></span>
-
-
-
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">footnote-sc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14047" >314</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">footnote-sc-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14053" >315</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">footnote-sm</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14049" >316</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">footnote-sm-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14055" >317</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">long-sc-short</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14015" >318</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">long-sc-short-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14029" >319</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">long-short-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14027" >320</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">long-sm-short</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14017" >321</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">long-sm-short-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14031" >322</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">long-sp-short</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14019" >323</a>, <a
-href="glossaries-extra-manual.html#dx1-14065" >324</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">long-sp-short-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14033" >325</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">sc-short-long</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14023" >326</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">sc-short-long-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14037" >327</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">short-long</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14021" >328</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">short-long-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14035" >329</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">sm-short-long</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14025" >330</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">sm-short-long-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14039" >331</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">amsgen </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-10" >332</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">amsmath </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4156" >333</a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\apptoglossarypreamble</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-85010" ><span
-class="cmti-10">334</span></a> <br /></span>
-<p class="theindex"> <span
-class="cmbx-10">B</span>
-<span class="index-item"><span
-class="cmss-10">babel </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-3010" >335</a>, <a
-href="glossaries-extra-manual.html#dx1-3014" >336</a>, <a
-href="glossaries-extra-manual.html#dx1-4227" >337</a>, <a
-href="glossaries-extra-manual.html#dx1-4228" >338</a>, <a
-href="glossaries-extra-manual.html#dx1-4229" >339</a>, <a
-href="glossaries-extra-manual.html#dx1-71004" >340</a>, <a
-href="glossaries-extra-manual.html#dx1-86086" >341</a>, <a
-href="glossaries-extra-manual.html#dx1-98003" >342</a>, <a
-href="glossaries-extra-manual.html#dx1-98004" >343</a> <br /></span>
-<span class="index-item"><span
-class="cmtt-10">bib2gls</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-2" >344</a>, <a
-href="glossaries-extra-manual.html#dx1-11" >345</a>, <a
-href="glossaries-extra-manual.html#dx1-4010" >346</a>, <a
-href="glossaries-extra-manual.html#dx1-4034" >347</a>, <a
-href="glossaries-extra-manual.html#dx1-4066" >348</a>, <a
-href="glossaries-extra-manual.html#dx1-4078" >349</a>, <a
-href="glossaries-extra-manual.html#dx1-4079" >350</a>, <a
-href="glossaries-extra-manual.html#dx1-4084" >351</a>, <a
-href="glossaries-extra-manual.html#dx1-4088" >352</a>, <a
-href="glossaries-extra-manual.html#dx1-4091" >353</a>, <a
-href="glossaries-extra-manual.html#dx1-4093" >354</a>, <a
-href="glossaries-extra-manual.html#dx1-4097" >355</a>, <a
-href="glossaries-extra-manual.html#dx1-4106" >356</a>, <a
-href="glossaries-extra-manual.html#dx1-4111" >357</a>, <a
-href="glossaries-extra-manual.html#dx1-4114" >358</a>, <a
-href="glossaries-extra-manual.html#dx1-4116" >359</a>, <a
-href="glossaries-extra-manual.html#dx1-4119" >360</a>, <a
-href="glossaries-extra-manual.html#dx1-4120" >361</a>, <a
-href="glossaries-extra-manual.html#dx1-4122" >362</a>, <a
-href="glossaries-extra-manual.html#dx1-4125" >363</a>, <a
-href="glossaries-extra-manual.html#dx1-4129" >364</a>, <a
-href="glossaries-extra-manual.html#dx1-4146" >365</a>, <a
-href="glossaries-extra-manual.html#dx1-4171" >366</a>, <a
-href="glossaries-extra-manual.html#dx1-4172" >367</a>, <a
-href="glossaries-extra-manual.html#dx1-4176" >368</a>, <a
-href="glossaries-extra-manual.html#dx1-4206" >369</a>, <a
-href="glossaries-extra-manual.html#dx1-4207" >370</a>, <a
-href="glossaries-extra-manual.html#dx1-6014" >371</a>, <a
-href="glossaries-extra-manual.html#dx1-7055" >372</a>, <a
-href="glossaries-extra-manual.html#dx1-7066" >373</a>, <a
-href="glossaries-extra-manual.html#dx1-10001" >374</a>, <a
-href="glossaries-extra-manual.html#dx1-11006" >375</a>, <a
-href="glossaries-extra-manual.html#dx1-17016" >376</a>, <a
-href="glossaries-extra-manual.html#dx1-18012" >377</a>, <a
-href="glossaries-extra-manual.html#dx1-22075" >378</a>, <a
-href="glossaries-extra-manual.html#dx1-22076" >379</a>, <a
-href="glossaries-extra-manual.html#dx1-24007" >380</a>, <a
-href="glossaries-extra-manual.html#dx1-24008" >381</a>, <a
-href="glossaries-extra-manual.html#dx1-24022" >382</a>, <a
-href="glossaries-extra-manual.html#dx1-24035" >383</a>, <a
-href="glossaries-extra-manual.html#dx1-24038" >384</a>, <a
-href="glossaries-extra-manual.html#dx1-25028" >385</a>, <a
-href="glossaries-extra-manual.html#dx1-25029" >386</a>, <a
-href="glossaries-extra-manual.html#dx1-25030" >387</a>, <a
-href="glossaries-extra-manual.html#dx1-26022" >388</a>, <a
-href="glossaries-extra-manual.html#dx1-46002" >389</a>, <a
-href="glossaries-extra-manual.html#dx1-69014" >390</a>, <a
-href="glossaries-extra-manual.html#dx1-70001" >391</a>, <a
-href="glossaries-extra-manual.html#dx1-70002" >392</a>, <a
-href="glossaries-extra-manual.html#dx1-70004" >393</a>, <a
-href="glossaries-extra-manual.html#dx1-70005" >394</a>, <a
-href="glossaries-extra-manual.html#dx1-70007" >395</a>, <a
-href="glossaries-extra-manual.html#dx1-71131" >396</a>, <a
-href="glossaries-extra-manual.html#dx1-72005" >397</a>, <a
-href="glossaries-extra-manual.html#dx1-75009" >398</a>, <a
-href="glossaries-extra-manual.html#dx1-76001" >399</a>, <a
-href="glossaries-extra-manual.html#dx1-76002" >400</a>, <a
-href="glossaries-extra-manual.html#dx1-76004" >401</a>, <a
-href="glossaries-extra-manual.html#dx1-76005" >402</a>, <a
-href="glossaries-extra-manual.html#dx1-76006" >403</a>, <a
-href="glossaries-extra-manual.html#dx1-76007" >404</a>, <a
-href="glossaries-extra-manual.html#dx1-76008" >405</a>, <a
-href="glossaries-extra-manual.html#dx1-76009" >406</a>, <a
-href="glossaries-extra-manual.html#dx1-76011" >407</a>, <a
-href="glossaries-extra-manual.html#dx1-76014" >408</a>, <a
-href="glossaries-extra-manual.html#dx1-76016" >409</a>, <a
-href="glossaries-extra-manual.html#dx1-76023" >410</a>, <a
-href="glossaries-extra-manual.html#dx1-77001" >411</a>, <a
-href="glossaries-extra-manual.html#dx1-77002" >412</a>, <a
-href="glossaries-extra-manual.html#dx1-77003" >413</a>, <a
-href="glossaries-extra-manual.html#dx1-77004" >414</a>, <a
-href="glossaries-extra-manual.html#dx1-77005" >415</a>, <a
-href="glossaries-extra-manual.html#dx1-77006" >416</a>, <a
-href="glossaries-extra-manual.html#dx1-78001" >417</a>, <a
-href="glossaries-extra-manual.html#dx1-78002" >418</a>, <a
-href="glossaries-extra-manual.html#dx1-78004" >419</a>, <a
-href="glossaries-extra-manual.html#dx1-78005" >420</a>, <a
-href="glossaries-extra-manual.html#dx1-78006" >421</a>, <a
-href="glossaries-extra-manual.html#dx1-78007" >422</a>, <a
-href="glossaries-extra-manual.html#dx1-78010" >423</a>, <a
-href="glossaries-extra-manual.html#dx1-78013" >424</a>, <a
-href="glossaries-extra-manual.html#dx1-79004" >425</a>, <a
-href="glossaries-extra-manual.html#dx1-79017" >426</a>, <a
-href="glossaries-extra-manual.html#dx1-79024" >427</a>, <a
-href="glossaries-extra-manual.html#dx1-79025" >428</a>, <a
-href="glossaries-extra-manual.html#dx1-79026" >429</a>, <a
-href="glossaries-extra-manual.html#dx1-79032" >430</a>, <a
-href="glossaries-extra-manual.html#dx1-79033" >431</a>, <a
-href="glossaries-extra-manual.html#dx1-79034" >432</a>, <a
-href="glossaries-extra-manual.html#dx1-79038" >433</a>, <a
-href="glossaries-extra-manual.html#dx1-79039" >434</a>, <a
-href="glossaries-extra-manual.html#dx1-80002" >435</a>, <a
-href="glossaries-extra-manual.html#dx1-81002" >436</a>, <a
-href="glossaries-extra-manual.html#dx1-81004" >437</a>, <a
-href="glossaries-extra-manual.html#dx1-81009" >438</a>, <a
-href="glossaries-extra-manual.html#dx1-81011" >439</a>, <a
-href="glossaries-extra-manual.html#dx1-81013" >440</a>, <a
-href="glossaries-extra-manual.html#dx1-81017" >441</a>, <a
-href="glossaries-extra-manual.html#dx1-81024" >442</a>, <a
-href="glossaries-extra-manual.html#dx1-81026" >443</a>, <a
-href="glossaries-extra-manual.html#dx1-81027" >444</a>, <a
-href="glossaries-extra-manual.html#dx1-82003" >445</a>, <a
-href="glossaries-extra-manual.html#dx1-82006" >446</a>, <a
-href="glossaries-extra-manual.html#dx1-82007" >447</a>, <a
-href="glossaries-extra-manual.html#dx1-82028" >448</a>, <a
-href="glossaries-extra-manual.html#dx1-82036" >449</a>, <a
-href="glossaries-extra-manual.html#dx1-82045" >450</a>, <a
-href="glossaries-extra-manual.html#dx1-82115" >451</a>, <a
-href="glossaries-extra-manual.html#dx1-83001" >452</a>, <a
-href="glossaries-extra-manual.html#dx1-83002" >453</a>, <a
-href="glossaries-extra-manual.html#dx1-83011" >454</a>, <a
-href="glossaries-extra-manual.html#dx1-83013" >455</a>, <a
-href="glossaries-extra-manual.html#dx1-83026" >456</a>, <a
-href="glossaries-extra-manual.html#dx1-83027" >457</a>, <a
-href="glossaries-extra-manual.html#dx1-83028" >458</a>, <a
-href="glossaries-extra-manual.html#dx1-84001" >459</a>, <a
-href="glossaries-extra-manual.html#dx1-84002" >460</a>, <a
-href="glossaries-extra-manual.html#dx1-84003" >461</a>, <a
-href="glossaries-extra-manual.html#dx1-84005" >462</a>, <a
-href="glossaries-extra-manual.html#dx1-84023" >463</a>, <a
-href="glossaries-extra-manual.html#dx1-86024" >464</a>, <a
-href="glossaries-extra-manual.html#dx1-86070" >465</a>, <a
-href="glossaries-extra-manual.html#dx1-87007" >466</a>, <a
-href="glossaries-extra-manual.html#dx1-87017" >467</a>, <a
-href="glossaries-extra-manual.html#dx1-88014" >468</a>, <a
-href="glossaries-extra-manual.html#dx1-90043" >469</a>, <a
-href="glossaries-extra-manual.html#dx1-90045" >470</a>, <a
-href="glossaries-extra-manual.html#dx1-90048" >471</a>, <a
-href="glossaries-extra-manual.html#dx1-90049" >472</a>, <a
-href="glossaries-extra-manual.html#dx1-90052" >473</a>, <a
-href="glossaries-extra-manual.html#dx1-90053" >474</a>, <a
-href="glossaries-extra-manual.html#dx1-92002" >475</a>, <a
-href="glossaries-extra-manual.html#dx1-92013" >476</a>, <a
-href="glossaries-extra-manual.html#dx1-98010" >477</a>, <a
-href="glossaries-extra-manual.html#dx1-99001" ><span
-class="cmbx-10">478</span></a> <br /></span>
-</p><p class="theindex"> <span
-class="cmbx-10">C</span>
-<span class="index-item">categories:<br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">abbreviation</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-10004" >479</a>, <a
-href="glossaries-extra-manual.html#dx1-27024" >480</a>, <a
-href="glossaries-extra-manual.html#dx1-28007" >481</a>, <a
-href="glossaries-extra-manual.html#dx1-71008" >482</a>, <a
-href="glossaries-extra-manual.html#dx1-74015" >483</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">acronym</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-3028" >484</a>, <a
-href="glossaries-extra-manual.html#dx1-17035" >485</a>, <a
-href="glossaries-extra-manual.html#dx1-27022" >486</a>, <a
-href="glossaries-extra-manual.html#dx1-28006" >487</a>, <a
-href="glossaries-extra-manual.html#dx1-71009" >488</a>, <a
-href="glossaries-extra-manual.html#dx1-71023" >489</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">general</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-9037" >490</a>, <a
-href="glossaries-extra-manual.html#dx1-9066" >491</a>, <a
-href="glossaries-extra-manual.html#dx1-17034" >492</a>, <a
-href="glossaries-extra-manual.html#dx1-17038" >493</a>, <a
-href="glossaries-extra-manual.html#dx1-71007" >494</a>, <a
-href="glossaries-extra-manual.html#dx1-71022" >495</a>, <a
-href="glossaries-extra-manual.html#dx1-71194" >496</a>, <a
-href="glossaries-extra-manual.html#dx1-73040" >497</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">index</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-6030" >498</a>, <a
-href="glossaries-extra-manual.html#dx1-71012" >499</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">number</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71018" >500</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">symbol</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-9045" >501</a>, <a
-href="glossaries-extra-manual.html#dx1-71015" >502</a> <br /></span>
-<span class="index-item">category attributes:<br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">accessaposplural</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71139" >503</a>, <a
-href="glossaries-extra-manual.html#dx1-71149" >504</a>, <a
-href="glossaries-extra-manual.html#dx1-71159" >505</a>, <a
-href="glossaries-extra-manual.html#dx1-71163" >506</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">accessinsertdots</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71138" >507</a>, <a
-href="glossaries-extra-manual.html#dx1-71142" >508</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">accessnoshortplural</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71140" >509</a>, <a
-href="glossaries-extra-manual.html#dx1-71160" >510</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">aposplural</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-12036" >511</a>, <a
-href="glossaries-extra-manual.html#dx1-31047" >512</a>, <a
-href="glossaries-extra-manual.html#dx1-71071" >513</a>, <a
-href="glossaries-extra-manual.html#dx1-71079" >514</a>, <a
-href="glossaries-extra-manual.html#dx1-71150" >515</a>, <a
-href="glossaries-extra-manual.html#dx1-71154" >516</a>, <a
-href="glossaries-extra-manual.html#dx1-71156" >517</a>, <a
-href="glossaries-extra-manual.html#dx1-71158" >518</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">combinedfirstsep</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-48004" >519</a>, <a
-href="glossaries-extra-manual.html#dx1-71173" >520</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">combinedfirstsepfirst</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-48008" >521</a>, <a
-href="glossaries-extra-manual.html#dx1-71175" >522</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">combinedsep</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-48002" >523</a>, <a
-href="glossaries-extra-manual.html#dx1-71179" >524</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">combinedsepfirst</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-48006" >525</a>, <a
-href="glossaries-extra-manual.html#dx1-71177" >526</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">discardperiod</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-9032" >527</a>, <a
-href="glossaries-extra-manual.html#dx1-43001" >528</a>, <a
-href="glossaries-extra-manual.html#dx1-71042" >529</a>, <a
-href="glossaries-extra-manual.html#dx1-71049" >530</a>, <a
-href="glossaries-extra-manual.html#dx1-71052" >531</a>, <a
-href="glossaries-extra-manual.html#dx1-71070" >532</a> <br /></span>
-
-
-
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">dualindex</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71119" >533</a>, <a
-href="glossaries-extra-manual.html#dx1-75002" >534</a>, <a
-href="glossaries-extra-manual.html#dx1-75015" >535</a>, <a
-href="glossaries-extra-manual.html#dx1-75031" >536</a>, <a
-href="glossaries-extra-manual.html#dx1-75038" >537</a>, <a
-href="glossaries-extra-manual.html#dx1-75041" >538</a>, <a
-href="glossaries-extra-manual.html#dx1-97003" >539</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">entrycount</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-10003" >540</a>, <a
-href="glossaries-extra-manual.html#dx1-71085" >541</a>, <a
-href="glossaries-extra-manual.html#dx1-71089" >542</a>, <a
-href="glossaries-extra-manual.html#dx1-73002" >543</a>, <a
-href="glossaries-extra-manual.html#dx1-73007" >544</a>, <a
-href="glossaries-extra-manual.html#dx1-73019" >545</a>, <a
-href="glossaries-extra-manual.html#dx1-73023" >546</a>, <a
-href="glossaries-extra-manual.html#dx1-73024" >547</a>, <a
-href="glossaries-extra-manual.html#dx1-73028" >548</a>, <a
-href="glossaries-extra-manual.html#dx1-73029" >549</a>, <a
-href="glossaries-extra-manual.html#dx1-73033" >550</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">externallocation</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7061" >551</a>, <a
-href="glossaries-extra-manual.html#dx1-7065" >552</a>, <a
-href="glossaries-extra-manual.html#dx1-71130" >553</a>, <a
-href="glossaries-extra-manual.html#dx1-80003" >554</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">firstshortaccess</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71170" >555</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">glossdesc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-17005" >556</a>, <a
-href="glossaries-extra-manual.html#dx1-71094" >557</a>, <a
-href="glossaries-extra-manual.html#dx1-71105" >558</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">glossdescfont</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-17006" >559</a>, <a
-href="glossaries-extra-manual.html#dx1-71102" >560</a>, <a
-href="glossaries-extra-manual.html#dx1-71114" >561</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">glossname</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-17003" >562</a>, <a
-href="glossaries-extra-manual.html#dx1-17021" >563</a>, <a
-href="glossaries-extra-manual.html#dx1-71104" >564</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">glossnamefont</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-17004" >565</a>, <a
-href="glossaries-extra-manual.html#dx1-17022" >566</a>, <a
-href="glossaries-extra-manual.html#dx1-71110" >567</a>, <a
-href="glossaries-extra-manual.html#dx1-71113" >568</a>, <a
-href="glossaries-extra-manual.html#dx1-91011" >569</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">glosssymbolfont</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-17008" >570</a>, <a
-href="glossaries-extra-manual.html#dx1-71112" >571</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">headuc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-13059" >572</a>, <a
-href="glossaries-extra-manual.html#dx1-37006" >573</a>, <a
-href="glossaries-extra-manual.html#dx1-37008" >574</a>, <a
-href="glossaries-extra-manual.html#dx1-71080" >575</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">hyperoutside</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7019" >576</a>, <a
-href="glossaries-extra-manual.html#dx1-71117" >577</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">indexname</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-17027" >578</a>, <a
-href="glossaries-extra-manual.html#dx1-71107" >579</a>, <a
-href="glossaries-extra-manual.html#dx1-75001" >580</a>, <a
-href="glossaries-extra-manual.html#dx1-75013" >581</a>, <a
-href="glossaries-extra-manual.html#dx1-97004" >582</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">indexonlyfirst</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7007" >583</a>, <a
-href="glossaries-extra-manual.html#dx1-71037" >584</a>, <a
-href="glossaries-extra-manual.html#dx1-75039" >585</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">insertdots</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-27013" >586</a>, <a
-href="glossaries-extra-manual.html#dx1-71064" >587</a>, <a
-href="glossaries-extra-manual.html#dx1-71066" >588</a>, <a
-href="glossaries-extra-manual.html#dx1-71145" >589</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">linkcount</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71090" >590</a>, <a
-href="glossaries-extra-manual.html#dx1-74003" >591</a>, <a
-href="glossaries-extra-manual.html#dx1-74016" >592</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">linkcountmaster</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71092" >593</a>, <a
-href="glossaries-extra-manual.html#dx1-74004" >594</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">markshortwords</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71061" >595</a>, <a
-href="glossaries-extra-manual.html#dx1-71068" >596</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">markwords</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33259" >597</a>, <a
-href="glossaries-extra-manual.html#dx1-33262" >598</a>, <a
-href="glossaries-extra-manual.html#dx1-33265" >599</a>, <a
-href="glossaries-extra-manual.html#dx1-34032" >600</a>, <a
-href="glossaries-extra-manual.html#dx1-71054" >601</a>, <a
-href="glossaries-extra-manual.html#dx1-71062" >602</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">multioptions</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-44001" >603</a>, <a
-href="glossaries-extra-manual.html#dx1-54001" >604</a>, <a
-href="glossaries-extra-manual.html#dx1-55002" >605</a>, <a
-href="glossaries-extra-manual.html#dx1-55009" >606</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">nameshortaccess</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71164" >607</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">nohyper</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71034" >608</a>, <a
-href="glossaries-extra-manual.html#dx1-71195" >609</a>, <a
-href="glossaries-extra-manual.html#dx1-71196" >610</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">nohyperfirst</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33156" >611</a>, <a
-href="glossaries-extra-manual.html#dx1-34021" >612</a>, <a
-href="glossaries-extra-manual.html#dx1-34023" >613</a>, <a
-href="glossaries-extra-manual.html#dx1-71025" >614</a>, <a
-href="glossaries-extra-manual.html#dx1-71032" >615</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">noshortplural</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-12037" >616</a>, <a
-href="glossaries-extra-manual.html#dx1-27014" >617</a>, <a
-href="glossaries-extra-manual.html#dx1-31048" >618</a>, <a
-href="glossaries-extra-manual.html#dx1-71074" >619</a>, <a
-href="glossaries-extra-manual.html#dx1-71075" >620</a>, <a
-href="glossaries-extra-manual.html#dx1-71161" >621</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">pluraldiscardperiod</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71048" >622</a>, <a
-href="glossaries-extra-manual.html#dx1-71053" >623</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">recordcount</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-84015" >624</a>, <a
-href="glossaries-extra-manual.html#dx1-84017" >625</a>, <a
-href="glossaries-extra-manual.html#dx1-84019" >626</a>, <a
-href="glossaries-extra-manual.html#dx1-84021" >627</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">regular</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-9010" >628</a>, <a
-href="glossaries-extra-manual.html#dx1-9019" >629</a>, <a
-href="glossaries-extra-manual.html#dx1-9022" >630</a>, <a
-href="glossaries-extra-manual.html#dx1-29004" >631</a>, <a
-href="glossaries-extra-manual.html#dx1-31005" >632</a>, <a
-href="glossaries-extra-manual.html#dx1-31014" >633</a>, <a
-href="glossaries-extra-manual.html#dx1-31105" >634</a>, <a
-href="glossaries-extra-manual.html#dx1-31107" >635</a>, <a
-href="glossaries-extra-manual.html#dx1-31110" >636</a>, <a
-href="glossaries-extra-manual.html#dx1-32001" >637</a>, <a
-href="glossaries-extra-manual.html#dx1-32111" >638</a>, <a
-href="glossaries-extra-manual.html#dx1-33001" >639</a>, <a
-href="glossaries-extra-manual.html#dx1-33038" >640</a>, <a
-href="glossaries-extra-manual.html#dx1-33058" >641</a>, <a
-href="glossaries-extra-manual.html#dx1-33061" >642</a>, <a
-href="glossaries-extra-manual.html#dx1-33084" >643</a>, <a
-href="glossaries-extra-manual.html#dx1-33096" >644</a>, <a
-href="glossaries-extra-manual.html#dx1-33099" >645</a>, <a
-href="glossaries-extra-manual.html#dx1-33128" >646</a>, <a
-href="glossaries-extra-manual.html#dx1-34022" >647</a>, <a
-href="glossaries-extra-manual.html#dx1-34053" >648</a>, <a
-href="glossaries-extra-manual.html#dx1-34057" >649</a>, <a
-href="glossaries-extra-manual.html#dx1-34061" >650</a>, <a
-href="glossaries-extra-manual.html#dx1-34065" >651</a>, <a
-href="glossaries-extra-manual.html#dx1-34081" >652</a>, <a
-href="glossaries-extra-manual.html#dx1-71024" >653</a>, <a
-href="glossaries-extra-manual.html#dx1-71184" >654</a>, <a
-href="glossaries-extra-manual.html#dx1-71198" >655</a>, <a
-href="glossaries-extra-manual.html#dx1-71201" >656</a>, <a
-href="glossaries-extra-manual.html#dx1-71202" >657</a>, <a
-href="glossaries-extra-manual.html#dx1-71205" >658</a>, <a
-href="glossaries-extra-manual.html#dx1-84031" >659</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">retainfirstuseperiod</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-43002" >660</a>, <a
-href="glossaries-extra-manual.html#dx1-71050" >661</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">tagging</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-28002" >662</a>, <a
-href="glossaries-extra-manual.html#dx1-28005" >663</a>, <a
-href="glossaries-extra-manual.html#dx1-28008" >664</a>, <a
-href="glossaries-extra-manual.html#dx1-71082" >665</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">targetcategory</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71128" >666</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">targetname</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71125" >667</a>, <a
-href="glossaries-extra-manual.html#dx1-71127" >668</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">targeturl</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-15002" >669</a>, <a
-href="glossaries-extra-manual.html#dx1-71123" >670</a>, <a
-href="glossaries-extra-manual.html#dx1-71126" >671</a>, <a
-href="glossaries-extra-manual.html#dx1-92006" >672</a>, <a
-href="glossaries-extra-manual.html#dx1-97009" >673</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">textformat</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7020" >674</a>, <a
-href="glossaries-extra-manual.html#dx1-7023" >675</a>, <a
-href="glossaries-extra-manual.html#dx1-9028" >676</a>, <a
-href="glossaries-extra-manual.html#dx1-11018" >677</a>, <a
-href="glossaries-extra-manual.html#dx1-71116" >678</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">textshortaccess</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71167" >679</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">unitcount</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-73034" >680</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">wrgloss</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7015" >681</a>, <a
-href="glossaries-extra-manual.html#dx1-71039" >682</a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\cGLS</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-73015" ><span
-class="cmti-10">683</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\cGLSformat</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-73017" ><span
-class="cmti-10">684</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\cGLSpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-73016" ><span
-class="cmti-10">685</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\cGLSplformat</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-73018" ><span
-class="cmti-10">686</span></a> <br /></span>
-<span class="index-item"><span
-class="cmtt-10">convertgls2bib</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-76003" >687</a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\csGlsXtrLetField</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86030" ><span
-class="cmti-10">688</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\CustomAbbreviationFields</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34006" ><span
-class="cmti-10">689</span></a> <br /></span>
-</p><p class="theindex"> <span
-class="cmbx-10">D</span>
-<span class="index-item"><span
-class="cmss-10">datatool </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86044" >690</a> <br /></span>
-
-
-
-<span class="index-item"><span
-class="cmss-10">datatool-base </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-9" >691</a>, <a
-href="glossaries-extra-manual.html#dx1-86043" >692</a>, <a
-href="glossaries-extra-manual.html#dx1-86066" >693</a>, <a
-href="glossaries-extra-manual.html#dx1-86069" >694</a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\dGLS</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-83022" ><span
-class="cmti-10">695</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\dGls</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-83020" ><span
-class="cmti-10">696</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\dgls</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-83018" ><span
-class="cmti-10">697</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\dglsdisp</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-83025" ><span
-class="cmti-10">698</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\dglslink</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-83024" ><span
-class="cmti-10">699</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\dGLSpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-83023" ><span
-class="cmti-10">700</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\dGlspl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-83021" ><span
-class="cmti-10">701</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\dglspl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-83019" ><span
-class="cmti-10">702</span></a> <br /></span>
-</p><p class="theindex"> <span
-class="cmbx-10">E</span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\eglssetwidest</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22067" ><span
-class="cmti-10">703</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\eglsupdatewidest</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22071" ><span
-class="cmti-10">704</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\eGlsXtrSetField</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86027" ><span
-class="cmti-10">705</span></a> <br /></span>
-<span class="index-item">entry location&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-99004" ><span
-class="cmbx-10">706</span></a>, <a
-href="glossaries-extra-manual.html#dx1-99024" >707</a>, <a
-href="glossaries-extra-manual.html#dx1-99035" >708</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">entrycounter </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-91020" >709</a> <br /></span>
-<span class="index-item"><span
-class="cmtt-10">equation </span>(counter)&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4133" >710</a>, <a
-href="glossaries-extra-manual.html#dx1-4158" >711</a>, <a
-href="glossaries-extra-manual.html#dx1-7043" >712</a>, <a
-href="glossaries-extra-manual.html#dx1-81008" >713</a>, <a
-href="glossaries-extra-manual.html#dx1-81021" >714</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">etoolbox </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-5" >715</a>, <a
-href="glossaries-extra-manual.html#dx1-71191" >716</a>, <a
-href="glossaries-extra-manual.html#dx1-74010" >717</a>, <a
-href="glossaries-extra-manual.html#dx1-86021" >718</a>, <a
-href="glossaries-extra-manual.html#dx1-86039" >719</a>, <a
-href="glossaries-extra-manual.html#dx1-86055" >720</a>, <a
-href="glossaries-extra-manual.html#dx1-86056" >721</a>, <a
-href="glossaries-extra-manual.html#dx1-86064" >722</a>, <a
-href="glossaries-extra-manual.html#dx1-86068" >723</a>, <a
-href="glossaries-extra-manual.html#dx1-86073" >724</a>, <a
-href="glossaries-extra-manual.html#dx1-86075" >725</a> <br /></span>
-</p><p class="theindex"> <span
-class="cmbx-10">F</span>
-<span class="index-item"><span
-class="cmtt-10">\false </span>options<br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">groups</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-15018" >726</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">fancyhdr </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24049" >727</a> <br /></span>
-<span class="index-item">file types<br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">aux</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-38006" >728</a>, <a
-href="glossaries-extra-manual.html#dx1-69010" >729</a>, <a
-href="glossaries-extra-manual.html#dx1-69012" >730</a>, <a
-href="glossaries-extra-manual.html#dx1-70003" >731</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">bib</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4112" >732</a>, <a
-href="glossaries-extra-manual.html#dx1-70006" >733</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">glg-abr</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4219" >734</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">glo-abr</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4221" >735</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmtt-10">gls-abr</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4220" >736</a> <br /></span>
-<span class="index-item">first use&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-3017" >737</a>, <a
-href="glossaries-extra-manual.html#dx1-7005" >738</a>, <a
-href="glossaries-extra-manual.html#dx1-9015" >739</a>, <a
-href="glossaries-extra-manual.html#dx1-9043" >740</a>, <a
-href="glossaries-extra-manual.html#dx1-9044" >741</a>, <a
-href="glossaries-extra-manual.html#dx1-9047" >742</a>, <a
-href="glossaries-extra-manual.html#dx1-9049" >743</a>, <a
-href="glossaries-extra-manual.html#dx1-9054" >744</a>, <a
-href="glossaries-extra-manual.html#dx1-9058" >745</a>, <a
-href="glossaries-extra-manual.html#dx1-9061" >746</a>, <a
-href="glossaries-extra-manual.html#dx1-9063" >747</a>, <a
-href="glossaries-extra-manual.html#dx1-9065" >748</a>, <a
-href="glossaries-extra-manual.html#dx1-13008" >749</a>, <a
-href="glossaries-extra-manual.html#dx1-13019" >750</a>, <a
-href="glossaries-extra-manual.html#dx1-13020" >751</a>, <a
-href="glossaries-extra-manual.html#dx1-13021" >752</a>, <a
-href="glossaries-extra-manual.html#dx1-13022" >753</a>, <a
-href="glossaries-extra-manual.html#dx1-13026" >754</a>, <a
-href="glossaries-extra-manual.html#dx1-13030" >755</a>, <a
-href="glossaries-extra-manual.html#dx1-13034" >756</a>, <a
-href="glossaries-extra-manual.html#dx1-13048" >757</a>, <a
-href="glossaries-extra-manual.html#dx1-13049" >758</a>, <a
-href="glossaries-extra-manual.html#dx1-14069" >759</a>, <a
-href="glossaries-extra-manual.html#dx1-14070" >760</a>, <a
-href="glossaries-extra-manual.html#dx1-27005" >761</a>, <a
-href="glossaries-extra-manual.html#dx1-27010" >762</a>, <a
-href="glossaries-extra-manual.html#dx1-27025" >763</a>, <a
-href="glossaries-extra-manual.html#dx1-29017" >764</a>, <a
-href="glossaries-extra-manual.html#dx1-29019" >765</a>, <a
-href="glossaries-extra-manual.html#dx1-31006" >766</a>, <a
-href="glossaries-extra-manual.html#dx1-31020" >767</a>, <a
-href="glossaries-extra-manual.html#dx1-32003" >768</a>, <a
-href="glossaries-extra-manual.html#dx1-33003" >769</a>, <a
-href="glossaries-extra-manual.html#dx1-33063" >770</a>, <a
-href="glossaries-extra-manual.html#dx1-33101" >771</a>, <a
-href="glossaries-extra-manual.html#dx1-33130" >772</a>, <a
-href="glossaries-extra-manual.html#dx1-33155" >773</a>, <a
-href="glossaries-extra-manual.html#dx1-33157" >774</a>, <a
-href="glossaries-extra-manual.html#dx1-33164" >775</a>, <a
-href="glossaries-extra-manual.html#dx1-33204" >776</a>, <a
-href="glossaries-extra-manual.html#dx1-33208" >777</a>, <a
-href="glossaries-extra-manual.html#dx1-34044" >778</a>, <a
-href="glossaries-extra-manual.html#dx1-34048" >779</a>, <a
-href="glossaries-extra-manual.html#dx1-34052" >780</a>, <a
-href="glossaries-extra-manual.html#dx1-34056" >781</a>, <a
-href="glossaries-extra-manual.html#dx1-34060" >782</a>, <a
-href="glossaries-extra-manual.html#dx1-34064" >783</a>, <a
-href="glossaries-extra-manual.html#dx1-38001" >784</a>, <a
-href="glossaries-extra-manual.html#dx1-45002" >785</a>, <a
-href="glossaries-extra-manual.html#dx1-45005" >786</a>, <a
-href="glossaries-extra-manual.html#dx1-48012" >787</a>, <a
-href="glossaries-extra-manual.html#dx1-71027" >788</a>, <a
-href="glossaries-extra-manual.html#dx1-71029" >789</a>, <a
-href="glossaries-extra-manual.html#dx1-71051" >790</a>, <a
-href="glossaries-extra-manual.html#dx1-73039" >791</a>, <a
-href="glossaries-extra-manual.html#dx1-97001" >792</a>, <a
-href="glossaries-extra-manual.html#dx1-99005" ><span
-class="cmbx-10">793</span></a>, <a
-href="glossaries-extra-manual.html#dx1-99014" >794</a>, <a
-href="glossaries-extra-manual.html#dx1-99016" >795</a> <br /></span>
-<span class="index-item">first use flag&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-9052" >796</a>, <a
-href="glossaries-extra-manual.html#dx1-11008" >797</a>, <a
-href="glossaries-extra-manual.html#dx1-35001" >798</a>, <a
-href="glossaries-extra-manual.html#dx1-44003" >799</a>, <a
-href="glossaries-extra-manual.html#dx1-45003" >800</a>, <a
-href="glossaries-extra-manual.html#dx1-45006" >801</a>, <a
-href="glossaries-extra-manual.html#dx1-49011" >802</a>, <a
-href="glossaries-extra-manual.html#dx1-53001" >803</a>, <a
-href="glossaries-extra-manual.html#dx1-53002" >804</a>, <a
-href="glossaries-extra-manual.html#dx1-53010" >805</a>, <a
-href="glossaries-extra-manual.html#dx1-53011" >806</a>, <a
-href="glossaries-extra-manual.html#dx1-62001" >807</a>, <a
-href="glossaries-extra-manual.html#dx1-62002" >808</a>, <a
-href="glossaries-extra-manual.html#dx1-62003" >809</a>, <a
-href="glossaries-extra-manual.html#dx1-62004" >810</a>, <a
-href="glossaries-extra-manual.html#dx1-62005" >811</a>, <a
-href="glossaries-extra-manual.html#dx1-62006" >812</a>, <a
-href="glossaries-extra-manual.html#dx1-62007" >813</a>, <a
-href="glossaries-extra-manual.html#dx1-63001" >814</a>, <a
-href="glossaries-extra-manual.html#dx1-73004" >815</a>, <a
-href="glossaries-extra-manual.html#dx1-73022" >816</a>, <a
-href="glossaries-extra-manual.html#dx1-84024" >817</a>, <a
-href="glossaries-extra-manual.html#dx1-99013" ><span
-class="cmbx-10">818</span></a> <br /></span>
-<span class="index-item">first use text&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-99015" ><span
-class="cmbx-10">819</span></a>, <a
-href="glossaries-extra-manual.html#dx1-99038" >820</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">fontenc </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31024" >821</a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\forallabbreviationlists</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-27040" ><span
-class="cmti-10">822</span></a> <br /></span>
-</p><p class="theindex"> <span
-class="cmbx-10">G</span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gglssetwidest</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22065" ><span
-class="cmti-10">823</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gglsupdatewidest</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22070" ><span
-class="cmti-10">824</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\gGlsXtrSetField</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86026" ><span
-class="cmti-10">825</span></a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">glossaries </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4204" >826</a>, <a
-href="glossaries-extra-manual.html#dx1-6018" >827</a>, <a
-href="glossaries-extra-manual.html#dx1-8020" >828</a>, <a
-href="glossaries-extra-manual.html#dx1-8023" >829</a>, <a
-href="glossaries-extra-manual.html#dx1-8025" >830</a>, <a
-href="glossaries-extra-manual.html#dx1-8078" >831</a>, <a
-href="glossaries-extra-manual.html#dx1-12001" >832</a>, <a
-href="glossaries-extra-manual.html#dx1-12003" >833</a>, <a
-href="glossaries-extra-manual.html#dx1-12012" >834</a>, <a
-href="glossaries-extra-manual.html#dx1-12029" >835</a>, <a
-href="glossaries-extra-manual.html#dx1-16003" >836</a>, <a
-href="glossaries-extra-manual.html#dx1-16004" >837</a>, <a
-href="glossaries-extra-manual.html#dx1-71031" >838</a>, <a
-href="glossaries-extra-manual.html#dx1-81007" >839</a>, <a
-href="glossaries-extra-manual.html#dx1-81012" >840</a>, <a
-href="glossaries-extra-manual.html#dx1-82009" >841</a>, <a
-href="glossaries-extra-manual.html#dx1-82034" >842</a>, <a
-href="glossaries-extra-manual.html#dx1-86052" >843</a>, <a
-href="glossaries-extra-manual.html#dx1-86077" >844</a>, <a
-href="glossaries-extra-manual.html#dx1-87019" >845</a> <br /></span>
-
-
-
-<span class="index-item"><span
-class="cmss-10">glossaries-accsupp </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4039" >846</a>, <a
-href="glossaries-extra-manual.html#dx1-4040" >847</a>, <a
-href="glossaries-extra-manual.html#dx1-4041" >848</a>, <a
-href="glossaries-extra-manual.html#dx1-4044" >849</a>, <a
-href="glossaries-extra-manual.html#dx1-4047" >850</a>, <a
-href="glossaries-extra-manual.html#dx1-17014" >851</a>, <a
-href="glossaries-extra-manual.html#dx1-34086" >852</a>, <a
-href="glossaries-extra-manual.html#dx1-34087" >853</a>, <a
-href="glossaries-extra-manual.html#dx1-71136" >854</a>, <a
-href="glossaries-extra-manual.html#dx1-71143" >855</a>, <a
-href="glossaries-extra-manual.html#dx1-91018" >856</a>, <a
-href="glossaries-extra-manual.html#dx1-94002" >857</a>, <a
-href="glossaries-extra-manual.html#dx1-96001" >858</a>, <a
-href="glossaries-extra-manual.html#dx1-96002" >859</a>, <a
-href="glossaries-extra-manual.html#dx1-96004" >860</a>, <a
-href="glossaries-extra-manual.html#dx1-96005" >861</a>, <a
-href="glossaries-extra-manual.html#dx1-96007" >862</a>, <a
-href="glossaries-extra-manual.html#dx1-96010" >863</a>, <a
-href="glossaries-extra-manual.html#dx1-96012" >864</a>, <a
-href="glossaries-extra-manual.html#dx1-96014" >865</a>, <a
-href="glossaries-extra-manual.html#dx1-96015" >866</a>, <a
-href="glossaries-extra-manual.html#dx1-97021" >867</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">glossaries-extra </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-6020" >868</a>, <a
-href="glossaries-extra-manual.html#dx1-8027" >869</a>, <a
-href="glossaries-extra-manual.html#dx1-8030" >870</a>, <a
-href="glossaries-extra-manual.html#dx1-8039" >871</a>, <a
-href="glossaries-extra-manual.html#dx1-16005" >872</a>, <a
-href="glossaries-extra-manual.html#dx1-71137" >873</a>, <a
-href="glossaries-extra-manual.html#dx1-82027" >874</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">glossaries-extra-bib2gls </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4086" >875</a>, <a
-href="glossaries-extra-manual.html#dx1-4087" >876</a>, <a
-href="glossaries-extra-manual.html#dx1-4121" >877</a>, <a
-href="glossaries-extra-manual.html#dx1-4223" >878</a>, <a
-href="glossaries-extra-manual.html#dx1-4240" >879</a>, <a
-href="glossaries-extra-manual.html#dx1-4245" >880</a>, <a
-href="glossaries-extra-manual.html#dx1-4250" >881</a>, <a
-href="glossaries-extra-manual.html#dx1-4255" >882</a>, <a
-href="glossaries-extra-manual.html#dx1-70011" >883</a>, <a
-href="glossaries-extra-manual.html#dx1-79003" >884</a>, <a
-href="glossaries-extra-manual.html#dx1-79008" >885</a>, <a
-href="glossaries-extra-manual.html#dx1-79018" >886</a>, <a
-href="glossaries-extra-manual.html#dx1-79023" >887</a>, <a
-href="glossaries-extra-manual.html#dx1-82011" >888</a>, <a
-href="glossaries-extra-manual.html#dx1-82037" >889</a>, <a
-href="glossaries-extra-manual.html#dx1-98007" >890</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">glossaries-extra-stylemods </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4029" >891</a>, <a
-href="glossaries-extra-manual.html#dx1-4049" >892</a>, <a
-href="glossaries-extra-manual.html#dx1-16001" >893</a>, <a
-href="glossaries-extra-manual.html#dx1-19001" >894</a>, <a
-href="glossaries-extra-manual.html#dx1-19002" >895</a>, <a
-href="glossaries-extra-manual.html#dx1-22026" >896</a>, <a
-href="glossaries-extra-manual.html#dx1-22038" >897</a>, <a
-href="glossaries-extra-manual.html#dx1-79041" >898</a>, <a
-href="glossaries-extra-manual.html#dx1-87004" >899</a>, <a
-href="glossaries-extra-manual.html#dx1-97011" >900</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">glossaries-prefix </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4037" >901</a>, <a
-href="glossaries-extra-manual.html#dx1-67001" >902</a>, <a
-href="glossaries-extra-manual.html#dx1-94001" >903</a>, <a
-href="glossaries-extra-manual.html#dx1-95001" >904</a>, <a
-href="glossaries-extra-manual.html#dx1-97022" >905</a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glossariesextrasetup</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4282" ><span
-class="cmti-10">906</span></a> <br /></span>
-<span class="index-item">glossary styles:<br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">altlist</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22006" >907</a>, <a
-href="glossaries-extra-manual.html#dx1-22009" >908</a>, <a
-href="glossaries-extra-manual.html#dx1-22014" >909</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">alttree</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22037" >910</a>, <a
-href="glossaries-extra-manual.html#dx1-22039" >911</a>, <a
-href="glossaries-extra-manual.html#dx1-22054" >912</a>, <a
-href="glossaries-extra-manual.html#dx1-22062" >913</a>, <a
-href="glossaries-extra-manual.html#dx1-22080" >914</a>, <a
-href="glossaries-extra-manual.html#dx1-22099" >915</a>, <a
-href="glossaries-extra-manual.html#dx1-22102" >916</a>, <a
-href="glossaries-extra-manual.html#dx1-25026" >917</a>, <a
-href="glossaries-extra-manual.html#dx1-25027" >918</a>, <a
-href="glossaries-extra-manual.html#dx1-26004" >919</a>, <a
-href="glossaries-extra-manual.html#dx1-79036" >920</a>, <a
-href="glossaries-extra-manual.html#dx1-79042" >921</a>, <a
-href="glossaries-extra-manual.html#dx1-97012" >922</a>, <a
-href="glossaries-extra-manual.html#dx1-97013" >923</a>, <a
-href="glossaries-extra-manual.html#dx1-97014" >924</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">bookindex</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24002" >925</a>, <a
-href="glossaries-extra-manual.html#dx1-24006" >926</a>, <a
-href="glossaries-extra-manual.html#dx1-24036" >927</a>, <a
-href="glossaries-extra-manual.html#dx1-24037" >928</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">index</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22042" >929</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">inline</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-20001" >930</a>, <a
-href="glossaries-extra-manual.html#dx1-20003" >931</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">list</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22001" >932</a>, <a
-href="glossaries-extra-manual.html#dx1-22005" >933</a>, <a
-href="glossaries-extra-manual.html#dx1-22013" >934</a>, <a
-href="glossaries-extra-manual.html#dx1-90044" >935</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">listdotted</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22007" >936</a>, <a
-href="glossaries-extra-manual.html#dx1-22015" >937</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">listhypergroup</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-15008" >938</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-21003" >939</a>, <a
-href="glossaries-extra-manual.html#dx1-90001" >940</a>, <a
-href="glossaries-extra-manual.html#dx1-90031" >941</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-desc-name</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25066" >942</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-desc-sym-name</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25133" >943</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-loc-desc-name</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25075" >944</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-loc-desc-sym-name</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25141" >945</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-loc-sym-desc-name</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25125" >946</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-name-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25044" >947</a>, <a
-href="glossaries-extra-manual.html#dx1-25058" >948</a>, <a
-href="glossaries-extra-manual.html#dx1-25067" >949</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-name-desc-loc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25057" >950</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-name-desc-sym</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25083" >951</a>, <a
-href="glossaries-extra-manual.html#dx1-25100" >952</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-name-desc-sym-loc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25091" >953</a>, <a
-href="glossaries-extra-manual.html#dx1-25109" >954</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-name-sym-desc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25099" >955</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-name-sym-desc-loc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25108" >956</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long-sym-desc-name</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25117" >957</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long3col</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-19004" >958</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">longragged-booktabs</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25045" >959</a>, <a
-href="glossaries-extra-manual.html#dx1-25048" >960</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">mcolindexgroup</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24003" >961</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">super</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-90002" >962</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">topic</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26006" >963</a>, <a
-href="glossaries-extra-manual.html#dx1-26010" >964</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">topicmcols</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26009" >965</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">tree</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22036" >966</a>, <a
-href="glossaries-extra-manual.html#dx1-22043" >967</a>, <a
-href="glossaries-extra-manual.html#dx1-22052" >968</a>, <a
-href="glossaries-extra-manual.html#dx1-26005" >969</a>, <a
-href="glossaries-extra-manual.html#dx1-26007" >970</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">treenoname</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22048" >971</a>, <a
-href="glossaries-extra-manual.html#dx1-22050" >972</a>, <a
-href="glossaries-extra-manual.html#dx1-22053" >973</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">glossary-bookindex </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24001" >974</a>, <a
-href="glossaries-extra-manual.html#dx1-24043" >975</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">glossary-inline </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-20002" >976</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">glossary-list </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-90003" >977</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">glossary-long </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25018" >978</a>, <a
-href="glossaries-extra-manual.html#dx1-25022" >979</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">glossary-longextra </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25001" >980</a>, <a
-href="glossaries-extra-manual.html#dx1-79037" >981</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">glossary-topic </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26001" >982</a>, <a
-href="glossaries-extra-manual.html#dx1-26019" >983</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">glossary-tree </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22022" >984</a>, <a
-href="glossaries-extra-manual.html#dx1-22033" >985</a>, <a
-href="glossaries-extra-manual.html#dx1-22063" >986</a>, <a
-href="glossaries-extra-manual.html#dx1-22066" >987</a>, <a
-href="glossaries-extra-manual.html#dx1-22077" >988</a>, <a
-href="glossaries-extra-manual.html#dx1-24042" >989</a>, <a
-href="glossaries-extra-manual.html#dx1-26003" >990</a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glossentrynameother</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-17020" ><span
-class="cmti-10">991</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glossxtrsetpopts</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-13058" ><span
-class="cmti-10">992</span></a> <br /></span>
-
-
-
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsabbrvdefaultfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31033" ><span
-class="cmti-10">993</span></a>, <a
-href="glossaries-extra-manual.html#dx1-31043" ><span
-class="cmti-10">994</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsabbrvemfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31057" ><span
-class="cmti-10">995</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsabbrvfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34047" ><span
-class="cmti-10">996</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsabbrvhyphenfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31069" ><span
-class="cmti-10">997</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsabbrvonlyfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31075" ><span
-class="cmti-10">998</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsabbrvscfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31041" ><span
-class="cmti-10">999</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsabbrvsconlyfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31081" ><span
-class="cmti-10">1000</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsabbrvscuserfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31088" ><span
-class="cmti-10">1001</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsabbrvsmfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31051" ><span
-class="cmti-10">1002</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsabbrvuserfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31064" ><span
-class="cmti-10">1003</span></a>, <a
-href="glossaries-extra-manual.html#dx1-33053" ><span
-class="cmti-10">1004</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsaccessdesc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96042" ><span
-class="cmti-10">1005</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsaccessdesc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96040" ><span
-class="cmti-10">1006</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsaccessdescplural</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96046" ><span
-class="cmti-10">1007</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsaccessdescplural</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96044" ><span
-class="cmti-10">1008</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsaccessfirst</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96026" ><span
-class="cmti-10">1009</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsaccessfirst</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96024" ><span
-class="cmti-10">1010</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsaccessfirstplural</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96030" ><span
-class="cmti-10">1011</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsaccessfirstplural</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96028" ><span
-class="cmti-10">1012</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsaccesslong</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96058" ><span
-class="cmti-10">1013</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsaccesslong</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96056" ><span
-class="cmti-10">1014</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsaccesslongpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96062" ><span
-class="cmti-10">1015</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsaccesslongpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96060" ><span
-class="cmti-10">1016</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsaccessname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96013" ><span
-class="cmti-10">1017</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsaccessname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96008" ><span
-class="cmti-10">1018</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsaccessplural</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96022" ><span
-class="cmti-10">1019</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsaccessplural</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96020" ><span
-class="cmti-10">1020</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsaccessshort</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96050" ><span
-class="cmti-10">1021</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsaccessshort</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96048" ><span
-class="cmti-10">1022</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsaccessshortpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96054" ><span
-class="cmti-10">1023</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsaccessshortpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96052" ><span
-class="cmti-10">1024</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsaccesssymbol</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96034" ><span
-class="cmti-10">1025</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsaccesssymbol</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96032" ><span
-class="cmti-10">1026</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsaccesssymbolplural</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96038" ><span
-class="cmti-10">1027</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsaccesssymbolplural</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96036" ><span
-class="cmti-10">1028</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsaccesstext</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96018" ><span
-class="cmti-10">1029</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsaccesstext</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96016" ><span
-class="cmti-10">1030</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsacspace</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14064" ><span
-class="cmti-10">1031</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsacspacemax</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14066" ><span
-class="cmti-10">1032</span></a> <br /></span>
-<span class="index-item"><span
-class="cmtt-10">\glsadd </span>options<br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">format</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7035" >1033</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">theHvalue</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7047" >1034</a>, <a
-href="glossaries-extra-manual.html#dx1-7063" >1035</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">thevalue</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7046" >1036</a>, <a
-href="glossaries-extra-manual.html#dx1-7048" >1037</a>, <a
-href="glossaries-extra-manual.html#dx1-7052" >1038</a>, <a
-href="glossaries-extra-manual.html#dx1-7059" >1039</a>, <a
-href="glossaries-extra-manual.html#dx1-97023" >1040</a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsaddeach</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7001" ><span
-class="cmti-10">1041</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsaddpostsetkeys</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7042" ><span
-class="cmti-10">1042</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsaddpresetkeys</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7041" ><span
-class="cmti-10">1043</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsaltlistitem</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22010" ><span
-class="cmti-10">1044</span></a> <br /></span>
-
-
-
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsalttreechildpredesc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22041" ><span
-class="cmti-10">1045</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsalttreepredesc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22040" ><span
-class="cmti-10">1046</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glscapturedgroup</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82002" ><span
-class="cmti-10">1047</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glscategory</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71019" ><span
-class="cmti-10">1048</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glscategorylabel</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34039" ><span
-class="cmti-10">1049</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glscombinedfirstsep</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-48003" ><span
-class="cmti-10">1050</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glscombinedfirstsepfirst</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-48007" ><span
-class="cmti-10">1051</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glscombinedsep</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-48001" ><span
-class="cmti-10">1052</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glscombinedsepfirst</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-48005" ><span
-class="cmti-10">1053</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glscurrententrylabel</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-17037" ><span
-class="cmti-10">1054</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glscurrentfieldvalue</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86034" ><span
-class="cmti-10">1055</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsdefaultshortaccess</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71135" ><span
-class="cmti-10">1056</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsdefpostdesc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-17036" ><span
-class="cmti-10">1057</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsdefpostlink</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-9038" ><span
-class="cmti-10">1058</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsdefpostname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-17030" ><span
-class="cmti-10">1059</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsentrycurrcount</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-73035" ><span
-class="cmti-10">1060</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsentrypdfsymbol</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-17012" ><span
-class="cmti-10">1061</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsentryprevcount</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-73036" ><span
-class="cmti-10">1062</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsentryprevmaxcount</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-73038" ><span
-class="cmti-10">1063</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsentryprevtotalcount</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-73037" ><span
-class="cmti-10">1064</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsextrapostnamehook</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-17031" ><span
-class="cmti-10">1065</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsFindWidestAnyName</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22083" ><span
-class="cmti-10">1066</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsFindWidestAnyNameLocation</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22095" ><span
-class="cmti-10">1067</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsFindWidestAnyNameSymbol</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22087" ><span
-class="cmti-10">1068</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsFindWidestAnyNameSymbolLocation</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22092" ><span
-class="cmti-10">1069</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsFindWidestLevelTwo</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22085" ><span
-class="cmti-10">1070</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsFindWidestTopLevelName</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22078" ><span
-class="cmti-10">1071</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsFindWidestUsedAnyName</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22081" ><span
-class="cmti-10">1072</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsFindWidestUsedAnyNameLocation</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22093" ><span
-class="cmti-10">1073</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsFindWidestUsedAnyNameSymbol</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22086" ><span
-class="cmti-10">1074</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsFindWidestUsedAnyNameSymbolLocation</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22088" ><span
-class="cmti-10">1075</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsFindWidestUsedLevelTwo</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22084" ><span
-class="cmti-10">1076</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsFindWidestUsedTopLevelName</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22079" ><span
-class="cmti-10">1077</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfirstabbrvdefaultfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31034" ><span
-class="cmti-10">1078</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfirstabbrvemfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31058" ><span
-class="cmti-10">1079</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfirstabbrvfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34045" ><span
-class="cmti-10">1080</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfirstabbrvhyphenfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31070" ><span
-class="cmti-10">1081</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfirstabbrvonlyfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31076" ><span
-class="cmti-10">1082</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfirstabbrvsconlyfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31083" ><span
-class="cmti-10">1083</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfirstabbrvscuserfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31090" ><span
-class="cmti-10">1084</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfirstabbrvsmfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31053" ><span
-class="cmti-10">1085</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfirstabbrvuserfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31065" ><span
-class="cmti-10">1086</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfirstlongdefaultfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31036" ><span
-class="cmti-10">1087</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfirstlongemfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31062" ><span
-class="cmti-10">1088</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfirstlongfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34049" ><span
-class="cmti-10">1089</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfirstlongfootnotefont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33163" ><span
-class="cmti-10">1090</span></a> <br /></span>
-
-
-
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfirstlonghyphenfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31072" ><span
-class="cmti-10">1091</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfirstlongonlyfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31078" ><span
-class="cmti-10">1092</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfirstlonguserfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31067" ><span
-class="cmti-10">1093</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GLSfmtfirst</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37044" ><span
-class="cmti-10">1094</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsfmtfirst</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37043" ><span
-class="cmti-10">1095</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfmtfirst</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37042" ><span
-class="cmti-10">1096</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GLSfmtfirstpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37047" ><span
-class="cmti-10">1097</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsfmtfirstpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37046" ><span
-class="cmti-10">1098</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfmtfirstpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37045" ><span
-class="cmti-10">1099</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GLSfmtfull</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37028" ><span
-class="cmti-10">1100</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsfmtfull</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37026" ><span
-class="cmti-10">1101</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfmtfull</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37024" ><span
-class="cmti-10">1102</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GLSfmtfullpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37029" ><span
-class="cmti-10">1103</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsfmtfullpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37027" ><span
-class="cmti-10">1104</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfmtfullpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37025" ><span
-class="cmti-10">1105</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GLSfmtlong</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37020" ><span
-class="cmti-10">1106</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsfmtlong</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37018" ><span
-class="cmti-10">1107</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfmtlong</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37016" ><span
-class="cmti-10">1108</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GLSfmtlongpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37021" ><span
-class="cmti-10">1109</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsfmtlongpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37019" ><span
-class="cmti-10">1110</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfmtlongpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37017" ><span
-class="cmti-10">1111</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GLSfmtname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37040" ><span
-class="cmti-10">1112</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsfmtname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37039" ><span
-class="cmti-10">1113</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfmtname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37038" ><span
-class="cmti-10">1114</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GLSfmtplural</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37036" ><span
-class="cmti-10">1115</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsfmtplural</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37035" ><span
-class="cmti-10">1116</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfmtplural</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37034" ><span
-class="cmti-10">1117</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GLSfmtshort</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37014" ><span
-class="cmti-10">1118</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsfmtshort</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37012" ><span
-class="cmti-10">1119</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfmtshort</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37010" ><span
-class="cmti-10">1120</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsfmtshortpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37013" ><span
-class="cmti-10">1121</span></a>, <a
-href="glossaries-extra-manual.html#dx1-37015" ><span
-class="cmti-10">1122</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfmtshortpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37011" ><span
-class="cmti-10">1123</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GLSfmttext</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37033" ><span
-class="cmti-10">1124</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsfmttext</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37032" ><span
-class="cmti-10">1125</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsfmttext</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37031" ><span
-class="cmti-10">1126</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsforeachwithattribute</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71206" ><span
-class="cmti-10">1127</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsgetattribute</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71189" ><span
-class="cmti-10">1128</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsgetcategoryattribute</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71188" ><span
-class="cmti-10">1129</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsgetwidestname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22073" ><span
-class="cmti-10">1130</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsgetwidestsubname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22074" ><span
-class="cmti-10">1131</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glshasattribute</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71192" ><span
-class="cmti-10">1132</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glshascategoryattribute</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71190" ><span
-class="cmti-10">1133</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glshex</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82001" ><span
-class="cmti-10">1134</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsifattribute</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71197" ><span
-class="cmti-10">1135</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsifcategory</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71020" ><span
-class="cmti-10">1136</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsifcategoryattribute</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71193" ><span
-class="cmti-10">1137</span></a> <br /></span>
-
-
-
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsifnotregular</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71204" ><span
-class="cmti-10">1138</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsifnotregularcategory</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71203" ><span
-class="cmti-10">1139</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsifregular</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71200" ><span
-class="cmti-10">1140</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsifregularcategory</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71199" ><span
-class="cmti-10">1141</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glskeylisttok</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34037" ><span
-class="cmti-10">1142</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslabeltok</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34036" ><span
-class="cmti-10">1143</span></a> <br /></span>
-<span class="index-item"><span
-class="cmtt-10">\glslink </span>options<br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">counter</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4138" >1144</a>, <a
-href="glossaries-extra-manual.html#dx1-4144" >1145</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">format</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7058" >1146</a>, <a
-href="glossaries-extra-manual.html#dx1-57001" >1147</a>, <a
-href="glossaries-extra-manual.html#dx1-57002" >1148</a>, <a
-href="glossaries-extra-manual.html#dx1-75030" >1149</a>, <a
-href="glossaries-extra-manual.html#dx1-75032" >1150</a>, <a
-href="glossaries-extra-manual.html#dx1-84022" >1151</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">hyper</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-13055" >1152</a>, <a
-href="glossaries-extra-manual.html#dx1-71028" >1153</a>, <a
-href="glossaries-extra-manual.html#dx1-71036" >1154</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">hyper=false</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37005" >1155</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">hyperoutside</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7018" >1156</a>, <a
-href="glossaries-extra-manual.html#dx1-71118" >1157</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">noindex</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7003" >1158</a>, <a
-href="glossaries-extra-manual.html#dx1-7008" >1159</a>, <a
-href="glossaries-extra-manual.html#dx1-7012" >1160</a>, <a
-href="glossaries-extra-manual.html#dx1-13056" >1161</a>, <a
-href="glossaries-extra-manual.html#dx1-37004" >1162</a>, <a
-href="glossaries-extra-manual.html#dx1-75042" >1163</a>, <a
-href="glossaries-extra-manual.html#dx1-92009" >1164</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">prefix</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7025" >1165</a>, <a
-href="glossaries-extra-manual.html#dx1-15012" >1166</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">textformat</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7022" >1167</a>, <a
-href="glossaries-extra-manual.html#dx1-11017" >1168</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">theHvalue</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7028" >1169</a>, <a
-href="glossaries-extra-manual.html#dx1-7050" >1170</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">thevalue</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7027" >1171</a>, <a
-href="glossaries-extra-manual.html#dx1-7049" >1172</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">wrgloss</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7011" >1173</a>, <a
-href="glossaries-extra-manual.html#dx1-7016" >1174</a>, <a
-href="glossaries-extra-manual.html#dx1-7033" >1175</a>, <a
-href="glossaries-extra-manual.html#dx1-71041" >1176</a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslinkcheckfirsthyperhook</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-73042" ><span
-class="cmti-10">1177</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslinkpresetkeys</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7039" ><span
-class="cmti-10">1178</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslistchildpostlocation</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22017" ><span
-class="cmti-10">1179</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslistchildprelocation</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22003" ><span
-class="cmti-10">1180</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslistdesc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22004" ><span
-class="cmti-10">1181</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslistgroupafterheader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22012" ><span
-class="cmti-10">1182</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslistgroupheaderitem</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22011" ><span
-class="cmti-10">1183</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslistgroupskip</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22020" ><span
-class="cmti-10">1184</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslistitem</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22008" ><span
-class="cmti-10">1185</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslistprelocation</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22002" ><span
-class="cmti-10">1186</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslocalreseteach</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-11010" ><span
-class="cmti-10">1187</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslocalunseteach</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-11011" ><span
-class="cmti-10">1188</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongdefaultfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31035" ><span
-class="cmti-10">1189</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongemfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31063" ><span
-class="cmti-10">1190</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraDescAlign</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25020" ><span
-class="cmti-10">1191</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraDescFmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25036" ><span
-class="cmti-10">1192</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraDescNameHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25070" ><span
-class="cmti-10">1193</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraDescNameTabularFooter</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25074" ><span
-class="cmti-10">1194</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraDescNameTabularHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25073" ><span
-class="cmti-10">1195</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraDescSymNameHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25136" ><span
-class="cmti-10">1196</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraDescSymNameTabularFooter</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25140" ><span
-class="cmti-10">1197</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraDescSymNameTabularHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25139" ><span
-class="cmti-10">1198</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraGroupHeading</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25043" ><span
-class="cmti-10">1199</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraHeaderFmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25010" ><span
-class="cmti-10">1200</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraLocationAlign</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25016" ><span
-class="cmti-10">1201</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraLocationDescNameHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25078" ><span
-class="cmti-10">1202</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraLocationDescNameTabularFooter</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25082" ><span
-class="cmti-10">1203</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraLocationDescNameTabularHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25081" ><span
-class="cmti-10">1204</span></a> <br /></span>
-
-
-
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraLocationDescSymNameHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25144" ><span
-class="cmti-10">1205</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraLocationDescSymNameTabularFooter</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25148" ><span
-class="cmti-10">1206</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraLocationDescSymNameTabularHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25147" ><span
-class="cmti-10">1207</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraLocationFmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25038" ><span
-class="cmti-10">1208</span></a>, <a
-href="glossaries-extra-manual.html#dx1-25042" ><span
-class="cmti-10">1209</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraLocationSymDescNameHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25128" ><span
-class="cmti-10">1210</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraLocationSymDescNameTabularFooter</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25132" ><span
-class="cmti-10">1211</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraLocationSymDescNameTabularHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25131" ><span
-class="cmti-10">1212</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraLocSetDescWidth</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25033" ><span
-class="cmti-10">1213</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraNameAlign</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25012" ><span
-class="cmti-10">1214</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraNameDescHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25047" ><span
-class="cmti-10">1215</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraNameDescLocationHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25061" ><span
-class="cmti-10">1216</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraNameDescLocationTabularFooter</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25065" ><span
-class="cmti-10">1217</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraNameDescLocationTabularHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25064" ><span
-class="cmti-10">1218</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraNameDescSymHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25086" ><span
-class="cmti-10">1219</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraNameDescSymLocationHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25094" ><span
-class="cmti-10">1220</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraNameDescSymLocationTabularFooter</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25098" ><span
-class="cmti-10">1221</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraNameDescSymLocationTabularHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25097" ><span
-class="cmti-10">1222</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraNameDescSymTabularFooter</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25090" ><span
-class="cmti-10">1223</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraNameDescSymTabularHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25089" ><span
-class="cmti-10">1224</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraNameDescTabularFooter</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25050" ><span
-class="cmti-10">1225</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraNameDescTabularHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25049" ><span
-class="cmti-10">1226</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraNameFmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25035" ><span
-class="cmti-10">1227</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraNameSymDescHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25103" ><span
-class="cmti-10">1228</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraNameSymDescLocationHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25112" ><span
-class="cmti-10">1229</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraNameSymDescLocationTabularFooter</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25116" ><span
-class="cmti-10">1230</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraNameSymDescLocationTabularHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25115" ><span
-class="cmti-10">1231</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraNameSymDescTabularFooter</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25107" ><span
-class="cmti-10">1232</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraNameSymDescTabularHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25106" ><span
-class="cmti-10">1233</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraSetDescWidth</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25023" ><span
-class="cmti-10">1234</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraSetWidest</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25024" ><span
-class="cmti-10">1235</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraSubDescFmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25040" ><span
-class="cmti-10">1236</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraSubNameFmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25039" ><span
-class="cmti-10">1237</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraSubSymbolFmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25041" ><span
-class="cmti-10">1238</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraSymbolAlign</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25014" ><span
-class="cmti-10">1239</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraSymbolFmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25037" ><span
-class="cmti-10">1240</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraSymDescNameHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25120" ><span
-class="cmti-10">1241</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraSymDescNameTabularFooter</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25124" ><span
-class="cmti-10">1242</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraSymDescNameTabularHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25123" ><span
-class="cmti-10">1243</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraSymLocSetDescWidth</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25034" ><span
-class="cmti-10">1244</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraSymSetDescWidth</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25032" ><span
-class="cmti-10">1245</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraTabularVAlign</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25009" ><span
-class="cmti-10">1246</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraUpdateWidest</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25025" ><span
-class="cmti-10">1247</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongextraUpdateWidestChild</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25031" ><span
-class="cmti-10">1248</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsLongExtraUseTabulartrue</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-25008" ><span
-class="cmti-10">1249</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34050" ><span
-class="cmti-10">1250</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongfootnotefont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33165" ><span
-class="cmti-10">1251</span></a> <br /></span>
-
-
-
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslonghyphenfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31071" ><span
-class="cmti-10">1252</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongonlyfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31077" ><span
-class="cmti-10">1253</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongpltok</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34029" ><span
-class="cmti-10">1254</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslongtok</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34028" ><span
-class="cmti-10">1255</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glslonguserfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31066" ><span
-class="cmti-10">1256</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsnoidxdisplayloc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-18014" ><span
-class="cmti-10">1257</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glspdffmtfull</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37022" ><span
-class="cmti-10">1258</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glspdffmtfullpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37023" ><span
-class="cmti-10">1259</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsps</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-13053" ><span
-class="cmti-10">1260</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glspt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-13054" ><span
-class="cmti-10">1261</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsrenewcommand</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-79027" ><span
-class="cmti-10">1262</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsseefirstitem</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8073" ><span
-class="cmti-10">1263</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsseeitemformat</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8031" ><span
-class="cmti-10">1264</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsseelastoxfordsep</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8074" ><span
-class="cmti-10">1265</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glssetattribute</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71186" ><span
-class="cmti-10">1266</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glssetcategoriesattribute</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71182" ><span
-class="cmti-10">1267</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glssetcategoriesattributes</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71183" ><span
-class="cmti-10">1268</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glssetcategoryattribute</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71181" ><span
-class="cmti-10">1269</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glssetcombinedsepabbrvnbsp</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-48009" ><span
-class="cmti-10">1270</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glssetcombinedsepabbrvnone</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-48010" ><span
-class="cmti-10">1271</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glssetcombinedsepnarrow</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-48011" ><span
-class="cmti-10">1272</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glssetregularcategory</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71185" ><span
-class="cmti-10">1273</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsshortpltok</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34025" ><span
-class="cmti-10">1274</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsshorttok</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34024" ><span
-class="cmti-10">1275</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicAssignSubIndent</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26032" ><span
-class="cmti-10">1276</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicAssignWidest</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26033" ><span
-class="cmti-10">1277</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicCols</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26014" ><span
-class="cmti-10">1278</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicColsEnv</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26013" ><span
-class="cmti-10">1279</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicDesc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26029" ><span
-class="cmti-10">1280</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicGroupHeading</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26021" ><span
-class="cmti-10">1281</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicInit</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26020" ><span
-class="cmti-10">1282</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicItem</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26023" ><span
-class="cmti-10">1283</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicLoc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26031" ><span
-class="cmti-10">1284</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicMarker</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26025" ><span
-class="cmti-10">1285</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicMidSkip</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26028" ><span
-class="cmti-10">1286</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicParIndent</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26015" ><span
-class="cmti-10">1287</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicPostSkip</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26030" ><span
-class="cmti-10">1288</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicPreSkip</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26024" ><span
-class="cmti-10">1289</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicSubIndent</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26016" ><span
-class="cmti-10">1290</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicSubItem</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26034" ><span
-class="cmti-10">1291</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicSubItemBox</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26037" ><span
-class="cmti-10">1292</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicSubItemParIndent</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26017" ><span
-class="cmti-10">1293</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicSubItemSep</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26036" ><span
-class="cmti-10">1294</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicSubLoc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26039" ><span
-class="cmti-10">1295</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicSubNameFont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26035" ><span
-class="cmti-10">1296</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicSubPreLocSep</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26038" ><span
-class="cmti-10">1297</span></a> <br /></span>
-
-
-
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicTitle</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26026" ><span
-class="cmti-10">1298</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstopicTitleFont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26027" ><span
-class="cmti-10">1299</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstreechilddesc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22057" ><span
-class="cmti-10">1300</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstreeChildDescLoc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22060" ><span
-class="cmti-10">1301</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstreechildpredesc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22035" ><span
-class="cmti-10">1302</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstreechildprelocation</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22046" ><span
-class="cmti-10">1303</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstreechildsymbol</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22058" ><span
-class="cmti-10">1304</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstreedefaultnamefmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22027" ><span
-class="cmti-10">1305</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstreedesc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22055" ><span
-class="cmti-10">1306</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstreeDescLoc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22059" ><span
-class="cmti-10">1307</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstreegroupskip</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22028" ><span
-class="cmti-10">1308</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstreeheadergroupskip</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22031" ><span
-class="cmti-10">1309</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstreeNoDescSymbolPreLocation</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22061" ><span
-class="cmti-10">1310</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstreenonamechilddesc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22051" ><span
-class="cmti-10">1311</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstreenonamedesc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22047" ><span
-class="cmti-10">1312</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstreenonamesymbol</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22049" ><span
-class="cmti-10">1313</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstreepredesc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22034" ><span
-class="cmti-10">1314</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstreePreHeader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22032" ><span
-class="cmti-10">1315</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstreeprelocation</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22045" ><span
-class="cmti-10">1316</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glstreesymbol</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22056" ><span
-class="cmti-10">1317</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsunsetcategoryattribute</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71187" ><span
-class="cmti-10">1318</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsupdatewidest</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22069" ><span
-class="cmti-10">1319</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsuseabbrvfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-27036" ><span
-class="cmti-10">1320</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsuselongfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-27037" ><span
-class="cmti-10">1321</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsuserdescription</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33049" ><span
-class="cmti-10">1322</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsxtr</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-93014" ><span
-class="cmti-10">1323</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtr</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-93009" ><span
-class="cmti-10">1324</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrabbreviationfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-9029" ><span
-class="cmti-10">1325</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrabbrvfootnote</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33166" ><span
-class="cmti-10">1326</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrabbrvpluralsuffix</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-12035" ><span
-class="cmti-10">1327</span></a>, <a
-href="glossaries-extra-manual.html#dx1-31037" ><span
-class="cmti-10">1328</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtractivatenopost</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-91014" ><span
-class="cmti-10">1329</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtraddallcrossrefs</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8005" ><span
-class="cmti-10">1330</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtraddlabelprefix</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-83014" ><span
-class="cmti-10">1331</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtralias</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-92019" ><span
-class="cmti-10">1332</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrAltTreeIndent</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22101" ><span
-class="cmti-10">1333</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtralttreeInit</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22100" ><span
-class="cmti-10">1334</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtralttreeSubSymbolDescLocation</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22098" ><span
-class="cmti-10">1335</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtralttreeSymbolDescLocation</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22097" ><span
-class="cmti-10">1336</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrapptocsvfield</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86025" ><span
-class="cmti-10">1337</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrAutoAddOnFormat</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7002" ><span
-class="cmti-10">1338</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrautoindex</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-75024" ><span
-class="cmti-10">1339</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrautoindexassignsort</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-75020" ><span
-class="cmti-10">1340</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrautoindexentry</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-75019" ><span
-class="cmti-10">1341</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrautoindexesc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-75022" ><span
-class="cmti-10">1342</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrBasicDigitrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82057" ><span
-class="cmti-10">1343</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrBibTeXEntryAliases</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82005" ><span
-class="cmti-10">1344</span></a> <br /></span>
-
-
-
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexatendgroup</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24034" ><span
-class="cmti-10">1345</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexbetween</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24029" ><span
-class="cmti-10">1346</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexbookmark</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24039" ><span
-class="cmti-10">1347</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexcols</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24010" ><span
-class="cmti-10">1348</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexcolspread</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24013" ><span
-class="cmti-10">1349</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexfirstmark</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24045" ><span
-class="cmti-10">1350</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexfirstmarkfmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24047" ><span
-class="cmti-10">1351</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexformatheader</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24041" ><span
-class="cmti-10">1352</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexlastmark</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24046" ><span
-class="cmti-10">1353</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexlastmarkfmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24048" ><span
-class="cmti-10">1354</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexlocation</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24025" ><span
-class="cmti-10">1355</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexmarkentry</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24044" ><span
-class="cmti-10">1356</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexmulticolsenv</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24018" ><span
-class="cmti-10">1357</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24019" ><span
-class="cmti-10">1358</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexparentchildsep</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24027" ><span
-class="cmti-10">1359</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexparentsubchildsep</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24028" ><span
-class="cmti-10">1360</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexprelocation</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24021" ><span
-class="cmti-10">1361</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexsubatendgroup</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24033" ><span
-class="cmti-10">1362</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexsubbetween</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24030" ><span
-class="cmti-10">1363</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexsublocation</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24026" ><span
-class="cmti-10">1364</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexsubname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24020" ><span
-class="cmti-10">1365</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexsubprelocation</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24024" ><span
-class="cmti-10">1366</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexsubsubatendgroup</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24032" ><span
-class="cmti-10">1367</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrbookindexsubsubbetween</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24031" ><span
-class="cmti-10">1368</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrchecknohyperfirst</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71033" ><span
-class="cmti-10">1369</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrclearlabelprefixes</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-83016" ><span
-class="cmti-10">1370</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrcombiningdiacriticIIIrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82049" ><span
-class="cmti-10">1371</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrcombiningdiacriticIIrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82048" ><span
-class="cmti-10">1372</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrcombiningdiacriticIrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82047" ><span
-class="cmti-10">1373</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrcombiningdiacriticIVrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82050" ><span
-class="cmti-10">1374</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrcombiningdiacriticrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82046" ><span
-class="cmti-10">1375</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrcontrolrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82042" ><span
-class="cmti-10">1376</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrcopytoglossary</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-85007" ><span
-class="cmti-10">1377</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrcurrencyrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82054" ><span
-class="cmti-10">1378</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrcurrentmglscsname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-49009" ><span
-class="cmti-10">1379</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrDefaultResourceOptions</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-83004" ><span
-class="cmti-10">1380</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrdeffield</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86020" ><span
-class="cmti-10">1381</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrdetoklocation</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-84004" ><span
-class="cmti-10">1382</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrdigitrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82056" ><span
-class="cmti-10">1383</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrDiscardUnsetBuffering</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-11016" ><span
-class="cmti-10">1384</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrdisplayendloc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-18017" ><span
-class="cmti-10">1385</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrdisplayendlochook</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-18019" ><span
-class="cmti-10">1386</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrdisplaylocnameref</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-81018" ><span
-class="cmti-10">1387</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrdisplaysingleloc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-18015" ><span
-class="cmti-10">1388</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrdisplaystartloc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-18016" ><span
-class="cmti-10">1389</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrdisplaysupploc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-80001" ><span
-class="cmti-10">1390</span></a> <br /></span>
-
-
-
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrdoautoindexname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-75016" ><span
-class="cmti-10">1391</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrdowrglossaryhook</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7038" ><span
-class="cmti-10">1392</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtredeffield</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86023" ><span
-class="cmti-10">1393</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtremsuffix</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31059" ><span
-class="cmti-10">1394</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrEnableEntryCounting</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-73027" ><span
-class="cmti-10">1395</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrEnableEntryUnitCounting</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-73030" ><span
-class="cmti-10">1396</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrEnableIndexFormatOverride</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-75033" ><span
-class="cmti-10">1397</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrEnableInitialTagging</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-28001" ><span
-class="cmti-10">1398</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrEnableLinkCounting</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-74002" ><span
-class="cmti-10">1399</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrEnableOnTheFly</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-93007" ><span
-class="cmti-10">1400</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrEnablePreLocationTag</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-18010" ><span
-class="cmti-10">1401</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrenablerecordcount</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-84032" ><span
-class="cmti-10">1402</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrendfor</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86079" ><span
-class="cmti-10">1403</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrentryfmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86008" ><span
-class="cmti-10">1404</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrExpandedFmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-11019" ><span
-class="cmti-10">1405</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfielddolistloop</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86061" ><span
-class="cmti-10">1406</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfieldforlistloop</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86062" ><span
-class="cmti-10">1407</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfieldformatcsvlist</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86080" ><span
-class="cmti-10">1408</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfieldformatlist</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86065" ><span
-class="cmti-10">1409</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfieldifinlist</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86071" ><span
-class="cmti-10">1410</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfieldlistadd</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86057" ><span
-class="cmti-10">1411</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfieldlisteadd</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86059" ><span
-class="cmti-10">1412</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfieldlistgadd</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86058" ><span
-class="cmti-10">1413</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfieldlistxadd</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86060" ><span
-class="cmti-10">1414</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfieldtitlecasecs</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71100" ><span
-class="cmti-10">1415</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfieldxifinlist</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86072" ><span
-class="cmti-10">1416</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86002" ><span
-class="cmti-10">1417</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfmt*</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86004" ><span
-class="cmti-10">1418</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrFmtDefaultOptions</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86003" ><span
-class="cmti-10">1419</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfmtdisplay</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86005" ><span
-class="cmti-10">1420</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfmtexternalnameref</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-81023" ><span
-class="cmti-10">1421</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrFmtField</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86001" ><span
-class="cmti-10">1422</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfmtinternalnameref</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-81022" ><span
-class="cmti-10">1423</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfootnotedescname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33186" ><span
-class="cmti-10">1424</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfootnotedescsort</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33188" ><span
-class="cmti-10">1425</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfootnotename</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33162" ><span
-class="cmti-10">1426</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrforcsvfield</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86074" ><span
-class="cmti-10">1427</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrForeignText</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86082" ><span
-class="cmti-10">1428</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrForeignTextField</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86081" ><span
-class="cmti-10">1429</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrFormatLocationList</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-18002" ><span
-class="cmti-10">1430</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrForUnsetBufferedList</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-11015" ><span
-class="cmti-10">1431</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfractionrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82060" ><span
-class="cmti-10">1432</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GLSxtrfull</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-29025" ><span
-class="cmti-10">1433</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsxtrfull</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-29022" ><span
-class="cmti-10">1434</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfull</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-29014" ><span
-class="cmti-10">1435</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsxtrfullformat</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34058" ><span
-class="cmti-10">1436</span></a> <br /></span>
-
-
-
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfullformat</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34054" ><span
-class="cmti-10">1437</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GLSxtrfullpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-29034" ><span
-class="cmti-10">1438</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsxtrfullpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-29033" ><span
-class="cmti-10">1439</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfullpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-29032" ><span
-class="cmti-10">1440</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsxtrfullplformat</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34066" ><span
-class="cmti-10">1441</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfullplformat</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34062" ><span
-class="cmti-10">1442</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrfullsep</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31096" ><span
-class="cmti-10">1443</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrGeneralLatinIIIrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82063" ><span
-class="cmti-10">1444</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrGeneralLatinIIrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82062" ><span
-class="cmti-10">1445</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrGeneralLatinIrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82061" ><span
-class="cmti-10">1446</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrGeneralLatinIVrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82064" ><span
-class="cmti-10">1447</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrGeneralLatinVIIIrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82068" ><span
-class="cmti-10">1448</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrGeneralLatinVIIrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82067" ><span
-class="cmti-10">1449</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrGeneralLatinVIrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82066" ><span
-class="cmti-10">1450</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrGeneralLatinVrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82065" ><span
-class="cmti-10">1451</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrgeneralpuncIIrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82055" ><span
-class="cmti-10">1452</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrgeneralpuncIrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82053" ><span
-class="cmti-10">1453</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrgeneralpuncrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82052" ><span
-class="cmti-10">1454</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrglossentry</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-91004" ><span
-class="cmti-10">1455</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrglossentryother</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-91016" ><span
-class="cmti-10">1456</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrgroupfield</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-87014" ><span
-class="cmti-10">1457</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GLSXTRhiername</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8051" ><span
-class="cmti-10">1458</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GLSxtrhiername</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8050" ><span
-class="cmti-10">1459</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrhiername</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8049" ><span
-class="cmti-10">1460</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsxtrhiername</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8048" ><span
-class="cmti-10">1461</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrhiername</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8041" ><span
-class="cmti-10">1462</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrhiernamesep</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8047" ><span
-class="cmti-10">1463</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrhyphenrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82051" ><span
-class="cmti-10">1464</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrhyphensuffix</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31073" ><span
-class="cmti-10">1465</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtridentifyglslike</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-83012" ><span
-class="cmti-10">1466</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrifcounttrigger</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-73021" ><span
-class="cmti-10">1467</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrifcustomdiscardperiod</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-9035" ><span
-class="cmti-10">1468</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrIfFieldCmpNum</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86049" ><span
-class="cmti-10">1469</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrIfFieldEqNum</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86048" ><span
-class="cmti-10">1470</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrIfFieldEqStr</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86038" ><span
-class="cmti-10">1471</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrIfFieldEqXpStr</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86040" ><span
-class="cmti-10">1472</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrIfFieldNonZero</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86047" ><span
-class="cmti-10">1473</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrIfFieldUndef</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86037" ><span
-class="cmti-10">1474</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrIfFieldValueInCsvList</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86042" ><span
-class="cmti-10">1475</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrifhasfield</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86033" ><span
-class="cmti-10">1476</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrifhasfield*</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86035" ><span
-class="cmti-10">1477</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrIfHasNonZeroChildCount</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82004" ><span
-class="cmti-10">1478</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrifinlabelprefixlist</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-83017" ><span
-class="cmti-10">1479</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrifkeydefined</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86012" ><span
-class="cmti-10">1480</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtriflabelinlist</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-89001" ><span
-class="cmti-10">1481</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrIfLinkCounterDef</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-74008" ><span
-class="cmti-10">1482</span></a> <br /></span>
-
-
-
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrifmulti</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-69001" ><span
-class="cmti-10">1483</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrifrecordtrigger</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-84018" ><span
-class="cmti-10">1484</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrIfUnusedOrUndefined</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-11007" ><span
-class="cmti-10">1485</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrIfValueInFieldCsvList</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86045" ><span
-class="cmti-10">1486</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrifwasfirstuse</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-9053" ><span
-class="cmti-10">1487</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrIfXpFieldEqXpStr</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86041" ><span
-class="cmti-10">1488</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrinclinkcounter</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-74005" ><span
-class="cmti-10">1489</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrindexaliased</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-92017" ><span
-class="cmti-10">1490</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrIndexCounterLink</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-79028" ><span
-class="cmti-10">1491</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrindexseealso</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8076" ><span
-class="cmti-10">1492</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrinitwrgloss</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7013" ><span
-class="cmti-10">1493</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsxtrinlinefullformat</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34073" ><span
-class="cmti-10">1494</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrinlinefullformat</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34070" ><span
-class="cmti-10">1495</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsxtrinlinefullplformat</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34080" ><span
-class="cmti-10">1496</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrinlinefullplformat</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34077" ><span
-class="cmti-10">1497</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrinsertinsidetrue</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31094" ><span
-class="cmti-10">1498</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinA</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82069" ><span
-class="cmti-10">1499</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinAA</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82093" ><span
-class="cmti-10">1500</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinAELigature</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82086" ><span
-class="cmti-10">1501</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinE</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82070" ><span
-class="cmti-10">1502</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinEszettSs</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82082" ><span
-class="cmti-10">1503</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinEszettSz</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82083" ><span
-class="cmti-10">1504</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinEth</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82084" ><span
-class="cmti-10">1505</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinH</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82071" ><span
-class="cmti-10">1506</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinI</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82073" ><span
-class="cmti-10">1507</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinInsularG</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82091" ><span
-class="cmti-10">1508</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinK</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82072" ><span
-class="cmti-10">1509</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinL</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82074" ><span
-class="cmti-10">1510</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinLslash</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82089" ><span
-class="cmti-10">1511</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinM</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82075" ><span
-class="cmti-10">1512</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinN</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82076" ><span
-class="cmti-10">1513</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinO</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82077" ><span
-class="cmti-10">1514</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinOELigature</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82087" ><span
-class="cmti-10">1515</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinOslash</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82088" ><span
-class="cmti-10">1516</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinP</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82078" ><span
-class="cmti-10">1517</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinS</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82079" ><span
-class="cmti-10">1518</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinSchwa</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82092" ><span
-class="cmti-10">1519</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinT</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82080" ><span
-class="cmti-10">1520</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinThorn</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82085" ><span
-class="cmti-10">1521</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinWynn</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82090" ><span
-class="cmti-10">1522</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrLatinX</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82081" ><span
-class="cmti-10">1523</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrLetField</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86029" ><span
-class="cmti-10">1524</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrLetFieldToField</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86031" ><span
-class="cmti-10">1525</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrLinkCounterName</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-74009" ><span
-class="cmti-10">1526</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrLinkCounterValue</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-74006" ><span
-class="cmti-10">1527</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrLoadResources</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-76018" ><span
-class="cmti-10">1528</span></a> <br /></span>
-
-
-
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrlocalsetgrouptitle</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-16007" ><span
-class="cmti-10">1529</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrLocationField</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-88012" ><span
-class="cmti-10">1530</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrLocationRecordCount</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-84008" ><span
-class="cmti-10">1531</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrlocrangefmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-18018" ><span
-class="cmti-10">1532</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsxtrlong</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-29021" ><span
-class="cmti-10">1533</span></a>, <a
-href="glossaries-extra-manual.html#dx1-29024" ><span
-class="cmti-10">1534</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrlong</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-29012" ><span
-class="cmti-10">1535</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrlonghyphen</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33279" ><span
-class="cmti-10">1536</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrlonghyphenshort</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33260" ><span
-class="cmti-10">1537</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrlongnoshortdescname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32062" ><span
-class="cmti-10">1538</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrlongnoshortname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32088" ><span
-class="cmti-10">1539</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GLSxtrlongpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-29031" ><span
-class="cmti-10">1540</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsxtrlongpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-29030" ><span
-class="cmti-10">1541</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrlongpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-29029" ><span
-class="cmti-10">1542</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrlongshortdescname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33069" ><span
-class="cmti-10">1543</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrlongshortdescsort</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33066" ><span
-class="cmti-10">1544</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrlongshortname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33006" ><span
-class="cmti-10">1545</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrlongshortuserdescname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33090" ><span
-class="cmti-10">1546</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrMathGreekIIrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82101" ><span
-class="cmti-10">1547</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrMathGreekIrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82094" ><span
-class="cmti-10">1548</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrMathItalicGreekIIrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82116" ><span
-class="cmti-10">1549</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrMathItalicGreekIrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82110" ><span
-class="cmti-10">1550</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrMathItalicLowerGreekIIrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82130" ><span
-class="cmti-10">1551</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrMathItalicLowerGreekIrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82126" ><span
-class="cmti-10">1552</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrMathItalicNabla</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82134" ><span
-class="cmti-10">1553</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrMathItalicPartial</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82133" ><span
-class="cmti-10">1554</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrMathItalicUpperGreekIIrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82123" ><span
-class="cmti-10">1555</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrMathItalicUpperGreekIrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82119" ><span
-class="cmti-10">1556</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrMathUpGreekIIrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82107" ><span
-class="cmti-10">1557</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrMathUpGreekIrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82102" ><span
-class="cmti-10">1558</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrMglsOrGls</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-38015" ><span
-class="cmti-10">1559</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrmglsWarnAllSkipped</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-60001" ><span
-class="cmti-10">1560</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GLSxtrmultientryadjustedname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-70016" ><span
-class="cmti-10">1561</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrmultientryadjustedname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-70015" ><span
-class="cmti-10">1562</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsxtrmultientryadjustedname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-70014" ><span
-class="cmti-10">1563</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrmultientryadjustedname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-70009" ><span
-class="cmti-10">1564</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GLSxtrmultientryadjustednamefmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-70024" ><span
-class="cmti-10">1565</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrmultientryadjustednamefmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-70023" ><span
-class="cmti-10">1566</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsxtrmultientryadjustednamefmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-70021" ><span
-class="cmti-10">1567</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrmultientryadjustednamefmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-70020" ><span
-class="cmti-10">1568</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GLSxtrmultientryadjustednameother</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-70029" ><span
-class="cmti-10">1569</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrmultientryadjustednameother</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-70027" ><span
-class="cmti-10">1570</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsxtrmultientryadjustednameother</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-70026" ><span
-class="cmti-10">1571</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrmultientryadjustednameother</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-70025" ><span
-class="cmti-10">1572</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrmultientryadjustednamepostsep</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-70019" ><span
-class="cmti-10">1573</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrmultientryadjustednamepresep</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-70018" ><span
-class="cmti-10">1574</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrmultientryadjustednamesep</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-70017" ><span
-class="cmti-10">1575</span></a> <br /></span>
-
-
-
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrmultilastotherindex</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-69009" ><span
-class="cmti-10">1576</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrmultilist</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-69003" ><span
-class="cmti-10">1577</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrmultimain</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-69002" ><span
-class="cmti-10">1578</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrmultimainindex</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-69008" ><span
-class="cmti-10">1579</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrmultisupplocation</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-80004" ><span
-class="cmti-10">1580</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrmultitotalelements</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-69007" ><span
-class="cmti-10">1581</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrnameloclink</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-81025" ><span
-class="cmti-10">1582</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrnamereflink</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-81019" ><span
-class="cmti-10">1583</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrnewgls</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-83005" ><span
-class="cmti-10">1584</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrnewGLSlike</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-83007" ><span
-class="cmti-10">1585</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrnewglslike</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-83006" ><span
-class="cmti-10">1586</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrnewnumber</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4244" ><span
-class="cmti-10">1587</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrnewrgls</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-83008" ><span
-class="cmti-10">1588</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrnewrGLSlike</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-83010" ><span
-class="cmti-10">1589</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrnewrglslike</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-83009" ><span
-class="cmti-10">1590</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrnewsymbol</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4238" ><span
-class="cmti-10">1591</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrNoGlsWarningAutoMake</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-98020" ><span
-class="cmti-10">1592</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrNoGlsWarningBuildInfo</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-98019" ><span
-class="cmti-10">1593</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrNoGlsWarningCheckFile</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-98015" ><span
-class="cmti-10">1594</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrNoGlsWarningEmptyMain</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-98013" ><span
-class="cmti-10">1595</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrNoGlsWarningEmptyNotMain</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-98014" ><span
-class="cmti-10">1596</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrNoGlsWarningEmptyStart</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-98012" ><span
-class="cmti-10">1597</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrNoGlsWarningHead</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-98011" ><span
-class="cmti-10">1598</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrNoGlsWarningMisMatch</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-98016" ><span
-class="cmti-10">1599</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrNoGlsWarningNoOut</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-98017" ><span
-class="cmti-10">1600</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrNoGlsWarningTail</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-98018" ><span
-class="cmti-10">1601</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrnonprintablerules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82044" ><span
-class="cmti-10">1602</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrnopostpunc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-6003" ><span
-class="cmti-10">1603</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtronlydescname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33030" ><span
-class="cmti-10">1604</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtronlydescsort</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33031" ><span
-class="cmti-10">1605</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtronlyname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33023" ><span
-class="cmti-10">1606</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtronlysuffix</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31079" ><span
-class="cmti-10">1607</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrorglong</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34034" ><span
-class="cmti-10">1608</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrorgshort</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34033" ><span
-class="cmti-10">1609</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GLSxtrp</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-13062" ><span
-class="cmti-10">1610</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsxtrp</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-13061" ><span
-class="cmti-10">1611</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrp</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-13052" ><span
-class="cmti-10">1612</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrpageref</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-85004" ><span
-class="cmti-10">1613</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrparen</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31030" ><span
-class="cmti-10">1614</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrpdfentryfmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86010" ><span
-class="cmti-10">1615</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsxtrpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-93015" ><span
-class="cmti-10">1616</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-93013" ><span
-class="cmti-10">1617</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrpostdescription</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-17032" ><span
-class="cmti-10">1618</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrposthyphenlong</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33292" ><span
-class="cmti-10">1619</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrposthyphenshort</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33277" ><span
-class="cmti-10">1620</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrpostlink</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-9033" ><span
-class="cmti-10">1621</span></a> <br /></span>
-
-
-
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrpostlinkAddDescOnFirstUse</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-9042" ><span
-class="cmti-10">1622</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrpostlinkAddSymbolDescOnFirstUse</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-9048" ><span
-class="cmti-10">1623</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrpostlinkAddSymbolOnFirstUse</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-9046" ><span
-class="cmti-10">1624</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrpostlinkendsentence</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-9034" ><span
-class="cmti-10">1625</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrpostlinkhook</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-9031" ><span
-class="cmti-10">1626</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrpostlongdescription</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-6017" ><span
-class="cmti-10">1627</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrpostnamehook</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-17026" ><span
-class="cmti-10">1628</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrPostNewAbbreviation</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34019" ><span
-class="cmti-10">1629</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrprelocation</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-21008" ><span
-class="cmti-10">1630</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrprependlabelprefix</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-83015" ><span
-class="cmti-10">1631</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrProvideBibTeXFields</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82008" ><span
-class="cmti-10">1632</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrprovidecommand</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-79022" ><span
-class="cmti-10">1633</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrprovidestoragekey</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86011" ><span
-class="cmti-10">1634</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrRecordCount</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-84007" ><span
-class="cmti-10">1635</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrRecordCounter</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86089" ><span
-class="cmti-10">1636</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrrecordtriggervalue</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-84020" ><span
-class="cmti-10">1637</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrregularfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-9026" ><span
-class="cmti-10">1638</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrresourcefile</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-76017" ><span
-class="cmti-10">1639</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrresourceinit</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-83003" ><span
-class="cmti-10">1640</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrrestorepostpunc</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-6004" ><span
-class="cmti-10">1641</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrRevertMarks</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-36008" ><span
-class="cmti-10">1642</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrRevertTocMarks</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-36009" ><span
-class="cmti-10">1643</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrsconlydescname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33034" ><span
-class="cmti-10">1644</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrsconlydescsort</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33035" ><span
-class="cmti-10">1645</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrsconlyname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33026" ><span
-class="cmti-10">1646</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrsconlysuffix</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31085" ><span
-class="cmti-10">1647</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrscsuffix</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31044" ><span
-class="cmti-10">1648</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrscusersuffix</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31092" ><span
-class="cmti-10">1649</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrseealsolabels</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8068" ><span
-class="cmti-10">1650</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrseelist</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8072" ><span
-class="cmti-10">1651</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrSetActualChar</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-75049" ><span
-class="cmti-10">1652</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrsetaliasnoindex</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-92014" ><span
-class="cmti-10">1653</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrSetAltModifier</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7037" ><span
-class="cmti-10">1654</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrsetcategory</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71208" ><span
-class="cmti-10">1655</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrsetcategoryforall</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71210" ><span
-class="cmti-10">1656</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrSetDefaultGlsOpts</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7031" ><span
-class="cmti-10">1657</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrSetEncapChar</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-75052" ><span
-class="cmti-10">1658</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrSetEscChar</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-75051" ><span
-class="cmti-10">1659</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrSetField</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86016" ><span
-class="cmti-10">1660</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrsetfieldifexists</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86017" ><span
-class="cmti-10">1661</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrsetglossarylabel</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-15014" ><span
-class="cmti-10">1662</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrsetgrouptitle</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-16006" ><span
-class="cmti-10">1663</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrSetLevelChar</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-75050" ><span
-class="cmti-10">1664</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrsetpopts</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-13057" ><span
-class="cmti-10">1665</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrSetRecordCountAttribute</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-84016" ><span
-class="cmti-10">1666</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrSetWidest</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-79035" ><span
-class="cmti-10">1667</span></a> <br /></span>
-
-
-
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrSetWidestFallback</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-79040" ><span
-class="cmti-10">1668</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsxtrshort</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-29020" ><span
-class="cmti-10">1669</span></a>, <a
-href="glossaries-extra-manual.html#dx1-29023" ><span
-class="cmti-10">1670</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrshort</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-29010" ><span
-class="cmti-10">1671</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrshortdescname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32036" ><span
-class="cmti-10">1672</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrshorthyphenlong</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33285" ><span
-class="cmti-10">1673</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrshortlongdescname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33134" ><span
-class="cmti-10">1674</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrshortlongname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33107" ><span
-class="cmti-10">1675</span></a>, <a
-href="glossaries-extra-manual.html#dx1-33124" ><span
-class="cmti-10">1676</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrshortlonguserdescname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33152" ><span
-class="cmti-10">1677</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrshortnolongname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-32005" ><span
-class="cmti-10">1678</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GLSxtrshortpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-29028" ><span
-class="cmti-10">1679</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsxtrshortpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-29027" ><span
-class="cmti-10">1680</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrshortpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-29026" ><span
-class="cmti-10">1681</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrsmsuffix</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31054" ><span
-class="cmti-10">1682</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrspacerules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82043" ><span
-class="cmti-10">1683</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrStandaloneEntryName</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-91010" ><span
-class="cmti-10">1684</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrStandaloneEntryOther</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-91017" ><span
-class="cmti-10">1685</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrStandaloneGlossaryType</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-91005" ><span
-class="cmti-10">1686</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrStartUnsetBuffering</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-11013" ><span
-class="cmti-10">1687</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrStopUnsetBuffering</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-11014" ><span
-class="cmti-10">1688</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrSubScriptDigitrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82058" ><span
-class="cmti-10">1689</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsxtrsubsequentfmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34083" ><span
-class="cmti-10">1690</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrsubsequentfmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34082" ><span
-class="cmti-10">1691</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsxtrsubsequentplfmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34085" ><span
-class="cmti-10">1692</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrsubsequentplfmt</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34084" ><span
-class="cmti-10">1693</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrSuperScriptDigitrules</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82059" ><span
-class="cmti-10">1694</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrtagfont</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-28003" ><span
-class="cmti-10">1695</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrTheLinkCounter</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-74007" ><span
-class="cmti-10">1696</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrTotalRecordCount</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-84006" ><span
-class="cmti-10">1697</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrunsrtdo</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-88007" ><span
-class="cmti-10">1698</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrUseAbbrStyleFmts</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34089" ><span
-class="cmti-10">1699</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrUseAbbrStyleSetup</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34040" ><span
-class="cmti-10">1700</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrusealias</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8066" ><span
-class="cmti-10">1701</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GLSxtrusefield</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86054" ><span
-class="cmti-10">1702</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Glsxtrusefield</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86053" ><span
-class="cmti-10">1703</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrusefield</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86051" ><span
-class="cmti-10">1704</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtruserfield</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33041" ><span
-class="cmti-10">1705</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtruserparen</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-33044" ><span
-class="cmti-10">1706</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrusersuffix</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31068" ><span
-class="cmti-10">1707</span></a>, <a
-href="glossaries-extra-manual.html#dx1-33054" ><span
-class="cmti-10">1708</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrusesee</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8015" ><span
-class="cmti-10">1709</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtruseseealso</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8063" ><span
-class="cmti-10">1710</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtruseseeformat</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8016" ><span
-class="cmti-10">1711</span></a>, <a
-href="glossaries-extra-manual.html#dx1-8064" ><span
-class="cmti-10">1712</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrWarnDeprecatedAbbrStyle</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31121" ><span
-class="cmti-10">1713</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\GlsXtrWarning</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-93011" ><span
-class="cmti-10">1714</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrword</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71057" ><span
-class="cmti-10">1715</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrwordsep</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71056" ><span
-class="cmti-10">1716</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\glsxtrwrglossmark</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4008" ><span
-class="cmti-10">1717</span></a> <br /></span>
-
-
-
-</p><p class="theindex"> <span
-class="cmbx-10">H</span>
-<span class="index-item"><span
-class="cmss-10">hyperref </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4099" >1718</a>, <a
-href="glossaries-extra-manual.html#dx1-4147" >1719</a>, <a
-href="glossaries-extra-manual.html#dx1-4159" >1720</a>, <a
-href="glossaries-extra-manual.html#dx1-7057" >1721</a>, <a
-href="glossaries-extra-manual.html#dx1-7062" >1722</a>, <a
-href="glossaries-extra-manual.html#dx1-7064" >1723</a>, <a
-href="glossaries-extra-manual.html#dx1-13029" >1724</a>, <a
-href="glossaries-extra-manual.html#dx1-13060" >1725</a>, <a
-href="glossaries-extra-manual.html#dx1-33158" >1726</a>, <a
-href="glossaries-extra-manual.html#dx1-35002" >1727</a>, <a
-href="glossaries-extra-manual.html#dx1-35003" >1728</a>, <a
-href="glossaries-extra-manual.html#dx1-35004" >1729</a>, <a
-href="glossaries-extra-manual.html#dx1-36004" >1730</a>, <a
-href="glossaries-extra-manual.html#dx1-37002" >1731</a>, <a
-href="glossaries-extra-manual.html#dx1-73032" >1732</a>, <a
-href="glossaries-extra-manual.html#dx1-75034" >1733</a>, <a
-href="glossaries-extra-manual.html#dx1-79030" >1734</a>, <a
-href="glossaries-extra-manual.html#dx1-81003" >1735</a>, <a
-href="glossaries-extra-manual.html#dx1-85008" >1736</a>, <a
-href="glossaries-extra-manual.html#dx1-86007" >1737</a>, <a
-href="glossaries-extra-manual.html#dx1-86009" >1738</a>, <a
-href="glossaries-extra-manual.html#dx1-89002" >1739</a>, <a
-href="glossaries-extra-manual.html#dx1-91003" >1740</a>, <a
-href="glossaries-extra-manual.html#dx1-92005" >1741</a>, <a
-href="glossaries-extra-manual.html#dx1-97006" >1742</a>, <a
-href="glossaries-extra-manual.html#dx1-97024" >1743</a> <br /></span>
-</p><p class="theindex"> <span
-class="cmbx-10">I</span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\ifmglsused</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-53003" ><span
-class="cmti-10">1744</span></a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">inputenc </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-78012" >1745</a> <br /></span>
-</p><p class="theindex"> <span
-class="cmbx-10">L</span>
-<span class="index-item">link-text&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-9001" >1746</a>, <a
-href="glossaries-extra-manual.html#dx1-9003" >1747</a>, <a
-href="glossaries-extra-manual.html#dx1-9030" >1748</a>, <a
-href="glossaries-extra-manual.html#dx1-9041" >1749</a>, <a
-href="glossaries-extra-manual.html#dx1-9051" >1750</a>, <a
-href="glossaries-extra-manual.html#dx1-9055" >1751</a>, <a
-href="glossaries-extra-manual.html#dx1-9059" >1752</a>, <a
-href="glossaries-extra-manual.html#dx1-9064" >1753</a>, <a
-href="glossaries-extra-manual.html#dx1-9068" >1754</a>, <a
-href="glossaries-extra-manual.html#dx1-13036" >1755</a>, <a
-href="glossaries-extra-manual.html#dx1-13037" >1756</a>, <a
-href="glossaries-extra-manual.html#dx1-31097" >1757</a>, <a
-href="glossaries-extra-manual.html#dx1-31111" >1758</a>, <a
-href="glossaries-extra-manual.html#dx1-31114" >1759</a>, <a
-href="glossaries-extra-manual.html#dx1-33203" >1760</a>, <a
-href="glossaries-extra-manual.html#dx1-71043" >1761</a>, <a
-href="glossaries-extra-manual.html#dx1-71047" >1762</a>, <a
-href="glossaries-extra-manual.html#dx1-74001" >1763</a>, <a
-href="glossaries-extra-manual.html#dx1-97002" >1764</a>, <a
-href="glossaries-extra-manual.html#dx1-99021" ><span
-class="cmbx-10">1765</span></a> <br /></span>
-<span class="index-item">location list&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-18013" >1766</a>, <a
-href="glossaries-extra-manual.html#dx1-92010" >1767</a>, <a
-href="glossaries-extra-manual.html#dx1-92012" >1768</a>, <a
-href="glossaries-extra-manual.html#dx1-97005" >1769</a>, <a
-href="glossaries-extra-manual.html#dx1-99023" ><span
-class="cmbx-10">1770</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\longnewglossaryentry</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-6015" ><span
-class="cmti-10">1771</span></a> <br /></span>
-</p><p class="theindex"> <span
-class="cmbx-10">M</span>
-<span class="index-item"><span
-class="cmtt-10">makeglossaries</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-3034" >1772</a>, <a
-href="glossaries-extra-manual.html#dx1-3036" >1773</a>, <a
-href="glossaries-extra-manual.html#dx1-3037" >1774</a>, <a
-href="glossaries-extra-manual.html#dx1-6037" >1775</a>, <a
-href="glossaries-extra-manual.html#dx1-99026" ><span
-class="cmbx-10">1776</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\makeglossaries</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-6032" ><span
-class="cmti-10">1777</span></a> <br /></span>
-<span class="index-item"><span
-class="cmtt-10">makeglossaries-lite</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-6038" >1778</a>, <a
-href="glossaries-extra-manual.html#dx1-99030" ><span
-class="cmbx-10">1779</span></a> <br /></span>
-<span class="index-item"><span
-class="cmtt-10">makeglossaries-lite</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-6039" >1780</a>, <a
-href="glossaries-extra-manual.html#dx1-99029" ><span
-class="cmbx-10">1781</span></a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">makeidx </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8081" >1782</a> <br /></span>
-<span class="index-item"><span
-class="cmtt-10">makeindex</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-3029" >1783</a>, <a
-href="glossaries-extra-manual.html#dx1-3035" >1784</a>, <a
-href="glossaries-extra-manual.html#dx1-3038" >1785</a>, <a
-href="glossaries-extra-manual.html#dx1-4011" >1786</a>, <a
-href="glossaries-extra-manual.html#dx1-4107" >1787</a>, <a
-href="glossaries-extra-manual.html#dx1-4113" >1788</a>, <a
-href="glossaries-extra-manual.html#dx1-4117" >1789</a>, <a
-href="glossaries-extra-manual.html#dx1-4123" >1790</a>, <a
-href="glossaries-extra-manual.html#dx1-4130" >1791</a>, <a
-href="glossaries-extra-manual.html#dx1-4148" >1792</a>, <a
-href="glossaries-extra-manual.html#dx1-4165" >1793</a>, <a
-href="glossaries-extra-manual.html#dx1-4169" >1794</a>, <a
-href="glossaries-extra-manual.html#dx1-4195" >1795</a>, <a
-href="glossaries-extra-manual.html#dx1-4210" >1796</a>, <a
-href="glossaries-extra-manual.html#dx1-75003" >1797</a>, <a
-href="glossaries-extra-manual.html#dx1-75008" >1798</a>, <a
-href="glossaries-extra-manual.html#dx1-75044" >1799</a>, <a
-href="glossaries-extra-manual.html#dx1-79006" >1800</a>, <a
-href="glossaries-extra-manual.html#dx1-81005" >1801</a>, <a
-href="glossaries-extra-manual.html#dx1-90004" >1802</a>, <a
-href="glossaries-extra-manual.html#dx1-90005" >1803</a>, <a
-href="glossaries-extra-manual.html#dx1-99003" >1804</a>, <a
-href="glossaries-extra-manual.html#dx1-99028" >1805</a>, <a
-href="glossaries-extra-manual.html#dx1-99032" >1806</a>, <a
-href="glossaries-extra-manual.html#dx1-99033" ><span
-class="cmbx-10">1807</span></a> <br /></span>
-<span class="index-item"><span
-class="cmtt-10">makeindex</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7053" >1808</a>, <a
-href="glossaries-extra-manual.html#dx1-7054" >1809</a>, <a
-href="glossaries-extra-manual.html#dx1-7060" >1810</a>, <a
-href="glossaries-extra-manual.html#dx1-8021" >1811</a>, <a
-href="glossaries-extra-manual.html#dx1-75021" >1812</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">memoir </span>class&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-3024" >1813</a>, <a
-href="glossaries-extra-manual.html#dx1-3025" >1814</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">mfirstuc </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4" >1815</a>, <a
-href="glossaries-extra-manual.html#dx1-71098" >1816</a>, <a
-href="glossaries-extra-manual.html#dx1-71101" >1817</a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\MGLS</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-64009" ><span
-class="cmti-10">1818</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\MGls</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-64004" ><span
-class="cmti-10">1819</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Mgls</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-64003" ><span
-class="cmti-10">1820</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mgls</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-38003" ><span
-class="cmti-10">1821</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglscurrentcategory</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-49008" ><span
-class="cmti-10">1822</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglscurrentlabel</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-49012" ><span
-class="cmti-10">1823</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglscurrentlist</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-49006" ><span
-class="cmti-10">1824</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglscurrentmainlabel</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-49005" ><span
-class="cmti-10">1825</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglscurrentmultilabel</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-49004" ><span
-class="cmti-10">1826</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglscurrentoptions</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-49007" ><span
-class="cmti-10">1827</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglscurrentprefix</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-49014" ><span
-class="cmti-10">1828</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglscurrentsuffix</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-49015" ><span
-class="cmti-10">1829</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglscustompostlinkhook</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-50001" ><span
-class="cmti-10">1830</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsdefcategoryprefix</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-47004" ><span
-class="cmti-10">1831</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsdefcategorysuffix</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-47005" ><span
-class="cmti-10">1832</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglselementindex</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-49013" ><span
-class="cmti-10">1833</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglselementposthook</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-49002" ><span
-class="cmti-10">1834</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglselementprehook</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-49001" ><span
-class="cmti-10">1835</span></a> <br /></span>
-
-
-
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglselementreset</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-62008" ><span
-class="cmti-10">1836</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglselementunset</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-62009" ><span
-class="cmti-10">1837</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsfield</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-66011" ><span
-class="cmti-10">1838</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsforelements</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-69004" ><span
-class="cmti-10">1839</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsforotherelements</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-69006" ><span
-class="cmti-10">1840</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Mglsfull</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-65009" ><span
-class="cmti-10">1841</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsfull</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-65005" ><span
-class="cmti-10">1842</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglshascategoryprefix</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-47006" ><span
-class="cmti-10">1843</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglshascategorysuffix</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-47008" ><span
-class="cmti-10">1844</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsiflast</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-49016" ><span
-class="cmti-10">1845</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsiflastelementcapscase</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-51005" ><span
-class="cmti-10">1846</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsiflastelementskipped</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-51002" ><span
-class="cmti-10">1847</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsiflastelementwasfirstuse</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-51003" ><span
-class="cmti-10">1848</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsiflastelementwasplural</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-51004" ><span
-class="cmti-10">1849</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsiflastmaincapscase</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-52005" ><span
-class="cmti-10">1850</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsiflastmainskipped</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-52002" ><span
-class="cmti-10">1851</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsiflastmainwasfirstuse</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-52003" ><span
-class="cmti-10">1852</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsiflastmainwasplural</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-52004" ><span
-class="cmti-10">1853</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsisfirstuse</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-49010" ><span
-class="cmti-10">1854</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglslastcategory</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-50007" ><span
-class="cmti-10">1855</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglslastelementlabel</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-51001" ><span
-class="cmti-10">1856</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglslastelementpostlinkhook</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-50002" ><span
-class="cmti-10">1857</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglslastmainlabel</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-52001" ><span
-class="cmti-10">1858</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglslastmainpostlinkhook</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-50003" ><span
-class="cmti-10">1859</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglslastmultilabel</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-50006" ><span
-class="cmti-10">1860</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglslocalreset</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-53007" ><span
-class="cmti-10">1861</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglslocalunset</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-53006" ><span
-class="cmti-10">1862</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglslocalunsetothers</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-62011" ><span
-class="cmti-10">1863</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Mglslong</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-65008" ><span
-class="cmti-10">1864</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglslong</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-65003" ><span
-class="cmti-10">1865</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\MGLSmainpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-64011" ><span
-class="cmti-10">1866</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\MGlsmainpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-64008" ><span
-class="cmti-10">1867</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Mglsmainpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-64006" ><span
-class="cmti-10">1868</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsmainpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-64002" ><span
-class="cmti-10">1869</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\MGlsname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-66002" ><span
-class="cmti-10">1870</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Mglsname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-66003" ><span
-class="cmti-10">1871</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-66001" ><span
-class="cmti-10">1872</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\MGLSpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-64010" ><span
-class="cmti-10">1873</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\MGlspl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-64007" ><span
-class="cmti-10">1874</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Mglspl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-64005" ><span
-class="cmti-10">1875</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglspl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-64001" ><span
-class="cmti-10">1876</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsprefix</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-47001" ><span
-class="cmti-10">1877</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsreset</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-53005" ><span
-class="cmti-10">1878</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsresetall</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-53009" ><span
-class="cmti-10">1879</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsseefirstitem</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-68003" ><span
-class="cmti-10">1880</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsseeitem</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-68004" ><span
-class="cmti-10">1881</span></a> <br /></span>
-
-
-
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsSetMain</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-46001" ><span
-class="cmti-10">1882</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsSetOptions</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-38009" ><span
-class="cmti-10">1883</span></a>, <a
-href="glossaries-extra-manual.html#dx1-38010" ><span
-class="cmti-10">1884</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Mglsshort</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-65007" ><span
-class="cmti-10">1885</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsshort</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-65001" ><span
-class="cmti-10">1886</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglssuffix</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-47002" ><span
-class="cmti-10">1887</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\MGlssymbol</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-66006" ><span
-class="cmti-10">1888</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Mglssymbol</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-66008" ><span
-class="cmti-10">1889</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglssymbol</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-66004" ><span
-class="cmti-10">1890</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsunset</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-53004" ><span
-class="cmti-10">1891</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsunsetall</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-53008" ><span
-class="cmti-10">1892</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsunsetothers</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-62010" ><span
-class="cmti-10">1893</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsusecategoryprefix</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-47007" ><span
-class="cmti-10">1894</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsusecategorysuffix</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-47009" ><span
-class="cmti-10">1895</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\MGlsusefield</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-66014" ><span
-class="cmti-10">1896</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Mglsusefield</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-66013" ><span
-class="cmti-10">1897</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglsusefield</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-66010" ><span
-class="cmti-10">1898</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mglswasfirstuse</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-50008" ><span
-class="cmti-10">1899</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\MPGLS</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-67012" ><span
-class="cmti-10">1900</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\MPGls</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-67009" ><span
-class="cmti-10">1901</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Mpgls</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-67007" ><span
-class="cmti-10">1902</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mpgls</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-67004" ><span
-class="cmti-10">1903</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\MPGLSmainpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-67014" ><span
-class="cmti-10">1904</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\MPGlsmainpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-67011" ><span
-class="cmti-10">1905</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\Mpglsmainpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-67008" ><span
-class="cmti-10">1906</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mpglsmainpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-67006" ><span
-class="cmti-10">1907</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\MPGLSpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-67013" ><span
-class="cmti-10">1908</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\MPGlspl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-67010" ><span
-class="cmti-10">1909</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mpglspl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-67005" ><span
-class="cmti-10">1910</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\mpglsWarning</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-67003" ><span
-class="cmti-10">1911</span></a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">multicols </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-26002" >1912</a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\multiglossaryentry</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-38002" ><span
-class="cmti-10">1913</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\multiglossaryentryglobalfalse</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-38008" ><span
-class="cmti-10">1914</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\multiglossaryentryglobaltrue</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-38007" ><span
-class="cmti-10">1915</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\multiglossaryentrysetup</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-55001" ><span
-class="cmti-10">1916</span></a> <br /></span>
-</p><p class="theindex"> <span
-class="cmbx-10">N</span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\newabbreviation</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-27011" ><span
-class="cmti-10">1917</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\newabbreviationstyle</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-34001" ><span
-class="cmti-10">1918</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\newacronym</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-27020" ><span
-class="cmti-10">1919</span></a> <br /></span>
-<span class="index-item"><span
-class="cmtt-10">\newglossaryentry </span>options<br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">access</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71165" >1920</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">alias</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-6008" >1921</a>, <a
-href="glossaries-extra-manual.html#dx1-6012" >1922</a>, <a
-href="glossaries-extra-manual.html#dx1-8065" >1923</a>, <a
-href="glossaries-extra-manual.html#dx1-38014" >1924</a>, <a
-href="glossaries-extra-manual.html#dx1-68008" >1925</a>, <a
-href="glossaries-extra-manual.html#dx1-92001" >1926</a>, <a
-href="glossaries-extra-manual.html#dx1-92004" >1927</a>, <a
-href="glossaries-extra-manual.html#dx1-92018" >1928</a>, <a
-href="glossaries-extra-manual.html#dx1-97010" >1929</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">category</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-6007" >1930</a>, <a
-href="glossaries-extra-manual.html#dx1-7021" >1931</a>, <a
-href="glossaries-extra-manual.html#dx1-27012" >1932</a>, <a
-href="glossaries-extra-manual.html#dx1-27019" >1933</a>, <a
-href="glossaries-extra-manual.html#dx1-71003" >1934</a>, <a
-href="glossaries-extra-manual.html#dx1-71005" >1935</a>, <a
-href="glossaries-extra-manual.html#dx1-90046" >1936</a>, <a
-href="glossaries-extra-manual.html#dx1-90051" >1937</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">counter</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7044" >1938</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">description</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-6002" >1939</a>, <a
-href="glossaries-extra-manual.html#dx1-31116" >1940</a>, <a
-href="glossaries-extra-manual.html#dx1-32006" >1941</a>, <a
-href="glossaries-extra-manual.html#dx1-32037" >1942</a>, <a
-href="glossaries-extra-manual.html#dx1-32039" >1943</a>, <a
-href="glossaries-extra-manual.html#dx1-32063" >1944</a>, <a
-href="glossaries-extra-manual.html#dx1-32089" >1945</a>, <a
-href="glossaries-extra-manual.html#dx1-33007" >1946</a>, <a
-href="glossaries-extra-manual.html#dx1-33048" >1947</a>, <a
-href="glossaries-extra-manual.html#dx1-33067" >1948</a>, <a
-href="glossaries-extra-manual.html#dx1-33091" >1949</a>, <a
-href="glossaries-extra-manual.html#dx1-33104" >1950</a>, <a
-href="glossaries-extra-manual.html#dx1-33125" >1951</a>, <a
-href="glossaries-extra-manual.html#dx1-33132" >1952</a>, <a
-href="glossaries-extra-manual.html#dx1-33153" >1953</a>, <a
-href="glossaries-extra-manual.html#dx1-33160" >1954</a>, <a
-href="glossaries-extra-manual.html#dx1-33184" >1955</a>, <a
-href="glossaries-extra-manual.html#dx1-33207" >1956</a>, <a
-href="glossaries-extra-manual.html#dx1-33225" >1957</a>, <a
-href="glossaries-extra-manual.html#dx1-33245" >1958</a>, <a
-href="glossaries-extra-manual.html#dx1-33252" >1959</a>, <a
-href="glossaries-extra-manual.html#dx1-34013" >1960</a>, <a
-href="glossaries-extra-manual.html#dx1-78009" >1961</a>, <a
-href="glossaries-extra-manual.html#dx1-96041" >1962</a>, <a
-href="glossaries-extra-manual.html#dx1-96043" >1963</a>, <a
-href="glossaries-extra-manual.html#dx1-6026" >1964</a> <br /></span>
-
-
-
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">descriptionplural</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-6016" >1965</a>, <a
-href="glossaries-extra-manual.html#dx1-6019" >1966</a>, <a
-href="glossaries-extra-manual.html#dx1-6021" >1967</a>, <a
-href="glossaries-extra-manual.html#dx1-96045" >1968</a>, <a
-href="glossaries-extra-manual.html#dx1-96047" >1969</a>, <a
-href="glossaries-extra-manual.html#dx1-6023" >1970</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">first</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-9013" >1971</a>, <a
-href="glossaries-extra-manual.html#dx1-12014" >1972</a>, <a
-href="glossaries-extra-manual.html#dx1-12015" >1973</a>, <a
-href="glossaries-extra-manual.html#dx1-13004" >1974</a>, <a
-href="glossaries-extra-manual.html#dx1-31008" >1975</a>, <a
-href="glossaries-extra-manual.html#dx1-31015" >1976</a>, <a
-href="glossaries-extra-manual.html#dx1-34009" >1977</a>, <a
-href="glossaries-extra-manual.html#dx1-34015" >1978</a>, <a
-href="glossaries-extra-manual.html#dx1-37041" >1979</a>, <a
-href="glossaries-extra-manual.html#dx1-48014" >1980</a>, <a
-href="glossaries-extra-manual.html#dx1-75026" >1981</a>, <a
-href="glossaries-extra-manual.html#dx1-96025" >1982</a>, <a
-href="glossaries-extra-manual.html#dx1-96027" >1983</a>, <a
-href="glossaries-extra-manual.html#dx1-99017" >1984</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">firstaccess</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71172" >1985</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">firstplural</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-9014" >1986</a>, <a
-href="glossaries-extra-manual.html#dx1-12009" >1987</a>, <a
-href="glossaries-extra-manual.html#dx1-12013" >1988</a>, <a
-href="glossaries-extra-manual.html#dx1-12017" >1989</a>, <a
-href="glossaries-extra-manual.html#dx1-12021" >1990</a>, <a
-href="glossaries-extra-manual.html#dx1-34010" >1991</a>, <a
-href="glossaries-extra-manual.html#dx1-34016" >1992</a>, <a
-href="glossaries-extra-manual.html#dx1-96029" >1993</a>, <a
-href="glossaries-extra-manual.html#dx1-96031" >1994</a>, <a
-href="glossaries-extra-manual.html#dx1-99018" >1995</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">group</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-15016" >1996</a>, <a
-href="glossaries-extra-manual.html#dx1-78011" >1997</a>, <a
-href="glossaries-extra-manual.html#dx1-87008" >1998</a>, <a
-href="glossaries-extra-manual.html#dx1-87010" >1999</a>, <a
-href="glossaries-extra-manual.html#dx1-87012" >2000</a>, <a
-href="glossaries-extra-manual.html#dx1-87015" >2001</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">location</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24023" >2002</a>, <a
-href="glossaries-extra-manual.html#dx1-79021" >2003</a>, <a
-href="glossaries-extra-manual.html#dx1-81015" >2004</a>, <a
-href="glossaries-extra-manual.html#dx1-88008" >2005</a>, <a
-href="glossaries-extra-manual.html#dx1-88011" >2006</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">loclist</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-81014" >2007</a>, <a
-href="glossaries-extra-manual.html#dx1-88009" >2008</a>, <a
-href="glossaries-extra-manual.html#dx1-88013" >2009</a>, <a
-href="glossaries-extra-manual.html#dx1-88015" >2010</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">long</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-12026" >2011</a>, <a
-href="glossaries-extra-manual.html#dx1-12027" >2012</a>, <a
-href="glossaries-extra-manual.html#dx1-27033" >2013</a>, <a
-href="glossaries-extra-manual.html#dx1-31012" >2014</a>, <a
-href="glossaries-extra-manual.html#dx1-48013" >2015</a>, <a
-href="glossaries-extra-manual.html#dx1-65004" >2016</a>, <a
-href="glossaries-extra-manual.html#dx1-71045" >2017</a>, <a
-href="glossaries-extra-manual.html#dx1-75028" >2018</a>, <a
-href="glossaries-extra-manual.html#dx1-96057" >2019</a>, <a
-href="glossaries-extra-manual.html#dx1-96059" >2020</a>, <a
-href="glossaries-extra-manual.html#dx1-6024" >2021</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">longplural</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-12010" >2022</a>, <a
-href="glossaries-extra-manual.html#dx1-12025" >2023</a>, <a
-href="glossaries-extra-manual.html#dx1-27034" >2024</a>, <a
-href="glossaries-extra-manual.html#dx1-34030" >2025</a>, <a
-href="glossaries-extra-manual.html#dx1-96061" >2026</a>, <a
-href="glossaries-extra-manual.html#dx1-96063" >2027</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">name</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8029" >2028</a>, <a
-href="glossaries-extra-manual.html#dx1-8033" >2029</a>, <a
-href="glossaries-extra-manual.html#dx1-8034" >2030</a>, <a
-href="glossaries-extra-manual.html#dx1-8036" >2031</a>, <a
-href="glossaries-extra-manual.html#dx1-8038" >2032</a>, <a
-href="glossaries-extra-manual.html#dx1-12023" >2033</a>, <a
-href="glossaries-extra-manual.html#dx1-13002" >2034</a>, <a
-href="glossaries-extra-manual.html#dx1-17019" >2035</a>, <a
-href="glossaries-extra-manual.html#dx1-17023" >2036</a>, <a
-href="glossaries-extra-manual.html#dx1-31025" >2037</a>, <a
-href="glossaries-extra-manual.html#dx1-32004" >2038</a>, <a
-href="glossaries-extra-manual.html#dx1-32035" >2039</a>, <a
-href="glossaries-extra-manual.html#dx1-32061" >2040</a>, <a
-href="glossaries-extra-manual.html#dx1-32087" >2041</a>, <a
-href="glossaries-extra-manual.html#dx1-33005" >2042</a>, <a
-href="glossaries-extra-manual.html#dx1-33022" >2043</a>, <a
-href="glossaries-extra-manual.html#dx1-33029" >2044</a>, <a
-href="glossaries-extra-manual.html#dx1-33050" >2045</a>, <a
-href="glossaries-extra-manual.html#dx1-33064" >2046</a>, <a
-href="glossaries-extra-manual.html#dx1-33068" >2047</a>, <a
-href="glossaries-extra-manual.html#dx1-33089" >2048</a>, <a
-href="glossaries-extra-manual.html#dx1-33102" >2049</a>, <a
-href="glossaries-extra-manual.html#dx1-33106" >2050</a>, <a
-href="glossaries-extra-manual.html#dx1-33123" >2051</a>, <a
-href="glossaries-extra-manual.html#dx1-33131" >2052</a>, <a
-href="glossaries-extra-manual.html#dx1-33133" >2053</a>, <a
-href="glossaries-extra-manual.html#dx1-33151" >2054</a>, <a
-href="glossaries-extra-manual.html#dx1-33159" >2055</a>, <a
-href="glossaries-extra-manual.html#dx1-33161" >2056</a>, <a
-href="glossaries-extra-manual.html#dx1-33185" >2057</a>, <a
-href="glossaries-extra-manual.html#dx1-33206" >2058</a>, <a
-href="glossaries-extra-manual.html#dx1-33226" >2059</a>, <a
-href="glossaries-extra-manual.html#dx1-33242" >2060</a>, <a
-href="glossaries-extra-manual.html#dx1-33246" >2061</a>, <a
-href="glossaries-extra-manual.html#dx1-33253" >2062</a>, <a
-href="glossaries-extra-manual.html#dx1-33263" >2063</a>, <a
-href="glossaries-extra-manual.html#dx1-33269" >2064</a>, <a
-href="glossaries-extra-manual.html#dx1-33274" >2065</a>, <a
-href="glossaries-extra-manual.html#dx1-33282" >2066</a>, <a
-href="glossaries-extra-manual.html#dx1-33286" >2067</a>, <a
-href="glossaries-extra-manual.html#dx1-33289" >2068</a>, <a
-href="glossaries-extra-manual.html#dx1-33294" >2069</a>, <a
-href="glossaries-extra-manual.html#dx1-33297" >2070</a>, <a
-href="glossaries-extra-manual.html#dx1-34007" >2071</a>, <a
-href="glossaries-extra-manual.html#dx1-37037" >2072</a>, <a
-href="glossaries-extra-manual.html#dx1-68005" >2073</a>, <a
-href="glossaries-extra-manual.html#dx1-70008" >2074</a>, <a
-href="glossaries-extra-manual.html#dx1-70010" >2075</a>, <a
-href="glossaries-extra-manual.html#dx1-71166" >2076</a>, <a
-href="glossaries-extra-manual.html#dx1-75014" >2077</a>, <a
-href="glossaries-extra-manual.html#dx1-75027" >2078</a>, <a
-href="glossaries-extra-manual.html#dx1-87009" >2079</a>, <a
-href="glossaries-extra-manual.html#dx1-91015" >2080</a>, <a
-href="glossaries-extra-manual.html#dx1-93010" >2081</a>, <a
-href="glossaries-extra-manual.html#dx1-96009" >2082</a>, <a
-href="glossaries-extra-manual.html#dx1-97008" >2083</a>, <a
-href="glossaries-extra-manual.html#dx1-97016" >2084</a>, <a
-href="glossaries-extra-manual.html#dx1-97017" >2085</a>, <a
-href="glossaries-extra-manual.html#dx1-97018" >2086</a>, <a
-href="glossaries-extra-manual.html#dx1-97020" >2087</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">nameshortaccess</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71168" >2088</a>, <a
-href="glossaries-extra-manual.html#dx1-71171" >2089</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">parent</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22082" >2090</a>, <a
-href="glossaries-extra-manual.html#dx1-38011" >2091</a>, <a
-href="glossaries-extra-manual.html#dx1-75025" >2092</a>, <a
-href="glossaries-extra-manual.html#dx1-86015" >2093</a>, <a
-href="glossaries-extra-manual.html#dx1-90047" >2094</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">plural</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-9017" >2095</a>, <a
-href="glossaries-extra-manual.html#dx1-12002" >2096</a>, <a
-href="glossaries-extra-manual.html#dx1-12004" >2097</a>, <a
-href="glossaries-extra-manual.html#dx1-12007" >2098</a>, <a
-href="glossaries-extra-manual.html#dx1-12008" >2099</a>, <a
-href="glossaries-extra-manual.html#dx1-12016" >2100</a>, <a
-href="glossaries-extra-manual.html#dx1-12018" >2101</a>, <a
-href="glossaries-extra-manual.html#dx1-12019" >2102</a>, <a
-href="glossaries-extra-manual.html#dx1-12020" >2103</a>, <a
-href="glossaries-extra-manual.html#dx1-34012" >2104</a>, <a
-href="glossaries-extra-manual.html#dx1-86014" >2105</a>, <a
-href="glossaries-extra-manual.html#dx1-96021" >2106</a>, <a
-href="glossaries-extra-manual.html#dx1-96023" >2107</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">prefix</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-15011" >2108</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">see</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4060" >2109</a>, <a
-href="glossaries-extra-manual.html#dx1-4063" >2110</a>, <a
-href="glossaries-extra-manual.html#dx1-4070" >2111</a>, <a
-href="glossaries-extra-manual.html#dx1-4075" >2112</a>, <a
-href="glossaries-extra-manual.html#dx1-4090" >2113</a>, <a
-href="glossaries-extra-manual.html#dx1-4092" >2114</a>, <a
-href="glossaries-extra-manual.html#dx1-4094" >2115</a>, <a
-href="glossaries-extra-manual.html#dx1-6010" >2116</a>, <a
-href="glossaries-extra-manual.html#dx1-6011" >2117</a>, <a
-href="glossaries-extra-manual.html#dx1-8001" >2118</a>, <a
-href="glossaries-extra-manual.html#dx1-8002" >2119</a>, <a
-href="glossaries-extra-manual.html#dx1-8003" >2120</a>, <a
-href="glossaries-extra-manual.html#dx1-8007" >2121</a>, <a
-href="glossaries-extra-manual.html#dx1-8010" >2122</a>, <a
-href="glossaries-extra-manual.html#dx1-8012" >2123</a>, <a
-href="glossaries-extra-manual.html#dx1-8014" >2124</a>, <a
-href="glossaries-extra-manual.html#dx1-8017" >2125</a>, <a
-href="glossaries-extra-manual.html#dx1-8019" >2126</a>, <a
-href="glossaries-extra-manual.html#dx1-8032" >2127</a>, <a
-href="glossaries-extra-manual.html#dx1-8056" >2128</a>, <a
-href="glossaries-extra-manual.html#dx1-8060" >2129</a>, <a
-href="glossaries-extra-manual.html#dx1-8061" >2130</a>, <a
-href="glossaries-extra-manual.html#dx1-8070" >2131</a>, <a
-href="glossaries-extra-manual.html#dx1-38012" >2132</a>, <a
-href="glossaries-extra-manual.html#dx1-68001" >2133</a>, <a
-href="glossaries-extra-manual.html#dx1-78008" >2134</a>, <a
-href="glossaries-extra-manual.html#dx1-87018" >2135</a>, <a
-href="glossaries-extra-manual.html#dx1-92003" >2136</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">seealso</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4061" >2137</a>, <a
-href="glossaries-extra-manual.html#dx1-4064" >2138</a>, <a
-href="glossaries-extra-manual.html#dx1-4071" >2139</a>, <a
-href="glossaries-extra-manual.html#dx1-6009" >2140</a>, <a
-href="glossaries-extra-manual.html#dx1-6013" >2141</a>, <a
-href="glossaries-extra-manual.html#dx1-8059" >2142</a>, <a
-href="glossaries-extra-manual.html#dx1-8062" >2143</a>, <a
-href="glossaries-extra-manual.html#dx1-8067" >2144</a>, <a
-href="glossaries-extra-manual.html#dx1-8069" >2145</a>, <a
-href="glossaries-extra-manual.html#dx1-8075" >2146</a>, <a
-href="glossaries-extra-manual.html#dx1-8082" >2147</a>, <a
-href="glossaries-extra-manual.html#dx1-38013" >2148</a>, <a
-href="glossaries-extra-manual.html#dx1-68002" >2149</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">short</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8046" >2150</a>, <a
-href="glossaries-extra-manual.html#dx1-9011" >2151</a>, <a
-href="glossaries-extra-manual.html#dx1-9018" >2152</a>, <a
-href="glossaries-extra-manual.html#dx1-9021" >2153</a>, <a
-href="glossaries-extra-manual.html#dx1-12031" >2154</a>, <a
-href="glossaries-extra-manual.html#dx1-12033" >2155</a>, <a
-href="glossaries-extra-manual.html#dx1-12039" >2156</a>, <a
-href="glossaries-extra-manual.html#dx1-27031" >2157</a>, <a
-href="glossaries-extra-manual.html#dx1-31011" >2158</a>, <a
-href="glossaries-extra-manual.html#dx1-31018" >2159</a>, <a
-href="glossaries-extra-manual.html#dx1-48015" >2160</a>, <a
-href="glossaries-extra-manual.html#dx1-65002" >2161</a>, <a
-href="glossaries-extra-manual.html#dx1-65006" >2162</a>, <a
-href="glossaries-extra-manual.html#dx1-68006" >2163</a>, <a
-href="glossaries-extra-manual.html#dx1-71044" >2164</a>, <a
-href="glossaries-extra-manual.html#dx1-71077" >2165</a>, <a
-href="glossaries-extra-manual.html#dx1-71147" >2166</a>, <a
-href="glossaries-extra-manual.html#dx1-96049" >2167</a>, <a
-href="glossaries-extra-manual.html#dx1-96051" >2168</a>, <a
-href="glossaries-extra-manual.html#dx1-6025" >2169</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">shortaccess</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71134" >2170</a>, <a
-href="glossaries-extra-manual.html#dx1-71146" >2171</a>, <a
-href="glossaries-extra-manual.html#dx1-71148" >2172</a>, <a
-href="glossaries-extra-manual.html#dx1-71152" >2173</a>, <a
-href="glossaries-extra-manual.html#dx1-71155" >2174</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">shortplural</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-12011" >2175</a>, <a
-href="glossaries-extra-manual.html#dx1-12028" >2176</a>, <a
-href="glossaries-extra-manual.html#dx1-12032" >2177</a>, <a
-href="glossaries-extra-manual.html#dx1-12038" >2178</a>, <a
-href="glossaries-extra-manual.html#dx1-27015" >2179</a>, <a
-href="glossaries-extra-manual.html#dx1-27032" >2180</a>, <a
-href="glossaries-extra-manual.html#dx1-31046" >2181</a>, <a
-href="glossaries-extra-manual.html#dx1-34026" >2182</a>, <a
-href="glossaries-extra-manual.html#dx1-34042" >2183</a>, <a
-href="glossaries-extra-manual.html#dx1-71063" >2184</a>, <a
-href="glossaries-extra-manual.html#dx1-71069" >2185</a>, <a
-href="glossaries-extra-manual.html#dx1-71073" >2186</a>, <a
-href="glossaries-extra-manual.html#dx1-71078" >2187</a>, <a
-href="glossaries-extra-manual.html#dx1-96053" >2188</a>, <a
-href="glossaries-extra-manual.html#dx1-96055" >2189</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">shortpluralaccess</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71151" >2190</a>, <a
-href="glossaries-extra-manual.html#dx1-71153" >2191</a>, <a
-href="glossaries-extra-manual.html#dx1-71157" >2192</a>, <a
-href="glossaries-extra-manual.html#dx1-71162" >2193</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">sort</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4197" >2194</a>, <a
-href="glossaries-extra-manual.html#dx1-4239" >2195</a>, <a
-href="glossaries-extra-manual.html#dx1-13016" >2196</a>, <a
-href="glossaries-extra-manual.html#dx1-13039" >2197</a>, <a
-href="glossaries-extra-manual.html#dx1-31026" >2198</a>, <a
-href="glossaries-extra-manual.html#dx1-32060" >2199</a>, <a
-href="glossaries-extra-manual.html#dx1-32086" >2200</a>, <a
-href="glossaries-extra-manual.html#dx1-33004" >2201</a>, <a
-href="glossaries-extra-manual.html#dx1-33065" >2202</a>, <a
-href="glossaries-extra-manual.html#dx1-33092" >2203</a>, <a
-href="glossaries-extra-manual.html#dx1-33103" >2204</a>, <a
-href="glossaries-extra-manual.html#dx1-33187" >2205</a>, <a
-href="glossaries-extra-manual.html#dx1-33227" >2206</a>, <a
-href="glossaries-extra-manual.html#dx1-34008" >2207</a>, <a
-href="glossaries-extra-manual.html#dx1-34035" >2208</a>, <a
-href="glossaries-extra-manual.html#dx1-71060" >2209</a>, <a
-href="glossaries-extra-manual.html#dx1-71065" >2210</a>, <a
-href="glossaries-extra-manual.html#dx1-75006" >2211</a>, <a
-href="glossaries-extra-manual.html#dx1-75018" >2212</a>, <a
-href="glossaries-extra-manual.html#dx1-75023" >2213</a>, <a
-href="glossaries-extra-manual.html#dx1-75029" >2214</a>, <a
-href="glossaries-extra-manual.html#dx1-76015" >2215</a>, <a
-href="glossaries-extra-manual.html#dx1-91002" >2216</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">symbol</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-17013" >2217</a>, <a
-href="glossaries-extra-manual.html#dx1-17017" >2218</a>, <a
-href="glossaries-extra-manual.html#dx1-66005" >2219</a>, <a
-href="glossaries-extra-manual.html#dx1-66007" >2220</a>, <a
-href="glossaries-extra-manual.html#dx1-66009" >2221</a>, <a
-href="glossaries-extra-manual.html#dx1-86036" >2222</a>, <a
-href="glossaries-extra-manual.html#dx1-96033" >2223</a>, <a
-href="glossaries-extra-manual.html#dx1-96035" >2224</a>, <a
-href="glossaries-extra-manual.html#dx1-6027" >2225</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">symbolaccess</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-17015" >2226</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">symbolplural</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-96037" >2227</a>, <a
-href="glossaries-extra-manual.html#dx1-96039" >2228</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">text</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8028" >2229</a>, <a
-href="glossaries-extra-manual.html#dx1-8035" >2230</a>, <a
-href="glossaries-extra-manual.html#dx1-8037" >2231</a>, <a
-href="glossaries-extra-manual.html#dx1-9016" >2232</a>, <a
-href="glossaries-extra-manual.html#dx1-12005" >2233</a>, <a
-href="glossaries-extra-manual.html#dx1-12022" >2234</a>, <a
-href="glossaries-extra-manual.html#dx1-12024" >2235</a>, <a
-href="glossaries-extra-manual.html#dx1-13003" >2236</a>, <a
-href="glossaries-extra-manual.html#dx1-31010" >2237</a>, <a
-href="glossaries-extra-manual.html#dx1-31016" >2238</a>, <a
-href="glossaries-extra-manual.html#dx1-34011" >2239</a>, <a
-href="glossaries-extra-manual.html#dx1-37030" >2240</a>, <a
-href="glossaries-extra-manual.html#dx1-48016" >2241</a>, <a
-href="glossaries-extra-manual.html#dx1-68007" >2242</a>, <a
-href="glossaries-extra-manual.html#dx1-86013" >2243</a>, <a
-href="glossaries-extra-manual.html#dx1-96017" >2244</a>, <a
-href="glossaries-extra-manual.html#dx1-96019" >2245</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">textaccess</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71169" >2246</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">type</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14058" >2247</a>, <a
-href="glossaries-extra-manual.html#dx1-71006" >2248</a>, <a
-href="glossaries-extra-manual.html#dx1-82010" >2249</a>, <a
-href="glossaries-extra-manual.html#dx1-90050" >2250</a>, <a
-href="glossaries-extra-manual.html#dx1-91006" >2251</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">user1</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-17018" >2252</a>, <a
-href="glossaries-extra-manual.html#dx1-31098" >2253</a>, <a
-href="glossaries-extra-manual.html#dx1-31103" >2254</a>, <a
-href="glossaries-extra-manual.html#dx1-42001" >2255</a>, <a
-href="glossaries-extra-manual.html#dx1-66012" >2256</a>, <a
-href="glossaries-extra-manual.html#dx1-66018" >2257</a>, <a
-href="glossaries-extra-manual.html#dx1-66022" >2258</a>, <a
-href="glossaries-extra-manual.html#dx1-66025" >2259</a>, <a
-href="glossaries-extra-manual.html#dx1-71046" >2260</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">user2</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-66017" >2261</a>, <a
-href="glossaries-extra-manual.html#dx1-66021" >2262</a> <br /></span>
-<span class="index-item">number list&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4030" >2263</a>, <a
-href="glossaries-extra-manual.html#dx1-4032" >2264</a>, <a
-href="glossaries-extra-manual.html#dx1-4033" >2265</a>, <a
-href="glossaries-extra-manual.html#dx1-4035" >2266</a>, <a
-href="glossaries-extra-manual.html#dx1-4150" >2267</a>, <a
-href="glossaries-extra-manual.html#dx1-4160" >2268</a>, <a
-href="glossaries-extra-manual.html#dx1-4164" >2269</a>, <a
-href="glossaries-extra-manual.html#dx1-4174" >2270</a>, <a
-href="glossaries-extra-manual.html#dx1-4175" >2271</a>, <a
-href="glossaries-extra-manual.html#dx1-7032" >2272</a>, <a
-href="glossaries-extra-manual.html#dx1-8018" >2273</a>, <a
-href="glossaries-extra-manual.html#dx1-8052" >2274</a>, <a
-href="glossaries-extra-manual.html#dx1-8055" >2275</a>, <a
-href="glossaries-extra-manual.html#dx1-8057" >2276</a>, <a
-href="glossaries-extra-manual.html#dx1-8058" >2277</a>, <a
-href="glossaries-extra-manual.html#dx1-18001" >2278</a>, <a
-href="glossaries-extra-manual.html#dx1-18004" >2279</a>, <a
-href="glossaries-extra-manual.html#dx1-18005" >2280</a>, <a
-href="glossaries-extra-manual.html#dx1-18006" >2281</a>, <a
-href="glossaries-extra-manual.html#dx1-18008" >2282</a>, <a
-href="glossaries-extra-manual.html#dx1-18009" >2283</a>, <a
-href="glossaries-extra-manual.html#dx1-18011" >2284</a>, <a
-href="glossaries-extra-manual.html#dx1-21007" >2285</a>, <a
-href="glossaries-extra-manual.html#dx1-22016" >2286</a>, <a
-href="glossaries-extra-manual.html#dx1-22044" >2287</a>, <a
-href="glossaries-extra-manual.html#dx1-22089" >2288</a>, <a
-href="glossaries-extra-manual.html#dx1-22091" >2289</a>, <a
-href="glossaries-extra-manual.html#dx1-22094" >2290</a>, <a
-href="glossaries-extra-manual.html#dx1-22096" >2291</a>, <a
-href="glossaries-extra-manual.html#dx1-40001" >2292</a>, <a
-href="glossaries-extra-manual.html#dx1-87006" >2293</a>, <a
-href="glossaries-extra-manual.html#dx1-88010" >2294</a>, <a
-href="glossaries-extra-manual.html#dx1-97015" >2295</a>, <a
-href="glossaries-extra-manual.html#dx1-99025" >2296</a>, <a
-href="glossaries-extra-manual.html#dx1-99034" ><span
-class="cmbx-10">2297</span></a> <br /></span>
-</p><p class="theindex"> <span
-class="cmbx-10">P</span>
-<span class="index-item">package options:<br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">abbreviations</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4218" >2298</a>, <a
-href="glossaries-extra-manual.html#dx1-4230" >2299</a>, <a
-href="glossaries-extra-manual.html#dx1-4231" >2300</a>, <a
-href="glossaries-extra-manual.html#dx1-4283" >2301</a>, <a
-href="glossaries-extra-manual.html#dx1-98002" >2302</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">accsupp</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4038" >2303</a>, <a
-href="glossaries-extra-manual.html#dx1-4045" >2304</a>, <a
-href="glossaries-extra-manual.html#dx1-71133" >2305</a>, <a
-href="glossaries-extra-manual.html#dx1-71141" >2306</a>, <a
-href="glossaries-extra-manual.html#dx1-71144" >2307</a>, <a
-href="glossaries-extra-manual.html#dx1-91019" >2308</a>, <a
-href="glossaries-extra-manual.html#dx1-96003" >2309</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">acronym</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4232" >2310</a>, <a
-href="glossaries-extra-manual.html#dx1-4249" >2311</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">acronymlists</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4236" >2312</a>, <a
-href="glossaries-extra-manual.html#dx1-27038" >2313</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">acronyms</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4248" >2314</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">automake</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-6040" >2315</a>, <a
-href="glossaries-extra-manual.html#dx1-98021" >2316</a> <br /></span>
-
-
-
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">autoseeindex</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4069" >2317</a>, <a
-href="glossaries-extra-manual.html#dx1-4076" >2318</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">false</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4062" >2319</a>, <a
-href="glossaries-extra-manual.html#dx1-4073" >2320</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">colorlinks</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-44002" >2321</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">counter</span><br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">chapter</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4101" >2322</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">equation</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4104" >2323</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">section</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4102" >2324</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">wrglossary</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4151" >2325</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">debug</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4002" >2326</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">all</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4005" >2327</a>, <a
-href="glossaries-extra-manual.html#dx1-4013" >2328</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">showtargets</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4003" >2329</a>, <a
-href="glossaries-extra-manual.html#dx1-4014" >2330</a>, <a
-href="glossaries-extra-manual.html#dx1-4017" >2331</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">showwrgloss</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4004" >2332</a>, <a
-href="glossaries-extra-manual.html#dx1-4006" >2333</a>, <a
-href="glossaries-extra-manual.html#dx1-4015" >2334</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">true</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4007" >2335</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">docdef</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4177" >2336</a>, <a
-href="glossaries-extra-manual.html#dx1-4284" >2337</a>, <a
-href="glossaries-extra-manual.html#dx1-4285" >2338</a>, <a
-href="glossaries-extra-manual.html#dx1-6036" >2339</a>, <a
-href="glossaries-extra-manual.html#dx1-68010" >2340</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">atom</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4199" >2341</a>, <a
-href="glossaries-extra-manual.html#dx1-4205" >2342</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">false</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4178" >2343</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">restricted</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4190" >2344</a>, <a
-href="glossaries-extra-manual.html#dx1-4191" >2345</a>, <a
-href="glossaries-extra-manual.html#dx1-4200" >2346</a>, <a
-href="glossaries-extra-manual.html#dx1-4201" >2347</a>, <a
-href="glossaries-extra-manual.html#dx1-4215" >2348</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">true</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4182" >2349</a>, <a
-href="glossaries-extra-manual.html#dx1-4214" >2350</a>, <a
-href="glossaries-extra-manual.html#dx1-4216" >2351</a>, <a
-href="glossaries-extra-manual.html#dx1-38005" >2352</a>, <a
-href="glossaries-extra-manual.html#dx1-68009" >2353</a>, <a
-href="glossaries-extra-manual.html#dx1-69013" >2354</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">docdefs</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-87023" >2355</a>, <a
-href="glossaries-extra-manual.html#dx1-93003" >2356</a>, <a
-href="glossaries-extra-manual.html#dx1-93006" >2357</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">true</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4189" >2358</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">entrycounter</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-85002" >2359</a>, <a
-href="glossaries-extra-manual.html#dx1-91007" >2360</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">equations</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4132" >2361</a>, <a
-href="glossaries-extra-manual.html#dx1-7045" >2362</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">true</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4105" >2363</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">floats</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4139" >2364</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">hyperfirst</span><br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">false</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-71030" >2365</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">index</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4254" >2366</a>, <a
-href="glossaries-extra-manual.html#dx1-6029" >2367</a>, <a
-href="glossaries-extra-manual.html#dx1-71011" >2368</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">indexcounter</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4100" >2369</a>, <a
-href="glossaries-extra-manual.html#dx1-4145" >2370</a>, <a
-href="glossaries-extra-manual.html#dx1-4161" >2371</a>, <a
-href="glossaries-extra-manual.html#dx1-79031" >2372</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">indexcrossrefs</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4059" >2373</a>, <a
-href="glossaries-extra-manual.html#dx1-4065" >2374</a>, <a
-href="glossaries-extra-manual.html#dx1-4074" >2375</a>, <a
-href="glossaries-extra-manual.html#dx1-8006" >2376</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">false</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4068" >2377</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">indexonlyfirst</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7004" >2378</a>, <a
-href="glossaries-extra-manual.html#dx1-7006" >2379</a>, <a
-href="glossaries-extra-manual.html#dx1-71038" >2380</a>, <a
-href="glossaries-extra-manual.html#dx1-75040" >2381</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">makeindex</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-81016" >2382</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">nogroupskip</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-21005" >2383</a>, <a
-href="glossaries-extra-manual.html#dx1-22019" >2384</a>, <a
-href="glossaries-extra-manual.html#dx1-22021" >2385</a>, <a
-href="glossaries-extra-manual.html#dx1-22030" >2386</a>, <a
-href="glossaries-extra-manual.html#dx1-26008" >2387</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">nomain</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-3039" >2388</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">nomissingglstext</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4217" >2389</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">nonumberlist</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8053" >2390</a>, <a
-href="glossaries-extra-manual.html#dx1-18003" >2391</a>, <a
-href="glossaries-extra-manual.html#dx1-18007" >2392</a>, <a
-href="glossaries-extra-manual.html#dx1-25046" >2393</a>, <a
-href="glossaries-extra-manual.html#dx1-99036" >2394</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">nopostdot</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4025" >2395</a>, <a
-href="glossaries-extra-manual.html#dx1-4027" >2396</a>, <a
-href="glossaries-extra-manual.html#dx1-17039" >2397</a>, <a
-href="glossaries-extra-manual.html#dx1-20004" >2398</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">false</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-3004" >2399</a>, <a
-href="glossaries-extra-manual.html#dx1-4020" >2400</a>, <a
-href="glossaries-extra-manual.html#dx1-17033" >2401</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">true</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-3003" >2402</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">noredefwarn</span><br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">false</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-3009" >2403</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">true</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-3006" >2404</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">notree</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22064" >2405</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">numbers</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4243" >2406</a>, <a
-href="glossaries-extra-manual.html#dx1-4273" >2407</a>, <a
-href="glossaries-extra-manual.html#dx1-71017" >2408</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">postdot</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-3005" >2409</a>, <a
-href="glossaries-extra-manual.html#dx1-4019" >2410</a>, <a
-href="glossaries-extra-manual.html#dx1-4028" >2411</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">postpunc</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4021" >2412</a>, <a
-href="glossaries-extra-manual.html#dx1-4026" >2413</a>, <a
-href="glossaries-extra-manual.html#dx1-4031" >2414</a> <br /></span>
-
-
-
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">comma</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4022" >2415</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">dot</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4023" >2416</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">none</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4024" >2417</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">prefix</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4036" >2418</a>, <a
-href="glossaries-extra-manual.html#dx1-67002" >2419</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">record</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4067" >2420</a>, <a
-href="glossaries-extra-manual.html#dx1-4077" >2421</a>, <a
-href="glossaries-extra-manual.html#dx1-11004" >2422</a>, <a
-href="glossaries-extra-manual.html#dx1-24009" >2423</a>, <a
-href="glossaries-extra-manual.html#dx1-76010" >2424</a>, <a
-href="glossaries-extra-manual.html#dx1-76021" >2425</a>, <a
-href="glossaries-extra-manual.html#dx1-79002" >2426</a>, <a
-href="glossaries-extra-manual.html#dx1-79009" >2427</a>, <a
-href="glossaries-extra-manual.html#dx1-86088" >2428</a>, <a
-href="glossaries-extra-manual.html#dx1-87011" >2429</a>, <a
-href="glossaries-extra-manual.html#dx1-87016" >2430</a>, <a
-href="glossaries-extra-manual.html#dx1-89005" >2431</a>, <a
-href="glossaries-extra-manual.html#dx1-98008" >2432</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">hybrid</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4009" >2433</a>, <a
-href="glossaries-extra-manual.html#dx1-4128" >2434</a>, <a
-href="glossaries-extra-manual.html#dx1-6034" >2435</a>, <a
-href="glossaries-extra-manual.html#dx1-76013" >2436</a>, <a
-href="glossaries-extra-manual.html#dx1-79005" >2437</a>, <a
-href="glossaries-extra-manual.html#dx1-89006" >2438</a>, <a
-href="glossaries-extra-manual.html#dx1-92008" >2439</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">nameref</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4080" >2440</a>, <a
-href="glossaries-extra-manual.html#dx1-4127" >2441</a>, <a
-href="glossaries-extra-manual.html#dx1-70013" >2442</a>, <a
-href="glossaries-extra-manual.html#dx1-81001" >2443</a>, <a
-href="glossaries-extra-manual.html#dx1-81010" >2444</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">off</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-6035" >2445</a>, <a
-href="glossaries-extra-manual.html#dx1-92007" >2446</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">only</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4072" >2447</a>, <a
-href="glossaries-extra-manual.html#dx1-4081" >2448</a>, <a
-href="glossaries-extra-manual.html#dx1-4082" >2449</a>, <a
-href="glossaries-extra-manual.html#dx1-4089" >2450</a>, <a
-href="glossaries-extra-manual.html#dx1-4095" >2451</a>, <a
-href="glossaries-extra-manual.html#dx1-4098" >2452</a>, <a
-href="glossaries-extra-manual.html#dx1-4126" >2453</a>, <a
-href="glossaries-extra-manual.html#dx1-6033" >2454</a>, <a
-href="glossaries-extra-manual.html#dx1-70012" >2455</a>, <a
-href="glossaries-extra-manual.html#dx1-79001" >2456</a>, <a
-href="glossaries-extra-manual.html#dx1-87022" >2457</a>, <a
-href="glossaries-extra-manual.html#dx1-92011" >2458</a>, <a
-href="glossaries-extra-manual.html#dx1-92016" >2459</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">savenumberlist</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-79016" >2460</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">section</span><br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">chapter</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24040" >2461</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">seeautonumberlist</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8054" >2462</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">seenoindex</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8011" >2463</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">ignore</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8013" >2464</a>, <a
-href="glossaries-extra-manual.html#dx1-87020" >2465</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">warn</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-87021" >2466</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">shortcuts</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4258" >2467</a>, <a
-href="glossaries-extra-manual.html#dx1-4281" >2468</a>, <a
-href="glossaries-extra-manual.html#dx1-14008" >2469</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">abbr</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4264" >2470</a>, <a
-href="glossaries-extra-manual.html#dx1-30002" >2471</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">abbreviations</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4263" >2472</a>, <a
-href="glossaries-extra-manual.html#dx1-4277" >2473</a>, <a
-href="glossaries-extra-manual.html#dx1-30001" >2474</a>, <a
-href="glossaries-extra-manual.html#dx1-30005" >2475</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">ac</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4261" >2476</a>, <a
-href="glossaries-extra-manual.html#dx1-4262" >2477</a>, <a
-href="glossaries-extra-manual.html#dx1-4276" >2478</a>, <a
-href="glossaries-extra-manual.html#dx1-14009" >2479</a>, <a
-href="glossaries-extra-manual.html#dx1-30003" >2480</a>, <a
-href="glossaries-extra-manual.html#dx1-30006" >2481</a>, <a
-href="glossaries-extra-manual.html#dx1-73011" >2482</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">acro</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4260" >2483</a>, <a
-href="glossaries-extra-manual.html#dx1-73014" >2484</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">acronyms</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4259" >2485</a>, <a
-href="glossaries-extra-manual.html#dx1-73013" >2486</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">all</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4274" >2487</a>, <a
-href="glossaries-extra-manual.html#dx1-73012" >2488</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">false</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4280" >2489</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">none</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4279" >2490</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">other</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4265" >2491</a>, <a
-href="glossaries-extra-manual.html#dx1-4278" >2492</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">true</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4275" >2493</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">showtargets</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4016" >2494</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">annoteleft</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-45004" >2495</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">sort</span><br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">none</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4096" >2496</a>, <a
-href="glossaries-extra-manual.html#dx1-91001" >2497</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">stylemods</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4048" >2498</a>, <a
-href="glossaries-extra-manual.html#dx1-16002" >2499</a>, <a
-href="glossaries-extra-manual.html#dx1-19003" >2500</a>, <a
-href="glossaries-extra-manual.html#dx1-19005" >2501</a>, <a
-href="glossaries-extra-manual.html#dx1-23001" >2502</a>, <a
-href="glossaries-extra-manual.html#dx1-24004" >2503</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">all</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4051" >2504</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">default</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4050" >2505</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">subentrycounter</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-85003" >2506</a>, <a
-href="glossaries-extra-manual.html#dx1-91008" >2507</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">symbols</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4237" >2508</a>, <a
-href="glossaries-extra-manual.html#dx1-4270" >2509</a>, <a
-href="glossaries-extra-manual.html#dx1-71014" >2510</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">toc</span><br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">false</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-3002" >2511</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">true</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-3001" >2512</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">translate</span><br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">babel</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-3011" >2513</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">true</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-3013" >2514</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">undefaction</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4052" >2515</a>, <a
-href="glossaries-extra-manual.html#dx1-6006" >2516</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">error</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4053" >2517</a>, <a
-href="glossaries-extra-manual.html#dx1-4083" >2518</a>, <a
-href="glossaries-extra-manual.html#dx1-11002" >2519</a> <br /></span>
-<span class="index-subsubitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">warn</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4054" >2520</a>, <a
-href="glossaries-extra-manual.html#dx1-4058" >2521</a>, <a
-href="glossaries-extra-manual.html#dx1-4085" >2522</a>, <a
-href="glossaries-extra-manual.html#dx1-4198" >2523</a>, <a
-href="glossaries-extra-manual.html#dx1-11003" >2524</a>, <a
-href="glossaries-extra-manual.html#dx1-11005" >2525</a>, <a
-href="glossaries-extra-manual.html#dx1-76022" >2526</a>, <a
-href="glossaries-extra-manual.html#dx1-86006" >2527</a>, <a
-href="glossaries-extra-manual.html#dx1-86019" >2528</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">writeglslabelnames</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4203" >2529</a> <br /></span>
-
-
-
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">writeglslabels</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4202" >2530</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">xindy</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8077" >2531</a>, <a
-href="glossaries-extra-manual.html#dx1-75004" >2532</a> <br /></span>
-<span class="index-item"><span
-class="cmtt-10">page </span>(counter)&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4103" >2533</a>, <a
-href="glossaries-extra-manual.html#dx1-4157" >2534</a>, <a
-href="glossaries-extra-manual.html#dx1-4170" >2535</a>, <a
-href="glossaries-extra-manual.html#dx1-73031" >2536</a>, <a
-href="glossaries-extra-manual.html#dx1-73043" >2537</a>, <a
-href="glossaries-extra-manual.html#dx1-81020" >2538</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">polyglossia </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86087" >2539</a>, <a
-href="glossaries-extra-manual.html#dx1-98005" >2540</a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\pretoglossarypreamble</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-85011" ><span
-class="cmti-10">2541</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\printabbreviations</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4222" ><span
-class="cmti-10">2542</span></a> <br /></span>
-<span class="index-item"><span
-class="cmtt-10">\printglossary </span>options<br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">label</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-15013" >2543</a>, <a
-href="glossaries-extra-manual.html#dx1-90039" >2544</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">nogroupskip</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-21006" >2545</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">numberedsection</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-90038" >2546</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">prefix</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-15010" >2547</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">style</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-90037" >2548</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">target</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-15006" >2549</a>, <a
-href="glossaries-extra-manual.html#dx1-85009" >2550</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">targetnameprefix</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-15007" >2551</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">title</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-90035" >2552</a>, <a
-href="glossaries-extra-manual.html#dx1-98006" >2553</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">toctitle</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-90036" >2554</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">type</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-90023" >2555</a> <br /></span>
-<span class="index-item"><span
-class="cmtt-10">\printnoidxglossary </span>options<br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">sort</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-87024" >2556</a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\printunsrtabbreviations</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4224" ><span
-class="cmti-10">2557</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\printunsrtacronyms</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4251" ><span
-class="cmti-10">2558</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\printunsrtglossaries</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-87025" ><span
-class="cmti-10">2559</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\printunsrtglossary</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-87001" ><span
-class="cmti-10">2560</span></a> <br /></span>
-<span class="index-item"><span
-class="cmtt-10">\printunsrtglossary </span>options<br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">groups</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-15015" >2561</a>, <a
-href="glossaries-extra-manual.html#dx1-87013" >2562</a> <br /></span>
-<span class="index-subitem">&#x00A0;&#x00A0;&#x00A0;&#x00A0;<span
-class="cmss-10">leveloffset</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-15017" >2563</a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\printunsrtglossary*</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-87005" ><span
-class="cmti-10">2564</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\printunsrtglossaryentryprocesshook</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-88003" ><span
-class="cmti-10">2565</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\printunsrtglossaryhandler</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-88006" ><span
-class="cmti-10">2566</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\printunsrtglossarypredoglossary</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-88005" ><span
-class="cmti-10">2567</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\printunsrtglossaryskipentry</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-88004" ><span
-class="cmti-10">2568</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\printunsrtglossaryunit</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-89003" ><span
-class="cmti-10">2569</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\printunsrtglossaryunitsetup</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-89004" ><span
-class="cmti-10">2570</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\printunsrtindex</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4256" ><span
-class="cmti-10">2571</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\printunsrtnumbers</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4246" ><span
-class="cmti-10">2572</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\printunsrtsymbols</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4241" ><span
-class="cmti-10">2573</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\provideignoredglossary</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-15003" ><span
-class="cmti-10">2574</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\providemultiglossaryentry</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-38004" ><span
-class="cmti-10">2575</span></a> <br /></span>
-</p><p class="theindex"> <span
-class="cmbx-10">R</span>
-<span class="index-item"><span
-class="cmss-10">relsizes </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-31052" >2576</a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\RestoreAcronyms</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-14057" ><span
-class="cmti-10">2577</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\rGLS</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-84013" ><span
-class="cmti-10">2578</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\rGls</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-84011" ><span
-class="cmti-10">2579</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\rgls</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-84009" ><span
-class="cmti-10">2580</span></a> <br /></span>
-
-
-
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\rGLSformat</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-84029" ><span
-class="cmti-10">2581</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\rGlsformat</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-84027" ><span
-class="cmti-10">2582</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\rglsformat</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-84025" ><span
-class="cmti-10">2583</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\rGLSpl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-84014" ><span
-class="cmti-10">2584</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\rGlspl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-84012" ><span
-class="cmti-10">2585</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\rglspl</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-84010" ><span
-class="cmti-10">2586</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\rGLSplformat</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-84030" ><span
-class="cmti-10">2587</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\rGlsplformat</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-84028" ><span
-class="cmti-10">2588</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\rglsplformat</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-84026" ><span
-class="cmti-10">2589</span></a> <br /></span>
-</p><p class="theindex"> <span
-class="cmbx-10">S</span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\seealsoname</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8079" ><span
-class="cmti-10">2590</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\setabbreviationstyle</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-29001" ><span
-class="cmti-10">2591</span></a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">slantsc </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-37009" >2592</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">soul </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7024" >2593</a>, <a
-href="glossaries-extra-manual.html#dx1-11012" >2594</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">style </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-24005" >2595</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">subentrycounter </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-91021" >2596</a> <br /></span>
-</p><p class="theindex"> <span
-class="cmbx-10">T</span>
-<span class="index-item"><span
-class="cmtt-10">texindy</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-75007" >2597</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">textcase </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7" >2598</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">tracklang </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-3" >2599</a>, <a
-href="glossaries-extra-manual.html#dx1-78003" >2600</a>, <a
-href="glossaries-extra-manual.html#dx1-82030" >2601</a>, <a
-href="glossaries-extra-manual.html#dx1-82031" >2602</a>, <a
-href="glossaries-extra-manual.html#dx1-82032" >2603</a>, <a
-href="glossaries-extra-manual.html#dx1-82033" >2604</a>, <a
-href="glossaries-extra-manual.html#dx1-82035" >2605</a>, <a
-href="glossaries-extra-manual.html#dx1-86083" >2606</a>, <a
-href="glossaries-extra-manual.html#dx1-86085" >2607</a>, <a
-href="glossaries-extra-manual.html#dx1-98009" >2608</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">translator </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-3012" >2609</a> <br /></span>
-</p><p class="theindex"> <span
-class="cmbx-10">U</span>
-<span class="index-item"><span
-class="cmss-10">upgreek </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-82029" >2610</a>, <a
-href="glossaries-extra-manual.html#dx1-82098" >2611</a>, <a
-href="glossaries-extra-manual.html#dx1-82104" >2612</a>, <a
-href="glossaries-extra-manual.html#dx1-82109" >2613</a> <br /></span>
-</p><p class="theindex"> <span
-class="cmbx-10">W</span>
-<span class="index-item"><span
-class="cmtt-10">wrglossary </span>(counter)&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-4152" >2614</a>, <a
-href="glossaries-extra-manual.html#dx1-4162" >2615</a>, <a
-href="glossaries-extra-manual.html#dx1-4163" >2616</a>, <a
-href="glossaries-extra-manual.html#dx1-4167" >2617</a>, <a
-href="glossaries-extra-manual.html#dx1-4173" >2618</a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\writemultiglossentry</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-69011" ><span
-class="cmti-10">2619</span></a> <br /></span>
-</p><p class="theindex"> <span
-class="cmbx-10">X</span>
-<span class="index-item"><span
-class="cmss-10">xfor </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-8" >2620</a>, <a
-href="glossaries-extra-manual.html#dx1-69005" >2621</a>, <a
-href="glossaries-extra-manual.html#dx1-86076" >2622</a>, <a
-href="glossaries-extra-manual.html#dx1-86078" >2623</a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\xglssetwidest</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22068" ><span
-class="cmti-10">2624</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\xglsupdatewidest</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-22072" ><span
-class="cmti-10">2625</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\xGlsXtrIfValueInFieldCsvList</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86046" ><span
-class="cmti-10">2626</span></a> <br /></span>
-<span class="index-item"><span class="obeylines-h"><span class="verb"><span
-class="cmtt-10">\xGlsXtrSetField</span></span></span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-86028" ><span
-class="cmti-10">2627</span></a> <br /></span>
-<span class="index-item"><span
-class="cmtt-10">xindy</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-3030" >2628</a>, <a
-href="glossaries-extra-manual.html#dx1-4012" >2629</a>, <a
-href="glossaries-extra-manual.html#dx1-4108" >2630</a>, <a
-href="glossaries-extra-manual.html#dx1-4110" >2631</a>, <a
-href="glossaries-extra-manual.html#dx1-4118" >2632</a>, <a
-href="glossaries-extra-manual.html#dx1-4124" >2633</a>, <a
-href="glossaries-extra-manual.html#dx1-4131" >2634</a>, <a
-href="glossaries-extra-manual.html#dx1-4149" >2635</a>, <a
-href="glossaries-extra-manual.html#dx1-4166" >2636</a>, <a
-href="glossaries-extra-manual.html#dx1-4168" >2637</a>, <a
-href="glossaries-extra-manual.html#dx1-4196" >2638</a>, <a
-href="glossaries-extra-manual.html#dx1-4211" >2639</a>, <a
-href="glossaries-extra-manual.html#dx1-75005" >2640</a>, <a
-href="glossaries-extra-manual.html#dx1-76012" >2641</a>, <a
-href="glossaries-extra-manual.html#dx1-79007" >2642</a>, <a
-href="glossaries-extra-manual.html#dx1-81006" >2643</a>, <a
-href="glossaries-extra-manual.html#dx1-99002" >2644</a>, <a
-href="glossaries-extra-manual.html#dx1-99027" >2645</a>, <a
-href="glossaries-extra-manual.html#dx1-99031" >2646</a>, <a
-href="glossaries-extra-manual.html#dx1-99037" ><span
-class="cmbx-10">2647</span></a> <br /></span>
-<span class="index-item"><span
-class="cmtt-10">xindy</span>&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-7056" >2648</a> <br /></span>
-<span class="index-item"><span
-class="cmss-10">xkeyval </span>package&#x00A0;&#x00A0;<a
-href="glossaries-extra-manual.html#dx1-6" >2649</a> <br /></span>
-
-
-
-</p></div>
- <a
- id="dx1-100001"></a><div class="footnotes"><!--l. 329--><p class="indent" > <span class="footnote-mark"><a
-href="#fn1x1-bk" id="fn1x1"><sup class="textsuperscript">1.1</sup></a></span><span
-class="cmr-8">4.21 was originally intended as the last release of </span><span
-class="cmss-8">glossaries </span><span
-class="cmr-8">to incorporate new features, but</span>
-<span
-class="cmr-8">a few new minor features slipped in with some bug fixes in v4.21.</span></p>
-<!--l. 1399--><p class="indent" > <span class="footnote-mark"><a
-href="#fn1x2-bk" id="fn1x2"><sup class="textsuperscript">2.1</sup></a></span><span
-class="cmr-8">The </span><span
-class="cmss-8">descriptionplural</span><a
- id="dx1-6023"></a> <span
-class="cmr-8">key is a throwback to the base package&#8217;s original acronym mechanism</span>
-<span
-class="cmr-8">before the introduction of the </span><span
-class="cmss-8">long</span><a
- id="dx1-6024"></a> <span
-class="cmr-8">and </span><span
-class="cmss-8">short</span><a
- id="dx1-6025"></a> <span
-class="cmr-8">keys, where the long form was stored in the </span><span
-class="cmss-8">description</span><a
- id="dx1-6026"></a>
-<span
-class="cmr-8">field and the short form was stored in the </span><span
-class="cmss-8">symbol</span><a
- id="dx1-6027"></a> <span
-class="cmr-8">field.</span></p>
-<!--l. 5595--><p class="indent" > <span class="footnote-mark"><a
-href="#fn1x4-bk" id="fn1x4"><sup class="textsuperscript">4.1</sup></a></span><span
-class="cmr-8">For compatibility with earlier versions, </span><span
-class="cmtt-8">\glsabbrvscfont </span><span
-class="cmr-8">is defined to </span><span
-class="cmtt-8">\glsxtrscfont</span><span
-class="cmr-8">, which</span>
-<span
-class="cmr-8">is defined to use </span><span
-class="cmtt-8">\textsc</span><span
-class="cmr-8">. Direct use of </span><span
-class="cmtt-8">\glsxtrscfont </span><span
-class="cmr-8">is now deprecated. Likewise for similar</span>
-<span
-class="cmr-8">commands.</span></p>
-<!--l. 11504--><p class="indent" > <span class="footnote-mark"><a
-href="#fn1x10-bk" id="fn1x10"><sup class="textsuperscript">10.1</sup></a></span><span
-class="cmr-8">Version 1.11 only allowed one use of </span><span
-class="cmtt-8">\GlsXtrLoadResources </span><span
-class="cmr-8">per document.</span></p>
-<!--l. 11524--><p class="indent" > <span class="footnote-mark"><a
-href="#fn2x10-bk" id="fn2x10"><sup class="textsuperscript">10.2</sup></a></span><span
-class="cmr-8">v1.08 assumed </span>&#x27E8;<span
-class="cmti-8">filename</span>&#x27E9;<span
-class="cmtt-8">.tex </span><span
-class="cmr-8">but that&#8217;s potentially dangerous if, for example, </span>&#x27E8;<span
-class="cmti-8">filename</span>&#x27E9;
-<span
-class="cmr-8">happens to be the same as </span><span
-class="cmtt-8">\jobname</span><span
-class="cmr-8">. The </span><span
-class="cmtt-8">.glstex </span><span
-class="cmr-8">extension was enforced by version</span>
-<span
-class="cmr-8">1.11.</span></p>
-<!--l. 13580--><p class="indent" > <span class="footnote-mark"><a
-href="#fn1x11-bk" id="fn1x11"><sup class="textsuperscript">11.1</sup></a></span><span
-class="cmr-8">Pre version 1.28 used </span><span
-class="cmtt-8">\csedef</span><span
-class="cmr-8">.</span></p> </div>
+</pre><p>
+If the value of the attribute is <span class="qt">“true”</span>, no encap will be added, otherwise the encap will be the attribute value. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.14057"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{<a id="wrglossary.14058"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>}{<a id="wrglossary.14059"></a><a href="#glo:opt.catattr.indexname"><span class="csoptfmt">indexname</span></a>}{textbf}
+</pre> will set the encap to <code class="code">textbf</code> which will display the relevant page number in bold whereas <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.14060"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a>{<a id="wrglossary.14061"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a>}{<a id="wrglossary.14062"></a><a href="#glo:opt.catattr.dualindex"><span class="csoptfmt">dualindex</span></a>}{true}
+</pre> won’t apply any formatting to the page number in the index.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The location used in the index will always be the page number not the counter used in the glossary. (Unless some other loaded package has modified the definition of <a id="wrglossary.14063"></a><a href="#glo:index"><code class="csfmt">\index</code></a> to use some thing else.) </div><!-- end of important -->
+<p>
+By default the <a id="wrglossary.14064"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a> key won’t be used with the <a id="wrglossary.14065"></a><a href="#glo:opt.catattr.dualindex"><span class="csoptfmt">dualindex</span></a> attribute. You can allow the <a id="wrglossary.14066"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a> key to override the attribute value by using the preamble-only command: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14067"></a><code class="code"><dfn id="glo:GlsXtrEnableIndexFormatOverride"><code class="csfmt">\GlsXtrEnableIndexFormatOverride</code></dfn></code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ If you use this command and <a id="wrglossary.14068"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> has been loaded, then the <a id="wrglossary.14069"></a><a href="#glo:env.theindex"><span class="envfmt">theindex</span></a> environment will be modified to redefine <a id="wrglossary.14070"></a><a href="#glo:glshypernumber"><code class="csfmt">\glshypernumber</code></a> to allow formats that use that command.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The <a id="wrglossary.14071"></a><a href="#glo:opt.catattr.dualindex"><span class="csoptfmt">dualindex</span></a> attribute will still be used on subsequent use even if the <a id="wrglossary.14072"></a><a href="#glo:opt.catattr.indexonlyfirst"><span class="csoptfmt">indexonlyfirst</span></a> attribute (or <a id="wrglossary.14073"></a><a href="#glo:opt.indexonlyfirst"><span class="styoptfmt">indexonlyfirst</span></a> package option) is set. However, the <a id="wrglossary.14074"></a><a href="#glo:opt.catattr.dualindex"><span class="csoptfmt">dualindex</span></a> attribute will honour the <a id="wrglossary.14075"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a> key. </div><!-- end of important -->
+<p>
+The <a id="wrglossary.14076"></a><a href="#glo:glsxtrdoautoindexname"><code class="csfmt">\glsxtrdoautoindexname</code></a> command will attempt to escape any of <a id="wrglossary.14077"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>’s special characters, but there may be special cases where it fails, so take care. This assumes the default <a id="wrglossary.14078"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> actual, level, quote and encap values (unless any of the commands <a id="wrglossary.14079"></a><a href="#glo:actualchar"><code class="csfmt">\actualchar</code></a>, <a id="wrglossary.14080"></a><a href="#glo:levelchar"><code class="csfmt">\levelchar</code></a>, <a id="wrglossary.14081"></a><a href="#glo:quotechar"><code class="csfmt">\quotechar</code></a> or <a id="wrglossary.14082"></a><a href="#glo:encapchar"><code class="csfmt">\encapchar</code></a> have been defined before <a id="wrglossary.14083"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> is loaded).<p>
+If this isn’t the case, you can use the following preamble-only commands to set the correct characters. <div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Be very careful of possible shifting category codes! </div><!-- end of important -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14084"></a><code class="code"><dfn id="glo:GlsXtrSetActualChar"><code class="csfmt">\GlsXtrSetActualChar</code></dfn>{<span class="meta">〈<em class="metainner">character</em>〉</span>}</code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ Set the actual character to <span class="meta">〈<em class="metainner">char</em>〉</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14085"></a><code class="code"><dfn id="glo:GlsXtrSetLevelChar"><code class="csfmt">\GlsXtrSetLevelChar</code></dfn>{<span class="meta">〈<em class="metainner">character</em>〉</span>}</code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ Set the level character to <span class="meta">〈<em class="metainner">char</em>〉</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14086"></a><code class="code"><dfn id="glo:GlsXtrSetEscChar"><code class="csfmt">\GlsXtrSetEscChar</code></dfn>{<span class="meta">〈<em class="metainner">character</em>〉</span>}</code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ Set the escape (quote) character to <span class="meta">〈<em class="metainner">char</em>〉</span>.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14087"></a><code class="code"><dfn id="glo:GlsXtrSetEncapChar"><code class="csfmt">\GlsXtrSetEncapChar</code></dfn>{<span class="meta">〈<em class="metainner">character</em>〉</span>}</code><p>
+<div class="noteBox"></div><!-- end of noteBox -->
+</div><!-- end of pinnedbox -->
+ Set the encap character to <span class="meta">〈<em class="metainner">char</em>〉</span>.<p>
+
+</section><!-- end of section sec:autoindex -->
+
+<section id="sec:onthefly"><!-- start of section sec:onthefly --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->13. On-the-Fly Document Definitions<div class="labellink"><a href="#sec:onthefly">[link]</a></div></h1><!-- end of chapter header -->
+<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The commands described here may superficially look like <code class="code"><span class="meta">〈<em class="metainner">word</em>〉</span><a id="wrglossary.14088"></a><a href="#glo:index"><code class="csfmt">\index</code></a>{<span class="meta">〈<em class="metainner">word</em>〉</span>}</code>, but they behave rather differently. If you want to use <a id="wrglossary.14089"></a><a href="#glo:index"><code class="csfmt">\index</code></a> then just use <a id="wrglossary.14090"></a><a href="#glo:index"><code class="csfmt">\index</code></a>. </div><!-- end of important -->
+<p>
+The base <a id="wrglossary.14091"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package advises against defining entries in the <a id="wrglossary.14092"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment. As mentioned in §<a href="#sec:refindexopts">2.4</a>, this ability is disabled by default with <a id="wrglossary.14093"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> but can be enabled using the <a id="wrglossary.14094"></a><a href="#glo:opt.docdef"><span class="styoptfmt">docdef</span></a> package options.<p>
+Although this can be problematic, the <a id="wrglossary.14095"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides a way of defining and using entries within the <a id="wrglossary.14096"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment without the tricks used with the <a id="wrglossary.14097"></a><a href="#glo:opt.docdef"><span class="styoptfmt">docdef</span></a> option. <span style="font-style: italic; font-variant: normal; ">There are limitations with this approach, so take care with it.</span> This function is disabled by default, but can be enabled using the preamble-only command: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14098"></a><code class="code"><dfn id="glo:GlsXtrEnableOnTheFly"><code class="csfmt">\GlsXtrEnableOnTheFly</code></dfn></code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ When used, this defines the commands described below. The starred version was provided to help support <a id="wrglossary.14099"></a><a href="#glo:dual.utf8">UTF-8</a> with <a id="wrglossary.14100"></a><a href="#glo:pkg.inputenc"><span class="styfmt">inputenc</span></a>. Recent versions of the LaTeX kernel now provide better support. Both <a id="wrglossary.14101"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> and <a id="wrglossary.14102"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> have been updated to help integrate the new kernel features, so the unstarred version may also work with <a id="wrglossary.14103"></a><a href="#glo:dual.utf8">UTF-8</a>.<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+If you use the starred version of <a id="wrglossary.14104"></a><a href="#glo:GlsXtrEnableOnTheFly"><code class="csfmt">\GlsXtrEnableOnTheFly</code></a> don’t use any commands in the <span class="meta">〈<em class="metainner">label</em>〉</span>, even if they expand to just text. </div><!-- end of warning -->
+<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14105"></a><code class="code"><dfn id="glo:glsxtr"><code class="csfmt">\glsxtr</code></dfn>[<span class="meta">〈<em class="metainner">gls-options</em>〉</span>][<span class="meta">〈<em class="metainner">dfn-options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If an entry with the label <span class="meta">〈<em class="metainner">entry-label</em>〉</span> has already been defined, this just does <code class="code"><a id="wrglossary.14106"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<span class="meta">〈<em class="metainner">gls-options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>. If <span class="meta">〈<em class="metainner">entry-label</em>〉</span> hasn’t been defined, this will define the entry using: <pre class="compactcodebox"><a id="wrglossary.14107"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<a id="wrglossary.14108"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={entry-label}</span>,
+ <a id="wrglossary.14109"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="optfmt">={<a id="wrglossary.14110"></a><a href="#glo:glsxtrcat"><code class="csfmt">\glsxtrcat</code></a>}</span>,
+ <a id="wrglossary.14111"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={<a id="wrglossary.14112"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>}</span>,
+ <span class="meta">〈<em class="metainner">dfn-options</em>〉</span>}
+</pre><p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The <span class="meta">〈<em class="metainner">label</em>〉</span> must contain any non-expandable commands, such as formatting commands or problematic characters. If the term requires any of these, they must be omitted from the <span class="meta">〈<em class="metainner">entry-label</em>〉</span> and placed in the <a id="wrglossary.14113"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key within the optional argument <span class="meta">〈<em class="metainner">dfn-options</em>〉</span>. </div><!-- end of important -->
+<p>
+The second optional argument <span class="meta">〈<em class="metainner">dfn-options</em>〉</span> should be empty if the entry has already been defined, since it’s too late for them. If it’s not empty, a warning will be generated with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14114"></a><code class="code"><dfn id="glo:GlsXtrWarning"><code class="csfmt">\GlsXtrWarning</code></dfn>{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ For example, this warning will be generated on the second instance of <a id="wrglossary.14115"></a><a href="#glo:glsxtr"><code class="csfmt">\glsxtr</code></a> below: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.14116"></a><a href="#glo:glsxtr"><code class="csfmt">\glsxtr</code></a>[][<a id="wrglossary.14117"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a>geese]{goose}
+<span class="comment">% ... later</span>
+<a id="wrglossary.14118"></a><a href="#glo:glsxtr"><code class="csfmt">\glsxtr</code></a>[][<a id="wrglossary.14119"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a>geese]{goose}
+</pre><p>
+If you are considering doing something like: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<code class="cmd">\goose</code>}{<a id="wrglossary.14120"></a><a href="#glo:glsxtr"><code class="csfmt">\glsxtr</code></a>[][<a id="wrglossary.14121"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a><span class="optfmt">={geese}</span>]{goose}}
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.14122"></a><a href="#glo:GlsXtrWarning"><code class="csfmt">\GlsXtrWarning</code></a>}[2]{}
+<span class="comment">% ... later</span>
+<code class="cmd">\goose</code><code class="cmd">\ </code>some more text here
+</pre> then don’t bother. It’s simpler and less problematic to just define the entries in the preamble with <a id="wrglossary.14123"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> and then use <a id="wrglossary.14124"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> in the document.<p>
+There are also plural and case-changing alternatives to <a id="wrglossary.14125"></a><a href="#glo:glsxtr"><code class="csfmt">\glsxtr</code></a>. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14126"></a><code class="code"><dfn id="glo:glsxtrpl"><code class="csfmt">\glsxtrpl</code></dfn>[<span class="meta">〈<em class="metainner">gls-options</em>〉</span>][<span class="meta">〈<em class="metainner">dfn-options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.14127"></a><a href="#glo:glsxtr"><code class="csfmt">\glsxtr</code></a> but uses <a id="wrglossary.14128"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> instead of <a id="wrglossary.14129"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14130"></a><code class="code"><dfn id="glo:Glsxtr"><code class="csfmt">\Glsxtr</code></dfn>[<span class="meta">〈<em class="metainner">gls-options</em>〉</span>][<span class="meta">〈<em class="metainner">dfn-options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.14131"></a><a href="#glo:glsxtr"><code class="csfmt">\glsxtr</code></a> but uses <a id="wrglossary.14132"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> instead of <a id="wrglossary.14133"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14134"></a><code class="code"><dfn id="glo:Glsxtrpl"><code class="csfmt">\Glsxtrpl</code></dfn>[<span class="meta">〈<em class="metainner">gls-options</em>〉</span>][<span class="meta">〈<em class="metainner">dfn-options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is like <a id="wrglossary.14135"></a><a href="#glo:glsxtr"><code class="csfmt">\glsxtr</code></a> but uses <a id="wrglossary.14136"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a> instead of <a id="wrglossary.14137"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>.<p>
+The category is set to: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14138"></a><code class="code"><dfn id="glo:glsxtrcat"><code class="csfmt">\glsxtrcat</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>general</span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This should simply expand to the required category label. The default definition is <code class="code">general</code>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The commands <a id="wrglossary.14139"></a><a href="#glo:glsxtr"><code class="csfmt">\glsxtr</code></a>, <a id="wrglossary.14140"></a><a href="#glo:glsxtrpl"><code class="csfmt">\glsxtrpl</code></a>, <a id="wrglossary.14141"></a><a href="#glo:Glsxtr"><code class="csfmt">\Glsxtr</code></a> and <a id="wrglossary.14142"></a><a href="#glo:Glsxtrpl"><code class="csfmt">\Glsxtrpl</code></a> can’t be used after the <a id="wrglossary.14143"></a><a href="#glo:dual.glossary">glossaries</a> have been displayed (through <a id="wrglossary.14144"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> etc). It’s best not to mix these commands with the standard glossary commands, such as <a id="wrglossary.14145"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or there may be unexpected results. </div><!-- end of important -->
+<p>
+
+</section><!-- end of section sec:onthefly -->
+
+<section id="sec:extrafiles"><!-- start of section sec:extrafiles --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->14. Supplementary Files<div class="labellink"><a href="#sec:extrafiles">[link]</a></div></h1><!-- end of chapter header -->
+<p>
+The <a id="wrglossary.14146"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package comes with some additional files. Those listed in §<a href="#sec:exampleglossariesfiles">14.1</a> provide dummy entries for testing various styles. They should be placed on TeX’s path.<p>
+There are also some sample files listed in §<a href="#sec:samples">14.2</a>. These should be located in the package documentation directory.<p>
+
+</section><!-- end of section sec:extrafiles -->
+
+<section id="sec:exampleglossariesfiles"><!-- start of section sec:exampleglossariesfiles --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->14.1. Dummy Files for Testing<div class="labellink"><a href="#sec:exampleglossariesfiles">[link]</a></div></h2><!-- end of section header -->
+<p>
+The base <a id="wrglossary.14147"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package provides files with dummy entries for testing. The <a id="wrglossary.14148"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides an additional file with entries.<p>
+<div class="filedef">🗋<a href="samples/example-glossaries-xr.tex">📥</a> <a id="wrglossary.14149"></a><dfn id="glo:file.example-glossaries-xr.tex"><span class="filefmt">example-glossaries-xr.tex</span></dfn></div><!-- end of filedef -->
+ This file contains entries that have the <a id="wrglossary.14150"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a>, <a id="wrglossary.14151"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> or <a id="wrglossary.14152"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> keys set.<p>
+There are also <a id="wrglossary.14153"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files corresponding to all the available <a id="wrglossary.14154"></a><a href="#glo:ext.tex"><span class="extfmt">tex</span></a> files for use with <a id="wrglossary.14155"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>.<p>
+<div class="filedef">🗋<a href="samples/example-glossaries-acronym.bib">📥</a> <a id="wrglossary.14156"></a><dfn id="glo:file.example-glossaries-acronym.bib"><span class="filefmt">example-glossaries-acronym.bib</span></dfn></div><!-- end of filedef -->
+ Corresponds to <span class="filefmt">example-glossaries-acronym.tex</span> <div class="filedef">🗋<a href="samples/example-glossaries-acronym-desc.bib">📥</a> <a id="wrglossary.14157"></a><dfn id="glo:file.example-glossaries-acronym-desc.bib"><span class="filefmt">example-glossaries-acronym-desc.bib</span></dfn></div><!-- end of filedef -->
+ Corresponds to <span class="filefmt">example-glossaries-acronym-desc.tex</span> <div class="filedef">🗋<a href="samples/example-glossaries-acronyms-lang.bib">📥</a> <a id="wrglossary.14158"></a><dfn id="glo:file.example-glossaries-acronyms-lang.bib"><span class="filefmt">example-glossaries-acronyms-lang.bib</span></dfn></div><!-- end of filedef -->
+ Corresponds to <span class="filefmt">example-glossaries-acronyms-lang.tex</span> <div class="filedef">🗋<a href="samples/example-glossaries-brief.bib">📥</a> <a id="wrglossary.14159"></a><dfn id="glo:file.example-glossaries-brief.bib"><span class="filefmt">example-glossaries-brief.bib</span></dfn></div><!-- end of filedef -->
+ Corresponds to <span class="filefmt">example-glossaries-brief.tex</span> <div class="filedef">🗋<a href="samples/example-glossaries-childmultipar.bib">📥</a> <a id="wrglossary.14160"></a><dfn id="glo:file.example-glossaries-childmultipar.bib"><span class="filefmt">example-glossaries-childmultipar.bib</span></dfn></div><!-- end of filedef -->
+ Corresponds to <span class="filefmt">example-glossaries-childmultipar.tex</span> <div class="filedef">🗋<a href="samples/example-glossaries-childnoname.bib">📥</a> <a id="wrglossary.14161"></a><dfn id="glo:file.example-glossaries-childnoname.bib"><span class="filefmt">example-glossaries-childnoname.bib</span></dfn></div><!-- end of filedef -->
+ Corresponds to <span class="filefmt">example-glossaries-childnoname.tex</span> <div class="filedef">🗋<a href="samples/example-glossaries-cite.bib">📥</a> <a id="wrglossary.14162"></a><dfn id="glo:file.example-glossaries-cite.bib"><span class="filefmt">example-glossaries-cite.bib</span></dfn></div><!-- end of filedef -->
+ Corresponds to <span class="filefmt">example-glossaries-cite.tex</span> <div class="filedef">🗋<a href="samples/example-glossaries-images.bib">📥</a> <a id="wrglossary.14163"></a><dfn id="glo:file.example-glossaries-images.bib"><span class="filefmt">example-glossaries-images.bib</span></dfn></div><!-- end of filedef -->
+ Corresponds to <span class="filefmt">example-glossaries-images.tex</span> <div class="filedef">🗋<a href="samples/example-glossaries-long.bib">📥</a> <a id="wrglossary.14164"></a><dfn id="glo:file.example-glossaries-long.bib"><span class="filefmt">example-glossaries-long.bib</span></dfn></div><!-- end of filedef -->
+ Corresponds to <span class="filefmt">example-glossaries-long.tex</span> <div class="filedef">🗋<a href="samples/example-glossaries-longchild.bib">📥</a> <a id="wrglossary.14165"></a><dfn id="glo:file.example-glossaries-longchild.bib"><span class="filefmt">example-glossaries-longchild.bib</span></dfn></div><!-- end of filedef -->
+ Corresponds to <span class="filefmt">example-glossaries-longchild.tex</span> <div class="filedef">🗋<a href="samples/example-glossaries-multipar.bib">📥</a> <a id="wrglossary.14166"></a><dfn id="glo:file.example-glossaries-multipar.bib"><span class="filefmt">example-glossaries-multipar.bib</span></dfn></div><!-- end of filedef -->
+ Corresponds to <span class="filefmt">example-glossaries-multipar.tex</span> <div class="filedef">🗋<a href="samples/example-glossaries-parent.bib">📥</a> <a id="wrglossary.14167"></a><dfn id="glo:file.example-glossaries-parent.bib"><span class="filefmt">example-glossaries-parent.bib</span></dfn></div><!-- end of filedef -->
+ Corresponds to <span class="filefmt">example-glossaries-parent.tex</span> <div class="filedef">🗋<a href="samples/example-glossaries-symbolnames.bib">📥</a> <a id="wrglossary.14168"></a><dfn id="glo:file.example-glossaries-symbolnames.bib"><span class="filefmt">example-glossaries-symbolnames.bib</span></dfn></div><!-- end of filedef -->
+ Corresponds to <span class="filefmt">example-glossaries-symbolnames.tex</span> <div class="filedef">🗋<a href="samples/example-glossaries-symbols.bib">📥</a> <a id="wrglossary.14169"></a><dfn id="glo:file.example-glossaries-symbols.bib"><span class="filefmt">example-glossaries-symbols.bib</span></dfn></div><!-- end of filedef -->
+ Corresponds to <span class="filefmt">example-glossaries-symbols.tex</span> <div class="filedef">🗋<a href="samples/example-glossaries-url.bib">📥</a> <a id="wrglossary.14170"></a><dfn id="glo:file.example-glossaries-url.bib"><span class="filefmt">example-glossaries-url.bib</span></dfn></div><!-- end of filedef -->
+ Corresponds to <span class="filefmt">example-glossaries-url.tex</span> <div class="filedef">🗋<a href="samples/example-glossaries-xr.bib">📥</a> <a id="wrglossary.14171"></a><dfn id="glo:file.example-glossaries-xr.bib"><span class="filefmt">example-glossaries-xr.bib</span></dfn></div><!-- end of filedef -->
+ Corresponds to <span class="filefmt">example-glossaries-xr.tex</span><p>
+
+</section><!-- end of section sec:exampleglossariesfiles -->
+
+<section id="sec:samples"><!-- start of section sec:samples --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->14.2. Sample Files<div class="labellink"><a href="#sec:samples">[link]</a></div></h2><!-- end of section header -->
+<p>
+The <a id="wrglossary.14172"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package comes with some sample files that are listed below. There are also sample files provided with the <a id="wrglossary.14173"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package and with <a id="wrglossary.14174"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. See also the <a href="https://www.dickimaw-books.com/gallery">Dickimaw Books Gallery</a>.<p>
+<div class="filedef">🗋<a href="samples/sample.tex">📥</a> <a id="wrglossary.14175"></a><dfn id="glo:file.sample.tex"><span class="filefmt">sample.tex</span></dfn></div><!-- end of filedef -->
+ Simple sample file that uses one of the dummy files provided by the <a id="wrglossary.14176"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package for testing. <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample
+makeglossaries sample
+pdflatex sample
+pdflatex sample
+</pre><p>
+<div class="filedef">🗋<a href="samples/sample-abbr-styles.tex">📥</a> <a id="wrglossary.14177"></a><dfn id="glo:file.sample-abbr-styles.tex"><span class="filefmt">sample-abbr-styles.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-abbr-styles
+makeglossaries sample-abbr-styles
+pdflatex sample-abbr-styles
+pdflatex sample-abbr-styles
+</pre> Demonstrates all predefined abbreviation styles.<p>
+<div class="filedef">🗋<a href="samples/sample-mixture.tex">📥</a> <a id="wrglossary.14178"></a><dfn id="glo:file.sample-mixture.tex"><span class="filefmt">sample-mixture.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-mixture
+makeglossaries sample-mixture
+pdflatex sample-mixture
+makeglossaries sample-mixture
+pdflatex sample-mixture
+</pre> General entries, acronyms and initialisms all treated differently.<p>
+<div class="filedef">🗋<a href="samples/sample-name-font.tex">📥</a> <a id="wrglossary.14179"></a><dfn id="glo:file.sample-name-font.tex"><span class="filefmt">sample-name-font.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-name-font
+makeglossaries sample-name-font
+pdflatex sample-name-font
+pdflatex sample-name-font
+</pre> Categories and attributes are used to customize the way different entries appear.<p>
+<div class="filedef">🗋<a href="samples/sample-abbrv.tex">📥</a> <a id="wrglossary.14180"></a><dfn id="glo:file.sample-abbrv.tex"><span class="filefmt">sample-abbrv.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-abbrv
+makeglossaries sample-abbrv
+pdflatex sample-abbrv
+pdflatex sample-abbrv
+</pre> General abbreviations.<p>
+<div class="filedef">🗋<a href="samples/sample-acronym.tex">📥</a> <a id="wrglossary.14181"></a><dfn id="glo:file.sample-acronym.tex"><span class="filefmt">sample-acronym.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-acronym
+makeglossaries sample-acronym
+pdflatex sample-acronym
+</pre> Acronyms aren’t initialisms and don’t expand on <a id="wrglossary.14182"></a><a href="#glo:dual.firstuse">first use</a>.<p>
+<div class="filedef">🗋<a href="samples/sample-acronym-desc.tex">📥</a> <a id="wrglossary.14183"></a><dfn id="glo:file.sample-acronym-desc.tex"><span class="filefmt">sample-acronym-desc.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-acronym-desc
+makeglossaries sample-acronym-desc
+pdflatex sample-acronym-desc
+makeglossaries sample-acronym-desc
+pdflatex sample-acronym-desc
+</pre> Acronyms that have a separate long form and description.<p>
+<div class="filedef">🗋<a href="samples/sample-crossref.tex">📥</a> <a id="wrglossary.14184"></a><dfn id="glo:file.sample-crossref.tex"><span class="filefmt">sample-crossref.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-crossref
+makeglossaries sample-crossref
+pdflatex sample-crossref
+</pre> Unused entries that have been cross-referenced automatically are added at the end of the document.<p>
+<div class="filedef">🗋<a href="samples/sample-indexhook.tex">📥</a> <a id="wrglossary.14185"></a><dfn id="glo:file.sample-indexhook.tex"><span class="filefmt">sample-indexhook.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-indexhook
+makeglossaries sample-indexhook
+pdflatex sample-indexhook
+</pre> Use the index hook to track which entries have been indexed (and therefore find out which ones haven’t been indexed).<p>
+<div class="filedef">🗋<a href="samples/sample-footnote.tex">📥</a> <a id="wrglossary.14186"></a><dfn id="glo:file.sample-footnote.tex"><span class="filefmt">sample-footnote.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-footnote
+makeglossaries sample-footnote
+pdflatex sample-footnote
+</pre> Footnote abbreviation style that moves the footnote marker outside of the hyperlink generated by <a id="wrglossary.14187"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> and moves it after certain punctuation characters for neatness.<p>
+<div class="filedef">🗋<a href="samples/sample-undef.tex">📥</a> <a id="wrglossary.14188"></a><dfn id="glo:file.sample-undef.tex"><span class="filefmt">sample-undef.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-undef
+makeglossaries sample-undef
+pdflatex sample-undef
+pdflatex sample-undef
+</pre> Warn on undefined entries instead of generating an error.<p>
+<div class="filedef">🗋<a href="samples/sample-mixed-abbrv-styles.tex">📥</a> <a id="wrglossary.14189"></a><dfn id="glo:file.sample-mixed-abbrv-styles.tex"><span class="filefmt">sample-mixed-abbrv-styles.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-mixed-abbrv-styles
+makeglossaries sample-mixed-abbrv-styles
+pdflatex sample-mixed-abbrv-styles
+</pre> Different abbreviation styles for different entries.<p>
+<div class="filedef">🗋<a href="samples/sample-initialisms.tex">📥</a> <a id="wrglossary.14190"></a><dfn id="glo:file.sample-initialisms.tex"><span class="filefmt">sample-initialisms.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-initialisms
+makeglossaries sample-initialisms
+pdflatex sample-initialisms
+</pre> Automatically insert dots into initialisms.<p>
+<div class="filedef">🗋<a href="samples/sample-postdot.tex">📥</a> <a id="wrglossary.14191"></a><dfn id="glo:file.sample-postdot.tex"><span class="filefmt">sample-postdot.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-postdot
+makeglossaries sample-postdot
+pdflatex sample-postdot
+</pre> Another initialisms example.<p>
+<div class="filedef">🗋<a href="samples/sample-postlink.tex">📥</a> <a id="wrglossary.14192"></a><dfn id="glo:file.sample-postlink.tex"><span class="filefmt">sample-postlink.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-postlink
+makeglossaries sample-postlink
+pdflatex sample-postlink
+</pre> Automatically inserting text after the <a id="wrglossary.14193"></a><a href="#glo:dual.linktext">link text</a> produced by commands like <a id="wrglossary.14194"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> (outside of hyperlink, if present).<p>
+<div class="filedef">🗋<a href="samples/sample-header.tex">📥</a> <a id="wrglossary.14195"></a><dfn id="glo:file.sample-header.tex"><span class="filefmt">sample-header.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-header
+makeglossaries sample-header
+pdflatex sample-header
+pdflatex sample-header
+</pre> Using entries in section/chapter headings.<p>
+<div class="filedef">🗋<a href="samples/sample-autoindex.tex">📥</a> <a id="wrglossary.14196"></a><dfn id="glo:file.sample-autoindex.tex"><span class="filefmt">sample-autoindex.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-autoindex
+makeglossaries sample-autoindex
+pdflatex sample-autoindex
+makeindex sample-autoindex
+pdflatex sample-autoindex
+</pre> Using the <a id="wrglossary.14197"></a><a href="#glo:opt.catattr.dualindex"><span class="csoptfmt">dualindex</span></a> and <a id="wrglossary.14198"></a><a href="#glo:opt.catattr.indexname"><span class="csoptfmt">indexname</span></a> attributes to automatically add glossary entries to the index (in addition to the glossary <a id="wrglossary.14199"></a><a href="#glo:dual.locationlist">location list</a>).<p>
+<div class="filedef">🗋<a href="samples/sample-autoindex-hyp.tex">📥</a> <a id="wrglossary.14200"></a><dfn id="glo:file.sample-autoindex-hyp.tex"><span class="filefmt">sample-autoindex-hyp.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-autoindex-hyp
+makeglossaries sample-autoindex-hyp
+pdflatex sample-autoindex-hyp
+makeindex sample-autoindex-hyp
+pdflatex sample-autoindex-hyp
+</pre> As previous but uses <a id="wrglossary.14201"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>.<p>
+<div class="filedef">🗋<a href="samples/sample-nested.tex">📥</a> <a id="wrglossary.14202"></a><dfn id="glo:file.sample-nested.tex"><span class="filefmt">sample-nested.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-nested
+makeglossaries sample-nested
+pdflatex sample-nested
+</pre> Using <a id="wrglossary.14203"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> within the value of the <a id="wrglossary.14204"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key.<p>
+<div class="filedef">🗋<a href="samples/sample-entrycount.tex">📥</a> <a id="wrglossary.14205"></a><dfn id="glo:file.sample-entrycount.tex"><span class="filefmt">sample-entrycount.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-entrycount
+pdflatex sample-entrycount
+makeglossaries sample-entrycount
+pdflatex sample-entrycount
+</pre> Enable entry-use counting (only index if used more than n times, see §<a href="#sec:entrycount">6.1</a>).<p>
+<div class="filedef">🗋<a href="samples/sample-unitentrycount.tex">📥</a> <a id="wrglossary.14206"></a><dfn id="glo:file.sample-unitentrycount.tex"><span class="filefmt">sample-unitentrycount.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-unitentrycount
+pdflatex sample-unitentrycount
+makeglossaries sample-unitentrycount
+pdflatex sample-unitentrycount
+</pre> Enable use of per-unit entry-use counting (§<a href="#sec:entrycount">6.1</a>).<p>
+<div class="filedef">🗋<a href="samples/sample-onelink.tex">📥</a> <a id="wrglossary.14207"></a><dfn id="glo:file.sample-onelink.tex"><span class="filefmt">sample-onelink.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-onelink
+makeglossaries sample-onelink
+pdflatex sample-onelink
+</pre> Using the per-unit entry counting (§<a href="#sec:entrycount">6.1</a>) to only have one hyperlink per entry per page.<p>
+<div class="filedef">🗋<a href="samples/sample-linkcount.tex">📥</a> <a id="wrglossary.14208"></a><dfn id="glo:file.sample-linkcount.tex"><span class="filefmt">sample-linkcount.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-linkcount
+makeglossaries sample-linkcount
+pdflatex sample-linkcount
+</pre> Using link counting (§<a href="#sec:linkcount">6.2</a>) to only have one hyperlink per entry.<p>
+<div class="filedef">🗋<a href="samples/sample-pages.tex">📥</a> <a id="wrglossary.14209"></a><dfn id="glo:file.sample-pages.tex"><span class="filefmt">sample-pages.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-pages
+makeglossaries sample-pages
+pdflatex sample-pages
+pdflatex sample-pages
+</pre> Insert <span class="qt">“page”</span> or <span class="qt">“pages”</span> before the <a id="wrglossary.14210"></a><a href="#glo:dual.locationlist">location list</a>.<p>
+<div class="filedef">🗋<a href="samples/sample-altmodifier.tex">📥</a> <a id="wrglossary.14211"></a><dfn id="glo:file.sample-altmodifier.tex"><span class="filefmt">sample-altmodifier.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-altmodifier
+makeglossaries sample-altmodifier
+pdflatex sample-altmodifier
+pdflatex sample-altmodifier
+</pre> Set the default options for commands like <a id="wrglossary.14212"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> and add an alternative modifier.<p>
+<div class="filedef">🗋<a href="samples/sample-mixedsort.tex">📥</a> <a id="wrglossary.14213"></a><dfn id="glo:file.sample-mixedsort.tex"><span class="filefmt">sample-mixedsort.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-mixedsort
+pdflatex sample-mixedsort
+</pre> Uses the optional argument of <a id="wrglossary.14214"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> to allow a mixture of <a id="wrglossary.14215"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> and <a id="wrglossary.14216"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>.<p>
+<div class="filedef">🗋<a href="samples/sample-external.tex">📥</a> <a id="wrglossary.14217"></a><dfn id="glo:file.sample-external.tex"><span class="filefmt">sample-external.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-external
+makeglossaries sample-external
+pdflatex sample-external
+</pre> Uses the <a id="wrglossary.14218"></a><a href="#glo:opt.catattr.targeturl"><span class="csoptfmt">targeturl</span></a> attribute to allow for entries that should link to an external URL rather than to an internal glossary.<p>
+<div class="filedef">🗋<a href="samples/sample-fmt.tex">📥</a> <a id="wrglossary.14219"></a><dfn id="glo:file.sample-fmt.tex"><span class="filefmt">sample-fmt.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-fmt
+makeglossaries sample-fmt
+pdflatex sample-fmt
+</pre> Provides text-block commands associated with entries in order to use <a id="wrglossary.14220"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a>.<p>
+<div class="filedef">🗋<a href="samples/sample-alias.tex">📥</a> <a id="wrglossary.14221"></a><dfn id="glo:file.sample-alias.tex"><span class="filefmt">sample-alias.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-alias
+makeglossaries sample-alias
+pdflatex sample-alias
+</pre> Uses the <a id="wrglossary.14222"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> key (see §<a href="#sec:alias">3.4</a>).<p>
+<div class="filedef">🗋<a href="samples/sample-alttree.tex">📥</a> <a id="wrglossary.14223"></a><dfn id="glo:file.sample-alttree.tex"><span class="filefmt">sample-alttree.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-alttree
+makeglossaries sample-alttree
+pdflatex sample-alttree
+</pre> Uses the <a id="wrglossary.14224"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> package with the <a id="wrglossary.14225"></a><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a> style (see §<a href="#sec:stylemods">8.6.5</a>).<p>
+<div class="filedef">🗋<a href="samples/sample-alttree-sym.tex">📥</a> <a id="wrglossary.14226"></a><dfn id="glo:file.sample-alttree-sym.tex"><span class="filefmt">sample-alttree-sym.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-alttree-sym
+makeglossaries sample-alttree-sym
+pdflatex sample-alttree-sym
+</pre> Another <a id="wrglossary.14227"></a><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a> example that measures the symbol widths.<p>
+<div class="filedef">🗋<a href="samples/sample-alttree-marginpar.tex">📥</a> <a id="wrglossary.14228"></a><dfn id="glo:file.sample-alttree-marginpar.tex"><span class="filefmt">sample-alttree-marginpar.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-alttree-marginpar
+makeglossaries sample-alttree-marginpar
+pdflatex sample-alttree-marginpar
+</pre> Another <a id="wrglossary.14229"></a><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a> example that puts the <a id="wrglossary.14230"></a><a href="#glo:dual.locationlist">location list</a> in the margin.<p>
+<div class="filedef">🗋<a href="samples/sample-onthefly.tex">📥</a> <a id="wrglossary.14231"></a><dfn id="glo:file.sample-onthefly.tex"><span class="filefmt">sample-onthefly.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-onthefly
+makeglossaries sample-onthefly
+pdflatex sample-onthefly
+</pre> Using on-the-fly commands. Terms with accents must have the <a id="wrglossary.14232"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key explicitly set.<p>
+<div class="filedef">🗋<a href="samples/sample-onthefly-xetex.tex">📥</a> <a id="wrglossary.14233"></a><dfn id="glo:file.sample-onthefly-xetex.tex"><span class="filefmt">sample-onthefly-xetex.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>xelatex sample-onthefly-xetex
+makeglossaries sample-onthefly-xetex
+xelatex sample-onthefly-xetex
+</pre> Using on-the-fly commands with XeLaTeX. Terms with UTF-8 characters don’t need to have the <a id="wrglossary.14234"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key explicitly set. Terms that contain commands must have the <a id="wrglossary.14235"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key explicitly set with the commands removed from the label.<p>
+<div class="filedef">🗋<a href="samples/sample-onthefly-utf8.tex">📥</a> <a id="wrglossary.14236"></a><dfn id="glo:file.sample-onthefly-utf8.tex"><span class="filefmt">sample-onthefly-utf8.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-onthefly-utf8
+makeglossaries sample-onthefly-utf8
+pdflatex sample-onthefly-utf8
+</pre> Tries to emulate the previous sample file for use with LaTeX through the starred version of <a id="wrglossary.14237"></a><a href="#glo:GlsXtrEnableOnTheFly"><code class="csfmt">\GlsXtrEnableOnTheFly</code></a>. This is a bit iffy and may not always work. Terms that contain commands must have the <a id="wrglossary.14238"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key explicitly set with the commands removed from the label.<p>
+<div class="filedef">🗋<a href="samples/sample-accsupp.tex">📥</a> <a id="wrglossary.14239"></a><dfn id="glo:file.sample-accsupp.tex"><span class="filefmt">sample-accsupp.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-accsupp
+makeglossaries sample-accsupp
+pdflatex sample-accsupp
+</pre> Integrate <a id="wrglossary.14240"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a>.<p>
+<div class="filedef">🗋<a href="samples/sample-prefix.tex">📥</a> <a id="wrglossary.14241"></a><dfn id="glo:file.sample-prefix.tex"><span class="filefmt">sample-prefix.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-prefix
+makeglossaries sample-prefix
+pdflatex sample-prefix
+</pre> Integrate <a id="wrglossary.14242"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>.<p>
+<div class="filedef">🗋<a href="samples/sample-suppl-main.tex">📥</a> <a id="wrglossary.14243"></a><dfn id="glo:file.sample-suppl-main.tex"><span class="filefmt">sample-suppl-main.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-suppl
+pdflatex sample-suppl-main
+makeglossaries sample-suppl-main
+pdflatex sample-suppl-main
+</pre> Uses <a id="wrglossary.14244"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a> to reference a location in the supplementary file <a id="wrglossary.14245"></a><dfn id="glo:file.sample-suppl.tex"><span class="filefmt">sample-suppl.tex</span></dfn>.<p>
+<div class="filedef">🗋<a href="samples/sample-suppl-main-hyp.tex">📥</a> <a id="wrglossary.14246"></a><dfn id="glo:file.sample-suppl-main-hyp.tex"><span class="filefmt">sample-suppl-main-hyp.tex</span></dfn></div><!-- end of filedef -->
+ <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex sample-suppl-hyp
+makeglossaries sample-suppl-hyp
+pdflatex sample-suppl-hyp
+pdflatex sample-suppl-main-hyp
+makeglossaries sample-suppl-main-hyp
+pdflatex sample-suppl-main-hyp
+</pre> A more complicated version to the above that uses the <a id="wrglossary.14247"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> package to reference a location in the supplementary file <a id="wrglossary.14248"></a><dfn id="glo:file.sample-suppl-hyp.tex"><span class="filefmt">sample-suppl-hyp.tex</span></dfn>.<p>
+
+</section><!-- end of section sec:samples -->
+
+<section id="sec:lang"><!-- start of section sec:lang --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->15. Multi-Lingual Support<div class="labellink"><a href="#sec:lang">[link]</a></div></h1><!-- end of chapter header -->
+<p>
+There’s only one command provided by <a id="wrglossary.14249"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> that you’re likely to want to change in your document and that’s <a id="wrglossary.14250"></a><a href="#glo:abbreviationsname"><code class="csfmt">\abbreviationsname</code></a> if you use the <a id="wrglossary.14251"></a><a href="#glo:opt.abbreviations"><span class="styoptfmt">abbreviations</span></a> package option to automatically create the glossary labelled <code class="code">abbreviations</code>. If this command doesn’t already exist, it will be defined to <span class="qt">“Abbreviations”</span> if <a id="wrglossary.14252"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> hasn’t been loaded, otherwise it will be defined as <a id="wrglossary.14253"></a><a href="#glo:acronymname"><code class="csfmt">\acronymname</code></a> (provided by <a id="wrglossary.14254"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>), which is language-sensitive.<p>
+You can redefine <a id="wrglossary.14255"></a><a href="#glo:abbreviationsname"><code class="csfmt">\abbreviationsname</code></a> in the usual way. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.14256"></a><a href="#glo:abbreviationsname"><code class="csfmt">\abbreviationsname</code></a>}{List of Abbreviations}
+</pre> Or using <a id="wrglossary.14257"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.14258"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a> captions hook: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\appto</code><code class="cmd">\captionsenglish</code>{<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.14259"></a><a href="#glo:abbreviationsname"><code class="csfmt">\abbreviationsname</code></a>}{List of Abbreviations}<span class="comment">% </span>
+}
+</pre><p>
+Alternatively you can use the <a id="wrglossary.14260"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a> key when you print the list of abbreviations. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.14261"></a><a href="#glo:printabbreviations"><code class="csfmt">\printabbreviations</code></a>[<a id="wrglossary.14262"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a><span class="optfmt">={List of Abbreviations}</span>]
+</pre> or <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.14263"></a><a href="#glo:printabbreviations"><code class="csfmt">\printabbreviations</code></a>[<a id="wrglossary.14264"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a>abbreviations,<a id="wrglossary.14265"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a><span class="optfmt">={List of Abbreviations}</span>]
+</pre><p>
+The other fixed text commands are the diagnostic messages, which shouldn’t appear in the final draft of your document.<p>
+The <a id="wrglossary.14266"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has the facility to load language modules (whose filename is in the form <span class="filefmt">glossariesxtr-</span><span class="meta">〈<em class="metainner">language</em>〉</span><span class="filefmt">.<a id="wrglossary.14267"></a><a href="#glo:ext.ldf"><span class="extfmt">ldf</span></a></span>) if they exist, but won’t warn if they don’t. If <a id="wrglossary.14268"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> is loaded via the <a id="wrglossary.14269"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a> package option then the check for language resource files will additionally search for an associated language script file given by <span class="filefmt">glossariesxtr-</span><span class="meta">〈<em class="metainner">script</em>〉</span><span class="filefmt">.<a id="wrglossary.14270"></a><a href="#glo:ext.ldf"><span class="extfmt">ldf</span></a></span> where <span class="meta">〈<em class="metainner">script</em>〉</span> is the four letter script identifier, such as <code class="code">Latn</code>, associated with the given dialect. There’s no warning if the associated file isn’t found. The script file is loaded after the dialect file.<p>
+If you want to write your own language module, you just need to create a file called <span class="filefmt">glossariesxtr-</span><span class="meta">〈<em class="metainner">lang</em>〉</span><span class="filefmt">.<a id="wrglossary.14271"></a><a href="#glo:ext.ldf"><span class="extfmt">ldf</span></a></span>, where <span class="meta">〈<em class="metainner">lang</em>〉</span> identifies the language or dialect (see the <a id="wrglossary.14272"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> package). For example, <span class="filefmt">glossariesxtr-french.ldf</span>. The file should start with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14273"></a><code class="code"><dfn id="glo:ProvidesGlossariesExtraLang"><code class="csfmt">\ProvidesGlossariesExtraLang</code></dfn>{<span class="meta">〈<em class="metainner">tag</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The simplest code for this file is: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.14274"></a><a href="#glo:ProvidesGlossariesExtraLang"><code class="csfmt">\ProvidesGlossariesExtraLang</code></a>{french}[2015/12/09 v1.0]
+
+<code class="cmd">\newcommand</code>*{<code class="cmd">\glossariesxtrcaptionsfrench</code>}{<span class="comment">% </span>
+ <code class="cmd">\def</code><a id="wrglossary.14275"></a><a href="#glo:abbreviationsname"><code class="csfmt">\abbreviationsname</code></a>{Abr<code class="cmd">\'</code>eviations}<span class="comment">% </span>
+}
+<code class="cmd">\glossariesxtrcaptionsfrench</code>
+
+<code class="cmd">\ifcsdef</code>{captions<a id="wrglossary.14276"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}
+{<span class="comment">% </span>
+ <code class="cmd">\csappto</code>{captions<a id="wrglossary.14277"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}<span class="comment">% </span>
+ {<span class="comment">% </span>
+ <code class="cmd">\glossariesxtrcaptionsfrench</code>
+ }<span class="comment">% </span>
+}<span class="comment">% </span>
+{<span class="comment">% </span>
+ <code class="cmd">\ifcsdef</code>{captions<a id="wrglossary.14278"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}
+ {<span class="comment">% </span>
+ <code class="cmd">\csappto</code>{captions<a id="wrglossary.14279"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}<span class="comment">% </span>
+ {<span class="comment">% </span>
+ <code class="cmd">\glossariesxtrcaptionsfrench</code>
+ }<span class="comment">% </span>
+ }<span class="comment">% </span>
+ {}<span class="comment">% </span>
+}
+</pre><p>
+You can adapt this for other languages by replacing all instances of the language identifier <code class="code">french</code> and the translated text <code class="code">Abr<span class="cmdfmt">\'</span>eviations</code> as appropriate. You can also use the <a id="wrglossary.14280"></a><a href="#glo:ext.ldf"><span class="extfmt">ldf</span></a> file to provide rule blocks for a particular language for use with <a id="wrglossary.14281"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span>’s</a> custom sort rule. See §<a href="#sec:bib2glssty">11.5</a> for further details.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+For further information on <a id="wrglossary.14282"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a>, see the <a id="wrglossary.14283"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> documentation or <a href="https://www.dickimaw-books.com/latex/tracklang/">Localisation with <span class="filefmt">tracklang.tex</span></a>. </div><!-- end of information -->
+<p>
+This <a id="wrglossary.14284"></a><a href="#glo:ext.ldf"><span class="extfmt">ldf</span></a> file then needs to be put somewhere on TeX’s path so that it can be found by <a id="wrglossary.14285"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. You might also want to consider uploading it to <a href="https://ctan.org/">CTAN</a> so that it can be useful to others. (Please don’t send it to me. I already have more packages than I am able to maintain.)<p>
+If you additionally want to provide translations for the diagnostic messages used when a glossary is missing, you need to redefine the following commands: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14286"></a><code class="code"><dfn id="glo:GlsXtrNoGlsWarningHead"><code class="csfmt">\GlsXtrNoGlsWarningHead</code></dfn>{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}{<span class="meta">〈<em class="metainner">file</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This produces the following text in English: <blockquote> This document is incomplete. The external file associated with the glossary ‘<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>’ (which should be called <span class="meta">〈<em class="metainner">file</em>〉</span>) hasn’t been created. </blockquote><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14287"></a><code class="code"><dfn id="glo:GlsXtrNoGlsWarningEmptyStart"><code class="csfmt">\GlsXtrNoGlsWarningEmptyStart</code></dfn></code></div><!-- end of pinnedbox -->
+ This produces the following text in English: <blockquote> This has probably happened because there are no entries defined in this glossary.</blockquote><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14288"></a><code class="code"><dfn id="glo:GlsXtrNoGlsWarningEmptyMain"><code class="csfmt">\GlsXtrNoGlsWarningEmptyMain</code></dfn></code></div><!-- end of pinnedbox -->
+ This produces the following text in English: <blockquote> If you don't want this glossary, add nomain to your package option list when you load glossaries-extra.sty. For example:</blockquote><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14289"></a><code class="code"><dfn id="glo:GlsXtrNoGlsWarningEmptyNotMain"><code class="csfmt">\GlsXtrNoGlsWarningEmptyNotMain</code></dfn>{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This produces the following text in English: <blockquote> Did you forget to use type=<span class="meta">〈<em class="metainner">glossary-label</em>〉</span> when you defined your entries? If you tried to load entries into this glossary with \loadglsentries did you remember to use [<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>] as the optional argument? If you did, check that the definitions in the file you loaded all had the type set to \glsdefaulttype </blockquote><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14290"></a><code class="code"><dfn id="glo:GlsXtrNoGlsWarningCheckFile"><code class="csfmt">\GlsXtrNoGlsWarningCheckFile</code></dfn>{<span class="meta">〈<em class="metainner">file</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This produces the following text in English: <blockquote> Check the contents of the file <span class="meta">〈<em class="metainner">file</em>〉</span>. If it’s empty, that means you haven’t indexed any of your entries in this glossary (using commands like \gls) or \glsadd) so this list can’t be generated. If the file isn’t empty, the document build process hasn’t been completed. </blockquote><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14291"></a><code class="code"><dfn id="glo:GlsXtrNoGlsWarningMisMatch"><code class="csfmt">\GlsXtrNoGlsWarningMisMatch</code></dfn></code></div><!-- end of pinnedbox -->
+ This produces the following text in English: <blockquote> You need to either replace \makenoidxglossaries with \makeglossaries or replace \printglossary (or \printglossaries) with \printnoidxglossary and then rebuild this document.</blockquote><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14292"></a><code class="code"><dfn id="glo:GlsXtrNoGlsWarningNoOut"><code class="csfmt">\GlsXtrNoGlsWarningNoOut</code></dfn>{<span class="meta">〈<em class="metainner">file</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This produces the following text in English: <blockquote> The file <span class="meta">〈<em class="metainner">file</em>〉</span> doesn’t exist. This most likely means you haven’t used \makeglossaries or you have used \nofiles. If this is just a draft version of the document, you can suppress this message using the nomissingglstext ackage option. </blockquote><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14293"></a><code class="code"><dfn id="glo:GlsXtrNoGlsWarningTail"><code class="csfmt">\GlsXtrNoGlsWarningTail</code></dfn></code></div><!-- end of pinnedbox -->
+ This produces the following text in English: <blockquote> This message will be removed once the problem has been fixed.</blockquote><p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14294"></a><code class="code"><dfn id="glo:GlsXtrNoGlsWarningBuildInfo"><code class="csfmt">\GlsXtrNoGlsWarningBuildInfo</code></dfn></code></div><!-- end of pinnedbox -->
+ This is advice on how to generate the glossary files.<p>
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.14295"></a><code class="code"><dfn id="glo:GlsXtrNoGlsWarningAutoMake"><code class="csfmt">\GlsXtrNoGlsWarningAutoMake</code></dfn>{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This is the message produced when the <a id="wrglossary.14296"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a> option is used, but the document needs a rerun or the shell escape setting doesn’t permit the execution of the external application. This command also generates a warning in the transcript file.<p>
+See the documented code (<span class="filefmt">glossaries-extra-code.pdf</span>) for further details.<p>
+
+</section><!-- end of section sec:lang -->
+
+<section id="part.II"><!-- start of section part.II --><div class="tomain"><a href="#main">[top]</a></div>
+<div class="part"><!-- start of part header -->II. Summaries and Index<div class="labellink"><a href="#part.II">[link]</a></div></div><!-- end of part header -->
+<p>
+
+</section><!-- end of section part.II -->
+
+<section id="symbols"><!-- start of section symbols --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->Symbols<div class="labellink"><a href="#symbols">[link]</a></div></h1><!-- end of chapter header -->
+
+<dl class="inlineblock">
+<dt><dfn id="glo:sym.counter">№</dfn></dt>
+<dd>A counter is being described.</dd>
+<dt><dfn id="glo:sym.definition">📌</dfn></dt>
+<dd>The syntax and usage of a command, environment or option etc.</dd>
+<dt><dfn id="glo:sym.deprecated"><span class="deprecatedorbannedfmt">🗑</span></dfn></dt>
+<dd>A command, environment or option that is now deprecated.</dd>
+<dt><dfn id="glo:sym.banned"><span class="deprecatedorbannedfmt">🛇</span></dfn></dt>
+<dd>A command, environment or option that should not be used with <span class="styfmt">glossaries-extra</span>.</dd>
+<dt><dfn id="glo:sym.important">ℹ</dfn></dt>
+<dd>An important message.</dd>
+<dt><dfn id="glo:sym.information">🛈</dfn></dt>
+<dd>Prominent information.</dd>
+<dt><dfn id="glo:sym.code">🖹</dfn></dt>
+<dd>LaTeX code to insert into your document.</dd>
+<dt><dfn id="glo:sym.optionvalue">🔖</dfn></dt>
+<dd>The definition of an option value.</dd>
+<dt><dfn id="glo:sym.badcode"><span class="overlapped">🖹</span><span class="overlapper"><span class="deprecatedorbannedfmt">🛇</span></span></dfn></dt>
+<dd>Problematic code which should be avoided.</dd>
+<dt><dfn id="glo:sym.result">🖺</dfn></dt>
+<dd>How the example code should appear in the PDF.</dd>
+<dt><dfn id="glo:sym.valuesetting"><span class="quarterleft">🎚</span></dfn></dt>
+<dd>An option that takes a value.</dd>
+<dt><dfn id="glo:sym.terminal">〉_</dfn></dt>
+<dd>A command-line application invocation that needs to be entered into a <a href="https://www.dickimaw-books.com/latex/novices/html/terminal.html">terminal or command prompt</a>. See also <span class="qt">“<a href="https://www.dickimaw-books.com/latex/buildglossaries">Incorporating makeglossaries or makeglossaries-lite or bib2gls into the document build</a>”</span>.</dd>
+<dt><dfn id="glo:sym.toggleoffsetting"><span class="fwsdisabledicon">🔘︎</span></dfn></dt>
+<dd>A boolean option that is initially false.</dd>
+<dt><dfn id="glo:sym.toggleonsetting"><span class="fwsactiveicon">🔘</span></dfn></dt>
+<dd>A boolean option that is initially true.</dd>
+<dt><dfn id="glo:sym.transcript">🔎</dfn></dt>
+<dd>Text in a transcript or log file or written to STDOUT or STDERR.</dd>
+<dt><dfn id="glo:sym.unicode"><span class="overlapped">🗋</span><span class="overlapper">U</span></dfn></dt>
+<dd>Code that requires a native Unicode engine (XeLaTeX or LuaLaTeX).</dd>
+<dt><dfn id="glo:sym.novaluesetting">𝍢</dfn></dt>
+<dd>An option that doesn’t take a value.</dd>
+<dt><dfn id="glo:sym.warning">⚠</dfn></dt>
+<dd>A warning.</dd>
+
+</dl>
+
+</section><!-- end of section symbols -->
+
+<section id="glossary"><!-- start of section glossary --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->Terms<div class="labellink"><a href="#glossary">[link]</a></div></h1><!-- end of chapter header -->
+
+<dl>
+<dt><a id="wrglossary.14297"></a><dfn id="glo:dual.ascii">American Standard Code for Information Interchange (ASCII)</dfn></dt>
+<dd>A single-byte character encoding. Related blog article: <a href="https://www.dickimaw-books.com/blog/binary-files-text-files-and-file-encodings/">Binary Files, Text Files and File Encodings</a>.</dd>
+<dt><a id="wrglossary.14298"></a><dfn id="glo:dual.catpostdeschook">Category post-description hook</dfn></dt>
+<dd>A <a id="wrglossary.14299"></a><a href="#glo:postdeschook">post-description hook</a> called <a id="wrglossary.14300"></a><a href="#glo:glsxtrpostdesccategory"><code class="csfmt">\glsxtrpostdesc<span class="meta">〈<em class="metainner">category</em>〉</span></code></a> that is associated with a particular <a id="wrglossary.14301"></a><a href="#glo:idx.category">category</a>.</dd>
+<dt><a id="wrglossary.14302"></a><dfn id="glo:dual.catpostlinkhook">Category post-link hook</dfn></dt>
+<dd>A <a id="wrglossary.14303"></a><a href="#glo:dual.postlinkhook">post-link hook</a> called <a id="wrglossary.14304"></a><a href="#glo:glsxtrpostlinkcat"><code class="csfmt">\glsxtrpostlink<span class="meta">〈<em class="metainner">category</em>〉</span></code></a> that is associated with a particular <a id="wrglossary.14305"></a><a href="#glo:idx.category">category</a>.</dd>
+<dt><a id="wrglossary.14306"></a><dfn id="glo:dual.catpostnamehook">Category post-name hook</dfn></dt>
+<dd>A <a id="wrglossary.14307"></a><a href="#glo:postnamehook">post-name hook</a> called <a id="wrglossary.14308"></a><a href="#glo:glsxtrpostnamecategory"><code class="csfmt">\glsxtrpostname<span class="meta">〈<em class="metainner">category</em>〉</span></code></a> that is associated with a particular <a id="wrglossary.14309"></a><a href="#glo:idx.category">category</a>.</dd>
+<dt><a id="wrglossary.14310"></a><dfn id="glo:dual.cli">Command-line interface (CLI)</dfn></dt>
+<dd>An application that doesn’t have a graphical user interface. That is, an application that doesn’t have any windows, buttons or menus and can be run in <a href="https://www.dickimaw-books.com/latex/novices/html/terminal.html">a command prompt or terminal</a>.</dd>
+<dt><a id="wrglossary.14311"></a><dfn id="glo:dual.displayfullform">Display full form</dfn></dt>
+<dd>The full form of an abbreviation obtained with the <a id="wrglossary.14312"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.14313"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or <a id="wrglossary.14314"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> (or case-changing variants). This may or may not produce the same result as the <a id="wrglossary.14315"></a><a href="#glo:dual.inlinefullform">inline full form</a> the corresponding <a id="wrglossary.14316"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> command, depending on the abbreviation style.</dd>
+<dt><a id="wrglossary.14317"></a><dfn id="glo:dual.entrylocation">Entry location</dfn></dt>
+<dd>The location of the entry in the document (obtained from the <a id="wrglossary.14318"></a><a href="#glo:dual.locationcounter">location counter</a> or from the <a id="wrglossary.14319"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a> option). This defaults to the page number on which the entry has been referenced with any of the <a id="wrglossary.14320"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a>, <a id="wrglossary.14321"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> or <a id="wrglossary.14322"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> commands. An entry may have multiple locations that form a list.</dd>
+<dt><a id="wrglossary.14323"></a><dfn id="glo:dual.field">Field</dfn></dt>
+<dd>Entry data is stored in fields. These may have a corresponding key used to set the value, such as <a id="wrglossary.14324"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> or <a id="wrglossary.14325"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a>, but field values may also be set using commands like <a id="wrglossary.14326"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a>, in which case there doesn’t need to be a corresponding key. Some fields are considered <a id="wrglossary.14327"></a><a href="#glo:dual.internalfield">internal fields</a>. If you are using <a id="wrglossary.14328"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, it will only recognise fields in the <a id="wrglossary.14329"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file that have had a key defined in the document or that are special to <a id="wrglossary.14330"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>.</dd>
+<dt><a id="wrglossary.14331"></a><dfn id="glo:dual.firstuse">First use</dfn></dt>
+<dd>The first time an entry is used by a command that unsets the <a id="wrglossary.14332"></a><a href="#glo:dual.firstuseflag">first use flag</a> (or the first time since the flag was reset). For multi-entry sets, see <a id="wrglossary.14333"></a><a href="#glo:dual.mfirstuse">first use</a>.</dd>
+<dt><a id="wrglossary.14334"></a><dfn id="glo:dual.firstuseflag">First use flag</dfn></dt>
+<dd>A conditional that keeps track of whether or not an entry has been referenced by any of the <a id="wrglossary.14335"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands (which can adjust their behaviour according to whether or not this flag is true). The conditional is true if the entry hasn’t been used by one of these commands (or if the flag has been reset) and false if it has been used (or if the flag has been unset). Note that multi-entries have their own flag that’s distinct from the first use flags of the individual elements.</dd>
+<dt><a id="wrglossary.14336"></a><dfn id="glo:dual.firstusetext">First use text</dfn></dt>
+<dd>The <a id="wrglossary.14337"></a><a href="#glo:dual.linktext">link text</a> that is displayed on <a id="wrglossary.14338"></a><a href="#glo:dual.firstuse">first use</a> of the <a id="wrglossary.14339"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands.</dd>
+<dt><a id="wrglossary.14340"></a><dfn id="glo:dual.idx.group">Group (letters, numbers, symbols)</dfn></dt>
+<dd>A logical division within a <a id="wrglossary.14341"></a><a href="#glo:dual.glossary">glossary</a> that is typically a by-product of the <a id="wrglossary.14342"></a><a href="#glo:dual.indexingapp">indexing application’s</a> sorting algorithm. See also <a href="https://www.dickimaw-books.com/gallery/index.php?label=logicaldivisions">Gallery: Logical Glossary Divisions (type vs group vs parent)</a>.</dd>
+<dt><a id="wrglossary.14343"></a><dfn id="glo:dual.gui">Graphical user interface (GUI)</dfn></dt>
+<dd>An application that has windows, buttons or menus.</dd>
+<dt><a id="wrglossary.14344"></a><dfn id="glo:dual.glossary">Glossary</dfn></dt>
+<dd>Technically a glossary is an alphabetical list of words relating to a particular topic. For the purposes of describing the <a id="wrglossary.14345"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> and <a id="wrglossary.14346"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> packages, a glossary is either the list produced by commands like <a id="wrglossary.14347"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> or <a id="wrglossary.14348"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> (which may or may not be ordered alphabetically) or a glossary is a set of entry labels where the set is identified by the glossary label or type.</dd>
+<dt><a id="wrglossary.14349"></a><dfn id="glo:dual.glslike"><code class="csfmt">\Gls</code>-like</dfn></dt>
+<dd>Commands like <a id="wrglossary.14350"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> and <a id="wrglossary.14351"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a> that change the <a id="wrglossary.14352"></a><a href="#glo:dual.firstuseflag">first use flag</a>. These commands index the entry (if indexing is enabled), create a hyperlink to the entry’s <a id="wrglossary.14353"></a><a href="#glo:dual.glossary">glossary</a> listing (if enabled) and unset the <a id="wrglossary.14354"></a><a href="#glo:dual.firstuseflag">first use flag</a>. These commands end with the <a id="wrglossary.14355"></a><a href="#glo:dual.postlinkhook">post-link hook</a>.</dd>
+<dt><a id="wrglossary.14356"></a><dfn id="glo:dual.glstextlike"><code class="csfmt">\Glstext</code>-like</dfn></dt>
+<dd>Commands like <a id="wrglossary.14357"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> and <a id="wrglossary.14358"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a> that don’t change the <a id="wrglossary.14359"></a><a href="#glo:dual.firstuseflag">first use flag</a>. These commands index the entry (if indexing is enabled) and create a hyperlink to the entry’s <a id="wrglossary.14360"></a><a href="#glo:dual.glossary">glossary</a> listing (if enabled). These commands end with the <a id="wrglossary.14361"></a><a href="#glo:dual.postlinkhook">post-link hook</a>.</dd>
+<dt><a id="wrglossary.14362"></a><dfn id="glo:dual.hierarchicallevel">Hierarchical level</dfn></dt>
+<dd>A number that indicates how many ancestors an entry has. An entry with no parent has hierarchical level 0. If an entry has a parent then the hierarchical level for the entry is one more than the hierarchical level of the parent. Most styles will format an entry according to its hierarchical level, giving prominence to level 0 entries, although some may have a maximum supported limit. The <a id="wrglossary.14363"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> allow the hierarchical level to be locally adjusted by adding an offset (<a id="wrglossary.14364"></a><a href="#glo:opt.printgloss.leveloffset"><span class="csoptfmt">leveloffset</span></a>) or to have hierarchy ignored (<a id="wrglossary.14365"></a><a href="#glo:opt.printgloss.flatten"><span class="csoptfmt">flatten</span></a>).</dd>
+<dt><a id="wrglossary.14366"></a><dfn id="glo:dual.ignoredglossary">Ignored glossary</dfn></dt>
+<dd>A <a id="wrglossary.14367"></a><a href="#glo:dual.glossary">glossary</a> that has been defined using a command like <a id="wrglossary.14368"></a><a href="#glo:newignoredglossary"><code class="csfmt">\newignoredglossary</code></a>. These <a id="wrglossary.14369"></a><a href="#glo:dual.glossary">glossaries</a> are omitted by iterative commands, such as <a id="wrglossary.14370"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a> and <a id="wrglossary.14371"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a>. An ignored <a id="wrglossary.14372"></a><a href="#glo:dual.glossary">glossary</a> can only be displayed with <a id="wrglossary.14373"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> or <a id="wrglossary.14374"></a><a href="#glo:printunsrtinnerglossary"><code class="csfmt">\printunsrtinnerglossary</code></a>.</dd>
+<dt><a id="wrglossary.14375"></a><dfn id="glo:dual.ignoredlocation">Ignored location (or record)</dfn></dt>
+<dd>A <a id="wrglossary.14376"></a><a href="#glo:@@glslabel@entrylocation">location</a> that uses <a id="wrglossary.14377"></a><a href="#glo:glsignore"><span class="csfmtcolourfont">glsignore</span></a> as the <a id="wrglossary.14378"></a><a href="#glo:@@glslabel@locationencap">encap</a>. With <a id="wrglossary.14379"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, this indicates that the entry needs to be selected but the <a id="wrglossary.14380"></a><a href="#glo:@@glslabel@entrylocation">location</a> isn’t added to the <a id="wrglossary.14381"></a><a href="#glo:dual.locationlist">location list</a>. With other methods, this will simply create an invisible <a id="wrglossary.14382"></a><a href="#glo:@@glslabel@entrylocation">location</a>, which can result in unwanted commas if the <a id="wrglossary.14383"></a><a href="#glo:dual.locationlist">location list</a> has other items.</dd>
+<dt><a id="wrglossary.14384"></a><dfn id="glo:dual.indexingapp">Indexing application</dfn></dt>
+<dd>An application (piece of software) separate from TeX/LaTeX that collates and sorts information that has an associated page reference. Generally the information is an index entry but in this case the information is a <a id="wrglossary.14385"></a><a href="#glo:dual.glossary">glossary</a> entry. There are two main indexing applications that are used with TeX: <a id="wrglossary.14386"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.14387"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. (There is also a new application called <a id="wrglossary.14388"></a><a href="#glo:app.xindex"><span class="appfmt">xindex</span></a>, but this isn’t supported by <a id="wrglossary.14389"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> or <a id="wrglossary.14390"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.) The <a id="wrglossary.14391"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package additionally supports <a id="wrglossary.14392"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. These are all <a id="wrglossary.14393"></a><a href="#glo:dual.cli">CLI</a> applications.</dd>
+<dt><a id="wrglossary.14394"></a><dfn id="glo:dual.indexing">Indexing (or recording)</dfn></dt>
+<dd>The process of saving the <a id="wrglossary.14395"></a><a href="#glo:dual.entrylocation">entry location</a> and any associated information that is required in the <a id="wrglossary.14396"></a><a href="#glo:dual.glossary">glossary</a>. In the case of <a id="wrglossary.14397"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.14398"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, the <a id="wrglossary.14399"></a><a href="#glo:dual.entrylocation">entry location</a>, <a id="wrglossary.14400"></a><a href="#glo:@@glslabel@locationencap">encap</a>, entry item and sort value are written to a supplementary file associated with the <a id="wrglossary.14401"></a><a href="#glo:dual.glossary">glossary</a> that is subsequently read by <a id="wrglossary.14402"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.14403"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. In the case of <a id="wrglossary.14404"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> and the <span class="qt">“noidx”</span> method, the <a id="wrglossary.14405"></a><a href="#glo:dual.entrylocation">entry location</a>, <a id="wrglossary.14406"></a><a href="#glo:@@glslabel@locationencap">encap</a> and label is written to the <a id="wrglossary.14407"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file. With <a id="wrglossary.14408"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.14409"></a><a href="#glo:optval.record.nameref"><span class="optfmt">nameref</span></a>, the current title and hyperlink target are also included. With <a id="wrglossary.14410"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, each line of data in the <a id="wrglossary.14411"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> is referred to as a <span class="qt">“record”</span> and indexing is referred to as <span class="qt">“recording”</span>. The <a id="wrglossary.14412"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=hybrid</span> option indexes twice: a <a id="wrglossary.14413"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> record in the <a id="wrglossary.14414"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and a <a id="wrglossary.14415"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.14416"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> line in the corresponding file, See §<a href="#sec:wrglossary">5.8</a>.</dd>
+<dt><a id="wrglossary.14417"></a><dfn id="glo:dual.inlinefullform">Inline full form</dfn></dt>
+<dd>The full form of an abbreviation obtained with <a id="wrglossary.14418"></a><a href="#glo:glsxtrfull"><span class="csfmtcolourfont">glsxtrfull</span></a> or <a id="wrglossary.14419"></a><a href="#glo:glsxtrfullpl"><span class="csfmtcolourfont">glsxtrfullpl</span></a> (or case-changing variants). This may or may not produce the same result as the full form on <a id="wrglossary.14420"></a><a href="#glo:dual.firstuse">first use</a> of the corresponding <a id="wrglossary.14421"></a><a href="#glo:dual.glslike"><span class="csfmtcolourfont">gls</span>-like</a> command (the <a id="wrglossary.14422"></a><a href="#glo:dual.displayfullform">display full form</a>), depending on the abbreviation style.</dd>
+<dt><a id="wrglossary.14423"></a><dfn id="glo:dual.innerformatting">Inner formatting</dfn></dt>
+<dd>The formatting applied by the <a id="wrglossary.14424"></a><a href="#glo:opt.glsopt.innertextformat"><span class="csoptfmt">innertextformat</span></a> option, which redefines <a id="wrglossary.14425"></a><a href="#glo:glsxtrgenentrytextfmt"><span class="csfmtcolourfont">glsxtrgenentrytextfmt</span></a>. The inner formatting can only be applied if <a id="wrglossary.14426"></a><a href="#glo:glsxtrgenentrytextfmt"><span class="csfmtcolourfont">glsxtrgenentrytextfmt</span></a> is embedded within the entry’s display style.</dd>
+<dt><a id="wrglossary.14427"></a><dfn id="glo:dual.internalfield">Internal field</dfn></dt>
+<dd>An internal <a id="wrglossary.14428"></a><a href="#glo:dual.field">field</a> may refer to a key that shouldn’t be used in the <a id="wrglossary.14429"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file (<a id="wrglossary.14430"></a><a href="#glo:dual.bib2glsinternalfield">internal field (<span class="appfmt">bib2gls</span>)</a>), such as the <a id="wrglossary.14431"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a> field, or it may refer to the <a id="wrglossary.14432"></a><a href="#glo:@@glslabel@internalfieldlabel">label</a> used to internally represent the <a id="wrglossary.14433"></a><a href="#glo:dual.field">field</a> (which may or may not match the key used to set the <a id="wrglossary.14434"></a><a href="#glo:dual.field">field</a> or may not have an associated key), such as <code class="fieldfmt">useri</code> which corresponds to the <a id="wrglossary.14435"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key, or it may refer to a <a id="wrglossary.14436"></a><a href="#glo:dual.field">field</a> that is only ever used internally that should not be explicitly modified, such as the field used to store the entry’s hierarchical level .</dd>
+<dt><a id="wrglossary.14437"></a><dfn id="glo:dual.bib2glsinternalfield">Internal field (<span class="appfmt">bib2gls</span>)</dfn></dt>
+<dd>A <a id="wrglossary.14438"></a><a href="#glo:dual.field">field</a> that is used or assigned by <a id="wrglossary.14439"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> that should typically not be used in the <a id="wrglossary.14440"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file.</dd>
+<dt><a id="wrglossary.14441"></a><dfn id="glo:dual.internalfieldlabel">Internal field label</dfn></dt>
+<dd>The field label that forms part of the internal control sequence used to store the field value. This may or may not match the key used to assign the value when defining the entry. See the <a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/glossaries-user.html#tab:fieldmap"><span class="qt">“Key to Field Mappings”</span></a> table in the <a id="wrglossary.14442"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> user manual.</dd>
+<dt><a id="wrglossary.14443"></a><dfn id="glo:dual.linktext">Link text</dfn></dt>
+<dd>The text produced by <a id="wrglossary.14444"></a><a href="#glo:dual.glslike"><span class="csfmtcolourfont">gls</span>-like</a> and <a id="wrglossary.14445"></a><a href="#glo:dual.glstextlike"><span class="csfmtcolourfont">glstext</span>-like</a> commands that have the potential to be a hyperlink.</dd>
+<dt><a id="wrglossary.14446"></a><dfn id="glo:dual.locationcounter">Location counter</dfn></dt>
+<dd>The counter used to obtain the <a id="wrglossary.14447"></a><a href="#glo:dual.entrylocation">entry location</a>.</dd>
+<dt><a id="wrglossary.14448"></a><dfn id="glo:dual.locationencap">Location encap (format)</dfn></dt>
+<dd>A command used to encapsulate an <a id="wrglossary.14449"></a><a href="#glo:dual.entrylocation">entry location</a>. The control sequence name (without the leading backslash) is identified by the <a id="wrglossary.14450"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a> key. The default encap is <a id="wrglossary.14451"></a><a href="#glo:glsnumberformat"><span class="csfmtcolourfont">glsnumberformat</span></a>.</dd>
+<dt><a id="wrglossary.14452"></a><dfn id="glo:dual.locationlist">Location list</dfn></dt>
+<dd>A list of <a id="wrglossary.14453"></a><a href="#glo:dual.entrylocation">entry locations</a> (also called a number list). May be suppressed for all <a id="wrglossary.14454"></a><a href="#glo:dual.glossary">glossaries</a> with the package option <a id="wrglossary.14455"></a><a href="#glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></a> or for individual <a id="wrglossary.14456"></a><a href="#glo:dual.glossary">glossaries</a> with <a id="wrglossary.14457"></a><a href="#glo:opt.printgloss.nonumberlist"><span class="csoptfmt">nonumberlist</span></a>. With <a id="wrglossary.14458"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the list may also be suppressed with <a id="wrglossary.14459"></a><a href="#glo:opt.resource.save-locations"><span class="csoptfmt">save-locations</span></a><span class="optfmt">=false</span>.</dd>
+<dt><a id="wrglossary.14460"></a><dfn id="glo:dual.mfirstuse">Multi-entry first use</dfn></dt>
+<dd>The first time a multi-entry is referenced (or the first time since the <a id="wrglossary.14461"></a><a href="#glo:dual.mfirstuseflag">multi-entry first use flag</a> was reset). This is not necessary the <a id="wrglossary.14462"></a><a href="#glo:dual.firstuse">first use</a> of any of the individual entries that form the set.</dd>
+<dt><a id="wrglossary.14463"></a><dfn id="glo:dual.mfirstuseflag">Multi-entry first use flag</dfn></dt>
+<dd>A conditional that keeps track of whether or not a multi-entry has been used. This is distinct from the <a id="wrglossary.14464"></a><a href="#glo:dual.firstuseflag">first use flags</a> of the individual elements.</dd>
+<dt><a id="wrglossary.14465"></a><dfn id="glo:dual.msubsequentuse">Multi-entry subsequent use</dfn></dt>
+<dd>When a multi-entry that has already been marked as used is referenced. This is not necessary the <a id="wrglossary.14466"></a><a href="#glo:dual.subsequentuse">subsequent use</a> of any of the individual entries that form the set.</dd>
+<dt><a id="wrglossary.14467"></a><dfn id="glo:dual.postdeschook">Post-description hook</dfn></dt>
+<dd>A hook (<a id="wrglossary.14468"></a><a href="#glo:glspostdescription"><span class="csfmtcolourfont">glspostdescription</span></a>) included in some <a id="wrglossary.14469"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that is used after the description is displayed. The <a id="wrglossary.14470"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package modifies this command to provide additional hooks, including <a id="wrglossary.14471"></a><a href="#glo:catpostdeschook">category post-description hooks</a>. The <a id="wrglossary.14472"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> package modifies the predefined styles provided with <a id="wrglossary.14473"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> to ensure that they all use <a id="wrglossary.14474"></a><a href="#glo:glspostdescription"><span class="csfmtcolourfont">glspostdescription</span></a> to allow the <a id="wrglossary.14475"></a><a href="#glo:catpostdeschook">category post-description hooks</a> to be implemented.</dd>
+<dt><a id="wrglossary.14476"></a><dfn id="glo:dual.postlinkhook">Post-link hook</dfn></dt>
+<dd>A hook (command) that is used after <a id="wrglossary.14477"></a><a href="#glo:dual.linktext">link text</a> to allow code to be automatically added. The base <a id="wrglossary.14478"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package provides a general purpose hook <a id="wrglossary.14479"></a><a href="#glo:glspostlinkhook"><span class="csfmtcolourfont">glspostlinkhook</span></a>. The <a id="wrglossary.14480"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package modifies this command to provide additional hooks, including <a id="wrglossary.14481"></a><a href="#glo:catpostlinkhook">category post-link hooks</a>.</dd>
+<dt><a id="wrglossary.14482"></a><dfn id="glo:dual.postnamehook">Post-name hook</dfn></dt>
+<dd>A hook (command) that is used after the name is displayed in <a id="wrglossary.14483"></a><a href="#glo:idx.glossarystyle">glossary styles</a>. These hooks are implemented by <a id="wrglossary.14484"></a><a href="#glo:glossentryname"><span class="csfmtcolourfont">glossentryname</span></a>, which needs to be present in the <a id="wrglossary.14485"></a><a href="#glo:idx.glossarystyle">glossary style</a>. The main hook is <a id="wrglossary.14486"></a><a href="#glo:glsxtrpostnamehook"><span class="csfmtcolourfont">glsxtrpostnamehook</span></a>, which implements auto-indexing (see §<a href="#sec:autoindex">12</a>), performs a general purpose hook <a id="wrglossary.14487"></a><a href="#glo:glsextrapostnamehook"><span class="csfmtcolourfont">glsextrapostnamehook</span></a> and a <a id="wrglossary.14488"></a><a href="#glo:idx.category">category</a>-specific hook <a id="wrglossary.14489"></a><a href="#glo:glsxtrpostnamecategory"><span class="csfmtcolourfont">glsxtrpostname<span class="meta">〈<em class="metainner">category</em>〉</span></span></a>.</dd>
+<dt><a id="wrglossary.14490"></a><dfn id="glo:dual.unsrtfam">Print <span class="qt">“unsrt”</span> glossary commands (and environment)</dfn></dt>
+<dd>The set of commands used for displaying a <a id="wrglossary.14491"></a><a href="#glo:dual.glossary">glossary</a> or partial <a id="wrglossary.14492"></a><a href="#glo:dual.glossary">glossary</a> that have <span class="qt">“unsrt”</span> in the name: <a id="wrglossary.14493"></a><a href="#glo:printunsrtglossary"><span class="csfmtcolourfont">printunsrtglossary</span></a>, <a id="wrglossary.14494"></a><a href="#glo:printunsrtglossaries"><span class="csfmtcolourfont">printunsrtglossaries</span></a> (which internally uses <a id="wrglossary.14495"></a><a href="#glo:printunsrtglossary"><span class="csfmtcolourfont">printunsrtglossary</span></a>), and <a id="wrglossary.14496"></a><a href="#glo:printunsrtinnerglossary"><span class="csfmtcolourfont">printunsrtinnerglossary</span></a>. These all simply iterate over the list of entries associated with the given <a id="wrglossary.14497"></a><a href="#glo:dual.glossary">glossary</a>, in the order in which they were added to the <a id="wrglossary.14498"></a><a href="#glo:dual.glossary">glossary</a> (hence <span class="qt">“unsrt”</span>, which is short for <span class="qt">“unsorted”</span>). The way that <a id="wrglossary.14499"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> works is that it sorts the entries according to the <a id="wrglossary.14500"></a><a href="#glo:idx.resourceopt">resource options</a> and adds the entries to the glossary in the required order. These commands may be used with or without <a id="wrglossary.14501"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. If you don’t use <a id="wrglossary.14502"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, you will need to manually ensure that the entries are added in the desired order. The <a id="wrglossary.14503"></a><a href="#glo:env.printunsrtglossarywrap"><span class="envfmt">printunsrtglossarywrap</span></a> environment may also be included in this category, although it only sets up the start and end of the <a id="wrglossary.14504"></a><a href="#glo:dual.glossary">glossary</a> for use with <a id="wrglossary.14505"></a><a href="#glo:printunsrtinnerglossary"><span class="csfmtcolourfont">printunsrtinnerglossary</span></a>.</dd>
+<dt><a id="wrglossary.14506"></a><dfn id="glo:dual.resourcefile">Resource file</dfn></dt>
+<dd>The <a id="wrglossary.14507"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file created by <a id="wrglossary.14508"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> and loaded by <a id="wrglossary.14509"></a><a href="#glo:GlsXtrLoadResources"><span class="csfmtcolourfont">GlsXtrLoadResources</span></a> (or <a id="wrglossary.14510"></a><a href="#glo:glsxtrresourcefile"><span class="csfmtcolourfont">glsxtrresourcefile</span></a>).</dd>
+<dt><a id="wrglossary.14511"></a><dfn id="glo:dual.resourceset">Resource set</dfn></dt>
+<dd>All the settings (<a id="wrglossary.14512"></a><a href="#glo:idx.resourceopt">resource options</a>) and entries associated with a particular instance of <a id="wrglossary.14513"></a><a href="#glo:GlsXtrLoadResources"><span class="csfmtcolourfont">GlsXtrLoadResources</span></a> (or <a id="wrglossary.14514"></a><a href="#glo:glsxtrresourcefile"><span class="csfmtcolourfont">glsxtrresourcefile</span></a>).</dd>
+<dt><a id="wrglossary.14515"></a><dfn id="glo:dual.standaloneentry">Standalone entry</dfn></dt>
+<dd>Normally the <a id="wrglossary.14516"></a><a href="#glo:dual.linktext">link text</a> target is created in the <a id="wrglossary.14517"></a><a href="#glo:dual.glossary">glossary</a>, where the entry’s name and description (and optionally other information, such as the symbol) are shown. It may be that you don’t want a list but need to have the name and description somewhere in the document text. These are standalone entries. Whilst it is possible to simply use <a id="wrglossary.14518"></a><a href="#glo:glsentryname"><span class="csfmtcolourfont">glsentryname</span></a> and <a id="wrglossary.14519"></a><a href="#glo:glsentrydesc"><span class="csfmtcolourfont">glsentrydesc</span></a>, the <a id="wrglossary.14520"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides a way inserting the name that includes the hypertarget for the <a id="wrglossary.14521"></a><a href="#glo:dual.linktext">link text</a> and obeys the <a id="wrglossary.14522"></a><a href="#glo:dual.postnamehook">post-name hook</a>.</dd>
+<dt><a id="wrglossary.14523"></a><dfn id="glo:dual.subsequentuse">Subsequent use</dfn></dt>
+<dd>Using an entry that unsets the <a id="wrglossary.14524"></a><a href="#glo:dual.firstuseflag">first use flag</a> when it has already been unset.</dd>
+<dt><a id="wrglossary.14525"></a><dfn id="glo:dual.utf8">Unicode Transformation Format (8-bit) (UTF-8)</dfn></dt>
+<dd>A variable-width encoding that uses 8-bit code units. This means that some characters are represented by more that one byte. XeLaTeX and LuaLaTeX treat the multi-byte sequence as a single token, but the older LaTeX formats have single-byte tokens, which can cause complications, although these have mostly been addressed with the newer kernels introduced over the past few years. Related blog article: <a href="https://www.dickimaw-books.com/blog/binary-files-text-files-and-file-encodings/">Binary Files, Text Files and File Encodings</a>.</dd>
+<dt><a id="wrglossary.14526"></a><dfn id="glo:dual.whatsit">Whatsit</dfn></dt>
+<dd>A command whose execution is delayed or an OS-specific special command. This includes writing to external files (which is what indexing does).</dd>
+
+</dl>
-</body></html>
-
-
-
-
+</section><!-- end of section glossary -->
+
+<section id="sec:gloskeys"><!-- start of section sec:gloskeys --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->Glossary Entry Keys Summary<div class="labellink"><a href="#sec:gloskeys">[link]</a></div></h1><!-- end of chapter header -->
+<a id="wrglossary.14527"></a>These are options that can be passed to commands that define entries, such as <a id="wrglossary.14528"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> or <a id="wrglossary.14529"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14530"></a><dfn id="glo:opt.gloskey.access"><span class="csoptfmt">access</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.14531"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of optionsummarybox -->
+<p>
+Accessibility text corresponding to the <a id="wrglossary.14532"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field. This field will be automatically set by <a id="wrglossary.14533"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>, if not provided and the <a id="wrglossary.14534"></a><a href="#glo:opt.catattr.nameshortaccess"><span class="csoptfmt">nameshortaccess</span></a> attribute is set. See §<a href="#sec:accessabbr">9.1</a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14535"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a>=<code class="code">{<span class="meta">〈<em class="metainner">xr-label</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14536"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Behaves in a similar manner to <a id="wrglossary.14537"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={[<a id="wrglossary.14538"></a><a href="#glo:seealsoname"><code class="csfmt">\seealsoname</code></a>]<span class="meta">〈<em class="metainner">xr-label</em>〉</span>}</span> but also sets up aliasing which makes the <a id="wrglossary.14539"></a><a href="#glo:dual.linktext">link text</a> hyperlink to <span class="meta">〈<em class="metainner">xr-label</em>〉</span> instead. <a href="#sec:newkeys">§3.2</a>; <a href="#wrglossary.968">33</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14540"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a>=<code class="code"><span class="meta">〈<em class="metainner">category-label</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>general <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14541"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The entry’s <a id="wrglossary.14542"></a><a href="#glo:idx.category">category</a> (must be a simple label). <a href="#sec:newkeys">§3.2</a>; <a href="#wrglossary.949">33</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14543"></a><dfn id="glo:opt.gloskey.counter"><span class="csoptfmt">counter</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">counter-name</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+If set, the value indicates the <a id="wrglossary.14544"></a><a href="#glo:dual.locationcounter">location counter</a> to use by default when <a id="wrglossary.14545"></a><a href="#glo:dual.indexing">indexing</a> this entry (overrides the counter associated with the <a id="wrglossary.14546"></a><a href="#glo:dual.glossary">glossary</a> or the <a id="wrglossary.14547"></a><a href="#glo:opt.counter"><span class="styoptfmt">counter</span></a> package option).<p>
+<div class="optionsummarybox"><a id="wrglossary.14548"></a><dfn id="glo:opt.gloskey.description"><span class="csoptfmt">description</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The entry’s description, as displayed in the <a id="wrglossary.14549"></a><a href="#glo:dual.glossary">glossary</a>. If required in the text, use <a id="wrglossary.14550"></a><a href="#glo:glsdesc"><code class="csfmt">\glsdesc</code></a> (if <a id="wrglossary.14551"></a><a href="#glo:dual.indexing">indexing</a> and hyperlinks are required) or <a id="wrglossary.14552"></a><a href="#glo:glsentrydesc"><code class="csfmt">\glsentrydesc</code></a>. Glossary styles should use <a id="wrglossary.14553"></a><a href="#glo:glossentrydesc"><code class="csfmt">\glossentrydesc</code></a> and <a id="wrglossary.14554"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a> to incorporate the <a id="wrglossary.14555"></a><a href="#glo:dual.postdeschook">post-description hook</a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14556"></a><dfn id="glo:opt.gloskey.descriptionaccess"><span class="csoptfmt">descriptionaccess</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.14557"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of optionsummarybox -->
+<p>
+Accessibility text corresponding to the <a id="wrglossary.14558"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> field.<p>
+<div class="optionsummarybox"><a id="wrglossary.14559"></a><dfn id="glo:opt.gloskey.descriptionplural"><span class="csoptfmt">descriptionplural</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The plural form of the entry’s description, if applicable. If omitted, this is set to the same value as the <a id="wrglossary.14560"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a>, since descriptions tend not to be a singular entity.<p>
+<div class="optionsummarybox"><a id="wrglossary.14561"></a><dfn id="glo:opt.gloskey.descriptionpluralaccess"><span class="csoptfmt">descriptionpluralaccess</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.14562"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of optionsummarybox -->
+<p>
+Accessibility text corresponding to the <a id="wrglossary.14563"></a><a href="#glo:opt.gloskey.descriptionplural"><span class="csoptfmt">descriptionplural</span></a> field.<p>
+<div class="optionsummarybox"><a id="wrglossary.14564"></a><dfn id="glo:opt.gloskey.first"><span class="csoptfmt">first</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">first</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The entry’s text, as displayed on <a id="wrglossary.14565"></a><a href="#glo:dual.firstuse">first use</a> of <a id="wrglossary.14566"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands. Note that using an <a id="wrglossary.14567"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> or <a id="wrglossary.14568"></a><a href="#glo:postlinkhook">post-link hooks</a> is a more flexible approach. If omitted, this value is assumed to be the same as the <a id="wrglossary.14569"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> key.<p>
+<div class="optionsummarybox"><a id="wrglossary.14570"></a><dfn id="glo:opt.gloskey.firstaccess"><span class="csoptfmt">firstaccess</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.14571"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of optionsummarybox -->
+<p>
+Accessibility text corresponding to the <a id="wrglossary.14572"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> field. This field will be automatically set by <a id="wrglossary.14573"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>, if not provided and the <a id="wrglossary.14574"></a><a href="#glo:opt.catattr.firstshortaccess"><span class="csoptfmt">firstshortaccess</span></a> attribute is set. See §<a href="#sec:accessabbr">9.1</a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14575"></a><dfn id="glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The entry’s plural form, as displayed on <a id="wrglossary.14576"></a><a href="#glo:dual.firstuse">first use</a> of plural <a id="wrglossary.14577"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands, such as <a id="wrglossary.14578"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>. If this key is omitted, then the value will either be the same as the <a id="wrglossary.14579"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> field, if the <a id="wrglossary.14580"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> key wasn’t used, or the value will be taken from the <a id="wrglossary.14581"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> key with <a id="wrglossary.14582"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a> appended.<p>
+<div class="optionsummarybox"><a id="wrglossary.14583"></a><dfn id="glo:opt.gloskey.firstpluralaccess"><span class="csoptfmt">firstpluralaccess</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.14584"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of optionsummarybox -->
+<p>
+Accessibility text corresponding to the <a id="wrglossary.14585"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> field. This field will be automatically set by <a id="wrglossary.14586"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>, if not provided and the <a id="wrglossary.14587"></a><a href="#glo:opt.catattr.firstshortaccess"><span class="csoptfmt">firstshortaccess</span></a> attribute is set. See §<a href="#sec:accessabbr">9.1</a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14588"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a>=<code class="code">{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14589"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The <a id="wrglossary.14590"></a><a href="#glo:idx.group">group</a> label that identifies which <a id="wrglossary.14591"></a><a href="#glo:idx.group">group</a> the entry belongs to. This key is only available with the <a id="wrglossary.14592"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.14593"></a><a href="#glo:optval.record.only"><span class="optfmt">only</span></a> and <a id="wrglossary.14594"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.14595"></a><a href="#glo:optval.record.nameref"><span class="optfmt">nameref</span></a> options, and is set by <a id="wrglossary.14596"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, if invoked with <a id="wrglossary.14597"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> or <a id="wrglossary.14598"></a><a href="#glo:switch.group"><span class="shortargfmt">-g</span></a>. This is an <a id="wrglossary.14599"></a><a href="#glo:@@glslabel@bib2glsinternalfield">internal key</a> assigned by <a id="wrglossary.14600"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> as a by-product of sorting. Explicit use without reference to the order of entries can result in fragmented groups. The corresponding title can be set with <a id="wrglossary.14601"></a><a href="#glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></a>, although this is more commonly done implicitly within the <a id="wrglossary.14602"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file. <a href="#sec:newkeys">§3.2</a>; <a href="#wrglossary.1019">34</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14603"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a>=<code class="code">{<span class="meta">〈<em class="metainner">location-list</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14604"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The formatted <a id="wrglossary.14605"></a><a href="#glo:dual.locationlist">location list</a> used by the <a id="wrglossary.14606"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>. This key is only available with the <a id="wrglossary.14607"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a> option and is set by <a id="wrglossary.14608"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> unless <a id="wrglossary.14609"></a><a href="#glo:opt.resource.save-locations"><span class="csoptfmt">save-locations</span></a>false is set. <a href="#sec:newkeys">§3.2</a>; <a href="#wrglossary.1028">35</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14610"></a><dfn id="glo:opt.gloskey.long"><span class="csoptfmt">long</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">long-form</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+A <a id="wrglossary.14611"></a><a href="#glo:dual.field">field</a> that is set by <a id="wrglossary.14612"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> to the entry’s long (unabbreviated) form. It typically shouldn’t be used explicitly with <a id="wrglossary.14613"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> as <a id="wrglossary.14614"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> makes other modifications to ensure that when the entry is referenced with the <a id="wrglossary.14615"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands, it will obey the appropriate <a id="wrglossary.14616"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a>. If you are using <a id="wrglossary.14617"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> then this field should be used in the <a id="wrglossary.14618"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file when defining abbreviations.<p>
+<div class="optionsummarybox"><a id="wrglossary.14619"></a><dfn id="glo:opt.gloskey.longaccess"><span class="csoptfmt">longaccess</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.14620"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of optionsummarybox -->
+<p>
+Accessibility text corresponding to the <a id="wrglossary.14621"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> field.<p>
+<div class="optionsummarybox"><a id="wrglossary.14622"></a><dfn id="glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">long-form</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+As <a id="wrglossary.14623"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> but the plural form.<p>
+<div class="optionsummarybox"><a id="wrglossary.14624"></a><dfn id="glo:opt.gloskey.longpluralaccess"><span class="csoptfmt">longpluralaccess</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.14625"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of optionsummarybox -->
+<p>
+Accessibility text corresponding to the <a id="wrglossary.14626"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> field.<p>
+<div class="optionsummarybox"><a id="wrglossary.14627"></a><dfn id="glo:opt.gloskey.name"><span class="csoptfmt">name</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The entry’s name, as displayed in the <a id="wrglossary.14628"></a><a href="#glo:dual.glossary">glossary</a>. This typically isn’t used outside of the <a id="wrglossary.14629"></a><a href="#glo:dual.glossary">glossary</a> (the <a id="wrglossary.14630"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> and <a id="wrglossary.14631"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> keys are used instead). However, if there is a need to specifically display the entry name, use <a id="wrglossary.14632"></a><a href="#glo:glsname"><code class="csfmt">\glsname</code></a> (if <a id="wrglossary.14633"></a><a href="#glo:dual.indexing">indexing</a> and hyperlinks are required) or <a id="wrglossary.14634"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a>. Glossary styles should use <a id="wrglossary.14635"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a>, which uses <a id="wrglossary.14636"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a> and incorporates the <a id="wrglossary.14637"></a><a href="#glo:dual.postnamehook">post-name hooks</a> and related <a id="wrglossary.14638"></a><a href="#glo:@@glslabel@categoryattribute">attributes</a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14639"></a><dfn id="glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">parent-label</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The label of the entry’s parent (from which the entry’s <a id="wrglossary.14640"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> is obtained).<p>
+<div class="optionsummarybox"><a id="wrglossary.14641"></a><dfn id="glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The entry’s plural form, as displayed on <a id="wrglossary.14642"></a><a href="#glo:dual.subsequentuse">subsequent use</a> of plural <a id="wrglossary.14643"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands, such as <a id="wrglossary.14644"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>. This should be the appropriate plural form of the value provided by the <a id="wrglossary.14645"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> key. If omitted, this value is assumed to be the value of the <a id="wrglossary.14646"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> key with <a id="wrglossary.14647"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a> appended.<p>
+<div class="optionsummarybox"><a id="wrglossary.14648"></a><dfn id="glo:opt.gloskey.pluralaccess"><span class="csoptfmt">pluralaccess</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.14649"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of optionsummarybox -->
+<p>
+Accessibility text corresponding to the <a id="wrglossary.14650"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> field. This field will be automatically set by <a id="wrglossary.14651"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>, if not provided and the <a id="wrglossary.14652"></a><a href="#glo:opt.catattr.textshortaccess"><span class="csoptfmt">textshortaccess</span></a> attribute is set. See §<a href="#sec:accessabbr">9.1</a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14653"></a><dfn id="glo:opt.gloskey.prefix"><span class="csoptfmt">prefix</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14654"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a> v3.14a+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The <a id="wrglossary.14655"></a><a href="#glo:dual.subsequentuse">subsequent use</a> singular prefix.<p>
+<div class="optionsummarybox"><a id="wrglossary.14656"></a><dfn id="glo:opt.gloskey.prefixfirst"><span class="csoptfmt">prefixfirst</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14657"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a> v3.14a+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The <a id="wrglossary.14658"></a><a href="#glo:dual.firstuse">first use</a> singular prefix.<p>
+<div class="optionsummarybox"><a id="wrglossary.14659"></a><dfn id="glo:opt.gloskey.prefixfirstplural"><span class="csoptfmt">prefixfirstplural</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14660"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a> v3.14a+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The <a id="wrglossary.14661"></a><a href="#glo:dual.firstuse">first use</a> plural prefix.<p>
+<div class="optionsummarybox"><a id="wrglossary.14662"></a><dfn id="glo:opt.gloskey.prefixplural"><span class="csoptfmt">prefixplural</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14663"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a> v3.14a+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The <a id="wrglossary.14664"></a><a href="#glo:dual.subsequentuse">subsequent use</a> plural prefix.<p>
+<div class="optionsummarybox"><a id="wrglossary.14665"></a><dfn id="glo:opt.gloskey.see"><span class="csoptfmt">see</span></dfn>=<code class="code">{[<span class="meta">〈<em class="metainner">tag</em>〉</span>]<span class="meta">〈<em class="metainner">xr-list</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+With the base <a id="wrglossary.14666"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package this simply triggers an automatic cross-reference with <a id="wrglossary.14667"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>. The <a id="wrglossary.14668"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package additionally saves the value. Use <a id="wrglossary.14669"></a><a href="#glo:opt.autoseeindex"><span class="styoptfmt">autoseeindex</span></a><span class="optfmt">=</span><a id="wrglossary.14670"></a><a href="#glo:optval.autoseeindex.false"><span class="optfmt">false</span></a> to prevent the automatic cross-reference. The <span class="meta">〈<em class="metainner">tag</em>〉</span> defaults to <a id="wrglossary.14671"></a><a href="#glo:seename"><code class="csfmt">\seename</code></a> and <span class="meta">〈<em class="metainner">xr-list</em>〉</span> should be a comma-separated list of entries that have already been defined.<p>
+<div class="optionsummarybox"><a id="wrglossary.14672"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a>=<code class="code">{<span class="meta">〈<em class="metainner">xr-list</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14673"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Behaves in a similar manner to <a id="wrglossary.14674"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={[<a id="wrglossary.14675"></a><a href="#glo:seealsoname"><code class="csfmt">\seealsoname</code></a>]<span class="meta">〈<em class="metainner">xr-list</em>〉</span>}</span>. <a href="#sec:newkeys">§3.2</a>; <a href="#wrglossary.951">33</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14676"></a><dfn id="glo:opt.gloskey.short"><span class="csoptfmt">short</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">short-form</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+A <a id="wrglossary.14677"></a><a href="#glo:dual.field">field</a> that is set by <a id="wrglossary.14678"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> (and <a id="wrglossary.14679"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>) to the entry’s short (abbreviated) form. It typically shouldn’t be used explicitly with <a id="wrglossary.14680"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> as <a id="wrglossary.14681"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> makes other modifications to ensure that when the entry is referenced with the <a id="wrglossary.14682"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands, it will obey the appropriate <a id="wrglossary.14683"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a>. If you are using <a id="wrglossary.14684"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> then this field should be used in the <a id="wrglossary.14685"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file when defining abbreviations.<p>
+<div class="optionsummarybox"><a id="wrglossary.14686"></a><dfn id="glo:opt.gloskey.shortaccess"><span class="csoptfmt">shortaccess</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.14687"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of optionsummarybox -->
+<p>
+Accessibility text corresponding to the <a id="wrglossary.14688"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> field. This field will be automatically set by <a id="wrglossary.14689"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>, if not provided. See §<a href="#sec:accessabbr">9.1</a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14690"></a><dfn id="glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">short-form</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+As <a id="wrglossary.14691"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> but the plural form. The default is obtained by appending the abbreviation plural suffix, but this behaviour can be altered by <a id="wrglossary.14692"></a><a href="#glo:idx.categoryattribute">category attributes</a>. See §<a href="#sec:abbreviations">4</a> for further details.<p>
+<div class="optionsummarybox"><a id="wrglossary.14693"></a><dfn id="glo:opt.gloskey.shortpluralaccess"><span class="csoptfmt">shortpluralaccess</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.14694"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of optionsummarybox -->
+<p>
+Accessibility text corresponding to the <a id="wrglossary.14695"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> field. This field will be automatically set by <a id="wrglossary.14696"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>, if not provided. See §<a href="#sec:accessabbr">9.1</a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14697"></a><dfn id="glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span><span class="meta">〈<em class="metainner">entry name</em>〉</span> <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Specifies the value to use for sorting (overrides the default). This key is usually required for <a id="wrglossary.14698"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> if the <a id="wrglossary.14699"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key only contains commands (for example, the entry is a symbol), but explicitly using this key in other contexts can break certain sort methods. <a href="https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-sorting">Don’t use the <a id="wrglossary.14700"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> field with <a id="wrglossary.14701"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> </a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14702"></a><dfn id="glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">symbol</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:relax"><code class="csfmt">\relax</code></a> <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The entry’s associated symbol (optional), which can be displayed with <a id="wrglossary.14703"></a><a href="#glo:glssymbol"><code class="csfmt">\glssymbol</code></a> (if <a id="wrglossary.14704"></a><a href="#glo:dual.indexing">indexing</a> and hyperlinks are required) or with <a id="wrglossary.14705"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14706"></a><dfn id="glo:opt.gloskey.symbolaccess"><span class="csoptfmt">symbolaccess</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.14707"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of optionsummarybox -->
+<p>
+Accessibility text corresponding to the <a id="wrglossary.14708"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> field.<p>
+<div class="optionsummarybox"><a id="wrglossary.14709"></a><dfn id="glo:opt.gloskey.symbolplural"><span class="csoptfmt">symbolplural</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">symbol plural</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The plural form of the <a id="wrglossary.14710"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a>, if applicable, which can be displayed with <a id="wrglossary.14711"></a><a href="#glo:glssymbolplural"><code class="csfmt">\glssymbolplural</code></a> (if <a id="wrglossary.14712"></a><a href="#glo:dual.indexing">indexing</a> and hyperlinks are required) or with <a id="wrglossary.14713"></a><a href="#glo:glsentrysymbolplural"><code class="csfmt">\glsentrysymbolplural</code></a>. If omitted, this value is set to the same as the <a id="wrglossary.14714"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> key (since symbols usually don’t have a plural form).<p>
+<div class="optionsummarybox"><a id="wrglossary.14715"></a><dfn id="glo:opt.gloskey.symbolpluralaccess"><span class="csoptfmt">symbolpluralaccess</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.14716"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of optionsummarybox -->
+<p>
+Accessibility text corresponding to the <a id="wrglossary.14717"></a><a href="#glo:opt.gloskey.symbolplural"><span class="csoptfmt">symbolplural</span></a> field.<p>
+<div class="optionsummarybox"><a id="wrglossary.14718"></a><dfn id="glo:opt.gloskey.text"><span class="csoptfmt">text</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The entry’s text, as displayed on <a id="wrglossary.14719"></a><a href="#glo:dual.subsequentuse">subsequent use</a> of <a id="wrglossary.14720"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands. If omitted, this value is assumed to be the same as the <a id="wrglossary.14721"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key.<p>
+<div class="optionsummarybox"><a id="wrglossary.14722"></a><dfn id="glo:opt.gloskey.textaccess"><span class="csoptfmt">textaccess</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.14723"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of optionsummarybox -->
+<p>
+Accessibility text corresponding to the <a id="wrglossary.14724"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field. This field will be automatically set by <a id="wrglossary.14725"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>, if not provided and the <a id="wrglossary.14726"></a><a href="#glo:opt.catattr.textshortaccess"><span class="csoptfmt">textshortaccess</span></a> attribute is set. See §<a href="#sec:accessabbr">9.1</a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14727"></a><dfn id="glo:opt.gloskey.type"><span class="csoptfmt">type</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner"><a id="wrglossary.14728"></a><a href="#glo:dual.glossary">glossary</a>-label</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a> <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Assigns the entry to the <a id="wrglossary.14729"></a><a href="#glo:dual.glossary">glossary</a> identified by <span class="meta">〈<em class="metainner"><a id="wrglossary.14730"></a><a href="#glo:dual.glossary">glossary</a>-label</em>〉</span>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14731"></a><dfn id="glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+A generic field, which can be displayed with <a id="wrglossary.14732"></a><a href="#glo:glsuseri"><code class="csfmt">\glsuseri</code></a> (if <a id="wrglossary.14733"></a><a href="#glo:dual.indexing">indexing</a> and hyperlinks are required) or with <a id="wrglossary.14734"></a><a href="#glo:glsentryuseri"><code class="csfmt">\glsentryuseri</code></a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14735"></a><dfn id="glo:opt.gloskey.user1access"><span class="csoptfmt">user1access</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14736"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> v4.45+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Accessibility text corresponding to the <a id="wrglossary.14737"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> field.<p>
+<div class="optionsummarybox"><a id="wrglossary.14738"></a><dfn id="glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+A generic field, which can be displayed with <a id="wrglossary.14739"></a><a href="#glo:glsuserii"><code class="csfmt">\glsuserii</code></a> (if <a id="wrglossary.14740"></a><a href="#glo:dual.indexing">indexing</a> and hyperlinks are required) or with <a id="wrglossary.14741"></a><a href="#glo:glsentryuserii"><code class="csfmt">\glsentryuserii</code></a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14742"></a><dfn id="glo:opt.gloskey.user2access"><span class="csoptfmt">user2access</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14743"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> v4.45+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Accessibility text corresponding to the <a id="wrglossary.14744"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a> field.<p>
+<div class="optionsummarybox"><a id="wrglossary.14745"></a><dfn id="glo:opt.gloskey.user3"><span class="csoptfmt">user3</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+A generic field, which can be displayed with <a id="wrglossary.14746"></a><a href="#glo:glsuseriii"><code class="csfmt">\glsuseriii</code></a> (if <a id="wrglossary.14747"></a><a href="#glo:dual.indexing">indexing</a> and hyperlinks are required) or with <a id="wrglossary.14748"></a><a href="#glo:glsentryuseriii"><code class="csfmt">\glsentryuseriii</code></a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14749"></a><dfn id="glo:opt.gloskey.user3access"><span class="csoptfmt">user3access</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14750"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> v4.45+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Accessibility text corresponding to the <a id="wrglossary.14751"></a><a href="#glo:opt.gloskey.user3"><span class="csoptfmt">user3</span></a> field.<p>
+<div class="optionsummarybox"><a id="wrglossary.14752"></a><dfn id="glo:opt.gloskey.user4"><span class="csoptfmt">user4</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+A generic field, which can be displayed with <a id="wrglossary.14753"></a><a href="#glo:glsuseriv"><code class="csfmt">\glsuseriv</code></a> (if <a id="wrglossary.14754"></a><a href="#glo:dual.indexing">indexing</a> and hyperlinks are required) or with <a id="wrglossary.14755"></a><a href="#glo:glsentryuseriv"><code class="csfmt">\glsentryuseriv</code></a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14756"></a><dfn id="glo:opt.gloskey.user4access"><span class="csoptfmt">user4access</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14757"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> v4.45+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Accessibility text corresponding to the <a id="wrglossary.14758"></a><a href="#glo:opt.gloskey.user4"><span class="csoptfmt">user4</span></a> field.<p>
+<div class="optionsummarybox"><a id="wrglossary.14759"></a><dfn id="glo:opt.gloskey.user5"><span class="csoptfmt">user5</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+A generic field, which can be displayed with <a id="wrglossary.14760"></a><a href="#glo:glsuserv"><code class="csfmt">\glsuserv</code></a> (if <a id="wrglossary.14761"></a><a href="#glo:dual.indexing">indexing</a> and hyperlinks are required) or with <a id="wrglossary.14762"></a><a href="#glo:glsentryuserv"><code class="csfmt">\glsentryuserv</code></a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14763"></a><dfn id="glo:opt.gloskey.user5access"><span class="csoptfmt">user5access</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14764"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> v4.45+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Accessibility text corresponding to the <a id="wrglossary.14765"></a><a href="#glo:opt.gloskey.user5"><span class="csoptfmt">user5</span></a> field.<p>
+<div class="optionsummarybox"><a id="wrglossary.14766"></a><dfn id="glo:opt.gloskey.user6"><span class="csoptfmt">user6</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+A generic field, which can be displayed with <a id="wrglossary.14767"></a><a href="#glo:glsuservi"><code class="csfmt">\glsuservi</code></a> (if <a id="wrglossary.14768"></a><a href="#glo:dual.indexing">indexing</a> and hyperlinks are required) or with <a id="wrglossary.14769"></a><a href="#glo:glsentryuservi"><code class="csfmt">\glsentryuservi</code></a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14770"></a><dfn id="glo:opt.gloskey.user6access"><span class="csoptfmt">user6access</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14771"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> v4.45+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Accessibility text corresponding to the <a id="wrglossary.14772"></a><a href="#glo:opt.gloskey.user6"><span class="csoptfmt">user6</span></a> field.<p>
+
+</section><!-- end of section sec:gloskeys -->
+
+<section id="idx.glosfield-optionsummary"><!-- start of section idx.glosfield-optionsummary --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->Glossary Entry Fields Summary<div class="labellink"><a href="#idx.glosfield-optionsummary">[link]</a></div></h1><!-- end of chapter header -->
+<a id="wrglossary.14773"></a>These are internal fields that don’t have a corresponding <a id="wrglossary.14774"></a><a href="#glo:@@glslabel@gloskey">key</a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14775"></a><dfn id="glo:opt.glosfield.childcount"><span class="csoptfmt">childcount</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">number</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Used with the <a id="wrglossary.14776"></a><a href="#glo:opt.resource.save-child-count"><span class="csoptfmt">save-child-count</span></a> resource option to store the entry’s child count.<p>
+<div class="optionsummarybox"><a id="wrglossary.14777"></a><dfn id="glo:opt.glosfield.childlist"><span class="csoptfmt">childlist</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">entry-label-list</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Used with the <a id="wrglossary.14778"></a><a href="#glo:opt.resource.save-child-count"><span class="csoptfmt">save-child-count</span></a> resource option to store the entry’s children as an <a id="wrglossary.14779"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span></a> internal list.<p>
+<div class="optionsummarybox"><a id="wrglossary.14780"></a><dfn id="glo:opt.glosfield.indexcounter"><span class="csoptfmt">indexcounter</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">target-name</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Used with the <a id="wrglossary.14781"></a><a href="#glo:opt.indexcounter"><span class="styoptfmt">indexcounter</span></a> package option and the <a id="wrglossary.14782"></a><a href="#glo:opt.resource.save-index-counter"><span class="csoptfmt">save-index-counter</span></a> resource option. The value is set to the hyperlink target of the first <a id="wrglossary.14783"></a><a href="#glo:ctr.wrglossary"><span class="ctrfmt">wrglossary</span></a> <a id="wrglossary.14784"></a><a href="#glo:@@glslabel@entrylocation">location</a> or the first instance for a specific <a id="wrglossary.14785"></a><a href="#glo:dual.locationencap">location encap</a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14786"></a><dfn id="glo:opt.glosfield.loclist"><span class="csoptfmt">loclist</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner"><a id="wrglossary.14787"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span></a> list</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14788"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.04+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Used by <a id="wrglossary.14789"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a> to provide the locations. The value is an <a id="wrglossary.14790"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span></a> list of individual locations which are obtained from the <a id="wrglossary.14791"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file. This field will also be used by the <a id="wrglossary.14792"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> if <a id="wrglossary.14793"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a> isn’t set.<p>
+<div class="optionsummarybox"><a id="wrglossary.14794"></a><dfn id="glo:opt.glosfield.recordcount"><span class="csoptfmt">recordcount</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">number</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Used with the <a id="wrglossary.14795"></a><a href="#glo:switch.record-count"><span class="longargfmt">--record-count</span></a> switch to store the total number of <a id="wrglossary.14796"></a><a href="#glo:@@glslabel@indexing">records</a> for the associated entry.<p>
+<div class="optionsummarybox"><a id="wrglossary.14797"></a><dfn id="glo:opt.glosfield.recordcount.counter"><span class="csoptfmt">recordcount.<span class="meta">〈<em class="metainner">counter</em>〉</span></span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">number</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Used with the <a id="wrglossary.14798"></a><a href="#glo:switch.record-count"><span class="longargfmt">--record-count</span></a> switch to store the total number of <a id="wrglossary.14799"></a><a href="#glo:@@glslabel@indexing">records</a> with the <a id="wrglossary.14800"></a><a href="#glo:dual.locationcounter">location counter</a> <span class="meta">〈<em class="metainner">counter</em>〉</span> for the associated entry.<p>
+<div class="optionsummarybox"><a id="wrglossary.14801"></a><dfn id="glo:opt.glosfield.recordcount.counter.location"><span class="csoptfmt">recordcount.<span class="meta">〈<em class="metainner">counter</em>〉</span>.<span class="meta">〈<em class="metainner">location</em>〉</span></span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">number</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Used with the <a id="wrglossary.14802"></a><a href="#glo:switch.record-count-unit"><span class="longargfmt">--record-count-unit</span></a> switch to store the total number of <a id="wrglossary.14803"></a><a href="#glo:@@glslabel@indexing">records</a> with the <a id="wrglossary.14804"></a><a href="#glo:dual.locationcounter">location counter</a> <span class="meta">〈<em class="metainner">counter</em>〉</span> set to <span class="meta">〈<em class="metainner">location</em>〉</span> for the associated entry.<p>
+<div class="optionsummarybox"><a id="wrglossary.14805"></a><dfn id="glo:opt.glosfield.record.counter"><span class="csoptfmt">record.<span class="meta">〈<em class="metainner">counter</em>〉</span></span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Used with <a id="wrglossary.14806"></a><a href="#glo:GlsXtrRecordCounter"><code class="csfmt">\GlsXtrRecordCounter</code></a> to store an <a id="wrglossary.14807"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span></a> internal list of locations (without encap) corresponding to the given counter.<p>
+<div class="optionsummarybox"><a id="wrglossary.14808"></a><dfn id="glo:opt.glosfield.secondarygroup"><span class="csoptfmt">secondarygroup</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Used by <a id="wrglossary.14809"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to store the <a id="wrglossary.14810"></a><a href="#glo:idx.group">group</a> label obtained from the secondary sort.<p>
+
+</section><!-- end of section idx.glosfield-optionsummary -->
+
+<section id="idx.glsopt-optionsummary"><!-- start of section idx.glsopt-optionsummary --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header --><code class="csfmt">\Gls</code>-Like and <code class="csfmt">\Glstext</code>-Like Options Summary<div class="labellink"><a href="#idx.glsopt-optionsummary">[link]</a></div></h1><!-- end of chapter header -->
+<a id="wrglossary.14811"></a>Most (but not all) of these options can be used in the optional argument of all the <a id="wrglossary.14812"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a>, <a id="wrglossary.14813"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> and <a id="wrglossary.14814"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> commands.<p>
+<div class="optionsummarybox"><a id="wrglossary.14815"></a><dfn id="glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">counter-name</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14816"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The <a id="wrglossary.14817"></a><a href="#glo:dual.locationcounter">location counter</a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14818"></a><dfn id="glo:opt.glsopt.format"><span class="csoptfmt">format</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">cs-name</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14819"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The control sequence name (without the leading backslash) that should be used to <a id="wrglossary.14820"></a><a href="#glo:@@glslabel@locationencap">encapsulate</a> the <a id="wrglossary.14821"></a><a href="#glo:dual.entrylocation">entry location</a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14822"></a><dfn id="glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true <a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a><a id="wrglossary.14823"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Determines whether or not the <a id="wrglossary.14824"></a><a href="#glo:dual.linktext">link text</a> should have a hyperlink (provided hyperlinks are supported).<p>
+<div class="optionsummarybox"><a id="wrglossary.14825"></a><a href="#glo:opt.glsopt.hyperoutside"><span class="csoptfmt">hyperoutside</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true <a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a><a id="wrglossary.14826"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Determines whether the hyperlink should be inside or outside of <a id="wrglossary.14827"></a><a href="#glo:glstextformat"><code class="csfmt">\glstextformat</code></a>. <a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.4819">190</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14828"></a><a href="#glo:opt.glsopt.innertextformat"><span class="csoptfmt">innertextformat</span></a>=<code class="code"><span class="meta">〈<em class="metainner">csname</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>glsxtrdefaultentrytextfmt <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14829"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The name of the control sequence to use for the <a id="wrglossary.14830"></a><a href="#glo:dual.innerformatting">inner formatting</a>. <a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.4829">191</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14831"></a><dfn id="glo:opt.glsopt.local"><span class="csoptfmt">local</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a><a id="wrglossary.14832"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.04+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+If true use <a id="wrglossary.14833"></a><a href="#glo:glslocalunset"><code class="csfmt">\glslocalunset</code></a> to unset the <a id="wrglossary.14834"></a><a href="#glo:dual.firstuseflag">first use flag</a>, otherwise use <a id="wrglossary.14835"></a><a href="#glo:glsunset"><code class="csfmt">\glsunset</code></a> (only applies to <a id="wrglossary.14836"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands).<p>
+<div class="optionsummarybox"><a id="wrglossary.14837"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a><a id="wrglossary.14838"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+If <span class="optfmt">true</span> this option will suppress <a id="wrglossary.14839"></a><a href="#glo:dual.indexing">indexing</a>. If you are using <a id="wrglossary.14840"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, you may want to consider using <a id="wrglossary.14841"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=glsignore</span> to prevent a <a id="wrglossary.14842"></a><a href="#glo:@@glslabel@entrylocation">location</a> but ensure that the entry is selected. <a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.4900">193</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14843"></a><a href="#glo:opt.glsopt.postunset"><span class="csoptfmt">postunset</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>global; <span class="summarytag">initial: </span>global <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14844"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Determines whether or not to unset the <a id="wrglossary.14845"></a><a href="#glo:dual.firstuseflag">first use flag</a> after the <a id="wrglossary.14846"></a><a href="#glo:dual.linktext">link text</a>. The value may be one of: <code class="code">global</code>, <code class="code">local</code> or <code class="code">none</code> (only applies to <a id="wrglossary.14847"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands). <a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.4836">191</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14848"></a><a href="#glo:opt.glsopt.prefix"><span class="csoptfmt">prefix</span></a>=<code class="code"><span class="meta">〈<em class="metainner">link-prefix</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14849"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The prefix to use for the entry’s hyperlink target. <a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.4984">196</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14850"></a><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>local; <span class="summarytag">initial: </span>none <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14851"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Determines whether or not to reset the entry before the <a id="wrglossary.14852"></a><a href="#glo:dual.linktext">link text</a>. Allowed values: <span class="optfmt">none</span> (no reset), <span class="optfmt">local</span> (localise the reset) and <span class="optfmt">global</span>. <a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.4844">191</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14853"></a><a href="#glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>local; <span class="summarytag">initial: </span>none <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14854"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Determines whether or not to unset the entry before the <a id="wrglossary.14855"></a><a href="#glo:dual.linktext">link text</a>. Allowed values: <span class="optfmt">none</span> (no unset), <span class="optfmt">local</span> (localise the unset) and <span class="optfmt">global</span>. <a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.4875">192</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14856"></a><a href="#glo:opt.glsopt.textformat"><span class="csoptfmt">textformat</span></a>=<code class="code"><span class="meta">〈<em class="metainner">csname</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14857"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.30+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The name of the control sequence to use instead of <a id="wrglossary.14858"></a><a href="#glo:glstextformat"><code class="csfmt">\glstextformat</code></a> to encapsulate the <a id="wrglossary.14859"></a><a href="#glo:dual.linktext">link text</a>. <a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.4824">190</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14860"></a><a href="#glo:opt.glsopt.theHvalue"><span class="csoptfmt">theHvalue</span></a>=<code class="code"><span class="meta">〈<em class="metainner">the-H-value</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14861"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.19+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Set the hyper <a id="wrglossary.14862"></a><a href="#glo:@@glslabel@entrylocation">location</a> to this value instead of obtaining it from <a id="wrglossary.14863"></a><a href="#glo:theHcounter"><code class="csfmt">\theH<span class="meta">〈<em class="metainner">counter</em>〉</span></code></a>. <a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.4971">196</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14864"></a><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a>=<code class="code"><span class="meta">〈<em class="metainner">location</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14865"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.19+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Set the <a id="wrglossary.14866"></a><a href="#glo:@@glslabel@entrylocation">location</a> to this value instead of obtaining it from the <a id="wrglossary.14867"></a><a href="#glo:dual.locationcounter">location counter</a>. <a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.4941">194</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14868"></a><dfn id="glo:opt.glsopt.types"><span class="csoptfmt">types</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">glossary list</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14869"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Only available with <a id="wrglossary.14870"></a><a href="#glo:glsaddall"><code class="csfmt">\glsaddall</code></a>, the value is the list of glossaries to iterate over.<p>
+<div class="optionsummarybox"><a id="wrglossary.14871"></a><a href="#glo:opt.glsopt.wrgloss"><span class="csoptfmt">wrgloss</span></a>=<code class="code"><span class="meta">〈<em class="metainner">position</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>before <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14872"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.14+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Determines whether to do the <a id="wrglossary.14873"></a><a href="#glo:dual.indexing">indexing</a> before or after the <a id="wrglossary.14874"></a><a href="#glo:dual.linktext">link text</a>. Allowed values: <span class="optfmt">before</span> and <span class="optfmt">after</span>. <a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.4921">194</a><p>
+
+</section><!-- end of section idx.glsopt-optionsummary -->
+
+<section id="idx.mglsopt-optionsummary"><!-- start of section idx.mglsopt-optionsummary --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->Multi-Entry Set Options Summary<div class="labellink"><a href="#idx.mglsopt-optionsummary">[link]</a></div></h1><!-- end of chapter header -->
+<a id="wrglossary.14875"></a><p>
+<div class="optionsummarybox"><a id="wrglossary.14876"></a><a href="#glo:opt.mglsopt.all"><span class="csoptfmt">all</span></a>=<code class="code"><span class="meta">〈<em class="metainner">option list</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Options to pass to the <a id="wrglossary.14877"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> command for each element. <a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.8970">360</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14878"></a><a href="#glo:opt.mglsopt.category"><span class="csoptfmt">category</span></a>=<code class="code"><span class="meta">〈<em class="metainner">category-label</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The category to assign to the multi-entry set. <a href="#sec:multiglsoptionsgeneral">§7.9.6</a>; <a href="#wrglossary.8939">359</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14879"></a><a href="#glo:opt.mglsopt.encapmain"><span class="csoptfmt">encapmain</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>glsnumberformat <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The value to pass to the <a id="wrglossary.14880"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a> option for the main entry. <a href="#sec:multiglsoptionsencap">§7.9.2</a>; <a href="#wrglossary.8886">355</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14881"></a><a href="#glo:opt.mglsopt.encapothers"><span class="csoptfmt">encapothers</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>glsnumberformat <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The value to pass to the <a id="wrglossary.14882"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a> option for the <span class="qt">“other”</span> elements. <a href="#sec:multiglsoptionsencap">§7.9.2</a>; <a href="#wrglossary.8889">355</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14883"></a><a href="#glo:opt.mglsopt.firstprefix"><span class="csoptfmt">firstprefix</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The prefix to use on <a id="wrglossary.14884"></a><a href="#glo:dual.firstuse">first use</a> of the multi-entry. <a href="#sec:multiglsoptionsfixes">§7.9.4</a>; <a href="#wrglossary.8915">357</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14885"></a><a href="#glo:opt.mglsopt.firstskipmain"><span class="csoptfmt">firstskipmain</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Determines whether or not to skip the main entry on <a id="wrglossary.14886"></a><a href="#glo:dual.mfirstuse">first use</a>. <a href="#sec:multiglsoptionsskip">§7.9.5</a>; <a href="#wrglossary.8923">358</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14887"></a><a href="#glo:opt.mglsopt.firstskipothers"><span class="csoptfmt">firstskipothers</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Determines whether or not to skip the <span class="qt">“other”</span> elements on <a id="wrglossary.14888"></a><a href="#glo:dual.mfirstuse">first use</a>. <a href="#sec:multiglsoptionsskip">§7.9.5</a>; <a href="#wrglossary.8925">358</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14889"></a><a href="#glo:opt.mglsopt.firstsuffix"><span class="csoptfmt">firstsuffix</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The suffix to use on <a id="wrglossary.14890"></a><a href="#glo:dual.mfirstuse">first use</a> of the multi-entry. <a href="#sec:multiglsoptionsfixes">§7.9.4</a>; <a href="#wrglossary.8919">357</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14891"></a><a href="#glo:opt.mglsopt.hyper"><span class="csoptfmt">hyper</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Indicates whether or not to use hyperlinks, if supported, for all elements. This option is for use in the optional argument of <a id="wrglossary.14892"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> and can be set implicitly with the default behaviour of the <a id="wrglossary.14893"></a><a href="#glo:idx.mod.star">*</a> and <a id="wrglossary.14894"></a><a href="#glo:idx.mod.plus">+</a> modifiers. <a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.8982">361</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14895"></a><a href="#glo:opt.mglsopt.multi.hyper">hyper</a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>individual <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Indicates which elements should have hyperlinks, if supported. This option is a multi-entry setting, see §<a href="#sec:multiglsoptions">7.9</a>. <a href="#sec:multiglsoptionsgeneral">§7.9.6</a>; <a href="#wrglossary.8934">358</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14896"></a><a href="#glo:opt.mglsopt.indexmain"><span class="csoptfmt">indexmain</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Indicates if the main element should be <a id="wrglossary.14897"></a><a href="#glo:@@glslabel@indexing">indexed</a>, should only be <a id="wrglossary.14898"></a><a href="#glo:@@glslabel@indexing">indexed</a> on <a id="wrglossary.14899"></a><a href="#glo:dual.firstuse">first use</a> or should not indexed. <a href="#sec:multiglsoptionsindexing">§7.9.1</a>; <a href="#wrglossary.8882">355</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14900"></a><a href="#glo:opt.mglsopt.indexothers"><span class="csoptfmt">indexothers</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Indicates if the <span class="qt">“other”</span> elements should be <a id="wrglossary.14901"></a><a href="#glo:@@glslabel@indexing">indexed</a>, should only be <a id="wrglossary.14902"></a><a href="#glo:@@glslabel@indexing">indexed</a> on <a id="wrglossary.14903"></a><a href="#glo:dual.firstuse">first use</a> or should not indexed. <a href="#sec:multiglsoptionsindexing">§7.9.1</a>; <a href="#wrglossary.8884">355</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14904"></a><a href="#glo:opt.mglsopt.main"><span class="csoptfmt">main</span></a>=<code class="code"><span class="meta">〈<em class="metainner">option list</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Options to pass to the <a id="wrglossary.14905"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> command for the main entry. <a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.8974">360</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14906"></a><a href="#glo:opt.mglsopt.mglsopts"><span class="csoptfmt">mglsopts</span></a>=<code class="code"><span class="meta">〈<em class="metainner">option list</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The default options to pass to commands like <a id="wrglossary.14907"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a>. <a href="#sec:multiglsoptionsgeneral">§7.9.6</a>; <a href="#wrglossary.8940">359</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14908"></a><a href="#glo:opt.mglsopt.mpostlink"><span class="csoptfmt">mpostlink</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Indicates whether or not the multi-entry post-link hook should be enabled and, if so, whether it should only be enabled on <a id="wrglossary.14909"></a><a href="#glo:@@glslabel@mfirstuse">first</a> or <a id="wrglossary.14910"></a><a href="#glo:@@glslabel@msubsequentuse">subsequent</a> use. <a href="#sec:multiglsoptionspostlink">§7.9.3</a>; <a href="#wrglossary.8903">356</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14911"></a><a href="#glo:opt.mglsopt.mpostlinkelement"><span class="csoptfmt">mpostlinkelement</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>last <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Indicates which <a id="wrglossary.14912"></a><a href="#glo:dual.postlinkhook">post-link hook</a> to use if the multi-entry post-link hook has been enabled. <a href="#sec:multiglsoptionspostlink">§7.9.3</a>; <a href="#wrglossary.8906">356</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14913"></a><a href="#glo:opt.mglsopt.multiunset"><span class="csoptfmt">multiunset</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>global <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Indicates whether or not the <a id="wrglossary.14914"></a><a href="#glo:dual.mfirstuseflag">multi-entry first use flag</a> should be unset. <a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.8984">361</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14915"></a><a href="#glo:opt.mglsopt.others"><span class="csoptfmt">others</span></a>=<code class="code"><span class="meta">〈<em class="metainner">option list</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Options to pass to the <a id="wrglossary.14916"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> command for the <span class="qt">“other”</span> elements. <a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.8978">360</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14917"></a><a href="#glo:opt.mglsopt.postlinks"><span class="csoptfmt">postlinks</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>none <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Indicates which <a id="wrglossary.14918"></a><a href="#glo:dual.postlinkhook">post-link hooks</a> should be enabled. <a href="#sec:multiglsoptionspostlink">§7.9.3</a>; <a href="#wrglossary.8892">356</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14919"></a><a href="#glo:opt.mglsopt.presetlocal"><span class="csoptfmt">presetlocal</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Indicates whether or not the prereset options should have a local or global effect. <a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.8987">361</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14920"></a><a href="#glo:opt.mglsopt.resetall"><span class="csoptfmt">resetall</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Indicates whether or not to reset all elements’ <a id="wrglossary.14921"></a><a href="#glo:dual.firstuseflag">first use flag</a> before using <a id="wrglossary.14922"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. <a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.8988">361</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14923"></a><a href="#glo:opt.mglsopt.resetmain"><span class="csoptfmt">resetmain</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Indicates whether or not to reset the main entry’s <a id="wrglossary.14924"></a><a href="#glo:dual.firstuseflag">first use flag</a> before using <a id="wrglossary.14925"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. <a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.8994">361</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14926"></a><a href="#glo:opt.mglsopt.resetothers"><span class="csoptfmt">resetothers</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Indicates whether or not to reset all <span class="qt">“other”</span> elements’ <a id="wrglossary.14927"></a><a href="#glo:dual.firstuseflag">first use flag</a> before using <a id="wrglossary.14928"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. <a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.8997">361</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14929"></a><a href="#glo:opt.mglsopt.setup"><span class="csoptfmt">setup</span></a>=<code class="code"><span class="meta">〈<em class="metainner">option list</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Multi-entry options that will override any conflicting options already assigned to the multi-entry. <a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.8965">360</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14930"></a><a href="#glo:opt.mglsopt.textformat"><span class="csoptfmt">textformat</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>@firstofone <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The control sequence name of the command that should encapsulate the entire content. <a href="#sec:multiglsoptionsgeneral">§7.9.6</a>; <a href="#wrglossary.8938">359</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14931"></a><a href="#glo:opt.mglsopt.unsetall"><span class="csoptfmt">unsetall</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Indicates whether or not to unset all elements’ <a id="wrglossary.14932"></a><a href="#glo:dual.firstuseflag">first use flag</a> before using <a id="wrglossary.14933"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. <a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.9000">362</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14934"></a><a href="#glo:opt.mglsopt.unsetmain"><span class="csoptfmt">unsetmain</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Indicates whether or not to unset the main entry’s <a id="wrglossary.14935"></a><a href="#glo:dual.firstuseflag">first use flag</a> before using <a id="wrglossary.14936"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. <a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.9006">362</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14937"></a><a href="#glo:opt.mglsopt.unsetothers"><span class="csoptfmt">unsetothers</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Indicates whether or not to unset all <span class="qt">“other”</span> elements’ <a id="wrglossary.14938"></a><a href="#glo:dual.firstuseflag">first use flag</a> before using <a id="wrglossary.14939"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. <a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.9009">362</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14940"></a><a href="#glo:opt.mglsopt.usedprefix"><span class="csoptfmt">usedprefix</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The prefix to use on <a id="wrglossary.14941"></a><a href="#glo:dual.subsequentuse">subsequent use</a> of the multi-entry. <a href="#sec:multiglsoptionsfixes">§7.9.4</a>; <a href="#wrglossary.8917">357</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14942"></a><a href="#glo:opt.mglsopt.usedskipmain"><span class="csoptfmt">usedskipmain</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Determines whether or not to skip the main entry on <a id="wrglossary.14943"></a><a href="#glo:dual.msubsequentuse">subsequent use</a>. <a href="#sec:multiglsoptionsskip">§7.9.5</a>; <a href="#wrglossary.8927">358</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14944"></a><a href="#glo:opt.mglsopt.usedskipothers"><span class="csoptfmt">usedskipothers</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Determines whether or not to skip the <span class="qt">“other”</span> elements on <a id="wrglossary.14945"></a><a href="#glo:dual.msubsequentuse">subsequent use</a>. <a href="#sec:multiglsoptionsskip">§7.9.5</a>; <a href="#wrglossary.8929">358</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14946"></a><a href="#glo:opt.mglsopt.usedsuffix"><span class="csoptfmt">usedsuffix</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+The suffix to use on <a id="wrglossary.14947"></a><a href="#glo:dual.msubsequentuse">subsequent use</a> of the multi-entry. <a href="#sec:multiglsoptionsfixes">§7.9.4</a>; <a href="#wrglossary.8921">357</a><p>
+
+</section><!-- end of section idx.mglsopt-optionsummary -->
+
+<section id="idx.printglossopt-optionsummary"><!-- start of section idx.printglossopt-optionsummary --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->Print [Unsrt|noidx] Glossary Options Summary<div class="labellink"><a href="#idx.printglossopt-optionsummary">[link]</a></div></h1><!-- end of chapter header -->
+<a id="wrglossary.14948"></a>Most (but not all) of these options can be used in the optional argument of all the print <a id="wrglossary.14949"></a><a href="#glo:dual.glossary">glossary</a> commands: <a id="wrglossary.14950"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>, <a id="wrglossary.14951"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>, <a id="wrglossary.14952"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> and <a id="wrglossary.14953"></a><a href="#glo:printunsrtinnerglossary"><code class="csfmt">\printunsrtinnerglossary</code></a>. Some may be used in the optional argument of the <a id="wrglossary.14954"></a><a href="#glo:env.printunsrtglossarywrap"><span class="envfmt">printunsrtglossarywrap</span></a> environment.<p>
+<div class="optionsummarybox"><a id="wrglossary.14955"></a><dfn id="glo:opt.printgloss.entrycounter"><span class="csoptfmt">entrycounter</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a><a id="wrglossary.14956"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.08+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+If true, enable the entry counter.<p>
+<div class="optionsummarybox"><a id="wrglossary.14957"></a><a href="#glo:opt.printgloss.flatten"><span class="csoptfmt">flatten</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a><a id="wrglossary.14958"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+If true, treats all entries as though they have the same hierarchical level (the value of <a id="wrglossary.14959"></a><a href="#glo:opt.printgloss.leveloffset"><span class="csoptfmt">leveloffset</span></a>). This option is only available for the <a id="wrglossary.14960"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> and the <a id="wrglossary.14961"></a><a href="#glo:env.printunsrtglossarywrap"><span class="envfmt">printunsrtglossarywrap</span></a> environment. <a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9564">379</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14962"></a><a href="#glo:opt.printgloss.groups"><span class="csoptfmt">groups</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true <a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a><a id="wrglossary.14963"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.44+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Enables <a id="wrglossary.14964"></a><a href="#glo:idx.group">group</a> formation. This option is only available for the <a id="wrglossary.14965"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> and the <a id="wrglossary.14966"></a><a href="#glo:env.printunsrtglossarywrap"><span class="envfmt">printunsrtglossarywrap</span></a> environment. Note that no <a id="wrglossary.14967"></a><a href="#glo:idx.group">groups</a> will be formed when invoking <a id="wrglossary.14968"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> with the default <a id="wrglossary.14969"></a><a href="#glo:switch.no-group"><span class="longargfmt">--no-group</span></a>, regardless of this setting. <a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9571">379</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14970"></a><a href="#glo:opt.printgloss.label"><span class="csoptfmt">label</span></a>=<code class="code"><span class="meta">〈<em class="metainner">label</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14971"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.39+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Adds <code class="code"><a id="wrglossary.14972"></a><a href="#glo:label"><code class="csfmt">\label</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> to the start of the <a id="wrglossary.14973"></a><a href="#glo:dual.glossary">glossary</a> (after the title). <a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9548">378</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14974"></a><a href="#glo:opt.printgloss.leveloffset"><span class="csoptfmt">leveloffset</span></a>=<code class="code"><span class="meta">〈<em class="metainner">offset</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>0 <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14975"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.44+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Set or increment the <a id="wrglossary.14976"></a><a href="#glo:hierarchicallevel">hierarchical level</a> offset. If <span class="meta">〈<em class="metainner">offset</em>〉</span> starts with <code class="code">++</code> then the current offset is incremented by the given amount otherwise the current offset is set to <span class="meta">〈<em class="metainner">offset</em>〉</span>. For example, an entry with a normal <a id="wrglossary.14977"></a><a href="#glo:hierarchicallevel">hierarchical level</a> of 1 will be treated as though it has <a id="wrglossary.14978"></a><a href="#glo:hierarchicallevel">hierarchical level</a> 1+<span class="meta">〈<em class="metainner">offset</em>〉</span>. This option is only available for the <a id="wrglossary.14979"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> and the <a id="wrglossary.14980"></a><a href="#glo:env.printunsrtglossarywrap"><span class="envfmt">printunsrtglossarywrap</span></a> environment. <a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9556">379</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14981"></a><dfn id="glo:opt.printgloss.nogroupskip"><span class="csoptfmt">nogroupskip</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Suppress the gap implemented by some <a id="wrglossary.14982"></a><a href="#glo:idx.glossarystyle">glossary styles</a> between <a id="wrglossary.14983"></a><a href="#glo:idx.group">groups</a>.<p>
+<div class="optionsummarybox"><a id="wrglossary.14984"></a><dfn id="glo:opt.printgloss.nonumberlist"><span class="csoptfmt">nonumberlist</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Suppress the <a id="wrglossary.14985"></a><a href="#glo:locationlist">location list</a>. Note that <a id="wrglossary.14986"></a><a href="#glo:opt.printgloss.nonumberlist"><span class="csoptfmt">nonumberlist</span></a><span class="optfmt">=false</span> will have no effect with the <a id="wrglossary.14987"></a><a href="#glo:opt.resource.save-locations"><span class="csoptfmt">save-locations</span></a>false <a id="wrglossary.14988"></a><a href="#glo:idx.resourceopt">resource option</a> as there won’t be any <a id="wrglossary.14989"></a><a href="#glo:locationlist">location lists</a> to display.<p>
+<div class="optionsummarybox"><a id="wrglossary.14990"></a><dfn id="glo:opt.printgloss.nopostdot"><span class="csoptfmt">nopostdot</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Suppress the post-description punctuation.<p>
+<div class="optionsummarybox"><a id="wrglossary.14991"></a><a href="#glo:opt.printgloss.numberedsection"><span class="csoptfmt">numberedsection</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>nolabel; <span class="summarytag">initial: </span>false <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Indicates whether or not <a id="wrglossary.14992"></a><a href="#glo:dual.glossary">glossary</a> section headers will be numbered and also if they should automatically be labelled. The <a id="wrglossary.14993"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a> package option will change the default setting to match. <a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9537">378</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14994"></a><a href="#glo:opt.printgloss.postamble"><span class="csoptfmt">postamble</span></a>=<code class="code"><span class="meta">〈<em class="metainner">text</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14995"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Redefines <a id="wrglossary.14996"></a><a href="#glo:glossarypostamble"><code class="csfmt">\glossarypostamble</code></a> to <span class="meta">〈<em class="metainner">text</em>〉</span>. <a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9637">382</a><p>
+<div class="optionsummarybox"><a id="wrglossary.14997"></a><a href="#glo:opt.printgloss.preamble"><span class="csoptfmt">preamble</span></a>=<code class="code"><span class="meta">〈<em class="metainner">text</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.14998"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Redefines <a id="wrglossary.14999"></a><a href="#glo:glossarypreamble"><code class="csfmt">\glossarypreamble</code></a> to <span class="meta">〈<em class="metainner">text</em>〉</span>. <a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9635">382</a><p>
+<div class="optionsummarybox"><a id="wrglossary.15000"></a><a href="#glo:opt.printgloss.prefix"><span class="csoptfmt">prefix</span></a>=<code class="code"><span class="meta">〈<em class="metainner">prefix</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.15001"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Redefines <a id="wrglossary.15002"></a><a href="#glo:glolinkprefix"><code class="csfmt">\glolinkprefix</code></a> to <span class="meta">〈<em class="metainner">prefix</em>〉</span>. <a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9576">379</a><p>
+<div class="optionsummarybox"><a id="wrglossary.15003"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a>=<code class="code"><span class="meta">〈<em class="metainner">method</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Only available with <a id="wrglossary.15004"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>, this indicates how the <a id="wrglossary.15005"></a><a href="#glo:dual.glossary">glossary</a> should be ordered. <a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9517">377</a><p>
+<div class="optionsummarybox"><a id="wrglossary.15006"></a><a href="#glo:opt.printgloss.style"><span class="csoptfmt">style</span></a>=<code class="code"><span class="meta">〈<em class="metainner">style-name</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Use the <span class="meta">〈<em class="metainner">style-name</em>〉</span> <a id="wrglossary.15007"></a><a href="#glo:idx.glossarystyle">glossary style</a>. <a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9544">378</a><p>
+<div class="optionsummarybox"><a id="wrglossary.15008"></a><dfn id="glo:opt.printgloss.subentrycounter"><span class="csoptfmt">subentrycounter</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a><a id="wrglossary.15009"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.08+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+If true, enable the sub-entry counter.<p>
+<div class="optionsummarybox"><a id="wrglossary.15010"></a><a href="#glo:opt.printgloss.target"><span class="csoptfmt">target</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true <a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a><a id="wrglossary.15011"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+If true, each entry in the <a id="wrglossary.15012"></a><a href="#glo:dual.glossary">glossary</a> should have a hypertarget created, if supported by the <a id="wrglossary.15013"></a><a href="#glo:idx.glossarystyle">glossary style</a> and if hyperlinks are enabled. <a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9632">382</a><p>
+<div class="optionsummarybox"><a id="wrglossary.15014"></a><a href="#glo:opt.printgloss.targetnameprefix"><span class="csoptfmt">targetnameprefix</span></a>=<code class="code"><span class="meta">〈<em class="metainner">prefix</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.15015"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.20+</span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Inserts <span class="meta">〈<em class="metainner">prefix</em>〉</span> at the start of the hypertarget names. <a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9615">381</a><p>
+<div class="optionsummarybox"><a id="wrglossary.15016"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a>=<code class="code"><span class="meta">〈<em class="metainner">text</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Sets the glossary title (overriding the default). <a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9525">378</a><p>
+<div class="optionsummarybox"><a id="wrglossary.15017"></a><a href="#glo:opt.printgloss.toctitle"><span class="csoptfmt">toctitle</span></a>=<code class="code"><span class="meta">〈<em class="metainner">text</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Sets the glossary toc title (overriding the default). <a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9531">378</a><p>
+<div class="optionsummarybox"><a id="wrglossary.15018"></a><dfn id="glo:opt.printgloss.type"><span class="csoptfmt">type</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner"><a id="wrglossary.15019"></a><a href="#glo:dual.glossary">glossary</a>-label</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span><a id="wrglossary.15020"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a> <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of optionsummarybox -->
+<p>
+Identifies the <a id="wrglossary.15021"></a><a href="#glo:dual.glossary">glossary</a> to display.<p>
+
+</section><!-- end of section idx.printglossopt-optionsummary -->
+
+<section id="idx.abbrvstyle-optionsummary"><!-- start of section idx.abbrvstyle-optionsummary --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->Abbreviation Styles Summary<div class="labellink"><a href="#idx.abbrvstyle-optionsummary">[link]</a></div></h1><!-- end of chapter header -->
+<a id="wrglossary.15022"></a>Abbreviations defined using <a id="wrglossary.15023"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> will follow the style associated with the entry’s category. If there is no style associated with the entry’s category, the style for the <a id="wrglossary.15024"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a> category is used (the default is <a id="wrglossary.15025"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a>). Note that <a id="wrglossary.15026"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> redefines <a id="wrglossary.15027"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> to use <a id="wrglossary.15028"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> with <code class="code"><a id="wrglossary.15029"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a>=<a id="wrglossary.15030"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a></code> so any entry defined with <a id="wrglossary.15031"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> will use the abbreviation style for the <a id="wrglossary.15032"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a> category (the default is <a id="wrglossary.15033"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a>).<p>
+<div class="defnbox"><a id="wrglossary.15034"></a><a href="#glo:opt.abbrstyle.footnote-desc"><span class="abbrstylefmt">footnote-desc</span></a><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">short-footnote-desc</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+ <a href="#wrglossary.3038">116</a><p>
+<div class="defnbox"><a id="wrglossary.15035"></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><dfn id="glo:opt.abbrstyle.footnote-em"><span class="abbrstylefmt">footnote-em</span></dfn><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">short-em-footnote</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+<p>
+<div class="defnbox"><a id="wrglossary.15036"></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><dfn id="glo:opt.abbrstyle.footnote-sc"><span class="abbrstylefmt">footnote-sc</span></dfn><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">short-sc-footnote</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+<p>
+<div class="defnbox"><a id="wrglossary.15037"></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><dfn id="glo:opt.abbrstyle.footnote-sm"><span class="abbrstylefmt">footnote-sm</span></dfn><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">short-sm-footnote</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+<p>
+<div class="defnbox"><a id="wrglossary.15038"></a><a href="#glo:opt.abbrstyle.footnote"><span class="abbrstylefmt">footnote</span></a><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">short-footnote</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+ <a href="#wrglossary.3022">115</a><p>
+<div class="defnbox"><a id="wrglossary.15039"></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><dfn id="glo:opt.abbrstyle.long-desc-em"><span class="abbrstylefmt">long-desc-em</span></dfn><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">long-noshort-em-desc</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+<p>
+<div class="defnbox"><a id="wrglossary.15040"></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><dfn id="glo:opt.abbrstyle.long-desc-sc"><span class="abbrstylefmt">long-desc-sc</span></dfn><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">long-noshort-sc-desc</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+<p>
+<div class="defnbox"><a id="wrglossary.15041"></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><dfn id="glo:opt.abbrstyle.long-desc-sm"><span class="abbrstylefmt">long-desc-sm</span></dfn><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">long-noshort-sm-desc</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+<p>
+<div class="defnbox"><a id="wrglossary.15042"></a><a href="#glo:opt.abbrstyle.long-desc"><span class="abbrstylefmt">long-desc</span></a><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">long-noshort-desc</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+ <a href="#wrglossary.2085">74</a><p>
+<div class="defnbox"><a id="wrglossary.15043"></a><a href="#glo:opt.abbrstyle.long-em-noshort-em-desc-noreg"><span class="abbrstylefmt">long-em-noshort-em-desc-noreg</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15044"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15045"></a><a href="#glo:opt.abbrstyle.long-em-noshort-em-desc"><span class="abbrstylefmt">long-em-noshort-em-desc</span></a> but sets the <a id="wrglossary.15046"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">false</code>. <a href="#wrglossary.3252">131</a><p>
+<div class="defnbox"><a id="wrglossary.15047"></a><a href="#glo:opt.abbrstyle.long-em-noshort-em-desc"><span class="abbrstylefmt">long-em-noshort-em-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15048"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15049"></a><a href="#glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></a> but formats both the long and short form in an emphasized font (<a id="wrglossary.15050"></a><a href="#glo:emph"><code class="csfmt">\emph</code></a>). <a href="#wrglossary.2196">80</a><p>
+<div class="defnbox"><a id="wrglossary.15051"></a><a href="#glo:opt.abbrstyle.long-em-noshort-em-noreg"><span class="abbrstylefmt">long-em-noshort-em-noreg</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15052"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15053"></a><a href="#glo:opt.abbrstyle.long-em-noshort-em"><span class="abbrstylefmt">long-em-noshort-em</span></a> but sets the <a id="wrglossary.15054"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">false</code>. <a href="#wrglossary.3250">131</a><p>
+<div class="defnbox"><a id="wrglossary.15055"></a><a href="#glo:opt.abbrstyle.long-em-noshort-em"><span class="abbrstylefmt">long-em-noshort-em</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15056"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15057"></a><a href="#glo:opt.abbrstyle.long-noshort"><span class="abbrstylefmt">long-noshort</span></a> but formats both the long and short form in an emphasized font (<a id="wrglossary.15058"></a><a href="#glo:emph"><code class="csfmt">\emph</code></a>). <a href="#wrglossary.2181">79</a><p>
+<div class="defnbox"><a id="wrglossary.15059"></a><a href="#glo:opt.abbrstyle.long-em-short-em-desc"><span class="abbrstylefmt">long-em-short-em-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15060"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15061"></a><a href="#glo:opt.abbrstyle.long-short-desc"><span class="abbrstylefmt">long-short-desc</span></a> but formats both the long and short form in an emphasized font (<a id="wrglossary.15062"></a><a href="#glo:emph"><code class="csfmt">\emph</code></a>). <a href="#wrglossary.2366">87</a><p>
+<div class="defnbox"><a id="wrglossary.15063"></a><a href="#glo:opt.abbrstyle.long-em-short-em"><span class="abbrstylefmt">long-em-short-em</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15064"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15065"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> but formats both the long and short form in an emphasized font (<a id="wrglossary.15066"></a><a href="#glo:emph"><code class="csfmt">\emph</code></a>). <a href="#wrglossary.2351">86</a><p>
+<div class="defnbox"><a id="wrglossary.15067"></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><dfn id="glo:opt.abbrstyle.long-em"><span class="abbrstylefmt">long-em</span></dfn><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">long-noshort-em</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+<p>
+<div class="defnbox"><a id="wrglossary.15068"></a><a href="#glo:opt.abbrstyle.long-hyphen-noshort-desc-noreg"><span class="abbrstylefmt">long-hyphen-noshort-desc-noreg</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15069"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15070"></a><a href="#glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></a> but checks if the inserted material starts with a hyphen (use with <a id="wrglossary.15071"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a> attribute). <a href="#wrglossary.2820">107</a><p>
+<div class="defnbox"><a id="wrglossary.15072"></a><a href="#glo:opt.abbrstyle.long-hyphen-noshort-noreg"><span class="abbrstylefmt">long-hyphen-noshort-noreg</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15073"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15074"></a><a href="#glo:opt.abbrstyle.long-hyphen-short-hyphen"><span class="abbrstylefmt">long-hyphen-short-hyphen</span></a> but doesn’t show the short form on <a id="wrglossary.15075"></a><a href="#glo:dual.firstuse">first use</a>. <a href="#wrglossary.2837">107</a><p>
+<div class="defnbox"><a id="wrglossary.15076"></a><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen-desc"><span class="abbrstylefmt">long-hyphen-postshort-hyphen-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15077"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15078"></a><a href="#glo:opt.abbrstyle.long-hyphen-short-hyphen-desc"><span class="abbrstylefmt">long-hyphen-short-hyphen-desc</span></a> but places the insert and parenthetical material in the <a id="wrglossary.15079"></a><a href="#glo:dual.postlinkhook">post-link hook</a>. <a href="#wrglossary.2797">106</a><p>
+<div class="defnbox"><a id="wrglossary.15080"></a><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen"><span class="abbrstylefmt">long-hyphen-postshort-hyphen</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15081"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15082"></a><a href="#glo:opt.abbrstyle.long-hyphen-short-hyphen"><span class="abbrstylefmt">long-hyphen-short-hyphen</span></a> but places the insert and parenthetical material in the <a id="wrglossary.15083"></a><a href="#glo:dual.postlinkhook">post-link hook</a>. <a href="#wrglossary.2752">104</a><p>
+<div class="defnbox"><a id="wrglossary.15084"></a><a href="#glo:opt.abbrstyle.long-hyphen-short-hyphen-desc"><span class="abbrstylefmt">long-hyphen-short-hyphen-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15085"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15086"></a><a href="#glo:opt.abbrstyle.long-hyphen-short-hyphen"><span class="abbrstylefmt">long-hyphen-short-hyphen</span></a> but the description must be supplied. <a href="#wrglossary.2780">105</a><p>
+<div class="defnbox"><a id="wrglossary.15087"></a><a href="#glo:opt.abbrstyle.long-hyphen-short-hyphen"><span class="abbrstylefmt">long-hyphen-short-hyphen</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15088"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15089"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> but checks if the inserted material starts with a hyphen (use with <a id="wrglossary.15090"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a> or <a id="wrglossary.15091"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a> attributes). <a href="#wrglossary.2733">103</a><p>
+<div class="defnbox"><a id="wrglossary.15092"></a><a href="#glo:opt.abbrstyle.long-noshort-desc-noreg"><span class="abbrstylefmt">long-noshort-desc-noreg</span></a></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15093"></a><a href="#glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></a> but it will set the <a id="wrglossary.15094"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">false</code>. <a href="#wrglossary.3246">131</a><p>
+<div class="defnbox"><a id="wrglossary.15095"></a><a href="#glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15096"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> that only shows the long form on <a id="wrglossary.15097"></a><a href="#glo:dual.firstuse">first use</a> and <a id="wrglossary.15098"></a><a href="#glo:dual.subsequentuse">subsequent use</a>. The short form won’t be showed unless you use a command like <a id="wrglossary.15099"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>. The <a id="wrglossary.15100"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> key must be supplied. The full form will only be shown with commands like <a id="wrglossary.15101"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>. This style sets the <a id="wrglossary.15102"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">true</code>. <a href="#wrglossary.2055">73</a>, <a href="#wrglossary.2085">74</a><p>
+<div class="defnbox"><a id="wrglossary.15103"></a><a href="#glo:opt.abbrstyle.long-noshort-em-desc"><span class="abbrstylefmt">long-noshort-em-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15104"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15105"></a><a href="#glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></a> but formats the short form in an emphasized font (<a id="wrglossary.15106"></a><a href="#glo:emph"><code class="csfmt">\emph</code></a>). <a href="#wrglossary.2167">78</a><p>
+<div class="defnbox"><a id="wrglossary.15107"></a><a href="#glo:opt.abbrstyle.long-noshort-em"><span class="abbrstylefmt">long-noshort-em</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15108"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15109"></a><a href="#glo:opt.abbrstyle.long-noshort"><span class="abbrstylefmt">long-noshort</span></a> but formats the short form in an emphasized font (<a id="wrglossary.15110"></a><a href="#glo:emph"><code class="csfmt">\emph</code></a>). <a href="#wrglossary.2154">78</a><p>
+<div class="defnbox"><a id="wrglossary.15111"></a><a href="#glo:opt.abbrstyle.long-noshort-noreg"><span class="abbrstylefmt">long-noshort-noreg</span></a></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15112"></a><a href="#glo:opt.abbrstyle.long-noshort"><span class="abbrstylefmt">long-noshort</span></a> but it will set the <a id="wrglossary.15113"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">false</code>. <a href="#wrglossary.3248">131</a><p>
+<div class="defnbox"><a id="wrglossary.15114"></a><a href="#glo:opt.abbrstyle.long-noshort-sc-desc"><span class="abbrstylefmt">long-noshort-sc-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15115"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15116"></a><a href="#glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></a> but formats the short form in a small caps font (<a id="wrglossary.15117"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a>). The short form should therefore be in lowercase. <a href="#wrglossary.2113">76</a><p>
+<div class="defnbox"><a id="wrglossary.15118"></a><a href="#glo:opt.abbrstyle.long-noshort-sc"><span class="abbrstylefmt">long-noshort-sc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15119"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15120"></a><a href="#glo:opt.abbrstyle.long-noshort"><span class="abbrstylefmt">long-noshort</span></a> but formats the short form in a small caps font (<a id="wrglossary.15121"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a>). The short form should therefore be in lowercase. <a href="#wrglossary.2100">75</a><p>
+<div class="defnbox"><a id="wrglossary.15122"></a><a href="#glo:opt.abbrstyle.long-noshort-sm-desc"><span class="abbrstylefmt">long-noshort-sm-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15123"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15124"></a><a href="#glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></a> but formats the short form in a smaller font (<a id="wrglossary.15125"></a><a href="#glo:textsmaller"><code class="csfmt">\textsmaller</code></a>). The <a id="wrglossary.15126"></a><a href="#glo:pkg.relsize"><span class="styfmt">relsize</span></a> package is must be loaded. <a href="#wrglossary.2140">77</a><p>
+<div class="defnbox"><a id="wrglossary.15127"></a><a href="#glo:opt.abbrstyle.long-noshort-sm"><span class="abbrstylefmt">long-noshort-sm</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15128"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15129"></a><a href="#glo:opt.abbrstyle.long-noshort"><span class="abbrstylefmt">long-noshort</span></a> but formats the short form in a smaller font (<a id="wrglossary.15130"></a><a href="#glo:textsmaller"><code class="csfmt">\textsmaller</code></a>). The <a id="wrglossary.15131"></a><a href="#glo:pkg.relsize"><span class="styfmt">relsize</span></a> package is must be loaded. <a href="#wrglossary.2127">76</a><p>
+<div class="defnbox"><a id="wrglossary.15132"></a><a href="#glo:opt.abbrstyle.long-noshort"><span class="abbrstylefmt">long-noshort</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15133"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> that only shows the long form on <a id="wrglossary.15134"></a><a href="#glo:dual.firstuse">first use</a> and <a id="wrglossary.15135"></a><a href="#glo:dual.subsequentuse">subsequent use</a>. The short form won’t be showed unless you use a command like <a id="wrglossary.15136"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a>. The full form will only be shown with commands like <a id="wrglossary.15137"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>. This style sets the <a id="wrglossary.15138"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">true</code>. <a href="#wrglossary.2087">74</a>, <a href="#wrglossary.2098">75</a><p>
+<div class="defnbox"><a id="wrglossary.15139"></a><a href="#glo:opt.abbrstyle.long-only-short-only-desc"><span class="abbrstylefmt">long-only-short-only-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15140"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15141"></a><a href="#glo:opt.abbrstyle.long-only-short-only"><span class="abbrstylefmt">long-only-short-only</span></a> but the description must be supplied. <a href="#wrglossary.2950">112</a><p>
+<div class="defnbox"><a id="wrglossary.15142"></a><a href="#glo:opt.abbrstyle.long-only-short-only"><span class="abbrstylefmt">long-only-short-only</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15143"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> that only shows the long form on <a id="wrglossary.15144"></a><a href="#glo:dual.firstuse">first use</a> and only shows the short form on <a id="wrglossary.15145"></a><a href="#glo:dual.subsequentuse">subsequent use</a>. <a href="#wrglossary.2939">111</a><p>
+<div class="defnbox"><a id="wrglossary.15146"></a><a href="#glo:opt.abbrstyle.long-only-short-sc-only-desc"><span class="abbrstylefmt">long-only-short-sc-only-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15147"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15148"></a><a href="#glo:opt.abbrstyle.long-only-short-sc-only"><span class="abbrstylefmt">long-only-short-sc-only</span></a> but the description must be supplied. <a href="#wrglossary.2978">113</a><p>
+<div class="defnbox"><a id="wrglossary.15149"></a><a href="#glo:opt.abbrstyle.long-only-short-sc-only"><span class="abbrstylefmt">long-only-short-sc-only</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15150"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15151"></a><a href="#glo:opt.abbrstyle.long-only-short-only"><span class="abbrstylefmt">long-only-short-only</span></a> but uses <a id="wrglossary.15152"></a><a href="#glo:idx.smallcaps">small caps</a> for the short form. <a href="#wrglossary.2963">112</a><p>
+<div class="defnbox"><a id="wrglossary.15153"></a><a href="#glo:opt.abbrstyle.long-postshort-sc-user-desc"><span class="abbrstylefmt">long-postshort-sc-user-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15154"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15155"></a><a href="#glo:opt.abbrstyle.long-postshort-sc-user"><span class="abbrstylefmt">long-postshort-sc-user</span></a> but the description must be supplied. <a href="#wrglossary.2475">92</a><p>
+<div class="defnbox"><a id="wrglossary.15156"></a><a href="#glo:opt.abbrstyle.long-postshort-sc-user"><span class="abbrstylefmt">long-postshort-sc-user</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15157"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15158"></a><a href="#glo:opt.abbrstyle.long-postshort-user"><span class="abbrstylefmt">long-postshort-user</span></a> but formats the short form in a small caps font (<a id="wrglossary.15159"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a>). The short form should therefore be in lowercase. <a href="#wrglossary.2460">91</a><p>
+<div class="defnbox"><a id="wrglossary.15160"></a><a href="#glo:opt.abbrstyle.long-postshort-user-desc"><span class="abbrstylefmt">long-postshort-user-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15161"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15162"></a><a href="#glo:opt.abbrstyle.long-postshort-user"><span class="abbrstylefmt">long-postshort-user</span></a> but the description must be supplied. <a href="#wrglossary.2443">90</a><p>
+<div class="defnbox"><a id="wrglossary.15163"></a><a href="#glo:opt.abbrstyle.long-postshort-user"><span class="abbrstylefmt">long-postshort-user</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15164"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15165"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a> but the parenthetical content is placed in the <a id="wrglossary.15166"></a><a href="#glo:dual.postlinkhook">post-link hook</a>. <a href="#wrglossary.2429">90</a><p>
+<div class="defnbox"><a id="wrglossary.15167"></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><dfn id="glo:opt.abbrstyle.long-sc"><span class="abbrstylefmt">long-sc</span></dfn><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">long-noshort-sc</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+<p>
+<div class="defnbox"><a id="wrglossary.15168"></a><a href="#glo:opt.abbrstyle.long-short-desc"><span class="abbrstylefmt">long-short-desc</span></a></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15169"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> but the <a id="wrglossary.15170"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> must be supplied in <span class="meta">〈<em class="metainner">options</em>〉</span>. <a href="#wrglossary.2252">82</a><p>
+<div class="defnbox"><a id="wrglossary.15171"></a><a href="#glo:opt.abbrstyle.long-short-em-desc"><span class="abbrstylefmt">long-short-em-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15172"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15173"></a><a href="#glo:opt.abbrstyle.long-short-desc"><span class="abbrstylefmt">long-short-desc</span></a> but formats the short form in an emphasized font (<a id="wrglossary.15174"></a><a href="#glo:emph"><code class="csfmt">\emph</code></a>). <a href="#wrglossary.2337">86</a><p>
+<div class="defnbox"><a id="wrglossary.15175"></a><a href="#glo:opt.abbrstyle.long-short-em"><span class="abbrstylefmt">long-short-em</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15176"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15177"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> but formats the short form in an emphasized font (<a id="wrglossary.15178"></a><a href="#glo:emph"><code class="csfmt">\emph</code></a>). <a href="#wrglossary.2324">85</a><p>
+<div class="defnbox"><a id="wrglossary.15179"></a><a href="#glo:opt.abbrstyle.long-short-sc-desc"><span class="abbrstylefmt">long-short-sc-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15180"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15181"></a><a href="#glo:opt.abbrstyle.long-short-desc"><span class="abbrstylefmt">long-short-desc</span></a> but formats the short form in a small caps font (<a id="wrglossary.15182"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a>). The short form should therefore be in lowercase. <a href="#wrglossary.2283">83</a><p>
+<div class="defnbox"><a id="wrglossary.15183"></a><a href="#glo:opt.abbrstyle.long-short-sc"><span class="abbrstylefmt">long-short-sc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15184"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15185"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> but formats the short form in a small caps font (<a id="wrglossary.15186"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a>). The short form should therefore be in lowercase. <a href="#wrglossary.2270">82</a><p>
+<div class="defnbox"><a id="wrglossary.15187"></a><a href="#glo:opt.abbrstyle.long-short-sm-desc"><span class="abbrstylefmt">long-short-sm-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15188"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15189"></a><a href="#glo:opt.abbrstyle.long-short-desc"><span class="abbrstylefmt">long-short-desc</span></a> but formats the short form in a smaller font (<a id="wrglossary.15190"></a><a href="#glo:textsmaller"><code class="csfmt">\textsmaller</code></a>). The <a id="wrglossary.15191"></a><a href="#glo:pkg.relsize"><span class="styfmt">relsize</span></a> package is must be loaded. <a href="#wrglossary.2310">84</a><p>
+<div class="defnbox"><a id="wrglossary.15192"></a><a href="#glo:opt.abbrstyle.long-short-sm"><span class="abbrstylefmt">long-short-sm</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15193"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15194"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> but formats the short form in a smaller font (<a id="wrglossary.15195"></a><a href="#glo:textsmaller"><code class="csfmt">\textsmaller</code></a>). The <a id="wrglossary.15196"></a><a href="#glo:pkg.relsize"><span class="styfmt">relsize</span></a> package is must be loaded. <a href="#wrglossary.2297">84</a><p>
+<div class="defnbox"><a id="wrglossary.15197"></a><a href="#glo:opt.abbrstyle.long-short-user-desc"><span class="abbrstylefmt">long-short-user-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15198"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15199"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a> but the description must be supplied. <a href="#wrglossary.2408">89</a><p>
+<div class="defnbox"><a id="wrglossary.15200"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15201"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15202"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> but includes the value of the field identified by <a id="wrglossary.15203"></a><a href="#glo:glsxtruserfield"><code class="csfmt">\glsxtruserfield</code></a> (if set) in the parenthetical content. <a href="#wrglossary.2394">88</a><p>
+<div class="defnbox"><a id="wrglossary.15204"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15205"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> that shows the long form followed by the short form on <a id="wrglossary.15206"></a><a href="#glo:dual.firstuse">first use</a>. If the <span class="meta">〈<em class="metainner">insert</em>〉</span> argument is used with the <a id="wrglossary.15207"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> or <a id="wrglossary.15208"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands, it will be placed after the long form on <a id="wrglossary.15209"></a><a href="#glo:dual.firstuse">first use</a>. On <a id="wrglossary.15210"></a><a href="#glo:dual.subsequentuse">subsequent use</a>, only the short form is shown (followed by <span class="meta">〈<em class="metainner">insert</em>〉</span>, if provided). This style sets the <a id="wrglossary.15211"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">false</code> (which means that the <a id="wrglossary.15212"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands won’t use the <a id="wrglossary.15213"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a>/<a id="wrglossary.15214"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> or <a id="wrglossary.15215"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a>/<a id="wrglossary.15216"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> values). <a href="#wrglossary.2225">81</a><p>
+<div class="defnbox"><a id="wrglossary.15217"></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><dfn id="glo:opt.abbrstyle.long-sm"><span class="abbrstylefmt">long-sm</span></dfn><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">long-noshort-sm</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+<p>
+<div class="defnbox"><a id="wrglossary.15218"></a><a href="#glo:opt.abbrstyle.long"><span class="abbrstylefmt">long</span></a><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">long-noshort</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+ <a href="#wrglossary.2098">75</a><p>
+<div class="defnbox"><a id="wrglossary.15219"></a><a href="#glo:opt.abbrstyle.nolong-short-em"><span class="abbrstylefmt">nolong-short-em</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15220"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15221"></a><a href="#glo:opt.abbrstyle.nolong-short"><span class="abbrstylefmt">nolong-short</span></a> but formats the short form in an emphasized font (<a id="wrglossary.15222"></a><a href="#glo:emph"><code class="csfmt">\emph</code></a>). <a href="#wrglossary.2040">73</a><p>
+<div class="defnbox"><a id="wrglossary.15223"></a><a href="#glo:opt.abbrstyle.nolong-short-noreg"><span class="abbrstylefmt">nolong-short-noreg</span></a></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15224"></a><a href="#glo:opt.abbrstyle.nolong-short"><span class="abbrstylefmt">nolong-short</span></a> but it will set the <a id="wrglossary.15225"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">false</code>. <a href="#wrglossary.3241">130</a><p>
+<div class="defnbox"><a id="wrglossary.15226"></a><a href="#glo:opt.abbrstyle.nolong-short-sc"><span class="abbrstylefmt">nolong-short-sc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15227"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15228"></a><a href="#glo:opt.abbrstyle.nolong-short"><span class="abbrstylefmt">nolong-short</span></a> but formats the short form in a small caps font (<a id="wrglossary.15229"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a>). The short form should therefore be in lowercase. <a href="#wrglossary.1952">69</a><p>
+<div class="defnbox"><a id="wrglossary.15230"></a><a href="#glo:opt.abbrstyle.nolong-short-sm"><span class="abbrstylefmt">nolong-short-sm</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15231"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15232"></a><a href="#glo:opt.abbrstyle.nolong-short"><span class="abbrstylefmt">nolong-short</span></a> but formats the short form in a smaller font (<a id="wrglossary.15233"></a><a href="#glo:textsmaller"><code class="csfmt">\textsmaller</code></a>). The <a id="wrglossary.15234"></a><a href="#glo:pkg.relsize"><span class="styfmt">relsize</span></a> package is must be loaded. <a href="#wrglossary.1996">71</a><p>
+<div class="defnbox"><a id="wrglossary.15235"></a><a href="#glo:opt.abbrstyle.nolong-short"><span class="abbrstylefmt">nolong-short</span></a></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15236"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a> but the <a id="wrglossary.15237"></a><a href="#glo:dual.inlinefullform">inline full form</a> shows the long form followed by the short form in parentheses. <a href="#wrglossary.1905">67</a><p>
+<div class="defnbox"><a id="wrglossary.15238"></a><a href="#glo:opt.abbrstyle.postfootnote-desc"><span class="abbrstylefmt">postfootnote-desc</span></a><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">short-postfootnote-desc</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+ <a href="#wrglossary.3070">118</a><p>
+<div class="defnbox"><a id="wrglossary.15239"></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><dfn id="glo:opt.abbrstyle.postfootnote-em"><span class="abbrstylefmt">postfootnote-em</span></dfn><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">short-em-postfootnote</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+<p>
+<div class="defnbox"><a id="wrglossary.15240"></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><dfn id="glo:opt.abbrstyle.postfootnote-sc"><span class="abbrstylefmt">postfootnote-sc</span></dfn><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">short-sc-postfootnote</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+<p>
+<div class="defnbox"><a id="wrglossary.15241"></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><dfn id="glo:opt.abbrstyle.postfootnote-sm"><span class="abbrstylefmt">postfootnote-sm</span></dfn><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">short-sm-postfootnote</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+<p>
+<div class="defnbox"><a id="wrglossary.15242"></a><a href="#glo:opt.abbrstyle.postfootnote"><span class="abbrstylefmt">postfootnote</span></a><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">short-postfootnote</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+ <a href="#wrglossary.3055">117</a><p>
+<div class="defnbox"><a id="wrglossary.15243"></a><a href="#glo:opt.abbrstyle.short-desc"><span class="abbrstylefmt">short-desc</span></a><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">short-nolong-desc</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+ <a href="#wrglossary.1903">66</a><p>
+<div class="defnbox"><a id="wrglossary.15244"></a><a href="#glo:opt.abbrstyle.short-em-desc"><span class="abbrstylefmt">short-em-desc</span></a><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">short-em-nolong-desc</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+ <a href="#wrglossary.2038">73</a><p>
+<div class="defnbox"><a id="wrglossary.15245"></a><a href="#glo:opt.abbrstyle.short-em-footnote-desc"><span class="abbrstylefmt">short-em-footnote-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15246"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15247"></a><a href="#glo:opt.abbrstyle.short-footnote-desc"><span class="abbrstylefmt">short-footnote-desc</span></a> but formats the short form in an emphasized font (<a id="wrglossary.15248"></a><a href="#glo:emph"><code class="csfmt">\emph</code></a>). <a href="#wrglossary.3193">127</a><p>
+<div class="defnbox"><a id="wrglossary.15249"></a><a href="#glo:opt.abbrstyle.short-em-footnote"><span class="abbrstylefmt">short-em-footnote</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15250"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15251"></a><a href="#glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">short-footnote</span></a> but formats the short form in an emphasized font (<a id="wrglossary.15252"></a><a href="#glo:emph"><code class="csfmt">\emph</code></a>). <a href="#wrglossary.3180">126</a><p>
+<div class="defnbox"><a id="wrglossary.15253"></a><a href="#glo:opt.abbrstyle.short-em-long-desc"><span class="abbrstylefmt">short-em-long-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15254"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15255"></a><a href="#glo:opt.abbrstyle.short-long-desc"><span class="abbrstylefmt">short-long-desc</span></a> but formats the short form in an emphasized font (<a id="wrglossary.15256"></a><a href="#glo:emph"><code class="csfmt">\emph</code></a>). <a href="#wrglossary.2605">97</a><p>
+<div class="defnbox"><a id="wrglossary.15257"></a><a href="#glo:opt.abbrstyle.short-em-long-em-desc"><span class="abbrstylefmt">short-em-long-em-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15258"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15259"></a><a href="#glo:opt.abbrstyle.short-long-desc"><span class="abbrstylefmt">short-long-desc</span></a> but formats both the long and short form in an emphasized font (<a id="wrglossary.15260"></a><a href="#glo:emph"><code class="csfmt">\emph</code></a>). <a href="#wrglossary.2634">99</a><p>
+<div class="defnbox"><a id="wrglossary.15261"></a><a href="#glo:opt.abbrstyle.short-em-long-em"><span class="abbrstylefmt">short-em-long-em</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15262"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15263"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a> but formats both the long and short form in an emphasized font (<a id="wrglossary.15264"></a><a href="#glo:emph"><code class="csfmt">\emph</code></a>). <a href="#wrglossary.2619">98</a><p>
+<div class="defnbox"><a id="wrglossary.15265"></a><a href="#glo:opt.abbrstyle.short-em-long"><span class="abbrstylefmt">short-em-long</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15266"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15267"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a> but formats the short form in an emphasized font (<a id="wrglossary.15268"></a><a href="#glo:emph"><code class="csfmt">\emph</code></a>). <a href="#wrglossary.2592">97</a><p>
+<div class="defnbox"><a id="wrglossary.15269"></a><a href="#glo:opt.abbrstyle.short-em-nolong-desc"><span class="abbrstylefmt">short-em-nolong-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15270"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15271"></a><a href="#glo:opt.abbrstyle.short-nolong-desc"><span class="abbrstylefmt">short-nolong-desc</span></a> but formats the short form in an emphasized font (<a id="wrglossary.15272"></a><a href="#glo:emph"><code class="csfmt">\emph</code></a>). <a href="#wrglossary.2024">72</a>, <a href="#wrglossary.2038">73</a><p>
+<div class="defnbox"><a id="wrglossary.15273"></a><a href="#glo:opt.abbrstyle.short-em-nolong"><span class="abbrstylefmt">short-em-nolong</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15274"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15275"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a> but formats the short form in an emphasized font (<a id="wrglossary.15276"></a><a href="#glo:emph"><code class="csfmt">\emph</code></a>). <a href="#wrglossary.2009">71</a>, <a href="#wrglossary.2022">72</a><p>
+<div class="defnbox"><a id="wrglossary.15277"></a><a href="#glo:opt.abbrstyle.short-em-postfootnote-desc"><span class="abbrstylefmt">short-em-postfootnote-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15278"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15279"></a><a href="#glo:opt.abbrstyle.short-postfootnote-desc"><span class="abbrstylefmt">short-postfootnote-desc</span></a> but formats the short form in an emphasized font (<a id="wrglossary.15280"></a><a href="#glo:emph"><code class="csfmt">\emph</code></a>). <a href="#wrglossary.3220">129</a><p>
+<div class="defnbox"><a id="wrglossary.15281"></a><a href="#glo:opt.abbrstyle.short-em-postfootnote"><span class="abbrstylefmt">short-em-postfootnote</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15282"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15283"></a><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></a> but formats the short form in an emphasized font (<a id="wrglossary.15284"></a><a href="#glo:emph"><code class="csfmt">\emph</code></a>). <a href="#wrglossary.3207">128</a><p>
+<div class="defnbox"><a id="wrglossary.15285"></a><a href="#glo:opt.abbrstyle.short-em"><span class="abbrstylefmt">short-em</span></a><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">short-em-nolong</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+ <a href="#wrglossary.2022">72</a><p>
+<div class="defnbox"><a id="wrglossary.15286"></a><a href="#glo:opt.abbrstyle.short-footnote-desc"><span class="abbrstylefmt">short-footnote-desc</span></a></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15287"></a><a href="#glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">short-footnote</span></a> but the <a id="wrglossary.15288"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> must be supplied in <span class="meta">〈<em class="metainner">options</em>〉</span>. <a href="#wrglossary.3024">115</a>, <a href="#wrglossary.3038">116</a><p>
+<div class="defnbox"><a id="wrglossary.15289"></a><a href="#glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">short-footnote</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15290"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> that shows the short form with the long form as a footnote on <a id="wrglossary.15291"></a><a href="#glo:dual.firstuse">first use</a>. If the <span class="meta">〈<em class="metainner">insert</em>〉</span> argument is used with the <a id="wrglossary.15292"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> or <a id="wrglossary.15293"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands, it will be placed after the short form, before the footnote marker, on <a id="wrglossary.15294"></a><a href="#glo:dual.firstuse">first use</a>. On <a id="wrglossary.15295"></a><a href="#glo:dual.subsequentuse">subsequent use</a>, only the short form is shown (followed by <span class="meta">〈<em class="metainner">insert</em>〉</span>, if provided). The <a id="wrglossary.15296"></a><a href="#glo:dual.inlinefullform">inline full form</a> shows the short form followed by the long form in parentheses. This style sets the <a id="wrglossary.15297"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">false</code> (which means that the <a id="wrglossary.15298"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands won’t use the <a id="wrglossary.15299"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a>/<a id="wrglossary.15300"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> or <a id="wrglossary.15301"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a>/<a id="wrglossary.15302"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> values). This style also sets the <a id="wrglossary.15303"></a><a href="#glo:opt.catattr.nohyperfirst"><span class="csoptfmt">nohyperfirst</span></a> attribute to <code class="code">true</code> to avoid nesting the footnote marker link. If you want hyperlinks on <a id="wrglossary.15304"></a><a href="#glo:dual.firstuse">first use</a>, use the <a id="wrglossary.15305"></a><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></a> style instead. <a href="#wrglossary.3001">114</a>, <a href="#wrglossary.3022">115</a><p>
+<div class="defnbox"><a id="wrglossary.15306"></a><a href="#glo:opt.abbrstyle.short-hyphen-long-hyphen-desc"><span class="abbrstylefmt">short-hyphen-long-hyphen-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15307"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15308"></a><a href="#glo:opt.abbrstyle.short-hyphen-long-hyphen"><span class="abbrstylefmt">short-hyphen-long-hyphen</span></a> but the description must be supplied. <a href="#wrglossary.2893">110</a><p>
+<div class="defnbox"><a id="wrglossary.15309"></a><a href="#glo:opt.abbrstyle.short-hyphen-long-hyphen"><span class="abbrstylefmt">short-hyphen-long-hyphen</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15310"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15311"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a> but checks if the inserted material starts with a hyphen (use with <a id="wrglossary.15312"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a> or <a id="wrglossary.15313"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a> attributes). <a href="#wrglossary.2853">108</a><p>
+<div class="defnbox"><a id="wrglossary.15314"></a><a href="#glo:opt.abbrstyle.short-hyphen-postlong-hyphen-desc"><span class="abbrstylefmt">short-hyphen-postlong-hyphen-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15315"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15316"></a><a href="#glo:opt.abbrstyle.short-hyphen-long-hyphen-desc"><span class="abbrstylefmt">short-hyphen-long-hyphen-desc</span></a> but the insert and parenthetical material are placed in the <a id="wrglossary.15317"></a><a href="#glo:dual.postlinkhook">post-link hook</a>. <a href="#wrglossary.2910">110</a><p>
+<div class="defnbox"><a id="wrglossary.15318"></a><a href="#glo:opt.abbrstyle.short-hyphen-postlong-hyphen"><span class="abbrstylefmt">short-hyphen-postlong-hyphen</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15319"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15320"></a><a href="#glo:opt.abbrstyle.short-hyphen-long-hyphen"><span class="abbrstylefmt">short-hyphen-long-hyphen</span></a> but the insert and parenthetical material are placed in the <a id="wrglossary.15321"></a><a href="#glo:dual.postlinkhook">post-link hook</a>. <a href="#wrglossary.2870">109</a><p>
+<div class="defnbox"><a id="wrglossary.15322"></a><a href="#glo:opt.abbrstyle.short-long-desc"><span class="abbrstylefmt">short-long-desc</span></a></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15323"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a> but the <a id="wrglossary.15324"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> must be supplied in <span class="meta">〈<em class="metainner">options</em>〉</span>. <a href="#wrglossary.2520">94</a><p>
+<div class="defnbox"><a id="wrglossary.15325"></a><a href="#glo:opt.abbrstyle.short-long-user-desc"><span class="abbrstylefmt">short-long-user-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15326"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15327"></a><a href="#glo:opt.abbrstyle.short-long-user"><span class="abbrstylefmt">short-long-user</span></a> but the description must be supplied. <a href="#wrglossary.2673">100</a><p>
+<div class="defnbox"><a id="wrglossary.15328"></a><a href="#glo:opt.abbrstyle.short-long-user"><span class="abbrstylefmt">short-long-user</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15329"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15330"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a> but includes the value of the field identified by <a id="wrglossary.15331"></a><a href="#glo:glsxtruserfield"><code class="csfmt">\glsxtruserfield</code></a> (if set) in the parenthetical content. <a href="#wrglossary.2659">100</a><p>
+<div class="defnbox"><a id="wrglossary.15332"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15333"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> that shows the short form followed by the long form on <a id="wrglossary.15334"></a><a href="#glo:dual.firstuse">first use</a>. If the <span class="meta">〈<em class="metainner">insert</em>〉</span> argument is used with the <a id="wrglossary.15335"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> or <a id="wrglossary.15336"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands, it will be placed after the short form on <a id="wrglossary.15337"></a><a href="#glo:dual.firstuse">first use</a>. On <a id="wrglossary.15338"></a><a href="#glo:dual.subsequentuse">subsequent use</a>, only the short form is shown (followed by <span class="meta">〈<em class="metainner">insert</em>〉</span>, if provided). This style sets the <a id="wrglossary.15339"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">false</code> (which means that the <a id="wrglossary.15340"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands won’t use the <a id="wrglossary.15341"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a>/<a id="wrglossary.15342"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> or <a id="wrglossary.15343"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a>/<a id="wrglossary.15344"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> values). <a href="#wrglossary.2493">93</a><p>
+<div class="defnbox"><a id="wrglossary.15345"></a><a href="#glo:opt.abbrstyle.short-nolong-desc-noreg"><span class="abbrstylefmt">short-nolong-desc-noreg</span></a></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15346"></a><a href="#glo:opt.abbrstyle.short-nolong-desc"><span class="abbrstylefmt">short-nolong-desc</span></a> but it will set the <a id="wrglossary.15347"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">false</code>. <a href="#wrglossary.3239">130</a><p>
+<div class="defnbox"><a id="wrglossary.15348"></a><a href="#glo:opt.abbrstyle.short-nolong-desc"><span class="abbrstylefmt">short-nolong-desc</span></a></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15349"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a> but the <a id="wrglossary.15350"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> must be supplied in <span class="meta">〈<em class="metainner">options</em>〉</span>. <a href="#wrglossary.1887">66</a>, <a href="#wrglossary.1903">66</a><p>
+<div class="defnbox"><a id="wrglossary.15351"></a><a href="#glo:opt.abbrstyle.short-nolong-noreg"><span class="abbrstylefmt">short-nolong-noreg</span></a></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15352"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a> but it will set the <a id="wrglossary.15353"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">false</code>. <a href="#wrglossary.3237">130</a><p>
+<div class="defnbox"><a id="wrglossary.15354"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15355"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> that only shows the short form on <a id="wrglossary.15356"></a><a href="#glo:dual.firstuse">first use</a> and <a id="wrglossary.15357"></a><a href="#glo:dual.subsequentuse">subsequent use</a>. The long form won’t be showed unless you use a command like <a id="wrglossary.15358"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a>. The full form will only be shown with commands like <a id="wrglossary.15359"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>. This style sets the <a id="wrglossary.15360"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">true</code>. <a href="#wrglossary.1861">65</a>, <a href="#wrglossary.1885">66</a><p>
+<div class="defnbox"><a id="wrglossary.15361"></a><a href="#glo:opt.abbrstyle.short-postfootnote-desc"><span class="abbrstylefmt">short-postfootnote-desc</span></a></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15362"></a><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></a> but the <a id="wrglossary.15363"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> must be supplied in <span class="meta">〈<em class="metainner">options</em>〉</span>. <a href="#wrglossary.3057">117</a>, <a href="#wrglossary.3070">118</a><p>
+<div class="defnbox"><a id="wrglossary.15364"></a><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></a></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.15365"></a><a href="#glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">short-footnote</span></a> but the footnote is placed in the <a id="wrglossary.15366"></a><a href="#glo:dual.postlinkhook">post-link hook</a>. <a href="#wrglossary.3040">116</a>, <a href="#wrglossary.3055">117</a><p>
+<div class="defnbox"><a id="wrglossary.15367"></a><a href="#glo:opt.abbrstyle.short-postlong-user-desc"><span class="abbrstylefmt">short-postlong-user-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15368"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15369"></a><a href="#glo:opt.abbrstyle.short-postlong-user"><span class="abbrstylefmt">short-postlong-user</span></a> but the description must be supplied. <a href="#wrglossary.2710">102</a><p>
+<div class="defnbox"><a id="wrglossary.15370"></a><a href="#glo:opt.abbrstyle.short-postlong-user"><span class="abbrstylefmt">short-postlong-user</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15371"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15372"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a> but includes the value of the field identified by <a id="wrglossary.15373"></a><a href="#glo:glsxtruserfield"><code class="csfmt">\glsxtruserfield</code></a> (if set) in the parenthetical content, which is placed in the <a id="wrglossary.15374"></a><a href="#glo:dual.postlinkhook">post-link hook</a>. <a href="#wrglossary.2695">101</a><p>
+<div class="defnbox"><a id="wrglossary.15375"></a><a href="#glo:opt.abbrstyle.short-sc-desc"><span class="abbrstylefmt">short-sc-desc</span></a><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">short-sc-nolong-desc</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+ <a href="#wrglossary.1950">69</a><p>
+<div class="defnbox"><a id="wrglossary.15376"></a><a href="#glo:opt.abbrstyle.short-sc-footnote-desc"><span class="abbrstylefmt">short-sc-footnote-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15377"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15378"></a><a href="#glo:opt.abbrstyle.short-footnote-desc"><span class="abbrstylefmt">short-footnote-desc</span></a> but formats the short form in a small caps font (<a id="wrglossary.15379"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a>). The short form should therefore be in lowercase. <a href="#wrglossary.3085">119</a><p>
+<div class="defnbox"><a id="wrglossary.15380"></a><a href="#glo:opt.abbrstyle.short-sc-footnote"><span class="abbrstylefmt">short-sc-footnote</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15381"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15382"></a><a href="#glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">short-footnote</span></a> but formats the short form in a small caps font (<a id="wrglossary.15383"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a>). The short form should therefore be in lowercase. <a href="#wrglossary.3072">118</a><p>
+<div class="defnbox"><a id="wrglossary.15384"></a><a href="#glo:opt.abbrstyle.short-sc-long-desc"><span class="abbrstylefmt">short-sc-long-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15385"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15386"></a><a href="#glo:opt.abbrstyle.short-long-desc"><span class="abbrstylefmt">short-long-desc</span></a> but formats the short form in a small caps font (<a id="wrglossary.15387"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a>). The short form should therefore be in lowercase. <a href="#wrglossary.2551">95</a><p>
+<div class="defnbox"><a id="wrglossary.15388"></a><a href="#glo:opt.abbrstyle.short-sc-long"><span class="abbrstylefmt">short-sc-long</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15389"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15390"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a> but formats the short form in a small caps font (<a id="wrglossary.15391"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a>). The short form should therefore be in lowercase. <a href="#wrglossary.2538">94</a><p>
+<div class="defnbox"><a id="wrglossary.15392"></a><a href="#glo:opt.abbrstyle.short-sc-nolong-desc"><span class="abbrstylefmt">short-sc-nolong-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15393"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15394"></a><a href="#glo:opt.abbrstyle.short-nolong-desc"><span class="abbrstylefmt">short-nolong-desc</span></a> but formats the short form in a small caps font (<a id="wrglossary.15395"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a>). The short form should therefore be in lowercase. <a href="#wrglossary.1936">68</a>, <a href="#wrglossary.1950">69</a><p>
+<div class="defnbox"><a id="wrglossary.15396"></a><a href="#glo:opt.abbrstyle.short-sc-nolong"><span class="abbrstylefmt">short-sc-nolong</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15397"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15398"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a> but formats the short form in a small caps font (<a id="wrglossary.15399"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a>). The short form should therefore be in lowercase. <a href="#wrglossary.1921">67</a>, <a href="#wrglossary.1934">68</a><p>
+<div class="defnbox"><a id="wrglossary.15400"></a><a href="#glo:opt.abbrstyle.short-sc-postfootnote-desc"><span class="abbrstylefmt">short-sc-postfootnote-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15401"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15402"></a><a href="#glo:opt.abbrstyle.short-postfootnote-desc"><span class="abbrstylefmt">short-postfootnote-desc</span></a> but formats the short form in a small caps font (<a id="wrglossary.15403"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a>). The short form should therefore be in lowercase. <a href="#wrglossary.3112">121</a><p>
+<div class="defnbox"><a id="wrglossary.15404"></a><a href="#glo:opt.abbrstyle.short-sc-postfootnote"><span class="abbrstylefmt">short-sc-postfootnote</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15405"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15406"></a><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></a> but formats the short form in a small caps font (<a id="wrglossary.15407"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a>). The short form should therefore be in lowercase. <a href="#wrglossary.3099">120</a><p>
+<div class="defnbox"><a id="wrglossary.15408"></a><a href="#glo:opt.abbrstyle.short-sc"><span class="abbrstylefmt">short-sc</span></a><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">short-sc-nolong</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+ <a href="#wrglossary.1934">68</a><p>
+<div class="defnbox"><a id="wrglossary.15409"></a><a href="#glo:opt.abbrstyle.short-sm-desc"><span class="abbrstylefmt">short-sm-desc</span></a><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">short-sm-nolong-desc</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+ <a href="#wrglossary.1994">71</a><p>
+<div class="defnbox"><a id="wrglossary.15410"></a><a href="#glo:opt.abbrstyle.short-sm-footnote-desc"><span class="abbrstylefmt">short-sm-footnote-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15411"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15412"></a><a href="#glo:opt.abbrstyle.short-footnote-desc"><span class="abbrstylefmt">short-footnote-desc</span></a> but formats the short form in a smaller font (<a id="wrglossary.15413"></a><a href="#glo:textsmaller"><code class="csfmt">\textsmaller</code></a>). The <a id="wrglossary.15414"></a><a href="#glo:pkg.relsize"><span class="styfmt">relsize</span></a> package is must be loaded. <a href="#wrglossary.3139">123</a><p>
+<div class="defnbox"><a id="wrglossary.15415"></a><a href="#glo:opt.abbrstyle.short-sm-footnote"><span class="abbrstylefmt">short-sm-footnote</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15416"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15417"></a><a href="#glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">short-footnote</span></a> but formats the short form in a smaller font (<a id="wrglossary.15418"></a><a href="#glo:textsmaller"><code class="csfmt">\textsmaller</code></a>). The <a id="wrglossary.15419"></a><a href="#glo:pkg.relsize"><span class="styfmt">relsize</span></a> package is must be loaded. <a href="#wrglossary.3126">122</a><p>
+<div class="defnbox"><a id="wrglossary.15420"></a><a href="#glo:opt.abbrstyle.short-sm-long-desc"><span class="abbrstylefmt">short-sm-long-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15421"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15422"></a><a href="#glo:opt.abbrstyle.short-long-desc"><span class="abbrstylefmt">short-long-desc</span></a> but formats the short form in a smaller font (<a id="wrglossary.15423"></a><a href="#glo:textsmaller"><code class="csfmt">\textsmaller</code></a>). The <a id="wrglossary.15424"></a><a href="#glo:pkg.relsize"><span class="styfmt">relsize</span></a> package is must be loaded. <a href="#wrglossary.2578">96</a><p>
+<div class="defnbox"><a id="wrglossary.15425"></a><a href="#glo:opt.abbrstyle.short-sm-long"><span class="abbrstylefmt">short-sm-long</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15426"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15427"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a> but formats the short form in a smaller font (<a id="wrglossary.15428"></a><a href="#glo:textsmaller"><code class="csfmt">\textsmaller</code></a>). The <a id="wrglossary.15429"></a><a href="#glo:pkg.relsize"><span class="styfmt">relsize</span></a> package is must be loaded. <a href="#wrglossary.2565">96</a><p>
+<div class="defnbox"><a id="wrglossary.15430"></a><a href="#glo:opt.abbrstyle.short-sm-nolong-desc"><span class="abbrstylefmt">short-sm-nolong-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15431"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15432"></a><a href="#glo:opt.abbrstyle.short-nolong-desc"><span class="abbrstylefmt">short-nolong-desc</span></a> but formats the short form in a smaller font (<a id="wrglossary.15433"></a><a href="#glo:textsmaller"><code class="csfmt">\textsmaller</code></a>). The <a id="wrglossary.15434"></a><a href="#glo:pkg.relsize"><span class="styfmt">relsize</span></a> package is must be loaded. <a href="#wrglossary.1980">70</a>, <a href="#wrglossary.1994">71</a><p>
+<div class="defnbox"><a id="wrglossary.15435"></a><a href="#glo:opt.abbrstyle.short-sm-nolong"><span class="abbrstylefmt">short-sm-nolong</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15436"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15437"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a> but formats the short form in a smaller font (<a id="wrglossary.15438"></a><a href="#glo:textsmaller"><code class="csfmt">\textsmaller</code></a>). The <a id="wrglossary.15439"></a><a href="#glo:pkg.relsize"><span class="styfmt">relsize</span></a> package is must be loaded. <a href="#wrglossary.1965">69</a>, <a href="#wrglossary.1978">70</a><p>
+<div class="defnbox"><a id="wrglossary.15440"></a><a href="#glo:opt.abbrstyle.short-sm-postfootnote-desc"><span class="abbrstylefmt">short-sm-postfootnote-desc</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15441"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15442"></a><a href="#glo:opt.abbrstyle.short-postfootnote-desc"><span class="abbrstylefmt">short-postfootnote-desc</span></a> but formats the short form in a smaller font (<a id="wrglossary.15443"></a><a href="#glo:textsmaller"><code class="csfmt">\textsmaller</code></a>). The <a id="wrglossary.15444"></a><a href="#glo:pkg.relsize"><span class="styfmt">relsize</span></a> package is must be loaded. <a href="#wrglossary.3166">125</a><p>
+<div class="defnbox"><a id="wrglossary.15445"></a><a href="#glo:opt.abbrstyle.short-sm-postfootnote"><span class="abbrstylefmt">short-sm-postfootnote</span></a></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.15446"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> like <a id="wrglossary.15447"></a><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></a> but formats the short form in a smaller font (<a id="wrglossary.15448"></a><a href="#glo:textsmaller"><code class="csfmt">\textsmaller</code></a>). The <a id="wrglossary.15449"></a><a href="#glo:pkg.relsize"><span class="styfmt">relsize</span></a> package is must be loaded. <a href="#wrglossary.3153">124</a><p>
+<div class="defnbox"><a id="wrglossary.15450"></a><a href="#glo:opt.abbrstyle.short-sm"><span class="abbrstylefmt">short-sm</span></a><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">short-sm-nolong</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+ <a href="#wrglossary.1978">70</a><p>
+<div class="defnbox"><a id="wrglossary.15451"></a><a href="#glo:opt.abbrstyle.short"><span class="abbrstylefmt">short</span></a><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="abbrstylefmt">short-nolong</span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+ <a href="#wrglossary.1885">66</a><p>
+
+</section><!-- end of section idx.abbrvstyle-optionsummary -->
+
+<section id="idx.glossarystyle-optionsummary"><!-- start of section idx.glossarystyle-optionsummary --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->Glossary Styles Summary<div class="labellink"><a href="#idx.glossarystyle-optionsummary">[link]</a></div></h1><!-- end of chapter header -->
+<a id="wrglossary.15452"></a>The default style may be set with <a id="wrglossary.15453"></a><a href="#glo:setglossarystyle"><code class="csfmt">\setglossarystyle</code></a> or use: <pre class="compactcodebox"><code class="csfmt">\usepackage</code>[<a id="wrglossary.15454"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a><span class="optfmt">=<span class="meta">〈<em class="metainner">name</em>〉</span></span>,<a id="wrglossary.15455"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<span class="meta">〈<em class="metainner">style-name</em>〉</span></span>]{glossaries-extra} </pre> where the style is provided by package <span class="styfmt">glossary-<span class="meta">〈<em class="metainner">name</em>〉</span></span>. The default style can be overridden for individual <a id="wrglossary.15456"></a><a href="#glo:dual.glossary">glossaries</a> with the <a id="wrglossary.15457"></a><a href="#glo:opt.printgloss.style"><span class="csoptfmt">style</span></a> option. For a summary of all available styles, see <a href="https://www.dickimaw-books.com/gallery/index.php?label=glossaries-styles">Gallery: Predefined Styles</a>.<p>
+<div class="defnbox"><a id="wrglossary.15458"></a><a href="#glo:opt.glostyle.abbr-long-short"><span class="glostylefmt">abbr-long-short</span></a><span class="floatrightbox"><a id="wrglossary.15459"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style displays the <a id="wrglossary.15460"></a><a href="#glo:dual.glossary">glossary</a> in a table for (either <a id="wrglossary.15461"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> or <a id="wrglossary.15462"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>) with two columns: the long form and the short form. <a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11475">460</a><p>
+<div class="defnbox"><a id="wrglossary.15463"></a><a href="#glo:opt.glostyle.abbr-short-long"><span class="glostylefmt">abbr-short-long</span></a><span class="floatrightbox"><a id="wrglossary.15464"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style displays the <a id="wrglossary.15465"></a><a href="#glo:dual.glossary">glossary</a> in a table for (either <a id="wrglossary.15466"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> or <a id="wrglossary.15467"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>) with two columns: the short form and the long form. <a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11469">460</a><p>
+<div class="defnbox"><a id="wrglossary.15468"></a><dfn id="glo:opt.glostyle.altlist"><span class="glostylefmt">altlist</span></dfn><span class="floatrightbox"><a id="wrglossary.15469"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15470"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> but starts the description on a new line.<p>
+<div class="defnbox"><a id="wrglossary.15471"></a><dfn id="glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></dfn><span class="floatrightbox"><a id="wrglossary.15472"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.15473"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a> but the width of the widest name must be supplied (using a command like <a id="wrglossary.15474"></a><a href="#glo:glssetwidest"><code class="csfmt">\glssetwidest</code></a>).<p>
+<div class="defnbox"><a id="wrglossary.15475"></a><dfn id="glo:opt.glostyle.alttreegroup"><span class="glostylefmt">alttreegroup</span></dfn><span class="floatrightbox"><a id="wrglossary.15476"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15477"></a><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a> but has headers at the start of each <a id="wrglossary.15478"></a><a href="#glo:idx.group">group</a>.<p>
+<div class="defnbox"><a id="wrglossary.15479"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a><span class="floatrightbox"><a id="wrglossary.15480"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style is designed for indexes. Symbols and descriptions are not shown. Since descriptions aren’t shown, there’s no <a id="wrglossary.15481"></a><a href="#glo:postdeschook">post-description hook</a>. <a href="#sec:bookindex">§8.7.1</a><p>
+<div class="defnbox"><a id="wrglossary.15482"></a><dfn id="glo:opt.glostyle.index"><span class="glostylefmt">index</span></dfn><span class="floatrightbox"><a id="wrglossary.15483"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A hierarchical style that supports up to level 2, similar to normal indexes, but symbols and descriptions are shown.<p>
+<div class="defnbox"><a id="wrglossary.15484"></a><dfn id="glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></dfn><span class="floatrightbox"><a id="wrglossary.15485"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15486"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a> but has headers at the start of each <a id="wrglossary.15487"></a><a href="#glo:idx.group">group</a>.<p>
+<div class="defnbox"><a id="wrglossary.15488"></a><dfn id="glo:opt.glostyle.inline"><span class="glostylefmt">inline</span></dfn><span class="floatrightbox"><a id="wrglossary.15489"></a><a href="#glo:pkg.glossary-inline"><span class="styfmt">glossary-inline</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A compact style with all entries listed in the same paragraph and no <a id="wrglossary.15490"></a><a href="#glo:idx.group">groups</a>, locations or symbols.<p>
+<div class="defnbox"><a id="wrglossary.15491"></a><dfn id="glo:opt.glostyle.list"><span class="glostylefmt">list</span></dfn><span class="floatrightbox"><a id="wrglossary.15492"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style uses the <a id="wrglossary.15493"></a><a href="#glo:env.description"><span class="envfmt">description</span></a> environment and places the entry name in the optional argument of <a id="wrglossary.15494"></a><a href="#glo:item"><code class="csfmt">\item</code></a>. Symbols and sub-entry names are not shown.<p>
+<div class="defnbox"><a id="wrglossary.15495"></a><dfn id="glo:opt.glostyle.listdotted"><span class="glostylefmt">listdotted</span></dfn><span class="floatrightbox"><a id="wrglossary.15496"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A <a id="wrglossary.15497"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a>-like style that has a dotted leader between the name and description. The <a id="wrglossary.15498"></a><a href="#glo:dual.locationlist">location list</a> isn’t shown.<p>
+<div class="defnbox"><a id="wrglossary.15499"></a><dfn id="glo:opt.glostyle.listgroup"><span class="glostylefmt">listgroup</span></dfn><span class="floatrightbox"><a id="wrglossary.15500"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15501"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> but has headers at the start of each <a id="wrglossary.15502"></a><a href="#glo:idx.group">group</a>.<p>
+<div class="defnbox"><a id="wrglossary.15503"></a><dfn id="glo:opt.glostyle.listhypergroup"><span class="glostylefmt">listhypergroup</span></dfn><span class="floatrightbox"><a id="wrglossary.15504"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15505"></a><a href="#glo:opt.glostyle.listgroup"><span class="glostylefmt">listgroup</span></a> but has a row at the start with hyperlinks to each <a id="wrglossary.15506"></a><a href="#glo:idx.group">group</a>.<p>
+<div class="defnbox"><a id="wrglossary.15507"></a><dfn id="glo:opt.glostyle.long-booktabs"><span class="glostylefmt">long-booktabs</span></dfn><span class="floatrightbox"><a id="wrglossary.15508"></a><a href="#glo:pkg.glossary-longbooktabs"><span class="styfmt">glossary-longbooktabs</span></a> v4.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style displays the <a id="wrglossary.15509"></a><a href="#glo:dual.glossary">glossary</a> using <a id="wrglossary.15510"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> and horizontal rules from the <a id="wrglossary.15511"></a><a href="#glo:pkg.booktabs"><span class="styfmt">booktabs</span></a> package.<p>
+<div class="defnbox"><a id="wrglossary.15512"></a><a href="#glo:opt.glostyle.long-desc-name"><span class="glostylefmt">long-desc-name</span></a><span class="floatrightbox"><a id="wrglossary.15513"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style displays the <a id="wrglossary.15514"></a><a href="#glo:dual.glossary">glossary</a> in a table for (either <a id="wrglossary.15515"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> or <a id="wrglossary.15516"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>) with two columns: the description and the name. <a href="#sec:longextranamedesc">§8.7.2.1</a>; <a href="#wrglossary.11302">449</a><p>
+<div class="defnbox"><a id="wrglossary.15517"></a><a href="#glo:opt.glostyle.long-desc-sym-name"><span class="glostylefmt">long-desc-sym-name</span></a><span class="floatrightbox"><a id="wrglossary.15518"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style displays the <a id="wrglossary.15519"></a><a href="#glo:dual.glossary">glossary</a> in a table for (either <a id="wrglossary.15520"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> or <a id="wrglossary.15521"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>) with three columns: the description, symbol and name. <a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11330">452</a><p>
+<div class="defnbox"><a id="wrglossary.15522"></a><a href="#glo:opt.glostyle.long-desc-sym"><span class="glostylefmt">long-desc-sym</span></a><span class="floatrightbox"><a id="wrglossary.15523"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style displays the <a id="wrglossary.15524"></a><a href="#glo:dual.glossary">glossary</a> in a table for (either <a id="wrglossary.15525"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> or <a id="wrglossary.15526"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>) with two columns: the description and the symbol. <a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11416">457</a><p>
+<div class="defnbox"><a id="wrglossary.15527"></a><a href="#glo:opt.glostyle.long-loc-desc-name"><span class="glostylefmt">long-loc-desc-name</span></a><span class="floatrightbox"><a id="wrglossary.15528"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style displays the <a id="wrglossary.15529"></a><a href="#glo:dual.glossary">glossary</a> in a table for (either <a id="wrglossary.15530"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> or <a id="wrglossary.15531"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>) with three columns: the <a id="wrglossary.15532"></a><a href="#glo:dual.locationlist">location list</a>, description and name. <a href="#sec:longextranamedescloc">§8.7.2.3</a>; <a href="#wrglossary.11351">453</a><p>
+<div class="defnbox"><a id="wrglossary.15533"></a><a href="#glo:opt.glostyle.long-loc-desc-sym-name"><span class="glostylefmt">long-loc-desc-sym-name</span></a><span class="floatrightbox"><a id="wrglossary.15534"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style displays the <a id="wrglossary.15535"></a><a href="#glo:dual.glossary">glossary</a> in a table for (either <a id="wrglossary.15536"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> or <a id="wrglossary.15537"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>) with four columns: the <a id="wrglossary.15538"></a><a href="#glo:dual.locationlist">location list</a>, description, symbol and name. <a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11385">455</a><p>
+<div class="defnbox"><a id="wrglossary.15539"></a><a href="#glo:opt.glostyle.long-loc-sym-desc-name"><span class="glostylefmt">long-loc-sym-desc-name</span></a><span class="floatrightbox"><a id="wrglossary.15540"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style displays the <a id="wrglossary.15541"></a><a href="#glo:dual.glossary">glossary</a> in a table for (either <a id="wrglossary.15542"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> or <a id="wrglossary.15543"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>) with four columns: the <a id="wrglossary.15544"></a><a href="#glo:dual.locationlist">location list</a>, symbol, description and name. <a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11379">455</a><p>
+<div class="defnbox"><a id="wrglossary.15545"></a><a href="#glo:opt.glostyle.long-name-desc-loc"><span class="glostylefmt">long-name-desc-loc</span></a><span class="floatrightbox"><a id="wrglossary.15546"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style displays the <a id="wrglossary.15547"></a><a href="#glo:dual.glossary">glossary</a> in a table for (either <a id="wrglossary.15548"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> or <a id="wrglossary.15549"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>) with three columns: the name, description and <a id="wrglossary.15550"></a><a href="#glo:dual.locationlist">location list</a>. <a href="#sec:longextranamedescloc">§8.7.2.3</a>; <a href="#wrglossary.11345">452</a><p>
+<div class="defnbox"><a id="wrglossary.15551"></a><a href="#glo:opt.glostyle.long-name-desc-sym-loc"><span class="glostylefmt">long-name-desc-sym-loc</span></a><span class="floatrightbox"><a id="wrglossary.15552"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style displays the <a id="wrglossary.15553"></a><a href="#glo:dual.glossary">glossary</a> in a table for (either <a id="wrglossary.15554"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> or <a id="wrglossary.15555"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>) with four columns: the name, description, symbol and <a id="wrglossary.15556"></a><a href="#glo:dual.locationlist">location list</a>. <a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11367">454</a><p>
+<div class="defnbox"><a id="wrglossary.15557"></a><a href="#glo:opt.glostyle.long-name-desc-sym"><span class="glostylefmt">long-name-desc-sym</span></a><span class="floatrightbox"><a id="wrglossary.15558"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style displays the <a id="wrglossary.15559"></a><a href="#glo:dual.glossary">glossary</a> in a table for (either <a id="wrglossary.15560"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> or <a id="wrglossary.15561"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>) with three columns: the name, description and symbol. <a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11315">450</a><p>
+<div class="defnbox"><a id="wrglossary.15562"></a><a href="#glo:opt.glostyle.long-name-desc"><span class="glostylefmt">long-name-desc</span></a><span class="floatrightbox"><a id="wrglossary.15563"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style displays the <a id="wrglossary.15564"></a><a href="#glo:dual.glossary">glossary</a> in a table for (either <a id="wrglossary.15565"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> or <a id="wrglossary.15566"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>) with two columns: the name and the description. <a href="#sec:longextranamedesc">§8.7.2.1</a>; <a href="#wrglossary.11297">449</a><p>
+<div class="defnbox"><a id="wrglossary.15567"></a><a href="#glo:opt.glostyle.long-name-sym-desc-loc"><span class="glostylefmt">long-name-sym-desc-loc</span></a><span class="floatrightbox"><a id="wrglossary.15568"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style displays the <a id="wrglossary.15569"></a><a href="#glo:dual.glossary">glossary</a> in a table for (either <a id="wrglossary.15570"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> or <a id="wrglossary.15571"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>) with four columns: the name, symbol, description and <a id="wrglossary.15572"></a><a href="#glo:dual.locationlist">location list</a>. <a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11373">454</a><p>
+<div class="defnbox"><a id="wrglossary.15573"></a><a href="#glo:opt.glostyle.long-name-sym-desc"><span class="glostylefmt">long-name-sym-desc</span></a><span class="floatrightbox"><a id="wrglossary.15574"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style displays the <a id="wrglossary.15575"></a><a href="#glo:dual.glossary">glossary</a> in a table for (either <a id="wrglossary.15576"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> or <a id="wrglossary.15577"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>) with three columns: the name, symbol and description. <a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11320">451</a><p>
+<div class="defnbox"><a id="wrglossary.15578"></a><a href="#glo:opt.glostyle.long-sym-desc-name"><span class="glostylefmt">long-sym-desc-name</span></a><span class="floatrightbox"><a id="wrglossary.15579"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style displays the <a id="wrglossary.15580"></a><a href="#glo:dual.glossary">glossary</a> in a table for (either <a id="wrglossary.15581"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> or <a id="wrglossary.15582"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>) with three columns: the symbol, description and name. <a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11325">451</a><p>
+<div class="defnbox"><a id="wrglossary.15583"></a><a href="#glo:opt.glostyle.long-sym-desc"><span class="glostylefmt">long-sym-desc</span></a><span class="floatrightbox"><a id="wrglossary.15584"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style displays the <a id="wrglossary.15585"></a><a href="#glo:dual.glossary">glossary</a> in a table for (either <a id="wrglossary.15586"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> or <a id="wrglossary.15587"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>) with two columns: the symbol and the description. <a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11410">457</a><p>
+<div class="defnbox"><a id="wrglossary.15588"></a><dfn id="glo:opt.glostyle.long"><span class="glostylefmt">long</span></dfn><span class="floatrightbox"><a id="wrglossary.15589"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style uses the <a id="wrglossary.15590"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> environment (provided by the <a id="wrglossary.15591"></a><a href="#glo:pkg.longtable"><span class="styfmt">longtable</span></a> package). Symbols and sub-entry names are not shown.<p>
+<div class="defnbox"><a id="wrglossary.15592"></a><dfn id="glo:opt.glostyle.longragged"><span class="glostylefmt">longragged</span></dfn><span class="floatrightbox"><a id="wrglossary.15593"></a><a href="#glo:pkg.glossary-longragged"><span class="styfmt">glossary-longragged</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style displays the <a id="wrglossary.15594"></a><a href="#glo:dual.glossary">glossary</a> using <a id="wrglossary.15595"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a> with ragged right paragraph formatting for the description column.<p>
+<div class="defnbox"><a id="wrglossary.15596"></a><dfn id="glo:opt.glostyle.mcolindex"><span class="glostylefmt">mcolindex</span></dfn><span class="floatrightbox"><a id="wrglossary.15597"></a><a href="#glo:pkg.glossary-mcols"><span class="styfmt">glossary-mcols</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15598"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a> but puts the content inside a <a id="wrglossary.15599"></a><a href="#glo:env.multicols"><span class="envfmt">multicols</span></a> environment.<p>
+<div class="defnbox"><a id="wrglossary.15600"></a><dfn id="glo:opt.glostyle.mcolindexgroup"><span class="glostylefmt">mcolindexgroup</span></dfn><span class="floatrightbox"><a id="wrglossary.15601"></a><a href="#glo:pkg.glossary-mcols"><span class="styfmt">glossary-mcols</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15602"></a><a href="#glo:opt.glostyle.mcolindex"><span class="glostylefmt">mcolindex</span></a> but has headers at the start of each <a id="wrglossary.15603"></a><a href="#glo:idx.group">group</a>.<p>
+<div class="defnbox"><a id="wrglossary.15604"></a><dfn id="glo:opt.glostyle.mcoltree"><span class="glostylefmt">mcoltree</span></dfn><span class="floatrightbox"><a id="wrglossary.15605"></a><a href="#glo:pkg.glossary-mcols"><span class="styfmt">glossary-mcols</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15606"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a> but puts the content inside a <a id="wrglossary.15607"></a><a href="#glo:env.multicols"><span class="envfmt">multicols</span></a> environment.<p>
+<div class="defnbox"><a id="wrglossary.15608"></a><dfn id="glo:opt.glostyle.super"><span class="glostylefmt">super</span></dfn><span class="floatrightbox"><a id="wrglossary.15609"></a><a href="#glo:pkg.glossary-super"><span class="styfmt">glossary-super</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style displays the <a id="wrglossary.15610"></a><a href="#glo:dual.glossary">glossary</a> using <a id="wrglossary.15611"></a><a href="#glo:env.supertabular"><span class="envfmt">supertabular</span></a>.<p>
+<div class="defnbox"><a id="wrglossary.15612"></a><dfn id="glo:opt.glostyle.superragged"><span class="glostylefmt">superragged</span></dfn><span class="floatrightbox"><a id="wrglossary.15613"></a><a href="#glo:pkg.glossary-superragged"><span class="styfmt">glossary-superragged</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style displays the <a id="wrglossary.15614"></a><a href="#glo:dual.glossary">glossary</a> using <a id="wrglossary.15615"></a><a href="#glo:env.supertabular"><span class="envfmt">supertabular</span></a> with ragged right paragraph formatting for the description column.<p>
+<div class="defnbox"><a id="wrglossary.15616"></a><a href="#glo:opt.glostyle.table"><span class="glostylefmt">table</span></a><span class="floatrightbox"><a id="wrglossary.15617"></a><a href="#glo:pkg.glossary-table"><span class="styfmt">glossary-table</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style is specific to <a id="wrglossary.15618"></a><a href="#glo:printunsrttable"><code class="csfmt">\printunsrttable</code></a>. <a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11563">468</a><p>
+<div class="defnbox"><a id="wrglossary.15619"></a><a href="#glo:opt.glostyle.topic"><span class="glostylefmt">topic</span></a><span class="floatrightbox"><a id="wrglossary.15620"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This style is designed for hierarchical glossaries where the top-level entry represents a topic. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11494">461</a><p>
+<div class="defnbox"><a id="wrglossary.15621"></a><a href="#glo:opt.glostyle.topicmcols"><span class="glostylefmt">topicmcols</span></a><span class="floatrightbox"><a id="wrglossary.15622"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.15623"></a><a href="#glo:opt.glostyle.topic"><span class="glostylefmt">topic</span></a> but the sub-entries are placed in a <a id="wrglossary.15624"></a><a href="#glo:env.multicols"><span class="envfmt">multicols</span></a> environment. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11497">461</a><p>
+<div class="defnbox"><a id="wrglossary.15625"></a><dfn id="glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></dfn><span class="floatrightbox"><a id="wrglossary.15626"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A hierarchical style that supports unlimited levels (although a deep hierarchy may not fit the available line width) with that shows symbols and descriptions.<p>
+<div class="defnbox"><a id="wrglossary.15627"></a><dfn id="glo:opt.glostyle.treegroup"><span class="glostylefmt">treegroup</span></dfn><span class="floatrightbox"><a id="wrglossary.15628"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15629"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a> but has headers at the start of each <a id="wrglossary.15630"></a><a href="#glo:idx.group">group</a>.<p>
+<div class="defnbox"><a id="wrglossary.15631"></a><dfn id="glo:opt.glostyle.treehypergroup"><span class="glostylefmt">treehypergroup</span></dfn><span class="floatrightbox"><a id="wrglossary.15632"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15633"></a><a href="#glo:opt.glostyle.treegroup"><span class="glostylefmt">treegroup</span></a> but has a row at the start with hyperlinks to each <a id="wrglossary.15634"></a><a href="#glo:idx.group">group</a>.<p>
+<div class="defnbox"><a id="wrglossary.15635"></a><dfn id="glo:opt.glostyle.treenoname"><span class="glostylefmt">treenoname</span></dfn><span class="floatrightbox"><a id="wrglossary.15636"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.15637"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a> but the child entries don’t have their name shown.<p>
+
+</section><!-- end of section idx.glossarystyle-optionsummary -->
+
+<section id="cmdsummary"><!-- start of section cmdsummary --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->Command Summary<div class="labellink"><a href="#cmdsummary">[link]</a></div></h1><!-- end of chapter header -->
+
+</section><!-- end of section cmdsummary -->
+
+<section id="summary.index@"><!-- start of section summary.index@ --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->@<div class="labellink"><a href="#summary.index@">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.15638"></a><a href="#glo:@glsxtr@doglossary"><code class="csfmt">\@glsxtr@doglossary</code></a><span class="floatrightbox"><a id="wrglossary.15639"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Internal command used within the construction of the <a id="wrglossary.15640"></a><a href="#glo:dual.glossary">glossary</a> code by the <a id="wrglossary.15641"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>. Should not be used or modified but <a id="wrglossary.15642"></a><a href="#glo:printunsrtglossarypredoglossary"><code class="csfmt">\printunsrtglossarypredoglossary</code></a> can be defined to show the definition of this command for debugging purposes. <a href="#sec:printunsrtadvanced">§8.4.3</a>; <a href="#wrglossary.10216">399</a><p>
+<div class="defnbox"><a id="wrglossary.15643"></a><a href="#glo:@glsxtr@multientry"><code class="csfmt">\@glsxtr@multientry</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}{<span class="meta">〈<em class="metainner">main-label</em>〉</span>}{<span class="meta">〈<em class="metainner">list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.15644"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Information in the <a id="wrglossary.15645"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> about a multi-label defined in the previous LaTeX run. <a href="#sec:multiextras">§7.13</a>; <a href="#wrglossary.9341">371</a><p>
+<div class="defnbox"><a id="wrglossary.15646"></a><a href="#glo:@glsxtr@org@@starttoc"><code class="csfmt">\@glsxtr@org@@starttoc</code></a><code class="code">{<span class="meta">〈<em class="metainner">toc</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Set to the definition of <a id="wrglossary.15647"></a><a href="#glo:@starttoc"><code class="csfmt">\@starttoc</code></a> when <a id="wrglossary.15648"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> loads. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5822">227</a><p>
+<div class="defnbox"><a id="wrglossary.15649"></a><a href="#glo:@glsxtr@org@markboth"><code class="csfmt">\@glsxtr@org@markboth</code></a><code class="code">{<span class="meta">〈<em class="metainner">left text</em>〉</span>}{<span class="meta">〈<em class="metainner">right text</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Set to the definition of <a id="wrglossary.15650"></a><a href="#glo:markboth"><code class="csfmt">\markboth</code></a> when <a id="wrglossary.15651"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> loads. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5820">227</a><p>
+<div class="defnbox"><a id="wrglossary.15652"></a><a href="#glo:@glsxtr@org@markright"><code class="csfmt">\@glsxtr@org@markright</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Set to the definition of <a id="wrglossary.15653"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a> when <a id="wrglossary.15654"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> loads. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5818">227</a><p>
+<div class="defnbox"><a id="wrglossary.15655"></a><a href="#glo:@glsxtrinmark"><code class="csfmt">\@glsxtrinmark</code></a><span class="floatrightbox"><a id="wrglossary.15656"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.07+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Redefines <a id="wrglossary.15657"></a><a href="#glo:glsxtrifinmark"><code class="csfmt">\glsxtrifinmark</code></a> to do its first argument (<span class="meta">〈<em class="metainner">true</em>〉</span>). <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5832">227</a><p>
+<div class="defnbox"><a id="wrglossary.15658"></a><a href="#glo:@glsxtrnotinmark"><code class="csfmt">\@glsxtrnotinmark</code></a><span class="floatrightbox"><a id="wrglossary.15659"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.07+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Redefines <a id="wrglossary.15660"></a><a href="#glo:glsxtrifinmark"><code class="csfmt">\glsxtrifinmark</code></a> to do its first argument (<span class="meta">〈<em class="metainner">true</em>〉</span>). <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5834">227</a><p>
+
+</section><!-- end of section summary.index@ -->
+
+<section id="summary.index6553600"><!-- start of section summary.index6553600 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->A<div class="labellink"><a href="#summary.index6553600">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.15661"></a><a href="#glo:AB"><code class="csfmt">\AB</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15662"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15663"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15664"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15665"></a><a href="#glo:cGLS"><code class="csfmt">\cGLS</code></a> defined by the <a id="wrglossary.15666"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15667"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15668"></a><a href="#glo:Ab"><code class="csfmt">\Ab</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15669"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15670"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15671"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15672"></a><a href="#glo:cGls"><code class="csfmt">\cGls</code></a> defined by the <a id="wrglossary.15673"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15674"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15675"></a><a href="#glo:ab"><code class="csfmt">\ab</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15676"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15677"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15678"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15679"></a><a href="#glo:cgls"><code class="csfmt">\cgls</code></a> defined by the <a id="wrglossary.15680"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15681"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15682"></a><a href="#glo:abbreviationsname"><code class="csfmt">\abbreviationsname</code></a><span class="floatrightbox"><span class="summarytag">initial: </span>Abbreviations; <a id="wrglossary.15683"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(language-sensitive)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Expands to the title of the <code class="code">abbreviations</code> <a id="wrglossary.15684"></a><a href="#glo:dual.glossary">glossary</a>. The default is <span class="qt">“Abbreviations”</span> or <a id="wrglossary.15685"></a><a href="#glo:acronymname"><code class="csfmt">\acronymname</code></a> if <a id="wrglossary.15686"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> has been detected. <a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.171">9</a><p>
+<div class="defnbox"><a id="wrglossary.15687"></a><a href="#glo:abbrvpluralsuffix"><code class="csfmt">\abbrvpluralsuffix</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Style-sensitive abbreviation suffix. This is the command that’s actually used in the value of the <a id="wrglossary.15688"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> key when an entry is defined with <a id="wrglossary.15689"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> (unless suppressed with the <a id="wrglossary.15690"></a><a href="#glo:opt.catattr.noshortplural"><span class="csoptfmt">noshortplural</span></a> attribute). This command is redefined by the <a id="wrglossary.15691"></a><a href="#glo:idx.abbrvstyle">abbreviation styles</a> to <a id="wrglossary.15692"></a><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a> or the style’s custom suffix command (such as <a id="wrglossary.15693"></a><a href="#glo:glsxtrscsuffix"><code class="csfmt">\glsxtrscsuffix</code></a>). <a href="#wrglossary.4312">171</a><p>
+<div class="defnbox"><a id="wrglossary.15694"></a><a href="#glo:ABP"><code class="csfmt">\ABP</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15695"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15696"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15697"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15698"></a><a href="#glo:cGLSpl"><code class="csfmt">\cGLSpl</code></a> defined by the <a id="wrglossary.15699"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15700"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15701"></a><a href="#glo:Abp"><code class="csfmt">\Abp</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15702"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15703"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15704"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15705"></a><a href="#glo:cGlspl"><code class="csfmt">\cGlspl</code></a> defined by the <a id="wrglossary.15706"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15707"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15708"></a><a href="#glo:abp"><code class="csfmt">\abp</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15709"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15710"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15711"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15712"></a><a href="#glo:cglspl"><code class="csfmt">\cglspl</code></a> defined by the <a id="wrglossary.15713"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15714"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15715"></a><a href="#glo:AC"><code class="csfmt">\AC</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15716"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15717"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15718"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15719"></a><a href="#glo:cGLS"><code class="csfmt">\cGLS</code></a> defined by the <a id="wrglossary.15720"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15721"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15722"></a><a href="#glo:Ac"><code class="csfmt">\Ac</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15723"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15724"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15725"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15726"></a><a href="#glo:cGls"><code class="csfmt">\cGls</code></a> or <a id="wrglossary.15727"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> defined by the <a id="wrglossary.15728"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15729"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> or <a id="wrglossary.15730"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15731"></a><a href="#glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></a> package option, respectively. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15732"></a><a href="#glo:ac"><code class="csfmt">\ac</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15733"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15734"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15735"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15736"></a><a href="#glo:cgls"><code class="csfmt">\cgls</code></a> or <a id="wrglossary.15737"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> defined by the <a id="wrglossary.15738"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15739"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> or <a id="wrglossary.15740"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15741"></a><a href="#glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></a> package option, respectively. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15742"></a><a href="#glo:ACF"><code class="csfmt">\ACF</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15743"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15744"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15745"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15746"></a><a href="#glo:GLSxtrfull"><code class="csfmt">\GLSxtrfull</code></a> defined by the <a id="wrglossary.15747"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15748"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15749"></a><a href="#glo:Acf"><code class="csfmt">\Acf</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15750"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15751"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15752"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15753"></a><a href="#glo:Glsxtrfull"><code class="csfmt">\Glsxtrfull</code></a> or <a id="wrglossary.15754"></a><a href="#glo:Acrfull"><code class="csfmt">\Acrfull</code></a> defined by the <a id="wrglossary.15755"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15756"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> or <a id="wrglossary.15757"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15758"></a><a href="#glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></a> package option, respectively. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15759"></a><a href="#glo:acf"><code class="csfmt">\acf</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15760"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15761"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15762"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15763"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> or <a id="wrglossary.15764"></a><a href="#glo:acrfull"><code class="csfmt">\acrfull</code></a> defined by the <a id="wrglossary.15765"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15766"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> or <a id="wrglossary.15767"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15768"></a><a href="#glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></a> package option, respectively. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15769"></a><a href="#glo:ACFP"><code class="csfmt">\ACFP</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15770"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15771"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15772"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15773"></a><a href="#glo:GLSxtrfullpl"><code class="csfmt">\GLSxtrfullpl</code></a> defined by the <a id="wrglossary.15774"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15775"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15776"></a><a href="#glo:Acfp"><code class="csfmt">\Acfp</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15777"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15778"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15779"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15780"></a><a href="#glo:Glsxtrfullpl"><code class="csfmt">\Glsxtrfullpl</code></a> or <a id="wrglossary.15781"></a><a href="#glo:Acrfullpl"><code class="csfmt">\Acrfullpl</code></a> defined by the <a id="wrglossary.15782"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15783"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> or <a id="wrglossary.15784"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15785"></a><a href="#glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></a> package option, respectively. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15786"></a><a href="#glo:acfp"><code class="csfmt">\acfp</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15787"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15788"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15789"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15790"></a><a href="#glo:glsxtrfullpl"><code class="csfmt">\glsxtrfullpl</code></a> or <a id="wrglossary.15791"></a><a href="#glo:acrfullpl"><code class="csfmt">\acrfullpl</code></a> defined by the <a id="wrglossary.15792"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15793"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> or <a id="wrglossary.15794"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15795"></a><a href="#glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></a> package option, respectively. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15796"></a><a href="#glo:ACL"><code class="csfmt">\ACL</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15797"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15798"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15799"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15800"></a><a href="#glo:GLSxtrlong"><code class="csfmt">\GLSxtrlong</code></a> defined by the <a id="wrglossary.15801"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15802"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15803"></a><a href="#glo:Acl"><code class="csfmt">\Acl</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15804"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15805"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15806"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15807"></a><a href="#glo:Glsxtrlong"><code class="csfmt">\Glsxtrlong</code></a> or <a id="wrglossary.15808"></a><a href="#glo:Acrlong"><code class="csfmt">\Acrlong</code></a> defined by the <a id="wrglossary.15809"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15810"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> or <a id="wrglossary.15811"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15812"></a><a href="#glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></a> package option, respectively. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15813"></a><a href="#glo:acl"><code class="csfmt">\acl</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15814"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15815"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15816"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15817"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> or <a id="wrglossary.15818"></a><a href="#glo:acrlong"><code class="csfmt">\acrlong</code></a> defined by the <a id="wrglossary.15819"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15820"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> or <a id="wrglossary.15821"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15822"></a><a href="#glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></a> package option, respectively. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15823"></a><a href="#glo:ACLP"><code class="csfmt">\ACLP</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15824"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15825"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15826"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15827"></a><a href="#glo:GLSxtrlongpl"><code class="csfmt">\GLSxtrlongpl</code></a> defined by the <a id="wrglossary.15828"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15829"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15830"></a><a href="#glo:Aclp"><code class="csfmt">\Aclp</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15831"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15832"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15833"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15834"></a><a href="#glo:Glsxtrlongpl"><code class="csfmt">\Glsxtrlongpl</code></a> or <a id="wrglossary.15835"></a><a href="#glo:Acrlongpl"><code class="csfmt">\Acrlongpl</code></a> defined by the <a id="wrglossary.15836"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15837"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> or <a id="wrglossary.15838"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15839"></a><a href="#glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></a> package option, respectively. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15840"></a><a href="#glo:aclp"><code class="csfmt">\aclp</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15841"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15842"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15843"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15844"></a><a href="#glo:glsxtrlongpl"><code class="csfmt">\glsxtrlongpl</code></a> or <a id="wrglossary.15845"></a><a href="#glo:acrlongpl"><code class="csfmt">\acrlongpl</code></a> defined by the <a id="wrglossary.15846"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15847"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> or <a id="wrglossary.15848"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15849"></a><a href="#glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></a> package option, respectively. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15850"></a><a href="#glo:ACP"><code class="csfmt">\ACP</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15851"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15852"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15853"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15854"></a><a href="#glo:cGLSpl"><code class="csfmt">\cGLSpl</code></a> defined by the <a id="wrglossary.15855"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15856"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15857"></a><a href="#glo:Acp"><code class="csfmt">\Acp</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15858"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15859"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15860"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15861"></a><a href="#glo:cGlspl"><code class="csfmt">\cGlspl</code></a> or <a id="wrglossary.15862"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> defined by the <a id="wrglossary.15863"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15864"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> or <a id="wrglossary.15865"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15866"></a><a href="#glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></a> package option, respectively. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15867"></a><a href="#glo:acp"><code class="csfmt">\acp</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15868"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15869"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15870"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15871"></a><a href="#glo:cglspl"><code class="csfmt">\cglspl</code></a> or <a id="wrglossary.15872"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> defined by the <a id="wrglossary.15873"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15874"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> or <a id="wrglossary.15875"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15876"></a><a href="#glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></a> package option, respectively. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15877"></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><dfn id="glo:Acrfull"><code class="csfmt">\Acrfull</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15878"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15879"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15880"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15881"></a><a href="#glo:acrfull"><code class="csfmt">\acrfull</code></a> but <a id="wrglossary.15882"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="defnbox"><a id="wrglossary.15883"></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><dfn id="glo:acrfull"><code class="csfmt">\acrfull</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15884"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15885"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15886"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the full form of an acronym. Only for use with the base <a id="wrglossary.15887"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s acronym mechanism. This command is not compatible with <a id="wrglossary.15888"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.15889"></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><dfn id="glo:Acrfullpl"><code class="csfmt">\Acrfullpl</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15890"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15891"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15892"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15893"></a><a href="#glo:acrfullpl"><code class="csfmt">\acrfullpl</code></a> but <a id="wrglossary.15894"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="defnbox"><a id="wrglossary.15895"></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><dfn id="glo:acrfullpl"><code class="csfmt">\acrfullpl</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15896"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15897"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15898"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the plural full form of an acronym. Only for use with the base <a id="wrglossary.15899"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s acronym mechanism. This command is not compatible with <a id="wrglossary.15900"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.15901"></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><dfn id="glo:Acrlong"><code class="csfmt">\Acrlong</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15902"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15903"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15904"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15905"></a><a href="#glo:acrlong"><code class="csfmt">\acrlong</code></a> but <a id="wrglossary.15906"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="defnbox"><a id="wrglossary.15907"></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><dfn id="glo:acrlong"><code class="csfmt">\acrlong</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15908"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15909"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15910"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the long form of an acronym. Only for use with the base <a id="wrglossary.15911"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s acronym mechanism. This command is not compatible with <a id="wrglossary.15912"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.15913"></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><dfn id="glo:Acrlongpl"><code class="csfmt">\Acrlongpl</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15914"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15915"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15916"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15917"></a><a href="#glo:acrlong"><code class="csfmt">\acrlong</code></a> but <a id="wrglossary.15918"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="defnbox"><a id="wrglossary.15919"></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><dfn id="glo:acrlongpl"><code class="csfmt">\acrlongpl</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15920"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15921"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15922"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the plural long form of an acronym. Only for use with the base <a id="wrglossary.15923"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s acronym mechanism. This command is not compatible with <a id="wrglossary.15924"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.15925"></a><dfn id="glo:acronymfont"><code class="csfmt">\acronymfont</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.15926"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v1.0+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to encapsulate the acronym short form on <a id="wrglossary.15927"></a><a href="#glo:dual.subsequentuse">subsequent use</a> by the base <a id="wrglossary.15928"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. This is redefined by <a id="wrglossary.15929"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> to use <a id="wrglossary.15930"></a><a href="#glo:glsabbrvfont"><code class="csfmt">\glsabbrvfont</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.15931"></a><dfn id="glo:acronymname"><code class="csfmt">\acronymname</code></dfn><span class="floatrightbox"><span class="summarytag">initial: </span>Acronyms; <a id="wrglossary.15932"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(language-sensitive)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Expands to the title of the <code class="code">acronym</code> <a id="wrglossary.15933"></a><a href="#glo:dual.glossary">glossary</a>.<p>
+<div class="defnbox"><a id="wrglossary.15934"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>; <a id="wrglossary.15935"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the label of the default acronym <a id="wrglossary.15936"></a><a href="#glo:dual.glossary">glossary</a>. The <a id="wrglossary.15937"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> or <a id="wrglossary.15938"></a><a href="#glo:opt.acronyms"><span class="styoptfmt">acronyms</span></a> package option will redefine this to <code class="code">acronym</code>. The <a id="wrglossary.15939"></a><a href="#glo:opt.abbreviations"><span class="styoptfmt">abbreviations</span></a> package option will redefine this to <a id="wrglossary.15940"></a><a href="#glo:glsxtrabbrvtype"><code class="csfmt">\glsxtrabbrvtype</code></a> if <a id="wrglossary.15941"></a><a href="#glo:opt.acronyms"><span class="styoptfmt">acronyms</span></a>/<a id="wrglossary.15942"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> isn’t used. <a href="#sec:abbrvfieldstype">§4.1.4</a>; <a href="#wrglossary.1362">44</a><p>
+<div class="defnbox"><a id="wrglossary.15943"></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><dfn id="glo:acrpluralsuffix"><code class="csfmt">\acrpluralsuffix</code></dfn></div><!-- end of defnbox -->
+<p>
+Used for the plural suffixes for the base package’s acronym mechanism. Not used with <a id="wrglossary.15944"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>’s abbreviations, which use <a id="wrglossary.15945"></a><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a>, <a id="wrglossary.15946"></a><a href="#glo:abbrvpluralsuffix"><code class="csfmt">\abbrvpluralsuffix</code></a> and commands provided for use with particular <a id="wrglossary.15947"></a><a href="#glo:idx.abbrvstyle">abbreviation styles</a>. This command should not be used with <a id="wrglossary.15948"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.<p>
+<div class="defnbox"><a id="wrglossary.15949"></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><dfn id="glo:Acrshort"><code class="csfmt">\Acrshort</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15950"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15951"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15952"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15953"></a><a href="#glo:acrshort"><code class="csfmt">\acrshort</code></a> but <a id="wrglossary.15954"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="defnbox"><a id="wrglossary.15955"></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><dfn id="glo:acrshort"><code class="csfmt">\acrshort</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15956"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15957"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15958"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the short form of an acronym. Only for use with the base <a id="wrglossary.15959"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s acronym mechanism. This command is not compatible with <a id="wrglossary.15960"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.15961"></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><dfn id="glo:Acrshortpl"><code class="csfmt">\Acrshortpl</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15962"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15963"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15964"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.15965"></a><a href="#glo:acrshort"><code class="csfmt">\acrshort</code></a> but <a id="wrglossary.15966"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="defnbox"><a id="wrglossary.15967"></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><dfn id="glo:acrshortpl"><code class="csfmt">\acrshortpl</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15968"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15969"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15970"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the plural short form of an acronym. Only for use with the base <a id="wrglossary.15971"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s acronym mechanism. This command is not compatible with <a id="wrglossary.15972"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.15973"></a><a href="#glo:ACS"><code class="csfmt">\ACS</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15974"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15975"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15976"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15977"></a><a href="#glo:GLSxtrshort"><code class="csfmt">\GLSxtrshort</code></a> defined by the <a id="wrglossary.15978"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15979"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15980"></a><a href="#glo:Acs"><code class="csfmt">\Acs</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15981"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15982"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15983"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15984"></a><a href="#glo:Glsxtrshort"><code class="csfmt">\Glsxtrshort</code></a> or <a id="wrglossary.15985"></a><a href="#glo:Acrshort"><code class="csfmt">\Acrshort</code></a> defined by the <a id="wrglossary.15986"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15987"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> or <a id="wrglossary.15988"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15989"></a><a href="#glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></a> package option, respectively. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.15990"></a><a href="#glo:acs"><code class="csfmt">\acs</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.15991"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.15992"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.15993"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.15994"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> or <a id="wrglossary.15995"></a><a href="#glo:acrshort"><code class="csfmt">\acrshort</code></a> defined by the <a id="wrglossary.15996"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15997"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> or <a id="wrglossary.15998"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.15999"></a><a href="#glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></a> package option, respectively. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.16000"></a><a href="#glo:ACSP"><code class="csfmt">\ACSP</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16001"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16002"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16003"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.16004"></a><a href="#glo:GLSxtrshortpl"><code class="csfmt">\GLSxtrshortpl</code></a> defined by the <a id="wrglossary.16005"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16006"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.16007"></a><a href="#glo:Acsp"><code class="csfmt">\Acsp</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16008"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16009"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16010"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.16011"></a><a href="#glo:Glsxtrshortpl"><code class="csfmt">\Glsxtrshortpl</code></a> or <a id="wrglossary.16012"></a><a href="#glo:Acrshortpl"><code class="csfmt">\Acrshortpl</code></a> defined by the <a id="wrglossary.16013"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16014"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> or <a id="wrglossary.16015"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16016"></a><a href="#glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></a> package option, respectively. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.16017"></a><a href="#glo:acsp"><code class="csfmt">\acsp</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16018"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16019"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16020"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.16021"></a><a href="#glo:glsxtrshortpl"><code class="csfmt">\glsxtrshortpl</code></a> or <a id="wrglossary.16022"></a><a href="#glo:acrshortpl"><code class="csfmt">\acrshortpl</code></a> defined by the <a id="wrglossary.16023"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16024"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> or <a id="wrglossary.16025"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16026"></a><a href="#glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></a> package option, respectively. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.16027"></a><a href="#glo:AF"><code class="csfmt">\AF</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16028"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16029"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16030"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.16031"></a><a href="#glo:Glsxtrfull"><code class="csfmt">\Glsxtrfull</code></a> defined by the <a id="wrglossary.16032"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16033"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.16034"></a><a href="#glo:Af"><code class="csfmt">\Af</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16035"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16036"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16037"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.16038"></a><a href="#glo:Glsxtrfull"><code class="csfmt">\Glsxtrfull</code></a> defined by the <a id="wrglossary.16039"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16040"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.16041"></a><a href="#glo:af"><code class="csfmt">\af</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16042"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16043"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16044"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.16045"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> defined by the <a id="wrglossary.16046"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16047"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.16048"></a><a href="#glo:AFP"><code class="csfmt">\AFP</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16049"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16050"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16051"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.16052"></a><a href="#glo:GLSxtrfullpl"><code class="csfmt">\GLSxtrfullpl</code></a> defined by the <a id="wrglossary.16053"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16054"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.16055"></a><a href="#glo:Afp"><code class="csfmt">\Afp</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16056"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16057"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16058"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.16059"></a><a href="#glo:Glsxtrfullpl"><code class="csfmt">\Glsxtrfullpl</code></a> defined by the <a id="wrglossary.16060"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16061"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.16062"></a><a href="#glo:afp"><code class="csfmt">\afp</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16063"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16064"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16065"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.16066"></a><a href="#glo:glsxtrfullpl"><code class="csfmt">\glsxtrfullpl</code></a> defined by the <a id="wrglossary.16067"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16068"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.16069"></a><a href="#glo:AL"><code class="csfmt">\AL</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16070"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16071"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16072"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.16073"></a><a href="#glo:GLSxtrlong"><code class="csfmt">\GLSxtrlong</code></a> defined by the <a id="wrglossary.16074"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16075"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.16076"></a><a href="#glo:Al"><code class="csfmt">\Al</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16077"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16078"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16079"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.16080"></a><a href="#glo:Glsxtrlong"><code class="csfmt">\Glsxtrlong</code></a> defined by the <a id="wrglossary.16081"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16082"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.16083"></a><a href="#glo:al"><code class="csfmt">\al</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16084"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16085"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16086"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.16087"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> defined by the <a id="wrglossary.16088"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16089"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.16090"></a><a href="#glo:ALP"><code class="csfmt">\ALP</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16091"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16092"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16093"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.16094"></a><a href="#glo:GLSxtrlongpl"><code class="csfmt">\GLSxtrlongpl</code></a> defined by the <a id="wrglossary.16095"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16096"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.16097"></a><a href="#glo:Alp"><code class="csfmt">\Alp</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16098"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16099"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16100"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.16101"></a><a href="#glo:Glsxtrlongpl"><code class="csfmt">\Glsxtrlongpl</code></a> defined by the <a id="wrglossary.16102"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16103"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.16104"></a><a href="#glo:alp"><code class="csfmt">\alp</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16105"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16106"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16107"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.16108"></a><a href="#glo:glsxtrlongpl"><code class="csfmt">\glsxtrlongpl</code></a> defined by the <a id="wrglossary.16109"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16110"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.16111"></a><a href="#glo:Alpha"><code class="csfmt">\Alpha</code></a><span class="floatrightbox"><a id="wrglossary.16112"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.16113"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a>, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{A}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13971">573</a><p>
+<div class="defnbox"><a id="wrglossary.16114"></a><dfn id="glo:alsoname"><code class="csfmt">\alsoname</code></dfn><span class="floatrightbox"><span class="summarytag">initial: </span>see also</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(language-sensitive)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Used as a cross-reference tag (provided by language packages, such as <a id="wrglossary.16115"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>).<p>
+<div class="defnbox"><a id="wrglossary.16116"></a><dfn id="glo:andname"><code class="csfmt">\andname</code></dfn><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:amp"><code class="csfmt">\&amp;</code></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.16117"></a><a href="#glo:glsseelastsep"><code class="csfmt">\glsseelastsep</code></a> (provided by <a id="wrglossary.16118"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> if not already defined).<p>
+<div class="defnbox"><a id="wrglossary.16119"></a><a href="#glo:apptoglossarypreamble"><code class="csfmt">\apptoglossarypreamble</code></a><code class="code">[<span class="meta">〈<em class="metainner">type</em>〉</span>]{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16120"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Appends (locally) <span class="meta">〈<em class="metainner">text</em>〉</span> to the preamble for the glossary identified by <span class="meta">〈<em class="metainner">type</em>〉</span>. If <span class="meta">〈<em class="metainner">type</em>〉</span> is omitted, <a id="wrglossary.16121"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a> is assumed. <a href="#sec:glospreamble">§8.2</a>; <a href="#wrglossary.9506">377</a><p>
+<div class="defnbox"><a id="wrglossary.16122"></a><a href="#glo:AS"><code class="csfmt">\AS</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16123"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16124"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16125"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.16126"></a><a href="#glo:GLSxtrshort"><code class="csfmt">\GLSxtrshort</code></a> defined by the <a id="wrglossary.16127"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16128"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.16129"></a><a href="#glo:As"><code class="csfmt">\As</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16130"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16131"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16132"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.16133"></a><a href="#glo:Glsxtrshort"><code class="csfmt">\Glsxtrshort</code></a> defined by the <a id="wrglossary.16134"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16135"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.16136"></a><a href="#glo:as"><code class="csfmt">\as</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16137"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16138"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16139"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.16140"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> defined by the <a id="wrglossary.16141"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16142"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.16143"></a><a href="#glo:ASP"><code class="csfmt">\ASP</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16144"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16145"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16146"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.16147"></a><a href="#glo:GLSxtrshortpl"><code class="csfmt">\GLSxtrshortpl</code></a> defined by the <a id="wrglossary.16148"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16149"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.16150"></a><a href="#glo:Asp"><code class="csfmt">\Asp</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16151"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16152"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16153"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.16154"></a><a href="#glo:Glsxtrshortpl"><code class="csfmt">\Glsxtrshortpl</code></a> defined by the <a id="wrglossary.16155"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16156"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.16157"></a><a href="#glo:asp"><code class="csfmt">\asp</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">inset</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16158"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16159"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16160"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.16161"></a><a href="#glo:glsxtrshortpl"><code class="csfmt">\glsxtrshortpl</code></a> defined by the <a id="wrglossary.16162"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.16163"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+
+</section><!-- end of section summary.index6553600 -->
+
+<section id="summary.index6619136"><!-- start of section summary.index6619136 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->B<div class="labellink"><a href="#summary.index6619136">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.16164"></a><a href="#glo:Beta"><code class="csfmt">\Beta</code></a><span class="floatrightbox"><a id="wrglossary.16165"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.16166"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a>, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{B}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13972">573</a><p>
+<div class="defnbox"><a id="wrglossary.16167"></a><dfn id="glo:bibgls@input"><code class="csfmt">\bibgls@input</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">filename</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16168"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indicates that the <a id="wrglossary.16169"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> records are in the file identified in the argument <span class="meta">〈<em class="metainner">filename</em>〉</span>, which corresponds to the file <span class="filefmt"></span><span class="meta">〈<em class="metainner">basename</em>〉</span><span class="filefmt">.aux</span> identified in the option <a id="wrglossary.16170"></a><a href="#glo:opt.bibglsaux"><span class="styoptfmt">bibglsaux</span></a><span class="optfmt">=<span class="meta">〈<em class="metainner">basename</em>〉</span></span>.<p>
+<div class="defnbox"><a id="wrglossary.16171"></a><a href="#glo:bibglsdualprefixlabel"><code class="csfmt">\bibglsdualprefixlabel</code></a><code class="code">{<span class="meta">〈<em class="metainner">label-prefix</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16172"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v1.8+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook written to the <a id="wrglossary.16173"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file identifying the dual label prefix. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13911">571</a><p>
+<div class="defnbox"><a id="wrglossary.16174"></a><dfn id="glo:bibglsnewdualindexsymbolsecondary"><code class="csfmt">\bibglsnewdualindexsymbolsecondary</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">name</em>〉</span>}{<span class="meta">〈<em class="metainner">description</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16175"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines secondary terms provided with <code class="code">@dualindexsymbol</code>.<p>
+<div class="defnbox"><a id="wrglossary.16176"></a><a href="#glo:bibglsprimaryprefixlabel"><code class="csfmt">\bibglsprimaryprefixlabel</code></a><code class="code">{<span class="meta">〈<em class="metainner">label-prefix</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16177"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v1.8+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook written to the <a id="wrglossary.16178"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file identifying the primary label prefix. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13912">571</a><p>
+<div class="defnbox"><a id="wrglossary.16179"></a><dfn id="glo:bibglssetlastgrouptitle"><code class="csfmt">\bibglssetlastgrouptitle</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">specs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16180"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the last group title.<p>
+<div class="defnbox"><a id="wrglossary.16181"></a><a href="#glo:bibglssetlocationrecordcount"><code class="csfmt">\bibglssetlocationrecordcount</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16182"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v1.1+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the location record count for the given entry. <a href="#sec:unitrecordcountminigloss">§11.4.2</a>; <a href="#wrglossary.13006">532</a><p>
+<div class="defnbox"><a id="wrglossary.16183"></a><a href="#glo:bibglssetrecordcount"><code class="csfmt">\bibglssetrecordcount</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16184"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v1.1+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the <span class="meta">〈<em class="metainner">counter</em>〉</span> record count for the given entry. <a href="#sec:unitrecordcountminigloss">§11.4.2</a>; <a href="#wrglossary.13001">532</a><p>
+<div class="defnbox"><a id="wrglossary.16185"></a><a href="#glo:bibglssettotalrecordcount"><code class="csfmt">\bibglssettotalrecordcount</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16186"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v1.1+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the total record count for the given entry. <a href="#sec:unitrecordcountminigloss">§11.4.2</a>; <a href="#wrglossary.12996">531</a><p>
+<div class="defnbox"><a id="wrglossary.16187"></a><a href="#glo:bibglstertiaryprefixlabel"><code class="csfmt">\bibglstertiaryprefixlabel</code></a><code class="code">{<span class="meta">〈<em class="metainner">label-prefix</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16188"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v1.8+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook written to the <a id="wrglossary.16189"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file identifying the tertiary label prefix. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13910">571</a><p>
+
+</section><!-- end of section summary.index6619136 -->
+
+<section id="summary.index6684672"><!-- start of section summary.index6684672 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->C<div class="labellink"><a href="#summary.index6684672">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.16190"></a><dfn id="glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16191"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.03+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Converts <span class="meta">〈<em class="metainner">text</em>〉</span> to <a id="wrglossary.16192"></a><a href="#glo:idx.titlecase">title case</a>, where <span class="meta">〈<em class="metainner">text</em>〉</span> may contain text-block commands. The starred form only permits a text-block command at the start of the argument. Limitations apply, see the <a id="wrglossary.16193"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> documentation for further details, either: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div><a href="https://www.tug.org/texdoc/">texdoc</a> mfirstuc</pre> or visit <a href="https://ctan.org/pkg/mfirstuc">ctan.org/pkg/mfirstuc</a>.<p>
+<div class="defnbox"><a id="wrglossary.16194"></a><dfn id="glo:capitalisewords"><code class="csfmt">\capitalisewords</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16195"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v1.06+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Converts <span class="meta">〈<em class="metainner">text</em>〉</span> to <a id="wrglossary.16196"></a><a href="#glo:idx.titlecase">title case</a>. Limitations apply, see the <a id="wrglossary.16197"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> documentation for further details, either: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div><a href="https://www.tug.org/texdoc/">texdoc</a> mfirstuc</pre> or visit <a href="https://ctan.org/pkg/mfirstuc">ctan.org/pkg/mfirstuc</a>.<p>
+<div class="defnbox"><a id="wrglossary.16198"></a><a href="#glo:cGLS"><code class="csfmt">\cGLS</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16199"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16200"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16201"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.16202"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a> but hooks into the entry counting mechanism. <a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8033">311</a><p>
+<div class="defnbox"><a id="wrglossary.16203"></a><a href="#glo:cGls"><code class="csfmt">\cGls</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16204"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16205"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16206"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.16207"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.16208"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> but hooks into the entry counting mechanism. <a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8016">310</a><p>
+<div class="defnbox"><a id="wrglossary.16209"></a><a href="#glo:cgls"><code class="csfmt">\cgls</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16210"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16211"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16212"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.16213"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.16214"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> but hooks into the entry counting mechanism. <a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.7995">309</a><p>
+<div class="defnbox"><a id="wrglossary.16215"></a><a href="#glo:cGLSformat"><code class="csfmt">\cGLSformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Format used by <a id="wrglossary.16216"></a><a href="#glo:cGLS"><code class="csfmt">\cGLS</code></a> if the entry was not used more than the given trigger value on the previous run. <a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8038">311</a><p>
+<div class="defnbox"><a id="wrglossary.16217"></a><a href="#glo:cGlsformat"><code class="csfmt">\cGlsformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16218"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Format used by <a id="wrglossary.16219"></a><a href="#glo:cGls"><code class="csfmt">\cGls</code></a> if the entry was not used more than the given trigger value on the previous run. <a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8021">310</a><p>
+<div class="defnbox"><a id="wrglossary.16220"></a><a href="#glo:cglsformat"><code class="csfmt">\cglsformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16221"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Format used by <a id="wrglossary.16222"></a><a href="#glo:cgls"><code class="csfmt">\cgls</code></a> if the entry was not used more than the given trigger value on the previous run. <a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8000">310</a><p>
+<div class="defnbox"><a id="wrglossary.16223"></a><a href="#glo:cGLSpl"><code class="csfmt">\cGLSpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16224"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16225"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16226"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.16227"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a> but hooks into the entry counting mechanism. <a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8041">311</a><p>
+<div class="defnbox"><a id="wrglossary.16228"></a><a href="#glo:cGlspl"><code class="csfmt">\cGlspl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16229"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16230"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16231"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.16232"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.16233"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a> but hooks into the entry counting mechanism. <a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8024">310</a><p>
+<div class="defnbox"><a id="wrglossary.16234"></a><a href="#glo:cglspl"><code class="csfmt">\cglspl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16235"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16236"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16237"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.16238"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.16239"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> but hooks into the entry counting mechanism. <a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8009">310</a><p>
+<div class="defnbox"><a id="wrglossary.16240"></a><a href="#glo:cGLSplformat"><code class="csfmt">\cGLSplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Format used by <a id="wrglossary.16241"></a><a href="#glo:cGLSpl"><code class="csfmt">\cGLSpl</code></a> if the entry was not used more than the given trigger value on the previous run. <a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8046">311</a><p>
+<div class="defnbox"><a id="wrglossary.16242"></a><a href="#glo:cGlsplformat"><code class="csfmt">\cGlsplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16243"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Format used by <a id="wrglossary.16244"></a><a href="#glo:cGlspl"><code class="csfmt">\cGlspl</code></a> if the entry was not used more than the given trigger value on the previous run. <a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8029">311</a><p>
+<div class="defnbox"><a id="wrglossary.16245"></a><a href="#glo:cglsplformat"><code class="csfmt">\cglsplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16246"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Format used by <a id="wrglossary.16247"></a><a href="#glo:cglspl"><code class="csfmt">\cglspl</code></a> if the entry was not used more than the given trigger value on the previous run. <a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8014">310</a><p>
+<div class="defnbox"><a id="wrglossary.16248"></a><a href="#glo:Chi"><code class="csfmt">\Chi</code></a><span class="floatrightbox"><a id="wrglossary.16249"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.16250"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a>, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{X}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13983">573</a><p>
+<div class="defnbox"><a id="wrglossary.16251"></a><a href="#glo:csGlsXtrLetField"><code class="csfmt">\csGlsXtrLetField</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">cs-name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16252"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.16253"></a><a href="#glo:GlsXtrLetField"><code class="csfmt">\GlsXtrLetField</code></a> but internally uses (<a id="wrglossary.16254"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a>) <a id="wrglossary.16255"></a><a href="#glo:csletcs"><code class="csfmt">\csletcs</code></a> instead of <a id="wrglossary.16256"></a><a href="#glo:cslet"><code class="csfmt">\cslet</code></a>. <a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1214">40</a><p>
+<div class="defnbox"><a id="wrglossary.16257"></a><dfn id="glo:currentglossary"><code class="csfmt">\currentglossary</code></dfn><span class="floatrightbox"><a id="wrglossary.16258"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.0+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined by the <code class="csfmt">\print…glossary</code> commands to the current <a id="wrglossary.16259"></a><a href="#glo:dual.glossary">glossary</a> label.<p>
+<div class="defnbox"><a id="wrglossary.16260"></a><a href="#glo:CustomAbbreviationFields"><code class="csfmt">\CustomAbbreviationFields</code></a></div><!-- end of defnbox -->
+<p>
+Expands to the default field definitions for the entry. <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4093">165</a><p>
+
+</section><!-- end of section summary.index6684672 -->
+
+<section id="summary.index6750208"><!-- start of section summary.index6750208 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->D<div class="labellink"><a href="#summary.index6750208">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.16261"></a><dfn id="glo:defglsentryfmt"><code class="csfmt">\defglsentryfmt</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">type</em>〉</span>]{<span class="meta">〈<em class="metainner">display</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16262"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Overrides the default display format (<a id="wrglossary.16263"></a><a href="#glo:glsentryfmt"><code class="csfmt">\glsentryfmt</code></a>) for the given glossary. If <span class="meta">〈<em class="metainner">type</em>〉</span> is omitted, <a id="wrglossary.16264"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a> is assumed. This will make the <a id="wrglossary.16265"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands do <span class="meta">〈<em class="metainner">display</em>〉</span> for any entries that have the <a id="wrglossary.16266"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> field set to the given <span class="meta">〈<em class="metainner">type</em>〉</span>. If you want to support any abbreviation styles, you need to include <a id="wrglossary.16267"></a><a href="#glo:glssetabbrvfmt"><code class="csfmt">\glssetabbrvfmt</code></a> in <span class="meta">〈<em class="metainner">display</em>〉</span>. Non-regular abbreviation styles are designed to work with <a id="wrglossary.16268"></a><a href="#glo:glsxtrgenabbrvfmt"><code class="csfmt">\glsxtrgenabbrvfmt</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.16269"></a><dfn id="glo:delimN"><code class="csfmt">\delimN</code></dfn><span class="floatrightbox"><a id="wrglossary.16270"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used as a separator between <a id="wrglossary.16271"></a><a href="#glo:@@glslabel@entrylocation">locations</a>.<p>
+<div class="defnbox"><a id="wrglossary.16272"></a><dfn id="glo:delimR"><code class="csfmt">\delimR</code></dfn><span class="floatrightbox"><a id="wrglossary.16273"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used between the start and end of a <a id="wrglossary.16274"></a><a href="#glo:@@glslabel@entrylocation">location</a> range.<p>
+<div class="defnbox"><a id="wrglossary.16275"></a><dfn id="glo:descriptionname"><code class="csfmt">\descriptionname</code></dfn><span class="floatrightbox"><span class="summarytag">initial: </span>Description; <a id="wrglossary.16276"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(language-sensitive)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Expands to the title of the description column for headed <a id="wrglossary.16277"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>-like styles.<p>
+<div class="defnbox"><a id="wrglossary.16278"></a><a href="#glo:dGLS"><code class="csfmt">\dGLS</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16279"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16280"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16281"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.16282"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16283"></a><a href="#glo:dgls"><code class="csfmt">\dgls</code></a> but uses <a id="wrglossary.16284"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a>. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13769">565</a><p>
+<div class="defnbox"><a id="wrglossary.16285"></a><a href="#glo:dGls"><code class="csfmt">\dGls</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16286"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16287"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16288"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.16289"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16290"></a><a href="#glo:dgls"><code class="csfmt">\dgls</code></a> but uses <a id="wrglossary.16291"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13759">565</a><p>
+<div class="defnbox"><a id="wrglossary.16292"></a><a href="#glo:dgls"><code class="csfmt">\dgls</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16293"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16294"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16295"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.16296"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <code class="code"><a id="wrglossary.16297"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span>{entry-label}}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code> for the first prefix in the prefix list that matches a defined entry. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13748">564</a><p>
+<div class="defnbox"><a id="wrglossary.16298"></a><a href="#glo:dGlsdisp"><code class="csfmt">\dGlsdisp</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16299"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16300"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16301"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.16302"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16303"></a><a href="#glo:dglsdisp"><code class="csfmt">\dglsdisp</code></a> but applies <a id="wrglossary.16304"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13794">565</a><p>
+<div class="defnbox"><a id="wrglossary.16305"></a><a href="#glo:dglsdisp"><code class="csfmt">\dglsdisp</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16306"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16307"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16308"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.16309"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16310"></a><a href="#glo:dgls"><code class="csfmt">\dgls</code></a> but uses <a id="wrglossary.16311"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a>. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13789">565</a><p>
+<div class="defnbox"><a id="wrglossary.16312"></a><a href="#glo:dGLSfield"><code class="csfmt">\dGLSfield</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16313"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16314"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16315"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.16316"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16317"></a><a href="#glo:dglsfield"><code class="csfmt">\dglsfield</code></a> but <a id="wrglossary.16318"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13810">566</a><p>
+<div class="defnbox"><a id="wrglossary.16319"></a><a href="#glo:dGlsfield"><code class="csfmt">\dGlsfield</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16320"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16321"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16322"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.16323"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16324"></a><a href="#glo:dglsfield"><code class="csfmt">\dglsfield</code></a> but applies <a id="wrglossary.16325"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13805">566</a><p>
+<div class="defnbox"><a id="wrglossary.16326"></a><a href="#glo:dglsfield"><code class="csfmt">\dglsfield</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16327"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16328"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16329"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.16330"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16331"></a><a href="#glo:dgls"><code class="csfmt">\dgls</code></a> but selects the first matching label that has an entry with the field set. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13799">566</a><p>
+<div class="defnbox"><a id="wrglossary.16332"></a><a href="#glo:dglsfieldactualfieldlabel"><code class="csfmt">\dglsfieldactualfieldlabel</code></a><span class="floatrightbox"><a id="wrglossary.16333"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Set by the <a id="wrglossary.16334"></a><a href="#glo:dglsfield"><code class="csfmt">\dglsfield</code></a> family of commands to the actual field used. This will either be the requested field or the fallback field. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13835">567</a><p>
+<div class="defnbox"><a id="wrglossary.16335"></a><a href="#glo:dglsfieldcurrentfieldlabel"><code class="csfmt">\dglsfieldcurrentfieldlabel</code></a><span class="floatrightbox"><a id="wrglossary.16336"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Set by the <a id="wrglossary.16337"></a><a href="#glo:dglsfield"><code class="csfmt">\dglsfield</code></a> family of commands to the given <span class="meta">〈<em class="metainner">field-label</em>〉</span>. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13831">567</a><p>
+<div class="defnbox"><a id="wrglossary.16338"></a><a href="#glo:dglsfieldfallbackfieldlabel"><code class="csfmt">\dglsfieldfallbackfieldlabel</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a>; <a id="wrglossary.16339"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the fallback field to use for the <a id="wrglossary.16340"></a><a href="#glo:dglsfield"><code class="csfmt">\dglsfield</code></a> family of commands. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13833">567</a><p>
+<div class="defnbox"><a id="wrglossary.16341"></a><a href="#glo:dGlslink"><code class="csfmt">\dGlslink</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16342"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16343"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16344"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.16345"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16346"></a><a href="#glo:dglslink"><code class="csfmt">\dglslink</code></a> but applies <a id="wrglossary.16347"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13784">565</a><p>
+<div class="defnbox"><a id="wrglossary.16348"></a><a href="#glo:dglslink"><code class="csfmt">\dglslink</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16349"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16350"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16351"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.16352"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16353"></a><a href="#glo:dgls"><code class="csfmt">\dgls</code></a> but uses <a id="wrglossary.16354"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a>. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13779">565</a><p>
+<div class="defnbox"><a id="wrglossary.16355"></a><a href="#glo:dGLSpl"><code class="csfmt">\dGLSpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16356"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16357"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16358"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.16359"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16360"></a><a href="#glo:dgls"><code class="csfmt">\dgls</code></a> but uses <a id="wrglossary.16361"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a>. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13774">565</a><p>
+<div class="defnbox"><a id="wrglossary.16362"></a><a href="#glo:dGlspl"><code class="csfmt">\dGlspl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16363"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16364"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16365"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.16366"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16367"></a><a href="#glo:dgls"><code class="csfmt">\dgls</code></a> but uses <a id="wrglossary.16368"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a>. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13764">565</a><p>
+<div class="defnbox"><a id="wrglossary.16369"></a><a href="#glo:dglspl"><code class="csfmt">\dglspl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16370"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16371"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16372"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.16373"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16374"></a><a href="#glo:dgls"><code class="csfmt">\dgls</code></a> but uses <a id="wrglossary.16375"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13754">564</a><p>
+<div class="defnbox"><a id="wrglossary.16376"></a><a href="#glo:Digamma"><code class="csfmt">\Digamma</code></a><span class="floatrightbox"><a id="wrglossary.16377"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.16378"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a>, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{F}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13984">573</a><p>
+<div class="defnbox"><a id="wrglossary.16379"></a><dfn id="glo:doifglossarynoexistsordo"><code class="csfmt">\doifglossarynoexistsordo</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">glossary-type</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16380"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.19+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If the <a id="wrglossary.16381"></a><a href="#glo:dual.glossary">glossary</a> given by <span class="meta">〈<em class="metainner">glossary-type</em>〉</span> doesn’t exist, this does <span class="meta">〈<em class="metainner">true</em>〉</span>, otherwise it generates an error and does <span class="meta">〈<em class="metainner">false</em>〉</span>. This uses the starred form of <a id="wrglossary.16382"></a><a href="#glo:ifglossaryexists"><code class="csfmt">\ifglossaryexists</code></a> to test for existence.<p>
+<div class="defnbox"><a id="wrglossary.16383"></a><dfn id="glo:DTLformatlist"><code class="csfmt">\DTLformatlist</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">csv-list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16384"></a><a href="#glo:pkg.datatool-base"><span class="styfmt">datatool-base</span></a> v2.28+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the comma-separated list <span class="meta">〈<em class="metainner">csv-list</em>〉</span>. One-level expansion is performed on <span class="meta">〈<em class="metainner">csv-list</em>〉</span>. See the <a id="wrglossary.16385"></a><a href="#glo:pkg.datatool"><span class="styfmt">datatool</span></a> documentation for further details, either: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div><a href="https://www.tug.org/texdoc/">texdoc</a> datatool</pre> or visit <a href="https://ctan.org/pkg/datatool">ctan.org/pkg/datatool</a>.<p>
+<div class="defnbox"><a id="wrglossary.16386"></a><dfn id="glo:DTLifinlist"><code class="csfmt">\DTLifinlist</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">element</em>〉</span>}{<span class="meta">〈<em class="metainner">csv-list</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16387"></a><a href="#glo:pkg.datatool-base"><span class="styfmt">datatool-base</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if <span class="meta">〈<em class="metainner">element</em>〉</span> is contained in the comma-separated list <span class="meta">〈<em class="metainner">csv-list</em>〉</span>, otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>. One-level expansion is performed on <span class="meta">〈<em class="metainner">csv-list</em>〉</span>, but not on <span class="meta">〈<em class="metainner">element</em>〉</span>. See the <a id="wrglossary.16388"></a><a href="#glo:pkg.datatool"><span class="styfmt">datatool</span></a> documentation for further details, either: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div><a href="https://www.tug.org/texdoc/">texdoc</a> datatool</pre> or visit <a href="https://ctan.org/pkg/datatool">ctan.org/pkg/datatool</a>.<p>
+
+</section><!-- end of section summary.index6750208 -->
+
+<section id="summary.index6815744"><!-- start of section summary.index6815744 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->E<div class="labellink"><a href="#summary.index6815744">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.16389"></a><a href="#glo:eglssetwidest"><code class="csfmt">\eglssetwidest</code></a><code class="code">[<span class="meta">〈<em class="metainner">level</em>〉</span>]{<span class="meta">〈<em class="metainner">name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16390"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16391"></a><a href="#glo:glssetwidest"><code class="csfmt">\glssetwidest</code></a> but expands <span class="meta">〈<em class="metainner">text</em>〉</span>. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11008">434</a><p>
+<div class="defnbox"><a id="wrglossary.16392"></a><a href="#glo:eglsupdatewidest"><code class="csfmt">\eglsupdatewidest</code></a><code class="code">[<span class="meta">〈<em class="metainner">level</em>〉</span>]{<span class="meta">〈<em class="metainner">name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16393"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.23+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16394"></a><a href="#glo:glsupdatewidest"><code class="csfmt">\glsupdatewidest</code></a> but expands <span class="meta">〈<em class="metainner">name</em>〉</span>. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11014">434</a><p>
+<div class="defnbox"><a id="wrglossary.16395"></a><a href="#glo:eGlsXtrSetField"><code class="csfmt">\eGlsXtrSetField</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16396"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16397"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a> but expands the value. <a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1205">40</a><p>
+<div class="defnbox"><a id="wrglossary.16398"></a><dfn id="glo:entryname"><code class="csfmt">\entryname</code></dfn><span class="floatrightbox"><span class="summarytag">initial: </span>Notation; <a id="wrglossary.16399"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(language-sensitive)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Expands to the title of the name column for headed <a id="wrglossary.16400"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>-like styles.<p>
+<div class="defnbox"><a id="wrglossary.16401"></a><a href="#glo:Epsilon"><code class="csfmt">\Epsilon</code></a><span class="floatrightbox"><a id="wrglossary.16402"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.16403"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a>, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{E}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13973">573</a><p>
+<div class="defnbox"><a id="wrglossary.16404"></a><a href="#glo:Eta"><code class="csfmt">\Eta</code></a><span class="floatrightbox"><a id="wrglossary.16405"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.16406"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a>, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{H}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13975">573</a><p>
+<div class="defnbox"><a id="wrglossary.16407"></a><a href="#glo:ExtraCustomAbbreviationFields"><code class="csfmt">\ExtraCustomAbbreviationFields</code></a><span class="floatrightbox"><a id="wrglossary.16408"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to additional fields that need to be set with <a id="wrglossary.16409"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>. <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4089">164</a><p>
+
+</section><!-- end of section summary.index6815744 -->
+
+<section id="summary.index6881280"><!-- start of section summary.index6881280 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->F<div class="labellink"><a href="#summary.index6881280">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.16410"></a><dfn id="glo:firstacronymfont"><code class="csfmt">\firstacronymfont</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16411"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v1.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to encapsulate the acronym short form on <a id="wrglossary.16412"></a><a href="#glo:dual.firstuse">first use</a> by the base <a id="wrglossary.16413"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. This is redefined by <a id="wrglossary.16414"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> to use <a id="wrglossary.16415"></a><a href="#glo:glsfirstabbrvfont"><code class="csfmt">\glsfirstabbrvfont</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.16416"></a><a href="#glo:forallabbreviationlists"><code class="csfmt">\forallabbreviationlists</code></a><code class="code">{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">body</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16417"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Iterates overall all lists of abbreviations, defines the command <span class="meta">〈<em class="metainner">cs</em>〉</span> to the current label and does <span class="meta">〈<em class="metainner">body</em>〉</span>. <a href="#sec:glossaries">§8</a>; <a href="#wrglossary.9483">376</a><p>
+<div class="defnbox"><a id="wrglossary.16418"></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><dfn id="glo:forallacronyms"><code class="csfmt">\forallacronyms</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">body</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16419"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Iterates overall all <a id="wrglossary.16420"></a><a href="#glo:dual.glossary">glossaries</a> that have been declared lists of acronyms, defines the command <span class="meta">〈<em class="metainner">cs</em>〉</span> to the current label and does <span class="meta">〈<em class="metainner">body</em>〉</span>. Use <a id="wrglossary.16421"></a><a href="#glo:forallabbreviationlists"><code class="csfmt">\forallabbreviationlists</code></a> with <a id="wrglossary.16422"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.<p>
+<div class="defnbox"><a id="wrglossary.16423"></a><dfn id="glo:forallglossaries"><code class="csfmt">\forallglossaries</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">types</em>〉</span>]{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">body</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16424"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Iterates overall all the <a id="wrglossary.16425"></a><a href="#glo:dual.glossary">glossary</a> labels given in the <span class="meta">〈<em class="metainner">types</em>〉</span> argument, defines the command <span class="meta">〈<em class="metainner">cs</em>〉</span> to the current label and does <span class="meta">〈<em class="metainner">body</em>〉</span>. If the optional argument is omitted, the list of all non-<a id="wrglossary.16426"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a> is assumed.<p>
+<div class="defnbox"><a id="wrglossary.16427"></a><dfn id="glo:forallglsentries"><code class="csfmt">\forallglsentries</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">types</em>〉</span>]{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">body</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16428"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <a id="wrglossary.16429"></a><a href="#glo:forglsentries"><code class="csfmt">\forglsentries</code></a> for each <a id="wrglossary.16430"></a><a href="#glo:dual.glossary">glossary</a>. The optional argument <span class="meta">〈<em class="metainner">types</em>〉</span> is a comma-separated list of <a id="wrglossary.16431"></a><a href="#glo:dual.glossary">glossary</a> labels. If omitted, all non-<a id="wrglossary.16432"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a> is assumed.<p>
+<div class="defnbox"><a id="wrglossary.16433"></a><dfn id="glo:forglsentries"><code class="csfmt">\forglsentries</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">type</em>〉</span>]{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">body</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16434"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Iterates over all entries in the given <a id="wrglossary.16435"></a><a href="#glo:dual.glossary">glossary</a> and, at each iteration, defines the command <span class="meta">〈<em class="metainner">cs</em>〉</span> to the current entry label and does <span class="meta">〈<em class="metainner">body</em>〉</span>. The optional argument <span class="meta">〈<em class="metainner">type</em>〉</span> is the <a id="wrglossary.16436"></a><a href="#glo:dual.glossary">glossary</a> label and defaults to <a id="wrglossary.16437"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a> if omitted. This command can’t be used with <a id="wrglossary.16438"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> since there are no defined entries until <a id="wrglossary.16439"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> has selected them and added them to the <a id="wrglossary.16440"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file.<p>
+
+</section><!-- end of section summary.index6881280 -->
+
+<section id="summary.index6946816"><!-- start of section summary.index6946816 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->G<div class="labellink"><a href="#summary.index6946816">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.16441"></a><a href="#glo:gglssetwidest"><code class="csfmt">\gglssetwidest</code></a><code class="code">[<span class="meta">〈<em class="metainner">level</em>〉</span>]{<span class="meta">〈<em class="metainner">name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16442"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16443"></a><a href="#glo:glssetwidest"><code class="csfmt">\glssetwidest</code></a> but global. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11006">434</a><p>
+<div class="defnbox"><a id="wrglossary.16444"></a><a href="#glo:gglsupdatewidest"><code class="csfmt">\gglsupdatewidest</code></a><code class="code">[<span class="meta">〈<em class="metainner">level</em>〉</span>]{<span class="meta">〈<em class="metainner">name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16445"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.23+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16446"></a><a href="#glo:glsupdatewidest"><code class="csfmt">\glsupdatewidest</code></a> but global. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11013">434</a><p>
+<div class="defnbox"><a id="wrglossary.16447"></a><a href="#glo:gGlsXtrSetField"><code class="csfmt">\gGlsXtrSetField</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16448"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16449"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a> but globally assigns the value. <a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1203">40</a><p>
+
+</section><!-- end of section summary.index6946816 -->
+
+<section id="summary.index7012352"><!-- start of section summary.index7012352 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->Glo<div class="labellink"><a href="#summary.index7012352">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.16450"></a><dfn id="glo:glolinkprefix"><code class="csfmt">\glolinkprefix</code></dfn><span class="floatrightbox"><span class="summarytag">initial: </span>glo:; <a id="wrglossary.16451"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the default prefix for the entry’s hypertarget anchor in the glossary.<p>
+<div class="defnbox"><a id="wrglossary.16452"></a><dfn id="glo:GlossariesAbbrStyleTooComplexWarning"><code class="csfmt">\GlossariesAbbrStyleTooComplexWarning</code></dfn><span class="floatrightbox"><a id="wrglossary.16453"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Issues a warning with <a id="wrglossary.16454"></a><a href="#glo:GlossariesExtraWarning"><code class="csfmt">\GlossariesExtraWarning</code></a> when a command is used that isn’t supported by a complex abbreviation style.<p>
+<div class="defnbox"><a id="wrglossary.16455"></a><a href="#glo:glossariesextrasetup"><code class="csfmt">\glossariesextrasetup</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Change allowed options that are defined or modified by the <a id="wrglossary.16456"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package. Note that some options can only be passed as package options. <a href="#sec:pkgopts">§2</a>; <a href="#wrglossary.154">8</a><p>
+<div class="defnbox"><a id="wrglossary.16457"></a><dfn id="glo:GlossariesExtraWarning"><code class="csfmt">\GlossariesExtraWarning</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">message</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Writes a warning in the transcript with the current line number. The <a id="wrglossary.16458"></a><a href="#glo:opt.nowarn"><span class="styoptfmt">nowarn</span></a> option redefines this command to do nothing.<p>
+<div class="defnbox"><a id="wrglossary.16459"></a><dfn id="glo:GlossariesExtraWarningNoLine"><code class="csfmt">\GlossariesExtraWarningNoLine</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">message</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16460"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Writes a warning in the transcript without a corresponding line number. The <a id="wrglossary.16461"></a><a href="#glo:opt.nowarn"><span class="styoptfmt">nowarn</span></a> option redefines this command to do nothing.<p>
+<div class="defnbox"><a id="wrglossary.16462"></a><dfn id="glo:glossaryentrynumbers"><code class="csfmt">\glossaryentrynumbers</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16463"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used within the <a id="wrglossary.16464"></a><a href="#glo:dual.glossary">glossary</a> to encapsulate the <a id="wrglossary.16465"></a><a href="#glo:dual.locationlist">location list</a> (redefined by the <a id="wrglossary.16466"></a><a href="#glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></a> option).<p>
+<div class="defnbox"><a id="wrglossary.16467"></a><dfn id="glo:glossaryheader"><code class="csfmt">\glossaryheader</code></dfn><span class="floatrightbox"><a id="wrglossary.16468"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Inserted after <code class="code"><code class="cbeg">\begin{<a id="wrglossary.16469"></a><a href="#glo:env.theglossary"><span class="envfmt">theglossary</span></a>}</code></code>. This command should be redefined by the <a id="wrglossary.16470"></a><a href="#glo:idx.glossarystyle">glossary style</a>.<p>
+<div class="defnbox"><a id="wrglossary.16471"></a><dfn id="glo:glossaryname"><code class="csfmt">\glossaryname</code></dfn><span class="floatrightbox"><span class="summarytag">initial: </span>Glossary</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(language-sensitive)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Expands to the default <a id="wrglossary.16472"></a><a href="#glo:dual.glossary">glossary</a> title (provided by <a id="wrglossary.16473"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> if not already defined).<p>
+<div class="defnbox"><a id="wrglossary.16474"></a><dfn id="glo:glossarypostamble"><code class="csfmt">\glossarypostamble</code></dfn><span class="floatrightbox"><a id="wrglossary.16475"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used at the end of the <a id="wrglossary.16476"></a><a href="#glo:dual.glossary">glossary</a>.<p>
+<div class="defnbox"><a id="wrglossary.16477"></a><dfn id="glo:glossarypreamble"><code class="csfmt">\glossarypreamble</code></dfn><span class="floatrightbox"><a id="wrglossary.16478"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used at the start of the <a id="wrglossary.16479"></a><a href="#glo:dual.glossary">glossary</a>. This will be locally redefined to the preamble associated with the current glossary, if one has been set.<p>
+<div class="defnbox"><a id="wrglossary.16480"></a><dfn id="glo:glossarysection"><code class="csfmt">\glossarysection</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">toc-title</em>〉</span>]{<span class="meta">〈<em class="metainner">title</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16481"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Occurs at the start of a <a id="wrglossary.16482"></a><a href="#glo:dual.glossary">glossary</a> (except with <a id="wrglossary.16483"></a><a href="#glo:printunsrtinnerglossary"><code class="csfmt">\printunsrtinnerglossary</code></a>). This will typically be defined to use a sectioning command, such as <a id="wrglossary.16484"></a><a href="#glo:section"><code class="csfmt">\section</code></a> or <a id="wrglossary.16485"></a><a href="#glo:chapter"><code class="csfmt">\chapter</code></a>. The default definition follows the <a id="wrglossary.16486"></a><a href="#glo:opt.section"><span class="styoptfmt">section</span></a> and <a id="wrglossary.16487"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a> options.<p>
+<div class="defnbox"><a id="wrglossary.16488"></a><dfn id="glo:glossarytitle"><code class="csfmt">\glossarytitle</code></dfn><span class="floatrightbox"><a id="wrglossary.16489"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Initialised by the <code class="csfmt">\print…glossary</code> set of commands (such as <a id="wrglossary.16490"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>) to the current <a id="wrglossary.16491"></a><a href="#glo:dual.glossary">glossary’s</a> title.<p>
+<div class="defnbox"><a id="wrglossary.16492"></a><dfn id="glo:glossarytoctitle"><code class="csfmt">\glossarytoctitle</code></dfn><span class="floatrightbox"><a id="wrglossary.16493"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Initialised by the <code class="csfmt">\print…glossary</code> set of commands (such as <a id="wrglossary.16494"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>) to the current <a id="wrglossary.16495"></a><a href="#glo:dual.glossary">glossary’s</a> table of contents title.<p>
+<div class="defnbox"><a id="wrglossary.16496"></a><dfn id="glo:glossentry"><code class="csfmt">\glossentry</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16497"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to format a top-level entry. This command should be redefined by the <a id="wrglossary.16498"></a><a href="#glo:idx.glossarystyle">glossary style</a>.<p>
+<div class="defnbox"><a id="wrglossary.16499"></a><dfn id="glo:Glossentrydesc"><code class="csfmt">\Glossentrydesc</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16500"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.08a+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16501"></a><a href="#glo:glossentrydesc"><code class="csfmt">\glossentrydesc</code></a> but <a id="wrglossary.16502"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="defnbox"><a id="wrglossary.16503"></a><dfn id="glo:glossentrydesc"><code class="csfmt">\glossentrydesc</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16504"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.08a+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.16505"></a><a href="#glo:dual.glossary">glossary</a> styles to display the entry’s description.<p>
+<div class="defnbox"><a id="wrglossary.16506"></a><dfn id="glo:Glossentryname"><code class="csfmt">\Glossentryname</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16507"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.08a+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16508"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a> but <a id="wrglossary.16509"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="defnbox"><a id="wrglossary.16510"></a><dfn id="glo:glossentryname"><code class="csfmt">\glossentryname</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16511"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.08a+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.16512"></a><a href="#glo:dual.glossary">glossary</a> styles to display the entry’s name.<p>
+<div class="defnbox"><a id="wrglossary.16513"></a><a href="#glo:glossentrynameother"><code class="csfmt">\glossentrynameother</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16514"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.22+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Behaves like <a id="wrglossary.16515"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a> but uses the given field (identified by its <a id="wrglossary.16516"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a>) instead of <a id="wrglossary.16517"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>. <a href="#sec:glosstylemods">§8.6</a>; <a href="#wrglossary.10683">419</a><p>
+<div class="defnbox"><a id="wrglossary.16518"></a><dfn id="glo:Glossentrysymbol"><code class="csfmt">\Glossentrysymbol</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16519"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.08a+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16520"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a> but <a id="wrglossary.16521"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="defnbox"><a id="wrglossary.16522"></a><dfn id="glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16523"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.08a+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.16524"></a><a href="#glo:dual.glossary">glossary</a> styles to display the entry’s symbol.<p>
+<div class="defnbox"><a id="wrglossary.16525"></a><a href="#glo:glossxtrsetpopts"><code class="csfmt">\glossxtrsetpopts</code></a><span class="floatrightbox"><a id="wrglossary.16526"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.07+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used at the start of each glossary to set the current options for the <a id="wrglossary.16527"></a><a href="#glo:glsxtrp"><code class="csfmt">\glsxtrp</code></a> set of commands (with <a id="wrglossary.16528"></a><a href="#glo:glsxtrsetpopts"><code class="csfmt">\glsxtrsetpopts</code></a>). <a href="#sec:nested">§5.4</a>; <a href="#wrglossary.5932">231</a><p>
+
+</section><!-- end of section summary.index7012352 -->
+
+<section id="summary.index7077888"><!-- start of section summary.index7077888 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->Gls<div class="labellink"><a href="#summary.index7077888">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.16529"></a><dfn id="glo:GLS"><code class="csfmt">\GLS</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16530"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16531"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16532"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.16533"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16534"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> but converts the <a id="wrglossary.16535"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.16536"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="defnbox"><a id="wrglossary.16537"></a><dfn id="glo:Gls"><code class="csfmt">\Gls</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16538"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16539"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16540"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.16541"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16542"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> but converts the first character of the <a id="wrglossary.16543"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.16544"></a><a href="#glo:idx.uppercase">uppercase</a><a id="wrglossary.16545"></a> (for the start of a sentence) using <a id="wrglossary.16546"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.16547"></a><dfn id="glo:gls"><code class="csfmt">\gls</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.16548"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.16549"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.16550"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.16551"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The text produced depends on whether or not this is the <a id="wrglossary.16552"></a><a href="#glo:dual.firstuse">first use</a> and whether or not the <a id="wrglossary.16553"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute has been set. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument may be inserted at the end of the <a id="wrglossary.16554"></a><a href="#glo:dual.linktext">link text</a> or may be inserted at a different point (for example, after the long form on <a id="wrglossary.16555"></a><a href="#glo:dual.firstuse">first use</a> for some abbreviation styles. For the first optional argument, see <a id="wrglossary.16556"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>.<p>
+<div class="defnbox"><a id="wrglossary.16557"></a><a href="#glo:glsabbrvdefaultfont"><code class="csfmt">\glsabbrvdefaultfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Formatting command for the short form used by the abbreviation styles that don’t apply a font change by default. <a href="#wrglossary.3274">132</a><p>
+<div class="defnbox"><a id="wrglossary.16558"></a><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16559"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Short form font used by the <span class="qt">“em”</span> abbreviation styles. <a href="#wrglossary.3931">158</a><p>
+<div class="defnbox"><a id="wrglossary.16560"></a><a href="#glo:glsabbrvfont"><code class="csfmt">\glsabbrvfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Font formatting command for the short form, initialised by the abbreviation style. <a href="#wrglossary.4322">171</a><p>
+<div class="defnbox"><a id="wrglossary.16561"></a><a href="#glo:glsabbrvhyphenfont"><code class="csfmt">\glsabbrvhyphenfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16562"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Short form font used by the <span class="qt">“hyphen”</span> abbreviation styles. <a href="#wrglossary.3658">148</a><p>
+<div class="defnbox"><a id="wrglossary.16563"></a><a href="#glo:glsabbrvonlyfont"><code class="csfmt">\glsabbrvonlyfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16564"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Short form font used by the <span class="qt">“only”</span> abbreviation styles. <a href="#wrglossary.3844">154</a><p>
+<div class="defnbox"><a id="wrglossary.16565"></a><a href="#glo:glsabbrvscfont"><code class="csfmt">\glsabbrvscfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16566"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Short form font used by the <a id="wrglossary.16567"></a><a href="#glo:idx.smallcaps">small caps</a> <span class="qt">“sc”</span> abbreviation styles. <a href="#wrglossary.3897">156</a><p>
+<div class="defnbox"><a id="wrglossary.16568"></a><a href="#glo:glsabbrvsconlyfont"><code class="csfmt">\glsabbrvsconlyfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16569"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Short form font used by the <span class="qt">“sc-only”</span> styles, such as <a id="wrglossary.16570"></a><a href="#glo:opt.abbrstyle.long-only-short-sc-only"><span class="abbrstylefmt">long-only-short-sc-only</span></a>. <a href="#wrglossary.3856">154</a><p>
+<div class="defnbox"><a id="wrglossary.16571"></a><a href="#glo:glsabbrvscuserfont"><code class="csfmt">\glsabbrvscuserfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16572"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Short form font used by the <a id="wrglossary.16573"></a><a href="#glo:idx.smallcaps">small caps</a> <span class="qt">“sc-user”</span> abbreviation styles. <a href="#wrglossary.3366">136</a><p>
+<div class="defnbox"><a id="wrglossary.16574"></a><a href="#glo:glsabbrvsmfont"><code class="csfmt">\glsabbrvsmfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16575"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Short form font used by the <span class="qt">“sm”</span> abbreviation styles. <a href="#wrglossary.3915">157</a><p>
+<div class="defnbox"><a id="wrglossary.16576"></a><a href="#glo:glsabbrvuserfont"><code class="csfmt">\glsabbrvuserfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16577"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Short form font used by the <span class="qt">“user”</span> abbreviation styles. <a href="#wrglossary.3354">135</a><p>
+<div class="defnbox"><a id="wrglossary.16578"></a><dfn id="glo:glsabspace"><code class="csfmt">\glsabspace</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16579"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.16580"></a><a href="#glo:glsacspace"><code class="csfmt">\glsacspace</code></a> but includes <a id="wrglossary.16581"></a><a href="#glo:dual.innerformatting">inner formatting</a>. Unlike <a id="wrglossary.16582"></a><a href="#glo:glsacspace"><code class="csfmt">\glsacspace</code></a>, this command is robust.<p>
+<div class="defnbox"><a id="wrglossary.16583"></a><a href="#glo:GLSaccessdesc"><code class="csfmt">\GLSaccessdesc</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16584"></a><a href="#glo:idx.allcaps">all caps</a> version of <a id="wrglossary.16585"></a><a href="#glo:glsaccessdesc"><code class="csfmt">\glsaccessdesc</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11810">480</a><p>
+<div class="defnbox"><a id="wrglossary.16586"></a><a href="#glo:Glsaccessdesc"><code class="csfmt">\Glsaccessdesc</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16587"></a><a href="#glo:idx.sentencecase">sentence case</a> version of <a id="wrglossary.16588"></a><a href="#glo:glsaccessdesc"><code class="csfmt">\glsaccessdesc</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11808">480</a><p>
+<div class="defnbox"><a id="wrglossary.16589"></a><a href="#glo:glsaccessdesc"><code class="csfmt">\glsaccessdesc</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+If accessibility support was enabled when <a id="wrglossary.16590"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> was loaded (<a id="wrglossary.16591"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>) this will display the value of the <a id="wrglossary.16592"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> key with the accessibility support enabled for that key (<a id="wrglossary.16593"></a><a href="#glo:opt.gloskey.descriptionaccess"><span class="csoptfmt">descriptionaccess</span></a>). If there is no accessibility support, this just uses <a id="wrglossary.16594"></a><a href="#glo:glsentrydesc"><code class="csfmt">\glsentrydesc</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11804">480</a><p>
+<div class="defnbox"><a id="wrglossary.16595"></a><a href="#glo:GLSaccessdescplural"><code class="csfmt">\GLSaccessdescplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16596"></a><a href="#glo:idx.allcaps">all caps</a> version of <a id="wrglossary.16597"></a><a href="#glo:glsaccessdescplural"><code class="csfmt">\glsaccessdescplural</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11818">480</a><p>
+<div class="defnbox"><a id="wrglossary.16598"></a><a href="#glo:Glsaccessdescplural"><code class="csfmt">\Glsaccessdescplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16599"></a><a href="#glo:idx.sentencecase">sentence case</a> version of <a id="wrglossary.16600"></a><a href="#glo:glsaccessdescplural"><code class="csfmt">\glsaccessdescplural</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11816">480</a><p>
+<div class="defnbox"><a id="wrglossary.16601"></a><a href="#glo:glsaccessdescplural"><code class="csfmt">\glsaccessdescplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+If accessibility support was enabled when <a id="wrglossary.16602"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> was loaded (<a id="wrglossary.16603"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>) this will display the value of the <a id="wrglossary.16604"></a><a href="#glo:opt.gloskey.descriptionplural"><span class="csoptfmt">descriptionplural</span></a> key with the accessibility support enabled for that key (<a id="wrglossary.16605"></a><a href="#glo:opt.gloskey.descriptionpluralaccess"><span class="csoptfmt">descriptionpluralaccess</span></a>). If there is no accessibility support, this just uses <a id="wrglossary.16606"></a><a href="#glo:glsentrydescplural"><code class="csfmt">\glsentrydescplural</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11812">480</a><p>
+<div class="defnbox"><a id="wrglossary.16607"></a><a href="#glo:GLSaccessfirst"><code class="csfmt">\GLSaccessfirst</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16608"></a><a href="#glo:idx.allcaps">all caps</a> version of <a id="wrglossary.16609"></a><a href="#glo:glsaccessfirst"><code class="csfmt">\glsaccessfirst</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11778">478</a><p>
+<div class="defnbox"><a id="wrglossary.16610"></a><a href="#glo:Glsaccessfirst"><code class="csfmt">\Glsaccessfirst</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16611"></a><a href="#glo:idx.sentencecase">sentence case</a> version of <a id="wrglossary.16612"></a><a href="#glo:glsaccessfirst"><code class="csfmt">\glsaccessfirst</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11776">478</a><p>
+<div class="defnbox"><a id="wrglossary.16613"></a><a href="#glo:glsaccessfirst"><code class="csfmt">\glsaccessfirst</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+If accessibility support was enabled when <a id="wrglossary.16614"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> was loaded (<a id="wrglossary.16615"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>) this will display the value of the <a id="wrglossary.16616"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> key with the accessibility support enabled for that key (<a id="wrglossary.16617"></a><a href="#glo:opt.gloskey.firstaccess"><span class="csoptfmt">firstaccess</span></a>). If there is no accessibility support, this just uses <a id="wrglossary.16618"></a><a href="#glo:glsentryfirst"><code class="csfmt">\glsentryfirst</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11772">478</a><p>
+<div class="defnbox"><a id="wrglossary.16619"></a><a href="#glo:GLSaccessfirstplural"><code class="csfmt">\GLSaccessfirstplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16620"></a><a href="#glo:idx.allcaps">all caps</a> version of <a id="wrglossary.16621"></a><a href="#glo:glsaccessfirstplural"><code class="csfmt">\glsaccessfirstplural</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11786">479</a><p>
+<div class="defnbox"><a id="wrglossary.16622"></a><a href="#glo:Glsaccessfirstplural"><code class="csfmt">\Glsaccessfirstplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16623"></a><a href="#glo:idx.sentencecase">sentence case</a> version of <a id="wrglossary.16624"></a><a href="#glo:glsaccessfirstplural"><code class="csfmt">\glsaccessfirstplural</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11784">479</a><p>
+<div class="defnbox"><a id="wrglossary.16625"></a><a href="#glo:glsaccessfirstplural"><code class="csfmt">\glsaccessfirstplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+If accessibility support was enabled when <a id="wrglossary.16626"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> was loaded (<a id="wrglossary.16627"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>) this will display the value of the <a id="wrglossary.16628"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> key with the accessibility support enabled for that key (<a id="wrglossary.16629"></a><a href="#glo:opt.gloskey.firstpluralaccess"><span class="csoptfmt">firstpluralaccess</span></a>). If there is no accessibility support, this just uses <a id="wrglossary.16630"></a><a href="#glo:glsentryfirstplural"><code class="csfmt">\glsentryfirstplural</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11780">479</a><p>
+<div class="defnbox"><a id="wrglossary.16631"></a><a href="#glo:GLSaccessfmtdesc"><code class="csfmt">\GLSaccessfmtdesc</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16632"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16633"></a><a href="#glo:GLSaccessdesc"><code class="csfmt">\GLSaccessdesc</code></a> but formats the displayed text with <a id="wrglossary.16634"></a><a href="#glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11959">487</a><p>
+<div class="defnbox"><a id="wrglossary.16635"></a><a href="#glo:Glsaccessfmtdesc"><code class="csfmt">\Glsaccessfmtdesc</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16636"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16637"></a><a href="#glo:Glsaccessdesc"><code class="csfmt">\Glsaccessdesc</code></a> but formats the displayed text with <a id="wrglossary.16638"></a><a href="#glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11957">487</a><p>
+<div class="defnbox"><a id="wrglossary.16639"></a><a href="#glo:glsaccessfmtdesc"><code class="csfmt">\glsaccessfmtdesc</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16640"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16641"></a><a href="#glo:glsaccessdesc"><code class="csfmt">\glsaccessdesc</code></a> but formats the displayed text with <a id="wrglossary.16642"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11954">487</a><p>
+<div class="defnbox"><a id="wrglossary.16643"></a><a href="#glo:GLSaccessfmtdescplural"><code class="csfmt">\GLSaccessfmtdescplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16644"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16645"></a><a href="#glo:GLSaccessdescplural"><code class="csfmt">\GLSaccessdescplural</code></a> but formats the displayed text with <a id="wrglossary.16646"></a><a href="#glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11966">488</a><p>
+<div class="defnbox"><a id="wrglossary.16647"></a><a href="#glo:Glsaccessfmtdescplural"><code class="csfmt">\Glsaccessfmtdescplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16648"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16649"></a><a href="#glo:Glsaccessdescplural"><code class="csfmt">\Glsaccessdescplural</code></a> but formats the displayed text with <a id="wrglossary.16650"></a><a href="#glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11964">488</a><p>
+<div class="defnbox"><a id="wrglossary.16651"></a><a href="#glo:glsaccessfmtdescplural"><code class="csfmt">\glsaccessfmtdescplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16652"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16653"></a><a href="#glo:glsaccessdescplural"><code class="csfmt">\glsaccessdescplural</code></a> but formats the displayed text with <a id="wrglossary.16654"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11961">487</a><p>
+<div class="defnbox"><a id="wrglossary.16655"></a><a href="#glo:GLSaccessfmtfirst"><code class="csfmt">\GLSaccessfmtfirst</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16656"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16657"></a><a href="#glo:GLSaccessfirst"><code class="csfmt">\GLSaccessfirst</code></a> but formats the displayed text with <a id="wrglossary.16658"></a><a href="#glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11931">486</a><p>
+<div class="defnbox"><a id="wrglossary.16659"></a><a href="#glo:Glsaccessfmtfirst"><code class="csfmt">\Glsaccessfmtfirst</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16660"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16661"></a><a href="#glo:Glsaccessfirst"><code class="csfmt">\Glsaccessfirst</code></a> but formats the displayed text with <a id="wrglossary.16662"></a><a href="#glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11929">486</a><p>
+<div class="defnbox"><a id="wrglossary.16663"></a><a href="#glo:glsaccessfmtfirst"><code class="csfmt">\glsaccessfmtfirst</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16664"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16665"></a><a href="#glo:glsaccessfirst"><code class="csfmt">\glsaccessfirst</code></a> but formats the displayed text with <a id="wrglossary.16666"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11926">486</a><p>
+<div class="defnbox"><a id="wrglossary.16667"></a><a href="#glo:GLSaccessfmtfirstplural"><code class="csfmt">\GLSaccessfmtfirstplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16668"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16669"></a><a href="#glo:GLSaccessfirstplural"><code class="csfmt">\GLSaccessfirstplural</code></a> but formats the displayed text with <a id="wrglossary.16670"></a><a href="#glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11938">486</a><p>
+<div class="defnbox"><a id="wrglossary.16671"></a><a href="#glo:Glsaccessfmtfirstplural"><code class="csfmt">\Glsaccessfmtfirstplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16672"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16673"></a><a href="#glo:Glsaccessfirstplural"><code class="csfmt">\Glsaccessfirstplural</code></a> but formats the displayed text with <a id="wrglossary.16674"></a><a href="#glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11936">486</a><p>
+<div class="defnbox"><a id="wrglossary.16675"></a><a href="#glo:glsaccessfmtfirstplural"><code class="csfmt">\glsaccessfmtfirstplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16676"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16677"></a><a href="#glo:glsaccessfirstplural"><code class="csfmt">\glsaccessfirstplural</code></a> but formats the displayed text with <a id="wrglossary.16678"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11933">486</a><p>
+<div class="defnbox"><a id="wrglossary.16679"></a><a href="#glo:GLSaccessfmtlong"><code class="csfmt">\GLSaccessfmtlong</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16680"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16681"></a><a href="#glo:GLSaccesslong"><code class="csfmt">\GLSaccesslong</code></a> but formats the displayed text with <a id="wrglossary.16682"></a><a href="#glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11987">489</a><p>
+<div class="defnbox"><a id="wrglossary.16683"></a><a href="#glo:Glsaccessfmtlong"><code class="csfmt">\Glsaccessfmtlong</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16684"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16685"></a><a href="#glo:Glsaccesslong"><code class="csfmt">\Glsaccesslong</code></a> but formats the displayed text with <a id="wrglossary.16686"></a><a href="#glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11985">489</a><p>
+<div class="defnbox"><a id="wrglossary.16687"></a><a href="#glo:glsaccessfmtlong"><code class="csfmt">\glsaccessfmtlong</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16688"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16689"></a><a href="#glo:glsaccesslong"><code class="csfmt">\glsaccesslong</code></a> but formats the displayed text with <a id="wrglossary.16690"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11982">489</a><p>
+<div class="defnbox"><a id="wrglossary.16691"></a><a href="#glo:GLSaccessfmtlongpl"><code class="csfmt">\GLSaccessfmtlongpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16692"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16693"></a><a href="#glo:GLSaccesslongpl"><code class="csfmt">\GLSaccesslongpl</code></a> but formats the displayed text with <a id="wrglossary.16694"></a><a href="#glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11994">489</a><p>
+<div class="defnbox"><a id="wrglossary.16695"></a><a href="#glo:Glsaccessfmtlongpl"><code class="csfmt">\Glsaccessfmtlongpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16696"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16697"></a><a href="#glo:Glsaccesslongpl"><code class="csfmt">\Glsaccesslongpl</code></a> but formats the displayed text with <a id="wrglossary.16698"></a><a href="#glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11992">489</a><p>
+<div class="defnbox"><a id="wrglossary.16699"></a><a href="#glo:glsaccessfmtlongpl"><code class="csfmt">\glsaccessfmtlongpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16700"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16701"></a><a href="#glo:glsaccesslongpl"><code class="csfmt">\glsaccesslongpl</code></a> but formats the displayed text with <a id="wrglossary.16702"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11989">489</a><p>
+<div class="defnbox"><a id="wrglossary.16703"></a><a href="#glo:GLSaccessfmtname"><code class="csfmt">\GLSaccessfmtname</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16704"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16705"></a><a href="#glo:GLSaccessname"><code class="csfmt">\GLSaccessname</code></a> but formats the displayed text with <a id="wrglossary.16706"></a><a href="#glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11910">485</a><p>
+<div class="defnbox"><a id="wrglossary.16707"></a><a href="#glo:Glsaccessfmtname"><code class="csfmt">\Glsaccessfmtname</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16708"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16709"></a><a href="#glo:Glsaccessname"><code class="csfmt">\Glsaccessname</code></a> but formats the displayed text with <a id="wrglossary.16710"></a><a href="#glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11908">485</a><p>
+<div class="defnbox"><a id="wrglossary.16711"></a><a href="#glo:glsaccessfmtname"><code class="csfmt">\glsaccessfmtname</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16712"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16713"></a><a href="#glo:glsaccessname"><code class="csfmt">\glsaccessname</code></a> but formats the displayed text with <a id="wrglossary.16714"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11905">484</a><p>
+<div class="defnbox"><a id="wrglossary.16715"></a><a href="#glo:GLSaccessfmtplural"><code class="csfmt">\GLSaccessfmtplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16716"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16717"></a><a href="#glo:GLSaccessplural"><code class="csfmt">\GLSaccessplural</code></a> but formats the displayed text with <a id="wrglossary.16718"></a><a href="#glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11924">485</a><p>
+<div class="defnbox"><a id="wrglossary.16719"></a><a href="#glo:Glsaccessfmtplural"><code class="csfmt">\Glsaccessfmtplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16720"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16721"></a><a href="#glo:Glsaccessplural"><code class="csfmt">\Glsaccessplural</code></a> but formats the displayed text with <a id="wrglossary.16722"></a><a href="#glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11922">485</a><p>
+<div class="defnbox"><a id="wrglossary.16723"></a><a href="#glo:glsaccessfmtplural"><code class="csfmt">\glsaccessfmtplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16724"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16725"></a><a href="#glo:glsaccessplural"><code class="csfmt">\glsaccessplural</code></a> but formats the displayed text with <a id="wrglossary.16726"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11919">485</a><p>
+<div class="defnbox"><a id="wrglossary.16727"></a><a href="#glo:GLSaccessfmtshort"><code class="csfmt">\GLSaccessfmtshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16728"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16729"></a><a href="#glo:GLSaccessshort"><code class="csfmt">\GLSaccessshort</code></a> but formats the displayed text with <a id="wrglossary.16730"></a><a href="#glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11973">488</a><p>
+<div class="defnbox"><a id="wrglossary.16731"></a><a href="#glo:Glsaccessfmtshort"><code class="csfmt">\Glsaccessfmtshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16732"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16733"></a><a href="#glo:Glsaccessshort"><code class="csfmt">\Glsaccessshort</code></a> but formats the displayed text with <a id="wrglossary.16734"></a><a href="#glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11971">488</a><p>
+<div class="defnbox"><a id="wrglossary.16735"></a><a href="#glo:glsaccessfmtshort"><code class="csfmt">\glsaccessfmtshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16736"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16737"></a><a href="#glo:glsaccessshort"><code class="csfmt">\glsaccessshort</code></a> but formats the displayed text with <a id="wrglossary.16738"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11968">488</a><p>
+<div class="defnbox"><a id="wrglossary.16739"></a><a href="#glo:GLSaccessfmtshortpl"><code class="csfmt">\GLSaccessfmtshortpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16740"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16741"></a><a href="#glo:GLSaccessshortpl"><code class="csfmt">\GLSaccessshortpl</code></a> but formats the displayed text with <a id="wrglossary.16742"></a><a href="#glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11980">488</a><p>
+<div class="defnbox"><a id="wrglossary.16743"></a><a href="#glo:Glsaccessfmtshortpl"><code class="csfmt">\Glsaccessfmtshortpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16744"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16745"></a><a href="#glo:Glsaccessshortpl"><code class="csfmt">\Glsaccessshortpl</code></a> but formats the displayed text with <a id="wrglossary.16746"></a><a href="#glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11978">488</a><p>
+<div class="defnbox"><a id="wrglossary.16747"></a><a href="#glo:glsaccessfmtshortpl"><code class="csfmt">\glsaccessfmtshortpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16748"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16749"></a><a href="#glo:glsaccessshortpl"><code class="csfmt">\glsaccessshortpl</code></a> but formats the displayed text with <a id="wrglossary.16750"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11975">488</a><p>
+<div class="defnbox"><a id="wrglossary.16751"></a><a href="#glo:GLSaccessfmtsymbol"><code class="csfmt">\GLSaccessfmtsymbol</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16752"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16753"></a><a href="#glo:GLSaccesssymbol"><code class="csfmt">\GLSaccesssymbol</code></a> but formats the displayed text with <a id="wrglossary.16754"></a><a href="#glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11945">487</a><p>
+<div class="defnbox"><a id="wrglossary.16755"></a><a href="#glo:Glsaccessfmtsymbol"><code class="csfmt">\Glsaccessfmtsymbol</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16756"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16757"></a><a href="#glo:Glsaccesssymbol"><code class="csfmt">\Glsaccesssymbol</code></a> but formats the displayed text with <a id="wrglossary.16758"></a><a href="#glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11943">486</a><p>
+<div class="defnbox"><a id="wrglossary.16759"></a><a href="#glo:glsaccessfmtsymbol"><code class="csfmt">\glsaccessfmtsymbol</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16760"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16761"></a><a href="#glo:glsaccesssymbol"><code class="csfmt">\glsaccesssymbol</code></a> but formats the displayed text with <a id="wrglossary.16762"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11940">486</a><p>
+<div class="defnbox"><a id="wrglossary.16763"></a><a href="#glo:GLSaccessfmtsymbolplural"><code class="csfmt">\GLSaccessfmtsymbolplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16764"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16765"></a><a href="#glo:GLSaccesssymbolplural"><code class="csfmt">\GLSaccesssymbolplural</code></a> but formats the displayed text with <a id="wrglossary.16766"></a><a href="#glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11952">487</a><p>
+<div class="defnbox"><a id="wrglossary.16767"></a><a href="#glo:Glsaccessfmtsymbolplural"><code class="csfmt">\Glsaccessfmtsymbolplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16768"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16769"></a><a href="#glo:Glsaccesssymbolplural"><code class="csfmt">\Glsaccesssymbolplural</code></a> but formats the displayed text with <a id="wrglossary.16770"></a><a href="#glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11950">487</a><p>
+<div class="defnbox"><a id="wrglossary.16771"></a><a href="#glo:glsaccessfmtsymbolplural"><code class="csfmt">\glsaccessfmtsymbolplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16772"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16773"></a><a href="#glo:glsaccesssymbolplural"><code class="csfmt">\glsaccesssymbolplural</code></a> but formats the displayed text with <a id="wrglossary.16774"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11947">487</a><p>
+<div class="defnbox"><a id="wrglossary.16775"></a><a href="#glo:GLSaccessfmttext"><code class="csfmt">\GLSaccessfmttext</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16776"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16777"></a><a href="#glo:GLSaccesstext"><code class="csfmt">\GLSaccesstext</code></a> but formats the displayed text with <a id="wrglossary.16778"></a><a href="#glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11917">485</a><p>
+<div class="defnbox"><a id="wrglossary.16779"></a><a href="#glo:Glsaccessfmttext"><code class="csfmt">\Glsaccessfmttext</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16780"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16781"></a><a href="#glo:Glsaccesstext"><code class="csfmt">\Glsaccesstext</code></a> but formats the displayed text with <a id="wrglossary.16782"></a><a href="#glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11915">485</a><p>
+<div class="defnbox"><a id="wrglossary.16783"></a><a href="#glo:glsaccessfmttext"><code class="csfmt">\glsaccessfmttext</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16784"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16785"></a><a href="#glo:glsaccesstext"><code class="csfmt">\glsaccesstext</code></a> but formats the displayed text with <a id="wrglossary.16786"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11912">485</a><p>
+<div class="defnbox"><a id="wrglossary.16787"></a><a href="#glo:GLSaccessfmtuseri"><code class="csfmt">\GLSaccessfmtuseri</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16788"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16789"></a><a href="#glo:GLSaccessuseri"><code class="csfmt">\GLSaccessuseri</code></a> but formats the displayed text with <a id="wrglossary.16790"></a><a href="#glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12001">490</a><p>
+<div class="defnbox"><a id="wrglossary.16791"></a><a href="#glo:Glsaccessfmtuseri"><code class="csfmt">\Glsaccessfmtuseri</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16792"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16793"></a><a href="#glo:Glsaccessuseri"><code class="csfmt">\Glsaccessuseri</code></a> but formats the displayed text with <a id="wrglossary.16794"></a><a href="#glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11999">489</a><p>
+<div class="defnbox"><a id="wrglossary.16795"></a><a href="#glo:glsaccessfmtuseri"><code class="csfmt">\glsaccessfmtuseri</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16796"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16797"></a><a href="#glo:glsaccessuseri"><code class="csfmt">\glsaccessuseri</code></a> but formats the displayed text with <a id="wrglossary.16798"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11996">489</a><p>
+<div class="defnbox"><a id="wrglossary.16799"></a><a href="#glo:GLSaccessfmtuserii"><code class="csfmt">\GLSaccessfmtuserii</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16800"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16801"></a><a href="#glo:GLSaccessuserii"><code class="csfmt">\GLSaccessuserii</code></a> but formats the displayed text with <a id="wrglossary.16802"></a><a href="#glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12008">490</a><p>
+<div class="defnbox"><a id="wrglossary.16803"></a><a href="#glo:Glsaccessfmtuserii"><code class="csfmt">\Glsaccessfmtuserii</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16804"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16805"></a><a href="#glo:Glsaccessuserii"><code class="csfmt">\Glsaccessuserii</code></a> but formats the displayed text with <a id="wrglossary.16806"></a><a href="#glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12006">490</a><p>
+<div class="defnbox"><a id="wrglossary.16807"></a><a href="#glo:glsaccessfmtuserii"><code class="csfmt">\glsaccessfmtuserii</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16808"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16809"></a><a href="#glo:glsaccessuserii"><code class="csfmt">\glsaccessuserii</code></a> but formats the displayed text with <a id="wrglossary.16810"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12003">490</a><p>
+<div class="defnbox"><a id="wrglossary.16811"></a><a href="#glo:GLSaccessfmtuseriii"><code class="csfmt">\GLSaccessfmtuseriii</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16812"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16813"></a><a href="#glo:GLSaccessuseriii"><code class="csfmt">\GLSaccessuseriii</code></a> but formats the displayed text with <a id="wrglossary.16814"></a><a href="#glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12015">490</a><p>
+<div class="defnbox"><a id="wrglossary.16815"></a><a href="#glo:Glsaccessfmtuseriii"><code class="csfmt">\Glsaccessfmtuseriii</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16816"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16817"></a><a href="#glo:Glsaccessuseriii"><code class="csfmt">\Glsaccessuseriii</code></a> but formats the displayed text with <a id="wrglossary.16818"></a><a href="#glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12013">490</a><p>
+<div class="defnbox"><a id="wrglossary.16819"></a><a href="#glo:glsaccessfmtuseriii"><code class="csfmt">\glsaccessfmtuseriii</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16820"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16821"></a><a href="#glo:glsaccessuseriii"><code class="csfmt">\glsaccessuseriii</code></a> but formats the displayed text with <a id="wrglossary.16822"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12010">490</a><p>
+<div class="defnbox"><a id="wrglossary.16823"></a><a href="#glo:GLSaccessfmtuseriv"><code class="csfmt">\GLSaccessfmtuseriv</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16824"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16825"></a><a href="#glo:GLSaccessuseriv"><code class="csfmt">\GLSaccessuseriv</code></a> but formats the displayed text with <a id="wrglossary.16826"></a><a href="#glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12022">491</a><p>
+<div class="defnbox"><a id="wrglossary.16827"></a><a href="#glo:Glsaccessfmtuseriv"><code class="csfmt">\Glsaccessfmtuseriv</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16828"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16829"></a><a href="#glo:Glsaccessuseriv"><code class="csfmt">\Glsaccessuseriv</code></a> but formats the displayed text with <a id="wrglossary.16830"></a><a href="#glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12020">491</a><p>
+<div class="defnbox"><a id="wrglossary.16831"></a><a href="#glo:glsaccessfmtuseriv"><code class="csfmt">\glsaccessfmtuseriv</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16832"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16833"></a><a href="#glo:glsaccessuseriv"><code class="csfmt">\glsaccessuseriv</code></a> but formats the displayed text with <a id="wrglossary.16834"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12017">490</a><p>
+<div class="defnbox"><a id="wrglossary.16835"></a><a href="#glo:GLSaccessfmtuserv"><code class="csfmt">\GLSaccessfmtuserv</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16836"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16837"></a><a href="#glo:GLSaccessuserv"><code class="csfmt">\GLSaccessuserv</code></a> but formats the displayed text with <a id="wrglossary.16838"></a><a href="#glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12029">491</a><p>
+<div class="defnbox"><a id="wrglossary.16839"></a><a href="#glo:Glsaccessfmtuserv"><code class="csfmt">\Glsaccessfmtuserv</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16840"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16841"></a><a href="#glo:Glsaccessuserv"><code class="csfmt">\Glsaccessuserv</code></a> but formats the displayed text with <a id="wrglossary.16842"></a><a href="#glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12027">491</a><p>
+<div class="defnbox"><a id="wrglossary.16843"></a><a href="#glo:glsaccessfmtuserv"><code class="csfmt">\glsaccessfmtuserv</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16844"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16845"></a><a href="#glo:glsaccessuserv"><code class="csfmt">\glsaccessuserv</code></a> but formats the displayed text with <a id="wrglossary.16846"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12024">491</a><p>
+<div class="defnbox"><a id="wrglossary.16847"></a><a href="#glo:GLSaccessfmtuservi"><code class="csfmt">\GLSaccessfmtuservi</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16848"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16849"></a><a href="#glo:GLSaccessuservi"><code class="csfmt">\GLSaccessuservi</code></a> but formats the displayed text with <a id="wrglossary.16850"></a><a href="#glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12036">491</a><p>
+<div class="defnbox"><a id="wrglossary.16851"></a><a href="#glo:Glsaccessfmtuservi"><code class="csfmt">\Glsaccessfmtuservi</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16852"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16853"></a><a href="#glo:Glsaccessuservi"><code class="csfmt">\Glsaccessuservi</code></a> but formats the displayed text with <a id="wrglossary.16854"></a><a href="#glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12034">491</a><p>
+<div class="defnbox"><a id="wrglossary.16855"></a><a href="#glo:glsaccessfmtuservi"><code class="csfmt">\glsaccessfmtuservi</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16856"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.16857"></a><a href="#glo:glsaccessuservi"><code class="csfmt">\glsaccessuservi</code></a> but formats the displayed text with <a id="wrglossary.16858"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a>. <a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12031">491</a><p>
+<div class="defnbox"><a id="wrglossary.16859"></a><dfn id="glo:glsaccessibility"><code class="csfmt">\glsaccessibility</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">PDF element</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}{<span class="meta">〈<em class="metainner">content</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16860"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> v4.45+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Applies <span class="meta">〈<em class="metainner">value</em>〉</span> as the accessibility attribute <span class="meta">〈<em class="metainner">PDF element</em>〉</span> for the given <span class="meta">〈<em class="metainner">content</em>〉</span>. This internally uses the accessibility support provided by <a id="wrglossary.16861"></a><a href="#glo:pkg.accsupp"><span class="styfmt">accsupp</span></a>.<p>
+<div class="defnbox"><a id="wrglossary.16862"></a><a href="#glo:GLSaccesslong"><code class="csfmt">\GLSaccesslong</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16863"></a><a href="#glo:idx.allcaps">all caps</a> version of <a id="wrglossary.16864"></a><a href="#glo:glsaccesslong"><code class="csfmt">\glsaccesslong</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11842">481</a><p>
+<div class="defnbox"><a id="wrglossary.16865"></a><a href="#glo:Glsaccesslong"><code class="csfmt">\Glsaccesslong</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16866"></a><a href="#glo:idx.sentencecase">sentence case</a> version of <a id="wrglossary.16867"></a><a href="#glo:glsaccesslong"><code class="csfmt">\glsaccesslong</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11840">481</a><p>
+<div class="defnbox"><a id="wrglossary.16868"></a><a href="#glo:glsaccesslong"><code class="csfmt">\glsaccesslong</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+If accessibility support was enabled when <a id="wrglossary.16869"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> was loaded (<a id="wrglossary.16870"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>) this will display the value of the <a id="wrglossary.16871"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> key with the accessibility support enabled for that key (<a id="wrglossary.16872"></a><a href="#glo:opt.gloskey.longaccess"><span class="csoptfmt">longaccess</span></a>). If there is no accessibility support, this just uses <a id="wrglossary.16873"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11836">481</a><p>
+<div class="defnbox"><a id="wrglossary.16874"></a><a href="#glo:GLSaccesslongpl"><code class="csfmt">\GLSaccesslongpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16875"></a><a href="#glo:idx.allcaps">all caps</a> version of <a id="wrglossary.16876"></a><a href="#glo:glsaccesslongpl"><code class="csfmt">\glsaccesslongpl</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11850">482</a><p>
+<div class="defnbox"><a id="wrglossary.16877"></a><a href="#glo:Glsaccesslongpl"><code class="csfmt">\Glsaccesslongpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16878"></a><a href="#glo:idx.sentencecase">sentence case</a> version of <a id="wrglossary.16879"></a><a href="#glo:glsaccesslongpl"><code class="csfmt">\glsaccesslongpl</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11848">482</a><p>
+<div class="defnbox"><a id="wrglossary.16880"></a><a href="#glo:glsaccesslongpl"><code class="csfmt">\glsaccesslongpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+If accessibility support was enabled when <a id="wrglossary.16881"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> was loaded (<a id="wrglossary.16882"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>) this will display the value of the <a id="wrglossary.16883"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> key with the accessibility support enabled for that key (<a id="wrglossary.16884"></a><a href="#glo:opt.gloskey.longpluralaccess"><span class="csoptfmt">longpluralaccess</span></a>). If there is no accessibility support, this just uses <a id="wrglossary.16885"></a><a href="#glo:glsentrylongpl"><code class="csfmt">\glsentrylongpl</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11844">482</a><p>
+<div class="defnbox"><a id="wrglossary.16886"></a><a href="#glo:GLSaccessname"><code class="csfmt">\GLSaccessname</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16887"></a><a href="#glo:idx.allcaps">all caps</a> version of <a id="wrglossary.16888"></a><a href="#glo:glsaccessname"><code class="csfmt">\glsaccessname</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11754">477</a><p>
+<div class="defnbox"><a id="wrglossary.16889"></a><a href="#glo:Glsaccessname"><code class="csfmt">\Glsaccessname</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16890"></a><a href="#glo:idx.sentencecase">sentence case</a> version of <a id="wrglossary.16891"></a><a href="#glo:glsaccessname"><code class="csfmt">\glsaccessname</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11752">477</a><p>
+<div class="defnbox"><a id="wrglossary.16892"></a><a href="#glo:glsaccessname"><code class="csfmt">\glsaccessname</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+If accessibility support was enabled when <a id="wrglossary.16893"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> was loaded (<a id="wrglossary.16894"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>) this will display the value of the <a id="wrglossary.16895"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key with the accessibility support enabled for that key (<a id="wrglossary.16896"></a><a href="#glo:opt.gloskey.access"><span class="csoptfmt">access</span></a>). If there is no accessibility support, this just uses <a id="wrglossary.16897"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11748">477</a><p>
+<div class="defnbox"><a id="wrglossary.16898"></a><a href="#glo:GLSaccessplural"><code class="csfmt">\GLSaccessplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16899"></a><a href="#glo:idx.allcaps">all caps</a> version of <a id="wrglossary.16900"></a><a href="#glo:glsaccessplural"><code class="csfmt">\glsaccessplural</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11770">478</a><p>
+<div class="defnbox"><a id="wrglossary.16901"></a><a href="#glo:Glsaccessplural"><code class="csfmt">\Glsaccessplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16902"></a><a href="#glo:idx.sentencecase">sentence case</a> version of <a id="wrglossary.16903"></a><a href="#glo:glsaccessplural"><code class="csfmt">\glsaccessplural</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11768">478</a><p>
+<div class="defnbox"><a id="wrglossary.16904"></a><a href="#glo:glsaccessplural"><code class="csfmt">\glsaccessplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+If accessibility support was enabled when <a id="wrglossary.16905"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> was loaded (<a id="wrglossary.16906"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>) this will display the value of the <a id="wrglossary.16907"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> key with the accessibility support enabled for that key (<a id="wrglossary.16908"></a><a href="#glo:opt.gloskey.pluralaccess"><span class="csoptfmt">pluralaccess</span></a>). If there is no accessibility support, this just uses <a id="wrglossary.16909"></a><a href="#glo:glsentryplural"><code class="csfmt">\glsentryplural</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11764">478</a><p>
+<div class="defnbox"><a id="wrglossary.16910"></a><a href="#glo:GLSaccessshort"><code class="csfmt">\GLSaccessshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16911"></a><a href="#glo:idx.allcaps">all caps</a> version of <a id="wrglossary.16912"></a><a href="#glo:glsaccessshort"><code class="csfmt">\glsaccessshort</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11826">481</a><p>
+<div class="defnbox"><a id="wrglossary.16913"></a><a href="#glo:Glsaccessshort"><code class="csfmt">\Glsaccessshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16914"></a><a href="#glo:idx.sentencecase">sentence case</a> version of <a id="wrglossary.16915"></a><a href="#glo:glsaccessshort"><code class="csfmt">\glsaccessshort</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11824">481</a><p>
+<div class="defnbox"><a id="wrglossary.16916"></a><a href="#glo:glsaccessshort"><code class="csfmt">\glsaccessshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+If accessibility support was enabled when <a id="wrglossary.16917"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> was loaded (<a id="wrglossary.16918"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>) this will display the value of the <a id="wrglossary.16919"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> key with the accessibility support enabled for that key (<a id="wrglossary.16920"></a><a href="#glo:opt.gloskey.shortaccess"><span class="csoptfmt">shortaccess</span></a>). If there is no accessibility support, this just uses <a id="wrglossary.16921"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11820">480</a><p>
+<div class="defnbox"><a id="wrglossary.16922"></a><a href="#glo:GLSaccessshortpl"><code class="csfmt">\GLSaccessshortpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16923"></a><a href="#glo:idx.allcaps">all caps</a> version of <a id="wrglossary.16924"></a><a href="#glo:glsaccessshortpl"><code class="csfmt">\glsaccessshortpl</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11834">481</a><p>
+<div class="defnbox"><a id="wrglossary.16925"></a><a href="#glo:Glsaccessshortpl"><code class="csfmt">\Glsaccessshortpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16926"></a><a href="#glo:idx.sentencecase">sentence case</a> version of <a id="wrglossary.16927"></a><a href="#glo:glsaccessshortpl"><code class="csfmt">\glsaccessshortpl</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11832">481</a><p>
+<div class="defnbox"><a id="wrglossary.16928"></a><a href="#glo:glsaccessshortpl"><code class="csfmt">\glsaccessshortpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+If accessibility support was enabled when <a id="wrglossary.16929"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> was loaded (<a id="wrglossary.16930"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>) this will display the value of the <a id="wrglossary.16931"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> key with the accessibility support enabled for that key (<a id="wrglossary.16932"></a><a href="#glo:opt.gloskey.shortpluralaccess"><span class="csoptfmt">shortpluralaccess</span></a>). If there is no accessibility support, this just uses <a id="wrglossary.16933"></a><a href="#glo:glsentryshortpl"><code class="csfmt">\glsentryshortpl</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11828">481</a><p>
+<div class="defnbox"><a id="wrglossary.16934"></a><a href="#glo:GLSaccesssymbol"><code class="csfmt">\GLSaccesssymbol</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16935"></a><a href="#glo:idx.allcaps">all caps</a> version of <a id="wrglossary.16936"></a><a href="#glo:glsaccesssymbol"><code class="csfmt">\glsaccesssymbol</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11794">479</a><p>
+<div class="defnbox"><a id="wrglossary.16937"></a><a href="#glo:Glsaccesssymbol"><code class="csfmt">\Glsaccesssymbol</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16938"></a><a href="#glo:idx.sentencecase">sentence case</a> version of <a id="wrglossary.16939"></a><a href="#glo:glsaccesssymbol"><code class="csfmt">\glsaccesssymbol</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11792">479</a><p>
+<div class="defnbox"><a id="wrglossary.16940"></a><a href="#glo:glsaccesssymbol"><code class="csfmt">\glsaccesssymbol</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+If accessibility support was enabled when <a id="wrglossary.16941"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> was loaded (<a id="wrglossary.16942"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>) this will display the value of the <a id="wrglossary.16943"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> key with the accessibility support enabled for that key (<a id="wrglossary.16944"></a><a href="#glo:opt.gloskey.symbolaccess"><span class="csoptfmt">symbolaccess</span></a>). If there is no accessibility support, this just uses <a id="wrglossary.16945"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11788">479</a><p>
+<div class="defnbox"><a id="wrglossary.16946"></a><a href="#glo:GLSaccesssymbolplural"><code class="csfmt">\GLSaccesssymbolplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16947"></a><a href="#glo:idx.allcaps">all caps</a> version of <a id="wrglossary.16948"></a><a href="#glo:glsaccesssymbolplural"><code class="csfmt">\glsaccesssymbolplural</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11802">480</a><p>
+<div class="defnbox"><a id="wrglossary.16949"></a><a href="#glo:Glsaccesssymbolplural"><code class="csfmt">\Glsaccesssymbolplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16950"></a><a href="#glo:idx.sentencecase">sentence case</a> version of <a id="wrglossary.16951"></a><a href="#glo:glsaccesssymbolplural"><code class="csfmt">\glsaccesssymbolplural</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11800">479</a><p>
+<div class="defnbox"><a id="wrglossary.16952"></a><a href="#glo:glsaccesssymbolplural"><code class="csfmt">\glsaccesssymbolplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+If accessibility support was enabled when <a id="wrglossary.16953"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> was loaded (<a id="wrglossary.16954"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>) this will display the value of the <a id="wrglossary.16955"></a><a href="#glo:opt.gloskey.symbolplural"><span class="csoptfmt">symbolplural</span></a> key with the accessibility support enabled for that key (<a id="wrglossary.16956"></a><a href="#glo:opt.gloskey.symbolpluralaccess"><span class="csoptfmt">symbolpluralaccess</span></a>). If there is no accessibility support, this just uses <a id="wrglossary.16957"></a><a href="#glo:glsentrysymbolplural"><code class="csfmt">\glsentrysymbolplural</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11796">479</a><p>
+<div class="defnbox"><a id="wrglossary.16958"></a><a href="#glo:GLSaccesstext"><code class="csfmt">\GLSaccesstext</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16959"></a><a href="#glo:idx.allcaps">all caps</a> version of <a id="wrglossary.16960"></a><a href="#glo:glsaccesstext"><code class="csfmt">\glsaccesstext</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11762">478</a><p>
+<div class="defnbox"><a id="wrglossary.16961"></a><a href="#glo:Glsaccesstext"><code class="csfmt">\Glsaccesstext</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16962"></a><a href="#glo:idx.sentencecase">sentence case</a> version of <a id="wrglossary.16963"></a><a href="#glo:glsaccesstext"><code class="csfmt">\glsaccesstext</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11760">478</a><p>
+<div class="defnbox"><a id="wrglossary.16964"></a><a href="#glo:glsaccesstext"><code class="csfmt">\glsaccesstext</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+If accessibility support was enabled when <a id="wrglossary.16965"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> was loaded (<a id="wrglossary.16966"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>) this will display the value of the <a id="wrglossary.16967"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> key with the accessibility support enabled for that key (<a id="wrglossary.16968"></a><a href="#glo:opt.gloskey.textaccess"><span class="csoptfmt">textaccess</span></a>). If there is no accessibility support, this just uses <a id="wrglossary.16969"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11756">477</a><p>
+<div class="defnbox"><a id="wrglossary.16970"></a><a href="#glo:GLSaccessuseri"><code class="csfmt">\GLSaccessuseri</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16971"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16972"></a><a href="#glo:idx.allcaps">all caps</a> version of <a id="wrglossary.16973"></a><a href="#glo:glsaccessuseri"><code class="csfmt">\glsaccessuseri</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11858">482</a><p>
+<div class="defnbox"><a id="wrglossary.16974"></a><a href="#glo:Glsaccessuseri"><code class="csfmt">\Glsaccessuseri</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16975"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16976"></a><a href="#glo:idx.sentencecase">sentence case</a> version of <a id="wrglossary.16977"></a><a href="#glo:glsaccessuseri"><code class="csfmt">\glsaccessuseri</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11856">482</a><p>
+<div class="defnbox"><a id="wrglossary.16978"></a><a href="#glo:glsaccessuseri"><code class="csfmt">\glsaccessuseri</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16979"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If accessibility support was enabled when <a id="wrglossary.16980"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> was loaded (<a id="wrglossary.16981"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>) this will display the value of the <a id="wrglossary.16982"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key with the accessibility support enabled for that key (<a id="wrglossary.16983"></a><a href="#glo:opt.gloskey.user1access"><span class="csoptfmt">user1access</span></a>). If there is no accessibility support, this just uses <a id="wrglossary.16984"></a><a href="#glo:glsentryuseri"><code class="csfmt">\glsentryuseri</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11852">482</a><p>
+<div class="defnbox"><a id="wrglossary.16985"></a><a href="#glo:GLSaccessuserii"><code class="csfmt">\GLSaccessuserii</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16986"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16987"></a><a href="#glo:idx.allcaps">all caps</a> version of <a id="wrglossary.16988"></a><a href="#glo:glsaccessuserii"><code class="csfmt">\glsaccessuserii</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11866">483</a><p>
+<div class="defnbox"><a id="wrglossary.16989"></a><a href="#glo:Glsaccessuserii"><code class="csfmt">\Glsaccessuserii</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16990"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.16991"></a><a href="#glo:idx.sentencecase">sentence case</a> version of <a id="wrglossary.16992"></a><a href="#glo:glsaccessuserii"><code class="csfmt">\glsaccessuserii</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11864">482</a><p>
+<div class="defnbox"><a id="wrglossary.16993"></a><a href="#glo:glsaccessuserii"><code class="csfmt">\glsaccessuserii</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.16994"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If accessibility support was enabled when <a id="wrglossary.16995"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> was loaded (<a id="wrglossary.16996"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>) this will display the value of the <a id="wrglossary.16997"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a> key with the accessibility support enabled for that key (<a id="wrglossary.16998"></a><a href="#glo:opt.gloskey.user2access"><span class="csoptfmt">user2access</span></a>). If there is no accessibility support, this just uses <a id="wrglossary.16999"></a><a href="#glo:glsentryuserii"><code class="csfmt">\glsentryuserii</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11860">482</a><p>
+<div class="defnbox"><a id="wrglossary.17000"></a><a href="#glo:GLSaccessuseriii"><code class="csfmt">\GLSaccessuseriii</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17001"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.17002"></a><a href="#glo:idx.allcaps">all caps</a> version of <a id="wrglossary.17003"></a><a href="#glo:glsaccessuseriii"><code class="csfmt">\glsaccessuseriii</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11874">483</a><p>
+<div class="defnbox"><a id="wrglossary.17004"></a><a href="#glo:Glsaccessuseriii"><code class="csfmt">\Glsaccessuseriii</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17005"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.17006"></a><a href="#glo:idx.sentencecase">sentence case</a> version of <a id="wrglossary.17007"></a><a href="#glo:glsaccessuseriii"><code class="csfmt">\glsaccessuseriii</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11872">483</a><p>
+<div class="defnbox"><a id="wrglossary.17008"></a><a href="#glo:glsaccessuseriii"><code class="csfmt">\glsaccessuseriii</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17009"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If accessibility support was enabled when <a id="wrglossary.17010"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> was loaded (<a id="wrglossary.17011"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>) this will display the value of the <a id="wrglossary.17012"></a><a href="#glo:opt.gloskey.user3"><span class="csoptfmt">user3</span></a> key with the accessibility support enabled for that key (<a id="wrglossary.17013"></a><a href="#glo:opt.gloskey.user3access"><span class="csoptfmt">user3access</span></a>). If there is no accessibility support, this just uses <a id="wrglossary.17014"></a><a href="#glo:glsentryuseriii"><code class="csfmt">\glsentryuseriii</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11868">483</a><p>
+<div class="defnbox"><a id="wrglossary.17015"></a><a href="#glo:GLSaccessuseriv"><code class="csfmt">\GLSaccessuseriv</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17016"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.17017"></a><a href="#glo:idx.allcaps">all caps</a> version of <a id="wrglossary.17018"></a><a href="#glo:glsaccessuseriv"><code class="csfmt">\glsaccessuseriv</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11882">483</a><p>
+<div class="defnbox"><a id="wrglossary.17019"></a><a href="#glo:Glsaccessuseriv"><code class="csfmt">\Glsaccessuseriv</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17020"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.17021"></a><a href="#glo:idx.sentencecase">sentence case</a> version of <a id="wrglossary.17022"></a><a href="#glo:glsaccessuseriv"><code class="csfmt">\glsaccessuseriv</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11880">483</a><p>
+<div class="defnbox"><a id="wrglossary.17023"></a><a href="#glo:glsaccessuseriv"><code class="csfmt">\glsaccessuseriv</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17024"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If accessibility support was enabled when <a id="wrglossary.17025"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> was loaded (<a id="wrglossary.17026"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>) this will display the value of the <a id="wrglossary.17027"></a><a href="#glo:opt.gloskey.user4"><span class="csoptfmt">user4</span></a> key with the accessibility support enabled for that key (<a id="wrglossary.17028"></a><a href="#glo:opt.gloskey.user4access"><span class="csoptfmt">user4access</span></a>). If there is no accessibility support, this just uses <a id="wrglossary.17029"></a><a href="#glo:glsentryuseriv"><code class="csfmt">\glsentryuseriv</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11876">483</a><p>
+<div class="defnbox"><a id="wrglossary.17030"></a><a href="#glo:GLSaccessuserv"><code class="csfmt">\GLSaccessuserv</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17031"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.17032"></a><a href="#glo:idx.allcaps">all caps</a> version of <a id="wrglossary.17033"></a><a href="#glo:glsaccessuserv"><code class="csfmt">\glsaccessuserv</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11890">484</a><p>
+<div class="defnbox"><a id="wrglossary.17034"></a><a href="#glo:Glsaccessuserv"><code class="csfmt">\Glsaccessuserv</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17035"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.17036"></a><a href="#glo:idx.sentencecase">sentence case</a> version of <a id="wrglossary.17037"></a><a href="#glo:glsaccessuserv"><code class="csfmt">\glsaccessuserv</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11888">484</a><p>
+<div class="defnbox"><a id="wrglossary.17038"></a><a href="#glo:glsaccessuserv"><code class="csfmt">\glsaccessuserv</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17039"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If accessibility support was enabled when <a id="wrglossary.17040"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> was loaded (<a id="wrglossary.17041"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>) this will display the value of the <a id="wrglossary.17042"></a><a href="#glo:opt.gloskey.user5"><span class="csoptfmt">user5</span></a> key with the accessibility support enabled for that key (<a id="wrglossary.17043"></a><a href="#glo:opt.gloskey.user5access"><span class="csoptfmt">user5access</span></a>). If there is no accessibility support, this just uses <a id="wrglossary.17044"></a><a href="#glo:glsentryuserv"><code class="csfmt">\glsentryuserv</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11884">483</a><p>
+<div class="defnbox"><a id="wrglossary.17045"></a><a href="#glo:GLSaccessuservi"><code class="csfmt">\GLSaccessuservi</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17046"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.17047"></a><a href="#glo:idx.allcaps">all caps</a> version of <a id="wrglossary.17048"></a><a href="#glo:glsaccessuservi"><code class="csfmt">\glsaccessuservi</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11898">484</a><p>
+<div class="defnbox"><a id="wrglossary.17049"></a><a href="#glo:Glsaccessuservi"><code class="csfmt">\Glsaccessuservi</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17050"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.17051"></a><a href="#glo:idx.sentencecase">sentence case</a> version of <a id="wrglossary.17052"></a><a href="#glo:glsaccessuservi"><code class="csfmt">\glsaccessuservi</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11896">484</a><p>
+<div class="defnbox"><a id="wrglossary.17053"></a><a href="#glo:glsaccessuservi"><code class="csfmt">\glsaccessuservi</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17054"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If accessibility support was enabled when <a id="wrglossary.17055"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> was loaded (<a id="wrglossary.17056"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>) this will display the value of the <a id="wrglossary.17057"></a><a href="#glo:opt.gloskey.user6"><span class="csoptfmt">user6</span></a> key with the accessibility support enabled for that key (<a id="wrglossary.17058"></a><a href="#glo:opt.gloskey.user6access"><span class="csoptfmt">user6access</span></a>). If there is no accessibility support, this just uses <a id="wrglossary.17059"></a><a href="#glo:glsentryuservi"><code class="csfmt">\glsentryuservi</code></a>. <a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11892">484</a><p>
+<div class="defnbox"><a id="wrglossary.17060"></a><dfn id="glo:glsaccsupp"><code class="csfmt">\glsaccsupp</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">replacement</em>〉</span>}{<span class="meta">〈<em class="metainner">content</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17061"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Applies <span class="meta">〈<em class="metainner">replacement</em>〉</span> as the ActualText for <span class="meta">〈<em class="metainner">content</em>〉</span> using <a id="wrglossary.17062"></a><a href="#glo:glsaccessibility"><code class="csfmt">\glsaccessibility</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.17063"></a><dfn id="glo:glsacspace"><code class="csfmt">\glsacspace</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17064"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.16+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Uses a non-breakable space if the short form is less than <a id="wrglossary.17065"></a><a href="#glo:glsacspacemax"><code class="csfmt">\glsacspacemax</code></a> otherwise uses <code class="csfmt">\space</code>. This command is provided by <a id="wrglossary.17066"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> but has a hard-coded maximum of 3em. This command is redefined by <a id="wrglossary.17067"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> to use <a id="wrglossary.17068"></a><a href="#glo:glsacspacemax"><code class="csfmt">\glsacspacemax</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.17069"></a><dfn id="glo:glsacspacemax"><code class="csfmt">\glsacspacemax</code></dfn></div><!-- end of defnbox -->
+<p>
+Expands to the maximum value used by <a id="wrglossary.17070"></a><a href="#glo:glsacspace"><code class="csfmt">\glsacspace</code></a>. This is a macro not a register. The default is <code class="code">3em</code>.<p>
+<div class="defnbox"><a id="wrglossary.17071"></a><dfn id="glo:glsadd"><code class="csfmt">\glsadd</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17072"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indexes the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>.<p>
+<div class="defnbox"><a id="wrglossary.17073"></a><dfn id="glo:glsaddall"><code class="csfmt">\glsaddall</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.17074"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Iterates over all <a id="wrglossary.17075"></a><a href="#glo:dual.glossary">glossaries</a> (or all those listed in the <a id="wrglossary.17076"></a><a href="#glo:opt.glsopt.types"><span class="csoptfmt">types</span></a> option) and <a id="wrglossary.17077"></a><a href="#glo:@@glslabel@indexing">indexes</a> each entry in the <a id="wrglossary.17078"></a><a href="#glo:dual.glossary">glossary</a>. The optional argument <span class="meta">〈<em class="metainner">options</em>〉</span> are passed to <a id="wrglossary.17079"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>. This command can’t be used with <a id="wrglossary.17080"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. Use the <a id="wrglossary.17081"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">=all</span> <a id="wrglossary.17082"></a><a href="#glo:idx.resourceopt">resource option</a> instead.<p>
+<div class="defnbox"><a id="wrglossary.17083"></a><a href="#glo:glsaddallunindexed"><code class="csfmt">\glsaddallunindexed</code></a><code class="code">[<span class="meta">〈<em class="metainner">glossary types</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.17084"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Iterates over all <a id="wrglossary.17085"></a><a href="#glo:dual.glossary">glossaries</a> listed in <span class="meta">〈<em class="metainner">glossary types</em>〉</span> and <a id="wrglossary.17086"></a><a href="#glo:@@glslabel@indexing">indexes</a> each entry (with <a id="wrglossary.17087"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=glsignore</span>) that hasn’t already been indexed. This command can’t be used with <a id="wrglossary.17088"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. Use the <a id="wrglossary.17089"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">=all</span> <a id="wrglossary.17090"></a><a href="#glo:idx.resourceopt">resource option</a> instead. <a href="#sec:wrglossary">§5.8</a>; <a href="#wrglossary.6680">259</a><p>
+<div class="defnbox"><a id="wrglossary.17091"></a><dfn id="glo:glsaddallunused"><code class="csfmt">\glsaddallunused</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">glossary types</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.17092"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.08a+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Iterates over all <a id="wrglossary.17093"></a><a href="#glo:dual.glossary">glossaries</a> listed in <span class="meta">〈<em class="metainner">glossary types</em>〉</span> and <a id="wrglossary.17094"></a><a href="#glo:@@glslabel@indexing">indexes</a> each entry (with <a id="wrglossary.17095"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=glsignore</span>) that hasn’t been used. This command can’t be used with <a id="wrglossary.17096"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. Use the <a id="wrglossary.17097"></a><a href="#glo:opt.resource.selection"><span class="csoptfmt">selection</span></a><span class="optfmt">=all</span> <a id="wrglossary.17098"></a><a href="#glo:idx.resourceopt">resource option</a> instead.<p>
+<div class="defnbox"><a id="wrglossary.17099"></a><a href="#glo:glsaddeach"><code class="csfmt">\glsaddeach</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry label list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17100"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <code class="code"><a id="wrglossary.17101"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code> for each label in the supplied comma-separated list. <a href="#sec:wrglossary">§5.8</a>; <a href="#wrglossary.6693">260</a><p>
+<div class="defnbox"><a id="wrglossary.17102"></a><dfn id="glo:glsaddkey"><code class="csfmt">\glsaddkey</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">key</em>〉</span>}{<span class="meta">〈<em class="metainner">default value</em>〉</span>}{<span class="meta">〈<em class="metainner">no link cs</em>〉</span>}{<span class="meta">〈<em class="metainner">no link ucfirst cs</em>〉</span>}{<span class="meta">〈<em class="metainner">link cs</em>〉</span>}{<span class="meta">〈<em class="metainner">link ucfirst cs</em>〉</span>}{<span class="meta">〈<em class="metainner">link allcaps cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17103"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.12a</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines a new <a id="wrglossary.17104"></a><a href="#glo:idx.gloskey">glossary entry key</a> with the given default value and commands that are analogous to <a id="wrglossary.17105"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a> (<span class="meta">〈<em class="metainner">no link cs</em>〉</span>), <a id="wrglossary.17106"></a><a href="#glo:Glsentrytext"><code class="csfmt">\Glsentrytext</code></a> (<span class="meta">〈<em class="metainner">no link ucfirst cs</em>〉</span>), <a id="wrglossary.17107"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> (<span class="meta">〈<em class="metainner">link cs</em>〉</span>), <a id="wrglossary.17108"></a><a href="#glo:Glstext"><code class="csfmt">\Glstext</code></a> (<span class="meta">〈<em class="metainner">link ucfirst cs</em>〉</span>), <a id="wrglossary.17109"></a><a href="#glo:GLStext"><code class="csfmt">\GLStext</code></a> (<span class="meta">〈<em class="metainner">link allcaps cs</em>〉</span>). The starred version switches on field expansion for the given key.<p>
+<div class="defnbox"><a id="wrglossary.17110"></a><a href="#glo:glsaddpostsetkeys"><code class="csfmt">\glsaddpostsetkeys</code></a><span class="floatrightbox"><a id="wrglossary.17111"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.30+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook implemented after setting the options passed to <a id="wrglossary.17112"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>. <a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4760">188</a><p>
+<div class="defnbox"><a id="wrglossary.17113"></a><a href="#glo:glsaddpresetkeys"><code class="csfmt">\glsaddpresetkeys</code></a><span class="floatrightbox"><a id="wrglossary.17114"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.30+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook implemented before setting the options passed to <a id="wrglossary.17115"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>. <a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4758">188</a><p>
+<div class="defnbox"><a id="wrglossary.17116"></a><dfn id="glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">key</em>〉</span>}{<span class="meta">〈<em class="metainner">default value</em>〉</span>}{<span class="meta">〈<em class="metainner">no link cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17117"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.16</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Provides a new <a id="wrglossary.17118"></a><a href="#glo:idx.gloskey">glossary entry key</a> with a default value and a command for simply accessing the value (without indexing or hyperlinks). The starred version switches on field expansion for the given key.<p>
+<div class="defnbox"><a id="wrglossary.17119"></a><a href="#glo:glsaltlistitem"><code class="csfmt">\glsaltlistitem</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17120"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.47+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the top-level entry item in the <a id="wrglossary.17121"></a><a href="#glo:opt.glostyle.altlist"><span class="glostylefmt">altlist</span></a> styles. <a href="#sec:stylemodslist">§8.6.5.3</a>; <a href="#wrglossary.10924">429</a><p>
+<div class="defnbox"><a id="wrglossary.17122"></a><a href="#glo:glsalttreechildpredesc"><code class="csfmt">\glsalttreechildpredesc</code></a><span class="floatrightbox"><a id="wrglossary.17123"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.46+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Inserted before the child descriptions for the <a id="wrglossary.17124"></a><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a> styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10974">431</a><p>
+<div class="defnbox"><a id="wrglossary.17125"></a><a href="#glo:glsalttreepredesc"><code class="csfmt">\glsalttreepredesc</code></a><span class="floatrightbox"><a id="wrglossary.17126"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.46+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Inserted before the top-level descriptions for the <a id="wrglossary.17127"></a><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a> styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10973">431</a><p>
+<div class="defnbox"><a id="wrglossary.17128"></a><a href="#glo:glsapptopostlink"><code class="csfmt">\glsapptopostlink</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">code</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17129"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Appends <span class="meta">〈<em class="metainner">code</em>〉</span> to <a id="wrglossary.17130"></a><a href="#glo:dual.postlinkhook">post-link hook</a> associated with the category identified by the label <span class="meta">〈<em class="metainner">category</em>〉</span> (or simply defines it, if it doesn’t already exist). <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6382">250</a><p>
+<div class="defnbox"><a id="wrglossary.17131"></a><dfn id="glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></dfn><span class="floatrightbox"><a id="wrglossary.17132"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v1.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the prefix for the label used by <a id="wrglossary.17133"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a><span class="optfmt">=autolabel</span> and <a id="wrglossary.17134"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a><span class="optfmt">=nameref</span>.<p>
+<div class="defnbox"><a id="wrglossary.17135"></a><dfn id="glo:glsbackslash"><code class="csfmt">\glsbackslash</code></dfn><span class="floatrightbox"><a id="wrglossary.17136"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.11+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to a literal backslash.<p>
+<div class="defnbox"><a id="wrglossary.17137"></a><a href="#glo:glscapitalisewords"><code class="csfmt">\glscapitalisewords</code></a><code class="code">{<span class="meta">〈<em class="metainner">content</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17138"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Just does <a id="wrglossary.17139"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a> but may be redefined to use <a id="wrglossary.17140"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a>, if required. <a href="#sec:titlecase">§5.2.4</a>; <a href="#wrglossary.5134">200</a><p>
+<div class="defnbox"><a id="wrglossary.17141"></a><dfn id="glo:glscapscase"><code class="csfmt">\glscapscase</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">no change</em>〉</span>}{<span class="meta">〈<em class="metainner">sentence</em>〉</span>}{<span class="meta">〈<em class="metainner">all caps</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17142"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Initialised by the <a id="wrglossary.17143"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.17144"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands, this expands to <span class="meta">〈<em class="metainner">no change</em>〉</span> if the calling command doesn’t apply a case-change (such as <a id="wrglossary.17145"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or <a id="wrglossary.17146"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>), to <span class="meta">〈<em class="metainner">sentence</em>〉</span> if the calling command converts to <a id="wrglossary.17147"></a><a href="#glo:idx.sentencecase">sentence case</a> (such as <a id="wrglossary.17148"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> or <a id="wrglossary.17149"></a><a href="#glo:Glstext"><code class="csfmt">\Glstext</code></a>), or to <span class="meta">〈<em class="metainner">all caps</em>〉</span> if the calling command converts to <a id="wrglossary.17150"></a><a href="#glo:idx.allcaps">all caps</a> (such as <a id="wrglossary.17151"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a> or <a id="wrglossary.17152"></a><a href="#glo:GLStext"><code class="csfmt">\GLStext</code></a>). This command may be used within associated hooks, entry display styles (<a id="wrglossary.17153"></a><a href="#glo:defglsentryfmt"><code class="csfmt">\defglsentryfmt</code></a>), and the <a id="wrglossary.17154"></a><a href="#glo:dual.postlinkhook">post-link hook</a>.<p>
+<div class="defnbox"><a id="wrglossary.17155"></a><a href="#glo:glscapturedgroup"><code class="csfmt">\glscapturedgroup</code></a><code class="code"><span class="meta">〈<em class="metainner">n</em>〉</span></code><span class="floatrightbox"><a id="wrglossary.17156"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to <code class="code"><a id="wrglossary.17157"></a><a href="#glo:string"><code class="csfmt">\string</code></a><a id="wrglossary.17158"></a><a href="#glo:dollar"><code class="csfmt">\$</code></a><span class="meta">〈<em class="metainner">n</em>〉</span></code>. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13085">535</a><p>
+<div class="defnbox"><a id="wrglossary.17159"></a><a href="#glo:glscategory"><code class="csfmt">\glscategory</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Expands to the entry’s category. <a href="#sec:categories">§10</a>; <a href="#wrglossary.12044">492</a><p>
+<div class="defnbox"><a id="wrglossary.17160"></a><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a></div><!-- end of defnbox -->
+<p>
+Expands to the category label of the abbreviation that is in the process of being defined by <a id="wrglossary.17161"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>. Maybe used in the style hooks (but take care to expand this command, if necessary). <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4065">163</a><p>
+<div class="defnbox"><a id="wrglossary.17162"></a><a href="#glo:glscombinedfirstsep"><code class="csfmt">\glscombinedfirstsep</code></a><code class="code">{<span class="meta">〈<em class="metainner">prev label</em>〉</span>}{<span class="meta">〈<em class="metainner">next label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17163"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Separator used between elements of a multi-entry set where only the next element have been marked as used. <a href="#sec:mglssep">§7.4</a>; <a href="#wrglossary.8677">343</a><p>
+<div class="defnbox"><a id="wrglossary.17164"></a><a href="#glo:glscombinedfirstsepfirst"><code class="csfmt">\glscombinedfirstsepfirst</code></a><code class="code">{<span class="meta">〈<em class="metainner">prev label</em>〉</span>}{<span class="meta">〈<em class="metainner">next label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17165"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Separator used between elements of a multi-entry set where neither the previous nor the next element has been marked as used. <a href="#sec:mglssep">§7.4</a>; <a href="#wrglossary.8695">344</a><p>
+<div class="defnbox"><a id="wrglossary.17166"></a><a href="#glo:glscombinedsep"><code class="csfmt">\glscombinedsep</code></a><code class="code">{<span class="meta">〈<em class="metainner">prev label</em>〉</span>}{<span class="meta">〈<em class="metainner">next label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17167"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Separator used between elements of a multi-entry set where both elements have been marked as used. <a href="#sec:mglssep">§7.4</a>; <a href="#wrglossary.8670">343</a><p>
+<div class="defnbox"><a id="wrglossary.17168"></a><a href="#glo:glscombinedsepfirst"><code class="csfmt">\glscombinedsepfirst</code></a><code class="code">{<span class="meta">〈<em class="metainner">prev label</em>〉</span>}{<span class="meta">〈<em class="metainner">next label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17169"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Separator used between elements of a multi-entry set where only the previous element have been marked as used. <a href="#sec:mglssep">§7.4</a>; <a href="#wrglossary.8686">344</a><p>
+<div class="defnbox"><a id="wrglossary.17170"></a><dfn id="glo:glscurrententrylabel"><code class="csfmt">\glscurrententrylabel</code></dfn><span class="floatrightbox"><a id="wrglossary.17171"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Assigned at the start of each entry item within the glossary. This command may be used by glossary hooks, such as the <a id="wrglossary.17172"></a><a href="#glo:dual.postdeschook">post-description hook</a>, to reference the current entry.<p>
+<div class="defnbox"><a id="wrglossary.17173"></a><a href="#glo:glscurrententrylevel"><code class="csfmt">\glscurrententrylevel</code></a><span class="floatrightbox"><a id="wrglossary.17174"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.44+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined within the <a id="wrglossary.17175"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> to the current <a id="wrglossary.17176"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> (taking <a id="wrglossary.17177"></a><a href="#glo:opt.printgloss.leveloffset"><span class="csoptfmt">leveloffset</span></a> into account). <a href="#sec:printunsrtadvanced">§8.4.3</a>; <a href="#wrglossary.10231">400</a><p>
+<div class="defnbox"><a id="wrglossary.17178"></a><dfn id="glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></dfn><span class="floatrightbox"><a id="wrglossary.17179"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.23+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Conditional commands such as <a id="wrglossary.17180"></a><a href="#glo:ifglshasfield"><code class="csfmt">\ifglshasfield</code></a> set this to the field’s value for use within the <span class="meta">〈<em class="metainner">true</em>〉</span> code.<p>
+<div class="defnbox"><a id="wrglossary.17181"></a><a href="#glo:glscurrentrootentry"><code class="csfmt">\glscurrentrootentry</code></a><span class="floatrightbox"><a id="wrglossary.17182"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+May be used within <a id="wrglossary.17183"></a><a href="#glo:printunsrtglossaryentryprocesshook"><code class="csfmt">\printunsrtglossaryentryprocesshook</code></a> to reference the most recent top level entry label (allowing for <a id="wrglossary.17184"></a><a href="#glo:opt.printgloss.flatten"><span class="csoptfmt">flatten</span></a> but not <a id="wrglossary.17185"></a><a href="#glo:opt.printgloss.leveloffset"><span class="csoptfmt">leveloffset</span></a>). <a href="#sec:printunsrtadvanced">§8.4.3</a>; <a href="#wrglossary.10239">400</a><p>
+<div class="defnbox"><a id="wrglossary.17186"></a><a href="#glo:glscurrenttoplevelentry"><code class="csfmt">\glscurrenttoplevelentry</code></a><span class="floatrightbox"><a id="wrglossary.17187"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+May be used within <a id="wrglossary.17188"></a><a href="#glo:printunsrtglossaryentryprocesshook"><code class="csfmt">\printunsrtglossaryentryprocesshook</code></a> to reference the most recent top level entry label (allowing for <a id="wrglossary.17189"></a><a href="#glo:opt.printgloss.flatten"><span class="csoptfmt">flatten</span></a> and <a id="wrglossary.17190"></a><a href="#glo:opt.printgloss.leveloffset"><span class="csoptfmt">leveloffset</span></a>). <a href="#sec:printunsrtadvanced">§8.4.3</a>; <a href="#wrglossary.10235">400</a><p>
+<div class="defnbox"><a id="wrglossary.17191"></a><dfn id="glo:glscustomtext"><code class="csfmt">\glscustomtext</code></dfn><span class="floatrightbox"><a id="wrglossary.17192"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The custom text provided by <a id="wrglossary.17193"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a> or the <a id="wrglossary.17194"></a><a href="#glo:dual.linktext">link text</a> for the <a id="wrglossary.17195"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands. This command may be used within associated hooks, entry display styles (<a id="wrglossary.17196"></a><a href="#glo:defglsentryfmt"><code class="csfmt">\defglsentryfmt</code></a>), and the <a id="wrglossary.17197"></a><a href="#glo:dual.postlinkhook">post-link hook</a>.<p>
+<div class="defnbox"><a id="wrglossary.17198"></a><dfn id="glo:glsdefaultshortaccess"><code class="csfmt">\glsdefaultshortaccess</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">long</em>〉</span>}{<span class="meta">〈<em class="metainner">short</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17199"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> v4.45+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.17200"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Used when <a id="wrglossary.17201"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> automatically assigns <a id="wrglossary.17202"></a><a href="#glo:opt.gloskey.shortaccess"><span class="csoptfmt">shortaccess</span></a>. This is defined by <a id="wrglossary.17203"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> to just do <span class="meta">〈<em class="metainner">long</em>〉</span> but is redefined by <a id="wrglossary.17204"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> to do <code class="code"><span class="meta">〈<em class="metainner">long</em>〉</span> (<span class="meta">〈<em class="metainner">short</em>〉</span>)</code>.<p>
+<div class="defnbox"><a id="wrglossary.17205"></a><dfn id="glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></dfn><span class="floatrightbox"><span class="summarytag">initial: </span>main; <a id="wrglossary.17206"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the label of the default <a id="wrglossary.17207"></a><a href="#glo:dual.glossary">glossary</a>, which is normally <code class="code">main</code> but if <a id="wrglossary.17208"></a><a href="#glo:opt.nomain"><span class="styoptfmt">nomain</span></a> is used, it will be the label of the first <a id="wrglossary.17209"></a><a href="#glo:dual.glossary">glossary</a> to be defined.<p>
+<div class="defnbox"><a id="wrglossary.17210"></a><a href="#glo:glsdefpostdesc"><code class="csfmt">\glsdefpostdesc</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">definition</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17211"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines <a id="wrglossary.17212"></a><a href="#glo:dual.postdeschook">post-description hook</a> associated with the category identified by the label <span class="meta">〈<em class="metainner">category</em>〉</span>. This simply (re)defines <a id="wrglossary.17213"></a><a href="#glo:glsxtrpostdesccategory"><code class="csfmt">\glsxtrpostdesc<span class="meta">〈<em class="metainner">category</em>〉</span></code></a> for the given <span class="meta">〈<em class="metainner">category</em>〉</span> to <span class="meta">〈<em class="metainner">definition</em>〉</span>. <a href="#sec:postdeschooks">§8.6.2</a>; <a href="#wrglossary.10744">422</a><p>
+<div class="defnbox"><a id="wrglossary.17214"></a><a href="#glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">definition</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17215"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines <a id="wrglossary.17216"></a><a href="#glo:dual.postlinkhook">post-link hook</a> associated with the category identified by the label <span class="meta">〈<em class="metainner">category</em>〉</span>. This simply (re)defines <a id="wrglossary.17217"></a><a href="#glo:glsxtrpostlinkcat"><code class="csfmt">\glsxtrpostlink<span class="meta">〈<em class="metainner">category</em>〉</span></code></a> for the given <span class="meta">〈<em class="metainner">category</em>〉</span> to <span class="meta">〈<em class="metainner">definition</em>〉</span>. <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6377">250</a><p>
+<div class="defnbox"><a id="wrglossary.17218"></a><a href="#glo:glsdefpostname"><code class="csfmt">\glsdefpostname</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">definition</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17219"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines <a id="wrglossary.17220"></a><a href="#glo:dual.postnamehook">post-name hook</a> associated with the category identified by the label <span class="meta">〈<em class="metainner">category</em>〉</span>. This simply (re)defines <a id="wrglossary.17221"></a><a href="#glo:glsxtrpostnamecategory"><code class="csfmt">\glsxtrpostname<span class="meta">〈<em class="metainner">category</em>〉</span></code></a> for the given <span class="meta">〈<em class="metainner">category</em>〉</span> to <span class="meta">〈<em class="metainner">definition</em>〉</span>. <a href="#sec:postnamehooks">§8.6.1</a>; <a href="#wrglossary.10706">420</a><p>
+<div class="defnbox"><a id="wrglossary.17222"></a><dfn id="glo:GLSdesc"><code class="csfmt">\GLSdesc</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.17223"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.17224"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.17225"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.17226"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.17227"></a><a href="#glo:glsdesc"><code class="csfmt">\glsdesc</code></a> but converts the <a id="wrglossary.17228"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.17229"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="defnbox"><a id="wrglossary.17230"></a><dfn id="glo:Glsdesc"><code class="csfmt">\Glsdesc</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.17231"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.17232"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.17233"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.17234"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.17235"></a><a href="#glo:glsdesc"><code class="csfmt">\glsdesc</code></a> but converts the <a id="wrglossary.17236"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.17237"></a><a href="#glo:idx.sentencecase">sentence case</a>. Use <a id="wrglossary.17238"></a><a href="#glo:Glossentrydesc"><code class="csfmt">\Glossentrydesc</code></a> within custom glossary styles instead of this command.<p>
+<div class="defnbox"><a id="wrglossary.17239"></a><dfn id="glo:glsdesc"><code class="csfmt">\glsdesc</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.17240"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.17241"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.17242"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.17243"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The text produced is obtained from the <a id="wrglossary.17244"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> value. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument will be inserted at the end of the <a id="wrglossary.17245"></a><a href="#glo:dual.linktext">link text</a>. This command does not alter or depend on the <a id="wrglossary.17246"></a><a href="#glo:dual.firstuseflag">first use flag</a>. For the first optional argument, see <a id="wrglossary.17247"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>. Use <a id="wrglossary.17248"></a><a href="#glo:glossentrydesc"><code class="csfmt">\glossentrydesc</code></a> within custom glossary styles instead of this command.<p>
+<div class="defnbox"><a id="wrglossary.17249"></a><dfn id="glo:glsdescplural"><code class="csfmt">\glsdescplural</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.17250"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.17251"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.17252"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.17253"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.17254"></a><a href="#glo:glsdesc"><code class="csfmt">\glsdesc</code></a> but for the <a id="wrglossary.17255"></a><a href="#glo:opt.gloskey.descriptionplural"><span class="csoptfmt">descriptionplural</span></a> field.<p>
+<div class="defnbox"><a id="wrglossary.17256"></a><dfn id="glo:glsdescriptionaccessdisplay"><code class="csfmt">\glsdescriptionaccessdisplay</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17257"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">text</em>〉</span> with the <a id="wrglossary.17258"></a><a href="#glo:opt.gloskey.descriptionaccess"><span class="csoptfmt">descriptionaccess</span></a> replacement text (if set).<p>
+<div class="defnbox"><a id="wrglossary.17259"></a><dfn id="glo:glsdescriptionpluralaccessdisplay"><code class="csfmt">\glsdescriptionpluralaccessdisplay</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17260"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">text</em>〉</span> with the <a id="wrglossary.17261"></a><a href="#glo:opt.gloskey.descriptionpluralaccess"><span class="csoptfmt">descriptionpluralaccess</span></a> replacement text (if set).<p>
+<div class="defnbox"><a id="wrglossary.17262"></a><dfn id="glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></dfn><span class="floatrightbox"><a id="wrglossary.17263"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a> &amp; <a id="wrglossary.17264"></a><a href="#glo:pkg.glossary-super"><span class="styfmt">glossary-super</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A length register used to set the width of the description column for <a id="wrglossary.17265"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>-like styles.<p>
+<div class="defnbox"><a id="wrglossary.17266"></a><dfn id="glo:Glsdisp"><code class="csfmt">\Glsdisp</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.17267"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.17268"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.17269"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.17270"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.17271"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a> but sets the <a id="wrglossary.17272"></a><a href="#glo:dual.linktext">link text</a> to <code class="code"><a id="wrglossary.17273"></a><a href="#glo:glssentencecase"><code class="csfmt">\glssentencecase</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code>. This is provided to allow a <a id="wrglossary.17274"></a><a href="#glo:idx.sentencecase">sentence case</a> mapping in the event that <a id="wrglossary.17275"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a> occurs at the start of content that has automated case-changing.<p>
+<div class="defnbox"><a id="wrglossary.17276"></a><dfn id="glo:glsdisp"><code class="csfmt">\glsdisp</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.17277"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.17278"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.17279"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.17280"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v1.19+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> with the given <span class="meta">〈<em class="metainner">text</em>〉</span> as the <a id="wrglossary.17281"></a><a href="#glo:dual.linktext">link text</a>. This command unsets the <a id="wrglossary.17282"></a><a href="#glo:dual.firstuseflag">first use flag</a> (use <a id="wrglossary.17283"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a> instead, if the <a id="wrglossary.17284"></a><a href="#glo:dual.firstuseflag">first use flag</a> should not be altered). This command is considered a <a id="wrglossary.17285"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> command. For the first optional argument, see <a id="wrglossary.17286"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>.<p>
+<div class="defnbox"><a id="wrglossary.17287"></a><a href="#glo:glsdisplaynumberlist"><code class="csfmt">\glsdisplaynumberlist</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17288"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the <a id="wrglossary.17289"></a><a href="#glo:dual.locationlist">location list</a> for the given entry. Redefined by <a id="wrglossary.17290"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> to obtain the <a id="wrglossary.17291"></a><a href="#glo:dual.locationlist">location list</a> from the <a id="wrglossary.17292"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a> field. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13928">571</a><p>
+<div class="defnbox"><a id="wrglossary.17293"></a><dfn id="glo:glsdoifexists"><code class="csfmt">\glsdoifexists</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">code</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17294"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">code</em>〉</span> if the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> exists. If the entry doesn’t exist, this will either generate an error (<a id="wrglossary.17295"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=</span><a id="wrglossary.17296"></a><a href="#glo:optval.undefaction.error"><span class="optfmt">error</span></a>) or a warning (<a id="wrglossary.17297"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=</span><a id="wrglossary.17298"></a><a href="#glo:optval.undefaction.warn"><span class="optfmt">warn</span></a>) and, within the document environment, it will insert the unknown marker <a id="wrglossary.17299"></a><a href="#glo:idx.unknowntag"><code class="code">??</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.17300"></a><dfn id="glo:glsdoifexistsordo"><code class="csfmt">\glsdoifexistsordo</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17301"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.19+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.17302"></a><a href="#glo:ifglsentryexists"><code class="csfmt">\ifglsentryexists</code></a>, this does <span class="meta">〈<em class="metainner">true</em>〉</span> if the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> exists. If the entry doesn’t it exist, this does <span class="meta">〈<em class="metainner">false</em>〉</span> and generates an error (<a id="wrglossary.17303"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=</span><a id="wrglossary.17304"></a><a href="#glo:optval.undefaction.error"><span class="optfmt">error</span></a>) or a warning (<a id="wrglossary.17305"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=</span><a id="wrglossary.17306"></a><a href="#glo:optval.undefaction.warn"><span class="optfmt">warn</span></a>). The unknown marker <a id="wrglossary.17307"></a><a href="#glo:idx.unknowntag"><code class="code">??</code></a> will be placed before the <span class="meta">〈<em class="metainner">false</em>〉</span> code.<p>
+<div class="defnbox"><a id="wrglossary.17308"></a><dfn id="glo:glsdoifexistsorwarn"><code class="csfmt">\glsdoifexistsorwarn</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">code</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17309"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.03+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.17310"></a><a href="#glo:glsdoifexists"><code class="csfmt">\glsdoifexists</code></a>, but always warns (no error) if the entry doesn’t exist, regardless of the <a id="wrglossary.17311"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a> setting, and doesn’t show the unknown marker.<p>
+<div class="defnbox"><a id="wrglossary.17312"></a><dfn id="glo:glsdoifnoexists"><code class="csfmt">\glsdoifnoexists</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">code</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17313"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">code</em>〉</span> if the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> does not exist. If the entry does exist, this will either generate an error (<a id="wrglossary.17314"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=</span><a id="wrglossary.17315"></a><a href="#glo:optval.undefaction.error"><span class="optfmt">error</span></a>) or a warning (<a id="wrglossary.17316"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=</span><a id="wrglossary.17317"></a><a href="#glo:optval.undefaction.warn"><span class="optfmt">warn</span></a>).<p>
+<div class="defnbox"><a id="wrglossary.17318"></a><dfn id="glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></dfn><span class="floatrightbox"><a id="wrglossary.17319"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Enables entry counting.<p>
+<div class="defnbox"><a id="wrglossary.17320"></a><a href="#glo:glsenableentryunitcount"><code class="csfmt">\glsenableentryunitcount</code></a></div><!-- end of defnbox -->
+<p>
+Enables entry unit counting. <a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8074">313</a><p>
+<div class="defnbox"><a id="wrglossary.17321"></a><a href="#glo:glsencapwrcontent"><code class="csfmt">\glsencapwrcontent</code></a><code class="code">{<span class="meta">〈<em class="metainner">code</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17322"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ &amp; <a id="wrglossary.17323"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Encapsulates the <a id="wrglossary.17324"></a><a href="#glo:dual.indexing">indexing</a> code (within <a id="wrglossary.17325"></a><a href="#glo:glslinkwrcontent"><code class="csfmt">\glslinkwrcontent</code></a>). <a href="#sec:wrglossary">§5.8</a>; <a href="#wrglossary.6894">264</a><p>
+<div class="defnbox"><a id="wrglossary.17326"></a><dfn id="glo:glsentrycounterlabel"><code class="csfmt">\glsentrycounterlabel</code></dfn><span class="floatrightbox"><a id="wrglossary.17327"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.0+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.17328"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a> to display the entry counter label.<p>
+<div class="defnbox"><a id="wrglossary.17329"></a><dfn id="glo:glsentrycurrcount"><code class="csfmt">\glsentrycurrcount</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17330"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the current entry count running total or 0 if not available (needs to be enabled with <a id="wrglossary.17331"></a><a href="#glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></a> or <a id="wrglossary.17332"></a><a href="#glo:glsenableentryunitcount"><code class="csfmt">\glsenableentryunitcount</code></a>). With unit entry counting, this expands to the total for the current unit.<p>
+<div class="defnbox"><a id="wrglossary.17333"></a><dfn id="glo:Glsentrydesc"><code class="csfmt">\Glsentrydesc</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17334"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Partially robust command that displays the value of the <a id="wrglossary.17335"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> <a id="wrglossary.17336"></a><a href="#glo:dual.field">field</a> with <a id="wrglossary.17337"></a><a href="#glo:idx.sentencecase">sentence case</a> applied. As from <a id="wrglossary.17338"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50, this command can expand in PDF bookmarks. Outside of PDF bookmarks it will expand to a robust internal command.<p>
+<div class="defnbox"><a id="wrglossary.17339"></a><dfn id="glo:glsentrydesc"><code class="csfmt">\glsentrydesc</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17340"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Simply expands to the value of the <a id="wrglossary.17341"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> <a id="wrglossary.17342"></a><a href="#glo:dual.field">field</a>. Does nothing if the entry hasn’t been defined. May be used in expandable contexts provided that the <a id="wrglossary.17343"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> <a id="wrglossary.17344"></a><a href="#glo:dual.field">field</a> doesn’t contain any fragile commands.<p>
+<div class="defnbox"><a id="wrglossary.17345"></a><dfn id="glo:glsentrydescplural"><code class="csfmt">\glsentrydescplural</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17346"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Simply expands to the value of the <a id="wrglossary.17347"></a><a href="#glo:opt.gloskey.descriptionplural"><span class="csoptfmt">descriptionplural</span></a> <a id="wrglossary.17348"></a><a href="#glo:dual.field">field</a>. Does nothing if the entry hasn’t been defined. May be used in expandable contexts provided that the <a id="wrglossary.17349"></a><a href="#glo:opt.gloskey.descriptionplural"><span class="csoptfmt">descriptionplural</span></a> <a id="wrglossary.17350"></a><a href="#glo:dual.field">field</a> doesn’t contain any fragile commands.<p>
+<div class="defnbox"><a id="wrglossary.17351"></a><dfn id="glo:Glsentryfirst"><code class="csfmt">\Glsentryfirst</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17352"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Partially robust command that displays the value of the <a id="wrglossary.17353"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> <a id="wrglossary.17354"></a><a href="#glo:dual.field">field</a> with the first letter converted to <a id="wrglossary.17355"></a><a href="#glo:idx.uppercase">uppercase</a>. As from <a id="wrglossary.17356"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50, this command can expand in PDF bookmarks. Outside of PDF bookmarks it will expand to a robust internal command.<p>
+<div class="defnbox"><a id="wrglossary.17357"></a><dfn id="glo:glsentryfirst"><code class="csfmt">\glsentryfirst</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17358"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Simply expands to the value of the <a id="wrglossary.17359"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> <a id="wrglossary.17360"></a><a href="#glo:dual.field">field</a>. Does nothing if the entry hasn’t been defined. May be used in expandable contexts provided that the <a id="wrglossary.17361"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> <a id="wrglossary.17362"></a><a href="#glo:dual.field">field</a> doesn’t contain any fragile commands.<p>
+<div class="defnbox"><a id="wrglossary.17363"></a><dfn id="glo:Glsentryfirstplural"><code class="csfmt">\Glsentryfirstplural</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17364"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Partially robust command that displays the value of the <a id="wrglossary.17365"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> <a id="wrglossary.17366"></a><a href="#glo:dual.field">field</a> with <a id="wrglossary.17367"></a><a href="#glo:idx.sentencecase">sentence case</a> applied. As from <a id="wrglossary.17368"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50, this command can expand in PDF bookmarks. Outside of PDF bookmarks it will expand to a robust internal command.<p>
+<div class="defnbox"><a id="wrglossary.17369"></a><dfn id="glo:glsentryfirstplural"><code class="csfmt">\glsentryfirstplural</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17370"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Simply expands to the value of the <a id="wrglossary.17371"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> <a id="wrglossary.17372"></a><a href="#glo:dual.field">field</a>. Does nothing if the entry hasn’t been defined. May be used in expandable contexts provided that the <a id="wrglossary.17373"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> <a id="wrglossary.17374"></a><a href="#glo:dual.field">field</a> doesn’t contain any fragile commands.<p>
+<div class="defnbox"><a id="wrglossary.17375"></a><dfn id="glo:glsentryfmt"><code class="csfmt">\glsentryfmt</code></dfn><span class="floatrightbox"><a id="wrglossary.17376"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.11a+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The default display format used by the <a id="wrglossary.17377"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands. This checks if the <a id="wrglossary.17378"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> field has been set for the current entry and, if set, initialises the abbreviation formatting commands (with <a id="wrglossary.17379"></a><a href="#glo:glssetabbrvfmt"><code class="csfmt">\glssetabbrvfmt</code></a>). This command will do <a id="wrglossary.17380"></a><a href="#glo:glsgenentryfmt"><code class="csfmt">\glsgenentryfmt</code></a> (encapsulated with <a id="wrglossary.17381"></a><a href="#glo:glsxtrregularfont"><code class="csfmt">\glsxtrregularfont</code></a>) if the entry is considered a regular entry (<a id="wrglossary.17382"></a><a href="#glo:glsifregular"><code class="csfmt">\glsifregular</code></a>) or if the entry doesn’t have the <a id="wrglossary.17383"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> field set. Otherwise it will do <a id="wrglossary.17384"></a><a href="#glo:glsxtrgenabbrvfmt"><code class="csfmt">\glsxtrgenabbrvfmt</code></a> encapsulated with <a id="wrglossary.17385"></a><a href="#glo:glsxtrabbreviationfont"><code class="csfmt">\glsxtrabbreviationfont</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.17386"></a><a href="#glo:glsentryindexcount"><code class="csfmt">\glsentryindexcount</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17387"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the number of times the given entry has been indexed. This will expand to 0 if the entry hasn’t been indexed or hasn’t been defined. <a href="#sec:wrglossary">§5.8</a>; <a href="#wrglossary.6916">264</a><p>
+<div class="defnbox"><a id="wrglossary.17388"></a><dfn id="glo:glsentryitem"><code class="csfmt">\glsentryitem</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17389"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.0+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does nothing if <a id="wrglossary.17390"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=false</span>, otherwise increments and displays the associated counter.<p>
+<div class="defnbox"><a id="wrglossary.17391"></a><dfn id="glo:Glsentrylong"><code class="csfmt">\Glsentrylong</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17392"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.0+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the value of the <a id="wrglossary.17393"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> <a id="wrglossary.17394"></a><a href="#glo:dual.field">field</a> with <a id="wrglossary.17395"></a><a href="#glo:idx.sentencecase">sentence case</a> applied. Does nothing if the entry hasn’t been defined. As from <a id="wrglossary.17396"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50, this command can expand in PDF bookmarks. Outside of PDF bookmarks it will expand to a robust internal command.<p>
+<div class="defnbox"><a id="wrglossary.17397"></a><dfn id="glo:glsentrylong"><code class="csfmt">\glsentrylong</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17398"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.0+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Simply expands to the value of the <a id="wrglossary.17399"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> <a id="wrglossary.17400"></a><a href="#glo:dual.field">field</a>. Does nothing if the entry hasn’t been defined. May be used in expandable contexts provided that the <a id="wrglossary.17401"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> <a id="wrglossary.17402"></a><a href="#glo:dual.field">field</a> doesn’t contain any fragile commands.<p>
+<div class="defnbox"><a id="wrglossary.17403"></a><dfn id="glo:Glsentrylongpl"><code class="csfmt">\Glsentrylongpl</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17404"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.0+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the value of the <a id="wrglossary.17405"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> <a id="wrglossary.17406"></a><a href="#glo:dual.field">field</a> with <a id="wrglossary.17407"></a><a href="#glo:idx.sentencecase">sentence case</a> applied. Does nothing if the entry hasn’t been defined. As from <a id="wrglossary.17408"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50, this command can expand in PDF bookmarks. Outside of PDF bookmarks it will expand to a robust internal command.<p>
+<div class="defnbox"><a id="wrglossary.17409"></a><dfn id="glo:glsentrylongpl"><code class="csfmt">\glsentrylongpl</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17410"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.0+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Simply expands to the value of the <a id="wrglossary.17411"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> <a id="wrglossary.17412"></a><a href="#glo:dual.field">field</a>. Does nothing if the entry hasn’t been defined. May be used in expandable contexts provided that the <a id="wrglossary.17413"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> <a id="wrglossary.17414"></a><a href="#glo:dual.field">field</a> doesn’t contain any fragile commands.<p>
+<div class="defnbox"><a id="wrglossary.17415"></a><dfn id="glo:Glsentryname"><code class="csfmt">\Glsentryname</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17416"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Partially robust command that displays the value of the <a id="wrglossary.17417"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> <a id="wrglossary.17418"></a><a href="#glo:dual.field">field</a> with <a id="wrglossary.17419"></a><a href="#glo:idx.sentencecase">sentence case</a> applied. As from <a id="wrglossary.17420"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50, this command can expand in PDF bookmarks. Outside of PDF bookmarks it will expand to a robust internal command.<p>
+<div class="defnbox"><a id="wrglossary.17421"></a><dfn id="glo:glsentryname"><code class="csfmt">\glsentryname</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17422"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Simply expands to the value of the <a id="wrglossary.17423"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key. Does nothing if the entry hasn’t been defined. May be used in expandable contexts provided that the <a id="wrglossary.17424"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key doesn’t contain any fragile commands.<p>
+<div class="defnbox"><a id="wrglossary.17425"></a><a href="#glo:glsentrynumberlist"><code class="csfmt">\glsentrynumberlist</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17426"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the <a id="wrglossary.17427"></a><a href="#glo:dual.locationlist">location list</a> for the given entry. Redefined by <a id="wrglossary.17428"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> to obtain the <a id="wrglossary.17429"></a><a href="#glo:dual.locationlist">location list</a> from the <a id="wrglossary.17430"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a> field. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13936">572</a><p>
+<div class="defnbox"><a id="wrglossary.17431"></a><dfn id="glo:glsentryparent"><code class="csfmt">\glsentryparent</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17432"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the value of the <a id="wrglossary.17433"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> <a id="wrglossary.17434"></a><a href="#glo:dual.field">field</a>. Expands to nothing if the <a id="wrglossary.17435"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> <a id="wrglossary.17436"></a><a href="#glo:dual.field">field</a> hasn’t been set and expands to <a id="wrglossary.17437"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a> if the entry hasn’t been defined.<p>
+<div class="defnbox"><a id="wrglossary.17438"></a><a href="#glo:glsentrypdfsymbol"><code class="csfmt">\glsentrypdfsymbol</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17439"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used when <a id="wrglossary.17440"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a> occurs in a PDF bookmark. <a href="#sec:glosstylemods">§8.6</a>; <a href="#wrglossary.10657">419</a><p>
+<div class="defnbox"><a id="wrglossary.17441"></a><dfn id="glo:Glsentryplural"><code class="csfmt">\Glsentryplural</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17442"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Partially robust command that displays the value of the <a id="wrglossary.17443"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> <a id="wrglossary.17444"></a><a href="#glo:dual.field">field</a> with <a id="wrglossary.17445"></a><a href="#glo:idx.sentencecase">sentence case</a> applied. As from <a id="wrglossary.17446"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50, this command can expand in PDF bookmarks. Outside of PDF bookmarks it will expand to a robust internal command.<p>
+<div class="defnbox"><a id="wrglossary.17447"></a><dfn id="glo:glsentryplural"><code class="csfmt">\glsentryplural</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17448"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Simply expands to the value of the <a id="wrglossary.17449"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> <a id="wrglossary.17450"></a><a href="#glo:dual.field">field</a>. Does nothing if the entry hasn’t been defined. May be used in expandable contexts provided that the <a id="wrglossary.17451"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> <a id="wrglossary.17452"></a><a href="#glo:dual.field">field</a> doesn’t contain any fragile commands.<p>
+<div class="defnbox"><a id="wrglossary.17453"></a><dfn id="glo:glsentryprevcount"><code class="csfmt">\glsentryprevcount</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17454"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the final entry count total from the previous LaTeX run or if 0 if not available (needs to be enabled with <a id="wrglossary.17455"></a><a href="#glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></a> or <a id="wrglossary.17456"></a><a href="#glo:glsenableentryunitcount"><code class="csfmt">\glsenableentryunitcount</code></a>). With unit entry counting, this expands to the total for the current unit.<p>
+<div class="defnbox"><a id="wrglossary.17457"></a><a href="#glo:glsentryprevmaxcount"><code class="csfmt">\glsentryprevmaxcount</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17458"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the maximum entry unit count total from the previous LaTeX run or if 0 if not available (needs to be enabled with <a id="wrglossary.17459"></a><a href="#glo:glsenableentryunitcount"><code class="csfmt">\glsenableentryunitcount</code></a>). <a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8100">314</a><p>
+<div class="defnbox"><a id="wrglossary.17460"></a><a href="#glo:glsentryprevtotalcount"><code class="csfmt">\glsentryprevtotalcount</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17461"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the final entry count total from the previous LaTeX run or if 0 if not available (needs to be enabled with <a id="wrglossary.17462"></a><a href="#glo:glsenableentryunitcount"><code class="csfmt">\glsenableentryunitcount</code></a>). <a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8099">314</a><p>
+<div class="defnbox"><a id="wrglossary.17463"></a><dfn id="glo:Glsentryshort"><code class="csfmt">\Glsentryshort</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17464"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.0+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the value of the <a id="wrglossary.17465"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> <a id="wrglossary.17466"></a><a href="#glo:dual.field">field</a> with <a id="wrglossary.17467"></a><a href="#glo:idx.sentencecase">sentence case</a> applied. Does nothing if the entry hasn’t been defined. As from <a id="wrglossary.17468"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50, this command can expand in PDF bookmarks. Outside of PDF bookmarks it will expand to a robust internal command.<p>
+<div class="defnbox"><a id="wrglossary.17469"></a><dfn id="glo:glsentryshort"><code class="csfmt">\glsentryshort</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17470"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.0+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Simply expands to the value of the <a id="wrglossary.17471"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> <a id="wrglossary.17472"></a><a href="#glo:dual.field">field</a>. Does nothing if the entry hasn’t been defined. May be used in expandable contexts provided that the <a id="wrglossary.17473"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> <a id="wrglossary.17474"></a><a href="#glo:dual.field">field</a> doesn’t contain any fragile commands.<p>
+<div class="defnbox"><a id="wrglossary.17475"></a><dfn id="glo:Glsentryshortpl"><code class="csfmt">\Glsentryshortpl</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17476"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.0+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the value of the <a id="wrglossary.17477"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> <a id="wrglossary.17478"></a><a href="#glo:dual.field">field</a> with <a id="wrglossary.17479"></a><a href="#glo:idx.sentencecase">sentence case</a> applied. Does nothing if the entry hasn’t been defined. As from <a id="wrglossary.17480"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50, this command can expand in PDF bookmarks. Outside of PDF bookmarks it will expand to a robust internal command.<p>
+<div class="defnbox"><a id="wrglossary.17481"></a><dfn id="glo:glsentryshortpl"><code class="csfmt">\glsentryshortpl</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17482"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.0+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Simply expands to the value of the <a id="wrglossary.17483"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> <a id="wrglossary.17484"></a><a href="#glo:dual.field">field</a>. Does nothing if the entry hasn’t been defined. May be used in expandable contexts provided that the <a id="wrglossary.17485"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> <a id="wrglossary.17486"></a><a href="#glo:dual.field">field</a> doesn’t contain any fragile commands.<p>
+<div class="defnbox"><a id="wrglossary.17487"></a><dfn id="glo:Glsentrysymbol"><code class="csfmt">\Glsentrysymbol</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17488"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Partially robust command that displays the value of the <a id="wrglossary.17489"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> <a id="wrglossary.17490"></a><a href="#glo:dual.field">field</a> with <a id="wrglossary.17491"></a><a href="#glo:idx.sentencecase">sentence case</a> applied. As from <a id="wrglossary.17492"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50, this command can expand in PDF bookmarks. Outside of PDF bookmarks it will expand to a robust internal command.<p>
+<div class="defnbox"><a id="wrglossary.17493"></a><dfn id="glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17494"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Simply expands to the value of the <a id="wrglossary.17495"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> <a id="wrglossary.17496"></a><a href="#glo:dual.field">field</a>. Does nothing if the entry hasn’t been defined. May be used in expandable contexts provided that the <a id="wrglossary.17497"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> <a id="wrglossary.17498"></a><a href="#glo:dual.field">field</a> doesn’t contain any fragile commands.<p>
+<div class="defnbox"><a id="wrglossary.17499"></a><dfn id="glo:glsentrysymbolaccess"><code class="csfmt">\glsentrysymbolaccess</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17500"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.17501"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a> but for the <a id="wrglossary.17502"></a><a href="#glo:opt.gloskey.symbolaccess"><span class="csoptfmt">symbolaccess</span></a> field.<p>
+<div class="defnbox"><a id="wrglossary.17503"></a><dfn id="glo:glsentrysymbolplural"><code class="csfmt">\glsentrysymbolplural</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17504"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Simply expands to the value of the <a id="wrglossary.17505"></a><a href="#glo:opt.gloskey.symbolplural"><span class="csoptfmt">symbolplural</span></a> <a id="wrglossary.17506"></a><a href="#glo:dual.field">field</a>. Does nothing if the entry hasn’t been defined. May be used in expandable contexts provided that the <a id="wrglossary.17507"></a><a href="#glo:opt.gloskey.symbolplural"><span class="csoptfmt">symbolplural</span></a> <a id="wrglossary.17508"></a><a href="#glo:dual.field">field</a> doesn’t contain any fragile commands.<p>
+<div class="defnbox"><a id="wrglossary.17509"></a><dfn id="glo:Glsentrytext"><code class="csfmt">\Glsentrytext</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17510"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Partially robust command that displays the value of the <a id="wrglossary.17511"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> <a id="wrglossary.17512"></a><a href="#glo:dual.field">field</a> with <a id="wrglossary.17513"></a><a href="#glo:idx.sentencecase">sentence case</a> applied. As from <a id="wrglossary.17514"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50, this command can expand in PDF bookmarks. Outside of PDF bookmarks it will expand to a robust internal command.<p>
+<div class="defnbox"><a id="wrglossary.17515"></a><dfn id="glo:glsentrytext"><code class="csfmt">\glsentrytext</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17516"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Simply expands to the value of the <a id="wrglossary.17517"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> <a id="wrglossary.17518"></a><a href="#glo:dual.field">field</a>. Does nothing if the entry hasn’t been defined. May be used in expandable contexts provided that the <a id="wrglossary.17519"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> <a id="wrglossary.17520"></a><a href="#glo:dual.field">field</a> doesn’t contain any fragile commands.<p>
+<div class="defnbox"><a id="wrglossary.17521"></a><dfn id="glo:glsentrytitlecase"><code class="csfmt">\glsentrytitlecase</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17522"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.22+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Applies <a id="wrglossary.17523"></a><a href="#glo:idx.titlecase">title case</a> to the value supplied in the given field (which is obtained with <a id="wrglossary.17524"></a><a href="#glo:glsfieldfetch"><code class="csfmt">\glsfieldfetch</code></a>).<p>
+<div class="defnbox"><a id="wrglossary.17525"></a><dfn id="glo:glsentrytype"><code class="csfmt">\glsentrytype</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17526"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Simply expands to the value of the <a id="wrglossary.17527"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> key. Does nothing if the entry hasn’t been defined.<p>
+<div class="defnbox"><a id="wrglossary.17528"></a><dfn id="glo:Glsentryuseri"><code class="csfmt">\Glsentryuseri</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17529"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Partially robust command that displays the value of the <a id="wrglossary.17530"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> <a id="wrglossary.17531"></a><a href="#glo:dual.field">field</a> with <a id="wrglossary.17532"></a><a href="#glo:idx.sentencecase">sentence case</a> applied. As from <a id="wrglossary.17533"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50, this command can expand in PDF bookmarks. Outside of PDF bookmarks it will expand to a robust internal command.<p>
+<div class="defnbox"><a id="wrglossary.17534"></a><dfn id="glo:glsentryuseri"><code class="csfmt">\glsentryuseri</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17535"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Simply expands to the value of the <a id="wrglossary.17536"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> <a id="wrglossary.17537"></a><a href="#glo:dual.field">field</a>. Does nothing if the entry hasn’t been defined. May be used in expandable contexts provided that the <a id="wrglossary.17538"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> <a id="wrglossary.17539"></a><a href="#glo:dual.field">field</a> doesn’t contain any fragile commands.<p>
+<div class="defnbox"><a id="wrglossary.17540"></a><dfn id="glo:Glsentryuserii"><code class="csfmt">\Glsentryuserii</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17541"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Partially robust command that displays the value of the <a id="wrglossary.17542"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a> <a id="wrglossary.17543"></a><a href="#glo:dual.field">field</a> with <a id="wrglossary.17544"></a><a href="#glo:idx.sentencecase">sentence case</a> applied. As from <a id="wrglossary.17545"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50, this command can expand in PDF bookmarks. Outside of PDF bookmarks it will expand to a robust internal command.<p>
+<div class="defnbox"><a id="wrglossary.17546"></a><dfn id="glo:glsentryuserii"><code class="csfmt">\glsentryuserii</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17547"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Simply expands to the value of the <a id="wrglossary.17548"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a> <a id="wrglossary.17549"></a><a href="#glo:dual.field">field</a>. Does nothing if the entry hasn’t been defined. May be used in expandable contexts provided that the <a id="wrglossary.17550"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a> <a id="wrglossary.17551"></a><a href="#glo:dual.field">field</a> doesn’t contain any fragile commands.<p>
+<div class="defnbox"><a id="wrglossary.17552"></a><dfn id="glo:Glsentryuseriii"><code class="csfmt">\Glsentryuseriii</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17553"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Partially robust command that displays the value of the <a id="wrglossary.17554"></a><a href="#glo:opt.gloskey.user3"><span class="csoptfmt">user3</span></a> <a id="wrglossary.17555"></a><a href="#glo:dual.field">field</a> with <a id="wrglossary.17556"></a><a href="#glo:idx.sentencecase">sentence case</a> applied. As from <a id="wrglossary.17557"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50, this command can expand in PDF bookmarks. Outside of PDF bookmarks it will expand to a robust internal command.<p>
+<div class="defnbox"><a id="wrglossary.17558"></a><dfn id="glo:glsentryuseriii"><code class="csfmt">\glsentryuseriii</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17559"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Simply expands to the value of the <a id="wrglossary.17560"></a><a href="#glo:opt.gloskey.user3"><span class="csoptfmt">user3</span></a> <a id="wrglossary.17561"></a><a href="#glo:dual.field">field</a>. Does nothing if the entry hasn’t been defined. May be used in expandable contexts provided that the <a id="wrglossary.17562"></a><a href="#glo:opt.gloskey.user3"><span class="csoptfmt">user3</span></a> <a id="wrglossary.17563"></a><a href="#glo:dual.field">field</a> doesn’t contain any fragile commands.<p>
+<div class="defnbox"><a id="wrglossary.17564"></a><dfn id="glo:Glsentryuseriv"><code class="csfmt">\Glsentryuseriv</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17565"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Partially robust command that displays the value of the <a id="wrglossary.17566"></a><a href="#glo:opt.gloskey.user4"><span class="csoptfmt">user4</span></a> <a id="wrglossary.17567"></a><a href="#glo:dual.field">field</a> with <a id="wrglossary.17568"></a><a href="#glo:idx.sentencecase">sentence case</a> applied. As from <a id="wrglossary.17569"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50, this command can expand in PDF bookmarks. Outside of PDF bookmarks it will expand to a robust internal command.<p>
+<div class="defnbox"><a id="wrglossary.17570"></a><dfn id="glo:glsentryuseriv"><code class="csfmt">\glsentryuseriv</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17571"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Simply expands to the value of the <a id="wrglossary.17572"></a><a href="#glo:opt.gloskey.user4"><span class="csoptfmt">user4</span></a> <a id="wrglossary.17573"></a><a href="#glo:dual.field">field</a>. Does nothing if the entry hasn’t been defined. May be used in expandable contexts provided that the <a id="wrglossary.17574"></a><a href="#glo:opt.gloskey.user4"><span class="csoptfmt">user4</span></a> <a id="wrglossary.17575"></a><a href="#glo:dual.field">field</a> doesn’t contain any fragile commands.<p>
+<div class="defnbox"><a id="wrglossary.17576"></a><dfn id="glo:Glsentryuserv"><code class="csfmt">\Glsentryuserv</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17577"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Partially robust command that displays the value of the <a id="wrglossary.17578"></a><a href="#glo:opt.gloskey.user5"><span class="csoptfmt">user5</span></a> <a id="wrglossary.17579"></a><a href="#glo:dual.field">field</a> with <a id="wrglossary.17580"></a><a href="#glo:idx.sentencecase">sentence case</a> applied. As from <a id="wrglossary.17581"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50, this command can expand in PDF bookmarks. Outside of PDF bookmarks it will expand to a robust internal command.<p>
+<div class="defnbox"><a id="wrglossary.17582"></a><dfn id="glo:glsentryuserv"><code class="csfmt">\glsentryuserv</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17583"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Simply expands to the value of the <a id="wrglossary.17584"></a><a href="#glo:opt.gloskey.user5"><span class="csoptfmt">user5</span></a> <a id="wrglossary.17585"></a><a href="#glo:dual.field">field</a>. Does nothing if the entry hasn’t been defined. May be used in expandable contexts provided that the <a id="wrglossary.17586"></a><a href="#glo:opt.gloskey.user5"><span class="csoptfmt">user5</span></a> <a id="wrglossary.17587"></a><a href="#glo:dual.field">field</a> doesn’t contain any fragile commands.<p>
+<div class="defnbox"><a id="wrglossary.17588"></a><dfn id="glo:Glsentryuservi"><code class="csfmt">\Glsentryuservi</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17589"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Partially robust command that displays the value of the <a id="wrglossary.17590"></a><a href="#glo:opt.gloskey.user6"><span class="csoptfmt">user6</span></a> <a id="wrglossary.17591"></a><a href="#glo:dual.field">field</a> with <a id="wrglossary.17592"></a><a href="#glo:idx.sentencecase">sentence case</a> applied. As from <a id="wrglossary.17593"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50, this command can expand in PDF bookmarks. Outside of PDF bookmarks it will expand to a robust internal command.<p>
+<div class="defnbox"><a id="wrglossary.17594"></a><dfn id="glo:glsentryuservi"><code class="csfmt">\glsentryuservi</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17595"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Simply expands to the value of the <a id="wrglossary.17596"></a><a href="#glo:opt.gloskey.user6"><span class="csoptfmt">user6</span></a> <a id="wrglossary.17597"></a><a href="#glo:dual.field">field</a>. Does nothing if the entry hasn’t been defined. May be used in expandable contexts provided that the <a id="wrglossary.17598"></a><a href="#glo:opt.gloskey.user6"><span class="csoptfmt">user6</span></a> <a id="wrglossary.17599"></a><a href="#glo:dual.field">field</a> doesn’t contain any fragile commands.<p>
+<div class="defnbox"><a id="wrglossary.17600"></a><a href="#glo:glsexclapplyinnerfmtfield"><code class="csfmt">\glsexclapplyinnerfmtfield</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">internal-field</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17601"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally adds the field given by its <a id="wrglossary.17602"></a><a href="#glo:dual.internalfieldlabel">internal field label</a> <span class="meta">〈<em class="metainner">internal-field</em>〉</span> to the <a id="wrglossary.17603"></a><a href="#glo:dual.innerformatting">inner formatting</a> exclusion list for the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. This typically means that the field value already contains the <a id="wrglossary.17604"></a><a href="#glo:dual.innerformatting">inner formatting</a>. <a href="#sec:innertextformat">§5.5.3</a>; <a href="#wrglossary.6255">245</a><p>
+<div class="defnbox"><a id="wrglossary.17605"></a><dfn id="glo:glsexpandfields"><code class="csfmt">\glsexpandfields</code></dfn><span class="floatrightbox"><a id="wrglossary.17606"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.08a+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expand field values when defining entries, except for those that explicitly have expansion disabled with <a id="wrglossary.17607"></a><a href="#glo:glssetnoexpandfield"><code class="csfmt">\glssetnoexpandfield</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.17608"></a><a href="#glo:glsextrapostnamehook"><code class="csfmt">\glsextrapostnamehook</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17609"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.25+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A general purpose hook that’s performed within <a id="wrglossary.17610"></a><a href="#glo:glsxtrpostnamehook"><code class="csfmt">\glsxtrpostnamehook</code></a>. <a href="#sec:postnamehooks">§8.6.1</a>; <a href="#wrglossary.10710">421</a><p>
+<div class="defnbox"><a id="wrglossary.17611"></a><dfn id="glo:glsfieldaccsupp"><code class="csfmt">\glsfieldaccsupp</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">replacement</em>〉</span>}{<span class="meta">〈<em class="metainner">content</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17612"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> v4.45+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If <a id="wrglossary.17613"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> has been loaded, this command will first check for the existence of the command <a id="wrglossary.17614"></a><a href="#glo:glsxtrcategoryfieldaccsupp"><code class="csfmt">\glsxtr<span class="meta">〈<em class="metainner">category</em>〉</span><span class="meta">〈<em class="metainner">field</em>〉</span>accsupp</code></a>. If that command doesn’t exist or if <a id="wrglossary.17615"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> hasn’t been loaded, it then checks for the existence of <code class="csfmt">\gls<span class="meta">〈<em class="metainner">field</em>〉</span>accsupp</code> (for example, <a id="wrglossary.17616"></a><a href="#glo:glsshortaccsupp"><code class="csfmt">\glsshortaccsupp</code></a>). Failing that it will use <a id="wrglossary.17617"></a><a href="#glo:glsaccsupp"><code class="csfmt">\glsaccsupp</code></a>. Whichever command is found first, <code class="code"><span class="meta">〈<em class="metainner">cs</em>〉</span>{<span class="meta">〈<em class="metainner">replacement</em>〉</span>}{<span class="meta">〈<em class="metainner">content</em>〉</span>}</code> is performed.<p>
+<div class="defnbox"><a id="wrglossary.17618"></a><dfn id="glo:glsfielddef"><code class="csfmt">\glsfielddef</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17619"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.16+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally assigns the <span class="meta">〈<em class="metainner">value</em>〉</span> to the given <a id="wrglossary.17620"></a><a href="#glo:dual.field">field</a> (identified by the <a id="wrglossary.17621"></a><a href="#glo:dual.internalfieldlabel">internal field label</a> <span class="meta">〈<em class="metainner">field</em>〉</span>) for the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. Produces an error (or warning with <a id="wrglossary.17622"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=</span><a id="wrglossary.17623"></a><a href="#glo:optval.undefaction.warn"><span class="optfmt">warn</span></a>) if the entry or field doesn’t exist. Note that this doesn’t update any associated fields.<p>
+<div class="defnbox"><a id="wrglossary.17624"></a><dfn id="glo:glsfieldedef"><code class="csfmt">\glsfieldedef</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17625"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.16+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally assigns the full expansion of <span class="meta">〈<em class="metainner">value</em>〉</span> to the given <a id="wrglossary.17626"></a><a href="#glo:dual.field">field</a> (identified by the <a id="wrglossary.17627"></a><a href="#glo:dual.internalfieldlabel">internal field label</a> <span class="meta">〈<em class="metainner">field</em>〉</span>) for the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. Produces an error (or warning with <a id="wrglossary.17628"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=</span><a id="wrglossary.17629"></a><a href="#glo:optval.undefaction.warn"><span class="optfmt">warn</span></a>) if the entry or field doesn’t exist. Note that this doesn’t update any associated fields.<p>
+<div class="defnbox"><a id="wrglossary.17630"></a><dfn id="glo:glsfieldfetch"><code class="csfmt">\glsfieldfetch</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17631"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.16+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Fetches the value of the given field for the given entry and stores it in the command <span class="meta">〈<em class="metainner">cs</em>〉</span>. Triggers an error if the given field (identified by its <a id="wrglossary.17632"></a><a href="#glo:dual.internalfieldlabel">internal field label</a>) hasn’t been defined. Uses <a id="wrglossary.17633"></a><a href="#glo:glsdoifexists"><code class="csfmt">\glsdoifexists</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.17634"></a><dfn id="glo:glsfieldgdef"><code class="csfmt">\glsfieldgdef</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17635"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.16+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.17636"></a><a href="#glo:glsfielddef"><code class="csfmt">\glsfielddef</code></a> but does a global assignment.<p>
+<div class="defnbox"><a id="wrglossary.17637"></a><dfn id="glo:glsfieldxdef"><code class="csfmt">\glsfieldxdef</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17638"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.16+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.17639"></a><a href="#glo:glsfieldedef"><code class="csfmt">\glsfieldedef</code></a> but does a global assignment.<p>
+<div class="defnbox"><a id="wrglossary.17640"></a><a href="#glo:glsFindWidestAnyName"><code class="csfmt">\glsFindWidestAnyName</code></a><code class="code">[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.17641"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Finds and sets the widest name for all entries in the given <a id="wrglossary.17642"></a><a href="#glo:dual.glossary">glossaries</a>. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11032">435</a><p>
+<div class="defnbox"><a id="wrglossary.17643"></a><a href="#glo:glsFindWidestAnyNameLocation"><code class="csfmt">\glsFindWidestAnyNameLocation</code></a><code class="code">[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]{<span class="meta">〈<em class="metainner">register</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17644"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.17645"></a><a href="#glo:glsFindWidestAnyName"><code class="csfmt">\glsFindWidestAnyName</code></a> but also also measures the <a id="wrglossary.17646"></a><a href="#glo:dual.locationlist">location list</a>. The length of the widest location is stored in <span class="meta">〈<em class="metainner">register</em>〉</span>, which should be a length register. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11048">436</a><p>
+<div class="defnbox"><a id="wrglossary.17647"></a><a href="#glo:glsFindWidestAnyNameSymbol"><code class="csfmt">\glsFindWidestAnyNameSymbol</code></a><code class="code">[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]{<span class="meta">〈<em class="metainner">register</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17648"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.17649"></a><a href="#glo:glsFindWidestAnyName"><code class="csfmt">\glsFindWidestAnyName</code></a> but also also measures the symbol. The length of the widest symbol is stored in <span class="meta">〈<em class="metainner">register</em>〉</span> which should be a length register. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11038">436</a><p>
+<div class="defnbox"><a id="wrglossary.17650"></a><a href="#glo:glsFindWidestAnyNameSymbolLocation"><code class="csfmt">\glsFindWidestAnyNameSymbolLocation</code></a><code class="code">[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]{<span class="meta">〈<em class="metainner">register1</em>〉</span>}{<span class="meta">〈<em class="metainner">register2</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17651"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.17652"></a><a href="#glo:glsFindWidestAnyNameSymbol"><code class="csfmt">\glsFindWidestAnyNameSymbol</code></a> but also also measures the <a id="wrglossary.17653"></a><a href="#glo:dual.locationlist">location list</a>. The length of the widest symbol is stored in <span class="meta">〈<em class="metainner">register1</em>〉</span> and the length of the widest location is stored in <span class="meta">〈<em class="metainner">register2</em>〉</span>, which should both be length registers. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11044">436</a><p>
+<div class="defnbox"><a id="wrglossary.17654"></a><a href="#glo:glsFindWidestLevelTwo"><code class="csfmt">\glsFindWidestLevelTwo</code></a><code class="code">[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.17655"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Finds and sets the widest name for all entries with <a id="wrglossary.17656"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> less than or equal to 2 in the given <a id="wrglossary.17657"></a><a href="#glo:dual.glossary">glossaries</a>. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11035">436</a><p>
+<div class="defnbox"><a id="wrglossary.17658"></a><a href="#glo:glsFindWidestTopLevelName"><code class="csfmt">\glsFindWidestTopLevelName</code></a><span class="floatrightbox"><a id="wrglossary.17659"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.17660"></a><a href="#glo:glsfindwidesttoplevelname"><code class="csfmt">\glsfindwidesttoplevelname</code></a>. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11024">435</a><p>
+<div class="defnbox"><a id="wrglossary.17661"></a><dfn id="glo:glsfindwidesttoplevelname"><code class="csfmt">\glsfindwidesttoplevelname</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.17662"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a> v4.22+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Finds and sets the widest name for all top-level entries in the given <a id="wrglossary.17663"></a><a href="#glo:dual.glossary">glossaries</a>. If the optional argument is omitted, the list of all non-<a id="wrglossary.17664"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a> is assumed.<p>
+<div class="defnbox"><a id="wrglossary.17665"></a><a href="#glo:glsFindWidestUsedAnyName"><code class="csfmt">\glsFindWidestUsedAnyName</code></a><code class="code">[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.17666"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Finds and sets the widest name for all entries that have been marked as <a id="wrglossary.17667"></a><a href="#glo:@@glslabel@firstuseflag">used</a> in the given <a id="wrglossary.17668"></a><a href="#glo:dual.glossary">glossaries</a>. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11029">435</a><p>
+<div class="defnbox"><a id="wrglossary.17669"></a><a href="#glo:glsFindWidestUsedAnyNameLocation"><code class="csfmt">\glsFindWidestUsedAnyNameLocation</code></a><code class="code">[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]{<span class="meta">〈<em class="metainner">register</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17670"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.17671"></a><a href="#glo:glsFindWidestUsedAnyName"><code class="csfmt">\glsFindWidestUsedAnyName</code></a> but also also measures the <a id="wrglossary.17672"></a><a href="#glo:dual.locationlist">location list</a>. The length of the widest location is stored in <span class="meta">〈<em class="metainner">register</em>〉</span>, which should be a length register. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11045">436</a><p>
+<div class="defnbox"><a id="wrglossary.17673"></a><a href="#glo:glsFindWidestUsedAnyNameSymbol"><code class="csfmt">\glsFindWidestUsedAnyNameSymbol</code></a><code class="code">[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]{<span class="meta">〈<em class="metainner">register</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17674"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.17675"></a><a href="#glo:glsFindWidestUsedAnyName"><code class="csfmt">\glsFindWidestUsedAnyName</code></a> but also also measures the symbol. The length of the widest symbol is stored in <span class="meta">〈<em class="metainner">register</em>〉</span> which should be a length register. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11036">436</a><p>
+<div class="defnbox"><a id="wrglossary.17676"></a><a href="#glo:glsFindWidestUsedAnyNameSymbolLocation"><code class="csfmt">\glsFindWidestUsedAnyNameSymbolLocation</code></a><code class="code">[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]{<span class="meta">〈<em class="metainner">register1</em>〉</span>}{<span class="meta">〈<em class="metainner">register2</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17677"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.17678"></a><a href="#glo:glsFindWidestUsedAnyNameSymbol"><code class="csfmt">\glsFindWidestUsedAnyNameSymbol</code></a> but also also measures the <a id="wrglossary.17679"></a><a href="#glo:dual.locationlist">location list</a>. The length of the widest symbol is stored in <span class="meta">〈<em class="metainner">register1</em>〉</span> and the length of the widest location is stored in <span class="meta">〈<em class="metainner">register2</em>〉</span>, which should both be length registers. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11039">436</a><p>
+<div class="defnbox"><a id="wrglossary.17680"></a><a href="#glo:glsFindWidestUsedLevelTwo"><code class="csfmt">\glsFindWidestUsedLevelTwo</code></a><code class="code">[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.17681"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Finds and sets the widest name for all entries that have been marked as <a id="wrglossary.17682"></a><a href="#glo:@@glslabel@firstuseflag">used</a> with <a id="wrglossary.17683"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> less than or equal to 2 in the given <a id="wrglossary.17684"></a><a href="#glo:dual.glossary">glossaries</a>. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11033">435</a><p>
+<div class="defnbox"><a id="wrglossary.17685"></a><a href="#glo:glsFindWidestUsedTopLevelName"><code class="csfmt">\glsFindWidestUsedTopLevelName</code></a><code class="code">[<span class="meta">〈<em class="metainner">glossary labels</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.17686"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Finds and sets the widest name for all top-level entries that have been marked as <a id="wrglossary.17687"></a><a href="#glo:@@glslabel@firstuseflag">used</a> in the given <a id="wrglossary.17688"></a><a href="#glo:dual.glossary">glossaries</a>. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11026">435</a><p>
+<div class="defnbox"><a id="wrglossary.17689"></a><dfn id="glo:GLSfirst"><code class="csfmt">\GLSfirst</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.17690"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.17691"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.17692"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.17693"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.17694"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a> but converts the <a id="wrglossary.17695"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.17696"></a><a href="#glo:idx.allcaps">all caps</a>. If you have defined the entry with <a id="wrglossary.17697"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> use <a id="wrglossary.17698"></a><a href="#glo:GLSxtrfull"><code class="csfmt">\GLSxtrfull</code></a> or <code class="code"><a id="wrglossary.17699"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a>[<a id="wrglossary.17700"></a><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a>]</code> instead.<p>
+<div class="defnbox"><a id="wrglossary.17701"></a><dfn id="glo:Glsfirst"><code class="csfmt">\Glsfirst</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.17702"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.17703"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.17704"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.17705"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.17706"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a> but converts the first character of the <a id="wrglossary.17707"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.17708"></a><a href="#glo:idx.uppercase">uppercase</a><a id="wrglossary.17709"></a> (for the start of a sentence) using <a id="wrglossary.17710"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. If you have defined the entry with <a id="wrglossary.17711"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> use <a id="wrglossary.17712"></a><a href="#glo:Glsxtrfull"><code class="csfmt">\Glsxtrfull</code></a> or <code class="code"><a id="wrglossary.17713"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>[<a id="wrglossary.17714"></a><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a>]</code> instead.<p>
+<div class="defnbox"><a id="wrglossary.17715"></a><dfn id="glo:glsfirst"><code class="csfmt">\glsfirst</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.17716"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.17717"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.17718"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.17719"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The text produced is obtained from the <a id="wrglossary.17720"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> value. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument will be inserted at the end of the <a id="wrglossary.17721"></a><a href="#glo:dual.linktext">link text</a>. This command does not alter or depend on the <a id="wrglossary.17722"></a><a href="#glo:dual.firstuseflag">first use flag</a>. If you have defined the entry with <a id="wrglossary.17723"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> use <a id="wrglossary.17724"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> for the full form or <a id="wrglossary.17725"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> for the long form or use <code class="code"><a id="wrglossary.17726"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.17727"></a><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a>]</code>, as some abbreviation styles are too complicated to work with <a id="wrglossary.17728"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a>. For the first optional argument, see <a id="wrglossary.17729"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>.<p>
+<div class="defnbox"><a id="wrglossary.17730"></a><a href="#glo:glsfirstabbrvdefaultfont"><code class="csfmt">\glsfirstabbrvdefaultfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Formatting command for the short form on <a id="wrglossary.17731"></a><a href="#glo:dual.firstuse">first use</a> used by the abbreviation styles that don’t apply a font change by default. <a href="#wrglossary.3277">132</a><p>
+<div class="defnbox"><a id="wrglossary.17732"></a><a href="#glo:glsfirstabbrvemfont"><code class="csfmt">\glsfirstabbrvemfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17733"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Short form font used by the <span class="qt">“em”</span> abbreviation styles on <a id="wrglossary.17734"></a><a href="#glo:dual.firstuse">first use</a>. <a href="#wrglossary.3933">158</a><p>
+<div class="defnbox"><a id="wrglossary.17735"></a><a href="#glo:glsfirstabbrvfont"><code class="csfmt">\glsfirstabbrvfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Font formatting command for the short form on <a id="wrglossary.17736"></a><a href="#glo:dual.firstuse">first use</a>, initialised by the abbreviation style. <a href="#wrglossary.4317">171</a><p>
+<div class="defnbox"><a id="wrglossary.17737"></a><a href="#glo:glsfirstabbrvhyphenfont"><code class="csfmt">\glsfirstabbrvhyphenfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17738"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Short form font used by the <span class="qt">“hyphen”</span> abbreviation styles on <a id="wrglossary.17739"></a><a href="#glo:dual.firstuse">first use</a>. <a href="#wrglossary.3660">148</a><p>
+<div class="defnbox"><a id="wrglossary.17740"></a><a href="#glo:glsfirstabbrvonlyfont"><code class="csfmt">\glsfirstabbrvonlyfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17741"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Short form font used by the <span class="qt">“only”</span> abbreviation styles on <a id="wrglossary.17742"></a><a href="#glo:dual.firstuse">first use</a>. <a href="#wrglossary.3846">154</a><p>
+<div class="defnbox"><a id="wrglossary.17743"></a><a href="#glo:glsfirstabbrvscfont"><code class="csfmt">\glsfirstabbrvscfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17744"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Short form font used by the <a id="wrglossary.17745"></a><a href="#glo:idx.smallcaps">small caps</a> <span class="qt">“sc”</span> abbreviation styles on <a id="wrglossary.17746"></a><a href="#glo:dual.firstuse">first use</a>. <a href="#wrglossary.3904">157</a><p>
+<div class="defnbox"><a id="wrglossary.17747"></a><a href="#glo:glsfirstabbrvsconlyfont"><code class="csfmt">\glsfirstabbrvsconlyfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17748"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Short form font used by the <span class="qt">“sc-only”</span> abbreviation styles on <a id="wrglossary.17749"></a><a href="#glo:dual.firstuse">first use</a>. <a href="#wrglossary.3858">155</a><p>
+<div class="defnbox"><a id="wrglossary.17750"></a><a href="#glo:glsfirstabbrvscuserfont"><code class="csfmt">\glsfirstabbrvscuserfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17751"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Short form font used by the <a id="wrglossary.17752"></a><a href="#glo:idx.smallcaps">small caps</a> <span class="qt">“sc-user”</span> abbreviation styles on <a id="wrglossary.17753"></a><a href="#glo:dual.firstuse">first use</a>. <a href="#wrglossary.3374">136</a><p>
+<div class="defnbox"><a id="wrglossary.17754"></a><a href="#glo:glsfirstabbrvsmfont"><code class="csfmt">\glsfirstabbrvsmfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17755"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Short form font used by the <span class="qt">“sm”</span> abbreviation styles on <a id="wrglossary.17756"></a><a href="#glo:dual.firstuse">first use</a>. <a href="#wrglossary.3921">157</a><p>
+<div class="defnbox"><a id="wrglossary.17757"></a><a href="#glo:glsfirstabbrvuserfont"><code class="csfmt">\glsfirstabbrvuserfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17758"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Short form font used by the <span class="qt">“user”</span> abbreviation styles on <a id="wrglossary.17759"></a><a href="#glo:dual.firstuse">first use</a>. <a href="#wrglossary.3356">136</a><p>
+<div class="defnbox"><a id="wrglossary.17760"></a><dfn id="glo:glsfirstaccessdisplay"><code class="csfmt">\glsfirstaccessdisplay</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17761"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">text</em>〉</span> with the <a id="wrglossary.17762"></a><a href="#glo:opt.gloskey.firstaccess"><span class="csoptfmt">firstaccess</span></a> replacement text (if set).<p>
+<div class="defnbox"><a id="wrglossary.17763"></a><a href="#glo:glsfirstinnerfmtabbrvfont"><code class="csfmt">\glsfirstinnerfmtabbrvfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17764"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Applies both <a id="wrglossary.17765"></a><a href="#glo:glsfirstabbrvfont"><code class="csfmt">\glsfirstabbrvfont</code></a> and <a id="wrglossary.17766"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a> to <span class="meta">〈<em class="metainner">text</em>〉</span>. <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4150">166</a><p>
+<div class="defnbox"><a id="wrglossary.17767"></a><a href="#glo:glsfirstinnerfmtlongfont"><code class="csfmt">\glsfirstinnerfmtlongfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17768"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Applies both <a id="wrglossary.17769"></a><a href="#glo:glsfirstlongfont"><code class="csfmt">\glsfirstlongfont</code></a> and <a id="wrglossary.17770"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a> to <span class="meta">〈<em class="metainner">text</em>〉</span>. <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4198">168</a><p>
+<div class="defnbox"><a id="wrglossary.17771"></a><a href="#glo:glsfirstlongdefaultfont"><code class="csfmt">\glsfirstlongdefaultfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Formatting command for the long form on <a id="wrglossary.17772"></a><a href="#glo:dual.firstuse">first use</a> used by the abbreviation styles that don’t apply a font change by default. <a href="#wrglossary.3285">133</a><p>
+<div class="defnbox"><a id="wrglossary.17773"></a><a href="#glo:glsfirstlongemfont"><code class="csfmt">\glsfirstlongemfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17774"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Long form font used by the <span class="qt">“em”</span> abbreviation styles on <a id="wrglossary.17775"></a><a href="#glo:dual.firstuse">first use</a>. <a href="#wrglossary.3945">158</a><p>
+<div class="defnbox"><a id="wrglossary.17776"></a><a href="#glo:glsfirstlongfont"><code class="csfmt">\glsfirstlongfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Font formatting command for the long form on <a id="wrglossary.17777"></a><a href="#glo:dual.firstuse">first use</a>, initialised by the abbreviation style. <a href="#wrglossary.4328">172</a><p>
+<div class="defnbox"><a id="wrglossary.17778"></a><a href="#glo:glsfirstlongfootnotefont"><code class="csfmt">\glsfirstlongfootnotefont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17779"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formatting command for the <a id="wrglossary.17780"></a><a href="#glo:dual.firstuse">first use</a> long form used by the footnote abbreviation styles. <a href="#wrglossary.3599">145</a><p>
+<div class="defnbox"><a id="wrglossary.17781"></a><a href="#glo:glsfirstlonghyphenfont"><code class="csfmt">\glsfirstlonghyphenfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17782"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Long form font used by the <span class="qt">“hyphen”</span> abbreviation styles on <a id="wrglossary.17783"></a><a href="#glo:dual.firstuse">first use</a>. <a href="#wrglossary.3665">148</a><p>
+<div class="defnbox"><a id="wrglossary.17784"></a><a href="#glo:glsfirstlongonlyfont"><code class="csfmt">\glsfirstlongonlyfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17785"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Long form font used by the <span class="qt">“only”</span> abbreviation styles on <a id="wrglossary.17786"></a><a href="#glo:dual.firstuse">first use</a>. <a href="#wrglossary.3851">154</a><p>
+<div class="defnbox"><a id="wrglossary.17787"></a><a href="#glo:glsfirstlonguserfont"><code class="csfmt">\glsfirstlonguserfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17788"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Long form font used by the <span class="qt">“user”</span> abbreviation styles on <a id="wrglossary.17789"></a><a href="#glo:dual.firstuse">first use</a>. <a href="#wrglossary.3363">136</a><p>
+<div class="defnbox"><a id="wrglossary.17790"></a><dfn id="glo:GLSfirstplural"><code class="csfmt">\GLSfirstplural</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.17791"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.17792"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.17793"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.17794"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.17795"></a><a href="#glo:glsfirstplural"><code class="csfmt">\glsfirstplural</code></a> but converts the <a id="wrglossary.17796"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.17797"></a><a href="#glo:idx.allcaps">all caps</a>. If you have defined the entry with <a id="wrglossary.17798"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> use <a id="wrglossary.17799"></a><a href="#glo:GLSxtrfullpl"><code class="csfmt">\GLSxtrfullpl</code></a> or <code class="code"><a id="wrglossary.17800"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a>[<a id="wrglossary.17801"></a><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a>]</code> instead.<p>
+<div class="defnbox"><a id="wrglossary.17802"></a><dfn id="glo:Glsfirstplural"><code class="csfmt">\Glsfirstplural</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.17803"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.17804"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.17805"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.17806"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.17807"></a><a href="#glo:glsfirstplural"><code class="csfmt">\glsfirstplural</code></a> but converts the first character of the <a id="wrglossary.17808"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.17809"></a><a href="#glo:idx.uppercase">uppercase</a><a id="wrglossary.17810"></a> (for the start of a sentence) using <a id="wrglossary.17811"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. If you have defined the entry with <a id="wrglossary.17812"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> use <a id="wrglossary.17813"></a><a href="#glo:Glsxtrfullpl"><code class="csfmt">\Glsxtrfullpl</code></a> or <code class="code"><a id="wrglossary.17814"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a>[<a id="wrglossary.17815"></a><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a>]</code> instead.<p>
+<div class="defnbox"><a id="wrglossary.17816"></a><dfn id="glo:glsfirstplural"><code class="csfmt">\glsfirstplural</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.17817"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.17818"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.17819"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.17820"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The text produced is obtained from the <a id="wrglossary.17821"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> value. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument will be inserted at the end of the <a id="wrglossary.17822"></a><a href="#glo:dual.linktext">link text</a>. This command does not alter or depend on the <a id="wrglossary.17823"></a><a href="#glo:dual.firstuseflag">first use flag</a>. If you have defined the entry with <a id="wrglossary.17824"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> use <a id="wrglossary.17825"></a><a href="#glo:glsxtrfullpl"><code class="csfmt">\glsxtrfullpl</code></a> for the full form or <a id="wrglossary.17826"></a><a href="#glo:glsxtrlongpl"><code class="csfmt">\glsxtrlongpl</code></a> for the long form or use <code class="code"><a id="wrglossary.17827"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>[<a id="wrglossary.17828"></a><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a>]</code>, as some abbreviation styles are too complicated to work with <a id="wrglossary.17829"></a><a href="#glo:glsfirstplural"><code class="csfmt">\glsfirstplural</code></a>. For the first optional argument, see <a id="wrglossary.17830"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>.<p>
+<div class="defnbox"><a id="wrglossary.17831"></a><dfn id="glo:glsfirstpluralaccessdisplay"><code class="csfmt">\glsfirstpluralaccessdisplay</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17832"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">text</em>〉</span> with the <a id="wrglossary.17833"></a><a href="#glo:opt.gloskey.firstpluralaccess"><span class="csoptfmt">firstpluralaccess</span></a> replacement text (if set).<p>
+<div class="defnbox"><a id="wrglossary.17834"></a><a href="#glo:glsfirstxpabbrvfont"><code class="csfmt">\glsfirstxpabbrvfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">category</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17835"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If the <a id="wrglossary.17836"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a> attribute is set for the given category, this encapsulates <span class="meta">〈<em class="metainner">text</em>〉</span> with <a id="wrglossary.17837"></a><a href="#glo:glsfirstabbrvfont"><code class="csfmt">\glsfirstabbrvfont</code></a> otherwise with <a id="wrglossary.17838"></a><a href="#glo:glsfirstinnerfmtabbrvfont"><code class="csfmt">\glsfirstinnerfmtabbrvfont</code></a>. This command has to expand, so protect any content that shouldn’t expand. <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4153">167</a><p>
+<div class="defnbox"><a id="wrglossary.17839"></a><a href="#glo:glsfirstxplongfont"><code class="csfmt">\glsfirstxplongfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17840"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If the <a id="wrglossary.17841"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a> attribute is set for the given category, this encapsulates <span class="meta">〈<em class="metainner">text</em>〉</span> with <a id="wrglossary.17842"></a><a href="#glo:glsfirstlongfont"><code class="csfmt">\glsfirstlongfont</code></a> otherwise with <a id="wrglossary.17843"></a><a href="#glo:glsinnerfmtlongfont"><code class="csfmt">\glsinnerfmtlongfont</code></a>. This command has to expand, so protect any content that shouldn’t expand. <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4201">168</a><p>
+<div class="defnbox"><a id="wrglossary.17844"></a><a href="#glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">internal-field</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17845"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.17846"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a> but changes the field value to <a id="wrglossary.17847"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#sec:innertextformat">§5.5.3</a>; <a href="#wrglossary.6261">245</a><p>
+<div class="defnbox"><a id="wrglossary.17848"></a><a href="#glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">internal-field</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17849"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.17850"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a> but uses <a id="wrglossary.17851"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> to change the field value to <a id="wrglossary.17852"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#sec:innertextformat">§5.5.3</a>; <a href="#wrglossary.6259">245</a><p>
+<div class="defnbox"><a id="wrglossary.17853"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a><code class="code">{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">internal-field</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17854"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Applies the formatting command <span class="meta">〈<em class="metainner">cs</em>〉</span> (which takes one argument) to the entry’s field value identified by the given <a id="wrglossary.17855"></a><a href="#glo:dual.internalfieldlabel">internal field label</a>, including <span class="meta">〈<em class="metainner">insert</em>〉</span> appended. Used by the <a id="wrglossary.17856"></a><a href="#glo:dual.innerformatting">inner formatting</a> commands. Note that <a id="wrglossary.17857"></a><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a> should not be robust as it needs to expand if it’s inside a case-changing command. <a href="#sec:innertextformat">§5.5.3</a>; <a href="#wrglossary.6257">245</a><p>
+<div class="defnbox"><a id="wrglossary.17858"></a><a href="#glo:GLSfmtfirst"><code class="csfmt">\GLSfmtfirst</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17859"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17860"></a><a href="#glo:idx.allcaps">all caps</a> <a id="wrglossary.17861"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5466">213</a><p>
+<div class="defnbox"><a id="wrglossary.17862"></a><a href="#glo:Glsfmtfirst"><code class="csfmt">\Glsfmtfirst</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17863"></a><a href="#glo:idx.sentencecase">sentence case</a> <a id="wrglossary.17864"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5462">213</a><p>
+<div class="defnbox"><a id="wrglossary.17865"></a><a href="#glo:glsfmtfirst"><code class="csfmt">\glsfmtfirst</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17866"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5459">213</a><p>
+<div class="defnbox"><a id="wrglossary.17867"></a><a href="#glo:GLSfmtfirstpl"><code class="csfmt">\GLSfmtfirstpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17868"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17869"></a><a href="#glo:idx.allcaps">all caps</a> <a id="wrglossary.17870"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5476">214</a><p>
+<div class="defnbox"><a id="wrglossary.17871"></a><a href="#glo:Glsfmtfirstpl"><code class="csfmt">\Glsfmtfirstpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17872"></a><a href="#glo:idx.sentencecase">sentence case</a> <a id="wrglossary.17873"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5472">214</a><p>
+<div class="defnbox"><a id="wrglossary.17874"></a><a href="#glo:glsfmtfirstpl"><code class="csfmt">\glsfmtfirstpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17875"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5469">213</a><p>
+<div class="defnbox"><a id="wrglossary.17876"></a><a href="#glo:GLSfmtfull"><code class="csfmt">\GLSfmtfull</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17877"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Designed for use in section headings or captions, this expands to just <code class="code"><a id="wrglossary.17878"></a><a href="#glo:glspdffmtfull"><code class="csfmt">\glspdffmtfull</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code> in PDF bookmarks (no case-change), otherwise it expands to <code class="code"><a id="wrglossary.17879"></a><a href="#glo:GLSxtrtitlefull"><code class="csfmt">\GLSxtrtitlefull</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5416">211</a><p>
+<div class="defnbox"><a id="wrglossary.17880"></a><a href="#glo:Glsfmtfull"><code class="csfmt">\Glsfmtfull</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17881"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Designed for use in section headings or captions, this expands to just <code class="code"><a id="wrglossary.17882"></a><a href="#glo:glspdffmtfull"><code class="csfmt">\glspdffmtfull</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code> in PDF bookmarks (no case-change), otherwise it expands to <code class="code"><a id="wrglossary.17883"></a><a href="#glo:Glsxtrtitlefull"><code class="csfmt">\Glsxtrtitlefull</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5412">211</a><p>
+<div class="defnbox"><a id="wrglossary.17884"></a><a href="#glo:glsfmtfull"><code class="csfmt">\glsfmtfull</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17885"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Designed for use in section headings or captions, this expands to just <code class="code"><a id="wrglossary.17886"></a><a href="#glo:glspdffmtfull"><code class="csfmt">\glspdffmtfull</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code> in PDF bookmarks, otherwise it expands to <code class="code"><a id="wrglossary.17887"></a><a href="#glo:glsxtrtitlefull"><code class="csfmt">\glsxtrtitlefull</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5409">210</a><p>
+<div class="defnbox"><a id="wrglossary.17888"></a><a href="#glo:GLSfmtfullpl"><code class="csfmt">\GLSfmtfullpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17889"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Designed for use in section headings or captions, this expands to just <code class="code"><a id="wrglossary.17890"></a><a href="#glo:glspdffmtfullpl"><code class="csfmt">\glspdffmtfullpl</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code> in PDF bookmarks (no case-change), otherwise it expands to <code class="code"><a id="wrglossary.17891"></a><a href="#glo:GLSxtrtitlefullpl"><code class="csfmt">\GLSxtrtitlefullpl</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5426">211</a><p>
+<div class="defnbox"><a id="wrglossary.17892"></a><a href="#glo:Glsfmtfullpl"><code class="csfmt">\Glsfmtfullpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17893"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Designed for use in section headings or captions, this expands to just <code class="code"><a id="wrglossary.17894"></a><a href="#glo:glspdffmtfullpl"><code class="csfmt">\glspdffmtfullpl</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code> in PDF bookmarks (no case-change), otherwise it expands to <code class="code"><a id="wrglossary.17895"></a><a href="#glo:Glsxtrtitlefullpl"><code class="csfmt">\Glsxtrtitlefullpl</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5422">211</a><p>
+<div class="defnbox"><a id="wrglossary.17896"></a><a href="#glo:glsfmtfullpl"><code class="csfmt">\glsfmtfullpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17897"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Designed for use in section headings or captions, this expands to just <code class="code"><a id="wrglossary.17898"></a><a href="#glo:glspdffmtfullpl"><code class="csfmt">\glspdffmtfullpl</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code> in PDF bookmarks, otherwise it expands to <code class="code"><a id="wrglossary.17899"></a><a href="#glo:glsxtrtitlefullpl"><code class="csfmt">\glsxtrtitlefullpl</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5419">211</a><p>
+<div class="defnbox"><a id="wrglossary.17900"></a><dfn id="glo:GLSfmtinsert"><code class="csfmt">\GLSfmtinsert</code></dfn><span class="floatrightbox"><a id="wrglossary.17901"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.17902"></a><a href="#glo:glsfmtinsert"><code class="csfmt">\glsfmtinsert</code></a> but converts to <a id="wrglossary.17903"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="defnbox"><a id="wrglossary.17904"></a><dfn id="glo:glsfmtinsert"><code class="csfmt">\glsfmtinsert</code></dfn><span class="floatrightbox"><a id="wrglossary.17905"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A shortcut that applies <a id="wrglossary.17906"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a> to <a id="wrglossary.17907"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a> if <a id="wrglossary.17908"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a> isn’t empty.<p>
+<div class="defnbox"><a id="wrglossary.17909"></a><a href="#glo:GLSfmtlong"><code class="csfmt">\GLSfmtlong</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17910"></a><a href="#glo:idx.allcaps">all caps</a> long form. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5346">209</a><p>
+<div class="defnbox"><a id="wrglossary.17911"></a><a href="#glo:Glsfmtlong"><code class="csfmt">\Glsfmtlong</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17912"></a><a href="#glo:idx.sentencecase">sentence case</a> long form. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5342">208</a><p>
+<div class="defnbox"><a id="wrglossary.17913"></a><a href="#glo:glsfmtlong"><code class="csfmt">\glsfmtlong</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted long form. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5339">208</a><p>
+<div class="defnbox"><a id="wrglossary.17914"></a><a href="#glo:GLSfmtlongpl"><code class="csfmt">\GLSfmtlongpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17915"></a><a href="#glo:idx.allcaps">all caps</a> long plural form. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5376">209</a><p>
+<div class="defnbox"><a id="wrglossary.17916"></a><a href="#glo:Glsfmtlongpl"><code class="csfmt">\Glsfmtlongpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17917"></a><a href="#glo:idx.sentencecase">sentence case</a> long plural form. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5372">209</a><p>
+<div class="defnbox"><a id="wrglossary.17918"></a><a href="#glo:glsfmtlongpl"><code class="csfmt">\glsfmtlongpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted long plural form. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5369">209</a><p>
+<div class="defnbox"><a id="wrglossary.17919"></a><a href="#glo:GLSfmtname"><code class="csfmt">\GLSfmtname</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17920"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17921"></a><a href="#glo:idx.allcaps">all caps</a> <a id="wrglossary.17922"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5436">212</a><p>
+<div class="defnbox"><a id="wrglossary.17923"></a><a href="#glo:Glsfmtname"><code class="csfmt">\Glsfmtname</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17924"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17925"></a><a href="#glo:idx.sentencecase">sentence case</a> <a id="wrglossary.17926"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5432">212</a><p>
+<div class="defnbox"><a id="wrglossary.17927"></a><a href="#glo:glsfmtname"><code class="csfmt">\glsfmtname</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17928"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17929"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5429">211</a><p>
+<div class="defnbox"><a id="wrglossary.17930"></a><a href="#glo:GLSfmtplural"><code class="csfmt">\GLSfmtplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17931"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17932"></a><a href="#glo:idx.allcaps">all caps</a> <a id="wrglossary.17933"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5456">213</a><p>
+<div class="defnbox"><a id="wrglossary.17934"></a><a href="#glo:Glsfmtplural"><code class="csfmt">\Glsfmtplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17935"></a><a href="#glo:idx.sentencecase">sentence case</a> <a id="wrglossary.17936"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5452">213</a><p>
+<div class="defnbox"><a id="wrglossary.17937"></a><a href="#glo:glsfmtplural"><code class="csfmt">\glsfmtplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17938"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5449">212</a><p>
+<div class="defnbox"><a id="wrglossary.17939"></a><a href="#glo:GLSfmtshort"><code class="csfmt">\GLSfmtshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17940"></a><a href="#glo:idx.allcaps">all caps</a> short form. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5284">207</a><p>
+<div class="defnbox"><a id="wrglossary.17941"></a><a href="#glo:Glsfmtshort"><code class="csfmt">\Glsfmtshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17942"></a><a href="#glo:idx.sentencecase">sentence case</a> short form. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5280">207</a><p>
+<div class="defnbox"><a id="wrglossary.17943"></a><a href="#glo:glsfmtshort"><code class="csfmt">\glsfmtshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted short form. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5277">207</a><p>
+<div class="defnbox"><a id="wrglossary.17944"></a><a href="#glo:GLSfmtshortpl"><code class="csfmt">\GLSfmtshortpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17945"></a><a href="#glo:idx.allcaps">all caps</a> short plural form. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5316">208</a><p>
+<div class="defnbox"><a id="wrglossary.17946"></a><a href="#glo:Glsfmtshortpl"><code class="csfmt">\Glsfmtshortpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17947"></a><a href="#glo:idx.sentencecase">sentence case</a> short plural form. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5312">208</a><p>
+<div class="defnbox"><a id="wrglossary.17948"></a><a href="#glo:glsfmtshortpl"><code class="csfmt">\glsfmtshortpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted short plural form. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5309">207</a><p>
+<div class="defnbox"><a id="wrglossary.17949"></a><a href="#glo:GLSfmttext"><code class="csfmt">\GLSfmttext</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17950"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17951"></a><a href="#glo:idx.allcaps">all caps</a> <a id="wrglossary.17952"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5446">212</a><p>
+<div class="defnbox"><a id="wrglossary.17953"></a><a href="#glo:Glsfmttext"><code class="csfmt">\Glsfmttext</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17954"></a><a href="#glo:idx.sentencecase">sentence case</a> <a id="wrglossary.17955"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5442">212</a><p>
+<div class="defnbox"><a id="wrglossary.17956"></a><a href="#glo:glsfmttext"><code class="csfmt">\glsfmttext</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+For use within captions or section titles to display the formatted <a id="wrglossary.17957"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5439">212</a><p>
+<div class="defnbox"><a id="wrglossary.17958"></a><a href="#glo:glsforeachincategory"><code class="csfmt">\glsforeachincategory</code></a><code class="code">[<span class="meta">〈<em class="metainner">glossary-types</em>〉</span>]{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">glossary-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">label-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">body</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Iterates over all entry in the given list of <a id="wrglossary.17959"></a><a href="#glo:dual.glossary">glossaries</a> (or all non-<a id="wrglossary.17960"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a>, if the optional argument is omitted) and performs <span class="meta">〈<em class="metainner">body</em>〉</span> for those entries that have the <a id="wrglossary.17961"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> set to <span class="meta">〈<em class="metainner">category</em>〉</span>. Within <span class="meta">〈<em class="metainner">body</em>〉</span>, the current entry can be referenced with <span class="meta">〈<em class="metainner">label-cs</em>〉</span> and the <a id="wrglossary.17962"></a><a href="#glo:dual.glossary">glossary</a> can be referenced with <span class="meta">〈<em class="metainner">glossary-cs</em>〉</span>. <a href="#sec:categories">§10</a>; <a href="#wrglossary.12056">493</a><p>
+<div class="defnbox"><a id="wrglossary.17963"></a><a href="#glo:glsforeachwithattribute"><code class="csfmt">\glsforeachwithattribute</code></a><code class="code">[<span class="meta">〈<em class="metainner">glossary-types</em>〉</span>]{<span class="meta">〈<em class="metainner">attribute-label</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute-value</em>〉</span>}{<span class="meta">〈<em class="metainner">glossary-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">label-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">body</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Iterates over all entry in the given list of <a id="wrglossary.17964"></a><a href="#glo:dual.glossary">glossaries</a> (or all non-<a id="wrglossary.17965"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a>, if the optional argument is omitted) and performs <span class="meta">〈<em class="metainner">body</em>〉</span> for those entries that have the attribute given by <span class="meta">〈<em class="metainner">attribute-label</em>〉</span> set to <span class="meta">〈<em class="metainner">attribute-value</em>〉</span>. Within <span class="meta">〈<em class="metainner">body</em>〉</span>, the current entry can be referenced with <span class="meta">〈<em class="metainner">label-cs</em>〉</span> and the <a id="wrglossary.17966"></a><a href="#glo:dual.glossary">glossary</a> can be referenced with <span class="meta">〈<em class="metainner">glossary-cs</em>〉</span>. <a href="#sec:categories">§10</a>; <a href="#wrglossary.12058">493</a><p>
+<div class="defnbox"><a id="wrglossary.17967"></a><a href="#glo:glsgenentryfmt"><code class="csfmt">\glsgenentryfmt</code></a><span class="floatrightbox"><a id="wrglossary.17968"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.11a+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The display format used by <a id="wrglossary.17969"></a><a href="#glo:glsentryfmt"><code class="csfmt">\glsentryfmt</code></a> for regular entries. <a href="#sec:entryfmt">§5.5.5</a>; <a href="#wrglossary.6540">255</a><p>
+<div class="defnbox"><a id="wrglossary.17970"></a><a href="#glo:glsgetattribute"><code class="csfmt">\glsgetattribute</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Expands to the value of the given attribute for the category associated with the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. Expands to nothing if the attribute hasn’t been set. <a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12337">505</a><p>
+<div class="defnbox"><a id="wrglossary.17971"></a><a href="#glo:glsgetcategoryattribute"><code class="csfmt">\glsgetcategoryattribute</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Expands to the value of the given attribute for the given category. Expands to nothing if the attribute hasn’t been set. <a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12336">505</a><p>
+<div class="defnbox"><a id="wrglossary.17972"></a><a href="#glo:glsgetwidestname"><code class="csfmt">\glsgetwidestname</code></a><span class="floatrightbox"><a id="wrglossary.17973"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the widest top-level name. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11016">434</a><p>
+<div class="defnbox"><a id="wrglossary.17974"></a><a href="#glo:glsgetwidestsubname"><code class="csfmt">\glsgetwidestsubname</code></a><code class="code">{<span class="meta">〈<em class="metainner">level</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17975"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the widest name for the given <a id="wrglossary.17976"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> or to the widest top-level name, if no widest name set for <span class="meta">〈<em class="metainner">level</em>〉</span>. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11017">435</a><p>
+<div class="defnbox"><a id="wrglossary.17977"></a><dfn id="glo:glsgroupheading"><code class="csfmt">\glsgroupheading</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.17978"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Inserted at the start of each <a id="wrglossary.17979"></a><a href="#glo:idx.group">group</a> in a <a id="wrglossary.17980"></a><a href="#glo:dual.glossary">glossary</a> (unless <a id="wrglossary.17981"></a><a href="#glo:opt.printgloss.groups"><span class="csoptfmt">groups</span></a><span class="optfmt">=false</span>) to display the <a id="wrglossary.17982"></a><a href="#glo:idx.group">group’s</a> heading, if applicable, using the title associated with <span class="meta">〈<em class="metainner">group-label</em>〉</span> or, if no title provided, just <span class="meta">〈<em class="metainner">group-label</em>〉</span>. This command is defined by <a id="wrglossary.17983"></a><a href="#glo:idx.glossarystyle">glossary styles</a> as appropriate.<p>
+<div class="defnbox"><a id="wrglossary.17984"></a><dfn id="glo:glsgroupskip"><code class="csfmt">\glsgroupskip</code></dfn><span class="floatrightbox"><a id="wrglossary.17985"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Inserted before each <a id="wrglossary.17986"></a><a href="#glo:idx.group">group</a> heading (except the first) in a <a id="wrglossary.17987"></a><a href="#glo:dual.glossary">glossary</a> (unless <a id="wrglossary.17988"></a><a href="#glo:opt.printgloss.groups"><span class="csoptfmt">groups</span></a><span class="optfmt">=false</span>). This command is defined by <a id="wrglossary.17989"></a><a href="#glo:idx.glossarystyle">glossary styles</a> as appropriate. Most of the predefined styles define this command to check the <a id="wrglossary.17990"></a><a href="#glo:opt.nogroupskip"><span class="styoptfmt">nogroupskip</span></a> option.<p>
+<div class="defnbox"><a id="wrglossary.17991"></a><a href="#glo:glshasattribute"><code class="csfmt">\glshasattribute</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Tests if the given attribute has been set for the category associated with the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> (using <a id="wrglossary.17992"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <a id="wrglossary.17993"></a><a href="#glo:ifcsvoid"><code class="csfmt">\ifcsvoid</code></a>). Does <span class="meta">〈<em class="metainner">false</em>〉</span> if the entry hasn’t been defined. <a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12342">505</a><p>
+<div class="defnbox"><a id="wrglossary.17994"></a><a href="#glo:glshascategoryattribute"><code class="csfmt">\glshascategoryattribute</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Tests if the given attribute has been set for the given category (using <a id="wrglossary.17995"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <a id="wrglossary.17996"></a><a href="#glo:ifcsvoid"><code class="csfmt">\ifcsvoid</code></a>). <a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12338">505</a><p>
+<div class="defnbox"><a id="wrglossary.17997"></a><a href="#glo:glshashchar"><code class="csfmt">\glshashchar</code></a><span class="floatrightbox"><a id="wrglossary.17998"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to a literal hash <a id="wrglossary.17999"></a><a href="#glo:idx.sym.hash"><code class="code">#</code></a>. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13082">535</a><p>
+<div class="defnbox"><a id="wrglossary.18000"></a><a href="#glo:glshex"><code class="csfmt">\glshex</code></a><code class="code"><span class="meta">〈<em class="metainner">hex</em>〉</span></code><span class="floatrightbox"><a id="wrglossary.18001"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to <code class="code"><a id="wrglossary.18002"></a><a href="#glo:string"><code class="csfmt">\string</code></a><a id="wrglossary.18003"></a><a href="#glo:u"><code class="csfmt">\u</code></a><span class="meta">〈<em class="metainner">hex</em>〉</span></code>. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13078">535</a><p>
+<div class="defnbox"><a id="wrglossary.18004"></a><dfn id="glo:glshyperlink"><code class="csfmt">\glshyperlink</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">text</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18005"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Creates a hyperlink to the given entry with the hyperlink text provided in the optional argument. If omitted, the default is <code class="code"><a id="wrglossary.18006"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>.<p>
+<div class="defnbox"><a id="wrglossary.18007"></a><dfn id="glo:glshypernumber"><code class="csfmt">\glshypernumber</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">location(s)</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18008"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This will encapsulate each location with a hyperlink, if supported. This may be used as a <a id="wrglossary.18009"></a><a href="#glo:dual.locationencap">location encap</a>. The argument may be a single location or locations delimited by <a id="wrglossary.18010"></a><a href="#glo:delimR"><code class="csfmt">\delimR</code></a> or <a id="wrglossary.18011"></a><a href="#glo:delimN"><code class="csfmt">\delimN</code></a>. This command should not be used outside of <a id="wrglossary.18012"></a><a href="#glo:dual.locationlist">location lists</a> as it requires additional information in order to correctly form the hyperlinks.<p>
+<div class="defnbox"><a id="wrglossary.18013"></a><a href="#glo:glsifapplyinnerfmtfield"><code class="csfmt">\glsifapplyinnerfmtfield</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">internal-field</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18014"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Tests if the field given by its <a id="wrglossary.18015"></a><a href="#glo:dual.internalfieldlabel">internal field label</a> <span class="meta">〈<em class="metainner">internal-field</em>〉</span> has been added to the <a id="wrglossary.18016"></a><a href="#glo:dual.innerformatting">inner formatting</a> exclusion list for the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. <a href="#sec:innertextformat">§5.5.3</a>; <a href="#wrglossary.6251">244</a><p>
+<div class="defnbox"><a id="wrglossary.18017"></a><a href="#glo:glsifattribute"><code class="csfmt">\glsifattribute</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Tests if the category associated with the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> has the given attribute set to <span class="meta">〈<em class="metainner">value</em>〉</span>. Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the attribute is <span class="meta">〈<em class="metainner">value</em>〉</span> and <span class="meta">〈<em class="metainner">false</em>〉</span> otherwise. Does <span class="meta">〈<em class="metainner">false</em>〉</span> if there’s no such attribute for the given category or if the entry hasn’t been defined. <a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12350">505</a><p>
+<div class="defnbox"><a id="wrglossary.18018"></a><a href="#glo:glsifattributetrue"><code class="csfmt">\glsifattributetrue</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18019"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Tests if the category associated with the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> has the given attribute set to <code class="code">true</code>. Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the attribute is <code class="code">true</code> and <span class="meta">〈<em class="metainner">false</em>〉</span> otherwise. Does <span class="meta">〈<em class="metainner">false</em>〉</span> if there’s no such attribute for the given category or if the entry hasn’t been defined. <a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12364">506</a><p>
+<div class="defnbox"><a id="wrglossary.18020"></a><a href="#glo:glsifcategory"><code class="csfmt">\glsifcategory</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Tests if the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> has the <a id="wrglossary.18021"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> set to <span class="meta">〈<em class="metainner">category</em>〉</span> (uses <a id="wrglossary.18022"></a><a href="#glo:ifglsfieldeq"><code class="csfmt">\ifglsfieldeq</code></a> for the test). <a href="#sec:categories">§10</a>; <a href="#wrglossary.12046">492</a><p>
+<div class="defnbox"><a id="wrglossary.18023"></a><a href="#glo:glsifcategoryattribute"><code class="csfmt">\glsifcategoryattribute</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Tests if the given category has the given attribute set to <span class="meta">〈<em class="metainner">value</em>〉</span>. Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the attribute is <span class="meta">〈<em class="metainner">value</em>〉</span> and <span class="meta">〈<em class="metainner">false</em>〉</span> otherwise. Does <span class="meta">〈<em class="metainner">false</em>〉</span> if there’s no such attribute for the given category. <a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12344">505</a><p>
+<div class="defnbox"><a id="wrglossary.18024"></a><a href="#glo:glsifcategoryattributehasitem"><code class="csfmt">\glsifcategoryattributehasitem</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}{<span class="meta">〈<em class="metainner">item</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18025"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the category has the attribute (whose value is a comma-separated list) contains the given item and <span class="meta">〈<em class="metainner">false</em>〉</span> otherwise. Does <span class="meta">〈<em class="metainner">false</em>〉</span> if there’s no such attribute for the given category. The item and list are expanded and passed to <a id="wrglossary.18026"></a><a href="#glo:pkg.datatool"><span class="styfmt">datatool</span>’s</a> <a id="wrglossary.18027"></a><a href="#glo:DTLifinlist"><code class="csfmt">\DTLifinlist</code></a> to perform the test. <a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12366">507</a><p>
+<div class="defnbox"><a id="wrglossary.18028"></a><a href="#glo:glsifcategoryattributetrue"><code class="csfmt">\glsifcategoryattributetrue</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18029"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Tests if the given category has the given attribute set to <code class="code">true</code>. Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the attribute is <code class="code">true</code> and <span class="meta">〈<em class="metainner">false</em>〉</span> otherwise. Does <span class="meta">〈<em class="metainner">false</em>〉</span> if there’s no such attribute for the given category. <a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12363">506</a><p>
+<div class="defnbox"><a id="wrglossary.18030"></a><a href="#glo:glsifindexed"><code class="csfmt">\glsifindexed</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18031"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Tests if the value obtained from <a id="wrglossary.18032"></a><a href="#glo:glsentryindexcount"><code class="csfmt">\glsentryindexcount</code></a> is greater than 0. <a href="#sec:wrglossary">§5.8</a>; <a href="#wrglossary.6919">264</a><p>
+<div class="defnbox"><a id="wrglossary.18033"></a><a href="#glo:glsifnotregular"><code class="csfmt">\glsifnotregular</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18034"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the category for the given entry has the <a id="wrglossary.18035"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute explicitly set to <code class="code">false</code>, otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12361">506</a><p>
+<div class="defnbox"><a id="wrglossary.18036"></a><a href="#glo:glsifnotregularcategory"><code class="csfmt">\glsifnotregularcategory</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18037"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the given category has the <a id="wrglossary.18038"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute explicitly set to <code class="code">false</code>, otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12354">506</a><p>
+<div class="defnbox"><a id="wrglossary.18039"></a><dfn id="glo:glsifplural"><code class="csfmt">\glsifplural</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18040"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Initialised by the <a id="wrglossary.18041"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.18042"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands, this expands to <span class="meta">〈<em class="metainner">true</em>〉</span> if the calling command accesses a plural field (such as <a id="wrglossary.18043"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> or <a id="wrglossary.18044"></a><a href="#glo:glsplural"><code class="csfmt">\glsplural</code></a>) otherwise it expands to <span class="meta">〈<em class="metainner">false</em>〉</span>. This command may be used within associated hooks, entry display styles (<a id="wrglossary.18045"></a><a href="#glo:defglsentryfmt"><code class="csfmt">\defglsentryfmt</code></a>), and the <a id="wrglossary.18046"></a><a href="#glo:dual.postlinkhook">post-link hook</a>.<p>
+<div class="defnbox"><a id="wrglossary.18047"></a><a href="#glo:glsifregular"><code class="csfmt">\glsifregular</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the category for the given entry has the <a id="wrglossary.18048"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute explicitly set to <code class="code">true</code>, otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12359">506</a><p>
+<div class="defnbox"><a id="wrglossary.18049"></a><a href="#glo:glsifregularcategory"><code class="csfmt">\glsifregularcategory</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the given category has the <a id="wrglossary.18050"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute explicitly set to <code class="code">true</code>, otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12352">506</a><p>
+<div class="defnbox"><a id="wrglossary.18051"></a><dfn id="glo:glsignore"><code class="csfmt">\glsignore</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18052"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does nothing. When used as a <a id="wrglossary.18053"></a><a href="#glo:dual.locationencap">location encap</a>, this signifies to <a id="wrglossary.18054"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> that the entry is required but the <a id="wrglossary.18055"></a><a href="#glo:@@glslabel@entrylocation">location</a> shouldn’t be added to the <a id="wrglossary.18056"></a><a href="#glo:dual.locationlist">location list</a>. With other <a id="wrglossary.18057"></a><a href="#glo:dual.indexing">indexing</a> methods, this simply creates an invisible <a id="wrglossary.18058"></a><a href="#glo:@@glslabel@entrylocation">location</a>.<p>
+<div class="defnbox"><a id="wrglossary.18059"></a><dfn id="glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></dfn><span class="floatrightbox"><a id="wrglossary.18060"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ &amp; <a id="wrglossary.18061"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indicates what <a id="wrglossary.18062"></a><a href="#glo:dual.indexing">indexing</a> option has been chosen.<p>
+<div class="defnbox"><a id="wrglossary.18063"></a><dfn id="glo:glsindexsubgroupitem"><code class="csfmt">\glsindexsubgroupitem</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">previous group level</em>〉</span>}{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">parent label</em>〉</span>}{<span class="meta">〈<em class="metainner">group label</em>〉</span>}{<span class="meta">〈<em class="metainner">group title</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18064"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to format sub-<a id="wrglossary.18065"></a><a href="#glo:idx.group">group</a> headers for the <a id="wrglossary.18066"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a> styles.<p>
+<div class="defnbox"><a id="wrglossary.18067"></a><a href="#glo:glsinitreunsets"><code class="csfmt">\glsinitreunsets</code></a><span class="floatrightbox"><a id="wrglossary.18068"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook that initialises the <a id="wrglossary.18069"></a><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a>, <a id="wrglossary.18070"></a><a href="#glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></a> and <a id="wrglossary.18071"></a><a href="#glo:opt.glsopt.postunset"><span class="csoptfmt">postunset</span></a> settings. <a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4762">189</a><p>
+<div class="defnbox"><a id="wrglossary.18072"></a><dfn id="glo:glsinlinedescformat"><code class="csfmt">\glsinlinedescformat</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">description</em>〉</span>}{<span class="meta">〈<em class="metainner">symbol</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18073"></a><a href="#glo:pkg.glossary-inline"><span class="styfmt">glossary-inline</span></a> v3.03+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the description, symbol and <a id="wrglossary.18074"></a><a href="#glo:dual.locationlist">location list</a> for top-level entries.<p>
+<div class="defnbox"><a id="wrglossary.18075"></a><dfn id="glo:glsinlinesubdescformat"><code class="csfmt">\glsinlinesubdescformat</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">description</em>〉</span>}{<span class="meta">〈<em class="metainner">symbol</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18076"></a><a href="#glo:pkg.glossary-inline"><span class="styfmt">glossary-inline</span></a> v3.03+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the description, symbol and <a id="wrglossary.18077"></a><a href="#glo:dual.locationlist">location list</a> for child entries.<p>
+<div class="defnbox"><a id="wrglossary.18078"></a><a href="#glo:glsinnerfmtabbrvfont"><code class="csfmt">\glsinnerfmtabbrvfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18079"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Robust command that applies both <a id="wrglossary.18080"></a><a href="#glo:glsabbrvfont"><code class="csfmt">\glsabbrvfont</code></a> and <a id="wrglossary.18081"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a> to <span class="meta">〈<em class="metainner">text</em>〉</span>. <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4187">167</a><p>
+<div class="defnbox"><a id="wrglossary.18082"></a><a href="#glo:glsinnerfmtlongfont"><code class="csfmt">\glsinnerfmtlongfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18083"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Applies both <a id="wrglossary.18084"></a><a href="#glo:glslongfont"><code class="csfmt">\glslongfont</code></a> and <a id="wrglossary.18085"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a> to <span class="meta">〈<em class="metainner">text</em>〉</span>. <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4208">168</a><p>
+<div class="defnbox"><a id="wrglossary.18086"></a><dfn id="glo:glsinsert"><code class="csfmt">\glsinsert</code></dfn><span class="floatrightbox"><a id="wrglossary.18087"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The final <span class="meta">〈<em class="metainner">insert</em>〉</span> argument passed to the <a id="wrglossary.18088"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands (but not to the <a id="wrglossary.18089"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands, where the <span class="meta">〈<em class="metainner">insert</em>〉</span> is added to <a id="wrglossary.18090"></a><a href="#glo:glscustomtext"><code class="csfmt">\glscustomtext</code></a>). This command may be used within associated hooks, entry display styles (<a id="wrglossary.18091"></a><a href="#glo:defglsentryfmt"><code class="csfmt">\defglsentryfmt</code></a>), and the <a id="wrglossary.18092"></a><a href="#glo:dual.postlinkhook">post-link hook</a>.<p>
+<div class="defnbox"><a id="wrglossary.18093"></a><a href="#glo:glskeylisttok"><code class="csfmt">\glskeylisttok</code></a><span class="floatrightbox"><a id="wrglossary.18094"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A token register that stores the options passed to <a id="wrglossary.18095"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>. <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4066">163</a><p>
+<div class="defnbox"><a id="wrglossary.18096"></a><dfn id="glo:glslabel"><code class="csfmt">\glslabel</code></dfn><span class="floatrightbox"><a id="wrglossary.18097"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The current entry label, initialised by the <a id="wrglossary.18098"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.18099"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands. This command may be used within associated hooks, entry display styles (<a id="wrglossary.18100"></a><a href="#glo:defglsentryfmt"><code class="csfmt">\defglsentryfmt</code></a>), and the <a id="wrglossary.18101"></a><a href="#glo:dual.postlinkhook">post-link hook</a>.<p>
+<div class="defnbox"><a id="wrglossary.18102"></a><a href="#glo:glslabeltok"><code class="csfmt">\glslabeltok</code></a><span class="floatrightbox"><a id="wrglossary.18103"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A token register that stores the entry’s label. <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4071">163</a><p>
+<div class="defnbox"><a id="wrglossary.18104"></a><dfn id="glo:glsletentryfield"><code class="csfmt">\glsletentryfield</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18105"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.07+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Fetches the value of the given <a id="wrglossary.18106"></a><a href="#glo:dual.field">field</a> (identified by its <a id="wrglossary.18107"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a> <span class="meta">〈<em class="metainner">field-label</em>〉</span>) for the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> and stores it in the command <span class="meta">〈<em class="metainner">cs</em>〉</span>.<p>
+<div class="defnbox"><a id="wrglossary.18108"></a><dfn id="glo:Glslink"><code class="csfmt">\Glslink</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.18109"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.18110"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.18111"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.18112"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.18113"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a> but sets the <a id="wrglossary.18114"></a><a href="#glo:dual.linktext">link text</a> to <code class="code"><a id="wrglossary.18115"></a><a href="#glo:glssentencecase"><code class="csfmt">\glssentencecase</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code>. This is provided to allow a <a id="wrglossary.18116"></a><a href="#glo:idx.sentencecase">sentence case</a> mapping in the event that <a id="wrglossary.18117"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a> occurs at the start of content that has automated case-changing.<p>
+<div class="defnbox"><a id="wrglossary.18118"></a><dfn id="glo:glslink"><code class="csfmt">\glslink</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.18119"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.18120"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.18121"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.18122"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> with the given <span class="meta">〈<em class="metainner">text</em>〉</span> as the <a id="wrglossary.18123"></a><a href="#glo:dual.linktext">link text</a>. This command does not alter or depend on the <a id="wrglossary.18124"></a><a href="#glo:dual.firstuseflag">first use flag</a> (use <a id="wrglossary.18125"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a> instead, if the <a id="wrglossary.18126"></a><a href="#glo:dual.firstuseflag">first use flag</a> needs to be unset). This command is considered a <a id="wrglossary.18127"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> command. For the first optional argument, see <a id="wrglossary.18128"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>.<p>
+<div class="defnbox"><a id="wrglossary.18129"></a><dfn id="glo:glslinkcheckfirsthyperhook"><code class="csfmt">\glslinkcheckfirsthyperhook</code></dfn><span class="floatrightbox"><a id="wrglossary.18130"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook used at the end of the code in the <a id="wrglossary.18131"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands that tests if the hyperlink should be switched off on <a id="wrglossary.18132"></a><a href="#glo:dual.firstuse">first use</a>.<p>
+<div class="defnbox"><a id="wrglossary.18133"></a><dfn id="glo:glslinkpostsetkeys"><code class="csfmt">\glslinkpostsetkeys</code></dfn><span class="floatrightbox"><a id="wrglossary.18134"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.16+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook implemented after setting the options passed to the <a id="wrglossary.18135"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.18136"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands.<p>
+<div class="defnbox"><a id="wrglossary.18137"></a><a href="#glo:glslinkpresetkeys"><code class="csfmt">\glslinkpresetkeys</code></a><span class="floatrightbox"><a id="wrglossary.18138"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.26+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook implemented before setting the options passed to the <a id="wrglossary.18139"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.18140"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands. <a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4752">188</a><p>
+<div class="defnbox"><a id="wrglossary.18141"></a><a href="#glo:glslinkwrcontent"><code class="csfmt">\glslinkwrcontent</code></a><code class="code">{<span class="meta">〈<em class="metainner">code</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18142"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Encapsulates the <a id="wrglossary.18143"></a><a href="#glo:dual.linktext">link text</a> and <a id="wrglossary.18144"></a><a href="#glo:dual.indexing">indexing</a>. Just does <span class="meta">〈<em class="metainner">code</em>〉</span> by default. <a href="#sec:glsref">§5</a>; <a href="#wrglossary.4624">185</a><p>
+<div class="defnbox"><a id="wrglossary.18145"></a><a href="#glo:glslistchildpostlocation"><code class="csfmt">\glslistchildpostlocation</code></a><span class="floatrightbox"><span class="summarytag">initial: </span>.; <a id="wrglossary.18146"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used after the child entry <a id="wrglossary.18147"></a><a href="#glo:dual.locationlist">location list</a> for the <a id="wrglossary.18148"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> styles. <a href="#sec:stylemodslist">§8.6.5.3</a>; <a href="#wrglossary.10934">429</a><p>
+<div class="defnbox"><a id="wrglossary.18149"></a><a href="#glo:glslistchildprelocation"><code class="csfmt">\glslistchildprelocation</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glslistprelocation"><code class="csfmt">\glslistprelocation</code></a>; <a id="wrglossary.18150"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used before the child entry <a id="wrglossary.18151"></a><a href="#glo:dual.locationlist">location list</a> for the <a id="wrglossary.18152"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> styles. <a href="#sec:stylemodslist">§8.6.5.3</a>; <a href="#wrglossary.10915">428</a><p>
+<div class="defnbox"><a id="wrglossary.18153"></a><a href="#glo:glslistdesc"><code class="csfmt">\glslistdesc</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18154"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the description for the <a id="wrglossary.18155"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> styles. <a href="#sec:stylemodslist">§8.6.5.3</a>; <a href="#wrglossary.10917">429</a><p>
+<div class="defnbox"><a id="wrglossary.18156"></a><dfn id="glo:glslistdottedwidth"><code class="csfmt">\glslistdottedwidth</code></dfn><span class="floatrightbox"><a id="wrglossary.18157"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A length register used by <a id="wrglossary.18158"></a><a href="#glo:opt.glostyle.listdotted"><span class="glostylefmt">listdotted</span></a>.<p>
+<div class="defnbox"><a id="wrglossary.18159"></a><dfn id="glo:glslistexpandedname"><code class="csfmt">\glslistexpandedname</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18160"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a> v4.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.18161"></a><a href="#glo:glslistinit"><code class="csfmt">\glslistinit</code></a> to provide better integration with <a id="wrglossary.18162"></a><a href="#glo:pkg.gettitlestring"><span class="styfmt">gettitlestring</span></a>.<p>
+<div class="defnbox"><a id="wrglossary.18163"></a><a href="#glo:glslistgroupafterheader"><code class="csfmt">\glslistgroupafterheader</code></a><span class="floatrightbox"><a id="wrglossary.18164"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.47+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used after <a id="wrglossary.18165"></a><a href="#glo:idx.group">group</a> headings in the <a id="wrglossary.18166"></a><a href="#glo:opt.glostyle.listgroup"><span class="glostylefmt">listgroup</span></a> styles. <a href="#sec:stylemodslist">§8.6.5.3</a>; <a href="#wrglossary.10929">429</a><p>
+<div class="defnbox"><a id="wrglossary.18167"></a><a href="#glo:glslistgroupheaderitem"><code class="csfmt">\glslistgroupheaderitem</code></a><code class="code">{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}{<span class="meta">〈<em class="metainner">header code</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18168"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.47+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the <a id="wrglossary.18169"></a><a href="#glo:idx.group">group</a> headings in the <a id="wrglossary.18170"></a><a href="#glo:opt.glostyle.listgroup"><span class="glostylefmt">listgroup</span></a> styles. <a href="#sec:stylemodslist">§8.6.5.3</a>; <a href="#wrglossary.10927">429</a><p>
+<div class="defnbox"><a id="wrglossary.18171"></a><a href="#glo:glslistgroupskip"><code class="csfmt">\glslistgroupskip</code></a><span class="floatrightbox"><a id="wrglossary.18172"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used for the group skip in the <a id="wrglossary.18173"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> styles. <a href="#sec:stylemodslist">§8.6.5.3</a>; <a href="#wrglossary.10939">430</a><p>
+<div class="defnbox"><a id="wrglossary.18174"></a><dfn id="glo:glslistinit"><code class="csfmt">\glslistinit</code></dfn><span class="floatrightbox"><a id="wrglossary.18175"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a> v4.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to disable problematic commands at the start the <a id="wrglossary.18176"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> styles to provide better integration with <a id="wrglossary.18177"></a><a href="#glo:pkg.gettitlestring"><span class="styfmt">gettitlestring</span></a>.<p>
+<div class="defnbox"><a id="wrglossary.18178"></a><a href="#glo:glslistitem"><code class="csfmt">\glslistitem</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18179"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.47+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the top-level entry item in the <a id="wrglossary.18180"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> styles. <a href="#sec:stylemodslist">§8.6.5.3</a>; <a href="#wrglossary.10922">429</a><p>
+<div class="defnbox"><a id="wrglossary.18181"></a><a href="#glo:glslistprelocation"><code class="csfmt">\glslistprelocation</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsxtrprelocation"><code class="csfmt">\glsxtrprelocation</code></a>; <a id="wrglossary.18182"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used before the top-level entry <a id="wrglossary.18183"></a><a href="#glo:dual.locationlist">location list</a> for the <a id="wrglossary.18184"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> styles. <a href="#sec:stylemodslist">§8.6.5.3</a>; <a href="#wrglossary.10913">428</a><p>
+<div class="defnbox"><a id="wrglossary.18185"></a><dfn id="glo:glslocalreset"><code class="csfmt">\glslocalreset</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18186"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally resets the entry’s <a id="wrglossary.18187"></a><a href="#glo:dual.firstuseflag">first use flag</a>. That is, this marks the entry as <span class="qt">“not used”</span>.<p>
+<div class="defnbox"><a id="wrglossary.18188"></a><dfn id="glo:glslocalresetall"><code class="csfmt">\glslocalresetall</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">glossary labels list</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.18189"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally resets the <a id="wrglossary.18190"></a><a href="#glo:dual.firstuseflag">first use flag</a> for all entries in whose labels are listed in the <span class="meta">〈<em class="metainner">glossary labels list</em>〉</span> comma-separated list. If the optional argument is omitted, the list of all non-<a id="wrglossary.18191"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a> is assumed.<p>
+<div class="defnbox"><a id="wrglossary.18192"></a><a href="#glo:glslocalreseteach"><code class="csfmt">\glslocalreseteach</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-labels</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18193"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally resets each listed entry’s <a id="wrglossary.18194"></a><a href="#glo:dual.firstuseflag">first use flag</a>. <a href="#sec:glsunset">§5.10</a>; <a href="#wrglossary.7362">281</a><p>
+<div class="defnbox"><a id="wrglossary.18195"></a><dfn id="glo:glslocalunset"><code class="csfmt">\glslocalunset</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18196"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally unsets the entry’s <a id="wrglossary.18197"></a><a href="#glo:dual.firstuseflag">first use flag</a>. That is, this marks the entry as <span class="qt">“used”</span>.<p>
+<div class="defnbox"><a id="wrglossary.18198"></a><dfn id="glo:glslocalunsetall"><code class="csfmt">\glslocalunsetall</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">glossary labels list</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.18199"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally unsets the <a id="wrglossary.18200"></a><a href="#glo:dual.firstuseflag">first use flag</a> for all entries in whose labels are listed in the <span class="meta">〈<em class="metainner">glossary labels list</em>〉</span> comma-separated list. If the optional argument is omitted, the list of all non-<a id="wrglossary.18201"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a> is assumed.<p>
+<div class="defnbox"><a id="wrglossary.18202"></a><a href="#glo:glslocalunseteach"><code class="csfmt">\glslocalunseteach</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-labels</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18203"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally unsets each listed entry’s <a id="wrglossary.18204"></a><a href="#glo:dual.firstuseflag">first use flag</a>. <a href="#sec:glsunset">§5.10</a>; <a href="#wrglossary.7361">281</a><p>
+<div class="defnbox"><a id="wrglossary.18205"></a><dfn id="glo:glslongaccessdisplay"><code class="csfmt">\glslongaccessdisplay</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18206"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">text</em>〉</span> with the <a id="wrglossary.18207"></a><a href="#glo:opt.gloskey.longaccess"><span class="csoptfmt">longaccess</span></a> replacement text (if set).<p>
+<div class="defnbox"><a id="wrglossary.18208"></a><a href="#glo:glslongdefaultfont"><code class="csfmt">\glslongdefaultfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18209"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formatting command for the long form used by the abbreviation styles that don’t apply a font change by default. <a href="#wrglossary.3284">133</a><p>
+<div class="defnbox"><a id="wrglossary.18210"></a><a href="#glo:glslongemfont"><code class="csfmt">\glslongemfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18211"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Long form font used by the <span class="qt">“em”</span> abbreviation styles. <a href="#wrglossary.3943">158</a><p>
+<div class="defnbox"><a id="wrglossary.18212"></a><a href="#glo:glslongextraDescAlign"><code class="csfmt">\glslongextraDescAlign</code></a><span class="floatrightbox"><a id="wrglossary.18213"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The horizontal alignment for the description column. <a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11238">446</a><p>
+<div class="defnbox"><a id="wrglossary.18214"></a><a href="#glo:glslongextraDescFmt"><code class="csfmt">\glslongextraDescFmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18215"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.18216"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> styles to display a top-level entry’s description and <a id="wrglossary.18217"></a><a href="#glo:dual.postdeschook">post-description hook</a>. <a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11233">446</a><p>
+<div class="defnbox"><a id="wrglossary.18218"></a><a href="#glo:glslongextraDescNameHeader"><code class="csfmt">\glslongextraDescNameHeader</code></a><span class="floatrightbox"><a id="wrglossary.18219"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the header and footer for the <a id="wrglossary.18220"></a><a href="#glo:opt.glostyle.long-desc-name"><span class="glostylefmt">long-desc-name</span></a> style with <a id="wrglossary.18221"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>. <a href="#sec:longextranamedesc">§8.7.2.1</a>; <a href="#wrglossary.11306">450</a><p>
+<div class="defnbox"><a id="wrglossary.18222"></a><a href="#glo:glslongextraDescNameTabularFooter"><code class="csfmt">\glslongextraDescNameTabularFooter</code></a><span class="floatrightbox"><a id="wrglossary.18223"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the footer for the <a id="wrglossary.18224"></a><a href="#glo:opt.glostyle.long-desc-name"><span class="glostylefmt">long-desc-name</span></a> style. <a href="#sec:longextranamedesc">§8.7.2.1</a>; <a href="#wrglossary.11304">450</a><p>
+<div class="defnbox"><a id="wrglossary.18225"></a><a href="#glo:glslongextraDescNameTabularHeader"><code class="csfmt">\glslongextraDescNameTabularHeader</code></a><span class="floatrightbox"><a id="wrglossary.18226"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the header for the <a id="wrglossary.18227"></a><a href="#glo:opt.glostyle.long-desc-name"><span class="glostylefmt">long-desc-name</span></a> style. <a href="#sec:longextranamedesc">§8.7.2.1</a>; <a href="#wrglossary.11303">450</a><p>
+<div class="defnbox"><a id="wrglossary.18228"></a><a href="#glo:glslongextraDescSymHeader"><code class="csfmt">\glslongextraDescSymHeader</code></a><span class="floatrightbox"><a id="wrglossary.18229"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the header and footer for the <a id="wrglossary.18230"></a><a href="#glo:opt.glostyle.long-desc-sym"><span class="glostylefmt">long-desc-sym</span></a> style with <a id="wrglossary.18231"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>. <a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11421">458</a><p>
+<div class="defnbox"><a id="wrglossary.18232"></a><a href="#glo:glslongextraDescSymNameHeader"><code class="csfmt">\glslongextraDescSymNameHeader</code></a><span class="floatrightbox"><a id="wrglossary.18233"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the header and footer for the <a id="wrglossary.18234"></a><a href="#glo:opt.glostyle.long-desc-sym-name"><span class="glostylefmt">long-desc-sym-name</span></a> style with <a id="wrglossary.18235"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>. <a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11334">452</a><p>
+<div class="defnbox"><a id="wrglossary.18236"></a><a href="#glo:glslongextraDescSymNameTabularFooter"><code class="csfmt">\glslongextraDescSymNameTabularFooter</code></a><span class="floatrightbox"><a id="wrglossary.18237"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the footer for the <a id="wrglossary.18238"></a><a href="#glo:opt.glostyle.long-desc-sym-name"><span class="glostylefmt">long-desc-sym-name</span></a> style. <a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11332">452</a><p>
+<div class="defnbox"><a id="wrglossary.18239"></a><a href="#glo:glslongextraDescSymNameTabularHeader"><code class="csfmt">\glslongextraDescSymNameTabularHeader</code></a><span class="floatrightbox"><a id="wrglossary.18240"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the header for the <a id="wrglossary.18241"></a><a href="#glo:opt.glostyle.long-desc-sym-name"><span class="glostylefmt">long-desc-sym-name</span></a> style. <a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11331">452</a><p>
+<div class="defnbox"><a id="wrglossary.18242"></a><a href="#glo:glslongextraDescSymTabularFooter"><code class="csfmt">\glslongextraDescSymTabularFooter</code></a><span class="floatrightbox"><a id="wrglossary.18243"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the footer for the <a id="wrglossary.18244"></a><a href="#glo:opt.glostyle.long-desc-sym"><span class="glostylefmt">long-desc-sym</span></a> style. <a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11419">458</a><p>
+<div class="defnbox"><a id="wrglossary.18245"></a><a href="#glo:glslongextraDescSymTabularHeader"><code class="csfmt">\glslongextraDescSymTabularHeader</code></a><span class="floatrightbox"><a id="wrglossary.18246"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the header for the <a id="wrglossary.18247"></a><a href="#glo:opt.glostyle.long-desc-sym"><span class="glostylefmt">long-desc-sym</span></a> style. <a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11418">458</a><p>
+<div class="defnbox"><a id="wrglossary.18248"></a><a href="#glo:glslongextraGroupHeading"><code class="csfmt">\glslongextraGroupHeading</code></a><code class="code">{<span class="meta">〈<em class="metainner">number columns</em>〉</span>}{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18249"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the top-level <a id="wrglossary.18250"></a><a href="#glo:idx.group">group</a> heading. <a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11272">448</a><p>
+<div class="defnbox"><a id="wrglossary.18251"></a><a href="#glo:glslongextraHeaderFmt"><code class="csfmt">\glslongextraHeaderFmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18252"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to format the column headers. <a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11218">445</a><p>
+<div class="defnbox"><a id="wrglossary.18253"></a><a href="#glo:glslongextraLocationAlign"><code class="csfmt">\glslongextraLocationAlign</code></a><span class="floatrightbox"><a id="wrglossary.18254"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The horizontal alignment for the <a id="wrglossary.18255"></a><a href="#glo:dual.locationlist">location list</a> column. <a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11259">447</a><p>
+<div class="defnbox"><a id="wrglossary.18256"></a><a href="#glo:glslongextraLocationDescNameHeader"><code class="csfmt">\glslongextraLocationDescNameHeader</code></a><span class="floatrightbox"><a id="wrglossary.18257"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the header and footer for the <a id="wrglossary.18258"></a><a href="#glo:opt.glostyle.long-loc-desc-name"><span class="glostylefmt">long-loc-desc-name</span></a> style with <a id="wrglossary.18259"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>. <a href="#sec:longextranamedescloc">§8.7.2.3</a>; <a href="#wrglossary.11356">453</a><p>
+<div class="defnbox"><a id="wrglossary.18260"></a><a href="#glo:glslongextraLocationDescNameTabularFooter"><code class="csfmt">\glslongextraLocationDescNameTabularFooter</code></a><span class="floatrightbox"><a id="wrglossary.18261"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the footer for the <a id="wrglossary.18262"></a><a href="#glo:opt.glostyle.long-loc-desc-name"><span class="glostylefmt">long-loc-desc-name</span></a> style. <a href="#sec:longextranamedescloc">§8.7.2.3</a>; <a href="#wrglossary.11354">453</a><p>
+<div class="defnbox"><a id="wrglossary.18263"></a><a href="#glo:glslongextraLocationDescNameTabularHeader"><code class="csfmt">\glslongextraLocationDescNameTabularHeader</code></a><span class="floatrightbox"><a id="wrglossary.18264"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the header for the <a id="wrglossary.18265"></a><a href="#glo:opt.glostyle.long-loc-desc-name"><span class="glostylefmt">long-loc-desc-name</span></a> style. <a href="#sec:longextranamedescloc">§8.7.2.3</a>; <a href="#wrglossary.11353">453</a><p>
+<div class="defnbox"><a id="wrglossary.18266"></a><a href="#glo:glslongextraLocationDescSymNameHeader"><code class="csfmt">\glslongextraLocationDescSymNameHeader</code></a><span class="floatrightbox"><a id="wrglossary.18267"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the header and footer for the <a id="wrglossary.18268"></a><a href="#glo:opt.glostyle.long-loc-desc-sym-name"><span class="glostylefmt">long-loc-desc-sym-name</span></a> style with <a id="wrglossary.18269"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>. <a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11390">456</a><p>
+<div class="defnbox"><a id="wrglossary.18270"></a><a href="#glo:glslongextraLocationDescSymNameTabularFooter"><code class="csfmt">\glslongextraLocationDescSymNameTabularFooter</code></a><span class="floatrightbox"><a id="wrglossary.18271"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the footer for the <a id="wrglossary.18272"></a><a href="#glo:opt.glostyle.long-loc-desc-sym-name"><span class="glostylefmt">long-loc-desc-sym-name</span></a> style. <a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11388">456</a><p>
+<div class="defnbox"><a id="wrglossary.18273"></a><a href="#glo:glslongextraLocationDescSymNameTabularHeader"><code class="csfmt">\glslongextraLocationDescSymNameTabularHeader</code></a><span class="floatrightbox"><a id="wrglossary.18274"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the header for the <a id="wrglossary.18275"></a><a href="#glo:opt.glostyle.long-loc-desc-sym-name"><span class="glostylefmt">long-loc-desc-sym-name</span></a> style. <a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11387">455</a><p>
+<div class="defnbox"><a id="wrglossary.18276"></a><a href="#glo:glslongextraLocationFmt"><code class="csfmt">\glslongextraLocationFmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18277"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.18278"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> styles to display a top-level entry’s <a id="wrglossary.18279"></a><a href="#glo:dual.locationlist">location list</a>. <a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11255">447</a><p>
+<div class="defnbox"><a id="wrglossary.18280"></a><a href="#glo:glslongextraLocationSymDescNameHeader"><code class="csfmt">\glslongextraLocationSymDescNameHeader</code></a><span class="floatrightbox"><a id="wrglossary.18281"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the header and footer for the <a id="wrglossary.18282"></a><a href="#glo:opt.glostyle.long-loc-sym-desc-name"><span class="glostylefmt">long-loc-sym-desc-name</span></a> style with <a id="wrglossary.18283"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>. <a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11384">455</a><p>
+<div class="defnbox"><a id="wrglossary.18284"></a><a href="#glo:glslongextraLocationSymDescNameTabularFooter"><code class="csfmt">\glslongextraLocationSymDescNameTabularFooter</code></a><span class="floatrightbox"><a id="wrglossary.18285"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the footer for the <a id="wrglossary.18286"></a><a href="#glo:opt.glostyle.long-loc-sym-desc-name"><span class="glostylefmt">long-loc-sym-desc-name</span></a> style. <a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11382">455</a><p>
+<div class="defnbox"><a id="wrglossary.18287"></a><a href="#glo:glslongextraLocationSymDescNameTabularHeader"><code class="csfmt">\glslongextraLocationSymDescNameTabularHeader</code></a><span class="floatrightbox"><a id="wrglossary.18288"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the header for the <a id="wrglossary.18289"></a><a href="#glo:opt.glostyle.long-loc-sym-desc-name"><span class="glostylefmt">long-loc-sym-desc-name</span></a> style. <a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11381">455</a><p>
+<div class="defnbox"><a id="wrglossary.18290"></a><a href="#glo:glslongextraLocSetDescWidth"><code class="csfmt">\glslongextraLocSetDescWidth</code></a><span class="floatrightbox"><a id="wrglossary.18291"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Computes the value of <a id="wrglossary.18292"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a> according to the widest name for styles that only show the name, <a id="wrglossary.18293"></a><a href="#glo:dual.locationlist">location list</a> and description. <a href="#sec:longextranamedescloc">§8.7.2.3</a>; <a href="#wrglossary.11336">452</a><p>
+<div class="defnbox"><a id="wrglossary.18294"></a><a href="#glo:glslongextraLongFmt"><code class="csfmt">\glslongextraLongFmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18295"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The formatting for the long form in the <a id="wrglossary.18296"></a><a href="#glo:opt.glostyle.abbr-long-short"><span class="glostylefmt">abbr-long-short</span></a> and <a id="wrglossary.18297"></a><a href="#glo:opt.glostyle.abbr-short-long"><span class="glostylefmt">abbr-short-long</span></a> styles. <a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11448">459</a><p>
+<div class="defnbox"><a id="wrglossary.18298"></a><a href="#glo:glslongextraLongHeader"><code class="csfmt">\glslongextraLongHeader</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:descriptionname"><code class="csfmt">\descriptionname</code></a>; <a id="wrglossary.18299"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The long column header for the <a id="wrglossary.18300"></a><a href="#glo:opt.glostyle.abbr-long-short"><span class="glostylefmt">abbr-long-short</span></a> and <a id="wrglossary.18301"></a><a href="#glo:opt.glostyle.abbr-short-long"><span class="glostylefmt">abbr-short-long</span></a> styles. <a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11436">459</a><p>
+<div class="defnbox"><a id="wrglossary.18302"></a><a href="#glo:glslongextraLongShortHeader"><code class="csfmt">\glslongextraLongShortHeader</code></a><span class="floatrightbox"><a id="wrglossary.18303"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the header and footer for the <a id="wrglossary.18304"></a><a href="#glo:opt.glostyle.abbr-short-long"><span class="glostylefmt">abbr-short-long</span></a> style with <a id="wrglossary.18305"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>. <a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11480">461</a><p>
+<div class="defnbox"><a id="wrglossary.18306"></a><a href="#glo:glslongextraLongShortTabularFooter"><code class="csfmt">\glslongextraLongShortTabularFooter</code></a><span class="floatrightbox"><a id="wrglossary.18307"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the footer for the <a id="wrglossary.18308"></a><a href="#glo:opt.glostyle.abbr-short-long"><span class="glostylefmt">abbr-short-long</span></a> style. <a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11478">461</a><p>
+<div class="defnbox"><a id="wrglossary.18309"></a><a href="#glo:glslongextraLongShortTabularHeader"><code class="csfmt">\glslongextraLongShortTabularHeader</code></a><span class="floatrightbox"><a id="wrglossary.18310"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the header for the <a id="wrglossary.18311"></a><a href="#glo:opt.glostyle.abbr-short-long"><span class="glostylefmt">abbr-short-long</span></a> style. <a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11477">461</a><p>
+<div class="defnbox"><a id="wrglossary.18312"></a><a href="#glo:glslongextraNameAlign"><code class="csfmt">\glslongextraNameAlign</code></a><span class="floatrightbox"><span class="summarytag">initial: </span>l; <a id="wrglossary.18313"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The horizontal alignment for the name column. <a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11231">446</a><p>
+<div class="defnbox"><a id="wrglossary.18314"></a><a href="#glo:glslongextraNameDescHeader"><code class="csfmt">\glslongextraNameDescHeader</code></a><span class="floatrightbox"><a id="wrglossary.18315"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the header and footer for the <a id="wrglossary.18316"></a><a href="#glo:opt.glostyle.long-name-desc"><span class="glostylefmt">long-name-desc</span></a> style with <a id="wrglossary.18317"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>. <a href="#sec:longextranamedesc">§8.7.2.1</a>; <a href="#wrglossary.11301">449</a><p>
+<div class="defnbox"><a id="wrglossary.18318"></a><a href="#glo:glslongextraNameDescLocationHeader"><code class="csfmt">\glslongextraNameDescLocationHeader</code></a><span class="floatrightbox"><a id="wrglossary.18319"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the header and footer for the <a id="wrglossary.18320"></a><a href="#glo:opt.glostyle.long-name-desc-loc"><span class="glostylefmt">long-name-desc-loc</span></a> style with <a id="wrglossary.18321"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>. <a href="#sec:longextranamedescloc">§8.7.2.3</a>; <a href="#wrglossary.11350">453</a><p>
+<div class="defnbox"><a id="wrglossary.18322"></a><a href="#glo:glslongextraNameDescLocationTabularFooter"><code class="csfmt">\glslongextraNameDescLocationTabularFooter</code></a><span class="floatrightbox"><a id="wrglossary.18323"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the footer for the <a id="wrglossary.18324"></a><a href="#glo:opt.glostyle.long-name-desc-loc"><span class="glostylefmt">long-name-desc-loc</span></a> style. <a href="#sec:longextranamedescloc">§8.7.2.3</a>; <a href="#wrglossary.11348">453</a><p>
+<div class="defnbox"><a id="wrglossary.18325"></a><a href="#glo:glslongextraNameDescLocationTabularHeader"><code class="csfmt">\glslongextraNameDescLocationTabularHeader</code></a><span class="floatrightbox"><a id="wrglossary.18326"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the header for the <a id="wrglossary.18327"></a><a href="#glo:opt.glostyle.long-name-desc-loc"><span class="glostylefmt">long-name-desc-loc</span></a> style. <a href="#sec:longextranamedescloc">§8.7.2.3</a>; <a href="#wrglossary.11347">453</a><p>
+<div class="defnbox"><a id="wrglossary.18328"></a><a href="#glo:glslongextraNameDescSymHeader"><code class="csfmt">\glslongextraNameDescSymHeader</code></a><span class="floatrightbox"><a id="wrglossary.18329"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the header and footer for the <a id="wrglossary.18330"></a><a href="#glo:opt.glostyle.long-name-desc-sym"><span class="glostylefmt">long-name-desc-sym</span></a> style with <a id="wrglossary.18331"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>. <a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11319">451</a><p>
+<div class="defnbox"><a id="wrglossary.18332"></a><a href="#glo:glslongextraNameDescSymLocationHeader"><code class="csfmt">\glslongextraNameDescSymLocationHeader</code></a><span class="floatrightbox"><a id="wrglossary.18333"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the header and footer for the <a id="wrglossary.18334"></a><a href="#glo:opt.glostyle.long-name-desc-sym-loc"><span class="glostylefmt">long-name-desc-sym-loc</span></a> style with <a id="wrglossary.18335"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>. <a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11372">454</a><p>
+<div class="defnbox"><a id="wrglossary.18336"></a><a href="#glo:glslongextraNameDescSymLocationTabularFooter"><code class="csfmt">\glslongextraNameDescSymLocationTabularFooter</code></a><span class="floatrightbox"><a id="wrglossary.18337"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the footer for the <a id="wrglossary.18338"></a><a href="#glo:opt.glostyle.long-name-desc-sym-loc"><span class="glostylefmt">long-name-desc-sym-loc</span></a> style. <a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11370">454</a><p>
+<div class="defnbox"><a id="wrglossary.18339"></a><a href="#glo:glslongextraNameDescSymLocationTabularHeader"><code class="csfmt">\glslongextraNameDescSymLocationTabularHeader</code></a><span class="floatrightbox"><a id="wrglossary.18340"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the header for the <a id="wrglossary.18341"></a><a href="#glo:opt.glostyle.long-name-desc-sym-loc"><span class="glostylefmt">long-name-desc-sym-loc</span></a> style. <a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11369">454</a><p>
+<div class="defnbox"><a id="wrglossary.18342"></a><a href="#glo:glslongextraNameDescSymTabularFooter"><code class="csfmt">\glslongextraNameDescSymTabularFooter</code></a><span class="floatrightbox"><a id="wrglossary.18343"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the footer for the <a id="wrglossary.18344"></a><a href="#glo:opt.glostyle.long-name-desc-sym"><span class="glostylefmt">long-name-desc-sym</span></a> style. <a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11317">450</a><p>
+<div class="defnbox"><a id="wrglossary.18345"></a><a href="#glo:glslongextraNameDescSymTabularHeader"><code class="csfmt">\glslongextraNameDescSymTabularHeader</code></a><span class="floatrightbox"><a id="wrglossary.18346"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the header for the <a id="wrglossary.18347"></a><a href="#glo:opt.glostyle.long-name-desc-sym"><span class="glostylefmt">long-name-desc-sym</span></a> style. <a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11316">450</a><p>
+<div class="defnbox"><a id="wrglossary.18348"></a><a href="#glo:glslongextraNameDescTabularFooter"><code class="csfmt">\glslongextraNameDescTabularFooter</code></a><span class="floatrightbox"><a id="wrglossary.18349"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the footer for the <a id="wrglossary.18350"></a><a href="#glo:opt.glostyle.long-name-desc"><span class="glostylefmt">long-name-desc</span></a> style. <a href="#sec:longextranamedesc">§8.7.2.1</a>; <a href="#wrglossary.11299">449</a><p>
+<div class="defnbox"><a id="wrglossary.18351"></a><a href="#glo:glslongextraNameDescTabularHeader"><code class="csfmt">\glslongextraNameDescTabularHeader</code></a><span class="floatrightbox"><a id="wrglossary.18352"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the header for the <a id="wrglossary.18353"></a><a href="#glo:opt.glostyle.long-name-desc"><span class="glostylefmt">long-name-desc</span></a> style. <a href="#sec:longextranamedesc">§8.7.2.1</a>; <a href="#wrglossary.11298">449</a><p>
+<div class="defnbox"><a id="wrglossary.18354"></a><a href="#glo:glslongextraNameFmt"><code class="csfmt">\glslongextraNameFmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18355"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.18356"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> styles to add the hypertarget (if supported) and display a top-level entry’s name. <a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11226">446</a><p>
+<div class="defnbox"><a id="wrglossary.18357"></a><a href="#glo:glslongextraNameSymDescHeader"><code class="csfmt">\glslongextraNameSymDescHeader</code></a><span class="floatrightbox"><a id="wrglossary.18358"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the header and footer for the <a id="wrglossary.18359"></a><a href="#glo:opt.glostyle.long-name-sym-desc"><span class="glostylefmt">long-name-sym-desc</span></a> style with <a id="wrglossary.18360"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>. <a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11324">451</a><p>
+<div class="defnbox"><a id="wrglossary.18361"></a><a href="#glo:glslongextraNameSymDescLocationHeader"><code class="csfmt">\glslongextraNameSymDescLocationHeader</code></a><span class="floatrightbox"><a id="wrglossary.18362"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the header and footer for the <a id="wrglossary.18363"></a><a href="#glo:opt.glostyle.long-name-sym-desc-loc"><span class="glostylefmt">long-name-sym-desc-loc</span></a> style with <a id="wrglossary.18364"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>. <a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11378">455</a><p>
+<div class="defnbox"><a id="wrglossary.18365"></a><a href="#glo:glslongextraNameSymDescLocationTabularFooter"><code class="csfmt">\glslongextraNameSymDescLocationTabularFooter</code></a><span class="floatrightbox"><a id="wrglossary.18366"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the footer for the <a id="wrglossary.18367"></a><a href="#glo:opt.glostyle.long-name-sym-desc-loc"><span class="glostylefmt">long-name-sym-desc-loc</span></a> style. <a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11376">455</a><p>
+<div class="defnbox"><a id="wrglossary.18368"></a><a href="#glo:glslongextraNameSymDescLocationTabularHeader"><code class="csfmt">\glslongextraNameSymDescLocationTabularHeader</code></a><span class="floatrightbox"><a id="wrglossary.18369"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the header for the <a id="wrglossary.18370"></a><a href="#glo:opt.glostyle.long-name-sym-desc-loc"><span class="glostylefmt">long-name-sym-desc-loc</span></a> style. <a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11375">454</a><p>
+<div class="defnbox"><a id="wrglossary.18371"></a><a href="#glo:glslongextraNameSymDescTabularFooter"><code class="csfmt">\glslongextraNameSymDescTabularFooter</code></a><span class="floatrightbox"><a id="wrglossary.18372"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the footer for the <a id="wrglossary.18373"></a><a href="#glo:opt.glostyle.long-name-sym-desc"><span class="glostylefmt">long-name-sym-desc</span></a> style. <a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11322">451</a><p>
+<div class="defnbox"><a id="wrglossary.18374"></a><a href="#glo:glslongextraNameSymDescTabularHeader"><code class="csfmt">\glslongextraNameSymDescTabularHeader</code></a><span class="floatrightbox"><a id="wrglossary.18375"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the header for the <a id="wrglossary.18376"></a><a href="#glo:opt.glostyle.long-name-sym-desc"><span class="glostylefmt">long-name-sym-desc</span></a> style. <a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11321">451</a><p>
+<div class="defnbox"><a id="wrglossary.18377"></a><a href="#glo:glslongextraSetDescWidth"><code class="csfmt">\glslongextraSetDescWidth</code></a><span class="floatrightbox"><a id="wrglossary.18378"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Computes the value of <a id="wrglossary.18379"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a> according to the widest name for styles that only show the name and description. <a href="#sec:longextranamedesc">§8.7.2.1</a>; <a href="#wrglossary.11289">449</a><p>
+<div class="defnbox"><a id="wrglossary.18380"></a><a href="#glo:glslongextraSetWidest"><code class="csfmt">\glslongextraSetWidest</code></a><code class="code">{<span class="meta">〈<em class="metainner">widest-name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18381"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Identifies <span class="meta">〈<em class="metainner">widest-name</em>〉</span> as the widest top-level name. <a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11245">447</a><p>
+<div class="defnbox"><a id="wrglossary.18382"></a><a href="#glo:glslongextraShortHeader"><code class="csfmt">\glslongextraShortHeader</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:entryname"><code class="csfmt">\entryname</code></a>; <a id="wrglossary.18383"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The short column header for the <a id="wrglossary.18384"></a><a href="#glo:opt.glostyle.abbr-long-short"><span class="glostylefmt">abbr-long-short</span></a> and <a id="wrglossary.18385"></a><a href="#glo:opt.glostyle.abbr-short-long"><span class="glostylefmt">abbr-short-long</span></a> styles. <a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11433">458</a><p>
+<div class="defnbox"><a id="wrglossary.18386"></a><a href="#glo:glslongextraShortLongHeader"><code class="csfmt">\glslongextraShortLongHeader</code></a><span class="floatrightbox"><a id="wrglossary.18387"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the header and footer for the <a id="wrglossary.18388"></a><a href="#glo:opt.glostyle.abbr-short-long"><span class="glostylefmt">abbr-short-long</span></a> style with <a id="wrglossary.18389"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>. <a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11474">460</a><p>
+<div class="defnbox"><a id="wrglossary.18390"></a><a href="#glo:glslongextraShortLongTabularFooter"><code class="csfmt">\glslongextraShortLongTabularFooter</code></a><span class="floatrightbox"><a id="wrglossary.18391"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the footer for the <a id="wrglossary.18392"></a><a href="#glo:opt.glostyle.abbr-short-long"><span class="glostylefmt">abbr-short-long</span></a> style. <a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11472">460</a><p>
+<div class="defnbox"><a id="wrglossary.18393"></a><a href="#glo:glslongextraShortLongTabularHeader"><code class="csfmt">\glslongextraShortLongTabularHeader</code></a><span class="floatrightbox"><a id="wrglossary.18394"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the header for the <a id="wrglossary.18395"></a><a href="#glo:opt.glostyle.abbr-short-long"><span class="glostylefmt">abbr-short-long</span></a> style. <a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11471">460</a><p>
+<div class="defnbox"><a id="wrglossary.18396"></a><a href="#glo:glslongextraShortNoNameSetDescWidth"><code class="csfmt">\glslongextraShortNoNameSetDescWidth</code></a><span class="floatrightbox"><a id="wrglossary.18397"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the value of <a id="wrglossary.18398"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a> for the <a id="wrglossary.18399"></a><a href="#glo:opt.glostyle.abbr-long-short"><span class="glostylefmt">abbr-long-short</span></a> and <a id="wrglossary.18400"></a><a href="#glo:opt.glostyle.abbr-short-long"><span class="glostylefmt">abbr-short-long</span></a> styles. <a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11466">460</a><p>
+<div class="defnbox"><a id="wrglossary.18401"></a><a href="#glo:glslongextraShortTargetFmt"><code class="csfmt">\glslongextraShortTargetFmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18402"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The formatting, including the target, for the short form in the <a id="wrglossary.18403"></a><a href="#glo:opt.glostyle.abbr-long-short"><span class="glostylefmt">abbr-long-short</span></a> and <a id="wrglossary.18404"></a><a href="#glo:opt.glostyle.abbr-short-long"><span class="glostylefmt">abbr-short-long</span></a> styles. <a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11439">459</a><p>
+<div class="defnbox"><a id="wrglossary.18405"></a><a href="#glo:glslongextraSubDescFmt"><code class="csfmt">\glslongextraSubDescFmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18406"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.18407"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> styles to display a child entry’s description and <a id="wrglossary.18408"></a><a href="#glo:dual.postdeschook">post-description hook</a>. <a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11236">446</a><p>
+<div class="defnbox"><a id="wrglossary.18409"></a><a href="#glo:glslongextraSubGroupHeading"><code class="csfmt">\glslongextraSubGroupHeading</code></a><code class="code">{<span class="meta">〈<em class="metainner">number columns</em>〉</span>}{<span class="meta">〈<em class="metainner">prev group level</em>〉</span>}{<span class="meta">〈<em class="metainner">group level</em>〉</span>}{<span class="meta">〈<em class="metainner">parent-entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18410"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the sub-<a id="wrglossary.18411"></a><a href="#glo:idx.group">group</a> heading, if supported. <a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11282">448</a><p>
+<div class="defnbox"><a id="wrglossary.18412"></a><a href="#glo:glslongextraSubLocationFmt"><code class="csfmt">\glslongextraSubLocationFmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18413"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.18414"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> styles to display a child entry’s <a id="wrglossary.18415"></a><a href="#glo:dual.locationlist">location list</a>. <a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11257">447</a><p>
+<div class="defnbox"><a id="wrglossary.18416"></a><a href="#glo:glslongextraSubLongFmt"><code class="csfmt">\glslongextraSubLongFmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18417"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The formatting for child entry long forms in the <a id="wrglossary.18418"></a><a href="#glo:opt.glostyle.abbr-long-short"><span class="glostylefmt">abbr-long-short</span></a> and <a id="wrglossary.18419"></a><a href="#glo:opt.glostyle.abbr-short-long"><span class="glostylefmt">abbr-short-long</span></a> styles. <a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11463">460</a><p>
+<div class="defnbox"><a id="wrglossary.18420"></a><a href="#glo:glslongextraSubNameFmt"><code class="csfmt">\glslongextraSubNameFmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18421"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.18422"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> styles to add the hypertarget (if supported) for child-entries. The name isn’t shown by default. <a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11229">446</a><p>
+<div class="defnbox"><a id="wrglossary.18423"></a><a href="#glo:glslongextraSubShortTargetFmt"><code class="csfmt">\glslongextraSubShortTargetFmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18424"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The formatting, including the target, for child entry short forms in the <a id="wrglossary.18425"></a><a href="#glo:opt.glostyle.abbr-long-short"><span class="glostylefmt">abbr-long-short</span></a> and <a id="wrglossary.18426"></a><a href="#glo:opt.glostyle.abbr-short-long"><span class="glostylefmt">abbr-short-long</span></a> styles. <a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11455">459</a><p>
+<div class="defnbox"><a id="wrglossary.18427"></a><a href="#glo:glslongextraSubSymbolFmt"><code class="csfmt">\glslongextraSubSymbolFmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18428"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.18429"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> styles to display a child entry’s symbol. <a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11266">448</a><p>
+<div class="defnbox"><a id="wrglossary.18430"></a><a href="#glo:glslongextraSubSymbolOrName"><code class="csfmt">\glslongextraSubSymbolOrName</code></a><code class="code">{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18431"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Adds the hypertarget (if supported) and displays the symbol if set or the name otherwise for child entries. <a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11402">457</a><p>
+<div class="defnbox"><a id="wrglossary.18432"></a><a href="#glo:glslongextraSubSymbolTargetFmt"><code class="csfmt">\glslongextraSubSymbolTargetFmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18433"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Adds the hypertarget (if supported) and displays the symbol for child entries. <a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11397">456</a><p>
+<div class="defnbox"><a id="wrglossary.18434"></a><a href="#glo:glslongextraSymbolAlign"><code class="csfmt">\glslongextraSymbolAlign</code></a><span class="floatrightbox"><span class="summarytag">initial: </span>c; <a id="wrglossary.18435"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The horizontal alignment for the symbol column. <a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11270">448</a><p>
+<div class="defnbox"><a id="wrglossary.18436"></a><a href="#glo:glslongextraSymbolFmt"><code class="csfmt">\glslongextraSymbolFmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18437"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.18438"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> styles to display a top-level entry’s symbol. <a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11264">448</a><p>
+<div class="defnbox"><a id="wrglossary.18439"></a><a href="#glo:glslongextraSymbolNameAlign"><code class="csfmt">\glslongextraSymbolNameAlign</code></a><span class="floatrightbox"><span class="summarytag">initial: </span>l; <a id="wrglossary.18440"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The horizontal alignment for the symbol column when it’s being used instead of the name. <a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11392">456</a><p>
+<div class="defnbox"><a id="wrglossary.18441"></a><a href="#glo:glslongextraSymbolOrName"><code class="csfmt">\glslongextraSymbolOrName</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18442"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Adds the hypertarget (if supported) and displays the symbol if set or the name otherwise for top-level entries. <a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11401">456</a><p>
+<div class="defnbox"><a id="wrglossary.18443"></a><a href="#glo:glslongextraSymbolTargetFmt"><code class="csfmt">\glslongextraSymbolTargetFmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18444"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Adds the hypertarget (if supported) and displays the symbol for top-level entries. <a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11395">456</a><p>
+<div class="defnbox"><a id="wrglossary.18445"></a><a href="#glo:glslongextraSymDescHeader"><code class="csfmt">\glslongextraSymDescHeader</code></a><span class="floatrightbox"><a id="wrglossary.18446"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the header and footer for the <a id="wrglossary.18447"></a><a href="#glo:opt.glostyle.long-sym-desc"><span class="glostylefmt">long-sym-desc</span></a> style with <a id="wrglossary.18448"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>. <a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11415">457</a><p>
+<div class="defnbox"><a id="wrglossary.18449"></a><a href="#glo:glslongextraSymDescNameHeader"><code class="csfmt">\glslongextraSymDescNameHeader</code></a><span class="floatrightbox"><a id="wrglossary.18450"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the header and footer for the <a id="wrglossary.18451"></a><a href="#glo:opt.glostyle.long-sym-desc-name"><span class="glostylefmt">long-sym-desc-name</span></a> style with <a id="wrglossary.18452"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>. <a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11329">452</a><p>
+<div class="defnbox"><a id="wrglossary.18453"></a><a href="#glo:glslongextraSymDescNameTabularFooter"><code class="csfmt">\glslongextraSymDescNameTabularFooter</code></a><span class="floatrightbox"><a id="wrglossary.18454"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the footer for the <a id="wrglossary.18455"></a><a href="#glo:opt.glostyle.long-sym-desc-name"><span class="glostylefmt">long-sym-desc-name</span></a> style. <a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11327">451</a><p>
+<div class="defnbox"><a id="wrglossary.18456"></a><a href="#glo:glslongextraSymDescNameTabularHeader"><code class="csfmt">\glslongextraSymDescNameTabularHeader</code></a><span class="floatrightbox"><a id="wrglossary.18457"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the header for the <a id="wrglossary.18458"></a><a href="#glo:opt.glostyle.long-sym-desc-name"><span class="glostylefmt">long-sym-desc-name</span></a> style. <a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11326">451</a><p>
+<div class="defnbox"><a id="wrglossary.18459"></a><a href="#glo:glslongextraSymDescTabularFooter"><code class="csfmt">\glslongextraSymDescTabularFooter</code></a><span class="floatrightbox"><a id="wrglossary.18460"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the footer for the <a id="wrglossary.18461"></a><a href="#glo:opt.glostyle.long-sym-desc"><span class="glostylefmt">long-sym-desc</span></a> style. <a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11413">457</a><p>
+<div class="defnbox"><a id="wrglossary.18462"></a><a href="#glo:glslongextraSymDescTabularHeader"><code class="csfmt">\glslongextraSymDescTabularHeader</code></a><span class="floatrightbox"><a id="wrglossary.18463"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the header for the <a id="wrglossary.18464"></a><a href="#glo:opt.glostyle.long-sym-desc"><span class="glostylefmt">long-sym-desc</span></a> style. <a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11412">457</a><p>
+<div class="defnbox"><a id="wrglossary.18465"></a><a href="#glo:glslongextraSymLocSetDescWidth"><code class="csfmt">\glslongextraSymLocSetDescWidth</code></a><span class="floatrightbox"><a id="wrglossary.18466"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Computes the value of <a id="wrglossary.18467"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a> according to the widest name for styles that show the name, symbol, <a id="wrglossary.18468"></a><a href="#glo:dual.locationlist">location list</a> and description. <a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11358">454</a><p>
+<div class="defnbox"><a id="wrglossary.18469"></a><a href="#glo:glslongextraSymNoNameSetDescWidth"><code class="csfmt">\glslongextraSymNoNameSetDescWidth</code></a><span class="floatrightbox"><a id="wrglossary.18470"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Computes the value of <a id="wrglossary.18471"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a> according to the widest name for styles that only show the symbol and description. <a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11404">457</a><p>
+<div class="defnbox"><a id="wrglossary.18472"></a><a href="#glo:glslongextraSymSetDescWidth"><code class="csfmt">\glslongextraSymSetDescWidth</code></a><span class="floatrightbox"><a id="wrglossary.18473"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Computes the value of <a id="wrglossary.18474"></a><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a> according to the widest name for styles that only show the name, symbol and description. <a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11308">450</a><p>
+<div class="defnbox"><a id="wrglossary.18475"></a><a href="#glo:glslongextraTabularVAlign"><code class="csfmt">\glslongextraTabularVAlign</code></a><span class="floatrightbox"><span class="summarytag">initial: </span>c; <a id="wrglossary.18476"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Only for use with the <a id="wrglossary.18477"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a> setting, this should expand to the <a id="wrglossary.18478"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a> environment’s vertical alignment specifier. <a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11215">445</a><p>
+<div class="defnbox"><a id="wrglossary.18479"></a><a href="#glo:glslongextraUpdateWidest"><code class="csfmt">\glslongextraUpdateWidest</code></a><code class="code">{<span class="meta">〈<em class="metainner">name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18480"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If <span class="meta">〈<em class="metainner">name</em>〉</span> is wider than the current widest name, it will be set as the new widest name. <a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11249">447</a><p>
+<div class="defnbox"><a id="wrglossary.18481"></a><a href="#glo:glslongextraUpdateWidestChild"><code class="csfmt">\glslongextraUpdateWidestChild</code></a><code class="code">{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18482"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.18483"></a><a href="#glo:glslongextraUpdateWidest"><code class="csfmt">\glslongextraUpdateWidest</code></a> but for child entries. Does nothing by default. <a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11251">447</a><p>
+<div class="defnbox"><a id="wrglossary.18484"></a><a href="#glo:GlsLongExtraUseTabularfalse"><code class="csfmt">\GlsLongExtraUseTabularfalse</code></a><span class="floatrightbox"><a id="wrglossary.18485"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets <a id="wrglossary.18486"></a><a href="#glo:ifGlsLongExtraUseTabular"><code class="csfmt">\ifGlsLongExtraUseTabular</code></a> to false (if this setting is required, the style must be set after this command). <a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11204">445</a><p>
+<div class="defnbox"><a id="wrglossary.18487"></a><a href="#glo:GlsLongExtraUseTabulartrue"><code class="csfmt">\GlsLongExtraUseTabulartrue</code></a><span class="floatrightbox"><a id="wrglossary.18488"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets <a id="wrglossary.18489"></a><a href="#glo:ifGlsLongExtraUseTabular"><code class="csfmt">\ifGlsLongExtraUseTabular</code></a> to true (if this setting is required, the style must be set after this command). <a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11201">445</a><p>
+<div class="defnbox"><a id="wrglossary.18490"></a><a href="#glo:glslongfont"><code class="csfmt">\glslongfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Font formatting command for the long form, initialised by the abbreviation style. <a href="#wrglossary.4333">172</a><p>
+<div class="defnbox"><a id="wrglossary.18491"></a><a href="#glo:glslongfootnotefont"><code class="csfmt">\glslongfootnotefont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18492"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formatting command for the long form used by the footnote abbreviation styles. <a href="#wrglossary.3597">145</a><p>
+<div class="defnbox"><a id="wrglossary.18493"></a><a href="#glo:glslonghyphenfont"><code class="csfmt">\glslonghyphenfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18494"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Long form font used by the <span class="qt">“hyphen”</span> abbreviation styles. <a href="#wrglossary.3663">148</a><p>
+<div class="defnbox"><a id="wrglossary.18495"></a><a href="#glo:glslongonlyfont"><code class="csfmt">\glslongonlyfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18496"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Long form font used by the <span class="qt">“only”</span> abbreviation styles. <a href="#wrglossary.3849">154</a><p>
+<div class="defnbox"><a id="wrglossary.18497"></a><a href="#glo:glslongpltok"><code class="csfmt">\glslongpltok</code></a></div><!-- end of defnbox -->
+<p>
+A token register that stores the long plural form (which may have been modified after being passed to <a id="wrglossary.18498"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>). <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4086">164</a><p>
+<div class="defnbox"><a id="wrglossary.18499"></a><dfn id="glo:glslongpluralaccessdisplay"><code class="csfmt">\glslongpluralaccessdisplay</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18500"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">text</em>〉</span> with the <a id="wrglossary.18501"></a><a href="#glo:opt.gloskey.longpluralaccess"><span class="csoptfmt">longpluralaccess</span></a> replacement text (if set).<p>
+<div class="defnbox"><a id="wrglossary.18502"></a><a href="#glo:glslongtok"><code class="csfmt">\glslongtok</code></a><span class="floatrightbox"><a id="wrglossary.18503"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A token register that stores the long form (which may have been modified after being passed to <a id="wrglossary.18504"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>). <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4081">164</a><p>
+<div class="defnbox"><a id="wrglossary.18505"></a><a href="#glo:glslonguserfont"><code class="csfmt">\glslonguserfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18506"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Long form font used by the <span class="qt">“user”</span> abbreviation styles. <a href="#wrglossary.3361">136</a><p>
+<div class="defnbox"><a id="wrglossary.18507"></a><a href="#glo:glslowercase"><code class="csfmt">\glslowercase</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18508"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Converts <span class="meta">〈<em class="metainner">text</em>〉</span> to <a id="wrglossary.18509"></a><a href="#glo:idx.lowercase">lowercase</a>. <a href="#sec:lowercase">§5.2.2</a>; <a href="#wrglossary.5116">200</a><p>
+<div class="defnbox"><a id="wrglossary.18510"></a><dfn id="glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18511"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.18512"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> to perform the actual case-change. As from <a id="wrglossary.18513"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+ this just uses <a id="wrglossary.18514"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.18515"></a><a href="#glo:glsmfuaddmap"><code class="csfmt">\glsmfuaddmap</code></a><code class="code">{<span class="meta">〈<em class="metainner">cs1</em>〉</span>}{<span class="meta">〈<em class="metainner">cs2</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18516"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ &amp; <a id="wrglossary.18517"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If <a id="wrglossary.18518"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+ is installed, this will use <a id="wrglossary.18519"></a><a href="#glo:MFUaddmap"><code class="csfmt">\MFUaddmap</code></a>, otherwise it will use <a id="wrglossary.18520"></a><a href="#glo:glsmfuexcl"><code class="csfmt">\glsmfuexcl</code></a> instead. See §<a href="#sec:firstuc">5.2.1</a> for further details. <a href="#sec:firstuc">§5.2.1</a>; <a href="#wrglossary.5100">199</a><p>
+<div class="defnbox"><a id="wrglossary.18521"></a><a href="#glo:glsmfublocker"><code class="csfmt">\glsmfublocker</code></a><code class="code">{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18522"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ &amp; <a id="wrglossary.18523"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If <a id="wrglossary.18524"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+ is installed, this will use <a id="wrglossary.18525"></a><a href="#glo:MFUblocker"><code class="csfmt">\MFUblocker</code></a>, otherwise it will use <a id="wrglossary.18526"></a><a href="#glo:glsmfuexcl"><code class="csfmt">\glsmfuexcl</code></a> instead. See §<a href="#sec:firstuc">5.2.1</a> for further details. <a href="#sec:firstuc">§5.2.1</a>; <a href="#wrglossary.5079">199</a><p>
+<div class="defnbox"><a id="wrglossary.18527"></a><a href="#glo:glsmfuexcl"><code class="csfmt">\glsmfuexcl</code></a><code class="code">{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18528"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ &amp; <a id="wrglossary.18529"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If <a id="wrglossary.18530"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+ is installed, this will use <a id="wrglossary.18531"></a><a href="#glo:MFUexcl"><code class="csfmt">\MFUexcl</code></a>, otherwise it will implement something similar. See §<a href="#sec:firstuc">5.2.1</a> for further details. <a href="#sec:firstuc">§5.2.1</a>; <a href="#wrglossary.5060">198</a><p>
+<div class="defnbox"><a id="wrglossary.18532"></a><dfn id="glo:GLSname"><code class="csfmt">\GLSname</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.18533"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.18534"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.18535"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.18536"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.18537"></a><a href="#glo:glsname"><code class="csfmt">\glsname</code></a> but converts the <a id="wrglossary.18538"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.18539"></a><a href="#glo:idx.allcaps">all caps</a>. This command is incompatible with some abbreviation styles.<p>
+<div class="defnbox"><a id="wrglossary.18540"></a><dfn id="glo:Glsname"><code class="csfmt">\Glsname</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.18541"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.18542"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.18543"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.18544"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.18545"></a><a href="#glo:glsname"><code class="csfmt">\glsname</code></a> but converts the <a id="wrglossary.18546"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.18547"></a><a href="#glo:idx.sentencecase">sentence case</a>. Use <a id="wrglossary.18548"></a><a href="#glo:Glossentryname"><code class="csfmt">\Glossentryname</code></a> within custom glossary styles instead of this command.<p>
+<div class="defnbox"><a id="wrglossary.18549"></a><dfn id="glo:glsname"><code class="csfmt">\glsname</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.18550"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.18551"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.18552"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.18553"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The text produced is obtained from the <a id="wrglossary.18554"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> value. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument will be inserted at the end of the <a id="wrglossary.18555"></a><a href="#glo:dual.linktext">link text</a>. This command does not alter or depend on the <a id="wrglossary.18556"></a><a href="#glo:dual.firstuseflag">first use flag</a>. For the first optional argument, see <a id="wrglossary.18557"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>. Use <a id="wrglossary.18558"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a> within custom glossary styles instead of this command.<p>
+<div class="defnbox"><a id="wrglossary.18559"></a><dfn id="glo:glsnameaccessdisplay"><code class="csfmt">\glsnameaccessdisplay</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18560"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">text</em>〉</span> with the <a id="wrglossary.18561"></a><a href="#glo:opt.gloskey.access"><span class="csoptfmt">access</span></a> replacement text (if set).<p>
+<div class="defnbox"><a id="wrglossary.18562"></a><dfn id="glo:glsnamefont"><code class="csfmt">\glsnamefont</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18563"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.18564"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a> to apply a font change to the <a id="wrglossary.18565"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, unless (with <a id="wrglossary.18566"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>) the <a id="wrglossary.18567"></a><a href="#glo:opt.catattr.glossnamefont"><span class="csoptfmt">glossnamefont</span></a> attribute has been set.<p>
+<div class="defnbox"><a id="wrglossary.18568"></a><dfn id="glo:glsnextpages"><code class="csfmt">\glsnextpages</code></dfn><span class="floatrightbox"><a id="wrglossary.18569"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.0+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Designed for use with <a id="wrglossary.18570"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.18571"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, this may be placed in an entry’s description to override <a id="wrglossary.18572"></a><a href="#glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></a>.<p>
+<div class="defnbox"><a id="wrglossary.18573"></a><dfn id="glo:glsnoexpandfields"><code class="csfmt">\glsnoexpandfields</code></dfn><span class="floatrightbox"><a id="wrglossary.18574"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.08a+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Don’t expand field values when defining entries, except for those that explicitly have expansion enabled with <a id="wrglossary.18575"></a><a href="#glo:glssetexpandfield"><code class="csfmt">\glssetexpandfield</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.18576"></a><a href="#glo:glsnoidxdisplayloc"><code class="csfmt">\glsnoidxdisplayloc</code></a><code class="code">{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18577"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display a location in the location list. <a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13565">556</a><p>
+<div class="defnbox"><a id="wrglossary.18578"></a><dfn id="glo:glsnonextpages"><code class="csfmt">\glsnonextpages</code></dfn><span class="floatrightbox"><a id="wrglossary.18579"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Designed for use with <a id="wrglossary.18580"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.18581"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, this may be placed in an entry’s description to suppress the entry’s <a id="wrglossary.18582"></a><a href="#glo:dual.locationlist">location list</a>.<p>
+<div class="defnbox"><a id="wrglossary.18583"></a><dfn id="glo:glsnumberformat"><code class="csfmt">\glsnumberformat</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">location(s)</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18584"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The default <a id="wrglossary.18585"></a><a href="#glo:@@glslabel@locationencap">format</a> for <a id="wrglossary.18586"></a><a href="#glo:dual.entrylocation">entry locations</a>. If hyperlinks are defined, this will use <a id="wrglossary.18587"></a><a href="#glo:glshypernumber"><code class="csfmt">\glshypernumber</code></a> otherwise it will simply display its argument, which may be a single <a id="wrglossary.18588"></a><a href="#glo:@@glslabel@entrylocation">location</a>, or locations delimited by <a id="wrglossary.18589"></a><a href="#glo:delimR"><code class="csfmt">\delimR</code></a> or <a id="wrglossary.18590"></a><a href="#glo:delimN"><code class="csfmt">\delimN</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.18591"></a><dfn id="glo:glsnumbersgroupname"><code class="csfmt">\glsnumbersgroupname</code></dfn><span class="floatrightbox"><span class="summarytag">initial: </span>Numbers; <a id="wrglossary.18592"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(language-sensitive)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Expands to the title of the <code class="code">numbers</code> <a id="wrglossary.18593"></a><a href="#glo:idx.group">group</a> and (if the <a id="wrglossary.18594"></a><a href="#glo:opt.numbers"><span class="styoptfmt">numbers</span></a> package option is used) the <code class="code">numbers</code> <a id="wrglossary.18595"></a><a href="#glo:dual.glossary">glossary</a>.<p>
+<div class="defnbox"><a id="wrglossary.18596"></a><dfn id="glo:glspagelistwidth"><code class="csfmt">\glspagelistwidth</code></dfn><span class="floatrightbox"><a id="wrglossary.18597"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a> &amp; <a id="wrglossary.18598"></a><a href="#glo:pkg.glossary-super"><span class="styfmt">glossary-super</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A length register used to set the width of the <a id="wrglossary.18599"></a><a href="#glo:dual.locationlist">location list</a> column for <a id="wrglossary.18600"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>-like styles.<p>
+<div class="defnbox"><a id="wrglossary.18601"></a><dfn id="glo:glspar"><code class="csfmt">\glspar</code></dfn><span class="floatrightbox"><a id="wrglossary.18602"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Paragraph break (for instances where <a id="wrglossary.18603"></a><a href="#glo:par"><code class="csfmt">\par</code></a> can’t be used directly).<p>
+<div class="defnbox"><a id="wrglossary.18604"></a><a href="#glo:glspdffmtfull"><code class="csfmt">\glspdffmtfull</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18605"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Shortcut for <code class="code"><a id="wrglossary.18606"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>} (<a id="wrglossary.18607"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>})</code> for use in PDF bookmarks or other text-only contexts. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5401">210</a><p>
+<div class="defnbox"><a id="wrglossary.18608"></a><a href="#glo:glspdffmtfullpl"><code class="csfmt">\glspdffmtfullpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18609"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Shortcut for <code class="code"><a id="wrglossary.18610"></a><a href="#glo:glsentrylongpl"><code class="csfmt">\glsentrylongpl</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>} (<a id="wrglossary.18611"></a><a href="#glo:glsentryshortpl"><code class="csfmt">\glsentryshortpl</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>})</code> for use in PDF bookmarks or other text-only contexts. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5405">210</a><p>
+<div class="defnbox"><a id="wrglossary.18612"></a><dfn id="glo:glspercentchar"><code class="csfmt">\glspercentchar</code></dfn><span class="floatrightbox"><a id="wrglossary.18613"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.10+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to a literal percent sign.<p>
+<div class="defnbox"><a id="wrglossary.18614"></a><dfn id="glo:GLSpl"><code class="csfmt">\GLSpl</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.18615"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.18616"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.18617"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.18618"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.18619"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> but converts the <a id="wrglossary.18620"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.18621"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="defnbox"><a id="wrglossary.18622"></a><dfn id="glo:Glspl"><code class="csfmt">\Glspl</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.18623"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.18624"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.18625"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.18626"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.18627"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> but converts the first character of the <a id="wrglossary.18628"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.18629"></a><a href="#glo:idx.uppercase">uppercase</a><a id="wrglossary.18630"></a> (for the start of a sentence) using <a id="wrglossary.18631"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.18632"></a><dfn id="glo:glspl"><code class="csfmt">\glspl</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.18633"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.18634"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.18635"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.18636"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.18637"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> but uses the relevant plural form.<p>
+<div class="defnbox"><a id="wrglossary.18638"></a><dfn id="glo:GLSplural"><code class="csfmt">\GLSplural</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.18639"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.18640"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.18641"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.18642"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.18643"></a><a href="#glo:glsplural"><code class="csfmt">\glsplural</code></a> but converts the <a id="wrglossary.18644"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.18645"></a><a href="#glo:idx.allcaps">all caps</a>. If you have defined the entry with <a id="wrglossary.18646"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> use <a id="wrglossary.18647"></a><a href="#glo:GLSxtrshortpl"><code class="csfmt">\GLSxtrshortpl</code></a> or <code class="code"><a id="wrglossary.18648"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a>[<a id="wrglossary.18649"></a><a href="#glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></a>]</code> instead.<p>
+<div class="defnbox"><a id="wrglossary.18650"></a><dfn id="glo:Glsplural"><code class="csfmt">\Glsplural</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.18651"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.18652"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.18653"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.18654"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.18655"></a><a href="#glo:glsplural"><code class="csfmt">\glsplural</code></a> but converts the first character of the <a id="wrglossary.18656"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.18657"></a><a href="#glo:idx.uppercase">uppercase</a><a id="wrglossary.18658"></a> (for the start of a sentence) using <a id="wrglossary.18659"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. If you have defined the entry with <a id="wrglossary.18660"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> use <a id="wrglossary.18661"></a><a href="#glo:Glsxtrshortpl"><code class="csfmt">\Glsxtrshortpl</code></a> or <code class="code"><a id="wrglossary.18662"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a>[<a id="wrglossary.18663"></a><a href="#glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></a>]</code> instead.<p>
+<div class="defnbox"><a id="wrglossary.18664"></a><dfn id="glo:glsplural"><code class="csfmt">\glsplural</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.18665"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.18666"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.18667"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.18668"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The text produced is obtained from the <a id="wrglossary.18669"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> value. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument will be inserted at the end of the <a id="wrglossary.18670"></a><a href="#glo:dual.linktext">link text</a>. This command does not alter or depend on the <a id="wrglossary.18671"></a><a href="#glo:dual.firstuseflag">first use flag</a>. If you have defined the entry with <a id="wrglossary.18672"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> use <a id="wrglossary.18673"></a><a href="#glo:glsxtrshortpl"><code class="csfmt">\glsxtrshortpl</code></a> for the short form or <code class="code"><a id="wrglossary.18674"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.18675"></a><a href="#glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></a>]</code>, as some abbreviation styles are too complicated to work with <a id="wrglossary.18676"></a><a href="#glo:glsplural"><code class="csfmt">\glsplural</code></a>. For the first optional argument, see <a id="wrglossary.18677"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>.<p>
+<div class="defnbox"><a id="wrglossary.18678"></a><dfn id="glo:glspluralaccessdisplay"><code class="csfmt">\glspluralaccessdisplay</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18679"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">text</em>〉</span> with the <a id="wrglossary.18680"></a><a href="#glo:opt.gloskey.pluralaccess"><span class="csoptfmt">pluralaccess</span></a> replacement text (if set).<p>
+<div class="defnbox"><a id="wrglossary.18681"></a><dfn id="glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></dfn></div><!-- end of defnbox -->
+<p>
+Expands to the letter <span class="qt">“s”</span> and is used to form default plurals. This command isn’t language-sensitive as there’s guarantee when it will be expanded. (It may be expanded when the entry is defined or it may be expanded when the entry is used). If you need to suppress this suffix for abbreviations, use the <a id="wrglossary.18682"></a><a href="#glo:opt.catattr.noshortplural"><span class="csoptfmt">noshortplural</span></a> attribute. If you need an apostrophe before the <span class="qt">“s”</span> for single-letter abbreviations to avoid ambiguity, use the <a id="wrglossary.18683"></a><a href="#glo:opt.catattr.aposplural"><span class="csoptfmt">aposplural</span></a> attribute.<p>
+<div class="defnbox"><a id="wrglossary.18684"></a><dfn id="glo:glspostdescription"><code class="csfmt">\glspostdescription</code></dfn><span class="floatrightbox"><a id="wrglossary.18685"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A hook that is usually placed after the description in <a id="wrglossary.18686"></a><a href="#glo:idx.glossarystyle">glossary styles</a>. Some of the styles provided with the <a id="wrglossary.18687"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package don’t use this hook. The <a id="wrglossary.18688"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> redefines those styles to include the hook. The default definition of this command tests for the <a id="wrglossary.18689"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a> option, but the <a id="wrglossary.18690"></a><a href="#glo:opt.postpunc"><span class="styoptfmt">postpunc</span></a> option redefines the command to implement the chosen punctuation.<p>
+<div class="defnbox"><a id="wrglossary.18691"></a><dfn id="glo:glspostinline"><code class="csfmt">\glspostinline</code></dfn><span class="floatrightbox"><a id="wrglossary.18692"></a><a href="#glo:pkg.glossary-inline"><span class="styfmt">glossary-inline</span></a> v3.03+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used at the end of the <a id="wrglossary.18693"></a><a href="#glo:env.theglossary"><span class="envfmt">theglossary</span></a> environment.<p>
+<div class="defnbox"><a id="wrglossary.18694"></a><dfn id="glo:glspostinlinedescformat"><code class="csfmt">\glspostinlinedescformat</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">description</em>〉</span>}{<span class="meta">〈<em class="metainner">symbol</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18695"></a><a href="#glo:pkg.glossary-inline"><span class="styfmt">glossary-inline</span></a> v3.03+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the top-level entry’s description, symbol and <a id="wrglossary.18696"></a><a href="#glo:dual.locationlist">location list</a>.<p>
+<div class="defnbox"><a id="wrglossary.18697"></a><dfn id="glo:glspostinlinesubdescformat"><code class="csfmt">\glspostinlinesubdescformat</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">description</em>〉</span>}{<span class="meta">〈<em class="metainner">symbol</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18698"></a><a href="#glo:pkg.glossary-inline"><span class="styfmt">glossary-inline</span></a> v3.03+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the child entry’s description, symbol and <a id="wrglossary.18699"></a><a href="#glo:dual.locationlist">location list</a>.<p>
+<div class="defnbox"><a id="wrglossary.18700"></a><dfn id="glo:glspostlinkhook"><code class="csfmt">\glspostlinkhook</code></dfn><span class="floatrightbox"><a id="wrglossary.18701"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.16+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A <a id="wrglossary.18702"></a><a href="#glo:dual.postlinkhook">post-link hook</a> used after all the <a id="wrglossary.18703"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.18704"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands. This is redefined by <a id="wrglossary.18705"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> to use <a id="wrglossary.18706"></a><a href="#glo:glsxtrpostlinkhook"><code class="csfmt">\glsxtrpostlinkhook</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.18707"></a><dfn id="glo:glsprefixsep"><code class="csfmt">\glsprefixsep</code></dfn><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">empty</em></span>; <a id="wrglossary.18708"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a> v4.45+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Separator between the prefix and the term.<p>
+<div class="defnbox"><a id="wrglossary.18709"></a><dfn id="glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">sort cs</em>〉</span>}{<span class="meta">〈<em class="metainner">type</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18710"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.13a+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook used with <a id="wrglossary.18711"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.18712"></a><a href="#glo:optval.sort.standard"><span class="optfmt">standard</span></a> to adjust the default sort value (with <a id="wrglossary.18713"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> or <a id="wrglossary.18714"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> only).<p>
+<div class="defnbox"><a id="wrglossary.18715"></a><a href="#glo:glspretopostlink"><code class="csfmt">\glspretopostlink</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">code</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18716"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Prepends <span class="meta">〈<em class="metainner">code</em>〉</span> to <a id="wrglossary.18717"></a><a href="#glo:dual.postlinkhook">post-link hook</a> associated with the category identified by the label <span class="meta">〈<em class="metainner">category</em>〉</span> (or simply defines it, if it doesn’t already exist). <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6381">250</a><p>
+<div class="defnbox"><a id="wrglossary.18718"></a><a href="#glo:glsps"><code class="csfmt">\glsps</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18719"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.07+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Shortcut for <code class="code"><a id="wrglossary.18720"></a><a href="#glo:glsxtrp"><code class="csfmt">\glsxtrp</code></a>{short}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>. <a href="#sec:nested">§5.4</a>; <a href="#wrglossary.5936">231</a><p>
+<div class="defnbox"><a id="wrglossary.18721"></a><a href="#glo:glspt"><code class="csfmt">\glspt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18722"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.07+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Shortcut for <code class="code"><a id="wrglossary.18723"></a><a href="#glo:glsxtrp"><code class="csfmt">\glsxtrp</code></a>{text}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>. <a href="#sec:nested">§5.4</a>; <a href="#wrglossary.5938">231</a><p>
+<div class="defnbox"><a id="wrglossary.18724"></a><dfn id="glo:glsrefentry"><code class="csfmt">\glsrefentry</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18725"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.0+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References (using <a id="wrglossary.18726"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>) the entry counter or sub-counter (if <a id="wrglossary.18727"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> or <a id="wrglossary.18728"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> options are set) otherwise just does <a id="wrglossary.18729"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}.<p>
+<div class="defnbox"><a id="wrglossary.18730"></a><a href="#glo:glsrenewcommand"><code class="csfmt">\glsrenewcommand</code></a><code class="code">{<span class="meta">〈<em class="metainner">cs</em>〉</span>}[<span class="meta">〈<em class="metainner">n</em>〉</span>][<span class="meta">〈<em class="metainner">default</em>〉</span>]{<span class="meta">〈<em class="metainner">definition</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.18731"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.18732"></a><a href="#glo:renewcommand"><code class="csfmt">\renewcommand</code></a> but only issues a warning instead of an error if the command hasn’t been defined. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13958">572</a><p>
+<div class="defnbox"><a id="wrglossary.18733"></a><dfn id="glo:glsreset"><code class="csfmt">\glsreset</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18734"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Globally resets the entry’s <a id="wrglossary.18735"></a><a href="#glo:dual.firstuseflag">first use flag</a>. That is, this marks the entry as <span class="qt">“not used”</span>.<p>
+<div class="defnbox"><a id="wrglossary.18736"></a><dfn id="glo:glsresetall"><code class="csfmt">\glsresetall</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">types</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.18737"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Globally resets all entries associated with the listed glossaries or all glossaries if <span class="meta">〈<em class="metainner">types</em>〉</span> is omitted.<p>
+<div class="defnbox"><a id="wrglossary.18738"></a><a href="#glo:glsresetcurrcountfalse"><code class="csfmt">\glsresetcurrcountfalse</code></a><span class="floatrightbox"><a id="wrglossary.18739"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets <a id="wrglossary.18740"></a><a href="#glo:ifglsresetcurrcount"><code class="csfmt">\ifglsresetcurrcount</code></a> to false. <a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.7954">308</a><p>
+<div class="defnbox"><a id="wrglossary.18741"></a><a href="#glo:glsresetcurrcounttrue"><code class="csfmt">\glsresetcurrcounttrue</code></a><span class="floatrightbox"><a id="wrglossary.18742"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets <a id="wrglossary.18743"></a><a href="#glo:ifglsresetcurrcount"><code class="csfmt">\ifglsresetcurrcount</code></a> to true. <a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.7953">308</a><p>
+<div class="defnbox"><a id="wrglossary.18744"></a><dfn id="glo:glsresetentrylist"><code class="csfmt">\glsresetentrylist</code></dfn><span class="floatrightbox"><a id="wrglossary.18745"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Inserted into the <a id="wrglossary.18746"></a><a href="#glo:dual.glossary">glossary</a> code to counteract the effect of <a id="wrglossary.18747"></a><a href="#glo:glsnonextpages"><code class="csfmt">\glsnonextpages</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.18748"></a><dfn id="glo:glssee"><code class="csfmt">\glssee</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">tag</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">xr-list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18749"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indexes the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> as a general cross-reference to the entries identified in the comma-separated list <span class="meta">〈<em class="metainner">xr-list</em>〉</span>. The optional argument is the textual tag that’s inserted before the cross-reference list and defaults to <a id="wrglossary.18750"></a><a href="#glo:seename"><code class="csfmt">\seename</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.18751"></a><a href="#glo:glsseefirstitem"><code class="csfmt">\glsseefirstitem</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18752"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.47+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.18753"></a><a href="#glo:glsseelist"><code class="csfmt">\glsseelist</code></a> to format the first entry. <a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7791">300</a><p>
+<div class="defnbox"><a id="wrglossary.18754"></a><dfn id="glo:glsseeformat"><code class="csfmt">\glsseeformat</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">tag</em>〉</span>]{<span class="meta">〈<em class="metainner">xr-list</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18755"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to format the <a id="wrglossary.18756"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> cross-reference in the <a id="wrglossary.18757"></a><a href="#glo:dual.locationlist">location list</a>. This requires a <a id="wrglossary.18758"></a><a href="#glo:@@glslabel@entrylocation">location</a> argument for <a id="wrglossary.18759"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> even though it isn’t required. The default definition is <code class="code"><code class="csfmt">\emph</code>{<span class="meta">〈<em class="metainner">tag</em>〉</span>} <a id="wrglossary.18760"></a><a href="#glo:glsseelist"><code class="csfmt">\glsseelist</code></a>{<span class="meta">〈<em class="metainner">xr-list</em>〉</span>}</code>.<p>
+<div class="defnbox"><a id="wrglossary.18761"></a><dfn id="glo:glsseeitem"><code class="csfmt">\glsseeitem</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18762"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.18763"></a><a href="#glo:glsseelist"><code class="csfmt">\glsseelist</code></a> to format each entry.<p>
+<div class="defnbox"><a id="wrglossary.18764"></a><a href="#glo:glsseeitemformat"><code class="csfmt">\glsseeitemformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18765"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.0+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.18766"></a><a href="#glo:glsseeitem"><code class="csfmt">\glsseeitem</code></a> to produce the hyperlink text. <a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7779">300</a><p>
+<div class="defnbox"><a id="wrglossary.18767"></a><a href="#glo:glsseelastoxfordsep"><code class="csfmt">\glsseelastoxfordsep</code></a><span class="floatrightbox"><a id="wrglossary.18768"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.47+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.18769"></a><a href="#glo:glsseelist"><code class="csfmt">\glsseelist</code></a> as a separator between penultimate and final entry in the list if there are at least three entries in the list. <a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7802">301</a><p>
+<div class="defnbox"><a id="wrglossary.18770"></a><a href="#glo:glsseelastsep"><code class="csfmt">\glsseelastsep</code></a><span class="floatrightbox"><a id="wrglossary.18771"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.18772"></a><a href="#glo:glsseelist"><code class="csfmt">\glsseelist</code></a> as a separator between penultimate and final entry in the list. <a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7799">301</a><p>
+<div class="defnbox"><a id="wrglossary.18773"></a><a href="#glo:glsseelist"><code class="csfmt">\glsseelist</code></a><code class="code">{<span class="meta">〈<em class="metainner">csv-list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18774"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Iterates over a comma-separated list of entry labels <span class="meta">〈<em class="metainner">csv-list</em>〉</span> and formats them. Each label in the list is encapsulated with <a id="wrglossary.18775"></a><a href="#glo:glsseeitem"><code class="csfmt">\glsseeitem</code></a> (or <a id="wrglossary.18776"></a><a href="#glo:mglsseeitem"><code class="csfmt">\mglsseeitem</code></a>, the label corresponds to a multi-entry). The separators are <a id="wrglossary.18777"></a><a href="#glo:glsseelastsep"><code class="csfmt">\glsseelastsep</code></a> (between the penultimate and last items) and <a id="wrglossary.18778"></a><a href="#glo:glsseesep"><code class="csfmt">\glsseesep</code></a> (between all the other items). With <a id="wrglossary.18779"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, the first label is encapsulated with <a id="wrglossary.18780"></a><a href="#glo:glsseefirstitem"><code class="csfmt">\glsseefirstitem</code></a> (or <a id="wrglossary.18781"></a><a href="#glo:mglsseefirstitem"><code class="csfmt">\mglsseefirstitem</code></a>) and the final separator for a list consisting of at least three items is given by <a id="wrglossary.18782"></a><a href="#glo:glsseelastoxfordsep"><code class="csfmt">\glsseelastoxfordsep</code></a>. <a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7766">299</a><p>
+<div class="defnbox"><a id="wrglossary.18783"></a><a href="#glo:glsseesep"><code class="csfmt">\glsseesep</code></a><span class="floatrightbox"><span class="summarytag">initial: </span>,␣; <a id="wrglossary.18784"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.18785"></a><a href="#glo:glsseelist"><code class="csfmt">\glsseelist</code></a> as a separator between each entry except the last pair. <a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7798">301</a><p>
+<div class="defnbox"><a id="wrglossary.18786"></a><a href="#glo:glssentencecase"><code class="csfmt">\glssentencecase</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18787"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ &amp; <a id="wrglossary.18788"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.18789"></a><a href="#glo:idx.sentencecase">sentence case</a> commands, such as <a id="wrglossary.18790"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>, to perform the case change. This is simply defined to use <a id="wrglossary.18791"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. <a href="#sec:firstuc">§5.2.1</a>; <a href="#wrglossary.5011">197</a><p>
+<div class="defnbox"><a id="wrglossary.18792"></a><a href="#glo:glssetabbrvfmt"><code class="csfmt">\glssetabbrvfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Implements the <span class="meta">〈<em class="metainner">display definitions</em>〉</span> code for the abbreviation style associated with the given category. <a href="#sec:advancedabbrstylecmds">§4.5.2</a>; <a href="#wrglossary.3948">159</a><p>
+<div class="defnbox"><a id="wrglossary.18793"></a><a href="#glo:glssetattribute"><code class="csfmt">\glssetattribute</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Locally sets the given attribute to <span class="meta">〈<em class="metainner">value</em>〉</span> for the category associated with the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. <a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12331">504</a><p>
+<div class="defnbox"><a id="wrglossary.18794"></a><a href="#glo:glssetcategoriesattribute"><code class="csfmt">\glssetcategoriesattribute</code></a><code class="code">{<span class="meta">〈<em class="metainner">category list</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18795"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Globally sets the given attribute to <span class="meta">〈<em class="metainner">value</em>〉</span> for all the categories in the comma-separated list <span class="meta">〈<em class="metainner">category list</em>〉</span>. <a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12328">504</a><p>
+<div class="defnbox"><a id="wrglossary.18796"></a><a href="#glo:glssetcategoriesattributes"><code class="csfmt">\glssetcategoriesattributes</code></a><code class="code">{<span class="meta">〈<em class="metainner">category list</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute list</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18797"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Globally sets each attribute in the comma separated <span class="meta">〈<em class="metainner">attribute list</em>〉</span> to <span class="meta">〈<em class="metainner">value</em>〉</span> for each category in the comma-separated list <span class="meta">〈<em class="metainner">category list</em>〉</span>. <a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12330">504</a><p>
+<div class="defnbox"><a id="wrglossary.18798"></a><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Locally sets the given attribute to <span class="meta">〈<em class="metainner">value</em>〉</span> for the given category. <a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12327">504</a><p>
+<div class="defnbox"><a id="wrglossary.18799"></a><a href="#glo:glssetcategoryattributes"><code class="csfmt">\glssetcategoryattributes</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute list</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18800"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Globally sets each attribute in the comma separated <span class="meta">〈<em class="metainner">attribute list</em>〉</span> to <span class="meta">〈<em class="metainner">value</em>〉</span> for the given <span class="meta">〈<em class="metainner">category</em>〉</span>. <a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12329">504</a><p>
+<div class="defnbox"><a id="wrglossary.18801"></a><a href="#glo:glssetcombinedsepabbrvnbsp"><code class="csfmt">\glssetcombinedsepabbrvnbsp</code></a><span class="floatrightbox"><a id="wrglossary.18802"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines the multi-entry separators to use a <a id="wrglossary.18803"></a><a href="#glo:idx.nbsp">non-breaking space (<code class="code">~</code>)</a> for abbreviations. <a href="#sec:mglssep">§7.4</a>; <a href="#wrglossary.8707">345</a><p>
+<div class="defnbox"><a id="wrglossary.18804"></a><a href="#glo:glssetcombinedsepabbrvnone"><code class="csfmt">\glssetcombinedsepabbrvnone</code></a><span class="floatrightbox"><a id="wrglossary.18805"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines the multi-entry separators to use no separator for abbreviations. <a href="#sec:mglssep">§7.4</a>; <a href="#wrglossary.8733">345</a><p>
+<div class="defnbox"><a id="wrglossary.18806"></a><a href="#glo:glssetcombinedsepnarrow"><code class="csfmt">\glssetcombinedsepnarrow</code></a><code class="code">{<span class="meta">〈<em class="metainner">width</em>〉</span>}{<span class="meta">〈<em class="metainner">narrow-sep</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18807"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines the multi-entry separators to use <span class="meta">〈<em class="metainner">narrow-sep</em>〉</span> if the width of associated field values is less than <span class="meta">〈<em class="metainner">width</em>〉</span>. <a href="#sec:mglssep">§7.4</a>; <a href="#wrglossary.8758">346</a><p>
+<div class="defnbox"><a id="wrglossary.18808"></a><dfn id="glo:glssetexpandfield"><code class="csfmt">\glssetexpandfield</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">field</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18809"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.13a+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expand the value of the field identified by its <a id="wrglossary.18810"></a><a href="#glo:dual.internalfieldlabel">internal field label</a> when defining entries (overrides <a id="wrglossary.18811"></a><a href="#glo:glsnoexpandfields"><code class="csfmt">\glsnoexpandfields</code></a>).<p>
+<div class="defnbox"><a id="wrglossary.18812"></a><dfn id="glo:glssetnoexpandfield"><code class="csfmt">\glssetnoexpandfield</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">field</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18813"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.13a+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Don’t expand the value of the field identified by its <a id="wrglossary.18814"></a><a href="#glo:dual.internalfieldlabel">internal field label</a> when defining entries (overrides <a id="wrglossary.18815"></a><a href="#glo:glsexpandfields"><code class="csfmt">\glsexpandfields</code></a>).<p>
+<div class="defnbox"><a id="wrglossary.18816"></a><a href="#glo:glssetregularcategory"><code class="csfmt">\glssetregularcategory</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Locally sets the <a id="wrglossary.18817"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute to <code class="code">true</code> for the given category. <a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12332">504</a><p>
+<div class="defnbox"><a id="wrglossary.18818"></a><dfn id="glo:glssetwidest"><code class="csfmt">\glssetwidest</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">level</em>〉</span>]{<span class="meta">〈<em class="metainner">name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18819"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indicates that <span class="meta">〈<em class="metainner">name</em>〉</span> is the widest name for the given <a id="wrglossary.18820"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a>.<p>
+<div class="defnbox"><a id="wrglossary.18821"></a><dfn id="glo:glsshortaccessdisplay"><code class="csfmt">\glsshortaccessdisplay</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18822"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">text</em>〉</span> with the <a id="wrglossary.18823"></a><a href="#glo:opt.gloskey.shortaccess"><span class="csoptfmt">shortaccess</span></a> replacement text (if set).<p>
+<div class="defnbox"><a id="wrglossary.18824"></a><dfn id="glo:glsshortaccsupp"><code class="csfmt">\glsshortaccsupp</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">replacement</em>〉</span>}{<span class="meta">〈<em class="metainner">content</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18825"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> v4.45+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Applies <span class="meta">〈<em class="metainner">replacement</em>〉</span> as the expansion (E) attribute for <span class="meta">〈<em class="metainner">content</em>〉</span> using <a id="wrglossary.18826"></a><a href="#glo:glsaccessibility"><code class="csfmt">\glsaccessibility</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.18827"></a><a href="#glo:glsshortpltok"><code class="csfmt">\glsshortpltok</code></a></div><!-- end of defnbox -->
+<p>
+A token register that stores the short plural form (which may have been modified after being passed to <a id="wrglossary.18828"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>). <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4078">164</a><p>
+<div class="defnbox"><a id="wrglossary.18829"></a><dfn id="glo:glsshortpluralaccessdisplay"><code class="csfmt">\glsshortpluralaccessdisplay</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18830"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">text</em>〉</span> with the <a id="wrglossary.18831"></a><a href="#glo:opt.gloskey.shortpluralaccess"><span class="csoptfmt">shortpluralaccess</span></a> replacement text (if set).<p>
+<div class="defnbox"><a id="wrglossary.18832"></a><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a><span class="floatrightbox"><a id="wrglossary.18833"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A token register that stores the short form (which may have been modified after being passed to <a id="wrglossary.18834"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>). <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4073">164</a><p>
+<div class="defnbox"><a id="wrglossary.18835"></a><dfn id="glo:glsshowtarget"><code class="csfmt">\glsshowtarget</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">target-name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18836"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.32+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the target name when <a id="wrglossary.18837"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.18838"></a><a href="#glo:optval.debug.showtargets"><span class="optfmt">showtargets</span></a> is enabled using either <a id="wrglossary.18839"></a><a href="#glo:glsshowtargetinner"><code class="csfmt">\glsshowtargetinner</code></a> or <a id="wrglossary.18840"></a><a href="#glo:glsshowtargetouter"><code class="csfmt">\glsshowtargetouter</code></a>, depending on the current mode.<p>
+<div class="defnbox"><a id="wrglossary.18841"></a><dfn id="glo:glsshowtargetfont"><code class="csfmt">\glsshowtargetfont</code></dfn><span class="floatrightbox"><a id="wrglossary.18842"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.45+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Font declaration used by debugging annotations.<p>
+<div class="defnbox"><a id="wrglossary.18843"></a><dfn id="glo:glsshowtargetfonttext"><code class="csfmt">\glsshowtargetfonttext</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18844"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Text-block command that checks for math mode and switches to the font given by the <a id="wrglossary.18845"></a><a href="#glo:glsshowtargetfont"><code class="csfmt">\glsshowtargetfont</code></a> declaration.<p>
+<div class="defnbox"><a id="wrglossary.18846"></a><dfn id="glo:glsshowtargetinner"><code class="csfmt">\glsshowtargetinner</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">target-name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18847"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the target name for inner and maths mode when <a id="wrglossary.18848"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.18849"></a><a href="#glo:optval.debug.showtargets"><span class="optfmt">showtargets</span></a> is enabled.<p>
+<div class="defnbox"><a id="wrglossary.18850"></a><a href="#glo:glsshowtargetinnersymleft"><code class="csfmt">\glsshowtargetinnersymleft</code></a><code class="code">{name}</code><span class="floatrightbox"><a id="wrglossary.18851"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Shows the left inner annotation followed by the left marker symbol <a id="wrglossary.18852"></a><a href="#glo:glsxtrshowtargetsymbolleft"><code class="csfmt">\glsxtrshowtargetsymbolleft</code></a>. <a href="#sec:debuggingopts">§2.5</a>; <a href="#wrglossary.906">30</a><p>
+<div class="defnbox"><a id="wrglossary.18853"></a><a href="#glo:glsshowtargetinnersymright"><code class="csfmt">\glsshowtargetinnersymright</code></a><code class="code">{name}</code><span class="floatrightbox"><a id="wrglossary.18854"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Shows the right marker symbol <a id="wrglossary.18855"></a><a href="#glo:glsxtrshowtargetsymbolright"><code class="csfmt">\glsxtrshowtargetsymbolright</code></a> followed by the right inner annotation. <a href="#sec:debuggingopts">§2.5</a>; <a href="#wrglossary.908">30</a><p>
+<div class="defnbox"><a id="wrglossary.18856"></a><dfn id="glo:glsshowtargetouter"><code class="csfmt">\glsshowtargetouter</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">target-name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18857"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the target name for outer mode when <a id="wrglossary.18858"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.18859"></a><a href="#glo:optval.debug.showtargets"><span class="optfmt">showtargets</span></a> is enabled. This places a marker (<a id="wrglossary.18860"></a><a href="#glo:glsshowtargetsymbol"><code class="csfmt">\glsshowtargetsymbol</code></a>) in the text and <span class="meta">〈<em class="metainner">target-name</em>〉</span> in the margin.<p>
+<div class="defnbox"><a id="wrglossary.18861"></a><dfn id="glo:glsshowtargetsymbol"><code class="csfmt">\glsshowtargetsymbol</code></dfn><span class="floatrightbox"><a id="wrglossary.18862"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.45+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Marker (◁) used in debugging annotations.<p>
+<div class="defnbox"><a id="wrglossary.18863"></a><dfn id="glo:glssubentryitem"><code class="csfmt">\glssubentryitem</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18864"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.0+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does nothing if <a id="wrglossary.18865"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a><span class="optfmt">=false</span>, otherwise increments and displays the associated counter.<p>
+<div class="defnbox"><a id="wrglossary.18866"></a><a href="#glo:glssubgroupheading"><code class="csfmt">\glssubgroupheading</code></a><code class="code">{<span class="meta">〈<em class="metainner">previous level</em>〉</span>}{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">parent-label</em>〉</span>}{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18867"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to format sub-<a id="wrglossary.18868"></a><a href="#glo:idx.group">group</a> headings. Only applicable with the <a id="wrglossary.18869"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>. This command won’t occur in <a id="wrglossary.18870"></a><a href="#glo:dual.glossary">glossaries</a> that use <a id="wrglossary.18871"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> or <a id="wrglossary.18872"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>. <a href="#sec:printunsrtgroups">§8.4.1</a>; <a href="#wrglossary.9985">393</a><p>
+<div class="defnbox"><a id="wrglossary.18873"></a><dfn id="glo:GLSsymbol"><code class="csfmt">\GLSsymbol</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.18874"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.18875"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.18876"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.18877"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.18878"></a><a href="#glo:glssymbol"><code class="csfmt">\glssymbol</code></a> but converts the <a id="wrglossary.18879"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.18880"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="defnbox"><a id="wrglossary.18881"></a><dfn id="glo:Glssymbol"><code class="csfmt">\Glssymbol</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.18882"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.18883"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.18884"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.18885"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.18886"></a><a href="#glo:glssymbol"><code class="csfmt">\glssymbol</code></a> but converts the <a id="wrglossary.18887"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.18888"></a><a href="#glo:idx.sentencecase">sentence case</a>. Use <a id="wrglossary.18889"></a><a href="#glo:Glossentrysymbol"><code class="csfmt">\Glossentrysymbol</code></a> within custom glossary styles instead of this command.<p>
+<div class="defnbox"><a id="wrglossary.18890"></a><dfn id="glo:glssymbol"><code class="csfmt">\glssymbol</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.18891"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.18892"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.18893"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.18894"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The text produced is obtained from the <a id="wrglossary.18895"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> value. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument will be inserted at the end of the <a id="wrglossary.18896"></a><a href="#glo:dual.linktext">link text</a>. This command does not alter or depend on the <a id="wrglossary.18897"></a><a href="#glo:dual.firstuseflag">first use flag</a>. For the first optional argument, see <a id="wrglossary.18898"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>. Use <a id="wrglossary.18899"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a> within custom glossary styles instead of this command.<p>
+<div class="defnbox"><a id="wrglossary.18900"></a><dfn id="glo:glssymbolaccessdisplay"><code class="csfmt">\glssymbolaccessdisplay</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18901"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">text</em>〉</span> with the <a id="wrglossary.18902"></a><a href="#glo:opt.gloskey.symbolaccess"><span class="csoptfmt">symbolaccess</span></a> replacement text (if set).<p>
+<div class="defnbox"><a id="wrglossary.18903"></a><dfn id="glo:glssymbolplural"><code class="csfmt">\glssymbolplural</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.18904"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.18905"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.18906"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.18907"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.18908"></a><a href="#glo:glssymbol"><code class="csfmt">\glssymbol</code></a> but for the <a id="wrglossary.18909"></a><a href="#glo:opt.gloskey.symbolplural"><span class="csoptfmt">symbolplural</span></a> field.<p>
+<div class="defnbox"><a id="wrglossary.18910"></a><dfn id="glo:glssymbolpluralaccessdisplay"><code class="csfmt">\glssymbolpluralaccessdisplay</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18911"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">text</em>〉</span> with the <a id="wrglossary.18912"></a><a href="#glo:opt.gloskey.symbolpluralaccess"><span class="csoptfmt">symbolpluralaccess</span></a> replacement text (if set).<p>
+<div class="defnbox"><a id="wrglossary.18913"></a><dfn id="glo:glssymbolsgroupname"><code class="csfmt">\glssymbolsgroupname</code></dfn><span class="floatrightbox"><span class="summarytag">initial: </span>Symbols; <a id="wrglossary.18914"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(language-sensitive)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Expands to the title of the <code class="code">symbols</code> <a id="wrglossary.18915"></a><a href="#glo:idx.group">group</a> and (if the <a id="wrglossary.18916"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a> package option is used) the <code class="code">symbols</code> <a id="wrglossary.18917"></a><a href="#glo:dual.glossary">glossary</a>.<p>
+<div class="defnbox"><a id="wrglossary.18918"></a><a href="#glo:glstabledescheader"><code class="csfmt">\glstabledescheader</code></a><span class="floatrightbox"><a id="wrglossary.18919"></a><a href="#glo:pkg.glossary-table"><span class="styfmt">glossary-table</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Header for the description column. <a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11596">469</a><p>
+<div class="defnbox"><a id="wrglossary.18920"></a><a href="#glo:glstableiffilter"><code class="csfmt">\glstableiffilter</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18921"></a><a href="#glo:pkg.glossary-table"><span class="styfmt">glossary-table</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Internally used by the custom handler in <a id="wrglossary.18922"></a><a href="#glo:printunsrttable"><code class="csfmt">\printunsrttable</code></a> to perform additional filtering. <a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11573">468</a><p>
+<div class="defnbox"><a id="wrglossary.18923"></a><a href="#glo:glstablenameheader"><code class="csfmt">\glstablenameheader</code></a><span class="floatrightbox"><a id="wrglossary.18924"></a><a href="#glo:pkg.glossary-table"><span class="styfmt">glossary-table</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Header for the name column. <a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11594">469</a><p>
+<div class="defnbox"><a id="wrglossary.18925"></a><a href="#glo:glstableotherheader"><code class="csfmt">\glstableotherheader</code></a><span class="floatrightbox"><a id="wrglossary.18926"></a><a href="#glo:pkg.glossary-table"><span class="styfmt">glossary-table</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Header for the other column. <a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11604">470</a><p>
+<div class="defnbox"><a id="wrglossary.18927"></a><a href="#glo:glstablesymbolheader"><code class="csfmt">\glstablesymbolheader</code></a><span class="floatrightbox"><a id="wrglossary.18928"></a><a href="#glo:pkg.glossary-table"><span class="styfmt">glossary-table</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Header for the symbol column. <a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11600">469</a><p>
+<div class="defnbox"><a id="wrglossary.18929"></a><dfn id="glo:glstarget"><code class="csfmt">\glstarget</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18930"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v1.18+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.18931"></a><a href="#glo:idx.glossarystyle">glossary styles</a> to create a hypertarget (if enabled) for the entry (identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>). The <span class="meta">〈<em class="metainner">text</em>〉</span> is usually <a id="wrglossary.18932"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}, but it can be something else.<p>
+<div class="defnbox"><a id="wrglossary.18933"></a><dfn id="glo:GLStext"><code class="csfmt">\GLStext</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.18934"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.18935"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.18936"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.18937"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.18938"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> but converts the <a id="wrglossary.18939"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.18940"></a><a href="#glo:idx.allcaps">all caps</a>. If you have defined the entry with <a id="wrglossary.18941"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> use <a id="wrglossary.18942"></a><a href="#glo:GLSxtrshort"><code class="csfmt">\GLSxtrshort</code></a> or <code class="code"><a id="wrglossary.18943"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a>[<a id="wrglossary.18944"></a><a href="#glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></a>]</code> instead.<p>
+<div class="defnbox"><a id="wrglossary.18945"></a><dfn id="glo:Glstext"><code class="csfmt">\Glstext</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.18946"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.18947"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.18948"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.18949"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.18950"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> but converts the first character of the <a id="wrglossary.18951"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.18952"></a><a href="#glo:idx.uppercase">uppercase</a><a id="wrglossary.18953"></a> (for the start of a sentence) using <a id="wrglossary.18954"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. If you have defined the entry with <a id="wrglossary.18955"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> use <a id="wrglossary.18956"></a><a href="#glo:Glsxtrshort"><code class="csfmt">\Glsxtrshort</code></a> or <code class="code"><a id="wrglossary.18957"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>[<a id="wrglossary.18958"></a><a href="#glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></a>]</code> instead.<p>
+<div class="defnbox"><a id="wrglossary.18959"></a><dfn id="glo:glstext"><code class="csfmt">\glstext</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.18960"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.18961"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.18962"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.18963"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The text produced is obtained from the <a id="wrglossary.18964"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> value. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument will be inserted at the end of the <a id="wrglossary.18965"></a><a href="#glo:dual.linktext">link text</a>. This command does not alter or depend on the <a id="wrglossary.18966"></a><a href="#glo:dual.firstuseflag">first use flag</a>. If you have defined the entry with <a id="wrglossary.18967"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> use <a id="wrglossary.18968"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> for the short form or <code class="code"><a id="wrglossary.18969"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.18970"></a><a href="#glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></a>]</code>, as some abbreviation styles are too complicated to work with <a id="wrglossary.18971"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>. For the first optional argument, see <a id="wrglossary.18972"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>.<p>
+<div class="defnbox"><a id="wrglossary.18973"></a><dfn id="glo:glstextaccessdisplay"><code class="csfmt">\glstextaccessdisplay</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18974"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">text</em>〉</span> with the <a id="wrglossary.18975"></a><a href="#glo:opt.gloskey.textaccess"><span class="csoptfmt">textaccess</span></a> replacement text (if set).<p>
+<div class="defnbox"><a id="wrglossary.18976"></a><dfn id="glo:glstextformat"><code class="csfmt">\glstextformat</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18977"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The default outer text formatting command used by the <a id="wrglossary.18978"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.18979"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands.<p>
+<div class="defnbox"><a id="wrglossary.18980"></a><dfn id="glo:glstextup"><code class="csfmt">\glstextup</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18981"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.09a+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Counteracts the effect of <a id="wrglossary.18982"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.18983"></a><dfn id="glo:glstildechar"><code class="csfmt">\glstildechar</code></dfn><span class="floatrightbox"><a id="wrglossary.18984"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.10+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to a literal tilde character.<p>
+<div class="defnbox"><a id="wrglossary.18985"></a><a href="#glo:glstopicAssignSubIndent"><code class="csfmt">\glstopicAssignSubIndent</code></a><code class="code">{<span class="meta">〈<em class="metainner">level</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18986"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.40+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to set the indentation for sub-levels. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11550">467</a><p>
+<div class="defnbox"><a id="wrglossary.18987"></a><a href="#glo:glstopicAssignWidest"><code class="csfmt">\glstopicAssignWidest</code></a><code class="code">{<span class="meta">〈<em class="metainner">level</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18988"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.40+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.18989"></a><a href="#glo:glstopicAssignSubIndent"><code class="csfmt">\glstopicAssignSubIndent</code></a> to calculate the width of the widest name for the given level. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11551">467</a><p>
+<div class="defnbox"><a id="wrglossary.18990"></a><a href="#glo:glstopicCols"><code class="csfmt">\glstopicCols</code></a><span class="floatrightbox"><a id="wrglossary.18991"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.40+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the number of columns for <a id="wrglossary.18992"></a><a href="#glo:opt.glostyle.topicmcols"><span class="glostylefmt">topicmcols</span></a>. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11504">462</a><p>
+<div class="defnbox"><a id="wrglossary.18993"></a><a href="#glo:glstopicColsEnv"><code class="csfmt">\glstopicColsEnv</code></a><span class="floatrightbox"><a id="wrglossary.18994"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.40+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the <a id="wrglossary.18995"></a><a href="#glo:env.multicols"><span class="envfmt">multicols</span></a> environment name to use for <a id="wrglossary.18996"></a><a href="#glo:opt.glostyle.topicmcols"><span class="glostylefmt">topicmcols</span></a>. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11502">462</a><p>
+<div class="defnbox"><a id="wrglossary.18997"></a><a href="#glo:glstopicDesc"><code class="csfmt">\glstopicDesc</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.18998"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.40+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to format the top-level description. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11544">466</a><p>
+<div class="defnbox"><a id="wrglossary.18999"></a><a href="#glo:glstopicGroupHeading"><code class="csfmt">\glstopicGroupHeading</code></a><code class="code">{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19000"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.40+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to format the top-level group headings, if required. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11520">465</a><p>
+<div class="defnbox"><a id="wrglossary.19001"></a><a href="#glo:glstopicInit"><code class="csfmt">\glstopicInit</code></a><span class="floatrightbox"><a id="wrglossary.19002"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.40+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Initialisation hook. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11518">465</a><p>
+<div class="defnbox"><a id="wrglossary.19003"></a><a href="#glo:glstopicItem"><code class="csfmt">\glstopicItem</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19004"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.40+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to format top-level entries. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11534">465</a><p>
+<div class="defnbox"><a id="wrglossary.19005"></a><a href="#glo:glstopicLoc"><code class="csfmt">\glstopicLoc</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19006"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.40+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to format the top-level <a id="wrglossary.19007"></a><a href="#glo:dual.locationlist">location list</a>. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11548">467</a><p>
+<div class="defnbox"><a id="wrglossary.19008"></a><a href="#glo:glstopicMarker"><code class="csfmt">\glstopicMarker</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19009"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.40+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook inserted before a top-level entry. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11537">466</a><p>
+<div class="defnbox"><a id="wrglossary.19010"></a><a href="#glo:glstopicMidSkip"><code class="csfmt">\glstopicMidSkip</code></a><span class="floatrightbox"><a id="wrglossary.19011"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.40+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Vertical space inserted before the description for a top-level entry. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11543">466</a><p>
+<div class="defnbox"><a id="wrglossary.19012"></a><a href="#glo:glstopicParIndent"><code class="csfmt">\glstopicParIndent</code></a><span class="floatrightbox"><a id="wrglossary.19013"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.40+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Length register used for the top-level paragraph indent. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11512">463</a><p>
+<div class="defnbox"><a id="wrglossary.19014"></a><a href="#glo:glstopicPostSkip"><code class="csfmt">\glstopicPostSkip</code></a><span class="floatrightbox"><a id="wrglossary.19015"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.40+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Vertical space inserted after the description for a top-level entry. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11547">466</a><p>
+<div class="defnbox"><a id="wrglossary.19016"></a><a href="#glo:glstopicPreSkip"><code class="csfmt">\glstopicPreSkip</code></a><span class="floatrightbox"><a id="wrglossary.19017"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.40+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Vertical space inserted before a top-level entry. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11536">466</a><p>
+<div class="defnbox"><a id="wrglossary.19018"></a><a href="#glo:glstopicSubGroupHeading"><code class="csfmt">\glstopicSubGroupHeading</code></a><code class="code">{<span class="meta">〈<em class="metainner">prev group level</em>〉</span>}{<span class="meta">〈<em class="metainner">group level</em>〉</span>}{<span class="meta">〈<em class="metainner">parent entry</em>〉</span>}{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19019"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to format the sub-group headings, if supported. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11531">465</a><p>
+<div class="defnbox"><a id="wrglossary.19020"></a><a href="#glo:glstopicSubIndent"><code class="csfmt">\glstopicSubIndent</code></a><span class="floatrightbox"><a id="wrglossary.19021"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.40+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Length register used for the child indent. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11513">464</a><p>
+<div class="defnbox"><a id="wrglossary.19022"></a><a href="#glo:glstopicSubItem"><code class="csfmt">\glstopicSubItem</code></a><code class="code">{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19023"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.40+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to format child entries. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11552">467</a><p>
+<div class="defnbox"><a id="wrglossary.19024"></a><a href="#glo:glstopicSubItemBox"><code class="csfmt">\glstopicSubItemBox</code></a><code class="code">{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19025"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.40+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Horizontal box used for child name if a widest name has been provided. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11555">467</a><p>
+<div class="defnbox"><a id="wrglossary.19026"></a><a href="#glo:glstopicSubItemParIndent"><code class="csfmt">\glstopicSubItemParIndent</code></a><span class="floatrightbox"><a id="wrglossary.19027"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.46+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Length register used for the child paragraph indent. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11515">464</a><p>
+<div class="defnbox"><a id="wrglossary.19028"></a><a href="#glo:glstopicSubItemSep"><code class="csfmt">\glstopicSubItemSep</code></a><span class="floatrightbox"><a id="wrglossary.19029"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.40+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Horizontal separator used after child names. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11554">467</a><p>
+<div class="defnbox"><a id="wrglossary.19030"></a><a href="#glo:glstopicSubLoc"><code class="csfmt">\glstopicSubLoc</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19031"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.41+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the child <a id="wrglossary.19032"></a><a href="#glo:dual.locationlist">location lists</a>. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11558">468</a><p>
+<div class="defnbox"><a id="wrglossary.19033"></a><a href="#glo:glstopicSubNameFont"><code class="csfmt">\glstopicSubNameFont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19034"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.40+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Font command to apply to the child entry name. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11553">467</a><p>
+<div class="defnbox"><a id="wrglossary.19035"></a><a href="#glo:glstopicSubPreLocSep"><code class="csfmt">\glstopicSubPreLocSep</code></a><span class="floatrightbox"><a id="wrglossary.19036"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.41+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Separator before the child <a id="wrglossary.19037"></a><a href="#glo:dual.locationlist">location lists</a>. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11557">468</a><p>
+<div class="defnbox"><a id="wrglossary.19038"></a><a href="#glo:glstopicTitle"><code class="csfmt">\glstopicTitle</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19039"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.40+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to format the name and (if provided) symbol for the top-level entry title. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11538">466</a><p>
+<div class="defnbox"><a id="wrglossary.19040"></a><a href="#glo:glstopicTitleFont"><code class="csfmt">\glstopicTitleFont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19041"></a><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span></a> v1.40+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Font command to apply to the top-level entry title. <a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11541">466</a><p>
+<div class="defnbox"><a id="wrglossary.19042"></a><a href="#glo:glstreechilddesc"><code class="csfmt">\glstreechilddesc</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19043"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the given child entry’s description with pre and post hooks for the <a id="wrglossary.19044"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a> styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10992">433</a><p>
+<div class="defnbox"><a id="wrglossary.19045"></a><a href="#glo:glstreeChildDescLoc"><code class="csfmt">\glstreeChildDescLoc</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19046"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.41+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the child description (if set) and <a id="wrglossary.19047"></a><a href="#glo:dual.locationlist">location list</a> for the <a id="wrglossary.19048"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a> styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10997">433</a><p>
+<div class="defnbox"><a id="wrglossary.19049"></a><a href="#glo:glstreechildpredesc"><code class="csfmt">\glstreechildpredesc</code></a><span class="floatrightbox"><a id="wrglossary.19050"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a> v4.26+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Space inserted before child descriptions. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10968">431</a><p>
+<div class="defnbox"><a id="wrglossary.19051"></a><a href="#glo:glstreechildprelocation"><code class="csfmt">\glstreechildprelocation</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glstreeprelocation"><code class="csfmt">\glstreeprelocation</code></a>; <a id="wrglossary.19052"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used before the child entry <a id="wrglossary.19053"></a><a href="#glo:dual.locationlist">location list</a> for the <a id="wrglossary.19054"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a> and <a id="wrglossary.19055"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a> styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10980">432</a><p>
+<div class="defnbox"><a id="wrglossary.19056"></a><a href="#glo:glstreechildsymbol"><code class="csfmt">\glstreechildsymbol</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19057"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the top-level symbol in parentheses, if set, for the <a id="wrglossary.19058"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a> styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10993">433</a><p>
+<div class="defnbox"><a id="wrglossary.19059"></a><a href="#glo:glstreedefaultnamefmt"><code class="csfmt">\glstreedefaultnamefmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19060"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used as the default name format for the <a id="wrglossary.19061"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a> and <a id="wrglossary.19062"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a> styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10948">430</a><p>
+<div class="defnbox"><a id="wrglossary.19063"></a><a href="#glo:glstreedesc"><code class="csfmt">\glstreedesc</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19064"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the given top-level entry’s description with pre and post hooks for the <a id="wrglossary.19065"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a> styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10990">432</a><p>
+<div class="defnbox"><a id="wrglossary.19066"></a><a href="#glo:glstreeDescLoc"><code class="csfmt">\glstreeDescLoc</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19067"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.41+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the top-level description (if set) and <a id="wrglossary.19068"></a><a href="#glo:dual.locationlist">location list</a> for the <a id="wrglossary.19069"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a> styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10996">433</a><p>
+<div class="defnbox"><a id="wrglossary.19070"></a><a href="#glo:glstreegroupheaderfmt"><code class="csfmt">\glstreegroupheaderfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19071"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a> v4.22+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to format the <a id="wrglossary.19072"></a><a href="#glo:idx.group">group</a> title for the <a id="wrglossary.19073"></a><a href="#glo:opt.glostyle.treegroup"><span class="glostylefmt">treegroup</span></a> and <a id="wrglossary.19074"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a> styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10943">430</a><p>
+<div class="defnbox"><a id="wrglossary.19075"></a><a href="#glo:glstreegroupheaderskip"><code class="csfmt">\glstreegroupheaderskip</code></a><span class="floatrightbox"><a id="wrglossary.19076"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+After group header skip for the <a id="wrglossary.19077"></a><a href="#glo:opt.glostyle.treegroup"><span class="glostylefmt">treegroup</span></a> and <a id="wrglossary.19078"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a> styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10956">431</a><p>
+<div class="defnbox"><a id="wrglossary.19079"></a><a href="#glo:glstreegroupskip"><code class="csfmt">\glstreegroupskip</code></a><span class="floatrightbox"><a id="wrglossary.19080"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.41+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Group skip for the <a id="wrglossary.19081"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a> and <a id="wrglossary.19082"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a> styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10952">430</a><p>
+<div class="defnbox"><a id="wrglossary.19083"></a><dfn id="glo:glstreeitem"><code class="csfmt">\glstreeitem</code></dfn><span class="floatrightbox"><a id="wrglossary.19084"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a> v4.26+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to indent the top-level entries for the <a id="wrglossary.19085"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a> styles.<p>
+<div class="defnbox"><a id="wrglossary.19086"></a><dfn id="glo:glstreenamefmt"><code class="csfmt">\glstreenamefmt</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19087"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a> v4.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to format the name for the <a id="wrglossary.19088"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a> and <a id="wrglossary.19089"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a> styles.<p>
+<div class="defnbox"><a id="wrglossary.19090"></a><a href="#glo:glstreenavigationfmt"><code class="csfmt">\glstreenavigationfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19091"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a> v4.22+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to format the navigation element for styles like <a id="wrglossary.19092"></a><a href="#glo:opt.glostyle.treehypergroup"><span class="glostylefmt">treehypergroup</span></a>. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10945">430</a><p>
+<div class="defnbox"><a id="wrglossary.19093"></a><a href="#glo:glstreeNoDescSymbolPreLocation"><code class="csfmt">\glstreeNoDescSymbolPreLocation</code></a><span class="floatrightbox"><a id="wrglossary.19094"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Inserted before the <a id="wrglossary.19095"></a><a href="#glo:dual.locationlist">location list</a> when there’s no description or symbol for the <a id="wrglossary.19096"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a> styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11000">433</a><p>
+<div class="defnbox"><a id="wrglossary.19097"></a><a href="#glo:glstreenonamechilddesc"><code class="csfmt">\glstreenonamechilddesc</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19098"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the given child entry’s description and post hook for the <a id="wrglossary.19099"></a><a href="#glo:opt.glostyle.treenoname"><span class="glostylefmt">treenoname</span></a> styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10986">432</a><p>
+<div class="defnbox"><a id="wrglossary.19100"></a><dfn id="glo:glstreenonameChildDescLoc"><code class="csfmt">\glstreenonameChildDescLoc</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19101"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.45+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the given child entry’s description and <a id="wrglossary.19102"></a><a href="#glo:dual.locationlist">location list</a> for the <a id="wrglossary.19103"></a><a href="#glo:opt.glostyle.treenoname"><span class="glostylefmt">treenoname</span></a> styles.<p>
+<div class="defnbox"><a id="wrglossary.19104"></a><a href="#glo:glstreenonamedesc"><code class="csfmt">\glstreenonamedesc</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19105"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the given top-level entry’s description with pre and post hooks for the <a id="wrglossary.19106"></a><a href="#glo:opt.glostyle.treenoname"><span class="glostylefmt">treenoname</span></a> styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10983">432</a><p>
+<div class="defnbox"><a id="wrglossary.19107"></a><dfn id="glo:glstreenonameDescLoc"><code class="csfmt">\glstreenonameDescLoc</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19108"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.45+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the given top-level entry’s description and <a id="wrglossary.19109"></a><a href="#glo:dual.locationlist">location list</a> for the <a id="wrglossary.19110"></a><a href="#glo:opt.glostyle.treenoname"><span class="glostylefmt">treenoname</span></a> styles.<p>
+<div class="defnbox"><a id="wrglossary.19111"></a><a href="#glo:glstreenonamesymbol"><code class="csfmt">\glstreenonamesymbol</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19112"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the given top-level entry’s symbol in parentheses for the <a id="wrglossary.19113"></a><a href="#glo:opt.glostyle.treenoname"><span class="glostylefmt">treenoname</span></a> styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10984">432</a><p>
+<div class="defnbox"><a id="wrglossary.19114"></a><a href="#glo:glstreepredesc"><code class="csfmt">\glstreepredesc</code></a><span class="floatrightbox"><a id="wrglossary.19115"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a> v4.26+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Space inserted before top-level descriptions. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10967">431</a><p>
+<div class="defnbox"><a id="wrglossary.19116"></a><a href="#glo:glstreePreHeader"><code class="csfmt">\glstreePreHeader</code></a><code class="code">{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}{<span class="meta">〈<em class="metainner">group-title</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19117"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.41+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Pre <a id="wrglossary.19118"></a><a href="#glo:idx.group">group</a> header hook the <a id="wrglossary.19119"></a><a href="#glo:opt.glostyle.treegroup"><span class="glostylefmt">treegroup</span></a> and <a id="wrglossary.19120"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a> styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10959">431</a><p>
+<div class="defnbox"><a id="wrglossary.19121"></a><a href="#glo:glstreeprelocation"><code class="csfmt">\glstreeprelocation</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsxtrprelocation"><code class="csfmt">\glsxtrprelocation</code></a>; <a id="wrglossary.19122"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used before the top-level entry <a id="wrglossary.19123"></a><a href="#glo:dual.locationlist">location list</a> for the <a id="wrglossary.19124"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a> and <a id="wrglossary.19125"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a> styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10978">432</a><p>
+<div class="defnbox"><a id="wrglossary.19126"></a><dfn id="glo:glstreesubgroupitem"><code class="csfmt">\glstreesubgroupitem</code></dfn><code class="code">{previous group level}{level}{parent label}{group label}{group title}</code><span class="floatrightbox"><a id="wrglossary.19127"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the sub-group header in the <a id="wrglossary.19128"></a><a href="#glo:opt.glostyle.treegroup"><span class="glostylefmt">treegroup</span></a> styles.<p>
+<div class="defnbox"><a id="wrglossary.19129"></a><dfn id="glo:glstreesubitem"><code class="csfmt">\glstreesubitem</code></dfn><span class="floatrightbox"><a id="wrglossary.19130"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a> v4.26+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to indent the level 1 entries for the <a id="wrglossary.19131"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a> styles.<p>
+<div class="defnbox"><a id="wrglossary.19132"></a><dfn id="glo:glstreeSubPreHeader"><code class="csfmt">\glstreeSubPreHeader</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">previous group level</em>〉</span>}{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">parent label</em>〉</span>}{<span class="meta">〈<em class="metainner">group label</em>〉</span>}{<span class="meta">〈<em class="metainner">group title</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19133"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Pre sub-<a id="wrglossary.19134"></a><a href="#glo:idx.group">group</a> header hook the <a id="wrglossary.19135"></a><a href="#glo:opt.glostyle.treegroup"><span class="glostylefmt">treegroup</span></a> and <a id="wrglossary.19136"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a> styles.<p>
+<div class="defnbox"><a id="wrglossary.19137"></a><dfn id="glo:glstreesubsubitem"><code class="csfmt">\glstreesubsubitem</code></dfn><span class="floatrightbox"><a id="wrglossary.19138"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a> v4.26+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to indent the level 2 entries for the <a id="wrglossary.19139"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a> styles.<p>
+<div class="defnbox"><a id="wrglossary.19140"></a><a href="#glo:glstreesymbol"><code class="csfmt">\glstreesymbol</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19141"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the top-level symbol in parentheses, if set, for the <a id="wrglossary.19142"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a> styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10991">432</a><p>
+<div class="defnbox"><a id="wrglossary.19143"></a><a href="#glo:glstriggerrecordformat"><code class="csfmt">\glstriggerrecordformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19144"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used as a special location format that indicates that the record is a trigger record. <a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12792">525</a><p>
+<div class="defnbox"><a id="wrglossary.19145"></a><dfn id="glo:glsunexpandedfieldvalue"><code class="csfmt">\glsunexpandedfieldvalue</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19146"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use in expandable contexts where the field value is required but the contents should not be expanded. The field should be identified by its <a id="wrglossary.19147"></a><a href="#glo:dual.internalfieldlabel">internal field label</a>. Expands to nothing with no error or warning if the entry or field aren’t defined.<p>
+<div class="defnbox"><a id="wrglossary.19148"></a><dfn id="glo:glsunset"><code class="csfmt">\glsunset</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19149"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Globally unsets the entry’s <a id="wrglossary.19150"></a><a href="#glo:dual.firstuseflag">first use flag</a>. That is, this marks the entry as <span class="qt">“used”</span>.<p>
+<div class="defnbox"><a id="wrglossary.19151"></a><dfn id="glo:glsunsetall"><code class="csfmt">\glsunsetall</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">types</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.19152"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Globally unsets all entries associated with the listed glossaries or all glossaries if <span class="meta">〈<em class="metainner">types</em>〉</span> is omitted.<p>
+<div class="defnbox"><a id="wrglossary.19153"></a><a href="#glo:glsunsetcategoryattribute"><code class="csfmt">\glsunsetcategoryattribute</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19154"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.47+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally unsets the given attribute for the given category. <a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12335">504</a><p>
+<div class="defnbox"><a id="wrglossary.19155"></a><a href="#glo:glsupdatewidest"><code class="csfmt">\glsupdatewidest</code></a><code class="code">[<span class="meta">〈<em class="metainner">level</em>〉</span>]{<span class="meta">〈<em class="metainner">name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19156"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.23+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.19157"></a><a href="#glo:glssetwidest"><code class="csfmt">\glssetwidest</code></a> but only if <span class="meta">〈<em class="metainner">name</em>〉</span> is wider than the current widest value for the given <a id="wrglossary.19158"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a>. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11012">434</a><p>
+<div class="defnbox"><a id="wrglossary.19159"></a><a href="#glo:glsuppercase"><code class="csfmt">\glsuppercase</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19160"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Converts <span class="meta">〈<em class="metainner">text</em>〉</span> to <a id="wrglossary.19161"></a><a href="#glo:idx.uppercase">uppercase</a>. <a href="#sec:uppercase">§5.2.3</a>; <a href="#wrglossary.5124">200</a><p>
+<div class="defnbox"><a id="wrglossary.19162"></a><a href="#glo:glsuseabbrvfont"><code class="csfmt">\glsuseabbrvfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">style-name</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19163"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats <span class="meta">〈<em class="metainner">text</em>〉</span> according to the short format for the given abbreviation style. <a href="#sec:advancedabbrstylecmds">§4.5.2</a>; <a href="#wrglossary.3966">159</a><p>
+<div class="defnbox"><a id="wrglossary.19164"></a><a href="#glo:glsuselongfont"><code class="csfmt">\glsuselongfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">style-name</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19165"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats <span class="meta">〈<em class="metainner">text</em>〉</span> according to the long format for the given abbreviation style. <a href="#sec:advancedabbrstylecmds">§4.5.2</a>; <a href="#wrglossary.3967">159</a><p>
+<div class="defnbox"><a id="wrglossary.19166"></a><a href="#glo:glsuserdescription"><code class="csfmt">\glsuserdescription</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19167"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.30+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Description encapsulator for styles like <a id="wrglossary.19168"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a>. <a href="#wrglossary.3384">137</a><p>
+<div class="defnbox"><a id="wrglossary.19169"></a><dfn id="glo:GLSuseri"><code class="csfmt">\GLSuseri</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.19170"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.19171"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.19172"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.19173"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.19174"></a><a href="#glo:glsuseri"><code class="csfmt">\glsuseri</code></a> but converts the <a id="wrglossary.19175"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.19176"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="defnbox"><a id="wrglossary.19177"></a><dfn id="glo:Glsuseri"><code class="csfmt">\Glsuseri</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.19178"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.19179"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.19180"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.19181"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.19182"></a><a href="#glo:glsuseri"><code class="csfmt">\glsuseri</code></a> but converts the <a id="wrglossary.19183"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.19184"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="defnbox"><a id="wrglossary.19185"></a><dfn id="glo:glsuseri"><code class="csfmt">\glsuseri</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.19186"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.19187"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.19188"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.19189"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The text produced is obtained from the <a id="wrglossary.19190"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> value. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument will be inserted at the end of the <a id="wrglossary.19191"></a><a href="#glo:dual.linktext">link text</a>. This command does not alter or depend on the <a id="wrglossary.19192"></a><a href="#glo:dual.firstuseflag">first use flag</a>. For the first optional argument, see <a id="wrglossary.19193"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>.<p>
+<div class="defnbox"><a id="wrglossary.19194"></a><dfn id="glo:glsuseriaccessdisplay"><code class="csfmt">\glsuseriaccessdisplay</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19195"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> v4.45+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">text</em>〉</span> with the <a id="wrglossary.19196"></a><a href="#glo:opt.gloskey.user1access"><span class="csoptfmt">user1access</span></a> replacement text (if set).<p>
+<div class="defnbox"><a id="wrglossary.19197"></a><dfn id="glo:GLSuserii"><code class="csfmt">\GLSuserii</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.19198"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.19199"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.19200"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.19201"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.19202"></a><a href="#glo:glsuserii"><code class="csfmt">\glsuserii</code></a> but converts the <a id="wrglossary.19203"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.19204"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="defnbox"><a id="wrglossary.19205"></a><dfn id="glo:Glsuserii"><code class="csfmt">\Glsuserii</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.19206"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.19207"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.19208"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.19209"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.19210"></a><a href="#glo:glsuserii"><code class="csfmt">\glsuserii</code></a> but converts the <a id="wrglossary.19211"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.19212"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="defnbox"><a id="wrglossary.19213"></a><dfn id="glo:glsuserii"><code class="csfmt">\glsuserii</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.19214"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.19215"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.19216"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.19217"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The text produced is obtained from the <a id="wrglossary.19218"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a> value. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument will be inserted at the end of the <a id="wrglossary.19219"></a><a href="#glo:dual.linktext">link text</a>. This command does not alter or depend on the <a id="wrglossary.19220"></a><a href="#glo:dual.firstuseflag">first use flag</a>. For the first optional argument, see <a id="wrglossary.19221"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>.<p>
+<div class="defnbox"><a id="wrglossary.19222"></a><dfn id="glo:glsuseriiaccessdisplay"><code class="csfmt">\glsuseriiaccessdisplay</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19223"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> v4.45+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">text</em>〉</span> with the <a id="wrglossary.19224"></a><a href="#glo:opt.gloskey.user2access"><span class="csoptfmt">user2access</span></a> replacement text (if set).<p>
+<div class="defnbox"><a id="wrglossary.19225"></a><dfn id="glo:GLSuseriii"><code class="csfmt">\GLSuseriii</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.19226"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.19227"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.19228"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.19229"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.19230"></a><a href="#glo:glsuseriii"><code class="csfmt">\glsuseriii</code></a> but converts the <a id="wrglossary.19231"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.19232"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="defnbox"><a id="wrglossary.19233"></a><dfn id="glo:Glsuseriii"><code class="csfmt">\Glsuseriii</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.19234"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.19235"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.19236"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.19237"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.19238"></a><a href="#glo:glsuseriii"><code class="csfmt">\glsuseriii</code></a> but converts the <a id="wrglossary.19239"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.19240"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="defnbox"><a id="wrglossary.19241"></a><dfn id="glo:glsuseriii"><code class="csfmt">\glsuseriii</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.19242"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.19243"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.19244"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.19245"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The text produced is obtained from the <a id="wrglossary.19246"></a><a href="#glo:opt.gloskey.user3"><span class="csoptfmt">user3</span></a> value. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument will be inserted at the end of the <a id="wrglossary.19247"></a><a href="#glo:dual.linktext">link text</a>. This command does not alter or depend on the <a id="wrglossary.19248"></a><a href="#glo:dual.firstuseflag">first use flag</a>. For the first optional argument, see <a id="wrglossary.19249"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>.<p>
+<div class="defnbox"><a id="wrglossary.19250"></a><dfn id="glo:glsuseriiiaccessdisplay"><code class="csfmt">\glsuseriiiaccessdisplay</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19251"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> v4.45+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">text</em>〉</span> with the <a id="wrglossary.19252"></a><a href="#glo:opt.gloskey.user3access"><span class="csoptfmt">user3access</span></a> replacement text (if set).<p>
+<div class="defnbox"><a id="wrglossary.19253"></a><dfn id="glo:GLSuseriv"><code class="csfmt">\GLSuseriv</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.19254"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.19255"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.19256"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.19257"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.19258"></a><a href="#glo:glsuseriv"><code class="csfmt">\glsuseriv</code></a> but converts the <a id="wrglossary.19259"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.19260"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="defnbox"><a id="wrglossary.19261"></a><dfn id="glo:Glsuseriv"><code class="csfmt">\Glsuseriv</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.19262"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.19263"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.19264"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.19265"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.19266"></a><a href="#glo:glsuseriv"><code class="csfmt">\glsuseriv</code></a> but converts the <a id="wrglossary.19267"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.19268"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="defnbox"><a id="wrglossary.19269"></a><dfn id="glo:glsuseriv"><code class="csfmt">\glsuseriv</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.19270"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.19271"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.19272"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.19273"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The text produced is obtained from the <a id="wrglossary.19274"></a><a href="#glo:opt.gloskey.user4"><span class="csoptfmt">user4</span></a> value. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument will be inserted at the end of the <a id="wrglossary.19275"></a><a href="#glo:dual.linktext">link text</a>. This command does not alter or depend on the <a id="wrglossary.19276"></a><a href="#glo:dual.firstuseflag">first use flag</a>. For the first optional argument, see <a id="wrglossary.19277"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>.<p>
+<div class="defnbox"><a id="wrglossary.19278"></a><dfn id="glo:glsuserivaccessdisplay"><code class="csfmt">\glsuserivaccessdisplay</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19279"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> v4.45+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">text</em>〉</span> with the <a id="wrglossary.19280"></a><a href="#glo:opt.gloskey.user4access"><span class="csoptfmt">user4access</span></a> replacement text (if set).<p>
+<div class="defnbox"><a id="wrglossary.19281"></a><dfn id="glo:GLSuserv"><code class="csfmt">\GLSuserv</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.19282"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.19283"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.19284"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.19285"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.19286"></a><a href="#glo:glsuserv"><code class="csfmt">\glsuserv</code></a> but converts the <a id="wrglossary.19287"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.19288"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="defnbox"><a id="wrglossary.19289"></a><dfn id="glo:Glsuserv"><code class="csfmt">\Glsuserv</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.19290"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.19291"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.19292"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.19293"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.19294"></a><a href="#glo:glsuserv"><code class="csfmt">\glsuserv</code></a> but converts the <a id="wrglossary.19295"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.19296"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="defnbox"><a id="wrglossary.19297"></a><dfn id="glo:glsuserv"><code class="csfmt">\glsuserv</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.19298"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.19299"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.19300"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.19301"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The text produced is obtained from the <a id="wrglossary.19302"></a><a href="#glo:opt.gloskey.user5"><span class="csoptfmt">user5</span></a> value. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument will be inserted at the end of the <a id="wrglossary.19303"></a><a href="#glo:dual.linktext">link text</a>. This command does not alter or depend on the <a id="wrglossary.19304"></a><a href="#glo:dual.firstuseflag">first use flag</a>. For the first optional argument, see <a id="wrglossary.19305"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>.<p>
+<div class="defnbox"><a id="wrglossary.19306"></a><dfn id="glo:glsuservaccessdisplay"><code class="csfmt">\glsuservaccessdisplay</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19307"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> v4.45+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">text</em>〉</span> with the <a id="wrglossary.19308"></a><a href="#glo:opt.gloskey.user5access"><span class="csoptfmt">user5access</span></a> replacement text (if set).<p>
+<div class="defnbox"><a id="wrglossary.19309"></a><dfn id="glo:GLSuservi"><code class="csfmt">\GLSuservi</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.19310"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.19311"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.19312"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.19313"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.19314"></a><a href="#glo:glsuservi"><code class="csfmt">\glsuservi</code></a> but converts the <a id="wrglossary.19315"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.19316"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="defnbox"><a id="wrglossary.19317"></a><dfn id="glo:Glsuservi"><code class="csfmt">\Glsuservi</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.19318"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.19319"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.19320"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.19321"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.19322"></a><a href="#glo:glsuservi"><code class="csfmt">\glsuservi</code></a> but converts the <a id="wrglossary.19323"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.19324"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="defnbox"><a id="wrglossary.19325"></a><dfn id="glo:glsuservi"><code class="csfmt">\glsuservi</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.19326"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.19327"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.19328"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.19329"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v2.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The text produced is obtained from the <a id="wrglossary.19330"></a><a href="#glo:opt.gloskey.user6"><span class="csoptfmt">user6</span></a> value. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument will be inserted at the end of the <a id="wrglossary.19331"></a><a href="#glo:dual.linktext">link text</a>. This command does not alter or depend on the <a id="wrglossary.19332"></a><a href="#glo:dual.firstuseflag">first use flag</a>. For the first optional argument, see <a id="wrglossary.19333"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>.<p>
+<div class="defnbox"><a id="wrglossary.19334"></a><dfn id="glo:glsuserviaccessdisplay"><code class="csfmt">\glsuserviaccessdisplay</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19335"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> v4.45+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">text</em>〉</span> with the <a id="wrglossary.19336"></a><a href="#glo:opt.gloskey.user6access"><span class="csoptfmt">user6access</span></a> replacement text (if set).<p>
+<div class="defnbox"><a id="wrglossary.19337"></a><a href="#glo:glswriteentry"><code class="csfmt">\glswriteentry</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">code</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Performs the indexing code unless indexing should be suppressed. <a href="#sec:wrglossary">§5.8</a>; <a href="#wrglossary.6926">264</a><p>
+<div class="defnbox"><a id="wrglossary.19338"></a><a href="#glo:glsxpabbrvfont"><code class="csfmt">\glsxpabbrvfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">category</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19339"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If the <a id="wrglossary.19340"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a> attribute is set for the given category, this encapsulates <span class="meta">〈<em class="metainner">text</em>〉</span> with <a id="wrglossary.19341"></a><a href="#glo:glsabbrvfont"><code class="csfmt">\glsabbrvfont</code></a> otherwise with <a id="wrglossary.19342"></a><a href="#glo:glsinnerfmtabbrvfont"><code class="csfmt">\glsinnerfmtabbrvfont</code></a>. This command has to expand, so protect any content that shouldn’t expand. <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4190">168</a><p>
+<div class="defnbox"><a id="wrglossary.19343"></a><a href="#glo:glsxplongfont"><code class="csfmt">\glsxplongfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19344"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If the <a id="wrglossary.19345"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a> attribute is set for the given category, this encapsulates <span class="meta">〈<em class="metainner">text</em>〉</span> with <a id="wrglossary.19346"></a><a href="#glo:glslongfont"><code class="csfmt">\glslongfont</code></a> otherwise with <a id="wrglossary.19347"></a><a href="#glo:glsinnerfmtlongfont"><code class="csfmt">\glsinnerfmtlongfont</code></a>. This command has to expand, so protect any content that shouldn’t expand. <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4211">168</a><p>
+
+</section><!-- end of section summary.index7077888 -->
+
+<section id="summary.index7143424"><!-- start of section summary.index7143424 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->Glsxtr<div class="labellink"><a href="#summary.index7143424">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.19348"></a><a href="#glo:Glsxtr"><code class="csfmt">\Glsxtr</code></a><code class="code">[<span class="meta">〈<em class="metainner">gls-options</em>〉</span>][<span class="meta">〈<em class="metainner">dfn-options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.19349"></a><a href="#glo:glsxtr"><code class="csfmt">\glsxtr</code></a> but applies <a id="wrglossary.19350"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#sec:onthefly">§13</a>; <a href="#wrglossary.14130">579</a><p>
+<div class="defnbox"><a id="wrglossary.19351"></a><a href="#glo:glsxtr"><code class="csfmt">\glsxtr</code></a><code class="code">[<span class="meta">〈<em class="metainner">gls-options</em>〉</span>][<span class="meta">〈<em class="metainner">dfn-options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+If <span class="meta">〈<em class="metainner">entry-label</em>〉</span> has already been defined, this just references it, otherwise the entry is defined. This command must be enabled with <a id="wrglossary.19352"></a><a href="#glo:GlsXtrEnableOnTheFly"><code class="csfmt">\GlsXtrEnableOnTheFly</code></a>. <a href="#sec:onthefly">§13</a>; <a href="#wrglossary.14105">578</a><p>
+<div class="defnbox"><a id="wrglossary.19353"></a><a href="#glo:glsxtr@counterrecord"><code class="csfmt">\glsxtr@counterrecord</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19354"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+An <a id="wrglossary.19355"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file command used with <a id="wrglossary.19356"></a><a href="#glo:GlsXtrRecordCounter"><code class="csfmt">\GlsXtrRecordCounter</code></a> to append <span class="meta">〈<em class="metainner">value</em>〉</span> to the <a id="wrglossary.19357"></a><a href="#glo:opt.glosfield.record.counter"><span class="csoptfmt">record.<span class="meta">〈<em class="metainner">counter</em>〉</span></span></a> field. Also implements <a id="wrglossary.19358"></a><a href="#glo:glsxtrAddCounterRecordHook"><code class="csfmt">\glsxtrAddCounterRecordHook</code></a>. <a href="#sec:printunsrtunit">§8.4.3.2</a>; <a href="#wrglossary.10397">407</a><p>
+<div class="defnbox"><a id="wrglossary.19359"></a><a href="#glo:glsxtr@record"><code class="csfmt">\glsxtr@record</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">h-prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">encap</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19360"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used in the <a id="wrglossary.19361"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file to provide the <a id="wrglossary.19362"></a><a href="#glo:@@glslabel@indexing">record</a> for <a id="wrglossary.19363"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> (<a id="wrglossary.19364"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.19365"></a><a href="#glo:optval.record.only"><span class="optfmt">only</span></a>). Ignored by LaTeX. <a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13539">555</a><p>
+<div class="defnbox"><a id="wrglossary.19366"></a><a href="#glo:glsxtr@record@nameref"><code class="csfmt">\glsxtr@record@nameref</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">h-prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">encap</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}{<span class="meta">〈<em class="metainner">current title</em>〉</span>}{<span class="meta">〈<em class="metainner">current anchor</em>〉</span>}{<span class="meta">〈<em class="metainner">the-h-counter</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19367"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used in the <a id="wrglossary.19368"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file to provide the <a id="wrglossary.19369"></a><a href="#glo:optval.record.nameref"><span class="optfmt">nameref</span></a> <a id="wrglossary.19370"></a><a href="#glo:@@glslabel@indexing">record</a> for <a id="wrglossary.19371"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. Ignored by LaTeX. <a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13547">555</a><p>
+<div class="defnbox"><a id="wrglossary.19372"></a><a href="#glo:glsxtr@resource"><code class="csfmt">\glsxtr@resource</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">basename</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19373"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used in the <a id="wrglossary.19374"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file to provide the <a id="wrglossary.19375"></a><a href="#glo:idx.resourceopt">resource options</a> for <a id="wrglossary.19376"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> for each <a id="wrglossary.19377"></a><a href="#glo:dual.resourceset">resource set</a>. Ignored by LaTeX. <a href="#sec:bib2gls">§11</a>; <a href="#wrglossary.12463">511</a><p>
+<div class="defnbox"><a id="wrglossary.19378"></a><a href="#glo:glsxtrabbreviationfont"><code class="csfmt">\glsxtrabbreviationfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19379"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.30+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.19380"></a><a href="#glo:glsentryfmt"><code class="csfmt">\glsentryfmt</code></a> to encapsulate non-regular entries the have the <a id="wrglossary.19381"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> field set. <a href="#sec:middleformat">§5.5.2</a>; <a href="#wrglossary.6139">240</a><p>
+<div class="defnbox"><a id="wrglossary.19382"></a><a href="#glo:glsxtrabbrvfootnote"><code class="csfmt">\glsxtrabbrvfootnote</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19383"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.07+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Command that produces the footnote for the footnote abbreviation styles, such as <a id="wrglossary.19384"></a><a href="#glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">short-footnote</span></a> and <a id="wrglossary.19385"></a><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></a>. <a href="#wrglossary.3602">145</a><p>
+<div class="defnbox"><a id="wrglossary.19386"></a><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a>; <a id="wrglossary.19387"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The default plural suffix used for abbreviations. <a href="#sec:abbrvfieldslongshortpl">§4.1.2</a>; <a href="#wrglossary.1344">44</a><p>
+<div class="defnbox"><a id="wrglossary.19388"></a><a href="#glo:glsxtrabbrvtype"><code class="csfmt">\glsxtrabbrvtype</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>; <a id="wrglossary.19389"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the label of the default abbreviation <a id="wrglossary.19390"></a><a href="#glo:dual.glossary">glossary</a>. The <a id="wrglossary.19391"></a><a href="#glo:opt.abbreviations"><span class="styoptfmt">abbreviations</span></a> package option will redefine this to <code class="code">abbreviations</code>. <a href="#sec:abbrvfieldstype">§4.1.4</a>; <a href="#wrglossary.1357">44</a><p>
+<div class="defnbox"><a id="wrglossary.19392"></a><a href="#glo:glsxtrAccSuppAbbrSetFirstLongAttrs"><code class="csfmt">\glsxtrAccSuppAbbrSetFirstLongAttrs</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19393"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Initialised accessibility support for the <a id="wrglossary.19394"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, <a id="wrglossary.19395"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> and <a id="wrglossary.19396"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> fields (if enabled with <a id="wrglossary.19397"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>). This command is provided for abbreviation styles where the <a id="wrglossary.19398"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> and <a id="wrglossary.19399"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> are just the formatted abbreviation. <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4247">169</a><p>
+<div class="defnbox"><a id="wrglossary.19400"></a><a href="#glo:glsxtrAccSuppAbbrSetNameLongAttrs"><code class="csfmt">\glsxtrAccSuppAbbrSetNameLongAttrs</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19401"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Initialised accessibility support for the <a id="wrglossary.19402"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a>, <a id="wrglossary.19403"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a>, <a id="wrglossary.19404"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> and <a id="wrglossary.19405"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> fields (if enabled with <a id="wrglossary.19406"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>). This command is provided for abbreviation styles where the <a id="wrglossary.19407"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> and <a id="wrglossary.19408"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> are just the formatted abbreviation. <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4235">169</a><p>
+<div class="defnbox"><a id="wrglossary.19409"></a><a href="#glo:glsxtrAccSuppAbbrSetNameShortAttrs"><code class="csfmt">\glsxtrAccSuppAbbrSetNameShortAttrs</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19410"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Initialised accessibility support for the <a id="wrglossary.19411"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field (if enabled with <a id="wrglossary.19412"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>). This command is provided for abbreviation styles where only the <a id="wrglossary.19413"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> is just the formatted abbreviation. <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4268">169</a><p>
+<div class="defnbox"><a id="wrglossary.19414"></a><a href="#glo:glsxtrAccSuppAbbrSetNoLongAttrs"><code class="csfmt">\glsxtrAccSuppAbbrSetNoLongAttrs</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19415"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Initialised accessibility support for the <a id="wrglossary.19416"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, <a id="wrglossary.19417"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a>, <a id="wrglossary.19418"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a>, <a id="wrglossary.19419"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> and <a id="wrglossary.19420"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> fields (if enabled with <a id="wrglossary.19421"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>). This command is provided for abbreviation styles where the <a id="wrglossary.19422"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, <a id="wrglossary.19423"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> and <a id="wrglossary.19424"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> are just the formatted abbreviation. <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4220">168</a><p>
+<div class="defnbox"><a id="wrglossary.19425"></a><a href="#glo:glsxtrAccSuppAbbrSetTextShortAttrs"><code class="csfmt">\glsxtrAccSuppAbbrSetTextShortAttrs</code></a><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19426"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Initialised accessibility support for the <a id="wrglossary.19427"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> and <a id="wrglossary.19428"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> fields (if enabled with <a id="wrglossary.19429"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>). This command is provided for abbreviation styles where the <a id="wrglossary.19430"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> is just the formatted abbreviation. <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4258">169</a><p>
+<div class="defnbox"><a id="wrglossary.19431"></a><a href="#glo:glsxtractivatenopost"><code class="csfmt">\glsxtractivatenopost</code></a><span class="floatrightbox"><a id="wrglossary.19432"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.22+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Activates <a id="wrglossary.19433"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a> and <a id="wrglossary.19434"></a><a href="#glo:glsxtrnopostpunc"><code class="csfmt">\glsxtrnopostpunc</code></a>. <a href="#sec:glossentry">§8.5</a>; <a href="#wrglossary.10573">415</a><p>
+<div class="defnbox"><a id="wrglossary.19435"></a><a href="#glo:glsxtractualanchor"><code class="csfmt">\glsxtractualanchor</code></a><span class="floatrightbox"><a id="wrglossary.19436"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the anchor required by <a id="wrglossary.19437"></a><a href="#glo:glsxtrdisplaylocnameref"><code class="csfmt">\glsxtrdisplaylocnameref</code></a>. <a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13597">557</a><p>
+<div class="defnbox"><a id="wrglossary.19438"></a><a href="#glo:glsxtraddallcrossrefs"><code class="csfmt">\glsxtraddallcrossrefs</code></a></div><!-- end of defnbox -->
+<p>
+Iterates over all defined entries and indexes any cross-references (identified by the <a id="wrglossary.19439"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> or <a id="wrglossary.19440"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> keys) that haven’t been used. <a href="#sec:glssee">§5.9.3</a>; <a href="#wrglossary.7318">279</a><p>
+<div class="defnbox"><a id="wrglossary.19441"></a><a href="#glo:glsxtrAddCounterRecordHook"><code class="csfmt">\glsxtrAddCounterRecordHook</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19442"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+User-level hook used by <a id="wrglossary.19443"></a><a href="#glo:glsxtr@counterrecord"><code class="csfmt">\glsxtr@counterrecord</code></a>. If this command is redefined, it must be done so in the preamble before the <a id="wrglossary.19444"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file is input. <a href="#sec:printunsrtunit">§8.4.3.2</a>; <a href="#wrglossary.10403">407</a><p>
+<div class="defnbox"><a id="wrglossary.19445"></a><a href="#glo:glsxtraddgroup"><code class="csfmt">\glsxtraddgroup</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">code</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19446"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.19447"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> to perform <span class="meta">〈<em class="metainner">code</em>〉</span> if the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> should have support for <a id="wrglossary.19448"></a><a href="#glo:idx.group">groups</a>. <a href="#sec:printunsrtgroups">§8.4.1</a>; <a href="#wrglossary.9953">391</a><p>
+<div class="defnbox"><a id="wrglossary.19449"></a><a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a><code class="code">{<span class="meta">〈<em class="metainner">label-prefix</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19450"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Appends <span class="meta">〈<em class="metainner">label-prefix</em>〉</span> to the list of known labels. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13738">563</a><p>
+<div class="defnbox"><a id="wrglossary.19451"></a><a href="#glo:glsxtraddpunctuationmark"><code class="csfmt">\glsxtraddpunctuationmark</code></a><code class="code">{<span class="meta">〈<em class="metainner">token(s)</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Adds <span class="meta">〈<em class="metainner">token(s)</em>〉</span> to the list of punctuation characters used by <a id="wrglossary.19452"></a><a href="#glo:glsxtrifnextpunc"><code class="csfmt">\glsxtrifnextpunc</code></a>. You may list multiple characters at the same time to add a batch, but don’t add any separators (including spaces). Note that each character must be a single token, which means a single-byte character for pdfLaTeX. Multi-byte characters (<a id="wrglossary.19453"></a><a href="#glo:dual.utf8">UTF-8</a>) will required a native Unicode engine (XeLaTeX or LuaLaTeX). <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6365">249</a><p>
+<div class="defnbox"><a id="wrglossary.19454"></a><a href="#glo:glsxtraddunusedxrefs"><code class="csfmt">\glsxtraddunusedxrefs</code></a><span class="floatrightbox"><a id="wrglossary.19455"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indexes any cross-references (identified by the <a id="wrglossary.19456"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> or <a id="wrglossary.19457"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> keys) that haven’t been used. <a href="#sec:glssee">§5.9.3</a>; <a href="#wrglossary.7323">279</a><p>
+<div class="defnbox"><a id="wrglossary.19458"></a><a href="#glo:glsxtralias"><code class="csfmt">\glsxtralias</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19459"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the value of the <a id="wrglossary.19460"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> field for the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. If the field isn’t set, this will expand to nothing. If the entry isn’t defined, this will expand to <a id="wrglossary.19461"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a>. <a href="#sec:getsee">§5.9.2</a>; <a href="#wrglossary.7268">277</a><p>
+<div class="defnbox"><a id="wrglossary.19462"></a><a href="#glo:glsxtraliashook"><code class="csfmt">\glsxtraliashook</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19463"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook implemented when the <a id="wrglossary.19464"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> key is provided when an entry is defined. <a href="#sec:alias">§3.4</a>; <a href="#wrglossary.1092">36</a><p>
+<div class="defnbox"><a id="wrglossary.19465"></a><a href="#glo:glsxtrAltTreeIndent"><code class="csfmt">\glsxtrAltTreeIndent</code></a><span class="floatrightbox"><a id="wrglossary.19466"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Length register for the subsequent paragraph indentation for the <a id="wrglossary.19467"></a><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a>-like styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11054">437</a><p>
+<div class="defnbox"><a id="wrglossary.19468"></a><a href="#glo:glsxtralttreeInit"><code class="csfmt">\glsxtralttreeInit</code></a><span class="floatrightbox"><a id="wrglossary.19469"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Initialisation code performed by the <a id="wrglossary.19470"></a><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a>-like styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11053">437</a><p>
+<div class="defnbox"><a id="wrglossary.19471"></a><a href="#glo:glsxtralttreeSubSymbolDescLocation"><code class="csfmt">\glsxtralttreeSubSymbolDescLocation</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19472"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the symbol, description and location for child entries for the <a id="wrglossary.19473"></a><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a>-like styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11051">437</a><p>
+<div class="defnbox"><a id="wrglossary.19474"></a><a href="#glo:glsxtralttreeSymbolDescLocation"><code class="csfmt">\glsxtralttreeSymbolDescLocation</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19475"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the symbol, description and location for top-level entries for the <a id="wrglossary.19476"></a><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a>-like styles. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11050">437</a><p>
+<div class="defnbox"><a id="wrglossary.19477"></a><a href="#glo:glsxtrapptocsvfield"><code class="csfmt">\glsxtrapptocsvfield</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">element</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19478"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.47+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use with fields that should contain comma-separated lists, this will append a command followed by <span class="meta">〈<em class="metainner">element</em>〉</span> to the field value. If the field isn’t defined, this command will behave like <a id="wrglossary.19479"></a><a href="#glo:glsxtrdeffield"><code class="csfmt">\glsxtrdeffield</code></a>. No existence check is performed. <a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1170">38</a><p>
+<div class="defnbox"><a id="wrglossary.19480"></a><a href="#glo:GlsXtrAppToDefaultGlsOpts"><code class="csfmt">\GlsXtrAppToDefaultGlsOpts</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19481"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally append <span class="meta">〈<em class="metainner">options</em>〉</span> to the default options for the <a id="wrglossary.19482"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.19483"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands. <a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4729">187</a><p>
+<div class="defnbox"><a id="wrglossary.19484"></a><a href="#glo:glsxtrassignactualsetup"><code class="csfmt">\glsxtrassignactualsetup</code></a><span class="floatrightbox"><a id="wrglossary.19485"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.19486"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Used to strip common formatting commands from a field value to supply the text-only accessibility content when initialising the default <a id="wrglossary.19487"></a><a href="#glo:opt.gloskey.shortaccess"><span class="csoptfmt">shortaccess</span></a> and <a id="wrglossary.19488"></a><a href="#glo:opt.gloskey.shortpluralaccess"><span class="csoptfmt">shortpluralaccess</span></a> values. <a href="#sec:accessabbr">§9.1</a>; <a href="#wrglossary.11694">475</a><p>
+<div class="defnbox"><a id="wrglossary.19489"></a><a href="#glo:glsxtrassignfieldfont"><code class="csfmt">\glsxtrassignfieldfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19490"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.19491"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands to initialise the formatting commands required for the given entry. <a href="#sec:middleformat">§5.5.2</a>; <a href="#wrglossary.6154">240</a><p>
+<div class="defnbox"><a id="wrglossary.19492"></a><a href="#glo:glsxtrassignlinktextfmt"><code class="csfmt">\glsxtrassignlinktextfmt</code></a><span class="floatrightbox"><a id="wrglossary.19493"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Initialised by the <a id="wrglossary.19494"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.19495"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands, this contains the definitions of <a id="wrglossary.19496"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>, <a id="wrglossary.19497"></a><a href="#glo:glstextformat"><code class="csfmt">\glstextformat</code></a>, <a id="wrglossary.19498"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a>. <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6486">254</a><p>
+<div class="defnbox"><a id="wrglossary.19499"></a><a href="#glo:glsxtrattrentrytextfmt"><code class="csfmt">\glsxtrattrentrytextfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19500"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Applies the command obtained from the control sequence name supplied in the <a id="wrglossary.19501"></a><a href="#glo:opt.catattr.innertextformat"><span class="csoptfmt">innertextformat</span></a> attribute for the category assigned to the entry given by <a id="wrglossary.19502"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>. This command isn’t used by default as it should rarely be needed an increases complexity. <a href="#sec:innertextformat">§5.5.3</a>; <a href="#wrglossary.6225">243</a><p>
+<div class="defnbox"><a id="wrglossary.19503"></a><a href="#glo:GlsXtrAutoAddOnFormat"><code class="csfmt">\GlsXtrAutoAddOnFormat</code></a><code class="code">[<span class="meta">〈<em class="metainner">entry-label</em>〉</span>]{<span class="meta">〈<em class="metainner">format list</em>〉</span>}{<span class="meta">〈<em class="metainner">glsadd options</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19504"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Identifies formats that should trigger an automatic <a id="wrglossary.19505"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> by the <a id="wrglossary.19506"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.19507"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands. <a href="#sec:wrglossary">§5.8</a>; <a href="#wrglossary.6696">260</a><p>
+<div class="defnbox"><a id="wrglossary.19508"></a><a href="#glo:glsxtrautoindex"><code class="csfmt">\glsxtrautoindex</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:index"><code class="csfmt">\index</code></a>; <a id="wrglossary.19509"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.16+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The indexing command used by by the auto-indexing feature. <a href="#sec:autoindex">§12</a>; <a href="#wrglossary.14041">575</a><p>
+<div class="defnbox"><a id="wrglossary.19510"></a><a href="#glo:glsxtrautoindexassignsort"><code class="csfmt">\glsxtrautoindexassignsort</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19511"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.16+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to assign the sort value for the auto-indexing feature. <a href="#sec:autoindex">§12</a>; <a href="#wrglossary.14034">575</a><p>
+<div class="defnbox"><a id="wrglossary.19512"></a><a href="#glo:glsxtrautoindexentry"><code class="csfmt">\glsxtrautoindexentry</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19513"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.16+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the <span class="qt">“actual”</span> part for the auto-indexing feature. <a href="#sec:autoindex">§12</a>; <a href="#wrglossary.14028">574</a><p>
+<div class="defnbox"><a id="wrglossary.19514"></a><a href="#glo:glsxtrautoindexesc"><code class="csfmt">\glsxtrautoindexesc</code></a><span class="floatrightbox"><a id="wrglossary.19515"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.36+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Escapes the sort value used by the auto-indexing feature. <a href="#sec:autoindex">§12</a>; <a href="#wrglossary.14039">575</a><p>
+<div class="defnbox"><a id="wrglossary.19516"></a><a href="#glo:glsxtrBasicDigitrules"><code class="csfmt">\glsxtrBasicDigitrules</code></a><span class="floatrightbox"><a id="wrglossary.19517"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the Basic Latin digit character sort rules. <a href="#wrglossary.13297">545</a><p>
+<div class="defnbox"><a id="wrglossary.19518"></a><a href="#glo:glsxtrbibaddress"><code class="csfmt">\glsxtrbibaddress</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(defined by <a id="wrglossary.19519"></a><a href="#glo:GlsXtrProvideBibTeXFields"><code class="csfmt">\GlsXtrProvideBibTeXFields</code></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Accesses the <code class="fieldfmt">address</code> field. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13100">536</a><p>
+<div class="defnbox"><a id="wrglossary.19520"></a><a href="#glo:glsxtrbibauthor"><code class="csfmt">\glsxtrbibauthor</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(defined by <a id="wrglossary.19521"></a><a href="#glo:GlsXtrProvideBibTeXFields"><code class="csfmt">\GlsXtrProvideBibTeXFields</code></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Accesses the <code class="fieldfmt">author</code> field. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13102">536</a><p>
+<div class="defnbox"><a id="wrglossary.19522"></a><a href="#glo:glsxtrbibbooktitle"><code class="csfmt">\glsxtrbibbooktitle</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(defined by <a id="wrglossary.19523"></a><a href="#glo:GlsXtrProvideBibTeXFields"><code class="csfmt">\GlsXtrProvideBibTeXFields</code></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Accesses the <code class="fieldfmt">booktitle</code> field. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13104">536</a><p>
+<div class="defnbox"><a id="wrglossary.19524"></a><a href="#glo:glsxtrbibchapter"><code class="csfmt">\glsxtrbibchapter</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(defined by <a id="wrglossary.19525"></a><a href="#glo:GlsXtrProvideBibTeXFields"><code class="csfmt">\GlsXtrProvideBibTeXFields</code></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Accesses the <code class="fieldfmt">chapter</code> field. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13106">536</a><p>
+<div class="defnbox"><a id="wrglossary.19526"></a><a href="#glo:glsxtrbibedition"><code class="csfmt">\glsxtrbibedition</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(defined by <a id="wrglossary.19527"></a><a href="#glo:GlsXtrProvideBibTeXFields"><code class="csfmt">\GlsXtrProvideBibTeXFields</code></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Accesses the <code class="fieldfmt">edition</code> field. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13108">536</a><p>
+<div class="defnbox"><a id="wrglossary.19528"></a><a href="#glo:glsxtrbibhowpublished"><code class="csfmt">\glsxtrbibhowpublished</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(defined by <a id="wrglossary.19529"></a><a href="#glo:GlsXtrProvideBibTeXFields"><code class="csfmt">\GlsXtrProvideBibTeXFields</code></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Accesses the <code class="fieldfmt">howpublished</code> field. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13110">536</a><p>
+<div class="defnbox"><a id="wrglossary.19530"></a><a href="#glo:glsxtrbibinstitution"><code class="csfmt">\glsxtrbibinstitution</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(defined by <a id="wrglossary.19531"></a><a href="#glo:GlsXtrProvideBibTeXFields"><code class="csfmt">\GlsXtrProvideBibTeXFields</code></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Accesses the <code class="fieldfmt">institution</code> field. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13112">536</a><p>
+<div class="defnbox"><a id="wrglossary.19532"></a><a href="#glo:glsxtrbibjournal"><code class="csfmt">\glsxtrbibjournal</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(defined by <a id="wrglossary.19533"></a><a href="#glo:GlsXtrProvideBibTeXFields"><code class="csfmt">\GlsXtrProvideBibTeXFields</code></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Accesses the <code class="fieldfmt">journal</code> field. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13114">536</a><p>
+<div class="defnbox"><a id="wrglossary.19534"></a><a href="#glo:glsxtrbibmonth"><code class="csfmt">\glsxtrbibmonth</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(defined by <a id="wrglossary.19535"></a><a href="#glo:GlsXtrProvideBibTeXFields"><code class="csfmt">\GlsXtrProvideBibTeXFields</code></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Accesses the <code class="fieldfmt">month</code> field. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13116">536</a><p>
+<div class="defnbox"><a id="wrglossary.19536"></a><a href="#glo:glsxtrbibnote"><code class="csfmt">\glsxtrbibnote</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(defined by <a id="wrglossary.19537"></a><a href="#glo:GlsXtrProvideBibTeXFields"><code class="csfmt">\GlsXtrProvideBibTeXFields</code></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Accesses the <code class="fieldfmt">note</code> field. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13118">536</a><p>
+<div class="defnbox"><a id="wrglossary.19538"></a><a href="#glo:glsxtrbibnumber"><code class="csfmt">\glsxtrbibnumber</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(defined by <a id="wrglossary.19539"></a><a href="#glo:GlsXtrProvideBibTeXFields"><code class="csfmt">\GlsXtrProvideBibTeXFields</code></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Accesses the <code class="fieldfmt">number</code> field. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13120">536</a><p>
+<div class="defnbox"><a id="wrglossary.19540"></a><a href="#glo:glsxtrbiborganization"><code class="csfmt">\glsxtrbiborganization</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(defined by <a id="wrglossary.19541"></a><a href="#glo:GlsXtrProvideBibTeXFields"><code class="csfmt">\GlsXtrProvideBibTeXFields</code></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Accesses the <code class="fieldfmt">organization</code> field. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13122">536</a><p>
+<div class="defnbox"><a id="wrglossary.19542"></a><a href="#glo:glsxtrbibpages"><code class="csfmt">\glsxtrbibpages</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(defined by <a id="wrglossary.19543"></a><a href="#glo:GlsXtrProvideBibTeXFields"><code class="csfmt">\GlsXtrProvideBibTeXFields</code></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Accesses the <code class="fieldfmt">pages</code> field. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13124">536</a><p>
+<div class="defnbox"><a id="wrglossary.19544"></a><a href="#glo:glsxtrbibpublisher"><code class="csfmt">\glsxtrbibpublisher</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(defined by <a id="wrglossary.19545"></a><a href="#glo:GlsXtrProvideBibTeXFields"><code class="csfmt">\GlsXtrProvideBibTeXFields</code></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Accesses the <code class="fieldfmt">publisher</code> field. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13126">536</a><p>
+<div class="defnbox"><a id="wrglossary.19546"></a><a href="#glo:glsxtrbibschool"><code class="csfmt">\glsxtrbibschool</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(defined by <a id="wrglossary.19547"></a><a href="#glo:GlsXtrProvideBibTeXFields"><code class="csfmt">\GlsXtrProvideBibTeXFields</code></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Accesses the <code class="fieldfmt">school</code> field. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13128">536</a><p>
+<div class="defnbox"><a id="wrglossary.19548"></a><a href="#glo:glsxtrbibseries"><code class="csfmt">\glsxtrbibseries</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(defined by <a id="wrglossary.19549"></a><a href="#glo:GlsXtrProvideBibTeXFields"><code class="csfmt">\GlsXtrProvideBibTeXFields</code></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Accesses the <code class="fieldfmt">series</code> field. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13130">536</a><p>
+<div class="defnbox"><a id="wrglossary.19550"></a><a href="#glo:GlsXtrBibTeXEntryAliases"><code class="csfmt">\GlsXtrBibTeXEntryAliases</code></a><span class="floatrightbox"><a id="wrglossary.19551"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.29+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the BibTeX to <a id="wrglossary.19552"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> entry aliases for use in <a id="wrglossary.19553"></a><a href="#glo:opt.resource.entry-type-aliases"><span class="csoptfmt">entry-type-aliases</span></a>. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13095">535</a><p>
+<div class="defnbox"><a id="wrglossary.19554"></a><a href="#glo:glsxtrbibtitle"><code class="csfmt">\glsxtrbibtitle</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(defined by <a id="wrglossary.19555"></a><a href="#glo:GlsXtrProvideBibTeXFields"><code class="csfmt">\GlsXtrProvideBibTeXFields</code></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Accesses the <code class="fieldfmt">title</code> field. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13132">536</a><p>
+<div class="defnbox"><a id="wrglossary.19556"></a><a href="#glo:glsxtrbibtype"><code class="csfmt">\glsxtrbibtype</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(defined by <a id="wrglossary.19557"></a><a href="#glo:GlsXtrProvideBibTeXFields"><code class="csfmt">\GlsXtrProvideBibTeXFields</code></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Accesses the <code class="fieldfmt">bibtextype</code> field. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13134">536</a><p>
+<div class="defnbox"><a id="wrglossary.19558"></a><a href="#glo:glsxtrbibvolume"><code class="csfmt">\glsxtrbibvolume</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(defined by <a id="wrglossary.19559"></a><a href="#glo:GlsXtrProvideBibTeXFields"><code class="csfmt">\GlsXtrProvideBibTeXFields</code></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Accesses the <code class="fieldfmt">volume</code> field. <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13136">536</a><p>
+<div class="defnbox"><a id="wrglossary.19560"></a><a href="#glo:glsxtrbookindexatendgroup"><code class="csfmt">\glsxtrbookindexatendgroup</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19561"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.19562"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style at the end of a letter group (where the last top-level entry is given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>). <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11121">441</a><p>
+<div class="defnbox"><a id="wrglossary.19563"></a><a href="#glo:glsxtrbookindexbetween"><code class="csfmt">\glsxtrbookindexbetween</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry1-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry2-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19564"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.19565"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style between two entries where <span class="meta">〈<em class="metainner">entry1-label</em>〉</span> is the last top-level entry and <span class="meta">〈<em class="metainner">entry2-label</em>〉</span> is the next entry, which is a top-level entry. <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11115">441</a><p>
+<div class="defnbox"><a id="wrglossary.19566"></a><a href="#glo:glsxtrbookindexbookmark"><code class="csfmt">\glsxtrbookindexbookmark</code></a><code class="code">{<span class="meta">〈<em class="metainner">group-title</em>〉</span>}{<span class="meta">〈<em class="metainner">bookmark-name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19567"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Adds a bookmark with <a id="wrglossary.19568"></a><a href="#glo:pdfbookmark"><code class="csfmt">\pdfbookmark</code></a>, if supported. <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11157">442</a><p>
+<div class="defnbox"><a id="wrglossary.19569"></a><a href="#glo:glsxtrbookindexcols"><code class="csfmt">\glsxtrbookindexcols</code></a><span class="floatrightbox"><span class="summarytag">initial: </span>2; <a id="wrglossary.19570"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the number of columns for the <a id="wrglossary.19571"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style. <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11077">438</a><p>
+<div class="defnbox"><a id="wrglossary.19572"></a><a href="#glo:glsxtrbookindexcolspread"><code class="csfmt">\glsxtrbookindexcolspread</code></a><span class="floatrightbox"><a id="wrglossary.19573"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If not empty this should expand to the option argument for <a id="wrglossary.19574"></a><a href="#glo:env.multicols"><span class="envfmt">multicols</span></a>. <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11079">439</a><p>
+<div class="defnbox"><a id="wrglossary.19575"></a><a href="#glo:glsxtrbookindexfirstmark"><code class="csfmt">\glsxtrbookindexfirstmark</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19576"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.19577"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style to obtain the first mark and, if found, format it with <a id="wrglossary.19578"></a><a href="#glo:glsxtrbookindexfirstmarkfmt"><code class="csfmt">\glsxtrbookindexfirstmarkfmt</code></a>. <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11173">443</a><p>
+<div class="defnbox"><a id="wrglossary.19579"></a><a href="#glo:glsxtrbookindexfirstmarkfmt"><code class="csfmt">\glsxtrbookindexfirstmarkfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19580"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.19581"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style to format the first mark. <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11175">444</a><p>
+<div class="defnbox"><a id="wrglossary.19582"></a><a href="#glo:glsxtrbookindexformatheader"><code class="csfmt">\glsxtrbookindexformatheader</code></a><code class="code">{<span class="meta">〈<em class="metainner">group-title</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19583"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.19584"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style to format a <a id="wrglossary.19585"></a><a href="#glo:idx.group">group</a> header. <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11161">443</a><p>
+<div class="defnbox"><a id="wrglossary.19586"></a><dfn id="glo:glsxtrbookindexformatsubheader"><code class="csfmt">\glsxtrbookindexformatsubheader</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">previous level</em>〉</span>}{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">parent-label</em>〉</span>}{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}{<span class="meta">〈<em class="metainner">title</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19587"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the sub-group header.<p>
+<div class="defnbox"><a id="wrglossary.19588"></a><a href="#glo:glsxtrbookindexlastmark"><code class="csfmt">\glsxtrbookindexlastmark</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19589"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.19590"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style to obtain the last mark and, if found, format it with <a id="wrglossary.19591"></a><a href="#glo:glsxtrbookindexlastmarkfmt"><code class="csfmt">\glsxtrbookindexlastmarkfmt</code></a>. <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11174">443</a><p>
+<div class="defnbox"><a id="wrglossary.19592"></a><a href="#glo:glsxtrbookindexlastmarkfmt"><code class="csfmt">\glsxtrbookindexlastmarkfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19593"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.19594"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style to format the last mark. <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11176">444</a><p>
+<div class="defnbox"><a id="wrglossary.19595"></a><a href="#glo:glsxtrbookindexlocation"><code class="csfmt">\glsxtrbookindexlocation</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19596"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.39+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.19597"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style to display top-level <a id="wrglossary.19598"></a><a href="#glo:dual.locationlist">location lists</a>. <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11110">440</a><p>
+<div class="defnbox"><a id="wrglossary.19599"></a><a href="#glo:glsxtrbookindexmarkentry"><code class="csfmt">\glsxtrbookindexmarkentry</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19600"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.19601"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style to mark an entry in the <a id="wrglossary.19602"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file. <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11171">443</a><p>
+<div class="defnbox"><a id="wrglossary.19603"></a><a href="#glo:glsxtrbookindexmulticolsenv"><code class="csfmt">\glsxtrbookindexmulticolsenv</code></a><span class="floatrightbox"><a id="wrglossary.19604"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.25+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the name of the <a id="wrglossary.19605"></a><a href="#glo:env.multicols"><span class="envfmt">multicols</span></a> environment to use. <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11082">439</a><p>
+<div class="defnbox"><a id="wrglossary.19606"></a><a href="#glo:glsxtrbookindexname"><code class="csfmt">\glsxtrbookindexname</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19607"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.19608"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style to display a top-level entry’s name. <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11084">439</a><p>
+<div class="defnbox"><a id="wrglossary.19609"></a><a href="#glo:glsxtrbookindexparentchildsep"><code class="csfmt">\glsxtrbookindexparentchildsep</code></a><span class="floatrightbox"><a id="wrglossary.19610"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.19611"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style to separate a top-level parent and child entry. <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11112">440</a><p>
+<div class="defnbox"><a id="wrglossary.19612"></a><a href="#glo:glsxtrbookindexparentsubchildsep"><code class="csfmt">\glsxtrbookindexparentsubchildsep</code></a><span class="floatrightbox"><a id="wrglossary.19613"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.19614"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style to separate a sub-level parent and child entry. <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11113">441</a><p>
+<div class="defnbox"><a id="wrglossary.19615"></a><a href="#glo:glsxtrbookindexpregroupskip"><code class="csfmt">\glsxtrbookindexpregroupskip</code></a><code class="code">{<span class="meta">〈<em class="metainner">skip</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19616"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.19617"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style insert <span class="meta">〈<em class="metainner">skip</em>〉</span> after a <a id="wrglossary.19618"></a><a href="#glo:idx.group">group</a> header. <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11168">443</a><p>
+<div class="defnbox"><a id="wrglossary.19619"></a><a href="#glo:glsxtrbookindexprelocation"><code class="csfmt">\glsxtrbookindexprelocation</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19620"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.19621"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style to display a separator before top-level <a id="wrglossary.19622"></a><a href="#glo:dual.locationlist">location lists</a>. <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11100">440</a><p>
+<div class="defnbox"><a id="wrglossary.19623"></a><a href="#glo:glsxtrbookindexsubatendgroup"><code class="csfmt">\glsxtrbookindexsubatendgroup</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19624"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.19625"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style at the end of a letter group (where the last level 1 entry is given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>). <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11120">441</a><p>
+<div class="defnbox"><a id="wrglossary.19626"></a><a href="#glo:glsxtrbookindexsubbetween"><code class="csfmt">\glsxtrbookindexsubbetween</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry1-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry2-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19627"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.19628"></a><a href="#glo:glsxtrbookindexbetween"><code class="csfmt">\glsxtrbookindexbetween</code></a> but for level 1 entries. <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11116">441</a><p>
+<div class="defnbox"><a id="wrglossary.19629"></a><a href="#glo:glsxtrbookindexsublocation"><code class="csfmt">\glsxtrbookindexsublocation</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19630"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.39+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.19631"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style to display child <a id="wrglossary.19632"></a><a href="#glo:dual.locationlist">location lists</a>. <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11111">440</a><p>
+<div class="defnbox"><a id="wrglossary.19633"></a><a href="#glo:glsxtrbookindexsubname"><code class="csfmt">\glsxtrbookindexsubname</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19634"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.19635"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style to display a child entry’s name. <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11097">440</a><p>
+<div class="defnbox"><a id="wrglossary.19636"></a><a href="#glo:glsxtrbookindexsubprelocation"><code class="csfmt">\glsxtrbookindexsubprelocation</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19637"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.19638"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style to display a separator before child <a id="wrglossary.19639"></a><a href="#glo:dual.locationlist">location lists</a>. <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11108">440</a><p>
+<div class="defnbox"><a id="wrglossary.19640"></a><a href="#glo:glsxtrbookindexsubsubatendgroup"><code class="csfmt">\glsxtrbookindexsubsubatendgroup</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19641"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.19642"></a><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a> style at the end of a letter group (where the last level 2 entry is given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>). <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11119">441</a><p>
+<div class="defnbox"><a id="wrglossary.19643"></a><a href="#glo:glsxtrbookindexsubsubbetween"><code class="csfmt">\glsxtrbookindexsubsubbetween</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry1-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry2-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19644"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.19645"></a><a href="#glo:glsxtrbookindexbetween"><code class="csfmt">\glsxtrbookindexbetween</code></a> but for level 2 entries. <a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11117">441</a><p>
+<div class="defnbox"><a id="wrglossary.19646"></a><a href="#glo:glsxtrcat"><code class="csfmt">\glsxtrcat</code></a><span class="floatrightbox"><span class="summarytag">initial: </span>general</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the default category set by commands like <a id="wrglossary.19647"></a><a href="#glo:glsxtr"><code class="csfmt">\glsxtr</code></a>. <a href="#sec:onthefly">§13</a>; <a href="#wrglossary.14138">580</a><p>
+<div class="defnbox"><a id="wrglossary.19648"></a><dfn id="glo:glsxtrcategoryfieldaccsupp"><code class="csfmt">\glsxtr<span class="meta">〈<em class="metainner">category</em>〉</span><span class="meta">〈<em class="metainner">field</em>〉</span>accsupp</code></dfn><p>
+<div class="noteBox"><span style="font-size: small; ">(user defined)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Expands to the accessibility support command for the given <a id="wrglossary.19649"></a><a href="#glo:dual.internalfieldlabel">internal field label</a> and category, which is used by <a id="wrglossary.19650"></a><a href="#glo:glsfieldaccsupp"><code class="csfmt">\glsfieldaccsupp</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.19651"></a><a href="#glo:glsxtrchecknohyperfirst"><code class="csfmt">\glsxtrchecknohyperfirst</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19652"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.07+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets <a id="wrglossary.19653"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span> if the <a id="wrglossary.19654"></a><a href="#glo:opt.catattr.nohyperfirst"><span class="csoptfmt">nohyperfirst</span></a> attribute is set. <a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4767">189</a><p>
+<div class="defnbox"><a id="wrglossary.19655"></a><a href="#glo:glsxtrclearlabelprefixes"><code class="csfmt">\glsxtrclearlabelprefixes</code></a><span class="floatrightbox"><a id="wrglossary.19656"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Clears the list of known prefixes. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13740">563</a><p>
+<div class="defnbox"><a id="wrglossary.19657"></a><a href="#glo:GlsXtrClearUnsetBuffer"><code class="csfmt">\GlsXtrClearUnsetBuffer</code></a><span class="floatrightbox"><a id="wrglossary.19658"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally clears the buffer, but doesn’t stop buffering. <a href="#sec:unsetbuffer">§5.10.1</a>; <a href="#wrglossary.7466">285</a><p>
+<div class="defnbox"><a id="wrglossary.19659"></a><a href="#glo:glsxtrcombiningdiacriticIIIrules"><code class="csfmt">\glsxtrcombiningdiacriticIIIrules</code></a><span class="floatrightbox"><a id="wrglossary.19660"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the third set of combining diacritic sort rules. <a href="#wrglossary.13271">543</a><p>
+<div class="defnbox"><a id="wrglossary.19661"></a><a href="#glo:glsxtrcombiningdiacriticIIrules"><code class="csfmt">\glsxtrcombiningdiacriticIIrules</code></a><span class="floatrightbox"><a id="wrglossary.19662"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the second set of combining diacritic sort rules. <a href="#wrglossary.13270">543</a><p>
+<div class="defnbox"><a id="wrglossary.19663"></a><a href="#glo:glsxtrcombiningdiacriticIrules"><code class="csfmt">\glsxtrcombiningdiacriticIrules</code></a><span class="floatrightbox"><a id="wrglossary.19664"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the first set of combining diacritic sort rules. <a href="#wrglossary.13269">542</a><p>
+<div class="defnbox"><a id="wrglossary.19665"></a><a href="#glo:glsxtrcombiningdiacriticIVrules"><code class="csfmt">\glsxtrcombiningdiacriticIVrules</code></a><span class="floatrightbox"><a id="wrglossary.19666"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the fourth set of combining diacritic sort rules. <a href="#wrglossary.13272">543</a><p>
+<div class="defnbox"><a id="wrglossary.19667"></a><a href="#glo:glsxtrcombiningdiacriticrules"><code class="csfmt">\glsxtrcombiningdiacriticrules</code></a><span class="floatrightbox"><a id="wrglossary.19668"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to all the combining diacritic sort rules. <a href="#wrglossary.13260">542</a><p>
+<div class="defnbox"><a id="wrglossary.19669"></a><a href="#glo:glsxtrcontrolrules"><code class="csfmt">\glsxtrcontrolrules</code></a><span class="floatrightbox"><a id="wrglossary.19670"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to control character sort rules. <a href="#wrglossary.13256">542</a><p>
+<div class="defnbox"><a id="wrglossary.19671"></a><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">glossary-type</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.19672"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Copies the entry to the internal <a id="wrglossary.19673"></a><a href="#glo:dual.glossary">glossary</a> list for the given <a id="wrglossary.19674"></a><a href="#glo:dual.glossary">glossary</a>. The starred version performs a global change. The unstarred version can be localised. Only for use with the <a id="wrglossary.19675"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>. <a href="#sec:glossaries">§8</a>; <a href="#wrglossary.9459">376</a><p>
+<div class="defnbox"><a id="wrglossary.19676"></a><a href="#glo:glsxtrcounterlocfmt"><code class="csfmt">\glsxtr<span class="meta">〈<em class="metainner">counter</em>〉</span>locfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">location</em>〉</span>}{<span class="meta">〈<em class="metainner">title</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(user defined)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.19677"></a><a href="#glo:glsxtrdisplaylocnameref"><code class="csfmt">\glsxtrdisplaylocnameref</code></a> for format a <a id="wrglossary.19678"></a><a href="#glo:@@glslabel@entrylocation">location</a> where the counter matches <span class="meta">〈<em class="metainner">counter</em>〉</span>. <a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13611">558</a><p>
+<div class="defnbox"><a id="wrglossary.19679"></a><a href="#glo:glsxtrcurrencyrules"><code class="csfmt">\glsxtrcurrencyrules</code></a><span class="floatrightbox"><a id="wrglossary.19680"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to currency character sort rules. <a href="#wrglossary.13294">545</a><p>
+<div class="defnbox"><a id="wrglossary.19681"></a><a href="#glo:glsxtrcurrentfield"><code class="csfmt">\glsxtrcurrentfield</code></a><span class="floatrightbox"><a id="wrglossary.19682"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Placeholder command for use in <a id="wrglossary.19683"></a><a href="#glo:dual.postlinkhook">post-link hooks</a>. This expands to empty if the calling command was one of the <a id="wrglossary.19684"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands or it was one of the <a id="wrglossary.19685"></a><a href="#glo:dual.inlinefullform">inline full form</a> commands, otherwise it will expand to the name of the key associated with the <span style="font-style: italic; font-variant: normal; ">singular</span> form of the command. <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6432">252</a><p>
+<div class="defnbox"><a id="wrglossary.19686"></a><a href="#glo:glsxtrcurrentmglscsname"><code class="csfmt">\glsxtrcurrentmglscsname</code></a><span class="floatrightbox"><a id="wrglossary.19687"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Placeholder command for use in multi-entry hooks, this expands to the control sequence name of the calling command. <a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8781">348</a><p>
+<div class="defnbox"><a id="wrglossary.19688"></a><a href="#glo:glsxtrdefaultentrytextfmt"><code class="csfmt">\glsxtrdefaultentrytextfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19689"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Default <a id="wrglossary.19690"></a><a href="#glo:dual.innerformatting">inner formatting</a>. Initialised to just do <span class="meta">〈<em class="metainner">text</em>〉</span>. <a href="#sec:innertextformat">§5.5.3</a>; <a href="#wrglossary.6220">243</a><p>
+<div class="defnbox"><a id="wrglossary.19691"></a><a href="#glo:GlsXtrDefaultResourceOptions"><code class="csfmt">\GlsXtrDefaultResourceOptions</code></a><span class="floatrightbox"><a id="wrglossary.19692"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.40+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to default <a id="wrglossary.19693"></a><a href="#glo:idx.resourceopt">resource options</a>. <a href="#sec:bib2gls">§11</a>; <a href="#wrglossary.12515">513</a><p>
+<div class="defnbox"><a id="wrglossary.19694"></a><a href="#glo:glsxtrdefaultrevert"><code class="csfmt">\glsxtrdefaultrevert</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19695"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The default definition of <a id="wrglossary.19696"></a><a href="#glo:glsxtrrevert"><code class="csfmt">\glsxtrrevert</code></a>. Simply does <span class="meta">〈<em class="metainner">text</em>〉</span>. <a href="#wrglossary.3280">133</a><p>
+<div class="defnbox"><a id="wrglossary.19697"></a><a href="#glo:GLSxtrdefaultsubsequentfmt"><code class="csfmt">\GLSxtrdefaultsubsequentfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19698"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The default <a id="wrglossary.19699"></a><a href="#glo:idx.allcaps">all caps</a> subsequent format style that only shows the short form and insert (with support for <a id="wrglossary.19700"></a><a href="#glo:opt.glsopt.innertextformat"><span class="csoptfmt">innertextformat</span></a>). <a href="#wrglossary.4417">174</a><p>
+<div class="defnbox"><a id="wrglossary.19701"></a><a href="#glo:Glsxtrdefaultsubsequentfmt"><code class="csfmt">\Glsxtrdefaultsubsequentfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19702"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The default <a id="wrglossary.19703"></a><a href="#glo:idx.sentencecase">sentence case</a> subsequent format style that only shows the short form and insert (with support for <a id="wrglossary.19704"></a><a href="#glo:opt.glsopt.innertextformat"><span class="csoptfmt">innertextformat</span></a>). <a href="#wrglossary.4409">174</a><p>
+<div class="defnbox"><a id="wrglossary.19705"></a><a href="#glo:glsxtrdefaultsubsequentfmt"><code class="csfmt">\glsxtrdefaultsubsequentfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19706"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The default subsequent format style that only shows the short form and insert (with support for <a id="wrglossary.19707"></a><a href="#glo:opt.glsopt.innertextformat"><span class="csoptfmt">innertextformat</span></a>). <a href="#wrglossary.4403">174</a><p>
+<div class="defnbox"><a id="wrglossary.19708"></a><a href="#glo:GLSxtrdefaultsubsequentplfmt"><code class="csfmt">\GLSxtrdefaultsubsequentplfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19709"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The default <a id="wrglossary.19710"></a><a href="#glo:idx.allcaps">all caps</a> subsequent plural format style that only shows the short form and insert (with support for <a id="wrglossary.19711"></a><a href="#glo:opt.glsopt.innertextformat"><span class="csoptfmt">innertextformat</span></a>). <a href="#wrglossary.4421">174</a><p>
+<div class="defnbox"><a id="wrglossary.19712"></a><a href="#glo:Glsxtrdefaultsubsequentplfmt"><code class="csfmt">\Glsxtrdefaultsubsequentplfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19713"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The default <a id="wrglossary.19714"></a><a href="#glo:idx.sentencecase">sentence case</a> subsequent plural format style that only shows the short form and insert (with support for <a id="wrglossary.19715"></a><a href="#glo:opt.glsopt.innertextformat"><span class="csoptfmt">innertextformat</span></a>). <a href="#wrglossary.4413">174</a><p>
+<div class="defnbox"><a id="wrglossary.19716"></a><a href="#glo:glsxtrdefaultsubsequentplfmt"><code class="csfmt">\glsxtrdefaultsubsequentplfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19717"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The default subsequent plural format style that only shows the short form and insert (with support for <a id="wrglossary.19718"></a><a href="#glo:opt.glsopt.innertextformat"><span class="csoptfmt">innertextformat</span></a>). <a href="#wrglossary.4406">174</a><p>
+<div class="defnbox"><a id="wrglossary.19719"></a><a href="#glo:glsxtrdeffield"><code class="csfmt">\glsxtrdeffield</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19720"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.19721"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a> but doesn’t perform any existence checks. <a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1163">38</a><p>
+<div class="defnbox"><a id="wrglossary.19722"></a><dfn id="glo:GlsXtrDefineAbbreviationShortcuts"><code class="csfmt">\GlsXtrDefineAbbreviationShortcuts</code></dfn></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.19723"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.19724"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> and <a id="wrglossary.19725"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.19726"></a><a href="#glo:optval.shortcuts.all"><span class="optfmt">all</span></a>. This command redefines itself to do nothing because it can only be used once.<p>
+<div class="defnbox"><a id="wrglossary.19727"></a><dfn id="glo:GlsXtrDefineAcronymShortcuts"><code class="csfmt">\GlsXtrDefineAcronymShortcuts</code></dfn><span class="floatrightbox"><a id="wrglossary.19728"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.19729"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.19730"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> and <a id="wrglossary.19731"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.19732"></a><a href="#glo:optval.shortcuts.acother"><span class="optfmt">acother</span></a>. This command redefines itself to do nothing because it can only be used once.<p>
+<div class="defnbox"><a id="wrglossary.19733"></a><dfn id="glo:GlsXtrDefineOtherShortcuts"><code class="csfmt">\GlsXtrDefineOtherShortcuts</code></dfn></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.19734"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.19735"></a><a href="#glo:optval.shortcuts.other"><span class="optfmt">other</span></a> and <a id="wrglossary.19736"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.19737"></a><a href="#glo:optval.shortcuts.all"><span class="optfmt">all</span></a>. This command redefines itself to do nothing because it can only be used once.<p>
+<div class="defnbox"><a id="wrglossary.19738"></a><a href="#glo:glsxtrdetoklocation"><code class="csfmt">\glsxtrdetoklocation</code></a><code class="code">{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19739"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Just expands to <span class="meta">〈<em class="metainner">location</em>〉</span> by default but may be redefined to help protect awkward characters. <a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12731">522</a><p>
+<div class="defnbox"><a id="wrglossary.19740"></a><a href="#glo:glsxtrdigitrules"><code class="csfmt">\glsxtrdigitrules</code></a><span class="floatrightbox"><a id="wrglossary.19741"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to 0–9 digit character sort rules (includes superscript and subscript digits). <a href="#wrglossary.13296">545</a><p>
+<div class="defnbox"><a id="wrglossary.19742"></a><a href="#glo:glsxtrdiscardperiod"><code class="csfmt">\glsxtrdiscardperiod</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">discarded</em>〉</span>}{<span class="meta">〈<em class="metainner">no discard</em>〉</span>}<span class="meta">〈<em class="metainner">token</em>〉</span></code><span class="floatrightbox"><a id="wrglossary.19743"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If <span class="meta">〈<em class="metainner">token</em>〉</span> is a <a id="wrglossary.19744"></a><a href="#glo:idx.fullstop">full stop</a> and the entry’s <a id="wrglossary.19745"></a><a href="#glo:idx.categoryattribute">category attributes</a> indicate that a <a id="wrglossary.19746"></a><a href="#glo:idx.fullstop">full stop</a> should be discarded (such as <a id="wrglossary.19747"></a><a href="#glo:opt.catattr.discardperiod"><span class="csoptfmt">discardperiod</span></a>), then <span class="meta">〈<em class="metainner">discarded</em>〉</span> is performed, otherwise <span class="meta">〈<em class="metainner">no discard</em>〉</span> is done and the <span class="meta">〈<em class="metainner">token</em>〉</span> is processed. The actual test to determine if <span class="meta">〈<em class="metainner">token</em>〉</span> is a <a id="wrglossary.19748"></a><a href="#glo:idx.fullstop">full stop</a> is performed by <a id="wrglossary.19749"></a><a href="#glo:glsxtrifperiod"><code class="csfmt">\glsxtrifperiod</code></a>. This command is used in <a id="wrglossary.19750"></a><a href="#glo:postlinkhook">post-link hooks</a>. <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6323">247</a><p>
+<div class="defnbox"><a id="wrglossary.19751"></a><a href="#glo:glsxtrdiscardperiodretainfirstuse"><code class="csfmt">\glsxtrdiscardperiodretainfirstuse</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">discarded</em>〉</span>}{<span class="meta">〈<em class="metainner">no discard</em>〉</span>}<span class="meta">〈<em class="metainner">token</em>〉</span></code><span class="floatrightbox"><a id="wrglossary.19752"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to discard a following <a id="wrglossary.19753"></a><a href="#glo:idx.fullstop">full stop</a> when the <a id="wrglossary.19754"></a><a href="#glo:opt.catattr.retainfirstuseperiod"><span class="csoptfmt">retainfirstuseperiod</span></a> attribute is set. <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6329">247</a><p>
+<div class="defnbox"><a id="wrglossary.19755"></a><a href="#glo:GlsXtrDiscardUnsetBuffering"><code class="csfmt">\GlsXtrDiscardUnsetBuffering</code></a><span class="floatrightbox"><a id="wrglossary.19756"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Discards the pending buffer and restores <a id="wrglossary.19757"></a><a href="#glo:glsunset"><code class="csfmt">\glsunset</code></a>. <a href="#sec:unsetbuffer">§5.10.1</a>; <a href="#wrglossary.7473">285</a><p>
+<div class="defnbox"><a id="wrglossary.19758"></a><a href="#glo:glsxtrdisplayendloc"><code class="csfmt">\glsxtrdisplayendloc</code></a><code class="code">{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19759"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display an end location from an explicit range. <a href="#sec:glosstylenumlist">§8.6.3</a>; <a href="#wrglossary.10810">424</a><p>
+<div class="defnbox"><a id="wrglossary.19760"></a><a href="#glo:glsxtrdisplayendlochook"><code class="csfmt">\glsxtrdisplayendlochook</code></a><span class="floatrightbox"><a id="wrglossary.19761"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook used by <a id="wrglossary.19762"></a><a href="#glo:glsxtrdisplayendloc"><code class="csfmt">\glsxtrdisplayendloc</code></a>. <a href="#sec:glosstylenumlist">§8.6.3</a>; <a href="#wrglossary.10813">425</a><p>
+<div class="defnbox"><a id="wrglossary.19763"></a><a href="#glo:glsxtrdisplaylocnameref"><code class="csfmt">\glsxtrdisplaylocnameref</code></a><code class="code">{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}{<span class="meta">〈<em class="metainner">title</em>〉</span>}{<span class="meta">〈<em class="metainner">href</em>〉</span>}{<span class="meta">〈<em class="metainner">hcounter</em>〉</span>}{<span class="meta">〈<em class="metainner">file</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19764"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display <a id="wrglossary.19765"></a><a href="#glo:@@glslabel@indexing">records</a> created with <a id="wrglossary.19766"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.19767"></a><a href="#glo:optval.record.nameref"><span class="optfmt">nameref</span></a>. <a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13580">556</a><p>
+<div class="defnbox"><a id="wrglossary.19768"></a><a href="#glo:glsxtrdisplaysingleloc"><code class="csfmt">\glsxtrdisplaysingleloc</code></a><code class="code">{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19769"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display a single location. <a href="#sec:glosstylenumlist">§8.6.3</a>; <a href="#wrglossary.10808">424</a><p>
+<div class="defnbox"><a id="wrglossary.19770"></a><a href="#glo:glsxtrdisplaystartloc"><code class="csfmt">\glsxtrdisplaystartloc</code></a><code class="code">{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19771"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display a start location from an explicit range. <a href="#sec:glosstylenumlist">§8.6.3</a>; <a href="#wrglossary.10809">424</a><p>
+<div class="defnbox"><a id="wrglossary.19772"></a><a href="#glo:glsxtrdisplaysupploc"><code class="csfmt">\glsxtrdisplaysupploc</code></a><code class="code">{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">src</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.19773"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.36+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.19774"></a><a href="#glo:glsnoidxdisplayloc"><code class="csfmt">\glsnoidxdisplayloc</code></a> but used for supplementary locations. <a href="#sec:supplocations">§11.5.5</a>; <a href="#wrglossary.13513">555</a><p>
+<div class="defnbox"><a id="wrglossary.19775"></a><a href="#glo:glsxtrdoautoindexname"><code class="csfmt">\glsxtrdoautoindexname</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">attribute</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used to automatically index (using <a id="wrglossary.19776"></a><a href="#glo:glsxtrautoindex"><code class="csfmt">\glsxtrautoindex</code></a>) the entry’s name, if the given attribute is set for the entry’s category. <a href="#sec:autoindex">§12</a>; <a href="#wrglossary.14024">574</a><p>
+<div class="defnbox"><a id="wrglossary.19777"></a><a href="#glo:glsxtrdopostpunc"><code class="csfmt">\glsxtrdopostpunc</code></a><code class="code">{<span class="meta">〈<em class="metainner">code</em>〉</span>}<span class="meta">〈<em class="metainner">token</em>〉</span></code><span class="floatrightbox"><a id="wrglossary.19778"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If <span class="meta">〈<em class="metainner">token</em>〉</span> is a recognised punctuation character (see <a id="wrglossary.19779"></a><a href="#glo:glsxtrifnextpunc"><code class="csfmt">\glsxtrifnextpunc</code></a>) this does the punctuation character and then <span class="meta">〈<em class="metainner">code</em>〉</span>, otherwise if does <span class="meta">〈<em class="metainner">code</em>〉</span> followed by <span class="meta">〈<em class="metainner">token</em>〉</span>. <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6353">248</a><p>
+<div class="defnbox"><a id="wrglossary.19780"></a><a href="#glo:glsxtrdowrglossaryhook"><code class="csfmt">\glsxtrdowrglossaryhook</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19781"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook used whenever an entry is <a id="wrglossary.19782"></a><a href="#glo:@@glslabel@indexing">indexed</a>. Does nothing by default. <a href="#sec:wrglossary">§5.8</a>; <a href="#wrglossary.6892">263</a><p>
+<div class="defnbox"><a id="wrglossary.19783"></a><a href="#glo:GlsXtrDualBackLink"><code class="csfmt">\GlsXtrDualBackLink</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19784"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.30+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Adds a hyperlink to the given entry’s dual (whose label is stored in the field given by <a id="wrglossary.19785"></a><a href="#glo:GlsXtrDualField"><code class="csfmt">\GlsXtrDualField</code></a>) with the given hyperlink text. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13693">561</a><p>
+<div class="defnbox"><a id="wrglossary.19786"></a><a href="#glo:GlsXtrDualField"><code class="csfmt">\GlsXtrDualField</code></a><span class="floatrightbox"><span class="summarytag">initial: </span>dual; <a id="wrglossary.19787"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.30+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the <a id="wrglossary.19788"></a><a href="#glo:dual.internalfieldlabel">internal field label</a> used by <a id="wrglossary.19789"></a><a href="#glo:GlsXtrDualBackLink"><code class="csfmt">\GlsXtrDualBackLink</code></a>. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13699">562</a><p>
+<div class="defnbox"><a id="wrglossary.19790"></a><a href="#glo:glsxtredeffield"><code class="csfmt">\glsxtredeffield</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19791"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.19792"></a><a href="#glo:glsxtrdeffield"><code class="csfmt">\glsxtrdeffield</code></a> but (protected) expands <span class="meta">〈<em class="metainner">value</em>〉</span>. <a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1168">38</a><p>
+<div class="defnbox"><a id="wrglossary.19793"></a><a href="#glo:glsxtremrevert"><code class="csfmt">\glsxtremrevert</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19794"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The definition of <a id="wrglossary.19795"></a><a href="#glo:glsxtrrevert"><code class="csfmt">\glsxtrrevert</code></a> used by the emphasized (<span class="qt">“em”</span>) <a id="wrglossary.19796"></a><a href="#glo:idx.abbrvstyle">abbreviation styles</a>. Uses <a id="wrglossary.19797"></a><a href="#glo:textup"><code class="csfmt">\textup</code></a>. <a href="#wrglossary.3936">158</a><p>
+<div class="defnbox"><a id="wrglossary.19798"></a><a href="#glo:glsxtremsuffix"><code class="csfmt">\glsxtremsuffix</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The plural suffix used by the emphasized (<span class="qt">“em”</span>) <a id="wrglossary.19799"></a><a href="#glo:idx.abbrvstyle">abbreviation styles</a>. <a href="#wrglossary.3941">158</a><p>
+<div class="defnbox"><a id="wrglossary.19800"></a><a href="#glo:GlsXtrEnableEntryCounting"><code class="csfmt">\GlsXtrEnableEntryCounting</code></a><code class="code">{<span class="meta">〈<em class="metainner">category-list</em>〉</span>}{<span class="meta">〈<em class="metainner">trigger-value</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Enables entry counting for the given list of categories with the given trigger value (which must be an integer). <a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.7968">308</a><p>
+<div class="defnbox"><a id="wrglossary.19801"></a><a href="#glo:GlsXtrEnableEntryUnitCounting"><code class="csfmt">\GlsXtrEnableEntryUnitCounting</code></a><code class="code">{<span class="meta">〈<em class="metainner">category-list</em>〉</span>}{<span class="meta">〈<em class="metainner">trigger-value</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Enables unit entry counting for the given list of categories with the given trigger value (which must be an integer) and the associated counter. <a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8082">313</a><p>
+<div class="defnbox"><a id="wrglossary.19802"></a><a href="#glo:GlsXtrEnableIndexFormatOverride"><code class="csfmt">\GlsXtrEnableIndexFormatOverride</code></a><p>
+<div class="noteBox"><span style="font-size: small; ">(preamble only)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Allows the <a id="wrglossary.19803"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a> key to override the attribute value. <a href="#sec:autoindex">§12</a>; <a href="#wrglossary.14067">576</a><p>
+<div class="defnbox"><a id="wrglossary.19804"></a><a href="#glo:GlsXtrEnableInitialTagging"><code class="csfmt">\GlsXtrEnableInitialTagging</code></a><code class="code">{<span class="meta">〈<em class="metainner">categories</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Robustly defines the command <span class="meta">〈<em class="metainner">cs</em>〉</span> to accept a single argument, which is a letter (or letters) that needs to be tagged. The unstarred version triggers an error if <span class="meta">〈<em class="metainner">cs</em>〉</span> is already defined. The unstarred version will redefine <span class="meta">〈<em class="metainner">cs</em>〉</span> if it already exists. <a href="#sec:tagging">§4.4</a>; <a href="#wrglossary.1708">56</a><p>
+<div class="defnbox"><a id="wrglossary.19805"></a><a href="#glo:GlsXtrEnableLinkCounting"><code class="csfmt">\GlsXtrEnableLinkCounting</code></a><code class="code">[<span class="meta">〈<em class="metainner">parent counter</em>〉</span>]{<span class="meta">〈<em class="metainner">categories</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19806"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.26+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(preamble only)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Enables link counting for the given categories. <a href="#sec:linkcount">§6.2</a>; <a href="#wrglossary.8150">317</a><p>
+<div class="defnbox"><a id="wrglossary.19807"></a><a href="#glo:GlsXtrEnableOnTheFly"><code class="csfmt">\GlsXtrEnableOnTheFly</code></a><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Enables on the fly commands, such as <a id="wrglossary.19808"></a><a href="#glo:glsxtr"><code class="csfmt">\glsxtr</code></a>. <a href="#sec:onthefly">§13</a>; <a href="#wrglossary.14098">578</a><p>
+<div class="defnbox"><a id="wrglossary.19809"></a><a href="#glo:GlsXtrEnablePreLocationTag"><code class="csfmt">\GlsXtrEnablePreLocationTag</code></a><code class="code">{<span class="meta">〈<em class="metainner">page tag</em>〉</span>}{<span class="meta">〈<em class="metainner">pages tag</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19810"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Enables the <a id="wrglossary.19811"></a><a href="#glo:dual.locationlist">location list</a> tag. <a href="#sec:glosstylenumlist">§8.6.3</a>; <a href="#wrglossary.10793">423</a><p>
+<div class="defnbox"><a id="wrglossary.19812"></a><a href="#glo:glsxtrenablerecordcount"><code class="csfmt">\glsxtrenablerecordcount</code></a><span class="floatrightbox"><a id="wrglossary.19813"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Redefines the <a id="wrglossary.19814"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands (except <a id="wrglossary.19815"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a>) to use the analogous record count commands (<a id="wrglossary.19816"></a><a href="#glo:rgls"><code class="csfmt">\rgls</code></a> etc). <a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12848">527</a><p>
+<div class="defnbox"><a id="wrglossary.19817"></a><a href="#glo:glsxtrendfor"><code class="csfmt">\glsxtrendfor</code></a><span class="floatrightbox"><a id="wrglossary.19818"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.24+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+When used within <a id="wrglossary.19819"></a><a href="#glo:glsxtrforcsvfield"><code class="csfmt">\glsxtrforcsvfield</code></a> signifies that the loop should break at the end of the current iteration. <a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7809">301</a><p>
+<div class="defnbox"><a id="wrglossary.19820"></a><a href="#glo:Glsxtrentryfmt"><code class="csfmt">\Glsxtrentryfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19821"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.19822"></a><a href="#glo:glsxtrentryfmt"><code class="csfmt">\glsxtrentryfmt</code></a> but converts <span class="meta">〈<em class="metainner">text</em>〉</span> to <a id="wrglossary.19823"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#sec:glsxtrfmt">§5.12.2</a>; <a href="#wrglossary.7745">298</a><p>
+<div class="defnbox"><a id="wrglossary.19824"></a><a href="#glo:glsxtrentryfmt"><code class="csfmt">\glsxtrentryfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19825"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <code class="code"><span class="cmdfmt">\<span class="meta">〈<em class="metainner">csname</em>〉</span></span>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code> where the control sequence name <span class="meta">〈<em class="metainner">csname</em>〉</span> is obtained from the field given by <a id="wrglossary.19826"></a><a href="#glo:GlsXtrFmtField"><code class="csfmt">\GlsXtrFmtField</code></a>. If <a id="wrglossary.19827"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> has been loaded and this command will expand to <a id="wrglossary.19828"></a><a href="#glo:glsxtrpdfentryfmt"><code class="csfmt">\glsxtrpdfentryfmt</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>} in a PDF bookmark. <a href="#sec:glsxtrfmt">§5.12.2</a>; <a href="#wrglossary.7701">296</a><p>
+<div class="defnbox"><a id="wrglossary.19829"></a><a href="#glo:glsxtrentryparentname"><code class="csfmt">\glsxtrentryparentname</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19830"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.39+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the <a id="wrglossary.19831"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field of the given entry’s parent or does nothing if the entry doesn’t have the <a id="wrglossary.19832"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> field set or isn’t defined. <a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.7606">291</a><p>
+<div class="defnbox"><a id="wrglossary.19833"></a><a href="#glo:glsxtrequationlocfmt"><code class="csfmt">\glsxtrequationlocfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">location</em>〉</span>}{<span class="meta">〈<em class="metainner">title</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19834"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.19835"></a><a href="#glo:glsxtrdisplaylocnameref"><code class="csfmt">\glsxtrdisplaylocnameref</code></a> to format a <a id="wrglossary.19836"></a><a href="#glo:@@glslabel@entrylocation">location</a> where the counter is <a id="wrglossary.19837"></a><a href="#glo:ctr.equation"><span class="ctrfmt">equation</span></a>. <a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13618">558</a><p>
+<div class="defnbox"><a id="wrglossary.19838"></a><a href="#glo:GlsXtrExpandedFmt"><code class="csfmt">\GlsXtrExpandedFmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">content</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19839"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.30+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Fully-expands <span class="meta">〈<em class="metainner">content</em>〉</span> and passes it to <span class="meta">〈<em class="metainner">cs</em>〉</span>, which must be a command that takes a single argument. <a href="#sec:entryfmtmods">§5.5</a>; <a href="#wrglossary.6057">236</a><p>
+<div class="defnbox"><a id="wrglossary.19840"></a><a href="#glo:glsxtrfielddolistloop"><code class="csfmt">\glsxtrfielddolistloop</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19841"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Iterates over the given field’s value using <a id="wrglossary.19842"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <a id="wrglossary.19843"></a><a href="#glo:dolistcsloop"><code class="csfmt">\dolistcsloop</code></a>. <a href="#sec:listfields">§5.14</a>; <a href="#wrglossary.7871">304</a><p>
+<div class="defnbox"><a id="wrglossary.19844"></a><a href="#glo:glsxtrfieldforlistloop"><code class="csfmt">\glsxtrfieldforlistloop</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">handler-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19845"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Iterates over the given field’s value using <a id="wrglossary.19846"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <a id="wrglossary.19847"></a><a href="#glo:forlistcsloop"><code class="csfmt">\forlistcsloop</code></a>. <a href="#sec:listfields">§5.14</a>; <a href="#wrglossary.7874">304</a><p>
+<div class="defnbox"><a id="wrglossary.19848"></a><a href="#glo:glsxtrfieldformatcsvlist"><code class="csfmt">\glsxtrfieldformatcsvlist</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19849"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the comma-separated list stored in the given <a id="wrglossary.19850"></a><a href="#glo:dual.field">field</a> (identified by its <a id="wrglossary.19851"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a>) for the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> using <a id="wrglossary.19852"></a><a href="#glo:pkg.datatool-base"><span class="styfmt">datatool-base</span>’s</a> <a id="wrglossary.19853"></a><a href="#glo:DTLformatlist"><code class="csfmt">\DTLformatlist</code></a>. This command uses <a id="wrglossary.19854"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a> so the complete list can be obtained with <a id="wrglossary.19855"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a>. This adds implicit grouping. There is no starred version. <a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7813">302</a><p>
+<div class="defnbox"><a id="wrglossary.19856"></a><a href="#glo:glsxtrfieldformatlist"><code class="csfmt">\glsxtrfieldformatlist</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19857"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the value of the given field, which should be an <a id="wrglossary.19858"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span></a> internal list, using the same list handler macro as <a id="wrglossary.19859"></a><a href="#glo:pkg.datatool"><span class="styfmt">datatool</span>’s</a> <a id="wrglossary.19860"></a><a href="#glo:DTLformatlist"><code class="csfmt">\DTLformatlist</code></a>. <a href="#sec:listfields">§5.14</a>; <a href="#wrglossary.7865">304</a><p>
+<div class="defnbox"><a id="wrglossary.19861"></a><a href="#glo:glsxtrfieldifinlist"><code class="csfmt">\glsxtrfieldifinlist</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">item</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19862"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Uses <a id="wrglossary.19863"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <a id="wrglossary.19864"></a><a href="#glo:ifinlistcs"><code class="csfmt">\ifinlistcs</code></a> to determine if <span class="meta">〈<em class="metainner">item</em>〉</span> is in the list stored in the given field. <a href="#sec:listfields">§5.14</a>; <a href="#wrglossary.7877">304</a><p>
+<div class="defnbox"><a id="wrglossary.19865"></a><a href="#glo:glsxtrfieldlistadd"><code class="csfmt">\glsxtrfieldlistadd</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19866"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Appends <span class="meta">〈<em class="metainner">value</em>〉</span> to the given field using <a id="wrglossary.19867"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <a id="wrglossary.19868"></a><a href="#glo:listcsadd"><code class="csfmt">\listcsadd</code></a>. <a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1174">39</a><p>
+<div class="defnbox"><a id="wrglossary.19869"></a><a href="#glo:glsxtrfieldlisteadd"><code class="csfmt">\glsxtrfieldlisteadd</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19870"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Appends <span class="meta">〈<em class="metainner">value</em>〉</span> to the given field using <a id="wrglossary.19871"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <a id="wrglossary.19872"></a><a href="#glo:listcseadd"><code class="csfmt">\listcseadd</code></a>. <a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1182">39</a><p>
+<div class="defnbox"><a id="wrglossary.19873"></a><a href="#glo:glsxtrfieldlistgadd"><code class="csfmt">\glsxtrfieldlistgadd</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19874"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Appends <span class="meta">〈<em class="metainner">value</em>〉</span> to the given field using <a id="wrglossary.19875"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <a id="wrglossary.19876"></a><a href="#glo:listcsgadd"><code class="csfmt">\listcsgadd</code></a>. <a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1180">39</a><p>
+<div class="defnbox"><a id="wrglossary.19877"></a><a href="#glo:glsxtrfieldlistxadd"><code class="csfmt">\glsxtrfieldlistxadd</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19878"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Appends <span class="meta">〈<em class="metainner">value</em>〉</span> to the given field using <a id="wrglossary.19879"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <a id="wrglossary.19880"></a><a href="#glo:listcsxadd"><code class="csfmt">\listcsxadd</code></a>. <a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1184">39</a><p>
+<div class="defnbox"><a id="wrglossary.19881"></a><a href="#glo:glsxtrfieldtitlecase"><code class="csfmt">\glsxtrfieldtitlecase</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.19882"></a><a href="#glo:glsxtrusefield"><code class="csfmt">\glsxtrusefield</code></a> but converts the field value to <a id="wrglossary.19883"></a><a href="#glo:idx.titlecase">title case</a>. <a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.7599">291</a><p>
+<div class="defnbox"><a id="wrglossary.19884"></a><a href="#glo:glsxtrfieldtitlecasecs"><code class="csfmt">\glsxtrfieldtitlecasecs</code></a><code class="code">{<span class="meta">〈<em class="metainner">content</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19885"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.07+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Converts <span class="meta">〈<em class="metainner">content</em>〉</span> to <a id="wrglossary.19886"></a><a href="#glo:idx.titlecase">title case</a> (expanding the first token once). Uses <a id="wrglossary.19887"></a><a href="#glo:glscapitalisewords"><code class="csfmt">\glscapitalisewords</code></a>, if defined, otherwise uses <a id="wrglossary.19888"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>. <a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.7602">291</a><p>
+<div class="defnbox"><a id="wrglossary.19889"></a><a href="#glo:glsxtrfieldxifinlist"><code class="csfmt">\glsxtrfieldxifinlist</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">item</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19890"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Uses <a id="wrglossary.19891"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <a id="wrglossary.19892"></a><a href="#glo:xifinlistcs"><code class="csfmt">\xifinlistcs</code></a> to determine if <span class="meta">〈<em class="metainner">item</em>〉</span> is in the list stored in the given field. <a href="#sec:listfields">§5.14</a>; <a href="#wrglossary.7880">305</a><p>
+<div class="defnbox"><a id="wrglossary.19893"></a><dfn id="glo:glsxtrfirstscfont"><code class="csfmt">\glsxtrfirstscfont</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19894"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Maintained for backwards-compatibility used to typeset <span class="meta">〈<em class="metainner">text</em>〉</span> in small capitals (<a id="wrglossary.19895"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a>) for the <span class="qt">“sc”</span> abbreviation styles on <a id="wrglossary.19896"></a><a href="#glo:dual.firstuse">first use</a>.<p>
+<div class="defnbox"><a id="wrglossary.19897"></a><dfn id="glo:glsxtrfirstsmfont"><code class="csfmt">\glsxtrfirstsmfont</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19898"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Maintained for backwards-compatibility used to typeset <span class="meta">〈<em class="metainner">text</em>〉</span> in a smaller font (<a id="wrglossary.19899"></a><a href="#glo:textsmaller"><code class="csfmt">\textsmaller</code></a>) for the <span class="qt">“sm”</span> abbreviation styles on <a id="wrglossary.19900"></a><a href="#glo:dual.firstuse">first use</a>.<p>
+<div class="defnbox"><a id="wrglossary.19901"></a><a href="#glo:Glsxtrfmt"><code class="csfmt">\Glsxtrfmt</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19902"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.19903"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a> but applies a <a id="wrglossary.19904"></a><a href="#glo:idx.sentencecase">sentence case</a> change to <span class="meta">〈<em class="metainner">text</em>〉</span>. <a href="#sec:glsxtrfmt">§5.12.2</a>; <a href="#wrglossary.7739">298</a><p>
+<div class="defnbox"><a id="wrglossary.19905"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19906"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Behaves like <code class="code"><a id="wrglossary.19907"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="cmdfmt">\<span class="meta">〈<em class="metainner">csname</em>〉</span></span>{<span class="meta">〈<em class="metainner">text</em>〉</span>}<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code> where the control sequence name <span class="meta">〈<em class="metainner">csname</em>〉</span> is obtained from the field given by <a id="wrglossary.19908"></a><a href="#glo:GlsXtrFmtField"><code class="csfmt">\GlsXtrFmtField</code></a>. The actual format of the <a id="wrglossary.19909"></a><a href="#glo:dual.linktext">link text</a> is governed by <a id="wrglossary.19910"></a><a href="#glo:glsxtrfmtdisplay"><code class="csfmt">\glsxtrfmtdisplay</code></a>. <a href="#sec:glsxtrfmt">§5.12.2</a>; <a href="#wrglossary.7690">295</a><p>
+<div class="defnbox"><a id="wrglossary.19911"></a><a href="#glo:Glsxtrfmt*"><code class="csfmt">\Glsxtrfmt*</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.19912"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.19913"></a><a href="#glo:glsxtrfmt*"><code class="csfmt">\glsxtrfmt*</code></a> but applies a <a id="wrglossary.19914"></a><a href="#glo:idx.sentencecase">sentence case</a> change to <span class="meta">〈<em class="metainner">text</em>〉</span>. <a href="#sec:glsxtrfmt">§5.12.2</a>; <a href="#wrglossary.7742">298</a><p>
+<div class="defnbox"><a id="wrglossary.19915"></a><dfn id="glo:glsxtrfmt*"><code class="csfmt">\glsxtrfmt*</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.19916"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.23+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As the unstarred version <a id="wrglossary.19917"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a> but accepts the final <span class="meta">〈<em class="metainner">insert</em>〉</span> option.<p>
+<div class="defnbox"><a id="wrglossary.19918"></a><a href="#glo:GlsXtrFmtDefaultOptions"><code class="csfmt">\GlsXtrFmtDefaultOptions</code></a><span class="floatrightbox"><span class="summarytag">initial: </span>noindex; <a id="wrglossary.19919"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the default options for <a id="wrglossary.19920"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a>. <a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4750">188</a><p>
+<div class="defnbox"><a id="wrglossary.19921"></a><a href="#glo:glsxtrfmtdisplay"><code class="csfmt">\glsxtrfmtdisplay</code></a><code class="code">{<span class="meta">〈<em class="metainner">csname</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19922"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.23+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the <a id="wrglossary.19923"></a><a href="#glo:dual.linktext">link text</a> used in <a id="wrglossary.19924"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a>. <a href="#sec:glsxtrfmt">§5.12.2</a>; <a href="#wrglossary.7693">296</a><p>
+<div class="defnbox"><a id="wrglossary.19925"></a><a href="#glo:glsxtrfmtexternalnameref"><code class="csfmt">\glsxtrfmtexternalnameref</code></a><code class="code">{<span class="meta">〈<em class="metainner">target</em>〉</span>}{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">title</em>〉</span>}{<span class="meta">〈<em class="metainner">file</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19926"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.19927"></a><a href="#glo:glsxtrnamereflink"><code class="csfmt">\glsxtrnamereflink</code></a> to create an external <a id="wrglossary.19928"></a><a href="#glo:@@glslabel@entrylocation">location</a> hyperlink. <a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13637">559</a><p>
+<div class="defnbox"><a id="wrglossary.19929"></a><a href="#glo:GlsXtrFmtField"><code class="csfmt">\GlsXtrFmtField</code></a><span class="floatrightbox"><span class="summarytag">initial: </span>useri; <a id="wrglossary.19930"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the name of the <a id="wrglossary.19931"></a><a href="#glo:@@glslabel@internalfieldlabel">u</a>sed by <a id="wrglossary.19932"></a><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a>. <a href="#sec:glsxtrfmt">§5.12.2</a>; <a href="#wrglossary.7687">295</a><p>
+<div class="defnbox"><a id="wrglossary.19933"></a><a href="#glo:glsxtrfmtinternalnameref"><code class="csfmt">\glsxtrfmtinternalnameref</code></a><code class="code">{<span class="meta">〈<em class="metainner">target</em>〉</span>}{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">file</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19934"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.19935"></a><a href="#glo:glsxtrnamereflink"><code class="csfmt">\glsxtrnamereflink</code></a> to create an internal <a id="wrglossary.19936"></a><a href="#glo:@@glslabel@entrylocation">location</a> hyperlink. <a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13636">559</a><p>
+<div class="defnbox"><a id="wrglossary.19937"></a><a href="#glo:glsxtrfootnotedescname"><code class="csfmt">\glsxtrfootnotedescname</code></a><span class="floatrightbox"><a id="wrglossary.19938"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the name value for styles like <a id="wrglossary.19939"></a><a href="#glo:opt.abbrstyle.short-footnote-desc"><span class="abbrstylefmt">short-footnote-desc</span></a>. <a href="#wrglossary.3580">144</a><p>
+<div class="defnbox"><a id="wrglossary.19940"></a><a href="#glo:glsxtrfootnotedescsort"><code class="csfmt">\glsxtrfootnotedescsort</code></a><span class="floatrightbox"><a id="wrglossary.19941"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the sort value for styles like <a id="wrglossary.19942"></a><a href="#glo:opt.abbrstyle.short-footnote-desc"><span class="abbrstylefmt">short-footnote-desc</span></a>. <a href="#wrglossary.3592">145</a><p>
+<div class="defnbox"><a id="wrglossary.19943"></a><a href="#glo:glsxtrfootnotelongformat"><code class="csfmt">\glsxtrfootnotelongformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19944"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used in the footnote text to format the singular long form. <a href="#wrglossary.3605">145</a><p>
+<div class="defnbox"><a id="wrglossary.19945"></a><a href="#glo:glsxtrfootnotelongplformat"><code class="csfmt">\glsxtrfootnotelongplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19946"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used in the footnote text to format the plural long form. <a href="#wrglossary.3616">146</a><p>
+<div class="defnbox"><a id="wrglossary.19947"></a><a href="#glo:glsxtrfootnotename"><code class="csfmt">\glsxtrfootnotename</code></a><span class="floatrightbox"><a id="wrglossary.19948"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.25+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the name value for styles like <a id="wrglossary.19949"></a><a href="#glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">short-footnote</span></a>. <a href="#wrglossary.3575">144</a><p>
+<div class="defnbox"><a id="wrglossary.19950"></a><a href="#glo:glsxtrforcsvfield"><code class="csfmt">\glsxtrforcsvfield</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">handler cs</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.19951"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.24+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Iterates over the comma-separated list stored in the given <a id="wrglossary.19952"></a><a href="#glo:dual.field">field</a> (identified by its <a id="wrglossary.19953"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a>) for the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> and performs <code class="code"><span class="meta">〈<em class="metainner">handler cs</em>〉</span>{<span class="meta">〈<em class="metainner">element</em>〉</span>}</code> for each element of the list. This command uses <a id="wrglossary.19954"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a> so the complete list can be obtained with <a id="wrglossary.19955"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a>. The unstarred version adds implicit grouping. The starred version doesn’t. <a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7804">301</a><p>
+<div class="defnbox"><a id="wrglossary.19956"></a><a href="#glo:GlsXtrForeignText"><code class="csfmt">\GlsXtrForeignText</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19957"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.32+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> has the field identified by <a id="wrglossary.19958"></a><a href="#glo:GlsXtrForeignTextField"><code class="csfmt">\GlsXtrForeignTextField</code></a> then <span class="meta">〈<em class="metainner">text</em>〉</span> will be encapsulated according to the language tag stored in that field (using <a id="wrglossary.19959"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span>’s</a> interface). <a href="#sec:foreignfield">§5.12.1</a>; <a href="#wrglossary.7655">293</a><p>
+<div class="defnbox"><a id="wrglossary.19960"></a><a href="#glo:GlsXtrForeignTextField"><code class="csfmt">\GlsXtrForeignTextField</code></a><span class="floatrightbox"><a id="wrglossary.19961"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.32+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the <a id="wrglossary.19962"></a><a href="#glo:dual.internalfieldlabel">internal field label</a> used by <a id="wrglossary.19963"></a><a href="#glo:GlsXtrForeignText"><code class="csfmt">\GlsXtrForeignText</code></a>. <a href="#sec:foreignfield">§5.12.1</a>; <a href="#wrglossary.7652">293</a><p>
+<div class="defnbox"><a id="wrglossary.19964"></a><a href="#glo:GlsXtrFormatLocationList"><code class="csfmt">\GlsXtrFormatLocationList</code></a><code class="code">{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.19965"></a><a href="#glo:glossaryentrynumbers"><code class="csfmt">\glossaryentrynumbers</code></a> to encapsulate the entire <a id="wrglossary.19966"></a><a href="#glo:dual.locationlist">location list</a> in the <a id="wrglossary.19967"></a><a href="#glo:dual.glossary">glossary</a>. <a href="#sec:glosstylenumlist">§8.6.3</a>; <a href="#wrglossary.10771">423</a><p>
+<div class="defnbox"><a id="wrglossary.19968"></a><a href="#glo:GlsXtrForUnsetBufferedList"><code class="csfmt">\GlsXtrForUnsetBufferedList</code></a><code class="code">{<span class="meta">〈<em class="metainner">handler-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.19969"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Iterates over the labels stored in the current buffer. <a href="#sec:unsetbuffer">§5.10.1</a>; <a href="#wrglossary.7471">285</a><p>
+<div class="defnbox"><a id="wrglossary.19970"></a><a href="#glo:glsxtrfractionrules"><code class="csfmt">\glsxtrfractionrules</code></a><span class="floatrightbox"><a id="wrglossary.19971"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the number forms fraction character sort rules. <a href="#wrglossary.13300">546</a><p>
+<div class="defnbox"><a id="wrglossary.19972"></a><a href="#glo:GLSxtrfull"><code class="csfmt">\GLSxtrfull</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.19973"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.19974"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.19975"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.19976"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> but converts the <a id="wrglossary.19977"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.19978"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1576">54</a><p>
+<div class="defnbox"><a id="wrglossary.19979"></a><a href="#glo:Glsxtrfull"><code class="csfmt">\Glsxtrfull</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.19980"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.19981"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.19982"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.19983"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> but converts the first character of the <a id="wrglossary.19984"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.19985"></a><a href="#glo:idx.uppercase">uppercase</a><a id="wrglossary.19986"></a> (for the start of a sentence) using <a id="wrglossary.19987"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. <a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1571">53</a><p>
+<div class="defnbox"><a id="wrglossary.19988"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.19989"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.19990"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.19991"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The text produced is obtained from the <a id="wrglossary.19992"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> and <a id="wrglossary.19993"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> values, formatted according to the <a id="wrglossary.19994"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> associated with the entry’s <a id="wrglossary.19995"></a><a href="#glo:idx.category">category</a>. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument will be inserted at the end of the <a id="wrglossary.19996"></a><a href="#glo:dual.linktext">link text</a>. This command does not alter or depend on the <a id="wrglossary.19997"></a><a href="#glo:dual.firstuseflag">first use flag</a>. The format produced by this command may not match the format produced by the <a id="wrglossary.19998"></a><a href="#glo:dual.firstuse">first use</a> of <code class="code"><a id="wrglossary.19999"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>, depending on the abbreviation style. For the first optional argument, see <a id="wrglossary.20000"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>. <a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1564">53</a><p>
+<div class="defnbox"><a id="wrglossary.20001"></a><a href="#glo:GLSxtrfullformat"><code class="csfmt">\GLSxtrfullformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20002"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.20003"></a><a href="#glo:idx.allcaps">all caps</a> singular <a id="wrglossary.20004"></a><a href="#glo:dual.displayfullform">display full form</a> (defined by the abbreviation style). <a href="#wrglossary.4355">173</a><p>
+<div class="defnbox"><a id="wrglossary.20005"></a><a href="#glo:Glsxtrfullformat"><code class="csfmt">\Glsxtrfullformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20006"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.20007"></a><a href="#glo:idx.sentencecase">sentence case</a> singular <a id="wrglossary.20008"></a><a href="#glo:dual.displayfullform">display full form</a> (defined by the abbreviation style). <a href="#wrglossary.4345">172</a><p>
+<div class="defnbox"><a id="wrglossary.20009"></a><a href="#glo:glsxtrfullformat"><code class="csfmt">\glsxtrfullformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20010"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The singular <a id="wrglossary.20011"></a><a href="#glo:dual.displayfullform">display full form</a> (defined by the abbreviation style). <a href="#wrglossary.4337">172</a><p>
+<div class="defnbox"><a id="wrglossary.20012"></a><a href="#glo:GLSxtrfullpl"><code class="csfmt">\GLSxtrfullpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.20013"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.20014"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.20015"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20016"></a><a href="#glo:glsxtrfullpl"><code class="csfmt">\glsxtrfullpl</code></a> but converts the <a id="wrglossary.20017"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.20018"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1593">54</a><p>
+<div class="defnbox"><a id="wrglossary.20019"></a><a href="#glo:Glsxtrfullpl"><code class="csfmt">\Glsxtrfullpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.20020"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.20021"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.20022"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20023"></a><a href="#glo:glsxtrfullpl"><code class="csfmt">\glsxtrfullpl</code></a> but converts the first character of the <a id="wrglossary.20024"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.20025"></a><a href="#glo:idx.uppercase">uppercase</a><a id="wrglossary.20026"></a> (for the start of a sentence) using <a id="wrglossary.20027"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. <a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1588">54</a><p>
+<div class="defnbox"><a id="wrglossary.20028"></a><a href="#glo:glsxtrfullpl"><code class="csfmt">\glsxtrfullpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.20029"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.20030"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.20031"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The text produced is obtained from the <a id="wrglossary.20032"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> and <a id="wrglossary.20033"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> values, formatted according to the <a id="wrglossary.20034"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> associated with the entry’s <a id="wrglossary.20035"></a><a href="#glo:idx.category">category</a>. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument will be inserted at the end of the <a id="wrglossary.20036"></a><a href="#glo:dual.linktext">link text</a>. This command does not alter or depend on the <a id="wrglossary.20037"></a><a href="#glo:dual.firstuseflag">first use flag</a>. The format produced by this command may not match the format produced by the <a id="wrglossary.20038"></a><a href="#glo:dual.firstuse">first use</a> of <code class="code"><a id="wrglossary.20039"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>, depending on the abbreviation style. For the first optional argument, see <a id="wrglossary.20040"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>. <a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1581">54</a><p>
+<div class="defnbox"><a id="wrglossary.20041"></a><a href="#glo:GLSxtrfullplformat"><code class="csfmt">\GLSxtrfullplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20042"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.20043"></a><a href="#glo:idx.allcaps">all caps</a> plural <a id="wrglossary.20044"></a><a href="#glo:dual.displayfullform">display full form</a> (defined by the abbreviation style). <a href="#wrglossary.4360">173</a><p>
+<div class="defnbox"><a id="wrglossary.20045"></a><a href="#glo:Glsxtrfullplformat"><code class="csfmt">\Glsxtrfullplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20046"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.20047"></a><a href="#glo:idx.sentencecase">sentence case</a> plural <a id="wrglossary.20048"></a><a href="#glo:dual.displayfullform">display full form</a> (defined by the abbreviation style). <a href="#wrglossary.4350">172</a><p>
+<div class="defnbox"><a id="wrglossary.20049"></a><a href="#glo:glsxtrfullplformat"><code class="csfmt">\glsxtrfullplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20050"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The plural <a id="wrglossary.20051"></a><a href="#glo:dual.displayfullform">display full form</a> (defined by the abbreviation style). <a href="#wrglossary.4341">172</a><p>
+<div class="defnbox"><a id="wrglossary.20052"></a><a href="#glo:glsxtrfullsaveinsert"><code class="csfmt">\glsxtrfullsaveinsert</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20053"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Implemented at the start of all the <a id="wrglossary.20054"></a><a href="#glo:dual.inlinefullform">inline full form</a> commands like <a id="wrglossary.20055"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> to save the <a id="wrglossary.20056"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a> placeholder. By default, this just does <a id="wrglossary.20057"></a><a href="#glo:glsxtrsaveinsert"><code class="csfmt">\glsxtrsaveinsert</code></a>. <a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1606">54</a><p>
+<div class="defnbox"><a id="wrglossary.20058"></a><a href="#glo:glsxtrfullsep"><code class="csfmt">\glsxtrfullsep</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Separator used by the parenthetical <a id="wrglossary.20059"></a><a href="#glo:dual.inlinefullform">inline full form</a> and also for some <a id="wrglossary.20060"></a><a href="#glo:dual.displayfullform">display full forms</a>. <a href="#wrglossary.3264">132</a><p>
+<div class="defnbox"><a id="wrglossary.20061"></a><a href="#glo:glsxtrgenabbrvfmt"><code class="csfmt">\glsxtrgenabbrvfmt</code></a></div><!-- end of defnbox -->
+<p>
+The display format used by <a id="wrglossary.20062"></a><a href="#glo:glsentryfmt"><code class="csfmt">\glsentryfmt</code></a> for entries that have the <a id="wrglossary.20063"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> field set and have the <a id="wrglossary.20064"></a><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a> attribute set to <code class="code">false</code>. <a href="#sec:entryfmt">§5.5.5</a>; <a href="#wrglossary.6549">255</a><p>
+<div class="defnbox"><a id="wrglossary.20065"></a><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a><span class="floatrightbox"><a id="wrglossary.20066"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Redefined by the <a id="wrglossary.20067"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.20068"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> hooks to set up the <a id="wrglossary.20069"></a><a href="#glo:dual.innerformatting">inner formatting</a>. Initialised to <a id="wrglossary.20070"></a><a href="#glo:glsxtrdefaultentrytextfmt"><code class="csfmt">\glsxtrdefaultentrytextfmt</code></a>. <a href="#sec:innertextformat">§5.5.3</a>; <a href="#wrglossary.6208">243</a><p>
+<div class="defnbox"><a id="wrglossary.20071"></a><a href="#glo:glsxtrGeneralInitRules"><code class="csfmt">\glsxtrGeneralInitRules</code></a><span class="floatrightbox"><a id="wrglossary.20072"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A shortcut that expands to the ignorable rules, combining diacritic rules, hyphen rules, general punctuation rules, digit rules, and fraction rules. <a href="#wrglossary.13305">546</a><p>
+<div class="defnbox"><a id="wrglossary.20073"></a><a href="#glo:glsxtrGeneralLatinAtoGrules"><code class="csfmt">\glsxtrGeneralLatinAtoGrules</code></a><span class="floatrightbox"><a id="wrglossary.20074"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the A–G subset of General Latin I sort rules. <a href="#wrglossary.13330">548</a><p>
+<div class="defnbox"><a id="wrglossary.20075"></a><a href="#glo:glsxtrGeneralLatinAtoMrules"><code class="csfmt">\glsxtrGeneralLatinAtoMrules</code></a><span class="floatrightbox"><a id="wrglossary.20076"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the A–M subset of General Latin I sort rules. <a href="#wrglossary.13328">548</a><p>
+<div class="defnbox"><a id="wrglossary.20077"></a><a href="#glo:glsxtrGeneralLatinHtoMrules"><code class="csfmt">\glsxtrGeneralLatinHtoMrules</code></a><span class="floatrightbox"><a id="wrglossary.20078"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the H–M subset of General Latin I sort rules. <a href="#wrglossary.13331">548</a><p>
+<div class="defnbox"><a id="wrglossary.20079"></a><a href="#glo:glsxtrGeneralLatinIIIrules"><code class="csfmt">\glsxtrGeneralLatinIIIrules</code></a><span class="floatrightbox"><a id="wrglossary.20080"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the third set of General Latin sort rules. <a href="#wrglossary.13316">547</a><p>
+<div class="defnbox"><a id="wrglossary.20081"></a><a href="#glo:glsxtrGeneralLatinIIrules"><code class="csfmt">\glsxtrGeneralLatinIIrules</code></a><span class="floatrightbox"><a id="wrglossary.20082"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the second set of General Latin sort rules. <a href="#wrglossary.13314">547</a><p>
+<div class="defnbox"><a id="wrglossary.20083"></a><a href="#glo:glsxtrGeneralLatinIrules"><code class="csfmt">\glsxtrGeneralLatinIrules</code></a><span class="floatrightbox"><a id="wrglossary.20084"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the first set of General Latin sort rules. <a href="#wrglossary.13312">546</a><p>
+<div class="defnbox"><a id="wrglossary.20085"></a><a href="#glo:glsxtrGeneralLatinIVrules"><code class="csfmt">\glsxtrGeneralLatinIVrules</code></a><span class="floatrightbox"><a id="wrglossary.20086"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the fourth set of General Latin sort rules. <a href="#wrglossary.13318">547</a><p>
+<div class="defnbox"><a id="wrglossary.20087"></a><a href="#glo:glsxtrGeneralLatinNtoSrules"><code class="csfmt">\glsxtrGeneralLatinNtoSrules</code></a><span class="floatrightbox"><a id="wrglossary.20088"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the N–S subset of General Latin I sort rules. <a href="#wrglossary.13332">548</a><p>
+<div class="defnbox"><a id="wrglossary.20089"></a><a href="#glo:glsxtrGeneralLatinNtoZrules"><code class="csfmt">\glsxtrGeneralLatinNtoZrules</code></a><span class="floatrightbox"><a id="wrglossary.20090"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the N–Z subset of General Latin I sort rules. <a href="#wrglossary.13329">548</a><p>
+<div class="defnbox"><a id="wrglossary.20091"></a><a href="#glo:glsxtrGeneralLatinTtoZrules"><code class="csfmt">\glsxtrGeneralLatinTtoZrules</code></a><span class="floatrightbox"><a id="wrglossary.20092"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the T–Z subset of General Latin I sort rules. <a href="#wrglossary.13333">548</a><p>
+<div class="defnbox"><a id="wrglossary.20093"></a><a href="#glo:glsxtrGeneralLatinVIIIrules"><code class="csfmt">\glsxtrGeneralLatinVIIIrules</code></a><span class="floatrightbox"><a id="wrglossary.20094"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the eighth set of General Latin sort rules. <a href="#wrglossary.13326">547</a><p>
+<div class="defnbox"><a id="wrglossary.20095"></a><a href="#glo:glsxtrGeneralLatinVIIrules"><code class="csfmt">\glsxtrGeneralLatinVIIrules</code></a><span class="floatrightbox"><a id="wrglossary.20096"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the seventh set of General Latin sort rules. <a href="#wrglossary.13324">547</a><p>
+<div class="defnbox"><a id="wrglossary.20097"></a><a href="#glo:glsxtrGeneralLatinVIrules"><code class="csfmt">\glsxtrGeneralLatinVIrules</code></a><span class="floatrightbox"><a id="wrglossary.20098"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the sixth set of General Latin sort rules. <a href="#wrglossary.13322">547</a><p>
+<div class="defnbox"><a id="wrglossary.20099"></a><a href="#glo:glsxtrGeneralLatinVrules"><code class="csfmt">\glsxtrGeneralLatinVrules</code></a><span class="floatrightbox"><a id="wrglossary.20100"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the fifth set of General Latin sort rules. <a href="#wrglossary.13320">547</a><p>
+<div class="defnbox"><a id="wrglossary.20101"></a><a href="#glo:glsxtrgeneralpuncaccentsrules"><code class="csfmt">\glsxtrgeneralpuncaccentsrules</code></a><span class="floatrightbox"><a id="wrglossary.20102"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Punctuation accent subset of <a id="wrglossary.20103"></a><a href="#glo:glsxtrgeneralpuncIrules"><code class="csfmt">\glsxtrgeneralpuncIrules</code></a>. <a href="#wrglossary.13290">544</a><p>
+<div class="defnbox"><a id="wrglossary.20104"></a><a href="#glo:glsxtrgeneralpuncbracketrules"><code class="csfmt">\glsxtrgeneralpuncbracketrules</code></a><span class="floatrightbox"><a id="wrglossary.20105"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Punctuation bracket subset of <a id="wrglossary.20106"></a><a href="#glo:glsxtrgeneralpuncIrules"><code class="csfmt">\glsxtrgeneralpuncIrules</code></a>. <a href="#wrglossary.13292">544</a><p>
+<div class="defnbox"><a id="wrglossary.20107"></a><a href="#glo:glsxtrgeneralpuncIIrules"><code class="csfmt">\glsxtrgeneralpuncIIrules</code></a><span class="floatrightbox"><a id="wrglossary.20108"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the second set of general punctuation (including currency) sort rules. <a href="#wrglossary.13295">545</a><p>
+<div class="defnbox"><a id="wrglossary.20109"></a><a href="#glo:glsxtrgeneralpuncIrules"><code class="csfmt">\glsxtrgeneralpuncIrules</code></a><span class="floatrightbox"><a id="wrglossary.20110"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the first set of general punctuation (including currency) sort rules. <a href="#wrglossary.13281">544</a><p>
+<div class="defnbox"><a id="wrglossary.20111"></a><a href="#glo:glsxtrgeneralpuncmarksrules"><code class="csfmt">\glsxtrgeneralpuncmarksrules</code></a><span class="floatrightbox"><a id="wrglossary.20112"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Punctuation mark subset of <a id="wrglossary.20113"></a><a href="#glo:glsxtrgeneralpuncIrules"><code class="csfmt">\glsxtrgeneralpuncIrules</code></a>. <a href="#wrglossary.13288">544</a><p>
+<div class="defnbox"><a id="wrglossary.20114"></a><a href="#glo:glsxtrgeneralpuncquoterules"><code class="csfmt">\glsxtrgeneralpuncquoterules</code></a><span class="floatrightbox"><a id="wrglossary.20115"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Punctuation quote subset of <a id="wrglossary.20116"></a><a href="#glo:glsxtrgeneralpuncIrules"><code class="csfmt">\glsxtrgeneralpuncIrules</code></a>. <a href="#wrglossary.13291">544</a><p>
+<div class="defnbox"><a id="wrglossary.20117"></a><a href="#glo:glsxtrgeneralpuncrules"><code class="csfmt">\glsxtrgeneralpuncrules</code></a><span class="floatrightbox"><a id="wrglossary.20118"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to all sets of general punctuation sort rules. <a href="#wrglossary.13274">543</a><p>
+<div class="defnbox"><a id="wrglossary.20119"></a><a href="#glo:glsxtrgeneralpuncsignrules"><code class="csfmt">\glsxtrgeneralpuncsignrules</code></a><span class="floatrightbox"><a id="wrglossary.20120"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Punctuation sign subset of <a id="wrglossary.20121"></a><a href="#glo:glsxtrgeneralpuncIrules"><code class="csfmt">\glsxtrgeneralpuncIrules</code></a>. <a href="#wrglossary.13293">545</a><p>
+<div class="defnbox"><a id="wrglossary.20122"></a><a href="#glo:glsxtrgetgrouptitle"><code class="csfmt">\glsxtrgetgrouptitle</code></a><code class="code">{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20123"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Obtains the title corresponding to the <a id="wrglossary.20124"></a><a href="#glo:idx.group">group</a> identified by <span class="meta">〈<em class="metainner">group-label</em>〉</span> and stores the result in the control sequence <span class="meta">〈<em class="metainner">cs</em>〉</span>. <a href="#sec:glosgroups">§8.6.4</a>; <a href="#wrglossary.10848">426</a><p>
+<div class="defnbox"><a id="wrglossary.20125"></a><a href="#glo:glsxtrgroupfield"><code class="csfmt">\glsxtrgroupfield</code></a><span class="floatrightbox"><span class="summarytag">initial: </span>group; <a id="wrglossary.20126"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the <a id="wrglossary.20127"></a><a href="#glo:dual.internalfieldlabel">internal field label</a> used to store the group label (requires <a id="wrglossary.20128"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>). <a href="#sec:printunsrtgroups">§8.4.1</a>; <a href="#wrglossary.9859">389</a><p>
+<div class="defnbox"><a id="wrglossary.20129"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20130"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used for standalone entries to display the name with <a id="wrglossary.20131"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a>, with appropriate hooks. <a href="#sec:glossentry">§8.5</a>; <a href="#wrglossary.10544">414</a><p>
+<div class="defnbox"><a id="wrglossary.20132"></a><a href="#glo:glsxtrglossentryother"><code class="csfmt">\glsxtrglossentryother</code></a><code class="code">{<span class="meta">〈<em class="metainner">header</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20133"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.22+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.20134"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a> but uses the given field instead of <a id="wrglossary.20135"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>. <a href="#sec:glossentry">§8.5</a>; <a href="#wrglossary.10579">415</a><p>
+<div class="defnbox"><a id="wrglossary.20136"></a><a href="#glo:GLSxtrheadfirst"><code class="csfmt">\GLSxtrheadfirst</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20137"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the <a id="wrglossary.20138"></a><a href="#glo:idx.allcaps">all caps</a> entry’s <a id="wrglossary.20139"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> <a id="wrglossary.20140"></a><a href="#glo:dual.field">field</a> in the page header. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5787">226</a><p>
+<div class="defnbox"><a id="wrglossary.20141"></a><a href="#glo:Glsxtrheadfirst"><code class="csfmt">\Glsxtrheadfirst</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used to display the <a id="wrglossary.20142"></a><a href="#glo:idx.sentencecase">sentence case</a> entry’s <a id="wrglossary.20143"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> <a id="wrglossary.20144"></a><a href="#glo:dual.field">field</a> in the page header (converts to <a id="wrglossary.20145"></a><a href="#glo:idx.allcaps">all caps</a> if <a id="wrglossary.20146"></a><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a> attribute is <code class="code">true</code>). <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5779">225</a><p>
+<div class="defnbox"><a id="wrglossary.20147"></a><a href="#glo:glsxtrheadfirst"><code class="csfmt">\glsxtrheadfirst</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used to display the entry’s <a id="wrglossary.20148"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> <a id="wrglossary.20149"></a><a href="#glo:dual.field">field</a> in the page header (converts to <a id="wrglossary.20150"></a><a href="#glo:idx.allcaps">all caps</a> if <a id="wrglossary.20151"></a><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a> attribute is <code class="code">true</code>). <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5772">225</a><p>
+<div class="defnbox"><a id="wrglossary.20152"></a><a href="#glo:GLSxtrheadfirstplural"><code class="csfmt">\GLSxtrheadfirstplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20153"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the <a id="wrglossary.20154"></a><a href="#glo:idx.allcaps">all caps</a> entry’s <a id="wrglossary.20155"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> <a id="wrglossary.20156"></a><a href="#glo:dual.field">field</a> in the page header. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5809">226</a><p>
+<div class="defnbox"><a id="wrglossary.20157"></a><a href="#glo:Glsxtrheadfirstplural"><code class="csfmt">\Glsxtrheadfirstplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used to display the <a id="wrglossary.20158"></a><a href="#glo:idx.sentencecase">sentence case</a> entry’s <a id="wrglossary.20159"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> <a id="wrglossary.20160"></a><a href="#glo:dual.field">field</a> in the page header (converts to <a id="wrglossary.20161"></a><a href="#glo:idx.allcaps">all caps</a> if <a id="wrglossary.20162"></a><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a> attribute is <code class="code">true</code>). <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5801">226</a><p>
+<div class="defnbox"><a id="wrglossary.20163"></a><a href="#glo:glsxtrheadfirstplural"><code class="csfmt">\glsxtrheadfirstplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used to display the entry’s <a id="wrglossary.20164"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> <a id="wrglossary.20165"></a><a href="#glo:dual.field">field</a> in the page header (converts to <a id="wrglossary.20166"></a><a href="#glo:idx.allcaps">all caps</a> if <a id="wrglossary.20167"></a><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a> attribute is <code class="code">true</code>). <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5794">226</a><p>
+<div class="defnbox"><a id="wrglossary.20168"></a><a href="#glo:GLSxtrheadfull"><code class="csfmt">\GLSxtrheadfull</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20169"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the entry’s <a id="wrglossary.20170"></a><a href="#glo:idx.allcaps">all caps</a> full form in the page header. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5684">222</a><p>
+<div class="defnbox"><a id="wrglossary.20171"></a><a href="#glo:Glsxtrheadfull"><code class="csfmt">\Glsxtrheadfull</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20172"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the entry’s <a id="wrglossary.20173"></a><a href="#glo:idx.sentencecase">sentence case</a> full form in the page header (converts to <a id="wrglossary.20174"></a><a href="#glo:idx.allcaps">all caps</a> if <a id="wrglossary.20175"></a><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a> attribute is <code class="code">true</code>). <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5678">222</a><p>
+<div class="defnbox"><a id="wrglossary.20176"></a><a href="#glo:glsxtrheadfull"><code class="csfmt">\glsxtrheadfull</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20177"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the entry’s full form in the page header (converts to <a id="wrglossary.20178"></a><a href="#glo:idx.allcaps">all caps</a> if <a id="wrglossary.20179"></a><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a> attribute is <code class="code">true</code>). <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5673">221</a><p>
+<div class="defnbox"><a id="wrglossary.20180"></a><a href="#glo:GLSxtrheadfullpl"><code class="csfmt">\GLSxtrheadfullpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20181"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the entry’s <a id="wrglossary.20182"></a><a href="#glo:idx.allcaps">all caps</a> full plural form in the page header. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5700">223</a><p>
+<div class="defnbox"><a id="wrglossary.20183"></a><a href="#glo:Glsxtrheadfullpl"><code class="csfmt">\Glsxtrheadfullpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20184"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the entry’s <a id="wrglossary.20185"></a><a href="#glo:idx.sentencecase">sentence case</a> full plural form in the page header (converts to <a id="wrglossary.20186"></a><a href="#glo:idx.allcaps">all caps</a> if <a id="wrglossary.20187"></a><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a> attribute is <code class="code">true</code>). <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5694">222</a><p>
+<div class="defnbox"><a id="wrglossary.20188"></a><a href="#glo:glsxtrheadfullpl"><code class="csfmt">\glsxtrheadfullpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20189"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the entry’s full plural form in the page header (converts to <a id="wrglossary.20190"></a><a href="#glo:idx.allcaps">all caps</a> if <a id="wrglossary.20191"></a><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a> attribute is <code class="code">true</code>). <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5689">222</a><p>
+<div class="defnbox"><a id="wrglossary.20192"></a><a href="#glo:GLSxtrheadlong"><code class="csfmt">\GLSxtrheadlong</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20193"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The behaviour of <a id="wrglossary.20194"></a><a href="#glo:GLSfmtlong"><code class="csfmt">\GLSfmtlong</code></a> when it occurs in a page header. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5652">220</a><p>
+<div class="defnbox"><a id="wrglossary.20195"></a><a href="#glo:Glsxtrheadlong"><code class="csfmt">\Glsxtrheadlong</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20196"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The behaviour of <a id="wrglossary.20197"></a><a href="#glo:Glsfmtlong"><code class="csfmt">\Glsfmtlong</code></a> when it occurs in a page header. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5646">220</a><p>
+<div class="defnbox"><a id="wrglossary.20198"></a><a href="#glo:glsxtrheadlong"><code class="csfmt">\glsxtrheadlong</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20199"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The behaviour of <a id="wrglossary.20200"></a><a href="#glo:glsfmtlong"><code class="csfmt">\glsfmtlong</code></a> when it occurs in a page header. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5641">220</a><p>
+<div class="defnbox"><a id="wrglossary.20201"></a><a href="#glo:GLSxtrheadlongpl"><code class="csfmt">\GLSxtrheadlongpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20202"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The behaviour of <a id="wrglossary.20203"></a><a href="#glo:GLSfmtlongpl"><code class="csfmt">\GLSfmtlongpl</code></a> when it occurs in a page header. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5668">221</a><p>
+<div class="defnbox"><a id="wrglossary.20204"></a><a href="#glo:Glsxtrheadlongpl"><code class="csfmt">\Glsxtrheadlongpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20205"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The behaviour of <a id="wrglossary.20206"></a><a href="#glo:Glsfmtlongpl"><code class="csfmt">\Glsfmtlongpl</code></a> when it occurs in a page header. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5662">221</a><p>
+<div class="defnbox"><a id="wrglossary.20207"></a><a href="#glo:glsxtrheadlongpl"><code class="csfmt">\glsxtrheadlongpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20208"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The behaviour of <a id="wrglossary.20209"></a><a href="#glo:glsfmtlongpl"><code class="csfmt">\glsfmtlongpl</code></a> when it occurs in a page header. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5657">221</a><p>
+<div class="defnbox"><a id="wrglossary.20210"></a><a href="#glo:GLSxtrheadname"><code class="csfmt">\GLSxtrheadname</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20211"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the <a id="wrglossary.20212"></a><a href="#glo:idx.allcaps">all caps</a> entry’s <a id="wrglossary.20213"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> <a id="wrglossary.20214"></a><a href="#glo:dual.field">field</a> in the page header. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5721">223</a><p>
+<div class="defnbox"><a id="wrglossary.20215"></a><a href="#glo:Glsxtrheadname"><code class="csfmt">\Glsxtrheadname</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20216"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the <a id="wrglossary.20217"></a><a href="#glo:idx.sentencecase">sentence case</a> entry’s name in the page header (converts to <a id="wrglossary.20218"></a><a href="#glo:idx.allcaps">all caps</a> if <a id="wrglossary.20219"></a><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a> attribute is <code class="code">true</code>). <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5713">223</a><p>
+<div class="defnbox"><a id="wrglossary.20220"></a><a href="#glo:glsxtrheadname"><code class="csfmt">\glsxtrheadname</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20221"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the entry’s name in the page header (converts to <a id="wrglossary.20222"></a><a href="#glo:idx.allcaps">all caps</a> if <a id="wrglossary.20223"></a><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a> attribute is <code class="code">true</code>). <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5706">223</a><p>
+<div class="defnbox"><a id="wrglossary.20224"></a><a href="#glo:GLSxtrheadplural"><code class="csfmt">\GLSxtrheadplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20225"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the <a id="wrglossary.20226"></a><a href="#glo:idx.allcaps">all caps</a> entry’s <a id="wrglossary.20227"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> <a id="wrglossary.20228"></a><a href="#glo:dual.field">field</a> in the page header. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5765">225</a><p>
+<div class="defnbox"><a id="wrglossary.20229"></a><a href="#glo:Glsxtrheadplural"><code class="csfmt">\Glsxtrheadplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used to display the <a id="wrglossary.20230"></a><a href="#glo:idx.sentencecase">sentence case</a> entry’s <a id="wrglossary.20231"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> <a id="wrglossary.20232"></a><a href="#glo:dual.field">field</a> in the page header (converts to <a id="wrglossary.20233"></a><a href="#glo:idx.allcaps">all caps</a> if <a id="wrglossary.20234"></a><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a> attribute is <code class="code">true</code>). <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5757">225</a><p>
+<div class="defnbox"><a id="wrglossary.20235"></a><a href="#glo:glsxtrheadplural"><code class="csfmt">\glsxtrheadplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used to display the entry’s <a id="wrglossary.20236"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> <a id="wrglossary.20237"></a><a href="#glo:dual.field">field</a> in the page header (converts to <a id="wrglossary.20238"></a><a href="#glo:idx.allcaps">all caps</a> if <a id="wrglossary.20239"></a><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a> attribute is <code class="code">true</code>). <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5750">224</a><p>
+<div class="defnbox"><a id="wrglossary.20240"></a><a href="#glo:GLSxtrheadshort"><code class="csfmt">\GLSxtrheadshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20241"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The behaviour of <a id="wrglossary.20242"></a><a href="#glo:GLSfmtshort"><code class="csfmt">\GLSfmtshort</code></a> when it occurs in a page header. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5600">218</a><p>
+<div class="defnbox"><a id="wrglossary.20243"></a><a href="#glo:Glsxtrheadshort"><code class="csfmt">\Glsxtrheadshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The behaviour of <a id="wrglossary.20244"></a><a href="#glo:Glsfmtshort"><code class="csfmt">\Glsfmtshort</code></a> when it occurs in a page header. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5581">218</a><p>
+<div class="defnbox"><a id="wrglossary.20245"></a><a href="#glo:glsxtrheadshort"><code class="csfmt">\glsxtrheadshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The behaviour of <a id="wrglossary.20246"></a><a href="#glo:glsfmtshort"><code class="csfmt">\glsfmtshort</code></a> when it occurs in a page header. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5560">217</a><p>
+<div class="defnbox"><a id="wrglossary.20247"></a><a href="#glo:GLSxtrheadshortpl"><code class="csfmt">\GLSxtrheadshortpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20248"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The behaviour of <a id="wrglossary.20249"></a><a href="#glo:GLSfmtshortpl"><code class="csfmt">\GLSfmtshortpl</code></a> when it occurs in a page header. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5636">220</a><p>
+<div class="defnbox"><a id="wrglossary.20250"></a><a href="#glo:Glsxtrheadshortpl"><code class="csfmt">\Glsxtrheadshortpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The behaviour of <a id="wrglossary.20251"></a><a href="#glo:Glsfmtshortpl"><code class="csfmt">\Glsfmtshortpl</code></a> when it occurs in a page header. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5630">219</a><p>
+<div class="defnbox"><a id="wrglossary.20252"></a><a href="#glo:glsxtrheadshortpl"><code class="csfmt">\glsxtrheadshortpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20253"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The behaviour of <a id="wrglossary.20254"></a><a href="#glo:glsfmtshortpl"><code class="csfmt">\glsfmtshortpl</code></a> when it occurs in a page header. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5625">219</a><p>
+<div class="defnbox"><a id="wrglossary.20255"></a><a href="#glo:GLSxtrheadtext"><code class="csfmt">\GLSxtrheadtext</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20256"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the <a id="wrglossary.20257"></a><a href="#glo:idx.allcaps">all caps</a> entry’s <a id="wrglossary.20258"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> <a id="wrglossary.20259"></a><a href="#glo:dual.field">field</a> in the page header. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5743">224</a><p>
+<div class="defnbox"><a id="wrglossary.20260"></a><a href="#glo:Glsxtrheadtext"><code class="csfmt">\Glsxtrheadtext</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used to display the <a id="wrglossary.20261"></a><a href="#glo:idx.sentencecase">sentence case</a> entry’s <a id="wrglossary.20262"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> <a id="wrglossary.20263"></a><a href="#glo:dual.field">field</a> in the page header (converts to <a id="wrglossary.20264"></a><a href="#glo:idx.allcaps">all caps</a> if <a id="wrglossary.20265"></a><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a> attribute is <code class="code">true</code>). <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5735">224</a><p>
+<div class="defnbox"><a id="wrglossary.20266"></a><a href="#glo:glsxtrheadtext"><code class="csfmt">\glsxtrheadtext</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used to display the entry’s <a id="wrglossary.20267"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> <a id="wrglossary.20268"></a><a href="#glo:dual.field">field</a> in the page header (converts to <a id="wrglossary.20269"></a><a href="#glo:idx.allcaps">all caps</a> if <a id="wrglossary.20270"></a><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a> attribute is <code class="code">true</code>). <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5728">224</a><p>
+<div class="defnbox"><a id="wrglossary.20271"></a><a href="#glo:GLSXTRhiername"><code class="csfmt">\GLSXTRhiername</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20272"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the entry’s hierarchical name where each name is converted to <a id="wrglossary.20273"></a><a href="#glo:idx.uppercase">uppercase</a>. <a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.7646">293</a><p>
+<div class="defnbox"><a id="wrglossary.20274"></a><a href="#glo:GLSxtrhiername"><code class="csfmt">\GLSxtrhiername</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20275"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the entry’s hierarchical name where the first name is converted to <a id="wrglossary.20276"></a><a href="#glo:idx.uppercase">uppercase</a>. <a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.7641">293</a><p>
+<div class="defnbox"><a id="wrglossary.20277"></a><a href="#glo:GlsXtrhiername"><code class="csfmt">\GlsXtrhiername</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20278"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the entry’s hierarchical name where each element name has its first character converted to <a id="wrglossary.20279"></a><a href="#glo:idx.uppercase">uppercase</a>. <a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.7636">292</a><p>
+<div class="defnbox"><a id="wrglossary.20280"></a><a href="#glo:Glsxtrhiername"><code class="csfmt">\Glsxtrhiername</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20281"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the entry’s hierarchical name using <a id="wrglossary.20282"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.7622">292</a><p>
+<div class="defnbox"><a id="wrglossary.20283"></a><a href="#glo:glsxtrhiername"><code class="csfmt">\glsxtrhiername</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20284"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the entry’s hierarchical name. <a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.7611">292</a><p>
+<div class="defnbox"><a id="wrglossary.20285"></a><a href="#glo:glsxtrhiernamesep"><code class="csfmt">\glsxtrhiernamesep</code></a><span class="floatrightbox"><a id="wrglossary.20286"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Separator used by commands like <a id="wrglossary.20287"></a><a href="#glo:glsxtrhiername"><code class="csfmt">\glsxtrhiername</code></a>. <a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.7620">292</a><p>
+<div class="defnbox"><a id="wrglossary.20288"></a><a href="#glo:glsxtrhyphenrules"><code class="csfmt">\glsxtrhyphenrules</code></a><span class="floatrightbox"><a id="wrglossary.20289"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to hyphen character sort rules. <a href="#wrglossary.13273">543</a><p>
+<div class="defnbox"><a id="wrglossary.20290"></a><a href="#glo:glsxtrhyphensuffix"><code class="csfmt">\glsxtrhyphensuffix</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a>; <a id="wrglossary.20291"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The plural suffix used by the <span class="qt">“hyphen”</span> <a id="wrglossary.20292"></a><a href="#glo:idx.abbrvstyle">abbreviation styles</a> (such as <a id="wrglossary.20293"></a><a href="#glo:opt.abbrstyle.short-hyphen-long-hyphen"><span class="abbrstylefmt">short-hyphen-long-hyphen</span></a>). <a href="#wrglossary.3668">148</a><p>
+<div class="defnbox"><a id="wrglossary.20294"></a><a href="#glo:glsxtridentifyglslike"><code class="csfmt">\glsxtridentifyglslike</code></a><code class="code">{<span class="meta">〈<em class="metainner">label-prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20295"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to inform <a id="wrglossary.20296"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to include the given command when it searches for dependencies. <a href="#sec:labelprefixes">§5.7</a>; <a href="#wrglossary.6624">258</a><p>
+<div class="defnbox"><a id="wrglossary.20297"></a><a href="#glo:glsxtrifallcaps"><code class="csfmt">\glsxtrifallcaps</code></a><code class="code">{<span class="meta">〈<em class="metainner">all caps</em>〉</span>}{<span class="meta">〈<em class="metainner">not all caps</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20298"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Shortcut for <code class="code"><a id="wrglossary.20299"></a><a href="#glo:glscapscase"><code class="csfmt">\glscapscase</code></a>{<span class="meta">〈<em class="metainner">not all caps</em>〉</span>}{<span class="meta">〈<em class="metainner">not all caps</em>〉</span>}{<span class="meta">〈<em class="metainner">all caps</em>〉</span>}</code>. <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6460">253</a><p>
+<div class="defnbox"><a id="wrglossary.20300"></a><a href="#glo:glsxtrifcounttrigger"><code class="csfmt">\glsxtrifcounttrigger</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the entry’s total use count at the end of the previous run exceeds the trigger value assigned to the entry’s category, otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8049">311</a><p>
+<div class="defnbox"><a id="wrglossary.20301"></a><a href="#glo:glsxtrifcustomdiscardperiod"><code class="csfmt">\glsxtrifcustomdiscardperiod</code></a><code class="code">{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">initial: </span><span class="meta">〈<em class="metainner">false</em>〉</span>; <a id="wrglossary.20302"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.23+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+User hook to trigger a check for a following <a id="wrglossary.20303"></a><a href="#glo:idx.fullstop">full stop</a>. This should do <span class="meta">〈<em class="metainner">true</em>〉</span> if there should be a check for a following <a id="wrglossary.20304"></a><a href="#glo:idx.fullstop">full stop</a> otherwise should do <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6341">248</a><p>
+<div class="defnbox"><a id="wrglossary.20305"></a><dfn id="glo:glsxtrifemptyglossary"><code class="csfmt">\glsxtrifemptyglossary</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">glossary-type</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the glossary identified by <span class="meta">〈<em class="metainner">glossary-type</em>〉</span> is empty, otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>. If the <a id="wrglossary.20306"></a><a href="#glo:dual.glossary">glossary</a> doesn’t exist, this does <span class="meta">〈<em class="metainner">true</em>〉</span> and will either generate an error (<a id="wrglossary.20307"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=</span><a id="wrglossary.20308"></a><a href="#glo:optval.undefaction.error"><span class="optfmt">error</span></a>) or a warning (<a id="wrglossary.20309"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=</span><a id="wrglossary.20310"></a><a href="#glo:optval.undefaction.warn"><span class="optfmt">warn</span></a>). This command considers <a id="wrglossary.20311"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a> as existing.<p>
+<div class="defnbox"><a id="wrglossary.20312"></a><a href="#glo:GlsXtrIfFieldCmpNum"><code class="csfmt">\GlsXtrIfFieldCmpNum</code></a><code class="code">{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">op</em>〉</span>}{<span class="meta">〈<em class="metainner">number</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.20313"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Compares the (numeric) value of the <a id="wrglossary.20314"></a><a href="#glo:dual.field">field</a> identified by its <a id="wrglossary.20315"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a> <span class="meta">〈<em class="metainner">field-label</em>〉</span> for the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> with <span class="meta">〈<em class="metainner">number</em>〉</span> where <span class="meta">〈<em class="metainner">op</em>〉</span> is the comparison operator (<code class="code">=</code>, <code class="code">&lt;</code> or <code class="code">&gt;</code>). The unstarred version adds implicit grouping. The starred version doesn’t. <a href="#sec:fieldconditionals">§5.15</a>; <a href="#wrglossary.7904">305</a><p>
+<div class="defnbox"><a id="wrglossary.20316"></a><a href="#glo:GlsXtrIfFieldEqNum"><code class="csfmt">\GlsXtrIfFieldEqNum</code></a><code class="code">{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">number</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.20317"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A shortcut that uses <a id="wrglossary.20318"></a><a href="#glo:GlsXtrIfFieldCmpNum"><code class="csfmt">\GlsXtrIfFieldCmpNum</code></a> with <span class="meta">〈<em class="metainner">op</em>〉</span> set to <code class="code">=</code>. The unstarred version adds implicit grouping. The starred version doesn’t. <a href="#sec:fieldconditionals">§5.15</a>; <a href="#wrglossary.7909">306</a><p>
+<div class="defnbox"><a id="wrglossary.20319"></a><a href="#glo:GlsXtrIfFieldEqStr"><code class="csfmt">\GlsXtrIfFieldEqStr</code></a><code class="code">{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.20320"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Tests if the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> has the <a id="wrglossary.20321"></a><a href="#glo:dual.field">field</a> identified by its <a id="wrglossary.20322"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a> <span class="meta">〈<em class="metainner">field-label</em>〉</span> set to <span class="meta">〈<em class="metainner">value</em>〉</span>. This internally uses <a id="wrglossary.20323"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a> and compares <a id="wrglossary.20324"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a> to <span class="meta">〈<em class="metainner">value</em>〉</span> using <a id="wrglossary.20325"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <a id="wrglossary.20326"></a><a href="#glo:ifdefstring"><code class="csfmt">\ifdefstring</code></a>. The unstarred version adds implicit grouping. The starred version doesn’t. <a href="#sec:fieldconditionals">§5.15</a>; <a href="#wrglossary.7913">306</a><p>
+<div class="defnbox"><a id="wrglossary.20327"></a><a href="#glo:GlsXtrIfFieldEqXpStr"><code class="csfmt">\GlsXtrIfFieldEqXpStr</code></a><code class="code">{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.20328"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.20329"></a><a href="#glo:GlsXtrIfFieldEqStr"><code class="csfmt">\GlsXtrIfFieldEqStr</code></a> but first (protected) expands <span class="meta">〈<em class="metainner">value</em>〉</span>. <a href="#sec:fieldconditionals">§5.15</a>; <a href="#wrglossary.7917">306</a><p>
+<div class="defnbox"><a id="wrglossary.20330"></a><a href="#glo:GlsXtrIfFieldNonZero"><code class="csfmt">\GlsXtrIfFieldNonZero</code></a><code class="code">{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.20331"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A shortcut that uses <a id="wrglossary.20332"></a><a href="#glo:GlsXtrIfFieldCmpNum"><code class="csfmt">\GlsXtrIfFieldCmpNum</code></a> to test if the (numeric) value of the <a id="wrglossary.20333"></a><a href="#glo:dual.field">field</a> identified by its <a id="wrglossary.20334"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a> <span class="meta">〈<em class="metainner">field-label</em>〉</span> for the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> is non-zero. An empty or undefined field is treated as 0. The unstarred version adds implicit grouping. The starred version doesn’t. The value can be referenced within <span class="meta">〈<em class="metainner">true</em>〉</span> (where it will be 0) or within <span class="meta">〈<em class="metainner">false</em>〉</span> using <a id="wrglossary.20335"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a>. <a href="#sec:fieldconditionals">§5.15</a>; <a href="#wrglossary.7911">306</a><p>
+<div class="defnbox"><a id="wrglossary.20336"></a><a href="#glo:GlsXtrIfFieldUndef"><code class="csfmt">\GlsXtrIfFieldUndef</code></a><code class="code">{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20337"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.23+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expandable command that tests if the given <a id="wrglossary.20338"></a><a href="#glo:dual.field">field</a> (identified by its <a id="wrglossary.20339"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a>) is undefined for the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. Internally uses <a id="wrglossary.20340"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <a id="wrglossary.20341"></a><a href="#glo:ifcsundef"><code class="csfmt">\ifcsundef</code></a> command. Unlike <a id="wrglossary.20342"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a> there is no grouping or starred version. <a href="#sec:fieldconditionals">§5.15</a>; <a href="#wrglossary.7883">305</a><p>
+<div class="defnbox"><a id="wrglossary.20343"></a><a href="#glo:GlsXtrIfFieldValueInCsvList"><code class="csfmt">\GlsXtrIfFieldValueInCsvList</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">csv-list</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.20344"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Tests if the value stored in the given <a id="wrglossary.20345"></a><a href="#glo:dual.field">field</a> (identified by its <a id="wrglossary.20346"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a>) for the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> is contained in the comma-separated list <span class="meta">〈<em class="metainner">csv-list</em>〉</span> using <a id="wrglossary.20347"></a><a href="#glo:DTLifinlist"><code class="csfmt">\DTLifinlist</code></a> (provided by <a id="wrglossary.20348"></a><a href="#glo:pkg.datatool-base"><span class="styfmt">datatool-base</span></a>, which is automatically loaded by the <a id="wrglossary.20349"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package). One level expansion is performed on <span class="meta">〈<em class="metainner">csv-list</em>〉</span>. This command uses <a id="wrglossary.20350"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a> so the field value can be obtained with <a id="wrglossary.20351"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a>. The unstarred version adds implicit grouping. The starred version doesn’t. <a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7857">303</a><p>
+<div class="defnbox"><a id="wrglossary.20352"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a><code class="code">{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.20353"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.19+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Tests if the <a id="wrglossary.20354"></a><a href="#glo:dual.field">field</a> identified by its <a id="wrglossary.20355"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a> <span class="meta">〈<em class="metainner">field-label</em>〉</span> for the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> is defined and is not empty. This is like <a id="wrglossary.20356"></a><a href="#glo:ifglshasfield"><code class="csfmt">\ifglshasfield</code></a> but doesn’t produce a warning if the entry or field doesn’t exist. This sets <a id="wrglossary.20357"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a> to the field value and does <span class="meta">〈<em class="metainner">true</em>〉</span> if its defined and not empty, otherwise it does <span class="meta">〈<em class="metainner">false</em>〉</span>. The unstarred version adds implicit grouping to make nesting easier. The starred version doesn’t (to make assignments easier). <a href="#sec:fieldconditionals">§5.15</a>; <a href="#wrglossary.7894">305</a><p>
+<div class="defnbox"><a id="wrglossary.20358"></a><a href="#glo:GlsXtrIfHasNonZeroChildCount"><code class="csfmt">\GlsXtrIfHasNonZeroChildCount</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.20359"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.47+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Tests if the value in the <a id="wrglossary.20360"></a><a href="#glo:opt.glosfield.childcount"><span class="csoptfmt">childcount</span></a> field is non-zero (using <a id="wrglossary.20361"></a><a href="#glo:GlsXtrIfFieldNonZero"><code class="csfmt">\GlsXtrIfFieldNonZero</code></a>). This requires the <a id="wrglossary.20362"></a><a href="#glo:opt.resource.save-child-count"><span class="csoptfmt">save-child-count</span></a> resource option. <a href="#sec:bib2glshier">§11.5.4</a>; <a href="#wrglossary.13502">554</a><p>
+<div class="defnbox"><a id="wrglossary.20363"></a><a href="#glo:glsxtrifheaduc"><code class="csfmt">\glsxtrifheaduc</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20364"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If the category associated with the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> has the <a id="wrglossary.20365"></a><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a> attribute set to <code class="code">true</code> this does <span class="meta">〈<em class="metainner">true</em>〉</span> otherwise it does <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5545">216</a><p>
+<div class="defnbox"><a id="wrglossary.20366"></a><a href="#glo:glsxtrifhyphenstart"><code class="csfmt">\glsxtrifhyphenstart</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20367"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If <span class="meta">〈<em class="metainner">text</em>〉</span> starts with a hyphen this does <span class="meta">〈<em class="metainner">true</em>〉</span> otherwise it does <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:advancedabbrstylecmds">§4.5.2</a>; <a href="#wrglossary.3983">160</a><p>
+<div class="defnbox"><a id="wrglossary.20368"></a><a href="#glo:glsxtrifindexing"><code class="csfmt">\glsxtrifindexing</code></a><code class="code">{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Tests whether or not the <a id="wrglossary.20369"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a> has been set. Does <span class="meta">〈<em class="metainner">false</em>〉</span> if <a id="wrglossary.20370"></a><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a><span class="optfmt">=true</span> otherwise does <span class="meta">〈<em class="metainner">true</em>〉</span>. <a href="#sec:wrglossary">§5.8</a>; <a href="#wrglossary.6930">265</a><p>
+<div class="defnbox"><a id="wrglossary.20371"></a><dfn id="glo:GlsXtrIfInGlossary"><code class="csfmt">\GlsXtrIfInGlossary</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">glossary-type</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20372"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> is in the internal list of the <a id="wrglossary.20373"></a><a href="#glo:dual.glossary">glossary</a> identified by <span class="meta">〈<em class="metainner">glossary-type</em>〉</span>, otherwise it does <span class="meta">〈<em class="metainner">false</em>〉</span>. If the <a id="wrglossary.20374"></a><a href="#glo:dual.glossary">glossary</a> doesn’t exist, this does <span class="meta">〈<em class="metainner">false</em>〉</span> and will either generate an error (<a id="wrglossary.20375"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=</span><a id="wrglossary.20376"></a><a href="#glo:optval.undefaction.error"><span class="optfmt">error</span></a>) or a warning (<a id="wrglossary.20377"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=</span><a id="wrglossary.20378"></a><a href="#glo:optval.undefaction.warn"><span class="optfmt">warn</span></a>). This command considers <a id="wrglossary.20379"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a> as existing.<p>
+<div class="defnbox"><a id="wrglossary.20380"></a><a href="#glo:glsxtrifinlabelprefixlist"><code class="csfmt">\glsxtrifinlabelprefixlist</code></a><code class="code">{<span class="meta">〈<em class="metainner">label-prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20381"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if <span class="meta">〈<em class="metainner">label-prefix</em>〉</span> has been identified as a label prefix. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13741">563</a><p>
+<div class="defnbox"><a id="wrglossary.20382"></a><a href="#glo:glsxtrifinmark"><code class="csfmt">\glsxtrifinmark</code></a><code class="code">{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20383"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.07+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if within <a id="wrglossary.20384"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a>, <a id="wrglossary.20385"></a><a href="#glo:markboth"><code class="csfmt">\markboth</code></a> or <a id="wrglossary.20386"></a><a href="#glo:@starttoc"><code class="csfmt">\@starttoc</code></a> otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5486">214</a><p>
+<div class="defnbox"><a id="wrglossary.20387"></a><a href="#glo:glsxtrifintoc"><code class="csfmt">\glsxtrifintoc</code></a><code class="code">{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20388"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Normally just expands to <span class="meta">〈<em class="metainner">false</em>〉</span> but <a id="wrglossary.20389"></a><a href="#glo:@starttoc"><code class="csfmt">\@starttoc</code></a> is redefined to temporarily set this macro to expand to <span class="meta">〈<em class="metainner">true</em>〉</span> instead. Will always expand to <span class="meta">〈<em class="metainner">false</em>〉</span> if <a id="wrglossary.20390"></a><a href="#glo:glsxtrRevertTocMarks"><code class="csfmt">\glsxtrRevertTocMarks</code></a> or <a id="wrglossary.20391"></a><a href="#glo:glsxtrRevertMarks"><code class="csfmt">\glsxtrRevertMarks</code></a> are used to revert <a id="wrglossary.20392"></a><a href="#glo:@starttoc"><code class="csfmt">\@starttoc</code></a> to its former definition. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5490">214</a><p>
+<div class="defnbox"><a id="wrglossary.20393"></a><a href="#glo:glsxtrifkeydefined"><code class="csfmt">\glsxtrifkeydefined</code></a><code class="code">{<span class="meta">〈<em class="metainner">key</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20394"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Tests if the given <span class="meta">〈<em class="metainner">key</em>〉</span> has been defined as a <a id="wrglossary.20395"></a><a href="#glo:idx.gloskey">glossary entry key</a>. Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the key has been defined, otherwise does false. <a href="#sec:newkeys">§3.2</a>; <a href="#wrglossary.1049">35</a><p>
+<div class="defnbox"><a id="wrglossary.20396"></a><a href="#glo:glsxtriflabelinlist"><code class="csfmt">\glsxtriflabelinlist</code></a><code class="code">{<span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">label-list</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20397"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the given label is in the given comma-separated list of labels, otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>. The label and list are fully expanded. <a href="#sec:printunsrtadvanced">§8.4.3</a>; <a href="#wrglossary.10272">402</a><p>
+<div class="defnbox"><a id="wrglossary.20398"></a><a href="#glo:GlsXtrIfLinkCounterDef"><code class="csfmt">\GlsXtrIfLinkCounterDef</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20399"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.26+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to <span class="meta">〈<em class="metainner">true</em>〉</span> if the link counter associated with the given entry has been defined, otherwise expands to <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:linkcount">§6.2</a>; <a href="#wrglossary.8164">318</a><p>
+<div class="defnbox"><a id="wrglossary.20400"></a><a href="#glo:glsxtrifmulti"><code class="csfmt">\glsxtrifmulti</code></a><code class="code">{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20401"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if a multi-entry has been defined with the label <span class="meta">〈<em class="metainner">multi-label</em>〉</span> otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:multiextras">§7.13</a>; <a href="#wrglossary.9326">370</a><p>
+<div class="defnbox"><a id="wrglossary.20402"></a><a href="#glo:glsxtrifnextpunc"><code class="csfmt">\glsxtrifnextpunc</code></a><code class="code">{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20403"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Performs <span class="meta">〈<em class="metainner">true</em>〉</span> if this command is followed by a recognised punctuation character otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>. The list of recognised punctuation marks is initialised to <code class="code">.,:;?!</code> (<a id="wrglossary.20404"></a><a href="#glo:idx.fullstop">full stop</a>, comma, colon, semicolon, question mark, and exclamation mark). Additional punctuation characters can be added with <a id="wrglossary.20405"></a><a href="#glo:glsxtraddpunctuationmark"><code class="csfmt">\glsxtraddpunctuationmark</code></a>. <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6351">248</a><p>
+<div class="defnbox"><a id="wrglossary.20406"></a><a href="#glo:glsxtrifperiod"><code class="csfmt">\glsxtrifperiod</code></a><code class="code">{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}<span class="meta">〈<em class="metainner">token</em>〉</span></code><span class="floatrightbox"><a id="wrglossary.20407"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if <span class="meta">〈<em class="metainner">token</em>〉</span> is a <a id="wrglossary.20408"></a><a href="#glo:idx.fullstop">full stop</a>, otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6349">248</a><p>
+<div class="defnbox"><a id="wrglossary.20409"></a><a href="#glo:glsxtrifrecordtrigger"><code class="csfmt">\glsxtrifrecordtrigger</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20410"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the entry’s total record count (obtained with <a id="wrglossary.20411"></a><a href="#glo:glsxtrrecordtriggervalue"><code class="csfmt">\glsxtrrecordtriggervalue</code></a>) exceeds the value supplied by the <a id="wrglossary.20412"></a><a href="#glo:opt.catattr.recordcount"><span class="csoptfmt">recordcount</span></a> attribute, otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12771">524</a><p>
+<div class="defnbox"><a id="wrglossary.20413"></a><a href="#glo:GlsXtrIfUnusedOrUndefined"><code class="csfmt">\GlsXtrIfUnusedOrUndefined</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20414"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.34+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the entry hasn’t been defined or hasn’t been marked as <a id="wrglossary.20415"></a><a href="#glo:@@glslabel@firstuseflag">used</a>, otherwise does <span class="meta">〈<em class="metainner">true</em>〉</span>. Note that this command will generate an error or warning (according to <a id="wrglossary.20416"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a>) if the entry hasn’t been defined, but will still do <span class="meta">〈<em class="metainner">true</em>〉</span>. <a href="#sec:glsunset">§5.10</a>; <a href="#wrglossary.7442">283</a><p>
+<div class="defnbox"><a id="wrglossary.20417"></a><a href="#glo:GlsXtrIfValueInFieldCsvList"><code class="csfmt">\GlsXtrIfValueInFieldCsvList</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.20418"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.47+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Tests if the given value (<span class="meta">〈<em class="metainner">value</em>〉</span>) is contained in the comma-separated list stored in the given <a id="wrglossary.20419"></a><a href="#glo:dual.field">field</a> (identified by its <a id="wrglossary.20420"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a>) for the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> using <a id="wrglossary.20421"></a><a href="#glo:DTLifinlist"><code class="csfmt">\DTLifinlist</code></a> (provided by <a id="wrglossary.20422"></a><a href="#glo:pkg.datatool-base"><span class="styfmt">datatool-base</span></a>, which is automatically loaded by the <a id="wrglossary.20423"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package). No expansion is performed on <span class="meta">〈<em class="metainner">value</em>〉</span>. This command uses <a id="wrglossary.20424"></a><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a> so the complete list can be obtained with <a id="wrglossary.20425"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a>. The unstarred version adds implicit grouping. The starred version doesn’t. <a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7850">303</a><p>
+<div class="defnbox"><a id="wrglossary.20426"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a><code class="code">{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Initialised by the <a id="wrglossary.20427"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.20428"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands, this expands to <span class="meta">〈<em class="metainner">true</em>〉</span> if the calling command was considered the <a id="wrglossary.20429"></a><a href="#glo:dual.firstuse">first use</a>, otherwise it expands to <span class="meta">〈<em class="metainner">false</em>〉</span>. This command may be used within the <a id="wrglossary.20430"></a><a href="#glo:dual.postlinkhook">post-link hook</a> (where it’s too late to test the <a id="wrglossary.20431"></a><a href="#glo:dual.firstuseflag">first use flag</a> with <a id="wrglossary.20432"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>). <a href="#sec:glsunset">§5.10</a>; <a href="#wrglossary.7394">282</a><p>
+<div class="defnbox"><a id="wrglossary.20433"></a><a href="#glo:glsxtrifwasglslike"><code class="csfmt">\glsxtrifwasglslike</code></a><code class="code">{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20434"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Initialised by the <a id="wrglossary.20435"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.20436"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands, this expands to <span class="meta">〈<em class="metainner">true</em>〉</span> if the calling command was a <a id="wrglossary.20437"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> command, otherwise it expands to <span class="meta">〈<em class="metainner">false</em>〉</span>. This command may be used within the <a id="wrglossary.20438"></a><a href="#glo:dual.postlinkhook">post-link hook</a>. <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6444">252</a><p>
+<div class="defnbox"><a id="wrglossary.20439"></a><a href="#glo:glsxtrifwasglslikeandfirstuse"><code class="csfmt">\glsxtrifwasglslikeandfirstuse</code></a><code class="code">{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20440"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A shortcut that nests <a id="wrglossary.20441"></a><a href="#glo:glsxtrifwasglslike"><code class="csfmt">\glsxtrifwasglslike</code></a> and <a id="wrglossary.20442"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a>. This does <span class="meta">〈<em class="metainner">true</em>〉</span> if the calling command was both a <a id="wrglossary.20443"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> command and was considered the <a id="wrglossary.20444"></a><a href="#glo:dual.firstuse">first use</a>. <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6446">252</a><p>
+<div class="defnbox"><a id="wrglossary.20445"></a><a href="#glo:glsxtrifwassubsequentorshort"><code class="csfmt">\glsxtrifwassubsequentorshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20446"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to <span class="meta">〈<em class="metainner">true</em>〉</span> if the calling command was a <a id="wrglossary.20447"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> command and was the <a id="wrglossary.20448"></a><a href="#glo:dual.subsequentuse">subsequent use</a> or if <a id="wrglossary.20449"></a><a href="#glo:glsxtrcurrentfield"><code class="csfmt">\glsxtrcurrentfield</code></a> was set to <code class="code">short</code>. <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6456">253</a><p>
+<div class="defnbox"><a id="wrglossary.20450"></a><a href="#glo:glsxtrifwassubsequentuse"><code class="csfmt">\glsxtrifwassubsequentuse</code></a><code class="code">{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20451"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A shortcut that nests <a id="wrglossary.20452"></a><a href="#glo:glsxtrifwasglslike"><code class="csfmt">\glsxtrifwasglslike</code></a> and <a id="wrglossary.20453"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a>. This does <span class="meta">〈<em class="metainner">true</em>〉</span> if the calling command was a <a id="wrglossary.20454"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> command but was not considered the <a id="wrglossary.20455"></a><a href="#glo:dual.firstuse">first use</a>. <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6451">252</a><p>
+<div class="defnbox"><a id="wrglossary.20456"></a><a href="#glo:GlsXtrIfXpFieldEqXpStr"><code class="csfmt">\GlsXtrIfXpFieldEqXpStr</code></a><code class="code">{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.20457"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.20458"></a><a href="#glo:GlsXtrIfFieldEqStr"><code class="csfmt">\GlsXtrIfFieldEqStr</code></a> but first (protected) expands both the field value and the supplied <span class="meta">〈<em class="metainner">value</em>〉</span>. <a href="#sec:fieldconditionals">§5.15</a>; <a href="#wrglossary.7919">306</a><p>
+<div class="defnbox"><a id="wrglossary.20459"></a><a href="#glo:glsxtrIgnorableRules"><code class="csfmt">\glsxtrIgnorableRules</code></a><span class="floatrightbox"><a id="wrglossary.20460"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A shortcut that expands to the control rules, space rules and non-printable rules. <a href="#wrglossary.13301">546</a><p>
+<div class="defnbox"><a id="wrglossary.20461"></a><a href="#glo:glsxtrinclinkcounter"><code class="csfmt">\glsxtrinclinkcounter</code></a><code class="code">{<span class="meta">〈<em class="metainner">counter</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20462"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.26+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Increments the link counter with <a id="wrglossary.20463"></a><a href="#glo:stepcounter"><code class="csfmt">\stepcounter</code></a>. <a href="#sec:linkcount">§6.2</a>; <a href="#wrglossary.8155">317</a><p>
+<div class="defnbox"><a id="wrglossary.20464"></a><a href="#glo:glsxtrindexaliased"><code class="csfmt">\glsxtrindexaliased</code></a><span class="floatrightbox"><a id="wrglossary.20465"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Index the current entry’s alias. May only be used within the definition of <a id="wrglossary.20466"></a><a href="#glo:glsxtrsetaliasnoindex"><code class="csfmt">\glsxtrsetaliasnoindex</code></a>. <a href="#sec:glssee">§5.9.3</a>; <a href="#wrglossary.7305">278</a><p>
+<div class="defnbox"><a id="wrglossary.20467"></a><a href="#glo:GlsXtrIndexCounterLink"><code class="csfmt">\GlsXtrIndexCounterLink</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20468"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.29+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Creates a hyperlink (if supported) to the target obtained from <a id="wrglossary.20469"></a><a href="#glo:opt.glosfield.indexcounter"><span class="csoptfmt">indexcounter</span></a>, if the field has been defined with the given hyperlink text (otherwise just does <span class="meta">〈<em class="metainner">text</em>〉</span>). <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13960">573</a><p>
+<div class="defnbox"><a id="wrglossary.20470"></a><a href="#glo:glsxtrindexseealso"><code class="csfmt">\glsxtrindexseealso</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">xr-list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20471"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.16+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indexes the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> as a <span class="qt">“see also”</span> cross-reference to the entries identified in the comma-separated list <span class="meta">〈<em class="metainner">xr-list</em>〉</span>. The cross-reference list is prefixed with <a id="wrglossary.20472"></a><a href="#glo:seealsoname"><code class="csfmt">\seealsoname</code></a>. <a href="#sec:glssee">§5.9.3</a>; <a href="#wrglossary.7288">278</a><p>
+<div class="defnbox"><a id="wrglossary.20473"></a><a href="#glo:glsxtrinithyperoutside"><code class="csfmt">\glsxtrinithyperoutside</code></a><span class="floatrightbox"><a id="wrglossary.20474"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook that initialises the <a id="wrglossary.20475"></a><a href="#glo:opt.glsopt.hyperoutside"><span class="csoptfmt">hyperoutside</span></a> setting. <a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4790">189</a><p>
+<div class="defnbox"><a id="wrglossary.20476"></a><a href="#glo:glsxtrinitwrgloss"><code class="csfmt">\glsxtrinitwrgloss</code></a><span class="floatrightbox"><a id="wrglossary.20477"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook that initialises the <a id="wrglossary.20478"></a><a href="#glo:opt.glsopt.wrgloss"><span class="csoptfmt">wrgloss</span></a> setting. <a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4772">189</a><p>
+<div class="defnbox"><a id="wrglossary.20479"></a><dfn id="glo:glsxtrinitwrglossbeforefalse"><code class="csfmt">\glsxtrinitwrglossbeforefalse</code></dfn><span class="floatrightbox"><a id="wrglossary.20480"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Corresponds to <a id="wrglossary.20481"></a><a href="#glo:opt.glsopt.wrgloss"><span class="csoptfmt">wrgloss</span></a><span class="optfmt">=after</span>.<p>
+<div class="defnbox"><a id="wrglossary.20482"></a><dfn id="glo:glsxtrinitwrglossbeforetrue"><code class="csfmt">\glsxtrinitwrglossbeforetrue</code></dfn><span class="floatrightbox"><a id="wrglossary.20483"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Corresponds to <a id="wrglossary.20484"></a><a href="#glo:opt.glsopt.wrgloss"><span class="csoptfmt">wrgloss</span></a><span class="optfmt">=before</span>.<p>
+<div class="defnbox"><a id="wrglossary.20485"></a><a href="#glo:GLSxtrinlinefullformat"><code class="csfmt">\GLSxtrinlinefullformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20486"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.20487"></a><a href="#glo:GLSxtrfull"><code class="csfmt">\GLSxtrfull</code></a> to display the <a id="wrglossary.20488"></a><a href="#glo:idx.allcaps">all caps</a> <a id="wrglossary.20489"></a><a href="#glo:dual.inlinefullform">inline full form</a> form (defined by the abbreviation style). <a href="#wrglossary.4437">175</a><p>
+<div class="defnbox"><a id="wrglossary.20490"></a><a href="#glo:Glsxtrinlinefullformat"><code class="csfmt">\Glsxtrinlinefullformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.20491"></a><a href="#glo:Glsxtrfull"><code class="csfmt">\Glsxtrfull</code></a> to display the <a id="wrglossary.20492"></a><a href="#glo:idx.sentencecase">sentence case</a> <a id="wrglossary.20493"></a><a href="#glo:dual.inlinefullform">inline full form</a> form (defined by the abbreviation style). <a href="#wrglossary.4431">175</a><p>
+<div class="defnbox"><a id="wrglossary.20494"></a><a href="#glo:glsxtrinlinefullformat"><code class="csfmt">\glsxtrinlinefullformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.20495"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> to display the <a id="wrglossary.20496"></a><a href="#glo:dual.inlinefullform">inline full form</a> form (defined by the abbreviation style). <a href="#wrglossary.4427">175</a><p>
+<div class="defnbox"><a id="wrglossary.20497"></a><a href="#glo:GLSxtrinlinefullplformat"><code class="csfmt">\GLSxtrinlinefullplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20498"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.20499"></a><a href="#glo:GLSxtrfullpl"><code class="csfmt">\GLSxtrfullpl</code></a> to display the plural <a id="wrglossary.20500"></a><a href="#glo:idx.allcaps">all caps</a> <a id="wrglossary.20501"></a><a href="#glo:dual.inlinefullform">inline full form</a> form (defined by the abbreviation style). <a href="#wrglossary.4440">175</a><p>
+<div class="defnbox"><a id="wrglossary.20502"></a><a href="#glo:Glsxtrinlinefullplformat"><code class="csfmt">\Glsxtrinlinefullplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.20503"></a><a href="#glo:Glsxtrfullpl"><code class="csfmt">\Glsxtrfullpl</code></a> to display the plural <a id="wrglossary.20504"></a><a href="#glo:idx.sentencecase">sentence case</a> <a id="wrglossary.20505"></a><a href="#glo:dual.inlinefullform">inline full form</a> form (defined by the abbreviation style). <a href="#wrglossary.4434">175</a><p>
+<div class="defnbox"><a id="wrglossary.20506"></a><a href="#glo:glsxtrinlinefullplformat"><code class="csfmt">\glsxtrinlinefullplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.20507"></a><a href="#glo:glsxtrfullpl"><code class="csfmt">\glsxtrfullpl</code></a> to display the plural <a id="wrglossary.20508"></a><a href="#glo:dual.inlinefullform">inline full form</a> form (defined by the abbreviation style). <a href="#wrglossary.4429">175</a><p>
+<div class="defnbox"><a id="wrglossary.20509"></a><a href="#glo:glsxtrinsertinsidefalse"><code class="csfmt">\glsxtrinsertinsidefalse</code></a><span class="floatrightbox"><a id="wrglossary.20510"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the <a id="wrglossary.20511"></a><a href="#glo:ifglsxtrinsertinside"><code class="csfmt">\ifglsxtrinsertinside</code></a> conditional to false. <a href="#wrglossary.3256">132</a><p>
+<div class="defnbox"><a id="wrglossary.20512"></a><a href="#glo:glsxtrinsertinsidetrue"><code class="csfmt">\glsxtrinsertinsidetrue</code></a><span class="floatrightbox"><a id="wrglossary.20513"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the <a id="wrglossary.20514"></a><a href="#glo:ifglsxtrinsertinside"><code class="csfmt">\ifglsxtrinsertinside</code></a> to true. <a href="#wrglossary.3255">131</a><p>
+<div class="defnbox"><a id="wrglossary.20515"></a><dfn id="glo:GlsXtrInternalLocationHyperlink"><code class="csfmt">\GlsXtrInternalLocationHyperlink</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20516"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.29+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.20517"></a><a href="#glo:glsxtrlocationhyperlink"><code class="csfmt">\glsxtrlocationhyperlink</code></a> to create an internal hyperlink to the given location (advanced command, see documented code for use).<p>
+<div class="defnbox"><a id="wrglossary.20518"></a><a href="#glo:glsxtrLatinA"><code class="csfmt">\glsxtrLatinA</code></a><span class="floatrightbox"><a id="wrglossary.20519"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin A (includes 0x00AA and 0x2090). <a href="#wrglossary.13334">548</a><p>
+<div class="defnbox"><a id="wrglossary.20520"></a><a href="#glo:glsxtrLatinAA"><code class="csfmt">\glsxtrLatinAA</code></a><span class="floatrightbox"><a id="wrglossary.20521"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin å. <a href="#wrglossary.13357">551</a><p>
+<div class="defnbox"><a id="wrglossary.20522"></a><a href="#glo:glsxtrLatinAELigature"><code class="csfmt">\glsxtrLatinAELigature</code></a><span class="floatrightbox"><a id="wrglossary.20523"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin ae-ligature. <a href="#wrglossary.13350">550</a><p>
+<div class="defnbox"><a id="wrglossary.20524"></a><a href="#glo:glsxtrLatinE"><code class="csfmt">\glsxtrLatinE</code></a><span class="floatrightbox"><a id="wrglossary.20525"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin E (includes 0x2091). <a href="#wrglossary.13335">548</a><p>
+<div class="defnbox"><a id="wrglossary.20526"></a><a href="#glo:glsxtrLatinEszettSs"><code class="csfmt">\glsxtrLatinEszettSs</code></a><span class="floatrightbox"><a id="wrglossary.20527"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to rule for ßand ſs. <a href="#wrglossary.13346">550</a><p>
+<div class="defnbox"><a id="wrglossary.20528"></a><a href="#glo:glsxtrLatinEszettSz"><code class="csfmt">\glsxtrLatinEszettSz</code></a><span class="floatrightbox"><a id="wrglossary.20529"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to rule for ßand ſz. <a href="#wrglossary.13347">550</a><p>
+<div class="defnbox"><a id="wrglossary.20530"></a><a href="#glo:glsxtrLatinEth"><code class="csfmt">\glsxtrLatinEth</code></a><span class="floatrightbox"><a id="wrglossary.20531"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin eth. <a href="#wrglossary.13348">550</a><p>
+<div class="defnbox"><a id="wrglossary.20532"></a><a href="#glo:glsxtrLatinH"><code class="csfmt">\glsxtrLatinH</code></a><span class="floatrightbox"><a id="wrglossary.20533"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin H (includes 0x2095). <a href="#wrglossary.13336">549</a><p>
+<div class="defnbox"><a id="wrglossary.20534"></a><a href="#glo:glsxtrLatinI"><code class="csfmt">\glsxtrLatinI</code></a><span class="floatrightbox"><a id="wrglossary.20535"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin I (includes 0x2071). <a href="#wrglossary.13338">549</a><p>
+<div class="defnbox"><a id="wrglossary.20536"></a><a href="#glo:glsxtrLatinInsularG"><code class="csfmt">\glsxtrLatinInsularG</code></a><span class="floatrightbox"><a id="wrglossary.20537"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin insular G and g, G. <a href="#wrglossary.13355">551</a><p>
+<div class="defnbox"><a id="wrglossary.20538"></a><a href="#glo:glsxtrLatinK"><code class="csfmt">\glsxtrLatinK</code></a><span class="floatrightbox"><a id="wrglossary.20539"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin K (includes 0x2096). <a href="#wrglossary.13337">549</a><p>
+<div class="defnbox"><a id="wrglossary.20540"></a><dfn id="glo:glsxtrLatinL"><code class="csfmt">\glsxtrLatinL</code></dfn><span class="floatrightbox"><a id="wrglossary.20541"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin L (includes 0x2097).<p>
+<div class="defnbox"><a id="wrglossary.20542"></a><a href="#glo:glsxtrLatinLslash"><code class="csfmt">\glsxtrLatinLslash</code></a><span class="floatrightbox"><a id="wrglossary.20543"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin ł. <a href="#wrglossary.13353">551</a><p>
+<div class="defnbox"><a id="wrglossary.20544"></a><a href="#glo:glsxtrLatinM"><code class="csfmt">\glsxtrLatinM</code></a><span class="floatrightbox"><a id="wrglossary.20545"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin M (includes 0x2098). <a href="#wrglossary.13339">549</a><p>
+<div class="defnbox"><a id="wrglossary.20546"></a><a href="#glo:glsxtrLatinN"><code class="csfmt">\glsxtrLatinN</code></a><span class="floatrightbox"><a id="wrglossary.20547"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin N (includes 0x2099). <a href="#wrglossary.13340">549</a><p>
+<div class="defnbox"><a id="wrglossary.20548"></a><a href="#glo:glsxtrLatinO"><code class="csfmt">\glsxtrLatinO</code></a><span class="floatrightbox"><a id="wrglossary.20549"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin O (includes 0x00BA and 0x2092). <a href="#wrglossary.13341">549</a><p>
+<div class="defnbox"><a id="wrglossary.20550"></a><a href="#glo:glsxtrLatinOELigature"><code class="csfmt">\glsxtrLatinOELigature</code></a><span class="floatrightbox"><a id="wrglossary.20551"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin oe-ligature. <a href="#wrglossary.13351">550</a><p>
+<div class="defnbox"><a id="wrglossary.20552"></a><a href="#glo:glsxtrLatinOslash"><code class="csfmt">\glsxtrLatinOslash</code></a><span class="floatrightbox"><a id="wrglossary.20553"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin ø. <a href="#wrglossary.13352">550</a><p>
+<div class="defnbox"><a id="wrglossary.20554"></a><a href="#glo:glsxtrLatinP"><code class="csfmt">\glsxtrLatinP</code></a><span class="floatrightbox"><a id="wrglossary.20555"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin P (includes 0x209A). <a href="#wrglossary.13342">549</a><p>
+<div class="defnbox"><a id="wrglossary.20556"></a><a href="#glo:glsxtrLatinS"><code class="csfmt">\glsxtrLatinS</code></a><span class="floatrightbox"><a id="wrglossary.20557"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin S (includes 0x209B). <a href="#wrglossary.13343">549</a><p>
+<div class="defnbox"><a id="wrglossary.20558"></a><a href="#glo:glsxtrLatinSchwa"><code class="csfmt">\glsxtrLatinSchwa</code></a><span class="floatrightbox"><a id="wrglossary.20559"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin schwa. <a href="#wrglossary.13356">551</a><p>
+<div class="defnbox"><a id="wrglossary.20560"></a><a href="#glo:glsxtrLatinT"><code class="csfmt">\glsxtrLatinT</code></a><span class="floatrightbox"><a id="wrglossary.20561"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin T (includes 0x209C). <a href="#wrglossary.13344">549</a><p>
+<div class="defnbox"><a id="wrglossary.20562"></a><a href="#glo:glsxtrLatinThorn"><code class="csfmt">\glsxtrLatinThorn</code></a><span class="floatrightbox"><a id="wrglossary.20563"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin thorn. <a href="#wrglossary.13349">550</a><p>
+<div class="defnbox"><a id="wrglossary.20564"></a><a href="#glo:glsxtrLatinWynn"><code class="csfmt">\glsxtrLatinWynn</code></a><span class="floatrightbox"><a id="wrglossary.20565"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin wynn. <a href="#wrglossary.13354">551</a><p>
+<div class="defnbox"><a id="wrglossary.20566"></a><a href="#glo:glsxtrLatinX"><code class="csfmt">\glsxtrLatinX</code></a><span class="floatrightbox"><a id="wrglossary.20567"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of Latin X (includes 0x2093). <a href="#wrglossary.13345">550</a><p>
+<div class="defnbox"><a id="wrglossary.20568"></a><a href="#glo:GlsXtrLetField"><code class="csfmt">\GlsXtrLetField</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20569"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.20570"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a> but internally uses (<a id="wrglossary.20571"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a>) <a id="wrglossary.20572"></a><a href="#glo:cslet"><code class="csfmt">\cslet</code></a> instead of <a id="wrglossary.20573"></a><a href="#glo:csdef"><code class="csfmt">\csdef</code></a>. <a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1209">40</a><p>
+<div class="defnbox"><a id="wrglossary.20574"></a><a href="#glo:GlsXtrLetFieldToField"><code class="csfmt">\GlsXtrLetFieldToField</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry1-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field1-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry2-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field2-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20575"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Assigns the <a id="wrglossary.20576"></a><a href="#glo:dual.field">field</a> identified by its <a id="wrglossary.20577"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a> <span class="meta">〈<em class="metainner">field1-label</em>〉</span> for the entry identified by <span class="meta">〈<em class="metainner">entry1-label</em>〉</span> to the value of the <a id="wrglossary.20578"></a><a href="#glo:dual.field">field</a> identified by <span class="meta">〈<em class="metainner">field2-label</em>〉</span> for the entry identified by <span class="meta">〈<em class="metainner">entry2-label</em>〉</span>. <a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1219">40</a><p>
+<div class="defnbox"><a id="wrglossary.20579"></a><a href="#glo:GlsXtrLinkCounterName"><code class="csfmt">\GlsXtrLinkCounterName</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20580"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.26+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the name of the link counter associated with the given entry (no check for existence). <a href="#sec:linkcount">§6.2</a>; <a href="#wrglossary.8165">318</a><p>
+<div class="defnbox"><a id="wrglossary.20581"></a><a href="#glo:GlsXtrLinkCounterValue"><code class="csfmt">\GlsXtrLinkCounterValue</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20582"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.26+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the internal link count register associated with the given register or 0 if it hasn’t been defined. <a href="#sec:linkcount">§6.2</a>; <a href="#wrglossary.8161">318</a><p>
+<div class="defnbox"><a id="wrglossary.20583"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.20584"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.11+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A shortcut that uses <a id="wrglossary.20585"></a><a href="#glo:glsxtrresourcefile"><code class="csfmt">\glsxtrresourcefile</code></a>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">basename</em>〉</span>}, where the <span class="meta">〈<em class="metainner">basename</em>〉</span> is obtained from <a id="wrglossary.20586"></a><a href="#glo:jobname"><code class="csfmt">\jobname</code></a> and <a id="wrglossary.20587"></a><a href="#glo:glsxtrresourcecount"><code class="csfmt">\glsxtrresourcecount</code></a>. <a href="#sec:bib2gls">§11</a>; <a href="#wrglossary.12437">510</a><p>
+<div class="defnbox"><a id="wrglossary.20588"></a><a href="#glo:glsxtrlocalsetgrouptitle"><code class="csfmt">\glsxtrlocalsetgrouptitle</code></a><code class="code">{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}{<span class="meta">〈<em class="metainner">group-title</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20589"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.24+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally assigns the given title <span class="meta">〈<em class="metainner">group-title</em>〉</span> to the <a id="wrglossary.20590"></a><a href="#glo:idx.group">group</a> identified by <span class="meta">〈<em class="metainner">group-label</em>〉</span>. <a href="#sec:glosgroups">§8.6.4</a>; <a href="#wrglossary.10847">426</a><p>
+<div class="defnbox"><a id="wrglossary.20591"></a><a href="#glo:glsxtrlocationanchor"><code class="csfmt">\glsxtrlocationanchor</code></a><span class="floatrightbox"><a id="wrglossary.20592"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined by <a id="wrglossary.20593"></a><a href="#glo:glsxtrdisplaylocnameref"><code class="csfmt">\glsxtrdisplaylocnameref</code></a> to expand to the anchor constructed from <span class="meta">〈<em class="metainner">counter</em>〉</span> and <span class="meta">〈<em class="metainner">hcounter</em>〉</span>, which corresponds to the record counter. <a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13592">557</a><p>
+<div class="defnbox"><a id="wrglossary.20594"></a><a href="#glo:GlsXtrLocationField"><code class="csfmt">\GlsXtrLocationField</code></a><span class="floatrightbox"><span class="summarytag">initial: </span>location; <a id="wrglossary.20595"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the <a id="wrglossary.20596"></a><a href="#glo:dual.internalfieldlabel">internal field label</a> used to obtain the formatted <a id="wrglossary.20597"></a><a href="#glo:dual.locationlist">location list</a> for the <a id="wrglossary.20598"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>. <a href="#sec:printunsrtlocations">§8.4.2</a>; <a href="#wrglossary.10141">398</a><p>
+<div class="defnbox"><a id="wrglossary.20599"></a><dfn id="glo:glsxtrlocationhyperlink"><code class="csfmt">\glsxtrlocationhyperlink</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20600"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to create a hyperlink to either an external or an internal location, depending on whether or not <a id="wrglossary.20601"></a><a href="#glo:glsxtrsupplocationurl"><code class="csfmt">\glsxtrsupplocationurl</code></a> is defined and not empty (advanced command, see documented code for use).<p>
+<div class="defnbox"><a id="wrglossary.20602"></a><a href="#glo:GlsXtrLocationRecordCount"><code class="csfmt">\GlsXtrLocationRecordCount</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20603"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the entry’s record count for the given <a id="wrglossary.20604"></a><a href="#glo:@@glslabel@locationcounter">counter</a> and <a id="wrglossary.20605"></a><a href="#glo:@@glslabel@entrylocation">location</a> (stored in the <a id="wrglossary.20606"></a><a href="#glo:opt.glosfield.recordcount.counter.location"><span class="csoptfmt">recordcount.<span class="meta">〈<em class="metainner">counter</em>〉</span>.<span class="meta">〈<em class="metainner">location</em>〉</span></span></a> field) or to 0 if not set. <a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12762">523</a><p>
+<div class="defnbox"><a id="wrglossary.20607"></a><a href="#glo:glsxtrlocrangefmt"><code class="csfmt">\glsxtrlocrangefmt</code></a><span class="floatrightbox"><a id="wrglossary.20608"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the range format (set by <a id="wrglossary.20609"></a><a href="#glo:glsxtrdisplaystartloc"><code class="csfmt">\glsxtrdisplaystartloc</code></a>). <a href="#sec:glosstylenumlist">§8.6.3</a>; <a href="#wrglossary.10811">424</a><p>
+<div class="defnbox"><a id="wrglossary.20610"></a><a href="#glo:GLSxtrlong"><code class="csfmt">\GLSxtrlong</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.20611"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.20612"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.20613"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20614"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> but converts the <a id="wrglossary.20615"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.20616"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1545">53</a><p>
+<div class="defnbox"><a id="wrglossary.20617"></a><a href="#glo:Glsxtrlong"><code class="csfmt">\Glsxtrlong</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.20618"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.20619"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.20620"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20621"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> but converts the first character of the <a id="wrglossary.20622"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.20623"></a><a href="#glo:idx.uppercase">uppercase</a><a id="wrglossary.20624"></a> (for the start of a sentence) using <a id="wrglossary.20625"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. <a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1540">53</a><p>
+<div class="defnbox"><a id="wrglossary.20626"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.20627"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.20628"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.20629"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The text produced is obtained from the <a id="wrglossary.20630"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> value, formatted according to the <a id="wrglossary.20631"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> associated with the entry’s <a id="wrglossary.20632"></a><a href="#glo:idx.category">category</a>. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument will be inserted at the end of the <a id="wrglossary.20633"></a><a href="#glo:dual.linktext">link text</a>. This command does not alter or depend on the <a id="wrglossary.20634"></a><a href="#glo:dual.firstuseflag">first use flag</a>. For the first optional argument, see <a id="wrglossary.20635"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>. <a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1528">52</a><p>
+<div class="defnbox"><a id="wrglossary.20636"></a><a href="#glo:GLSxtrlongformat"><code class="csfmt">\GLSxtrlongformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20637"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20638"></a><a href="#glo:glsxtrlongformat"><code class="csfmt">\glsxtrlongformat</code></a> but <a id="wrglossary.20639"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#wrglossary.4455">176</a><p>
+<div class="defnbox"><a id="wrglossary.20640"></a><a href="#glo:Glsxtrlongformat"><code class="csfmt">\Glsxtrlongformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20641"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20642"></a><a href="#glo:glsxtrlongformat"><code class="csfmt">\glsxtrlongformat</code></a> but <a id="wrglossary.20643"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#wrglossary.4453">176</a><p>
+<div class="defnbox"><a id="wrglossary.20644"></a><a href="#glo:glsxtrlongformat"><code class="csfmt">\glsxtrlongformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20645"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Encapsulates the <a id="wrglossary.20646"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> field for the given entry with <span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument is the insertion material supplied in the final optional argument of the <a id="wrglossary.20647"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> or <a id="wrglossary.20648"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands. The <a id="wrglossary.20649"></a><a href="#glo:ifglsxtrinsertinside"><code class="csfmt">\ifglsxtrinsertinside</code></a>, <a id="wrglossary.20650"></a><a href="#glo:dual.innerformatting">inner formatting</a>, and accessibility settings are supported. <a href="#wrglossary.4443">175</a><p>
+<div class="defnbox"><a id="wrglossary.20651"></a><a href="#glo:GLSxtrlongformatgrp"><code class="csfmt">\GLSxtrlongformatgrp</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20652"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20653"></a><a href="#glo:glsxtrlongformatgrp"><code class="csfmt">\glsxtrlongformatgrp</code></a> but <a id="wrglossary.20654"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.4469">177</a><p>
+<div class="defnbox"><a id="wrglossary.20655"></a><a href="#glo:Glsxtrlongformatgrp"><code class="csfmt">\Glsxtrlongformatgrp</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20656"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20657"></a><a href="#glo:glsxtrlongformatgrp"><code class="csfmt">\glsxtrlongformatgrp</code></a> but <a id="wrglossary.20658"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#wrglossary.4467">176</a><p>
+<div class="defnbox"><a id="wrglossary.20659"></a><a href="#glo:glsxtrlongformatgrp"><code class="csfmt">\glsxtrlongformatgrp</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20660"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20661"></a><a href="#glo:glsxtrlongformat"><code class="csfmt">\glsxtrlongformat</code></a> but adds grouping around <span class="meta">〈<em class="metainner">insert</em>〉</span> (with the <a id="wrglossary.20662"></a><a href="#glo:dual.innerformatting">inner formatting</a> inside the group). <a href="#wrglossary.4464">176</a><p>
+<div class="defnbox"><a id="wrglossary.20663"></a><a href="#glo:glsxtrlonghyphen"><code class="csfmt">\glsxtrlonghyphen</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">long</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20664"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the long form according to the <a id="wrglossary.20665"></a><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen"><span class="abbrstylefmt">long-hyphen-postshort-hyphen</span></a> style. <a href="#wrglossary.3710">150</a><p>
+<div class="defnbox"><a id="wrglossary.20666"></a><a href="#glo:GLSxtrlonghyphennoshort"><code class="csfmt">\GLSxtrlonghyphennoshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">long</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20667"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20668"></a><a href="#glo:glsxtrlonghyphennoshort"><code class="csfmt">\glsxtrlonghyphennoshort</code></a> but converts <span class="meta">〈<em class="metainner">insert</em>〉</span> to <a id="wrglossary.20669"></a><a href="#glo:idx.allcaps">all caps</a> The <span class="meta">〈<em class="metainner">long</em>〉</span> argument should be supplied as <a id="wrglossary.20670"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.3705">150</a><p>
+<div class="defnbox"><a id="wrglossary.20671"></a><a href="#glo:glsxtrlonghyphennoshort"><code class="csfmt">\glsxtrlonghyphennoshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">long</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20672"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the long form according to the <a id="wrglossary.20673"></a><a href="#glo:opt.abbrstyle.long-hyphen-noshort-desc-noreg"><span class="abbrstylefmt">long-hyphen-noshort-desc-noreg</span></a> style. <a href="#wrglossary.3699">149</a><p>
+<div class="defnbox"><a id="wrglossary.20674"></a><a href="#glo:glsxtrlonghyphennoshortdescsort"><code class="csfmt">\glsxtrlonghyphennoshortdescsort</code></a><span class="floatrightbox"><a id="wrglossary.20675"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the sort value for the <a id="wrglossary.20676"></a><a href="#glo:opt.abbrstyle.long-hyphen-noshort-desc-noreg"><span class="abbrstylefmt">long-hyphen-noshort-desc-noreg</span></a> styles. <a href="#wrglossary.3682">149</a><p>
+<div class="defnbox"><a id="wrglossary.20677"></a><a href="#glo:glsxtrlonghyphennoshortsort"><code class="csfmt">\glsxtrlonghyphennoshortsort</code></a><span class="floatrightbox"><a id="wrglossary.20678"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the sort value for the <a id="wrglossary.20679"></a><a href="#glo:opt.abbrstyle.long-hyphen-noshort-noreg"><span class="abbrstylefmt">long-hyphen-noshort-noreg</span></a> styles. <a href="#wrglossary.3678">149</a><p>
+<div class="defnbox"><a id="wrglossary.20680"></a><a href="#glo:GLSxtrlonghyphenshort"><code class="csfmt">\GLSxtrlonghyphenshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">long</em>〉</span>}{<span class="meta">〈<em class="metainner">short</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20681"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20682"></a><a href="#glo:glsxtrlonghyphenshort"><code class="csfmt">\glsxtrlonghyphenshort</code></a> but converts <span class="meta">〈<em class="metainner">insert</em>〉</span> to <a id="wrglossary.20683"></a><a href="#glo:idx.allcaps">all caps</a>. The <span class="meta">〈<em class="metainner">long</em>〉</span> and <span class="meta">〈<em class="metainner">short</em>〉</span> arguments should be supplied as <a id="wrglossary.20684"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.3694">149</a><p>
+<div class="defnbox"><a id="wrglossary.20685"></a><a href="#glo:glsxtrlonghyphenshort"><code class="csfmt">\glsxtrlonghyphenshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">long</em>〉</span>}{<span class="meta">〈<em class="metainner">short</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20686"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the long and short form according to the <a id="wrglossary.20687"></a><a href="#glo:opt.abbrstyle.long-hyphen-short-hyphen"><span class="abbrstylefmt">long-hyphen-short-hyphen</span></a> style. <a href="#wrglossary.3686">149</a><p>
+<div class="defnbox"><a id="wrglossary.20688"></a><a href="#glo:glsxtrlonghyphenshortsort"><code class="csfmt">\glsxtrlonghyphenshortsort</code></a><span class="floatrightbox"><a id="wrglossary.20689"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the sort value for the <a id="wrglossary.20690"></a><a href="#glo:opt.abbrstyle.long-hyphen-short-hyphen"><span class="abbrstylefmt">long-hyphen-short-hyphen</span></a> styles. <a href="#wrglossary.3670">148</a><p>
+<div class="defnbox"><a id="wrglossary.20691"></a><a href="#glo:glsxtrlongnoshortdescname"><code class="csfmt">\glsxtrlongnoshortdescname</code></a><span class="floatrightbox"><a id="wrglossary.20692"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.25+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the name value for styles like <a id="wrglossary.20693"></a><a href="#glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></a>. <a href="#wrglossary.3644">147</a><p>
+<div class="defnbox"><a id="wrglossary.20694"></a><a href="#glo:glsxtrlongnoshortname"><code class="csfmt">\glsxtrlongnoshortname</code></a><span class="floatrightbox"><a id="wrglossary.20695"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.25+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the name value for styles like <a id="wrglossary.20696"></a><a href="#glo:opt.abbrstyle.long-noshort"><span class="abbrstylefmt">long-noshort</span></a>. <a href="#wrglossary.3650">147</a><p>
+<div class="defnbox"><a id="wrglossary.20697"></a><a href="#glo:GLSxtrlongpl"><code class="csfmt">\GLSxtrlongpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.20698"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.20699"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.20700"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20701"></a><a href="#glo:glsxtrlongpl"><code class="csfmt">\glsxtrlongpl</code></a> but converts the <a id="wrglossary.20702"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.20703"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1559">53</a><p>
+<div class="defnbox"><a id="wrglossary.20704"></a><a href="#glo:Glsxtrlongpl"><code class="csfmt">\Glsxtrlongpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.20705"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.20706"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.20707"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20708"></a><a href="#glo:glsxtrlongpl"><code class="csfmt">\glsxtrlongpl</code></a> but converts the first character of the <a id="wrglossary.20709"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.20710"></a><a href="#glo:idx.uppercase">uppercase</a><a id="wrglossary.20711"></a> (for the start of a sentence) using <a id="wrglossary.20712"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. <a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1554">53</a><p>
+<div class="defnbox"><a id="wrglossary.20713"></a><a href="#glo:glsxtrlongpl"><code class="csfmt">\glsxtrlongpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.20714"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.20715"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.20716"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The text produced is obtained from the <a id="wrglossary.20717"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> value, formatted according to the <a id="wrglossary.20718"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> associated with the entry’s <a id="wrglossary.20719"></a><a href="#glo:idx.category">category</a>. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument will be inserted at the end of the <a id="wrglossary.20720"></a><a href="#glo:dual.linktext">link text</a>. This command does not alter or depend on the <a id="wrglossary.20721"></a><a href="#glo:dual.firstuseflag">first use flag</a>. For the first optional argument, see <a id="wrglossary.20722"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>. <a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1550">53</a><p>
+<div class="defnbox"><a id="wrglossary.20723"></a><a href="#glo:GLSxtrlongplformat"><code class="csfmt">\GLSxtrlongplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20724"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20725"></a><a href="#glo:glsxtrlongplformat"><code class="csfmt">\glsxtrlongplformat</code></a> but <a id="wrglossary.20726"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.4462">176</a><p>
+<div class="defnbox"><a id="wrglossary.20727"></a><a href="#glo:Glsxtrlongplformat"><code class="csfmt">\Glsxtrlongplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20728"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20729"></a><a href="#glo:glsxtrlongplformat"><code class="csfmt">\glsxtrlongplformat</code></a> but <a id="wrglossary.20730"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#wrglossary.4460">176</a><p>
+<div class="defnbox"><a id="wrglossary.20731"></a><a href="#glo:glsxtrlongplformat"><code class="csfmt">\glsxtrlongplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20732"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20733"></a><a href="#glo:glsxtrlongformat"><code class="csfmt">\glsxtrlongformat</code></a> but for the <a id="wrglossary.20734"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> field. <a href="#wrglossary.4457">176</a><p>
+<div class="defnbox"><a id="wrglossary.20735"></a><a href="#glo:GLSxtrlongplformatgrp"><code class="csfmt">\GLSxtrlongplformatgrp</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20736"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20737"></a><a href="#glo:glsxtrlongplformatgrp"><code class="csfmt">\glsxtrlongplformatgrp</code></a> but <a id="wrglossary.20738"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.4476">177</a><p>
+<div class="defnbox"><a id="wrglossary.20739"></a><a href="#glo:Glsxtrlongplformatgrp"><code class="csfmt">\Glsxtrlongplformatgrp</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20740"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20741"></a><a href="#glo:glsxtrlongplformatgrp"><code class="csfmt">\glsxtrlongplformatgrp</code></a> but <a id="wrglossary.20742"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#wrglossary.4474">177</a><p>
+<div class="defnbox"><a id="wrglossary.20743"></a><a href="#glo:glsxtrlongplformatgrp"><code class="csfmt">\glsxtrlongplformatgrp</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20744"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20745"></a><a href="#glo:glsxtrlongplformat"><code class="csfmt">\glsxtrlongplformat</code></a> but adds grouping around <span class="meta">〈<em class="metainner">insert</em>〉</span> (with the <a id="wrglossary.20746"></a><a href="#glo:dual.innerformatting">inner formatting</a> inside the group). <a href="#wrglossary.4471">177</a><p>
+<div class="defnbox"><a id="wrglossary.20747"></a><a href="#glo:glsxtrlongshortdescname"><code class="csfmt">\glsxtrlongshortdescname</code></a><span class="floatrightbox"><a id="wrglossary.20748"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the name value for <a id="wrglossary.20749"></a><a href="#glo:opt.abbrstyle.long-short-desc"><span class="abbrstylefmt">long-short-desc</span></a> styles. <a href="#wrglossary.3303">134</a><p>
+<div class="defnbox"><a id="wrglossary.20750"></a><a href="#glo:glsxtrlongshortdescsort"><code class="csfmt">\glsxtrlongshortdescsort</code></a><span class="floatrightbox"><a id="wrglossary.20751"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the sort value for <a id="wrglossary.20752"></a><a href="#glo:opt.abbrstyle.long-short-desc"><span class="abbrstylefmt">long-short-desc</span></a> styles. <a href="#wrglossary.3295">133</a><p>
+<div class="defnbox"><a id="wrglossary.20753"></a><a href="#glo:GLSxtrlongshortformat"><code class="csfmt">\GLSxtrlongshortformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20754"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20755"></a><a href="#glo:glsxtrlongshortformat"><code class="csfmt">\glsxtrlongshortformat</code></a> but <a id="wrglossary.20756"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.4520">179</a><p>
+<div class="defnbox"><a id="wrglossary.20757"></a><a href="#glo:Glsxtrlongshortformat"><code class="csfmt">\Glsxtrlongshortformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20758"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20759"></a><a href="#glo:glsxtrlongshortformat"><code class="csfmt">\glsxtrlongshortformat</code></a> but <a id="wrglossary.20760"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#wrglossary.4518">179</a><p>
+<div class="defnbox"><a id="wrglossary.20761"></a><a href="#glo:glsxtrlongshortformat"><code class="csfmt">\glsxtrlongshortformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20762"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the long form with <a id="wrglossary.20763"></a><a href="#glo:glsxtrlongformat"><code class="csfmt">\glsxtrlongformat</code></a> and the short form in parentheses with <a id="wrglossary.20764"></a><a href="#glo:glsxtrshortformat"><code class="csfmt">\glsxtrshortformat</code></a>. <a href="#wrglossary.4513">179</a><p>
+<div class="defnbox"><a id="wrglossary.20765"></a><a href="#glo:glsxtrlongshortname"><code class="csfmt">\glsxtrlongshortname</code></a><span class="floatrightbox"><a id="wrglossary.20766"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.25+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the name value for <a id="wrglossary.20767"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a> styles. <a href="#wrglossary.3289">133</a><p>
+<div class="defnbox"><a id="wrglossary.20768"></a><a href="#glo:GLSxtrlongshortplformat"><code class="csfmt">\GLSxtrlongshortplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20769"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20770"></a><a href="#glo:glsxtrlongshortplformat"><code class="csfmt">\glsxtrlongshortplformat</code></a> but <a id="wrglossary.20771"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.4528">180</a><p>
+<div class="defnbox"><a id="wrglossary.20772"></a><a href="#glo:Glsxtrlongshortplformat"><code class="csfmt">\Glsxtrlongshortplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20773"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20774"></a><a href="#glo:glsxtrlongshortplformat"><code class="csfmt">\glsxtrlongshortplformat</code></a> but <a id="wrglossary.20775"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#wrglossary.4526">179</a><p>
+<div class="defnbox"><a id="wrglossary.20776"></a><a href="#glo:glsxtrlongshortplformat"><code class="csfmt">\glsxtrlongshortplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20777"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20778"></a><a href="#glo:glsxtrlongshortformat"><code class="csfmt">\glsxtrlongshortformat</code></a> but for the plurals. <a href="#wrglossary.4522">179</a><p>
+<div class="defnbox"><a id="wrglossary.20779"></a><a href="#glo:glsxtrlongshortscuserdescname"><code class="csfmt">\glsxtrlongshortscuserdescname</code></a><span class="floatrightbox"><a id="wrglossary.20780"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the value for the <a id="wrglossary.20781"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key for styles like <a id="wrglossary.20782"></a><a href="#glo:opt.abbrstyle.long-postshort-sc-user-desc"><span class="abbrstylefmt">long-postshort-sc-user-desc</span></a>. <a href="#wrglossary.3424">138</a><p>
+<div class="defnbox"><a id="wrglossary.20783"></a><a href="#glo:glsxtrlongshortscusername"><code class="csfmt">\glsxtrlongshortscusername</code></a><span class="floatrightbox"><a id="wrglossary.20784"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the value for the <a id="wrglossary.20785"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key for styles like <a id="wrglossary.20786"></a><a href="#glo:opt.abbrstyle.long-postshort-sc-user"><span class="abbrstylefmt">long-postshort-sc-user</span></a>. <a href="#wrglossary.3419">138</a><p>
+<div class="defnbox"><a id="wrglossary.20787"></a><a href="#glo:glsxtrlongshortuserdescname"><code class="csfmt">\glsxtrlongshortuserdescname</code></a><span class="floatrightbox"><a id="wrglossary.20788"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.25+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the value for the <a id="wrglossary.20789"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key for styles like <a id="wrglossary.20790"></a><a href="#glo:opt.abbrstyle.long-short-user-desc"><span class="abbrstylefmt">long-short-user-desc</span></a>. <a href="#wrglossary.3410">138</a><p>
+<div class="defnbox"><a id="wrglossary.20791"></a><a href="#glo:glsxtrmarkhook"><code class="csfmt">\glsxtrmarkhook</code></a></div><!-- end of defnbox -->
+<p>
+Hook that’s performed at the start of <a id="wrglossary.20792"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a>, <a id="wrglossary.20793"></a><a href="#glo:markboth"><code class="csfmt">\markboth</code></a> and <a id="wrglossary.20794"></a><a href="#glo:@starttoc"><code class="csfmt">\@starttoc</code></a> to redefine commands that need to change when they occur within page headers or contents. This must be counteracted with <a id="wrglossary.20795"></a><a href="#glo:glsxtrrestoremarkhook"><code class="csfmt">\glsxtrrestoremarkhook</code></a> afterwards. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5828">227</a><p>
+<div class="defnbox"><a id="wrglossary.20796"></a><a href="#glo:glsxtrMathGreekIIrules"><code class="csfmt">\glsxtrMathGreekIIrules</code></a><span class="floatrightbox"><a id="wrglossary.20797"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the second set of math Greek sort rules. <a href="#wrglossary.13365">551</a><p>
+<div class="defnbox"><a id="wrglossary.20798"></a><a href="#glo:glsxtrMathGreekIrules"><code class="csfmt">\glsxtrMathGreekIrules</code></a><span class="floatrightbox"><a id="wrglossary.20799"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the first set of math Greek sort rules. <a href="#wrglossary.13358">551</a><p>
+<div class="defnbox"><a id="wrglossary.20800"></a><a href="#glo:glsxtrMathItalicAlpha"><code class="csfmt">\glsxtrMathItalicAlpha</code></a><span class="floatrightbox"><a id="wrglossary.20801"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek alpha. <a href="#wrglossary.13411">553</a><p>
+<div class="defnbox"><a id="wrglossary.20802"></a><a href="#glo:glsxtrMathItalicBeta"><code class="csfmt">\glsxtrMathItalicBeta</code></a><span class="floatrightbox"><a id="wrglossary.20803"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek beta. <a href="#wrglossary.13413">553</a><p>
+<div class="defnbox"><a id="wrglossary.20804"></a><a href="#glo:glsxtrMathItalicChi"><code class="csfmt">\glsxtrMathItalicChi</code></a><span class="floatrightbox"><a id="wrglossary.20805"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek chi. <a href="#wrglossary.13455">553</a><p>
+<div class="defnbox"><a id="wrglossary.20806"></a><a href="#glo:glsxtrMathItalicDelta"><code class="csfmt">\glsxtrMathItalicDelta</code></a><span class="floatrightbox"><a id="wrglossary.20807"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek delta. <a href="#wrglossary.13417">553</a><p>
+<div class="defnbox"><a id="wrglossary.20808"></a><a href="#glo:glsxtrMathItalicDigamma"><code class="csfmt">\glsxtrMathItalicDigamma</code></a><span class="floatrightbox"><a id="wrglossary.20809"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek digamma. <a href="#wrglossary.13421">553</a><p>
+<div class="defnbox"><a id="wrglossary.20810"></a><a href="#glo:glsxtrMathItalicEpsilon"><code class="csfmt">\glsxtrMathItalicEpsilon</code></a><span class="floatrightbox"><a id="wrglossary.20811"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek epsilon. <a href="#wrglossary.13419">553</a><p>
+<div class="defnbox"><a id="wrglossary.20812"></a><a href="#glo:glsxtrMathItalicEta"><code class="csfmt">\glsxtrMathItalicEta</code></a><span class="floatrightbox"><a id="wrglossary.20813"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek eta. <a href="#wrglossary.13425">553</a><p>
+<div class="defnbox"><a id="wrglossary.20814"></a><a href="#glo:glsxtrMathItalicGamma"><code class="csfmt">\glsxtrMathItalicGamma</code></a><span class="floatrightbox"><a id="wrglossary.20815"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek gamma. <a href="#wrglossary.13415">553</a><p>
+<div class="defnbox"><a id="wrglossary.20816"></a><a href="#glo:glsxtrMathItalicGreekIIrules"><code class="csfmt">\glsxtrMathItalicGreekIIrules</code></a><span class="floatrightbox"><a id="wrglossary.20817"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the second set of math italic Greek sort rules. <a href="#wrglossary.13384">552</a><p>
+<div class="defnbox"><a id="wrglossary.20818"></a><a href="#glo:glsxtrMathItalicGreekIrules"><code class="csfmt">\glsxtrMathItalicGreekIrules</code></a><span class="floatrightbox"><a id="wrglossary.20819"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the first set of math italic Greek sort rules. <a href="#wrglossary.13375">552</a><p>
+<div class="defnbox"><a id="wrglossary.20820"></a><a href="#glo:glsxtrMathItalicIota"><code class="csfmt">\glsxtrMathItalicIota</code></a><span class="floatrightbox"><a id="wrglossary.20821"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek iota. <a href="#wrglossary.13429">553</a><p>
+<div class="defnbox"><a id="wrglossary.20822"></a><a href="#glo:glsxtrMathItalicKappa"><code class="csfmt">\glsxtrMathItalicKappa</code></a><span class="floatrightbox"><a id="wrglossary.20823"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek kappa. <a href="#wrglossary.13431">553</a><p>
+<div class="defnbox"><a id="wrglossary.20824"></a><a href="#glo:glsxtrMathItalicLambda"><code class="csfmt">\glsxtrMathItalicLambda</code></a><span class="floatrightbox"><a id="wrglossary.20825"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek lambda. <a href="#wrglossary.13433">553</a><p>
+<div class="defnbox"><a id="wrglossary.20826"></a><a href="#glo:glsxtrMathItalicLowerGreekIIrules"><code class="csfmt">\glsxtrMathItalicLowerGreekIIrules</code></a><span class="floatrightbox"><a id="wrglossary.20827"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the second set of math italic <a id="wrglossary.20828"></a><a href="#glo:idx.lowercase">lowercase</a> Greek sort rules. <a href="#wrglossary.13401">553</a><p>
+<div class="defnbox"><a id="wrglossary.20829"></a><a href="#glo:glsxtrMathItalicLowerGreekIrules"><code class="csfmt">\glsxtrMathItalicLowerGreekIrules</code></a><span class="floatrightbox"><a id="wrglossary.20830"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the first set of math italic <a id="wrglossary.20831"></a><a href="#glo:idx.lowercase">lowercase</a> Greek sort rules. <a href="#wrglossary.13396">552</a><p>
+<div class="defnbox"><a id="wrglossary.20832"></a><a href="#glo:glsxtrMathItalicMu"><code class="csfmt">\glsxtrMathItalicMu</code></a><span class="floatrightbox"><a id="wrglossary.20833"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek mu. <a href="#wrglossary.13435">553</a><p>
+<div class="defnbox"><a id="wrglossary.20834"></a><a href="#glo:glsxtrMathItalicNabla"><code class="csfmt">\glsxtrMathItalicNabla</code></a><span class="floatrightbox"><a id="wrglossary.20835"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the Unicode codepoint for nabla. <a href="#wrglossary.13461">553</a><p>
+<div class="defnbox"><a id="wrglossary.20836"></a><a href="#glo:glsxtrMathItalicNu"><code class="csfmt">\glsxtrMathItalicNu</code></a><span class="floatrightbox"><a id="wrglossary.20837"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek nu. <a href="#wrglossary.13437">553</a><p>
+<div class="defnbox"><a id="wrglossary.20838"></a><a href="#glo:glsxtrMathItalicOmega"><code class="csfmt">\glsxtrMathItalicOmega</code></a><span class="floatrightbox"><a id="wrglossary.20839"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek omega. <a href="#wrglossary.13459">553</a><p>
+<div class="defnbox"><a id="wrglossary.20840"></a><a href="#glo:glsxtrMathItalicOmicron"><code class="csfmt">\glsxtrMathItalicOmicron</code></a><span class="floatrightbox"><a id="wrglossary.20841"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek omicron. <a href="#wrglossary.13441">553</a><p>
+<div class="defnbox"><a id="wrglossary.20842"></a><a href="#glo:glsxtrMathItalicPartial"><code class="csfmt">\glsxtrMathItalicPartial</code></a><span class="floatrightbox"><a id="wrglossary.20843"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the Unicode codepoint for math italic partial differential. <a href="#wrglossary.13460">553</a><p>
+<div class="defnbox"><a id="wrglossary.20844"></a><a href="#glo:glsxtrMathItalicPhi"><code class="csfmt">\glsxtrMathItalicPhi</code></a><span class="floatrightbox"><a id="wrglossary.20845"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek phi. <a href="#wrglossary.13453">553</a><p>
+<div class="defnbox"><a id="wrglossary.20846"></a><a href="#glo:glsxtrMathItalicPi"><code class="csfmt">\glsxtrMathItalicPi</code></a><span class="floatrightbox"><a id="wrglossary.20847"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek pi. <a href="#wrglossary.13443">553</a><p>
+<div class="defnbox"><a id="wrglossary.20848"></a><a href="#glo:glsxtrMathItalicPsi"><code class="csfmt">\glsxtrMathItalicPsi</code></a><span class="floatrightbox"><a id="wrglossary.20849"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek psi. <a href="#wrglossary.13457">553</a><p>
+<div class="defnbox"><a id="wrglossary.20850"></a><a href="#glo:glsxtrMathItalicRho"><code class="csfmt">\glsxtrMathItalicRho</code></a><span class="floatrightbox"><a id="wrglossary.20851"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek rho. <a href="#wrglossary.13445">553</a><p>
+<div class="defnbox"><a id="wrglossary.20852"></a><a href="#glo:glsxtrMathItalicSigma"><code class="csfmt">\glsxtrMathItalicSigma</code></a><span class="floatrightbox"><a id="wrglossary.20853"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek sigma. <a href="#wrglossary.13447">553</a><p>
+<div class="defnbox"><a id="wrglossary.20854"></a><a href="#glo:glsxtrMathItalicTau"><code class="csfmt">\glsxtrMathItalicTau</code></a><span class="floatrightbox"><a id="wrglossary.20855"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek tau. <a href="#wrglossary.13449">553</a><p>
+<div class="defnbox"><a id="wrglossary.20856"></a><a href="#glo:glsxtrMathItalicTheta"><code class="csfmt">\glsxtrMathItalicTheta</code></a><span class="floatrightbox"><a id="wrglossary.20857"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek theta. <a href="#wrglossary.13427">553</a><p>
+<div class="defnbox"><a id="wrglossary.20858"></a><a href="#glo:glsxtrMathItalicUpperGreekIIrules"><code class="csfmt">\glsxtrMathItalicUpperGreekIIrules</code></a><span class="floatrightbox"><a id="wrglossary.20859"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the second set of math italic <a id="wrglossary.20860"></a><a href="#glo:idx.uppercase">uppercase</a> Greek sort rules. <a href="#wrglossary.13392">552</a><p>
+<div class="defnbox"><a id="wrglossary.20861"></a><a href="#glo:glsxtrMathItalicUpperGreekIrules"><code class="csfmt">\glsxtrMathItalicUpperGreekIrules</code></a><span class="floatrightbox"><a id="wrglossary.20862"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the first set of math italic <a id="wrglossary.20863"></a><a href="#glo:idx.uppercase">uppercase</a> Greek sort rules. <a href="#wrglossary.13387">552</a><p>
+<div class="defnbox"><a id="wrglossary.20864"></a><a href="#glo:glsxtrMathItalicUpsilon"><code class="csfmt">\glsxtrMathItalicUpsilon</code></a><span class="floatrightbox"><a id="wrglossary.20865"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek upsilon. <a href="#wrglossary.13451">553</a><p>
+<div class="defnbox"><a id="wrglossary.20866"></a><a href="#glo:glsxtrMathItalicXi"><code class="csfmt">\glsxtrMathItalicXi</code></a><span class="floatrightbox"><a id="wrglossary.20867"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek xi. <a href="#wrglossary.13439">553</a><p>
+<div class="defnbox"><a id="wrglossary.20868"></a><a href="#glo:glsxtrMathItalicZeta"><code class="csfmt">\glsxtrMathItalicZeta</code></a><span class="floatrightbox"><a id="wrglossary.20869"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math italic Greek zeta. <a href="#wrglossary.13423">553</a><p>
+<div class="defnbox"><a id="wrglossary.20870"></a><a href="#glo:glsxtrMathUpGreekIIrules"><code class="csfmt">\glsxtrMathUpGreekIIrules</code></a><span class="floatrightbox"><a id="wrglossary.20871"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the second set of math upright Greek sort rules. <a href="#wrglossary.13372">552</a><p>
+<div class="defnbox"><a id="wrglossary.20872"></a><a href="#glo:glsxtrMathUpGreekIrules"><code class="csfmt">\glsxtrMathUpGreekIrules</code></a><span class="floatrightbox"><a id="wrglossary.20873"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the first set of math upright Greek sort rules. <a href="#wrglossary.13367">552</a><p>
+<div class="defnbox"><a id="wrglossary.20874"></a><a href="#glo:glsxtrMFUsave"><code class="csfmt">\glsxtrMFUsave</code></a><span class="floatrightbox"><a id="wrglossary.20875"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used on the first instance of <a id="wrglossary.20876"></a><a href="#glo:glsxtrresourcefile"><code class="csfmt">\glsxtrresourcefile</code></a>, this will add <a id="wrglossary.20877"></a><a href="#glo:MFUsave"><code class="csfmt">\MFUsave</code></a> to the begin document hook and then disable itself. This is provided to help <a id="wrglossary.20878"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> pick up any of <a id="wrglossary.20879"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span>’s</a> exclusions, blockers and mappings to assist with its <a id="wrglossary.20880"></a><a href="#glo:idx.sentencecase">sentence case</a> function. <a href="#sec:bib2gls">§11</a>; <a href="#wrglossary.12503">512</a><p>
+<div class="defnbox"><a id="wrglossary.20881"></a><a href="#glo:GlsXtrMglsOrGls"><code class="csfmt">\GlsXtrMglsOrGls</code></a><code class="code">{<span class="meta">〈<em class="metainner">mgls cs</em>〉</span>}{<span class="meta">〈<em class="metainner">gls cs</em>〉</span>}<span class="meta">〈<em class="metainner">modifier</em>〉</span>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.20882"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If <span class="meta">〈<em class="metainner">label</em>〉</span> matches a defined multi-entry, this will do <span class="meta">〈<em class="metainner">mgls cls</em>〉</span> otherwise it will do <span class="meta">〈<em class="metainner">gls cs</em>〉</span>. The <span class="meta">〈<em class="metainner">modifier</em>〉</span> (<code class="code">*</code> or <code class="code">+</code> or the token identified with <a id="wrglossary.20883"></a><a href="#glo:GlsXtrSetAltModifier"><code class="csfmt">\GlsXtrSetAltModifier</code></a>) may be omitted. <a href="#sec:multientries">§7</a>; <a href="#wrglossary.8297">325</a><p>
+<div class="defnbox"><a id="wrglossary.20884"></a><a href="#glo:glsxtrmglsWarnAllSkipped"><code class="csfmt">\glsxtrmglsWarnAllSkipped</code></a><code class="code">{<span class="meta">〈<em class="metainner">message</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20885"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Issues the given warning message with <a id="wrglossary.20886"></a><a href="#glo:GlossariesExtraWarning"><code class="csfmt">\GlossariesExtraWarning</code></a> and does <code class="code"><span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code> (this warning is used if all elements of a multi-entry set are skipped). <a href="#sec:multiglsoptionsskip">§7.9.5</a>; <a href="#wrglossary.8932">358</a><p>
+<div class="defnbox"><a id="wrglossary.20887"></a><a href="#glo:GLSxtrmultientryadjustedname"><code class="csfmt">\GLSxtrmultientryadjustedname</code></a><code class="code">{<span class="meta">〈<em class="metainner">sublist1</em>〉</span>}{<span class="meta">〈<em class="metainner">name</em>〉</span>}{<span class="meta">〈<em class="metainner">sublist2</em>〉</span>}{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20888"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20889"></a><a href="#glo:glsxtrmultientryadjustedname"><code class="csfmt">\glsxtrmultientryadjustedname</code></a> but <a id="wrglossary.20890"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9371">372</a><p>
+<div class="defnbox"><a id="wrglossary.20891"></a><a href="#glo:GlsXtrmultientryadjustedname"><code class="csfmt">\GlsXtrmultientryadjustedname</code></a><code class="code">{<span class="meta">〈<em class="metainner">sublist1</em>〉</span>}{<span class="meta">〈<em class="metainner">name</em>〉</span>}{<span class="meta">〈<em class="metainner">sublist2</em>〉</span>}{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20892"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20893"></a><a href="#glo:glsxtrmultientryadjustedname"><code class="csfmt">\glsxtrmultientryadjustedname</code></a> but <a id="wrglossary.20894"></a><a href="#glo:idx.titlecase">title case</a>. <a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9368">372</a><p>
+<div class="defnbox"><a id="wrglossary.20895"></a><a href="#glo:Glsxtrmultientryadjustedname"><code class="csfmt">\Glsxtrmultientryadjustedname</code></a><code class="code">{<span class="meta">〈<em class="metainner">sublist1</em>〉</span>}{<span class="meta">〈<em class="metainner">name</em>〉</span>}{<span class="meta">〈<em class="metainner">sublist2</em>〉</span>}{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20896"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.20897"></a><a href="#glo:glsxtrmultientryadjustedname"><code class="csfmt">\glsxtrmultientryadjustedname</code></a> but <a id="wrglossary.20898"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9365">372</a><p>
+<div class="defnbox"><a id="wrglossary.20899"></a><a href="#glo:glsxtrmultientryadjustedname"><code class="csfmt">\glsxtrmultientryadjustedname</code></a><code class="code">{<span class="meta">〈<em class="metainner">sublist1</em>〉</span>}{<span class="meta">〈<em class="metainner">name</em>〉</span>}{<span class="meta">〈<em class="metainner">sublist2</em>〉</span>}{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20900"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.20901"></a><a href="#glo:opt.resource.compound-adjust-name"><span class="csoptfmt">compound-adjust-name</span></a>. <a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9358">372</a><p>
+<div class="defnbox"><a id="wrglossary.20902"></a><a href="#glo:GLSxtrmultientryadjustednamefmt"><code class="csfmt">\GLSxtrmultientryadjustednamefmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20903"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.20904"></a><a href="#glo:GLSxtrmultientryadjustedname"><code class="csfmt">\GLSxtrmultientryadjustedname</code></a> to encapsulate the main entry name. <a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9388">373</a><p>
+<div class="defnbox"><a id="wrglossary.20905"></a><a href="#glo:GlsXtrmultientryadjustednamefmt"><code class="csfmt">\GlsXtrmultientryadjustednamefmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20906"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.20907"></a><a href="#glo:GlsXtrmultientryadjustedname"><code class="csfmt">\GlsXtrmultientryadjustedname</code></a> to encapsulate the main entry name. <a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9384">373</a><p>
+<div class="defnbox"><a id="wrglossary.20908"></a><a href="#glo:Glsxtrmultientryadjustednamefmt"><code class="csfmt">\Glsxtrmultientryadjustednamefmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20909"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.20910"></a><a href="#glo:Glsxtrmultientryadjustedname"><code class="csfmt">\Glsxtrmultientryadjustedname</code></a> to encapsulate the main entry name if the first sublist is empty. <a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9381">373</a><p>
+<div class="defnbox"><a id="wrglossary.20911"></a><a href="#glo:glsxtrmultientryadjustednamefmt"><code class="csfmt">\glsxtrmultientryadjustednamefmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20912"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.20913"></a><a href="#glo:glsxtrmultientryadjustedname"><code class="csfmt">\glsxtrmultientryadjustedname</code></a> to encapsulate the main entry name. <a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9379">373</a><p>
+<div class="defnbox"><a id="wrglossary.20914"></a><a href="#glo:GLSxtrmultientryadjustednameother"><code class="csfmt">\GLSxtrmultientryadjustednameother</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20915"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.20916"></a><a href="#glo:GLSxtrmultientryadjustedname"><code class="csfmt">\GLSxtrmultientryadjustedname</code></a> to encapsulate the other (not main) entries. <a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9399">374</a><p>
+<div class="defnbox"><a id="wrglossary.20917"></a><a href="#glo:GlsXtrmultientryadjustednameother"><code class="csfmt">\GlsXtrmultientryadjustednameother</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20918"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.20919"></a><a href="#glo:GlsXtrmultientryadjustedname"><code class="csfmt">\GlsXtrmultientryadjustedname</code></a> to encapsulate the other (not main) entries. <a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9396">374</a><p>
+<div class="defnbox"><a id="wrglossary.20920"></a><a href="#glo:Glsxtrmultientryadjustednameother"><code class="csfmt">\Glsxtrmultientryadjustednameother</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20921"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.20922"></a><a href="#glo:Glsxtrmultientryadjustedname"><code class="csfmt">\Glsxtrmultientryadjustedname</code></a> to encapsulate the other (not main) entries. <a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9393">374</a><p>
+<div class="defnbox"><a id="wrglossary.20923"></a><a href="#glo:glsxtrmultientryadjustednameother"><code class="csfmt">\glsxtrmultientryadjustednameother</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20924"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.20925"></a><a href="#glo:glsxtrmultientryadjustedname"><code class="csfmt">\glsxtrmultientryadjustedname</code></a> to encapsulate the other (not main) entries. <a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9390">374</a><p>
+<div class="defnbox"><a id="wrglossary.20926"></a><a href="#glo:glsxtrmultientryadjustednamepostsep"><code class="csfmt">\glsxtrmultientryadjustednamepostsep</code></a><code class="code">{<span class="meta">〈<em class="metainner">pre-label</em>〉</span>}{<span class="meta">〈<em class="metainner">post-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20927"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Separator used by <a id="wrglossary.20928"></a><a href="#glo:glsxtrmultientryadjustedname"><code class="csfmt">\glsxtrmultientryadjustedname</code></a> between the main element and the first element of the second sublist. <a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9377">373</a><p>
+<div class="defnbox"><a id="wrglossary.20929"></a><a href="#glo:glsxtrmultientryadjustednamepresep"><code class="csfmt">\glsxtrmultientryadjustednamepresep</code></a><code class="code">{<span class="meta">〈<em class="metainner">pre-label</em>〉</span>}{<span class="meta">〈<em class="metainner">post-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20930"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Separator used by <a id="wrglossary.20931"></a><a href="#glo:glsxtrmultientryadjustedname"><code class="csfmt">\glsxtrmultientryadjustedname</code></a> between the last element of the first sublist and the main element. <a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9376">373</a><p>
+<div class="defnbox"><a id="wrglossary.20932"></a><a href="#glo:glsxtrmultientryadjustednamesep"><code class="csfmt">\glsxtrmultientryadjustednamesep</code></a><code class="code">{<span class="meta">〈<em class="metainner">pre-label</em>〉</span>}{<span class="meta">〈<em class="metainner">post-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20933"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Separator used by <a id="wrglossary.20934"></a><a href="#glo:glsxtrmultientryadjustedname"><code class="csfmt">\glsxtrmultientryadjustedname</code></a>. <a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9374">373</a><p>
+<div class="defnbox"><a id="wrglossary.20935"></a><a href="#glo:glsxtrmultilastotherindex"><code class="csfmt">\glsxtrmultilastotherindex</code></a><code class="code">{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20936"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the index of the final non-main element in the given multi-entry or nothing if <span class="meta">〈<em class="metainner">multi-label</em>〉</span> hasn’t been defined. <a href="#sec:multiextras">§7.13</a>; <a href="#wrglossary.9336">371</a><p>
+<div class="defnbox"><a id="wrglossary.20937"></a><a href="#glo:glsxtrmultilist"><code class="csfmt">\glsxtrmultilist</code></a><code class="code">{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20938"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the list of element labels for the multi-entry identified by <span class="meta">〈<em class="metainner">multi-label</em>〉</span> or nothing if not defined. <a href="#sec:multiextras">§7.13</a>; <a href="#wrglossary.9328">370</a><p>
+<div class="defnbox"><a id="wrglossary.20939"></a><a href="#glo:glsxtrmultimain"><code class="csfmt">\glsxtrmultimain</code></a><code class="code">{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20940"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the main label for the multi-entry identified by <span class="meta">〈<em class="metainner">multi-label</em>〉</span> or nothing if not defined. <a href="#sec:multiextras">§7.13</a>; <a href="#wrglossary.9327">370</a><p>
+<div class="defnbox"><a id="wrglossary.20941"></a><a href="#glo:glsxtrmultimainindex"><code class="csfmt">\glsxtrmultimainindex</code></a><code class="code">{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20942"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the index of the main element in the given multi-entry or nothing if <span class="meta">〈<em class="metainner">multi-label</em>〉</span> hasn’t been defined. <a href="#sec:multiextras">§7.13</a>; <a href="#wrglossary.9335">371</a><p>
+<div class="defnbox"><a id="wrglossary.20943"></a><a href="#glo:glsxtrmultisupplocation"><code class="csfmt">\glsxtrmultisupplocation</code></a><code class="code">{<span class="meta">〈<em class="metainner">src</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}{<span class="meta">〈<em class="metainner">format</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.20944"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.36+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.20945"></a><a href="#glo:glsxtrdisplaysupploc"><code class="csfmt">\glsxtrdisplaysupploc</code></a> to format the location. <a href="#sec:supplocations">§11.5.5</a>; <a href="#wrglossary.13518">555</a><p>
+<div class="defnbox"><a id="wrglossary.20946"></a><a href="#glo:glsxtrmultitotalelements"><code class="csfmt">\glsxtrmultitotalelements</code></a><code class="code">{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20947"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the total number of elements in the given multi-entry or nothing if <span class="meta">〈<em class="metainner">multi-label</em>〉</span> hasn’t been defined. <a href="#sec:multiextras">§7.13</a>; <a href="#wrglossary.9334">371</a><p>
+<div class="defnbox"><a id="wrglossary.20948"></a><a href="#glo:glsxtrnameloclink"><code class="csfmt">\glsxtrnameloclink</code></a><code class="code">{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">file</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20949"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Create an external <a id="wrglossary.20950"></a><a href="#glo:@@glslabel@entrylocation">location</a> hyperlink using the prefix and counter. <a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13645">560</a><p>
+<div class="defnbox"><a id="wrglossary.20951"></a><dfn id="glo:glsxtrnamereflink"><code class="csfmt">\glsxtrnamereflink</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">title</em>〉</span>}{<span class="meta">〈<em class="metainner">target</em>〉</span>}{<span class="meta">〈<em class="metainner">file</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20952"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.20953"></a><a href="#glo:glsxtrdisplaylocnameref"><code class="csfmt">\glsxtrdisplaylocnameref</code></a> to create a <a id="wrglossary.20954"></a><a href="#glo:@@glslabel@entrylocation">location</a> hyperlink.<p>
+<div class="defnbox"><a id="wrglossary.20955"></a><a href="#glo:glsxtrnewabbrevpresetkeyhook"><code class="csfmt">\glsxtrnewabbrevpresetkeyhook</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">short</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Hook provided to adjust initialisation within <a id="wrglossary.20956"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>. <a href="#sec:abbrvgeneralhooks">§4.1.5</a>; <a href="#wrglossary.1366">45</a><p>
+<div class="defnbox"><a id="wrglossary.20957"></a><a href="#glo:glsxtrnewgls"><code class="csfmt">\glsxtrnewgls</code></a><code class="code">[<span class="meta">〈<em class="metainner">default-options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20958"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines the command <span class="meta">〈<em class="metainner">cs</em>〉</span>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>} to behave like <code class="code"><a id="wrglossary.20959"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<span class="meta">〈<em class="metainner">default-options</em>〉</span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span><span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>. <a href="#sec:labelprefixes">§5.7</a>; <a href="#wrglossary.6596">257</a><p>
+<div class="defnbox"><a id="wrglossary.20960"></a><a href="#glo:glsxtrnewglsdisp"><code class="csfmt">\glsxtrnewglsdisp</code></a><code class="code">[<span class="meta">〈<em class="metainner">default-options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20961"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines the command <code class="code"><span class="meta">〈<em class="metainner">cs</em>〉</span>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code> to behave like <code class="code"><a id="wrglossary.20962"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a>[<span class="meta">〈<em class="metainner">default-options</em>〉</span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span><span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code>. <a href="#sec:labelprefixes">§5.7</a>; <a href="#wrglossary.6618">258</a><p>
+<div class="defnbox"><a id="wrglossary.20963"></a><a href="#glo:glsxtrnewGLSlike"><code class="csfmt">\glsxtrnewGLSlike</code></a><code class="code">[<span class="meta">〈<em class="metainner">default-options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.20964"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a>-like cs</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.20965"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a>-like cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20966"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.20967"></a><a href="#glo:glsxtrnewgls"><code class="csfmt">\glsxtrnewgls</code></a> but provides <a id="wrglossary.20968"></a><a href="#glo:idx.allcaps">all caps</a> commands. <a href="#sec:labelprefixes">§5.7</a>; <a href="#wrglossary.6611">257</a><p>
+<div class="defnbox"><a id="wrglossary.20969"></a><a href="#glo:glsxtrnewglslike"><code class="csfmt">\glsxtrnewglslike</code></a><code class="code">[<span class="meta">〈<em class="metainner">default-options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.20970"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>-like cs</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.20971"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>-like cs</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.20972"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>-like cs</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.20973"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a>-like cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20974"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.20975"></a><a href="#glo:glsxtrnewgls"><code class="csfmt">\glsxtrnewgls</code></a> but provides plural and <a id="wrglossary.20976"></a><a href="#glo:idx.sentencecase">sentence case</a> commands as well. <a href="#sec:labelprefixes">§5.7</a>; <a href="#wrglossary.6603">257</a><p>
+<div class="defnbox"><a id="wrglossary.20977"></a><a href="#glo:glsxtrnewglslink"><code class="csfmt">\glsxtrnewglslink</code></a><code class="code">[<span class="meta">〈<em class="metainner">default-options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20978"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines the command <code class="code"><span class="meta">〈<em class="metainner">cs</em>〉</span>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code> to behave like <code class="code"><a id="wrglossary.20979"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a>[<span class="meta">〈<em class="metainner">default-options</em>〉</span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span><span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code>. <a href="#sec:labelprefixes">§5.7</a>; <a href="#wrglossary.6616">258</a><p>
+<div class="defnbox"><a id="wrglossary.20980"></a><a href="#glo:glsxtrnewnumber"><code class="csfmt">\glsxtrnewnumber</code></a><code class="code">[<span class="meta">〈<em class="metainner">key=value list</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">num</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <code class="code"><code class="csfmt">\usepackage</code>[<a id="wrglossary.20981"></a><a href="#glo:opt.numbers"><span class="styoptfmt">numbers</span></a>]{glossaries-extra}</code>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Defines a new <a id="wrglossary.20982"></a><a href="#glo:dual.glossary">glossary</a> entry with the given label, <a id="wrglossary.20983"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> set to <code class="code">numbers</code>, the <a id="wrglossary.20984"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> set to <code class="code">number</code>, the <a id="wrglossary.20985"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> set to <span class="meta">〈<em class="metainner">num</em>〉</span> and the <a id="wrglossary.20986"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> set to <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The optional argument is a comma-separated list of <a id="wrglossary.20987"></a><a href="#glo:idx.gloskey">glossary entry keys</a>, which can be used to override the defaults. <a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.210">11</a><p>
+<div class="defnbox"><a id="wrglossary.20988"></a><a href="#glo:glsxtrnewrgls"><code class="csfmt">\glsxtrnewrgls</code></a><code class="code">[<span class="meta">〈<em class="metainner">default-options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20989"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.20990"></a><a href="#glo:glsxtrnewgls"><code class="csfmt">\glsxtrnewgls</code></a> but uses <a id="wrglossary.20991"></a><a href="#glo:rgls"><code class="csfmt">\rgls</code></a>. <a href="#sec:labelprefixes">§5.7</a>; <a href="#wrglossary.6631">258</a><p>
+<div class="defnbox"><a id="wrglossary.20992"></a><a href="#glo:glsxtrnewrGLSlike"><code class="csfmt">\glsxtrnewrGLSlike</code></a><code class="code">[<span class="meta">〈<em class="metainner">default-options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.20993"></a><a href="#glo:rGLS"><code class="csfmt">\rGLS</code></a>-like cs</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.20994"></a><a href="#glo:rGLSpl"><code class="csfmt">\rGLSpl</code></a>-like cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.20995"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.20996"></a><a href="#glo:glsxtrnewrgls"><code class="csfmt">\glsxtrnewrgls</code></a> but provides <a id="wrglossary.20997"></a><a href="#glo:idx.allcaps">all caps</a> commands. <a href="#sec:labelprefixes">§5.7</a>; <a href="#wrglossary.6642">259</a><p>
+<div class="defnbox"><a id="wrglossary.20998"></a><a href="#glo:glsxtrnewrglslike"><code class="csfmt">\glsxtrnewrglslike</code></a><code class="code">[<span class="meta">〈<em class="metainner">default-options</em>〉</span>]{<span class="meta">〈<em class="metainner">prefix</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.20999"></a><a href="#glo:rgls"><code class="csfmt">\rgls</code></a>-like cs</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.21000"></a><a href="#glo:rglspl"><code class="csfmt">\rglspl</code></a>-like cs</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.21001"></a><a href="#glo:rGls"><code class="csfmt">\rGls</code></a>-like cs</em>〉</span>}{<span class="meta">〈<em class="metainner"><a id="wrglossary.21002"></a><a href="#glo:rGlspl"><code class="csfmt">\rGlspl</code></a>-like cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21003"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.21004"></a><a href="#glo:glsxtrnewrgls"><code class="csfmt">\glsxtrnewrgls</code></a> but provides plural and <a id="wrglossary.21005"></a><a href="#glo:idx.sentencecase">sentence case</a> commands as well. <a href="#sec:labelprefixes">§5.7</a>; <a href="#wrglossary.6636">258</a><p>
+<div class="defnbox"><a id="wrglossary.21006"></a><a href="#glo:glsxtrnewsymbol"><code class="csfmt">\glsxtrnewsymbol</code></a><code class="code">[<span class="meta">〈<em class="metainner">key=value list</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">sym</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <code class="code"><code class="csfmt">\usepackage</code>[<a id="wrglossary.21007"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a>]{glossaries-extra}</code>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Defines a new <a id="wrglossary.21008"></a><a href="#glo:dual.glossary">glossary</a> entry with the given label, <a id="wrglossary.21009"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> set to <code class="code">symbols</code>, the <a id="wrglossary.21010"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> set to <code class="code">symbol</code>, the <a id="wrglossary.21011"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> set to <span class="meta">〈<em class="metainner">sym</em>〉</span> and the <a id="wrglossary.21012"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> set to <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The optional argument is a comma-separated list of <a id="wrglossary.21013"></a><a href="#glo:idx.gloskey">glossary entry keys</a>, which can be used to override the defaults. <a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.192">10</a><p>
+<div class="defnbox"><a id="wrglossary.21014"></a><dfn id="glo:glsxtrNoGlossaryWarning"><code class="csfmt">\glsxtrNoGlossaryWarning</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">glossary-type</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Issues a warning with <a id="wrglossary.21015"></a><a href="#glo:GlossariesExtraWarning"><code class="csfmt">\GlossariesExtraWarning</code></a> indicating that the given glossary is missing.<p>
+<div class="defnbox"><a id="wrglossary.21016"></a><a href="#glo:GlsXtrNoGlsWarningAutoMake"><code class="csfmt">\GlsXtrNoGlsWarningAutoMake</code></a><code class="code">{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Advisory message when <a id="wrglossary.21017"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a> has been used. <a href="#sec:lang">§15</a>; <a href="#wrglossary.14295">596</a><p>
+<div class="defnbox"><a id="wrglossary.21018"></a><a href="#glo:GlsXtrNoGlsWarningBuildInfo"><code class="csfmt">\GlsXtrNoGlsWarningBuildInfo</code></a></div><!-- end of defnbox -->
+<p>
+Build advice. <a href="#sec:lang">§15</a>; <a href="#wrglossary.14294">595</a><p>
+<div class="defnbox"><a id="wrglossary.21019"></a><a href="#glo:GlsXtrNoGlsWarningCheckFile"><code class="csfmt">\GlsXtrNoGlsWarningCheckFile</code></a><code class="code">{<span class="meta">〈<em class="metainner">file</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Advisory message to check the file contents. <a href="#sec:lang">§15</a>; <a href="#wrglossary.14290">595</a><p>
+<div class="defnbox"><a id="wrglossary.21020"></a><a href="#glo:GlsXtrNoGlsWarningEmptyMain"><code class="csfmt">\GlsXtrNoGlsWarningEmptyMain</code></a></div><!-- end of defnbox -->
+<p>
+Produces the boilerplate text if the probably empty glossary is the <code class="code">main</code> one. <a href="#sec:lang">§15</a>; <a href="#wrglossary.14288">594</a><p>
+<div class="defnbox"><a id="wrglossary.21021"></a><a href="#glo:GlsXtrNoGlsWarningEmptyNotMain"><code class="csfmt">\GlsXtrNoGlsWarningEmptyNotMain</code></a><code class="code">{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Produces the boilerplate text if the probably empty glossary is not the <code class="code">main</code> one. <a href="#sec:lang">§15</a>; <a href="#wrglossary.14289">594</a><p>
+<div class="defnbox"><a id="wrglossary.21022"></a><a href="#glo:GlsXtrNoGlsWarningEmptyStart"><code class="csfmt">\GlsXtrNoGlsWarningEmptyStart</code></a></div><!-- end of defnbox -->
+<p>
+Produces the boilerplate text if a glossary is probably empty. <a href="#sec:lang">§15</a>; <a href="#wrglossary.14287">594</a><p>
+<div class="defnbox"><a id="wrglossary.21023"></a><a href="#glo:GlsXtrNoGlsWarningHead"><code class="csfmt">\GlsXtrNoGlsWarningHead</code></a><code class="code">{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}{<span class="meta">〈<em class="metainner">file</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Produces the header boilerplate text if a glossary file is missing. <a href="#sec:lang">§15</a>; <a href="#wrglossary.14286">594</a><p>
+<div class="defnbox"><a id="wrglossary.21024"></a><a href="#glo:GlsXtrNoGlsWarningMisMatch"><code class="csfmt">\GlsXtrNoGlsWarningMisMatch</code></a></div><!-- end of defnbox -->
+<p>
+Advisory message on mis-matching <a id="wrglossary.21025"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a>. <a href="#sec:lang">§15</a>; <a href="#wrglossary.14291">595</a><p>
+<div class="defnbox"><a id="wrglossary.21026"></a><a href="#glo:GlsXtrNoGlsWarningNoOut"><code class="csfmt">\GlsXtrNoGlsWarningNoOut</code></a><code class="code">{<span class="meta">〈<em class="metainner">file</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Advisory if no output file was created. <a href="#sec:lang">§15</a>; <a href="#wrglossary.14292">595</a><p>
+<div class="defnbox"><a id="wrglossary.21027"></a><a href="#glo:GlsXtrNoGlsWarningTail"><code class="csfmt">\GlsXtrNoGlsWarningTail</code></a></div><!-- end of defnbox -->
+<p>
+Final paragraph of missing glossary boilerplate text. <a href="#sec:lang">§15</a>; <a href="#wrglossary.14293">595</a><p>
+<div class="defnbox"><a id="wrglossary.21028"></a><a href="#glo:glsxtrnoidxgroups"><code class="csfmt">\glsxtrnoidxgroups</code></a><span class="floatrightbox"><a id="wrglossary.21029"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Makes the group titling mechanism used with the <a id="wrglossary.21030"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> use the same method as for <a id="wrglossary.21031"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a> (<a id="wrglossary.21032"></a><a href="#glo:dual.ascii">ASCII</a> only). This command can’t be used with <a id="wrglossary.21033"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> or with <a id="wrglossary.21034"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>. <a href="#sec:printunsrt">§8.4</a>; <a href="#wrglossary.9706">385</a><p>
+<div class="defnbox"><a id="wrglossary.21035"></a><a href="#glo:glsxtrnonprintablerules"><code class="csfmt">\glsxtrnonprintablerules</code></a><span class="floatrightbox"><a id="wrglossary.21036"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to non-printable character sort rules. <a href="#wrglossary.13258">542</a><p>
+<div class="defnbox"><a id="wrglossary.21037"></a><a href="#glo:glsxtrnopostpunc"><code class="csfmt">\glsxtrnopostpunc</code></a><span class="floatrightbox"><a id="wrglossary.21038"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.22+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+When placed at the end of the <a id="wrglossary.21039"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a>, this switches off the post-description punctuation (inserted automatically via options such as <a id="wrglossary.21040"></a><a href="#glo:opt.postdot"><span class="styoptfmt">postdot</span></a>) but doesn’t suppress the <a id="wrglossary.21041"></a><a href="#glo:dual.postdeschook">post-description hook</a>. Does nothing outside of the <a id="wrglossary.21042"></a><a href="#glo:dual.glossary">glossary</a>. <a href="#sec:postdeschooks">§8.6.2</a>; <a href="#wrglossary.10753">422</a><p>
+<div class="defnbox"><a id="wrglossary.21043"></a><a href="#glo:glsxtronlydescname"><code class="csfmt">\glsxtronlydescname</code></a><span class="floatrightbox"><a id="wrglossary.21044"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the name value for styles like <a id="wrglossary.21045"></a><a href="#glo:opt.abbrstyle.long-only-short-only-desc"><span class="abbrstylefmt">long-only-short-only-desc</span></a>. <a href="#wrglossary.3872">155</a><p>
+<div class="defnbox"><a id="wrglossary.21046"></a><a href="#glo:glsxtronlydescsort"><code class="csfmt">\glsxtronlydescsort</code></a><span class="floatrightbox"><a id="wrglossary.21047"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the name value for styles like <a id="wrglossary.21048"></a><a href="#glo:opt.abbrstyle.long-only-short-only-desc"><span class="abbrstylefmt">long-only-short-only-desc</span></a>. <a href="#wrglossary.3877">155</a><p>
+<div class="defnbox"><a id="wrglossary.21049"></a><a href="#glo:glsxtronlyname"><code class="csfmt">\glsxtronlyname</code></a><span class="floatrightbox"><a id="wrglossary.21050"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.25+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the name value for styles like <a id="wrglossary.21051"></a><a href="#glo:opt.abbrstyle.long-only-short-only"><span class="abbrstylefmt">long-only-short-only</span></a>. <a href="#wrglossary.3868">155</a><p>
+<div class="defnbox"><a id="wrglossary.21052"></a><a href="#glo:glsxtronlysuffix"><code class="csfmt">\glsxtronlysuffix</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a>; <a id="wrglossary.21053"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The plural suffix used by the <span class="qt">“only”</span> <a id="wrglossary.21054"></a><a href="#glo:idx.abbrvstyle">abbreviation styles</a> (such as <a id="wrglossary.21055"></a><a href="#glo:opt.abbrstyle.long-only-short-only"><span class="abbrstylefmt">long-only-short-only</span></a>). <a href="#wrglossary.3854">154</a><p>
+<div class="defnbox"><a id="wrglossary.21056"></a><a href="#glo:glsxtrorgkeylist"><code class="csfmt">\glsxtrorgkeylist</code></a><span class="floatrightbox"><a id="wrglossary.21057"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the original option list as it was supplied to <a id="wrglossary.21058"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>. <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4070">163</a><p>
+<div class="defnbox"><a id="wrglossary.21059"></a><a href="#glo:glsxtrorgshort"><code class="csfmt">\glsxtrorgshort</code></a><span class="floatrightbox"><a id="wrglossary.21060"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the original short form as it was supplied to <a id="wrglossary.21061"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>. <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4077">164</a><p>
+<div class="defnbox"><a id="wrglossary.21062"></a><a href="#glo:glsxtrorglong"><code class="csfmt">\glsxtrorglong</code></a><span class="floatrightbox"><a id="wrglossary.21063"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the original long form as it was supplied to <a id="wrglossary.21064"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>. <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4085">164</a><p>
+<div class="defnbox"><a id="wrglossary.21065"></a><a href="#glo:GLSxtrp"><code class="csfmt">\GLSxtrp</code></a><code class="code">{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21066"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.07+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21067"></a><a href="#glo:glsxtrp"><code class="csfmt">\glsxtrp</code></a> but converts to uppercase (but not in the PDF bookmark). <a href="#sec:nested">§5.4</a>; <a href="#wrglossary.5944">232</a><p>
+<div class="defnbox"><a id="wrglossary.21068"></a><a href="#glo:Glsxtrp"><code class="csfmt">\Glsxtrp</code></a><code class="code">{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21069"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.07+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21070"></a><a href="#glo:glsxtrp"><code class="csfmt">\glsxtrp</code></a> but converts the first letter to uppercase (but not in the PDF bookmark). <a href="#sec:nested">§5.4</a>; <a href="#wrglossary.5942">232</a><p>
+<div class="defnbox"><a id="wrglossary.21071"></a><a href="#glo:glsxtrp"><code class="csfmt">\glsxtrp</code></a><code class="code">{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21072"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.07+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use in headings and captions (instead of the <a id="wrglossary.21073"></a><a href="#glo:glslike"><code class="csfmt">\gls</code>-like</a> or <a id="wrglossary.21074"></a><a href="#glo:glstextlike"><code class="csfmt">\glstext</code>-like</a> commands). This command is designed to expand to the field value if used in a PDF bookmark and can also expand to a more appropriate command if it ends up in the page header. Note that there’s no option argument. Options should be set beforehand using <a id="wrglossary.21075"></a><a href="#glo:glsxtrsetpopts"><code class="csfmt">\glsxtrsetpopts</code></a>, which is done automatically in the glossary with <a id="wrglossary.21076"></a><a href="#glo:glossxtrsetpopts"><code class="csfmt">\glossxtrsetpopts</code></a>. <a href="#sec:nested">§5.4</a>; <a href="#wrglossary.5924">231</a><p>
+<div class="defnbox"><a id="wrglossary.21077"></a><a href="#glo:glsxtrpageref"><code class="csfmt">\glsxtrpageref</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21078"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.11+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21079"></a><a href="#glo:glsrefentry"><code class="csfmt">\glsrefentry</code></a> but uses <a id="wrglossary.21080"></a><a href="#glo:pageref"><code class="csfmt">\pageref</code></a> instead of <a id="wrglossary.21081"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>. As with <a id="wrglossary.21082"></a><a href="#glo:glsrefentry"><code class="csfmt">\glsrefentry</code></a>, this will use <a id="wrglossary.21083"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> instead if the corresponding entry counter is disabled. <a href="#sec:glspageref">§8.1</a>; <a href="#wrglossary.9495">377</a><p>
+<div class="defnbox"><a id="wrglossary.21084"></a><a href="#glo:glsxtrparen"><code class="csfmt">\glsxtrparen</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21085"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to encapsulate <span class="meta">〈<em class="metainner">text</em>〉</span> in parentheses. <a href="#wrglossary.3257">132</a><p>
+<div class="defnbox"><a id="wrglossary.21086"></a><a href="#glo:Glsxtrpdfentryfmt"><code class="csfmt">\Glsxtrpdfentryfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21087"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <code class="code"><a id="wrglossary.21088"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code>. <a href="#sec:glsxtrfmt">§5.12.2</a>; <a href="#wrglossary.7748">299</a><p>
+<div class="defnbox"><a id="wrglossary.21089"></a><a href="#glo:glsxtrpdfentryfmt"><code class="csfmt">\glsxtrpdfentryfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21090"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Just does <span class="meta">〈<em class="metainner">text</em>〉</span>. <a href="#sec:glsxtrfmt">§5.12.2</a>; <a href="#wrglossary.7703">296</a><p>
+<div class="defnbox"><a id="wrglossary.21091"></a><a href="#glo:Glsxtrpl"><code class="csfmt">\Glsxtrpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">gls-options</em>〉</span>][<span class="meta">〈<em class="metainner">dfn-options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21092"></a><a href="#glo:glsxtrpl"><code class="csfmt">\glsxtrpl</code></a> but applies <a id="wrglossary.21093"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#sec:onthefly">§13</a>; <a href="#wrglossary.14134">579</a><p>
+<div class="defnbox"><a id="wrglossary.21094"></a><a href="#glo:glsxtrpl"><code class="csfmt">\glsxtrpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">gls-options</em>〉</span>][<span class="meta">〈<em class="metainner">dfn-options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21095"></a><a href="#glo:glsxtr"><code class="csfmt">\glsxtr</code></a> but shows the plural form. <a href="#sec:onthefly">§13</a>; <a href="#wrglossary.14126">579</a><p>
+<div class="defnbox"><a id="wrglossary.21096"></a><a href="#glo:glsxtrpostabbrvfootnote"><code class="csfmt">\glsxtrpostabbrvfootnote</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-code</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21097"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Command used in the <a id="wrglossary.21098"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for styles like <a id="wrglossary.21099"></a><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></a>. <a href="#sec:advancedabbrstylecmds">§4.5.2</a>; <a href="#wrglossary.3975">160</a><p>
+<div class="defnbox"><a id="wrglossary.21100"></a><a href="#glo:glsxtrpostdescabbreviation"><code class="csfmt">\glsxtrpostdescabbreviation</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">empty</em></span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The default post-description hook for the <a id="wrglossary.21101"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a> category. <a href="#sec:postdeschooks">§8.6.2</a>; <a href="#wrglossary.10740">422</a><p>
+<div class="defnbox"><a id="wrglossary.21102"></a><a href="#glo:glsxtrpostdescacronym"><code class="csfmt">\glsxtrpostdescacronym</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">empty</em></span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The default post-description hook for the <a id="wrglossary.21103"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a> category. <a href="#sec:postdeschooks">§8.6.2</a>; <a href="#wrglossary.10737">422</a><p>
+<div class="defnbox"><a id="wrglossary.21104"></a><a href="#glo:glsxtrpostdesccategory"><code class="csfmt">\glsxtrpostdesc<span class="meta">〈<em class="metainner">category</em>〉</span></code></a><span class="floatrightbox"><a id="wrglossary.21105"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.21106"></a><a href="#glo:postdeschook">post-description hook</a> associated with the category identified by the label <span class="meta">〈<em class="metainner">category</em>〉</span>. <a href="#sec:postdeschooks">§8.6.2</a>; <a href="#wrglossary.10729">421</a><p>
+<div class="defnbox"><a id="wrglossary.21107"></a><a href="#glo:glsxtrpostdescgeneral"><code class="csfmt">\glsxtrpostdescgeneral</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">empty</em></span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The default post-description hook for the <a id="wrglossary.21108"></a><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a> category. <a href="#sec:postdeschooks">§8.6.2</a>; <a href="#wrglossary.10731">422</a><p>
+<div class="defnbox"><a id="wrglossary.21109"></a><a href="#glo:glsxtrpostdescindex"><code class="csfmt">\glsxtrpostdescindex</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">empty</em></span></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <code class="code"><code class="csfmt">\usepackage</code>[<a id="wrglossary.21110"></a><a href="#glo:opt.index"><span class="styoptfmt">index</span></a>]{glossaries-extra}</code>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+The default post-description hook for the <a id="wrglossary.21111"></a><a href="#glo:opt.cat.index"><span class="csoptfmt">index</span></a> category. <a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.258">12</a><p>
+<div class="defnbox"><a id="wrglossary.21112"></a><a href="#glo:glsxtrpostdescnumber"><code class="csfmt">\glsxtrpostdescnumber</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">empty</em></span></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <code class="code"><code class="csfmt">\usepackage</code>[<a id="wrglossary.21113"></a><a href="#glo:opt.numbers"><span class="styoptfmt">numbers</span></a>]{glossaries-extra}</code>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+The default post-description hook for the <a id="wrglossary.21114"></a><a href="#glo:opt.cat.number"><span class="csoptfmt">number</span></a> category. <a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.221">11</a><p>
+<div class="defnbox"><a id="wrglossary.21115"></a><a href="#glo:glsxtrpostdescription"><code class="csfmt">\glsxtrpostdescription</code></a></div><!-- end of defnbox -->
+<p>
+An additional hook used within <a id="wrglossary.21116"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a> that implements the <a id="wrglossary.21117"></a><a href="#glo:dual.catpostdeschook">category post-description hook</a>. <a href="#sec:postdeschooks">§8.6.2</a>; <a href="#wrglossary.10717">421</a><p>
+<div class="defnbox"><a id="wrglossary.21118"></a><a href="#glo:glsxtrpostdescsymbol"><code class="csfmt">\glsxtrpostdescsymbol</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">empty</em></span></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <code class="code"><code class="csfmt">\usepackage</code>[<a id="wrglossary.21119"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a>]{glossaries-extra}</code>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+The default <a id="wrglossary.21120"></a><a href="#glo:postdeschook">post-description hook</a> for the <a id="wrglossary.21121"></a><a href="#glo:opt.cat.symbol"><span class="csoptfmt">symbol</span></a> category. <a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.203">10</a><p>
+<div class="defnbox"><a id="wrglossary.21122"></a><a href="#glo:glsxtrpostdescterm"><code class="csfmt">\glsxtrpostdescterm</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">empty</em></span></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The default post-description hook for the <span class="csoptfmt">term</span> category (which isn’t used by <a id="wrglossary.21123"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>). <a href="#sec:postdeschooks">§8.6.2</a>; <a href="#wrglossary.10734">422</a><p>
+<div class="defnbox"><a id="wrglossary.21124"></a><a href="#glo:glsxtrpostfootnotelongformat"><code class="csfmt">\glsxtrpostfootnotelongformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21125"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used in the footnote text to format the long form for styles like <a id="wrglossary.21126"></a><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></a>. <a href="#wrglossary.3623">146</a><p>
+<div class="defnbox"><a id="wrglossary.21127"></a><a href="#glo:GLSxtrposthyphenlong"><code class="csfmt">\GLSxtrposthyphenlong</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21128"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21129"></a><a href="#glo:glsxtrposthyphenlong"><code class="csfmt">\glsxtrposthyphenlong</code></a> but <a id="wrglossary.21130"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.3837">153</a><p>
+<div class="defnbox"><a id="wrglossary.21131"></a><a href="#glo:glsxtrposthyphenlong"><code class="csfmt">\glsxtrposthyphenlong</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21132"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used within the <a id="wrglossary.21133"></a><a href="#glo:dual.postlinkhook">post-link hook</a> to format the long form according to the <a id="wrglossary.21134"></a><a href="#glo:opt.abbrstyle.short-hyphen-postlong-hyphen"><span class="abbrstylefmt">short-hyphen-postlong-hyphen</span></a> style on <a id="wrglossary.21135"></a><a href="#glo:dual.firstuse">first use</a>. <a href="#wrglossary.3832">153</a><p>
+<div class="defnbox"><a id="wrglossary.21136"></a><a href="#glo:GLSxtrposthyphenlongpl"><code class="csfmt">\GLSxtrposthyphenlongpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21137"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21138"></a><a href="#glo:glsxtrposthyphenlongpl"><code class="csfmt">\glsxtrposthyphenlongpl</code></a> but <a id="wrglossary.21139"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.3841">154</a><p>
+<div class="defnbox"><a id="wrglossary.21140"></a><a href="#glo:glsxtrposthyphenlongpl"><code class="csfmt">\glsxtrposthyphenlongpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21141"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21142"></a><a href="#glo:glsxtrposthyphenlong"><code class="csfmt">\glsxtrposthyphenlong</code></a> but shows the plural. <a href="#wrglossary.3839">153</a><p>
+<div class="defnbox"><a id="wrglossary.21143"></a><a href="#glo:GLSxtrposthyphenshort"><code class="csfmt">\GLSxtrposthyphenshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21144"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21145"></a><a href="#glo:glsxtrposthyphenshort"><code class="csfmt">\glsxtrposthyphenshort</code></a> but <a id="wrglossary.21146"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.3760">151</a><p>
+<div class="defnbox"><a id="wrglossary.21147"></a><a href="#glo:glsxtrposthyphenshort"><code class="csfmt">\glsxtrposthyphenshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21148"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used within the <a id="wrglossary.21149"></a><a href="#glo:dual.postlinkhook">post-link hook</a> to format the short form according to the <a id="wrglossary.21150"></a><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen"><span class="abbrstylefmt">long-hyphen-postshort-hyphen</span></a> style on <a id="wrglossary.21151"></a><a href="#glo:dual.firstuse">first use</a>. <a href="#wrglossary.3752">151</a><p>
+<div class="defnbox"><a id="wrglossary.21152"></a><a href="#glo:GLSxtrposthyphenshortpl"><code class="csfmt">\GLSxtrposthyphenshortpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21153"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21154"></a><a href="#glo:glsxtrposthyphenshortpl"><code class="csfmt">\glsxtrposthyphenshortpl</code></a> but <a id="wrglossary.21155"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.3764">151</a><p>
+<div class="defnbox"><a id="wrglossary.21156"></a><a href="#glo:glsxtrposthyphenshortpl"><code class="csfmt">\glsxtrposthyphenshortpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21157"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21158"></a><a href="#glo:glsxtrposthyphenshort"><code class="csfmt">\glsxtrposthyphenshort</code></a> but plural. <a href="#wrglossary.3762">151</a><p>
+<div class="defnbox"><a id="wrglossary.21159"></a><a href="#glo:GLSxtrposthyphensubsequent"><code class="csfmt">\GLSxtrposthyphensubsequent</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21160"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21161"></a><a href="#glo:glsxtrposthyphensubsequent"><code class="csfmt">\glsxtrposthyphensubsequent</code></a> but <a id="wrglossary.21162"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.3779">152</a><p>
+<div class="defnbox"><a id="wrglossary.21163"></a><a href="#glo:glsxtrposthyphensubsequent"><code class="csfmt">\glsxtrposthyphensubsequent</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21164"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used within the <a id="wrglossary.21165"></a><a href="#glo:dual.postlinkhook">post-link hook</a> to format the insert according to the <a id="wrglossary.21166"></a><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen"><span class="abbrstylefmt">long-hyphen-postshort-hyphen</span></a> style on <a id="wrglossary.21167"></a><a href="#glo:dual.subsequentuse">subsequent use</a>. <a href="#wrglossary.3775">152</a><p>
+<div class="defnbox"><a id="wrglossary.21168"></a><a href="#glo:glsxtrpostlink"><code class="csfmt">\glsxtrpostlink</code></a></div><!-- end of defnbox -->
+<p>
+A <a id="wrglossary.21169"></a><a href="#glo:dual.postlinkhook">post-link hook</a> that does <a id="wrglossary.21170"></a><a href="#glo:glsxtrpostlinkcat"><code class="csfmt">\glsxtrpostlink<span class="meta">〈<em class="metainner">category</em>〉</span></code></a> if that command has been defined, where the category label is obtained from the entry that has just been referenced with a <a id="wrglossary.21171"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> or <a id="wrglossary.21172"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> command (using <a id="wrglossary.21173"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>). Does nothing if <a id="wrglossary.21174"></a><a href="#glo:glsxtrpostlinkcat"><code class="csfmt">\glsxtrpostlink<span class="meta">〈<em class="metainner">category</em>〉</span></code></a> isn’t defined. <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6371">250</a><p>
+<div class="defnbox"><a id="wrglossary.21175"></a><a href="#glo:glsxtrpostlinkAddDescOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddDescOnFirstUse</code></a></div><!-- end of defnbox -->
+<p>
+May be used within a <a id="wrglossary.21176"></a><a href="#glo:dual.postlinkhook">post-link hook</a> to display the description in parentheses on <a id="wrglossary.21177"></a><a href="#glo:dual.firstuse">first use</a>. <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6390">251</a><p>
+<div class="defnbox"><a id="wrglossary.21178"></a><a href="#glo:glsxtrpostlinkAddSymbolDescOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddSymbolDescOnFirstUse</code></a><span class="floatrightbox"><a id="wrglossary.21179"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+May be used within a <a id="wrglossary.21180"></a><a href="#glo:dual.postlinkhook">post-link hook</a> to display the symbol and description in parentheses on <a id="wrglossary.21181"></a><a href="#glo:dual.firstuse">first use</a>. <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6396">251</a><p>
+<div class="defnbox"><a id="wrglossary.21182"></a><a href="#glo:glsxtrpostlinkAddSymbolOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddSymbolOnFirstUse</code></a></div><!-- end of defnbox -->
+<p>
+May be used within a <a id="wrglossary.21183"></a><a href="#glo:dual.postlinkhook">post-link hook</a> to display the symbol in parentheses on <a id="wrglossary.21184"></a><a href="#glo:dual.firstuse">first use</a>. <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6393">251</a><p>
+<div class="defnbox"><a id="wrglossary.21185"></a><dfn id="glo:glsxtrpostlinkcat"><code class="csfmt">\glsxtrpostlink<span class="meta">〈<em class="metainner">category</em>〉</span></code></dfn></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.21186"></a><a href="#glo:dual.postlinkhook">post-link hook</a> associated with the category identified by the label <span class="meta">〈<em class="metainner">category</em>〉</span>.<p>
+<div class="defnbox"><a id="wrglossary.21187"></a><a href="#glo:glsxtrpostlinkendsentence"><code class="csfmt">\glsxtrpostlinkendsentence</code></a></div><!-- end of defnbox -->
+<p>
+A <a id="wrglossary.21188"></a><a href="#glo:dual.postlinkhook">post-link hook</a> that’s used if a <a id="wrglossary.21189"></a><a href="#glo:idx.fullstop">full stop</a> is discarded in order to adjust the space factor (to denote the end of a sentence). If the <a id="wrglossary.21190"></a><a href="#glo:dual.catpostlinkhook">category post-link hook</a> exists, and will be applied and the <a id="wrglossary.21191"></a><a href="#glo:idx.fullstop">full stop</a> will be restored. <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6342">248</a><p>
+<div class="defnbox"><a id="wrglossary.21192"></a><a href="#glo:glsxtrpostlinkhook"><code class="csfmt">\glsxtrpostlinkhook</code></a></div><!-- end of defnbox -->
+<p>
+A <a id="wrglossary.21193"></a><a href="#glo:dual.postlinkhook">post-link hook</a> that checks if a following <a id="wrglossary.21194"></a><a href="#glo:idx.fullstop">full stop</a> needs to be discarded, in which case it does <a id="wrglossary.21195"></a><a href="#glo:glsxtrpostlinkendsentence"><code class="csfmt">\glsxtrpostlinkendsentence</code></a>, otherwise it does <a id="wrglossary.21196"></a><a href="#glo:glsxtrpostlink"><code class="csfmt">\glsxtrpostlink</code></a>. <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6299">246</a><p>
+<div class="defnbox"><a id="wrglossary.21197"></a><a href="#glo:glsxtrpostlinkSymbolDescSep"><code class="csfmt">\glsxtrpostlinkSymbolDescSep</code></a><span class="floatrightbox"><a id="wrglossary.21198"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.21199"></a><a href="#glo:glsxtrpostlinkAddSymbolDescOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddSymbolDescOnFirstUse</code></a> to separate the symbol and description, if both are set. <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6400">251</a><p>
+<div class="defnbox"><a id="wrglossary.21200"></a><a href="#glo:glsxtrpostlocalreset"><code class="csfmt">\glsxtrpostlocalreset</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Hook performed by <a id="wrglossary.21201"></a><a href="#glo:glslocalreset"><code class="csfmt">\glslocalreset</code></a>. This hook is modified by <a id="wrglossary.21202"></a><a href="#glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></a> and <a id="wrglossary.21203"></a><a href="#glo:glsenableentryunitcount"><code class="csfmt">\glsenableentryunitcount</code></a>. <a href="#sec:glsunset">§5.10</a>; <a href="#wrglossary.7353">280</a><p>
+<div class="defnbox"><a id="wrglossary.21204"></a><a href="#glo:glsxtrpostlocalunset"><code class="csfmt">\glsxtrpostlocalunset</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Hook performed by <a id="wrglossary.21205"></a><a href="#glo:glslocalunset"><code class="csfmt">\glslocalunset</code></a>. This hook is modified by <a id="wrglossary.21206"></a><a href="#glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></a> and <a id="wrglossary.21207"></a><a href="#glo:glsenableentryunitcount"><code class="csfmt">\glsenableentryunitcount</code></a>. <a href="#sec:glsunset">§5.10</a>; <a href="#wrglossary.7349">280</a><p>
+<div class="defnbox"><a id="wrglossary.21208"></a><a href="#glo:glsxtrpostlongdescription"><code class="csfmt">\glsxtrpostlongdescription</code></a><span class="floatrightbox"><a id="wrglossary.21209"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook added to the end of the <a id="wrglossary.21210"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> field by the unstarred version of <a id="wrglossary.21211"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>. <a href="#sec:newentrydefs">§3.1</a>; <a href="#wrglossary.939">32</a><p>
+<div class="defnbox"><a id="wrglossary.21212"></a><a href="#glo:glsxtrpostnamecategory"><code class="csfmt">\glsxtrpostname<span class="meta">〈<em class="metainner">category</em>〉</span></code></a><span class="floatrightbox"><a id="wrglossary.21213"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.21214"></a><a href="#glo:postnamehook">post-name hook</a> associated with the category identified by the label <span class="meta">〈<em class="metainner">category</em>〉</span>. <a href="#sec:postnamehooks">§8.6.1</a>; <a href="#wrglossary.10702">420</a><p>
+<div class="defnbox"><a id="wrglossary.21215"></a><a href="#glo:glsxtrpostnamehook"><code class="csfmt">\glsxtrpostnamehook</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+A hook that’s performed within <a id="wrglossary.21216"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a> and <a id="wrglossary.21217"></a><a href="#glo:glossentrynameother"><code class="csfmt">\glossentrynameother</code></a> after the entry name is displayed. This hook implements auto-indexing (see §<a href="#sec:autoindex">12</a>), then the general hook <a id="wrglossary.21218"></a><a href="#glo:glsextrapostnamehook"><code class="csfmt">\glsextrapostnamehook</code></a> and finally the <a id="wrglossary.21219"></a><a href="#glo:glsxtrpostnamecategory"><code class="csfmt">\glsxtrpostname<span class="meta">〈<em class="metainner">category</em>〉</span></code></a> hook. <a href="#sec:postnamehooks">§8.6.1</a>; <a href="#wrglossary.10695">420</a><p>
+<div class="defnbox"><a id="wrglossary.21220"></a><a href="#glo:GlsXtrPostNewAbbreviation"><code class="csfmt">\GlsXtrPostNewAbbreviation</code></a></div><!-- end of defnbox -->
+<p>
+A hook that’s performed after the entry has been defined. <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4094">165</a><p>
+<div class="defnbox"><a id="wrglossary.21221"></a><a href="#glo:glsxtrpostreset"><code class="csfmt">\glsxtrpostreset</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Hook performed by <a id="wrglossary.21222"></a><a href="#glo:glsreset"><code class="csfmt">\glsreset</code></a>. This hook is modified by <a id="wrglossary.21223"></a><a href="#glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></a> and <a id="wrglossary.21224"></a><a href="#glo:glsenableentryunitcount"><code class="csfmt">\glsenableentryunitcount</code></a>. <a href="#sec:glsunset">§5.10</a>; <a href="#wrglossary.7351">280</a><p>
+<div class="defnbox"><a id="wrglossary.21225"></a><a href="#glo:glsxtrpostunset"><code class="csfmt">\glsxtrpostunset</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Hook performed by <a id="wrglossary.21226"></a><a href="#glo:glsunset"><code class="csfmt">\glsunset</code></a>. This hook is modified by <a id="wrglossary.21227"></a><a href="#glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></a> and <a id="wrglossary.21228"></a><a href="#glo:glsenableentryunitcount"><code class="csfmt">\glsenableentryunitcount</code></a>. <a href="#sec:glsunset">§5.10</a>; <a href="#wrglossary.7347">280</a><p>
+<div class="defnbox"><a id="wrglossary.21229"></a><a href="#glo:glsxtrpostuserlongformat"><code class="csfmt">\glsxtrpostuserlongformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21230"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the long form in parentheses (with <a id="wrglossary.21231"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a>) in styles like <a id="wrglossary.21232"></a><a href="#glo:opt.abbrstyle.short-postlong-user"><span class="abbrstylefmt">short-postlong-user</span></a>. <a href="#wrglossary.3566">144</a><p>
+<div class="defnbox"><a id="wrglossary.21233"></a><a href="#glo:glsxtrpostusershortformat"><code class="csfmt">\glsxtrpostusershortformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21234"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the short form in parentheses (with <a id="wrglossary.21235"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a>) in styles like <a id="wrglossary.21236"></a><a href="#glo:opt.abbrstyle.long-postshort-user"><span class="abbrstylefmt">long-postshort-user</span></a>. <a href="#wrglossary.3522">142</a><p>
+<div class="defnbox"><a id="wrglossary.21237"></a><a href="#glo:GlsXtrPrefixLabelFallbackLastfalse"><code class="csfmt">\GlsXtrPrefixLabelFallbackLastfalse</code></a><span class="floatrightbox"><a id="wrglossary.21238"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the <a id="wrglossary.21239"></a><a href="#glo:ifGlsXtrPrefixLabelFallbackLast"><code class="csfmt">\ifGlsXtrPrefixLabelFallbackLast</code></a> conditional to false. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13745">564</a><p>
+<div class="defnbox"><a id="wrglossary.21240"></a><a href="#glo:GlsXtrPrefixLabelFallbackLasttrue"><code class="csfmt">\GlsXtrPrefixLabelFallbackLasttrue</code></a><span class="floatrightbox"><a id="wrglossary.21241"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the <a id="wrglossary.21242"></a><a href="#glo:ifGlsXtrPrefixLabelFallbackLast"><code class="csfmt">\ifGlsXtrPrefixLabelFallbackLast</code></a> conditional to true. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13744">564</a><p>
+<div class="defnbox"><a id="wrglossary.21243"></a><a href="#glo:glsxtrpreglossarystyle"><code class="csfmt">\glsxtrpreglossarystyle</code></a><span class="floatrightbox"><a id="wrglossary.21244"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook performed by <a id="wrglossary.21245"></a><a href="#glo:setglossarystyle"><code class="csfmt">\setglossarystyle</code></a> to initialise default definitions of style commands. <a href="#sec:glosstylemods">§8.6</a>; <a href="#wrglossary.10641">418</a><p>
+<div class="defnbox"><a id="wrglossary.21246"></a><a href="#glo:glsxtrprelocation"><code class="csfmt">\glsxtrprelocation</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\space</code>; <a id="wrglossary.21247"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used before the <a id="wrglossary.21248"></a><a href="#glo:dual.locationlist">location list</a> in the predefined styles provided by <a id="wrglossary.21249"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> or modified by <a id="wrglossary.21250"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a>. <a href="#sec:stylemods">§8.6.5</a>; <a href="#wrglossary.10871">427</a><p>
+<div class="defnbox"><a id="wrglossary.21251"></a><a href="#glo:glsxtrprependlabelprefix"><code class="csfmt">\glsxtrprependlabelprefix</code></a><code class="code">{<span class="meta">〈<em class="metainner">label-prefix</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21252"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Prepends <span class="meta">〈<em class="metainner">label-prefix</em>〉</span> to the list of known labels. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13739">563</a><p>
+<div class="defnbox"><a id="wrglossary.21253"></a><a href="#glo:GlsXtrPreToDefaultGlsOpts"><code class="csfmt">\GlsXtrPreToDefaultGlsOpts</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21254"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally prepend <span class="meta">〈<em class="metainner">options</em>〉</span> to the default options for the <a id="wrglossary.21255"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.21256"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands. <a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4730">187</a><p>
+<div class="defnbox"><a id="wrglossary.21257"></a><dfn id="glo:glsxtrprovideaccsuppcmd"><code class="csfmt">\glsxtrprovideaccsuppcmd</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">category</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21258"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.21259"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Defines <a id="wrglossary.21260"></a><a href="#glo:glsxtrcategoryfieldaccsupp"><code class="csfmt">\glsxtr<span class="meta">〈<em class="metainner">category</em>〉</span><span class="meta">〈<em class="metainner">field</em>〉</span>accsupp</code></a> to <a id="wrglossary.21261"></a><a href="#glo:glsshortaccsupp"><code class="csfmt">\glsshortaccsupp</code></a>, if not already defined.<p>
+<div class="defnbox"><a id="wrglossary.21262"></a><a href="#glo:GlsXtrProvideBibTeXFields"><code class="csfmt">\GlsXtrProvideBibTeXFields</code></a><span class="floatrightbox"><a id="wrglossary.21263"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.29+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Provides the standard BibTeX fields as glossary entry keys (using <a id="wrglossary.21264"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>). <a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13098">536</a><p>
+<div class="defnbox"><a id="wrglossary.21265"></a><a href="#glo:glsxtrprovidecommand"><code class="csfmt">\glsxtrprovidecommand</code></a><code class="code">{<span class="meta">〈<em class="metainner">cs</em>〉</span>}[<span class="meta">〈<em class="metainner">n</em>〉</span>][<span class="meta">〈<em class="metainner">default</em>〉</span>]{<span class="meta">〈<em class="metainner">definition</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.21266"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Just uses <a id="wrglossary.21267"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a> within the LaTeX document but is treated as <a id="wrglossary.21268"></a><a href="#glo:renewcommand"><code class="csfmt">\renewcommand</code></a> by <a id="wrglossary.21269"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span>’s</a> interpreter. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13943">572</a><p>
+<div class="defnbox"><a id="wrglossary.21270"></a><a href="#glo:glsxtrprovidestoragekey"><code class="csfmt">\glsxtrprovidestoragekey</code></a><code class="code">{<span class="meta">〈<em class="metainner">key</em>〉</span>}{<span class="meta">〈<em class="metainner">default value</em>〉</span>}{<span class="meta">〈<em class="metainner">no link cs</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.21271"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.21272"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a> but does nothing if the key has already been defined. <a href="#sec:newkeys">§3.2</a>; <a href="#wrglossary.1046">35</a><p>
+<div class="defnbox"><a id="wrglossary.21273"></a><a href="#glo:glsxtrrecentanchor"><code class="csfmt">\glsxtrrecentanchor</code></a><span class="floatrightbox"><a id="wrglossary.21274"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined by <a id="wrglossary.21275"></a><a href="#glo:glsxtrdisplaylocnameref"><code class="csfmt">\glsxtrdisplaylocnameref</code></a> to expand to the <span class="meta">〈<em class="metainner">href</em>〉</span> argument. This corresponds to the value of <a id="wrglossary.21276"></a><a href="#glo:@currentHref"><code class="csfmt">\@currentHref</code></a> when the record was created. <a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13585">557</a><p>
+<div class="defnbox"><a id="wrglossary.21277"></a><a href="#glo:GlsXtrRecordCount"><code class="csfmt">\GlsXtrRecordCount</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21278"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the entry’s record count for the given <a id="wrglossary.21279"></a><a href="#glo:@@glslabel@locationcounter">counter</a> (stored in the <a id="wrglossary.21280"></a><a href="#glo:opt.glosfield.recordcount.counter"><span class="csoptfmt">recordcount.<span class="meta">〈<em class="metainner">counter</em>〉</span></span></a> field) or to 0 if not set. <a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12756">523</a><p>
+<div class="defnbox"><a id="wrglossary.21281"></a><a href="#glo:GlsXtrRecordCounter"><code class="csfmt">\GlsXtrRecordCounter</code></a><code class="code">{<span class="meta">〈<em class="metainner">counter-name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21282"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(preamble only)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Activates recording for the given counter. <a href="#sec:printunsrtunit">§8.4.3.2</a>; <a href="#wrglossary.10392">407</a><p>
+<div class="defnbox"><a id="wrglossary.21283"></a><a href="#glo:glsxtrrecordtriggervalue"><code class="csfmt">\glsxtrrecordtriggervalue</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21284"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the trigger value used by <a id="wrglossary.21285"></a><a href="#glo:glsxtrifrecordtrigger"><code class="csfmt">\glsxtrifrecordtrigger</code></a>. <a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12774">524</a><p>
+<div class="defnbox"><a id="wrglossary.21286"></a><dfn id="glo:GlsXtrRecordWarning"><code class="csfmt">\GlsXtrRecordWarning</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">glossary-type</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21287"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Incorrect use of <a id="wrglossary.21288"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> with non-hybrid <a id="wrglossary.21289"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>.<p>
+<div class="defnbox"><a id="wrglossary.21290"></a><a href="#glo:glsxtrregularfont"><code class="csfmt">\glsxtrregularfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21291"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.21292"></a><a href="#glo:glsentryfmt"><code class="csfmt">\glsentryfmt</code></a> to encapsulate regular entries. Also used by <a id="wrglossary.21293"></a><a href="#glo:glsxtrassignfieldfont"><code class="csfmt">\glsxtrassignfieldfont</code></a> for regular entries. <a href="#sec:middleformat">§5.5.2</a>; <a href="#wrglossary.6138">240</a><p>
+<div class="defnbox"><a id="wrglossary.21294"></a><a href="#glo:GlsXtrResetLocalBuffer"><code class="csfmt">\GlsXtrResetLocalBuffer</code></a><span class="floatrightbox"><a id="wrglossary.21295"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If local unset for repeat entries has been enabled with <a id="wrglossary.21296"></a><a href="#glo:GlsXtrUnsetBufferEnableRepeatLocal"><code class="csfmt">\GlsXtrUnsetBufferEnableRepeatLocal</code></a>, this will locally reset all entries that are in the buffer that hadn’t been marked as used before the function was enabled. <a href="#sec:unsetbuffer">§5.10.1</a>; <a href="#wrglossary.7480">285</a><p>
+<div class="defnbox"><a id="wrglossary.21297"></a><a href="#glo:glsxtrresourcecount"><code class="csfmt">\glsxtrresourcecount</code></a><span class="floatrightbox"><a id="wrglossary.21298"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A count register that is incremented on each use of <a id="wrglossary.21299"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a> to provide a unique basename for each <a id="wrglossary.21300"></a><a href="#glo:dual.resourceset">resource set</a>. <a href="#sec:bib2gls">§11</a>; <a href="#wrglossary.12457">511</a><p>
+<div class="defnbox"><a id="wrglossary.21301"></a><a href="#glo:glsxtrresourcefile"><code class="csfmt">\glsxtrresourcefile</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">basename</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21302"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.11+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use with <a id="wrglossary.21303"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, this both sets up the options for the <a id="wrglossary.21304"></a><a href="#glo:dual.resourceset">resource set</a> (which <a id="wrglossary.21305"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can detect from the <a id="wrglossary.21306"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file) and inputs the file <span class="filefmt"></span><span class="meta">〈<em class="metainner">basename</em>〉</span><span class="filefmt">.glstex</span> file created by <a id="wrglossary.21307"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. <a href="#sec:bib2gls">§11</a>; <a href="#wrglossary.12432">510</a><p>
+<div class="defnbox"><a id="wrglossary.21308"></a><a href="#glo:glsxtrresourceinit"><code class="csfmt">\glsxtrresourceinit</code></a><span class="floatrightbox"><a id="wrglossary.21309"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+May be defined to temporarily change command definitions before information is written to the <a id="wrglossary.21310"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file by the protected write used by <a id="wrglossary.21311"></a><a href="#glo:glsxtrresourcefile"><code class="csfmt">\glsxtrresourcefile</code></a>. <a href="#sec:bib2gls">§11</a>; <a href="#wrglossary.12495">512</a><p>
+<div class="defnbox"><a id="wrglossary.21312"></a><a href="#glo:glsxtrrestoremarkhook"><code class="csfmt">\glsxtrrestoremarkhook</code></a></div><!-- end of defnbox -->
+<p>
+Counteracts <a id="wrglossary.21313"></a><a href="#glo:glsxtrmarkhook"><code class="csfmt">\glsxtrmarkhook</code></a>. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5836">227</a><p>
+<div class="defnbox"><a id="wrglossary.21314"></a><a href="#glo:glsxtrrestorepostpunc"><code class="csfmt">\glsxtrrestorepostpunc</code></a><span class="floatrightbox"><a id="wrglossary.21315"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.23+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used in the <a id="wrglossary.21316"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> to counteract the use of <a id="wrglossary.21317"></a><a href="#glo:glsxtrnopostpunc"><code class="csfmt">\glsxtrnopostpunc</code></a>. Does nothing outside of the <a id="wrglossary.21318"></a><a href="#glo:dual.glossary">glossary</a>. <a href="#sec:postdeschooks">§8.6.2</a>; <a href="#wrglossary.10764">423</a><p>
+<div class="defnbox"><a id="wrglossary.21319"></a><a href="#glo:glsxtrrevert"><code class="csfmt">\glsxtrrevert</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21320"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Style-sensitive abbreviation command designed to counteract any font change applied by the style. <a href="#wrglossary.4326">171</a><p>
+<div class="defnbox"><a id="wrglossary.21321"></a><a href="#glo:glsxtrRevertMarks"><code class="csfmt">\glsxtrRevertMarks</code></a></div><!-- end of defnbox -->
+<p>
+Restores <a id="wrglossary.21322"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a>, <a id="wrglossary.21323"></a><a href="#glo:markboth"><code class="csfmt">\markboth</code></a> and <a id="wrglossary.21324"></a><a href="#glo:@starttoc"><code class="csfmt">\@starttoc</code></a> to their previous definitions. <a href="#sec:headtitle">§5.3</a>; <a href="#wrglossary.5160">201</a><p>
+<div class="defnbox"><a id="wrglossary.21325"></a><a href="#glo:glsxtrRevertTocMarks"><code class="csfmt">\glsxtrRevertTocMarks</code></a><span class="floatrightbox"><a id="wrglossary.21326"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.31+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Restores <a id="wrglossary.21327"></a><a href="#glo:@starttoc"><code class="csfmt">\@starttoc</code></a> to its previous definition. <a href="#sec:headtitle">§5.3</a>; <a href="#wrglossary.5165">201</a><p>
+<div class="defnbox"><a id="wrglossary.21328"></a><a href="#glo:glsxtrsaveinsert"><code class="csfmt">\glsxtrsaveinsert</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21329"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Implemented at the start of all the <a id="wrglossary.21330"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands (except the <a id="wrglossary.21331"></a><a href="#glo:dual.inlinefullform">inline full form</a> commands like <a id="wrglossary.21332"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a>) to save the <a id="wrglossary.21333"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a> placeholder. By default, this sets <a id="wrglossary.21334"></a><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a> to empty. <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6471">253</a><p>
+<div class="defnbox"><a id="wrglossary.21335"></a><dfn id="glo:glsxtrscfont"><code class="csfmt">\glsxtrscfont</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Maintained for backwards-compatibility used to typeset <span class="meta">〈<em class="metainner">text</em>〉</span> in small capitals (<a id="wrglossary.21336"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a>) for the <span class="qt">“sc”</span> abbreviation styles.<p>
+<div class="defnbox"><a id="wrglossary.21337"></a><a href="#glo:glsxtrsconlydescname"><code class="csfmt">\glsxtrsconlydescname</code></a><span class="floatrightbox"><a id="wrglossary.21338"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the name value for styles like <a id="wrglossary.21339"></a><a href="#glo:opt.abbrstyle.long-only-short-sc-only-desc"><span class="abbrstylefmt">long-only-short-sc-only-desc</span></a>. <a href="#wrglossary.3886">156</a><p>
+<div class="defnbox"><a id="wrglossary.21340"></a><a href="#glo:glsxtrsconlydescsort"><code class="csfmt">\glsxtrsconlydescsort</code></a><span class="floatrightbox"><a id="wrglossary.21341"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the sort value for styles like <a id="wrglossary.21342"></a><a href="#glo:opt.abbrstyle.long-only-short-sc-only-desc"><span class="abbrstylefmt">long-only-short-sc-only-desc</span></a>. <a href="#wrglossary.3889">156</a><p>
+<div class="defnbox"><a id="wrglossary.21343"></a><a href="#glo:glsxtrsconlyname"><code class="csfmt">\glsxtrsconlyname</code></a><span class="floatrightbox"><a id="wrglossary.21344"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the name value for styles like <a id="wrglossary.21345"></a><a href="#glo:opt.abbrstyle.long-only-short-sc-only"><span class="abbrstylefmt">long-only-short-sc-only</span></a>. <a href="#wrglossary.3882">156</a><p>
+<div class="defnbox"><a id="wrglossary.21346"></a><a href="#glo:glsxtrsconlyrevert"><code class="csfmt">\glsxtrsconlyrevert</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21347"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The definition of <a id="wrglossary.21348"></a><a href="#glo:glsxtrrevert"><code class="csfmt">\glsxtrrevert</code></a> used by styles like <a id="wrglossary.21349"></a><a href="#glo:opt.abbrstyle.long-only-short-sc-only"><span class="abbrstylefmt">long-only-short-sc-only</span></a>. Uses <a id="wrglossary.21350"></a><a href="#glo:glsxtrscrevert"><code class="csfmt">\glsxtrscrevert</code></a>. <a href="#wrglossary.3861">155</a><p>
+<div class="defnbox"><a id="wrglossary.21351"></a><a href="#glo:glsxtrsconlysuffix"><code class="csfmt">\glsxtrsconlysuffix</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsxtrscsuffix"><code class="csfmt">\glsxtrscsuffix</code></a>; <a id="wrglossary.21352"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The plural suffix used by the <span class="qt">“sc-only”</span> <a id="wrglossary.21353"></a><a href="#glo:idx.abbrvstyle">abbreviation styles</a> (such as <a id="wrglossary.21354"></a><a href="#glo:opt.abbrstyle.long-only-short-sc-only"><span class="abbrstylefmt">long-only-short-sc-only</span></a>). <a href="#wrglossary.3866">155</a><p>
+<div class="defnbox"><a id="wrglossary.21355"></a><a href="#glo:glsxtrscrevert"><code class="csfmt">\glsxtrscrevert</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21356"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The definition of <a id="wrglossary.21357"></a><a href="#glo:glsxtrrevert"><code class="csfmt">\glsxtrrevert</code></a> used by the <a id="wrglossary.21358"></a><a href="#glo:idx.smallcaps">small caps</a> (<span class="qt">“sc”</span>) <a id="wrglossary.21359"></a><a href="#glo:idx.abbrvstyle">abbreviation styles</a>. Uses <a id="wrglossary.21360"></a><a href="#glo:glstextup"><code class="csfmt">\glstextup</code></a>. <a href="#wrglossary.3907">157</a><p>
+<div class="defnbox"><a id="wrglossary.21361"></a><a href="#glo:glsxtrscsuffix"><code class="csfmt">\glsxtrscsuffix</code></a></div><!-- end of defnbox -->
+<p>
+The plural suffix used by the <a id="wrglossary.21362"></a><a href="#glo:idx.smallcaps">small caps</a> (<span class="qt">“sc”</span>) <a id="wrglossary.21363"></a><a href="#glo:idx.abbrvstyle">abbreviation styles</a>. This switches off the <a id="wrglossary.21364"></a><a href="#glo:idx.smallcaps">small caps</a> font to prevent the suffix from also appearing in <a id="wrglossary.21365"></a><a href="#glo:idx.smallcaps">small caps</a>. <a href="#wrglossary.3912">157</a><p>
+<div class="defnbox"><a id="wrglossary.21366"></a><a href="#glo:glsxtrscuserrevert"><code class="csfmt">\glsxtrscuserrevert</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21367"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The definition of <a id="wrglossary.21368"></a><a href="#glo:glsxtrrevert"><code class="csfmt">\glsxtrrevert</code></a> used by styles like <a id="wrglossary.21369"></a><a href="#glo:opt.abbrstyle.long-postshort-sc-user"><span class="abbrstylefmt">long-postshort-sc-user</span></a>. Uses <a id="wrglossary.21370"></a><a href="#glo:glsxtrscrevert"><code class="csfmt">\glsxtrscrevert</code></a>. <a href="#wrglossary.3377">136</a><p>
+<div class="defnbox"><a id="wrglossary.21371"></a><a href="#glo:glsxtrscusersuffix"><code class="csfmt">\glsxtrscusersuffix</code></a><span class="floatrightbox"><a id="wrglossary.21372"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The plural suffix used by styles like <a id="wrglossary.21373"></a><a href="#glo:opt.abbrstyle.long-postshort-sc-user"><span class="abbrstylefmt">long-postshort-sc-user</span></a>. <a href="#wrglossary.3382">137</a><p>
+<div class="defnbox"><a id="wrglossary.21374"></a><a href="#glo:glsxtrseealsolabels"><code class="csfmt">\glsxtrseealsolabels</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21375"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.16+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the value of the <a id="wrglossary.21376"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> field for the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. If the field isn’t set, this will expand to nothing. If the entry isn’t defined, this will expand to <a id="wrglossary.21377"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a>. <a href="#sec:getsee">§5.9.2</a>; <a href="#wrglossary.7272">277</a><p>
+<div class="defnbox"><a id="wrglossary.21378"></a><a href="#glo:glsxtrseelist"><code class="csfmt">\glsxtrseelist</code></a><code class="code">{<span class="meta">〈<em class="metainner">csv-list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21379"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.16+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Fully expands <span class="meta">〈<em class="metainner">csv-list</em>〉</span> and passes it to <a id="wrglossary.21380"></a><a href="#glo:glsseelist"><code class="csfmt">\glsseelist</code></a>. <a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7770">299</a><p>
+<div class="defnbox"><a id="wrglossary.21381"></a><a href="#glo:glsxtrseelists"><code class="csfmt">\glsxtrseelists</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21382"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> has the <a id="wrglossary.21383"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a>, <a id="wrglossary.21384"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> or <a id="wrglossary.21385"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> fields set, this will display the cross reference according to <a id="wrglossary.21386"></a><a href="#glo:glsxtruseseeformat"><code class="csfmt">\glsxtruseseeformat</code></a> (for <a id="wrglossary.21387"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> and <a id="wrglossary.21388"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a>) or <a id="wrglossary.21389"></a><a href="#glo:glsxtruseseealsoformat"><code class="csfmt">\glsxtruseseealsoformat</code></a> (for <a id="wrglossary.21390"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a>). If any of these fields are set, the list is encapsulated with <a id="wrglossary.21391"></a><a href="#glo:glsxtrseelistsencap"><code class="csfmt">\glsxtrseelistsencap</code></a>. <a href="#sec:getsee">§5.9.2</a>; <a href="#wrglossary.7240">276</a><p>
+<div class="defnbox"><a id="wrglossary.21392"></a><a href="#glo:glsxtrseelistsdelim"><code class="csfmt">\glsxtrseelistsdelim</code></a><span class="floatrightbox"><a id="wrglossary.21393"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.21394"></a><a href="#glo:glsxtrseelists"><code class="csfmt">\glsxtrseelists</code></a> to as separator between sub-lists. <a href="#sec:getsee">§5.9.2</a>; <a href="#wrglossary.7254">277</a><p>
+<div class="defnbox"><a id="wrglossary.21395"></a><a href="#glo:glsxtrseelistsencap"><code class="csfmt">\glsxtrseelistsencap</code></a><code class="code">{<span class="meta">〈<em class="metainner">content</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21396"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.21397"></a><a href="#glo:glsxtrseelists"><code class="csfmt">\glsxtrseelists</code></a> to encapsulate the lists. <a href="#sec:getsee">§5.9.2</a>; <a href="#wrglossary.7249">276</a><p>
+<div class="defnbox"><a id="wrglossary.21398"></a><a href="#glo:glsxtrsetactualanchor"><code class="csfmt">\glsxtrsetactualanchor</code></a><code class="code">{<span class="meta">〈<em class="metainner">counter</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21399"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook used by <a id="wrglossary.21400"></a><a href="#glo:glsxtrdisplaylocnameref"><code class="csfmt">\glsxtrdisplaylocnameref</code></a> to override the default definition of <a id="wrglossary.21401"></a><a href="#glo:glsxtractualanchor"><code class="csfmt">\glsxtractualanchor</code></a>. <a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13599">557</a><p>
+<div class="defnbox"><a id="wrglossary.21402"></a><a href="#glo:GlsXtrSetActualChar"><code class="csfmt">\GlsXtrSetActualChar</code></a><code class="code">{<span class="meta">〈<em class="metainner">character</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(preamble only)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Sets the <span class="qt">“actual character”</span> for the auto-indexing feature. <a href="#sec:autoindex">§12</a>; <a href="#wrglossary.14084">577</a><p>
+<div class="defnbox"><a id="wrglossary.21403"></a><a href="#glo:glsxtrsetaliasnoindex"><code class="csfmt">\glsxtrsetaliasnoindex</code></a><span class="floatrightbox"><a id="wrglossary.21404"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook used to switch off indexing for aliases. <a href="#sec:glssee">§5.9.3</a>; <a href="#wrglossary.7297">278</a><p>
+<div class="defnbox"><a id="wrglossary.21405"></a><a href="#glo:GlsXtrSetAltModifier"><code class="csfmt">\GlsXtrSetAltModifier</code></a><code class="code">{<span class="meta">〈<em class="metainner">token</em>〉</span>}{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Sets <span class="meta">〈<em class="metainner">token</em>〉</span> as a modifier for the <a id="wrglossary.21406"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.21407"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands that will automatically implement the given options. <a href="#sec:glsref">§5</a>; <a href="#wrglossary.4607">184</a><p>
+<div class="defnbox"><a id="wrglossary.21408"></a><a href="#glo:glsxtrsetbibglsaux"><code class="csfmt">\glsxtrsetbibglsaux</code></a><code class="code">{<span class="meta">〈<em class="metainner">basename</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21409"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.21410"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v3.0+)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As the <a id="wrglossary.21411"></a><a href="#glo:opt.bibglsaux"><span class="styoptfmt">bibglsaux</span></a> option. <a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.774">26</a><p>
+<div class="defnbox"><a id="wrglossary.21412"></a><a href="#glo:glsxtrsetcategory"><code class="csfmt">\glsxtrsetcategory</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-labels</em>〉</span>}{<span class="meta">〈<em class="metainner">category-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Globally sets the <a id="wrglossary.21413"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> field to the fully expanded <span class="meta">〈<em class="metainner">category-label</em>〉</span> for each entry listed in <span class="meta">〈<em class="metainner">entry-labels</em>〉</span>. <a href="#sec:categories">§10</a>; <a href="#wrglossary.12051">492</a><p>
+<div class="defnbox"><a id="wrglossary.21414"></a><a href="#glo:glsxtrsetcategoryforall"><code class="csfmt">\glsxtrsetcategoryforall</code></a><code class="code">{<span class="meta">〈<em class="metainner">glossary-labels</em>〉</span>}{<span class="meta">〈<em class="metainner">category-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Globally sets the <a id="wrglossary.21415"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> field to the fully expanded <span class="meta">〈<em class="metainner">category-label</em>〉</span> for each entry belonging to the <a id="wrglossary.21416"></a><a href="#glo:dual.glossary">glossaries</a> listed in <span class="meta">〈<em class="metainner">glossary-labels</em>〉</span>. <a href="#sec:categories">§10</a>; <a href="#wrglossary.12053">492</a><p>
+<div class="defnbox"><a id="wrglossary.21417"></a><a href="#glo:glsxtrsetcomplexstyle"><code class="csfmt">\glsxtrsetcomplexstyle</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">n</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21418"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indicates that the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> uses a complex abbreviation style. The second argument <span class="meta">〈<em class="metainner">n</em>〉</span> should be numeric, which indicates why it doesn’t work with the variations of <a id="wrglossary.21419"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a>: 1 (all caps doesn’t work), 2 (all caps and insert doesn’t work), 3 (insert doesn’t work). <a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4142">166</a><p>
+<div class="defnbox"><a id="wrglossary.21420"></a><a href="#glo:GlsXtrSetDefaultGlsOpts"><code class="csfmt">\GlsXtrSetDefaultGlsOpts</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Locally set the default options for the <a id="wrglossary.21421"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.21422"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands. <a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4725">187</a><p>
+<div class="defnbox"><a id="wrglossary.21423"></a><a href="#glo:GlsXtrSetDefaultNumberFormat"><code class="csfmt">\GlsXtrSetDefaultNumberFormat</code></a><code class="code">{<span class="meta">〈<em class="metainner">encap</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21424"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.19+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the default <a id="wrglossary.21425"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a> to <span class="meta">〈<em class="metainner">encap</em>〉</span> (without the leading backslash). <a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4747">188</a><p>
+<div class="defnbox"><a id="wrglossary.21426"></a><a href="#glo:GlsXtrSetEncapChar"><code class="csfmt">\GlsXtrSetEncapChar</code></a><code class="code">{<span class="meta">〈<em class="metainner">character</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(preamble only)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Sets the <span class="qt">“encap character”</span> for the auto-indexing feature. <a href="#sec:autoindex">§12</a>; <a href="#wrglossary.14087">577</a><p>
+<div class="defnbox"><a id="wrglossary.21427"></a><a href="#glo:GlsXtrSetEscChar"><code class="csfmt">\GlsXtrSetEscChar</code></a><code class="code">{<span class="meta">〈<em class="metainner">character</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(preamble only)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Sets the <span class="qt">“escape character”</span> for the auto-indexing feature. <a href="#sec:autoindex">§12</a>; <a href="#wrglossary.14086">577</a><p>
+<div class="defnbox"><a id="wrglossary.21428"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21429"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Assigns <span class="meta">〈<em class="metainner">value</em>〉</span> to the field identified by its <a id="wrglossary.21430"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a> <span class="meta">〈<em class="metainner">field-label</em>〉</span> for the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. An error (or warning with <a id="wrglossary.21431"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="optfmt">=</span><a id="wrglossary.21432"></a><a href="#glo:optval.undefaction.warn"><span class="optfmt">warn</span></a>) occurs if the entry hasn’t been defined. <a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1196">39</a><p>
+<div class="defnbox"><a id="wrglossary.21433"></a><a href="#glo:glsxtrsetfieldifexists"><code class="csfmt">\glsxtrsetfieldifexists</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">code</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21434"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by commands like <a id="wrglossary.21435"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a> to check if the entry exists before assigning a value to the field. The <span class="meta">〈<em class="metainner">code</em>〉</span> part is the assignment code, which is only done if the required condition is met. This can be redefined if the condition needs to be altered. <a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1186">39</a><p>
+<div class="defnbox"><a id="wrglossary.21436"></a><a href="#glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></a><code class="code">{<span class="meta">〈<em class="metainner">group-label</em>〉</span>}{<span class="meta">〈<em class="metainner">group-title</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21437"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Globally assigns the given title <span class="meta">〈<em class="metainner">group-title</em>〉</span> to the <a id="wrglossary.21438"></a><a href="#glo:idx.group">group</a> identified by <span class="meta">〈<em class="metainner">group-label</em>〉</span>. <a href="#sec:glosgroups">§8.6.4</a>; <a href="#wrglossary.10843">426</a><p>
+<div class="defnbox"><a id="wrglossary.21439"></a><a href="#glo:glsxtrsetglossarylabel"><code class="csfmt">\glsxtrsetglossarylabel</code></a><code class="code">{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21440"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.39+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the label to add (using <code class="code"><a id="wrglossary.21441"></a><a href="#glo:label"><code class="csfmt">\label</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code>) after the <a id="wrglossary.21442"></a><a href="#glo:dual.glossary">glossary</a> section heading. <a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9553">378</a><p>
+<div class="defnbox"><a id="wrglossary.21443"></a><a href="#glo:GlsXtrSetLevelChar"><code class="csfmt">\GlsXtrSetLevelChar</code></a><code class="code">{<span class="meta">〈<em class="metainner">character</em>〉</span>}</code><p>
+<div class="noteBox"><span style="font-size: small; ">(preamble only)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Sets the <span class="qt">“level character”</span> for the auto-indexing feature. <a href="#sec:autoindex">§12</a>; <a href="#wrglossary.14085">577</a><p>
+<div class="defnbox"><a id="wrglossary.21444"></a><a href="#glo:glsxtrsetlongfirstuse"><code class="csfmt">\glsxtrsetlongfirstuse</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21445"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Implemented by the <a id="wrglossary.21446"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> set of commands to assign <a id="wrglossary.21447"></a><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a>. <a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1534">52</a><p>
+<div class="defnbox"><a id="wrglossary.21448"></a><a href="#glo:GlsXtrSetPlusModifier"><code class="csfmt">\GlsXtrSetPlusModifier</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21449"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Overrides the options that should be implemented by the plus (<code class="code">+</code>) modifier for <a id="wrglossary.21450"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.21451"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands. <a href="#sec:glsref">§5</a>; <a href="#wrglossary.4615">184</a><p>
+<div class="defnbox"><a id="wrglossary.21452"></a><a href="#glo:glsxtrsetpopts"><code class="csfmt">\glsxtrsetpopts</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21453"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.07+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the options that <a id="wrglossary.21454"></a><a href="#glo:glsxtrp"><code class="csfmt">\glsxtrp</code></a> (and case-change variants) pass to the relevant <a id="wrglossary.21455"></a><a href="#glo:glstextlike"><code class="csfmt">\glstext</code>-like</a> command. <a href="#sec:nested">§5.4</a>; <a href="#wrglossary.5931">231</a><p>
+<div class="defnbox"><a id="wrglossary.21456"></a><a href="#glo:glsxtrsetpunctuationmarks"><code class="csfmt">\glsxtrsetpunctuationmarks</code></a><code class="code">{<span class="meta">〈<em class="metainner">token list</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Sets the punctuation list used by <a id="wrglossary.21457"></a><a href="#glo:glsxtrifnextpunc"><code class="csfmt">\glsxtrifnextpunc</code></a>. The <span class="meta">〈<em class="metainner">token list</em>〉</span> must be a non-delimited list of single tokens that represent each punctuation character. Note that the element of the list must be a single token, which means a single-byte character for pdfLaTeX (for example, <a id="wrglossary.21458"></a><a href="#glo:dual.ascii">ASCII</a>). Multi-byte characters (<a id="wrglossary.21459"></a><a href="#glo:dual.utf8">UTF-8</a>) will required a native Unicode engine (XeLaTeX or LuaLaTeX). <a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6369">249</a><p>
+<div class="defnbox"><a id="wrglossary.21460"></a><a href="#glo:GlsXtrSetRecordCountAttribute"><code class="csfmt">\GlsXtrSetRecordCountAttribute</code></a><code class="code">{<span class="meta">〈<em class="metainner">category-list</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21461"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the <a id="wrglossary.21462"></a><a href="#glo:opt.catattr.recordcount"><span class="csoptfmt">recordcount</span></a> attribute to <span class="meta">〈<em class="metainner">value</em>〉</span> for each of the listed categories. <a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12782">524</a><p>
+<div class="defnbox"><a id="wrglossary.21463"></a><a href="#glo:GlsXtrSetStarModifier"><code class="csfmt">\GlsXtrSetStarModifier</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21464"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Overrides the options that should be implemented by the star (<code class="code">*</code>) modifier for <a id="wrglossary.21465"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.21466"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands. <a href="#sec:glsref">§5</a>; <a href="#wrglossary.4614">184</a><p>
+<div class="defnbox"><a id="wrglossary.21467"></a><a href="#glo:glsxtrsetupfulldefs"><code class="csfmt">\glsxtrsetupfulldefs</code></a></div><!-- end of defnbox -->
+<p>
+Hook used by <a id="wrglossary.21468"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> (and case-changing and plural variations). <a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1598">54</a><p>
+<div class="defnbox"><a id="wrglossary.21469"></a><a href="#glo:glsxtrSetWidest"><code class="csfmt">\glsxtrSetWidest</code></a><code class="code">{<span class="meta">〈<em class="metainner">type</em>〉</span>}{<span class="meta">〈<em class="metainner">level</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21470"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Written to the <a id="wrglossary.21471"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> by the <a id="wrglossary.21472"></a><a href="#glo:opt.resource.set-widest"><span class="csoptfmt">set-widest</span></a> option. <a href="#sec:glstexcmds">§11.5.3</a>; <a href="#wrglossary.13467">553</a><p>
+<div class="defnbox"><a id="wrglossary.21473"></a><a href="#glo:glsxtrSetWidestFallback"><code class="csfmt">\glsxtrSetWidestFallback</code></a><code class="code">{<span class="meta">〈<em class="metainner">type</em>〉</span>}{<span class="meta">〈<em class="metainner">level</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21474"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Written to the <a id="wrglossary.21475"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> by the <a id="wrglossary.21476"></a><a href="#glo:opt.resource.set-widest"><span class="csoptfmt">set-widest</span></a> option if <a id="wrglossary.21477"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can’t determine the widest name. <a href="#sec:glstexcmds">§11.5.3</a>; <a href="#wrglossary.13476">554</a><p>
+<div class="defnbox"><a id="wrglossary.21478"></a><a href="#glo:GLSxtrshort"><code class="csfmt">\GLSxtrshort</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.21479"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.21480"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.21481"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21482"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> but converts the <a id="wrglossary.21483"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.21484"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1509">52</a><p>
+<div class="defnbox"><a id="wrglossary.21485"></a><a href="#glo:Glsxtrshort"><code class="csfmt">\Glsxtrshort</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.21486"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.21487"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.21488"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21489"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> but converts the first character of the <a id="wrglossary.21490"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.21491"></a><a href="#glo:idx.uppercase">uppercase</a><a id="wrglossary.21492"></a> (for the start of a sentence) using <a id="wrglossary.21493"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. <a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1504">51</a><p>
+<div class="defnbox"><a id="wrglossary.21494"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.21495"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.21496"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.21497"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The text produced is obtained from the <a id="wrglossary.21498"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> value, formatted according to the <a id="wrglossary.21499"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> associated with the entry’s <a id="wrglossary.21500"></a><a href="#glo:idx.category">category</a>. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument will be inserted at the end of the <a id="wrglossary.21501"></a><a href="#glo:dual.linktext">link text</a>. This command does not alter or depend on the <a id="wrglossary.21502"></a><a href="#glo:dual.firstuseflag">first use flag</a>. For the first optional argument, see <a id="wrglossary.21503"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>. <a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1500">51</a><p>
+<div class="defnbox"><a id="wrglossary.21504"></a><a href="#glo:glsxtrshortdescname"><code class="csfmt">\glsxtrshortdescname</code></a><span class="floatrightbox"><a id="wrglossary.21505"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the name value for styles like <a id="wrglossary.21506"></a><a href="#glo:opt.abbrstyle.short-nolong-desc"><span class="abbrstylefmt">short-nolong-desc</span></a>. <a href="#wrglossary.3632">147</a><p>
+<div class="defnbox"><a id="wrglossary.21507"></a><a href="#glo:GLSxtrshortformat"><code class="csfmt">\GLSxtrshortformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21508"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21509"></a><a href="#glo:glsxtrshortformat"><code class="csfmt">\glsxtrshortformat</code></a> but <a id="wrglossary.21510"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.4490">177</a><p>
+<div class="defnbox"><a id="wrglossary.21511"></a><a href="#glo:Glsxtrshortformat"><code class="csfmt">\Glsxtrshortformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21512"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21513"></a><a href="#glo:glsxtrshortformat"><code class="csfmt">\glsxtrshortformat</code></a> but <a id="wrglossary.21514"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#wrglossary.4488">177</a><p>
+<div class="defnbox"><a id="wrglossary.21515"></a><a href="#glo:glsxtrshortformat"><code class="csfmt">\glsxtrshortformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21516"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Encapsulates the <a id="wrglossary.21517"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> field for the given entry with <span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument is the insertion material supplied in the final optional argument of the <a id="wrglossary.21518"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> or <a id="wrglossary.21519"></a><a href="#glo:dual.glstextlike"><code class="csfmt">\glstext</code>-like</a> commands. The <a id="wrglossary.21520"></a><a href="#glo:ifglsxtrinsertinside"><code class="csfmt">\ifglsxtrinsertinside</code></a>, <a id="wrglossary.21521"></a><a href="#glo:dual.innerformatting">inner formatting</a>, and accessibility settings are supported. <a href="#wrglossary.4478">177</a><p>
+<div class="defnbox"><a id="wrglossary.21522"></a><a href="#glo:GLSxtrshortformatgrp"><code class="csfmt">\GLSxtrshortformatgrp</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21523"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21524"></a><a href="#glo:glsxtrshortformatgrp"><code class="csfmt">\glsxtrshortformatgrp</code></a> but <a id="wrglossary.21525"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.4504">178</a><p>
+<div class="defnbox"><a id="wrglossary.21526"></a><a href="#glo:Glsxtrshortformatgrp"><code class="csfmt">\Glsxtrshortformatgrp</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21527"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21528"></a><a href="#glo:glsxtrshortformatgrp"><code class="csfmt">\glsxtrshortformatgrp</code></a> but <a id="wrglossary.21529"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#wrglossary.4502">178</a><p>
+<div class="defnbox"><a id="wrglossary.21530"></a><a href="#glo:glsxtrshortformatgrp"><code class="csfmt">\glsxtrshortformatgrp</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21531"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21532"></a><a href="#glo:glsxtrshortformat"><code class="csfmt">\glsxtrshortformat</code></a> but adds grouping around <span class="meta">〈<em class="metainner">insert</em>〉</span> (with the <a id="wrglossary.21533"></a><a href="#glo:dual.innerformatting">inner formatting</a> inside the group). <a href="#wrglossary.4499">178</a><p>
+<div class="defnbox"><a id="wrglossary.21534"></a><a href="#glo:glsxtrshorthyphen"><code class="csfmt">\glsxtrshorthyphen</code></a><code class="code">{<span class="meta">〈<em class="metainner">short</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21535"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the short form according to the <a id="wrglossary.21536"></a><a href="#glo:opt.abbrstyle.short-hyphen-postlong-hyphen"><span class="abbrstylefmt">short-hyphen-postlong-hyphen</span></a> style. <a href="#wrglossary.3790">152</a><p>
+<div class="defnbox"><a id="wrglossary.21537"></a><a href="#glo:GLSxtrshorthyphenlong"><code class="csfmt">\GLSxtrshorthyphenlong</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">short</em>〉</span>}{<span class="meta">〈<em class="metainner">long</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21538"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21539"></a><a href="#glo:glsxtrshorthyphenlong"><code class="csfmt">\glsxtrshorthyphenlong</code></a> but <span class="meta">〈<em class="metainner">insert</em>〉</span> is converted to <a id="wrglossary.21540"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.3785">152</a><p>
+<div class="defnbox"><a id="wrglossary.21541"></a><a href="#glo:glsxtrshorthyphenlong"><code class="csfmt">\glsxtrshorthyphenlong</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">short</em>〉</span>}{<span class="meta">〈<em class="metainner">long</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21542"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the short and long form according to the <a id="wrglossary.21543"></a><a href="#glo:opt.abbrstyle.short-hyphen-long-hyphen"><span class="abbrstylefmt">short-hyphen-long-hyphen</span></a> style. <a href="#wrglossary.3781">152</a><p>
+<div class="defnbox"><a id="wrglossary.21544"></a><a href="#glo:glsxtrshorthyphenlongsort"><code class="csfmt">\glsxtrshorthyphenlongsort</code></a><span class="floatrightbox"><a id="wrglossary.21545"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the sort value for the <a id="wrglossary.21546"></a><a href="#glo:opt.abbrstyle.short-hyphen-long-hyphen"><span class="abbrstylefmt">short-hyphen-long-hyphen</span></a> styles. <a href="#wrglossary.3674">148</a><p>
+<div class="defnbox"><a id="wrglossary.21547"></a><a href="#glo:glsxtrshortlongdescname"><code class="csfmt">\glsxtrshortlongdescname</code></a><span class="floatrightbox"><a id="wrglossary.21548"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the name value for <a id="wrglossary.21549"></a><a href="#glo:opt.abbrstyle.short-long-desc"><span class="abbrstylefmt">short-long-desc</span></a> styles. <a href="#wrglossary.3326">134</a><p>
+<div class="defnbox"><a id="wrglossary.21550"></a><a href="#glo:glsxtrshortlongdescsort"><code class="csfmt">\glsxtrshortlongdescsort</code></a><span class="floatrightbox"><a id="wrglossary.21551"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the sort value for <a id="wrglossary.21552"></a><a href="#glo:opt.abbrstyle.short-long-desc"><span class="abbrstylefmt">short-long-desc</span></a> styles. <a href="#wrglossary.3320">134</a><p>
+<div class="defnbox"><a id="wrglossary.21553"></a><a href="#glo:GLSxtrshortlongformat"><code class="csfmt">\GLSxtrshortlongformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21554"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21555"></a><a href="#glo:glsxtrshortlongformat"><code class="csfmt">\glsxtrshortlongformat</code></a> but <a id="wrglossary.21556"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.4540">180</a><p>
+<div class="defnbox"><a id="wrglossary.21557"></a><a href="#glo:Glsxtrshortlongformat"><code class="csfmt">\Glsxtrshortlongformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21558"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21559"></a><a href="#glo:glsxtrshortlongformat"><code class="csfmt">\glsxtrshortlongformat</code></a> but <a id="wrglossary.21560"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#wrglossary.4538">180</a><p>
+<div class="defnbox"><a id="wrglossary.21561"></a><a href="#glo:glsxtrshortlongformat"><code class="csfmt">\glsxtrshortlongformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21562"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the short form with <a id="wrglossary.21563"></a><a href="#glo:glsxtrshortformat"><code class="csfmt">\glsxtrshortformat</code></a> and the long form in parentheses with <a id="wrglossary.21564"></a><a href="#glo:glsxtrlongformat"><code class="csfmt">\glsxtrlongformat</code></a>. <a href="#wrglossary.4530">180</a><p>
+<div class="defnbox"><a id="wrglossary.21565"></a><a href="#glo:glsxtrshortlongname"><code class="csfmt">\glsxtrshortlongname</code></a><span class="floatrightbox"><a id="wrglossary.21566"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.25+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the name value for <a id="wrglossary.21567"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a> styles. <a href="#wrglossary.3314">134</a><p>
+<div class="defnbox"><a id="wrglossary.21568"></a><a href="#glo:GLSxtrshortlongplformat"><code class="csfmt">\GLSxtrshortlongplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21569"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21570"></a><a href="#glo:glsxtrshortlongplformat"><code class="csfmt">\glsxtrshortlongplformat</code></a> but <a id="wrglossary.21571"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.4548">181</a><p>
+<div class="defnbox"><a id="wrglossary.21572"></a><a href="#glo:Glsxtrshortlongplformat"><code class="csfmt">\Glsxtrshortlongplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21573"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21574"></a><a href="#glo:glsxtrshortlongplformat"><code class="csfmt">\glsxtrshortlongplformat</code></a> but <a id="wrglossary.21575"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#wrglossary.4546">180</a><p>
+<div class="defnbox"><a id="wrglossary.21576"></a><a href="#glo:glsxtrshortlongplformat"><code class="csfmt">\glsxtrshortlongplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21577"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21578"></a><a href="#glo:glsxtrshortlongformat"><code class="csfmt">\glsxtrshortlongformat</code></a> but for the plurals. <a href="#wrglossary.4542">180</a><p>
+<div class="defnbox"><a id="wrglossary.21579"></a><a href="#glo:glsxtrshortlonguserdescname"><code class="csfmt">\glsxtrshortlonguserdescname</code></a><span class="floatrightbox"><a id="wrglossary.21580"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.25+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the value for the <a id="wrglossary.21581"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key for styles like <a id="wrglossary.21582"></a><a href="#glo:opt.abbrstyle.short-long-user-desc"><span class="abbrstylefmt">short-long-user-desc</span></a>. <a href="#wrglossary.3433">139</a><p>
+<div class="defnbox"><a id="wrglossary.21583"></a><a href="#glo:glsxtrshortnolongname"><code class="csfmt">\glsxtrshortnolongname</code></a><span class="floatrightbox"><a id="wrglossary.21584"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.25+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the name value for <a id="wrglossary.21585"></a><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a> styles. <a href="#wrglossary.3626">146</a><p>
+<div class="defnbox"><a id="wrglossary.21586"></a><a href="#glo:GLSxtrshortpl"><code class="csfmt">\GLSxtrshortpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.21587"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.21588"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.21589"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21590"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> but converts the <a id="wrglossary.21591"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.21592"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1523">52</a><p>
+<div class="defnbox"><a id="wrglossary.21593"></a><a href="#glo:Glsxtrshortpl"><code class="csfmt">\Glsxtrshortpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.21594"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.21595"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.21596"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21597"></a><a href="#glo:glsxtrshortpl"><code class="csfmt">\glsxtrshortpl</code></a> but converts the first character of the <a id="wrglossary.21598"></a><a href="#glo:dual.linktext">link text</a> to <a id="wrglossary.21599"></a><a href="#glo:idx.uppercase">uppercase</a><a id="wrglossary.21600"></a> (for the start of a sentence) using <a id="wrglossary.21601"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. <a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1518">52</a><p>
+<div class="defnbox"><a id="wrglossary.21602"></a><a href="#glo:glsxtrshortpl"><code class="csfmt">\glsxtrshortpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.21603"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.21604"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.21605"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> </span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. The text produced is obtained from the <a id="wrglossary.21606"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> value, formatted according to the <a id="wrglossary.21607"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> associated with the entry’s <a id="wrglossary.21608"></a><a href="#glo:idx.category">category</a>. The <span class="meta">〈<em class="metainner">insert</em>〉</span> argument will be inserted at the end of the <a id="wrglossary.21609"></a><a href="#glo:dual.linktext">link text</a>. This command does not alter or depend on the <a id="wrglossary.21610"></a><a href="#glo:dual.firstuseflag">first use flag</a>. For the first optional argument, see <a id="wrglossary.21611"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>. <a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1514">52</a><p>
+<div class="defnbox"><a id="wrglossary.21612"></a><a href="#glo:GLSxtrshortplformat"><code class="csfmt">\GLSxtrshortplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21613"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21614"></a><a href="#glo:glsxtrshortplformat"><code class="csfmt">\glsxtrshortplformat</code></a> but <a id="wrglossary.21615"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.4497">178</a><p>
+<div class="defnbox"><a id="wrglossary.21616"></a><a href="#glo:Glsxtrshortplformat"><code class="csfmt">\Glsxtrshortplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21617"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21618"></a><a href="#glo:glsxtrshortplformat"><code class="csfmt">\glsxtrshortplformat</code></a> but <a id="wrglossary.21619"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#wrglossary.4495">178</a><p>
+<div class="defnbox"><a id="wrglossary.21620"></a><a href="#glo:glsxtrshortplformat"><code class="csfmt">\glsxtrshortplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21621"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21622"></a><a href="#glo:glsxtrshortformat"><code class="csfmt">\glsxtrshortformat</code></a> but for the <a id="wrglossary.21623"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> field. <a href="#wrglossary.4492">178</a><p>
+<div class="defnbox"><a id="wrglossary.21624"></a><a href="#glo:GLSxtrshortplformatgrp"><code class="csfmt">\GLSxtrshortplformatgrp</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21625"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21626"></a><a href="#glo:glsxtrshortplformatgrp"><code class="csfmt">\glsxtrshortplformatgrp</code></a> but <a id="wrglossary.21627"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.4511">179</a><p>
+<div class="defnbox"><a id="wrglossary.21628"></a><a href="#glo:Glsxtrshortplformatgrp"><code class="csfmt">\Glsxtrshortplformatgrp</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21629"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21630"></a><a href="#glo:glsxtrshortplformatgrp"><code class="csfmt">\glsxtrshortplformatgrp</code></a> but <a id="wrglossary.21631"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#wrglossary.4509">178</a><p>
+<div class="defnbox"><a id="wrglossary.21632"></a><a href="#glo:glsxtrshortplformatgrp"><code class="csfmt">\glsxtrshortplformatgrp</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21633"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21634"></a><a href="#glo:glsxtrshortplformat"><code class="csfmt">\glsxtrshortplformat</code></a> but adds grouping around <span class="meta">〈<em class="metainner">insert</em>〉</span> (with the <a id="wrglossary.21635"></a><a href="#glo:dual.innerformatting">inner formatting</a> inside the group). <a href="#wrglossary.4506">178</a><p>
+<div class="defnbox"><a id="wrglossary.21636"></a><a href="#glo:glsxtrshowtargetinner"><code class="csfmt">\glsxtrshowtargetinner</code></a><code class="code">{<span class="meta">〈<em class="metainner">target-name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21637"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used in inner mode for debugging, this defaults to <a id="wrglossary.21638"></a><a href="#glo:glsshowtargetinner"><code class="csfmt">\glsshowtargetinner</code></a> but is changed by the <a id="wrglossary.21639"></a><a href="#glo:opt.showtargets"><span class="styoptfmt">showtargets</span></a> options. <a href="#sec:debuggingopts">§2.5</a>; <a href="#wrglossary.902">30</a><p>
+<div class="defnbox"><a id="wrglossary.21640"></a><a href="#glo:glsxtrshowtargetouter"><code class="csfmt">\glsxtrshowtargetouter</code></a><code class="code">{<span class="meta">〈<em class="metainner">target-name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21641"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used in outer mode for debugging, this defaults to <a id="wrglossary.21642"></a><a href="#glo:glsshowtargetouter"><code class="csfmt">\glsshowtargetouter</code></a> but is changed by the <a id="wrglossary.21643"></a><a href="#glo:opt.showtargets"><span class="styoptfmt">showtargets</span></a> options. <a href="#sec:debuggingopts">§2.5</a>; <a href="#wrglossary.898">30</a><p>
+<div class="defnbox"><a id="wrglossary.21644"></a><a href="#glo:glsxtrshowtargetsymbolleft"><code class="csfmt">\glsxtrshowtargetsymbolleft</code></a><span class="floatrightbox"><a id="wrglossary.21645"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The left marker debugging symbol (◁). <a href="#sec:debuggingopts">§2.5</a>; <a href="#wrglossary.907">30</a><p>
+<div class="defnbox"><a id="wrglossary.21646"></a><a href="#glo:glsxtrshowtargetsymbolright"><code class="csfmt">\glsxtrshowtargetsymbolright</code></a><span class="floatrightbox"><a id="wrglossary.21647"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The right marker debugging symbol (▷). <a href="#sec:debuggingopts">§2.5</a>; <a href="#wrglossary.909">30</a><p>
+<div class="defnbox"><a id="wrglossary.21648"></a><dfn id="glo:glsxtrsmfont"><code class="csfmt">\glsxtrsmfont</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Maintained for backwards-compatibility used to typeset <span class="meta">〈<em class="metainner">text</em>〉</span> in a smaller font (<a id="wrglossary.21649"></a><a href="#glo:textsmaller"><code class="csfmt">\textsmaller</code></a>) for the <span class="qt">“sm”</span> abbreviation styles.<p>
+<div class="defnbox"><a id="wrglossary.21650"></a><a href="#glo:glsxtrsmrevert"><code class="csfmt">\glsxtrsmrevert</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21651"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The definition of <a id="wrglossary.21652"></a><a href="#glo:glsxtrrevert"><code class="csfmt">\glsxtrrevert</code></a> used by the smaller (<span class="qt">“sm”</span>) <a id="wrglossary.21653"></a><a href="#glo:idx.abbrvstyle">abbreviation styles</a>. Uses <a id="wrglossary.21654"></a><a href="#glo:textlarger"><code class="csfmt">\textlarger</code></a>. <a href="#wrglossary.3924">158</a><p>
+<div class="defnbox"><a id="wrglossary.21655"></a><a href="#glo:glsxtrsmsuffix"><code class="csfmt">\glsxtrsmsuffix</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The plural suffix used by the smaller (<span class="qt">“sm”</span>) <a id="wrglossary.21656"></a><a href="#glo:idx.abbrvstyle">abbreviation styles</a> (such as <a id="wrglossary.21657"></a><a href="#glo:opt.abbrstyle.short-sm-long"><span class="abbrstylefmt">short-sm-long</span></a>). <a href="#wrglossary.3929">158</a><p>
+<div class="defnbox"><a id="wrglossary.21658"></a><a href="#glo:glsxtrspacerules"><code class="csfmt">\glsxtrspacerules</code></a><span class="floatrightbox"><a id="wrglossary.21659"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to space character sort rules. <a href="#wrglossary.13257">542</a><p>
+<div class="defnbox"><a id="wrglossary.21660"></a><a href="#glo:GlsXtrStandaloneEntryHeadName"><code class="csfmt">\GlsXtrStandaloneEntryHeadName</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21661"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.21662"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a> for the header and toc. <a href="#sec:glossentry">§8.5</a>; <a href="#wrglossary.10613">417</a><p>
+<div class="defnbox"><a id="wrglossary.21663"></a><a href="#glo:GlsXtrStandaloneEntryHeadOther"><code class="csfmt">\GlsXtrStandaloneEntryHeadOther</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21664"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.21665"></a><a href="#glo:glsxtrglossentryother"><code class="csfmt">\glsxtrglossentryother</code></a> for the header and toc. <a href="#sec:glossentry">§8.5</a>; <a href="#wrglossary.10630">418</a><p>
+<div class="defnbox"><a id="wrglossary.21666"></a><a href="#glo:GlsXtrStandaloneEntryName"><code class="csfmt">\GlsXtrStandaloneEntryName</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21667"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the standalone entry name and create the associated hypertarget, if supported. <a href="#sec:glossentry">§8.5</a>; <a href="#wrglossary.10565">415</a><p>
+<div class="defnbox"><a id="wrglossary.21668"></a><a href="#glo:GlsXtrStandaloneEntryOther"><code class="csfmt">\GlsXtrStandaloneEntryOther</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21669"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21670"></a><a href="#glo:GlsXtrStandaloneEntryName"><code class="csfmt">\GlsXtrStandaloneEntryName</code></a> but where the text is obtained from the given field instead of <a id="wrglossary.21671"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>. <a href="#sec:glossentry">§8.5</a>; <a href="#wrglossary.10583">415</a><p>
+<div class="defnbox"><a id="wrglossary.21672"></a><a href="#glo:GlsXtrStandaloneEntryPdfName"><code class="csfmt">\GlsXtrStandaloneEntryPdfName</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21673"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.21674"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a> for the PDF bookmark. <a href="#sec:glossentry">§8.5</a>; <a href="#wrglossary.10611">417</a><p>
+<div class="defnbox"><a id="wrglossary.21675"></a><a href="#glo:GlsXtrStandaloneEntryPdfOther"><code class="csfmt">\GlsXtrStandaloneEntryPdfOther</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21676"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.21677"></a><a href="#glo:glsxtrglossentryother"><code class="csfmt">\glsxtrglossentryother</code></a> for the PDF bookmark. <a href="#sec:glossentry">§8.5</a>; <a href="#wrglossary.10629">417</a><p>
+<div class="defnbox"><a id="wrglossary.21678"></a><a href="#glo:GlsXtrStandaloneGlossaryType"><code class="csfmt">\GlsXtrStandaloneGlossaryType</code></a><span class="floatrightbox"><a id="wrglossary.21679"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the <a id="wrglossary.21680"></a><a href="#glo:dual.glossary">glossary</a> type for standalone entries. <a href="#sec:glossentry">§8.5</a>; <a href="#wrglossary.10554">414</a><p>
+<div class="defnbox"><a id="wrglossary.21681"></a><a href="#glo:GlsXtrStandaloneSubEntryItem"><code class="csfmt">\GlsXtrStandaloneSubEntryItem</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21682"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display standalone entries that have the <a id="wrglossary.21683"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> field set. <a href="#sec:glossentry">§8.5</a>; <a href="#wrglossary.10559">414</a><p>
+<div class="defnbox"><a id="wrglossary.21684"></a><dfn id="glo:glsxtrstarflywarn"><code class="csfmt">\glsxtrstarflywarn</code></dfn></div><!-- end of defnbox -->
+<p>
+Issues a warning with <a id="wrglossary.21685"></a><a href="#glo:GlossariesExtraWarning"><code class="csfmt">\GlossariesExtraWarning</code></a> indicating that the experimental starred version of <a id="wrglossary.21686"></a><a href="#glo:GlsXtrEnableOnTheFly"><code class="csfmt">\GlsXtrEnableOnTheFly</code></a> has been used.<p>
+<div class="defnbox"><a id="wrglossary.21687"></a><a href="#glo:GlsXtrStartUnsetBuffering"><code class="csfmt">\GlsXtrStartUnsetBuffering</code></a><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.21688"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.30+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Enables unset buffering. The starred version doesn’t check for duplicates. <a href="#sec:unsetbuffer">§5.10.1</a>; <a href="#wrglossary.7463">284</a><p>
+<div class="defnbox"><a id="wrglossary.21689"></a><a href="#glo:GlsXtrStopUnsetBuffering"><code class="csfmt">\GlsXtrStopUnsetBuffering</code></a><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.21690"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.30+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Stops buffering. The starred version performs a global unset. <a href="#sec:unsetbuffer">§5.10.1</a>; <a href="#wrglossary.7468">285</a><p>
+<div class="defnbox"><a id="wrglossary.21691"></a><a href="#glo:glsxtrSubScriptDigitrules"><code class="csfmt">\glsxtrSubScriptDigitrules</code></a><span class="floatrightbox"><a id="wrglossary.21692"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the 0–9 subscript digit character sort rules. <a href="#wrglossary.13298">545</a><p>
+<div class="defnbox"><a id="wrglossary.21693"></a><a href="#glo:GLSxtrsubsequentfmt"><code class="csfmt">\GLSxtrsubsequentfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21694"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.21695"></a><a href="#glo:glsxtrgenabbrvfmt"><code class="csfmt">\glsxtrgenabbrvfmt</code></a> to display the <a id="wrglossary.21696"></a><a href="#glo:idx.allcaps">all caps</a> subsequent singular form (defined by the abbreviation style). <a href="#wrglossary.4380">173</a><p>
+<div class="defnbox"><a id="wrglossary.21697"></a><a href="#glo:Glsxtrsubsequentfmt"><code class="csfmt">\Glsxtrsubsequentfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21698"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.21699"></a><a href="#glo:glsxtrgenabbrvfmt"><code class="csfmt">\glsxtrgenabbrvfmt</code></a> to display the <a id="wrglossary.21700"></a><a href="#glo:idx.sentencecase">sentence case</a> subsequent singular form (defined by the abbreviation style). <a href="#wrglossary.4372">173</a><p>
+<div class="defnbox"><a id="wrglossary.21701"></a><a href="#glo:glsxtrsubsequentfmt"><code class="csfmt">\glsxtrsubsequentfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21702"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.21703"></a><a href="#glo:glsxtrgenabbrvfmt"><code class="csfmt">\glsxtrgenabbrvfmt</code></a> to display the subsequent singular form (defined by the abbreviation style). <a href="#wrglossary.4366">173</a><p>
+<div class="defnbox"><a id="wrglossary.21704"></a><a href="#glo:GLSxtrsubsequentplfmt"><code class="csfmt">\GLSxtrsubsequentplfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21705"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.21706"></a><a href="#glo:glsxtrgenabbrvfmt"><code class="csfmt">\glsxtrgenabbrvfmt</code></a> to display the <a id="wrglossary.21707"></a><a href="#glo:idx.allcaps">all caps</a> subsequent plural form (defined by the abbreviation style). <a href="#wrglossary.4384">173</a><p>
+<div class="defnbox"><a id="wrglossary.21708"></a><a href="#glo:Glsxtrsubsequentplfmt"><code class="csfmt">\Glsxtrsubsequentplfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21709"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.21710"></a><a href="#glo:glsxtrgenabbrvfmt"><code class="csfmt">\glsxtrgenabbrvfmt</code></a> to display the <a id="wrglossary.21711"></a><a href="#glo:idx.sentencecase">sentence case</a> subsequent plural form (defined by the abbreviation style). <a href="#wrglossary.4376">173</a><p>
+<div class="defnbox"><a id="wrglossary.21712"></a><a href="#glo:glsxtrsubsequentplfmt"><code class="csfmt">\glsxtrsubsequentplfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21713"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.21714"></a><a href="#glo:glsxtrgenabbrvfmt"><code class="csfmt">\glsxtrgenabbrvfmt</code></a> to display the subsequent plural form (defined by the abbreviation style). <a href="#wrglossary.4369">173</a><p>
+<div class="defnbox"><a id="wrglossary.21715"></a><a href="#glo:glsxtrSuperScriptDigitrules"><code class="csfmt">\glsxtrSuperScriptDigitrules</code></a><span class="floatrightbox"><a id="wrglossary.21716"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the 0–9 superscript digit character sort rules. <a href="#wrglossary.13299">545</a><p>
+<div class="defnbox"><a id="wrglossary.21717"></a><a href="#glo:glsxtrsupphypernumber"><code class="csfmt">\glsxtrsupphypernumber</code></a><code class="code">{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21718"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to hyperlink to a location in an external document if the <a id="wrglossary.21719"></a><a href="#glo:opt.catattr.externallocation"><span class="csoptfmt">externallocation</span></a> attribute has been set. This will define <a id="wrglossary.21720"></a><a href="#glo:glsxtrsupplocationurl"><code class="csfmt">\glsxtrsupplocationurl</code></a> to the location provided by the attribute or to empty if the attribute isn’t set. <a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.4961">195</a><p>
+<div class="defnbox"><a id="wrglossary.21721"></a><dfn id="glo:glsxtrsupplocationurl"><code class="csfmt">\glsxtrsupplocationurl</code></dfn><span class="floatrightbox"><a id="wrglossary.21722"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined by <a id="wrglossary.21723"></a><a href="#glo:glsxtrsupphypernumber"><code class="csfmt">\glsxtrsupphypernumber</code></a> to the external location or empty if not provided.<p>
+<div class="defnbox"><a id="wrglossary.21724"></a><a href="#glo:glsxtrtagfont"><code class="csfmt">\glsxtrtagfont</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used by the tagging command defined with <a id="wrglossary.21725"></a><a href="#glo:GlsXtrEnableInitialTagging"><code class="csfmt">\GlsXtrEnableInitialTagging</code></a>. <a href="#sec:tagging">§4.4</a>; <a href="#wrglossary.1711">58</a><p>
+<div class="defnbox"><a id="wrglossary.21726"></a><a href="#glo:glsxtrtaggedlist"><code class="csfmt">\glsxtrtaggedlist</code></a><code class="code">{<span class="meta">〈<em class="metainner">singular tag</em>〉</span>}{<span class="meta">〈<em class="metainner">plural tag</em>〉</span>}{<span class="meta">〈<em class="metainner">label prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">csv-list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21727"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.21728"></a><a href="#glo:glsseelist"><code class="csfmt">\glsseelist</code></a>, this will start the list with <span class="meta">〈<em class="metainner">singular tag</em>〉</span> if the list only contains one element and <span class="meta">〈<em class="metainner">plural tag</em>〉</span> if the list contains more than one element. Each element is prefixed with <span class="meta">〈<em class="metainner">label prefix</em>〉</span>. The tag is separated from the start of the list with <a id="wrglossary.21729"></a><a href="#glo:glsxtrtaggedlistsep"><code class="csfmt">\glsxtrtaggedlistsep</code></a>. The actual list separators as as for <a id="wrglossary.21730"></a><a href="#glo:glsseelist"><code class="csfmt">\glsseelist</code></a>. The <span class="meta">〈<em class="metainner">csv-list</em>〉</span> is expanded before being iterated over. Does nothing if <span class="meta">〈<em class="metainner">csv-list</em>〉</span> is empty. <a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7776">300</a><p>
+<div class="defnbox"><a id="wrglossary.21731"></a><a href="#glo:glsxtrtaggedlistsep"><code class="csfmt">\glsxtrtaggedlistsep</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\space</code>; <a id="wrglossary.21732"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Separator used by <a id="wrglossary.21733"></a><a href="#glo:glsxtrtaggedlist"><code class="csfmt">\glsxtrtaggedlist</code></a> between the tag and the list. <a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7777">300</a><p>
+<div class="defnbox"><a id="wrglossary.21734"></a><a href="#glo:GlsXtrTheLinkCounter"><code class="csfmt">\GlsXtrTheLinkCounter</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21735"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.26+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the value of the link counter associated with the given entry or 0 if it hasn’t been defined. <a href="#sec:linkcount">§6.2</a>; <a href="#wrglossary.8163">318</a><p>
+<div class="defnbox"><a id="wrglossary.21736"></a><a href="#glo:glsxtrtitlednamereflink"><code class="csfmt">\glsxtrtitlednamereflink</code></a><code class="code">{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}{<span class="meta">〈<em class="metainner">title</em>〉</span>}{<span class="meta">〈<em class="metainner">file</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21737"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.21738"></a><a href="#glo:glsxtrdisplaylocnameref"><code class="csfmt">\glsxtrdisplaylocnameref</code></a> to display locations that have a title and are not associated with the <a id="wrglossary.21739"></a><a href="#glo:ctr.page"><span class="ctrfmt">page</span></a> counter and don’t have an associated <a id="wrglossary.21740"></a><a href="#glo:glsxtrcounterlocfmt"><code class="csfmt">\glsxtr<span class="meta">〈<em class="metainner">counter</em>〉</span>locfmt</code></a> command. The anchor is obtained from <a id="wrglossary.21741"></a><a href="#glo:glsxtrrecentanchor"><code class="csfmt">\glsxtrrecentanchor</code></a>. <a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13627">559</a><p>
+<div class="defnbox"><a id="wrglossary.21742"></a><a href="#glo:GLSxtrtitlefirst"><code class="csfmt">\GLSxtrtitlefirst</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21743"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the <a id="wrglossary.21744"></a><a href="#glo:idx.allcaps">all caps</a> entry’s <a id="wrglossary.21745"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> <a id="wrglossary.21746"></a><a href="#glo:dual.field">field</a> in the section title and table of contents. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5783">226</a><p>
+<div class="defnbox"><a id="wrglossary.21747"></a><a href="#glo:Glsxtrtitlefirst"><code class="csfmt">\Glsxtrtitlefirst</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used to display the <a id="wrglossary.21748"></a><a href="#glo:idx.sentencecase">sentence case</a> entry’s <a id="wrglossary.21749"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> <a id="wrglossary.21750"></a><a href="#glo:dual.field">field</a> in the section title and table of contents. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5775">225</a><p>
+<div class="defnbox"><a id="wrglossary.21751"></a><a href="#glo:glsxtrtitlefirst"><code class="csfmt">\glsxtrtitlefirst</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used to display the entry’s <a id="wrglossary.21752"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> <a id="wrglossary.21753"></a><a href="#glo:dual.field">field</a> in the section title and table of contents. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5769">225</a><p>
+<div class="defnbox"><a id="wrglossary.21754"></a><a href="#glo:GLSxtrtitlefirstplural"><code class="csfmt">\GLSxtrtitlefirstplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21755"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the <a id="wrglossary.21756"></a><a href="#glo:idx.allcaps">all caps</a> entry’s <a id="wrglossary.21757"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> <a id="wrglossary.21758"></a><a href="#glo:dual.field">field</a> in the section title and table of contents. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5805">226</a><p>
+<div class="defnbox"><a id="wrglossary.21759"></a><a href="#glo:Glsxtrtitlefirstplural"><code class="csfmt">\Glsxtrtitlefirstplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used to display the <a id="wrglossary.21760"></a><a href="#glo:idx.sentencecase">sentence case</a> entry’s <a id="wrglossary.21761"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> <a id="wrglossary.21762"></a><a href="#glo:dual.field">field</a> in the section title and table of contents. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5797">226</a><p>
+<div class="defnbox"><a id="wrglossary.21763"></a><a href="#glo:glsxtrtitlefirstplural"><code class="csfmt">\glsxtrtitlefirstplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used to display the entry’s <a id="wrglossary.21764"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> <a id="wrglossary.21765"></a><a href="#glo:dual.field">field</a> in the section title and table of contents. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5791">226</a><p>
+<div class="defnbox"><a id="wrglossary.21766"></a><a href="#glo:GLSxtrtitlefull"><code class="csfmt">\GLSxtrtitlefull</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21767"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the entry’s <a id="wrglossary.21768"></a><a href="#glo:idx.allcaps">all caps</a> full form in the section title and table of contents. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5681">222</a><p>
+<div class="defnbox"><a id="wrglossary.21769"></a><a href="#glo:Glsxtrtitlefull"><code class="csfmt">\Glsxtrtitlefull</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21770"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the entry’s <a id="wrglossary.21771"></a><a href="#glo:idx.sentencecase">sentence case</a> full form in the section title and table of contents. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5675">222</a><p>
+<div class="defnbox"><a id="wrglossary.21772"></a><a href="#glo:glsxtrtitlefull"><code class="csfmt">\glsxtrtitlefull</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21773"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the entry’s full form in the section title and table of contents. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5671">221</a><p>
+<div class="defnbox"><a id="wrglossary.21774"></a><a href="#glo:GLSxtrtitlefullpl"><code class="csfmt">\GLSxtrtitlefullpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21775"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the entry’s <a id="wrglossary.21776"></a><a href="#glo:idx.allcaps">all caps</a> full plural form in the section title and table of contents. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5697">223</a><p>
+<div class="defnbox"><a id="wrglossary.21777"></a><a href="#glo:Glsxtrtitlefullpl"><code class="csfmt">\Glsxtrtitlefullpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21778"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the entry’s <a id="wrglossary.21779"></a><a href="#glo:idx.sentencecase">sentence case</a> full plural form in the section title and table of contents. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5691">222</a><p>
+<div class="defnbox"><a id="wrglossary.21780"></a><a href="#glo:glsxtrtitlefullpl"><code class="csfmt">\glsxtrtitlefullpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21781"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the entry’s full plural form in the section title and table of contents. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5687">222</a><p>
+<div class="defnbox"><a id="wrglossary.21782"></a><a href="#glo:GLSxtrtitlelong"><code class="csfmt">\GLSxtrtitlelong</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21783"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The normal behaviour of <a id="wrglossary.21784"></a><a href="#glo:GLSfmtlong"><code class="csfmt">\GLSfmtlong</code></a>. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5649">220</a><p>
+<div class="defnbox"><a id="wrglossary.21785"></a><a href="#glo:Glsxtrtitlelong"><code class="csfmt">\Glsxtrtitlelong</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21786"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The normal behaviour of <a id="wrglossary.21787"></a><a href="#glo:Glsfmtlong"><code class="csfmt">\Glsfmtlong</code></a>. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5643">220</a><p>
+<div class="defnbox"><a id="wrglossary.21788"></a><a href="#glo:glsxtrtitlelong"><code class="csfmt">\glsxtrtitlelong</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21789"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The normal behaviour of <a id="wrglossary.21790"></a><a href="#glo:glsfmtlong"><code class="csfmt">\glsfmtlong</code></a>. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5639">220</a><p>
+<div class="defnbox"><a id="wrglossary.21791"></a><a href="#glo:GLSxtrtitlelongpl"><code class="csfmt">\GLSxtrtitlelongpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21792"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The normal behaviour of <a id="wrglossary.21793"></a><a href="#glo:GLSfmtlongpl"><code class="csfmt">\GLSfmtlongpl</code></a>. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5665">221</a><p>
+<div class="defnbox"><a id="wrglossary.21794"></a><a href="#glo:Glsxtrtitlelongpl"><code class="csfmt">\Glsxtrtitlelongpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21795"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The normal behaviour of <a id="wrglossary.21796"></a><a href="#glo:Glsfmtlongpl"><code class="csfmt">\Glsfmtlongpl</code></a>. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5659">221</a><p>
+<div class="defnbox"><a id="wrglossary.21797"></a><a href="#glo:glsxtrtitlelongpl"><code class="csfmt">\glsxtrtitlelongpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21798"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The normal behaviour of <a id="wrglossary.21799"></a><a href="#glo:glsfmtlongpl"><code class="csfmt">\glsfmtlongpl</code></a>. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5655">221</a><p>
+<div class="defnbox"><a id="wrglossary.21800"></a><a href="#glo:GLSxtrtitlename"><code class="csfmt">\GLSxtrtitlename</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21801"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the <a id="wrglossary.21802"></a><a href="#glo:idx.allcaps">all caps</a> entry’s name in the section title and table of contents. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5717">223</a><p>
+<div class="defnbox"><a id="wrglossary.21803"></a><a href="#glo:Glsxtrtitlename"><code class="csfmt">\Glsxtrtitlename</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21804"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the <a id="wrglossary.21805"></a><a href="#glo:idx.sentencecase">sentence case</a> entry’s name in the section title and table of contents. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5709">223</a><p>
+<div class="defnbox"><a id="wrglossary.21806"></a><a href="#glo:glsxtrtitlename"><code class="csfmt">\glsxtrtitlename</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21807"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the entry’s name in the section title and table of contents. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5703">223</a><p>
+<div class="defnbox"><a id="wrglossary.21808"></a><a href="#glo:glsxtrtitleopts"><code class="csfmt">\glsxtrtitleopts</code></a><span class="floatrightbox"><a id="wrglossary.21809"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the options that commands like <a id="wrglossary.21810"></a><a href="#glo:glsfmtshort"><code class="csfmt">\glsfmtshort</code></a> should use in the title or caption within the document text. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5262">206</a><p>
+<div class="defnbox"><a id="wrglossary.21811"></a><a href="#glo:glsxtrtitleorpdforheading"><code class="csfmt">\glsxtrtitleorpdforheading</code></a><code class="code">{<span class="meta">〈<em class="metainner">title</em>〉</span>}{<span class="meta">〈<em class="metainner">PDF bookmarks</em>〉</span>}{<span class="meta">〈<em class="metainner">heading</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21812"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does the applicable argument depending on whether the command occurs within a title/caption or PDF bookmark or heading. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5496">215</a><p>
+<div class="defnbox"><a id="wrglossary.21813"></a><a href="#glo:GLSxtrtitleplural"><code class="csfmt">\GLSxtrtitleplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21814"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the <a id="wrglossary.21815"></a><a href="#glo:idx.allcaps">all caps</a> entry’s <a id="wrglossary.21816"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> <a id="wrglossary.21817"></a><a href="#glo:dual.field">field</a> in the section title and table of contents. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5761">225</a><p>
+<div class="defnbox"><a id="wrglossary.21818"></a><a href="#glo:Glsxtrtitleplural"><code class="csfmt">\Glsxtrtitleplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used to display the <a id="wrglossary.21819"></a><a href="#glo:idx.sentencecase">sentence case</a> entry’s <a id="wrglossary.21820"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> <a id="wrglossary.21821"></a><a href="#glo:dual.field">field</a> in the section title and table of contents. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5753">225</a><p>
+<div class="defnbox"><a id="wrglossary.21822"></a><a href="#glo:glsxtrtitleplural"><code class="csfmt">\glsxtrtitleplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used to display the entry’s <a id="wrglossary.21823"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> <a id="wrglossary.21824"></a><a href="#glo:dual.field">field</a> in the section title and table of contents. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5747">224</a><p>
+<div class="defnbox"><a id="wrglossary.21825"></a><a href="#glo:GLSxtrtitleshort"><code class="csfmt">\GLSxtrtitleshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21826"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The normal behaviour of <a id="wrglossary.21827"></a><a href="#glo:GLSfmtshort"><code class="csfmt">\GLSfmtshort</code></a>. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5593">218</a><p>
+<div class="defnbox"><a id="wrglossary.21828"></a><a href="#glo:Glsxtrtitleshort"><code class="csfmt">\Glsxtrtitleshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The normal behaviour of <a id="wrglossary.21829"></a><a href="#glo:Glsfmtshort"><code class="csfmt">\Glsfmtshort</code></a>. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5573">217</a><p>
+<div class="defnbox"><a id="wrglossary.21830"></a><a href="#glo:glsxtrtitleshort"><code class="csfmt">\glsxtrtitleshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The normal behaviour of <a id="wrglossary.21831"></a><a href="#glo:glsfmtshort"><code class="csfmt">\glsfmtshort</code></a>. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5552">217</a><p>
+<div class="defnbox"><a id="wrglossary.21832"></a><a href="#glo:GLSxtrtitleshortpl"><code class="csfmt">\GLSxtrtitleshortpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21833"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The normal behaviour of <a id="wrglossary.21834"></a><a href="#glo:GLSfmtshortpl"><code class="csfmt">\GLSfmtshortpl</code></a>. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5633">220</a><p>
+<div class="defnbox"><a id="wrglossary.21835"></a><a href="#glo:Glsxtrtitleshortpl"><code class="csfmt">\Glsxtrtitleshortpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The normal behaviour of <a id="wrglossary.21836"></a><a href="#glo:Glsfmtshortpl"><code class="csfmt">\Glsfmtshortpl</code></a>. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5627">219</a><p>
+<div class="defnbox"><a id="wrglossary.21837"></a><a href="#glo:glsxtrtitleshortpl"><code class="csfmt">\glsxtrtitleshortpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21838"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.03+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The normal behaviour of <a id="wrglossary.21839"></a><a href="#glo:glsfmtshortpl"><code class="csfmt">\glsfmtshortpl</code></a>. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5623">219</a><p>
+<div class="defnbox"><a id="wrglossary.21840"></a><a href="#glo:GLSxtrtitletext"><code class="csfmt">\GLSxtrtitletext</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21841"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to display the <a id="wrglossary.21842"></a><a href="#glo:idx.allcaps">all caps</a> entry’s <a id="wrglossary.21843"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> <a id="wrglossary.21844"></a><a href="#glo:dual.field">field</a> in the section title and table of contents. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5739">224</a><p>
+<div class="defnbox"><a id="wrglossary.21845"></a><a href="#glo:Glsxtrtitletext"><code class="csfmt">\Glsxtrtitletext</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used to display the <a id="wrglossary.21846"></a><a href="#glo:idx.sentencecase">sentence case</a> entry’s <a id="wrglossary.21847"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> <a id="wrglossary.21848"></a><a href="#glo:dual.field">field</a> in the section title and table of contents. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5731">224</a><p>
+<div class="defnbox"><a id="wrglossary.21849"></a><a href="#glo:glsxtrtitletext"><code class="csfmt">\glsxtrtitletext</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Used to display the entry’s <a id="wrglossary.21850"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> <a id="wrglossary.21851"></a><a href="#glo:dual.field">field</a> in the section title and table of contents. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5725">224</a><p>
+<div class="defnbox"><a id="wrglossary.21852"></a><a href="#glo:GlsXtrTotalRecordCount"><code class="csfmt">\GlsXtrTotalRecordCount</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21853"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the entry’s total record count (stored in the <a id="wrglossary.21854"></a><a href="#glo:opt.glosfield.recordcount"><span class="csoptfmt">recordcount</span></a> field) or to 0 if not set. <a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12754">523</a><p>
+<div class="defnbox"><a id="wrglossary.21855"></a><dfn id="glo:glsxtrtreechildpredesc"><code class="csfmt">\glsxtrtreechildpredesc</code></dfn><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glstreechildpredesc"><code class="csfmt">\glstreechildpredesc</code></a>; <a id="wrglossary.21856"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.46+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Inserted before the child descriptions for the <a id="wrglossary.21857"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a> styles.<p>
+<div class="defnbox"><a id="wrglossary.21858"></a><dfn id="glo:glsxtrtreepredesc"><code class="csfmt">\glsxtrtreepredesc</code></dfn><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glstreepredesc"><code class="csfmt">\glstreepredesc</code></a>; <a id="wrglossary.21859"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.46+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Inserted before the top-level descriptions for the <a id="wrglossary.21860"></a><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a> styles.<p>
+<div class="defnbox"><a id="wrglossary.21861"></a><a href="#glo:glsxtrundefaction"><code class="csfmt">\glsxtrundefaction</code></a><code class="code">{<span class="meta">〈<em class="metainner">message</em>〉</span>}{<span class="meta">〈<em class="metainner">additional help</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21862"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Will either produce an error or a warning, depending on the <a id="wrglossary.21863"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a> setting. In the <span class="envfmt">document</span> environment this will also generate the unknown marker (<a id="wrglossary.21864"></a><a href="#glo:idx.unknowntag"><code class="code">??</code></a>). <a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.362">16</a><p>
+<div class="defnbox"><a id="wrglossary.21865"></a><a href="#glo:glsxtrundeftag"><code class="csfmt">\glsxtrundeftag</code></a><span class="floatrightbox"><span class="summarytag">initial: </span>??; <a id="wrglossary.21866"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the unknown marker (<a id="wrglossary.21867"></a><a href="#glo:idx.unknowntag"><code class="code">??</code></a>). <a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.356">15</a><p>
+<div class="defnbox"><a id="wrglossary.21868"></a><a href="#glo:GlsXtrUnknownDialectWarning"><code class="csfmt">\GlsXtrUnknownDialectWarning</code></a><code class="code">{<span class="meta">〈<em class="metainner">locale</em>〉</span>}{<span class="meta">〈<em class="metainner">root language</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21869"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.32+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Issues a warning with <a id="wrglossary.21870"></a><a href="#glo:GlossariesExtraWarning"><code class="csfmt">\GlossariesExtraWarning</code></a> indicating that a valid dialect label can’t be determined for the given locale and root language. <a href="#sec:foreignfield">§5.12.1</a>; <a href="#wrglossary.7663">294</a><p>
+<div class="defnbox"><a id="wrglossary.21871"></a><a href="#glo:GlsXtrUnsetBufferDisableRepeatLocal"><code class="csfmt">\GlsXtrUnsetBufferDisableRepeatLocal</code></a><span class="floatrightbox"><a id="wrglossary.21872"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Disables GlsXtrUnsetBufferEnableRepeatLocal. <a href="#sec:unsetbuffer">§5.10.1</a>; <a href="#wrglossary.7482">286</a><p>
+<div class="defnbox"><a id="wrglossary.21873"></a><a href="#glo:GlsXtrUnsetBufferEnableRepeatLocal"><code class="csfmt">\GlsXtrUnsetBufferEnableRepeatLocal</code></a><span class="floatrightbox"><a id="wrglossary.21874"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Allows repeat entries within the buffering code to be locally unset before the <a id="wrglossary.21875"></a><a href="#glo:dual.linktext">link text</a>. <a href="#sec:unsetbuffer">§5.10.1</a>; <a href="#wrglossary.7476">285</a><p>
+<div class="defnbox"><a id="wrglossary.21876"></a><a href="#glo:glsxtrunsrtdo"><code class="csfmt">\glsxtrunsrtdo</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21877"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <a id="wrglossary.21878"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>, this displays the <a id="wrglossary.21879"></a><a href="#glo:dual.glossary">glossary</a> entry according to the current <a id="wrglossary.21880"></a><a href="#glo:idx.glossarystyle">glossary style</a> (taking the <a id="wrglossary.21881"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> into account, which may have been adjusted by <a id="wrglossary.21882"></a><a href="#glo:opt.printgloss.leveloffset"><span class="csoptfmt">leveloffset</span></a> or <a id="wrglossary.21883"></a><a href="#glo:opt.printgloss.flatten"><span class="csoptfmt">flatten</span></a>). <a href="#sec:printunsrtadvanced">§8.4.3</a>; <a href="#wrglossary.10268">402</a><p>
+<div class="defnbox"><a id="wrglossary.21884"></a><a href="#glo:glsxtrunusedformat"><code class="csfmt">\glsxtrunusedformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+The <a id="wrglossary.21885"></a><a href="#glo:@@glslabel@locationencap">format</a> used by <a id="wrglossary.21886"></a><a href="#glo:glsxtraddallcrossrefs"><code class="csfmt">\glsxtraddallcrossrefs</code></a>. <a href="#sec:glssee">§5.9.3</a>; <a href="#wrglossary.7329">279</a><p>
+<div class="defnbox"><a id="wrglossary.21887"></a><a href="#glo:glsxtrUpAlpha"><code class="csfmt">\glsxtrUpAlpha</code></a><span class="floatrightbox"><a id="wrglossary.21888"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright alpha. <a href="#wrglossary.13410">553</a><p>
+<div class="defnbox"><a id="wrglossary.21889"></a><a href="#glo:glsxtrUpBeta"><code class="csfmt">\glsxtrUpBeta</code></a><span class="floatrightbox"><a id="wrglossary.21890"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright beta. <a href="#wrglossary.13412">553</a><p>
+<div class="defnbox"><a id="wrglossary.21891"></a><a href="#glo:glsxtrUpChi"><code class="csfmt">\glsxtrUpChi</code></a><span class="floatrightbox"><a id="wrglossary.21892"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright chi. <a href="#wrglossary.13454">553</a><p>
+<div class="defnbox"><a id="wrglossary.21893"></a><a href="#glo:glsxtrUpDelta"><code class="csfmt">\glsxtrUpDelta</code></a><span class="floatrightbox"><a id="wrglossary.21894"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright delta. <a href="#wrglossary.13416">553</a><p>
+<div class="defnbox"><a id="wrglossary.21895"></a><a href="#glo:glsxtrUpDigamma"><code class="csfmt">\glsxtrUpDigamma</code></a><span class="floatrightbox"><a id="wrglossary.21896"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright digamma. <a href="#wrglossary.13420">553</a><p>
+<div class="defnbox"><a id="wrglossary.21897"></a><a href="#glo:glsxtrUpEpsilon"><code class="csfmt">\glsxtrUpEpsilon</code></a><span class="floatrightbox"><a id="wrglossary.21898"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright epsilon. <a href="#wrglossary.13418">553</a><p>
+<div class="defnbox"><a id="wrglossary.21899"></a><a href="#glo:glsxtrUpEta"><code class="csfmt">\glsxtrUpEta</code></a><span class="floatrightbox"><a id="wrglossary.21900"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright eta. <a href="#wrglossary.13424">553</a><p>
+<div class="defnbox"><a id="wrglossary.21901"></a><a href="#glo:glsxtrUpGamma"><code class="csfmt">\glsxtrUpGamma</code></a><span class="floatrightbox"><a id="wrglossary.21902"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright gamma. <a href="#wrglossary.13414">553</a><p>
+<div class="defnbox"><a id="wrglossary.21903"></a><a href="#glo:glsxtrUpIota"><code class="csfmt">\glsxtrUpIota</code></a><span class="floatrightbox"><a id="wrglossary.21904"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright iota. <a href="#wrglossary.13428">553</a><p>
+<div class="defnbox"><a id="wrglossary.21905"></a><a href="#glo:glsxtrUpKappa"><code class="csfmt">\glsxtrUpKappa</code></a><span class="floatrightbox"><a id="wrglossary.21906"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright kappa. <a href="#wrglossary.13430">553</a><p>
+<div class="defnbox"><a id="wrglossary.21907"></a><a href="#glo:glsxtrUpLambda"><code class="csfmt">\glsxtrUpLambda</code></a><span class="floatrightbox"><a id="wrglossary.21908"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright lambda. <a href="#wrglossary.13432">553</a><p>
+<div class="defnbox"><a id="wrglossary.21909"></a><a href="#glo:glsxtrUpMu"><code class="csfmt">\glsxtrUpMu</code></a><span class="floatrightbox"><a id="wrglossary.21910"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright mu. <a href="#wrglossary.13434">553</a><p>
+<div class="defnbox"><a id="wrglossary.21911"></a><a href="#glo:glsxtrUpNu"><code class="csfmt">\glsxtrUpNu</code></a><span class="floatrightbox"><a id="wrglossary.21912"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright nu. <a href="#wrglossary.13436">553</a><p>
+<div class="defnbox"><a id="wrglossary.21913"></a><a href="#glo:glsxtrUpOmega"><code class="csfmt">\glsxtrUpOmega</code></a><span class="floatrightbox"><a id="wrglossary.21914"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright omega. <a href="#wrglossary.13458">553</a><p>
+<div class="defnbox"><a id="wrglossary.21915"></a><a href="#glo:glsxtrUpOmicron"><code class="csfmt">\glsxtrUpOmicron</code></a><span class="floatrightbox"><a id="wrglossary.21916"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright omicron. <a href="#wrglossary.13440">553</a><p>
+<div class="defnbox"><a id="wrglossary.21917"></a><a href="#glo:glsxtrUpPhi"><code class="csfmt">\glsxtrUpPhi</code></a><span class="floatrightbox"><a id="wrglossary.21918"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright phi. <a href="#wrglossary.13452">553</a><p>
+<div class="defnbox"><a id="wrglossary.21919"></a><a href="#glo:glsxtrUpPi"><code class="csfmt">\glsxtrUpPi</code></a><span class="floatrightbox"><a id="wrglossary.21920"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright pi. <a href="#wrglossary.13442">553</a><p>
+<div class="defnbox"><a id="wrglossary.21921"></a><a href="#glo:glsxtrUpPsi"><code class="csfmt">\glsxtrUpPsi</code></a><span class="floatrightbox"><a id="wrglossary.21922"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright psi. <a href="#wrglossary.13456">553</a><p>
+<div class="defnbox"><a id="wrglossary.21923"></a><a href="#glo:glsxtrUpRho"><code class="csfmt">\glsxtrUpRho</code></a><span class="floatrightbox"><a id="wrglossary.21924"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright rho. <a href="#wrglossary.13444">553</a><p>
+<div class="defnbox"><a id="wrglossary.21925"></a><a href="#glo:glsxtrUpSigma"><code class="csfmt">\glsxtrUpSigma</code></a><span class="floatrightbox"><a id="wrglossary.21926"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright sigma. <a href="#wrglossary.13446">553</a><p>
+<div class="defnbox"><a id="wrglossary.21927"></a><a href="#glo:glsxtrUpTau"><code class="csfmt">\glsxtrUpTau</code></a><span class="floatrightbox"><a id="wrglossary.21928"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright tau. <a href="#wrglossary.13448">553</a><p>
+<div class="defnbox"><a id="wrglossary.21929"></a><a href="#glo:glsxtrUpTheta"><code class="csfmt">\glsxtrUpTheta</code></a><span class="floatrightbox"><a id="wrglossary.21930"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright theta. <a href="#wrglossary.13426">553</a><p>
+<div class="defnbox"><a id="wrglossary.21931"></a><a href="#glo:glsxtrUpUpsilon"><code class="csfmt">\glsxtrUpUpsilon</code></a><span class="floatrightbox"><a id="wrglossary.21932"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright upsilon. <a href="#wrglossary.13450">553</a><p>
+<div class="defnbox"><a id="wrglossary.21933"></a><a href="#glo:glsxtrUpXi"><code class="csfmt">\glsxtrUpXi</code></a><span class="floatrightbox"><a id="wrglossary.21934"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright xi. <a href="#wrglossary.13438">553</a><p>
+<div class="defnbox"><a id="wrglossary.21935"></a><a href="#glo:glsxtrUpZeta"><code class="csfmt">\glsxtrUpZeta</code></a><span class="floatrightbox"><a id="wrglossary.21936"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+(Sort rule) expands to the variations of math Greek upright zeta. <a href="#wrglossary.13422">553</a><p>
+<div class="defnbox"><a id="wrglossary.21937"></a><a href="#glo:GlsXtrUseAbbrStyleFmts"><code class="csfmt">\GlsXtrUseAbbrStyleFmts</code></a><code class="code">{<span class="meta">〈<em class="metainner">style-name</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Implements the <span class="meta">〈<em class="metainner">display definitions</em>〉</span> code for the given abbreviation style. <a href="#sec:advancedabbrstylecmds">§4.5.2</a>; <a href="#wrglossary.3970">160</a><p>
+<div class="defnbox"><a id="wrglossary.21938"></a><a href="#glo:GlsXtrUseAbbrStyleSetup"><code class="csfmt">\GlsXtrUseAbbrStyleSetup</code></a><code class="code">{<span class="meta">〈<em class="metainner">style-name</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Implements the <span class="meta">〈<em class="metainner">setup</em>〉</span> code for the given abbreviation style. <a href="#sec:advancedabbrstylecmds">§4.5.2</a>; <a href="#wrglossary.3968">159</a><p>
+<div class="defnbox"><a id="wrglossary.21939"></a><a href="#glo:glsxtrusealias"><code class="csfmt">\glsxtrusealias</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21940"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> has the <a id="wrglossary.21941"></a><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a> field set, this will display the cross reference according to <a id="wrglossary.21942"></a><a href="#glo:glsxtruseseeformat"><code class="csfmt">\glsxtruseseeformat</code></a>. <a href="#sec:getsee">§5.9.2</a>; <a href="#wrglossary.7260">277</a><p>
+<div class="defnbox"><a id="wrglossary.21943"></a><a href="#glo:GLSxtrusefield"><code class="csfmt">\GLSxtrusefield</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21944"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21945"></a><a href="#glo:glsxtrusefield"><code class="csfmt">\glsxtrusefield</code></a> but converts the field value to <a id="wrglossary.21946"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.7596">291</a><p>
+<div class="defnbox"><a id="wrglossary.21947"></a><a href="#glo:Glsxtrusefield"><code class="csfmt">\Glsxtrusefield</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21948"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21949"></a><a href="#glo:glsxtrusefield"><code class="csfmt">\glsxtrusefield</code></a> but uses <a id="wrglossary.21950"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.7587">291</a><p>
+<div class="defnbox"><a id="wrglossary.21951"></a><a href="#glo:glsxtrusefield"><code class="csfmt">\glsxtrusefield</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21952"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the value of the given <a id="wrglossary.21953"></a><a href="#glo:dual.field">field</a> (identified by its <a id="wrglossary.21954"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a> <span class="meta">〈<em class="metainner">field-label</em>〉</span>) for the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span>. Expands to <a id="wrglossary.21955"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a> if the entry or field are undefined. <a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.7582">291</a><p>
+<div class="defnbox"><a id="wrglossary.21956"></a><a href="#glo:glsxtruserfield"><code class="csfmt">\glsxtruserfield</code></a><span class="floatrightbox"><a id="wrglossary.21957"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the <a id="wrglossary.21958"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a> of the field used to store additional information for the <span class="qt">“user”</span> abbreviation styles, such as <a id="wrglossary.21959"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a>. <a href="#wrglossary.3339">135</a><p>
+<div class="defnbox"><a id="wrglossary.21960"></a><a href="#glo:glsxtruserfieldfmt"><code class="csfmt">\glsxtruserfieldfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21961"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to format the value of the field given by <a id="wrglossary.21962"></a><a href="#glo:glsxtruserfield"><code class="csfmt">\glsxtruserfield</code></a> within <a id="wrglossary.21963"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a> and <a id="wrglossary.21964"></a><a href="#glo:GLSxtruserparen"><code class="csfmt">\GLSxtruserparen</code></a>. <a href="#wrglossary.3344">135</a><p>
+<div class="defnbox"><a id="wrglossary.21965"></a><a href="#glo:GLSxtruserlongformat"><code class="csfmt">\GLSxtruserlongformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21966"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21967"></a><a href="#glo:glsxtruserlongformat"><code class="csfmt">\glsxtruserlongformat</code></a> but <a id="wrglossary.21968"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.3548">143</a><p>
+<div class="defnbox"><a id="wrglossary.21969"></a><a href="#glo:glsxtruserlongformat"><code class="csfmt">\glsxtruserlongformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21970"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the singular long form in parentheses (with <a id="wrglossary.21971"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a>) in styles like <a id="wrglossary.21972"></a><a href="#glo:opt.abbrstyle.short-long-user"><span class="abbrstylefmt">short-long-user</span></a>. <a href="#wrglossary.3538">143</a><p>
+<div class="defnbox"><a id="wrglossary.21973"></a><a href="#glo:GLSxtruserlongplformat"><code class="csfmt">\GLSxtruserlongplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21974"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21975"></a><a href="#glo:glsxtruserlongplformat"><code class="csfmt">\glsxtruserlongplformat</code></a> but <a id="wrglossary.21976"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.3561">144</a><p>
+<div class="defnbox"><a id="wrglossary.21977"></a><a href="#glo:glsxtruserlongplformat"><code class="csfmt">\glsxtruserlongplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21978"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the plural long form in parentheses (with <a id="wrglossary.21979"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a>) in styles like <a id="wrglossary.21980"></a><a href="#glo:opt.abbrstyle.short-long-user"><span class="abbrstylefmt">short-long-user</span></a>. <a href="#wrglossary.3553">143</a><p>
+<div class="defnbox"><a id="wrglossary.21981"></a><a href="#glo:GLSxtruserlongshortformat"><code class="csfmt">\GLSxtruserlongshortformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21982"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21983"></a><a href="#glo:glsxtruserlongshortformat"><code class="csfmt">\glsxtruserlongshortformat</code></a> but <a id="wrglossary.21984"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.3452">139</a><p>
+<div class="defnbox"><a id="wrglossary.21985"></a><a href="#glo:Glsxtruserlongshortformat"><code class="csfmt">\Glsxtruserlongshortformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21986"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21987"></a><a href="#glo:glsxtruserlongshortformat"><code class="csfmt">\glsxtruserlongshortformat</code></a> but <a id="wrglossary.21988"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#wrglossary.3450">139</a><p>
+<div class="defnbox"><a id="wrglossary.21989"></a><a href="#glo:glsxtruserlongshortformat"><code class="csfmt">\glsxtruserlongshortformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21990"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by styles like <a id="wrglossary.21991"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a> to format the long and short form. <a href="#wrglossary.3442">139</a><p>
+<div class="defnbox"><a id="wrglossary.21992"></a><a href="#glo:GLSxtruserlongshortplformat"><code class="csfmt">\GLSxtruserlongshortplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21993"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21994"></a><a href="#glo:glsxtruserlongshortplformat"><code class="csfmt">\glsxtruserlongshortplformat</code></a> but <a id="wrglossary.21995"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.3464">140</a><p>
+<div class="defnbox"><a id="wrglossary.21996"></a><a href="#glo:Glsxtruserlongshortplformat"><code class="csfmt">\Glsxtruserlongshortplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.21997"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.21998"></a><a href="#glo:glsxtruserlongshortplformat"><code class="csfmt">\glsxtruserlongshortplformat</code></a> but <a id="wrglossary.21999"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#wrglossary.3462">140</a><p>
+<div class="defnbox"><a id="wrglossary.22000"></a><a href="#glo:glsxtruserlongshortplformat"><code class="csfmt">\glsxtruserlongshortplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22001"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by styles like <a id="wrglossary.22002"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a> to format the plural long and plural short form. <a href="#wrglossary.3454">140</a><p>
+<div class="defnbox"><a id="wrglossary.22003"></a><a href="#glo:GLSxtruserparen"><code class="csfmt">\GLSxtruserparen</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22004"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22005"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a> but the value of the field given by <a id="wrglossary.22006"></a><a href="#glo:glsxtruserfield"><code class="csfmt">\glsxtruserfield</code></a> is converted to <a id="wrglossary.22007"></a><a href="#glo:idx.allcaps">all caps</a>. The <span class="meta">〈<em class="metainner">text</em>〉</span> argument should already be in <a id="wrglossary.22008"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.3404">138</a><p>
+<div class="defnbox"><a id="wrglossary.22009"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22010"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by the <span class="qt">“user”</span> abbreviation styles, such as <a id="wrglossary.22011"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a>, to insert the space separator (<a id="wrglossary.22012"></a><a href="#glo:glsxtrfullsep"><code class="csfmt">\glsxtrfullsep</code></a>) followed by the parenthetical material (<a id="wrglossary.22013"></a><a href="#glo:glsxtrparen"><code class="csfmt">\glsxtrparen</code></a>) consisting of <span class="meta">〈<em class="metainner">text</em>〉</span> and, if set, the value of the field given by <a id="wrglossary.22014"></a><a href="#glo:glsxtruserfield"><code class="csfmt">\glsxtruserfield</code></a>, separated by <a id="wrglossary.22015"></a><a href="#glo:glsxtruserparensep"><code class="csfmt">\glsxtruserparensep</code></a>. <a href="#wrglossary.3394">137</a><p>
+<div class="defnbox"><a id="wrglossary.22016"></a><a href="#glo:glsxtruserparensep"><code class="csfmt">\glsxtruserparensep</code></a><span class="floatrightbox"><a id="wrglossary.22017"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The separator used in the parenthetical content of <a id="wrglossary.22018"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a> and <a id="wrglossary.22019"></a><a href="#glo:GLSxtruserparen"><code class="csfmt">\GLSxtruserparen</code></a>. <a href="#wrglossary.3343">135</a><p>
+<div class="defnbox"><a id="wrglossary.22020"></a><a href="#glo:GLSxtrusershortformat"><code class="csfmt">\GLSxtrusershortformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22021"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22022"></a><a href="#glo:glsxtrusershortformat"><code class="csfmt">\glsxtrusershortformat</code></a> but <a id="wrglossary.22023"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.3508">142</a><p>
+<div class="defnbox"><a id="wrglossary.22024"></a><a href="#glo:glsxtrusershortformat"><code class="csfmt">\glsxtrusershortformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22025"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the singular short form in parentheses (with <a id="wrglossary.22026"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a>) in styles like <a id="wrglossary.22027"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a>. <a href="#wrglossary.3490">141</a><p>
+<div class="defnbox"><a id="wrglossary.22028"></a><a href="#glo:GLSxtrusershortlongformat"><code class="csfmt">\GLSxtrusershortlongformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22029"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22030"></a><a href="#glo:glsxtrusershortlongformat"><code class="csfmt">\glsxtrusershortlongformat</code></a> but <a id="wrglossary.22031"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.3476">141</a><p>
+<div class="defnbox"><a id="wrglossary.22032"></a><a href="#glo:Glsxtrusershortlongformat"><code class="csfmt">\Glsxtrusershortlongformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22033"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22034"></a><a href="#glo:glsxtrusershortlongformat"><code class="csfmt">\glsxtrusershortlongformat</code></a> but <a id="wrglossary.22035"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#wrglossary.3474">141</a><p>
+<div class="defnbox"><a id="wrglossary.22036"></a><a href="#glo:glsxtrusershortlongformat"><code class="csfmt">\glsxtrusershortlongformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22037"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by styles like <a id="wrglossary.22038"></a><a href="#glo:opt.abbrstyle.short-long-user"><span class="abbrstylefmt">short-long-user</span></a> to format the short and long form. <a href="#wrglossary.3466">140</a><p>
+<div class="defnbox"><a id="wrglossary.22039"></a><a href="#glo:GLSxtrusershortlongplformat"><code class="csfmt">\GLSxtrusershortlongplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22040"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22041"></a><a href="#glo:glsxtrusershortlongplformat"><code class="csfmt">\glsxtrusershortlongplformat</code></a> but <a id="wrglossary.22042"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.3488">141</a><p>
+<div class="defnbox"><a id="wrglossary.22043"></a><a href="#glo:Glsxtrusershortlongplformat"><code class="csfmt">\Glsxtrusershortlongplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22044"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22045"></a><a href="#glo:glsxtrusershortlongplformat"><code class="csfmt">\glsxtrusershortlongplformat</code></a> but <a id="wrglossary.22046"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#wrglossary.3486">141</a><p>
+<div class="defnbox"><a id="wrglossary.22047"></a><a href="#glo:glsxtrusershortlongplformat"><code class="csfmt">\glsxtrusershortlongplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}{<span class="meta">〈<em class="metainner">long-fmt-cs</em>〉</span>}{<span class="meta">〈<em class="metainner">short-fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22048"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by styles like <a id="wrglossary.22049"></a><a href="#glo:opt.abbrstyle.short-long-user"><span class="abbrstylefmt">short-long-user</span></a> to format the plural short and plural long form. <a href="#wrglossary.3478">141</a><p>
+<div class="defnbox"><a id="wrglossary.22050"></a><a href="#glo:GLSxtrusershortplformat"><code class="csfmt">\GLSxtrusershortplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22051"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22052"></a><a href="#glo:glsxtrusershortplformat"><code class="csfmt">\glsxtrusershortplformat</code></a> but <a id="wrglossary.22053"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#wrglossary.3515">142</a><p>
+<div class="defnbox"><a id="wrglossary.22054"></a><a href="#glo:glsxtrusershortplformat"><code class="csfmt">\glsxtrusershortplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">fmt-cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22055"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the plural short form in parentheses (with <a id="wrglossary.22056"></a><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a>) in styles like <a id="wrglossary.22057"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a>. <a href="#wrglossary.3501">142</a><p>
+<div class="defnbox"><a id="wrglossary.22058"></a><a href="#glo:glsxtrusersuffix"><code class="csfmt">\glsxtrusersuffix</code></a><span class="floatrightbox"><span class="summarytag">initial: </span><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a>; <a id="wrglossary.22059"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The plural suffix used by styles like <a id="wrglossary.22060"></a><a href="#glo:opt.abbrstyle.short-long-user"><span class="abbrstylefmt">short-long-user</span></a>. <a href="#wrglossary.3359">136</a><p>
+<div class="defnbox"><a id="wrglossary.22061"></a><a href="#glo:glsxtrusesee"><code class="csfmt">\glsxtrusesee</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22062"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.06+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> has the <a id="wrglossary.22063"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> field set, this will display the cross reference according to <a id="wrglossary.22064"></a><a href="#glo:glsxtruseseeformat"><code class="csfmt">\glsxtruseseeformat</code></a>. <a href="#sec:getsee">§5.9.2</a>; <a href="#wrglossary.7255">277</a><p>
+<div class="defnbox"><a id="wrglossary.22065"></a><a href="#glo:glsxtruseseealso"><code class="csfmt">\glsxtruseseealso</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22066"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.16+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> has the <a id="wrglossary.22067"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> field set, this will display the cross reference according to <a id="wrglossary.22068"></a><a href="#glo:glsxtruseseealsoformat"><code class="csfmt">\glsxtruseseealsoformat</code></a>. <a href="#sec:getsee">§5.9.2</a>; <a href="#wrglossary.7263">277</a><p>
+<div class="defnbox"><a id="wrglossary.22069"></a><a href="#glo:glsxtruseseealsoformat"><code class="csfmt">\glsxtruseseealsoformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">csv-list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22070"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.16+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formats the comma-separated list of entry labels as a <span class="qt">“see also”</span> cross-reference. <a href="#sec:getsee">§5.9.2</a>; <a href="#wrglossary.7276">278</a><p>
+<div class="defnbox"><a id="wrglossary.22071"></a><dfn id="glo:glsxtruseseeformat"><code class="csfmt">\glsxtruseseeformat</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">tag</em>〉</span>}{<span class="meta">〈<em class="metainner">xr-list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22072"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.06+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Format used by <a id="wrglossary.22073"></a><a href="#glo:glsxtrusesee"><code class="csfmt">\glsxtrusesee</code></a>. This internally uses <a id="wrglossary.22074"></a><a href="#glo:glsseeformat"><code class="csfmt">\glsseeformat</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.22075"></a><a href="#glo:GlsXtrWarnDeprecatedAbbrStyle"><code class="csfmt">\GlsXtrWarnDeprecatedAbbrStyle</code></a><code class="code">{<span class="meta">〈<em class="metainner">old-name</em>〉</span>}{<span class="meta">〈<em class="metainner">new-name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22076"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Issues a warning with <a id="wrglossary.22077"></a><a href="#glo:GlossariesExtraWarning"><code class="csfmt">\GlossariesExtraWarning</code></a> indicating that a deprecated abbreviation style has been used. <a href="#sec:advancedabbrstylecmds">§4.5.2</a>; <a href="#wrglossary.3984">160</a><p>
+<div class="defnbox"><a id="wrglossary.22078"></a><a href="#glo:GlsXtrWarning"><code class="csfmt">\GlsXtrWarning</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">entry</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Issues a warning with <a id="wrglossary.22079"></a><a href="#glo:GlossariesExtraWarning"><code class="csfmt">\GlossariesExtraWarning</code></a> indicating that the given options list has been ignored by the given entry because it has already been defined. <a href="#sec:onthefly">§13</a>; <a href="#wrglossary.14114">579</a><p>
+<div class="defnbox"><a id="wrglossary.22080"></a><a href="#glo:glsxtrword"><code class="csfmt">\glsxtrword</code></a><code class="code">{<span class="meta">〈<em class="metainner">word</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22081"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to mark each word by the <a id="wrglossary.22082"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a> and <a id="wrglossary.22083"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a> attributes. <a href="#sec:abbrattr">§10.2.1.1</a>; <a href="#wrglossary.12107">496</a><p>
+<div class="defnbox"><a id="wrglossary.22084"></a><a href="#glo:glsxtrwordsep"><code class="csfmt">\glsxtrwordsep</code></a><span class="floatrightbox"><a id="wrglossary.22085"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to mark word separator space by the <a id="wrglossary.22086"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a> and <a id="wrglossary.22087"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a> attributes. <a href="#sec:abbrattr">§10.2.1.1</a>; <a href="#wrglossary.12106">496</a><p>
+<div class="defnbox"><a id="wrglossary.22088"></a><dfn id="glo:glsxtrwordsephyphen"><code class="csfmt">\glsxtrwordsephyphen</code></dfn><span class="floatrightbox"><a id="wrglossary.22089"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to mark compound word separator hyphen by the <a id="wrglossary.22090"></a><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a> and <a id="wrglossary.22091"></a><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a> attributes.<p>
+<div class="defnbox"><a id="wrglossary.22092"></a><dfn id="glo:glsxtrwrglossaryhook"><code class="csfmt">\glsxtrwrglossaryhook</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Hook implemented everytime an entry is indexed.<p>
+<div class="defnbox"><a id="wrglossary.22093"></a><a href="#glo:glsxtrwrglossarylocfmt"><code class="csfmt">\glsxtrwrglossarylocfmt</code></a><code class="code">{<span class="meta">〈<em class="metainner">location</em>〉</span>}{<span class="meta">〈<em class="metainner">title</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22094"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by <a id="wrglossary.22095"></a><a href="#glo:glsxtrdisplaylocnameref"><code class="csfmt">\glsxtrdisplaylocnameref</code></a> to format a <a id="wrglossary.22096"></a><a href="#glo:@@glslabel@entrylocation">location</a> where the counter is <a id="wrglossary.22097"></a><a href="#glo:ctr.wrglossary"><span class="ctrfmt">wrglossary</span></a>. <a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13619">559</a><p>
+<div class="defnbox"><a id="wrglossary.22098"></a><a href="#glo:glsxtrwrglosscountermark"><code class="csfmt">\glsxtrwrglosscountermark</code></a><code class="code">{<span class="meta">〈<em class="metainner">number</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22099"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to mark where the <a id="wrglossary.22100"></a><a href="#glo:ctr.wrglossary"><span class="ctrfmt">wrglossary</span></a> counter is incrememented with <a id="wrglossary.22101"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.22102"></a><a href="#glo:optval.debug.showwrgloss"><span class="optfmt">showwrgloss</span></a>. <a href="#sec:debuggingopts">§2.5</a>; <a href="#wrglossary.880">29</a><p>
+<div class="defnbox"><a id="wrglossary.22103"></a><a href="#glo:glsxtrwrglossmark"><code class="csfmt">\glsxtrwrglossmark</code></a><span class="floatrightbox"><a id="wrglossary.22104"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Marker (·) used to mark write operations with <a id="wrglossary.22105"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.22106"></a><a href="#glo:optval.debug.showwrgloss"><span class="optfmt">showwrgloss</span></a>. <a href="#sec:debuggingopts">§2.5</a>; <a href="#wrglossary.877">29</a><p>
+
+</section><!-- end of section summary.index7143424 -->
+
+<section id="summary.index7208960"><!-- start of section summary.index7208960 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->H<div class="labellink"><a href="#summary.index7208960">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.22107"></a><dfn id="glo:hyperbf"><code class="csfmt">\hyperbf</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">location(s)</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22108"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If hyperlinks are supported this does <code class="code"><span class="cmdfmt">\textbf</span>{<a id="wrglossary.22109"></a><a href="#glo:glshypernumber"><code class="csfmt">\glshypernumber</code></a>{<span class="meta">〈<em class="metainner">location(s)</em>〉</span>}}</code> otherwise it just does <code class="code"><span class="cmdfmt">\textbf</span>{<span class="meta">〈<em class="metainner">location(s)</em>〉</span>}</code>.<p>
+
+</section><!-- end of section summary.index7208960 -->
+
+<section id="summary.index7274496"><!-- start of section summary.index7274496 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->I<div class="labellink"><a href="#summary.index7274496">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.22110"></a><dfn id="glo:ifglossaryexists"><code class="csfmt">\ifglossaryexists</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">glossary-type</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.22111"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If the <a id="wrglossary.22112"></a><a href="#glo:dual.glossary">glossary</a> given by <span class="meta">〈<em class="metainner">glossary-type</em>〉</span> exists, this does <span class="meta">〈<em class="metainner">true</em>〉</span>, otherwise it does <span class="meta">〈<em class="metainner">false</em>〉</span>. The unstarred form treats <a id="wrglossary.22113"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a> as non-existent. The starred form (v4.46+) will do <span class="meta">〈<em class="metainner">true</em>〉</span> if <span class="meta">〈<em class="metainner">glossary-type</em>〉</span> matches an ignored glossary.<p>
+<div class="defnbox"><a id="wrglossary.22114"></a><dfn id="glo:ifglsentryexists"><code class="csfmt">\ifglsentryexists</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22115"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the entry given by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> exists, otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>.<p>
+<div class="defnbox"><a id="wrglossary.22116"></a><dfn id="glo:ifglsfieldcseq"><code class="csfmt">\ifglsfieldcseq</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">cs-name</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22117"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.16+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Tests if the value of the given field is equal to the replacement text of the command given by the control sequence name <span class="meta">〈<em class="metainner">cs-name</em>〉</span> using <a id="wrglossary.22118"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <code class="csfmt">\ifcsstrequal</code>. Triggers an error if the given field (identified by its <a id="wrglossary.22119"></a><a href="#glo:dual.internalfieldlabel">internal field label</a>) hasn’t been defined. Uses <a id="wrglossary.22120"></a><a href="#glo:glsdoifexists"><code class="csfmt">\glsdoifexists</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.22121"></a><dfn id="glo:ifglsfielddefeq"><code class="csfmt">\ifglsfielddefeq</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22122"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.16+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Tests if the value of the given field is equal to the replacement text of the given command <span class="meta">〈<em class="metainner">cs</em>〉</span> using <a id="wrglossary.22123"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <code class="csfmt">\ifdefstrequal</code>. Triggers an error if the given field (identified by its <a id="wrglossary.22124"></a><a href="#glo:dual.internalfieldlabel">internal field label</a>) hasn’t been defined. Uses <a id="wrglossary.22125"></a><a href="#glo:glsdoifexists"><code class="csfmt">\glsdoifexists</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.22126"></a><dfn id="glo:ifglsfieldeq"><code class="csfmt">\ifglsfieldeq</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">string</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22127"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.16+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Tests if the value of the given field is equal to the given string using <a id="wrglossary.22128"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span>’s</a> <a id="wrglossary.22129"></a><a href="#glo:ifcsstring"><code class="csfmt">\ifcsstring</code></a>. Triggers an error if the given field (identified by its <a id="wrglossary.22130"></a><a href="#glo:dual.internalfieldlabel">internal field label</a>) hasn’t been defined. Uses <a id="wrglossary.22131"></a><a href="#glo:glsdoifexists"><code class="csfmt">\glsdoifexists</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.22132"></a><dfn id="glo:ifglsfieldvoid"><code class="csfmt">\ifglsfieldvoid</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22133"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+An expandable test to determine if the entry is undefined or the field is undefined or empty. The <span class="meta">〈<em class="metainner">field-label</em>〉</span> must be the field’s <a id="wrglossary.22134"></a><a href="#glo:@@glslabel@internalfieldlabel">internal label</a>.<p>
+<div class="defnbox"><a id="wrglossary.22135"></a><dfn id="glo:ifglshaschildren"><code class="csfmt">\ifglshaschildren</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22136"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the given entry has child entries otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>. Note that this has to iterate over the set of defined entries for the entry’s <a id="wrglossary.22137"></a><a href="#glo:dual.glossary">glossary</a> to find one that has the entry identified in its <a id="wrglossary.22138"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> field. A more efficient approach can be achieved with <a id="wrglossary.22139"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> and the <a id="wrglossary.22140"></a><a href="#glo:opt.resource.save-child-count"><span class="csoptfmt">save-child-count</span></a> resource option.<p>
+<div class="defnbox"><a id="wrglossary.22141"></a><dfn id="glo:ifglshasdesc"><code class="csfmt">\ifglshasdesc</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22142"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.08a+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the entry’s <a id="wrglossary.22143"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> field is set otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>.<p>
+<div class="defnbox"><a id="wrglossary.22144"></a><dfn id="glo:ifglshasdescsuppressed"><code class="csfmt">\ifglshasdescsuppressed</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22145"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.08a+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the entry’s <a id="wrglossary.22146"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> field is just <a id="wrglossary.22147"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a> otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>.<p>
+<div class="defnbox"><a id="wrglossary.22148"></a><dfn id="glo:ifglshasfield"><code class="csfmt">\ifglshasfield</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22149"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.03+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If the field identified by either its key or its <a id="wrglossary.22150"></a><a href="#glo:dual.internalfieldlabel">internal field label</a> <span class="meta">〈<em class="metainner">field</em>〉</span> for the entry identified by <span class="meta">〈<em class="metainner">entry-label</em>〉</span> is set and non-empty, this sets <a id="wrglossary.22151"></a><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a> to the field value and does <span class="meta">〈<em class="metainner">true</em>〉</span> otherwise it does <span class="meta">〈<em class="metainner">false</em>〉</span>.<p>
+<div class="defnbox"><a id="wrglossary.22152"></a><dfn id="glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22153"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.11a+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the entry’s <a id="wrglossary.22154"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> field is set otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>.<p>
+<div class="defnbox"><a id="wrglossary.22155"></a><dfn id="glo:ifglshasparent"><code class="csfmt">\ifglshasparent</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22156"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the entry’s <a id="wrglossary.22157"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> field is set otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>.<p>
+<div class="defnbox"><a id="wrglossary.22158"></a><dfn id="glo:ifglshasshort"><code class="csfmt">\ifglshasshort</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22159"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.11a+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the entry’s <a id="wrglossary.22160"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> field is set otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>.<p>
+<div class="defnbox"><a id="wrglossary.22161"></a><dfn id="glo:ifglshassymbol"><code class="csfmt">\ifglshassymbol</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22162"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.08a+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the entry’s <a id="wrglossary.22163"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> field is set otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>.<p>
+<div class="defnbox"><a id="wrglossary.22164"></a><a href="#glo:ifglsindexonlyfirst"><code class="csfmt">\ifglsindexonlyfirst</code></a><code class="code"> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\iffalse</code>; <a id="wrglossary.22165"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A conditional that corresponds to the <a id="wrglossary.22166"></a><a href="#glo:opt.indexonlyfirst"><span class="styoptfmt">indexonlyfirst</span></a> option. <a href="#sec:wrglossary">§5.8</a>; <a href="#wrglossary.6933">265</a><p>
+<div class="defnbox"><a id="wrglossary.22167"></a><a href="#glo:ifGlsLongExtraUseTabular"><code class="csfmt">\ifGlsLongExtraUseTabular</code></a><code class="code"> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\iffalse</code>; <a id="wrglossary.22168"></a><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span></a> v1.37+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Conditional that determines whether or not to use <a id="wrglossary.22169"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a> instead of <a id="wrglossary.22170"></a><a href="#glo:env.longtable"><span class="envfmt">longtable</span></a>. If this conditional is changed, it must be changed before the style is set. <a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11206">445</a><p>
+<div class="defnbox"><a id="wrglossary.22171"></a><dfn id="glo:ifglsnogroupskip"><code class="csfmt">\ifglsnogroupskip</code></dfn><code class="code"> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\iffalse</code>; <a id="wrglossary.22172"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.03+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Conditional set by the <a id="wrglossary.22173"></a><a href="#glo:opt.nogroupskip"><span class="styoptfmt">nogroupskip</span></a> option.<p>
+<div class="defnbox"><a id="wrglossary.22174"></a><a href="#glo:ifglsresetcurrcount"><code class="csfmt">\ifglsresetcurrcount</code></a><code class="code"> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\iffalse</code>; <a id="wrglossary.22175"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Conditional that determines whether or not to reset the entry counter to 0 when the <a id="wrglossary.22176"></a><a href="#glo:dual.firstuseflag">first use flag</a> is reset. <a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.7952">308</a><p>
+<div class="defnbox"><a id="wrglossary.22177"></a><dfn id="glo:ifglsused"><code class="csfmt">\ifglsused</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22178"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the entry has been marked as <a id="wrglossary.22179"></a><a href="#glo:@@glslabel@firstuseflag">used</a>, does <span class="meta">〈<em class="metainner">false</em>〉</span> if the entry is marked as <a id="wrglossary.22180"></a><a href="#glo:@@glslabel@firstuseflag">unused</a>, and does neither if the entry hasn’t been defined (but will generate an error or warning according to <a id="wrglossary.22181"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a>).<p>
+<div class="defnbox"><a id="wrglossary.22182"></a><a href="#glo:ifglsxtrinitwrglossbefore"><code class="csfmt">\ifglsxtrinitwrglossbefore</code></a><code class="code"> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\iftrue</code>; <a id="wrglossary.22183"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.14+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A conditional that indicates whether or not <a id="wrglossary.22184"></a><a href="#glo:opt.glsopt.wrgloss"><span class="csoptfmt">wrgloss</span></a><span class="optfmt">=before</span> is set. <a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.4933">194</a><p>
+<div class="defnbox"><a id="wrglossary.22185"></a><a href="#glo:ifglsxtrinsertinside"><code class="csfmt">\ifglsxtrinsertinside</code></a><code class="code"> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\iffalse</code>; <a id="wrglossary.22186"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.02</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A conditional used by the predefined abbreviation styles to determine whether the <span class="meta">〈<em class="metainner">insert</em>〉</span> part should go inside or outside of the style’s font formatting commands. <a href="#wrglossary.3254">131</a><p>
+<div class="defnbox"><a id="wrglossary.22187"></a><a href="#glo:ifGlsXtrPrefixLabelFallbackLast"><code class="csfmt">\ifGlsXtrPrefixLabelFallbackLast</code></a><code class="code"> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\iftrue</code>; <a id="wrglossary.22188"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Conditional that determines whether or not to use the last label prefix as the default. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13743">563</a><p>
+<div class="defnbox"><a id="wrglossary.22189"></a><a href="#glo:ifglsxtrprintglossflatten"><code class="csfmt">\ifglsxtrprintglossflatten</code></a><code class="code"> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\iffalse</code>; <a id="wrglossary.22190"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Conditional set by the <a id="wrglossary.22191"></a><a href="#glo:opt.printgloss.flatten"><span class="csoptfmt">flatten</span></a> option. <a href="#sec:printunsrtadvanced">§8.4.3</a>; <a href="#wrglossary.10273">402</a><p>
+<div class="defnbox"><a id="wrglossary.22192"></a><a href="#glo:ifmglsused"><code class="csfmt">\ifmglsused</code></a><code class="code">{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22193"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the given multi-entry has been marked as used, otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:mglsfirstuse">§7.7</a>; <a href="#wrglossary.8845">352</a><p>
+<div class="defnbox"><a id="wrglossary.22194"></a><a href="#glo:ifmultiglossaryentryglobal"><code class="csfmt">\ifmultiglossaryentryglobal</code></a><code class="code"> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\iffalse</code>; <a id="wrglossary.22195"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If true, subsequent multi-entry definitions will be global. <a href="#sec:multientries">§7</a>; <a href="#wrglossary.8282">325</a><p>
+<div class="defnbox"><a id="wrglossary.22196"></a><a href="#glo:IfTeXParserLib"><code class="csfmt">\IfTeXParserLib</code></a><code class="code">{<span class="meta">〈<em class="metainner">TeX parser lib code</em>〉</span>}{<span class="meta">〈<em class="metainner">LaTeX code</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22197"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined by <a id="wrglossary.22198"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> to <span class="meta">〈<em class="metainner">LaTeX code</em>〉</span> but defined by <a id="wrglossary.22199"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span>’s</a> interpreter to expand to <span class="meta">〈<em class="metainner">TeX parser lib code</em>〉</span>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13939">572</a><p>
+<div class="defnbox"><a id="wrglossary.22200"></a><dfn id="glo:indexname"><code class="csfmt">\indexname</code></dfn><span class="floatrightbox"><span class="summarytag">initial: </span>Index</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(language-sensitive)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Expands to the index title.<p>
+<div class="defnbox"><a id="wrglossary.22201"></a><a href="#glo:Iota"><code class="csfmt">\Iota</code></a><span class="floatrightbox"><a id="wrglossary.22202"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.22203"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a>, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{I}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13976">573</a><p>
+
+</section><!-- end of section summary.index7274496 -->
+
+<section id="summary.index7405568"><!-- start of section summary.index7405568 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->K<div class="labellink"><a href="#summary.index7405568">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.22204"></a><a href="#glo:Kappa"><code class="csfmt">\Kappa</code></a><span class="floatrightbox"><a id="wrglossary.22205"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.22206"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a>, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{K}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13977">573</a><p>
+
+</section><!-- end of section summary.index7405568 -->
+
+<section id="summary.index7471104"><!-- start of section summary.index7471104 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->L<div class="labellink"><a href="#summary.index7471104">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.22207"></a><a href="#glo:letabbreviationstyle"><code class="csfmt">\letabbreviationstyle</code></a><code class="code">{<span class="meta">〈<em class="metainner">new style</em>〉</span>}{<span class="meta">〈<em class="metainner">existing style</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22208"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines a synonym for an existing abbreviation style. <a href="#sec:newabbrvstyle">§4.5.3</a>; <a href="#wrglossary.3990">161</a><p>
+<div class="defnbox"><a id="wrglossary.22209"></a><dfn id="glo:loadglsentries"><code class="csfmt">\loadglsentries</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">type</em>〉</span>]{<span class="meta">〈<em class="metainner">filename</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22210"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally assigns <a id="wrglossary.22211"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a> to <span class="meta">〈<em class="metainner">type</em>〉</span> and inputs <span class="meta">〈<em class="metainner">filename</em>〉</span>. If the optional argument is omitted, the default glossary is assumed. Note that if any entries with <span class="meta">〈<em class="metainner">filename</em>〉</span> have the <a id="wrglossary.22212"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> key set (including implicitly in commands like <a id="wrglossary.22213"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>), then this will override the type given in the optional argument.<p>
+<div class="defnbox"><a id="wrglossary.22214"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">key=value list</em>〉</span>}{<span class="meta">〈<em class="metainner">description</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22215"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.11a</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines a new <a id="wrglossary.22216"></a><a href="#glo:dual.glossary">glossary</a> entry with the given label. The second argument is a comma-separated list of <a id="wrglossary.22217"></a><a href="#glo:idx.gloskey">glossary entry keys</a>. The third argument is the description, which may include paragraph breaks. <a href="#sec:newentrydefs">§3.1</a>; <a href="#wrglossary.933">32</a><p>
+<div class="defnbox"><a id="wrglossary.22218"></a><a href="#glo:longnewglossaryentry*"><code class="csfmt">\longnewglossaryentry*</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">key=value list</em>〉</span>}{<span class="meta">〈<em class="metainner">description</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22219"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like the unstarred <a id="wrglossary.22220"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a> but doesn’t add the <a id="wrglossary.22221"></a><a href="#glo:glsxtrpostlongdescription"><code class="csfmt">\glsxtrpostlongdescription</code></a> hook. <a href="#sec:newentrydefs">§3.1</a>; <a href="#wrglossary.941">32</a><p>
+
+</section><!-- end of section summary.index7471104 -->
+
+<section id="summary.index7536640"><!-- start of section summary.index7536640 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->M<div class="labellink"><a href="#summary.index7536640">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.22222"></a><a href="#glo:MakeAcronymsAbbreviations"><code class="csfmt">\MakeAcronymsAbbreviations</code></a></div><!-- end of defnbox -->
+<p>
+Counteracts <a id="wrglossary.22223"></a><a href="#glo:RestoreAcronyms"><code class="csfmt">\RestoreAcronyms</code></a>. Not recommended. <a href="#sec:acrorevert">§4.6</a>; <a href="#wrglossary.4571">182</a><p>
+<div class="defnbox"><a id="wrglossary.22224"></a><dfn id="glo:makefirstuc"><code class="csfmt">\makefirstuc</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22225"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Robust command that converts the first character of <span class="meta">〈<em class="metainner">text</em>〉</span> to <a id="wrglossary.22226"></a><a href="#glo:idx.uppercase">uppercase</a><a id="wrglossary.22227"></a> unless <span class="meta">〈<em class="metainner">text</em>〉</span> starts with a command, in which case it will attempt to apply the <a id="wrglossary.22228"></a><a href="#glo:idx.casechange">case change</a> to the first character of the first argument following the command, if the command is followed by a group. As from <a id="wrglossary.22229"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08, this command internally uses <a id="wrglossary.22230"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> to perform the actual case-change. See the <a id="wrglossary.22231"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> documentation for further details, either: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div><a href="https://www.tug.org/texdoc/">texdoc</a> mfirstuc</pre> or visit <a href="https://ctan.org/pkg/mfirstuc">ctan.org/pkg/mfirstuc</a>.<p>
+<div class="defnbox"><a id="wrglossary.22232"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a><code class="code">[<span class="meta">〈<em class="metainner">types</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.22233"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Opens the associated <a id="wrglossary.22234"></a><a href="#glo:dual.glossary">glossary</a> files that need to be processed by <a id="wrglossary.22235"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.22236"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. The optional argument is only available with <a id="wrglossary.22237"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and is used for a hybrid approach. All <a id="wrglossary.22238"></a><a href="#glo:dual.glossary">glossaries</a> (or each <a id="wrglossary.22239"></a><a href="#glo:dual.glossary">glossary</a> identified in <span class="meta">〈<em class="metainner">types</em>〉</span>) should be displayed with <a id="wrglossary.22240"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>. If the optional argument is present, any <a id="wrglossary.22241"></a><a href="#glo:dual.glossary">glossaries</a> not identified in <span class="meta">〈<em class="metainner">types</em>〉</span> should be displayed with <a id="wrglossary.22242"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>. <a href="#sec:glossaries">§8</a>; <a href="#wrglossary.9411">375</a><p>
+<div class="defnbox"><a id="wrglossary.22243"></a><dfn id="glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></dfn><span class="floatrightbox"><a id="wrglossary.22244"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets up all non-<a id="wrglossary.22245"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a> so that they can be displayed with <a id="wrglossary.22246"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.22247"></a><dfn id="glo:mfirstucMakeUppercase"><code class="csfmt">\mfirstucMakeUppercase</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22248"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This command was used by <a id="wrglossary.22249"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> to convert its argument to <a id="wrglossary.22250"></a><a href="#glo:idx.allcaps">all caps</a> and was redefined by <a id="wrglossary.22251"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> to use <a id="wrglossary.22252"></a><a href="#glo:MakeTextUppercase"><code class="csfmt">\MakeTextUppercase</code></a>, but with <a id="wrglossary.22253"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+ and <a id="wrglossary.22254"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ this command is instead defined to use the LaTeX3 <a id="wrglossary.22255"></a><a href="#glo:idx.allcaps">all caps</a> command, which is expandable. This command is no longer used by <a id="wrglossary.22256"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> (which instead uses <a id="wrglossary.22257"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>) or by <a id="wrglossary.22258"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ (which now uses <a id="wrglossary.22259"></a><a href="#glo:glsuppercase"><code class="csfmt">\glsuppercase</code></a> for <a id="wrglossary.22260"></a><a href="#glo:idx.allcaps">all caps</a> commands such as <a id="wrglossary.22261"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a>).<p>
+<div class="defnbox"><a id="wrglossary.22262"></a><dfn id="glo:MFUaddmap"><code class="csfmt">\MFUaddmap</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">cs1</em>〉</span>}{<span class="meta">〈<em class="metainner">cs2</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22263"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Identifies a mapping from the command <span class="meta">〈<em class="metainner">cs1</em>〉</span> to command <span class="meta">〈<em class="metainner">cs2</em>〉</span> for <a id="wrglossary.22264"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> and also identifies <span class="meta">〈<em class="metainner">cs2</em>〉</span> as a blocker. Mappings and blockers aren’t supported by <a id="wrglossary.22265"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>, so both <span class="meta">〈<em class="metainner">cs1</em>〉</span> and <span class="meta">〈<em class="metainner">cs2</em>〉</span> are identified as exclusions for <a id="wrglossary.22266"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.22267"></a><dfn id="glo:MFUblocker"><code class="csfmt">\MFUblocker</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22268"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally identifies <span class="meta">〈<em class="metainner">cs</em>〉</span> as a blocker command for <a id="wrglossary.22269"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> and an exclusion for <a id="wrglossary.22270"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> (which doesn’t support blockers).<p>
+<div class="defnbox"><a id="wrglossary.22271"></a><dfn id="glo:MFUexcl"><code class="csfmt">\MFUexcl</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22272"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally identifies <span class="meta">〈<em class="metainner">cs</em>〉</span> as an exclusion command, which will be recognised by both <a id="wrglossary.22273"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> and <a id="wrglossary.22274"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.22275"></a><dfn id="glo:MFUsave"><code class="csfmt">\MFUsave</code></dfn><span class="floatrightbox"><a id="wrglossary.22276"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Saves the list of exclusions, blockers and mappings to the <a id="wrglossary.22277"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file (if required by some external tool, such as <a id="wrglossary.22278"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>). This command sets itself to <code class="cmd">\relax</code> so it doesn’t repeat the action if used multiple times, and counteracts any use of <a id="wrglossary.22279"></a><a href="#glo:MFUsaveatend"><code class="csfmt">\MFUsaveatend</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.22280"></a><dfn id="glo:MFUsaveatend"><code class="csfmt">\MFUsaveatend</code></dfn><span class="floatrightbox"><a id="wrglossary.22281"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Saves the list of exclusions, blockers and mappings to the <a id="wrglossary.22282"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file (if required by some external tool, such as <a id="wrglossary.22283"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>) at the end of the document. This command sets itself to <code class="cmd">\relax</code> so it doesn’t repeat the action if used multiple times, but it can be overridden by <a id="wrglossary.22284"></a><a href="#glo:MFUsave"><code class="csfmt">\MFUsave</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.22285"></a><dfn id="glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22286"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Fully expands <span class="meta">〈<em class="metainner">text</em>〉</span> and converts the first letter to <a id="wrglossary.22287"></a><a href="#glo:idx.uppercase">uppercase</a><a id="wrglossary.22288"></a>. Unlike <a id="wrglossary.22289"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>, this command is expandable, but only recognises commands identified as exclusions. See the <a id="wrglossary.22290"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> documentation for further details. This command is provided by <a id="wrglossary.22291"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+ if an old version of <a id="wrglossary.22292"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> is detected.<p>
+<div class="defnbox"><a id="wrglossary.22293"></a><a href="#glo:MGLS"><code class="csfmt">\MGLS</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22294"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22295"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22296"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22297"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22298"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses <a id="wrglossary.22299"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a> for each element. <a href="#sec:mglsbasic">§7.11.1</a>; <a href="#wrglossary.9076">364</a><p>
+<div class="defnbox"><a id="wrglossary.22300"></a><a href="#glo:MGls"><code class="csfmt">\MGls</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22301"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22302"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22303"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22304"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22305"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses <a id="wrglossary.22306"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> for all elements. <a href="#sec:mglsbasic">§7.11.1</a>; <a href="#wrglossary.9045">363</a><p>
+<div class="defnbox"><a id="wrglossary.22307"></a><a href="#glo:Mgls"><code class="csfmt">\Mgls</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22308"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22309"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22310"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22311"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22312"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses <a id="wrglossary.22313"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> for the first element. <a href="#sec:mglsbasic">§7.11.1</a>; <a href="#wrglossary.9039">363</a><p>
+<div class="defnbox"><a id="wrglossary.22314"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22315"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22316"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22317"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22318"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+References a multi-entry identified by the given <span class="meta">〈<em class="metainner">multi-label</em>〉</span>. <a href="#sec:multientries">§7</a>; <a href="#wrglossary.8258">323</a><p>
+<div class="defnbox"><a id="wrglossary.22319"></a><a href="#glo:mglsAddOptions"><code class="csfmt">\mglsAddOptions</code></a><code class="code">{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}{<span class="meta">〈<em class="metainner">new-options</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22320"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally appends to the options associated with the given multi-entry. <a href="#sec:multientries">§7</a>; <a href="#wrglossary.8284">325</a><p>
+<div class="defnbox"><a id="wrglossary.22321"></a><a href="#glo:mglscurrentcategory"><code class="csfmt">\mglscurrentcategory</code></a><span class="floatrightbox"><a id="wrglossary.22322"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Placeholder command for use in multi-entry hooks, this expands to the multi-entry category current in effect. <a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8780">348</a><p>
+<div class="defnbox"><a id="wrglossary.22323"></a><a href="#glo:mglscurrentlabel"><code class="csfmt">\mglscurrentlabel</code></a><span class="floatrightbox"><a id="wrglossary.22324"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Placeholder command for use in multi-entry hooks, this expands to the current element label. <a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8789">348</a><p>
+<div class="defnbox"><a id="wrglossary.22325"></a><a href="#glo:mglscurrentlist"><code class="csfmt">\mglscurrentlist</code></a><span class="floatrightbox"><a id="wrglossary.22326"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Placeholder command for use in multi-entry hooks, this expands to the complete comma-separated list of elements. <a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8776">347</a><p>
+<div class="defnbox"><a id="wrglossary.22327"></a><a href="#glo:mglscurrentmainlabel"><code class="csfmt">\mglscurrentmainlabel</code></a><span class="floatrightbox"><a id="wrglossary.22328"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Placeholder command for use in multi-entry hooks, this expands to the label of the main element. <a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8775">347</a><p>
+<div class="defnbox"><a id="wrglossary.22329"></a><a href="#glo:mglscurrentmultilabel"><code class="csfmt">\mglscurrentmultilabel</code></a><span class="floatrightbox"><a id="wrglossary.22330"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Placeholder command for use in multi-entry hooks, this expands to the multi-entry label. <a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8774">347</a><p>
+<div class="defnbox"><a id="wrglossary.22331"></a><a href="#glo:mglscurrentoptions"><code class="csfmt">\mglscurrentoptions</code></a><span class="floatrightbox"><a id="wrglossary.22332"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Placeholder command for use in multi-entry hooks, this expands to the options used when the multi-entry was defined. <a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8777">347</a><p>
+<div class="defnbox"><a id="wrglossary.22333"></a><a href="#glo:mglscurrentprefix"><code class="csfmt">\mglscurrentprefix</code></a><span class="floatrightbox"><a id="wrglossary.22334"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Placeholder command for use in multi-entry hooks, this expands to the current prefix. <a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8791">348</a><p>
+<div class="defnbox"><a id="wrglossary.22335"></a><a href="#glo:mglscurrentsuffix"><code class="csfmt">\mglscurrentsuffix</code></a><span class="floatrightbox"><a id="wrglossary.22336"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Placeholder command for use in multi-entry hooks, this expands to the current suffix. <a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8792">348</a><p>
+<div class="defnbox"><a id="wrglossary.22337"></a><a href="#glo:mglscustompostlinkhook"><code class="csfmt">\mglscustompostlinkhook</code></a><span class="floatrightbox"><a id="wrglossary.22338"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook used with the <a id="wrglossary.22339"></a><a href="#glo:opt.mglsopt.mpostlinkelement"><span class="csoptfmt">mpostlinkelement</span></a><span class="optfmt">=custom</span> option. <a href="#sec:mglspostlinkhook">§7.6</a>; <a href="#wrglossary.8798">349</a><p>
+<div class="defnbox"><a id="wrglossary.22340"></a><a href="#glo:mglsdefcategoryprefix"><code class="csfmt">\mglsdefcategoryprefix</code></a><code class="code">{<span class="meta">〈<em class="metainner">category-label</em>〉</span>}{<span class="meta">〈<em class="metainner">definition</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22341"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines the prefix for the given multi-entry category. <a href="#sec:mglsfixes">§7.3</a>; <a href="#wrglossary.8643">341</a><p>
+<div class="defnbox"><a id="wrglossary.22342"></a><a href="#glo:mglsdefcategorysuffix"><code class="csfmt">\mglsdefcategorysuffix</code></a><code class="code">{<span class="meta">〈<em class="metainner">category-label</em>〉</span>}{<span class="meta">〈<em class="metainner">definition</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22343"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines the suffix for the given multi-entry category. <a href="#sec:mglsfixes">§7.3</a>; <a href="#wrglossary.8645">341</a><p>
+<div class="defnbox"><a id="wrglossary.22344"></a><a href="#glo:mglselementindex"><code class="csfmt">\mglselementindex</code></a><span class="floatrightbox"><a id="wrglossary.22345"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A count register used in multi-entry hooks, this is set to the element index. <a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8790">348</a><p>
+<div class="defnbox"><a id="wrglossary.22346"></a><a href="#glo:mglselementposthook"><code class="csfmt">\mglselementposthook</code></a><span class="floatrightbox"><a id="wrglossary.22347"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook performed after each (non-skipped) element in a multi-entry set. <a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8768">347</a><p>
+<div class="defnbox"><a id="wrglossary.22348"></a><a href="#glo:mglselementprehook"><code class="csfmt">\mglselementprehook</code></a><span class="floatrightbox"><a id="wrglossary.22349"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook performed before each (non-skipped) element in a multi-entry set. <a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8767">347</a><p>
+<div class="defnbox"><a id="wrglossary.22350"></a><a href="#glo:mglselementreset"><code class="csfmt">\mglselementreset</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22351"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by options such as <a id="wrglossary.22352"></a><a href="#glo:opt.mglsopt.resetall"><span class="csoptfmt">resetall</span></a> to reset an element’s <a id="wrglossary.22353"></a><a href="#glo:dual.firstuseflag">first use flag</a> (taking the <a id="wrglossary.22354"></a><a href="#glo:opt.mglsopt.presetlocal"><span class="csoptfmt">presetlocal</span></a> option into account). <a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.9012">362</a><p>
+<div class="defnbox"><a id="wrglossary.22355"></a><a href="#glo:mglselementunset"><code class="csfmt">\mglselementunset</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22356"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used by options such as <a id="wrglossary.22357"></a><a href="#glo:opt.mglsopt.unsetall"><span class="csoptfmt">unsetall</span></a> to unset an element’s <a id="wrglossary.22358"></a><a href="#glo:dual.firstuseflag">first use flag</a> (taking the <a id="wrglossary.22359"></a><a href="#glo:opt.mglsopt.presetlocal"><span class="csoptfmt">presetlocal</span></a> option into account). <a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.9013">362</a><p>
+<div class="defnbox"><a id="wrglossary.22360"></a><a href="#glo:mglsfield"><code class="csfmt">\mglsfield</code></a><span class="floatrightbox"><span class="summarytag">initial: </span>useri; <a id="wrglossary.22361"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the <a id="wrglossary.22362"></a><a href="#glo:dual.internalfieldlabel">internal field label</a> required by <a id="wrglossary.22363"></a><a href="#glo:mglsusefield"><code class="csfmt">\mglsusefield</code></a>. <a href="#sec:mglsotherfields">§7.11.3</a>; <a href="#wrglossary.9178">366</a><p>
+<div class="defnbox"><a id="wrglossary.22364"></a><a href="#glo:mglsforelements"><code class="csfmt">\mglsforelements</code></a><code class="code">{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">body</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22365"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Iterates over the list of element labels for the multi-entry identified by <span class="meta">〈<em class="metainner">multi-label</em>〉</span>. <a href="#sec:multiextras">§7.13</a>; <a href="#wrglossary.9329">370</a><p>
+<div class="defnbox"><a id="wrglossary.22366"></a><a href="#glo:mglsforotherelements"><code class="csfmt">\mglsforotherelements</code></a><code class="code">{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">body</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22367"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22368"></a><a href="#glo:mglsforelements"><code class="csfmt">\mglsforelements</code></a> but skips the main entry label. <a href="#sec:multiextras">§7.13</a>; <a href="#wrglossary.9332">371</a><p>
+<div class="defnbox"><a id="wrglossary.22369"></a><a href="#glo:Mglsfull"><code class="csfmt">\Mglsfull</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22370"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22371"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22372"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22373"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22374"></a><a href="#glo:mglsfull"><code class="csfmt">\mglsfull</code></a> but <a id="wrglossary.22375"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#sec:mglsabbrv">§7.11.2</a>; <a href="#wrglossary.9126">365</a><p>
+<div class="defnbox"><a id="wrglossary.22376"></a><a href="#glo:mglsfull"><code class="csfmt">\mglsfull</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22377"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22378"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22379"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22380"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22381"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses <a id="wrglossary.22382"></a><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a> for any elements that have the <a id="wrglossary.22383"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> field set and <a id="wrglossary.22384"></a><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a> otherwise. <a href="#sec:mglsabbrv">§7.11.2</a>; <a href="#wrglossary.9107">364</a><p>
+<div class="defnbox"><a id="wrglossary.22385"></a><a href="#glo:mglshascategoryprefix"><code class="csfmt">\mglshascategoryprefix</code></a><code class="code">{<span class="meta">〈<em class="metainner">category-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22386"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the given multi-entry category has a prefix set otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:mglsfixes">§7.3</a>; <a href="#wrglossary.8648">342</a><p>
+<div class="defnbox"><a id="wrglossary.22387"></a><a href="#glo:mglshascategorysuffix"><code class="csfmt">\mglshascategorysuffix</code></a><code class="code">{<span class="meta">〈<em class="metainner">category-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22388"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <span class="meta">〈<em class="metainner">true</em>〉</span> if the given multi-entry category has a suffix set otherwise does <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:mglsfixes">§7.3</a>; <a href="#wrglossary.8651">342</a><p>
+<div class="defnbox"><a id="wrglossary.22389"></a><a href="#glo:mglsiflast"><code class="csfmt">\mglsiflast</code></a><code class="code">{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22390"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use in multi-entry hooks, this expands to <span class="meta">〈<em class="metainner">true</em>〉</span> if this is the last iteration otherwise expands to <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8793">349</a><p>
+<div class="defnbox"><a id="wrglossary.22391"></a><a href="#glo:mglsiflastelementcapscase"><code class="csfmt">\mglsiflastelementcapscase</code></a><code class="code">{<span class="meta">〈<em class="metainner">no-change</em>〉</span>}{<span class="meta">〈<em class="metainner">firstuc</em>〉</span>}{<span class="meta">〈<em class="metainner">all caps</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22392"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use in multi-entry suffix and post-link hooks, this expands to the <span class="meta">〈<em class="metainner">no-change</em>〉</span> if the last element had no case-change applied, to <span class="meta">〈<em class="metainner">firstuc</em>〉</span> if the last element had <a id="wrglossary.22393"></a><a href="#glo:idx.sentencecase">sentence case</a> applied or to <span class="meta">〈<em class="metainner">all caps</em>〉</span> if the last element had <a id="wrglossary.22394"></a><a href="#glo:idx.allcaps">all caps</a> applied. <a href="#sec:mglspostlinkhooklastelement">§7.6.1</a>; <a href="#wrglossary.8827">351</a><p>
+<div class="defnbox"><a id="wrglossary.22395"></a><a href="#glo:mglsiflastelementskipped"><code class="csfmt">\mglsiflastelementskipped</code></a><code class="code">{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22396"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use in multi-entry suffix and post-link hooks, this expands to the <span class="meta">〈<em class="metainner">true</em>〉</span> if the last element was skipped, otherwise to <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:mglspostlinkhooklastelement">§7.6.1</a>; <a href="#wrglossary.8822">350</a><p>
+<div class="defnbox"><a id="wrglossary.22397"></a><a href="#glo:mglsiflastelementwasfirstuse"><code class="csfmt">\mglsiflastelementwasfirstuse</code></a><code class="code">{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22398"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use in multi-entry suffix and post-link hooks, this expands to the <span class="meta">〈<em class="metainner">true</em>〉</span> if the last element was used for the first time, otherwise to <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:mglspostlinkhooklastelement">§7.6.1</a>; <a href="#wrglossary.8823">350</a><p>
+<div class="defnbox"><a id="wrglossary.22399"></a><a href="#glo:mglsiflastelementwasplural"><code class="csfmt">\mglsiflastelementwasplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22400"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use in multi-entry suffix and post-link hooks, this expands to the <span class="meta">〈<em class="metainner">true</em>〉</span> if the last element had the plural form displayed, otherwise to <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:mglspostlinkhooklastelement">§7.6.1</a>; <a href="#wrglossary.8825">351</a><p>
+<div class="defnbox"><a id="wrglossary.22401"></a><a href="#glo:mglsiflastmaincapscase"><code class="csfmt">\mglsiflastmaincapscase</code></a><code class="code">{<span class="meta">〈<em class="metainner">no-change</em>〉</span>}{<span class="meta">〈<em class="metainner">firstuc</em>〉</span>}{<span class="meta">〈<em class="metainner">all caps</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22402"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use in multi-entry suffix and post-link hooks, this expands to the <span class="meta">〈<em class="metainner">no-change</em>〉</span> if the main element from the multi-entry just referenced had no case-change applied, to <span class="meta">〈<em class="metainner">firstuc</em>〉</span> if the last element had <a id="wrglossary.22403"></a><a href="#glo:idx.sentencecase">sentence case</a> applied or to <span class="meta">〈<em class="metainner">all caps</em>〉</span> if the last element had <a id="wrglossary.22404"></a><a href="#glo:idx.allcaps">all caps</a> applied. <a href="#sec:mglspostlinkhookmainelement">§7.6.2</a>; <a href="#wrglossary.8836">352</a><p>
+<div class="defnbox"><a id="wrglossary.22405"></a><a href="#glo:mglsiflastmainskipped"><code class="csfmt">\mglsiflastmainskipped</code></a><code class="code">{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22406"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use in multi-entry suffix and post-link hooks, this expands to the <span class="meta">〈<em class="metainner">true</em>〉</span> if the main element from the multi-entry just referenced was skipped, otherwise to <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:mglspostlinkhookmainelement">§7.6.2</a>; <a href="#wrglossary.8831">351</a><p>
+<div class="defnbox"><a id="wrglossary.22407"></a><a href="#glo:mglsiflastmainwasfirstuse"><code class="csfmt">\mglsiflastmainwasfirstuse</code></a><code class="code">{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22408"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use in multi-entry suffix and post-link hooks, this expands to the <span class="meta">〈<em class="metainner">true</em>〉</span> if the main element from the multi-entry just referenced was used for the first time, otherwise to <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:mglspostlinkhookmainelement">§7.6.2</a>; <a href="#wrglossary.8832">351</a><p>
+<div class="defnbox"><a id="wrglossary.22409"></a><a href="#glo:mglsiflastmainwasplural"><code class="csfmt">\mglsiflastmainwasplural</code></a><code class="code">{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22410"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use in multi-entry suffix and post-link hooks, this expands to the <span class="meta">〈<em class="metainner">true</em>〉</span> if the main element from the multi-entry just referenced had the plural form shown, otherwise to <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:mglspostlinkhookmainelement">§7.6.2</a>; <a href="#wrglossary.8834">352</a><p>
+<div class="defnbox"><a id="wrglossary.22411"></a><a href="#glo:mglsisfirstuse"><code class="csfmt">\mglsisfirstuse</code></a><code class="code">{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22412"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use in multi-entry hooks, this expands to <span class="meta">〈<em class="metainner">true</em>〉</span> if this is the first use otherwise expands to <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8782">348</a><p>
+<div class="defnbox"><a id="wrglossary.22413"></a><a href="#glo:mglslastcategory"><code class="csfmt">\mglslastcategory</code></a><span class="floatrightbox"><a id="wrglossary.22414"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use in multi-entry suffix and post-link hooks, this expands to the multi-entry category or nothing, if no category assigned. <a href="#sec:mglspostlinkhook">§7.6</a>; <a href="#wrglossary.8819">350</a><p>
+<div class="defnbox"><a id="wrglossary.22415"></a><a href="#glo:mglslastelementlabel"><code class="csfmt">\mglslastelementlabel</code></a><span class="floatrightbox"><a id="wrglossary.22416"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use in multi-entry suffix and post-link hooks, this expands to the label of the last non-skipped element. <a href="#sec:mglspostlinkhooklastelement">§7.6.1</a>; <a href="#wrglossary.8821">350</a><p>
+<div class="defnbox"><a id="wrglossary.22417"></a><a href="#glo:mglslastelementpostlinkhook"><code class="csfmt">\mglslastelementpostlinkhook</code></a><span class="floatrightbox"><a id="wrglossary.22418"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook used with the <a id="wrglossary.22419"></a><a href="#glo:opt.mglsopt.mpostlinkelement"><span class="csoptfmt">mpostlinkelement</span></a><span class="optfmt">=last</span> option. <a href="#sec:mglspostlinkhook">§7.6</a>; <a href="#wrglossary.8800">349</a><p>
+<div class="defnbox"><a id="wrglossary.22420"></a><a href="#glo:mglslastmainlabel"><code class="csfmt">\mglslastmainlabel</code></a><span class="floatrightbox"><a id="wrglossary.22421"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use in multi-entry suffix and post-link hooks, this expands to the label of the main element that was just referenced. <a href="#sec:mglspostlinkhookmainelement">§7.6.2</a>; <a href="#wrglossary.8829">351</a><p>
+<div class="defnbox"><a id="wrglossary.22422"></a><a href="#glo:mglslastmainpostlinkhook"><code class="csfmt">\mglslastmainpostlinkhook</code></a><span class="floatrightbox"><a id="wrglossary.22423"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook used with the <a id="wrglossary.22424"></a><a href="#glo:opt.mglsopt.mpostlinkelement"><span class="csoptfmt">mpostlinkelement</span></a><span class="optfmt">=main</span> option. <a href="#sec:mglspostlinkhook">§7.6</a>; <a href="#wrglossary.8802">349</a><p>
+<div class="defnbox"><a id="wrglossary.22425"></a><a href="#glo:mglslastmultilabel"><code class="csfmt">\mglslastmultilabel</code></a><span class="floatrightbox"><a id="wrglossary.22426"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use in multi-entry suffix and post-link hooks, this expands to the multi-entry label. <a href="#sec:mglspostlinkhook">§7.6</a>; <a href="#wrglossary.8818">350</a><p>
+<div class="defnbox"><a id="wrglossary.22427"></a><a href="#glo:mglslocalreset"><code class="csfmt">\mglslocalreset</code></a><code class="code">{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22428"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally resets the first use flag for the given multi-entry. <a href="#sec:mglsfirstuse">§7.7</a>; <a href="#wrglossary.8849">353</a><p>
+<div class="defnbox"><a id="wrglossary.22429"></a><a href="#glo:mglslocalunset"><code class="csfmt">\mglslocalunset</code></a><code class="code">{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22430"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally unsets the first use flag for the given multi-entry. <a href="#sec:mglsfirstuse">§7.7</a>; <a href="#wrglossary.8848">353</a><p>
+<div class="defnbox"><a id="wrglossary.22431"></a><a href="#glo:mglslocalunsetothers"><code class="csfmt">\mglslocalunsetothers</code></a><code class="code">{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22432"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally unsets the <a id="wrglossary.22433"></a><a href="#glo:dual.firstuseflag">first use flag</a> for the other (not main) elements of the given multi-entry. <a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.9016">362</a><p>
+<div class="defnbox"><a id="wrglossary.22434"></a><a href="#glo:Mglslong"><code class="csfmt">\Mglslong</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22435"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22436"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22437"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22438"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22439"></a><a href="#glo:mglslong"><code class="csfmt">\mglslong</code></a> but <a id="wrglossary.22440"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#sec:mglsabbrv">§7.11.2</a>; <a href="#wrglossary.9120">365</a><p>
+<div class="defnbox"><a id="wrglossary.22441"></a><a href="#glo:mglslong"><code class="csfmt">\mglslong</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22442"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22443"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22444"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22445"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22446"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses <a id="wrglossary.22447"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> for any elements that have the <a id="wrglossary.22448"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> field set and <a id="wrglossary.22449"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> otherwise. <a href="#sec:mglsabbrv">§7.11.2</a>; <a href="#wrglossary.9100">364</a><p>
+<div class="defnbox"><a id="wrglossary.22450"></a><a href="#glo:MGLSmainpl"><code class="csfmt">\MGLSmainpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22451"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22452"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22453"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22454"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22455"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses <a id="wrglossary.22456"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a> for the main element and <a id="wrglossary.22457"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a> for the others. <a href="#sec:mglsbasic">§7.11.1</a>; <a href="#wrglossary.9087">364</a><p>
+<div class="defnbox"><a id="wrglossary.22458"></a><a href="#glo:MGlsmainpl"><code class="csfmt">\MGlsmainpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22459"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22460"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22461"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22462"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22463"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses <a id="wrglossary.22464"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a> for the main entry and <a id="wrglossary.22465"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> for the others. <a href="#sec:mglsbasic">§7.11.1</a>; <a href="#wrglossary.9070">364</a><p>
+<div class="defnbox"><a id="wrglossary.22466"></a><a href="#glo:Mglsmainpl"><code class="csfmt">\Mglsmainpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22467"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22468"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22469"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22470"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22471"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> uses <a id="wrglossary.22472"></a><a href="#glo:idx.sentencecase">sentence case</a> for the first element and the plural form for the main element. <a href="#sec:mglsbasic">§7.11.1</a>; <a href="#wrglossary.9056">363</a><p>
+<div class="defnbox"><a id="wrglossary.22473"></a><a href="#glo:mglsmainpl"><code class="csfmt">\mglsmainpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22474"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22475"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22476"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22477"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22478"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses the plural form for the main element. <a href="#sec:mglsbasic">§7.11.1</a>; <a href="#wrglossary.9032">363</a><p>
+<div class="defnbox"><a id="wrglossary.22479"></a><a href="#glo:MGlsname"><code class="csfmt">\MGlsname</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22480"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22481"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22482"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22483"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22484"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses <a id="wrglossary.22485"></a><a href="#glo:Glsname"><code class="csfmt">\Glsname</code></a>. <a href="#sec:mglsotherfields">§7.11.3</a>; <a href="#wrglossary.9143">365</a><p>
+<div class="defnbox"><a id="wrglossary.22486"></a><a href="#glo:Mglsname"><code class="csfmt">\Mglsname</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22487"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22488"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22489"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22490"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22491"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses <a id="wrglossary.22492"></a><a href="#glo:Glsname"><code class="csfmt">\Glsname</code></a> for the first entry and <a id="wrglossary.22493"></a><a href="#glo:glsname"><code class="csfmt">\glsname</code></a> for the remaining entries. <a href="#sec:mglsotherfields">§7.11.3</a>; <a href="#wrglossary.9137">365</a><p>
+<div class="defnbox"><a id="wrglossary.22494"></a><a href="#glo:mglsname"><code class="csfmt">\mglsname</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22495"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22496"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22497"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22498"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22499"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses <a id="wrglossary.22500"></a><a href="#glo:glsname"><code class="csfmt">\glsname</code></a>. <a href="#sec:mglsotherfields">§7.11.3</a>; <a href="#wrglossary.9132">365</a><p>
+<div class="defnbox"><a id="wrglossary.22501"></a><a href="#glo:MGLSpl"><code class="csfmt">\MGLSpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22502"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22503"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22504"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22505"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22506"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses <a id="wrglossary.22507"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a> for each element. <a href="#sec:mglsbasic">§7.11.1</a>; <a href="#wrglossary.9081">364</a><p>
+<div class="defnbox"><a id="wrglossary.22508"></a><a href="#glo:MGlspl"><code class="csfmt">\MGlspl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22509"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22510"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22511"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22512"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22513"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses <a id="wrglossary.22514"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a> for each element. <a href="#sec:mglsbasic">§7.11.1</a>; <a href="#wrglossary.9065">364</a><p>
+<div class="defnbox"><a id="wrglossary.22515"></a><a href="#glo:Mglspl"><code class="csfmt">\Mglspl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22516"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22517"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22518"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22519"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22520"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses <a id="wrglossary.22521"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a> for the first element and <a id="wrglossary.22522"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> for the remaining elements. <a href="#sec:mglsbasic">§7.11.1</a>; <a href="#wrglossary.9050">363</a><p>
+<div class="defnbox"><a id="wrglossary.22523"></a><a href="#glo:mglspl"><code class="csfmt">\mglspl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22524"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22525"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22526"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22527"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22528"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses the plural form for each element. <a href="#sec:mglsbasic">§7.11.1</a>; <a href="#wrglossary.9026">363</a><p>
+<div class="defnbox"><a id="wrglossary.22529"></a><a href="#glo:mglsprefix"><code class="csfmt">\mglsprefix</code></a><span class="floatrightbox"><a id="wrglossary.22530"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Code used to typeset the multi-entry prefix. <a href="#sec:mglsfixes">§7.3</a>; <a href="#wrglossary.8618">340</a><p>
+<div class="defnbox"><a id="wrglossary.22531"></a><a href="#glo:mglsreset"><code class="csfmt">\mglsreset</code></a><code class="code">{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22532"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Globally resets the first use flag for the given multi-entry. <a href="#sec:mglsfirstuse">§7.7</a>; <a href="#wrglossary.8847">352</a><p>
+<div class="defnbox"><a id="wrglossary.22533"></a><a href="#glo:mglsresetall"><code class="csfmt">\mglsresetall</code></a><span class="floatrightbox"><a id="wrglossary.22534"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Resets the first use flag for all multi-entries. <a href="#sec:mglsfirstuse">§7.7</a>; <a href="#wrglossary.8851">353</a><p>
+<div class="defnbox"><a id="wrglossary.22535"></a><a href="#glo:mglsseefirstitem"><code class="csfmt">\mglsseefirstitem</code></a><code class="code">{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22536"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formatting command used by cross-reference lists for the first item if the item is a multi-entry. <a href="#sec:msee">§7.12</a>; <a href="#wrglossary.9301">369</a><p>
+<div class="defnbox"><a id="wrglossary.22537"></a><a href="#glo:mglsseeitem"><code class="csfmt">\mglsseeitem</code></a><code class="code">{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22538"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Formatting command used by cross-reference lists for subsequent items if the item is a multi-entry. <a href="#sec:msee">§7.12</a>; <a href="#wrglossary.9302">369</a><p>
+<div class="defnbox"><a id="wrglossary.22539"></a><dfn id="glo:mglsSetMain"><code class="csfmt">\mglsSetMain</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}{<span class="meta">〈<em class="metainner">new-main-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22540"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally changes the main element for the given multi-entry.<p>
+<div class="defnbox"><a id="wrglossary.22541"></a><a href="#glo:mglsSetOptions"><code class="csfmt">\mglsSetOptions</code></a><code class="code">{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}{<span class="meta">〈<em class="metainner">new-options</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22542"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Locally sets the options associated with the given multi-entry. <a href="#sec:multientries">§7</a>; <a href="#wrglossary.8283">325</a><p>
+<div class="defnbox"><a id="wrglossary.22543"></a><a href="#glo:Mglsshort"><code class="csfmt">\Mglsshort</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22544"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22545"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22546"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22547"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22548"></a><a href="#glo:mglsshort"><code class="csfmt">\mglsshort</code></a> but <a id="wrglossary.22549"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#sec:mglsabbrv">§7.11.2</a>; <a href="#wrglossary.9114">365</a><p>
+<div class="defnbox"><a id="wrglossary.22550"></a><a href="#glo:mglsshort"><code class="csfmt">\mglsshort</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22551"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22552"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22553"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22554"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22555"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses <a id="wrglossary.22556"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> for any elements that have the <a id="wrglossary.22557"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> field set and <a id="wrglossary.22558"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a> otherwise. <a href="#sec:mglsabbrv">§7.11.2</a>; <a href="#wrglossary.9093">364</a><p>
+<div class="defnbox"><a id="wrglossary.22559"></a><a href="#glo:mglssuffix"><code class="csfmt">\mglssuffix</code></a><span class="floatrightbox"><a id="wrglossary.22560"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Code used to typeset the multi-entry suffix. <a href="#sec:mglsfixes">§7.3</a>; <a href="#wrglossary.8628">341</a><p>
+<div class="defnbox"><a id="wrglossary.22561"></a><a href="#glo:MGlssymbol"><code class="csfmt">\MGlssymbol</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22562"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22563"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22564"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22565"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22566"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses <a id="wrglossary.22567"></a><a href="#glo:glssymbol"><code class="csfmt">\glssymbol</code></a> if the <a id="wrglossary.22568"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> field is set and <a id="wrglossary.22569"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> otherwise. <a href="#sec:mglsotherfields">§7.11.3</a>; <a href="#wrglossary.9155">365</a><p>
+<div class="defnbox"><a id="wrglossary.22570"></a><a href="#glo:Mglssymbol"><code class="csfmt">\Mglssymbol</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22571"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22572"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22573"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22574"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22575"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses <a id="wrglossary.22576"></a><a href="#glo:glssymbol"><code class="csfmt">\glssymbol</code></a> if the <a id="wrglossary.22577"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> field is set, otherwise it uses <a id="wrglossary.22578"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> for the first element and <a id="wrglossary.22579"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> for the remaining elements. <a href="#sec:mglsotherfields">§7.11.3</a>; <a href="#wrglossary.9163">366</a><p>
+<div class="defnbox"><a id="wrglossary.22580"></a><a href="#glo:mglssymbol"><code class="csfmt">\mglssymbol</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22581"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22582"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22583"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22584"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22585"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses <a id="wrglossary.22586"></a><a href="#glo:glssymbol"><code class="csfmt">\glssymbol</code></a> if the <a id="wrglossary.22587"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> field is set and <a id="wrglossary.22588"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> otherwise. <a href="#sec:mglsotherfields">§7.11.3</a>; <a href="#wrglossary.9148">365</a><p>
+<div class="defnbox"><a id="wrglossary.22589"></a><a href="#glo:mglsunset"><code class="csfmt">\mglsunset</code></a><code class="code">{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22590"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Globally unsets the first use flag for the given multi-entry. <a href="#sec:mglsfirstuse">§7.7</a>; <a href="#wrglossary.8846">352</a><p>
+<div class="defnbox"><a id="wrglossary.22591"></a><a href="#glo:mglsunsetall"><code class="csfmt">\mglsunsetall</code></a><span class="floatrightbox"><a id="wrglossary.22592"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Unsets the first use flag for all multi-entries. <a href="#sec:mglsfirstuse">§7.7</a>; <a href="#wrglossary.8850">353</a><p>
+<div class="defnbox"><a id="wrglossary.22593"></a><a href="#glo:mglsunsetothers"><code class="csfmt">\mglsunsetothers</code></a><code class="code">{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22594"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Globally unsets the <a id="wrglossary.22595"></a><a href="#glo:dual.firstuseflag">first use flag</a> for the other (not main) elements of the given multi-entry. <a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.9015">362</a><p>
+<div class="defnbox"><a id="wrglossary.22596"></a><a href="#glo:mglsusecategoryprefix"><code class="csfmt">\mglsusecategoryprefix</code></a><code class="code">{<span class="meta">〈<em class="metainner">category-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22597"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the prefix assigned to the given multi-entry category or does nothing if no prefix assigned. <a href="#sec:mglsfixes">§7.3</a>; <a href="#wrglossary.8649">342</a><p>
+<div class="defnbox"><a id="wrglossary.22598"></a><a href="#glo:mglsusecategorysuffix"><code class="csfmt">\mglsusecategorysuffix</code></a><code class="code">{<span class="meta">〈<em class="metainner">category-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22599"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the suffix assigned to the given multi-entry category or does nothing if no suffix assigned. <a href="#sec:mglsfixes">§7.3</a>; <a href="#wrglossary.8652">342</a><p>
+<div class="defnbox"><a id="wrglossary.22600"></a><a href="#glo:MGlsusefield"><code class="csfmt">\MGlsusefield</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22601"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22602"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22603"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22604"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22605"></a><a href="#glo:mglsusefield"><code class="csfmt">\mglsusefield</code></a> but <a id="wrglossary.22606"></a><a href="#glo:idx.sentencecase">sentence case</a> for each element. <a href="#sec:mglsotherfields">§7.11.3</a>; <a href="#wrglossary.9188">366</a><p>
+<div class="defnbox"><a id="wrglossary.22607"></a><a href="#glo:Mglsusefield"><code class="csfmt">\Mglsusefield</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22608"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22609"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22610"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22611"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22612"></a><a href="#glo:mglsusefield"><code class="csfmt">\mglsusefield</code></a> but <a id="wrglossary.22613"></a><a href="#glo:idx.sentencecase">sentence case</a> for the first element. <a href="#sec:mglsotherfields">§7.11.3</a>; <a href="#wrglossary.9182">366</a><p>
+<div class="defnbox"><a id="wrglossary.22614"></a><a href="#glo:mglsusefield"><code class="csfmt">\mglsusefield</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22615"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22616"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22617"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22618"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22619"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses <a id="wrglossary.22620"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a> if the field identified by <a id="wrglossary.22621"></a><a href="#glo:mglsfield"><code class="csfmt">\mglsfield</code></a> exists with the <a id="wrglossary.22622"></a><a href="#glo:dual.linktext">link text</a> obtained from the field value. <a href="#sec:mglsotherfields">§7.11.3</a>; <a href="#wrglossary.9170">366</a><p>
+<div class="defnbox"><a id="wrglossary.22623"></a><a href="#glo:mglswasfirstuse"><code class="csfmt">\mglswasfirstuse</code></a><code class="code">{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22624"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+For use in multi-entry suffix and post-link hooks, this expands to the <span class="meta">〈<em class="metainner">true</em>〉</span> if this was the first use of the multi-entry, otherwise to <span class="meta">〈<em class="metainner">false</em>〉</span>. <a href="#sec:mglspostlinkhook">§7.6</a>; <a href="#wrglossary.8820">350</a><p>
+<div class="defnbox"><a id="wrglossary.22625"></a><a href="#glo:MPGLS"><code class="csfmt">\MPGLS</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22626"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22627"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22628"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22629"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22630"></a><a href="#glo:mpgls"><code class="csfmt">\mpgls</code></a> but <a id="wrglossary.22631"></a><a href="#glo:idx.allcaps">all caps</a> for the all elements. <a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9280">369</a><p>
+<div class="defnbox"><a id="wrglossary.22632"></a><a href="#glo:MPGls"><code class="csfmt">\MPGls</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22633"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22634"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22635"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22636"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22637"></a><a href="#glo:mpgls"><code class="csfmt">\mpgls</code></a> but <a id="wrglossary.22638"></a><a href="#glo:idx.sentencecase">sentence case</a> for all elements. <a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9261">368</a><p>
+<div class="defnbox"><a id="wrglossary.22639"></a><a href="#glo:Mpgls"><code class="csfmt">\Mpgls</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22640"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22641"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22642"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22643"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22644"></a><a href="#glo:mpgls"><code class="csfmt">\mpgls</code></a> but <a id="wrglossary.22645"></a><a href="#glo:idx.sentencecase">sentence case</a> for the first element. <a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9248">368</a><p>
+<div class="defnbox"><a id="wrglossary.22646"></a><a href="#glo:mpgls"><code class="csfmt">\mpgls</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22647"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22648"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22649"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22650"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22651"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses <a id="wrglossary.22652"></a><a href="#glo:pgls"><code class="csfmt">\pgls</code></a> for the first element. <a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9230">367</a><p>
+<div class="defnbox"><a id="wrglossary.22653"></a><a href="#glo:MPGLSmainpl"><code class="csfmt">\MPGLSmainpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22654"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22655"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22656"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22657"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22658"></a><a href="#glo:mpglsmainpl"><code class="csfmt">\mpglsmainpl</code></a> but <a id="wrglossary.22659"></a><a href="#glo:idx.allcaps">all caps</a> for the all elements. <a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9292">369</a><p>
+<div class="defnbox"><a id="wrglossary.22660"></a><a href="#glo:MPGlsmainpl"><code class="csfmt">\MPGlsmainpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22661"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22662"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22663"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22664"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22665"></a><a href="#glo:mpglsmainpl"><code class="csfmt">\mpglsmainpl</code></a> but <a id="wrglossary.22666"></a><a href="#glo:idx.sentencecase">sentence case</a> for all elements. <a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9273">368</a><p>
+<div class="defnbox"><a id="wrglossary.22667"></a><a href="#glo:Mpglsmainpl"><code class="csfmt">\Mpglsmainpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22668"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22669"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22670"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22671"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22672"></a><a href="#glo:mpglspl"><code class="csfmt">\mpglspl</code></a> but <a id="wrglossary.22673"></a><a href="#glo:idx.sentencecase">sentence case</a> for the first element. <a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9254">368</a><p>
+<div class="defnbox"><a id="wrglossary.22674"></a><a href="#glo:mpglsmainpl"><code class="csfmt">\mpglsmainpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22675"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22676"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22677"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22678"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22679"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses <a id="wrglossary.22680"></a><a href="#glo:pglspl"><code class="csfmt">\pglspl</code></a> for the first element if its the main element otherwise <a id="wrglossary.22681"></a><a href="#glo:pgls"><code class="csfmt">\pgls</code></a> and, for the remaining elements, uses <a id="wrglossary.22682"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> if the element is the main entry or <a id="wrglossary.22683"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> otherwise. <a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9242">368</a><p>
+<div class="defnbox"><a id="wrglossary.22684"></a><a href="#glo:MPGLSpl"><code class="csfmt">\MPGLSpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22685"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22686"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22687"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22688"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22689"></a><a href="#glo:mpglspl"><code class="csfmt">\mpglspl</code></a> but <a id="wrglossary.22690"></a><a href="#glo:idx.allcaps">all caps</a> for the all elements. <a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9286">369</a><p>
+<div class="defnbox"><a id="wrglossary.22691"></a><a href="#glo:MPGlspl"><code class="csfmt">\MPGlspl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22692"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22693"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22694"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22695"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22696"></a><a href="#glo:mpglspl"><code class="csfmt">\mpglspl</code></a> but <a id="wrglossary.22697"></a><a href="#glo:idx.sentencecase">sentence case</a> for all elements. <a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9267">368</a><p>
+<div class="defnbox"><a id="wrglossary.22698"></a><a href="#glo:mpglspl"><code class="csfmt">\mpglspl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22699"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22700"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22701"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22702"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22703"></a><a href="#glo:mgls"><code class="csfmt">\mgls</code></a> but uses <a id="wrglossary.22704"></a><a href="#glo:pglspl"><code class="csfmt">\pglspl</code></a> for the first element and <a id="wrglossary.22705"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> for the remaining elements. <a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9236">368</a><p>
+<div class="defnbox"><a id="wrglossary.22706"></a><a href="#glo:mpglsWarning"><code class="csfmt">\mpglsWarning</code></a><span class="floatrightbox"><a id="wrglossary.22707"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Issues a warning with <a id="wrglossary.22708"></a><a href="#glo:GlossariesExtraWarning"><code class="csfmt">\GlossariesExtraWarning</code></a> indicating that <a id="wrglossary.22709"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a> is required for <a id="wrglossary.22710"></a><a href="#glo:mpgls"><code class="csfmt">\mpgls</code></a> family of commands. <a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9229">367</a><p>
+<div class="defnbox"><a id="wrglossary.22711"></a><a href="#glo:Mu"><code class="csfmt">\Mu</code></a><span class="floatrightbox"><a id="wrglossary.22712"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.22713"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a>, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{M}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13978">573</a><p>
+<div class="defnbox"><a id="wrglossary.22714"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">main-label</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label-list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22715"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines a multi-entry set with the label <span class="meta">〈<em class="metainner">multi-label</em>〉</span>, consisting of the entries whose labels are listed in <span class="meta">〈<em class="metainner">entry-label-list</em>〉</span>, where the main entry (which must be present in <span class="meta">〈<em class="metainner">entry-label-list</em>〉</span>) is identified by <span class="meta">〈<em class="metainner">main-label</em>〉</span> (or the final element in <span class="meta">〈<em class="metainner">entry-label-list</em>〉</span>, if <span class="meta">〈<em class="metainner">main-label</em>〉</span> is omitted). <a href="#sec:multientries">§7</a>; <a href="#wrglossary.8253">323</a><p>
+<div class="defnbox"><a id="wrglossary.22716"></a><a href="#glo:multiglossaryentryglobalfalse"><code class="csfmt">\multiglossaryentryglobalfalse</code></a><span class="floatrightbox"><a id="wrglossary.22717"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets <a id="wrglossary.22718"></a><a href="#glo:ifmultiglossaryentryglobal"><code class="csfmt">\ifmultiglossaryentryglobal</code></a> to false. <a href="#sec:multientries">§7</a>; <a href="#wrglossary.8281">325</a><p>
+<div class="defnbox"><a id="wrglossary.22719"></a><a href="#glo:multiglossaryentryglobaltrue"><code class="csfmt">\multiglossaryentryglobaltrue</code></a><span class="floatrightbox"><a id="wrglossary.22720"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets <a id="wrglossary.22721"></a><a href="#glo:ifmultiglossaryentryglobal"><code class="csfmt">\ifmultiglossaryentryglobal</code></a> to true. <a href="#sec:multientries">§7</a>; <a href="#wrglossary.8280">324</a><p>
+<div class="defnbox"><a id="wrglossary.22722"></a><a href="#glo:multiglossaryentrysetup"><code class="csfmt">\multiglossaryentrysetup</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22723"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Specifies a general set of options to apply to all multi-entries. <a href="#sec:multiglsoptions">§7.9</a>; <a href="#wrglossary.8872">354</a><p>
+
+</section><!-- end of section summary.index7536640 -->
+
+<section id="summary.index7602176"><!-- start of section summary.index7602176 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->N<div class="labellink"><a href="#summary.index7602176">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.22724"></a><a href="#glo:newabbr"><code class="csfmt">\newabbr</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">short</em>〉</span>}{<span class="meta">〈<em class="metainner">long</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.22725"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> defined by the <a id="wrglossary.22726"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.22727"></a><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a> or <a id="wrglossary.22728"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.22729"></a><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a> package option. <a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a><p>
+<div class="defnbox"><a id="wrglossary.22730"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">short</em>〉</span>}{<span class="meta">〈<em class="metainner">long</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Defines a new entry that represents an abbreviation. This internally uses <a id="wrglossary.22731"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> and any provided <span class="meta">〈<em class="metainner">options</em>〉</span> (<a id="wrglossary.22732"></a><a href="#glo:idx.gloskey">glossary entry keys</a>) will be appended. The <a id="wrglossary.22733"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> is set to <a id="wrglossary.22734"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a> by default, but may be overridden in <span class="meta">〈<em class="metainner">options</em>〉</span>. The appropriate style should be set before the abbreviation is defined with <a id="wrglossary.22735"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>. <a href="#sec:newabbr">§4.1</a>; <a href="#wrglossary.1226">41</a><p>
+<div class="defnbox"><a id="wrglossary.22736"></a><a href="#glo:newabbreviationhook"><code class="csfmt">\newabbreviationhook</code></a></div><!-- end of defnbox -->
+<p>
+Hook provided within <a id="wrglossary.22737"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> just before the entry is defined. <a href="#sec:abbrvgeneralhooks">§4.1.5</a>; <a href="#wrglossary.1370">45</a><p>
+<div class="defnbox"><a id="wrglossary.22738"></a><a href="#glo:newabbreviationstyle"><code class="csfmt">\newabbreviationstyle</code></a><code class="code">{<span class="meta">〈<em class="metainner">style-name</em>〉</span>}{<span class="meta">〈<em class="metainner">setup</em>〉</span>}{<span class="meta">〈<em class="metainner">display definitions</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Defines an abbreviation style, which can be set with <a id="wrglossary.22739"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>. <a href="#sec:newabbrvstyle">§4.5.3</a>; <a href="#wrglossary.3986">161</a><p>
+<div class="defnbox"><a id="wrglossary.22740"></a><dfn id="glo:newacronym"><code class="csfmt">\newacronym</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">short</em>〉</span>}{<span class="meta">〈<em class="metainner">long</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22741"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This command is provided by the base <a id="wrglossary.22742"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package but is redefined by <a id="wrglossary.22743"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> to use <a id="wrglossary.22744"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a> with the <a id="wrglossary.22745"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> key set to <a id="wrglossary.22746"></a><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a>. The appropriate style should be set before the abbreviation is defined with <code class="code"><a id="wrglossary.22747"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>[acronym]{<span class="meta">〈<em class="metainner">style</em>〉</span>}</code>. You can override the <a id="wrglossary.22748"></a><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a> in <span class="meta">〈<em class="metainner">options</em>〉</span> but remember to change the optional argument of <a id="wrglossary.22749"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a> to match.<p>
+<div class="defnbox"><a id="wrglossary.22750"></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><dfn id="glo:newacronymstyle"><code class="csfmt">\newacronymstyle</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">name</em>〉</span>}{<span class="meta">〈<em class="metainner">format def</em>〉</span>}{<span class="meta">〈<em class="metainner">display defs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22751"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines an acronym style for use with the base <a id="wrglossary.22752"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s acronym mechanism. These styles are not compatible with <a id="wrglossary.22753"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. Use <a id="wrglossary.22754"></a><a href="#glo:newabbreviationstyle"><code class="csfmt">\newabbreviationstyle</code></a> instead.<p>
+<div class="defnbox"><a id="wrglossary.22755"></a><a href="#glo:newdglsfield"><code class="csfmt">\newdglsfield</code></a><code class="code">[<span class="meta">〈<em class="metainner">default-options</em>〉</span>]{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22756"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines the command <span class="meta">〈<em class="metainner">cs</em>〉</span>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>} to behave like <code class="code"><a id="wrglossary.22757"></a><a href="#glo:dglsfield"><code class="csfmt">\dglsfield</code></a>[<span class="meta">〈<em class="metainner">default-options</em>〉</span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field</em>〉</span>}</code>. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13816">566</a><p>
+<div class="defnbox"><a id="wrglossary.22758"></a><a href="#glo:newdglsfieldlike"><code class="csfmt">\newdglsfieldlike</code></a><code class="code">[<span class="meta">〈<em class="metainner">default-options</em>〉</span>]{<span class="meta">〈<em class="metainner">field</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}{<span class="meta">〈<em class="metainner">Cs</em>〉</span>}{<span class="meta">〈<em class="metainner">CS</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22759"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.22760"></a><a href="#glo:newdglsfield"><code class="csfmt">\newdglsfield</code></a> but also defines <a id="wrglossary.22761"></a><a href="#glo:idx.sentencecase">sentence case</a> (<span class="meta">〈<em class="metainner">Cs</em>〉</span>) and <a id="wrglossary.22762"></a><a href="#glo:idx.allcaps">all caps</a> (<span class="meta">〈<em class="metainner">CS</em>〉</span>) commands with mappings. <a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13820">566</a><p>
+<div class="defnbox"><a id="wrglossary.22763"></a><a href="#glo:newentry"><code class="csfmt">\newentry</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.22764"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> defined by the <a id="wrglossary.22765"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.22766"></a><a href="#glo:optval.shortcuts.other"><span class="optfmt">other</span></a> package option. <a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.463">18</a><p>
+<div class="defnbox"><a id="wrglossary.22767"></a><dfn id="glo:newglossary"><code class="csfmt">\newglossary</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">log-ext</em>〉</span>]{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}{<span class="meta">〈<em class="metainner">in-ext</em>〉</span>}{<span class="meta">〈<em class="metainner">out-ext</em>〉</span>}{<span class="meta">〈<em class="metainner">title</em>〉</span>}[<span class="meta">〈<em class="metainner">counter</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.22768"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines a <a id="wrglossary.22769"></a><a href="#glo:dual.glossary">glossary</a> identified by <span class="meta">〈<em class="metainner">glossary-label</em>〉</span> (which can be referenced by the <a id="wrglossary.22770"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> key when defining an entry). The <span class="meta">〈<em class="metainner">title</em>〉</span> will be used when displaying the <a id="wrglossary.22771"></a><a href="#glo:dual.glossary">glossary</a> (using commands like <a id="wrglossary.22772"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>), but this title can be overridden by the <a id="wrglossary.22773"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a> option. The optional <span class="meta">〈<em class="metainner">counter</em>〉</span> indicates which <a id="wrglossary.22774"></a><a href="#glo:@@glslabel@locationcounter">counter</a> should be used by default for the <a id="wrglossary.22775"></a><a href="#glo:@@glslabel@entrylocation">location</a> when <a id="wrglossary.22776"></a><a href="#glo:dual.indexing">indexing</a> any entries that have been assigned to this <a id="wrglossary.22777"></a><a href="#glo:dual.glossary">glossary</a>. (This can be overridden by the <a id="wrglossary.22778"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a> option.) The other arguments are file extensions for use with <a id="wrglossary.22779"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.22780"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. These arguments aren’t relevant for other <a id="wrglossary.22781"></a><a href="#glo:dual.indexing">indexing</a> options (in which case, you may prefer to use <a id="wrglossary.22782"></a><a href="#glo:newglossary*"><code class="csfmt">\newglossary*</code></a>).<p>
+<div class="defnbox"><a id="wrglossary.22783"></a><dfn id="glo:newglossary*"><code class="csfmt">\newglossary*</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}{<span class="meta">〈<em class="metainner">title</em>〉</span>}[<span class="meta">〈<em class="metainner">counter</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.22784"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A shortcut that supplies file extensions based on the <a id="wrglossary.22785"></a><a href="#glo:dual.glossary">glossary</a> label:<pre class="compactcodebox"><a id="wrglossary.22786"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>-glg]{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>-gls}{<span class="meta">〈<em class="metainner"><span class="meta">〈<em class="metainner">glossary-label</em>〉</span>-glo</em>〉</span>}{<span class="meta">〈<em class="metainner">title</em>〉</span>}[<span class="meta">〈<em class="metainner">counter</em>〉</span>]</pre><p>
+<div class="defnbox"><a id="wrglossary.22787"></a><dfn id="glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">key=value list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22788"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines a new <a id="wrglossary.22789"></a><a href="#glo:dual.glossary">glossary</a> entry with the given label. The second argument is a comma-separated list of <a id="wrglossary.22790"></a><a href="#glo:idx.gloskey">glossary entry keys</a>.<p>
+<div class="defnbox"><a id="wrglossary.22791"></a><dfn id="glo:newignoredglossary"><code class="csfmt">\newignoredglossary</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22792"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines a <a id="wrglossary.22793"></a><a href="#glo:dual.glossary">glossary</a> that should be ignored by iterative commands, such as <a id="wrglossary.22794"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>. This <a id="wrglossary.22795"></a><a href="#glo:dual.glossary">glossary</a> has no associated <a id="wrglossary.22796"></a><a href="#glo:dual.indexing">indexing</a> files and has hyperlinks disabled. You can use an <a id="wrglossary.22797"></a><a href="#glo:dual.ignoredglossary">ignored glossary</a> for common terms or abbreviations that don’t need to be included in any listing (but you may want these terms defined as entries to allow automated formatting with the <a id="wrglossary.22798"></a><a href="#glo:dual.glslike"><code class="csfmt">\gls</code>-like</a> commands). An <a id="wrglossary.22799"></a><a href="#glo:dual.ignoredglossary">ignored glossary</a> can’t be displayed with <a id="wrglossary.22800"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> but may be displayed with the <a id="wrglossary.22801"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>, such as <a id="wrglossary.22802"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.22803"></a><a href="#glo:newignoredglossary*"><code class="csfmt">\newignoredglossary*</code></a><code class="code">{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22804"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.11+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+This is like the unstarred <a id="wrglossary.22805"></a><a href="#glo:newignoredglossary"><code class="csfmt">\newignoredglossary</code></a> but doesn’t disable hyperlinks. You will need to ensure that the hypertargets are defined. For example, with <a id="wrglossary.22806"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> or through <a id="wrglossary.22807"></a><a href="#glo:dual.standaloneentry">standalone entrys</a>. <a href="#sec:glossaries">§8</a>; <a href="#wrglossary.9442">375</a><p>
+<div class="defnbox"><a id="wrglossary.22808"></a><a href="#glo:newnum"><code class="csfmt">\newnum</code></a><code class="code">[<span class="meta">〈<em class="metainner">key=value list</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">num</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.22809"></a><a href="#glo:glsxtrnewnumber"><code class="csfmt">\glsxtrnewnumber</code></a> defined by the <a id="wrglossary.22810"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.22811"></a><a href="#glo:optval.shortcuts.other"><span class="optfmt">other</span></a> package option (provided the <a id="wrglossary.22812"></a><a href="#glo:opt.numbers"><span class="styoptfmt">numbers</span></a> option is also used). <a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.468">19</a><p>
+<div class="defnbox"><a id="wrglossary.22813"></a><a href="#glo:newsym"><code class="csfmt">\newsym</code></a><code class="code">[<span class="meta">〈<em class="metainner">key=value list</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">sym</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+A synonym for <a id="wrglossary.22814"></a><a href="#glo:glsxtrnewsymbol"><code class="csfmt">\glsxtrnewsymbol</code></a> defined by the <a id="wrglossary.22815"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=</span><a id="wrglossary.22816"></a><a href="#glo:optval.shortcuts.other"><span class="optfmt">other</span></a> package option (provided the <a id="wrglossary.22817"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a> option is also used). <a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.465">18</a><p>
+<div class="defnbox"><a id="wrglossary.22818"></a><a href="#glo:newterm"><code class="csfmt">\newterm</code></a><code class="code">[<span class="meta">〈<em class="metainner">key=value list</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.22819"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.02+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.22820"></a><a href="#glo:opt.index"><span class="styoptfmt">index</span></a> package option)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Defines a new <a id="wrglossary.22821"></a><a href="#glo:dual.glossary">glossary</a> entry with the given label, <a id="wrglossary.22822"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> set to <code class="code">index</code>, the <a id="wrglossary.22823"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> set to <span class="meta">〈<em class="metainner">entry-label</em>〉</span> and the <a id="wrglossary.22824"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> set to <a id="wrglossary.22825"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>. The optional argument is a comma-separated list of <a id="wrglossary.22826"></a><a href="#glo:idx.gloskey">glossary entry keys</a>, which can be used to override the defaults. <a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.246">12</a><p>
+<div class="defnbox"><a id="wrglossary.22827"></a><dfn id="glo:nopostdesc"><code class="csfmt">\nopostdesc</code></dfn><span class="floatrightbox"><a id="wrglossary.22828"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v1.17+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+When placed at the end of the <a id="wrglossary.22829"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a>, this switches off the <a id="wrglossary.22830"></a><a href="#glo:dual.postdeschook">post-description hook</a> (including the post-description punctuation). Does nothing outside of the <a id="wrglossary.22831"></a><a href="#glo:dual.glossary">glossary</a>.<p>
+<div class="defnbox"><a id="wrglossary.22832"></a><a href="#glo:Nu"><code class="csfmt">\Nu</code></a><span class="floatrightbox"><a id="wrglossary.22833"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.22834"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a>, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{N}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13979">573</a><p>
+
+</section><!-- end of section summary.index7602176 -->
+
+<section id="summary.index7667712"><!-- start of section summary.index7667712 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->O<div class="labellink"><a href="#summary.index7667712">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.22835"></a><a href="#glo:Omicron"><code class="csfmt">\Omicron</code></a><span class="floatrightbox"><a id="wrglossary.22836"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.22837"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a>, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{O}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13980">573</a><p>
+<div class="defnbox"><a id="wrglossary.22838"></a><a href="#glo:omicron"><code class="csfmt">\omicron</code></a><span class="floatrightbox"><a id="wrglossary.22839"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.22840"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a>, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{O}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13985">573</a><p>
+
+</section><!-- end of section summary.index7667712 -->
+
+<section id="summary.index7733248"><!-- start of section summary.index7733248 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->P<div class="labellink"><a href="#summary.index7733248">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.22841"></a><dfn id="glo:pagelistname"><code class="csfmt">\pagelistname</code></dfn><span class="floatrightbox"><span class="summarytag">initial: </span>Page List; <a id="wrglossary.22842"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(language-sensitive)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Expands to the title of the <a id="wrglossary.22843"></a><a href="#glo:dual.locationlist">location list</a> column for headed <a id="wrglossary.22844"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>-like styles.<p>
+<div class="defnbox"><a id="wrglossary.22845"></a><dfn id="glo:PGLS"><code class="csfmt">\PGLS</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22846"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22847"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22848"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22849"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22850"></a><a href="#glo:pgls"><code class="csfmt">\pgls</code></a> but <a id="wrglossary.22851"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="defnbox"><a id="wrglossary.22852"></a><dfn id="glo:Pgls"><code class="csfmt">\Pgls</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22853"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22854"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22855"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22856"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22857"></a><a href="#glo:pgls"><code class="csfmt">\pgls</code></a> but <a id="wrglossary.22858"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="defnbox"><a id="wrglossary.22859"></a><dfn id="glo:pgls"><code class="csfmt">\pgls</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22860"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22861"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22862"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22863"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.22864"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> but inserts the appropriate prefix, if provided.<p>
+<div class="defnbox"><a id="wrglossary.22865"></a><a href="#glo:PGLSfmtlong"><code class="csfmt">\PGLSfmtlong</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22866"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22867"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22868"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22869"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.22870"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22871"></a><a href="#glo:pglsfmtlong"><code class="csfmt">\pglsfmtlong</code></a> but <a id="wrglossary.22872"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5363">209</a><p>
+<div class="defnbox"><a id="wrglossary.22873"></a><a href="#glo:Pglsfmtlong"><code class="csfmt">\Pglsfmtlong</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22874"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22875"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22876"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22877"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.22878"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22879"></a><a href="#glo:pglsfmtlong"><code class="csfmt">\pglsfmtlong</code></a> but <a id="wrglossary.22880"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5357">209</a><p>
+<div class="defnbox"><a id="wrglossary.22881"></a><a href="#glo:pglsfmtlong"><code class="csfmt">\pglsfmtlong</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22882"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22883"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22884"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22885"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22886"></a><a href="#glo:glsfmtlong"><code class="csfmt">\glsfmtlong</code></a> but inserts the <a id="wrglossary.22887"></a><a href="#glo:opt.gloskey.prefixfirst"><span class="csoptfmt">prefixfirst</span></a> field and separator in front if set. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5349">209</a><p>
+<div class="defnbox"><a id="wrglossary.22888"></a><a href="#glo:PGLSfmtlongpl"><code class="csfmt">\PGLSfmtlongpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22889"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22890"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22891"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22892"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.22893"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22894"></a><a href="#glo:pglsfmtlongpl"><code class="csfmt">\pglsfmtlongpl</code></a> but <a id="wrglossary.22895"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5393">210</a><p>
+<div class="defnbox"><a id="wrglossary.22896"></a><a href="#glo:Pglsfmtlongpl"><code class="csfmt">\Pglsfmtlongpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22897"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22898"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22899"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22900"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.22901"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22902"></a><a href="#glo:pglsfmtlongpl"><code class="csfmt">\pglsfmtlongpl</code></a> but <a id="wrglossary.22903"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5387">210</a><p>
+<div class="defnbox"><a id="wrglossary.22904"></a><a href="#glo:pglsfmtlongpl"><code class="csfmt">\pglsfmtlongpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22905"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22906"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22907"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22908"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.22909"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22910"></a><a href="#glo:glsfmtlongpl"><code class="csfmt">\glsfmtlongpl</code></a> but inserts the <a id="wrglossary.22911"></a><a href="#glo:opt.gloskey.prefixfirstplural"><span class="csoptfmt">prefixfirstplural</span></a> field and separator in front if set. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5379">210</a><p>
+<div class="defnbox"><a id="wrglossary.22912"></a><a href="#glo:PGLSfmtshort"><code class="csfmt">\PGLSfmtshort</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22913"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22914"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22915"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22916"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.22917"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22918"></a><a href="#glo:pglsfmtshort"><code class="csfmt">\pglsfmtshort</code></a> but <a id="wrglossary.22919"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5303">207</a><p>
+<div class="defnbox"><a id="wrglossary.22920"></a><a href="#glo:Pglsfmtshort"><code class="csfmt">\Pglsfmtshort</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22921"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22922"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22923"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22924"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.22925"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22926"></a><a href="#glo:pglsfmtshort"><code class="csfmt">\pglsfmtshort</code></a> but <a id="wrglossary.22927"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5295">207</a><p>
+<div class="defnbox"><a id="wrglossary.22928"></a><a href="#glo:pglsfmtshort"><code class="csfmt">\pglsfmtshort</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22929"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22930"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22931"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22932"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.22933"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22934"></a><a href="#glo:glsfmtshort"><code class="csfmt">\glsfmtshort</code></a> but inserts the <a id="wrglossary.22935"></a><a href="#glo:opt.gloskey.prefix"><span class="csoptfmt">prefix</span></a> field and separator in front if set. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5287">207</a><p>
+<div class="defnbox"><a id="wrglossary.22936"></a><a href="#glo:PGLSfmtshortpl"><code class="csfmt">\PGLSfmtshortpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22937"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22938"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22939"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22940"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.22941"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22942"></a><a href="#glo:pglsfmtshortpl"><code class="csfmt">\pglsfmtshortpl</code></a> but <a id="wrglossary.22943"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5333">208</a><p>
+<div class="defnbox"><a id="wrglossary.22944"></a><a href="#glo:Pglsfmtshortpl"><code class="csfmt">\Pglsfmtshortpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22945"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22946"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22947"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22948"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.22949"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22950"></a><a href="#glo:pglsfmtshortpl"><code class="csfmt">\pglsfmtshortpl</code></a> but <a id="wrglossary.22951"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5327">208</a><p>
+<div class="defnbox"><a id="wrglossary.22952"></a><a href="#glo:pglsfmtshortpl"><code class="csfmt">\pglsfmtshortpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22953"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22954"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22955"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22956"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.22957"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22958"></a><a href="#glo:glsfmtshortpl"><code class="csfmt">\glsfmtshortpl</code></a> but inserts the <a id="wrglossary.22959"></a><a href="#glo:opt.gloskey.prefixplural"><span class="csoptfmt">prefixplural</span></a> field and separator in front if set. <a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5319">208</a><p>
+<div class="defnbox"><a id="wrglossary.22960"></a><dfn id="glo:PGLSpl"><code class="csfmt">\PGLSpl</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22961"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22962"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22963"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22964"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22965"></a><a href="#glo:pgls"><code class="csfmt">\pgls</code></a> but <a id="wrglossary.22966"></a><a href="#glo:idx.allcaps">all caps</a>.<p>
+<div class="defnbox"><a id="wrglossary.22967"></a><dfn id="glo:Pglspl"><code class="csfmt">\Pglspl</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22968"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22969"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22970"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22971"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22972"></a><a href="#glo:pgls"><code class="csfmt">\pgls</code></a> but <a id="wrglossary.22973"></a><a href="#glo:idx.sentencecase">sentence case</a>.<p>
+<div class="defnbox"><a id="wrglossary.22974"></a><dfn id="glo:pglspl"><code class="csfmt">\pglspl</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22975"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22976"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22977"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22978"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.22979"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> but inserts the appropriate prefix, if provided.<p>
+<div class="defnbox"><a id="wrglossary.22980"></a><a href="#glo:PGLSxtrlong"><code class="csfmt">\PGLSxtrlong</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22981"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22982"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22983"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22984"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.22985"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22986"></a><a href="#glo:pglsxtrlong"><code class="csfmt">\pglsxtrlong</code></a> but <a id="wrglossary.22987"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1674">56</a><p>
+<div class="defnbox"><a id="wrglossary.22988"></a><a href="#glo:Pglsxtrlong"><code class="csfmt">\Pglsxtrlong</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22989"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22990"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22991"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.22992"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.22993"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.22994"></a><a href="#glo:pglsxtrlong"><code class="csfmt">\pglsxtrlong</code></a> but <a id="wrglossary.22995"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1668">56</a><p>
+<div class="defnbox"><a id="wrglossary.22996"></a><a href="#glo:pglsxtrlong"><code class="csfmt">\pglsxtrlong</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.22997"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.22998"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.22999"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.23000"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.23001"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.23002"></a><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a> but inserts the <a id="wrglossary.23003"></a><a href="#glo:opt.gloskey.prefixfirst"><span class="csoptfmt">prefixfirst</span></a> field and separator in front if set. <a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1661">55</a><p>
+<div class="defnbox"><a id="wrglossary.23004"></a><a href="#glo:PGLSxtrlongpl"><code class="csfmt">\PGLSxtrlongpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.23005"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.23006"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.23007"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.23008"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.23009"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.23010"></a><a href="#glo:pglsxtrlongpl"><code class="csfmt">\pglsxtrlongpl</code></a> but <a id="wrglossary.23011"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1693">56</a><p>
+<div class="defnbox"><a id="wrglossary.23012"></a><a href="#glo:Pglsxtrlongpl"><code class="csfmt">\Pglsxtrlongpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.23013"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.23014"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.23015"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.23016"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.23017"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.23018"></a><a href="#glo:pglsxtrlongpl"><code class="csfmt">\pglsxtrlongpl</code></a> but <a id="wrglossary.23019"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1687">56</a><p>
+<div class="defnbox"><a id="wrglossary.23020"></a><a href="#glo:pglsxtrlongpl"><code class="csfmt">\pglsxtrlongpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.23021"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.23022"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.23023"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.23024"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.23025"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.23026"></a><a href="#glo:glsxtrlongpl"><code class="csfmt">\glsxtrlongpl</code></a> but inserts the <a id="wrglossary.23027"></a><a href="#glo:opt.gloskey.prefixfirstplural"><span class="csoptfmt">prefixfirstplural</span></a> field and separator in front if set. <a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1680">56</a><p>
+<div class="defnbox"><a id="wrglossary.23028"></a><a href="#glo:PGLSxtrshort"><code class="csfmt">\PGLSxtrshort</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.23029"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.23030"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.23031"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.23032"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.23033"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.23034"></a><a href="#glo:pglsxtrshort"><code class="csfmt">\pglsxtrshort</code></a> but <a id="wrglossary.23035"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1636">55</a><p>
+<div class="defnbox"><a id="wrglossary.23036"></a><a href="#glo:Pglsxtrshort"><code class="csfmt">\Pglsxtrshort</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.23037"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.23038"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.23039"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.23040"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.23041"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.23042"></a><a href="#glo:pglsxtrshort"><code class="csfmt">\pglsxtrshort</code></a> but <a id="wrglossary.23043"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1628">55</a><p>
+<div class="defnbox"><a id="wrglossary.23044"></a><a href="#glo:pglsxtrshort"><code class="csfmt">\pglsxtrshort</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.23045"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.23046"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.23047"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.23048"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.23049"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.23050"></a><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a> but inserts the <a id="wrglossary.23051"></a><a href="#glo:opt.gloskey.prefix"><span class="csoptfmt">prefix</span></a> field and separator in front if set. <a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1621">55</a><p>
+<div class="defnbox"><a id="wrglossary.23052"></a><a href="#glo:PGLSxtrshortpl"><code class="csfmt">\PGLSxtrshortpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.23053"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.23054"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.23055"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.23056"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.23057"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.23058"></a><a href="#glo:pglsxtrshortpl"><code class="csfmt">\pglsxtrshortpl</code></a> but <a id="wrglossary.23059"></a><a href="#glo:idx.allcaps">all caps</a>. <a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1655">55</a><p>
+<div class="defnbox"><a id="wrglossary.23060"></a><a href="#glo:Pglsxtrshortpl"><code class="csfmt">\Pglsxtrshortpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.23061"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.23062"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.23063"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.23064"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.23065"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.23066"></a><a href="#glo:pglsxtrshortpl"><code class="csfmt">\pglsxtrshortpl</code></a> but <a id="wrglossary.23067"></a><a href="#glo:idx.sentencecase">sentence case</a>. <a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1649">55</a><p>
+<div class="defnbox"><a id="wrglossary.23068"></a><a href="#glo:pglsxtrshortpl"><code class="csfmt">\pglsxtrshortpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.23069"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.23070"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.23071"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.23072"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.23073"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.23074"></a><a href="#glo:glsxtrshortpl"><code class="csfmt">\glsxtrshortpl</code></a> but inserts the <a id="wrglossary.23075"></a><a href="#glo:opt.gloskey.prefixplural"><span class="csoptfmt">prefixplural</span></a> field and separator in front if set. <a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1642">55</a><p>
+<div class="defnbox"><a id="wrglossary.23076"></a><a href="#glo:Pglsxtrtitlelong"><code class="csfmt">\Pglsxtrtitlelong</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23077"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.23078"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+The normal behaviour of <a id="wrglossary.23079"></a><a href="#glo:Pglsfmtlong"><code class="csfmt">\Pglsfmtlong</code></a>. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5619">219</a><p>
+<div class="defnbox"><a id="wrglossary.23080"></a><a href="#glo:Pglsxtrtitlelongpl"><code class="csfmt">\Pglsxtrtitlelongpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23081"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.23082"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+The normal behaviour of <a id="wrglossary.23083"></a><a href="#glo:Pglsfmtlongpl"><code class="csfmt">\Pglsfmtlongpl</code></a>. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5621">219</a><p>
+<div class="defnbox"><a id="wrglossary.23084"></a><a href="#glo:Pglsxtrtitleshort"><code class="csfmt">\Pglsxtrtitleshort</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23085"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.23086"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+The normal behaviour of <a id="wrglossary.23087"></a><a href="#glo:Pglsfmtshort"><code class="csfmt">\Pglsfmtshort</code></a>. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5615">219</a><p>
+<div class="defnbox"><a id="wrglossary.23088"></a><a href="#glo:Pglsxtrtitleshortpl"><code class="csfmt">\Pglsxtrtitleshortpl</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23089"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.23090"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+The normal behaviour of <a id="wrglossary.23091"></a><a href="#glo:Pglsfmtshortpl"><code class="csfmt">\Pglsfmtshortpl</code></a>. <a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5617">219</a><p>
+<div class="defnbox"><a id="wrglossary.23092"></a><a href="#glo:pretoglossarypreamble"><code class="csfmt">\pretoglossarypreamble</code></a><code class="code">[<span class="meta">〈<em class="metainner">type</em>〉</span>]{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23093"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Prepends (locally) <span class="meta">〈<em class="metainner">text</em>〉</span> to the preamble for the glossary identified by <span class="meta">〈<em class="metainner">type</em>〉</span>. If <span class="meta">〈<em class="metainner">type</em>〉</span> is omitted, <a id="wrglossary.23094"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a> is assumed. <a href="#sec:glospreamble">§8.2</a>; <a href="#wrglossary.9509">377</a><p>
+<div class="defnbox"><a id="wrglossary.23095"></a><a href="#glo:printabbreviations"><code class="csfmt">\printabbreviations</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <code class="code"><code class="csfmt">\usepackage</code>[<a id="wrglossary.23096"></a><a href="#glo:opt.abbreviations"><span class="styoptfmt">abbreviations</span></a>]{glossaries-extra}</code>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Shortcut for <code class="code"><a id="wrglossary.23097"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>[<a id="wrglossary.23098"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.23099"></a><a href="#glo:glsxtrabbrvtype"><code class="csfmt">\glsxtrabbrvtype</code></a></span>]</code>. <a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.164">9</a><p>
+<div class="defnbox"><a id="wrglossary.23100"></a><dfn id="glo:printacronyms"><code class="csfmt">\printacronyms</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.23101"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires the <a id="wrglossary.23102"></a><a href="#glo:opt.acronyms"><span class="styoptfmt">acronyms</span></a> package option)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Shortcut for <code class="code"><a id="wrglossary.23103"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>[<a id="wrglossary.23104"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.23105"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a></span>]</code>.<p>
+<div class="defnbox"><a id="wrglossary.23106"></a><dfn id="glo:printglossaries"><code class="csfmt">\printglossaries</code></dfn><span class="floatrightbox"><a id="wrglossary.23107"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Iterates over all non-<a id="wrglossary.23108"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a> and does <code class="code"><a id="wrglossary.23109"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>[<a id="wrglossary.23110"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<span class="meta">〈<em class="metainner">type</em>〉</span></span>]</code> for each <a id="wrglossary.23111"></a><a href="#glo:dual.glossary">glossary</a>.<p>
+<div class="defnbox"><a id="wrglossary.23112"></a><dfn id="glo:printglossary"><code class="csfmt">\printglossary</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.23113"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the <a id="wrglossary.23114"></a><a href="#glo:dual.glossary">glossary</a> by inputting a file created by <a id="wrglossary.23115"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.23116"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. Must be used with <a id="wrglossary.23117"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> and either <a id="wrglossary.23118"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.23119"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.<p>
+<div class="defnbox"><a id="wrglossary.23120"></a><dfn id="glo:printindex"><code class="csfmt">\printindex</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>] v4.02+</code><p>
+<div class="noteBox"><span style="font-size: small; ">(requires the <a id="wrglossary.23121"></a><a href="#glo:opt.index"><span class="styoptfmt">index</span></a> package option)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Shortcut provided by the <a id="wrglossary.23122"></a><a href="#glo:opt.index"><span class="styoptfmt">index</span></a> package option that simply does <code class="code"><a id="wrglossary.23123"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>[<a id="wrglossary.23124"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=index</span>]</code>.<p>
+<div class="defnbox"><a id="wrglossary.23125"></a><dfn id="glo:printnoidxglossaries"><code class="csfmt">\printnoidxglossaries</code></dfn><span class="floatrightbox"><a id="wrglossary.23126"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Iterates over all non-<a id="wrglossary.23127"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a> and does <code class="code"><a id="wrglossary.23128"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.23129"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<span class="meta">〈<em class="metainner">type</em>〉</span></span>]</code> for each <a id="wrglossary.23130"></a><a href="#glo:dual.glossary">glossary</a>.<p>
+<div class="defnbox"><a id="wrglossary.23131"></a><dfn id="glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.23132"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the <a id="wrglossary.23133"></a><a href="#glo:dual.glossary">glossary</a> by obtaining the <a id="wrglossary.23134"></a><a href="#glo:dual.indexing">indexing</a> information from the <a id="wrglossary.23135"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and using TeX to sort and collate. Must be used with <a id="wrglossary.23136"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> or with the <a id="wrglossary.23137"></a><a href="#glo:dual.glossary">glossaries</a> not identified in the optional argument of <a id="wrglossary.23138"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> when using the hybrid method. This method can be very slow and has limitations.<p>
+<div class="defnbox"><a id="wrglossary.23139"></a><dfn id="glo:printnumbers"><code class="csfmt">\printnumbers</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.23140"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.02+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires the <a id="wrglossary.23141"></a><a href="#glo:opt.numbers"><span class="styoptfmt">numbers</span></a> package option)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Shortcut for <code class="code"><a id="wrglossary.23142"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>[<a id="wrglossary.23143"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=numbers</span>]</code>.<p>
+<div class="defnbox"><a id="wrglossary.23144"></a><dfn id="glo:printsymbols"><code class="csfmt">\printsymbols</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.23145"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.02+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires the <a id="wrglossary.23146"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a> package option)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Shortcut for <code class="code"><a id="wrglossary.23147"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>[<a id="wrglossary.23148"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=symbols</span>]</code>.<p>
+<div class="defnbox"><a id="wrglossary.23149"></a><a href="#glo:printunsrtabbreviations"><code class="csfmt">\printunsrtabbreviations</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.23150"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.40+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <code class="code"><code class="csfmt">\usepackage</code>[<a id="wrglossary.23151"></a><a href="#glo:opt.abbreviations"><span class="styoptfmt">abbreviations</span></a>,<a id="wrglossary.23152"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>]{glossaries-extra}</code>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Shortcut for <code class="code"><a id="wrglossary.23153"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<a id="wrglossary.23154"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.23155"></a><a href="#glo:glsxtrabbrvtype"><code class="csfmt">\glsxtrabbrvtype</code></a></span>]</code>. <a href="#sec:printunsrtshortcuts">§11.5.1</a>; <a href="#wrglossary.13061">534</a><p>
+<div class="defnbox"><a id="wrglossary.23156"></a><a href="#glo:printunsrtacronyms"><code class="csfmt">\printunsrtacronyms</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.23157"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.40+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <code class="code"><code class="csfmt">\usepackage</code>[<a id="wrglossary.23158"></a><a href="#glo:opt.acronyms"><span class="styoptfmt">acronyms</span></a>,<a id="wrglossary.23159"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>]{glossaries-extra}</code>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Shortcut for <code class="code"><a id="wrglossary.23160"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<a id="wrglossary.23161"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.23162"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a></span>]</code>. <a href="#sec:printunsrtshortcuts">§11.5.1</a>; <a href="#wrglossary.13064">534</a><p>
+<div class="defnbox"><a id="wrglossary.23163"></a><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><span class="floatrightbox"><a id="wrglossary.23164"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Iterates over all non-<a id="wrglossary.23165"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a> and does <code class="code"><a id="wrglossary.23166"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<a id="wrglossary.23167"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<span class="meta">〈<em class="metainner">type</em>〉</span></span>]</code> for each <a id="wrglossary.23168"></a><a href="#glo:dual.glossary">glossary</a>. <a href="#sec:printunsrt">§8.4</a>; <a href="#wrglossary.9670">383</a><p>
+<div class="defnbox"><a id="wrglossary.23169"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.23170"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Displays the <a id="wrglossary.23171"></a><a href="#glo:dual.glossary">glossary</a> by iterating over all entries associated with the given <a id="wrglossary.23172"></a><a href="#glo:dual.glossary">glossary</a> (in the order in which they were added to the <a id="wrglossary.23173"></a><a href="#glo:dual.glossary">glossary</a>). <a id="wrglossary.23174"></a><a href="#glo:idx.group">Group</a> headers will only be inserted if the <a id="wrglossary.23175"></a><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a> key has been defined and has been set (typically with the <a id="wrglossary.23176"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a> option and <a id="wrglossary.23177"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>). <a id="wrglossary.23178"></a><a href="#glo:dual.locationlist">Location lists</a> will only be shown if the <a id="wrglossary.23179"></a><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a> or <a id="wrglossary.23180"></a><a href="#glo:opt.glosfield.loclist"><span class="csoptfmt">loclist</span></a> fields have been set (typically by <a id="wrglossary.23181"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>). <a href="#sec:printunsrt">§8.4</a>; <a href="#wrglossary.9648">382</a><p>
+<div class="defnbox"><a id="wrglossary.23182"></a><a href="#glo:printunsrtglossary*"><code class="csfmt">\printunsrtglossary*</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">init-code</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23183"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Does <code class="code">{<span class="meta">〈<em class="metainner">init-code</em>〉</span><a id="wrglossary.23184"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<span class="meta">〈<em class="metainner">options</em>〉</span>]}</code> which localises <span class="meta">〈<em class="metainner">init-code</em>〉</span>. <a href="#sec:printunsrt">§8.4</a>; <a href="#wrglossary.9657">383</a><p>
+<div class="defnbox"><a id="wrglossary.23185"></a><a href="#glo:printunsrtglossaryentryprocesshook"><code class="csfmt">\printunsrtglossaryentryprocesshook</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23186"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook used within the <a id="wrglossary.23187"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> while the <a id="wrglossary.23188"></a><a href="#glo:dual.glossary">glossary</a> is being constructed. <a href="#sec:printunsrtadvanced">§8.4.3</a>; <a href="#wrglossary.10243">401</a><p>
+<div class="defnbox"><a id="wrglossary.23189"></a><a href="#glo:printunsrtglossaryhandler"><code class="csfmt">\printunsrtglossaryhandler</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23190"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.16+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used within the <a id="wrglossary.23191"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> to process the current entry. <a href="#sec:printunsrtadvanced">§8.4.3</a>; <a href="#wrglossary.10267">402</a><p>
+<div class="defnbox"><a id="wrglossary.23192"></a><a href="#glo:printunsrtglossarypredoglossary"><code class="csfmt">\printunsrtglossarypredoglossary</code></a><span class="floatrightbox"><a id="wrglossary.23193"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Hook performed by the <a id="wrglossary.23194"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a> just before the <a id="wrglossary.23195"></a><a href="#glo:dual.glossary">glossary</a> body is displayed. <a href="#sec:printunsrtadvanced">§8.4.3</a>; <a href="#wrglossary.10257">401</a><p>
+<div class="defnbox"><a id="wrglossary.23196"></a><a href="#glo:printunsrtglossaryskipentry"><code class="csfmt">\printunsrtglossaryskipentry</code></a><span class="floatrightbox"><a id="wrglossary.23197"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+May be used within <a id="wrglossary.23198"></a><a href="#glo:printunsrtglossaryentryprocesshook"><code class="csfmt">\printunsrtglossaryentryprocesshook</code></a> to skip the current entry. <a href="#sec:printunsrtadvanced">§8.4.3</a>; <a href="#wrglossary.10244">401</a><p>
+<div class="defnbox"><a id="wrglossary.23199"></a><a href="#glo:printunsrtglossaryunit"><code class="csfmt">\printunsrtglossaryunit</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">counter-name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23200"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Provided for use with <a id="wrglossary.23201"></a><a href="#glo:GlsXtrRecordCounter"><code class="csfmt">\GlsXtrRecordCounter</code></a> to display a glossary with <a id="wrglossary.23202"></a><a href="#glo:printunsrtglossary*"><code class="csfmt">\printunsrtglossary*</code></a> that filters entries that don’t have a match for the current <span class="meta">〈<em class="metainner">counter-name</em>〉</span> value. <a href="#sec:printunsrtunit">§8.4.3.2</a>; <a href="#wrglossary.10447">408</a><p>
+<div class="defnbox"><a id="wrglossary.23203"></a><a href="#glo:printunsrtglossaryunitpostskip"><code class="csfmt">\printunsrtglossaryunitpostskip</code></a><span class="floatrightbox"><a id="wrglossary.23204"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The vertical space at the end of the <a id="wrglossary.23205"></a><a href="#glo:dual.glossary">glossary</a> appended by <a id="wrglossary.23206"></a><a href="#glo:printunsrtglossaryunit"><code class="csfmt">\printunsrtglossaryunit</code></a>. <a href="#sec:printunsrtunit">§8.4.3.2</a>; <a href="#wrglossary.10461">409</a><p>
+<div class="defnbox"><a id="wrglossary.23207"></a><a href="#glo:printunsrtglossaryunitsetup"><code class="csfmt">\printunsrtglossaryunitsetup</code></a><code class="code">{<span class="meta">〈<em class="metainner">counter-name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23208"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets up the filtering used by <a id="wrglossary.23209"></a><a href="#glo:printunsrtglossaryunit"><code class="csfmt">\printunsrtglossaryunit</code></a>. <a href="#sec:printunsrtunit">§8.4.3.2</a>; <a href="#wrglossary.10452">409</a><p>
+<div class="defnbox"><a id="wrglossary.23210"></a><a href="#glo:printunsrtindex"><code class="csfmt">\printunsrtindex</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.23211"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.40+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <code class="code"><code class="csfmt">\usepackage</code>[<a id="wrglossary.23212"></a><a href="#glo:opt.index"><span class="styoptfmt">index</span></a>,<a id="wrglossary.23213"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>]{glossaries-extra}</code>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Shortcut provided by the <a id="wrglossary.23214"></a><a href="#glo:opt.index"><span class="styoptfmt">index</span></a> package option combined with <a id="wrglossary.23215"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> that simply does <code class="code"><a id="wrglossary.23216"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<a id="wrglossary.23217"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=index</span>]</code>. <a href="#sec:printunsrtshortcuts">§11.5.1</a>; <a href="#wrglossary.13075">535</a><p>
+<div class="defnbox"><a id="wrglossary.23218"></a><a href="#glo:printunsrtinnerglossary"><code class="csfmt">\printunsrtinnerglossary</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">pre-code</em>〉</span>}{<span class="meta">〈<em class="metainner">post-code</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23219"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.44+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Similar to <a id="wrglossary.23220"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> but doesn’t contain the code that starts and ends the <a id="wrglossary.23221"></a><a href="#glo:dual.glossary">glossary</a> (such as beginning and ending the <a id="wrglossary.23222"></a><a href="#glo:env.theglossary"><span class="envfmt">theglossary</span></a> environment), so this command needs to be either placed inside <a id="wrglossary.23223"></a><a href="#glo:env.printunsrtglossarywrap"><span class="envfmt">printunsrtglossarywrap</span></a> or in the <a id="wrglossary.23224"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> entry handler <a id="wrglossary.23225"></a><a href="#glo:printunsrtglossaryhandler"><code class="csfmt">\printunsrtglossaryhandler</code></a>. <a href="#sec:printunsrtinner">§8.4.3.1</a>; <a href="#wrglossary.10298">403</a><p>
+<div class="defnbox"><a id="wrglossary.23226"></a><a href="#glo:printunsrtnumbers"><code class="csfmt">\printunsrtnumbers</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.23227"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.40+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <code class="code"><code class="csfmt">\usepackage</code>[<a id="wrglossary.23228"></a><a href="#glo:opt.numbers"><span class="styoptfmt">numbers</span></a>,<a id="wrglossary.23229"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>]{glossaries-extra}</code>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Shortcut provided by the <a id="wrglossary.23230"></a><a href="#glo:opt.numbers"><span class="styoptfmt">numbers</span></a> package option combined with <a id="wrglossary.23231"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> that simply does <code class="code"><a id="wrglossary.23232"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<a id="wrglossary.23233"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=numbers</span>]</code>. <a href="#sec:printunsrtshortcuts">§11.5.1</a>; <a href="#wrglossary.13072">534</a><p>
+<div class="defnbox"><a id="wrglossary.23234"></a><a href="#glo:printunsrtsymbols"><code class="csfmt">\printunsrtsymbols</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.23235"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.40+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <code class="code"><code class="csfmt">\usepackage</code>[<a id="wrglossary.23236"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a>,<a id="wrglossary.23237"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>]{glossaries-extra}</code>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Shortcut for <code class="code"><a id="wrglossary.23238"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a>[<a id="wrglossary.23239"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=symbols</span>]</code>. <a href="#sec:printunsrtshortcuts">§11.5.1</a>; <a href="#wrglossary.13069">534</a><p>
+<div class="defnbox"><a id="wrglossary.23240"></a><a href="#glo:printunsrttable"><code class="csfmt">\printunsrttable</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.23241"></a><a href="#glo:pkg.glossary-table"><span class="styfmt">glossary-table</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Internally uses <a id="wrglossary.23242"></a><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a> with the <a id="wrglossary.23243"></a><a href="#glo:opt.glostyle.table"><span class="glostylefmt">table</span></a> style. <a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11564">468</a><p>
+<div class="defnbox"><a id="wrglossary.23244"></a><a href="#glo:provideignoredglossary"><code class="csfmt">\provideignoredglossary</code></a><code class="code">{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.23245"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.23246"></a><a href="#glo:newignoredglossary"><code class="csfmt">\newignoredglossary</code></a> but does nothing if the <a id="wrglossary.23247"></a><a href="#glo:dual.glossary">glossary</a> has already been defined. <a href="#sec:glossaries">§8</a>; <a href="#wrglossary.9450">376</a><p>
+<div class="defnbox"><a id="wrglossary.23248"></a><a href="#glo:providemultiglossaryentry"><code class="csfmt">\providemultiglossaryentry</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}[<span class="meta">〈<em class="metainner">main-label</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label-list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23249"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.23250"></a><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a> but does nothing if a multi-entry set has already been defined with the given label. <a href="#sec:multientries">§7</a>; <a href="#wrglossary.8270">324</a><p>
+<div class="defnbox"><a id="wrglossary.23251"></a><a href="#glo:ProvidesGlossariesExtraLang"><code class="csfmt">\ProvidesGlossariesExtraLang</code></a><code class="code">{<span class="meta">〈<em class="metainner">tag</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Should be placed at the start of a <a id="wrglossary.23252"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> <a id="wrglossary.23253"></a><a href="#glo:ext.ldf"><span class="extfmt">ldf</span></a> file. <a href="#sec:lang">§15</a>; <a href="#wrglossary.14273">593</a><p>
+
+</section><!-- end of section summary.index7733248 -->
+
+<section id="summary.index7864320"><!-- start of section summary.index7864320 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->R<div class="labellink"><a href="#summary.index7864320">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.23254"></a><a href="#glo:renewabbreviationstyle"><code class="csfmt">\renewabbreviationstyle</code></a><code class="code">{<span class="meta">〈<em class="metainner">style-name</em>〉</span>}{<span class="meta">〈<em class="metainner">setup</em>〉</span>}{<span class="meta">〈<em class="metainner">display definitions</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23255"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.04+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Redefines an abbreviation style. <a href="#sec:newabbrvstyle">§4.5.3</a>; <a href="#wrglossary.3989">161</a><p>
+<div class="defnbox"><a id="wrglossary.23256"></a><dfn id="glo:RequireGlossariesExtraLang"><code class="csfmt">\RequireGlossariesExtraLang</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">tag</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Indicates that a <a id="wrglossary.23257"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> <a id="wrglossary.23258"></a><a href="#glo:ext.ldf"><span class="extfmt">ldf</span></a> file should be input, if it hasn’t already been input.<p>
+<div class="defnbox"><a id="wrglossary.23259"></a><a href="#glo:RestoreAcronyms"><code class="csfmt">\RestoreAcronyms</code></a></div><!-- end of defnbox -->
+<p>
+Restores <a id="wrglossary.23260"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> to the base <a id="wrglossary.23261"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> mechanism. Not recommended. <a href="#sec:acrorevert">§4.6</a>; <a href="#wrglossary.4564">181</a><p>
+<div class="defnbox"><a id="wrglossary.23262"></a><a href="#glo:rGLS"><code class="csfmt">\rGLS</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.23263"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.23264"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.23265"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.23266"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.23267"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a> but hooks into the entry’s record count. <a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12834">526</a><p>
+<div class="defnbox"><a id="wrglossary.23268"></a><a href="#glo:rGls"><code class="csfmt">\rGls</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.23269"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.23270"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.23271"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.23272"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.23273"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> but hooks into the entry’s record count. <a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12820">526</a><p>
+<div class="defnbox"><a id="wrglossary.23274"></a><a href="#glo:rgls"><code class="csfmt">\rgls</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.23275"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.23276"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.23277"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.23278"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.23279"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> but hooks into the entry’s record count. <a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12805">525</a><p>
+<div class="defnbox"><a id="wrglossary.23280"></a><a href="#glo:rGLSformat"><code class="csfmt">\rGLSformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23281"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Format used by <a id="wrglossary.23282"></a><a href="#glo:rGLS"><code class="csfmt">\rGLS</code></a> if the entry’s record count is more than the given trigger value. <a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12840">526</a><p>
+<div class="defnbox"><a id="wrglossary.23283"></a><a href="#glo:rGlsformat"><code class="csfmt">\rGlsformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23284"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Format used by <a id="wrglossary.23285"></a><a href="#glo:rGls"><code class="csfmt">\rGls</code></a> if the entry’s record count is more than the given trigger value. <a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12826">526</a><p>
+<div class="defnbox"><a id="wrglossary.23286"></a><a href="#glo:rglsformat"><code class="csfmt">\rglsformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23287"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Format used by <a id="wrglossary.23288"></a><a href="#glo:rgls"><code class="csfmt">\rgls</code></a> if the entry’s record count is more than the given trigger value. <a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12811">525</a><p>
+<div class="defnbox"><a id="wrglossary.23289"></a><a href="#glo:rGLSpl"><code class="csfmt">\rGLSpl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.23290"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.23291"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.23292"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.23293"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.23294"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a> but hooks into the entry’s record count. <a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12841">526</a><p>
+<div class="defnbox"><a id="wrglossary.23295"></a><a href="#glo:rGlspl"><code class="csfmt">\rGlspl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.23296"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.23297"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.23298"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.23299"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.23300"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a> but hooks into the entry’s record count. <a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12827">526</a><p>
+<div class="defnbox"><a id="wrglossary.23301"></a><a href="#glo:rglspl"><code class="csfmt">\rglspl</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}[<span class="meta">〈<em class="metainner">insert</em>〉</span>]</code><span class="floatrightbox"><span class="summarytag">modifiers: </span><a id="wrglossary.23302"></a><a href="#glo:idx.mod.star">*</a> <a id="wrglossary.23303"></a><a href="#glo:idx.mod.plus">+</a> <a id="wrglossary.23304"></a><a href="#glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span></a> <a id="wrglossary.23305"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Like <a id="wrglossary.23306"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> but hooks into the entry’s record count. <a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12813">525</a><p>
+<div class="defnbox"><a id="wrglossary.23307"></a><a href="#glo:rGLSplformat"><code class="csfmt">\rGLSplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23308"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Format used by <a id="wrglossary.23309"></a><a href="#glo:rGLSpl"><code class="csfmt">\rGLSpl</code></a> if the entry’s record count is more than the given trigger value. <a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12847">526</a><p>
+<div class="defnbox"><a id="wrglossary.23310"></a><a href="#glo:rGlsplformat"><code class="csfmt">\rGlsplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23311"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Format used by <a id="wrglossary.23312"></a><a href="#glo:rGlspl"><code class="csfmt">\rGlspl</code></a> if the entry’s record count is more than the given trigger value. <a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12833">526</a><p>
+<div class="defnbox"><a id="wrglossary.23313"></a><a href="#glo:rglsplformat"><code class="csfmt">\rglsplformat</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">insert</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23314"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Format used by <a id="wrglossary.23315"></a><a href="#glo:rglspl"><code class="csfmt">\rglspl</code></a> if the entry’s record count is more than the given trigger value. <a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12819">525</a><p>
+<div class="defnbox"><a id="wrglossary.23316"></a><a href="#glo:Rho"><code class="csfmt">\Rho</code></a><span class="floatrightbox"><a id="wrglossary.23317"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.23318"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a>, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{P}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13981">573</a><p>
+
+</section><!-- end of section summary.index7864320 -->
+
+<section id="summary.index7929856"><!-- start of section summary.index7929856 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->S<div class="labellink"><a href="#summary.index7929856">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.23319"></a><dfn id="glo:seealsoname"><code class="csfmt">\seealsoname</code></dfn><span class="floatrightbox"><span class="summarytag">initial: </span>see also; <a id="wrglossary.23320"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.16+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(language-sensitive)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Used as a cross-reference tag. The default value is <a id="wrglossary.23321"></a><a href="#glo:alsoname"><code class="csfmt">\alsoname</code></a>, if that command has been defined, or <span class="qt">“see also”</span>.<p>
+<div class="defnbox"><a id="wrglossary.23322"></a><dfn id="glo:seename"><code class="csfmt">\seename</code></dfn><span class="floatrightbox"><span class="summarytag">initial: </span>see</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(language-sensitive)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Used as a cross-reference tag (provided by <a id="wrglossary.23323"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> if not already defined).<p>
+<div class="defnbox"><a id="wrglossary.23324"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a><code class="code">[<span class="meta">〈<em class="metainner">category</em>〉</span>]{<span class="meta">〈<em class="metainner">style-name</em>〉</span>}</code></div><!-- end of defnbox -->
+<p>
+Sets the current <a id="wrglossary.23325"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> to <span class="meta">〈<em class="metainner">style-name</em>〉</span> for the category identified by <span class="meta">〈<em class="metainner">category</em>〉</span>. If the optional argument is omitted, <a id="wrglossary.23326"></a><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a> is assumed. <a href="#sec:abbrstyle">§4.5</a>; <a href="#wrglossary.1737">59</a><p>
+<div class="defnbox"><a id="wrglossary.23327"></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><dfn id="glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">acronym-style-name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23328"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.02+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the style for the base <a id="wrglossary.23329"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s acronym mechanism. These styles are not compatible with <a id="wrglossary.23330"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, which redefines <a id="wrglossary.23331"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> to use <a id="wrglossary.23332"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>. Use: <pre class="compactcodebox"><a id="wrglossary.23333"></a><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a>[acronym]{<span class="meta">〈<em class="metainner">abbreviation-style-name</em>〉</span>} </pre> with the closest matching <a id="wrglossary.23334"></a><a href="#glo:idx.abbrvstyle">abbreviation style</a> instead.<p>
+<div class="defnbox"><a id="wrglossary.23335"></a><dfn id="glo:setentrycounter"><code class="csfmt">\setentrycounter</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">prefix</em>〉</span>]{<span class="meta">〈<em class="metainner">counter</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23336"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to set the <a id="wrglossary.23337"></a><a href="#glo:dual.locationcounter">location counter</a> and prefix required for <a id="wrglossary.23338"></a><a href="#glo:glshypernumber"><code class="csfmt">\glshypernumber</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.23339"></a><dfn id="glo:setglossarypreamble"><code class="csfmt">\setglossarypreamble</code></dfn><code class="code">[<span class="meta">〈<em class="metainner">type</em>〉</span>]{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23340"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.07+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Globally sets the preamble for the glossary identified by <span class="meta">〈<em class="metainner">type</em>〉</span> to <span class="meta">〈<em class="metainner">text</em>〉</span>. If <span class="meta">〈<em class="metainner">type</em>〉</span> is omitted, <a id="wrglossary.23341"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a> is assumed.<p>
+<div class="defnbox"><a id="wrglossary.23342"></a><dfn id="glo:setglossarystyle"><code class="csfmt">\setglossarystyle</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">style-name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23343"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.08a+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Set the current <a id="wrglossary.23344"></a><a href="#glo:idx.glossarystyle">glossary style</a> to <span class="meta">〈<em class="metainner">style-name</em>〉</span>. Redefined by <a id="wrglossary.23345"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> to include <a id="wrglossary.23346"></a><a href="#glo:glsxtrpreglossarystyle"><code class="csfmt">\glsxtrpreglossarystyle</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.23347"></a><a href="#glo:setupglossaries"><code class="csfmt">\setupglossaries</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23348"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.11a+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Change allowed options that are defined by the base <a id="wrglossary.23349"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. Note that some options can only be passed as package options. To change options defined or modified by the <a id="wrglossary.23350"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package, use <a id="wrglossary.23351"></a><a href="#glo:glossariesextrasetup"><code class="csfmt">\glossariesextrasetup</code></a>. <a href="#sec:pkgopts">§2</a>; <a href="#wrglossary.157">9</a><p>
+<div class="defnbox"><a id="wrglossary.23352"></a><a href="#glo:setupglsadd"><code class="csfmt">\setupglsadd</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23353"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Set the default options for <a id="wrglossary.23354"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>. <a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4805">190</a><p>
+<div class="defnbox"><a id="wrglossary.23355"></a><a href="#glo:setupglslink"><code class="csfmt">\setupglslink</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23356"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Set the default <a id="wrglossary.23357"></a><a href="#glo:idx.glsopt"><code class="csfmt">\glslink</code> options</a>. <a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4803">190</a><p>
+<div class="defnbox"><a id="wrglossary.23358"></a><dfn id="glo:subglossentry"><code class="csfmt">\subglossentry</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">level</em>〉</span>}{<span class="meta">〈<em class="metainner">entry label</em>〉</span>}{<span class="meta">〈<em class="metainner">location list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23359"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used to format a child entry. This command should be redefined by the <a id="wrglossary.23360"></a><a href="#glo:idx.glossarystyle">glossary style</a>.<p>
+<div class="defnbox"><a id="wrglossary.23361"></a><dfn id="glo:symbolname"><code class="csfmt">\symbolname</code></dfn><span class="floatrightbox"><span class="summarytag">initial: </span>Symbol; <a id="wrglossary.23362"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(language-sensitive)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Expands to the title of the symbol column for headed <a id="wrglossary.23363"></a><a href="#glo:env.tabular"><span class="envfmt">tabular</span></a>-like styles.<p>
+
+</section><!-- end of section summary.index7929856 -->
+
+<section id="summary.index7995392"><!-- start of section summary.index7995392 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->T<div class="labellink"><a href="#summary.index7995392">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.23364"></a><a href="#glo:Tau"><code class="csfmt">\Tau</code></a><span class="floatrightbox"><a id="wrglossary.23365"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.23366"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a>, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{T}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13982">573</a><p>
+<div class="defnbox"><a id="wrglossary.23367"></a><dfn id="glo:theglossaryentry"><code class="csfmt">\theglossaryentry</code></dfn><span class="floatrightbox"><a id="wrglossary.23368"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v3.0+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+The value of the <a id="wrglossary.23369"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter.<p>
+
+</section><!-- end of section summary.index7995392 -->
+
+<section id="summary.index8060928"><!-- start of section summary.index8060928 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->U<div class="labellink"><a href="#summary.index8060928">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.23370"></a><dfn id="glo:u"><code class="csfmt">\u</code></dfn><code class="code"><span class="meta">〈<em class="metainner">hex</em>〉</span></code></div><!-- end of defnbox -->
+<p>
+Recognised by <a id="wrglossary.23371"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> within some <a id="wrglossary.23372"></a><a href="#glo:idx.resourceopt">resource options</a> as identifying the Unicode character given by <span class="meta">〈<em class="metainner">hex</em>〉</span>. Since <code class="csfmt">\u</code> is defined by the LaTeX kernel, you need to protect it from expansion while the options are written to the <a id="wrglossary.23373"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file (<code class="code"><a id="wrglossary.23374"></a><a href="#glo:string"><code class="csfmt">\string</code></a><code class="csfmt">\u</code><span class="meta">〈<em class="metainner">hex</em>〉</span></code>).<p>
+<div class="defnbox"><a id="wrglossary.23375"></a><a href="#glo:Upalpha"><code class="csfmt">\Upalpha</code></a><span class="floatrightbox"><a id="wrglossary.23376"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.23377"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a> and only if <a id="wrglossary.23378"></a><a href="#glo:pkg.upgreek"><span class="styfmt">upgreek</span></a> has been loaded, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{A}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13990">573</a><p>
+<div class="defnbox"><a id="wrglossary.23379"></a><a href="#glo:Upbeta"><code class="csfmt">\Upbeta</code></a><span class="floatrightbox"><a id="wrglossary.23380"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.23381"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a> and only if <a id="wrglossary.23382"></a><a href="#glo:pkg.upgreek"><span class="styfmt">upgreek</span></a> has been loaded, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{B}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13991">573</a><p>
+<div class="defnbox"><a id="wrglossary.23383"></a><a href="#glo:Upchi"><code class="csfmt">\Upchi</code></a><span class="floatrightbox"><a id="wrglossary.23384"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.23385"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a> and only if <a id="wrglossary.23386"></a><a href="#glo:pkg.upgreek"><span class="styfmt">upgreek</span></a> has been loaded, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{X}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.14002">573</a><p>
+<div class="defnbox"><a id="wrglossary.23387"></a><a href="#glo:Upepsilon"><code class="csfmt">\Upepsilon</code></a><span class="floatrightbox"><a id="wrglossary.23388"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.23389"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a> and only if <a id="wrglossary.23390"></a><a href="#glo:pkg.upgreek"><span class="styfmt">upgreek</span></a> has been loaded, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{E}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13992">573</a><p>
+<div class="defnbox"><a id="wrglossary.23391"></a><a href="#glo:Upeta"><code class="csfmt">\Upeta</code></a><span class="floatrightbox"><a id="wrglossary.23392"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.23393"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a> and only if <a id="wrglossary.23394"></a><a href="#glo:pkg.upgreek"><span class="styfmt">upgreek</span></a> has been loaded, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{H}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13994">573</a><p>
+<div class="defnbox"><a id="wrglossary.23395"></a><a href="#glo:Upiota"><code class="csfmt">\Upiota</code></a><span class="floatrightbox"><a id="wrglossary.23396"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.23397"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a> and only if <a id="wrglossary.23398"></a><a href="#glo:pkg.upgreek"><span class="styfmt">upgreek</span></a> has been loaded, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{I}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13995">573</a><p>
+<div class="defnbox"><a id="wrglossary.23399"></a><a href="#glo:Upkappa"><code class="csfmt">\Upkappa</code></a><span class="floatrightbox"><a id="wrglossary.23400"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.23401"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a> and only if <a id="wrglossary.23402"></a><a href="#glo:pkg.upgreek"><span class="styfmt">upgreek</span></a> has been loaded, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{K}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13996">573</a><p>
+<div class="defnbox"><a id="wrglossary.23403"></a><a href="#glo:Upmu"><code class="csfmt">\Upmu</code></a><span class="floatrightbox"><a id="wrglossary.23404"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.23405"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a> and only if <a id="wrglossary.23406"></a><a href="#glo:pkg.upgreek"><span class="styfmt">upgreek</span></a> has been loaded, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{M}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13997">573</a><p>
+<div class="defnbox"><a id="wrglossary.23407"></a><a href="#glo:Upnu"><code class="csfmt">\Upnu</code></a><span class="floatrightbox"><a id="wrglossary.23408"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.23409"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a> and only if <a id="wrglossary.23410"></a><a href="#glo:pkg.upgreek"><span class="styfmt">upgreek</span></a> has been loaded, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{N}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13998">573</a><p>
+<div class="defnbox"><a id="wrglossary.23411"></a><a href="#glo:Upomicron"><code class="csfmt">\Upomicron</code></a><span class="floatrightbox"><a id="wrglossary.23412"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.23413"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a> and only if <a id="wrglossary.23414"></a><a href="#glo:pkg.upgreek"><span class="styfmt">upgreek</span></a> has been loaded, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{O}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13999">573</a><p>
+<div class="defnbox"><a id="wrglossary.23415"></a><a href="#glo:upomicron"><code class="csfmt">\upomicron</code></a><span class="floatrightbox"><a id="wrglossary.23416"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.23417"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a> and only if <a id="wrglossary.23418"></a><a href="#glo:pkg.upgreek"><span class="styfmt">upgreek</span></a> has been loaded, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{o}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.14003">573</a><p>
+<div class="defnbox"><a id="wrglossary.23419"></a><a href="#glo:Uprho"><code class="csfmt">\Uprho</code></a><span class="floatrightbox"><a id="wrglossary.23420"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.23421"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a> and only if <a id="wrglossary.23422"></a><a href="#glo:pkg.upgreek"><span class="styfmt">upgreek</span></a> has been loaded, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{P}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.14000">573</a><p>
+<div class="defnbox"><a id="wrglossary.23423"></a><a href="#glo:Uptau"><code class="csfmt">\Uptau</code></a><span class="floatrightbox"><a id="wrglossary.23424"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.23425"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a> and only if <a id="wrglossary.23426"></a><a href="#glo:pkg.upgreek"><span class="styfmt">upgreek</span></a> has been loaded, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{T}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.14001">573</a><p>
+<div class="defnbox"><a id="wrglossary.23427"></a><a href="#glo:Upzeta"><code class="csfmt">\Upzeta</code></a><span class="floatrightbox"><a id="wrglossary.23428"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.23429"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a> and only if <a id="wrglossary.23430"></a><a href="#glo:pkg.upgreek"><span class="styfmt">upgreek</span></a> has been loaded, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{Z}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13993">573</a><p>
+
+</section><!-- end of section summary.index8060928 -->
+
+<section id="summary.index8192000"><!-- start of section summary.index8192000 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->W<div class="labellink"><a href="#summary.index8192000">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.23431"></a><a href="#glo:writemultiglossentry"><code class="csfmt">\writemultiglossentry</code></a><code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">multi-label</em>〉</span>}{<span class="meta">〈<em class="metainner">main-label</em>〉</span>}{<span class="meta">〈<em class="metainner">list</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23432"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Writes multi-entry information to the <a id="wrglossary.23433"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file. <a href="#sec:multiextras">§7.13</a>; <a href="#wrglossary.9339">371</a><p>
+
+</section><!-- end of section summary.index8192000 -->
+
+<section id="summary.index8257536"><!-- start of section summary.index8257536 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->X<div class="labellink"><a href="#summary.index8257536">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.23434"></a><dfn id="glo:xcapitalisefmtwords"><code class="csfmt">\xcapitalisefmtwords</code></dfn><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23435"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.03+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Passes the argument to <a id="wrglossary.23436"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a> but with the first token in <span class="meta">〈<em class="metainner">text</em>〉</span> expanded. The starred version uses the starred version of <a id="wrglossary.23437"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.23438"></a><a href="#glo:xglssetwidest"><code class="csfmt">\xglssetwidest</code></a><code class="code">[<span class="meta">〈<em class="metainner">level</em>〉</span>]{<span class="meta">〈<em class="metainner">name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23439"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.23440"></a><a href="#glo:eglssetwidest"><code class="csfmt">\eglssetwidest</code></a> but global. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11010">434</a><p>
+<div class="defnbox"><a id="wrglossary.23441"></a><a href="#glo:xglsupdatewidest"><code class="csfmt">\xglsupdatewidest</code></a><code class="code">[<span class="meta">〈<em class="metainner">level</em>〉</span>]{<span class="meta">〈<em class="metainner">name</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23442"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> v1.23+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.23443"></a><a href="#glo:eglsupdatewidest"><code class="csfmt">\eglsupdatewidest</code></a> but global. <a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11015">434</a><p>
+<div class="defnbox"><a id="wrglossary.23444"></a><a href="#glo:xGlsXtrIfValueInFieldCsvList"><code class="csfmt">\xGlsXtrIfValueInFieldCsvList</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.23445"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.47+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.23446"></a><a href="#glo:GlsXtrIfValueInFieldCsvList"><code class="csfmt">\GlsXtrIfValueInFieldCsvList</code></a> but fully expands <span class="meta">〈<em class="metainner">value</em>〉</span>. <a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7860">304</a><p>
+<div class="defnbox"><a id="wrglossary.23447"></a><a href="#glo:xGlsXtrSetField"><code class="csfmt">\xGlsXtrSetField</code></a><code class="code">{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">field-label</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.23448"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+As <a id="wrglossary.23449"></a><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a> but expands the value and uses a global assignment. <a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1207">40</a><p>
+<div class="defnbox"><a id="wrglossary.23450"></a><a href="#glo:xpglsxtrpostabbrvfootnote"><code class="csfmt">\xpglsxtrpostabbrvfootnote</code></a><span class="floatrightbox"><a id="wrglossary.23451"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Expands to the footnote code required for styles like <a id="wrglossary.23452"></a><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></a>. <a href="#sec:advancedabbrstylecmds">§4.5.2</a>; <a href="#wrglossary.3972">160</a><p>
+<div class="defnbox"><a id="wrglossary.23453"></a><a href="#glo:xpglsxtrposthyphenlong"><code class="csfmt">\xpglsxtrposthyphenlong</code></a><span class="floatrightbox"><a id="wrglossary.23454"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used within the <a id="wrglossary.23455"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the <a id="wrglossary.23456"></a><a href="#glo:opt.abbrstyle.short-hyphen-postlong-hyphen"><span class="abbrstylefmt">short-hyphen-postlong-hyphen</span></a> style on <a id="wrglossary.23457"></a><a href="#glo:dual.firstuse">first use</a>. This expands the placeholder commands and uses either <a id="wrglossary.23458"></a><a href="#glo:glsxtrposthyphenlong"><code class="csfmt">\glsxtrposthyphenlong</code></a> or <a id="wrglossary.23459"></a><a href="#glo:GLSxtrposthyphenlong"><code class="csfmt">\GLSxtrposthyphenlong</code></a>. <a href="#wrglossary.3794">152</a><p>
+<div class="defnbox"><a id="wrglossary.23460"></a><a href="#glo:xpglsxtrposthyphenshort"><code class="csfmt">\xpglsxtrposthyphenshort</code></a><span class="floatrightbox"><a id="wrglossary.23461"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used within the <a id="wrglossary.23462"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the <a id="wrglossary.23463"></a><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen"><span class="abbrstylefmt">long-hyphen-postshort-hyphen</span></a> style on <a id="wrglossary.23464"></a><a href="#glo:dual.firstuse">first use</a>. This expands the placeholder commands and uses either <a id="wrglossary.23465"></a><a href="#glo:glsxtrposthyphenshort"><code class="csfmt">\glsxtrposthyphenshort</code></a> or <a id="wrglossary.23466"></a><a href="#glo:GLSxtrposthyphenshort"><code class="csfmt">\GLSxtrposthyphenshort</code></a>. <a href="#wrglossary.3714">150</a><p>
+<div class="defnbox"><a id="wrglossary.23467"></a><a href="#glo:xpglsxtrposthyphensubsequent"><code class="csfmt">\xpglsxtrposthyphensubsequent</code></a><span class="floatrightbox"><a id="wrglossary.23468"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Used within the <a id="wrglossary.23469"></a><a href="#glo:dual.postlinkhook">post-link hook</a> for the <a id="wrglossary.23470"></a><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen"><span class="abbrstylefmt">long-hyphen-postshort-hyphen</span></a> style on <a id="wrglossary.23471"></a><a href="#glo:dual.subsequentuse">subsequent use</a>. This expands the placeholder commands and uses either <a id="wrglossary.23472"></a><a href="#glo:glsxtrposthyphensubsequent"><code class="csfmt">\glsxtrposthyphensubsequent</code></a> or <a id="wrglossary.23473"></a><a href="#glo:GLSxtrposthyphensubsequent"><code class="csfmt">\GLSxtrposthyphensubsequent</code></a>. <a href="#wrglossary.3766">151</a><p>
+
+</section><!-- end of section summary.index8257536 -->
+
+<section id="summary.index8388608"><!-- start of section summary.index8388608 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->Z<div class="labellink"><a href="#summary.index8388608">[link]</a></div></h2><!-- end of section header -->
+<div class="defnbox"><a id="wrglossary.23474"></a><a href="#glo:Zeta"><code class="csfmt">\Zeta</code></a><span class="floatrightbox"><a id="wrglossary.23475"></a><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span></a> v1.27+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defined with <a id="wrglossary.23476"></a><a href="#glo:providecommand"><code class="csfmt">\providecommand</code></a>, this just does <code class="code"><span class="cmdfmt">\mathrm</span>{Z}</code>. <a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13974">573</a><p>
+
+</section><!-- end of section summary.index8388608 -->
+
+<section id="envsummary"><!-- start of section envsummary --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->Environment Summary<div class="labellink"><a href="#envsummary">[link]</a></div></h1><!-- end of chapter header -->
+<div class="defnbox"><a id="wrglossary.23477"></a><a href="#glo:env.printunsrtglossarywrap"><code class="cbeg">\begin{<span class="envfmt">printunsrtglossarywrap</span>}</code></a><code class="code">[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code><span class="floatrightbox"><a id="wrglossary.23478"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.44+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets up the start and end of the <a id="wrglossary.23479"></a><a href="#glo:dual.glossary">glossary</a> (including beginning and ending the <a id="wrglossary.23480"></a><a href="#glo:env.theglossary"><span class="envfmt">theglossary</span></a> environment). Use <a id="wrglossary.23481"></a><a href="#glo:printunsrtinnerglossary"><code class="csfmt">\printunsrtinnerglossary</code></a> within the body for each block of entries. <a href="#sec:printunsrtinner">§8.4.3.1</a>; <a href="#wrglossary.10302">404</a><p>
+<div class="defnbox"><a id="wrglossary.23482"></a><dfn id="glo:env.theglossary"><code class="cbeg">\begin{<span class="envfmt">theglossary</span>}</code></dfn><span class="floatrightbox"><a id="wrglossary.23483"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Redefined by <a id="wrglossary.23484"></a><a href="#glo:idx.glossarystyle">glossary styles</a> to set up the way the <a id="wrglossary.23485"></a><a href="#glo:dual.glossary">glossary</a> is displayed. For example, to start and end the <a id="wrglossary.23486"></a><a href="#glo:env.description"><span class="envfmt">description</span></a> environment for the <a id="wrglossary.23487"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> styles.<p>
+
+</section><!-- end of section envsummary -->
+
+<section id="styoptsummary"><!-- start of section styoptsummary --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->Package Option Summary<div class="labellink"><a href="#styoptsummary">[link]</a></div></h1><!-- end of chapter header -->
+<div class="defnbox"><a id="wrglossary.23488"></a><code class="cmd">\usepackage</code>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<dfn id="glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></dfn>}<p>
+<div class="noteBox"><span style="font-size: small; ">(or <code class="code"><code class="csfmt">\usepackage</code>[<a id="wrglossary.23489"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a><span class="optfmt">=<span class="meta">〈<em class="metainner">options</em>〉</span></span>]{glossaries-extra}</code>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Modifies the <a id="wrglossary.23490"></a><a href="#glo:idx.glossarystyle">glossary styles</a> supplied with the base <a id="wrglossary.23491"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package to make them more flexible and to integrate support for features provided by <a id="wrglossary.23492"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> or <a id="wrglossary.23493"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>.<p>
+<div class="defnbox"><a id="wrglossary.23494"></a><dfn id="glo:opt.all"><span class="styoptfmt">all</span></dfn><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Load all predefined styles.<p>
+<div class="defnbox"><a id="wrglossary.23495"></a><dfn id="glo:opt.name"><span class="meta">〈<em class="metainner">name</em>〉</span></dfn><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Load package <span class="styfmt">glossary-<span class="meta">〈<em class="metainner">name</em>〉</span></span>.<p>
+<div class="defnbox"><a id="wrglossary.23496"></a><code class="cmd">\usepackage</code>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>}</div><!-- end of defnbox -->
+<p>
+Extension package that loads <a id="wrglossary.23497"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>, provides additional commands, and modifies some of the base <a id="wrglossary.23498"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> commands to integrate them with the new commands or to make them more flexible. <a href="#sec:pkgopts">§2</a>; <a href="#wrglossary.141">8</a><p>
+<div class="defnbox"><a id="wrglossary.23499"></a><a href="#glo:opt.abbreviations"><span class="styoptfmt">abbreviations</span></a><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Provides a new <a id="wrglossary.23500"></a><a href="#glo:dual.glossary">glossary</a> with the label <code class="code">abbreviations</code> and title given by <a id="wrglossary.23501"></a><a href="#glo:abbreviationsname"><code class="csfmt">\abbreviationsname</code></a>, redefines <a id="wrglossary.23502"></a><a href="#glo:glsxtrabbrvtype"><code class="csfmt">\glsxtrabbrvtype</code></a> to <code class="code">abbreviations</code>, redefines <a id="wrglossary.23503"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> to <a id="wrglossary.23504"></a><a href="#glo:glsxtrabbrvtype"><code class="csfmt">\glsxtrabbrvtype</code></a> (unless the <a id="wrglossary.23505"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> or <a id="wrglossary.23506"></a><a href="#glo:opt.acronyms"><span class="styoptfmt">acronyms</span></a> option has been used), and provides <a id="wrglossary.23507"></a><a href="#glo:printabbreviations"><code class="csfmt">\printabbreviations</code></a>. <a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.159">9</a><p>
+<div class="defnbox"><a id="wrglossary.23508"></a><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Loads <a id="wrglossary.23509"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a>. <a href="#sec:otherpkgopts">§2.3</a>; <a href="#wrglossary.333">14</a><p>
+<div class="defnbox"><a id="wrglossary.23510"></a><a href="#glo:opt.autoseeindex"><span class="styoptfmt">autoseeindex</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true <a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indicates whether or not to enable automatic <a id="wrglossary.23511"></a><a href="#glo:dual.indexing">indexing</a> of <a id="wrglossary.23512"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> and <a id="wrglossary.23513"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> fields. <a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.565">21</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23514"></a><span class="styoptfmt">autoseeindex</span>=<a href="#glo:optval.autoseeindex.false"><span class="optfmt">false</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Disables automatic <a id="wrglossary.23515"></a><a href="#glo:dual.indexing">indexing</a> of <a id="wrglossary.23516"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> and <a id="wrglossary.23517"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> fields. <a href="#wrglossary.619">22</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23518"></a><span class="styoptfmt">autoseeindex</span>=<a href="#glo:optval.autoseeindex.true"><span class="optfmt">true</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Enables automatic <a id="wrglossary.23519"></a><a href="#glo:dual.indexing">indexing</a> of <a id="wrglossary.23520"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> and <a id="wrglossary.23521"></a><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a> fields. <a href="#wrglossary.597">22</a><p>
+<div class="defnbox"><a id="wrglossary.23522"></a><a href="#glo:opt.bibglsaux"><span class="styoptfmt">bibglsaux</span></a>=<code class="code"><span class="meta">〈<em class="metainner">basename</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">empty</em></span> <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.23523"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(requires <a id="wrglossary.23524"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v3.0+)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+If set, an additional <a id="wrglossary.23525"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file called <span class="filefmt"></span><span class="meta">〈<em class="metainner">basename</em>〉</span><span class="filefmt">.aux</span> will be created in which to store the <a id="wrglossary.23526"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> records. This file will be skipped by LaTeX when the main <a id="wrglossary.23527"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file is input but will be read by <a id="wrglossary.23528"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. <a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.772">26</a><p>
+<div class="defnbox"><a id="wrglossary.23529"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Provides debugging information. Some options are also available with just the base <a id="wrglossary.23530"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. <a href="#sec:debuggingopts">§2.5</a>; <a href="#wrglossary.839">28</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23531"></a><span class="styoptfmt">debug</span>=<a href="#glo:optval.debug.all"><span class="optfmt">all</span></a><span class="floatrightbox"><a id="wrglossary.23532"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of optionvaluesummarybox -->
+<p>
+Implements all debugging options. <a href="#wrglossary.864">29</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23533"></a><span class="styoptfmt">debug</span>=<a href="#glo:optval.debug.false"><span class="optfmt">false</span></a><span class="floatrightbox"><a id="wrglossary.23534"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.24+</span><span class="clearfix"></span></div><!-- end of optionvaluesummarybox -->
+<p>
+Disable debugging actions. <a href="#wrglossary.843">28</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23535"></a><span class="styoptfmt">debug</span>=<a href="#glo:optval.debug.showaccsupp"><span class="optfmt">showaccsupp</span></a><span class="floatrightbox"><a id="wrglossary.23536"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.45+</span><span class="clearfix"></span></div><!-- end of optionvaluesummarybox -->
+<p>
+Implements <a id="wrglossary.23537"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=true</span> and also shows accessibility information in the document. <a href="#wrglossary.860">28</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23538"></a><span class="styoptfmt">debug</span>=<a href="#glo:optval.debug.showtargets"><span class="optfmt">showtargets</span></a><span class="floatrightbox"><a id="wrglossary.23539"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.24+</span><span class="clearfix"></span></div><!-- end of optionvaluesummarybox -->
+<p>
+Implements <a id="wrglossary.23540"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=true</span> and also shows target markers in the document. <a href="#wrglossary.882">29</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23541"></a><span class="styoptfmt">debug</span>=<a href="#glo:optval.debug.showwrgloss"><span class="optfmt">showwrgloss</span></a><span class="floatrightbox"><a id="wrglossary.23542"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of optionvaluesummarybox -->
+<p>
+Implements <a id="wrglossary.23543"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=true</span> and also shows a marker in the document whenever the entry is <a id="wrglossary.23544"></a><a href="#glo:@@glslabel@indexing">indexed</a> and (if used with <a id="wrglossary.23545"></a><a href="#glo:opt.indexcounter"><span class="styoptfmt">indexcounter</span></a>) will mark where the <a id="wrglossary.23546"></a><a href="#glo:ctr.wrglossary"><span class="ctrfmt">wrglossary</span></a> counter is incremented. <a href="#wrglossary.866">29</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23547"></a><span class="styoptfmt">debug</span>=<a href="#glo:optval.debug.true"><span class="optfmt">true</span></a><span class="floatrightbox"><a id="wrglossary.23548"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.24+</span><span class="clearfix"></span></div><!-- end of optionvaluesummarybox -->
+<p>
+Writes <code class="code">wrglossary(<span class="meta">〈<em class="metainner">type</em>〉</span>)(<span class="meta">〈<em class="metainner"><a id="wrglossary.23549"></a><a href="#glo:dual.indexing">indexing</a> info</em>〉</span>)</code> to the <a id="wrglossary.23550"></a><a href="#glo:ext.log"><span class="extfmt">log</span></a> file if there is an attempt to index an entry before the associated <a id="wrglossary.23551"></a><a href="#glo:dual.indexing">indexing</a> file has been opened (<a id="wrglossary.23552"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.23553"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> only). With <a id="wrglossary.23554"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, this setting will also display the label of any undefined entries that are referenced in the document. <a href="#wrglossary.846">28</a><p>
+<div class="defnbox"><a id="wrglossary.23555"></a><a href="#glo:opt.docdef"><span class="styoptfmt">docdef</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Determines whether or not <a id="wrglossary.23556"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is permitted in the <a id="wrglossary.23557"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment. <a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.365">16</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23558"></a><span class="styoptfmt">docdef</span>=<a href="#glo:optval.docdef.atom"><span class="optfmt">atom</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+As <span class="optfmt">restricted</span> but creates the <a id="wrglossary.23559"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file for atom’s autocomplete support. <a href="#wrglossary.418">17</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23560"></a><span class="styoptfmt">docdef</span>=<a href="#glo:optval.docdef.false"><span class="optfmt">false</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Don’t allow <a id="wrglossary.23561"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> in the <a id="wrglossary.23562"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment. <a href="#wrglossary.386">16</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23563"></a><span class="styoptfmt">docdef</span>=<a href="#glo:optval.docdef.restricted"><span class="optfmt">restricted</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Allow <a id="wrglossary.23564"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> in the <a id="wrglossary.23565"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment, but only before any <a id="wrglossary.23566"></a><a href="#glo:dual.glossary">glossaries</a>. <a href="#wrglossary.401">17</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23567"></a><span class="styoptfmt">docdef</span>=<a href="#glo:optval.docdef.true"><span class="optfmt">true</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Allow <a id="wrglossary.23568"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> in the <a id="wrglossary.23569"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment if the base <a id="wrglossary.23570"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package would allow it. <a href="#wrglossary.390">16</a><p>
+<div class="defnbox"><a id="wrglossary.23571"></a><a href="#glo:opt.equations"><span class="styoptfmt">equations</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Automatically switch the <a id="wrglossary.23572"></a><a href="#glo:dual.locationcounter">location counter</a> to <a id="wrglossary.23573"></a><a href="#glo:ctr.equation"><span class="ctrfmt">equation</span></a> when inside a numbered equation environment. <a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.788">26</a><p>
+<div class="defnbox"><a id="wrglossary.23574"></a><a href="#glo:opt.floats"><span class="styoptfmt">floats</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Automatically switch the <a id="wrglossary.23575"></a><a href="#glo:dual.locationcounter">location counter</a> to the corresponding counter when inside a floating environment. <a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.795">27</a><p>
+<div class="defnbox"><a id="wrglossary.23576"></a><a href="#glo:opt.indexcounter"><span class="styoptfmt">indexcounter</span></a><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines the index counter <a id="wrglossary.23577"></a><a href="#glo:ctr.wrglossary"><span class="ctrfmt">wrglossary</span></a> and implements <a id="wrglossary.23578"></a><a href="#glo:opt.counter"><span class="styoptfmt">counter</span></a><span class="optfmt">=wrglossary</span>. <a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.809">27</a><p>
+<div class="defnbox"><a id="wrglossary.23579"></a><a href="#glo:opt.indexcrossrefs"><span class="styoptfmt">indexcrossrefs</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">varies</em></span> <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indicates whether or not to enable automatic <a id="wrglossary.23580"></a><a href="#glo:dual.indexing">indexing</a> of cross-referenced entries. <a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.522">20</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23581"></a><span class="styoptfmt">indexcrossrefs</span>=<a href="#glo:optval.indexcrossrefs.false"><span class="optfmt">false</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Disables automatic <a id="wrglossary.23582"></a><a href="#glo:dual.indexing">indexing</a> of cross-referenced entries. <a href="#wrglossary.561">21</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23583"></a><span class="styoptfmt">indexcrossrefs</span>=<a href="#glo:optval.indexcrossrefs.true"><span class="optfmt">true</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Enables automatic <a id="wrglossary.23584"></a><a href="#glo:dual.indexing">indexing</a> of cross-referenced entries. <a href="#wrglossary.559">21</a><p>
+<div class="defnbox"><a id="wrglossary.23585"></a><a href="#glo:opt.nomissingglstext"><span class="styoptfmt">nomissingglstext</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Determines whether or not to display warning text if the external <a id="wrglossary.23586"></a><a href="#glo:dual.glossary">glossary</a> file hasn’t been generated due to an incomplete build. <a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.158">9</a><p>
+<div class="defnbox"><a id="wrglossary.23587"></a><a href="#glo:opt.postdot"><span class="styoptfmt">postdot</span></a><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a><a id="wrglossary.23588"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.12+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+A shortcut for <a id="wrglossary.23589"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=false</span>. <a href="#sec:glosstyleopts">§2.2</a>; <a href="#wrglossary.273">12</a><p>
+<div class="defnbox"><a id="wrglossary.23590"></a><a href="#glo:opt.postpunc"><span class="styoptfmt">postpunc</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.23591"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.21+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+An alternative to <a id="wrglossary.23592"></a><a href="#glo:opt.postdot"><span class="styoptfmt">postdot</span></a>, this can be used to insert a different punctuation character after the description. <a href="#sec:glosstyleopts">§2.2</a>; <a href="#wrglossary.275">12</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23593"></a><span class="styoptfmt">postpunc</span>=<a href="#glo:optval.postpunc.comma"><span class="optfmt">comma</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Inserts a comma after the description. <a href="#wrglossary.290">13</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23594"></a><span class="styoptfmt">postpunc</span>=<a href="#glo:optval.postpunc.dot"><span class="optfmt">dot</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Equivalent to <a id="wrglossary.23595"></a><a href="#glo:opt.postdot"><span class="styoptfmt">postdot</span></a> or <a id="wrglossary.23596"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=false</span>. <a href="#wrglossary.282">13</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23597"></a><span class="styoptfmt">postpunc</span>=<a href="#glo:optval.postpunc.none"><span class="optfmt">none</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Switches off automatic post-description punctuation insertion. <a href="#wrglossary.293">13</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23598"></a><span class="styoptfmt">postpunc</span>=<dfn id="glo:optval.postpunc.other"><span class="meta">〈<em class="metainner">punctuation</em>〉</span></dfn></div><!-- end of optionvaluesummarybox -->
+<p>
+Inserts <span class="meta">〈<em class="metainner">punctuation</em>〉</span> after the description.<p>
+<div class="defnbox"><a id="wrglossary.23599"></a><a href="#glo:opt.prefix"><span class="styoptfmt">prefix</span></a><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Loads <a id="wrglossary.23600"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>. <a href="#sec:otherpkgopts">§2.3</a>; <a href="#wrglossary.331">14</a><p>
+<div class="defnbox"><a id="wrglossary.23601"></a><a href="#glo:opt.record"><span class="styoptfmt">record</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>only; <span class="summarytag">initial: </span>off <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indicates whether or not <a id="wrglossary.23602"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> is being used (in which case entry <a id="wrglossary.23603"></a><a href="#glo:dual.indexing">indexing</a> is performed by adding <a id="wrglossary.23604"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> <a id="wrglossary.23605"></a><a href="#glo:@@glslabel@indexing">records</a> in the <a id="wrglossary.23606"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file). <a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.643">23</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23607"></a><span class="styoptfmt">record</span>=<a href="#glo:optval.record.alsoindex"><span class="optfmt">alsoindex</span></a><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="optfmt">hybrid</span><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></span><span class="clearfix"></span></div><!-- end of optionvaluesummarybox -->
+<p>
+ <a href="#wrglossary.733">25</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23608"></a><span class="styoptfmt">record</span>=<a href="#glo:optval.record.hybrid"><span class="optfmt">hybrid</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Performs a mixture of <a id="wrglossary.23609"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> <a id="wrglossary.23610"></a><a href="#glo:@@glslabel@indexing">records</a> in the <a id="wrglossary.23611"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file (to select entries from a <a id="wrglossary.23612"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file) and <a id="wrglossary.23613"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.23614"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> <a id="wrglossary.23615"></a><a href="#glo:dual.indexing">indexing</a> in their associated files. The actual sorting and collation is performed by the <a id="wrglossary.23616"></a><a href="#glo:dual.indexingapp">indexing application</a>, so <a id="wrglossary.23617"></a><a href="#glo:opt.resource.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=none</span> and <a id="wrglossary.23618"></a><a href="#glo:opt.resource.save-locations"><span class="csoptfmt">save-locations</span></a><span class="optfmt">=false</span> should be used in <a id="wrglossary.23619"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a> (because it’s redundant to make <a id="wrglossary.23620"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> sort and collate as well). This setting should be used with <a id="wrglossary.23621"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> before <a id="wrglossary.23622"></a><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a> and <a id="wrglossary.23623"></a><a href="#glo:dual.glossary">glossaries</a> should be displayed with <a id="wrglossary.23624"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> (or <a id="wrglossary.23625"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>). There’s little point in using this setting unless you have a custom <a id="wrglossary.23626"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> module that you can’t convert to an equivalent set of <a id="wrglossary.23627"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> options. <a href="#wrglossary.737">25</a>, <a href="#wrglossary.733">25</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23628"></a><span class="styoptfmt">record</span>=<a href="#glo:optval.record.nameref"><span class="optfmt">nameref</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Entry <a id="wrglossary.23629"></a><a href="#glo:dual.indexing">indexing</a> is performed by adding <a id="wrglossary.23630"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> nameref <a id="wrglossary.23631"></a><a href="#glo:@@glslabel@indexing">records</a> in the <a id="wrglossary.23632"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file. Glossaries should be displayed with the <a id="wrglossary.23633"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>. <a href="#wrglossary.714">24</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23634"></a><span class="styoptfmt">record</span>=<a href="#glo:optval.record.off"><span class="optfmt">off</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Entry <a id="wrglossary.23635"></a><a href="#glo:dual.indexing">indexing</a> is performed as per the base <a id="wrglossary.23636"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, using either <a id="wrglossary.23637"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> or <a id="wrglossary.23638"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a>. <a href="#wrglossary.665">23</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23639"></a><span class="styoptfmt">record</span>=<a href="#glo:optval.record.only"><span class="optfmt">only</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Entry <a id="wrglossary.23640"></a><a href="#glo:dual.indexing">indexing</a> is performed by adding <a id="wrglossary.23641"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> <a id="wrglossary.23642"></a><a href="#glo:@@glslabel@indexing">records</a> in the <a id="wrglossary.23643"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file. Glossaries should be displayed with the <a id="wrglossary.23644"></a><a href="#glo:dual.unsrtfam"><span class="qt">“unsrt”</span> family of commands</a>. <a href="#wrglossary.672">24</a><p>
+<div class="defnbox"><a id="wrglossary.23645"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a>=<code class="code">{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">initial: </span>none <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Defines various shortcut commands (boolean only with just the base <a id="wrglossary.23646"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package). <a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.441">17</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23647"></a><span class="styoptfmt">shortcuts</span>=<a href="#glo:optval.shortcuts.abbr"><span class="optfmt">abbr</span></a><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="optfmt">abbreviations</span></span><span class="clearfix"></span></div><!-- end of optionvaluesummarybox -->
+<p>
+ <a href="#wrglossary.457">18</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23648"></a><span class="styoptfmt">shortcuts</span>=<a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Implements the abbreviation shortcuts. <a href="#wrglossary.454">18</a>, <a href="#wrglossary.457">18</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23649"></a><span class="styoptfmt">shortcuts</span>=<a href="#glo:optval.shortcuts.abother"><span class="optfmt">abother</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Implements <a id="wrglossary.23650"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=abbreviations</span> and <a id="wrglossary.23651"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=other</span>. <a href="#wrglossary.476">19</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23652"></a><span class="styoptfmt">shortcuts</span>=<a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Implements the acronym shortcuts that are compatible with <a id="wrglossary.23653"></a><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a>. <a href="#wrglossary.445">18</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23654"></a><span class="styoptfmt">shortcuts</span>=<a href="#glo:optval.shortcuts.acother"><span class="optfmt">acother</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Implements <a id="wrglossary.23655"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=ac</span> and <a id="wrglossary.23656"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=other</span>. <a href="#wrglossary.471">19</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23657"></a><span class="styoptfmt">shortcuts</span>=<a href="#glo:optval.shortcuts.acro"><span class="optfmt">acro</span></a><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="optfmt">acronyms</span></span><span class="clearfix"></span></div><!-- end of optionvaluesummarybox -->
+<p>
+ <a href="#wrglossary.506">19</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23658"></a><span class="styoptfmt">shortcuts</span>=<a href="#glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Implements the acronym shortcuts. Don’t use this option unless you have reverted <a id="wrglossary.23659"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> back to the base <a id="wrglossary.23660"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s acronym mechanism. <a href="#wrglossary.488">19</a>, <a href="#wrglossary.506">19</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23661"></a><span class="styoptfmt">shortcuts</span>=<a href="#glo:optval.shortcuts.all"><span class="optfmt">all</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Implements <a id="wrglossary.23662"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=ac</span>, <a id="wrglossary.23663"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=abbreviations</span>, <a id="wrglossary.23664"></a><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="optfmt">=other</span>. <a href="#wrglossary.481">19</a>, <a href="#wrglossary.510">19</a>, <a href="#wrglossary.516">20</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23665"></a><span class="styoptfmt">shortcuts</span>=<a href="#glo:optval.shortcuts.false"><span class="optfmt">false</span></a><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="optfmt">all</span></span><span class="clearfix"></span></div><!-- end of optionvaluesummarybox -->
+<p>
+ <a href="#wrglossary.516">20</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23666"></a><span class="styoptfmt">shortcuts</span>=<dfn id="glo:optval.shortcuts.none"><span class="optfmt">none</span></dfn></div><!-- end of optionvaluesummarybox -->
+<p>
+Don’t define any shortcut commands.<p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23667"></a><span class="styoptfmt">shortcuts</span>=<a href="#glo:optval.shortcuts.other"><span class="optfmt">other</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Implements the shortcuts <a id="wrglossary.23668"></a><a href="#glo:newentry"><code class="csfmt">\newentry</code></a>, <a id="wrglossary.23669"></a><a href="#glo:newsym"><code class="csfmt">\newsym</code></a> and <a id="wrglossary.23670"></a><a href="#glo:newnum"><code class="csfmt">\newnum</code></a>. <a href="#wrglossary.461">18</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23671"></a><span class="styoptfmt">shortcuts</span>=<a href="#glo:optval.shortcuts.true"><span class="optfmt">true</span></a><span class="floatrightbox"><span class="summarytag">alias: </span> <span class="optfmt">all</span></span><span class="clearfix"></span></div><!-- end of optionvaluesummarybox -->
+<p>
+ <a href="#wrglossary.510">19</a><p>
+<div class="defnbox"><a id="wrglossary.23672"></a><a href="#glo:opt.showtargets"><span class="styoptfmt">showtargets</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.23673"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.48+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Implements <a id="wrglossary.23674"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.23675"></a><a href="#glo:optval.debug.showtargets"><span class="optfmt">showtargets</span></a>. <a href="#sec:debuggingopts">§2.5</a>; <a href="#wrglossary.894">29</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23676"></a><span class="styoptfmt">showtargets</span>=<a href="#glo:optval.showtargets.annoteleft"><span class="optfmt">annoteleft</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Markers are placed on either side of the link/target with the annotation on the left in all modes. <a href="#wrglossary.918">31</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23677"></a><span class="styoptfmt">showtargets</span>=<a href="#glo:optval.showtargets.annoteright"><span class="optfmt">annoteright</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Markers are placed on either side of the link/target with the annotation on the right in all modes. <a href="#wrglossary.920">31</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23678"></a><span class="styoptfmt">showtargets</span>=<a href="#glo:optval.showtargets.innerleft"><span class="optfmt">innerleft</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+A marker and annotation are placed to the left of the link/target in all modes. <a href="#wrglossary.914">31</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23679"></a><span class="styoptfmt">showtargets</span>=<a href="#glo:optval.showtargets.innerright"><span class="optfmt">innerright</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+A marker and annotation are placed to the left of the link/target in all modes. <a href="#wrglossary.916">31</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23680"></a><span class="styoptfmt">showtargets</span>=<a href="#glo:optval.showtargets.left"><span class="optfmt">left</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+A marker is placed to the left of the link/target and a marginal note is used in outer mode. <a href="#wrglossary.910">30</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23681"></a><span class="styoptfmt">showtargets</span>=<a href="#glo:optval.showtargets.right"><span class="optfmt">right</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+A marker is placed to the right of the link/target and a marginal note is used in outer mode. <a href="#wrglossary.912">30</a><p>
+<div class="defnbox"><a id="wrglossary.23682"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>default <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Loads <a id="wrglossary.23683"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> with the given options. If <a id="wrglossary.23684"></a><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a><span class="optfmt">=</span><a id="wrglossary.23685"></a><a href="#glo:optval.stylemods.default"><span class="optfmt">default</span></a> then no options are passed to <a id="wrglossary.23686"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a>. <a href="#sec:glosstyleopts">§2.2</a>; <a href="#wrglossary.298">13</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23687"></a><span class="styoptfmt">stylemods</span>=<a href="#glo:optval.stylemods.all"><span class="optfmt">all</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Load <a id="wrglossary.23688"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> with all predefined styles. <a href="#wrglossary.302">13</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23689"></a><span class="styoptfmt">stylemods</span>=<a href="#glo:optval.stylemods.default"><span class="optfmt">default</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Load <a id="wrglossary.23690"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> with no options (patches any predefined styles that have been loaded). <a href="#wrglossary.306">13</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23691"></a><span class="styoptfmt">stylemods</span>=<a href="#glo:optval.stylemods.list"><span class="meta">〈<em class="metainner">list</em>〉</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Load <a id="wrglossary.23692"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> with all the listed styles. <a href="#wrglossary.317">14</a><p>
+<div class="defnbox"><a id="wrglossary.23693"></a><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>error <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indicates whether to trigger an error or warning if an unknown entry label is referenced. <a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.344">15</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23694"></a><span class="styoptfmt">undefaction</span>=<a href="#glo:optval.undefaction.error"><span class="optfmt">error</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Trigger an error if an unknown entry label is referenced. <a href="#wrglossary.349">15</a><p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23695"></a><span class="styoptfmt">undefaction</span>=<a href="#glo:optval.undefaction.warn"><span class="optfmt">warn</span></a></div><!-- end of optionvaluesummarybox -->
+<p>
+Trigger a warning if an unknown entry label is referenced. <a href="#wrglossary.352">15</a><p>
+<div class="defnbox"><a id="wrglossary.23696"></a><code class="cmd">\usepackage</code>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<dfn id="glo:pkg.glossaries"><span class="styfmt">glossaries</span></dfn>}<p>
+<div class="noteBox"><span style="font-size: small; ">(automatically loaded with <code class="code"><code class="csfmt">\usepackage</code>{glossaries-extra}</code>)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Base package. When loaded implicitly with <a id="wrglossary.23697"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, any relevant options will be passed to the base <a id="wrglossary.23698"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package.<p>
+<div class="defnbox"><a id="wrglossary.23699"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If true, provides a new <a id="wrglossary.23700"></a><a href="#glo:dual.glossary">glossary</a> with the label <code class="code">acronym</code> and title given by <a id="wrglossary.23701"></a><a href="#glo:acronymname"><code class="csfmt">\acronymname</code></a>, redefines <a id="wrglossary.23702"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> to <code class="code">acronym</code>, and provides <a id="wrglossary.23703"></a><a href="#glo:printacronyms"><code class="csfmt">\printacronyms</code></a>. <a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.234">11</a><p>
+<div class="defnbox"><a id="wrglossary.23704"></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><dfn id="glo:opt.acronymlists"><span class="styoptfmt">acronymlists</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">label-list</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Identifies the <a id="wrglossary.23705"></a><a href="#glo:dual.glossary">glossaries</a> that contain acronyms (defined with the base <a id="wrglossary.23706"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> packages acronym mechanism).<p>
+<div class="defnbox"><a id="wrglossary.23707"></a><a href="#glo:opt.acronyms"><span class="styoptfmt">acronyms</span></a><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Provides a new <a id="wrglossary.23708"></a><a href="#glo:dual.glossary">glossary</a> with the label <code class="code">acronym</code>, redefines <a id="wrglossary.23709"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> to <code class="code">acronym</code>, and provides <a id="wrglossary.23710"></a><a href="#glo:printacronyms"><code class="csfmt">\printacronyms</code></a>. <a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.225">11</a><p>
+<div class="defnbox"><a id="wrglossary.23711"></a><dfn id="glo:opt.automake"><span class="styoptfmt">automake</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indicates whether or not to attempt to use TeX’s shell escape to run an <a id="wrglossary.23712"></a><a href="#glo:dual.indexingapp">indexing application</a>.<p>
+<div class="defnbox"><a id="wrglossary.23713"></a><dfn id="glo:opt.counter"><span class="styoptfmt">counter</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">counter-name</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>page <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the default <a id="wrglossary.23714"></a><a href="#glo:dual.locationcounter">location counter</a>.<p>
+<div class="defnbox"><a id="wrglossary.23715"></a><dfn id="glo:opt.base.debug"><span class="styoptfmt">debug</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>false <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a><a id="wrglossary.23716"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.24+</span><span class="clearfix"></span><p>
+<div class="noteBox"><span style="font-size: small; ">(modified by <a id="wrglossary.23717"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span>’s</a> <a id="wrglossary.23718"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a> option)</span></div><!-- end of noteBox -->
+</div><!-- end of defnbox -->
+<p>
+Adds markers to the document for debugging purposes.<p>
+<div class="defnbox"><a id="wrglossary.23719"></a><dfn id="glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></dfn><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Enables the entry counter for top-level entries.<p>
+<div class="defnbox"><a id="wrglossary.23720"></a><dfn id="glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true <a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indicates whether or not to use hyperlinks on <a id="wrglossary.23721"></a><a href="#glo:dual.firstuse">first use</a> (if hyperlinks are supported).<p>
+<div class="defnbox"><a id="wrglossary.23722"></a><a href="#glo:opt.index"><span class="styoptfmt">index</span></a><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Provides a new <a id="wrglossary.23723"></a><a href="#glo:dual.glossary">glossary</a> with the label <code class="code">index</code> and the title <a id="wrglossary.23724"></a><a href="#glo:indexname"><code class="csfmt">\indexname</code></a>, and provides <a id="wrglossary.23725"></a><a href="#glo:printindex"><code class="csfmt">\printindex</code></a> and <a id="wrglossary.23726"></a><a href="#glo:newterm"><code class="csfmt">\newterm</code></a>. <a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.240">11</a><p>
+<div class="defnbox"><a id="wrglossary.23727"></a><dfn id="glo:opt.indexonlyfirst"><span class="styoptfmt">indexonlyfirst</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indicates whether or not to only <a id="wrglossary.23728"></a><a href="#glo:@@glslabel@indexing">index</a> the <a id="wrglossary.23729"></a><a href="#glo:dual.firstuse">first use</a>.<p>
+<div class="defnbox"><a id="wrglossary.23730"></a><dfn id="glo:opt.makeindex"><span class="styoptfmt">makeindex</span></dfn><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indicates that the <a id="wrglossary.23731"></a><a href="#glo:dual.indexing">indexing</a> should be performed by <a id="wrglossary.23732"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> (default).<p>
+<div class="defnbox"><a id="wrglossary.23733"></a><dfn id="glo:opt.mfirstuc"><span class="styoptfmt">mfirstuc</span></dfn><span class="floatrightbox"><span class="summarytag">initial: </span>unexpanded <a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a><a id="wrglossary.23734"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+</span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Implements the <span class="optfmt">expanded</span> and <span class="optfmt">unexpanded</span> options provided by <a id="wrglossary.23735"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>.<p>
+<div class="defnbox"><a id="wrglossary.23736"></a><dfn id="glo:opt.nogroupskip"><span class="styoptfmt">nogroupskip</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If true, suppress the gap between letter <a id="wrglossary.23737"></a><a href="#glo:idx.group">groups</a> in the <a id="wrglossary.23738"></a><a href="#glo:dual.glossary">glossaries</a> by default.<p>
+<div class="defnbox"><a id="wrglossary.23739"></a><dfn id="glo:opt.nolist"><span class="styoptfmt">nolist</span></dfn><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Don’t load <a id="wrglossary.23740"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a>, which is normally loaded automatically. Note that if <a id="wrglossary.23741"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> is loaded before <a id="wrglossary.23742"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, then this option should be passed directly to <a id="wrglossary.23743"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> not <a id="wrglossary.23744"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> otherwise it will be too late to implement.<p>
+<div class="defnbox"><a id="wrglossary.23745"></a><dfn id="glo:opt.nolong"><span class="styoptfmt">nolong</span></dfn><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Don’t load <a id="wrglossary.23746"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a>, which is normally loaded automatically. Note that if <a id="wrglossary.23747"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> is loaded before <a id="wrglossary.23748"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, then this option should be passed directly to <a id="wrglossary.23749"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> not <a id="wrglossary.23750"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> otherwise it will be too late to implement.<p>
+<div class="defnbox"><a id="wrglossary.23751"></a><dfn id="glo:opt.nomain"><span class="styoptfmt">nomain</span></dfn><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Prevents the definition of the <code class="code">main</code> <a id="wrglossary.23752"></a><a href="#glo:dual.glossary">glossary</a>. You will need to define another <a id="wrglossary.23753"></a><a href="#glo:dual.glossary">glossary</a> to use instead. For example, with the <a id="wrglossary.23754"></a><a href="#glo:opt.acronyms"><span class="styoptfmt">acronyms</span></a> package option.<p>
+<div class="defnbox"><a id="wrglossary.23755"></a><dfn id="glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></dfn><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Set no <a id="wrglossary.23756"></a><a href="#glo:locationlist">location lists</a> as the default for all <a id="wrglossary.23757"></a><a href="#glo:dual.glossary">glossaries</a>. May be overridden for individual <a id="wrglossary.23758"></a><a href="#glo:dual.glossary">glossaries</a> with <a id="wrglossary.23759"></a><a href="#glo:opt.printgloss.nonumberlist"><span class="csoptfmt">nonumberlist</span></a><span class="optfmt">=true</span>.<p>
+<div class="defnbox"><a id="wrglossary.23760"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true <a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If true, suppresses the automatic insertion of a <a id="wrglossary.23761"></a><a href="#glo:idx.fullstop">full stop</a> after each entry’s description in the <a id="wrglossary.23762"></a><a href="#glo:dual.glossary">glossary</a> (for styles that support this). The default is <a id="wrglossary.23763"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=true</span> for <a id="wrglossary.23764"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and <a id="wrglossary.23765"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=false</span> for just <a id="wrglossary.23766"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>. <a href="#sec:glosstyleopts">§2.2</a>; <a href="#wrglossary.259">12</a><p>
+<div class="defnbox"><a id="wrglossary.23767"></a><dfn id="glo:opt.noredefwarn"><span class="styoptfmt">noredefwarn</span></dfn><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Suppresses a warning if <a id="wrglossary.23768"></a><a href="#glo:env.theglossary"><span class="envfmt">theglossary</span></a> or <a id="wrglossary.23769"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> have already been defined (which indicates that the document class or another package also provides a mechanism for creating a <a id="wrglossary.23770"></a><a href="#glo:dual.glossary">glossary</a> that could potentially conflict with <a id="wrglossary.23771"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>). This option is automatically implemented with <a id="wrglossary.23772"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.<p>
+<div class="defnbox"><a id="wrglossary.23773"></a><dfn id="glo:opt.nostyles"><span class="styoptfmt">nostyles</span></dfn><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Don’t load the default set of predefined styles. Note that if <a id="wrglossary.23774"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> is loaded before <a id="wrglossary.23775"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, then this option should be passed directly to <a id="wrglossary.23776"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> not <a id="wrglossary.23777"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> otherwise it will be too late to implement.<p>
+<div class="defnbox"><a id="wrglossary.23778"></a><dfn id="glo:opt.nosuper"><span class="styoptfmt">nosuper</span></dfn><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Don’t load <a id="wrglossary.23779"></a><a href="#glo:pkg.glossary-super"><span class="styfmt">glossary-super</span></a>, which is normally loaded automatically. Note that if <a id="wrglossary.23780"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> is loaded before <a id="wrglossary.23781"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, then this option should be passed directly to <a id="wrglossary.23782"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> not <a id="wrglossary.23783"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> otherwise it will be too late to implement.<p>
+<div class="defnbox"><a id="wrglossary.23784"></a><dfn id="glo:opt.notranslate"><span class="styoptfmt">notranslate</span></dfn><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Equivalent to <a id="wrglossary.23785"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=false</span>.<p>
+<div class="defnbox"><a id="wrglossary.23786"></a><dfn id="glo:opt.notree"><span class="styoptfmt">notree</span></dfn><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Don’t load <a id="wrglossary.23787"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a>, which is normally loaded automatically. Note that if <a id="wrglossary.23788"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> is loaded before <a id="wrglossary.23789"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, then this option should be passed directly to <a id="wrglossary.23790"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> not <a id="wrglossary.23791"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> otherwise it will be too late to implement.<p>
+<div class="defnbox"><a id="wrglossary.23792"></a><dfn id="glo:opt.nowarn"><span class="styoptfmt">nowarn</span></dfn><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Suppresses warnings.<p>
+<div class="defnbox"><a id="wrglossary.23793"></a><dfn id="glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>nolabel; <span class="summarytag">initial: </span>false <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indicates whether or not <a id="wrglossary.23794"></a><a href="#glo:dual.glossary">glossary</a> section headers will be numbered and also if they should automatically be labelled.<p>
+<div class="defnbox"><a id="wrglossary.23795"></a><a href="#glo:opt.numbers"><span class="styoptfmt">numbers</span></a><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Provides a new <a id="wrglossary.23796"></a><a href="#glo:dual.glossary">glossary</a> with the label <code class="code">numbers</code> and the title <a id="wrglossary.23797"></a><a href="#glo:glsnumbersgroupname"><code class="csfmt">\glsnumbersgroupname</code></a>, and provides <a id="wrglossary.23798"></a><a href="#glo:printnumbers"><code class="csfmt">\printnumbers</code></a>. With <a id="wrglossary.23799"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, this additionally defines <a id="wrglossary.23800"></a><a href="#glo:glsxtrnewnumber"><code class="csfmt">\glsxtrnewnumber</code></a>. <a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.207">11</a><p>
+<div class="defnbox"><a id="wrglossary.23801"></a><dfn id="glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">varies</em></span> <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indicates whether the default sort value should be sanitized (only applicable with <a id="wrglossary.23802"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.23803"></a><a href="#glo:optval.sort.standard"><span class="optfmt">standard</span></a>).<p>
+<div class="defnbox"><a id="wrglossary.23804"></a><dfn id="glo:opt.savenumberlist"><span class="styoptfmt">savenumberlist</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false <a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If true, patches the <a id="wrglossary.23805"></a><a href="#glo:dual.locationlist">location list</a> encapsulator to save the <a id="wrglossary.23806"></a><a href="#glo:dual.locationlist">location list</a>. With <a id="wrglossary.23807"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, use the <a id="wrglossary.23808"></a><a href="#glo:opt.resource.save-locations"><span class="csoptfmt">save-locations</span></a> resource option.<p>
+<div class="defnbox"><a id="wrglossary.23809"></a><dfn id="glo:opt.section"><span class="styoptfmt">section</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>section <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indicates which section heading command to use for the <a id="wrglossary.23810"></a><a href="#glo:dual.glossary">glossary</a>. The value may be one of the standard sectioning command’s control sequence name (without the leading backslash), such as <code class="code">chapter</code> or <code class="code">section</code>.<p>
+<div class="defnbox"><a id="wrglossary.23811"></a><dfn id="glo:opt.seenoindex"><span class="styoptfmt">seenoindex</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>error <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indicates what to do if the <a id="wrglossary.23812"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key is used before the associated <a id="wrglossary.23813"></a><a href="#glo:dual.indexing">indexing</a> files have been opened by <a id="wrglossary.23814"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>.<p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23815"></a><span class="styoptfmt">seenoindex</span>=<dfn id="glo:optval.seenoindex.error"><span class="optfmt">error</span></dfn></div><!-- end of optionvaluesummarybox -->
+<p>
+Triggers an error if the <a id="wrglossary.23816"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key is used before <a id="wrglossary.23817"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>.<p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23818"></a><span class="styoptfmt">seenoindex</span>=<dfn id="glo:optval.seenoindex.ignore"><span class="optfmt">ignore</span></dfn></div><!-- end of optionvaluesummarybox -->
+<p>
+Does nothing if the <a id="wrglossary.23819"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key is used before <a id="wrglossary.23820"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>.<p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23821"></a><span class="styoptfmt">seenoindex</span>=<dfn id="glo:optval.seenoindex.warn"><span class="optfmt">warn</span></dfn></div><!-- end of optionvaluesummarybox -->
+<p>
+Triggers a warning if the <a id="wrglossary.23822"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key is used before <a id="wrglossary.23823"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>.<p>
+<div class="defnbox"><a id="wrglossary.23824"></a><dfn id="glo:opt.sort"><span class="styoptfmt">sort</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>standard <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indicates how the <a id="wrglossary.23825"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key should automatically be assigned if not explicitly provided (for <a id="wrglossary.23826"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> and <a id="wrglossary.23827"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> only).<p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23828"></a><span class="styoptfmt">sort</span>=<dfn id="glo:optval.sort.clear"><span class="optfmt">clear</span></dfn><span class="floatrightbox"><a id="wrglossary.23829"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+</span><span class="clearfix"></span></div><!-- end of optionvaluesummarybox -->
+<p>
+Sets the <a id="wrglossary.23830"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key to an empty value. Use this option if no <a id="wrglossary.23831"></a><a href="#glo:dual.indexing">indexing</a> is required for a slightly faster build.<p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23832"></a><span class="styoptfmt">sort</span>=<dfn id="glo:optval.sort.def"><span class="optfmt">def</span></dfn></div><!-- end of optionvaluesummarybox -->
+<p>
+Use the (zero-padded) order of definition as the default for the <a id="wrglossary.23833"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key.<p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23834"></a><span class="styoptfmt">sort</span>=<dfn id="glo:optval.sort.none"><span class="optfmt">none</span></dfn><span class="floatrightbox"><a id="wrglossary.23835"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.30+</span><span class="clearfix"></span></div><!-- end of optionvaluesummarybox -->
+<p>
+Don’t process the <a id="wrglossary.23836"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key. Use this option if no <a id="wrglossary.23837"></a><a href="#glo:dual.indexing">indexing</a> is required for a slightly faster build.<p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23838"></a><span class="styoptfmt">sort</span>=<dfn id="glo:optval.sort.standard"><span class="optfmt">standard</span></dfn></div><!-- end of optionvaluesummarybox -->
+<p>
+Use the value of the <a id="wrglossary.23839"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key as the default for the <a id="wrglossary.23840"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key and implement the <a id="wrglossary.23841"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a> hook.<p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23842"></a><span class="styoptfmt">sort</span>=<dfn id="glo:optval.sort.use"><span class="optfmt">use</span></dfn></div><!-- end of optionvaluesummarybox -->
+<p>
+Use the (zero-padded) order of use as the default for the <a id="wrglossary.23843"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key.<p>
+<div class="defnbox"><a id="wrglossary.23844"></a><dfn id="glo:opt.style"><span class="styoptfmt">style</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">style-name</em>〉</span></code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Sets the default <a id="wrglossary.23845"></a><a href="#glo:idx.glossarystyle">glossary style</a> to <span class="meta">〈<em class="metainner">style-name</em>〉</span>.<p>
+<div class="defnbox"><a id="wrglossary.23846"></a><dfn id="glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></dfn><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Enables the entry counter for level 1 entries.<p>
+<div class="defnbox"><a id="wrglossary.23847"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Provides a new <a id="wrglossary.23848"></a><a href="#glo:dual.glossary">glossary</a> with the label <code class="code">symbols</code> and the title <a id="wrglossary.23849"></a><a href="#glo:glssymbolsgroupname"><code class="csfmt">\glssymbolsgroupname</code></a>, and provides <a id="wrglossary.23850"></a><a href="#glo:printsymbols"><code class="csfmt">\printsymbols</code></a>. With <a id="wrglossary.23851"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, this additionally defines <a id="wrglossary.23852"></a><a href="#glo:glsxtrnewsymbol"><code class="csfmt">\glsxtrnewsymbol</code></a>. <a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.189">10</a><p>
+<div class="defnbox"><a id="wrglossary.23853"></a><dfn id="glo:opt.toc"><span class="styoptfmt">toc</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true <a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+If true, each <a id="wrglossary.23854"></a><a href="#glo:dual.glossary">glossary</a> will be automatically added to the table of contents. The default is <a id="wrglossary.23855"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=false</span> with <a id="wrglossary.23856"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> and <a id="wrglossary.23857"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=true</span> with <a id="wrglossary.23858"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.<p>
+<div class="defnbox"><a id="wrglossary.23859"></a><dfn id="glo:opt.translate"><span class="styoptfmt">translate</span></dfn>=<code class="code"><span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>babel <a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indicates how multilingual support should be provided, if applicable.<p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23860"></a><span class="styoptfmt">translate</span>=<dfn id="glo:optval.translate.babel"><span class="optfmt">babel</span></dfn></div><!-- end of optionvaluesummarybox -->
+<p>
+Uses <a id="wrglossary.23861"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span>’s</a> language hooks to implement multilingual support (default for <a id="wrglossary.23862"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> if <a id="wrglossary.23863"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> has been detected).<p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23864"></a><span class="styoptfmt">translate</span>=<dfn id="glo:optval.translate.false"><span class="optfmt">false</span></dfn></div><!-- end of optionvaluesummarybox -->
+<p>
+Don’t implement multilingual support (default if no language package has been detected).<p>
+<div class="optionvaluesummarybox"><a id="wrglossary.23865"></a><span class="styoptfmt">translate</span>=<dfn id="glo:optval.translate.true"><span class="optfmt">true</span></dfn></div><!-- end of optionvaluesummarybox -->
+<p>
+Uses <a id="wrglossary.23866"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span>’s</a> language hooks to implement multilingual support (default for <a id="wrglossary.23867"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> if a language package has been detected).<p>
+<div class="defnbox"><a id="wrglossary.23868"></a><dfn id="glo:opt.writeglslabelnames"><span class="styoptfmt">writeglslabelnames</span></dfn><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Creates a file called <code class="csfmt">\jobname</code><span class="filefmt">.</span><a id="wrglossary.23869"></a><a href="#glo:ext.glslabels"><span class="extfmt">glslabels</span></a> that contains all defined entry labels and names (for the benefit of autocompletion tools).<p>
+<div class="defnbox"><a id="wrglossary.23870"></a><dfn id="glo:opt.writeglslabels"><span class="styoptfmt">writeglslabels</span></dfn><span class="floatrightbox"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Creates a file called <code class="csfmt">\jobname</code><span class="filefmt">.</span><a id="wrglossary.23871"></a><a href="#glo:ext.glslabels"><span class="extfmt">glslabels</span></a> that contains all defined entry labels (for the benefit of autocompletion tools).<p>
+<div class="defnbox"><a id="wrglossary.23872"></a><dfn id="glo:opt.xindy"><span class="styoptfmt">xindy</span></dfn>=<code class="code">{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code><span class="floatrightbox"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></span><span class="clearfix"></span></div><!-- end of defnbox -->
+<p>
+Indicates that the <a id="wrglossary.23873"></a><a href="#glo:dual.indexing">indexing</a> should be performed by <a id="wrglossary.23874"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.<p>
+<p>
+
+</section><!-- end of section styoptsummary -->
+
+<section id="index"><!-- start of section index --><div class="tomain"><a href="#main">[top]</a></div>
+<h1><!-- start of chapter header -->Index<div class="labellink"><a href="#index">[link]</a></div></h1><!-- end of chapter header -->
+<div class="nlctusernavbox"><a href="#indexglssymbols">Symbols</a> <a href="#index@">@</a> <a href="#index6553600">A</a> <a href="#index6619136">B</a> <a href="#index6684672">C</a> <a href="#index6750208">D</a> <a href="#index6815744">E</a> <a href="#index6881280">F</a> <a href="#index6946816">G</a> <a href="#index7012352">Glo</a> <a href="#index7077888">Gls</a> <a href="#index7143424">Glsxtr</a> <a href="#index7208960">H</a> <a href="#index7274496">I</a> <a href="#index7340032">J</a> <a href="#index7405568">K</a> <a href="#index7471104">L</a> <a href="#index7536640">M</a> <a href="#index7602176">N</a> <a href="#index7667712">O</a> <a href="#index7733248">P</a> <a href="#index7798784">Q</a> <a href="#index7864320">R</a> <a href="#index7929856">S</a> <a href="#index7995392">T</a> <a href="#index8060928">U</a> <a href="#index8192000">W</a> <a href="#index8257536">X</a> <a href="#index8388608">Z</a></div><!-- end of nlctusernavbox -->
+
+</section><!-- end of section index -->
+
+<section id="indexglssymbols"><!-- start of section indexglssymbols --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->Symbols<div class="labellink"><a href="#indexglssymbols">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.unknowntag"><code class="code">??</code> (unknown entry marker)</dfn><span class="qquad"></span><a href="#wrglossary.355">15</a>, <a href="#wrglossary.854">28</a>, <a href="#wrglossary.1145">37</a>, <a href="#wrglossary.1154">38</a>, <a href="#wrglossary.12475">511</a>, <a href="#wrglossary.12478">512</a>, <a href="#wrglossary.17299">703</a>, <a href="#wrglossary.21864">883</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.sym.fullstop"><code class="code">.</code> (full stop or period)</dfn><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:idx.fullstop">full stop (<code class="code">.</code>)</a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.sym.nbsp"><code class="code">~</code> (non-breaking space)</dfn><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:idx.nbsp">non-breaking space (<code class="code">~</code>)</a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:dollar"><code class="csfmt">\$</code></dfn><span class="qquad"></span><a href="#wrglossary.13087">535</a>, <a href="#wrglossary.17158">698</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.mod.star"><span style="font-family: monospace; ">*</span> (modifier)</dfn><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:GlsXtrSetStarModifier"><code class="csfmt">\GlsXtrSetStarModifier</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:amp"><code class="csfmt">\&amp;</code></dfn></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.sym.hash"><code class="code">#</code></dfn><span class="qquad"></span><a href="#wrglossary.13083">535</a>, <a href="#wrglossary.17999">728</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.mod.plus"><span style="font-family: monospace; ">+</span> (modifier)</dfn><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:GlsXtrSetPlusModifier"><code class="csfmt">\GlsXtrSetPlusModifier</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section indexglssymbols -->
+
+<section id="index@"><!-- start of section index@ --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->@<div class="labellink"><a href="#index@">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><dfn id="glo:@currentHref"><code class="csfmt">\@currentHref</code></dfn><span class="qquad"></span><a href="#wrglossary.720">24</a>, <a href="#wrglossary.725">25</a>, <a href="#wrglossary.13549">555</a>, <a href="#wrglossary.13586">557</a>, <a href="#wrglossary.21276">859</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:@currentlabel"><code class="csfmt">\@currentlabel</code></dfn><span class="qquad"></span><a href="#wrglossary.719">24</a>, <a href="#wrglossary.727">25</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:@currentlabelname"><code class="csfmt">\@currentlabelname</code></dfn><span class="qquad"></span><a href="#wrglossary.13548">555</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:@endfortrue"><code class="csfmt">\@endfortrue</code></dfn><span class="qquad"></span><a href="#wrglossary.7811">301</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:@firstofone"><code class="csfmt">\@firstofone</code></dfn><span class="qquad"></span><a href="#wrglossary.6157">240</a>, <a href="#wrglossary.7695">296</a>, <a href="#wrglossary.13641">560</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:@firstoftwo"><code class="csfmt">\@firstoftwo</code></dfn><span class="qquad"></span><a href="#wrglossary.1537">52</a>, <a href="#wrglossary.5494">214</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:@for"><code class="csfmt">\@for</code></dfn><span class="qquad"></span><a href="#wrglossary.7810">301</a>, <a href="#wrglossary.9330">371</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:@gobble"><code class="csfmt">\@gobble</code></dfn><span class="qquad"></span><a href="#wrglossary.10470">409</a>, <a href="#wrglossary.10797">424</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:@glsxtr@doglossary"><code class="csfmt">\@glsxtr@doglossary</code></a><span class="qquad"></span><a href="#sec:printunsrtadvanced">§8.4.3</a>; <a href="#wrglossary.10216">399</a>, <a href="#wrglossary.10250">401</a>, <span class="summarylocfmt"><a href="#wrglossary.15638">652</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:@glsxtr@multientry"><code class="csfmt">\@glsxtr@multientry</code></a><span class="qquad"></span><a href="#sec:multiextras">§7.13</a>; <a href="#wrglossary.9341">371</a>, <span class="summarylocfmt"><a href="#wrglossary.15643">652</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:@glsxtr@org@@starttoc"><code class="csfmt">\@glsxtr@org@@starttoc</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5822">227</a>, <span class="summarylocfmt"><a href="#wrglossary.15646">652</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:@glsxtr@org@markboth"><code class="csfmt">\@glsxtr@org@markboth</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5820">227</a>, <span class="summarylocfmt"><a href="#wrglossary.15649">652</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:@glsxtr@org@markright"><code class="csfmt">\@glsxtr@org@markright</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5818">227</a>, <span class="summarylocfmt"><a href="#wrglossary.15652">652</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:@glsxtrinmark"><code class="csfmt">\@glsxtrinmark</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5832">227</a>, <a href="#wrglossary.10636">418</a>, <span class="summarylocfmt"><a href="#wrglossary.15655">652</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:@glsxtrnotinmark"><code class="csfmt">\@glsxtrnotinmark</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5834">227</a>, <a href="#wrglossary.10637">418</a>, <span class="summarylocfmt"><a href="#wrglossary.15658">653</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:@secondoftwo"><code class="csfmt">\@secondoftwo</code></dfn><span class="qquad"></span><a href="#wrglossary.5495">214</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:@starttoc"><code class="csfmt">\@starttoc</code></dfn><span class="qquad"></span><a href="#wrglossary.5159">201</a>, <a href="#wrglossary.5206">204</a>, <a href="#wrglossary.5482">214</a>, <a href="#wrglossary.5815">227</a>, <a href="#wrglossary.10634">418</a>, <a href="#wrglossary.15647">652</a>, <a href="#wrglossary.20386">821</a>, <a href="#wrglossary.20794">837</a>, <a href="#wrglossary.21324">861</a></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index@ -->
+
+<section id="index6553600"><!-- start of section index6553600 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->A<div class="labellink"><a href="#index6553600">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><a href="#glo:AB"><code class="csfmt">\AB</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15661">653</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Ab"><code class="csfmt">\Ab</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15668">653</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ab"><code class="csfmt">\ab</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.12862">527</a>, <span class="summarylocfmt"><a href="#wrglossary.15675">653</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.abbrvstyle">abbreviation styles</dfn><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.15022">628</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.footnote-desc"><span class="abbrstylefmt">footnote-desc</span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.short-footnote-desc"><span class="abbrstylefmt">short-footnote-desc</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.footnote-em"><span class="abbrstylefmt">footnote-em</span></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.short-em-footnote"><span class="abbrstylefmt">short-em-footnote</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.footnote-sc"><span class="abbrstylefmt">footnote-sc</span></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.short-sc-footnote"><span class="abbrstylefmt">short-sc-footnote</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.footnote-sm"><span class="abbrstylefmt">footnote-sm</span></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.short-sm-footnote"><span class="abbrstylefmt">short-sm-footnote</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.footnote"><span class="abbrstylefmt">footnote</span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">short-footnote</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-desc-em"><span class="abbrstylefmt">long-desc-em</span></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.long-noshort-em-desc"><span class="abbrstylefmt">long-noshort-em-desc</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-desc-sc"><span class="abbrstylefmt">long-desc-sc</span></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.long-noshort-sc-desc"><span class="abbrstylefmt">long-noshort-sc-desc</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-desc-sm"><span class="abbrstylefmt">long-desc-sm</span></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.long-noshort-sm-desc"><span class="abbrstylefmt">long-noshort-sm-desc</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-desc"><span class="abbrstylefmt">long-desc</span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-em-noshort-em-desc-noreg"><span class="abbrstylefmt">long-em-noshort-em-desc-noreg</span></a><span class="qquad"></span><a href="#wrglossary.3252">131</a>, <span class="summarylocfmt"><a href="#wrglossary.15043">629</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-em-noshort-em-desc"><span class="abbrstylefmt">long-em-noshort-em-desc</span></a><span class="qquad"></span><a href="#wrglossary.2196">80</a>, <a href="#wrglossary.3253">131</a>, <span class="summarylocfmt"><a href="#wrglossary.15047">629</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-em-noshort-em-noreg"><span class="abbrstylefmt">long-em-noshort-em-noreg</span></a><span class="qquad"></span><a href="#wrglossary.1841">64</a>, <a href="#wrglossary.3250">131</a>, <span class="summarylocfmt"><a href="#wrglossary.15051">629</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-em-noshort-em"><span class="abbrstylefmt">long-em-noshort-em</span></a><span class="qquad"></span><a href="#wrglossary.1839">64</a>, <a href="#wrglossary.2181">79</a>, <a href="#wrglossary.3251">131</a>, <span class="summarylocfmt"><a href="#wrglossary.15055">629</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-em-short-em-desc"><span class="abbrstylefmt">long-em-short-em-desc</span></a><span class="qquad"></span><a href="#wrglossary.2258">82</a>, <a href="#wrglossary.2366">87</a>, <span class="summarylocfmt"><a href="#wrglossary.15059">629</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-em-short-em"><span class="abbrstylefmt">long-em-short-em</span></a><span class="qquad"></span><a href="#wrglossary.1828">63</a>, <a href="#wrglossary.2235">81</a>, <a href="#wrglossary.2351">86</a>, <a href="#wrglossary.3276">132</a>, <span class="summarylocfmt"><a href="#wrglossary.15063">630</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-em"><span class="abbrstylefmt">long-em</span></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.long-noshort-em"><span class="abbrstylefmt">long-noshort-em</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-hyphen-noshort-desc-noreg"><span class="abbrstylefmt">long-hyphen-noshort-desc-noreg</span></a><span class="qquad"></span><a href="#wrglossary.2820">107</a>, <a href="#wrglossary.3683">149</a>, <span class="summarylocfmt"><a href="#wrglossary.15068">630</a></span>, <a href="#wrglossary.20673">833</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-hyphen-noshort-noreg"><span class="abbrstylefmt">long-hyphen-noshort-noreg</span></a><span class="qquad"></span><a href="#wrglossary.1842">64</a>, <a href="#wrglossary.2837">107</a>, <a href="#wrglossary.3679">149</a>, <span class="summarylocfmt"><a href="#wrglossary.15072">630</a></span>, <a href="#wrglossary.20679">833</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen-desc"><span class="abbrstylefmt">long-hyphen-postshort-hyphen-desc</span></a><span class="qquad"></span><a href="#wrglossary.2797">106</a>, <span class="summarylocfmt"><a href="#wrglossary.15076">630</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-hyphen-postshort-hyphen"><span class="abbrstylefmt">long-hyphen-postshort-hyphen</span></a><span class="qquad"></span><a href="#wrglossary.1613">54</a>, <a href="#wrglossary.1832">64</a>, <a href="#wrglossary.2752">104</a>, <a href="#wrglossary.2814">106</a>, <a href="#wrglossary.2886">109</a>–<a href="#wrglossary.2927">111</a>, <a href="#wrglossary.3712">150</a>–<a href="#wrglossary.3777">152</a>, <a href="#wrglossary.4110">165</a>, <span class="summarylocfmt"><a href="#wrglossary.15080">630</a></span>, <a href="#wrglossary.20665">833</a>, <a href="#wrglossary.21150">854</a>, <a href="#wrglossary.23463">938</a>, <a href="#wrglossary.23470">939</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-hyphen-short-hyphen-desc"><span class="abbrstylefmt">long-hyphen-short-hyphen-desc</span></a><span class="qquad"></span><a href="#wrglossary.2780">105</a>, <a href="#wrglossary.2798">106</a>, <span class="summarylocfmt"><a href="#wrglossary.15084">630</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-hyphen-short-hyphen"><span class="abbrstylefmt">long-hyphen-short-hyphen</span></a><span class="qquad"></span><a href="#wrglossary.2733">103</a>–<a href="#wrglossary.2781">105</a>, <a href="#wrglossary.3671">148</a>, <a href="#wrglossary.3688">149</a>, <a href="#wrglossary.12116">496</a>, <a href="#wrglossary.15074">630</a>, <span class="summarylocfmt"><a href="#wrglossary.15087">631</a></span>, <a href="#wrglossary.20687">833</a>, <a href="#wrglossary.20690">834</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-noshort-desc-noreg"><span class="abbrstylefmt">long-noshort-desc-noreg</span></a><span class="qquad"></span><a href="#wrglossary.2821">107</a>, <a href="#wrglossary.3246">131</a>, <span class="summarylocfmt"><a href="#wrglossary.15092">631</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-noshort-desc"><span class="abbrstylefmt">long-noshort-desc</span></a><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a>; <a href="#wrglossary.2055">73</a>, <a href="#wrglossary.2086">74</a>, <a href="#wrglossary.2114">76</a>–<a href="#wrglossary.2168">78</a>, <a href="#wrglossary.2197">80</a>, <a href="#wrglossary.3247">131</a>, <a href="#wrglossary.3646">147</a>, <a href="#wrglossary.4219">168</a>, <span class="summarylocfmt"><a href="#wrglossary.15042">629</a></span>, <a href="#wrglossary.15049">629</a>, <a href="#wrglossary.15070">630</a>, <span class="summarylocfmt"><a href="#wrglossary.15095">631</a></span>, <a href="#wrglossary.15116">632</a>, <a href="#wrglossary.20693">834</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-noshort-em-desc"><span class="abbrstylefmt">long-noshort-em-desc</span></a><span class="qquad"></span><a href="#wrglossary.2065">73</a>, <a href="#wrglossary.2167">78</a>, <span class="summarylocfmt"><a href="#wrglossary.15039">628</a></span>, <span class="summarylocfmt"><a href="#wrglossary.15103">631</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-noshort-em"><span class="abbrstylefmt">long-noshort-em</span></a><span class="qquad"></span><a href="#wrglossary.2154">78</a>, <span class="summarylocfmt"><a href="#wrglossary.15067">630</a></span>, <span class="summarylocfmt"><a href="#wrglossary.15107">631</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-noshort-noreg"><span class="abbrstylefmt">long-noshort-noreg</span></a><span class="qquad"></span><a href="#wrglossary.2838">107</a>, <a href="#wrglossary.3248">131</a>, <span class="summarylocfmt"><a href="#wrglossary.15111">631</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-noshort-sc-desc"><span class="abbrstylefmt">long-noshort-sc-desc</span></a><span class="qquad"></span><a href="#wrglossary.2063">73</a>, <a href="#wrglossary.2113">76</a>, <span class="summarylocfmt"><a href="#wrglossary.15040">628</a></span>, <span class="summarylocfmt"><a href="#wrglossary.15114">631</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-noshort-sc"><span class="abbrstylefmt">long-noshort-sc</span></a><span class="qquad"></span><a href="#wrglossary.1826">63</a>, <a href="#wrglossary.2100">75</a>, <span class="summarylocfmt"><a href="#wrglossary.15118">632</a></span>, <span class="summarylocfmt"><a href="#wrglossary.15167">633</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-noshort-sm-desc"><span class="abbrstylefmt">long-noshort-sm-desc</span></a><span class="qquad"></span><a href="#wrglossary.2064">73</a>, <a href="#wrglossary.2140">77</a>, <span class="summarylocfmt"><a href="#wrglossary.15041">629</a></span>, <span class="summarylocfmt"><a href="#wrglossary.15122">632</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-noshort-sm"><span class="abbrstylefmt">long-noshort-sm</span></a><span class="qquad"></span><a href="#wrglossary.2127">76</a>, <span class="summarylocfmt"><a href="#wrglossary.15127">632</a></span>, <span class="summarylocfmt"><a href="#wrglossary.15217">635</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-noshort"><span class="abbrstylefmt">long-noshort</span></a><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a>; <a href="#wrglossary.1428">47</a>, <a href="#wrglossary.2087">74</a>–<a href="#wrglossary.2128">76</a>, <a href="#wrglossary.2155">78</a>, <a href="#wrglossary.2182">79</a>, <a href="#wrglossary.3249">131</a>, <a href="#wrglossary.3652">147</a>, <a href="#wrglossary.15057">629</a>, <a href="#wrglossary.15109">631</a>, <span class="summarylocfmt"><a href="#wrglossary.15132">632</a></span>, <span class="summarylocfmt"><a href="#wrglossary.15218">635</a></span>, <a href="#wrglossary.20696">834</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-only-short-only-desc"><span class="abbrstylefmt">long-only-short-only-desc</span></a><span class="qquad"></span><a href="#wrglossary.2950">112</a>, <a href="#wrglossary.2979">113</a>, <a href="#wrglossary.3874">155</a>, <a href="#wrglossary.3879">156</a>, <span class="summarylocfmt"><a href="#wrglossary.15139">632</a></span>, <a href="#wrglossary.21045">850</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-only-short-only"><span class="abbrstylefmt">long-only-short-only</span></a><span class="qquad"></span><a href="#wrglossary.1241">41</a>, <a href="#wrglossary.2939">111</a>, <a href="#wrglossary.2951">112</a>, <a href="#wrglossary.3843">154</a>, <span class="summarylocfmt"><a href="#wrglossary.15142">632</a></span>, <a href="#wrglossary.15151">633</a>, <a href="#wrglossary.21051">850</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-only-short-sc-only-desc"><span class="abbrstylefmt">long-only-short-sc-only-desc</span></a><span class="qquad"></span><a href="#wrglossary.2978">113</a>, <span class="summarylocfmt"><a href="#wrglossary.15146">633</a></span>, <a href="#wrglossary.21339">861</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-only-short-sc-only"><span class="abbrstylefmt">long-only-short-sc-only</span></a><span class="qquad"></span><a href="#wrglossary.2963">112</a>, <span class="summarylocfmt"><a href="#wrglossary.15149">633</a></span>, <a href="#wrglossary.16570">678</a>, <a href="#wrglossary.21345">862</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-postshort-sc-user-desc"><span class="abbrstylefmt">long-postshort-sc-user-desc</span></a><span class="qquad"></span><a href="#wrglossary.2475">92</a>, <a href="#wrglossary.3426">138</a>, <span class="summarylocfmt"><a href="#wrglossary.15153">633</a></span>, <a href="#wrglossary.20782">837</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-postshort-sc-user"><span class="abbrstylefmt">long-postshort-sc-user</span></a><span class="qquad"></span><a href="#wrglossary.2460">91</a>, <a href="#wrglossary.2476">92</a>, <a href="#wrglossary.3421">138</a>, <a href="#wrglossary.8508">334</a>, <span class="summarylocfmt"><a href="#wrglossary.15156">633</a></span>, <a href="#wrglossary.20786">837</a>, <a href="#wrglossary.21369">862</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-postshort-user-desc"><span class="abbrstylefmt">long-postshort-user-desc</span></a><span class="qquad"></span><a href="#wrglossary.2443">90</a>, <span class="summarylocfmt"><a href="#wrglossary.15160">633</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-postshort-user"><span class="abbrstylefmt">long-postshort-user</span></a><span class="qquad"></span><a href="#wrglossary.2429">90</a>, <a href="#wrglossary.2461">91</a>, <a href="#wrglossary.3524">142</a>, <a href="#wrglossary.6094">238</a>, <span class="summarylocfmt"><a href="#wrglossary.15163">633</a></span>, <a href="#wrglossary.21236">857</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-sc"><span class="abbrstylefmt">long-sc</span></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.long-noshort-sc"><span class="abbrstylefmt">long-noshort-sc</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-short-desc"><span class="abbrstylefmt">long-short-desc</span></a><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a>; <a href="#wrglossary.2252">82</a>–<a href="#wrglossary.2311">84</a>, <a href="#wrglossary.2338">86</a>, <a href="#wrglossary.2367">87</a>, <a href="#wrglossary.3296">133</a>, <a href="#wrglossary.3304">134</a>, <a href="#wrglossary.15061">629</a>, <span class="summarylocfmt"><a href="#wrglossary.15168">633</a></span>, <a href="#wrglossary.15173">634</a>, <a href="#wrglossary.20749">835</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-short-em-desc"><span class="abbrstylefmt">long-short-em-desc</span></a><span class="qquad"></span><a href="#wrglossary.2257">82</a>, <a href="#wrglossary.2337">86</a>, <span class="summarylocfmt"><a href="#wrglossary.15171">634</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-short-em"><span class="abbrstylefmt">long-short-em</span></a><span class="qquad"></span><a href="#wrglossary.1829">63</a>, <a href="#wrglossary.2234">81</a>, <a href="#wrglossary.2324">85</a>, <span class="summarylocfmt"><a href="#wrglossary.15175">634</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-short-sc-desc"><span class="abbrstylefmt">long-short-sc-desc</span></a><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a>; <a href="#wrglossary.2255">82</a>, <a href="#wrglossary.2283">83</a>, <span class="summarylocfmt"><a href="#wrglossary.15179">634</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-short-sc"><span class="abbrstylefmt">long-short-sc</span></a><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a>; <a href="#wrglossary.1239">41</a>, <a href="#wrglossary.1269">42</a>, <a href="#wrglossary.1346">44</a>, <a href="#wrglossary.2232">81</a>, <a href="#wrglossary.2270">82</a>, <a href="#wrglossary.4315">171</a>, <a href="#wrglossary.4330">172</a>, <span class="summarylocfmt"><a href="#wrglossary.15183">634</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-short-sm-desc"><span class="abbrstylefmt">long-short-sm-desc</span></a><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a>; <a href="#wrglossary.2256">82</a>, <a href="#wrglossary.2310">84</a>, <span class="summarylocfmt"><a href="#wrglossary.15187">634</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-short-sm"><span class="abbrstylefmt">long-short-sm</span></a><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a>; <a href="#wrglossary.2233">81</a>, <a href="#wrglossary.2297">84</a>, <span class="summarylocfmt"><a href="#wrglossary.15192">634</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-short-user-desc"><span class="abbrstylefmt">long-short-user-desc</span></a><span class="qquad"></span><a href="#wrglossary.2408">89</a>, <a href="#wrglossary.2459">91</a>, <a href="#wrglossary.3412">138</a>, <span class="summarylocfmt"><a href="#wrglossary.15197">635</a></span>, <a href="#wrglossary.20790">837</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a><span class="qquad"></span><a href="#wrglossary.1830">64</a>, <a href="#wrglossary.2394">88</a>–<a href="#wrglossary.2430">90</a>, <a href="#wrglossary.3338">135</a>, <a href="#wrglossary.3446">139</a>–<a href="#wrglossary.3506">142</a>, <a href="#wrglossary.15165">633</a>, <span class="summarylocfmt"><a href="#wrglossary.15200">635</a></span>, <a href="#wrglossary.19168">774</a>, <a href="#wrglossary.21959">888</a>–<a href="#wrglossary.22057">891</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a>; <a href="#wrglossary.53">3</a>, <a href="#wrglossary.1295">42</a>, <a href="#wrglossary.1342">44</a>, <a href="#wrglossary.1476">50</a>, <a href="#wrglossary.1749">60</a>, <a href="#wrglossary.1908">67</a>, <a href="#wrglossary.2061">73</a>, <a href="#wrglossary.2225">81</a>, <a href="#wrglossary.2253">82</a>, <a href="#wrglossary.2298">84</a>–<a href="#wrglossary.2352">86</a>, <a href="#wrglossary.2395">88</a>, <a href="#wrglossary.2734">103</a>, <a href="#wrglossary.3275">132</a>, <a href="#wrglossary.3288">133</a>, <a href="#wrglossary.4098">165</a>, <a href="#wrglossary.4313">171</a>, <a href="#wrglossary.6142">240</a>, <a href="#wrglossary.15025">628</a>, <a href="#wrglossary.15065">630</a>, <a href="#wrglossary.15089">631</a>, <a href="#wrglossary.15169">634</a>, <span class="summarylocfmt"><a href="#wrglossary.15204">635</a></span>, <a href="#wrglossary.20767">836</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long-sm"><span class="abbrstylefmt">long-sm</span></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.long-noshort-sm"><span class="abbrstylefmt">long-noshort-sm</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.long"><span class="abbrstylefmt">long</span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.long-noshort"><span class="abbrstylefmt">long-noshort</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.nolong-short-em"><span class="abbrstylefmt">nolong-short-em</span></a><span class="qquad"></span><a href="#wrglossary.1912">67</a>, <a href="#wrglossary.2040">73</a>, <span class="summarylocfmt"><a href="#wrglossary.15219">635</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.nolong-short-noreg"><span class="abbrstylefmt">nolong-short-noreg</span></a><span class="qquad"></span><a href="#wrglossary.3241">130</a>, <span class="summarylocfmt"><a href="#wrglossary.15223">635</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.nolong-short-sc"><span class="abbrstylefmt">nolong-short-sc</span></a><span class="qquad"></span><a href="#wrglossary.1910">67</a>, <a href="#wrglossary.1952">69</a>, <span class="summarylocfmt"><a href="#wrglossary.15226">636</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.nolong-short-sm"><span class="abbrstylefmt">nolong-short-sm</span></a><span class="qquad"></span><a href="#wrglossary.1911">67</a>, <a href="#wrglossary.1996">71</a>, <span class="summarylocfmt"><a href="#wrglossary.15230">636</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.nolong-short"><span class="abbrstylefmt">nolong-short</span></a><span class="qquad"></span><a href="#wrglossary.1905">67</a>, <a href="#wrglossary.1953">69</a>, <a href="#wrglossary.1997">71</a>, <a href="#wrglossary.2041">73</a>, <a href="#wrglossary.3242">130</a>, <a href="#wrglossary.15221">635</a>, <span class="summarylocfmt"><a href="#wrglossary.15235">636</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.postfootnote-desc"><span class="abbrstylefmt">postfootnote-desc</span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.short-postfootnote-desc"><span class="abbrstylefmt">short-postfootnote-desc</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.postfootnote-em"><span class="abbrstylefmt">postfootnote-em</span></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.short-em-postfootnote"><span class="abbrstylefmt">short-em-postfootnote</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.postfootnote-sc"><span class="abbrstylefmt">postfootnote-sc</span></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.short-sc-postfootnote"><span class="abbrstylefmt">short-sc-postfootnote</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.postfootnote-sm"><span class="abbrstylefmt">postfootnote-sm</span></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.short-sm-postfootnote"><span class="abbrstylefmt">short-sm-postfootnote</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.postfootnote"><span class="abbrstylefmt">postfootnote</span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-desc"><span class="abbrstylefmt">short-desc</span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.short-nolong-desc"><span class="abbrstylefmt">short-nolong-desc</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-em-desc"><span class="abbrstylefmt">short-em-desc</span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.short-em-nolong-desc"><span class="abbrstylefmt">short-em-nolong-desc</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-em-footnote-desc"><span class="abbrstylefmt">short-em-footnote-desc</span></a><span class="qquad"></span><a href="#wrglossary.1852">64</a>, <a href="#wrglossary.3193">127</a>, <span class="summarylocfmt"><a href="#wrglossary.15245">637</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-em-footnote"><span class="abbrstylefmt">short-em-footnote</span></a><span class="qquad"></span><a href="#wrglossary.1853">64</a>, <a href="#wrglossary.3000">114</a>, <a href="#wrglossary.3180">126</a>, <span class="summarylocfmt"><a href="#wrglossary.15035">628</a></span>, <span class="summarylocfmt"><a href="#wrglossary.15249">637</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-em-long-desc"><span class="abbrstylefmt">short-em-long-desc</span></a><span class="qquad"></span><a href="#wrglossary.2525">94</a>, <a href="#wrglossary.2605">97</a>, <span class="summarylocfmt"><a href="#wrglossary.15253">637</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-em-long-em-desc"><span class="abbrstylefmt">short-em-long-em-desc</span></a><span class="qquad"></span><a href="#wrglossary.2526">94</a>, <a href="#wrglossary.2634">99</a>, <span class="summarylocfmt"><a href="#wrglossary.15257">637</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-em-long-em"><span class="abbrstylefmt">short-em-long-em</span></a><span class="qquad"></span><a href="#wrglossary.2503">93</a>, <a href="#wrglossary.2619">98</a>, <span class="summarylocfmt"><a href="#wrglossary.15261">637</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-em-long"><span class="abbrstylefmt">short-em-long</span></a><span class="qquad"></span><a href="#wrglossary.2502">93</a>, <a href="#wrglossary.2592">97</a>, <span class="summarylocfmt"><a href="#wrglossary.15265">637</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-em-nolong-desc"><span class="abbrstylefmt">short-em-nolong-desc</span></a><span class="qquad"></span><a href="#wrglossary.1892">66</a>, <a href="#wrglossary.2024">72</a>, <a href="#wrglossary.2039">73</a>, <span class="summarylocfmt"><a href="#wrglossary.15244">637</a></span>, <span class="summarylocfmt"><a href="#wrglossary.15269">638</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-em-nolong"><span class="abbrstylefmt">short-em-nolong</span></a><span class="qquad"></span><a href="#wrglossary.1869">65</a>, <a href="#wrglossary.2009">71</a>, <a href="#wrglossary.2023">72</a>, <span class="summarylocfmt"><a href="#wrglossary.15273">638</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-em-postfootnote-desc"><span class="abbrstylefmt">short-em-postfootnote-desc</span></a><span class="qquad"></span><a href="#wrglossary.3220">129</a>, <span class="summarylocfmt"><a href="#wrglossary.15277">638</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-em-postfootnote"><span class="abbrstylefmt">short-em-postfootnote</span></a><span class="qquad"></span><a href="#wrglossary.3207">128</a>, <span class="summarylocfmt"><a href="#wrglossary.15239">636</a></span>, <span class="summarylocfmt"><a href="#wrglossary.15281">638</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-em"><span class="abbrstylefmt">short-em</span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.short-em-nolong"><span class="abbrstylefmt">short-em-nolong</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-footnote-desc"><span class="abbrstylefmt">short-footnote-desc</span></a><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a>; <a href="#wrglossary.3024">115</a>–<a href="#wrglossary.3058">117</a>, <a href="#wrglossary.3086">119</a>, <a href="#wrglossary.3140">123</a>, <a href="#wrglossary.3194">127</a>, <a href="#wrglossary.3582">144</a>, <a href="#wrglossary.3594">145</a>, <span class="summarylocfmt"><a href="#wrglossary.15034">628</a></span>, <a href="#wrglossary.15247">637</a>, <span class="summarylocfmt"><a href="#wrglossary.15286">638</a></span>, <a href="#wrglossary.15378">641</a>, <a href="#wrglossary.15412">643</a>, <a href="#wrglossary.19939">804</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-footnote"><span class="abbrstylefmt">short-footnote</span></a><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a>; <a href="#wrglossary.1482">50</a>, <a href="#wrglossary.1845">64</a>, <a href="#wrglossary.3001">114</a>–<a href="#wrglossary.3041">116</a>, <a href="#wrglossary.3073">118</a>, <a href="#wrglossary.3127">122</a>, <a href="#wrglossary.3181">126</a>, <span class="summarylocfmt"><a href="#wrglossary.15038">628</a></span>, <a href="#wrglossary.15251">637</a>, <span class="summarylocfmt"><a href="#wrglossary.15289">638</a></span>, <a href="#wrglossary.15365">641</a>, <a href="#wrglossary.15417">643</a>, <a href="#wrglossary.19384">780</a>, <a href="#wrglossary.19949">804</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-hyphen-long-hyphen-desc"><span class="abbrstylefmt">short-hyphen-long-hyphen-desc</span></a><span class="qquad"></span><a href="#wrglossary.2893">110</a>, <span class="summarylocfmt"><a href="#wrglossary.15306">639</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-hyphen-long-hyphen"><span class="abbrstylefmt">short-hyphen-long-hyphen</span></a><span class="qquad"></span><a href="#wrglossary.2853">108</a>–<a href="#wrglossary.2894">110</a>, <a href="#wrglossary.3675">149</a>, <a href="#wrglossary.3783">152</a>, <span class="summarylocfmt"><a href="#wrglossary.15309">639</a></span>, <a href="#wrglossary.20293">817</a>, <a href="#wrglossary.21543">869</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-hyphen-postlong-hyphen-desc"><span class="abbrstylefmt">short-hyphen-postlong-hyphen-desc</span></a><span class="qquad"></span><a href="#wrglossary.2910">110</a>, <span class="summarylocfmt"><a href="#wrglossary.15314">639</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-hyphen-postlong-hyphen"><span class="abbrstylefmt">short-hyphen-postlong-hyphen</span></a><span class="qquad"></span><a href="#wrglossary.2870">109</a>, <a href="#wrglossary.3792">152</a>, <a href="#wrglossary.3834">153</a>, <span class="summarylocfmt"><a href="#wrglossary.15318">639</a></span>, <a href="#wrglossary.21134">853</a>, <a href="#wrglossary.21536">869</a>, <a href="#wrglossary.23456">938</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-long-desc"><span class="abbrstylefmt">short-long-desc</span></a><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a>; <a href="#wrglossary.1850">64</a>, <a href="#wrglossary.2520">94</a>–<a href="#wrglossary.2606">97</a>, <a href="#wrglossary.2635">99</a>, <a href="#wrglossary.3322">134</a>, <a href="#wrglossary.3328">135</a>, <a href="#wrglossary.15255">637</a>, <span class="summarylocfmt"><a href="#wrglossary.15322">639</a></span>, <a href="#wrglossary.15386">642</a>, <a href="#wrglossary.15422">643</a>, <a href="#wrglossary.21549">869</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-long-user-desc"><span class="abbrstylefmt">short-long-user-desc</span></a><span class="qquad"></span><a href="#wrglossary.2673">100</a>, <a href="#wrglossary.2726">103</a>, <a href="#wrglossary.3435">139</a>, <span class="summarylocfmt"><a href="#wrglossary.15325">640</a></span>, <a href="#wrglossary.21582">871</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-long-user"><span class="abbrstylefmt">short-long-user</span></a><span class="qquad"></span><a href="#wrglossary.2659">100</a>, <a href="#wrglossary.3470">140</a>, <a href="#wrglossary.3482">141</a>, <a href="#wrglossary.3544">143</a>, <span class="summarylocfmt"><a href="#wrglossary.15328">640</a></span>, <a href="#wrglossary.21972">888</a>, <a href="#wrglossary.22038">891</a>, <a href="#wrglossary.22060">892</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a>; <a href="#wrglossary.1851">64</a>, <a href="#wrglossary.1865">65</a>, <a href="#wrglossary.2493">93</a>, <a href="#wrglossary.2521">94</a>, <a href="#wrglossary.2566">96</a>–<a href="#wrglossary.2620">98</a>, <a href="#wrglossary.2660">100</a>, <a href="#wrglossary.2696">101</a>, <a href="#wrglossary.2854">108</a>, <a href="#wrglossary.2996">114</a>, <a href="#wrglossary.3316">134</a>, <a href="#wrglossary.15263">637</a>–<a href="#wrglossary.15311">639</a>, <span class="summarylocfmt"><a href="#wrglossary.15332">640</a></span>, <a href="#wrglossary.15372">641</a>–<a href="#wrglossary.15427">643</a>, <a href="#wrglossary.21567">870</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-nolong-desc-noreg"><span class="abbrstylefmt">short-nolong-desc-noreg</span></a><span class="qquad"></span><a href="#wrglossary.3239">130</a>, <span class="summarylocfmt"><a href="#wrglossary.15345">640</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-nolong-desc"><span class="abbrstylefmt">short-nolong-desc</span></a><span class="qquad"></span><a href="#wrglossary.1887">66</a>–<a href="#wrglossary.1937">68</a>, <a href="#wrglossary.1981">70</a>, <a href="#wrglossary.2025">72</a>, <a href="#wrglossary.3240">130</a>, <a href="#wrglossary.3634">147</a>, <span class="summarylocfmt"><a href="#wrglossary.15243">637</a></span>, <a href="#wrglossary.15271">638</a>, <span class="summarylocfmt"><a href="#wrglossary.15348">640</a></span>, <a href="#wrglossary.15394">642</a>, <a href="#wrglossary.15432">643</a>, <a href="#wrglossary.21506">868</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-nolong-noreg"><span class="abbrstylefmt">short-nolong-noreg</span></a><span class="qquad"></span><a href="#wrglossary.3237">130</a>, <span class="summarylocfmt"><a href="#wrglossary.15351">640</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a><span class="qquad"></span><a href="#wrglossary.47">3</a>, <a href="#wrglossary.1242">41</a>, <a href="#wrglossary.1293">42</a>, <a href="#wrglossary.1388">46</a>, <a href="#wrglossary.1430">47</a>, <a href="#wrglossary.1751">60</a>, <a href="#wrglossary.1861">65</a>–<a href="#wrglossary.1906">67</a>, <a href="#wrglossary.1966">69</a>, <a href="#wrglossary.2010">71</a>, <a href="#wrglossary.3238">130</a>, <a href="#wrglossary.3628">146</a>, <a href="#wrglossary.6053">236</a>, <a href="#wrglossary.6140">240</a>, <a href="#wrglossary.15033">628</a>, <a href="#wrglossary.15236">636</a>, <a href="#wrglossary.15275">638</a>, <span class="summarylocfmt"><a href="#wrglossary.15354">640</a></span>, <a href="#wrglossary.15398">642</a>, <a href="#wrglossary.15437">643</a>, <span class="summarylocfmt"><a href="#wrglossary.15451">644</a></span>, <a href="#wrglossary.21585">871</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-postfootnote-desc"><span class="abbrstylefmt">short-postfootnote-desc</span></a><span class="qquad"></span><a href="#wrglossary.3057">117</a>, <a href="#wrglossary.3071">118</a>, <a href="#wrglossary.3113">121</a>, <a href="#wrglossary.3167">125</a>, <a href="#wrglossary.3221">129</a>, <span class="summarylocfmt"><a href="#wrglossary.15238">636</a></span>, <a href="#wrglossary.15279">638</a>, <span class="summarylocfmt"><a href="#wrglossary.15361">641</a></span>, <a href="#wrglossary.15402">642</a>, <a href="#wrglossary.15442">644</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-postfootnote"><span class="abbrstylefmt">short-postfootnote</span></a><span class="qquad"></span><a href="#wrglossary.3040">116</a>, <a href="#wrglossary.3056">117</a>, <a href="#wrglossary.3100">120</a>, <a href="#wrglossary.3154">124</a>, <a href="#wrglossary.3208">128</a>, <a href="#wrglossary.3973">160</a>, <a href="#wrglossary.4161">167</a>, <a href="#wrglossary.6097">238</a>, <a href="#wrglossary.6350">248</a>, <span class="summarylocfmt"><a href="#wrglossary.15242">636</a></span>, <a href="#wrglossary.15283">638</a>, <a href="#wrglossary.15305">639</a>, <span class="summarylocfmt"><a href="#wrglossary.15364">641</a></span>, <a href="#wrglossary.15406">642</a>, <a href="#wrglossary.15447">644</a>, <a href="#wrglossary.19385">780</a>, <a href="#wrglossary.21099">852</a>, <a href="#wrglossary.21126">853</a>, <a href="#wrglossary.23452">938</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-postlong-user-desc"><span class="abbrstylefmt">short-postlong-user-desc</span></a><span class="qquad"></span><a href="#wrglossary.2710">102</a>, <span class="summarylocfmt"><a href="#wrglossary.15367">641</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-postlong-user"><span class="abbrstylefmt">short-postlong-user</span></a><span class="qquad"></span><a href="#wrglossary.1605">54</a>, <a href="#wrglossary.2695">101</a>, <a href="#wrglossary.2711">102</a>, <a href="#wrglossary.3568">144</a>, <span class="summarylocfmt"><a href="#wrglossary.15370">641</a></span>, <a href="#wrglossary.21232">857</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-sc-desc"><span class="abbrstylefmt">short-sc-desc</span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.short-sc-nolong-desc"><span class="abbrstylefmt">short-sc-nolong-desc</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-sc-footnote-desc"><span class="abbrstylefmt">short-sc-footnote-desc</span></a><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a>; <a href="#wrglossary.3085">119</a>, <span class="summarylocfmt"><a href="#wrglossary.15376">641</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-sc-footnote"><span class="abbrstylefmt">short-sc-footnote</span></a><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a>; <a href="#wrglossary.2998">114</a>, <a href="#wrglossary.3072">118</a>, <span class="summarylocfmt"><a href="#wrglossary.15036">628</a></span>, <span class="summarylocfmt"><a href="#wrglossary.15380">641</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-sc-long-desc"><span class="abbrstylefmt">short-sc-long-desc</span></a><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a>; <a href="#wrglossary.2523">94</a>, <a href="#wrglossary.2551">95</a>, <span class="summarylocfmt"><a href="#wrglossary.15384">642</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-sc-long"><span class="abbrstylefmt">short-sc-long</span></a><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a>; <a href="#wrglossary.2500">93</a>, <a href="#wrglossary.2538">94</a>, <span class="summarylocfmt"><a href="#wrglossary.15388">642</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-sc-nolong-desc"><span class="abbrstylefmt">short-sc-nolong-desc</span></a><span class="qquad"></span><a href="#wrglossary.1890">66</a>, <a href="#wrglossary.1936">68</a>, <a href="#wrglossary.1951">69</a>, <span class="summarylocfmt"><a href="#wrglossary.15375">641</a></span>, <span class="summarylocfmt"><a href="#wrglossary.15392">642</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-sc-nolong"><span class="abbrstylefmt">short-sc-nolong</span></a><span class="qquad"></span><a href="#wrglossary.1867">65</a>, <a href="#wrglossary.1921">67</a>, <a href="#wrglossary.1935">68</a>, <span class="summarylocfmt"><a href="#wrglossary.15396">642</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-sc-postfootnote-desc"><span class="abbrstylefmt">short-sc-postfootnote-desc</span></a><span class="qquad"></span><a href="#wrglossary.3112">121</a>, <span class="summarylocfmt"><a href="#wrglossary.15400">642</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-sc-postfootnote"><span class="abbrstylefmt">short-sc-postfootnote</span></a><span class="qquad"></span><a href="#wrglossary.1846">64</a>, <a href="#wrglossary.3099">120</a>, <span class="summarylocfmt"><a href="#wrglossary.15240">636</a></span>, <span class="summarylocfmt"><a href="#wrglossary.15404">642</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-sc"><span class="abbrstylefmt">short-sc</span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.short-sc-nolong"><span class="abbrstylefmt">short-sc-nolong</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-sm-desc"><span class="abbrstylefmt">short-sm-desc</span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.short-sm-nolong-desc"><span class="abbrstylefmt">short-sm-nolong-desc</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-sm-footnote-desc"><span class="abbrstylefmt">short-sm-footnote-desc</span></a><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a>; <a href="#wrglossary.3139">123</a>, <span class="summarylocfmt"><a href="#wrglossary.15410">643</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-sm-footnote"><span class="abbrstylefmt">short-sm-footnote</span></a><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a>; <a href="#wrglossary.2999">114</a>, <a href="#wrglossary.3126">122</a>, <span class="summarylocfmt"><a href="#wrglossary.15037">628</a></span>, <span class="summarylocfmt"><a href="#wrglossary.15415">643</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-sm-long-desc"><span class="abbrstylefmt">short-sm-long-desc</span></a><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a>; <a href="#wrglossary.2524">94</a>, <a href="#wrglossary.2578">96</a>, <span class="summarylocfmt"><a href="#wrglossary.15420">643</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-sm-long"><span class="abbrstylefmt">short-sm-long</span></a><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a>; <a href="#wrglossary.2501">93</a>, <a href="#wrglossary.2565">96</a>, <span class="summarylocfmt"><a href="#wrglossary.15425">643</a></span>, <a href="#wrglossary.21657">873</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-sm-nolong-desc"><span class="abbrstylefmt">short-sm-nolong-desc</span></a><span class="qquad"></span><a href="#wrglossary.1891">66</a>, <a href="#wrglossary.1980">70</a>, <a href="#wrglossary.1995">71</a>, <span class="summarylocfmt"><a href="#wrglossary.15430">643</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-sm-nolong"><span class="abbrstylefmt">short-sm-nolong</span></a><span class="qquad"></span><a href="#wrglossary.1868">65</a>, <a href="#wrglossary.1965">69</a>, <a href="#wrglossary.1979">70</a>, <span class="summarylocfmt"><a href="#wrglossary.15435">643</a></span>, <span class="summarylocfmt"><a href="#wrglossary.15450">644</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-sm-postfootnote-desc"><span class="abbrstylefmt">short-sm-postfootnote-desc</span></a><span class="qquad"></span><a href="#wrglossary.3166">125</a>, <span class="summarylocfmt"><a href="#wrglossary.15440">644</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-sm-postfootnote"><span class="abbrstylefmt">short-sm-postfootnote</span></a><span class="qquad"></span><a href="#wrglossary.3153">124</a>, <span class="summarylocfmt"><a href="#wrglossary.15241">636</a></span>, <span class="summarylocfmt"><a href="#wrglossary.15445">644</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short-sm"><span class="abbrstylefmt">short-sm</span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.short-sm-nolong"><span class="abbrstylefmt">short-sm-nolong</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbrstyle.short"><span class="abbrstylefmt">short</span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:opt.abbrstyle.short-nolong"><span class="abbrstylefmt">short-nolong</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx0"><a href="#glo:abbreviationsname"><code class="csfmt">\abbreviationsname</code></a><span class="qquad"></span><a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.171">9</a>, <a href="#wrglossary.177">10</a>, <a href="#wrglossary.14250">592</a>, <span class="summarylocfmt"><a href="#wrglossary.15682">653</a></span>, <a href="#wrglossary.23501">941</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:abbrvpluralsuffix"><code class="csfmt">\abbrvpluralsuffix</code></a><span class="qquad"></span><a href="#wrglossary.1088">36</a>, <a href="#wrglossary.1333">43</a>, <a href="#wrglossary.1336">44</a>, <a href="#wrglossary.4306">170</a>, <a href="#wrglossary.4312">171</a>, <a href="#wrglossary.11721">476</a>, <span class="summarylocfmt"><a href="#wrglossary.15687">653</a></span>, <a href="#wrglossary.15946">658</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ABP"><code class="csfmt">\ABP</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15694">654</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Abp"><code class="csfmt">\Abp</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15701">654</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:abp"><code class="csfmt">\abp</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15708">654</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:AC"><code class="csfmt">\AC</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15715">654</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Ac"><code class="csfmt">\Ac</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15722">654</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ac"><code class="csfmt">\ac</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.448">18</a>, <a href="#wrglossary.491">19</a>, <a href="#wrglossary.1309">43</a>, <a href="#wrglossary.7963">308</a>, <a href="#wrglossary.12861">527</a>, <span class="summarylocfmt"><a href="#wrglossary.15732">654</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.accsupp"><span class="styfmt">accsupp</span> package</dfn><span class="qquad"></span><a href="#wrglossary.16861">689</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ACF"><code class="csfmt">\ACF</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15742">654</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Acf"><code class="csfmt">\Acf</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15749">655</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:acf"><code class="csfmt">\acf</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15759">655</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ACFP"><code class="csfmt">\ACFP</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15769">655</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Acfp"><code class="csfmt">\Acfp</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15776">655</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:acfp"><code class="csfmt">\acfp</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15786">655</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ACL"><code class="csfmt">\ACL</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15796">655</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Acl"><code class="csfmt">\Acl</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15803">655</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:acl"><code class="csfmt">\acl</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.494">19</a>, <span class="summarylocfmt"><a href="#wrglossary.15813">656</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ACLP"><code class="csfmt">\ACLP</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15823">656</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Aclp"><code class="csfmt">\Aclp</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15830">656</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:aclp"><code class="csfmt">\aclp</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15840">656</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ACP"><code class="csfmt">\ACP</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15850">656</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Acp"><code class="csfmt">\Acp</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15857">656</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:acp"><code class="csfmt">\acp</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15867">657</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Acrfull"><code class="csfmt">\Acrfull</code></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><span class="qquad"></span><a href="#wrglossary.15754">655</a>, <span class="summarylocfmt"><a href="#wrglossary.15877">657</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:acrfull"><code class="csfmt">\acrfull</code></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><span class="qquad"></span><a href="#wrglossary.15764">655</a>, <span class="summarylocfmt"><a href="#wrglossary.15883">657</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Acrfullpl"><code class="csfmt">\Acrfullpl</code></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><span class="qquad"></span><a href="#wrglossary.15781">655</a>, <span class="summarylocfmt"><a href="#wrglossary.15889">657</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:acrfullpl"><code class="csfmt">\acrfullpl</code></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><span class="qquad"></span><a href="#wrglossary.15791">655</a>, <span class="summarylocfmt"><a href="#wrglossary.15895">657</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Acrlong"><code class="csfmt">\Acrlong</code></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><span class="qquad"></span><a href="#wrglossary.15808">656</a>, <span class="summarylocfmt"><a href="#wrglossary.15901">657</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:acrlong"><code class="csfmt">\acrlong</code></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><span class="qquad"></span><a href="#wrglossary.453">18</a>, <a href="#wrglossary.498">19</a>, <a href="#wrglossary.15818">656</a>, <span class="summarylocfmt"><a href="#wrglossary.15907">657</a></span>, <a href="#wrglossary.15917">658</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Acrlongpl"><code class="csfmt">\Acrlongpl</code></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><span class="qquad"></span><a href="#wrglossary.15835">656</a>, <span class="summarylocfmt"><a href="#wrglossary.15913">658</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:acrlongpl"><code class="csfmt">\acrlongpl</code></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><span class="qquad"></span><a href="#wrglossary.15845">656</a>, <span class="summarylocfmt"><a href="#wrglossary.15919">658</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.acronymstyle">acronym (base) style</dfn></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.acrstyle.dua-desc"><span class="acrstylefmt">dua-desc</span></dfn><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.acrstyle.dua"><span class="acrstylefmt">dua</span></dfn><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.acrstyle.footnote-desc"><span class="acrstylefmt">footnote-desc</span></dfn><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.acrstyle.footnote-sc-desc"><span class="acrstylefmt">footnote-sc-desc</span></dfn><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.acrstyle.footnote-sc"><span class="acrstylefmt">footnote-sc</span></dfn><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.acrstyle.footnote-sm-desc"><span class="acrstylefmt">footnote-sm-desc</span></dfn><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.acrstyle.footnote-sm"><span class="acrstylefmt">footnote-sm</span></dfn><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.acrstyle.footnote"><span class="acrstylefmt">footnote</span></dfn><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.acrstyle.long-sc-short-desc"><span class="acrstylefmt">long-sc-short-desc</span></dfn><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.acrstyle.long-sc-short"><span class="acrstylefmt">long-sc-short</span></dfn><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.acrstyle.long-short-desc"><span class="acrstylefmt">long-short-desc</span></dfn><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.acrstyle.long-short"><span class="acrstylefmt">long-short</span></dfn><span class="qquad"></span><a href="#wrglossary.5896">229</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.acrstyle.long-sm-short-desc"><span class="acrstylefmt">long-sm-short-desc</span></dfn><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.acrstyle.long-sm-short"><span class="acrstylefmt">long-sm-short</span></dfn><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.acrstyle.long-sp-short-desc"><span class="acrstylefmt">long-sp-short-desc</span></dfn><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.acrstyle.long-sp-short"><span class="acrstylefmt">long-sp-short</span></dfn><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.acrstyle.sc-short-long-desc"><span class="acrstylefmt">sc-short-long-desc</span></dfn><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.acrstyle.sc-short-long"><span class="acrstylefmt">sc-short-long</span></dfn><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.acrstyle.short-long-desc"><span class="acrstylefmt">short-long-desc</span></dfn><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.acrstyle.short-long"><span class="acrstylefmt">short-long</span></dfn><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.acrstyle.sm-short-long-desc"><span class="acrstylefmt">sm-short-long-desc</span></dfn><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.acrstyle.sm-short-long"><span class="acrstylefmt">sm-short-long</span></dfn><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx0"><a href="#glo:acronymfont"><code class="csfmt">\acronymfont</code></a><span class="qquad"></span><a href="#wrglossary.5913">230</a>, <span class="summarylocfmt"><a href="#wrglossary.15925">658</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:acronymname"><code class="csfmt">\acronymname</code></a><span class="qquad"></span><a href="#wrglossary.173">9</a>, <a href="#wrglossary.14253">592</a>, <a href="#wrglossary.15685">653</a>, <span class="summarylocfmt"><a href="#wrglossary.15931">658</a></span>, <a href="#wrglossary.23701">946</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a><span class="qquad"></span><a href="#sec:abbrvfieldstype">§4.1.4</a>; <a href="#wrglossary.181">10</a>, <a href="#wrglossary.232">11</a>, <a href="#wrglossary.1362">44</a>, <span class="summarylocfmt"><a href="#wrglossary.15934">658</a></span>, <a href="#wrglossary.23105">926</a>, <a href="#wrglossary.23162">927</a>, <a href="#wrglossary.23503">941</a>, <a href="#wrglossary.23702">946</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:acrpluralsuffix"><code class="csfmt">\acrpluralsuffix</code></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><span class="qquad"></span><a href="#wrglossary.1083">36</a>, <span class="summarylocfmt"><a href="#wrglossary.15943">658</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Acrshort"><code class="csfmt">\Acrshort</code></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.15949">659</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:acrshort"><code class="csfmt">\acrshort</code></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><span class="qquad"></span><a href="#wrglossary.452">18</a>, <a href="#wrglossary.497">19</a>, <a href="#wrglossary.1469">50</a>, <span class="summarylocfmt"><a href="#wrglossary.15955">659</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Acrshortpl"><code class="csfmt">\Acrshortpl</code></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.15961">659</a></span>, <a href="#wrglossary.16012">660</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:acrshortpl"><code class="csfmt">\acrshortpl</code></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.15967">659</a></span>, <a href="#wrglossary.16022">660</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ACS"><code class="csfmt">\ACS</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15973">659</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Acs"><code class="csfmt">\Acs</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.15980">659</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:acs"><code class="csfmt">\acs</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.493">19</a>, <span class="summarylocfmt"><a href="#wrglossary.15990">659</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ACSP"><code class="csfmt">\ACSP</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.16000">660</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Acsp"><code class="csfmt">\Acsp</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.16007">660</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:acsp"><code class="csfmt">\acsp</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.16017">660</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:actualchar"><code class="csfmt">\actualchar</code></dfn><span class="qquad"></span><a href="#wrglossary.14079">576</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:AF"><code class="csfmt">\AF</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.16027">660</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Af"><code class="csfmt">\Af</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.16034">660</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:af"><code class="csfmt">\af</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.16041">660</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:AFP"><code class="csfmt">\AFP</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.16048">660</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Afp"><code class="csfmt">\Afp</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.16055">661</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:afp"><code class="csfmt">\afp</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.16062">661</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:AL"><code class="csfmt">\AL</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.16069">661</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Al"><code class="csfmt">\Al</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.16076">661</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:al"><code class="csfmt">\al</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.16083">661</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:env.align"><span class="envfmt">align</span> environment</dfn><span class="qquad"></span><a href="#wrglossary.792">26</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.allcaps">all caps</dfn><span class="qquad"></span><a href="#wrglossary.5127">200</a>, <a href="#wrglossary.6464">253</a>, <a href="#wrglossary.17150">698</a>, <a href="#wrglossary.20968">846</a>, <a href="#wrglossary.20997">847</a>, <a href="#wrglossary.22394">905</a>, <a href="#wrglossary.22404">906</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ALP"><code class="csfmt">\ALP</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.16090">661</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Alp"><code class="csfmt">\Alp</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.16097">661</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:alp"><code class="csfmt">\alp</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.16104">661</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:Alph"><code class="csfmt">\Alph</code></dfn><span class="qquad"></span><a href="#wrglossary.6814">262</a>, <a href="#wrglossary.6851">263</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:alph"><code class="csfmt">\alph</code></dfn><span class="qquad"></span><a href="#wrglossary.6812">262</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Alpha"><code class="csfmt">\Alpha</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13240">541</a>, <a href="#wrglossary.13377">552</a>, <a href="#wrglossary.13408">553</a>, <a href="#wrglossary.13971">573</a>, <span class="summarylocfmt"><a href="#wrglossary.16111">662</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:alpha"><code class="csfmt">\alpha</code></dfn><span class="qquad"></span><a href="#wrglossary.13239">541</a>, <a href="#wrglossary.13359">551</a>–<a href="#wrglossary.13398">553</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:alsoname"><code class="csfmt">\alsoname</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.16114">662</a></span>, <a href="#wrglossary.23321">933</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.mod.alt-mod"><span class="meta">〈<em class="metainner">alt-mod</em>〉</span> (modifier)</dfn><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:GlsXtrSetAltModifier"><code class="csfmt">\GlsXtrSetAltModifier</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.amsmath"><span class="styfmt">amsmath</span> package</dfn><span class="qquad"></span><a href="#wrglossary.828">27</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:andname"><code class="csfmt">\andname</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.16116">662</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:appto"><code class="csfmt">\appto</code></dfn><span class="qquad"></span><a href="#wrglossary.4091">164</a>, <a href="#wrglossary.11695">475</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:apptoglossarypreamble"><code class="csfmt">\apptoglossarypreamble</code></a><span class="qquad"></span><a href="#sec:glospreamble">§8.2</a>; <a href="#wrglossary.9506">377</a>, <span class="summarylocfmt"><a href="#wrglossary.16119">662</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:arabic"><code class="csfmt">\arabic</code></dfn><span class="qquad"></span><a href="#wrglossary.6806">262</a>, <a href="#wrglossary.6850">263</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:app.arara"><span class="appfmt">arara</span></dfn><span class="qquad"></span><a href="#wrglossary.12468">511</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.array"><span class="styfmt">array</span> package</dfn><span class="qquad"></span><a href="#wrglossary.11241">446</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:AS"><code class="csfmt">\AS</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.16122">662</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:As"><code class="csfmt">\As</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.16129">662</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:as"><code class="csfmt">\as</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.16136">662</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:ascii">ASCII</dfn><span class="qquad"></span><a href="#wrglossary.9708">385</a>, <a href="#wrglossary.12680">521</a>, <span class="termslocfmt"><a href="#wrglossary.14297">599</a></span>, <a href="#wrglossary.21032">849</a>, <a href="#wrglossary.21458">866</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ASP"><code class="csfmt">\ASP</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.16143">663</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Asp"><code class="csfmt">\Asp</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.16150">663</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:asp"><code class="csfmt">\asp</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.16157">663</a></span></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index6553600 -->
+
+<section id="index6619136"><!-- start of section index6619136 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->B<div class="labellink"><a href="#index6619136">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.babel"><span class="styfmt">babel</span> package</dfn><span class="qquad"></span><a href="#wrglossary.41">3</a>, <a href="#wrglossary.62">4</a>, <a href="#wrglossary.172">9</a>, <a href="#wrglossary.410">17</a>, <a href="#wrglossary.12041">492</a>, <a href="#wrglossary.14252">592</a>, <a href="#wrglossary.15686">653</a>, <a href="#wrglossary.16115">662</a>, <a href="#wrglossary.23861">950</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:backmatter"><code class="csfmt">\backmatter</code></dfn><span class="qquad"></span><a href="#wrglossary.4736">188</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:cls.beamer"><span class="clsfmt">beamer</span> class</dfn><span class="qquad"></span><a href="#wrglossary.7495">286</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Beta"><code class="csfmt">\Beta</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13242">541</a>, <a href="#wrglossary.13390">552</a>, <a href="#wrglossary.13972">573</a>, <span class="summarylocfmt"><a href="#wrglossary.16164">663</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:beta"><code class="csfmt">\beta</code></dfn><span class="qquad"></span><a href="#wrglossary.13241">541</a>, <a href="#wrglossary.13360">551</a>, <a href="#wrglossary.13399">553</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:app.bib2gls"><span class="appfmt">bib2gls</span></dfn><span class="qquad"></span><a href="#wrglossary.12369">508</a>–<a href="#wrglossary.14005">573</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx1"><dfn id="glo:switch.g"><span class="shortargfmt">-g</span></dfn><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:switch.group"><span class="longargfmt">--group</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:switch.group"><span class="longargfmt">--group</span></dfn><span class="qquad"></span><a href="#wrglossary.703">24</a>, <a href="#wrglossary.767">26</a>, <a href="#wrglossary.1025">34</a>, <a href="#wrglossary.7211">273</a>, <a href="#wrglossary.9871">390</a>, <a href="#wrglossary.10039">395</a>, <a href="#wrglossary.10129">397</a>, <a href="#wrglossary.10833">426</a>, <a href="#wrglossary.11155">442</a>, <a href="#wrglossary.11277">448</a>, <a href="#wrglossary.11525">465</a>, <a href="#wrglossary.12663">519</a>, <a href="#wrglossary.13161">537</a>, <a href="#wrglossary.14597">607</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:switch.i"><span class="shortargfmt">-i</span></dfn><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:switch.index-conversion"><span class="longargfmt">--index-conversion</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:switch.log-file"><span class="longargfmt">--log-file</span></dfn><span class="qquad"></span><a href="#wrglossary.764">25</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:switch.merge-nameref-on"><span class="longargfmt">--merge-nameref-on</span></dfn><span class="qquad"></span><a href="#wrglossary.13647">560</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:switch.no-group"><span class="longargfmt">--no-group</span></dfn><span class="qquad"></span><a href="#wrglossary.14969">624</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:switch.record-count-rule"><span class="longargfmt">--record-count-rule</span></dfn><span class="qquad"></span><a href="#wrglossary.12737">522</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:switch.record-count-unit"><span class="longargfmt">--record-count-unit</span></dfn><span class="qquad"></span><a href="#wrglossary.12718">522</a>, <a href="#wrglossary.12901">528</a>, <a href="#wrglossary.13005">532</a>, <a href="#wrglossary.14802">615</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:switch.record-count"><span class="longargfmt">--record-count</span></dfn><span class="qquad"></span><a href="#wrglossary.6923">264</a>, <a href="#wrglossary.12717">522</a>, <a href="#wrglossary.12889">528</a>, <a href="#wrglossary.14795">614</a>, <a href="#wrglossary.14798">615</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:switch.t"><span class="shortargfmt">-t</span></dfn><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:switch.log-file"><span class="longargfmt">--log-file</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx0"><a href="#glo:bibgls@input"><code class="csfmt">\bibgls@input</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.16167">663</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:bibglsdualprefixlabel"><code class="csfmt">\bibglsdualprefixlabel</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13911">571</a>, <span class="summarylocfmt"><a href="#wrglossary.16171">663</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:bibglsnewdualindexsymbolsecondary"><code class="csfmt">\bibglsnewdualindexsymbolsecondary</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.16174">663</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:bibglsprimaryprefixlabel"><code class="csfmt">\bibglsprimaryprefixlabel</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13912">571</a>, <span class="summarylocfmt"><a href="#wrglossary.16176">664</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:bibglssetlastgrouptitle"><code class="csfmt">\bibglssetlastgrouptitle</code></a><span class="qquad"></span><a href="#wrglossary.13160">537</a>, <span class="summarylocfmt"><a href="#wrglossary.16179">664</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:bibglssetlocationrecordcount"><code class="csfmt">\bibglssetlocationrecordcount</code></a><span class="qquad"></span><a href="#sec:unitrecordcountminigloss">§11.4.2</a>; <a href="#wrglossary.13006">532</a>, <span class="summarylocfmt"><a href="#wrglossary.16181">664</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:switch.record-count-unit"><span class="longargfmt">--record-count-unit</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:bibglssetrecordcount"><code class="csfmt">\bibglssetrecordcount</code></a><span class="qquad"></span><a href="#sec:unitrecordcountminigloss">§11.4.2</a>; <a href="#wrglossary.13001">532</a>, <span class="summarylocfmt"><a href="#wrglossary.16183">664</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:switch.record-count"><span class="longargfmt">--record-count</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:bibglssettotalrecordcount"><code class="csfmt">\bibglssettotalrecordcount</code></a><span class="qquad"></span><a href="#sec:unitrecordcountminigloss">§11.4.2</a>; <a href="#wrglossary.12996">531</a>, <span class="summarylocfmt"><a href="#wrglossary.16185">664</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:switch.record-count"><span class="longargfmt">--record-count</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:bibglstertiaryprefixlabel"><code class="csfmt">\bibglstertiaryprefixlabel</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13910">571</a>, <span class="summarylocfmt"><a href="#wrglossary.16187">664</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.booktabs"><span class="styfmt">booktabs</span> package</dfn><span class="qquad"></span><a href="#wrglossary.11607">470</a>, <a href="#wrglossary.15511">647</a></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index6619136 -->
+
+<section id="index6684672"><!-- start of section index6684672 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->C<div class="labellink"><a href="#index6684672">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a><span class="qquad"></span><a href="#wrglossary.5141">200</a>, <a href="#wrglossary.12224">500</a>, <span class="summarylocfmt"><a href="#wrglossary.16190">664</a></span>, <a href="#wrglossary.17140">698</a>, <a href="#wrglossary.23436">937</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a><span class="qquad"></span><a href="#wrglossary.5136">200</a>, <a href="#wrglossary.7605">291</a>, <a href="#wrglossary.9386">373</a>, <a href="#wrglossary.12215">500</a>, <span class="summarylocfmt"><a href="#wrglossary.16194">665</a></span>, <a href="#wrglossary.17139">698</a>, <a href="#wrglossary.19888">802</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:caption"><code class="csfmt">\caption</code></dfn><span class="qquad"></span><a href="#wrglossary.801">27</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.casechange">case change</dfn><span class="qquad"></span><a href="#wrglossary.9162">366</a>, <a href="#wrglossary.12208">499</a>, <a href="#wrglossary.13829">567</a>, <a href="#wrglossary.22228">899</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:idx.uppercase">uppercase</a>, <a href="#glo:idx.lowercase">lowercase</a>, <a href="#glo:idx.titlecase">title case</a>, <a href="#glo:idx.sentencecase">sentence case</a> &amp; <a href="#glo:idx.allcaps">all caps</a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.category">categories</dfn></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.cat.abbreviation"><span class="csoptfmt">abbreviation</span></a><span class="qquad"></span><a href="#sec:knowncategories">§10.1</a>; <a href="#wrglossary.1236">41</a>, <a href="#wrglossary.1268">42</a>, <a href="#wrglossary.1717">58</a>–<a href="#wrglossary.1747">60</a>, <a href="#wrglossary.3950">159</a>, <a href="#wrglossary.6096">238</a>, <a href="#wrglossary.6143">240</a>, <a href="#wrglossary.8216">320</a>, <a href="#wrglossary.10742">422</a>, <a href="#wrglossary.12065">493</a>, <a href="#wrglossary.15024">628</a>, <a href="#wrglossary.21101">852</a>, <a href="#wrglossary.22734">916</a>, <a href="#wrglossary.23326">933</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.cat.acronym"><span class="csoptfmt">acronym</span></a><span class="qquad"></span><a href="#sec:knowncategories">§10.1</a>; <a href="#wrglossary.88">5</a>, <a href="#wrglossary.1271">42</a>, <a href="#wrglossary.1387">46</a>, <a href="#wrglossary.1716">58</a>–<a href="#wrglossary.1750">60</a>, <a href="#wrglossary.4569">181</a>, <a href="#wrglossary.6052">236</a>, <a href="#wrglossary.6098">238</a>, <a href="#wrglossary.6141">240</a>, <a href="#wrglossary.10739">422</a>, <a href="#wrglossary.12067">493</a>, <a href="#wrglossary.12081">495</a>, <a href="#wrglossary.15030">628</a>, <a href="#wrglossary.21103">852</a>, <a href="#wrglossary.22746">917</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.cat.general"><span class="csoptfmt">general</span></a><span class="qquad"></span><a href="#sec:knowncategories">§10.1</a>; <a href="#wrglossary.6101">238</a>, <a href="#wrglossary.6267">245</a>, <a href="#wrglossary.6478">253</a>, <a href="#wrglossary.8052">311</a>, <a href="#wrglossary.8069">312</a>, <a href="#wrglossary.8123">316</a>, <a href="#wrglossary.10733">422</a>, <a href="#wrglossary.11574">468</a>, <a href="#wrglossary.12063">493</a>, <a href="#wrglossary.12080">495</a>, <a href="#wrglossary.12306">503</a>, <a href="#wrglossary.12348">505</a>, <a href="#wrglossary.21108">852</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.cat.index"><span class="csoptfmt">index</span></a><span class="qquad"></span><a href="#sec:knowncategories">§10.1</a>; <a href="#wrglossary.249">12</a>, <a href="#wrglossary.12069">493</a>, <a href="#wrglossary.21111">852</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.cat.number"><span class="csoptfmt">number</span></a><span class="qquad"></span><a href="#sec:knowncategories">§10.1</a>; <a href="#wrglossary.219">11</a>, <a href="#wrglossary.12073">494</a>, <a href="#wrglossary.21114">853</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.cat.symbol"><span class="csoptfmt">symbol</span></a><span class="qquad"></span><a href="#sec:knowncategories">§10.1</a>; <a href="#wrglossary.201">10</a>, <a href="#wrglossary.10276">402</a>, <a href="#wrglossary.12071">494</a>, <a href="#wrglossary.21121">853</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.cat.term"><span class="csoptfmt">term</span></dfn><span class="qquad"></span><a href="#wrglossary.10736">422</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.categoryattribute">category attributes</dfn><span class="qquad"></span><a href="#wrglossary.6325">247</a>, <a href="#wrglossary.14638">608</a>, <a href="#wrglossary.14692">610</a>, <a href="#wrglossary.19745">796</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.accessaposplural"><span class="csoptfmt">accessaposplural</span></a><span class="qquad"></span><a href="#sec:accessabbr">§9.1</a>; <a href="#wrglossary.11717">476</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.accessinsertdots"><span class="csoptfmt">accessinsertdots</span></a><span class="qquad"></span><a href="#sec:accessabbr">§9.1</a>; <a href="#wrglossary.11712">476</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.accessnoshortplural"><span class="csoptfmt">accessnoshortplural</span></a><span class="qquad"></span><a href="#sec:accessabbr">§9.1</a>; <a href="#wrglossary.11724">476</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.aposplural"><span class="csoptfmt">aposplural</span></a><span class="qquad"></span><a href="#sec:abbrattr">§10.2.1.1</a>; <a href="#wrglossary.1334">43</a>, <a href="#wrglossary.4027">162</a>, <a href="#wrglossary.11719">476</a>, <a href="#wrglossary.12149">497</a>, <a href="#wrglossary.12160">498</a>, <a href="#wrglossary.18683">754</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.combinedfirstsep"><span class="csoptfmt">combinedfirstsep</span></a><span class="qquad"></span><a href="#sec:multiglscategory">§7.8</a>; <a href="#wrglossary.8684">344</a>, <a href="#wrglossary.8860">354</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.combinedfirstsepfirst"><span class="csoptfmt">combinedfirstsepfirst</span></a><span class="qquad"></span><a href="#sec:multiglscategory">§7.8</a>; <a href="#wrglossary.8702">344</a>, <a href="#wrglossary.8862">354</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.combinedsep"><span class="csoptfmt">combinedsep</span></a><span class="qquad"></span><a href="#sec:multiglscategory">§7.8</a>; <a href="#wrglossary.8676">343</a>, <a href="#wrglossary.8866">354</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.combinedsepfirst"><span class="csoptfmt">combinedsepfirst</span></a><span class="qquad"></span><a href="#sec:multiglscategory">§7.8</a>; <a href="#wrglossary.8693">344</a>, <a href="#wrglossary.8864">354</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.discardperiod"><span class="csoptfmt">discardperiod</span></a><span class="qquad"></span><a href="#sec:abbrattr">§10.2.1.1</a>; <a href="#wrglossary.6327">247</a>, <a href="#wrglossary.8426">330</a>, <a href="#wrglossary.12083">495</a>, <a href="#wrglossary.12148">497</a>, <a href="#wrglossary.19747">796</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.dualindex"><span class="csoptfmt">dualindex</span></a><span class="qquad"></span><a href="#sec:otherattr">§10.2.1.4</a>; <a href="#wrglossary.12265">502</a>, <a href="#wrglossary.14007">574</a>, <a href="#wrglossary.14065">576</a>, <a href="#wrglossary.14197">586</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.catattr.encapinnerfmt"><span class="csoptfmt">encapinnerfmt</span></dfn><span class="qquad"></span><a href="#wrglossary.6214">243</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.catattr.encapnocase"><span class="csoptfmt">encapnocase</span></dfn></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.catattr.encapnocaseinnerfmt"><span class="csoptfmt">encapnocaseinnerfmt</span></dfn><span class="qquad"></span><a href="#wrglossary.6215">243</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.entrycount"><span class="csoptfmt">entrycount</span></a><span class="qquad"></span><a href="#sec:otherattr">§10.2.1.4</a>; <a href="#wrglossary.7948">308</a>, <a href="#wrglossary.7972">309</a>, <a href="#wrglossary.8050">311</a>–<a href="#wrglossary.8077">313</a>, <a href="#wrglossary.12257">501</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.externallocation"><span class="csoptfmt">externallocation</span></a><span class="qquad"></span><a href="#sec:otherattr">§10.2.1.4</a>; <a href="#wrglossary.4966">195</a>, <a href="#wrglossary.4967">196</a>, <a href="#wrglossary.12324">503</a>, <a href="#wrglossary.13516">555</a>, <a href="#wrglossary.21719">876</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.firstshortaccess"><span class="csoptfmt">firstshortaccess</span></a><span class="qquad"></span><a href="#sec:accessabbr">§9.1</a>; <a href="#wrglossary.4229">168</a>, <a href="#wrglossary.4242">169</a>, <a href="#wrglossary.11740">477</a>, <a href="#wrglossary.14574">606</a>, <a href="#wrglossary.14587">607</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.glossdesc"><span class="csoptfmt">glossdesc</span></a><span class="qquad"></span><a href="#sec:glossattr">§10.2.1.3</a>; <a href="#wrglossary.5010">197</a>, <a href="#wrglossary.5140">200</a>, <a href="#wrglossary.5996">234</a>, <a href="#wrglossary.10650">418</a>, <a href="#wrglossary.12206">499</a>, <a href="#wrglossary.12237">501</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.glossdescfont"><span class="csoptfmt">glossdescfont</span></a><span class="qquad"></span><a href="#sec:glossattr">§10.2.1.3</a>; <a href="#wrglossary.10651">418</a>, <a href="#wrglossary.12231">500</a>, <a href="#wrglossary.12246">501</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.glossname"><span class="csoptfmt">glossname</span></a><span class="qquad"></span><a href="#sec:glossattr">§10.2.1.3</a>; <a href="#wrglossary.5009">197</a>, <a href="#wrglossary.10648">418</a>, <a href="#wrglossary.10685">419</a>, <a href="#wrglossary.11429">458</a>, <a href="#wrglossary.12236">500</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.glossnamefont"><span class="csoptfmt">glossnamefont</span></a><span class="qquad"></span><a href="#sec:glossattr">§10.2.1.3</a>; <a href="#wrglossary.10570">415</a>, <a href="#wrglossary.10649">418</a>, <a href="#wrglossary.10686">419</a>, <a href="#wrglossary.11428">458</a>, <a href="#wrglossary.12245">501</a>, <a href="#wrglossary.18567">751</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.glosssymbolfont"><span class="csoptfmt">glosssymbolfont</span></a><span class="qquad"></span><a href="#sec:glossattr">§10.2.1.3</a>; <a href="#wrglossary.10653">418</a>, <a href="#wrglossary.12251">501</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.headuc"><span class="csoptfmt">headuc</span></a><span class="qquad"></span><a href="#sec:otherattr">§10.2.1.4</a>; <a href="#wrglossary.5220">204</a>, <a href="#wrglossary.5543">216</a>–<a href="#wrglossary.5602">218</a>, <a href="#wrglossary.12255">501</a>, <a href="#wrglossary.20146">812</a>–<a href="#wrglossary.20265">816</a>, <a href="#wrglossary.20365">820</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.hyperoutside"><span class="csoptfmt">hyperoutside</span></a><span class="qquad"></span><a href="#sec:glsoptsattr">§10.2.1.2</a>; <a href="#wrglossary.4792">189</a>, <a href="#wrglossary.12204">499</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.indexname"><span class="csoptfmt">indexname</span></a><span class="qquad"></span><a href="#sec:glossattr">§10.2.1.3</a>; <a href="#wrglossary.10698">420</a>, <a href="#wrglossary.12242">501</a>, <a href="#wrglossary.14006">574</a>, <a href="#wrglossary.14198">586</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.indexonlyfirst"><span class="csoptfmt">indexonlyfirst</span></a><span class="qquad"></span><a href="#sec:glsoptsattr">§10.2.1.2</a>; <a href="#wrglossary.6938">265</a>, <a href="#wrglossary.12191">499</a>, <a href="#wrglossary.14072">576</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.catattr.innertextformat"><span class="csoptfmt">innertextformat</span></dfn><span class="qquad"></span><a href="#wrglossary.6226">243</a>, <a href="#wrglossary.19501">784</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.insertdots"><span class="csoptfmt">insertdots</span></a><span class="qquad"></span><a href="#sec:abbrattr">§10.2.1.1</a>; <a href="#wrglossary.4026">162</a>, <a href="#wrglossary.11714">476</a>, <a href="#wrglossary.12139">497</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.linkcount"><span class="csoptfmt">linkcount</span></a><span class="qquad"></span><a href="#sec:otherattr">§10.2.1.4</a>; <a href="#wrglossary.8151">317</a>, <a href="#wrglossary.8217">320</a>, <a href="#wrglossary.12261">501</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.linkcountmaster"><span class="csoptfmt">linkcountmaster</span></a><span class="qquad"></span><a href="#sec:otherattr">§10.2.1.4</a>; <a href="#wrglossary.8152">317</a>, <a href="#wrglossary.12263">502</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.markshortwords"><span class="csoptfmt">markshortwords</span></a><span class="qquad"></span><a href="#sec:abbrattr">§10.2.1.1</a>; <a href="#wrglossary.1327">43</a>, <a href="#wrglossary.1813">63</a>, <a href="#wrglossary.2728">103</a>, <a href="#wrglossary.3657">148</a>, <a href="#wrglossary.4025">162</a>, <a href="#wrglossary.4154">167</a>, <a href="#wrglossary.4191">168</a>, <a href="#wrglossary.4394">174</a>, <a href="#wrglossary.4482">177</a>, <a href="#wrglossary.12129">497</a>, <a href="#wrglossary.15091">631</a>, <a href="#wrglossary.15313">639</a>, <a href="#wrglossary.17836">721</a>, <a href="#wrglossary.19340">778</a>, <a href="#wrglossary.22083">893</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.markwords"><span class="csoptfmt">markwords</span></a><span class="qquad"></span><a href="#sec:abbrattr">§10.2.1.1</a>; <a href="#wrglossary.1326">43</a>, <a href="#wrglossary.1812">63</a>, <a href="#wrglossary.2727">103</a>, <a href="#wrglossary.3656">148</a>, <a href="#wrglossary.4023">162</a>, <a href="#wrglossary.4202">168</a>, <a href="#wrglossary.4447">176</a>, <a href="#wrglossary.12104">496</a>, <a href="#wrglossary.12130">497</a>, <a href="#wrglossary.15071">630</a>, <a href="#wrglossary.15090">631</a>, <a href="#wrglossary.15312">639</a>, <a href="#wrglossary.17841">721</a>, <a href="#wrglossary.19345">779</a>, <a href="#wrglossary.22082">893</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.multioptions"><span class="csoptfmt">multioptions</span></a><span class="qquad"></span><a href="#sec:multiglscategory">§7.8</a>; <a href="#wrglossary.8472">332</a>, <a href="#wrglossary.8856">353</a>, <a href="#wrglossary.8878">354</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.nameshortaccess"><span class="csoptfmt">nameshortaccess</span></a><span class="qquad"></span><a href="#sec:accessabbr">§9.1</a>; <a href="#wrglossary.4228">168</a>, <a href="#wrglossary.4253">169</a>, <a href="#wrglossary.11730">476</a>, <a href="#wrglossary.14534">605</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.nohyper"><span class="csoptfmt">nohyper</span></a><span class="qquad"></span><a href="#sec:glsoptsattr">§10.2.1.2</a>; <a href="#wrglossary.6567">256</a>, <a href="#wrglossary.12187">499</a>, <a href="#wrglossary.12349">505</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.nohyperfirst"><span class="csoptfmt">nohyperfirst</span></a><span class="qquad"></span><a href="#sec:glsoptsattr">§10.2.1.2</a>; <a href="#wrglossary.3021">115</a>, <a href="#wrglossary.3045">116</a>, <a href="#wrglossary.4708">186</a>, <a href="#wrglossary.4771">189</a>, <a href="#wrglossary.6568">256</a>, <a href="#wrglossary.12167">498</a>, <a href="#wrglossary.15303">639</a>, <a href="#wrglossary.19654">792</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.nohypernext"><span class="csoptfmt">nohypernext</span></a><span class="qquad"></span><a href="#sec:glsoptsattr">§10.2.1.2</a>; <a href="#wrglossary.4709">186</a>, <a href="#wrglossary.6569">256</a>, <a href="#wrglossary.12183">498</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.noshortplural"><span class="csoptfmt">noshortplural</span></a><span class="qquad"></span><a href="#sec:abbrattr">§10.2.1.1</a>; <a href="#wrglossary.1337">44</a>, <a href="#wrglossary.4028">162</a>, <a href="#wrglossary.11727">476</a>, <a href="#wrglossary.12152">497</a>, <a href="#wrglossary.12156">498</a>, <a href="#wrglossary.15690">653</a>, <a href="#wrglossary.18682">754</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.pluraldiscardperiod"><span class="csoptfmt">pluraldiscardperiod</span></a><span class="qquad"></span><a href="#sec:abbrattr">§10.2.1.1</a>; <a href="#wrglossary.12095">495</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.catattr.recordcount"><span class="csoptfmt">recordcount</span></dfn><span class="qquad"></span><a href="#wrglossary.12770">524</a>–<a href="#wrglossary.12824">526</a>, <a href="#wrglossary.20412">822</a>, <a href="#wrglossary.21462">867</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.regular"><span class="csoptfmt">regular</span></a><span class="qquad"></span><a href="#sec:abbrattr">§10.2.1.1</a>; <a href="#wrglossary.12076">494</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.retainfirstuseperiod"><span class="csoptfmt">retainfirstuseperiod</span></a><span class="qquad"></span><a href="#sec:abbrattr">§10.2.1.1</a>; <a href="#wrglossary.6328">247</a>, <a href="#wrglossary.8427">330</a>, <a href="#wrglossary.12099">495</a>, <a href="#wrglossary.19754">796</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.tagging"><span class="csoptfmt">tagging</span></a><span class="qquad"></span><a href="#sec:abbrattr">§10.2.1.1</a>; <a href="#wrglossary.1710">58</a>, <a href="#wrglossary.1736">59</a>, <a href="#wrglossary.12164">498</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.targetcategory"><span class="csoptfmt">targetcategory</span></a><span class="qquad"></span><a href="#sec:otherattr">§10.2.1.4</a>; <a href="#wrglossary.12294">503</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.targetname"><span class="csoptfmt">targetname</span></a><span class="qquad"></span><a href="#sec:otherattr">§10.2.1.4</a>; <a href="#wrglossary.12279">502</a>, <a href="#wrglossary.12295">503</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.targeturl"><span class="csoptfmt">targeturl</span></a><span class="qquad"></span><a href="#sec:otherattr">§10.2.1.4</a>; <a href="#wrglossary.1101">36</a>, <a href="#wrglossary.6577">256</a>, <a href="#wrglossary.12270">502</a>, <a href="#wrglossary.14218">588</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.textformat"><span class="csoptfmt">textformat</span></a><span class="qquad"></span><a href="#sec:glsoptsattr">§10.2.1.2</a>; <a href="#wrglossary.4828">191</a>, <a href="#wrglossary.6104">238</a>, <a href="#wrglossary.6127">239</a>, <a href="#wrglossary.12197">499</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.textshortaccess"><span class="csoptfmt">textshortaccess</span></a><span class="qquad"></span><a href="#sec:accessabbr">§9.1</a>; <a href="#wrglossary.4230">168</a>, <a href="#wrglossary.4243">169</a>, <a href="#wrglossary.11734">477</a>, <a href="#wrglossary.14652">608</a>, <a href="#wrglossary.14726">611</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.catattr.unitcount"><span class="csoptfmt">unitcount</span></dfn><span class="qquad"></span><a href="#wrglossary.8078">313</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.catattr.wrgloss"><span class="csoptfmt">wrgloss</span></a><span class="qquad"></span><a href="#sec:glsoptsattr">§10.2.1.2</a>; <a href="#wrglossary.4638">185</a>, <a href="#wrglossary.4774">189</a>, <a href="#wrglossary.4935">194</a>, <a href="#wrglossary.6911">264</a>, <a href="#wrglossary.12193">499</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx0"><dfn id="glo:catpostdeschook">category post-description hook</dfn><span class="qquad"></span><a href="#wrglossary.202">10</a>–<a href="#wrglossary.254">12</a>, <a href="#wrglossary.10718">421</a>, <a href="#wrglossary.10749">422</a>, <a href="#wrglossary.10898">428</a>, <span class="termslocfmt"><a href="#wrglossary.14298">599</a></span>, <a href="#wrglossary.14471">603</a>, <a href="#wrglossary.21117">853</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:catpostlinkhook">category post-link hook</dfn><span class="qquad"></span><a href="#wrglossary.6029">235</a>, <a href="#wrglossary.6065">237</a>, <a href="#wrglossary.6266">245</a>–<a href="#wrglossary.6344">248</a>, <a href="#wrglossary.6372">250</a>, <a href="#wrglossary.6389">251</a>, <a href="#wrglossary.10766">423</a>, <a href="#wrglossary.13727">563</a>, <span class="termslocfmt"><a href="#wrglossary.14302">599</a></span>, <a href="#wrglossary.14481">603</a>, <a href="#wrglossary.21190">855</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:catpostnamehook">category post-name hook</dfn><span class="qquad"></span><a href="#wrglossary.13728">563</a>, <span class="termslocfmt"><a href="#wrglossary.14306">599</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:cGLS"><code class="csfmt">\cGLS</code></a><span class="qquad"></span><a href="#sec:entrycount">§6.1</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.8033">311</a>, <a href="#wrglossary.15665">653</a>, <a href="#wrglossary.15719">654</a>, <span class="summarylocfmt"><a href="#wrglossary.16198">665</a></span>, <a href="#wrglossary.16216">666</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></a> &amp; <a href="#glo:cGLSformat"><code class="csfmt">\cGLSformat</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:cGls"><code class="csfmt">\cGls</code></a><span class="qquad"></span><a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8016">310</a>, <a href="#wrglossary.15672">653</a>, <a href="#wrglossary.15726">654</a>, <span class="summarylocfmt"><a href="#wrglossary.16203">665</a></span>, <a href="#wrglossary.16219">666</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></a> &amp; <a href="#glo:cGlsformat"><code class="csfmt">\cGlsformat</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:cgls"><code class="csfmt">\cgls</code></a><span class="qquad"></span><a href="#sec:entrycount">§6.1</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.1706">56</a>, <a href="#wrglossary.4585">183</a>, <a href="#wrglossary.7958">308</a>, <a href="#wrglossary.7995">309</a>, <a href="#wrglossary.8085">313</a>, <a href="#wrglossary.12260">501</a>, <a href="#wrglossary.12768">524</a>, <a href="#wrglossary.12863">527</a>, <a href="#wrglossary.15679">653</a>, <a href="#wrglossary.15736">654</a>, <span class="summarylocfmt"><a href="#wrglossary.16209">665</a></span>, <a href="#wrglossary.16222">666</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></a> &amp; <a href="#glo:cglsformat"><code class="csfmt">\cglsformat</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:cGLSformat"><code class="csfmt">\cGLSformat</code></a><span class="qquad"></span><a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8038">311</a>, <span class="summarylocfmt"><a href="#wrglossary.16215">665</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:cGlsformat"><code class="csfmt">\cGlsformat</code></a><span class="qquad"></span><a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8021">310</a>, <span class="summarylocfmt"><a href="#wrglossary.16217">666</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:cglsformat"><code class="csfmt">\cglsformat</code></a><span class="qquad"></span><a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.7994">309</a>–<a href="#wrglossary.8030">311</a>, <a href="#wrglossary.12769">524</a>, <a href="#wrglossary.12812">525</a>, <span class="summarylocfmt"><a href="#wrglossary.16220">666</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:cGLSpl"><code class="csfmt">\cGLSpl</code></a><span class="qquad"></span><a href="#sec:entrycount">§6.1</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.8041">311</a>, <a href="#wrglossary.15698">654</a>, <a href="#wrglossary.15854">656</a>, <span class="summarylocfmt"><a href="#wrglossary.16223">666</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></a> &amp; <a href="#glo:cGLSplformat"><code class="csfmt">\cGLSplformat</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:cGlspl"><code class="csfmt">\cGlspl</code></a><span class="qquad"></span><a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8024">310</a>, <a href="#wrglossary.15705">654</a>, <a href="#wrglossary.15861">656</a>, <span class="summarylocfmt"><a href="#wrglossary.16228">666</a></span>, <a href="#wrglossary.16244">667</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></a> &amp; <a href="#glo:cGlsplformat"><code class="csfmt">\cGlsplformat</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:cglspl"><code class="csfmt">\cglspl</code></a><span class="qquad"></span><a href="#sec:entrycount">§6.1</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.8009">310</a>, <a href="#wrglossary.15712">654</a>, <a href="#wrglossary.15871">657</a>, <span class="summarylocfmt"><a href="#wrglossary.16234">666</a></span>, <a href="#wrglossary.16247">667</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></a> &amp; <a href="#glo:cglsplformat"><code class="csfmt">\cglsplformat</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:cGLSplformat"><code class="csfmt">\cGLSplformat</code></a><span class="qquad"></span><a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8046">311</a>, <span class="summarylocfmt"><a href="#wrglossary.16240">666</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:cGlsplformat"><code class="csfmt">\cGlsplformat</code></a><span class="qquad"></span><a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8029">311</a>, <span class="summarylocfmt"><a href="#wrglossary.16242">667</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:cglsplformat"><code class="csfmt">\cglsplformat</code></a><span class="qquad"></span><a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8014">310</a>, <a href="#wrglossary.8047">311</a>, <span class="summarylocfmt"><a href="#wrglossary.16245">667</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:chapter"><code class="csfmt">\chapter</code></dfn><span class="qquad"></span><a href="#wrglossary.10961">431</a>, <a href="#wrglossary.16485">675</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:ctr.chapter"><span class="ctrfmt">chapter</span> counter</dfn><span class="qquad"></span><a href="#wrglossary.8080">313</a>, <a href="#wrglossary.12904">529</a>, <a href="#wrglossary.12958">530</a>, <a href="#wrglossary.13026">533</a>, <a href="#wrglossary.13529">555</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:char"><code class="csfmt">\char</code></dfn><span class="qquad"></span><a href="#wrglossary.9701">385</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Chi"><code class="csfmt">\Chi</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13983">573</a>, <span class="summarylocfmt"><a href="#wrglossary.16248">667</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:cli">CLI</dfn><span class="qquad"></span><span class="termslocfmt"><a href="#wrglossary.14310">599</a></span>, <a href="#wrglossary.14393">601</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:app.convertgls2bib"><span class="appfmt">convertgls2bib</span></dfn><span class="qquad"></span><a href="#wrglossary.7178">272</a>, <a href="#wrglossary.12386">508</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx1"><dfn id="glo:switch.index-conversion"><span class="longargfmt">--index-conversion</span></dfn><span class="qquad"></span><a href="#wrglossary.7179">272</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:switch.preamble-only"><span class="longargfmt">--preamble-only</span></dfn></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx0"><dfn id="glo:csdef"><code class="csfmt">\csdef</code></dfn><span class="qquad"></span><a href="#wrglossary.1165">38</a>, <a href="#wrglossary.1198">39</a>, <a href="#wrglossary.20573">829</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:csGlsXtrLetField"><code class="csfmt">\csGlsXtrLetField</code></a><span class="qquad"></span><a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1192">39</a>, <a href="#wrglossary.1214">40</a>, <span class="summarylocfmt"><a href="#wrglossary.16251">667</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:cslet"><code class="csfmt">\cslet</code></dfn><span class="qquad"></span><a href="#wrglossary.1211">40</a>, <a href="#wrglossary.16256">667</a>, <a href="#wrglossary.20572">829</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:csletcs"><code class="csfmt">\csletcs</code></dfn><span class="qquad"></span><a href="#wrglossary.1216">40</a>, <a href="#wrglossary.16255">667</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:currentglossary"><code class="csfmt">\currentglossary</code></a><span class="qquad"></span><a href="#wrglossary.10192">399</a>, <a href="#wrglossary.10550">414</a>, <a href="#wrglossary.10965">431</a>, <span class="summarylocfmt"><a href="#wrglossary.16257">667</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></dfn><span class="qquad"></span><a href="#wrglossary.14276">593</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></dfn><span class="qquad"></span><a href="#wrglossary.14278">593</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:CustomAbbreviationFields"><code class="csfmt">\CustomAbbreviationFields</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4093">165</a>, <a href="#wrglossary.4157">167</a>, <a href="#wrglossary.4197">168</a>, <span class="summarylocfmt"><a href="#wrglossary.16260">667</a></span></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index6684672 -->
+
+<section id="index6750208"><!-- start of section index6750208 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->D<div class="labellink"><a href="#index6750208">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.datatool-base"><span class="styfmt">datatool-base</span> package</dfn><span class="qquad"></span><a href="#wrglossary.7816">302</a>, <a href="#wrglossary.7854">303</a>, <a href="#wrglossary.16384">671</a>, <a href="#wrglossary.19852">801</a>, <a href="#wrglossary.20348">819</a>, <a href="#wrglossary.20422">822</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.datatool"><span class="styfmt">datatool</span> package</dfn><span class="qquad"></span><a href="#wrglossary.7866">304</a>, <a href="#wrglossary.12367">507</a>, <a href="#wrglossary.16385">671</a>, <a href="#wrglossary.18026">730</a>, <a href="#wrglossary.19859">801</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:defglsentryfmt"><code class="csfmt">\defglsentryfmt</code></a><span class="qquad"></span><a href="#wrglossary.2216">81</a>, <a href="#wrglossary.4659">185</a>, <a href="#wrglossary.6506">254</a>, <span class="summarylocfmt"><a href="#wrglossary.16261">667</a></span>, <a href="#wrglossary.17153">698</a>, <a href="#wrglossary.17196">700</a>, <a href="#wrglossary.18045">731</a>–<a href="#wrglossary.18100">733</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:delimN"><code class="csfmt">\delimN</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.16269">668</a></span>, <a href="#wrglossary.18011">729</a>, <a href="#wrglossary.18590">752</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:delimR"><code class="csfmt">\delimR</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.16272">668</a></span>, <a href="#wrglossary.18010">729</a>, <a href="#wrglossary.18589">752</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:Delta"><code class="csfmt">\Delta</code></dfn><span class="qquad"></span><a href="#wrglossary.13381">552</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:env.description"><span class="envfmt">description</span> environment</dfn><span class="qquad"></span><a href="#wrglossary.15493">646</a>, <a href="#wrglossary.23486">940</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:descriptionname"><code class="csfmt">\descriptionname</code></a><span class="qquad"></span><a href="#wrglossary.11221">446</a>, <a href="#wrglossary.11599">469</a>, <span class="summarylocfmt"><a href="#wrglossary.16275">668</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:dGLS"><code class="csfmt">\dGLS</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13769">565</a>, <span class="summarylocfmt"><a href="#wrglossary.16278">668</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a> &amp; <a href="#glo:glsxtrprependlabelprefix"><code class="csfmt">\glsxtrprependlabelprefix</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:dGls"><code class="csfmt">\dGls</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13759">565</a>, <span class="summarylocfmt"><a href="#wrglossary.16285">668</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a> &amp; <a href="#glo:glsxtrprependlabelprefix"><code class="csfmt">\glsxtrprependlabelprefix</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:dgls"><code class="csfmt">\dgls</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.4582">183</a>, <a href="#wrglossary.13748">564</a>, <a href="#wrglossary.13876">569</a>, <a href="#wrglossary.13890">570</a>, <span class="summarylocfmt"><a href="#wrglossary.16292">668</a></span>, <a href="#wrglossary.16310">669</a>, <a href="#wrglossary.16353">670</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a> &amp; <a href="#glo:glsxtrprependlabelprefix"><code class="csfmt">\glsxtrprependlabelprefix</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:dGlsdisp"><code class="csfmt">\dGlsdisp</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13794">565</a>, <span class="summarylocfmt"><a href="#wrglossary.16298">669</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a> &amp; <a href="#glo:glsxtrprependlabelprefix"><code class="csfmt">\glsxtrprependlabelprefix</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:dglsdisp"><code class="csfmt">\dglsdisp</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13789">565</a>, <span class="summarylocfmt"><a href="#wrglossary.16305">669</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a> &amp; <a href="#glo:glsxtrprependlabelprefix"><code class="csfmt">\glsxtrprependlabelprefix</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:dGLSfield"><code class="csfmt">\dGLSfield</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13810">566</a>, <a href="#wrglossary.13825">567</a>, <span class="summarylocfmt"><a href="#wrglossary.16312">669</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a> &amp; <a href="#glo:glsxtrprependlabelprefix"><code class="csfmt">\glsxtrprependlabelprefix</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:dGlsfield"><code class="csfmt">\dGlsfield</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13805">566</a>, <a href="#wrglossary.13823">567</a>, <span class="summarylocfmt"><a href="#wrglossary.16319">669</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a> &amp; <a href="#glo:glsxtrprependlabelprefix"><code class="csfmt">\glsxtrprependlabelprefix</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:dglsfield"><code class="csfmt">\dglsfield</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13799">566</a>, <a href="#wrglossary.13821">567</a>, <span class="summarylocfmt"><a href="#wrglossary.16326">669</a></span>, <a href="#wrglossary.16337">670</a>, <a href="#wrglossary.22757">917</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a> &amp; <a href="#glo:glsxtrprependlabelprefix"><code class="csfmt">\glsxtrprependlabelprefix</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:dglsfieldactualfieldlabel"><code class="csfmt">\dglsfieldactualfieldlabel</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13835">567</a>, <span class="summarylocfmt"><a href="#wrglossary.16332">669</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:dglsfieldcurrentfieldlabel"><code class="csfmt">\dglsfieldcurrentfieldlabel</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13831">567</a>, <span class="summarylocfmt"><a href="#wrglossary.16335">669</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:dglsfieldfallbackfieldlabel"><code class="csfmt">\dglsfieldfallbackfieldlabel</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13833">567</a>, <span class="summarylocfmt"><a href="#wrglossary.16338">670</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:dGlslink"><code class="csfmt">\dGlslink</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13784">565</a>, <span class="summarylocfmt"><a href="#wrglossary.16341">670</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a> &amp; <a href="#glo:glsxtrprependlabelprefix"><code class="csfmt">\glsxtrprependlabelprefix</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:dglslink"><code class="csfmt">\dglslink</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13779">565</a>, <span class="summarylocfmt"><a href="#wrglossary.16348">670</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a> &amp; <a href="#glo:glsxtrprependlabelprefix"><code class="csfmt">\glsxtrprependlabelprefix</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:dGLSpl"><code class="csfmt">\dGLSpl</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13774">565</a>, <span class="summarylocfmt"><a href="#wrglossary.16355">670</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a> &amp; <a href="#glo:glsxtrprependlabelprefix"><code class="csfmt">\glsxtrprependlabelprefix</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:dGlspl"><code class="csfmt">\dGlspl</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13764">565</a>, <span class="summarylocfmt"><a href="#wrglossary.16362">670</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a> &amp; <a href="#glo:glsxtrprependlabelprefix"><code class="csfmt">\glsxtrprependlabelprefix</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:dglspl"><code class="csfmt">\dglspl</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13754">564</a>, <span class="summarylocfmt"><a href="#wrglossary.16369">670</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a> &amp; <a href="#glo:glsxtrprependlabelprefix"><code class="csfmt">\glsxtrprependlabelprefix</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Digamma"><code class="csfmt">\Digamma</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13364">551</a>, <a href="#wrglossary.13371">552</a>, <a href="#wrglossary.13984">573</a>, <span class="summarylocfmt"><a href="#wrglossary.16376">671</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:digamma"><code class="csfmt">\digamma</code></dfn><span class="qquad"></span><a href="#wrglossary.13363">551</a>–<a href="#wrglossary.13400">553</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:displayfullform">display full form</dfn><span class="qquad"></span><a href="#wrglossary.1471">50</a>, <a href="#wrglossary.1815">63</a>, <a href="#wrglossary.2230">81</a>, <a href="#wrglossary.2385">88</a>, <a href="#wrglossary.2498">93</a>, <a href="#wrglossary.2653">100</a>, <a href="#wrglossary.2732">103</a>, <a href="#wrglossary.2755">104</a>, <a href="#wrglossary.2800">106</a>, <a href="#wrglossary.2873">109</a>–<a href="#wrglossary.2937">111</a>, <a href="#wrglossary.3259">132</a>, <a href="#wrglossary.4307">170</a>, <a href="#wrglossary.4338">172</a>, <a href="#wrglossary.4352">173</a>, <a href="#wrglossary.4426">175</a>, <span class="termslocfmt"><a href="#wrglossary.14311">599</a></span>, <a href="#wrglossary.14422">601</a>, <a href="#wrglossary.20004">806</a>, <a href="#wrglossary.20044">807</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:env.document"><span class="envfmt">document</span> environment</dfn><span class="qquad"></span><a href="#wrglossary.374">16</a>, <a href="#wrglossary.404">17</a>, <a href="#wrglossary.1144">37</a>, <a href="#wrglossary.12510">512</a>, <a href="#wrglossary.14092">578</a>, <a href="#wrglossary.23557">942</a>, <a href="#wrglossary.23569">943</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:doifglossarynoexistsordo"><code class="csfmt">\doifglossarynoexistsordo</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.16379">671</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:ifglossaryexists"><code class="csfmt">\ifglossaryexists</code></a> &amp; <a href="#glo:glsxtrifemptyglossary"><code class="csfmt">\glsxtrifemptyglossary</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:dolistcsloop"><code class="csfmt">\dolistcsloop</code></dfn><span class="qquad"></span><a href="#wrglossary.7873">304</a>, <a href="#wrglossary.19843">800</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:DTLformatlist"><code class="csfmt">\DTLformatlist</code></a><span class="qquad"></span><a href="#wrglossary.7817">302</a>, <a href="#wrglossary.7867">304</a>, <span class="summarylocfmt"><a href="#wrglossary.16383">671</a></span>, <a href="#wrglossary.19853">801</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:DTLifinlist"><code class="csfmt">\DTLifinlist</code></a><span class="qquad"></span><a href="#wrglossary.7853">303</a>, <a href="#wrglossary.12368">507</a>, <span class="summarylocfmt"><a href="#wrglossary.16386">671</a></span>, <a href="#wrglossary.18027">730</a>, <a href="#wrglossary.20347">819</a>, <a href="#wrglossary.20421">822</a></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index6750208 -->
+
+<section id="index6815744"><!-- start of section index6815744 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->E<div class="labellink"><a href="#index6815744">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><a href="#glo:eglssetwidest"><code class="csfmt">\eglssetwidest</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11008">434</a>, <span class="summarylocfmt"><a href="#wrglossary.16389">671</a></span>, <a href="#wrglossary.23440">937</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:eglsupdatewidest"><code class="csfmt">\eglsupdatewidest</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11014">434</a>, <span class="summarylocfmt"><a href="#wrglossary.16392">672</a></span>, <a href="#wrglossary.23443">938</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:eGlsXtrSetField"><code class="csfmt">\eGlsXtrSetField</code></a><span class="qquad"></span><a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1190">39</a>, <a href="#wrglossary.1205">40</a>, <span class="summarylocfmt"><a href="#wrglossary.16395">672</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:emph"><code class="csfmt">\emph</code></dfn><span class="qquad"></span><a href="#wrglossary.3896">156</a>, <a href="#wrglossary.3932">158</a>, <a href="#wrglossary.15050">629</a>–<a href="#wrglossary.15106">631</a>, <a href="#wrglossary.15174">634</a>, <a href="#wrglossary.15222">635</a>, <a href="#wrglossary.15248">637</a>, <a href="#wrglossary.15268">638</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:encapchar"><code class="csfmt">\encapchar</code></dfn><span class="qquad"></span><a href="#wrglossary.14082">576</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:entrylocation">entry location</dfn><span class="qquad"></span><span class="termslocfmt"><a href="#wrglossary.14317">599</a></span>, <a href="#wrglossary.14395">601</a>, <a href="#wrglossary.14453">602</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:entryname"><code class="csfmt">\entryname</code></a><span class="qquad"></span><a href="#wrglossary.11220">446</a>, <a href="#wrglossary.11595">469</a>, <span class="summarylocfmt"><a href="#wrglossary.16398">672</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Epsilon"><code class="csfmt">\Epsilon</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13973">573</a>, <span class="summarylocfmt"><a href="#wrglossary.16401">672</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:ctr.equation"><span class="ctrfmt">equation</span> counter</dfn><span class="qquad"></span><a href="#wrglossary.790">26</a>, <a href="#wrglossary.832">27</a>, <a href="#wrglossary.13535">555</a>, <a href="#wrglossary.13559">556</a>, <a href="#wrglossary.13617">558</a>, <a href="#wrglossary.19837">800</a>, <a href="#wrglossary.23573">943</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:env.equation"><span class="envfmt">equation</span> environment</dfn><span class="qquad"></span><a href="#wrglossary.791">26</a>, <a href="#wrglossary.827">27</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Eta"><code class="csfmt">\Eta</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13975">573</a>, <span class="summarylocfmt"><a href="#wrglossary.16404">672</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.etoolbox"><span class="styfmt">etoolbox</span> package</dfn><span class="qquad"></span><a href="#wrglossary.1164">38</a>–<a href="#wrglossary.1210">40</a>, <a href="#wrglossary.7862">304</a>, <a href="#wrglossary.7878">305</a>, <a href="#wrglossary.8167">318</a>, <a href="#wrglossary.10401">407</a>, <a href="#wrglossary.12339">505</a>, <a href="#wrglossary.12535">513</a>, <a href="#wrglossary.14779">614</a>, <a href="#wrglossary.14807">615</a>, <a href="#wrglossary.16254">667</a>, <a href="#wrglossary.17992">728</a>, <a href="#wrglossary.19842">800</a>–<a href="#wrglossary.19875">802</a>, <a href="#wrglossary.20325">819</a>, <a href="#wrglossary.20571">829</a>, <a href="#wrglossary.22118">894</a>, <a href="#wrglossary.22128">895</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.example-glossaries-acronym.bib"><span class="filefmt">example-glossaries-acronym.bib</span></a><span class="qquad"></span><a href="#sec:exampleglossariesfiles">§14.1</a>; <a href="#wrglossary.14156">581</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.example-glossaries-acronym-desc.bib"><span class="filefmt">example-glossaries-acronym-desc.bib</span></a><span class="qquad"></span><a href="#sec:exampleglossariesfiles">§14.1</a>; <a href="#wrglossary.14157">581</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.example-glossaries-acronyms-lang.bib"><span class="filefmt">example-glossaries-acronyms-lang.bib</span></a><span class="qquad"></span><a href="#sec:exampleglossariesfiles">§14.1</a>; <a href="#wrglossary.14158">581</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.example-glossaries-brief.bib"><span class="filefmt">example-glossaries-brief.bib</span></a><span class="qquad"></span><a href="#sec:exampleglossariesfiles">§14.1</a>; <a href="#wrglossary.14159">581</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.example-glossaries-childmultipar.bib"><span class="filefmt">example-glossaries-childmultipar.bib</span></a><span class="qquad"></span><a href="#sec:exampleglossariesfiles">§14.1</a>; <a href="#wrglossary.14160">581</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.example-glossaries-childnoname.bib"><span class="filefmt">example-glossaries-childnoname.bib</span></a><span class="qquad"></span><a href="#sec:exampleglossariesfiles">§14.1</a>; <a href="#wrglossary.14161">581</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.example-glossaries-cite.bib"><span class="filefmt">example-glossaries-cite.bib</span></a><span class="qquad"></span><a href="#sec:exampleglossariesfiles">§14.1</a>; <a href="#wrglossary.14162">581</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.example-glossaries-images.bib"><span class="filefmt">example-glossaries-images.bib</span></a><span class="qquad"></span><a href="#sec:exampleglossariesfiles">§14.1</a>; <a href="#wrglossary.14163">581</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.example-glossaries-long.bib"><span class="filefmt">example-glossaries-long.bib</span></a><span class="qquad"></span><a href="#sec:exampleglossariesfiles">§14.1</a>; <a href="#wrglossary.14164">581</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.example-glossaries-longchild.bib"><span class="filefmt">example-glossaries-longchild.bib</span></a><span class="qquad"></span><a href="#sec:exampleglossariesfiles">§14.1</a>; <a href="#wrglossary.14165">582</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.example-glossaries-multipar.bib"><span class="filefmt">example-glossaries-multipar.bib</span></a><span class="qquad"></span><a href="#sec:exampleglossariesfiles">§14.1</a>; <a href="#wrglossary.14166">582</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.example-glossaries-parent.bib"><span class="filefmt">example-glossaries-parent.bib</span></a><span class="qquad"></span><a href="#sec:exampleglossariesfiles">§14.1</a>; <a href="#wrglossary.14167">582</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.example-glossaries-symbolnames.bib"><span class="filefmt">example-glossaries-symbolnames.bib</span></a><span class="qquad"></span><a href="#sec:exampleglossariesfiles">§14.1</a>; <a href="#wrglossary.14168">582</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.example-glossaries-symbols.bib"><span class="filefmt">example-glossaries-symbols.bib</span></a><span class="qquad"></span><a href="#sec:exampleglossariesfiles">§14.1</a>; <a href="#wrglossary.14169">582</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:file.example-glossaries-symbolsnames.bib"><span class="filefmt">example-glossaries-symbolsnames.bib</span></dfn></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.example-glossaries-url.bib"><span class="filefmt">example-glossaries-url.bib</span></a><span class="qquad"></span><a href="#sec:exampleglossariesfiles">§14.1</a>; <a href="#wrglossary.14170">582</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.example-glossaries-xr.bib"><span class="filefmt">example-glossaries-xr.bib</span></a><span class="qquad"></span><a href="#sec:exampleglossariesfiles">§14.1</a>; <a href="#wrglossary.14171">582</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.example-glossaries-xr.tex"><span class="filefmt">example-glossaries-xr.tex</span></a><span class="qquad"></span><a href="#sec:exampleglossariesfiles">§14.1</a>; <a href="#wrglossary.14149">581</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:expandafter"><code class="csfmt">\expandafter</code></dfn><span class="qquad"></span><a href="#wrglossary.4140">166</a>, <a href="#wrglossary.6494">254</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:expandonce"><code class="csfmt">\expandonce</code></dfn><span class="qquad"></span><a href="#wrglossary.3297">133</a>, <a href="#wrglossary.3323">134</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ExtraCustomAbbreviationFields"><code class="csfmt">\ExtraCustomAbbreviationFields</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4007">162</a>, <a href="#wrglossary.4089">164</a>, <span class="summarylocfmt"><a href="#wrglossary.16407">672</a></span></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index6815744 -->
+
+<section id="index6881280"><!-- start of section index6881280 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->F<div class="labellink"><a href="#index6881280">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.fancyhdr"><span class="styfmt">fancyhdr</span> package</dfn><span class="qquad"></span><a href="#wrglossary.11186">444</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:fbox"><code class="csfmt">\fbox</code></dfn><span class="qquad"></span><a href="#wrglossary.6187">242</a>, <a href="#wrglossary.6218">243</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:field">field</dfn><span class="qquad"></span><a href="#wrglossary.930">32</a>, <a href="#wrglossary.1132">37</a>–<a href="#wrglossary.1212">40</a>, <a href="#wrglossary.4667">186</a>, <a href="#wrglossary.5399">210</a>, <a href="#wrglossary.5926">231</a>, <a href="#wrglossary.7583">291</a>, <a href="#wrglossary.7805">301</a>–<a href="#wrglossary.7845">303</a>, <a href="#wrglossary.7884">305</a>, <a href="#wrglossary.10196">399</a>, <span class="termslocfmt"><a href="#wrglossary.14323">599</a></span>, <a href="#wrglossary.14428">602</a>, <a href="#wrglossary.14611">607</a>, <a href="#wrglossary.14677">609</a>, <a href="#wrglossary.17336">704</a>–<a href="#wrglossary.17620">714</a>, <a href="#wrglossary.18106">733</a>, <a href="#wrglossary.19850">801</a>, <a href="#wrglossary.19952">805</a>, <a href="#wrglossary.20140">811</a>, <a href="#wrglossary.20144">812</a>, <a href="#wrglossary.20214">814</a>–<a href="#wrglossary.20259">816</a>, <a href="#wrglossary.20314">818</a>–<a href="#wrglossary.20354">820</a>, <a href="#wrglossary.20419">822</a>, <a href="#wrglossary.20576">830</a>, <a href="#wrglossary.21746">877</a>, <a href="#wrglossary.21750">878</a>, <a href="#wrglossary.21817">881</a>, <a href="#wrglossary.21844">882</a>, <a href="#wrglossary.21953">888</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:ctr.figure"><span class="ctrfmt">figure</span> counter</dfn></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:env.figure"><span class="envfmt">figure</span> environment</dfn><span class="qquad"></span><a href="#wrglossary.797">27</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:fileformat">file formats</dfn></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx1"><dfn id="glo:ext.acr"><span class="extfmt">acr</span></dfn><span class="qquad"></span><a href="#wrglossary.117">6</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:ext.aux"><span class="extfmt">aux</span></dfn><span class="qquad"></span><a href="#wrglossary.416">17</a>, <a href="#wrglossary.778">26</a>, <a href="#wrglossary.9340">371</a>, <a href="#wrglossary.10396">407</a>, <a href="#wrglossary.12372">508</a>, <a href="#wrglossary.12525">513</a>, <a href="#wrglossary.14407">601</a>, <a href="#wrglossary.14791">614</a>, <a href="#wrglossary.23135">927</a>, <a href="#wrglossary.23525">942</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:ext.bib"><span class="extfmt">bib</span></dfn><span class="qquad"></span><a href="#wrglossary.435">17</a>, <a href="#wrglossary.986">33</a>, <a href="#wrglossary.992">34</a>, <a href="#wrglossary.12379">508</a>, <a href="#wrglossary.14153">581</a>, <a href="#wrglossary.14440">602</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:ext.glg-abr"><span class="extfmt">glg-abr</span></dfn><span class="qquad"></span><a href="#wrglossary.161">9</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:ext.glg"><span class="extfmt">glg</span></dfn></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:ext.glo-abr"><span class="extfmt">glo-abr</span></dfn><span class="qquad"></span><a href="#wrglossary.163">9</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:ext.glo"><span class="extfmt">glo</span></dfn></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:ext.gls-abr"><span class="extfmt">gls-abr</span></dfn><span class="qquad"></span><a href="#wrglossary.162">9</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:ext.gls"><span class="extfmt">gls</span></dfn><span class="qquad"></span><a href="#wrglossary.417">17</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:ext.glsdefs"><span class="extfmt">glsdefs</span></dfn><span class="qquad"></span><a href="#wrglossary.396">16</a>, <a href="#wrglossary.406">17</a>, <a href="#wrglossary.1121">37</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:ext.glslabels"><span class="extfmt">glslabels</span></dfn><span class="qquad"></span><a href="#wrglossary.23869">950</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:ext.glstex"><span class="extfmt">glstex</span></dfn><span class="qquad"></span><a href="#wrglossary.1000">34</a>, <a href="#wrglossary.12381">508</a>, <a href="#wrglossary.12465">511</a>, <a href="#wrglossary.14507">603</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:ext.ist"><span class="extfmt">ist</span></dfn></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:ext.ldf"><span class="extfmt">ldf</span></dfn><span class="qquad"></span><a href="#wrglossary.14267">592</a>, <a href="#wrglossary.14280">593</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:ext.log"><span class="extfmt">log</span></dfn><span class="qquad"></span><a href="#wrglossary.23550">942</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:ext.tex"><span class="extfmt">tex</span></dfn><span class="qquad"></span><a href="#wrglossary.987">33</a>, <a href="#wrglossary.12376">508</a>, <a href="#wrglossary.14154">581</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:ext.toc"><span class="extfmt">toc</span></dfn><span class="qquad"></span><a href="#wrglossary.5497">215</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:ext.xdy"><span class="extfmt">xdy</span></dfn></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx0"><dfn id="glo:firstuse">first use</dfn><span class="qquad"></span><span class="termslocfmt"><a href="#wrglossary.14331">600</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:firstuseflag">first use flag</dfn><span class="qquad"></span><span class="termslocfmt"><a href="#wrglossary.14334">600</a></span>, <a href="#wrglossary.18190">736</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:firstusetext">first use text</dfn><span class="qquad"></span><span class="termslocfmt"><a href="#wrglossary.14336">600</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:firstacronymfont"><code class="csfmt">\firstacronymfont</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.16410">672</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.fontenc"><span class="styfmt">fontenc</span> package</dfn><span class="qquad"></span><a href="#wrglossary.1797">61</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:footnote"><code class="csfmt">\footnote</code></dfn><span class="qquad"></span><a href="#wrglossary.1848">64</a>, <a href="#wrglossary.6495">254</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:forallabbreviationlists"><code class="csfmt">\forallabbreviationlists</code></a><span class="qquad"></span><a href="#sec:glossaries">§8</a>; <a href="#wrglossary.9483">376</a>, <span class="summarylocfmt"><a href="#wrglossary.16416">673</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:forallglossaries"><code class="csfmt">\forallglossaries</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:forallacronyms"><code class="csfmt">\forallacronyms</code></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><span class="qquad"></span><a href="#wrglossary.9480">376</a>, <span class="summarylocfmt"><a href="#wrglossary.16418">673</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:forallglossaries"><code class="csfmt">\forallglossaries</code></a><span class="qquad"></span><a href="#wrglossary.9476">376</a>, <span class="summarylocfmt"><a href="#wrglossary.16423">673</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:forallglsentries"><code class="csfmt">\forallglsentries</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.16427">673</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:foreignlanguage"><code class="csfmt">\foreignlanguage</code></dfn><span class="qquad"></span><a href="#wrglossary.7658">293</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:forglsentries"><code class="csfmt">\forglsentries</code></a><span class="qquad"></span><a href="#wrglossary.347">15</a>, <span class="summarylocfmt"><a href="#wrglossary.16433">673</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:forallglsentries"><code class="csfmt">\forallglsentries</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:forlistcsloop"><code class="csfmt">\forlistcsloop</code></dfn><span class="qquad"></span><a href="#wrglossary.7869">304</a>, <a href="#wrglossary.19847">801</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:frontmatter"><code class="csfmt">\frontmatter</code></dfn><span class="qquad"></span><a href="#wrglossary.4731">187</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.fullstop">full stop (<code class="code">.</code>)</dfn><span class="qquad"></span><a href="#wrglossary.27">2</a>, <a href="#wrglossary.262">12</a>, <a href="#wrglossary.285">13</a>, <a href="#wrglossary.6317">247</a>, <a href="#wrglossary.6343">248</a>, <a href="#wrglossary.10935">429</a>, <a href="#wrglossary.12085">495</a>, <a href="#wrglossary.12141">497</a>, <a href="#wrglossary.13289">544</a>, <a href="#wrglossary.19744">796</a>, <a href="#wrglossary.20303">818</a>, <a href="#wrglossary.20404">822</a>, <a href="#wrglossary.21189">855</a>, <a href="#wrglossary.21194">856</a>, <a href="#wrglossary.23761">948</a></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index6881280 -->
+
+<section id="index6946816"><!-- start of section index6946816 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->G<div class="labellink"><a href="#index6946816">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.gettitlestring"><span class="styfmt">gettitlestring</span> package</dfn><span class="qquad"></span><a href="#wrglossary.5512">215</a>, <a href="#wrglossary.18162">735</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:GetTitleStringDisableCommands"><code class="csfmt">\GetTitleStringDisableCommands</code></dfn><span class="qquad"></span><a href="#wrglossary.5517">215</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:GetTitleStringSetup"><code class="csfmt">\GetTitleStringSetup</code></dfn><span class="qquad"></span><a href="#wrglossary.5518">215</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:gglssetwidest"><code class="csfmt">\gglssetwidest</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11006">434</a>, <span class="summarylocfmt"><a href="#wrglossary.16441">673</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:gglsupdatewidest"><code class="csfmt">\gglsupdatewidest</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11013">434</a>, <span class="summarylocfmt"><a href="#wrglossary.16444">674</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:gGlsXtrSetField"><code class="csfmt">\gGlsXtrSetField</code></a><span class="qquad"></span><a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1188">39</a>, <a href="#wrglossary.1203">40</a>, <span class="summarylocfmt"><a href="#wrglossary.16447">674</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.group">group (letters, numbers, symbols)</dfn><span class="qquad"></span><a href="#wrglossary.700">24</a>, <a href="#wrglossary.1022">34</a>, <a href="#wrglossary.1027">35</a>, <a href="#wrglossary.7209">273</a>, <a href="#wrglossary.9574">379</a>, <a href="#wrglossary.9695">385</a>, <a href="#wrglossary.9735">386</a>, <a href="#wrglossary.9808">388</a>–<a href="#wrglossary.9992">394</a>, <a href="#wrglossary.10117">396</a>, <a href="#wrglossary.10174">398</a>, <a href="#wrglossary.10197">399</a>, <a href="#wrglossary.10822">425</a>, <a href="#wrglossary.10835">426</a>, <a href="#wrglossary.10958">431</a>, <a href="#wrglossary.11118">441</a>, <a href="#wrglossary.11167">443</a>, <a href="#wrglossary.11271">448</a>, <a href="#wrglossary.11519">465</a>, <span class="termslocfmt"><a href="#wrglossary.14340">600</a></span>, <a href="#wrglossary.14590">607</a>, <a href="#wrglossary.14810">615</a>, <a href="#wrglossary.14964">624</a>, <a href="#wrglossary.14983">625</a>, <a href="#wrglossary.15478">646</a>, <a href="#wrglossary.15502">647</a>, <a href="#wrglossary.15603">649</a>, <a href="#wrglossary.15630">651</a>, <a href="#wrglossary.17979">728</a>, <a href="#wrglossary.18065">731</a>, <a href="#wrglossary.18165">735</a>, <a href="#wrglossary.18250">738</a>, <a href="#wrglossary.18411">745</a>, <a href="#wrglossary.18593">752</a>, <a href="#wrglossary.18868">762</a>, <a href="#wrglossary.18915">764</a>, <a href="#wrglossary.19072">770</a>, <a href="#wrglossary.19118">772</a>, <a href="#wrglossary.19448">782</a>, <a href="#wrglossary.19585">789</a>, <a href="#wrglossary.19618">790</a>, <a href="#wrglossary.20124">811</a>, <a href="#wrglossary.20590">830</a>, <a href="#wrglossary.21438">865</a>, <a href="#wrglossary.23174">928</a>, <a href="#wrglossary.23737">947</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:gui">GUI</dfn><span class="qquad"></span><span class="termslocfmt"><a href="#wrglossary.14343">600</a></span></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index6946816 -->
+
+<section id="index7012352"><!-- start of section index7012352 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->Glo<div class="labellink"><a href="#index7012352">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><a href="#glo:glolinkprefix"><code class="csfmt">\glolinkprefix</code></a><span class="qquad"></span><a href="#wrglossary.4985">196</a>, <a href="#wrglossary.6574">256</a>, <a href="#wrglossary.9578">379</a>, <a href="#wrglossary.10471">409</a>, <a href="#wrglossary.12285">502</a>, <a href="#wrglossary.15002">626</a>, <span class="summarylocfmt"><a href="#wrglossary.16450">674</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span> package</dfn><span class="qquad"></span><a href="#wrglossary.334">14</a>, <a href="#wrglossary.337">15</a>, <a href="#wrglossary.863">29</a>, <a href="#wrglossary.10587">416</a>, <a href="#wrglossary.10661">419</a>, <a href="#wrglossary.11677">475</a>–<a href="#wrglossary.11747">477</a>, <a href="#wrglossary.14240">590</a>, <a href="#wrglossary.14736">611</a>–<a href="#wrglossary.14764">613</a>, <a href="#wrglossary.16860">688</a>, <a href="#wrglossary.17061">695</a>, <a href="#wrglossary.17199">700</a>–<a href="#wrglossary.17257">702</a>, <a href="#wrglossary.17500">710</a>, <a href="#wrglossary.17612">713</a>, <a href="#wrglossary.17761">718</a>, <a href="#wrglossary.17832">720</a>, <a href="#wrglossary.18206">736</a>, <a href="#wrglossary.18500">749</a>, <a href="#wrglossary.18560">751</a>, <a href="#wrglossary.18679">754</a>, <a href="#wrglossary.18822">760</a>, <a href="#wrglossary.18830">761</a>, <a href="#wrglossary.18901">763</a>, <a href="#wrglossary.18974">765</a>, <a href="#wrglossary.19195">775</a>–<a href="#wrglossary.19335">778</a>, <a href="#wrglossary.23509">941</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:pkg.glossaries-extra-bib2gls"><span class="styfmt">glossaries-extra-bib2gls</span> package</a><span class="qquad"></span><a href="#sec:bib2glssty">§11.5</a>; <a href="#wrglossary.168">9</a>–<a href="#wrglossary.242">12</a>, <a href="#wrglossary.694">24</a>, <a href="#wrglossary.749">25</a>, <a href="#wrglossary.9360">372</a>, <a href="#wrglossary.12484">512</a>, <a href="#wrglossary.13041">533</a>–<a href="#wrglossary.14004">573</a>, <a href="#wrglossary.14268">592</a>, <a href="#wrglossary.16112">662</a>, <a href="#wrglossary.16165">663</a>, <a href="#wrglossary.16249">667</a>–<a href="#wrglossary.16402">672</a>, <a href="#wrglossary.17156">698</a>, <a href="#wrglossary.17290">703</a>, <a href="#wrglossary.17428">707</a>, <a href="#wrglossary.17998">728</a>, <a href="#wrglossary.18731">756</a>, <a href="#wrglossary.19436">781</a>, <a href="#wrglossary.19450">782</a>, <a href="#wrglossary.19517">785</a>, <a href="#wrglossary.19551">787</a>, <a href="#wrglossary.19656">792</a>, <a href="#wrglossary.19668">793</a>, <a href="#wrglossary.19741">796</a>–<a href="#wrglossary.19784">798</a>, <a href="#wrglossary.19834">800</a>, <a href="#wrglossary.19926">803</a>–<a href="#wrglossary.19971">805</a>, <a href="#wrglossary.20072">808</a>–<a href="#wrglossary.20118">811</a>, <a href="#wrglossary.20289">817</a>, <a href="#wrglossary.20359">820</a>, <a href="#wrglossary.20381">821</a>, <a href="#wrglossary.20460">824</a>, <a href="#wrglossary.20519">826</a>–<a href="#wrglossary.20592">830</a>, <a href="#wrglossary.20797">837</a>–<a href="#wrglossary.20952">846</a>, <a href="#wrglossary.21036">849</a>, <a href="#wrglossary.21238">857</a>–<a href="#wrglossary.21274">859</a>, <a href="#wrglossary.21399">863</a>, <a href="#wrglossary.21470">867</a>, <a href="#wrglossary.21659">873</a>, <a href="#wrglossary.21692">875</a>–<a href="#wrglossary.21737">877</a>, <a href="#wrglossary.21888">884</a>–<a href="#wrglossary.21934">887</a>, <a href="#wrglossary.22094">893</a>, <a href="#wrglossary.22188">897</a>, <a href="#wrglossary.22197">898</a>, <a href="#wrglossary.22712">915</a>, <a href="#wrglossary.22756">917</a>, <a href="#wrglossary.22833">919</a>, <a href="#wrglossary.23150">927</a>, <a href="#wrglossary.23211">929</a>, <a href="#wrglossary.23317">932</a>, <a href="#wrglossary.23365">934</a>–<a href="#wrglossary.23420">937</a>, <a href="#wrglossary.23475">939</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span> package</a><span class="qquad"></span><a href="#wrglossary.299">13</a>, <a href="#wrglossary.325">14</a>, <a href="#wrglossary.9665">383</a>, <a href="#wrglossary.9697">385</a>, <a href="#wrglossary.9984">393</a>, <a href="#wrglossary.10714">421</a>, <a href="#wrglossary.10854">427</a>, <a href="#wrglossary.10971">431</a>, <a href="#wrglossary.11507">463</a>, <a href="#wrglossary.13477">554</a>, <a href="#wrglossary.14224">589</a>, <a href="#wrglossary.14472">603</a>, <a href="#wrglossary.16390">671</a>–<a href="#wrglossary.16445">674</a>, <a href="#wrglossary.17120">697</a>, <a href="#wrglossary.17641">714</a>–<a href="#wrglossary.17670">716</a>, <a href="#wrglossary.17973">727</a>, <a href="#wrglossary.18064">731</a>, <a href="#wrglossary.18146">734</a>, <a href="#wrglossary.18164">735</a>, <a href="#wrglossary.18688">754</a>, <a href="#wrglossary.19043">769</a>–<a href="#wrglossary.19156">774</a>, <a href="#wrglossary.19466">783</a>, <a href="#wrglossary.21247">858</a>, <a href="#wrglossary.21856">882</a>, <a href="#wrglossary.21859">883</a>, <a href="#wrglossary.23439">937</a>, <a href="#wrglossary.23442">938</a>, <span class="summarylocfmt"><a href="#wrglossary.23488">941</a></span>, <a href="#wrglossary.23683">946</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.all"><span class="styoptfmt">all</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23494">941</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.name"><span class="meta">〈<em class="metainner">name</em>〉</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23495">941</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx0"><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span> package</a><span class="qquad"></span><a href="#sec:pkgopts">§2</a>; <a href="#wrglossary.11">2</a>, <a href="#wrglossary.141">8</a>, <span class="summarylocfmt"><a href="#wrglossary.23496">941</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.abbreviations"><span class="styoptfmt">abbreviations</span></a><span class="qquad"></span><a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.159">9</a>, <a href="#wrglossary.176">10</a>, <a href="#wrglossary.1359">44</a>, <a href="#wrglossary.1389">46</a>, <a href="#wrglossary.13062">534</a>, <a href="#wrglossary.14251">592</a>, <a href="#wrglossary.15939">658</a>, <a href="#wrglossary.19391">780</a>, <a href="#wrglossary.23096">926</a>, <a href="#wrglossary.23151">927</a>, <span class="summarylocfmt"><a href="#wrglossary.23499">941</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.accsupp"><span class="styoptfmt">accsupp</span></a><span class="qquad"></span><a href="#sec:otherpkgopts">§2.3</a>; <a href="#wrglossary.333">14</a>, <a href="#wrglossary.4221">168</a>, <a href="#wrglossary.4236">169</a>, <a href="#wrglossary.10588">416</a>, <a href="#wrglossary.11680">475</a>, <a href="#wrglossary.14531">605</a>–<a href="#wrglossary.14716">611</a>, <a href="#wrglossary.16591">679</a>–<a href="#wrglossary.16627">681</a>, <a href="#wrglossary.16870">689</a>–<a href="#wrglossary.17041">695</a>, <a href="#wrglossary.17200">700</a>, <a href="#wrglossary.19397">780</a>, <a href="#wrglossary.19406">781</a>, <a href="#wrglossary.19486">784</a>, <a href="#wrglossary.21259">858</a>, <span class="summarylocfmt"><a href="#wrglossary.23508">941</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.autoseeindex"><span class="styoptfmt">autoseeindex</span></a><span class="qquad"></span><a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.565">21</a>, <a href="#wrglossary.628">22</a>, <a href="#wrglossary.981">33</a>, <a href="#wrglossary.6890">263</a>, <a href="#wrglossary.7117">270</a>, <a href="#wrglossary.7238">276</a>, <a href="#wrglossary.7842">302</a>, <span class="summarylocfmt"><a href="#wrglossary.23510">941</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.autoseeindex.false"><span class="optfmt">false</span></a><span class="qquad"></span><a href="#wrglossary.619">22</a>–<a href="#wrglossary.689">24</a>, <a href="#wrglossary.958">33</a>, <a href="#wrglossary.14670">609</a>, <span class="summarylocfmt"><a href="#wrglossary.23514">941</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.autoseeindex.true"><span class="optfmt">true</span></a><span class="qquad"></span><a href="#wrglossary.597">22</a>, <span class="summarylocfmt"><a href="#wrglossary.23518">941</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.bibglsaux"><span class="styoptfmt">bibglsaux</span></a><span class="qquad"></span><a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.772">26</a>, <a href="#wrglossary.16170">663</a>, <a href="#wrglossary.21411">864</a>, <span class="summarylocfmt"><a href="#wrglossary.23522">942</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="qquad"></span><a href="#sec:debuggingopts">§2.5</a>; <a href="#wrglossary.839">28</a>, <span class="summarylocfmt"><a href="#wrglossary.23529">942</a></span>, <a href="#wrglossary.23718">947</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.debug.all"><span class="optfmt">all</span></a><span class="qquad"></span><a href="#wrglossary.864">29</a>, <span class="summarylocfmt"><a href="#wrglossary.23531">942</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.debug.false"><span class="optfmt">false</span></a><span class="qquad"></span><a href="#wrglossary.843">28</a>, <span class="summarylocfmt"><a href="#wrglossary.23533">942</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.debug.showaccsupp"><span class="optfmt">showaccsupp</span></a><span class="qquad"></span><a href="#wrglossary.860">28</a>, <span class="summarylocfmt"><a href="#wrglossary.23535">942</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.debug.showtargets"><span class="optfmt">showtargets</span></a><span class="qquad"></span><a href="#wrglossary.882">29</a>, <a href="#wrglossary.896">30</a>, <a href="#wrglossary.18838">761</a>, <a href="#wrglossary.18849">762</a>, <span class="summarylocfmt"><a href="#wrglossary.23538">942</a></span>, <a href="#wrglossary.23675">945</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:opt.showtargets"><span class="styoptfmt">showtargets</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.debug.showwrgloss"><span class="optfmt">showwrgloss</span></a><span class="qquad"></span><a href="#wrglossary.866">29</a>, <a href="#wrglossary.22102">893</a>, <span class="summarylocfmt"><a href="#wrglossary.23541">942</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.debug.true"><span class="optfmt">true</span></a><span class="qquad"></span><a href="#wrglossary.846">28</a>, <a href="#wrglossary.870">29</a>, <span class="summarylocfmt"><a href="#wrglossary.23547">942</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.docdef"><span class="styoptfmt">docdef</span></a><span class="qquad"></span><a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.365">16</a>, <a href="#wrglossary.8276">324</a>, <a href="#wrglossary.9324">370</a>, <a href="#wrglossary.9342">371</a>, <a href="#wrglossary.14094">578</a>, <span class="summarylocfmt"><a href="#wrglossary.23555">942</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.docdef.atom"><span class="optfmt">atom</span></a><span class="qquad"></span><a href="#wrglossary.418">17</a>, <span class="summarylocfmt"><a href="#wrglossary.23558">942</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.docdef.false"><span class="optfmt">false</span></a><span class="qquad"></span><a href="#wrglossary.386">16</a>, <span class="summarylocfmt"><a href="#wrglossary.23560">942</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.docdef.restricted"><span class="optfmt">restricted</span></a><span class="qquad"></span><a href="#wrglossary.401">17</a>, <span class="summarylocfmt"><a href="#wrglossary.23563">942</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.docdef.true"><span class="optfmt">true</span></a><span class="qquad"></span><a href="#wrglossary.390">16</a>, <a href="#wrglossary.1120">37</a>, <a href="#wrglossary.7945">308</a>, <a href="#wrglossary.9464">376</a>, <span class="summarylocfmt"><a href="#wrglossary.23567">942</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.equations"><span class="styoptfmt">equations</span></a><span class="qquad"></span><a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.788">26</a>, <a href="#wrglossary.13536">555</a>, <span class="summarylocfmt"><a href="#wrglossary.23571">943</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.floats"><span class="styoptfmt">floats</span></a><span class="qquad"></span><a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.795">27</a>, <span class="summarylocfmt"><a href="#wrglossary.23574">943</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.indexcounter"><span class="styoptfmt">indexcounter</span></a><span class="qquad"></span><a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.728">25</a>, <a href="#wrglossary.809">27</a>, <a href="#wrglossary.878">29</a>, <a href="#wrglossary.13605">558</a>, <a href="#wrglossary.13620">559</a>, <a href="#wrglossary.13961">573</a>, <a href="#wrglossary.14781">614</a>, <a href="#wrglossary.23545">942</a>, <span class="summarylocfmt"><a href="#wrglossary.23576">943</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.indexcrossrefs"><span class="styoptfmt">indexcrossrefs</span></a><span class="qquad"></span><a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.522">20</a>, <a href="#wrglossary.610">22</a>, <a href="#wrglossary.635">23</a>, <a href="#wrglossary.6962">265</a>, <a href="#wrglossary.6997">266</a>, <a href="#wrglossary.7319">279</a>, <span class="summarylocfmt"><a href="#wrglossary.23579">943</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.indexcrossrefs.false"><span class="optfmt">false</span></a><span class="qquad"></span><a href="#wrglossary.553">20</a>, <a href="#wrglossary.561">21</a>, <a href="#wrglossary.691">24</a>, <span class="summarylocfmt"><a href="#wrglossary.23581">943</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.indexcrossrefs.true"><span class="optfmt">true</span></a><span class="qquad"></span><a href="#wrglossary.538">20</a>, <a href="#wrglossary.559">21</a>, <span class="summarylocfmt"><a href="#wrglossary.23583">943</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.nomissingglstext"><span class="styoptfmt">nomissingglstext</span></a><span class="qquad"></span><a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.158">9</a>, <span class="summarylocfmt"><a href="#wrglossary.23585">943</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.postdot"><span class="styoptfmt">postdot</span></a><span class="qquad"></span><a href="#sec:glosstyleopts">§2.2</a>; <a href="#wrglossary.30">2</a>, <a href="#wrglossary.273">12</a>, <a href="#wrglossary.10722">421</a>, <a href="#wrglossary.10754">422</a>, <a href="#wrglossary.21040">849</a>, <span class="summarylocfmt"><a href="#wrglossary.23587">943</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a> &amp; <a href="#glo:opt.postpunc"><span class="styoptfmt">postpunc</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.postpunc"><span class="styoptfmt">postpunc</span></a><span class="qquad"></span><a href="#sec:glosstyleopts">§2.2</a>; <a href="#wrglossary.275">12</a>, <a href="#wrglossary.281">13</a>, <a href="#wrglossary.10723">421</a>, <a href="#wrglossary.10755">422</a>, <a href="#wrglossary.10872">427</a>, <a href="#wrglossary.18690">754</a>, <span class="summarylocfmt"><a href="#wrglossary.23590">943</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.postpunc.comma"><span class="optfmt">comma</span></a><span class="qquad"></span><a href="#wrglossary.290">13</a>, <span class="summarylocfmt"><a href="#wrglossary.23593">943</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.postpunc.dot"><span class="optfmt">dot</span></a><span class="qquad"></span><a href="#wrglossary.282">13</a>, <span class="summarylocfmt"><a href="#wrglossary.23594">943</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.postpunc.none"><span class="optfmt">none</span></a><span class="qquad"></span><a href="#wrglossary.293">13</a>, <span class="summarylocfmt"><a href="#wrglossary.23597">943</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.postpunc.other"><span class="meta">〈<em class="metainner">punctuation</em>〉</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23598">943</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.prefix"><span class="styoptfmt">prefix</span></a><span class="qquad"></span><a href="#sec:otherpkgopts">§2.3</a>; <a href="#wrglossary.331">14</a>, <a href="#wrglossary.1615">54</a>, <a href="#wrglossary.9224">367</a>, <span class="summarylocfmt"><a href="#wrglossary.23599">943</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.record"><span class="styoptfmt">record</span></a><span class="qquad"></span><a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.643">23</a>, <span class="summarylocfmt"><a href="#wrglossary.23601">944</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.record.alsoindex"><span class="optfmt">alsoindex</span></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:optval.record.hybrid"><span class="optfmt">hybrid</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.record.hybrid"><span class="optfmt">hybrid</span></a><span class="qquad"></span><a href="#wrglossary.652">23</a>, <a href="#wrglossary.737">25</a>, <a href="#wrglossary.872">29</a>, <a href="#wrglossary.1105">37</a>, <a href="#wrglossary.12436">510</a>, <a href="#wrglossary.12488">512</a>, <a href="#wrglossary.13051">533</a>, <span class="summarylocfmt"><a href="#wrglossary.23608">944</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.record.nameref"><span class="optfmt">nameref</span></a><span class="qquad"></span><a href="#wrglossary.650">23</a>, <a href="#wrglossary.714">24</a>, <a href="#wrglossary.1017">34</a>, <a href="#wrglossary.4979">196</a>, <a href="#wrglossary.7316">279</a>, <a href="#wrglossary.9364">372</a>, <a href="#wrglossary.9848">389</a>, <a href="#wrglossary.12429">510</a>, <a href="#wrglossary.12483">512</a>, <a href="#wrglossary.13040">533</a>, <a href="#wrglossary.13524">555</a>, <a href="#wrglossary.14409">601</a>, <a href="#wrglossary.14595">607</a>, <a href="#wrglossary.19369">779</a>, <a href="#wrglossary.19767">797</a>, <span class="summarylocfmt"><a href="#wrglossary.23628">944</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.record.off"><span class="optfmt">off</span></a><span class="qquad"></span><a href="#wrglossary.665">23</a>, <a href="#wrglossary.1103">37</a>, <a href="#wrglossary.9710">385</a>, <span class="summarylocfmt"><a href="#wrglossary.23634">944</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.record.only"><span class="optfmt">only</span></a><span class="qquad"></span><a href="#wrglossary.648">23</a>, <a href="#wrglossary.672">24</a>, <a href="#wrglossary.1015">34</a>, <a href="#wrglossary.1114">37</a>, <a href="#wrglossary.7314">279</a>, <a href="#wrglossary.9362">372</a>, <a href="#wrglossary.9846">389</a>, <a href="#wrglossary.12481">512</a>, <a href="#wrglossary.13043">533</a>, <a href="#wrglossary.14593">607</a>, <a href="#wrglossary.19365">779</a>, <span class="summarylocfmt"><a href="#wrglossary.23639">944</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></a><span class="qquad"></span><a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.441">17</a>–<a href="#wrglossary.475">19</a>, <a href="#wrglossary.7962">308</a>, <a href="#wrglossary.8304">326</a>, <span class="summarylocfmt"><a href="#wrglossary.23645">944</a></span>, <a href="#wrglossary.23655">945</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.shortcuts.abbr"><span class="optfmt">abbr</span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.shortcuts.abbreviations"><span class="optfmt">abbreviations</span></a><span class="qquad"></span><a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.454">18</a>, <a href="#wrglossary.479">19</a>, <a href="#wrglossary.1700">56</a>, <a href="#wrglossary.15667">653</a>, <a href="#wrglossary.15700">654</a>, <a href="#wrglossary.16033">660</a>–<a href="#wrglossary.16149">663</a>, <a href="#wrglossary.19724">795</a>, <a href="#wrglossary.22727">916</a>, <span class="summarylocfmt"><a href="#wrglossary.23648">944</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.shortcuts.abother"><span class="optfmt">abother</span></a><span class="qquad"></span><a href="#wrglossary.476">19</a>, <span class="summarylocfmt"><a href="#wrglossary.23649">944</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.shortcuts.ac"><span class="optfmt">ac</span></a><span class="qquad"></span><a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.445">18</a>, <a href="#wrglossary.474">19</a>, <a href="#wrglossary.1311">43</a>, <a href="#wrglossary.1704">56</a>, <a href="#wrglossary.15721">654</a>–<a href="#wrglossary.15874">657</a>, <a href="#wrglossary.15979">659</a>, <a href="#wrglossary.16006">660</a>, <a href="#wrglossary.19730">795</a>, <a href="#wrglossary.22729">916</a>, <span class="summarylocfmt"><a href="#wrglossary.23652">944</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.shortcuts.acother"><span class="optfmt">acother</span></a><span class="qquad"></span><a href="#wrglossary.471">19</a>, <a href="#wrglossary.19732">795</a>, <span class="summarylocfmt"><a href="#wrglossary.23654">944</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.shortcuts.acro"><span class="optfmt">acro</span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.shortcuts.acronyms"><span class="optfmt">acronyms</span></a><span class="qquad"></span><a href="#wrglossary.488">19</a>, <a href="#wrglossary.15731">654</a>–<a href="#wrglossary.15876">657</a>, <a href="#wrglossary.15989">659</a>, <a href="#wrglossary.16016">660</a>, <span class="summarylocfmt"><a href="#wrglossary.23658">945</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.shortcuts.all"><span class="optfmt">all</span></a><span class="qquad"></span><a href="#wrglossary.481">19</a>, <a href="#wrglossary.515">20</a>, <a href="#wrglossary.19726">795</a>, <span class="summarylocfmt"><a href="#wrglossary.23661">945</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.shortcuts.false"><span class="optfmt">false</span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:optval.shortcuts.all"><span class="optfmt">all</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.shortcuts.none"><span class="optfmt">none</span></a><span class="qquad"></span><a href="#wrglossary.521">20</a>, <span class="summarylocfmt"><a href="#wrglossary.23666">945</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.shortcuts.other"><span class="optfmt">other</span></a><span class="qquad"></span><a href="#wrglossary.461">18</a>, <a href="#wrglossary.19735">795</a>, <a href="#wrglossary.22766">917</a>, <a href="#wrglossary.22811">919</a>, <span class="summarylocfmt"><a href="#wrglossary.23667">945</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.shortcuts.true"><span class="optfmt">true</span></a><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:optval.shortcuts.all"><span class="optfmt">all</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.showtargets"><span class="styoptfmt">showtargets</span></a><span class="qquad"></span><a href="#sec:debuggingopts">§2.5</a>; <a href="#wrglossary.894">29</a>, <a href="#wrglossary.9608">380</a>, <a href="#wrglossary.21639">872</a>, <a href="#wrglossary.21643">873</a>, <span class="summarylocfmt"><a href="#wrglossary.23672">945</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.showtargets.annoteleft"><span class="optfmt">annoteleft</span></a><span class="qquad"></span><a href="#wrglossary.918">31</a>, <a href="#wrglossary.8565">338</a>, <span class="summarylocfmt"><a href="#wrglossary.23676">945</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.showtargets.annoteright"><span class="optfmt">annoteright</span></a><span class="qquad"></span><a href="#wrglossary.920">31</a>, <span class="summarylocfmt"><a href="#wrglossary.23677">945</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.showtargets.innerleft"><span class="optfmt">innerleft</span></a><span class="qquad"></span><a href="#wrglossary.914">31</a>, <span class="summarylocfmt"><a href="#wrglossary.23678">945</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.showtargets.innerright"><span class="optfmt">innerright</span></a><span class="qquad"></span><a href="#wrglossary.916">31</a>, <span class="summarylocfmt"><a href="#wrglossary.23679">945</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.showtargets.left"><span class="optfmt">left</span></a><span class="qquad"></span><a href="#wrglossary.910">30</a>, <span class="summarylocfmt"><a href="#wrglossary.23680">945</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.showtargets.right"><span class="optfmt">right</span></a><span class="qquad"></span><a href="#wrglossary.912">30</a>, <span class="summarylocfmt"><a href="#wrglossary.23681">945</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.stylemods"><span class="styoptfmt">stylemods</span></a><span class="qquad"></span><a href="#sec:glosstyleopts">§2.2</a>; <a href="#wrglossary.270">12</a>–<a href="#wrglossary.329">14</a>, <a href="#wrglossary.9691">384</a>, <a href="#wrglossary.9705">385</a>, <a href="#wrglossary.9758">387</a>, <a href="#wrglossary.9834">389</a>, <a href="#wrglossary.10856">427</a>, <a href="#wrglossary.11060">437</a>, <a href="#wrglossary.23489">941</a>, <span class="summarylocfmt"><a href="#wrglossary.23682">945</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.stylemods.all"><span class="optfmt">all</span></a><span class="qquad"></span><a href="#wrglossary.302">13</a>, <span class="summarylocfmt"><a href="#wrglossary.23687">946</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.stylemods.default"><span class="optfmt">default</span></a><span class="qquad"></span><a href="#wrglossary.306">13</a>, <a href="#wrglossary.314">14</a>, <span class="summarylocfmt"><a href="#wrglossary.23689">946</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.stylemods.list"><span class="meta">〈<em class="metainner">list</em>〉</span></a><span class="qquad"></span><a href="#wrglossary.317">14</a>, <span class="summarylocfmt"><a href="#wrglossary.23691">946</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.undefaction"><span class="styoptfmt">undefaction</span></a><span class="qquad"></span><a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.344">15</a>, <a href="#wrglossary.363">16</a>, <a href="#wrglossary.7365">281</a>, <a href="#wrglossary.7438">283</a>, <a href="#wrglossary.17311">703</a>, <a href="#wrglossary.20416">822</a>, <a href="#wrglossary.21863">883</a>, <a href="#wrglossary.22181">897</a>, <span class="summarylocfmt"><a href="#wrglossary.23693">946</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.undefaction.error"><span class="optfmt">error</span></a><span class="qquad"></span><a href="#wrglossary.349">15</a>, <a href="#wrglossary.671">24</a>, <a href="#wrglossary.17296">703</a>, <a href="#wrglossary.17315">704</a>, <a href="#wrglossary.20308">818</a>, <a href="#wrglossary.20376">820</a>, <span class="summarylocfmt"><a href="#wrglossary.23694">946</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.undefaction.warn"><span class="optfmt">warn</span></a><span class="qquad"></span><a href="#wrglossary.352">15</a>, <a href="#wrglossary.415">17</a>, <a href="#wrglossary.687">24</a>, <a href="#wrglossary.1195">39</a>, <a href="#wrglossary.7259">277</a>, <a href="#wrglossary.12472">511</a>, <a href="#wrglossary.17298">703</a>, <a href="#wrglossary.17317">704</a>, <a href="#wrglossary.17623">714</a>, <a href="#wrglossary.20310">818</a>, <a href="#wrglossary.20378">820</a>, <a href="#wrglossary.21432">865</a>, <span class="summarylocfmt"><a href="#wrglossary.23695">946</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span> package</dfn><span class="qquad"></span><a href="#wrglossary.332">14</a>, <a href="#wrglossary.1614">54</a>, <a href="#wrglossary.1620">55</a>, <a href="#wrglossary.5294">207</a>–<a href="#wrglossary.5386">210</a>, <a href="#wrglossary.5608">218</a>, <a href="#wrglossary.9222">367</a>, <a href="#wrglossary.14242">590</a>, <a href="#wrglossary.14654">608</a>, <a href="#wrglossary.14657">609</a>, <a href="#wrglossary.18708">755</a>, <a href="#wrglossary.22709">915</a>, <a href="#wrglossary.22849">920</a>–<a href="#wrglossary.23073">925</a>, <a href="#wrglossary.23600">944</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span> package</a><span class="qquad"></span><a href="#wrglossary.10">2</a>, <a href="#wrglossary.1222">41</a>, <span class="summarylocfmt"><a href="#wrglossary.23696">946</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a><span class="qquad"></span><a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.179">10</a>, <a href="#wrglossary.234">11</a>, <a href="#wrglossary.13066">534</a>, <a href="#wrglossary.15937">658</a>, <a href="#wrglossary.23505">941</a>, <span class="summarylocfmt"><a href="#wrglossary.23699">946</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.acronymlists"><span class="styoptfmt">acronymlists</span></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><span class="qquad"></span><a href="#wrglossary.187">10</a>, <span class="summarylocfmt"><a href="#wrglossary.23704">946</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.acronyms"><span class="styoptfmt">acronyms</span></a><span class="qquad"></span><a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.225">11</a>, <a href="#wrglossary.1364">44</a>, <a href="#wrglossary.1390">46</a>, <a href="#wrglossary.13065">534</a>, <a href="#wrglossary.15938">658</a>, <a href="#wrglossary.23102">926</a>, <a href="#wrglossary.23158">927</a>, <a href="#wrglossary.23506">941</a>, <span class="summarylocfmt"><a href="#wrglossary.23707">946</a></span>, <a href="#wrglossary.23754">947</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="qquad"></span><a href="#wrglossary.14296">596</a>, <a href="#wrglossary.21017">848</a>, <span class="summarylocfmt"><a href="#wrglossary.23711">946</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.counter"><span class="styoptfmt">counter</span></a><span class="qquad"></span><a href="#wrglossary.813">27</a>, <a href="#wrglossary.6780">261</a>, <a href="#wrglossary.12905">529</a>, <a href="#wrglossary.13528">555</a>, <a href="#wrglossary.14547">605</a>, <a href="#wrglossary.23578">943</a>, <span class="summarylocfmt"><a href="#wrglossary.23713">947</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.base.debug"><span class="styoptfmt">debug</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23715">947</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="qquad"></span><a href="#wrglossary.9491">377</a>, <a href="#wrglossary.10556">414</a>, <a href="#wrglossary.10592">416</a>, <a href="#wrglossary.11225">446</a>, <a href="#wrglossary.11394">456</a>, <a href="#wrglossary.17390">706</a>, <a href="#wrglossary.18727">756</a>, <span class="summarylocfmt"><a href="#wrglossary.23719">947</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a><span class="qquad"></span><a href="#wrglossary.4707">186</a>, <a href="#wrglossary.6566">256</a>, <a href="#wrglossary.12178">498</a>, <span class="summarylocfmt"><a href="#wrglossary.23720">947</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.index"><span class="styoptfmt">index</span></a><span class="qquad"></span><a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.240">11</a>, <a href="#wrglossary.245">12</a>, <a href="#wrglossary.10748">422</a>, <a href="#wrglossary.13076">535</a>, <a href="#wrglossary.21110">852</a>, <a href="#wrglossary.22820">919</a>, <a href="#wrglossary.23121">926</a>, <a href="#wrglossary.23212">929</a>, <span class="summarylocfmt"><a href="#wrglossary.23722">947</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.indexonlyfirst"><span class="styoptfmt">indexonlyfirst</span></a><span class="qquad"></span><a href="#wrglossary.6927">264</a>, <a href="#wrglossary.6934">265</a>, <a href="#wrglossary.12192">499</a>, <a href="#wrglossary.14073">576</a>, <a href="#wrglossary.22166">896</a>, <span class="summarylocfmt"><a href="#wrglossary.23727">947</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.makeindex"><span class="styoptfmt">makeindex</span></a><span class="qquad"></span><a href="#wrglossary.13572">556</a>, <span class="summarylocfmt"><a href="#wrglossary.23730">947</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mfirstuc"><span class="styoptfmt">mfirstuc</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23733">947</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.nogroupskip"><span class="styoptfmt">nogroupskip</span></a><span class="qquad"></span><a href="#wrglossary.10902">428</a>, <a href="#wrglossary.10938">430</a>, <a href="#wrglossary.11496">461</a>, <a href="#wrglossary.17990">728</a>, <a href="#wrglossary.22173">896</a>, <span class="summarylocfmt"><a href="#wrglossary.23736">947</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.nolist"><span class="styoptfmt">nolist</span></a><span class="qquad"></span><a href="#wrglossary.311">14</a>, <span class="summarylocfmt"><a href="#wrglossary.23739">947</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.nolong"><span class="styoptfmt">nolong</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23745">947</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.nomain"><span class="styoptfmt">nomain</span></a><span class="qquad"></span><a href="#wrglossary.128">6</a>, <a href="#wrglossary.17208">701</a>, <span class="summarylocfmt"><a href="#wrglossary.23751">947</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></a><span class="qquad"></span><a href="#wrglossary.6761">261</a>, <a href="#wrglossary.10152">398</a>, <a href="#wrglossary.10773">423</a>, <a href="#wrglossary.11492">461</a>, <a href="#wrglossary.12911">529</a>, <a href="#wrglossary.14455">602</a>, <a href="#wrglossary.16466">675</a>, <a href="#wrglossary.18572">751</a>, <span class="summarylocfmt"><a href="#wrglossary.23755">947</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="qquad"></span><a href="#sec:glosstyleopts">§2.2</a>; <a href="#wrglossary.26">2</a>–<a href="#wrglossary.65">4</a>, <a href="#wrglossary.259">12</a>, <a href="#wrglossary.277">13</a>, <a href="#wrglossary.10897">428</a>, <a href="#wrglossary.18689">754</a>, <a href="#wrglossary.23589">943</a>, <span class="summarylocfmt"><a href="#wrglossary.23760">948</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:opt.postdot"><span class="styoptfmt">postdot</span></a> &amp; <a href="#glo:opt.postpunc"><span class="styoptfmt">postpunc</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.noredefwarn"><span class="styoptfmt">noredefwarn</span></a><span class="qquad"></span><a href="#wrglossary.35">3</a>, <span class="summarylocfmt"><a href="#wrglossary.23767">948</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a><span class="qquad"></span><a href="#wrglossary.312">14</a>, <a href="#wrglossary.10867">427</a>, <a href="#wrglossary.11004">433</a>, <a href="#wrglossary.11063">437</a>, <span class="summarylocfmt"><a href="#wrglossary.23773">948</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.nosuper"><span class="styoptfmt">nosuper</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23778">948</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.notranslate"><span class="styoptfmt">notranslate</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23784">948</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.notree"><span class="styoptfmt">notree</span></a><span class="qquad"></span><a href="#wrglossary.11003">433</a>, <span class="summarylocfmt"><a href="#wrglossary.23786">948</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.nowarn"><span class="styoptfmt">nowarn</span></a><span class="qquad"></span><a href="#wrglossary.16458">674</a>, <a href="#wrglossary.16461">675</a>, <span class="summarylocfmt"><a href="#wrglossary.23792">948</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a><span class="qquad"></span><a href="#wrglossary.9542">378</a>, <a href="#wrglossary.14993">625</a>, <a href="#wrglossary.16487">675</a>, <a href="#wrglossary.17133">698</a>, <span class="summarylocfmt"><a href="#wrglossary.23793">948</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.numbers"><span class="styoptfmt">numbers</span></a><span class="qquad"></span><a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.207">11</a>, <a href="#wrglossary.470">19</a>, <a href="#wrglossary.944">32</a>, <a href="#wrglossary.10747">422</a>, <a href="#wrglossary.13073">534</a>, <a href="#wrglossary.18594">752</a>, <a href="#wrglossary.20981">847</a>, <a href="#wrglossary.21113">852</a>, <a href="#wrglossary.22812">919</a>, <a href="#wrglossary.23141">927</a>, <a href="#wrglossary.23228">929</a>, <span class="summarylocfmt"><a href="#wrglossary.23795">948</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23801">948</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.savenumberlist"><span class="styoptfmt">savenumberlist</span></a><span class="qquad"></span><a href="#wrglossary.12582">514</a>, <span class="summarylocfmt"><a href="#wrglossary.23804">948</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.section"><span class="styoptfmt">section</span></a><span class="qquad"></span><a href="#wrglossary.11159">442</a>, <a href="#wrglossary.16486">675</a>, <span class="summarylocfmt"><a href="#wrglossary.23809">949</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.seenoindex"><span class="styoptfmt">seenoindex</span></a><span class="qquad"></span><a href="#wrglossary.642">23</a>, <span class="summarylocfmt"><a href="#wrglossary.23811">949</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.seenoindex.error"><span class="optfmt">error</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23815">949</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.seenoindex.ignore"><span class="optfmt">ignore</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23818">949</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.seenoindex.warn"><span class="optfmt">warn</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23821">949</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="qquad"></span><a href="#wrglossary.9823">389</a>, <a href="#wrglossary.10533">412</a>, <span class="summarylocfmt"><a href="#wrglossary.23824">949</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.sort.clear"><span class="optfmt">clear</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23828">949</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23832">949</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.sort.none"><span class="optfmt">none</span></a><span class="qquad"></span><a href="#wrglossary.693">24</a>, <span class="summarylocfmt"><a href="#wrglossary.23834">949</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.sort.standard"><span class="optfmt">standard</span></a><span class="qquad"></span><a href="#wrglossary.18712">755</a>, <a href="#wrglossary.23803">948</a>, <span class="summarylocfmt"><a href="#wrglossary.23838">949</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23842">949</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23844">949</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a><span class="qquad"></span><a href="#wrglossary.9492">377</a>, <a href="#wrglossary.10557">414</a>, <a href="#wrglossary.10593">416</a>, <a href="#wrglossary.11230">446</a>, <a href="#wrglossary.11654">472</a>, <a href="#wrglossary.18728">756</a>, <a href="#wrglossary.18865">762</a>, <span class="summarylocfmt"><a href="#wrglossary.23846">949</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a><span class="qquad"></span><a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.189">10</a>, <a href="#wrglossary.467">18</a>, <a href="#wrglossary.942">32</a>, <a href="#wrglossary.10746">422</a>, <a href="#wrglossary.13070">534</a>, <a href="#wrglossary.13686">561</a>, <a href="#wrglossary.18916">764</a>, <a href="#wrglossary.21007">847</a>, <a href="#wrglossary.21119">853</a>, <a href="#wrglossary.22817">919</a>, <a href="#wrglossary.23146">927</a>, <a href="#wrglossary.23236">929</a>, <span class="summarylocfmt"><a href="#wrglossary.23847">950</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="qquad"></span><a href="#wrglossary.24">2</a>–<a href="#wrglossary.64">4</a>, <span class="summarylocfmt"><a href="#wrglossary.23853">950</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="qquad"></span><a href="#wrglossary.42">3</a>, <a href="#wrglossary.66">4</a>, <a href="#wrglossary.23785">948</a>, <span class="summarylocfmt"><a href="#wrglossary.23859">950</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.translate.babel"><span class="optfmt">babel</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23860">950</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.translate.false"><span class="optfmt">false</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23864">950</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.translate.true"><span class="optfmt">true</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23865">950</a></span></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.writeglslabelnames"><span class="styoptfmt">writeglslabelnames</span></a><span class="qquad"></span><a href="#wrglossary.429">17</a>, <span class="summarylocfmt"><a href="#wrglossary.23868">950</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.writeglslabels"><span class="styoptfmt">writeglslabels</span></a><span class="qquad"></span><a href="#wrglossary.428">17</a>, <span class="summarylocfmt"><a href="#wrglossary.23870">950</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="qquad"></span><a href="#wrglossary.6739">261</a>, <a href="#wrglossary.6853">263</a>, <a href="#wrglossary.10829">426</a>, <a href="#wrglossary.14009">574</a>, <span class="summarylocfmt"><a href="#wrglossary.23872">950</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlossariesAbbrStyleTooComplexWarning"><code class="csfmt">\GlossariesAbbrStyleTooComplexWarning</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.16452">674</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glossariesextrasetup"><code class="csfmt">\glossariesextrasetup</code></a><span class="qquad"></span><a href="#sec:pkgopts">§2</a>; <a href="#wrglossary.154">8</a>, <a href="#wrglossary.335">14</a>, <a href="#wrglossary.444">18</a>, <a href="#wrglossary.13060">534</a>, <span class="summarylocfmt"><a href="#wrglossary.16455">674</a></span>, <a href="#wrglossary.23351">934</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlossariesExtraWarning"><code class="csfmt">\GlossariesExtraWarning</code></a><span class="qquad"></span><a href="#wrglossary.3985">160</a>, <span class="summarylocfmt"><a href="#wrglossary.16457">674</a></span>, <a href="#wrglossary.20886">842</a>, <a href="#wrglossary.21015">848</a>, <a href="#wrglossary.21685">875</a>, <a href="#wrglossary.21870">883</a>, <a href="#wrglossary.22077">892</a>, <a href="#wrglossary.22708">915</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlossariesExtraWarningNoLine"><code class="csfmt">\GlossariesExtraWarningNoLine</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.16459">675</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span> package</a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.326">14</a>, <a href="#wrglossary.9759">387</a>, <a href="#wrglossary.11065">437</a>–<a href="#wrglossary.11191">444</a>, <a href="#wrglossary.15480">646</a>, <a href="#wrglossary.19561">788</a>–<a href="#wrglossary.19630">791</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.glossary-hypernav"><span class="styfmt">glossary-hypernav</span> package</dfn></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.glossary-inline"><span class="styfmt">glossary-inline</span> package</dfn><span class="qquad"></span><a href="#wrglossary.10888">428</a>, <a href="#wrglossary.15489">646</a>, <a href="#wrglossary.18073">732</a>, <a href="#wrglossary.18692">754</a>, <a href="#wrglossary.18695">755</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.glossary-list"><span class="styfmt">glossary-list</span> package</dfn><span class="qquad"></span><a href="#wrglossary.15469">645</a>–<a href="#wrglossary.15504">647</a>, <a href="#wrglossary.18157">734</a>, <a href="#wrglossary.18175">735</a>, <a href="#wrglossary.23740">947</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.glossary-long"><span class="styfmt">glossary-long</span> package</dfn><span class="qquad"></span><a href="#wrglossary.15589">649</a>, <a href="#wrglossary.17263">702</a>, <a href="#wrglossary.18597">752</a>, <a href="#wrglossary.23746">947</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.glossary-longbooktabs"><span class="styfmt">glossary-longbooktabs</span> package</dfn><span class="qquad"></span><a href="#wrglossary.11195">444</a>, <a href="#wrglossary.11562">468</a>, <a href="#wrglossary.15508">647</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:pkg.glossary-longextra"><span class="styfmt">glossary-longextra</span> package</a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.327">14</a>, <a href="#wrglossary.11192">444</a>–<a href="#wrglossary.11481">461</a>, <a href="#wrglossary.13471">553</a>, <a href="#wrglossary.15459">645</a>, <a href="#wrglossary.15513">647</a>–<a href="#wrglossary.15574">649</a>, <a href="#wrglossary.18213">737</a>–<a href="#wrglossary.18473">748</a>, <a href="#wrglossary.22168">896</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.glossary-longragged"><span class="styfmt">glossary-longragged</span> package</dfn><span class="qquad"></span><a href="#wrglossary.15593">649</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.glossary-mcols"><span class="styfmt">glossary-mcols</span> package</dfn><span class="qquad"></span><a href="#wrglossary.15597">649</a>, <a href="#wrglossary.15605">650</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.glossary-super"><span class="styfmt">glossary-super</span> package</dfn><span class="qquad"></span><a href="#wrglossary.15609">650</a>, <a href="#wrglossary.17264">702</a>, <a href="#wrglossary.18598">752</a>, <a href="#wrglossary.23779">948</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.glossary-superragged"><span class="styfmt">glossary-superragged</span> package</dfn><span class="qquad"></span><a href="#wrglossary.15613">650</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:pkg.glossary-table"><span class="styfmt">glossary-table</span> package</a><span class="qquad"></span><a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11560">468</a>–<a href="#wrglossary.11675">474</a>, <a href="#wrglossary.15617">650</a>, <a href="#wrglossary.18919">764</a>, <a href="#wrglossary.23241">930</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:pkg.glossary-topic"><span class="styfmt">glossary-topic</span> package</a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11482">461</a>–<a href="#wrglossary.11559">468</a>, <a href="#wrglossary.15620">650</a>, <a href="#wrglossary.18986">766</a>–<a href="#wrglossary.19036">769</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span> package</dfn><span class="qquad"></span><a href="#wrglossary.10966">431</a>, <a href="#wrglossary.11002">433</a>, <a href="#wrglossary.11023">435</a>, <a href="#wrglossary.11165">443</a>, <a href="#wrglossary.11486">461</a>, <a href="#wrglossary.11506">463</a>, <a href="#wrglossary.15472">645</a>, <a href="#wrglossary.15483">646</a>, <a href="#wrglossary.15626">650</a>, <a href="#wrglossary.15632">651</a>, <a href="#wrglossary.17662">715</a>, <a href="#wrglossary.18819">760</a>, <a href="#wrglossary.19050">769</a>–<a href="#wrglossary.19138">773</a>, <a href="#wrglossary.23787">948</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:glossary">glossary</dfn><span class="qquad"></span><span class="termslocfmt"><a href="#wrglossary.14344">600</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.glosfield">glossary entry fields</dfn><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.14773">614</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glosfield.childcount"><span class="csoptfmt">childcount</span></a><span class="qquad"></span><a href="#wrglossary.13500">554</a>, <span class="summarylocfmt"><a href="#wrglossary.14775">614</a></span>, <a href="#wrglossary.20360">820</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glosfield.childlist"><span class="csoptfmt">childlist</span></a><span class="qquad"></span><a href="#wrglossary.11650">472</a>, <span class="summarylocfmt"><a href="#wrglossary.14777">614</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glosfield.indexcounter"><span class="csoptfmt">indexcounter</span></a><span class="qquad"></span><a href="#wrglossary.13963">573</a>, <span class="summarylocfmt"><a href="#wrglossary.14780">614</a></span>, <a href="#wrglossary.20469">824</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glosfield.loclist"><span class="csoptfmt">loclist</span></a><span class="qquad"></span><a href="#wrglossary.1032">35</a>, <a href="#wrglossary.10132">397</a>, <a href="#wrglossary.10138">398</a>, <a href="#wrglossary.12534">513</a>, <a href="#wrglossary.13569">556</a>, <span class="summarylocfmt"><a href="#wrglossary.14786">614</a></span>, <a href="#wrglossary.23180">928</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glosfield.recordcount"><span class="csoptfmt">recordcount</span></a><span class="qquad"></span><a href="#wrglossary.12721">522</a>, <a href="#wrglossary.12745">523</a>, <span class="summarylocfmt"><a href="#wrglossary.14794">614</a></span>, <a href="#wrglossary.21854">882</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glosfield.recordcount.counter"><span class="csoptfmt">recordcount.<span class="meta">〈<em class="metainner">counter</em>〉</span></span></a><span class="qquad"></span><a href="#wrglossary.12723">522</a>, <a href="#wrglossary.12747">523</a>, <span class="summarylocfmt"><a href="#wrglossary.14797">615</a></span>, <a href="#wrglossary.21280">859</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glosfield.recordcount.counter.location"><span class="csoptfmt">recordcount.<span class="meta">〈<em class="metainner">counter</em>〉</span>.<span class="meta">〈<em class="metainner">location</em>〉</span></span></a><span class="qquad"></span><a href="#wrglossary.12726">522</a>, <a href="#wrglossary.12750">523</a>, <span class="summarylocfmt"><a href="#wrglossary.14801">615</a></span>, <a href="#wrglossary.20606">831</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glosfield.record.counter"><span class="csoptfmt">record.<span class="meta">〈<em class="metainner">counter</em>〉</span></span></a><span class="qquad"></span><a href="#wrglossary.10400">407</a>, <a href="#wrglossary.10442">408</a>, <span class="summarylocfmt"><a href="#wrglossary.14805">615</a></span>, <a href="#wrglossary.19357">779</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glosfield.secondarygroup"><span class="csoptfmt">secondarygroup</span></a><span class="qquad"></span><a href="#wrglossary.9873">390</a>, <a href="#wrglossary.9947">391</a>, <a href="#wrglossary.10044">395</a>, <a href="#wrglossary.10119">396</a>, <span class="summarylocfmt"><a href="#wrglossary.14808">615</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.gloskey">glossary entry keys</dfn><span class="qquad"></span><a href="#wrglossary.946">33</a>, <span class="summarylocfmt"><a href="#wrglossary.14527">605</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.access"><span class="csoptfmt">access</span></a><span class="qquad"></span><a href="#wrglossary.4011">162</a>, <a href="#wrglossary.11691">475</a>, <a href="#wrglossary.11731">476</a>, <span class="summarylocfmt"><a href="#wrglossary.14530">605</a></span>, <a href="#wrglossary.16896">690</a>, <a href="#wrglossary.18561">751</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.alias"><span class="csoptfmt">alias</span></a><span class="qquad"></span><a href="#sec:newkeys">§3.2</a>; <a href="#wrglossary.525">20</a>, <a href="#wrglossary.968">33</a>, <a href="#wrglossary.1090">36</a>, <a href="#wrglossary.1117">37</a>, <a href="#wrglossary.6880">263</a>, <a href="#wrglossary.6954">265</a>, <a href="#wrglossary.7017">267</a>, <a href="#wrglossary.7116">270</a>, <a href="#wrglossary.7169">272</a>, <a href="#wrglossary.7221">274</a>, <a href="#wrglossary.7243">276</a>, <a href="#wrglossary.7252">277</a>, <a href="#wrglossary.7322">279</a>, <a href="#wrglossary.7578">291</a>, <a href="#wrglossary.8296">325</a>, <a href="#wrglossary.9317">370</a>, <a href="#wrglossary.14152">581</a>, <a href="#wrglossary.14222">588</a>, <span class="summarylocfmt"><a href="#wrglossary.14535">605</a></span>, <a href="#wrglossary.19460">782</a>, <a href="#wrglossary.19464">783</a>, <a href="#wrglossary.21385">863</a>, <a href="#wrglossary.21941">887</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.category"><span class="csoptfmt">category</span></a><span class="qquad"></span><a href="#sec:newkeys">§3.2</a>; <a href="#wrglossary.248">12</a>, <a href="#wrglossary.949">33</a>, <a href="#wrglossary.1231">41</a>, <a href="#wrglossary.1279">42</a>, <a href="#wrglossary.1740">59</a>, <a href="#wrglossary.1757">60</a>, <a href="#wrglossary.4010">162</a>, <a href="#wrglossary.6942">265</a>, <a href="#wrglossary.10116">396</a>, <a href="#wrglossary.10275">402</a>, <a href="#wrglossary.12040">492</a>, <a href="#wrglossary.12054">493</a>, <a href="#wrglossary.12891">528</a>, <span class="summarylocfmt"><a href="#wrglossary.14540">605</a></span>, <a href="#wrglossary.15029">628</a>, <a href="#wrglossary.17961">726</a>, <a href="#wrglossary.18021">729</a>, <a href="#wrglossary.20984">847</a>, <a href="#wrglossary.21413">864</a>, <a href="#wrglossary.22733">916</a>, <a href="#wrglossary.22745">917</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.counter"><span class="csoptfmt">counter</span></a><span class="qquad"></span><a href="#wrglossary.6782">261</a>, <a href="#wrglossary.6799">262</a>, <span class="summarylocfmt"><a href="#wrglossary.14543">605</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="qquad"></span><a href="#wrglossary.250">12</a>, <a href="#wrglossary.1352">44</a>, <a href="#wrglossary.1807">63</a>, <a href="#wrglossary.1849">64</a>, <a href="#wrglossary.6391">251</a>, <a href="#wrglossary.6621">258</a>, <a href="#wrglossary.10758">422</a>, <a href="#wrglossary.11232">446</a>, <a href="#wrglossary.11285">448</a>, <a href="#wrglossary.11805">480</a>, <a href="#wrglossary.11955">487</a>, <a href="#wrglossary.12607">516</a>, <a href="#wrglossary.14325">599</a>, <span class="summarylocfmt"><a href="#wrglossary.14548">605</a></span>, <a href="#wrglossary.14558">606</a>, <a href="#wrglossary.15100">631</a>, <a href="#wrglossary.15170">634</a>, <a href="#wrglossary.15288">638</a>–<a href="#wrglossary.15363">641</a>, <a href="#wrglossary.16592">679</a>, <a href="#wrglossary.17244">702</a>, <a href="#wrglossary.17335">704</a>, <a href="#wrglossary.17341">705</a>, <a href="#wrglossary.21039">849</a>, <a href="#wrglossary.21210">856</a>, <a href="#wrglossary.21316">860</a>, <a href="#wrglossary.22143">895</a>, <a href="#wrglossary.22824">919</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.descriptionaccess"><span class="csoptfmt">descriptionaccess</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.14556">606</a></span>, <a href="#wrglossary.16593">679</a>, <a href="#wrglossary.17258">702</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.descriptionplural"><span class="csoptfmt">descriptionplural</span></a><span class="qquad"></span><a href="#wrglossary.11813">480</a>, <a href="#wrglossary.11962">487</a>, <span class="summarylocfmt"><a href="#wrglossary.14559">606</a></span>, <a href="#wrglossary.16604">680</a>, <a href="#wrglossary.17255">702</a>, <a href="#wrglossary.17347">705</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.descriptionpluralaccess"><span class="csoptfmt">descriptionpluralaccess</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.14561">606</a></span>, <a href="#wrglossary.16605">680</a>, <a href="#wrglossary.17261">702</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a><span class="qquad"></span><a href="#wrglossary.1065">36</a>, <a href="#wrglossary.1779">61</a>, <a href="#wrglossary.4058">163</a>, <a href="#wrglossary.4158">167</a>–<a href="#wrglossary.4274">170</a>, <a href="#wrglossary.5227">204</a>, <a href="#wrglossary.5770">225</a>, <a href="#wrglossary.5785">226</a>, <a href="#wrglossary.5849">228</a>, <a href="#wrglossary.6542">255</a>, <a href="#wrglossary.8761">346</a>, <a href="#wrglossary.11773">478</a>, <a href="#wrglossary.11927">486</a>, <a href="#wrglossary.14044">575</a>, <span class="summarylocfmt"><a href="#wrglossary.14564">606</a></span>, <a href="#wrglossary.15213">635</a>, <a href="#wrglossary.15299">639</a>, <a href="#wrglossary.15341">640</a>, <a href="#wrglossary.16616">680</a>, <a href="#wrglossary.17353">705</a>, <a href="#wrglossary.17720">717</a>, <a href="#wrglossary.17861">721</a>, <a href="#wrglossary.17864">722</a>, <a href="#wrglossary.19402">781</a>, <a href="#wrglossary.20139">811</a>, <a href="#wrglossary.20143">812</a>, <a href="#wrglossary.21745">877</a>, <a href="#wrglossary.21749">878</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.firstaccess"><span class="csoptfmt">firstaccess</span></a><span class="qquad"></span><a href="#wrglossary.4014">162</a>, <a href="#wrglossary.11741">477</a>, <span class="summarylocfmt"><a href="#wrglossary.14570">606</a></span>, <a href="#wrglossary.16617">680</a>, <a href="#wrglossary.17762">719</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a><span class="qquad"></span><a href="#wrglossary.1059">36</a>, <a href="#wrglossary.4059">163</a>, <a href="#wrglossary.4159">167</a>–<a href="#wrglossary.4238">169</a>, <a href="#wrglossary.5228">204</a>, <a href="#wrglossary.5792">226</a>, <a href="#wrglossary.6543">255</a>, <a href="#wrglossary.11781">479</a>, <a href="#wrglossary.11934">486</a>, <span class="summarylocfmt"><a href="#wrglossary.14575">606</a></span>, <a href="#wrglossary.14585">607</a>, <a href="#wrglossary.15214">635</a>, <a href="#wrglossary.15300">639</a>, <a href="#wrglossary.15342">640</a>, <a href="#wrglossary.16628">681</a>, <a href="#wrglossary.17365">705</a>, <a href="#wrglossary.17371">706</a>, <a href="#wrglossary.17821">720</a>, <a href="#wrglossary.17870">722</a>, <a href="#wrglossary.19403">781</a>, <a href="#wrglossary.20155">812</a>, <a href="#wrglossary.21757">878</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.firstpluralaccess"><span class="csoptfmt">firstpluralaccess</span></a><span class="qquad"></span><a href="#wrglossary.4015">162</a>, <a href="#wrglossary.11744">477</a>, <span class="summarylocfmt"><a href="#wrglossary.14583">606</a></span>, <a href="#wrglossary.16629">681</a>, <a href="#wrglossary.17833">720</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.group"><span class="csoptfmt">group</span></a><span class="qquad"></span><a href="#sec:newkeys">§3.2</a>; <a href="#wrglossary.697">24</a>, <a href="#wrglossary.1019">34</a>, <a href="#wrglossary.9755">387</a>–<a href="#wrglossary.9950">391</a>, <a href="#wrglossary.10043">395</a>, <a href="#wrglossary.10118">396</a>, <a href="#wrglossary.10836">426</a>, <a href="#wrglossary.12580">514</a>, <a href="#wrglossary.12660">519</a>, <a href="#wrglossary.12666">520</a>, <a href="#wrglossary.14431">602</a>, <span class="summarylocfmt"><a href="#wrglossary.14588">607</a></span>, <a href="#wrglossary.23175">928</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.location"><span class="csoptfmt">location</span></a><span class="qquad"></span><a href="#sec:newkeys">§3.2</a>; <a href="#wrglossary.696">24</a>, <a href="#wrglossary.1009">34</a>, <a href="#wrglossary.1028">35</a>, <a href="#wrglossary.10131">397</a>, <a href="#wrglossary.10136">398</a>, <a href="#wrglossary.10886">428</a>, <a href="#wrglossary.11101">440</a>, <a href="#wrglossary.11590">469</a>, <a href="#wrglossary.12532">513</a>, <a href="#wrglossary.12579">514</a>, <a href="#wrglossary.12950">530</a>, <a href="#wrglossary.13571">556</a>, <a href="#wrglossary.13934">572</a>, <span class="summarylocfmt"><a href="#wrglossary.14603">607</a></span>, <a href="#wrglossary.14793">614</a>, <a href="#wrglossary.17292">703</a>, <a href="#wrglossary.17430">707</a>, <a href="#wrglossary.23179">928</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a><span class="qquad"></span><a href="#wrglossary.1079">36</a>, <a href="#wrglossary.1325">43</a>, <a href="#wrglossary.1792">61</a>, <a href="#wrglossary.4445">175</a>, <a href="#wrglossary.5231">204</a>, <a href="#wrglossary.5963">233</a>, <a href="#wrglossary.8760">346</a>, <a href="#wrglossary.9105">364</a>, <a href="#wrglossary.11431">458</a>, <a href="#wrglossary.11579">469</a>, <a href="#wrglossary.11689">475</a>, <a href="#wrglossary.11837">481</a>, <a href="#wrglossary.11983">489</a>, <a href="#wrglossary.12091">495</a>, <a href="#wrglossary.14049">575</a>, <span class="summarylocfmt"><a href="#wrglossary.14610">607</a></span>, <a href="#wrglossary.16871">689</a>, <a href="#wrglossary.17393">706</a>, <a href="#wrglossary.19993">806</a>, <a href="#wrglossary.20630">831</a>, <a href="#wrglossary.20646">832</a>, <a href="#wrglossary.22154">896</a>, <a href="#wrglossary.22448">908</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.longaccess"><span class="csoptfmt">longaccess</span></a><span class="qquad"></span><a href="#wrglossary.4018">162</a>, <a href="#wrglossary.11685">475</a>, <span class="summarylocfmt"><a href="#wrglossary.14619">607</a></span>, <a href="#wrglossary.16872">689</a>, <a href="#wrglossary.18207">736</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a><span class="qquad"></span><a href="#wrglossary.1060">36</a>, <a href="#wrglossary.1330">43</a>–<a href="#wrglossary.1368">45</a>, <a href="#wrglossary.4032">162</a>, <a href="#wrglossary.4459">176</a>, <a href="#wrglossary.5232">204</a>, <a href="#wrglossary.11690">475</a>, <a href="#wrglossary.11845">482</a>, <a href="#wrglossary.11990">489</a>, <span class="summarylocfmt"><a href="#wrglossary.14622">607</a></span>, <a href="#wrglossary.14626">608</a>, <a href="#wrglossary.16883">689</a>, <a href="#wrglossary.17405">707</a>, <a href="#wrglossary.20033">807</a>, <a href="#wrglossary.20717">834</a>, <a href="#wrglossary.20734">835</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.longpluralaccess"><span class="csoptfmt">longpluralaccess</span></a><span class="qquad"></span><a href="#wrglossary.4019">162</a>, <a href="#wrglossary.11686">475</a>, <span class="summarylocfmt"><a href="#wrglossary.14624">608</a></span>, <a href="#wrglossary.16884">689</a>, <a href="#wrglossary.18501">749</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="qquad"></span><a href="#wrglossary.1005">34</a>, <a href="#wrglossary.1074">36</a>, <a href="#wrglossary.1351">44</a>, <a href="#wrglossary.3290">133</a>–<a href="#wrglossary.3327">135</a>, <a href="#wrglossary.3411">138</a>, <a href="#wrglossary.3434">139</a>, <a href="#wrglossary.3576">144</a>, <a href="#wrglossary.3627">146</a>, <a href="#wrglossary.3633">147</a>, <a href="#wrglossary.3869">155</a>, <a href="#wrglossary.3883">156</a>, <a href="#wrglossary.4057">163</a>, <a href="#wrglossary.4194">168</a>–<a href="#wrglossary.4273">170</a>, <a href="#wrglossary.5224">204</a>, <a href="#wrglossary.5704">223</a>, <a href="#wrglossary.5723">224</a>, <a href="#wrglossary.5847">228</a>, <a href="#wrglossary.6063">237</a>, <a href="#wrglossary.7607">292</a>, <a href="#wrglossary.9308">369</a>, <a href="#wrglossary.9357">372</a>, <a href="#wrglossary.9822">389</a>, <a href="#wrglossary.10578">415</a>, <a href="#wrglossary.10682">419</a>, <a href="#wrglossary.11224">446</a>, <a href="#wrglossary.11263">448</a>, <a href="#wrglossary.11692">475</a>, <a href="#wrglossary.11749">477</a>, <a href="#wrglossary.11906">485</a>, <a href="#wrglossary.13473">553</a>, <a href="#wrglossary.13730">563</a>, <a href="#wrglossary.14021">574</a>, <a href="#wrglossary.14045">575</a>, <a href="#wrglossary.14113">579</a>, <a href="#wrglossary.14204">586</a>, <a href="#wrglossary.14232">589</a>, <a href="#wrglossary.14238">590</a>, <a href="#wrglossary.14324">599</a>, <a href="#wrglossary.14532">605</a>, <span class="summarylocfmt"><a href="#wrglossary.14627">608</a></span>, <a href="#wrglossary.14699">610</a>, <a href="#wrglossary.14721">611</a>, <a href="#wrglossary.16517">677</a>, <a href="#wrglossary.16895">690</a>, <a href="#wrglossary.17417">707</a>, <a href="#wrglossary.17922">724</a>, <a href="#wrglossary.17929">725</a>, <a href="#wrglossary.18554">751</a>, <a href="#wrglossary.19394">780</a>, <a href="#wrglossary.19411">781</a>, <a href="#wrglossary.19831">800</a>, <a href="#wrglossary.20135">811</a>, <a href="#wrglossary.20213">814</a>, <a href="#wrglossary.20781">837</a>, <a href="#wrglossary.20985">847</a>, <a href="#wrglossary.21581">871</a>, <a href="#wrglossary.21671">874</a>, <a href="#wrglossary.22823">919</a>, <a href="#wrglossary.23839">949</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="qquad"></span><a href="#wrglossary.1142">37</a>, <a href="#wrglossary.8286">325</a>, <a href="#wrglossary.9570">379</a>, <a href="#wrglossary.9757">387</a>, <a href="#wrglossary.10838">426</a>, <a href="#wrglossary.11030">435</a>, <a href="#wrglossary.13489">554</a>, <a href="#wrglossary.14043">575</a>, <span class="summarylocfmt"><a href="#wrglossary.14639">608</a></span>, <a href="#wrglossary.17433">707</a>, <a href="#wrglossary.19832">800</a>, <a href="#wrglossary.21683">875</a>, <a href="#wrglossary.22138">895</a>, <a href="#wrglossary.22157">896</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a><span class="qquad"></span><a href="#wrglossary.1052">35</a>–<a href="#wrglossary.1135">37</a>, <a href="#wrglossary.4061">163</a>, <a href="#wrglossary.4196">168</a>, <a href="#wrglossary.4240">169</a>, <a href="#wrglossary.5226">204</a>, <a href="#wrglossary.5748">224</a>, <a href="#wrglossary.5751">225</a>, <a href="#wrglossary.6545">255</a>, <a href="#wrglossary.11765">478</a>, <a href="#wrglossary.11920">485</a>, <a href="#wrglossary.14579">606</a>, <span class="summarylocfmt"><a href="#wrglossary.14641">608</a></span>, <a href="#wrglossary.15216">635</a>, <a href="#wrglossary.15302">639</a>, <a href="#wrglossary.15344">640</a>, <a href="#wrglossary.16907">690</a>, <a href="#wrglossary.17443">708</a>, <a href="#wrglossary.17933">725</a>, <a href="#wrglossary.18669">754</a>, <a href="#wrglossary.19396">780</a>, <a href="#wrglossary.19405">781</a>, <a href="#wrglossary.20227">814</a>, <a href="#wrglossary.20231">815</a>, <a href="#wrglossary.21816">881</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.pluralaccess"><span class="csoptfmt">pluralaccess</span></a><span class="qquad"></span><a href="#wrglossary.4013">162</a>, <a href="#wrglossary.11738">477</a>, <span class="summarylocfmt"><a href="#wrglossary.14648">608</a></span>, <a href="#wrglossary.16908">690</a>, <a href="#wrglossary.18680">754</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.prefix"><span class="csoptfmt">prefix</span></a><span class="qquad"></span><a href="#wrglossary.1626">55</a>, <a href="#wrglossary.5292">207</a>, <span class="summarylocfmt"><a href="#wrglossary.14653">608</a></span>, <a href="#wrglossary.22935">922</a>, <a href="#wrglossary.23051">924</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.prefixfirst"><span class="csoptfmt">prefixfirst</span></a><span class="qquad"></span><a href="#wrglossary.1666">56</a>, <a href="#wrglossary.5354">209</a>, <span class="summarylocfmt"><a href="#wrglossary.14656">609</a></span>, <a href="#wrglossary.22887">921</a>, <a href="#wrglossary.23003">923</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.prefixfirstplural"><span class="csoptfmt">prefixfirstplural</span></a><span class="qquad"></span><a href="#wrglossary.1685">56</a>, <a href="#wrglossary.5384">210</a>, <span class="summarylocfmt"><a href="#wrglossary.14659">609</a></span>, <a href="#wrglossary.22911">921</a>, <a href="#wrglossary.23027">924</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.prefixplural"><span class="csoptfmt">prefixplural</span></a><span class="qquad"></span><a href="#wrglossary.1647">55</a>, <a href="#wrglossary.5324">208</a>, <span class="summarylocfmt"><a href="#wrglossary.14662">609</a></span>, <a href="#wrglossary.22959">922</a>, <a href="#wrglossary.23075">925</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="qquad"></span><a href="#wrglossary.523">20</a>–<a href="#wrglossary.587">22</a>, <a href="#wrglossary.707">24</a>, <a href="#wrglossary.952">33</a>, <a href="#wrglossary.1096">36</a>, <a href="#wrglossary.6878">263</a>, <a href="#wrglossary.6946">265</a>–<a href="#wrglossary.7034">267</a>, <a href="#wrglossary.7219">274</a>, <a href="#wrglossary.7236">276</a>, <a href="#wrglossary.7250">277</a>, <a href="#wrglossary.7320">279</a>, <a href="#wrglossary.7576">291</a>, <a href="#wrglossary.7761">299</a>, <a href="#wrglossary.8294">325</a>, <a href="#wrglossary.9299">369</a>, <a href="#wrglossary.11126">441</a>, <a href="#wrglossary.12606">516</a>, <a href="#wrglossary.14150">581</a>, <a href="#wrglossary.14537">605</a>, <span class="summarylocfmt"><a href="#wrglossary.14665">609</a></span>, <a href="#wrglossary.18756">757</a>, <a href="#wrglossary.19439">781</a>, <a href="#wrglossary.19456">782</a>, <a href="#wrglossary.21383">863</a>, <a href="#wrglossary.22063">892</a>, <a href="#wrglossary.23512">941</a>, <a href="#wrglossary.23812">949</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.seealso"><span class="csoptfmt">seealso</span></a><span class="qquad"></span><a href="#sec:newkeys">§3.2</a>; <a href="#wrglossary.524">20</a>–<a href="#wrglossary.591">22</a>, <a href="#wrglossary.951">33</a>, <a href="#wrglossary.6879">263</a>, <a href="#wrglossary.6953">265</a>–<a href="#wrglossary.7035">267</a>, <a href="#wrglossary.7220">274</a>, <a href="#wrglossary.7242">276</a>–<a href="#wrglossary.7321">279</a>, <a href="#wrglossary.7577">291</a>, <a href="#wrglossary.7762">299</a>, <a href="#wrglossary.8295">325</a>, <a href="#wrglossary.9300">369</a>, <a href="#wrglossary.11124">441</a>, <a href="#wrglossary.14151">581</a>, <span class="summarylocfmt"><a href="#wrglossary.14672">609</a></span>, <a href="#wrglossary.19440">781</a>, <a href="#wrglossary.19457">782</a>, <a href="#wrglossary.21376">863</a>, <a href="#wrglossary.22067">892</a>, <a href="#wrglossary.23513">941</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a><span class="qquad"></span><a href="#wrglossary.1084">36</a>, <a href="#wrglossary.1324">43</a>, <a href="#wrglossary.1791">61</a>, <a href="#wrglossary.3952">159</a>, <a href="#wrglossary.4480">177</a>, <a href="#wrglossary.5229">204</a>, <a href="#wrglossary.6539">255</a>, <a href="#wrglossary.8762">346</a>, <a href="#wrglossary.9098">364</a>, <a href="#wrglossary.9112">365</a>, <a href="#wrglossary.9311">369</a>, <a href="#wrglossary.11430">458</a>, <a href="#wrglossary.11687">475</a>, <a href="#wrglossary.11705">476</a>, <a href="#wrglossary.11821">481</a>, <a href="#wrglossary.11969">488</a>, <a href="#wrglossary.12090">495</a>, <a href="#wrglossary.12158">498</a>, <span class="summarylocfmt"><a href="#wrglossary.14676">609</a></span>, <a href="#wrglossary.14688">610</a>, <a href="#wrglossary.16919">691</a>, <a href="#wrglossary.17378">706</a>, <a href="#wrglossary.17465">709</a>, <a href="#wrglossary.19381">780</a>, <a href="#wrglossary.19992">806</a>, <a href="#wrglossary.20063">808</a>, <a href="#wrglossary.21498">868</a>, <a href="#wrglossary.22160">896</a>, <a href="#wrglossary.22383">905</a>, <a href="#wrglossary.22557">911</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.shortaccess"><span class="csoptfmt">shortaccess</span></a><span class="qquad"></span><a href="#wrglossary.4016">162</a>, <a href="#wrglossary.4090">164</a>, <a href="#wrglossary.11683">475</a>–<a href="#wrglossary.11733">477</a>, <span class="summarylocfmt"><a href="#wrglossary.14686">609</a></span>, <a href="#wrglossary.16920">691</a>, <a href="#wrglossary.17202">701</a>, <a href="#wrglossary.18823">760</a>, <a href="#wrglossary.19487">784</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a><span class="qquad"></span><a href="#wrglossary.1061">36</a>, <a href="#wrglossary.1332">43</a>–<a href="#wrglossary.1367">45</a>, <a href="#wrglossary.4031">162</a>, <a href="#wrglossary.4494">178</a>, <a href="#wrglossary.5230">204</a>, <a href="#wrglossary.11688">475</a>, <a href="#wrglossary.11829">481</a>, <a href="#wrglossary.11976">488</a>, <a href="#wrglossary.12134">497</a>, <a href="#wrglossary.12159">498</a>, <span class="summarylocfmt"><a href="#wrglossary.14690">610</a></span>, <a href="#wrglossary.15688">653</a>, <a href="#wrglossary.16931">691</a>, <a href="#wrglossary.17477">709</a>, <a href="#wrglossary.20032">807</a>, <a href="#wrglossary.21606">871</a>, <a href="#wrglossary.21623">872</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.shortpluralaccess"><span class="csoptfmt">shortpluralaccess</span></a><span class="qquad"></span><a href="#wrglossary.4017">162</a>, <a href="#wrglossary.11684">475</a>–<a href="#wrglossary.11739">477</a>, <span class="summarylocfmt"><a href="#wrglossary.14693">610</a></span>, <a href="#wrglossary.16932">691</a>, <a href="#wrglossary.18831">761</a>, <a href="#wrglossary.19488">784</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="qquad"></span><a href="#wrglossary.198">10</a>, <a href="#wrglossary.216">11</a>, <a href="#wrglossary.409">17</a>, <a href="#wrglossary.1003">34</a>, <a href="#wrglossary.1141">37</a>, <a href="#wrglossary.3321">134</a>, <a href="#wrglossary.3593">145</a>, <a href="#wrglossary.3878">156</a>, <a href="#wrglossary.5882">229</a>, <a href="#wrglossary.9816">388</a>, <a href="#wrglossary.9821">389</a>, <a href="#wrglossary.10535">412</a>, <a href="#wrglossary.12128">497</a>, <a href="#wrglossary.14011">574</a>, <a href="#wrglossary.14040">575</a>, <span class="summarylocfmt"><a href="#wrglossary.14697">610</a></span>, <a href="#wrglossary.20986">847</a>, <a href="#wrglossary.23825">949</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="qquad"></span><a href="#wrglossary.6394">251</a>, <a href="#wrglossary.9153">365</a>, <a href="#wrglossary.9160">366</a>, <a href="#wrglossary.10659">419</a>, <a href="#wrglossary.11262">448</a>, <a href="#wrglossary.11335">452</a>, <a href="#wrglossary.11391">456</a>, <a href="#wrglossary.11789">479</a>, <a href="#wrglossary.11941">486</a>, <a href="#wrglossary.13726">563</a>, <span class="summarylocfmt"><a href="#wrglossary.14702">610</a></span>, <a href="#wrglossary.14710">611</a>, <a href="#wrglossary.16943">692</a>, <a href="#wrglossary.17489">709</a>, <a href="#wrglossary.17495">710</a>, <a href="#wrglossary.18895">763</a>, <a href="#wrglossary.22163">896</a>, <a href="#wrglossary.22568">912</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.symbolaccess"><span class="csoptfmt">symbolaccess</span></a><span class="qquad"></span><a href="#wrglossary.10662">419</a>, <span class="summarylocfmt"><a href="#wrglossary.14706">610</a></span>, <a href="#wrglossary.16944">692</a>, <a href="#wrglossary.17502">710</a>, <a href="#wrglossary.18902">763</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.symbolplural"><span class="csoptfmt">symbolplural</span></a><span class="qquad"></span><a href="#wrglossary.11797">479</a>, <a href="#wrglossary.11948">487</a>, <span class="summarylocfmt"><a href="#wrglossary.14709">610</a></span>, <a href="#wrglossary.14717">611</a>, <a href="#wrglossary.16955">692</a>, <a href="#wrglossary.17505">710</a>, <a href="#wrglossary.18909">763</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.symbolpluralaccess"><span class="csoptfmt">symbolpluralaccess</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.14715">611</a></span>, <a href="#wrglossary.16956">692</a>, <a href="#wrglossary.18912">763</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a><span class="qquad"></span><a href="#wrglossary.1055">35</a>–<a href="#wrglossary.1134">37</a>, <a href="#wrglossary.1781">61</a>, <a href="#wrglossary.4060">163</a>, <a href="#wrglossary.4195">168</a>–<a href="#wrglossary.4275">170</a>, <a href="#wrglossary.5225">204</a>, <a href="#wrglossary.5726">224</a>, <a href="#wrglossary.5848">228</a>, <a href="#wrglossary.6544">255</a>, <a href="#wrglossary.8763">346</a>, <a href="#wrglossary.9312">369</a>, <a href="#wrglossary.11757">478</a>, <a href="#wrglossary.11913">485</a>, <a href="#wrglossary.13834">567</a>, <a href="#wrglossary.14569">606</a>, <a href="#wrglossary.14630">608</a>, <span class="summarylocfmt"><a href="#wrglossary.14718">611</a></span>, <a href="#wrglossary.15215">635</a>, <a href="#wrglossary.15301">639</a>, <a href="#wrglossary.15343">640</a>, <a href="#wrglossary.16967">693</a>, <a href="#wrglossary.17511">710</a>, <a href="#wrglossary.17952">726</a>, <a href="#wrglossary.18964">765</a>, <a href="#wrglossary.19395">780</a>, <a href="#wrglossary.19404">781</a>, <a href="#wrglossary.20258">816</a>, <a href="#wrglossary.21843">882</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.textaccess"><span class="csoptfmt">textaccess</span></a><span class="qquad"></span><a href="#wrglossary.4012">162</a>, <a href="#wrglossary.11735">477</a>, <span class="summarylocfmt"><a href="#wrglossary.14722">611</a></span>, <a href="#wrglossary.16968">693</a>, <a href="#wrglossary.18975">765</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="qquad"></span><a href="#wrglossary.1230">41</a>, <a href="#wrglossary.1355">44</a>, <a href="#wrglossary.6505">254</a>, <a href="#wrglossary.6798">262</a>, <a href="#wrglossary.9465">376</a>, <a href="#wrglossary.9756">387</a>, <a href="#wrglossary.10555">414</a>, <a href="#wrglossary.10837">426</a>, <a href="#wrglossary.12043">492</a>, <a href="#wrglossary.13139">536</a>, <span class="summarylocfmt"><a href="#wrglossary.14727">611</a></span>, <a href="#wrglossary.16266">668</a>, <a href="#wrglossary.17527">711</a>, <a href="#wrglossary.20983">847</a>, <a href="#wrglossary.22212">899</a>, <a href="#wrglossary.22770">917</a>, <a href="#wrglossary.22822">919</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="qquad"></span><a href="#wrglossary.1808">63</a>, <a href="#wrglossary.1831">64</a>, <a href="#wrglossary.3342">135</a>, <a href="#wrglossary.7689">295</a>, <a href="#wrglossary.8371">328</a>, <a href="#wrglossary.9181">366</a>, <a href="#wrglossary.9203">367</a>, <a href="#wrglossary.10019">394</a>, <a href="#wrglossary.10045">395</a>, <a href="#wrglossary.10674">419</a>, <a href="#wrglossary.11853">482</a>, <a href="#wrglossary.11997">489</a>, <a href="#wrglossary.12092">495</a>, <a href="#wrglossary.14435">602</a>, <span class="summarylocfmt"><a href="#wrglossary.14731">611</a></span>, <a href="#wrglossary.16982">693</a>, <a href="#wrglossary.17530">711</a>, <a href="#wrglossary.19190">775</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.user1access"><span class="csoptfmt">user1access</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.14735">611</a></span>, <a href="#wrglossary.16983">693</a>, <a href="#wrglossary.19196">775</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a><span class="qquad"></span><a href="#wrglossary.7654">293</a>, <a href="#wrglossary.9196">366</a>, <a href="#wrglossary.9202">367</a>, <a href="#wrglossary.11861">482</a>, <a href="#wrglossary.12004">490</a>, <span class="summarylocfmt"><a href="#wrglossary.14738">612</a></span>, <a href="#wrglossary.16997">693</a>, <a href="#wrglossary.17542">711</a>, <a href="#wrglossary.19218">775</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.user2access"><span class="csoptfmt">user2access</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.14742">612</a></span>, <a href="#wrglossary.16998">693</a>, <a href="#wrglossary.19224">775</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.user3"><span class="csoptfmt">user3</span></a><span class="qquad"></span><a href="#wrglossary.11869">483</a>, <a href="#wrglossary.12011">490</a>, <span class="summarylocfmt"><a href="#wrglossary.14745">612</a></span>, <a href="#wrglossary.17012">694</a>, <a href="#wrglossary.17554">711</a>, <a href="#wrglossary.17560">712</a>, <a href="#wrglossary.19246">776</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.user3access"><span class="csoptfmt">user3access</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.14749">612</a></span>, <a href="#wrglossary.17013">694</a>, <a href="#wrglossary.19252">776</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.user4"><span class="csoptfmt">user4</span></a><span class="qquad"></span><a href="#wrglossary.11877">483</a>, <a href="#wrglossary.12018">491</a>, <span class="summarylocfmt"><a href="#wrglossary.14752">612</a></span>, <a href="#wrglossary.17027">694</a>, <a href="#wrglossary.17566">712</a>, <a href="#wrglossary.19274">777</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.user4access"><span class="csoptfmt">user4access</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.14756">612</a></span>, <a href="#wrglossary.17028">694</a>, <a href="#wrglossary.19280">777</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.user5"><span class="csoptfmt">user5</span></a><span class="qquad"></span><a href="#wrglossary.11885">484</a>, <a href="#wrglossary.12025">491</a>, <span class="summarylocfmt"><a href="#wrglossary.14759">612</a></span>, <a href="#wrglossary.14765">613</a>, <a href="#wrglossary.17042">695</a>, <a href="#wrglossary.17578">712</a>, <a href="#wrglossary.19302">777</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.user5access"><span class="csoptfmt">user5access</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.14763">613</a></span>, <a href="#wrglossary.17043">695</a>, <a href="#wrglossary.19308">777</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.user6"><span class="csoptfmt">user6</span></a><span class="qquad"></span><a href="#wrglossary.11893">484</a>, <a href="#wrglossary.12032">491</a>, <span class="summarylocfmt"><a href="#wrglossary.14766">613</a></span>, <a href="#wrglossary.17057">695</a>, <a href="#wrglossary.17590">712</a>, <a href="#wrglossary.17596">713</a>, <a href="#wrglossary.19330">778</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.gloskey.user6access"><span class="csoptfmt">user6access</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.14770">613</a></span>, <a href="#wrglossary.17058">695</a>, <a href="#wrglossary.19336">778</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.glossaryignored">glossary, ignored</dfn><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:ignoredglossary">ignored glossary</a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.glossmini">glossary, mini</dfn><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:idx.mini-glossary">mini-glossary</a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.glossarystyle">glossary styles</dfn><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.15452">645</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.abbr-long-short"><span class="glostylefmt">abbr-long-short</span></a><span class="qquad"></span><a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11475">460</a>, <span class="summarylocfmt"><a href="#wrglossary.15458">645</a></span>, <a href="#wrglossary.18296">740</a>, <a href="#wrglossary.18384">744</a>, <a href="#wrglossary.18418">745</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.abbr-short-long"><span class="glostylefmt">abbr-short-long</span></a><span class="qquad"></span><a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11469">460</a>, <span class="summarylocfmt"><a href="#wrglossary.15463">645</a></span>, <a href="#wrglossary.18297">740</a>, <a href="#wrglossary.18308">741</a>, <a href="#wrglossary.18385">744</a>, <a href="#wrglossary.18419">745</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.altlist"><span class="glostylefmt">altlist</span></a><span class="qquad"></span><a href="#wrglossary.10919">429</a>, <span class="summarylocfmt"><a href="#wrglossary.15468">645</a></span>, <a href="#wrglossary.17121">697</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.alttree"><span class="glostylefmt">alttree</span></a><span class="qquad"></span><a href="#wrglossary.10970">431</a>–<a href="#wrglossary.11001">433</a>, <a href="#wrglossary.11028">435</a>, <a href="#wrglossary.11052">437</a>, <a href="#wrglossary.11247">447</a>, <a href="#wrglossary.11488">461</a>, <a href="#wrglossary.11505">463</a>, <a href="#wrglossary.13470">553</a>, <a href="#wrglossary.13478">554</a>, <a href="#wrglossary.14225">589</a>, <span class="summarylocfmt"><a href="#wrglossary.15471">645</a></span>, <a href="#wrglossary.15477">646</a>, <a href="#wrglossary.17124">697</a>, <a href="#wrglossary.19467">783</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.alttreegroup"><span class="glostylefmt">alttreegroup</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.15475">645</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.bookindex"><span class="glostylefmt">bookindex</span></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.328">14</a>, <a href="#wrglossary.9855">389</a>, <a href="#wrglossary.9993">394</a>, <a href="#wrglossary.11064">437</a>–<a href="#wrglossary.11190">444</a>, <a href="#wrglossary.13056">534</a>, <span class="summarylocfmt"><a href="#wrglossary.15479">646</a></span>, <a href="#wrglossary.19562">788</a>–<a href="#wrglossary.19631">791</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a><span class="qquad"></span><a href="#wrglossary.10975">432</a>, <span class="summarylocfmt"><a href="#wrglossary.15482">646</a></span>, <a href="#wrglossary.15598">649</a>, <a href="#wrglossary.19055">769</a>–<a href="#wrglossary.19139">773</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.15484">646</a></span>, <a href="#wrglossary.18066">731</a>, <a href="#wrglossary.19074">770</a>, <a href="#wrglossary.19120">772</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.inline"><span class="glostylefmt">inline</span></a><span class="qquad"></span><a href="#wrglossary.10887">428</a>, <span class="summarylocfmt"><a href="#wrglossary.15488">646</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a><span class="qquad"></span><a href="#wrglossary.309">14</a>, <a href="#wrglossary.10912">428</a>, <a href="#wrglossary.10918">429</a>, <a href="#wrglossary.15470">645</a>, <span class="summarylocfmt"><a href="#wrglossary.15491">646</a></span>, <a href="#wrglossary.15501">647</a>, <a href="#wrglossary.18148">734</a>, <a href="#wrglossary.18173">735</a>, <a href="#wrglossary.23487">940</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.listdotted"><span class="glostylefmt">listdotted</span></a><span class="qquad"></span><a href="#wrglossary.10920">429</a>, <span class="summarylocfmt"><a href="#wrglossary.15495">646</a></span>, <a href="#wrglossary.18158">734</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.listgroup"><span class="glostylefmt">listgroup</span></a><span class="qquad"></span><a href="#wrglossary.10926">429</a>, <span class="summarylocfmt"><a href="#wrglossary.15499">646</a></span>, <a href="#wrglossary.15505">647</a>, <a href="#wrglossary.18166">735</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.listhypergroup"><span class="glostylefmt">listhypergroup</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.15503">647</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.long-booktabs"><span class="glostylefmt">long-booktabs</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.15507">647</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.long-desc-name"><span class="glostylefmt">long-desc-name</span></a><span class="qquad"></span><a href="#sec:longextranamedesc">§8.7.2.1</a>; <a href="#wrglossary.11302">449</a>, <span class="summarylocfmt"><a href="#wrglossary.15512">647</a></span>, <a href="#wrglossary.18220">737</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.long-desc-sym-name"><span class="glostylefmt">long-desc-sym-name</span></a><span class="qquad"></span><a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11330">452</a>, <span class="summarylocfmt"><a href="#wrglossary.15517">647</a></span>, <a href="#wrglossary.18234">738</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.long-desc-sym"><span class="glostylefmt">long-desc-sym</span></a><span class="qquad"></span><a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11269">448</a>, <a href="#wrglossary.11416">457</a>, <span class="summarylocfmt"><a href="#wrglossary.15522">647</a></span>, <a href="#wrglossary.18230">737</a>, <a href="#wrglossary.18244">738</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.long-loc-desc-name"><span class="glostylefmt">long-loc-desc-name</span></a><span class="qquad"></span><a href="#sec:longextranamedescloc">§8.7.2.3</a>; <a href="#wrglossary.11351">453</a>, <span class="summarylocfmt"><a href="#wrglossary.15527">647</a></span>, <a href="#wrglossary.18258">739</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.long-loc-desc-sym-name"><span class="glostylefmt">long-loc-desc-sym-name</span></a><span class="qquad"></span><a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11385">455</a>, <span class="summarylocfmt"><a href="#wrglossary.15533">647</a></span>, <a href="#wrglossary.18268">739</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.long-loc-sym-desc-name"><span class="glostylefmt">long-loc-sym-desc-name</span></a><span class="qquad"></span><a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11379">455</a>, <span class="summarylocfmt"><a href="#wrglossary.15539">648</a></span>, <a href="#wrglossary.18282">740</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.long-name-desc-loc"><span class="glostylefmt">long-name-desc-loc</span></a><span class="qquad"></span><a href="#sec:longextranamedescloc">§8.7.2.3</a>; <a href="#wrglossary.11345">452</a>, <span class="summarylocfmt"><a href="#wrglossary.15545">648</a></span>, <a href="#wrglossary.18320">741</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.long-name-desc-sym-loc"><span class="glostylefmt">long-name-desc-sym-loc</span></a><span class="qquad"></span><a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11367">454</a>, <span class="summarylocfmt"><a href="#wrglossary.15551">648</a></span>, <a href="#wrglossary.18334">742</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.long-name-desc-sym"><span class="glostylefmt">long-name-desc-sym</span></a><span class="qquad"></span><a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11315">450</a>, <span class="summarylocfmt"><a href="#wrglossary.15557">648</a></span>, <a href="#wrglossary.18330">741</a>, <a href="#wrglossary.18344">742</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.long-name-desc"><span class="glostylefmt">long-name-desc</span></a><span class="qquad"></span><a href="#sec:longextranamedesc">§8.7.2.1</a>; <a href="#wrglossary.11273">448</a>, <a href="#wrglossary.11297">449</a>, <a href="#wrglossary.11432">458</a>, <span class="summarylocfmt"><a href="#wrglossary.15562">648</a></span>, <a href="#wrglossary.18316">741</a>, <a href="#wrglossary.18350">742</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.long-name-sym-desc-loc"><span class="glostylefmt">long-name-sym-desc-loc</span></a><span class="qquad"></span><a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11373">454</a>, <span class="summarylocfmt"><a href="#wrglossary.15567">648</a></span>, <a href="#wrglossary.18363">743</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.long-name-sym-desc"><span class="glostylefmt">long-name-sym-desc</span></a><span class="qquad"></span><a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11274">448</a>, <a href="#wrglossary.11320">451</a>, <a href="#wrglossary.11393">456</a>, <span class="summarylocfmt"><a href="#wrglossary.15573">649</a></span>, <a href="#wrglossary.18359">743</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.long-sym-desc-name"><span class="glostylefmt">long-sym-desc-name</span></a><span class="qquad"></span><a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11325">451</a>, <span class="summarylocfmt"><a href="#wrglossary.15578">649</a></span>, <a href="#wrglossary.18451">747</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.long-sym-desc"><span class="glostylefmt">long-sym-desc</span></a><span class="qquad"></span><a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11268">448</a>, <a href="#wrglossary.11410">457</a>, <span class="summarylocfmt"><a href="#wrglossary.15583">649</a></span>, <a href="#wrglossary.18447">747</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.long"><span class="glostylefmt">long</span></a><span class="qquad"></span><a href="#wrglossary.310">14</a>, <a href="#wrglossary.10211">399</a>, <a href="#wrglossary.10900">428</a>, <a href="#wrglossary.11219">446</a>, <span class="summarylocfmt"><a href="#wrglossary.15588">649</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.longragged"><span class="glostylefmt">longragged</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.15592">649</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.mcolindex"><span class="glostylefmt">mcolindex</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.15596">649</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.mcolindexgroup"><span class="glostylefmt">mcolindexgroup</span></a><span class="qquad"></span><a href="#wrglossary.11068">437</a>, <span class="summarylocfmt"><a href="#wrglossary.15600">649</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.mcoltree"><span class="glostylefmt">mcoltree</span></a><span class="qquad"></span><a href="#wrglossary.11500">462</a>, <span class="summarylocfmt"><a href="#wrglossary.15604">650</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.super"><span class="glostylefmt">super</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.15608">650</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.superragged"><span class="glostylefmt">superragged</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.15612">650</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.table"><span class="glostylefmt">table</span></a><span class="qquad"></span><a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11563">468</a>, <a href="#wrglossary.11581">469</a>, <a href="#wrglossary.11646">472</a>, <span class="summarylocfmt"><a href="#wrglossary.15616">650</a></span>, <a href="#wrglossary.23243">930</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.topic"><span class="glostylefmt">topic</span></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11494">461</a>, <a href="#wrglossary.11498">462</a>, <span class="summarylocfmt"><a href="#wrglossary.15619">650</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.topicmcols"><span class="glostylefmt">topicmcols</span></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11497">461</a>, <span class="summarylocfmt"><a href="#wrglossary.15621">650</a></span>, <a href="#wrglossary.18992">766</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.tree"><span class="glostylefmt">tree</span></a><span class="qquad"></span><a href="#wrglossary.10969">431</a>, <a href="#wrglossary.10976">432</a>, <a href="#wrglossary.11489">461</a>, <a href="#wrglossary.15473">645</a>, <span class="summarylocfmt"><a href="#wrglossary.15625">650</a></span>, <a href="#wrglossary.15629">651</a>, <a href="#wrglossary.19044">769</a>–<a href="#wrglossary.19142">773</a>, <a href="#wrglossary.21857">882</a>, <a href="#wrglossary.21860">883</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.treegroup"><span class="glostylefmt">treegroup</span></a><span class="qquad"></span><a href="#wrglossary.10942">430</a>, <span class="summarylocfmt"><a href="#wrglossary.15627">650</a></span>, <a href="#wrglossary.15633">651</a>, <a href="#wrglossary.19073">770</a>, <a href="#wrglossary.19119">772</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.treehypergroup"><span class="glostylefmt">treehypergroup</span></a><span class="qquad"></span><a href="#wrglossary.10944">430</a>, <span class="summarylocfmt"><a href="#wrglossary.15631">651</a></span>, <a href="#wrglossary.19092">771</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glostyle.treenoname"><span class="glostylefmt">treenoname</span></a><span class="qquad"></span><a href="#wrglossary.10982">432</a>, <span class="summarylocfmt"><a href="#wrglossary.15635">651</a></span>, <a href="#wrglossary.19099">771</a>, <a href="#wrglossary.19113">772</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx0"><dfn id="glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span> counter</dfn><span class="qquad"></span><a href="#wrglossary.23369">935</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glossaryentrynumbers"><code class="csfmt">\glossaryentrynumbers</code></a><span class="qquad"></span><a href="#wrglossary.10149">398</a>, <a href="#wrglossary.10772">423</a>, <span class="summarylocfmt"><a href="#wrglossary.16462">675</a></span>, <a href="#wrglossary.19965">805</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glossaryheader"><code class="csfmt">\glossaryheader</code></a><span class="qquad"></span><a href="#wrglossary.10186">399</a>, <span class="summarylocfmt"><a href="#wrglossary.16467">675</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.16471">675</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glossarypostamble"><code class="csfmt">\glossarypostamble</code></a><span class="qquad"></span><a href="#wrglossary.9638">382</a>, <a href="#wrglossary.14996">625</a>, <span class="summarylocfmt"><a href="#wrglossary.16474">675</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glossarypreamble"><code class="csfmt">\glossarypreamble</code></a><span class="qquad"></span><a href="#wrglossary.9500">377</a>, <a href="#wrglossary.9636">382</a>, <a href="#wrglossary.9661">383</a>, <a href="#wrglossary.14999">625</a>, <span class="summarylocfmt"><a href="#wrglossary.16477">675</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:setglossarypreamble"><code class="csfmt">\setglossarypreamble</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glossarysection"><code class="csfmt">\glossarysection</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.16480">675</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glossarytitle"><code class="csfmt">\glossarytitle</code></a><span class="qquad"></span><a href="#wrglossary.10190">399</a>, <span class="summarylocfmt"><a href="#wrglossary.16488">676</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glossarytoctitle"><code class="csfmt">\glossarytoctitle</code></a><span class="qquad"></span><a href="#wrglossary.10191">399</a>, <span class="summarylocfmt"><a href="#wrglossary.16492">676</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glossentry"><code class="csfmt">\glossentry</code></a><span class="qquad"></span><a href="#wrglossary.10147">398</a>–<a href="#wrglossary.10221">400</a>, <a href="#wrglossary.10546">414</a>, <a href="#wrglossary.11649">472</a>, <span class="summarylocfmt"><a href="#wrglossary.16496">676</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glossentrydesc"><code class="csfmt">\Glossentrydesc</code></a><span class="qquad"></span><a href="#wrglossary.3963">159</a>, <a href="#wrglossary.11545">466</a>, <span class="summarylocfmt"><a href="#wrglossary.16499">676</a></span>, <a href="#wrglossary.17238">701</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glossentrydesc"><code class="csfmt">\glossentrydesc</code></a><span class="qquad"></span><a href="#wrglossary.3962">159</a>, <a href="#wrglossary.10647">418</a>, <a href="#wrglossary.11234">446</a>, <a href="#wrglossary.12207">499</a>, <a href="#wrglossary.12232">500</a>, <a href="#wrglossary.14553">605</a>, <span class="summarylocfmt"><a href="#wrglossary.16503">676</a></span>, <a href="#wrglossary.17248">702</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glossentryname"><code class="csfmt">\Glossentryname</code></a><span class="qquad"></span><a href="#wrglossary.10693">420</a>, <a href="#wrglossary.11539">466</a>, <a href="#wrglossary.14018">574</a>, <span class="summarylocfmt"><a href="#wrglossary.16506">676</a></span>, <a href="#wrglossary.18548">751</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a><span class="qquad"></span><a href="#wrglossary.3960">159</a>, <a href="#wrglossary.10549">414</a>, <a href="#wrglossary.10567">415</a>, <a href="#wrglossary.10646">418</a>–<a href="#wrglossary.10692">420</a>, <a href="#wrglossary.11085">439</a>, <a href="#wrglossary.11227">446</a>, <a href="#wrglossary.11746">477</a>, <a href="#wrglossary.12238">501</a>, <a href="#wrglossary.14017">574</a>, <a href="#wrglossary.14484">603</a>, <a href="#wrglossary.14635">608</a>, <span class="summarylocfmt"><a href="#wrglossary.16510">676</a></span>, <a href="#wrglossary.16515">677</a>, <a href="#wrglossary.18558">751</a>, <a href="#wrglossary.18932">764</a>, <a href="#wrglossary.20131">811</a>, <a href="#wrglossary.21216">856</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glossentrynameother"><code class="csfmt">\glossentrynameother</code></a><span class="qquad"></span><a href="#sec:glosstylemods">§8.6</a>; <a href="#wrglossary.3961">159</a>, <a href="#wrglossary.10585">415</a>, <a href="#wrglossary.10683">419</a>, <span class="summarylocfmt"><a href="#wrglossary.16513">676</a></span>, <a href="#wrglossary.21217">856</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glossentrysymbol"><code class="csfmt">\Glossentrysymbol</code></a><span class="qquad"></span><a href="#wrglossary.3965">159</a>, <span class="summarylocfmt"><a href="#wrglossary.16518">677</a></span>, <a href="#wrglossary.18889">763</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a><span class="qquad"></span><a href="#wrglossary.3964">159</a>, <a href="#wrglossary.10652">418</a>, <a href="#wrglossary.10680">419</a>, <a href="#wrglossary.11265">448</a>, <a href="#wrglossary.12254">501</a>, <span class="summarylocfmt"><a href="#wrglossary.16522">677</a></span>, <a href="#wrglossary.17440">708</a>, <a href="#wrglossary.18899">763</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glossxtrsetpopts"><code class="csfmt">\glossxtrsetpopts</code></a><span class="qquad"></span><a href="#sec:nested">§5.4</a>; <a href="#wrglossary.5932">231</a>, <span class="summarylocfmt"><a href="#wrglossary.16525">677</a></span>, <a href="#wrglossary.21076">851</a></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index7012352 -->
+
+<section id="index7077888"><!-- start of section index7077888 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->Gls<div class="labellink"><a href="#index7077888">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><a href="#glo:GLS"><code class="csfmt">\GLS</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.16529">677</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Gls"><code class="csfmt">\Gls</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.16537">677</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:gls"><code class="csfmt">\gls</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.16547">677</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:glslike"><code class="csfmt">\gls</code>-like</dfn><span class="qquad"></span><span class="termslocfmt"><a href="#wrglossary.14349">600</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.glsopt"><code class="csfmt">\gls</code>-like and <code class="csfmt">\glstext</code>-like options</dfn><span class="qquad"></span><a href="#wrglossary.4679">186</a>–<a href="#wrglossary.4995">196</a>, <span class="summarylocfmt"><a href="#wrglossary.14811">616</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a><span class="qquad"></span><a href="#wrglossary.793">27</a>, <a href="#wrglossary.6783">261</a>, <a href="#wrglossary.12744">523</a>, <a href="#wrglossary.12903">529</a>, <a href="#wrglossary.13588">557</a>, <a href="#wrglossary.13608">558</a>, <span class="summarylocfmt"><a href="#wrglossary.14815">616</a></span>, <a href="#wrglossary.22778">918</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.14818">616</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="qquad"></span><a href="#wrglossary.4604">183</a>, <a href="#wrglossary.4687">186</a>, <a href="#wrglossary.4770">189</a>, <a href="#wrglossary.5218">204</a>, <a href="#wrglossary.5260">205</a>, <a href="#wrglossary.5930">231</a>, <a href="#wrglossary.6563">256</a>, <a href="#wrglossary.8212">320</a>, <a href="#wrglossary.8227">321</a>, <a href="#wrglossary.12170">498</a>, <a href="#wrglossary.12188">499</a>, <span class="summarylocfmt"><a href="#wrglossary.14822">616</a></span>, <a href="#wrglossary.19653">792</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glsopt.hyperoutside"><span class="csoptfmt">hyperoutside</span></a><span class="qquad"></span><a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.4694">186</a>, <a href="#wrglossary.4791">189</a>, <a href="#wrglossary.4819">190</a>, <a href="#wrglossary.6004">234</a>, <a href="#wrglossary.6570">256</a>, <a href="#wrglossary.12205">499</a>, <span class="summarylocfmt"><a href="#wrglossary.14825">616</a></span>, <a href="#wrglossary.20475">824</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glsopt.innertextformat"><span class="csoptfmt">innertextformat</span></a><span class="qquad"></span><a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.1319">43</a>, <a href="#wrglossary.4141">166</a>, <a href="#wrglossary.4400">174</a>, <a href="#wrglossary.4829">191</a>, <a href="#wrglossary.14424">601</a>, <span class="summarylocfmt"><a href="#wrglossary.14828">616</a></span>, <a href="#wrglossary.19700">794</a>, <a href="#wrglossary.19711">795</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glsopt.local"><span class="csoptfmt">local</span></a><span class="qquad"></span><a href="#wrglossary.4840">191</a>, <a href="#wrglossary.7424">283</a>, <span class="summarylocfmt"><a href="#wrglossary.14831">617</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glsopt.noindex"><span class="csoptfmt">noindex</span></a><span class="qquad"></span><a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.1106">37</a>, <a href="#wrglossary.1498">51</a>, <a href="#wrglossary.4641">185</a>, <a href="#wrglossary.4675">186</a>, <a href="#wrglossary.4739">188</a>, <a href="#wrglossary.4815">190</a>, <a href="#wrglossary.4900">193</a>, <a href="#wrglossary.4912">194</a>, <a href="#wrglossary.5217">204</a>, <a href="#wrglossary.5259">205</a>, <a href="#wrglossary.5929">231</a>, <a href="#wrglossary.6651">259</a>, <a href="#wrglossary.6931">265</a>, <a href="#wrglossary.7302">278</a>, <a href="#wrglossary.7308">279</a>, <a href="#wrglossary.14075">576</a>, <span class="summarylocfmt"><a href="#wrglossary.14837">617</a></span>, <a href="#wrglossary.20369">820</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glsopt.postunset"><span class="csoptfmt">postunset</span></a><span class="qquad"></span><a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.4685">186</a>, <a href="#wrglossary.4765">189</a>–<a href="#wrglossary.4898">193</a>, <a href="#wrglossary.7426">283</a>, <span class="summarylocfmt"><a href="#wrglossary.14843">617</a></span>, <a href="#wrglossary.18071">732</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glsopt.prefix"><span class="csoptfmt">prefix</span></a><span class="qquad"></span><a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.4984">196</a>, <a href="#wrglossary.9623">382</a>, <span class="summarylocfmt"><a href="#wrglossary.14848">617</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glsopt.prereset"><span class="csoptfmt">prereset</span></a><span class="qquad"></span><a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.1312">43</a>, <a href="#wrglossary.1413">47</a>, <a href="#wrglossary.4654">185</a>, <a href="#wrglossary.4683">186</a>, <a href="#wrglossary.4763">189</a>, <a href="#wrglossary.4844">191</a>–<a href="#wrglossary.4899">193</a>, <a href="#wrglossary.7383">282</a>, <a href="#wrglossary.7414">283</a>, <a href="#wrglossary.7507">287</a>, <a href="#wrglossary.8992">361</a>, <span class="summarylocfmt"><a href="#wrglossary.14850">617</a></span>, <a href="#wrglossary.17700">717</a>, <a href="#wrglossary.17801">720</a>, <a href="#wrglossary.18069">732</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glsopt.preunset"><span class="csoptfmt">preunset</span></a><span class="qquad"></span><a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.1313">43</a>, <a href="#wrglossary.1414">47</a>, <a href="#wrglossary.4655">185</a>, <a href="#wrglossary.4684">186</a>, <a href="#wrglossary.4764">189</a>, <a href="#wrglossary.4875">192</a>, <a href="#wrglossary.7382">282</a>, <a href="#wrglossary.7413">283</a>, <a href="#wrglossary.7475">285</a>, <a href="#wrglossary.7489">286</a>, <a href="#wrglossary.9004">362</a>, <span class="summarylocfmt"><a href="#wrglossary.14853">617</a></span>, <a href="#wrglossary.18070">732</a>, <a href="#wrglossary.18649">753</a>, <a href="#wrglossary.18663">754</a>, <a href="#wrglossary.18944">765</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glsopt.textformat"><span class="csoptfmt">textformat</span></a><span class="qquad"></span><a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.4824">190</a>, <a href="#wrglossary.4835">191</a>, <a href="#wrglossary.6105">239</a>, <span class="summarylocfmt"><a href="#wrglossary.14856">617</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glsopt.theHvalue"><span class="csoptfmt">theHvalue</span></a><span class="qquad"></span><a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.4945">194</a>, <a href="#wrglossary.4971">196</a>, <span class="summarylocfmt"><a href="#wrglossary.14860">618</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glsopt.thevalue"><span class="csoptfmt">thevalue</span></a><span class="qquad"></span><a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.4941">194</a>, <a href="#wrglossary.4977">196</a>, <a href="#wrglossary.6821">262</a>, <a href="#wrglossary.12325">503</a>, <a href="#wrglossary.13506">554</a>, <a href="#wrglossary.14244">590</a>, <a href="#wrglossary.14319">599</a>, <span class="summarylocfmt"><a href="#wrglossary.14864">618</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glsopt.types"><span class="csoptfmt">types</span></a><span class="qquad"></span><a href="#wrglossary.4677">186</a>, <span class="summarylocfmt"><a href="#wrglossary.14868">618</a></span>, <a href="#wrglossary.17076">696</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.glsopt.wrgloss"><span class="csoptfmt">wrgloss</span></a><span class="qquad"></span><a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.4637">185</a>, <a href="#wrglossary.4690">186</a>, <a href="#wrglossary.4773">189</a>, <a href="#wrglossary.4816">190</a>, <a href="#wrglossary.4921">194</a>, <a href="#wrglossary.6908">264</a>, <a href="#wrglossary.12196">499</a>, <span class="summarylocfmt"><a href="#wrglossary.14871">618</a></span>, <a href="#wrglossary.20478">825</a>, <a href="#wrglossary.22184">897</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsabbrvdefaultfont"><code class="csfmt">\glsabbrvdefaultfont</code></a><span class="qquad"></span><a href="#wrglossary.1881">66</a>, <a href="#wrglossary.2082">74</a>, <a href="#wrglossary.2248">82</a>, <a href="#wrglossary.2516">93</a>, <a href="#wrglossary.3017">115</a>, <a href="#wrglossary.3274">132</a>, <a href="#wrglossary.3279">133</a>, <a href="#wrglossary.3355">136</a>, <a href="#wrglossary.3659">148</a>, <a href="#wrglossary.3845">154</a>, <span class="summarylocfmt"><a href="#wrglossary.16557">678</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsabbrvemfont"><code class="csfmt">\glsabbrvemfont</code></a><span class="qquad"></span><a href="#wrglossary.2012">71</a>–<a href="#wrglossary.2043">73</a>, <a href="#wrglossary.2157">78</a>–<a href="#wrglossary.2199">80</a>, <a href="#wrglossary.2327">85</a>–<a href="#wrglossary.2369">87</a>, <a href="#wrglossary.2595">97</a>–<a href="#wrglossary.2637">99</a>, <a href="#wrglossary.3183">126</a>–<a href="#wrglossary.3223">129</a>, <a href="#wrglossary.3931">158</a>, <span class="summarylocfmt"><a href="#wrglossary.16558">678</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsabbrvfont"><code class="csfmt">\glsabbrvfont</code></a><span class="qquad"></span><a href="#wrglossary.4188">167</a>, <a href="#wrglossary.4192">168</a>, <a href="#wrglossary.4322">171</a>, <a href="#wrglossary.4390">174</a>, <a href="#wrglossary.15930">658</a>, <span class="summarylocfmt"><a href="#wrglossary.16560">678</a></span>, <a href="#wrglossary.18080">732</a>, <a href="#wrglossary.19341">778</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsabbrvhyphenfont"><code class="csfmt">\glsabbrvhyphenfont</code></a><span class="qquad"></span><a href="#wrglossary.1836">64</a>, <a href="#wrglossary.3658">148</a>, <span class="summarylocfmt"><a href="#wrglossary.16561">678</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsabbrvonlyfont"><code class="csfmt">\glsabbrvonlyfont</code></a><span class="qquad"></span><a href="#wrglossary.3844">154</a>, <span class="summarylocfmt"><a href="#wrglossary.16563">678</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsabbrvscfont"><code class="csfmt">\glsabbrvscfont</code></a><span class="qquad"></span><a href="#wrglossary.1924">67</a>–<a href="#wrglossary.1955">69</a>, <a href="#wrglossary.2103">75</a>, <a href="#wrglossary.2116">76</a>, <a href="#wrglossary.2273">82</a>, <a href="#wrglossary.2286">83</a>, <a href="#wrglossary.2541">94</a>, <a href="#wrglossary.2554">95</a>, <a href="#wrglossary.3075">118</a>–<a href="#wrglossary.3115">121</a>, <a href="#wrglossary.3367">136</a>, <a href="#wrglossary.3857">155</a>–<a href="#wrglossary.3906">157</a>, <span class="summarylocfmt"><a href="#wrglossary.16565">678</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsabbrvsconlyfont"><code class="csfmt">\glsabbrvsconlyfont</code></a><span class="qquad"></span><a href="#wrglossary.2967">113</a>, <a href="#wrglossary.3856">154</a>, <a href="#wrglossary.3860">155</a>, <span class="summarylocfmt"><a href="#wrglossary.16568">678</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsabbrvscuserfont"><code class="csfmt">\glsabbrvscuserfont</code></a><span class="qquad"></span><a href="#wrglossary.2463">91</a>, <a href="#wrglossary.3366">136</a>, <a href="#wrglossary.3378">137</a>, <span class="summarylocfmt"><a href="#wrglossary.16571">679</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsabbrvsmfont"><code class="csfmt">\glsabbrvsmfont</code></a><span class="qquad"></span><a href="#wrglossary.1968">69</a>–<a href="#wrglossary.1999">71</a>, <a href="#wrglossary.2130">76</a>, <a href="#wrglossary.2143">77</a>, <a href="#wrglossary.2300">84</a>, <a href="#wrglossary.2568">96</a>, <a href="#wrglossary.3129">122</a>–<a href="#wrglossary.3169">125</a>, <a href="#wrglossary.3915">157</a>, <a href="#wrglossary.3923">158</a>, <span class="summarylocfmt"><a href="#wrglossary.16574">679</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsabbrvuserfont"><code class="csfmt">\glsabbrvuserfont</code></a><span class="qquad"></span><a href="#wrglossary.2387">88</a>, <a href="#wrglossary.2655">100</a>, <a href="#wrglossary.3354">135</a>, <a href="#wrglossary.3358">136</a>, <span class="summarylocfmt"><a href="#wrglossary.16576">679</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsabspace"><code class="csfmt">\glsabspace</code></a><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a>; <a href="#wrglossary.3269">132</a>, <span class="summarylocfmt"><a href="#wrglossary.16578">679</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessdesc"><code class="csfmt">\GLSaccessdesc</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11810">480</a>, <span class="summarylocfmt"><a href="#wrglossary.16583">679</a></span>, <a href="#wrglossary.16633">681</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessdesc"><code class="csfmt">\Glsaccessdesc</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11808">480</a>, <span class="summarylocfmt"><a href="#wrglossary.16586">679</a></span>, <a href="#wrglossary.16637">681</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessdesc"><code class="csfmt">\glsaccessdesc</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11804">480</a>, <span class="summarylocfmt"><a href="#wrglossary.16589">679</a></span>, <a href="#wrglossary.16641">681</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessdescplural"><code class="csfmt">\GLSaccessdescplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11818">480</a>, <span class="summarylocfmt"><a href="#wrglossary.16595">680</a></span>, <a href="#wrglossary.16645">681</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessdescplural"><code class="csfmt">\Glsaccessdescplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11816">480</a>, <span class="summarylocfmt"><a href="#wrglossary.16598">680</a></span>, <a href="#wrglossary.16649">681</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessdescplural"><code class="csfmt">\glsaccessdescplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11812">480</a>, <span class="summarylocfmt"><a href="#wrglossary.16601">680</a></span>, <a href="#wrglossary.16653">682</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessfirst"><code class="csfmt">\GLSaccessfirst</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11778">478</a>, <span class="summarylocfmt"><a href="#wrglossary.16607">680</a></span>, <a href="#wrglossary.16657">682</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessfirst"><code class="csfmt">\Glsaccessfirst</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11776">478</a>, <span class="summarylocfmt"><a href="#wrglossary.16610">680</a></span>, <a href="#wrglossary.16661">682</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessfirst"><code class="csfmt">\glsaccessfirst</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11772">478</a>, <span class="summarylocfmt"><a href="#wrglossary.16613">680</a></span>, <a href="#wrglossary.16665">682</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessfirstplural"><code class="csfmt">\GLSaccessfirstplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11786">479</a>, <span class="summarylocfmt"><a href="#wrglossary.16619">680</a></span>, <a href="#wrglossary.16669">682</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessfirstplural"><code class="csfmt">\Glsaccessfirstplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11784">479</a>, <span class="summarylocfmt"><a href="#wrglossary.16622">681</a></span>, <a href="#wrglossary.16673">682</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessfirstplural"><code class="csfmt">\glsaccessfirstplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11780">479</a>, <a href="#wrglossary.16621">680</a>, <span class="summarylocfmt"><a href="#wrglossary.16625">681</a></span>, <a href="#wrglossary.16677">682</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessfmtdesc"><code class="csfmt">\GLSaccessfmtdesc</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11959">487</a>, <span class="summarylocfmt"><a href="#wrglossary.16631">681</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessfmtdesc"><code class="csfmt">\Glsaccessfmtdesc</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11957">487</a>, <span class="summarylocfmt"><a href="#wrglossary.16635">681</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessfmtdesc"><code class="csfmt">\glsaccessfmtdesc</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11954">487</a>, <span class="summarylocfmt"><a href="#wrglossary.16639">681</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessfmtdescplural"><code class="csfmt">\GLSaccessfmtdescplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11966">488</a>, <span class="summarylocfmt"><a href="#wrglossary.16643">681</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessfmtdescplural"><code class="csfmt">\Glsaccessfmtdescplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11964">488</a>, <span class="summarylocfmt"><a href="#wrglossary.16647">681</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessfmtdescplural"><code class="csfmt">\glsaccessfmtdescplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11961">487</a>, <span class="summarylocfmt"><a href="#wrglossary.16651">682</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessfmtfirst"><code class="csfmt">\GLSaccessfmtfirst</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11931">486</a>, <span class="summarylocfmt"><a href="#wrglossary.16655">682</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessfmtfirst"><code class="csfmt">\Glsaccessfmtfirst</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11929">486</a>, <span class="summarylocfmt"><a href="#wrglossary.16659">682</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessfmtfirst"><code class="csfmt">\glsaccessfmtfirst</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11926">486</a>, <span class="summarylocfmt"><a href="#wrglossary.16663">682</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessfmtfirstplural"><code class="csfmt">\GLSaccessfmtfirstplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11938">486</a>, <span class="summarylocfmt"><a href="#wrglossary.16667">682</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessfmtfirstplural"><code class="csfmt">\Glsaccessfmtfirstplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11936">486</a>, <span class="summarylocfmt"><a href="#wrglossary.16671">682</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessfmtfirstplural"><code class="csfmt">\glsaccessfmtfirstplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11933">486</a>, <span class="summarylocfmt"><a href="#wrglossary.16675">682</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessfmtlong"><code class="csfmt">\GLSaccessfmtlong</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11987">489</a>, <span class="summarylocfmt"><a href="#wrglossary.16679">682</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessfmtlong"><code class="csfmt">\Glsaccessfmtlong</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11985">489</a>, <span class="summarylocfmt"><a href="#wrglossary.16683">683</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessfmtlong"><code class="csfmt">\glsaccessfmtlong</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.4448">176</a>, <a href="#wrglossary.11982">489</a>, <span class="summarylocfmt"><a href="#wrglossary.16687">683</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessfmtlongpl"><code class="csfmt">\GLSaccessfmtlongpl</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11994">489</a>, <span class="summarylocfmt"><a href="#wrglossary.16691">683</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessfmtlongpl"><code class="csfmt">\Glsaccessfmtlongpl</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11992">489</a>, <span class="summarylocfmt"><a href="#wrglossary.16695">683</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessfmtlongpl"><code class="csfmt">\glsaccessfmtlongpl</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11989">489</a>, <span class="summarylocfmt"><a href="#wrglossary.16699">683</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessfmtname"><code class="csfmt">\GLSaccessfmtname</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11910">485</a>, <span class="summarylocfmt"><a href="#wrglossary.16703">683</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessfmtname"><code class="csfmt">\Glsaccessfmtname</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11908">485</a>, <span class="summarylocfmt"><a href="#wrglossary.16707">683</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessfmtname"><code class="csfmt">\glsaccessfmtname</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11905">484</a>, <span class="summarylocfmt"><a href="#wrglossary.16711">684</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessfmtplural"><code class="csfmt">\GLSaccessfmtplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11924">485</a>, <span class="summarylocfmt"><a href="#wrglossary.16715">684</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessfmtplural"><code class="csfmt">\Glsaccessfmtplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11922">485</a>, <span class="summarylocfmt"><a href="#wrglossary.16719">684</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessfmtplural"><code class="csfmt">\glsaccessfmtplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11919">485</a>, <span class="summarylocfmt"><a href="#wrglossary.16723">684</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessfmtshort"><code class="csfmt">\GLSaccessfmtshort</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11973">488</a>, <span class="summarylocfmt"><a href="#wrglossary.16727">684</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessfmtshort"><code class="csfmt">\Glsaccessfmtshort</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11971">488</a>, <span class="summarylocfmt"><a href="#wrglossary.16731">684</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessfmtshort"><code class="csfmt">\glsaccessfmtshort</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.4483">177</a>, <a href="#wrglossary.11968">488</a>, <span class="summarylocfmt"><a href="#wrglossary.16735">684</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessfmtshortpl"><code class="csfmt">\GLSaccessfmtshortpl</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11980">488</a>, <span class="summarylocfmt"><a href="#wrglossary.16739">684</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessfmtshortpl"><code class="csfmt">\Glsaccessfmtshortpl</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11978">488</a>, <span class="summarylocfmt"><a href="#wrglossary.16743">685</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessfmtshortpl"><code class="csfmt">\glsaccessfmtshortpl</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11975">488</a>, <span class="summarylocfmt"><a href="#wrglossary.16747">685</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessfmtsymbol"><code class="csfmt">\GLSaccessfmtsymbol</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11945">487</a>, <span class="summarylocfmt"><a href="#wrglossary.16751">685</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessfmtsymbol"><code class="csfmt">\Glsaccessfmtsymbol</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11943">486</a>, <span class="summarylocfmt"><a href="#wrglossary.16755">685</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessfmtsymbol"><code class="csfmt">\glsaccessfmtsymbol</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11940">486</a>, <span class="summarylocfmt"><a href="#wrglossary.16759">685</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessfmtsymbolplural"><code class="csfmt">\GLSaccessfmtsymbolplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11952">487</a>, <span class="summarylocfmt"><a href="#wrglossary.16763">685</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessfmtsymbolplural"><code class="csfmt">\Glsaccessfmtsymbolplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11950">487</a>, <span class="summarylocfmt"><a href="#wrglossary.16767">685</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessfmtsymbolplural"><code class="csfmt">\glsaccessfmtsymbolplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11947">487</a>, <span class="summarylocfmt"><a href="#wrglossary.16771">686</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessfmttext"><code class="csfmt">\GLSaccessfmttext</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11917">485</a>, <span class="summarylocfmt"><a href="#wrglossary.16775">686</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessfmttext"><code class="csfmt">\Glsaccessfmttext</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11915">485</a>, <span class="summarylocfmt"><a href="#wrglossary.16779">686</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessfmttext"><code class="csfmt">\glsaccessfmttext</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11912">485</a>, <span class="summarylocfmt"><a href="#wrglossary.16783">686</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessfmtuseri"><code class="csfmt">\GLSaccessfmtuseri</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12001">490</a>, <span class="summarylocfmt"><a href="#wrglossary.16787">686</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessfmtuseri"><code class="csfmt">\Glsaccessfmtuseri</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11999">489</a>, <span class="summarylocfmt"><a href="#wrglossary.16791">686</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessfmtuseri"><code class="csfmt">\glsaccessfmtuseri</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.11996">489</a>, <span class="summarylocfmt"><a href="#wrglossary.16795">686</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessfmtuserii"><code class="csfmt">\GLSaccessfmtuserii</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12008">490</a>, <span class="summarylocfmt"><a href="#wrglossary.16799">686</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessfmtuserii"><code class="csfmt">\Glsaccessfmtuserii</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12006">490</a>, <span class="summarylocfmt"><a href="#wrglossary.16803">687</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessfmtuserii"><code class="csfmt">\glsaccessfmtuserii</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12003">490</a>, <span class="summarylocfmt"><a href="#wrglossary.16807">687</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessfmtuseriii"><code class="csfmt">\GLSaccessfmtuseriii</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12015">490</a>, <span class="summarylocfmt"><a href="#wrglossary.16811">687</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessfmtuseriii"><code class="csfmt">\Glsaccessfmtuseriii</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12013">490</a>, <span class="summarylocfmt"><a href="#wrglossary.16815">687</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessfmtuseriii"><code class="csfmt">\glsaccessfmtuseriii</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12010">490</a>, <span class="summarylocfmt"><a href="#wrglossary.16819">687</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessfmtuseriv"><code class="csfmt">\GLSaccessfmtuseriv</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12022">491</a>, <span class="summarylocfmt"><a href="#wrglossary.16823">687</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessfmtuseriv"><code class="csfmt">\Glsaccessfmtuseriv</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12020">491</a>, <span class="summarylocfmt"><a href="#wrglossary.16827">687</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessfmtuseriv"><code class="csfmt">\glsaccessfmtuseriv</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12017">490</a>, <span class="summarylocfmt"><a href="#wrglossary.16831">688</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessfmtuserv"><code class="csfmt">\GLSaccessfmtuserv</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12029">491</a>, <span class="summarylocfmt"><a href="#wrglossary.16835">688</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessfmtuserv"><code class="csfmt">\Glsaccessfmtuserv</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12027">491</a>, <span class="summarylocfmt"><a href="#wrglossary.16839">688</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessfmtuserv"><code class="csfmt">\glsaccessfmtuserv</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12024">491</a>, <span class="summarylocfmt"><a href="#wrglossary.16843">688</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessfmtuservi"><code class="csfmt">\GLSaccessfmtuservi</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12036">491</a>, <span class="summarylocfmt"><a href="#wrglossary.16847">688</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessfmtuservi"><code class="csfmt">\Glsaccessfmtuservi</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12034">491</a>, <span class="summarylocfmt"><a href="#wrglossary.16851">688</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessfmtuservi"><code class="csfmt">\glsaccessfmtuservi</code></a><span class="qquad"></span><a href="#sec:glsaccessfmtfield">§9.3</a>; <a href="#wrglossary.12031">491</a>, <span class="summarylocfmt"><a href="#wrglossary.16855">688</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessibility"><code class="csfmt">\glsaccessibility</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.16859">688</a></span>, <a href="#wrglossary.17062">695</a>, <a href="#wrglossary.18826">761</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccesslong"><code class="csfmt">\GLSaccesslong</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11842">481</a>, <a href="#wrglossary.16681">683</a>, <span class="summarylocfmt"><a href="#wrglossary.16862">689</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccesslong"><code class="csfmt">\Glsaccesslong</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11840">481</a>, <a href="#wrglossary.16685">683</a>, <span class="summarylocfmt"><a href="#wrglossary.16865">689</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccesslong"><code class="csfmt">\glsaccesslong</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.4446">176</a>, <a href="#wrglossary.11836">481</a>, <a href="#wrglossary.16689">683</a>, <span class="summarylocfmt"><a href="#wrglossary.16868">689</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccesslongpl"><code class="csfmt">\GLSaccesslongpl</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11850">482</a>, <a href="#wrglossary.16693">683</a>, <span class="summarylocfmt"><a href="#wrglossary.16874">689</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccesslongpl"><code class="csfmt">\Glsaccesslongpl</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11848">482</a>, <a href="#wrglossary.16697">683</a>, <span class="summarylocfmt"><a href="#wrglossary.16877">689</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccesslongpl"><code class="csfmt">\glsaccesslongpl</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11844">482</a>, <a href="#wrglossary.16701">683</a>, <span class="summarylocfmt"><a href="#wrglossary.16880">689</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessname"><code class="csfmt">\GLSaccessname</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11754">477</a>, <a href="#wrglossary.16705">683</a>, <span class="summarylocfmt"><a href="#wrglossary.16886">690</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessname"><code class="csfmt">\Glsaccessname</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11752">477</a>, <a href="#wrglossary.16709">683</a>, <span class="summarylocfmt"><a href="#wrglossary.16889">690</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessname"><code class="csfmt">\glsaccessname</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.4581">183</a>, <a href="#wrglossary.11748">477</a>, <a href="#wrglossary.16713">684</a>, <span class="summarylocfmt"><a href="#wrglossary.16892">690</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessplural"><code class="csfmt">\GLSaccessplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11770">478</a>, <a href="#wrglossary.16717">684</a>, <span class="summarylocfmt"><a href="#wrglossary.16898">690</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessplural"><code class="csfmt">\Glsaccessplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11768">478</a>, <a href="#wrglossary.16721">684</a>, <span class="summarylocfmt"><a href="#wrglossary.16901">690</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessplural"><code class="csfmt">\glsaccessplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11764">478</a>, <a href="#wrglossary.16725">684</a>, <span class="summarylocfmt"><a href="#wrglossary.16904">690</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessshort"><code class="csfmt">\GLSaccessshort</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11826">481</a>, <a href="#wrglossary.16729">684</a>, <span class="summarylocfmt"><a href="#wrglossary.16910">690</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessshort"><code class="csfmt">\Glsaccessshort</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11824">481</a>, <a href="#wrglossary.16733">684</a>, <span class="summarylocfmt"><a href="#wrglossary.16913">691</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessshort"><code class="csfmt">\glsaccessshort</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.4481">177</a>, <a href="#wrglossary.11820">480</a>, <a href="#wrglossary.16737">684</a>, <a href="#wrglossary.16912">690</a>, <span class="summarylocfmt"><a href="#wrglossary.16916">691</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessshortpl"><code class="csfmt">\GLSaccessshortpl</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11834">481</a>, <a href="#wrglossary.16741">685</a>, <span class="summarylocfmt"><a href="#wrglossary.16922">691</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessshortpl"><code class="csfmt">\Glsaccessshortpl</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11832">481</a>, <a href="#wrglossary.16745">685</a>, <span class="summarylocfmt"><a href="#wrglossary.16925">691</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessshortpl"><code class="csfmt">\glsaccessshortpl</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11828">481</a>, <a href="#wrglossary.16749">685</a>, <span class="summarylocfmt"><a href="#wrglossary.16928">691</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccesssymbol"><code class="csfmt">\GLSaccesssymbol</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11794">479</a>, <a href="#wrglossary.16753">685</a>, <span class="summarylocfmt"><a href="#wrglossary.16934">691</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccesssymbol"><code class="csfmt">\Glsaccesssymbol</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11792">479</a>, <a href="#wrglossary.16757">685</a>, <span class="summarylocfmt"><a href="#wrglossary.16937">691</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccesssymbol"><code class="csfmt">\glsaccesssymbol</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11788">479</a>, <a href="#wrglossary.16761">685</a>, <a href="#wrglossary.16936">691</a>, <span class="summarylocfmt"><a href="#wrglossary.16940">692</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccesssymbolplural"><code class="csfmt">\GLSaccesssymbolplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11802">480</a>, <a href="#wrglossary.16765">685</a>, <span class="summarylocfmt"><a href="#wrglossary.16946">692</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccesssymbolplural"><code class="csfmt">\Glsaccesssymbolplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11800">479</a>, <a href="#wrglossary.16769">685</a>, <span class="summarylocfmt"><a href="#wrglossary.16949">692</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccesssymbolplural"><code class="csfmt">\glsaccesssymbolplural</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11796">479</a>, <a href="#wrglossary.16773">686</a>, <span class="summarylocfmt"><a href="#wrglossary.16952">692</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccesstext"><code class="csfmt">\GLSaccesstext</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11762">478</a>, <a href="#wrglossary.16777">686</a>, <span class="summarylocfmt"><a href="#wrglossary.16958">692</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccesstext"><code class="csfmt">\Glsaccesstext</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11760">478</a>, <a href="#wrglossary.16781">686</a>, <span class="summarylocfmt"><a href="#wrglossary.16961">692</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccesstext"><code class="csfmt">\glsaccesstext</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.339">15</a>, <a href="#wrglossary.11756">477</a>, <a href="#wrglossary.16785">686</a>, <span class="summarylocfmt"><a href="#wrglossary.16964">692</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessuseri"><code class="csfmt">\GLSaccessuseri</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11858">482</a>, <a href="#wrglossary.16789">686</a>, <span class="summarylocfmt"><a href="#wrglossary.16970">693</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessuseri"><code class="csfmt">\Glsaccessuseri</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11856">482</a>, <a href="#wrglossary.16793">686</a>, <span class="summarylocfmt"><a href="#wrglossary.16974">693</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessuseri"><code class="csfmt">\glsaccessuseri</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11852">482</a>, <a href="#wrglossary.16797">686</a>, <span class="summarylocfmt"><a href="#wrglossary.16978">693</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessuserii"><code class="csfmt">\GLSaccessuserii</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11866">483</a>, <a href="#wrglossary.16801">687</a>, <span class="summarylocfmt"><a href="#wrglossary.16985">693</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessuserii"><code class="csfmt">\Glsaccessuserii</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11864">482</a>, <a href="#wrglossary.16805">687</a>, <span class="summarylocfmt"><a href="#wrglossary.16989">693</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessuserii"><code class="csfmt">\glsaccessuserii</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11860">482</a>, <a href="#wrglossary.16809">687</a>, <span class="summarylocfmt"><a href="#wrglossary.16993">693</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessuseriii"><code class="csfmt">\GLSaccessuseriii</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11874">483</a>, <a href="#wrglossary.16813">687</a>, <span class="summarylocfmt"><a href="#wrglossary.17000">694</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessuseriii"><code class="csfmt">\Glsaccessuseriii</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11872">483</a>, <a href="#wrglossary.16817">687</a>, <span class="summarylocfmt"><a href="#wrglossary.17004">694</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessuseriii"><code class="csfmt">\glsaccessuseriii</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11868">483</a>, <a href="#wrglossary.16821">687</a>, <span class="summarylocfmt"><a href="#wrglossary.17008">694</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessuseriv"><code class="csfmt">\GLSaccessuseriv</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11882">483</a>, <a href="#wrglossary.16825">687</a>, <span class="summarylocfmt"><a href="#wrglossary.17015">694</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessuseriv"><code class="csfmt">\Glsaccessuseriv</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11880">483</a>, <a href="#wrglossary.16829">687</a>, <span class="summarylocfmt"><a href="#wrglossary.17019">694</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessuseriv"><code class="csfmt">\glsaccessuseriv</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11876">483</a>, <a href="#wrglossary.16833">688</a>, <span class="summarylocfmt"><a href="#wrglossary.17023">694</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessuserv"><code class="csfmt">\GLSaccessuserv</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11890">484</a>, <a href="#wrglossary.16837">688</a>, <span class="summarylocfmt"><a href="#wrglossary.17030">694</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessuserv"><code class="csfmt">\Glsaccessuserv</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11888">484</a>, <a href="#wrglossary.16841">688</a>, <span class="summarylocfmt"><a href="#wrglossary.17034">695</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessuserv"><code class="csfmt">\glsaccessuserv</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11884">483</a>, <a href="#wrglossary.16845">688</a>, <a href="#wrglossary.17033">694</a>, <span class="summarylocfmt"><a href="#wrglossary.17038">695</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSaccessuservi"><code class="csfmt">\GLSaccessuservi</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11898">484</a>, <a href="#wrglossary.16849">688</a>, <span class="summarylocfmt"><a href="#wrglossary.17045">695</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsaccessuservi"><code class="csfmt">\Glsaccessuservi</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11896">484</a>, <a href="#wrglossary.16853">688</a>, <span class="summarylocfmt"><a href="#wrglossary.17049">695</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccessuservi"><code class="csfmt">\glsaccessuservi</code></a><span class="qquad"></span><a href="#sec:glsaccessfield">§9.2</a>; <a href="#wrglossary.11892">484</a>, <a href="#wrglossary.16857">688</a>, <span class="summarylocfmt"><a href="#wrglossary.17053">695</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaccsupp"><code class="csfmt">\glsaccsupp</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17060">695</a></span>, <a href="#wrglossary.17617">713</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsacspace"><code class="csfmt">\glsacspace</code></a><span class="qquad"></span><a href="#wrglossary.3271">132</a>, <a href="#wrglossary.16580">679</a>, <span class="summarylocfmt"><a href="#wrglossary.17063">695</a></span>, <a href="#wrglossary.17070">696</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsacspacemax"><code class="csfmt">\glsacspacemax</code></a><span class="qquad"></span><a href="#wrglossary.3270">132</a>, <a href="#wrglossary.17065">695</a>, <span class="summarylocfmt"><a href="#wrglossary.17069">696</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a><span class="qquad"></span><a href="#wrglossary.535">20</a>, <a href="#wrglossary.655">23</a>, <a href="#wrglossary.805">27</a>, <a href="#wrglossary.1111">37</a>, <a href="#wrglossary.4669">186</a>–<a href="#wrglossary.4799">190</a>, <a href="#wrglossary.4970">196</a>, <a href="#wrglossary.5053">198</a>, <a href="#wrglossary.6654">259</a>–<a href="#wrglossary.6726">261</a>, <a href="#wrglossary.7216">274</a>, <a href="#wrglossary.12267">502</a>, <a href="#wrglossary.14322">599</a>, <a href="#wrglossary.14814">616</a>, <span class="summarylocfmt"><a href="#wrglossary.17071">696</a></span>, <a href="#wrglossary.17112">697</a>, <a href="#wrglossary.19505">784</a>, <a href="#wrglossary.23354">934</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaddall"><code class="csfmt">\glsaddall</code></a><span class="qquad"></span><a href="#wrglossary.348">15</a>, <a href="#wrglossary.4678">186</a>, <a href="#wrglossary.5069">198</a>, <a href="#wrglossary.6666">259</a>, <a href="#wrglossary.6688">260</a>, <a href="#wrglossary.9473">376</a>, <a href="#wrglossary.12551">514</a>, <a href="#wrglossary.14870">618</a>, <span class="summarylocfmt"><a href="#wrglossary.17073">696</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaddallunindexed"><code class="csfmt">\glsaddallunindexed</code></a><span class="qquad"></span><a href="#sec:wrglossary">§5.8</a>; <a href="#wrglossary.6680">259</a>, <a href="#wrglossary.6690">260</a>, <span class="summarylocfmt"><a href="#wrglossary.17083">696</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaddallunused"><code class="csfmt">\glsaddallunused</code></a><span class="qquad"></span><a href="#wrglossary.6667">259</a>, <a href="#wrglossary.6689">260</a>, <a href="#wrglossary.12552">514</a>, <span class="summarylocfmt"><a href="#wrglossary.17091">696</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaddeach"><code class="csfmt">\glsaddeach</code></a><span class="qquad"></span><a href="#sec:wrglossary">§5.8</a>; <a href="#wrglossary.5070">198</a>, <a href="#wrglossary.6693">260</a>, <span class="summarylocfmt"><a href="#wrglossary.17099">696</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a><span class="qquad"></span><a href="#wrglossary.1043">35</a>, <span class="summarylocfmt"><a href="#wrglossary.17102">696</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a> &amp; <a href="#glo:glsxtrprovidestoragekey"><code class="csfmt">\glsxtrprovidestoragekey</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaddpostsetkeys"><code class="csfmt">\glsaddpostsetkeys</code></a><span class="qquad"></span><a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4722">187</a>, <a href="#wrglossary.4760">188</a>, <span class="summarylocfmt"><a href="#wrglossary.17110">697</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaddpresetkeys"><code class="csfmt">\glsaddpresetkeys</code></a><span class="qquad"></span><a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4716">187</a>, <a href="#wrglossary.4758">188</a>, <span class="summarylocfmt"><a href="#wrglossary.17113">697</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a><span class="qquad"></span><a href="#wrglossary.1044">35</a>, <span class="summarylocfmt"><a href="#wrglossary.17116">697</a></span>, <a href="#wrglossary.21264">858</a>, <a href="#wrglossary.21272">859</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a> &amp; <a href="#glo:glsxtrprovidestoragekey"><code class="csfmt">\glsxtrprovidestoragekey</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsaltlistitem"><code class="csfmt">\glsaltlistitem</code></a><span class="qquad"></span><a href="#sec:stylemodslist">§8.6.5.3</a>; <a href="#wrglossary.10924">429</a>, <span class="summarylocfmt"><a href="#wrglossary.17119">697</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsalttreechildpredesc"><code class="csfmt">\glsalttreechildpredesc</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10974">431</a>, <span class="summarylocfmt"><a href="#wrglossary.17122">697</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsalttreepredesc"><code class="csfmt">\glsalttreepredesc</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10973">431</a>, <span class="summarylocfmt"><a href="#wrglossary.17125">697</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsapptopostlink"><code class="csfmt">\glsapptopostlink</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6382">250</a>, <span class="summarylocfmt"><a href="#wrglossary.17128">698</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></a><span class="qquad"></span><a href="#wrglossary.9541">378</a>, <span class="summarylocfmt"><a href="#wrglossary.17131">698</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsbackslash"><code class="csfmt">\glsbackslash</code></a><span class="qquad"></span><a href="#wrglossary.13084">535</a>, <span class="summarylocfmt"><a href="#wrglossary.17135">698</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glscapitalisewords"><code class="csfmt">\glscapitalisewords</code></a><span class="qquad"></span><a href="#sec:titlecase">§5.2.4</a>; <a href="#wrglossary.5134">200</a>, <a href="#wrglossary.7604">291</a>, <a href="#wrglossary.9385">373</a>, <a href="#wrglossary.12214">500</a>, <span class="summarylocfmt"><a href="#wrglossary.17137">698</a></span>, <a href="#wrglossary.19887">802</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glscapscase"><code class="csfmt">\glscapscase</code></a><span class="qquad"></span><a href="#wrglossary.6516">254</a>, <a href="#wrglossary.8828">351</a>, <a href="#wrglossary.8837">352</a>, <span class="summarylocfmt"><a href="#wrglossary.17141">698</a></span>, <a href="#wrglossary.20299">817</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glscapturedgroup"><code class="csfmt">\glscapturedgroup</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13085">535</a>, <span class="summarylocfmt"><a href="#wrglossary.17155">698</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glscategory"><code class="csfmt">\glscategory</code></a><span class="qquad"></span><a href="#sec:categories">§10</a>; <a href="#wrglossary.12044">492</a>, <span class="summarylocfmt"><a href="#wrglossary.17159">699</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glscategorylabel"><code class="csfmt">\glscategorylabel</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4009">162</a>, <a href="#wrglossary.4065">163</a>, <a href="#wrglossary.4134">166</a>, <a href="#wrglossary.4184">167</a>, <span class="summarylocfmt"><a href="#wrglossary.17160">699</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glscombinedfirstsep"><code class="csfmt">\glscombinedfirstsep</code></a><span class="qquad"></span><a href="#sec:mglssep">§7.4</a>; <a href="#wrglossary.8677">343</a>, <a href="#wrglossary.8861">354</a>, <span class="summarylocfmt"><a href="#wrglossary.17162">699</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glscombinedfirstsepfirst"><code class="csfmt">\glscombinedfirstsepfirst</code></a><span class="qquad"></span><a href="#sec:mglssep">§7.4</a>; <a href="#wrglossary.8695">344</a>, <a href="#wrglossary.8863">354</a>, <a href="#wrglossary.9375">373</a>, <span class="summarylocfmt"><a href="#wrglossary.17164">699</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glscombinedsep"><code class="csfmt">\glscombinedsep</code></a><span class="qquad"></span><a href="#sec:mglssep">§7.4</a>; <a href="#wrglossary.8670">343</a>, <a href="#wrglossary.8685">344</a>, <a href="#wrglossary.8867">354</a>, <span class="summarylocfmt"><a href="#wrglossary.17166">699</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glscombinedsepfirst"><code class="csfmt">\glscombinedsepfirst</code></a><span class="qquad"></span><a href="#sec:mglssep">§7.4</a>; <a href="#wrglossary.8686">344</a>, <a href="#wrglossary.8865">354</a>, <span class="summarylocfmt"><a href="#wrglossary.17168">699</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glscurrententrylabel"><code class="csfmt">\glscurrententrylabel</code></a><span class="qquad"></span><a href="#wrglossary.3388">137</a>, <a href="#wrglossary.10229">400</a>, <a href="#wrglossary.10263">402</a>, <a href="#wrglossary.10545">414</a>, <a href="#wrglossary.10703">420</a>, <a href="#wrglossary.10750">422</a>, <span class="summarylocfmt"><a href="#wrglossary.17170">699</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glscurrententrylevel"><code class="csfmt">\glscurrententrylevel</code></a><span class="qquad"></span><a href="#sec:printunsrtadvanced">§8.4.3</a>; <a href="#wrglossary.10231">400</a>, <a href="#wrglossary.10271">402</a>, <span class="summarylocfmt"><a href="#wrglossary.17173">700</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glscurrentfieldvalue"><code class="csfmt">\glscurrentfieldvalue</code></a><span class="qquad"></span><a href="#wrglossary.7808">301</a>–<a href="#wrglossary.7907">306</a>, <span class="summarylocfmt"><a href="#wrglossary.17178">700</a></span>, <a href="#wrglossary.19855">801</a>, <a href="#wrglossary.19955">805</a>, <a href="#wrglossary.20324">818</a>–<a href="#wrglossary.20357">820</a>, <a href="#wrglossary.20425">823</a>, <a href="#wrglossary.22151">895</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glscurrentrootentry"><code class="csfmt">\glscurrentrootentry</code></a><span class="qquad"></span><a href="#sec:printunsrtadvanced">§8.4.3</a>; <a href="#wrglossary.10239">400</a>, <a href="#wrglossary.10253">401</a>, <span class="summarylocfmt"><a href="#wrglossary.17181">700</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glscurrenttoplevelentry"><code class="csfmt">\glscurrenttoplevelentry</code></a><span class="qquad"></span><a href="#sec:printunsrtadvanced">§8.4.3</a>; <a href="#wrglossary.10235">400</a>, <a href="#wrglossary.10252">401</a>, <span class="summarylocfmt"><a href="#wrglossary.17186">700</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glscustomtext"><code class="csfmt">\glscustomtext</code></a><span class="qquad"></span><a href="#wrglossary.6511">254</a>, <span class="summarylocfmt"><a href="#wrglossary.17191">700</a></span>, <a href="#wrglossary.18090">732</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsdefaultshortaccess"><code class="csfmt">\glsdefaultshortaccess</code></a><span class="qquad"></span><a href="#wrglossary.11709">476</a>, <span class="summarylocfmt"><a href="#wrglossary.17198">700</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a><span class="qquad"></span><a href="#wrglossary.1358">44</a>, <a href="#wrglossary.9508">377</a>, <a href="#wrglossary.15020">627</a>, <a href="#wrglossary.16121">662</a>, <a href="#wrglossary.16264">667</a>, <a href="#wrglossary.16437">673</a>, <span class="summarylocfmt"><a href="#wrglossary.17205">701</a></span>, <a href="#wrglossary.22211">899</a>, <a href="#wrglossary.23094">925</a>, <a href="#wrglossary.23341">933</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsdefpostdesc"><code class="csfmt">\glsdefpostdesc</code></a><span class="qquad"></span><a href="#sec:postdeschooks">§8.6.2</a>; <a href="#wrglossary.10744">422</a>, <span class="summarylocfmt"><a href="#wrglossary.17210">701</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6377">250</a>, <span class="summarylocfmt"><a href="#wrglossary.17214">701</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsdefpostname"><code class="csfmt">\glsdefpostname</code></a><span class="qquad"></span><a href="#sec:postnamehooks">§8.6.1</a>; <a href="#wrglossary.10706">420</a>, <span class="summarylocfmt"><a href="#wrglossary.17218">701</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSdesc"><code class="csfmt">\GLSdesc</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17222">701</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsdesc"><code class="csfmt">\Glsdesc</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17230">701</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsdesc"><code class="csfmt">\glsdesc</code></a><span class="qquad"></span><a href="#wrglossary.6438">252</a>, <a href="#wrglossary.14550">605</a>, <a href="#wrglossary.17227">701</a>, <span class="summarylocfmt"><a href="#wrglossary.17239">702</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsdescplural"><code class="csfmt">\glsdescplural</code></a><span class="qquad"></span><a href="#wrglossary.6439">252</a>, <span class="summarylocfmt"><a href="#wrglossary.17249">702</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsdescriptionaccessdisplay"><code class="csfmt">\glsdescriptionaccessdisplay</code></a><span class="qquad"></span><a href="#wrglossary.11806">480</a>, <a href="#wrglossary.11956">487</a>, <span class="summarylocfmt"><a href="#wrglossary.17256">702</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsdescriptionpluralaccessdisplay"><code class="csfmt">\glsdescriptionpluralaccessdisplay</code></a><span class="qquad"></span><a href="#wrglossary.11814">480</a>, <a href="#wrglossary.11963">488</a>, <span class="summarylocfmt"><a href="#wrglossary.17259">702</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsdescwidth"><code class="csfmt">\glsdescwidth</code></a><span class="qquad"></span><a href="#wrglossary.11239">446</a>, <a href="#wrglossary.11290">449</a>, <a href="#wrglossary.11309">450</a>, <a href="#wrglossary.11337">452</a>, <a href="#wrglossary.11359">454</a>, <a href="#wrglossary.11405">457</a>, <a href="#wrglossary.11426">458</a>, <a href="#wrglossary.11467">460</a>, <span class="summarylocfmt"><a href="#wrglossary.17262">702</a></span>, <a href="#wrglossary.18292">740</a>, <a href="#wrglossary.18379">743</a>, <a href="#wrglossary.18398">744</a>, <a href="#wrglossary.18467">747</a>, <a href="#wrglossary.18471">748</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsdisp"><code class="csfmt">\Glsdisp</code></a><span class="qquad"></span><a href="#wrglossary.13798">565</a>, <span class="summarylocfmt"><a href="#wrglossary.17266">702</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a><span class="qquad"></span><a href="#wrglossary.4594">183</a>, <a href="#wrglossary.6016">235</a>, <a href="#wrglossary.6203">242</a>, <a href="#wrglossary.6512">254</a>, <a href="#wrglossary.6619">258</a>, <a href="#wrglossary.9175">366</a>, <a href="#wrglossary.13793">565</a>, <a href="#wrglossary.14351">600</a>, <a href="#wrglossary.16311">669</a>, <a href="#wrglossary.17193">700</a>, <a href="#wrglossary.17271">702</a>, <span class="summarylocfmt"><a href="#wrglossary.17276">703</a></span>, <a href="#wrglossary.18125">733</a>, <a href="#wrglossary.19815">799</a>, <a href="#wrglossary.20962">846</a>, <a href="#wrglossary.22620">913</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsdisplaynumberlist"><code class="csfmt">\glsdisplaynumberlist</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13928">571</a>, <span class="summarylocfmt"><a href="#wrglossary.17287">703</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsdoifexists"><code class="csfmt">\glsdoifexists</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17293">703</a></span>, <a href="#wrglossary.17633">714</a>, <a href="#wrglossary.22120">894</a>, <a href="#wrglossary.22131">895</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:ifglsentryexists"><code class="csfmt">\ifglsentryexists</code></a>, <a href="#glo:glsdoifexistsordo"><code class="csfmt">\glsdoifexistsordo</code></a> &amp; <a href="#glo:glsdoifnoexists"><code class="csfmt">\glsdoifnoexists</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsdoifexistsordo"><code class="csfmt">\glsdoifexistsordo</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17300">703</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:ifglsentryexists"><code class="csfmt">\ifglsentryexists</code></a>, <a href="#glo:glsdoifexists"><code class="csfmt">\glsdoifexists</code></a> &amp; <a href="#glo:glsdoifnoexists"><code class="csfmt">\glsdoifnoexists</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsdoifexistsorwarn"><code class="csfmt">\glsdoifexistsorwarn</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17308">703</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsdoifnoexists"><code class="csfmt">\glsdoifnoexists</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17312">703</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:ifglsentryexists"><code class="csfmt">\ifglsentryexists</code></a>, <a href="#glo:glsdoifexistsordo"><code class="csfmt">\glsdoifexistsordo</code></a> &amp; <a href="#glo:glsdoifexists"><code class="csfmt">\glsdoifexists</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsenableentrycount"><code class="csfmt">\glsenableentrycount</code></a><span class="qquad"></span><a href="#wrglossary.7345">280</a>, <a href="#wrglossary.7939">307</a>–<a href="#wrglossary.7969">309</a>, <a href="#wrglossary.8075">313</a>, <a href="#wrglossary.12258">501</a>, <span class="summarylocfmt"><a href="#wrglossary.17318">704</a></span>, <a href="#wrglossary.17455">708</a>, <a href="#wrglossary.21202">856</a>, <a href="#wrglossary.21223">857</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsenableentryunitcount"><code class="csfmt">\glsenableentryunitcount</code></a><span class="qquad"></span><a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.7346">280</a>, <a href="#wrglossary.8074">313</a>, <span class="summarylocfmt"><a href="#wrglossary.17320">704</a></span>, <a href="#wrglossary.17456">708</a>, <a href="#wrglossary.21203">856</a>, <a href="#wrglossary.21224">857</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsencapwrcontent"><code class="csfmt">\glsencapwrcontent</code></a><span class="qquad"></span><a href="#sec:wrglossary">§5.8</a>; <a href="#wrglossary.4629">185</a>, <a href="#wrglossary.6894">264</a>, <span class="summarylocfmt"><a href="#wrglossary.17321">704</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentrycounterlabel"><code class="csfmt">\glsentrycounterlabel</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17326">704</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentrycurrcount"><code class="csfmt">\glsentrycurrcount</code></a><span class="qquad"></span><a href="#wrglossary.7940">307</a>, <a href="#wrglossary.8097">314</a>, <span class="summarylocfmt"><a href="#wrglossary.17329">704</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsentrydesc"><code class="csfmt">\Glsentrydesc</code></a><span class="qquad"></span><a href="#wrglossary.12211">500</a>, <span class="summarylocfmt"><a href="#wrglossary.17333">704</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentrydesc"><code class="csfmt">\glsentrydesc</code></a><span class="qquad"></span><a href="#wrglossary.10532">412</a>, <a href="#wrglossary.11807">480</a>, <a href="#wrglossary.14519">604</a>, <a href="#wrglossary.14552">605</a>, <a href="#wrglossary.16594">679</a>, <span class="summarylocfmt"><a href="#wrglossary.17339">705</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentrydescplural"><code class="csfmt">\glsentrydescplural</code></a><span class="qquad"></span><a href="#wrglossary.11815">480</a>, <a href="#wrglossary.16606">680</a>, <span class="summarylocfmt"><a href="#wrglossary.17345">705</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsentryfirst"><code class="csfmt">\Glsentryfirst</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17351">705</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentryfirst"><code class="csfmt">\glsentryfirst</code></a><span class="qquad"></span><a href="#wrglossary.5461">213</a>, <a href="#wrglossary.11775">478</a>, <a href="#wrglossary.16618">680</a>, <span class="summarylocfmt"><a href="#wrglossary.17357">705</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsentryfirstplural"><code class="csfmt">\Glsentryfirstplural</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17363">705</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentryfirstplural"><code class="csfmt">\glsentryfirstplural</code></a><span class="qquad"></span><a href="#wrglossary.5471">214</a>, <a href="#wrglossary.11783">479</a>, <a href="#wrglossary.16630">681</a>, <span class="summarylocfmt"><a href="#wrglossary.17369">705</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentryfmt"><code class="csfmt">\glsentryfmt</code></a><span class="qquad"></span><a href="#wrglossary.3951">159</a>, <a href="#wrglossary.6507">254</a>, <a href="#wrglossary.12077">494</a>, <a href="#wrglossary.16263">667</a>, <span class="summarylocfmt"><a href="#wrglossary.17375">706</a></span>, <a href="#wrglossary.17969">727</a>, <a href="#wrglossary.19380">780</a>, <a href="#wrglossary.20062">808</a>, <a href="#wrglossary.21292">859</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentryindexcount"><code class="csfmt">\glsentryindexcount</code></a><span class="qquad"></span><a href="#sec:wrglossary">§5.8</a>; <a href="#wrglossary.6916">264</a>, <span class="summarylocfmt"><a href="#wrglossary.17386">706</a></span>, <a href="#wrglossary.18032">730</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a><span class="qquad"></span><a href="#wrglossary.10552">414</a>, <a href="#wrglossary.17328">704</a>, <span class="summarylocfmt"><a href="#wrglossary.17388">706</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsentrylong"><code class="csfmt">\Glsentrylong</code></a><span class="qquad"></span><a href="#wrglossary.1463">50</a>, <span class="summarylocfmt"><a href="#wrglossary.17391">706</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a><span class="qquad"></span><a href="#wrglossary.1458">50</a>, <a href="#wrglossary.5341">208</a>, <a href="#wrglossary.5348">209</a>, <a href="#wrglossary.5880">229</a>, <a href="#wrglossary.5962">233</a>, <a href="#wrglossary.11839">481</a>, <a href="#wrglossary.16873">689</a>, <span class="summarylocfmt"><a href="#wrglossary.17397">706</a></span>, <a href="#wrglossary.18606">752</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsentrylongpl"><code class="csfmt">\Glsentrylongpl</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17403">707</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentrylongpl"><code class="csfmt">\glsentrylongpl</code></a><span class="qquad"></span><a href="#wrglossary.1460">50</a>, <a href="#wrglossary.5371">209</a>, <a href="#wrglossary.5378">210</a>, <a href="#wrglossary.11847">482</a>, <a href="#wrglossary.16885">689</a>, <span class="summarylocfmt"><a href="#wrglossary.17409">707</a></span>, <a href="#wrglossary.18610">753</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsentryname"><code class="csfmt">\Glsentryname</code></a><span class="qquad"></span><a href="#wrglossary.9394">374</a>, <a href="#wrglossary.10624">417</a>, <span class="summarylocfmt"><a href="#wrglossary.17415">707</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a><span class="qquad"></span><a href="#wrglossary.659">23</a>, <a href="#wrglossary.1433">47</a>, <a href="#wrglossary.5431">212</a>, <a href="#wrglossary.7580">291</a>, <a href="#wrglossary.7619">292</a>, <a href="#wrglossary.7781">300</a>, <a href="#wrglossary.9391">374</a>, <a href="#wrglossary.10531">412</a>, <a href="#wrglossary.10543">414</a>, <a href="#wrglossary.10612">417</a>, <a href="#wrglossary.11751">477</a>, <a href="#wrglossary.12045">492</a>, <a href="#wrglossary.14027">574</a>, <a href="#wrglossary.14033">575</a>, <a href="#wrglossary.14518">604</a>, <a href="#wrglossary.14634">608</a>, <a href="#wrglossary.16897">690</a>, <span class="summarylocfmt"><a href="#wrglossary.17421">707</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentrynumberlist"><code class="csfmt">\glsentrynumberlist</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.11042">436</a>, <a href="#wrglossary.13936">572</a>, <span class="summarylocfmt"><a href="#wrglossary.17425">707</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentryparent"><code class="csfmt">\glsentryparent</code></a><span class="qquad"></span><a href="#wrglossary.7608">292</a>, <span class="summarylocfmt"><a href="#wrglossary.17431">707</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentrypdfsymbol"><code class="csfmt">\glsentrypdfsymbol</code></a><span class="qquad"></span><a href="#sec:glosstylemods">§8.6</a>; <a href="#wrglossary.10657">419</a>, <span class="summarylocfmt"><a href="#wrglossary.17438">708</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsentryplural"><code class="csfmt">\Glsentryplural</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17441">708</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentryplural"><code class="csfmt">\glsentryplural</code></a><span class="qquad"></span><a href="#wrglossary.5451">213</a>, <a href="#wrglossary.11767">478</a>, <a href="#wrglossary.16909">690</a>, <span class="summarylocfmt"><a href="#wrglossary.17447">708</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentryprevcount"><code class="csfmt">\glsentryprevcount</code></a><span class="qquad"></span><a href="#wrglossary.7941">307</a>, <a href="#wrglossary.8098">314</a>, <span class="summarylocfmt"><a href="#wrglossary.17453">708</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentryprevmaxcount"><code class="csfmt">\glsentryprevmaxcount</code></a><span class="qquad"></span><a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8100">314</a>, <span class="summarylocfmt"><a href="#wrglossary.17457">708</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentryprevtotalcount"><code class="csfmt">\glsentryprevtotalcount</code></a><span class="qquad"></span><a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8099">314</a>, <span class="summarylocfmt"><a href="#wrglossary.17460">708</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsentryshort"><code class="csfmt">\Glsentryshort</code></a><span class="qquad"></span><a href="#wrglossary.1462">50</a>, <span class="summarylocfmt"><a href="#wrglossary.17463">709</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a><span class="qquad"></span><a href="#wrglossary.1457">50</a>, <a href="#wrglossary.5172">201</a>, <a href="#wrglossary.5279">207</a>, <a href="#wrglossary.5529">216</a>, <a href="#wrglossary.5881">229</a>, <a href="#wrglossary.5921">230</a>, <a href="#wrglossary.5967">233</a>, <a href="#wrglossary.11823">481</a>, <a href="#wrglossary.16921">691</a>, <span class="summarylocfmt"><a href="#wrglossary.17469">709</a></span>, <a href="#wrglossary.18607">752</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsentryshortpl"><code class="csfmt">\Glsentryshortpl</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17475">709</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentryshortpl"><code class="csfmt">\glsentryshortpl</code></a><span class="qquad"></span><a href="#wrglossary.1459">50</a>, <a href="#wrglossary.5311">207</a>, <a href="#wrglossary.5318">208</a>, <a href="#wrglossary.5408">210</a>, <a href="#wrglossary.11831">481</a>, <a href="#wrglossary.16933">691</a>, <span class="summarylocfmt"><a href="#wrglossary.17481">709</a></span>, <a href="#wrglossary.18611">753</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsentrysymbol"><code class="csfmt">\Glsentrysymbol</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17487">709</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a><span class="qquad"></span><a href="#wrglossary.10658">419</a>, <a href="#wrglossary.11791">479</a>, <a href="#wrglossary.14705">610</a>, <a href="#wrglossary.16945">692</a>, <span class="summarylocfmt"><a href="#wrglossary.17493">709</a></span>, <a href="#wrglossary.17501">710</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentrysymbolaccess"><code class="csfmt">\glsentrysymbolaccess</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17499">710</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentrysymbolplural"><code class="csfmt">\glsentrysymbolplural</code></a><span class="qquad"></span><a href="#wrglossary.11799">479</a>, <a href="#wrglossary.14713">611</a>, <a href="#wrglossary.16957">692</a>, <span class="summarylocfmt"><a href="#wrglossary.17503">710</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsentrytext"><code class="csfmt">\Glsentrytext</code></a><span class="qquad"></span><a href="#wrglossary.17106">697</a>, <span class="summarylocfmt"><a href="#wrglossary.17509">710</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a><span class="qquad"></span><a href="#wrglossary.340">15</a>, <a href="#wrglossary.1461">50</a>, <a href="#wrglossary.5171">201</a>, <a href="#wrglossary.5441">212</a>, <a href="#wrglossary.5920">230</a>, <a href="#wrglossary.7782">300</a>, <a href="#wrglossary.11759">478</a>, <a href="#wrglossary.16969">693</a>, <a href="#wrglossary.17105">697</a>, <span class="summarylocfmt"><a href="#wrglossary.17515">710</a></span>, <a href="#wrglossary.18006">728</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentrytitlecase"><code class="csfmt">\glsentrytitlecase</code></a><span class="qquad"></span><a href="#wrglossary.5139">200</a>, <a href="#wrglossary.9397">374</a>, <a href="#wrglossary.12218">500</a>, <span class="summarylocfmt"><a href="#wrglossary.17521">710</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentrytype"><code class="csfmt">\glsentrytype</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17525">710</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsentryuseri"><code class="csfmt">\Glsentryuseri</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17528">711</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentryuseri"><code class="csfmt">\glsentryuseri</code></a><span class="qquad"></span><a href="#wrglossary.11855">482</a>, <a href="#wrglossary.14734">611</a>, <a href="#wrglossary.16984">693</a>, <span class="summarylocfmt"><a href="#wrglossary.17534">711</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsentryuserii"><code class="csfmt">\Glsentryuserii</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17540">711</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentryuserii"><code class="csfmt">\glsentryuserii</code></a><span class="qquad"></span><a href="#wrglossary.11863">482</a>, <a href="#wrglossary.14741">612</a>, <a href="#wrglossary.16999">693</a>, <span class="summarylocfmt"><a href="#wrglossary.17546">711</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsentryuseriii"><code class="csfmt">\Glsentryuseriii</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17552">711</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentryuseriii"><code class="csfmt">\glsentryuseriii</code></a><span class="qquad"></span><a href="#wrglossary.11871">483</a>, <a href="#wrglossary.14748">612</a>, <a href="#wrglossary.17014">694</a>, <span class="summarylocfmt"><a href="#wrglossary.17558">711</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsentryuseriv"><code class="csfmt">\Glsentryuseriv</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17564">712</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentryuseriv"><code class="csfmt">\glsentryuseriv</code></a><span class="qquad"></span><a href="#wrglossary.11879">483</a>, <a href="#wrglossary.14755">612</a>, <a href="#wrglossary.17029">694</a>, <span class="summarylocfmt"><a href="#wrglossary.17570">712</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsentryuserv"><code class="csfmt">\Glsentryuserv</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17576">712</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentryuserv"><code class="csfmt">\glsentryuserv</code></a><span class="qquad"></span><a href="#wrglossary.11887">484</a>, <a href="#wrglossary.14762">612</a>, <a href="#wrglossary.17044">695</a>, <span class="summarylocfmt"><a href="#wrglossary.17582">712</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsentryuservi"><code class="csfmt">\Glsentryuservi</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17588">712</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsentryuservi"><code class="csfmt">\glsentryuservi</code></a><span class="qquad"></span><a href="#wrglossary.11895">484</a>, <a href="#wrglossary.14769">613</a>, <a href="#wrglossary.17059">695</a>, <span class="summarylocfmt"><a href="#wrglossary.17594">713</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsexclapplyinnerfmtfield"><code class="csfmt">\glsexclapplyinnerfmtfield</code></a><span class="qquad"></span><a href="#sec:innertextformat">§5.5.3</a>; <a href="#wrglossary.4024">162</a>, <a href="#wrglossary.6255">245</a>, <span class="summarylocfmt"><a href="#wrglossary.17600">713</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsexpandfields"><code class="csfmt">\glsexpandfields</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17605">713</a></span>, <a href="#wrglossary.18815">760</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsextrapostnamehook"><code class="csfmt">\glsextrapostnamehook</code></a><span class="qquad"></span><a href="#sec:postnamehooks">§8.6.1</a>; <a href="#wrglossary.10710">421</a>, <a href="#wrglossary.14487">603</a>, <span class="summarylocfmt"><a href="#wrglossary.17608">713</a></span>, <a href="#wrglossary.21218">856</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfieldaccsupp"><code class="csfmt">\glsfieldaccsupp</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17611">713</a></span>, <a href="#wrglossary.19650">792</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfielddef"><code class="csfmt">\glsfielddef</code></a><span class="qquad"></span><a href="#wrglossary.1122">37</a>, <span class="summarylocfmt"><a href="#wrglossary.17618">713</a></span>, <a href="#wrglossary.17636">714</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfieldedef"><code class="csfmt">\glsfieldedef</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17624">714</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfieldfetch"><code class="csfmt">\glsfieldfetch</code></a><span class="qquad"></span><a href="#wrglossary.17524">710</a>, <span class="summarylocfmt"><a href="#wrglossary.17630">714</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfieldgdef"><code class="csfmt">\glsfieldgdef</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17634">714</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfieldxdef"><code class="csfmt">\glsfieldxdef</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17637">714</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsFindWidestAnyName"><code class="csfmt">\glsFindWidestAnyName</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11032">435</a>, <span class="summarylocfmt"><a href="#wrglossary.17640">714</a></span>, <a href="#wrglossary.17645">715</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsFindWidestAnyNameLocation"><code class="csfmt">\glsFindWidestAnyNameLocation</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11048">436</a>, <span class="summarylocfmt"><a href="#wrglossary.17643">714</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsFindWidestAnyNameSymbol"><code class="csfmt">\glsFindWidestAnyNameSymbol</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11038">436</a>, <span class="summarylocfmt"><a href="#wrglossary.17647">715</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsFindWidestAnyNameSymbolLocation"><code class="csfmt">\glsFindWidestAnyNameSymbolLocation</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11044">436</a>, <span class="summarylocfmt"><a href="#wrglossary.17650">715</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsFindWidestLevelTwo"><code class="csfmt">\glsFindWidestLevelTwo</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11035">436</a>, <span class="summarylocfmt"><a href="#wrglossary.17654">715</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsFindWidestTopLevelName"><code class="csfmt">\glsFindWidestTopLevelName</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11024">435</a>, <span class="summarylocfmt"><a href="#wrglossary.17658">715</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfindwidesttoplevelname"><code class="csfmt">\glsfindwidesttoplevelname</code></a><span class="qquad"></span><a href="#wrglossary.11022">435</a>, <span class="summarylocfmt"><a href="#wrglossary.17661">715</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsFindWidestUsedAnyName"><code class="csfmt">\glsFindWidestUsedAnyName</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11029">435</a>, <a href="#wrglossary.11037">436</a>, <span class="summarylocfmt"><a href="#wrglossary.17665">715</a></span>, <a href="#wrglossary.17671">716</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsFindWidestUsedAnyNameLocation"><code class="csfmt">\glsFindWidestUsedAnyNameLocation</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11045">436</a>, <span class="summarylocfmt"><a href="#wrglossary.17669">716</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsFindWidestUsedAnyNameSymbol"><code class="csfmt">\glsFindWidestUsedAnyNameSymbol</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11036">436</a>, <span class="summarylocfmt"><a href="#wrglossary.17673">716</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsFindWidestUsedAnyNameSymbolLocation"><code class="csfmt">\glsFindWidestUsedAnyNameSymbolLocation</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11039">436</a>, <span class="summarylocfmt"><a href="#wrglossary.17676">716</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsFindWidestUsedLevelTwo"><code class="csfmt">\glsFindWidestUsedLevelTwo</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11033">435</a>, <span class="summarylocfmt"><a href="#wrglossary.17680">716</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsFindWidestUsedTopLevelName"><code class="csfmt">\glsFindWidestUsedTopLevelName</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11026">435</a>, <a href="#wrglossary.11034">436</a>, <span class="summarylocfmt"><a href="#wrglossary.17685">716</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSfirst"><code class="csfmt">\GLSfirst</code></a><span class="qquad"></span><a href="#wrglossary.4146">166</a>, <a href="#wrglossary.5467">213</a>, <a href="#wrglossary.12174">498</a>, <span class="summarylocfmt"><a href="#wrglossary.17689">717</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsfirst"><code class="csfmt">\Glsfirst</code></a><span class="qquad"></span><a href="#wrglossary.4145">166</a>, <a href="#wrglossary.5463">213</a>, <a href="#wrglossary.12173">498</a>, <span class="summarylocfmt"><a href="#wrglossary.17701">717</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirst"><code class="csfmt">\glsfirst</code></a><span class="qquad"></span><a href="#wrglossary.96">5</a>, <a href="#wrglossary.1315">43</a>, <a href="#wrglossary.1416">47</a>, <a href="#wrglossary.1483">50</a>, <a href="#wrglossary.1493">51</a>, <a href="#wrglossary.1790">61</a>, <a href="#wrglossary.2218">81</a>, <a href="#wrglossary.4144">166</a>, <a href="#wrglossary.4648">185</a>, <a href="#wrglossary.4689">186</a>, <a href="#wrglossary.4768">189</a>, <a href="#wrglossary.5460">213</a>, <a href="#wrglossary.6160">240</a>, <a href="#wrglossary.7406">282</a>, <a href="#wrglossary.9113">365</a>, <a href="#wrglossary.12172">498</a>, <span class="summarylocfmt"><a href="#wrglossary.17715">717</a></span>, <a href="#wrglossary.21419">864</a>, <a href="#wrglossary.22384">905</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstabbrvdefaultfont"><code class="csfmt">\glsfirstabbrvdefaultfont</code></a><span class="qquad"></span><a href="#wrglossary.1880">65</a>, <a href="#wrglossary.2080">74</a>, <a href="#wrglossary.2247">81</a>, <a href="#wrglossary.2515">93</a>, <a href="#wrglossary.3016">115</a>, <a href="#wrglossary.3277">132</a>, <span class="summarylocfmt"><a href="#wrglossary.17730">717</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstabbrvemfont"><code class="csfmt">\glsfirstabbrvemfont</code></a><span class="qquad"></span><a href="#wrglossary.2013">71</a>–<a href="#wrglossary.2044">73</a>, <a href="#wrglossary.2158">78</a>–<a href="#wrglossary.2200">80</a>, <a href="#wrglossary.2328">85</a>–<a href="#wrglossary.2370">87</a>, <a href="#wrglossary.2596">97</a>–<a href="#wrglossary.2638">99</a>, <a href="#wrglossary.3184">126</a>–<a href="#wrglossary.3224">129</a>, <a href="#wrglossary.3933">158</a>, <span class="summarylocfmt"><a href="#wrglossary.17732">717</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstabbrvfont"><code class="csfmt">\glsfirstabbrvfont</code></a><span class="qquad"></span><a href="#wrglossary.4151">166</a>, <a href="#wrglossary.4155">167</a>, <a href="#wrglossary.4317">171</a>, <a href="#wrglossary.16415">672</a>, <span class="summarylocfmt"><a href="#wrglossary.17735">717</a></span>, <a href="#wrglossary.17765">719</a>, <a href="#wrglossary.17837">721</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstabbrvhyphenfont"><code class="csfmt">\glsfirstabbrvhyphenfont</code></a><span class="qquad"></span><a href="#wrglossary.1837">64</a>, <a href="#wrglossary.3660">148</a>, <span class="summarylocfmt"><a href="#wrglossary.17737">718</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstabbrvonlyfont"><code class="csfmt">\glsfirstabbrvonlyfont</code></a><span class="qquad"></span><a href="#wrglossary.3846">154</a>, <span class="summarylocfmt"><a href="#wrglossary.17740">718</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstabbrvscfont"><code class="csfmt">\glsfirstabbrvscfont</code></a><span class="qquad"></span><a href="#wrglossary.1925">67</a>–<a href="#wrglossary.1956">69</a>, <a href="#wrglossary.2104">75</a>, <a href="#wrglossary.2117">76</a>, <a href="#wrglossary.2274">82</a>, <a href="#wrglossary.2287">83</a>, <a href="#wrglossary.2542">94</a>, <a href="#wrglossary.2555">95</a>, <a href="#wrglossary.3076">118</a>–<a href="#wrglossary.3116">121</a>, <a href="#wrglossary.3904">157</a>, <span class="summarylocfmt"><a href="#wrglossary.17743">718</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstabbrvsconlyfont"><code class="csfmt">\glsfirstabbrvsconlyfont</code></a><span class="qquad"></span><a href="#wrglossary.2968">113</a>, <a href="#wrglossary.3858">155</a>, <span class="summarylocfmt"><a href="#wrglossary.17747">718</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstabbrvscuserfont"><code class="csfmt">\glsfirstabbrvscuserfont</code></a><span class="qquad"></span><a href="#wrglossary.2464">91</a>, <a href="#wrglossary.3374">136</a>, <span class="summarylocfmt"><a href="#wrglossary.17750">718</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstabbrvsmfont"><code class="csfmt">\glsfirstabbrvsmfont</code></a><span class="qquad"></span><a href="#wrglossary.1969">69</a>–<a href="#wrglossary.2000">71</a>, <a href="#wrglossary.2131">76</a>, <a href="#wrglossary.2144">77</a>, <a href="#wrglossary.2301">84</a>, <a href="#wrglossary.2569">96</a>, <a href="#wrglossary.3130">122</a>–<a href="#wrglossary.3170">125</a>, <a href="#wrglossary.3921">157</a>, <span class="summarylocfmt"><a href="#wrglossary.17754">718</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstabbrvuserfont"><code class="csfmt">\glsfirstabbrvuserfont</code></a><span class="qquad"></span><a href="#wrglossary.2388">88</a>, <a href="#wrglossary.2656">100</a>, <a href="#wrglossary.3356">136</a>, <span class="summarylocfmt"><a href="#wrglossary.17757">718</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstaccessdisplay"><code class="csfmt">\glsfirstaccessdisplay</code></a><span class="qquad"></span><a href="#wrglossary.11774">478</a>, <a href="#wrglossary.11928">486</a>, <span class="summarylocfmt"><a href="#wrglossary.17760">718</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstinnerfmtabbrvfont"><code class="csfmt">\glsfirstinnerfmtabbrvfont</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4150">166</a>, <a href="#wrglossary.4156">167</a>, <span class="summarylocfmt"><a href="#wrglossary.17763">719</a></span>, <a href="#wrglossary.17838">721</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstinnerfmtlongfont"><code class="csfmt">\glsfirstinnerfmtlongfont</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4198">168</a>, <span class="summarylocfmt"><a href="#wrglossary.17767">719</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstlongdefaultfont"><code class="csfmt">\glsfirstlongdefaultfont</code></a><span class="qquad"></span><a href="#wrglossary.2075">74</a>, <a href="#wrglossary.2244">81</a>, <a href="#wrglossary.2512">93</a>, <a href="#wrglossary.3285">133</a>, <span class="summarylocfmt"><a href="#wrglossary.17771">719</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstlongemfont"><code class="csfmt">\glsfirstlongemfont</code></a><span class="qquad"></span><a href="#wrglossary.2187">79</a>, <a href="#wrglossary.2202">80</a>, <a href="#wrglossary.2356">86</a>, <a href="#wrglossary.2371">87</a>, <a href="#wrglossary.2624">98</a>, <a href="#wrglossary.2639">99</a>, <a href="#wrglossary.3945">158</a>, <span class="summarylocfmt"><a href="#wrglossary.17773">719</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstlongfont"><code class="csfmt">\glsfirstlongfont</code></a><span class="qquad"></span><a href="#wrglossary.4199">168</a>, <a href="#wrglossary.4328">172</a>, <span class="summarylocfmt"><a href="#wrglossary.17776">719</a></span>, <a href="#wrglossary.17842">721</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstlongfootnotefont"><code class="csfmt">\glsfirstlongfootnotefont</code></a><span class="qquad"></span><a href="#wrglossary.3013">115</a>, <a href="#wrglossary.3599">145</a>, <span class="summarylocfmt"><a href="#wrglossary.17778">719</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstlonghyphenfont"><code class="csfmt">\glsfirstlonghyphenfont</code></a><span class="qquad"></span><a href="#wrglossary.1835">64</a>, <a href="#wrglossary.3665">148</a>, <a href="#wrglossary.3755">151</a>, <span class="summarylocfmt"><a href="#wrglossary.17781">719</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstlongonlyfont"><code class="csfmt">\glsfirstlongonlyfont</code></a><span class="qquad"></span><a href="#wrglossary.3851">154</a>, <span class="summarylocfmt"><a href="#wrglossary.17784">720</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstlonguserfont"><code class="csfmt">\glsfirstlonguserfont</code></a><span class="qquad"></span><a href="#wrglossary.2390">88</a>, <a href="#wrglossary.2658">100</a>, <a href="#wrglossary.3363">136</a>, <span class="summarylocfmt"><a href="#wrglossary.17787">720</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSfirstplural"><code class="csfmt">\GLSfirstplural</code></a><span class="qquad"></span><a href="#wrglossary.4149">166</a>, <a href="#wrglossary.5477">214</a>, <span class="summarylocfmt"><a href="#wrglossary.17790">720</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsfirstplural"><code class="csfmt">\Glsfirstplural</code></a><span class="qquad"></span><a href="#wrglossary.4148">166</a>, <a href="#wrglossary.5473">214</a>, <span class="summarylocfmt"><a href="#wrglossary.17802">720</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstplural"><code class="csfmt">\glsfirstplural</code></a><span class="qquad"></span><a href="#wrglossary.1316">43</a>, <a href="#wrglossary.1417">47</a>, <a href="#wrglossary.2219">81</a>, <a href="#wrglossary.4147">166</a>, <a href="#wrglossary.4649">185</a>, <a href="#wrglossary.4769">189</a>, <a href="#wrglossary.5470">214</a>, <a href="#wrglossary.6162">240</a>, <span class="summarylocfmt"><a href="#wrglossary.17816">720</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstpluralaccessdisplay"><code class="csfmt">\glsfirstpluralaccessdisplay</code></a><span class="qquad"></span><a href="#wrglossary.11782">479</a>, <a href="#wrglossary.11935">486</a>, <span class="summarylocfmt"><a href="#wrglossary.17831">720</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstxpabbrvfont"><code class="csfmt">\glsfirstxpabbrvfont</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4153">167</a>, <span class="summarylocfmt"><a href="#wrglossary.17834">721</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfirstxplongfont"><code class="csfmt">\glsfirstxplongfont</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4201">168</a>, <span class="summarylocfmt"><a href="#wrglossary.17839">721</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSfmtfield"><code class="csfmt">\GLSfmtfield</code></a><span class="qquad"></span><a href="#sec:innertextformat">§5.5.3</a>; <a href="#wrglossary.6261">245</a>, <a href="#wrglossary.11902">484</a>, <a href="#wrglossary.16634">681</a>–<a href="#wrglossary.16838">688</a>, <span class="summarylocfmt"><a href="#wrglossary.17844">721</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsfmtfield"><code class="csfmt">\Glsfmtfield</code></a><span class="qquad"></span><a href="#sec:innertextformat">§5.5.3</a>; <a href="#wrglossary.6259">245</a>, <a href="#wrglossary.11901">484</a>, <a href="#wrglossary.16638">681</a>–<a href="#wrglossary.16842">688</a>, <span class="summarylocfmt"><a href="#wrglossary.17848">721</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfmtfield"><code class="csfmt">\glsfmtfield</code></a><span class="qquad"></span><a href="#sec:innertextformat">§5.5.3</a>; <a href="#wrglossary.6249">244</a>, <a href="#wrglossary.6257">245</a>, <a href="#wrglossary.11900">484</a>, <a href="#wrglossary.16642">681</a>–<a href="#wrglossary.16834">688</a>, <span class="summarylocfmt"><a href="#wrglossary.17853">721</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSfmtfirst"><code class="csfmt">\GLSfmtfirst</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5466">213</a>, <a href="#wrglossary.5786">226</a>, <span class="summarylocfmt"><a href="#wrglossary.17858">721</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsfmtfirst"><code class="csfmt">\Glsfmtfirst</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5462">213</a>, <a href="#wrglossary.5778">225</a>, <span class="summarylocfmt"><a href="#wrglossary.17862">721</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfmtfirst"><code class="csfmt">\glsfmtfirst</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5459">213</a>, <a href="#wrglossary.5771">225</a>, <span class="summarylocfmt"><a href="#wrglossary.17865">722</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSfmtfirstpl"><code class="csfmt">\GLSfmtfirstpl</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5476">214</a>, <a href="#wrglossary.5808">226</a>, <span class="summarylocfmt"><a href="#wrglossary.17867">722</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsfmtfirstpl"><code class="csfmt">\Glsfmtfirstpl</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5472">214</a>, <a href="#wrglossary.5800">226</a>, <span class="summarylocfmt"><a href="#wrglossary.17871">722</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfmtfirstpl"><code class="csfmt">\glsfmtfirstpl</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5469">213</a>, <a href="#wrglossary.5793">226</a>, <span class="summarylocfmt"><a href="#wrglossary.17874">722</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSfmtfull"><code class="csfmt">\GLSfmtfull</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5416">211</a>, <a href="#wrglossary.5683">222</a>, <span class="summarylocfmt"><a href="#wrglossary.17876">722</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsfmtfull"><code class="csfmt">\Glsfmtfull</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5412">211</a>, <a href="#wrglossary.5677">222</a>, <span class="summarylocfmt"><a href="#wrglossary.17880">722</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfmtfull"><code class="csfmt">\glsfmtfull</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5409">210</a>, <a href="#wrglossary.5672">221</a>, <a href="#wrglossary.5674">222</a>, <span class="summarylocfmt"><a href="#wrglossary.17884">722</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSfmtfullpl"><code class="csfmt">\GLSfmtfullpl</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5426">211</a>, <a href="#wrglossary.5699">223</a>, <span class="summarylocfmt"><a href="#wrglossary.17888">723</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsfmtfullpl"><code class="csfmt">\Glsfmtfullpl</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5422">211</a>, <a href="#wrglossary.5693">222</a>, <span class="summarylocfmt"><a href="#wrglossary.17892">723</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfmtfullpl"><code class="csfmt">\glsfmtfullpl</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5419">211</a>, <a href="#wrglossary.5688">222</a>, <span class="summarylocfmt"><a href="#wrglossary.17896">723</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSfmtinsert"><code class="csfmt">\GLSfmtinsert</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17900">723</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfmtinsert"><code class="csfmt">\glsfmtinsert</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.17904">723</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSfmtlong"><code class="csfmt">\GLSfmtlong</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5346">209</a>, <a href="#wrglossary.5651">220</a>, <a href="#wrglossary.5654">221</a>, <span class="summarylocfmt"><a href="#wrglossary.17909">723</a></span>, <a href="#wrglossary.20194">813</a>, <a href="#wrglossary.21784">879</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsfmtlong"><code class="csfmt">\Glsfmtlong</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5342">208</a>, <a href="#wrglossary.5645">220</a>, <span class="summarylocfmt"><a href="#wrglossary.17911">724</a></span>, <a href="#wrglossary.20197">813</a>, <a href="#wrglossary.21787">879</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfmtlong"><code class="csfmt">\glsfmtlong</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.1432">47</a>, <a href="#wrglossary.1453">49</a>, <a href="#wrglossary.5339">208</a>, <a href="#wrglossary.5353">209</a>, <a href="#wrglossary.5640">220</a>, <a href="#wrglossary.5961">233</a>, <span class="summarylocfmt"><a href="#wrglossary.17913">724</a></span>, <a href="#wrglossary.20200">813</a>, <a href="#wrglossary.21790">879</a>, <a href="#wrglossary.22886">921</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSfmtlongpl"><code class="csfmt">\GLSfmtlongpl</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5376">209</a>, <a href="#wrglossary.5667">221</a>, <span class="summarylocfmt"><a href="#wrglossary.17914">724</a></span>, <a href="#wrglossary.20203">814</a>, <a href="#wrglossary.21793">880</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsfmtlongpl"><code class="csfmt">\Glsfmtlongpl</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5372">209</a>, <a href="#wrglossary.5661">221</a>, <span class="summarylocfmt"><a href="#wrglossary.17916">724</a></span>, <a href="#wrglossary.20206">814</a>, <a href="#wrglossary.21796">880</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfmtlongpl"><code class="csfmt">\glsfmtlongpl</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5369">209</a>, <a href="#wrglossary.5383">210</a>, <a href="#wrglossary.5656">221</a>, <span class="summarylocfmt"><a href="#wrglossary.17918">724</a></span>, <a href="#wrglossary.20209">814</a>, <a href="#wrglossary.21799">880</a>, <a href="#wrglossary.22910">921</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSfmtname"><code class="csfmt">\GLSfmtname</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5436">212</a>, <a href="#wrglossary.5720">223</a>, <a href="#wrglossary.5724">224</a>, <a href="#wrglossary.7645">293</a>, <span class="summarylocfmt"><a href="#wrglossary.17919">724</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsfmtname"><code class="csfmt">\Glsfmtname</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5432">212</a>, <a href="#wrglossary.5712">223</a>, <a href="#wrglossary.7626">292</a>, <a href="#wrglossary.7640">293</a>, <span class="summarylocfmt"><a href="#wrglossary.17923">724</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfmtname"><code class="csfmt">\glsfmtname</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5429">211</a>, <a href="#wrglossary.5705">223</a>, <a href="#wrglossary.7616">292</a>, <span class="summarylocfmt"><a href="#wrglossary.17927">725</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSfmtplural"><code class="csfmt">\GLSfmtplural</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5456">213</a>, <a href="#wrglossary.5764">225</a>, <span class="summarylocfmt"><a href="#wrglossary.17930">725</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsfmtplural"><code class="csfmt">\Glsfmtplural</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5452">213</a>, <a href="#wrglossary.5756">225</a>, <span class="summarylocfmt"><a href="#wrglossary.17934">725</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfmtplural"><code class="csfmt">\glsfmtplural</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5449">212</a>, <a href="#wrglossary.5749">224</a>, <a href="#wrglossary.5752">225</a>, <span class="summarylocfmt"><a href="#wrglossary.17937">725</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSfmtshort"><code class="csfmt">\GLSfmtshort</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5284">207</a>, <a href="#wrglossary.5594">218</a>, <span class="summarylocfmt"><a href="#wrglossary.17939">725</a></span>, <a href="#wrglossary.20242">815</a>, <a href="#wrglossary.21827">881</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsfmtshort"><code class="csfmt">\Glsfmtshort</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5280">207</a>, <a href="#wrglossary.5532">216</a>, <a href="#wrglossary.5574">217</a>, <a href="#wrglossary.5612">219</a>, <span class="summarylocfmt"><a href="#wrglossary.17941">725</a></span>, <a href="#wrglossary.20244">815</a>, <a href="#wrglossary.21829">881</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfmtshort"><code class="csfmt">\glsfmtshort</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.804">27</a>, <a href="#wrglossary.1431">47</a>, <a href="#wrglossary.5214">204</a>, <a href="#wrglossary.5261">205</a>, <a href="#wrglossary.5277">207</a>, <a href="#wrglossary.5519">215</a>–<a href="#wrglossary.5553">217</a>, <a href="#wrglossary.5611">219</a>, <a href="#wrglossary.5928">231</a>, <a href="#wrglossary.12256">501</a>, <span class="summarylocfmt"><a href="#wrglossary.17943">725</a></span>, <a href="#wrglossary.20246">815</a>, <a href="#wrglossary.21810">880</a>, <a href="#wrglossary.21831">881</a>, <a href="#wrglossary.22934">922</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSfmtshortpl"><code class="csfmt">\GLSfmtshortpl</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5316">208</a>, <a href="#wrglossary.5635">220</a>, <span class="summarylocfmt"><a href="#wrglossary.17944">725</a></span>, <a href="#wrglossary.20249">815</a>, <a href="#wrglossary.21834">882</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsfmtshortpl"><code class="csfmt">\Glsfmtshortpl</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5312">208</a>, <a href="#wrglossary.5629">219</a>, <a href="#wrglossary.5632">220</a>, <span class="summarylocfmt"><a href="#wrglossary.17946">726</a></span>, <a href="#wrglossary.20251">815</a>, <a href="#wrglossary.21836">882</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfmtshortpl"><code class="csfmt">\glsfmtshortpl</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5309">207</a>, <a href="#wrglossary.5323">208</a>, <a href="#wrglossary.5624">219</a>, <span class="summarylocfmt"><a href="#wrglossary.17948">726</a></span>, <a href="#wrglossary.20254">816</a>, <a href="#wrglossary.21839">882</a>, <a href="#wrglossary.22958">922</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSfmttext"><code class="csfmt">\GLSfmttext</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5446">212</a>, <a href="#wrglossary.5742">224</a>, <a href="#wrglossary.7644">293</a>, <span class="summarylocfmt"><a href="#wrglossary.17949">726</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsfmttext"><code class="csfmt">\Glsfmttext</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5028">197</a>, <a href="#wrglossary.5442">212</a>, <a href="#wrglossary.5734">224</a>, <a href="#wrglossary.7625">292</a>, <a href="#wrglossary.7639">293</a>, <span class="summarylocfmt"><a href="#wrglossary.17953">726</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsfmttext"><code class="csfmt">\glsfmttext</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.803">27</a>, <a href="#wrglossary.4578">183</a>, <a href="#wrglossary.4810">190</a>, <a href="#wrglossary.5213">204</a>, <a href="#wrglossary.5439">212</a>, <a href="#wrglossary.5727">224</a>, <a href="#wrglossary.7615">292</a>, <a href="#wrglossary.7787">300</a>, <span class="summarylocfmt"><a href="#wrglossary.17956">726</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsforeachincategory"><code class="csfmt">\glsforeachincategory</code></a><span class="qquad"></span><a href="#sec:categories">§10</a>; <a href="#wrglossary.12056">493</a>, <span class="summarylocfmt"><a href="#wrglossary.17958">726</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsforeachwithattribute"><code class="csfmt">\glsforeachwithattribute</code></a><span class="qquad"></span><a href="#sec:categories">§10</a>; <a href="#wrglossary.12058">493</a>, <span class="summarylocfmt"><a href="#wrglossary.17963">727</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsgenentryfmt"><code class="csfmt">\glsgenentryfmt</code></a><span class="qquad"></span><a href="#sec:entryfmt">§5.5.5</a>; <a href="#wrglossary.1771">60</a>, <a href="#wrglossary.1858">65</a>, <a href="#wrglossary.2213">81</a>, <a href="#wrglossary.4833">191</a>, <a href="#wrglossary.6212">243</a>, <a href="#wrglossary.6540">255</a>, <a href="#wrglossary.11903">484</a>, <a href="#wrglossary.12078">494</a>, <a href="#wrglossary.17380">706</a>, <span class="summarylocfmt"><a href="#wrglossary.17967">727</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsgetattribute"><code class="csfmt">\glsgetattribute</code></a><span class="qquad"></span><a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12337">505</a>, <span class="summarylocfmt"><a href="#wrglossary.17970">727</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsgetcategoryattribute"><code class="csfmt">\glsgetcategoryattribute</code></a><span class="qquad"></span><a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12336">505</a>, <span class="summarylocfmt"><a href="#wrglossary.17971">727</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsgetwidestname"><code class="csfmt">\glsgetwidestname</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11016">434</a>, <span class="summarylocfmt"><a href="#wrglossary.17972">727</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsgetwidestsubname"><code class="csfmt">\glsgetwidestsubname</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11017">435</a>, <span class="summarylocfmt"><a href="#wrglossary.17974">727</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsgroupheading"><code class="csfmt">\glsgroupheading</code></a><span class="qquad"></span><a href="#wrglossary.9986">393</a>, <a href="#wrglossary.10175">398</a>–<a href="#wrglossary.10248">401</a>, <span class="summarylocfmt"><a href="#wrglossary.17977">727</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsgroupskip"><code class="csfmt">\glsgroupskip</code></a><span class="qquad"></span><a href="#wrglossary.9666">383</a>, <a href="#wrglossary.10903">428</a>, <span class="summarylocfmt"><a href="#wrglossary.17984">728</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glshasattribute"><code class="csfmt">\glshasattribute</code></a><span class="qquad"></span><a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.8868">354</a>, <a href="#wrglossary.12342">505</a>, <span class="summarylocfmt"><a href="#wrglossary.17991">728</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glshascategoryattribute"><code class="csfmt">\glshascategoryattribute</code></a><span class="qquad"></span><a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.8871">354</a>, <a href="#wrglossary.12338">505</a>, <span class="summarylocfmt"><a href="#wrglossary.17994">728</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glshashchar"><code class="csfmt">\glshashchar</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13082">535</a>, <span class="summarylocfmt"><a href="#wrglossary.17997">728</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glshex"><code class="csfmt">\glshex</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13078">535</a>, <span class="summarylocfmt"><a href="#wrglossary.18000">728</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glshyperlink"><code class="csfmt">\glshyperlink</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.18004">728</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glshypernumber"><code class="csfmt">\glshypernumber</code></a><span class="qquad"></span><a href="#wrglossary.888">29</a>, <a href="#wrglossary.13574">556</a>, <a href="#wrglossary.13640">560</a>, <a href="#wrglossary.14070">576</a>, <span class="summarylocfmt"><a href="#wrglossary.18007">729</a></span>, <a href="#wrglossary.18587">752</a>, <a href="#wrglossary.22109">894</a>, <a href="#wrglossary.23338">933</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsifapplyinnerfmtfield"><code class="csfmt">\glsifapplyinnerfmtfield</code></a><span class="qquad"></span><a href="#sec:innertextformat">§5.5.3</a>; <a href="#wrglossary.6251">244</a>, <span class="summarylocfmt"><a href="#wrglossary.18013">729</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsexclapplyinnerfmtfield"><code class="csfmt">\glsexclapplyinnerfmtfield</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsifattribute"><code class="csfmt">\glsifattribute</code></a><span class="qquad"></span><a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12350">505</a>, <span class="summarylocfmt"><a href="#wrglossary.18017">729</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsifattributetrue"><code class="csfmt">\glsifattributetrue</code></a><span class="qquad"></span><a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12364">506</a>, <span class="summarylocfmt"><a href="#wrglossary.18018">729</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsifcategory"><code class="csfmt">\glsifcategory</code></a><span class="qquad"></span><a href="#sec:categories">§10</a>; <a href="#wrglossary.12046">492</a>, <span class="summarylocfmt"><a href="#wrglossary.18020">729</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsifcategoryattribute"><code class="csfmt">\glsifcategoryattribute</code></a><span class="qquad"></span><a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12344">505</a>, <a href="#wrglossary.12351">506</a>, <span class="summarylocfmt"><a href="#wrglossary.18023">729</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsifcategoryattributehasitem"><code class="csfmt">\glsifcategoryattributehasitem</code></a><span class="qquad"></span><a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12366">507</a>, <span class="summarylocfmt"><a href="#wrglossary.18024">730</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsifcategoryattributetrue"><code class="csfmt">\glsifcategoryattributetrue</code></a><span class="qquad"></span><a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12363">506</a>, <span class="summarylocfmt"><a href="#wrglossary.18028">730</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsifindexed"><code class="csfmt">\glsifindexed</code></a><span class="qquad"></span><a href="#sec:wrglossary">§5.8</a>; <a href="#wrglossary.6919">264</a>, <span class="summarylocfmt"><a href="#wrglossary.18030">730</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsifnotregular"><code class="csfmt">\glsifnotregular</code></a><span class="qquad"></span><a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12361">506</a>, <span class="summarylocfmt"><a href="#wrglossary.18033">730</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsifnotregularcategory"><code class="csfmt">\glsifnotregularcategory</code></a><span class="qquad"></span><a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12354">506</a>, <span class="summarylocfmt"><a href="#wrglossary.18036">730</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsifplural"><code class="csfmt">\glsifplural</code></a><span class="qquad"></span><a href="#wrglossary.3529">142</a>, <a href="#wrglossary.3574">144</a>, <a href="#wrglossary.3723">150</a>, <a href="#wrglossary.3803">152</a>, <a href="#wrglossary.6515">254</a>, <a href="#wrglossary.8826">351</a>, <a href="#wrglossary.8835">352</a>, <span class="summarylocfmt"><a href="#wrglossary.18039">730</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsifregular"><code class="csfmt">\glsifregular</code></a><span class="qquad"></span><a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.6537">255</a>, <a href="#wrglossary.12359">506</a>, <a href="#wrglossary.17382">706</a>, <span class="summarylocfmt"><a href="#wrglossary.18047">731</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsifregularcategory"><code class="csfmt">\glsifregularcategory</code></a><span class="qquad"></span><a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12352">506</a>, <span class="summarylocfmt"><a href="#wrglossary.18049">731</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsignore"><code class="csfmt">\glsignore</code></a><span class="qquad"></span><a href="#wrglossary.6766">261</a>, <a href="#wrglossary.10796">424</a>, <a href="#wrglossary.12793">525</a>, <a href="#wrglossary.14377">601</a>, <span class="summarylocfmt"><a href="#wrglossary.18051">731</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a><span class="qquad"></span><a href="#wrglossary.9425">375</a>, <a href="#wrglossary.12434">510</a>, <span class="summarylocfmt"><a href="#wrglossary.18059">731</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsindexsubgroupitem"><code class="csfmt">\glsindexsubgroupitem</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.18063">731</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsinitreunsets"><code class="csfmt">\glsinitreunsets</code></a><span class="qquad"></span><a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4686">186</a>, <a href="#wrglossary.4762">189</a>, <a href="#wrglossary.7484">286</a>, <span class="summarylocfmt"><a href="#wrglossary.18067">731</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsinlinedescformat"><code class="csfmt">\glsinlinedescformat</code></a><span class="qquad"></span><a href="#wrglossary.10892">428</a>, <span class="summarylocfmt"><a href="#wrglossary.18072">732</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsinlinesubdescformat"><code class="csfmt">\glsinlinesubdescformat</code></a><span class="qquad"></span><a href="#wrglossary.10893">428</a>, <span class="summarylocfmt"><a href="#wrglossary.18075">732</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsinnerfmtabbrvfont"><code class="csfmt">\glsinnerfmtabbrvfont</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4187">167</a>, <a href="#wrglossary.4193">168</a>, <span class="summarylocfmt"><a href="#wrglossary.18078">732</a></span>, <a href="#wrglossary.19342">778</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsinnerfmtlongfont"><code class="csfmt">\glsinnerfmtlongfont</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4208">168</a>, <a href="#wrglossary.17843">721</a>, <span class="summarylocfmt"><a href="#wrglossary.18082">732</a></span>, <a href="#wrglossary.19347">779</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsinsert"><code class="csfmt">\glsinsert</code></a><span class="qquad"></span><a href="#wrglossary.1609">54</a>, <a href="#wrglossary.2774">105</a>, <a href="#wrglossary.3719">150</a>–<a href="#wrglossary.3799">152</a>, <a href="#wrglossary.4137">166</a>, <a href="#wrglossary.6466">253</a>, <a href="#wrglossary.6513">254</a>, <a href="#wrglossary.17907">723</a>, <span class="summarylocfmt"><a href="#wrglossary.18086">732</a></span>, <a href="#wrglossary.20056">807</a>, <a href="#wrglossary.21333">861</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtrsaveinsert"><code class="csfmt">\glsxtrsaveinsert</code></a> &amp; <a href="#glo:glsxtrfullsaveinsert"><code class="csfmt">\glsxtrfullsaveinsert</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glskeylisttok"><code class="csfmt">\glskeylisttok</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.3996">161</a>–<a href="#wrglossary.4066">163</a>, <span class="summarylocfmt"><a href="#wrglossary.18093">732</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a><span class="qquad"></span><a href="#wrglossary.3718">150</a>–<a href="#wrglossary.3798">152</a>, <a href="#wrglossary.4108">165</a>, <a href="#wrglossary.4136">166</a>, <a href="#wrglossary.5897">230</a>, <a href="#wrglossary.6232">243</a>, <a href="#wrglossary.6284">246</a>, <a href="#wrglossary.6487">254</a>, <a href="#wrglossary.6703">260</a>, <a href="#wrglossary.7485">286</a>, <a href="#wrglossary.12281">502</a>, <span class="summarylocfmt"><a href="#wrglossary.18096">732</a></span>, <a href="#wrglossary.19496">784</a>, <a href="#wrglossary.21173">855</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslabeltok"><code class="csfmt">\glslabeltok</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.3997">161</a>, <a href="#wrglossary.4071">163</a>–<a href="#wrglossary.4133">166</a>, <span class="summarylocfmt"><a href="#wrglossary.18102">733</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsletentryfield"><code class="csfmt">\glsletentryfield</code></a><span class="qquad"></span><a href="#wrglossary.7581">291</a>, <span class="summarylocfmt"><a href="#wrglossary.18104">733</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glslink"><code class="csfmt">\Glslink</code></a><span class="qquad"></span><a href="#wrglossary.13788">565</a>, <span class="summarylocfmt"><a href="#wrglossary.18108">733</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslink"><code class="csfmt">\glslink</code></a><span class="qquad"></span><a href="#wrglossary.4601">183</a>, <a href="#wrglossary.6017">235</a>, <a href="#wrglossary.6204">242</a>, <a href="#wrglossary.6433">252</a>, <a href="#wrglossary.6617">258</a>, <a href="#wrglossary.7696">296</a>, <a href="#wrglossary.13783">565</a>, <a href="#wrglossary.14358">600</a>, <a href="#wrglossary.16354">670</a>, <a href="#wrglossary.17283">703</a>, <span class="summarylocfmt"><a href="#wrglossary.18118">733</a></span>, <a href="#wrglossary.19907">803</a>, <a href="#wrglossary.20979">847</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslinkcheckfirsthyperhook"><code class="csfmt">\glslinkcheckfirsthyperhook</code></a><span class="qquad"></span><a href="#wrglossary.4711">186</a>, <a href="#wrglossary.7934">307</a>, <a href="#wrglossary.8126">316</a>, <a href="#wrglossary.8181">319</a>, <span class="summarylocfmt"><a href="#wrglossary.18129">733</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslinkpostsetkeys"><code class="csfmt">\glslinkpostsetkeys</code></a><span class="qquad"></span><a href="#wrglossary.4717">187</a>–<a href="#wrglossary.4797">190</a>, <a href="#wrglossary.7935">307</a>, <a href="#wrglossary.8214">320</a>, <span class="summarylocfmt"><a href="#wrglossary.18133">733</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslinkpresetkeys"><code class="csfmt">\glslinkpresetkeys</code></a><span class="qquad"></span><a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4712">187</a>–<a href="#wrglossary.4796">190</a>, <a href="#wrglossary.7936">307</a>, <a href="#wrglossary.8178">319</a>, <a href="#wrglossary.8208">320</a>, <a href="#wrglossary.13025">533</a>, <span class="summarylocfmt"><a href="#wrglossary.18137">734</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslinkwrcontent"><code class="csfmt">\glslinkwrcontent</code></a><span class="qquad"></span><a href="#sec:glsref">§5</a>; <a href="#wrglossary.4624">185</a>, <a href="#wrglossary.5903">230</a>, <a href="#wrglossary.17325">704</a>, <span class="summarylocfmt"><a href="#wrglossary.18141">734</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslistchildpostlocation"><code class="csfmt">\glslistchildpostlocation</code></a><span class="qquad"></span><a href="#sec:stylemodslist">§8.6.5.3</a>; <a href="#wrglossary.10934">429</a>, <span class="summarylocfmt"><a href="#wrglossary.18145">734</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslistchildprelocation"><code class="csfmt">\glslistchildprelocation</code></a><span class="qquad"></span><a href="#sec:stylemodslist">§8.6.5.3</a>; <a href="#wrglossary.10915">428</a>, <span class="summarylocfmt"><a href="#wrglossary.18149">734</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslistdesc"><code class="csfmt">\glslistdesc</code></a><span class="qquad"></span><a href="#sec:stylemodslist">§8.6.5.3</a>; <a href="#wrglossary.10917">429</a>, <span class="summarylocfmt"><a href="#wrglossary.18153">734</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslistdottedwidth"><code class="csfmt">\glslistdottedwidth</code></a><span class="qquad"></span><a href="#wrglossary.10936">429</a>, <span class="summarylocfmt"><a href="#wrglossary.18156">734</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslistexpandedname"><code class="csfmt">\glslistexpandedname</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.18159">734</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslistgroupafterheader"><code class="csfmt">\glslistgroupafterheader</code></a><span class="qquad"></span><a href="#sec:stylemodslist">§8.6.5.3</a>; <a href="#wrglossary.10929">429</a>, <span class="summarylocfmt"><a href="#wrglossary.18163">735</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslistgroupheaderitem"><code class="csfmt">\glslistgroupheaderitem</code></a><span class="qquad"></span><a href="#sec:stylemodslist">§8.6.5.3</a>; <a href="#wrglossary.10927">429</a>, <span class="summarylocfmt"><a href="#wrglossary.18167">735</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslistgroupskip"><code class="csfmt">\glslistgroupskip</code></a><span class="qquad"></span><a href="#sec:stylemodslist">§8.6.5.3</a>; <a href="#wrglossary.10939">430</a>, <span class="summarylocfmt"><a href="#wrglossary.18171">735</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslistinit"><code class="csfmt">\glslistinit</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.18174">735</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslistitem"><code class="csfmt">\glslistitem</code></a><span class="qquad"></span><a href="#sec:stylemodslist">§8.6.5.3</a>; <a href="#wrglossary.10922">429</a>, <span class="summarylocfmt"><a href="#wrglossary.18178">735</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslistprelocation"><code class="csfmt">\glslistprelocation</code></a><span class="qquad"></span><a href="#sec:stylemodslist">§8.6.5.3</a>; <a href="#wrglossary.10913">428</a>, <a href="#wrglossary.10916">429</a>, <span class="summarylocfmt"><a href="#wrglossary.18181">735</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslocalreset"><code class="csfmt">\glslocalreset</code></a><span class="qquad"></span><a href="#wrglossary.4849">191</a>, <a href="#wrglossary.7343">280</a>, <span class="summarylocfmt"><a href="#wrglossary.18185">735</a></span>, <a href="#wrglossary.21201">856</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsreset"><code class="csfmt">\glsreset</code></a>, <a href="#glo:glslocalunset"><code class="csfmt">\glslocalunset</code></a>, <a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a> &amp; <a href="#glo:GlsXtrIfUnusedOrUndefined"><code class="csfmt">\GlsXtrIfUnusedOrUndefined</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslocalresetall"><code class="csfmt">\glslocalresetall</code></a><span class="qquad"></span><a href="#wrglossary.7506">287</a>, <span class="summarylocfmt"><a href="#wrglossary.18188">736</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsreset"><code class="csfmt">\glsreset</code></a>, <a href="#glo:glslocalreset"><code class="csfmt">\glslocalreset</code></a>, <a href="#glo:glsresetall"><code class="csfmt">\glsresetall</code></a> &amp; <a href="#glo:glslocalunsetall"><code class="csfmt">\glslocalunsetall</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslocalreseteach"><code class="csfmt">\glslocalreseteach</code></a><span class="qquad"></span><a href="#sec:glsunset">§5.10</a>; <a href="#wrglossary.7362">281</a>, <span class="summarylocfmt"><a href="#wrglossary.18192">736</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsreset"><code class="csfmt">\glsreset</code></a>, <a href="#glo:glslocalreset"><code class="csfmt">\glslocalreset</code></a>, <a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a> &amp; <a href="#glo:GlsXtrIfUnusedOrUndefined"><code class="csfmt">\GlsXtrIfUnusedOrUndefined</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslocalunset"><code class="csfmt">\glslocalunset</code></a><span class="qquad"></span><a href="#wrglossary.7341">280</a>, <a href="#wrglossary.7423">283</a>–<a href="#wrglossary.7470">285</a>, <a href="#wrglossary.14833">617</a>, <span class="summarylocfmt"><a href="#wrglossary.18195">736</a></span>, <a href="#wrglossary.21205">856</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsunset"><code class="csfmt">\glsunset</code></a>, <a href="#glo:glslocalreset"><code class="csfmt">\glslocalreset</code></a>, <a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a> &amp; <a href="#glo:GlsXtrIfUnusedOrUndefined"><code class="csfmt">\GlsXtrIfUnusedOrUndefined</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslocalunsetall"><code class="csfmt">\glslocalunsetall</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.18198">736</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsunset"><code class="csfmt">\glsunset</code></a>, <a href="#glo:glslocalunset"><code class="csfmt">\glslocalunset</code></a>, <a href="#glo:glsunsetall"><code class="csfmt">\glsunsetall</code></a> &amp; <a href="#glo:glslocalresetall"><code class="csfmt">\glslocalresetall</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslocalunseteach"><code class="csfmt">\glslocalunseteach</code></a><span class="qquad"></span><a href="#sec:glsunset">§5.10</a>; <a href="#wrglossary.7361">281</a>, <span class="summarylocfmt"><a href="#wrglossary.18202">736</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsunset"><code class="csfmt">\glsunset</code></a>, <a href="#glo:glslocalreset"><code class="csfmt">\glslocalreset</code></a>, <a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a> &amp; <a href="#glo:GlsXtrIfUnusedOrUndefined"><code class="csfmt">\GlsXtrIfUnusedOrUndefined</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongaccessdisplay"><code class="csfmt">\glslongaccessdisplay</code></a><span class="qquad"></span><a href="#wrglossary.11838">481</a>, <a href="#wrglossary.11984">489</a>, <span class="summarylocfmt"><a href="#wrglossary.18205">736</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongdefaultfont"><code class="csfmt">\glslongdefaultfont</code></a><span class="qquad"></span><a href="#wrglossary.1878">65</a>, <a href="#wrglossary.2077">74</a>, <a href="#wrglossary.2245">81</a>, <a href="#wrglossary.2513">93</a>, <a href="#wrglossary.3284">133</a>, <a href="#wrglossary.3598">145</a>, <a href="#wrglossary.3664">148</a>, <a href="#wrglossary.3850">154</a>, <span class="summarylocfmt"><a href="#wrglossary.18208">736</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongemfont"><code class="csfmt">\glslongemfont</code></a><span class="qquad"></span><a href="#wrglossary.2186">79</a>, <a href="#wrglossary.2201">80</a>, <a href="#wrglossary.2357">86</a>, <a href="#wrglossary.2372">87</a>, <a href="#wrglossary.2625">98</a>, <a href="#wrglossary.2640">99</a>, <a href="#wrglossary.3943">158</a>, <a href="#wrglossary.5973">233</a>, <span class="summarylocfmt"><a href="#wrglossary.18210">737</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraDescAlign"><code class="csfmt">\glslongextraDescAlign</code></a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11238">446</a>, <a href="#wrglossary.11425">458</a>, <span class="summarylocfmt"><a href="#wrglossary.18212">737</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraDescFmt"><code class="csfmt">\glslongextraDescFmt</code></a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11233">446</a>, <span class="summarylocfmt"><a href="#wrglossary.18214">737</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraDescNameHeader"><code class="csfmt">\glslongextraDescNameHeader</code></a><span class="qquad"></span><a href="#sec:longextranamedesc">§8.7.2.1</a>; <a href="#wrglossary.11306">450</a>, <span class="summarylocfmt"><a href="#wrglossary.18218">737</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraDescNameTabularFooter"><code class="csfmt">\glslongextraDescNameTabularFooter</code></a><span class="qquad"></span><a href="#sec:longextranamedesc">§8.7.2.1</a>; <a href="#wrglossary.11304">450</a>, <span class="summarylocfmt"><a href="#wrglossary.18222">737</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraDescNameTabularHeader"><code class="csfmt">\glslongextraDescNameTabularHeader</code></a><span class="qquad"></span><a href="#sec:longextranamedesc">§8.7.2.1</a>; <a href="#wrglossary.11303">450</a>, <span class="summarylocfmt"><a href="#wrglossary.18225">737</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraDescSymHeader"><code class="csfmt">\glslongextraDescSymHeader</code></a><span class="qquad"></span><a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11421">458</a>, <span class="summarylocfmt"><a href="#wrglossary.18228">737</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraDescSymNameHeader"><code class="csfmt">\glslongextraDescSymNameHeader</code></a><span class="qquad"></span><a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11334">452</a>, <span class="summarylocfmt"><a href="#wrglossary.18232">738</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraDescSymNameTabularFooter"><code class="csfmt">\glslongextraDescSymNameTabularFooter</code></a><span class="qquad"></span><a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11332">452</a>, <span class="summarylocfmt"><a href="#wrglossary.18236">738</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraDescSymNameTabularHeader"><code class="csfmt">\glslongextraDescSymNameTabularHeader</code></a><span class="qquad"></span><a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11331">452</a>, <span class="summarylocfmt"><a href="#wrglossary.18239">738</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraDescSymTabularFooter"><code class="csfmt">\glslongextraDescSymTabularFooter</code></a><span class="qquad"></span><a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11419">458</a>, <span class="summarylocfmt"><a href="#wrglossary.18242">738</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraDescSymTabularHeader"><code class="csfmt">\glslongextraDescSymTabularHeader</code></a><span class="qquad"></span><a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11418">458</a>, <span class="summarylocfmt"><a href="#wrglossary.18245">738</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraGroupHeading"><code class="csfmt">\glslongextraGroupHeading</code></a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11272">448</a>, <span class="summarylocfmt"><a href="#wrglossary.18248">738</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraHeaderFmt"><code class="csfmt">\glslongextraHeaderFmt</code></a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11218">445</a>, <span class="summarylocfmt"><a href="#wrglossary.18251">738</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraLocationAlign"><code class="csfmt">\glslongextraLocationAlign</code></a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11259">447</a>, <span class="summarylocfmt"><a href="#wrglossary.18253">738</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraLocationDescNameHeader"><code class="csfmt">\glslongextraLocationDescNameHeader</code></a><span class="qquad"></span><a href="#sec:longextranamedescloc">§8.7.2.3</a>; <a href="#wrglossary.11356">453</a>, <span class="summarylocfmt"><a href="#wrglossary.18256">739</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraLocationDescNameTabularFooter"><code class="csfmt">\glslongextraLocationDescNameTabularFooter</code></a><span class="qquad"></span><a href="#sec:longextranamedescloc">§8.7.2.3</a>; <a href="#wrglossary.11354">453</a>, <span class="summarylocfmt"><a href="#wrglossary.18260">739</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraLocationDescNameTabularHeader"><code class="csfmt">\glslongextraLocationDescNameTabularHeader</code></a><span class="qquad"></span><a href="#sec:longextranamedescloc">§8.7.2.3</a>; <a href="#wrglossary.11353">453</a>, <span class="summarylocfmt"><a href="#wrglossary.18263">739</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraLocationDescSymNameHeader"><code class="csfmt">\glslongextraLocationDescSymNameHeader</code></a><span class="qquad"></span><a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11390">456</a>, <span class="summarylocfmt"><a href="#wrglossary.18266">739</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraLocationDescSymNameTabularFooter"><code class="csfmt">\glslongextraLocationDescSymNameTabularFooter</code></a><span class="qquad"></span><a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11388">456</a>, <span class="summarylocfmt"><a href="#wrglossary.18270">739</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraLocationDescSymNameTabularHeader"><code class="csfmt">\glslongextraLocationDescSymNameTabularHeader</code></a><span class="qquad"></span><a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11387">455</a>, <span class="summarylocfmt"><a href="#wrglossary.18273">739</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraLocationFmt"><code class="csfmt">\glslongextraLocationFmt</code></a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11255">447</a>, <span class="summarylocfmt"><a href="#wrglossary.18276">739</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraLocationSymDescNameHeader"><code class="csfmt">\glslongextraLocationSymDescNameHeader</code></a><span class="qquad"></span><a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11384">455</a>, <span class="summarylocfmt"><a href="#wrglossary.18280">740</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraLocationSymDescNameTabularFooter"><code class="csfmt">\glslongextraLocationSymDescNameTabularFooter</code></a><span class="qquad"></span><a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11382">455</a>, <span class="summarylocfmt"><a href="#wrglossary.18284">740</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraLocationSymDescNameTabularHeader"><code class="csfmt">\glslongextraLocationSymDescNameTabularHeader</code></a><span class="qquad"></span><a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11381">455</a>, <span class="summarylocfmt"><a href="#wrglossary.18287">740</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraLocSetDescWidth"><code class="csfmt">\glslongextraLocSetDescWidth</code></a><span class="qquad"></span><a href="#sec:longextranamedescloc">§8.7.2.3</a>; <a href="#wrglossary.11336">452</a>, <span class="summarylocfmt"><a href="#wrglossary.18290">740</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraLongFmt"><code class="csfmt">\glslongextraLongFmt</code></a><span class="qquad"></span><a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11448">459</a>, <span class="summarylocfmt"><a href="#wrglossary.18294">740</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraLongHeader"><code class="csfmt">\glslongextraLongHeader</code></a><span class="qquad"></span><a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11436">459</a>, <span class="summarylocfmt"><a href="#wrglossary.18298">740</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraLongShortHeader"><code class="csfmt">\glslongextraLongShortHeader</code></a><span class="qquad"></span><a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11480">461</a>, <span class="summarylocfmt"><a href="#wrglossary.18302">740</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraLongShortTabularFooter"><code class="csfmt">\glslongextraLongShortTabularFooter</code></a><span class="qquad"></span><a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11478">461</a>, <span class="summarylocfmt"><a href="#wrglossary.18306">740</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraLongShortTabularHeader"><code class="csfmt">\glslongextraLongShortTabularHeader</code></a><span class="qquad"></span><a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11477">461</a>, <span class="summarylocfmt"><a href="#wrglossary.18309">741</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraNameAlign"><code class="csfmt">\glslongextraNameAlign</code></a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11231">446</a>, <a href="#wrglossary.11424">458</a>, <span class="summarylocfmt"><a href="#wrglossary.18312">741</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraNameDescHeader"><code class="csfmt">\glslongextraNameDescHeader</code></a><span class="qquad"></span><a href="#sec:longextranamedesc">§8.7.2.1</a>; <a href="#wrglossary.11301">449</a>, <span class="summarylocfmt"><a href="#wrglossary.18314">741</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraNameDescLocationHeader"><code class="csfmt">\glslongextraNameDescLocationHeader</code></a><span class="qquad"></span><a href="#sec:longextranamedescloc">§8.7.2.3</a>; <a href="#wrglossary.11350">453</a>, <span class="summarylocfmt"><a href="#wrglossary.18318">741</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraNameDescLocationTabularFooter"><code class="csfmt">\glslongextraNameDescLocationTabularFooter</code></a><span class="qquad"></span><a href="#sec:longextranamedescloc">§8.7.2.3</a>; <a href="#wrglossary.11348">453</a>, <span class="summarylocfmt"><a href="#wrglossary.18322">741</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraNameDescLocationTabularHeader"><code class="csfmt">\glslongextraNameDescLocationTabularHeader</code></a><span class="qquad"></span><a href="#sec:longextranamedescloc">§8.7.2.3</a>; <a href="#wrglossary.11347">453</a>, <span class="summarylocfmt"><a href="#wrglossary.18325">741</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraNameDescSymHeader"><code class="csfmt">\glslongextraNameDescSymHeader</code></a><span class="qquad"></span><a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11319">451</a>, <span class="summarylocfmt"><a href="#wrglossary.18328">741</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraNameDescSymLocationHeader"><code class="csfmt">\glslongextraNameDescSymLocationHeader</code></a><span class="qquad"></span><a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11372">454</a>, <span class="summarylocfmt"><a href="#wrglossary.18332">742</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraNameDescSymLocationTabularFooter"><code class="csfmt">\glslongextraNameDescSymLocationTabularFooter</code></a><span class="qquad"></span><a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11370">454</a>, <span class="summarylocfmt"><a href="#wrglossary.18336">742</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraNameDescSymLocationTabularHeader"><code class="csfmt">\glslongextraNameDescSymLocationTabularHeader</code></a><span class="qquad"></span><a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11369">454</a>, <span class="summarylocfmt"><a href="#wrglossary.18339">742</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraNameDescSymTabularFooter"><code class="csfmt">\glslongextraNameDescSymTabularFooter</code></a><span class="qquad"></span><a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11317">450</a>, <span class="summarylocfmt"><a href="#wrglossary.18342">742</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraNameDescSymTabularHeader"><code class="csfmt">\glslongextraNameDescSymTabularHeader</code></a><span class="qquad"></span><a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11316">450</a>, <span class="summarylocfmt"><a href="#wrglossary.18345">742</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraNameDescTabularFooter"><code class="csfmt">\glslongextraNameDescTabularFooter</code></a><span class="qquad"></span><a href="#sec:longextranamedesc">§8.7.2.1</a>; <a href="#wrglossary.11299">449</a>, <span class="summarylocfmt"><a href="#wrglossary.18348">742</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraNameDescTabularHeader"><code class="csfmt">\glslongextraNameDescTabularHeader</code></a><span class="qquad"></span><a href="#sec:longextranamedesc">§8.7.2.1</a>; <a href="#wrglossary.11298">449</a>, <span class="summarylocfmt"><a href="#wrglossary.18351">742</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraNameFmt"><code class="csfmt">\glslongextraNameFmt</code></a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11226">446</a>, <span class="summarylocfmt"><a href="#wrglossary.18354">742</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraNameSymDescHeader"><code class="csfmt">\glslongextraNameSymDescHeader</code></a><span class="qquad"></span><a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11324">451</a>, <span class="summarylocfmt"><a href="#wrglossary.18357">743</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraNameSymDescLocationHeader"><code class="csfmt">\glslongextraNameSymDescLocationHeader</code></a><span class="qquad"></span><a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11378">455</a>, <span class="summarylocfmt"><a href="#wrglossary.18361">743</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraNameSymDescLocationTabularFooter"><code class="csfmt">\glslongextraNameSymDescLocationTabularFooter</code></a><span class="qquad"></span><a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11376">455</a>, <span class="summarylocfmt"><a href="#wrglossary.18365">743</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraNameSymDescLocationTabularHeader"><code class="csfmt">\glslongextraNameSymDescLocationTabularHeader</code></a><span class="qquad"></span><a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11375">454</a>, <span class="summarylocfmt"><a href="#wrglossary.18368">743</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraNameSymDescTabularFooter"><code class="csfmt">\glslongextraNameSymDescTabularFooter</code></a><span class="qquad"></span><a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11322">451</a>, <span class="summarylocfmt"><a href="#wrglossary.18371">743</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraNameSymDescTabularHeader"><code class="csfmt">\glslongextraNameSymDescTabularHeader</code></a><span class="qquad"></span><a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11321">451</a>, <span class="summarylocfmt"><a href="#wrglossary.18374">743</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSetDescWidth"><code class="csfmt">\glslongextraSetDescWidth</code></a><span class="qquad"></span><a href="#sec:longextranamedesc">§8.7.2.1</a>; <a href="#wrglossary.11289">449</a>, <a href="#wrglossary.11312">450</a>, <a href="#wrglossary.11340">452</a>, <span class="summarylocfmt"><a href="#wrglossary.18377">743</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSetWidest"><code class="csfmt">\glslongextraSetWidest</code></a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11245">447</a>, <a href="#wrglossary.11291">449</a>, <a href="#wrglossary.11310">450</a>, <a href="#wrglossary.11338">452</a>, <a href="#wrglossary.11360">454</a>, <span class="summarylocfmt"><a href="#wrglossary.18380">744</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraShortHeader"><code class="csfmt">\glslongextraShortHeader</code></a><span class="qquad"></span><a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11433">458</a>, <a href="#wrglossary.11468">460</a>, <span class="summarylocfmt"><a href="#wrglossary.18382">744</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraShortLongHeader"><code class="csfmt">\glslongextraShortLongHeader</code></a><span class="qquad"></span><a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11474">460</a>, <span class="summarylocfmt"><a href="#wrglossary.18386">744</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraShortLongTabularFooter"><code class="csfmt">\glslongextraShortLongTabularFooter</code></a><span class="qquad"></span><a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11472">460</a>, <span class="summarylocfmt"><a href="#wrglossary.18390">744</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraShortLongTabularHeader"><code class="csfmt">\glslongextraShortLongTabularHeader</code></a><span class="qquad"></span><a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11471">460</a>, <span class="summarylocfmt"><a href="#wrglossary.18393">744</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraShortNoNameSetDescWidth"><code class="csfmt">\glslongextraShortNoNameSetDescWidth</code></a><span class="qquad"></span><a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11466">460</a>, <span class="summarylocfmt"><a href="#wrglossary.18396">744</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraShortTargetFmt"><code class="csfmt">\glslongextraShortTargetFmt</code></a><span class="qquad"></span><a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11439">459</a>, <span class="summarylocfmt"><a href="#wrglossary.18401">744</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSubDescFmt"><code class="csfmt">\glslongextraSubDescFmt</code></a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11236">446</a>, <span class="summarylocfmt"><a href="#wrglossary.18405">744</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSubGroupHeading"><code class="csfmt">\glslongextraSubGroupHeading</code></a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11282">448</a>, <span class="summarylocfmt"><a href="#wrglossary.18409">745</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSubLocationFmt"><code class="csfmt">\glslongextraSubLocationFmt</code></a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11257">447</a>, <span class="summarylocfmt"><a href="#wrglossary.18412">745</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSubLongFmt"><code class="csfmt">\glslongextraSubLongFmt</code></a><span class="qquad"></span><a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11463">460</a>, <span class="summarylocfmt"><a href="#wrglossary.18416">745</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSubNameFmt"><code class="csfmt">\glslongextraSubNameFmt</code></a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11229">446</a>, <a href="#wrglossary.11252">447</a>, <a href="#wrglossary.11398">456</a>, <span class="summarylocfmt"><a href="#wrglossary.18420">745</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSubShortTargetFmt"><code class="csfmt">\glslongextraSubShortTargetFmt</code></a><span class="qquad"></span><a href="#sec:longextraabbr">§8.7.2.6</a>; <a href="#wrglossary.11455">459</a>, <span class="summarylocfmt"><a href="#wrglossary.18423">745</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSubSymbolFmt"><code class="csfmt">\glslongextraSubSymbolFmt</code></a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11266">448</a>, <span class="summarylocfmt"><a href="#wrglossary.18427">745</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSubSymbolOrName"><code class="csfmt">\glslongextraSubSymbolOrName</code></a><span class="qquad"></span><a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11402">457</a>, <span class="summarylocfmt"><a href="#wrglossary.18430">746</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSubSymbolTargetFmt"><code class="csfmt">\glslongextraSubSymbolTargetFmt</code></a><span class="qquad"></span><a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11397">456</a>, <a href="#wrglossary.11403">457</a>, <span class="summarylocfmt"><a href="#wrglossary.18432">746</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSymbolAlign"><code class="csfmt">\glslongextraSymbolAlign</code></a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11270">448</a>, <span class="summarylocfmt"><a href="#wrglossary.18434">746</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSymbolFmt"><code class="csfmt">\glslongextraSymbolFmt</code></a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11264">448</a>, <a href="#wrglossary.11396">456</a>, <span class="summarylocfmt"><a href="#wrglossary.18436">746</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSymbolNameAlign"><code class="csfmt">\glslongextraSymbolNameAlign</code></a><span class="qquad"></span><a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11392">456</a>, <span class="summarylocfmt"><a href="#wrglossary.18439">746</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSymbolOrName"><code class="csfmt">\glslongextraSymbolOrName</code></a><span class="qquad"></span><a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11401">456</a>, <span class="summarylocfmt"><a href="#wrglossary.18441">746</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSymbolTargetFmt"><code class="csfmt">\glslongextraSymbolTargetFmt</code></a><span class="qquad"></span><a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11395">456</a>, <span class="summarylocfmt"><a href="#wrglossary.18443">746</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSymDescHeader"><code class="csfmt">\glslongextraSymDescHeader</code></a><span class="qquad"></span><a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11415">457</a>, <span class="summarylocfmt"><a href="#wrglossary.18445">747</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSymDescNameHeader"><code class="csfmt">\glslongextraSymDescNameHeader</code></a><span class="qquad"></span><a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11329">452</a>, <span class="summarylocfmt"><a href="#wrglossary.18449">747</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSymDescNameTabularFooter"><code class="csfmt">\glslongextraSymDescNameTabularFooter</code></a><span class="qquad"></span><a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11327">451</a>, <span class="summarylocfmt"><a href="#wrglossary.18453">747</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSymDescNameTabularHeader"><code class="csfmt">\glslongextraSymDescNameTabularHeader</code></a><span class="qquad"></span><a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11326">451</a>, <span class="summarylocfmt"><a href="#wrglossary.18456">747</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSymDescTabularFooter"><code class="csfmt">\glslongextraSymDescTabularFooter</code></a><span class="qquad"></span><a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11413">457</a>, <span class="summarylocfmt"><a href="#wrglossary.18459">747</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSymDescTabularHeader"><code class="csfmt">\glslongextraSymDescTabularHeader</code></a><span class="qquad"></span><a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11412">457</a>, <span class="summarylocfmt"><a href="#wrglossary.18462">747</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSymLocSetDescWidth"><code class="csfmt">\glslongextraSymLocSetDescWidth</code></a><span class="qquad"></span><a href="#sec:longextranamedescsymloc">§8.7.2.4</a>; <a href="#wrglossary.11358">454</a>, <span class="summarylocfmt"><a href="#wrglossary.18465">747</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSymNoNameSetDescWidth"><code class="csfmt">\glslongextraSymNoNameSetDescWidth</code></a><span class="qquad"></span><a href="#sec:longextrasymdesc">§8.7.2.5</a>; <a href="#wrglossary.11404">457</a>, <span class="summarylocfmt"><a href="#wrglossary.18469">747</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraSymSetDescWidth"><code class="csfmt">\glslongextraSymSetDescWidth</code></a><span class="qquad"></span><a href="#sec:longextranamesymdesc">§8.7.2.2</a>; <a href="#wrglossary.11308">450</a>, <a href="#wrglossary.11362">454</a>, <span class="summarylocfmt"><a href="#wrglossary.18472">748</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraTabularVAlign"><code class="csfmt">\glslongextraTabularVAlign</code></a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11215">445</a>, <span class="summarylocfmt"><a href="#wrglossary.18475">748</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraUpdateWidest"><code class="csfmt">\glslongextraUpdateWidest</code></a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11249">447</a>, <span class="summarylocfmt"><a href="#wrglossary.18479">748</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongextraUpdateWidestChild"><code class="csfmt">\glslongextraUpdateWidestChild</code></a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11251">447</a>, <span class="summarylocfmt"><a href="#wrglossary.18481">748</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsLongExtraUseTabularfalse"><code class="csfmt">\GlsLongExtraUseTabularfalse</code></a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11204">445</a>, <span class="summarylocfmt"><a href="#wrglossary.18484">748</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsLongExtraUseTabulartrue"><code class="csfmt">\GlsLongExtraUseTabulartrue</code></a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11201">445</a>, <span class="summarylocfmt"><a href="#wrglossary.18487">748</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongfont"><code class="csfmt">\glslongfont</code></a><span class="qquad"></span><a href="#wrglossary.4209">168</a>, <a href="#wrglossary.4333">172</a>, <a href="#wrglossary.18084">732</a>, <span class="summarylocfmt"><a href="#wrglossary.18490">749</a></span>, <a href="#wrglossary.19346">779</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongfootnotefont"><code class="csfmt">\glslongfootnotefont</code></a><span class="qquad"></span><a href="#wrglossary.3014">115</a>, <a href="#wrglossary.3597">145</a>, <span class="summarylocfmt"><a href="#wrglossary.18491">749</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslonghyphenfont"><code class="csfmt">\glslonghyphenfont</code></a><span class="qquad"></span><a href="#wrglossary.1834">64</a>, <a href="#wrglossary.2735">103</a>, <a href="#wrglossary.2855">108</a>, <a href="#wrglossary.3663">148</a>, <span class="summarylocfmt"><a href="#wrglossary.18493">749</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongonlyfont"><code class="csfmt">\glslongonlyfont</code></a><span class="qquad"></span><a href="#wrglossary.2941">111</a>, <a href="#wrglossary.3849">154</a>, <span class="summarylocfmt"><a href="#wrglossary.18495">749</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongpltok"><code class="csfmt">\glslongpltok</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4038">162</a>, <a href="#wrglossary.4086">164</a>, <span class="summarylocfmt"><a href="#wrglossary.18497">749</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongpluralaccessdisplay"><code class="csfmt">\glslongpluralaccessdisplay</code></a><span class="qquad"></span><a href="#wrglossary.11846">482</a>, <a href="#wrglossary.11991">489</a>, <span class="summarylocfmt"><a href="#wrglossary.18499">749</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslongtok"><code class="csfmt">\glslongtok</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.3880">156</a>, <a href="#wrglossary.3999">161</a>, <a href="#wrglossary.4081">164</a>, <span class="summarylocfmt"><a href="#wrglossary.18502">749</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslonguserfont"><code class="csfmt">\glslonguserfont</code></a><span class="qquad"></span><a href="#wrglossary.2389">88</a>, <a href="#wrglossary.2657">100</a>, <a href="#wrglossary.3361">136</a>, <span class="summarylocfmt"><a href="#wrglossary.18505">749</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glslowercase"><code class="csfmt">\glslowercase</code></a><span class="qquad"></span><a href="#sec:lowercase">§5.2.2</a>; <a href="#wrglossary.5116">200</a>, <span class="summarylocfmt"><a href="#wrglossary.18507">750</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.18510">750</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsmfuaddmap"><code class="csfmt">\glsmfuaddmap</code></a><span class="qquad"></span><a href="#sec:firstuc">§5.2.1</a>; <a href="#wrglossary.5100">199</a>, <a href="#wrglossary.7635">292</a>, <a href="#wrglossary.13826">567</a>, <span class="summarylocfmt"><a href="#wrglossary.18515">750</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsmfublocker"><code class="csfmt">\glsmfublocker</code></a><span class="qquad"></span><a href="#sec:firstuc">§5.2.1</a>; <a href="#wrglossary.5079">199</a>, <a href="#wrglossary.13827">567</a>, <span class="summarylocfmt"><a href="#wrglossary.18521">750</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsmfuexcl"><code class="csfmt">\glsmfuexcl</code></a><span class="qquad"></span><a href="#sec:firstuc">§5.2.1</a>; <a href="#wrglossary.5060">198</a>, <a href="#wrglossary.5082">199</a>, <span class="summarylocfmt"><a href="#wrglossary.18527">750</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSname"><code class="csfmt">\GLSname</code></a><span class="qquad"></span><a href="#wrglossary.2222">81</a>, <a href="#wrglossary.2421">89</a>, <a href="#wrglossary.2456">91</a>, <a href="#wrglossary.2488">93</a>, <a href="#wrglossary.2687">101</a>, <a href="#wrglossary.2723">103</a>, <a href="#wrglossary.5437">212</a>, <span class="summarylocfmt"><a href="#wrglossary.18532">750</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsname"><code class="csfmt">\Glsname</code></a><span class="qquad"></span><a href="#wrglossary.5433">212</a>, <a href="#wrglossary.9141">365</a>, <span class="summarylocfmt"><a href="#wrglossary.18540">751</a></span>, <a href="#wrglossary.22485">909</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsname"><code class="csfmt">\glsname</code></a><span class="qquad"></span><a href="#wrglossary.5430">212</a>, <a href="#wrglossary.8843">352</a>, <a href="#wrglossary.9136">365</a>, <a href="#wrglossary.14632">608</a>, <a href="#wrglossary.18537">750</a>, <span class="summarylocfmt"><a href="#wrglossary.18549">751</a></span>, <a href="#wrglossary.22493">909</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsnameaccessdisplay"><code class="csfmt">\glsnameaccessdisplay</code></a><span class="qquad"></span><a href="#wrglossary.11750">477</a>, <a href="#wrglossary.11907">485</a>, <span class="summarylocfmt"><a href="#wrglossary.18559">751</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsnamefont"><code class="csfmt">\glsnamefont</code></a><span class="qquad"></span><a href="#wrglossary.10569">415</a>, <a href="#wrglossary.10687">419</a>, <a href="#wrglossary.11427">458</a>, <a href="#wrglossary.11657">473</a>, <a href="#wrglossary.12248">501</a>, <span class="summarylocfmt"><a href="#wrglossary.18562">751</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsnextpages"><code class="csfmt">\glsnextpages</code></a><span class="qquad"></span><a href="#wrglossary.10577">415</a>, <span class="summarylocfmt"><a href="#wrglossary.18568">751</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsnoexpandfields"><code class="csfmt">\glsnoexpandfields</code></a><span class="qquad"></span><a href="#wrglossary.5257">205</a>, <a href="#wrglossary.13463">553</a>, <span class="summarylocfmt"><a href="#wrglossary.18573">751</a></span>, <a href="#wrglossary.18811">760</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsnoidxdisplayloc"><code class="csfmt">\glsnoidxdisplayloc</code></a><span class="qquad"></span><a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.10805">424</a>, <a href="#wrglossary.13565">556</a>, <span class="summarylocfmt"><a href="#wrglossary.18576">751</a></span>, <a href="#wrglossary.19774">797</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsnonextpages"><code class="csfmt">\glsnonextpages</code></a><span class="qquad"></span><a href="#wrglossary.10576">415</a>, <span class="summarylocfmt"><a href="#wrglossary.18578">752</a></span>, <a href="#wrglossary.18747">757</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsnumberformat"><code class="csfmt">\glsnumberformat</code></a><span class="qquad"></span><a href="#wrglossary.4746">188</a>, <a href="#wrglossary.14451">602</a>, <span class="summarylocfmt"><a href="#wrglossary.18583">752</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsnumbersgroupname"><code class="csfmt">\glsnumbersgroupname</code></a><span class="qquad"></span><a href="#wrglossary.10841">426</a>, <span class="summarylocfmt"><a href="#wrglossary.18591">752</a></span>, <a href="#wrglossary.23797">948</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glspagelistwidth"><code class="csfmt">\glspagelistwidth</code></a><span class="qquad"></span><a href="#wrglossary.11260">447</a>, <a href="#wrglossary.11342">452</a>, <a href="#wrglossary.11364">454</a>, <span class="summarylocfmt"><a href="#wrglossary.18596">752</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glspar"><code class="csfmt">\glspar</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.18601">752</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glspdffmtfull"><code class="csfmt">\glspdffmtfull</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5401">210</a>, <a href="#wrglossary.5411">211</a>, <a href="#wrglossary.17878">722</a>, <a href="#wrglossary.17886">723</a>, <span class="summarylocfmt"><a href="#wrglossary.18604">752</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glspdffmtfullpl"><code class="csfmt">\glspdffmtfullpl</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5405">210</a>, <a href="#wrglossary.5421">211</a>, <a href="#wrglossary.17890">723</a>, <span class="summarylocfmt"><a href="#wrglossary.18608">753</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glspercentchar"><code class="csfmt">\glspercentchar</code></a><span class="qquad"></span><a href="#wrglossary.12277">502</a>, <span class="summarylocfmt"><a href="#wrglossary.18612">753</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.18614">753</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.18622">753</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glspl"><code class="csfmt">\glspl</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.18632">753</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSplural"><code class="csfmt">\GLSplural</code></a><span class="qquad"></span><a href="#wrglossary.5457">213</a>, <span class="summarylocfmt"><a href="#wrglossary.18638">753</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsplural"><code class="csfmt">\Glsplural</code></a><span class="qquad"></span><a href="#wrglossary.5453">213</a>, <span class="summarylocfmt"><a href="#wrglossary.18650">753</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsplural"><code class="csfmt">\glsplural</code></a><span class="qquad"></span><a href="#wrglossary.1318">43</a>, <a href="#wrglossary.1419">47</a>, <a href="#wrglossary.2221">81</a>, <a href="#wrglossary.4647">185</a>, <a href="#wrglossary.4853">191</a>, <a href="#wrglossary.5450">213</a>, <a href="#wrglossary.6161">240</a>, <a href="#wrglossary.6437">252</a>, <a href="#wrglossary.12098">495</a>, <a href="#wrglossary.18044">731</a>, <a href="#wrglossary.18643">753</a>, <span class="summarylocfmt"><a href="#wrglossary.18664">754</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glspluralaccessdisplay"><code class="csfmt">\glspluralaccessdisplay</code></a><span class="qquad"></span><a href="#wrglossary.11766">478</a>, <a href="#wrglossary.11921">485</a>, <span class="summarylocfmt"><a href="#wrglossary.18678">754</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a><span class="qquad"></span><a href="#wrglossary.1056">35</a>, <a href="#wrglossary.1064">36</a>, <a href="#wrglossary.1331">43</a>, <a href="#wrglossary.1345">44</a>, <a href="#wrglossary.4022">162</a>, <a href="#wrglossary.14582">606</a>, <a href="#wrglossary.14647">608</a>, <span class="summarylocfmt"><a href="#wrglossary.18681">754</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a><span class="qquad"></span><a href="#wrglossary.261">12</a>, <a href="#wrglossary.276">13</a>, <a href="#wrglossary.10713">421</a>–<a href="#wrglossary.10769">423</a>, <a href="#wrglossary.10869">427</a>, <a href="#wrglossary.10889">428</a>, <a href="#wrglossary.14468">603</a>, <a href="#wrglossary.14554">605</a>, <span class="summarylocfmt"><a href="#wrglossary.18684">754</a></span>, <a href="#wrglossary.21116">853</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glspostinline"><code class="csfmt">\glspostinline</code></a><span class="qquad"></span><a href="#wrglossary.10890">428</a>, <span class="summarylocfmt"><a href="#wrglossary.18691">754</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glspostinlinedescformat"><code class="csfmt">\glspostinlinedescformat</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.18694">755</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glspostinlinesubdescformat"><code class="csfmt">\glspostinlinesubdescformat</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.18697">755</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glspostlinkhook"><code class="csfmt">\glspostlinkhook</code></a><span class="qquad"></span><a href="#wrglossary.6290">246</a>, <a href="#wrglossary.8769">347</a>, <a href="#wrglossary.8807">349</a>, <a href="#wrglossary.14479">603</a>, <span class="summarylocfmt"><a href="#wrglossary.18700">755</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsprefixsep"><code class="csfmt">\glsprefixsep</code></a><span class="qquad"></span><a href="#wrglossary.1618">55</a>, <span class="summarylocfmt"><a href="#wrglossary.18707">755</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.18709">755</a></span>, <a href="#wrglossary.23841">949</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glspretopostlink"><code class="csfmt">\glspretopostlink</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6381">250</a>, <span class="summarylocfmt"><a href="#wrglossary.18715">755</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsps"><code class="csfmt">\glsps</code></a><span class="qquad"></span><a href="#sec:nested">§5.4</a>; <a href="#wrglossary.5936">231</a>, <a href="#wrglossary.5966">233</a>, <a href="#wrglossary.8473">332</a>, <span class="summarylocfmt"><a href="#wrglossary.18718">756</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glspt"><code class="csfmt">\glspt</code></a><span class="qquad"></span><a href="#sec:nested">§5.4</a>; <a href="#wrglossary.5938">231</a>, <span class="summarylocfmt"><a href="#wrglossary.18721">756</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsrefentry"><code class="csfmt">\glsrefentry</code></a><span class="qquad"></span><a href="#wrglossary.9489">377</a>, <a href="#wrglossary.10599">416</a>, <span class="summarylocfmt"><a href="#wrglossary.18724">756</a></span>, <a href="#wrglossary.21079">851</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsrenewcommand"><code class="csfmt">\glsrenewcommand</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13958">572</a>, <span class="summarylocfmt"><a href="#wrglossary.18730">756</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsreset"><code class="csfmt">\glsreset</code></a><span class="qquad"></span><a href="#wrglossary.4850">191</a>, <a href="#wrglossary.7342">280</a>, <a href="#wrglossary.7922">307</a>, <span class="summarylocfmt"><a href="#wrglossary.18733">756</a></span>, <a href="#wrglossary.21222">857</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glslocalreset"><code class="csfmt">\glslocalreset</code></a>, <a href="#glo:glsunset"><code class="csfmt">\glsunset</code></a>, <a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a> &amp; <a href="#glo:GlsXtrIfUnusedOrUndefined"><code class="csfmt">\GlsXtrIfUnusedOrUndefined</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsresetall"><code class="csfmt">\glsresetall</code></a><span class="qquad"></span><a href="#wrglossary.7356">280</a>, <span class="summarylocfmt"><a href="#wrglossary.18736">756</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsreset"><code class="csfmt">\glsreset</code></a>, <a href="#glo:glsunsetall"><code class="csfmt">\glsunsetall</code></a>, <a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a> &amp; <a href="#glo:GlsXtrIfUnusedOrUndefined"><code class="csfmt">\GlsXtrIfUnusedOrUndefined</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsresetcurrcountfalse"><code class="csfmt">\glsresetcurrcountfalse</code></a><span class="qquad"></span><a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.7923">307</a>, <a href="#wrglossary.7954">308</a>, <span class="summarylocfmt"><a href="#wrglossary.18738">756</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsresetcurrcounttrue"><code class="csfmt">\glsresetcurrcounttrue</code></a><span class="qquad"></span><a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.7953">308</a>, <span class="summarylocfmt"><a href="#wrglossary.18741">757</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsresetentrylist"><code class="csfmt">\glsresetentrylist</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.18744">757</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glssee"><code class="csfmt">\glssee</code></a><span class="qquad"></span><a href="#wrglossary.570">21</a>, <a href="#wrglossary.588">22</a>, <a href="#wrglossary.708">24</a>, <a href="#wrglossary.967">33</a>, <a href="#wrglossary.1110">37</a>, <a href="#wrglossary.4670">186</a>, <a href="#wrglossary.6656">259</a>, <a href="#wrglossary.6948">265</a>–<a href="#wrglossary.7024">267</a>, <a href="#wrglossary.7123">270</a>, <a href="#wrglossary.7171">272</a>, <a href="#wrglossary.7289">278</a>, <a href="#wrglossary.14667">609</a>, <span class="summarylocfmt"><a href="#wrglossary.18748">757</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtrindexseealso"><code class="csfmt">\glsxtrindexseealso</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsseefirstitem"><code class="csfmt">\glsseefirstitem</code></a><span class="qquad"></span><a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7791">300</a>, <span class="summarylocfmt"><a href="#wrglossary.18751">757</a></span>, <a href="#wrglossary.18780">758</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsseeitem"><code class="csfmt">\glsseeitem</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsseeformat"><code class="csfmt">\glsseeformat</code></a><span class="qquad"></span><a href="#wrglossary.7277">278</a>, <a href="#wrglossary.7769">299</a>, <span class="summarylocfmt"><a href="#wrglossary.18754">757</a></span>, <a href="#wrglossary.22074">892</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsseeitem"><code class="csfmt">\glsseeitem</code></a><span class="qquad"></span><a href="#wrglossary.7773">299</a>–<a href="#wrglossary.7797">301</a>, <span class="summarylocfmt"><a href="#wrglossary.18761">757</a></span>, <a href="#wrglossary.18775">758</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsseefirstitem"><code class="csfmt">\glsseefirstitem</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsseeitemformat"><code class="csfmt">\glsseeitemformat</code></a><span class="qquad"></span><a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7612">292</a>, <a href="#wrglossary.7779">300</a>, <span class="summarylocfmt"><a href="#wrglossary.18764">757</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsseelastoxfordsep"><code class="csfmt">\glsseelastoxfordsep</code></a><span class="qquad"></span><a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7802">301</a>, <span class="summarylocfmt"><a href="#wrglossary.18767">758</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsseelastsep"><code class="csfmt">\glsseelastsep</code></a> &amp; <a href="#glo:glsseelastoxfordsep"><code class="csfmt">\glsseelastoxfordsep</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsseelastsep"><code class="csfmt">\glsseelastsep</code></a><span class="qquad"></span><a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7799">301</a>, <a href="#wrglossary.16117">662</a>, <span class="summarylocfmt"><a href="#wrglossary.18770">758</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsseelastsep"><code class="csfmt">\glsseelastsep</code></a> &amp; <a href="#glo:glsseelastoxfordsep"><code class="csfmt">\glsseelastoxfordsep</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsseelist"><code class="csfmt">\glsseelist</code></a><span class="qquad"></span><a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7766">299</a>, <a href="#wrglossary.7778">300</a>, <a href="#wrglossary.7820">302</a>, <a href="#wrglossary.18753">757</a>, <span class="summarylocfmt"><a href="#wrglossary.18773">758</a></span>, <a href="#wrglossary.21380">863</a>, <a href="#wrglossary.21728">877</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtrseelist"><code class="csfmt">\glsxtrseelist</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsseesep"><code class="csfmt">\glsseesep</code></a><span class="qquad"></span><a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7798">301</a>, <span class="summarylocfmt"><a href="#wrglossary.18783">758</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsseelastsep"><code class="csfmt">\glsseelastsep</code></a> &amp; <a href="#glo:glsseelastoxfordsep"><code class="csfmt">\glsseelastoxfordsep</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glssentencecase"><code class="csfmt">\glssentencecase</code></a><span class="qquad"></span><a href="#sec:firstuc">§5.2.1</a>; <a href="#wrglossary.5011">197</a>, <a href="#wrglossary.5046">198</a>, <a href="#wrglossary.17273">702</a>, <a href="#wrglossary.18115">733</a>, <span class="summarylocfmt"><a href="#wrglossary.18786">758</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glssetabbrvfmt"><code class="csfmt">\glssetabbrvfmt</code></a><span class="qquad"></span><a href="#sec:advancedabbrstylecmds">§4.5.2</a>; <a href="#wrglossary.3948">159</a>, <a href="#wrglossary.4279">170</a>, <a href="#wrglossary.6536">255</a>, <a href="#wrglossary.16267">668</a>, <a href="#wrglossary.17379">706</a>, <span class="summarylocfmt"><a href="#wrglossary.18792">758</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glssetattribute"><code class="csfmt">\glssetattribute</code></a><span class="qquad"></span><a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12331">504</a>, <span class="summarylocfmt"><a href="#wrglossary.18793">759</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glssetcategoriesattribute"><code class="csfmt">\glssetcategoriesattribute</code></a><span class="qquad"></span><a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12328">504</a>, <span class="summarylocfmt"><a href="#wrglossary.18794">759</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glssetcategoriesattributes"><code class="csfmt">\glssetcategoriesattributes</code></a><span class="qquad"></span><a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12330">504</a>, <span class="summarylocfmt"><a href="#wrglossary.18796">759</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glssetcategoryattribute"><code class="csfmt">\glssetcategoryattribute</code></a><span class="qquad"></span><a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12327">504</a>, <a href="#wrglossary.12781">524</a>, <span class="summarylocfmt"><a href="#wrglossary.18798">759</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glssetcategoryattributes"><code class="csfmt">\glssetcategoryattributes</code></a><span class="qquad"></span><a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12329">504</a>, <span class="summarylocfmt"><a href="#wrglossary.18799">759</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glssetcombinedsepabbrvnbsp"><code class="csfmt">\glssetcombinedsepabbrvnbsp</code></a><span class="qquad"></span><a href="#sec:mglssep">§7.4</a>; <a href="#wrglossary.8707">345</a>, <span class="summarylocfmt"><a href="#wrglossary.18801">759</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glssetcombinedsepabbrvnone"><code class="csfmt">\glssetcombinedsepabbrvnone</code></a><span class="qquad"></span><a href="#sec:mglssep">§7.4</a>; <a href="#wrglossary.8733">345</a>, <span class="summarylocfmt"><a href="#wrglossary.18804">759</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glssetcombinedsepnarrow"><code class="csfmt">\glssetcombinedsepnarrow</code></a><span class="qquad"></span><a href="#sec:mglssep">§7.4</a>; <a href="#wrglossary.8758">346</a>, <span class="summarylocfmt"><a href="#wrglossary.18806">760</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glssetexpandfield"><code class="csfmt">\glssetexpandfield</code></a><span class="qquad"></span><a href="#wrglossary.18575">751</a>, <span class="summarylocfmt"><a href="#wrglossary.18808">760</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glssetnoexpandfield"><code class="csfmt">\glssetnoexpandfield</code></a><span class="qquad"></span><a href="#wrglossary.17607">713</a>, <span class="summarylocfmt"><a href="#wrglossary.18812">760</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glssetregularcategory"><code class="csfmt">\glssetregularcategory</code></a><span class="qquad"></span><a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12332">504</a>, <span class="summarylocfmt"><a href="#wrglossary.18816">760</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glssetwidest"><code class="csfmt">\glssetwidest</code></a><span class="qquad"></span><a href="#wrglossary.11007">434</a>, <a href="#wrglossary.11246">447</a>, <a href="#wrglossary.11487">461</a>, <a href="#wrglossary.13479">554</a>, <a href="#wrglossary.15474">645</a>, <a href="#wrglossary.16391">671</a>, <a href="#wrglossary.16443">674</a>, <span class="summarylocfmt"><a href="#wrglossary.18818">760</a></span>, <a href="#wrglossary.19157">774</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsshortaccessdisplay"><code class="csfmt">\glsshortaccessdisplay</code></a><span class="qquad"></span><a href="#wrglossary.11822">481</a>, <a href="#wrglossary.11970">488</a>, <span class="summarylocfmt"><a href="#wrglossary.18821">760</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsshortaccsupp"><code class="csfmt">\glsshortaccsupp</code></a><span class="qquad"></span><a href="#wrglossary.17616">713</a>, <span class="summarylocfmt"><a href="#wrglossary.18824">760</a></span>, <a href="#wrglossary.21261">858</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsshortpltok"><code class="csfmt">\glsshortpltok</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4037">162</a>, <a href="#wrglossary.4078">164</a>, <a href="#wrglossary.4182">167</a>, <span class="summarylocfmt"><a href="#wrglossary.18827">761</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsshortpluralaccessdisplay"><code class="csfmt">\glsshortpluralaccessdisplay</code></a><span class="qquad"></span><a href="#wrglossary.11830">481</a>, <a href="#wrglossary.11977">488</a>, <span class="summarylocfmt"><a href="#wrglossary.18829">761</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsshorttok"><code class="csfmt">\glsshorttok</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.3595">145</a>, <a href="#wrglossary.3998">161</a>, <a href="#wrglossary.4029">162</a>, <a href="#wrglossary.4073">164</a>, <a href="#wrglossary.4181">167</a>, <span class="summarylocfmt"><a href="#wrglossary.18832">761</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsshowtarget"><code class="csfmt">\glsshowtarget</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.18835">761</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsshowtargetfont"><code class="csfmt">\glsshowtargetfont</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.18841">761</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsshowtargetfonttext"><code class="csfmt">\glsshowtargetfonttext</code></a><span class="qquad"></span><a href="#wrglossary.858">28</a>, <span class="summarylocfmt"><a href="#wrglossary.18843">761</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsshowtargetinner"><code class="csfmt">\glsshowtargetinner</code></a><span class="qquad"></span><a href="#wrglossary.889">29</a>, <a href="#wrglossary.903">30</a>, <a href="#wrglossary.18839">761</a>, <span class="summarylocfmt"><a href="#wrglossary.18846">762</a></span>, <a href="#wrglossary.21638">872</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsshowtargetinnersymleft"><code class="csfmt">\glsshowtargetinnersymleft</code></a><span class="qquad"></span><a href="#sec:debuggingopts">§2.5</a>; <a href="#wrglossary.906">30</a>, <span class="summarylocfmt"><a href="#wrglossary.18850">762</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsshowtargetinnersymright"><code class="csfmt">\glsshowtargetinnersymright</code></a><span class="qquad"></span><a href="#sec:debuggingopts">§2.5</a>; <a href="#wrglossary.908">30</a>, <span class="summarylocfmt"><a href="#wrglossary.18853">762</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsshowtargetouter"><code class="csfmt">\glsshowtargetouter</code></a><span class="qquad"></span><a href="#wrglossary.890">29</a>, <a href="#wrglossary.899">30</a>, <a href="#wrglossary.18840">761</a>, <span class="summarylocfmt"><a href="#wrglossary.18856">762</a></span>, <a href="#wrglossary.21642">873</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsshowtargetsymbol"><code class="csfmt">\glsshowtargetsymbol</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.18861">762</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glssubentryitem"><code class="csfmt">\glssubentryitem</code></a><span class="qquad"></span><a href="#wrglossary.10553">414</a>, <span class="summarylocfmt"><a href="#wrglossary.18863">762</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glssubgroupheading"><code class="csfmt">\glssubgroupheading</code></a><span class="qquad"></span><a href="#sec:printunsrtgroups">§8.4.1</a>; <a href="#wrglossary.9985">393</a>, <a href="#wrglossary.9994">394</a>, <a href="#wrglossary.10224">400</a>, <a href="#wrglossary.10249">401</a>, <span class="summarylocfmt"><a href="#wrglossary.18866">762</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSsymbol"><code class="csfmt">\GLSsymbol</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.18873">763</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glssymbol"><code class="csfmt">\Glssymbol</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.18881">763</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glssymbol"><code class="csfmt">\glssymbol</code></a><span class="qquad"></span><a href="#wrglossary.9152">365</a>, <a href="#wrglossary.9159">366</a>, <a href="#wrglossary.14703">610</a>, <span class="summarylocfmt"><a href="#wrglossary.18890">763</a></span>, <a href="#wrglossary.22567">912</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glssymbolaccessdisplay"><code class="csfmt">\glssymbolaccessdisplay</code></a><span class="qquad"></span><a href="#wrglossary.10589">416</a>, <a href="#wrglossary.11790">479</a>, <a href="#wrglossary.11942">486</a>, <span class="summarylocfmt"><a href="#wrglossary.18900">763</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glssymbolplural"><code class="csfmt">\glssymbolplural</code></a><span class="qquad"></span><a href="#wrglossary.14711">611</a>, <span class="summarylocfmt"><a href="#wrglossary.18903">763</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glssymbolpluralaccessdisplay"><code class="csfmt">\glssymbolpluralaccessdisplay</code></a><span class="qquad"></span><a href="#wrglossary.11798">479</a>, <a href="#wrglossary.11949">487</a>, <span class="summarylocfmt"><a href="#wrglossary.18910">763</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glssymbolsgroupname"><code class="csfmt">\glssymbolsgroupname</code></a><span class="qquad"></span><a href="#wrglossary.10840">426</a>, <span class="summarylocfmt"><a href="#wrglossary.18913">764</a></span>, <a href="#wrglossary.23849">950</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstabledescheader"><code class="csfmt">\glstabledescheader</code></a><span class="qquad"></span><a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11596">469</a>, <span class="summarylocfmt"><a href="#wrglossary.18918">764</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstableiffilter"><code class="csfmt">\glstableiffilter</code></a><span class="qquad"></span><a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11573">468</a>, <span class="summarylocfmt"><a href="#wrglossary.18920">764</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstablenameheader"><code class="csfmt">\glstablenameheader</code></a><span class="qquad"></span><a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11594">469</a>, <span class="summarylocfmt"><a href="#wrglossary.18923">764</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstableotherheader"><code class="csfmt">\glstableotherheader</code></a><span class="qquad"></span><a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11604">470</a>, <span class="summarylocfmt"><a href="#wrglossary.18925">764</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstablesymbolheader"><code class="csfmt">\glstablesymbolheader</code></a><span class="qquad"></span><a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11600">469</a>, <span class="summarylocfmt"><a href="#wrglossary.18927">764</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstarget"><code class="csfmt">\glstarget</code></a><span class="qquad"></span><a href="#wrglossary.887">29</a>, <a href="#wrglossary.6571">256</a>, <a href="#wrglossary.9580">379</a>, <a href="#wrglossary.10564">415</a>, <a href="#wrglossary.12284">502</a>, <span class="summarylocfmt"><a href="#wrglossary.18929">764</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLStext"><code class="csfmt">\GLStext</code></a><span class="qquad"></span><a href="#wrglossary.5222">204</a>, <a href="#wrglossary.5447">212</a>, <a href="#wrglossary.17109">697</a>, <a href="#wrglossary.17152">698</a>, <span class="summarylocfmt"><a href="#wrglossary.18933">765</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glstext"><code class="csfmt">\Glstext</code></a><span class="qquad"></span><a href="#wrglossary.5443">212</a>, <a href="#wrglossary.17108">697</a>, <a href="#wrglossary.17149">698</a>, <span class="summarylocfmt"><a href="#wrglossary.18945">765</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstext"><code class="csfmt">\glstext</code></a><span class="qquad"></span><a href="#wrglossary.97">5</a>, <a href="#wrglossary.654">23</a>, <a href="#wrglossary.1108">37</a>, <a href="#wrglossary.1317">43</a>, <a href="#wrglossary.1418">47</a>, <a href="#wrglossary.1496">51</a>, <a href="#wrglossary.2220">81</a>, <a href="#wrglossary.4600">183</a>, <a href="#wrglossary.4646">185</a>, <a href="#wrglossary.4852">191</a>, <a href="#wrglossary.4872">192</a>, <a href="#wrglossary.5173">201</a>, <a href="#wrglossary.5215">204</a>, <a href="#wrglossary.5440">212</a>, <a href="#wrglossary.6008">234</a>, <a href="#wrglossary.6159">240</a>, <a href="#wrglossary.6243">244</a>, <a href="#wrglossary.6436">252</a>, <a href="#wrglossary.7409">282</a>, <a href="#wrglossary.8180">319</a>, <a href="#wrglossary.9099">364</a>, <a href="#wrglossary.12087">495</a>, <a href="#wrglossary.12474">511</a>, <a href="#wrglossary.14357">600</a>, <a href="#wrglossary.17107">697</a>, <a href="#wrglossary.17146">698</a>, <span class="summarylocfmt"><a href="#wrglossary.18959">765</a></span>, <a href="#wrglossary.22449">908</a>, <a href="#wrglossary.22558">911</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:glstextlike"><code class="csfmt">\glstext</code>-like</dfn><span class="qquad"></span><span class="termslocfmt"><a href="#wrglossary.14356">600</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstextaccessdisplay"><code class="csfmt">\glstextaccessdisplay</code></a><span class="qquad"></span><a href="#wrglossary.11758">478</a>, <a href="#wrglossary.11914">485</a>, <span class="summarylocfmt"><a href="#wrglossary.18973">765</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstextformat"><code class="csfmt">\glstextformat</code></a><span class="qquad"></span><a href="#wrglossary.4820">190</a>, <a href="#wrglossary.4825">191</a>, <a href="#wrglossary.6102">238</a>, <a href="#wrglossary.6108">239</a>, <a href="#wrglossary.6488">254</a>, <a href="#wrglossary.12201">499</a>, <a href="#wrglossary.14827">616</a>, <a href="#wrglossary.14858">618</a>, <span class="summarylocfmt"><a href="#wrglossary.18976">765</a></span>, <a href="#wrglossary.19497">784</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstextup"><code class="csfmt">\glstextup</code></a><span class="qquad"></span><a href="#wrglossary.3909">157</a>, <span class="summarylocfmt"><a href="#wrglossary.18980">765</a></span>, <a href="#wrglossary.21360">862</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstildechar"><code class="csfmt">\glstildechar</code></a><span class="qquad"></span><a href="#wrglossary.12278">502</a>, <span class="summarylocfmt"><a href="#wrglossary.18983">766</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicAssignSubIndent"><code class="csfmt">\glstopicAssignSubIndent</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11550">467</a>, <span class="summarylocfmt"><a href="#wrglossary.18985">766</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicAssignWidest"><code class="csfmt">\glstopicAssignWidest</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11551">467</a>, <span class="summarylocfmt"><a href="#wrglossary.18987">766</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicCols"><code class="csfmt">\glstopicCols</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11504">462</a>, <span class="summarylocfmt"><a href="#wrglossary.18990">766</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicColsEnv"><code class="csfmt">\glstopicColsEnv</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11502">462</a>, <span class="summarylocfmt"><a href="#wrglossary.18993">766</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicDesc"><code class="csfmt">\glstopicDesc</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11544">466</a>, <span class="summarylocfmt"><a href="#wrglossary.18997">766</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicGroupHeading"><code class="csfmt">\glstopicGroupHeading</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11520">465</a>, <span class="summarylocfmt"><a href="#wrglossary.18999">766</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicInit"><code class="csfmt">\glstopicInit</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11518">465</a>, <span class="summarylocfmt"><a href="#wrglossary.19001">766</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicItem"><code class="csfmt">\glstopicItem</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11534">465</a>, <a href="#wrglossary.11535">466</a>, <span class="summarylocfmt"><a href="#wrglossary.19003">767</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicLoc"><code class="csfmt">\glstopicLoc</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11548">467</a>, <span class="summarylocfmt"><a href="#wrglossary.19005">767</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicMarker"><code class="csfmt">\glstopicMarker</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11537">466</a>, <span class="summarylocfmt"><a href="#wrglossary.19008">767</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicMidSkip"><code class="csfmt">\glstopicMidSkip</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11543">466</a>, <span class="summarylocfmt"><a href="#wrglossary.19010">767</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicParIndent"><code class="csfmt">\glstopicParIndent</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11512">463</a>, <span class="summarylocfmt"><a href="#wrglossary.19012">767</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicPostSkip"><code class="csfmt">\glstopicPostSkip</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11547">466</a>, <span class="summarylocfmt"><a href="#wrglossary.19014">767</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicPreSkip"><code class="csfmt">\glstopicPreSkip</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11536">466</a>, <span class="summarylocfmt"><a href="#wrglossary.19016">767</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicSubGroupHeading"><code class="csfmt">\glstopicSubGroupHeading</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11531">465</a>, <span class="summarylocfmt"><a href="#wrglossary.19018">768</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicSubIndent"><code class="csfmt">\glstopicSubIndent</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11513">464</a>, <span class="summarylocfmt"><a href="#wrglossary.19020">768</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicSubItem"><code class="csfmt">\glstopicSubItem</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11552">467</a>, <span class="summarylocfmt"><a href="#wrglossary.19022">768</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicSubItemBox"><code class="csfmt">\glstopicSubItemBox</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11555">467</a>, <span class="summarylocfmt"><a href="#wrglossary.19024">768</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicSubItemParIndent"><code class="csfmt">\glstopicSubItemParIndent</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11515">464</a>, <span class="summarylocfmt"><a href="#wrglossary.19026">768</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicSubItemSep"><code class="csfmt">\glstopicSubItemSep</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11554">467</a>, <span class="summarylocfmt"><a href="#wrglossary.19028">768</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicSubLoc"><code class="csfmt">\glstopicSubLoc</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11558">468</a>, <span class="summarylocfmt"><a href="#wrglossary.19030">768</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicSubNameFont"><code class="csfmt">\glstopicSubNameFont</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11553">467</a>, <span class="summarylocfmt"><a href="#wrglossary.19033">768</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicSubPreLocSep"><code class="csfmt">\glstopicSubPreLocSep</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11557">468</a>, <span class="summarylocfmt"><a href="#wrglossary.19035">769</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicTitle"><code class="csfmt">\glstopicTitle</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11538">466</a>, <span class="summarylocfmt"><a href="#wrglossary.19038">769</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstopicTitleFont"><code class="csfmt">\glstopicTitleFont</code></a><span class="qquad"></span><a href="#sec:topic">§8.7.3</a>; <a href="#wrglossary.11541">466</a>, <span class="summarylocfmt"><a href="#wrglossary.19040">769</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreechilddesc"><code class="csfmt">\glstreechilddesc</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10992">433</a>, <span class="summarylocfmt"><a href="#wrglossary.19042">769</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreeChildDescLoc"><code class="csfmt">\glstreeChildDescLoc</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10997">433</a>, <span class="summarylocfmt"><a href="#wrglossary.19045">769</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreechildpredesc"><code class="csfmt">\glstreechildpredesc</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10968">431</a>, <span class="summarylocfmt"><a href="#wrglossary.19049">769</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreechildprelocation"><code class="csfmt">\glstreechildprelocation</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10980">432</a>, <a href="#wrglossary.10999">433</a>, <span class="summarylocfmt"><a href="#wrglossary.19051">769</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreechildsymbol"><code class="csfmt">\glstreechildsymbol</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10993">433</a>, <span class="summarylocfmt"><a href="#wrglossary.19056">770</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreedefaultnamefmt"><code class="csfmt">\glstreedefaultnamefmt</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10948">430</a>, <span class="summarylocfmt"><a href="#wrglossary.19059">770</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreedesc"><code class="csfmt">\glstreedesc</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10990">432</a>, <a href="#wrglossary.10994">433</a>, <span class="summarylocfmt"><a href="#wrglossary.19063">770</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreeDescLoc"><code class="csfmt">\glstreeDescLoc</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10996">433</a>, <span class="summarylocfmt"><a href="#wrglossary.19066">770</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreegroupheaderfmt"><code class="csfmt">\glstreegroupheaderfmt</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10943">430</a>, <a href="#wrglossary.11164">443</a>, <span class="summarylocfmt"><a href="#wrglossary.19070">770</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreegroupheaderskip"><code class="csfmt">\glstreegroupheaderskip</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10955">430</a>, <a href="#wrglossary.10956">431</a>, <span class="summarylocfmt"><a href="#wrglossary.19075">770</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreegroupskip"><code class="csfmt">\glstreegroupskip</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10952">430</a>, <a href="#wrglossary.10957">431</a>, <span class="summarylocfmt"><a href="#wrglossary.19079">770</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreeitem"><code class="csfmt">\glstreeitem</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19083">770</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreenamefmt"><code class="csfmt">\glstreenamefmt</code></a><span class="qquad"></span><a href="#wrglossary.10946">430</a>, <a href="#wrglossary.11166">443</a>, <span class="summarylocfmt"><a href="#wrglossary.19086">771</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreenavigationfmt"><code class="csfmt">\glstreenavigationfmt</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10945">430</a>, <span class="summarylocfmt"><a href="#wrglossary.19090">771</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreeNoDescSymbolPreLocation"><code class="csfmt">\glstreeNoDescSymbolPreLocation</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11000">433</a>, <span class="summarylocfmt"><a href="#wrglossary.19093">771</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreenonamechilddesc"><code class="csfmt">\glstreenonamechilddesc</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10986">432</a>, <span class="summarylocfmt"><a href="#wrglossary.19097">771</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreenonameChildDescLoc"><code class="csfmt">\glstreenonameChildDescLoc</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19100">771</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreenonamedesc"><code class="csfmt">\glstreenonamedesc</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10983">432</a>, <span class="summarylocfmt"><a href="#wrglossary.19104">771</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreenonameDescLoc"><code class="csfmt">\glstreenonameDescLoc</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19107">771</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreenonamesymbol"><code class="csfmt">\glstreenonamesymbol</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10984">432</a>, <span class="summarylocfmt"><a href="#wrglossary.19111">772</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreepredesc"><code class="csfmt">\glstreepredesc</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10967">431</a>, <span class="summarylocfmt"><a href="#wrglossary.19114">772</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreePreHeader"><code class="csfmt">\glstreePreHeader</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10959">431</a>, <span class="summarylocfmt"><a href="#wrglossary.19116">772</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreeprelocation"><code class="csfmt">\glstreeprelocation</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10978">432</a>, <a href="#wrglossary.10998">433</a>, <span class="summarylocfmt"><a href="#wrglossary.19121">772</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreesubgroupitem"><code class="csfmt">\glstreesubgroupitem</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19126">772</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreesubitem"><code class="csfmt">\glstreesubitem</code></a><span class="qquad"></span><a href="#wrglossary.11150">442</a>, <span class="summarylocfmt"><a href="#wrglossary.19129">772</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreeSubPreHeader"><code class="csfmt">\glstreeSubPreHeader</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19132">772</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreesubsubitem"><code class="csfmt">\glstreesubsubitem</code></a><span class="qquad"></span><a href="#wrglossary.11151">442</a>, <span class="summarylocfmt"><a href="#wrglossary.19137">773</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstreesymbol"><code class="csfmt">\glstreesymbol</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.10991">432</a>, <span class="summarylocfmt"><a href="#wrglossary.19140">773</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glstriggerrecordformat"><code class="csfmt">\glstriggerrecordformat</code></a><span class="qquad"></span><a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12792">525</a>, <a href="#wrglossary.12945">530</a>, <span class="summarylocfmt"><a href="#wrglossary.19143">773</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:rgls"><code class="csfmt">\rgls</code></a> &amp; <a href="#glo:switch.record-count"><span class="longargfmt">--record-count</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsunexpandedfieldvalue"><code class="csfmt">\glsunexpandedfieldvalue</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19145">773</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsunset"><code class="csfmt">\glsunset</code></a><span class="qquad"></span><a href="#wrglossary.7340">280</a>, <a href="#wrglossary.7422">283</a>–<a href="#wrglossary.7487">286</a>, <a href="#wrglossary.7921">307</a>, <a href="#wrglossary.14835">617</a>, <span class="summarylocfmt"><a href="#wrglossary.19148">773</a></span>, <a href="#wrglossary.19757">796</a>, <a href="#wrglossary.21226">857</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glslocalunset"><code class="csfmt">\glslocalunset</code></a>, <a href="#glo:glsreset"><code class="csfmt">\glsreset</code></a>, <a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a> &amp; <a href="#glo:GlsXtrIfUnusedOrUndefined"><code class="csfmt">\GlsXtrIfUnusedOrUndefined</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsunsetall"><code class="csfmt">\glsunsetall</code></a><span class="qquad"></span><a href="#wrglossary.7355">280</a>, <span class="summarylocfmt"><a href="#wrglossary.19151">773</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsunset"><code class="csfmt">\glsunset</code></a>, <a href="#glo:glsresetall"><code class="csfmt">\glsresetall</code></a>, <a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a> &amp; <a href="#glo:GlsXtrIfUnusedOrUndefined"><code class="csfmt">\GlsXtrIfUnusedOrUndefined</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsunsetcategoryattribute"><code class="csfmt">\glsunsetcategoryattribute</code></a><span class="qquad"></span><a href="#sec:attributecmds">§10.2.2</a>; <a href="#wrglossary.12335">504</a>, <span class="summarylocfmt"><a href="#wrglossary.19153">773</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsupdatewidest"><code class="csfmt">\glsupdatewidest</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11012">434</a>, <a href="#wrglossary.16394">672</a>, <a href="#wrglossary.16446">674</a>, <span class="summarylocfmt"><a href="#wrglossary.19155">774</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsuppercase"><code class="csfmt">\glsuppercase</code></a><span class="qquad"></span><a href="#sec:uppercase">§5.2.3</a>; <a href="#wrglossary.5124">200</a>, <span class="summarylocfmt"><a href="#wrglossary.19159">774</a></span>, <a href="#wrglossary.22259">900</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsuseabbrvfont"><code class="csfmt">\glsuseabbrvfont</code></a><span class="qquad"></span><a href="#sec:advancedabbrstylecmds">§4.5.2</a>; <a href="#wrglossary.3966">159</a>, <span class="summarylocfmt"><a href="#wrglossary.19162">774</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsuselongfont"><code class="csfmt">\glsuselongfont</code></a><span class="qquad"></span><a href="#sec:advancedabbrstylecmds">§4.5.2</a>; <a href="#wrglossary.3967">159</a>, <span class="summarylocfmt"><a href="#wrglossary.19164">774</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsuserdescription"><code class="csfmt">\glsuserdescription</code></a><span class="qquad"></span><a href="#wrglossary.2398">88</a>, <a href="#wrglossary.2663">100</a>, <a href="#wrglossary.2700">101</a>, <a href="#wrglossary.3384">137</a>, <span class="summarylocfmt"><a href="#wrglossary.19166">774</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSuseri"><code class="csfmt">\GLSuseri</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19169">774</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsuseri"><code class="csfmt">\Glsuseri</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19177">774</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsuseri"><code class="csfmt">\glsuseri</code></a><span class="qquad"></span><a href="#wrglossary.14732">611</a>, <a href="#wrglossary.19174">774</a>, <span class="summarylocfmt"><a href="#wrglossary.19185">775</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsuseriaccessdisplay"><code class="csfmt">\glsuseriaccessdisplay</code></a><span class="qquad"></span><a href="#wrglossary.11854">482</a>, <a href="#wrglossary.11998">489</a>, <span class="summarylocfmt"><a href="#wrglossary.19194">775</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSuserii"><code class="csfmt">\GLSuserii</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19197">775</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsuserii"><code class="csfmt">\Glsuserii</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19205">775</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsuserii"><code class="csfmt">\glsuserii</code></a><span class="qquad"></span><a href="#wrglossary.14739">612</a>, <span class="summarylocfmt"><a href="#wrglossary.19213">775</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsuseriiaccessdisplay"><code class="csfmt">\glsuseriiaccessdisplay</code></a><span class="qquad"></span><a href="#wrglossary.11862">482</a>, <a href="#wrglossary.12005">490</a>, <span class="summarylocfmt"><a href="#wrglossary.19222">775</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSuseriii"><code class="csfmt">\GLSuseriii</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19225">776</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsuseriii"><code class="csfmt">\Glsuseriii</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19233">776</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsuseriii"><code class="csfmt">\glsuseriii</code></a><span class="qquad"></span><a href="#wrglossary.14746">612</a>, <span class="summarylocfmt"><a href="#wrglossary.19241">776</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsuseriiiaccessdisplay"><code class="csfmt">\glsuseriiiaccessdisplay</code></a><span class="qquad"></span><a href="#wrglossary.11870">483</a>, <a href="#wrglossary.12012">490</a>, <span class="summarylocfmt"><a href="#wrglossary.19250">776</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSuseriv"><code class="csfmt">\GLSuseriv</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19253">776</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsuseriv"><code class="csfmt">\Glsuseriv</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19261">776</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsuseriv"><code class="csfmt">\glsuseriv</code></a><span class="qquad"></span><a href="#wrglossary.14753">612</a>, <a href="#wrglossary.19258">776</a>, <span class="summarylocfmt"><a href="#wrglossary.19269">777</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsuserivaccessdisplay"><code class="csfmt">\glsuserivaccessdisplay</code></a><span class="qquad"></span><a href="#wrglossary.11878">483</a>, <a href="#wrglossary.12019">491</a>, <span class="summarylocfmt"><a href="#wrglossary.19278">777</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSuserv"><code class="csfmt">\GLSuserv</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19281">777</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsuserv"><code class="csfmt">\Glsuserv</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19289">777</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsuserv"><code class="csfmt">\glsuserv</code></a><span class="qquad"></span><a href="#wrglossary.14760">612</a>, <span class="summarylocfmt"><a href="#wrglossary.19297">777</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsuservaccessdisplay"><code class="csfmt">\glsuservaccessdisplay</code></a><span class="qquad"></span><a href="#wrglossary.11886">484</a>, <a href="#wrglossary.12026">491</a>, <span class="summarylocfmt"><a href="#wrglossary.19306">777</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSuservi"><code class="csfmt">\GLSuservi</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19309">778</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsuservi"><code class="csfmt">\Glsuservi</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19317">778</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsuservi"><code class="csfmt">\glsuservi</code></a><span class="qquad"></span><a href="#wrglossary.14767">613</a>, <span class="summarylocfmt"><a href="#wrglossary.19325">778</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsuserviaccessdisplay"><code class="csfmt">\glsuserviaccessdisplay</code></a><span class="qquad"></span><a href="#wrglossary.11894">484</a>, <a href="#wrglossary.12033">491</a>, <span class="summarylocfmt"><a href="#wrglossary.19334">778</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glswriteentry"><code class="csfmt">\glswriteentry</code></a><span class="qquad"></span><a href="#sec:wrglossary">§5.8</a>; <a href="#wrglossary.6926">264</a>, <span class="summarylocfmt"><a href="#wrglossary.19337">778</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxpabbrvfont"><code class="csfmt">\glsxpabbrvfont</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4190">168</a>, <span class="summarylocfmt"><a href="#wrglossary.19338">778</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxplongfont"><code class="csfmt">\glsxplongfont</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4211">168</a>, <span class="summarylocfmt"><a href="#wrglossary.19343">779</a></span></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index7077888 -->
+
+<section id="index7143424"><!-- start of section index7143424 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->Glsxtr<div class="labellink"><a href="#index7143424">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtr"><code class="csfmt">\Glsxtr</code></a><span class="qquad"></span><a href="#sec:onthefly">§13</a>; <a href="#wrglossary.14130">579</a>, <a href="#wrglossary.14141">580</a>, <span class="summarylocfmt"><a href="#wrglossary.19348">779</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtr"><code class="csfmt">\glsxtr</code></a><span class="qquad"></span><a href="#sec:onthefly">§13</a>; <a href="#wrglossary.14105">578</a>–<a href="#wrglossary.14135">580</a>, <span class="summarylocfmt"><a href="#wrglossary.19351">779</a></span>, <a href="#wrglossary.19647">791</a>, <a href="#wrglossary.19808">799</a>, <a href="#wrglossary.21095">852</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtr@counterrecord"><code class="csfmt">\glsxtr@counterrecord</code></a><span class="qquad"></span><a href="#sec:printunsrtunit">§8.4.3.2</a>; <a href="#wrglossary.10397">407</a>, <a href="#wrglossary.10440">408</a>, <span class="summarylocfmt"><a href="#wrglossary.19353">779</a></span>, <a href="#wrglossary.19443">782</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtr@record"><code class="csfmt">\glsxtr@record</code></a><span class="qquad"></span><a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13539">555</a>, <span class="summarylocfmt"><a href="#wrglossary.19359">779</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtr@record@nameref"><code class="csfmt">\glsxtr@record@nameref</code></a><span class="qquad"></span><a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13547">555</a>, <a href="#wrglossary.13577">556</a>, <span class="summarylocfmt"><a href="#wrglossary.19366">779</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtr@resource"><code class="csfmt">\glsxtr@resource</code></a><span class="qquad"></span><a href="#sec:bib2gls">§11</a>; <a href="#wrglossary.437">17</a>, <a href="#wrglossary.12463">511</a>, <span class="summarylocfmt"><a href="#wrglossary.19372">780</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrabbreviationfont"><code class="csfmt">\glsxtrabbreviationfont</code></a><span class="qquad"></span><a href="#sec:middleformat">§5.5.2</a>; <a href="#wrglossary.1775">61</a>, <a href="#wrglossary.1856">65</a>, <a href="#wrglossary.6056">236</a>, <a href="#wrglossary.6139">240</a>, <a href="#wrglossary.6550">255</a>, <a href="#wrglossary.17385">706</a>, <span class="summarylocfmt"><a href="#wrglossary.19378">780</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrabbrvfootnote"><code class="csfmt">\glsxtrabbrvfootnote</code></a><span class="qquad"></span><a href="#wrglossary.3602">145</a>, <span class="summarylocfmt"><a href="#wrglossary.19382">780</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrabbrvpluralsuffix"><code class="csfmt">\glsxtrabbrvpluralsuffix</code></a><span class="qquad"></span><a href="#sec:abbrvfieldslongshortpl">§4.1.2</a>; <a href="#wrglossary.1344">44</a>, <a href="#wrglossary.3360">136</a>, <a href="#wrglossary.3669">148</a>, <a href="#wrglossary.3855">154</a>, <a href="#wrglossary.3930">158</a>, <a href="#wrglossary.4314">171</a>, <a href="#wrglossary.11720">476</a>, <a href="#wrglossary.15692">654</a>, <a href="#wrglossary.15945">658</a>, <span class="summarylocfmt"><a href="#wrglossary.19386">780</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrabbrvtype"><code class="csfmt">\glsxtrabbrvtype</code></a><span class="qquad"></span><a href="#sec:abbrvfieldstype">§4.1.4</a>; <a href="#wrglossary.160">9</a>–<a href="#wrglossary.233">11</a>, <a href="#wrglossary.1234">41</a>, <a href="#wrglossary.1357">44</a>, <a href="#wrglossary.15940">658</a>, <span class="summarylocfmt"><a href="#wrglossary.19388">780</a></span>, <a href="#wrglossary.23099">926</a>, <a href="#wrglossary.23155">927</a>, <a href="#wrglossary.23502">941</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrAccSuppAbbrSetFirstLongAttrs"><code class="csfmt">\glsxtrAccSuppAbbrSetFirstLongAttrs</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4247">169</a>, <span class="summarylocfmt"><a href="#wrglossary.19392">780</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrAccSuppAbbrSetNameLongAttrs"><code class="csfmt">\glsxtrAccSuppAbbrSetNameLongAttrs</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4235">169</a>, <span class="summarylocfmt"><a href="#wrglossary.19400">780</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrAccSuppAbbrSetNameShortAttrs"><code class="csfmt">\glsxtrAccSuppAbbrSetNameShortAttrs</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4268">169</a>, <span class="summarylocfmt"><a href="#wrglossary.19409">781</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrAccSuppAbbrSetNoLongAttrs"><code class="csfmt">\glsxtrAccSuppAbbrSetNoLongAttrs</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4220">168</a>, <span class="summarylocfmt"><a href="#wrglossary.19414">781</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrAccSuppAbbrSetTextShortAttrs"><code class="csfmt">\glsxtrAccSuppAbbrSetTextShortAttrs</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4258">169</a>, <span class="summarylocfmt"><a href="#wrglossary.19425">781</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtractivatenopost"><code class="csfmt">\glsxtractivatenopost</code></a><span class="qquad"></span><a href="#sec:glossentry">§8.5</a>; <a href="#wrglossary.10573">415</a>, <a href="#wrglossary.10605">417</a>, <a href="#wrglossary.10768">423</a>, <span class="summarylocfmt"><a href="#wrglossary.19431">781</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtractualanchor"><code class="csfmt">\glsxtractualanchor</code></a><span class="qquad"></span><a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13597">557</a>, <span class="summarylocfmt"><a href="#wrglossary.19435">781</a></span>, <a href="#wrglossary.21401">863</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtraddallcrossrefs"><code class="csfmt">\glsxtraddallcrossrefs</code></a><span class="qquad"></span><a href="#sec:glssee">§5.9.3</a>; <a href="#wrglossary.554">21</a>, <a href="#wrglossary.7318">279</a>, <span class="summarylocfmt"><a href="#wrglossary.19438">781</a></span>, <a href="#wrglossary.21886">884</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:opt.indexcrossrefs"><span class="styoptfmt">indexcrossrefs</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrAddCounterRecordHook"><code class="csfmt">\glsxtrAddCounterRecordHook</code></a><span class="qquad"></span><a href="#sec:printunsrtunit">§8.4.3.2</a>; <a href="#wrglossary.10403">407</a>, <a href="#wrglossary.10509">411</a>, <a href="#wrglossary.19358">779</a>, <span class="summarylocfmt"><a href="#wrglossary.19441">782</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtraddgroup"><code class="csfmt">\glsxtraddgroup</code></a><span class="qquad"></span><a href="#sec:printunsrtgroups">§8.4.1</a>; <a href="#wrglossary.9953">391</a>, <a href="#wrglossary.9976">392</a>, <a href="#wrglossary.10120">396</a>, <a href="#wrglossary.10247">401</a>, <span class="summarylocfmt"><a href="#wrglossary.19445">782</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13738">563</a>, <a href="#wrglossary.13907">571</a>, <span class="summarylocfmt"><a href="#wrglossary.19449">782</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtraddpunctuationmark"><code class="csfmt">\glsxtraddpunctuationmark</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6365">249</a>, <span class="summarylocfmt"><a href="#wrglossary.19451">782</a></span>, <a href="#wrglossary.20405">822</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtraddunusedxrefs"><code class="csfmt">\glsxtraddunusedxrefs</code></a><span class="qquad"></span><a href="#sec:glssee">§5.9.3</a>; <a href="#wrglossary.7323">279</a>, <span class="summarylocfmt"><a href="#wrglossary.19454">782</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtralias"><code class="csfmt">\glsxtralias</code></a><span class="qquad"></span><a href="#sec:getsee">§5.9.2</a>; <a href="#wrglossary.1095">36</a>, <a href="#wrglossary.1118">37</a>, <a href="#wrglossary.7268">277</a>, <span class="summarylocfmt"><a href="#wrglossary.19458">782</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtraliashook"><code class="csfmt">\glsxtraliashook</code></a><span class="qquad"></span><a href="#sec:alias">§3.4</a>; <a href="#wrglossary.1092">36</a>, <span class="summarylocfmt"><a href="#wrglossary.19462">783</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrAltTreeIndent"><code class="csfmt">\glsxtrAltTreeIndent</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11054">437</a>, <span class="summarylocfmt"><a href="#wrglossary.19465">783</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtralttreeInit"><code class="csfmt">\glsxtralttreeInit</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11053">437</a>, <span class="summarylocfmt"><a href="#wrglossary.19468">783</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtralttreeSubSymbolDescLocation"><code class="csfmt">\glsxtralttreeSubSymbolDescLocation</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11051">437</a>, <span class="summarylocfmt"><a href="#wrglossary.19471">783</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtralttreeSymbolDescLocation"><code class="csfmt">\glsxtralttreeSymbolDescLocation</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11050">437</a>, <span class="summarylocfmt"><a href="#wrglossary.19474">783</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrapptocsvfield"><code class="csfmt">\glsxtrapptocsvfield</code></a><span class="qquad"></span><a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1170">38</a>, <a href="#wrglossary.7759">299</a>, <a href="#wrglossary.7847">303</a>, <span class="summarylocfmt"><a href="#wrglossary.19477">783</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrAppToDefaultGlsOpts"><code class="csfmt">\GlsXtrAppToDefaultGlsOpts</code></a><span class="qquad"></span><a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4701">186</a>, <a href="#wrglossary.4729">187</a>, <span class="summarylocfmt"><a href="#wrglossary.19480">783</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrassignactualsetup"><code class="csfmt">\glsxtrassignactualsetup</code></a><span class="qquad"></span><a href="#sec:accessabbr">§9.1</a>; <a href="#wrglossary.11694">475</a>, <a href="#wrglossary.11706">476</a>, <span class="summarylocfmt"><a href="#wrglossary.19484">784</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrassignfieldfont"><code class="csfmt">\glsxtrassignfieldfont</code></a><span class="qquad"></span><a href="#sec:middleformat">§5.5.2</a>; <a href="#wrglossary.3954">159</a>, <a href="#wrglossary.6136">239</a>, <a href="#wrglossary.6154">240</a>, <a href="#wrglossary.6237">244</a>, <span class="summarylocfmt"><a href="#wrglossary.19489">784</a></span>, <a href="#wrglossary.21293">859</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrassignlinktextfmt"><code class="csfmt">\glsxtrassignlinktextfmt</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.3981">160</a>, <a href="#wrglossary.6486">254</a>, <span class="summarylocfmt"><a href="#wrglossary.19492">784</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrattrentrytextfmt"><code class="csfmt">\glsxtrattrentrytextfmt</code></a><span class="qquad"></span><a href="#sec:innertextformat">§5.5.3</a>; <a href="#wrglossary.6225">243</a>, <span class="summarylocfmt"><a href="#wrglossary.19499">784</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrAutoAddOnFormat"><code class="csfmt">\GlsXtrAutoAddOnFormat</code></a><span class="qquad"></span><a href="#sec:wrglossary">§5.8</a>; <a href="#wrglossary.6696">260</a>, <a href="#wrglossary.6725">261</a>, <span class="summarylocfmt"><a href="#wrglossary.19503">784</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrautoindex"><code class="csfmt">\glsxtrautoindex</code></a><span class="qquad"></span><a href="#sec:autoindex">§12</a>; <a href="#wrglossary.14041">575</a>, <span class="summarylocfmt"><a href="#wrglossary.19508">784</a></span>, <a href="#wrglossary.19776">797</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrautoindexassignsort"><code class="csfmt">\glsxtrautoindexassignsort</code></a><span class="qquad"></span><a href="#sec:autoindex">§12</a>; <a href="#wrglossary.14034">575</a>, <span class="summarylocfmt"><a href="#wrglossary.19510">784</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrautoindexentry"><code class="csfmt">\glsxtrautoindexentry</code></a><span class="qquad"></span><a href="#sec:autoindex">§12</a>; <a href="#wrglossary.14028">574</a>, <span class="summarylocfmt"><a href="#wrglossary.19512">785</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrautoindexesc"><code class="csfmt">\glsxtrautoindexesc</code></a><span class="qquad"></span><a href="#sec:autoindex">§12</a>; <a href="#wrglossary.14039">575</a>, <span class="summarylocfmt"><a href="#wrglossary.19514">785</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrBasicDigitrules"><code class="csfmt">\glsxtrBasicDigitrules</code></a><span class="qquad"></span><a href="#wrglossary.13297">545</a>, <span class="summarylocfmt"><a href="#wrglossary.19516">785</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbibaddress"><code class="csfmt">\glsxtrbibaddress</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13100">536</a>, <span class="summarylocfmt"><a href="#wrglossary.19518">785</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbibauthor"><code class="csfmt">\glsxtrbibauthor</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13102">536</a>, <span class="summarylocfmt"><a href="#wrglossary.19520">785</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbibbooktitle"><code class="csfmt">\glsxtrbibbooktitle</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13104">536</a>, <span class="summarylocfmt"><a href="#wrglossary.19522">785</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbibchapter"><code class="csfmt">\glsxtrbibchapter</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13106">536</a>, <span class="summarylocfmt"><a href="#wrglossary.19524">785</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbibedition"><code class="csfmt">\glsxtrbibedition</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13108">536</a>, <span class="summarylocfmt"><a href="#wrglossary.19526">786</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbibhowpublished"><code class="csfmt">\glsxtrbibhowpublished</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13110">536</a>, <span class="summarylocfmt"><a href="#wrglossary.19528">786</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbibinstitution"><code class="csfmt">\glsxtrbibinstitution</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13112">536</a>, <span class="summarylocfmt"><a href="#wrglossary.19530">786</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbibjournal"><code class="csfmt">\glsxtrbibjournal</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13114">536</a>, <span class="summarylocfmt"><a href="#wrglossary.19532">786</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbibmonth"><code class="csfmt">\glsxtrbibmonth</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13116">536</a>, <span class="summarylocfmt"><a href="#wrglossary.19534">786</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbibnote"><code class="csfmt">\glsxtrbibnote</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13118">536</a>, <span class="summarylocfmt"><a href="#wrglossary.19536">786</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbibnumber"><code class="csfmt">\glsxtrbibnumber</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13120">536</a>, <span class="summarylocfmt"><a href="#wrglossary.19538">786</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbiborganization"><code class="csfmt">\glsxtrbiborganization</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13122">536</a>, <span class="summarylocfmt"><a href="#wrglossary.19540">786</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbibpages"><code class="csfmt">\glsxtrbibpages</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13124">536</a>, <span class="summarylocfmt"><a href="#wrglossary.19542">787</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbibpublisher"><code class="csfmt">\glsxtrbibpublisher</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13126">536</a>, <span class="summarylocfmt"><a href="#wrglossary.19544">787</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbibschool"><code class="csfmt">\glsxtrbibschool</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13128">536</a>, <span class="summarylocfmt"><a href="#wrglossary.19546">787</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbibseries"><code class="csfmt">\glsxtrbibseries</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13130">536</a>, <span class="summarylocfmt"><a href="#wrglossary.19548">787</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrBibTeXEntryAliases"><code class="csfmt">\GlsXtrBibTeXEntryAliases</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13095">535</a>, <span class="summarylocfmt"><a href="#wrglossary.19550">787</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbibtitle"><code class="csfmt">\glsxtrbibtitle</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13132">536</a>, <span class="summarylocfmt"><a href="#wrglossary.19554">787</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbibtype"><code class="csfmt">\glsxtrbibtype</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13134">536</a>, <span class="summarylocfmt"><a href="#wrglossary.19556">787</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbibvolume"><code class="csfmt">\glsxtrbibvolume</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13136">536</a>, <span class="summarylocfmt"><a href="#wrglossary.19558">788</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexatendgroup"><code class="csfmt">\glsxtrbookindexatendgroup</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11121">441</a>, <span class="summarylocfmt"><a href="#wrglossary.19560">788</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexbetween"><code class="csfmt">\glsxtrbookindexbetween</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11115">441</a>, <span class="summarylocfmt"><a href="#wrglossary.19563">788</a></span>, <a href="#wrglossary.19628">791</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexbookmark"><code class="csfmt">\glsxtrbookindexbookmark</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11157">442</a>, <span class="summarylocfmt"><a href="#wrglossary.19566">788</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexcols"><code class="csfmt">\glsxtrbookindexcols</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11077">438</a>, <span class="summarylocfmt"><a href="#wrglossary.19569">788</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexcolspread"><code class="csfmt">\glsxtrbookindexcolspread</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11079">439</a>, <span class="summarylocfmt"><a href="#wrglossary.19572">788</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexfirstmark"><code class="csfmt">\glsxtrbookindexfirstmark</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11173">443</a>, <span class="summarylocfmt"><a href="#wrglossary.19575">788</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexfirstmarkfmt"><code class="csfmt">\glsxtrbookindexfirstmarkfmt</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11175">444</a>, <a href="#wrglossary.19578">788</a>, <span class="summarylocfmt"><a href="#wrglossary.19579">789</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexformatheader"><code class="csfmt">\glsxtrbookindexformatheader</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11161">443</a>, <span class="summarylocfmt"><a href="#wrglossary.19582">789</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexformatsubheader"><code class="csfmt">\glsxtrbookindexformatsubheader</code></a><span class="qquad"></span><a href="#wrglossary.9995">394</a>, <span class="summarylocfmt"><a href="#wrglossary.19586">789</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexlastmark"><code class="csfmt">\glsxtrbookindexlastmark</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11174">443</a>, <span class="summarylocfmt"><a href="#wrglossary.19588">789</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexlastmarkfmt"><code class="csfmt">\glsxtrbookindexlastmarkfmt</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11176">444</a>, <span class="summarylocfmt"><a href="#wrglossary.19592">789</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexlocation"><code class="csfmt">\glsxtrbookindexlocation</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11110">440</a>, <span class="summarylocfmt"><a href="#wrglossary.19595">789</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexmarkentry"><code class="csfmt">\glsxtrbookindexmarkentry</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11171">443</a>, <span class="summarylocfmt"><a href="#wrglossary.19599">789</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexmulticolsenv"><code class="csfmt">\glsxtrbookindexmulticolsenv</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11082">439</a>, <span class="summarylocfmt"><a href="#wrglossary.19603">790</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexname"><code class="csfmt">\glsxtrbookindexname</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11084">439</a>, <a href="#wrglossary.11098">440</a>, <a href="#wrglossary.11177">444</a>, <span class="summarylocfmt"><a href="#wrglossary.19606">790</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexparentchildsep"><code class="csfmt">\glsxtrbookindexparentchildsep</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11112">440</a>, <a href="#wrglossary.11114">441</a>, <span class="summarylocfmt"><a href="#wrglossary.19609">790</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexparentsubchildsep"><code class="csfmt">\glsxtrbookindexparentsubchildsep</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11113">441</a>, <span class="summarylocfmt"><a href="#wrglossary.19612">790</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexpregroupskip"><code class="csfmt">\glsxtrbookindexpregroupskip</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11168">443</a>, <span class="summarylocfmt"><a href="#wrglossary.19615">790</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexprelocation"><code class="csfmt">\glsxtrbookindexprelocation</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11100">440</a>, <span class="summarylocfmt"><a href="#wrglossary.19619">790</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexsubatendgroup"><code class="csfmt">\glsxtrbookindexsubatendgroup</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11120">441</a>, <span class="summarylocfmt"><a href="#wrglossary.19623">790</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexsubbetween"><code class="csfmt">\glsxtrbookindexsubbetween</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11116">441</a>, <span class="summarylocfmt"><a href="#wrglossary.19626">790</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexsublocation"><code class="csfmt">\glsxtrbookindexsublocation</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11111">440</a>, <span class="summarylocfmt"><a href="#wrglossary.19629">791</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexsubname"><code class="csfmt">\glsxtrbookindexsubname</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11097">440</a>, <a href="#wrglossary.11181">444</a>, <span class="summarylocfmt"><a href="#wrglossary.19633">791</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexsubprelocation"><code class="csfmt">\glsxtrbookindexsubprelocation</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11108">440</a>, <span class="summarylocfmt"><a href="#wrglossary.19636">791</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexsubsubatendgroup"><code class="csfmt">\glsxtrbookindexsubsubatendgroup</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11119">441</a>, <span class="summarylocfmt"><a href="#wrglossary.19640">791</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrbookindexsubsubbetween"><code class="csfmt">\glsxtrbookindexsubsubbetween</code></a><span class="qquad"></span><a href="#sec:bookindex">§8.7.1</a>; <a href="#wrglossary.11117">441</a>, <span class="summarylocfmt"><a href="#wrglossary.19643">791</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrcat"><code class="csfmt">\glsxtrcat</code></a><span class="qquad"></span><a href="#sec:onthefly">§13</a>; <a href="#wrglossary.14138">580</a>, <span class="summarylocfmt"><a href="#wrglossary.19646">791</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrcategoryfieldaccsupp"><code class="csfmt">\glsxtr<span class="meta">〈<em class="metainner">category</em>〉</span><span class="meta">〈<em class="metainner">field</em>〉</span>accsupp</code></a><span class="qquad"></span><a href="#wrglossary.17614">713</a>, <span class="summarylocfmt"><a href="#wrglossary.19648">791</a></span>, <a href="#wrglossary.21260">858</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrchecknohyperfirst"><code class="csfmt">\glsxtrchecknohyperfirst</code></a><span class="qquad"></span><a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4688">186</a>, <a href="#wrglossary.4767">189</a>, <a href="#wrglossary.12182">498</a>, <span class="summarylocfmt"><a href="#wrglossary.19651">792</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrclearlabelprefixes"><code class="csfmt">\glsxtrclearlabelprefixes</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13740">563</a>, <span class="summarylocfmt"><a href="#wrglossary.19655">792</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a> &amp; <a href="#glo:glsxtrprependlabelprefix"><code class="csfmt">\glsxtrprependlabelprefix</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrClearUnsetBuffer"><code class="csfmt">\GlsXtrClearUnsetBuffer</code></a><span class="qquad"></span><a href="#sec:unsetbuffer">§5.10.1</a>; <a href="#wrglossary.7466">285</a>, <a href="#wrglossary.7481">286</a>, <span class="summarylocfmt"><a href="#wrglossary.19657">792</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrcombiningdiacriticIIIrules"><code class="csfmt">\glsxtrcombiningdiacriticIIIrules</code></a><span class="qquad"></span><a href="#wrglossary.13271">543</a>, <span class="summarylocfmt"><a href="#wrglossary.19659">792</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrcombiningdiacriticIIrules"><code class="csfmt">\glsxtrcombiningdiacriticIIrules</code></a><span class="qquad"></span><a href="#wrglossary.13270">543</a>, <span class="summarylocfmt"><a href="#wrglossary.19661">792</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrcombiningdiacriticIrules"><code class="csfmt">\glsxtrcombiningdiacriticIrules</code></a><span class="qquad"></span><a href="#wrglossary.13269">542</a>, <span class="summarylocfmt"><a href="#wrglossary.19663">792</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrcombiningdiacriticIVrules"><code class="csfmt">\glsxtrcombiningdiacriticIVrules</code></a><span class="qquad"></span><a href="#wrglossary.13272">543</a>, <span class="summarylocfmt"><a href="#wrglossary.19665">792</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrcombiningdiacriticrules"><code class="csfmt">\glsxtrcombiningdiacriticrules</code></a><span class="qquad"></span><a href="#wrglossary.13260">542</a>, <span class="summarylocfmt"><a href="#wrglossary.19667">793</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrcontrolrules"><code class="csfmt">\glsxtrcontrolrules</code></a><span class="qquad"></span><a href="#wrglossary.13256">542</a>, <span class="summarylocfmt"><a href="#wrglossary.19669">793</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrcopytoglossary"><code class="csfmt">\glsxtrcopytoglossary</code></a><span class="qquad"></span><a href="#sec:glossaries">§8</a>; <a href="#wrglossary.4992">196</a>, <a href="#wrglossary.9459">376</a>, <a href="#wrglossary.9681">384</a>, <span class="summarylocfmt"><a href="#wrglossary.19671">793</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrcounterlocfmt"><code class="csfmt">\glsxtr<span class="meta">〈<em class="metainner">counter</em>〉</span>locfmt</code></a><span class="qquad"></span><a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13591">557</a>–<a href="#wrglossary.13623">559</a>, <span class="summarylocfmt"><a href="#wrglossary.19676">793</a></span>, <a href="#wrglossary.21740">877</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrcurrencyrules"><code class="csfmt">\glsxtrcurrencyrules</code></a><span class="qquad"></span><a href="#wrglossary.13294">545</a>, <span class="summarylocfmt"><a href="#wrglossary.19679">793</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrcurrentfield"><code class="csfmt">\glsxtrcurrentfield</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6432">252</a>, <a href="#wrglossary.6459">253</a>, <span class="summarylocfmt"><a href="#wrglossary.19681">793</a></span>, <a href="#wrglossary.20449">823</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrcurrentmglscsname"><code class="csfmt">\glsxtrcurrentmglscsname</code></a><span class="qquad"></span><a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8781">348</a>, <span class="summarylocfmt"><a href="#wrglossary.19686">793</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrdefaultentrytextfmt"><code class="csfmt">\glsxtrdefaultentrytextfmt</code></a><span class="qquad"></span><a href="#sec:innertextformat">§5.5.3</a>; <a href="#wrglossary.6220">243</a>, <span class="summarylocfmt"><a href="#wrglossary.19688">794</a></span>, <a href="#wrglossary.20070">808</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrDefaultResourceOptions"><code class="csfmt">\GlsXtrDefaultResourceOptions</code></a><span class="qquad"></span><a href="#sec:bib2gls">§11</a>; <a href="#wrglossary.12515">513</a>, <span class="summarylocfmt"><a href="#wrglossary.19691">794</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrdefaultrevert"><code class="csfmt">\glsxtrdefaultrevert</code></a><span class="qquad"></span><a href="#wrglossary.3280">133</a>, <span class="summarylocfmt"><a href="#wrglossary.19694">794</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrdefaultsubsequentfmt"><code class="csfmt">\GLSxtrdefaultsubsequentfmt</code></a><span class="qquad"></span><a href="#wrglossary.4417">174</a>, <span class="summarylocfmt"><a href="#wrglossary.19697">794</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrdefaultsubsequentfmt"><code class="csfmt">\Glsxtrdefaultsubsequentfmt</code></a><span class="qquad"></span><a href="#wrglossary.4409">174</a>, <span class="summarylocfmt"><a href="#wrglossary.19701">794</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrdefaultsubsequentfmt"><code class="csfmt">\glsxtrdefaultsubsequentfmt</code></a><span class="qquad"></span><a href="#wrglossary.4403">174</a>, <span class="summarylocfmt"><a href="#wrglossary.19705">794</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrdefaultsubsequentplfmt"><code class="csfmt">\GLSxtrdefaultsubsequentplfmt</code></a><span class="qquad"></span><a href="#wrglossary.4421">174</a>, <span class="summarylocfmt"><a href="#wrglossary.19708">794</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrdefaultsubsequentplfmt"><code class="csfmt">\Glsxtrdefaultsubsequentplfmt</code></a><span class="qquad"></span><a href="#wrglossary.4413">174</a>, <span class="summarylocfmt"><a href="#wrglossary.19712">795</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrdefaultsubsequentplfmt"><code class="csfmt">\glsxtrdefaultsubsequentplfmt</code></a><span class="qquad"></span><a href="#wrglossary.4406">174</a>, <span class="summarylocfmt"><a href="#wrglossary.19716">795</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrdeffield"><code class="csfmt">\glsxtrdeffield</code></a><span class="qquad"></span><a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1124">37</a>–<a href="#wrglossary.1171">39</a>, <a href="#wrglossary.19479">783</a>, <span class="summarylocfmt"><a href="#wrglossary.19719">795</a></span>, <a href="#wrglossary.19792">798</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrDefineAbbreviationShortcuts"><code class="csfmt">\GlsXtrDefineAbbreviationShortcuts</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19722">795</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrDefineAcronymShortcuts"><code class="csfmt">\GlsXtrDefineAcronymShortcuts</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19727">795</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrDefineOtherShortcuts"><code class="csfmt">\GlsXtrDefineOtherShortcuts</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19733">795</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrdetoklocation"><code class="csfmt">\glsxtrdetoklocation</code></a><span class="qquad"></span><a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12731">522</a>, <a href="#wrglossary.13018">532</a>, <span class="summarylocfmt"><a href="#wrglossary.19738">796</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrdigitrules"><code class="csfmt">\glsxtrdigitrules</code></a><span class="qquad"></span><a href="#wrglossary.13296">545</a>, <span class="summarylocfmt"><a href="#wrglossary.19740">796</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrdiscardperiod"><code class="csfmt">\glsxtrdiscardperiod</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6323">247</a>, <span class="summarylocfmt"><a href="#wrglossary.19742">796</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrdiscardperiodretainfirstuse"><code class="csfmt">\glsxtrdiscardperiodretainfirstuse</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6329">247</a>, <a href="#wrglossary.12100">495</a>, <span class="summarylocfmt"><a href="#wrglossary.19751">796</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrDiscardUnsetBuffering"><code class="csfmt">\GlsXtrDiscardUnsetBuffering</code></a><span class="qquad"></span><a href="#sec:unsetbuffer">§5.10.1</a>; <a href="#wrglossary.7473">285</a>, <span class="summarylocfmt"><a href="#wrglossary.19755">796</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GlsXtrStartUnsetBuffering"><code class="csfmt">\GlsXtrStartUnsetBuffering</code></a> &amp; <a href="#glo:GlsXtrStopUnsetBuffering"><code class="csfmt">\GlsXtrStopUnsetBuffering</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrdisplayendloc"><code class="csfmt">\glsxtrdisplayendloc</code></a><span class="qquad"></span><a href="#sec:glosstylenumlist">§8.6.3</a>; <a href="#wrglossary.10810">424</a>, <span class="summarylocfmt"><a href="#wrglossary.19758">796</a></span>, <a href="#wrglossary.19762">797</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrdisplayendlochook"><code class="csfmt">\glsxtrdisplayendlochook</code></a><span class="qquad"></span><a href="#sec:glosstylenumlist">§8.6.3</a>; <a href="#wrglossary.10813">425</a>, <span class="summarylocfmt"><a href="#wrglossary.19760">796</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrdisplaylocnameref"><code class="csfmt">\glsxtrdisplaylocnameref</code></a><span class="qquad"></span><a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13580">556</a>, <a href="#wrglossary.13610">558</a>, <a href="#wrglossary.13624">559</a>, <a href="#wrglossary.19437">781</a>, <a href="#wrglossary.19677">793</a>, <span class="summarylocfmt"><a href="#wrglossary.19763">797</a></span>, <a href="#wrglossary.19835">800</a>, <a href="#wrglossary.20593">830</a>, <a href="#wrglossary.20953">846</a>, <a href="#wrglossary.21275">859</a>, <a href="#wrglossary.21400">863</a>, <a href="#wrglossary.21738">877</a>, <a href="#wrglossary.22095">893</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrdisplaysingleloc"><code class="csfmt">\glsxtrdisplaysingleloc</code></a><span class="qquad"></span><a href="#sec:glosstylenumlist">§8.6.3</a>; <a href="#wrglossary.10808">424</a>, <span class="summarylocfmt"><a href="#wrglossary.19768">797</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrdisplaystartloc"><code class="csfmt">\glsxtrdisplaystartloc</code></a><span class="qquad"></span><a href="#sec:glosstylenumlist">§8.6.3</a>; <a href="#wrglossary.10809">424</a>, <span class="summarylocfmt"><a href="#wrglossary.19770">797</a></span>, <a href="#wrglossary.20609">831</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrdisplaysupploc"><code class="csfmt">\glsxtrdisplaysupploc</code></a><span class="qquad"></span><a href="#sec:supplocations">§11.5.5</a>; <a href="#wrglossary.13513">555</a>, <span class="summarylocfmt"><a href="#wrglossary.19772">797</a></span>, <a href="#wrglossary.20945">845</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrdoautoindexname"><code class="csfmt">\glsxtrdoautoindexname</code></a><span class="qquad"></span><a href="#sec:autoindex">§12</a>; <a href="#wrglossary.6940">265</a>, <a href="#wrglossary.14024">574</a>, <a href="#wrglossary.14076">576</a>, <span class="summarylocfmt"><a href="#wrglossary.19775">797</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrdopostpunc"><code class="csfmt">\glsxtrdopostpunc</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6353">248</a>, <span class="summarylocfmt"><a href="#wrglossary.19777">797</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrdowrglossaryhook"><code class="csfmt">\glsxtrdowrglossaryhook</code></a><span class="qquad"></span><a href="#sec:wrglossary">§5.8</a>; <a href="#wrglossary.6892">263</a>, <span class="summarylocfmt"><a href="#wrglossary.19780">797</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrDualBackLink"><code class="csfmt">\GlsXtrDualBackLink</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13693">561</a>, <span class="summarylocfmt"><a href="#wrglossary.19783">798</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrDualField"><code class="csfmt">\GlsXtrDualField</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13699">562</a>, <span class="summarylocfmt"><a href="#wrglossary.19786">798</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtredeffield"><code class="csfmt">\glsxtredeffield</code></a><span class="qquad"></span><a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1168">38</a>, <span class="summarylocfmt"><a href="#wrglossary.19790">798</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtremrevert"><code class="csfmt">\glsxtremrevert</code></a><span class="qquad"></span><a href="#wrglossary.3936">158</a>, <span class="summarylocfmt"><a href="#wrglossary.19793">798</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtremsuffix"><code class="csfmt">\glsxtremsuffix</code></a><span class="qquad"></span><a href="#wrglossary.2011">71</a>–<a href="#wrglossary.2042">73</a>, <a href="#wrglossary.2156">78</a>–<a href="#wrglossary.2198">80</a>, <a href="#wrglossary.2326">85</a>–<a href="#wrglossary.2368">87</a>, <a href="#wrglossary.2594">97</a>–<a href="#wrglossary.2636">99</a>, <a href="#wrglossary.3182">126</a>–<a href="#wrglossary.3222">129</a>, <a href="#wrglossary.3941">158</a>, <span class="summarylocfmt"><a href="#wrglossary.19798">798</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrEnableEntryCounting"><code class="csfmt">\GlsXtrEnableEntryCounting</code></a><span class="qquad"></span><a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.7968">308</a>, <a href="#wrglossary.7979">309</a>, <span class="summarylocfmt"><a href="#wrglossary.19800">798</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrEnableEntryUnitCounting"><code class="csfmt">\GlsXtrEnableEntryUnitCounting</code></a><span class="qquad"></span><a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8082">313</a>, <a href="#wrglossary.8124">316</a>, <span class="summarylocfmt"><a href="#wrglossary.19801">798</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrEnableIndexFormatOverride"><code class="csfmt">\GlsXtrEnableIndexFormatOverride</code></a><span class="qquad"></span><a href="#sec:autoindex">§12</a>; <a href="#wrglossary.14067">576</a>, <span class="summarylocfmt"><a href="#wrglossary.19802">799</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrEnableInitialTagging"><code class="csfmt">\GlsXtrEnableInitialTagging</code></a><span class="qquad"></span><a href="#sec:tagging">§4.4</a>; <a href="#wrglossary.1708">56</a>, <a href="#wrglossary.1709">58</a>, <a href="#wrglossary.12165">498</a>, <span class="summarylocfmt"><a href="#wrglossary.19804">799</a></span>, <a href="#wrglossary.21725">877</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrEnableLinkCounting"><code class="csfmt">\GlsXtrEnableLinkCounting</code></a><span class="qquad"></span><a href="#sec:linkcount">§6.2</a>; <a href="#wrglossary.8150">317</a>, <a href="#wrglossary.8177">319</a>, <a href="#wrglossary.8218">320</a>, <a href="#wrglossary.12262">502</a>, <span class="summarylocfmt"><a href="#wrglossary.19805">799</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrEnableOnTheFly"><code class="csfmt">\GlsXtrEnableOnTheFly</code></a><span class="qquad"></span><a href="#sec:onthefly">§13</a>; <a href="#wrglossary.14098">578</a>, <a href="#wrglossary.14237">590</a>, <a href="#wrglossary.19352">779</a>, <span class="summarylocfmt"><a href="#wrglossary.19807">799</a></span>, <a href="#wrglossary.21686">875</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrEnablePreLocationTag"><code class="csfmt">\GlsXtrEnablePreLocationTag</code></a><span class="qquad"></span><a href="#sec:glosstylenumlist">§8.6.3</a>; <a href="#wrglossary.10793">423</a>, <a href="#wrglossary.10801">424</a>, <span class="summarylocfmt"><a href="#wrglossary.19809">799</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrenablerecordcount"><code class="csfmt">\glsxtrenablerecordcount</code></a><span class="qquad"></span><a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.1705">56</a>, <a href="#wrglossary.12848">527</a>, <span class="summarylocfmt"><a href="#wrglossary.19812">799</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrendfor"><code class="csfmt">\glsxtrendfor</code></a><span class="qquad"></span><a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7809">301</a>, <span class="summarylocfmt"><a href="#wrglossary.19817">800</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrentryfmt"><code class="csfmt">\Glsxtrentryfmt</code></a><span class="qquad"></span><a href="#sec:glsxtrfmt">§5.12.2</a>; <a href="#wrglossary.7745">298</a>, <span class="summarylocfmt"><a href="#wrglossary.19820">800</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrentryfmt"><code class="csfmt">\glsxtrentryfmt</code></a><span class="qquad"></span><a href="#sec:glsxtrfmt">§5.12.2</a>; <a href="#wrglossary.7701">296</a>, <a href="#wrglossary.7751">299</a>, <span class="summarylocfmt"><a href="#wrglossary.19824">800</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrentryparentname"><code class="csfmt">\glsxtrentryparentname</code></a><span class="qquad"></span><a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.7606">291</a>, <span class="summarylocfmt"><a href="#wrglossary.19829">800</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrequationlocfmt"><code class="csfmt">\glsxtrequationlocfmt</code></a><span class="qquad"></span><a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13618">558</a>, <span class="summarylocfmt"><a href="#wrglossary.19833">800</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrExpandedFmt"><code class="csfmt">\GlsXtrExpandedFmt</code></a><span class="qquad"></span><a href="#sec:entryfmtmods">§5.5</a>; <a href="#wrglossary.6057">236</a>, <a href="#wrglossary.7546">289</a>, <span class="summarylocfmt"><a href="#wrglossary.19838">800</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfielddolistloop"><code class="csfmt">\glsxtrfielddolistloop</code></a><span class="qquad"></span><a href="#sec:listfields">§5.14</a>; <a href="#wrglossary.1178">39</a>, <a href="#wrglossary.7871">304</a>, <span class="summarylocfmt"><a href="#wrglossary.19840">800</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfieldforlistloop"><code class="csfmt">\glsxtrfieldforlistloop</code></a><span class="qquad"></span><a href="#sec:listfields">§5.14</a>; <a href="#wrglossary.1179">39</a>, <a href="#wrglossary.7874">304</a>, <span class="summarylocfmt"><a href="#wrglossary.19844">801</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfieldformatcsvlist"><code class="csfmt">\glsxtrfieldformatcsvlist</code></a><span class="qquad"></span><a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.1173">39</a>, <a href="#wrglossary.7813">302</a>, <span class="summarylocfmt"><a href="#wrglossary.19848">801</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfieldformatlist"><code class="csfmt">\glsxtrfieldformatlist</code></a><span class="qquad"></span><a href="#sec:listfields">§5.14</a>; <a href="#wrglossary.7865">304</a>, <span class="summarylocfmt"><a href="#wrglossary.19856">801</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfieldifinlist"><code class="csfmt">\glsxtrfieldifinlist</code></a><span class="qquad"></span><a href="#sec:listfields">§5.14</a>; <a href="#wrglossary.7877">304</a>, <span class="summarylocfmt"><a href="#wrglossary.19861">801</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfieldlistadd"><code class="csfmt">\glsxtrfieldlistadd</code></a><span class="qquad"></span><a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1174">39</a>, <a href="#wrglossary.7863">304</a>, <span class="summarylocfmt"><a href="#wrglossary.19865">801</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfieldlisteadd"><code class="csfmt">\glsxtrfieldlisteadd</code></a><span class="qquad"></span><a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1182">39</a>, <span class="summarylocfmt"><a href="#wrglossary.19869">801</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfieldlistgadd"><code class="csfmt">\glsxtrfieldlistgadd</code></a><span class="qquad"></span><a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1180">39</a>, <span class="summarylocfmt"><a href="#wrglossary.19873">801</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfieldlistxadd"><code class="csfmt">\glsxtrfieldlistxadd</code></a><span class="qquad"></span><a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1184">39</a>, <span class="summarylocfmt"><a href="#wrglossary.19877">802</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfieldtitlecase"><code class="csfmt">\glsxtrfieldtitlecase</code></a><span class="qquad"></span><a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.7599">291</a>, <span class="summarylocfmt"><a href="#wrglossary.19881">802</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfieldtitlecasecs"><code class="csfmt">\glsxtrfieldtitlecasecs</code></a><span class="qquad"></span><a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.7602">291</a>, <a href="#wrglossary.12219">500</a>, <span class="summarylocfmt"><a href="#wrglossary.19884">802</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfieldxifinlist"><code class="csfmt">\glsxtrfieldxifinlist</code></a><span class="qquad"></span><a href="#sec:listfields">§5.14</a>; <a href="#wrglossary.7880">305</a>, <a href="#wrglossary.10443">408</a>, <span class="summarylocfmt"><a href="#wrglossary.19889">802</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfirstscfont"><code class="csfmt">\glsxtrfirstscfont</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19893">802</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfirstsmfont"><code class="csfmt">\glsxtrfirstsmfont</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.19897">802</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrfmt"><code class="csfmt">\Glsxtrfmt</code></a><span class="qquad"></span><a href="#sec:glsxtrfmt">§5.12.2</a>; <a href="#wrglossary.7739">298</a>, <span class="summarylocfmt"><a href="#wrglossary.19901">802</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfmt"><code class="csfmt">\glsxtrfmt</code></a><span class="qquad"></span><a href="#sec:glsxtrfmt">§5.12.2</a>; <a href="#wrglossary.4693">186</a>–<a href="#wrglossary.4798">190</a>, <a href="#wrglossary.7690">295</a>, <a href="#wrglossary.7699">296</a>, <a href="#wrglossary.7737">298</a>, <a href="#wrglossary.7750">299</a>, <a href="#wrglossary.14220">588</a>, <span class="summarylocfmt"><a href="#wrglossary.19905">803</a></span>, <a href="#wrglossary.19932">804</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrfmt*"><code class="csfmt">\Glsxtrfmt*</code></a><span class="qquad"></span><a href="#sec:glsxtrfmt">§5.12.2</a>; <a href="#wrglossary.7742">298</a>, <span class="summarylocfmt"><a href="#wrglossary.19911">803</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfmt*"><code class="csfmt">\glsxtrfmt*</code></a><span class="qquad"></span><a href="#wrglossary.7736">298</a>, <span class="summarylocfmt"><a href="#wrglossary.19915">803</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrFmtDefaultOptions"><code class="csfmt">\GlsXtrFmtDefaultOptions</code></a><span class="qquad"></span><a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4705">186</a>, <a href="#wrglossary.4750">188</a>, <a href="#wrglossary.7697">296</a>, <span class="summarylocfmt"><a href="#wrglossary.19918">803</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfmtdisplay"><code class="csfmt">\glsxtrfmtdisplay</code></a><span class="qquad"></span><a href="#sec:glsxtrfmt">§5.12.2</a>; <a href="#wrglossary.7693">296</a>, <span class="summarylocfmt"><a href="#wrglossary.19921">803</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfmtexternalnameref"><code class="csfmt">\glsxtrfmtexternalnameref</code></a><span class="qquad"></span><a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13637">559</a>, <span class="summarylocfmt"><a href="#wrglossary.19925">803</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrFmtField"><code class="csfmt">\GlsXtrFmtField</code></a><span class="qquad"></span><a href="#sec:glsxtrfmt">§5.12.2</a>; <a href="#wrglossary.7687">295</a>, <a href="#wrglossary.7694">296</a>, <a href="#wrglossary.19826">800</a>, <span class="summarylocfmt"><a href="#wrglossary.19929">803</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfmtinternalnameref"><code class="csfmt">\glsxtrfmtinternalnameref</code></a><span class="qquad"></span><a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13636">559</a>, <span class="summarylocfmt"><a href="#wrglossary.19933">804</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfootnotedescname"><code class="csfmt">\glsxtrfootnotedescname</code></a><span class="qquad"></span><a href="#wrglossary.3036">116</a>, <a href="#wrglossary.3580">144</a>, <span class="summarylocfmt"><a href="#wrglossary.19937">804</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfootnotedescsort"><code class="csfmt">\glsxtrfootnotedescsort</code></a><span class="qquad"></span><a href="#wrglossary.3037">116</a>, <a href="#wrglossary.3592">145</a>, <span class="summarylocfmt"><a href="#wrglossary.19940">804</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfootnotelongformat"><code class="csfmt">\glsxtrfootnotelongformat</code></a><span class="qquad"></span><a href="#wrglossary.3605">145</a>, <a href="#wrglossary.3624">146</a>, <span class="summarylocfmt"><a href="#wrglossary.19943">804</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfootnotelongplformat"><code class="csfmt">\glsxtrfootnotelongplformat</code></a><span class="qquad"></span><a href="#wrglossary.3616">146</a>, <span class="summarylocfmt"><a href="#wrglossary.19945">804</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfootnotename"><code class="csfmt">\glsxtrfootnotename</code></a><span class="qquad"></span><a href="#wrglossary.3020">115</a>, <a href="#wrglossary.3575">144</a>, <span class="summarylocfmt"><a href="#wrglossary.19947">804</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrforcsvfield"><code class="csfmt">\glsxtrforcsvfield</code></a><span class="qquad"></span><a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.1172">39</a>, <a href="#wrglossary.7804">301</a>, <a href="#wrglossary.19819">800</a>, <span class="summarylocfmt"><a href="#wrglossary.19950">804</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrForeignText"><code class="csfmt">\GlsXtrForeignText</code></a><span class="qquad"></span><a href="#sec:foreignfield">§5.12.1</a>; <a href="#wrglossary.7655">293</a>, <a href="#wrglossary.7665">294</a>, <span class="summarylocfmt"><a href="#wrglossary.19956">805</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrForeignTextField"><code class="csfmt">\GlsXtrForeignTextField</code></a><span class="qquad"></span><a href="#sec:foreignfield">§5.12.1</a>; <a href="#wrglossary.7652">293</a>, <span class="summarylocfmt"><a href="#wrglossary.19960">805</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrFormatLocationList"><code class="csfmt">\GlsXtrFormatLocationList</code></a><span class="qquad"></span><a href="#sec:glosstylenumlist">§8.6.3</a>; <a href="#wrglossary.10771">423</a>, <span class="summarylocfmt"><a href="#wrglossary.19964">805</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrForUnsetBufferedList"><code class="csfmt">\GlsXtrForUnsetBufferedList</code></a><span class="qquad"></span><a href="#sec:unsetbuffer">§5.10.1</a>; <a href="#wrglossary.7471">285</a>, <a href="#wrglossary.7572">290</a>, <span class="summarylocfmt"><a href="#wrglossary.19968">805</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfractionrules"><code class="csfmt">\glsxtrfractionrules</code></a><span class="qquad"></span><a href="#wrglossary.13300">546</a>, <span class="summarylocfmt"><a href="#wrglossary.19970">805</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrfull"><code class="csfmt">\GLSxtrfull</code></a><span class="qquad"></span><a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.1576">54</a>, <a href="#wrglossary.3512">142</a>, <a href="#wrglossary.4439">175</a>, <a href="#wrglossary.5417">211</a>, <a href="#wrglossary.15746">655</a>, <a href="#wrglossary.17698">717</a>, <span class="summarylocfmt"><a href="#wrglossary.19972">805</a></span>, <a href="#wrglossary.20487">825</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrfull"><code class="csfmt">\Glsxtrfull</code></a><span class="qquad"></span><a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.1571">53</a>, <a href="#wrglossary.3496">141</a>, <a href="#wrglossary.4433">175</a>, <a href="#wrglossary.5413">211</a>, <a href="#wrglossary.15753">655</a>, <a href="#wrglossary.16031">660</a>, <a href="#wrglossary.17712">717</a>, <span class="summarylocfmt"><a href="#wrglossary.19979">806</a></span>, <a href="#wrglossary.20491">825</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfull"><code class="csfmt">\glsxtrfull</code></a><span class="qquad"></span><a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.1323">43</a>, <a href="#wrglossary.1422">47</a>, <a href="#wrglossary.1475">50</a>, <a href="#wrglossary.1492">51</a>, <a href="#wrglossary.1564">53</a>, <a href="#wrglossary.1599">54</a>, <a href="#wrglossary.2769">105</a>, <a href="#wrglossary.3445">139</a>–<a href="#wrglossary.3543">143</a>, <a href="#wrglossary.3959">159</a>, <a href="#wrglossary.3988">161</a>, <a href="#wrglossary.4428">175</a>, <a href="#wrglossary.4652">185</a>, <a href="#wrglossary.5410">211</a>, <a href="#wrglossary.6014">235</a>, <a href="#wrglossary.6443">252</a>, <a href="#wrglossary.6484">254</a>, <a href="#wrglossary.7376">282</a>, <a href="#wrglossary.9111">365</a>, <a href="#wrglossary.14316">599</a>, <a href="#wrglossary.14418">601</a>, <a href="#wrglossary.15101">631</a>, <a href="#wrglossary.15137">632</a>, <a href="#wrglossary.15359">641</a>, <a href="#wrglossary.15763">655</a>, <a href="#wrglossary.16045">660</a>, <a href="#wrglossary.17724">717</a>, <a href="#wrglossary.19976">805</a>, <span class="summarylocfmt"><a href="#wrglossary.19988">806</a></span>, <a href="#wrglossary.20055">807</a>, <a href="#wrglossary.20495">825</a>, <a href="#wrglossary.21332">861</a>, <a href="#wrglossary.21468">867</a>, <a href="#wrglossary.22382">905</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrfullformat"><code class="csfmt">\GLSxtrfullformat</code></a><span class="qquad"></span><a href="#wrglossary.4304">170</a>, <a href="#wrglossary.4355">173</a>, <span class="summarylocfmt"><a href="#wrglossary.20001">806</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrfullformat"><code class="csfmt">\Glsxtrfullformat</code></a><span class="qquad"></span><a href="#wrglossary.4345">172</a>, <span class="summarylocfmt"><a href="#wrglossary.20005">806</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfullformat"><code class="csfmt">\glsxtrfullformat</code></a><span class="qquad"></span><a href="#wrglossary.1786">61</a>, <a href="#wrglossary.4308">170</a>, <a href="#wrglossary.4337">172</a>, <a href="#wrglossary.6556">255</a>, <span class="summarylocfmt"><a href="#wrglossary.20009">806</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrfullpl"><code class="csfmt">\GLSxtrfullpl</code></a><span class="qquad"></span><a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.1593">54</a>, <a href="#wrglossary.3519">142</a>, <a href="#wrglossary.4442">175</a>, <a href="#wrglossary.15773">655</a>, <a href="#wrglossary.16052">660</a>, <a href="#wrglossary.17799">720</a>, <span class="summarylocfmt"><a href="#wrglossary.20012">806</a></span>, <a href="#wrglossary.20499">825</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrfullpl"><code class="csfmt">\Glsxtrfullpl</code></a><span class="qquad"></span><a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.1588">54</a>, <a href="#wrglossary.4436">175</a>, <a href="#wrglossary.5423">211</a>, <a href="#wrglossary.15780">655</a>, <a href="#wrglossary.16059">661</a>, <a href="#wrglossary.17813">720</a>, <span class="summarylocfmt"><a href="#wrglossary.20019">806</a></span>, <a href="#wrglossary.20503">826</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfullpl"><code class="csfmt">\glsxtrfullpl</code></a><span class="qquad"></span><a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.1581">54</a>, <a href="#wrglossary.3457">140</a>, <a href="#wrglossary.3481">141</a>, <a href="#wrglossary.4430">175</a>, <a href="#wrglossary.5420">211</a>, <a href="#wrglossary.14419">601</a>, <a href="#wrglossary.15790">655</a>, <a href="#wrglossary.16066">661</a>, <a href="#wrglossary.17825">720</a>, <a href="#wrglossary.20016">806</a>, <span class="summarylocfmt"><a href="#wrglossary.20028">807</a></span>, <a href="#wrglossary.20507">826</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrfullplformat"><code class="csfmt">\GLSxtrfullplformat</code></a><span class="qquad"></span><a href="#wrglossary.4305">170</a>, <a href="#wrglossary.4360">173</a>, <span class="summarylocfmt"><a href="#wrglossary.20041">807</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrfullplformat"><code class="csfmt">\Glsxtrfullplformat</code></a><span class="qquad"></span><a href="#wrglossary.4350">172</a>, <span class="summarylocfmt"><a href="#wrglossary.20045">807</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfullplformat"><code class="csfmt">\glsxtrfullplformat</code></a><span class="qquad"></span><a href="#wrglossary.4309">170</a>, <a href="#wrglossary.4341">172</a>, <span class="summarylocfmt"><a href="#wrglossary.20049">807</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfullsaveinsert"><code class="csfmt">\glsxtrfullsaveinsert</code></a><span class="qquad"></span><a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1606">54</a>, <a href="#wrglossary.2777">105</a>, <a href="#wrglossary.2819">107</a>, <a href="#wrglossary.2891">109</a>, <a href="#wrglossary.2932">111</a>, <a href="#wrglossary.6485">254</a>, <span class="summarylocfmt"><a href="#wrglossary.20052">807</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrfullsep"><code class="csfmt">\glsxtrfullsep</code></a><span class="qquad"></span><a href="#tab:acrabbrvstyles">Table 4.2</a>; <a href="#wrglossary.3264">132</a>, <a href="#wrglossary.3693">149</a>, <a href="#wrglossary.3759">151</a>, <span class="summarylocfmt"><a href="#wrglossary.20058">807</a></span>, <a href="#wrglossary.22012">890</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrgenabbrvfmt"><code class="csfmt">\glsxtrgenabbrvfmt</code></a><span class="qquad"></span><a href="#sec:entryfmt">§5.5.5</a>; <a href="#wrglossary.1774">60</a>, <a href="#wrglossary.2215">81</a>, <a href="#wrglossary.6549">255</a>, <a href="#wrglossary.12079">494</a>, <a href="#wrglossary.16268">668</a>, <a href="#wrglossary.17384">706</a>, <span class="summarylocfmt"><a href="#wrglossary.20061">808</a></span>, <a href="#wrglossary.21695">875</a>, <a href="#wrglossary.21703">876</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrgenentrytextfmt"><code class="csfmt">\glsxtrgenentrytextfmt</code></a><span class="qquad"></span><a href="#sec:innertextformat">§5.5.3</a>; <a href="#wrglossary.4152">167</a>, <a href="#wrglossary.4189">168</a>, <a href="#wrglossary.4389">174</a>, <a href="#wrglossary.4449">176</a>, <a href="#wrglossary.4484">177</a>, <a href="#wrglossary.4830">191</a>, <a href="#wrglossary.6208">243</a>, <a href="#wrglossary.6239">244</a>, <a href="#wrglossary.6489">254</a>, <a href="#wrglossary.14425">601</a>, <a href="#wrglossary.17766">719</a>, <a href="#wrglossary.17906">723</a>, <a href="#wrglossary.18081">732</a>, <a href="#wrglossary.19498">784</a>, <span class="summarylocfmt"><a href="#wrglossary.20065">808</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrGeneralInitRules"><code class="csfmt">\glsxtrGeneralInitRules</code></a><span class="qquad"></span><a href="#wrglossary.13305">546</a>, <span class="summarylocfmt"><a href="#wrglossary.20071">808</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrGeneralLatinAtoGrules"><code class="csfmt">\glsxtrGeneralLatinAtoGrules</code></a><span class="qquad"></span><a href="#wrglossary.13330">548</a>, <span class="summarylocfmt"><a href="#wrglossary.20073">808</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrGeneralLatinAtoMrules"><code class="csfmt">\glsxtrGeneralLatinAtoMrules</code></a><span class="qquad"></span><a href="#wrglossary.13328">548</a>, <span class="summarylocfmt"><a href="#wrglossary.20075">808</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrGeneralLatinHtoMrules"><code class="csfmt">\glsxtrGeneralLatinHtoMrules</code></a><span class="qquad"></span><a href="#wrglossary.13331">548</a>, <span class="summarylocfmt"><a href="#wrglossary.20077">808</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrGeneralLatinIIIrules"><code class="csfmt">\glsxtrGeneralLatinIIIrules</code></a><span class="qquad"></span><a href="#wrglossary.13316">547</a>, <span class="summarylocfmt"><a href="#wrglossary.20079">808</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrGeneralLatinIIrules"><code class="csfmt">\glsxtrGeneralLatinIIrules</code></a><span class="qquad"></span><a href="#wrglossary.13314">547</a>, <span class="summarylocfmt"><a href="#wrglossary.20081">809</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrGeneralLatinIrules"><code class="csfmt">\glsxtrGeneralLatinIrules</code></a><span class="qquad"></span><a href="#wrglossary.13312">546</a>–<a href="#wrglossary.13327">548</a>, <span class="summarylocfmt"><a href="#wrglossary.20083">809</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrGeneralLatinIVrules"><code class="csfmt">\glsxtrGeneralLatinIVrules</code></a><span class="qquad"></span><a href="#wrglossary.13318">547</a>, <span class="summarylocfmt"><a href="#wrglossary.20085">809</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrGeneralLatinNtoSrules"><code class="csfmt">\glsxtrGeneralLatinNtoSrules</code></a><span class="qquad"></span><a href="#wrglossary.13332">548</a>, <span class="summarylocfmt"><a href="#wrglossary.20087">809</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrGeneralLatinNtoZrules"><code class="csfmt">\glsxtrGeneralLatinNtoZrules</code></a><span class="qquad"></span><a href="#wrglossary.13329">548</a>, <span class="summarylocfmt"><a href="#wrglossary.20089">809</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrGeneralLatinTtoZrules"><code class="csfmt">\glsxtrGeneralLatinTtoZrules</code></a><span class="qquad"></span><a href="#wrglossary.13333">548</a>, <span class="summarylocfmt"><a href="#wrglossary.20091">809</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrGeneralLatinVIIIrules"><code class="csfmt">\glsxtrGeneralLatinVIIIrules</code></a><span class="qquad"></span><a href="#wrglossary.13326">547</a>, <span class="summarylocfmt"><a href="#wrglossary.20093">809</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrGeneralLatinVIIrules"><code class="csfmt">\glsxtrGeneralLatinVIIrules</code></a><span class="qquad"></span><a href="#wrglossary.13324">547</a>, <span class="summarylocfmt"><a href="#wrglossary.20095">809</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrGeneralLatinVIrules"><code class="csfmt">\glsxtrGeneralLatinVIrules</code></a><span class="qquad"></span><a href="#wrglossary.13322">547</a>, <span class="summarylocfmt"><a href="#wrglossary.20097">810</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrGeneralLatinVrules"><code class="csfmt">\glsxtrGeneralLatinVrules</code></a><span class="qquad"></span><a href="#wrglossary.13320">547</a>, <span class="summarylocfmt"><a href="#wrglossary.20099">810</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrgeneralpuncaccentsrules"><code class="csfmt">\glsxtrgeneralpuncaccentsrules</code></a><span class="qquad"></span><a href="#wrglossary.13290">544</a>, <span class="summarylocfmt"><a href="#wrglossary.20101">810</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrgeneralpuncbracketrules"><code class="csfmt">\glsxtrgeneralpuncbracketrules</code></a><span class="qquad"></span><a href="#wrglossary.13292">544</a>, <span class="summarylocfmt"><a href="#wrglossary.20104">810</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrgeneralpuncIIrules"><code class="csfmt">\glsxtrgeneralpuncIIrules</code></a><span class="qquad"></span><a href="#wrglossary.13295">545</a>, <span class="summarylocfmt"><a href="#wrglossary.20107">810</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrgeneralpuncIrules"><code class="csfmt">\glsxtrgeneralpuncIrules</code></a><span class="qquad"></span><a href="#wrglossary.13281">544</a>, <span class="summarylocfmt"><a href="#wrglossary.20109">810</a></span>, <a href="#wrglossary.20121">811</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrgeneralpuncmarksrules"><code class="csfmt">\glsxtrgeneralpuncmarksrules</code></a><span class="qquad"></span><a href="#wrglossary.13288">544</a>, <span class="summarylocfmt"><a href="#wrglossary.20111">810</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrgeneralpuncquoterules"><code class="csfmt">\glsxtrgeneralpuncquoterules</code></a><span class="qquad"></span><a href="#wrglossary.13291">544</a>, <span class="summarylocfmt"><a href="#wrglossary.20114">810</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrgeneralpuncrules"><code class="csfmt">\glsxtrgeneralpuncrules</code></a><span class="qquad"></span><a href="#wrglossary.13274">543</a>, <span class="summarylocfmt"><a href="#wrglossary.20117">811</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrgeneralpuncsignrules"><code class="csfmt">\glsxtrgeneralpuncsignrules</code></a><span class="qquad"></span><a href="#wrglossary.13293">545</a>, <span class="summarylocfmt"><a href="#wrglossary.20119">811</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrgetgrouptitle"><code class="csfmt">\glsxtrgetgrouptitle</code></a><span class="qquad"></span><a href="#sec:glosgroups">§8.6.4</a>; <a href="#wrglossary.10848">426</a>, <a href="#wrglossary.11521">465</a>, <span class="summarylocfmt"><a href="#wrglossary.20122">811</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrgroupfield"><code class="csfmt">\glsxtrgroupfield</code></a><span class="qquad"></span><a href="#sec:printunsrtgroups">§8.4.1</a>; <a href="#wrglossary.9859">389</a>–<a href="#wrglossary.9948">391</a>, <span class="summarylocfmt"><a href="#wrglossary.20125">811</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a><span class="qquad"></span><a href="#sec:glossentry">§8.5</a>; <a href="#wrglossary.10544">414</a>, <a href="#wrglossary.10606">417</a>, <a href="#wrglossary.10752">422</a>, <span class="summarylocfmt"><a href="#wrglossary.20129">811</a></span>, <a href="#wrglossary.21662">874</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrglossentryother"><code class="csfmt">\glsxtrglossentryother</code></a><span class="qquad"></span><a href="#sec:glossentry">§8.5</a>; <a href="#wrglossary.10579">415</a>, <a href="#wrglossary.10626">417</a>, <span class="summarylocfmt"><a href="#wrglossary.20132">811</a></span>, <a href="#wrglossary.21665">874</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrheadfirst"><code class="csfmt">\GLSxtrheadfirst</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5787">226</a>, <span class="summarylocfmt"><a href="#wrglossary.20136">811</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GLSfmtfirst"><code class="csfmt">\GLSfmtfirst</code></a> &amp; <a href="#glo:GLSxtrtitlefirst"><code class="csfmt">\GLSxtrtitlefirst</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrheadfirst"><code class="csfmt">\Glsxtrheadfirst</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5779">225</a>, <span class="summarylocfmt"><a href="#wrglossary.20141">812</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:Glsfmtfirst"><code class="csfmt">\Glsfmtfirst</code></a> &amp; <a href="#glo:Glsxtrtitlefirst"><code class="csfmt">\Glsxtrtitlefirst</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrheadfirst"><code class="csfmt">\glsxtrheadfirst</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5772">225</a>, <span class="summarylocfmt"><a href="#wrglossary.20147">812</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsfmtfirst"><code class="csfmt">\glsfmtfirst</code></a> &amp; <a href="#glo:glsxtrtitlefirst"><code class="csfmt">\glsxtrtitlefirst</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrheadfirstplural"><code class="csfmt">\GLSxtrheadfirstplural</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5809">226</a>, <span class="summarylocfmt"><a href="#wrglossary.20152">812</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GLSfmtfirstpl"><code class="csfmt">\GLSfmtfirstpl</code></a> &amp; <a href="#glo:GLSxtrtitlefirstplural"><code class="csfmt">\GLSxtrtitlefirstplural</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrheadfirstplural"><code class="csfmt">\Glsxtrheadfirstplural</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5801">226</a>, <span class="summarylocfmt"><a href="#wrglossary.20157">812</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:Glsfmtfirstpl"><code class="csfmt">\Glsfmtfirstpl</code></a> &amp; <a href="#glo:Glsxtrtitlefirstplural"><code class="csfmt">\Glsxtrtitlefirstplural</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrheadfirstplural"><code class="csfmt">\glsxtrheadfirstplural</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5794">226</a>, <span class="summarylocfmt"><a href="#wrglossary.20163">812</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsfmtfirstpl"><code class="csfmt">\glsfmtfirstpl</code></a> &amp; <a href="#glo:glsxtrtitlefirstplural"><code class="csfmt">\glsxtrtitlefirstplural</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrheadfull"><code class="csfmt">\GLSxtrheadfull</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5684">222</a>, <span class="summarylocfmt"><a href="#wrglossary.20168">812</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GLSfmtfull"><code class="csfmt">\GLSfmtfull</code></a> &amp; <a href="#glo:GLSxtrtitlefull"><code class="csfmt">\GLSxtrtitlefull</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrheadfull"><code class="csfmt">\Glsxtrheadfull</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5678">222</a>, <span class="summarylocfmt"><a href="#wrglossary.20171">812</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:Glsfmtfull"><code class="csfmt">\Glsfmtfull</code></a> &amp; <a href="#glo:Glsxtrtitlefull"><code class="csfmt">\Glsxtrtitlefull</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrheadfull"><code class="csfmt">\glsxtrheadfull</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5673">221</a>, <span class="summarylocfmt"><a href="#wrglossary.20176">813</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsfmtfull"><code class="csfmt">\glsfmtfull</code></a> &amp; <a href="#glo:glsxtrtitlefull"><code class="csfmt">\glsxtrtitlefull</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrheadfullpl"><code class="csfmt">\GLSxtrheadfullpl</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5700">223</a>, <span class="summarylocfmt"><a href="#wrglossary.20180">813</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GLSfmtfullpl"><code class="csfmt">\GLSfmtfullpl</code></a> &amp; <a href="#glo:GLSxtrtitlefullpl"><code class="csfmt">\GLSxtrtitlefullpl</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrheadfullpl"><code class="csfmt">\Glsxtrheadfullpl</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5694">222</a>, <span class="summarylocfmt"><a href="#wrglossary.20183">813</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:Glsfmtfullpl"><code class="csfmt">\Glsfmtfullpl</code></a> &amp; <a href="#glo:Glsxtrtitlefullpl"><code class="csfmt">\Glsxtrtitlefullpl</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrheadfullpl"><code class="csfmt">\glsxtrheadfullpl</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5689">222</a>, <span class="summarylocfmt"><a href="#wrglossary.20188">813</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsfmtfullpl"><code class="csfmt">\glsfmtfullpl</code></a> &amp; <a href="#glo:glsxtrtitlefullpl"><code class="csfmt">\glsxtrtitlefullpl</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrheadlong"><code class="csfmt">\GLSxtrheadlong</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5652">220</a>, <span class="summarylocfmt"><a href="#wrglossary.20192">813</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrheadlong"><code class="csfmt">\Glsxtrheadlong</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5646">220</a>, <span class="summarylocfmt"><a href="#wrglossary.20195">813</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrheadlong"><code class="csfmt">\glsxtrheadlong</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5641">220</a>, <span class="summarylocfmt"><a href="#wrglossary.20198">813</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrheadlongpl"><code class="csfmt">\GLSxtrheadlongpl</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5668">221</a>, <span class="summarylocfmt"><a href="#wrglossary.20201">814</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrheadlongpl"><code class="csfmt">\Glsxtrheadlongpl</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5662">221</a>, <span class="summarylocfmt"><a href="#wrglossary.20204">814</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrheadlongpl"><code class="csfmt">\glsxtrheadlongpl</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5657">221</a>, <span class="summarylocfmt"><a href="#wrglossary.20207">814</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrheadname"><code class="csfmt">\GLSxtrheadname</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5721">223</a>, <span class="summarylocfmt"><a href="#wrglossary.20210">814</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GLSfmtname"><code class="csfmt">\GLSfmtname</code></a> &amp; <a href="#glo:GLSxtrtitlename"><code class="csfmt">\GLSxtrtitlename</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrheadname"><code class="csfmt">\Glsxtrheadname</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5713">223</a>, <span class="summarylocfmt"><a href="#wrglossary.20215">814</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:Glsfmtname"><code class="csfmt">\Glsfmtname</code></a> &amp; <a href="#glo:Glsxtrtitlename"><code class="csfmt">\Glsxtrtitlename</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrheadname"><code class="csfmt">\glsxtrheadname</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5706">223</a>, <a href="#wrglossary.10614">417</a>, <span class="summarylocfmt"><a href="#wrglossary.20220">814</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsfmtname"><code class="csfmt">\glsfmtname</code></a> &amp; <a href="#glo:glsxtrtitlename"><code class="csfmt">\glsxtrtitlename</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrheadplural"><code class="csfmt">\GLSxtrheadplural</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5765">225</a>, <span class="summarylocfmt"><a href="#wrglossary.20224">814</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GLSfmtplural"><code class="csfmt">\GLSfmtplural</code></a> &amp; <a href="#glo:GLSxtrtitleplural"><code class="csfmt">\GLSxtrtitleplural</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrheadplural"><code class="csfmt">\Glsxtrheadplural</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5757">225</a>, <span class="summarylocfmt"><a href="#wrglossary.20229">815</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:Glsfmtplural"><code class="csfmt">\Glsfmtplural</code></a> &amp; <a href="#glo:Glsxtrtitleplural"><code class="csfmt">\Glsxtrtitleplural</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrheadplural"><code class="csfmt">\glsxtrheadplural</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5750">224</a>, <span class="summarylocfmt"><a href="#wrglossary.20235">815</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsfmtplural"><code class="csfmt">\glsfmtplural</code></a> &amp; <a href="#glo:glsxtrtitleplural"><code class="csfmt">\glsxtrtitleplural</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrheadshort"><code class="csfmt">\GLSxtrheadshort</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5600">218</a>, <span class="summarylocfmt"><a href="#wrglossary.20240">815</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrheadshort"><code class="csfmt">\Glsxtrheadshort</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5576">217</a>, <a href="#wrglossary.5581">218</a>, <span class="summarylocfmt"><a href="#wrglossary.20243">815</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrheadshort"><code class="csfmt">\glsxtrheadshort</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5560">217</a>, <span class="summarylocfmt"><a href="#wrglossary.20245">815</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrheadshortpl"><code class="csfmt">\GLSxtrheadshortpl</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5636">220</a>, <span class="summarylocfmt"><a href="#wrglossary.20247">815</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrheadshortpl"><code class="csfmt">\Glsxtrheadshortpl</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5630">219</a>, <span class="summarylocfmt"><a href="#wrglossary.20250">815</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrheadshortpl"><code class="csfmt">\glsxtrheadshortpl</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5625">219</a>, <span class="summarylocfmt"><a href="#wrglossary.20252">816</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrheadtext"><code class="csfmt">\GLSxtrheadtext</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5743">224</a>, <span class="summarylocfmt"><a href="#wrglossary.20255">816</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GLSfmttext"><code class="csfmt">\GLSfmttext</code></a> &amp; <a href="#glo:GLSxtrtitletext"><code class="csfmt">\GLSxtrtitletext</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrheadtext"><code class="csfmt">\Glsxtrheadtext</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5735">224</a>, <span class="summarylocfmt"><a href="#wrglossary.20260">816</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:Glsfmttext"><code class="csfmt">\Glsfmttext</code></a> &amp; <a href="#glo:Glsxtrtitletext"><code class="csfmt">\Glsxtrtitletext</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrheadtext"><code class="csfmt">\glsxtrheadtext</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5728">224</a>, <span class="summarylocfmt"><a href="#wrglossary.20266">816</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsfmttext"><code class="csfmt">\glsfmttext</code></a> &amp; <a href="#glo:glsxtrtitletext"><code class="csfmt">\glsxtrtitletext</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSXTRhiername"><code class="csfmt">\GLSXTRhiername</code></a><span class="qquad"></span><a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.7646">293</a>, <span class="summarylocfmt"><a href="#wrglossary.20271">816</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrhiername"><code class="csfmt">\GLSxtrhiername</code></a><span class="qquad"></span><a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.7641">293</a>, <span class="summarylocfmt"><a href="#wrglossary.20274">816</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrhiername"><code class="csfmt">\GlsXtrhiername</code></a><span class="qquad"></span><a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.7636">292</a>, <span class="summarylocfmt"><a href="#wrglossary.20277">816</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrhiername"><code class="csfmt">\Glsxtrhiername</code></a><span class="qquad"></span><a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.7622">292</a>, <span class="summarylocfmt"><a href="#wrglossary.20280">817</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrhiername"><code class="csfmt">\glsxtrhiername</code></a><span class="qquad"></span><a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.7611">292</a>, <a href="#wrglossary.7642">293</a>, <span class="summarylocfmt"><a href="#wrglossary.20283">817</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrhiernamesep"><code class="csfmt">\glsxtrhiernamesep</code></a><span class="qquad"></span><a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.7620">292</a>, <span class="summarylocfmt"><a href="#wrglossary.20285">817</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrhyphenrules"><code class="csfmt">\glsxtrhyphenrules</code></a><span class="qquad"></span><a href="#wrglossary.13273">543</a>, <span class="summarylocfmt"><a href="#wrglossary.20288">817</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrhyphensuffix"><code class="csfmt">\glsxtrhyphensuffix</code></a><span class="qquad"></span><a href="#wrglossary.3668">148</a>, <span class="summarylocfmt"><a href="#wrglossary.20290">817</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtridentifyglslike"><code class="csfmt">\glsxtridentifyglslike</code></a><span class="qquad"></span><a href="#sec:labelprefixes">§5.7</a>; <a href="#wrglossary.6624">258</a>, <span class="summarylocfmt"><a href="#wrglossary.20294">817</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrifallcaps"><code class="csfmt">\glsxtrifallcaps</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6460">253</a>, <span class="summarylocfmt"><a href="#wrglossary.20297">817</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrifcounttrigger"><code class="csfmt">\glsxtrifcounttrigger</code></a><span class="qquad"></span><a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.8049">311</a>, <a href="#wrglossary.12259">501</a>, <span class="summarylocfmt"><a href="#wrglossary.20300">817</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrifcustomdiscardperiod"><code class="csfmt">\glsxtrifcustomdiscardperiod</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6341">248</a>, <span class="summarylocfmt"><a href="#wrglossary.20301">818</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrifemptyglossary"><code class="csfmt">\glsxtrifemptyglossary</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.20305">818</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:ifglossaryexists"><code class="csfmt">\ifglossaryexists</code></a> &amp; <a href="#glo:GlsXtrIfInGlossary"><code class="csfmt">\GlsXtrIfInGlossary</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrIfFieldCmpNum"><code class="csfmt">\GlsXtrIfFieldCmpNum</code></a><span class="qquad"></span><a href="#sec:fieldconditionals">§5.15</a>; <a href="#wrglossary.7904">305</a>, <a href="#wrglossary.7910">306</a>, <span class="summarylocfmt"><a href="#wrglossary.20312">818</a></span>, <a href="#wrglossary.20332">819</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrIfFieldEqNum"><code class="csfmt">\GlsXtrIfFieldEqNum</code></a><span class="qquad"></span><a href="#sec:fieldconditionals">§5.15</a>; <a href="#wrglossary.7909">306</a>, <span class="summarylocfmt"><a href="#wrglossary.20316">818</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrIfFieldEqStr"><code class="csfmt">\GlsXtrIfFieldEqStr</code></a><span class="qquad"></span><a href="#sec:fieldconditionals">§5.15</a>; <a href="#wrglossary.7913">306</a>, <span class="summarylocfmt"><a href="#wrglossary.20319">818</a></span>, <a href="#wrglossary.20329">819</a>, <a href="#wrglossary.20458">824</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrIfFieldEqXpStr"><code class="csfmt">\GlsXtrIfFieldEqXpStr</code></a><span class="qquad"></span><a href="#sec:fieldconditionals">§5.15</a>; <a href="#wrglossary.7917">306</a>, <span class="summarylocfmt"><a href="#wrglossary.20327">819</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrIfFieldNonZero"><code class="csfmt">\GlsXtrIfFieldNonZero</code></a><span class="qquad"></span><a href="#sec:fieldconditionals">§5.15</a>; <a href="#wrglossary.7911">306</a>, <a href="#wrglossary.13503">554</a>, <span class="summarylocfmt"><a href="#wrglossary.20330">819</a></span>, <a href="#wrglossary.20361">820</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrIfFieldUndef"><code class="csfmt">\GlsXtrIfFieldUndef</code></a><span class="qquad"></span><a href="#sec:fieldconditionals">§5.15</a>; <a href="#wrglossary.7883">305</a>, <span class="summarylocfmt"><a href="#wrglossary.20336">819</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:ifglsfieldvoid"><code class="csfmt">\ifglsfieldvoid</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrIfFieldValueInCsvList"><code class="csfmt">\GlsXtrIfFieldValueInCsvList</code></a><span class="qquad"></span><a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7857">303</a>, <span class="summarylocfmt"><a href="#wrglossary.20343">819</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a><span class="qquad"></span><a href="#sec:fieldconditionals">§5.15</a>; <a href="#wrglossary.7271">277</a>, <a href="#wrglossary.7275">278</a>, <a href="#wrglossary.7610">292</a>, <a href="#wrglossary.7807">301</a>–<a href="#wrglossary.7905">306</a>, <a href="#wrglossary.13492">554</a>, <a href="#wrglossary.19854">801</a>, <a href="#wrglossary.19954">805</a>, <a href="#wrglossary.20323">818</a>, <span class="summarylocfmt"><a href="#wrglossary.20352">819</a></span>, <a href="#wrglossary.20424">822</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrIfHasNonZeroChildCount"><code class="csfmt">\GlsXtrIfHasNonZeroChildCount</code></a><span class="qquad"></span><a href="#sec:bib2glshier">§11.5.4</a>; <a href="#wrglossary.13502">554</a>, <span class="summarylocfmt"><a href="#wrglossary.20358">820</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrifheaduc"><code class="csfmt">\glsxtrifheaduc</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5545">216</a>, <span class="summarylocfmt"><a href="#wrglossary.20363">820</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrifhyphenstart"><code class="csfmt">\glsxtrifhyphenstart</code></a><span class="qquad"></span><a href="#sec:advancedabbrstylecmds">§4.5.2</a>; <a href="#wrglossary.3689">149</a>, <a href="#wrglossary.3983">160</a>, <span class="summarylocfmt"><a href="#wrglossary.20366">820</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrifindexing"><code class="csfmt">\glsxtrifindexing</code></a><span class="qquad"></span><a href="#sec:wrglossary">§5.8</a>; <a href="#wrglossary.6930">265</a>, <span class="summarylocfmt"><a href="#wrglossary.20368">820</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrIfInGlossary"><code class="csfmt">\GlsXtrIfInGlossary</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.20371">820</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:ifglossaryexists"><code class="csfmt">\ifglossaryexists</code></a> &amp; <a href="#glo:glsxtrifemptyglossary"><code class="csfmt">\glsxtrifemptyglossary</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrifinlabelprefixlist"><code class="csfmt">\glsxtrifinlabelprefixlist</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13741">563</a>, <span class="summarylocfmt"><a href="#wrglossary.20380">821</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtraddlabelprefix"><code class="csfmt">\glsxtraddlabelprefix</code></a> &amp; <a href="#glo:glsxtrprependlabelprefix"><code class="csfmt">\glsxtrprependlabelprefix</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrifinmark"><code class="csfmt">\glsxtrifinmark</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5486">214</a>, <a href="#wrglossary.5510">215</a>, <a href="#wrglossary.5833">227</a>, <a href="#wrglossary.15657">653</a>, <span class="summarylocfmt"><a href="#wrglossary.20382">821</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrifintoc"><code class="csfmt">\glsxtrifintoc</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5490">214</a>, <a href="#wrglossary.5551">217</a>, <span class="summarylocfmt"><a href="#wrglossary.20387">821</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrifkeydefined"><code class="csfmt">\glsxtrifkeydefined</code></a><span class="qquad"></span><a href="#sec:newkeys">§3.2</a>; <a href="#wrglossary.1049">35</a>, <span class="summarylocfmt"><a href="#wrglossary.20393">821</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtriflabelinlist"><code class="csfmt">\glsxtriflabelinlist</code></a><span class="qquad"></span><a href="#sec:printunsrtadvanced">§8.4.3</a>; <a href="#wrglossary.10272">402</a>, <span class="summarylocfmt"><a href="#wrglossary.20396">821</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrIfLinkCounterDef"><code class="csfmt">\GlsXtrIfLinkCounterDef</code></a><span class="qquad"></span><a href="#sec:linkcount">§6.2</a>; <a href="#wrglossary.8164">318</a>, <span class="summarylocfmt"><a href="#wrglossary.20398">821</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrifmulti"><code class="csfmt">\glsxtrifmulti</code></a><span class="qquad"></span><a href="#sec:multiextras">§7.13</a>; <a href="#wrglossary.9326">370</a>, <span class="summarylocfmt"><a href="#wrglossary.20400">821</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrifnextpunc"><code class="csfmt">\glsxtrifnextpunc</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6351">248</a>, <a href="#wrglossary.19452">782</a>, <a href="#wrglossary.19779">797</a>, <span class="summarylocfmt"><a href="#wrglossary.20402">822</a></span>, <a href="#wrglossary.21457">866</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrifperiod"><code class="csfmt">\glsxtrifperiod</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6321">247</a>, <a href="#wrglossary.6349">248</a>, <a href="#wrglossary.19749">796</a>, <span class="summarylocfmt"><a href="#wrglossary.20406">822</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrifrecordtrigger"><code class="csfmt">\glsxtrifrecordtrigger</code></a><span class="qquad"></span><a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12771">524</a>, <span class="summarylocfmt"><a href="#wrglossary.20409">822</a></span>, <a href="#wrglossary.21285">859</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:rgls"><code class="csfmt">\rgls</code></a>, <a href="#glo:GlsXtrSetRecordCountAttribute"><code class="csfmt">\GlsXtrSetRecordCountAttribute</code></a> &amp; <a href="#glo:switch.record-count"><span class="longargfmt">--record-count</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrIfUnusedOrUndefined"><code class="csfmt">\GlsXtrIfUnusedOrUndefined</code></a><span class="qquad"></span><a href="#sec:glsunset">§5.10</a>; <a href="#wrglossary.361">15</a>, <a href="#wrglossary.6936">265</a>, <a href="#wrglossary.7442">283</a>, <span class="summarylocfmt"><a href="#wrglossary.20413">822</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a> &amp; <a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrIfValueInFieldCsvList"><code class="csfmt">\GlsXtrIfValueInFieldCsvList</code></a><span class="qquad"></span><a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7850">303</a>, <a href="#wrglossary.7861">304</a>, <span class="summarylocfmt"><a href="#wrglossary.20417">822</a></span>, <a href="#wrglossary.23446">938</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a><span class="qquad"></span><a href="#sec:glsunset">§5.10</a>; <a href="#wrglossary.1533">52</a>, <a href="#wrglossary.1601">54</a>, <a href="#wrglossary.4847">191</a>, <a href="#wrglossary.4878">192</a>, <a href="#wrglossary.6287">246</a>, <a href="#wrglossary.6450">252</a>, <a href="#wrglossary.6455">253</a>, <a href="#wrglossary.7394">282</a>, <a href="#wrglossary.7415">283</a>, <a href="#wrglossary.8824">350</a>, <a href="#wrglossary.8833">351</a>, <span class="summarylocfmt"><a href="#wrglossary.20426">823</a></span>, <a href="#wrglossary.21447">866</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrifwasglslike"><code class="csfmt">\glsxtrifwasglslike</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6444">252</a>, <a href="#wrglossary.6454">253</a>, <span class="summarylocfmt"><a href="#wrglossary.20433">823</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrifwasglslikeandfirstuse"><code class="csfmt">\glsxtrifwasglslikeandfirstuse</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6446">252</a>, <a href="#wrglossary.7419">283</a>, <span class="summarylocfmt"><a href="#wrglossary.20439">823</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrifwassubsequentorshort"><code class="csfmt">\glsxtrifwassubsequentorshort</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6456">253</a>, <span class="summarylocfmt"><a href="#wrglossary.20445">823</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrifwassubsequentuse"><code class="csfmt">\glsxtrifwassubsequentuse</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6451">252</a>, <span class="summarylocfmt"><a href="#wrglossary.20450">823</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrIfXpFieldEqXpStr"><code class="csfmt">\GlsXtrIfXpFieldEqXpStr</code></a><span class="qquad"></span><a href="#sec:fieldconditionals">§5.15</a>; <a href="#wrglossary.7919">306</a>, <span class="summarylocfmt"><a href="#wrglossary.20456">823</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrIgnorableRules"><code class="csfmt">\glsxtrIgnorableRules</code></a><span class="qquad"></span><a href="#wrglossary.13301">546</a>, <span class="summarylocfmt"><a href="#wrglossary.20459">824</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrinclinkcounter"><code class="csfmt">\glsxtrinclinkcounter</code></a><span class="qquad"></span><a href="#sec:linkcount">§6.2</a>; <a href="#wrglossary.8155">317</a>, <span class="summarylocfmt"><a href="#wrglossary.20461">824</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrindexaliased"><code class="csfmt">\glsxtrindexaliased</code></a><span class="qquad"></span><a href="#sec:glssee">§5.9.3</a>; <a href="#wrglossary.7305">278</a>, <a href="#wrglossary.7310">279</a>, <span class="summarylocfmt"><a href="#wrglossary.20464">824</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrIndexCounterLink"><code class="csfmt">\GlsXtrIndexCounterLink</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13960">573</a>, <span class="summarylocfmt"><a href="#wrglossary.20467">824</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrindexseealso"><code class="csfmt">\glsxtrindexseealso</code></a><span class="qquad"></span><a href="#sec:glssee">§5.9.3</a>; <a href="#wrglossary.602">22</a>, <a href="#wrglossary.966">33</a>, <a href="#wrglossary.7000">266</a>, <a href="#wrglossary.7124">270</a>, <a href="#wrglossary.7288">278</a>, <span class="summarylocfmt"><a href="#wrglossary.20470">824</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glssee"><code class="csfmt">\glssee</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrinithyperoutside"><code class="csfmt">\glsxtrinithyperoutside</code></a><span class="qquad"></span><a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4695">186</a>, <a href="#wrglossary.4790">189</a>, <span class="summarylocfmt"><a href="#wrglossary.20473">824</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrinitwrgloss"><code class="csfmt">\glsxtrinitwrgloss</code></a><span class="qquad"></span><a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4691">186</a>, <a href="#wrglossary.4772">189</a>, <a href="#wrglossary.4934">194</a>, <a href="#wrglossary.6912">264</a>, <span class="summarylocfmt"><a href="#wrglossary.20476">825</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrinitwrglossbeforefalse"><code class="csfmt">\glsxtrinitwrglossbeforefalse</code></a><span class="qquad"></span><a href="#wrglossary.4789">189</a>, <span class="summarylocfmt"><a href="#wrglossary.20479">825</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrinitwrglossbeforetrue"><code class="csfmt">\glsxtrinitwrglossbeforetrue</code></a><span class="qquad"></span><a href="#wrglossary.4788">189</a>, <span class="summarylocfmt"><a href="#wrglossary.20482">825</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrinlinefullformat"><code class="csfmt">\GLSxtrinlinefullformat</code></a><span class="qquad"></span><a href="#wrglossary.4437">175</a>, <span class="summarylocfmt"><a href="#wrglossary.20485">825</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrinlinefullformat"><code class="csfmt">\Glsxtrinlinefullformat</code></a><span class="qquad"></span><a href="#wrglossary.4431">175</a>, <span class="summarylocfmt"><a href="#wrglossary.20490">825</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrinlinefullformat"><code class="csfmt">\glsxtrinlinefullformat</code></a><span class="qquad"></span><a href="#wrglossary.4427">175</a>, <span class="summarylocfmt"><a href="#wrglossary.20494">825</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrinlinefullplformat"><code class="csfmt">\GLSxtrinlinefullplformat</code></a><span class="qquad"></span><a href="#wrglossary.4440">175</a>, <span class="summarylocfmt"><a href="#wrglossary.20497">825</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrinlinefullplformat"><code class="csfmt">\Glsxtrinlinefullplformat</code></a><span class="qquad"></span><a href="#wrglossary.4434">175</a>, <span class="summarylocfmt"><a href="#wrglossary.20502">826</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrinlinefullplformat"><code class="csfmt">\glsxtrinlinefullplformat</code></a><span class="qquad"></span><a href="#wrglossary.4429">175</a>, <span class="summarylocfmt"><a href="#wrglossary.20506">826</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrinsertinsidefalse"><code class="csfmt">\glsxtrinsertinsidefalse</code></a><span class="qquad"></span><a href="#wrglossary.3256">132</a>, <span class="summarylocfmt"><a href="#wrglossary.20509">826</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrinsertinsidetrue"><code class="csfmt">\glsxtrinsertinsidetrue</code></a><span class="qquad"></span><a href="#wrglossary.3255">131</a>, <span class="summarylocfmt"><a href="#wrglossary.20512">826</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrInternalLocationHyperlink"><code class="csfmt">\GlsXtrInternalLocationHyperlink</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.20515">826</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinA"><code class="csfmt">\glsxtrLatinA</code></a><span class="qquad"></span><a href="#wrglossary.13313">547</a>, <a href="#wrglossary.13334">548</a>, <span class="summarylocfmt"><a href="#wrglossary.20518">826</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinAA"><code class="csfmt">\glsxtrLatinAA</code></a><span class="qquad"></span><a href="#wrglossary.13357">551</a>, <span class="summarylocfmt"><a href="#wrglossary.20520">826</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinAELigature"><code class="csfmt">\glsxtrLatinAELigature</code></a><span class="qquad"></span><a href="#wrglossary.13350">550</a>, <span class="summarylocfmt"><a href="#wrglossary.20522">827</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinE"><code class="csfmt">\glsxtrLatinE</code></a><span class="qquad"></span><a href="#wrglossary.13335">548</a>, <span class="summarylocfmt"><a href="#wrglossary.20524">827</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinEszettSs"><code class="csfmt">\glsxtrLatinEszettSs</code></a><span class="qquad"></span><a href="#wrglossary.13346">550</a>, <span class="summarylocfmt"><a href="#wrglossary.20526">827</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinEszettSz"><code class="csfmt">\glsxtrLatinEszettSz</code></a><span class="qquad"></span><a href="#wrglossary.13347">550</a>, <span class="summarylocfmt"><a href="#wrglossary.20528">827</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinEth"><code class="csfmt">\glsxtrLatinEth</code></a><span class="qquad"></span><a href="#wrglossary.13348">550</a>, <span class="summarylocfmt"><a href="#wrglossary.20530">827</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinH"><code class="csfmt">\glsxtrLatinH</code></a><span class="qquad"></span><a href="#wrglossary.13336">549</a>, <span class="summarylocfmt"><a href="#wrglossary.20532">827</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinI"><code class="csfmt">\glsxtrLatinI</code></a><span class="qquad"></span><a href="#wrglossary.13338">549</a>, <span class="summarylocfmt"><a href="#wrglossary.20534">827</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinInsularG"><code class="csfmt">\glsxtrLatinInsularG</code></a><span class="qquad"></span><a href="#wrglossary.13355">551</a>, <span class="summarylocfmt"><a href="#wrglossary.20536">827</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinK"><code class="csfmt">\glsxtrLatinK</code></a><span class="qquad"></span><a href="#wrglossary.13337">549</a>, <span class="summarylocfmt"><a href="#wrglossary.20538">828</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinL"><code class="csfmt">\glsxtrLatinL</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.20540">828</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinLslash"><code class="csfmt">\glsxtrLatinLslash</code></a><span class="qquad"></span><a href="#wrglossary.13353">551</a>, <span class="summarylocfmt"><a href="#wrglossary.20542">828</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinM"><code class="csfmt">\glsxtrLatinM</code></a><span class="qquad"></span><a href="#wrglossary.13339">549</a>, <span class="summarylocfmt"><a href="#wrglossary.20544">828</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinN"><code class="csfmt">\glsxtrLatinN</code></a><span class="qquad"></span><a href="#wrglossary.13340">549</a>, <span class="summarylocfmt"><a href="#wrglossary.20546">828</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinO"><code class="csfmt">\glsxtrLatinO</code></a><span class="qquad"></span><a href="#wrglossary.13341">549</a>, <span class="summarylocfmt"><a href="#wrglossary.20548">828</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinOELigature"><code class="csfmt">\glsxtrLatinOELigature</code></a><span class="qquad"></span><a href="#wrglossary.13351">550</a>, <span class="summarylocfmt"><a href="#wrglossary.20550">828</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinOslash"><code class="csfmt">\glsxtrLatinOslash</code></a><span class="qquad"></span><a href="#wrglossary.13352">550</a>, <span class="summarylocfmt"><a href="#wrglossary.20552">828</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinP"><code class="csfmt">\glsxtrLatinP</code></a><span class="qquad"></span><a href="#wrglossary.13342">549</a>, <span class="summarylocfmt"><a href="#wrglossary.20554">829</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinS"><code class="csfmt">\glsxtrLatinS</code></a><span class="qquad"></span><a href="#wrglossary.13343">549</a>, <span class="summarylocfmt"><a href="#wrglossary.20556">829</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinSchwa"><code class="csfmt">\glsxtrLatinSchwa</code></a><span class="qquad"></span><a href="#wrglossary.13356">551</a>, <span class="summarylocfmt"><a href="#wrglossary.20558">829</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinT"><code class="csfmt">\glsxtrLatinT</code></a><span class="qquad"></span><a href="#wrglossary.13344">549</a>, <span class="summarylocfmt"><a href="#wrglossary.20560">829</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinThorn"><code class="csfmt">\glsxtrLatinThorn</code></a><span class="qquad"></span><a href="#wrglossary.13349">550</a>, <span class="summarylocfmt"><a href="#wrglossary.20562">829</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinWynn"><code class="csfmt">\glsxtrLatinWynn</code></a><span class="qquad"></span><a href="#wrglossary.13354">551</a>, <span class="summarylocfmt"><a href="#wrglossary.20564">829</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrLatinX"><code class="csfmt">\glsxtrLatinX</code></a><span class="qquad"></span><a href="#wrglossary.13345">550</a>, <span class="summarylocfmt"><a href="#wrglossary.20566">829</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrLetField"><code class="csfmt">\GlsXtrLetField</code></a><span class="qquad"></span><a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1191">39</a>, <a href="#wrglossary.1209">40</a>, <a href="#wrglossary.16253">667</a>, <span class="summarylocfmt"><a href="#wrglossary.20568">829</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrLetFieldToField"><code class="csfmt">\GlsXtrLetFieldToField</code></a><span class="qquad"></span><a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1193">39</a>, <a href="#wrglossary.1219">40</a>, <span class="summarylocfmt"><a href="#wrglossary.20574">830</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrLinkCounterName"><code class="csfmt">\GlsXtrLinkCounterName</code></a><span class="qquad"></span><a href="#sec:linkcount">§6.2</a>; <a href="#wrglossary.8165">318</a>, <span class="summarylocfmt"><a href="#wrglossary.20579">830</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrLinkCounterValue"><code class="csfmt">\GlsXtrLinkCounterValue</code></a><span class="qquad"></span><a href="#sec:linkcount">§6.2</a>; <a href="#wrglossary.8161">318</a>, <a href="#wrglossary.8219">320</a>, <span class="summarylocfmt"><a href="#wrglossary.20581">830</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a><span class="qquad"></span><a href="#sec:bib2gls">§11</a>; <a href="#wrglossary.645">23</a>, <a href="#wrglossary.680">24</a>, <a href="#wrglossary.1001">34</a>, <a href="#wrglossary.1162">38</a>, <a href="#wrglossary.1746">60</a>, <a href="#wrglossary.9744">386</a>, <a href="#wrglossary.10021">394</a>, <a href="#wrglossary.10048">395</a>, <a href="#wrglossary.10195">399</a>, <a href="#wrglossary.12382">508</a>, <a href="#wrglossary.12437">510</a>–<a href="#wrglossary.12491">512</a>, <a href="#wrglossary.12632">518</a>, <a href="#wrglossary.12677">521</a>, <a href="#wrglossary.13137">536</a>, <a href="#wrglossary.14509">603</a>, <span class="summarylocfmt"><a href="#wrglossary.20583">830</a></span>, <a href="#wrglossary.21299">860</a>, <a href="#wrglossary.23619">944</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:idx.resourceopt">resource options</a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlocalsetgrouptitle"><code class="csfmt">\glsxtrlocalsetgrouptitle</code></a><span class="qquad"></span><a href="#sec:glosgroups">§8.6.4</a>; <a href="#wrglossary.10847">426</a>, <span class="summarylocfmt"><a href="#wrglossary.20588">830</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlocationanchor"><code class="csfmt">\glsxtrlocationanchor</code></a><span class="qquad"></span><a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13592">557</a>, <span class="summarylocfmt"><a href="#wrglossary.20591">830</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrLocationField"><code class="csfmt">\GlsXtrLocationField</code></a><span class="qquad"></span><a href="#sec:printunsrtlocations">§8.4.2</a>; <a href="#wrglossary.10141">398</a>, <span class="summarylocfmt"><a href="#wrglossary.20594">830</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlocationhyperlink"><code class="csfmt">\glsxtrlocationhyperlink</code></a><span class="qquad"></span><a href="#wrglossary.20517">826</a>, <span class="summarylocfmt"><a href="#wrglossary.20599">831</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrLocationRecordCount"><code class="csfmt">\GlsXtrLocationRecordCount</code></a><span class="qquad"></span><a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12732">522</a>–<a href="#wrglossary.12779">524</a>, <span class="summarylocfmt"><a href="#wrglossary.20602">831</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlocrangefmt"><code class="csfmt">\glsxtrlocrangefmt</code></a><span class="qquad"></span><a href="#sec:glosstylenumlist">§8.6.3</a>; <a href="#wrglossary.10811">424</a>, <a href="#wrglossary.10815">425</a>, <span class="summarylocfmt"><a href="#wrglossary.20607">831</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrlong"><code class="csfmt">\GLSxtrlong</code></a><span class="qquad"></span><a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.1545">53</a>, <a href="#wrglossary.5347">209</a>, <a href="#wrglossary.15800">655</a>, <a href="#wrglossary.16073">661</a>, <span class="summarylocfmt"><a href="#wrglossary.20610">831</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrlong"><code class="csfmt">\Glsxtrlong</code></a><span class="qquad"></span><a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.1540">53</a>, <a href="#wrglossary.5343">208</a>, <a href="#wrglossary.5989">234</a>, <a href="#wrglossary.8507">334</a>, <a href="#wrglossary.15807">656</a>, <a href="#wrglossary.16080">661</a>, <span class="summarylocfmt"><a href="#wrglossary.20617">831</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlong"><code class="csfmt">\glsxtrlong</code></a><span class="qquad"></span><a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.451">18</a>, <a href="#wrglossary.496">19</a>, <a href="#wrglossary.1322">43</a>, <a href="#wrglossary.1426">47</a>, <a href="#wrglossary.1528">52</a>, <a href="#wrglossary.1617">54</a>, <a href="#wrglossary.1665">56</a>, <a href="#wrglossary.1794">61</a>, <a href="#wrglossary.1823">63</a>, <a href="#wrglossary.1879">65</a>, <a href="#wrglossary.2079">74</a>, <a href="#wrglossary.2246">81</a>, <a href="#wrglossary.2514">93</a>, <a href="#wrglossary.2730">103</a>, <a href="#wrglossary.3015">115</a>, <a href="#wrglossary.3958">159</a>, <a href="#wrglossary.4444">175</a>, <a href="#wrglossary.5340">208</a>, <a href="#wrglossary.5969">233</a>, <a href="#wrglossary.6013">235</a>, <a href="#wrglossary.8494">333</a>, <a href="#wrglossary.9104">364</a>, <a href="#wrglossary.12120">496</a>, <a href="#wrglossary.15358">640</a>, <a href="#wrglossary.15817">656</a>, <a href="#wrglossary.16087">661</a>, <a href="#wrglossary.17725">717</a>, <span class="summarylocfmt"><a href="#wrglossary.20626">831</a></span>, <a href="#wrglossary.21446">866</a>, <a href="#wrglossary.22447">908</a>, <a href="#wrglossary.23002">923</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrlongformat"><code class="csfmt">\GLSxtrlongformat</code></a><span class="qquad"></span><a href="#wrglossary.4455">176</a>, <span class="summarylocfmt"><a href="#wrglossary.20636">832</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrlongformat"><code class="csfmt">\Glsxtrlongformat</code></a><span class="qquad"></span><a href="#wrglossary.3613">146</a>, <a href="#wrglossary.4453">176</a>, <span class="summarylocfmt"><a href="#wrglossary.20640">832</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlongformat"><code class="csfmt">\glsxtrlongformat</code></a><span class="qquad"></span><a href="#wrglossary.2059">73</a>, <a href="#wrglossary.4443">175</a>, <a href="#wrglossary.4458">176</a>, <a href="#wrglossary.4536">180</a>, <span class="summarylocfmt"><a href="#wrglossary.20644">832</a></span>, <a href="#wrglossary.20733">835</a>, <a href="#wrglossary.20763">836</a>, <a href="#wrglossary.21564">870</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrlongformatgrp"><code class="csfmt">\GLSxtrlongformatgrp</code></a><span class="qquad"></span><a href="#wrglossary.4469">177</a>, <span class="summarylocfmt"><a href="#wrglossary.20651">832</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrlongformatgrp"><code class="csfmt">\Glsxtrlongformatgrp</code></a><span class="qquad"></span><a href="#wrglossary.4467">176</a>, <span class="summarylocfmt"><a href="#wrglossary.20655">832</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlongformatgrp"><code class="csfmt">\glsxtrlongformatgrp</code></a><span class="qquad"></span><a href="#wrglossary.4464">176</a>, <span class="summarylocfmt"><a href="#wrglossary.20659">832</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlonghyphen"><code class="csfmt">\glsxtrlonghyphen</code></a><span class="qquad"></span><a href="#wrglossary.3710">150</a>, <a href="#wrglossary.3756">151</a>, <span class="summarylocfmt"><a href="#wrglossary.20663">832</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrlonghyphennoshort"><code class="csfmt">\GLSxtrlonghyphennoshort</code></a><span class="qquad"></span><a href="#wrglossary.3705">150</a>, <span class="summarylocfmt"><a href="#wrglossary.20666">833</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlonghyphennoshort"><code class="csfmt">\glsxtrlonghyphennoshort</code></a><span class="qquad"></span><a href="#wrglossary.3699">149</a>, <a href="#wrglossary.3708">150</a>, <span class="summarylocfmt"><a href="#wrglossary.20671">833</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlonghyphennoshortdescsort"><code class="csfmt">\glsxtrlonghyphennoshortdescsort</code></a><span class="qquad"></span><a href="#wrglossary.2823">107</a>, <a href="#wrglossary.3682">149</a>, <span class="summarylocfmt"><a href="#wrglossary.20674">833</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlonghyphennoshortsort"><code class="csfmt">\glsxtrlonghyphennoshortsort</code></a><span class="qquad"></span><a href="#wrglossary.2840">107</a>, <a href="#wrglossary.3678">149</a>, <span class="summarylocfmt"><a href="#wrglossary.20677">833</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrlonghyphenshort"><code class="csfmt">\GLSxtrlonghyphenshort</code></a><span class="qquad"></span><a href="#wrglossary.3694">149</a>, <span class="summarylocfmt"><a href="#wrglossary.20680">833</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlonghyphenshort"><code class="csfmt">\glsxtrlonghyphenshort</code></a><span class="qquad"></span><a href="#wrglossary.3686">149</a>, <a href="#wrglossary.3784">152</a>, <span class="summarylocfmt"><a href="#wrglossary.20685">833</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlonghyphenshortsort"><code class="csfmt">\glsxtrlonghyphenshortsort</code></a><span class="qquad"></span><a href="#wrglossary.2737">103</a>, <a href="#wrglossary.3670">148</a>, <span class="summarylocfmt"><a href="#wrglossary.20688">833</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlongnoshortdescname"><code class="csfmt">\glsxtrlongnoshortdescname</code></a><span class="qquad"></span><a href="#wrglossary.2084">74</a>, <a href="#wrglossary.2822">107</a>, <a href="#wrglossary.3644">147</a>, <span class="summarylocfmt"><a href="#wrglossary.20691">834</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlongnoshortname"><code class="csfmt">\glsxtrlongnoshortname</code></a><span class="qquad"></span><a href="#wrglossary.2089">74</a>, <a href="#wrglossary.2839">107</a>, <a href="#wrglossary.3650">147</a>, <span class="summarylocfmt"><a href="#wrglossary.20694">834</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrlongpl"><code class="csfmt">\GLSxtrlongpl</code></a><span class="qquad"></span><a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.1559">53</a>, <a href="#wrglossary.5377">210</a>, <a href="#wrglossary.15827">656</a>, <a href="#wrglossary.16094">661</a>, <span class="summarylocfmt"><a href="#wrglossary.20697">834</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrlongpl"><code class="csfmt">\Glsxtrlongpl</code></a><span class="qquad"></span><a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.1554">53</a>, <a href="#wrglossary.5373">209</a>, <a href="#wrglossary.15834">656</a>, <a href="#wrglossary.16101">661</a>, <span class="summarylocfmt"><a href="#wrglossary.20704">834</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlongpl"><code class="csfmt">\glsxtrlongpl</code></a><span class="qquad"></span><a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.1550">53</a>, <a href="#wrglossary.1684">56</a>, <a href="#wrglossary.5370">209</a>, <a href="#wrglossary.15844">656</a>, <a href="#wrglossary.16108">662</a>, <a href="#wrglossary.17826">720</a>, <span class="summarylocfmt"><a href="#wrglossary.20713">834</a></span>, <a href="#wrglossary.23026">924</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrlongplformat"><code class="csfmt">\GLSxtrlongplformat</code></a><span class="qquad"></span><a href="#wrglossary.4462">176</a>, <span class="summarylocfmt"><a href="#wrglossary.20723">834</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrlongplformat"><code class="csfmt">\Glsxtrlongplformat</code></a><span class="qquad"></span><a href="#wrglossary.4460">176</a>, <span class="summarylocfmt"><a href="#wrglossary.20727">835</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlongplformat"><code class="csfmt">\glsxtrlongplformat</code></a><span class="qquad"></span><a href="#wrglossary.3560">144</a>, <a href="#wrglossary.4457">176</a>, <a href="#wrglossary.4472">177</a>, <a href="#wrglossary.4524">179</a>, <a href="#wrglossary.4545">180</a>, <a href="#wrglossary.20725">834</a>, <span class="summarylocfmt"><a href="#wrglossary.20731">835</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrlongplformatgrp"><code class="csfmt">\GLSxtrlongplformatgrp</code></a><span class="qquad"></span><a href="#wrglossary.4476">177</a>, <span class="summarylocfmt"><a href="#wrglossary.20735">835</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrlongplformatgrp"><code class="csfmt">\Glsxtrlongplformatgrp</code></a><span class="qquad"></span><a href="#wrglossary.4474">177</a>, <span class="summarylocfmt"><a href="#wrglossary.20739">835</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlongplformatgrp"><code class="csfmt">\glsxtrlongplformatgrp</code></a><span class="qquad"></span><a href="#wrglossary.4471">177</a>, <span class="summarylocfmt"><a href="#wrglossary.20743">835</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlongshortdescname"><code class="csfmt">\glsxtrlongshortdescname</code></a><span class="qquad"></span><a href="#wrglossary.2268">82</a>, <a href="#wrglossary.2782">105</a>, <a href="#wrglossary.3303">134</a>, <span class="summarylocfmt"><a href="#wrglossary.20747">835</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlongshortdescsort"><code class="csfmt">\glsxtrlongshortdescsort</code></a><span class="qquad"></span><a href="#wrglossary.2269">82</a>, <a href="#wrglossary.2783">105</a>, <a href="#wrglossary.3295">133</a>, <span class="summarylocfmt"><a href="#wrglossary.20750">835</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrlongshortformat"><code class="csfmt">\GLSxtrlongshortformat</code></a><span class="qquad"></span><a href="#wrglossary.4520">179</a>, <span class="summarylocfmt"><a href="#wrglossary.20753">835</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrlongshortformat"><code class="csfmt">\Glsxtrlongshortformat</code></a><span class="qquad"></span><a href="#wrglossary.4518">179</a>, <span class="summarylocfmt"><a href="#wrglossary.20757">836</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlongshortformat"><code class="csfmt">\glsxtrlongshortformat</code></a><span class="qquad"></span><a href="#wrglossary.1909">67</a>, <a href="#wrglossary.2062">73</a>, <a href="#wrglossary.2231">81</a>, <a href="#wrglossary.4513">179</a>, <a href="#wrglossary.4535">180</a>, <span class="summarylocfmt"><a href="#wrglossary.20761">836</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlongshortname"><code class="csfmt">\glsxtrlongshortname</code></a><span class="qquad"></span><a href="#wrglossary.2251">82</a>, <a href="#wrglossary.2519">93</a>, <a href="#wrglossary.2736">103</a>, <a href="#wrglossary.3289">133</a>, <span class="summarylocfmt"><a href="#wrglossary.20765">836</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrlongshortplformat"><code class="csfmt">\GLSxtrlongshortplformat</code></a><span class="qquad"></span><a href="#wrglossary.4528">180</a>, <span class="summarylocfmt"><a href="#wrglossary.20768">836</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrlongshortplformat"><code class="csfmt">\Glsxtrlongshortplformat</code></a><span class="qquad"></span><a href="#wrglossary.4526">179</a>, <span class="summarylocfmt"><a href="#wrglossary.20772">836</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlongshortplformat"><code class="csfmt">\glsxtrlongshortplformat</code></a><span class="qquad"></span><a href="#wrglossary.4522">179</a>, <span class="summarylocfmt"><a href="#wrglossary.20776">836</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlongshortscuserdescname"><code class="csfmt">\glsxtrlongshortscuserdescname</code></a><span class="qquad"></span><a href="#wrglossary.2490">93</a>, <a href="#wrglossary.3424">138</a>, <span class="summarylocfmt"><a href="#wrglossary.20779">837</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlongshortscusername"><code class="csfmt">\glsxtrlongshortscusername</code></a><span class="qquad"></span><a href="#wrglossary.2465">91</a>, <a href="#wrglossary.3419">138</a>, <span class="summarylocfmt"><a href="#wrglossary.20783">837</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrlongshortuserdescname"><code class="csfmt">\glsxtrlongshortuserdescname</code></a><span class="qquad"></span><a href="#wrglossary.2410">89</a>, <a href="#wrglossary.2445">90</a>, <a href="#wrglossary.2477">92</a>, <a href="#wrglossary.3410">138</a>, <span class="summarylocfmt"><a href="#wrglossary.20787">837</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrmarkhook"><code class="csfmt">\glsxtrmarkhook</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5539">216</a>–<a href="#wrglossary.5595">218</a>, <a href="#wrglossary.5828">227</a>, <a href="#wrglossary.10635">418</a>, <span class="summarylocfmt"><a href="#wrglossary.20791">837</a></span>, <a href="#wrglossary.21313">860</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathGreekIIrules"><code class="csfmt">\glsxtrMathGreekIIrules</code></a><span class="qquad"></span><a href="#wrglossary.13365">551</a>, <span class="summarylocfmt"><a href="#wrglossary.20796">837</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathGreekIrules"><code class="csfmt">\glsxtrMathGreekIrules</code></a><span class="qquad"></span><a href="#wrglossary.13358">551</a>, <a href="#wrglossary.13366">552</a>, <span class="summarylocfmt"><a href="#wrglossary.20798">837</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicAlpha"><code class="csfmt">\glsxtrMathItalicAlpha</code></a><span class="qquad"></span><a href="#wrglossary.13411">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20800">837</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicBeta"><code class="csfmt">\glsxtrMathItalicBeta</code></a><span class="qquad"></span><a href="#wrglossary.13413">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20802">837</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicChi"><code class="csfmt">\glsxtrMathItalicChi</code></a><span class="qquad"></span><a href="#wrglossary.13455">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20804">838</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicDelta"><code class="csfmt">\glsxtrMathItalicDelta</code></a><span class="qquad"></span><a href="#wrglossary.13417">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20806">838</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicDigamma"><code class="csfmt">\glsxtrMathItalicDigamma</code></a><span class="qquad"></span><a href="#wrglossary.13421">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20808">838</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicEpsilon"><code class="csfmt">\glsxtrMathItalicEpsilon</code></a><span class="qquad"></span><a href="#wrglossary.13419">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20810">838</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicEta"><code class="csfmt">\glsxtrMathItalicEta</code></a><span class="qquad"></span><a href="#wrglossary.13425">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20812">838</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicGamma"><code class="csfmt">\glsxtrMathItalicGamma</code></a><span class="qquad"></span><a href="#wrglossary.13415">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20814">838</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicGreekIIrules"><code class="csfmt">\glsxtrMathItalicGreekIIrules</code></a><span class="qquad"></span><a href="#wrglossary.13384">552</a>, <span class="summarylocfmt"><a href="#wrglossary.20816">838</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicGreekIrules"><code class="csfmt">\glsxtrMathItalicGreekIrules</code></a><span class="qquad"></span><a href="#wrglossary.13375">552</a>, <span class="summarylocfmt"><a href="#wrglossary.20818">839</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicIota"><code class="csfmt">\glsxtrMathItalicIota</code></a><span class="qquad"></span><a href="#wrglossary.13429">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20820">839</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicKappa"><code class="csfmt">\glsxtrMathItalicKappa</code></a><span class="qquad"></span><a href="#wrglossary.13431">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20822">839</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicLambda"><code class="csfmt">\glsxtrMathItalicLambda</code></a><span class="qquad"></span><a href="#wrglossary.13433">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20824">839</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicLowerGreekIIrules"><code class="csfmt">\glsxtrMathItalicLowerGreekIIrules</code></a><span class="qquad"></span><a href="#wrglossary.13401">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20826">839</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicLowerGreekIrules"><code class="csfmt">\glsxtrMathItalicLowerGreekIrules</code></a><span class="qquad"></span><a href="#wrglossary.13396">552</a>, <span class="summarylocfmt"><a href="#wrglossary.20829">839</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicMu"><code class="csfmt">\glsxtrMathItalicMu</code></a><span class="qquad"></span><a href="#wrglossary.13435">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20832">839</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicNabla"><code class="csfmt">\glsxtrMathItalicNabla</code></a><span class="qquad"></span><a href="#wrglossary.13461">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20834">839</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicNu"><code class="csfmt">\glsxtrMathItalicNu</code></a><span class="qquad"></span><a href="#wrglossary.13437">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20836">840</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicOmega"><code class="csfmt">\glsxtrMathItalicOmega</code></a><span class="qquad"></span><a href="#wrglossary.13459">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20838">840</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicOmicron"><code class="csfmt">\glsxtrMathItalicOmicron</code></a><span class="qquad"></span><a href="#wrglossary.13441">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20840">840</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicPartial"><code class="csfmt">\glsxtrMathItalicPartial</code></a><span class="qquad"></span><a href="#wrglossary.13460">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20842">840</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicPhi"><code class="csfmt">\glsxtrMathItalicPhi</code></a><span class="qquad"></span><a href="#wrglossary.13453">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20844">840</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicPi"><code class="csfmt">\glsxtrMathItalicPi</code></a><span class="qquad"></span><a href="#wrglossary.13443">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20846">840</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicPsi"><code class="csfmt">\glsxtrMathItalicPsi</code></a><span class="qquad"></span><a href="#wrglossary.13457">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20848">840</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicRho"><code class="csfmt">\glsxtrMathItalicRho</code></a><span class="qquad"></span><a href="#wrglossary.13445">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20850">840</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicSigma"><code class="csfmt">\glsxtrMathItalicSigma</code></a><span class="qquad"></span><a href="#wrglossary.13447">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20852">841</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicTau"><code class="csfmt">\glsxtrMathItalicTau</code></a><span class="qquad"></span><a href="#wrglossary.13449">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20854">841</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicTheta"><code class="csfmt">\glsxtrMathItalicTheta</code></a><span class="qquad"></span><a href="#wrglossary.13427">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20856">841</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicUpperGreekIIrules"><code class="csfmt">\glsxtrMathItalicUpperGreekIIrules</code></a><span class="qquad"></span><a href="#wrglossary.13392">552</a>, <span class="summarylocfmt"><a href="#wrglossary.20858">841</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicUpperGreekIrules"><code class="csfmt">\glsxtrMathItalicUpperGreekIrules</code></a><span class="qquad"></span><a href="#wrglossary.13387">552</a>, <span class="summarylocfmt"><a href="#wrglossary.20861">841</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicUpsilon"><code class="csfmt">\glsxtrMathItalicUpsilon</code></a><span class="qquad"></span><a href="#wrglossary.13451">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20864">841</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicXi"><code class="csfmt">\glsxtrMathItalicXi</code></a><span class="qquad"></span><a href="#wrglossary.13439">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20866">841</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathItalicZeta"><code class="csfmt">\glsxtrMathItalicZeta</code></a><span class="qquad"></span><a href="#wrglossary.13423">553</a>, <span class="summarylocfmt"><a href="#wrglossary.20868">841</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathUpGreekIIrules"><code class="csfmt">\glsxtrMathUpGreekIIrules</code></a><span class="qquad"></span><a href="#wrglossary.13372">552</a>, <span class="summarylocfmt"><a href="#wrglossary.20870">842</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMathUpGreekIrules"><code class="csfmt">\glsxtrMathUpGreekIrules</code></a><span class="qquad"></span><a href="#wrglossary.13367">552</a>, <span class="summarylocfmt"><a href="#wrglossary.20872">842</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrMFUsave"><code class="csfmt">\glsxtrMFUsave</code></a><span class="qquad"></span><a href="#sec:bib2gls">§11</a>; <a href="#wrglossary.12503">512</a>, <span class="summarylocfmt"><a href="#wrglossary.20874">842</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrMglsOrGls"><code class="csfmt">\GlsXtrMglsOrGls</code></a><span class="qquad"></span><a href="#sec:multientries">§7</a>; <a href="#wrglossary.8297">325</a>, <span class="summarylocfmt"><a href="#wrglossary.20881">842</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrmglsWarnAllSkipped"><code class="csfmt">\glsxtrmglsWarnAllSkipped</code></a><span class="qquad"></span><a href="#sec:multiglsoptionsskip">§7.9.5</a>; <a href="#wrglossary.8932">358</a>, <span class="summarylocfmt"><a href="#wrglossary.20884">842</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrmultientryadjustedname"><code class="csfmt">\GLSxtrmultientryadjustedname</code></a><span class="qquad"></span><a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9371">372</a>, <span class="summarylocfmt"><a href="#wrglossary.20887">842</a></span>, <a href="#wrglossary.20904">843</a>, <a href="#wrglossary.20916">844</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrmultientryadjustedname"><code class="csfmt">\GlsXtrmultientryadjustedname</code></a><span class="qquad"></span><a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9368">372</a>, <span class="summarylocfmt"><a href="#wrglossary.20891">843</a></span>, <a href="#wrglossary.20919">844</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrmultientryadjustedname"><code class="csfmt">\Glsxtrmultientryadjustedname</code></a><span class="qquad"></span><a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9365">372</a>, <span class="summarylocfmt"><a href="#wrglossary.20895">843</a></span>, <a href="#wrglossary.20922">844</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrmultientryadjustedname"><code class="csfmt">\glsxtrmultientryadjustedname</code></a><span class="qquad"></span><a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9358">372</a>, <a href="#wrglossary.9373">373</a>, <a href="#wrglossary.20889">842</a>, <span class="summarylocfmt"><a href="#wrglossary.20899">843</a></span>, <a href="#wrglossary.20925">844</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrmultientryadjustednamefmt"><code class="csfmt">\GLSxtrmultientryadjustednamefmt</code></a><span class="qquad"></span><a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9388">373</a>, <span class="summarylocfmt"><a href="#wrglossary.20902">843</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrmultientryadjustednamefmt"><code class="csfmt">\GlsXtrmultientryadjustednamefmt</code></a><span class="qquad"></span><a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9384">373</a>, <span class="summarylocfmt"><a href="#wrglossary.20905">843</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrmultientryadjustednamefmt"><code class="csfmt">\Glsxtrmultientryadjustednamefmt</code></a><span class="qquad"></span><a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9381">373</a>, <span class="summarylocfmt"><a href="#wrglossary.20908">843</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrmultientryadjustednamefmt"><code class="csfmt">\glsxtrmultientryadjustednamefmt</code></a><span class="qquad"></span><a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9379">373</a>, <span class="summarylocfmt"><a href="#wrglossary.20911">843</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrmultientryadjustednameother"><code class="csfmt">\GLSxtrmultientryadjustednameother</code></a><span class="qquad"></span><a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9399">374</a>, <span class="summarylocfmt"><a href="#wrglossary.20914">844</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrmultientryadjustednameother"><code class="csfmt">\GlsXtrmultientryadjustednameother</code></a><span class="qquad"></span><a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9396">374</a>, <span class="summarylocfmt"><a href="#wrglossary.20917">844</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrmultientryadjustednameother"><code class="csfmt">\Glsxtrmultientryadjustednameother</code></a><span class="qquad"></span><a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9393">374</a>, <span class="summarylocfmt"><a href="#wrglossary.20920">844</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrmultientryadjustednameother"><code class="csfmt">\glsxtrmultientryadjustednameother</code></a><span class="qquad"></span><a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9390">374</a>, <span class="summarylocfmt"><a href="#wrglossary.20923">844</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrmultientryadjustednamepostsep"><code class="csfmt">\glsxtrmultientryadjustednamepostsep</code></a><span class="qquad"></span><a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9377">373</a>, <span class="summarylocfmt"><a href="#wrglossary.20926">844</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrmultientryadjustednamepresep"><code class="csfmt">\glsxtrmultientryadjustednamepresep</code></a><span class="qquad"></span><a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9376">373</a>, <span class="summarylocfmt"><a href="#wrglossary.20929">844</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrmultientryadjustednamesep"><code class="csfmt">\glsxtrmultientryadjustednamesep</code></a><span class="qquad"></span><a href="#sec:mbib2gls">§7.14</a>; <a href="#wrglossary.9374">373</a>, <span class="summarylocfmt"><a href="#wrglossary.20932">844</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrmultilastotherindex"><code class="csfmt">\glsxtrmultilastotherindex</code></a><span class="qquad"></span><a href="#sec:multiextras">§7.13</a>; <a href="#wrglossary.9336">371</a>, <span class="summarylocfmt"><a href="#wrglossary.20935">845</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrmultilist"><code class="csfmt">\glsxtrmultilist</code></a><span class="qquad"></span><a href="#sec:multiextras">§7.13</a>; <a href="#wrglossary.9328">370</a>, <span class="summarylocfmt"><a href="#wrglossary.20937">845</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrmultimain"><code class="csfmt">\glsxtrmultimain</code></a><span class="qquad"></span><a href="#sec:multiextras">§7.13</a>; <a href="#wrglossary.9327">370</a>, <span class="summarylocfmt"><a href="#wrglossary.20939">845</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrmultimainindex"><code class="csfmt">\glsxtrmultimainindex</code></a><span class="qquad"></span><a href="#sec:multiextras">§7.13</a>; <a href="#wrglossary.9335">371</a>, <span class="summarylocfmt"><a href="#wrglossary.20941">845</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrmultisupplocation"><code class="csfmt">\glsxtrmultisupplocation</code></a><span class="qquad"></span><a href="#sec:supplocations">§11.5.5</a>; <a href="#wrglossary.13518">555</a>, <span class="summarylocfmt"><a href="#wrglossary.20943">845</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrmultitotalelements"><code class="csfmt">\glsxtrmultitotalelements</code></a><span class="qquad"></span><a href="#sec:multiextras">§7.13</a>; <a href="#wrglossary.9334">371</a>, <span class="summarylocfmt"><a href="#wrglossary.20946">845</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrnameloclink"><code class="csfmt">\glsxtrnameloclink</code></a><span class="qquad"></span><a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13645">560</a>, <span class="summarylocfmt"><a href="#wrglossary.20948">845</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrnamereflink"><code class="csfmt">\glsxtrnamereflink</code></a><span class="qquad"></span><a href="#wrglossary.13626">559</a>, <a href="#wrglossary.19927">803</a>, <a href="#wrglossary.19935">804</a>, <span class="summarylocfmt"><a href="#wrglossary.20951">846</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrnewabbrevpresetkeyhook"><code class="csfmt">\glsxtrnewabbrevpresetkeyhook</code></a><span class="qquad"></span><a href="#sec:abbrvgeneralhooks">§4.1.5</a>; <a href="#wrglossary.1366">45</a>, <a href="#wrglossary.4030">162</a>, <span class="summarylocfmt"><a href="#wrglossary.20955">846</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrnewgls"><code class="csfmt">\glsxtrnewgls</code></a><span class="qquad"></span><a href="#sec:labelprefixes">§5.7</a>; <a href="#wrglossary.6596">257</a>, <a href="#wrglossary.6629">258</a>, <a href="#wrglossary.13735">563</a>, <a href="#wrglossary.13871">568</a>, <span class="summarylocfmt"><a href="#wrglossary.20957">846</a></span>, <a href="#wrglossary.20990">847</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrnewglsdisp"><code class="csfmt">\glsxtrnewglsdisp</code></a><span class="qquad"></span><a href="#sec:labelprefixes">§5.7</a>; <a href="#wrglossary.6618">258</a>, <span class="summarylocfmt"><a href="#wrglossary.20960">846</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrnewGLSlike"><code class="csfmt">\glsxtrnewGLSlike</code></a><span class="qquad"></span><a href="#sec:labelprefixes">§5.7</a>; <a href="#wrglossary.6611">257</a>, <span class="summarylocfmt"><a href="#wrglossary.20963">846</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrnewglslike"><code class="csfmt">\glsxtrnewglslike</code></a><span class="qquad"></span><a href="#sec:labelprefixes">§5.7</a>; <a href="#wrglossary.6603">257</a>, <a href="#wrglossary.6646">259</a>, <a href="#wrglossary.13872">568</a>, <span class="summarylocfmt"><a href="#wrglossary.20969">846</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrnewglslink"><code class="csfmt">\glsxtrnewglslink</code></a><span class="qquad"></span><a href="#sec:labelprefixes">§5.7</a>; <a href="#wrglossary.6616">258</a>, <span class="summarylocfmt"><a href="#wrglossary.20977">847</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrnewnumber"><code class="csfmt">\glsxtrnewnumber</code></a><span class="qquad"></span><a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.210">11</a>, <a href="#wrglossary.469">19</a>, <a href="#wrglossary.945">32</a>, <a href="#wrglossary.12074">494</a>, <span class="summarylocfmt"><a href="#wrglossary.20980">847</a></span>, <a href="#wrglossary.22809">919</a>, <a href="#wrglossary.23800">948</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrnewrgls"><code class="csfmt">\glsxtrnewrgls</code></a><span class="qquad"></span><a href="#sec:labelprefixes">§5.7</a>; <a href="#wrglossary.6631">258</a>, <span class="summarylocfmt"><a href="#wrglossary.20988">847</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrnewrGLSlike"><code class="csfmt">\glsxtrnewrGLSlike</code></a><span class="qquad"></span><a href="#sec:labelprefixes">§5.7</a>; <a href="#wrglossary.6642">259</a>, <span class="summarylocfmt"><a href="#wrglossary.20992">847</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrnewrglslike"><code class="csfmt">\glsxtrnewrglslike</code></a><span class="qquad"></span><a href="#sec:labelprefixes">§5.7</a>; <a href="#wrglossary.6636">258</a>, <a href="#wrglossary.6647">259</a>, <span class="summarylocfmt"><a href="#wrglossary.20998">847</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrnewsymbol"><code class="csfmt">\glsxtrnewsymbol</code></a><span class="qquad"></span><a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.192">10</a>, <a href="#wrglossary.369">16</a>, <a href="#wrglossary.466">18</a>, <a href="#wrglossary.943">32</a>, <a href="#wrglossary.12072">494</a>, <span class="summarylocfmt"><a href="#wrglossary.21006">847</a></span>, <a href="#wrglossary.22814">919</a>, <a href="#wrglossary.23852">950</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrNoGlossaryWarning"><code class="csfmt">\glsxtrNoGlossaryWarning</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.21014">848</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrNoGlsWarningAutoMake"><code class="csfmt">\GlsXtrNoGlsWarningAutoMake</code></a><span class="qquad"></span><a href="#sec:lang">§15</a>; <a href="#wrglossary.14295">596</a>, <span class="summarylocfmt"><a href="#wrglossary.21016">848</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrNoGlsWarningBuildInfo"><code class="csfmt">\GlsXtrNoGlsWarningBuildInfo</code></a><span class="qquad"></span><a href="#sec:lang">§15</a>; <a href="#wrglossary.14294">595</a>, <span class="summarylocfmt"><a href="#wrglossary.21018">848</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrNoGlsWarningCheckFile"><code class="csfmt">\GlsXtrNoGlsWarningCheckFile</code></a><span class="qquad"></span><a href="#sec:lang">§15</a>; <a href="#wrglossary.14290">595</a>, <span class="summarylocfmt"><a href="#wrglossary.21019">848</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrNoGlsWarningEmptyMain"><code class="csfmt">\GlsXtrNoGlsWarningEmptyMain</code></a><span class="qquad"></span><a href="#sec:lang">§15</a>; <a href="#wrglossary.14288">594</a>, <span class="summarylocfmt"><a href="#wrglossary.21020">848</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrNoGlsWarningEmptyNotMain"><code class="csfmt">\GlsXtrNoGlsWarningEmptyNotMain</code></a><span class="qquad"></span><a href="#sec:lang">§15</a>; <a href="#wrglossary.14289">594</a>, <span class="summarylocfmt"><a href="#wrglossary.21021">848</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrNoGlsWarningEmptyStart"><code class="csfmt">\GlsXtrNoGlsWarningEmptyStart</code></a><span class="qquad"></span><a href="#sec:lang">§15</a>; <a href="#wrglossary.14287">594</a>, <span class="summarylocfmt"><a href="#wrglossary.21022">848</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrNoGlsWarningHead"><code class="csfmt">\GlsXtrNoGlsWarningHead</code></a><span class="qquad"></span><a href="#sec:lang">§15</a>; <a href="#wrglossary.14286">594</a>, <span class="summarylocfmt"><a href="#wrglossary.21023">848</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrNoGlsWarningMisMatch"><code class="csfmt">\GlsXtrNoGlsWarningMisMatch</code></a><span class="qquad"></span><a href="#sec:lang">§15</a>; <a href="#wrglossary.14291">595</a>, <span class="summarylocfmt"><a href="#wrglossary.21024">849</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrNoGlsWarningNoOut"><code class="csfmt">\GlsXtrNoGlsWarningNoOut</code></a><span class="qquad"></span><a href="#sec:lang">§15</a>; <a href="#wrglossary.14292">595</a>, <span class="summarylocfmt"><a href="#wrglossary.21026">849</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrNoGlsWarningTail"><code class="csfmt">\GlsXtrNoGlsWarningTail</code></a><span class="qquad"></span><a href="#sec:lang">§15</a>; <a href="#wrglossary.14293">595</a>, <span class="summarylocfmt"><a href="#wrglossary.21027">849</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrnoidxgroups"><code class="csfmt">\glsxtrnoidxgroups</code></a><span class="qquad"></span><a href="#sec:printunsrt">§8.4</a>; <a href="#wrglossary.9706">385</a>, <a href="#wrglossary.9836">389</a>, <span class="summarylocfmt"><a href="#wrglossary.21028">849</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrnonprintablerules"><code class="csfmt">\glsxtrnonprintablerules</code></a><span class="qquad"></span><a href="#wrglossary.13258">542</a>, <span class="summarylocfmt"><a href="#wrglossary.21035">849</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrnopostpunc"><code class="csfmt">\glsxtrnopostpunc</code></a><span class="qquad"></span><a href="#sec:postdeschooks">§8.6.2</a>; <a href="#wrglossary.10572">415</a>, <a href="#wrglossary.10753">422</a>, <a href="#wrglossary.10767">423</a>, <a href="#wrglossary.19434">781</a>, <span class="summarylocfmt"><a href="#wrglossary.21037">849</a></span>, <a href="#wrglossary.21317">860</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtronlydescname"><code class="csfmt">\glsxtronlydescname</code></a><span class="qquad"></span><a href="#wrglossary.2952">112</a>, <a href="#wrglossary.3872">155</a>, <a href="#wrglossary.3888">156</a>, <span class="summarylocfmt"><a href="#wrglossary.21043">849</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtronlydescsort"><code class="csfmt">\glsxtronlydescsort</code></a><span class="qquad"></span><a href="#wrglossary.2953">112</a>, <a href="#wrglossary.3877">155</a>, <a href="#wrglossary.3892">156</a>, <span class="summarylocfmt"><a href="#wrglossary.21046">850</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtronlyname"><code class="csfmt">\glsxtronlyname</code></a><span class="qquad"></span><a href="#wrglossary.2940">111</a>, <a href="#wrglossary.3868">155</a>, <span class="summarylocfmt"><a href="#wrglossary.21049">850</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtronlysuffix"><code class="csfmt">\glsxtronlysuffix</code></a><span class="qquad"></span><a href="#wrglossary.3854">154</a>, <span class="summarylocfmt"><a href="#wrglossary.21052">850</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrorgkeylist"><code class="csfmt">\glsxtrorgkeylist</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4000">161</a>, <a href="#wrglossary.4070">163</a>, <span class="summarylocfmt"><a href="#wrglossary.21056">850</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrorgshort"><code class="csfmt">\glsxtrorgshort</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.1369">45</a>, <a href="#wrglossary.3324">134</a>, <a href="#wrglossary.3672">148</a>, <a href="#wrglossary.3676">149</a>, <a href="#wrglossary.4001">161</a>, <a href="#wrglossary.4077">164</a>, <span class="summarylocfmt"><a href="#wrglossary.21059">850</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrorglong"><code class="csfmt">\glsxtrorglong</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.3684">149</a>, <a href="#wrglossary.4002">161</a>, <a href="#wrglossary.4085">164</a>, <span class="summarylocfmt"><a href="#wrglossary.21062">850</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrp"><code class="csfmt">\GLSxtrp</code></a><span class="qquad"></span><a href="#sec:nested">§5.4</a>; <a href="#wrglossary.5944">232</a>, <span class="summarylocfmt"><a href="#wrglossary.21065">850</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrp"><code class="csfmt">\Glsxtrp</code></a><span class="qquad"></span><a href="#sec:nested">§5.4</a>; <a href="#wrglossary.5942">232</a>, <span class="summarylocfmt"><a href="#wrglossary.21068">851</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrp"><code class="csfmt">\glsxtrp</code></a><span class="qquad"></span><a href="#sec:nested">§5.4</a>; <a href="#wrglossary.932">32</a>, <a href="#wrglossary.4579">183</a>, <a href="#wrglossary.4630">185</a>, <a href="#wrglossary.4665">186</a>, <a href="#wrglossary.5923">230</a>, <a href="#wrglossary.5924">231</a>, <a href="#wrglossary.16527">677</a>, <a href="#wrglossary.18720">756</a>, <a href="#wrglossary.21067">850</a>, <span class="summarylocfmt"><a href="#wrglossary.21071">851</a></span>, <a href="#wrglossary.21454">866</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpageref"><code class="csfmt">\glsxtrpageref</code></a><span class="qquad"></span><a href="#sec:glspageref">§8.1</a>; <a href="#wrglossary.9495">377</a>, <a href="#wrglossary.10600">416</a>, <span class="summarylocfmt"><a href="#wrglossary.21077">851</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrparen"><code class="csfmt">\glsxtrparen</code></a><span class="qquad"></span><a href="#wrglossary.3257">132</a>, <a href="#wrglossary.3692">149</a>, <a href="#wrglossary.3758">151</a>, <span class="summarylocfmt"><a href="#wrglossary.21084">851</a></span>, <a href="#wrglossary.22013">890</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrpdfentryfmt"><code class="csfmt">\Glsxtrpdfentryfmt</code></a><span class="qquad"></span><a href="#sec:glsxtrfmt">§5.12.2</a>; <a href="#wrglossary.7748">299</a>, <span class="summarylocfmt"><a href="#wrglossary.21086">851</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpdfentryfmt"><code class="csfmt">\glsxtrpdfentryfmt</code></a><span class="qquad"></span><a href="#sec:glsxtrfmt">§5.12.2</a>; <a href="#wrglossary.7703">296</a>, <a href="#wrglossary.19828">800</a>, <span class="summarylocfmt"><a href="#wrglossary.21089">851</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrpl"><code class="csfmt">\Glsxtrpl</code></a><span class="qquad"></span><a href="#sec:onthefly">§13</a>; <a href="#wrglossary.14134">579</a>, <a href="#wrglossary.14142">580</a>, <span class="summarylocfmt"><a href="#wrglossary.21091">851</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpl"><code class="csfmt">\glsxtrpl</code></a><span class="qquad"></span><a href="#sec:onthefly">§13</a>; <a href="#wrglossary.14126">579</a>, <a href="#wrglossary.14140">580</a>, <a href="#wrglossary.21092">851</a>, <span class="summarylocfmt"><a href="#wrglossary.21094">852</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostabbrvfootnote"><code class="csfmt">\glsxtrpostabbrvfootnote</code></a><span class="qquad"></span><a href="#sec:advancedabbrstylecmds">§4.5.2</a>; <a href="#wrglossary.3975">160</a>, <span class="summarylocfmt"><a href="#wrglossary.21096">852</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostdescabbreviation"><code class="csfmt">\glsxtrpostdescabbreviation</code></a><span class="qquad"></span><a href="#sec:postdeschooks">§8.6.2</a>; <a href="#wrglossary.10740">422</a>, <span class="summarylocfmt"><a href="#wrglossary.21100">852</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostdescacronym"><code class="csfmt">\glsxtrpostdescacronym</code></a><span class="qquad"></span><a href="#sec:postdeschooks">§8.6.2</a>; <a href="#wrglossary.10737">422</a>, <span class="summarylocfmt"><a href="#wrglossary.21102">852</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostdesccategory"><code class="csfmt">\glsxtrpostdesc<span class="meta">〈<em class="metainner">category</em>〉</span></code></a><span class="qquad"></span><a href="#sec:postdeschooks">§8.6.2</a>; <a href="#wrglossary.10729">421</a>, <a href="#wrglossary.10745">422</a>, <a href="#wrglossary.14300">599</a>, <a href="#wrglossary.17213">701</a>, <span class="summarylocfmt"><a href="#wrglossary.21104">852</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostdescgeneral"><code class="csfmt">\glsxtrpostdescgeneral</code></a><span class="qquad"></span><a href="#sec:postdeschooks">§8.6.2</a>; <a href="#wrglossary.10731">422</a>, <span class="summarylocfmt"><a href="#wrglossary.21107">852</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostdescindex"><code class="csfmt">\glsxtrpostdescindex</code></a><span class="qquad"></span><a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.258">12</a>, <span class="summarylocfmt"><a href="#wrglossary.21109">852</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostdescnumber"><code class="csfmt">\glsxtrpostdescnumber</code></a><span class="qquad"></span><a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.221">11</a>, <span class="summarylocfmt"><a href="#wrglossary.21112">852</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostdescription"><code class="csfmt">\glsxtrpostdescription</code></a><span class="qquad"></span><a href="#sec:postdeschooks">§8.6.2</a>; <a href="#wrglossary.253">12</a>, <a href="#wrglossary.10717">421</a>–<a href="#wrglossary.10765">423</a>, <a href="#wrglossary.10894">428</a>, <span class="summarylocfmt"><a href="#wrglossary.21115">853</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostdescsymbol"><code class="csfmt">\glsxtrpostdescsymbol</code></a><span class="qquad"></span><a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.203">10</a>, <span class="summarylocfmt"><a href="#wrglossary.21118">853</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostdescterm"><code class="csfmt">\glsxtrpostdescterm</code></a><span class="qquad"></span><a href="#sec:postdeschooks">§8.6.2</a>; <a href="#wrglossary.10734">422</a>, <span class="summarylocfmt"><a href="#wrglossary.21122">853</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostfootnotelongformat"><code class="csfmt">\glsxtrpostfootnotelongformat</code></a><span class="qquad"></span><a href="#wrglossary.3623">146</a>, <span class="summarylocfmt"><a href="#wrglossary.21124">853</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrposthyphenlong"><code class="csfmt">\GLSxtrposthyphenlong</code></a><span class="qquad"></span><a href="#wrglossary.3800">152</a>, <a href="#wrglossary.3837">153</a>, <span class="summarylocfmt"><a href="#wrglossary.21127">853</a></span>, <a href="#wrglossary.23459">938</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrposthyphenlong"><code class="csfmt">\glsxtrposthyphenlong</code></a><span class="qquad"></span><a href="#wrglossary.3802">152</a>–<a href="#wrglossary.3840">154</a>, <span class="summarylocfmt"><a href="#wrglossary.21131">853</a></span>, <a href="#wrglossary.21142">854</a>, <a href="#wrglossary.23458">938</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrposthyphenlongpl"><code class="csfmt">\GLSxtrposthyphenlongpl</code></a><span class="qquad"></span><a href="#wrglossary.3841">154</a>, <span class="summarylocfmt"><a href="#wrglossary.21136">853</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrposthyphenlongpl"><code class="csfmt">\glsxtrposthyphenlongpl</code></a><span class="qquad"></span><a href="#wrglossary.3839">153</a>, <span class="summarylocfmt"><a href="#wrglossary.21140">854</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrposthyphenshort"><code class="csfmt">\GLSxtrposthyphenshort</code></a><span class="qquad"></span><a href="#wrglossary.3720">150</a>, <a href="#wrglossary.3760">151</a>, <span class="summarylocfmt"><a href="#wrglossary.21143">854</a></span>, <a href="#wrglossary.23466">938</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrposthyphenshort"><code class="csfmt">\glsxtrposthyphenshort</code></a><span class="qquad"></span><a href="#wrglossary.3722">150</a>, <a href="#wrglossary.3752">151</a>, <a href="#wrglossary.3836">153</a>, <span class="summarylocfmt"><a href="#wrglossary.21147">854</a></span>, <a href="#wrglossary.23465">938</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrposthyphenshortpl"><code class="csfmt">\GLSxtrposthyphenshortpl</code></a><span class="qquad"></span><a href="#wrglossary.3764">151</a>, <span class="summarylocfmt"><a href="#wrglossary.21152">854</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrposthyphenshortpl"><code class="csfmt">\glsxtrposthyphenshortpl</code></a><span class="qquad"></span><a href="#wrglossary.3762">151</a>, <span class="summarylocfmt"><a href="#wrglossary.21156">854</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrposthyphensubsequent"><code class="csfmt">\GLSxtrposthyphensubsequent</code></a><span class="qquad"></span><a href="#wrglossary.3772">151</a>, <a href="#wrglossary.3779">152</a>, <span class="summarylocfmt"><a href="#wrglossary.21159">854</a></span>, <a href="#wrglossary.23473">939</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrposthyphensubsequent"><code class="csfmt">\glsxtrposthyphensubsequent</code></a><span class="qquad"></span><a href="#wrglossary.3774">151</a>, <a href="#wrglossary.3775">152</a>, <span class="summarylocfmt"><a href="#wrglossary.21163">854</a></span>, <a href="#wrglossary.23472">939</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostlink"><code class="csfmt">\glsxtrpostlink</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6305">246</a>–<a href="#wrglossary.6346">248</a>, <a href="#wrglossary.6371">250</a>, <a href="#wrglossary.6386">251</a>, <span class="summarylocfmt"><a href="#wrglossary.21168">855</a></span>, <a href="#wrglossary.21196">856</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostlinkAddDescOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddDescOnFirstUse</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6066">237</a>, <a href="#wrglossary.6280">246</a>, <a href="#wrglossary.6390">251</a>, <span class="summarylocfmt"><a href="#wrglossary.21175">855</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostlinkAddSymbolDescOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddSymbolDescOnFirstUse</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6396">251</a>, <span class="summarylocfmt"><a href="#wrglossary.21178">855</a></span>, <a href="#wrglossary.21199">856</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostlinkAddSymbolOnFirstUse"><code class="csfmt">\glsxtrpostlinkAddSymbolOnFirstUse</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6393">251</a>, <span class="summarylocfmt"><a href="#wrglossary.21182">855</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostlinkcat"><code class="csfmt">\glsxtrpostlink<span class="meta">〈<em class="metainner">category</em>〉</span></code></a><span class="qquad"></span><a href="#wrglossary.6345">248</a>, <a href="#wrglossary.6378">250</a>, <a href="#wrglossary.14304">599</a>, <a href="#wrglossary.17217">701</a>, <span class="summarylocfmt"><a href="#wrglossary.21185">855</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostlinkendsentence"><code class="csfmt">\glsxtrpostlinkendsentence</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6342">248</a>, <a href="#wrglossary.6383">250</a>, <span class="summarylocfmt"><a href="#wrglossary.21187">855</a></span>, <a href="#wrglossary.21195">856</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostlinkhook"><code class="csfmt">\glsxtrpostlinkhook</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6299">246</a>, <a href="#wrglossary.6384">251</a>, <a href="#wrglossary.18706">755</a>, <span class="summarylocfmt"><a href="#wrglossary.21192">855</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostlinkSymbolDescSep"><code class="csfmt">\glsxtrpostlinkSymbolDescSep</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6400">251</a>, <span class="summarylocfmt"><a href="#wrglossary.21197">856</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostlocalreset"><code class="csfmt">\glsxtrpostlocalreset</code></a><span class="qquad"></span><a href="#sec:glsunset">§5.10</a>; <a href="#wrglossary.7353">280</a>, <span class="summarylocfmt"><a href="#wrglossary.21200">856</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostlocalunset"><code class="csfmt">\glsxtrpostlocalunset</code></a><span class="qquad"></span><a href="#sec:glsunset">§5.10</a>; <a href="#wrglossary.7349">280</a>, <span class="summarylocfmt"><a href="#wrglossary.21204">856</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostlongdescription"><code class="csfmt">\glsxtrpostlongdescription</code></a><span class="qquad"></span><a href="#sec:newentrydefs">§3.1</a>; <a href="#wrglossary.939">32</a>, <span class="summarylocfmt"><a href="#wrglossary.21208">856</a></span>, <a href="#wrglossary.22221">899</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostnamecategory"><code class="csfmt">\glsxtrpostname<span class="meta">〈<em class="metainner">category</em>〉</span></code></a><span class="qquad"></span><a href="#sec:postnamehooks">§8.6.1</a>; <a href="#wrglossary.10702">420</a>, <a href="#wrglossary.10711">421</a>, <a href="#wrglossary.11096">439</a>, <a href="#wrglossary.14308">599</a>, <a href="#wrglossary.14489">603</a>, <a href="#wrglossary.17221">701</a>, <span class="summarylocfmt"><a href="#wrglossary.21212">856</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostnamehook"><code class="csfmt">\glsxtrpostnamehook</code></a><span class="qquad"></span><a href="#sec:postnamehooks">§8.6.1</a>; <a href="#wrglossary.10695">420</a>, <a href="#wrglossary.14016">574</a>, <a href="#wrglossary.14486">603</a>, <a href="#wrglossary.17610">713</a>, <span class="summarylocfmt"><a href="#wrglossary.21215">856</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrPostNewAbbreviation"><code class="csfmt">\GlsXtrPostNewAbbreviation</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4063">163</a>, <a href="#wrglossary.4094">165</a>, <a href="#wrglossary.4143">166</a>, <span class="summarylocfmt"><a href="#wrglossary.21220">857</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostreset"><code class="csfmt">\glsxtrpostreset</code></a><span class="qquad"></span><a href="#sec:glsunset">§5.10</a>; <a href="#wrglossary.7351">280</a>, <span class="summarylocfmt"><a href="#wrglossary.21221">857</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostunset"><code class="csfmt">\glsxtrpostunset</code></a><span class="qquad"></span><a href="#sec:glsunset">§5.10</a>; <a href="#wrglossary.7347">280</a>, <span class="summarylocfmt"><a href="#wrglossary.21225">857</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostuserlongformat"><code class="csfmt">\glsxtrpostuserlongformat</code></a><span class="qquad"></span><a href="#wrglossary.3566">144</a>, <span class="summarylocfmt"><a href="#wrglossary.21229">857</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpostusershortformat"><code class="csfmt">\glsxtrpostusershortformat</code></a><span class="qquad"></span><a href="#wrglossary.2433">90</a>, <a href="#wrglossary.3522">142</a>, <a href="#wrglossary.3573">144</a>, <span class="summarylocfmt"><a href="#wrglossary.21233">857</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrPrefixLabelFallbackLastfalse"><code class="csfmt">\GlsXtrPrefixLabelFallbackLastfalse</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13745">564</a>, <span class="summarylocfmt"><a href="#wrglossary.21237">857</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrPrefixLabelFallbackLasttrue"><code class="csfmt">\GlsXtrPrefixLabelFallbackLasttrue</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13744">564</a>, <span class="summarylocfmt"><a href="#wrglossary.21240">857</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrpreglossarystyle"><code class="csfmt">\glsxtrpreglossarystyle</code></a><span class="qquad"></span><a href="#sec:glosstylemods">§8.6</a>; <a href="#wrglossary.9988">393</a>, <a href="#wrglossary.10641">418</a>, <span class="summarylocfmt"><a href="#wrglossary.21243">858</a></span>, <a href="#wrglossary.23346">934</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrprelocation"><code class="csfmt">\glsxtrprelocation</code></a><span class="qquad"></span><a href="#sec:stylemods">§8.6.5</a>; <a href="#wrglossary.10871">427</a>, <a href="#wrglossary.10882">428</a>, <a href="#wrglossary.10979">432</a>, <a href="#wrglossary.11103">440</a>, <span class="summarylocfmt"><a href="#wrglossary.21246">858</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrprependlabelprefix"><code class="csfmt">\glsxtrprependlabelprefix</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13739">563</a>, <span class="summarylocfmt"><a href="#wrglossary.21251">858</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrPreToDefaultGlsOpts"><code class="csfmt">\GlsXtrPreToDefaultGlsOpts</code></a><span class="qquad"></span><a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4702">186</a>, <a href="#wrglossary.4730">187</a>, <span class="summarylocfmt"><a href="#wrglossary.21253">858</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrprovideaccsuppcmd"><code class="csfmt">\glsxtrprovideaccsuppcmd</code></a><span class="qquad"></span><a href="#wrglossary.4227">168</a>, <a href="#wrglossary.4241">169</a>, <span class="summarylocfmt"><a href="#wrglossary.21257">858</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrProvideBibTeXFields"><code class="csfmt">\GlsXtrProvideBibTeXFields</code></a><span class="qquad"></span><a href="#sec:resourcecommands">§11.5.2</a>; <a href="#wrglossary.13098">536</a>, <a href="#wrglossary.19519">785</a>–<a href="#wrglossary.19559">788</a>, <span class="summarylocfmt"><a href="#wrglossary.21262">858</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrprovidecommand"><code class="csfmt">\glsxtrprovidecommand</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13943">572</a>, <span class="summarylocfmt"><a href="#wrglossary.21265">858</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrprovidestoragekey"><code class="csfmt">\glsxtrprovidestoragekey</code></a><span class="qquad"></span><a href="#sec:newkeys">§3.2</a>; <a href="#wrglossary.1046">35</a>, <a href="#wrglossary.13481">554</a>, <span class="summarylocfmt"><a href="#wrglossary.21270">859</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrrecentanchor"><code class="csfmt">\glsxtrrecentanchor</code></a><span class="qquad"></span><a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13585">557</a>, <a href="#wrglossary.13629">559</a>, <span class="summarylocfmt"><a href="#wrglossary.21273">859</a></span>, <a href="#wrglossary.21741">877</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrRecordCount"><code class="csfmt">\GlsXtrRecordCount</code></a><span class="qquad"></span><a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12756">523</a>, <a href="#wrglossary.12777">524</a>, <span class="summarylocfmt"><a href="#wrglossary.21277">859</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrRecordCounter"><code class="csfmt">\GlsXtrRecordCounter</code></a><span class="qquad"></span><a href="#sec:printunsrtunit">§8.4.3.2</a>; <a href="#wrglossary.10392">407</a>, <a href="#wrglossary.14806">615</a>, <a href="#wrglossary.19356">779</a>, <span class="summarylocfmt"><a href="#wrglossary.21281">859</a></span>, <a href="#wrglossary.23201">928</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrrecordtriggervalue"><code class="csfmt">\glsxtrrecordtriggervalue</code></a><span class="qquad"></span><a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12774">524</a>, <a href="#wrglossary.12902">528</a>, <a href="#wrglossary.12927">529</a>, <a href="#wrglossary.20411">822</a>, <span class="summarylocfmt"><a href="#wrglossary.21283">859</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:rgls"><code class="csfmt">\rgls</code></a> &amp; <a href="#glo:switch.record-count"><span class="longargfmt">--record-count</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrRecordWarning"><code class="csfmt">\GlsXtrRecordWarning</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.21286">859</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrregularfont"><code class="csfmt">\glsxtrregularfont</code></a><span class="qquad"></span><a href="#sec:middleformat">§5.5.2</a>; <a href="#wrglossary.1772">60</a>, <a href="#wrglossary.1855">65</a>, <a href="#wrglossary.4599">183</a>, <a href="#wrglossary.6055">236</a>, <a href="#wrglossary.6138">240</a>, <a href="#wrglossary.6541">255</a>, <a href="#wrglossary.17381">706</a>, <span class="summarylocfmt"><a href="#wrglossary.21290">859</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrResetLocalBuffer"><code class="csfmt">\GlsXtrResetLocalBuffer</code></a><span class="qquad"></span><a href="#sec:unsetbuffer">§5.10.1</a>; <a href="#wrglossary.7480">285</a>, <a href="#wrglossary.7517">287</a>, <a href="#wrglossary.7526">288</a>, <span class="summarylocfmt"><a href="#wrglossary.21294">860</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GlsXtrUnsetBufferEnableRepeatLocal"><code class="csfmt">\GlsXtrUnsetBufferEnableRepeatLocal</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrresourcecount"><code class="csfmt">\glsxtrresourcecount</code></a><span class="qquad"></span><a href="#sec:bib2gls">§11</a>; <a href="#wrglossary.12457">511</a>, <a href="#wrglossary.20587">830</a>, <span class="summarylocfmt"><a href="#wrglossary.21297">860</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrresourcefile"><code class="csfmt">\glsxtrresourcefile</code></a><span class="qquad"></span><a href="#sec:bib2gls">§11</a>; <a href="#wrglossary.646">23</a>, <a href="#wrglossary.681">24</a>, <a href="#wrglossary.12432">510</a>–<a href="#wrglossary.12479">512</a>, <a href="#wrglossary.14510">603</a>, <a href="#wrglossary.20585">830</a>, <a href="#wrglossary.20876">842</a>, <span class="summarylocfmt"><a href="#wrglossary.21301">860</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:idx.resourceopt">resource options</a> &amp; <a href="#glo:GlsXtrLoadResources"><code class="csfmt">\GlsXtrLoadResources</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrresourceinit"><code class="csfmt">\glsxtrresourceinit</code></a><span class="qquad"></span><a href="#sec:bib2gls">§11</a>; <a href="#wrglossary.12495">512</a>, <span class="summarylocfmt"><a href="#wrglossary.21308">860</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrrestoremarkhook"><code class="csfmt">\glsxtrrestoremarkhook</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5836">227</a>, <a href="#wrglossary.10638">418</a>, <a href="#wrglossary.20795">837</a>, <span class="summarylocfmt"><a href="#wrglossary.21312">860</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrrestorepostpunc"><code class="csfmt">\glsxtrrestorepostpunc</code></a><span class="qquad"></span><a href="#sec:postdeschooks">§8.6.2</a>; <a href="#wrglossary.10764">423</a>, <span class="summarylocfmt"><a href="#wrglossary.21314">860</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrrevert"><code class="csfmt">\glsxtrrevert</code></a><span class="qquad"></span><a href="#wrglossary.3281">133</a>, <a href="#wrglossary.4326">171</a>, <a href="#wrglossary.19696">794</a>, <a href="#wrglossary.19795">798</a>, <span class="summarylocfmt"><a href="#wrglossary.21319">860</a></span>, <a href="#wrglossary.21348">862</a>, <a href="#wrglossary.21652">873</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrRevertMarks"><code class="csfmt">\glsxtrRevertMarks</code></a><span class="qquad"></span><a href="#sec:headtitle">§5.3</a>; <a href="#wrglossary.5160">201</a>, <a href="#wrglossary.5203">204</a>, <a href="#wrglossary.5479">214</a>, <a href="#wrglossary.20391">821</a>, <span class="summarylocfmt"><a href="#wrglossary.21321">861</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtrRevertTocMarks"><code class="csfmt">\glsxtrRevertTocMarks</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrRevertTocMarks"><code class="csfmt">\glsxtrRevertTocMarks</code></a><span class="qquad"></span><a href="#sec:headtitle">§5.3</a>; <a href="#wrglossary.5165">201</a>, <a href="#wrglossary.5207">204</a>, <a href="#wrglossary.5483">214</a>, <a href="#wrglossary.20390">821</a>, <span class="summarylocfmt"><a href="#wrglossary.21325">861</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtrRevertMarks"><code class="csfmt">\glsxtrRevertMarks</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsaveinsert"><code class="csfmt">\glsxtrsaveinsert</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.1610">54</a>, <a href="#wrglossary.6471">253</a>, <a href="#wrglossary.20057">807</a>, <span class="summarylocfmt"><a href="#wrglossary.21328">861</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrscfont"><code class="csfmt">\glsxtrscfont</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.21335">861</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsconlydescname"><code class="csfmt">\glsxtrsconlydescname</code></a><span class="qquad"></span><a href="#wrglossary.2981">113</a>, <a href="#wrglossary.3886">156</a>, <span class="summarylocfmt"><a href="#wrglossary.21337">861</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsconlydescsort"><code class="csfmt">\glsxtrsconlydescsort</code></a><span class="qquad"></span><a href="#wrglossary.2982">113</a>, <a href="#wrglossary.3889">156</a>, <span class="summarylocfmt"><a href="#wrglossary.21340">861</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsconlyname"><code class="csfmt">\glsxtrsconlyname</code></a><span class="qquad"></span><a href="#wrglossary.2966">112</a>, <a href="#wrglossary.3882">156</a>, <span class="summarylocfmt"><a href="#wrglossary.21343">861</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsconlyrevert"><code class="csfmt">\glsxtrsconlyrevert</code></a><span class="qquad"></span><a href="#wrglossary.3861">155</a>, <span class="summarylocfmt"><a href="#wrglossary.21346">862</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsconlysuffix"><code class="csfmt">\glsxtrsconlysuffix</code></a><span class="qquad"></span><a href="#wrglossary.2969">113</a>, <a href="#wrglossary.3866">155</a>, <span class="summarylocfmt"><a href="#wrglossary.21351">862</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrscrevert"><code class="csfmt">\glsxtrscrevert</code></a><span class="qquad"></span><a href="#wrglossary.3379">137</a>, <a href="#wrglossary.3863">155</a>, <a href="#wrglossary.3907">157</a>, <span class="summarylocfmt"><a href="#wrglossary.21355">862</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrscsuffix"><code class="csfmt">\glsxtrscsuffix</code></a><span class="qquad"></span><a href="#wrglossary.1923">67</a>–<a href="#wrglossary.1954">69</a>, <a href="#wrglossary.2102">75</a>, <a href="#wrglossary.2115">76</a>, <a href="#wrglossary.2272">82</a>, <a href="#wrglossary.2285">83</a>, <a href="#wrglossary.2540">94</a>, <a href="#wrglossary.2553">95</a>, <a href="#wrglossary.3074">118</a>–<a href="#wrglossary.3114">121</a>, <a href="#wrglossary.3383">137</a>, <a href="#wrglossary.3867">155</a>, <a href="#wrglossary.3912">157</a>, <a href="#wrglossary.4316">171</a>, <a href="#wrglossary.15693">654</a>, <span class="summarylocfmt"><a href="#wrglossary.21361">862</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrscuserrevert"><code class="csfmt">\glsxtrscuserrevert</code></a><span class="qquad"></span><a href="#wrglossary.3377">136</a>, <a href="#wrglossary.3381">137</a>, <span class="summarylocfmt"><a href="#wrglossary.21366">862</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrscusersuffix"><code class="csfmt">\glsxtrscusersuffix</code></a><span class="qquad"></span><a href="#wrglossary.2462">91</a>, <a href="#wrglossary.3382">137</a>, <span class="summarylocfmt"><a href="#wrglossary.21371">862</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrseealsolabels"><code class="csfmt">\glsxtrseealsolabels</code></a><span class="qquad"></span><a href="#sec:getsee">§5.9.2</a>; <a href="#wrglossary.7272">277</a>, <span class="summarylocfmt"><a href="#wrglossary.21374">862</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrseelist"><code class="csfmt">\glsxtrseelist</code></a><span class="qquad"></span><a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7770">299</a>, <span class="summarylocfmt"><a href="#wrglossary.21378">863</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrseelists"><code class="csfmt">\glsxtrseelists</code></a><span class="qquad"></span><a href="#sec:getsee">§5.9.2</a>; <a href="#wrglossary.7240">276</a>, <span class="summarylocfmt"><a href="#wrglossary.21381">863</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtrseelistsencap"><code class="csfmt">\glsxtrseelistsencap</code></a> &amp; <a href="#glo:glsxtrseelistsdelim"><code class="csfmt">\glsxtrseelistsdelim</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrseelistsdelim"><code class="csfmt">\glsxtrseelistsdelim</code></a><span class="qquad"></span><a href="#sec:getsee">§5.9.2</a>; <a href="#wrglossary.7254">277</a>, <span class="summarylocfmt"><a href="#wrglossary.21392">863</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrseelistsencap"><code class="csfmt">\glsxtrseelistsencap</code></a><span class="qquad"></span><a href="#sec:getsee">§5.9.2</a>; <a href="#wrglossary.7249">276</a>, <a href="#wrglossary.7253">277</a>, <span class="summarylocfmt"><a href="#wrglossary.21395">863</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsetactualanchor"><code class="csfmt">\glsxtrsetactualanchor</code></a><span class="qquad"></span><a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13599">557</a>, <span class="summarylocfmt"><a href="#wrglossary.21398">863</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrSetActualChar"><code class="csfmt">\GlsXtrSetActualChar</code></a><span class="qquad"></span><a href="#sec:autoindex">§12</a>; <a href="#wrglossary.14084">577</a>, <span class="summarylocfmt"><a href="#wrglossary.21402">863</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsetaliasnoindex"><code class="csfmt">\glsxtrsetaliasnoindex</code></a><span class="qquad"></span><a href="#sec:glssee">§5.9.3</a>; <a href="#wrglossary.7028">267</a>, <a href="#wrglossary.7297">278</a>, <a href="#wrglossary.7311">279</a>, <a href="#wrglossary.20466">824</a>, <span class="summarylocfmt"><a href="#wrglossary.21403">864</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrSetAltModifier"><code class="csfmt">\GlsXtrSetAltModifier</code></a><span class="qquad"></span><a href="#sec:glsref">§5</a>; <a href="#wrglossary.4607">184</a>, <a href="#wrglossary.7992">309</a>, <a href="#wrglossary.8303">326</a>, <a href="#wrglossary.20883">842</a>, <span class="summarylocfmt"><a href="#wrglossary.21405">864</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsetbibglsaux"><code class="csfmt">\glsxtrsetbibglsaux</code></a><span class="qquad"></span><a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.774">26</a>, <span class="summarylocfmt"><a href="#wrglossary.21408">864</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsetcategory"><code class="csfmt">\glsxtrsetcategory</code></a><span class="qquad"></span><a href="#sec:categories">§10</a>; <a href="#wrglossary.12051">492</a>, <span class="summarylocfmt"><a href="#wrglossary.21412">864</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsetcategoryforall"><code class="csfmt">\glsxtrsetcategoryforall</code></a><span class="qquad"></span><a href="#sec:categories">§10</a>; <a href="#wrglossary.12053">492</a>, <span class="summarylocfmt"><a href="#wrglossary.21414">864</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsetcomplexstyle"><code class="csfmt">\glsxtrsetcomplexstyle</code></a><span class="qquad"></span><a href="#sec:abbrstyleinit">§4.5.3.1</a>; <a href="#wrglossary.4097">165</a>, <a href="#wrglossary.4142">166</a>, <span class="summarylocfmt"><a href="#wrglossary.21417">864</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrSetDefaultGlsOpts"><code class="csfmt">\GlsXtrSetDefaultGlsOpts</code></a><span class="qquad"></span><a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4700">186</a>–<a href="#wrglossary.4795">190</a>, <a href="#wrglossary.7301">278</a>, <span class="summarylocfmt"><a href="#wrglossary.21420">864</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrSetDefaultNumberFormat"><code class="csfmt">\GlsXtrSetDefaultNumberFormat</code></a><span class="qquad"></span><a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4747">188</a>, <span class="summarylocfmt"><a href="#wrglossary.21423">865</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrSetEncapChar"><code class="csfmt">\GlsXtrSetEncapChar</code></a><span class="qquad"></span><a href="#sec:autoindex">§12</a>; <a href="#wrglossary.14087">577</a>, <span class="summarylocfmt"><a href="#wrglossary.21426">865</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrSetEscChar"><code class="csfmt">\GlsXtrSetEscChar</code></a><span class="qquad"></span><a href="#sec:autoindex">§12</a>; <a href="#wrglossary.14086">577</a>, <span class="summarylocfmt"><a href="#wrglossary.21427">865</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrSetField"><code class="csfmt">\GlsXtrSetField</code></a><span class="qquad"></span><a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1125">37</a>–<a href="#wrglossary.1204">40</a>, <a href="#wrglossary.7170">272</a>, <a href="#wrglossary.9882">390</a>, <a href="#wrglossary.12049">492</a>, <a href="#wrglossary.14326">599</a>, <a href="#wrglossary.16397">672</a>, <a href="#wrglossary.16449">674</a>, <a href="#wrglossary.19721">795</a>, <a href="#wrglossary.20570">829</a>, <span class="summarylocfmt"><a href="#wrglossary.21428">865</a></span>, <a href="#wrglossary.23449">938</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsetfieldifexists"><code class="csfmt">\glsxtrsetfieldifexists</code></a><span class="qquad"></span><a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1186">39</a>, <span class="summarylocfmt"><a href="#wrglossary.21433">865</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsetgrouptitle"><code class="csfmt">\glsxtrsetgrouptitle</code></a><span class="qquad"></span><a href="#sec:glosgroups">§8.6.4</a>; <a href="#wrglossary.1023">34</a>, <a href="#wrglossary.9833">389</a>, <a href="#wrglossary.10843">426</a>, <a href="#wrglossary.14601">607</a>, <span class="summarylocfmt"><a href="#wrglossary.21436">865</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsetglossarylabel"><code class="csfmt">\glsxtrsetglossarylabel</code></a><span class="qquad"></span><a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9553">378</a>, <span class="summarylocfmt"><a href="#wrglossary.21439">866</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrSetLevelChar"><code class="csfmt">\GlsXtrSetLevelChar</code></a><span class="qquad"></span><a href="#sec:autoindex">§12</a>; <a href="#wrglossary.14085">577</a>, <span class="summarylocfmt"><a href="#wrglossary.21443">866</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsetlongfirstuse"><code class="csfmt">\glsxtrsetlongfirstuse</code></a><span class="qquad"></span><a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1534">52</a>, <span class="summarylocfmt"><a href="#wrglossary.21444">866</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrSetPlusModifier"><code class="csfmt">\GlsXtrSetPlusModifier</code></a><span class="qquad"></span><a href="#sec:glsref">§5</a>; <a href="#wrglossary.4615">184</a>, <span class="summarylocfmt"><a href="#wrglossary.21448">866</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsetpopts"><code class="csfmt">\glsxtrsetpopts</code></a><span class="qquad"></span><a href="#sec:nested">§5.4</a>; <a href="#wrglossary.5931">231</a>, <a href="#wrglossary.16528">677</a>, <a href="#wrglossary.21075">851</a>, <span class="summarylocfmt"><a href="#wrglossary.21452">866</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsetpunctuationmarks"><code class="csfmt">\glsxtrsetpunctuationmarks</code></a><span class="qquad"></span><a href="#sec:postlinkhook">§5.5.4</a>; <a href="#wrglossary.6369">249</a>, <span class="summarylocfmt"><a href="#wrglossary.21456">866</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrSetRecordCountAttribute"><code class="csfmt">\GlsXtrSetRecordCountAttribute</code></a><span class="qquad"></span><a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12782">524</a>, <span class="summarylocfmt"><a href="#wrglossary.21460">866</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrSetStarModifier"><code class="csfmt">\GlsXtrSetStarModifier</code></a><span class="qquad"></span><a href="#sec:glsref">§5</a>; <a href="#wrglossary.4614">184</a>, <span class="summarylocfmt"><a href="#wrglossary.21463">867</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsetupfulldefs"><code class="csfmt">\glsxtrsetupfulldefs</code></a><span class="qquad"></span><a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#wrglossary.1598">54</a>, <span class="summarylocfmt"><a href="#wrglossary.21467">867</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrSetWidest"><code class="csfmt">\glsxtrSetWidest</code></a><span class="qquad"></span><a href="#sec:glstexcmds">§11.5.3</a>; <a href="#wrglossary.13467">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21469">867</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrSetWidestFallback"><code class="csfmt">\glsxtrSetWidestFallback</code></a><span class="qquad"></span><a href="#sec:glstexcmds">§11.5.3</a>; <a href="#wrglossary.13476">554</a>, <span class="summarylocfmt"><a href="#wrglossary.21473">867</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrshort"><code class="csfmt">\GLSxtrshort</code></a><span class="qquad"></span><a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.1509">52</a>, <a href="#wrglossary.5223">204</a>, <a href="#wrglossary.5285">207</a>, <a href="#wrglossary.5597">218</a>, <a href="#wrglossary.15977">659</a>, <a href="#wrglossary.16126">662</a>, <a href="#wrglossary.18942">765</a>, <span class="summarylocfmt"><a href="#wrglossary.21478">867</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrshort"><code class="csfmt">\Glsxtrshort</code></a><span class="qquad"></span><a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.1504">51</a>, <a href="#wrglossary.5281">207</a>, <a href="#wrglossary.15984">659</a>, <a href="#wrglossary.16133">662</a>, <a href="#wrglossary.18956">765</a>, <span class="summarylocfmt"><a href="#wrglossary.21485">867</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrshort"><code class="csfmt">\glsxtrshort</code></a><span class="qquad"></span><a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.450">18</a>, <a href="#wrglossary.495">19</a>, <a href="#wrglossary.1321">43</a>, <a href="#wrglossary.1425">47</a>, <a href="#wrglossary.1500">51</a>, <a href="#wrglossary.1616">54</a>, <a href="#wrglossary.1625">55</a>, <a href="#wrglossary.1793">61</a>, <a href="#wrglossary.1822">63</a>, <a href="#wrglossary.1883">66</a>, <a href="#wrglossary.2083">74</a>, <a href="#wrglossary.2250">82</a>, <a href="#wrglossary.2518">93</a>, <a href="#wrglossary.2729">103</a>, <a href="#wrglossary.3019">115</a>, <a href="#wrglossary.3957">159</a>, <a href="#wrglossary.4479">177</a>, <a href="#wrglossary.4577">183</a>, <a href="#wrglossary.4651">185</a>, <a href="#wrglossary.5174">201</a>, <a href="#wrglossary.5216">204</a>, <a href="#wrglossary.5278">207</a>, <a href="#wrglossary.6012">235</a>, <a href="#wrglossary.6164">240</a>, <a href="#wrglossary.6336">247</a>, <a href="#wrglossary.6440">252</a>, <a href="#wrglossary.8500">334</a>, <a href="#wrglossary.9097">364</a>, <a href="#wrglossary.15099">631</a>, <a href="#wrglossary.15136">632</a>, <a href="#wrglossary.15994">659</a>, <a href="#wrglossary.16140">662</a>, <a href="#wrglossary.18968">765</a>, <span class="summarylocfmt"><a href="#wrglossary.21494">867</a></span>, <a href="#wrglossary.21590">871</a>, <a href="#wrglossary.22556">911</a>, <a href="#wrglossary.23050">924</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrshortdescname"><code class="csfmt">\glsxtrshortdescname</code></a><span class="qquad"></span><a href="#wrglossary.1902">66</a>, <a href="#wrglossary.3632">147</a>, <span class="summarylocfmt"><a href="#wrglossary.21504">868</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrshortformat"><code class="csfmt">\GLSxtrshortformat</code></a><span class="qquad"></span><a href="#wrglossary.4490">177</a>, <span class="summarylocfmt"><a href="#wrglossary.21507">868</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrshortformat"><code class="csfmt">\Glsxtrshortformat</code></a><span class="qquad"></span><a href="#wrglossary.4488">177</a>, <span class="summarylocfmt"><a href="#wrglossary.21511">868</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrshortformat"><code class="csfmt">\glsxtrshortformat</code></a><span class="qquad"></span><a href="#wrglossary.2992">114</a>, <a href="#wrglossary.4478">177</a>, <a href="#wrglossary.4493">178</a>, <a href="#wrglossary.4537">180</a>, <a href="#wrglossary.20764">836</a>, <span class="summarylocfmt"><a href="#wrglossary.21515">868</a></span>, <a href="#wrglossary.21532">869</a>, <a href="#wrglossary.21563">870</a>, <a href="#wrglossary.21622">872</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrshortformatgrp"><code class="csfmt">\GLSxtrshortformatgrp</code></a><span class="qquad"></span><a href="#wrglossary.4504">178</a>, <span class="summarylocfmt"><a href="#wrglossary.21522">868</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrshortformatgrp"><code class="csfmt">\Glsxtrshortformatgrp</code></a><span class="qquad"></span><a href="#wrglossary.4502">178</a>, <span class="summarylocfmt"><a href="#wrglossary.21526">868</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrshortformatgrp"><code class="csfmt">\glsxtrshortformatgrp</code></a><span class="qquad"></span><a href="#wrglossary.4499">178</a>, <a href="#wrglossary.21524">868</a>, <span class="summarylocfmt"><a href="#wrglossary.21530">869</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrshorthyphen"><code class="csfmt">\glsxtrshorthyphen</code></a><span class="qquad"></span><a href="#wrglossary.3790">152</a>, <span class="summarylocfmt"><a href="#wrglossary.21534">869</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrshorthyphenlong"><code class="csfmt">\GLSxtrshorthyphenlong</code></a><span class="qquad"></span><a href="#wrglossary.3785">152</a>, <span class="summarylocfmt"><a href="#wrglossary.21537">869</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrshorthyphenlong"><code class="csfmt">\glsxtrshorthyphenlong</code></a><span class="qquad"></span><a href="#wrglossary.3781">152</a>, <span class="summarylocfmt"><a href="#wrglossary.21541">869</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrshorthyphenlongsort"><code class="csfmt">\glsxtrshorthyphenlongsort</code></a><span class="qquad"></span><a href="#wrglossary.2857">108</a>, <a href="#wrglossary.3674">148</a>, <span class="summarylocfmt"><a href="#wrglossary.21544">869</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrshortlongdescname"><code class="csfmt">\glsxtrshortlongdescname</code></a><span class="qquad"></span><a href="#wrglossary.2536">94</a>, <a href="#wrglossary.2895">110</a>, <a href="#wrglossary.3326">134</a>, <span class="summarylocfmt"><a href="#wrglossary.21547">869</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrshortlongdescsort"><code class="csfmt">\glsxtrshortlongdescsort</code></a><span class="qquad"></span><a href="#wrglossary.2537">94</a>, <a href="#wrglossary.2676">100</a>, <a href="#wrglossary.2896">110</a>, <a href="#wrglossary.3320">134</a>, <span class="summarylocfmt"><a href="#wrglossary.21550">869</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrshortlongformat"><code class="csfmt">\GLSxtrshortlongformat</code></a><span class="qquad"></span><a href="#wrglossary.4540">180</a>, <span class="summarylocfmt"><a href="#wrglossary.21553">870</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrshortlongformat"><code class="csfmt">\Glsxtrshortlongformat</code></a><span class="qquad"></span><a href="#wrglossary.4538">180</a>, <span class="summarylocfmt"><a href="#wrglossary.21557">870</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrshortlongformat"><code class="csfmt">\glsxtrshortlongformat</code></a><span class="qquad"></span><a href="#wrglossary.1866">65</a>, <a href="#wrglossary.2499">93</a>, <a href="#wrglossary.2997">114</a>, <a href="#wrglossary.4530">180</a>, <span class="summarylocfmt"><a href="#wrglossary.21561">870</a></span>, <a href="#wrglossary.21578">871</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrshortlongname"><code class="csfmt">\glsxtrshortlongname</code></a><span class="qquad"></span><a href="#wrglossary.2856">108</a>, <a href="#wrglossary.3314">134</a>, <span class="summarylocfmt"><a href="#wrglossary.21565">870</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrshortlongplformat"><code class="csfmt">\GLSxtrshortlongplformat</code></a><span class="qquad"></span><a href="#wrglossary.4548">181</a>, <span class="summarylocfmt"><a href="#wrglossary.21568">870</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrshortlongplformat"><code class="csfmt">\Glsxtrshortlongplformat</code></a><span class="qquad"></span><a href="#wrglossary.4546">180</a>, <span class="summarylocfmt"><a href="#wrglossary.21572">870</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrshortlongplformat"><code class="csfmt">\glsxtrshortlongplformat</code></a><span class="qquad"></span><a href="#wrglossary.4542">180</a>, <span class="summarylocfmt"><a href="#wrglossary.21576">870</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrshortlonguserdescname"><code class="csfmt">\glsxtrshortlonguserdescname</code></a><span class="qquad"></span><a href="#wrglossary.2458">91</a>, <a href="#wrglossary.2675">100</a>–<a href="#wrglossary.2725">103</a>, <a href="#wrglossary.3433">139</a>, <span class="summarylocfmt"><a href="#wrglossary.21579">871</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrshortnolongname"><code class="csfmt">\glsxtrshortnolongname</code></a><span class="qquad"></span><a href="#wrglossary.1884">66</a>, <a href="#wrglossary.3626">146</a>, <span class="summarylocfmt"><a href="#wrglossary.21583">871</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrshortpl"><code class="csfmt">\GLSxtrshortpl</code></a><span class="qquad"></span><a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.1523">52</a>, <a href="#wrglossary.5317">208</a>, <a href="#wrglossary.16004">660</a>, <a href="#wrglossary.16147">663</a>, <a href="#wrglossary.18647">753</a>, <span class="summarylocfmt"><a href="#wrglossary.21586">871</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrshortpl"><code class="csfmt">\Glsxtrshortpl</code></a><span class="qquad"></span><a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.1518">52</a>, <a href="#wrglossary.5313">208</a>, <a href="#wrglossary.16011">660</a>, <a href="#wrglossary.16154">663</a>, <a href="#wrglossary.18661">754</a>, <span class="summarylocfmt"><a href="#wrglossary.21593">871</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrshortpl"><code class="csfmt">\glsxtrshortpl</code></a><span class="qquad"></span><a href="#sec:abbrvfieldrefs">§4.3</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.1514">52</a>, <a href="#wrglossary.1646">55</a>, <a href="#wrglossary.5310">207</a>, <a href="#wrglossary.6441">252</a>, <a href="#wrglossary.16021">660</a>, <a href="#wrglossary.16161">663</a>, <a href="#wrglossary.18673">754</a>, <span class="summarylocfmt"><a href="#wrglossary.21602">871</a></span>, <a href="#wrglossary.23074">925</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrshortplformat"><code class="csfmt">\GLSxtrshortplformat</code></a><span class="qquad"></span><a href="#wrglossary.4497">178</a>, <span class="summarylocfmt"><a href="#wrglossary.21612">871</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrshortplformat"><code class="csfmt">\Glsxtrshortplformat</code></a><span class="qquad"></span><a href="#wrglossary.4495">178</a>, <span class="summarylocfmt"><a href="#wrglossary.21616">872</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrshortplformat"><code class="csfmt">\glsxtrshortplformat</code></a><span class="qquad"></span><a href="#wrglossary.3507">142</a>, <a href="#wrglossary.4492">178</a>–<a href="#wrglossary.4544">180</a>, <a href="#wrglossary.21614">871</a>, <span class="summarylocfmt"><a href="#wrglossary.21620">872</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrshortplformatgrp"><code class="csfmt">\GLSxtrshortplformatgrp</code></a><span class="qquad"></span><a href="#wrglossary.4511">179</a>, <span class="summarylocfmt"><a href="#wrglossary.21624">872</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrshortplformatgrp"><code class="csfmt">\Glsxtrshortplformatgrp</code></a><span class="qquad"></span><a href="#wrglossary.4509">178</a>, <span class="summarylocfmt"><a href="#wrglossary.21628">872</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrshortplformatgrp"><code class="csfmt">\glsxtrshortplformatgrp</code></a><span class="qquad"></span><a href="#wrglossary.4506">178</a>, <span class="summarylocfmt"><a href="#wrglossary.21632">872</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrshowtargetinner"><code class="csfmt">\glsxtrshowtargetinner</code></a><span class="qquad"></span><a href="#sec:debuggingopts">§2.5</a>; <a href="#wrglossary.902">30</a>, <span class="summarylocfmt"><a href="#wrglossary.21636">872</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrshowtargetouter"><code class="csfmt">\glsxtrshowtargetouter</code></a><span class="qquad"></span><a href="#sec:debuggingopts">§2.5</a>; <a href="#wrglossary.898">30</a>, <span class="summarylocfmt"><a href="#wrglossary.21640">872</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrshowtargetsymbolleft"><code class="csfmt">\glsxtrshowtargetsymbolleft</code></a><span class="qquad"></span><a href="#sec:debuggingopts">§2.5</a>; <a href="#wrglossary.907">30</a>, <a href="#wrglossary.18852">762</a>, <span class="summarylocfmt"><a href="#wrglossary.21644">873</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrshowtargetsymbolright"><code class="csfmt">\glsxtrshowtargetsymbolright</code></a><span class="qquad"></span><a href="#sec:debuggingopts">§2.5</a>; <a href="#wrglossary.909">30</a>, <a href="#wrglossary.18855">762</a>, <span class="summarylocfmt"><a href="#wrglossary.21646">873</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsmfont"><code class="csfmt">\glsxtrsmfont</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.21648">873</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsmrevert"><code class="csfmt">\glsxtrsmrevert</code></a><span class="qquad"></span><a href="#wrglossary.3924">158</a>, <span class="summarylocfmt"><a href="#wrglossary.21650">873</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsmsuffix"><code class="csfmt">\glsxtrsmsuffix</code></a><span class="qquad"></span><a href="#wrglossary.1967">69</a>–<a href="#wrglossary.1998">71</a>, <a href="#wrglossary.2129">76</a>, <a href="#wrglossary.2142">77</a>, <a href="#wrglossary.2299">84</a>, <a href="#wrglossary.2567">96</a>, <a href="#wrglossary.3128">122</a>–<a href="#wrglossary.3168">125</a>, <a href="#wrglossary.3929">158</a>, <span class="summarylocfmt"><a href="#wrglossary.21655">873</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrspacerules"><code class="csfmt">\glsxtrspacerules</code></a><span class="qquad"></span><a href="#wrglossary.13257">542</a>, <span class="summarylocfmt"><a href="#wrglossary.21658">873</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrStandaloneEntryHeadName"><code class="csfmt">\GlsXtrStandaloneEntryHeadName</code></a><span class="qquad"></span><a href="#sec:glossentry">§8.5</a>; <a href="#wrglossary.10613">417</a>, <span class="summarylocfmt"><a href="#wrglossary.21660">873</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrStandaloneEntryHeadOther"><code class="csfmt">\GlsXtrStandaloneEntryHeadOther</code></a><span class="qquad"></span><a href="#sec:glossentry">§8.5</a>; <a href="#wrglossary.10630">418</a>, <span class="summarylocfmt"><a href="#wrglossary.21663">874</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrStandaloneEntryName"><code class="csfmt">\GlsXtrStandaloneEntryName</code></a><span class="qquad"></span><a href="#sec:glossentry">§8.5</a>; <a href="#wrglossary.6573">256</a>, <a href="#wrglossary.10565">415</a>, <span class="summarylocfmt"><a href="#wrglossary.21666">874</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrStandaloneEntryOther"><code class="csfmt">\GlsXtrStandaloneEntryOther</code></a><span class="qquad"></span><a href="#sec:glossentry">§8.5</a>; <a href="#wrglossary.10583">415</a>, <span class="summarylocfmt"><a href="#wrglossary.21668">874</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrStandaloneEntryPdfName"><code class="csfmt">\GlsXtrStandaloneEntryPdfName</code></a><span class="qquad"></span><a href="#sec:glossentry">§8.5</a>; <a href="#wrglossary.10611">417</a>, <span class="summarylocfmt"><a href="#wrglossary.21672">874</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrStandaloneEntryPdfOther"><code class="csfmt">\GlsXtrStandaloneEntryPdfOther</code></a><span class="qquad"></span><a href="#sec:glossentry">§8.5</a>; <a href="#wrglossary.10629">417</a>, <span class="summarylocfmt"><a href="#wrglossary.21675">874</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrStandaloneGlossaryType"><code class="csfmt">\GlsXtrStandaloneGlossaryType</code></a><span class="qquad"></span><a href="#sec:glossentry">§8.5</a>; <a href="#wrglossary.10554">414</a>, <span class="summarylocfmt"><a href="#wrglossary.21678">874</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrStandaloneSubEntryItem"><code class="csfmt">\GlsXtrStandaloneSubEntryItem</code></a><span class="qquad"></span><a href="#sec:glossentry">§8.5</a>; <a href="#wrglossary.10559">414</a>, <span class="summarylocfmt"><a href="#wrglossary.21681">874</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrstarflywarn"><code class="csfmt">\glsxtrstarflywarn</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.21684">875</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrStartUnsetBuffering"><code class="csfmt">\GlsXtrStartUnsetBuffering</code></a><span class="qquad"></span><a href="#sec:unsetbuffer">§5.10.1</a>; <a href="#wrglossary.7463">284</a>, <a href="#wrglossary.7472">285</a>, <span class="summarylocfmt"><a href="#wrglossary.21687">875</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GlsXtrStopUnsetBuffering"><code class="csfmt">\GlsXtrStopUnsetBuffering</code></a> &amp; <a href="#glo:GlsXtrDiscardUnsetBuffering"><code class="csfmt">\GlsXtrDiscardUnsetBuffering</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrStopUnsetBuffering"><code class="csfmt">\GlsXtrStopUnsetBuffering</code></a><span class="qquad"></span><a href="#sec:unsetbuffer">§5.10.1</a>; <a href="#wrglossary.7468">285</a>, <a href="#wrglossary.7543">289</a>, <span class="summarylocfmt"><a href="#wrglossary.21689">875</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GlsXtrStartUnsetBuffering"><code class="csfmt">\GlsXtrStartUnsetBuffering</code></a>, <a href="#glo:GlsXtrDiscardUnsetBuffering"><code class="csfmt">\GlsXtrDiscardUnsetBuffering</code></a> &amp; <a href="#glo:GlsXtrForUnsetBufferedList"><code class="csfmt">\GlsXtrForUnsetBufferedList</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrSubScriptDigitrules"><code class="csfmt">\glsxtrSubScriptDigitrules</code></a><span class="qquad"></span><a href="#wrglossary.13298">545</a>, <span class="summarylocfmt"><a href="#wrglossary.21691">875</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrsubsequentfmt"><code class="csfmt">\GLSxtrsubsequentfmt</code></a><span class="qquad"></span><a href="#wrglossary.4380">173</a>, <span class="summarylocfmt"><a href="#wrglossary.21693">875</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrsubsequentfmt"><code class="csfmt">\Glsxtrsubsequentfmt</code></a><span class="qquad"></span><a href="#wrglossary.4372">173</a>, <span class="summarylocfmt"><a href="#wrglossary.21697">875</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsubsequentfmt"><code class="csfmt">\glsxtrsubsequentfmt</code></a><span class="qquad"></span><a href="#wrglossary.1787">61</a>, <a href="#wrglossary.4366">173</a>, <a href="#wrglossary.6557">255</a>, <span class="summarylocfmt"><a href="#wrglossary.21701">875</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrsubsequentplfmt"><code class="csfmt">\GLSxtrsubsequentplfmt</code></a><span class="qquad"></span><a href="#wrglossary.4384">173</a>, <span class="summarylocfmt"><a href="#wrglossary.21704">876</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrsubsequentplfmt"><code class="csfmt">\Glsxtrsubsequentplfmt</code></a><span class="qquad"></span><a href="#wrglossary.4376">173</a>, <span class="summarylocfmt"><a href="#wrglossary.21708">876</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsubsequentplfmt"><code class="csfmt">\glsxtrsubsequentplfmt</code></a><span class="qquad"></span><a href="#wrglossary.4369">173</a>, <span class="summarylocfmt"><a href="#wrglossary.21712">876</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrSuperScriptDigitrules"><code class="csfmt">\glsxtrSuperScriptDigitrules</code></a><span class="qquad"></span><a href="#wrglossary.13299">545</a>, <span class="summarylocfmt"><a href="#wrglossary.21715">876</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsupphypernumber"><code class="csfmt">\glsxtrsupphypernumber</code></a><span class="qquad"></span><a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.4961">195</a>, <a href="#wrglossary.13515">555</a>, <span class="summarylocfmt"><a href="#wrglossary.21717">876</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrsupplocationurl"><code class="csfmt">\glsxtrsupplocationurl</code></a><span class="qquad"></span><a href="#wrglossary.20601">831</a>, <span class="summarylocfmt"><a href="#wrglossary.21721">876</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrtagfont"><code class="csfmt">\glsxtrtagfont</code></a><span class="qquad"></span><a href="#sec:tagging">§4.4</a>; <a href="#wrglossary.1711">58</a>, <a href="#wrglossary.12166">498</a>, <span class="summarylocfmt"><a href="#wrglossary.21724">877</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrtaggedlist"><code class="csfmt">\glsxtrtaggedlist</code></a><span class="qquad"></span><a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7776">300</a>, <span class="summarylocfmt"><a href="#wrglossary.21726">877</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrtaggedlistsep"><code class="csfmt">\glsxtrtaggedlistsep</code></a><span class="qquad"></span><a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7777">300</a>, <span class="summarylocfmt"><a href="#wrglossary.21731">877</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrTheLinkCounter"><code class="csfmt">\GlsXtrTheLinkCounter</code></a><span class="qquad"></span><a href="#sec:linkcount">§6.2</a>; <a href="#wrglossary.8163">318</a>, <span class="summarylocfmt"><a href="#wrglossary.21734">877</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrtitlednamereflink"><code class="csfmt">\glsxtrtitlednamereflink</code></a><span class="qquad"></span><a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.13627">559</a>, <span class="summarylocfmt"><a href="#wrglossary.21736">877</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrtitlefirst"><code class="csfmt">\GLSxtrtitlefirst</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5783">226</a>, <span class="summarylocfmt"><a href="#wrglossary.21742">877</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GLSfmtfirst"><code class="csfmt">\GLSfmtfirst</code></a> &amp; <a href="#glo:GLSxtrheadfirst"><code class="csfmt">\GLSxtrheadfirst</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrtitlefirst"><code class="csfmt">\Glsxtrtitlefirst</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5775">225</a>, <span class="summarylocfmt"><a href="#wrglossary.21747">878</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:Glsfmtfirst"><code class="csfmt">\Glsfmtfirst</code></a> &amp; <a href="#glo:Glsxtrheadfirst"><code class="csfmt">\Glsxtrheadfirst</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrtitlefirst"><code class="csfmt">\glsxtrtitlefirst</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5769">225</a>, <span class="summarylocfmt"><a href="#wrglossary.21751">878</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsfmtfirst"><code class="csfmt">\glsfmtfirst</code></a> &amp; <a href="#glo:glsxtrheadfirst"><code class="csfmt">\glsxtrheadfirst</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrtitlefirstplural"><code class="csfmt">\GLSxtrtitlefirstplural</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5805">226</a>, <span class="summarylocfmt"><a href="#wrglossary.21754">878</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GLSfmtfirstpl"><code class="csfmt">\GLSfmtfirstpl</code></a> &amp; <a href="#glo:GLSxtrheadfirstplural"><code class="csfmt">\GLSxtrheadfirstplural</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrtitlefirstplural"><code class="csfmt">\Glsxtrtitlefirstplural</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5797">226</a>, <span class="summarylocfmt"><a href="#wrglossary.21759">878</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:Glsfmtfirstpl"><code class="csfmt">\Glsfmtfirstpl</code></a> &amp; <a href="#glo:Glsxtrheadfirstplural"><code class="csfmt">\Glsxtrheadfirstplural</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrtitlefirstplural"><code class="csfmt">\glsxtrtitlefirstplural</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5791">226</a>, <span class="summarylocfmt"><a href="#wrglossary.21763">878</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsfmtfirstpl"><code class="csfmt">\glsfmtfirstpl</code></a> &amp; <a href="#glo:glsxtrheadfirstplural"><code class="csfmt">\glsxtrheadfirstplural</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrtitlefull"><code class="csfmt">\GLSxtrtitlefull</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5681">222</a>, <a href="#wrglossary.17879">722</a>, <span class="summarylocfmt"><a href="#wrglossary.21766">878</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GLSfmtfull"><code class="csfmt">\GLSfmtfull</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrtitlefull"><code class="csfmt">\Glsxtrtitlefull</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5675">222</a>, <a href="#wrglossary.17883">722</a>, <span class="summarylocfmt"><a href="#wrglossary.21769">878</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:Glsfmtfull"><code class="csfmt">\Glsfmtfull</code></a> &amp; <a href="#glo:Glsxtrheadfull"><code class="csfmt">\Glsxtrheadfull</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrtitlefull"><code class="csfmt">\glsxtrtitlefull</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5671">221</a>, <a href="#wrglossary.17887">723</a>, <span class="summarylocfmt"><a href="#wrglossary.21772">879</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsfmtfull"><code class="csfmt">\glsfmtfull</code></a> &amp; <a href="#glo:glsxtrheadfull"><code class="csfmt">\glsxtrheadfull</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrtitlefullpl"><code class="csfmt">\GLSxtrtitlefullpl</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5697">223</a>, <a href="#wrglossary.17891">723</a>, <span class="summarylocfmt"><a href="#wrglossary.21774">879</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GLSfmtfullpl"><code class="csfmt">\GLSfmtfullpl</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrtitlefullpl"><code class="csfmt">\Glsxtrtitlefullpl</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5691">222</a>, <a href="#wrglossary.17895">723</a>, <span class="summarylocfmt"><a href="#wrglossary.21777">879</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:Glsfmtfullpl"><code class="csfmt">\Glsfmtfullpl</code></a> &amp; <a href="#glo:Glsxtrheadfullpl"><code class="csfmt">\Glsxtrheadfullpl</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrtitlefullpl"><code class="csfmt">\glsxtrtitlefullpl</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5687">222</a>, <a href="#wrglossary.17899">723</a>, <span class="summarylocfmt"><a href="#wrglossary.21780">879</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsfmtfullpl"><code class="csfmt">\glsfmtfullpl</code></a> &amp; <a href="#glo:glsxtrheadfullpl"><code class="csfmt">\glsxtrheadfullpl</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrtitlelong"><code class="csfmt">\GLSxtrtitlelong</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5649">220</a>, <span class="summarylocfmt"><a href="#wrglossary.21782">879</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrtitlelong"><code class="csfmt">\Glsxtrtitlelong</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5643">220</a>, <span class="summarylocfmt"><a href="#wrglossary.21785">879</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrtitlelong"><code class="csfmt">\glsxtrtitlelong</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5639">220</a>, <span class="summarylocfmt"><a href="#wrglossary.21788">879</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrtitlelongpl"><code class="csfmt">\GLSxtrtitlelongpl</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5665">221</a>, <span class="summarylocfmt"><a href="#wrglossary.21791">879</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrtitlelongpl"><code class="csfmt">\Glsxtrtitlelongpl</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5659">221</a>, <span class="summarylocfmt"><a href="#wrglossary.21794">880</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrtitlelongpl"><code class="csfmt">\glsxtrtitlelongpl</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5655">221</a>, <span class="summarylocfmt"><a href="#wrglossary.21797">880</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrtitlename"><code class="csfmt">\GLSxtrtitlename</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5717">223</a>, <span class="summarylocfmt"><a href="#wrglossary.21800">880</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GLSfmtname"><code class="csfmt">\GLSfmtname</code></a> &amp; <a href="#glo:GLSxtrheadname"><code class="csfmt">\GLSxtrheadname</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrtitlename"><code class="csfmt">\Glsxtrtitlename</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5709">223</a>, <span class="summarylocfmt"><a href="#wrglossary.21803">880</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:Glsfmtname"><code class="csfmt">\Glsfmtname</code></a> &amp; <a href="#glo:Glsxtrheadname"><code class="csfmt">\Glsxtrheadname</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrtitlename"><code class="csfmt">\glsxtrtitlename</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5703">223</a>, <span class="summarylocfmt"><a href="#wrglossary.21806">880</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsfmtname"><code class="csfmt">\glsfmtname</code></a> &amp; <a href="#glo:glsxtrheadname"><code class="csfmt">\glsxtrheadname</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrtitleopts"><code class="csfmt">\glsxtrtitleopts</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5262">206</a>, <a href="#wrglossary.5538">216</a>, <a href="#wrglossary.5559">217</a>, <span class="summarylocfmt"><a href="#wrglossary.21808">880</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrtitleorpdforheading"><code class="csfmt">\glsxtrtitleorpdforheading</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5496">215</a>, <a href="#wrglossary.10581">415</a>, <span class="summarylocfmt"><a href="#wrglossary.21811">880</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrtitleplural"><code class="csfmt">\GLSxtrtitleplural</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5761">225</a>, <span class="summarylocfmt"><a href="#wrglossary.21813">881</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GLSfmtplural"><code class="csfmt">\GLSfmtplural</code></a> &amp; <a href="#glo:GLSxtrheadplural"><code class="csfmt">\GLSxtrheadplural</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrtitleplural"><code class="csfmt">\Glsxtrtitleplural</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5753">225</a>, <span class="summarylocfmt"><a href="#wrglossary.21818">881</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:Glsfmtplural"><code class="csfmt">\Glsfmtplural</code></a> &amp; <a href="#glo:Glsxtrheadplural"><code class="csfmt">\Glsxtrheadplural</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrtitleplural"><code class="csfmt">\glsxtrtitleplural</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5747">224</a>, <span class="summarylocfmt"><a href="#wrglossary.21822">881</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsfmtplural"><code class="csfmt">\glsfmtplural</code></a> &amp; <a href="#glo:glsxtrheadplural"><code class="csfmt">\glsxtrheadplural</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrtitleshort"><code class="csfmt">\GLSxtrtitleshort</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5593">218</a>, <span class="summarylocfmt"><a href="#wrglossary.21825">881</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrtitleshort"><code class="csfmt">\Glsxtrtitleshort</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5573">217</a>, <a href="#wrglossary.5599">218</a>, <span class="summarylocfmt"><a href="#wrglossary.21828">881</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrtitleshort"><code class="csfmt">\glsxtrtitleshort</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5552">217</a>, <a href="#wrglossary.5598">218</a>, <span class="summarylocfmt"><a href="#wrglossary.21830">881</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrtitleshortpl"><code class="csfmt">\GLSxtrtitleshortpl</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5633">220</a>, <span class="summarylocfmt"><a href="#wrglossary.21832">881</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrtitleshortpl"><code class="csfmt">\Glsxtrtitleshortpl</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5627">219</a>, <span class="summarylocfmt"><a href="#wrglossary.21835">882</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrtitleshortpl"><code class="csfmt">\glsxtrtitleshortpl</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5623">219</a>, <span class="summarylocfmt"><a href="#wrglossary.21837">882</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrtitletext"><code class="csfmt">\GLSxtrtitletext</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5739">224</a>, <span class="summarylocfmt"><a href="#wrglossary.21840">882</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GLSfmttext"><code class="csfmt">\GLSfmttext</code></a> &amp; <a href="#glo:GLSxtrheadtext"><code class="csfmt">\GLSxtrheadtext</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrtitletext"><code class="csfmt">\Glsxtrtitletext</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5731">224</a>, <span class="summarylocfmt"><a href="#wrglossary.21845">882</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:Glsfmttext"><code class="csfmt">\Glsfmttext</code></a> &amp; <a href="#glo:Glsxtrheadtext"><code class="csfmt">\Glsxtrheadtext</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrtitletext"><code class="csfmt">\glsxtrtitletext</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5725">224</a>, <span class="summarylocfmt"><a href="#wrglossary.21849">882</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsfmttext"><code class="csfmt">\glsfmttext</code></a> &amp; <a href="#glo:glsxtrheadtext"><code class="csfmt">\glsxtrheadtext</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrTotalRecordCount"><code class="csfmt">\GlsXtrTotalRecordCount</code></a><span class="qquad"></span><a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12754">523</a>, <span class="summarylocfmt"><a href="#wrglossary.21852">882</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrtreechildpredesc"><code class="csfmt">\glsxtrtreechildpredesc</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.21855">882</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrtreepredesc"><code class="csfmt">\glsxtrtreepredesc</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.21858">883</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrundefaction"><code class="csfmt">\glsxtrundefaction</code></a><span class="qquad"></span><a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.362">16</a>, <span class="summarylocfmt"><a href="#wrglossary.21861">883</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrundeftag"><code class="csfmt">\glsxtrundeftag</code></a><span class="qquad"></span><a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.356">15</a>, <span class="summarylocfmt"><a href="#wrglossary.21865">883</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrUnknownDialectWarning"><code class="csfmt">\GlsXtrUnknownDialectWarning</code></a><span class="qquad"></span><a href="#sec:foreignfield">§5.12.1</a>; <a href="#wrglossary.7663">294</a>, <span class="summarylocfmt"><a href="#wrglossary.21868">883</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrUnsetBufferDisableRepeatLocal"><code class="csfmt">\GlsXtrUnsetBufferDisableRepeatLocal</code></a><span class="qquad"></span><a href="#sec:unsetbuffer">§5.10.1</a>; <a href="#wrglossary.7482">286</a>, <span class="summarylocfmt"><a href="#wrglossary.21871">883</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrUnsetBufferEnableRepeatLocal"><code class="csfmt">\GlsXtrUnsetBufferEnableRepeatLocal</code></a><span class="qquad"></span><a href="#sec:unsetbuffer">§5.10.1</a>; <a href="#wrglossary.4766">189</a>, <a href="#wrglossary.7476">285</a>, <a href="#wrglossary.7516">287</a>, <a href="#wrglossary.21296">860</a>, <span class="summarylocfmt"><a href="#wrglossary.21873">883</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GlsXtrResetLocalBuffer"><code class="csfmt">\GlsXtrResetLocalBuffer</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrunsrtdo"><code class="csfmt">\glsxtrunsrtdo</code></a><span class="qquad"></span><a href="#sec:printunsrtadvanced">§8.4.3</a>; <a href="#wrglossary.10268">402</a>, <a href="#wrglossary.10446">408</a>, <span class="summarylocfmt"><a href="#wrglossary.21876">883</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrunusedformat"><code class="csfmt">\glsxtrunusedformat</code></a><span class="qquad"></span><a href="#sec:glssee">§5.9.3</a>; <a href="#wrglossary.541">20</a>, <a href="#wrglossary.7329">279</a>, <span class="summarylocfmt"><a href="#wrglossary.21884">884</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpAlpha"><code class="csfmt">\glsxtrUpAlpha</code></a><span class="qquad"></span><a href="#wrglossary.13410">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21887">884</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpBeta"><code class="csfmt">\glsxtrUpBeta</code></a><span class="qquad"></span><a href="#wrglossary.13412">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21889">884</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpChi"><code class="csfmt">\glsxtrUpChi</code></a><span class="qquad"></span><a href="#wrglossary.13454">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21891">884</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpDelta"><code class="csfmt">\glsxtrUpDelta</code></a><span class="qquad"></span><a href="#wrglossary.13416">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21893">884</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpDigamma"><code class="csfmt">\glsxtrUpDigamma</code></a><span class="qquad"></span><a href="#wrglossary.13420">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21895">884</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpEpsilon"><code class="csfmt">\glsxtrUpEpsilon</code></a><span class="qquad"></span><a href="#wrglossary.13418">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21897">884</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpEta"><code class="csfmt">\glsxtrUpEta</code></a><span class="qquad"></span><a href="#wrglossary.13424">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21899">884</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpGamma"><code class="csfmt">\glsxtrUpGamma</code></a><span class="qquad"></span><a href="#wrglossary.13414">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21901">885</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpIota"><code class="csfmt">\glsxtrUpIota</code></a><span class="qquad"></span><a href="#wrglossary.13428">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21903">885</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpKappa"><code class="csfmt">\glsxtrUpKappa</code></a><span class="qquad"></span><a href="#wrglossary.13430">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21905">885</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpLambda"><code class="csfmt">\glsxtrUpLambda</code></a><span class="qquad"></span><a href="#wrglossary.13432">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21907">885</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpMu"><code class="csfmt">\glsxtrUpMu</code></a><span class="qquad"></span><a href="#wrglossary.13434">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21909">885</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpNu"><code class="csfmt">\glsxtrUpNu</code></a><span class="qquad"></span><a href="#wrglossary.13436">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21911">885</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpOmega"><code class="csfmt">\glsxtrUpOmega</code></a><span class="qquad"></span><a href="#wrglossary.13458">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21913">885</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpOmicron"><code class="csfmt">\glsxtrUpOmicron</code></a><span class="qquad"></span><a href="#wrglossary.13440">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21915">885</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpPhi"><code class="csfmt">\glsxtrUpPhi</code></a><span class="qquad"></span><a href="#wrglossary.13452">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21917">886</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpPi"><code class="csfmt">\glsxtrUpPi</code></a><span class="qquad"></span><a href="#wrglossary.13442">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21919">886</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpPsi"><code class="csfmt">\glsxtrUpPsi</code></a><span class="qquad"></span><a href="#wrglossary.13456">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21921">886</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpRho"><code class="csfmt">\glsxtrUpRho</code></a><span class="qquad"></span><a href="#wrglossary.13444">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21923">886</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpSigma"><code class="csfmt">\glsxtrUpSigma</code></a><span class="qquad"></span><a href="#wrglossary.13446">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21925">886</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpTau"><code class="csfmt">\glsxtrUpTau</code></a><span class="qquad"></span><a href="#wrglossary.13448">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21927">886</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpTheta"><code class="csfmt">\glsxtrUpTheta</code></a><span class="qquad"></span><a href="#wrglossary.13426">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21929">886</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpUpsilon"><code class="csfmt">\glsxtrUpUpsilon</code></a><span class="qquad"></span><a href="#wrglossary.13450">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21931">886</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpXi"><code class="csfmt">\glsxtrUpXi</code></a><span class="qquad"></span><a href="#wrglossary.13438">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21933">887</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrUpZeta"><code class="csfmt">\glsxtrUpZeta</code></a><span class="qquad"></span><a href="#wrglossary.13422">553</a>, <span class="summarylocfmt"><a href="#wrglossary.21935">887</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrUseAbbrStyleFmts"><code class="csfmt">\GlsXtrUseAbbrStyleFmts</code></a><span class="qquad"></span><a href="#sec:advancedabbrstylecmds">§4.5.2</a>; <a href="#wrglossary.3970">160</a>, <span class="summarylocfmt"><a href="#wrglossary.21937">887</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrUseAbbrStyleSetup"><code class="csfmt">\GlsXtrUseAbbrStyleSetup</code></a><span class="qquad"></span><a href="#sec:advancedabbrstylecmds">§4.5.2</a>; <a href="#wrglossary.3968">159</a>, <span class="summarylocfmt"><a href="#wrglossary.21938">887</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrusealias"><code class="csfmt">\glsxtrusealias</code></a><span class="qquad"></span><a href="#sec:getsee">§5.9.2</a>; <a href="#wrglossary.7260">277</a>, <span class="summarylocfmt"><a href="#wrglossary.21939">887</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtrusesee"><code class="csfmt">\glsxtrusesee</code></a>, <a href="#glo:glsxtruseseealso"><code class="csfmt">\glsxtruseseealso</code></a> &amp; <a href="#glo:glsxtrseelists"><code class="csfmt">\glsxtrseelists</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrusefield"><code class="csfmt">\GLSxtrusefield</code></a><span class="qquad"></span><a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.5133">200</a>, <a href="#wrglossary.7596">291</a>, <span class="summarylocfmt"><a href="#wrglossary.21943">887</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrusefield"><code class="csfmt">\Glsxtrusefield</code></a><span class="qquad"></span><a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.7587">291</a>, <a href="#wrglossary.10625">417</a>, <span class="summarylocfmt"><a href="#wrglossary.21947">887</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrusefield"><code class="csfmt">\glsxtrusefield</code></a><span class="qquad"></span><a href="#sec:getfields">§5.11</a>; <a href="#wrglossary.1157">38</a>, <a href="#wrglossary.7582">291</a>, <a href="#wrglossary.10631">418</a>, <a href="#wrglossary.19882">802</a>, <span class="summarylocfmt"><a href="#wrglossary.21951">887</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtruserfield"><code class="csfmt">\glsxtruserfield</code></a><span class="qquad"></span><a href="#wrglossary.1824">63</a>, <a href="#wrglossary.2382">88</a>, <a href="#wrglossary.2650">99</a>, <a href="#wrglossary.3339">135</a>, <a href="#wrglossary.3387">137</a>, <a href="#wrglossary.3405">138</a>, <a href="#wrglossary.15203">635</a>, <a href="#wrglossary.15331">640</a>, <a href="#wrglossary.15373">641</a>, <span class="summarylocfmt"><a href="#wrglossary.21956">888</a></span>, <a href="#wrglossary.22006">890</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtruserfieldfmt"><code class="csfmt">\glsxtruserfieldfmt</code></a><span class="qquad"></span><a href="#wrglossary.3344">135</a>, <a href="#wrglossary.3402">138</a>, <span class="summarylocfmt"><a href="#wrglossary.21960">888</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtruserlongformat"><code class="csfmt">\GLSxtruserlongformat</code></a><span class="qquad"></span><a href="#wrglossary.3548">143</a>, <span class="summarylocfmt"><a href="#wrglossary.21965">888</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtruserlongformat"><code class="csfmt">\glsxtruserlongformat</code></a><span class="qquad"></span><a href="#wrglossary.3538">143</a>, <span class="summarylocfmt"><a href="#wrglossary.21969">888</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtruserlongplformat"><code class="csfmt">\GLSxtruserlongplformat</code></a><span class="qquad"></span><a href="#wrglossary.3561">144</a>, <span class="summarylocfmt"><a href="#wrglossary.21973">888</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtruserlongplformat"><code class="csfmt">\glsxtruserlongplformat</code></a><span class="qquad"></span><a href="#wrglossary.3553">143</a>, <a href="#wrglossary.3562">144</a>, <span class="summarylocfmt"><a href="#wrglossary.21977">888</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtruserlongshortformat"><code class="csfmt">\GLSxtruserlongshortformat</code></a><span class="qquad"></span><a href="#wrglossary.3452">139</a>, <span class="summarylocfmt"><a href="#wrglossary.21981">889</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtruserlongshortformat"><code class="csfmt">\Glsxtruserlongshortformat</code></a><span class="qquad"></span><a href="#wrglossary.3450">139</a>, <span class="summarylocfmt"><a href="#wrglossary.21985">889</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtruserlongshortformat"><code class="csfmt">\glsxtruserlongshortformat</code></a><span class="qquad"></span><a href="#wrglossary.3442">139</a>, <span class="summarylocfmt"><a href="#wrglossary.21989">889</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtruserlongshortplformat"><code class="csfmt">\GLSxtruserlongshortplformat</code></a><span class="qquad"></span><a href="#wrglossary.3464">140</a>, <span class="summarylocfmt"><a href="#wrglossary.21992">889</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtruserlongshortplformat"><code class="csfmt">\Glsxtruserlongshortplformat</code></a><span class="qquad"></span><a href="#wrglossary.3462">140</a>, <span class="summarylocfmt"><a href="#wrglossary.21996">889</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtruserlongshortplformat"><code class="csfmt">\glsxtruserlongshortplformat</code></a><span class="qquad"></span><a href="#wrglossary.3454">140</a>, <span class="summarylocfmt"><a href="#wrglossary.22000">889</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtruserparen"><code class="csfmt">\GLSxtruserparen</code></a><span class="qquad"></span><a href="#wrglossary.3347">135</a>, <a href="#wrglossary.3404">138</a>, <a href="#wrglossary.3513">142</a>–<a href="#wrglossary.3564">144</a>, <a href="#wrglossary.21964">888</a>, <span class="summarylocfmt"><a href="#wrglossary.22003">889</a></span>, <a href="#wrglossary.22019">890</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtruserparen"><code class="csfmt">\glsxtruserparen</code></a><span class="qquad"></span><a href="#wrglossary.3346">135</a>, <a href="#wrglossary.3394">137</a>, <a href="#wrglossary.3408">138</a>, <a href="#wrglossary.3491">141</a>–<a href="#wrglossary.3565">144</a>, <a href="#wrglossary.21231">857</a>, <a href="#wrglossary.21963">888</a>, <span class="summarylocfmt"><a href="#wrglossary.22009">890</a></span>, <a href="#wrglossary.22056">891</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GLSxtruserparen"><code class="csfmt">\GLSxtruserparen</code></a>, <a href="#glo:glsxtruserparensep"><code class="csfmt">\glsxtruserparensep</code></a> &amp; <a href="#glo:glsxtruserfieldfmt"><code class="csfmt">\glsxtruserfieldfmt</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtruserparensep"><code class="csfmt">\glsxtruserparensep</code></a><span class="qquad"></span><a href="#wrglossary.3343">135</a>, <a href="#wrglossary.3401">137</a>, <span class="summarylocfmt"><a href="#wrglossary.22016">890</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrusershortformat"><code class="csfmt">\GLSxtrusershortformat</code></a><span class="qquad"></span><a href="#wrglossary.3508">142</a>, <span class="summarylocfmt"><a href="#wrglossary.22020">890</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrusershortformat"><code class="csfmt">\glsxtrusershortformat</code></a><span class="qquad"></span><a href="#wrglossary.3490">141</a>, <a href="#wrglossary.3502">142</a>, <span class="summarylocfmt"><a href="#wrglossary.22024">890</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrusershortlongformat"><code class="csfmt">\GLSxtrusershortlongformat</code></a><span class="qquad"></span><a href="#wrglossary.3476">141</a>, <span class="summarylocfmt"><a href="#wrglossary.22028">890</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrusershortlongformat"><code class="csfmt">\Glsxtrusershortlongformat</code></a><span class="qquad"></span><a href="#wrglossary.3474">141</a>, <span class="summarylocfmt"><a href="#wrglossary.22032">890</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrusershortlongformat"><code class="csfmt">\glsxtrusershortlongformat</code></a><span class="qquad"></span><a href="#wrglossary.3466">140</a>, <a href="#wrglossary.22030">890</a>, <span class="summarylocfmt"><a href="#wrglossary.22036">891</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrusershortlongplformat"><code class="csfmt">\GLSxtrusershortlongplformat</code></a><span class="qquad"></span><a href="#wrglossary.3488">141</a>, <span class="summarylocfmt"><a href="#wrglossary.22039">891</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Glsxtrusershortlongplformat"><code class="csfmt">\Glsxtrusershortlongplformat</code></a><span class="qquad"></span><a href="#wrglossary.3486">141</a>, <span class="summarylocfmt"><a href="#wrglossary.22043">891</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrusershortlongplformat"><code class="csfmt">\glsxtrusershortlongplformat</code></a><span class="qquad"></span><a href="#wrglossary.3478">141</a>, <span class="summarylocfmt"><a href="#wrglossary.22047">891</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GLSxtrusershortplformat"><code class="csfmt">\GLSxtrusershortplformat</code></a><span class="qquad"></span><a href="#wrglossary.3515">142</a>, <span class="summarylocfmt"><a href="#wrglossary.22050">891</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrusershortplformat"><code class="csfmt">\glsxtrusershortplformat</code></a><span class="qquad"></span><a href="#wrglossary.3501">142</a>, <span class="summarylocfmt"><a href="#wrglossary.22054">891</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrusersuffix"><code class="csfmt">\glsxtrusersuffix</code></a><span class="qquad"></span><a href="#wrglossary.2386">88</a>, <a href="#wrglossary.2654">100</a>, <a href="#wrglossary.3359">136</a>, <span class="summarylocfmt"><a href="#wrglossary.22058">892</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrusesee"><code class="csfmt">\glsxtrusesee</code></a><span class="qquad"></span><a href="#sec:getsee">§5.9.2</a>; <a href="#wrglossary.623">22</a>, <a href="#wrglossary.7255">277</a>, <span class="summarylocfmt"><a href="#wrglossary.22061">892</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtrusealias"><code class="csfmt">\glsxtrusealias</code></a>, <a href="#glo:glsxtruseseealso"><code class="csfmt">\glsxtruseseealso</code></a> &amp; <a href="#glo:glsxtrseelists"><code class="csfmt">\glsxtrseelists</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtruseseealso"><code class="csfmt">\glsxtruseseealso</code></a><span class="qquad"></span><a href="#sec:getsee">§5.9.2</a>; <a href="#wrglossary.624">22</a>, <a href="#wrglossary.7263">277</a>, <span class="summarylocfmt"><a href="#wrglossary.22065">892</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtrusesee"><code class="csfmt">\glsxtrusesee</code></a>, <a href="#glo:glsxtrusealias"><code class="csfmt">\glsxtrusealias</code></a> &amp; <a href="#glo:glsxtrseelists"><code class="csfmt">\glsxtrseelists</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtruseseealsoformat"><code class="csfmt">\glsxtruseseealsoformat</code></a><span class="qquad"></span><a href="#sec:getsee">§5.9.2</a>; <a href="#wrglossary.956">33</a>, <a href="#wrglossary.7016">267</a>, <a href="#wrglossary.7247">276</a>–<a href="#wrglossary.7276">278</a>, <a href="#wrglossary.21389">863</a>, <span class="summarylocfmt"><a href="#wrglossary.22069">892</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtruseseeformat"><code class="csfmt">\glsxtruseseeformat</code></a><span class="qquad"></span><a href="#wrglossary.7244">276</a>, <a href="#wrglossary.7257">277</a>, <a href="#wrglossary.21386">863</a>, <a href="#wrglossary.21942">887</a>, <span class="summarylocfmt"><a href="#wrglossary.22071">892</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrWarnDeprecatedAbbrStyle"><code class="csfmt">\GlsXtrWarnDeprecatedAbbrStyle</code></a><span class="qquad"></span><a href="#sec:advancedabbrstylecmds">§4.5.2</a>; <a href="#wrglossary.3984">160</a>, <span class="summarylocfmt"><a href="#wrglossary.22075">892</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:GlsXtrWarning"><code class="csfmt">\GlsXtrWarning</code></a><span class="qquad"></span><a href="#sec:onthefly">§13</a>; <a href="#wrglossary.14114">579</a>, <span class="summarylocfmt"><a href="#wrglossary.22078">892</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrword"><code class="csfmt">\glsxtrword</code></a><span class="qquad"></span><a href="#sec:abbrattr">§10.2.1.1</a>; <a href="#wrglossary.4395">174</a>, <a href="#wrglossary.12107">496</a>, <a href="#wrglossary.12126">497</a>, <span class="summarylocfmt"><a href="#wrglossary.22080">893</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrwordsep"><code class="csfmt">\glsxtrwordsep</code></a><span class="qquad"></span><a href="#sec:abbrattr">§10.2.1.1</a>; <a href="#wrglossary.3690">149</a>, <a href="#wrglossary.3753">151</a>, <a href="#wrglossary.4396">174</a>, <a href="#wrglossary.12106">496</a>, <a href="#wrglossary.12127">497</a>, <span class="summarylocfmt"><a href="#wrglossary.22084">893</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrwordsephyphen"><code class="csfmt">\glsxtrwordsephyphen</code></a><span class="qquad"></span><a href="#wrglossary.3691">149</a>, <a href="#wrglossary.3754">151</a>, <span class="summarylocfmt"><a href="#wrglossary.22088">893</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrwrglossaryhook"><code class="csfmt">\glsxtrwrglossaryhook</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.22092">893</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrwrglossarylocfmt"><code class="csfmt">\glsxtrwrglossarylocfmt</code></a><span class="qquad"></span><a href="#sec:recordnameref">§11.5.6</a>; <a href="#wrglossary.881">29</a>, <a href="#wrglossary.13619">559</a>, <span class="summarylocfmt"><a href="#wrglossary.22093">893</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrwrglosscountermark"><code class="csfmt">\glsxtrwrglosscountermark</code></a><span class="qquad"></span><a href="#sec:debuggingopts">§2.5</a>; <a href="#wrglossary.880">29</a>, <span class="summarylocfmt"><a href="#wrglossary.22098">893</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:glsxtrwrglossmark"><code class="csfmt">\glsxtrwrglossmark</code></a><span class="qquad"></span><a href="#sec:debuggingopts">§2.5</a>; <a href="#wrglossary.877">29</a>, <span class="summarylocfmt"><a href="#wrglossary.22103">893</a></span></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index7143424 -->
+
+<section id="index7208960"><!-- start of section index7208960 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->H<div class="labellink"><a href="#index7208960">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><dfn id="glo:hfil"><code class="csfmt">\hfil</code></dfn><span class="qquad"></span><a href="#wrglossary.10874">427</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:hierarchicallevel">hierarchical level</dfn><span class="qquad"></span><a href="#wrglossary.6735">261</a>, <a href="#wrglossary.9557">379</a>, <a href="#wrglossary.9678">384</a>, <a href="#wrglossary.9737">386</a>, <a href="#wrglossary.9806">388</a>, <a href="#wrglossary.9973">392</a>, <a href="#wrglossary.9981">393</a>, <a href="#wrglossary.10178">398</a>, <a href="#wrglossary.10232">400</a>, <a href="#wrglossary.10270">402</a>, <a href="#wrglossary.10387">406</a>, <a href="#wrglossary.11018">435</a>, <a href="#wrglossary.11073">438</a>, <a href="#wrglossary.11196">444</a>, <a href="#wrglossary.11571">468</a>, <a href="#wrglossary.11653">472</a>, <a href="#wrglossary.12959">530</a>, <a href="#wrglossary.13469">553</a>, <span class="termslocfmt"><a href="#wrglossary.14362">600</a></span>, <a href="#wrglossary.14640">608</a>, <a href="#wrglossary.14976">625</a>, <a href="#wrglossary.17176">700</a>, <a href="#wrglossary.17656">715</a>, <a href="#wrglossary.17683">716</a>, <a href="#wrglossary.17976">727</a>, <a href="#wrglossary.18820">760</a>, <a href="#wrglossary.19158">774</a>, <a href="#wrglossary.21881">883</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:hl"><code class="csfmt">\hl</code></dfn><span class="qquad"></span><a href="#wrglossary.6173">241</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:hsize"><code class="csfmt">\hsize</code></dfn><span class="qquad"></span><a href="#wrglossary.10937">429</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:hyperbf"><code class="csfmt">\hyperbf</code></a><span class="qquad"></span><a href="#wrglossary.13643">560</a>, <span class="summarylocfmt"><a href="#wrglossary.22107">894</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:hyperlink"><code class="csfmt">\hyperlink</code></dfn><span class="qquad"></span><a href="#wrglossary.8147">317</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:hyperref"><code class="csfmt">\hyperref</code></dfn><span class="qquad"></span><a href="#wrglossary.13966">573</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.hyperref"><span class="styfmt">hyperref</span> package</dfn><span class="qquad"></span><a href="#wrglossary.723">25</a>, <a href="#wrglossary.819">27</a>, <a href="#wrglossary.1099">36</a>, <a href="#wrglossary.1814">63</a>, <a href="#wrglossary.4944">194</a>, <a href="#wrglossary.4974">196</a>, <a href="#wrglossary.5027">197</a>, <a href="#wrglossary.5152">201</a>, <a href="#wrglossary.5250">205</a>, <a href="#wrglossary.5523">216</a>, <a href="#wrglossary.5917">230</a>, <a href="#wrglossary.6126">239</a>, <a href="#wrglossary.6560">256</a>, <a href="#wrglossary.7592">291</a>, <a href="#wrglossary.7617">292</a>, <a href="#wrglossary.7702">296</a>, <a href="#wrglossary.8092">313</a>, <a href="#wrglossary.10541">413</a>, <a href="#wrglossary.10609">417</a>, <a href="#wrglossary.12427">510</a>, <a href="#wrglossary.12728">522</a>, <a href="#wrglossary.12928">529</a>, <a href="#wrglossary.13550">555</a>, <a href="#wrglossary.13581">556</a>, <a href="#wrglossary.14068">576</a>, <a href="#wrglossary.14201">586</a>, <a href="#wrglossary.14247">591</a>, <a href="#wrglossary.19827">800</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:hypertarget"><code class="csfmt">\hypertarget</code></dfn></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index7208960 -->
+
+<section id="index7274496"><!-- start of section index7274496 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->I<div class="labellink"><a href="#index7274496">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><dfn id="glo:ifcsstring"><code class="csfmt">\ifcsstring</code></dfn><span class="qquad"></span><a href="#wrglossary.22129">895</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:ifcsundef"><code class="csfmt">\ifcsundef</code></dfn><span class="qquad"></span><a href="#wrglossary.7889">305</a>, <a href="#wrglossary.20341">819</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:ifcsvoid"><code class="csfmt">\ifcsvoid</code></dfn><span class="qquad"></span><a href="#wrglossary.7893">305</a>, <a href="#wrglossary.12340">505</a>, <a href="#wrglossary.13832">567</a>, <a href="#wrglossary.17993">728</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:ifdefempty"><code class="csfmt">\ifdefempty</code></dfn><span class="qquad"></span><a href="#wrglossary.7902">305</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:ifdefstring"><code class="csfmt">\ifdefstring</code></dfn><span class="qquad"></span><a href="#wrglossary.20326">819</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifglossaryexists"><code class="csfmt">\ifglossaryexists</code></a><span class="qquad"></span><a href="#wrglossary.16382">671</a>, <span class="summarylocfmt"><a href="#wrglossary.22110">894</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:doifglossarynoexistsordo"><code class="csfmt">\doifglossarynoexistsordo</code></a> &amp; <a href="#glo:glsxtrifemptyglossary"><code class="csfmt">\glsxtrifemptyglossary</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifglsentryexists"><code class="csfmt">\ifglsentryexists</code></a><span class="qquad"></span><a href="#wrglossary.17302">703</a>, <span class="summarylocfmt"><a href="#wrglossary.22114">894</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsdoifexistsordo"><code class="csfmt">\glsdoifexistsordo</code></a>, <a href="#glo:glsdoifexists"><code class="csfmt">\glsdoifexists</code></a> &amp; <a href="#glo:glsdoifnoexists"><code class="csfmt">\glsdoifnoexists</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifglsfieldcseq"><code class="csfmt">\ifglsfieldcseq</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.22116">894</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifglsfielddefeq"><code class="csfmt">\ifglsfielddefeq</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.22121">894</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifglsfieldeq"><code class="csfmt">\ifglsfieldeq</code></a><span class="qquad"></span><a href="#wrglossary.18022">729</a>, <span class="summarylocfmt"><a href="#wrglossary.22126">895</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifglsfieldvoid"><code class="csfmt">\ifglsfieldvoid</code></a><span class="qquad"></span><a href="#wrglossary.7891">305</a>, <span class="summarylocfmt"><a href="#wrglossary.22132">895</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GlsXtrIfFieldUndef"><code class="csfmt">\GlsXtrIfFieldUndef</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifglshaschildren"><code class="csfmt">\ifglshaschildren</code></a><span class="qquad"></span><a href="#wrglossary.13494">554</a>, <span class="summarylocfmt"><a href="#wrglossary.22135">895</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GlsXtrIfHasNonZeroChildCount"><code class="csfmt">\GlsXtrIfHasNonZeroChildCount</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifglshasdesc"><code class="csfmt">\ifglshasdesc</code></a><span class="qquad"></span><a href="#wrglossary.11542">466</a>, <span class="summarylocfmt"><a href="#wrglossary.22141">895</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifglshasdescsuppressed"><code class="csfmt">\ifglshasdescsuppressed</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.22144">895</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifglshasfield"><code class="csfmt">\ifglshasfield</code></a><span class="qquad"></span><a href="#wrglossary.7897">305</a>, <a href="#wrglossary.17180">700</a>, <a href="#wrglossary.20356">820</a>, <span class="summarylocfmt"><a href="#wrglossary.22148">895</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtrifhasfield"><code class="csfmt">\glsxtrifhasfield</code></a> &amp; <a href="#glo:ifglsfieldvoid"><code class="csfmt">\ifglsfieldvoid</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.22152">896</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifglshasparent"><code class="csfmt">\ifglshasparent</code></a><span class="qquad"></span><a href="#wrglossary.7609">292</a>, <a href="#wrglossary.13491">554</a>, <span class="summarylocfmt"><a href="#wrglossary.22155">896</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifglshasshort"><code class="csfmt">\ifglshasshort</code></a><span class="qquad"></span><a href="#wrglossary.6535">255</a>, <span class="summarylocfmt"><a href="#wrglossary.22158">896</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifglshassymbol"><code class="csfmt">\ifglshassymbol</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.22161">896</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifglsindexonlyfirst"><code class="csfmt">\ifglsindexonlyfirst</code></a><span class="qquad"></span><a href="#sec:wrglossary">§5.8</a>; <a href="#wrglossary.6933">265</a>, <span class="summarylocfmt"><a href="#wrglossary.22164">896</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifGlsLongExtraUseTabular"><code class="csfmt">\ifGlsLongExtraUseTabular</code></a><span class="qquad"></span><a href="#sec:longextra">§8.7.2</a>; <a href="#wrglossary.11206">445</a>, <a href="#wrglossary.18486">748</a>, <span class="summarylocfmt"><a href="#wrglossary.22167">896</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifglsnogroupskip"><code class="csfmt">\ifglsnogroupskip</code></a><span class="qquad"></span><a href="#wrglossary.10901">428</a>, <span class="summarylocfmt"><a href="#wrglossary.22171">896</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifglsresetcurrcount"><code class="csfmt">\ifglsresetcurrcount</code></a><span class="qquad"></span><a href="#sec:entrycount">§6.1</a>; <a href="#wrglossary.7952">308</a>, <a href="#wrglossary.18740">756</a>, <a href="#wrglossary.18743">757</a>, <span class="summarylocfmt"><a href="#wrglossary.22174">897</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a><span class="qquad"></span><a href="#wrglossary.357">15</a>, <a href="#wrglossary.6285">246</a>, <a href="#wrglossary.6937">265</a>, <a href="#wrglossary.7363">281</a>–<a href="#wrglossary.7441">283</a>, <a href="#wrglossary.20432">823</a>, <span class="summarylocfmt"><a href="#wrglossary.22177">897</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:GlsXtrIfUnusedOrUndefined"><code class="csfmt">\GlsXtrIfUnusedOrUndefined</code></a> &amp; <a href="#glo:glsxtrifwasfirstuse"><code class="csfmt">\glsxtrifwasfirstuse</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifglsxtrinitwrglossbefore"><code class="csfmt">\ifglsxtrinitwrglossbefore</code></a><span class="qquad"></span><a href="#sec:xtrglsopts">§5.1.2</a>; <a href="#wrglossary.4933">194</a>, <span class="summarylocfmt"><a href="#wrglossary.22182">897</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifglsxtrinsertinside"><code class="csfmt">\ifglsxtrinsertinside</code></a><span class="qquad"></span><a href="#wrglossary.3254">131</a>, <a href="#wrglossary.4401">174</a>, <a href="#wrglossary.4451">176</a>, <a href="#wrglossary.4486">177</a>, <a href="#wrglossary.20511">826</a>, <a href="#wrglossary.20649">832</a>, <a href="#wrglossary.21520">868</a>, <span class="summarylocfmt"><a href="#wrglossary.22185">897</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifGlsXtrPrefixLabelFallbackLast"><code class="csfmt">\ifGlsXtrPrefixLabelFallbackLast</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13743">563</a>, <a href="#wrglossary.21239">857</a>, <span class="summarylocfmt"><a href="#wrglossary.22187">897</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifglsxtrprintglossflatten"><code class="csfmt">\ifglsxtrprintglossflatten</code></a><span class="qquad"></span><a href="#sec:printunsrtadvanced">§8.4.3</a>; <a href="#wrglossary.10273">402</a>, <span class="summarylocfmt"><a href="#wrglossary.22189">897</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:ifinlistcs"><code class="csfmt">\ifinlistcs</code></dfn><span class="qquad"></span><a href="#wrglossary.7879">305</a>, <a href="#wrglossary.19864">801</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifmglsused"><code class="csfmt">\ifmglsused</code></a><span class="qquad"></span><a href="#sec:mglsfirstuse">§7.7</a>; <a href="#wrglossary.8845">352</a>, <span class="summarylocfmt"><a href="#wrglossary.22192">898</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ifmultiglossaryentryglobal"><code class="csfmt">\ifmultiglossaryentryglobal</code></a><span class="qquad"></span><a href="#sec:multientries">§7</a>; <a href="#wrglossary.8282">325</a>, <span class="summarylocfmt"><a href="#wrglossary.22194">898</a></span>, <a href="#wrglossary.22718">916</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:IfTeXParserLib"><code class="csfmt">\IfTeXParserLib</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13939">572</a>, <span class="summarylocfmt"><a href="#wrglossary.22196">898</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:IfTrackedLanguageFileExists"><code class="csfmt">\IfTrackedLanguageFileExists</code></dfn><span class="qquad"></span><a href="#wrglossary.13163">538</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:ifundef"><code class="csfmt">\ifundef</code></dfn><span class="qquad"></span><a href="#wrglossary.7901">305</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:ignoredglossary">ignored glossary</dfn><span class="qquad"></span><a href="#wrglossary.6564">256</a>, <a href="#wrglossary.6662">259</a>, <a href="#wrglossary.9416">375</a>, <a href="#wrglossary.9447">376</a>, <a href="#wrglossary.9652">382</a>, <a href="#wrglossary.9669">383</a>, <a href="#wrglossary.10349">405</a>, <a href="#wrglossary.11025">435</a>, <a href="#wrglossary.12060">493</a>, <a href="#wrglossary.12798">525</a>, <span class="termslocfmt"><a href="#wrglossary.14366">601</a></span>, <a href="#wrglossary.16426">673</a>, <a href="#wrglossary.17664">715</a>, <a href="#wrglossary.17960">726</a>, <a href="#wrglossary.17965">727</a>, <a href="#wrglossary.18191">736</a>, <a href="#wrglossary.20311">818</a>, <a href="#wrglossary.20379">820</a>, <a href="#wrglossary.22113">894</a>, <a href="#wrglossary.22245">900</a>, <a href="#wrglossary.22797">918</a>, <a href="#wrglossary.23108">926</a>, <a href="#wrglossary.23165">927</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:ignoredlocation">ignored location (or record)</dfn><span class="qquad"></span><a href="#wrglossary.6774">261</a>, <a href="#wrglossary.12545">513</a>, <a href="#wrglossary.12736">522</a>, <a href="#wrglossary.12791">524</a>, <span class="termslocfmt"><a href="#wrglossary.14375">601</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:index"><code class="csfmt">\index</code></dfn><span class="qquad"></span><a href="#wrglossary.6730">261</a>, <a href="#wrglossary.12244">501</a>, <a href="#wrglossary.12268">502</a>, <a href="#wrglossary.14012">574</a>–<a href="#wrglossary.14063">576</a>, <a href="#wrglossary.14088">578</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:indexingapp">indexing application</dfn><span class="qquad"></span><a href="#wrglossary.4956">195</a>, <a href="#wrglossary.6732">261</a>, <a href="#wrglossary.6804">262</a>, <a href="#wrglossary.8051">311</a>, <a href="#wrglossary.10823">425</a>, <a href="#wrglossary.14342">600</a>, <span class="termslocfmt"><a href="#wrglossary.14384">601</a></span>, <a href="#wrglossary.23616">944</a>, <a href="#wrglossary.23712">946</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:indexing">indexing (or recording)</dfn><span class="qquad"></span><a href="#wrglossary.625">22</a>–<a href="#wrglossary.849">28</a>, <a href="#wrglossary.959">33</a>, <a href="#wrglossary.1140">37</a>, <a href="#wrglossary.4618">184</a>, <a href="#wrglossary.4626">185</a>, <a href="#wrglossary.4782">189</a>, <a href="#wrglossary.4817">190</a>, <a href="#wrglossary.4901">193</a>–<a href="#wrglossary.4994">196</a>, <a href="#wrglossary.5263">206</a>, <a href="#wrglossary.5970">233</a>, <a href="#wrglossary.6648">259</a>, <a href="#wrglossary.6729">261</a>, <a href="#wrglossary.6856">263</a>–<a href="#wrglossary.7023">267</a>, <a href="#wrglossary.7097">269</a>, <a href="#wrglossary.7114">270</a>, <a href="#wrglossary.7213">274</a>, <a href="#wrglossary.7228">275</a>, <a href="#wrglossary.7286">278</a>, <a href="#wrglossary.7309">279</a>, <a href="#wrglossary.7571">290</a>, <a href="#wrglossary.7841">302</a>, <a href="#wrglossary.7930">307</a>, <a href="#wrglossary.9430">375</a>, <a href="#wrglossary.9453">376</a>, <a href="#wrglossary.9641">382</a>, <a href="#wrglossary.10390">406</a>–<a href="#wrglossary.10437">408</a>, <a href="#wrglossary.11071">437</a>, <a href="#wrglossary.12371">508</a>, <a href="#wrglossary.12522">513</a>, <a href="#wrglossary.12563">514</a>, <a href="#wrglossary.12722">522</a>, <a href="#wrglossary.12785">524</a>, <a href="#wrglossary.12913">529</a>, <a href="#wrglossary.12947">530</a>, <a href="#wrglossary.13507">554</a>, <a href="#wrglossary.13521">555</a>, <a href="#wrglossary.13587">557</a>, <a href="#wrglossary.13607">558</a>, <a href="#wrglossary.13652">560</a>, <a href="#wrglossary.13746">564</a>, <a href="#wrglossary.13903">570</a>, <span class="termslocfmt"><a href="#wrglossary.14394">601</a></span>, <a href="#wrglossary.14545">605</a>, <a href="#wrglossary.14633">608</a>, <a href="#wrglossary.14704">610</a>–<a href="#wrglossary.14799">615</a>, <a href="#wrglossary.14839">617</a>, <a href="#wrglossary.14873">618</a>, <a href="#wrglossary.14897">620</a>, <a href="#wrglossary.17077">696</a>, <a href="#wrglossary.17324">704</a>, <a href="#wrglossary.18057">731</a>, <a href="#wrglossary.18144">734</a>, <a href="#wrglossary.19362">779</a>, <a href="#wrglossary.19765">797</a>, <a href="#wrglossary.19782">798</a>, <a href="#wrglossary.22776">918</a>, <a href="#wrglossary.23134">927</a>, <a href="#wrglossary.23511">941</a>–<a href="#wrglossary.23603">944</a>, <a href="#wrglossary.23728">947</a>, <a href="#wrglossary.23813">949</a>, <a href="#wrglossary.23873">950</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:indexname"><code class="csfmt">\indexname</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.22200">898</a></span>, <a href="#wrglossary.23724">947</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:indexspace"><code class="csfmt">\indexspace</code></dfn><span class="qquad"></span><a href="#wrglossary.10940">430</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:inlinefullform">inline full form</dfn><span class="qquad"></span><a href="#wrglossary.1474">50</a>, <a href="#wrglossary.1491">51</a>, <a href="#wrglossary.1568">53</a>, <a href="#wrglossary.1585">54</a>, <a href="#wrglossary.1816">63</a>, <a href="#wrglossary.1864">65</a>, <a href="#wrglossary.1907">67</a>, <a href="#wrglossary.2060">73</a>, <a href="#wrglossary.2081">74</a>, <a href="#wrglossary.2229">81</a>, <a href="#wrglossary.2384">88</a>, <a href="#wrglossary.2497">93</a>, <a href="#wrglossary.2652">100</a>, <a href="#wrglossary.2698">101</a>, <a href="#wrglossary.2731">103</a>, <a href="#wrglossary.2768">105</a>–<a href="#wrglossary.2818">107</a>, <a href="#wrglossary.2888">109</a>, <a href="#wrglossary.2929">111</a>, <a href="#wrglossary.2995">114</a>, <a href="#wrglossary.3258">132</a>, <a href="#wrglossary.4310">170</a>, <a href="#wrglossary.4425">175</a>, <a href="#wrglossary.6435">252</a>, <a href="#wrglossary.7377">282</a>, <a href="#wrglossary.14315">599</a>, <span class="termslocfmt"><a href="#wrglossary.14417">601</a></span>, <a href="#wrglossary.15237">636</a>, <a href="#wrglossary.15296">639</a>, <a href="#wrglossary.19685">793</a>, <a href="#wrglossary.20054">807</a>, <a href="#wrglossary.20489">825</a>, <a href="#wrglossary.20505">826</a>, <a href="#wrglossary.21331">861</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:innerformatting">inner formatting</dfn><span class="qquad"></span><a href="#wrglossary.3260">132</a>, <a href="#wrglossary.3348">135</a>, <a href="#wrglossary.3400">137</a>, <a href="#wrglossary.3403">138</a>, <a href="#wrglossary.3982">160</a>, <a href="#wrglossary.4062">163</a>, <a href="#wrglossary.4388">174</a>, <a href="#wrglossary.4450">176</a>–<a href="#wrglossary.4501">178</a>, <a href="#wrglossary.6028">235</a>, <a href="#wrglossary.6134">239</a>, <a href="#wrglossary.6179">241</a>, <a href="#wrglossary.6209">243</a>–<a href="#wrglossary.6254">245</a>, <a href="#wrglossary.11904">484</a>, <span class="termslocfmt"><a href="#wrglossary.14423">601</a></span>, <a href="#wrglossary.14830">616</a>, <a href="#wrglossary.16581">679</a>, <a href="#wrglossary.17603">713</a>, <a href="#wrglossary.17856">721</a>, <a href="#wrglossary.18016">729</a>, <a href="#wrglossary.19690">794</a>, <a href="#wrglossary.20069">808</a>, <a href="#wrglossary.20650">832</a>, <a href="#wrglossary.20746">835</a>, <a href="#wrglossary.21521">868</a>, <a href="#wrglossary.21533">869</a>, <a href="#wrglossary.21635">872</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:input"><code class="csfmt">\input</code></dfn><span class="qquad"></span><a href="#wrglossary.12377">508</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.inputenc"><span class="styfmt">inputenc</span> package</dfn><span class="qquad"></span><a href="#wrglossary.14100">578</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:internalfield">internal field</dfn><span class="qquad"></span><a href="#wrglossary.1031">35</a>, <a href="#wrglossary.1127">37</a>, <a href="#wrglossary.6914">264</a>, <a href="#wrglossary.7843">303</a>, <a href="#wrglossary.14327">600</a>, <span class="termslocfmt"><a href="#wrglossary.14427">602</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:bib2glsinternalfield">internal field (<span class="appfmt">bib2gls</span>)</dfn><span class="qquad"></span><a href="#wrglossary.997">34</a>, <span class="termslocfmt"><a href="#wrglossary.14437">602</a></span>, <a href="#wrglossary.14599">607</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:internalfieldlabel">internal field label</dfn><span class="qquad"></span><a href="#wrglossary.1167">38</a>–<a href="#wrglossary.1213">40</a>, <a href="#wrglossary.3340">135</a>, <a href="#wrglossary.5925">231</a>, <a href="#wrglossary.6252">244</a>, <a href="#wrglossary.6256">245</a>, <a href="#wrglossary.7584">291</a>, <a href="#wrglossary.7653">293</a>, <a href="#wrglossary.7688">295</a>, <a href="#wrglossary.7806">301</a>–<a href="#wrglossary.7852">303</a>, <a href="#wrglossary.7885">305</a>, <a href="#wrglossary.9179">366</a>, <a href="#wrglossary.10142">398</a>, <a href="#wrglossary.10580">415</a>, <a href="#wrglossary.10690">419</a>, <a href="#wrglossary.11614">470</a>, <a href="#wrglossary.13804">566</a>, <span class="termslocfmt"><a href="#wrglossary.14441">602</a></span>, <a href="#wrglossary.16516">677</a>, <a href="#wrglossary.17602">713</a>, <a href="#wrglossary.17621">714</a>, <a href="#wrglossary.17855">721</a>, <a href="#wrglossary.18015">729</a>, <a href="#wrglossary.18107">733</a>, <a href="#wrglossary.18810">760</a>, <a href="#wrglossary.19147">773</a>, <a href="#wrglossary.19649">792</a>, <a href="#wrglossary.19788">798</a>, <a href="#wrglossary.19851">801</a>, <a href="#wrglossary.19931">804</a>, <a href="#wrglossary.19953">805</a>, <a href="#wrglossary.20127">811</a>, <a href="#wrglossary.20315">818</a>–<a href="#wrglossary.20355">820</a>, <a href="#wrglossary.20420">822</a>, <a href="#wrglossary.20577">830</a>, <a href="#wrglossary.20596">831</a>, <a href="#wrglossary.21430">865</a>, <a href="#wrglossary.21954">888</a>, <a href="#wrglossary.22119">894</a>, <a href="#wrglossary.22130">895</a>, <a href="#wrglossary.22362">904</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Iota"><code class="csfmt">\Iota</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13976">573</a>, <span class="summarylocfmt"><a href="#wrglossary.22201">898</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:item"><code class="csfmt">\item</code></dfn><span class="qquad"></span><a href="#wrglossary.10921">429</a>, <a href="#wrglossary.12250">501</a>, <a href="#wrglossary.15494">646</a></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index7274496 -->
+
+<section id="index7340032"><!-- start of section index7340032 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->J<div class="labellink"><a href="#index7340032">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><dfn id="glo:jobname"><code class="csfmt">\jobname</code></dfn><span class="qquad"></span><a href="#wrglossary.439">17</a>, <a href="#wrglossary.12439">510</a>, <a href="#wrglossary.12464">511</a>, <a href="#wrglossary.20586">830</a></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index7340032 -->
+
+<section id="index7405568"><!-- start of section index7405568 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->K<div class="labellink"><a href="#index7405568">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><a href="#glo:Kappa"><code class="csfmt">\Kappa</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13977">573</a>, <span class="summarylocfmt"><a href="#wrglossary.22204">898</a></span></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index7405568 -->
+
+<section id="index7471104"><!-- start of section index7471104 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->L<div class="labellink"><a href="#index7471104">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><dfn id="glo:label"><code class="csfmt">\label</code></dfn><span class="qquad"></span><a href="#wrglossary.825">27</a>, <a href="#wrglossary.9540">378</a>, <a href="#wrglossary.14972">624</a>, <a href="#wrglossary.21441">866</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:leavevmode"><code class="csfmt">\leavevmode</code></dfn><span class="qquad"></span><a href="#wrglossary.935">32</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:let"><code class="csfmt">\let</code></dfn><span class="qquad"></span><a href="#wrglossary.5816">227</a>, <a href="#wrglossary.6222">243</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:letabbreviationstyle"><code class="csfmt">\letabbreviationstyle</code></a><span class="qquad"></span><a href="#sec:newabbrvstyle">§4.5.3</a>; <a href="#wrglossary.3990">161</a>, <span class="summarylocfmt"><a href="#wrglossary.22207">898</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:letcs"><code class="csfmt">\letcs</code></dfn><span class="qquad"></span><a href="#wrglossary.11701">475</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:levelchar"><code class="csfmt">\levelchar</code></dfn><span class="qquad"></span><a href="#wrglossary.14080">576</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:linewidth"><code class="csfmt">\linewidth</code></dfn><span class="qquad"></span><a href="#wrglossary.11293">449</a>, <a href="#wrglossary.11406">457</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:linktext">link text</dfn><span class="qquad"></span><a href="#wrglossary.1817">63</a>, <a href="#wrglossary.1844">64</a>, <a href="#wrglossary.2771">105</a>, <a href="#wrglossary.3043">116</a>, <a href="#wrglossary.3757">151</a>, <a href="#wrglossary.4589">183</a>, <a href="#wrglossary.4625">185</a>, <a href="#wrglossary.4663">186</a>, <a href="#wrglossary.4783">189</a>–<a href="#wrglossary.4874">192</a>, <a href="#wrglossary.4923">194</a>, <a href="#wrglossary.4990">196</a>, <a href="#wrglossary.5015">197</a>, <a href="#wrglossary.5904">230</a>, <a href="#wrglossary.5971">233</a>, <a href="#wrglossary.6006">234</a>, <a href="#wrglossary.6062">237</a>, <a href="#wrglossary.6165">241</a>, <a href="#wrglossary.6242">244</a>, <a href="#wrglossary.6468">253</a>, <a href="#wrglossary.6490">254</a>, <a href="#wrglossary.6652">259</a>, <a href="#wrglossary.6899">264</a>, <a href="#wrglossary.7334">279</a>, <a href="#wrglossary.7366">281</a>–<a href="#wrglossary.7448">284</a>, <a href="#wrglossary.7486">286</a>, <a href="#wrglossary.7547">289</a>, <a href="#wrglossary.7692">296</a>, <a href="#wrglossary.8149">317</a>, <a href="#wrglossary.9176">366</a>, <a href="#wrglossary.12094">495</a>, <a href="#wrglossary.12200">499</a>, <a href="#wrglossary.14193">585</a>, <a href="#wrglossary.14337">600</a>, <span class="termslocfmt"><a href="#wrglossary.14443">602</a></span>, <a href="#wrglossary.14477">603</a>–<a href="#wrglossary.14539">605</a>, <a href="#wrglossary.14824">616</a>–<a href="#wrglossary.14859">618</a>, <a href="#wrglossary.16535">677</a>, <a href="#wrglossary.17194">700</a>–<a href="#wrglossary.17281">703</a>, <a href="#wrglossary.17695">717</a>, <a href="#wrglossary.17796">720</a>, <a href="#wrglossary.18114">733</a>, <a href="#wrglossary.18143">734</a>, <a href="#wrglossary.18538">750</a>, <a href="#wrglossary.18546">751</a>, <a href="#wrglossary.18620">753</a>, <a href="#wrglossary.18656">754</a>, <a href="#wrglossary.18879">763</a>, <a href="#wrglossary.18939">765</a>, <a href="#wrglossary.19175">774</a>–<a href="#wrglossary.19315">778</a>, <a href="#wrglossary.19909">803</a>, <a href="#wrglossary.19977">805</a>–<a href="#wrglossary.20024">807</a>, <a href="#wrglossary.20615">831</a>, <a href="#wrglossary.20633">832</a>, <a href="#wrglossary.20702">834</a>, <a href="#wrglossary.21483">867</a>, <a href="#wrglossary.21501">868</a>, <a href="#wrglossary.21591">871</a>, <a href="#wrglossary.21875">883</a>, <a href="#wrglossary.22622">913</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:listcsadd"><code class="csfmt">\listcsadd</code></dfn><span class="qquad"></span><a href="#wrglossary.1177">39</a>, <a href="#wrglossary.19868">801</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:listcseadd"><code class="csfmt">\listcseadd</code></dfn><span class="qquad"></span><a href="#wrglossary.1183">39</a>, <a href="#wrglossary.19872">801</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:listcsgadd"><code class="csfmt">\listcsgadd</code></dfn><span class="qquad"></span><a href="#wrglossary.1181">39</a>, <a href="#wrglossary.19876">802</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:listcsxadd"><code class="csfmt">\listcsxadd</code></dfn><span class="qquad"></span><a href="#wrglossary.1185">39</a>, <a href="#wrglossary.19880">802</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a><span class="qquad"></span><a href="#wrglossary.12378">508</a>, <span class="summarylocfmt"><a href="#wrglossary.22209">899</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:locationcounter">location counter</dfn><span class="qquad"></span><a href="#wrglossary.722">24</a>–<a href="#wrglossary.796">27</a>, <a href="#wrglossary.4943">194</a>, <a href="#wrglossary.6787">261</a>, <a href="#wrglossary.6801">262</a>, <a href="#wrglossary.6906">264</a>, <a href="#wrglossary.9493">377</a>, <a href="#wrglossary.12530">513</a>, <a href="#wrglossary.12757">523</a>, <a href="#wrglossary.12778">524</a>, <a href="#wrglossary.13517">555</a>–<a href="#wrglossary.13593">557</a>, <a href="#wrglossary.14318">599</a>, <span class="termslocfmt"><a href="#wrglossary.14446">602</a></span>, <a href="#wrglossary.14544">605</a>, <a href="#wrglossary.14800">615</a>, <a href="#wrglossary.14817">616</a>, <a href="#wrglossary.14867">618</a>, <a href="#wrglossary.20604">831</a>, <a href="#wrglossary.21279">859</a>, <a href="#wrglossary.22774">918</a>, <a href="#wrglossary.23337">933</a>, <a href="#wrglossary.23572">943</a>, <a href="#wrglossary.23714">947</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:locationencap">location encap (format)</dfn><span class="qquad"></span><a href="#wrglossary.4745">188</a>, <a href="#wrglossary.4962">195</a>, <a href="#wrglossary.8888">355</a>, <a href="#wrglossary.12528">513</a>, <a href="#wrglossary.13520">555</a>, <a href="#wrglossary.14378">601</a>, <span class="termslocfmt"><a href="#wrglossary.14448">602</a></span>, <a href="#wrglossary.14785">614</a>, <a href="#wrglossary.14820">616</a>, <a href="#wrglossary.18009">729</a>, <a href="#wrglossary.18053">731</a>, <a href="#wrglossary.18585">752</a>, <a href="#wrglossary.21885">884</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.locationignored">location, ignored/invisible</dfn><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:ignoredlocation">ignored location (or record)</a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:locationlist">location list</dfn><span class="qquad"></span><a href="#wrglossary.536">20</a>, <a href="#wrglossary.699">24</a>, <a href="#wrglossary.822">27</a>, <a href="#wrglossary.955">33</a>, <a href="#wrglossary.1030">35</a>, <a href="#wrglossary.1109">37</a>, <a href="#wrglossary.4917">194</a>, <a href="#wrglossary.4948">195</a>, <a href="#wrglossary.5146">201</a>, <a href="#wrglossary.6661">259</a>, <a href="#wrglossary.6738">261</a>–<a href="#wrglossary.6855">263</a>, <a href="#wrglossary.6950">265</a>–<a href="#wrglossary.7025">267</a>, <a href="#wrglossary.7229">275</a>, <a href="#wrglossary.7239">276</a>, <a href="#wrglossary.7304">278</a>, <a href="#wrglossary.8361">327</a>, <a href="#wrglossary.9671">383</a>, <a href="#wrglossary.9753">386</a>, <a href="#wrglossary.10137">398</a>, <a href="#wrglossary.10198">399</a>, <a href="#wrglossary.10494">410</a>, <a href="#wrglossary.10770">423</a>, <a href="#wrglossary.10803">424</a>, <a href="#wrglossary.10870">427</a>–<a href="#wrglossary.10933">429</a>, <a href="#wrglossary.10977">432</a>, <a href="#wrglossary.11041">436</a>, <a href="#wrglossary.11049">437</a>, <a href="#wrglossary.11099">440</a>, <a href="#wrglossary.11125">441</a>, <a href="#wrglossary.11254">447</a>–<a href="#wrglossary.11307">450</a>, <a href="#wrglossary.11346">453</a>–<a href="#wrglossary.11380">455</a>, <a href="#wrglossary.11411">457</a>, <a href="#wrglossary.11417">458</a>, <a href="#wrglossary.11470">460</a>, <a href="#wrglossary.11491">461</a>, <a href="#wrglossary.11549">467</a>, <a href="#wrglossary.11589">469</a>, <a href="#wrglossary.12373">508</a>, <a href="#wrglossary.12486">512</a>–<a href="#wrglossary.12550">514</a>, <a href="#wrglossary.12608">516</a>, <a href="#wrglossary.12794">525</a>, <a href="#wrglossary.12909">529</a>, <a href="#wrglossary.13049">533</a>, <a href="#wrglossary.13579">556</a>, <a href="#wrglossary.13894">570</a>, <a href="#wrglossary.13930">572</a>, <a href="#wrglossary.14199">586</a>, <a href="#wrglossary.14210">587</a>, <a href="#wrglossary.14230">589</a>, <a href="#wrglossary.14381">601</a>, <span class="termslocfmt"><a href="#wrglossary.14452">602</a></span>, <a href="#wrglossary.14605">607</a>, <a href="#wrglossary.14985">625</a>, <a href="#wrglossary.15498">646</a>–<a href="#wrglossary.15538">648</a>, <a href="#wrglossary.16465">675</a>, <a href="#wrglossary.17289">703</a>, <a href="#wrglossary.17427">707</a>, <a href="#wrglossary.17646">715</a>, <a href="#wrglossary.17672">716</a>, <a href="#wrglossary.18012">729</a>, <a href="#wrglossary.18056">731</a>, <a href="#wrglossary.18074">732</a>, <a href="#wrglossary.18147">734</a>, <a href="#wrglossary.18183">735</a>, <a href="#wrglossary.18255">739</a>, <a href="#wrglossary.18293">740</a>, <a href="#wrglossary.18415">745</a>, <a href="#wrglossary.18468">747</a>, <a href="#wrglossary.18582">752</a>, <a href="#wrglossary.18696">755</a>, <a href="#wrglossary.18757">757</a>, <a href="#wrglossary.19007">767</a>–<a href="#wrglossary.19123">772</a>, <a href="#wrglossary.19598">789</a>–<a href="#wrglossary.19632">791</a>, <a href="#wrglossary.19811">799</a>, <a href="#wrglossary.19966">805</a>, <a href="#wrglossary.20597">831</a>, <a href="#wrglossary.21248">858</a>, <a href="#wrglossary.22843">920</a>, <a href="#wrglossary.23178">928</a>, <a href="#wrglossary.23756">947</a>, <a href="#wrglossary.23805">948</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a><span class="qquad"></span><a href="#sec:newentrydefs">§3.1</a>; <a href="#wrglossary.371">16</a>, <a href="#wrglossary.413">17</a>, <a href="#wrglossary.933">32</a>, <a href="#wrglossary.12571">514</a>, <a href="#wrglossary.21211">856</a>, <span class="summarylocfmt"><a href="#wrglossary.22214">899</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:longnewglossaryentry*"><code class="csfmt">\longnewglossaryentry*</code></a><span class="qquad"></span><a href="#sec:newentrydefs">§3.1</a>; <a href="#wrglossary.941">32</a>, <a href="#wrglossary.9741">386</a>, <span class="summarylocfmt"><a href="#wrglossary.22218">899</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:env.longtable"><span class="envfmt">longtable</span> environment</dfn><span class="qquad"></span><a href="#wrglossary.10210">399</a>, <a href="#wrglossary.11197">445</a>, <a href="#wrglossary.11300">449</a>–<a href="#wrglossary.11420">458</a>, <a href="#wrglossary.11473">460</a>, <a href="#wrglossary.11479">461</a>, <a href="#wrglossary.11565">468</a>, <a href="#wrglossary.11580">469</a>, <a href="#wrglossary.11647">472</a>, <a href="#wrglossary.15461">645</a>, <a href="#wrglossary.15510">647</a>–<a href="#wrglossary.15576">649</a>, <a href="#wrglossary.18221">737</a>–<a href="#wrglossary.18389">744</a>, <a href="#wrglossary.18448">747</a>, <a href="#wrglossary.22170">896</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.longtable"><span class="styfmt">longtable</span> package</dfn><span class="qquad"></span><a href="#wrglossary.15591">649</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.lowercase">lowercase</dfn><span class="qquad"></span><a href="#wrglossary.3371">136</a>, <a href="#wrglossary.3901">157</a>, <a href="#wrglossary.5118">200</a>, <a href="#wrglossary.6807">262</a>, <a href="#wrglossary.13383">552</a>, <a href="#wrglossary.13397">553</a>, <a href="#wrglossary.18509">750</a>, <a href="#wrglossary.20828">839</a></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index7471104 -->
+
+<section id="index7536640"><!-- start of section index7536640 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->M<div class="labellink"><a href="#index7536640">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><dfn id="glo:mainmatter"><code class="csfmt">\mainmatter</code></dfn><span class="qquad"></span><a href="#wrglossary.4734">187</a>, <a href="#wrglossary.4742">188</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:MakeAcronymsAbbreviations"><code class="csfmt">\MakeAcronymsAbbreviations</code></a><span class="qquad"></span><a href="#sec:acrorevert">§4.6</a>; <a href="#wrglossary.4563">181</a>, <a href="#wrglossary.4571">182</a>, <span class="summarylocfmt"><a href="#wrglossary.22222">899</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a><span class="qquad"></span><a href="#wrglossary.5012">197</a>–<a href="#wrglossary.5083">199</a>, <a href="#wrglossary.6181">241</a>, <a href="#wrglossary.7590">291</a>, <a href="#wrglossary.7632">292</a>, <a href="#wrglossary.9382">373</a>, <a href="#wrglossary.16546">677</a>, <a href="#wrglossary.17710">717</a>, <a href="#wrglossary.17811">720</a>, <a href="#wrglossary.17851">721</a>, <a href="#wrglossary.18512">750</a>, <a href="#wrglossary.18631">753</a>, <a href="#wrglossary.18659">754</a>, <a href="#wrglossary.18791">758</a>, <a href="#wrglossary.18954">765</a>, <a href="#wrglossary.19987">806</a>, <a href="#wrglossary.20027">807</a>, <a href="#wrglossary.20625">831</a>, <a href="#wrglossary.20712">834</a>, <a href="#wrglossary.21493">867</a>, <a href="#wrglossary.21601">871</a>, <span class="summarylocfmt"><a href="#wrglossary.22224">899</a></span>, <a href="#wrglossary.22249">900</a>, <a href="#wrglossary.22269">901</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a><span class="qquad"></span><a href="#sec:glossaries">§8</a>; <a href="#wrglossary.641">23</a>–<a href="#wrglossary.756">25</a>, <a href="#wrglossary.6578">256</a>, <a href="#wrglossary.9411">375</a>, <a href="#wrglossary.9643">382</a>, <a href="#wrglossary.9711">385</a>, <a href="#wrglossary.14214">588</a>, <a href="#wrglossary.18713">755</a>, <a href="#wrglossary.21033">849</a>, <span class="summarylocfmt"><a href="#wrglossary.22232">900</a></span>, <a href="#wrglossary.23117">926</a>, <a href="#wrglossary.23138">927</a>, <a href="#wrglossary.23621">944</a>, <a href="#wrglossary.23814">949</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></dfn></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></dfn><span class="qquad"></span><a href="#wrglossary.115">6</a>, <a href="#wrglossary.6579">256</a>, <a href="#wrglossary.8066">312</a>, <a href="#wrglossary.8071">313</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:app.makeglossariesgui"><span class="appfmt">makeglossariesgui</span></dfn></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:app.makeindex"><span class="appfmt">makeindex</span></dfn><span class="qquad"></span><a href="#wrglossary.101">6</a>, <a href="#wrglossary.407">17</a>, <a href="#wrglossary.546">20</a>, <a href="#wrglossary.661">23</a>, <a href="#wrglossary.741">25</a>, <a href="#wrglossary.851">28</a>, <a href="#wrglossary.4957">195</a>, <a href="#wrglossary.4982">196</a>, <a href="#wrglossary.6741">261</a>, <a href="#wrglossary.14008">574</a>, <a href="#wrglossary.14386">601</a>, <a href="#wrglossary.22235">900</a>, <a href="#wrglossary.23115">926</a>, <a href="#wrglossary.23613">944</a>, <a href="#wrglossary.23732">947</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:MakeLowercase"><code class="csfmt">\MakeLowercase</code></dfn></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a><span class="qquad"></span><a href="#wrglossary.375">16</a>, <a href="#wrglossary.412">17</a>, <a href="#wrglossary.669">24</a>, <a href="#wrglossary.760">25</a>, <a href="#wrglossary.9404">375</a>, <a href="#wrglossary.9645">382</a>, <a href="#wrglossary.10135">397</a>, <a href="#wrglossary.12523">513</a>, <a href="#wrglossary.13540">555</a>, <a href="#wrglossary.18714">755</a>, <a href="#wrglossary.21025">849</a>, <span class="summarylocfmt"><a href="#wrglossary.22243">900</a></span>, <a href="#wrglossary.23136">927</a>, <a href="#wrglossary.23638">944</a>, <a href="#wrglossary.23827">949</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:MakeTextLowercase"><code class="csfmt">\MakeTextLowercase</code></dfn><span class="qquad"></span><a href="#wrglossary.5121">200</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:MakeTextUppercase"><code class="csfmt">\MakeTextUppercase</code></dfn><span class="qquad"></span><a href="#wrglossary.5199">203</a>, <a href="#wrglossary.5831">227</a>, <a href="#wrglossary.22252">900</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:MakeUppercase"><code class="csfmt">\MakeUppercase</code></dfn><span class="qquad"></span><a href="#wrglossary.3698">149</a>, <a href="#wrglossary.3709">150</a>, <a href="#wrglossary.3789">152</a>, <a href="#wrglossary.5829">227</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:markboth"><code class="csfmt">\markboth</code></dfn><span class="qquad"></span><a href="#wrglossary.5158">201</a>, <a href="#wrglossary.5205">204</a>, <a href="#wrglossary.5481">214</a>, <a href="#wrglossary.5814">227</a>, <a href="#wrglossary.10633">418</a>, <a href="#wrglossary.15650">652</a>, <a href="#wrglossary.20385">821</a>, <a href="#wrglossary.20793">837</a>, <a href="#wrglossary.21323">861</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:markright"><code class="csfmt">\markright</code></dfn><span class="qquad"></span><a href="#wrglossary.5157">201</a>, <a href="#wrglossary.5204">204</a>, <a href="#wrglossary.5480">214</a>, <a href="#wrglossary.5813">227</a>, <a href="#wrglossary.10632">418</a>, <a href="#wrglossary.15653">652</a>, <a href="#wrglossary.20384">821</a>, <a href="#wrglossary.20792">837</a>, <a href="#wrglossary.21322">861</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:mbox"><code class="csfmt">\mbox</code></dfn><span class="qquad"></span><a href="#wrglossary.6174">241</a>, <a href="#wrglossary.6200">242</a>, <a href="#wrglossary.7455">284</a>, <a href="#wrglossary.7528">288</a>, <a href="#wrglossary.7539">289</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:cls.memoir"><span class="clsfmt">memoir</span> class</dfn><span class="qquad"></span><a href="#wrglossary.78">5</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span> package</dfn><span class="qquad"></span><a href="#wrglossary.4998">196</a>–<a href="#wrglossary.5113">200</a>, <a href="#wrglossary.5194">203</a>, <a href="#wrglossary.5857">228</a>, <a href="#wrglossary.5987">234</a>, <a href="#wrglossary.6207">243</a>, <a href="#wrglossary.7591">291</a>, <a href="#wrglossary.7757">299</a>, <a href="#wrglossary.12216">500</a>, <a href="#wrglossary.12504">512</a>, <a href="#wrglossary.16191">664</a>, <a href="#wrglossary.16193">665</a>, <a href="#wrglossary.18511">750</a>, <a href="#wrglossary.20879">842</a>, <a href="#wrglossary.22225">899</a>–<a href="#wrglossary.22272">901</a>, <a href="#wrglossary.23435">937</a>, <a href="#wrglossary.23735">947</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mfirstucMakeUppercase"><code class="csfmt">\mfirstucMakeUppercase</code></a><span class="qquad"></span><a href="#wrglossary.5130">200</a>, <a href="#wrglossary.9389">373</a>, <span class="summarylocfmt"><a href="#wrglossary.22247">900</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:MFUaddmap"><code class="csfmt">\MFUaddmap</code></a><span class="qquad"></span><a href="#wrglossary.5096">199</a>, <a href="#wrglossary.7753">299</a>, <a href="#wrglossary.18519">750</a>, <span class="summarylocfmt"><a href="#wrglossary.22262">900</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:MFUexcl"><code class="csfmt">\MFUexcl</code></a> &amp; <a href="#glo:MFUblocker"><code class="csfmt">\MFUblocker</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:MFUblocker"><code class="csfmt">\MFUblocker</code></a><span class="qquad"></span><a href="#wrglossary.5075">199</a>, <a href="#wrglossary.18525">750</a>, <span class="summarylocfmt"><a href="#wrglossary.22267">900</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:MFUexcl"><code class="csfmt">\MFUexcl</code></a> &amp; <a href="#glo:MFUaddmap"><code class="csfmt">\MFUaddmap</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:MFUexcl"><code class="csfmt">\MFUexcl</code></a><span class="qquad"></span><a href="#wrglossary.5056">198</a>, <a href="#wrglossary.18531">750</a>, <span class="summarylocfmt"><a href="#wrglossary.22271">901</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:MFUblocker"><code class="csfmt">\MFUblocker</code></a> &amp; <a href="#glo:MFUaddmap"><code class="csfmt">\MFUaddmap</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:MFUsave"><code class="csfmt">\MFUsave</code></a><span class="qquad"></span><a href="#wrglossary.12506">512</a>, <a href="#wrglossary.20877">842</a>, <span class="summarylocfmt"><a href="#wrglossary.22275">901</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:MFUsaveatend"><code class="csfmt">\MFUsaveatend</code></a><span class="qquad"></span><a href="#wrglossary.12514">512</a>, <span class="summarylocfmt"><a href="#wrglossary.22280">901</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a><span class="qquad"></span><a href="#wrglossary.5019">197</a>, <a href="#wrglossary.5032">198</a>, <a href="#wrglossary.6180">241</a>, <a href="#wrglossary.7749">299</a>, <a href="#wrglossary.11605">470</a>, <a href="#wrglossary.18514">750</a>, <a href="#wrglossary.21088">851</a>, <a href="#wrglossary.22230">900</a>, <span class="summarylocfmt"><a href="#wrglossary.22285">901</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:MGLS"><code class="csfmt">\MGLS</code></a><span class="qquad"></span><a href="#sec:mglsbasic">§7.11.1</a>; <a href="#wrglossary.8660">342</a>, <a href="#wrglossary.8913">357</a>, <a href="#wrglossary.9076">364</a>, <span class="summarylocfmt"><a href="#wrglossary.22293">901</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:MGls"><code class="csfmt">\MGls</code></a><span class="qquad"></span><a href="#sec:mglsbasic">§7.11.1</a>; <a href="#wrglossary.9045">363</a>, <span class="summarylocfmt"><a href="#wrglossary.22300">901</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Mgls"><code class="csfmt">\Mgls</code></a><span class="qquad"></span><a href="#sec:mglsbasic">§7.11.1</a>; <a href="#wrglossary.8616">340</a>, <a href="#wrglossary.8659">342</a>, <a href="#wrglossary.8912">357</a>, <a href="#wrglossary.9039">363</a>, <span class="summarylocfmt"><a href="#wrglossary.22307">902</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mgls"><code class="csfmt">\mgls</code></a><span class="qquad"></span><a href="#sec:multientries">§7</a>; <a href="#wrglossary.4580">183</a>, <a href="#wrglossary.8258">323</a>–<a href="#wrglossary.8363">327</a>, <a href="#wrglossary.8436">330</a>, <a href="#wrglossary.8474">332</a>–<a href="#wrglossary.8512">334</a>, <a href="#wrglossary.8554">337</a>–<a href="#wrglossary.8595">339</a>, <a href="#wrglossary.8766">347</a>–<a href="#wrglossary.8794">349</a>, <a href="#wrglossary.8840">352</a>–<a href="#wrglossary.8881">355</a>, <a href="#wrglossary.8941">359</a>–<a href="#wrglossary.8983">361</a>, <a href="#wrglossary.9017">363</a>, <a href="#wrglossary.9347">372</a>, <a href="#wrglossary.14892">620</a>, <a href="#wrglossary.14907">621</a>, <a href="#wrglossary.22298">901</a>, <span class="summarylocfmt"><a href="#wrglossary.22314">902</a></span>, <a href="#wrglossary.22381">905</a>, <a href="#wrglossary.22446">908</a>–<a href="#wrglossary.22703">915</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsAddOptions"><code class="csfmt">\mglsAddOptions</code></a><span class="qquad"></span><a href="#sec:multientries">§7</a>; <a href="#wrglossary.8284">325</a>, <span class="summarylocfmt"><a href="#wrglossary.22319">902</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglscurrentcategory"><code class="csfmt">\mglscurrentcategory</code></a><span class="qquad"></span><a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8780">348</a>, <a href="#wrglossary.8870">354</a>, <span class="summarylocfmt"><a href="#wrglossary.22321">902</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglscurrentlabel"><code class="csfmt">\mglscurrentlabel</code></a><span class="qquad"></span><a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8789">348</a>, <a href="#wrglossary.8931">358</a>, <span class="summarylocfmt"><a href="#wrglossary.22323">902</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglscurrentlist"><code class="csfmt">\mglscurrentlist</code></a><span class="qquad"></span><a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8776">347</a>, <span class="summarylocfmt"><a href="#wrglossary.22325">902</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglscurrentmainlabel"><code class="csfmt">\mglscurrentmainlabel</code></a><span class="qquad"></span><a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8775">347</a>, <span class="summarylocfmt"><a href="#wrglossary.22327">902</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglscurrentmultilabel"><code class="csfmt">\mglscurrentmultilabel</code></a><span class="qquad"></span><a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8774">347</a>, <span class="summarylocfmt"><a href="#wrglossary.22329">903</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglscurrentoptions"><code class="csfmt">\mglscurrentoptions</code></a><span class="qquad"></span><a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8777">347</a>, <span class="summarylocfmt"><a href="#wrglossary.22331">903</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglscurrentprefix"><code class="csfmt">\mglscurrentprefix</code></a><span class="qquad"></span><a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8644">341</a>, <a href="#wrglossary.8653">342</a>, <a href="#wrglossary.8791">348</a>, <span class="summarylocfmt"><a href="#wrglossary.22333">903</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglscurrentsuffix"><code class="csfmt">\mglscurrentsuffix</code></a><span class="qquad"></span><a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8646">342</a>, <a href="#wrglossary.8792">348</a>, <span class="summarylocfmt"><a href="#wrglossary.22335">903</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglscustompostlinkhook"><code class="csfmt">\mglscustompostlinkhook</code></a><span class="qquad"></span><a href="#sec:mglspostlinkhook">§7.6</a>; <a href="#wrglossary.8798">349</a>, <a href="#wrglossary.8911">357</a>, <span class="summarylocfmt"><a href="#wrglossary.22337">903</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsdefcategoryprefix"><code class="csfmt">\mglsdefcategoryprefix</code></a><span class="qquad"></span><a href="#sec:mglsfixes">§7.3</a>; <a href="#wrglossary.8643">341</a>, <span class="summarylocfmt"><a href="#wrglossary.22340">903</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsdefcategorysuffix"><code class="csfmt">\mglsdefcategorysuffix</code></a><span class="qquad"></span><a href="#sec:mglsfixes">§7.3</a>; <a href="#wrglossary.8645">341</a>, <span class="summarylocfmt"><a href="#wrglossary.22342">903</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglselementindex"><code class="csfmt">\mglselementindex</code></a><span class="qquad"></span><a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8790">348</a>, <span class="summarylocfmt"><a href="#wrglossary.22344">904</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglselementposthook"><code class="csfmt">\mglselementposthook</code></a><span class="qquad"></span><a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8768">347</a>, <span class="summarylocfmt"><a href="#wrglossary.22346">904</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglselementprehook"><code class="csfmt">\mglselementprehook</code></a><span class="qquad"></span><a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8767">347</a>, <a href="#wrglossary.8784">348</a>, <a href="#wrglossary.9194">366</a>, <span class="summarylocfmt"><a href="#wrglossary.22348">904</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglselementreset"><code class="csfmt">\mglselementreset</code></a><span class="qquad"></span><a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.9012">362</a>, <span class="summarylocfmt"><a href="#wrglossary.22350">904</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglselementunset"><code class="csfmt">\mglselementunset</code></a><span class="qquad"></span><a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.9013">362</a>, <span class="summarylocfmt"><a href="#wrglossary.22355">904</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsfield"><code class="csfmt">\mglsfield</code></a><span class="qquad"></span><a href="#sec:mglsotherfields">§7.11.3</a>; <a href="#wrglossary.9178">366</a>, <span class="summarylocfmt"><a href="#wrglossary.22360">904</a></span>, <a href="#wrglossary.22621">913</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsforelements"><code class="csfmt">\mglsforelements</code></a><span class="qquad"></span><a href="#sec:multiextras">§7.13</a>; <a href="#wrglossary.9329">370</a>, <a href="#wrglossary.9333">371</a>, <span class="summarylocfmt"><a href="#wrglossary.22364">904</a></span>, <a href="#wrglossary.22368">905</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsforotherelements"><code class="csfmt">\mglsforotherelements</code></a><span class="qquad"></span><a href="#sec:multiextras">§7.13</a>; <a href="#wrglossary.9332">371</a>, <span class="summarylocfmt"><a href="#wrglossary.22366">904</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Mglsfull"><code class="csfmt">\Mglsfull</code></a><span class="qquad"></span><a href="#sec:mglsabbrv">§7.11.2</a>; <a href="#wrglossary.9126">365</a>, <span class="summarylocfmt"><a href="#wrglossary.22369">905</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsfull"><code class="csfmt">\mglsfull</code></a><span class="qquad"></span><a href="#sec:mglsabbrv">§7.11.2</a>; <a href="#wrglossary.9107">364</a>, <a href="#wrglossary.9130">365</a>, <span class="summarylocfmt"><a href="#wrglossary.22376">905</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglshascategoryprefix"><code class="csfmt">\mglshascategoryprefix</code></a><span class="qquad"></span><a href="#sec:mglsfixes">§7.3</a>; <a href="#wrglossary.8648">342</a>, <span class="summarylocfmt"><a href="#wrglossary.22385">905</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglshascategorysuffix"><code class="csfmt">\mglshascategorysuffix</code></a><span class="qquad"></span><a href="#sec:mglsfixes">§7.3</a>; <a href="#wrglossary.8651">342</a>, <span class="summarylocfmt"><a href="#wrglossary.22387">905</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsiflast"><code class="csfmt">\mglsiflast</code></a><span class="qquad"></span><a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8793">349</a>, <span class="summarylocfmt"><a href="#wrglossary.22389">905</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsiflastelementcapscase"><code class="csfmt">\mglsiflastelementcapscase</code></a><span class="qquad"></span><a href="#sec:mglspostlinkhooklastelement">§7.6.1</a>; <a href="#wrglossary.8827">351</a>, <span class="summarylocfmt"><a href="#wrglossary.22391">905</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsiflastelementskipped"><code class="csfmt">\mglsiflastelementskipped</code></a><span class="qquad"></span><a href="#sec:mglspostlinkhooklastelement">§7.6.1</a>; <a href="#wrglossary.8822">350</a>, <span class="summarylocfmt"><a href="#wrglossary.22395">906</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsiflastelementwasfirstuse"><code class="csfmt">\mglsiflastelementwasfirstuse</code></a><span class="qquad"></span><a href="#sec:mglspostlinkhooklastelement">§7.6.1</a>; <a href="#wrglossary.8823">350</a>, <span class="summarylocfmt"><a href="#wrglossary.22397">906</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsiflastelementwasplural"><code class="csfmt">\mglsiflastelementwasplural</code></a><span class="qquad"></span><a href="#sec:mglspostlinkhooklastelement">§7.6.1</a>; <a href="#wrglossary.8825">351</a>, <span class="summarylocfmt"><a href="#wrglossary.22399">906</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsiflastmaincapscase"><code class="csfmt">\mglsiflastmaincapscase</code></a><span class="qquad"></span><a href="#sec:mglspostlinkhookmainelement">§7.6.2</a>; <a href="#wrglossary.8836">352</a>, <span class="summarylocfmt"><a href="#wrglossary.22401">906</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsiflastmainskipped"><code class="csfmt">\mglsiflastmainskipped</code></a><span class="qquad"></span><a href="#sec:mglspostlinkhookmainelement">§7.6.2</a>; <a href="#wrglossary.8831">351</a>, <span class="summarylocfmt"><a href="#wrglossary.22405">906</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsiflastmainwasfirstuse"><code class="csfmt">\mglsiflastmainwasfirstuse</code></a><span class="qquad"></span><a href="#sec:mglspostlinkhookmainelement">§7.6.2</a>; <a href="#wrglossary.8832">351</a>, <span class="summarylocfmt"><a href="#wrglossary.22407">906</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsiflastmainwasplural"><code class="csfmt">\mglsiflastmainwasplural</code></a><span class="qquad"></span><a href="#sec:mglspostlinkhookmainelement">§7.6.2</a>; <a href="#wrglossary.8834">352</a>, <span class="summarylocfmt"><a href="#wrglossary.22409">907</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsisfirstuse"><code class="csfmt">\mglsisfirstuse</code></a><span class="qquad"></span><a href="#sec:mglselementhooks">§7.5</a>; <a href="#wrglossary.8782">348</a>, <span class="summarylocfmt"><a href="#wrglossary.22411">907</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglslastcategory"><code class="csfmt">\mglslastcategory</code></a><span class="qquad"></span><a href="#sec:mglspostlinkhook">§7.6</a>; <a href="#wrglossary.8819">350</a>, <span class="summarylocfmt"><a href="#wrglossary.22413">907</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglslastelementlabel"><code class="csfmt">\mglslastelementlabel</code></a><span class="qquad"></span><a href="#sec:mglspostlinkhooklastelement">§7.6.1</a>; <a href="#wrglossary.8642">341</a>, <a href="#wrglossary.8821">350</a>, <a href="#wrglossary.8830">351</a>, <span class="summarylocfmt"><a href="#wrglossary.22415">907</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglslastelementpostlinkhook"><code class="csfmt">\mglslastelementpostlinkhook</code></a><span class="qquad"></span><a href="#sec:mglspostlinkhook">§7.6</a>; <a href="#wrglossary.8800">349</a>, <a href="#wrglossary.8907">357</a>, <span class="summarylocfmt"><a href="#wrglossary.22417">907</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglslastmainlabel"><code class="csfmt">\mglslastmainlabel</code></a><span class="qquad"></span><a href="#sec:mglspostlinkhookmainelement">§7.6.2</a>; <a href="#wrglossary.8829">351</a>, <span class="summarylocfmt"><a href="#wrglossary.22420">907</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglslastmainpostlinkhook"><code class="csfmt">\mglslastmainpostlinkhook</code></a><span class="qquad"></span><a href="#sec:mglspostlinkhook">§7.6</a>; <a href="#wrglossary.8802">349</a>, <a href="#wrglossary.8909">357</a>, <span class="summarylocfmt"><a href="#wrglossary.22422">907</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglslastmultilabel"><code class="csfmt">\mglslastmultilabel</code></a><span class="qquad"></span><a href="#sec:mglspostlinkhook">§7.6</a>; <a href="#wrglossary.8818">350</a>, <span class="summarylocfmt"><a href="#wrglossary.22425">908</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglslocalreset"><code class="csfmt">\mglslocalreset</code></a><span class="qquad"></span><a href="#sec:mglsfirstuse">§7.7</a>; <a href="#wrglossary.8849">353</a>, <span class="summarylocfmt"><a href="#wrglossary.22427">908</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglslocalunset"><code class="csfmt">\mglslocalunset</code></a><span class="qquad"></span><a href="#sec:mglsfirstuse">§7.7</a>; <a href="#wrglossary.8848">353</a>, <span class="summarylocfmt"><a href="#wrglossary.22429">908</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglslocalunsetothers"><code class="csfmt">\mglslocalunsetothers</code></a><span class="qquad"></span><a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.9016">362</a>, <span class="summarylocfmt"><a href="#wrglossary.22431">908</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Mglslong"><code class="csfmt">\Mglslong</code></a><span class="qquad"></span><a href="#sec:mglsabbrv">§7.11.2</a>; <a href="#wrglossary.9120">365</a>, <span class="summarylocfmt"><a href="#wrglossary.22434">908</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglslong"><code class="csfmt">\mglslong</code></a><span class="qquad"></span><a href="#sec:mglsabbrv">§7.11.2</a>; <a href="#wrglossary.9100">364</a>, <a href="#wrglossary.9124">365</a>, <span class="summarylocfmt"><a href="#wrglossary.22441">908</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:MGLSmainpl"><code class="csfmt">\MGLSmainpl</code></a><span class="qquad"></span><a href="#sec:mglsbasic">§7.11.1</a>; <a href="#wrglossary.9087">364</a>, <span class="summarylocfmt"><a href="#wrglossary.22450">908</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:MGlsmainpl"><code class="csfmt">\MGlsmainpl</code></a><span class="qquad"></span><a href="#sec:mglsbasic">§7.11.1</a>; <a href="#wrglossary.9070">364</a>, <span class="summarylocfmt"><a href="#wrglossary.22458">909</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Mglsmainpl"><code class="csfmt">\Mglsmainpl</code></a><span class="qquad"></span><a href="#sec:mglsbasic">§7.11.1</a>; <a href="#wrglossary.9056">363</a>, <span class="summarylocfmt"><a href="#wrglossary.22466">909</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsmainpl"><code class="csfmt">\mglsmainpl</code></a><span class="qquad"></span><a href="#sec:mglsbasic">§7.11.1</a>; <a href="#wrglossary.8598">339</a>, <a href="#wrglossary.8611">340</a>, <a href="#wrglossary.9032">363</a>, <span class="summarylocfmt"><a href="#wrglossary.22473">909</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:MGlsname"><code class="csfmt">\MGlsname</code></a><span class="qquad"></span><a href="#sec:mglsotherfields">§7.11.3</a>; <a href="#wrglossary.9143">365</a>, <span class="summarylocfmt"><a href="#wrglossary.22479">909</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Mglsname"><code class="csfmt">\Mglsname</code></a><span class="qquad"></span><a href="#sec:mglsotherfields">§7.11.3</a>; <a href="#wrglossary.9137">365</a>, <span class="summarylocfmt"><a href="#wrglossary.22486">909</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsname"><code class="csfmt">\mglsname</code></a><span class="qquad"></span><a href="#sec:mglsotherfields">§7.11.3</a>; <a href="#wrglossary.8765">346</a>, <a href="#wrglossary.8842">352</a>, <a href="#wrglossary.9132">365</a>, <span class="summarylocfmt"><a href="#wrglossary.22494">909</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:MGLSpl"><code class="csfmt">\MGLSpl</code></a><span class="qquad"></span><a href="#sec:mglsbasic">§7.11.1</a>; <a href="#wrglossary.9081">364</a>, <span class="summarylocfmt"><a href="#wrglossary.22501">909</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:MGlspl"><code class="csfmt">\MGlspl</code></a><span class="qquad"></span><a href="#sec:mglsbasic">§7.11.1</a>; <a href="#wrglossary.9065">364</a>, <span class="summarylocfmt"><a href="#wrglossary.22508">910</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Mglspl"><code class="csfmt">\Mglspl</code></a><span class="qquad"></span><a href="#sec:mglsbasic">§7.11.1</a>; <a href="#wrglossary.9050">363</a>, <span class="summarylocfmt"><a href="#wrglossary.22515">910</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglspl"><code class="csfmt">\mglspl</code></a><span class="qquad"></span><a href="#sec:mglsbasic">§7.11.1</a>; <a href="#wrglossary.8610">340</a>, <a href="#wrglossary.8764">346</a>, <a href="#wrglossary.8964">360</a>, <a href="#wrglossary.9026">363</a>, <span class="summarylocfmt"><a href="#wrglossary.22523">910</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsprefix"><code class="csfmt">\mglsprefix</code></a><span class="qquad"></span><a href="#sec:mglsfixes">§7.3</a>; <a href="#wrglossary.8618">340</a>, <a href="#wrglossary.8647">342</a>, <span class="summarylocfmt"><a href="#wrglossary.22529">910</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsreset"><code class="csfmt">\mglsreset</code></a><span class="qquad"></span><a href="#sec:mglsfirstuse">§7.7</a>; <a href="#wrglossary.8847">352</a>, <span class="summarylocfmt"><a href="#wrglossary.22531">910</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsresetall"><code class="csfmt">\mglsresetall</code></a><span class="qquad"></span><a href="#sec:mglsfirstuse">§7.7</a>; <a href="#wrglossary.8851">353</a>, <span class="summarylocfmt"><a href="#wrglossary.22533">910</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsseefirstitem"><code class="csfmt">\mglsseefirstitem</code></a><span class="qquad"></span><a href="#sec:msee">§7.12</a>; <a href="#wrglossary.7795">301</a>, <a href="#wrglossary.9301">369</a>, <a href="#wrglossary.18781">758</a>, <span class="summarylocfmt"><a href="#wrglossary.22535">910</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsseeitem"><code class="csfmt">\mglsseeitem</code></a><span class="qquad"></span><a href="#sec:msee">§7.12</a>; <a href="#wrglossary.7796">301</a>, <a href="#wrglossary.9302">369</a>, <a href="#wrglossary.18776">758</a>, <span class="summarylocfmt"><a href="#wrglossary.22537">911</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsSetMain"><code class="csfmt">\mglsSetMain</code></a><span class="qquad"></span><a href="#wrglossary.8278">324</a>, <a href="#wrglossary.8596">339</a>, <span class="summarylocfmt"><a href="#wrglossary.22539">911</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsSetOptions"><code class="csfmt">\mglsSetOptions</code></a><span class="qquad"></span><a href="#sec:multientries">§7</a>; <a href="#wrglossary.8283">325</a>, <span class="summarylocfmt"><a href="#wrglossary.22541">911</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Mglsshort"><code class="csfmt">\Mglsshort</code></a><span class="qquad"></span><a href="#sec:mglsabbrv">§7.11.2</a>; <a href="#wrglossary.9114">365</a>, <span class="summarylocfmt"><a href="#wrglossary.22543">911</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsshort"><code class="csfmt">\mglsshort</code></a><span class="qquad"></span><a href="#sec:mglsabbrv">§7.11.2</a>; <a href="#wrglossary.9093">364</a>, <a href="#wrglossary.9118">365</a>, <span class="summarylocfmt"><a href="#wrglossary.22550">911</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglssuffix"><code class="csfmt">\mglssuffix</code></a><span class="qquad"></span><a href="#sec:mglsfixes">§7.3</a>; <a href="#wrglossary.8628">341</a>, <a href="#wrglossary.8650">342</a>, <a href="#wrglossary.8817">350</a>, <span class="summarylocfmt"><a href="#wrglossary.22559">911</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:MGlssymbol"><code class="csfmt">\MGlssymbol</code></a><span class="qquad"></span><a href="#sec:mglsotherfields">§7.11.3</a>; <a href="#wrglossary.9155">365</a>, <a href="#wrglossary.9167">366</a>, <span class="summarylocfmt"><a href="#wrglossary.22561">912</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Mglssymbol"><code class="csfmt">\Mglssymbol</code></a><span class="qquad"></span><a href="#sec:mglsotherfields">§7.11.3</a>; <a href="#wrglossary.9163">366</a>, <span class="summarylocfmt"><a href="#wrglossary.22570">912</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglssymbol"><code class="csfmt">\mglssymbol</code></a><span class="qquad"></span><a href="#sec:mglsotherfields">§7.11.3</a>; <a href="#wrglossary.9148">365</a>, <span class="summarylocfmt"><a href="#wrglossary.22580">912</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsunset"><code class="csfmt">\mglsunset</code></a><span class="qquad"></span><a href="#sec:mglsfirstuse">§7.7</a>; <a href="#wrglossary.8846">352</a>, <span class="summarylocfmt"><a href="#wrglossary.22589">912</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsunsetall"><code class="csfmt">\mglsunsetall</code></a><span class="qquad"></span><a href="#sec:mglsfirstuse">§7.7</a>; <a href="#wrglossary.8850">353</a>, <span class="summarylocfmt"><a href="#wrglossary.22591">912</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsunsetothers"><code class="csfmt">\mglsunsetothers</code></a><span class="qquad"></span><a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.9015">362</a>, <span class="summarylocfmt"><a href="#wrglossary.22593">912</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsusecategoryprefix"><code class="csfmt">\mglsusecategoryprefix</code></a><span class="qquad"></span><a href="#sec:mglsfixes">§7.3</a>; <a href="#wrglossary.8649">342</a>, <span class="summarylocfmt"><a href="#wrglossary.22596">912</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsusecategorysuffix"><code class="csfmt">\mglsusecategorysuffix</code></a><span class="qquad"></span><a href="#sec:mglsfixes">§7.3</a>; <a href="#wrglossary.8652">342</a>, <span class="summarylocfmt"><a href="#wrglossary.22598">913</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:MGlsusefield"><code class="csfmt">\MGlsusefield</code></a><span class="qquad"></span><a href="#sec:mglsotherfields">§7.11.3</a>; <a href="#wrglossary.9188">366</a>, <span class="summarylocfmt"><a href="#wrglossary.22600">913</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Mglsusefield"><code class="csfmt">\Mglsusefield</code></a><span class="qquad"></span><a href="#sec:mglsotherfields">§7.11.3</a>; <a href="#wrglossary.9182">366</a>, <span class="summarylocfmt"><a href="#wrglossary.22607">913</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglsusefield"><code class="csfmt">\mglsusefield</code></a><span class="qquad"></span><a href="#sec:mglsotherfields">§7.11.3</a>; <a href="#wrglossary.9170">366</a>, <a href="#wrglossary.22363">904</a>, <span class="summarylocfmt"><a href="#wrglossary.22614">913</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mglswasfirstuse"><code class="csfmt">\mglswasfirstuse</code></a><span class="qquad"></span><a href="#sec:mglspostlinkhook">§7.6</a>; <a href="#wrglossary.8820">350</a>, <span class="summarylocfmt"><a href="#wrglossary.22623">913</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.mini-glossary">mini-glossary</dfn><span class="qquad"></span><a href="#wrglossary.7575">290</a>, <a href="#wrglossary.10389">406</a>, <a href="#wrglossary.10496">410</a>, <a href="#wrglossary.10503">411</a>, <a href="#wrglossary.11422">458</a>, <a href="#wrglossary.13012">532</a>, <a href="#wrglossary.13024">533</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:MPGLS"><code class="csfmt">\MPGLS</code></a><span class="qquad"></span><a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9280">369</a>, <span class="summarylocfmt"><a href="#wrglossary.22625">913</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:MPGls"><code class="csfmt">\MPGls</code></a><span class="qquad"></span><a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9261">368</a>, <span class="summarylocfmt"><a href="#wrglossary.22632">913</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Mpgls"><code class="csfmt">\Mpgls</code></a><span class="qquad"></span><a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9248">368</a>, <span class="summarylocfmt"><a href="#wrglossary.22639">914</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mpgls"><code class="csfmt">\mpgls</code></a><span class="qquad"></span><a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.8617">340</a>, <a href="#wrglossary.8914">357</a>, <a href="#wrglossary.9230">367</a>, <a href="#wrglossary.22630">913</a>, <span class="summarylocfmt"><a href="#wrglossary.22646">914</a></span>, <a href="#wrglossary.22710">915</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:MPGLSmainpl"><code class="csfmt">\MPGLSmainpl</code></a><span class="qquad"></span><a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9292">369</a>, <span class="summarylocfmt"><a href="#wrglossary.22653">914</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:MPGlsmainpl"><code class="csfmt">\MPGlsmainpl</code></a><span class="qquad"></span><a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9273">368</a>, <span class="summarylocfmt"><a href="#wrglossary.22660">914</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Mpglsmainpl"><code class="csfmt">\Mpglsmainpl</code></a><span class="qquad"></span><a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9254">368</a>, <span class="summarylocfmt"><a href="#wrglossary.22667">914</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mpglsmainpl"><code class="csfmt">\mpglsmainpl</code></a><span class="qquad"></span><a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9242">368</a>, <span class="summarylocfmt"><a href="#wrglossary.22674">914</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:MPGLSpl"><code class="csfmt">\MPGLSpl</code></a><span class="qquad"></span><a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9286">369</a>, <span class="summarylocfmt"><a href="#wrglossary.22684">915</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:MPGlspl"><code class="csfmt">\MPGlspl</code></a><span class="qquad"></span><a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9267">368</a>, <span class="summarylocfmt"><a href="#wrglossary.22691">915</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mpglspl"><code class="csfmt">\mpglspl</code></a><span class="qquad"></span><a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9236">368</a>, <a href="#wrglossary.22672">914</a>, <span class="summarylocfmt"><a href="#wrglossary.22698">915</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:mpglsWarning"><code class="csfmt">\mpglsWarning</code></a><span class="qquad"></span><a href="#sec:mpgls">§7.11.4</a>; <a href="#wrglossary.9229">367</a>, <span class="summarylocfmt"><a href="#wrglossary.22706">915</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Mu"><code class="csfmt">\Mu</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13978">573</a>, <span class="summarylocfmt"><a href="#wrglossary.22711">915</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:mfirstuse">multi-entry first use</dfn><span class="qquad"></span><a href="#wrglossary.8904">356</a>–<a href="#wrglossary.8935">359</a>, <a href="#wrglossary.14333">600</a>, <span class="termslocfmt"><a href="#wrglossary.14460">602</a></span>, <a href="#wrglossary.14886">619</a>–<a href="#wrglossary.14909">621</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:mfirstuseflag">multi-entry first use flag</dfn><span class="qquad"></span><a href="#wrglossary.8985">361</a>–<a href="#wrglossary.9020">363</a>, <span class="termslocfmt"><a href="#wrglossary.14463">602</a></span>, <a href="#wrglossary.14914">621</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.mglsopt">multi-entry set options</dfn><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.14875">619</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.all"><span class="csoptfmt">all</span></a><span class="qquad"></span><a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.8944">359</a>–<a href="#wrglossary.8981">361</a>, <span class="summarylocfmt"><a href="#wrglossary.14876">619</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.category"><span class="csoptfmt">category</span></a><span class="qquad"></span><a href="#sec:multiglsoptionsgeneral">§7.9.6</a>; <a href="#wrglossary.8854">353</a>, <a href="#wrglossary.8939">359</a>, <span class="summarylocfmt"><a href="#wrglossary.14878">619</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.encapmain"><span class="csoptfmt">encapmain</span></a><span class="qquad"></span><a href="#sec:multiglsoptionsencap">§7.9.2</a>; <a href="#wrglossary.8886">355</a>, <span class="summarylocfmt"><a href="#wrglossary.14879">619</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.encapothers"><span class="csoptfmt">encapothers</span></a><span class="qquad"></span><a href="#sec:multiglsoptionsencap">§7.9.2</a>; <a href="#wrglossary.8889">355</a>, <span class="summarylocfmt"><a href="#wrglossary.14881">619</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.firstprefix"><span class="csoptfmt">firstprefix</span></a><span class="qquad"></span><a href="#sec:multiglsoptionsfixes">§7.9.4</a>; <a href="#wrglossary.8655">342</a>, <a href="#wrglossary.8915">357</a>, <span class="summarylocfmt"><a href="#wrglossary.14883">619</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.firstskipmain"><span class="csoptfmt">firstskipmain</span></a><span class="qquad"></span><a href="#sec:multiglsoptionsskip">§7.9.5</a>; <a href="#wrglossary.8923">358</a>, <span class="summarylocfmt"><a href="#wrglossary.14885">619</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.firstskipothers"><span class="csoptfmt">firstskipothers</span></a><span class="qquad"></span><a href="#sec:multiglsoptionsskip">§7.9.5</a>; <a href="#wrglossary.8925">358</a>, <span class="summarylocfmt"><a href="#wrglossary.14887">620</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.firstsuffix"><span class="csoptfmt">firstsuffix</span></a><span class="qquad"></span><a href="#sec:multiglsoptionsfixes">§7.9.4</a>; <a href="#wrglossary.8370">328</a>, <a href="#wrglossary.8656">342</a>, <a href="#wrglossary.8919">357</a>, <span class="summarylocfmt"><a href="#wrglossary.14889">620</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="qquad"></span><a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.8362">327</a>, <a href="#wrglossary.8475">332</a>, <a href="#wrglossary.8982">361</a>, <span class="summarylocfmt"><a href="#wrglossary.14891">620</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.multi.hyper">hyper</a><span class="qquad"></span><a href="#sec:multiglsoptionsgeneral">§7.9.6</a>; <a href="#wrglossary.8934">358</a>, <span class="summarylocfmt"><a href="#wrglossary.14895">620</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.indexmain"><span class="csoptfmt">indexmain</span></a><span class="qquad"></span><a href="#sec:multiglsoptionsindexing">§7.9.1</a>; <a href="#wrglossary.8882">355</a>, <span class="summarylocfmt"><a href="#wrglossary.14896">620</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.indexothers"><span class="csoptfmt">indexothers</span></a><span class="qquad"></span><a href="#sec:multiglsoptionsindexing">§7.9.1</a>; <a href="#wrglossary.8288">325</a>, <a href="#wrglossary.8884">355</a>, <span class="summarylocfmt"><a href="#wrglossary.14900">620</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.main"><span class="csoptfmt">main</span></a><span class="qquad"></span><a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.8974">360</a>, <span class="summarylocfmt"><a href="#wrglossary.14904">620</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.mglsopts"><span class="csoptfmt">mglsopts</span></a><span class="qquad"></span><a href="#sec:multiglsoptionsgeneral">§7.9.6</a>; <a href="#wrglossary.8477">332</a>, <a href="#wrglossary.8940">359</a>, <a href="#wrglossary.8969">360</a>, <span class="summarylocfmt"><a href="#wrglossary.14906">621</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.mpostlink"><span class="csoptfmt">mpostlink</span></a><span class="qquad"></span><a href="#sec:multiglsoptionspostlink">§7.9.3</a>; <a href="#wrglossary.8433">330</a>, <a href="#wrglossary.8795">349</a>, <a href="#wrglossary.8903">356</a>, <span class="summarylocfmt"><a href="#wrglossary.14908">621</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.mpostlinkelement"><span class="csoptfmt">mpostlinkelement</span></a><span class="qquad"></span><a href="#sec:multiglsoptionspostlink">§7.9.3</a>; <a href="#wrglossary.8796">349</a>, <a href="#wrglossary.8906">356</a>, <span class="summarylocfmt"><a href="#wrglossary.14911">621</a></span>, <a href="#wrglossary.22339">903</a>, <a href="#wrglossary.22419">907</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.multiunset"><span class="csoptfmt">multiunset</span></a><span class="qquad"></span><a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.8984">361</a>, <a href="#wrglossary.9021">363</a>, <span class="summarylocfmt"><a href="#wrglossary.14913">621</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.others"><span class="csoptfmt">others</span></a><span class="qquad"></span><a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.8482">332</a>, <a href="#wrglossary.8978">360</a>, <span class="summarylocfmt"><a href="#wrglossary.14915">621</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.postlinks"><span class="csoptfmt">postlinks</span></a><span class="qquad"></span><a href="#sec:multiglsoptionspostlink">§7.9.3</a>; <a href="#wrglossary.8432">330</a>, <a href="#wrglossary.8770">347</a>, <a href="#wrglossary.8803">349</a>, <a href="#wrglossary.8892">356</a>, <span class="summarylocfmt"><a href="#wrglossary.14917">621</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.presetlocal"><span class="csoptfmt">presetlocal</span></a><span class="qquad"></span><a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.8478">332</a>, <a href="#wrglossary.8987">361</a>, <a href="#wrglossary.9014">362</a>, <span class="summarylocfmt"><a href="#wrglossary.14919">621</a></span>, <a href="#wrglossary.22354">904</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.resetall"><span class="csoptfmt">resetall</span></a><span class="qquad"></span><a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.8988">361</a>, <span class="summarylocfmt"><a href="#wrglossary.14920">621</a></span>, <a href="#wrglossary.22352">904</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.resetmain"><span class="csoptfmt">resetmain</span></a><span class="qquad"></span><a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.8994">361</a>, <span class="summarylocfmt"><a href="#wrglossary.14923">622</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.resetothers"><span class="csoptfmt">resetothers</span></a><span class="qquad"></span><a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.8997">361</a>, <span class="summarylocfmt"><a href="#wrglossary.14926">622</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.setup"><span class="csoptfmt">setup</span></a><span class="qquad"></span><a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.8858">354</a>, <a href="#wrglossary.8880">355</a>, <a href="#wrglossary.8942">359</a>, <a href="#wrglossary.8965">360</a>, <span class="summarylocfmt"><a href="#wrglossary.14929">622</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.textformat"><span class="csoptfmt">textformat</span></a><span class="qquad"></span><a href="#sec:multiglsoptionsgeneral">§7.9.6</a>; <a href="#wrglossary.8933">358</a>, <a href="#wrglossary.8938">359</a>, <span class="summarylocfmt"><a href="#wrglossary.14930">622</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.unsetall"><span class="csoptfmt">unsetall</span></a><span class="qquad"></span><a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.9000">362</a>, <span class="summarylocfmt"><a href="#wrglossary.14931">622</a></span>, <a href="#wrglossary.22357">904</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.unsetmain"><span class="csoptfmt">unsetmain</span></a><span class="qquad"></span><a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.9006">362</a>, <span class="summarylocfmt"><a href="#wrglossary.14934">622</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.unsetothers"><span class="csoptfmt">unsetothers</span></a><span class="qquad"></span><a href="#sec:mglsopts">§7.10</a>; <a href="#wrglossary.9009">362</a>, <span class="summarylocfmt"><a href="#wrglossary.14937">622</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.usedprefix"><span class="csoptfmt">usedprefix</span></a><span class="qquad"></span><a href="#sec:multiglsoptionsfixes">§7.9.4</a>; <a href="#wrglossary.8657">342</a>, <a href="#wrglossary.8917">357</a>, <span class="summarylocfmt"><a href="#wrglossary.14940">623</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.usedskipmain"><span class="csoptfmt">usedskipmain</span></a><span class="qquad"></span><a href="#sec:multiglsoptionsskip">§7.9.5</a>; <a href="#wrglossary.8927">358</a>, <span class="summarylocfmt"><a href="#wrglossary.14942">623</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.usedskipothers"><span class="csoptfmt">usedskipothers</span></a><span class="qquad"></span><a href="#sec:multiglsoptionsskip">§7.9.5</a>; <a href="#wrglossary.8929">358</a>, <span class="summarylocfmt"><a href="#wrglossary.14944">623</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.mglsopt.usedsuffix"><span class="csoptfmt">usedsuffix</span></a><span class="qquad"></span><a href="#sec:multiglsoptionsfixes">§7.9.4</a>; <a href="#wrglossary.8658">342</a>, <a href="#wrglossary.8921">357</a>, <span class="summarylocfmt"><a href="#wrglossary.14946">623</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx0"><dfn id="glo:msubsequentuse">multi-entry subsequent use</dfn><span class="qquad"></span><a href="#wrglossary.8905">356</a>–<a href="#wrglossary.8928">358</a>, <span class="termslocfmt"><a href="#wrglossary.14465">602</a></span>, <a href="#wrglossary.14910">621</a>, <a href="#wrglossary.14943">623</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.multicol"><span class="styfmt">multicol</span> package</dfn><span class="qquad"></span><a href="#wrglossary.11485">461</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:env.multicols"><span class="envfmt">multicols</span> environment</dfn><span class="qquad"></span><a href="#wrglossary.11078">439</a>, <a href="#wrglossary.11499">462</a>, <a href="#wrglossary.15599">649</a>, <a href="#wrglossary.15607">650</a>, <a href="#wrglossary.18995">766</a>, <a href="#wrglossary.19574">788</a>, <a href="#wrglossary.19605">790</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:env.multicols*"><span class="envfmt">multicols*</span> environment</dfn><span class="qquad"></span><a href="#wrglossary.11081">439</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:multiglossaryentry"><code class="csfmt">\multiglossaryentry</code></a><span class="qquad"></span><a href="#sec:multientries">§7</a>; <a href="#wrglossary.8253">323</a>–<a href="#wrglossary.8285">325</a>, <a href="#wrglossary.8594">339</a>, <a href="#wrglossary.8857">353</a>, <a href="#wrglossary.8873">354</a>, <a href="#wrglossary.8967">360</a>, <a href="#wrglossary.9337">371</a>, <a href="#wrglossary.9352">372</a>, <span class="summarylocfmt"><a href="#wrglossary.22714">915</a></span>, <a href="#wrglossary.23250">930</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:multiglossaryentryglobalfalse"><code class="csfmt">\multiglossaryentryglobalfalse</code></a><span class="qquad"></span><a href="#sec:multientries">§7</a>; <a href="#wrglossary.8281">325</a>, <span class="summarylocfmt"><a href="#wrglossary.22716">915</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:multiglossaryentryglobaltrue"><code class="csfmt">\multiglossaryentryglobaltrue</code></a><span class="qquad"></span><a href="#sec:multientries">§7</a>; <a href="#wrglossary.8280">324</a>, <span class="summarylocfmt"><a href="#wrglossary.22719">916</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:multiglossaryentrysetup"><code class="csfmt">\multiglossaryentrysetup</code></a><span class="qquad"></span><a href="#sec:multiglsoptions">§7.9</a>; <a href="#wrglossary.8778">347</a>, <a href="#wrglossary.8872">354</a>, <a href="#wrglossary.8966">360</a>, <span class="summarylocfmt"><a href="#wrglossary.22722">916</a></span></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index7536640 -->
+
+<section id="index7602176"><!-- start of section index7602176 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->N<div class="labellink"><a href="#index7602176">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><dfn id="glo:nameref"><code class="csfmt">\nameref</code></dfn><span class="qquad"></span><a href="#wrglossary.5514">215</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.nameref"><span class="styfmt">nameref</span> package</dfn><span class="qquad"></span><a href="#wrglossary.5513">215</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:newabbr"><code class="csfmt">\newabbr</code></a><span class="qquad"></span><a href="#sec:abbrshortcuts">§4.3.2</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <span class="summarylocfmt"><a href="#wrglossary.22724">916</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:newabbreviation"><code class="csfmt">\newabbreviation</code></a><span class="qquad"></span><a href="#sec:newabbr">§4.1</a>; <a href="#tab:abbrshortcuts">Table 4.1</a>; <a href="#wrglossary.80">5</a>, <a href="#wrglossary.368">16</a>, <a href="#wrglossary.1226">41</a>, <a href="#wrglossary.1306">43</a>–<a href="#wrglossary.1365">45</a>, <a href="#wrglossary.1410">47</a>, <a href="#wrglossary.1470">50</a>, <a href="#wrglossary.1809">63</a>, <a href="#wrglossary.1889">66</a>, <a href="#wrglossary.2254">82</a>, <a href="#wrglossary.2522">94</a>, <a href="#wrglossary.3026">115</a>, <a href="#wrglossary.3301">134</a>, <a href="#wrglossary.3994">161</a>, <a href="#wrglossary.4064">163</a>–<a href="#wrglossary.4160">167</a>, <a href="#wrglossary.4278">170</a>, <a href="#wrglossary.4567">181</a>, <a href="#wrglossary.4650">185</a>, <a href="#wrglossary.8255">323</a>, <a href="#wrglossary.9484">376</a>, <a href="#wrglossary.9742">386</a>, <a href="#wrglossary.11693">475</a>, <a href="#wrglossary.12039">492</a>, <a href="#wrglossary.12066">493</a>, <a href="#wrglossary.12105">496</a>–<a href="#wrglossary.12155">498</a>, <a href="#wrglossary.12572">514</a>, <a href="#wrglossary.14529">605</a>–<a href="#wrglossary.14725">611</a>, <a href="#wrglossary.15023">628</a>, <a href="#wrglossary.15689">653</a>, <a href="#wrglossary.15888">657</a>–<a href="#wrglossary.15960">659</a>, <a href="#wrglossary.16409">672</a>, <a href="#wrglossary.17161">699</a>, <a href="#wrglossary.17201">701</a>, <a href="#wrglossary.17697">717</a>, <a href="#wrglossary.17798">720</a>, <a href="#wrglossary.18095">732</a>, <a href="#wrglossary.18498">749</a>, <a href="#wrglossary.18646">753</a>, <a href="#wrglossary.18660">754</a>, <a href="#wrglossary.18828">761</a>, <a href="#wrglossary.18941">765</a>, <a href="#wrglossary.20956">846</a>, <a href="#wrglossary.21058">850</a>, <a href="#wrglossary.22213">899</a>, <span class="summarylocfmt"><a href="#wrglossary.22730">916</a></span>, <a href="#wrglossary.22744">917</a>, <a href="#wrglossary.23332">933</a>, <a href="#wrglossary.23653">944</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:newabbreviationhook"><code class="csfmt">\newabbreviationhook</code></a><span class="qquad"></span><a href="#sec:abbrvgeneralhooks">§4.1.5</a>; <a href="#wrglossary.1370">45</a>, <a href="#wrglossary.4039">162</a>, <span class="summarylocfmt"><a href="#wrglossary.22736">916</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:newabbreviationstyle"><code class="csfmt">\newabbreviationstyle</code></a><span class="qquad"></span><a href="#sec:newabbrvstyle">§4.5.3</a>; <a href="#wrglossary.1303">43</a>, <a href="#wrglossary.3949">159</a>–<a href="#wrglossary.4021">162</a>, <a href="#wrglossary.4276">170</a>, <span class="summarylocfmt"><a href="#wrglossary.22738">916</a></span>, <a href="#wrglossary.22754">917</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a><span class="qquad"></span><a href="#wrglossary.46">3</a>, <a href="#wrglossary.87">5</a>, <a href="#wrglossary.140">7</a>, <a href="#wrglossary.183">10</a>, <a href="#wrglossary.504">19</a>, <a href="#wrglossary.1282">42</a>–<a href="#wrglossary.1361">44</a>, <a href="#wrglossary.1739">59</a>, <a href="#wrglossary.1754">60</a>, <a href="#wrglossary.4550">181</a>, <a href="#wrglossary.12068">493</a>, <a href="#wrglossary.12124">496</a>–<a href="#wrglossary.12154">498</a>, <a href="#wrglossary.14679">609</a>, <a href="#wrglossary.15027">628</a>, <span class="summarylocfmt"><a href="#wrglossary.22740">917</a></span>, <a href="#wrglossary.23260">930</a>, <a href="#wrglossary.23331">933</a>, <a href="#wrglossary.23659">945</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:newacronymstyle"><code class="csfmt">\newacronymstyle</code></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><span class="qquad"></span><a href="#wrglossary.1302">43</a>, <span class="summarylocfmt"><a href="#wrglossary.22750">917</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:newcommand"><code class="csfmt">\newcommand</code></dfn><span class="qquad"></span><a href="#wrglossary.6379">250</a>, <a href="#wrglossary.6622">258</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:newdglsfield"><code class="csfmt">\newdglsfield</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13816">566</a>, <span class="summarylocfmt"><a href="#wrglossary.22755">917</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:newdglsfieldlike"><code class="csfmt">\newdglsfieldlike</code></a><span class="qquad"></span><a href="#sec:dgls">§11.5.7</a>; <a href="#wrglossary.13820">566</a>, <span class="summarylocfmt"><a href="#wrglossary.22758">917</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:newentry"><code class="csfmt">\newentry</code></a><span class="qquad"></span><a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.463">18</a>, <span class="summarylocfmt"><a href="#wrglossary.22763">917</a></span>, <a href="#wrglossary.23668">945</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a><span class="qquad"></span><a href="#wrglossary.6781">261</a>, <span class="summarylocfmt"><a href="#wrglossary.22767">917</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:newglossary*"><code class="csfmt">\newglossary*</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.22783">918</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a><span class="qquad"></span><a href="#wrglossary.366">16</a>–<a href="#wrglossary.464">18</a>, <a href="#wrglossary.923">32</a>, <a href="#wrglossary.1136">37</a>, <a href="#wrglossary.1229">41</a>, <a href="#wrglossary.1411">47</a>, <a href="#wrglossary.3992">161</a>, <a href="#wrglossary.4040">162</a>, <a href="#wrglossary.4171">167</a>, <a href="#wrglossary.7844">303</a>, <a href="#wrglossary.8254">323</a>, <a href="#wrglossary.12038">492</a>, <a href="#wrglossary.12064">493</a>, <a href="#wrglossary.14123">579</a>, <a href="#wrglossary.14528">605</a>, <a href="#wrglossary.14613">607</a>, <a href="#wrglossary.14680">609</a>, <a href="#wrglossary.22731">916</a>, <a href="#wrglossary.22764">917</a>, <span class="summarylocfmt"><a href="#wrglossary.22787">918</a></span>, <a href="#wrglossary.23556">942</a>, <a href="#wrglossary.23568">943</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:newignoredglossary"><code class="csfmt">\newignoredglossary</code></a><span class="qquad"></span><a href="#wrglossary.6565">256</a>, <a href="#wrglossary.9434">375</a>, <a href="#wrglossary.9451">376</a>, <a href="#wrglossary.14368">601</a>, <span class="summarylocfmt"><a href="#wrglossary.22791">918</a></span>, <a href="#wrglossary.23246">930</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:newignoredglossary*"><code class="csfmt">\newignoredglossary*</code></a><span class="qquad"></span><a href="#sec:glossaries">§8</a>; <a href="#wrglossary.9442">375</a>, <a href="#wrglossary.12307">503</a>, <span class="summarylocfmt"><a href="#wrglossary.22803">918</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:newnum"><code class="csfmt">\newnum</code></a><span class="qquad"></span><a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.468">19</a>, <span class="summarylocfmt"><a href="#wrglossary.22808">918</a></span>, <a href="#wrglossary.23670">945</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:newsym"><code class="csfmt">\newsym</code></a><span class="qquad"></span><a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.465">18</a>, <span class="summarylocfmt"><a href="#wrglossary.22813">919</a></span>, <a href="#wrglossary.23669">945</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:newterm"><code class="csfmt">\newterm</code></a><span class="qquad"></span><a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.246">12</a>, <a href="#wrglossary.12070">494</a>, <span class="summarylocfmt"><a href="#wrglossary.22818">919</a></span>, <a href="#wrglossary.23726">947</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:NoCaseChange"><code class="csfmt">\NoCaseChange</code></dfn><span class="qquad"></span><a href="#wrglossary.5195">203</a>, <a href="#wrglossary.5540">216</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.nbsp">non-breaking space (<code class="code">~</code>)</dfn><span class="qquad"></span><a href="#wrglossary.8399">329</a>, <a href="#wrglossary.8732">345</a>, <a href="#wrglossary.18803">759</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a><span class="qquad"></span><a href="#wrglossary.252">12</a>, <a href="#wrglossary.937">32</a>, <a href="#wrglossary.10571">415</a>, <a href="#wrglossary.10757">422</a>, <a href="#wrglossary.19433">781</a>, <a href="#wrglossary.22147">895</a>, <span class="summarylocfmt"><a href="#wrglossary.22827">919</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtrnopostpunc"><code class="csfmt">\glsxtrnopostpunc</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Nu"><code class="csfmt">\Nu</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13979">573</a>, <span class="summarylocfmt"><a href="#wrglossary.22832">919</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:null"><code class="csfmt">\null</code></dfn><span class="qquad"></span><a href="#wrglossary.121">6</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.numberlist">number list</dfn><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:locationlist">location list</a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index7602176 -->
+
+<section id="index7667712"><!-- start of section index7667712 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->O<div class="labellink"><a href="#index7667712">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><a href="#glo:Omicron"><code class="csfmt">\Omicron</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13980">573</a>, <span class="summarylocfmt"><a href="#wrglossary.22835">919</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:omicron"><code class="csfmt">\omicron</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13985">573</a>, <span class="summarylocfmt"><a href="#wrglossary.22838">919</a></span></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index7667712 -->
+
+<section id="index7733248"><!-- start of section index7733248 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->P<div class="labellink"><a href="#index7733248">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><dfn id="glo:ctr.page"><span class="ctrfmt">page</span> counter</dfn><span class="qquad"></span><a href="#wrglossary.731">25</a>, <a href="#wrglossary.831">27</a>, <a href="#wrglossary.6779">261</a>, <a href="#wrglossary.6905">264</a>, <a href="#wrglossary.8081">313</a>, <a href="#wrglossary.8143">317</a>, <a href="#wrglossary.12746">523</a>, <a href="#wrglossary.12914">529</a>, <a href="#wrglossary.12957">530</a>, <a href="#wrglossary.13532">555</a>, <a href="#wrglossary.13625">559</a>, <a href="#wrglossary.21739">877</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:pagelistname"><code class="csfmt">\pagelistname</code></a><span class="qquad"></span><a href="#wrglossary.11223">446</a>, <span class="summarylocfmt"><a href="#wrglossary.22841">920</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pageref"><code class="csfmt">\pageref</code></dfn><span class="qquad"></span><a href="#wrglossary.9496">377</a>, <a href="#wrglossary.21080">851</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pagestyle"><code class="csfmt">\pagestyle</code></dfn><span class="qquad"></span><a href="#wrglossary.5265">206</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:par"><code class="csfmt">\par</code></dfn><span class="qquad"></span><a href="#wrglossary.18603">752</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:parindent"><code class="csfmt">\parindent</code></dfn><span class="qquad"></span><a href="#wrglossary.11516">465</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:part"><code class="csfmt">\part</code></dfn><span class="qquad"></span><a href="#wrglossary.6792">261</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:ctr.part"><span class="ctrfmt">part</span> counter</dfn><span class="qquad"></span><a href="#wrglossary.6790">261</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pdfbookmark"><code class="csfmt">\pdfbookmark</code></dfn><span class="qquad"></span><a href="#wrglossary.11158">442</a>, <a href="#wrglossary.19568">788</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.period">period (<code class="code">.</code>)</dfn><span class="qquad"></span><div class="crossref"><span class="crossreftag">see</span> <a href="#glo:idx.fullstop">full stop (<code class="code">.</code>)</a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:PGLS"><code class="csfmt">\PGLS</code></a><span class="qquad"></span><a href="#wrglossary.9284">369</a>, <span class="summarylocfmt"><a href="#wrglossary.22845">920</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Pgls"><code class="csfmt">\Pgls</code></a><span class="qquad"></span><a href="#wrglossary.1634">55</a>, <a href="#wrglossary.5301">207</a>, <a href="#wrglossary.9252">368</a>, <span class="summarylocfmt"><a href="#wrglossary.22852">920</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:pgls"><code class="csfmt">\pgls</code></a><span class="qquad"></span><a href="#wrglossary.1619">55</a>, <a href="#wrglossary.9225">367</a>, <a href="#wrglossary.9234">368</a>, <a href="#wrglossary.22652">914</a>, <span class="summarylocfmt"><a href="#wrglossary.22859">920</a></span>, <a href="#wrglossary.22965">922</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:PGLSfmtlong"><code class="csfmt">\PGLSfmtlong</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5363">209</a>, <span class="summarylocfmt"><a href="#wrglossary.22865">920</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Pglsfmtlong"><code class="csfmt">\Pglsfmtlong</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5357">209</a>, <a href="#wrglossary.5620">219</a>, <span class="summarylocfmt"><a href="#wrglossary.22873">920</a></span>, <a href="#wrglossary.23079">925</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:pglsfmtlong"><code class="csfmt">\pglsfmtlong</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5349">209</a>, <span class="summarylocfmt"><a href="#wrglossary.22881">920</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:PGLSfmtlongpl"><code class="csfmt">\PGLSfmtlongpl</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5393">210</a>, <span class="summarylocfmt"><a href="#wrglossary.22888">921</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Pglsfmtlongpl"><code class="csfmt">\Pglsfmtlongpl</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5387">210</a>, <a href="#wrglossary.5622">219</a>, <span class="summarylocfmt"><a href="#wrglossary.22896">921</a></span>, <a href="#wrglossary.23083">925</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:pglsfmtlongpl"><code class="csfmt">\pglsfmtlongpl</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5379">210</a>, <span class="summarylocfmt"><a href="#wrglossary.22904">921</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:PGLSfmtshort"><code class="csfmt">\PGLSfmtshort</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5303">207</a>, <span class="summarylocfmt"><a href="#wrglossary.22912">921</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Pglsfmtshort"><code class="csfmt">\Pglsfmtshort</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5295">207</a>, <a href="#wrglossary.5610">219</a>, <span class="summarylocfmt"><a href="#wrglossary.22920">921</a></span>, <a href="#wrglossary.23087">925</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:pglsfmtshort"><code class="csfmt">\pglsfmtshort</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5287">207</a>, <a href="#wrglossary.5613">219</a>, <a href="#wrglossary.22918">921</a>, <span class="summarylocfmt"><a href="#wrglossary.22928">922</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:PGLSfmtshortpl"><code class="csfmt">\PGLSfmtshortpl</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5333">208</a>, <span class="summarylocfmt"><a href="#wrglossary.22936">922</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Pglsfmtshortpl"><code class="csfmt">\Pglsfmtshortpl</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5327">208</a>, <a href="#wrglossary.5618">219</a>, <span class="summarylocfmt"><a href="#wrglossary.22944">922</a></span>, <a href="#wrglossary.23091">925</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:pglsfmtshortpl"><code class="csfmt">\pglsfmtshortpl</code></a><span class="qquad"></span><a href="#sec:headingcommands">§5.3.2</a>; <a href="#wrglossary.5319">208</a>, <span class="summarylocfmt"><a href="#wrglossary.22952">922</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:PGLSpl"><code class="csfmt">\PGLSpl</code></a><span class="qquad"></span><a href="#wrglossary.9290">369</a>, <span class="summarylocfmt"><a href="#wrglossary.22960">922</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Pglspl"><code class="csfmt">\Pglspl</code></a><span class="qquad"></span><a href="#wrglossary.9260">368</a>, <span class="summarylocfmt"><a href="#wrglossary.22967">922</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:pglspl"><code class="csfmt">\pglspl</code></a><span class="qquad"></span><a href="#wrglossary.9240">368</a>, <a href="#wrglossary.22680">914</a>, <a href="#wrglossary.22704">915</a>, <span class="summarylocfmt"><a href="#wrglossary.22974">923</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:PGLSxtrlong"><code class="csfmt">\PGLSxtrlong</code></a><span class="qquad"></span><a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1674">56</a>, <span class="summarylocfmt"><a href="#wrglossary.22980">923</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Pglsxtrlong"><code class="csfmt">\Pglsxtrlong</code></a><span class="qquad"></span><a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1668">56</a>, <span class="summarylocfmt"><a href="#wrglossary.22988">923</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:pglsxtrlong"><code class="csfmt">\pglsxtrlong</code></a><span class="qquad"></span><a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1661">55</a>, <a href="#wrglossary.1672">56</a>, <span class="summarylocfmt"><a href="#wrglossary.22996">923</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:PGLSxtrlongpl"><code class="csfmt">\PGLSxtrlongpl</code></a><span class="qquad"></span><a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1693">56</a>, <span class="summarylocfmt"><a href="#wrglossary.23004">923</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Pglsxtrlongpl"><code class="csfmt">\Pglsxtrlongpl</code></a><span class="qquad"></span><a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1687">56</a>, <span class="summarylocfmt"><a href="#wrglossary.23012">923</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:pglsxtrlongpl"><code class="csfmt">\pglsxtrlongpl</code></a><span class="qquad"></span><a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1680">56</a>, <a href="#wrglossary.23010">923</a>, <span class="summarylocfmt"><a href="#wrglossary.23020">924</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:PGLSxtrshort"><code class="csfmt">\PGLSxtrshort</code></a><span class="qquad"></span><a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1636">55</a>, <span class="summarylocfmt"><a href="#wrglossary.23028">924</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Pglsxtrshort"><code class="csfmt">\Pglsxtrshort</code></a><span class="qquad"></span><a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1628">55</a>, <span class="summarylocfmt"><a href="#wrglossary.23036">924</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:pglsxtrshort"><code class="csfmt">\pglsxtrshort</code></a><span class="qquad"></span><a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1621">55</a>, <span class="summarylocfmt"><a href="#wrglossary.23044">924</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:PGLSxtrshortpl"><code class="csfmt">\PGLSxtrshortpl</code></a><span class="qquad"></span><a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1655">55</a>, <span class="summarylocfmt"><a href="#wrglossary.23052">924</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Pglsxtrshortpl"><code class="csfmt">\Pglsxtrshortpl</code></a><span class="qquad"></span><a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1649">55</a>, <span class="summarylocfmt"><a href="#wrglossary.23060">924</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:pglsxtrshortpl"><code class="csfmt">\pglsxtrshortpl</code></a><span class="qquad"></span><a href="#sec:abbrprefixes">§4.3.1</a>; <a href="#wrglossary.1642">55</a>, <a href="#wrglossary.23058">924</a>, <span class="summarylocfmt"><a href="#wrglossary.23068">925</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Pglsxtrtitlelong"><code class="csfmt">\Pglsxtrtitlelong</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5619">219</a>, <span class="summarylocfmt"><a href="#wrglossary.23076">925</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Pglsxtrtitlelongpl"><code class="csfmt">\Pglsxtrtitlelongpl</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5621">219</a>, <span class="summarylocfmt"><a href="#wrglossary.23080">925</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Pglsxtrtitleshort"><code class="csfmt">\Pglsxtrtitleshort</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5615">219</a>, <span class="summarylocfmt"><a href="#wrglossary.23084">925</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Pglsxtrtitleshortpl"><code class="csfmt">\Pglsxtrtitleshortpl</code></a><span class="qquad"></span><a href="#sec:headingsadvanced">§5.3.3</a>; <a href="#wrglossary.5617">219</a>, <span class="summarylocfmt"><a href="#wrglossary.23088">925</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.polyglossia"><span class="styfmt">polyglossia</span> package</dfn><span class="qquad"></span><a href="#wrglossary.14258">592</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:postdeschook">post-description hook</dfn><span class="qquad"></span><a href="#wrglossary.251">12</a>, <a href="#wrglossary.982">33</a>, <a href="#wrglossary.7098">269</a>, <a href="#wrglossary.7903">305</a>, <a href="#wrglossary.10265">402</a>, <a href="#wrglossary.10732">422</a>, <a href="#wrglossary.11095">439</a>, <a href="#wrglossary.11235">446</a>, <a href="#wrglossary.11454">459</a>, <a href="#wrglossary.11546">466</a>, <a href="#wrglossary.11556">468</a>, <a href="#wrglossary.14299">599</a>, <span class="termslocfmt"><a href="#wrglossary.14467">603</a></span>, <a href="#wrglossary.14555">605</a>, <a href="#wrglossary.15481">646</a>, <a href="#wrglossary.17172">700</a>, <a href="#wrglossary.17212">701</a>, <a href="#wrglossary.18217">737</a>, <a href="#wrglossary.18408">745</a>, <a href="#wrglossary.21041">849</a>, <a href="#wrglossary.21106">852</a>, <a href="#wrglossary.21120">853</a>, <a href="#wrglossary.22830">919</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:postlinkhook">post-link hook</dfn><span class="qquad"></span><a href="#wrglossary.1499">51</a>, <a href="#wrglossary.1602">54</a>, <a href="#wrglossary.1818">63</a>, <a href="#wrglossary.2431">90</a>, <a href="#wrglossary.2699">101</a>, <a href="#wrglossary.2754">104</a>–<a href="#wrglossary.2817">107</a>, <a href="#wrglossary.2872">109</a>–<a href="#wrglossary.2928">111</a>, <a href="#wrglossary.3042">116</a>, <a href="#wrglossary.3059">117</a>, <a href="#wrglossary.3523">142</a>, <a href="#wrglossary.3567">144</a>, <a href="#wrglossary.3713">150</a>–<a href="#wrglossary.3833">153</a>, <a href="#wrglossary.3976">160</a>, <a href="#wrglossary.4096">165</a>, <a href="#wrglossary.4138">166</a>, <a href="#wrglossary.4592">183</a>, <a href="#wrglossary.4631">185</a>, <a href="#wrglossary.5907">230</a>, <a href="#wrglossary.5927">231</a>, <a href="#wrglossary.5986">234</a>–<a href="#wrglossary.6051">236</a>, <a href="#wrglossary.6093">238</a>, <a href="#wrglossary.6132">239</a>, <a href="#wrglossary.6263">245</a>–<a href="#wrglossary.6318">247</a>, <a href="#wrglossary.6385">251</a>–<a href="#wrglossary.6491">254</a>, <a href="#wrglossary.7335">279</a>, <a href="#wrglossary.7367">281</a>–<a href="#wrglossary.7416">283</a>, <a href="#wrglossary.7698">296</a>, <a href="#wrglossary.8431">330</a>, <a href="#wrglossary.8511">334</a>, <a href="#wrglossary.8806">349</a>, <a href="#wrglossary.8893">356</a>, <a href="#wrglossary.8908">357</a>, <a href="#wrglossary.12084">495</a>, <a href="#wrglossary.12802">525</a>, <a href="#wrglossary.12896">528</a>, <a href="#wrglossary.14303">599</a>, <a href="#wrglossary.14355">600</a>, <span class="termslocfmt"><a href="#wrglossary.14476">603</a></span>, <a href="#wrglossary.14568">606</a>, <a href="#wrglossary.14912">621</a>, <a href="#wrglossary.15079">630</a>, <a href="#wrglossary.15166">633</a>, <a href="#wrglossary.15317">639</a>, <a href="#wrglossary.15366">641</a>, <a href="#wrglossary.17130">698</a>, <a href="#wrglossary.17197">700</a>, <a href="#wrglossary.17216">701</a>, <a href="#wrglossary.18046">731</a>–<a href="#wrglossary.18101">733</a>, <a href="#wrglossary.18702">755</a>, <a href="#wrglossary.19683">793</a>, <a href="#wrglossary.19750">796</a>, <a href="#wrglossary.20430">823</a>, <a href="#wrglossary.21098">852</a>–<a href="#wrglossary.21193">856</a>, <a href="#wrglossary.23455">938</a>, <a href="#wrglossary.23469">939</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:postnamehook">post-name hook</dfn><span class="qquad"></span><a href="#wrglossary.10264">402</a>, <a href="#wrglossary.10548">414</a>, <a href="#wrglossary.10688">419</a>–<a href="#wrglossary.10709">421</a>, <a href="#wrglossary.11228">446</a>, <a href="#wrglossary.11447">459</a>, <a href="#wrglossary.12243">501</a>, <a href="#wrglossary.14307">599</a>, <span class="termslocfmt"><a href="#wrglossary.14482">603</a></span>, <a href="#wrglossary.14522">604</a>, <a href="#wrglossary.14637">608</a>, <a href="#wrglossary.17220">701</a>, <a href="#wrglossary.21214">856</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:preto"><code class="csfmt">\preto</code></dfn><span class="qquad"></span><a href="#wrglossary.4092">165</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:pretoglossarypreamble"><code class="csfmt">\pretoglossarypreamble</code></a><span class="qquad"></span><a href="#sec:glospreamble">§8.2</a>; <a href="#wrglossary.9509">377</a>, <span class="summarylocfmt"><a href="#wrglossary.23092">925</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:unsrtfam">print <span class="qt">“unsrt”</span> glossary commands (and environment)</dfn><span class="qquad"></span><a href="#wrglossary.684">24</a>, <a href="#wrglossary.1011">34</a>, <a href="#wrglossary.1034">35</a>, <a href="#wrglossary.3302">134</a>, <a href="#wrglossary.3596">145</a>, <a href="#wrglossary.3673">148</a>, <a href="#wrglossary.3677">149</a>, <a href="#wrglossary.3881">156</a>, <a href="#wrglossary.4991">196</a>, <a href="#wrglossary.9456">376</a>, <a href="#wrglossary.9516">377</a>, <a href="#wrglossary.9562">379</a>, <a href="#wrglossary.9653">382</a>, <a href="#wrglossary.9733">386</a>, <a href="#wrglossary.9843">389</a>, <a href="#wrglossary.10130">397</a>, <a href="#wrglossary.10783">423</a>, <a href="#wrglossary.10824">425</a>, <a href="#wrglossary.11281">448</a>, <a href="#wrglossary.13055">534</a>, <a href="#wrglossary.14363">601</a>, <span class="termslocfmt"><a href="#wrglossary.14490">603</a></span>, <a href="#wrglossary.14606">607</a>, <a href="#wrglossary.14792">614</a>, <a href="#wrglossary.14960">624</a>, <a href="#wrglossary.14979">625</a>, <a href="#wrglossary.15641">652</a>, <a href="#wrglossary.17175">700</a>, <a href="#wrglossary.18869">762</a>, <a href="#wrglossary.19447">782</a>, <a href="#wrglossary.19675">793</a>, <a href="#wrglossary.20598">831</a>, <a href="#wrglossary.21030">849</a>, <a href="#wrglossary.21878">883</a>, <a href="#wrglossary.22801">918</a>, <a href="#wrglossary.23187">928</a>, <a href="#wrglossary.23633">944</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.printglossopt">print [unsrt|noidx] glossary options</dfn><span class="qquad"></span><a href="#wrglossary.9512">377</a>, <span class="summarylocfmt"><a href="#wrglossary.14948">624</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printgloss.entrycounter"><span class="csoptfmt">entrycounter</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.14955">624</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printgloss.flatten"><span class="csoptfmt">flatten</span></a><span class="qquad"></span><a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9564">379</a>, <a href="#wrglossary.9959">391</a>, <a href="#wrglossary.10234">400</a>–<a href="#wrglossary.10274">402</a>, <a href="#wrglossary.14365">601</a>, <span class="summarylocfmt"><a href="#wrglossary.14957">624</a></span>, <a href="#wrglossary.17184">700</a>, <a href="#wrglossary.21883">883</a>, <a href="#wrglossary.22191">897</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printgloss.groups"><span class="csoptfmt">groups</span></a><span class="qquad"></span><a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9571">379</a>, <a href="#wrglossary.9714">385</a>, <a href="#wrglossary.10246">401</a>, <span class="summarylocfmt"><a href="#wrglossary.14962">624</a></span>, <a href="#wrglossary.17981">728</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printgloss.label"><span class="csoptfmt">label</span></a><span class="qquad"></span><a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9548">378</a>, <span class="summarylocfmt"><a href="#wrglossary.14970">624</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printgloss.leveloffset"><span class="csoptfmt">leveloffset</span></a><span class="qquad"></span><a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9556">379</a>, <a href="#wrglossary.10233">400</a>, <a href="#wrglossary.10242">401</a>, <a href="#wrglossary.14364">601</a>, <span class="summarylocfmt"><a href="#wrglossary.14974">624</a></span>, <a href="#wrglossary.17177">700</a>, <a href="#wrglossary.21882">883</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printgloss.nogroupskip"><span class="csoptfmt">nogroupskip</span></a><span class="qquad"></span><a href="#wrglossary.9732">385</a>, <a href="#wrglossary.10907">428</a>, <a href="#wrglossary.11586">469</a>, <span class="summarylocfmt"><a href="#wrglossary.14981">625</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printgloss.nonumberlist"><span class="csoptfmt">nonumberlist</span></a><span class="qquad"></span><a href="#wrglossary.1040">35</a>, <a href="#wrglossary.11587">469</a>, <a href="#wrglossary.14457">602</a>, <span class="summarylocfmt"><a href="#wrglossary.14984">625</a></span>, <a href="#wrglossary.23759">947</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printgloss.nopostdot"><span class="csoptfmt">nopostdot</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.14990">625</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printgloss.numberedsection"><span class="csoptfmt">numberedsection</span></a><span class="qquad"></span><a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9537">378</a>, <span class="summarylocfmt"><a href="#wrglossary.14991">625</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printgloss.postamble"><span class="csoptfmt">postamble</span></a><span class="qquad"></span><a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9637">382</a>, <span class="summarylocfmt"><a href="#wrglossary.14994">625</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printgloss.preamble"><span class="csoptfmt">preamble</span></a><span class="qquad"></span><a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9635">382</a>, <span class="summarylocfmt"><a href="#wrglossary.14997">625</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printgloss.prefix"><span class="csoptfmt">prefix</span></a><span class="qquad"></span><a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.6575">256</a>, <a href="#wrglossary.9576">379</a>, <a href="#wrglossary.9629">382</a>, <span class="summarylocfmt"><a href="#wrglossary.15000">626</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="qquad"></span><a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9517">377</a>, <span class="summarylocfmt"><a href="#wrglossary.15003">626</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printgloss.style"><span class="csoptfmt">style</span></a><span class="qquad"></span><a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9544">378</a>, <a href="#wrglossary.11588">469</a>, <span class="summarylocfmt"><a href="#wrglossary.15006">626</a></span>, <a href="#wrglossary.15457">645</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printgloss.subentrycounter"><span class="csoptfmt">subentrycounter</span></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.15008">626</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printgloss.target"><span class="csoptfmt">target</span></a><span class="qquad"></span><a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9632">382</a>, <span class="summarylocfmt"><a href="#wrglossary.15010">626</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printgloss.targetnameprefix"><span class="csoptfmt">targetnameprefix</span></a><span class="qquad"></span><a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9615">381</a>, <a href="#wrglossary.9628">382</a>, <a href="#wrglossary.10464">409</a>, <span class="summarylocfmt"><a href="#wrglossary.15014">626</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a><span class="qquad"></span><a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9449">376</a>, <a href="#wrglossary.9525">378</a>, <a href="#wrglossary.10308">404</a>, <a href="#wrglossary.11566">468</a>, <a href="#wrglossary.14260">592</a>, <span class="summarylocfmt"><a href="#wrglossary.15016">626</a></span>, <a href="#wrglossary.22773">917</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printgloss.toctitle"><span class="csoptfmt">toctitle</span></a><span class="qquad"></span><a href="#sec:printglossopts">§8.3</a>; <a href="#wrglossary.9531">378</a>, <a href="#wrglossary.11567">468</a>, <span class="summarylocfmt"><a href="#wrglossary.15017">627</a></span></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="qquad"></span><a href="#wrglossary.9800">387</a>, <a href="#wrglossary.10305">404</a>, <a href="#wrglossary.10504">411</a>, <span class="summarylocfmt"><a href="#wrglossary.15018">627</a></span>, <a href="#wrglossary.23098">926</a>, <a href="#wrglossary.23143">927</a>, <a href="#wrglossary.23217">929</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx0"><a href="#glo:printabbreviations"><code class="csfmt">\printabbreviations</code></a><span class="qquad"></span><a href="#sec:gloslistopts">§2.1</a>; <a href="#wrglossary.164">9</a>, <span class="summarylocfmt"><a href="#wrglossary.23095">926</a></span>, <a href="#wrglossary.23507">941</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printacronyms"><code class="csfmt">\printacronyms</code></a><span class="qquad"></span><a href="#wrglossary.227">11</a>, <span class="summarylocfmt"><a href="#wrglossary.23100">926</a></span>, <a href="#wrglossary.23703">946</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a><span class="qquad"></span><a href="#wrglossary.105">6</a>, <a href="#wrglossary.759">25</a>, <a href="#wrglossary.14370">601</a>, <a href="#wrglossary.22794">918</a>, <span class="summarylocfmt"><a href="#wrglossary.23106">926</a></span>, <a href="#wrglossary.23625">944</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a><span class="qquad"></span><a href="#wrglossary.37">3</a>, <a href="#wrglossary.99">5</a>, <a href="#wrglossary.106">6</a>, <a href="#wrglossary.744">25</a>, <a href="#wrglossary.9409">375</a>–<a href="#wrglossary.9513">377</a>, <a href="#wrglossary.9642">382</a>, <a href="#wrglossary.9667">383</a>, <a href="#wrglossary.10154">398</a>, <a href="#wrglossary.10205">399</a>, <a href="#wrglossary.10551">414</a>, <a href="#wrglossary.10787">423</a>, <a href="#wrglossary.10908">428</a>, <a href="#wrglossary.12568">514</a>, <a href="#wrglossary.14144">580</a>, <a href="#wrglossary.14215">588</a>, <a href="#wrglossary.14347">600</a>, <a href="#wrglossary.14950">624</a>, <a href="#wrglossary.16490">676</a>, <a href="#wrglossary.18871">762</a>, <a href="#wrglossary.21288">859</a>, <a href="#wrglossary.22240">900</a>, <a href="#wrglossary.22772">917</a>, <a href="#wrglossary.22800">918</a>, <span class="summarylocfmt"><a href="#wrglossary.23112">926</a></span>, <a href="#wrglossary.23142">927</a>, <a href="#wrglossary.23624">944</a>, <a href="#wrglossary.23769">948</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printindex"><code class="csfmt">\printindex</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23120">926</a></span>, <a href="#wrglossary.23725">947</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printnoidxglossaries"><code class="csfmt">\printnoidxglossaries</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23125">926</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a><span class="qquad"></span><a href="#wrglossary.1033">35</a>, <a href="#wrglossary.9405">375</a>, <a href="#wrglossary.9446">376</a>, <a href="#wrglossary.9518">378</a>, <a href="#wrglossary.9644">382</a>, <a href="#wrglossary.9668">383</a>, <a href="#wrglossary.9700">385</a>, <a href="#wrglossary.9819">388</a>, <a href="#wrglossary.10139">398</a>, <a href="#wrglossary.10786">423</a>, <a href="#wrglossary.10804">424</a>, <a href="#wrglossary.10851">427</a>, <a href="#wrglossary.10905">428</a>, <a href="#wrglossary.14216">588</a>, <a href="#wrglossary.14789">614</a>, <a href="#wrglossary.14951">624</a>, <a href="#wrglossary.15004">626</a>, <a href="#wrglossary.18872">762</a>, <a href="#wrglossary.21031">849</a>, <a href="#wrglossary.22242">900</a>, <span class="summarylocfmt"><a href="#wrglossary.23131">926</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printnumbers"><code class="csfmt">\printnumbers</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23139">927</a></span>, <a href="#wrglossary.23798">948</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printsymbols"><code class="csfmt">\printsymbols</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23144">927</a></span>, <a href="#wrglossary.23850">950</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printunsrtabbreviations"><code class="csfmt">\printunsrtabbreviations</code></a><span class="qquad"></span><a href="#sec:printunsrtshortcuts">§11.5.1</a>; <a href="#wrglossary.169">9</a>, <a href="#wrglossary.13061">534</a>, <span class="summarylocfmt"><a href="#wrglossary.23149">927</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printunsrtacronyms"><code class="csfmt">\printunsrtacronyms</code></a><span class="qquad"></span><a href="#sec:printunsrtshortcuts">§11.5.1</a>; <a href="#wrglossary.229">11</a>, <a href="#wrglossary.13064">534</a>, <span class="summarylocfmt"><a href="#wrglossary.23156">927</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printunsrtglossaries"><code class="csfmt">\printunsrtglossaries</code></a><span class="qquad"></span><a href="#sec:printunsrt">§8.4</a>; <a href="#wrglossary.9444">376</a>, <a href="#wrglossary.9670">383</a>, <a href="#wrglossary.14371">601</a>, <a href="#wrglossary.14494">603</a>, <span class="summarylocfmt"><a href="#wrglossary.23163">927</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printunsrtglossary"><code class="csfmt">\printunsrtglossary</code></a><span class="qquad"></span><a href="#sec:printunsrt">§8.4</a>; <a href="#wrglossary.170">9</a>, <a href="#wrglossary.206">11</a>, <a href="#wrglossary.244">12</a>, <a href="#wrglossary.685">24</a>, <a href="#wrglossary.4560">181</a>, <a href="#wrglossary.4986">196</a>, <a href="#wrglossary.9440">375</a>–<a href="#wrglossary.9519">378</a>, <a href="#wrglossary.9648">382</a>, <a href="#wrglossary.9664">383</a>, <a href="#wrglossary.9699">385</a>–<a href="#wrglossary.9807">388</a>, <a href="#wrglossary.10005">394</a>, <a href="#wrglossary.10157">398</a>, <a href="#wrglossary.10199">399</a>, <a href="#wrglossary.10297">403</a>–<a href="#wrglossary.10345">405</a>, <a href="#wrglossary.10904">428</a>, <a href="#wrglossary.11568">468</a>–<a href="#wrglossary.11616">470</a>, <a href="#wrglossary.12576">514</a>, <a href="#wrglossary.13058">534</a>, <a href="#wrglossary.14348">600</a>, <a href="#wrglossary.14373">601</a>, <a href="#wrglossary.14493">603</a>, <a href="#wrglossary.14952">624</a>, <a href="#wrglossary.22802">918</a>, <span class="summarylocfmt"><a href="#wrglossary.23169">927</a></span>, <a href="#wrglossary.23184">928</a>–<a href="#wrglossary.23242">930</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printunsrtglossary*"><code class="csfmt">\printunsrtglossary*</code></a><span class="qquad"></span><a href="#sec:printunsrt">§8.4</a>; <a href="#wrglossary.9657">383</a>, <span class="summarylocfmt"><a href="#wrglossary.23182">928</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printunsrtglossaryentryprocesshook"><code class="csfmt">\printunsrtglossaryentryprocesshook</code></a><span class="qquad"></span><a href="#sec:printunsrtadvanced">§8.4.3</a>; <a href="#wrglossary.10243">401</a>, <a href="#wrglossary.10405">407</a>, <a href="#wrglossary.17183">700</a>, <span class="summarylocfmt"><a href="#wrglossary.23185">928</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printunsrtglossaryhandler"><code class="csfmt">\printunsrtglossaryhandler</code></a><span class="qquad"></span><a href="#sec:printunsrtadvanced">§8.4.3</a>; <a href="#wrglossary.10267">402</a>, <a href="#wrglossary.10407">407</a>, <span class="summarylocfmt"><a href="#wrglossary.23189">928</a></span>, <a href="#wrglossary.23225">929</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printunsrtglossarypredoglossary"><code class="csfmt">\printunsrtglossarypredoglossary</code></a><span class="qquad"></span><a href="#sec:printunsrtadvanced">§8.4.3</a>; <a href="#wrglossary.10257">401</a>, <a href="#wrglossary.15642">652</a>, <span class="summarylocfmt"><a href="#wrglossary.23192">928</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printunsrtglossaryskipentry"><code class="csfmt">\printunsrtglossaryskipentry</code></a><span class="qquad"></span><a href="#sec:printunsrtadvanced">§8.4.3</a>; <a href="#wrglossary.10244">401</a>, <a href="#wrglossary.10406">407</a>, <span class="summarylocfmt"><a href="#wrglossary.23196">928</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printunsrtglossaryunit"><code class="csfmt">\printunsrtglossaryunit</code></a><span class="qquad"></span><a href="#sec:printunsrtunit">§8.4.3.2</a>; <a href="#wrglossary.10447">408</a>, <a href="#wrglossary.10472">410</a>, <a href="#wrglossary.10524">412</a>, <span class="summarylocfmt"><a href="#wrglossary.23199">928</a></span>, <a href="#wrglossary.23206">929</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printunsrtglossaryunitpostskip"><code class="csfmt">\printunsrtglossaryunitpostskip</code></a><span class="qquad"></span><a href="#sec:printunsrtunit">§8.4.3.2</a>; <a href="#wrglossary.10461">409</a>, <span class="summarylocfmt"><a href="#wrglossary.23203">929</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printunsrtglossaryunitsetup"><code class="csfmt">\printunsrtglossaryunitsetup</code></a><span class="qquad"></span><a href="#sec:printunsrtunit">§8.4.3.2</a>; <a href="#wrglossary.10452">409</a>, <span class="summarylocfmt"><a href="#wrglossary.23207">929</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:env.printunsrtglossarywrap"><span class="envfmt">printunsrtglossarywrap</span> environment</a><span class="qquad"></span><a href="#sec:printunsrtinner">§8.4.3.1</a>; <a href="#wrglossary.9515">377</a>–<a href="#wrglossary.9563">379</a>, <a href="#wrglossary.9654">382</a>, <a href="#wrglossary.10302">404</a>, <a href="#wrglossary.14503">603</a>, <a href="#wrglossary.14954">624</a>, <a href="#wrglossary.14980">625</a>, <a href="#wrglossary.23223">929</a>, <span class="summarylocfmt"><a href="#wrglossary.23477">940</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printunsrtindex"><code class="csfmt">\printunsrtindex</code></a><span class="qquad"></span><a href="#sec:printunsrtshortcuts">§11.5.1</a>; <a href="#wrglossary.243">12</a>, <a href="#wrglossary.13075">535</a>, <span class="summarylocfmt"><a href="#wrglossary.23210">929</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printunsrtinnerglossary"><code class="csfmt">\printunsrtinnerglossary</code></a><span class="qquad"></span><a href="#sec:printunsrtinner">§8.4.3.1</a>; <a href="#wrglossary.9520">378</a>, <a href="#wrglossary.10298">403</a>, <a href="#wrglossary.10344">405</a>, <a href="#wrglossary.14374">601</a>, <a href="#wrglossary.14496">603</a>, <a href="#wrglossary.14953">624</a>, <a href="#wrglossary.16483">675</a>, <span class="summarylocfmt"><a href="#wrglossary.23218">929</a></span>, <a href="#wrglossary.23481">940</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printunsrtnumbers"><code class="csfmt">\printunsrtnumbers</code></a><span class="qquad"></span><a href="#sec:printunsrtshortcuts">§11.5.1</a>; <a href="#wrglossary.223">11</a>, <a href="#wrglossary.13072">534</a>, <span class="summarylocfmt"><a href="#wrglossary.23226">929</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printunsrtsymbols"><code class="csfmt">\printunsrtsymbols</code></a><span class="qquad"></span><a href="#sec:printunsrtshortcuts">§11.5.1</a>; <a href="#wrglossary.205">10</a>, <a href="#wrglossary.13069">534</a>, <span class="summarylocfmt"><a href="#wrglossary.23234">929</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:printunsrttable"><code class="csfmt">\printunsrttable</code></a><span class="qquad"></span><a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11564">468</a>, <a href="#wrglossary.15618">650</a>, <a href="#wrglossary.18922">764</a>, <span class="summarylocfmt"><a href="#wrglossary.23240">930</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printunsrttab.block-style"><span class="csoptfmt">block-style</span></a><span class="qquad"></span><a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11617">470</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.printunsrttab.block-style.desc-name"><span class="optfmt">desc-name</span></a><span class="qquad"></span><a href="#wrglossary.11620">471</a>, <a href="#wrglossary.11638">472</a></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.printunsrttab.block-style.name-desc-symbol"><span class="optfmt">name-desc-symbol</span></a><span class="qquad"></span><a href="#wrglossary.11628">471</a></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.printunsrttab.block-style.name-desc"><span class="optfmt">name-desc</span></a><span class="qquad"></span><a href="#wrglossary.11592">469</a>, <a href="#wrglossary.11618">471</a>, <a href="#wrglossary.11634">472</a></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.printunsrttab.block-style.name-other"><span class="optfmt">name-other</span></a><span class="qquad"></span><a href="#wrglossary.11632">472</a></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.printunsrttab.block-style.name-symbol-desc"><span class="optfmt">name-symbol-desc</span></a><span class="qquad"></span><a href="#wrglossary.11598">469</a>, <a href="#wrglossary.11626">471</a></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.printunsrttab.block-style.name-symbol"><span class="optfmt">name-symbol</span></a><span class="qquad"></span><a href="#wrglossary.11601">469</a>, <a href="#wrglossary.11622">471</a></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.printunsrttab.block-style.name"><span class="optfmt">name</span></a><span class="qquad"></span><a href="#wrglossary.11630">471</a>, <a href="#wrglossary.11656">473</a></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.printunsrttab.block-style.other-name"><span class="optfmt">other-name</span></a><span class="qquad"></span><a href="#wrglossary.11636">472</a></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.printunsrttab.block-style.other-symbol"><span class="optfmt">other-symbol</span></a><span class="qquad"></span><a href="#wrglossary.11643">472</a></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.printunsrttab.block-style.symbol-name"><span class="optfmt">symbol-name</span></a><span class="qquad"></span><a href="#wrglossary.11583">469</a>, <a href="#wrglossary.11624">471</a></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx2"><a href="#glo:optval.printunsrttab.block-style.symbol-other"><span class="optfmt">symbol-other</span></a><span class="qquad"></span><a href="#wrglossary.11584">469</a>, <a href="#wrglossary.11640">472</a></div><!-- end of nlctuserguideidx2 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printunsrttab.blocks"><span class="csoptfmt">blocks</span></a><span class="qquad"></span><a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11591">469</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printunsrttab.blocksep"><span class="csoptfmt">blocksep</span></a><span class="qquad"></span><a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11610">470</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printunsrttab.header"><span class="csoptfmt">header</span></a><span class="qquad"></span><a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11593">469</a>, <a href="#wrglossary.11608">470</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printunsrttab.init"><span class="csoptfmt">init</span></a><span class="qquad"></span><a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11615">470</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printunsrttab.other"><span class="csoptfmt">other</span></a><span class="qquad"></span><a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11582">469</a>, <a href="#wrglossary.11613">470</a>, <a href="#wrglossary.11635">472</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printunsrttab.par"><span class="csoptfmt">par</span></a><span class="qquad"></span><a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11577">468</a>, <a href="#wrglossary.11611">470</a>, <a href="#wrglossary.11658">473</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><a href="#glo:opt.printunsrttab.rules"><span class="csoptfmt">rules</span></a><span class="qquad"></span><a href="#sec:table">§8.7.4</a>; <a href="#wrglossary.11606">470</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx0"><dfn id="glo:protect"><code class="csfmt">\protect</code></dfn><span class="qquad"></span><a href="#wrglossary.7545">289</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:providecommand"><code class="csfmt">\providecommand</code></dfn><span class="qquad"></span><a href="#wrglossary.13487">554</a>, <a href="#wrglossary.13944">572</a>, <a href="#wrglossary.13986">573</a>, <a href="#wrglossary.16113">662</a>, <a href="#wrglossary.16166">663</a>, <a href="#wrglossary.16250">667</a>, <a href="#wrglossary.16378">671</a>, <a href="#wrglossary.16403">672</a>, <a href="#wrglossary.21267">858</a>, <a href="#wrglossary.22203">898</a>, <a href="#wrglossary.22713">915</a>, <a href="#wrglossary.22834">919</a>, <a href="#wrglossary.23318">932</a>, <a href="#wrglossary.23366">934</a>–<a href="#wrglossary.23421">937</a>, <a href="#wrglossary.23476">939</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:provideignoredglossary"><code class="csfmt">\provideignoredglossary</code></a><span class="qquad"></span><a href="#sec:glossaries">§8</a>; <a href="#wrglossary.9450">376</a>, <a href="#wrglossary.13483">554</a>, <span class="summarylocfmt"><a href="#wrglossary.23244">930</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:providemultiglossaryentry"><code class="csfmt">\providemultiglossaryentry</code></a><span class="qquad"></span><a href="#sec:multientries">§7</a>; <a href="#wrglossary.8270">324</a>, <a href="#wrglossary.9353">372</a>, <span class="summarylocfmt"><a href="#wrglossary.23248">930</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ProvidesGlossariesExtraLang"><code class="csfmt">\ProvidesGlossariesExtraLang</code></a><span class="qquad"></span><a href="#sec:lang">§15</a>; <a href="#wrglossary.14273">593</a>, <span class="summarylocfmt"><a href="#wrglossary.23251">930</a></span></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index7733248 -->
+
+<section id="index7798784"><!-- start of section index7798784 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->Q<div class="labellink"><a href="#index7798784">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><dfn id="glo:quotechar"><code class="csfmt">\quotechar</code></dfn><span class="qquad"></span><a href="#wrglossary.14081">576</a></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index7798784 -->
+
+<section id="index7864320"><!-- start of section index7864320 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->R<div class="labellink"><a href="#index7864320">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><dfn id="glo:ref"><code class="csfmt">\ref</code></dfn><span class="qquad"></span><a href="#wrglossary.9490">377</a>, <a href="#wrglossary.18726">756</a>, <a href="#wrglossary.21081">851</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:refstepcounter"><code class="csfmt">\refstepcounter</code></dfn><span class="qquad"></span><a href="#wrglossary.726">25</a>, <a href="#wrglossary.802">27</a>, <a href="#wrglossary.8157">317</a>, <a href="#wrglossary.13553">556</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:relax"><code class="csfmt">\relax</code></dfn><span class="qquad"></span><a href="#wrglossary.7270">277</a>, <a href="#wrglossary.7585">291</a>, <a href="#wrglossary.8398">329</a>, <a href="#wrglossary.12341">505</a>, <a href="#wrglossary.13803">566</a>, <a href="#wrglossary.17437">707</a>, <a href="#wrglossary.19461">782</a>, <a href="#wrglossary.21377">863</a>, <a href="#wrglossary.21955">888</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.relsize"><span class="styfmt">relsize</span> package</dfn><span class="qquad"></span><a href="#wrglossary.1811">63</a>, <a href="#wrglossary.3917">157</a>, <a href="#wrglossary.15126">632</a>, <a href="#wrglossary.15191">634</a>, <a href="#wrglossary.15234">636</a>, <a href="#wrglossary.15414">643</a>, <a href="#wrglossary.15444">644</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:renewabbreviationstyle"><code class="csfmt">\renewabbreviationstyle</code></a><span class="qquad"></span><a href="#sec:newabbrvstyle">§4.5.3</a>; <a href="#wrglossary.3989">161</a>, <span class="summarylocfmt"><a href="#wrglossary.23254">930</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:newabbreviationstyle"><code class="csfmt">\newabbreviationstyle</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:renewcommand"><code class="csfmt">\renewcommand</code></dfn><span class="qquad"></span><a href="#wrglossary.6380">250</a>, <a href="#wrglossary.10743">422</a>, <a href="#wrglossary.13947">572</a>, <a href="#wrglossary.13959">573</a>, <a href="#wrglossary.18732">756</a>, <a href="#wrglossary.21268">858</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:RequireGlossariesExtraLang"><code class="csfmt">\RequireGlossariesExtraLang</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23256">930</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:resourcefile">resource file</dfn><span class="qquad"></span><a href="#wrglossary.13949">572</a>, <span class="termslocfmt"><a href="#wrglossary.14506">603</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.resourceopt">resource options</dfn><span class="qquad"></span><a href="#wrglossary.683">24</a>–<a href="#wrglossary.787">26</a>, <a href="#wrglossary.9350">372</a>, <a href="#wrglossary.10667">419</a>, <a href="#wrglossary.13081">535</a>, <a href="#wrglossary.13142">536</a>, <a href="#wrglossary.13498">554</a>, <a href="#wrglossary.13691">561</a>, <a href="#wrglossary.13732">563</a>, <a href="#wrglossary.14500">603</a>, <a href="#wrglossary.14988">625</a>, <a href="#wrglossary.17082">696</a>, <a href="#wrglossary.19375">780</a>, <a href="#wrglossary.19693">794</a>, <a href="#wrglossary.23372">935</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.alias-loc"><span class="csoptfmt">alias-loc</span></dfn><span class="qquad"></span><a href="#wrglossary.7030">267</a>, <a href="#wrglossary.7285">278</a>, <a href="#wrglossary.7317">279</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.alias"><span class="csoptfmt">alias</span></dfn><span class="qquad"></span><a href="#wrglossary.7284">278</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.category"><span class="csoptfmt">category</span></dfn><span class="qquad"></span><a href="#wrglossary.12890">528</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.combine-dual-locations"><span class="csoptfmt">combine-dual-locations</span></dfn><span class="qquad"></span><a href="#wrglossary.13895">570</a>, <a href="#wrglossary.13905">571</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.compound-adjust-name"><span class="csoptfmt">compound-adjust-name</span></dfn><span class="qquad"></span><a href="#wrglossary.9356">372</a>, <a href="#wrglossary.20901">843</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.description-case-change"><span class="csoptfmt">description-case-change</span></dfn><span class="qquad"></span><a href="#wrglossary.12230">500</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.dual-backlink"><span class="csoptfmt">dual-backlink</span></dfn><span class="qquad"></span><a href="#wrglossary.13733">563</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.dual-field"><span class="csoptfmt">dual-field</span></dfn><span class="qquad"></span><a href="#wrglossary.13690">561</a>, <a href="#wrglossary.13700">562</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.dual-prefix"><span class="csoptfmt">dual-prefix</span></dfn><span class="qquad"></span><a href="#wrglossary.13863">568</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.dual-type"><span class="csoptfmt">dual-type</span></dfn><span class="qquad"></span><a href="#wrglossary.13685">561</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.entry-type-aliases"><span class="csoptfmt">entry-type-aliases</span></dfn><span class="qquad"></span><a href="#wrglossary.13094">535</a>, <a href="#wrglossary.19553">787</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.field-aliases"><span class="csoptfmt">field-aliases</span></dfn><span class="qquad"></span><a href="#wrglossary.13140">536</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.flatten"><span class="csoptfmt">flatten</span></dfn><span class="qquad"></span><a href="#wrglossary.9569">379</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.group-level"><span class="csoptfmt">group-level</span></dfn><span class="qquad"></span><a href="#wrglossary.9963">391</a>, <a href="#wrglossary.10121">396</a>, <a href="#wrglossary.11530">465</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.group"><span class="csoptfmt">group</span></dfn><span class="qquad"></span><a href="#wrglossary.12661">519</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.ignore-fields"><span class="csoptfmt">ignore-fields</span></dfn></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.interpret-fields"><span class="csoptfmt">interpret-fields</span></dfn><span class="qquad"></span><a href="#wrglossary.10677">419</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.label-prefix"><span class="csoptfmt">label-prefix</span></dfn><span class="qquad"></span><a href="#wrglossary.13862">568</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.loc-counters"><span class="csoptfmt">loc-counters</span></dfn><span class="qquad"></span><a href="#wrglossary.12924">529</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.loc-prefix"><span class="csoptfmt">loc-prefix</span></dfn><span class="qquad"></span><a href="#wrglossary.10800">424</a>, <a href="#wrglossary.10883">428</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.loc-suffix"><span class="csoptfmt">loc-suffix</span></dfn><span class="qquad"></span><a href="#wrglossary.10802">424</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.name-case-change"><span class="csoptfmt">name-case-change</span></dfn><span class="qquad"></span><a href="#wrglossary.12241">501</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.post-description-dot"><span class="csoptfmt">post-description-dot</span></dfn><span class="qquad"></span><a href="#wrglossary.34">2</a>, <a href="#wrglossary.272">12</a>, <a href="#wrglossary.289">13</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.prune-xr"><span class="csoptfmt">prune-xr</span></dfn><span class="qquad"></span><a href="#wrglossary.7231">275</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.replicate-fields"><span class="csoptfmt">replicate-fields</span></dfn><span class="qquad"></span><a href="#wrglossary.10675">419</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.save-child-count"><span class="csoptfmt">save-child-count</span></dfn><span class="qquad"></span><a href="#wrglossary.11572">468</a>, <a href="#wrglossary.11652">472</a>, <a href="#wrglossary.13499">554</a>, <a href="#wrglossary.14776">614</a>, <a href="#wrglossary.20362">820</a>, <a href="#wrglossary.22140">895</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.save-index-counter"><span class="csoptfmt">save-index-counter</span></dfn><span class="qquad"></span><a href="#wrglossary.817">27</a>, <a href="#wrglossary.13962">573</a>, <a href="#wrglossary.14782">614</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.save-locations"><span class="csoptfmt">save-locations</span></dfn><span class="qquad"></span><a href="#wrglossary.754">25</a>, <a href="#wrglossary.1041">35</a>, <a href="#wrglossary.11105">440</a>, <a href="#wrglossary.11493">461</a>, <a href="#wrglossary.12533">513</a>, <a href="#wrglossary.14459">602</a>, <a href="#wrglossary.14609">607</a>, <a href="#wrglossary.14987">625</a>, <a href="#wrglossary.23618">944</a>, <a href="#wrglossary.23808">948</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.secondary"><span class="csoptfmt">secondary</span></dfn><span class="qquad"></span><a href="#wrglossary.9583">379</a>, <a href="#wrglossary.9870">390</a>, <a href="#wrglossary.9946">391</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.see"><span class="csoptfmt">see</span></dfn><span class="qquad"></span><a href="#wrglossary.7282">278</a>, <a href="#wrglossary.11127">441</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.seealso"><span class="csoptfmt">seealso</span></dfn><span class="qquad"></span><a href="#wrglossary.7283">278</a>, <a href="#wrglossary.11122">441</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.selection"><span class="csoptfmt">selection</span></dfn><span class="qquad"></span><a href="#wrglossary.596">22</a>, <a href="#wrglossary.961">33</a>, <a href="#wrglossary.6692">260</a>, <a href="#wrglossary.6965">266</a>, <a href="#wrglossary.7032">267</a>, <a href="#wrglossary.7212">274</a>, <a href="#wrglossary.7281">278</a>, <a href="#wrglossary.7325">279</a>, <a href="#wrglossary.12556">514</a>, <a href="#wrglossary.12788">524</a>, <a href="#wrglossary.13651">560</a>, <a href="#wrglossary.17081">696</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.set-widest"><span class="csoptfmt">set-widest</span></dfn><span class="qquad"></span><a href="#wrglossary.11020">435</a>, <a href="#wrglossary.11244">447</a>, <a href="#wrglossary.11508">463</a>, <a href="#wrglossary.13464">553</a>, <a href="#wrglossary.21472">867</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.sort-field"><span class="csoptfmt">sort-field</span></dfn><span class="qquad"></span><a href="#wrglossary.1007">34</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.sort-label-list"><span class="csoptfmt">sort-label-list</span></dfn><span class="qquad"></span><a href="#wrglossary.7763">299</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.sort-replace"><span class="csoptfmt">sort-replace</span></dfn><span class="qquad"></span><a href="#wrglossary.13090">535</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.sort-rule"><span class="csoptfmt">sort-rule</span></dfn><span class="qquad"></span><a href="#wrglossary.12673">521</a>, <a href="#wrglossary.13146">536</a>, <a href="#wrglossary.13162">538</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.sort"><span class="csoptfmt">sort</span></dfn><span class="qquad"></span><a href="#wrglossary.753">25</a>, <a href="#wrglossary.9524">378</a>, <a href="#wrglossary.12585">514</a>, <a href="#wrglossary.13144">536</a>, <a href="#wrglossary.23617">944</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.src"><span class="csoptfmt">src</span></dfn><span class="qquad"></span><a href="#wrglossary.438">17</a>, <a href="#wrglossary.12559">514</a>, <a href="#wrglossary.13510">554</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.supplemental-locations"><span class="csoptfmt">supplemental-locations</span></dfn><span class="qquad"></span><a href="#wrglossary.4949">195</a>, <a href="#wrglossary.13511">555</a>, <a href="#wrglossary.13639">560</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.symbol-sort-fallback"><span class="csoptfmt">symbol-sort-fallback</span></dfn><span class="qquad"></span><a href="#wrglossary.10473">410</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.trigger-type"><span class="csoptfmt">trigger-type</span></dfn><span class="qquad"></span><a href="#wrglossary.12796">525</a>, <a href="#wrglossary.12944">530</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx1"><dfn id="glo:opt.resource.type"><span class="csoptfmt">type</span></dfn><span class="qquad"></span><a href="#wrglossary.12633">518</a></div><!-- end of nlctuserguideidx1 -->
+<div class="nlctuserguideidx0"><dfn id="glo:resourceset">resource set</dfn><span class="qquad"></span><a href="#wrglossary.13501">554</a>, <span class="termslocfmt"><a href="#wrglossary.14511">603</a></span>, <a href="#wrglossary.19377">780</a>, <a href="#wrglossary.21300">860</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:RestoreAcronyms"><code class="csfmt">\RestoreAcronyms</code></a><span class="qquad"></span><a href="#sec:acrorevert">§4.6</a>; <a href="#wrglossary.4564">181</a>, <a href="#wrglossary.4572">182</a>, <a href="#wrglossary.22223">899</a>, <span class="summarylocfmt"><a href="#wrglossary.23259">930</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:rGLS"><code class="csfmt">\rGLS</code></a><span class="qquad"></span><a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.5089">199</a>, <a href="#wrglossary.6643">259</a>, <a href="#wrglossary.12834">526</a>, <a href="#wrglossary.12859">527</a>, <a href="#wrglossary.20993">847</a>, <span class="summarylocfmt"><a href="#wrglossary.23262">931</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtrifrecordtrigger"><code class="csfmt">\glsxtrifrecordtrigger</code></a>, <a href="#glo:rGLSformat"><code class="csfmt">\rGLSformat</code></a> &amp; <a href="#glo:switch.record-count"><span class="longargfmt">--record-count</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:rGls"><code class="csfmt">\rGls</code></a><span class="qquad"></span><a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.5112">200</a>, <a href="#wrglossary.6634">258</a>, <a href="#wrglossary.12820">526</a>, <a href="#wrglossary.12857">527</a>, <a href="#wrglossary.21001">847</a>, <span class="summarylocfmt"><a href="#wrglossary.23268">931</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtrifrecordtrigger"><code class="csfmt">\glsxtrifrecordtrigger</code></a>, <a href="#glo:rGlsformat"><code class="csfmt">\rGlsformat</code></a> &amp; <a href="#glo:switch.record-count"><span class="longargfmt">--record-count</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:rgls"><code class="csfmt">\rgls</code></a><span class="qquad"></span><a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.1707">56</a>, <a href="#wrglossary.4584">183</a>, <a href="#wrglossary.5111">200</a>, <a href="#wrglossary.6630">258</a>, <a href="#wrglossary.12783">524</a>, <a href="#wrglossary.12805">525</a>, <a href="#wrglossary.12855">527</a>, <a href="#wrglossary.12992">531</a>, <a href="#wrglossary.13023">533</a>, <a href="#wrglossary.19816">799</a>, <a href="#wrglossary.20991">847</a>, <span class="summarylocfmt"><a href="#wrglossary.23274">931</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtrifrecordtrigger"><code class="csfmt">\glsxtrifrecordtrigger</code></a>, <a href="#glo:rglsformat"><code class="csfmt">\rglsformat</code></a> &amp; <a href="#glo:switch.record-count"><span class="longargfmt">--record-count</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:rGLSformat"><code class="csfmt">\rGLSformat</code></a><span class="qquad"></span><a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12840">526</a>, <span class="summarylocfmt"><a href="#wrglossary.23280">931</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:rGlsformat"><code class="csfmt">\rGlsformat</code></a><span class="qquad"></span><a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12826">526</a>, <span class="summarylocfmt"><a href="#wrglossary.23283">931</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:rglsformat"><code class="csfmt">\rglsformat</code></a><span class="qquad"></span><a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12811">525</a>, <a href="#wrglossary.12898">528</a>, <span class="summarylocfmt"><a href="#wrglossary.23286">931</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:rGLSpl"><code class="csfmt">\rGLSpl</code></a><span class="qquad"></span><a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.6644">259</a>, <a href="#wrglossary.12841">526</a>, <a href="#wrglossary.12860">527</a>, <a href="#wrglossary.20994">847</a>, <span class="summarylocfmt"><a href="#wrglossary.23289">931</a></span>, <a href="#wrglossary.23309">932</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtrifrecordtrigger"><code class="csfmt">\glsxtrifrecordtrigger</code></a>, <a href="#glo:rGlsplformat"><code class="csfmt">\rGlsplformat</code></a> &amp; <a href="#glo:switch.record-count"><span class="longargfmt">--record-count</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:rGlspl"><code class="csfmt">\rGlspl</code></a><span class="qquad"></span><a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.6635">258</a>, <a href="#wrglossary.12827">526</a>, <a href="#wrglossary.12858">527</a>, <a href="#wrglossary.21002">847</a>, <span class="summarylocfmt"><a href="#wrglossary.23295">932</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtrifrecordtrigger"><code class="csfmt">\glsxtrifrecordtrigger</code></a>, <a href="#glo:rGlsplformat"><code class="csfmt">\rGlsplformat</code></a> &amp; <a href="#glo:switch.record-count"><span class="longargfmt">--record-count</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:rglspl"><code class="csfmt">\rglspl</code></a><span class="qquad"></span><a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.6633">258</a>, <a href="#wrglossary.12813">525</a>, <a href="#wrglossary.12856">527</a>, <a href="#wrglossary.21000">847</a>, <span class="summarylocfmt"><a href="#wrglossary.23301">932</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glsxtrifrecordtrigger"><code class="csfmt">\glsxtrifrecordtrigger</code></a>, <a href="#glo:rglsplformat"><code class="csfmt">\rglsplformat</code></a> &amp; <a href="#glo:switch.record-count"><span class="longargfmt">--record-count</span></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:rGLSplformat"><code class="csfmt">\rGLSplformat</code></a><span class="qquad"></span><a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12847">526</a>, <span class="summarylocfmt"><a href="#wrglossary.23307">932</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:rGlsplformat"><code class="csfmt">\rGlsplformat</code></a><span class="qquad"></span><a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12833">526</a>, <span class="summarylocfmt"><a href="#wrglossary.23310">932</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:rglsplformat"><code class="csfmt">\rglsplformat</code></a><span class="qquad"></span><a href="#sec:recordcount">§11.4</a>; <a href="#wrglossary.12819">525</a>, <span class="summarylocfmt"><a href="#wrglossary.23313">932</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Rho"><code class="csfmt">\Rho</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13981">573</a>, <span class="summarylocfmt"><a href="#wrglossary.23316">932</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:Roman"><code class="csfmt">\Roman</code></dfn><span class="qquad"></span><a href="#wrglossary.6810">262</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:roman"><code class="csfmt">\roman</code></dfn><span class="qquad"></span><a href="#wrglossary.6808">262</a></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index7864320 -->
+
+<section id="index7929856"><!-- start of section index7929856 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->S<div class="labellink"><a href="#index7929856">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample.tex"><span class="filefmt">sample.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14175">582</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-abbr-styles.tex"><span class="filefmt">sample-abbr-styles.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14177">582</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-abbrv.tex"><span class="filefmt">sample-abbrv.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14180">583</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-accsupp.tex"><span class="filefmt">sample-accsupp.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14239">590</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-acronym.tex"><span class="filefmt">sample-acronym.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14181">583</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-acronym-desc.tex"><span class="filefmt">sample-acronym-desc.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14183">584</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-alias.tex"><span class="filefmt">sample-alias.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14221">588</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-altmodifier.tex"><span class="filefmt">sample-altmodifier.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14211">587</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-alttree.tex"><span class="filefmt">sample-alttree.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.11056">437</a>, <a href="#wrglossary.14223">588</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-alttree-marginpar.tex"><span class="filefmt">sample-alttree-marginpar.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.11058">437</a>, <a href="#wrglossary.14228">589</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-alttree-sym.tex"><span class="filefmt">sample-alttree-sym.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.11057">437</a>, <a href="#wrglossary.14226">589</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-autoindex.tex"><span class="filefmt">sample-autoindex.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14196">586</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-autoindex-hyp.tex"><span class="filefmt">sample-autoindex-hyp.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14200">586</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-crossref.tex"><span class="filefmt">sample-crossref.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14184">584</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-entrycount.tex"><span class="filefmt">sample-entrycount.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14205">586</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-external.tex"><span class="filefmt">sample-external.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.12275">502</a>, <a href="#wrglossary.14217">588</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-fmt.tex"><span class="filefmt">sample-fmt.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14219">588</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-footnote.tex"><span class="filefmt">sample-footnote.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14186">584</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-header.tex"><span class="filefmt">sample-header.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14195">585</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-indexhook.tex"><span class="filefmt">sample-indexhook.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14185">584</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-initialisms.tex"><span class="filefmt">sample-initialisms.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14190">585</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-linkcount.tex"><span class="filefmt">sample-linkcount.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14208">587</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-mixed-abbrv-styles.tex"><span class="filefmt">sample-mixed-abbrv-styles.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14189">585</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-mixedsort.tex"><span class="filefmt">sample-mixedsort.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.9422">375</a>, <a href="#wrglossary.14213">588</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-mixture.tex"><span class="filefmt">sample-mixture.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14178">583</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-name-font.tex"><span class="filefmt">sample-name-font.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14179">583</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-nested.tex"><span class="filefmt">sample-nested.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14202">586</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-onelink.tex"><span class="filefmt">sample-onelink.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14207">587</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-onthefly.tex"><span class="filefmt">sample-onthefly.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14231">589</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-onthefly-utf8.tex"><span class="filefmt">sample-onthefly-utf8.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14236">589</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-onthefly-xetex.tex"><span class="filefmt">sample-onthefly-xetex.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14233">589</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-pages.tex"><span class="filefmt">sample-pages.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.10798">424</a>, <a href="#wrglossary.14209">587</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-postdot.tex"><span class="filefmt">sample-postdot.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14191">585</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-postlink.tex"><span class="filefmt">sample-postlink.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14192">585</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-prefix.tex"><span class="filefmt">sample-prefix.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14241">590</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-suppl.tex"><span class="filefmt">sample-suppl.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14245">590</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-suppl-hyp.tex"><span class="filefmt">sample-suppl-hyp.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14248">591</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-suppl-main.tex"><span class="filefmt">sample-suppl-main.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14243">590</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-suppl-main-hyp.tex"><span class="filefmt">sample-suppl-main-hyp.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14246">590</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-undef.tex"><span class="filefmt">sample-undef.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14188">584</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:file.sample-unitentrycount.tex"><span class="filefmt">sample-unitentrycount.tex</span></a><span class="qquad"></span><a href="#sec:samples">§14.2</a>; <a href="#wrglossary.14206">587</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.samplefile">sample files</dfn></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:section"><code class="csfmt">\section</code></dfn><span class="qquad"></span><a href="#wrglossary.16484">675</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:ctr.section"><span class="ctrfmt">section</span> counter</dfn><span class="qquad"></span><a href="#wrglossary.8079">313</a>, <a href="#wrglossary.12748">523</a>, <a href="#wrglossary.13531">555</a>, <a href="#wrglossary.13589">557</a>, <a href="#wrglossary.13614">558</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:seealsoname"><code class="csfmt">\seealsoname</code></a><span class="qquad"></span><a href="#wrglossary.953">33</a>, <a href="#wrglossary.7015">267</a>, <a href="#wrglossary.7278">278</a>, <a href="#wrglossary.14538">605</a>, <a href="#wrglossary.14675">609</a>, <a href="#wrglossary.20472">824</a>, <span class="summarylocfmt"><a href="#wrglossary.23319">932</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:seename"><code class="csfmt">\seename</code></a><span class="qquad"></span><a href="#wrglossary.7003">266</a>, <a href="#wrglossary.14671">609</a>, <a href="#wrglossary.18750">757</a>, <span class="summarylocfmt"><a href="#wrglossary.23322">933</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.sentencecase">sentence case</dfn><span class="qquad"></span><a href="#wrglossary.6463">253</a>, <a href="#wrglossary.12209">500</a>, <a href="#wrglossary.16545">677</a>, <a href="#wrglossary.17147">698</a>, <a href="#wrglossary.17709">717</a>, <a href="#wrglossary.17810">720</a>, <a href="#wrglossary.18630">753</a>, <a href="#wrglossary.18658">754</a>, <a href="#wrglossary.18953">765</a>, <a href="#wrglossary.19986">806</a>, <a href="#wrglossary.20026">807</a>, <a href="#wrglossary.20624">831</a>, <a href="#wrglossary.20711">834</a>, <a href="#wrglossary.21492">867</a>, <a href="#wrglossary.21600">871</a>, <a href="#wrglossary.22227">899</a>, <a href="#wrglossary.22288">901</a>, <a href="#wrglossary.22393">905</a>, <a href="#wrglossary.22403">906</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:setabbreviationstyle"><code class="csfmt">\setabbreviationstyle</code></a><span class="qquad"></span><a href="#sec:abbrstyle">§4.5</a>; <a href="#wrglossary.139">7</a>, <a href="#wrglossary.1237">41</a>, <a href="#wrglossary.1737">59</a>, <a href="#wrglossary.4277">170</a>, <a href="#wrglossary.22735">916</a>, <a href="#wrglossary.22747">917</a>, <span class="summarylocfmt"><a href="#wrglossary.23324">933</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a><a href="#glo:sym.banned"><span title="Don’t use" class="icon"><span class="deprecatedorbannedfmt">🛇</span></span></a><span class="qquad"></span><a href="#wrglossary.1300">43</a>, <a href="#wrglossary.5894">229</a>, <span class="summarylocfmt"><a href="#wrglossary.23327">933</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:setentrycounter"><code class="csfmt">\setentrycounter</code></a><span class="qquad"></span><a href="#wrglossary.13570">556</a>, <span class="summarylocfmt"><a href="#wrglossary.23335">933</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:setglossarypreamble"><code class="csfmt">\setglossarypreamble</code></a><span class="qquad"></span><a href="#wrglossary.9504">377</a>, <span class="summarylocfmt"><a href="#wrglossary.23339">933</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:setglossarystyle"><code class="csfmt">\setglossarystyle</code></a><span class="qquad"></span><a href="#wrglossary.9987">393</a>, <a href="#wrglossary.10640">418</a>, <a href="#wrglossary.15453">645</a>, <a href="#wrglossary.21245">858</a>, <span class="summarylocfmt"><a href="#wrglossary.23342">933</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:setupglossaries"><code class="csfmt">\setupglossaries</code></a><span class="qquad"></span><a href="#sec:pkgopts">§2</a>; <a href="#wrglossary.157">9</a>, <a href="#wrglossary.10906">428</a>, <span class="summarylocfmt"><a href="#wrglossary.23347">934</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:setupglsadd"><code class="csfmt">\setupglsadd</code></a><span class="qquad"></span><a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4805">190</a>, <span class="summarylocfmt"><a href="#wrglossary.23352">934</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:setupglslink"><code class="csfmt">\setupglslink</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:setupglslink"><code class="csfmt">\setupglslink</code></a><span class="qquad"></span><a href="#sec:defaultglsopts">§5.1.1</a>; <a href="#wrglossary.4803">190</a>, <span class="summarylocfmt"><a href="#wrglossary.23355">934</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:setupglsadd"><code class="csfmt">\setupglsadd</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.smallcaps">small caps</dfn><span class="qquad"></span><a href="#wrglossary.1806">63</a>, <a href="#wrglossary.2391">88</a>, <a href="#wrglossary.2965">112</a>, <a href="#wrglossary.2980">113</a>, <a href="#wrglossary.3369">136</a>, <a href="#wrglossary.3899">157</a>, <a href="#wrglossary.5122">200</a>, <a href="#wrglossary.15152">633</a>, <a href="#wrglossary.16567">678</a>, <a href="#wrglossary.16573">679</a>, <a href="#wrglossary.17745">718</a>, <a href="#wrglossary.21358">862</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:so"><code class="csfmt">\so</code></dfn><span class="qquad"></span><a href="#wrglossary.6189">242</a>, <a href="#wrglossary.6219">243</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.soul"><span class="styfmt">soul</span> package</dfn><span class="qquad"></span><a href="#wrglossary.6058">236</a>, <a href="#wrglossary.6170">241</a>, <a href="#wrglossary.6188">242</a>, <a href="#wrglossary.7451">284</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:standaloneentry">standalone entry</dfn><span class="qquad"></span><span class="termslocfmt"><a href="#wrglossary.14515">603</a></span>, <a href="#wrglossary.22807">918</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:stepcounter"><code class="csfmt">\stepcounter</code></dfn><span class="qquad"></span><a href="#wrglossary.8156">317</a>, <a href="#wrglossary.20463">824</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:string"><code class="csfmt">\string</code></dfn><span class="qquad"></span><a href="#wrglossary.12500">512</a>, <a href="#wrglossary.12681">521</a>, <a href="#wrglossary.13079">535</a>, <a href="#wrglossary.13207">539</a>, <a href="#wrglossary.13237">541</a>, <a href="#wrglossary.14032">575</a>, <a href="#wrglossary.17157">698</a>, <a href="#wrglossary.18002">728</a>, <a href="#wrglossary.23374">935</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:subglossentry"><code class="csfmt">\subglossentry</code></a><span class="qquad"></span><a href="#wrglossary.10148">398</a>–<a href="#wrglossary.10222">400</a>, <a href="#wrglossary.10547">414</a>, <a href="#wrglossary.11651">472</a>, <span class="summarylocfmt"><a href="#wrglossary.23358">934</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:subsequentuse">subsequent use</dfn><span class="qquad"></span><span class="termslocfmt"><a href="#wrglossary.14523">604</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:env.supertabular"><span class="envfmt">supertabular</span> environment</dfn><span class="qquad"></span><a href="#wrglossary.15611">650</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.supertabular"><span class="styfmt">supertabular</span> package</dfn></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:symbolname"><code class="csfmt">\symbolname</code></a><span class="qquad"></span><a href="#wrglossary.11222">446</a>, <a href="#wrglossary.11603">469</a>, <span class="summarylocfmt"><a href="#wrglossary.23361">934</a></span></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index7929856 -->
+
+<section id="index7995392"><!-- start of section index7995392 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->T<div class="labellink"><a href="#index7995392">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><dfn id="glo:tabcolsep"><code class="csfmt">\tabcolsep</code></dfn><span class="qquad"></span><a href="#wrglossary.11294">449</a>, <a href="#wrglossary.11341">452</a>, <a href="#wrglossary.11363">454</a>, <a href="#wrglossary.11407">457</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:ctr.table"><span class="ctrfmt">table</span> counter</dfn></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:env.table"><span class="envfmt">table</span> environment</dfn><span class="qquad"></span><a href="#wrglossary.798">27</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:tableofcontents"><code class="csfmt">\tableofcontents</code></dfn><span class="qquad"></span><a href="#wrglossary.5193">203</a>, <a href="#wrglossary.5500">215</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:env.tabular"><span class="envfmt">tabular</span> environment</dfn><span class="qquad"></span><a href="#wrglossary.9663">383</a>, <a href="#wrglossary.10209">399</a>, <a href="#wrglossary.10266">402</a>, <a href="#wrglossary.10899">428</a>, <a href="#wrglossary.11194">444</a>, <a href="#wrglossary.11200">445</a>, <a href="#wrglossary.11655">472</a>, <a href="#wrglossary.15462">645</a>, <a href="#wrglossary.15516">647</a>–<a href="#wrglossary.15577">649</a>, <a href="#wrglossary.16277">668</a>, <a href="#wrglossary.16400">672</a>, <a href="#wrglossary.17265">702</a>, <a href="#wrglossary.18477">748</a>, <a href="#wrglossary.18600">752</a>, <a href="#wrglossary.22169">896</a>, <a href="#wrglossary.22844">920</a>, <a href="#wrglossary.23363">934</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Tau"><code class="csfmt">\Tau</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13982">573</a>, <span class="summarylocfmt"><a href="#wrglossary.23364">934</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:app.texindy"><span class="appfmt">texindy</span></dfn><span class="qquad"></span><a href="#wrglossary.14013">574</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:texorpdfstring"><code class="csfmt">\texorpdfstring</code></dfn><span class="qquad"></span><a href="#wrglossary.5251">205</a>, <a href="#wrglossary.5521">216</a>, <a href="#wrglossary.10654">418</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:textbf"><code class="csfmt">\textbf</code></dfn><span class="qquad"></span><a href="#wrglossary.10949">430</a>, <a href="#wrglossary.13644">560</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.textcase"><span class="styfmt">textcase</span> package</dfn><span class="qquad"></span><a href="#wrglossary.5198">203</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:textlarger"><code class="csfmt">\textlarger</code></dfn><span class="qquad"></span><a href="#wrglossary.3926">158</a>, <a href="#wrglossary.21654">873</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:textsc"><code class="csfmt">\textsc</code></dfn><span class="qquad"></span><a href="#wrglossary.1796">61</a>, <a href="#wrglossary.3368">136</a>, <a href="#wrglossary.3894">156</a>, <a href="#wrglossary.3898">157</a>, <a href="#wrglossary.15117">632</a>–<a href="#wrglossary.15182">634</a>, <a href="#wrglossary.15229">636</a>, <a href="#wrglossary.15379">641</a>, <a href="#wrglossary.15387">642</a>, <a href="#wrglossary.18982">765</a>, <a href="#wrglossary.19895">802</a>, <a href="#wrglossary.21336">861</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:textsmaller"><code class="csfmt">\textsmaller</code></dfn><span class="qquad"></span><a href="#wrglossary.1810">63</a>, <a href="#wrglossary.3895">156</a>, <a href="#wrglossary.3916">157</a>, <a href="#wrglossary.5915">230</a>, <a href="#wrglossary.15125">632</a>, <a href="#wrglossary.15190">634</a>, <a href="#wrglossary.15233">636</a>, <a href="#wrglossary.15413">643</a>, <a href="#wrglossary.15443">644</a>, <a href="#wrglossary.19899">802</a>, <a href="#wrglossary.21649">873</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:textsubscript"><code class="csfmt">\textsubscript</code></dfn><span class="qquad"></span><a href="#wrglossary.11698">475</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:textsuperscript"><code class="csfmt">\textsuperscript</code></dfn><span class="qquad"></span><a href="#wrglossary.11697">475</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:textup"><code class="csfmt">\textup</code></dfn><span class="qquad"></span><a href="#wrglossary.3938">158</a>, <a href="#wrglossary.19797">798</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:thecounter"><code class="csfmt">\the<span class="meta">〈<em class="metainner">counter</em>〉</span></code></dfn><span class="qquad"></span><a href="#wrglossary.4976">196</a>, <a href="#wrglossary.8091">313</a>, <a href="#wrglossary.8162">318</a>, <a href="#wrglossary.10398">407</a>, <a href="#wrglossary.10444">408</a>, <a href="#wrglossary.12730">522</a>, <a href="#wrglossary.12934">529</a>, <a href="#wrglossary.13558">556</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:env.theglossary"><span class="envfmt">theglossary</span> environment</a><span class="qquad"></span><a href="#wrglossary.36">3</a>, <a href="#wrglossary.10185">399</a>, <a href="#wrglossary.10299">403</a>, <a href="#wrglossary.10316">404</a>, <a href="#wrglossary.16469">675</a>, <a href="#wrglossary.18693">755</a>, <a href="#wrglossary.23222">929</a>, <span class="summarylocfmt"><a href="#wrglossary.23482">940</a></span>, <a href="#wrglossary.23768">948</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:theglossaryentry"><code class="csfmt">\theglossaryentry</code></a><span class="qquad"></span><span class="summarylocfmt"><a href="#wrglossary.23367">935</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:theHcounter"><code class="csfmt">\theH<span class="meta">〈<em class="metainner">counter</em>〉</span></code></dfn><span class="qquad"></span><a href="#wrglossary.4975">196</a>, <a href="#wrglossary.8093">313</a>, <a href="#wrglossary.10465">409</a>, <a href="#wrglossary.12729">522</a>, <a href="#wrglossary.12929">529</a>, <a href="#wrglossary.13595">557</a>, <a href="#wrglossary.14863">618</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:env.theindex"><span class="envfmt">theindex</span> environment</dfn><span class="qquad"></span><a href="#wrglossary.14069">576</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:thepage"><code class="csfmt">\thepage</code></dfn><span class="qquad"></span><a href="#wrglossary.12733">522</a>, <a href="#wrglossary.12766">524</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.titlecase">title case</dfn><span class="qquad"></span><a href="#wrglossary.5137">200</a>, <a href="#wrglossary.7601">291</a>, <a href="#wrglossary.9369">372</a>–<a href="#wrglossary.9395">374</a>, <a href="#wrglossary.12212">500</a>, <a href="#wrglossary.16192">665</a>, <a href="#wrglossary.17523">710</a>, <a href="#wrglossary.19883">802</a>, <a href="#wrglossary.20894">843</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.titlestring"><span class="styfmt">titlestring</span> package</dfn></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.tracklang"><span class="styfmt">tracklang</span> package</dfn><span class="qquad"></span><a href="#wrglossary.7657">293</a>, <a href="#wrglossary.7664">294</a>, <a href="#wrglossary.12587">514</a>, <a href="#wrglossary.13164">538</a>, <a href="#wrglossary.13209">540</a>, <a href="#wrglossary.14272">593</a>, <a href="#wrglossary.14282">594</a>, <a href="#wrglossary.19959">805</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.translator"><span class="styfmt">translator</span> package</dfn><span class="qquad"></span><a href="#wrglossary.43">3</a>, <a href="#wrglossary.23866">950</a></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index7995392 -->
+
+<section id="index8060928"><!-- start of section index8060928 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->U<div class="labellink"><a href="#index8060928">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><a href="#glo:u"><code class="csfmt">\u</code></a><span class="qquad"></span><a href="#wrglossary.12499">512</a>, <a href="#wrglossary.12674">521</a>, <a href="#wrglossary.13080">535</a>, <a href="#wrglossary.18003">728</a>, <span class="summarylocfmt"><a href="#wrglossary.23370">935</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:glshex"><code class="csfmt">\glshex</code></a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:ul"><code class="csfmt">\ul</code></dfn><span class="qquad"></span><a href="#wrglossary.6059">236</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:underline"><code class="csfmt">\underline</code></dfn><span class="qquad"></span><a href="#wrglossary.1712">58</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:unskip"><code class="csfmt">\unskip</code></dfn><span class="qquad"></span><a href="#wrglossary.543">20</a>, <a href="#wrglossary.936">32</a>, <a href="#wrglossary.7331">279</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Upalpha"><code class="csfmt">\Upalpha</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13406">553</a>, <a href="#wrglossary.13990">573</a>, <span class="summarylocfmt"><a href="#wrglossary.23375">935</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:upalpha"><code class="csfmt">\upalpha</code></dfn><span class="qquad"></span><a href="#wrglossary.13361">551</a>–<a href="#wrglossary.13407">553</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Upbeta"><code class="csfmt">\Upbeta</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13991">573</a>, <span class="summarylocfmt"><a href="#wrglossary.23379">935</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:upbeta"><code class="csfmt">\upbeta</code></dfn></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Upchi"><code class="csfmt">\Upchi</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.14002">573</a>, <span class="summarylocfmt"><a href="#wrglossary.23383">935</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Upepsilon"><code class="csfmt">\Upepsilon</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13992">573</a>, <span class="summarylocfmt"><a href="#wrglossary.23387">935</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Upeta"><code class="csfmt">\Upeta</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13994">573</a>, <span class="summarylocfmt"><a href="#wrglossary.23391">935</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.upgreek"><span class="styfmt">upgreek</span> package</dfn><span class="qquad"></span><a href="#wrglossary.13362">551</a>, <a href="#wrglossary.13369">552</a>, <a href="#wrglossary.13989">573</a>, <a href="#wrglossary.23378">935</a>–<a href="#wrglossary.23422">937</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Upiota"><code class="csfmt">\Upiota</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13995">573</a>, <span class="summarylocfmt"><a href="#wrglossary.23395">936</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Upkappa"><code class="csfmt">\Upkappa</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13996">573</a>, <span class="summarylocfmt"><a href="#wrglossary.23399">936</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Upmu"><code class="csfmt">\Upmu</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13997">573</a>, <span class="summarylocfmt"><a href="#wrglossary.23403">936</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Upnu"><code class="csfmt">\Upnu</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13998">573</a>, <span class="summarylocfmt"><a href="#wrglossary.23407">936</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Upomicron"><code class="csfmt">\Upomicron</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13999">573</a>, <span class="summarylocfmt"><a href="#wrglossary.23411">936</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:upomicron"><code class="csfmt">\upomicron</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.14003">573</a>, <span class="summarylocfmt"><a href="#wrglossary.23415">936</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:uppercase"><code class="csfmt">\uppercase</code></dfn><span class="qquad"></span><a href="#wrglossary.5863">228</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:idx.uppercase">uppercase</dfn><span class="qquad"></span><a href="#wrglossary.3372">136</a>, <a href="#wrglossary.3407">138</a>, <a href="#wrglossary.3612">146</a>, <a href="#wrglossary.3902">157</a>, <a href="#wrglossary.5008">197</a>, <a href="#wrglossary.5126">200</a>, <a href="#wrglossary.5149">201</a>, <a href="#wrglossary.6809">262</a>, <a href="#wrglossary.7589">291</a>–<a href="#wrglossary.7643">293</a>, <a href="#wrglossary.7793">300</a>, <a href="#wrglossary.8040">311</a>, <a href="#wrglossary.9815">388</a>, <a href="#wrglossary.9832">389</a>, <a href="#wrglossary.12210">500</a>, <a href="#wrglossary.13380">552</a>, <a href="#wrglossary.13404">553</a>, <a href="#wrglossary.16544">677</a>, <a href="#wrglossary.17355">705</a>, <a href="#wrglossary.17708">717</a>, <a href="#wrglossary.17809">720</a>, <a href="#wrglossary.18629">753</a>, <a href="#wrglossary.18657">754</a>, <a href="#wrglossary.18952">765</a>, <a href="#wrglossary.19161">774</a>, <a href="#wrglossary.19985">806</a>, <a href="#wrglossary.20025">807</a>, <a href="#wrglossary.20273">816</a>, <a href="#wrglossary.20623">831</a>, <a href="#wrglossary.20710">834</a>, <a href="#wrglossary.20860">841</a>, <a href="#wrglossary.21491">867</a>, <a href="#wrglossary.21599">871</a>, <a href="#wrglossary.22226">899</a>, <a href="#wrglossary.22287">901</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:idx.titlecase">title case</a>, <a href="#glo:idx.sentencecase">sentence case</a> &amp; <a href="#glo:idx.allcaps">all caps</a></div><!-- end of crossref -->
+</div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Uprho"><code class="csfmt">\Uprho</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.14000">573</a>, <span class="summarylocfmt"><a href="#wrglossary.23419">937</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Uptau"><code class="csfmt">\Uptau</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.14001">573</a>, <span class="summarylocfmt"><a href="#wrglossary.23423">937</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:Upzeta"><code class="csfmt">\Upzeta</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13993">573</a>, <span class="summarylocfmt"><a href="#wrglossary.23427">937</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:utf8">UTF-8</dfn><span class="qquad"></span><a href="#wrglossary.4608">184</a>, <a href="#wrglossary.5016">197</a>, <a href="#wrglossary.5034">198</a>, <a href="#wrglossary.6366">249</a>, <a href="#wrglossary.10852">427</a>, <a href="#wrglossary.11075">438</a>, <a href="#wrglossary.12671">521</a>, <a href="#wrglossary.14099">578</a>, <span class="termslocfmt"><a href="#wrglossary.14525">604</a></span>, <a href="#wrglossary.19453">782</a>, <a href="#wrglossary.21459">866</a></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index8060928 -->
+
+<section id="index8192000"><!-- start of section index8192000 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->W<div class="labellink"><a href="#index8192000">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><dfn id="glo:whatsit">whatsit</dfn><span class="qquad"></span><a href="#wrglossary.4627">185</a>, <a href="#wrglossary.4925">194</a>, <a href="#wrglossary.6895">264</a>, <a href="#wrglossary.7570">290</a>, <span class="termslocfmt"><a href="#wrglossary.14526">604</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:ctr.wrglossary"><span class="ctrfmt">wrglossary</span> counter</a><span class="qquad"></span><a href="#sec:refindexopts">§2.4</a>; <a href="#wrglossary.811">27</a>, <a href="#wrglossary.879">29</a>, <a href="#wrglossary.13606">558</a>, <a href="#wrglossary.13621">559</a>, <a href="#wrglossary.14783">614</a>, <a href="#wrglossary.22097">893</a>, <a href="#wrglossary.23546">942</a>, <a href="#wrglossary.23577">943</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:writemultiglossentry"><code class="csfmt">\writemultiglossentry</code></a><span class="qquad"></span><a href="#sec:multiextras">§7.13</a>; <a href="#wrglossary.9339">371</a>, <span class="summarylocfmt"><a href="#wrglossary.23431">937</a></span></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index8192000 -->
+
+<section id="index8257536"><!-- start of section index8257536 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->X<div class="labellink"><a href="#index8257536">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><a href="#glo:xcapitalisefmtwords"><code class="csfmt">\xcapitalisefmtwords</code></a><span class="qquad"></span><a href="#wrglossary.12223">500</a>, <span class="summarylocfmt"><a href="#wrglossary.23434">937</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:pkg.xfor"><span class="styfmt">xfor</span> package</dfn><span class="qquad"></span><a href="#wrglossary.7812">301</a>, <a href="#wrglossary.9331">371</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:xglssetwidest"><code class="csfmt">\xglssetwidest</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11010">434</a>, <span class="summarylocfmt"><a href="#wrglossary.23438">937</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:xglsupdatewidest"><code class="csfmt">\xglsupdatewidest</code></a><span class="qquad"></span><a href="#sec:stylemodstree">§8.6.5.4</a>; <a href="#wrglossary.11015">434</a>, <span class="summarylocfmt"><a href="#wrglossary.23441">938</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:xGlsXtrIfValueInFieldCsvList"><code class="csfmt">\xGlsXtrIfValueInFieldCsvList</code></a><span class="qquad"></span><a href="#sec:csvfields">§5.13</a>; <a href="#wrglossary.7860">304</a>, <span class="summarylocfmt"><a href="#wrglossary.23444">938</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:xGlsXtrSetField"><code class="csfmt">\xGlsXtrSetField</code></a><span class="qquad"></span><a href="#sec:setfields">§3.5</a>; <a href="#wrglossary.1189">39</a>, <a href="#wrglossary.1207">40</a>, <span class="summarylocfmt"><a href="#wrglossary.23447">938</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:xifinlistcs"><code class="csfmt">\xifinlistcs</code></dfn><span class="qquad"></span><a href="#wrglossary.7882">305</a>, <a href="#wrglossary.19892">802</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:app.xindex"><span class="appfmt">xindex</span></dfn><span class="qquad"></span><a href="#wrglossary.14388">601</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><dfn id="glo:app.xindy"><span class="appfmt">xindy</span></dfn><span class="qquad"></span><a href="#wrglossary.102">6</a>, <a href="#wrglossary.408">17</a>, <a href="#wrglossary.547">20</a>, <a href="#wrglossary.662">23</a>, <a href="#wrglossary.742">25</a>, <a href="#wrglossary.852">28</a>, <a href="#wrglossary.4958">195</a>, <a href="#wrglossary.4983">196</a>, <a href="#wrglossary.6742">261</a>, <a href="#wrglossary.14010">574</a>, <a href="#wrglossary.14387">601</a>, <a href="#wrglossary.14698">610</a>, <a href="#wrglossary.22236">900</a>, <a href="#wrglossary.23116">926</a>, <a href="#wrglossary.23614">944</a>, <a href="#wrglossary.23874">950</a></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:xpglsxtrpostabbrvfootnote"><code class="csfmt">\xpglsxtrpostabbrvfootnote</code></a><span class="qquad"></span><a href="#sec:advancedabbrstylecmds">§4.5.2</a>; <a href="#wrglossary.3972">160</a>, <span class="summarylocfmt"><a href="#wrglossary.23450">938</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:xpglsxtrposthyphenlong"><code class="csfmt">\xpglsxtrposthyphenlong</code></a><span class="qquad"></span><a href="#wrglossary.3794">152</a>, <span class="summarylocfmt"><a href="#wrglossary.23453">938</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:xpglsxtrposthyphenshort"><code class="csfmt">\xpglsxtrposthyphenshort</code></a><span class="qquad"></span><a href="#wrglossary.3714">150</a>, <span class="summarylocfmt"><a href="#wrglossary.23460">938</a></span></div><!-- end of nlctuserguideidx0 -->
+<div class="nlctuserguideidx0"><a href="#glo:xpglsxtrposthyphensubsequent"><code class="csfmt">\xpglsxtrposthyphensubsequent</code></a><span class="qquad"></span><a href="#wrglossary.3766">151</a>, <span class="summarylocfmt"><a href="#wrglossary.23467">938</a></span></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index8257536 -->
+
+<section id="index8388608"><!-- start of section index8388608 --><div class="tomain"><a href="#main">[top]</a></div>
+<h2><!-- start of section header -->Z<div class="labellink"><a href="#index8388608">[link]</a></div></h2><!-- end of section header -->
+<div class="nlctuserguideidx0"><a href="#glo:Zeta"><code class="csfmt">\Zeta</code></a><span class="qquad"></span><a href="#sec:bib2glssupplementarycommands">§11.5.8</a>; <a href="#wrglossary.13974">573</a>, <span class="summarylocfmt"><a href="#wrglossary.23474">939</a></span></div><!-- end of nlctuserguideidx0 -->
+
+</section><!-- end of section index8388608 -->
+</div><!-- end of main -->
+</body>
+</html>
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual.pdf b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual.pdf
index fd0a2ca8dc..3c80a18688 100644
--- a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual.pdf
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual.tex b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual.tex
index 44d5314dad..925ff20f05 100644
--- a/macros/latex/contrib/glossaries-extra/glossaries-extra-manual.tex
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra-manual.tex
@@ -1,2587 +1,22323 @@
-\documentclass[report,inlinetitle,noprint]{nlctdoc}
-
-\makeatletter
-\@ifpackageloaded{tex4ht}
-{
- \DeclareUnicodeCharacter{00FE}{\HCode{&\#x00FE;}}
- \DeclareUnicodeCharacter{00D0}{\HCode{&\#x00D0;}}
- \DeclareUnicodeCharacter{01F7}{\HCode{&\#x01F7;}}
- \DeclareUnicodeCharacter{A77D}{\HCode{&\#xA77D;}}
- \DeclareUnicodeCharacter{017F}{\HCode{&\#x017F;}}
- \DeclareUnicodeCharacter{018F}{\HCode{&\#x018F;}}
+% This document takes a *long* time to compile from scratch. See
+% notes below.
+%
+% arara: lualatex if missing("glstex")
+% arara: bib2gls: { group: on, packages: [ mfirstuc-english ] } if missing("glstex")
+% arara: lualatex: { shell: yes }
+% arara: bib2gls: { group: on, packages: [ mfirstuc-english ] }
+% arara: lualatex
+% arara: lualatex if found("log", "Rerun to get")
+%
+% This manual creates example documents on the fly in the
+% directory created by the following line:
+\directlua{os.execute("mkdir -p glossaries-extra-manual-examples")}
+% If the above doesn't work, you'll have to create the directory
+% manually.
+
+% If the shell escape is enabled the example documents will be
+% automatically built with arara. If you already have the example .tex and
+% .pdf files in the above directory, the shell escape isn't
+% required. You'll need to run pdfcrop on the example pdf files if
+% you don't have the *-crop.pdf files. If you only have the .tex
+% files in the examples directory, then you need to run arara on
+% each .tex file (which will call pdfcrop where applicable).
+%
+% This document requires glossaries-extra v1.49, bib2gls v3.0
+% and nlctuserguide.sty. Some of the example documents require
+% glossaries v4.50 and mfirstuc v2.08. If they haven't already
+% been uploaded to CTAN, they will be shortly.
+
+\documentclass[titlepage=false,oneside,
+ fontsize=12pt,captions=tableheading]{scrbook}
+
+%\usepackage[autooneside=false]{scrlayer-scrpage}
+
+\usepackage{relsize}
+\usepackage{mfirstuc-english}
+\usepackage[
+ deephierarchy,
+ numberedsection,
+ abbreviations,
+ %debug=showwrgloss,novref,
+ %showtargets=annoteleft
+ ]{nlctuserguide}
+
+\hypersetup{pdfauthor={Nicola Talbot},
+ pdftitle={glossaries-extra manual},
+ bookmarksdepth=5}
+
+\renewcommand*{\thispackagename}{glossaries-extra}
+\renewcommand{\cmdnotefmt}[1]{}
+\renewcommand*{\summarynotefmt}[1]{{\small(#1)}}
+
+\appto\terminaldesc{. See also
+\qt{\dickimawhref{latex/buildglossaries}{Incorporating
+makeglossaries or makeglossaries-lite or bib2gls into the document
+build}}}
+
+\newfontfamily\noto{Noto Serif}
+\newcommand{\textnoto}[1]{{\noto #1}}
+
+\providecommand{\eth}{\char"00F0}
+\providecommand{\Eth}{\char"00D0}
+\providecommand{\thorn}{\char"00FE}
+\providecommand{\Thorn}{\char"00DE}
+\providecommand{\wynn}{\char"01BF}
+\providecommand{\Wynn}{\char"01F7}
+\newcommand{\insularg}{\textnoto{\char"1D79}}
+\newcommand{\InsularG}{\textnoto{\char"A77D}}
+\providecommand{\longs}{\char"017F}
+\providecommand{\Schwa}{\char"018F}
+\providecommand{\schwa}{\char"0259}
+
+\newcommand{\attr}{\idxc{categoryattribute}{attribute}}
+\newcommand{\attrs}{\idxc{categoryattribute}{attributes}}
+\newcommand{\location}{\idxc{entrylocation}{location}}
+\newcommand{\locations}{\idxc{entrylocation}{locations}}
+\newcommand{\encap}[2][]{{\let\csfmt\csfmtcolourfont\gls[#1]{#2}}}
+\newcommand{\indexed}{\idxc{indexing}{indexed}}
+\newcommand{\recorded}{\idxc{indexing}{recorded}}
+\newcommand{\record}{\idxc{indexing}{record}}
+\newcommand{\records}{\idxc{indexing}{records}}
+\newcommand{\atentry}[1]{\texorpdfstring{\code{@#1}}{@#1}}
+\newcommand{\thecounter}[1]{\glslink{thecounter}{\csfmt{the\-#1}}}
+\newcommand{\theHcounter}[1]{\glslink{theHcounter}{\csfmt{the\-H\-#1}}}
+\newcommand{\thecountername}{\glslink{thecounter}{\csfmt{the\-\meta{counter-name}}}}
+\newcommand{\theHcountername}{\glslink{theHcounter}{\csfmt{the\-\meta{counter-name}}}}
+\newcommand{\recordcounterfield}[1]{%
+ \glslink{opt.glosfield.recordcount.counter}{\csoptfmt{record\-count\dfullstop#1}}}
+\newcommand{\recordcounterlocationfield}[2]{%
+ \glslink{opt.glosfield.recordcount.counter.location}{\csoptfmt{record\-count\dfullstop#1\dfullstop#2}}}
+
+\MFUhyphentrue
+\setabbreviationstyle[termacronym]{short-sm-desc}
+
+\glsxtrnewgls{opt.printgloss.}{\printglossopt}
+\newcommand{\printglossoptval}[2]{\optval{printgloss.#1}{#2}}
+\newcommand{\printglossoptvalm}[2]{\optval{printgloss.#1}{\marg{#2}}}
+
+\glsxtrnewgls{opt.printunsrttab.}{\glstableopt}
+\newcommand{\glstableoptval}[2]{\optval{printunsrttab.#1}{#2}}
+\newcommand{\glstableoptvalm}[2]{\optval{printunsrttab.#1}{\marg{#2}}}
+\glsxtrnewgls{optval.printunsrttab.block-style.}{\glstableblockstyle}
+\newcommand{\glstableblockstyledef}[1]{\optionvaldef{printunsrttab.block-style}{#1}}
+
+\glsxtrnewgls{opt.glsopt.}{\glsopt}
+\newcommand{\glsoptval}[2]{\optval{glsopt.#1}{#2}}
+\glsxtrnewgls{opt.mglsopt.}{\mglsopt}
+\newcommand{\mglsoptval}[2]{\optval{mglsopt.#1}{#2}}
+\newcommand{\mglsoptvalm}[2]{\optvalm{mglsopt.#1}{#2}}
+\glsxtrnewgls{opt.gloskey.}{\gloskey}
+\newcommand{\gloskeyval}[2]{\optval{gloskey.#1}{\marg{#2}}}
+\glsxtrnewgls{opt.glosfield.}{\glosfield}
+\newcommand{\glosfielddisp}[3][]{\glsdisp[#1]{opt.glosfield.#2}{\csoptfmt{#3}}}
+\glsxtrnewgls{opt.cat.}{\cat}
+\glsxtrnewgls{opt.catattr.}{\catattr}
+\glsxtrnewgls{opt.resource.}{\resourceopt}
+\newcommand{\resourceoptval}[2]{\optval{resource.#1}{#2}}
+\newcommand{\resourceoptvalm}[2]{\optval{resource.#1}{\marg{#2}}}
+
+\glsxtrnewgls{opt.glostyle.}{\glostyle}
+\glsxtrnewgls{opt.abbrstyle.}{\abbrstyle}
+\glsxtrnewgls{opt.acrstyle.}{\acrstyle}
+
+\newcommand*{\abbrstyledef}[1]{\optiondef{abbrstyle.#1}}
+
+\defsemanticcmd[style1]{\fieldfmt}{\texttt}{}
+\defsemanticcmd[style2]{\entryfmt}{\texttt}{}
+\newcommand*{\atentryfmt}[1]{\entryfmt{@#1}}
+
+\defsemanticcmd{\acrstylefmt}{\textsf}{}
+\defsemanticcmd[style3]{\abbrstylefmt}{\textsf}{}
+\defsemanticcmd{\glostylefmt}{\textsf}{}
+\defsemanticcmd[style4]{\catattrfmt}{\textsf}{}
+
+\newcommand*{\catfmt}{\csoptfmt}
+
+\newcommand{\hierarchical}{\glslink{hierarchicallevel}{hierarchical}}
+
+\renewcommand{\nlctuserguidecustomentryaliases}{%
+ glossarystyle=index,
+ abbreviationstyle=index,
+ acronymstyle=index,
}
-{
- \usepackage{fontspec}
- \setmainfont{FreeSerif}
-}
-\makeatother
-
-\usepackage{alltt}
-\usepackage[normalem]{ulem}
-\usepackage{hologo}
-\usepackage[colorlinks,
- hyperindex=false,
- pdfauthor={Nicola L.C. Talbot},
- pdftitle={glossaries-extra.sty: an extension to the glossaries
-package},
- pdfkeywords={LaTeX,package,glossary,abbreviations}]{hyperref}
-\usepackage[nogroupskip,nonumberlist]{glossaries-extra}
-
-\makeglossaries
-
-\makeatletter
-\@nlctdoc@if@usingtexht
- {
- \newcommand{\headingsty}[1]{#1}
- \newcommand{\headingcs}[1]{#1}
- \newcommand{\headingapp}[1]{#1}
- }
- {
- \newcommand{\headingsty}[1]{\styfmt{#1}}
- \newcommand{\headingcs}[1]{\cs{#1}}
- \newcommand{\headingapp}[1]{\appfmt{#1}}
- }
-\makeatother
-
-\GlsXtrEnableEntryUnitCounting{general}{0}{page}
-\renewcommand*{\glsxtrifcounttrigger}[3]{#3}
-
-\renewcommand*{\glslinkcheckfirsthyperhook}{%
- \ifnum\glsentrycurrcount\glslabel>0
- \setkeys{glslink}{hyper=false}%
- \fi
+\appto{\nlctexampledisablecmds}{%
+ \letcs{\opt}{@firstofone}%
+ \letcs{\cat}{@firstofone}%
+ \letcs{\catattr}{@firstofone}%
+ \letcs{\resourceopt}{@firstofone}%
+ \letcs{\abbrstyle}{@firstofone}%
+ \letcs{\glostyle}{@firstofone}%
+ \letcs{\glsopt}{@firstofone}%
+ \letcs{\mglsopt}{@firstofone}%
+ \letcs{\gloskey}{@firstofone}%
+ \letcs{\glosfield}{@firstofone}%
+ \letcs{\printglossopt}{@firstofone}%
+ \let\resourceoptval\keyeqvalue
+ \let\resourceoptvalm\keyeqvaluem
+ \let\optval\keyeqvalue
+ \let\opteqvalref\keyeqvalue
+ \let\gloskeyval\keyeqvaluem
+ \let\glsoptval\keyeqvaluem
+ \let\mglsoptval\keyeqvaluem
+ \let\printglossoptval\keyeqvalue
+ \let\printglossoptvalm\keyeqvaluem
}
-\newcommand*{\XeLaTeX}{\hologo{XeLaTeX}}
-\newcommand*{\LuaLaTeX}{\hologo{LuaLaTeX}}
-\newcommand*{\pdfLaTeX}{\hologo{pdfLaTeX}}
-
-\IndexPrologue{\chapter*{\indexname}
- \addcontentsline{toc}{chapter}{\indexname}%
- \markboth{\indexname}{\indexname}}
+\newcommand{\genabbrvstyleexamplecode}[6]{%
+\gls{setabbreviationstyle}\allowbreak\marg{\abbrstyle{#2}}
-\renewcommand*{\main}[1]{\hyperpage{#1}}
-\newcommand*{\htextbf}[1]{\textbf{\hyperpage{#1}}}
+#6\gls{newabbreviation}#4\marg{ex}\marg{#3}\marg{long form}
-\glssetcategoryattribute{general}{indexname}{htextbf}
-\glssetcategoryattribute{general}{dualindex}{main}
-
-\newglossaryentry{xindy}{
- name={\appfmt{xindy}},
- sort={xindy},
- description={An flexible indexing application with multilingual
- support written in Perl.}
+\cbeg{document}
+First: \gls{gls}\marg{ex}[-insert]. Next: \gls{gls}\marg{ex}[-insert].
+Full: \gls{glsxtrfull}\marg{ex}[-insert].
+First plural: \gls{glspl}\oarg{prereset}\marg{ex}[-insert].\newline
+\gls{printunsrtglossaries}\newline
+\cend{document}
}
-\newglossaryentry{makeindex}{%
- name={\appfmt{makeindex}},%
- sort={makeindex},%
- description={An indexing application.},
+\newcommand{\genabbrvstyleexampleresult}[6]{%
+\createexample*[fontsize={20},title={The \optfmt{#2} abbreviation style},
+ description={Example document demonstrating the #2 abbreviation style},
+ label={ex:abbrvstyle#2},#1]
+{%
+ #5\cmd{usepackage}\oarg{T1}\marg{fontenc}^^J%
+ \cmd{usepackage}\oarg{colorlinks}\marg{hyperref}^^J%
+ \cmd{usepackage}\marg{glossaries-extra}^^J%
+ #6\gls{setabbreviationstyle}\marg{#2}^^J%
+ \gls{newabbreviation}#4\marg{ex}\marg{#3}\marg{long form}
}
-
-\newglossaryentry{makeglossaries}{%
-name={\appfmt{makeglossaries}},%
-sort={makeglossaries},%
-description={A custom designed Perl script interface
-provided with the \styfmt{glossaries} package
-to run \gls{xindy} or \gls{makeindex} according to
-the document settings.}}
-
-\newglossaryentry{makeglossaries-lite.lua}{%
-name={\appfmt{makeglossaries-lite}\index{makeglossaries-lite=\appfmt{makeglossaries-lite}|htextbf}},%
-sort={makeglossaries-lite},%
-text={\appfmt{makeglossaries-lite}\iapp{makeglossaries-lite}},%
-description={A custom designed Lua script interface
-to \gls{xindy} and \gls{makeindex} provided with the
-\styfmt{glossaries}
-package. This is a cut-down alternative to the Perl
-\appfmt{makeglossaries} script. If you have Perl installed, use the
-Perl script instead. This script is distributed in the source code
-on CTAN with the file name
-\texttt{makeglossaries-lite.lua} but TeX Live on Unix-like systems
-creates a symbolic link
-called \texttt{makeglossaries-lite} (without the \texttt{.lua}
-extension) to the actual \texttt{makeglossaries-lite.lua} script, and
-\TeX\ distributions on Windows convert the script to an executable
-\texttt{makeglossaries-lite.exe}.}
+{%
+First: \gls{gls}\marg{ex}[-insert]. Next: \gls{gls}\marg{ex}[-insert].^^J%
+Full: \gls{glsxtrfull}\marg{ex}[-insert].
+First plural: \gls{glspl}\oarg{prereset}\marg{ex}[-insert].^^J%
+\gls{printunsrtglossaries}
}
-
-\newglossaryentry{bib2gls}{%
-name={\appfmt{bib2gls}},%
-sort={bib2gls},%
-description={A command line Java application that selects
-entries from a .bib file and converts them to glossary
-definitions (like \appfmt{bibtex} but also performs hierarchical
-sorting and collation, thus omitting the need for \gls{xindy} or
-\gls{makeindex}). Further details at:
-\url{http://www.dickimaw-books.com/software/bib2gls/}.}%
}
-\newglossaryentry{numberlist}{%
-name={number list},%
-description={A list of \glspl{entrylocation} (also
-called a location list). The number list can be suppressed using the
-\pkgopt{nonumberlist} package option.}
+\newcommand{\genabbrvstyleexampleside}[6]{%
+\begin{coderesult}
+\genabbrvstyleexamplecode{#1}{#2}{#3}{#4}{#5}{#6}%
+\tcblower
+\genabbrvstyleexampleresult{#1}{#2}{#3}{#4}{#5}{#6}%
+\end{coderesult}%
}
-\newglossaryentry{entrylocation}{%
-name={entry location},%
-description={The location of the entry in the document. This
-defaults to the page number on which the entry appears. An entry may
-have multiple locations.}
+\newcommand{\genabbrvstyleexamplestack}[6]{%
+\begin{codebox}
+\genabbrvstyleexamplecode{#1}{#2}{#3}{#4}{#5}{#6}%
+\end{codebox}
+\begin{resultbox}
+\genabbrvstyleexampleresult{fontsize={11},#1}{#2}{#3}{#4}{#5}{#6}%
+\end{resultbox}%
}
-\newglossaryentry{locationlist}{%
-name={location list},%
-description={A list of \glspl{entrylocation}.
-See \gls{numberlist}.}%
+\newcommand*{\abbrvstyleexampleucfn}[2][]{%
+ \genabbrvstyleexampleside{#1}{#2}{SHRT FM}{}{}{}%
}
-\newglossaryentry{linktext}{%
-name={link-text},
-description={The text produced by commands such as \ics{gls}. It may
-or may not have a hyperlink to the glossary.}
+\newcommand*{\abbrvstyleexampleucdescfn}[2][]{%
+ \genabbrvstyleexampleside{#1}{#2}{SHRT FM}%
+ {\oarg{\gloskeyval{description}{sample description}}\newline}%
+ {}{}%
}
-\let\glsd\glsuseri
-\let\glsation\glsuserii
-
-\newglossaryentry{firstuseflag}{%
-name={first use flag},
-description={A conditional that determines whether or not the entry
-has been used according to the rules of \gls{firstuse}.}%
+\newcommand*{\abbrvstyleexamplelcfn}[2][]{%
+ \genabbrvstyleexampleside{#1}{#2}{shrt fm}{}{}{}%
}
-\newglossaryentry{firstusetext}{%
-name={first use text},
-description={The text that is displayed on \gls{firstuse}, which is
-governed by the \gloskey{first} and \gloskey{firstplural} keys of
-\ics{newglossaryentry}. (May be overridden by
-\ics{glsdisp}.)}%
+\newcommand*{\abbrvstyleexamplelcdescfn}[2][]{%
+ \genabbrvstyleexampleside{#1}{#2}{shrt fm}%
+ {\oarg{\gloskeyval{description}{sample description}}\newline}%
+ {}{}%
}
-\newglossaryentry{firstuse}{%
- name={first use},
- user1={first used},
- see={firstuseflag,firstusetext},
- description={The first time a glossary entry is used (from the start
- of the document or after a reset) with one of the
- following commands: \ics{gls}, \ics{Gls}, \ics{GLS}, \ics{glspl},
- \ics{Glspl}, \ics{GLSpl} or \ics{glsdisp}.}%
+\newcommand*{\abbrvstyleexamplesmfn}[2][]{%
+ \genabbrvstyleexampleside{#1}{#2}{SHRT FM}{}%
+ {^^J\cmd{usepackage}\marg{relsize}}{}%
}
-\setcounter{IndexColumns}{2}
-
-\newrobustcmd*{\eq}{\protect=}% hide from makeindex
-
-\newcommand*{\igloskey}[2][newglossaryentry]{\icsopt{#1}{#2}}
-\newcommand*{\gloskey}[2][newglossaryentry]{\csopt{#1}{#2}}
-\newcommand*{\optfmt}[1]{\textsf{#1}}
+\newcommand*{\abbrvstyleexamplesmdescfn}[2][]{%
+ \genabbrvstyleexampleside{#1}{#2}{SHRT FM}%
+ {\oarg{\gloskeyval{description}{sample description}}\newline}%
+ {^^J\cmd{usepackage}\marg{relsize}}{}%
+}
-\newcommand*{\glostyle}[1]{\textsf{#1}\index{glossary styles:>#1={\protect\sffamily#1}|main}}
+\newcommand*{\abbrvstyleexampleuc}[2][]{%
+ \genabbrvstyleexamplestack{#1}{#2}{SHRT FM}{}{}{}%
+}
-\newcommand*{\acrstyle}[1]{\textsf{#1}\index{acronym
-styles (glossaries):>#1={\protect\ttfamily#1}|main}}
+\newcommand*{\abbrvstyleexamplelc}[2][]{%
+ \genabbrvstyleexamplestack{#1}{#2}{shrt fm}{}{}{}%
+}
-\newcommand*{\abbrstylenolink}[1]{%
- \textsf{#1}\index{abbreviation styles:>#1={\protect\sffamily#1}|main}}
+\newcommand*{\abbrvstyleexamplesm}[2][]{%
+ \genabbrvstyleexamplestack{#1}{#2}{SHRT FM}{}%
+ {^^J\cmd{usepackage}\marg{relsize}}{}%
+}
-\newcommand*{\abbrstyle}[1]{%
- \hyperlink{abbrstyle.#1}{\textsf{#1}}%
- \index{abbreviation styles:>#1={\protect\sffamily#1}|main}%
+\newcommand*{\abbrvstyleexampleucdesc}[2][]{%
+ \genabbrvstyleexamplestack{#1}{#2}{SHRT FM}%
+ {\oarg{\gloskeyval{description}{sample description}}\newline}%
+ {}{}%
}
-\makeatletter
-\newcommand{\htarget}[2]{\Hy@raisedlink{\hypertarget{#1}{}}#2}
-\makeatother
+\newcommand*{\abbrvstyleexamplelcdesc}[2][]{%
+ \genabbrvstyleexamplestack{#1}{#2}{shrt fm}%
+ {\oarg{\gloskeyval{description}{sample description}}\newline}%
+ {}{}%
+}
-\newcommand*{\abbrstyledef}[1]{%
- \htarget{abbrstyle.#1}{\textsf{#1}}%
- \index{abbreviation styles:>#1={\protect\sffamily#1}|main}%
+\newcommand*{\abbrvstyleexamplesmdesc}[2][]{%
+ \genabbrvstyleexamplestack{#1}{#2}{SHRT FM}%
+ {\oarg{\gloskeyval{description}{sample description}}\newline}%
+ {^^J\cmd{usepackage}\marg{relsize}}{}%
}
-\newcommand*{\depabbrstyle}[1]{\textsf{#1}\index{abbreviation styles (deprecated):>#1={\protect\sffamily#1}|main}}
+\newcommand*{\abbrvstyleexamplelcuser}[2][]{%
+ \genabbrvstyleexamplestack{#1}{#2}{shrt fm}%
+ {\oarg{\gloskeyval{user1}{extra info}}}%
+ {}{}%
+}
-\newcommand*{\category}[1]{\textsf{#1}\index{categories:>#1={\protect\sffamily#1}|main}}
+\newcommand*{\abbrvstyleexampleucuser}[2][]{%
+ \genabbrvstyleexamplestack{#1}{#2}{SHRT FM}%
+ {\oarg{\gloskeyval{user1}{extra info}}}%
+ {}{}%
+}
-\newcommand*{\catattrnolink}[1]{%
- \textsf{#1}\index{category attributes:>#1={\protect\sffamily#1}|main}}
+\newcommand*{\abbrvstyleexamplelcuserdesc}[2][]{%
+ \genabbrvstyleexamplestack{#1}{#2}{shrt fm}%
+ {\oarg{\gloskeyval{description}{sample description},\newline
+ \gloskeyval{user1}{extra info}}}{}{}%
+}
-\newcommand*{\catattr}[1]{%
- \hyperlink{catattr.#1}{\textsf{#1}}%
- \index{category attributes:>#1={\protect\sffamily#1}|main}%
+\newcommand*{\abbrvstyleexampleucuserdesc}[2][]{%
+ \genabbrvstyleexamplestack{#1}{#2}{SHRT FM}%
+ {\oarg{\gloskeyval{description}{sample description},\newline
+ \gloskeyval{user1}{extra info}}}{}{}%
}
-\newcommand*{\catattrdef}[1]{%
- \htarget{catattr.#1}{\textsf{#1}}%
- \index{category attributes:>#1={\protect\sffamily#1}|main}%
+\newcommand*{\abbrvstyleexampleuchyp}[2][]{%
+ \genabbrvstyleexamplestack{#1}{#2}{SHRT FM}%
+ {}%
+ {}{\gls{glssetcategoryattributes}\marg{\cat{abbreviation}}\marg{\catattr{markwords},\catattr{markshortwords}}\marg{true}\newline}%
}
-\newcommand*{\postlinkcat}{%
- \cs{glsxtrpostlink}\meta{category}%
- \index{glsxtrpostlinkcategory=\cs{glsxtrpostlink}\meta{category}|hyperpage}%
+\newcommand*{\abbrvstyleexampleuchypdesc}[2][]{%
+ \genabbrvstyleexamplestack{#1}{#2}{SHRT FM}%
+ {\oarg{\gloskeyval{description}{sample description}}\newline}%
+ {}%
+ {%
+ \gls{glssetcategoryattributes}\marg{\cat{abbreviation}}\marg{\catattr{markwords},\catattr{markshortwords}}\marg{true}\newline
+ }%
}
-\renewcommand*{\pkgopt}[2][]{%
- \hyperlink{styopt.#2}{\pkgoptfmt{#2}}%
- \ifstrempty{#1}{}{\pkgoptfmt{=#1}}%
- \ipkgopt[#1]{#2}%
+\newcommand{\summaryentryglossarystyle}[1]{%
+ {%
+ \renewcommand*{\glostylefmt}[1]{\texttt{##1}}%
+ \genericsummaryentryoption{#1}%
+ }%
}
-\newcommand*{\pkgoptdef}[1]{%
- \htarget{styopt.#1}{\pkgoptfmt{#1}}%
- \ipkgopt{#1}%
+\newcommand{\summaryentryabbreviationstyle}[1]{%
+ {%
+ \renewcommand*{\abbrstylefmt}[1]{\texttt{##1}}%
+ \genericsummaryentryoption{#1}%
+ }%
}
-\setlength\marginparwidth{70pt}
+\renewcommand{\nlctuserguideletterrules}{%
+ \glsxtrGeneralLatinAtoGrules
+ \string<glo,Glo,GLO\string<gls,Gls,GLS\string<glsxtr,Glsxtr,GlsXtr,GLSxtr,GLSXTR
+ \glsxtrGeneralLatinHtoMrules
+ \glsxtrGeneralLatinNtoZrules
+}
-\begin{document}
-\DeleteShortVerb{\|}
-\MakeShortVerb{"}
+\nlctuserguidegls[selection=all]
+{
+ \gmod{star}{\common\name{\texttt{*} (modifier)}\field{text}{*}
+ \field{see}{GlsXtrSetStarModifier}}%
+ \gmod{plus}{\common\name{\texttt{+} (modifier)}\field{text}{+}
+ \field{see}{GlsXtrSetPlusModifier}}%
+ \gmod{alt-mod}{\common\name{\meta{alt-mod} (modifier)}\field{text}{\meta{alt-mod}}
+ \field{see}{GlsXtrSetAltModifier}}%
+ \def\gcmdspa#1#2{\glsbibwriteentry{command}{#1}{\field{name}{\csfmt{#1}}\field{modifiers}{star,plus,alt-mod}#2}}%
+ \def\gprintglossopt#1#2{%
+ \glsbibwriteentry{commandoption}{opt.printgloss.#1}{%
+ \field{name}{\csoptfmt{#1}}\parent{idx.printglossopt}#2}}%
+ \def\gprintunsrttableopt#1#2{%
+ \glsbibwriteentry{commandoption}{opt.printunsrttab.#1}{%
+ \parent{printunsrttable}%
+ \field{name}{\csoptfmt{#1}}#2}}%
+ \def\gtableblockstyle#1#2{%
+ \glsbibwriteentry{commandoption}{optval.printunsrttab.block-style.#1}{%
+ \parent{opt.printunsrttab.block-style}%
+ \field{name}{\optfmt{#1}}#2}}%
+ \def\gglsopt#1#2{%
+ \glsbibwriteentry{commandoption}{opt.glsopt.#1}{%
+ \field{name}{\csoptfmt{#1}}\parent{idx.glsopt}#2}}%
+ \def\gmglsopt#1#2{%
+ \glsbibwriteentry{commandoption}{opt.mglsopt.#1}{%
+ \field{name}{\csoptfmt{#1}}\parent{idx.mglsopt}#2}}%
+ \def\ggloskey#1#2{%
+ \glsbibwriteentry{commandoption}{opt.gloskey.#1}{%
+ \field{name}{\csoptfmt{#1}}\parent{idx.gloskey}#2}}%
+ \def\gglosfield#1#2{%
+ \glsbibwriteentry{commandoption}{opt.glosfield.#1}{%
+ \field{name}{\csoptfmt{#1}}\parent{idx.glosfield}#2}}%
+ \def\gcat#1#2{%
+ \glsbibwriteentry{optionvalue}{opt.cat.#1}{%
+ \field{name}{\catfmt{#1}}\parent{idx.category}#2}}%
+ \def\gcatattr#1#2{%
+ \glsbibwriteentry{optionvalue}{opt.catattr.#1}{%
+ \field{name}{\csoptfmt{#1}}\parent{idx.categoryattribute}#2}}%
+ \def\gglosty#1#2{\glsbibwriteentry{glossarystyle}{opt.glostyle.#1}%
+ {\field{name}{\glostylefmt{#1}}\parent{idx.glossarystyle}#2}}%
+ \def\gabbrsty#1#2{\glsbibwriteentry{abbreviationstyle}{opt.abbrstyle.#1}%
+ {\field{name}{\abbrstylefmt{#1}}\parent{idx.abbrvstyle}#2}}%
+ \def\gabbrstyalias#1#2{\gabbrsty{#1}{\field{alias}{opt.abbrstyle.#2}}}%
+ \def\gdepabbrsty#1#2{\gabbrsty{#1}{\deprecated\field{alias}{opt.abbrstyle.#2}}}%
+ \def\gacrsty#1#2{\glsbibwriteentry{acronymstyle}{opt.acrstyle.#1}%
+ {\field{name}{\acrstylefmt{#1}}\parent{idx.acronymstyle}#2}}%
+ \def\gresourceopt#1#2{%
+ \glsbibwriteentry{commandoption}{opt.resource.#1}{%
+ \field{name}{\csoptfmt{#1}}\parent{idx.resourceopt}#2}}%
+ % sample files:
+ \gidx{samplefile}{\name{sample files}\field{text}{sample file}}%
+ \gfile{sample.tex}{}% file: sample.tex
+ \gfile{sample\dhyphen abbr\dhyphen styles.tex}{}% file: sample-abbr-styles.tex
+ \gfile{sample\dhyphen mixture.tex}{}% file: sample-mixture.tex
+ \gfile{sample\dhyphen name\dhyphen font.tex}{}% file: sample-name-font.tex
+ \gfile{sample\dhyphen abbrv.tex}{}% file: sample-abbrv.tex
+ \gfile{sample\dhyphen acronym.tex}{}% file: sample-acronym.tex
+ \gfile{sample\dhyphen acronym\dhyphen desc.tex}{}% file: sample-acronym-desc.tex
+ \gfile{sample\dhyphen crossref.tex}{}% file: sample-crossref.tex
+ \gfile{sample\dhyphen indexhook.tex}{}% file: sample-indexhook.tex
+ \gfile{sample\dhyphen footnote.tex}{}% file: sample-footnote.tex
+ \gfile{sample\dhyphen undef.tex}{}% file: sample-undef.tex
+ \gfile{sample\dhyphen mixed\dhyphen abbrv\dhyphen styles.tex}{}% file: sample-mixed-abbrv-styles.tex
+ \gfile{sample\dhyphen initialisms.tex}{}% file: sample-initialisms.tex
+ \gfile{sample\dhyphen postdot.tex}{}% file: sample-postdot.tex
+ \gfile{sample\dhyphen postlink.tex}{}% file: sample-postlink.tex
+ \gfile{sample\dhyphen header.tex}{}% file: sample-header.tex
+ \gfile{sample\dhyphen autoindex.tex}{}% file: sample-autoindex.tex
+ \gfile{sample\dhyphen autoindex\dhyphen hyp.tex}{}% file: sample-autoindex-hyp.tex
+ \gfile{sample\dhyphen nested.tex}{}% file: sample-nested.tex
+ \gfile{sample\dhyphen entrycount.tex}{}% file: sample-entrycount.tex
+ \gfile{sample\dhyphen unitentrycount.tex}{}% file: sample-unitentrycount.tex
+ \gfile{sample\dhyphen onelink.tex}{}% file: sample-onelink.tex
+ \gfile{sample\dhyphen linkcount.tex}{}% file: sample-linkcount.tex
+ \gfile{sample\dhyphen pages.tex}{}% file: sample-pages.tex
+ \gfile{sample\dhyphen altmodifier.tex}{}% file: sample-altmodifier.tex
+ \gfile{sample\dhyphen mixedsort.tex}{}% file: sample-mixedsort.tex
+ \gfile{sample\dhyphen external.tex}{}% file: sample-external.tex
+ \gfile{sample\dhyphen fmt.tex}{}% file: sample-fmt.tex
+ \gfile{sample\dhyphen alias.tex}{}% file: sample-alias.tex
+ \gfile{sample\dhyphen alttree.tex}{}% file: sample-alttree.tex
+ \gfile{sample\dhyphen alttree\dhyphen sym.tex}{}% file: sample-alttree-sym.tex
+ \gfile{sample\dhyphen alttree\dhyphen marginpar.tex}{}% file: sample-alttree-marginpar.tex
+ \gfile{sample\dhyphen onthefly.tex}{}% file: sample-onthefly.tex
+ \gfile{sample\dhyphen onthefly\dhyphen xetex.tex}{}% file: sample-onthefly-xetex.tex
+ \gfile{sample\dhyphen onthefly\dhyphen utf8.tex}{}% file: sample-onthefly-utf8.tex
+ \gfile{sample\dhyphen accsupp.tex}{}% file: sample-accsupp.tex
+ \gfile{sample\dhyphen prefix.tex}{}% file: sample-prefix.tex
+ \gfile{sample\dhyphen suppl.tex}{}% file: sample-suppl.tex
+ \gfile{sample\dhyphen suppl\dhyphen main.tex}{}% file: sample-suppl-main.tex
+ \gfile{sample\dhyphen suppl\dhyphen hyp.tex}{}% file: sample-suppl-hyp.tex
+ \gfile{sample\dhyphen suppl\dhyphen main\dhyphen hyp.tex}{}% file: sample-suppl-main-hyp.tex
+ % example files with dummy entries for testing
+ % example-glossaries-xr.tex
+ \gfile{example\dhyphen glossaries\dhyphen xr.tex}%
+ {\providedby{\sty{glossaries-extra} v1.16+}}%
+ % example-glossaries-xr.bib
+ \gfile{example\dhyphen glossaries\dhyphen xr.bib}%
+ {\providedby{\sty{glossaries-extra} v1.19+}}%
+ % example-glossaries-symbolsnames.bib
+ \gfile{example\dhyphen glossaries\dhyphen symbolsnames.bib}%
+ {\providedby{\sty{glossaries-extra} v1.39+}}%
+ % example-glossaries-acronym-desc.bib
+ \gfile{example\dhyphen glossaries\dhyphen acronym\dhyphen desc.bib}%
+ {\providedby{\sty{glossaries-extra} v1.19+}}%
+ % example-glossaries-longchild.bib
+ \gfile{example\dhyphen glossaries\dhyphen longchild.bib}%
+ {\providedby{\sty{glossaries-extra} v1.19+}}%
+ % example-glossaries-acronyms-lang.bib
+ \gfile{example\dhyphen glossaries\dhyphen acronyms\dhyphen lang.bib}%
+ {\providedby{\sty{glossaries-extra} v1.19+}}%
+ % example-glossaries-long.bib
+ \gfile{example\dhyphen glossaries\dhyphen long.bib}%
+ {\providedby{\sty{glossaries-extra} v1.19+}}%
+ % example-glossaries-acronym.bib
+ \gfile{example\dhyphen glossaries\dhyphen acronym.bib}%
+ {\providedby{\sty{glossaries-extra} v1.19+}}%
+ % example-glossaries-multipar.bib
+ \gfile{example\dhyphen glossaries\dhyphen multipar.bib}%
+ {\providedby{\sty{glossaries-extra} v1.19+}}%
+ % example-glossaries-brief.bib
+ \gfile{example\dhyphen glossaries\dhyphen brief.bib}%
+ {\providedby{\sty{glossaries-extra} v1.19+}}%
+ % example-glossaries-parent.bib
+ \gfile{example\dhyphen glossaries\dhyphen parent.bib}%
+ {\providedby{\sty{glossaries-extra} v1.19+}}%
+ % example-glossaries-childmultipar.bib
+ \gfile{example\dhyphen glossaries\dhyphen childmultipar.bib}%
+ {\providedby{\sty{glossaries-extra} v1.19+}}%
+ % example-glossaries-symbolnames.bib
+ \gfile{example\dhyphen glossaries\dhyphen symbolnames.bib}%
+ {\providedby{\sty{glossaries-extra} v1.19+}}%
+ % example-glossaries-childnoname.bib
+ \gfile{example\dhyphen glossaries\dhyphen childnoname.bib}%
+ {\providedby{\sty{glossaries-extra} v1.19+}}%
+ % example-glossaries-symbols.bib
+ \gfile{example\dhyphen glossaries\dhyphen symbols.bib}%
+ {\providedby{\sty{glossaries-extra} v1.19+}}%
+ % example-glossaries-cite.bib
+ \gfile{example\dhyphen glossaries\dhyphen cite.bib}%
+ {\providedby{\sty{glossaries-extra} v1.19+}}%
+ % example-glossaries-url.bib
+ \gfile{example\dhyphen glossaries\dhyphen url.bib}%
+ {\providedby{\sty{glossaries-extra} v1.19+}}%
+ % example-glossaries-images.bib
+ \gfile{example\dhyphen glossaries\dhyphen images.bib}%
+ {\providedby{\sty{glossaries-extra} v1.19+}}%
+ % packages:
+ \gpkg{glossaries}% glossaries.sty
+ {%
+ \common
+ \syntax{\meta{options}}%
+ \note{automatically loaded with
+ \code{\csfmt{usepackage}\marg{glossaries-extra}}}
+ \desc{base package. When loaded implicitly with
+ \sty{glossaries-extra}, any relevant options will be passed to the
+ base \sty{glossaries} package}
+ }
+ \gpkg{glossaries\dhyphen extra}% glossaries-extra.sty
+ {%
+ \common
+ \syntax{\meta{options}}%
+ \desc{extension package that loads \sty{glossaries}, provides
+ additional commands, and modifies some of the base
+ \sty{glossaries} commands to integrate them with the new
+ commands or to make them more flexible}
+ }
+ \gpkg{glossaries\dhyphen extra\dhyphen stylemods}% glossaries-extra-stylemods.sty
+ {%
+ \syntax{\meta{options}}%
+ \note{or \code{\csfmt{usepackage}[\optval{stylemods}{\meta{options}}]\marg{glossaries-extra}}}
+ \desc{modifies the \idxpl{glossarystyle} supplied with the base \sty{glossaries}
+ package to make them more flexible and to integrate support
+ for features provided by \sty{glossaries-extra} or \app{bib2gls}}
+ }
+ % glossaries-extra-bib2gls.sty
+ \gpkg{glossaries\dhyphen extra\dhyphen bib2gls}%
+ {%
+ \note{automatically loaded with
+ \code{\csfmt{usepackage}[\opt{record}]\marg{glossaries-extra}}
+ or
+ \code{\csfmt{usepackage}[\opteqvalref{record}{nameref}]\marg{glossaries-extra}}}%
+ \desc{provides additional commands that may be used with
+ \app{bib2gls}}
+ }
+ % glossaries-prefix.sty
+ \gpkg{glossaries\dhyphen prefix}%
+ {%
+ \syntax{\meta{options}}%
+ \note{automatically loaded with
+ \code{\csfmt{usepackage}[\opt{prefix}]\marg{glossaries-extra}}}
+ \desc{provides additional keys and commands to associated
+ prefixes with \idx{glossary} entries. If loaded on its own, it will
+ automatically load \sty{glossaries} with the given options}
+ }
+ % glossaries-accsupp.sty
+ \gpkg{glossaries\dhyphen accsupp}%
+ {%
+ \syntax{\meta{options}}%
+ \note{automatically loaded with
+ \code{\csfmt{usepackage}[\opt{accsupp}]\marg{glossaries-extra}}}
+ \desc{provides additional keys and commands to make it easier to
+ integrate accessibility support into \idx{glossary} entry definitions.
+ If loaded on its own, it will automatically load \sty{glossaries}
+ with the given options}
+ }
+ % glossaries-hypernav.sty
+ \gpkg{glossary\dhyphen hypernav}%
+ {%
+ \note{automatically loaded with \code{\csfmt{usepackage}\marg{glossaries}}}
+ \desc{provides support for \idxpl{glossarystyle}, such as \glostyle{listhypergroup}}
+ }
+ % glossaries-list.sty
+ \gpkg{glossary\dhyphen list}%
+ {%
+ \note{automatically loaded with \code{\csfmt{usepackage}\marg{glossaries}}}
+ \desc{provides list-like \idxpl{glossarystyle}, such as
+ \glostyle{list}. These styles are patched by \sty{glossaries-extra-stylemods}}
+ }
+ % glossaries-tree.sty
+ \gpkg{glossary\dhyphen tree}%
+ {%
+ \note{automatically loaded with \code{\csfmt{usepackage}\marg{glossaries}}}
+ \desc{provides \hierarchical\ index or tree-like \idxpl{glossarystyle}, such as
+ \glostyle{index} and \glostyle{tree}.
+ These styles are patched by \sty{glossaries-extra-stylemods}}
+ }
+ % glossaries-mcols.sty
+ \gpkg{glossary\dhyphen mcols}%
+ {%
+ \note{load explicitly or with
+ \code{\csfmt{usepackage}[\opt{stylemods}\dequals mcols]\marg{glossaries-extra}}}
+ \desc{provides multicolumn \hierarchical\ index and tree-like
+ \idxpl{glossarystyle},
+ such as \glostyle{mcolindex} and \glostyle{mcoltree}. This package
+ automatically loads \sty{glossary-tree} and \sty{multicol}.
+ These styles are patched by \sty{glossaries-extra-stylemods}}
+ }
+ % glossaries-inline.sty
+ \gpkg{glossary\dhyphen inline}%
+ {%
+ \note{load explicitly or with
+ \code{\csfmt{usepackage}[\optval{stylemods}{inline}]\marg{glossaries-extra}}}
+ \desc{provides the \glostyle{inline} \idx{glossarystyle}.
+ This style is patched by \sty{glossaries-extra-stylemods}}
+ }
+ % glossaries-long.sty
+ \gpkg{glossary\dhyphen long}%
+ {%
+ \note{automatically loaded with \code{\csfmt{usepackage}\marg{glossaries}}}
+ \desc{provides tabular-like \idxpl{glossarystyle}, such as
+ \glostyle{long} that use the \sty{longtable} package.
+ These styles are patched by \sty{glossaries-extra-stylemods}}
+ }
+ % glossaries-longbooktabs.sty
+ \gpkg{glossary\dhyphen longbooktabs}%
+ {%
+ \note{load explicitly or with
+ \code{\csfmt{usepackage}[\optval{stylemods}{longbooktabs}]\marg{glossaries-extra}}}
+ \desc{provides tabular-like \idxpl{glossarystyle}, such as
+ \glostyle{long\dhyphen booktabs} that use the \sty{longtable} package with
+ the \sty{booktabs} package to provide horizontal rules.
+ These styles are patched by \sty{glossaries-extra-stylemods}}
+ }
+ % glossaries-longragged.sty
+ \gpkg{glossary\dhyphen longragged}%
+ {%
+ \note{load explicitly or with
+ \code{\csfmt{usepackage}[\optval{stylemods}{longragged}]\marg{glossaries-extra}}}
+ \desc{provides tabular-like \idxpl{glossarystyle}, such as
+ \glostyle{longragged} that use the \sty{longtable} package with
+ the \sty{array} package to left-justify the description column.
+ These styles are patched by \sty{glossaries-extra-stylemods}}
+ }
+ % glossaries-super.sty
+ \gpkg{glossary\dhyphen super}%
+ {%
+ \note{automatically loaded with \code{\csfmt{usepackage}\marg{glossaries}}}
+ \desc{provides tabular-like \idxpl{glossarystyle}, such as
+ \glostyle{super} that use the \sty{supertabular} package.
+ These styles are patched by \sty{glossaries-extra-stylemods}}
+ }
+ % glossaries-superragged.sty
+ \gpkg{glossary\dhyphen superragged}%
+ {%
+ \note{load explicitly or with
+ \code{\csfmt{usepackage}[\optval{stylemods}{superragged}]\marg{glossaries-extra}}}
+ \desc{provides tabular-like \idxpl{glossarystyle}, such as
+ \glostyle{superragged} that use the \sty{supertabular} package with
+ the \sty{array} package to left-justify the description column.
+ These styles are patched by \sty{glossaries-extra-stylemods}}
+ }
+ % glossaries-bookindex.sty
+ \gpkg{glossary\dhyphen bookindex}%
+ {%
+ \note{load explicitly or with
+ \code{\csfmt{usepackage}[\optval{stylemods}{bookindex}]\marg{glossaries-extra}}}
+ \desc{provides the \glostyle{bookindex} \idx{glossarystyle}, which
+ doesn't show descriptions. This package is distributed with
+ \sty{glossaries-extra}}
+ }
+ % glossaries-longextra.sty
+ \gpkg{glossary\dhyphen longextra}%
+ {%
+ \note{load explicitly or with
+ \code{\csfmt{usepackage}[\optval{stylemods}{longextra}]\marg{glossaries-extra}}}
+ \desc{provides more flexible tabular-like \idxpl{glossarystyle}, such
+ as \glostyle{long-name-desc}. This package is distributed with
+ \sty{glossaries-extra} and automatically loads
+ \sty{glossary-longbooktabs}}
+ }
+ % glossaries-topic.sty
+ \gpkg{glossary\dhyphen topic}%
+ {%
+ \note{load explicitly or with
+ \code{\csfmt{usepackage}[\optval{stylemods}{topic}]\marg{glossaries-extra}}}
+ \desc{provides the \hierarchical\ \glostyle{topic} and \glostyle{topicmcols}
+ \idxpl{glossarystyle}. This package is distributed with
+ \sty{glossaries-extra} and automatically loads \sty{multicol}}
+ }
+ % glossaries-table.sty
+ \gpkg{glossary\dhyphen table}%
+ {%
+ \note{load explicitly or with
+ \code{\csfmt{usepackage}[\optval{stylemods}{table}]\marg{glossaries-extra}}}
+ \desc{provides \gls{printunsrttable} and its custom style.
+ This package is distributed with
+ \sty{glossaries-extra} and automatically loads
+ \sty{glossary-longbooktabs}}
+ }
+ % OTHER PACKAGES:
+ \gpkg{long\-table}{}% longtable.sty
+ \gpkg{super\-tabular}{}% supertabular.sty
+ \gpkg{array}{}% array.sty
+ \gpkg{book\-tabs}{}% booktabs.sty
+ \gpkg{multi\-col}{}% multicol.sty
+ \gpkg{babel}{}% babel.sty
+ \gpkg{poly\-glossia}{}% polyglossia.sty
+ \gpkg{translator}{}% translator.sty
+ \gcls{memoir}{}% memoir.cls
+ \gcls{beamer}{}% beamer.cls
+ \gpkg{hyper\-ref}{}% hyperref.sty
+ \gpkg{get\-title\-string}{}% gettitlestring
+ \gpkg{name\-ref}{}% nameref
+ \gpkg{ams\-math}{}% amsmath.sty
+ \gpkg{etool\-box}{}% etoolbox.sty
+ \gpkg{soul}{}% soul.sty
+ \gpkg{input\-enc}{}% inputenc.sty
+ \gpkg{font\-enc}{}% fontenc.sty
+ \gpkg{rel\-size}{}% relsize.sty
+ \gpkg{acc\-supp}{}% accsupp.sty
+ \gpkg{text\-case}{}% textcase.sty
+ \gpkg{up\-greek}{}% upgreek.sty
+ \gpkg{title\-string}{}% titlestring.sty
+ \gpkg{xfor}{}% xfor.sty
+ \gpkg{fancy\-hdr}{}% fancyhdr.sty
+ % mfirstuc package
+ \gpkg{mfirst\-uc}{}% mfirstuc.sty
+ % \makefirstuc
+ \gcmd{make\-first\-uc}%
+ {%
+ \syntax{\margm{text}}
+ \providedby{\sty{mfirstuc}}
+ \desc{robust command that converts the first character of \meta{text} to
+ \idx{uppercase}\glsadd{idx.sentencecase} unless \meta{text}
+ starts with a command, in which case it will attempt to apply
+ the \idx{casechange} to the first character of the first
+ argument following the command, if the command is followed by a
+ group. As from \sty{mfirstuc} v2.08, this command internally
+ uses \gls{MFUsentencecase} to perform the actual case-change.
+ See the \sty{mfirstuc} documentation for further details, either:
+ \texdocref{mfirstuc} or visit \ctanpkg{mfirstuc}}
+ }
+ % \MFUsentencecase
+ \gcmd{MFU\-sentence\-case}%
+ {%
+ \syntax{\margm{text}}
+ \providedby{\sty{mfirstuc} v2.08+}
+ \desc{fully expands \meta{text} and converts the first letter to
+ \idx{uppercase}\glsadd{idx.sentencecase}. Unlike
+ \gls{makefirstuc}, this command is expandable, but only
+ recognises commands identified as exclusions. See the
+ \sty{mfirstuc} documentation for further details. This command
+ is provided by \sty{glossaries-extra} v1.49+ if an old version
+ of \sty{mfirstuc} is detected}
+ }
+ % \glsmakefirstuc
+ \gcmd{gls\-make\-first\-uc}%
+ {%
+ \syntax{\margm{text}}
+ \providedby{\sty{mfirstuc} v1.05+}
+ \desc{used by \gls{makefirstuc} to perform the actual
+ case-change. As from \sty{mfirstuc} v2.08+ this just uses
+ \gls{MFUsentencecase}}
+ }
+ % \MFUexcl
+ \gcmd{MFU\-excl}
+ {
+ \providedby{\sty{mfirstuc} v2.08+}
+ \syntax{\margm{cs}}%
+ \desc{locally identifies \meta{cs} as an exclusion command,
+ which will be recognised by both \gls{makefirstuc} and
+ \gls{MFUsentencecase}}
+ \field{seealso}{MFUblocker,MFUaddmap}
+ }
+ % \MFUblocker
+ \gcmd{MFU\-blocker}
+ {
+ \providedby{\sty{mfirstuc} v2.08+}
+ \syntax{\margm{cs}}%
+ \desc{locally identifies \meta{cs} as a blocker command for
+ \gls{makefirstuc} and an exclusion for \gls{MFUsentencecase}
+ (which doesn't support blockers)}
+ \field{seealso}{MFUexcl,MFUaddmap}
+ }
+ % \MFUaddmap
+ \gcmd{MFU\-add\-map}
+ {
+ \providedby{\sty{mfirstuc} v2.08+}
+ \syntax{\margm{cs1}\margm{cs2}}%
+ \desc{identifies a mapping from the command \meta{cs1} to
+ command \meta{cs2} for \gls{makefirstuc} and also identifies
+ \meta{cs2} as a blocker. Mappings and blockers aren't supported
+ by \gls{MFUsentencecase}, so both \meta{cs1} and \meta{cs2} are
+ identified as exclusions for \gls{MFUsentencecase}}
+ \field{seealso}{MFUexcl,MFUblocker}
+ }
+ % \glsmfuexcl
+ \gcmd{gls\-mfu\-excl}
+ {
+ \providedby{\sty{glossaries} v4.50+ \& \sty{glossaries-extra} v1.49+}
+ \syntax{\margm{cs}}%
+ \desc{if \sty{mfirstuc} v2.08+ is installed, this will use
+ \gls+{MFUexcl}, otherwise it will implement something similar.
+ See \sectionref{sec:firstuc} for further details}
+ }
+ % \glsmfublocker
+ \gcmd{gls\-mfu\-block\-er}
+ {
+ \providedby{\sty{glossaries} v4.50+ \& \sty{glossaries-extra} v1.49+}
+ \syntax{\margm{cs}}%
+ \desc{if \sty{mfirstuc} v2.08+ is installed, this will use
+ \gls+{MFUblocker}, otherwise it will use \gls{glsmfuexcl} instead.
+ See \sectionref{sec:firstuc} for further details}
+ }
+ % \glsmfuaddmap
+ \gcmd{gls\-mfu\-add\-map}
+ {
+ \providedby{\sty{glossaries} v4.50+ \& \sty{glossaries-extra} v1.49+}
+ \syntax{\margm{cs1}\margm{cs2}}%
+ \desc{if \sty{mfirstuc} v2.08+ is installed, this will use
+ \gls+{MFUaddmap}, otherwise it will use \gls{glsmfuexcl} instead.
+ See \sectionref{sec:firstuc} for further details}
+ }
+ % \glssentencecase
+ \gcmd{gls\-sentence\-case}
+ {
+ \providedby{\sty{glossaries} v4.50+ \& \sty{glossaries-extra} v1.49+}
+ \syntax{\margm{text}}
+ \desc{used by \idx{sentencecase} commands, such as \gls{Gls}, to
+ perform the case change. This is simply defined to use
+ \gls{makefirstuc}}
+ }
+ % \capitalisewords
+ \gcmd{capitalise\-words}%
+ {%
+ \providedby{\sty{mfirstuc} v1.06+}
+ \syntax{\margm{text}}
+ \desc{converts \meta{text} to \idx{titlecase}. Limitations
+ apply, see the \sty{mfirstuc} documentation for further details, either:
+ \texdocref{mfirstuc} or visit \ctanpkg{mfirstuc}}
+ }
+ % \capitalisefmtwords
+ \gcmd{capitalise\-fmt\-words}%
+ {%
+ \providedby{\sty{mfirstuc} v2.03+}
+ \syntax{\margm{text}}
+ \desc{converts \meta{text} to \idx{titlecase}, where \meta{text}
+ may contain text-block commands. The starred form only permits a
+ text-block command at the start of the argument. Limitations
+ apply, see the \sty{mfirstuc} documentation for further details, either:
+ \texdocref{mfirstuc} or visit \ctanpkg{mfirstuc}}
+ }
+ % \xcapitalisefmtwords
+ \gcmd{xcapitalise\-fmt\-words}%
+ {%
+ \providedby{\sty{mfirstuc} v2.03+}
+ \syntax{\margm{text}}
+ \desc{passes the argument to \gls{capitalisefmtwords} but with the
+ first token in \meta{text} expanded. The starred version uses
+ the starred version of \gls{capitalisefmtwords}}
+ }
+ % \mfirstucMakeUppercase
+ \gcmd{mfirst\-uc\-Make\-Upper\-case}
+ {
+ \providedby{\sty{mfirstuc}}
+ \syntax{\margm{text}}
+ \desc{this command was used by \gls{makefirstuc} to convert its argument to
+ \idx{allcaps} and was redefined by \sty{glossaries} to use
+ \gls{MakeTextUppercase}, but with \sty{mfirstuc} v2.08+ and
+ \sty{glossaries} v4.50+ this command is instead defined
+ to use the \LaTeX3 \idx{allcaps} command, which is expandable.
+ This command is no longer used by \gls{makefirstuc} (which instead uses
+ \gls{MFUsentencecase}) or by \sty{glossaries} v4.50+ (which now
+ uses \gls{glsuppercase} for \idx{allcaps} commands such as \gls{GLS})}
+ }
+ % \MFUsaveatend
+ \gcmd{MFU\-save\-at\-end}
+ {
+ \providedby{\sty{mfirstuc} v2.08+}
+ \desc{saves the list of exclusions, blockers
+ and mappings to the \ext{aux} file (if required by some
+ external tool, such as \app{bib2gls}) at the end of the document.
+ This command sets itself to \cmd{relax} so it
+ doesn't repeat the action if used multiple times, but it can
+ be overridden by \gls{MFUsave}}
+ }
+ % \MFUsave
+ \gcmd{MFU\-save}
+ {
+ \providedby{\sty{mfirstuc} v2.08+}
+ \desc{saves the list of exclusions, blockers
+ and mappings to the \ext{aux} file (if required by some
+ external tool, such as \app{bib2gls}).
+ This command sets itself to \cmd{relax} so it
+ doesn't repeat the action if used multiple times, and
+ counteracts any use of \gls{MFUsaveatend}}
+ }
+ % \glslowercase
+ \gcmd{gls\-lower\-case}
+ {
+ \providedby{\sty{glossaries} v4.50+}
+ \syntax{\margm{text}}
+ \desc{converts \meta{text} to \idx{lowercase}}
+ }
+ % \glsuppercase
+ \gcmd{gls\-upper\-case}
+ {
+ \providedby{\sty{glossaries} v4.50+}
+ \syntax{\margm{text}}
+ \desc{converts \meta{text} to \idx{uppercase}}
+ }
+ \gpkg{datatool}{}% datatool.sty
+ \gpkg{datatool\dhyphen base}{}% datatool-base.sty
+ % \DTLformatlist
+ \gcmd{DTL\-format\-list}
+ {
+ \providedby{\sty{datatool-base} v2.28+}
+ \syntax{\margm{csv-list}}
+ \desc{formats the comma-separated list \meta{csv-list}.
+ One-level expansion is performed on \meta{csv-list}. See the
+ \sty{datatool} documentation for further details, either:
+ \texdocref{datatool} or visit \ctanpkg{datatool}}
+ }
+ % \DTLifinlist
+ \gcmd{DTL\-if\-in\-list}
+ {
+ \providedby{\sty{datatool-base}}
+ \syntax{\margm{element}\margm{csv-list}\margm{true}\margm{false}}
+ \desc{does \meta{true} if \meta{element} is contained in the comma-separated
+ list \meta{csv-list}, otherwise does \meta{false}.
+ One-level expansion is performed on \meta{csv-list}, but not on
+ \meta{element}. See the \sty{datatool} documentation for further
+ details, either:
+ \texdocref{datatool} or visit \ctanpkg{datatool}}
+ }
+ \gpkg{track\-lang}{}% tracklang.sty
+ % \CurrentTrackedLanguage
+ \gcmd{Current\-Tracked\-Language}
+ {
+ \providedby{\sty{tracklang}}
+ \syntax{placeholder for use in \ext{ldf} files, expands to the
+ current language label}
+ }
+ % \CurrentTrackedDialect
+ \gcmd{Current\-Tracked\-Dialect}
+ {
+ \providedby{\sty{tracklang}}
+ \syntax{placeholder for use in \ext{ldf} files, expands to the
+ current dialect label}
+ }
+ % applications:
+ \gapp{make\-index}% makeidnex
+ {%
+ \common
+ \syntax{\meta{options} \meta{\idx{indexing} file}}%
+ \desc{a general purpose \idx{indexingapp}}%
+ }
+ \gapp{xindy}%
+ {%
+ \common
+ \syntax{\meta{options} \meta{\idx{indexing} file}}%
+ \desc{a flexible \idx{indexingapp} with multilingual support
+ written in Perl}
+ }
+ \gapp{texindy}%
+ {%
+ \syntax{\meta{options} \meta{\idx{indexing} file}}%
+ \desc{runs \app{xindy} with modules set up for input written in
+ \app{makeindex}['s] syntax}
+ }
+ \gapp{make\-glos\-saries}% makeglossaries
+ {%
+ \syntax{\meta{options} \meta{aux-file}}%
+ \desc{A custom designed Perl script interface
+ to \app+{xindy} and \app+{makeindex} provided with the \sty{glossaries}
+ package}
+ }
+ \gapp{make\-glos\-saries\dhyphen lite}% makeglossaries-lite
+ {%
+ \syntax{\meta{options} \meta{aux-file}}%
+ \desc{A custom designed Lua script interface
+ to \app+{xindy} and \app+{makeindex} provided with the \sty{glossaries}
+ package. This is a cut-down alternative to the Perl
+ \app{makeglossaries} script. If you have Perl installed, use the
+ Perl script instead}
+ }
+ \gapp{make\-glos\-saries\-gui}% makeglossariesgui
+ {%
+ \syntax{\meta{options} \meta{aux-file}}%
+ \desc{A Java \gls{gui} alternative to \app{makeglossaries} that
+ also provides diagnostic tools. Available separately on
+ \CTANpkg{makeglossariesgui}}
+ }
+ \gapp{bib2gls}%
+ {%
+ \common
+ \syntax{\meta{options} \meta{aux-file}}%
+ \desc{an \idx{indexingapp} that combines two functions in
+ one: (1) fetches entry definition from a \ext+{bib} file
+ based on information provided in the \ext+{aux} file (similar
+ to \BibTeX); (2) hierarchically sorts and collates location
+ lists (similar to \app{makeindex} and \app{xindy}).
+ This application is designed for use with \sty{glossaries-extra}
+ and can't be used with just the base \sty{glossaries} package.
+ Available separately on \CTANpkg{bib2gls}}
+ }
+ \gapp{con\-vert\-gls2bib}% convertgls2bib
+ {%
+ \syntax{\meta{options} \meta{tex-file} \meta{bib-file}}%
+ \desc{An application provided with \app{bib2gls} that
+ converts \ext+{tex} files containing entry definitions to
+ \ext+{bib} files suitable for use with \app{bib2gls}.
+ This application is designed for files that just contain entry
+ definitions, but it can work on a complete document file.
+ However, there will be a lot of \qt{undefined command} warnings as
+ \app{convertgls2bib} only has a limited set of known commands. You
+ can limit it so that it only parses the preamble with the
+ \switch{preamble-only} switch (requires at least \app{bib2gls}
+ v2.0)}
+ }
+ \gapp{xindex}{}
+ \gapp{arara}{}
+ % switches
+ % --preamble-only
+ \glongswitch{preamble\dhyphen only}{\inapp{convertgls2bib}}
+ % --index-conversion
+ \glongswitch{index\dhyphen conversion}{\inapp{convertgls2bib}}
+ % -i
+ \gshortswitch{i}{\inapp{bib2gls}\field{alias}{switch.index-conversion}}
+ % --group
+ \glongswitch{group}{\inapp{bib2gls}}
+ % -g
+ \gshortswitch{g}{\inapp{bib2gls}\field{alias}{switch.group}}
+ % --no-group
+ \glongswitch{no\dhyphen group}{\inapp{bib2gls}}
+ % --log-file
+ \glongswitch{log\dhyphen file}{\inapp{bib2gls}}
+ % -t
+ \gshortswitch{t}{\inapp{bib2gls}\field{alias}{switch.log-file}}
+ % --record-count
+ \glongswitch{record\dhyphen count}{\inapp{bib2gls}}
+ % --record-count-rule
+ \glongswitch{record\dhyphen count\dhyphen rule}{\inapp{bib2gls}}
+ % --record-count-unit
+ \glongswitch{record\dhyphen count\dhyphen unit}{\inapp{bib2gls}}
+ % --merge-nameref-on
+ \glongswitch{merge\dhyphen nameref\dhyphen on}{\inapp{bib2gls}}
+ % COMMANDS: ABBREVIATIONS
+ % \newabbreviation
+ \gcmd{new\-ab\-bre\-vi\-a\-tion}%
+ {%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{options}\margm{entry-label}\margm{short}\margm{long}}
+ \desc{defines a new entry that represents an abbreviation.
+ This internally uses \gls{newglossaryentry} and any provided
+ \meta{options} (\idxpl{gloskey}) will be appended. The
+ \gloskey{category} is set to \cat{abbreviation} by default, but
+ may be overridden in \meta{options}. The
+ appropriate style should be set before the abbreviation is
+ defined with \gls{setabbreviationstyle}}
+ }
+ % \newacronym
+ \gcmd{new\-acronym}%
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\margm{short}\margm{long}}
+ \desc{this command is provided by the base \sty{glossaries}
+ package but is redefined by \sty{glossaries-extra} to use
+ \gls{newabbreviation} with the \gloskey{category} key set to
+ \cat{acronym}. The
+ appropriate style should be set before the abbreviation is
+ defined with
+ \code{\gls{setabbreviationstyle}\oarg{acronym}\margm{style}}.
+ You can override the \gloskey{category} in \meta{options} but
+ remember to change the optional argument of
+ \gls{setabbreviationstyle} to match}
+ }%
+ % \GlsXtrEnableInitialTagging
+ \gcmds{Gls\-Xtr\-Enable\-Initial\-Tagging}%
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.2+}
+ \syntax{\margm{categories}\margm{cs}}
+ \desc{robustly defines the command \meta{cs} to accept a single
+ argument, which is a letter (or letters) that needs to be
+ tagged. The unstarred version triggers an error if \meta{cs} is
+ already defined. The unstarred version will redefine \meta{cs} if
+ it already exists}
+ }
+ % \glsxtrtagfont
+ \gcmd{gls\-xtr\-tag\-font}%
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.2+}
+ \syntax{\margm{text}}
+ \desc{used by the tagging command defined with \gls{GlsXtrEnableInitialTagging}}
+ }
+ % \GlsXtrDefineAbbreviationShortcuts
+ \gcmd{Gls\-Xtr\-Define\-Abbreviation\-Shortcuts}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{used by \opteqvalref{shortcuts}{abbreviations} and
+ \opteqvalref{shortcuts}{all}. This
+ command redefines itself to do nothing because it can only be
+ used once}
+ }
+ % \GlsXtrDefineAcronymShortcuts
+ \gcmd{Gls\-Xtr\-Define\-Acronym\-Shortcuts}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \desc{used by \opteqvalref{shortcuts}{ac} and
+ \opteqvalref{shortcuts}{acother}. This
+ command redefines itself to do nothing because it can only be
+ used once}
+ }
+ % \GlsXtrDefineOtherShortcuts
+ \gcmd{Gls\-Xtr\-Define\-Other\-Shortcuts}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{used by \opteqvalref{shortcuts}{other} and
+ \opteqvalref{shortcuts}{all}. This
+ command redefines itself to do nothing because it can only be
+ used once}
+ }
+ % COMMANDS: ABBREVIATION STYLES
+ % \setabbreviationstyle
+ \gcmd{set\-ab\-bre\-vi\-a\-tion\-style}%
+ {%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{category}\margm{style-name}}
+ \desc{sets the current \idx{abbrvstyle} to \meta{style-name}
+ for the category identified by \meta{category}. If the
+ optional argument is omitted, \cat{abbreviation} is assumed}
+ }
+ % \setacronymstyle
+ \gcmd{set\-acronym\-style}%
+ {%
+ \providedby{\sty{glossaries} v4.02+}
+ \syntax{\margm{acronym-style-name}}
+ \banned
+ \desc{sets the style for the base \sty{glossaries} package's
+ acronym mechanism. These styles are not compatible with
+ \sty{glossaries-extra}, which redefines \gls{newacronym}
+ to use \gls{newabbreviation}. Use:
+\begin{compactcodebox}
+\gls{setabbreviationstyle}\oarg{acronym}\margm{abbreviation-style-name}
+\end{compactcodebox}
+ with the closest matching \idx{abbrvstyle} instead}
+ }
+ % \RestoreAcronyms
+ \gcmd{Restore\-Acronyms}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{restores \gls{newacronym} to the base \sty{glossaries}
+ mechanism. Not recommended}
+ }
+ % \MakeAcronymsAbbreviations
+ \gcmd{Make\-Acronyms\-Ab\-bre\-vi\-a\-tions}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{counteracts \gls{RestoreAcronyms}. Not recommended}
+ }
+ % \newacronymstyle
+ \gcmd{new\-acronym\-style}%
+ {
+ \providedby{\sty{glossaries} v4.02+}
+ \syntax{\margm{name}\margm{format def}\margm{display defs}}
+ \banned
+ \desc{defines an acronym style for use with the base
+ \sty{glossaries} package's acronym mechanism. These styles are not
+ compatible with \sty{glossaries-extra}. Use
+ \gls{newabbreviationstyle} instead}
+ }
+ % \glsabspace
+ \gcmd{gls\-ab\-space}%
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{label}}
+ \desc{as \gls{glsacspace} but includes \idx{innerformatting}.
+ Unlike \gls{glsacspace}, this command is robust}
+ }
+ % \glsacspace
+ \gcmd{gls\-ac\-space}%
+ {
+ \providedby{\sty{glossaries} v4.16+}
+ \syntax{\margm{label}}
+ \desc{uses a non-breakable space if the short form is less than
+ \gls{glsacspacemax} otherwise uses \csfmt{space}. This command
+ is provided by \sty{glossaries} but has a hard-coded maximum of 3em.
+ This command is redefined by \sty{glossaries-extra} to use
+ \gls{glsacspacemax}}
+ }
+ % \glsacspacemax
+ \gcmd{gls\-ac\-space\-max}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{expands to the maximum value used by \gls{glsacspace}.
+ This is a macro not a register. The default is \code{3em}}
+ }
+ % \firstacronymfont
+ \gcmd{first\-acronym\-font}
+ {
+ \providedby{\sty{glossaries} v1.14+}
+ \syntax{\margm{text}}
+ \desc{used to encapsulate the acronym short form on
+ \idx{firstuse} by the base \sty{glossaries} package. This is
+ redefined by \sty{glossaries-extra} to use \gls{glsfirstabbrvfont}}
+ }
+ % \acronymfont
+ \gcmd{acronym\-font}
+ {
+ \providedby{\sty{glossaries} v1.0+}
+ \syntax{\margm{text}}
+ \desc{used to encapsulate the acronym short form on
+ \idx{subsequentuse} by the base \sty{glossaries} package. This is
+ redefined by \sty{glossaries-extra} to use \gls{glsabbrvfont}}
+ }
+ % \newabbreviationstyle
+ \gcmd{new\-ab\-bre\-vi\-a\-tion\-style}%
+ {%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{style-name}\margm{setup}\margm{display definitions}}
+ \desc{defines an abbreviation style, which can be set with
+ \gls{setabbreviationstyle}}
+ }
+ % \renewabbreviationstyle
+ \gcmd{re\-new\-ab\-bre\-vi\-a\-tion\-style}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \syntax{\margm{style-name}\margm{setup}\margm{display definitions}}
+ \desc{redefines an abbreviation style}
+ \field{seealso}{newabbreviationstyle}
+ }
+ % \letabbreviationstyle
+ \gcmd{let\-ab\-bre\-vi\-a\-tion\-style}
+ {
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \syntax{\margm{new style}\margm{existing style}}
+ \desc{defines a synonym for an existing abbreviation style}
+ }
+ % \ExtraCustomAbbreviationFields
+ \gcmd{Extra\-Custom\-Ab\-bre\-vi\-a\-tion\-Fields}
+ {
+ \providedby{\sty{glossaries-extra} v1.31+}
+ \desc{expands to additional fields that need to be set with \gls{newabbreviation}}
+ }
+ % \glsxtrnewabbrevpresetkeyhook
+ \gcmd{gls\-xtr\-new\-ab\-brev\-preset\-key\-hook}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.2+}
+ \syntax{\margm{options}\margm{label}\margm{short}}
+ \desc{hook provided to adjust initialisation within
+ \gls{newabbreviation}}
+ }
+ % \newabbreviationhook
+ \gcmd{new\-ab\-bre\-vi\-a\-tion\-hook}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{hook provided within \gls{newabbreviation} just before the entry is defined}
+ }
+ % \CustomAbbreviationFields
+ \gcmd{Custom\-Ab\-bre\-vi\-a\-tion\-Fields}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{expands to the default field definitions for the entry}
+ }
+ % \GlsXtrPostNewAbbreviation
+ \gcmd{Gls\-Xtr\-Post\-New\-Ab\-bre\-vi\-a\-tion}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{a hook that's performed after the entry has been defined}
+ }
+ % \glsxtrsetcomplexstyle
+ \gcmd{gls\-xtr\-set\-complex\-style}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{n}}
+ \desc{indicates that the entry given by \meta{entry-label} uses a
+ complex abbreviation style. The second argument \meta{n} should
+ be numeric, which indicates why it doesn't work with the
+ variations of \gls{glsfirst}: 1 (all caps doesn't work), 2 (all caps and insert
+ doesn't work), 3 (insert doesn't work)}
+ }
+ % \glscategorylabel
+ \gcmd{gls\-cat\-e\-gory\-label}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{expands to the category label of the abbreviation that is
+ in the process of being defined by \gls{newabbreviation}. Maybe used
+ in the style hooks (but take care to expand this command, if
+ necessary)}
+ }
+ % \glsxtrorgkeylist
+ \gcmd{gls\-xtr\-org\-key\-list}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{expands to the original option list as it was supplied to
+ \gls{newabbreviation}}
+ }
+ % \glsxtrorgshort
+ \gcmd{gls\-xtr\-org\-short}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \desc{expands to the original short form as it was supplied to
+ \gls{newabbreviation}}
+ }
+ % \glsxtrorglong
+ \gcmd{gls\-xtr\-org\-long}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \desc{expands to the original long form as it was supplied to
+ \gls{newabbreviation}}
+ }
+ % \glskeylisttok
+ \gcmd{gls\-key\-list\-tok}
+ {
+ \providedby{\sty{glossaries}}
+ \desc{a token register that stores the options passed to
+ \gls{newabbreviation}}
+ }
+ % \glslabeltok
+ \gcmd{gls\-label\-tok}
+ {
+ \providedby{\sty{glossaries}}
+ \desc{a token register that stores the entry's label}
+ }
+ % \glsshorttok
+ \gcmd{gls\-short\-tok}
+ {
+ \providedby{\sty{glossaries}}
+ \desc{a token register that stores the short form (which may
+ have been modified after being passed to \gls{newabbreviation})}
+ }
+ % \glsshortpltok
+ \gcmd{gls\-short\-pl\-tok}
+ {
+ %\providedby{\sty{glossaries-extra} v0.3+}
+ \desc{a token register that stores the short plural form (which may
+ have been modified after being passed to \gls{newabbreviation})}
+ }
+ % \glslongtok
+ \gcmd{gls\-long\-tok}
+ {
+ \providedby{\sty{glossaries}}
+ \desc{a token register that stores the long form (which may
+ have been modified after being passed to \gls{newabbreviation})}
+ }
+ % \glslongpltok
+ \gcmd{gls\-long\-pl\-tok}
+ {
+ %\providedby{\sty{glossaries-extra} v0.3+}
+ \desc{a token register that stores the long plural form (which may
+ have been modified after being passed to \gls{newabbreviation})}
+ }
+ % \glsxtrword
+ \gcmd{gls\-xtr\-word}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{word}}
+ \desc{used to mark each word by the \catattr{markwords}
+ and \catattr{markshortwords} attributes}
+ }
+ % \glsxtrwordsep
+ \gcmd{gls\-xtr\-word\-sep}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \desc{used to mark word separator space by the \catattr{markwords}
+ and \catattr{markshortwords} attributes}
+ }
+ % \glsxtrwordsephyphen
+ \gcmd{gls\-xtr\-word\-sep\-hyphen}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{used to mark compound word separator hyphen by the \catattr{markwords}
+ and \catattr{markshortwords} attributes}
+ }
+ % \glsxtrsubsequentfmt
+ \gcmd{gls\-xtr\-sub\-sequent\-fmt}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{used by \gls{glsxtrgenabbrvfmt} to display the subsequent
+ singular form (defined by the abbreviation style)}
+ }
+ % \glsxtrsubsequentplfmt
+ \gcmd{gls\-xtr\-sub\-sequent\-pl\-fmt}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{used by \gls{glsxtrgenabbrvfmt} to display the subsequent
+ plural form (defined by the abbreviation style)}
+ }
+ % \Glsxtrsubsequentfmt
+ \gcmd{Gls\-xtr\-sub\-sequent\-fmt}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{used by \gls{glsxtrgenabbrvfmt} to display the
+ \idx{sentencecase} subsequent
+ singular form (defined by the abbreviation style)}
+ }
+ % \Glsxtrsubsequentplfmt
+ \gcmd{Gls\-xtr\-sub\-sequent\-pl\-fmt}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{used by \gls{glsxtrgenabbrvfmt} to display the
+ \idx{sentencecase} subsequent
+ plural form (defined by the abbreviation style)}
+ }
+ % \GLSxtrsubsequentfmt
+ \gcmd{GLS\-xtr\-sub\-sequent\-fmt}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{used by \gls{glsxtrgenabbrvfmt} to display the
+ \idx{allcaps} subsequent
+ singular form (defined by the abbreviation style)}
+ }
+ % \GLSxtrsubsequentplfmt
+ \gcmd{GLS\-xtr\-sub\-sequent\-pl\-fmt}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{used by \gls{glsxtrgenabbrvfmt} to display the
+ \idx{allcaps} subsequent
+ plural form (defined by the abbreviation style)}
+ }
+ % \glsxtrdefaultsubsequentfmt
+ \gcmd{gls\-xtr\-default\-sub\-sequent\-fmt}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{the default subsequent format style that only shows the
+ short form and insert (with support for \glsopt{innertextformat})}
+ }
+ % \glsxtrdefaultsubsequentplfmt
+ \gcmd{gls\-xtr\-default\-sub\-sequent\-pl\-fmt}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{the default subsequent plural format style that only shows the
+ short form and insert (with support for \glsopt{innertextformat})}
+ }
+ % \Glsxtrdefaultsubsequentfmt
+ \gcmd{Gls\-xtr\-default\-sub\-sequent\-fmt}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{the default \idx{sentencecase} subsequent format style that only shows the
+ short form and insert (with support for \glsopt{innertextformat})}
+ }
+ % \Glsxtrdefaultsubsequentplfmt
+ \gcmd{Gls\-xtr\-default\-sub\-sequent\-pl\-fmt}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{the default \idx{sentencecase} subsequent plural format style that only shows the
+ short form and insert (with support for \glsopt{innertextformat})}
+ }
+ % \GLSxtrdefaultsubsequentfmt
+ \gcmd{GLS\-xtr\-default\-sub\-sequent\-fmt}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{the default \idx{allcaps} subsequent format style that only shows the
+ short form and insert (with support for \glsopt{innertextformat})}
+ }
+ % \GLSxtrdefaultsubsequentplfmt
+ \gcmd{GLS\-xtr\-default\-sub\-sequent\-pl\-fmt}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{the default \idx{allcaps} subsequent plural format style that only shows the
+ short form and insert (with support for \glsopt{innertextformat})}
+ }
+ % \glsxtrfullformat
+ \gcmd{gls\-xtr\-full\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{the singular \idx{displayfullform} (defined by the abbreviation style)}
+ }
+ % \glsxtrfullplformat
+ \gcmd{gls\-xtr\-full\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{the plural \idx{displayfullform} (defined by the abbreviation style)}
+ }
+ % \Glsxtrfullformat
+ \gcmd{Gls\-xtr\-full\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{the \idx{sentencecase} singular \idx{displayfullform} (defined by the abbreviation style)}
+ }
+ % \Glsxtrfullplformat
+ \gcmd{Gls\-xtr\-full\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{the \idx{sentencecase} plural \idx{displayfullform} (defined by the abbreviation style)}
+ }
+ % \GLSxtrfullformat
+ \gcmd{GLS\-xtr\-full\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{the \idx{allcaps} singular \idx{displayfullform} (defined by the abbreviation style)}
+ }
+ % \GLSxtrfullplformat
+ \gcmd{GLS\-xtr\-full\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{the \idx{allcaps} plural \idx{displayfullform} (defined by the abbreviation style)}
+ }
+ % \glsxtrinlinefullformat
+ \gcmd{gls\-xtr\-in\-line\-full\-format}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{used by \gls{glsxtrfull} to display the \idx{inlinefullform}
+ form (defined by the abbreviation style)}
+ }
+ % \Glsxtrinlinefullformat
+ \gcmd{Gls\-xtr\-in\-line\-full\-format}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{used by \gls{Glsxtrfull} to display the \idx{sentencecase} \idx{inlinefullform}
+ form (defined by the abbreviation style)}
+ }
+ % \GLSxtrinlinefullformat
+ \gcmd{GLS\-xtr\-in\-line\-full\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{used by \gls{GLSxtrfull} to display the \idx{allcaps} \idx{inlinefullform}
+ form (defined by the abbreviation style)}
+ }
+ % \glsxtrinlinefullplformat
+ \gcmd{gls\-xtr\-in\-line\-full\-pl\-format}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{used by \gls{glsxtrfullpl} to display the plural \idx{inlinefullform}
+ form (defined by the abbreviation style)}
+ }
+ % \Glsxtrinlinefullplformat
+ \gcmd{Gls\-xtr\-in\-line\-full\-pl\-format}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{used by \gls{Glsxtrfullpl} to display the plural \idx{sentencecase} \idx{inlinefullform}
+ form (defined by the abbreviation style)}
+ }
+ % \GLSxtrinlinefullplformat
+ \gcmd{GLS\-xtr\-in\-line\-full\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{used by \gls{GLSxtrfullpl} to display the plural \idx{allcaps} \idx{inlinefullform}
+ form (defined by the abbreviation style)}
+ }
+ % \glsfirstabbrvfont
+ \gcmd{gls\-first\-abbrv\-font}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{text}}
+ \desc{font formatting command for the short form on \idx{firstuse}, initialised by
+ the abbreviation style}
+ }
+ % \glsabbrvfont
+ \gcmd{gls\-abbrv\-font}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{text}}
+ \desc{font formatting command for the short form, initialised by
+ the abbreviation style}
+ }
+ % \glsxtrrevert
+ \gcmd{gls\-xtr\-revert}{
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{text}}
+ \desc{style-sensitive abbreviation command designed to
+ counteract any font change applied by the style}
+ }
+ % \glsxtrdefaultrevert
+ \gcmd{gls\-xtr\-default\-revert}{
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{text}}
+ \desc{the default definition of \gls{glsxtrrevert}. Simply does
+ \meta{text}}
+ }
+ % \glsxtrscrevert
+ \gcmd{gls\-xtr\-sc\-revert}{
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{text}}
+ \desc{the definition of \gls{glsxtrrevert} used by the \idx{smallcaps} (\qt{sc})
+ \idxpl{abbrvstyle}. Uses \gls{glstextup}}
+ }
+ % \glsxtrscuserrevert
+ \gcmd{gls\-xtr\-sc\-user\-revert}{
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{text}}
+ \desc{the definition of \gls{glsxtrrevert} used by
+ styles like \abbrstyle{long-postshort-sc-user}. Uses \gls{glsxtrscrevert}}
+ }
+ % \glsxtrsconlyrevert
+ \gcmd{gls\-xtr\-sc\-only\-revert}{
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{text}}
+ \desc{the definition of \gls{glsxtrrevert} used by
+ styles like \abbrstyle{long-only-short-sc-only}. Uses \gls{glsxtrscrevert}}
+ }
+ % \glsxtrsmrevert
+ \gcmd{gls\-xtr\-sm\-revert}{
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{text}}
+ \desc{the definition of \gls{glsxtrrevert} used by the smaller (\qt{sm})
+ \idxpl{abbrvstyle}. Uses \gls{textlarger}}
+ }
+ % \glsxtremrevert
+ \gcmd{gls\-xtr\-em\-revert}{
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{text}}
+ \desc{the definition of \gls{glsxtrrevert} used by the emphasized (\qt{em})
+ \idxpl{abbrvstyle}. Uses \gls{textup}}
+ }
+ % \glsinnerfmtabbrvfont
+ \gcmd{gls\-inner\-fmt\-abbrv\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{text}}
+ \desc{robust command that applies both \gls{glsabbrvfont} and
+ \gls{glsxtrgenentrytextfmt} to \meta{text}}
+ }
+ % \glsfirstlongfont
+ \gcmd{gls\-first\-long\-font}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{text}}
+ \desc{font formatting command for the long form on \idx{firstuse}, initialised by
+ the abbreviation style}
+ }
+ % \glslongfont
+ \gcmd{gls\-long\-font}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{text}}
+ \desc{font formatting command for the long form, initialised by
+ the abbreviation style}
+ }
+ % \glsxtrlongformat
+ \gcmd{gls\-xtr\-long\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{encapsulates the \gloskey{long} field for the given entry
+ with \meta{fmt-cs}. The \meta{insert} argument is the insertion
+ material supplied in the final optional argument of the
+ \idx{glslike} or \idx{glstextlike} commands. The
+ \gls{ifglsxtrinsertinside}, \idx{innerformatting},
+ and accessibility settings are supported}
+ }
+ % \Glsxtrlongformat
+ \gcmd{Gls\-xtr\-long\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrlongformat} but \idx{sentencecase}}
+ }
+ % \GLSxtrlongformat
+ \gcmd{GLS\-xtr\-long\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrlongformat} but \idx{sentencecase}}
+ }
+ % \glsxtrlongplformat
+ \gcmd{gls\-xtr\-long\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrlongformat} but for the \gloskey{longplural} field}
+ }
+ % \Glsxtrlongplformat
+ \gcmd{Gls\-xtr\-long\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrlongplformat} but \idx{sentencecase}}
+ }
+ % \GLSxtrlongplformat
+ \gcmd{GLS\-xtr\-long\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrlongplformat} but \idx{allcaps}}
+ }
+ % \glsxtrlongformatgrp
+ \gcmd{gls\-xtr\-long\-format\-grp}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrlongformat} but adds grouping around \meta{insert}
+ (with the \idx{innerformatting} inside the group)}
+ }
+ % \Glsxtrlongformatgrp
+ \gcmd{Gls\-xtr\-long\-format\-grp}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrlongformatgrp} but \idx{sentencecase}}
+ }
+ % \GLSxtrlongformatgrp
+ \gcmd{GLS\-xtr\-long\-format\-grp}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrlongformatgrp} but \idx{allcaps}}
+ }
+ % \glsxtrlongplformatgrp
+ \gcmd{gls\-xtr\-long\-pl\-format\-grp}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrlongplformat} but adds grouping around \meta{insert}
+ (with the \idx{innerformatting} inside the group)}
+ }
+ % \Glsxtrlongplformatgrp
+ \gcmd{Gls\-xtr\-long\-pl\-format\-grp}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrlongplformatgrp} but \idx{sentencecase}}
+ }
+ % \GLSxtrlongplformatgrp
+ \gcmd{GLS\-xtr\-long\-pl\-format\-grp}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrlongplformatgrp} but \idx{allcaps}}
+ }
+ % \glsxtrshortformat
+ \gcmd{gls\-xtr\-short\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{encapsulates the \gloskey{short} field for the given entry
+ with \meta{fmt-cs}. The \meta{insert} argument is the insertion
+ material supplied in the final optional argument of the
+ \idx{glslike} or \idx{glstextlike} commands. The
+ \gls{ifglsxtrinsertinside}, \idx{innerformatting},
+ and accessibility settings are supported}
+ }
+ % \Glsxtrshortformat
+ \gcmd{Gls\-xtr\-short\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrshortformat} but \idx{sentencecase}}
+ }
+ % \GLSxtrshortformat
+ \gcmd{GLS\-xtr\-short\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrshortformat} but \idx{allcaps}}
+ }
+ % \glsxtrshortplformat
+ \gcmd{gls\-xtr\-short\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrshortformat} but for the \gloskey{shortplural} field}
+ }
+ % \Glsxtrshortplformat
+ \gcmd{Gls\-xtr\-short\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrshortplformat} but \idx{sentencecase}}
+ }
+ % \GLSxtrshortplformat
+ \gcmd{GLS\-xtr\-short\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrshortplformat} but \idx{allcaps}}
+ }
+ % \glsxtrshortformatgrp
+ \gcmd{gls\-xtr\-short\-format\-grp}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrshortformat} but adds grouping around \meta{insert}
+ (with the \idx{innerformatting} inside the group)}
+ }
+ % \Glsxtrshortformatgrp
+ \gcmd{Gls\-xtr\-short\-format\-grp}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrshortformatgrp} but \idx{sentencecase}}
+ }
+ % \GLSxtrshortformatgrp
+ \gcmd{GLS\-xtr\-short\-format\-grp}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrshortformatgrp} but \idx{allcaps}}
+ }
+ % \glsxtrshortplformatgrp
+ \gcmd{gls\-xtr\-short\-pl\-format\-grp}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrshortplformat} but adds grouping around \meta{insert}
+ (with the \idx{innerformatting} inside the group)}
+ }
+ % \Glsxtrshortplformatgrp
+ \gcmd{Gls\-xtr\-short\-pl\-format\-grp}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrshortplformatgrp} but \idx{sentencecase}}
+ }
+ % \GLSxtrshortplformatgrp
+ \gcmd{GLS\-xtr\-short\-pl\-format\-grp}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrshortplformatgrp} but \idx{allcaps}}
+ }
+ % \glsxtrlongshortformat
+ \gcmd{gls\-xtr\-long\-short\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{formats the long form with \gls{glsxtrlongformat} and the
+ short form in parentheses with \gls{glsxtrshortformat}}
+ }
+ % \Glsxtrlongshortformat
+ \gcmd{Gls\-xtr\-long\-short\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{as \gls{glsxtrlongshortformat} but \idx{sentencecase}}
+ }
+ % \GLSxtrlongshortformat
+ \gcmd{GLS\-xtr\-long\-short\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{as \gls{glsxtrlongshortformat} but \idx{allcaps}}
+ }
+ % \glsxtrlongshortplformat
+ \gcmd{gls\-xtr\-long\-short\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{as \gls{glsxtrlongshortformat} but for the plurals}
+ }
+ % \Glsxtrlongshortplformat
+ \gcmd{Gls\-xtr\-long\-short\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{as \gls{glsxtrlongshortplformat} but \idx{sentencecase}}
+ }
+ % \GLSxtrlongshortplformat
+ \gcmd{GLS\-xtr\-long\-short\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{as \gls{glsxtrlongshortplformat} but \idx{allcaps}}
+ }
+ % \glsxtrshortlongformat
+ \gcmd{gls\-xtr\-short\-long\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{formats the short form with \gls{glsxtrshortformat} and the
+ long form in parentheses with \gls{glsxtrlongformat}}
+ }
+ % \Glsxtrshortlongformat
+ \gcmd{Gls\-xtr\-short\-long\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{as \gls{glsxtrshortlongformat} but \idx{sentencecase}}
+ }
+ % \GLSxtrshortlongformat
+ \gcmd{GLS\-xtr\-short\-long\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{as \gls{glsxtrshortlongformat} but \idx{allcaps}}
+ }
+ % \glsxtrshortlongplformat
+ \gcmd{gls\-xtr\-short\-long\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{as \gls{glsxtrshortlongformat} but for the plurals}
+ }
+ % \Glsxtrshortlongplformat
+ \gcmd{Gls\-xtr\-short\-long\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{as \gls{glsxtrshortlongplformat} but \idx{sentencecase}}
+ }
+ % \GLSxtrshortlongplformat
+ \gcmd{GLS\-xtr\-short\-long\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{as \gls{glsxtrshortlongplformat} but \idx{allcaps}}
+ }
+ % \glsxtrAccSuppAbbrSetNoLongAttrs
+ \gcmd{gls\-xtr\-Acc\-Supp\-Abbr\-Set\-No\-Long\-Attrs}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{category}}
+ \desc{initialised accessibility support for the \gloskey{name},
+ \gloskey{first}, \gloskey{firstplural}, \gloskey{text} and \gloskey{plural}
+ fields (if enabled with
+ \opt{accsupp}). This command is provided for abbreviation styles
+ where the \gloskey{name}, \gloskey{first} and \gloskey{text} are
+ just the formatted abbreviation}
+ }
+ % \glsxtrAccSuppAbbrSetFirstLongAttrs
+ \gcmd{gls\-xtr\-Acc\-Supp\-Abbr\-Set\-First\-Long\-Attrs}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{category}}
+ \desc{initialised accessibility support for the \gloskey{name},
+ \gloskey{text} and \gloskey{plural} fields (if enabled with
+ \opt{accsupp}). This command is provided for abbreviation styles
+ where the \gloskey{name} and \gloskey{text} are just the
+ formatted abbreviation}
+ }
+ % \glsxtrAccSuppAbbrSetTextShortAttrs
+ \gcmd{gls\-xtr\-Acc\-Supp\-Abbr\-Set\-Text\-Short\-Attrs}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{category}}
+ \desc{initialised accessibility support for the
+ \gloskey{text} and \gloskey{plural} fields (if enabled with
+ \opt{accsupp}). This command is provided for abbreviation styles
+ where the \gloskey{text} is just the
+ formatted abbreviation}
+ }
+ % \glsxtrAccSuppAbbrSetNameShortAttrs
+ \gcmd{gls\-xtr\-Acc\-Supp\-Abbr\-Set\-Name\-Short\-Attrs}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{category}}
+ \desc{initialised accessibility support for the
+ \gloskey{name} field (if enabled with
+ \opt{accsupp}). This command is provided for abbreviation styles
+ where only the \gloskey{name} is just the
+ formatted abbreviation}
+ }
+ % \glsxtrAccSuppAbbrSetNameLongAttrs
+ \gcmd{gls\-xtr\-Acc\-Supp\-Abbr\-Set\-Name\-Long\-Attrs}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{category}}
+ \desc{initialised accessibility support for the
+ \gloskey{first}, \gloskey{firstplural}, \gloskey{text} and \gloskey{plural}
+ fields (if enabled with
+ \opt{accsupp}). This command is provided for abbreviation styles
+ where the \gloskey{first} and \gloskey{text} are
+ just the formatted abbreviation}
+ }
+ % \glsxtrprovideaccsuppcmd
+ \gcmd{gls\-xtr\-provide\-acc\-supp\-cmd}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \note{requires \opt{accsupp}}
+ \syntax{\margm{category}\margm{field}}
+ \desc{defines \gls{glsxtrcategoryfieldaccsupp} to
+ \gls{glsshortaccsupp}, if not already defined}
+ }
+ % COMMANDS: ABBREVIATION STYLE USER COMMANDS
+ % \ifglsxtrinsertinside
+ \gcond{if\-gls\-xtr\-insert\-inside}
+ {
+ \providedby{\sty{glossaries-extra} v1.02}
+ \initvalcs{iffalse}
+ \desc{a conditional used by the predefined abbreviation styles to determine
+ whether the \meta{insert} part should go inside or outside of the style's font
+ formatting commands}
+ }
+ % \glsxtrinsertinsidetrue
+ \gcmd{gls\-xtr\-insert\-inside\-true}
+ {
+ \providedby{\sty{glossaries-extra} v1.02}
+ \desc{sets the \gls{ifglsxtrinsertinside} to true}
+ }
+ % \glsxtrinsertinsidefalse
+ \gcmd{gls\-xtr\-insert\-inside\-false}
+ {
+ \providedby{\sty{glossaries-extra} v1.02}
+ \desc{sets the \gls{ifglsxtrinsertinside} conditional to false}
+ }
+ % \glsxtrfullsep
+ \gcmd{gls\-xtr\-full\-sep}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{entry-label}}
+ \desc{Separator used by the parenthetical \idx{inlinefullform}
+ and also for some \idxpl{displayfullform}}
+ }
+ % \glsxtrparen
+ \gcmd{gls\-xtr\-paren}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{text}}
+ \desc{used to encapsulate \meta{text} in parentheses}
+ }
+ % \glsxtrlongshortname
+ \gcmd{gls\-xtr\-long\-short\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.25+}
+ \desc{expands to the name value for \abbrstyle{long-short} styles}
+ }
+ % \glsxtrlongshortdescsort
+ \gcmd{gls\-xtr\-long\-short\-desc\-sort}
+ {
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \desc{expands to the sort value for \abbrstyle{long-short-desc} styles}
+ }
+ % \glsxtrlongshortdescname
+ \gcmd{gls\-xtr\-long\-short\-desc\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \desc{expands to the name value for \abbrstyle{long-short-desc} styles}
+ }
+ % \glsxtrshortlongname
+ \gcmd{gls\-xtr\-short\-long\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.25+}
+ \desc{expands to the name value for \abbrstyle{short-long} styles}
+ }
+ % \glsxtrshortlongdescsort
+ \gcmd{gls\-xtr\-short\-long\-desc\-sort}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \desc{expands to the sort value for \abbrstyle{short-long-desc} styles}
+ }
+ % \glsxtrshortlongdescname
+ \gcmd{gls\-xtr\-short\-long\-desc\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \desc{expands to the name value for \abbrstyle{short-long-desc} styles}
+ }
+ % \glsxtrshortnolongname
+ \gcmd{gls\-xtr\-short\-no\-long\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.25+}
+ \desc{expands to the name value for \abbrstyle{short-nolong} styles}
+ }
+ % \glsxtrlonghyphenshortsort
+ \gcmd{gls\-xtr\-long\-hyphen\-short\-sort}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{expands to the sort value for the \abbrstyle{long-hyphen-short-hyphen}
+ styles}
+ }
+ % \glsxtrshorthyphenlongsort
+ \gcmd{gls\-xtr\-short\-hyphen\-long\-sort}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{expands to the sort value for the \abbrstyle{short-hyphen-long-hyphen}
+ styles}
+ }
+ % \glsxtrlonghyphennoshortdescsort
+ \gcmd{gls\-xtr\-long\-hyphen\-no\-short\-desc\-sort}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{expands to the sort value for the \abbrstyle{long-hyphen-noshort-desc-noreg}
+ styles}
+ }
+ % \glsxtrlonghyphennoshortsort
+ \gcmd{gls\-xtr\-long\-hyphen\-no\-short\-sort}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{expands to the sort value for the \abbrstyle{long-hyphen-noshort-noreg}
+ styles}
+ }
+ % \glsxtruserparen
+ \gcmd{gls\-xtr\-user\-paren}
+ {
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{used by the \qt{user} abbreviation styles, such as
+ \abbrstyle{long-short-user}, to insert the
+ space separator (\gls{glsxtrfullsep}) followed by the parenthetical
+ material (\gls{glsxtrparen}) consisting of \meta{text} and, if set,
+ the value of the field given by \gls{glsxtruserfield}, separated by
+ \gls{glsxtruserparensep}}
+ \field{seealso}{GLSxtruserparen,glsxtruserparensep,glsxtruserfieldfmt}
+ }
+ % \GLSxtruserparen
+ \gcmd{GLS\-xtr\-user\-paren}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{as \gls{glsxtruserparen} but the value of the field given
+ by \gls{glsxtruserfield} is converted to \idx{allcaps}. The
+ \meta{text} argument should already be in \idx{allcaps}}
+ }
+ % \glsxtruserparensep
+ \gcmd{gls\-xtr\-user\-paren\-sep}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{the separator used in the parenthetical content of
+ \gls{glsxtruserparen} and \gls{GLSxtruserparen}}
+ }
+ % \glsxtruserfieldfmt
+ \gcmd{gls\-xtr\-user\-field\-fmt}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{text}}
+ \desc{used to format the value of the field given by
+ \gls{glsxtruserfield} within \gls{glsxtruserparen} and \gls{GLSxtruserparen}}
+ }
+ % \glsxtruserfield
+ \gcmd{gls\-xtr\-user\-field}
+ {
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \desc{expands to the \idxc{internalfieldlabel}{internal label}
+ of the field used to store additional information for the
+ \qt{user} abbreviation styles, such as \abbrstyle{long-short-user}}
+ }
+ % \glsxtruserlongshortformat
+ \gcmd{gls\-xtr\-user\-long\-short\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{used by styles like \abbrstyle{long-short-user} to format
+ the long and short form}
+ }
+ % \Glsxtruserlongshortformat
+ \gcmd{Gls\-xtr\-user\-long\-short\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{as \gls{glsxtruserlongshortformat} but \idx{sentencecase}}
+ }
+ % \GLSxtruserlongshortformat
+ \gcmd{GLS\-xtr\-user\-long\-short\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{as \gls{glsxtruserlongshortformat} but \idx{allcaps}}
+ }
+ % \glsxtruserlongshortplformat
+ \gcmd{gls\-xtr\-user\-long\-short\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{used by styles like \abbrstyle{long-short-user} to format
+ the plural long and plural short form}
+ }
+ % \Glsxtruserlongshortplformat
+ \gcmd{Gls\-xtr\-user\-long\-short\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{as \gls{glsxtruserlongshortplformat} but \idx{sentencecase}}
+ }
+ % \GLSxtruserlongshortplformat
+ \gcmd{GLS\-xtr\-user\-long\-short\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{as \gls{glsxtruserlongshortplformat} but \idx{allcaps}}
+ }
+ % \glsxtrusershortlongformat
+ \gcmd{gls\-xtr\-user\-short\-long\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{used by styles like \abbrstyle{short-long-user} to format
+ the short and long form}
+ }
+ % \Glsxtrusershortlongformat
+ \gcmd{Gls\-xtr\-user\-short\-long\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{as \gls{glsxtrusershortlongformat} but \idx{sentencecase}}
+ }
+ % \GLSxtrusershortlongformat
+ \gcmd{GLS\-xtr\-user\-short\-long\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{as \gls{glsxtrusershortlongformat} but \idx{allcaps}}
+ }
+ % \glsxtrusershortlongplformat
+ \gcmd{gls\-xtr\-user\-short\-long\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{used by styles like \abbrstyle{short-long-user} to format
+ the plural short and plural long form}
+ }
+ % \Glsxtrusershortlongplformat
+ \gcmd{Gls\-xtr\-user\-short\-long\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{as \gls{glsxtrusershortlongplformat} but \idx{sentencecase}}
+ }
+ % \GLSxtrusershortlongplformat
+ \gcmd{GLS\-xtr\-user\-short\-long\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}\margm{long-fmt-cs}\margm{short-fmt-cs}}
+ \desc{as \gls{glsxtrusershortlongplformat} but \idx{allcaps}}
+ }
+ % \glsxtrusershortformat
+ \gcmd{gls\-xtr\-user\-short\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{fmt-cs}}
+ \desc{formats the singular short form in parentheses
+ (with \gls{glsxtruserparen}) in styles like \abbrstyle{long-short-user}}
+ }
+ % \GLSxtrusershortformat
+ \gcmd{GLS\-xtr\-user\-short\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrusershortformat} but \idx{allcaps}}
+ }
+ % \glsxtrusershortplformat
+ \gcmd{gls\-xtr\-user\-short\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{fmt-cs}}
+ \desc{formats the plural short form in parentheses
+ (with \gls{glsxtruserparen}) in styles like \abbrstyle{long-short-user}}
+ }
+ % \GLSxtrusershortplformat
+ \gcmd{GLS\-xtr\-user\-short\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{fmt-cs}}
+ \desc{as \gls{glsxtrusershortplformat} but \idx{allcaps}}
+ }
+ % \glsxtrpostusershortformat
+ \gcmd{gls\-xtr\-post\-user\-short\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{fmt-cs}}
+ \desc{formats the short form in parentheses
+ (with \gls{glsxtruserparen}) in styles like \abbrstyle{long-postshort-user}}
+ }
+ % \glsxtruserlongformat
+ \gcmd{gls\-xtr\-user\-long\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{fmt-cs}}
+ \desc{formats the singular long form in parentheses
+ (with \gls{glsxtruserparen}) in styles like \abbrstyle{short-long-user}}
+ }
+ % \glsxtruserlongplformat
+ \gcmd{gls\-xtr\-user\-long\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{fmt-cs}}
+ \desc{formats the plural long form in parentheses
+ (with \gls{glsxtruserparen}) in styles like \abbrstyle{short-long-user}}
+ }
+ % \GLSxtruserlongformat
+ \gcmd{GLS\-xtr\-user\-long\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{fmt-cs}}
+ \desc{as \gls{glsxtruserlongformat} but \idx{allcaps}}
+ }
+ % \GLSxtruserlongplformat
+ \gcmd{GLS\-xtr\-user\-long\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{fmt-cs}}
+ \desc{as \gls{glsxtruserlongplformat} but \idx{allcaps}}
+ }
+ % \glsxtrpostuserlongformat
+ \gcmd{gls\-xtr\-post\-user\-long\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{fmt-cs}}
+ \desc{formats the long form in parentheses
+ (with \gls{glsxtruserparen}) in styles like \abbrstyle{short-postlong-user}}
+ }
+ % \glsxtrfootnotelongformat
+ \gcmd{gls\-xtr\-foot\-note\-long\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{fmt-cs}}
+ \desc{used in the footnote text to format the singular long form}
+ }
+ % \glsxtrfootnotelongplformat
+ \gcmd{gls\-xtr\-foot\-note\-long\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{fmt-cs}}
+ \desc{used in the footnote text to format the plural long form}
+ }
+ % \glsxtrpostfootnotelongformat
+ \gcmd{gls\-xtr\-post\-foot\-note\-long\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{fmt-cs}}
+ \desc{used in the footnote text to format the long form
+ for styles like \abbrstyle{short-postfootnote}}
+ }
+ % \glsabbrvdefaultfont
+ \gcmd{gls\-abbrv\-default\-font}
+ {
+ %\providedby{\sty{glossaries-extra} v0.3+}
+ \syntax{\margm{text}}
+ \desc{formatting command for the short form
+ used by the abbreviation styles that don't apply a font change
+ by default}
+ }
+ % \glsfirstabbrvdefaultfont
+ \gcmd{gls\-first\-abbrv\-default\-font}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{text}}
+ \desc{formatting command for the short form on \idx{firstuse}
+ used by the abbreviation styles that don't apply a font change
+ by default}
+ }
+ % \glsfirstinnerfmtabbrvfont
+ \gcmd{gls\-first\-inner\-fmt\-abbrv\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{text}}
+ \desc{applies both \gls{glsfirstabbrvfont} and
+ \gls{glsxtrgenentrytextfmt} to \meta{text}}
+ }
+ % \glsfirstxpabbrvfont
+ \gcmd{gls\-first\-xp\-abbrv\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{text}\margm{category}}
+ \desc{if the \catattr{markshortwords} attribute is set for the
+ given category, this encapsulates \meta{text} with
+ \gls{glsfirstabbrvfont} otherwise with
+ \gls{glsfirstinnerfmtabbrvfont}. This command has to expand, so
+ protect any content that shouldn't expand}
+ }
+ % \glsxpabbrvfont
+ \gcmd{gls\-xp\-abbrv\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{text}\margm{category}}
+ \desc{if the \catattr{markshortwords} attribute is set for the
+ given category, this encapsulates \meta{text} with
+ \gls{glsabbrvfont} otherwise with
+ \gls{glsinnerfmtabbrvfont}. This command has to expand, so
+ protect any content that shouldn't expand}
+ }
+ % \glsfirstlongdefaultfont
+ \gcmd{gls\-first\-long\-default\-font}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{text}}
+ \desc{formatting command for the long form on \idx{firstuse}
+ used by the abbreviation styles that don't apply a font change
+ by default}
+ }
+ % \glslongdefaultfont
+ \gcmd{gls\-long\-default\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \syntax{\margm{text}}
+ \desc{formatting command for the long form
+ used by the abbreviation styles that don't apply a font change
+ by default}
+ }
+ % \glslongfootnotefont
+ \gcmd{gls\-long\-foot\-note\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.05+}
+ \syntax{\margm{text}}
+ \desc{formatting command for the long form
+ used by the footnote abbreviation styles}
+ }
+ % \glsfirstlongfootnotefont
+ \gcmd{gls\-first\-long\-foot\-note\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.05+}
+ \syntax{\margm{text}}
+ \desc{formatting command for the \idx{firstuse} long form
+ used by the footnote abbreviation styles}
+ }
+ % \glsxtrabbrvfootnote
+ \gcmd{gls\-xtr\-abbrv\-foot\-note}
+ {
+ \providedby{\sty{glossaries-extra} v1.07+}
+ \syntax{\margm{entry-label}\margm{text}}
+ \desc{command that produces the footnote for the footnote
+ abbreviation styles, such as \abbrstyle{short-footnote}
+ and \abbrstyle{short-postfootnote}}
+ }
+ % \glsxtrpostabbrvfootnote
+ \gcmd{gls\-xtr\-post\-abbrv\-foot\-note}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{fmt-code}}
+ \desc{command used in the \idx{postlinkhook} for styles like
+ \abbrstyle{short-postfootnote}}
+ }
+ % \xpglsxtrpostabbrvfootnote
+ \gcmd{xp\-gls\-xtr\-post\-abbrv\-foot\-note}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{expands to the footnote code required for styles like
+ \abbrstyle{short-postfootnote}}
+ }
+ % \glsxtrfootnotename
+ \gcmd{gls\-xtr\-foot\-note\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.25+}
+ \desc{expands to the name value for styles like \abbrstyle{short-footnote}}
+ }
+ % \glsxtrfootnotedescname
+ \gcmd{gls\-xtr\-foot\-note\-desc\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \desc{expands to the name value for styles like
+ \abbrstyle{short-footnote-desc}}
+ }
+ % \glsxtrfootnotedescsort
+ \gcmd{gls\-xtr\-foot\-note\-desc\-sort}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \desc{expands to the sort value for styles like
+ \abbrstyle{short-footnote-desc}}
+ }
+ % \glsxtrshortdescname
+ \gcmd{gls\-xtr\-short\-desc\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \desc{expands to the name value for styles like
+ \abbrstyle{short-nolong-desc}}
+ }
+ % \glsxtrlongnoshortdescname
+ \gcmd{gls\-xtr\-long\-no\-short\-desc\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.25+}
+ \desc{expands to the name value for styles like
+ \abbrstyle{long-noshort-desc}}
+ }
+ % \glsxtrlongnoshortname
+ \gcmd{gls\-xtr\-long\-no\-short\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.25+}
+ \desc{expands to the name value for styles like \abbrstyle{long-noshort}}
+ }
+ % \glsxtrscfont
+ \gcmd{gls\-xtr\-sc\-font}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{text}}
+ \desc{maintained for backwards-compatibility used to typeset
+ \meta{text} in small capitals (\gls{textsc}) for the \qt{sc}
+ abbreviation styles}
+ }
+ % \glsxtrfirstscfont
+ \gcmd{gls\-xtr\-first\-sc\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \syntax{\margm{text}}
+ \desc{maintained for backwards-compatibility used to typeset
+ \meta{text} in small capitals (\gls{textsc}) for the \qt{sc}
+ abbreviation styles on \idx{firstuse}}
+ }
+ % \glsabbrvscfont
+ \gcmd{gls\-abbrv\-sc\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{text}}
+ \desc{short form font used by the \idx{smallcaps} \qt{sc} abbreviation styles}
+ }
+ % \glsfirstabbrvscfont
+ \gcmd{gls\-first\-abbrv\-sc\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{text}}
+ \desc{short form font used by the \idx{smallcaps} \qt{sc} abbreviation
+ styles on \idx{firstuse}}
+ }
+ % \glsabbrvscuserfont
+ \gcmd{gls\-abbrv\-sc\-user\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{text}}
+ \desc{short form font used by the \idx{smallcaps} \qt{sc-user} abbreviation styles}
+ }
+ % \glsfirstabbrvscuserfont
+ \gcmd{gls\-first\-abbrv\-sc\-user\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{text}}
+ \desc{short form font used by the \idx{smallcaps} \qt{sc-user} abbreviation
+ styles on \idx{firstuse}}
+ }
+ % \glstextup
+ \gcmd{gls\-text\-up}
+ {
+ \providedby{\sty{glossaries} v3.09a+}
+ \syntax{\margm{text}}
+ \desc{counteracts the effect of \gls{textsc}}
+ }
+ % \glsxtrsmfont
+ \gcmd{gls\-xtr\-sm\-font}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{text}}
+ \desc{maintained for backwards-compatibility used to typeset
+ \meta{text} in a smaller font (\gls{textsmaller}) for the \qt{sm}
+ abbreviation styles}
+ }
+ % \glsxtrfirstsmfont
+ \gcmd{gls\-xtr\-first\-sm\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \syntax{\margm{text}}
+ \desc{maintained for backwards-compatibility used to typeset
+ \meta{text} in a smaller font (\gls{textsmaller}) for the \qt{sm}
+ abbreviation styles on \idx{firstuse}}
+ }
+ % \glsabbrvsmfont
+ \gcmd{gls\-abbrv\-sm\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{text}}
+ \desc{short form font used by the \qt{sm} abbreviation styles}
+ }
+ % \glsfirstabbrvsmfont
+ \gcmd{gls\-first\-abbrv\-sm\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{text}}
+ \desc{short form font used by the \qt{sm} abbreviation styles on \idx{firstuse}}
+ }
+ % \glsabbrvemfont
+ \gcmd{gls\-abbrv\-em\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \syntax{\margm{text}}
+ \desc{short form font used by the \qt{em} abbreviation styles}
+ }
+ % \glsfirstabbrvemfont
+ \gcmd{gls\-first\-abbrv\-em\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \syntax{\margm{text}}
+ \desc{short form font used by the \qt{em} abbreviation styles on \idx{firstuse}}
+ }
+ % \glslongemfont
+ \gcmd{gls\-long\-em\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \syntax{\margm{text}}
+ \desc{long form font used by the \qt{em} abbreviation styles}
+ }
+ % \glsfirstlongemfont
+ \gcmd{gls\-first\-long\-em\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \syntax{\margm{text}}
+ \desc{long form font used by the \qt{em} abbreviation styles on \idx{firstuse}}
+ }
+ % \glsabbrvuserfont
+ \gcmd{gls\-abbrv\-user\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \syntax{\margm{text}}
+ \desc{short form font used by the \qt{user} abbreviation styles}
+ }
+ % \glsfirstabbrvuserfont
+ \gcmd{gls\-first\-abbrv\-user\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \syntax{\margm{text}}
+ \desc{short form font used by the \qt{user} abbreviation styles on \idx{firstuse}}
+ }
+ % \glslonguserfont
+ \gcmd{gls\-long\-user\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \syntax{\margm{text}}
+ \desc{long form font used by the \qt{user} abbreviation styles}
+ }
+ % \glsfirstlonguserfont
+ \gcmd{gls\-first\-long\-user\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \syntax{\margm{text}}
+ \desc{long form font used by the \qt{user} abbreviation styles on \idx{firstuse}}
+ }
+ % \glsuserdescription
+ \gcmd{gls\-user\-description}
+ {
+ \providedby{\sty{glossaries-extra} v1.30+}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{description encapsulator for styles like
+ \abbrstyle{long-short-user}}
+ }
+ % \glsxtrlongshortscusername
+ \gcmd{gls\-xtr\-long\-short\-sc\-user\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{expands to the value for the \gloskey{name} key for
+ styles like \abbrstyle{long-postshort-sc-user}}
+ }
+ % \glsxtrlongshortuserdescname
+ \gcmd{gls\-xtr\-long\-short\-user\-desc\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.25+}
+ \desc{expands to the value for the \gloskey{name} key for
+ styles like \abbrstyle{long-short-user-desc}}
+ }
+ % \glsxtrlongshortscuserdescname
+ \gcmd{gls\-xtr\-long\-short\-sc\-user\-desc\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{expands to the value for the \gloskey{name} key for
+ styles like \abbrstyle{long-postshort-sc-user-desc}}
+ }
+ % \glsxtrshortlonguserdescname
+ \gcmd{gls\-xtr\-short\-long\-user\-desc\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.25+}
+ \desc{expands to the value for the \gloskey{name} key for
+ styles like \abbrstyle{short-long-user-desc}}
+ }
+ % \glsxtrifhyphenstart
+ \gcmd{gls\-xtr\-if\-hyphen\-start}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{text}\margm{true}\margm{false}}
+ \desc{if \meta{text} starts with a hyphen this does \meta{true}
+ otherwise it does \meta{false}}
+ }
+ % \glsxtrlonghyphenshort
+ \gcmd{gls\-xtr\-long\-hyphen\-short}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{entry-label}\margm{long}\margm{short}\margm{insert}}
+ \desc{formats the long and short form according to the
+ \abbrstyle{long-hyphen-short-hyphen} style}
+ }
+ % \GLSxtrlonghyphenshort
+ \gcmd{GLS\-xtr\-long\-hyphen\-short}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{long}\margm{short}\margm{insert}}
+ \desc{as \gls{glsxtrlonghyphenshort} but converts \meta{insert}
+ to \idx{allcaps}. The \meta{long} and \meta{short} arguments
+ should be supplied as \idx{allcaps}}
+ }
+ % \glsxtrlonghyphennoshort
+ \gcmd{gls\-xtr\-long\-hyphen\-noshort}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{entry-label}\margm{long}\margm{insert}}
+ \desc{formats the long form according to the
+ \abbrstyle{long-hyphen-noshort-desc-noreg} style}
+ }
+ % \GLSxtrlonghyphennoshort
+ \gcmd{GLS\-xtr\-long\-hyphen\-noshort}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{long}\margm{insert}}
+ \desc{as \gls{glsxtrlonghyphennoshort} but converts
+ \meta{insert} to \idx{allcaps} The \meta{long} argument
+ should be supplied as \idx{allcaps}}
+ }
+ % \glsxtrlonghyphen
+ \gcmd{gls\-xtr\-long\-hyphen}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{entry-label}\margm{long}\margm{insert}}
+ \desc{formats the long form according to the
+ \abbrstyle{long-hyphen-postshort-hyphen} style}
+ }
+ % \xpglsxtrposthyphenshort
+ \gcmd{xp\-gls\-xtr\-post\-hyphen\-short}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{used within the \idx{postlinkhook} for the
+ \abbrstyle{long-hyphen-postshort-hyphen} style on
+ \idx{firstuse}. This expands the placeholder commands and uses
+ either \gls{glsxtrposthyphenshort} or \gls{GLSxtrposthyphenshort}}
+ }
+ % \glsxtrposthyphenshort
+ \gcmd{gls\-xtr\-post\-hyphen\-short}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{used within the \idx{postlinkhook} to format the short form according to the
+ \abbrstyle{long-hyphen-postshort-hyphen} style on \idx{firstuse}}
+ }
+ % \GLSxtrposthyphenshort
+ \gcmd{GLS\-xtr\-post\-hyphen\-short}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{as \gls{glsxtrposthyphenshort} but \idx{allcaps}}
+ }
+ % \glsxtrposthyphenshortpl
+ \gcmd{gls\-xtr\-post\-hyphen\-short\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{as \gls{glsxtrposthyphenshort} but plural}
+ }
+ % \GLSxtrposthyphenshortpl
+ \gcmd{GLS\-xtr\-post\-hyphen\-short\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{as \gls{glsxtrposthyphenshortpl} but \idx{allcaps}}
+ }
+ % \glsxtrposthyphensubsequent
+ \gcmd{gls\-xtr\-post\-hyphen\-sub\-sequent}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{used within the \idx{postlinkhook} to format the insert according to the
+ \abbrstyle{long-hyphen-postshort-hyphen} style on
+ \idx{subsequentuse}}
+ }
+ % \GLSxtrposthyphensubsequent
+ \gcmd{GLS\-xtr\-post\-hyphen\-sub\-sequent}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{as \gls{glsxtrposthyphensubsequent} but \idx{allcaps}}
+ }
+ % \xpglsxtrposthyphensubsequent
+ \gcmd{xp\-gls\-xtr\-post\-hyphen\-subsequent}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{used within the \idx{postlinkhook} for the
+ \abbrstyle{long-hyphen-postshort-hyphen} style on
+ \idx{subsequentuse}. This expands the placeholder commands and uses
+ either \gls{glsxtrposthyphensubsequent} or
+ \gls{GLSxtrposthyphensubsequent}}
+ }
+ % \glsxtrshorthyphenlong
+ \gcmd{gls\-xtr\-short\-hyphen\-long}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{entry-label}\margm{short}\margm{long}\margm{insert}}
+ \desc{formats the short and long form according to the
+ \abbrstyle{short-hyphen-long-hyphen} style}
+ }
+ % \GLSxtrshorthyphenlong
+ \gcmd{GLS\-xtr\-short\-hyphen\-long}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{short}\margm{long}\margm{insert}}
+ \desc{as \gls{glsxtrshorthyphenlong} but \meta{insert} is
+ converted to \idx{allcaps}}
+ }
+ % \glsxtrshorthyphen
+ \gcmd{gls\-xtr\-short\-hyphen}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{short}\margm{entry-label}\margm{insert}}
+ \desc{formats the short form according to the
+ \abbrstyle{short-hyphen-postlong-hyphen} style}
+ }
+ % \glsxtrposthyphenlong
+ \gcmd{gls\-xtr\-post\-hyphen\-long}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{used within the \idx{postlinkhook} to format the long form according to the
+ \abbrstyle{short-hyphen-postlong-hyphen} style on \idx{firstuse}}
+ }
+ % \GLSxtrposthyphenlong
+ \gcmd{GLS\-xtr\-post\-hyphen\-long}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{as \gls{glsxtrposthyphenlong} but \idx{allcaps}}
+ }
+ % \xpglsxtrposthyphenlong
+ \gcmd{xp\-gls\-xtr\-post\-hyphen\-long}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{used within the \idx{postlinkhook} for the
+ \abbrstyle{short-hyphen-postlong-hyphen} style on
+ \idx{firstuse}. This expands the placeholder commands and uses
+ either \gls{glsxtrposthyphenlong} or \gls{GLSxtrposthyphenlong}}
+ }
+ % \glsxtrposthyphenlongpl
+ \gcmd{gls\-xtr\-post\-hyphen\-long\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{as \gls{glsxtrposthyphenlong} but shows the plural}
+ }
+ % \GLSxtrposthyphenlongpl
+ \gcmd{GLS\-xtr\-post\-hyphen\-long\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{as \gls{glsxtrposthyphenlongpl} but \idx{allcaps}}
+ }
+ % \glsabbrvhyphenfont
+ \gcmd{gls\-abbrv\-hyphen\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{text}}
+ \desc{short form font used by the \qt{hyphen} abbreviation styles}
+ }
+ % \glsfirstabbrvhyphenfont
+ \gcmd{gls\-first\-abbrv\-hyphen\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{text}}
+ \desc{short form font used by the \qt{hyphen} abbreviation
+ styles on \idx{firstuse}}
+ }
+ % \glslonghyphenfont
+ \gcmd{gls\-long\-hyphen\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{text}}
+ \desc{long form font used by the \qt{hyphen} abbreviation styles}
+ }
+ % \glsfirstlonghyphenfont
+ \gcmd{gls\-first\-long\-hyphen\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{text}}
+ \desc{long form font used by the \qt{hyphen} abbreviation
+ styles on \idx{firstuse}}
+ }
+ % \glsabbrvonlyfont
+ \gcmd{gls\-abbrv\-only\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{text}}
+ \desc{short form font used by the \qt{only} abbreviation styles}
+ }
+ % \glsfirstabbrvonlyfont
+ \gcmd{gls\-first\-abbrv\-only\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{text}}
+ \desc{short form font used by the \qt{only} abbreviation
+ styles on \idx{firstuse}}
+ }
+ % \glslongonlyfont
+ \gcmd{gls\-long\-only\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{text}}
+ \desc{long form font used by the \qt{only} abbreviation styles}
+ }
+ % \glsfirstlongonlyfont
+ \gcmd{gls\-first\-long\-only\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \syntax{\margm{text}}
+ \desc{long form font used by the \qt{only} abbreviation
+ styles on \idx{firstuse}}
+ }
+ % \glsxtronlyname
+ \gcmd{gls\-xtr\-only\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.25+}
+ \desc{expands to the name value for styles like
+ \abbrstyle{long-only-short-only}}
+ }
+ % \glsxtronlydescname
+ \gcmd{gls\-xtr\-only\-desc\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \desc{expands to the name value for styles like
+ \abbrstyle{long-only-short-only-desc}}
+ }
+ % \glsxtronlydescsort
+ \gcmd{gls\-xtr\-only\-desc\-sort}
+ {
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \desc{expands to the name value for styles like
+ \abbrstyle{long-only-short-only-desc}}
+ }
+ % \glsabbrvsconlyfont
+ \gcmd{gls\-abbrv\-sc\-only\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{text}}
+ \desc{short form font used by the \qt{sc-only} styles, such as
+ \abbrstyle{long-only-short-sc-only}}
+ }
+ % \glsfirstabbrvsconlyfont
+ \gcmd{gls\-first\-abbrv\-sc\-only\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{text}}
+ \desc{short form font used by the \qt{sc-only} abbreviation
+ styles on \idx{firstuse}}
+ }
+ % \glsxtrsconlyname
+ \gcmd{gls\-xtr\-sc\-only\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{expands to the name value for styles like
+ \abbrstyle{long-only-short-sc-only}}
+ }
+ % \glsxtrsconlydescsort
+ \gcmd{gls\-xtr\-sc\-only\-desc\-sort}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{expands to the sort value for styles like
+ \abbrstyle{long-only-short-sc-only-desc}}
+ }
+ % \glsxtrsconlydescname
+ \gcmd{gls\-xtr\-sc\-only\-desc\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{expands to the name value for styles like
+ \abbrstyle{long-only-short-sc-only-desc}}
+ }
+ % \glsfirstinnerfmtlongfont
+ \gcmd{gls\-first\-inner\-fmt\-long\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{text}}
+ \desc{applies both \gls{glsfirstlongfont} and
+ \gls{glsxtrgenentrytextfmt} to \meta{text}}
+ }
+ % \glsinnerfmtlongfont
+ \gcmd{gls\-inner\-fmt\-long\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{text}}
+ \desc{applies both \gls{glslongfont} and
+ \gls{glsxtrgenentrytextfmt} to \meta{text}}
+ }
+ % \glsfirstxplongfont
+ \gcmd{gls\-first\-xp\-long\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{category}\margm{text}}
+ \desc{if the \catattr{markwords} attribute is set for the
+ given category, this encapsulates \meta{text} with
+ \gls{glsfirstlongfont} otherwise with
+ \gls{glsinnerfmtlongfont}. This command has to expand, so
+ protect any content that shouldn't expand}
+ }
+ % \glsxplongfont
+ \gcmd{gls\-xp\-long\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{category}\margm{text}}
+ \desc{if the \catattr{markwords} attribute is set for the
+ given category, this encapsulates \meta{text} with
+ \gls{glslongfont} otherwise with
+ \gls{glsinnerfmtlongfont}. This command has to expand, so
+ protect any content that shouldn't expand}
+ }
+ % \glsxtr<category><field>accsupp
+ \gcmdmetameta{gls\-xtr}{category}{}{field}{acc\-supp}
+ {%
+ \note{user defined}
+ \desc{expands to the accessibility support command for the given
+ \idx{internalfieldlabel} and category, which is used by \gls{glsfieldaccsupp}}
+ }
+ % \glsfieldaccsupp
+ \gcmd{gls\-field\-acc\-supp}
+ {
+ \providedby{\sty{glossaries-accsupp} v4.45+}
+ \syntax{\margm{replacement}\margm{content}\margm{field}\margm{entry-label}}
+ \desc{if \sty{glossaries-extra} has been loaded, this command
+ will first check for the existence of the command
+ \gls{glsxtrcategoryfieldaccsupp}. If that command doesn't
+ exist or if \sty{glossaries-extra} hasn't been loaded, it then
+ checks for the existence of \csmetafmt{gls}{field}{accsupp} (for
+ example, \gls{glsshortaccsupp}).
+ Failing that it will use \gls{glsaccsupp}. Whichever command is
+ found first, \code{\meta{cs}\margm{replacement}\margm{content}}
+ is performed.}
+ }
+ % \glsaccsupp
+ \gcmd{gls\-acc\-supp}
+ {
+ \providedby{\sty{glossaries-accsupp}}
+ \syntax{\margm{replacement}\margm{content}}
+ \desc{applies \meta{replacement} as the ActualText for
+ \meta{content} using \gls{glsaccessibility}}
+ }
+ % \glsshortaccsupp
+ \gcmd{gls\-short\-acc\-supp}
+ {
+ \providedby{\sty{glossaries-accsupp} v4.45+}
+ \syntax{\margm{replacement}\margm{content}}
+ \desc{applies \meta{replacement} as the expansion (E) attribute for
+ \meta{content} using \gls{glsaccessibility}}
+ }
+ % \glsaccessibility
+ \gcmd{gls\-ac\-ces\-si\-bil\-ity}
+ {
+ \providedby{\sty{glossaries-accsupp} v4.45+}
+ \syntax{\oargm{options}\margm{PDF element}\margm{value}\margm{content}}
+ \desc{applies \meta{value} as the accessibility attribute
+ \meta{PDF element} for the given \meta{content}. This
+ internally uses the accessibility support provided by \sty{accsupp}}
+ }
+ %
+ % ABBREVIATION STYLES
+ \gidxpl{abbrvstyle}%
+ {%
+ \common
+ \field{text}{abbreviation style}%
+ \desc{abbreviations defined using \gls{newabbreviation} will
+ follow the style associated with the entry's category. If there
+ is no style associated with the entry's category, the style for
+ the \cat{abbreviation} category is used (the default is
+ \abbrstyle{long-short}). Note that
+ \sty{glossaries-extra} redefines \gls{newacronym} to use
+ \gls{newabbreviation} with \code{\gloskey{category}\dequals\cat{acronym}}
+ so any entry defined with \gls{newacronym} will use the
+ abbreviation style for the \cat{acronym} category (the
+ default is \abbrstyle{short-nolong})}
+ }
+ % long-short
+ \gabbrsty{long\dhyphen short}%
+ {%
+ \desc{an \idx{abbrvstyle} that shows the long form followed by the
+ short form on \idx{firstuse}. If the \meta{insert} argument is
+ used with the \idx{glslike} or \idx{glstextlike} commands, it will
+ be placed after the long form on \idx{firstuse}. On
+ \idx{subsequentuse}, only the short form is shown (followed by
+ \meta{insert}, if provided). This style sets the
+ \catattr{regular} attribute to \code{false} (which means that
+ the \idx{glslike} commands won't use the
+ \gloskey{first}\slash\gloskey{firstplural} or
+ \gloskey{text}\slash\gloskey{plural} values)}
+ }
+ % long-short-desc
+ \gabbrsty{long\dhyphen short\dhyphen desc}%
+ {%
+ \desc{as \abbrstyle{long-short} but the \gloskey{description}
+ must be supplied in \meta{options}}
+ }
+ % short-long
+ \gabbrsty{short\dhyphen long}%
+ {%
+ \desc{an \idx{abbrvstyle} that shows the short form followed by the
+ long form on \idx{firstuse}. If the \meta{insert} argument is
+ used with the \idx{glslike} or \idx{glstextlike} commands, it will
+ be placed after the short form on \idx{firstuse}. On
+ \idx{subsequentuse}, only the short form is shown (followed by
+ \meta{insert}, if provided). This style sets the
+ \catattr{regular} attribute to \code{false} (which means that
+ the \idx{glslike} commands won't use the
+ \gloskey{first}\slash\gloskey{firstplural} or
+ \gloskey{text}\slash\gloskey{plural} values)}
+ }
+ % short-long-desc
+ \gabbrsty{short\dhyphen long\dhyphen desc}%
+ {%
+ \desc{as \abbrstyle{short-long} but the \gloskey{description}
+ must be supplied in \meta{options}}
+ }
+ % short-nolong
+ \gabbrsty{short\dhyphen nolong}%
+ {%
+ \desc{an \idx{abbrvstyle} that only shows the short form on
+ \idx{firstuse} and \idx{subsequentuse}. The long form won't be
+ showed unless you use a command like \gls{glsxtrlong}. The full
+ form will only be shown with commands like \gls{glsxtrfull}.
+ This style sets the \catattr{regular} attribute to \code{true}}
+ }
+ % short
+ \gabbrstyalias{short}{short-nolong}
+ % short-nolong-desc
+ \gabbrsty{short\dhyphen nolong\dhyphen desc}%
+ {%
+ \desc{as \abbrstyle{short-nolong} but the \gloskey{description}
+ must be supplied in \meta{options}}
+ }
+ % short-desc
+ \gabbrstyalias{short\dhyphen desc}{short-nolong-desc}
+ % short-nolong-noreg
+ \gabbrsty{short\dhyphen nolong\dhyphen noreg}%
+ {%
+ \desc{as \abbrstyle{short-nolong} but it will set the
+ \catattr{regular} attribute to \code{false}}
+ }
+ % short-nolong-desc-noreg
+ \gabbrsty{short\dhyphen nolong\dhyphen desc\dhyphen noreg}%
+ {%
+ \desc{as \abbrstyle{short-nolong-desc} but it will set the
+ \catattr{regular} attribute to \code{false}}
+ }
+ % short-sc-nolong
+ \gabbrsty{short\dhyphen sc\dhyphen nolong}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-nolong} but
+ formats the short form in a small caps font (\gls{textsc}).
+ The short form should therefore be in lowercase}
+ }
+ % short-sc
+ \gabbrstyalias{short\dhyphen sc}{short-sc-nolong}
+ % short-sc-nolong-desc
+ \gabbrsty{short\dhyphen sc\dhyphen nolong\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-nolong-desc} but
+ formats the short form in a small caps font (\gls{textsc}).
+ The short form should therefore be in lowercase}
+ }
+ % short-sc-desc
+ \gabbrstyalias{short\dhyphen sc\dhyphen desc}{short-sc-nolong-desc}
+ % nolong-short
+ \gabbrsty{nolong\dhyphen short}%
+ {%
+ \desc{as \abbrstyle{short-nolong} but the \idx{inlinefullform}
+ shows the long form followed by the short form in parentheses}
+ }
+ % nolong-short-noreg
+ \gabbrsty{nolong\dhyphen short\dhyphen noreg}%
+ {%
+ \desc{as \abbrstyle{nolong-short} but it will set the
+ \catattr{regular} attribute to \code{false}}
+ }
+ % nolong-short-sc
+ \gabbrsty{nolong\dhyphen short\dhyphen sc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{nolong-short} but
+ formats the short form in a small caps font (\gls{textsc}).
+ The short form should therefore be in lowercase}
+ }
+ % long-noshort
+ \gabbrsty{long\dhyphen noshort}%
+ {%
+ \desc{an \idx{abbrvstyle} that only shows the long form on
+ \idx{firstuse} and \idx{subsequentuse}. The short form won't be
+ showed unless you use a command like \gls{glsxtrshort}. The full
+ form will only be shown with commands like \gls{glsxtrfull}.
+ This style sets the \catattr{regular} attribute to \code{true}}
+ }
+ % long
+ \gabbrstyalias{long}{long-noshort}
+ % long-noshort-desc
+ \gabbrsty{long\dhyphen noshort\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} that only shows the long form on
+ \idx{firstuse} and \idx{subsequentuse}. The short form won't be
+ showed unless you use a command like \gls{glsxtrshort}. The
+ \gloskey{description} key must be supplied. The full
+ form will only be shown with commands like \gls{glsxtrfull}.
+ This style sets the \catattr{regular} attribute to \code{true}}
+ }
+ % long-desc
+ \gabbrstyalias{long-desc}{long-noshort-desc}
+ % long-noshort-desc-noreg
+ \gabbrsty{long\dhyphen noshort\dhyphen desc\dhyphen noreg}%
+ {%
+ \desc{as \abbrstyle{long-noshort-desc} but it will set the
+ \catattr{regular} attribute to \code{false}}
+ }
+ % long-noshort-noreg
+ \gabbrsty{long\dhyphen noshort\dhyphen noreg}%
+ {%
+ \desc{as \abbrstyle{long-noshort} but it will set the
+ \catattr{regular} attribute to \code{false}}
+ }
+ % long-noshort-sc
+ \gabbrsty{long\dhyphen noshort\dhyphen sc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-noshort} but
+ formats the short form in a small caps font (\gls{textsc}).
+ The short form should therefore be in lowercase}
+ }
+ % long-noshort-sc-desc
+ \gabbrsty{long\dhyphen noshort\dhyphen sc\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-noshort-desc} but
+ formats the short form in a small caps font (\gls{textsc}).
+ The short form should therefore be in lowercase}
+ }
+ % long-short-sc
+ \gabbrsty{long\dhyphen short\dhyphen sc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-short} but
+ formats the short form in a small caps font (\gls{textsc}).
+ The short form should therefore be in lowercase}
+ }
+ % long-short-sc-desc
+ \gabbrsty{long\dhyphen short\dhyphen sc\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-short-desc} but
+ formats the short form in a small caps font (\gls{textsc}).
+ The short form should therefore be in lowercase}
+ }
+ % short-sc-long
+ \gabbrsty{short\dhyphen sc\dhyphen long}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-long} but
+ formats the short form in a small caps font (\gls{textsc}).
+ The short form should therefore be in lowercase}
+ }
+ % short-sc-long-desc
+ \gabbrsty{short\dhyphen sc\dhyphen long\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-long-desc} but
+ formats the short form in a small caps font (\gls{textsc}).
+ The short form should therefore be in lowercase}
+ }
+ % long-short-sm
+ \gabbrsty{long\dhyphen short\dhyphen sm}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-short} but
+ formats the short form in a smaller font (\gls{textsmaller}).
+ The \sty{relsize} package is must be loaded}
+ }
+ % long-short-sm-desc
+ \gabbrsty{long\dhyphen short\dhyphen sm\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-short-desc} but
+ formats the short form in a smaller font (\gls{textsmaller}).
+ The \sty{relsize} package is must be loaded}
+ }
+ % long-short-em
+ \gabbrsty{long\dhyphen short\dhyphen em}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-short} but
+ formats the short form in an emphasized font (\gls{emph})}
+ }
+ % long-short-em-desc
+ \gabbrsty{long\dhyphen short\dhyphen em\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-short-desc} but
+ formats the short form in an emphasized font (\gls{emph})}
+ }
+ % long-em-short-em
+ \gabbrsty{long\dhyphen em\dhyphen short\dhyphen em}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-short} but
+ formats both the long and short form in an emphasized font (\gls{emph})}
+ }
+ % long-em-short-em-desc
+ \gabbrsty{long\dhyphen em\dhyphen short\dhyphen em\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-short-desc} but
+ formats both the long and short form in an emphasized font (\gls{emph})}
+ }
+ % short-sm-long
+ \gabbrsty{short\dhyphen sm\dhyphen long}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-long} but
+ formats the short form in a smaller font (\gls{textsmaller}).
+ The \sty{relsize} package is must be loaded}
+ }
+ % short-sm-long-desc
+ \gabbrsty{short\dhyphen sm\dhyphen long\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-long-desc} but
+ formats the short form in a smaller font (\gls{textsmaller}).
+ The \sty{relsize} package is must be loaded}
+ }
+ % short-sm-nolong
+ \gabbrsty{short\dhyphen sm\dhyphen nolong}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-nolong} but
+ formats the short form in a smaller font (\gls{textsmaller}).
+ The \sty{relsize} package is must be loaded}
+ }
+ % short-sm
+ \gabbrstyalias{short\dhyphen sm}{short-sm-nolong}
+ % short-sm-nolong-desc
+ \gabbrsty{short\dhyphen sm\dhyphen nolong\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-nolong-desc} but
+ formats the short form in a smaller font (\gls{textsmaller}).
+ The \sty{relsize} package is must be loaded}
+ }
+ % short-sm-desc
+ \gabbrstyalias{short\dhyphen sm\dhyphen desc}{short-sm-nolong-desc}
+ % nolong-short-sm
+ \gabbrsty{nolong\dhyphen short\dhyphen sm}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{nolong-short} but
+ formats the short form in a smaller font (\gls{textsmaller}).
+ The \sty{relsize} package is must be loaded}
+ }
+ % long-noshort-sm
+ \gabbrsty{long\dhyphen noshort\dhyphen sm}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-noshort} but
+ formats the short form in a smaller font (\gls{textsmaller}).
+ The \sty{relsize} package is must be loaded}
+ }
+ % long-noshort-sm-desc
+ \gabbrsty{long\dhyphen noshort\dhyphen sm\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-noshort-desc} but
+ formats the short form in a smaller font (\gls{textsmaller}).
+ The \sty{relsize} package is must be loaded}
+ }
+ % short-em-long
+ \gabbrsty{short\dhyphen em\dhyphen long}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-long} but
+ formats the short form in an emphasized font (\gls{emph})}
+ }
+ % short-em-long-desc
+ \gabbrsty{short\dhyphen em\dhyphen long\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-long-desc} but
+ formats the short form in an emphasized font (\gls{emph})}
+ }
+ % short-em-long-em
+ \gabbrsty{short\dhyphen em\dhyphen long\dhyphen em}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-long} but
+ formats both the long and short form in an emphasized font (\gls{emph})}
+ }
+ % short-em-long-em-desc
+ \gabbrsty{short\dhyphen em\dhyphen long\dhyphen em\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-long-desc} but
+ formats both the long and short form in an emphasized font (\gls{emph})}
+ }
+ % short-em-nolong
+ \gabbrsty{short\dhyphen em\dhyphen nolong}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-nolong} but
+ formats the short form in an emphasized font (\gls{emph})}
+ }
+ % short-em
+ \gabbrstyalias{short\dhyphen em}{short-em-nolong}
+ % short-em-nolong-desc
+ \gabbrsty{short\dhyphen em\dhyphen nolong\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-nolong-desc} but
+ formats the short form in an emphasized font (\gls{emph})}
+ }
+ % short-em-desc
+ \gabbrstyalias{short\dhyphen em\dhyphen desc}{short-em-nolong-desc}
+ % nolong-short-em
+ \gabbrsty{nolong\dhyphen short\dhyphen em}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{nolong-short} but
+ formats the short form in an emphasized font (\gls{emph})}
+ }
+ % long-noshort-em
+ \gabbrsty{long\dhyphen noshort\dhyphen em}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-noshort} but
+ formats the short form in an emphasized font (\gls{emph})}
+ }
+ % long-noshort-em-desc
+ \gabbrsty{long\dhyphen noshort\dhyphen em\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-noshort-desc} but
+ formats the short form in an emphasized font (\gls{emph})}
+ }
+ % long-em-noshort-em
+ \gabbrsty{long\dhyphen em\dhyphen noshort\dhyphen em}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-noshort} but
+ formats both the long and short form in an emphasized font (\gls{emph})}
+ }
+ % long-em-noshort-em-desc
+ \gabbrsty{long\dhyphen em\dhyphen noshort\dhyphen em\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-noshort-desc} but
+ formats both the long and short form in an emphasized font (\gls{emph})}
+ }
+ % long-em-noshort-em-noreg
+ \gabbrsty{long\dhyphen em\dhyphen noshort\dhyphen em\dhyphen noreg}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-em-noshort-em} but
+ sets the \catattr{regular} attribute to \code{false}}
+ }
+ % long-em-noshort-em-desc-noreg
+ \gabbrsty{long\dhyphen em\dhyphen noshort\dhyphen em\dhyphen desc\dhyphen noreg}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-em-noshort-em-desc} but
+ sets the \catattr{regular} attribute to \code{false}}
+ }
+ % short-footnote
+ \gabbrsty{short\dhyphen footnote}%
+ {%
+ \desc{an \idx{abbrvstyle} that shows the short form with the
+ long form as a footnote on \idx{firstuse}. If the \meta{insert} argument is
+ used with the \idx{glslike} or \idx{glstextlike} commands, it will
+ be placed after the short form, before the footnote marker, on \idx{firstuse}. On
+ \idx{subsequentuse}, only the short form is shown (followed by
+ \meta{insert}, if provided). The \idx{inlinefullform} shows the
+ short form followed by the long form in parentheses. This style sets the
+ \catattr{regular} attribute to \code{false} (which means that
+ the \idx{glslike} commands won't use the
+ \gloskey{first}\slash\gloskey{firstplural} or
+ \gloskey{text}\slash\gloskey{plural} values). This style also
+ sets the \catattr{nohyperfirst} attribute to \code{true} to
+ avoid nesting the footnote marker link. If you want hyperlinks
+ on \idx{firstuse}, use the \abbrstyle{short-postfootnote} style
+ instead}
+ }
+ % footnote
+ \gabbrstyalias{footnote}{short-footnote}
+ % short-footnote-desc
+ \gabbrsty{short\dhyphen footnote\dhyphen desc}%
+ {%
+ \desc{as \abbrstyle{short-footnote} but the \gloskey{description}
+ must be supplied in \meta{options}}
+ }
+ % footnote-desc
+ \gabbrstyalias{footnote\dhyphen desc}{short-footnote-desc}
+ % short-postfootnote
+ \gabbrsty{short\dhyphen postfootnote}%
+ {%
+ \desc{similar to \abbrstyle{short-footnote} but the footnote is
+ placed in the \idx{postlinkhook}}
+ }
+ % postfootnote
+ \gabbrstyalias{postfootnote}{short-postfootnote}
+ % short-postfootnote-desc
+ \gabbrsty{short\dhyphen postfootnote\dhyphen desc}%
+ {%
+ \desc{as \abbrstyle{short-postfootnote} but the \gloskey{description}
+ must be supplied in \meta{options}}
+ }
+ % postfootnote-desc
+ \gabbrstyalias{postfootnote\dhyphen desc}{short-postfootnote-desc}
+ % short-sc-footnote
+ \gabbrsty{short\dhyphen sc\dhyphen footnote}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-footnote} but
+ formats the short form in a small caps font (\gls{textsc}).
+ The short form should therefore be in lowercase}
+ }
+ % short-sc-footnote-desc
+ \gabbrsty{short\dhyphen sc\dhyphen footnote\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-footnote-desc} but
+ formats the short form in a small caps font (\gls{textsc}).
+ The short form should therefore be in lowercase}
+ }
+ % short-sc-postfootnote
+ \gabbrsty{short\dhyphen sc\dhyphen postfootnote}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-postfootnote} but
+ formats the short form in a small caps font (\gls{textsc}).
+ The short form should therefore be in lowercase}
+ }
+ % short-sc-postfootnote-desc
+ \gabbrsty{short\dhyphen sc\dhyphen postfootnote\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-postfootnote-desc} but
+ formats the short form in a small caps font (\gls{textsc}).
+ The short form should therefore be in lowercase}
+ }
+ % short-sm-footnote
+ \gabbrsty{short\dhyphen sm\dhyphen footnote}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-footnote} but
+ formats the short form in a smaller font (\gls{textsmaller}).
+ The \sty{relsize} package is must be loaded}
+ }
+ % short-sm-footnote-desc
+ \gabbrsty{short\dhyphen sm\dhyphen footnote\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-footnote-desc} but
+ formats the short form in a smaller font (\gls{textsmaller}).
+ The \sty{relsize} package is must be loaded}
+ }
+ % short-sm-postfootnote
+ \gabbrsty{short\dhyphen sm\dhyphen postfootnote}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-postfootnote} but
+ formats the short form in a smaller font (\gls{textsmaller}).
+ The \sty{relsize} package is must be loaded}
+ }
+ % short-sm-postfootnote-desc
+ \gabbrsty{short\dhyphen sm\dhyphen postfootnote\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-postfootnote-desc} but
+ formats the short form in a smaller font (\gls{textsmaller}).
+ The \sty{relsize} package is must be loaded}
+ }
+ % short-em-footnote
+ \gabbrsty{short\dhyphen em\dhyphen footnote}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-footnote} but
+ formats the short form in an emphasized font (\gls{emph})}
+ }
+ % short-em-footnote-desc
+ \gabbrsty{short\dhyphen em\dhyphen footnote\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-footnote-desc} but
+ formats the short form in an emphasized font (\gls{emph})}
+ }
+ % short-em-postfootnote
+ \gabbrsty{short\dhyphen em\dhyphen postfootnote}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-postfootnote} but
+ formats the short form in an emphasized font (\gls{emph})}
+ }
+ % short-em-postfootnote-desc
+ \gabbrsty{short\dhyphen em\dhyphen postfootnote\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-postfootnote-desc} but
+ formats the short form in an emphasized font (\gls{emph})}
+ }
+ % long-short-user
+ \gabbrsty{long\dhyphen short\dhyphen user}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-short} but
+ includes the value of the field identified by
+ \gls{glsxtruserfield} (if set) in the parenthetical content}
+ }
+ % long-postshort-user
+ \gabbrsty{long\dhyphen postshort\dhyphen user}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-short-user} but
+ the parenthetical content is placed in the \idx{postlinkhook}}
+ }
+ % long-short-user-desc
+ \gabbrsty{long\dhyphen short\dhyphen user\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-short-user} but
+ the description must be supplied}
+ }
+ % long-postshort-user-desc
+ \gabbrsty{long\dhyphen postshort\dhyphen user\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-postshort-user} but
+ the description must be supplied}
+ }
+ % long-postshort-sc-user
+ \gabbrsty{long\dhyphen postshort\dhyphen sc\dhyphen user}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-postshort-user} but
+ formats the short form in a small caps font (\gls{textsc}).
+ The short form should therefore be in lowercase}
+ }
+ % long-postshort-sc-user-desc
+ \gabbrsty{long\dhyphen postshort\dhyphen sc\dhyphen user\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-postshort-sc-user} but
+ the description must be supplied}
+ }
+ % short-postlong-user
+ \gabbrsty{short\dhyphen postlong\dhyphen user}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-long} but
+ includes the value of the field identified by
+ \gls{glsxtruserfield} (if set) in the parenthetical content,
+ which is placed in the \idx{postlinkhook}}
+ }
+ % short-postlong-user-desc
+ \gabbrsty{short\dhyphen postlong\dhyphen user\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-postlong-user} but
+ the description must be supplied}
+ }
+ % short-long-user
+ \gabbrsty{short\dhyphen long\dhyphen user}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-long} but
+ includes the value of the field identified by
+ \gls{glsxtruserfield} (if set) in the parenthetical content}
+ }
+ % short-long-user-desc
+ \gabbrsty{short\dhyphen long\dhyphen user\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-long-user} but
+ the description must be supplied}
+ }
+ % long-hyphen-short-hyphen
+ \gabbrsty{long\dhyphen hyphen\dhyphen short\dhyphen hyphen}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-short} but
+ checks if the inserted material starts with a hyphen (use with
+ \catattr{markwords} or \catattr{markshortwords} attributes)}
+ }
+ % long-hyphen-postshort-hyphen
+ \gabbrsty{long\dhyphen hyphen\dhyphen postshort\dhyphen hyphen}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-hyphen-short-hyphen} but
+ places the insert and parenthetical material in the \idx{postlinkhook}}
+ }
+ % long-hyphen-short-hyphen-desc
+ \gabbrsty{long\dhyphen hyphen\dhyphen short\dhyphen hyphen\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-hyphen-short-hyphen} but
+ the description must be supplied}
+ }
+ % long-hyphen-postshort-hyphen-desc
+ \gabbrsty{long\dhyphen hyphen\dhyphen postshort\dhyphen hyphen\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-hyphen-short-hyphen-desc} but
+ places the insert and parenthetical material in the \idx{postlinkhook}}
+ }
+ % long-hyphen-noshort-desc-noreg
+ \gabbrsty{long\dhyphen hyphen\dhyphen noshort\dhyphen desc\dhyphen noreg}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-noshort-desc} but
+ checks if the inserted material starts with a hyphen (use with
+ \catattr{markwords} attribute)}
+ }
+ % long-hyphen-noshort-noreg
+ \gabbrsty{long\dhyphen hyphen\dhyphen noshort\dhyphen noreg}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-hyphen-short-hyphen} but
+ doesn't show the short form on \idx{firstuse}}
+ }
+ % short-hyphen-long-hyphen
+ \gabbrsty{short\dhyphen hyphen\dhyphen long\dhyphen hyphen}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-long} but
+ checks if the inserted material starts with a hyphen (use with
+ \catattr{markwords} or \catattr{markshortwords} attributes)}
+ }
+ % short-hyphen-long-hyphen-desc
+ \gabbrsty{short\dhyphen hyphen\dhyphen long\dhyphen hyphen\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-hyphen-long-hyphen} but
+ the description must be supplied}
+ }
+ % short-hyphen-postlong-hyphen
+ \gabbrsty{short\dhyphen hyphen\dhyphen postlong\dhyphen hyphen}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-hyphen-long-hyphen} but
+ the insert and parenthetical material are placed in the \idx{postlinkhook}}
+ }
+ % short-hyphen-postlong-hyphen-desc
+ \gabbrsty{short\dhyphen hyphen\dhyphen postlong\dhyphen hyphen\dhyphen desc}%
+ {%
+ \desc{an \idx{abbrvstyle} like \abbrstyle{short-hyphen-long-hyphen-desc} but
+ the insert and parenthetical material are placed in the \idx{postlinkhook}}
+ }
+ % long-only-short-only
+ \gabbrsty{long\dhyphen only\dhyphen short\dhyphen only}
+ {
+ \desc{an \idx{abbrvstyle} that only shows the long form on
+ \idx{firstuse} and only shows the short form on \idx{subsequentuse}}
+ }
+ % long-only-short-only-desc
+ \gabbrsty{long\dhyphen only\dhyphen short\dhyphen only\dhyphen desc}
+ {
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-only-short-only}
+ but the description must be supplied}
+ }
+ % long-only-short-sc-only
+ \gabbrsty{long\dhyphen only\dhyphen short\dhyphen sc\dhyphen only}
+ {
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-only-short-only}
+ but uses \idx{smallcaps} for the short form}
+ }
+ % long-only-short-sc-only-desc
+ \gabbrsty{long\dhyphen only\dhyphen short\dhyphen sc\dhyphen only\dhyphen desc}
+ {
+ \desc{an \idx{abbrvstyle} like \abbrstyle{long-only-short-sc-only}
+ but the description must be supplied}
+ }
+ % long-sc
+ \gdepabbrsty{long\dhyphen sc}{long-noshort-sc}
+ % long-desc-sc
+ \gdepabbrsty{long\dhyphen desc\dhyphen sc}{long-noshort-sc-desc}
+ % footnote-sc
+ \gdepabbrsty{footnote\dhyphen sc}{short-sc-footnote}
+ % postfootnote-sc
+ \gdepabbrsty{postfootnote\dhyphen sc}{short-sc-postfootnote}
+ % long-sm
+ \gdepabbrsty{long\dhyphen sm}{long-noshort-sm}
+ % long-desc-sm
+ \gdepabbrsty{long\dhyphen desc\dhyphen sm}{long-noshort-sm-desc}
+ % footnote-sm
+ \gdepabbrsty{footnote\dhyphen sm}{short-sm-footnote}
+ % postfootnote-sm
+ \gdepabbrsty{postfootnote\dhyphen sm}{short-sm-postfootnote}
+ % long-em
+ \gdepabbrsty{long\dhyphen em}{long-noshort-em}
+ % long-desc-em
+ \gdepabbrsty{long\dhyphen desc\dhyphen em}{long-noshort-em-desc}
+ % footnote-em
+ \gdepabbrsty{footnote\dhyphen em}{short-em-footnote}
+ % postfootnote-em
+ \gdepabbrsty{postfootnote\dhyphen em}{short-em-postfootnote}
+ % base acronym styles
+ \gidx{acronymstyle}{\name{acronym (base) style}%
+ \field{text}{acronym style}
+ }
+ \gacrsty{long\dhyphen short}{}
+ \gacrsty{long\dhyphen sc\dhyphen short}{}
+ \gacrsty{long\dhyphen sm\dhyphen short}{}
+ \gacrsty{long\dhyphen sp\dhyphen short}{}
+ \gacrsty{short\dhyphen long}{}
+ \gacrsty{sc\dhyphen short\dhyphen long}{}
+ \gacrsty{sm\dhyphen short\dhyphen long}{}
+ \gacrsty{long\dhyphen short\dhyphen desc}{}
+ \gacrsty{long\dhyphen sc\dhyphen short\dhyphen desc}{}
+ \gacrsty{long\dhyphen sm\dhyphen short\dhyphen desc}{}
+ \gacrsty{long\dhyphen sp\dhyphen short\dhyphen desc}{}
+ \gacrsty{short\dhyphen long\dhyphen desc}{}
+ \gacrsty{sc\dhyphen short\dhyphen long\dhyphen desc}{}
+ \gacrsty{sm\dhyphen short\dhyphen long\dhyphen desc}{}
+ \gacrsty{dua}{}
+ \gacrsty{dua\dhyphen desc}{}
+ \gacrsty{footnote}{}
+ \gacrsty{footnote\dhyphen sc}{}
+ \gacrsty{footnote\dhyphen sm}{}
+ \gacrsty{footnote\dhyphen desc}{}
+ \gacrsty{footnote\dhyphen sc\dhyphen desc}{}
+ \gacrsty{footnote\dhyphen sm\dhyphen desc}{}
+ % GLOSSARY STYLES:
+ % \setglossarystyle
+ \gcmd{set\-glossary\-style}%
+ {%
+ \providedby{\sty{glossaries} v3.08a+}%
+ \syntax{\margm{style-name}}
+ \desc{set the current \idx{glossarystyle} to \meta{style-name}.
+ Redefined by \sty{glossaries-extra} to include \gls{glsxtrpreglossarystyle}}
+ }
+ % \glsxtrpreglossarystyle
+ \gcmd{gls\-xtr\-pre\-glossary\-style}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}%
+ \desc{hook performed by \gls{setglossarystyle} to initialise
+ default definitions of style commands}
+ }
+ \gidxpl{glossarystyle}%
+ {%
+ \common
+ \field{text}{glossary style}%
+ \desc{the default style may be set with \gls{setglossarystyle}
+or use:
+\begin{compactcodebox}
+\csfmt{usepackage}[\optval{stylemods}{\meta{name}},\optval{style}{\meta{style-name}}]\marg{glossaries-extra}
+\end{compactcodebox}
+where the style is provided by package \styfmt{glossary-\meta{name}}.
+The default style can be overridden for individual \idxpl{glossary}
+with the \printglossopt{style} option. For a summary of all
+available styles, see \gallerypage{glossaries-styles}{Gallery:
+Predefined Styles}}
+ }
+ % glossary style: inline
+ \gglosty{inline}%
+ {%
+ \providedby{\sty{glossary-inline}}%
+ \desc{a compact style with all entries listed in the
+ same paragraph and no \idxpl{group}, locations or symbols}
+ }
+ % glossary style: list
+ \gglosty{list}%
+ {%
+ \providedby{\sty{glossary-list}}%
+ \desc{this style uses the \env{description} environment
+ and places the entry name in the optional argument of
+ \gls{item}. Symbols and sub-entry names are not shown}
+ }
+ % glossary style: listgroup
+ \gglosty{list\-group}%
+ {%
+ \providedby{\sty{glossary-list}}%
+ \desc{as \glostyle{list} but has headers at the start of each
+ \idx{group}}
+ }
+ % glossary style: listhypergroup
+ \gglosty{list\-hyper\-group}%
+ {%
+ \providedby{\sty{glossary-list}}%
+ \desc{as \glostyle{listgroup} but has a row at the start with
+ hyperlinks to each \idx{group}}
+ }
+ % glossary style: altlist
+ \gglosty{alt\-list}%
+ {%
+ \providedby{\sty{glossary-list}}%
+ \desc{as \glostyle{list} but starts the description on a new line}
+ }
+ % glossary style: listdotted
+ \gglosty{list\-dotted}%
+ {%
+ \providedby{\sty{glossary-list}}%
+ \desc{a \glostyle{list}-like style that has a dotted leader
+between the name and description. The \idx{locationlist} isn't shown}
+ }
+ % glossary style: long
+ \gglosty{long}%
+ {%
+ \providedby{\sty{glossary-long}}%
+ \desc{this style uses the \env{longtable} environment
+ (provided by the \sty{longtable} package). Symbols and
+ sub-entry names are not shown}
+ }
+ % glossary style: long-name-desc
+ \gglosty{long\dhyphen name\dhyphen desc}%
+ {%
+ \providedby{\sty{glossary-longextra} v1.37+}%
+ \desc{this style displays the \idx{glossary} in a table for
+ (either \env{longtable} or \env{tabular}) with two columns: the
+ name and the description}
+ }
+ % glossary style: long-desc-name
+ \gglosty{long\dhyphen desc\dhyphen name}%
+ {%
+ \providedby{\sty{glossary-longextra} v1.37+}%
+ \desc{this style displays the \idx{glossary} in a table for
+ (either \env{longtable} or \env{tabular}) with two columns: the
+ description and the name}
+ }
+ % glossary style: long-name-desc-loc
+ \gglosty{long\dhyphen name\dhyphen desc\dhyphen loc}%
+ {%
+ \providedby{\sty{glossary-longextra} v1.37+}%
+ \desc{this style displays the \idx{glossary} in a table for
+ (either \env{longtable} or \env{tabular}) with three columns: the
+ name, description and \idx{locationlist}}
+ }
+ % glossary style: long-loc-desc-name
+ \gglosty{long\dhyphen loc\dhyphen desc\dhyphen name}%
+ {%
+ \providedby{\sty{glossary-longextra} v1.37+}%
+ \desc{this style displays the \idx{glossary} in a table for
+ (either \env{longtable} or \env{tabular}) with three columns: the
+ \idx{locationlist}, description and name}
+ }
+ % glossary style: long-name-desc-sym
+ \gglosty{long\dhyphen name\dhyphen desc\dhyphen sym}%
+ {%
+ \providedby{\sty{glossary-longextra} v1.37+}%
+ \desc{this style displays the \idx{glossary} in a table for
+ (either \env{longtable} or \env{tabular}) with three columns: the
+ name, description and symbol}
+ }
+ % glossary style: long-name-desc-sym-loc
+ \gglosty{long\dhyphen name\dhyphen desc\dhyphen sym\dhyphen loc}%
+ {%
+ \providedby{\sty{glossary-longextra} v1.37+}%
+ \desc{this style displays the \idx{glossary} in a table for
+ (either \env{longtable} or \env{tabular}) with four columns: the
+ name, description, symbol and \idx{locationlist}}
+ }
+ % glossary style: long-name-sym-desc
+ \gglosty{long\dhyphen name\dhyphen sym\dhyphen desc}%
+ {%
+ \providedby{\sty{glossary-longextra} v1.37+}%
+ \desc{this style displays the \idx{glossary} in a table for
+ (either \env{longtable} or \env{tabular}) with three columns: the
+ name, symbol and description}
+ }
+ % glossary style: long-name-sym-desc-loc
+ \gglosty{long\dhyphen name\dhyphen sym\dhyphen desc\dhyphen loc}%
+ {%
+ \providedby{\sty{glossary-longextra} v1.37+}%
+ \desc{this style displays the \idx{glossary} in a table for
+ (either \env{longtable} or \env{tabular}) with four columns: the
+ name, symbol, description and \idx{locationlist}}
+ }
+ % glossary style: long-sym-desc-name
+ \gglosty{long\dhyphen sym\dhyphen desc\dhyphen name}%
+ {%
+ \providedby{\sty{glossary-longextra} v1.37+}%
+ \desc{this style displays the \idx{glossary} in a table for
+ (either \env{longtable} or \env{tabular}) with three columns: the
+ symbol, description and name}
+ }
+ % glossary style: long-loc-sym-desc-name
+ \gglosty{long\dhyphen loc\dhyphen sym\dhyphen desc\dhyphen name}%
+ {%
+ \providedby{\sty{glossary-longextra} v1.37+}%
+ \desc{this style displays the \idx{glossary} in a table for
+ (either \env{longtable} or \env{tabular}) with four columns: the
+ \idx{locationlist}, symbol, description and name}
+ }
+ % glossary style: long-desc-sym-name
+ \gglosty{long\dhyphen desc\dhyphen sym\dhyphen name}%
+ {%
+ \providedby{\sty{glossary-longextra} v1.37+}%
+ \desc{this style displays the \idx{glossary} in a table for
+ (either \env{longtable} or \env{tabular}) with three columns: the
+ description, symbol and name}
+ }
+ % glossary style: long-loc-desc-sym-name
+ \gglosty{long\dhyphen loc\dhyphen desc\dhyphen sym\dhyphen name}%
+ {%
+ \providedby{\sty{glossary-longextra} v1.37+}%
+ \desc{this style displays the \idx{glossary} in a table for
+ (either \env{longtable} or \env{tabular}) with four columns: the
+ \idx{locationlist}, description, symbol and name}
+ }
+ % glossary style: long-sym-desc
+ \gglosty{long\dhyphen sym\dhyphen desc}%
+ {%
+ \providedby{\sty{glossary-longextra} v1.49+}%
+ \desc{this style displays the \idx{glossary} in a table for
+ (either \env{longtable} or \env{tabular}) with two columns: the
+ symbol and the description}
+ }
+ % glossary style: long-desc-sym
+ \gglosty{long\dhyphen desc\dhyphen sym}%
+ {%
+ \providedby{\sty{glossary-longextra} v1.49+}%
+ \desc{this style displays the \idx{glossary} in a table for
+ (either \env{longtable} or \env{tabular}) with two columns: the
+ description and the symbol}
+ }
+ % glossary style: abbr-short-long
+ \gglosty{abbr\dhyphen short\dhyphen long}%
+ {%
+ \providedby{\sty{glossary-longextra} v1.49+}%
+ \desc{this style displays the \idx{glossary} in a table for
+ (either \env{longtable} or \env{tabular}) with two columns: the
+ short form and the long form}
+ }
+ % glossary style: abbr-long-short
+ \gglosty{abbr\dhyphen long\dhyphen short}%
+ {%
+ \providedby{\sty{glossary-longextra} v1.49+}%
+ \desc{this style displays the \idx{glossary} in a table for
+ (either \env{longtable} or \env{tabular}) with two columns: the
+ long form and the short form}
+ }
+ % glossary style: long-booktabs
+ \gglosty{long\dhyphen booktabs}
+ {%
+ \providedby{\sty{glossary-longbooktabs} v4.21+}%
+ \desc{this style displays the \idx{glossary} using
+ \env{longtable} and horizontal rules from the \sty{booktabs} package}
+ }
+ % glossary style: longragged
+ \gglosty{longragged}
+ {%
+ \providedby{\sty{glossary-longragged}}%
+ \desc{this style displays the \idx{glossary} using
+ \env{longtable} with ragged right paragraph formatting for the
+ description column}
+ }
+ % glossary style: super
+ \gglosty{super}
+ {%
+ \providedby{\sty{glossary-super}}%
+ \desc{this style displays the \idx{glossary} using
+ \env{supertabular}}
+ }
+ % glossary style: superragged
+ \gglosty{superragged}
+ {%
+ \providedby{\sty{glossary-superragged}}%
+ \desc{this style displays the \idx{glossary} using
+ \env{supertabular} with ragged right paragraph formatting for the
+ description column}
+ }
+ % glossary style: topic
+ \gglosty{topic}
+ {
+ \providedby{\sty{glossary-topic}}%
+ \desc{this style is designed for hierarchical glossaries where
+ the top-level entry represents a topic}
+ }
+ % glossary style: topicmcols
+ \gglosty{topicmcols}
+ {
+ \providedby{\sty{glossary-topic}}%
+ \desc{similar to \glostyle{topic} but the sub-entries are placed
+ in a \env{multicols} environment}
+ }
+ % glossary style: table
+ \gglosty{table}
+ {
+ \providedby{\sty{glossary-table}}%
+ \desc{this style is specific to \gls{printunsrttable}}
+ }
+ % glossary style: bookindex
+ \gglosty{bookindex}%
+ {%
+ \providedby{\sty{glossary-bookindex}}%
+ \desc{this style is designed for indexes. Symbols and
+ descriptions are not shown. Since descriptions aren't shown,
+ there's no \gls{postdeschook}}
+ }
+ % glossary style: index
+ \gglosty{index}%
+ {
+ \providedby{\sty{glossary-tree}}%
+ \desc{a hierarchical style that supports up to level~2, similar to normal indexes, but
+ symbols and descriptions are shown}
+ }
+ % glossary style: tree
+ \gglosty{tree}%
+ {
+ \providedby{\sty{glossary-tree}}%
+ \desc{a hierarchical style that supports unlimited levels
+ (although a deep hierarchy may not fit the available line width)
+ with that shows symbols and descriptions}
+ }
+ % glossary style: treegroup
+ \gglosty{tree\-group}%
+ {
+ \providedby{\sty{glossary-tree}}%
+ \desc{as \glostyle{tree} but has headers at the start of each
+ \idx{group}}
+ }
+ % glossary style: treehypergroup
+ \gglosty{tree\-hyper\-group}%
+ {%
+ \providedby{\sty{glossary-tree}}%
+ \desc{as \glostyle{treegroup} but has a row at the start with
+ hyperlinks to each \idx{group}}
+ }
+ % glossary style: indexgroup
+ \gglosty{index\-group}%
+ {
+ \providedby{\sty{glossary-tree}}%
+ \desc{as \glostyle{index} but has headers at the start of each
+ \idx{group}}
+ }
+ % glossary style: alttree
+ \gglosty{alt\-tree}%
+ {
+ \providedby{\sty{glossary-tree}}%
+ \desc{like \glostyle{tree} but the width of the widest name must
+ be supplied (using a command like \gls{glssetwidest})}
+ }
+ % glossary style: alttreegroup
+ \gglosty{alt\-tree\-group}%
+ {
+ \providedby{\sty{glossary-tree}}%
+ \desc{as \glostyle{alttree} but has headers at the start of each
+ \idx{group}}
+ }
+ % glossary style: treenoname
+ \gglosty{tree\-no\-name}%
+ {
+ \providedby{\sty{glossary-tree}}%
+ \desc{like \glostyle{tree} but the child entries don't have their
+ name shown}
+ }
+ % glossary style: mcolindex
+ \gglosty{mcol\-index}%
+ {
+ \providedby{\sty{glossary-mcols}}%
+ \desc{as \glostyle{index} but puts the content inside a
+ \env{multicols} environment}
+ }
+ % glossary style: mcolindexgroup
+ \gglosty{mcol\-index\-group}%
+ {
+ \providedby{\sty{glossary-mcols}}%
+ \desc{as \glostyle{mcolindex} but has headers at the start of each
+ \idx{group}}
+ }
+ % glossary style: mcoltree
+ \gglosty{mcol\-tree}%
+ {
+ \providedby{\sty{glossary-mcols}}%
+ \desc{as \glostyle{tree} but puts the content inside a
+ \env{multicols} environment}
+ }
+ % PACKAGE OPTIONS
+ % package option prefix
+ \gstyopt{prefix}
+ {%
+ \inpackage{glossaries-extra}
+ \desc{loads \sty{glossaries-prefix}}
+ }
+ % package option accsupp
+ \gstyopt{accsupp}
+ {%
+ \inpackage{glossaries-extra}
+ \desc{loads \sty{glossaries-accsupp}}
+ }
+ % package option style
+ \gstyopt{style}%
+ {%
+ \inpackage{glossaries}%
+ \syntax{\meta{style-name}}
+ \desc{sets the default \idx{glossarystyle} to \meta{style-name}}%
+ }
+ % package option nostyles
+ \gstyopt{nostyles}%
+ {%
+ \inpackage{glossaries}%
+ \desc{don't load the default set of predefined styles. Note that
+ if \sty{glossaries} is loaded before \sty{glossaries-extra},
+ then this option should be passed directly to \sty{glossaries}
+ not \sty{glossaries-extra} otherwise it will be too late to
+ implement}%
+ }
+ % package option nolist
+ \gstyopt{nolist}%
+ {%
+ \inpackage{glossaries}%
+ \desc{don't load \sty{glossary-list}, which is normally loaded
+ automatically. Note that if \sty{glossaries} is loaded before
+ \sty{glossaries-extra},
+ then this option should be passed directly to \sty{glossaries}
+ not \sty{glossaries-extra} otherwise it will be too late to
+ implement}%
+ }
+ % package option nolong
+ \gstyopt{nolong}%
+ {%
+ \inpackage{glossaries}%
+ \desc{don't load \sty{glossary-long}, which is normally loaded
+ automatically. Note that if \sty{glossaries} is loaded before
+ \sty{glossaries-extra},
+ then this option should be passed directly to \sty{glossaries}
+ not \sty{glossaries-extra} otherwise it will be too late to
+ implement}%
+ }
+ % package option nosuper
+ \gstyopt{nosuper}%
+ {%
+ \inpackage{glossaries}%
+ \desc{don't load \sty{glossary-super}, which is normally loaded
+ automatically. Note that if \sty{glossaries} is loaded before
+ \sty{glossaries-extra},
+ then this option should be passed directly to \sty{glossaries}
+ not \sty{glossaries-extra} otherwise it will be too late to
+ implement}%
+ }
+ % package option notree
+ \gstyopt{notree}%
+ {%
+ \inpackage{glossaries}%
+ \desc{don't load \sty{glossary-tree}, which is normally loaded
+ automatically. Note that if \sty{glossaries} is loaded before
+ \sty{glossaries-extra},
+ then this option should be passed directly to \sty{glossaries}
+ not \sty{glossaries-extra} otherwise it will be too late to
+ implement}%
+ }
+ % package option stylemods
+ \gstyopt{stylemods}
+ {%
+ \inpackage{glossaries-extra}
+ \syntax{\meta{value}}
+ \defval{default}
+ \desc{loads \sty{glossaries-extra-stylemods} with the given
+ options. If \opteqvalref{stylemods}{default} then no options are
+ passed to \sty{glossaries-extra-stylemods}}
+ }
+ % package option stylemods values
+ % stylemods=default
+ \goptval{stylemods}{default}{\desc{load
+ \sty{glossaries-extra-stylemods} with no options (patches any
+ predefined styles that have been loaded)}%
+ }
+ % stylemods=all
+ \goptval{stylemods}{all}%
+ {%
+ \desc{load \sty{glossaries-extra-stylemods} with all predefined styles}%
+ }
+ % stylemods=<list>
+ \goptmetaval{stylemods}{list}%
+ {%
+ \desc{load \sty{glossaries-extra-stylemods} with all the listed styles}%
+ }
+ \gstyopt{all}%
+ {%
+ \inpackage{glossaries-extra-stylemods}%
+ \desc{load all predefined styles}%
+ }
+ \gstyopt{name}%
+ {%
+ \name{{}\meta{name}}%
+ \inpackage{glossaries-extra-stylemods}%
+ \desc{load package \styfmt{glossary-\meta{name}}}%
+ }
+ % package option section
+ \gstyopt{section}
+ {
+ \inpackage{glossaries}%
+ \syntax{\meta{value}}
+ \defval{section}
+ \desc{indicates which section heading command to use for the
+ \idx{glossary}. The value may be one of the standard sectioning
+ command's control sequence name (without the leading backslash),
+ such as \code{chapter} or \code{section}}
+ }
+ % package option sort
+ \gstyopt{sort}%
+ {%
+ \inpackage{glossaries}%
+ \syntax{\meta{value}}
+ \initval{standard}
+ \desc{indicates how the \gloskey{sort} key should automatically
+ be assigned if not explicitly provided (for \gls{makeglossaries}
+ and \gls{makenoidxglossaries} only)}
+ }
+ \goptval{sort}{none}%
+ {%
+ \providedby{\sty{glossaries} v4.30+}
+ \desc{don't process the \gloskey{sort} key. Use this option
+ if no \idx{indexing} is required for a slightly faster build}%
+ }
+ \goptval{sort}{clear}%
+ {%
+ \providedby{\sty{glossaries} v4.50+}
+ \desc{sets the \gloskey{sort} key to an empty value. Use this option if no
+ \idx{indexing} is required for a slightly faster build}%
+ }%
+ \goptval{sort}{standard}%
+ {%
+ \desc{use the value of the \gloskey{name} key as the default for the
+ \gloskey{sort} key and implement the \gls{glsprestandardsort} hook}%
+ }
+ \goptval{sort}{def}%
+ {%
+ \desc{use the (zero-padded) order of definition as the default for the
+ \gloskey{sort} key}%
+ }
+ \goptval{sort}{use}%
+ {%
+ \desc{use the (zero-padded) order of use as the default for the
+ \gloskey{sort} key}%
+ }
+ % package option sanitizesort
+ \gstyopt{sanitize\-sort}%
+ {%
+ \inpackage{glossaries}%
+ \syntax{\meta{boolean}}
+ \initvalvaries
+ \defval{true}
+ \desc{indicates whether the default sort value should be sanitized
+ (only applicable with \opteqvalref{sort}{standard})}
+ }
+ % package option debug (base)
+ \glsbibwriteentry{packageoption}{opt.base.debug}%
+ {%
+ \providedby{\sty{glossaries} v4.24+}%
+ \field{name}{{}\styoptfmt{debug}}%
+ \initval{false}%
+ \syntax{\meta{value}}
+ \inpackage{glossaries}
+ \note{modified by \sty{glossaries-extra}['s] \opt{debug} option}
+ \desc{adds markers to the document for debugging purposes}
+ }
+ % package option debug
+ \gstyopt{debug}%
+ {%
+ \syntax{\meta{value}}
+ \defval{true}%
+ \initval{false}%
+ \inpackage{glossaries-extra}
+ \desc{provides debugging information. Some options are also
+ available with just the base \sty{glossaries} package}
+ }
+ % package option debug values
+ \goptval{debug}{true}%
+ {%
+ \providedby{\sty{glossaries} v4.24+}%
+ \desc{writes \code{wrglossary(\meta{type})(\meta{\idx{indexing} info})}
+ to the \ext+{log} file if there is an attempt to index an entry
+ before the associated \idx{indexing} file has been opened (\app{makeindex}
+ and \app{xindy} only). With \sty{glossaries-extra}, this setting will
+ also display the label of any undefined entries that are
+ referenced in the document}
+ }
+ \goptval{debug}{false}%
+ {%
+ \providedby{\sty{glossaries} v4.24+}%
+ \desc{disable debugging actions}
+ }
+ \goptval{debug}{showtargets}%
+ {%
+ \providedby{\sty{glossaries} v4.24+}%
+ \desc{implements \optval{debug}{true} and also shows target
+ markers in the document}%
+ \field{seealso}{opt.showtargets}
+ }
+ \goptval{debug}{showaccsupp}%
+ {%
+ \providedby{\sty{glossaries} v4.45+}%
+ \desc{implements \optval{debug}{true} and also shows accessibility information
+ in the document}
+ }
+ \goptval{debug}{showwrgloss}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.21+}%
+ \desc{implements \optval{debug}{true} and also shows a marker
+ in the document whenever the entry is \indexed\ and (if used
+ with \opt{indexcounter}) will mark where the \ctr{wrglossary}
+ counter is incremented}
+ }
+ \goptval{debug}{all}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.21+}%
+ \desc{implements all debugging options}
+ }
+ % package option showtargets
+ \gstyopt{show\-targets}%
+ {%
+ \inpackage{glossaries-extra}
+ \providedby{\sty{glossaries-extra} v1.48+}%
+ \syntax{\meta{value}}
+ \desc{implements \opteqvalref{debug}{showtargets}}
+ }
+ \goptval{showtargets}{left}%
+ {%
+ \desc{a marker is placed to the left of the link/target and
+ a marginal note is used in outer mode}
+ }
+ \goptval{showtargets}{right}%
+ {%
+ \desc{a marker is placed to the right of the link/target and
+ a marginal note is used in outer mode}
+ }
+ \goptval{showtargets}{innerleft}%
+ {%
+ \desc{a marker and annotation are placed to the left of the
+ link/target in all modes}
+ }
+ \goptval{showtargets}{innerright}%
+ {%
+ \desc{a marker and annotation are placed to the left of the
+ link/target in all modes}
+ }
+ \goptval{showtargets}{annoteleft}%
+ {%
+ \desc{markers are placed on either side of the
+ link/target with the annotation on the left in all modes}
+ }
+ \goptval{showtargets}{annoteright}%
+ {%
+ \desc{markers are placed on either side of the
+ link/target with the annotation on the right in all modes}
+ }
+ % package option undefaction
+ \gstyopt{undef\-action}%
+ {%
+ \syntax{\meta{value}}
+ \initval{error}
+ \inpackage{glossaries-extra}
+ \desc{indicates whether to trigger an error or warning if an
+ unknown entry label is referenced}
+ }
+ \goptval{undefaction}{error}%
+ {%
+ \desc{trigger an error if an unknown entry label is referenced}
+ }
+ \goptval{undefaction}{warn}%
+ {%
+ \desc{trigger a warning if an unknown entry label is referenced}
+ }
+ % package option makeindex
+ \gstyopt{makeindex}
+ {
+ \inpackage{glossaries}
+ \desc{indicates that the \idx{indexing} should be performed by
+ \app+{makeindex} (default)}
+ }
+ % package option xindy
+ \gstyopt{xindy}
+ {
+ \syntax{\margm{options}}
+ \inpackage{glossaries}
+ \desc{indicates that the \idx{indexing} should be performed by \app+{xindy}}
+ }
+ % package option hyperfirst
+ \gstyopt{hyper\-first}%
+ {%
+ \syntax{\meta{boolean}}
+ \initval{true}
+ \defval{true}
+ \inpackage{glossaries}
+ \desc{indicates whether or not to use hyperlinks on
+ \idx{firstuse} (if hyperlinks are supported)}
+ }
+ % package option indexonlyfirst
+ \gstyopt{index\-only\-first}%
+ {%
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \inpackage{glossaries}
+ \desc{indicates whether or not to only \idxc{indexing}{index}
+ the \idx{firstuse}}
+ }
+ % package option indexcrossrefs
+ \gstyopt{index\-cross\-refs}%
+ {%
+ \syntax{\meta{boolean}}
+ \initvalvaries
+ \defval{true}
+ \inpackage{glossaries-extra}
+ \desc{indicates whether or not to enable automatic \idx{indexing} of
+cross-referenced entries}
+ }
+ \goptval{indexcrossrefs}{true}%
+ {%
+ \desc{enables automatic \idx{indexing} of cross-referenced entries}
+ }
+ \goptval{indexcrossrefs}{false}%
+ {%
+ \desc{disables automatic \idx{indexing} of cross-referenced entries}
+ }
+ % package option autoseeindex
+ \gstyopt{auto\-see\-index}%
+ {%
+ \syntax{\meta{boolean}}
+ \initval{true}
+ \defval{true}
+ \inpackage{glossaries-extra}
+ \desc{indicates whether or not to enable automatic \idx{indexing} of
+ \gloskey{see} and \gloskey{seealso} fields}
+ }
+ \goptval{autoseeindex}{true}%
+ {%
+ \desc{enables automatic \idx{indexing} of \gloskey{see} and \gloskey{seealso} fields}
+ }
+ \goptval{autoseeindex}{false}%
+ {%
+ \desc{disables automatic \idx{indexing} of \gloskey{see} and \gloskey{seealso} fields}
+ }
+ % package option seenoindex
+ \gstyopt{see\-no\-index}%
+ {%
+ \syntax{\meta{value}}
+ \initval{error}
+ \inpackage{glossaries}
+ \desc{indicates what to do if the \gloskey{see} key is used
+ before the associated \idx{indexing} files have been opened by
+ \gls{makeglossaries}}
+ }
+ \goptval{seenoindex}{error}%
+ {%
+ \desc{triggers an error if the \gloskey{see} key is used before
+ \gls{makeglossaries}}
+ }
+ \goptval{seenoindex}{warn}%
+ {%
+ \desc{triggers a warning if the \gloskey{see} key is used before
+ \gls{makeglossaries}}
+ }
+ \goptval{seenoindex}{ignore}%
+ {%
+ \desc{does nothing if the \gloskey{see} key is used before
+ \gls{makeglossaries}}
+ }
+ % package option record
+ \gstyopt{record}%
+ {%
+ \common
+ \syntax{\meta{value}}
+ \initval{off}
+ \defval{only}
+ \inpackage{glossaries-extra}
+ \desc{indicates whether or not \app{bib2gls} is being used (in
+ which case entry \idx{indexing} is performed by adding \app{bib2gls}
+ \records\ in the \ext{aux} file)}
+ }
+ % package option record=off
+ \goptval{record}{off}%
+ {%
+ \desc{entry \idx{indexing} is performed as per the base \sty{glossaries} package, using
+ either \gls{makeglossaries} or \gls{makenoidxglossaries}}
+ }
+ % package option record=only
+ \goptval{record}{only}%
+ {%
+ \desc{entry \idx{indexing} is performed by adding \app{bib2gls}
+ \records\ in the \ext{aux} file. Glossaries should be displayed with the \idx{unsrtfam}}
+ }
+ % package option record=nameref
+ \goptval{record}{name\-ref}%
+ {%
+ \desc{entry \idx{indexing} is performed by adding \app{bib2gls}
+ nameref \records\ in the \ext{aux} file. Glossaries should be displayed with the \idx{unsrtfam}}
+ }
+ % package option record=hybrid
+ \goptval{record}{hybrid}%
+ {%
+ \desc{performs a mixture of \app{bib2gls} \records\ in the
+ \ext{aux} file (to select entries from a \ext{bib} file)
+ and \app+{makeindex}\slash\app+{xindy}
+ \idx{indexing} in their associated files. The actual sorting and
+ collation is performed by the \idx{indexingapp}, so
+ \resourceoptval{sort}{none} and
+ \resourceoptval{save-locations}{false}
+ should be used in \gls{GlsXtrLoadResources} (because it's
+ redundant to make \app{bib2gls} sort and collate as well).
+ This setting should be used with
+ \gls{makeglossaries} before \gls{GlsXtrLoadResources} and
+ \idxpl{glossary} should be displayed with \gls{printglossary} (or
+ \gls{printglossaries}). There's little point in using this
+ setting unless you have a custom \app{xindy} module that you can't
+ convert to an equivalent set of \app{bib2gls} options}
+ }
+ % package option record=alsoindex
+ \goptval{record}{also\-index}%
+ {%
+ \deprecated
+ \field{alias}{optval.record.hybrid}
+ }
+ % package option bibglsaux
+ \gstyopt{bib\-gls\-aux}%
+ {%
+ \inpackage{glossaries-extra}
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \app{bib2gls} v3.0+}
+ \initvalempty
+ \syntax{\meta{basename}}
+ \desc{if set, an additional \ext+{aux} file called
+ \metafilefmt{}{basename}{.aux} will be created in which to
+ store the \app{bib2gls} records. This file will be skipped by
+ \LaTeX\ when the main \ext{aux} file is input but will be read
+ by \app{bib2gls}}
+ }
+ % package option numberedsection
+ \gstyopt{numbered\-section}
+ {
+ \syntax{\meta{value}}
+ \initval{false}
+ \defval{nolabel}
+ \inpackage{glossaries}
+ \desc{indicates whether or not \idx{glossary} section headers will be numbered
+ and also if they should automatically be labelled}
+ }
+ % package option savenumberlist
+ \gstyopt{save\-number\-list}
+ {
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \inpackage{glossaries}
+ \desc{if true, patches the \idx{locationlist} encapsulator to
+ save the \idx{locationlist}. With \app{bib2gls}, use the
+ \resourceopt{save-locations} resource option}
+ }
+ % package option equations
+ \gstyopt{equations}
+ {
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \inpackage{glossaries-extra}
+ \desc{automatically switch the \idx{locationcounter} to
+ \ctr{equation} when inside a numbered equation environment}
+ }
+ % package option floats
+ \gstyopt{floats}
+ {
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \inpackage{glossaries-extra}
+ \desc{automatically switch the \idx{locationcounter} to
+ the corresponding counter when inside a floating environment}
+ }
+ % package option indexcounter
+ \gstyopt{index\-counter}
+ {
+ \inpackage{glossaries-extra}
+ \desc{defines the index counter \ctr{wrglossary} and implements
+ \optval{counter}{wrglossary}}
+ }
+ % counter wrglossary
+ \gctr{wr\-glossary}
+ {
+ \providedby{\sty{glossaries-extra}}
+ \desc{a counter that is incremented every time an entry is \indexed}
+ }
+ % package option counter
+ \gstyopt{counter}%
+ {%
+ \inpackage{glossaries}%
+ \syntax{\meta{counter-name}}
+ \initval{page}
+ \desc{sets the default \idx{locationcounter}}%
+ }
+ % package option nonumberlist
+ \gstyopt{no\-number\-list}%
+ {
+ \inpackage{glossaries}
+ \desc{set no \glspl{locationlist} as the default for all
+ \idxpl{glossary}. May be overridden for individual \idxpl{glossary} with
+ \printglossoptval{nonumberlist}{true}}
+ }
+ % package option entrycounter
+ \gstyopt{entry\-counter}%
+ {
+ \inpackage{glossaries}
+ \desc{enables the entry counter for top-level entries}
+ }
+ % package option subentrycounter
+ \gstyopt{sub\-entry\-counter}%
+ {
+ \inpackage{glossaries}
+ \desc{enables the entry counter for level~1 entries}
+ }
+ % package option writeglslabels
+ \gstyopt{write\-gls\-labels}%
+ {
+ \inpackage{glossaries}
+ \desc{creates a file called \csfmt{jobname}\filefmt{.}\ext+{glslabels}
+ that contains all defined entry labels (for the benefit of
+ autocompletion tools)}
+ }
+ % package option writeglslabelnames
+ \gstyopt{write\-gls\-label\-names}%
+ {
+ \inpackage{glossaries}
+ \desc{creates a file called \csfmt{jobname}\filefmt{.}\ext+{glslabels}
+ that contains all defined entry labels and names (for the benefit of
+ autocompletion tools)}
+ }
+ % package option nomain
+ \gstyopt{nomain}%
+ {%
+ \inpackage{glossaries}%
+ \desc{prevents the definition of the \code{main} \idx{glossary}. You
+ will need to define another \idx{glossary} to use instead. For
+ example, with the \opt{acronyms} package option}%
+ }
+ % package option acronymlists
+ \gstyopt{acronym\-lists}%
+ {
+ \inpackage{glossaries}
+ \syntax{\margm{label-list}}
+ \banned
+ \desc{identifies the \idxpl{glossary} that contain acronyms
+ (defined with the base \sty{glossaries} packages acronym mechanism)}
+ }
+ % package option shortcuts
+ \gstyopt{shortcuts}%
+ {
+ \inpackage{glossaries-extra}
+ \syntax{\margm{value}}
+ \initval{none}
+ \desc{defines various shortcut commands (boolean only with just
+ the base \sty{glossaries} package)}
+ }
+ % package option shortcuts=none
+ \goptval{shortcuts}{none}%
+ {%
+ \desc{don't define any shortcut commands}
+ }
+ % package option shortcuts=all
+ \goptval{shortcuts}{all}%
+ {%
+ \desc{implements \optval{shortcuts}{ac},
+ \optval{shortcuts}{abbreviations}, \optval{shortcuts}{other}}
+ }
+ % package option shortcuts=acother
+ \goptval{shortcuts}{acother}%
+ {%
+ \desc{implements \optval{shortcuts}{ac} and \optval{shortcuts}{other}}
+ }
+ % package option shortcuts=abother
+ \goptval{shortcuts}{abother}%
+ {%
+ \desc{implements \optval{shortcuts}{abbreviations} and \optval{shortcuts}{other}}
+ }
+ % package option shortcuts=true
+ \goptval{shortcuts}{true}%
+ {%
+ \field{alias}{optval.shortcuts.all}
+ }
+ % package option shortcuts=false
+ \goptval{shortcuts}{false}%
+ {%
+ \field{alias}{optval.shortcuts.all}
+ }
+ % package option shortcuts=ac
+ \goptval{shortcuts}{ac}%
+ {%
+ \desc{implements the acronym shortcuts that are compatible with
+ \gls{newabbreviation}}
+ }
+ % package option shortcuts=abbreviations
+ \goptval{shortcuts}{abbreviations}%
+ {%
+ \desc{implements the abbreviation shortcuts}
+ }
+ % package option shortcuts=abbr
+ \goptval{shortcuts}{abbr}%
+ {%
+ \field{alias}{optval.shortcuts.abbreviations}
+ }
+ % package option shortcuts=other
+ \goptval{shortcuts}{other}%
+ {%
+ \desc{implements the shortcuts \gls{newentry}, \gls{newsym} and
+ \gls{newnum}}
+ }
+ % package option shortcuts=acronyms
+ \goptval{shortcuts}{acronyms}%
+ {%
+ \desc{implements the acronym shortcuts. Don't use this option
+unless you have reverted \gls{newacronym} back to the base
+\sty{glossaries} package's acronym mechanism}
+ }
+ % package option shortcuts=acro
+ \goptval{shortcuts}{acro}%
+ {%
+ \field{alias}{optval.shortcuts.acronyms}
+ }
+ % package option acronyms
+ \gstyopt{acronyms}%
+ {
+ \inpackage{glossaries}
+ \desc{provides a new \idx{glossary} with the label \code{acronym},
+ redefines \gls{acronymtype} to \code{acronym}, and provides
+ \gls{printacronyms}}
+ }
+ % package option acronym
+ \gstyopt{acronym}%
+ {
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \inpackage{glossaries}
+ \desc{if true, provides a new \idx{glossary} with the label
+ \code{acronym} and title given by \gls{acronymname},
+ redefines \gls{acronymtype} to \code{acronym}, and provides
+ \gls{printacronyms}}
+ }
+ % package option abbreviations
+ \gstyopt{abbreviations}%
+ {
+ \inpackage{glossaries-extra}
+ \desc{provides a new \idx{glossary} with the label
+ \code{abbreviations} and title given by \gls{abbreviationsname},
+ redefines \gls{glsxtrabbrvtype} to \code{abbreviations},
+ redefines \gls{acronymtype} to \gls{glsxtrabbrvtype} (unless
+ the \opt{acronym} or \opt{acronyms} option has been used), and provides
+ \gls{printabbreviations}}
+ }
+ % package option symbols
+ \gstyopt{symbols}%
+ {
+ \inpackage{glossaries}
+ \desc{provides a new \idx{glossary} with the label \code{symbols} and
+ the title \gls{glssymbolsgroupname}, and provides
+ \gls{printsymbols}. With \sty{glossaries-extra}, this additionally
+ defines \gls{glsxtrnewsymbol}}
+ }
+ % package option numbers
+ \gstyopt{numbers}%
+ {
+ \inpackage{glossaries}
+ \desc{provides a new \idx{glossary} with the label \code{numbers} and
+ the title \gls{glsnumbersgroupname}, and provides \gls{printnumbers}.
+ With \sty{glossaries-extra}, this additionally
+ defines \gls{glsxtrnewnumber}}
+ }
+ % package option index
+ \gstyopt{index}%
+ {
+ \inpackage{glossaries}
+ \desc{provides a new \idx{glossary} with the label \code{index} and
+ the title \gls{indexname}, and provides \gls{printindex} and
+ \gls{newterm}}
+ }
+ % package option nomissingglstext
+ \gstyopt{no\-missing\-gls\-text}%
+ {%
+ \inpackage{glossaries-extra}
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \desc{determines whether or not to display warning text if the
+ external \idx{glossary} file hasn't been generated due to an
+ incomplete build}
+ }
+ % package option nopostdot
+ \gstyopt{nopostdot}%
+ {%
+ \inpackage{glossaries}
+ \syntax{\meta{boolean}}
+ \initval{true}
+ \defval{true}
+ \desc{if true, suppresses the automatic insertion of a
+ \idx{fullstop} after each entry's description in the \idx{glossary}
+ (for styles that support this). The default is
+ \optval{nopostdot}{true} for \sty{glossaries-extra} and
+ \optval{nopostdot}{false} for just \sty{glossaries}}
+ \field{seealso}{opt.postdot,opt.postpunc}
+ }
+ % package option postdot
+ \gstyopt{postdot}%
+ {%
+ \inpackage{glossaries-extra}
+ \providedby{\sty{glossaries-extra} v1.12+}%
+ \desc{a shortcut for \optval{nopostdot}{false}}
+ \field{seealso}{opt.nopostdot,opt.postpunc}
+ }
+ % package option postpunc
+ \gstyopt{postpunc}%
+ {%
+ \inpackage{glossaries-extra}
+ \providedby{\sty{glossaries-extra} v1.21+}%
+ \syntax{\meta{value}}
+ \desc{an alternative to \opt{postdot}, this can be used to
+ insert a different punctuation character after the description}
+ }
+ % package option postpunc values
+ \goptval{postpunc}{dot}%
+ {%
+ \desc{equivalent to \opt{postdot} or \optval{nopostdot}{false}}
+ }
+ \goptval{postpunc}{comma}%
+ {%
+ \desc{inserts a comma after the description}
+ }
+ \goptval{postpunc}{none}%
+ {%
+ \desc{switches off automatic post-description punctuation insertion}
+ }
+ \goptval{postpunc}{other}%
+ {%
+ \name{{}\meta{punctuation}}
+ \desc{inserts \meta{punctuation} after the description}
+ }
+ % package option nowarn
+ \gstyopt{no\-warn}%
+ {%
+ \inpackage{glossaries}
+ \desc{suppresses warnings}
+ }
+ % package option noredefwarn
+ \gstyopt{noredefwarn}%
+ {%
+ \inpackage{glossaries}
+ \desc{suppresses a warning if \env{theglossary} or
+ \gls{printglossary} have already been defined (which indicates
+ that the document class or another package also provides a mechanism
+ for creating a \idx{glossary} that could potentially conflict with
+ \sty{glossaries}). This option is automatically implemented with
+ \sty{glossaries-extra}}
+ }
+ % package option translate
+ \gstyopt{translate}%
+ {%
+ \inpackage{glossaries}
+ \syntax{\meta{value}}
+ \initval{babel}
+ \desc{indicates how multilingual support should be provided, if
+ applicable}
+ }
+ % package option translate values
+ \goptval{translate}{babel}%
+ {%
+ \desc{uses \sty{babel}['s] language hooks to implement
+ multilingual support (default for \sty{glossaries-extra} if
+ \sty{babel} has been detected)}
+ }
+ \goptval{translate}{true}%
+ {%
+ \desc{uses \sty{translator}['s] language hooks to implement
+ multilingual support (default for \sty{glossaries} if a
+ language package has been detected)}
+ }
+ \goptval{translate}{false}%
+ {%
+ \desc{don't implement multilingual support (default if no
+ language package has been detected)}
+ }
+ % package option notranslate
+ \gstyopt{notranslate}%
+ {%
+ \inpackage{glossaries}
+ \desc{equivalent to \optval{translate}{false}}
+ }
+ % package option nogroupskip
+ \gstyopt{nogroupskip}%
+ {%
+ \inpackage{glossaries}
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \desc{if true, suppress the gap between letter \idxpl{group} in the
+ \idxpl{glossary} by default}
+ }
+ % package option toc
+ \gstyopt{toc}%
+ {%
+ \inpackage{glossaries}
+ \syntax{\meta{boolean}}
+ \initval{true}
+ \defval{true}
+ \desc{if true, each \idx{glossary} will be automatically added to the
+ table of contents. The default is \optval{toc}{false} with
+ \sty{glossaries} and \optval{toc}{true} with \sty{glossaries-extra}}
+ }
+ % package option docdef
+ \gstyopt{docdef}%
+ {%
+ \inpackage{glossaries-extra}
+ \syntax{\meta{value}}
+ \initval{false}
+ \defval{true}
+ \desc{determines whether or not \gls{newglossaryentry} is
+ permitted in the \env{document} environment}
+ }
+ \goptval{docdef}{false}%
+ {%
+ \desc{don't allow \gls{newglossaryentry} in the \env{document}
+ environment}
+ }
+ \goptval{docdef}{true}%
+ {%
+ \desc{allow \gls{newglossaryentry} in the \env{document}
+ environment if the base \sty{glossaries} package would allow it}
+ }
+ \goptval{docdef}{restricted}%
+ {%
+ \desc{allow \gls{newglossaryentry} in the \env{document}
+ environment, but only before any \idxpl{glossary}}
+ }
+ \goptval{docdef}{atom}%
+ {%
+ \desc{as \optfmt{restricted} but creates the \ext{glsdefs} file
+ for atom's autocomplete support}
+ }
+ % package option automake
+ \gstyopt{auto\-make}%
+ {%
+ \inpackage{glossaries}
+ \syntax{\meta{value}}
+ \initval{false}
+ \defval{true}
+ \desc{indicates whether or not to attempt to use \TeX's shell
+ escape to run an \idx{indexingapp}}
+ }
+ % package option mfirstuc
+ \gstyopt{mfirstuc}
+ {
+ \inpackage{glossaries}
+ \providedby{\sty{glossaries} v4.50+}
+ \initval{unexpanded}
+ \desc{implements the \optfmt{expanded} and \optfmt{unexpanded}
+ options provided by \sty{mfirstuc}}
+ }
+ % COMMANDS
+ % COMMANDS: OPTIONS
+ % \setupglossaries
+ \gcmd{set\-up\-glos\-saries}%
+ {%
+ \providedby{\sty{glossaries} v3.11a+}
+ \syntax{\margm{options}}
+ \desc{change allowed options that are defined by the base
+ \sty{glossaries} package. Note that some options can only be
+ passed as package options. To change options defined or modified
+ by the \sty{glossaries-extra} package, use
+ \gls{glossariesextrasetup}}
+ }
+ % \glossariesextrasetup
+ \gcmd{glos\-saries\-extra\-setup}%
+ {%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{options}}
+ \desc{change allowed options that are defined or modified by the
+ \sty{glossaries-extra} package. Note that some options can only be
+ passed as package options}
+ }
+ % \glsindexingsetting
+ \gcmd{gls\-index\-ing\-setting}
+ {
+ \providedby{\sty{glossaries} v4.50+ \& \sty{glossaries-extra} v1.49+}
+ \desc{indicates what \idx{indexing} option has been chosen}
+ }
+ % \glsxtrsetbibglsaux
+ \gcmd{gls\-xtr\-set\-bib\-gls\-aux}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \app{bib2gls} v3.0+}
+ \syntax{\margm{basename}}
+ \desc{as the \opt{bibglsaux} option}
+ }
+ % COMMANDS: DEBUGGING
+ % \glsshowtargetinner
+ \gcmd{gls\-show\-target\-inner}%
+ {%
+ \providedby{\sty{glossaries} v4.50+}
+ \syntax{\margm{target-name}}
+ \desc{formats the target name for inner and maths mode when
+ \opteqvalref{debug}{showtargets} is enabled}
+ }
+ % \glsshowtargetouter
+ \gcmd{gls\-show\-target\-outer}%
+ {%
+ \providedby{\sty{glossaries} v4.50+}
+ \syntax{\margm{target-name}}
+ \desc{formats the target name for outer mode when
+ \opteqvalref{debug}{showtargets} is enabled. This places a
+ marker (\gls{glsshowtargetsymbol}) in the text and
+ \meta{target-name} in the margin}
+ }
+ % \glsshowtarget
+ \gcmd{gls\-show\-target}%
+ {%
+ \providedby{\sty{glossaries} v4.32+}
+ \syntax{\margm{target-name}}
+ \desc{formats the target name when
+ \opteqvalref{debug}{showtargets} is enabled using either
+ \gls{glsshowtargetinner} or \gls{glsshowtargetouter}, depending
+ on the current mode}
+ }
+ % \glsshowtargetfont
+ \gcmd{gls\-show\-target\-font}%
+ {%
+ \providedby{\sty{glossaries} v4.45+}
+ \desc{font declaration used by debugging annotations}
+ }
+ % \glsshowtargetfonttext
+ \gcmd{gls\-show\-target\-font\-text}%
+ {%
+ \providedby{\sty{glossaries} v4.50+}
+ \syntax{\margm{text}}
+ \desc{text-block command that checks for math mode and switches
+ to the font given by the \gls{glsshowtargetfont} declaration}
+ }
+ % \glsshowtargetsymbol
+ \gcmd{gls\-show\-target\-symbol}%
+ {%
+ \providedby{\sty{glossaries} v4.45+}
+ \desc{marker (\glsshowtargetsymbol) used in debugging annotations}
+ }
+ % \glsxtrwrglossmark
+ \gcmd{gls\-xtr\-wr\-gloss\-mark}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \desc{marker (\glsxtrwrglossmark) used to mark write operations
+ with \opteqvalref{debug}{showwrgloss}}
+ }
+ % \glsxtrwrglosscountermark
+ \gcmd{gls\-xtr\-wr\-gloss\-counter\-mark}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{number}}
+ \desc{used to mark where the \ctr{wrglossary} counter is
+ incrememented with \opteqvalref{debug}{showwrgloss}}
+ }
+ % \glsxtrshowtargetouter
+ \gcmd{gls\-xtr\-show\-target\-outer}%
+ {%
+ \syntax{\margm{target-name}}
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{used in outer mode for debugging, this defaults to
+ \gls{glsshowtargetouter} but is changed by the
+ \opt{showtargets} options}
+ }
+ % \glsxtrshowtargetinner
+ \gcmd{gls\-xtr\-show\-target\-inner}%
+ {%
+ \syntax{\margm{target-name}}
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{used in inner mode for debugging, this defaults to
+ \gls{glsshowtargetinner} but is changed by the
+ \opt{showtargets} options}
+ }
+ % \glsshowtargetinnersymleft
+ \gcmd{gls\-show\-target\-inner\-sym\-left}%
+ {%
+ \syntax{\marg{name}}
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{shows the left inner annotation followed by the left
+ marker symbol \gls{glsxtrshowtargetsymbolleft}}
+ }
+ % \glsshowtargetinnersymright
+ \gcmd{gls\-show\-target\-inner\-sym\-right}%
+ {%
+ \syntax{\marg{name}}
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{shows the right marker symbol
+ \gls{glsxtrshowtargetsymbolright} followed by the right inner annotation}
+ }
+ % \glsxtrshowtargetsymbolleft
+ \gcmd{gls\-xtr\-show\-target\-symbol\-left}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{the left marker debugging symbol~(\glsxtrshowtargetsymbolleft)}
+ }
+ % \glsxtrshowtargetsymbolright
+ \gcmd{gls\-xtr\-show\-target\-symbol\-right}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{the right marker debugging symbol~(\glsxtrshowtargetsymbolright)}
+ }
+ % COMMANDS: INDEXING INITIALISATION
+ % \glsprestandardsort
+ \gcmd{gls\-pre\-standard\-sort}
+ {
+ \providedby{\sty{glossaries} v3.13a+}
+ \syntax{\margm{sort cs}\margm{type}\margm{entry-label}}
+ \desc{hook used with \opteqvalref{sort}{standard} to adjust the
+ default sort value (with \gls{makeglossaries} or
+ \gls{makenoidxglossaries} only)}
+ }
+ % \makeglossaries
+ \gcmd{make\-glossaries}%
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{types}}
+ \desc{opens the associated \idx{glossary} files that need to be
+ processed by \app+{makeindex} or \app+{xindy}. The optional
+ argument is only available with \sty{glossaries-extra} and is
+ used for a hybrid approach. All \idxpl{glossary} (or each \idx{glossary}
+ identified in \meta{types}) should be displayed with
+ \gls{printglossary}. If the optional argument is present, any
+ \idxpl{glossary} not identified in \meta{types} should be displayed with
+ \gls{printnoidxglossary}}
+ }
+ % \makenoidxglossaries
+ \gcmd{make\-noidx\-glossaries}%
+ {%
+ \providedby{\sty{glossaries} v4.04+}
+ \desc{sets up all non-\idxpl{ignoredglossary} so that they can be displayed
+ with \gls{printnoidxglossary}}
+ }
+ % COMMANDS: GLOSSARIES
+ % \glsdefaulttype
+ \gcmd{gls\-default\-type}%
+ {%
+ \providedby{\sty{glossaries}}
+ \initval{main}%
+ \desc{expands to the label of the default \idx{glossary}, which is
+ normally \code{main} but if \opt{nomain} is used, it will be the
+ label of the first \idx{glossary} to be defined}
+ }%
+ % \acronymtype
+ \gcmd{acronym\-type}%
+ {%
+ \providedby{\sty{glossaries}}
+ \initvalcs{glsdefaulttype}%
+ \desc{expands to the label of the default acronym \idx{glossary}. The
+ \opt{acronym} or \opt{acronyms} package option will redefine
+ this to \code{acronym}. The \opt{abbreviations} package option
+ will redefine this to \gls{glsxtrabbrvtype} if
+ \opt{acronyms}\slash\opt{acronym} isn't used}
+ }%
+ % \glsxtrabbrvtype
+ \gcmd{gls\-xtr\-abbrv\-type}%
+ {%
+ \initvalcs{glsdefaulttype}%
+ \providedby{\sty{glossaries-extra}}
+ \desc{expands to the label of the default abbreviation \idx{glossary}. The
+ \opt{abbreviations} package option will redefine
+ this to \code{abbreviations}}
+ }%
+ % \newglossary
+ \gcmd{new\-glos\-sary}%
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{log-ext}\margm{glossary-label}\margm{in-ext}\margm{out-ext}\margm{title}\oargm{counter}}
+ \desc{defines a \idx{glossary} identified by \meta{glossary-label} (which can
+ be referenced by the \gloskey{type} key when defining an entry).
+ The \meta{title} will be used when displaying the \idx{glossary}
+ (using commands like \gls{printglossary}), but this title can be
+ overridden by the \printglossopt{title} option. The optional
+ \meta{counter} indicates which \idxc{locationcounter}{counter} should be used by default
+ for the \location\ when \idx{indexing} any entries that have been assigned to this
+ \idx{glossary}. (This can be overridden by the \glsopt{counter}
+ option.) The other arguments are file extensions for use with
+ \app{makeindex} or \app{xindy}. These arguments aren't relevant
+ for other \idx{indexing} options (in which case, you may prefer to use
+ \gls{newglossary*})}
+ }
+ % \newglossary*
+ \gcmd{new\-glos\-sary*}%
+ {%
+ \providedby{\sty{glossaries} v4.08+}
+ \syntax{\margm{glossary-label}\margm{title}\oargm{counter}}
+ \desc{a shortcut that supplies file extensions based on the
+ \idx{glossary} label:\begin{compactcodebox}%
+\gls{newglossary}\oarg{\meta{glossary-label}-glg}\margm{glossary-label}\marg{\meta{glossary-label}-gls}\margm{\meta{glossary-label}-glo}\margm{title}\oargm{counter}%
+\end{compactcodebox}\glsxtrnopostpunc
+}
+ }
+ % \newignoredglossary
+ \gcmd{new\-ignored\-glos\-sary}%
+ {%
+ \providedby{\sty{glossaries} v4.08+}
+ \syntax{\margm{glossary-label}}
+ \desc{defines a \idx{glossary} that should be ignored by iterative
+ commands, such as \gls{printglossaries}. This \idx{glossary} has no
+ associated \idx{indexing} files and has hyperlinks disabled. You can
+ use an \idx{ignoredglossary} for common terms or abbreviations that don't need to be
+ included in any listing (but you may want these terms defined
+ as entries to allow automated formatting with the \idx{glslike}
+ commands). An \idx{ignoredglossary} can't be displayed with
+ \gls{printglossary} but may be displayed with the \idx{unsrtfam}, such as
+ \gls{printunsrtglossary}}
+ }
+ % \newignoredglossary*
+ \gcmd{new\-ignored\-glos\-sary*}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.11+}
+ \syntax{\margm{glossary-label}}
+ \desc{this is like the unstarred \gls{newignoredglossary} but
+ doesn't disable hyperlinks. You will need to ensure that the
+ hypertargets are defined. For example, with
+ \gls{printunsrtglossary} or through \idxpl{standaloneentry}}
+ }
+ % \provideignoredglossary
+ \gcmds{provide\-ignored\-glos\-sary}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{glossary-label}}
+ \desc{as \gls{newignoredglossary} but does nothing if the
+ \idx{glossary} has already been defined}
+ }
+ % \ifglossaryexists
+ \gcmds{if\-glos\-sary\-exists}
+ {
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{glossary-type}\margm{true}\margm{false}}
+ \desc{if the \idx{glossary} given by \meta{glossary-type} exists,
+ this does \meta{true}, otherwise it does \meta{false}. The
+ unstarred form treats \idxpl{ignoredglossary} as non-existent. The
+ starred form (v4.46+) will do \meta{true} if \meta{glossary-type} matches
+ an ignored glossary}
+ \field{seealso}{doifglossarynoexistsordo,glsxtrifemptyglossary}
+ }
+ % \doifglossarynoexistsordo
+ \gcmd{do\-if\-glos\-sary\-no\-exists\-or\-do}
+ {
+ \providedby{\sty{glossaries} v4.19+}
+ \syntax{\margm{glossary-type}\margm{true}\margm{false}}
+ \desc{if the \idx{glossary} given by \meta{glossary-type} doesn't
+ exist, this does \meta{true}, otherwise it generates an error
+ and does \meta{false}. This uses the starred form of
+ \gls{ifglossaryexists} to test for existence}
+ \field{seealso}{ifglossaryexists,glsxtrifemptyglossary}
+ }
+ % \glsxtrifemptyglossary
+ \gcmd{gls\-xtr\-if\-empty\-glos\-sary}
+ {
+ %\providedby{\sty{glossaries-extra} v0.4+}
+ \syntax{\margm{glossary-type}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the glossary identified by
+ \meta{glossary-type} is empty, otherwise does \meta{false}.
+ If the \idx{glossary} doesn't exist, this does \meta{true} and
+ will either generate an error (\opteqvalref{undefaction}{error})
+ or a warning (\opteqvalref{undefaction}{warn}). This command
+ considers \idxpl{ignoredglossary} as existing}
+ \field{seealso}{ifglossaryexists,GlsXtrIfInGlossary}
+ }
+ % \GlsXtrIfInGlossary
+ \gcmd{Gls\-Xtr\-If\-In\-Glossary}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{glossary-type}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the entry given by \meta{entry-label}
+ is in the internal list of the \idx{glossary} identified by
+ \meta{glossary-type}, otherwise it does \meta{false}. If the
+ \idx{glossary} doesn't exist, this does \meta{false} and
+ will either generate an error (\opteqvalref{undefaction}{error})
+ or a warning (\opteqvalref{undefaction}{warn}). This command
+ considers \idxpl{ignoredglossary} as existing}
+ \field{seealso}{ifglossaryexists,glsxtrifemptyglossary}
+ }
+ % \glsxtrcopytoglossary
+ \gcmds{gls\-xtr\-copy\-to\-glos\-sary}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{glossary-type}}
+ \desc{copies the entry to the internal \idx{glossary} list for
+ the given \idx{glossary}. The starred version performs a global
+ change. The unstarred version can be localised. Only for use with
+ the \idx{unsrtfam}}
+ }
+ % \glsxtrgroupfield
+ \gcmd{gls\-xtr\-group\-field}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \initval{group}
+ \desc{expands to the \idx{internalfieldlabel} used to store the
+ group label (requires \opt{record})}
+ }
+ % \glsautoprefix
+ \gcmd{gls\-auto\-prefix}
+ {
+ \providedby{\sty{glossaries} v1.14+}
+ \desc{expands to the prefix for the label used by
+ \optval{numberedsection}{autolabel} and \optval{numberedsection}{nameref}}
+ }
+ % \glsxtrsetglossarylabel
+ \gcmd{gls\-xtr\-set\-glos\-sary\-label}
+ {
+ \providedby{\sty{glossaries-extra} v1.39+}
+ \syntax{\margm{label}}
+ \desc{sets the label to add (using
+ \code{\gls{label}\margm{label}}) after the \idx{glossary} section
+ heading}
+ }
+ % COMMANDS: GLOSSARY STYLES
+ % \ifglsnogroupskip
+ \gcond{if\-gls\-no\-group\-skip}
+ {
+ \providedby{\sty{glossaries} v3.03+}
+ \initvalcs{iffalse}
+ \desc{conditional set by the \opt{nogroupskip} option}
+ }
+ % \glossentryname
+ \gcmd{gloss\-entry\-name}
+ {%
+ \providedby{\sty{glossaries} v3.08a+}
+ \syntax{\margm{entry-label}}
+ \desc{used by \idx{glossary} styles to display the entry's name}
+ }
+ % \Glossentryname
+ \gcmd{Gloss\-entry\-name}
+ {%
+ \providedby{\sty{glossaries} v3.08a+}
+ \syntax{\margm{entry-label}}
+ \desc{as \gls{glossentryname} but \idx{sentencecase}}
+ }
+ % \glossentrynameother
+ \gcmd{gloss\-entry\-name\-other}
+ {%
+ \providedby{\sty{glossaries-extra} v1.22+}
+ \syntax{\margm{entry-label}\margm{field-label}}
+ \desc{behaves like \gls{glossentryname} but uses the given field
+ (identified by its \idxc{internalfieldlabel}{internal label})
+ instead of \gloskey{name}}
+ }
+ % \glossentrysymbol
+ \gcmd{gloss\-entry\-symbol}
+ {%
+ \providedby{\sty{glossaries} v3.08a+}
+ \syntax{\margm{entry-label}}
+ \desc{used by \idx{glossary} styles to display the entry's symbol}
+ }
+ % \Glossentrysymbol
+ \gcmd{Gloss\-entry\-symbol}
+ {%
+ \providedby{\sty{glossaries} v3.08a+}
+ \syntax{\margm{entry-label}}
+ \desc{as \gls{glossentrysymbol} but \idx{sentencecase}}
+ }
+ % \glsentrypdfsymbol
+ \gcmd{gls\-entry\-pdf\-symbol}
+ {%
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}}
+ \desc{used when \gls{glossentrysymbol} occurs in a PDF bookmark}
+ }
+ % \glossentrydesc
+ \gcmd{gloss\-entry\-desc}
+ {%
+ \providedby{\sty{glossaries} v3.08a+}
+ \syntax{\margm{entry-label}}
+ \desc{used by \idx{glossary} styles to display the entry's
+ description}
+ }
+ % \Glossentrydesc
+ \gcmd{Gloss\-entry\-desc}
+ {%
+ \providedby{\sty{glossaries} v3.08a+}
+ \syntax{\margm{entry-label}}
+ \desc{as \gls{glossentrydesc} but \idx{sentencecase}}
+ }
+ % \GlsXtrFormatLocationList
+ \gcmd{Gls\-Xtr\-Format\-Location\-List}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.2+}
+ \syntax{\margm{location list}}
+ \desc{used by \gls{glossaryentrynumbers} to encapsulate the entire
+ \idx{locationlist} in the
+ \idx{glossary}}
+ }
+ % \glossaryentrynumbers
+ \gcmd{glos\-sary\-entry\-numbers}
+ {
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{location list}}
+ \desc{used within the \idx{glossary} to encapsulate the
+ \idx{locationlist} (redefined by the \opt{nonumberlist} option)}
+ }
+ % \GlsXtrEnablePreLocationTag
+ \gcmd{Gls\-Xtr\-Enable\-Pre\-Location\-Tag}
+ {
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \syntax{\margm{page tag}\margm{pages tag}}
+ \desc{enables the \idx{locationlist} tag}
+ }
+ % \glsnoidxdisplayloc
+ \gcmd{gls\-no\-idx\-display\-loc}
+ {
+ \providedby{\sty{glossaries} v4.04+}
+ \syntax{\margm{prefix}\margm{counter}\margm{format}\margm{location}}
+ \desc{used to display a location in the location list}
+ }
+ % \glsxtrdisplaysingleloc
+ \gcmd{gls\-xtr\-display\-single\-loc}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{format}\margm{location}}
+ \desc{used to display a single location}
+ }
+ % \glsxtrdisplaystartloc
+ \gcmd{gls\-xtr\-display\-start\-loc}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{format}\margm{location}}
+ \desc{used to display a start location from an explicit range}
+ }
+ % \glsxtrdisplayendloc
+ \gcmd{gls\-xtr\-display\-end\-loc}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{format}\margm{location}}
+ \desc{used to display an end location from an explicit range}
+ }
+ % \glsxtrlocrangefmt
+ \gcmd{gls\-xtr\-loc\-range\-fmt}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \desc{expands to the range format (set by \gls{glsxtrdisplaystartloc})}
+ }
+ % \glsxtrdisplayendlochook
+ \gcmd{gls\-xtr\-display\-end\-loc\-hook}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \desc{hook used by \gls{glsxtrdisplayendloc}}
+ }
+ % theglossary environment
+ \genv{the\-glossary}%
+ {%
+ \providedby{\sty{glossaries}}
+ \desc{redefined by \idxpl{glossarystyle} to set up the way the
+ \idx{glossary} is displayed. For example, to start and end the
+ \env{description} environment for the \glostyle{list} styles}
+ }
+ % \glsnumberformat
+ \gcmd{gls\-number\-format}%
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{location(s)}}
+ \desc{the default \idxc{locationencap}{format} for \idxpl{entrylocation}. If
+ hyperlinks are defined, this will use \gls{glshypernumber}
+ otherwise it will simply display its argument, which may be a
+ single \location, or locations delimited by \gls{delimR} or
+ \gls{delimN}}
+ }
+ % \delimR
+ \gcmd{delimR}%
+ {%
+ \providedby{\sty{glossaries}}
+ \desc{used between the start and end of a \location\ range}
+ }
+ % \delimN
+ \gcmd{delimN}%
+ {%
+ \providedby{\sty{glossaries}}
+ \desc{used as a separator between \locations}
+ }
+ % \glshypernumber
+ \gcmd{gls\-hyper\-number}%
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{location(s)}}
+ \desc{this will encapsulate each location with a hyperlink, if
+ supported. This may be used as a \idx{locationencap}.
+ The argument may be a single location or locations
+ delimited by \gls{delimR} or \gls{delimN}. This command should
+ not be used outside of \idxpl{locationlist} as it
+ requires additional information in order to correctly form the
+ hyperlinks}
+ }
+ % \hyperbf
+ \gcmd{hyper\-bf}
+ {
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{location(s)}}
+ \desc{if hyperlinks are supported this does
+ \code{\cmd{textbf}\marg{\gls{glshypernumber}\margm{location(s)}}} otherwise it just
+ does \code{\cmd{textbf}\margm{location(s)}}}
+ }
+ % \glstarget
+ \gcmd{gls\-target}%
+ {%
+ \providedby{\sty{glossaries} v1.18+}
+ \syntax{\margm{entry-label}\margm{text}}
+ \desc{used by \idxpl{glossarystyle} to create a hypertarget (if enabled) for
+ the entry (identified by \meta{entry-label}). The \meta{text} is usually
+ \gls{glossentryname}\margm{entry-label}, but it can be something
+ else}
+ }
+ % \setentrycounter
+ \gcmd{set\-entry\-counter}
+ {
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{prefix}\margm{counter}}
+ \desc{used to set the \idx{locationcounter} and prefix required
+ for \gls{glshypernumber}}
+ }
+ % \glsentryitem
+ \gcmd{gls\-entry\-item}
+ {
+ \providedby{\sty{glossaries} v3.0+}
+ \syntax{\margm{entry-label}}
+ \desc{does nothing if \optval{entrycounter}{false},
+ otherwise increments and displays the associated counter}
+ }
+ % \glssubentryitem
+ \gcmd{gls\-sub\-entry\-item}
+ {
+ \providedby{\sty{glossaries} v3.0+}
+ \syntax{\margm{entry-label}}
+ \desc{does nothing if \optval{subentrycounter}{false},
+ otherwise increments and displays the associated counter}
+ }
+ % \glsentrycounterlabel
+ \gcmd{gls\-entry\-counter\-label}
+ {
+ \providedby{\sty{glossaries} v3.0+}
+ \desc{used by \gls{glsentryitem} to display the entry counter label}
+ }
+ % \theglossaryentry
+ \gcmd{the\-glossary\-entry}
+ {
+ \providedby{\sty{glossaries} v3.0+}
+ \desc{the value of the \ctr{glossaryentry} counter}
+ }
+ % counter glossaryentry
+ \gctr{glossary\-entry}
+ {
+ \providedby{\sty{glossaries} v3.0+}
+ \desc{the counter associated with the \opt{entrycounter} package option}
+ }
+ % \glsnamefont
+ \gcmd{gls\-name\-font}
+ {
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{text}}
+ \desc{used by \gls{glossentryname} to apply a font change to the
+ \gloskey{name}, unless (with \sty{glossaries-extra}) the
+ \catattr{glossnamefont} attribute has been set}
+ }
+ % \glsxtrpostname<category>
+ \gcmdmeta{gls\-xtr\-post\-name}{cat\-e\-gory}{}{%
+ \providedby{\sty{glossaries-extra} v1.04+}%
+ \desc{the \gls{postnamehook} associated with the category
+ identified by the label \meta{category}}
+ }
+ % \glsxtrpostnamehook
+ \gcmd{gls\-xtr\-post\-name\-hook}{%
+ %\providedby{\sty{glossaries-extra} v0.5.3+}%
+ \syntax{\margm{entry-label}}
+ \desc{a hook that's performed within \gls{glossentryname}
+ and \gls{glossentrynameother} after the entry name is
+ displayed. This hook implements auto-indexing (see
+ \sectionref{sec:autoindex}), then the general hook
+ \gls{glsextrapostnamehook} and finally the
+ \gls{glsxtrpostnamecategory} hook}
+ }
+ % \glsextrapostnamehook
+ \gcmd{gls\-extra\-post\-name\-hook}{%
+ \providedby{\sty{glossaries-extra} v1.25+}%
+ \syntax{\margm{entry-label}}
+ \desc{a general purpose hook that's performed within \gls{glsxtrpostnamehook}}
+ }
+ % \glsdefpostname
+ \gcmd{gls\-def\-post\-name}{%
+ \providedby{\sty{glossaries-extra} v1.31+}%
+ \syntax{\margm{category}\margm{definition}}
+ \desc{defines \idx{postnamehook} associated with the category
+ identified by the label \meta{category}. This simply (re)defines
+ \gls{glsxtrpostnamecategory} for the given \meta{category} to
+ \meta{definition}}
+ }
+ % \glspostdescription
+ \gcmd{gls\-post\-de\-scrip\-tion}%
+ {%
+ \providedby{\sty{glossaries}}
+ \desc{a hook that is usually placed after the description in
+ \idxpl{glossarystyle}. Some of the styles provided with the
+ \sty{glossaries} package don't use this hook. The
+ \sty{glossaries-extra-stylemods} redefines those styles to
+ include the hook. The default definition of this command
+ tests for the \opt{nopostdot} option, but the \opt{postpunc}
+ option redefines the command to implement the chosen punctuation}
+ }
+ % \glsxtrpostdescription
+ \gcmd{gls\-xtr\-post\-de\-scrip\-tion}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{an additional hook used within \gls{glspostdescription}
+ that implements the \idx{catpostdeschook}}
+ }
+ % \glsxtrpostdesc<category>
+ \gcmdmeta{gls\-xtr\-post\-desc}{cat\-e\-gory}{}{%
+ \providedby{\sty{glossaries-extra}}
+ \desc{the \gls{postdeschook} associated with the category
+ identified by the label \meta{category}}
+ }
+ % \glsdefpostdesc
+ \gcmd{gls\-def\-post\-desc}{%
+ \providedby{\sty{glossaries-extra} v1.31+}
+ \syntax{\margm{category}\margm{definition}}
+ \desc{defines \idx{postdeschook} associated with the category
+ identified by the label \meta{category}. This simply (re)defines
+ \gls{glsxtrpostdesccategory} for the given \meta{category} to
+ \meta{definition}}
+ }
+ % \glsxtrpostdescgeneral
+ \gcmd{gls\-xtr\-post\-desc\-general}%
+ {%
+ \initvalempty
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{the default post-description hook for the \cat{general} category}
+ }
+ % \glsxtrpostdescsymbol
+ \gcmd{gls\-xtr\-post\-desc\-symbol}%
+ {%
+ \initvalempty
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \note{requires \code{\csfmt{usepackage}\oarg{\opt{symbols}}\marg{glossaries-extra}}}
+ \desc{the default \gls{postdeschook} for the \cat{symbol} category}
+ }
+ % \glsxtrpostdescnumber
+ \gcmd{gls\-xtr\-post\-desc\-number}%
+ {%
+ \initvalempty
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \note{requires \code{\csfmt{usepackage}\oarg{\opt{numbers}}\marg{glossaries-extra}}}
+ \desc{the default post-description hook for the \cat{number} category}
+ }
+ % \glsxtrpostdescindex
+ \gcmd{gls\-xtr\-post\-desc\-index}%
+ {%
+ \initvalempty
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \note{requires \code{\csfmt{usepackage}\oarg{\opt{index}}\marg{glossaries-extra}}}
+ \desc{the default post-description hook for the \cat{index} category}
+ }
+ % \glsxtrpostdescterm
+ \gcmd{gls\-xtr\-post\-desc\-term}%
+ {%
+ \initvalempty
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{the default post-description hook for the \catfmt{term} category
+ (which isn't used by \sty{glossaries-extra})}
+ }
+ % \glsxtrpostdescacronym
+ \gcmd{gls\-xtr\-post\-desc\-acronym}%
+ {%
+ \initvalempty
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{the default post-description hook for the \cat{acronym} category}
+ }
+ % \glsxtrpostdescabbreviation
+ \gcmd{gls\-xtr\-post\-desc\-ab\-bre\-vi\-a\-tion}%
+ {%
+ \initvalempty
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{the default post-description hook for the \cat{abbreviation} category}
+ }
+ % \glsxtrrestorepostpunc
+ \gcmd{glsxtrrestorepostpunc}
+ {
+ \providedby{\sty{glossaries-extra} v1.23+}
+ \desc{used in the \gloskey{description} to counteract the use of
+ \gls{glsxtrnopostpunc}. Does nothing outside of the \idx{glossary}}
+ }
+ % \glsxtrnopostpunc
+ \gcmd{gls\-xtr\-no\-post\-punc}
+ {%
+ \providedby{\sty{glossaries-extra} v1.22+}
+ \desc{when placed at the end of the \gloskey{description}, this
+ switches off the post-description punctuation (inserted
+ automatically via options such as \opt{postdot}) but doesn't
+ suppress the \idx{postdeschook}. Does nothing outside of the
+ \idx{glossary}}
+ \field{seealso}{nopostdesc}
+ }
+ % \nopostdesc
+ \gcmd{no\-post\-desc}
+ {%
+ \providedby{\sty{glossaries} v1.17+}
+ \desc{when placed at the end of the \gloskey{description}, this
+ switches off the \idx{postdeschook} (including the
+ post-description punctuation). Does nothing outside of the
+ \idx{glossary}}
+ \field{seealso}{glsxtrnopostpunc}
+ }
+ % \glscurrententrylabel
+ \gcmd{gls\-current\-entry\-label}
+ {
+ \providedby{\sty{glossaries} v3.02+}
+ \desc{assigned at the start of each entry item within the
+ glossary. This command may be used by glossary hooks, such
+ as the \idx{postdeschook}, to reference the current entry}
+ }
+ % COMMANDS: longextra
+ % \glslongextraNameFmt
+ \gcmd{gls\-long\-extra\-Name\-Fmt}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \syntax{\margm{entry-label}}
+ \desc{used by the \sty{glossary-longextra} styles to add the
+ hypertarget (if supported) and display a top-level entry's name}
+ }
+ % \glslongextraSubNameFmt
+ \gcmd{gls\-long\-extra\-Sub\-Name\-Fmt}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \syntax{\margm{level}\margm{entry-label}}
+ \desc{used by the \sty{glossary-longextra} styles to add the
+ hypertarget (if supported) for child-entries. The name isn't
+ shown by default}
+ }
+ % \glslongextraDescFmt
+ \gcmd{gls\-long\-extra\-Desc\-Fmt}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \syntax{\margm{entry-label}}
+ \desc{used by the \sty{glossary-longextra} styles to display a
+ top-level entry's description and \idx{postdeschook}}
+ }
+ % \glslongextraSubDescFmt
+ \gcmd{gls\-long\-extra\-Sub\-Desc\-Fmt}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \syntax{\margm{level}\margm{entry-label}}
+ \desc{used by the \sty{glossary-longextra} styles to display a
+ child entry's description and \idx{postdeschook}}
+ }
+ % \glslongextraSymbolFmt
+ \gcmd{gls\-long\-extra\-Symbol\-Fmt}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \syntax{\margm{entry-label}}
+ \desc{used by the \sty{glossary-longextra} styles to display a
+ top-level entry's symbol}
+ }
+ % \glslongextraSubSymbolFmt
+ \gcmd{gls\-long\-extra\-Sub\-Symbol\-Fmt}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \syntax{\margm{level}\margm{entry-label}}
+ \desc{used by the \sty{glossary-longextra} styles to display a
+ child entry's symbol}
+ }
+ % \glslongextraSymbolTargetFmt
+ \gcmd{gls\-long\-extra\-Symbol\-Target\-Fmt}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{adds the hypertarget (if supported) and displays the
+ symbol for top-level entries}
+ }
+ % \glslongextraSubSymbolTargetFmt
+ \gcmd{gls\-long\-extra\-Sub\-Symbol\-Target\-Fmt}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \syntax{\margm{level}\margm{entry-label}}
+ \desc{adds the hypertarget (if supported) and displays the
+ symbol for child entries}
+ }
+ % \glslongextraSymbolOrName
+ \gcmd{gls\-long\-extra\-Symbol\-Or\-Name}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{adds the hypertarget (if supported) and displays the
+ symbol if set or the name otherwise for top-level entries}
+ }
+ % \glslongextraSubSymbolOrName
+ \gcmd{gls\-long\-extra\-Sub\-Symbol\-Or\-Name}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \syntax{\margm{level}\margm{entry-label}}
+ \desc{adds the hypertarget (if supported) and displays the
+ symbol if set or the name otherwise for child entries}
+ }
+ % \glslongextraLocationFmt
+ \gcmd{gls\-long\-extra\-Location\-Fmt}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \syntax{\margm{entry-label}\margm{location list}}
+ \desc{used by the \sty{glossary-longextra} styles to display a
+ top-level entry's \idx{locationlist}}
+ }
+ % \glslongextraSubLocationFmt
+ \gcmd{gls\-long\-extra\-Sub\-Location\-Fmt}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \syntax{\margm{level}\margm{entry-label}\margm{location list}}
+ \desc{used by the \sty{glossary-longextra} styles to display a
+ child entry's \idx{locationlist}}
+ }
+ % \glslongextraHeaderFmt
+ \gcmd{gls\-long\-extra\-Header\-Fmt}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \syntax{\margm{text}}
+ \desc{used to format the column headers}
+ }
+ % \ifGlsLongExtraUseTabular
+ \gcond{if\-Gls\-Long\-Extra\-Use\-Tabular}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \initvalcs{iffalse}
+ \desc{conditional that determines whether or not to use
+ \env{tabular} instead of \env{longtable}. If this conditional is
+ changed, it must be changed before the style is set}
+ }
+ % \GlsLongExtraUseTabulartrue
+ \gcmd{Gls\-Long\-Extra\-Use\-Tabular\-true}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{sets \gls{ifGlsLongExtraUseTabular} to true (if this
+ setting is required, the style must be set after this command)}
+ }
+ % \GlsLongExtraUseTabularfalse
+ \gcmd{Gls\-Long\-Extra\-Use\-Tabular\-false}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{sets \gls{ifGlsLongExtraUseTabular} to false (if this
+ setting is required, the style must be set after this command)}
+ }
+ % \glslongextraTabularVAlign
+ \gcmd{gls\-long\-extra\-Tabular\-V\-Align}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \initval{c}
+ \desc{only for use with the \env{tabular} setting, this should
+ expand to the \env{tabular} environment's vertical alignment
+ specifier}
+ }
+ % \glslongextraNameAlign
+ \gcmd{gls\-long\-extra\-Name\-Align}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \initval{l}
+ \desc{the horizontal alignment for the name column}
+ }
+ % \glslongextraSymbolAlign
+ \gcmd{gls\-long\-extra\-Symbol\-Align}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \initval{c}
+ \desc{the horizontal alignment for the symbol column}
+ }
+ % \glslongextraSymbolNameAlign
+ \gcmd{gls\-long\-extra\-Symbol\-Name\-Align}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \initval{l}
+ \desc{the horizontal alignment for the symbol column when it's
+ being used instead of the name}
+ }
+ % \glslongextraDescAlign
+ \gcmd{gls\-long\-extra\-Desc\-Align}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{the horizontal alignment for the description column}
+ }
+ % \glslongextraLocationAlign
+ \gcmd{gls\-long\-extra\-Location\-Align}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{the horizontal alignment for the \idx{locationlist} column}
+ }
+ % \glslongextraGroupHeading
+ \gcmd{gls\-long\-extra\-Group\-Head\-ing}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \syntax{\margm{number columns}\margm{group-label}}
+ \desc{formats the top-level \idx{group} heading}
+ }
+ % \glslongextraSubGroupHeading
+ \gcmd{gls\-long\-extra\-Sub\-Group\-Head\-ing}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \syntax{\margm{number columns}\margm{prev group
+ level}\margm{group level}\margm{parent-entry-label}\margm{group-label}}
+ \desc{formats the sub-\idx{group} heading, if supported}
+ }
+ % \glslongextraNameDescHeader
+ \gcmd{gls\-long\-extra\-Name\-Desc\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{sets the header and footer for the \glostyle{long-name-desc}
+ style with \env{longtable}}
+ }
+ % \glslongextraNameDescTabularHeader
+ \gcmd{gls\-long\-extra\-Name\-Desc\-Tabular\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the header for the \glostyle{long-name-desc} style}
+ }
+ % \glslongextraNameDescTabularFooter
+ \gcmd{gls\-long\-extra\-Name\-Desc\-Tabular\-Footer}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the footer for the \glostyle{long-name-desc} style}
+ }
+ % \glslongextraNameDescLocationHeader
+ \gcmd{gls\-long\-extra\-Name\-Desc\-Location\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{sets the header and footer for the \glostyle{long-name-desc-loc}
+ style with \env{longtable}}
+ }
+ % \glslongextraNameDescLocationTabularHeader
+ \gcmd{gls\-long\-extra\-Name\-Desc\-Location\-Tabular\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the header for the \glostyle{long-name-desc-loc} style}
+ }
+ % \glslongextraNameDescLocationTabularFooter
+ \gcmd{gls\-long\-extra\-Name\-Desc\-Location\-Tabular\-Footer}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the footer for the \glostyle{long-name-desc-loc} style}
+ }
+ % \glslongextraDescNameHeader
+ \gcmd{gls\-long\-extra\-Desc\-Name\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{sets the header and footer for the \glostyle{long-desc-name}
+ style with \env{longtable}}
+ }
+ % \glslongextraDescNameTabularHeader
+ \gcmd{gls\-long\-extra\-Desc\-Name\-Tabular\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the header for the \glostyle{long-desc-name} style}
+ }
+ % \glslongextraDescNameTabularFooter
+ \gcmd{gls\-long\-extra\-Desc\-Name\-Tabular\-Footer}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the footer for the \glostyle{long-desc-name} style}
+ }
+ % \glslongextraLocationDescNameHeader
+ \gcmd{gls\-long\-extra\-Location\-Desc\-Name\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{sets the header and footer for the \glostyle{long-loc-desc-name}
+ style with \env{longtable}}
+ }
+ % \glslongextraLocationDescNameTabularHeader
+ \gcmd{gls\-long\-extra\-Location\-Desc\-Name\-Tabular\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the header for the \glostyle{long-loc-desc-name} style}
+ }
+ % \glslongextraLocationDescNameTabularFooter
+ \gcmd{gls\-long\-extra\-Location\-Desc\-Name\-Tabular\-Footer}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the footer for the \glostyle{long-loc-desc-name} style}
+ }
+ % \glslongextraNameDescSymHeader
+ \gcmd{gls\-long\-extra\-Name\-Desc\-Sym\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{sets the header and footer for the \glostyle{long-name-desc-sym}
+ style with \env{longtable}}
+ }
+ % \glslongextraNameDescSymTabularHeader
+ \gcmd{gls\-long\-extra\-Name\-Desc\-Sym\-Tabular\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the header for the \glostyle{long-name-desc-sym} style}
+ }
+ % \glslongextraNameDescSymTabularFooter
+ \gcmd{gls\-long\-extra\-Name\-Desc\-Sym\-Tabular\-Footer}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the footer for the \glostyle{long-name-desc-sym} style}
+ }
+ % \glslongextraNameDescSymLocationHeader
+ \gcmd{gls\-long\-extra\-Name\-Desc\-Sym\-Location\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{sets the header and footer for the \glostyle{long-name-desc-sym-loc}
+ style with \env{longtable}}
+ }
+ % \glslongextraNameDescSymLocationTabularHeader
+ \gcmd{gls\-long\-extra\-Name\-Desc\-Sym\-Location\-Tabular\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the header for the \glostyle{long-name-desc-sym-loc} style}
+ }
+ % \glslongextraNameDescSymLocationTabularFooter
+ \gcmd{gls\-long\-extra\-Name\-Desc\-Sym\-Location\-Tabular\-Footer}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the footer for the \glostyle{long-name-desc-sym-loc} style}
+ }
+ % \glslongextraNameSymDescHeader
+ \gcmd{gls\-long\-extra\-Name\-Sym\-Desc\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{sets the header and footer for the \glostyle{long-name-sym-desc}
+ style with \env{longtable}}
+ }
+ % \glslongextraNameSymDescTabularHeader
+ \gcmd{gls\-long\-extra\-Name\-Sym\-Desc\-Tabular\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the header for the \glostyle{long-name-sym-desc} style}
+ }
+ % \glslongextraNameSymDescTabularFooter
+ \gcmd{gls\-long\-extra\-Name\-Sym\-Desc\-Tabular\-Footer}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the footer for the \glostyle{long-name-sym-desc} style}
+ }
+ % \glslongextraNameSymDescLocationHeader
+ \gcmd{gls\-long\-extra\-Name\-Sym\-Desc\-Location\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{sets the header and footer for the \glostyle{long-name-sym-desc-loc}
+ style with \env{longtable}}
+ }
+ % \glslongextraNameSymDescLocationTabularHeader
+ \gcmd{gls\-long\-extra\-Name\-Sym\-Desc\-Location\-Tabular\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the header for the \glostyle{long-name-sym-desc-loc} style}
+ }
+ % \glslongextraNameSymDescLocationTabularFooter
+ \gcmd{gls\-long\-extra\-Name\-Sym\-Desc\-Location\-Tabular\-Footer}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the footer for the \glostyle{long-name-sym-desc-loc} style}
+ }
+ % \glslongextraSymDescNameHeader
+ \gcmd{gls\-long\-extra\-Sym\-Desc\-Name\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{sets the header and footer for the \glostyle{long-sym-desc-name}
+ style with \env{longtable}}
+ }
+ % \glslongextraSymDescNameTabularHeader
+ \gcmd{gls\-long\-extra\-Sym\-Desc\-Name\-Tabular\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the header for the \glostyle{long-sym-desc-name} style}
+ }
+ % \glslongextraSymDescNameTabularFooter
+ \gcmd{gls\-long\-extra\-Sym\-Desc\-Name\-Tabular\-Footer}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the footer for the \glostyle{long-sym-desc-name} style}
+ }
+ % \glslongextraLocationSymDescNameHeader
+ \gcmd{gls\-long\-extra\-Location\-Sym\-Desc\-Name\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{sets the header and footer for the \glostyle{long-loc-sym-desc-name}
+ style with \env{longtable}}
+ }
+ % \glslongextraLocationSymDescNameTabularHeader
+ \gcmd{gls\-long\-extra\-Location\-Sym\-Desc\-Name\-Tabular\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the header for the \glostyle{long-loc-sym-desc-name} style}
+ }
+ % \glslongextraLocationSymDescNameTabularFooter
+ \gcmd{gls\-long\-extra\-Location\-Sym\-Desc\-Name\-Tabular\-Footer}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the footer for the \glostyle{long-loc-sym-desc-name} style}
+ }
+ % \glslongextraDescSymNameHeader
+ \gcmd{gls\-long\-extra\-Desc\-Sym\-Name\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{sets the header and footer for the \glostyle{long-desc-sym-name}
+ style with \env{longtable}}
+ }
+ % \glslongextraDescSymNameTabularHeader
+ \gcmd{gls\-long\-extra\-Desc\-Sym\-Name\-Tabular\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the header for the \glostyle{long-desc-sym-name} style}
+ }
+ % \glslongextraDescSymNameTabularFooter
+ \gcmd{gls\-long\-extra\-Desc\-Sym\-Name\-Tabular\-Footer}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the footer for the \glostyle{long-desc-sym-name} style}
+ }
+ % \glslongextraLocationDescSymNameHeader
+ \gcmd{gls\-long\-extra\-Location\-Desc\-Sym\-Name\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{sets the header and footer for the \glostyle{long-loc-desc-sym-name}
+ style with \env{longtable}}
+ }
+ % \glslongextraLocationDescSymNameTabularHeader
+ \gcmd{gls\-long\-extra\-Location\-Desc\-Sym\-Name\-Tabular\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the header for the \glostyle{long-loc-desc-sym-name} style}
+ }
+ % \glslongextraLocationDescSymNameTabularFooter
+ \gcmd{gls\-long\-extra\-Location\-Desc\-Sym\-Name\-Tabular\-Footer}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{displays the footer for the \glostyle{long-loc-desc-sym-name} style}
+ }
+ % \glslongextraDescSymHeader
+ \gcmd{gls\-long\-extra\-Desc\-Sym\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \desc{sets the header and footer for the \glostyle{long-desc-sym}
+ style with \env{longtable}}
+ }
+ % \glslongextraDescSymTabularHeader
+ \gcmd{gls\-long\-extra\-Desc\-Sym\-Tabular\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \desc{displays the header for the \glostyle{long-desc-sym} style}
+ }
+ % \glslongextraDescSymTabularFooter
+ \gcmd{gls\-long\-extra\-Desc\-Sym\-Tabular\-Footer}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \desc{displays the footer for the \glostyle{long-desc-sym} style}
+ }
+ % \glslongextraSymDescHeader
+ \gcmd{gls\-long\-extra\-Sym\-Desc\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \desc{sets the header and footer for the \glostyle{long-sym-desc}
+ style with \env{longtable}}
+ }
+ % \glslongextraSymDescTabularHeader
+ \gcmd{gls\-long\-extra\-Sym\-Desc\-Tabular\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \desc{displays the header for the \glostyle{long-sym-desc} style}
+ }
+ % \glslongextraSymDescTabularFooter
+ \gcmd{gls\-long\-extra\-Sym\-Desc\-Tabular\-Footer}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \desc{displays the footer for the \glostyle{long-sym-desc} style}
+ }
+ % \glslongextraShortLongTabularHeader
+ \gcmd{gls\-long\-extra\-Short\-Long\-Tabular\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \desc{displays the header for the \glostyle{abbr-short-long} style}
+ }
+ % \glslongextraShortLongTabularFooter
+ \gcmd{gls\-long\-extra\-Short\-Long\-Tabular\-Footer}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \desc{displays the footer for the \glostyle{abbr-short-long} style}
+ }
+ % \glslongextraShortLongHeader
+ \gcmd{gls\-long\-extra\-Short\-Long\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \desc{sets the header and footer for the \glostyle{abbr-short-long}
+ style with \env{longtable}}
+ }
+ % \glslongextraLongShortTabularHeader
+ \gcmd{gls\-long\-extra\-Long\-Short\-Tabular\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \desc{displays the header for the \glostyle{abbr-short-long} style}
+ }
+ % \glslongextraLongShortTabularFooter
+ \gcmd{gls\-long\-extra\-Long\-Short\-Tabular\-Footer}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \desc{displays the footer for the \glostyle{abbr-short-long} style}
+ }
+ % \glslongextraLongShortHeader
+ \gcmd{gls\-long\-extra\-Long\-Short\-Header}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \desc{sets the header and footer for the \glostyle{abbr-short-long}
+ style with \env{longtable}}
+ }
+ % \glslongextraShortNoNameSetDescWidth
+ \gcmd{gls\-long\-extra\-Short\-No\-Name\-Set\-Desc\-Width}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \desc{sets the value of \gls{glsdescwidth} for the
+ \glostyle{abbr-long-short} and \glostyle{abbr-short-long}
+ styles}
+ }
+ % \glslongextraShortHeader
+ \gcmd{gls\-long\-extra\-Short\-Head\-er}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \initvalcs{entryname}
+ \desc{the short column header for the
+ \glostyle{abbr-long-short} and \glostyle{abbr-short-long}
+ styles}
+ }
+ % \glslongextraLongHeader
+ \gcmd{gls\-long\-extra\-Long\-Head\-er}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \initvalcs{descriptionname}
+ \desc{the long column header for the
+ \glostyle{abbr-long-short} and \glostyle{abbr-short-long}
+ styles}
+ }
+ % \glslongextraShortTargetFmt
+ \gcmd{gls\-long\-extra\-Short\-Target\-Fmt}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{the formatting, including the target, for the short form in the
+ \glostyle{abbr-long-short} and \glostyle{abbr-short-long}
+ styles}
+ }
+ % \glslongextraLongFmt
+ \gcmd{gls\-long\-extra\-Long\-Fmt}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{the formatting for the long form in the
+ \glostyle{abbr-long-short} and \glostyle{abbr-short-long}
+ styles}
+ }
+ % \glslongextraSubShortTargetFmt
+ \gcmd{gls\-long\-extra\-Sub\-Short\-Target\-Fmt}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \syntax{\margm{level}\margm{entry-label}}
+ \desc{the formatting, including the target, for child entry short forms in the
+ \glostyle{abbr-long-short} and \glostyle{abbr-short-long}
+ styles}
+ }
+ % \glslongextraSubLongFmt
+ \gcmd{gls\-long\-extra\-Sub\-Long\-Fmt}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \syntax{\margm{level}\margm{entry-label}}
+ \desc{the formatting for child entry long forms in the
+ \glostyle{abbr-long-short} and \glostyle{abbr-short-long}
+ styles}
+ }
+ % \glslongextraSetWidest
+ \gcmd{gls\-long\-extra\-Set\-Widest}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \syntax{\margm{widest-name}}
+ \desc{identifies \meta{widest-name} as the widest top-level name}
+ }
+ % \glslongextraUpdateWidest
+ \gcmd{gls\-long\-extra\-Update\-Widest}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \syntax{\margm{name}}
+ \desc{if \meta{name} is wider than the current widest name, it
+ will be set as the new widest name}
+ }
+ % \glslongextraUpdateWidestChild
+ \gcmd{gls\-long\-extra\-Update\-Widest\-Child}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \syntax{\margm{level}\margm{name}}
+ \desc{as \gls{glslongextraUpdateWidest} but for child entries.
+ Does nothing by default}
+ }
+ % \glslongextraSetDescWidth
+ \gcmd{gls\-long\-extra\-Set\-Desc\-Width}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{computes the value of \gls{glsdescwidth} according to the
+ widest name for styles that only show the name and description}
+ }
+ % \glslongextraSymSetDescWidth
+ \gcmd{gls\-long\-extra\-Sym\-Set\-Desc\-Width}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{computes the value of \gls{glsdescwidth} according to the
+ widest name for styles that only show the name, symbol and description}
+ }
+ % \glslongextraSymNoNameSetDescWidth
+ \gcmd{gls\-long\-extra\-Sym\-No\-Name\-Set\-Desc\-Width}
+ {
+ \providedby{\sty{glossary-longextra} v1.49+}
+ \desc{computes the value of \gls{glsdescwidth} according to the
+ widest name for styles that only show the symbol and description}
+ }
+ % \glslongextraLocSetDescWidth
+ \gcmd{gls\-long\-extra\-Loc\-Set\-Desc\-Width}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{computes the value of \gls{glsdescwidth} according to the
+ widest name for styles that only show the name, \idx{locationlist} and description}
+ }
+ % \glslongextraSymLocSetDescWidth
+ \gcmd{gls\-long\-extra\-Sym\-Loc\-Set\-Desc\-Width}
+ {
+ \providedby{\sty{glossary-longextra} v1.37+}
+ \desc{computes the value of \gls{glsdescwidth} according to the
+ widest name for styles that show the name, symbol, \idx{locationlist} and description}
+ }
+ % COMMANDS: bookindex
+ % \glsxtrbookindexname
+ \gcmd{gls\-xtr\-book\-index\-name}
+ {
+ \providedby{\sty{glossary-bookindex} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{used by the \glostyle{bookindex} style to display a
+ top-level entry's name}
+ }
+ % \glsxtrbookindexsubname
+ \gcmd{gls\-xtr\-book\-index\-sub\-name}
+ {
+ \providedby{\sty{glossary-bookindex} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{used by the \glostyle{bookindex} style to display a
+ child entry's name}
+ }
+ % \glsxtrbookindexpregroupskip
+ \gcmd{gls\-xtr\-book\-index\-pre\-group\-skip}
+ {
+ \providedby{\sty{glossary-bookindex} v1.49+}
+ \syntax{\margm{skip}}
+ \desc{used by the \glostyle{bookindex} style insert \meta{skip}
+ after a \idx{group} header}
+ }
+ % \glsxtrbookindexcols
+ \gcmd{gls\-xtr\-book\-index\-cols}
+ {
+ \providedby{\sty{glossary-bookindex} v1.21+}
+ \initval{2}
+ \desc{expands to the number of columns for the \glostyle{bookindex} style}
+ }
+ % \glsxtrbookindexformatsubheader
+ \gcmd{gls\-xtr\-book\-index\-format\-sub\-header}
+ {
+ \providedby{\sty{glossary-bookindex} v1.49+}
+ \syntax{\margm{previous level}\margm{level}\margm{parent-label}\margm{group-label}\margm{title}}
+ \desc{formats the sub-group header}
+ }
+ % \glsxtrbookindexcolspread
+ \gcmd{gls\-xtr\-book\-index\-col\-spread}
+ {
+ \providedby{\sty{glossary-bookindex} v1.12+}
+ \desc{if not empty this should expand to the option argument for
+ \env{multicols}}
+ }
+ % \glsxtrbookindexmulticolsenv
+ \gcmd{gls\-xtr\-book\-index\-multi\-cols\-env}
+ {
+ \providedby{\sty{glossary-bookindex} v1.25+}
+ \desc{expands to the name of the \env{multicols} environment to use}
+ }
+ % \glsxtrbookindexprelocation
+ \gcmd{gls\-xtr\-book\-index\-pre\-lo\-ca\-tion}
+ {
+ \providedby{\sty{glossary-bookindex} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{used by the \glostyle{bookindex} style to display
+ a separator before top-level \idxpl{locationlist}}
+ }
+ % \glsxtrbookindexsubprelocation
+ \gcmd{gls\-xtr\-book\-index\-sub\-pre\-lo\-ca\-tion}
+ {
+ \providedby{\sty{glossary-bookindex} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{used by the \glostyle{bookindex} style to display
+ a separator before child \idxpl{locationlist}}
+ }
+ % \glsxtrbookindexlocation
+ \gcmd{gls\-xtr\-book\-index\-lo\-ca\-tion}
+ {
+ \providedby{\sty{glossary-bookindex} v1.39+}
+ \syntax{\margm{entry-label}\margm{location list}}
+ \desc{used by the \glostyle{bookindex} style to display
+ top-level \idxpl{locationlist}}
+ }
+ % \glsxtrbookindexsublocation
+ \gcmd{gls\-xtr\-book\-index\-sub\-lo\-ca\-tion}
+ {
+ \providedby{\sty{glossary-bookindex} v1.39+}
+ \syntax{\margm{entry-label}\margm{location list}}
+ \desc{used by the \glostyle{bookindex} style to display
+ child \idxpl{locationlist}}
+ }
+ % \glsxtrbookindexparentchildsep
+ \gcmd{gls\-xtr\-book\-index\-parent\-child\-sep}
+ {
+ \providedby{\sty{glossary-bookindex} v1.21+}
+ \desc{used by the \glostyle{bookindex} style to separate
+ a top-level parent and child entry}
+ }
+ % \glsxtrbookindexparentsubchildsep
+ \gcmd{gls\-xtr\-book\-index\-parent\-sub\-child\-sep}
+ {
+ \providedby{\sty{glossary-bookindex} v1.21+}
+ \desc{used by the \glostyle{bookindex} style to separate
+ a sub-level parent and child entry}
+ }
+ % \glsxtrbookindexbetween
+ \gcmd{gls\-xtr\-book\-index\-between}
+ {
+ \providedby{\sty{glossary-bookindex} v1.21+}
+ \syntax{\margm{entry1-label}\margm{entry2-label}}
+ \desc{used by the \glostyle{bookindex} style between two
+ entries where \meta{entry1-label} is the last top-level entry
+ and \meta{entry2-label} is the next entry, which is a top-level
+ entry}
+ }
+ % \glsxtrbookindexsubbetween
+ \gcmd{gls\-xtr\-book\-index\-sub\-between}
+ {
+ \providedby{\sty{glossary-bookindex} v1.21+}
+ \syntax{\margm{entry1-label}\margm{entry2-label}}
+ \desc{as \gls{glsxtrbookindexbetween} but for level~1 entries}
+ }
+ % \glsxtrbookindexsubsubbetween
+ \gcmd{gls\-xtr\-book\-index\-sub\-sub\-between}
+ {
+ \providedby{\sty{glossary-bookindex} v1.21+}
+ \syntax{\margm{entry1-label}\margm{entry2-label}}
+ \desc{as \gls{glsxtrbookindexbetween} but for level~2 entries}
+ }
+ % \glsxtrbookindexatendgroup
+ \gcmd{gls\-xtr\-book\-index\-at\-end\-group}
+ {
+ \providedby{\sty{glossary-bookindex} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{used by the \glostyle{bookindex} style at the end of a
+ letter group (where the last top-level entry is given by \meta{entry-label})}
+ }
+ % \glsxtrbookindexsubatendgroup
+ \gcmd{gls\-xtr\-book\-index\-sub\-at\-end\-group}
+ {
+ \providedby{\sty{glossary-bookindex} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{used by the \glostyle{bookindex} style at the end of a
+ letter group (where the last level~1 entry is given by \meta{entry-label})}
+ }
+ % \glsxtrbookindexsubsubatendgroup
+ \gcmd{gls\-xtr\-book\-index\-sub\-sub\-at\-end\-group}
+ {
+ \providedby{\sty{glossary-bookindex} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{used by the \glostyle{bookindex} style at the end of a
+ letter group (where the last level~2 entry is given by \meta{entry-label})}
+ }
+ % \glsxtrbookindexbookmark
+ \gcmd{gls\-xtr\-book\-index\-bookmark}
+ {
+ \providedby{\sty{glossary-bookindex} v1.21+}
+ \syntax{\margm{group-title}\margm{bookmark-name}}
+ \desc{adds a bookmark with \gls{pdfbookmark}, if supported}
+ }
+ % \glsxtrbookindexformatheader
+ \gcmd{gls\-xtr\-book\-index\-format\-header}
+ {
+ \providedby{\sty{glossary-bookindex} v1.21+}
+ \syntax{\margm{group-title}}
+ \desc{used by the \glostyle{bookindex} style to format a \idx{group} header}
+ }
+ % \glsxtrbookindexmarkentry
+ \gcmd{gls\-xtr\-book\-index\-mark\-entry}
+ {
+ \providedby{\sty{glossary-bookindex} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{used by the \glostyle{bookindex} style to mark an entry in
+ the \ext{aux} file}
+ }
+ % \glsxtrbookindexfirstmarkfmt
+ \gcmd{gls\-xtr\-book\-index\-first\-mark\-fmt}
+ {
+ \providedby{\sty{glossary-bookindex} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{used by the \glostyle{bookindex} style to format the first mark}
+ }
+ % \glsxtrbookindexfirstmark
+ \gcmd{gls\-xtr\-book\-index\-first\-mark}
+ {
+ \providedby{\sty{glossary-bookindex} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{used by the \glostyle{bookindex} style to obtain the first mark
+ and, if found, format it with \gls{glsxtrbookindexfirstmarkfmt}}
+ }
+ % \glsxtrbookindexlastmarkfmt
+ \gcmd{gls\-xtr\-book\-index\-last\-mark\-fmt}
+ {
+ \providedby{\sty{glossary-bookindex} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{used by the \glostyle{bookindex} style to format the last mark}
+ }
+ % \glsxtrbookindexlastmark
+ \gcmd{gls\-xtr\-book\-index\-last\-mark}
+ {
+ \providedby{\sty{glossary-bookindex} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{used by the \glostyle{bookindex} style to obtain the last mark
+ and, if found, format it with \gls{glsxtrbookindexlastmarkfmt}}
+ }
+ % COMMANDS: topic
+ % \glstopicGroupHeading
+ \gcmd{gls\-topic\-Group\-Heading}
+ {
+ \providedby{\sty{glossary-topic} v1.40+}
+ \syntax{\margm{group-label}}
+ \desc{used to format the top-level group headings, if required}
+ }
+ % \glstopicSubGroupHeading
+ \gcmd{gls\-topic\-Sub\-Group\-Heading}
+ {
+ \providedby{\sty{glossary-topic} v1.49+}
+ \syntax{\margm{prev group level}\margm{group level}\margm{parent entry}\margm{group-label}}
+ \desc{used to format the sub-group headings, if supported}
+ }
+ % \glstopicItem
+ \gcmd{gls\-topic\-Item}
+ {
+ \providedby{\sty{glossary-topic} v1.40+}
+ \syntax{\margm{entry-label}\margm{location list}}
+ \desc{used to format top-level entries}
+ }
+ % \glstopicSubItem
+ \gcmd{gls\-topic\-Sub\-Item}
+ {
+ \providedby{\sty{glossary-topic} v1.40+}
+ \syntax{\margm{level}\margm{entry-label}\margm{location list}}
+ \desc{used to format child entries}
+ }
+ % \glstopicSubItemSep
+ \gcmd{gls\-topic\-Sub\-Item\-Sep}
+ {
+ \providedby{\sty{glossary-topic} v1.40+}
+ \desc{horizontal separator used after child names}
+ }
+ % \glstopicSubItemBox
+ \gcmd{gls\-topic\-Sub\-Item\-Box}
+ {
+ \providedby{\sty{glossary-topic} v1.40+}
+ \syntax{\margm{level}\margm{text}}
+ \desc{horizontal box used for child name if a widest name has
+ been provided}
+ }
+ % \glstopicSubNameFont
+ \gcmd{gls\-topic\-Sub\-Name\-Font}
+ {
+ \providedby{\sty{glossary-topic} v1.40+}
+ \syntax{\margm{text}}
+ \desc{font command to apply to the child entry name}
+ }
+ % \glstopicSubPreLocSep
+ \gcmd{gls\-topic\-Sub\-Pre\-Loc\-Sep}
+ {
+ \providedby{\sty{glossary-topic} v1.41+}
+ \desc{separator before the child \idxpl{locationlist}}
+ }
+ % \glstopicSubLoc
+ \gcmd{gls\-topic\-Sub\-Loc}
+ {
+ \providedby{\sty{glossary-topic} v1.41+}
+ \syntax{\margm{entry-label}\margm{location list}}
+ \desc{formats the child \idxpl{locationlist}}
+ }
+ % \glstopicPreSkip
+ \gcmd{gls\-topic\-Pre\-Skip}
+ {
+ \providedby{\sty{glossary-topic} v1.40+}
+ \desc{vertical space inserted before a top-level entry}
+ }
+ % \glstopicMidSkip
+ \gcmd{gls\-topic\-Mid\-Skip}
+ {
+ \providedby{\sty{glossary-topic} v1.40+}
+ \desc{vertical space inserted before the description for a top-level entry}
+ }
+ % \glstopicPostSkip
+ \gcmd{gls\-topic\-Post\-Skip}
+ {
+ \providedby{\sty{glossary-topic} v1.40+}
+ \desc{vertical space inserted after the description for a top-level entry}
+ }
+ % \glstopicMarker
+ \gcmd{gls\-topic\-Marker}
+ {
+ \providedby{\sty{glossary-topic} v1.40+}
+ \syntax{\margm{entry-label}}
+ \desc{hook inserted before a top-level entry}
+ }
+ % \glstopicTitleFont
+ \gcmd{gls\-topic\-Title\-Font}
+ {
+ \providedby{\sty{glossary-topic} v1.40+}
+ \syntax{\margm{text}}
+ \desc{font command to apply to the top-level entry title}
+ }
+ % \glstopicTitle
+ \gcmd{gls\-topic\-Title}
+ {
+ \providedby{\sty{glossary-topic} v1.40+}
+ \syntax{\margm{entry-label}}
+ \desc{used to format the name and (if provided) symbol for the top-level entry title}
+ }
+ % \glstopicDesc
+ \gcmd{gls\-topic\-Desc}
+ {
+ \providedby{\sty{glossary-topic} v1.40+}
+ \syntax{\margm{entry-label}}
+ \desc{used to format the top-level description}
+ }
+ % \glstopicLoc
+ \gcmd{gls\-topic\-Loc}
+ {
+ \providedby{\sty{glossary-topic} v1.40+}
+ \syntax{\margm{entry-label}\margm{location list}}
+ \desc{used to format the top-level \idx{locationlist}}
+ }
+ % \glstopicParIndent
+ \gcmd{gls\-topic\-Par\-Indent}
+ {
+ \providedby{\sty{glossary-topic} v1.40+}
+ \desc{length register used for the top-level paragraph indent}
+ }
+ % \glstopicSubIndent
+ \gcmd{gls\-topic\-Sub\-Indent}
+ {
+ \providedby{\sty{glossary-topic} v1.40+}
+ \desc{length register used for the child indent}
+ }
+ % \glstopicSubItemParIndent
+ \gcmd{gls\-topic\-Sub\-Item\-Par\-Indent}
+ {
+ \providedby{\sty{glossary-topic} v1.46+}
+ \desc{length register used for the child paragraph indent}
+ }
+ % \glstopicInit
+ \gcmd{gls\-topic\-Init}
+ {
+ \providedby{\sty{glossary-topic} v1.40+}
+ \desc{initialisation hook}
+ }
+ % \glstopicAssignSubIndent
+ \gcmd{gls\-topic\-Assign\-Sub\-Indent}
+ {
+ \providedby{\sty{glossary-topic} v1.40+}
+ \syntax{\margm{level}}
+ \desc{used to set the indentation for sub-levels}
+ }
+ % \glstopicAssignWidest
+ \gcmd{gls\-topic\-Assign\-Widest}
+ {
+ \providedby{\sty{glossary-topic} v1.40+}
+ \syntax{\margm{level}}
+ \desc{used by \gls{glstopicAssignSubIndent} to calculate the
+ width of the widest name for the given level}
+ }
+ % \glstopicCols
+ \gcmd{gls\-topic\-Cols}
+ {
+ \providedby{\sty{glossary-topic} v1.40+}
+ \desc{expands to the number of columns for \glostyle{topicmcols}}
+ }
+ % \glstopicColsEnv
+ \gcmd{gls\-topic\-Cols\-Env}
+ {
+ \providedby{\sty{glossary-topic} v1.40+}
+ \desc{expands to the \env{multicols} environment name to use
+ for \glostyle{topicmcols}}
+ }
+ % COMMANDS: table
+ % \printunsrttable
+ \gcmd{print\-unsrt\-table}
+ {
+ \providedby{\sty{glossary-table} v1.49+}
+ \syntax{\oargm{options}}
+ \desc{internally uses \gls{printunsrtglossary} with the
+ \glostyle{table} style}
+ }
+ % \glstablenameheader
+ \gcmd{gls\-table\-name\-header}
+ {
+ \providedby{\sty{glossary-table} v1.49+}
+ \desc{header for the name column}
+ }
+ % \glstabledescheader
+ \gcmd{gls\-table\-desc\-header}
+ {
+ \providedby{\sty{glossary-table} v1.49+}
+ \desc{header for the description column}
+ }
+ % \glstablesymbolheader
+ \gcmd{gls\-table\-symbol\-header}
+ {
+ \providedby{\sty{glossary-table} v1.49+}
+ \desc{header for the symbol column}
+ }
+ % \glstableotherheader
+ \gcmd{gls\-table\-other\-header}
+ {
+ \providedby{\sty{glossary-table} v1.49+}
+ \desc{header for the other column}
+ }
+ \gprintunsrttableopt{blocks}%
+ {%
+ \syntax{\meta{n}}
+ \initval{2}
+ \desc{number of blocks per row}
+ }
+ \gprintunsrttableopt{header}%
+ {%
+ \syntax{\meta{boolean}}
+ \initval{true}
+ \defval{true}
+ \desc{include header row}
+ }
+ \gprintunsrttableopt{rules}%
+ {%
+ \syntax{\meta{boolean}}
+ \initval{true}
+ \defval{true}
+ \desc{include horizontal rules}
+ }
+ \gprintunsrttableopt{blocksep}%
+ {%
+ \syntax{\meta{alignment spec}}
+ \initval{|}
+ \desc{between block table alignment specifier}
+ }
+ \gprintunsrttableopt{par}%
+ {%
+ \syntax{\meta{value}}
+ \initval{false}
+ \desc{indicates whether or not to use a paragraph column
+specifier}
+ }
+ \gprintunsrttableopt{block-style}%
+ {%
+ \syntax{\meta{value}}
+ \initval{name-desc}
+ \desc{indicates the block style}
+ }
+ \gprintunsrttableopt{other}%
+ {%
+ \syntax{\meta{field-label}}
+ \initvalempty
+ \desc{indicates the other field to use}
+ }
+ \gprintunsrttableopt{init}%
+ {%
+ \syntax{\margm{code}}
+ \initvalempty
+ \desc{initialisation code}
+ }
+ \gtableblockstyle{name\dhyphen desc}{}% name-desc
+ \gtableblockstyle{name}{}
+ \gtableblockstyle{name\dhyphen symbol}{}% name-symbol
+ \gtableblockstyle{desc\dhyphen name}{}% desc-name
+ \gtableblockstyle{symbol\dhyphen name}{}% symbol-name
+ \gtableblockstyle{name\dhyphen symbol\dhyphen desc}{}% name-symbol-desc
+ \gtableblockstyle{name\dhyphen desc\dhyphen symbol}{}% name-desc-symbol
+ \gtableblockstyle{name\dhyphen other}{}% name-other
+ \gtableblockstyle{symbol\dhyphen other}{}% symbol-other
+ \gtableblockstyle{other\dhyphen name}{}% other-name
+ \gtableblockstyle{other\dhyphen symbol}{}% other-symbol
+ % \glstableiffilter
+ \gcmd{gls\-table\-if\-filter}
+ {
+ \providedby{\sty{glossary-table} v1.49+}
+ \syntax{\margm{entry-label}\margm{true}\margm{false}}
+ \desc{internally used by the custom handler in \gls{printunsrttable}
+ to perform additional filtering}
+ }
+ % COMMANDS: long
+ % \glsdescwidth
+ \gcmd{gls\-desc\-width}
+ {
+ \providedby{\sty{glossary-long} \& \sty{glossary-super}}
+ \desc{a length register used to set the width of the description
+ column for \env{tabular}-like styles}
+ }
+ % \glspagelistwidth
+ \gcmd{gls\-page\-list\-width}
+ {
+ \providedby{\sty{glossary-long} \& \sty{glossary-super}}
+ \desc{a length register used to set the width of the
+ \idx{locationlist} column for \env{tabular}-like styles}
+ }
+ % COMMANDS: tree
+ % \glstreepredesc
+ \gcmd{gls\-tree\-pre\-desc}
+ {
+ \providedby{\sty{glossary-tree} v4.26+}
+ \desc{space inserted before top-level descriptions}
+ }
+ % \glstreechildpredesc
+ \gcmd{gls\-tree\-child\-pre\-desc}
+ {
+ \providedby{\sty{glossary-tree} v4.26+}
+ \desc{space inserted before child descriptions}
+ }
+ % \glstreenamefmt
+ \gcmd{gls\-tree\-name\-fmt}
+ {
+ \providedby{\sty{glossary-tree} v4.08+}
+ \syntax{\margm{text}}
+ \desc{used to format the name for the \glostyle{tree} and
+ \glostyle{index} styles}
+ }
+ % \glstreegroupheaderfmt
+ \gcmd{gls\-tree\-group\-header\-fmt}
+ {
+ \providedby{\sty{glossary-tree} v4.22+}
+ \syntax{\margm{text}}
+ \desc{used to format the \idx{group} title for the \glostyle{treegroup} and
+ \glostyle{indexgroup} styles}
+ }
+ % \glstreenavigationfmt
+ \gcmd{gls\-tree\-navigation\-fmt}
+ {
+ \providedby{\sty{glossary-tree} v4.22+}
+ \syntax{\margm{text}}
+ \desc{used to format the navigation element for styles like \glostyle{treehypergroup}}
+ }
+ % \glstreeitem
+ \gcmd{gls\-tree\-item}
+ {
+ \providedby{\sty{glossary-tree} v4.26+}
+ \desc{used to indent the top-level entries for the \glostyle{index} styles}
+ }
+ % \glstreesubitem
+ \gcmd{gls\-tree\-sub\-item}
+ {
+ \providedby{\sty{glossary-tree} v4.26+}
+ \desc{used to indent the level~1 entries for the \glostyle{index} styles}
+ }
+ % \glstreesubsubitem
+ \gcmd{gls\-tree\-sub\-sub\-item}
+ {
+ \providedby{\sty{glossary-tree} v4.26+}
+ \desc{used to indent the level~2 entries for the \glostyle{index} styles}
+ }
+ % COMMANDS: list style
+ % \glslistdottedwidth
+ \gcmd{glslistdottedwidth}
+ {
+ \providedby{\sty{glossary-list}}
+ \desc{a length register used by \glostyle{listdotted}}
+ }
+ % \glslistinit
+ \gcmd{gls\-list\-init}
+ {%
+ \providedby{\sty{glossary-list} v4.48+}
+ \desc{used to disable problematic commands at the start the
+ \glostyle{list} styles to provide better integration with
+ \sty{gettitlestring}}
+ }
+ % \glslistexpandedname
+ \gcmd{gls\-list\-expanded\-name}
+ {%
+ \providedby{\sty{glossary-list} v4.48+}
+ \syntax{\margm{entry-label}}
+ \desc{used by \gls{glslistinit} to provide better integration with
+ \sty{gettitlestring}}
+ }
+ % COMMANDS: inline style
+ % \glsinlinedescformat
+ \gcmd{gls\-in\-line\-desc\-format}
+ {
+ \providedby{\sty{glossary-inline} v3.03+}
+ \syntax{\margm{description}\margm{symbol}\margm{location list}}
+ \desc{formats the description, symbol and \idx{locationlist} for
+ top-level entries}
+ }
+ % \glsinlinesubdescformat
+ \gcmd{gls\-in\-line\-sub\-desc\-format}
+ {
+ \providedby{\sty{glossary-inline} v3.03+}
+ \syntax{\margm{description}\margm{symbol}\margm{location list}}
+ \desc{formats the description, symbol and \idx{locationlist} for
+ child entries}
+ }
+ % \glspostinline
+ \gcmd{gls\-post\-in\-line}
+ {%
+ \providedby{\sty{glossary-inline} v3.03+}
+ \desc{used at the end of the \env{theglossary} environment}
+ }
+ % \glspostinlinedescformat
+ \gcmd{gls\-post\-in\-line\-desc\-format}
+ {%
+ \providedby{\sty{glossary-inline} v3.03+}
+ \syntax{\margm{description}\margm{symbol}\margm{location list}}
+ \desc{formats the top-level entry's description, symbol and \idx{locationlist}}
+ }
+ % \glspostinlinesubdescformat
+ \gcmd{gls\-post\-in\-line\-sub\-desc\-format}
+ {%
+ \providedby{\sty{glossary-inline} v3.03+}
+ \syntax{\margm{description}\margm{symbol}\margm{location list}}
+ \desc{formats the child entry's description, symbol and \idx{locationlist}}
+ }
+ % COMMANDS: STYLE MODIFICATIONS
+ % \glsxtrprelocation
+ \gcmd{gls\-xtr\-pre\-location}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.21+}
+ \initvalcs{space}
+ \desc{used before the \idx{locationlist} in the predefined
+ styles provided by \sty{glossaries-extra} or modified by
+ \sty{glossaries-extra-stylemods}}
+ }
+ % \glslistprelocation
+ \gcmd{gls\-list\-pre\-location}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.21+}
+ \initvalcs{glsxtrprelocation}
+ \desc{used before the top-level entry \idx{locationlist}
+ for the \glostyle{list} styles}
+ }
+ % \glslistchildprelocation
+ \gcmd{gls\-list\-child\-pre\-location}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.21+}
+ \initvalcs{glslistprelocation}
+ \desc{used before the child entry \idx{locationlist}
+ for the \glostyle{list} styles}
+ }
+ % \glslistchildpostlocation
+ \gcmd{gls\-list\-child\-post\-location}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.21+}
+ \initval{.}
+ \desc{used after the child entry \idx{locationlist}
+ for the \glostyle{list} styles}
+ }
+ % \glslistdesc
+ \gcmd{gls\-list\-desc}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.31+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the description for the \glostyle{list} styles}
+ }
+ % \glslistgroupskip
+ \gcmd{gls\-list\-group\-skip}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.31+}
+ \desc{used for the group skip in the \glostyle{list} styles}
+ }
+ % \glslistitem
+ \gcmd{gls\-list\-item}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.47+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the top-level entry item in the \glostyle{list} styles}
+ }
+ % \glsaltlistitem
+ \gcmd{gls\-alt\-list\-item}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.47+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the top-level entry item in the \glostyle{altlist} styles}
+ }
+ % \glslistgroupheaderitem
+ \gcmd{gls\-list\-group\-header\-item}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.47+}
+ \syntax{\margm{group-label}\margm{header code}}
+ \desc{used to display the \idx{group} headings in the \glostyle{listgroup} styles}
+ }
+ % \glslistgroupafterheader
+ \gcmd{gls\-list\-group\-after\-header}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.47+}
+ \desc{used after \idx{group} headings in the \glostyle{listgroup} styles}
+ }
+ % \glstreedefaultnamefmt
+ \gcmd{gls\-tree\-default\-name\-fmt}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.31+}
+ \syntax{\margm{text}}
+ \desc{used as the default name format for the \glostyle{tree}
+ and \glostyle{index} styles}
+ }
+ % \glstreePreHeader
+ \gcmd{gls\-tree\-Pre\-Header}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.41+}
+ \syntax{\margm{group-label}\margm{group-title}}
+ \desc{pre \idx{group} header hook the \glostyle{treegroup}
+ and \glostyle{indexgroup} styles}
+ }
+ % \glstreeSubPreHeader
+ \gcmd{gls\-tree\-Sub\-Pre\-Header}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.49+}
+ \syntax{\margm{previous group level}\margm{level}\margm{parent label}\margm{group label}\margm{group title}}
+ \desc{pre sub-\idx{group} header hook the \glostyle{treegroup}
+ and \glostyle{indexgroup} styles}
+ }
+ % \glstreeprelocation
+ \gcmd{gls\-tree\-pre\-location}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.21+}
+ \initvalcs{glsxtrprelocation}
+ \desc{used before the top-level entry \idx{locationlist}
+ for the \glostyle{tree} and \glostyle{index} styles}
+ }
+ % \glstreechildprelocation
+ \gcmd{gls\-tree\-child\-pre\-location}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.21+}
+ \initvalcs{glstreeprelocation}
+ \desc{used before the child entry \idx{locationlist}
+ for the \glostyle{tree} and \glostyle{index} styles}
+ }
+ % \glstreegroupskip
+ \gcmd{gls\-tree\-group\-skip}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.41+}
+ \desc{group skip for the \glostyle{tree} and \glostyle{index} styles}
+ }
+ % \glstreegroupheaderskip
+ \gcmd{gls\-tree\-group\-header\-skip}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.42+}
+ \desc{after group header skip for the \glostyle{treegroup} and
+ \glostyle{indexgroup} styles}
+ }
+ % \glsindexsubgroupitem
+ \gcmd{gls\-index\-sub\-group\-item}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.49+}
+ \syntax{\margm{previous group level}\margm{level}\margm{parent
+label}\margm{group label}\margm{group title}}
+ \desc{used to format sub-\idx{group} headers for the
+ \glostyle{indexgroup} styles}
+ }
+ % \glsxtrtreepredesc
+ \gcmd{gls\-xtr\-tree\-pre\-desc}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.46+}
+ \initvalcs{glstreepredesc}
+ \desc{inserted before the top-level descriptions for the \glostyle{tree} styles}
+ }
+ % \glsxtrtreechildpredesc
+ \gcmd{gls\-xtr\-tree\-child\-pre\-desc}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.46+}
+ \initvalcs{glstreechildpredesc}
+ \desc{inserted before the child descriptions for the \glostyle{tree} styles}
+ }
+ % \glstreedesc
+ \gcmd{gls\-tree\-desc}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.31+}
+ \syntax{\margm{entry-label}}
+ \desc{displays the given top-level entry's description with pre and post hooks for the \glostyle{tree} styles}
+ }
+ % \glstreechilddesc
+ \gcmd{gls\-tree\-child\-desc}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.31+}
+ \syntax{\margm{entry-label}}
+ \desc{displays the given child entry's description with pre and post hooks for the \glostyle{tree} styles}
+ }
+ % \glstreeDescLoc
+ \gcmd{gls\-tree\-Desc\-Loc}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.41+}
+ \syntax{\margm{entry-label}\margm{location list}}
+ \desc{formats the top-level description (if set) and \idx{locationlist} for the \glostyle{tree} styles}
+ }
+ % \glstreeChildDescLoc
+ \gcmd{gls\-tree\-Child\-Desc\-Loc}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.41+}
+ \syntax{\margm{entry-label}\margm{location list}}
+ \desc{formats the child description (if set) and \idx{locationlist} for the \glostyle{tree} styles}
+ }
+ % \glstreeNoDescSymbolPreLocation
+ \gcmd{gls\-tree\-No\-Desc\-Symbol\-Pre\-Location}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.42+}
+ \desc{inserted before the \idx{locationlist} when there's no
+ description or symbol for the \glostyle{tree} styles}
+ }
+ % \glstreesymbol
+ \gcmd{gls\-tree\-symbol}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.31+}
+ \syntax{\margm{entry-label}}
+ \desc{displays the top-level symbol in parentheses, if set, for the \glostyle{tree} styles}
+ }
+ % \glstreechildsymbol
+ \gcmd{gls\-tree\-child\-symbol}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.31+}
+ \syntax{\margm{entry-label}}
+ \desc{displays the top-level symbol in parentheses, if set, for the \glostyle{tree} styles}
+ }
+ % \glstreesubgroupitem
+ \gcmd{gls\-tree\-sub\-group\-item}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.49+}
+ \syntax{\marg{previous group level}\marg{level}\marg{parent label}\marg{group label}\marg{group title}}
+ \desc{used to display the sub-group header in the \glostyle{treegroup} styles}
+ }
+ % \glstreenonamedesc
+ \gcmd{gls\-tree\-no\-name\-desc}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.31+}
+ \syntax{\margm{entry-label}}
+ \desc{displays the given top-level entry's description with pre
+ and post hooks for the \glostyle{treenoname} styles}
+ }
+ % \glstreenonamesymbol
+ \gcmd{gls\-tree\-no\-name\-symbol}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.31+}
+ \syntax{\margm{entry-label}}
+ \desc{displays the given top-level entry's symbol in parentheses for
+ the \glostyle{treenoname} styles}
+ }
+ % \glstreenonameDescLoc
+ \gcmd{gls\-tree\-no\-name\-Desc\-Loc}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.45+}
+ \syntax{\margm{entry-label}}
+ \desc{displays the given top-level entry's description and
+ \idx{locationlist} for the \glostyle{treenoname} styles}
+ }
+ % \glstreenonamechilddesc
+ \gcmd{gls\-tree\-no\-name\-child\-desc}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.31+}
+ \syntax{\margm{entry-label}}
+ \desc{displays the given child entry's description and
+ post hook for the \glostyle{treenoname} styles}
+ }
+ % \glstreenonameChildDescLoc
+ \gcmd{gls\-tree\-no\-name\-Child\-Desc\-Loc}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.45+}
+ \syntax{\margm{entry-label}}
+ \desc{displays the given child entry's description and
+ \idx{locationlist} for the \glostyle{treenoname} styles}
+ }
+ % \glsalttreepredesc
+ \gcmd{gls\-alt\-tree\-pre\-desc}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.46+}
+ \desc{inserted before the top-level descriptions for the \glostyle{alttree} styles}
+ }
+ % \glsalttreechildpredesc
+ \gcmd{gls\-alt\-tree\-child\-pre\-desc}
+ {%
+ \providedby{\sty{glossaries-extra-stylemods} v1.46+}
+ \desc{inserted before the child descriptions for the \glostyle{alttree} styles}
+ }
+ % \glssetwidest
+ \gcmd{gls\-set\-widest}
+ {
+ \providedby{\sty{glossary-tree}}
+ \syntax{\oargm{level}\margm{name}}
+ \desc{indicates that \meta{name} is the widest name for the
+ given \idx{hierarchicallevel}}
+ }
+ % \gglssetwidest
+ \gcmd{ggls\-set\-widest}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.21+}
+ \syntax{\oargm{level}\margm{name}}
+ \desc{as \gls{glssetwidest} but global}
+ }
+ % \eglssetwidest
+ \gcmd{egls\-set\-widest}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.05+}
+ \syntax{\oargm{level}\margm{name}}
+ \desc{as \gls{glssetwidest} but expands \meta{text}}
+ }
+ % \xglssetwidest
+ \gcmd{xgls\-set\-widest}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.05+}
+ \syntax{\oargm{level}\margm{name}}
+ \desc{as \gls{eglssetwidest} but global}
+ }
+ % \glsupdatewidest
+ \gcmd{gls\-update\-widest}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.23+}
+ \syntax{\oargm{level}\margm{name}}
+ \desc{similar to \gls{glssetwidest} but only if \meta{name} is
+ wider than the current widest value for the given
+ \idx{hierarchicallevel}}
+ }
+ % \gglsupdatewidest
+ \gcmd{ggls\-update\-widest}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.23+}
+ \syntax{\oargm{level}\margm{name}}
+ \desc{as \gls{glsupdatewidest} but global}
+ }
+ % \eglsupdatewidest
+ \gcmd{egls\-update\-widest}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.23+}
+ \syntax{\oargm{level}\margm{name}}
+ \desc{as \gls{glsupdatewidest} but expands \meta{name}}
+ }
+ % \xglsupdatewidest
+ \gcmd{xgls\-update\-widest}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.23+}
+ \syntax{\oargm{level}\margm{name}}
+ \desc{as \gls{eglsupdatewidest} but global}
+ }
+ % \glsgetwidestname
+ \gcmd{gls\-get\-widest\-name}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.05+}
+ \desc{expands to the widest top-level name}
+ }
+ % \glsgetwidestsubname
+ \gcmd{gls\-get\-widest\-sub\-name}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.05+}
+ \syntax{\margm{level}}
+ \desc{expands to the widest name for the given
+ \idx{hierarchicallevel} or to the widest top-level name, if no
+ widest name set for \meta{level}}
+ }
+ % \glsfindwidesttoplevelname
+ \gcmd{gls\-find\-widest\-top\-level\-name}
+ {
+ \providedby{\sty{glossary-tree} v4.22+}
+ \syntax{\oargm{glossary labels}}
+ \desc{finds and sets the widest name for all top-level entries
+ in the given \idxpl{glossary}. If the optional argument is
+ omitted, the list of all non-\idxpl{ignoredglossary} is assumed}
+ }
+ % \glsFindWidestTopLevelName
+ \gcmd{gls\-Find\-Widest\-Top\-Level\-Name}
+ {
+ \providedby{\sty{glossaries-extra-stylemods}}% v1.0+
+ \desc{a synonym for \gls{glsfindwidesttoplevelname}}
+ }
+ % \glsFindWidestUsedTopLevelName
+ \gcmd{gls\-Find\-Widest\-Used\-Top\-Level\-Name}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.05+}
+ \syntax{\oargm{glossary labels}}
+ \desc{finds and sets the widest name for all top-level entries
+ that have been marked as \idxc{firstuseflag}{used} in the given \idxpl{glossary}}
+ }
+ % \glsFindWidestUsedAnyName
+ \gcmd{gls\-Find\-Widest\-Used\-Any\-Name}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.05+}
+ \syntax{\oargm{glossary labels}}
+ \desc{finds and sets the widest name for all entries
+ that have been marked as \idxc{firstuseflag}{used} in the given \idxpl{glossary}}
+ }
+ % \glsFindWidestAnyName
+ \gcmd{gls\-Find\-Widest\-Any\-Name}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.05+}
+ \syntax{\oargm{glossary labels}}
+ \desc{finds and sets the widest name for all entries
+ in the given \idxpl{glossary}}
+ }
+ % \glsFindWidestUsedLevelTwo
+ \gcmd{gls\-Find\-Widest\-Used\-Level\-Two}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.05+}
+ \syntax{\oargm{glossary labels}}
+ \desc{finds and sets the widest name for all entries
+ that have been marked as \idxc{firstuseflag}{used} with
+ \idx{hierarchicallevel} less than or equal to 2 in the given \idxpl{glossary}}
+ }
+ % \glsFindWidestLevelTwo
+ \gcmd{gls\-Find\-Widest\-Level\-Two}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.05+}
+ \syntax{\oargm{glossary labels}}
+ \desc{finds and sets the widest name for all entries with
+ \idx{hierarchicallevel} less than or equal to 2 in the given \idxpl{glossary}}
+ }
+ % \glsFindWidestUsedAnyNameSymbol
+ \gcmd{gls\-Find\-Widest\-Used\-Any\-Name\-Symbol}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.05+}
+ \syntax{\oargm{glossary labels}\margm{register}}
+ \desc{like \gls{glsFindWidestUsedAnyName} but also also measures the
+ symbol. The length of the widest symbol is stored in
+ \meta{register} which should be a length register}
+ }
+ % \glsFindWidestAnyNameSymbol
+ \gcmd{gls\-Find\-Widest\-Any\-Name\-Symbol}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.05+}
+ \syntax{\oargm{glossary labels}\margm{register}}
+ \desc{like \gls{glsFindWidestAnyName} but also also measures the
+ symbol. The length of the widest symbol is stored in
+ \meta{register} which should be a length register}
+ }
+ % \glsFindWidestUsedAnyNameSymbolLocation
+ \gcmd{gls\-Find\-Widest\-Used\-Any\-Name\-Symbol\-Location}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.05+}
+ \syntax{\oargm{glossary labels}\margm{register1}\margm{register2}}
+ \desc{like \gls{glsFindWidestUsedAnyNameSymbol} but also also measures the
+ \idx{locationlist}. The length of the widest symbol is stored in
+ \meta{register1} and the length of the widest location is
+ stored in \meta{register2}, which should both be length registers}
+ }
+ % \glsFindWidestAnyNameSymbolLocation
+ \gcmd{gls\-Find\-Widest\-Any\-Name\-Symbol\-Location}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.05+}
+ \syntax{\oargm{glossary labels}\margm{register1}\margm{register2}}
+ \desc{like \gls{glsFindWidestAnyNameSymbol} but also also measures the
+ \idx{locationlist}. The length of the widest symbol is stored in
+ \meta{register1} and the length of the widest location is
+ stored in \meta{register2}, which should both be length registers}
+ }
+ % \glsFindWidestUsedAnyNameLocation
+ \gcmd{gls\-Find\-Widest\-Used\-Any\-Name\-Location}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.05+}
+ \syntax{\oargm{glossary labels}\margm{register}}
+ \desc{like \gls{glsFindWidestUsedAnyName} but also also measures the
+ \idx{locationlist}. The length of the widest location is
+ stored in \meta{register}, which should be a length register}
+ }
+ % \glsFindWidestAnyNameLocation
+ \gcmd{gls\-Find\-Widest\-Any\-Name\-Location}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.05+}
+ \syntax{\oargm{glossary labels}\margm{register}}
+ \desc{like \gls{glsFindWidestAnyName} but also also measures the
+ \idx{locationlist}. The length of the widest location is
+ stored in \meta{register}, which should be a length register}
+ }
+ % \glsxtralttreeSymbolDescLocation
+ \gcmd{gls\-xtr\-alt\-tree\-Symbol\-Desc\-Location}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.05+}
+ \syntax{\margm{entry-label}\margm{location list}}
+ \desc{formats the symbol, description and location for top-level entries
+ for the \glostyle{alttree}-like styles}
+ }
+ % \glsxtralttreeSubSymbolDescLocation
+ \gcmd{gls\-xtr\-alt\-tree\-Sub\-Symbol\-Desc\-Location}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.05+}
+ \syntax{\margm{entry-label}\margm{location list}}
+ \desc{formats the symbol, description and location for child entries
+ for the \glostyle{alttree}-like styles}
+ }
+ % \glsxtralttreeInit
+ \gcmd{gls\-xtr\-alt\-tree\-Init}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.05+}
+ \desc{initialisation code performed by the \glostyle{alttree}-like styles}
+ }
+ % \glsxtrAltTreeIndent
+ \gcmd{gls\-xtr\-Alt\-Tree\-Indent}
+ {
+ \providedby{\sty{glossaries-extra-stylemods} v1.05+}
+ \desc{length register for the subsequent paragraph indentation for
+ the \glostyle{alttree}-like styles}
+ }
+ % COMMANDS: DISPLAYING GLOSSARIES
+ % \glossarysection
+ \gcmd{glossary\-section}
+ {
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{toc-title}\margm{title}}
+ \desc{occurs at the start of a \idx{glossary} (except with
+ \gls{printunsrtinnerglossary}). This will typically be defined
+ to use a sectioning command, such as \gls{section} or
+ \gls{chapter}. The default definition follows the \opt{section}
+ and \opt{numberedsection} options}
+ }
+ % \glossarytitle
+ \gcmd{glossary\-title}
+ {
+ \providedby{\sty{glossaries}}
+ \desc{initialised by the \csfmt{print\ldots glossary} set of
+ commands (such as \gls{printglossary}) to the current
+ \idx{glossary}['s] title}
+ }
+ % \glossarytoctitle
+ \gcmd{glossary\-toc\-title}
+ {
+ \providedby{\sty{glossaries}}
+ \desc{initialised by the \csfmt{print\ldots glossary} set of
+ commands (such as \gls{printglossary}) to the current
+ \idx{glossary}['s] table of contents title}
+ }
+ % \glossaryheader
+ \gcmd{glossary\-header}
+ {
+ \providedby{\sty{glossaries}}
+ \desc{inserted after \code{\cbeg{\env{theglossary}}}. This
+ command should be redefined by the \idx{glossarystyle}}
+ }
+ % \glossentry
+ \gcmd{gloss\-entry}
+ {
+ \providedby{\sty{glossaries} v3.08+}
+ \syntax{\margm{entry label}\margm{location list}}
+ \desc{used to format a top-level entry. This
+ command should be redefined by the \idx{glossarystyle}}
+ }
+ % \subglossentry
+ \gcmd{sub\-gloss\-entry}
+ {
+ \providedby{\sty{glossaries} v3.08+}
+ \syntax{\margm{level}\margm{entry label}\margm{location list}}
+ \desc{used to format a child entry. This
+ command should be redefined by the \idx{glossarystyle}}
+ }
+ % \glsresetentrylist
+ \gcmd{gls\-reset\-entry\-list}
+ {
+ \providedby{\sty{glossaries}}
+ \desc{inserted into the \idx{glossary} code to counteract the
+ effect of \gls{glsnonextpages}}
+ }
+ % \glsnonextpages
+ \gcmd{gls\-no\-next\-pages}
+ {
+ \providedby{\sty{glossaries} v1.17+}
+ \desc{designed for use with \app{makeindex} and \app{xindy},
+ this may be placed in an entry's description to suppress the
+ entry's \idx{locationlist}}
+ }
+ % \glsnextpages
+ \gcmd{gls\-next\-pages}
+ {
+ \providedby{\sty{glossaries} v3.0+}
+ \desc{designed for use with \app{makeindex} and \app{xindy},
+ this may be placed in an entry's description to override
+ \opt{nonumberlist}}
+ }
+ % \glsgroupskip
+ \gcmd{gls\-group\-skip}
+ {
+ \providedby{\sty{glossaries}}
+ \desc{inserted before each \idx{group} heading (except the
+ first) in a \idx{glossary} (unless \printglossoptval{groups}{false}).
+ This command is defined by \idxpl{glossarystyle} as appropriate.
+ Most of the predefined styles define this command to check the
+ \opt{nogroupskip} option}
+ }
+ % \glsgroupheading
+ \gcmd{gls\-group\-head\-ing}%
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{group-label}}
+ \desc{inserted at the start of each \idx{group} in a \idx{glossary}
+ (unless \printglossoptval{groups}{false}) to display the
+ \idx{group}['s] heading, if applicable, using the title
+ associated with \meta{group-label} or, if no title provided,
+ just \meta{group-label}.
+ This command is defined by \idxpl{glossarystyle} as appropriate}
+ }
+ % \glssubgroupheading
+ \gcmd{gls\-sub\-group\-head\-ing}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{previous level}\margm{level}\margm{parent-label}\margm{group-label}}
+ \desc{used to format sub-\idx{group} headings. Only applicable
+ with the \idx{unsrtfam}. This command won't occur in
+ \idxpl{glossary} that use \gls{printglossary} or
+ \gls{printnoidxglossary}}
+ }
+ % \glossarypostamble
+ \gcmd{glossary\-postamble}%
+ {%
+ \providedby{\sty{glossaries}}
+ \desc{used at the end of the \idx{glossary}}
+ }
+ % \glossarypreamble
+ \gcmd{glossary\-preamble}%
+ {%
+ \providedby{\sty{glossaries}}
+ \desc{used at the start of the \idx{glossary}. This will be
+ locally redefined to the preamble associated with
+ the current glossary, if one has been set}
+ \field{seealso}{setglossarypreamble}
+ }
+ % \setglossarypreamble
+ \gcmd{set\-glossary\-preamble}%
+ {%
+ \providedby{\sty{glossaries} v3.07+}
+ \syntax{\oargm{type}\margm{text}}
+ \desc{globally sets the preamble for the glossary identified by
+ \meta{type} to \meta{text}. If \meta{type} is omitted,
+ \gls{glsdefaulttype} is assumed}
+ }
+ % \apptoglossarypreamble
+ \gcmd{app\-to\-glossary\-preamble}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\oargm{type}\margm{text}}
+ \desc{appends (locally) \meta{text} to the preamble for the glossary identified by
+ \meta{type}. If \meta{type} is omitted,
+ \gls{glsdefaulttype} is assumed}
+ }
+ % \pretoglossarypreamble
+ \gcmd{pre\-to\-glossary\-preamble}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\oargm{type}\margm{text}}
+ \desc{prepends (locally) \meta{text} to the preamble for the glossary identified by
+ \meta{type}. If \meta{type} is omitted,
+ \gls{glsdefaulttype} is assumed}
+ }
+ % \printglossaries
+ \gcmd{print\-glossaries}%
+ {%
+ \providedby{\sty{glossaries}}
+ \desc{iterates over all non-\idxpl{ignoredglossary} and does
+ \code{\gls{printglossary}\oarg{\printglossoptval{type}{\meta{type}}}}
+ for each \idx{glossary}}
+ }
+ % \printnoidxglossaries
+ \gcmd{print\-noidx\-glossaries}%
+ {%
+ \providedby{\sty{glossaries} v4.04+}
+ \desc{iterates over all non-\idxpl{ignoredglossary} and does
+ \code{\gls{printnoidxglossary}\oarg{\printglossoptval{type}{\meta{type}}}}
+ for each \idx{glossary}}
+ }
+ % \printunsrtglossaries
+ \gcmd{print\-unsrt\-glossaries}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.08+}
+ \desc{iterates over all non-\idxpl{ignoredglossary} and does
+ \code{\gls{printunsrtglossary}\oarg{\printglossoptval{type}{\meta{type}}}}
+ for each \idx{glossary}}
+ }
+ % \printglossary
+ \gcmd{print\-glossary}%
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}}
+ \desc{displays the \idx{glossary} by inputting a file created by
+ \app+{makeindex} or \app+{xindy}. Must be used with
+ \gls{makeglossaries} and either \app{makeindex} or \app{xindy}}
+ }%
+ % \printacronyms
+ \gcmd{print\-acronyms}%
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}}
+ \note{requires the \opt{acronyms} package option}
+ \desc{shortcut for
+ \code{\gls{printglossary}\oarg{\printglossoptval{type}{\gls{acronymtype}}}}}
+ }%
+ % \printunsrtacronyms
+ \gcmd{print\-unsrt\-acronyms}%
+ {%
+ \providedby{\sty{glossaries-extra-bib2gls} v1.40+}
+ \syntax{\oargm{options}}
+ \note{requires \code{\csfmt{usepackage}\oarg{\opt{acronyms},\opt{record}}\marg{glossaries-extra}}}
+ \desc{shortcut for
+ \code{\gls{printunsrtglossary}\oarg{\printglossoptval{type}{\gls{acronymtype}}}}}
+ }%
+ % \printabbreviations
+ \gcmd{print\-ab\-bre\-vi\-a\-tions}%
+ {%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{options}}
+ \note{requires \code{\csfmt{usepackage}\oarg{\opt{abbreviations}}\marg{glossaries-extra}}}
+ \desc{shortcut for
+ \code{\gls{printglossary}\oarg{\printglossoptval{type}{\gls{glsxtrabbrvtype}}}}}
+ }%
+ % \printunsrtabbreviations
+ \gcmd{print\-unsrt\-ab\-bre\-vi\-a\-tions}%
+ {%
+ \providedby{\sty{glossaries-extra-bib2gls} v1.40+}
+ \syntax{\oargm{options}}
+ \note{requires \code{\csfmt{usepackage}\oarg{\opt{abbreviations},\opt{record}}\marg{glossaries-extra}}}
+ \desc{shortcut for
+ \code{\gls{printunsrtglossary}\oarg{\printglossoptval{type}{\gls{glsxtrabbrvtype}}}}}
+ }%
+ % \printsymbols
+ \gcmd{print\-symbols}%
+ {%
+ \providedby{\sty{glossaries} v4.02+}
+ \syntax{\oargm{options}}
+ \note{requires the \opt{symbols} package option}
+ \desc{shortcut for
+ \code{\gls{printglossary}\oarg{\printglossoptval{type}{symbols}}}}
+ }%
+ % \printunsrtsymbols
+ \gcmd{print\-unsrt\-symbols}%
+ {%
+ \providedby{\sty{glossaries-extra-bib2gls} v1.40+}
+ \syntax{\oargm{options}}
+ \note{requires \code{\csfmt{usepackage}\oarg{\opt{symbols},\opt{record}}\marg{glossaries-extra}}}
+ \desc{shortcut for
+ \code{\gls{printunsrtglossary}\oarg{\printglossoptval{type}{symbols}}}}
+ }%
+ % \printnumbers
+ \gcmd{print\-numbers}%
+ {%
+ \providedby{\sty{glossaries} v4.02+}
+ \syntax{\oargm{options}}
+ \note{requires the \opt{numbers} package option}
+ \desc{shortcut for
+ \code{\gls{printglossary}\oarg{\printglossoptval{type}{numbers}}}}
+ }%
+ % \printunsrtnumbers
+ \gcmd{print\-unsrt\-numbers}%
+ {%
+ \providedby{\sty{glossaries-extra-bib2gls} v1.40+}
+ \syntax{\oargm{options}}
+ \note{requires \code{\csfmt{usepackage}\oarg{\opt{numbers},\opt{record}}\marg{glossaries-extra}}}
+ \desc{shortcut provided by the \opt{numbers} package option combined
+ with \sty{glossaries-extra-bib2gls} that simply does
+ \code{\gls{printunsrtglossary}\oarg{\printglossoptval{type}{numbers}}}}
+ }%
+ % \printindex
+ \gcmd{print\-index}%
+ {%
+ \syntax{\oargm{options} v4.02+}
+ \note{requires the \opt{index} package option}
+ \desc{shortcut provided by the \opt{index} package option that simply does
+ \code{\gls{printglossary}\oarg{\printglossoptval{type}{index}}}}
+ }%
+ % \printunsrtindex
+ \gcmd{print\-unsrt\-index}%
+ {%
+ \providedby{\sty{glossaries-extra-bib2gls} v1.40+}
+ \syntax{\oargm{options}}
+ \note{requires \code{\csfmt{usepackage}\oarg{\opt{index},\opt{record}}\marg{glossaries-extra}}}
+ \desc{shortcut provided by the \opt{index} package option combined
+ with \sty{glossaries-extra-bib2gls} that simply does
+ \code{\gls{printunsrtglossary}\oarg{\printglossoptval{type}{index}}}}
+ }%
+ % \printnoidxglossary
+ \gcmd{print\-noidx\-glossary}%
+ {%
+ \providedby{\sty{glossaries} v4.04+}
+ \syntax{\oargm{options}}
+ \desc{displays the \idx{glossary} by obtaining the \idx{indexing} information from
+ the \ext+{aux} file and using \TeX\ to sort and collate. Must be used with
+ \gls{makenoidxglossaries} or with the \idxpl{glossary} not identified
+ in the optional argument of \gls{makeglossaries} when using the
+ hybrid method. This method can be very slow and has limitations}
+ }%
+ % \printunsrtglossary
+ \gcmd{print\-unsrt\-glossary}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.08+}
+ \syntax{\oargm{options}}
+ \desc{displays the \idx{glossary} by iterating over all entries
+ associated with the given \idx{glossary} (in the order in which they
+ were added to the \idx{glossary}). \Idx{group} headers will only be
+ inserted if the \gloskey{group} key has been defined and has
+ been set (typically with the \opt{record} option and
+ \app{bib2gls}). \Idxpl{locationlist} will only be shown if the
+ \gloskey{location} or \glosfield{loclist} fields have been set
+ (typically by \app{bib2gls})}
+ }%
+ % \printunsrtglossary*
+ \gcmd{print\-unsrt\-glossary*}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\oargm{options}\margm{init-code}}
+ \desc{does \code{\marg{\meta{init-code}\gls{printunsrtglossary}\oargm{options}}}
+ which localises \meta{init-code}}
+ }
+ % \printunsrtglossaryunit
+ \gcmd{print\-unsrt\-glossary\-unit}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\oargm{options}\margm{counter-name}}
+ \desc{provided for use with \gls{GlsXtrRecordCounter} to display
+ a glossary with \gls{printunsrtglossary*} that filters entries that
+ don't have a match for the current \meta{counter-name} value}
+ }
+ % \printunsrtglossaryunitsetup
+ \gcmd{print\-unsrt\-glossary\-unit\-set\-up}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{counter-name}}
+ \desc{sets up the filtering used by \gls{printunsrtglossaryunit}}
+ }
+ % \printunsrtglossaryunitpostskip
+ \gcmd{print\-unsrt\-glossary\-unit\-post\-skip}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{the vertical space at the end of the \idx{glossary} appended
+ by \gls{printunsrtglossaryunit}}
+ }
+ % \printunsrtinnerglossary
+ \gcmd{print\-unsrt\-inner\-glossary}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.44+}
+ \syntax{\oargm{options}\margm{pre-code}\margm{post-code}}
+ \desc{similar to \gls{printunsrtglossary} but doesn't contain
+ the code that starts and ends the \idx{glossary} (such as
+ beginning and ending the \env{theglossary} environment), so
+ this command needs to be
+ either placed inside \env{printunsrtglossarywrap} or in the
+ \gls{printunsrtglossary} entry handler \gls{printunsrtglossaryhandler}}
+ }%
+ % \glsxtrnoidxgroups
+ \gcmd{gls\-xtr\-no\-idx\-groups}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{makes the group titling mechanism used with the
+ \idx{unsrtfam} use the same method as for
+ \gls{printnoidxglossary} (\idx{ascii} only). This command can't
+ be used with \gls{makeglossaries} or with \opt{record}}
+ }
+ % \printunsrtglossaryentryprocesshook
+ \gcmd{print\-unsrt\-glossary\-entry\-process\-hook}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{hook used within the \idx{unsrtfam} while the
+ \idx{glossary} is being constructed}
+ }
+ % \printunsrtglossaryskipentry
+ \gcmd{print\-unsrt\-glossary\-skip\-entry}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \desc{may be used within
+ \gls{printunsrtglossaryentryprocesshook} to skip the current entry}
+ }
+ % \glscurrenttoplevelentry
+ \gcmd{gls\-current\-top\-level\-entry}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{may be used within
+ \gls{printunsrtglossaryentryprocesshook} to reference the most
+recent top level entry label (allowing for \printglossopt{flatten} and \printglossopt{leveloffset})}
+ }
+ % \glscurrentrootentry
+ \gcmd{gls\-current\-root\-entry}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{may be used within
+ \gls{printunsrtglossaryentryprocesshook} to reference the most
+recent top level entry label (allowing for \printglossopt{flatten}
+but not \printglossopt{leveloffset})}
+ }
+ % \currentglossary
+ \gcmd{current\-glossary}
+ {
+ \providedby{\sty{glossaries} v3.0+}
+ \desc{defined by the \csfmt{print\ldots glossary} commands to
+ the current \idx{glossary} label}
+ }
+ % \printunsrtglossarypredoglossary
+ \gcmd{print\-unsrt\-glossary\-pre\-do\-glossary}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \desc{hook performed by the \idx{unsrtfam} just before the
+ \idx{glossary} body is displayed}
+ }
+ % \@glsxtr@doglossary
+ \gcmd{@gls\-xtr\-@do\-glossary}
+ {
+ \providedby{\sty{glossaries-extra} v1.08+}
+ \desc{internal command used within the construction of the
+ \idx{glossary} code by the \idx{unsrtfam}. Should not be used
+ or modified but \gls{printunsrtglossarypredoglossary} can be
+ defined to show the definition of this command for debugging
+ purposes}
+ }
+ % \printunsrtglossaryhandler
+ \gcmd{print\-unsrt\-glossary\-handler}
+ {
+ \providedby{\sty{glossaries-extra} v1.16+}
+ \syntax{\margm{entry-label}}
+ \desc{used within the \idx{unsrtfam} to process the current entry}
+ }
+ % \glsxtrunsrtdo
+ \gcmd{gls\-xtr\-unsrt\-do}%
+ {%
+ \syntax{\margm{entry-label}}
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \desc{used by the \idx{unsrtfam},
+ this displays the \idx{glossary} entry according to the current
+ \idx{glossarystyle} (taking the \idx{hierarchicallevel} into account,
+ which may have been adjusted by \printglossopt{leveloffset} or
+ \printglossopt{flatten})}
+ }
+ % \GlsXtrLocationField
+ \gcmd{Gls\-Xtr\-Location\-Field}
+ {
+ \providedby{\sty{glossaries-extra} v1.37+}
+ \initval{location}
+ \desc{expands to the \idx{internalfieldlabel} used to obtain the
+ formatted \idx{locationlist} for the \idx{unsrtfam}}
+ }
+ % \glsxtriflabelinlist
+ \gcmd{gls\-xtr\-if\-label\-in\-list}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{label}\margm{label-list}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the given label is in the given comma-separated
+ list of labels, otherwise does \meta{false}. The label and list are fully
+ expanded}
+ }
+ % prinunsrtglossarywrap environment
+ \genv{print\-unsrt\-glossary\-wrap}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.44+}
+ \syntax{\oargm{options}}
+ \desc{sets up the start and end of the \idx{glossary} (including
+ beginning and ending the \env{theglossary} environment). Use
+ \gls{printunsrtinnerglossary} within the body for each block of
+ entries}
+ }%
+ % print*glossary options
+ \gidx{printglossopt}{\name{print [unsrt|noidx] glossary options}%
+ \field{text}{print glossary option}%
+ \desc{most (but not all) of these options can be used in the optional argument
+ of all the print \idx{glossary} commands: \gls{printglossary}, \gls{printnoidxglossary},
+ \gls{printunsrtglossary} and \gls{printunsrtinnerglossary}.
+ Some may be used in the optional argument of
+ the \env{printunsrtglossarywrap} environment}
+ }
+ % printgloss type
+ \gprintglossopt{type}{%
+ \syntax{\meta{\idx{glossary}-label}}
+ \defval{\gls{glsdefaulttype}}%
+ \desc{identifies the \idx{glossary} to display}}
+ % printgloss sort
+ \gprintglossopt{sort}{%
+ \syntax{\meta{method}}
+ \desc{only available with \gls{printnoidxglossary}, this
+ indicates how the \idx{glossary} should be ordered}}
+ % printgloss title
+ \gprintglossopt{title}{%
+ \syntax{\meta{text}}
+ \desc{sets the glossary title (overriding the default)}}
+ % printgloss toctitle
+ \gprintglossopt{toc\-title}{%
+ \syntax{\meta{text}}
+ \desc{sets the glossary toc title (overriding the default)}}
+ % printgloss target
+ \gprintglossopt{target}{%
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\meta{boolean}}
+ \initval{true}%
+ \defval{true}%
+ \desc{if true, each entry in the \idx{glossary} should have a
+ hypertarget created, if supported by the \idx{glossarystyle} and if
+ hyperlinks are enabled}
+ }
+ % printgloss targetnameprefix
+ \gprintglossopt{target\-name\-prefix}{%
+ \providedby{\sty{glossaries-extra} v1.20+}
+ \syntax{\meta{prefix}}
+ \desc{inserts \meta{prefix} at the start of the hypertarget names}}
+ % printgloss prefix
+ \gprintglossopt{prefix}{%
+ \providedby{\sty{glossaries-extra} v1.31+}
+ \syntax{\meta{prefix}}
+ \desc{redefines \gls{glolinkprefix} to \meta{prefix}}}
+ % printgloss label
+ \gprintglossopt{label}{%
+ \providedby{\sty{glossaries-extra} v1.39+}
+ \syntax{\meta{label}}
+ \desc{adds \code{\gls{label}\margm{label}} to the start of the
+ \idx{glossary} (after the title)}}
+ % printgloss preamble
+ \gprintglossopt{preamble}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\meta{text}}
+ \desc{redefines \gls{glossarypreamble} to \meta{text}}
+ }
+ % printgloss postamble
+ \gprintglossopt{postamble}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\meta{text}}
+ \desc{redefines \gls{glossarypostamble} to \meta{text}}
+ }
+ % printgloss nonumberlist
+ \gprintglossopt{no\-number\-list}{%
+ \syntax{\meta{boolean}}
+ \initval{false}%
+ \defval{true}%
+ \desc{suppress the \gls{locationlist}. Note that
+ \printglossoptval{nonumberlist}{false}
+ will have no effect with the \resourceopt{save-locations}{false}
+ \idx{resourceopt} as there won't be any \glspl{locationlist} to
+ display}
+ }
+ % printgloss nogroupskip
+ \gprintglossopt{no\-group\-skip}{%
+ \syntax{\meta{boolean}}
+ \initval{false}%
+ \defval{true}%
+ \desc{suppress the gap implemented by some \idxpl{glossarystyle}
+ between \idxpl{group}}
+ }
+ % printgloss numberedsection
+ \gprintglossopt{numbered\-section}{%
+ \syntax{\meta{value}}
+ \initval{false}%
+ \defval{nolabel}%
+ \desc{indicates whether or not \idx{glossary} section headers will be numbered
+ and also if they should automatically be labelled.
+ The \opt{numberedsection} package option will change the default
+ setting to match}
+ }
+ % printgloss style
+ \gprintglossopt{style}{%
+ \syntax{\meta{style-name}}
+ \desc{use the \meta{style-name} \idx{glossarystyle}}
+ }
+ % printgloss leveloffset
+ \gprintglossopt{level\-offset}{%
+ \providedby{\sty{glossaries-extra} v1.44+}
+ \syntax{\meta{offset}}
+ \initval{0}%
+ \desc{set or increment the \gls{hierarchicallevel} offset. If
+ \meta{offset} starts with \code{++} then the current offset is
+ incremented by the given amount otherwise the current offset is
+ set to \meta{offset}. For example, an entry with a normal
+ \gls{hierarchicallevel} of 1 will be treated as though it has
+ \gls{hierarchicallevel} $1+\meta{offset}$. This option is only available for the
+ \idx{unsrtfam} and the \env{printunsrtglossarywrap}
+ environment}%
+ }
+ % printgloss groups
+ \gprintglossopt{groups}{%
+ \providedby{\sty{glossaries-extra} v1.44+}
+ \syntax{\meta{boolean}}
+ \initval{true}%
+ \defval{true}%
+ \desc{enables \idx{group} formation. This option is only available for the
+ \idx{unsrtfam} and the \env{printunsrtglossarywrap}
+ environment. Note that no \idxpl{group} will be formed when
+ invoking \app{bib2gls} with the default \switch{no-group}, regardless of
+ this setting}
+ }
+ % printgloss flatten
+ \gprintglossopt{flatten}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\meta{boolean}}
+ \initval{false}%
+ \defval{true}%
+ \desc{if true, treats all entries as though they have the same
+ hierarchical level (the value of \printglossopt{leveloffset}).
+ This option is only available for the
+ \idx{unsrtfam} and the \env{printunsrtglossarywrap}
+ environment}
+ }
+ % printgloss nopostdot
+ \gprintglossopt{no\-post\-dot}{%
+ \syntax{\meta{boolean}}
+ \initval{false}%
+ \defval{true}%
+ \desc{suppress the post-description punctuation}
+ }
+ % printgloss entrycounter
+ \gprintglossopt{entry\-counter}{%
+ \providedby{\sty{glossaries} v4.08+}
+ \syntax{\meta{boolean}}
+ \initval{false}%
+ \defval{true}%
+ \desc{if true, enable the entry counter}
+ }
+ % printgloss subentrycounter
+ \gprintglossopt{sub\-entry\-counter}{%
+ \providedby{\sty{glossaries} v4.08+}
+ \syntax{\meta{boolean}}
+ \initval{false}%
+ \defval{true}%
+ \desc{if true, enable the sub-entry counter}
+ }
+ % \ifglsxtrprintglossflatten
+ \gcond{if\-gls\-xtr\-print\-gloss\-flatten}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \initvalcs{iffalse}
+ \desc{conditional set by the \printglossopt{flatten} option}
+ }
+ % \glsxtraddgroup
+ \gcmd{gls\-xtr\-add\-group}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{code}}
+ \desc{used by the \idx{unsrtfam} to perform \meta{code} if the
+ entry identified by \meta{entry-label} should have support for
+ \idxpl{group}}
+ }
+ % \glscurrententrylevel
+ \gcmd{gls\-current\-entry\-level}
+ {
+ \providedby{\sty{glossaries-extra} v1.44+}
+ \desc{defined within the \idx{unsrtfam} to the current
+ \idx{hierarchicallevel} (taking \printglossopt{leveloffset} into
+ account)}
+ }
+ % \glsxtrsetgrouptitle
+ \gcmd{gls\-xtr\-set\-group\-title}
+ {
+ \providedby{\sty{glossaries-extra} v1.14+}
+ \syntax{\margm{group-label}\margm{group-title}}
+ \desc{globally assigns the given title \meta{group-title} to the
+ \idx{group} identified by \meta{group-label}}
+ }
+ % \glsxtrlocalsetgrouptitle
+ \gcmd{gls\-xtr\-local\-set\-group\-title}
+ {
+ \providedby{\sty{glossaries-extra} v1.24+}
+ \syntax{\margm{group-label}\margm{group-title}}
+ \desc{locally assigns the given title \meta{group-title} to the
+ \idx{group} identified by \meta{group-label}}
+ }
+ % \glsxtrgetgrouptitle
+ \gcmd{gls\-xtr\-get\-group\-title}
+ {
+ \providedby{\sty{glossaries-extra} v1.14+}
+ \syntax{\margm{group-label}\margm{cs}}
+ \desc{obtains the title corresponding to the \idx{group}
+ identified by \meta{group-label} and stores the result in the
+ control sequence \meta{cs}}
+ }
+ % \glsxtrdetoklocation
+ \gcmd{gls\-xtr\-de\-tok\-location}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{location}}
+ \desc{just expands to \meta{location} by default but may be
+ redefined to help protect awkward characters}
+ }
+ % \glsdisplaynumberlist
+ \gcmd{gls\-display\-number\-list}
+ {
+ \providedby{\sty{glossaries} v3.02+}
+ \syntax{\margm{entry-label}}
+ \desc{formats the \idx{locationlist} for the given entry.
+ Redefined by \sty{glossaries-extra-bib2gls} to obtain the
+ \idx{locationlist} from the \gloskey{location} field}
+ }
+ % \glsentrynumberlist
+ \gcmd{gls\-entry\-number\-list}
+ {
+ \providedby{\sty{glossaries} v3.02+}
+ \syntax{\margm{entry-label}}
+ \desc{displays the \idx{locationlist} for the given entry.
+ Redefined by \sty{glossaries-extra-bib2gls} to obtain the
+ \idx{locationlist} from the \gloskey{location} field}
+ }
+ % COMMANDS: STANDALONE
+ % \glsxtrglossentry
+ \gcmd{gls\-xtr\-gloss\-entry}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{used for standalone entries to display the name with
+ \gls{glossentryname}, with appropriate hooks}
+ }
+ % \GlsXtrStandaloneGlossaryType
+ \gcmd{Gls\-Xtr\-Stand\-alone\-Glossary\-Type}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \desc{expands to the \idx{glossary} type for standalone entries}
+ }
+ % \GlsXtrStandaloneSubEntryItem
+ \gcmd{Gls\-Xtr\-Stand\-alone\-Sub\-Entry\-Item}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display standalone entries that have the
+ \gloskey{parent} field set}
+ }
+ % \GlsXtrStandaloneEntryName
+ \gcmd{Gls\-Xtr\-Stand\-alone\-Entry\-Name}
+ {
+ \providedby{\sty{glossaries-extra} v1.37+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the standalone entry name and create the
+ associated hypertarget, if supported}
+ }
+ % \GlsXtrStandaloneEntryPdfName
+ \gcmd{Gls\-Xtr\-Stand\-alone\-Entry\-Pdf\-Name}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{used by \gls{glsxtrglossentry} for the PDF bookmark}
+ }
+ % \GlsXtrStandaloneEntryHeadName
+ \gcmd{Gls\-Xtr\-Stand\-alone\-Entry\-Head\-Name}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{used by \gls{glsxtrglossentry} for the header and toc}
+ }
+ % \GlsXtrStandaloneEntryOther
+ \gcmd{Gls\-Xtr\-Stand\-alone\-Entry\-Other}
+ {
+ \providedby{\sty{glossaries-extra} v1.37+}
+ \syntax{\margm{entry-label}\margm{field-label}}
+ \desc{as \gls{GlsXtrStandaloneEntryName} but where the text is
+ obtained from the given field instead of \gloskey{name}}
+ }
+ % \GlsXtrStandaloneEntryPdfOther
+ \gcmd{Gls\-Xtr\-Stand\-alone\-Entry\-Pdf\-Other}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{field-label}}
+ \desc{used by \gls{glsxtrglossentryother} for the PDF bookmark}
+ }
+ % \GlsXtrStandaloneEntryHeadOther
+ \gcmd{Gls\-Xtr\-Stand\-alone\-Entry\-Head\-Other}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{field-label}}
+ \desc{used by \gls{glsxtrglossentryother} for the header and toc}
+ }
+ % \glsxtractivatenopost
+ \gcmd{gls\-xtr\-activate\-no\-post}
+ {
+ \providedby{\sty{glossaries-extra} v1.22+}
+ \desc{activates \gls{nopostdesc} and \gls{glsxtrnopostpunc}}
+ }
+ % \glsxtrglossentryother
+ \gcmd{gls\-xtr\-gloss\-entry\-other}
+ {
+ \providedby{\sty{glossaries-extra} v1.22+}
+ \syntax{\margm{header}\margm{entry-label}\margm{field-label}}
+ \desc{like \gls{glsxtrglossentry} but uses the given field
+ instead of \gloskey{name}}
+ }
+ % COMMANDS: DEFINING ENTRIES
+ % \glsnoexpandfields
+ \gcmd{gls\-no\-expand\-fields}
+ {
+ \providedby{\sty{glossaries} v3.08a+}
+ \desc{don't expand field values when defining entries, except
+ for those that explicitly have expansion enabled with
+ \gls{glssetexpandfield}}
+ }
+ % \glsexpandfields
+ \gcmd{gls\-expand\-fields}
+ {
+ \providedby{\sty{glossaries} v3.08a+}
+ \desc{expand field values when defining entries, except
+ for those that explicitly have expansion disabled with
+ \gls{glssetnoexpandfield}}
+ }
+ % \glssetnoexpandfield
+ \gcmd{gls\-set\-no\-expand\-field}
+ {
+ \providedby{\sty{glossaries} v3.13a+}
+ \syntax{\margm{field}}
+ \desc{don't expand the value of the field identified by its
+ \idx{internalfieldlabel} when defining entries (overrides \gls{glsexpandfields})}
+ }
+ % \glssetexpandfield
+ \gcmd{gls\-set\-expand\-field}
+ {
+ \providedby{\sty{glossaries} v3.13a+}
+ \syntax{\margm{field}}
+ \desc{expand the value of the field identified by its
+ \idx{internalfieldlabel} when defining entries (overrides \gls{glsnoexpandfields})}
+ }
+ % \ifglsentryexists
+ \gcmd{if\-gls\-entry\-exists}
+ {
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the entry given by \meta{entry-label}
+ exists, otherwise does \meta{false}}
+ \field{seealso}{glsdoifexistsordo,glsdoifexists,glsdoifnoexists}
+ }
+ % \glsdoifexistsordo
+ \gcmd{gls\-do\-if\-exists\-or\-do}
+ {
+ \providedby{\sty{glossaries} v4.19+}
+ \syntax{\margm{entry-label}\margm{true}\margm{false}}
+ \desc{similar to \gls{ifglsentryexists}, this does \meta{true} if the entry
+ given by \meta{entry-label}
+ exists. If the entry doesn't it exist, this does \meta{false}
+ and generates an error (\opteqvalref{undefaction}{error}) or a warning
+ (\opteqvalref{undefaction}{warn}). The unknown marker
+ \idx{unknowntag} will be placed before the \meta{false} code}
+ \field{seealso}{ifglsentryexists,glsdoifexists,glsdoifnoexists}
+ }
+ % \glsdoifexists
+ \gcmd{gls\-do\-if\-exists}
+ {
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}\margm{code}}
+ \desc{does \meta{code} if the entry given by \meta{entry-label}
+ exists. If the entry doesn't exist, this will either generate
+ an error (\opteqvalref{undefaction}{error}) or a warning
+ (\opteqvalref{undefaction}{warn}) and, within the document
+ environment, it will insert the unknown marker \idx{unknowntag}}
+ \field{seealso}{ifglsentryexists,glsdoifexistsordo,glsdoifnoexists}
+ }
+ % \glsdoifexistsorwarn
+ \gcmd{gls\-do\-if\-exists\-or\-warn}
+ {
+ \providedby{\sty{glossaries} v4.03+}
+ \syntax{\margm{entry-label}\margm{code}}
+ \desc{like \gls{glsdoifexists}, but always warns (no error) if
+ the entry doesn't exist, regardless of the \opt{undefaction}
+ setting, and doesn't show the unknown marker}
+ }
+ % \glsdoifnoexists
+ \gcmd{gls\-do\-if\-no\-exists}
+ {
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}\margm{code}}
+ \desc{does \meta{code} if the entry given by \meta{entry-label}
+ does not exist. If the entry does exist, this will either generate
+ an error (\opteqvalref{undefaction}{error}) or a warning
+ (\opteqvalref{undefaction}{warn})}
+ \field{seealso}{ifglsentryexists,glsdoifexistsordo,glsdoifexists}
+ }
+ % \loadglsentries
+ \gcmd{load\-gls\-entries}
+ {
+ \providedby{\sty{glossaries}}%
+ \syntax{\oargm{type}\margm{filename}}
+ \desc{locally assigns \gls{glsdefaulttype} to \meta{type} and
+ inputs \meta{filename}. If the optional argument is omitted,
+ the default glossary is assumed. Note that if any entries with
+ \meta{filename} have the \gloskey{type} key set (including
+ implicitly in commands like \gls{newabbreviation}), then this will
+ override the type given in the optional argument}
+ }
+ % \newglossaryentry
+ \gcmd{new\-glossary\-entry}%
+ {%
+ \providedby{\sty{glossaries}}%
+ \syntax{\margm{entry-label}\margm{key=value list}}
+ \desc{defines a new \idx{glossary} entry with the given label. The
+ second argument is a comma-separated list of \idxpl{gloskey}}
+ }
+ % \longnewglossaryentry
+ \gcmd{long\-new\-glossary\-entry}%
+ {%
+ \providedby{\sty{glossaries} v3.11a}%
+ \syntax{\margm{entry-label}\margm{key=value list}\margm{description}}
+ \desc{defines a new \idx{glossary} entry with the given label. The
+ second argument is a comma-separated list of \idxpl{gloskey}.
+ The third argument is the description, which may include
+ paragraph breaks}
+ }
+ % \longnewglossaryentry*
+ \gcmd{long\-new\-glossary\-entry*}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{key=value list}\margm{description}}
+ \desc{like the unstarred \gls{longnewglossaryentry} but doesn't
+ add the \gls{glsxtrpostlongdescription} hook}
+ }%
+ % \glsxtrpostlongdescription
+ \gcmd{gls\-xtr\-post\-long\-descrip\-tion}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \desc{hook added to the end of the \gloskey{description} field
+ by the unstarred version of \gls{longnewglossaryentry}}
+ }%
+ % \newterm
+ \gcmd{new\-term}%
+ {%
+ \providedby{\sty{glossaries} v4.02+}
+ \syntax{\oargm{key=value list}\margm{entry-label}}
+ \note{requires \opt{index} package option}
+ \desc{defines a new \idx{glossary} entry with the given label,
+ \gloskey{type} set to \code{index}, the \gloskey{name}
+ set to \meta{entry-label} and the \gloskey{description}
+ set to \gls{nopostdesc}. The
+ optional argument is a comma-separated list of \idxpl{gloskey},
+ which can be used to override the defaults}
+ }
+ % \glsxtrnewsymbol
+ \gcmd{gls\-xtr\-new\-symbol}%
+ {%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{key=value list}\margm{entry-label}\margm{sym}}
+ \note{requires \code{\csfmt{usepackage}\oarg{\opt{symbols}}\marg{glossaries-extra}}}
+ \desc{defines a new \idx{glossary} entry with the given label,
+ \gloskey{type} set to \code{symbols}, the \gloskey{category} set
+ to \code{symbol}, the \gloskey{name} set to \meta{sym} and the \gloskey{sort}
+ set to \meta{entry-label}. The optional argument is a comma-separated list of \idxpl{gloskey},
+ which can be used to override the defaults}
+ }
+ % \glsxtrnewnumber
+ \gcmd{gls\-xtr\-new\-number}%
+ {%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{key=value list}\margm{entry-label}\margm{num}}
+ \note{requires \code{\csfmt{usepackage}\oarg{\opt{numbers}}\marg{glossaries-extra}}}
+ \desc{defines a new \idx{glossary} entry with the given label,
+ \gloskey{type} set to \code{numbers}, the \gloskey{category} set
+ to \code{number}, the \gloskey{name} set to \meta{num} and the \gloskey{sort}
+ set to \meta{entry-label}. The optional argument is a comma-separated list of \idxpl{gloskey},
+ which can be used to override the defaults}
+ }
+ % \newentry
+ \gcmd{new\-entry}%
+ {%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{entry-label}\margm{options}}
+ \desc{a synonym for \gls{newglossaryentry} defined by the
+ \opteqvalref{shortcuts}{other} package option}
+ }
+ % \newsym
+ \gcmd{new\-sym}%
+ {%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{key=value list}\margm{entry-label}\margm{sym}}
+ \desc{a synonym for \gls{glsxtrnewsymbol} defined by the
+ \opteqvalref{shortcuts}{other} package option (provided
+ the \opt{symbols} option is also used)}
+ }
+ % \newnum
+ \gcmd{new\-num}%
+ {%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{key=value list}\margm{entry-label}\margm{num}}
+ \desc{a synonym for \gls{glsxtrnewnumber} defined by the
+ \opteqvalref{shortcuts}{other} package option (provided
+ the \opt{numbers} option is also used)}
+ }
+ % \newabbr
+ \gcmd{new\-abbr}%
+ {%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{options}\margm{entry-label}\margm{short}\margm{long}}
+ \desc{a synonym for \gls{newabbreviation} defined by the
+ \opteqvalref{shortcuts}{abbreviations} or
+ \opteqvalref{shortcuts}{ac} package option}
+ }
+ % \glsaddkey
+ \gcmd{gls\-add\-key}
+ {
+ \providedby{\sty{glossaries} v3.12a}
+ \syntax{\margm{key}\margm{default value}\margm{no link cs}\margm{no link ucfirst
+ cs}\margm{link cs}\margm{link ucfirst cs}\margm{link allcaps cs}}
+ \desc{defines a new \idx{gloskey} with the given default value
+ and commands that are analogous to \gls{glsentrytext} (\meta{no
+ link cs}), \gls{Glsentrytext} (\meta{no link ucfirst cs}),
+ \gls{glstext} (\meta{link cs}), \gls{Glstext} (\meta{link ucfirst cs}),
+ \gls{GLStext} (\meta{link allcaps cs}). The starred version switches on field
+ expansion for the given key}
+ \field{seealso}{glsaddstoragekey,glsxtrprovidestoragekey}
+ }
+ % \glsaddstoragekey
+ \gcmd{gls\-add\-storage\-key}
+ {%
+ \providedby{\sty{glossaries} v4.16}
+ \syntax{\margm{key}\margm{default value}\margm{no link cs}}
+ \desc{provides a new \idx{gloskey} with a default value and a
+ command for simply accessing the value (without indexing
+ or hyperlinks). The starred version switches on field
+ expansion for the given key}
+ \field{seealso}{glsaddkey,glsxtrprovidestoragekey}
+ }
+ % \glsxtrprovidestoragekey
+ \gcmds{gls\-xtr\-provide\-storage\-key}
+ {%
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{key}\margm{default value}\margm{no link cs}}
+ \desc{like \gls{glsaddstoragekey} but does nothing if the key
+ has already been defined}
+ }
+ % \glsxtrifkeydefined
+ \gcmd{gls\-xtr\-if\-key\-defined}
+ {%
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{key}\margm{true}\margm{false}}
+ \desc{tests if the given \meta{key} has been defined as a
+ \idx{gloskey}. Does \meta{true} if the key has been defined,
+ otherwise does false}
+ }
+ % \newglossaryentry (glossentry) keys
+ \gidxpl{gloskey}{%
+ \common
+ \field{text}{glossary entry key}
+ \desc{these are options that can be passed to commands that
+ define entries, such as \gls{newglossaryentry} or
+ \gls{newabbreviation}}
+ }
+ % glossentry name
+ \ggloskey{name}%
+ {%
+ \syntax{\margm{text}}
+ \desc{the entry's name, as displayed in the \idx{glossary}. This
+ typically isn't used outside of the \idx{glossary} (the \gloskey{text} and
+ \gloskey{plural} keys are used instead). However, if there is a
+ need to specifically display the entry name,
+ use \gls{glsname} (if \idx{indexing} and hyperlinks
+ are required) or \gls{glsentryname}. Glossary styles should use
+ \gls{glossentryname}, which uses \gls{glsentryname} and
+ incorporates the \idxpl{postnamehook} and related \attrs}
+ }
+ % glossentry description
+ \ggloskey{description}%
+ {%
+ \syntax{\margm{text}}
+ \desc{the entry's description, as displayed in the \idx{glossary}. If
+ required in the text, use \gls{glsdesc} (if \idx{indexing} and hyperlinks
+ are required) or \gls{glsentrydesc}. Glossary styles should use
+ \gls{glossentrydesc} and \gls{glspostdescription} to
+ incorporate the \idx{postdeschook}}
+ }
+ % glossentry descriptionplural
+ \ggloskey{description\-plural}%
+ {%
+ \syntax{\margm{text}}
+ \desc{the plural form of the entry's description, if applicable.
+ If omitted, this is set to the same value as the
+ \gloskey{description}, since descriptions tend not to be a singular
+ entity}
+ }
+ % glossentry type
+ \ggloskey{type}%
+ {%
+ \syntax{\meta{\idx{glossary}-label}}
+ \initvalcs{glsdefaulttype}%
+ \desc{assigns the entry to the \idx{glossary} identified by
+ \meta{\idx{glossary}-label}}
+ }
+ % glossentry parent
+ \ggloskey{parent}%
+ {%
+ \syntax{\meta{parent-label}}
+ \desc{the label of the entry's parent (from which the entry's
+ \idx{hierarchicallevel} is obtained)}
+ }
+ % glossentry category
+ \ggloskey{category}%
+ {%
+ \syntax{\meta{category-label}}%
+ \initval{general}%
+ \providedby{\sty{glossaries-extra}}
+ \desc{the entry's \idx{category} (must be a simple label)}
+ }
+ % glossentry sort
+ \ggloskey{sort}%
+ {%
+ \syntax{\meta{value}}
+ \initval{\meta{entry name}}
+ \desc{specifies the value to use for sorting (overrides the
+ default). This key is usually required for \app+{xindy} if the
+ \gloskey{name} key only contains commands (for example, the
+ entry is a symbol), but explicitly using this key in other
+ contexts can break certain sort methods.
+ \gallerypage{bib2gls-sorting}{Don't use the \gloskey{sort} field
+ with \app{bib2gls}}}
+ }
+ % glossentry text
+ \ggloskey{text}%
+ {%
+ \syntax{\margm{text}}
+ \desc{the entry's text, as displayed on \idx{subsequentuse} of
+ \idx{glslike} commands. If omitted, this value is assumed to be
+ the same as the \gloskey{name} key}
+ }
+ % glossentry plural
+ \ggloskey{plural}%
+ {%
+ \syntax{\margm{text}}
+ \desc{the entry's plural form, as displayed on \idx{subsequentuse} of
+ plural \idx{glslike} commands, such as \gls{glspl}. This should
+ be the appropriate plural form of the value provided by the
+ \gloskey{text} key. If omitted, this value is assumed to be the
+ value of the \gloskey{text} key with \gls{glspluralsuffix}
+ appended}
+ }
+ % glossentry symbol
+ \ggloskey{symbol}%
+ {%
+ \initvalcs{relax}
+ \syntax{\margm{symbol}}
+ \desc{the entry's associated symbol (optional), which can be
+ displayed with \gls{glssymbol} (if \idx{indexing} and hyperlinks are
+ required) or with \gls{glsentrysymbol}}
+ }
+ % glossentry symbolplural
+ \ggloskey{symbol\-plural}%
+ {%
+ \syntax{\margm{symbol plural}}
+ \desc{The plural form of the \gloskey{symbol}, if applicable,
+ which can be displayed with \gls{glssymbolplural} (if \idx{indexing}
+ and hyperlinks are required) or with \gls{glsentrysymbolplural}.
+ If omitted, this value is set to the same as the
+ \gloskey{symbol} key (since symbols usually don't have a plural
+ form)}
+ }
+ % glossentry first
+ \ggloskey{first}%
+ {%
+ \syntax{\margm{first}}
+ \desc{the entry's text, as displayed on \idx{firstuse} of
+ \idx{glslike} commands. Note that using an \idx{abbrvstyle}
+ or \glspl{postlinkhook} is a more flexible approach. If omitted,
+ this value is assumed to be the same as the \gloskey{text} key}
+ }
+ % glossentry firstplural
+ \ggloskey{first\-plural}%
+ {%
+ \syntax{\margm{text}}
+ \desc{the entry's plural form, as displayed on \idx{firstuse} of
+ plural \idx{glslike} commands, such as \gls{glspl}. If this key
+ is omitted, then the value will either be the same as the
+ \gloskey{plural} field, if the \gloskey{first} key wasn't used, or
+ the value will be taken from the \gloskey{first} key with
+ \gls{glspluralsuffix} appended}
+ }
+ % glossentry short
+ \ggloskey{short}%
+ {%
+ \syntax{\margm{short-form}}
+ \desc{a \idx{field} that is set by \gls{newabbreviation}
+ (and \gls{newacronym}) to the entry's short (abbreviated) form. It
+ typically shouldn't be used explicitly with
+ \gls{newglossaryentry} as \gls{newabbreviation}
+ makes other modifications to ensure that when the entry is
+ referenced with the \idx{glslike} commands, it will obey the
+ appropriate \idx{abbrvstyle}. If you are using \app{bib2gls}
+ then this field should be used in the \ext{bib} file when
+ defining abbreviations}
+ }
+ % glossentry shortplural
+ \ggloskey{short\-plural}%
+ {%
+ \syntax{\margm{short-form}}
+ \desc{as \gloskey{short} but the plural form. The default is
+ obtained by appending the abbreviation plural suffix, but this
+ behaviour can be altered by \idxpl{categoryattribute}. See
+ \sectionref{sec:abbreviations} for further details}
+ }
+ % glossentry long
+ \ggloskey{long}%
+ {%
+ \syntax{\margm{long-form}}
+ \desc{a \idx{field} that is set by \gls{newabbreviation} to
+ the entry's long (unabbreviated) form. It
+ typically shouldn't be used explicitly with
+ \gls{newglossaryentry} as \gls{newabbreviation}
+ makes other modifications to ensure that when the entry is
+ referenced with the \idx{glslike} commands, it will obey the
+ appropriate \idx{abbrvstyle}. If you are using \app{bib2gls}
+ then this field should be used in the \ext{bib} file when
+ defining abbreviations}
+ }
+ % glossentry longplural
+ \ggloskey{long\-plural}%
+ {%
+ \syntax{\margm{long-form}}
+ \desc{as \gloskey{long} but the plural form}
+ }
+ % glossentry user1
+ \ggloskey{user1}%
+ {%
+ \syntax{\margm{text}}
+ \desc{a generic field, which can be
+ displayed with \gls{glsuseri} (if \idx{indexing} and hyperlinks are
+ required) or with \gls{glsentryuseri}}
+ }
+ % glossentry user2
+ \ggloskey{user2}%
+ {%
+ \syntax{\margm{text}}
+ \desc{a generic field, which can be
+ displayed with \gls{glsuserii} (if \idx{indexing} and hyperlinks are
+ required) or with \gls{glsentryuserii}}
+ }
+ % glossentry user3
+ \ggloskey{user3}%
+ {%
+ \syntax{\margm{text}}
+ \desc{a generic field, which can be
+ displayed with \gls{glsuseriii} (if \idx{indexing} and hyperlinks are
+ required) or with \gls{glsentryuseriii}}
+ }
+ % glossentry user4
+ \ggloskey{user4}%
+ {%
+ \syntax{\margm{text}}
+ \desc{a generic field, which can be
+ displayed with \gls{glsuseriv} (if \idx{indexing} and hyperlinks are
+ required) or with \gls{glsentryuseriv}}
+ }
+ % glossentry user5
+ \ggloskey{user5}%
+ {%
+ \syntax{\margm{text}}
+ \desc{a generic field, which can be
+ displayed with \gls{glsuserv} (if \idx{indexing} and hyperlinks are
+ required) or with \gls{glsentryuserv}}
+ }
+ % glossentry user6
+ \ggloskey{user6}%
+ {%
+ \syntax{\margm{text}}
+ \desc{a generic field, which can be
+ displayed with \gls{glsuservi} (if \idx{indexing} and hyperlinks are
+ required) or with \gls{glsentryuservi}}
+ }
+ % glossentry counter
+ \ggloskey{counter}%
+ {%
+ \syntax{\margm{counter-name}}
+ \desc{if set, the value indicates the \idx{locationcounter} to use
+ by default when \idx{indexing} this entry (overrides the
+ counter associated with the \idx{glossary} or the \opt{counter}
+ package option)}
+ }
+ % glossentry see
+ \ggloskey{see}%
+ {%
+ \syntax{\marg{\oargm{tag}\meta{xr-list}}}
+ \desc{with the base \sty{glossaries} package this simply
+ triggers an automatic cross-reference with \gls{glssee}. The
+ \sty{glossaries-extra} package additionally saves the value.
+ Use \opteqvalref{autoseeindex}{false} to prevent the automatic
+ cross-reference. The \meta{tag} defaults to \gls{seename} and
+ \meta{xr-list} should be a comma-separated list of entries that
+ have already been defined}
+ }
+ % glossentry seealso
+ \ggloskey{see\-also}%
+ {%
+ \providedby{\sty{glossaries-extra}}
+ \syntax{\margm{xr-list}}
+ \desc{behaves in a similar manner to
+ \gloskeyval{see}{\oarg{\gls{seealsoname}}\meta{xr-list}}}
+ }
+ % glossentry alias
+ \ggloskey{alias}%
+ {%
+ \providedby{\sty{glossaries-extra}}
+ \syntax{\margm{xr-label}}
+ \desc{behaves in a similar manner to
+ \gloskeyval{see}{\oarg{\gls{seealsoname}}\meta{xr-label}} but also
+ sets up aliasing which makes the \idx{linktext} hyperlink to
+ \meta{xr-label} instead}
+ }
+ % glossentry group
+ \ggloskey{group}%
+ {%
+ \providedby{\sty{glossaries-extra}}
+ \syntax{\margm{group-label}}
+ \desc{the \idx{group} label that identifies which \idx{group} the
+ entry belongs to. This key is only available with the
+ \opteqvalref{record}{only} and \opteqvalref{record}{nameref} options,
+ and is set by \app{bib2gls}, if invoked with \switch{group} or \switch{g}.
+ This is an \idxc{bib2glsinternalfield}{internal key} assigned by
+ \app{bib2gls} as a by-product of sorting.
+ Explicit use without reference to the order of entries can result in
+ fragmented groups. The corresponding title can be set with
+ \gls{glsxtrsetgrouptitle}, although this is more commonly done
+ implicitly within the \ext{glstex} file}
+ }
+ % glossentry location
+ \ggloskey{location}%
+ {%
+ \providedby{\sty{glossaries-extra}}
+ \syntax{\margm{location-list}}
+ \desc{the formatted \idx{locationlist} used by the \idx{unsrtfam}. This key
+ is only available with the \opt{record} option and is set by \app{bib2gls}
+ unless \resourceopt{save-locations}{false} is set}
+ }
+ % ACCESSIBILITY KEYS
+ % glossentry access
+ \ggloskey{access}%
+ {%
+ \note{requires \opt{accsupp}}
+ \syntax{\margm{text}}
+ \desc{accessibility text corresponding to the \gloskey{name} field.
+ This field will be automatically set by
+ \gls{newabbreviation}, if not provided and the
+ \catattr{nameshortaccess} attribute is set. See \sectionref{sec:accessabbr}}
+ }
+ % glossentry textaccess
+ \ggloskey{text\-access}%
+ {%
+ \note{requires \opt{accsupp}}
+ \syntax{\margm{text}}
+ \desc{accessibility text corresponding to the \gloskey{text} field.
+ This field will be automatically set by
+ \gls{newabbreviation}, if not provided and the
+ \catattr{textshortaccess} attribute is set. See \sectionref{sec:accessabbr}}
+ }
+ % glossentry pluralaccess
+ \ggloskey{plural\-access}%
+ {%
+ \note{requires \opt{accsupp}}
+ \syntax{\margm{text}}
+ \desc{accessibility text corresponding to the \gloskey{plural} field.
+ This field will be automatically set by
+ \gls{newabbreviation}, if not provided and the
+ \catattr{textshortaccess} attribute is set. See \sectionref{sec:accessabbr}}
+ }
+ % glossentry firstaccess
+ \ggloskey{first\-access}%
+ {%
+ \note{requires \opt{accsupp}}
+ \syntax{\margm{text}}
+ \desc{accessibility text corresponding to the \gloskey{first} field.
+ This field will be automatically set by
+ \gls{newabbreviation}, if not provided and the
+ \catattr{firstshortaccess} attribute is set. See \sectionref{sec:accessabbr}}
+ }
+ % glossentry firstpluralaccess
+ \ggloskey{first\-plural\-access}%
+ {%
+ \note{requires \opt{accsupp}}
+ \syntax{\margm{text}}
+ \desc{accessibility text corresponding to the \gloskey{firstplural} field.
+ This field will be automatically set by
+ \gls{newabbreviation}, if not provided and the
+ \catattr{firstshortaccess} attribute is set. See \sectionref{sec:accessabbr}}
+ }
+ % glossentry shortaccess
+ \ggloskey{short\-access}%
+ {%
+ \note{requires \opt{accsupp}}
+ \syntax{\margm{text}}
+ \desc{accessibility text corresponding to the \gloskey{short}
+ field. This field will be automatically set by
+ \gls{newabbreviation}, if not provided. See \sectionref{sec:accessabbr}}
+ }
+ % glossentry shortpluralaccess
+ \ggloskey{short\-plural\-access}%
+ {%
+ \note{requires \opt{accsupp}}
+ \syntax{\margm{text}}
+ \desc{accessibility text corresponding to the \gloskey{shortplural} field. This field will be automatically set by
+ \gls{newabbreviation}, if not provided. See \sectionref{sec:accessabbr}}
+ }
+ % glossentry longaccess
+ \ggloskey{long\-access}%
+ {%
+ \note{requires \opt{accsupp}}
+ \syntax{\margm{text}}
+ \desc{accessibility text corresponding to the \gloskey{long} field}
+ }
+ % glossentry longpluralaccess
+ \ggloskey{long\-plural\-access}%
+ {%
+ \note{requires \opt{accsupp}}
+ \syntax{\margm{text}}
+ \desc{accessibility text corresponding to the \gloskey{longplural} field}
+ }
+ % glossentry descriptionaccess
+ \ggloskey{description\-access}%
+ {%
+ \note{requires \opt{accsupp}}
+ \syntax{\margm{text}}
+ \desc{accessibility text corresponding to the \gloskey{description} field}
+ }
+ % glossentry descriptionpluralaccess
+ \ggloskey{description\-plural\-access}%
+ {%
+ \note{requires \opt{accsupp}}
+ \syntax{\margm{text}}
+ \desc{accessibility text corresponding to the \gloskey{descriptionplural} field}
+ }
+ % glossentry symbolaccess
+ \ggloskey{symbol\-access}%
+ {%
+ \note{requires \opt{accsupp}}
+ \syntax{\margm{text}}
+ \desc{accessibility text corresponding to the \gloskey{symbol} field}
+ }
+ % glossentry symbolpluralaccess
+ \ggloskey{symbol\-plural\-access}%
+ {%
+ \note{requires \opt{accsupp}}
+ \syntax{\margm{text}}
+ \desc{accessibility text corresponding to the \gloskey{symbolplural} field}
+ }
+ % glossentry user1access
+ \ggloskey{user1\-access}%
+ {%
+ \providedby{\sty{glossaries-accsupp} v4.45+}
+ \syntax{\margm{text}}
+ \desc{accessibility text corresponding to the \gloskey{user1} field}
+ }
+ % glossentry user2access
+ \ggloskey{user2\-access}%
+ {%
+ \providedby{\sty{glossaries-accsupp} v4.45+}
+ \syntax{\margm{text}}
+ \desc{accessibility text corresponding to the \gloskey{user2} field}
+ }
+ % glossentry user3access
+ \ggloskey{user3\-access}%
+ {%
+ \providedby{\sty{glossaries-accsupp} v4.45+}
+ \syntax{\margm{text}}
+ \desc{accessibility text corresponding to the \gloskey{user3} field}
+ }
+ % glossentry user4access
+ \ggloskey{user4\-access}%
+ {%
+ \providedby{\sty{glossaries-accsupp} v4.45+}
+ \syntax{\margm{text}}
+ \desc{accessibility text corresponding to the \gloskey{user4} field}
+ }
+ % glossentry user5access
+ \ggloskey{user5\-access}%
+ {%
+ \providedby{\sty{glossaries-accsupp} v4.45+}
+ \syntax{\margm{text}}
+ \desc{accessibility text corresponding to the \gloskey{user5} field}
+ }
+ % glossentry user6access
+ \ggloskey{user6\-access}%
+ {%
+ \providedby{\sty{glossaries-accsupp} v4.45+}
+ \syntax{\margm{text}}
+ \desc{accessibility text corresponding to the \gloskey{user6} field}
+ }
+ % PREFIX KEYS
+ % glossentry prefix
+ \ggloskey{prefix}%
+ {%
+ \providedby{\sty{glossaries-prefix} v3.14a+}
+ \syntax{\margm{text}}
+ \desc{the \idx{subsequentuse} singular prefix}
+ }
+ % glossentry prefixplural
+ \ggloskey{prefix\-plural}%
+ {%
+ \providedby{\sty{glossaries-prefix} v3.14a+}
+ \syntax{\margm{text}}
+ \desc{the \idx{subsequentuse} plural prefix}
+ }
+ % glossentry prefixfirst
+ \ggloskey{prefix\-first}%
+ {%
+ \providedby{\sty{glossaries-prefix} v3.14a+}
+ \syntax{\margm{text}}
+ \desc{the \idx{firstuse} singular prefix}
+ }
+ % glossentry prefixfirstplural
+ \ggloskey{prefix\-first\-plural}%
+ {%
+ \providedby{\sty{glossaries-prefix} v3.14a+}
+ \syntax{\margm{text}}
+ \desc{the \idx{firstuse} plural prefix}
+ }
+ % COMMANDS: FIELDS
+ \gidxpl{glosfield}{%
+ \common
+ \field{text}{glossary entry field}
+ \desc{these are internal fields that don't have a corresponding
+ \idxc{gloskey}{key}}
+ }
+ % field loclist
+ \gglosfield{loc\-list}%
+ {%
+ \providedby{\sty{glossaries} v4.04+}
+ \syntax{\margm{\sty{etoolbox} list}}
+ \desc{used by \gls{printnoidxglossary} to provide the locations.
+ The value is an \sty{etoolbox} list of individual locations
+ which are obtained from the \ext+{aux} file. This field will also
+ be used by the \idx{unsrtfam} if \gloskey{location} isn't set}
+ }
+ % field indexcounter
+ \gglosfield{index\-counter}%
+ {%
+ \syntax{\margm{target-name}}
+ \desc{used with the \opt{indexcounter} package option and the
+ \resourceopt{save-index-counter} resource option. The value is
+ set to the hyperlink target of the first \ctr{wrglossary} \location\
+ or the first instance for a specific \idx{locationencap}}
+ }
+ % field childcount
+ \gglosfield{child\-count}%
+ {%
+ \syntax{\margm{number}}
+ \desc{used with the \resourceopt{save-child-count} resource
+ option to store the entry's child count}
+ }
+ % field childlist
+ \gglosfield{child\-list}%
+ {%
+ \syntax{\margm{entry-label-list}}
+ \desc{used with the \resourceopt{save-child-count} resource
+ option to store the entry's children as an \sty{etoolbox}
+ internal list}
+ }
+ % field recordcount
+ \gglosfield{record\-count}%
+ {%
+ \syntax{\margm{number}}
+ \desc{used with the \switch{record-count} switch to store the
+ total number of \records\ for the associated entry}
+ }
+ % field record.<counter>
+ \gglosfield{record.counter}%
+ {%
+ \name{\csoptfmt{record\dfullstop\meta{counter}}}
+ \syntax{\margm{location}}
+ \desc{used with \gls{GlsXtrRecordCounter} to store an
+ \sty{etoolbox} internal list of locations (without encap) corresponding to the
+ given counter}
+ }
+ % field recordcount.<counter>
+ \gglosfield{record\-count.counter}%
+ {%
+ \name{\csoptfmt{record\-count\dfullstop\meta{counter}}}
+ \syntax{\margm{number}}
+ \desc{used with the \switch{record-count} switch to store the
+ total number of \records\ with the \idx{locationcounter} \meta{counter}
+ for the associated entry}
+ }
+ % field recordcount.<counter>.<location>
+ \gglosfield{record\-count.counter.location}%
+ {%
+ \name{\csoptfmt{record\-count\dfullstop\meta{counter}\dfullstop\meta{location}}}
+ \syntax{\margm{number}}
+ \desc{used with the \switch{record-count-unit} switch to store the
+ total number of \records\ with the \idx{locationcounter}
+ \meta{counter} set to \meta{location} for the associated entry}
+ }
+ % field secondarygroup
+ \gglosfield{sec\-ondary\-group}
+ {
+ \syntax{\margm{group-label}}
+ \desc{used by \app{bib2gls} to store the \idx{group} label
+ obtained from the secondary sort}
+ }
+ % \glscategory
+ \gcmd{gls\-category}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{entry-label}}
+ \desc{expands to the entry's category}
+ }
+ % \glsfieldxdef
+ \gcmd{gls\-field\-xdef}
+ {
+ \providedby{\sty{glossaries} v4.16+}
+ \syntax{\margm{entry-label}\margm{field}\margm{value}}
+ \desc{as \gls{glsfieldedef} but does a global assignment}
+ }
+ % \glsfieldedef
+ \gcmd{gls\-field\-edef}
+ {
+ \providedby{\sty{glossaries} v4.16+}
+ \syntax{\margm{entry-label}\margm{field}\margm{value}}
+ \desc{locally assigns the full expansion of \meta{value} to the given \idx{field}
+ (identified by the \idx{internalfieldlabel} \meta{field}) for the entry identified by
+ \meta{entry-label}. Produces an error (or warning with
+ \opteqvalref{undefaction}{warn}) if the entry or field doesn't
+ exist. Note that this doesn't update any associated fields}
+ }
+ % \glsfieldgdef
+ \gcmd{gls\-field\-gdef}
+ {
+ \providedby{\sty{glossaries} v4.16+}
+ \syntax{\margm{entry-label}\margm{field}\margm{value}}
+ \desc{as \gls{glsfielddef} but does a global assignment}
+ }
+ % \glsfielddef
+ \gcmd{gls\-field\-def}
+ {
+ \providedby{\sty{glossaries} v4.16+}
+ \syntax{\margm{entry-label}\margm{field}\margm{value}}
+ \desc{locally assigns the \meta{value} to the given \idx{field}
+ (identified by the \idx{internalfieldlabel} \meta{field}) for the entry identified by
+ \meta{entry-label}. Produces an error (or warning with
+ \opteqvalref{undefaction}{warn}) if the entry or field doesn't
+ exist. Note that this doesn't update any associated fields}
+ }
+ % \glsxtrdeffield
+ \gcmd{gls\-xtr\-def\-field}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{field-label}\margm{value}}
+ \desc{like \gls{GlsXtrSetField} but doesn't perform any
+ existence checks}
+ }
+ % \glsxtredeffield
+ \gcmd{gls\-xtr\-edef\-field}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{field-label}\margm{value}}
+ \desc{like \gls{glsxtrdeffield} but (protected) expands
+ \meta{value}}
+ }
+ % \glsxtrapptocsvfield
+ \gcmd{gls\-xtr\-app\-to\-csv\-field}
+ {
+ \providedby{\sty{glossaries-extra} v1.47+}
+ \syntax{\margm{entry-label}\margm{field-label}\margm{element}}
+ \desc{For use with fields that should contain comma-separated
+ lists, this will append a command followed by \meta{element} to
+ the field value. If the field isn't defined, this command will
+ behave like \gls{glsxtrdeffield}. No existence check is performed}
+ }
+ % \glsxtrsetfieldifexists
+ \gcmd{gls\-xtr\-set\-field\-if\-exists}
+ {%
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{field-label}\margm{code}}
+ \desc{used by commands like \gls{GlsXtrSetField} to check if
+ the entry exists before assigning a value to the field. The
+ \meta{code} part is the assignment code, which is only done if
+ the required condition is met. This can be redefined if the
+ condition needs to be altered}
+ }
+ % \glsxtrfieldlistadd
+ \gcmd{gls\-xtr\-field\-list\-add}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{field}\margm{value}}
+ \desc{appends \meta{value} to the given field using
+ \sty{etoolbox}['s] \gls{listcsadd}}
+ }
+ % \glsxtrfieldlistgadd
+ \gcmd{gls\-xtr\-field\-list\-gadd}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{field}\margm{value}}
+ \desc{appends \meta{value} to the given field using
+ \sty{etoolbox}['s] \gls{listcsgadd}}
+ }
+ % \glsxtrfieldlisteadd
+ \gcmd{gls\-xtr\-field\-list\-eadd}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{field}\margm{value}}
+ \desc{appends \meta{value} to the given field using
+ \sty{etoolbox}['s] \gls{listcseadd}}
+ }
+ % \glsxtrfieldlistxadd
+ \gcmd{gls\-xtr\-field\-list\-xadd}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{field}\margm{value}}
+ \desc{appends \meta{value} to the given field using
+ \sty{etoolbox}['s] \gls{listcsxadd}}
+ }
+ % \glsxtrfieldformatlist
+ \gcmd{gls\-xtr\-field\-format\-list}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}\margm{field-label}}
+ \desc{formats the value of the given field, which should be
+ an \sty{etoolbox} internal list, using the same list handler
+ macro as \sty{datatool}['s] \gls{DTLformatlist}}
+ }
+ % \glsxtrfielddolistloop
+ \gcmd{gls\-xtr\-field\-do\-list\-loop}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{field}}
+ \desc{iterates over the given field's value using
+ \sty{etoolbox}['s] \gls{dolistcsloop}}
+ }
+ % \glsxtrfieldforlistloop
+ \gcmd{gls\-xtr\-field\-for\-list\-loop}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{field}\margm{handler-cs}}
+ \desc{iterates over the given field's value using
+ \sty{etoolbox}['s] \gls{forlistcsloop}}
+ }
+ % \glsxtrfieldifinlist
+ \gcmd{gls\-xtr\-field\-if\-in\-list}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{field}\margm{item}\margm{true}\margm{false}}
+ \desc{uses \sty{etoolbox}['s] \gls{ifinlistcs} to determine if
+ \meta{item} is in the list stored in the given field}
+ }
+ % \glsxtrfieldxifinlist
+ \gcmd{gls\-xtr\-field\-x\-if\-in\-list}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{field}\margm{item}\margm{true}\margm{false}}
+ \desc{uses \sty{etoolbox}['s] \gls{xifinlistcs} to determine if
+ \meta{item} is in the list stored in the given field}
+ }
+ % \GlsXtrSetField
+ \gcmd{Gls\-Xtr\-Set\-Field}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{field-label}\margm{value}}
+ \desc{assigns \meta{value} to the field identified by its
+ \idxc{internalfieldlabel}{internal label} \meta{field-label}
+ for the entry identified by \meta{entry-label}. An error (or
+ warning with \opteqvalref{undefaction}{warn}) occurs
+ if the entry hasn't been defined}
+ }
+ % \gGlsXtrSetField
+ \gcmd{gGls\-Xtr\-Set\-Field}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{field-label}\margm{value}}
+ \desc{as \gls{GlsXtrSetField} but globally assigns the value}
+ }
+ % \eGlsXtrSetField
+ \gcmd{eGls\-Xtr\-Set\-Field}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{field-label}\margm{value}}
+ \desc{as \gls{GlsXtrSetField} but expands the value}
+ }
+ % \xGlsXtrSetField
+ \gcmd{xGls\-Xtr\-Set\-Field}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{field-label}\margm{value}}
+ \desc{as \gls{GlsXtrSetField} but expands the value and uses a
+ global assignment}
+ }
+ % \GlsXtrLetField
+ \gcmd{Gls\-Xtr\-Let\-Field}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{field-label}\margm{cs}}
+ \desc{like \gls{GlsXtrSetField} but internally uses
+ (\sty{etoolbox}['s]) \gls{cslet} instead of \gls{csdef}}
+ }
+ % \csGlsXtrLetField
+ \gcmd{cs\-Gls\-Xtr\-Let\-Field}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{field-label}\margm{cs-name}}
+ \desc{like \gls{GlsXtrLetField} but internally uses
+ (\sty{etoolbox}['s]) \gls{csletcs} instead of \gls{cslet}}
+ }
+ % \GlsXtrLetFieldToField
+ \gcmd{Gls\-Xtr\-Let\-Field\-To\-Field}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry1-label}\margm{field1-label}\margm{entry2-label}\margm{field2-label}}
+ \desc{assigns the \idx{field} identified by its
+ \idxc{internalfieldlabel}{internal label} \meta{field1-label}
+ for the entry identified by \meta{entry1-label} to the
+ value of the \idx{field} identified by \meta{field2-label} for the
+ entry identified by \meta{entry2-label}}
+ }
+ % \GlsXtrIfFieldUndef
+ \gcmd{Gls\-Xtr\-If\-Field\-Undef}
+ {
+ \providedby{\sty{glossaries-extra} v1.23+}
+ \syntax{\margm{field-label}\margm{entry-label}\margm{true}\margm{false}}
+ \desc{expandable command that tests if the given \idx{field} (identified by its
+ \idxc{internalfieldlabel}{internal label}) is undefined for the
+ entry given by \meta{entry-label}. Internally uses \sty{etoolbox}['s]
+ \gls{ifcsundef} command. Unlike \gls{glsxtrifhasfield} there is no
+ grouping or starred version}
+ \field{seealso}{ifglsfieldvoid}
+ }
+ % \glsxtrifhasfield
+ \gcmds{gls\-xtr\-if\-has\-field}
+ {
+ \providedby{\sty{glossaries-extra} v1.19+}
+ \syntax{\margm{field-label}\margm{entry-label}\margm{true}\margm{false}}
+ \desc{tests if the \idx{field} identified by its
+ \idxc{internalfieldlabel}{internal label} \meta{field-label} for the entry
+ given by \meta{entry-label} is defined and is not empty. This is like
+ \gls{ifglshasfield} but doesn't produce a warning if the entry or field
+ doesn't exist. This sets \gls{glscurrentfieldvalue} to the field value and
+ does \meta{true} if its defined and not empty, otherwise it does
+ \meta{false}. The unstarred version adds implicit grouping to
+ make nesting easier. The starred version doesn't (to make
+ assignments easier)}
+ }
+ % \ifglsfieldeq
+ \gcmd{if\-gls\-field\-eq}
+ {
+ \providedby{\sty{glossaries} v4.16+}
+ \syntax{\margm{entry-label}\margm{field-label}\margm{string}\margm{true}\margm{false}}
+ \desc{tests if the value of the given field is equal to the
+ given string using \sty{etoolbox}['s] \gls{ifcsstring}.
+ Triggers an error if the given field (identified by its
+ \idx{internalfieldlabel}) hasn't been defined. Uses
+ \gls{glsdoifexists}}
+ }
+ % \ifglsfielddefeq
+ \gcmd{if\-gls\-field\-def\-eq}
+ {
+ \providedby{\sty{glossaries} v4.16+}
+ \syntax{\margm{entry-label}\margm{field-label}\margm{cs}\margm{true}\margm{false}}
+ \desc{tests if the value of the given field is equal to the
+ replacement text of the given command \meta{cs} using \sty{etoolbox}['s]
+ \csfmt{ifdefstrequal}.
+ Triggers an error if the given field (identified by its
+ \idx{internalfieldlabel}) hasn't been defined. Uses
+ \gls{glsdoifexists}}
+ }
+ % \ifglsfieldcseq
+ \gcmd{if\-gls\-field\-cs\-eq}
+ {
+ \providedby{\sty{glossaries} v4.16+}
+ \syntax{\margm{entry-label}\margm{field-label}\margm{cs-name}\margm{true}\margm{false}}
+ \desc{tests if the value of the given field is equal to the
+ replacement text of the command given by the control sequence
+ name \meta{cs-name} using \sty{etoolbox}['s] \csfmt{ifcsstrequal}.
+ Triggers an error if the given field (identified by its
+ \idx{internalfieldlabel}) hasn't been defined. Uses
+ \gls{glsdoifexists}}
+ }
+ % \glsfieldfetch
+ \gcmd{gls\-field\-fetch}
+ {
+ \providedby{\sty{glossaries} v4.16+}
+ \syntax{\margm{entry-label}\margm{field-label}\margm{cs}}
+ \desc{fetches the value of the given field for the given entry and stores it in
+ the command \meta{cs}. Triggers an error if the given field (identified by its
+ \idx{internalfieldlabel}) hasn't been defined. Uses
+ \gls{glsdoifexists}}
+ }
+ % \glsunexpandedfieldvalue
+ \gcmd{gls\-un\-expanded\-field\-value}
+ {
+ \providedby{\sty{glossaries} v4.48+}
+ \syntax{\margm{entry-label}\margm{field-label}}
+ \desc{for use in expandable contexts where the field value is
+ required but the contents should not be expanded. The field
+ should be identified by its \idx{internalfieldlabel}. Expands
+ to nothing with no error or warning if the entry or field aren't defined}
+ }
+ % \GlsXtrIfFieldCmpNum
+ \gcmds{Gls\-Xtr\-If\-Field\-Cmp\-Num}
+ {
+ \providedby{\sty{glossaries-extra} v1.31+}
+ \syntax{\margm{field-label}\margm{entry-label}\margm{op}\margm{number}\margm{true}\margm{false}}
+ \desc{compares the (numeric) value of the \idx{field} identified by its
+ \idxc{internalfieldlabel}{internal label}
+ \meta{field-label} for the entry identified by
+ \meta{entry-label} with \meta{number} where \meta{op} is
+ the comparison operator (\code{=}, \code{<} or \code{>}). The
+ unstarred version adds implicit grouping. The starred version
+ doesn't}
+ }
+ % \GlsXtrIfFieldEqNum
+ \gcmds{Gls\-Xtr\-If\-Field\-Eq\-Num}
+ {
+ \providedby{\sty{glossaries-extra} v1.31+}
+ \syntax{\margm{field-label}\margm{entry-label}\margm{number}\margm{true}\margm{false}}
+ \desc{a shortcut that uses \gls{GlsXtrIfFieldCmpNum} with
+ \meta{op} set to \code{=}. The
+ unstarred version adds implicit grouping. The starred version
+ doesn't}
+ }
+ % \GlsXtrIfFieldNonZero
+ \gcmds{Gls\-Xtr\-If\-Field\-Non\-Zero}
+ {
+ \providedby{\sty{glossaries-extra} v1.31+}
+ \syntax{\margm{field-label}\margm{entry-label}\margm{true}\margm{false}}
+ \desc{a shortcut that uses \gls{GlsXtrIfFieldCmpNum} to test if
+ the (numeric) value of the \idx{field} identified by its
+ \idxc{internalfieldlabel}{internal label}
+ \meta{field-label} for the entry identified by
+ \meta{entry-label} is non-zero. An empty or undefined field is
+ treated as 0. The unstarred version adds implicit grouping. The starred version
+ doesn't. The value can be referenced within \meta{true} (where
+ it will be 0) or within \meta{false} using \gls{glscurrentfieldvalue}}
+ }
+ % \GlsXtrIfFieldEqStr
+ \gcmds{Gls\-Xtr\-If\-Field\-Eq\-Str}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{field-label}\margm{entry-label}\margm{value}\margm{true}\margm{false}}
+ \desc{tests if the entry given by \meta{entry-label} has the
+ \idx{field} identified by its \idxc{internalfieldlabel}{internal label}
+ \meta{field-label} set to \meta{value}. This internally uses
+ \gls{glsxtrifhasfield} and compares \gls{glscurrentfieldvalue}
+ to \meta{value} using \sty{etoolbox}['s] \gls{ifdefstring}. The
+ unstarred version adds implicit grouping. The starred version
+ doesn't}
+ }
+ % \GlsXtrIfFieldEqXpStr
+ \gcmds{Gls\-Xtr\-If\-Field\-Eq\-Xp\-Str}
+ {
+ \providedby{\sty{glossaries-extra} v1.31+}
+ \syntax{\margm{field-label}\margm{entry-label}\margm{value}\margm{true}\margm{false}}
+ \desc{like \gls{GlsXtrIfFieldEqStr} but first (protected) expands
+ \meta{value}}
+ }
+ % \GlsXtrIfXpFieldEqXpStr
+ \gcmds{Gls\-Xtr\-If\-Xp\-Field\-Eq\-Xp\-Str}
+ {
+ \providedby{\sty{glossaries-extra} v1.31+}
+ \syntax{\margm{field-label}\margm{entry-label}\margm{value}\margm{true}\margm{false}}
+ \desc{like \gls{GlsXtrIfFieldEqStr} but first (protected) expands
+ both the field value and the supplied \meta{value}}
+ }
+ % \glsxtrforcsvfield
+ \gcmds{gls\-xtr\-for\-csv\-field}
+ {
+ \providedby{\sty{glossaries-extra} v1.24+}
+ \syntax{\margm{entry-label}\margm{field-label}\margm{handler cs}}
+ \desc{iterates over the comma-separated list stored in the given \idx{field}
+ (identified by its \idxc{internalfieldlabel}{internal label})
+ for the entry identified by \meta{entry-label} and performs
+ \code{\meta{handler cs}\margm{element}} for each element of the
+ list. This command uses \gls{glsxtrifhasfield} so the complete
+ list can be obtained with \gls{glscurrentfieldvalue}. The
+ unstarred version adds implicit grouping. The starred version
+ doesn't}
+ }
+ % \glsxtrendfor
+ \gcmd{glsxtrendfor}
+ {
+ \providedby{\sty{glossaries-extra} v1.24+}
+ \desc{when used within \gls{glsxtrforcsvfield} signifies that
+ the loop should break at the end of the current iteration}
+ }
+ % \glsxtrfieldformatcsvlist
+ \gcmd{gls\-xtr\-field\-format\-csv\-list}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}\margm{field-label}}
+ \desc{formats the comma-separated list stored in the given \idx{field}
+ (identified by its \idxc{internalfieldlabel}{internal label})
+ for the entry identified by \meta{entry-label} using \sty{datatool-base}['s]
+ \gls{DTLformatlist}.
+ This command uses \gls{glsxtrifhasfield} so the complete
+ list can be obtained with \gls{glscurrentfieldvalue}.
+ This adds implicit grouping. There is no starred version}
+ }
+ % \GlsXtrIfFieldValueInCsvList
+ \gcmds{Gls\-Xtr\-If\-Field\-Value\-In\-Csv\-List}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}\margm{field-label}\margm{csv-list}\margm{true}\margm{false}}
+ \desc{tests if the value stored in the given \idx{field}
+ (identified by its \idxc{internalfieldlabel}{internal label})
+ for the entry identified by \meta{entry-label} is contained in
+ the comma-separated list \meta{csv-list} using
+ \gls{DTLifinlist} (provided by \sty{datatool-base}, which is
+ automatically loaded by the \sty{glossaries} package).
+ One level expansion is performed on \meta{csv-list}.
+ This command uses \gls{glsxtrifhasfield} so the field value
+ can be obtained with \gls{glscurrentfieldvalue}.
+ The unstarred version adds implicit grouping. The starred version doesn't}
+ }
+ % \GlsXtrIfValueInFieldCsvList
+ \gcmds{Gls\-Xtr\-If\-Value\-In\-Field\-Csv\-List}
+ {
+ \providedby{\sty{glossaries-extra} v1.47+}
+ \syntax{\margm{entry-label}\margm{field-label}\margm{value}\margm{true}\margm{false}}
+ \desc{tests if the given value (\meta{value}) is contained in
+ the comma-separated list stored in the given \idx{field}
+ (identified by its \idxc{internalfieldlabel}{internal label})
+ for the entry identified by \meta{entry-label} using
+ \gls{DTLifinlist} (provided by \sty{datatool-base}, which is
+ automatically loaded by the \sty{glossaries} package).
+ No expansion is performed on \meta{value}.
+ This command uses \gls{glsxtrifhasfield} so the complete
+ list can be obtained with \gls{glscurrentfieldvalue}.
+ The unstarred version adds implicit grouping. The starred version doesn't}
+ }
+ % \xGlsXtrIfValueInFieldCsvList
+ \gcmds{xGls\-Xtr\-If\-Value\-In\-Field\-Csv\-List}
+ {
+ \providedby{\sty{glossaries-extra} v1.47+}
+ \syntax{\margm{entry-label}\margm{field-label}\margm{value}\margm{true}\margm{false}}
+ \desc{as \gls{GlsXtrIfValueInFieldCsvList} but fully expands
+ \meta{value}}
+ }
+ % \glsxtrusefield
+ \gcmd{gls\-xtr\-use\-field}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{field-label}}
+ \desc{expands to the value of the given \idx{field}
+ (identified by its \idxc{internalfieldlabel}{internal label}
+ \meta{field-label}) for the entry given by
+ \meta{entry-label}. Expands to \gls{relax} if the entry or field are undefined}
+ }
+ % \Glsxtrusefield
+ \gcmd{Gls\-xtr\-use\-field}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{field-label}}
+ \desc{as \gls{glsxtrusefield} but uses \idx{sentencecase}}
+ }
+ % \GLSxtrusefield
+ \gcmd{GLS\-xtr\-use\-field}
+ {
+ \providedby{\sty{glossaries-extra} v1.37+}
+ \syntax{\margm{entry-label}\margm{field-label}}
+ \desc{as \gls{glsxtrusefield} but converts the field value
+ to \idx{allcaps}}
+ }
+ % \glsxtrfieldtitlecase
+ \gcmd{gls\-xtr\-field\-title\-case}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.2+}
+ \syntax{\margm{entry-label}\margm{field-label}}
+ \desc{as \gls{glsxtrusefield} but converts the field value
+ to \idx{titlecase}}
+ }
+ % \glsxtrfieldtitlecasecs
+ \gcmd{gls\-xtr\-field\-title\-case\-cs}
+ {
+ \providedby{\sty{glossaries-extra} v1.07+}
+ \syntax{\margm{content}}
+ \desc{converts \meta{content} to \idx{titlecase} (expanding the
+ first token once). Uses \gls{glscapitalisewords}, if defined,
+ otherwise uses \gls{capitalisewords}}
+ }
+ % \glscapitalisewords
+ \gcmd{gls\-capitalise\-words}
+ {
+ \providedby{\sty{glossaries} v4.48+}
+ \syntax{\margm{content}}
+ \desc{just does \gls{capitalisewords} but may be redefined to
+ use \gls{capitalisefmtwords}, if required}
+ }
+ % \glsentrytitlecase
+ \gcmd{gls\-entry\-title\-case}
+ {
+ \providedby{\sty{glossaries} v4.22+}
+ \syntax{\margm{entry-label}\margm{field-label}}
+ \desc{applies \idx{titlecase} to the value supplied in the given
+ field (which is obtained with \gls{glsfieldfetch})}
+ }
+ % \glsletentryfield
+ \gcmd{gls\-let\-entry\-field}
+ {
+ \providedby{\sty{glossaries} v4.07+}
+ \syntax{\margm{cs}\margm{entry-label}\margm{field-label}}
+ \desc{fetches the value of the given \idx{field}
+ (identified by its \idxc{internalfieldlabel}{internal label}
+ \meta{field-label}) for the entry given by
+ \meta{entry-label} and stores it in the command \meta{cs}}
+ }
+ % \glsxtrentryparentname
+ \gcmd{gls\-xtr\-entry\-parent\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.39+}
+ \syntax{\margm{entry-name}}
+ \desc{expands to the \gloskey{name} field of the given entry's
+ parent or does nothing if the entry doesn't have the
+ \gloskey{parent} field set or isn't defined}
+ }
+ % COMMANDS: FORMATTING HOOKS
+ % \glsexclapplyinnerfmtfield
+ \gcmd{gls\-excl\-apply\-inner\-fmt\-field}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{internal-field}}
+ \desc{locally adds the field given by its \idx{internalfieldlabel}
+ \meta{internal-field} to the \idx{innerformatting} exclusion list
+ for the entry identified by \meta{entry-label}. This typically
+ means that the field value already contains the \idx{innerformatting}}
+ }
+ % \glsifapplyinnerfmtfield
+ \gcmd{gls\-if\-apply\-inner\-fmt\-field}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{internal-field}\margm{true}\margm{false}}
+ \desc{tests if the field given by its \idx{internalfieldlabel}
+ \meta{internal-field} has been added to the \idx{innerformatting}
+ exclusion list for the entry identified by \meta{entry-label}}
+ \field{seealso}{glsexclapplyinnerfmtfield}
+ }
+ % \glsxtrattrentrytextfmt
+ \gcmd{gls\-xtr\-attr\-entry\-text\-fmt}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{text}}
+ \desc{applies the command obtained from the control sequence
+ name supplied in the \catattr{innertextformat} attribute for
+ the category assigned to the entry given by \gls{glslabel}. This command isn't
+ used by default as it should rarely be needed an increases
+ complexity}
+ }
+ % \glsxtrgenentrytextfmt
+ \gcmd{gls\-xtr\-gen\-entry\-text\-fmt}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{redefined by the \idx{glslike} and \idx{glstextlike} hooks
+ to set up the \idx{innerformatting}.
+ Initialised to \gls{glsxtrdefaultentrytextfmt}}
+ }
+ % \glsxtrdefaultentrytextfmt
+ \gcmd{gls\-xtr\-default\-entry\-text\-fmt}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{text}}
+ \desc{default \idx{innerformatting}. Initialised to just do \meta{text}}
+ }
+ % \glsfmtfield
+ \gcmd{gls\-fmt\-field}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}\margm{internal-field}}
+ \desc{applies the formatting command \meta{cs} (which takes one
+ argument) to the entry's field value identified by the given
+ \idx{internalfieldlabel}, including \meta{insert} appended. Used
+ by the \idx{innerformatting} commands.
+ Note that \gls{glsfmtfield} should not be robust as it needs to
+ expand if it's inside a case-changing command}
+ }
+ % \Glsfmtfield
+ \gcmd{Gls\-fmt\-field}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}\margm{internal-field}}
+ \desc{as \gls{glsfmtfield} but uses \gls{makefirstuc} to change
+ the field value to \idx{sentencecase}}
+ }
+ % \GLSfmtfield
+ \gcmd{GLS\-fmt\-field}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}\margm{internal-field}}
+ \desc{as \gls{glsfmtfield} but changes the field value to \idx{allcaps}}
+ }
+ % \glsfmtinsert
+ \gcmd{gls\-fmt\-insert}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{a shortcut that applies \gls{glsxtrgenentrytextfmt} to
+ \gls{glsinsert} if \gls{glsinsert} isn't empty}
+ }
+ % \GLSfmtinsert
+ \gcmd{GLS\-fmt\-insert}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{as \gls{glsfmtinsert} but converts to \idx{allcaps}}
+ }
+ % \glsxtrsaveinsert
+ \gcmd{gls\-xtr\-save\-insert}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{implemented at the start of all the \idx{glstextlike}
+ commands (except the \idx{inlinefullform} commands like \gls{glsxtrfull})
+ to save the \gls{glsinsert} placeholder. By default, this sets
+ \gls{glsinsert} to empty}
+ }
+ % \glsxtrfullsaveinsert
+ \gcmd{gls\-xtr\-full\-save\-insert}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{implemented at the start of all the \idx{inlinefullform} commands
+ like \gls{glsxtrfull} to save the \gls{glsinsert} placeholder.
+ By default, this just does \gls{glsxtrsaveinsert}}
+ }
+ % \glsxtrsetlongfirstuse
+ \gcmd{gls\-xtr\-set\-long\-first\-use}
+ {
+ \providedby{\sty{glossaries} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{implemented by the \gls{glsxtrlong} set of commands to
+ assign \gls{glsxtrifwasfirstuse}}
+ }
+ % \glsxtrsetupfulldefs
+ \gcmd{gls\-xtr\-set\-up\-full\-defs}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{hook used by \gls{glsxtrfull} (and case-changing and
+ plural variations)}
+ }
+ % COMMANDS: REFERENCING ENTRIES
+ % \gls
+ \gcmdspa{gls}{%
+ \common
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{references the entry identified by \meta{entry-label}. The text
+ produced depends on whether or not this is the \idx{firstuse}
+ and whether or not the \catattr{regular} attribute has been set.
+ The \meta{insert} argument may be inserted at the end of the
+ \idx{linktext} or may be inserted at a different point (for
+ example, after the long form on \idx{firstuse} for some abbreviation
+ styles. For the first optional argument, see \idxpl{glsopt}}
+ }
+ % \Gls
+ \gcmdspa{Gls}{%
+ \common
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{gls} but converts the first character of the
+ \idx{linktext} to \idx{uppercase}\glsadd{idx.sentencecase} (for
+ the start of a sentence) using \gls{makefirstuc}}
+ }
+ % \GLS
+ \gcmdspa{GLS}{%
+ \common
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{gls} but converts the \idx{linktext} to \idx{allcaps}}
+ }
+ % \glspl
+ \gcmdspa{glspl}{%
+ \common
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{gls} but uses the relevant plural form}
+ }
+ % \Glspl
+ \gcmdspa{Glspl}{%
+ \common
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glspl} but converts the first character of the
+ \idx{linktext} to \idx{uppercase}\glsadd{idx.sentencecase} (for
+ the start of a sentence) using \gls{makefirstuc}}
+ }
+ % \GLSpl
+ \gcmdspa{GLSpl}{%
+ \common
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glspl} but converts the \idx{linktext} to \idx{allcaps}}
+ }
+ % \glsdisp
+ \gcmdspa{gls\-disp}{%
+ \providedby{\sty{glossaries} v1.19+}
+ \syntax{\oargm{options}\margm{entry-label}\margm{text}}
+ \desc{references the entry identified by \meta{entry-label} with the
+ given \meta{text} as the \idx{linktext}. This command unsets the
+ \idx{firstuseflag} (use \gls{glslink} instead, if the
+ \idx{firstuseflag} should not be altered).
+ This command is considered a \idx{glslike} command.
+ For the first optional argument, see \idxpl{glsopt}}
+ }
+ % \Glsdisp
+ \gcmdspa{Gls\-disp}{%
+ \providedby{\sty{glossaries} v4.50+}
+ \syntax{\oargm{options}\margm{entry-label}\margm{text}}
+ \desc{as \gls{glsdisp} but sets the \idx{linktext} to
+ \code{\gls{glssentencecase}\margm{text}}. This is provided to
+ allow a \idx{sentencecase} mapping in the event that \gls{glsdisp}
+ occurs at the start of content that has automated case-changing}
+ }
+ % \glslink
+ \gcmdspa{gls\-link}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\margm{text}}
+ \desc{references the entry identified by \meta{entry-label} with the
+ given \meta{text} as the \idx{linktext}. This command does not
+ alter or depend on the \idx{firstuseflag} (use \gls{glsdisp} instead, if the
+ \idx{firstuseflag} needs to be unset).
+ This command is considered a \idx{glstextlike} command.
+ For the first optional argument, see \idxpl{glsopt}}
+ }
+ % \Glslink
+ \gcmdspa{Gls\-link}{%
+ \providedby{\sty{glossaries} v4.50+}
+ \syntax{\oargm{options}\margm{entry-label}\margm{text}}
+ \desc{as \gls{glslink} but sets the \idx{linktext} to
+ \code{\gls{glssentencecase}\margm{text}}. This is provided to
+ allow a \idx{sentencecase} mapping in the event that \gls{glslink}
+ occurs at the start of content that has automated case-changing}
+ }
+ % \glstext
+ \gcmdspa{gls\-text}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{references the entry identified by \meta{entry-label}. The text
+ produced is obtained from the \gloskey{text} value.
+ The \meta{insert} argument will be inserted at the end of the
+ \idx{linktext}. This command does not alter or depend on the
+ \idx{firstuseflag}. If you have defined the entry with
+ \gls{newabbreviation} use \gls{glsxtrshort} for the short form or
+ \code{\gls{gls}\oarg{\glsopt{preunset}}}, as some
+ abbreviation styles are too complicated to work with \gls{glstext}.
+ For the first optional argument, see \idxpl{glsopt}}
+ }
+ % \Glstext
+ \gcmdspa{Gls\-text}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glstext} but converts the first character of the
+ \idx{linktext} to \idx{uppercase}\glsadd{idx.sentencecase} (for
+ the start of a sentence) using \gls{makefirstuc}.
+ If you have defined the entry with
+ \gls{newabbreviation} use \gls{Glsxtrshort} or
+ \code{\gls{Gls}\oarg{\glsopt{preunset}}} instead}
+ }
+ % \GLStext
+ \gcmdspa{GLS\-text}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glstext} but converts the \idx{linktext} to \idx{allcaps}.
+ If you have defined the entry with
+ \gls{newabbreviation} use \gls{GLSxtrshort} or
+ \code{\gls{GLS}\oarg{\glsopt{preunset}}} instead}
+ }
+ % \glsplural
+ \gcmdspa{gls\-plural}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{references the entry identified by \meta{entry-label}. The text
+ produced is obtained from the \gloskey{plural} value.
+ The \meta{insert} argument will be inserted at the end of the
+ \idx{linktext}. This command does not alter or depend on the
+ \idx{firstuseflag}. If you have defined the entry with
+ \gls{newabbreviation} use \gls{glsxtrshortpl} for the short form or
+ \code{\gls{gls}\oarg{\glsopt{preunset}}}, as some
+ abbreviation styles are too complicated to work with \gls{glsplural}.
+ For the first optional argument, see \idxpl{glsopt}}
+ }
+ % \Glsplural
+ \gcmdspa{Gls\-plural}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsplural} but converts the first character of the
+ \idx{linktext} to \idx{uppercase}\glsadd{idx.sentencecase} (for
+ the start of a sentence) using \gls{makefirstuc}.
+ If you have defined the entry with
+ \gls{newabbreviation} use \gls{Glsxtrshortpl} or
+ \code{\gls{Glspl}\oarg{\glsopt{preunset}}} instead}
+ }
+ % \GLSplural
+ \gcmdspa{GLS\-plural}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsplural} but converts the \idx{linktext} to \idx{allcaps}.
+ If you have defined the entry with
+ \gls{newabbreviation} use \gls{GLSxtrshortpl} or
+ \code{\gls{GLSpl}\oarg{\glsopt{preunset}}} instead}
+ }
+ % \glsfirst
+ \gcmdspa{gls\-first}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{references the entry identified by \meta{entry-label}. The text
+ produced is obtained from the \gloskey{first} value.
+ The \meta{insert} argument will be inserted at the end of the
+ \idx{linktext}. This command does not alter or depend on the
+ \idx{firstuseflag}. If you have defined the entry with
+ \gls{newabbreviation} use \gls{glsxtrfull}
+ for the full form or \gls{glsxtrlong} for the long form or use
+ \code{\gls{gls}\oarg{\glsopt{prereset}}}, as some
+ abbreviation styles are too complicated to work with \gls{glsfirst}.
+ For the first optional argument, see \idxpl{glsopt}}
+ }
+ % \Glsfirst
+ \gcmdspa{Gls\-first}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsfirst} but converts the first character of the
+ \idx{linktext} to \idx{uppercase}\glsadd{idx.sentencecase} (for
+ the start of a sentence) using \gls{makefirstuc}.
+ If you have defined the entry with
+ \gls{newabbreviation} use \gls{Glsxtrfull} or
+ \code{\gls{Gls}\oarg{\glsopt{prereset}}} instead}
+ }
+ % \GLSfirst
+ \gcmdspa{GLS\-first}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsfirst} but converts the \idx{linktext} to \idx{allcaps}.
+ If you have defined the entry with
+ \gls{newabbreviation} use \gls{GLSxtrfull} or
+ \code{\gls{GLS}\oarg{\glsopt{prereset}}} instead}
+ }
+ % \glsfirstplural
+ \gcmdspa{gls\-first\-plural}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{references the entry identified by \meta{entry-label}. The text
+ produced is obtained from the \gloskey{firstplural} value.
+ The \meta{insert} argument will be inserted at the end of the
+ \idx{linktext}. This command does not alter or depend on the
+ \idx{firstuseflag}. If you have defined the entry with
+ \gls{newabbreviation} use \gls{glsxtrfullpl}
+ for the full form or \gls{glsxtrlongpl} for the long form or use
+ \code{\gls{glspl}\oarg{\glsopt{prereset}}}, as some
+ abbreviation styles are too complicated to work with \gls{glsfirstplural}.
+ For the first optional argument, see \idxpl{glsopt}}
+ }
+ % \Glsfirstplural
+ \gcmdspa{Gls\-first\-plural}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsfirstplural} but converts the first character of the
+ \idx{linktext} to \idx{uppercase}\glsadd{idx.sentencecase} (for
+ the start of a sentence) using \gls{makefirstuc}.
+ If you have defined the entry with
+ \gls{newabbreviation} use \gls{Glsxtrfullpl} or
+ \code{\gls{Glspl}\oarg{\glsopt{prereset}}} instead}
+ }
+ % \GLSfirstplural
+ \gcmdspa{GLS\-first\-plural}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsfirstplural} but converts the \idx{linktext} to \idx{allcaps}.
+ If you have defined the entry with
+ \gls{newabbreviation} use \gls{GLSxtrfullpl} or
+ \code{\gls{GLSpl}\oarg{\glsopt{prereset}}} instead}
+ }
+ % \glsxtrshort
+ \gcmdspa{gls\-xtr\-short}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{references the entry identified by \meta{entry-label}. The text
+ produced is obtained from the \gloskey{short} value, formatted
+ according to the \idx{abbrvstyle} associated with the entry's \idx{category}.
+ The \meta{insert} argument will be inserted at the end of the
+ \idx{linktext}. This command does not alter or depend on the
+ \idx{firstuseflag}. For the first optional argument, see \idxpl{glsopt}}
+ }
+ % \Glsxtrshort
+ \gcmdspa{Gls\-xtr\-short}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsxtrshort} but converts the first character of the
+ \idx{linktext} to \idx{uppercase}\glsadd{idx.sentencecase} (for
+ the start of a sentence) using \gls{makefirstuc}}
+ }
+ % \GLSxtrshort
+ \gcmdspa{GLS\-xtr\-short}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsxtrshort} but converts the \idx{linktext} to \idx{allcaps}}
+ }
+ % \glsxtrshortpl
+ \gcmdspa{gls\-xtr\-shortpl}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{references the entry identified by \meta{entry-label}. The text
+ produced is obtained from the \gloskey{shortplural} value, formatted
+ according to the \idx{abbrvstyle} associated with the entry's \idx{category}.
+ The \meta{insert} argument will be inserted at the end of the
+ \idx{linktext}. This command does not alter or depend on the
+ \idx{firstuseflag}. For the first optional argument, see \idxpl{glsopt}}
+ }
+ % \Glsxtrshortpl
+ \gcmdspa{Gls\-xtr\-shortpl}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsxtrshortpl} but converts the first character of the
+ \idx{linktext} to \idx{uppercase}\glsadd{idx.sentencecase} (for
+ the start of a sentence) using \gls{makefirstuc}}
+ }
+ % \GLSxtrshortpl
+ \gcmdspa{GLS\-xtr\-shortpl}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsxtrshort} but converts the \idx{linktext} to \idx{allcaps}}
+ }
+ % \glsxtrlong
+ \gcmdspa{gls\-xtr\-long}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{references the entry identified by \meta{entry-label}. The text
+ produced is obtained from the \gloskey{long} value, formatted
+ according to the \idx{abbrvstyle} associated with the entry's \idx{category}.
+ The \meta{insert} argument will be inserted at the end of the
+ \idx{linktext}. This command does not alter or depend on the
+ \idx{firstuseflag}. For the first optional argument, see \idxpl{glsopt}}
+ }
+ % \Glsxtrlong
+ \gcmdspa{Gls\-xtr\-long}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsxtrlong} but converts the first character of the
+ \idx{linktext} to \idx{uppercase}\glsadd{idx.sentencecase} (for
+ the start of a sentence) using \gls{makefirstuc}}
+ }
+ % \GLSxtrlong
+ \gcmdspa{GLS\-xtr\-long}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsxtrlong} but converts the \idx{linktext} to \idx{allcaps}}
+ }
+ % \glsxtrlongpl
+ \gcmdspa{gls\-xtr\-long\-pl}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{references the entry identified by \meta{entry-label}. The text
+ produced is obtained from the \gloskey{longplural} value, formatted
+ according to the \idx{abbrvstyle} associated with the entry's \idx{category}.
+ The \meta{insert} argument will be inserted at the end of the
+ \idx{linktext}. This command does not alter or depend on the
+ \idx{firstuseflag}. For the first optional argument, see \idxpl{glsopt}}
+ }
+ % \Glsxtrlongpl
+ \gcmdspa{Gls\-xtr\-long\-pl}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsxtrlongpl} but converts the first character of the
+ \idx{linktext} to \idx{uppercase}\glsadd{idx.sentencecase} (for
+ the start of a sentence) using \gls{makefirstuc}}
+ }
+ % \GLSxtrlongpl
+ \gcmdspa{GLS\-xtr\-long\-pl}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsxtrlongpl} but converts the \idx{linktext} to \idx{allcaps}}
+ }
+ % \glsxtrfull
+ \gcmdspa{gls\-xtr\-full}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{references the entry identified by \meta{entry-label}. The text
+ produced is obtained from the \gloskey{short} and \gloskey{long} values, formatted
+ according to the \idx{abbrvstyle} associated with the entry's \idx{category}.
+ The \meta{insert} argument will be inserted at the end of the
+ \idx{linktext}. This command does not alter or depend on the
+ \idx{firstuseflag}. The format produced by this command may not
+ match the format produced by the \idx{firstuse} of
+ \code{\gls{gls}\margm{entry-label}}, depending on the abbreviation
+ style. For the first optional argument, see \idxpl{glsopt}}
+ }
+ % \Glsxtrfull
+ \gcmdspa{Gls\-xtr\-full}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsxtrfull} but converts the first character of the
+ \idx{linktext} to \idx{uppercase}\glsadd{idx.sentencecase} (for
+ the start of a sentence) using \gls{makefirstuc}}
+ }
+ % \GLSxtrfull
+ \gcmdspa{GLS\-xtr\-full}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsxtrfull} but converts the \idx{linktext} to \idx{allcaps}}
+ }
+ % \glsxtrfullpl
+ \gcmdspa{gls\-xtr\-fullpl}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{references the entry identified by \meta{entry-label}. The text
+ produced is obtained from the \gloskey{shortplural} and
+ \gloskey{longplural} values, formatted
+ according to the \idx{abbrvstyle} associated with the entry's \idx{category}.
+ The \meta{insert} argument will be inserted at the end of the
+ \idx{linktext}. This command does not alter or depend on the
+ \idx{firstuseflag}. The format produced by this command may not
+ match the format produced by the \idx{firstuse} of
+ \code{\gls{glspl}\margm{entry-label}}, depending on the abbreviation
+ style. For the first optional argument, see \idxpl{glsopt}}
+ }
+ % \Glsxtrfullpl
+ \gcmdspa{Gls\-xtr\-fullpl}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsxtrfullpl} but converts the first character of the
+ \idx{linktext} to \idx{uppercase}\glsadd{idx.sentencecase} (for
+ the start of a sentence) using \gls{makefirstuc}}
+ }
+ % \GLSxtrfullpl
+ \gcmdspa{GLS\-xtr\-fullpl}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsxtrfullpl} but converts the \idx{linktext} to \idx{allcaps}}
+ }
+ % \glsname
+ \gcmdspa{gls\-name}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{references the entry identified by \meta{entry-label}. The text
+ produced is obtained from the \gloskey{name} value.
+ The \meta{insert} argument will be inserted at the end of the
+ \idx{linktext}. This command does not alter or depend on the
+ \idx{firstuseflag}. For the first optional argument, see \idxpl{glsopt}.
+ Use \gls{glossentryname} within custom glossary styles
+ instead of this command}
+ }
+ % \Glsname
+ \gcmdspa{Gls\-name}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsname} but converts the \idx{linktext} to
+ \idx{sentencecase}. Use \gls{Glossentryname} within custom glossary styles
+ instead of this command}
+ }
+ % \GLSname
+ \gcmdspa{GLS\-name}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsname} but converts the \idx{linktext} to
+ \idx{allcaps}. This command is incompatible with some
+ abbreviation styles}
+ }
+ % \glsdesc
+ \gcmdspa{gls\-desc}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{references the entry identified by \meta{entry-label}. The text
+ produced is obtained from the \gloskey{description} value.
+ The \meta{insert} argument will be inserted at the end of the
+ \idx{linktext}. This command does not alter or depend on the
+ \idx{firstuseflag}. For the first optional argument, see
+ \idxpl{glsopt}. Use \gls{glossentrydesc} within custom glossary styles
+ instead of this command}
+ }
+ % \Glsdesc
+ \gcmdspa{Gls\-desc}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsdesc} but converts the
+ \idx{linktext} to \idx{sentencecase}. Use
+ \gls{Glossentrydesc} within custom glossary styles
+ instead of this command}
+ }
+ % \GLSdesc
+ \gcmdspa{GLS\-desc}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsdesc} but converts the \idx{linktext} to
+ \idx{allcaps}}
+ }
+ % \glsdescplural
+ \gcmdspa{gls\-desc\-plural}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsdesc} but for the \gloskey{descriptionplural} field}
+ }
+ % \glssymbol
+ \gcmdspa{gls\-symbol}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{references the entry identified by \meta{entry-label}. The text
+ produced is obtained from the \gloskey{symbol} value.
+ The \meta{insert} argument will be inserted at the end of the
+ \idx{linktext}. This command does not alter or depend on the
+ \idx{firstuseflag}. For the first optional argument, see
+ \idxpl{glsopt}. Use \gls{glossentrysymbol} within custom glossary styles
+ instead of this command}
+ }
+ % \Glssymbol
+ \gcmdspa{Gls\-symbol}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glssymbol} but converts the
+ \idx{linktext} to \idx{sentencecase}. Use
+ \gls{Glossentrysymbol} within custom glossary styles
+ instead of this command}
+ }
+ % \GLSsymbol
+ \gcmdspa{GLS\-symbol}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glssymbol} but converts the \idx{linktext} to
+ \idx{allcaps}}
+ }
+ % \glssymbolplural
+ \gcmdspa{gls\-symbol\-plural}{%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glssymbol} but for the \gloskey{symbolplural} field}
+ }
+ % \glsuseri
+ \gcmdspa{gls\-useri}{%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{references the entry identified by \meta{entry-label}. The text
+ produced is obtained from the \gloskey{user1} value.
+ The \meta{insert} argument will be inserted at the end of the
+ \idx{linktext}. This command does not alter or depend on the
+ \idx{firstuseflag}. For the first optional argument, see
+ \idxpl{glsopt}}
+ }
+ % \Glsuseri
+ \gcmdspa{Gls\-useri}{%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsuseri} but converts the
+ \idx{linktext} to \idx{sentencecase}}
+ }
+ % \GLSuseri
+ \gcmdspa{GLS\-useri}{%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsuseri} but converts the \idx{linktext} to
+ \idx{allcaps}}
+ }
+ % \glsuserii
+ \gcmdspa{gls\-userii}{%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{references the entry identified by \meta{entry-label}. The text
+ produced is obtained from the \gloskey{user2} value.
+ The \meta{insert} argument will be inserted at the end of the
+ \idx{linktext}. This command does not alter or depend on the
+ \idx{firstuseflag}. For the first optional argument, see
+ \idxpl{glsopt}}
+ }
+ % \Glsuserii
+ \gcmdspa{Gls\-userii}{%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsuserii} but converts the
+ \idx{linktext} to \idx{sentencecase}}
+ }
+ % \GLSuserii
+ \gcmdspa{GLS\-userii}{%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsuserii} but converts the \idx{linktext} to
+ \idx{allcaps}}
+ }
+ % \glsuseriii
+ \gcmdspa{gls\-useriii}{%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{references the entry identified by \meta{entry-label}. The text
+ produced is obtained from the \gloskey{user3} value.
+ The \meta{insert} argument will be inserted at the end of the
+ \idx{linktext}. This command does not alter or depend on the
+ \idx{firstuseflag}. For the first optional argument, see
+ \idxpl{glsopt}}
+ }
+ % \Glsuseriii
+ \gcmdspa{Gls\-useriii}{%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsuseriii} but converts the
+ \idx{linktext} to \idx{sentencecase}}
+ }
+ % \GLSuseriii
+ \gcmdspa{GLS\-useriii}{%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsuseriii} but converts the \idx{linktext} to
+ \idx{allcaps}}
+ }
+ % \glsuseriv
+ \gcmdspa{gls\-useriv}{%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{references the entry identified by \meta{entry-label}. The text
+ produced is obtained from the \gloskey{user4} value.
+ The \meta{insert} argument will be inserted at the end of the
+ \idx{linktext}. This command does not alter or depend on the
+ \idx{firstuseflag}. For the first optional argument, see
+ \idxpl{glsopt}}
+ }
+ % \Glsuseriv
+ \gcmdspa{Gls\-useriv}{%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsuseriv} but converts the
+ \idx{linktext} to \idx{sentencecase}}
+ }
+ % \GLSuseriv
+ \gcmdspa{GLS\-useriv}{%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsuseriv} but converts the \idx{linktext} to
+ \idx{allcaps}}
+ }
+ % \glsuserv
+ \gcmdspa{gls\-userv}{%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{references the entry identified by \meta{entry-label}. The text
+ produced is obtained from the \gloskey{user5} value.
+ The \meta{insert} argument will be inserted at the end of the
+ \idx{linktext}. This command does not alter or depend on the
+ \idx{firstuseflag}. For the first optional argument, see
+ \idxpl{glsopt}}
+ }
+ % \Glsuserv
+ \gcmdspa{Gls\-userv}{%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsuserv} but converts the
+ \idx{linktext} to \idx{sentencecase}}
+ }
+ % \GLSuserv
+ \gcmdspa{GLS\-userv}{%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsuserv} but converts the \idx{linktext} to
+ \idx{allcaps}}
+ }
+ % \glsuservi
+ \gcmdspa{gls\-uservi}{%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{references the entry identified by \meta{entry-label}. The text
+ produced is obtained from the \gloskey{user6} value.
+ The \meta{insert} argument will be inserted at the end of the
+ \idx{linktext}. This command does not alter or depend on the
+ \idx{firstuseflag}. For the first optional argument, see
+ \idxpl{glsopt}}
+ }
+ % \Glsuservi
+ \gcmdspa{Gls\-uservi}{%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsuservi} but converts the
+ \idx{linktext} to \idx{sentencecase}}
+ }
+ % \GLSuservi
+ \gcmdspa{GLS\-uservi}{%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsuservi} but converts the \idx{linktext} to
+ \idx{allcaps}}
+ }
+ % \glshyperlink
+ \gcmd{gls\-hyper\-link}
+ {
+ \providedby{\sty{glossaries} v1.17+}
+ \syntax{\oargm{text}\margm{entry-label}}
+ \desc{creates a hyperlink to the given entry with the hyperlink
+ text provided in the optional argument. If omitted, the default is
+ \code{\gls{glsentrytext}\margm{entry-label}}}
+ }
+ % \acrshort
+ \gcmdspa{acr\-short}{%
+ \banned
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{displays the short form of an acronym. Only for use with
+ the base \sty{glossaries} package's acronym mechanism. This
+ command is not compatible with \gls{newabbreviation}}
+ }
+ % \acrshortpl
+ \gcmdspa{acr\-shortpl}{%
+ \banned
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{displays the plural short form of an acronym. Only for use with
+ the base \sty{glossaries} package's acronym mechanism. This
+ command is not compatible with \gls{newabbreviation}}
+ }
+ % \Acrshort
+ \gcmdspa{Acr\-short}{%
+ \banned
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{acrshort} but \idx{sentencecase}}
+ }
+ % \Acrshortpl
+ \gcmdspa{Acr\-shortpl}{%
+ \banned
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{acrshort} but \idx{sentencecase}}
+ }
+ % \acrlong
+ \gcmdspa{acr\-long}{%
+ \banned
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{displays the long form of an acronym. Only for use with
+ the base \sty{glossaries} package's acronym mechanism. This
+ command is not compatible with \gls{newabbreviation}}
+ }
+ % \acrlongpl
+ \gcmdspa{acr\-longpl}{%
+ \banned
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{displays the plural long form of an acronym. Only for use with
+ the base \sty{glossaries} package's acronym mechanism. This
+ command is not compatible with \gls{newabbreviation}}
+ }
+ % \Acrlong
+ \gcmdspa{Acr\-long}{%
+ \banned
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{acrlong} but \idx{sentencecase}}
+ }
+ % \Acrlongpl
+ \gcmdspa{Acr\-longpl}{%
+ \banned
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{acrlong} but \idx{sentencecase}}
+ }
+ % \acrfull
+ \gcmdspa{acr\-full}{%
+ \banned
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{displays the full form of an acronym. Only for use with
+ the base \sty{glossaries} package's acronym mechanism. This
+ command is not compatible with \gls{newabbreviation}}
+ }
+ % \acrfullpl
+ \gcmdspa{acr\-fullpl}{%
+ \banned
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{displays the plural full form of an acronym. Only for use with
+ the base \sty{glossaries} package's acronym mechanism. This
+ command is not compatible with \gls{newabbreviation}}
+ }
+ % \Acrfull
+ \gcmdspa{Acr\-full}{%
+ \banned
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{acrfull} but \idx{sentencecase}}
+ }
+ % \Acrfullpl
+ \gcmdspa{Acr\-full\-pl}{%
+ \banned
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{acrfullpl} but \idx{sentencecase}}
+ }
+ % \ac
+ \gcmdspa{ac}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{cgls} or \gls{gls} defined by the
+ \opteqvalref{shortcuts}{ac} or \opteqvalref{shortcuts}{acronyms} package
+ option, respectively}
+ }
+ % \Ac
+ \gcmdspa{Ac}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{cGls} or \gls{Gls} defined by the
+ \opteqvalref{shortcuts}{ac} or \opteqvalref{shortcuts}{acronyms} package
+ option, respectively}
+ }
+ % \AC
+ \gcmdspa{AC}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{cGLS} defined by the
+ \opteqvalref{shortcuts}{ac} package option}
+ }
+ % \acp
+ \gcmdspa{acp}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{cglspl} or \gls{glspl} defined by the
+ \opteqvalref{shortcuts}{ac} or \opteqvalref{shortcuts}{acronyms} package
+ option, respectively}
+ }
+ % \Acp
+ \gcmdspa{Acp}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{cGlspl} or \gls{glspl} defined by the
+ \opteqvalref{shortcuts}{ac} or \opteqvalref{shortcuts}{acronyms} package
+ option, respectively}
+ }
+ % \ACP
+ \gcmdspa{ACP}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{cGLSpl} defined by the
+ \opteqvalref{shortcuts}{ac} package option}
+ }
+ % \acs
+ \gcmdspa{acs}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{glsxtrshort} or \gls{acrshort} defined by the
+ \opteqvalref{shortcuts}{ac} or \opteqvalref{shortcuts}{acronyms} package
+ option, respectively}
+ }
+ % \Acs
+ \gcmdspa{Acs}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{Glsxtrshort} or \gls{Acrshort} defined by the
+ \opteqvalref{shortcuts}{ac} or \opteqvalref{shortcuts}{acronyms} package
+ option, respectively}
+ }
+ \gcmdspa{ACS}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{GLSxtrshort} defined by the
+ \opteqvalref{shortcuts}{ac} package option}
+ }
+ % \acsp
+ \gcmdspa{acsp}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{glsxtrshortpl} or \gls{acrshortpl} defined by the
+ \opteqvalref{shortcuts}{ac} or \opteqvalref{shortcuts}{acronyms} package
+ option, respectively}
+ }
+ % \Acsp
+ \gcmdspa{Acsp}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{Glsxtrshortpl} or \gls{Acrshortpl} defined by the
+ \opteqvalref{shortcuts}{ac} or \opteqvalref{shortcuts}{acronyms} package
+ option, respectively}
+ }
+ % \ACSP
+ \gcmdspa{ACSP}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{GLSxtrshortpl} defined by the
+ \opteqvalref{shortcuts}{ac} package option}
+ }
+ % \acl
+ \gcmdspa{acl}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{glsxtrlong} or \gls{acrlong} defined by the
+ \opteqvalref{shortcuts}{ac} or \opteqvalref{shortcuts}{acronyms} package
+ option, respectively}
+ }
+ % \aclp
+ \gcmdspa{aclp}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{glsxtrlongpl} or \gls{acrlongpl} defined by the
+ \opteqvalref{shortcuts}{ac} or \opteqvalref{shortcuts}{acronyms} package
+ option, respectively}
+ }
+ % \Acl
+ \gcmdspa{Acl}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{Glsxtrlong} or \gls{Acrlong} defined by the
+ \opteqvalref{shortcuts}{ac} or \opteqvalref{shortcuts}{acronyms} package
+ option, respectively}
+ }
+ % \ACL
+ \gcmdspa{ACL}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{GLSxtrlong} defined by the
+ \opteqvalref{shortcuts}{ac} package option}
+ }
+ % \Aclp
+ \gcmdspa{Aclp}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{Glsxtrlongpl} or \gls{Acrlongpl} defined by the
+ \opteqvalref{shortcuts}{ac} or \opteqvalref{shortcuts}{acronyms} package
+ option, respectively}
+ }
+ % \ACLP
+ \gcmdspa{ACLP}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{GLSxtrlongpl} defined by the
+ \opteqvalref{shortcuts}{ac} package option}
+ }
+ % \acf
+ \gcmdspa{acf}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{glsxtrfull} or \gls{acrfull} defined by the
+ \opteqvalref{shortcuts}{ac} or \opteqvalref{shortcuts}{acronyms} package
+ option, respectively}
+ }
+ % \acfp
+ \gcmdspa{acfp}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{glsxtrfullpl} or \gls{acrfullpl} defined by the
+ \opteqvalref{shortcuts}{ac} or \opteqvalref{shortcuts}{acronyms} package
+ option, respectively}
+ }
+ % \Acf
+ \gcmdspa{Acf}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{Glsxtrfull} or \gls{Acrfull} defined by the
+ \opteqvalref{shortcuts}{ac} or \opteqvalref{shortcuts}{acronyms} package
+ option, respectively}
+ }
+ % \ACF
+ \gcmdspa{ACF}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{GLSxtrfull} defined by the
+ \opteqvalref{shortcuts}{ac} package option}
+ }
+ % \Acfp
+ \gcmdspa{Acfp}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{Glsxtrfullpl} or \gls{Acrfullpl} defined by the
+ \opteqvalref{shortcuts}{ac} or \opteqvalref{shortcuts}{acronyms} package
+ option, respectively}
+ }
+ % \ACFP
+ \gcmdspa{ACFP}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{GLSxtrfullpl} defined by the
+ \opteqvalref{shortcuts}{ac} package option}
+ }
+ % \ab
+ \gcmdspa{ab}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{cgls} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \Ab
+ \gcmdspa{Ab}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{cGls} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \AB
+ \gcmdspa{AB}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{cGLS} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \abp
+ \gcmdspa{abp}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{cglspl} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \Abp
+ \gcmdspa{Abp}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{cGlspl} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \ABP
+ \gcmdspa{ABP}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{cGLSpl} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \as
+ \gcmdspa{as}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{glsxtrshort} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \As
+ \gcmdspa{As}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{Glsxtrshort} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \AS
+ \gcmdspa{AS}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{GLSxtrshort} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \asp
+ \gcmdspa{asp}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{glsxtrshortpl} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \Asp
+ \gcmdspa{Asp}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{Glsxtrshortpl} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \ASP
+ \gcmdspa{ASP}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{GLSxtrshortpl} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \al
+ \gcmdspa{al}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{glsxtrlong} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \Al
+ \gcmdspa{Al}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{Glsxtrlong} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \AL
+ \gcmdspa{AL}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{GLSxtrlong} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \alp
+ \gcmdspa{alp}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{glsxtrlongpl} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \Alp
+ \gcmdspa{Alp}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{Glsxtrlongpl} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \ALP
+ \gcmdspa{ALP}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{GLSxtrlongpl} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \af
+ \gcmdspa{af}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{glsxtrfull} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \Af
+ \gcmdspa{Af}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{Glsxtrfull} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \AF
+ \gcmdspa{AF}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{Glsxtrfull} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \afp
+ \gcmdspa{afp}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{glsxtrfullpl} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \Afp
+ \gcmdspa{Afp}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{Glsxtrfullpl} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \AFP
+ \gcmdspa{AFP}%
+ {%
+ \syntax{\margm{options}\margm{entry-label}\margm{inset}}
+ \desc{a synonym for \gls{GLSxtrfullpl} defined by the
+ \opteqvalref{shortcuts}{abbreviations} package option}
+ }
+ % \glsentrytype
+ \gcmd{gls\-entry\-type}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}}
+ \desc{simply expands to the value of the \gloskey{type} key.
+ Does nothing if the entry hasn't been defined}
+ }
+ % \glsentryname
+ \gcmd{gls\-entry\-name}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}}
+ \desc{simply expands to the value of the \gloskey{name} key.
+ Does nothing if the entry hasn't been defined. May be used in
+ expandable contexts provided that the \gloskey{name} key doesn't
+ contain any fragile commands}
+ }
+ % \Glsentryname
+ \gcmd{Gls\-entry\-name}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}}
+ \desc{partially robust command that displays the value of the
+ \gloskey{name} \idx{field} with \idx{sentencecase} applied.
+ As from \sty{glossaries} v4.50, this command
+ can expand in PDF bookmarks. Outside of PDF bookmarks it will
+ expand to a robust internal command}
+ }
+ % \glsentryparent
+ \gcmd{gls\-entry\-parent}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}}
+ \desc{expands to the value of the \gloskey{parent} \idx{field}.
+ Expands to nothing if the \gloskey{parent} \idx{field} hasn't been set
+ and expands to \gls{relax} if the entry hasn't been defined}
+ }
+ % \glsentrytext
+ \gcmd{gls\-entry\-text}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}}
+ \desc{simply expands to the value of the \gloskey{text} \idx{field}.
+ Does nothing if the entry hasn't been defined. May be used in
+ expandable contexts provided that the \gloskey{text} \idx{field} doesn't
+ contain any fragile commands}
+ }
+ % \Glsentrytext
+ \gcmd{Gls\-entry\-text}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}}
+ \desc{partially robust command that displays the value of the
+ \gloskey{text} \idx{field} with \idx{sentencecase} applied.
+ As from \sty{glossaries} v4.50, this command
+ can expand in PDF bookmarks. Outside of PDF bookmarks it will
+ expand to a robust internal command}
+ }
+ % \glsentryplural
+ \gcmd{gls\-entry\-plural}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}}
+ \desc{simply expands to the value of the \gloskey{plural} \idx{field}.
+ Does nothing if the entry hasn't been defined. May be used in
+ expandable contexts provided that the \gloskey{plural} \idx{field} doesn't
+ contain any fragile commands}
+ }
+ % \Glsentryplural
+ \gcmd{Gls\-entry\-plural}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}}
+ \desc{partially robust command that displays the value of the
+ \gloskey{plural} \idx{field} with \idx{sentencecase} applied.
+ As from \sty{glossaries} v4.50, this command
+ can expand in PDF bookmarks. Outside of PDF bookmarks it will
+ expand to a robust internal command}
+ }
+ % \glsentryfirst
+ \gcmd{gls\-entry\-first}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}}
+ \desc{simply expands to the value of the \gloskey{first} \idx{field}.
+ Does nothing if the entry hasn't been defined. May be used in
+ expandable contexts provided that the \gloskey{first} \idx{field} doesn't
+ contain any fragile commands}
+ }
+ % \Glsentryfirst
+ \gcmd{Gls\-entry\-first}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}}
+ \desc{partially robust command that displays the value of the
+ \gloskey{first} \idx{field} with the first letter converted to
+ \idx{uppercase}. As from \sty{glossaries} v4.50, this command
+ can expand in PDF bookmarks. Outside of PDF bookmarks it will
+ expand to a robust internal command}
+ }
+ % \glsentryfirstplural
+ \gcmd{gls\-entry\-first\-plural}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}}
+ \desc{simply expands to the value of the \gloskey{firstplural} \idx{field}.
+ Does nothing if the entry hasn't been defined. May be used in
+ expandable contexts provided that the \gloskey{firstplural} \idx{field} doesn't
+ contain any fragile commands}
+ }
+ % \Glsentryfirstplural
+ \gcmd{Gls\-entry\-first\-plural}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}}
+ \desc{partially robust command that displays the value of the
+ \gloskey{firstplural} \idx{field} with \idx{sentencecase}
+ applied. As from \sty{glossaries} v4.50, this command
+ can expand in PDF bookmarks. Outside of PDF bookmarks it will
+ expand to a robust internal command}
+ }
+ % \glsentrydesc
+ \gcmd{gls\-entry\-desc}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}}
+ \desc{simply expands to the value of the \gloskey{description} \idx{field}.
+ Does nothing if the entry hasn't been defined. May be used in
+ expandable contexts provided that the \gloskey{description} \idx{field} doesn't
+ contain any fragile commands}
+ }
+ % \Glsentrydesc
+ \gcmd{Gls\-entry\-desc}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}}
+ \desc{partially robust command that displays the value of the
+ \gloskey{description} \idx{field} with \idx{sentencecase}
+ applied. As from \sty{glossaries} v4.50, this command
+ can expand in PDF bookmarks. Outside of PDF bookmarks it will
+ expand to a robust internal command}
+ }
+ % \glsentrydescplural
+ \gcmd{gls\-entry\-desc\-plural}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}}
+ \desc{simply expands to the value of the \gloskey{descriptionplural}
+ \idx{field}. Does nothing if the entry hasn't been defined.
+ May be used in expandable contexts provided that the
+ \gloskey{descriptionplural} \idx{field} doesn't contain any fragile commands}
+ }
+ % \glsentryshort
+ \gcmd{gls\-entry\-short}
+ {%
+ \providedby{\sty{glossaries} v3.0+}
+ \syntax{\margm{entry-label}}
+ \desc{simply expands to the value of the \gloskey{short} \idx{field}.
+ Does nothing if the entry hasn't been defined. May be used in
+ expandable contexts provided that the \gloskey{short} \idx{field} doesn't
+ contain any fragile commands}
+ }
+ % \glsentryshortpl
+ \gcmd{gls\-entry\-short\-pl}
+ {%
+ \providedby{\sty{glossaries} v3.0+}
+ \syntax{\margm{entry-label}}
+ \desc{simply expands to the value of the \gloskey{shortplural} \idx{field}.
+ Does nothing if the entry hasn't been defined. May be used in
+ expandable contexts provided that the \gloskey{shortplural} \idx{field} doesn't
+ contain any fragile commands}
+ }
+ % \glsentrylong
+ \gcmd{gls\-entry\-long}
+ {%
+ \providedby{\sty{glossaries} v3.0+}
+ \syntax{\margm{entry-label}}
+ \desc{simply expands to the value of the \gloskey{long} \idx{field}.
+ Does nothing if the entry hasn't been defined. May be used in
+ expandable contexts provided that the \gloskey{long} \idx{field} doesn't
+ contain any fragile commands}
+ }
+ % \glsentrylongpl
+ \gcmd{gls\-entry\-long\-pl}
+ {%
+ \providedby{\sty{glossaries} v3.0+}
+ \syntax{\margm{entry-label}}
+ \desc{simply expands to the value of the \gloskey{longplural} \idx{field}.
+ Does nothing if the entry hasn't been defined. May be used in
+ expandable contexts provided that the \gloskey{longplural} \idx{field} doesn't
+ contain any fragile commands}
+ }
+ % \Glsentryshort
+ \gcmd{Gls\-entry\-short}
+ {%
+ \providedby{\sty{glossaries} v3.0+}
+ \syntax{\margm{entry-label}}
+ \desc{displays the value of the \gloskey{short} \idx{field} with
+ \idx{sentencecase} applied.
+ Does nothing if the entry hasn't been defined.
+ As from \sty{glossaries} v4.50, this command
+ can expand in PDF bookmarks. Outside of PDF bookmarks it will
+ expand to a robust internal command}
+ }
+ % \Glsentrylong
+ \gcmd{Gls\-entry\-long}
+ {%
+ \providedby{\sty{glossaries} v3.0+}
+ \syntax{\margm{entry-label}}
+ \desc{displays the value of the \gloskey{long} \idx{field} with
+ \idx{sentencecase} applied.
+ Does nothing if the entry hasn't been defined.
+ As from \sty{glossaries} v4.50, this command
+ can expand in PDF bookmarks. Outside of PDF bookmarks it will
+ expand to a robust internal command}
+ }
+ % \Glsentryshortpl
+ \gcmd{Gls\-entry\-short\-pl}
+ {%
+ \providedby{\sty{glossaries} v3.0+}
+ \syntax{\margm{entry-label}}
+ \desc{displays the value of the \gloskey{shortplural} \idx{field} with
+ \idx{sentencecase} applied.
+ Does nothing if the entry hasn't been defined. As from \sty{glossaries} v4.50, this command
+ can expand in PDF bookmarks. Outside of PDF bookmarks it will
+ expand to a robust internal command}
+ }
+ % \Glsentrylong
+ \gcmd{Gls\-entry\-long\-pl}
+ {%
+ \providedby{\sty{glossaries} v3.0+}
+ \syntax{\margm{entry-label}}
+ \desc{displays the value of the \gloskey{longplural} \idx{field} with
+ \idx{sentencecase} applied.
+ Does nothing if the entry hasn't been defined. As from \sty{glossaries} v4.50, this command
+ can expand in PDF bookmarks. Outside of PDF bookmarks it will
+ expand to a robust internal command}
+ }
+ % \glsentrysymbol
+ \gcmd{gls\-entry\-symbol}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}}
+ \desc{simply expands to the value of the \gloskey{symbol} \idx{field}.
+ Does nothing if the entry hasn't been defined. May be used in
+ expandable contexts provided that the \gloskey{symbol} \idx{field} doesn't
+ contain any fragile commands}
+ }
+ % \Glsentrysymbol
+ \gcmd{Gls\-entry\-symbol}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}}
+ \desc{partially robust command that displays the value of the
+ \gloskey{symbol} \idx{field} with \idx{sentencecase} applied.
+ As from \sty{glossaries} v4.50, this command
+ can expand in PDF bookmarks. Outside of PDF bookmarks it will
+ expand to a robust internal command}
+ }
+ % \glsentrysymbolplural
+ \gcmd{gls\-entry\-symbol\-plural}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}}
+ \desc{simply expands to the value of the \gloskey{symbolplural} \idx{field}.
+ Does nothing if the entry hasn't been defined. May be used in
+ expandable contexts provided that the \gloskey{symbolplural} \idx{field} doesn't
+ contain any fragile commands}
+ }
+ % \glsentryuseri
+ \gcmd{gls\-entry\-useri}
+ {%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\margm{entry-label}}
+ \desc{simply expands to the value of the \gloskey{user1} \idx{field}.
+ Does nothing if the entry hasn't been defined. May be used in
+ expandable contexts provided that the \gloskey{user1} \idx{field} doesn't
+ contain any fragile commands}
+ }
+ % \Glsentryuseri
+ \gcmd{Gls\-entry\-useri}
+ {%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\margm{entry-label}}
+ \desc{partially robust command that displays the value of the
+ \gloskey{user1} \idx{field} with \idx{sentencecase} applied.
+ As from \sty{glossaries} v4.50, this command
+ can expand in PDF bookmarks. Outside of PDF bookmarks it will
+ expand to a robust internal command}
+ }
+ % \glsentryuserii
+ \gcmd{gls\-entry\-user\-ii}
+ {%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\margm{entry-label}}
+ \desc{simply expands to the value of the \gloskey{user2} \idx{field}.
+ Does nothing if the entry hasn't been defined. May be used in
+ expandable contexts provided that the \gloskey{user2} \idx{field} doesn't
+ contain any fragile commands}
+ }
+ % \Glsentryuserii
+ \gcmd{Gls\-entry\-user\-ii}
+ {%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\margm{entry-label}}
+ \desc{partially robust command that displays the value of the
+ \gloskey{user2} \idx{field} with \idx{sentencecase} applied.
+ As from \sty{glossaries} v4.50, this command
+ can expand in PDF bookmarks. Outside of PDF bookmarks it will
+ expand to a robust internal command}
+ }
+ % \glsentryuseriii
+ \gcmd{gls\-entry\-user\-iii}
+ {%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\margm{entry-label}}
+ \desc{simply expands to the value of the \gloskey{user3} \idx{field}.
+ Does nothing if the entry hasn't been defined. May be used in
+ expandable contexts provided that the \gloskey{user3} \idx{field} doesn't
+ contain any fragile commands}
+ }
+ % \Glsentryuseriii
+ \gcmd{Gls\-entry\-user\-iii}
+ {%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\margm{entry-label}}
+ \desc{partially robust command that displays the value of the
+ \gloskey{user3} \idx{field} with \idx{sentencecase} applied.
+ As from \sty{glossaries} v4.50, this command
+ can expand in PDF bookmarks. Outside of PDF bookmarks it will
+ expand to a robust internal command}
+ }
+ % \glsentryuseriv
+ \gcmd{gls\-entry\-user\-iv}
+ {%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\margm{entry-label}}
+ \desc{simply expands to the value of the \gloskey{user4} \idx{field}.
+ Does nothing if the entry hasn't been defined. May be used in
+ expandable contexts provided that the \gloskey{user4} \idx{field} doesn't
+ contain any fragile commands}
+ }
+ % \Glsentryuseriv
+ \gcmd{Gls\-entry\-user\-iv}
+ {%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\margm{entry-label}}
+ \desc{partially robust command that displays the value of the
+ \gloskey{user4} \idx{field} with \idx{sentencecase} applied.
+ As from \sty{glossaries} v4.50, this command
+ can expand in PDF bookmarks. Outside of PDF bookmarks it will
+ expand to a robust internal command}
+ }
+ % \glsentryuserv
+ \gcmd{gls\-entry\-user\-v}
+ {%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\margm{entry-label}}
+ \desc{simply expands to the value of the \gloskey{user5} \idx{field}.
+ Does nothing if the entry hasn't been defined. May be used in
+ expandable contexts provided that the \gloskey{user5} \idx{field} doesn't
+ contain any fragile commands}
+ }
+ % \Glsentryuserv
+ \gcmd{Gls\-entry\-user\-v}
+ {%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\margm{entry-label}}
+ \desc{partially robust command that displays the value of the
+ \gloskey{user5} \idx{field} with \idx{sentencecase} applied.
+ As from \sty{glossaries} v4.50, this command
+ can expand in PDF bookmarks. Outside of PDF bookmarks it will
+ expand to a robust internal command}
+ }
+ % \glsentryuservi
+ \gcmd{gls\-entry\-user\-vi}
+ {%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\margm{entry-label}}
+ \desc{simply expands to the value of the \gloskey{user6} \idx{field}.
+ Does nothing if the entry hasn't been defined. May be used in
+ expandable contexts provided that the \gloskey{user6} \idx{field} doesn't
+ contain any fragile commands}
+ }
+ % \Glsentryuservi
+ \gcmd{Gls\-entry\-user\-vi}
+ {%
+ \providedby{\sty{glossaries} v2.04+}
+ \syntax{\margm{entry-label}}
+ \desc{partially robust command that displays the value of the
+ \gloskey{user6} \idx{field} with \idx{sentencecase} applied.
+ As from \sty{glossaries} v4.50, this command
+ can expand in PDF bookmarks. Outside of PDF bookmarks it will
+ expand to a robust internal command}
+ }
+ % \glsxtrhiername
+ \gcmd{gls\-xtr\-hier\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.37+}
+ \syntax{\margm{entry-label}}
+ \desc{displays the entry's hierarchical name}
+ }
+ % \Glsxtrhiername
+ \gcmd{Gls\-xtr\-hier\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.37+}
+ \syntax{\margm{entry-label}}
+ \desc{displays the entry's hierarchical name using
+ \idx{sentencecase}}
+ }
+ % \GlsXtrhiername
+ \gcmd{Gls\-Xtr\-hier\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.37+}
+ \syntax{\margm{entry-label}}
+ \desc{displays the entry's hierarchical name where each element
+ name has its first character converted to \idx{uppercase}}
+ }
+ % \GLSxtrhiername
+ \gcmd{GLS\-xtr\-hier\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.37+}
+ \syntax{\margm{entry-label}}
+ \desc{displays the entry's hierarchical name where the first
+ name is converted to \idx{uppercase}}
+ }
+ % \GLSXTRhiername
+ \gcmd{GLS\-XTR\-hier\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.37+}
+ \syntax{\margm{entry-label}}
+ \desc{displays the entry's hierarchical name where each
+ name is converted to \idx{uppercase}}
+ }
+ % \glsxtrhiernamesep
+ \gcmd{gls\-xtr\-hier\-name\-sep}
+ {
+ \providedby{\sty{glossaries-extra} v1.37+}
+ \desc{separator used by commands like \gls{glsxtrhiername}}
+ }
+ % \GlsXtrForeignText
+ \gcmd{Gls\-Xtr\-Foreign\-Text}
+ {%
+ \providedby{\sty{glossaries-extra} v1.32+}
+ \syntax{\margm{entry-label}\margm{text}}
+ \desc{If the entry given by \meta{entry-label} has the field identified by
+ \gls{GlsXtrForeignTextField} then \meta{text} will be
+ encapsulated according to the language tag stored in that
+ field (using \sty{tracklang}['s] interface)}
+ }
+ % \GlsXtrForeignTextField
+ \gcmd{Gls\-Xtr\-Foreign\-Text\-Field}
+ {%
+ \providedby{\sty{glossaries-extra} v1.32+}
+ \desc{expands to the \idx{internalfieldlabel} used by
+ \gls{GlsXtrForeignText}}
+ }
+ % \glsxtrfmt
+ \gcmd{gls\-xtr\-fmt}{%
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\oargm{options}\margm{entry-label}\margm{text}}
+ \desc{behaves like
+\code{\gls{glslink}\oargm{options}\margm{entry-label}\marg{\cmd{\meta{csname}}\margm{text}\meta{insert}}}
+ where the control sequence name \meta{csname} is obtained from the
+ field given by \gls{GlsXtrFmtField}. The actual format of the
+ \idx{linktext} is governed by \gls{glsxtrfmtdisplay}}
+ }
+ % \glsxtrfmt*
+ \gcmd{gls\-xtr\-fmt*}{%
+ \providedby{\sty{glossaries-extra} v1.23+}
+ \syntax{\oargm{options}\margm{entry-label}\margm{text}\oargm{insert}}
+ \desc{as the unstarred version \gls{glsxtrfmt} but accepts the
+final \meta{insert} option}
+ }
+ % \Glsxtrfmt
+ \gcmd{Gls\-xtr\-fmt}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\oargm{options}\margm{entry-label}\margm{text}}
+ \desc{as \gls{glsxtrfmt} but applies a \idx{sentencecase} change
+ to \meta{text}}
+ }
+ % \Glsxtrfmt*
+ \gcmd{Gls\-xtr\-fmt*}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\oargm{options}\margm{entry-label}\margm{text}\oargm{insert}}
+ \desc{as \gls{glsxtrfmt*} but applies a \idx{sentencecase} change
+ to \meta{text}}
+ }
+ % \glsxtrfmtdisplay
+ \gcmd{gls\-xtr\-fmt\-display}{%
+ \providedby{\sty{glossaries-extra} v1.23+}
+ \syntax{\margm{csname}\margm{text}\margm{insert}}
+ \desc{formats the \idx{linktext} used in \gls{glsxtrfmt}}
+ }
+ % \GlsXtrFmtDefaultOptions
+ \gcmd{Gls\-Xtr\-Fmt\-Default\-Options}
+ {%
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \initval{noindex}
+ \desc{expands to the default options for \gls{glsxtrfmt}}
+ }
+ % \GlsXtrFmtField
+ \gcmd{Gls\-Xtr\-Fmt\-Field}{%
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \initval{useri}
+ \desc{expands to the name of the \idxc{internalfieldlabel} used by \gls{glsxtrfmt}}
+ }
+ % \glsxtrentryfmt
+ \gcmd{gls\-xtr\-entry\-fmt}{%
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{text}}
+ \desc{does \code{\cmd{\meta{csname}}\margm{text}}
+ where the control sequence name \meta{csname} is obtained from the
+ field given by \gls{GlsXtrFmtField}. If \sty{hyperref} has been loaded and
+ this command will expand to \gls{glsxtrpdfentryfmt}\margm{entry-label}\margm{text}
+ in a PDF bookmark}
+ }
+ % \Glsxtrentryfmt
+ \gcmd{Gls\-xtr\-entry\-fmt}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{text}}
+ \desc{as \gls{glsxtrentryfmt} but converts \meta{text} to
+ \idx{sentencecase}}
+ }
+ % \glsxtrpdfentryfmt
+ \gcmd{gls\-xtr\-pdf\-entry\-fmt}{%
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}\margm{text}}
+ \desc{just does \meta{text}}
+ }
+ % \Glsxtrpdfentryfmt
+ \gcmd{Gls\-xtr\-pdf\-entry\-fmt}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{text}}
+ \desc{does \code{\gls{MFUsentencecase}\margm{text}}}
+ }
+ % \setupglslink
+ \gcmd{setup\-gls\-link}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{options}}
+ \desc{set the default \idxpl{glsopt}}
+ \field{seealso}{setupglsadd}
+ }
+ % \setupglsadd
+ \gcmd{setup\-gls\-add}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{options}}
+ \desc{set the default options for \gls{glsadd}}
+ \field{seealso}{setupglslink}
+ }
+ % all \gls... options
+ \gidx{glsopt}{\name{{}\csfmt{gls}-like and {}\csfmt{glstext}-like options}%
+ \common
+ \field{text}{\csfmt{glslink} option}%
+ \desc{most (but not all) of these options can be used in the optional argument
+ of all the \idx{glslike}, \idx{glstextlike} and \gls{glsadd} commands}
+ }
+ % format
+ \gglsopt{format}%
+ {%
+ \common
+ \providedby{\sty{glossaries}}
+ \syntax{\meta{cs-name}}
+ \desc{the control sequence name (without the leading backslash)
+ that should be used to \idxc{locationencap}{encapsulate} the \idx{entrylocation}}%
+ }%
+ % counter
+ \gglsopt{counter}%
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\meta{counter-name}}
+ \desc{the \idx{locationcounter}}%
+ }%
+ % local
+ \gglsopt{local}%
+ {%
+ \providedby{\sty{glossaries} v3.04+}
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \desc{if true use \gls{glslocalunset} to unset the
+ \idx{firstuseflag}, otherwise use \gls{glsunset} (only applies
+ to \idx{glslike} commands)}%
+ }%
+ % postunset
+ \gglsopt{post\-unset}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\meta{value}}
+ \initval{global}
+ \defval{global}
+ \desc{determines whether or not to unset the \idx{firstuseflag}
+ after the \idx{linktext}. The value may be one of:
+ \code{global}, \code{local} or \code{none}
+ (only applies to \idx{glslike} commands)}%
+ }%
+ % prefix
+ \gglsopt{prefix}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.31+}
+ \syntax{\meta{link-prefix}}
+ \desc{the prefix to use for the entry's hyperlink target}%
+ }%
+ % textformat
+ \gglsopt{text\-format}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.30+}
+ \syntax{\meta{csname}}
+ \desc{the name of the control sequence to use instead of \gls{glstextformat}
+to encapsulate the \idx{linktext}}%
+ }%
+ % innertextformat
+ \gglsopt{inner\-text\-format}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\meta{csname}}
+ \initval{glsxtrdefaultentrytextfmt}%
+ \desc{the name of the control sequence to use for the \idx{innerformatting}}%
+ }%
+ % hyperoutside
+ \gglsopt{hyper\-outside}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \initval{true}
+ \defval{true}
+ \syntax{\meta{boolean}}
+ \desc{determines whether the hyperlink should be inside or outside of \gls{glstextformat}}%
+ }%
+ % wrgloss
+ \gglsopt{wr\-gloss}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.14+}
+ \initval{before}
+ \syntax{\meta{position}}
+ \desc{determines whether to do the \idx{indexing} before or after the
+\idx{linktext}. Allowed values: \optfmt{before} and \optfmt{after}}%
+ }%
+ % noindex
+ \gglsopt{no\-index}%
+ {%
+ \providedby{\sty{glossaries-extra}}
+ \initval{false}
+ \defval{true}
+ \syntax{\meta{boolean}}
+ \desc{if \optfmt{true} this option will suppress \idx{indexing}.
+ If you are using \app{bib2gls}, you may want to consider using
+ \glsoptval{format}{glsignore} to prevent a \location\ but
+ ensure that the entry is selected}%
+ }%
+ % hyper
+ \gglsopt{hyper}%
+ {%
+ \providedby{\sty{glossaries}}
+ \initval{true}
+ \defval{true}
+ \syntax{\meta{boolean}}
+ \desc{determines whether or not the \idx{linktext} should have a
+ hyperlink (provided hyperlinks are supported)}%
+ }%
+ % thevalue
+ \gglsopt{the\-value}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.19+}
+ \syntax{\meta{location}}
+ \desc{set the \location\ to this value instead of obtaining it from the
+ \idx{locationcounter}}%
+ }%
+ % theHvalue
+ \gglsopt{the\-H\-value}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.19+}
+ \syntax{\meta{the-H-value}}
+ \desc{set the hyper \location\ to this value instead of obtaining it
+from \gls{theHcounter}}%
+ }%
+ % types
+ \gglsopt{types}%
+ {
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{glossary list}}
+ \desc{only available with \gls{glsaddall}, the value is the
+ list of glossaries to iterate over}
+ }
+ % prereset
+ \gglsopt{pre\-reset}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \initval{none}
+ \defval{local}
+ \syntax{\meta{value}}
+ \desc{determines whether or not to reset the entry before the
+ \idx{linktext}. Allowed values: \optfmt{none} (no reset),
+ \optfmt{local} (localise the reset) and \optfmt{global}}%
+ }%
+ % preunset
+ \gglsopt{pre\-unset}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \initval{none}
+ \defval{local}
+ \syntax{\meta{value}}
+ \desc{determines whether or not to unset the entry before the
+ \idx{linktext}. Allowed values: \optfmt{none} (no unset),
+ \optfmt{local} (localise the unset) and \optfmt{global}}%
+ }%
+ % \glolinkprefix
+ \gcmd{glo\-link\-prefix}
+ {
+ \providedby{\sty{glossaries}}
+ \initval{glo:}
+ \desc{expands to the default prefix for the entry's hypertarget anchor
+ in the glossary}
+ }
+ % \glstextformat
+ \gcmd{gls\-text\-format}
+ {
+ \providedby{\sty{glossaries} v1.04+}
+ \syntax{\margm{text}}
+ \desc{the default outer text formatting command used by the
+ \idx{glslike} and \idx{glstextlike} commands}
+ }
+ % \glsrefentry
+ \gcmd{gls\-ref\-entry}
+ {%
+ \providedby{\sty{glossaries} v3.0+}
+ \syntax{\margm{entry-label}}
+ \desc{references (using \gls{ref}) the entry counter or sub-counter (if
+ \opt{entrycounter} or \opt{subentrycounter} options are set)
+ otherwise just does \gls{gls}\margm{entry-label}}
+ }
+ % \glsxtrpageref
+ \gcmd{gls\-xtr\-page\-ref}
+ {%
+ \providedby{\sty{glossaries-extra} v1.11+}
+ \syntax{\margm{entry-label}}
+ \desc{as \gls{glsrefentry} but uses \gls{pageref} instead of
+ \gls{ref}. As with \gls{glsrefentry}, this will use \gls{gls}
+ instead if the corresponding entry counter is disabled}
+ }
+ % \glsxtrp
+ \gcmd{gls\-xtrp}
+ {
+ \providedby{\sty{glossaries-extra} v1.07+}
+ \syntax{\margm{field}\margm{entry-label}}
+ \desc{for use in headings and captions (instead of the
+ \gls{glslike} or \gls{glstextlike} commands). This command is
+ designed to expand to the field value if used in a PDF
+ bookmark and can also expand to a more appropriate command if
+ it ends up in the page header. Note that there's no option
+ argument. Options should be set beforehand using
+ \gls{glsxtrsetpopts}, which is done automatically in the
+ glossary with \gls{glossxtrsetpopts}}
+ }
+ % \Glsxtrp
+ \gcmd{Gls\-xtrp}
+ {
+ \providedby{\sty{glossaries-extra} v1.07+}
+ \syntax{\margm{field}\margm{entry-label}}
+ \desc{as \gls{glsxtrp} but converts the first letter to
+ uppercase (but not in the PDF bookmark)}
+ }
+ % \GLSxtrp
+ \gcmd{GLS\-xtrp}
+ {
+ \providedby{\sty{glossaries-extra} v1.07+}
+ \syntax{\margm{field}\margm{entry-label}}
+ \desc{as \gls{glsxtrp} but converts to
+ uppercase (but not in the PDF bookmark)}
+ }
+ % \glsps
+ \gcmd{gls\-ps}
+ {
+ \providedby{\sty{glossaries-extra} v1.07+}
+ \syntax{\margm{entry-label}}
+ \desc{shortcut for \code{\gls{glsxtrp}\marg{short}\margm{entry-label}}}
+ }
+ % \glspt
+ \gcmd{gls\-pt}
+ {%
+ \providedby{\sty{glossaries-extra} v1.07+}
+ \syntax{\margm{entry-label}}
+ \desc{shortcut for \code{\gls{glsxtrp}\marg{text}\margm{entry-label}}}
+ }
+ % \glsxtrsetpopts
+ \gcmd{gls\-xtr\-set\-p\-opts}
+ {%
+ \providedby{\sty{glossaries-extra} v1.07+}
+ \syntax{\margm{options}}
+ \desc{sets the options that \gls{glsxtrp} (and case-change
+ variants) pass to the relevant \gls{glstextlike} command}
+ }
+ % \glossxtrsetpopts
+ \gcmd{gloss\-xtr\-set\-p\-opts}
+ {
+ \providedby{\sty{glossaries-extra} v1.07+}
+ \desc{used at the start of each glossary to set the current
+ options for the \gls{glsxtrp} set of commands (with
+ \gls{glsxtrsetpopts})}
+ }
+ % \glsxtridentifyglslike
+ \gcmd{gls\-xtr\-identify\-gls\-like}
+ {
+ \providedby{\sty{glossaries-extra} v1.37+}
+ \syntax{\margm{label-prefix}\margm{cs}}
+ \desc{used to inform \app{bib2gls} to include the given command
+ when it searches for dependencies}
+ }
+ % \glsxtraddlabelprefix
+ \gcmd{gls\-xtr\-add\-label\-prefix}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.37+}
+ \syntax{\margm{label-prefix}}
+ \desc{appends \meta{label-prefix} to the list of known labels}
+ }
+ % \glsxtrprependlabelprefix
+ \gcmd{gls\-xtr\-prepend\-label\-prefix}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.37+}
+ \syntax{\margm{label-prefix}}
+ \desc{prepends \meta{label-prefix} to the list of known labels}
+ }
+ % \glsxtrclearlabelprefixes
+ \gcmd{gls\-xtr\-clear\-label\-prefixes}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.37+}
+ \desc{clears the list of known prefixes}
+ \field{seealso}{glsxtraddlabelprefix,glsxtrprependlabelprefix}
+ }
+ % \glsxtrifinlabelprefixlist
+ \gcmd{glsxtrifinlabelprefixlist}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.37+}
+ \syntax{\margm{label-prefix}\margm{true}\margm{false}}
+ \desc{does \meta{true} if \meta{label-prefix} has been
+ identified as a label prefix}
+ \field{seealso}{glsxtraddlabelprefix,glsxtrprependlabelprefix}
+ }
+ % \ifGlsXtrPrefixLabelFallbackLast
+ \gcond{if\-Gls\-Xtr\-Prefix\-Label\-Fallback\-Last}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \initvalcs{iftrue}
+ \desc{conditional that determines whether or not to use the
+ last label prefix as the default}
+ }
+ % \GlsXtrPrefixLabelFallbackLasttrue
+ \gcmd{Gls\-Xtr\-Prefix\-Label\-Fallback\-Last\-true}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \desc{sets the \gls{ifGlsXtrPrefixLabelFallbackLast} conditional to true}
+ }
+ % \GlsXtrPrefixLabelFallbackLastfalse
+ \gcmd{Gls\-Xtr\-Prefix\-Label\-Fallback\-Last\-false}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \desc{sets the \gls{ifGlsXtrPrefixLabelFallbackLast} conditional to false}
+ }
+ % \dgls
+ \gcmdspa{dgls}{%
+ \providedby{\sty{glossaries-extra-bib2gls} v1.37+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{does \code{\gls{gls}\oargm{options}\marg{\meta{prefix}\marg{entry-label}}\oargm{insert}}
+ for the first prefix in the prefix list that matches a defined entry}
+ \field{seealso}{glsxtraddlabelprefix,glsxtrprependlabelprefix}
+ }
+ % \dGls
+ \gcmdspa{dGls}{%
+ \providedby{\sty{glossaries-extra-bib2gls} v1.37+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{dgls} but uses \gls{Gls}}
+ \field{seealso}{glsxtraddlabelprefix,glsxtrprependlabelprefix}
+ }
+ % \dGLS
+ \gcmdspa{dGLS}{%
+ \providedby{\sty{glossaries-extra-bib2gls} v1.37+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{dgls} but uses \gls{GLS}}
+ \field{seealso}{glsxtraddlabelprefix,glsxtrprependlabelprefix}
+ }
+ % \dglspl
+ \gcmdspa{dgls\-pl}{%
+ \providedby{\sty{glossaries-extra-bib2gls} v1.37+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{dgls} but uses \gls{glspl}}
+ \field{seealso}{glsxtraddlabelprefix,glsxtrprependlabelprefix}
+ }
+ % \dGlspl
+ \gcmdspa{dGls\-pl}{%
+ \providedby{\sty{glossaries-extra-bib2gls} v1.37+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{dgls} but uses \gls{Glspl}}
+ \field{seealso}{glsxtraddlabelprefix,glsxtrprependlabelprefix}
+ }
+ % \dGLSpl
+ \gcmdspa{dGLS\-pl}{%
+ \providedby{\sty{glossaries-extra-bib2gls} v1.37+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{dgls} but uses \gls{GLSpl}}
+ \field{seealso}{glsxtraddlabelprefix,glsxtrprependlabelprefix}
+ }
+ % \dglslink
+ \gcmdspa{dgls\-link}{%
+ \providedby{\sty{glossaries-extra-bib2gls} v1.37+}
+ \syntax{\oargm{options}\margm{entry-label}\margm{text}}
+ \desc{as \gls{dgls} but uses \gls{glslink}}
+ \field{seealso}{glsxtraddlabelprefix,glsxtrprependlabelprefix}
+ }
+ % \dGlslink
+ \gcmdspa{dGls\-link}{%
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \syntax{\oargm{options}\margm{entry-label}\margm{text}}
+ \desc{as \gls{dglslink} but applies \idx{sentencecase}}
+ \field{seealso}{glsxtraddlabelprefix,glsxtrprependlabelprefix}
+ }
+ % \dglsdisp
+ \gcmdspa{dgls\-disp}{%
+ \providedby{\sty{glossaries-extra-bib2gls} v1.37+}
+ \syntax{\oargm{options}\margm{entry-label}\margm{text}}
+ \desc{as \gls{dgls} but uses \gls{glsdisp}}
+ \field{seealso}{glsxtraddlabelprefix,glsxtrprependlabelprefix}
+ }
+ % \dGlsdisp
+ \gcmdspa{dGls\-disp}{%
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \syntax{\oargm{options}\margm{entry-label}\margm{text}}
+ \desc{as \gls{dglsdisp} but applies \idx{sentencecase}}
+ \field{seealso}{glsxtraddlabelprefix,glsxtrprependlabelprefix}
+ }
+ % \dglsfield
+ \gcmdspa{dgls\-field}{%
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \syntax{\oargm{options}\margm{entry-label}\margm{field-label}\margm{text}}
+ \desc{as \gls{dgls} but selects the first matching label that
+ has an entry with the field set}
+ \field{seealso}{glsxtraddlabelprefix,glsxtrprependlabelprefix}
+ }
+ % \dGlsfield
+ \gcmdspa{dGls\-field}{%
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \syntax{\oargm{options}\margm{entry-label}\margm{field-label}\margm{text}}
+ \desc{as \gls{dglsfield} but applies \idx{sentencecase}}
+ \field{seealso}{glsxtraddlabelprefix,glsxtrprependlabelprefix}
+ }
+ % \dGLSfield
+ \gcmdspa{dGLS\-field}{%
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \syntax{\oargm{options}\margm{entry-label}\margm{field-label}\margm{text}}
+ \desc{as \gls{dglsfield} but \idx{allcaps}}
+ \field{seealso}{glsxtraddlabelprefix,glsxtrprependlabelprefix}
+ }
+ % \dglsfieldcurrentfieldlabel
+ \gcmd{dgls\-field\-current\-field\-label}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \desc{set by the \gls{dglsfield} family of commands to the given
+ \meta{field-label}}
+ }
+ % \dglsfieldfallbackfieldlabel
+ \gcmd{dgls\-field\-fallback\-field\-label}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \initvalopt{gloskey}{text}
+ \desc{expands to the fallback field to use for the
+ \gls{dglsfield} family of commands}
+ }
+ % \dglsfieldactualfieldlabel
+ \gcmd{dgls\-field\-actual\-field\-label}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \desc{set by the \gls{dglsfield} family of commands to the
+ actual field used. This will either be the requested field or
+ the fallback field}
+ }
+ % \newdglsfield
+ \gcmd{new\-d\-gls\-field}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \syntax{\oargm{default-options}\margm{field}\margm{cs}}
+ \desc{defines the command
+\meta{cs}\oargm{options}\margm{entry-label} to behave like
+ \code{\gls{dglsfield}\oarg{\meta{default-options},\meta{options}}\margm{entry-label}\margm{field}}}
+ }
+ % \newdglsfieldlike
+ \gcmd{new\-d\-gls\-field\-like}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \syntax{\oargm{default-options}\margm{field}\margm{cs}\margm{Cs}\margm{CS}}
+ \desc{similar to \gls{newdglsfield} but also defines
+ \idx{sentencecase} (\meta{Cs}) and \idx{allcaps} (\meta{CS}) commands
+ with mappings}
+ }
+ % \glsxtrnewgls
+ \gcmd{gls\-xtr\-new\-gls}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\oargm{default-options}\margm{prefix}\margm{cs}}
+ \desc{defines the command
+\meta{cs}\oargm{options}\margm{entry-label} to behave like
+ \code{\gls{gls}\oarg{\meta{default-options},\meta{options}}\marg{\meta{prefix}\meta{entry-label}}}}
+ }
+ % \glsxtrnewglslike
+ \gcmd{gls\-xtr\-new\-gls\-like}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\oargm{default-options}\margm{prefix}\margm{\gls{gls}-like
+cs}\margm{\gls{glspl}-like cs}\margm{\gls{Gls}-like cs}\margm{\gls{Glspl}-like cs}}
+ \desc{like \gls{glsxtrnewgls} but provides plural and
+ \idx{sentencecase} commands as well}
+ }
+ % \glsxtrnewGLSlike
+ \gcmd{gls\-xtr\-new\-GLS\-like}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\oargm{default-options}\margm{prefix}\margm{\gls{GLS}-like
+cs}\margm{\gls{GLSpl}-like cs}}
+ \desc{like \gls{glsxtrnewgls} but provides \idx+{allcaps} commands}
+ }
+ % \glsxtrnewrgls
+ \gcmd{gls\-xtr\-new\-rgls}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\oargm{default-options}\margm{prefix}\margm{cs}}
+ \desc{like \gls{glsxtrnewgls} but uses \gls{rgls}}
+ }
+ % \glsxtrnewrglslike
+ \gcmd{gls\-xtr\-new\-rgls\-like}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\oargm{default-options}\margm{prefix}\margm{\gls{rgls}-like
+cs}\margm{\gls{rglspl}-like cs}\margm{\gls{rGls}-like
+cs}\margm{\gls{rGlspl}-like cs}}
+ \desc{like \gls{glsxtrnewrgls} but provides plural and
+ \idx{sentencecase} commands as well}
+ }
+ % \glsxtrnewrGLSlike
+ \gcmd{gls\-xtr\-new\-rGLS\-like}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\oargm{default-options}\margm{prefix}\margm{\gls{rGLS}-like
+cs}\margm{\gls{rGLSpl}-like cs}}
+ \desc{like \gls{glsxtrnewrgls} but provides \idx+{allcaps} commands}
+ }
+ % \glsxtrnewglslink
+ \gcmd{gls\-xtr\-new\-gls\-link}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\oargm{default-options}\margm{prefix}\margm{cs}}
+ \desc{defines the command \code{\meta{cs}\oargm{options}\margm{label}\margm{text}} to behave like
+ \code{\gls{glslink}\oarg{\meta{default-options},\meta{options}}\marg{\meta{prefix}\meta{label}}\margm{text}}}
+ }
+ % \glsxtrnewglsdisp
+ \gcmd{gls\-xtr\-new\-gls\-disp}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\oargm{default-options}\margm{prefix}\margm{cs}}
+ \desc{defines the command \code{\meta{cs}\oargm{options}\margm{label}\margm{text}} to behave like
+ \code{\gls{glsdisp}\oarg{\meta{default-options},\meta{options}}\marg{\meta{prefix}\meta{label}}\margm{text}}}
+ }
+ % \GlsXtrRecordCounter
+ \gcmd{Gls\-Xtr\-Record\-Counter}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{counter-name}}
+ \desc{activates recording for the given counter}
+ \note{preamble only}
+ }
+ % \glsxtr@counterrecord
+ \gcmd{gls\-xtr\-@\-counter\-record}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}\margm{counter}\margm{value}}
+ \desc{an \ext{aux} file command used with \gls{GlsXtrRecordCounter}
+ to append \meta{value} to the \glosfield{record.counter} field.
+ Also implements \gls{glsxtrAddCounterRecordHook}}
+ }
+ % \glsxtrAddCounterRecordHook
+ \gcmd{gls\-xtr\-Add\-Counter\-Record\-Hook}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{counter}\margm{value}}
+ \desc{user-level hook used by \gls{glsxtr@counterrecord}. If
+ this command is redefined, it must be done so in the preamble before
+ the \ext{aux} file is input}
+ }
+ % \glsxtrsupphypernumber
+ \gcmd{gls\-xtr\-supp\-hyper\-number}
+ {
+ \providedby{\sty{glossaries-extra} v1.14+}
+ \syntax{\margm{location}}
+ \desc{used to hyperlink to a location in an external document if
+ the \catattr{externallocation} attribute has been set. This will
+ define \gls{glsxtrsupplocationurl} to the location provided by the
+ attribute or to empty if the attribute isn't set}
+ }
+ % \glsxtrsupplocationurl
+ \gcmd{gls\-xtr\-supp\-lo\-ca\-tion\-url}
+ {
+ \providedby{\sty{glossaries-extra} v1.14+}
+ \desc{defined by \gls{glsxtrsupphypernumber} to the external
+ location or empty if not provided}
+ }
+ % COMMANDS: ENTRY COUNTING
+ % \ifglsresetcurrcount
+ \gcond{if\-gls\-re\-set\-curr\-count}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \initvalcs{iffalse}
+ \desc{conditional that determines whether or not to reset the
+ entry counter to 0 when the \idx{firstuseflag} is reset}
+ }
+ % \glsresetcurrcounttrue
+ \gcmd{gls\-re\-set\-curr\-count\-true}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{sets \gls{ifglsresetcurrcount} to true}
+ }
+ % \glsresetcurrcountfalse
+ \gcmd{gls\-re\-set\-curr\-count\-false}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{sets \gls{ifglsresetcurrcount} to false}
+ }
+ % \glsenableentrycount
+ \gcmd{gls\-enable\-entry\-count}
+ {
+ \providedby{\sty{glossaries} v4.14+}
+ \desc{enables entry counting}
+ }
+ % \glsenableentryunitcount
+ \gcmd{gls\-enable\-entry\-unit\-count}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.4+}
+ \desc{enables entry unit counting}
+ }
+ % \glsentrycurrcount
+ \gcmd{gls\-entry\-curr\-count}
+ {
+ \syntax{\margm{entry-label}}
+ \providedby{\sty{glossaries} v4.14+}
+ \desc{expands to the current entry count running total or 0 if
+ not available (needs to be enabled with
+ \gls{glsenableentrycount} or \gls{glsenableentryunitcount}).
+ With unit entry counting, this
+ expands to the total for the current unit}
+ }
+ % \glsentryprevcount
+ \gcmd{gls\-entry\-prev\-count}
+ {
+ \syntax{\margm{entry-label}}
+ \providedby{\sty{glossaries} v4.14+}
+ \desc{expands to the final entry count total from the previous
+ \LaTeX\ run or if 0 if not available (needs to be enabled with
+ \gls{glsenableentrycount} or \gls{glsenableentryunitcount}).
+ With unit entry counting, this
+ expands to the total for the current unit}
+ }
+ % \glsentryprevtotalcount
+ \gcmd{gls\-entry\-prev\-total\-count}
+ {
+ \providedby{\sty{glossaries} v4.14+}
+ \syntax{\margm{entry-label}}
+ \desc{expands to the final entry count total from the previous
+ \LaTeX\ run or if 0 if not available (needs to be enabled with
+ \gls{glsenableentryunitcount})}
+ }
+ % \glsentryprevmaxcount
+ \gcmd{gls\-entry\-prev\-max\-count}
+ {
+ \providedby{\sty{glossaries} v4.14+}
+ \syntax{\margm{entry-label}}
+ \desc{expands to the maximum entry unit count total from the previous
+ \LaTeX\ run or if 0 if not available (needs to be enabled with
+ \gls{glsenableentryunitcount})}
+ }
+ % \cgls
+ \gcmdspa{cgls}
+ {
+ \providedby{\sty{glossaries} v4.14+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{like \gls{gls} but hooks into the entry counting mechanism}
+ \field{seealso}{glsenableentrycount,cglsformat}
+ }
+ % \cglspl
+ \gcmdspa{cglspl}
+ {
+ \providedby{\sty{glossaries} v4.14+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{like \gls{glspl} but hooks into the entry counting mechanism}
+ \field{seealso}{glsenableentrycount,cglsplformat}
+ }
+ % \cGls
+ \gcmdspa{cGls}
+ {
+ \providedby{\sty{glossaries} v4.14+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{like \gls{Gls} but hooks into the entry counting mechanism}
+ \field{seealso}{glsenableentrycount,cGlsformat}
+ }
+ % \cGlspl
+ \gcmdspa{cGlspl}
+ {
+ \providedby{\sty{glossaries} v4.14+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{like \gls{Glspl} but hooks into the entry counting mechanism}
+ \field{seealso}{glsenableentrycount,cGlsplformat}
+ }
+ % \cglsformat
+ \gcmd{cgls\-format}
+ {
+ \providedby{\sty{glossaries} v4.14+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{format used by \gls{cgls} if the entry was not used more
+ than the given trigger value on the previous run}
+ }
+ % \cglsplformat
+ \gcmd{cgls\-pl\-format}
+ {
+ \providedby{\sty{glossaries} v4.14+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{format used by \gls{cglspl} if the entry was not used more
+ than the given trigger value on the previous run}
+ }
+ % \cGlsformat
+ \gcmd{cGls\-format}
+ {
+ \providedby{\sty{glossaries} v4.14+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{format used by \gls{cGls} if the entry was not used more
+ than the given trigger value on the previous run}
+ }
+ % \cGlsplformat
+ \gcmd{cGls\-pl\-format}
+ {
+ \providedby{\sty{glossaries} v4.14+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{format used by \gls{cGlspl} if the entry was not used more
+ than the given trigger value on the previous run}
+ }
+ % \cGLS
+ \gcmdspa{cGLS}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{like \gls{GLS} but hooks into the entry counting mechanism}
+ \field{seealso}{glsenableentrycount,cGLSformat}
+ }
+ % \cGLSpl
+ \gcmdspa{cGLSpl}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{like \gls{GLSpl} but hooks into the entry counting mechanism}
+ \field{seealso}{glsenableentrycount,cGLSplformat}
+ }
+ % \cGLSformat
+ \gcmd{cGLS\-format}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{format used by \gls{cGLS} if the entry was not used more
+ than the given trigger value on the previous run}
+ }
+ % \cGLSplformat
+ \gcmd{cGLS\-pl\-format}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{format used by \gls{cGLSpl} if the entry was not used more
+ than the given trigger value on the previous run}
+ }
+ % \glsxtrifcounttrigger
+ \gcmd{gls\-xtr\-if\-count\-trigger}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the entry's total use count at the end
+ of the previous run exceeds the trigger value assigned to the
+ entry's category, otherwise does \meta{false}}
+ }
+ % \GlsXtrEnableEntryCounting
+ \gcmd{Gls\-Xtr\-Enable\-Entry\-Count\-ing}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{category-list}\margm{trigger-value}}
+ \desc{enables entry counting for the given list of categories
+ with the given trigger value (which must be an integer)}
+ }
+ % \GlsXtrEnableEntryUnitCounting
+ \gcmd{Gls\-Xtr\-Enable\-Entry\-Unit\-Count\-ing}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.4+}
+ \syntax{\margm{category-list}\margm{trigger-value}\margm{counter}}
+ \desc{enables unit entry counting for the given list of categories
+ with the given trigger value (which must be an integer) and the
+ associated counter}
+ }
+ % \GlsXtrStartUnsetBuffering
+ \gcmds{Gls\-Xtr\-Start\-Unset\-Buffering}
+ {
+ \providedby{\sty{glossaries-extra} v1.30+}
+ \desc{enables unset buffering. The starred version doesn't check
+ for duplicates}
+ \field{seealso}{GlsXtrStopUnsetBuffering,GlsXtrDiscardUnsetBuffering}
+ }
+ % \GlsXtrStopUnsetBuffering
+ \gcmds{Gls\-Xtr\-Stop\-Unset\-Buffering}
+ {
+ \providedby{\sty{glossaries-extra} v1.30+}
+ \desc{stops buffering. The starred version performs a global unset}
+ \field{seealso}{GlsXtrStartUnsetBuffering,GlsXtrDiscardUnsetBuffering,GlsXtrForUnsetBufferedList}
+ }
+ % \GlsXtrDiscardUnsetBuffering
+ \gcmd{Gls\-Xtr\-Discard\-Unset\-Buffering}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \desc{discards the pending buffer and restores \gls{glsunset}}
+ \field{seealso}{GlsXtrStartUnsetBuffering,GlsXtrStopUnsetBuffering}
+ }
+ % \GlsXtrForUnsetBufferedList
+ \gcmd{Gls\-Xtr\-For\-Unset\-Buffered\-List}
+ {
+ \providedby{\sty{glossaries-extra} v1.31+}
+ \syntax{\margm{handler-cs}}
+ \desc{iterates over the labels stored in the current buffer}
+ }
+ % \GlsXtrClearUnsetBuffer
+ \gcmd{Gls\-Xtr\-Clear\-Unset\-Buffer}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{locally clears the buffer, but doesn't stop buffering}
+ }
+ % \GlsXtrUnsetBufferEnableRepeatLocal
+ \gcmd{Gls\-Xtr\-Unset\-Buffer\-Enable\-Repeat\-Local}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{allows repeat entries within the buffering code to be
+ locally unset before the \idx{linktext}}
+ \field{seealso}{GlsXtrResetLocalBuffer}
+ }
+ % \GlsXtrResetLocalBuffer
+ \gcmd{Gls\-Xtr\-Reset\-Local\-Buffer}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{if local unset for repeat entries has been enabled with
+ \gls{GlsXtrUnsetBufferEnableRepeatLocal}, this will locally
+ reset all entries that are in the buffer that hadn't been
+ marked as used before the function was enabled}
+ \field{seealso}{GlsXtrUnsetBufferEnableRepeatLocal}
+ }
+ % \GlsXtrUnsetBufferDisableRepeatLocal
+ \gcmd{Gls\-Xtr\-Un\-set\-Buffer\-Disable\-Repeat\-Local}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{disables GlsXtrUnsetBufferEnableRepeatLocal}
+ }
+ % \glsxtrpostlocalunset
+ \gcmd{gls\-xtr\-post\-local\-unset}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.4+}
+ \syntax{\margm{entry-label}}
+ \desc{hook performed by \gls{glslocalunset}. This hook is
+ modified by \gls{glsenableentrycount} and \gls{glsenableentryunitcount}}
+ }
+ % \glsxtrpostunset
+ \gcmd{gls\-xtr\-post\-unset}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.4+}
+ \syntax{\margm{entry-label}}
+ \desc{hook performed by \gls{glsunset}. This hook is
+ modified by \gls{glsenableentrycount} and \gls{glsenableentryunitcount}}
+ }
+ % \glsxtrpostlocalreset
+ \gcmd{gls\-xtr\-post\-local\-reset}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.4+}
+ \syntax{\margm{entry-label}}
+ \desc{hook performed by \gls{glslocalreset}. This hook is
+ modified by \gls{glsenableentrycount} and \gls{glsenableentryunitcount}}
+ }
+ % \glsxtrpostreset
+ \gcmd{gls\-xtr\-post\-reset}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.4+}
+ \syntax{\margm{entry-label}}
+ \desc{hook performed by \gls{glsreset}. This hook is
+ modified by \gls{glsenableentrycount} and \gls{glsenableentryunitcount}}
+ }
+ % \GlsXtrEnableLinkCounting
+ \gcmd{Gls\-Xtr\-Enable\-Link\-Count\-ing}
+ {
+ \providedby{\sty{glossaries-extra} v1.26+}
+ \syntax{\oargm{parent counter}\margm{categories}}
+ \desc{enables link counting for the given categories}
+ \note{preamble only}
+ }
+ % \glsxtrinclinkcounter
+ \gcmd{gls\-xtr\-inc\-link\-counter}
+ {
+ \providedby{\sty{glossaries-extra} v1.26+}
+ \syntax{\margm{counter}}
+ \desc{increments the link counter with \gls{stepcounter}}
+ }
+ % \GlsXtrLinkCounterValue
+ \gcmd{Gls\-Xtr\-Link\-Counter\-Value}
+ {
+ \providedby{\sty{glossaries-extra} v1.26+}
+ \syntax{\margm{entry-label}}
+ \desc{expands to the internal link count register associated
+ with the given register or 0 if it hasn't been defined}
+ }
+ % \GlsXtrTheLinkCounter
+ \gcmd{Gls\-Xtr\-The\-Link\-Counter}
+ {
+ \providedby{\sty{glossaries-extra} v1.26+}
+ \syntax{\margm{entry-label}}
+ \desc{expands to the value of the link counter associated
+ with the given entry or 0 if it hasn't been defined}
+ }
+ % \GlsXtrIfLinkCounterDef
+ \gcmd{Gls\-Xtr\-If\-Link\-Counter\-Def}
+ {
+ \providedby{\sty{glossaries-extra} v1.26+}
+ \syntax{\margm{entry-label}\margm{true}\margm{false}}
+ \desc{expands to \meta{true} if the link counter associated
+ with the given entry has been defined, otherwise expands to \meta{false}}
+ }
+ % \GlsXtrLinkCounterName
+ \gcmd{Gls\-Xtr\-Link\-Counter\-Name}
+ {
+ \providedby{\sty{glossaries-extra} v1.26+}
+ \syntax{\margm{entry-label}}
+ \desc{expands to the name of the link counter associated with the given entry
+ (no check for existence)}
+ }
+ % COMMANDS: MULTI-ENTRY
+ % \multiglossaryentry
+ \gcmd{multi\-glossary\-entry}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{main-label}\margm{entry-label-list}}
+ \desc{defines a multi-entry set with the label
+ \meta{multi-label}, consisting of the entries whose labels are
+ listed in \meta{entry-label-list}, where the main entry (which must be
+ present in \meta{entry-label-list}) is identified by \meta{main-label}
+ (or the final element in \meta{entry-label-list}, if \meta{main-label} is
+ omitted)}
+ }
+ % \providemultiglossaryentry
+ \gcmd{provide\-multi\-glossary\-entry}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{main-label}\margm{entry-label-list}}
+ \desc{as \gls{multiglossaryentry} but does nothing if a
+ multi-entry set has already been defined with the given label}
+ }
+ % \ifmultiglossaryentryglobal
+ \gcond{if\-multi\-glossary\-entry\-global}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \initvalcs{iffalse}
+ \desc{if true, subsequent multi-entry definitions will be global}
+ }
+ % \multiglossaryentryglobaltrue
+ \gcmd{multi\-glossary\-entry\-global\-true}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{sets \gls{ifmultiglossaryentryglobal} to true}
+ }
+ % \multiglossaryentryglobalfalse
+ \gcmd{multi\-glossary\-entry\-global\-false}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{sets \gls{ifmultiglossaryentryglobal} to false}
+ }
+ % \mglsSetOptions
+ \gcmd{mgls\-Set\-Options}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{multi-label}\margm{new-options}}
+ \desc{locally sets the options associated with the given
+ multi-entry}
+ }
+ % \mglsAddOptions
+ \gcmd{mgls\-Add\-Options}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{multi-label}\margm{new-options}}
+ \desc{locally appends to the options associated with the given
+ multi-entry}
+ }
+ % \GlsXtrMglsOrGls
+ \gcmd{GlsXtrMglsOrGls}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{mgls cs}\margm{gls cs}\meta{modifier}\oargm{options}\margm{label}\oargm{insert}}
+ \desc{if \meta{label} matches a defined multi-entry, this will
+ do \meta{mgls cls} otherwise it will do \meta{gls cs}. The
+ \meta{modifier} (\code{*} or \code{+} or the token identified
+ with \gls{GlsXtrSetAltModifier}) may be omitted}
+ }
+ % \multiglossaryentrysetup
+ \gcmd{multi\-glossary\-entry\-set\-up}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{options}}
+ \desc{specifies a general set of options to apply to all multi-entries}
+ }
+ % \mglsdefcategoryprefix
+ \gcmd{mgls\-def\-category\-prefix}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{category-label}\margm{definition}}
+ \desc{defines the prefix for the given multi-entry category}
+ }
+ % \mglshascategoryprefix
+ \gcmd{mgls\-has\-category\-prefix}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{category-label}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the given multi-entry category has a
+ prefix set otherwise does \meta{false}}
+ }
+ % \mglsusecategoryprefix
+ \gcmd{mgls\-use\-category\-prefix}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{category-label}}
+ \desc{expands to the prefix assigned to the given multi-entry
+ category or does nothing if no prefix assigned}
+ }
+ % \mglsdefcategorysuffix
+ \gcmd{mgls\-def\-category\-suffix}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{category-label}\margm{definition}}
+ \desc{defines the suffix for the given multi-entry category}
+ }
+ % \mglsprefix
+ \gcmd{mgls\-prefix}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{code used to typeset the multi-entry prefix}
+ }
+ % \mglshascategorysuffix
+ \gcmd{mgls\-has\-category\-suffix}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{category-label}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the given multi-entry category has a
+ suffix set otherwise does \meta{false}}
+ }
+ % \mglsusecategorysuffix
+ \gcmd{mgls\-use\-category\-suffix}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{category-label}}
+ \desc{expands to the suffix assigned to the given multi-entry
+ category or does nothing if no suffix assigned}
+ }
+ % \mglssuffix
+ \gcmd{mgls\-suffix}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{code used to typeset the multi-entry suffix}
+ }
+ % \glscombinedsep
+ \gcmd{gls\-combined\-sep}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{prev label}\margm{next label}}
+ \desc{separator used between elements of a multi-entry set where
+ both elements have been marked as used}
+ }
+ % \glscombinedfirstsep
+ \gcmd{gls\-combined\-first\-sep}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{prev label}\margm{next label}}
+ \desc{separator used between elements of a multi-entry set where
+ only the next element have been marked as used}
+ }
+ % \glscombinedsepfirst
+ \gcmd{gls\-combined\-sep\-first}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{prev label}\margm{next label}}
+ \desc{separator used between elements of a multi-entry set where
+ only the previous element have been marked as used}
+ }
+ % \glscombinedfirstsepfirst
+ \gcmd{gls\-combined\-first\-sep\-first}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{prev label}\margm{next label}}
+ \desc{separator used between elements of a multi-entry set where
+ neither the previous nor the next element has been marked as used}
+ }
+ % \glssetcombinedsepabbrvnbsp
+ \gcmd{gls\-set\-combined\-sep\-abbrv\-nbsp}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{defines the multi-entry separators to use a
+ \idx{nbsp} for abbreviations}
+ }
+ % \glssetcombinedsepabbrvnone
+ \gcmd{gls\-set\-combined\-sep\-abbrv\-none}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{defines the multi-entry separators to use no
+ separator for abbreviations}
+ }
+ % \glssetcombinedsepnarrow
+ \gcmd{gls\-set\-combined\-sep\-narrow}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{width}\margm{narrow-sep}}
+ \desc{defines the multi-entry separators to use
+ \meta{narrow-sep} if the width of associated field values is less
+ than \meta{width}}
+ }
+ % \mglselementprehook
+ \gcmd{mgls\-element\-pre\-hook}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{hook performed before each (non-skipped) element in a
+ multi-entry set}
+ }
+ % \mglselementposthook
+ \gcmd{mgls\-element\-post\-hook}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{hook performed after each (non-skipped) element in a
+ multi-entry set}
+ }
+ % \mglscurrentmultilabel
+ \gcmd{mgls\-current\-multi\-label}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{placeholder command for use in multi-entry hooks, this
+ expands to the multi-entry label}
+ }
+ % \mglscurrentmainlabel
+ \gcmd{mgls\-current\-main\-label}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{placeholder command for use in multi-entry hooks, this
+ expands to the label of the main element}
+ }
+ % \mglscurrentlist
+ \gcmd{mgls\-current\-list}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{placeholder command for use in multi-entry hooks, this
+ expands to the complete comma-separated list of elements}
+ }
+ % \mglscurrentoptions
+ \gcmd{mgls\-current\-options}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{placeholder command for use in multi-entry hooks, this
+ expands to the options used when the multi-entry was defined}
+ }
+ % \mglscurrentcategory
+ \gcmd{mgls\-current\-category}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{placeholder command for use in multi-entry hooks, this
+ expands to the multi-entry category current in effect}
+ }
+ % \glsxtrcurrentmglscsname
+ \gcmd{gls\-xtr\-current\-mgls\-cs\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{placeholder command for use in multi-entry hooks, this
+ expands to the control sequence name of the calling command}
+ }
+ % \mglscurrentlabel
+ \gcmd{mgls\-current\-label}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{placeholder command for use in multi-entry hooks, this
+ expands to the current element label}
+ }
+ % \mglselementindex
+ \gcmd{mgls\-element\-index}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{a count register used in multi-entry hooks, this
+ is set to the element index}
+ }
+ % \mglscurrentprefix
+ \gcmd{mgls\-current\-prefix}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{placeholder command for use in multi-entry hooks, this
+ expands to the current prefix}
+ }
+ % \mglscurrentsuffix
+ \gcmd{mgls\-current\-suffix}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{placeholder command for use in multi-entry hooks, this
+ expands to the current suffix}
+ }
+ % \mglsisfirstuse
+ \gcmd{mgls\-is\-first\-use}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{true}\margm{false}}
+ \desc{for use in multi-entry hooks, this expands to \meta{true}
+ if this is the first use otherwise expands to \meta{false}}
+ }
+ % \mglsiflast
+ \gcmd{mgls\-if\-last}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{true}\margm{false}}
+ \desc{for use in multi-entry hooks, this expands to \meta{true}
+ if this is the last iteration otherwise expands to \meta{false}}
+ }
+ % \mglslastmultilabel
+ \gcmd{mgls\-last\-multi\-label}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{for use in multi-entry suffix and post-link hooks, this expands to the
+ multi-entry label}
+ }
+ % \mglslastcategory
+ \gcmd{mgls\-last\-category}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{for use in multi-entry suffix and post-link hooks, this expands to the
+ multi-entry category or nothing, if no category assigned}
+ }
+ % \mglswasfirstuse
+ \gcmd{mgls\-was\-first\-use}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{true}\margm{false}}
+ \desc{for use in multi-entry suffix and post-link hooks, this expands to the
+ \meta{true} if this was the first use of the multi-entry,
+ otherwise to \meta{false}}
+ }
+ % \mglslastelementlabel
+ \gcmd{mgls\-last\-element\-label}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{for use in multi-entry suffix and post-link hooks, this expands to the
+ label of the last non-skipped element}
+ }
+ % \mglsiflastelementskipped
+ \gcmd{mgls\-if\-last\-element\-skipped}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{true}\margm{false}}
+ \desc{for use in multi-entry suffix and post-link hooks, this expands to the
+ \meta{true} if the last element was skipped,
+ otherwise to \meta{false}}
+ }
+ % \mglsiflastelementwasfirstuse
+ \gcmd{mgls\-if\-last\-element\-was\-first\-use}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{true}\margm{false}}
+ \desc{for use in multi-entry suffix and post-link hooks, this expands to the
+ \meta{true} if the last element was used for the first time,
+ otherwise to \meta{false}}
+ }
+ % \mglsiflastelementwasplural
+ \gcmd{mgls\-if\-last\-element\-was\-plural}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{true}\margm{false}}
+ \desc{for use in multi-entry suffix and post-link hooks, this expands to the
+ \meta{true} if the last element had the plural form displayed,
+ otherwise to \meta{false}}
+ }
+ % \mglsiflastelementcapscase
+ \gcmd{mgls\-if\-last\-element\-caps\-case}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{no-change}\margm{firstuc}\margm{all caps}}
+ \desc{for use in multi-entry suffix and post-link hooks, this expands to the
+ \meta{no-change} if the last element had no case-change applied,
+ to \meta{firstuc} if the last element had \idx+{sentencecase}
+ applied or to \meta{all caps} if the last element had \idx+{allcaps}
+ applied}
+ }
+ % \mglslastmainlabel
+ \gcmd{mgls\-last\-main\-label}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{for use in multi-entry suffix and post-link hooks, this expands to the
+ label of the main element that was just referenced}
+ }
+ % \mglsiflastmainskipped
+ \gcmd{mgls\-if\-last\-main\-skipped}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{true}\margm{false}}
+ \desc{for use in multi-entry suffix and post-link hooks, this expands to the
+ \meta{true} if the main element from the multi-entry just
+ referenced was skipped, otherwise to \meta{false}}
+ }
+ % \mglsiflastmainwasfirstuse
+ \gcmd{mgls\-if\-last\-main\-was\-first\-use}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{true}\margm{false}}
+ \desc{for use in multi-entry suffix and post-link hooks, this expands to the
+ \meta{true} if the main element from the multi-entry just
+ referenced was used for the first time, otherwise to \meta{false}}
+ }
+ % \mglsiflastmainwasplural
+ \gcmd{mgls\-if\-last\-main\-was\-plural}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{true}\margm{false}}
+ \desc{for use in multi-entry suffix and post-link hooks, this expands to the
+ \meta{true} if the main element from the multi-entry just
+ referenced had the plural form shown, otherwise to \meta{false}}
+ }
+ % \mglsiflastmaincapscase
+ \gcmd{mgls\-if\-last\-main\-caps\-case}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{no-change}\margm{firstuc}\margm{all caps}}
+ \desc{for use in multi-entry suffix and post-link hooks, this expands to the
+ \meta{no-change} if the main element from the multi-entry just
+ referenced had no case-change applied,
+ to \meta{firstuc} if the last element had \idx+{sentencecase}
+ applied or to \meta{all caps} if the last element had \idx+{allcaps}
+ applied}
+ }
+ % \mglscustompostlinkhook
+ \gcmd{mgls\-custom\-post\-link\-hook}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{hook used with the \mglsoptval{mpostlinkelement}{custom} option}
+ }
+ % \mglslastelementpostlinkhook
+ \gcmd{mgls\-last\-element\-post\-link\-hook}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{hook used with the \mglsoptval{mpostlinkelement}{last} option}
+ }
+ % \mglslastmainpostlinkhook
+ \gcmd{mgls\-last\-main\-post\-link\-hook}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{hook used with the \mglsoptval{mpostlinkelement}{main} option}
+ }
+ % \ifmglsused
+ \gcmd{if\-mgls\-used}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{multi-label}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the given multi-entry has been marked
+ as used, otherwise does \meta{false}}
+ }
+ % \mglsunset
+ \gcmd{mgls\-unset}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{multi-label}}
+ \desc{globally unsets the first use flag for the given multi-entry}
+ }
+ % \mglsreset
+ \gcmd{mgls\-reset}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{multi-label}}
+ \desc{globally resets the first use flag for the given multi-entry}
+ }
+ % \mglslocalunset
+ \gcmd{mgls\-local\-unset}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{multi-label}}
+ \desc{locally unsets the first use flag for the given multi-entry}
+ }
+ % \mglslocalreset
+ \gcmd{mgls\-local\-reset}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{multi-label}}
+ \desc{locally resets the first use flag for the given multi-entry}
+ }
+ % \mglsunsetall
+ \gcmd{mgls\-unset\-all}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{unsets the first use flag for all multi-entries}
+ }
+ % \mglsresetall
+ \gcmd{mgls\-reset\-all}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{resets the first use flag for all multi-entries}
+ }
+ % \mglsSetMain
+ \gcmd{mgls\-Set\-Main}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{multi-label}\margm{new-main-label}}
+ \desc{locally changes the main element for the given multi-entry}
+ }
+ % \mgls
+ \gcmdspa{mgls}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{references a multi-entry identified by the given
+ \meta{multi-label}}
+ }
+ % \mglspl
+ \gcmdspa{mgls\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses the plural form for each element}
+ }
+ % \mglsmainpl
+ \gcmdspa{mgls\-main\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses the plural form for the main element}
+ }
+ % \Mgls
+ \gcmdspa{Mgls}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses \gls{Gls} for the first element}
+ }
+ % \MGls
+ \gcmdspa{MGls}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses \gls{Gls} for all elements}
+ }
+ % \Mglspl
+ \gcmdspa{Mglspl}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses \gls{Glspl} for the first element
+ and \gls{glspl} for the remaining elements}
+ }
+ % \Mglsmainpl
+ \gcmdspa{Mglsmainpl}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} uses \idx{sentencecase} for the first
+ element and the plural form for the main element}
+ }
+ % \MGlspl
+ \gcmdspa{MGls\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses \gls{Glspl} for each element}
+ }
+ % \MGlsmainpl
+ \gcmdspa{MGls\-main\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses \gls{Glspl} for the main entry and
+ \gls{Gls} for the others}
+ }
+ % \MGLS
+ \gcmdspa{MGLS}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses \gls{GLS} for each element}
+ }
+ % \MGLSpl
+ \gcmdspa{MGLS\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses \gls{GLSpl} for each element}
+ }
+ % \MGLSmainpl
+ \gcmdspa{MGLS\-main\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses \gls{GLSpl} for the main element
+ and \gls{GLS} for the others}
+ }
+ % \mglsshort
+ \gcmdspa{mgls\-short}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses \gls{glsxtrshort} for any elements
+ that have the \gloskey{short} field set and \gls{glstext} otherwise}
+ }
+ % \mglslong
+ \gcmdspa{mgls\-long}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses \gls{glsxtrlong} for any elements
+ that have the \gloskey{long} field set and \gls{glstext} otherwise}
+ }
+ % \mglsfull
+ \gcmdspa{mgls\-full}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses \gls{glsxtrfull} for any elements
+ that have the \gloskey{short} field set and \gls{glsfirst} otherwise}
+ }
+ % \Mglsshort
+ \gcmdspa{Mgls\-short}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mglsshort} but \idx{sentencecase}}
+ }
+ % \Mglslong
+ \gcmdspa{Mgls\-long}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mglslong} but \idx{sentencecase}}
+ }
+ % \Mglsfull
+ \gcmdspa{Mgls\-full}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mglsfull} but \idx{sentencecase}}
+ }
+ % \mglsname
+ \gcmdspa{mgls\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses \gls{glsname}}
+ }
+ % \MGlsname
+ \gcmdspa{MGls\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses \gls{Glsname}}
+ }
+ % \Mglsname
+ \gcmdspa{Mgls\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses \gls{Glsname} for the first entry
+ and \gls{glsname} for the remaining entries}
+ }
+ % \mglssymbol
+ \gcmdspa{mgls\-symbol}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses \gls{glssymbol} if the
+ \gloskey{symbol} field is set and \gls{gls} otherwise}
+ }
+ % \MGlssymbol
+ \gcmdspa{MGls\-symbol}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses \gls{glssymbol} if the
+ \gloskey{symbol} field is set and \gls{Gls} otherwise}
+ }
+ % \Mglssymbol
+ \gcmdspa{Mgls\-symbol}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses \gls{glssymbol} if the
+ \gloskey{symbol} field is set, otherwise it uses \gls{Gls} for
+ the first element and \gls{gls} for the remaining elements}
+ }
+ % \mglsusefield
+ \gcmdspa{mgls\-use\-field}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses \gls{glsdisp} if the field
+ identified by \gls{mglsfield} exists with the
+ \idx{linktext} obtained from the field value}
+ }
+ % \Mglsusefield
+ \gcmdspa{Mgls\-use\-field}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mglsusefield} but \idx{sentencecase} for the first
+element}
+ }
+ % \MGlsusefield
+ \gcmdspa{MGls\-use\-field}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mglsusefield} but \idx{sentencecase} for each element}
+ }
+ % \mglsfield
+ \gcmd{mgls\-field}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \initval{useri}
+ \desc{expands to the \idx{internalfieldlabel} required by
+ \gls{mglsusefield}}
+ }
+ % \mpgls
+ \gcmdspa{mpgls}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses \gls{pgls} for the first element}
+ }
+ % \mpglspl
+ \gcmdspa{mpgls\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses \gls{pglspl} for the first element
+ and \gls{glspl} for the remaining elements}
+ }
+ % \mpglsmainpl
+ \gcmdspa{mpgls\-main\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mgls} but uses \gls{pglspl} for the first element
+ if its the main element otherwise \gls{pgls} and, for the remaining
+ elements, uses \gls{glspl} if the element is the main entry or
+ \gls{gls} otherwise}
+ }
+ % \Mpgls
+ \gcmdspa{Mpgls}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mpgls} but \idx{sentencecase} for the first element}
+ }
+ % \Mpglsmain
+ \gcmdspa{Mpglsmainpl}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mpglspl} but \idx{sentencecase} for the first element}
+ }
+ % \MPGls
+ \gcmdspa{MPGls}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mpgls} but \idx{sentencecase} for all elements}
+ }
+ % \MPGlspl
+ \gcmdspa{MPGls\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mpglspl} but \idx{sentencecase} for all elements}
+ }
+ % \MPGlsmainpl
+ \gcmdspa{MPGls\-main\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mpglsmainpl} but \idx{sentencecase} for all elements}
+ }
+ % \MPGLS
+ \gcmdspa{MPGLS}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mpgls} but \idx{allcaps} for the all elements}
+ }
+ % \MPGLSpl
+ \gcmdspa{MPGLSpl}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mpglspl} but \idx{allcaps} for the all elements}
+ }
+ % \MPGLSmainpl
+ \gcmdspa{MPGLS\-main\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\oargm{options}\margm{multi-label}\oargm{insert}}
+ \desc{as \gls{mpglsmainpl} but \idx{allcaps} for the all elements}
+ }
+ % \mglsseefirstitem
+ \gcmd{mgls\-see\-first\-item}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{multi-label}}
+ \desc{formatting command used by cross-reference lists for the
+ first item if the item is a multi-entry}
+ }
+ % \mglsseeitem
+ \gcmd{mgls\-see\-item}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{multi-label}}
+ \desc{formatting command used by cross-reference lists for
+ subsequent items if the item is a multi-entry}
+ }
+ % \glsxtrifmulti
+ \gcmd{gls\-xtr\-if\-multi}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{multi-label}\margm{true}\margm{false}}
+ \desc{does \meta{true} if a multi-entry has been defined with
+ the label \meta{multi-label} otherwise does \meta{false}}
+ }
+ % \glsxtrmultimain
+ \gcmd{gls\-xtr\-multi\-main}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{multi-label}}
+ \desc{expands to the main label for the multi-entry identified
+by \meta{multi-label} or nothing if not defined}
+ }
+ % \glsxtrmultilist
+ \gcmd{gls\-xtr\-multi\-list}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{multi-label}}
+ \desc{expands to the list of element labels for the multi-entry identified
+by \meta{multi-label} or nothing if not defined}
+ }
+ % \mglsforelements
+ \gcmd{mgls\-for\-elements}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{multi-label}\margm{cs}\margm{body}}
+ \desc{iterates over the list of element labels for the multi-entry identified
+by \meta{multi-label}}
+ }
+ % \mglsforotherelements
+ \gcmd{mgls\-for\-other\-elements}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{multi-label}\margm{cs}\margm{body}}
+ \desc{as \gls{mglsforelements} but skips the main entry label}
+ }
+ % \glsxtrmultitotalelements
+ \gcmd{gls\-xtr\-multi\-total\-elements}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{multi-label}}
+ \desc{expands to the total number of elements in the given
+ multi-entry or nothing if \meta{multi-label} hasn't been defined}
+ }
+ % \glsxtrmultimainindex
+ \gcmd{gls\-xtr\-multi\-main\-index}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{multi-label}}
+ \desc{expands to the index of the main element in the given
+ multi-entry or nothing if \meta{multi-label} hasn't been defined}
+ }
+ % \glsxtrmultilastotherindex
+ \gcmd{gls\-xtr\-multi\-last\-other\-index}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{multi-label}}
+ \desc{expands to the index of the final non-main element in the given
+ multi-entry or nothing if \meta{multi-label} hasn't been defined}
+ }
+ % \writemultiglossentry
+ \gcmd{write\-multi\-gloss\-entry}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{options}\margm{multi-label}\margm{main-label}\margm{list}}
+ \desc{writes multi-entry information to the \ext{aux} file}
+ }
+ % \@glsxtr@multientry
+ \gcmd{@gls\-xtr\-@multi\-entry}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{options}\margm{multi-label}\margm{main-label}\margm{list}}
+ \desc{information in the \ext{aux} about a multi-label defined
+ in the previous \LaTeX\ run}
+ }
+ % \glsxtrmultientryadjustedname
+ \gcmd{gls\-xtr\-multi\-entry\-adjust\-ed\-name}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.48+}
+ \syntax{\margm{sublist1}\margm{name}\margm{sublist2}\margm{multi-label}}
+ \desc{used by \resourceopt{compound-adjust-name}}
+ }
+ % \Glsxtrmultientryadjustedname
+ \gcmd{Gls\-xtr\-multi\-entry\-adjust\-ed\-name}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.48+}
+ \syntax{\margm{sublist1}\margm{name}\margm{sublist2}\margm{multi-label}}
+ \desc{as \gls{glsxtrmultientryadjustedname} but \idx{sentencecase}}
+ }
+ % \GlsXtrmultientryadjustedname
+ \gcmd{Gls\-Xtr\-multi\-entry\-adjust\-ed\-name}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.48+}
+ \syntax{\margm{sublist1}\margm{name}\margm{sublist2}\margm{multi-label}}
+ \desc{as \gls{glsxtrmultientryadjustedname} but \idx{titlecase}}
+ }
+ % \GLSxtrmultientryadjustedname
+ \gcmd{GLS\-xtr\-multi\-entry\-adjust\-ed\-name}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.48+}
+ \syntax{\margm{sublist1}\margm{name}\margm{sublist2}\margm{multi-label}}
+ \desc{as \gls{glsxtrmultientryadjustedname} but \idx{allcaps}}
+ }
+ % \glsxtrmultientryadjustednamesep
+ \gcmd{gls\-xtr\-multi\-entry\-adjusted\-name\-sep}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.48+}
+ \syntax{\margm{pre-label}\margm{post-label}}
+ \desc{separator used by \gls{glsxtrmultientryadjustedname}}
+ }
+ % \glsxtrmultientryadjustednamepresep
+ \gcmd{gls\-xtr\-multi\-entry\-adjusted\-name\-pre\-sep}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.48+}
+ \syntax{\margm{pre-label}\margm{post-label}}
+ \desc{separator used by \gls{glsxtrmultientryadjustedname}
+ between the last element of the first sublist and the main element}
+ }
+ % \glsxtrmultientryadjustednamepostsep
+ \gcmd{gls\-xtr\-multi\-entry\-adjusted\-name\-post\-sep}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.48+}
+ \syntax{\margm{pre-label}\margm{post-label}}
+ \desc{separator used by \gls{glsxtrmultientryadjustedname}
+ between the main element and the first element of the second
+ sublist}
+ }
+ % \glsxtrmultientryadjustednamefmt
+ \gcmd{gls\-xtr\-multi\-entry\-adjusted\-name\-fmt}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.48+}
+ \syntax{\margm{text}}
+ \desc{used by \gls{glsxtrmultientryadjustedname}
+ to encapsulate the main entry name}
+ }
+ % \Glsxtrmultientryadjustednamefmt
+ \gcmd{Gls\-xtr\-multi\-entry\-adjusted\-name\-fmt}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.48+}
+ \syntax{\margm{text}}
+ \desc{used by \gls{Glsxtrmultientryadjustedname}
+ to encapsulate the main entry name if the first sublist is empty}
+ }
+ % \GlsXtrmultientryadjustednamefmt
+ \gcmd{Gls\-Xtr\-multi\-entry\-adjusted\-name\-fmt}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.48+}
+ \syntax{\margm{text}}
+ \desc{used by \gls{GlsXtrmultientryadjustedname}
+ to encapsulate the main entry name}
+ }
+ % \GLSxtrmultientryadjustednamefmt
+ \gcmd{GLS\-xtr\-multi\-entry\-adjusted\-name\-fmt}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.48+}
+ \syntax{\margm{text}}
+ \desc{used by \gls{GLSxtrmultientryadjustedname}
+ to encapsulate the main entry name}
+ }
+ % \glsxtrmultientryadjustednameother
+ \gcmd{gls\-xtr\-multi\-entry\-adjusted\-name\-other}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.48+}
+ \syntax{\margm{text}}
+ \desc{used by \gls{glsxtrmultientryadjustedname}
+ to encapsulate the other (not main) entries}
+ }
+ % \Glsxtrmultientryadjustednameother
+ \gcmd{Gls\-xtr\-multi\-entry\-adjusted\-name\-other}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.48+}
+ \syntax{\margm{text}}
+ \desc{used by \gls{Glsxtrmultientryadjustedname}
+ to encapsulate the other (not main) entries}
+ }
+ % \GlsXtrmultientryadjustednameother
+ \gcmd{Gls\-Xtr\-multi\-entry\-adjusted\-name\-other}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.48+}
+ \syntax{\margm{text}}
+ \desc{used by \gls{GlsXtrmultientryadjustedname}
+ to encapsulate the other (not main) entries}
+ }
+ % \GLSxtrmultientryadjustednameother
+ \gcmd{GLS\-xtr\-multi\-entry\-adjusted\-name\-other}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.48+}
+ \syntax{\margm{text}}
+ \desc{used by \gls{GLSxtrmultientryadjustedname}
+ to encapsulate the other (not main) entries}
+ }
+ % \mglselementreset
+ \gcmd{mgls\-element\-reset}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{entry-label}}
+ \desc{used by options such as \mglsopt{resetall} to reset an
+ element's \idx{firstuseflag} (taking the \mglsopt{presetlocal}
+ option into account)}
+ }
+ % \mglselementunset
+ \gcmd{mgls\-element\-unset}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{entry-label}}
+ \desc{used by options such as \mglsopt{unsetall} to unset an
+ element's \idx{firstuseflag} (taking the \mglsopt{presetlocal}
+ option into account)}
+ }
+ % \mglsunsetothers
+ \gcmd{mgls\-unset\-others}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{multi-label}}
+ \desc{globally unsets the \idx{firstuseflag} for the other (not main) elements
+ of the given multi-entry}
+ }
+ % \mglslocalunsetothers
+ \gcmd{mgls\-local\-unset\-others}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{multi-label}}
+ \desc{locally unsets the \idx{firstuseflag} for the other (not main) elements
+ of the given multi-entry}
+ }
+ % MULTI-ENTRY OPTIONS:
+ \gidx{mglsopt}{\name{multi-entry set options}}
+ % option: indexmain
+ \gmglsopt{index\-main}
+ {
+ \syntax{\meta{value}}
+ \initval{true}
+ \defval{true}
+ \desc{indicates if the main element should
+ be \indexed, should only be \indexed\ on \idx{firstuse} or should not indexed}
+ }
+ % option: indexothers
+ \gmglsopt{index\-others}
+ {
+ \syntax{\meta{value}}
+ \initval{true}
+ \defval{true}
+ \desc{indicates if the \qt{other} elements should
+ be \indexed, should only be \indexed\ on \idx{firstuse} or should not indexed}
+ }
+ % option: encapmain
+ \gmglsopt{encap\-main}
+ {
+ \syntax{\meta{value}}
+ \initval{glsnumberformat}
+ \desc{the value to pass to the \glsopt{format} option for the
+ main entry}
+ }
+ % option: encapothers
+ \gmglsopt{encap\-others}
+ {
+ \syntax{\meta{value}}
+ \initval{glsnumberformat}
+ \desc{the value to pass to the \glsopt{format} option for the
+ \qt{other} elements}
+ }
+ % option: postlinks
+ \gmglsopt{post\-links}
+ {
+ \syntax{\meta{value}}
+ \initval{none}
+ \desc{indicates which \idxpl{postlinkhook} should be enabled}
+ }
+ % option: mpostlink
+ \gmglsopt{mpost\-link}
+ {
+ \syntax{\meta{value}}
+ \initval{true}
+ \defval{true}
+ \desc{indicates whether or not the multi-entry post-link hook
+ should be enabled and, if so, whether it should only be enabled
+ on \idxc{mfirstuse}{first} or \idxc{msubsequentuse}{subsequent} use}
+ }
+ % option: mpostlinkelement
+ \gmglsopt{mpost\-link\-element}
+ {
+ \syntax{\meta{value}}
+ \initval{last}
+ \desc{indicates which \idx{postlinkhook} to use if the
+ multi-entry post-link hook has been enabled}
+ }
+ % option: firstprefix
+ \gmglsopt{first\-prefix}
+ {
+ \syntax{\meta{value}}
+ \desc{the prefix to use on \idx{firstuse} of the multi-entry}
+ }
+ % option: usedprefix
+ \gmglsopt{used\-prefix}
+ {
+ \syntax{\meta{value}}
+ \desc{the prefix to use on \idx{subsequentuse} of the multi-entry}
+ }
+ % option: firstsuffix
+ \gmglsopt{first\-suffix}
+ {
+ \syntax{\meta{value}}
+ \desc{the suffix to use on \idx{mfirstuse} of the multi-entry}
+ }
+ % option: usedsuffix
+ \gmglsopt{used\-suffix}
+ {
+ \syntax{\meta{value}}
+ \desc{the suffix to use on \idx{msubsequentuse} of the multi-entry}
+ }
+ % option: firstskipmain
+ \gmglsopt{first\-skip\-main}
+ {
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \desc{determines whether or not to skip the main entry on \idx{mfirstuse}}
+ }
+ % option: firstskipothers
+ \gmglsopt{first\-skip\-others}
+ {
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \desc{determines whether or not to skip the \qt{other} elements on \idx{mfirstuse}}
+ }
+ % option: usedskipmain
+ \gmglsopt{used\-skip\-main}
+ {
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \desc{determines whether or not to skip the main entry on
+ \idx{msubsequentuse}}
+ }
+ % option: usedskipothers
+ \gmglsopt{used\-skip\-others}
+ {
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \desc{determines whether or not to skip the \qt{other} elements
+ on \idx{msubsequentuse}}
+ }
+ % option: hyper (\multiglossaryentry)
+ \gmglsopt{multi.hyper}
+ {
+ \name{hyper}
+ \syntax{\meta{value}}
+ \initval{individual}
+ \desc{indicates which elements should have hyperlinks, if
+ supported. This option is a multi-entry setting, see
+ \sectionref{sec:multiglsoptions}}
+ }
+ % option: hyper (\mgls)
+ \gmglsopt{hyper}
+ {
+ \syntax{\meta{boolean}}
+ \defval{true}
+ \desc{indicates whether or not to use hyperlinks, if supported,
+ for all elements. This option is for use in the optional
+ argument of \gls{mgls} and can be set implicitly with the
+ default behaviour of the \cmdmod{star} and \cmdmod{plus} modifiers}
+ }
+ % option: textformat
+ \gmglsopt{text\-format}
+ {
+ \syntax{\meta{value}}
+ \initval{@firstofone}
+ \desc{the control sequence name of the command that should
+ encapsulate the entire content}
+ }
+ % option: category
+ \gmglsopt{category}
+ {
+ \syntax{\meta{category-label}}
+ \desc{the category to assign to the multi-entry set}
+ }
+ % option: mglsopts
+ \gmglsopt{mgls\-opts}
+ {
+ \syntax{\meta{option list}}
+ \desc{the default options to pass to commands like \gls{mgls}}
+ }
+ % option: setup
+ \gmglsopt{set\-up}
+ {
+ \syntax{\meta{option list}}
+ \desc{multi-entry options that will override any conflicting
+ options already assigned to the multi-entry}
+ }
+ % option: all
+ \gmglsopt{all}
+ {
+ \syntax{\meta{option list}}
+ \desc{options to pass to the \idx{glslike} command for each element}
+ }
+ % option: main
+ \gmglsopt{main}
+ {
+ \syntax{\meta{option list}}
+ \desc{options to pass to the \idx{glslike} command for the main entry}
+ }
+ % option: others
+ \gmglsopt{others}
+ {
+ \syntax{\meta{option list}}
+ \desc{options to pass to the \idx{glslike} command for the \qt{other}
+ elements}
+ }
+ % option: multiunset
+ \gmglsopt{multi\-un\-set}
+ {
+ \syntax{\meta{value}}
+ \initval{global}
+ \desc{indicates whether or not the \idx{mfirstuseflag} should be unset}
+ }
+ % option: presetlocal
+ \gmglsopt{pre\-set\-local}
+ {
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \desc{indicates whether or not the prereset options should have
+ a local or global effect}
+ }
+ % option: resetall
+ \gmglsopt{reset\-all}
+ {
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \desc{indicates whether or not to reset all elements'
+ \idx{firstuseflag} before using \gls{gls}}
+ }
+ % option: resetmain
+ \gmglsopt{reset\-main}
+ {
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \desc{indicates whether or not to reset the main entry's
+ \idx{firstuseflag} before using \gls{gls}}
+ }
+ % option: resetothers
+ \gmglsopt{reset\-others}
+ {
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \desc{indicates whether or not to reset all \qt{other} elements'
+ \idx{firstuseflag} before using \gls{gls}}
+ }
+ % option: unsetall
+ \gmglsopt{unset\-all}
+ {
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \desc{indicates whether or not to unset all elements'
+ \idx{firstuseflag} before using \gls{gls}}
+ }
+ % option: unsetmain
+ \gmglsopt{unset\-main}
+ {
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \desc{indicates whether or not to unset the main entry's
+ \idx{firstuseflag} before using \gls{gls}}
+ }
+ % option: unsetothers
+ \gmglsopt{unset\-others}
+ {
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \desc{indicates whether or not to unset all \qt{other} elements'
+ \idx{firstuseflag} before using \gls{gls}}
+ }
+ % COMMANDS: PREFIXES
+ % \pgls
+ \gcmdspa{pgls}{%
+ \providedby{\sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{similar to \gls{gls} but inserts the appropriate prefix,
+ if provided}
+ }
+ % \Pgls
+ \gcmdspa{Pgls}{%
+ \providedby{\sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{pgls} but \idx{sentencecase}}
+ }
+ % \PGLS
+ \gcmdspa{PGLS}{%
+ \providedby{\sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{pgls} but \idx{allcaps}}
+ }
+ % \pglspl
+ \gcmdspa{pgls\-pl}{%
+ \providedby{\sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{similar to \gls{glspl} but inserts the appropriate prefix,
+ if provided}
+ }
+ % \Pglspl
+ \gcmdspa{Pgls\-pl}{%
+ \providedby{\sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{pgls} but \idx{sentencecase}}
+ }
+ % \PGLSpl
+ \gcmdspa{PGLS\-pl}{%
+ \providedby{\sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{pgls} but \idx{allcaps}}
+ }
+ % \glsprefixsep
+ \gcmd{glsprefixsep}
+ {
+ \providedby{\sty{glossaries-prefix} v4.45+}
+ \initvalempty
+ \desc{separator between the prefix and the term}
+ }
+ % COMMANDS: PREFIXES (glossaries-extra)
+ % \pglsxtrshort
+ \gcmdspa{pgls\-xtr\-short}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsxtrshort} but inserts the \gloskey{prefix}
+ field and separator in front if set}
+ }
+ % \pglsxtrshortpl
+ \gcmdspa{pgls\-xtr\-short\-pl}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsxtrshortpl} but inserts the \gloskey{prefixplural}
+ field and separator in front if set}
+ }
+ % \pglsxtrlong
+ \gcmdspa{pgls\-xtr\-long}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsxtrlong} but inserts the \gloskey{prefixfirst}
+ field and separator in front if set}
+ }
+ % \pglsxtrlongpl
+ \gcmdspa{pgls\-xtr\-long\-pl}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsxtrlongpl} but inserts the \gloskey{prefixfirstplural}
+ field and separator in front if set}
+ }
+ % \Pglsxtrshort
+ \gcmdspa{Pgls\-xtr\-short}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{pglsxtrshort} but \idx{sentencecase}}
+ }
+ % \Pglsxtrshortpl
+ \gcmdspa{Pgls\-xtr\-short\-pl}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{pglsxtrshortpl} but \idx{sentencecase}}
+ }
+ % \Pglsxtrlong
+ \gcmdspa{Pgls\-xtr\-long}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{pglsxtrlong} but \idx{sentencecase}}
+ }
+ % \Pglsxtrlongpl
+ \gcmdspa{Pgls\-xtr\-long\-pl}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{pglsxtrlongpl} but \idx{sentencecase}}
+ }
+ % \PGLSxtrshort
+ \gcmdspa{PGLS\-xtr\-short}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{pglsxtrshort} but \idx{allcaps}}
+ }
+ % \PGLSxtrshortpl
+ \gcmdspa{PGLS\-xtr\-short\-pl}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{pglsxtrshortpl} but \idx{allcaps}}
+ }
+ % \PGLSxtrlong
+ \gcmdspa{PGLS\-xtr\-long}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{pglsxtrlong} but \idx{allcaps}}
+ }
+ % \PGLSxtrlongpl
+ \gcmdspa{PGLS\-xtr\-long\-pl}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{pglsxtrlongpl} but \idx{allcaps}}
+ }
+ % \pglsfmtshort
+ \gcmdspa{pgls\-fmt\-short}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsfmtshort} but inserts the \gloskey{prefix}
+ field and separator in front if set}
+ }
+ % \pglsfmtshortpl
+ \gcmdspa{pgls\-fmt\-short\-pl}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsfmtshortpl} but inserts the \gloskey{prefixplural}
+ field and separator in front if set}
+ }
+ % \pglsfmtlong
+ \gcmdspa{pgls\-fmt\-long}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsfmtlong} but inserts the \gloskey{prefixfirst}
+ field and separator in front if set}
+ }
+ % \pglsfmtlongpl
+ \gcmdspa{pgls\-fmt\-long\-pl}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{glsfmtlongpl} but inserts the \gloskey{prefixfirstplural}
+ field and separator in front if set}
+ }
+ % \Pglsfmtshort
+ \gcmdspa{Pgls\-fmt\-short}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{pglsfmtshort} but \idx{sentencecase}}
+ }
+ % \Pglsfmtshortpl
+ \gcmdspa{Pgls\-fmt\-short\-pl}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{pglsfmtshortpl} but \idx{sentencecase}}
+ }
+ % \PGLSfmtshort
+ \gcmdspa{PGLS\-fmt\-short}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{pglsfmtshort} but \idx{allcaps}}
+ }
+ % \PGLSfmtshortpl
+ \gcmdspa{PGLS\-fmt\-short\-pl}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{pglsfmtshortpl} but \idx{allcaps}}
+ }
+ % \Pglsfmtlong
+ \gcmdspa{Pgls\-fmt\-long}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{pglsfmtlong} but \idx{sentencecase}}
+ }
+ % \Pglsfmtlongpl
+ \gcmdspa{Pgls\-fmt\-long\-pl}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{pglsfmtlongpl} but \idx{sentencecase}}
+ }
+ % \PGLSfmtlong
+ \gcmdspa{PGLS\-fmt\-long}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{pglsfmtlong} but \idx{allcaps}}
+ }
+ % \PGLSfmtlongpl
+ \gcmdspa{PGLS\-fmt\-long\-pl}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \note{requires \sty{glossaries-prefix}}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{as \gls{pglsfmtlongpl} but \idx{allcaps}}
+ }
+ % \Pglsxtrtitleshort
+ \gcmd{Pgls\-xtr\-title\-short}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \note{requires \sty{glossaries-prefix}}
+ \desc{the normal behaviour of \gls{Pglsfmtshort}}
+ }
+ % \Pglsxtrtitleshortpl
+ \gcmd{Pgls\-xtr\-title\-short\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \note{requires \sty{glossaries-prefix}}
+ \desc{the normal behaviour of \gls{Pglsfmtshortpl}}
+ }
+ % \Pglsxtrtitlelong
+ \gcmd{Pgls\-xtr\-title\-long}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \note{requires \sty{glossaries-prefix}}
+ \desc{the normal behaviour of \gls{Pglsfmtlong}}
+ }
+ % \Pglsxtrtitlelongpl
+ \gcmd{Pgls\-xtr\-title\-long\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \note{requires \sty{glossaries-prefix}}
+ \desc{the normal behaviour of \gls{Pglsfmtlongpl}}
+ }
+ % COMMANDS: ACCESSIBILITY
+ % \glsentrysymbolaccess
+ \gcmd{gls\-entry\-symbol\-access}
+ {
+ \providedby{\sty{glossaries-accsupp}}
+ \syntax{\margm{entry-label}}
+ \desc{as \gls{glsentrysymbol} but for the \gloskey{symbolaccess} field}
+ }
+ % \glsxtrassignactualsetup
+ \gcmd{gls\-xtr\-assign\-actual\-set\-up}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \note{requires \opt{accsupp}}
+ \desc{used to strip common formatting commands from a field
+ value to supply the text-only accessibility content when
+ initialising the default \gloskey{shortaccess} and
+ \gloskey{shortpluralaccess} values}
+ }
+ % \glsdefaultshortaccess
+ \gcmd{gls\-default\-short\-access}
+ {
+ \note{requires \opt{accsupp}}
+ \providedby{\sty{glossaries-accsupp} v4.45+}
+ \syntax{\margm{long}\margm{short}}
+ \desc{used when \gls{newabbreviation} automatically assigns
+ \gloskey{shortaccess}. This is defined by
+ \sty{glossaries-accsupp} to just do \meta{long} but is redefined by
+ \sty{glossaries-extra} to do \code{\meta{long} (\meta{short})}}
+ }
+ % \glsnameaccessdisplay
+ \gcmd{gls\-name\-access\-display}
+ {
+ \providedby{\sty{glossaries-accsupp}}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{does \meta{text} with the \gloskey{access} replacement
+ text (if set)}
+ }
+ % \glstextaccessdisplay
+ \gcmd{gls\-text\-access\-display}
+ {
+ \providedby{\sty{glossaries-accsupp}}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{does \meta{text} with the \gloskey{textaccess} replacement
+ text (if set)}
+ }
+ % \glspluralaccessdisplay
+ \gcmd{gls\-plural\-access\-display}
+ {
+ \providedby{\sty{glossaries-accsupp}}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{does \meta{text} with the \gloskey{pluralaccess} replacement
+ text (if set)}
+ }
+ % \glsfirstaccessdisplay
+ \gcmd{gls\-first\-access\-display}
+ {
+ \providedby{\sty{glossaries-accsupp}}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{does \meta{text} with the \gloskey{firstaccess} replacement
+ text (if set)}
+ }
+ % \glsfirstpluralaccessdisplay
+ \gcmd{gls\-first\-plural\-access\-display}
+ {
+ \providedby{\sty{glossaries-accsupp}}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{does \meta{text} with the \gloskey{firstpluralaccess} replacement
+ text (if set)}
+ }
+ % \glssymbolaccessdisplay
+ \gcmd{gls\-symbol\-access\-display}
+ {
+ \providedby{\sty{glossaries-accsupp}}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{does \meta{text} with the \gloskey{symbolaccess} replacement
+ text (if set)}
+ }
+ % \glssymbolpluralaccessdisplay
+ \gcmd{gls\-symbol\-plural\-access\-display}
+ {
+ \providedby{\sty{glossaries-accsupp}}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{does \meta{text} with the \gloskey{symbolpluralaccess} replacement
+ text (if set)}
+ }
+ % \glsdescriptionaccessdisplay
+ \gcmd{gls\-description\-access\-display}
+ {
+ \providedby{\sty{glossaries-accsupp}}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{does \meta{text} with the \gloskey{descriptionaccess} replacement
+ text (if set)}
+ }
+ % \glsdescriptionpluralaccessdisplay
+ \gcmd{gls\-description\-plural\-access\-display}
+ {
+ \providedby{\sty{glossaries-accsupp}}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{does \meta{text} with the \gloskey{descriptionpluralaccess} replacement
+ text (if set)}
+ }
+ % \glsshortaccessdisplay
+ \gcmd{gls\-short\-access\-display}
+ {
+ \providedby{\sty{glossaries-accsupp}}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{does \meta{text} with the \gloskey{shortaccess} replacement
+ text (if set)}
+ }
+ % \glsshortpluralaccessdisplay
+ \gcmd{gls\-short\-plural\-access\-display}
+ {
+ \providedby{\sty{glossaries-accsupp}}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{does \meta{text} with the \gloskey{shortpluralaccess} replacement
+ text (if set)}
+ }
+ % \glslongaccessdisplay
+ \gcmd{gls\-long\-access\-display}
+ {
+ \providedby{\sty{glossaries-accsupp}}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{does \meta{text} with the \gloskey{longaccess} replacement
+ text (if set)}
+ }
+ % \glslongpluralaccessdisplay
+ \gcmd{gls\-long\-plural\-access\-display}
+ {
+ \providedby{\sty{glossaries-accsupp}}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{does \meta{text} with the \gloskey{longpluralaccess} replacement
+ text (if set)}
+ }
+ % \glsuseriaccessdisplay
+ \gcmd{gls\-user\-i\-access\-display}
+ {
+ \providedby{\sty{glossaries-accsupp} v4.45+}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{does \meta{text} with the \gloskey{user1access} replacement
+ text (if set)}
+ }
+ % \glsuseriiaccessdisplay
+ \gcmd{gls\-user\-ii\-access\-display}
+ {
+ \providedby{\sty{glossaries-accsupp} v4.45+}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{does \meta{text} with the \gloskey{user2access} replacement
+ text (if set)}
+ }
+ % \glsuseriiiaccessdisplay
+ \gcmd{gls\-user\-iii\-access\-display}
+ {
+ \providedby{\sty{glossaries-accsupp} v4.45+}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{does \meta{text} with the \gloskey{user3access} replacement
+ text (if set)}
+ }
+ % \glsuserivaccessdisplay
+ \gcmd{gls\-user\-iv\-access\-display}
+ {
+ \providedby{\sty{glossaries-accsupp} v4.45+}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{does \meta{text} with the \gloskey{user4access} replacement
+ text (if set)}
+ }
+ % \glsuservaccessdisplay
+ \gcmd{gls\-user\-v\-access\-display}
+ {
+ \providedby{\sty{glossaries-accsupp} v4.45+}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{does \meta{text} with the \gloskey{user5access} replacement
+ text (if set)}
+ }
+ % \glsuserviaccessdisplay
+ \gcmd{gls\-user\-vi\-access\-display}
+ {
+ \providedby{\sty{glossaries-accsupp} v4.45+}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{does \meta{text} with the \gloskey{user6access} replacement
+ text (if set)}
+ }
+ % \glsaccessname
+ \gcmd{gls\-access\-name}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.3+}
+ \syntax{\margm{entry-label}}
+ \desc{if accessibility support was enabled when
+ \sty{glossaries-extra} was loaded (\opt{accsupp}) this will
+ display the value of the \gloskey{name} key with the accessibility
+ support enabled for that key (\gloskey{access}). If there is no accessibility
+ support, this just uses \gls{glsentryname}}
+ }
+ % \Glsaccessname
+ \gcmd{Gls\-access\-name}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.1+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{sentencecase} version of \gls{glsaccessname}}
+ }
+ % \GLSaccessname
+ \gcmd{GLS\-access\-name}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.2+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{allcaps} version of \gls{glsaccessname}}
+ }
+ % \glsaccesstext
+ \gcmd{gls\-access\-text}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.3+}
+ \syntax{\margm{entry-label}}
+ \desc{if accessibility support was enabled when
+ \sty{glossaries-extra} was loaded (\opt{accsupp}) this will
+ display the value of the \gloskey{text} key with the accessibility
+ support enabled for that key (\gloskey{textaccess}). If there is no accessibility
+ support, this just uses \gls{glsentrytext}}
+ }
+ % \Glsaccesstext
+ \gcmd{Gls\-access\-text}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.1+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{sentencecase} version of \gls{glsaccesstext}}
+ }
+ % \GLSaccesstext
+ \gcmd{GLS\-access\-text}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.2+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{allcaps} version of \gls{glsaccesstext}}
+ }
+ % \glsaccessplural
+ \gcmd{gls\-access\-plural}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.3+}
+ \syntax{\margm{entry-label}}
+ \desc{if accessibility support was enabled when
+ \sty{glossaries-extra} was loaded (\opt{accsupp}) this will
+ display the value of the \gloskey{plural} key with the accessibility
+ support enabled for that key (\gloskey{pluralaccess}). If there is
+ no accessibility support, this just uses \gls{glsentryplural}}
+ }
+ % \Glsaccessplural
+ \gcmd{Gls\-access\-plural}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.1+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{sentencecase} version of \gls{glsaccessplural}}
+ }
+ % \GLSaccessplural
+ \gcmd{GLS\-access\-plural}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.2+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{allcaps} version of \gls{glsaccessplural}}
+ }
+ % \glsaccessfirst
+ \gcmd{gls\-access\-first}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.3+}
+ \syntax{\margm{entry-label}}
+ \desc{if accessibility support was enabled when
+ \sty{glossaries-extra} was loaded (\opt{accsupp}) this will
+ display the value of the \gloskey{first} key with the accessibility
+ support enabled for that key (\gloskey{firstaccess}). If there is
+ no accessibility support, this just uses \gls{glsentryfirst}}
+ }
+ % \Glsaccessfirst
+ \gcmd{Gls\-access\-first}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.1+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{sentencecase} version of \gls{glsaccessfirst}}
+ }
+ % \GLSaccessfirst
+ \gcmd{GLS\-access\-first}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.2+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{allcaps} version of \gls{glsaccessfirst}}
+ }
+ % \glsaccessfirstplural
+ \gcmd{gls\-access\-firstplural}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.3+}
+ \syntax{\margm{entry-label}}
+ \desc{if accessibility support was enabled when
+ \sty{glossaries-extra} was loaded (\opt{accsupp}) this will
+ display the value of the \gloskey{firstplural} key with the accessibility
+ support enabled for that key (\gloskey{firstpluralaccess}). If there is
+ no accessibility support, this just uses \gls{glsentryfirstplural}}
+ }
+ % \Glsaccessfirstplural
+ \gcmd{Gls\-access\-firstplural}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.1+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{sentencecase} version of \gls{glsaccessfirstplural}}
+ }
+ % \GLSaccessfirstplural
+ \gcmd{GLS\-access\-firstplural}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.2+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{allcaps} version of \gls{glsaccessfirstplural}}
+ }
+ % \glsaccesssymbol
+ \gcmd{gls\-access\-symbol}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.3+}
+ \syntax{\margm{entry-label}}
+ \desc{if accessibility support was enabled when
+ \sty{glossaries-extra} was loaded (\opt{accsupp}) this will
+ display the value of the \gloskey{symbol} key with the accessibility
+ support enabled for that key (\gloskey{symbolaccess}). If there is
+ no accessibility support, this just uses \gls{glsentrysymbol}}
+ }
+ % \Glsaccesssymbol
+ \gcmd{Gls\-access\-symbol}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.1+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{sentencecase} version of \gls{glsaccesssymbol}}
+ }
+ % \GLSaccesssymbol
+ \gcmd{GLS\-access\-symbol}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.2+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{allcaps} version of \gls{glsaccesssymbol}}
+ }
+ % \glsaccesssymbolplural
+ \gcmd{gls\-access\-symbolplural}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.3+}
+ \syntax{\margm{entry-label}}
+ \desc{if accessibility support was enabled when
+ \sty{glossaries-extra} was loaded (\opt{accsupp}) this will
+ display the value of the \gloskey{symbolplural} key with the accessibility
+ support enabled for that key (\gloskey{symbolpluralaccess}). If there is
+ no accessibility support, this just uses \gls{glsentrysymbolplural}}
+ }
+ % \Glsaccesssymbolplural
+ \gcmd{Gls\-access\-symbolplural}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.1+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{sentencecase} version of \gls{glsaccesssymbolplural}}
+ }
+ % \GLSaccesssymbolplural
+ \gcmd{GLS\-access\-symbolplural}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.2+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{allcaps} version of \gls{glsaccesssymbolplural}}
+ }
+ % \glsaccessdesc
+ \gcmd{gls\-access\-desc}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.3+}
+ \syntax{\margm{entry-label}}
+ \desc{if accessibility support was enabled when
+ \sty{glossaries-extra} was loaded (\opt{accsupp}) this will
+ display the value of the \gloskey{description} key with the accessibility
+ support enabled for that key (\gloskey{descriptionaccess}). If there is
+ no accessibility support, this just uses \gls{glsentrydesc}}
+ }
+ % \Glsaccessdesc
+ \gcmd{Gls\-access\-desc}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.1+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{sentencecase} version of \gls{glsaccessdesc}}
+ }
+ % \GLSaccessdesc
+ \gcmd{GLS\-access\-desc}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.2+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{allcaps} version of \gls{glsaccessdesc}}
+ }
+ % \glsaccessdescplural
+ \gcmd{gls\-access\-desc\-plural}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.3+}
+ \syntax{\margm{entry-label}}
+ \desc{if accessibility support was enabled when
+ \sty{glossaries-extra} was loaded (\opt{accsupp}) this will
+ display the value of the \gloskey{descriptionplural} key with the accessibility
+ support enabled for that key (\gloskey{descriptionpluralaccess}). If there is
+ no accessibility support, this just uses \gls{glsentrydescplural}}
+ }
+ % \Glsaccessdescplural
+ \gcmd{Gls\-access\-desc\-plural}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.1+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{sentencecase} version of \gls{glsaccessdescplural}}
+ }
+ % \GLSaccessdescplural
+ \gcmd{GLS\-access\-desc\-plural}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.2+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{allcaps} version of \gls{glsaccessdescplural}}
+ }
+ % \glsaccessshort
+ \gcmd{gls\-access\-short}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.3+}
+ \syntax{\margm{entry-label}}
+ \desc{if accessibility support was enabled when
+ \sty{glossaries-extra} was loaded (\opt{accsupp}) this will
+ display the value of the \gloskey{short} key with the accessibility
+ support enabled for that key (\gloskey{shortaccess}). If there is
+ no accessibility support, this just uses \gls{glsentryshort}}
+ }
+ % \Glsaccessshort
+ \gcmd{Gls\-access\-short}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.1+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{sentencecase} version of \gls{glsaccessshort}}
+ }
+ % \GLSaccessshort
+ \gcmd{GLS\-access\-short}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.2+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{allcaps} version of \gls{glsaccessshort}}
+ }
+ % \glsaccessshortpl
+ \gcmd{gls\-access\-shortpl}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.3+}
+ \syntax{\margm{entry-label}}
+ \desc{if accessibility support was enabled when
+ \sty{glossaries-extra} was loaded (\opt{accsupp}) this will
+ display the value of the \gloskey{shortplural} key with the accessibility
+ support enabled for that key (\gloskey{shortpluralaccess}). If there is
+ no accessibility support, this just uses \gls{glsentryshortpl}}
+ }
+ % \Glsaccessshortpl
+ \gcmd{Gls\-access\-shortpl}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.1+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{sentencecase} version of \gls{glsaccessshortpl}}
+ }
+ % \GLSaccessshortpl
+ \gcmd{GLS\-access\-shortpl}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.2+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{allcaps} version of \gls{glsaccessshortpl}}
+ }
+ % \glsaccesslong
+ \gcmd{gls\-access\-long}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.3+}
+ \syntax{\margm{entry-label}}
+ \desc{if accessibility support was enabled when
+ \sty{glossaries-extra} was loaded (\opt{accsupp}) this will
+ display the value of the \gloskey{long} key with the accessibility
+ support enabled for that key (\gloskey{longaccess}). If there is
+ no accessibility support, this just uses \gls{glsentrylong}}
+ }
+ % \Glsaccesslong
+ \gcmd{Gls\-access\-long}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.1+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{sentencecase} version of \gls{glsaccesslong}}
+ }
+ % \GLSaccesslong
+ \gcmd{GLS\-access\-long}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.2+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{allcaps} version of \gls{glsaccesslong}}
+ }
+ % \glsaccesslongpl
+ \gcmd{gls\-access\-longpl}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.3+}
+ \syntax{\margm{entry-label}}
+ \desc{if accessibility support was enabled when
+ \sty{glossaries-extra} was loaded (\opt{accsupp}) this will
+ display the value of the \gloskey{longplural} key with the accessibility
+ support enabled for that key (\gloskey{longpluralaccess}). If there is
+ no accessibility support, this just uses \gls{glsentrylongpl}}
+ }
+ % \Glsaccesslongpl
+ \gcmd{Gls\-access\-longpl}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.1+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{sentencecase} version of \gls{glsaccesslongpl}}
+ }
+ % \GLSaccesslongpl
+ \gcmd{GLS\-access\-longpl}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.2+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{allcaps} version of \gls{glsaccesslongpl}}
+ }
+ % \glsaccessuseri
+ \gcmd{gls\-access\-useri}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{if accessibility support was enabled when
+ \sty{glossaries-extra} was loaded (\opt{accsupp}) this will
+ display the value of the \gloskey{user1} key with the accessibility
+ support enabled for that key (\gloskey{user1access}). If there is
+ no accessibility support, this just uses \gls{glsentryuseri}}
+ }
+ % \Glsaccessuseri
+ \gcmd{Gls\-access\-useri}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{sentencecase} version of \gls{glsaccessuseri}}
+ }
+ % \GLSaccessuseri
+ \gcmd{GLS\-access\-useri}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{allcaps} version of \gls{glsaccessuseri}}
+ }
+ % \glsaccessuserii
+ \gcmd{gls\-access\-userii}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{if accessibility support was enabled when
+ \sty{glossaries-extra} was loaded (\opt{accsupp}) this will
+ display the value of the \gloskey{user2} key with the accessibility
+ support enabled for that key (\gloskey{user2access}). If there is
+ no accessibility support, this just uses \gls{glsentryuserii}}
+ }
+ % \Glsaccessuserii
+ \gcmd{Gls\-access\-userii}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{sentencecase} version of \gls{glsaccessuserii}}
+ }
+ % \GLSaccessuserii
+ \gcmd{GLS\-access\-userii}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{allcaps} version of \gls{glsaccessuserii}}
+ }
+ % \glsaccessuseriii
+ \gcmd{gls\-access\-useriii}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{if accessibility support was enabled when
+ \sty{glossaries-extra} was loaded (\opt{accsupp}) this will
+ display the value of the \gloskey{user3} key with the accessibility
+ support enabled for that key (\gloskey{user3access}). If there is
+ no accessibility support, this just uses \gls{glsentryuseriii}}
+ }
+ % \Glsaccessuseriii
+ \gcmd{Gls\-access\-useriii}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{sentencecase} version of \gls{glsaccessuseriii}}
+ }
+ % \GLSaccessuseriii
+ \gcmd{GLS\-access\-useriii}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{allcaps} version of \gls{glsaccessuseriii}}
+ }
+ % \glsaccessuseriv
+ \gcmd{gls\-access\-useriv}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{if accessibility support was enabled when
+ \sty{glossaries-extra} was loaded (\opt{accsupp}) this will
+ display the value of the \gloskey{user4} key with the accessibility
+ support enabled for that key (\gloskey{user4access}). If there is
+ no accessibility support, this just uses \gls{glsentryuseriv}}
+ }
+ % \Glsaccessuseriv
+ \gcmd{Gls\-access\-useriv}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{sentencecase} version of \gls{glsaccessuseriv}}
+ }
+ % \GLSaccessuseriv
+ \gcmd{GLS\-access\-useriv}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{allcaps} version of \gls{glsaccessuseriv}}
+ }
+ % \glsaccessuserv
+ \gcmd{gls\-access\-userv}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{if accessibility support was enabled when
+ \sty{glossaries-extra} was loaded (\opt{accsupp}) this will
+ display the value of the \gloskey{user5} key with the accessibility
+ support enabled for that key (\gloskey{user5access}). If there is
+ no accessibility support, this just uses \gls{glsentryuserv}}
+ }
+ % \Glsaccessuserv
+ \gcmd{Gls\-access\-userv}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{sentencecase} version of \gls{glsaccessuserv}}
+ }
+ % \GLSaccessuserv
+ \gcmd{GLS\-access\-userv}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{allcaps} version of \gls{glsaccessuserv}}
+ }
+ % \glsaccessuservi
+ \gcmd{gls\-access\-uservi}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{if accessibility support was enabled when
+ \sty{glossaries-extra} was loaded (\opt{accsupp}) this will
+ display the value of the \gloskey{user6} key with the accessibility
+ support enabled for that key (\gloskey{user6access}). If there is
+ no accessibility support, this just uses \gls{glsentryuservi}}
+ }
+ % \Glsaccessuservi
+ \gcmd{Gls\-access\-uservi}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{sentencecase} version of \gls{glsaccessuservi}}
+ }
+ % \GLSaccessuservi
+ \gcmd{GLS\-access\-uservi}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{the \idx{allcaps} version of \gls{glsaccessuservi}}
+ }
+ % \glsaccessfmtname
+ \gcmd{gls\-access\-fmt\-name}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{glsaccessname} but formats the displayed
+ text with \gls{glsfmtfield}}
+ }
+ % \Glsaccessfmtname
+ \gcmd{Gls\-access\-fmt\-name}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{Glsaccessname} but formats the displayed
+ text with \gls{Glsfmtfield}}
+ }
+ % \GLSaccessfmtname
+ \gcmd{GLS\-access\-fmt\-name}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{GLSaccessname} but formats the displayed
+ text with \gls{GLSfmtfield}}
+ }
+ % \glsaccessfmttext
+ \gcmd{gls\-access\-fmt\-text}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{glsaccesstext} but formats the displayed
+ text with \gls{glsfmtfield}}
+ }
+ % \Glsaccessfmttext
+ \gcmd{Gls\-access\-fmt\-text}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{Glsaccesstext} but formats the displayed
+ text with \gls{Glsfmtfield}}
+ }
+ % \GLSaccessfmttext
+ \gcmd{GLS\-access\-fmt\-text}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{GLSaccesstext} but formats the displayed
+ text with \gls{GLSfmtfield}}
+ }
+ % \glsaccessfmtplural
+ \gcmd{gls\-access\-fmt\-plural}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{glsaccessplural} but formats the displayed
+ text with \gls{glsfmtfield}}
+ }
+ % \Glsaccessfmtplural
+ \gcmd{Gls\-access\-fmt\-plural}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{Glsaccessplural} but formats the displayed
+ text with \gls{Glsfmtfield}}
+ }
+ % \GLSaccessfmtplural
+ \gcmd{GLS\-access\-fmt\-plural}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{GLSaccessplural} but formats the displayed
+ text with \gls{GLSfmtfield}}
+ }
+ % \glsaccessfmtfirst
+ \gcmd{gls\-access\-fmt\-first}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{glsaccessfirst} but formats the displayed
+ text with \gls{glsfmtfield}}
+ }
+ % \Glsaccessfmtfirst
+ \gcmd{Gls\-access\-fmt\-first}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{Glsaccessfirst} but formats the displayed
+ text with \gls{Glsfmtfield}}
+ }
+ % \GLSaccessfmtfirst
+ \gcmd{GLS\-access\-fmt\-first}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{GLSaccessfirst} but formats the displayed
+ text with \gls{GLSfmtfield}}
+ }
+ % \glsaccessfmtfirstplural
+ \gcmd{gls\-access\-fmt\-first\-plural}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{glsaccessfirstplural} but formats the displayed
+ text with \gls{glsfmtfield}}
+ }
+ % \Glsaccessfmtfirstplural
+ \gcmd{Gls\-access\-fmt\-first\-plural}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{Glsaccessfirstplural} but formats the displayed
+ text with \gls{Glsfmtfield}}
+ }
+ % \GLSaccessfmtfirstplural
+ \gcmd{GLS\-access\-fmt\-first\-plural}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{GLSaccessfirstplural} but formats the displayed
+ text with \gls{GLSfmtfield}}
+ }
+ % \glsaccessfmtsymbol
+ \gcmd{gls\-access\-fmt\-symbol}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{glsaccesssymbol} but formats the displayed
+ text with \gls{glsfmtfield}}
+ }
+ % \Glsaccessfmtsymbol
+ \gcmd{Gls\-access\-fmt\-symbol}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{Glsaccesssymbol} but formats the displayed
+ text with \gls{Glsfmtfield}}
+ }
+ % \GLSaccessfmtsymbol
+ \gcmd{GLS\-access\-fmt\-symbol}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{GLSaccesssymbol} but formats the displayed
+ text with \gls{GLSfmtfield}}
+ }
+ % \glsaccessfmtsymbolplural
+ \gcmd{gls\-access\-fmt\-symbol\-plural}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{glsaccesssymbolplural} but formats the displayed
+ text with \gls{glsfmtfield}}
+ }
+ % \Glsaccessfmtsymbolplural
+ \gcmd{Gls\-access\-fmt\-symbol\-plural}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{Glsaccesssymbolplural} but formats the displayed
+ text with \gls{Glsfmtfield}}
+ }
+ % \GLSaccessfmtsymbolplural
+ \gcmd{GLS\-access\-fmt\-symbol\-plural}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{GLSaccesssymbolplural} but formats the displayed
+ text with \gls{GLSfmtfield}}
+ }
+ % \glsaccessfmtdesc
+ \gcmd{gls\-access\-fmt\-desc}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{glsaccessdesc} but formats the displayed
+ text with \gls{glsfmtfield}}
+ }
+ % \Glsaccessfmtdesc
+ \gcmd{Gls\-access\-fmt\-desc}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{Glsaccessdesc} but formats the displayed
+ text with \gls{Glsfmtfield}}
+ }
+ % \GLSaccessfmtdesc
+ \gcmd{GLS\-access\-fmt\-desc}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{GLSaccessdesc} but formats the displayed
+ text with \gls{GLSfmtfield}}
+ }
+ % \glsaccessfmtdescplural
+ \gcmd{gls\-access\-fmt\-desc\-plural}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{glsaccessdescplural} but formats the displayed
+ text with \gls{glsfmtfield}}
+ }
+ % \Glsaccessfmtdescplural
+ \gcmd{Gls\-access\-fmt\-desc\-plural}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{Glsaccessdescplural} but formats the displayed
+ text with \gls{Glsfmtfield}}
+ }
+ % \GLSaccessfmtdescplural
+ \gcmd{GLS\-access\-fmt\-desc\-plural}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{GLSaccessdescplural} but formats the displayed
+ text with \gls{GLSfmtfield}}
+ }
+ % \glsaccessfmtshort
+ \gcmd{gls\-access\-fmt\-short}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{glsaccessshort} but formats the displayed
+ text with \gls{glsfmtfield}}
+ }
+ % \Glsaccessfmtshort
+ \gcmd{Gls\-access\-fmt\-short}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{Glsaccessshort} but formats the displayed
+ text with \gls{Glsfmtfield}}
+ }
+ % \GLSaccessfmtshort
+ \gcmd{GLS\-access\-fmt\-short}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{GLSaccessshort} but formats the displayed
+ text with \gls{GLSfmtfield}}
+ }
+ % \glsaccessfmtshortpl
+ \gcmd{gls\-access\-fmt\-short\-pl}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{glsaccessshortpl} but formats the displayed
+ text with \gls{glsfmtfield}}
+ }
+ % \Glsaccessfmtshortpl
+ \gcmd{Gls\-access\-fmt\-short\-pl}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{Glsaccessshortpl} but formats the displayed
+ text with \gls{Glsfmtfield}}
+ }
+ % \GLSaccessfmtshortpl
+ \gcmd{GLS\-access\-fmt\-short\-pl}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{GLSaccessshortpl} but formats the displayed
+ text with \gls{GLSfmtfield}}
+ }
+ % \glsaccessfmtlong
+ \gcmd{gls\-access\-fmt\-long}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{glsaccesslong} but formats the displayed
+ text with \gls{glsfmtfield}}
+ }
+ % \Glsaccessfmtlong
+ \gcmd{Gls\-access\-fmt\-long}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{Glsaccesslong} but formats the displayed
+ text with \gls{Glsfmtfield}}
+ }
+ % \GLSaccessfmtlong
+ \gcmd{GLS\-access\-fmt\-long}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{GLSaccesslong} but formats the displayed
+ text with \gls{GLSfmtfield}}
+ }
+ % \glsaccessfmtlongpl
+ \gcmd{gls\-access\-fmt\-long\-pl}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{glsaccesslongpl} but formats the displayed
+ text with \gls{glsfmtfield}}
+ }
+ % \Glsaccessfmtlongpl
+ \gcmd{Gls\-access\-fmt\-long\-pl}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{Glsaccesslongpl} but formats the displayed
+ text with \gls{Glsfmtfield}}
+ }
+ % \GLSaccessfmtlongpl
+ \gcmd{GLS\-access\-fmt\-long\-pl}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{GLSaccesslongpl} but formats the displayed
+ text with \gls{GLSfmtfield}}
+ }
+ % \glsaccessfmtuseri
+ \gcmd{gls\-access\-fmt\-useri}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{glsaccessuseri} but formats the displayed
+ text with \gls{glsfmtfield}}
+ }
+ % \Glsaccessfmtuseri
+ \gcmd{Gls\-access\-fmt\-useri}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{Glsaccessuseri} but formats the displayed
+ text with \gls{Glsfmtfield}}
+ }
+ % \GLSaccessfmtuseri
+ \gcmd{GLS\-access\-fmt\-useri}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{GLSaccessuseri} but formats the displayed
+ text with \gls{GLSfmtfield}}
+ }
+ % \glsaccessfmtuserii
+ \gcmd{gls\-access\-fmt\-userii}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{glsaccessuserii} but formats the displayed
+ text with \gls{glsfmtfield}}
+ }
+ % \Glsaccessfmtuserii
+ \gcmd{Gls\-access\-fmt\-userii}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{Glsaccessuserii} but formats the displayed
+ text with \gls{Glsfmtfield}}
+ }
+ % \GLSaccessfmtuserii
+ \gcmd{GLS\-access\-fmt\-userii}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{GLSaccessuserii} but formats the displayed
+ text with \gls{GLSfmtfield}}
+ }
+ % \glsaccessfmtuseriii
+ \gcmd{gls\-access\-fmt\-useriii}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{glsaccessuseriii} but formats the displayed
+ text with \gls{glsfmtfield}}
+ }
+ % \Glsaccessfmtuseriii
+ \gcmd{Gls\-access\-fmt\-useriii}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{Glsaccessuseriii} but formats the displayed
+ text with \gls{Glsfmtfield}}
+ }
+ % \GLSaccessfmtuseriii
+ \gcmd{GLS\-access\-fmt\-useriii}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{GLSaccessuseriii} but formats the displayed
+ text with \gls{GLSfmtfield}}
+ }
+ % \glsaccessfmtuseriv
+ \gcmd{gls\-access\-fmt\-useriv}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{glsaccessuseriv} but formats the displayed
+ text with \gls{glsfmtfield}}
+ }
+ % \Glsaccessfmtuseriv
+ \gcmd{Gls\-access\-fmt\-useriv}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{Glsaccessuseriv} but formats the displayed
+ text with \gls{Glsfmtfield}}
+ }
+ % \GLSaccessfmtuseriv
+ \gcmd{GLS\-access\-fmt\-useriv}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{GLSaccessuseriv} but formats the displayed
+ text with \gls{GLSfmtfield}}
+ }
+ % \glsaccessfmtuserv
+ \gcmd{gls\-access\-fmt\-userv}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{glsaccessuserv} but formats the displayed
+ text with \gls{glsfmtfield}}
+ }
+ % \Glsaccessfmtuserv
+ \gcmd{Gls\-access\-fmt\-userv}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{Glsaccessuserv} but formats the displayed
+ text with \gls{Glsfmtfield}}
+ }
+ % \GLSaccessfmtuserv
+ \gcmd{GLS\-access\-fmt\-userv}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{GLSaccessuserv} but formats the displayed
+ text with \gls{GLSfmtfield}}
+ }
+ % \glsaccessfmtuservi
+ \gcmd{gls\-access\-fmt\-uservi}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{glsaccessuservi} but formats the displayed
+ text with \gls{glsfmtfield}}
+ }
+ % \Glsaccessfmtuservi
+ \gcmd{Gls\-access\-fmt\-uservi}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{Glsaccessuservi} but formats the displayed
+ text with \gls{Glsfmtfield}}
+ }
+ % \GLSaccessfmtuservi
+ \gcmd{GLS\-access\-fmt\-uservi}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{insert}\margm{cs}\margm{entry-label}}
+ \desc{similar to \gls{GLSaccessuservi} but formats the displayed
+ text with \gls{GLSfmtfield}}
+ }
+ % COMMANDS: HEADINGS AND CAPTIONS
+ % \glsxtrRevertMarks
+ \gcmd{gls\-xtr\-Revert\-Marks}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{restores \gls{markright}, \gls{markboth} and
+ \gls{@starttoc} to their previous definitions}
+ \field{seealso}{glsxtrRevertTocMarks}
+ }
+ % \glsxtrRevertTocMarks
+ \gcmd{gls\-xtr\-Revert\-Toc\-Marks}
+ {
+ \providedby{\sty{glossaries-extra} v1.31+}
+ \desc{restores \gls{@starttoc} to its previous definition}
+ \field{seealso}{glsxtrRevertMarks}
+ }
+ % \glsxtrifinmark
+ \gcmd{glsxtrifinmark}
+ {
+ \providedby{\sty{glossaries-extra} v1.07+}
+ \syntax{\margm{true}\margm{false}}
+ \desc{does \meta{true} if within \gls{markright},
+ \gls{markboth} or \gls{@starttoc} otherwise does \meta{false}}
+ }
+ % \@glsxtrinmark
+ \gcmd{@gls\-xtr\-in\-mark}
+ {
+ \providedby{\sty{glossaries-extra} v1.07+}
+ \desc{redefines \gls{glsxtrifinmark} to do its first argument
+ (\meta{true})}
+ }
+ % \@glsxtrnotinmark
+ \gcmd{@gls\-xtr\-not\-in\-mark}
+ {
+ \providedby{\sty{glossaries-extra} v1.07+}
+ \desc{redefines \gls{glsxtrifinmark} to do its first argument
+ (\meta{true})}
+ }
+ % \@glsxtr@org@markboth
+ \gcmd{@gls\-xtr\-@org\-@mark\-both}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{left text}\margm{right text}}
+ \desc{set to the definition of \gls{markboth} when
+ \sty{glossaries-extra} loads}
+ }
+ % \@glsxtr@org@markright
+ \gcmd{@gls\-xtr\-@org\-@mark\-right}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{text}}
+ \desc{set to the definition of \gls{markright} when
+ \sty{glossaries-extra} loads}
+ }
+ % \@glsxtr@org@@starttoc
+ \gcmd{@gls\-xtr\-@org\-@@start\-toc}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{toc}}
+ \desc{set to the definition of \gls{@starttoc} when
+ \sty{glossaries-extra} loads}
+ }
+ % \glsxtrmarkhook
+ \gcmd{gls\-xtr\-mark\-hook}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{hook that's performed at the start of \gls{markright},
+ \gls{markboth} and \gls{@starttoc} to redefine commands that
+ need to change when they occur within page headers or
+ contents. This must be counteracted with \gls{glsxtrrestoremarkhook}
+ afterwards}
+ }
+ % \glsxtrrestoremarkhook
+ \gcmd{gls\-xtr\-restore\-mark\-hook}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{counteracts \gls{glsxtrmarkhook}}
+ }
+ % \glsxtrtitleorpdforheading
+ \gcmd{gls\-xtr\-title\-or\-pdf\-or\-heading}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{title}\margm{PDF bookmarks}\margm{heading}}
+ \desc{does the applicable argument depending on whether the
+ command occurs within a title\slash caption or PDF bookmark or
+ heading}
+ }
+ % \glsxtrifheaduc
+ \gcmd{gls\-xtr\-if\-head\-uc}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{true}\margm{false}}
+ \desc{if the category associated with the entry given by
+ \meta{entry-label} has the \catattr{headuc} attribute set to
+ \code{true} this does \meta{true} otherwise it does \meta{false}}
+ }
+ % \glsxtrifintoc
+ \gcmd{gls\-xtr\-if\-in\-toc}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{true}\margm{false}}
+ \desc{normally just expands to \meta{false} but \gls{@starttoc}
+ is redefined to temporarily set this macro to expand to \meta{true}
+ instead. Will always expand to \meta{false} if \gls{glsxtrRevertTocMarks}
+ or \gls{glsxtrRevertMarks} are used to revert \gls{@starttoc}
+ to its former definition}
+ }
+ % \glsfmtshort
+ \gcmd{gls\-fmt\-short}
+ {
+ %\providedby{\sty{glossaries-extra} v0.2+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted short form}
+ }
+ % \Glsfmtshort
+ \gcmd{Gls\-fmt\-short}
+ {
+ %\providedby{\sty{glossaries-extra} v0.2+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \idx{sentencecase} short form}
+ }
+ % \GLSfmtshort
+ \gcmd{GLS\-fmt\-short}
+ {
+ %\providedby{\sty{glossaries-extra} v0.2+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \idx{allcaps} short form}
+ }
+ % \glsfmtshortpl
+ \gcmd{gls\-fmt\-short\-pl}
+ {
+ %\providedby{\sty{glossaries-extra} v0.2+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted short plural form}
+ }
+ % \Glsfmtshortpl
+ \gcmd{Gls\-fmt\-short\-pl}
+ {
+ %\providedby{\sty{glossaries-extra} v0.2+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \idx{sentencecase} short plural form}
+ }
+ % \GLSfmtshortpl
+ \gcmd{GLS\-fmt\-short\-pl}
+ {
+ %\providedby{\sty{glossaries-extra} v0.2+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \idx{allcaps} short plural form}
+ }
+ % \glsfmtlong
+ \gcmd{gls\-fmt\-long}
+ {
+ %\providedby{\sty{glossaries-extra} v0.2+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted long form}
+ }
+ % \Glsfmtlong
+ \gcmd{Gls\-fmt\-long}
+ {
+ %\providedby{\sty{glossaries-extra} v0.2+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \idx{sentencecase} long form}
+ }
+ % \GLSfmtlong
+ \gcmd{GLS\-fmt\-long}
+ {
+ %\providedby{\sty{glossaries-extra} v0.2+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \idx{allcaps} long form}
+ }
+ % \glsfmtlongpl
+ \gcmd{gls\-fmt\-long\-pl}
+ {
+ %\providedby{\sty{glossaries-extra} v0.2+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted long plural form}
+ }
+ % \Glsfmtlongpl
+ \gcmd{Gls\-fmt\-long\-pl}
+ {
+ %\providedby{\sty{glossaries-extra} v0.2+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \idx{sentencecase} long plural form}
+ }
+ % \GLSfmtlongpl
+ \gcmd{GLS\-fmt\-long\-pl}
+ {
+ %\providedby{\sty{glossaries-extra} v0.2+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \idx{allcaps} long plural form}
+ }
+ % \glspdffmtfull
+ \gcmd{gls\-pdf\-fmt\-full}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}}
+ \desc{shortcut for \code{\gls{glsentrylong}\margm{entry-label}
+ (\gls{glsentryshort}\margm{entry-label})} for use in PDF
+ bookmarks or other text-only contexts}
+ }
+ % \glspdffmtfullpl
+ \gcmd{gls\-pdf\-fmt\-full\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}}
+ \desc{shortcut for \code{\gls{glsentrylongpl}\margm{entry-label}
+ (\gls{glsentryshortpl}\margm{entry-label})} for use in PDF
+ bookmarks or other text-only contexts}
+ }
+ % \glsfmtfull
+ \gcmd{gls\-fmt\-full}
+ {
+ \providedby{\sty{glossaries-extra} v1.02+}
+ \syntax{\margm{entry-label}}
+ \desc{designed for use in section headings or captions, this
+ expands to just \code{\gls{glspdffmtfull}\margm{entry-label}}
+ in PDF bookmarks, otherwise it
+ expands to \code{\gls{glsxtrtitlefull}\margm{entry-label}}}
+ }
+ % \Glsfmtfull
+ \gcmd{Gls\-fmt\-full}
+ {
+ \providedby{\sty{glossaries-extra} v1.02+}
+ \syntax{\margm{entry-label}}
+ \desc{designed for use in section headings or captions, this
+ expands to just \code{\gls{glspdffmtfull}\margm{entry-label}}
+ in PDF bookmarks (no case-change), otherwise it
+ expands to \code{\gls{Glsxtrtitlefull}\margm{entry-label}}}
+ }
+ % \GLSfmtfull
+ \gcmd{GLS\-fmt\-full}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}}
+ \desc{designed for use in section headings or captions, this
+ expands to just \code{\gls{glspdffmtfull}\margm{entry-label}}
+ in PDF bookmarks (no case-change), otherwise it
+ expands to \code{\gls{GLSxtrtitlefull}\margm{entry-label}}}
+ }
+ % \glsfmtfullpl
+ \gcmd{gls\-fmt\-full\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.02+}
+ \syntax{\margm{entry-label}}
+ \desc{designed for use in section headings or captions, this
+ expands to just \code{\gls{glspdffmtfullpl}\margm{entry-label}}
+ in PDF bookmarks, otherwise it
+ expands to \code{\gls{glsxtrtitlefullpl}\margm{entry-label}}}
+ }
+ % \Glsfmtfullpl
+ \gcmd{Gls\-fmt\-full\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.02+}
+ \syntax{\margm{entry-label}}
+ \desc{designed for use in section headings or captions, this
+ expands to just \code{\gls{glspdffmtfullpl}\margm{entry-label}}
+ in PDF bookmarks (no case-change), otherwise it
+ expands to \code{\gls{Glsxtrtitlefullpl}\margm{entry-label}}}
+ }
+ % \GLSfmtfullpl
+ \gcmd{GLS\-fmt\-full\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}}
+ \desc{designed for use in section headings or captions, this
+ expands to just \code{\gls{glspdffmtfullpl}\margm{entry-label}}
+ in PDF bookmarks (no case-change), otherwise it
+ expands to \code{\gls{GLSxtrtitlefullpl}\margm{entry-label}}}
+ }
+ % \glsfmtname
+ \gcmd{gls\-fmt\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \gloskey{name}}
+ }
+ % \Glsfmtname
+ \gcmd{Gls\-fmt\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \idx{sentencecase} \gloskey{name}}
+ }
+ % \GLSfmtname
+ \gcmd{GLS\-fmt\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \idx{allcaps} \gloskey{name}}
+ }
+ % \glsfmttext
+ \gcmd{gls\-fmt\-text}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \gloskey{text}}
+ }
+ % \Glsfmttext
+ \gcmd{Gls\-fmt\-text}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \idx{sentencecase} \gloskey{text}}
+ }
+ % \GLSfmttext
+ \gcmd{GLS\-fmt\-text}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \idx{allcaps} \gloskey{text}}
+ }
+ % \glsfmtplural
+ \gcmd{gls\-fmt\-plural}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \gloskey{plural}}
+ }
+ % \Glsfmtplural
+ \gcmd{Gls\-fmt\-plural}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \idx{sentencecase} \gloskey{plural}}
+ }
+ % \GLSfmtplural
+ \gcmd{GLS\-fmt\-plural}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \idx{allcaps} \gloskey{plural}}
+ }
+ % \glsfmtfirst
+ \gcmd{gls\-fmt\-first}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \gloskey{first}}
+ }
+ % \Glsfmtfirst
+ \gcmd{Gls\-fmt\-first}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \idx{sentencecase} \gloskey{first}}
+ }
+ % \GLSfmtfirst
+ \gcmd{GLS\-fmt\-first}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \idx{allcaps} \gloskey{first}}
+ }
+ % \glsfmtfirstpl
+ \gcmd{gls\-fmt\-firstpl}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \gloskey{firstplural}}
+ }
+ % \Glsfmtfirstpl
+ \gcmd{Gls\-fmt\-firstpl}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \idx{sentencecase} \gloskey{firstplural}}
+ }
+ % \GLSfmtfirstpl
+ \gcmd{GLS\-fmt\-firstpl}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}}
+ \desc{for use within captions or section titles to display the
+ formatted \idx{allcaps} \gloskey{firstplural}}
+ }
+ % COMMANDS: INNER HEAD AND TITLE
+ % \glsxtrtitleopts
+ \gcmd{gls\-xtr\-title\-opts}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{expands to the options that commands like
+ \gls{glsfmtshort} should use in the title or caption within the
+ document text}
+ }
+ % \glsxtrheadshort
+ \gcmd{gls\-xtr\-head\-short}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.1+}
+ \syntax{\margm{entry-label}}
+ \desc{the behaviour of \gls{glsfmtshort} when it occurs in a
+ page header}
+ }
+ % \glsxtrtitleshort
+ \gcmd{gls\-xtr\-title\-short}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.1+}
+ \syntax{\margm{entry-label}}
+ \desc{the normal behaviour of \gls{glsfmtshort}}
+ }
+ % \Glsxtrheadshort
+ \gcmd{Gls\-xtr\-head\-short}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.1+}
+ \syntax{\margm{entry-label}}
+ \desc{the behaviour of \gls{Glsfmtshort} when it occurs in a
+ page header}
+ }
+ % \Glsxtrtitleshort
+ \gcmd{Gls\-xtr\-title\-short}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.1+}
+ \syntax{\margm{entry-label}}
+ \desc{the normal behaviour of \gls{Glsfmtshort}}
+ }
+ % \GLSxtrheadshort
+ \gcmd{GLS\-xtr\-head\-short}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{the behaviour of \gls{GLSfmtshort} when it occurs in a
+ page header}
+ }
+ % \GLSxtrtitleshort
+ \gcmd{GLS\-xtr\-title\-short}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}}
+ \desc{the normal behaviour of \gls{GLSfmtshort}}
+ }
+ % \glsxtrheadshortpl
+ \gcmd{gls\-xtr\-head\-short\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{the behaviour of \gls{glsfmtshortpl} when it occurs in a
+ page header}
+ }
+ % \glsxtrtitleshortpl
+ \gcmd{gls\-xtr\-title\-short\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.03+}
+ \syntax{\margm{entry-label}}
+ \desc{the normal behaviour of \gls{glsfmtshortpl}}
+ }
+ % \Glsxtrheadshortpl
+ \gcmd{Gls\-xtr\-head\-short\-pl}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{the behaviour of \gls{Glsfmtshortpl} when it occurs in a
+ page header}
+ }
+ % \Glsxtrtitleshortpl
+ \gcmd{Gls\-xtr\-title\-short\-pl}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{the normal behaviour of \gls{Glsfmtshortpl}}
+ }
+ % \GLSxtrheadshortpl
+ \gcmd{GLS\-xtr\-head\-short\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{the behaviour of \gls{GLSfmtshortpl} when it occurs in a
+ page header}
+ }
+ % \GLSxtrtitleshortpl
+ \gcmd{GLS\-xtr\-title\-short\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}}
+ \desc{the normal behaviour of \gls{GLSfmtshortpl}}
+ }
+ % \glsxtrheadlong
+ \gcmd{gls\-xtr\-head\-long}
+ {
+ \providedby{\sty{glossaries-extra} v1.02+}
+ \syntax{\margm{entry-label}}
+ \desc{the behaviour of \gls{glsfmtlong} when it occurs in a
+ page header}
+ }
+ % \glsxtrtitlelong
+ \gcmd{gls\-xtr\-title\-long}
+ {
+ \providedby{\sty{glossaries-extra} v1.02+}
+ \syntax{\margm{entry-label}}
+ \desc{the normal behaviour of \gls{glsfmtlong}}
+ }
+ % \Glsxtrheadlong
+ \gcmd{Gls\-xtr\-head\-long}
+ {
+ \providedby{\sty{glossaries-extra} v1.02+}
+ \syntax{\margm{entry-label}}
+ \desc{the behaviour of \gls{Glsfmtlong} when it occurs in a
+ page header}
+ }
+ % \Glsxtrtitlelong
+ \gcmd{Gls\-xtr\-title\-long}
+ {
+ \providedby{\sty{glossaries-extra} v1.02+}
+ \syntax{\margm{entry-label}}
+ \desc{the normal behaviour of \gls{Glsfmtlong}}
+ }
+ % \GLSxtrheadlong
+ \gcmd{GLS\-xtr\-head\-long}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{the behaviour of \gls{GLSfmtlong} when it occurs in a
+ page header}
+ }
+ % \GLSxtrtitlelong
+ \gcmd{GLS\-xtr\-title\-long}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}}
+ \desc{the normal behaviour of \gls{GLSfmtlong}}
+ }
+ % \glsxtrheadlongpl
+ \gcmd{gls\-xtr\-head\-long\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.02+}
+ \syntax{\margm{entry-label}}
+ \desc{the behaviour of \gls{glsfmtlongpl} when it occurs in a
+ page header}
+ }
+ % \glsxtrtitlelongpl
+ \gcmd{gls\-xtr\-title\-long\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.02+}
+ \syntax{\margm{entry-label}}
+ \desc{the normal behaviour of \gls{glsfmtlongpl}}
+ }
+ % \Glsxtrheadlongpl
+ \gcmd{Gls\-xtr\-head\-long\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.02+}
+ \syntax{\margm{entry-label}}
+ \desc{the behaviour of \gls{Glsfmtlongpl} when it occurs in a
+ page header}
+ }
+ % \Glsxtrtitlelongpl
+ \gcmd{Gls\-xtr\-title\-long\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.02+}
+ \syntax{\margm{entry-label}}
+ \desc{the normal behaviour of \gls{Glsfmtlongpl}}
+ }
+ % \GLSxtrheadlongpl
+ \gcmd{GLS\-xtr\-head\-long\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{the behaviour of \gls{GLSfmtlongpl} when it occurs in a
+ page header}
+ }
+ % \GLSxtrtitlelongpl
+ \gcmd{GLS\-xtr\-title\-long\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}}
+ \desc{the normal behaviour of \gls{GLSfmtlongpl}}
+ }
+ % \glsxtrheadfull
+ \gcmd{gls\-xtr\-head\-full}
+ {
+ \providedby{\sty{glossaries-extra} v1.02+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the entry's full form in the page header
+ (converts to \idx{allcaps} if \catattr{headuc} attribute is \code{true})}
+ \field{seealso}{glsfmtfull,glsxtrtitlefull}
+ }
+ % \glsxtrtitlefull
+ \gcmd{gls\-xtr\-title\-full}
+ {
+ \providedby{\sty{glossaries-extra} v1.02+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the entry's full form in the section title and
+ table of contents}
+ \field{seealso}{glsfmtfull,glsxtrheadfull}
+ }
+ % \glsxtrheadfullpl
+ \gcmd{gls\-xtr\-head\-full\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.02+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the entry's full plural form in the page header
+ (converts to \idx{allcaps} if \catattr{headuc} attribute is \code{true})}
+ \field{seealso}{glsfmtfullpl,glsxtrtitlefullpl}
+ }
+ % \glsxtrtitlefullpl
+ \gcmd{gls\-xtr\-title\-full\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.02+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the entry's full plural form in the section title and
+ table of contents}
+ \field{seealso}{glsfmtfullpl,glsxtrheadfullpl}
+ }
+ % \Glsxtrheadfull
+ \gcmd{Gls\-xtr\-head\-full}
+ {
+ \providedby{\sty{glossaries-extra} v1.02+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the entry's \idx{sentencecase} full form in the page header
+ (converts to \idx{allcaps} if \catattr{headuc} attribute is \code{true})}
+ \field{seealso}{Glsfmtfull,Glsxtrtitlefull}
+ }
+ % \Glsxtrtitlefull
+ \gcmd{Gls\-xtr\-title\-full}
+ {
+ \providedby{\sty{glossaries-extra} v1.02+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the entry's \idx{sentencecase} full form in the section title and
+ table of contents}
+ \field{seealso}{Glsfmtfull,Glsxtrheadfull}
+ }
+ % \GLSxtrheadfull
+ \gcmd{GLS\-xtr\-head\-full}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the entry's \idx{allcaps} full form in the page header}
+ \field{seealso}{GLSfmtfull,GLSxtrtitlefull}
+ }
+ % \GLSxtrtitlefull
+ \gcmd{GLS\-xtr\-title\-full}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the entry's \idx{allcaps} full form in the section title and
+ table of contents}
+ \field{seealso}{GLSfmtfull}
+ }
+ % \Glsxtrheadfullpl
+ \gcmd{Gls\-xtr\-head\-full\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.02+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the entry's \idx{sentencecase} full plural form in the page header
+ (converts to \idx{allcaps} if \catattr{headuc} attribute is \code{true})}
+ \field{seealso}{Glsfmtfullpl,Glsxtrtitlefullpl}
+ }
+ % \Glsxtrtitlefullpl
+ \gcmd{Gls\-xtr\-title\-full\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.02+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the entry's \idx{sentencecase} full plural form in the section title and
+ table of contents}
+ \field{seealso}{Glsfmtfullpl,Glsxtrheadfullpl}
+ }
+ % \GLSxtrheadfullpl
+ \gcmd{GLS\-xtr\-head\-full\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the entry's \idx{allcaps} full plural form in the
+ page header}
+ \field{seealso}{GLSfmtfullpl,GLSxtrtitlefullpl}
+ }
+ % \GLSxtrtitlefullpl
+ \gcmd{GLS\-xtr\-title\-full\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the entry's \idx{allcaps} full plural form in the section title and
+ table of contents}
+ \field{seealso}{GLSfmtfullpl}
+ }
+ % \glsxtrheadname
+ \gcmd{gls\-xtr\-head\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the entry's name in the page header
+ (converts to \idx{allcaps} if \catattr{headuc} attribute is \code{true})}
+ \field{seealso}{glsfmtname,glsxtrtitlename}
+ }
+ % \glsxtrtitlename
+ \gcmd{gls\-xtr\-title\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the entry's name in the section title and
+ table of contents}
+ \field{seealso}{glsfmtname,glsxtrheadname}
+ }
+ % \Glsxtrheadname
+ \gcmd{Gls\-xtr\-head\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the \idx{sentencecase} entry's name in the page header
+ (converts to \idx{allcaps} if \catattr{headuc} attribute is \code{true})}
+ \field{seealso}{Glsfmtname,Glsxtrtitlename}
+ }
+ % \Glsxtrtitlename
+ \gcmd{Gls\-xtr\-title\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the \idx{sentencecase} entry's name in the section title and
+ table of contents}
+ \field{seealso}{Glsfmtname,Glsxtrheadname}
+ }
+ % \GLSxtrheadname
+ \gcmd{GLS\-xtr\-head\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the \idx{allcaps} entry's
+ \gloskey{name} \idx{field} in the page header}
+ \field{seealso}{GLSfmtname,GLSxtrtitlename}
+ }
+ % \GLSxtrtitlename
+ \gcmd{GLS\-xtr\-title\-name}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the \idx{allcaps} entry's name in the section title and
+ table of contents}
+ \field{seealso}{GLSfmtname,GLSxtrheadname}
+ }
+ % \glsxtrheadtext
+ \gcmd{gls\-xtr\-head\-text}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the entry's \gloskey{text} \idx{field} in the page header
+ (converts to \idx{allcaps} if \catattr{headuc} attribute is \code{true})}
+ \field{seealso}{glsfmttext,glsxtrtitletext}
+ }
+ % \glsxtrtitletext
+ \gcmd{gls\-xtr\-title\-text}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the entry's \gloskey{text} \idx{field} in the section title and
+ table of contents}
+ \field{seealso}{glsfmttext,glsxtrheadtext}
+ }
+ % \Glsxtrheadtext
+ \gcmd{Gls\-xtr\-head\-text}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the \idx{sentencecase} entry's
+ \gloskey{text} \idx{field} in the page header
+ (converts to \idx{allcaps} if \catattr{headuc} attribute is \code{true})}
+ \field{seealso}{Glsfmttext,Glsxtrtitletext}
+ }
+ % \Glsxtrtitletext
+ \gcmd{Gls\-xtr\-title\-text}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the \idx{sentencecase} entry's
+ \gloskey{text} \idx{field} in the section title and
+ table of contents}
+ \field{seealso}{Glsfmttext,Glsxtrheadtext}
+ }
+ % \GLSxtrheadtext
+ \gcmd{GLS\-xtr\-head\-text}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the \idx{allcaps} entry's
+ \gloskey{text} \idx{field} in the page header}
+ \field{seealso}{GLSfmttext,GLSxtrtitletext}
+ }
+ % \GLSxtrtitletext
+ \gcmd{GLS\-xtr\-title\-text}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the \idx{allcaps} entry's \gloskey{text} \idx{field}
+ in the section title and table of contents}
+ \field{seealso}{GLSfmttext,GLSxtrheadtext}
+ }
+ % \glsxtrheadplural
+ \gcmd{gls\-xtr\-head\-plural}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the entry's \gloskey{plural} \idx{field} in the page header
+ (converts to \idx{allcaps} if \catattr{headuc} attribute is \code{true})}
+ \field{seealso}{glsfmtplural,glsxtrtitleplural}
+ }
+ % \glsxtrtitleplural
+ \gcmd{gls\-xtr\-title\-plural}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the entry's \gloskey{plural} \idx{field} in the section title and
+ table of contents}
+ \field{seealso}{glsfmtplural,glsxtrheadplural}
+ }
+ % \Glsxtrheadplural
+ \gcmd{Gls\-xtr\-head\-plural}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the \idx{sentencecase} entry's
+ \gloskey{plural} \idx{field} in the page header
+ (converts to \idx{allcaps} if \catattr{headuc} attribute is \code{true})}
+ \field{seealso}{Glsfmtplural,Glsxtrtitleplural}
+ }
+ % \Glsxtrtitleplural
+ \gcmd{Gls\-xtr\-title\-plural}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the \idx{sentencecase} entry's
+ \gloskey{plural} \idx{field} in the section title and
+ table of contents}
+ \field{seealso}{Glsfmtplural,Glsxtrheadplural}
+ }
+ % \GLSxtrheadplural
+ \gcmd{GLS\-xtr\-head\-plural}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the \idx{allcaps} entry's
+ \gloskey{plural} \idx{field} in the page header}
+ \field{seealso}{GLSfmtplural,GLSxtrtitleplural}
+ }
+ % \GLSxtrtitleplural
+ \gcmd{GLS\-xtr\-title\-plural}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the \idx{allcaps} entry's \gloskey{plural} \idx{field} in the section title and
+ table of contents}
+ \field{seealso}{GLSfmtplural,GLSxtrheadplural}
+ }
+ % \glsxtrheadfirst
+ \gcmd{gls\-xtr\-head\-first}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the entry's \gloskey{first} \idx{field} in the page header
+ (converts to \idx{allcaps} if \catattr{headuc} attribute is \code{true})}
+ \field{seealso}{glsfmtfirst,glsxtrtitlefirst}
+ }
+ % \glsxtrtitlefirst
+ \gcmd{gls\-xtr\-title\-first}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the entry's \gloskey{first} \idx{field} in the section title and
+ table of contents}
+ \field{seealso}{glsfmtfirst,glsxtrheadfirst}
+ }
+ % \Glsxtrheadfirst
+ \gcmd{Gls\-xtr\-head\-first}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the \idx{sentencecase} entry's
+ \gloskey{first} \idx{field} in the page header
+ (converts to \idx{allcaps} if \catattr{headuc} attribute is \code{true})}
+ \field{seealso}{Glsfmtfirst,Glsxtrtitlefirst}
+ }
+ % \Glsxtrtitlefirst
+ \gcmd{Gls\-xtr\-title\-first}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the \idx{sentencecase} entry's
+ \gloskey{first} \idx{field} in the section title and
+ table of contents}
+ \field{seealso}{Glsfmtfirst,Glsxtrheadfirst}
+ }
+ % \GLSxtrheadfirst
+ \gcmd{GLS\-xtr\-head\-first}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the \idx{allcaps} entry's
+ \gloskey{first} \idx{field} in the page header}
+ \field{seealso}{GLSfmtfirst,GLSxtrtitlefirst}
+ }
+ % \GLSxtrtitlefirst
+ \gcmd{GLS\-xtr\-title\-first}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the \idx{allcaps} entry's \gloskey{first} \idx{field} in the section title and
+ table of contents}
+ \field{seealso}{GLSfmtfirst,GLSxtrheadfirst}
+ }
+ % \glsxtrheadfirstplural
+ \gcmd{gls\-xtr\-head\-firstplural}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the entry's \gloskey{firstplural} \idx{field} in the page header
+ (converts to \idx{allcaps} if \catattr{headuc} attribute is \code{true})}
+ \field{seealso}{glsfmtfirstpl,glsxtrtitlefirstplural}
+ }
+ % \glsxtrtitlefirstplural
+ \gcmd{gls\-xtr\-title\-firstplural}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the entry's \gloskey{firstplural} \idx{field} in the section title and
+ table of contents}
+ \field{seealso}{glsfmtfirstpl,glsxtrheadfirstplural}
+ }
+ % \Glsxtrheadfirstplural
+ \gcmd{Gls\-xtr\-head\-firstplural}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the \idx{sentencecase} entry's
+ \gloskey{firstplural} \idx{field} in the page header
+ (converts to \idx{allcaps} if \catattr{headuc} attribute is \code{true})}
+ \field{seealso}{Glsfmtfirstpl,Glsxtrtitlefirstplural}
+ }
+ % \Glsxtrtitlefirstplural
+ \gcmd{Gls\-xtr\-title\-firstplural}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the \idx{sentencecase} entry's
+ \gloskey{firstplural} \idx{field} in the section title and
+ table of contents}
+ \field{seealso}{Glsfmtfirstpl,Glsxtrheadfirstplural}
+ }
+ % \GLSxtrheadfirstplural
+ \gcmd{GLS\-xtr\-head\-first\-plural}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the \idx{allcaps} entry's
+ \gloskey{firstplural} \idx{field} in the page header}
+ \field{seealso}{GLSfmtfirstpl,GLSxtrtitlefirstplural}
+ }
+ % \GLSxtrtitlefirstplural
+ \gcmd{GLS\-xtr\-title\-firstplural}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}}
+ \desc{used to display the \idx{allcaps} entry's \gloskey{firstplural} \idx{field} in the section title and
+ table of contents}
+ \field{seealso}{GLSfmtfirstpl,GLSxtrheadfirstplural}
+ }
+ % COMMANDS: FORMATTING
+ % \glsxtrassignfieldfont
+ \gcmd{gls\-xtr\-assign\-field\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \syntax{\margm{entry-label}}
+ \desc{used by the \idx{glstextlike} commands to initialise the
+ formatting commands required for the given entry}
+ }
+ % \glssetabbrvfmt
+ \gcmd{gls\-set\-abbrv\-fmt}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{category}}
+ \desc{implements the \meta{display definitions} code for the
+ abbreviation style associated with the given category}
+ }
+ % \GlsXtrUseAbbrStyleSetup
+ \gcmd{Gls\-Xtr\-Use\-Abbr\-Style\-Set\-up}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{style-name}}
+ \desc{implements the \meta{setup} code for the given
+ abbreviation style}
+ }
+ % \GlsXtrUseAbbrStyleFmts
+ \gcmd{Gls\-Xtr\-Use\-Abbr\-Style\-Fmts}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{style-name}}
+ \desc{implements the \meta{display definitions} code for the given
+ abbreviation style}
+ }
+ % \glsuseabbrvfont
+ \gcmd{gls\-use\-abbrv\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{style-name}\margm{text}}
+ \desc{formats \meta{text} according to the short format for the
+ given abbreviation style}
+ }
+ % \glsuselongfont
+ \gcmd{gls\-use\-long\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{style-name}\margm{text}}
+ \desc{formats \meta{text} according to the long format for the
+ given abbreviation style}
+ }
+ % \glsxtrgenabbrvfmt
+ \gcmd{gls\-xtr\-gen\-abbrv\-fmt}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{the display format used by \gls{glsentryfmt} for entries that have
+ the \gloskey{short} field set and have the \catattr{regular}
+ attribute set to \code{false}}
+ }
+ % \glsgenentryfmt
+ \gcmd{gls\-gen\-entry\-fmt}
+ {
+ \providedby{\sty{glossaries} v3.11a+}
+ \desc{the display format used by \gls{glsentryfmt} for regular entries}
+ }
+ % \glsentryfmt
+ \gcmd{gls\-entry\-fmt}
+ {
+ \providedby{\sty{glossaries} v3.11a+}
+ \desc{the default display format used by the \idx{glslike}
+ commands. This checks if the \gloskey{short} field has been
+ set for the current entry and, if set, initialises the
+ abbreviation formatting commands (with \gls{glssetabbrvfmt}).
+ This command will do \gls{glsgenentryfmt} (encapsulated with
+ \gls{glsxtrregularfont}) if the entry is considered a regular
+ entry (\gls{glsifregular}) or if the entry doesn't have the
+ \gloskey{short} field set. Otherwise it will do \gls{glsxtrgenabbrvfmt}
+ encapsulated with \gls{glsxtrabbreviationfont}}
+ }
+ % \glsxtrregularfont
+ \gcmd{gls\-xtr\-regular\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \syntax{\margm{text}}
+ \desc{used by \gls{glsentryfmt} to encapsulate regular entries.
+ Also used by \gls{glsxtrassignfieldfont} for regular entries}
+ }
+ % \glsxtrabbreviationfont
+ \gcmd{gls\-xtr\-ab\-bre\-vi\-a\-tion\-font}
+ {
+ \providedby{\sty{glossaries-extra} v1.30+}
+ \syntax{\margm{text}}
+ \desc{used by \gls{glsentryfmt} to encapsulate non-regular entries
+ the have the \gloskey{short} field set}
+ }
+ % \defglsentryfmt
+ \gcmd{def\-gls\-entry\-fmt}
+ {
+ \providedby{\sty{glossaries} v3.11a+}
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{type}\margm{display}}
+ \desc{overrides the default display format (\gls{glsentryfmt})
+ for the given glossary. If \meta{type} is omitted,
+ \gls{glsdefaulttype} is assumed. This will make the
+ \idx{glslike} commands do \meta{display} for any entries that
+ have the \gloskey{type} field set to the given \meta{type}. If
+ you want to support any abbreviation styles, you need to include
+ \gls{glssetabbrvfmt} in \meta{display}. Non-regular abbreviation
+ styles are designed to work with \gls{glsxtrgenabbrvfmt}}
+ }
+ % \glslabel
+ \gcmd{gls\-label}
+ {
+ \providedby{\sty{glossaries}}
+ \desc{the current entry label, initialised by the \idx{glslike}
+ and \idx{glstextlike} commands. This command may be used
+ within associated hooks, entry display styles
+ (\gls{defglsentryfmt}), and the \idx{postlinkhook}}
+ }
+ % \glsinsert
+ \gcmd{gls\-insert}
+ {
+ \providedby{\sty{glossaries}}
+ \desc{the final \meta{insert} argument passed to the
+ \idx{glslike} commands (but not to the \idx{glstextlike} commands,
+ where the \meta{insert} is added to \gls{glscustomtext}). This command may be used
+ within associated hooks, entry display styles
+ (\gls{defglsentryfmt}), and the \idx{postlinkhook}}
+ \field{seealso}{glsxtrsaveinsert,glsxtrfullsaveinsert}
+ }
+ % \glscustomtext
+ \gcmd{gls\-custom\-text}
+ {
+ \providedby{\sty{glossaries}}
+ \desc{the custom text provided by \gls{glsdisp} or the
+ \idx{linktext} for the \idx{glstextlike} commands. This command may be used
+ within associated hooks, entry display styles
+ (\gls{defglsentryfmt}), and the \idx{postlinkhook}}
+ }
+ % \glsifplural
+ \gcmd{gls\-if\-plural}
+ {
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{true}\margm{false}}
+ \desc{initialised by the \idx{glslike}
+ and \idx{glstextlike} commands, this expands to \meta{true} if
+ the calling command accesses a plural field (such as \gls{glspl} or
+ \gls{glsplural}) otherwise it expands to \meta{false}. This command may be used
+ within associated hooks, entry display styles
+ (\gls{defglsentryfmt}), and the \idx{postlinkhook}}
+ }
+ % \glscapscase
+ \gcmd{gls\-caps\-case}
+ {
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{no change}\margm{sentence}\margm{all caps}}
+ \desc{initialised by the \idx{glslike}
+ and \idx{glstextlike} commands, this expands to \meta{no change} if
+ the calling command doesn't apply a case-change (such as \gls{gls} or
+ \gls{glstext}), to \meta{sentence} if the calling command
+ converts to \idx+{sentencecase} (such as \gls{Gls} or \gls{Glstext}),
+ or to \meta{all caps} if the calling command converts to
+ \idx+{allcaps} (such as \gls{GLS} or \gls{GLStext}). This command may be used
+ within associated hooks, entry display styles
+ (\gls{defglsentryfmt}), and the \idx{postlinkhook}}
+ }
+ % \glsxtrifallcaps
+ \gcmd{gls\-xtr\-if\-all\-caps}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{all caps}\margm{not all caps}}
+ \desc{shortcut for \code{\gls{glscapscase}\margm{not all caps}\margm{not all caps}\margm{all caps}}}
+ }
+ % \glsxtrifwasfirstuse
+ \gcmd{gls\-xtr\-if\-was\-first\-use}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{true}\margm{false}}
+ \desc{initialised by the \idx{glslike}
+ and \idx{glstextlike} commands, this expands to \meta{true} if
+ the calling command was considered the \idx{firstuse},
+ otherwise it expands to \meta{false}. This command may be used
+ within the \idx{postlinkhook} (where it's too late to test the
+ \idx{firstuseflag} with \gls{ifglsused})}
+ }
+ % \glsxtrifwasglslike
+ \gcmd{gls\-xtr\-if\-was\-gls\-like}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{true}\margm{false}}
+ \desc{initialised by the \idx{glslike}
+ and \idx{glstextlike} commands, this expands to \meta{true} if
+ the calling command was a \idx{glslike} command,
+ otherwise it expands to \meta{false}. This command may be used
+ within the \idx{postlinkhook}}
+ }
+ % \glsxtrifwasglslikeandfirstuse
+ \gcmd{gls\-xtr\-if\-was\-gls\-like\-and\-first\-use}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{true}\margm{false}}
+ \desc{a shortcut that nests \gls{glsxtrifwasglslike}
+ and \gls{glsxtrifwasfirstuse}. This does \meta{true}
+ if the calling command was both a \idx{glslike} command and
+ was considered the \idx{firstuse}}
+ }
+ % \glsxtrifwassubsequentuse
+ \gcmd{gls\-xtr\-if\-was\-subsequent\-use}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{true}\margm{false}}
+ \desc{a shortcut that nests \gls{glsxtrifwasglslike}
+ and \gls{glsxtrifwasfirstuse}. This does \meta{true}
+ if the calling command was a \idx{glslike} command but
+ was not considered the \idx{firstuse}}
+ }
+ % \glsxtrifwassubsequentorshort
+ \gcmd{gls\-xtr\-if\-was\-subsequent\-or\-short}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{true}\margm{false}}
+ \desc{expands to \meta{true} if the calling command was a
+ \idx{glslike} command and was the \idx{subsequentuse} or if
+ \gls{glsxtrcurrentfield} was set to \code{short}}
+ }
+ % \glsxtrcurrentfield
+ \gcmd{gls\-xtr\-current\-field}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{placeholder command for use in \idxpl{postlinkhook}. This
+ expands to empty if the calling command was one of the
+ \idx{glslike} commands or it was one of the \idx{inlinefullform}
+ commands, otherwise it will expand to the name of the key
+ associated with the \emph{singular} form of the command}
+ }
+ % \glsxtrassignlinktextfmt
+ \gcmd{gls\-xtr\-assign\-link\-text\-fmt}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{initialised by the \idx{glslike}
+ and \idx{glstextlike} commands, this contains the definitions of
+ \gls{glslabel}, \gls{glstextformat},
+ \gls{glsxtrgenentrytextfmt}}
+ }
+ % COMMANDS: CATEGORIES
+ % \glsifcategory
+ \gcmd{gls\-if\-category}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{entry-label}\margm{category}\margm{true}\margm{false}}
+ \desc{tests if the entry identified by \meta{entry-label} has
+ the \gloskey{category} set to \meta{category} (uses
+ \gls{ifglsfieldeq} for the test)}
+ }
+ % \glsifregularcategory
+ \gcmd{gls\-if\-regular\-category}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{category}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the given category has the
+ \catattr{regular} attribute explicitly set to \code{true},
+ otherwise does \meta{false}}
+ }
+ % \glsifnotregularcategory
+ \gcmd{gls\-if\-not\-regular\-category}
+ {
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \syntax{\margm{category}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the given category has the
+ \catattr{regular} attribute explicitly set to \code{false},
+ otherwise does \meta{false}}
+ }
+ % \glsifregular
+ \gcmd{gls\-if\-regular}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{entry-label}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the category for the given entry has the
+ \catattr{regular} attribute explicitly set to \code{true},
+ otherwise does \meta{false}}
+ }
+ % \glsifnotregular
+ \gcmd{gls\-if\-not\-regular}
+ {
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \syntax{\margm{entry-label}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the category for the given entry has the
+ \catattr{regular} attribute explicitly set to \code{false},
+ otherwise does \meta{false}}
+ }
+ % \glsforeachincategory
+ \gcmd{gls\-for\-each\-in\-category}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{glossary-types}\margm{category}\margm{glossary-cs}\margm{label-cs}\margm{body}}
+ \desc{iterates over all entry in the given list of
+ \idxpl{glossary} (or all non-\idxpl{ignoredglossary}, if the optional
+ argument is omitted) and performs \meta{body} for those entries that
+ have the \gloskey{category} set to \meta{category}. Within
+ \meta{body}, the current entry can be referenced with
+ \meta{label-cs} and the \idx{glossary} can be referenced with
+ \meta{glossary-cs}}
+ }
+ % \glsforeachwithattribute
+ \gcmd{gls\-for\-each\-with\-attribute}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\oargm{glossary-types}\margm{attribute-label}\margm{attribute-value}\margm{glossary-cs}\margm{label-cs}\margm{body}}
+ \desc{iterates over all entry in the given list of
+ \idxpl{glossary} (or all non-\idxpl{ignoredglossary}, if the optional
+ argument is omitted) and performs \meta{body} for those entries that
+ have the attribute given by \meta{attribute-label} set to
+ \meta{attribute-value}. Within
+ \meta{body}, the current entry can be referenced with
+ \meta{label-cs} and the \idx{glossary} can be referenced with
+ \meta{glossary-cs}}
+ }
+ % \glssetcategoryattribute
+ \gcmd{gls\-set\-category\-attribute}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{category}\margm{attribute}\margm{value}}
+ \desc{locally sets the given attribute to \meta{value} for the given
+ category}
+ }
+ % \glssetcategoriesattribute
+ \gcmd{gls\-set\-categories\-attribute}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{category list}\margm{attribute}\margm{value}}
+ \desc{globally sets the given attribute to \meta{value} for all the
+ categories in the comma-separated list \meta{category list}}
+ }
+ % \glssetcategoriesattributes
+ \gcmd{gls\-set\-categories\-attributes}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{category list}\margm{attribute list}\margm{value}}
+ \desc{globally sets each attribute in the comma separated
+ \meta{attribute list} to \meta{value} for each
+ category in the comma-separated list \meta{category list}}
+ }
+ % \glssetcategoryattributes
+ \gcmd{gls\-set\-category\-attributes}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{category}\margm{attribute list}\margm{value}}
+ \desc{globally sets each attribute in the comma separated
+ \meta{attribute list} to \meta{value} for the given \meta{category}}
+ }
+ % \glssetregularcategory
+ \gcmd{gls\-set\-regular\-category}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{category}}
+ \desc{locally sets the \catattr{regular} attribute to
+ \code{true} for the given category}
+ }
+ % \glsgetcategoryattribute
+ \gcmd{gls\-get\-category\-attribute}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{category}\margm{attribute}}
+ \desc{expands to the value of the given attribute for the given
+ category. Expands to nothing if the attribute hasn't been set}
+ }
+ % \glsunsetcategoryattribute
+ \gcmd{gls\-unset\-category\-attribute}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.47+}
+ \syntax{\margm{category}\margm{attribute}}
+ \desc{locally unsets the given attribute for the given category}
+ }
+ % \glshascategoryattribute
+ \gcmd{gls\-has\-category\-attribute}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{category}\margm{attribute}\margm{true}\margm{false}}
+ \desc{tests if the given attribute has been set for the given
+ category (using \sty{etoolbox}['s] \gls{ifcsvoid})}
+ }
+ % \glssetattribute
+ \gcmd{gls\-set\-attribute}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{entry-label}\margm{attribute}\margm{value}}
+ \desc{locally sets the given attribute to \meta{value} for the
+ category associated with the entry identified by
+ \meta{entry-label}}
+ }
+ % \glsgetattribute
+ \gcmd{gls\-get\-attribute}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{entry-label}\margm{attribute}}
+ \desc{expands to the value of the given attribute for the
+ category associated with the entry identified by \meta{entry-label}.
+ Expands to nothing if the attribute hasn't been set}
+ }
+ % \glsxtrsetcategory
+ \gcmd{gls\-xtr\-set\-category}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{entry-labels}\margm{category-label}}
+ \desc{globally sets the \gloskey{category} field to the fully
+ expanded \meta{category-label} for each entry listed in
+ \meta{entry-labels}}
+ }
+ % \glsxtrsetcategoryforall
+ \gcmd{gls\-xtr\-set\-category\-for\-all}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{glossary-labels}\margm{category-label}}
+ \desc{globally sets the \gloskey{category} field to the fully
+ expanded \meta{category-label} for each entry belonging to the
+ \idxpl{glossary} listed in \meta{glossary-labels}}
+ }
+ % \glshasattribute
+ \gcmd{gls\-has\-attribute}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \syntax{\margm{entry-label}\margm{attribute}\margm{true}\margm{false}}
+ \desc{tests if the given attribute has been set for the category
+ associated with the entry identified by \meta{entry-label}
+ (using \sty{etoolbox}['s] \gls{ifcsvoid}). Does \meta{false}
+ if the entry hasn't been defined}
+ }
+ % \glsifcategoryattribute
+ \gcmd{gls\-if\-category\-attribute}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{category}\margm{attribute}\margm{value}\margm{true}\margm{false}}
+ \desc{tests if the given category has the given attribute set to
+ \meta{value}. Does \meta{true} if the attribute is
+ \meta{value} and \meta{false} otherwise. Does \meta{false} if there's
+ no such attribute for the given category}
+ }
+ % \glsifattribute
+ \gcmd{gls\-if\-attribute}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{entry-label}\margm{attribute}\margm{value}\margm{true}\margm{false}}
+ \desc{tests if the category associated with the entry identified
+ by \meta{entry-label} has the given attribute set to
+ \meta{value}. Does \meta{true} if the attribute is
+ \meta{value} and \meta{false} otherwise. Does \meta{false} if there's
+ no such attribute for the given category or if the entry hasn't
+ been defined}
+ }
+ % \glsifcategoryattributetrue
+ \gcmd{gls\-if\-category\-attribute\-true}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{category}\margm{attribute}\margm{true}\margm{false}}
+ \desc{tests if the given category has the given attribute set to
+ \code{true}. Does \meta{true} if the attribute is
+ \code{true} and \meta{false} otherwise. Does \meta{false} if there's
+ no such attribute for the given category}
+ }
+ % \glsifattributetrue
+ \gcmd{gls\-if\-attribute\-true}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{attribute}\margm{true}\margm{false}}
+ \desc{tests if the category associated with the entry given by
+ \meta{entry-label} has the given attribute set to
+ \code{true}. Does \meta{true} if the attribute is
+ \code{true} and \meta{false} otherwise. Does \meta{false} if there's
+ no such attribute for the given category or if the entry hasn't
+ been defined}
+ }
+ % \glsifcategoryattributehasitem
+ \gcmd{gls\-if\-category\-attribute\-has\-item}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{category}\margm{attribute}\margm{item}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the category has the attribute (whose
+ value is a comma-separated list) contains the given item and \meta{false}
+ otherwise. Does \meta{false} if there's
+ no such attribute for the given category. The item and list are
+ expanded and passed to \sty{datatool}['s] \gls{DTLifinlist} to perform the test}
+ }
+ % \glsxtrchecknohyperfirst
+ \gcmd{gls\-xtr\-check\-no\-hyper\-first}
+ {
+ \providedby{\sty{glossaries-extra} v1.07+}
+ \syntax{\margm{entry-label}}
+ \desc{sets \glsoptval{hyper}{false} if the
+ \catattr{nohyperfirst} attribute is set}
+ }
+ % COMMANDS: INDEXING
+ % \glsignore
+ \gcmd{gls\-ignore}
+ {
+ \providedby{\sty{glossaries} v4.12+}
+ \syntax{\margm{text}}
+ \desc{does nothing. When used as a \idx{locationencap}, this
+ signifies to \app{bib2gls} that the entry is required but the
+ \location\ shouldn't be added to the \idx{locationlist}. With
+ other \idx{indexing} methods, this simply creates an invisible
+ \location}
+ }
+ % \glsxtrdowrglossaryhook
+ \gcmd{gls\-xtr\-do\-wr\-glossary\-hook}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{hook used whenever an entry is \indexed. Does nothing by default}
+ }
+ % \glsadd
+ \gcmd{gls\-add}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}\margm{entry-label}}
+ \desc{indexes the entry identified by \meta{entry-label}}
+ }
+ % \glsaddall
+ \gcmd{gls\-add\-all}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{options}}
+ \desc{iterates over all \idxpl{glossary} (or all those
+ listed in the \glsopt{types} option)
+ and \idxc{indexing}{indexes} each entry in the \idx{glossary}. The optional
+ argument \meta{options} are passed to \gls{glsadd}.
+ This command can't be used with \app{bib2gls}. Use the
+ \resourceoptval{selection}{all} \idx{resourceopt} instead}
+ }
+ % \glsaddallunused
+ \gcmd{gls\-add\-all\-unused}
+ {%
+ \providedby{\sty{glossaries} v3.08a+}
+ \syntax{\oargm{glossary types}}
+ \desc{iterates over all \idxpl{glossary} listed in
+ \meta{glossary types} and \idxc{indexing}{indexes} each entry
+ (with \glsoptval{format}{glsignore}) that hasn't been used.
+ This command can't be used with \app{bib2gls}. Use the
+ \resourceoptval{selection}{all} \idx{resourceopt} instead}
+ }
+ % \glsaddallunindexed
+ \gcmd{gls\-add\-all\-un\-indexed}
+ {%
+ \syntax{\oargm{glossary types}}
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{iterates over all \idxpl{glossary} listed in
+ \meta{glossary types} and \idxc{indexing}{indexes} each entry
+ (with \glsoptval{format}{glsignore}) that hasn't already been indexed.
+ This command can't be used with \app{bib2gls}. Use the
+ \resourceoptval{selection}{all} \idx{resourceopt} instead}
+ }
+ % \glsaddeach
+ \gcmd{gls\-add\-each}
+ {
+ \providedby{\sty{glossaries-extra} v1.31+}
+ \syntax{\oargm{options}\margm{entry label list}}
+ \desc{does \code{\gls{glsadd}\oargm{options}\margm{entry-label}} for each label
+ in the supplied comma-separated list}
+ }
+ % \GlsXtrAutoAddOnFormat
+ \gcmd{Gls\-Xtr\-Auto\-Add\-On\-Format}
+ {
+ \providedby{\sty{glossaries-extra} v1.37+}
+ \syntax{\oargm{entry-label}\margm{format list}\margm{gls\-add options}}
+ \desc{identifies formats that should trigger an automatic
+ \gls{glsadd} by the \idx{glslike} and \idx{glstextlike}
+commands}
+ }
+ % \glsxtrdoautoindexname
+ \gcmd{gls\-xtr\-do\-auto\-index\-name}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.3+}
+ \syntax{\margm{entry-label}\margm{attribute}}
+ \desc{used to automatically index (using \gls{glsxtrautoindex})
+ the entry's name, if the given attribute is set for the entry's category}
+ }
+ % \glsxtrautoindex
+ \gcmd{gls\-xtr\-auto\-index}
+ {
+ \providedby{\sty{glossaries-extra} v1.16+}
+ \initvalcs{index}
+ \desc{the indexing command used by by the auto-indexing feature}
+ }
+ % \glsxtrautoindexesc
+ \gcmd{gls\-xtr\-auto\-index\-esc}
+ {
+ \providedby{\sty{glossaries-extra} v1.36+}
+ \desc{escapes the sort value used by the auto-indexing feature}
+ }
+ % \glsxtrautoindexentry
+ \gcmd{gls\-xtr\-auto\-index\-entry}
+ {
+ \providedby{\sty{glossaries-extra} v1.16+}
+ \syntax{\margm{entry-label}}
+ \desc{expands to the \qt{actual} part for the auto-indexing feature}
+ }
+ % \glsxtrautoindexassignsort
+ \gcmd{gls\-xtr\-auto\-index\-assign\-sort}
+ {
+ \providedby{\sty{glossaries-extra} v1.16+}
+ \syntax{\margm{entry-label}}
+ \desc{used to assign the sort value for the auto-indexing feature}
+ }
+ % \GlsXtrEnableIndexFormatOverride
+ \gcmd{Gls\-Xtr\-Enable\-Index\-Format\-Override}
+ {
+ %\providedby{\sty{glossaries-extra}}
+ \desc{allows the \glsopt{format} key to override the attribute value}
+ \note{preamble only}
+ }
+ % \GlsXtrSetActualChar
+ \gcmd{Gls\-Xtr\-Set\-Actual\-Char}
+ {
+ %\providedby{\sty{glossaries-extra}}
+ \syntax{\margm{character}}
+ \desc{sets the \qt{actual character} for the auto-indexing feature}
+ \note{preamble only}
+ }
+ % \GlsXtrSetEncapChar
+ \gcmd{Gls\-Xtr\-Set\-Encap\-Char}
+ {
+ %\providedby{\sty{glossaries-extra}}
+ \syntax{\margm{character}}
+ \desc{sets the \qt{encap character} for the auto-indexing feature}
+ \note{preamble only}
+ }
+ % \GlsXtrSetLevelChar
+ \gcmd{Gls\-Xtr\-Set\-Level\-Char}
+ {
+ %\providedby{\sty{glossaries-extra}}
+ \syntax{\margm{character}}
+ \desc{sets the \qt{level character} for the auto-indexing feature}
+ \note{preamble only}
+ }
+ % \GlsXtrSetEscChar
+ \gcmd{Gls\-Xtr\-Set\-Esc\-Char}
+ {
+ %\providedby{\sty{glossaries-extra}}
+ \syntax{\margm{character}}
+ \desc{sets the \qt{escape character} for the auto-indexing feature}
+ \note{preamble only}
+ }
+ % \glssee
+ \gcmd{gls\-see}
+ {%
+ \providedby{\sty{glossaries} v1.17+}
+ \syntax{\oargm{tag}\margm{entry-label}\margm{xr-list}}
+ \desc{indexes the entry identified by \meta{entry-label} as a
+ general cross-reference to the entries identified in the comma-separated
+ list \meta{xr-list}. The optional argument is the textual tag
+ that's inserted before the cross-reference list and defaults to
+ \gls{seename}}
+ \field{seealso}{glsxtrindexseealso}
+ }
+ % \glsseeformat
+ \gcmd{gls\-see\-format}
+ {
+ \providedby{\sty{glossaries} v1.17+}
+ \syntax{\oargm{tag}\margm{xr-list}\margm{location}}
+ \desc{used to format the \gloskey{see} cross-reference in the
+ \idx{locationlist}. This requires a \location\ argument for
+ \app{makeindex} even though it isn't required. The default
+ definition is \code{\csfmt{emph}\margm{tag} \gls{glsseelist}\margm{xr-list}}}
+ }
+ % \glsseelist
+ \gcmd{gls\-see\-list}
+ {
+ \providedby{\sty{glossaries} v1.17+}
+ \syntax{\margm{csv-list}}
+ \desc{iterates over a comma-separated list of entry labels
+ \meta{csv-list} and formats them. Each label in the list is
+ encapsulated with \gls{glsseeitem} (or \gls{mglsseeitem}, the
+ label corresponds to a multi-entry). The separators are
+ \gls{glsseelastsep} (between the penultimate and last items)
+ and \gls{glsseesep} (between all the other items). With
+ \sty{glossaries-extra}, the first label is encapsulated with
+ \gls{glsseefirstitem} (or \gls{mglsseefirstitem}) and the final separator for a list
+ consisting of at least three items is given by
+ \gls{glsseelastoxfordsep}}
+ \field{seealso}{glsxtrseelist}
+ }
+ % \glsseeitem
+ \gcmd{gls\-see\-item}
+ {
+ \providedby{\sty{glossaries} v1.17+}
+ \syntax{\margm{entry-label}}
+ \desc{used by \gls{glsseelist} to format each entry}
+ \field{seealso}{glsseefirstitem}
+ }
+ % \glsseeitemformat
+ \gcmd{gls\-see\-item\-format}
+ {
+ \providedby{\sty{glossaries} v3.0+}
+ \syntax{\margm{entry-label}}
+ \desc{used by \gls{glsseeitem} to produce the hyperlink text}
+ }
+ % \glsseefirstitem
+ \gcmd{gls\-see\-first\-item}
+ {
+ \providedby{\sty{glossaries-extra} v1.47+}
+ \syntax{\margm{entry-label}}
+ \desc{used by \gls{glsseelist} to format the first entry}
+ \field{seealso}{glsseeitem}
+ }
+ % \glsseesep
+ \gcmd{gls\-see\-sep}
+ {
+ \providedby{\sty{glossaries} v1.17+}
+ \initval{{,\textvisiblespace}}
+ \desc{used by \gls{glsseelist} as a separator between each entry
+ except the last pair}
+ \field{seealso}{glsseelastsep,glsseelastoxfordsep}
+ }
+ % \glsseelastsep
+ \gcmd{gls\-see\-last\-sep}
+ {
+ \providedby{\sty{glossaries} v1.17+}
+ \desc{used by \gls{glsseelist} as a separator between
+ penultimate and final entry in the list}
+ \field{seealso}{glsseelastsep,glsseelastoxfordsep}
+ }
+ % \glsseelastoxfordsep
+ \gcmd{gls\-see\-last\-oxford\-sep}
+ {
+ \providedby{\sty{glossaries-extra} v1.47+}
+ \desc{used by \gls{glsseelist} as a separator between
+ penultimate and final entry in the list if there are at least
+ three entries in the list}
+ \field{seealso}{glsseelastsep,glsseelastoxfordsep}
+ }
+ % \andname
+ \gcmd{and\-name}
+ {
+ \initvalcs{amp}
+ \desc{used by \gls{glsseelastsep} (provided by \sty{glossaries}
+ if not already defined)}
+ }
+ % \glsxtrseelist
+ \gcmd{glsxtrseelist}
+ {
+ \providedby{\sty{glossaries-extra} v1.16+}
+ \syntax{\margm{csv-list}}
+ \desc{fully expands \meta{csv-list} and passes it to
+ \gls{glsseelist}}
+ }
+ % \glsxtrtaggedlist
+ \gcmd{gls\-xtr\-tagged\-list}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{singular tag}\margm{plural tag}\margm{label prefix}\margm{csv-list}}
+ \desc{similar to \gls{glsseelist}, this will start the list with
+ \meta{singular tag} if the list only contains one element and
+ \meta{plural tag} if the list contains more than one element.
+ Each element is prefixed with \meta{label prefix}. The tag is
+ separated from the start of the list with
+ \gls{glsxtrtaggedlistsep}. The actual list separators as as for
+ \gls{glsseelist}. The \meta{csv-list} is expanded before being
+ iterated over. Does nothing if \meta{csv-list} is empty}
+ }
+ % \glsxtrtaggedlistsep
+ \gcmd{gls\-xtr\-tagged\-list\-sep}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \initvalcs{space}
+ \desc{separator used by \gls{glsxtrtaggedlist} between the tag and the list}
+ }
+ % \glsxtrusesee
+ \gcmd{gls\-xtr\-use\-see}
+ {
+ \providedby{\sty{glossaries-extra} v1.06+}
+ \syntax{\margm{entry-label}}
+ \desc{if the entry given by \meta{entry-label} has the
+ \gloskey{see} field set, this will display the cross reference
+ according to \gls{glsxtruseseeformat}}
+ \field{seealso}{glsxtrusealias,glsxtruseseealso,glsxtrseelists}
+ }
+ % \glsxtrusealias
+ \gcmd{gls\-xtr\-use\-alias}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{entry-label}}
+ \desc{if the entry given by \meta{entry-label} has the
+ \gloskey{alias} field set, this will display the cross reference
+ according to \gls{glsxtruseseeformat}}
+ \field{seealso}{glsxtrusesee,glsxtruseseealso,glsxtrseelists}
+ }
+ % \glsxtruseseealso
+ \gcmd{gls\-xtr\-use\-see\-also}
+ {
+ \providedby{\sty{glossaries-extra} v1.16+}
+ \syntax{\margm{entry-label}}
+ \desc{if the entry given by \meta{entry-label} has the
+ \gloskey{seealso} field set, this will display the cross reference
+ according to \gls{glsxtruseseealsoformat}}
+ \field{seealso}{glsxtrusesee,glsxtrusealias,glsxtrseelists}
+ }
+ % \glsxtrseelists
+ \gcmd{gls\-xtr\-see\-lists}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{if the entry given by \meta{entry-label} has the
+ \gloskey{see}, \gloskey{seealso} or \gloskey{alias} fields set,
+ this will display the cross reference
+ according to \gls{glsxtruseseeformat} (for \gloskey{see} and
+ \gloskey{alias}) or \gls{glsxtruseseealsoformat} (for
+ \gloskey{seealso}). If any of these fields are set, the list is
+ encapsulated with \gls{glsxtrseelistsencap}}
+ \field{seealso}{glsxtrseelistsencap,glsxtrseelistsdelim}
+ }
+ % \glsxtrseelistsencap
+ \gcmd{gls\-xtr\-see\-lists\-encap}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{content}}
+ \desc{used by \gls{glsxtrseelists} to encapsulate the lists}
+ }
+ % \glsxtrseelistsdelim
+ \gcmd{gls\-xtr\-see\-lists\-delim}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{used by \gls{glsxtrseelists} to as separator between sub-lists}
+ }
+ % \glsxtruseseeformat
+ \gcmd{gls\-xtr\-use\-see\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.06+}
+ \syntax{\margm{tag}\margm{xr-list}}
+ \desc{format used by \gls{glsxtrusesee}. This internally uses
+ \gls{glsseeformat}}
+ }
+ % \glsxtruseseealsoformat
+ \gcmd{gls\-xtr\-use\-see\-also\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.16+}
+ \syntax{\margm{csv-list}}
+ \desc{formats the comma-separated list of entry labels as a
+ \qt{see also} cross-reference}
+ }
+ % \glsxtrindexseealso
+ \gcmd{gls\-xtr\-index\-see\-also}
+ {%
+ \providedby{\sty{glossaries-extra} v1.16+}
+ \syntax{\margm{entry-label}\margm{xr-list}}
+ \desc{indexes the entry identified by \meta{entry-label} as a
+ \qt{see also} cross-reference to the entries identified in the comma-separated
+ list \meta{xr-list}. The cross-reference list is prefixed with
+ \gls{seealsoname}}
+ \field{seealso}{glssee}
+ }
+ % \glsxtrsetaliasnoindex
+ \gcmd{gls\-xtr\-set\-alias\-no\-index}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \desc{hook used to switch off indexing for aliases}
+ }
+ % \glsxtrindexaliased
+ \gcmd{gls\-xtr\-index\-aliased}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \desc{index the current entry's alias. May only be used within
+ the definition of \gls{glsxtrsetaliasnoindex}}
+ }
+ % \glsxtralias
+ \gcmd{gls\-xtr\-alias}
+ {
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \syntax{\margm{entry-label}}
+ \desc{expands to the value of the \gloskey{alias} field for the
+ entry identified by \meta{entry-label}. If the field isn't set, this
+ will expand to nothing. If the entry isn't defined, this will expand
+ to \gls{relax}}
+ }
+ % \glsxtraliashook
+ \gcmd{gls\-xtr\-alias\-hook}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{hook implemented when the \gloskey{alias} key is provided when an
+ entry is defined}
+ }
+ % \glsxtrseealsolabels
+ \gcmd{gls\-xtr\-see\-also\-labels}
+ {
+ \providedby{\sty{glossaries-extra} v1.16+}
+ \syntax{\margm{entry-label}}
+ \desc{expands to the value of the \gloskey{seealso} field for the
+ entry identified by \meta{entry-label}. If the field isn't set, this
+ will expand to nothing. If the entry isn't defined, this will expand
+ to \gls{relax}}
+ }
+ % \glsxtraddallcrossrefs
+ \gcmd{gls\-xtr\-add\-all\-cross\-refs}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{iterates over all defined entries and indexes any
+ cross-references (identified by the \gloskey{see} or \gloskey{seealso}
+ keys) that haven't been used}
+ \field{seealso}{opt.indexcrossrefs}
+ }
+ % \glsxtraddunusedxrefs
+ \gcmd{gls\-xtr\-add\-un\-used\-xrefs}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{indexes any cross-references (identified by the \gloskey{see} or \gloskey{seealso}
+ keys) that haven't been used}
+ }
+ % \glsxtrunusedformat
+ \gcmd{gls\-xtr\-un\-used\-format}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{location}}
+ \desc{the \idxc{locationencap}{format} used by \gls{glsxtraddallcrossrefs}}
+ }
+ % \glsxtrdowrglossaryhook
+ \gcmd{gls\-xtr\-wr\-glossary\-hook}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.4+}
+ \syntax{\margm{entry-label}}
+ \desc{hook implemented everytime an entry is indexed}
+ }
+ % \GlsXtrSetAltModifier
+ \gcmd{Gls\-Xtr\-Set\-Alt\-Modifier}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.4+}
+ \syntax{\margm{token}\margm{options}}
+ \desc{sets \meta{token} as a modifier for the \idx{glslike} and
+ \idx{glstextlike} commands that will automatically implement the
+ given options}
+ }
+ % \GlsXtrSetStarModifier
+ \gcmd{Gls\-Xtr\-Set\-Star\-Modifier}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{options}}
+ \desc{overrides the options that should be implemented by the
+ star (\code{*}) modifier for \idx{glslike} and
+ \idx{glstextlike} commands}
+ }
+ % \GlsXtrSetPlusModifier
+ \gcmd{Gls\-Xtr\-Set\-Plus\-Modifier}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{options}}
+ \desc{overrides the options that should be implemented by the
+ plus (\code{+}) modifier for \idx{glslike} and
+ \idx{glstextlike} commands}
+ }
+ % \glslinkwrcontent
+ \gcmd{gls\-link\-wr\-content}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{code}}
+ \desc{encapsulates the \idx{linktext} and \idx{indexing}. Just
+ does \meta{code} by default}
+ }
+ % \glsencapwrcontent
+ \gcmd{gls\-encap\-wr\-content}
+ {
+ \providedby{\sty{glossaries} v4.50+ \& \sty{glossaries-extra} v1.49+}
+ \syntax{\margm{code}}
+ \desc{encapsulates the \idx{indexing} code (within \gls{glslinkwrcontent})}
+ }
+ % \glsentryindexcount
+ \gcmd{gls\-entry\-index\-count}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}}
+ \desc{expands to the number of times the given entry has been indexed. This
+ will expand to 0 if the entry hasn't been indexed or hasn't been defined}
+ }
+ % \glsifindexed
+ \gcmd{gls\-if\-indexed}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{entry-label}\margm{true}\margm{false}}
+ \desc{tests if the value obtained from \gls{glsentryindexcount} is greater than 0}
+ }
+ % \glswriteentry
+ \gcmd{gls\-write\-entry}
+ {%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{entry-label}\margm{code}}
+ \desc{performs the indexing code unless indexing should be suppressed}
+ }
+ % \glsxtrifindexing
+ \gcmd{gls\-xtr\-if\-indexing}
+ {%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{true}\margm{false}}
+ \desc{tests whether or not the \glsopt{noindex} has been set. Does
+ \meta{false} if \glsoptval{noindex}{true} otherwise does \meta{true}}
+ }
+ % \ifglsindexonlyfirst
+ \gcond{if\-gls\-index\-only\-first}
+ {%
+ \providedby{\sty{glossaries} v3.02+}
+ \initvalcs{iffalse}
+ \desc{a conditional that corresponds to the \opt{indexonlyfirst} option}
+ }
+ % \ifglsxtrinitwrglossbefore
+ \gcond{if\-gls\-xtr\-init\-wr\-gloss\-before}
+ {%
+ \providedby{\sty{glossaries-extra} v1.14+}
+ \initvalcs{iftrue}
+ \desc{a conditional that indicates whether or not
+ \glsoptval{wrgloss}{before} is set}
+ }
+ % \glsxtrinitwrglossbeforetrue
+ \gcmd{gls\-xtr\-init\-wr\-gloss\-before\-true}
+ {%
+ \providedby{\sty{glossaries-extra} v1.14+}
+ \desc{corresponds to \glsoptval{wrgloss}{before}}
+ }
+ % \glsxtrinitwrglossbeforefalse
+ \gcmd{gls\-xtr\-init\-wr\-gloss\-before\-false}
+ {%
+ \providedby{\sty{glossaries-extra} v1.14+}
+ \desc{corresponds to \glsoptval{wrgloss}{after}}
+ }
+ % \GlsXtrSetDefaultNumberFormat
+ \gcmd{Gls\-Xtr\-Set\-Default\-Number\-Format}
+ {
+ \providedby{\sty{glossaries-extra} v1.19+}
+ \syntax{\margm{encap}}
+ \desc{sets the default \glsopt{format} to \meta{encap} (without
+ the leading backslash)}
+ }
+ % \GlsXtrSetDefaultGlsOpts
+ \gcmd{Gls\-Xtr\-Set\-Default\-Gls\-Opts}
+ {%
+ %\providedby{\sty{glossaries-extra} v0.5.4+}
+ \syntax{\margm{options}}
+ \desc{locally set the default options for the
+ \idx{glslike} and \idx{glstextlike} commands}
+ }
+ % \GlsXtrAppToDefaultGlsOpts
+ \gcmd{Gls\-Xtr\-App\-To\-Default\-Gls\-Opts}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{options}}
+ \desc{locally append \meta{options} to the default options for the
+ \idx{glslike} and \idx{glstextlike} commands}
+ }
+ % \GlsXtrPreToDefaultGlsOpts
+ \gcmd{Gls\-Xtr\-Pre\-To\-Default\-Gls\-Opts}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{options}}
+ \desc{locally prepend \meta{options} to the default options for the
+ \idx{glslike} and \idx{glstextlike} commands}
+ }
+ % \glslinkpresetkeys
+ \gcmd{gls\-link\-pre\-set\-keys}
+ {%
+ \providedby{\sty{glossaries-extra} v1.26+}
+ \desc{hook implemented before setting the options passed to the
+ \idx{glslike} and \idx{glstextlike} commands}
+ }
+ % \glslinkpostsetkeys
+ \gcmd{gls\-link\-post\-set\-keys}
+ {%
+ \providedby{\sty{glossaries} v4.16+}
+ \desc{hook implemented after setting the options passed to the
+ \idx{glslike} and \idx{glstextlike} commands}
+ }
+ % \glslinkcheckfirsthyperhook
+ \gcmd{gls\-link\-check\-first\-hyper\-hook}
+ {
+ \providedby{\sty{glossaries} v4.08+}
+ \desc{hook used at the end of the code in the \idx{glslike}
+ commands that tests if the hyperlink should be switched off on \idx{firstuse}}
+ }
+ % \glsaddpresetkeys
+ \gcmd{gls\-add\-pre\-set\-keys}
+ {%
+ \providedby{\sty{glossaries-extra} v1.30+}
+ \desc{hook implemented before setting the options passed to \gls{glsadd}}
+ }
+ % \glsaddpostsetkeys
+ \gcmd{gls\-add\-post\-set\-keys}
+ {%
+ \providedby{\sty{glossaries-extra} v1.30+}
+ \desc{hook implemented after setting the options passed to \gls{glsadd}}
+ }
+ % \glsxtrinitwrgloss
+ \gcmd{gls\-xtr\-init\-wr\-gloss}
+ {%
+ \providedby{\sty{glossaries-extra} v1.14+}
+ \desc{hook that initialises the \glsopt{wrgloss} setting}
+ }
+ % \glsxtrinithyperoutside
+ \gcmd{gls\-xtr\-init\-hyper\-out\-side}
+ {%
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \desc{hook that initialises the \glsopt{hyperoutside} setting}
+ }
+ % \glsinitreunsets
+ \gcmd{gls\-init\-re\-un\-sets}
+ {%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{hook that initialises the \glsopt{prereset},
+ \glsopt{preunset} and \glsopt{postunset} settings}
+ }
+ % COMMANDS: CONDITIONALS
+ % \glsunset
+ \gcmd{gls\-unset}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}}
+ \desc{globally unsets the entry's \idx{firstuseflag}. That is, this marks the entry
+ as \qt{used}}
+ \field{seealso}{glslocalunset,glsreset,ifglsused,GlsXtrIfUnusedOrUndefined}
+ }
+ % \glslocalunset
+ \gcmd{gls\-local\-unset}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}}
+ \desc{locally unsets the entry's \idx{firstuseflag}. That is, this marks the entry
+ as \qt{used}}
+ \field{seealso}{glsunset,glslocalreset,ifglsused,GlsXtrIfUnusedOrUndefined}
+ }
+ % \glslocalunseteach
+ \gcmd{gls\-local\-unset\-each}
+ {%
+ \providedby{\sty{glossaries-extra} v1.31+}
+ \syntax{\margm{entry-labels}}
+ \desc{locally unsets each listed entry's \idx{firstuseflag}}
+ \field{seealso}{glsunset,glslocalreset,ifglsused,GlsXtrIfUnusedOrUndefined}
+ }
+ % \glsreset
+ \gcmd{gls\-reset}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}}
+ \desc{globally resets the entry's \idx{firstuseflag}. That is, this marks the entry
+ as \qt{not used}}
+ \field{seealso}{glslocalreset,glsunset,ifglsused,GlsXtrIfUnusedOrUndefined}
+ }
+ % \glslocalreset
+ \gcmd{gls\-local\-reset}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}}
+ \desc{locally resets the entry's \idx{firstuseflag}. That is, this marks the entry
+ as \qt{not used}}
+ \field{seealso}{glsreset,glslocalunset,ifglsused,GlsXtrIfUnusedOrUndefined}
+ }
+ % \glslocalreseteach
+ \gcmd{gls\-local\-reset\-each}
+ {%
+ \providedby{\sty{glossaries-extra} v1.31+}
+ \syntax{\margm{entry-labels}}
+ \desc{locally resets each listed entry's \idx{firstuseflag}}
+ \field{seealso}{glsreset,glslocalreset,ifglsused,GlsXtrIfUnusedOrUndefined}
+ }
+ % \glsunsetall
+ \gcmd{gls\-unset\-all}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{types}}
+ \desc{globally unsets all entries associated with the listed
+ glossaries or all glossaries if \meta{types} is omitted}
+ \field{seealso}{glsunset,glsresetall,ifglsused,GlsXtrIfUnusedOrUndefined}
+ }
+ % \glsresetall
+ \gcmd{gls\-reset\-all}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{types}}
+ \desc{globally resets all entries associated with the listed
+ glossaries or all glossaries if \meta{types} is omitted}
+ \field{seealso}{glsreset,glsunsetall,ifglsused,GlsXtrIfUnusedOrUndefined}
+ }
+ % \glslocalunsetall
+ \gcmd{gls\-local\-un\-set\-all}
+ {
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{glossary labels list}}
+ \desc{locally unsets the \idx+{firstuseflag} for all
+ entries in whose labels are listed in the \meta{glossary
+ labels list} comma-separated list. If the optional argument is
+ omitted, the list of all non-\idxpl{ignoredglossary} is assumed}
+ \field{seealso}{glsunset,glslocalunset,glsunsetall,glslocalresetall}
+ }
+ % \glslocalresetall
+ \gcmd{gls\-local\-re\-set\-all}
+ {
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{glossary labels list}}
+ \desc{locally resets the \idx+{firstuseflag} for all
+ entries in whose labels are listed in the \meta{glossary
+ labels list} comma-separated list. If the optional argument is
+ omitted, the list of all non-\idxpl{ignoredglossary} is assumed}
+ \field{seealso}{glsreset,glslocalreset,glsresetall,glslocalunsetall}
+ }
+ % \ifglsused
+ \gcmd{if\-gls\-used}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\margm{entry-label}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the entry has been marked as
+ \idxc{firstuseflag}{used}, does \meta{false} if the entry is
+ marked as \idxc{firstuseflag}{unused}, and does neither if
+ the entry hasn't been defined (but will generate an error or
+ warning according to \opt{undefaction})}
+ \field{seealso}{GlsXtrIfUnusedOrUndefined,glsxtrifwasfirstuse}
+ }
+ % \GlsXtrIfUnusedOrUndefined
+ \gcmd{Gls\-Xtr\-If\-Unused\-Or\-Undefined}
+ {
+ \providedby{\sty{glossaries-extra} v1.34+}
+ \syntax{\margm{entry-label}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the entry hasn't been defined or hasn't been marked as
+ \idxc{firstuseflag}{used}, otherwise does \meta{true}. Note
+ that this command will generate an error or warning (according to
+ \opt{undefaction}) if the entry hasn't been defined, but will
+ still do \meta{true}}
+ \field{seealso}{ifglsused,glsxtrifwasfirstuse}
+ }
+ % \glscurrentfieldvalue
+ \gcmd{gls\-current\-field\-value}
+ {
+ \providedby{\sty{glossaries} v4.23+}
+ \desc{conditional commands such as \gls{ifglshasfield} set this
+ to the field's value for use within the \meta{true} code}
+ }
+ % \ifglshasfield
+ \gcmd{if\-gls\-has\-field}
+ {
+ \providedby{\sty{glossaries} v4.03+}
+ \syntax{\margm{field}\margm{entry-label}\margm{true}\margm{false}}
+ \desc{if the field identified by either its key or its
+ \idx{internalfieldlabel} \meta{field} for the entry identified by
+ \meta{entry-label} is set and non-empty, this sets
+ \gls{glscurrentfieldvalue} to the field value and does \meta{true}
+ otherwise it does \meta{false}}
+ \field{seealso}{glsxtrifhasfield,ifglsfieldvoid}
+ }
+ % \ifglsfieldvoid
+ \gcmd{if\-gls\-field\-void}
+ {
+ \providedby{\sty{glossaries} v4.50+}
+ \syntax{\margm{field-label}\margm{entry-label}\margm{true}\margm{false}}
+ \desc{an expandable test to determine if the entry is undefined
+ or the field is undefined or empty. The \meta{field-label}
+ must be the field's \idxc{internalfieldlabel}{internal label}}
+ \field{seealso}{GlsXtrIfFieldUndef}
+ }%
+ % \ifglshasparent
+ \gcmd{if\-gls\-has\-parent}
+ {
+ \providedby{\sty{glossaries} v3.02+}
+ \syntax{\margm{entry-label}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the entry's \gloskey{parent} field is
+ set otherwise does \meta{false}}
+ }
+ % \ifglshasdesc
+ \gcmd{if\-gls\-has\-desc}
+ {
+ \providedby{\sty{glossaries} v3.08a+}
+ \syntax{\margm{entry-label}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the entry's \gloskey{description} field is
+ set otherwise does \meta{false}}
+ }
+ % \ifglshasdescsuppressed
+ \gcmd{if\-gls\-has\-desc\-suppressed}
+ {
+ \providedby{\sty{glossaries} v3.08a+}
+ \syntax{\margm{entry-label}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the entry's \gloskey{description} field is
+ just \gls{nopostdesc} otherwise does \meta{false}}
+ }
+ % \ifglshassymbol
+ \gcmd{if\-gls\-has\-symbol}
+ {
+ \providedby{\sty{glossaries} v3.08a+}
+ \syntax{\margm{entry-label}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the entry's \gloskey{symbol} field is
+ set otherwise does \meta{false}}
+ }
+ % \ifglshaslong
+ \gcmd{if\-gls\-has\-long}
+ {
+ \providedby{\sty{glossaries} v3.11a+}
+ \syntax{\margm{entry-label}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the entry's \gloskey{long} field is
+ set otherwise does \meta{false}}
+ }
+ % \ifglshasshort
+ \gcmd{if\-gls\-has\-short}
+ {
+ \providedby{\sty{glossaries} v3.11a+}
+ \syntax{\margm{entry-label}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the entry's \gloskey{short} field is
+ set otherwise does \meta{false}}
+ }
+ % \ifglshaschildren
+ \gcmd{if\-gls\-has\-children}
+ {
+ \providedby{\sty{glossaries} v3.02+}
+ \syntax{\margm{entry-label}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the given entry has child entries
+ otherwise does \meta{false}. Note that this has to iterate over
+ the set of defined entries for the entry's \idx{glossary} to
+ find one that has the entry identified in its \gloskey{parent}
+ field. A more efficient approach can be achieved with
+ \app{bib2gls} and the \resourceopt{save-child-count} resource option}
+ \field{seealso}{GlsXtrIfHasNonZeroChildCount}
+ }
+ % COMMANDS: LOOPS
+ % \forglsentries
+ \gcmd{for\-gls\-entries}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{type}\margm{cs}\margm{body}}
+ \desc{iterates over all entries in the given \idx{glossary}
+ and, at each iteration, defines the command \meta{cs}
+ to the current entry label and does \meta{body}. The optional
+ argument \meta{type} is the \idx{glossary}
+ label and defaults to \gls{glsdefaulttype} if omitted.
+ This command can't be used with \app{bib2gls} since there are no
+ defined entries until \app{bib2gls} has selected them and added
+ them to the \ext{glstex} file}
+ \field{seealso}{forallglsentries}
+ }
+ % \forallglsentries
+ \gcmd{for\-all\-gls\-entries}
+ {%
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{types}\margm{cs}\margm{body}}
+ \desc{does \gls{forglsentries} for each \idx{glossary}. The optional
+ argument \meta{types} is a comma-separated list of \idx{glossary}
+ labels. If omitted, all non-\idxpl{ignoredglossary} is assumed}
+ }
+ % \forallglossaries
+ \gcmd{for\-all\-glossaries}
+ {
+ \providedby{\sty{glossaries}}
+ \syntax{\oargm{types}\margm{cs}\margm{body}}
+ \desc{iterates overall all the \idx{glossary} labels given in
+ the \meta{types} argument, defines the command \meta{cs} to the
+ current label and does \meta{body}. If the optional argument is
+ omitted, the list of all non-\idxpl{ignoredglossary} is assumed}
+ }
+ % \forallacronyms
+ \gcmd{for\-all\-acronyms}
+ {
+ \banned
+ \providedby{\sty{glossaries} v4.08+}
+ \syntax{\margm{cs}\margm{body}}
+ \desc{iterates overall all \idxpl{glossary} that have been
+ declared lists of acronyms, defines the command \meta{cs} to the
+ current label and does \meta{body}. Use
+ \gls{forallabbreviationlists} with \sty{glossaries-extra}}
+ }
+ % \forallabbreviationlists
+ \gcmd{forallabbreviationlists}
+ {
+ \providedby{\sty{glossaries-extra} v1.42+}
+ \syntax{\margm{cs}\margm{body}}
+ \desc{iterates overall all lists of abbreviations, defines the
+ command \meta{cs} to the current label and does \meta{body}}
+ \field{seealso}{forallglossaries}
+ }
+ % CATEGORIES
+ \gidxpl{category}{\field{plural}{categories}
+ \common
+ \desc{with \sty{glossaries-extra}, each entry has an associated
+ category (a simple label) assigned with the \gloskey{category} key. Each category
+ can have a set of \attrs\ (assigned with
+ commands like \gls{glssetcategoryattribute}), which can affect the way the entry
+ is formatted. Some categories, such as \cat{general}, are supplied by
+ \sty{glossaries-extra}}
+ }
+ % general category
+ \gcat{general}{\desc{the default \idx{category} for
+ \gls{newglossaryentry} and similar commands. This
+ category has the \catattr{regular} attribute set to \code{true}}}%
+ % abbreviation category
+ \gcat{abbreviation}{\desc{the default \idx{category} for
+ \gls{newabbreviation}}}%
+ % acronym category
+ \gcat{acronym}{\desc{the default \idx{category} for
+ \gls{newacronym} (as redefined by \sty{glossaries-extra}). This
+ category has the \catattr{regular} attribute set to \code{true}
+ by default but this may be changed to \code{false} by certain
+ \idx{abbrvstyle}}}%
+ % symbol category
+ \gcat{symbol}{\desc{the default \idx{category} for
+ \gls{glsxtrnewsymbol}. This
+ category has the \catattr{regular} attribute set to \code{true}}}%
+ % number category
+ \gcat{number}{\desc{the default \idx{category} for
+ \gls{glsxtrnewnumber}. This
+ category has the \catattr{regular} attribute set to \code{true}}}%
+ % index category
+ \gcat{index}{\desc{the default \idx{category} for
+ \gls{newterm} (as redefined by \sty{glossaries-extra}). This
+ category has the \catattr{regular} attribute set to \code{true}}}%
+ % term category
+ \gcat{term}{\desc{a \idx{catpostdeschook} is provided for this
+category, but no commands are provided that set the
+\gloskey{category} key to this label}}
+ % CATEGORY ATTRIBUTES
+ \gidxpl{categoryattribute}{\field{text}{category attribute}%
+ \desc{a category can have a set of attributes (assigned with commands like
+ \gls{glssetcategoryattribute}), which can affect the way the entry
+ is formatted. Some attributes are recognised by certain
+ commands. Custom attributes can also be defined and referenced
+ in hooks or custom commands as required}
+ }
+ % regular
+ \gcatattr{regular}%
+ {%
+ \common
+ \syntax{\meta{boolean}}
+ \desc{if set to \code{true}, this attribute indicates that the
+ entry should be treated as a regular entry (the
+ \gloskey{first}\slash\gloskey{firstplural} key is used on
+ \idx{firstuse} and the \gloskey{text}\slash\gloskey{plural} key
+ is used on subsequent use). If set to \code{false}, the entry
+ is assumed to be governed by the \idx{abbrvstyle} associated
+ with the category or the default style for the
+ \cat{abbreviation} category, if no style is associated with the
+ entry's category. If this attribute isn't set, \code{true} is
+ assumed. Certain \idxpl{abbrvstyle} set this attribute to
+ \code{true} or \code{false}, depending on the complexity of the
+ style}
+ }
+ % markwords
+ \gcatattr{mark\-words}%
+ {%
+ \syntax{\meta{boolean}}
+ \desc{if set to \code{true}, this attribute indicates that
+ abbreviations should have the words in the long form marked up
+ with \gls{glsxtrword} and separated by \gls{glsxtrwordsep}. If
+ this attribute isn't set, \code{false} is assumed}
+ }
+ % markshortwords
+ \gcatattr{mark\-short\-words}%
+ {%
+ \syntax{\meta{boolean}}
+ \desc{if set to \code{true}, this attribute indicates that
+ abbreviations should have the words in the short form marked up
+ with \gls{glsxtrword} and separated by \gls{glsxtrwordsep}. If
+ this attribute isn't set, \code{false} is assumed}
+ }
+ % discardperiod
+ \gcatattr{discard\-period}%
+ {
+ \syntax{\meta{boolean}}
+ \desc{this attribute is provided for abbreviations that end in a
+ \idx{fullstop}. If set to \code{true}, indicates that
+ the \idx{postlinkhook} will discard a \idx{fullstop} that
+ follows \emph{non-plural} commands like \gls{gls} or \gls{glstext}}
+ }
+ % pluraldiscardperiod
+ \gcatattr{plural\-discard\-period}%
+ {
+ \syntax{\meta{boolean}}
+ \desc{as \catattr{discardperiod} but for plural commands like \gls{glspl}}
+ }
+ % insertdots
+ \gcatattr{insert\-dots}%
+ {
+ \syntax{\meta{boolean}}
+ \desc{if set to \code{true}, this attribute indicates that
+ the abbreviation short form should have a \idx{fullstop} automatically
+ inserted after every character}
+ }
+ % accessinsertdots
+ \gcatattr{access\-insert\-dots}%
+ {
+ \syntax{\meta{boolean}}
+ \desc{if set to \code{true}, this attribute indicates that
+ the abbreviation accessibility replacement (provided in the
+ \gloskey{shortaccess} key) should have a \idx{fullstop} automatically
+ inserted after every character. Only checked if
+ \catattr{insertdots} hasn't been set}
+ }
+ % retainfirstuseperiod
+ \gcatattr{retain\-first\-use\-period}
+ {
+ \providedby{\sty{glossaries-extra} v1.01+}
+ \syntax{\meta{boolean}}
+ \desc{if set, the \idx{fullstop} won't be discarded for
+ \idx{firstuse} with \catattr{discardperiod} or
+ \catattr{pluraldiscardperiod}}
+ }
+ % noshortplural
+ \gcatattr{no\-short\-plural}%
+ {%
+ \syntax{\meta{boolean}}
+ \desc{if set to \code{true}, this attribute indicates that
+ abbreviations should have the \gloskey{shortplural} field set to the
+ same as the \gloskey{short} value by default}
+ }
+ % accessnoshortplural
+ \gcatattr{access\-no\-short\-plural}%
+ {%
+ \syntax{\meta{boolean}}
+ \desc{if set to \code{true} and \gloskey{shortpluralaccess}
+ hasn't been set, this attribute indicates that
+ abbreviations should have the \gloskey{shortpluralaccess} field set to the
+ same as the \gloskey{shortaccess} value by default}
+ }
+ % aposplural
+ \gcatattr{apos\-plural}%
+ {%
+ \syntax{\meta{boolean}}
+ \desc{if set to \code{true}, this attribute indicates that
+ abbreviations should have the \gloskey{shortplural} field set to the
+ short form followed by \code{'\gls{abbrvpluralsuffix}} by default}
+ }
+ % accessaposplural
+ \gcatattr{access\-apos\-plural}%
+ {%
+ \syntax{\meta{boolean}}
+ \desc{if set to \code{true} and \gloskey{shortpluralaccess}
+ hasn't been set, this attribute indicates that
+ abbreviations should have the \gloskey{shortpluralaccess} field set to the
+ short form followed by \code{'\gls{glsxtrpluralsuffix}} by default}
+ }
+ % nameshortaccess
+ \gcatattr{name\-short\-access}
+ {%
+ \syntax{\meta{boolean}}
+ \desc{if the \gloskey{access} hasn't been set then if this
+ attribute is \code{true}, the \gloskey{access} field will be
+ set to the \gloskey{shortaccess}}
+ }
+ % textshortaccess
+ \gcatattr{text\-short\-access}
+ {%
+ \syntax{\meta{boolean}}
+ \desc{if the \gloskey{textaccess} hasn't been set then if this
+ attribute is \code{true}, the \gloskey{textaccess} field will be
+ set to the \gloskey{shortaccess} and, likewise, if the
+ \gloskey{pluralaccess} field hasn't been set it will be set to the
+ \gloskey{shortpluralaccess}}
+ }
+ % firstshortaccess
+ \gcatattr{first\-short\-access}
+ {%
+ \syntax{\meta{boolean}}
+ \desc{if the \gloskey{firstaccess} hasn't been set then if this
+ attribute is \code{true}, the \gloskey{firstaccess} field will be
+ set to the \gloskey{shortaccess} and, likewise, if the
+ \gloskey{firstpluralaccess} field hasn't been set it will be set to the
+ \gloskey{shortpluralaccess}}
+ }
+ % tagging
+ \gcatattr{tagging}%
+ {
+ \syntax{\meta{boolean}}
+ \desc{if set to \code{true}, this attribute indicates that
+ abbreviations with the associated category use the command
+ defined with \gls{GlsXtrEnableInitialTagging} to tag initials}
+ }
+ % textformat
+ \gcatattr{text\-format}%
+ {
+ \syntax{\meta{cs-name}}
+ \desc{if set, the value should be the name of a control sequence
+ (without the leading backslash) that should be used to
+ encapsulate the link text (instead of \gls{glstextformat})}
+ }
+ % innertextformat
+ \gcatattr{inner\-text\-format}%
+ {
+ \syntax{\meta{cs-name}}
+ \desc{when used with \gls{glsxtrattrentrytextfmt}, the value
+ should be the name of a control sequence (without the leading
+ backslash)}
+ }
+ % nohyper
+ \gcatattr{no\-hyper}
+ {
+ \syntax{\meta{boolean}}
+ \desc{if set to \code{true}, this attribute indicates that
+ the hyperlink should be switched off for commands like \gls{gls}}
+ }
+ % nohyperfirst
+ \gcatattr{no\-hyper\-first}
+ {
+ \syntax{\meta{boolean}}
+ \desc{if set to \code{true}, this attribute indicates that
+ the hyperlink should be switched off on \idx{firstuse} of the
+ \idx{glslike} commands}
+ }
+ % nohypernext
+ \gcatattr{no\-hyper\-next}
+ {
+ \syntax{\meta{boolean}}
+ \desc{if set to \code{true}, this attribute indicates that
+ the hyperlink should be switched off on \idx{subsequentuse} of the
+ \idx{glslike} commands}
+ }
+ % indexonlyfirst
+ \gcatattr{index\-only\-first}
+ {
+ \syntax{\meta{boolean}}
+ \desc{if set to \code{true}, this attribute indicates that
+ \idx{indexing} should only occur on \idx{firstuse}}
+ }
+ % indexname
+ \gcatattr{index\-name}
+ {
+ \providedby{\sty{glossaries-extra}}
+ \syntax{\margm{value}}
+ \desc{used by the \idx{postnamehook} with
+ \gls{glsxtrdoautoindexname} to indicate that an entry
+ needs to be automatically indexed with \gls{index}. The value
+ may be \code{true} or the encap}
+ }
+ % wrgloss
+ \gcatattr{wr\-gloss}
+ {
+ \syntax{\meta{value}}
+ \desc{determines whether the \idx{indexing} is performed before or
+ after the \idx{linktext}. If the value is \code{after} then
+ \glsoptval{wrgloss}{after} otherwise it implements
+ \glsoptval{wrgloss}{before}}
+ }
+ % hyperoutside
+ \gcatattr{hyper\-out\-side}
+ {
+ \syntax{\meta{boolean}}
+ \desc{if set to \code{true}, this attribute indicates that
+ the hyperlink should be outside of the outer formatting command}
+ }
+ % headuc
+ \gcatattr{head\-uc}%
+ {%
+ \syntax{\meta{boolean}}
+ \desc{if set to \code{true}, this attribute indicates that the
+ text produced by commands like \gls{glsfmttext} should be converted
+ to \idx+{allcaps} when they appear in a page header}
+ }
+ % encapnocase
+ \gcatattr{encap\-no\-case}
+ {
+ \syntax{\meta{internal field list}}
+ \desc{if set, all the listed fields (identified by their
+ \idx{internalfieldlabel}) will have their values encapsulated
+ with \gls{NoCaseChange} when an entry with the associated category is defined}
+ }
+ % encapinnerfmt
+ \gcatattr{encap\-inner\-fmt}
+ {
+ \syntax{\meta{internal field list}}
+ \desc{if set, all the listed fields (identified by their
+ \idx{internalfieldlabel}) will have their values encapsulated
+ with the inner formatting command \gls{glsxtrgenentrytextfmt}
+ when an entry with the associated category is defined}
+ }
+ % encapnocaseinnerfmt
+ \gcatattr{encap\-no\-case\-inner\-fmt}
+ {
+ \syntax{\meta{internal field list}}
+ \desc{combines \catattr{encapnocase} and \catattr{encapinnerfmt}
+ for the same field set}
+ }
+ % entrycount
+ \gcatattr{entry\-count}
+ {
+ \syntax{\meta{trigger-value}}
+ \desc{when used with entry counting, this attribute provides the trigger value}
+ }
+ % unitcount
+ \gcatattr{unit\-count}
+ {
+ \syntax{\meta{counter}}
+ \desc{when used with unit entry counting, this attribute
+ provides the name of the counter associated with the unit}
+ }
+ % recordcount
+ \gcatattr{record\-count}
+ {
+ \syntax{\meta{trigger-value}}
+ \desc{when used with record counting, this attribute provides the trigger value}
+ }
+ % multioptions
+ \gcatattr{multioptions}
+ {
+ \syntax{\meta{options}}
+ \desc{default options to apply to any multi-entry set for the
+ given category}
+ }
+ % glossname
+ \gcatattr{gloss\-name}
+ {
+ \syntax{\meta{value}}
+ \desc{indicates if any \idx{casechange} should be applied
+ within \gls{glossentryname}}
+ }
+ % glossdesc
+ \gcatattr{gloss\-desc}
+ {
+ \syntax{\meta{value}}
+ \desc{indicates if any \idx{casechange} should be applied
+ within \gls{glossentrydesc}}
+ }
+ % glossnamefont
+ \gcatattr{gloss\-name\-font}
+ {
+ \syntax{\meta{cs-name}}
+ \desc{the control sequence name (without the leading backslash)
+ to format the name within \gls{glossentryname}}
+ }
+ % glossdescfont
+ \gcatattr{gloss\-desc\-font}
+ {
+ \syntax{\meta{cs-name}}
+ \desc{the control sequence name (without the leading backslash)
+ to format the description within \gls{glossentrydesc}}
+ }
+ % glosssymbolfont
+ \gcatattr{gloss\-symbol\-font}
+ {
+ \syntax{\meta{cs-name}}
+ \desc{the control sequence name (without the leading backslash)
+ to format the symbol within \gls{glossentrysymbol}}
+ }
+ % linkcount
+ \gcatattr{link\-count}
+ {
+ \syntax{\meta{boolean}}
+ \desc{if true, link counting is enabled}
+ }
+ % linkcountmaster
+ \gcatattr{link\-count\-master}
+ {
+ \syntax{\meta{counter-name}}
+ \desc{if link counting is enabled, the value should be the name
+ of the counter that needs to have its reset list updated}
+ }
+ % dualindex
+ \gcatattr{dual\-index}
+ {
+ \syntax{\meta{value}}
+ \desc{if set, implement dual indexing}
+ }
+ % targeturl
+ \gcatattr{target\-url}
+ {
+ \syntax{\meta{url}}
+ \desc{if set, indicates the target URL for the hyperlinks
+ created by the \idx{glslike} and \idx{glstextlike} commands}
+ }
+ % targetname
+ \gcatattr{target\-name}
+ {
+ \syntax{\meta{anchor}}
+ \desc{if set, the named anchor within the URL provided by
+ \catattr{targeturl}}
+ }
+ % targetcategory
+ \gcatattr{target\-category}
+ {
+ \syntax{\meta{anchor}}
+ \desc{if set, the named anchor category within the URL provided by
+ \catattr{targeturl} (combined with \catattr{targetname})}
+ }
+ % externallocation
+ \gcatattr{external\-location}
+ {
+ \providedby{\sty{glossaries-extra} v1.14+}
+ \syntax{\meta{PDF filename}}
+ \desc{if set, the value is the filename of the external target PDF document
+ (used by \gls{glsxtrsupphypernumber})}
+ }
+ % combinedsep
+ \gcatattr{combined\-sep}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\meta{separator}}
+ \desc{if set, indicates separator to use in \gls{glscombinedsep}}
+ }
+ % combinedsepfirst
+ \gcatattr{combined\-sep\-first}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\meta{separator}}
+ \desc{if set, indicates separator to use in \gls{glscombinedsepfirst}}
+ }
+ % combinedfirstsepfirst
+ \gcatattr{combined\-first\-sep\-first}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\meta{separator}}
+ \desc{if set, indicates separator to use in \gls{glscombinedfirstsepfirst}}
+ }
+ % combinedfirstsep
+ \gcatattr{combined\-first\-sep}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\meta{separator}}
+ \desc{if set, indicates separator to use in \gls{glscombinedfirstsep}}
+ }
+ % COMMANDS: bib2gls
+ % \glsxtrresourcefile
+ \gcmd{gls\-xtr\-resource\-file}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.11+}
+ \syntax{\oargm{options}\margm{basename}}
+ \field{seealso}{idx.resourceopt,GlsXtrLoadResources}
+ \desc{for use with \app{bib2gls}, this both sets up the options
+ for the \idx{resourceset} (which \app{bib2gls} can detect from the
+ \ext{aux} file) and inputs the file \metafilefmt{}{basename}{.glstex} file
+ created by \app{bib2gls}}
+ }
+ % \GlsXtrLoadResources
+ \gcmd{Gls\-Xtr\-Load\-Resources}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.11+}
+ \syntax{\oargm{options}}
+ \field{seealso}{idx.resourceopt}
+ \desc{a shortcut that uses
+ \gls{glsxtrresourcefile}\oargm{options}\margm{basename}, where
+ the \meta{basename} is obtained from \gls{jobname} and
+ \gls{glsxtrresourcecount}}
+ }
+ % \glsxtrresourcecount
+ \gcmd{gls\-xtr\-resource\-count}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \desc{a count register that is incremented on each use of
+ \gls{GlsXtrLoadResources} to provide a unique basename for each
+ \idx{resourceset}}
+ }
+ % \glsxtrresourceinit
+ \gcmd{gls\-xtr\-resource\-init}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \desc{may be defined to temporarily change command definitions
+ before information is written to the \ext{aux} file by the protected
+ write used by \gls{glsxtrresourcefile}}
+ }
+ % \GlsXtrDefaultResourceOptions
+ \gcmd{Gls\-Xtr\-Default\-Resource\-Options}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.40+}
+ \desc{expands to default \idxpl{resourceopt}}
+ }
+ % \glsxtr@resource
+ \gcmd{gls\-xtr\-@\-resource}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.08+}
+ \syntax{\margm{options}\margm{basename}}
+ \desc{used in the \ext{aux} file to provide the
+ \idxpl{resourceopt} for \app{bib2gls} for each \idx{resourceset}.
+ Ignored by \LaTeX}
+ }
+ % \glsxtr@record
+ \gcmd{gls\-xtr\-@\-record}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.08+}
+ \syntax{\margm{entry-label}\margm{h-prefix}\margm{counter}\margm{encap}\margm{location}}
+ \desc{used in the \ext{aux} file to provide the \record\ for
+ \app{bib2gls} (\opteqvalref{record}{only}). Ignored by \LaTeX}
+ }
+ % \glsxtr@record@nameref
+ \gcmd{gls\-xtr\-@\-record\-@\-name\-ref}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.37+}
+ \syntax{\margm{entry-label}\margm{h-prefix}\margm{counter}\margm{encap}\margm{location}\margm{current title}\margm{current anchor}\margm{the-h-counter}}
+ \desc{used in the \ext{aux} file to provide the
+ \optvalref{record}{nameref} \record\ for \app{bib2gls}. Ignored by \LaTeX}
+ }
+ % \glsxtrMFUsave
+ \gcmd{gls\-xtr\-MFU\-save}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{used on the first instance of \gls{glsxtrresourcefile},
+ this will add \gls{MFUsave} to the begin document hook and
+ then disable itself. This is provided to help \app{bib2gls}
+ pick up any of \sty{mfirstuc}['s] exclusions, blockers and
+ mappings to assist with its \idx{sentencecase} function}
+ }
+ % \bibgls@input
+ \gcmd{bib\-gls\-@\-in\-put}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{filename}}
+ \desc{indicates that the \app{bib2gls} records are in the file
+ identified in the argument \meta{filename}, which corresponds
+ to the file \metafilefmt{}{basename}{.aux} identified in the option
+ \optval{bibglsaux}{\meta{basename}}}
+ }
+ % \IfTeXParserLib
+ \gcmd{If\-TeX\-Parser\-Lib}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \syntax{\margm{\TeX\ parser lib code}\margm{\LaTeX\ code}}
+ \desc{defined by \sty{glossaries-extra-bib2gls} to \meta{\LaTeX\ code}
+ but defined by \app{bib2gls}['s] interpreter to expand to
+ \meta{\TeX\ parser lib code}}
+ }
+ % \glshex
+ \gcmd{gls\-hex}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.21+}
+ \syntax{\meta{hex}}
+ \desc{expands to \code{\gls{string}\gls{u}\meta{hex}}}
+ }
+ % \u
+ \gcmd{u}
+ {
+ \syntax{\meta{hex}}
+ \desc{recognised by \app{bib2gls} within some \idxpl{resourceopt}
+ as identifying the Unicode character given by \meta{hex}. Since
+ \csfmt{u} is defined by the \LaTeX\ kernel, you need to protect
+ it from expansion while the options are written to the \ext{aux} file
+ (\code{\gls{string}\csfmt{u}\meta{hex}})}
+ \field{seealso}{glshex}
+ }
+ % \glscapturedgroup
+ \gcmd{gls\-captured\-group}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.31+}
+ \syntax{\meta{n}}
+ \desc{expands to \code{\gls{string}\gls{dollar}\meta{n}}}
+ }
+ % \glshashchar
+ \gcmd{gls\-hash\-char}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \desc{expands to a literal hash \idx{sym.hash}}
+ }
+ % \GlsXtrBibTeXEntryAliases
+ \gcmd{Gls\-Xtr\-Bib\-TeX\-Entry\-Aliases}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.29+}
+ \desc{expands to the \BibTeX\ to \app{bib2gls} entry aliases
+ for use in \resourceopt{entry-type-aliases}}
+ }
+ % \GlsXtrProvideBibTeXFields
+ \gcmd{Gls\-Xtr\-Provide\-Bib\-TeX\-Fields}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.29+}
+ \desc{provides the standard \BibTeX\ fields as glossary entry
+ keys (using \gls{glsaddstoragekey})}
+ }
+ % \glsxtrbibaddress
+ \gcmd{gls\-xtr\-bib\-address}
+ {
+ \note{defined by \gls{GlsXtrProvideBibTeXFields}}
+ \syntax{\margm{entry-label}}
+ \desc{accesses the \fieldfmt{address} field}
+ }
+ % \glsxtrbibauthor
+ \gcmd{gls\-xtr\-bib\-author}
+ {
+ \note{defined by \gls{GlsXtrProvideBibTeXFields}}
+ \syntax{\margm{entry-label}}
+ \desc{accesses the \fieldfmt{author} field}
+ }
+ % \glsxtrbibbooktitle
+ \gcmd{gls\-xtr\-bib\-book\-title}
+ {
+ \note{defined by \gls{GlsXtrProvideBibTeXFields}}
+ \syntax{\margm{entry-label}}
+ \desc{accesses the \fieldfmt{booktitle} field}
+ }
+ % \glsxtrbibchapter
+ \gcmd{gls\-xtr\-bib\-chapter}
+ {
+ \note{defined by \gls{GlsXtrProvideBibTeXFields}}
+ \syntax{\margm{entry-label}}
+ \desc{accesses the \fieldfmt{chapter} field}
+ }
+ % \glsxtrbibedition
+ \gcmd{gls\-xtr\-bib\-edition}
+ {
+ \note{defined by \gls{GlsXtrProvideBibTeXFields}}
+ \syntax{\margm{entry-label}}
+ \desc{accesses the \fieldfmt{edition} field}
+ }
+ % \glsxtrbibhowpublished
+ \gcmd{gls\-xtr\-bib\-how\-published}
+ {
+ \note{defined by \gls{GlsXtrProvideBibTeXFields}}
+ \syntax{\margm{entry-label}}
+ \desc{accesses the \fieldfmt{howpublished} field}
+ }
+ % \glsxtrbibinstitution
+ \gcmd{gls\-xtr\-bib\-institution}
+ {
+ \note{defined by \gls{GlsXtrProvideBibTeXFields}}
+ \syntax{\margm{entry-label}}
+ \desc{accesses the \fieldfmt{institution} field}
+ }
+ % \glsxtrbibjournal
+ \gcmd{gls\-xtr\-bib\-journal}
+ {
+ \note{defined by \gls{GlsXtrProvideBibTeXFields}}
+ \syntax{\margm{entry-label}}
+ \desc{accesses the \fieldfmt{journal} field}
+ }
+ % \glsxtrbibmonth
+ \gcmd{gls\-xtr\-bib\-month}
+ {
+ \note{defined by \gls{GlsXtrProvideBibTeXFields}}
+ \syntax{\margm{entry-label}}
+ \desc{accesses the \fieldfmt{month} field}
+ }
+ % \glsxtrbibnote
+ \gcmd{gls\-xtr\-bib\-note}
+ {
+ \note{defined by \gls{GlsXtrProvideBibTeXFields}}
+ \syntax{\margm{entry-label}}
+ \desc{accesses the \fieldfmt{note} field}
+ }
+ % \glsxtrbibnumber
+ \gcmd{gls\-xtr\-bib\-number}
+ {
+ \note{defined by \gls{GlsXtrProvideBibTeXFields}}
+ \syntax{\margm{entry-label}}
+ \desc{accesses the \fieldfmt{number} field}
+ }
+ % \glsxtrbiborganization
+ \gcmd{gls\-xtr\-bib\-organization}
+ {
+ \note{defined by \gls{GlsXtrProvideBibTeXFields}}
+ \syntax{\margm{entry-label}}
+ \desc{accesses the \fieldfmt{organization} field}
+ }
+ % \glsxtrbibpages
+ \gcmd{gls\-xtr\-bib\-pages}
+ {
+ \note{defined by \gls{GlsXtrProvideBibTeXFields}}
+ \syntax{\margm{entry-label}}
+ \desc{accesses the \fieldfmt{pages} field}
+ }
+ % \glsxtrbibpublisher
+ \gcmd{gls\-xtr\-bib\-publisher}
+ {
+ \note{defined by \gls{GlsXtrProvideBibTeXFields}}
+ \syntax{\margm{entry-label}}
+ \desc{accesses the \fieldfmt{publisher} field}
+ }
+ % \glsxtrbibschool
+ \gcmd{gls\-xtr\-bib\-school}
+ {
+ \note{defined by \gls{GlsXtrProvideBibTeXFields}}
+ \syntax{\margm{entry-label}}
+ \desc{accesses the \fieldfmt{school} field}
+ }
+ % \glsxtrbibseries
+ \gcmd{gls\-xtr\-bib\-series}
+ {
+ \note{defined by \gls{GlsXtrProvideBibTeXFields}}
+ \syntax{\margm{entry-label}}
+ \desc{accesses the \fieldfmt{series} field}
+ }
+ % \glsxtrbibtitle
+ \gcmd{gls\-xtr\-bib\-title}
+ {
+ \note{defined by \gls{GlsXtrProvideBibTeXFields}}
+ \syntax{\margm{entry-label}}
+ \desc{accesses the \fieldfmt{title} field}
+ }
+ % \glsxtrbibvolume
+ \gcmd{gls\-xtr\-bib\-volume}
+ {
+ \note{defined by \gls{GlsXtrProvideBibTeXFields}}
+ \syntax{\margm{entry-label}}
+ \desc{accesses the \fieldfmt{volume} field}
+ }
+ % \glsxtrbibtype
+ \gcmd{gls\-xtr\-bib\-type}
+ {
+ \note{defined by \gls{GlsXtrProvideBibTeXFields}}
+ \syntax{\margm{entry-label}}
+ \desc{accesses the \fieldfmt{bibtextype} field}
+ }
+ % \glsxtrprovidecommand
+ \gcmds{gls\-xtr\-provide\-command}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \syntax{\margm{cs}\oargm{n}\oargm{default}\margm{definition}}
+ \desc{just uses \gls{providecommand} within the \LaTeX\ document
+ but is treated as \gls{renewcommand} by \app{bib2gls}['s]
+ interpreter}
+ }
+ % \glsrenewcommand
+ \gcmds{gls\-re\-new\-command}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.37+}
+ \syntax{\margm{cs}\oargm{n}\oargm{default}\margm{definition}}
+ \desc{like \gls{renewcommand} but only issues a warning instead
+ of an error if the command hasn't been defined}
+ }
+ % \GlsXtrIndexCounterLink
+ \gcmd{Gls\-Xtr\-Index\-Counter\-Link}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.29+}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{creates a hyperlink (if supported) to the target
+ obtained from \glosfield{indexcounter}, if the field has been
+ defined with the given hyperlink text (otherwise just does
+ \meta{text})}
+ }
+ % \Alpha
+ \gcmd{Alpha}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand}, this just does
+ \code{\cmd{mathrm}\marg{A}}}
+ }
+ % \Beta
+ \gcmd{Beta}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand}, this just does
+ \code{\cmd{mathrm}\marg{B}}}
+ }
+ % \Epsilon
+ \gcmd{Epsilon}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand}, this just does
+ \code{\cmd{mathrm}\marg{E}}}
+ }
+ % \Zeta
+ \gcmd{Zeta}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand}, this just does
+ \code{\cmd{mathrm}\marg{Z}}}
+ }
+ % \Eta
+ \gcmd{Eta}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand}, this just does
+ \code{\cmd{mathrm}\marg{H}}}
+ }
+ % \Iota
+ \gcmd{Iota}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand}, this just does
+ \code{\cmd{mathrm}\marg{I}}}
+ }
+ % \Kappa
+ \gcmd{Kappa}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand}, this just does
+ \code{\cmd{mathrm}\marg{K}}}
+ }
+ % \Mu
+ \gcmd{Mu}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand}, this just does
+ \code{\cmd{mathrm}\marg{M}}}
+ }
+ % \Nu
+ \gcmd{Nu}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand}, this just does
+ \code{\cmd{mathrm}\marg{N}}}
+ }
+ % \Omicron
+ \gcmd{Omicron}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand}, this just does
+ \code{\cmd{mathrm}\marg{O}}}
+ }
+ % \omicron
+ \gcmd{omicron}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand}, this just does
+ \code{\cmd{mathrm}\marg{O}}}
+ }
+ % \Rho
+ \gcmd{Rho}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand}, this just does
+ \code{\cmd{mathrm}\marg{P}}}
+ }
+ % \Tau
+ \gcmd{Tau}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand}, this just does
+ \code{\cmd{mathrm}\marg{T}}}
+ }
+ % \Chi
+ \gcmd{Chi}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand}, this just does
+ \code{\cmd{mathrm}\marg{X}}}
+ }
+ % \Digamma
+ \gcmd{Digamma}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand}, this just does
+ \code{\cmd{mathrm}\marg{F}}}
+ }
+ % \Upalpha
+ \gcmd{Upalpha}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand} and only if
+ \sty{upgreek} has been loaded, this just does
+ \code{\cmd{mathrm}\marg{A}}}
+ }
+ % \Upbeta
+ \gcmd{Upbeta}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand} and only if
+ \sty{upgreek} has been loaded, this just does
+ \code{\cmd{mathrm}\marg{B}}}
+ }
+ % \Upepsilon
+ \gcmd{Upepsilon}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand} and only if
+ \sty{upgreek} has been loaded, this just does
+ \code{\cmd{mathrm}\marg{E}}}
+ }
+ % \Upzeta
+ \gcmd{Upzeta}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand} and only if
+ \sty{upgreek} has been loaded, this just does
+ \code{\cmd{mathrm}\marg{Z}}}
+ }
+ % \Upeta
+ \gcmd{Upeta}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand} and only if
+ \sty{upgreek} has been loaded, this just does
+ \code{\cmd{mathrm}\marg{H}}}
+ }
+ % \Upiota
+ \gcmd{Upiota}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand} and only if
+ \sty{upgreek} has been loaded, this just does
+ \code{\cmd{mathrm}\marg{I}}}
+ }
+ % \Upkappa
+ \gcmd{Upkappa}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand} and only if
+ \sty{upgreek} has been loaded, this just does
+ \code{\cmd{mathrm}\marg{K}}}
+ }
+ % \Upmu
+ \gcmd{Upmu}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand} and only if
+ \sty{upgreek} has been loaded, this just does
+ \code{\cmd{mathrm}\marg{M}}}
+ }
+ % \Upnu
+ \gcmd{Upnu}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand} and only if
+ \sty{upgreek} has been loaded, this just does
+ \code{\cmd{mathrm}\marg{N}}}
+ }
+ % \Upomicron
+ \gcmd{Upomicron}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand} and only if
+ \sty{upgreek} has been loaded, this just does
+ \code{\cmd{mathrm}\marg{O}}}
+ }
+ % \upomicron
+ \gcmd{upomicron}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand} and only if
+ \sty{upgreek} has been loaded, this just does
+ \code{\cmd{mathrm}\marg{o}}}
+ }
+ % \Uprho
+ \gcmd{Uprho}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand} and only if
+ \sty{upgreek} has been loaded, this just does
+ \code{\cmd{mathrm}\marg{P}}}
+ }
+ % \Uptau
+ \gcmd{Uptau}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand} and only if
+ \sty{upgreek} has been loaded, this just does
+ \code{\cmd{mathrm}\marg{T}}}
+ }
+ % \Upchi
+ \gcmd{Upchi}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{defined with \gls{providecommand} and only if
+ \sty{upgreek} has been loaded, this just does
+ \code{\cmd{mathrm}\marg{X}}}
+ }
+ % \glsxtrcontrolrules
+ \gcmd{gls\-xtr\-control\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to control character sort rules}
+ }
+ % \glsxtrspacerules
+ \gcmd{gls\-xtr\-space\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to space character sort rules}
+ }
+ % \glsxtrnonprintablerules
+ \gcmd{gls\-xtr\-non\-printable\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to non-printable character sort rules}
+ }
+ % \glsxtrcombiningdiacriticrules
+ \gcmd{gls\-xtr\-combining\-diacritic\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to all the combining diacritic sort rules}
+ }
+ % \glsxtrcombiningdiacriticIrules
+ \gcmd{gls\-xtr\-combining\-diacritic\-I\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the first set of combining diacritic sort rules}
+ }
+ % \glsxtrcombiningdiacriticIIrules
+ \gcmd{gls\-xtr\-combining\-diacritic\-II\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the second set of combining diacritic sort rules}
+ }
+ % \glsxtrcombiningdiacriticIIIrules
+ \gcmd{gls\-xtr\-combining\-diacritic\-III\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the third set of combining diacritic sort rules}
+ }
+ % \glsxtrcombiningdiacriticIVrules
+ \gcmd{gls\-xtr\-combining\-diacritic\-IV\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the fourth set of combining diacritic sort rules}
+ }
+ % \glsxtrhyphenrules
+ \gcmd{gls\-xtr\-hyphen\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to hyphen character sort rules}
+ }
+ % \glsxtrgeneralpuncrules
+ \gcmd{gls\-xtr\-general\-punc\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to all sets of general punctuation sort rules}
+ }
+ % \glsxtrgeneralpuncIrules
+ \gcmd{gls\-xtr\-general\-punc\-I\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the first set of general punctuation (including
+ currency) sort rules}
+ }
+ % \glsxtrgeneralpuncmarksrules
+ \gcmd{gls\-xtr\-general\-punc\-marks\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \desc{punctuation mark subset of \gls{glsxtrgeneralpuncIrules}}
+ }
+ % \glsxtrgeneralpuncaccentsrules
+ \gcmd{gls\-xtr\-general\-punc\-accents\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \desc{punctuation accent subset of \gls{glsxtrgeneralpuncIrules}}
+ }
+ % \glsxtrgeneralpuncquoterules
+ \gcmd{gls\-xtr\-general\-punc\-quote\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \desc{punctuation quote subset of \gls{glsxtrgeneralpuncIrules}}
+ }
+ % \glsxtrgeneralpuncbracketrules
+ \gcmd{gls\-xtr\-general\-punc\-bracket\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \desc{punctuation bracket subset of \gls{glsxtrgeneralpuncIrules}}
+ }
+ % \glsxtrgeneralpuncsignrules
+ \gcmd{gls\-xtr\-general\-punc\-sign\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \desc{punctuation sign subset of \gls{glsxtrgeneralpuncIrules}}
+ }
+ % \glsxtrgeneralpuncIIrules
+ \gcmd{gls\-xtr\-general\-punc\-II\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the second set of general punctuation (including
+ currency) sort rules}
+ }
+ % \glsxtrcurrencyrules
+ \gcmd{gls\-xtr\-currency\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to currency character sort rules}
+ }
+ % \glsxtrdigitrules
+ \gcmd{gls\-xtr\-digit\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to 0--9 digit character sort rules (includes
+ superscript and subscript digits)}
+ }
+ % \glsxtrBasicDigitrules
+ \gcmd{gls\-xtr\-Basic\-Digit\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the Basic Latin digit character sort rules}
+ }
+ % \glsxtrSubScriptDigitrules
+ \gcmd{gls\-xtr\-Sub\-Script\-Digit\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the 0--9 subscript digit character sort rules}
+ }
+ % \glsxtrSuperScriptDigitrules
+ \gcmd{gls\-xtr\-Super\-Script\-Digit\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the 0--9 superscript digit character sort rules}
+ }
+ % \glsxtrfractionrules
+ \gcmd{gls\-xtr\-fraction\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the number forms fraction character sort rules}
+ }
+ % \glsxtrIgnorableRules
+ \gcmd{gls\-xtr\-Ignorable\-Rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \desc{a shortcut that expands to the control rules, space rules
+ and non-printable rules}
+ }
+ % \glsxtrGeneralInitRules
+ \gcmd{gls\-xtr\-General\-Init\-Rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \desc{a shortcut that expands to the ignorable rules,
+ combining diacritic rules, hyphen rules, general punctuation
+ rules, digit rules, and fraction rules}
+ }
+ % \glsxtrLatinA
+ \gcmd{gls\-xtr\-LatinA}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin A (includes 0x00AA and 0x2090)}
+ }
+ % \glsxtrLatinE
+ \gcmd{gls\-xtr\-LatinE}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin E (includes 0x2091)}
+ }
+ % \glsxtrLatinH
+ \gcmd{gls\-xtr\-LatinH}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin H (includes 0x2095)}
+ }
+ % \glsxtrLatinI
+ \gcmd{gls\-xtr\-LatinI}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin I (includes 0x2071)}
+ }
+ % \glsxtrLatinK
+ \gcmd{gls\-xtr\-LatinK}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin K (includes 0x2096)}
+ }
+ % \glsxtrLatinL
+ \gcmd{gls\-xtr\-LatinL}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin L (includes 0x2097)}
+ }
+ % \glsxtrLatinM
+ \gcmd{gls\-xtr\-LatinM}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin M (includes 0x2098)}
+ }
+ % \glsxtrLatinN
+ \gcmd{gls\-xtr\-LatinN}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin N (includes 0x2099)}
+ }
+ % \glsxtrLatinO
+ \gcmd{gls\-xtr\-LatinO}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin O (includes 0x00BA and 0x2092)}
+ }
+ % \glsxtrLatinP
+ \gcmd{gls\-xtr\-LatinP}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin P (includes 0x209A)}
+ }
+ % \glsxtrLatinS
+ \gcmd{gls\-xtr\-LatinS}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin S (includes 0x209B)}
+ }
+ % \glsxtrLatinT
+ \gcmd{gls\-xtr\-LatinT}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin T (includes 0x209C)}
+ }
+ % \glsxtrLatinX
+ \gcmd{gls\-xtr\-LatinX}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin X (includes 0x2093)}
+ }
+ % \glsxtrLatinSchwa
+ \gcmd{gls\-xtr\-Latin\-Schwa}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin schwa}
+ }
+ % \glsxtrLatinEszettSs
+ \gcmd{gls\-xtr\-Latin\-EszettSs}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to rule for \ss and \char"017F\relax s}
+ }
+ % \glsxtrLatinEszettSz
+ \gcmd{gls\-xtr\-Latin\-EszettSz}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to rule for \ss and \char"017F\relax z}
+ }
+ % \glsxtrLatinEth
+ \gcmd{gls\-xtr\-Latin\-Eth}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin eth}
+ }
+ % \glsxtrLatinThorn
+ \gcmd{gls\-xtr\-Latin\-Thorn}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin thorn}
+ }
+ % \glsxtrLatinAELigature
+ \gcmd{gls\-xtr\-Latin\-AE\-Ligature}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin ae-ligature}
+ }
+ % \glsxtrLatinOELigature
+ \gcmd{gls\-xtr\-Latin\-OE\-Ligature}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin oe-ligature}
+ }
+ % \glsxtrLatinAA
+ \gcmd{gls\-xtr\-Latin\-AA}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin \aa}
+ }
+ % \glsxtrLatinWynn
+ \gcmd{gls\-xtr\-Latin\-Wynn}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin wynn}
+ }
+ % \glsxtrLatinInsularG
+ \gcmd{gls\-xtr\-Latin\-InsularG}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin insular G and g, G}
+ }
+ % \glsxtrLatinOslash
+ \gcmd{gls\-xtr\-Latin\-O\-slash}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin \o}
+ }
+ % \glsxtrLatinLslash
+ \gcmd{gls\-xtr\-Latin\-L\-slash}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of Latin \l}
+ }
+ % \glsxtrGeneralLatinAtoMrules
+ \gcmd{gls\-xtr\-General\-Latin\-A\-to\-M\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \desc{expands to the A--M subset of General Latin I sort rules}
+ }
+ % \glsxtrGeneralLatinNtoZrules
+ \gcmd{gls\-xtr\-General\-Latin\-N\-to\-Z\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \desc{expands to the N--Z subset of General Latin I sort rules}
+ }
+ % \glsxtrGeneralLatinAtoGrules
+ \gcmd{gls\-xtr\-General\-Latin\-A\-to\-G\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \desc{expands to the A--G subset of General Latin I sort rules}
+ }
+ % \glsxtrGeneralLatinHtoMrules
+ \gcmd{gls\-xtr\-General\-Latin\-H\-to\-M\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \desc{expands to the H--M subset of General Latin I sort rules}
+ }
+ % \glsxtrGeneralLatinNtoSrules
+ \gcmd{gls\-xtr\-General\-Latin\-N\-to\-S\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \desc{expands to the N--S subset of General Latin I sort rules}
+ }
+ % \glsxtrGeneralLatinTtoZrules
+ \gcmd{gls\-xtr\-General\-Latin\-T\-to\-Z\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \desc{expands to the T--Z subset of General Latin I sort rules}
+ }
+ % \glsxtrGeneralLatinIrules
+ \gcmd{gls\-xtr\-General\-Latin\-I\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the first set of General Latin sort rules}
+ }
+ % \glsxtrGeneralLatinIIrules
+ \gcmd{gls\-xtr\-General\-Latin\-II\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the second set of General Latin sort rules}
+ }
+ % \glsxtrGeneralLatinIIIrules
+ \gcmd{gls\-xtr\-General\-Latin\-III\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the third set of General Latin sort rules}
+ }
+ % \glsxtrGeneralLatinIVrules
+ \gcmd{gls\-xtr\-General\-Latin\-IV\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the fourth set of General Latin sort rules}
+ }
+ % \glsxtrGeneralLatinVrules
+ \gcmd{gls\-xtr\-General\-Latin\-V\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the fifth set of General Latin sort rules}
+ }
+ % \glsxtrGeneralLatinVIrules
+ \gcmd{gls\-xtr\-General\-Latin\-VI\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the sixth set of General Latin sort rules}
+ }
+ % \glsxtrGeneralLatinVIIrules
+ \gcmd{gls\-xtr\-General\-Latin\-VII\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the seventh set of General Latin sort rules}
+ }
+ % \glsxtrGeneralLatinVIIIrules
+ \gcmd{gls\-xtr\-General\-Latin\-VIII\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the eighth set of General Latin sort rules}
+ }
+ % \glsxtrMathUpGreekIrules
+ \gcmd{gls\-xtr\-Math\-Up\-Greek\-I\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the first set of math upright Greek sort rules}
+ }
+ % \glsxtrMathUpGreekIIrules
+ \gcmd{gls\-xtr\-Math\-Up\-Greek\-II\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the second set of math upright Greek sort rules}
+ }
+ % \glsxtrMathItalicGreekIrules
+ \gcmd{gls\-xtr\-Math\-Italic\-Greek\-I\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the first set of math italic Greek sort rules}
+ }
+ % \glsxtrMathItalicGreekIIrules
+ \gcmd{gls\-xtr\-Math\-Italic\-Greek\-II\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the second set of math italic Greek sort rules}
+ }
+ % \glsxtrMathItalicUpperGreekIrules
+ \gcmd{gls\-xtr\-Math\-Italic\-Upper\-Greek\-I\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the first set of math italic \idx{uppercase} Greek sort rules}
+ }
+ % \glsxtrMathItalicUpperGreekIIrules
+ \gcmd{gls\-xtr\-Math\-Italic\-Upper\-Greek\-II\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the second set of math italic \idx{uppercase} Greek sort rules}
+ }
+ % \glsxtrMathItalicLowerGreekIrules
+ \gcmd{gls\-xtr\-Math\-Italic\-Lower\-Greek\-I\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the first set of math italic \idx{lowercase} Greek sort rules}
+ }
+ % \glsxtrMathItalicLowerGreekIIrules
+ \gcmd{gls\-xtr\-Math\-Italic\-Lower\-Greek\-II\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the second set of math italic \idx{lowercase} Greek sort rules}
+ }
+ % \glsxtrMathGreekIrules
+ \gcmd{gls\-xtr\-Math\-Greek\-I\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the first set of math Greek sort rules}
+ }
+ % \glsxtrMathGreekIIrules
+ \gcmd{gls\-xtr\-Math\-Greek\-II\-rules}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{expands to the second set of math Greek sort rules}
+ }
+ % \glsxtrUpAlpha
+ \gcmd{gls\-xtr\-Up\-Alpha}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright alpha}
+ }
+ % \glsxtrUpBeta
+ \gcmd{gls\-xtr\-Up\-Beta}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright beta}
+ }
+ % \glsxtrUpGamma
+ \gcmd{gls\-xtr\-Up\-Gamma}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright gamma}
+ }
+ % \glsxtrUpDelta
+ \gcmd{gls\-xtr\-Up\-Delta}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright delta}
+ }
+ % \glsxtrUpEpsilon
+ \gcmd{gls\-xtr\-Up\-Epsilon}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright epsilon}
+ }
+ % \glsxtrUpDigamma
+ \gcmd{gls\-xtr\-Up\-Digamma}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright digamma}
+ }
+ % \glsxtrUpZeta
+ \gcmd{gls\-xtr\-Up\-Zeta}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright zeta}
+ }
+ % \glsxtrUpEta
+ \gcmd{gls\-xtr\-Up\-Eta}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright eta}
+ }
+ % \glsxtrUpTheta
+ \gcmd{gls\-xtr\-Up\-Theta}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright theta}
+ }
+ % \glsxtrUpIota
+ \gcmd{gls\-xtr\-Up\-Iota}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright iota}
+ }
+ % \glsxtrUpKappa
+ \gcmd{gls\-xtr\-Up\-Kappa}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright kappa}
+ }
+ % \glsxtrUpLambda
+ \gcmd{gls\-xtr\-Up\-Lambda}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright lambda}
+ }
+ % \glsxtrUpMu
+ \gcmd{gls\-xtr\-Up\-Mu}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright mu}
+ }
+ % \glsxtrUpNu
+ \gcmd{gls\-xtr\-Up\-Nu}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright nu}
+ }
+ % \glsxtrUpXi
+ \gcmd{gls\-xtr\-Up\-Xi}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright xi}
+ }
+ % \glsxtrUpOmicron
+ \gcmd{gls\-xtr\-Up\-Omicron}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright omicron}
+ }
+ % \glsxtrUpPi
+ \gcmd{gls\-xtr\-Up\-Pi}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright pi}
+ }
+ % \glsxtrUpRho
+ \gcmd{gls\-xtr\-Up\-Rho}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright rho}
+ }
+ % \glsxtrUpSigma
+ \gcmd{gls\-xtr\-Up\-Sigma}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright sigma}
+ }
+ % \glsxtrUpTau
+ \gcmd{gls\-xtr\-Up\-Tau}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright tau}
+ }
+ % \glsxtrUpUpsilon
+ \gcmd{gls\-xtr\-Up\-Upsilon}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright upsilon}
+ }
+ % \glsxtrUpPhi
+ \gcmd{gls\-xtr\-Up\-Phi}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright phi}
+ }
+ % \glsxtrUpChi
+ \gcmd{gls\-xtr\-Up\-Chi}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright chi}
+ }
+ % \glsxtrUpPsi
+ \gcmd{gls\-xtr\-Up\-Psi}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright psi}
+ }
+ % \glsxtrUpOmega
+ \gcmd{gls\-xtr\-Up\-Omega}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math Greek upright omega}
+ }
+ % \glsxtrMathItalicAlpha
+ \gcmd{gls\-xtr\-Math\-Italic\-Alpha}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek alpha}
+ }
+ % \glsxtrMathItalicBeta
+ \gcmd{gls\-xtr\-Math\-Italic\-Beta}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek beta}
+ }
+ % \glsxtrMathItalicGamma
+ \gcmd{gls\-xtr\-Math\-Italic\-Gamma}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek gamma}
+ }
+ % \glsxtrMathItalicDelta
+ \gcmd{gls\-xtr\-Math\-Italic\-Delta}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek delta}
+ }
+ % \glsxtrMathItalicEpsilon
+ \gcmd{gls\-xtr\-Math\-Italic\-Epsilon}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek epsilon}
+ }
+ % \glsxtrMathItalicDigamma
+ \gcmd{gls\-xtr\-Math\-Italic\-Digamma}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek digamma}
+ }
+ % \glsxtrMathItalicZeta
+ \gcmd{gls\-xtr\-Math\-Italic\-Zeta}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek zeta}
+ }
+ % \glsxtrMathItalicEta
+ \gcmd{gls\-xtr\-Math\-Italic\-Eta}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek eta}
+ }
+ % \glsxtrMathItalicTheta
+ \gcmd{gls\-xtr\-Math\-Italic\-Theta}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek theta}
+ }
+ % \glsxtrMathItalicIota
+ \gcmd{gls\-xtr\-Math\-Italic\-Iota}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek iota}
+ }
+ % \glsxtrMathItalicKappa
+ \gcmd{gls\-xtr\-Math\-Italic\-Kappa}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek kappa}
+ }
+ % \glsxtrMathItalicLambda
+ \gcmd{gls\-xtr\-Math\-Italic\-Lambda}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek lambda}
+ }
+ % \glsxtrMathItalicMu
+ \gcmd{gls\-xtr\-Math\-Italic\-Mu}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek mu}
+ }
+ % \glsxtrMathItalicNu
+ \gcmd{gls\-xtr\-Math\-Italic\-Nu}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek nu}
+ }
+ % \glsxtrMathItalicXi
+ \gcmd{gls\-xtr\-Math\-Italic\-Xi}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek xi}
+ }
+ % \glsxtrMathItalicOmicron
+ \gcmd{gls\-xtr\-Math\-Italic\-Omicron}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek omicron}
+ }
+ % \glsxtrMathItalicPi
+ \gcmd{gls\-xtr\-Math\-Italic\-Pi}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek pi}
+ }
+ % \glsxtrMathItalicRho
+ \gcmd{gls\-xtr\-Math\-Italic\-Rho}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek rho}
+ }
+ % \glsxtrMathItalicSigma
+ \gcmd{gls\-xtr\-Math\-Italic\-Sigma}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek sigma}
+ }
+ % \glsxtrMathItalicTau
+ \gcmd{gls\-xtr\-Math\-Italic\-Tau}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek tau}
+ }
+ % \glsxtrMathItalicUpsilon
+ \gcmd{gls\-xtr\-Math\-Italic\-Upsilon}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek upsilon}
+ }
+ % \glsxtrMathItalicPhi
+ \gcmd{gls\-xtr\-Math\-Italic\-Phi}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek phi}
+ }
+ % \glsxtrMathItalicChi
+ \gcmd{gls\-xtr\-Math\-Italic\-Chi}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek chi}
+ }
+ % \glsxtrMathItalicPsi
+ \gcmd{gls\-xtr\-Math\-Italic\-Psi}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek psi}
+ }
+ % \glsxtrMathItalicOmega
+ \gcmd{gls\-xtr\-Math\-Italic\-Omega}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the variations of math italic Greek omega}
+ }
+ % \glsxtrMathItalicPartial
+ \gcmd{gls\-xtr\-Math\-Italic\-Partial}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the Unicode codepoint for math italic partial differential}
+ }
+ % \glsxtrMathItalicNabla
+ \gcmd{gls\-xtr\-Math\-Italic\-Nabla}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.27+}
+ \desc{(sort rule) expands to the Unicode codepoint for nabla}
+ }
+ % \glsxtrSetWidest
+ \gcmd{gls\-xtr\-Set\-Widest}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.37+}
+ \syntax{\margm{type}\margm{level}}
+ \desc{written to the \ext{glstex} by the
+ \resourceopt{set-widest} option}
+ }
+ % \glsxtrSetWidestFalback
+ \gcmd{gls\-xtr\-Set\-Widest\-Fallback}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.37+}
+ \syntax{\margm{type}\margm{level}}
+ \desc{written to the \ext{glstex} by the
+ \resourceopt{set-widest} option if \app{bib2gls} can't
+ determine the widest name}
+ }
+ % \GlsXtrIfHasNonZeroChildCount
+ \gcmds{Gls\-Xtr\-If\-Has\-Non\-Zero\-Child\-Count}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.47+}
+ \syntax{\margm{entry-label}\margm{true}\margm{false}}
+ \desc{tests if the value in the \glosfield{childcount} field is
+ non-zero (using \gls{GlsXtrIfFieldNonZero}). This requires the
+ \resourceopt{save-child-count} resource option}
+ }
+ % \glsxtrdisplaysupploc
+ \gcmds{gls\-xtr\-display\-supp\-loc}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.36+}
+ \syntax{\margm{prefix}\margm{counter}\margm{format}\margm{src}\margm{location}}
+ \desc{like \gls{glsnoidxdisplayloc} but used for supplementary
+ locations}
+ }
+ % \glsxtrmultisupplocation
+ \gcmds{gls\-xtr\-multi\-supp\-location}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.36+}
+ \syntax{\margm{src}\margm{location}\margm{format}}
+ \desc{used by \gls{glsxtrdisplaysupploc} to format the
+ location}
+ }
+ % \glsxtrdisplaylocnameref
+ \gcmd{gls\-xtr\-display\-loc\-name\-ref}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.37+}
+ \syntax{\margm{prefix}\margm{counter}\margm{format}\margm{location}\margm{title}\margm{href}\margm{hcounter}\margm{file}}
+ \desc{used to display \records\ created with
+ \opteqvalref{record}{nameref}}
+ }
+ % \glsxtrtitlednamereflink
+ \gcmd{gls\-xtr\-titled\-name\-ref\-link}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \syntax{\margm{format}\margm{location}\margm{title}\margm{file}}
+ \desc{used by \gls{glsxtrdisplaylocnameref} to display locations
+ that have a title and are not associated with the \ctr{page} counter
+ and don't have an associated \gls{glsxtrcounterlocfmt} command.
+ The anchor is obtained from \gls{glsxtrrecentanchor}}
+ }
+ % \glsxtrlocationanchor
+ \gcmd{gls\-xtr\-location\-anchor}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \desc{defined by \gls{glsxtrdisplaylocnameref} to expand to the
+ anchor constructed from \meta{counter} and \meta{hcounter},
+ which corresponds to the record counter}
+ }
+ % \glsxtrrecentanchor
+ \gcmd{gls\-xtr\-recent\-anchor}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \desc{defined by \gls{glsxtrdisplaylocnameref} to expand to
+ the \meta{href} argument. This corresponds to the value of
+ \gls{@currentHref} when the record was created}
+ }
+ % \glsxtractualanchor
+ \gcmd{gls\-xtr\-actual\-anchor}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \desc{expands to the anchor required by \gls{glsxtrdisplaylocnameref}}
+ }
+ % \glsxtrsetactualanchor
+ \gcmd{gls\-xtr\-set\-actual\-anchor}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \syntax{\margm{counter}}
+ \desc{hook used by \gls{glsxtrdisplaylocnameref} to override
+ the default definition of \gls{glsxtractualanchor}}
+ }
+ % \glsxtr<counter>locfmt
+ \gcmdmeta{gls\-xtr}{counter}{loc\-fmt}
+ {
+ \note{user defined}
+ \syntax{\margm{location}\margm{title}}
+ \desc{used by \gls{glsxtrdisplaylocnameref} for format a
+ \location\ where the counter matches \meta{counter}}
+ }
+ % \glsxtrequationlocfmt
+ \gcmd{gls\-xtr\-equation\-loc\-fmt}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.42+}
+ \syntax{\margm{location}\margm{title}}
+ \desc{used by \gls{glsxtrdisplaylocnameref} to format a
+ \location\ where the counter is \ctr{equation}}
+ }
+ % \glsxtrwrglossarylocfmt
+ \gcmd{gls\-xtr\-wr\-glossary\-loc\-fmt}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.49+}
+ \syntax{\margm{location}\margm{title}}
+ \desc{used by \gls{glsxtrdisplaylocnameref} to format a
+ \location\ where the counter is \ctr{wrglossary}}
+ }
+ % \glsxtrnamereflink
+ \gcmd{gls\-xtr\-name\-ref\-link}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.37+}
+ \syntax{\margm{format}\margm{title}\margm{target}\margm{file}}
+ \desc{used by \gls{glsxtrdisplaylocnameref} to create a
+ \location\ hyperlink}
+ }
+ % \glsxtrfmtinternalnameref
+ \gcmd{gls\-xtr\-fmt\-internal\-name\-ref}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.37+}
+ \syntax{\margm{target}\margm{format}\margm{file}}
+ \desc{used by \gls{glsxtrnamereflink} to create an internal
+ \location\ hyperlink}
+ }
+ % \glsxtrfmtexternalnameref
+ \gcmd{gls\-xtr\-fmt\-external\-name\-ref}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.37+}
+ \syntax{\margm{target}\margm{format}\margm{title}\margm{file}}
+ \desc{used by \gls{glsxtrnamereflink} to create an external
+ \location\ hyperlink}
+ }
+ % \glsxtrnameloclink
+ \gcmd{gls\-xtr\-name\-loc\-link}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.37+}
+ \syntax{\margm{prefix}\margm{counter}\margm{format}\margm{location}\margm{text}\margm{file}}
+ \desc{create an external \location\ hyperlink using the prefix and counter}
+ }
+ % RESOURCE OPTIONS
+ \gidx{resourceopt}{\name{resource options}%
+ \field{text}{resource option}%
+ \desc{these options may be used in the optional argument of
+ \gls{GlsXtrLoadResources} and \gls{glsxtrresourcefile}}
+ }
+ % resource option loc-prefix
+ \gresourceopt{loc\dhyphen prefix}%
+ {%
+ \syntax{\meta{value}}
+ \initval{false}
+ \desc{inserts a prefix in front of \idxpl{locationlist}}
+ }
+ % resource option loc-suffix
+ \gresourceopt{loc\dhyphen suffix}%
+ {%
+ \syntax{\meta{value}}
+ \initval{false}
+ \desc{inserts a suffix at the end of \idxpl{locationlist}}
+ }
+ % resource option group-level
+ \gresourceopt{group\dhyphen level}
+ {
+ \syntax{\meta{value}}
+ \initval{0}
+ \desc{if the \switch{group} switch is used, this indicates which
+ \idxpl{hierarchicallevel} should have the \gloskey{group} field
+ set. The default is 0, which means the \idx{group} is only set for
+ top-level entries. This option has no effect if the default
+ \switch{no-group} is in effect}
+ }
+ % resource option label-prefix
+ \gresourceopt{label\dhyphen prefix}%
+ {%
+ \syntax{\meta{value}}
+ \desc{inserts a prefix in front of primary entry labels}
+ }
+ % resource option dual-prefix
+ \gresourceopt{dual\dhyphen prefix}%
+ {%
+ \syntax{\meta{value}}
+ \initval{dual.}
+ \desc{inserts a prefix in front of dual entry labels}
+ }
+ % resource option src
+ \gresourceopt{src}%
+ {%
+ \syntax{\meta{list}}
+ \initvalcs{jobname}
+ \desc{a comma-separated list of \ext+{bib} files that contain the
+ entry data (the file extension may be omitted)}
+ }
+ % resource option selection
+ \gresourceopt{selection}%
+ {%
+ \syntax{\meta{value}}
+ \initval{recorded and deps and see}
+ \desc{the selection criteria}
+ }
+ % resource option sort-field
+ \gresourceopt{sort\dhyphen field}%
+ {%
+ \syntax{\meta{value}}
+ \initval{sort}
+ \desc{the field to use for sorting}
+ }
+ % resource option sort-replace
+ \gresourceopt{sort\dhyphen replace}%
+ {%
+ \syntax{\meta{regex list}}
+ \desc{the value is a command separated list of
+ \margm{regex}\margm{replacement} pairs to perform on the sort value}
+ }
+ % resource option save-locations
+ \gresourceopt{save\dhyphen locations}%
+ {%
+ \syntax{\meta{value}}
+ \initval{true}
+ \defval{true}
+ \desc{determines whether or not to save the \idx{locationlist}.
+This was originally a boolean option but as from \app{bib2gls} v3.0 it
+now takes additional values}
+ }
+ % resource option loc-counters
+ \gresourceopt{loc\dhyphen counters}%
+ {%
+ \syntax{\meta{counter list}}
+ \desc{indicates that the \idx{locationlist} should be divided up
+ into counter groups corresponding to the listed counters}
+ }
+ % resource option sort
+ \gresourceopt{sort}%
+ {%
+ \syntax{\meta{value}}
+ \initval{doc}
+ \desc{identifies the sort method. The default is to use the
+ document's language or (if not set) the default locale}
+ }
+ % resource option save-index-counter
+ \gresourceopt{save\dhyphen index\dhyphen counter}%
+ {%
+ \syntax{\meta{value}}
+ \initval{false}
+ \desc{determines whether or not to create the
+ \glosfield{indexcounter} \idx{internalfield} with the value set to the first
+ \ctr{wrglossary} \location. This option is designed to be used
+ with the \opt{indexcounter} package option}
+ }
+ % resource option save-child-count
+ \gresourceopt{save\dhyphen child\dhyphen count}%
+ {%
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \desc{if true, each entry will have the total number of child
+ entries stored in the \glosfield{childcount} field and the list of
+ children will be stored in the \glosfield{childlist} field}
+ }
+ % resource option post-description-dot
+ \gresourceopt{post\dhyphen description\dhyphen dot}%
+ {%
+ \syntax{\meta{value}}
+ \initval{none}
+ \desc{appends a \idx{fullstop} to the \gloskey{description} field.
+ Allowed values: \optfmt{none} (no change), \optfmt{all} (append for all selected entries),
+ \optfmt{check} (only appends according to certain criteria). Note this inserts the
+ punctuation into the field value not in the \idx{postdeschook}.
+ See the \app{bib2gls} manual for further details.}
+ }
+ % resource option alias-loc
+ \gresourceopt{alias\dhyphen loc}
+ {
+ \syntax{\meta{value}}
+ \initval{transfer}
+ \desc{if an entry has an \gloskey{alias} field, this setting indicates
+ whether to keep the \idx{locationlist}, transfer it, or omit it}
+ }
+ % resource option see
+ \gresourceopt{see}
+ {
+ \syntax{\meta{value}}
+ \initval{transfer}
+ \desc{if an entry has an \gloskey{see} field, this setting indicates
+ whether to show the cross-reference at the start or end of the \idx{locationlist}
+ or omit it}
+ }
+ % resource option seealso
+ \gresourceopt{seealso}
+ {
+ \syntax{\meta{value}}
+ \initval{transfer}
+ \desc{if an entry has an \gloskey{seealso} field, this setting indicates
+ whether to show the cross-reference at the start or end of the \idx{locationlist}
+ or omit it}
+ }
+ % resource option alias
+ \gresourceopt{alias}
+ {
+ \syntax{\meta{value}}
+ \initval{transfer}
+ \desc{if an entry has an \gloskey{alias} field, this setting indicates
+ whether to show the cross-reference at the start or end of the \idx{locationlist}
+ or omit it}
+ }
+ % resource option supplemental-locations
+ \gresourceopt{supplemental\dhyphen locations}
+ {
+ \syntax{\meta{basename list}}
+ \desc{add \locations\ from the supplemental documents to the
+ corresponding entry's \idx{locationlist}}
+ }
+ % resource option prune-xr
+ \gresourceopt{prune\dhyphen xr}
+ {
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \desc{shortcut option that enables pruning for both the
+ \gloskey{see} and \gloskey{seealso} fields}
+ }
+ % resource option sort-label-list
+ \gresourceopt{sort\dhyphen label\dhyphen list}
+ {
+ \syntax{\meta{field-list}:\meta{sort}:\meta{csname}}
+ \desc{instructs \app{bib2gls} to sort the given field values
+ (which must contain comma-separated lists of labels) according
+ to the given sort method. The final \code{:\meta{csname}} is
+ optional and indicates that the sort value should be obtained by
+ encapsulating the item with the command with the given control
+ sequence name (which needs to be recognised by \app{bib2gls})}
+ }
+ % resource option compound-adjust-name
+ \gresourceopt{compound\dhyphen adjust\dhyphen name}
+ {
+ \syntax{\meta{value}}
+ \desc{adjusts the \gloskey{name} of main entries in compound sets}
+ }
+ % resource option description-case-change
+ \gresourceopt{description\dhyphen case\dhyphen change}
+ {
+ \syntax{\meta{value}}
+ \desc{applies a \idx{casechange} to the \gloskey{description} field}
+ }
+ % resource option name-case-change
+ \gresourceopt{name\dhyphen case\dhyphen change}
+ {
+ \syntax{\meta{value}}
+ \desc{applies a \idx{casechange} to the \gloskey{name} field}
+ }
+ % resource option entry-type-aliases
+ \gresourceopt{entry\dhyphen type\dhyphen aliases}
+ {
+ \syntax{\meta{key=val list}}
+ \desc{the value is a comma-separated list of
+ \code{\meta{org type}\dequals\meta{new type}} elements, where
+ \meta{org type} is the original entry type given in the
+ \ext{bib} file (without the leading \code{@}) and \meta{new type}
+ is the entry type it should be treated as}
+ }
+ % resource option combine-dual-locations
+ \gresourceopt{combine\dhyphen dual\dhyphen locations}
+ {
+ \syntax{\meta{value}}
+ \desc{indicates whether or not to combine the
+ \idxpl{locationlist} for the primary and dual entries, and
+ indicates which entry (either or both) should have the \idx{locationlist}}
+ }
+ % resource option type
+ \gresourceopt{type}
+ {
+ \syntax{\meta{glossary-type}}
+ \desc{indicates that primary entries should be
+ assigned to the given \idx{glossary}}
+ }
+ % resource option category
+ \gresourceopt{category}
+ {
+ \syntax{\meta{category-label}}
+ \desc{indicates that primary entries should be
+ assigned to the given category}
+ }
+ % resource option group
+ \gresourceopt{group}
+ {
+ \syntax{\meta{group-label}}
+ \desc{indicates that primary entries should have the
+ \gloskey{group} field set to the given value}
+ }
+ % resource option trigger-type
+ \gresourceopt{trigger\dhyphen type}
+ {
+ \syntax{\meta{glossary-type}}
+ \desc{indicates that entries with trigger records should be
+ assigned to the given \idx{glossary}}
+ }
+ % resource option dual-type
+ \gresourceopt{dual\dhyphen type}
+ {
+ \syntax{\meta{glossary-type}}
+ \desc{indicates that dual entries should be
+ assigned to the given \idx{glossary}}
+ }
+ % resource option dual-field
+ \gresourceopt{dual\dhyphen field}
+ {
+ \syntax{\meta{field-name}}
+ \initval{false}
+ \defval{dual}
+ \desc{indicates that dual entry labels should be stored in the
+ given field}
+ }
+ % resource option dual-backlink
+ \gresourceopt{dual\dhyphen backlink}
+ {
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \desc{switches on all the dual backlink settings}
+ }
+ % resource option flatten
+ \gresourceopt{flatten}
+ {
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \desc{if true, sorting will ignore hierarchy and the
+ \gloskey{parent} key won't be used in the \ext{glstex} file, but the
+ parent entry will still be considered a dependency (unlike
+ \resourceoptvalm{ignore-fields}{parent})}
+ }
+ % resource option ignore-fields
+ \gresourceopt{ignore\dhyphen fields}
+ {
+ \syntax{\margm{field list}}
+ \desc{instructs \app{bib2gls} to ignore the listed fields}
+ }
+ % resource option secondary
+ \gresourceopt{secondary}
+ {
+ \syntax{\meta{sort}:\meta{field}:\meta{type}}
+ \desc{re-sorts the entries according to the given sort
+ method, using the value in the given \meta{field} as the sort
+ value, and copies the entry to the glossary identified by
+ \meta{type}. The \code{:\meta{field}} may be omitted, in which case
+ the \gloskey{sort} field is assumed}
+ }
+ % resource option symbol-sort-fallback
+ \gresourceopt{symbol\dhyphen sort\dhyphen fallback}
+ {
+ \syntax{\margm{field}}
+ \desc{if the \gloskey{sort} key is being used to obtain the sort
+ value but the \gloskey{sort} key hasn't been set for any symbol
+ entries (for example, \atentry{symbol} or \atentry{number}) then the
+ sort value will be obtained from the given \meta{field} instead. If
+ the \gloskey{sort} key has been set or if a different field is being
+ used for sorting, then this option has no effect}
+ }
+ % resource option field-aliases
+ \gresourceopt{field\dhyphen aliases}
+ {
+ \syntax{\margm{src-field=target-field list}}
+ \desc{makes \meta{src-field} an alias of \meta{target-field} for
+ each pair in the list}
+ }
+ % resource option replicate-fields
+ \gresourceopt{replicate\dhyphen fields}
+ {
+ \syntax{\margm{key=value list}}
+ \desc{where each element in the \meta{key=value list} is in the
+ form \code{\meta{src-field}\dequals\meta{dest-field list}},
+ this copies the value of the field identified by \meta{src-field} to
+ each field in the comma-separated \meta{dest-field list}}
+ }
+ % resource option interpret-fields
+ \gresourceopt{interpret\dhyphen fields}
+ {
+ \syntax{\margm{field list}}
+ \desc{replaces each field in the list with its interpreted value}
+ }
+ % resource option set-widest
+ \gresourceopt{set\dhyphen widest}
+ {
+ \syntax{\meta{boolean}}
+ \initval{false}
+ \defval{true}
+ \desc{instructs \app{bib2gls} to determine the widest entry name
+ for use with styles like \glostyle{alttree}. Only suitable for
+ textual names}
+ }
+ % resource option sort-rule
+ \gresourceopt{sort\dhyphen rule}
+ {
+ \syntax{\margm{value}}
+ \desc{the comparator rule to use with \resourceoptval{sort}{custom}}
+ }
+ % COMMANDS: LANGUAGE-SENSITIVE
+ % \glossaryname
+ \gcmd{glossary\-name}%
+ {%
+ \initval{Glossary}%
+ \note{language-sensitive}
+ \desc{expands to the default \idx{glossary} title (provided by
+ \sty{glossaries} if not already defined)}
+ }%
+ % \indexname
+ \gcmd{index\-name}%
+ {%
+ \initval{Index}%
+ \note{language-sensitive}
+ \desc{expands to the index title}
+ }%
+ % \acronymname
+ \gcmd{acronym\-name}%
+ {%
+ \providedby{\sty{glossaries}}
+ \initval{Acronyms}%
+ \note{language-sensitive}
+ \desc{expands to the title of the \code{acronym} \idx{glossary}}
+ }%
+ % \abbreviationsname
+ \gcmd{abbre\-vi\-a\-tions\-name}%
+ {%
+ \initval{Abbreviations}%
+ \providedby{\sty{glossaries-extra}}
+ \note{language-sensitive}
+ \desc{expands to the title of the \code{abbreviations} \idx{glossary}.
+ The default is \qt{Abbreviations} or \gls{acronymname} if \sty{babel}
+ has been detected}
+ }%
+ % \glsnumbersgroupname
+ \gcmd{gls\-numbers\-group\-name}%
+ {%
+ \providedby{\sty{glossaries}}
+ \initval{Numbers}%
+ \note{language-sensitive}
+ \desc{expands to the title of the \code{numbers} \idx{group} and
+ (if the \opt{numbers} package option is used) the
+ \code{numbers} \idx{glossary}}
+ }%
+ % \glssymbolsgroupname
+ \gcmd{gls\-symbols\-group\-name}%
+ {%
+ \providedby{\sty{glossaries}}
+ \initval{Symbols}%
+ \note{language-sensitive}
+ \desc{expands to the title of the \code{symbols} \idx{group} and
+ (if the \opt{symbols} package option is used) the
+ \code{symbols} \idx{glossary}}
+ }%
+ % \seename
+ \gcmd{see\-name}%
+ {%
+ \initval{see}%
+ \note{language-sensitive}
+ \desc{used as a cross-reference tag (provided by
+ \sty{glossaries} if not already defined)}
+ }%
+ % \seealsoname
+ \gcmd{see\-also\-name}%
+ {%
+ \providedby{\sty{glossaries-extra} v1.16+}
+ \initval{see also}%
+ \note{language-sensitive}
+ \desc{used as a cross-reference tag. The default value is
+ \gls{alsoname}, if that command has been defined, or \qt{see also}}
+ }%
+ % \alsoname
+ \gcmd{also\-name}%
+ {%
+ \initval{see also}%
+ \note{language-sensitive}
+ \desc{used as a cross-reference tag (provided by language
+ packages, such as \sty{babel})}
+ }%
+ % \entryname
+ \gcmd{entry\-name}%
+ {%
+ \providedby{\sty{glossaries}}
+ \initval{Notation}%
+ \note{language-sensitive}
+ \desc{expands to the title of the name column for headed
+ \env{tabular}-like styles}
+ }%
+ % \descriptionname
+ \gcmd{description\-name}%
+ {%
+ \providedby{\sty{glossaries}}
+ \initval{Description}%
+ \note{language-sensitive}
+ \desc{expands to the title of the description column for headed
+ \env{tabular}-like styles}
+ }%
+ % \symbolname
+ \gcmd{symbol\-name}%
+ {%
+ \providedby{\sty{glossaries}}
+ \initval{Symbol}%
+ \note{language-sensitive}
+ \desc{expands to the title of the symbol column for headed
+ \env{tabular}-like styles}
+ }%
+ % \pagelistname
+ \gcmd{page\-list\-name}%
+ {%
+ \providedby{\sty{glossaries}}
+ \initval{Page List}%
+ \note{language-sensitive}
+ \desc{expands to the title of the \idx{locationlist} column for headed
+ \env{tabular}-like styles}
+ }%
+ % COMMANDS: PLURAL SUFFIXES
+ % \glspluralsuffix
+ \gcmd{gls\-plural\-suffix}{
+ \desc{expands to the letter \qt{s} and is used to form default
+ plurals. This command isn't language-sensitive as there's
+ guarantee when it will be expanded. (It may be expanded when
+ the entry is defined or it may be expanded when the entry is
+ used). If you need to suppress this suffix for abbreviations,
+ use the \catattr{noshortplural} attribute. If you need an
+ apostrophe before the \qt{s} for single-letter abbreviations to
+ avoid ambiguity, use the \catattr{aposplural} attribute}
+ }
+ % \acrpluralsuffix
+ \gcmd{acr\-plural\-suffix}{
+ \banned
+ \desc{used for the plural suffixes for the base package's
+ acronym mechanism. Not used with \sty{glossaries-extra}'s abbreviations,
+ which use \gls{glsxtrabbrvpluralsuffix},
+ \gls{abbrvpluralsuffix} and commands provided for use with
+ particular \idxpl{abbrvstyle}. This command should not be used
+ with \sty{glossaries-extra}}
+ }
+ % \glsxtrabbrvpluralsuffix
+ \gcmd{gls\-xtr\-abbrv\-plural\-suffix}{
+ \providedby{\sty{glossaries-extra} v1.12+}
+ \initvalcs{glspluralsuffix}
+ \desc{the default plural suffix used for abbreviations}
+ }
+ % \abbrvpluralsuffix
+ \gcmd{abbrv\-plural\-suffix}{
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \initvalcs{glsxtrabbrvpluralsuffix}
+ \desc{style-sensitive abbreviation suffix. This is the command
+ that's actually used in the value of the \gloskey{shortplural} key
+ when an entry is defined with \gls{newabbreviation} (unless
+ suppressed with the \catattr{noshortplural} attribute). This command is
+ redefined by the \idxpl{abbrvstyle} to
+ \gls{glsxtrabbrvpluralsuffix} or the style's custom suffix command
+ (such as \gls{glsxtrscsuffix})}
+ }
+ % \glsxtrscsuffix
+ \gcmd{gls\-xtr\-sc\-suffix}{
+ %\providedby{\sty{glossaries-extra} 0.5+}
+ \desc{the plural suffix used by the \idx{smallcaps} (\qt{sc})
+ \idxpl{abbrvstyle}. This switches off the \idx{smallcaps} font to
+ prevent the suffix from also appearing in \idx{smallcaps}}
+ }
+ % \glsxtrsmsuffix
+ \gcmd{gls\-xtr\-sm\-suffix}{
+ %\providedby{\sty{glossaries-extra} 0.5+}
+ \initvalcs{glsxtrabbrvpluralsuffix}
+ \desc{the plural suffix used by the smaller (\qt{sm}) \idxpl{abbrvstyle}
+ (such as \abbrstyle{short-sm-long})}
+ }
+ % \glsxtremsuffix
+ \gcmd{gls\-xtr\-em\-suffix}{
+ %\providedby{\sty{glossaries-extra} 0.5+}
+ \initvalcs{glsxtrabbrvpluralsuffix}
+ \desc{the plural suffix used by the emphasized (\qt{em}) \idxpl{abbrvstyle}}
+ }
+ % \glsxtrusersuffix
+ \gcmd{gls\-xtr\-user\-suffix}{
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \initvalcs{glsxtrabbrvpluralsuffix}
+ \desc{the plural suffix used by styles like \abbrstyle{short-long-user}}
+ }
+ % \glsxtrscusersuffix
+ \gcmd{gls\-xtr\-sc\-user\-suffix}{
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{the plural suffix used by styles like
+ \abbrstyle{long-postshort-sc-user}}
+ }
+ % \glsxtrhyphensuffix
+ \gcmd{gls\-xtr\-hyphen\-suffix}{
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \initvalcs{glsxtrabbrvpluralsuffix}
+ \desc{the plural suffix used by the \qt{hyphen} \idxpl{abbrvstyle}
+ (such as \abbrstyle{short-hyphen-long-hyphen})}
+ }
+ % \glsxtronlysuffix
+ \gcmd{gls\-xtr\-only\-suffix}{
+ \providedby{\sty{glossaries-extra} v1.17+}
+ \initvalcs{glsxtrabbrvpluralsuffix}
+ \desc{the plural suffix used by the \qt{only} \idxpl{abbrvstyle}
+ (such as \abbrstyle{long-only-short-only})}
+ }
+ % \glsxtrsconlysuffix
+ \gcmd{gls\-xtr\-sc\-only\-suffix}{
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \initvalcs{glsxtrscsuffix}
+ \desc{the plural suffix used by the \qt{sc-only} \idxpl{abbrvstyle}
+ (such as \abbrstyle{long-only-short-sc-only})}
+ }
+ % COMMANDS: POST-LINK HOOKS
+ % \glspostlinkhook
+ \gcmd{gls\-post\-link\-hook}{%
+ \providedby{\sty{glossaries} v4.16+}
+ \desc{a \idx{postlinkhook} used after all the \idx{glslike} and
+ \idx{glstextlike} commands. This is redefined by
+ \sty{glossaries-extra} to use \gls{glsxtrpostlinkhook}}
+ }
+ % \glsxtrpostlinkhook
+ \gcmd{gls\-xtr\-post\-link\-hook}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}%
+ \desc{a \idx{postlinkhook} that
+ checks if a following \idx{fullstop} needs to be discarded, in which case
+ it does \gls{glsxtrpostlinkendsentence}, otherwise it does
+ \gls{glsxtrpostlink}}
+ }
+ % \glsxtrpostlinkendsentence
+ \gcmd{gls\-xtr\-post\-link\-end\-sentence}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}%
+ \desc{a \idx{postlinkhook} that's used if a \idx{fullstop} is
+ discarded in order to adjust the space factor (to denote the end
+ of a sentence). If the \idx{catpostlinkhook} exists, and will be applied and the
+ \idx{fullstop} will be restored}
+ }
+ % \glsxtrpostlink
+ \gcmd{gls\-xtr\-post\-link}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}%
+ \desc{a \idx{postlinkhook} that does \gls{glsxtrpostlinkcat} if
+ that command has been defined, where the category label is
+ obtained from the entry that has just been referenced with a
+ \idx{glslike} or \idx{glstextlike} command (using \gls{glslabel}).
+ Does nothing if \gls{glsxtrpostlinkcat} isn't defined}
+ }
+ % \glsxtrpostlink<category>
+ \gcmd{glsxtrpostlinkcat}{%
+ \name{{}\csfmt{gls\-xtr\-post\-link\meta{category}}}
+ %\providedby{\sty{glossaries-extra} v1.0+}%
+ \desc{the \idx{postlinkhook} associated with the category
+ identified by the label \meta{category}}
+ }
+ % \glsdefpostlink
+ \gcmd{gls\-def\-post\-link}{%
+ \syntax{\margm{category}\margm{definition}}
+ \providedby{\sty{glossaries-extra} v1.31+}%
+ \desc{defines \idx{postlinkhook} associated with the category
+ identified by the label \meta{category}. This simply (re)defines
+ \gls{glsxtrpostlinkcat} for the given \meta{category} to
+ \meta{definition}}
+ }
+ % \glspretopostlink
+ \gcmd{gls\-pre\-to\-post\-link}{%
+ \syntax{\margm{category}\margm{code}}
+ \providedby{\sty{glossaries-extra} v1.49+}%
+ \desc{prepends \meta{code} to \idx{postlinkhook} associated with the category
+ identified by the label \meta{category} (or simply defines it,
+ if it doesn't already exist)}
+ }
+ % \glsapptopostlink
+ \gcmd{gls\-app\-to\-post\-link}{%
+ \syntax{\margm{category}\margm{code}}
+ \providedby{\sty{glossaries-extra} v1.49+}%
+ \desc{appends \meta{code} to \idx{postlinkhook} associated with the category
+ identified by the label \meta{category} (or simply defines it,
+ if it doesn't already exist)}
+ }
+ % \glsxtrpostlinkAddDescOnFirstUse
+ \gcmd{gls\-xtr\-post\-link\-Add\-Desc\-On\-First\-Use}{%
+ %\providedby{\sty{glossaries-extra} v0.3+}%
+ \desc{may be used within a \idx{postlinkhook} to display the
+ description in parentheses on \idx{firstuse}}
+ }
+ % \glsxtrpostlinkAddSymbolOnFirstUse
+ \gcmd{gls\-xtr\-post\-link\-Add\-Symbol\-On\-First\-Use}{%
+ %\providedby{\sty{glossaries-extra} v0.3+}%
+ \desc{may be used within a \idx{postlinkhook} to display the
+ symbol in parentheses on \idx{firstuse}}
+ }
+ % \glsxtrpostlinkAddSymbolDescOnFirstUse
+ \gcmd{gls\-xtr\-post\-link\-Add\-Symbol\-Desc\-On\-First\-Use}{%
+ \providedby{\sty{glossaries-extra} v1.31+}%
+ \desc{may be used within a \idx{postlinkhook} to display the
+ symbol and description in parentheses on \idx{firstuse}}
+ }
+ % \glsxtrpostlinkSymbolDescSep
+ \gcmd{gls\-xtr\-post\-link\-Symbol\-Desc\-Sep}{%
+ \providedby{\sty{glossaries-extra} v1.49+}%
+ \desc{used by \gls{glsxtrpostlinkAddSymbolDescOnFirstUse} to
+ separate the symbol and description, if both are set}
+ }
+ % \glsxtrdiscardperiod
+ \gcmd{gls\-xtr\-discard\-period}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{entry-label}\margm{discarded}\margm{no discard}\meta{token}}
+ \providedby{\sty{glossaries-extra}}%
+ \desc{if \meta{token} is a \idx{fullstop} and the entry's
+ \idxpl{categoryattribute} indicate that a \idx{fullstop} should be discarded
+ (such as \catattr{discardperiod}),
+ then \meta{discarded} is performed, otherwise
+ \meta{no discard} is done and the \meta{token} is processed. The actual test to
+ determine if \meta{token} is a \idx{fullstop} is performed by
+ \gls{glsxtrifperiod}. This command is used in \glspl{postlinkhook}}
+ }
+ % \glsxtrifcustomdiscardperiod
+ \gcmd{gls\-xtr\-if\-custom\-discard\-period}
+ {
+ \providedby{\sty{glossaries-extra} v1.23+}
+ \syntax{\margm{true}\margm{false}}
+ \initval{\meta{false}}
+ \desc{user hook to trigger a check for a following \idx{fullstop}.
+ This should do \meta{true} if there should be a check for a
+ following \idx{fullstop} otherwise should do \meta{false}}
+ }
+ % \glsxtrifperiod
+ \gcmd{gls\-xtr\-if\-period}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{true}\margm{false}\meta{token}}
+ \providedby{\sty{glossaries-extra}}%
+ \desc{does \meta{true} if \meta{token} is a \idx{fullstop}, otherwise
+ does \meta{false}}
+ }
+ % \glsxtrdiscardperiodretainfirstuse
+ \gcmd{gls\-xtr\-discard\-period\-retain\-first\-use}{%
+ \providedby{\sty{glossaries-extra} v1.49+}%
+ \syntax{\margm{entry-label}\margm{discarded}\margm{no discard}\meta{token}}
+ \desc{used to discard a following \idx{fullstop} when the
+ \catattr{retainfirstuseperiod} attribute is set}
+ }
+ % \glsxtrdopostpunc
+ \gcmd{gls\-xtr\-do\-post\-punc}{%
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \syntax{\margm{code}\meta{token}}
+ \desc{if \meta{token} is a recognised punctuation character
+ (see \gls{glsxtrifnextpunc}) this does the punctuation
+ character and then \meta{code}, otherwise if does \meta{code}
+ followed by \meta{token}}
+ }
+ % \glsxtrifnextpunc
+ \gcmd{gls\-xtr\-if\-next\-punc}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{true}\margm{false}}
+ \providedby{\sty{glossaries-extra}}%
+ \desc{performs \meta{true} if this command is followed by a
+ recognised punctuation character otherwise does \meta{false}.
+ The list of recognised punctuation marks is initialised to \code{.,:;?!}
+ (\idx{fullstop}, comma, colon, semicolon, question mark, and
+ exclamation mark). Additional punctuation characters can be
+ added with \gls{glsxtraddpunctuationmark}}
+ }
+ % \glsxtraddpunctuationmark
+ \gcmd{gls\-xtr\-add\-punctuation\-mark}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{token(s)}}
+ \desc{adds \meta{token(s)} to the list of punctuation characters
+ used by \gls{glsxtrifnextpunc}. You may list multiple characters
+ at the same time to add a batch, but don't add any separators
+ (including spaces). Note that each character must be a
+ single token, which means a single-byte character for \pdfLaTeX.
+ Multi-byte characters (\idx{utf8}) will required a native
+ Unicode engine (\XeLaTeX\ or \LuaLaTeX)}
+ }
+ % \glsxtrsetpunctuationmarks
+ \gcmd{gls\-xtr\-set\-punctuation\-marks}{%
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{token list}}
+ \desc{sets the punctuation list used by \gls{glsxtrifnextpunc}.
+ The \meta{token list} must be a non-delimited list of single
+ tokens that represent each punctuation character. Note that the
+ element of the list must be a single token, which means a single-byte
+ character for \pdfLaTeX\ (for example, \idx{ascii}). Multi-byte
+ characters (\idx{utf8}) will required a native Unicode engine
+ (\XeLaTeX\ or \LuaLaTeX)}
+ }
+ % COMMANDS: bib2gls
+ % \bibglssettotalrecordcount
+ \gcmd{bib\-gls\-set\-total\-record\-count}
+ {
+ \providedby{\app{bib2gls} v1.1+}
+ \syntax{\margm{entry-label}\margm{value}}
+ \desc{sets the total record count for the given entry}
+ \field{seealso}{switch.record-count}
+ }
+ % \bibglssetrecordcount
+ \gcmd{bib\-gls\-set\-record\-count}
+ {
+ \providedby{\app{bib2gls} v1.1+}
+ \syntax{\margm{entry-label}\margm{counter}\margm{value}}
+ \desc{sets the \meta{counter} record count for the given entry}
+ \field{seealso}{switch.record-count}
+ }
+ % \bibglssetlocationrecordcount
+ \gcmd{bib\-gls\-set\-location\-record\-count}
+ {
+ \providedby{\app{bib2gls} v1.1+}
+ \syntax{\margm{entry-label}\margm{counter}\margm{location}\margm{value}}
+ \desc{sets the location record count for the given entry}
+ \field{seealso}{switch.record-count-unit}
+ }
+ % \bibglsprimaryprefixlabel
+ \gcmd{bib\-gls\-primary\-prefix\-label}
+ {
+ \providedby{\app{bib2gls} v1.8+}
+ \syntax{\margm{label-prefix}}
+ \desc{hook written to the \ext{glstex} file identifying the
+ primary label prefix}
+ }
+ % \bibglsdualprefixlabel
+ \gcmd{bib\-gls\-dual\-prefix\-label}
+ {
+ \providedby{\app{bib2gls} v1.8+}
+ \syntax{\margm{label-prefix}}
+ \desc{hook written to the \ext{glstex} file identifying the
+ dual label prefix}
+ }
+ % \bibglstertiaryprefixlabel
+ \gcmd{bib\-gls\-tertiary\-prefix\-label}
+ {
+ \providedby{\app{bib2gls} v1.8+}
+ \syntax{\margm{label-prefix}}
+ \desc{hook written to the \ext{glstex} file identifying the
+ tertiary label prefix}
+ }
+ % \GlsXtrTotalRecordCount
+ \gcmd{Gls\-Xtr\-Total\-Record\-Count}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{expands to the entry's total record count (stored in
+ the \glosfield{recordcount} field) or to 0 if not set}
+ }
+ % \GlsXtrRecordCount
+ \gcmd{Gls\-Xtr\-Record\-Count}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{entry-label}\margm{counter}}
+ \desc{expands to the entry's record count for the given
+ \idxc{locationcounter}{counter} (stored in
+ the \glosfield{recordcount.counter} field) or to 0 if not set}
+ }
+ % \GlsXtrLocationRecordCount
+ \gcmd{Gls\-Xtr\-Location\-Record\-Count}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{entry-label}\margm{counter}\margm{location}}
+ \desc{expands to the entry's record count for the given
+ \idxc{locationcounter}{counter} and \location\ (stored in
+ the \glosfield{recordcount.counter.location} field) or
+ to 0 if not set}
+ }
+ % \glsxtrenablerecordcount
+ \gcmd{gls\-xtr\-enable\-record\-count}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \desc{redefines the \idx{glslike} commands (except \gls{glsdisp})
+ to use the analogous record count commands (\gls{rgls} etc)}
+ }
+ % \rgls
+ \gcmdspa{rgls}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{like \gls{gls} but hooks into the entry's record count}
+ \field{seealso}{glsxtrifrecordtrigger,rglsformat,switch.record-count}
+ }
+ % \rglspl
+ \gcmdspa{rgls\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{like \gls{glspl} but hooks into the entry's record count}
+ \field{seealso}{glsxtrifrecordtrigger,rglsplformat,switch.record-count}
+ }
+ % \rGls
+ \gcmdspa{rGls}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{like \gls{Gls} but hooks into the entry's record count}
+ \field{seealso}{glsxtrifrecordtrigger,rGlsformat,switch.record-count}
+ }
+ % \rGlspl
+ \gcmdspa{rGls\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{like \gls{Glspl} but hooks into the entry's record count}
+ \field{seealso}{glsxtrifrecordtrigger,rGlsplformat,switch.record-count}
+ }
+ % \rGLS
+ \gcmdspa{rGLS}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{like \gls{GLS} but hooks into the entry's record count}
+ \field{seealso}{glsxtrifrecordtrigger,rGLSformat,switch.record-count}
+ }
+ % \rGLSpl
+ \gcmdspa{rGLS\-pl}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\oargm{options}\margm{entry-label}\oargm{insert}}
+ \desc{like \gls{GLSpl} but hooks into the entry's record count}
+ \field{seealso}{glsxtrifrecordtrigger,rGlsplformat,switch.record-count}
+ }
+ % \glsxtrifrecordtrigger
+ \gcmd{gls\-xtr\-if\-record\-trigger}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{entry-label}\margm{true}\margm{false}}
+ \desc{does \meta{true} if the entry's total record count
+ (obtained with \gls{glsxtrrecordtriggervalue}) exceeds the value
+ supplied by the \catattr{recordcount} attribute,
+ otherwise does \meta{false}}
+ \field{seealso}{rgls,GlsXtrSetRecordCountAttribute,switch.record-count}
+ }
+ % \glsxtrrecordtriggervalue
+ \gcmd{gls\-xtr\-record\-trigger\-value}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{entry-label}}
+ \desc{expands to the trigger value used by \gls{glsxtrifrecordtrigger}}
+ \field{seealso}{rgls,switch.record-count}
+ }
+ % \glstriggerrecordformat
+ \gcmd{gls\-trigger\-record\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{location}}
+ \desc{used as a special location format that indicates that the
+ record is a trigger record}
+ \field{seealso}{rgls,switch.record-count}
+ }
+ % \GlsXtrSetRecordCountAttribute
+ \gcmd{Gls\-Xtr\-Set\-Record\-Count\-Attribute}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{category-list}\margm{value}}
+ \desc{sets the \catattr{recordcount} attribute to \meta{value}
+ for each of the listed categories}
+ }
+ % \rglsformat
+ \gcmd{rgls\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{format used by \gls{rgls} if the entry's record count is more
+ than the given trigger value}
+ }
+ % \rglsplformat
+ \gcmd{rgls\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{format used by \gls{rglspl} if the entry's record count is more
+ than the given trigger value}
+ }
+ % \rGlsformat
+ \gcmd{rGls\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{format used by \gls{rGls} if the entry's record count is more
+ than the given trigger value}
+ }
+ % \rGlsplformat
+ \gcmd{rGls\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{format used by \gls{rGlspl} if the entry's record count is more
+ than the given trigger value}
+ }
+ % \rGLSformat
+ \gcmd{rGLS\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{format used by \gls{rGLS} if the entry's record count is more
+ than the given trigger value}
+ }
+ % \rGLSplformat
+ \gcmd{rGLS\-pl\-format}
+ {
+ \providedby{\sty{glossaries-extra} v1.21+}
+ \syntax{\margm{entry-label}\margm{insert}}
+ \desc{format used by \gls{rGLSpl} if the entry's record count is more
+ than the given trigger value}
+ }
+ % \bibglsnewdualindexsymbolsecondary
+ \gcmd{bib\-gls\-new\-dual\-index\-symbol\-secondary}
+ {
+ \providedby{\app{bib2gls}}
+ \syntax{\margm{label}\margm{options}\margm{name}\margm{description}}
+ \desc{defines secondary terms provided with \atentry{dualindexsymbol}}
+ }
+ % \bibglssetlastgrouptitle
+ \gcmd{bib\-gls\-set\-last\-group\-title}
+ {
+ \providedby{\app{bib2gls}}
+ \syntax{\margm{cs}\margm{specs}}
+ \desc{sets the last group title}
+ }
+ % \GlsXtrDualField
+ \gcmd{Gls\-Xtr\-Dual\-Field}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.30+}
+ \initval{dual}
+ \desc{expands to the \idx{internalfieldlabel} used by \gls{GlsXtrDualBackLink}}
+ }
+ % \GlsXtrDualBackLink
+ \gcmd{Gls\-Xtr\-Dual\-Back\-Link}
+ {
+ \providedby{\sty{glossaries-extra-bib2gls} v1.30+}
+ \syntax{\margm{text}\margm{entry-label}}
+ \desc{Adds a hyperlink to the given entry's dual (whose label is
+ stored in the field given by \gls{GlsXtrDualField}) with the
+ given hyperlink text}
+ }
+ % COMMANDS: ON THE FLY
+ % \GlsXtrEnableOnTheFly
+ \gcmds{Gls\-Xtr\-Enable\-On\-The\-Fly}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.4+}
+ \desc{enables on the fly commands, such as \gls{glsxtr}}
+ }
+ % \glsxtr
+ \gcmd{gls\-xtr}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.4+}
+ \syntax{\oargm{gls-options}\oargm{dfn-options}\margm{entry-label}}
+ \desc{if \meta{entry-label} has already been defined, this just
+ references it, otherwise the entry is defined. This command must
+ be enabled with \gls{GlsXtrEnableOnTheFly}}
+ }
+ % \glsxtrpl
+ \gcmd{gls\-xtr\-pl}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.4+}
+ \syntax{\oargm{gls-options}\oargm{dfn-options}\margm{entry-label}}
+ \desc{as \gls{glsxtr} but shows the plural form}
+ }
+ % \Glsxtr
+ \gcmd{Gls\-xtr}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.4+}
+ \syntax{\oargm{gls-options}\oargm{dfn-options}\margm{entry-label}}
+ \desc{as \gls{glsxtr} but applies \idx{sentencecase}}
+ }
+ % \Glsxtrpl
+ \gcmd{Gls\-xtr\-pl}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.4+}
+ \syntax{\oargm{gls-options}\oargm{dfn-options}\margm{entry-label}}
+ \desc{as \gls{glsxtrpl} but applies \idx{sentencecase}}
+ }
+ % \glsxtrcat
+ \gcmd{gls\-xtr\-cat}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.4+}
+ \initval{general}
+ \desc{expands to the default category set by commands like \gls{glsxtr}}
+ }
+ % COMMANDS: OTHER
+ % \GlsXtrInternalLocationHyperlink
+ \gcmd{Gls\-Xtr\-Internal\-Location\-Hyper\-link}
+ {
+ \providedby{\sty{glossaries-extra} v1.29+}
+ \syntax{\margm{counter}\margm{prefix}\margm{location}}
+ \desc{used by \gls{glsxtrlocationhyperlink} to create an
+ internal hyperlink to the given location (advanced command, see
+ documented code for use)}
+ }
+ % \glsxtrlocationhyperlink
+ \gcmd{gls\-xtr\-location\-hyper\-link}
+ {
+ \providedby{\sty{glossaries-extra} v1.14+}
+ \syntax{\margm{counter}\margm{prefix}\margm{location}}
+ \desc{used to create a hyperlink to either an external or an
+ internal location, depending on whether or not
+ \gls{glsxtrsupplocationurl} is defined and not empty (advanced command, see
+ documented code for use)}
+ }
+ % \glsxtrundefaction
+ \gcmd{gls\-xtr\-un\-def\-action}
+ {
+ \providedby{\sty{glossaries-extra} v1.08+}
+ \syntax{\margm{message}\margm{additional help}}
+ \desc{will either produce an error or a warning, depending on
+ the \opt{undefaction} setting. In the \envfmt{document} environment
+ this will also generate the unknown marker (\idx{unknowntag})}
+ }
+ % \glsxtrundeftag
+ \gcmd{gls\-xtr\-un\-def\-tag}
+ {
+ \providedby{\sty{glossaries-extra} v1.08+}
+ \initval{\glsxtrundeftag}
+ \desc{expands to the unknown marker (\idx{unknowntag})}
+ }
+ % \ProvidesGlossariesExtraLang
+ \gcmd{Provides\-Glossaries\-Extra\-Lang}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.3+}
+ \syntax{\margm{tag}}
+ \desc{should be placed at the start of a \sty{glossaries-extra}
+ \ext{ldf} file}
+ }
+ % \RequireGlossariesExtraLang
+ \gcmd{Require\-Glossaries\-Extra\-Lang}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.3+}
+ \syntax{\margm{tag}}
+ \desc{indicates that a \sty{glossaries-extra}
+ \ext{ldf} file should be input, if it hasn't already been input}
+ }
+ % \GlsXtrNoGlsWarningHead
+ \gcmd{Gls\-Xtr\-No\-Gls\-Warning\-Head}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{glossary-label}\margm{file}}
+ \desc{produces the header boilerplate text if a glossary file is missing}
+ }
+ % \GlsXtrNoGlsWarningEmptyStart
+ \gcmd{Gls\-Xtr\-No\-Gls\-Warning\-Empty\-Start}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{produces the boilerplate text if a glossary is
+ probably empty}
+ }
+ % \GlsXtrNoGlsWarningEmptyMain
+ \gcmd{Gls\-Xtr\-No\-Gls\-Warning\-Empty\-Main}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{produces the boilerplate text if the probably empty
+ glossary is the \code{main} one}
+ }
+ % \GlsXtrNoGlsWarningEmptyNotMain
+ \gcmd{Gls\-Xtr\-No\-Gls\-Warning\-Empty\-Not\-Main}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{glossary-label}}
+ \desc{produces the boilerplate text if the probably empty
+ glossary is not the \code{main} one}
+ }
+ % \GlsXtrNoGlsWarningCheckFile
+ \gcmd{Gls\-Xtr\-No\-Gls\-Warning\-Check\-File}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{file}}
+ \desc{advisory message to check the file contents}
+ }
+ % \GlsXtrNoGlsWarningAutoMake
+ \gcmd{Gls\-Xtr\-No\-Gls\-Warning\-Auto\-Make}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{glossary-label}}
+ \desc{advisory message when \opt{automake} has been used}
+ }
+ % \GlsXtrNoGlsWarningMisMatch
+ \gcmd{Gls\-Xtr\-No\-Gls\-Warning\-Mis\-Match}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{advisory message on mis-matching \gls{makenoidxglossaries}}
+ }
+ % \GlsXtrNoGlsWarningBuildInfo
+ \gcmd{Gls\-Xtr\-No\-Gls\-Warning\-Build\-Info}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{build advice}
+ }
+ % \GlsXtrRecordWarning
+ \gcmd{Gls\-Xtr\-Record\-Warning}
+ {
+ \providedby{\sty{glossaries-extra} v1.31+}
+ \syntax{\margm{glossary-type}}
+ \desc{incorrect use of \gls{printglossary} with non-hybrid \opt{record}}
+ }
+ % \GlsXtrNoGlsWarningTail
+ \gcmd{Gls\-Xtr\-No\-Gls\-Warning\-Tail}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \desc{final paragraph of missing glossary boilerplate text}
+ }
+ % \GlsXtrNoGlsWarningNoOut
+ \gcmd{Gls\-Xtr\-No\-Gls\-Warning\-No\-Out}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{file}}
+ \desc{advisory if no output file was created}
+ }
+ % \glspar
+ \gcmd{gls\-par}
+ {
+ \providedby{\sty{glossaries}}
+ \desc{paragraph break (for instances where \gls{par} can't be used directly)}
+ }
+ % \glsbackslash
+ \gcmd{gls\-back\-slash}
+ {
+ \providedby{\sty{glossaries} v4.11+}
+ \desc{expands to a literal backslash}
+ }
+ % \glspercentchar
+ \gcmd{gls\-percent\-char}
+ {
+ \providedby{\sty{glossaries} v4.10+}
+ \desc{expands to a literal percent sign}
+ }
+ % \glstildechar
+ \gcmd{gls\-tilde\-char}
+ {
+ \providedby{\sty{glossaries} v4.10+}
+ \desc{expands to a literal tilde character}
+ }
+ % \GlsXtrExpandedFmt
+ \gcmd{Gls\-Xtr\-Expanded\-Fmt}
+ {
+ \providedby{\sty{glossaries-extra} v1.30+}
+ \syntax{\margm{cs}\margm{content}}
+ \desc{fully-expands \meta{content} and passes it to \meta{cs},
+ which must be a command that takes a single argument}
+ }
+ % \GlossariesExtraWarning
+ \gcmd{Glossaries\-Extra\-Warning}
+ {
+ %\providedby{\sty{glossaries-extra} v1.0+}
+ \syntax{\margm{message}}
+ \desc{writes a warning in the transcript with the current line
+ number. The \opt{nowarn} option redefines this command to do nothing}
+ }
+ % \GlossariesExtraWarningNoLine
+ \gcmd{Glossaries\-Extra\-Warning\-No\-Line}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5+}
+ \providedby{\sty{glossaries-extra}}
+ \syntax{\margm{message}}
+ \desc{writes a warning in the transcript without a
+ corresponding line number. The \opt{nowarn}
+ option redefines this command to do nothing}
+ }
+ % \GlsXtrWarnDeprecatedAbbrStyle
+ \gcmd{Gls\-Xtr\-Warn\-Deprecated\-Abbr\-Style}
+ {
+ \providedby{\sty{glossaries-extra} v1.04+}
+ \syntax{\margm{old-name}\margm{new-name}}
+ \desc{issues a warning with \gls{GlossariesExtraWarning}
+ indicating that a deprecated abbreviation style has been used}
+ }
+ % \glsxtrNoGlossaryWarning
+ \gcmd{gls\-xtr\-No\-Glossary\-Warning}
+ {
+ %\providedby{\sty{glossaries-extra} v0.3+}
+ \syntax{\margm{glossary-type}}
+ \desc{issues a warning with \gls{GlossariesExtraWarning}
+ indicating that the given glossary is missing}
+ }
+ % \GlsXtrUnknownDialectWarning
+ \gcmd{Gls\-Xtr\-Unknown\-Dialect\-Warning}
+ {
+ \providedby{\sty{glossaries-extra} v1.32+}
+ \syntax{\margm{locale}\margm{root language}}
+ \desc{issues a warning with \gls{GlossariesExtraWarning}
+ indicating that a valid dialect label can't be determined for
+ the given locale and root language}
+ }
+ % \glsxtrstarflywarn
+ \gcmd{gls\-xtr\-star\-fly\-warn}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.4+}
+ \desc{issues a warning with \gls{GlossariesExtraWarning}
+ indicating that the experimental starred version of
+ \gls{GlsXtrEnableOnTheFly} has been used}
+ }
+ % \GlsXtrWarning
+ \gcmd{Gls\-Xtr\-Warning}
+ {
+ %\providedby{\sty{glossaries-extra} v0.5.4+}
+ \syntax{\margm{options}\margm{entry}}
+ \desc{issues a warning with \gls{GlossariesExtraWarning}
+ indicating that the given options list has been ignored by the
+ given entry because it has already been defined}
+ }
+ % \glsxtrmglsWarnAllSkipped
+ \gcmd{gls\-xtr\-mgls\-Warn\-All\-Skipped}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \syntax{\margm{message}\margm{insert}\margm{fmt-cs}}
+ \desc{issues the given warning message with \gls{GlossariesExtraWarning}
+ and does \code{\meta{fmt-cs}\margm{insert}} (this warning is used if all
+ elements of a multi-entry set are skipped)}
+ }
+ % \mpglsWarning
+ \gcmd{mpglsWarning}
+ {
+ \providedby{\sty{glossaries-extra} v1.48+}
+ \desc{issues a warning with \gls{GlossariesExtraWarning}
+ indicating that \sty{glossaries-prefix} is required for
+ \gls{mpgls} family of commands}
+ }
+ % \GlossariesAbbrStyleTooComplexWarning
+ \gcmd{Glossaries\-Abbr\-Style\-Too\-Complex\-Warning}
+ {
+ \providedby{\sty{glossaries-extra} v1.49+}
+ \desc{issues a warning with \gls{GlossariesExtraWarning}
+ when a command is used that isn't supported by a complex
+ abbreviation style}
+ }
+ % GENERAL COMMANDS AND ENVIRONMENTS (index only)
+ \genv{document}{}
+ \genv{description}{}
+ \genv{equation}{}
+ \genv{align}{}
+ \genv{figure}{}
+ \genv{table}{}
+ \genv{tabular}{}
+ \genv{long\-table}{}% longtable
+ \genv{super\-tabular}{}% supertabular
+ \genv{the\-index}{}% theindex
+ \genv{multi\-cols}{}% multicols
+ \genv{multi\-cols*}{}% multicols*
+ \gcmd{item}{\syntax{\oarg{marker}}}% \item
+ \gcmd{index\-space}{}% \indexspace
+ \gcmd{hsize}{}% \hsize
+ \gcmd{index}{}% \index
+ \gcmd{actual\-char}{}% \actualchar
+ \gcmd{level\-char}{}% \levelchar
+ \gcmd{quote\-char}{}% \quotechar
+ \gcmd{encap\-char}{}% \encapchar
+ \gcmd{table\-of\-contents}{}% \tableofcontents
+ \gcmd{char}{}% \char
+ \gcmd{null}{}% \null
+ \gcmd{relax}{}% \relax
+ \gcmd{par\-indent}{}% \parindent
+ \gcmd{line\-width}{}% \linewidth
+ \gcmd{tab\-col\-sep}{}% \tabcolsep
+ \gcmd{@gobble}{}% \@gobble
+ \gcmd{@first\-of\-one}{}% \@firstofone
+ \gcmd{@first\-of\-two}{}% \@firstoftwo
+ \gcmd{@second\-of\-two}{}% \@secondoftwo
+ \gcmd{par}{}% \par
+ \gcmd{protect}{}% \protect
+ \gcmd{string}{}% \string
+ \gcmd{chapter}{}% \chapter
+ \gcmd{section}{}% \section
+ \gcmd{part}{}% \part
+ \gcmd{expand\-after}{}% \expandafter
+ \gcmd{expand\-once}{}% \expandonce
+ \gcmd{un\-skip}{}% \unskip
+ \gcmd{leave\-v\-mode}{}% \leavevmode
+ \gcmd{let}{}% \let
+ \gcmd{hfil}{}% \hfil
+ \gcmd{caption}{}% \caption
+ \gcmd{label}{}% \label
+ \gcmd{ref}{}% \ref
+ \gcmd{name\-ref}{}% \nameref
+ \gcmd{Get\-Title\-String\-Disable\-Commands}{}% \GetTitleStringDisableCommands
+ \gcmd{Get\-Title\-String\-Set\-up}{}% \GetTitleStringSetup
+ \gcmd{textsc}{}% \textsc
+ \gcmd{textbf}{}% \textbf
+ \gcmd{textup}{}% \textup
+ \gcmd{emph}{}% \emph
+ \gcmd{underline}{}% \underline
+ \gcmd{text\-smaller}{}% \textsmaller
+ \gcmd{text\-larger}{}% \textlarger
+ \gcmd{page\-ref}{}% \pageref
+ \gcmd{job\-name}{}% \jobname
+ \gcmd{input}{}% \input
+ \gcmd{the\-page}{}% \thepage
+ \gcmdmeta{the}{counter}{}{}% \the<counter>
+ \gcmdmeta{theH}{counter}{}{}% \theH<counter>
+ \gcmd{foreign\-language}{}% \foreignlanguage
+ \gpunccmd{amp}{\&}{}% \&
+ \gpunccmd{dollar}{\$}{}% \$
+ \gcmd{new\-command}{}% \newcommand
+ \gcmd{re\-new\-command}{}% \renewcommand
+ \gcmd{provide\-command}{}% \providecommand
+ \gcmd{step\-counter}{}% \stepcounter
+ \gcmd{ref\-step\-counter}{}% \refstepcounter
+ \gcmd{@current\-label}{}% \@currentlabel
+ \gcmd{@current\-label\-name}{}% \@currentlabelname
+ \gcmd{@current\-Href}{}% \@currentHref
+ \gcmd{cs\-def}{}% \csdef
+ \gcmd{cs\-let}{}% \cslet
+ \gcmd{cs\-let\-cs}{}% \csletcs
+ \gcmd{let\-cs}{}% \letcs
+ \gcmd{if\-cs\-undef}{}% \ifcsundef
+ \gcmd{if\-undef}{}% \ifundef
+ \gcmd{if\-def\-empty}{}% \ifdefempty
+ \gcmd{if\-def\-string}{}% \ifdefstring
+ \gcmd{if\-cs\-string}{}% \ifcsstring
+ \gcmd{if\-cs\-void}{}% \ifcsvoid
+ \gcmd{app\-to}{}% \appto
+ \gcmd{pre\-to}{}% \preto
+ \gcmd{list\-cs\-add}{}% \listcsadd
+ \gcmd{list\-cs\-gadd}{}% \listcsgadd
+ \gcmd{list\-cs\-eadd}{}% \listcseadd
+ \gcmd{list\-cs\-xadd}{}% \listcsxadd
+ \gcmd{do\-list\-cs\-loop}{}% \dolistcsloop
+ \gcmd{for\-list\-cs\-loop}{}% \forlistcsloop
+ \gcmd{if\-in\-list\-cs}{}% \ifinlistcs
+ \gcmd{xif\-in\-list\-cs}{}% \xifinlistcs
+ \gcmd{hyper\-target}{}% \hypertarget
+ \gcmd{hyper\-link}{}% \hyperlink
+ \gcmd{hyper\-ref}{}% \hyperref
+ \gcmd{hl}{}% \hl
+ \gcmd{so}{}% \so
+ \gcmd{ul}{}% \ul
+ \gcmd{mbox}{}% \mbox
+ \gcmd{fbox}{}% \fbox
+ \gcmd{text\-super\-script}{}% \textsuperscript
+ \gcmd{text\-sub\-script}{}% \textsubscript
+ \gcmd{foot\-note}{}% \footnote
+ \gcmd{upper\-case}{}% \uppercase
+ \gcmd{Make\-Upper\-case}{}% \MakeUppercase
+ \gcmd{Make\-Text\-Upper\-case}{}% \MakeTextUppercase
+ \gcmd{Make\-Text\-Lower\-case}{}% \MakeTextLowercase
+ \gcmd{Make\-Lower\-case}{}% \MakeLowercase
+ \gcmd{main\-matter}{}% \mainmatter
+ \gcmd{front\-matter}{}% \frontmatter
+ \gcmd{back\-matter}{}% \backmatter
+ \gcmd{@start\-toc}{}% \@starttoc
+ \gcmd{mark\-right}{}% \markright
+ \gcmd{mark\-both}{}% \markboth
+ \gcmd{pdf\-book\-mark}{}% \pdfbookmark
+ \gcmd{tex\-or\-pdf\-string}{}% \texorpdfstring
+ \gcmd{No\-Case\-Change}{}% \NoCaseChange
+ \gcmd{pagestyle}{}% \pagestyle
+ \gcmd{alph}{}% \alph
+ \gcmd{Alph}{}% \Alph
+ \gcmd{arabic}{}% \arabic
+ \gcmd{roman}{}% \roman
+ \gcmd{Roman}{}% \Roman
+ \gcmd{@for}{}% \@for
+ \gcmd{@endfortrue}{}% \@endfortrue
+ \gcmd{alpha}{}% \alpha
+ \gcmd{beta}{}% \beta
+ \gcmd{Delta}{}% \Delta
+ \gcmd{digamma}{}% \digamma
+ \gcmd{up\-alpha}{}% \upalpha
+ \gcmd{up\-beta}{}% \upbeta
+ \gcmd{If\-Track\-ed\-Language\-File\-Exists}{}% \IfTrackedLanguageFileExists
+ % GENERAL COUNTERS
+ \gctr{page}{}
+ \gctr{section}{}
+ \gctr{chapter}{}
+ \gctr{part}{}
+ \gctr{equation}{}
+ \gctr{figure}{}
+ \gctr{table}{}
+ % TERMS
+ \gterm{indexingapp}{\name{indexing application}%
+ \desc{an application (piece of software) separate from
+ \protect\TeX/\protect\LaTeX\ that collates and sorts information that has an
+ associated page reference. Generally the information is an index
+ entry but in this case the information is a \idx{glossary} entry.
+ There are two main indexing applications that are used with \TeX:
+ \app+{makeindex} and \app+{xindy}. (There is also a new
+ application called \app{xindex}, but this isn't supported by
+ \sty{glossaries} or \sty{glossaries-extra}.) The \sty{glossaries-extra}
+ package additionally supports \app{bib2gls}. These are all
+ \idx{cli} applications.}%
+ }%
+ \gterm{indexing}{%
+ \name{indexing (or recording)}
+ \field{text}{indexing}
+ \desc{the process of saving the \idx+{entrylocation} and any
+ associated information that is required in the \idx{glossary}. In
+ the case of \app{makeindex} and \app{xindy}, the
+ \idx{entrylocation}, \idxc{locationencap}{encap}, entry item and sort value are written
+ to a supplementary file associated with the \idx{glossary} that is
+ subsequently read by \app{makeindex}\slash\app{xindy}. In the
+ case of \app{bib2gls} and the \qt{noidx} method, the
+ \idx{entrylocation}, \idxc{locationencap}{encap} and label is written to the
+ \ext+{aux} file. With \opteqvalref{record}{nameref}, the
+ current title and hyperlink target are also included. With
+ \app{bib2gls}, each line of data in the \ext{aux} is referred
+ to as a \qt{record} and indexing is referred to as
+ \qt{recording}. The \optval{record}{hybrid} option indexes
+ twice: a \app{bib2gls} record in the \ext{aux} file and a
+ \app{makeindex}\slash\app{xindy} line in the corresponding file, See
+ \sectionref{sec:wrglossary}}
+ }
+ \gterm{glossary}%
+ {%
+ \common
+ \name{glossary}
+ \field{plural}{glossaries}
+ \desc{technically a glossary is an alphabetical list of words
+ relating to a particular topic. For the purposes of describing
+ the \sty{glossaries} and \sty{glossaries-extra} packages, a
+ glossary is either the list produced by commands like
+ \gls{printglossary} or \gls{printunsrtglossary} (which may or
+ may not be ordered alphabetically) or a glossary is a set of
+ entry labels where the set is identified by the glossary label
+ or type}
+ }
+ \gidx{mini-glossary}{\field{plural}{mini-glossaries}}
+ \gidx{glossmini}{\name{glossary, mini}\field{see}{idx.mini-glossary}}
+ \gtermacr{cli}{CLI}{command-line interface}%
+ {%
+ \desc{an application that doesn't have a graphical user
+ interface. That is, an application that doesn't have any windows,
+ buttons or menus and can be run in
+ \dickimawhref{latex/novices/html/terminal.html}{a command
+ prompt or terminal}}%
+ }%
+ \gtermacr{gui}{GUI}{graphical user interface}%
+ {%
+ \desc{an application that has windows, buttons or menus}
+ }
+ \gtermacr{ascii}{ASCII}{American Standard Code for Information Interchange}
+ {%
+ \desc{a single-byte character encoding. Related blog article:
+ \blog{binary-files-text-files-and-file-encodings/}{Binary
+ Files, Text Files and File Encodings}}
+ }
+ \gtermacr{utf8}{UTF\glsxtrrevert{-8}}{Unicode Transformation Format (8-bit)}
+ {%
+ \desc{a variable-width encoding that uses 8-bit code units. This
+ means that some characters are represented by more that one byte.
+ \XeLaTeX\ and \LuaLaTeX\ treat the multi-byte sequence as a single
+ token, but the older \LaTeX\ formats have single-byte tokens, which
+ can cause complications, although these have mostly been addressed with
+ the newer kernels introduced over the past few years. Related blog article:
+ \blog{binary-files-text-files-and-file-encodings/}{Binary Files,
+ Text Files and File Encodings}}
+ }
+ \gterm{idx.group}{\name{group (letters, numbers, symbols)}
+ \field{text}{group}%
+ \desc{a logical division within a \idx{glossary} that is typically a
+ by-product of the \idx{indexingapp}['s] sorting algorithm. See also
+ \gallerypage{logicaldivisions}{Gallery: Logical Glossary Divisions
+ (type vs group vs parent)}}%
+ }%
+ \gterm{hierarchicallevel}{\name{hierarchical level}%
+ \desc{a number that indicates how many ancestors an entry has.
+ An entry with no parent has hierarchical level~0. If an entry
+ has a parent then the hierarchical level for the entry is one
+ more than the hierarchical level of the parent. Most styles will
+ format an entry according to its hierarchical level, giving
+ prominence to level~0 entries, although some may have a maximum
+ supported limit. The \idx{unsrtfam} allow the
+ hierarchical level to be locally adjusted by adding an offset
+ (\printglossopt{leveloffset}) or to have hierarchy ignored
+ (\printglossopt{flatten})}
+ }
+ \gterm{locationlist}{\name{location list}%
+ \desc{a list of \idxpl+{entrylocation} (also called a number
+ list). May be suppressed for all \idxpl{glossary} with the package option
+ \opt{nonumberlist} or for individual \idxpl{glossary} with
+ \printglossopt{nonumberlist}. With \app{bib2gls}, the list may
+ also be suppressed with \resourceoptval{save-locations}{false}}
+ }
+ \gterm{locationencap}{\name{location encap (format)}
+ \field{text}{location encap}
+ \desc{a command used to encapsulate an \idx{entrylocation}.
+ The control sequence name (without the leading backslash)
+ is identified by the \glsopt{format} key. The default encap is
+ \gls{glsnumberformat}}
+ }
+ \gterm{locationcounter}{\name{location counter}
+ \desc{the counter used to obtain the \idx{entrylocation}}
+ }
+ \gterm{entrylocation}{\common\name{entry location}%
+ \desc{the location of the entry in the document (obtained from
+ the \idx{locationcounter} or from the \glsopt{thevalue} option). This defaults to the page number
+ on which the entry has been
+ referenced with any of the \idx{glslike}, \idx{glstextlike} or \gls{glsadd}
+ commands. An entry may have multiple locations that form a list}
+ }
+ \gidx{numberlist}{\name{number list}\field{alias}{locationlist}}
+ \gterm{ignoredlocation}{\name{ignored location (or record)}%
+ \field{text}{ignored location}
+ \desc{a \location\ that uses \encap{glsignore} as the
+ \idxc{locationencap}{encap}. With \app{bib2gls}, this indicates that the entry
+ needs to be selected but the \location\ isn't added to the
+ \idx{locationlist}. With other methods, this will simply create
+ an invisible \location, which can result in unwanted commas if
+ the \idx{locationlist} has other items}
+ }
+ \gidx{locationignored}{\name{location, ignored\slash invisible}%
+ \field{see}{ignoredlocation}}
+ \gterm{ignoredglossary}{\name{ignored glossary}%
+ \field{plural}{ignored glossaries}%
+ \desc{a \idx{glossary} that has been defined using a command like
+ \gls{newignoredglossary}. These \idxpl{glossary} are omitted by
+ iterative commands, such as \gls{printglossaries} and
+ \gls{printunsrtglossaries}. An ignored
+ \idx{glossary} can only be displayed with \gls{printunsrtglossary}
+ or \gls{printunsrtinnerglossary}}
+ }
+ \gidx{glossaryignored}{\name{glossary, ignored}\field{see}{ignoredglossary}}
+ \gterm{firstuseflag}{\name{first use flag}%
+ \common
+ \desc{a conditional that keeps track of whether or not an entry
+ has been referenced by any of the \idx{glslike} commands (which
+ can adjust their behaviour according to whether or not this flag is
+ true). The conditional is true if the entry hasn't been used by
+ one of these commands
+ (or if the flag has been reset) and false if it has been used
+ (or if the flag has been unset). Note that multi-entries have
+ their own flag that's distinct from the first use flags of the
+ individual elements}
+ }
+ \gterm{firstuse}{\name{first use}%
+ \common
+ \desc{the first time an entry is used by a command that unsets
+ the \idx{firstuseflag} (or the first time since the flag was
+ reset). For multi-entry sets, see \idx{mfirstuse}}
+ }
+ \gterm{firstusetext}{\name{first use text}%
+ \common
+ \desc{the \idx{linktext} that is displayed on \idx{firstuse} of
+ the \idx{glslike} commands}
+ }
+ \gterm{subsequentuse}{\name{subsequent use}
+ \common
+ \desc{using an entry that unsets the \idx{firstuseflag} when it
+ has already been unset}
+ }
+ \gterm{mfirstuseflag}{\name{multi-entry first use flag}%
+ \desc{a conditional that keeps track of whether or not a
+ multi-entry has been used. This is distinct from the
+ \idxpl{firstuseflag} of the individual elements}
+ }
+ \gterm{mfirstuse}{\name{multi-entry first use}%
+ \field{text}{first use}
+ \desc{the first time a multi-entry is referenced (or the first time since
+ the \idx{mfirstuseflag} was reset). This is not necessary the
+ \idx{firstuse} of any of the individual entries that form the set}
+ }
+ \gterm{msubsequentuse}{\name{multi-entry subsequent use}%
+ \field{text}{subsequent use}
+ \desc{when a multi-entry that has already been marked as used is referenced.
+ This is not necessary the \idx{subsequentuse} of any of the individual entries
+ that form the set}
+ }
+ \gterm{glslike}{\common\name{{}\csfmt{gls}-like}
+ \desc{commands like \gls{gls} and \gls{glsdisp} that change the
+ \idx{firstuseflag}. These commands index the entry (if indexing
+ is enabled), create a hyperlink to the entry's \idx{glossary} listing (if enabled)
+ and unset the \idx{firstuseflag}. These commands end with the
+ \idx{postlinkhook}}
+ }
+ \gterm{glstextlike}{\common\name{{}\csfmt{glstext}-like}
+ \desc{commands like \gls{glstext} and \gls{glslink} that don't change
+ the \idx{firstuseflag}. These commands index the entry (if indexing
+ is enabled) and create a hyperlink to the entry's \idx{glossary} listing (if enabled). These commands end with the \idx{postlinkhook}}
+ }
+ \gterm{linktext}{\name{link text}%
+ \desc{the text produced by \idx{glslike} and \idx{glstextlike}
+ commands that have the potential to be a hyperlink}
+ }
+ \gterm{postlinkhook}{\name{post-link hook}
+ \desc{a hook (command) that is used after \idx{linktext} to
+ allow code to be automatically added. The base \sty{glossaries}
+ package provides a general purpose hook \gls{glspostlinkhook}. The
+ \sty{glossaries-extra} package modifies this command to provide
+ additional hooks, including \glspl{catpostlinkhook}}
+ }
+ \gterm{catpostlinkhook}{\name{category post-link hook}
+ \desc{a \idx{postlinkhook} called \gls{glsxtrpostlinkcat} that is
+ associated with a particular \idx{category}}
+ }
+ \gterm{postdeschook}{\name{post-description hook}%
+ \desc{a hook (\gls{glspostdescription}) included in some \idxpl{glossarystyle}
+ that is used after the description is displayed. The \sty{glossaries-extra} package modifies
+ this command to provide additional hooks, including \glspl{catpostdeschook}.
+ The \sty{glossaries-extra-stylemods}
+ package modifies the predefined styles provided with
+ \sty{glossaries} to ensure that they all use
+ \gls{glspostdescription} to allow the \glspl{catpostdeschook} to be
+ implemented}
+ }
+ \gterm{catpostdeschook}{\name{category post-description hook}
+ \desc{a \gls{postdeschook} called \gls{glsxtrpostdesccategory} that is
+ associated with a particular \idx{category}}
+ }
+ \gterm{postnamehook}{\name{post-name hook}%
+ \desc{a hook (command) that is used after the name is
+ displayed in \idxpl{glossarystyle}. These hooks are implemented by
+ \gls{glossentryname}, which needs to be present in the
+ \idx{glossarystyle}. The main hook is \gls{glsxtrpostnamehook},
+ which implements auto-indexing (see \sectionref{sec:autoindex}),
+ performs a general purpose hook \gls{glsextrapostnamehook}
+ and a \idx{category}-specific hook \gls{glsxtrpostnamecategory}}
+ }
+ \gterm{catpostnamehook}{\name{category post-name hook}
+ \desc{a \gls{postnamehook} called \gls{glsxtrpostnamecategory} that is
+ associated with a particular \idx{category}}
+ }
+ \gterm{standaloneentry}%
+ {%
+ \name{standalone entry}
+ \desc{normally the \idx{linktext} target is created in the
+ \idx{glossary}, where the entry's name and description (and optionally
+ other information, such as the symbol) are shown. It may be that
+ you don't want a list but need to have the name and description
+ somewhere in the document text. These are standalone entries.
+ Whilst it is possible to simply use \gls{glsentryname} and
+ \gls{glsentrydesc}, the \sty{glossaries-extra} package provides
+ a way inserting the name that includes the hypertarget for the
+ \idx{linktext} and obeys the \idx{postnamehook}}
+ }
+ \gterm{resourceset}%
+ {%
+ \name{resource set}
+ \desc{all the settings (\idxpl{resourceopt}) and entries associated with a particular
+ instance of \gls{GlsXtrLoadResources} (or \gls{glsxtrresourcefile})}
+ }
+ \gterm{resourcefile}%
+ {%
+ \name{resource file}
+ \desc{the \ext+{glstex} file created by \app{bib2gls} and loaded by
+ \gls{GlsXtrLoadResources} (or \gls{glsxtrresourcefile})}
+ }
+ \gterm{field}%
+ {%
+ \name{field}
+ \desc{entry data is stored in fields. These may have a
+ corresponding key used to set the value, such as \gloskey{name}
+ or \gloskey{description}, but field values may also be set
+ using commands like \gls{GlsXtrSetField}, in which case there
+ doesn't need to be a corresponding key. Some fields are
+ considered \idxpl{internalfield}. If you are using
+ \app{bib2gls}, it will only recognise fields in the \ext{bib}
+ file that have had a key defined in the document or that are
+ special to \app{bib2gls}}
+ }
+ \gterm{internalfield}%
+ {%
+ \name{internal field}
+ \desc{an internal \idx{field} may refer to a key that shouldn't be
+ used in the \ext{bib} file (\idx{bib2glsinternalfield}), such as
+ the \gloskey{group} field, or it may refer to the
+ \idxc{internalfieldlabel}{label} used to internally represent the
+ \idx{field} (which may or may not match the key used to set the
+ \idx{field} or may not have an associated key), such as \fieldfmt{useri} which
+ corresponds to the \gloskey{user1} key, or it may refer to a \idx{field}
+ that is only ever used internally that should not be explicitly
+ modified, such as the field used to store the entry's
+ hierarchical level
+}
+ }
+ \gterm{bib2glsinternalfield}%
+ {%
+ \name{internal field (\appfmt{bib2gls})}
+ \desc{a \idx{field} that is used or assigned by \app{bib2gls}
+ that should typically not be used in the \ext+{bib} file}
+ }
+ \gterm{internalfieldlabel}%
+ {%
+ \name{internal field label}
+ \desc{the field label that forms part of the internal control
+ sequence used to store the field value. This may or may not
+ match the key used to assign the value when defining the entry.
+ See the \ctanmirrornofn{macros/latex/contrib/glossaries/glossaries-user.html\#tab:fieldmap}{\qt{Key to Field Mappings}} table in the \sty{glossaries}
+ user manual}
+ }
+ \gterm{unsrtfam}%
+ {%
+ \name{print \qt{unsrt} glossary commands (and environment)}
+ \field{text}{\qt{unsrt} family of commands}
+ \desc{the set of commands used for displaying a \idx{glossary} or
+ partial \idx{glossary} that have \qt{unsrt} in the name:
+ \gls{printunsrtglossary}, \gls{printunsrtglossaries} (which
+ internally uses \gls{printunsrtglossary}), and
+ \gls{printunsrtinnerglossary}. These all simply
+ iterate over the list of entries associated with the given
+ \idx{glossary}, in the order in which they were added to the \idx{glossary}
+ (hence \qt{unsrt}, which is short for \qt{unsorted}). The way that \app{bib2gls}
+ works is that it sorts the entries according to the
+ \idxpl{resourceopt} and adds the entries to the glossary in the
+ required order. These commands may be used with or without
+ \app{bib2gls}. If you don't use \app{bib2gls}, you will need
+ to manually ensure that the entries are added in the desired
+ order. The \env{printunsrtglossarywrap} environment may also be
+ included in this category, although it only sets up the start
+ and end of the \idx{glossary} for use with \gls{printunsrtinnerglossary}}
+ }
+ \gterm{whatsit}%
+ {%
+ \desc{a command whose execution is delayed or an OS-specific special command.
+ This includes writing to external files (which is what indexing does)}
+ }
+ \gterm{inlinefullform}%
+ {
+ \name{inline full form}
+ \desc{the full form of an abbreviation obtained with
+ \gls{glsxtrfull} or \gls{glsxtrfullpl} (or case-changing
+ variants). This may or may not produce the same result as the
+ full form on \idx{firstuse} of the corresponding \idx{glslike}
+ command (the \idx{displayfullform}), depending on the abbreviation style}
+ }
+ \gterm{displayfullform}%
+ {
+ \name{display full form}
+ \desc{the full form of an abbreviation obtained with
+ the \idx{firstuse} of \gls{gls} or \gls{glspl} (or case-changing
+ variants). This may or may not produce the same result as the
+ \idx{inlinefullform} the corresponding \idx{glsxtrfull} command,
+ depending on the abbreviation style}
+ }
+ \gterm{innerformatting}
+ {
+ \name{inner formatting}
+ \desc{the formatting applied by the \glsopt{innertextformat}
+ option, which redefines \gls{glsxtrgenentrytextfmt}. The inner
+ formatting can only be applied if \gls{glsxtrgenentrytextfmt} is
+ embedded within the entry's display style}
+ }
+ % FILE EXTENSIONS
+ \gext{log}{}%
+ \gext{aux}{\common}%
+ \gext{bib}{\common}%
+ \gext{tex}{\common}%
+ \gext{toc}{}%
+ \gext{glstex}{}%
+ \gext{glsdefs}{}%
+ \gext{glslabels}{}%
+ \gext{gls}{}%
+ \gext{glo}{}%
+ \gext{glg}{}%
+ \gext{ist}{}%
+ \gext{xdy}{}%
+ \gext{acr}{}%
+ \gext{gls-abr}{}%
+ \gext{glo-abr}{}%
+ \gext{glg-abr}{}%
+ \gext{ldf}{}%
+ % GENERAL INDEX
+ \gpunc{unknowntag}{\name{\code{??} (unknown entry marker)}
+ \field{text}{\code{??}}}
+ \gpunc{sym.fullstop}{\name{\code{.} (full stop or period)}
+ \field{see}{idx.fullstop}
+ }
+ \gpunc{sym.nbsp}{\name{\code{\textasciitilde} (non-breaking space)}
+ \field{see}{idx.nbsp}
+ }
+ \gpunc{sym.hash}{\name{\code{\#}}}
+ \gidx{uppercase}{\field{seealso}{idx.titlecase,idx.sentencecase,idx.allcaps}}
+ \gidx{lowercase}{}
+ \gidx{titlecase}{\name{title case}}
+ \gidx{sentencecase}{\common\name{sentence case}}
+ \gidx{allcaps}{\common\name{all caps}}
+ \gidx{casechange}{\name{case change}
+ \field{seealso}{idx.uppercase,idx.lowercase,idx.titlecase,idx.sentencecase,idx.allcaps}}
+ \gidx{smallcaps}{\name{small caps}}
+ \gidx{period}{\name{period (\code{.})}%
+ \field{text}{period}
+ \field{alias}{idx.fullstop}
+ }
+ \gidx{fullstop}{\name{full stop (\code{.})}%
+ \field{text}{full stop}
+ }
+ \gidx{nbsp}{\name{non-breaking space (\code{\textasciitilde})}
+ \field{symbol}{\code{\textasciitilde}}
+ }
+}
- \title{glossaries-extra.sty v1.48:
- an extension to the glossaries package}
- \author{Nicola L.C. Talbot\\[10pt]
+\title{\styfmt{glossaries-extra.sty} v1.49:
+ an extension to the \styfmt{glossaries} package}
+\author{Nicola L.C. Talbot\\[10pt]
Dickimaw Books\\
-\url{http://www.dickimaw-books.com/}}
+\href{https://www.dickimaw-books.com/}{\nolinkurl{dickimaw-books.com}}}
- \date{2021-11-22}
+\date{2022-10-14
+}
+\begin{document}
\maketitle
+\htmlavailable
+
\begin{abstract}
-The \styfmt{glossaries-extra} package is an extension to the
-\styfmt{glossaries} package, providing additional features.
-Some of the features provided by this package are only available
-with \styfmt{glossaries} version 4.19 (or above).
-This document assumes familiarity with the \styfmt{glossaries} package.
-
-The file \nolinkurl{example-glossaries-xr.tex} contains dummy
-entries with cross-references that may be used for creating
-minimal working examples for testing the \styfmt{glossaries-extra}
-package. (The base \styfmt{glossaries} package provides additional files,
-but this one needs \styfmt{glossaries-extra}.) There are equivalent
-\texttt{.bib} files for use with \gls{bib2gls}.
-
-\textbf{The \styfmt{glossaries-extra} package uses a different set
-of defaults to the base \styfmt{glossaries} package.} See the
-Introduction for more details.
+The \sty{glossaries-extra} package is an extension to the
+\sty{glossaries} package, providing additional features.
+In particular, it provides a completely different abbreviation
+mechanism.
+You will need at least \sty{glossaries} version 4.19, but it is best
+to update both packages at the same time, if new releases are
+available for both of them.
\end{abstract}
-\begin{important}
-Since \styfmt{glossaries-extra} internally loads the \styfmt{glossaries}
-package, you also need to have \styfmt{glossaries} installed and
-all the packages that \styfmt{glossaries} depends on (including, but
-not limited to, \sty{tracklang}, \sty{mfirstuc}, \sty{etoolbox},
-\sty{xkeyval} (at least version dated 2006/11/18), \sty{textcase},
-\sty{xfor}, \sty{datatool-base} and \sty{amsgen}. These
-packages are all available in the current \TeX\ Live and Mik\TeX\
-distributions. If any of them are missing, please update your
-\TeX\ distribution using your update manager.
-(For help on this see, for example,
-\href{http://tex.stackexchange.com/questions/55437/how-do-i-update-my-tex-distribution}{How do I update my \TeX\ distribution?}
-or
-\href{http://tex.stackexchange.com/questions/14925/updating-tex-on-linux}{Updating
-\TeX\ on Linux}.)
-\end{important}
-
-Additional resources:
+\begin{warning}
+The \sty{glossaries-extra} package uses a different set
+of defaults to the base \sty{glossaries} package. This means that if
+you simply replace \sty{glossaries} with \sty{glossaries-extra} in
+an existing document, there may be some differences in the PDF, and
+you may encounter errors. See \sectionref{sec:defaults} for more details.
+\end{warning}
+
+\begin{information}
+This document assumes some familiarity with the \sty{glossaries} package.
+If you are new to \sty{glossaries}, you may prefer to start with the
+following:
\begin{itemize}
-\item The \styfmt{glossaries-extra} documented code
-\href{http://mirrors.ctan.org/macros/latex/contrib/glossaries-extra/glossaries-extra-code.pdf}{glossaries-extra-code.pdf}.
-
-\item The
-\href{http://www.dickimaw-books.com/gallery/#glossaries-extra}{\styfmt{glossaries-extra} gallery}.
-
-\item \styfmt{glossaries-extra} and \gls{bib2gls}: An Introductory
-Guide. (\href{http://mirrors.ctan.org/support/bib2gls/bib2gls-begin.pdf}{\texttt{bib2gls-begin.pdf}}).
-
\item
-\href{https://www.dickimaw-books.com/latex/buildglossaries/}{Incorporating
-makeglossaries or makeglossaries-lite or bib2gls into the document
-build}.
-
-\item The
-\href{http://www.dickimaw-books.com/software/bib2gls}{\appfmt{bib2gls}}
-application.
+\ctanmirrordocnofn{macros/latex/contrib/glossaries/glossariesbegin}{The
+\styfmt{glossaries} package: a guide for beginners}
+\texdocref{glossariesbegin}
-\item The base \href{https://ctan.org/pkg/glossaries}{\styfmt{glossaries}} package.
+\item
+\ctanmirrornofn{support/bib2gls/bib2gls-begin.pdf}{\styfmt{glossaries-extra}
+and \appfmt{bib2gls}: an
+introductory guide}
+\texdocref{bib2gls-begin}
\end{itemize}
+\end{information}
+\frontmatter
\tableofcontents
+\listofexamples
+
+\mainmatter
+\part{User Guide}
\chapter{Introduction}
\label{sec:intro}
-The \styfmt{glossaries} package is a flexible package, but it's also a
+The \sty+{glossaries} package is a flexible package, but it's also a
heavy-weight package that uses a lot of resources. As package
developer, I'm caught between those users who complain about the
drawbacks of a heavy-weight package with a large user manual and
those users who want more features (which necessarily adds to the
package weight and manual size).
-The \styfmt{glossaries-extra} package is an attempt to provide
-a~compromise for this
-conflict. Version 4.22 of the \styfmt{glossaries} package is
-the last version to incorporate new features.\footnote{4.21 was
-originally intended as the last release of \styfmt{glossaries} to
-incorporate new features, but a few new minor features slipped in with
-some bug fixes in v4.21.} Future versions of
-\styfmt{glossaries} will just be bug fixes. New features will
-instead be added to \styfmt{glossaries-extra}.
+The \sty+{glossaries-extra} package is an attempt to provide
+a~compromise for this conflict. Version 4.22 of the \sty{glossaries}
+package is the last version to incorporate any major new features.
+Future versions of \sty{glossaries} will mostly just be bug fixes.
+New features will instead be added to \styfmt{glossaries-extra}.
This means that the base \styfmt{glossaries} package won't increase
in terms of package loading time and allocation of resources, but
those users who do want extra features available will have more of a
chance of getting their feature requests accepted.
+\begin{important}
+Some of the commands provided by the base \sty+{glossaries} package
+are incompatible with \sty+{glossaries-extra}. These are marked with
+\glssymbol{sym.banned} in this document.
+\end{important}
+
+The \sty{glossaries-extra} package internally loads the
+\sty{glossaries} package. As a general rule, it's better to defer
+loading the base \sty{glossaries} package to \sty{glossaries-extra}
+rather than loading the two packages separately.
+
\section{Package Defaults}
\label{sec:defaults}
I'm not happy with some of the default settings assumed by the
-\styfmt{glossaries} package, and, judging from code I've seen, other
+\sty{glossaries} package, and, judging from code I've seen, other
users also seem unhappy with them, as certain package options are
often used in questions posted on various sites. I can't change the default
-behaviour of \styfmt{glossaries} as it would break backward
-compatibility, but since \styfmt{glossaries-extra} is a separate
-package, I have decided to implement some of these commonly-used
-options by default. You can switch them back if they're not
+behaviour of \sty{glossaries} as it would break backward
+compatibility, but since \sty{glossaries-extra} is a separate
+package, I have decided to implement some of these commonly-used
+options by default. You can switch them back if they're not
appropriate.
The new defaults are:
\begin{itemize}
-\item \pkgopt[true]{toc} (add the glossaries to the table of
-contents). Use \pkgopt[false]{toc} to switch this back off.
-
-\item \pkgopt[true]{nopostdot} (suppress the terminating full stop
-after the description in the glossary). Use
-\pkgopt[false]{nopostdot} or just \pkgopt{postdot} to restore the
-terminating full stop (period).
-
-\item \pkgopt[true]{noredefwarn} (suppress the warnings that occur when
-the \env{theglossary} environment and \cs{printglossary} are redefined while
-\styfmt{glossaries} is loading). To restore the warnings, use
-\pkgopt[false]{noredefwarn}. Note that this won't have any effect if
-the \styfmt{glossaries} package has already been loaded before you use
-the \styfmt{glossaries-extra} package.
-
-\item If \sty{babel} has been loaded, the \pkgopt[babel]{translate}
+\item \optval{toc}{true} (add the glossaries to the table of
+contents). Use \optval{toc}{false} to switch this back off.
+
+\item \optval{nopostdot}{true} (suppress the terminating \idx{fullstop}
+after the description in the \idx{glossary}). Use
+\optval{nopostdot}{false} or just \opt{postdot} to restore the
+terminating \idx{fullstop}. Alternatively, if you are interested in
+switching to \app{bib2gls}, you can instruct \app{bib2gls} to insert
+it with the \resourceopt{post-description-dot} option.
+
+\item \opt{noredefwarn} (suppress the warnings that occur when
+the \env{theglossary} environment and \gls{printglossary} are redefined while
+\sty{glossaries} is loading). Note that this won't have any effect if
+the \sty{glossaries} package has already been loaded before you load
+the \sty{glossaries-extra} package.
+
+\item If \sty{babel} has been loaded, the \optval{translate}{babel}
option is switched on. To revert to using the \sty{translator}
-interface, use \pkgopt[true]{translate}. There is no change to the
+interface, use \optval{translate}{true}. There is no change to the
default if \sty{babel} hasn't been loaded.
-\item The default style used by \ics{newacronym} is
+\item The default style used by \gls{newacronym} is
\abbrstyle{short-nolong}. (That is, the long form is not shown on
-\gls{firstuse}.)
+\idx{firstuse}.) To revert back to \qt{\meta{long} (\meta{short})} on
+\idx{firstuse} do:
+\begin{codebox}
+\gls{setabbreviationstyle}\oarg{\cat{acronym}}\marg{\abbrstyle{long-short}}
+\end{codebox}
+In the above example, \abbrstyle{long-short} refers to the
+ \sty{glossaries-extra} \idx{abbrvstyle} not the \sty{glossaries} acronym style
+of the same name. See \sectionref{sec:abbreviations} for further details.
\end{itemize}
-The examples below illustrate the difference in explicit
-package options between \styfmt{glossaries} and
-\styfmt{glossaries-extra}. There may be other differences
-resulting from modifications to commands provided by
-\styfmt{glossaries} (see \sectionref{sec:modifications}).
+\section{Example Differences Between \stytext{glossaries} and
+\stytext{glossaries-extra}}
+\label{sec:examplediffs}
-\begin{enumerate}
-\item Basic defaults:
-\begin{verbatim}
-\documentclass{article}
-\usepackage{glossaries-extra}
-\end{verbatim}
+The examples below illustrate the difference in explicit package
+options between \sty{glossaries} and \sty{glossaries-extra}. There
+may be other differences resulting from modifications to commands
+provided by \sty{glossaries}.
+
+\subsection{Basic defaults}
+\label{sec:examplediffsbasic}
+
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\cmd{usepackage}\marg{glossaries-extra}
+\end{codebox}
This is like:
-\begin{verbatim}
-\documentclass{article}
-\usepackage[toc,nopostdot]{glossaries}
-\usepackage{glossaries-extra}
-\end{verbatim}
-
-\item Language defaults:
-\begin{verbatim}
-\documentclass[british]{article}
-\usepackage{babel}
-\usepackage{glossaries-extra}
-\end{verbatim}
+\begin{codebox*}
+\cmd{documentclass}\marg{article}
+\cmd{usepackage}[\opt{toc},\opt{nopostdot}]\marg{glossaries}
+\cmd{usepackage}\marg{glossaries-extra}
+\end{codebox*}
+
+\subsection{Language defaults}
+\label{sec:examplediffslang}
+
+\begin{codebox*}
+\cmd{documentclass}[british]\marg{article}
+\cmd{usepackage}\marg{\sty{babel}}
+\cmd{usepackage}\marg{glossaries-extra}
+\end{codebox*}
This is like:
-\begin{verbatim}
-\documentclass[british]{article}
-\usepackage{babel}
-\usepackage[toc,nopostdot,translate=babel]{glossaries}
-\usepackage{glossaries-extra}
-\end{verbatim}
-
-\item Combined with \cls{memoir}
-\begin{verbatim}
-\documentclass{memoir}
-\usepackage{glossaries-extra}
-\end{verbatim}
+\begin{codebox*}
+\cmd{documentclass}[british]\marg{article}
+\cmd{usepackage}\marg{\sty{babel}}
+\cmd{usepackage}[\opt{toc},\opt{nopostdot},\optval{translate}{babel}]\marg{glossaries}
+\cmd{usepackage}\marg{glossaries-extra}
+\end{codebox*}
+
+\subsection{Combined with \clstext{memoir}}
+\label{sec:examplediffsmemoir}
+
+\begin{codebox}
+\cmd{documentclass}\marg{\cls{memoir}}
+\cmd{usepackage}\marg{glossaries-extra}
+\end{codebox}
This is like:
-\begin{verbatim}
-\documentclass{memoir}
-\usepackage[toc,nopostdot,noredefwarn]{glossaries}
-\usepackage{glossaries-extra}
-\end{verbatim}
+\begin{codebox}
+\cmd{documentclass}\marg{\cls{memoir}}
+\cmd{usepackage}[\opt{toc},\opt{nopostdot},\opt{noredefwarn}]\marg{glossaries}
+\cmd{usepackage}\marg{glossaries-extra}
+\end{codebox}
\emph{However}
-\begin{verbatim}
-\documentclass{memoir}
-\usepackage{glossaries}
-\usepackage{glossaries-extra}
-\end{verbatim}
+\begin{codebox}
+\cmd{documentclass}\marg{\cls{memoir}}
+\cmd{usepackage}\marg{glossaries}
+\cmd{usepackage}\marg{glossaries-extra}
+\end{codebox}
This is like:
-\begin{verbatim}
-\documentclass{memoir}
-\usepackage[toc,nopostdot]{glossaries}
-\usepackage{glossaries-extra}
-\end{verbatim}
-Since by the time \styfmt{glossaries-extra} has been loaded,
-\styfmt{glossaries} has already redefined \cls{memoir}'s
-glossary-related commands.
-
-\item Abbreviations are defined with \cs{newabbreviation}:
-\begin{verbatim}
-\usepackage{glossaries-extra}
-\newabbreviation{svm}{SVM}{support vector machine}
-\begin{document}
-First use: \gls{svm}. Explicit full form: \glsxtrfull{svm}.
-\end{document}
-\end{verbatim}
-This is the closest to:
-\begin{verbatim}
-\usepackage{glossaries}
-\newacronym{svm}{SVM}{support vector machine}
-\begin{document}
-First use: \gls{svm}. Explicit full form: \acrfull{svm}.
-\end{document}
-\end{verbatim}
-If you want to continue using \cs{newacronym} then you will need to
-change the style for the \category{acronym} category:
-\begin{verbatim}
-\usepackage{glossaries-extra}
-\setabbreviationstyle[acronym]{long-short}
-\newacronym{svm}{SVM}{support vector machine}
-\begin{document}
-First use: \gls{svm}. Explicit full form: \glsxtrfull{svm}.
-\end{document}
-\end{verbatim}
-\end{enumerate}
-
-Another noticeable change is that by default \cs{printglossary}
-will now display information text in the document if the external
-glossary file doesn't exist. This is explanatory text to help new
-users who can't work out what to do next to complete the document
-build. Once the document is set up correctly and the external files
-have been generated, this text will disappear.
+\begin{codebox}
+\cmd{documentclass}\marg{\cls{memoir}}
+\cmd{usepackage}[\optval{toc}{false},\optval{nopostdot}{false}]\marg{glossaries}
+\cmd{usepackage}\marg{glossaries-extra}
+\end{codebox}
+Since by the time \sty{glossaries-extra} has been loaded,
+the base \sty{glossaries} package has already redefined \cls{memoir}['s]
+\idx{glossary}-related commands.
-This change is mostly likely to be noticed by users
-with one or more redundant empty glossaries who ignore
-transcript messages, explicitly use \gls{makeindex}\slash\gls{xindy}
-on just the non-empty glossary (or glossaries) and use
-the iterative
-\ics{printglossaries} command instead of \ics{printglossary}. For example,
-consider the following:
-\begin{verbatim}
-\documentclass{article}
-
-\usepackage[acronym]{glossaries}
+\subsection{Abbreviations}
+\label{sec:examplediffsabbrv}
+
+Abbreviations are defined with \gls{newabbreviation}:
+\begin{codebox}
+\cmd{usepackage}\marg{glossaries-extra}
+\gls{newabbreviation}\marg{svm}\marg{SVM}\marg{support vector machine}
+\cbeg{document}
+First use: \gls{gls}\marg{svm}. Explicit full form: \gls{glsxtrfull}\marg{svm}.
+\cend{document}
+\end{codebox}
+This is the closest match to:
+\begin{codebox}
+\cmd{usepackage}\marg{glossaries}
+\gls{newacronym}\marg{svm}\marg{SVM}\marg{support vector machine}
+\cbeg{document}
+First use: \gls{gls}\marg{svm}. Explicit full form: \gls{acrfull}\marg{svm}.
+\cend{document}
+\end{codebox}
+If you want to continue using \gls{newacronym} then you will need to
+change the style for the \cat{acronym} \idx{category}:
+\begin{codebox}
+\cmd{usepackage}\marg{glossaries-extra}
+\gls{setabbreviationstyle}\oarg{\cat{acronym}}\marg{\abbrstyle{long-short}}
+\gls{newacronym}\marg{svm}\marg{SVM}\marg{support vector machine}
+\cbeg{document}
+First use: \gls{gls}\marg{svm}. Explicit full form: \gls{glsxtrfull}\marg{svm}.
+\cend{document}
+\end{codebox}
-\makeglossaries
+\begin{important}
+Don't use commands like \gls{glsfirst} or \gls{glstext} with
+abbreviations. See \sectionref{sec:abbreviations} for further
+details.
+\end{important}
-\newacronym{laser}{laser}{light amplification by stimulated
+\subsection{Glossary Mid-Build Placeholder (\glsfmttext{printglossary})}
+\label{sec:examplediffprintgloss}
+
+Another noticeable change with \sty{glossaries-extra} is that by
+default \gls{printglossary} will now display information text in the
+document if the external \idx{glossary} file doesn't exist. This is
+explanatory text to help new users who can't work out what to do
+next to complete the document build. Once the document is set up
+correctly and the external files have been generated, this text will
+disappear.
+
+This change is mostly likely to be noticed by users with one or more
+redundant empty glossaries who ignore transcript messages,
+explicitly use \app+{makeindex}\slash\app+{xindy} on just the
+non-empty \idx{glossary} (or \idxpl{glossary}) and use the iterative
+\gls{printglossaries} command instead of \gls{printglossary}. For
+example, consider the following:
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\cmd{usepackage}[\opt{acronym}]\marg{glossaries}
+\gls{makeglossaries}
+\gls{newacronym}\marg{laser}\marg{laser}\marg{light amplification by stimulated
emission of radiation}
-
-\begin{document}
-
-\gls{laser}
-
-\printglossaries
-
-\end{document}
-\end{verbatim}
+\cbeg{document}
+\gls{gls}\marg{laser}
+\gls{printglossaries}
+\cend{document}
+\end{codebox}
The above document will only display the list of
-acronyms at the place where \ics{printglossaries} occurs. However it
-will also attempt to input the \texttt{.gls} file associated with
-the \texttt{main} glossary.
+acronyms at the place where \gls{printglossaries} occurs. However it
+will also attempt to input the \ext{gls} file associated with
+the \code{main} \idx{glossary}.
-If you use \gls{makeglossaries}, you'll get the warning message:
-\begin{verbatim}
+If you use \app{makeglossaries}, you'll get the warning message:
+\begin{transcript}
Warning: File 'test.glo' is empty.
Have you used any entries defined in glossary 'main'?
Remember to use package option 'nomain' if you
don't want to use the main glossary.
-\end{verbatim}
-(where the original file is called \texttt{test.tex})
-but if you simply call \gls{makeindex} directly to generate the
-\texttt{.acr} file (without attempting to create the \texttt{.gls}
+\end{transcript}
+(where the original file is called \filefmt{test.tex})
+but if you simply call \app{makeindex} directly to generate the
+\ext+{acr} file (without attempting to create the \ext{gls}
file) then the transcript file will always contain the message:
-\begin{verbatim}
+\begin{transcript}
No file test.gls.
-\end{verbatim}
-This doesn't occur with \gls{makeglossaries} as it will create
-the \texttt{.gls} file containing the single command \cs{null}.
+\end{transcript}
+This doesn't occur with \app{makeglossaries} as it will create
+the \ext{gls} file containing the single command \gls{null}.
-If you simply change from \styfmt{glossaries} to
-\styfmt{glossaries-extra} in this document, you'll find a change in the
-resulting PDF if you don't use \gls{makeglossaries} and you only
-generate the \texttt{.acr} file with \gls{makeindex}.
+If you simply change from \sty{glossaries} to
+\sty{glossaries-extra} in this document, you'll find a change in the
+resulting PDF if you don't use \app{makeglossaries} and you only
+generate the \ext{acr} file with \app{makeindex}.
The transcript file will still contain the message
-about the missing \texttt{.gls}, but now you'll also see
+about the missing \ext{gls}, but now you'll also see
information in the actual PDF document. The simplest remedy is to
follow the advice inserted into the document at that point, which is
-to add the \pkgopt{nomain} package option:
-\begin{verbatim}
-\documentclass{article}
-
-\usepackage[nomain,acronym,postdot]{glossaries-extra}
-
-\makeglossaries
+to add the \opt{nomain} package option:
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\cmd{usepackage}[\opt{nomain},\opt{acronym},\opt{postdot}]\marg{glossaries-extra}
+\gls{makeglossaries}
+\gls{setabbreviationstyle}\oarg{\cat{acronym}}\marg{\abbrstyle{long-short}}
+\gls{newacronym}\marg{laser}\marg{laser}\marg{light amplification by stimulated
+emission of radiation}
+\cbeg{document}
+\gls{gls}\marg{laser}
+\gls{printglossaries}
+\cend{document}
+\end{codebox}
+\begin{information}
+Note the need to set the acronym style using
+\gls{setabbreviationstyle} before \gls{newacronym}.
+See \sectionref{sec:abbreviations} for further details.
+\end{information}
+
+\section{Further Reading}
+\label{sec:reading}
+
+The following documents and web pages are also available:
+\begin{itemize}
+\item
+\ctanmirrornofn{macros/latex/contrib/glossaries-extra/glossaries-extra-code.pdf}%
+{The \styfmt{glossaries-extra} documented code}
+\texdocref{glossaries-extra-code}
-\setabbreviationstyle[acronym]{long-short}
+\item \gallery{Gallery: \styfmt{glossaries},
+\styfmt{glossaries-extra} and \appfmt{bib2gls}}.
-\newacronym{laser}{laser}{light amplification by stimulated
-emission of radiation}
+\item \dickimawhref{faq.php}{FAQs: \styfmt{glossaries},
+\styfmt{glossaries-extra} and \appfmt{bib2gls}}.
-\begin{document}
+\item \dickimawhref{latex/buildglossaries/}{Incorporating
+\appfmt{makeglossaries} or \appfmt{makeglossaries-lite} or
+\appfmt{bib2gls} into the document build}.
-\gls{laser}
+\item \ctanref{pkg/bib2gls}{The \appfmt{bib2gls} application}.
-\printglossaries
+\item \ctanref{pkg/glossaries}{The \styfmt{glossaries} package}.
-\end{document}
-\end{verbatim}
-(Note the need to set the acronym style using
-\cs{setabbreviationstyle} before \cs{newacronym}.
-See \sectionref{sec:abbreviations} for further details.)
+\end{itemize}
-\section{New or Modified Package Options}
+\chapter{Package Options}
\label{sec:pkgopts}
-If you haven't already loaded \styfmt{glossaries}, you can use any of
-the package options provided by \styfmt{glossaries} when you load
-\styfmt{glossaries-extra} and they will automatically be passed to
-\styfmt{glossaries} (which \styfmt{glossaries-extra} will load). If
-\styfmt{glossaries} has already been loaded, then those options will be
-passed to \ics{setupglossaries}, but remember that not all of the
-\styfmt{glossaries} package options may be used in that command.
+\pkgdef{glossaries-extra}
+%
+This chapter describes the package options provided by \sty{glossaries-extra}
+that are either not defined by the base \sty{glossaries} package or are modified by
+\sty{glossaries-extra}. You can additionally pass the base package
+options to \sty{glossaries-extra}. For example, instead of:
+\begin{codebox}
+\cmd{usepackage}\oarg{\opt{nonumberlist}}\marg{glossaries}
+\cmd{usepackage}\oarg{\opt{abbreviations}}\marg{glossaries-extra}
+\end{codebox}
+you can simply do:
+\begin{codebox}
+\cmd{usepackage}\oarg{\opt{abbreviations},\opt{nonumberlist}}\marg{glossaries-extra}
+\end{codebox}
+
+\begin{information}
+It's better not to load the \sty{glossaries} package first.
+Leave \sty{glossaries-extra} to load it, where possible, to allow for
+a smoother integration between the two packages.
+\end{information}
+
+After \sty{glossaries-extra} has been loaded, some of the \sty{glossaries-extra}
+package options may be changed with:
+\cmddef{glossariesextrasetup}
+where \meta{options} are the same as the relevant package option.
\begin{important}
-This section only lists options that are either unrecognised by
-the \styfmt{glossaries} package or are a modified version of options
-of the same name provided by \styfmt{glossaries}. See the
-\styfmt{glossaries} user manual for details about the unmodified
-options.
+Certain options can only be supplied as package options since the
+settings need to be known while \sty{glossaries-extra} is loading.
\end{important}
-The new and modified options provided by \styfmt{glossaries-extra}
-are described below:
+To change the base \sty{glossaries} package's options (that may be
+changed after the package has loaded), continue to use:
+\cmddef{setupglossaries}
+but don't use any of the options listed here in that command.
-\begin{description}
+\section{Glossary Lists}
+\label{sec:gloslistopts}
-\item[{\pkgoptdef{debug}}] The \styfmt{glossaries} package
-has a \pkgoptfmt{debug} option that allows the values
-\pkgoptfmt{false}, \pkgoptfmt{true} and \pkgoptfmt{showtargets}.
-The \pkgopt[showtargets]{debug} option was introduced to
-\styfmt{glossaries} v4.32, so if you want to use this option
-with \styfmt{glossaries-extra} you must make sure that
-your version of \styfmt{glossaries} supports it.
-
-The \styfmt{glossaries-extra} package extends this option
-to provide the additional values \pkgopt[showwrgloss]{debug}
-and \pkgopt[all]{debug}.
-
-The \pkgopt[showwrgloss]{debug} option implements
-\pkgopt[true]{debug} and uses
-\begin{definition}[\DescribeMacro\glsxtrwrglossmark]
-\cs{glsxtrwrglossmark}
-\end{definition}
-to show a mark \ensuremath{\cdot} just before the write operation
-performed by the indexing commands. If you use
-\pkgopt[hybrid]{record} there will be a mark for the
-write operation to the \texttt{.aux} file for \gls{bib2gls}
-and a mark for the write operation to the associated glossary
-file for \gls{makeindex} or \gls{xindy}.
-
-The \pkgopt[all]{debug} option implements both \pkgopt[showtargets]{debug}
-and \pkgopt[showwrgloss]{debug}.
-
-\item[{\pkgoptdef{showtargets}}] This implements
-\pkgopt[showtargets]{debug} and can also adjust the way the targets
-are shown. By default, any links that occur in \TeX's \qt{outer}
-mode are placed in the margin according to \ics{glsshowtargetouter}
-(provided by the base \styfmt{glossaries} package). This can lead to
-the \qt{too many floats} error if there are multiple instances of
-commands like \cs{gls} in a single line. This option provides a way
-of changing this to an in-line annotation. Available values:
-\begin{description}
-\item[\optfmt{left}] A marker is placed to the left of the
-link/target and a marginal note is used in outer mode;
-\item[\optfmt{right}] A marker is placed to the right of the
-link/target and a marginal note is used in outer mode;
-\item[\optfmt{innerleft}] A marker and annotation are placed to the left of the
-link/target in all modes;
-\item[\optfmt{innerright}] A marker and annotation are placed to the
-right of the link/target in all modes;
-\item[\optfmt{annoteleft}] Markers are placed on either side of the
-link/target and the annotation is on the left;
-\item[\optfmt{annoteright}] Markers are placed on either side of the
-link/target and the annotation is on the right.
-\end{description}
+% PACKAGE OPTION: nomissingglstext
+\optiondef{nomissingglstext}
+If true, this will suppress the warning written to the transcript
+and the warning text that will appear in the
+document if the external glossary files haven't been generated due
+to an incomplete document build. However, it's probably simpler
+just to fix whatever has caused the failure to build the external
+file or files.
-\item[{\pkgoptdef{postdot}}] (New to version 1.12.)
-This option is just a shortcut for \pkgopt[false]{nopostdot}.
+% PACKAGE OPTION: abbreviations
+\optiondef{abbreviations}
+This option has no value and can't be cancelled. If used,
+it will automatically create a new glossary with the label
+\code{abbreviations} and redefines \gls{glsxtrabbrvtype} to this
+label. (The file extensions are \ext+{glg-abr},
+\ext+{gls-abr} and \ext+{glo-abr}.)
+In addition, this option defines a shortcut command:
+\cmddef*{printabbreviations}
+which is equivalent to:
+\begin{codebox}
+\gls{printglossary}\oarg{\printglossoptval{type}{\gls{glsxtrabbrvtype}},\meta{options}}
+\end{codebox}
+If \sty{glossaries-extra-bib2gls} is also loaded then this option
+will additionally provide \gls{printunsrtabbreviations}
+which uses \gls{printunsrtglossary} instead.
-\item[{\pkgoptdef{postpunc}}] (New to version 1.21.)
-This option sets the post-description punctuation to the given
-value. For example: \pkgoptfmt{postpunc={;}} does
-\begin{verbatim}
-\renewcommand{\glspostdescription}{;}
-\end{verbatim}
-The value may also be one of the following keywords:
-\begin{description}
-\item[\texttt{comma}:] \pkgopt[comma]{postpunc} is
-equivalent to
-\begin{verbatim}
-\renewcommand{\glspostdescription}{,}
-\end{verbatim}
-
-\item[\texttt{dot}:] \pkgopt[dot]{postpunc} is
-equivalent to
-\begin{verbatim}
-\renewcommand{\glspostdescription}{.\spacefactor\sfcode`\. }
-\end{verbatim}
-
-\item[\texttt{none}:] \pkgopt[none]{postpunc} is
-equivalent to
-\begin{verbatim}
-\renewcommand{\glspostdescription}{}
-\end{verbatim}
-\end{description}
-The default definition is
-\begin{verbatim}
-\newcommand*{\glspostdescription}{%
- \ifglsnopostdot\else.\spacefactor\sfcode`\. \fi
-}
-\end{verbatim}
-where the conditional is determined by the \pkgopt{nopostdot}
-package option. The \pkgopt{postpunc} option removes the conditional
-from the definition of \cs{glspostdescription}. The package options
-\pkgopt{nopostdot} and \pkgopt{postdot} will restore the original definition of
-\cs{glspostdescription}.
-
-The \sty{glossaries-extra-stylemods} package adjusts
-the predefined styles that had a hard-coded \cs{space}
-before the \gls{numberlist} so that they use \cs{glsxtrprelocation}
-instead (which is defined to \cs{space}). You can therefore
-redefine this command in combination with \pkgopt{postpunc}
-to alter the separator before the \gls{numberlist}.
-For example, to have a comma followed by \cs{hfil}:
-\begin{verbatim}
-\usepackage[postpunc=comma,stylemods]{glossaries-extra}
-\renewcommand{\glsxtrprelocation}{\hfil}
-\end{verbatim}
-Be careful with doing this as it will look odd if the \gls{numberlist} is
-missing. (With \gls{bib2gls} you can instead redefine
-\cs{glsxtrprelocation} to do nothing and set the
-location prefixes with \texttt{loc-prefix} which will only
-apply if the entry has a \gls{numberlist}.)
-
-\item[{\pkgoptdef{prefix}}] Load the \sty{glossaries-prefix}
-package (if not already loaded).
-
-\item[{\pkgoptdef{accsupp}}] Load the \sty{glossaries-accsupp}
-package (if not already loaded).
+The title of the new glossary is given by
+\cmddef*{abbreviationsname}
+If this command is already defined, it's left unchanged. Otherwise
+it's defined to \qt{Abbreviations} if \sty{babel} hasn't been loaded
+or \gls{acronymname} if \sty{babel} has been loaded. However, if
+you're using \sty{babel} it's likely you will need to change this.
+(See \sectionref{sec:lang} for further details.)
-\begin{important}
-The \sty{glossaries-accsupp} package is still experimental and so
-accessibility features are liable to change.
-\end{important}
+\begin{information}
+If you don't use the \opt{abbreviations} package option,
+the \gls{abbreviationsname} command won't be defined (unless it's
+defined by an included language file).
+\end{information}
+
+If the \opt{abbreviations} option is used and the
+\opt{acronym} option provided by the \sty{glossaries}
+package hasn't been used, then \gls{acronymtype}
+will be set to \gls{glsxtrabbrvtype} so that acronyms defined with
+\gls{newacronym} can be added to the list of abbreviations. If you
+want acronyms in the \code{main} glossary and other abbreviations in the
+\code{abbreviations} glossary then you will need to redefine
+\gls{acronymtype} to \code{main}:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{acronymtype}}\marg{main}
+\end{codebox}
+
+Note that there are no analogous options to the \sty{glossaries}
+package's \opt{acronymlists} option (or associated commands)
+as the abbreviation mechanism is handled differently with
+\sty{glossaries-extra}.
+
+% PACKAGE OPTION: symbols
+\optiondef{symbols}
+This is passed to the base \sty{glossaries} package, but
+\sty{glossaries-extra} will additionally define:
+\cmddef*{glsxtrnewsymbol}
+which is equivalent to:
+\begin{codebox}
+\gls{newglossaryentry}\margm{entry-label}\marg{\gloskeyval{name}{\meta{symbol}},
+ \gloskeyval{sort}{\meta{entry-label}},\gloskeyval{type}{symbols},\gloskeyval{category}{symbol},
+\meta{options}}
+\end{codebox}
+Note that the \gloskey{sort} key is set to the \meta{entry-label}
+not the \meta{symbol} as the symbol will likely contain commands.
+If this isn't appropriate, you can override it by using the \gloskey{sort} key
+in the optional argument.
-If you want to define styles that can interface with the
-accessibility support provided by \sty{glossaries-accsupp} use
-the \cs{glsaccess\meta{xxx}} type of commands instead of
-\cs{glsentry\meta{xxx}} (for example, \ics{glsaccesstext} instead of
-\ics{glsentrytext}). If \sty{glossaries-accsupp} hasn't been loaded
-those commands are equivalent (for example, \cs{glsaccesstext}
-just does \cs{glsentrytext}) but if it has been loaded, then the
-\cs{glsaccess\meta{xxx}} commands will add the accessibility
-information. (See \sectionref{sec:accsupp} for further details.)
-
-Note that the \pkgopt{accsupp} option can only be used as
-a~package option (and can't be set with \ics{glossariesextrasetup}) since the \sty{glossaries-accsupp}
-package must be loaded before \styfmt{glossaries-extra} if it's
-required.
-
-\item[{\pkgoptdef{stylemods}}] This is a
-\meta{key}=\meta{value} option used to load the
-\sty{glossaries-extra-stylemods} package. The value may be a
-comma-separated list of options to pass to that package. (Remember
-to group \meta{value} if it contains any commas.) The value may be
-omitted if no options need to be passed. See \sectionref{sec:glosstylemods}
-for further details. There are two special keyword values:
-\pkgopt[default]{stylemods} (equivalent to omitting the value)
-and \pkgopt[all]{stylemods}, which loads all the
-predefined styles.
+This option also sets the \catattr{regular} attribute to \code{true}
+for the \cat{symbol} category and provides the
+\idx{catpostdeschook}:
+\cmddef*{glsxtrpostdescsymbol}
-\item[{\pkgoptdef{undefaction}}] This is a \meta{key}=\meta{value}
-option, which has two allowed values: \pkgoptfmt{warn} and
-\pkgoptfmt{error}. This indicates what to do if an undefined
-glossary entry is referenced. The default behaviour is
-\pkgopt[error]{undefaction}, which produces an error message (the
-default for \styfmt{glossaries}). You can switch this to a warning
-message (and ?? appearing in the text) with
-\pkgopt[warn]{undefaction}.
+If \sty{glossaries-extra-bib2gls} is also loaded then this option
+will additionally provide \gls{printunsrtsymbols}
+which uses \gls{printunsrtglossary}.
+
+% PACKAGE OPTION: numbers
+\optiondef{numbers}
+This is passed to the base \sty{glossaries} package but
+\sty{glossaries-extra} will additionally define:
+\cmddef*{glsxtrnewnumber}
+which is equivalent to:
+\begin{codebox}
+\gls{newglossaryentry}\margm{entry-label}\marg{\gloskeyval{name}{\meta{number}},
+ \gloskeyval{sort}{\meta{entry-label}},\gloskeyval{type}{numbers},\gloskeyval{category}{number},
+\meta{options}}
+\end{codebox}
+Note that the \gloskey{sort} key is set to the \meta{entry-label}.
+If this isn't appropriate, you can override it by using the \gloskey{sort} key
+in the optional argument.
+
+This option also sets the \catattr{regular} attribute to \code{true}
+for the \cat{number} category and provides the
+\idx{catpostdeschook}:
+\cmddef*{glsxtrpostdescnumber}
+
+If \sty{glossaries-extra-bib2gls} is also loaded then this option
+will additionally provide \gls{printunsrtnumbers}
+which uses \gls{printunsrtglossary}.
+
+% PACKAGE OPTION: acronyms
+\optiondef{acronyms}
+This is passed to the base \sty{glossaries} package (which defines
+\gls{printacronyms} and creates a new glossary with the label \code{acronym}) but
+if \sty{glossaries-extra-bib2gls} is loaded then this option will
+additionally provide \gls{printunsrtacronyms}
+which uses \gls{printunsrtglossary}.
+
+As with the base \sty{glossaries} package, this option redefines
+\gls{acronymtype} to \code{acronym}. Note that this option doesn't
+change \gls{glsxtrabbrvtype}.
+
+% PACKAGE OPTION: acronym
+\optiondef{acronym}
+If \optval{acronym}{true}, this behaves like \opt{acronyms}.
+Note that \optval{acronym}{false} won't work if the base
+\sty{glossaries} package was loaded before \sty{glossaries-extra}.
+
+% PACKAGE OPTION: index
+\optiondef{index}
+This is passed to the base \sty{glossaries} package but
+if \sty{glossaries-extra-bib2gls} is loaded then this option will
+additionally provide \gls{printunsrtindex}
+which uses \gls{printunsrtglossary}.
+
+The base package \opt{index} option also defines:
+\cmddef*{newterm}
+This definition is modified by \sty{glossaries-extra} to
+additionally set the \gloskey{category} to \cat{index} and sets the
+\gloskey{description} to discard the \idx{postdeschook}
+(\gls{nopostdesc}) but retain \gls{glsxtrpostdescription} so that
+the \idx{catpostdeschook} can still be applied.
+
+This option also sets the \catattr{regular} attribute to \code{true}
+for the \cat{index} category and defines an associated
+\idx{catpostdeschook}:
+\cmddef*{glsxtrpostdescindex}
+
+\section{Glossary Style Options}
+\label{sec:glosstyleopts}
+
+% PACKAGE OPTION: nopostdot
+\optiondef{nopostdot}
+This option is provided by \sty{glossaries} where it simply alters a
+corresponding conditional that's used inside
+\gls{glspostdescription} to determine whether or not to insert a
+\idx{fullstop}.
+
+The \opt{postpunc} option (see below) redefines \gls{glspostdescription}, so the
+\opt{nopostdot} option is modified by \sty{glossaries-extra} to
+reset the hook back to its original definition to
+counteract any use of the \opt{postpunc} option.
\begin{important}
-Undefined entries can't be picked up by any commands that iterate
-over a glossary list. This includes \ics{forglsentries} and
-\ics{glsaddall}.
+This option will have no effect if the \idx{glossarystyle} doesn't
+include \gls{glspostdescription}. (Use \opt{stylemods} to ensure that all the
+predefined styles that show the description have this hook added.)
\end{important}
-Note that \ics{ifglsused} will display ?? in the document text with
-\pkgopt[warn]{undefaction} if the entry hasn't been defined, as the
-underlying boolean variable doesn't exist and so is neither true nor
-false. (There will also be a warning in the transcript.) See
-\sectionref{sec:glsunset} for further details.
-
-\item[{\pkgoptdef{indexcrossrefs}}] This is a boolean option.
-If \pkgoptfmt{true}, this will automatically index any
-cross-referenced entries that haven't been marked as used at
-the end of the document. Note that this necessarily adds to
-the overall document build time, especially if you have defined
-a large number of entries, so this defaults to \pkgoptfmt{false},
-but it will be automatically switched on if you use the \gloskey{see}
-or \gloskey{seealso} keys in any entries (unless
-\pkgopt[false]{autoseeindex}). To force it off, even if you use the
-\gloskey{see} or \gloskey{seealso} key, you
-need to explicitly set \pkgopt{indexcrossrefs} to \pkgoptfmt{false}.
-
-Note that \gls{bib2gls} can automatically find dependent
-entries when it parses the \texttt{.bib} source file.
-The \pkgopt{record} option automatically implements
-\pkgopt[false]{indexcrossrefs}.
-
-\item[{\pkgoptdef{autoseeindex}}]\label{opt:autoseeindex} (New to
-v1.16.) This is a boolean option. If true (default), this makes
-the \gloskey{see} and \gloskey{seealso} keys automatically index the
-cross-reference when an entry is defined. If false, the value
-of those keys will still be stored in their corresponding fields
-(and can be accessed using commands like \cs{glsxtrusesee} and
-\cs{glsxtruseseealso}) but cross-reference won't be automatically
-indexed.
-
-Note that the \pkgopt[only]{record} option automatically implements
-\pkgopt[false]{autoseeindex}.
-
-For example, if an entry is defined as
-\begin{verbatim}
-\newglossaryentry{foo}{name={foo},description={},see={bar,baz}}
-\end{verbatim}
-then with \texttt{autoseeindex=true}, this is equivalent to
-\begin{verbatim}
-\newglossaryentry{foo}{name={foo},description={}}
-\glssee{foo}{bar,baz}
-\glossariesextrasetup{indexcrossrefs=true}
-\GlsXtrSetField{foo}{see}{bar,baz}
-\end{verbatim}
-but with \texttt{autoseeindex=false}, this is equivalent to
-\begin{verbatim}
-\newglossaryentry{foo}{name={foo},description={}}
-\GlsXtrSetField{foo}{see}{bar,baz}
-\end{verbatim}
-Note that \pkgopt{indexcrossrefs} isn't automatically implemented
-by the presence of the \gloskey{see} key when \pkgopt{autoseeindex}
-is false.
+If you are using \app{bib2gls}, you may prefer to use the
+\resourceopt{post-description-dot} resource option.
-It's therefore possible to remove the cross-references from the
-location lists and set their position within the glossary style.
-
-Another method of preventing the automatic indexing is to
-define the entries before the external indexing files have been
-opened with \cs{makeglossaries}. Since the appropriate file isn't
-open, the information can't be written to it. This will need
-the package option \pkgoptfmt{seenoindex=ignore} (provided by
-\styfmt{glossaries}) to prevent an error occurring.
-
-\item[{\pkgoptdef{record}}]\label{opt:record}(New to v1.08.) This is
-a \meta{key}=\meta{value} option provided for the benefit of
-\gls{bib2gls} (see \sectionref{sec:bib2gls}). If you want to use
-\gls{bib2gls}, the recommended setting is \pkgopt[nameref]{record}
-if you have hyperlinks and \pkgopt[only]{record} if you don't have hyperlinks.
-
-The option may only be set in the preamble and can't be used after
-\cs{GlsXtrLoadResources}. If the value is missing
-\pkgopt[only]{record} is assumed. Permitted values:
-\begin{description}
-\item[\pkgoptfmt{off}] This is the default setting. The indexing
-is performed as normal using either \cs{makeglossaries}
-or \cs{makenoidxglossaries}. This setting implements \pkgopt[error]{undefaction}.
-
-\item[\pkgoptfmt{only}] The indexing (recording) is performed by
-\gls{bib2gls} (see \sectionref{sec:bib2gls}). Neither
-\cs{makeglossaries} nor \cs{makenoidxglossaries} is permitted.
-This setting implements \pkgopt[warn]{undefaction} and automatically
-loads the supplementary \sty{glossaries-extra-bib2gls} package.
-(There should be no need to explicitly load \sty{glossaries-extra-bib2gls}.)
+% PACKAGE OPTION: postdot
+\optiondef{postdot}
+This is a shortcut for \optval{nopostdot}{false}.
-The glossaries should be displayed using \cs{printunsrtglossary}
-(or \cs{printunsrtglossaries}).
+% PACKAGE OPTION: postpunc
+\optiondef{postpunc}
+This option redefines \gls{glspostdescription} to display the
+required punctuation. Note that this means the hook will no longer
+check for the \opt{nopostdot} conditional.
-The document build process is (assuming the file is called
-\texttt{myDoc.tex}):
-\begin{verbatim}
-pdflatex myDoc
-bib2gls myDoc
-pdflatex myDoc
-\end{verbatim}
-If you want letter groups you will need the \verb|--group|
-or \verb|-g| switch when invoking \gls{bib2gls}:
-\begin{verbatim}
-pdflatex myDoc
-bib2gls -g myDoc
-pdflatex myDoc
-\end{verbatim}
-
-Note that \pkgopt[only]{record} will prevent the \gloskey{see} from
-automatically implementing \cs{glssee}. (\gls{bib2gls} deals with the
-\gloskey{see} field.) You may explicitly use \cs{glssee} in the
-document, but \gls{bib2gls} will ignore the cross-reference if the
-\gloskey{see} field was already set for that entry.
+\begin{important}
+This option will have no effect if the \idx{glossarystyle} doesn't
+include \gls{glspostdescription}. (Use \opt{stylemods} to ensure that all the
+predefined styles that show the description have this hook added.)
+\end{important}
-The \pkgopt[only]{record} option will automatically set
-the \styfmt{glossaries} package's \pkgopt[none]{sort} option
-if available. (That option value was only introduced to
-\styfmt{glossaries} v4.30.)
-
-\item[\pkgoptfmt{nameref}] (New to v1.37 and requires \gls{bib2gls}
-v1.8+.) This option is like \pkgopt[only]{record} but additionally
-records the current label information given by \cs{@currentlabel}
-and \cs{@currentHref}, and provides a more reliable way of saving
-the \cs{theH}\meta{counter} for the given location. This option
-requires \sty{hyperref} otherwise it will fall back on the usual
-location records. Remember that \cs{@currentHref} is always globally
-updated whenever \cs{refstepcounter} is used, but \cs{@currentlabel}
-isn't. This can cause some undesired side-effects with some settings. Remember also that the \pkgopt{indexcounter} option
-increments the associated counter every time an entry is indexed,
-which affects this option. See \sectionref{sec:recordnameref} for
-further details.
+The \opt{postpunc} value may either be the required punctuation or
+one of the following keywords:
+
+\optionvaldef{postpunc}{dot}
+This redefines \gls{glspostdescription} to use a \idx{fullstop} but
+also adjusts the space factor. This isn't exactly the same as
+\optval{nopostdot}{false} since it removes the conditional from
+\gls{glspostdescription}.
+If you are using \app{bib2gls}, you may prefer to use the
+\resourceopt{post-description-dot} resource option.
+
+\optionvaldef{postpunc}{comma}
+This redefines \gls{glspostdescription} to a comma.
+
+\optionvaldef{postpunc}{none}
+This redefines \gls{glspostdescription} to do nothing. This isn't
+exactly the same as \optval{nopostdot}{true} since it removes the
+conditional from \gls{glspostdescription}.
+
+% PACKAGE OPTION: stylemods
+\optiondef{stylemods}
+Loads the \sty{glossaries-extra-stylemods} package (see
+\sectionref{sec:stylemods}), which patches the styles provided with
+the base \sty{glossaries} package so that they all use
+\gls{glspostdescription}. Extra hooks are also provided to make them
+easier to customize.
+The value may be one of the following:
+
+\optionvaldef{stylemods}{all}
+Loads all styles that are provided by both \sty{glossaries} and
+\sty{glossaries-extra}.
+
+\optionvaldef{stylemods}{default}
+Patches all the predefined styles that have been loaded, without
+loading any extra styles. This will typically be all the styles that
+are usually loaded by \sty{glossaries} (for example, \glostyle{list}
+and \glostyle{long}). Package options such as \opt{nolist} will
+alter which styles are loaded. In the case of \opt{nostyles}, no
+styles will be loaded, so none of them will be patched.
+
+\begin{information}
+It's pointless using both \opteqvalref{stylemods}{default} and
+\opt{nostyles}. Any \idx{glossarystyle} packages that are subsequently loaded
+won't be patched.
+\end{information}
+
+\optionvaldef{stylemods}{list}
+For each element \meta{tag} in \meta{list}, the corresponding package
+\styfmt{glossary\dhyphen\meta{tag}} will be loaded. You can use
+this in combination with \opt{nostyles} to only load the particular
+style package or packages that you require (without loading the full
+set of defaults). For example,
+\begin{codebox}
+\cmd{usepackage}[\opt{nostyles},\optval{stylemods}{\marg{bookindex,longextra}},
+ \optval{style}{bookindex}]\marg{\sty{glossaries-extra}}
+\end{codebox}
+This prevents the base \sty{glossaries} package from loading the
+default set of styles, but loads \sty{glossaries-extra-stylemods},
+\sty{glossary-bookindex} and \sty{glossary-longextra},
+and then sets the default style to \glostyle{bookindex}.
+
+\section{Loading Other Packages}
+\label{sec:otherpkgopts}
+
+Some options listed in other sections, such as the \opt{stylemods}
+and \opt{record} options, also load supplementary packages.
+
+% PACKAGE OPTION: prefix
+\optiondef{prefix}
+Loads the \sty{glossaries-prefix} package (if not already loaded).
+
+% PACKAGE OPTION: accsupp
+\optiondef{accsupp}
+Loads the \sty{glossaries-accsupp} package (if not already loaded).
+This option can only be used as a package option (not in
+\gls{glossariesextrasetup}) as \sty{glossaries-extra} needs to know
+whether or not to provide accessibility support while it's loading.
-This option is best used with \pkgopt[chapter]{counter} or
-\pkgopt[section]{counter} if you want the title included in the
-location list. If the indexing counter is the default
-\ctr{page}, only the location number is shown. Similarly for
-\pkgopt[equation]{counter} (or \pkgopt[true]{equations}).
+\begin{important}
+The \sty{glossaries-accsupp} package is still experimental and so
+accessibility features are liable to change.
+\end{important}
-\item[\pkgoptfmt{alsoindex}] Deprecated synonym of \pkgoptfmt{hybrid}.
+If you want to define styles that can interface with the
+accessibility support provided by \sty{glossaries-accsupp} use
+the \csfmt{glsaccess\meta{xxx}} type of commands instead of
+\csfmt{glsentry\meta{xxx}} (for example, \gls{glsaccesstext} instead of
+\gls{glsentrytext}). If \sty{glossaries-accsupp} hasn't been loaded
+those commands are equivalent (for example, \gls{glsaccesstext}
+just does \gls{glsentrytext}) but if it has been loaded, then the
+\csfmt{glsaccess\meta{xxx}} commands will add the accessibility
+information. See \sectionref{sec:accsupp} for further details.
-\item[\pkgoptfmt{hybrid}] This is a hybrid setting
-that uses \gls{bib2gls} to fetch entry information from
-\texttt{.bib} files, but uses \gls{makeindex} or \gls{xindy}
-to create the glossary files (which are input with \ics{printglossary}).
-Note that this requires a slower and more complicated build process
-(see below).
+\section{Entry Definitions, References and Indexing}
+\label{sec:refindexopts}
-This hybrid approach is provided for the rare instances
-where an existing \gls{xindy} rule or module is too complicated to convert to
-a \gls{bib2gls} rule but the entries need to be fetched from a
-\filetype{bib} file. There's no benefit in using this option with \gls{makeindex}.
+% PACKAGE OPTION: undefaction
+\optiondef{undefaction}
+This indicates what to do if an undefined \idx{glossary} entry is referenced.
\begin{important}
-Since it's redundant to make \gls{bib2gls} also sort, use \texttt{sort=none} in
-\cs{GlsXtrLoadResources} for a faster build.
+Undefined entries can't be picked up by any commands that iterate
+over a \idx{glossary} list. This includes \gls{forglsentries} and
+\gls{glsaddall}.
\end{important}
-This option must be used with \ics{makeglossaries} but not with
-its optional argument. This option should not be used with
-\cs{makenoidxglossaries}. You may need to change the transcript
-file used by \gls{bib2gls} to avoid a clash with the transcript file
-used by \gls{makeindex} or \gls{xindy}. (This can be done with
-\gls{bib2gls}['s] \verb|--log-file| or \verb|-t| option.)
+\optionvaldef{undefaction}{error}
+Produces an error message for undefined \idx{glossary} entries.
-Each glossary should be displayed using \cs{printglossary} (or
-\cs{printglossaries} for all of them). This option is expected to be
-used with \gls{bib2gls}'s \texttt{sort=none} setting and so
-\sty{glossaries-extra-bib2gls} is not automatically loaded.
+\optionvaldef{undefaction}{warn}
+Only produces a warning message for undefined \idx{glossary} entries. The
+place where the entry has been referenced will be marked with
+\idx{unknowntag} (as with undefined labels or citations). The
+unknown marker is produced with:
+\cmddef{glsxtrundeftag}
+This defaults to two question marks.
-The document build process is (assuming the file is called
-\texttt{myDoc.tex}):
-\begin{verbatim}
-pdflatex myDoc
-bib2gls myDoc
-pdflatex myDoc
-makeglossaries myDoc
-pdflatex myDoc
-\end{verbatim}
-Note that, in this case, it's redundant to call \gls{bib2gls} with the
-\verb|--group| or \verb|-g| switch as \gls{makeindex}/\gls{xindy}
-will insert the group heading information into the corresponding
-glossary file. (If you want \gls{bib2gls} to form the letter groups
-then this hybrid method is inappropriate.)
-\end{description}
-
-With the recording on (\pkgopt[only]{record},
-\pkgopt[nameref]{record} or \pkgopt[hybrid]{record}), any of the
-commands that would typically index the entry (such as \cs{gls},
-\cs{glstext} or \cs{glsadd}) will add a \cs{glsxtr@record} entry to
-the \texttt{.aux} file. \gls{bib2gls} can then read these lines to
-find out which entries have been used. (Remember that commands like
-\cs{glsentryname} don't index, so any use of these commands won't
-add a corresponding \cs{glsxtr@record} entry to the \texttt{.aux}
-file.) See \sectionref{sec:bib2gls} for further details.
-
-The hybrid method additionally performs the standard indexing action
-that's required for \gls{makeindex} or \gls{xindy} to work.
-
-\item[{\pkgoptdef{equations}}] (New to v1.37.) This option will
-cause the default location counter to automatically switch
-to \ctr{equation} when inside a numbered equation environment, such
-as \env{equation} or \env{align}. The counter can be explicitly
-overridden with \gloskey[glslink]{counter} in the optional
-arguments of commands like \cs{glslink} or \cs{gls} as usual.
+Note that \gls{ifglsused} will only display \idx{unknowntag} in the document text with
+\opteqvalref{undefaction}{warn} if the entry hasn't been defined, as the
+underlying boolean variable doesn't exist and so is neither true nor
+false. (There will also be a warning in the transcript.) You may
+prefer to use \gls{GlsXtrIfUnusedOrUndefined} instead. See
+\sectionref{sec:glsunset} for further details.
-\item[{\pkgoptdef{floats}}] (New to v1.37.) This option will
-cause the default location counter to automatically switch
-to the corresponding counter when inside a floating environment,
-such as \env{figure} or \env{table}. The counter can be explicitly
-overridden with \gloskey[glslink]{counter} in the optional
-arguments of commands like \cs{glslink} or \cs{gls} as usual.
-Remember that within floats it's the \cs{caption} command that actually uses
-\cs{refstepcounter}, so indexing before the caption will result in
-the wrong reference. The commands for use in captions and sections,
-such as \cs{glsfmttext} and \cs{glsfmtshort}, don't index. (See
-\sectionref{sec:headtitle}). You may
-want to consider using \cs{glsadd} after the caption (not before). For example:
-\begin{verbatim}
-\begin{figure}[htbp]
- \centering
- \includegraphics{example-image}
- \caption{Sample \glsfmttext{foobar} figure}
- \glsadd{foobar}
-\end{figure}
-\end{verbatim}
-
-\item[{\pkgoptdef{indexcounter}}] (New to v1.29.) This option (which
-doesn't take a value) is primarily intended for use with
-\gls{bib2gls} (v1.4+) and \sty{hyperref}. It can be used with
-\gls{makeindex} or \gls{xindy} but it will interfere with the
-\gls{numberlist} collation, so you won't have ranges and you'll have
-duplicate page numbers present (but each page number will link to
-the relevant part of the page where the indexing occurred). This
-option automatically implements \pkgopt[wrglossary]{counter}.
+If you want to write a custom command that needs to generate a
+warning or error for an undefined reference, you can use:
+\cmddef{glsxtrundefaction}
+This will produce the unknown marker if used within the document
+environment. Depending on the \opt{undefaction},
+\gls{glsxtrundefaction} will either create an error with the given
+\meta{message} and \meta{additional help} or will create a warning with the given
+\meta{message}.
+
+% PACKAGE OPTION: docdef
+\optiondef{docdef}
+This setting governs where \gls{newglossaryentry} can be used
+(preamble-only or anywhere before the first \idx{glossary} or
+anywhere within the document).
+
+Commands like \gls{newabbreviation} and \gls{glsxtrnewsymbol} that internally use
+\gls{newglossaryentry} are also governed by this option. Other
+commands, such as \gls{longnewglossaryentry} are always preamble-only.
+
+With just the base \sty{glossaries} package, \gls{newglossaryentry} is allowed in
+the \env{document} environment as long as you haven't used
+\gls{makenoidxglossaries}. There are, however, problems that can
+occur when entries are defined within the \env{document} environment
+(see the \sty{glossaries} documentation for further details).
+To encourage preamble-only use, the \sty{glossaries-extra} package
+prohibits the use of \gls{newglossaryentry} within the
+\env{document} environment by default, but if you really want this
+you can use this package option to allow it.
+
+\begin{information}
+Note that in the case of \app{bib2gls}, all entry data is originally
+defined in \ext{bib} files. The entry definitions (using commands
+like \gls{longnewglossaryentry} and \gls{newabbreviation}) are
+written to the \ext{glstex} files that are input in the preamble.
+\end{information}
+
+\optionvaldef{docdef}{false}
+Prohibits the use of \gls{newglossaryentry} within the
+\env{document} environment. All entries must be defined in the
+preamble.
+
+\optionvaldef{docdef}{true}
+Permits the use of \gls{newglossaryentry} in the \env{document}
+environment provided \gls{makenoidxglossaries} hasn't been used (as
+per the base \sty{glossaries} package).
+This will create a temporary \ext+{glsdefs} file that contains the
+entry definitions so that they can be available on the next \LaTeX\
+run at the beginning of the document to allow any \idxpl{glossary}
+in the front matter to display correctly.
+
+If all your \idxpl{glossary} occur at the end of the document, consider
+using \opteqvalref{docdef}{restricted} instead.
+
+\optionvaldef{docdef}{restricted}
+Permits the use of \gls{newglossaryentry} in the \env{document}
+environment provided the entry definitions all occur before the first
+\idx{glossary} is displayed.
+
+This avoids the need for the \ext+{glsdefs} file. You will still need to take
+care about any changes made to the category code of characters that are required
+by the \meta{key}\dequals\meta{value} mechanism (that is, the comma and
+equal sign) and any \app+{makeindex} or \app+{xindy} special character that
+occurs in the \gloskey{sort} key or label. If any of those
+characters are made active in the document (for example, through
+\sty{babel} shortcuts), then it can cause problems with the entry definition.
+
+This option will allow \gls{newglossaryentry} to be used in the document with
+\gls{makenoidxglossaries}, but note that \gls{longnewglossaryentry}
+remains a preamble-only command.
+
+With this option, if an entry appears in the glossary before
+it has been defined, an error will occur (or a warning if
+the \opteqvalref{undefaction}{warn} option is used). If you edit your
+document and either remove an entry or change its label, you may
+need to delete the document's temporary files (such as the
+\ext+{aux} and \ext+{gls} files).
+
+\optionvaldef{docdef}{atom}
+This option behaves like \opteqvalref{docdef}{restricted} but creates the
+\ext+{glsdefs} file for
+\href{https://atom.io/packages/autocomplete-glossaries}{atom's
+autocomplete support}. This file isn't input by
+\sty{glossaries-extra} and so associated problems with the use of
+this file are avoided, but it allows the autocomplete support to
+find the labels in the file.
\begin{important}
-This option works by incrementing \ctr{wrglossary} and
-adding \ics{label}. This can cause a problem if the indexing
-occurs in an \env{equation} environment as \sty{amsmath}
-forbids multiple occurrences of \cs{label} (resulting in the
-\qt{Multiple \cs{label}'s} error). It's best to change the counter
-to \ctr{page} or \ctr{equation} when in maths mode with this option.
-For example:
-\begin{verbatim}
-\renewcommand{\glslinkpresetkeys}{%
- \ifmmode \setkeys{glslink}{counter=equation}\fi}
-\renewcommand{\glsaddpresetkeys}{%
- \ifmmode \setkeys{glossadd}{counter=equation}\fi}
-\end{verbatim}
+A \dickimawhrefnofn{bugtracker.php?key=173}{bug fix} in \sty{glossaries} v4.47 has changed the format of the
+\ext+{glsdefs} file slightly.
\end{important}
-By default (with \sty{hyperref}), the page numbers in
-\glspl{numberlist} link back to the top of the relevant page
-(provided the format uses \cs{glshypernumber}). The
-\pkgopt{indexcounter} option is designed to link back to the place
-within the page where the indexing occurred. It does this by
-creating a new counter (called \ctr{wrglossary}) that's incremented
-with \cs{refstepcounter} every time an entry is indexed (but not via
-cross-referencing commands, such as \cs{glssee}). A \cs{label} is
-placed immediately after the increment command allowing the
-back-referenced to be obtained with \cs{pageref}. The location, as
-seen by the indexing application, is the value of the
-\ctr{wrglossary} counter but this value is substituted with the page
-reference when \gls{numberlist} is typeset. Since the counter is
-used by all entries and is incremented every time any indexing
-occurs, neither \gls{makeindex} nor \gls{xindy} can correctly
-collate the lists. For example, if the first term to be referenced
-is indexed three times on page~5 without any intervening terms then
-the actual locations obtained from \ctr{wrglossary} will be 1, 2 and
-3, which \gls{xindy} and \gls{makeindex} will try to form into the
-range 1--3, but they should actually all simply appear as page~5,
-whereas it can actually end up with 5--5. Conversely, a range may
-not be formed where it would naturally occur if just the \ctr{page}
-counter was used.
-
-Since \gls{bib2gls} is designed specifically to work with
-\styfmt{glossaries-extra}, \gls{bib2gls} (v1.4+) will check for
-\ctr{wrglossary} locations. If the default
-\texttt{--merge-wrglossary-records} is on, then any records for the
-same page for a given entry will be merged. In the above example
-with three references on page~5, only a single record for page~5 for
-that entry will be added to the \gls{numberlist} and it will link
-back to the first instance on that page. Whereas if you use the
-\texttt{--no-merge-wrglossary-records} switch, the \gls{numberlist}
-will contain three instance of page~5, with each linking to the
-corresponding place on that page. In both cases, consecutive pages
-can form ranges, but it may look strange in the second case.
-
-See the \gls{bib2gls} documentation for the
-\texttt{save-index-counter} resource option for more details.
-
-\item[{\pkgoptdef{docdef}}] This option governs the use of
-\cs{newglossaryentry}. It was originally a boolean option,
-but as from version 1.06, it can now take one of the following values (if
-the value is omitted, \pkgoptfmt{true} is assumed):
-
- \begin{itemize}
- \item {\pkgopt[false]{docdef}}: \ics{newglossaryentry} is not
- permitted in the \env{document} environment (default).
-
- \item {\pkgopt[true]{docdef}}: \cs{newglossaryentry} behaves as it
- does in the base \styfmt{glossaries} package. That is, where
- its use is permitted in the \env{document} environment, it
- uses the \texttt{.glsdefs} temporary file to store the entry
- definitions so that on the next \LaTeX\ run the entries are
- defined at the beginning of the \env{document} environment.
- This allows the entry information to be referenced in the glossary,
- even if the glossary occurs before \cs{newglossaryentry}.
- (For example, when the glossary is displayed in the front matter.)
- This method of saving the definitions for the next \LaTeX\ run
- has drawbacks that are detailed in the \styfmt{glossaries} user
- manual.
-
- Remember that if \cs{newglossaryentry} wouldn't be allowed
- in the \env{document} environment with the
- base \styfmt{glossaries} package, then it still won't
- be allowed with \pkgopt[true]{docdefs}.
- If your glossaries occur at the end of the document, consider using
- \pkgopt[restricted]{docdef} instead.
-
- \item {\pkgopt[restricted]{docdef}}: (new to version 1.06)
- \ics{newglossaryentry} is permitted in the \env{document}
- environment without using the \texttt{.glsdefs} file. This means
- that all entries must be defined before the glossary is displayed,
- but it avoids the complications associated with saving the
- entry details in a temporary file. You will still need to take
- care about any changes made to characters that are required
- by the \meta{key}=\meta{value} mechanism (that is, the comma and
- equal sign) and any \gls{makeindex} or \gls{xindy} character that
- occurs in the \gloskey{sort} key or label. If any of those
- characters are made active in the document, then it can cause
- problems with the entry definition. This option will allow
- \cs{newglossaryentry} to be used in the document with
- \cs{makenoidxglossaries}, but note that \cs{longnewglossaryentry}
- remains a preamble-only command.
-
- With this option, if an entry appears in the glossary before
- it has been defined, an error will occur (or a warning if
- the \pkgopt[warn]{undefaction} option is used.) If you edit your
- document and either remove an entry or change its label, you may
- need to delete the document's temporary files (such as the
- \texttt{.aux} and \texttt{.gls} files).
-
- \item {\pkgopt[atom]{docdef}}: (new to version 1.34)
- This option behaves like \pkgopt[restricted]{docdef} but creates the
- \texttt{.glsdefs} file for
- \href{https://atom.io/packages/autocomplete-glossaries}{atom's
- autocomplete support}. This file isn't input by
- \styfmt{glossaries-extra} and so associated problems with the use of
- this file are avoided, but it allows the autocomplete support to
- find the labels in the file. As with \pkgopt[restricted]{docdef},
- entries may be defined in the preamble or anywhere in the document,
- but they may only be referenced after they have been defined.
- Entries must be defined before the associated glossary is displayed.
-
- If you need a list of all entry labels for the use of an editor or
- helper script you may also want to consider the package options
- \pkgopt{writeglslabels} and \pkgopt{writeglslabelnames} provided by
- the base \sty{glossaries} package. Note that with these options
- and \pkgopt[atom]{docdef}, only the entry labels visible to \LaTeX\ can
- be saved. So if you are using \gls{bib2gls} you will only get the
- labels of the entries that are selected by \gls{bib2gls}.
-
- \end{itemize}
-
-The \styfmt{glossaries} package allows
-\cs{newglossaryentry} within the \env{document} environment (when
-used with \gls{makeindex} or \gls{xindy}) but the user manual warns
-against this usage. By default the \styfmt{glossaries-extra} package
-\emph{prohibits} this, only allowing definitions within the
-preamble. If you are really determined to define entries in the
-\env{document} environment, despite all the associated drawbacks,
-you can restore this with \pkgopt[true]{docdef}. Note that this
-doesn't change the prohibitions that the \styfmt{glossaries}
-package has in certain circumstances (for example, when using
-\qt{option~1}). See the \styfmt{glossaries} user manual for further
-details. A better option if document definitions are required
-is \pkgopt[restricted]{docdef}. Only use \pkgopt[true]{docdef}
-if document definitions are necessary and one or more of the
-glossaries occurs in the front matter.
-
-\begin{sloppypar}
-This option affects commands that internally use
-\cs{newglossaryentry}, such as \cs{newabbreviation}, but not
-the \qt{on-the-fly} commands described in \sectionref{sec:onthefly}.
-\end{sloppypar}
-
-\item[{\pkgoptdef{nomissingglstext}}] This is a boolean option.
-If true, this will suppress the warning written to the transcript
-and the warning text that will appear in the
-document if the external glossary files haven't been generated due
-to an incomplete document build. However, it's probably simpler
-just to fix whatever has caused the failure to build the external
-file or files.
-
-\item[{\pkgoptdef{abbreviations}}] This option has no value and can't
-be cancelled. If used,
-it will automatically create a new glossary with the label
-\texttt{abbreviations} and redefines \cs{glsxtrabbrvtype} to this
-label. (The file extensions are \filetype{glg-abr},
-\filetype{gls-abr} and \filetype{glo-abr}.)
-In addition, this option defines a shortcut command
-\begin{definition}[\DescribeMacro\printabbreviations]
-\cs{printabbreviations}\oarg{options}
-\end{definition}
-which is equivalent to
-\begin{alltt}
-\cs{printglossary}[type=\cs{glsxtrabbrvtype},\meta{options}]
-\end{alltt}
-If \sty{glossaries-extra-bib2gls} is also loaded then this option
-will additionally provide:
-\begin{definition}[\DescribeMacro\printunsrtabbreviations]
-\cs{printunsrtabbreviations}\oarg{options}
-\end{definition}
-which uses \ics{printunsrtglossary}.
+As with \opteqvalref{docdef}{restricted},
+entries may be defined in the preamble or anywhere in the document,
+but they may only be referenced after they have been defined.
+Entries must be defined before the associated glossary is displayed.
+
+If you need a list of all entry labels for the use of an editor or
+helper script you may also want to consider the package options
+\opt{writeglslabels} and \opt{writeglslabelnames} provided by the
+base \sty{glossaries} package. Note that with these options and
+with \opteqvalref{docdef}{atom}, only the entry labels that are visible
+to \LaTeX\ can be saved. So if you are using \app{bib2gls} you will
+only get the labels of the entries that have already been selected by
+\app{bib2gls}. The \ext+{bib} files can be found by parsing the
+\ext+{aux} file for \gls{glsxtr@resource} (listed in the \resourceopt{src}
+option or \gls{jobname}\filefmt{.bib} if \resourceopt{src} is
+missing).
+
+% PACKAGE OPTION: shortcuts
+\optiondef{shortcuts}
+Unlike the base \sty{glossaries} package
+option of the same name, this option isn't boolean but has multiple
+values.
-The title of the new glossary is given by
-\begin{definition}[\DescribeMacro\abbreviationsname]
-\cs{abbreviationsname}
-\end{definition}
-If this command is already defined, it's left unchanged. Otherwise
-it's defined to \qt{Abbreviations} if \sty{babel} hasn't been loaded
-or \cs{acronymname} if \sty{babel} has been loaded. However, if
-you're using \sty{babel} it's likely you will need to change this.
-(See \sectionref{sec:lang} for further details.)
+\begin{information}
+Multiple invocations of the \opt{shortcuts} option
+\emph{within the same option list} will override each other.
+Since these options define commands, the action can't be undone with
+a later \gls{glossariesextrasetup}.
+\end{information}
+
+\optionvaldef{shortcuts}{ac}
+Set the shortcut commands provided by the base \sty{glossaries} package for
+acronyms (such as \gls{ac}) but use the \sty{glossaries-extra}
+abbreviation commands, such as \gls{glsxtrshort} and
+\gls{glsxtrlong}, instead of the analogous base commands, such as
+\gls{acrshort} and \gls{acrlong}. See \sectionref{sec:abbrshortcuts}
+for further details.
-\begin{important}
-If you don't use the \pkgopt{abbreviations} package option,
-the \cs{abbreviationsname} command won't be defined (unless it's
-defined by an included language file).
-\end{important}
+\optionvaldef{shortcuts}{abbreviations}
+Sets the abbreviation shortcuts (see \sectionref{sec:abbrshortcuts}).
+This setting doesn't switch on the acronym shortcuts provided by the
+base \sty{glossaries} package.
-If the \pkgopt{abbreviations} option is used and the
-\pkgopt{acronym} option provided by the \styfmt{glossaries}
-package hasn't been used, then \ics{acronymtype}
-will be set to \ics{glsxtrabbrvtype} so that acronyms defined with
-\ics{newacronym} can be added to the list of abbreviations. If you
-want acronyms in the \texttt{main} glossary and other abbreviations in the
-\texttt{abbreviations} glossary then you will need to redefine
-\cs{acronymtype} to \texttt{main}:
-\begin{verbatim}
-\renewcommand*{\acronymtype}{main}
-\end{verbatim}
-
-Note that there are no analogous options to the \styfmt{glossaries}
-package's \pkgopt{acronymlists} option (or associated commands)
-as the abbreviation mechanism is handled differently with
-\styfmt{glossaries-extra}.
+\optionvaldef{shortcuts}{abbr}
+Synonym for \opteqvalref{shortcuts}{abbreviations}.
-\item[{\pkgoptdef{symbols}}] This is passed to \styfmt{glossaries} but
-will additionally define
-\begin{definition}[\DescribeMacro\glsxtrnewsymbol]
-\cs{glsxtrnewsymbol}\oarg{options}\marg{label}\marg{symbol}
-\end{definition}
-which is equivalent to
-\begin{alltt}
-\cs{newglossaryentry}\marg{label}\{name=\marg{symbol},
- sort=\marg{label},type=symbols,category=symbol,\meta{options}\}
-\end{alltt}
-Note that the \gloskey{sort} key is set to the \meta{label}
-not the \meta{symbol} as the symbol will likely contain commands.
+\optionvaldef{shortcuts}{other}
+Implements the other (non-abbreviation) shortcut commands:
+\cmddef*{newentry}
+A synonym for \gls{newglossaryentry}.
-If \sty{glossaries-extra-bib2gls} is also loaded then this option
-will additionally provide:
-\begin{definition}[\DescribeMacro\printunsrtsymbols]
-\cs{printunsrtsymbols}\oarg{options}
-\end{definition}
-which uses \ics{printunsrtglossary}.
-
-\item[{\pkgoptdef{numbers}}] This is passed to \styfmt{glossaries} but
-will additionally define
-\begin{definition}[\DescribeMacro\glsxtrnewnumber]
-\cs{glsxtrnewnumber}\oarg{options}\marg{number}
-\end{definition}
-which is equivalent to
-\begin{alltt}
-\cs{newglossaryentry}\marg{label}\{name=\marg{number},
- sort=\marg{label},type=numbers,category=number,\meta{options}\}
-\end{alltt}
+\cmddef*{newsym}
+A synonym for \gls{glsxtrnewsymbol} (provided that the \opt{symbols}
+package option is also used).
-If \sty{glossaries-extra-bib2gls} is also loaded then this option
-will additionally provide:
-\begin{definition}[\DescribeMacro\printunsrtnumbers]
-\cs{printunsrtnumbers}\oarg{options}
-\end{definition}
-which uses \ics{printunsrtglossary}.
-
-\item[{\pkgoptdef{acronyms} (or \pkgoptdef{acronym})}] This is
-passed to \styfmt{glossaries} but if
-\sty{glossaries-extra-bib2gls} is also loaded then this option
-will additionally provide:
-\begin{definition}[\DescribeMacro\printunsrtacronyms]
-\cs{printunsrtacronyms}\oarg{options}
-\end{definition}
-which uses \ics{printunsrtglossary}.
+\cmddef*{newnum}
+A synonym for \gls{glsxtrnewnumber} (provided that the \opt{numbers}
+package option is also used).
-\begin{important}
-This option defines a new glossary with the label \texttt{acronym}
-not \texttt{acronyms}. You may find it easier to reference it
-with the command \ics{acronymtype}.
-\end{important}
+\optionvaldef{shortcuts}{acother}
+Implements \opteqvalref{shortcuts}{ac} and \optval{shortcuts}{other}.
-\item[{\pkgoptdef{index}}] This is
-passed to \styfmt{glossaries} but if
-\sty{glossaries-extra-bib2gls} is also loaded then this option
-will additionally provide:
-\begin{definition}[\DescribeMacro\printunsrtindex]
-\cs{printunsrtindex}\oarg{options}
-\end{definition}
-which uses \ics{printunsrtglossary}.
+\optionvaldef{shortcuts}{abother}
+Implements \opteqvalref{shortcuts}{abbreviations} and \optval{shortcuts}{other}.
-\item[{\pkgoptdef{shortcuts}}] Unlike the \styfmt{glossaries} package
-option of the same name, this option isn't boolean but has multiple
-values:
- \begin{itemize}
- \item \pkgopt[acronyms]{shortcuts} (or \pkgopt[acro]{shortcuts}):
- set the shortcuts provided by the \styfmt{glossaries} package for
- acronyms (such as \cs{ac}). Note that the short and long forms don't
- use \cs{glsxtrshort} and \cs{glsxtrlong} but use the original
- \cs{acrshort} and \cs{acrlong}, which don't recognise multiple
- abbreviation styles. The better option with \styfmt{glossaries-extra}
- is \pkgopt[ac]{shortcuts}.
-
- \item \pkgopt[ac]{shortcuts}:
- set the shortcuts provided by the \styfmt{glossaries} package for
- acronyms (such as \cs{ac}) but uses the \styfmt{glossaries-extra}
- interface (such as \cs{glsxtrshort} rather than \cs{acrshort}).
- In this case \cs{ac} is defined as \cs{cgls} rather than
- \cs{gls}.
-
- \item \pkgopt[abbreviations]{shortcuts} (or
- \pkgopt[abbr]{shortcuts}):
- set the abbreviation shortcuts provided by \styfmt{glossaries-extra}. (See
- \sectionref{sec:abbrshortcuts}.) These settings don't switch on the
- acronym shortcuts provided by the \styfmt{glossaries} package.
-
- \item \pkgopt[other]{shortcuts}: set the \qt{other}
- shortcut commands, but not the shortcut commands for abbreviations
- or the acronym shortcuts provided by \styfmt{glossaries}.
- The \qt{other} shortcuts are:
- \begin{itemize}
- \item \ics{newentry} equivalent to \ics{newglossaryentry}
- \item \ics{newsym} equivalent to \ics{glsxtrnewsymbol} (see the
- \pkgopt{symbols} option).
- \item \ics{newnum} equivalent to \ics{glsxtrnewnumber} (see the
- \pkgopt{numbers} option).
- \end{itemize}
-
- \item \pkgopt[all]{shortcuts} (or \pkgopt[true]{shortcuts}):
- implements \pkgopt[ac]{shortcuts}, \pkgopt[abbreviations]{shortcuts}
- and \pkgopt[other]{shortcuts}.
-
- \item \pkgopt[none]{shortcuts} (or \pkgopt[false]{shortcuts}):
- don't define any of the shortcut commands (default).
-
- \end{itemize}
-
-Note that multiple invocations of the \pkgopt{shortcuts} option
-\emph{within the same option list} will override each other.
+\optionvaldef{shortcuts}{all}
+Implements \opteqvalref{shortcuts}{ac}, \opteqvalref{shortcuts}{abbreviations}
+and \optval{shortcuts}{other}.
-\end{description}
+\optionvaldef{shortcuts}{acronyms}
+Sets the shortcuts provided by the base \sty{glossaries} package for
+acronyms (such as \gls{ac}). See the \sty{glossaries} package
+documentation for further details.
-After the \styfmt{glossaries-extra} package has been loaded, you can
-set available options using
-\begin{definition}[\DescribeMacro\glossariesextrasetup]
-\cs{glossariesextrasetup}\marg{options}
-\end{definition}
-The \pkgopt{abbreviations} and \pkgopt{docdef} options may only be
-used in the preamble. Additionally, \pkgopt{docdef} can't be used
-after \ics{makenoidxglossaries}.
-
-\chapter{Modifications to Existing Commands and Styles}
-\label{sec:modifications}
-
-\section{Defining Entries}
-\label{sec:definingentries}
-
-The \styfmt{glossaries} package provides \ics{nopostdesc}
-which may be used in the \gloskey{description} to suppress
-the post-description hook. The \styfmt{glossaries-extra} package
-provides another command
-\begin{definition}[\DescribeMacro\glsxtrnopostpunc]
-\cs{glsxtrnopostpunc}
-\end{definition}
-which has a similar function but only suppresses the
-post-description punctuation. It doesn't suppress the use of
-\cs{glsxtrpostdescription} which allows the use of
-category-dependent post-description hooks. (Note that the
-punctuation, which is in the original base hook \cs{glspostdescription},
-comes after the extended post-description hook
-\cs{glsxtrpostdescription} not before.) The post-description hook
-can counter-act the effect of \cs{glsxtrnopostpunc} using
-\begin{definition}[\DescribeMacro\glsxtrrestorepostpunc]
-\cs{glsxtrrestorepostpunc}
-\end{definition}
-These commands have no effect outside of the glossary (except with
-standalone entries that use \cs{glsxtractivatenopost} and
-\cs{glspostdescription}, see \sectionref{sec:glossentry}).
+Note that the short and long forms (\gls{acs} and \gls{acl}) don't
+use \gls{glsxtrshort} and \gls{glsxtrlong} but use the original
+\gls{acrshort} and \gls{acrlong}, which aren't compatible with the
+\sty{glossaries-extra} abbreviation mechanism. The better option is
+to use \opteqvalref{shortcuts}{ac}.
-The commands used by \styfmt{glossaries} to automatically produce an
-error if an entry is undefined (such as \ics{glsdoifexists}) are
-changed to take the \pkgopt{undefaction} option into account.
+\begin{information}
+Don't use \opteqvalref{shortcuts}{acronyms} unless you have reverted \gls{newacronym} back to the base
+\sty{glossaries} package's acronym mechanism. See \sectionref{sec:acrorevert}
+for further details.
+\end{information}
-The \cs{newglossaryentry} command has three new keys:
-\begin{itemize}
-\item \gloskey{category}, which sets the category label for the given
-entry. By default this is \texttt{general}. See
-\sectionref{sec:categories} for further information about
-categories.
-\item \gloskey{alias}, which allows an entry to be alias to another
-entry. See \sectionref{sec:alias} for further details.
-\item \gloskey{seealso}, which performs much like \gloskey{see}, but
-allows for separate \qt{see} and \qt{see also} treatment.
-See \sectionref{sec:see} for further details.
-\end{itemize}
-This apply to all entry defining commands (such as
-\cs{newabbreviation}).
-
-The test file \nolinkurl{example-glossaries-xr.tex} contains
-dummy entries with a mixture of \gloskey{see}, \gloskey{alias}
-and \gloskey{seealso} keys for use with minimal working examples.
-There are also \nolinkurl{example-glossaries-*.bib} files that
-correspond to each \nolinkurl{example-glossaries-*.tex} file
-for testing \gls{bib2gls}.
-
-The \cs{longnewglossaryentry} command now has a starred version
-(as from v1.12) that doesn't automatically insert
-\begin{verbatim}
-\leavevmode\unskip\nopostdesc
-\end{verbatim}
-at the end of the description field.
-\begin{definition}[\DescribeMacro\longnewglossaryentry]
-\cs{longnewglossaryentry}*\marg{label}\marg{options}\marg{description}
-\end{definition}
-The \gloskey{descriptionplural} key is left unset unless explicitly
-set in \meta{options}.
-
-The unstarred version no longer hard-codes the above code (which
-removes trailing space and suppresses the post-description hook) but instead
-uses:
-\begin{definition}[\DescribeMacro\glsxtrpostlongdescription]
-\cs{glsxtrpostlongdescription}
-\end{definition}
-This can be redefined to allow the post-description hook to work
-but retain the \cs{unskip} part if required.
-For example:
-\begin{verbatim}
-\renewcommand*{\glsxtrpostlongdescription}{\leavevmode\unskip}
-\end{verbatim}
-This will discarded unwanted trailing space at the end of the description
-but won't suppress the post-description hook.
-
-The unstarred version also alters the base \sty{glossaries} package's
-treatment of the \gloskey{descriptionplural} key. Since a
-plural description doesn't make much sense for multi-paragraph
-descriptions, the default behaviour with
-\sty{glossaries-extra}'s
-\cs{longnewglossaryentry} is to simply leave the plural description
-unset unless explicitly set using the \gloskey{descriptionplural}
-key. The \styfmt{glossaries.sty} version of this command sets the description's
-plural form to the same as the singular.\footnote{The
-\gloskey{descriptionplural} key is a
-throwback to the base package's original acronym mechanism before the introduction of
-the \gloskey{long} and \gloskey{short} keys, where the long form was
-stored in the \gloskey{description} field and the short form was stored in the
-\gloskey{symbol} field.}
-
-Note that this modified unstarred version doesn't append
-\cs{glsxtrpostlongdescription} to the description's plural form.
-
-The \ics{newterm} command (defined through the \pkgopt{index} package
-option) is modified so that the category defaults to \category{index}.
-The \ics{newacronym} command is modified to use the new abbreviation
-interface provided by \styfmt{glossaries-extra}.
-(See \sectionref{sec:abbreviations}.)
-
-The \cs{makeglossaries} command now has an optional argument.
-\begin{definition}[\DescribeMacro\makeglossaries]
-\cs{makeglossaries}\oarg{list}
-\end{definition}
-If \meta{list} is empty, \cs{makeglossaries} behaves as per
-its original definition in the \styfmt{glossaries} package,
-otherwise \meta{list} can be a comma-separated list of glossaries
-that need processing with an external indexing application.
-
-This command is not permitted with the \pkgopt[only]{record}
-package option. Without the optional argument, it's required
-with \pkgopt[hybrid]{record}. With the optional argument,
-it's only permitted with the default \pkgopt[off]{record}.
-
-It should then be possible to use \cs{printglossary} for those
-glossaries listed in \meta{list} and \cs{printnoidxglossary}
-for the other glossaries. (See the accompanying file
-\texttt{sample-mixedsort.tex} for an example.)
+\optionvaldef{shortcuts}{acro}
+Synonym for \opteqvalref{shortcuts}{acronyms}.
-\begin{important}
-If you use the optional argument \meta{list}, you can't define
-entries in the document (even with the \pkgopt{docdef} option).
-\end{important}
+\optionvaldef{shortcuts}{true}
+This setting is provided by the base \sty{glossaries} package. With
+\sty{glossaries-extra} it's equivalent to \opteqvalref{shortcuts}{all}.
-You will need at least version 2.20 of \gls{makeglossaries} or at
-least version 1.3 of the Lua alternative \gls{makeglossaries-lite.lua} (both distributed
-with \styfmt{glossaries} v4.27) to allow for this use of
-\cs{makeglossaries}\oarg{list}. Alternatively, use the
-\pkgopt{automake} option.
+\optionvaldef{shortcuts}{false}
+This setting is provided by the base \sty{glossaries} package. With
+\sty{glossaries-extra} it's equivalent to \opteqvalref{shortcuts}{none}.
-\section{Entry Indexing}
-\label{sec:wrglossary}
+% PACKAGE OPTION: indexcrossrefs
+\optiondef{indexcrossrefs}
+This is a boolean option that governs whether or not to
+automatically index any cross-referenced entries that haven't been
+marked as used at the end of the document. These are entries that are identified
+in one of the cross-referencing fields (\gloskey{see} and \gloskey{seealso}) of
+another used entry as opposed to entries that have the cross-referencing fields set.
-As from version 1.31, there is a new command like \cs{glsadd}
-where the mandatory argument is a comma-separated list
-of labels:
-\begin{definition}[\DescribeMacro\glsaddeach]
-\cs{glsaddeach}\oarg{options}\marg{list}
-\end{definition}
-This simply iterates over \meta{list} and does
-\cs{glsadd}\oarg{options}\marg{label} for each entry in the list.
-
-As from version 1.37, you can make commands like \cs{gls} or
-\cs{glslink} automatically use \cs{glsadd} with specific options
-when a given format is used (identified with
-\texttt{format=\marg{format}} in the optional argument of the
-corresponding \cs{gls}, \cs{glslink} etc).
-\begin{definition}[\DescribeMacro\GlsXtrAutoAddOnFormat]
-\cs{GlsXtrAutoAddOnFormat}\oarg{label}\marg{format list}\marg{glsadd options}
-\end{definition}
-The optional argument \meta{label} defaults to \cs{glslabel} and
-indicates the label to use in \cs{glsadd} and so needs to be
-expandable. The \meta{format list} is a comma-separated list
-of format values that will trigger the automated adding. The
-\meta{glsadd options} are the options to pass to \cs{glsadd} with
-\texttt{format=\marg{format}} prepended to the list.
+Since entries with the \gloskey{alias} key are intended as synonyms for another
+term, the target is expected to be indexed so entries with the \gloskey{alias}
+key set aren't affected by this option.
-For example, with:
-\begin{verbatim}
-\GlsXtrAutoAddOnFormat{hyperbf}{counter=chapter}
-\end{verbatim}
-then \verb|\gls[format=hyperbf]{sample}| will be equivalent to
-\begin{verbatim}
-\glsadd[format=hyperbf,counter=chapter]{sample}\gls[format=hyperbf]{sample}
-\end{verbatim}
-Note that the explicit range markers will prevent a match
-unless you include them in \meta{format list} (in which case, be
-sure to add both the start and end formats).
+For example:
+\begin{codebox}
+\gls{newglossaryentry}\marg{courgette}\marg{\gloskeyval{name}{courgette},
+ \gloskeyval{description}{small vegetable marrow}}
+\gls{newglossaryentry}\marg{marrow}\marg{\gloskeyval{name}{marrow},
+ \gloskeyval{description}{long gourd with green skin},
+ \gloskeyval{seealso}{courgette}}
+\end{codebox}
+Suppose that \qt{marrow} is indexed (so that it appears in the glossary with the
+cross-reference to \qt{courgette}) but if courgette isn't indexed anywhere in
+the document (using commands like \gls{gls} or \gls{glsadd}) then there will be
+a broken cross-reference in the marrow \idx{locationlist} pointing to courgette,
+which doesn't appear in the glossary. With \opteqvalref{indexcrossrefs}{true},
+the courgette entry will be indexed at the end of the document using \gls{glsadd} with
+\glsoptval{format}{glsxtrunusedformat}, which corresponds to the command
+\gls{glsxtrunusedformat}.
+
+Note that this special format \gls{glsxtrunusedformat} simply does \gls{unskip}
+and ignores its argument, which creates a blank location.
+If any of the cross-referenced entries have been indexed but haven't been marked
+as used (for example, with \gls{glsadd}) then this will cause a spurious comma in the
+\idx{locationlist}. This is a limitation of the way that \app+{makeindex} and
+\app+{xindy} work as they are general purpose indexing applications which require
+locations. If you have entries with cross-references, you may want to consider
+switching to \app{bib2gls} instead.
+
+\begin{information}
+Note that \app{bib2gls} can automatically find dependent
+entries when it parses the \ext{bib} source file, so
+the \opt{record} option automatically implements
+\opteqvalref{indexcrossrefs}{false}.
+\end{information}
+
+This function is implemented by code added to the end document hook
+that determines whether or not to use the command
+\gls{glsxtraddallcrossrefs}. This command iterates over all entries
+in all glossaries, which adds to the overall document build time,
+especially if you have defined a large number of entries, so this
+defaults to \opteqvalref{indexcrossrefs}{false}, but it will be
+automatically switched on if you use the \gloskey{see} or
+\gloskey{seealso} keys in any entries. See also \sectionref{sec:xr}.
+
+\optionvaldef{indexcrossrefs}{true}
+Enables this setting.
+
+\optionvaldef{indexcrossrefs}{false}
+Disables this setting even if the \gloskey{see} or \gloskey{seealso}
+key is present in any entries.
+
+% PACKAGE OPTION: autoseeindex
+\optiondef{autoseeindex}
+This is a boolean option that governs whether or not the
+\gloskey{see} and \gloskey{seealso} keys should automatically index the
+cross-reference when an entry is defined (see \sectionref{sec:xr}).
+
+With the base
+\sty{glossaries} package, the \gloskey{see} key was provided as a
+shortcut for \gls{glssee}. For example:
+\begin{codebox}
+\gls{newglossaryentry}\marg{courgette}\marg{\gloskeyval{name}{courgette},
+ \gloskeyval{description}{small vegetable marrow}}
+\gls{newglossaryentry}\marg{zucchini}\marg{\gloskeyval{name}{zucchini},
+ \gloskeyval{description}{},
+ \gloskeyval{see}{courgette}}
+\end{codebox}
+is equivalent to:
+\begin{codebox}
+\gls{newglossaryentry}\marg{courgette}\marg{\gloskeyval{name}{courgette},
+ \gloskeyval{description}{small vegetable marrow}}
+\gls{newglossaryentry}\marg{zucchini}\marg{\gloskeyval{name}{zucchini},
+ \gloskeyval{description}{}}
+\gls{glssee}\marg{zucchini}\marg{courgette}
+\end{codebox}
+This was designed for documents where only entries that are actually
+used in the document are defined and ensures that the
+cross-reference is included in the \idx{glossary}, even though it may not
+be referenced anywhere in the document. However, it becomes
+problematic if neither entry is required in the document.
+
+The \sty{glossaries-extra} package modifies the action of the
+\gloskey{see} key so that it also saves the value and will only
+perform the automated \gls{glssee} if
+\opteqvalref{autoseeindex}{true}. Similarly for the \gloskey{seealso} key.
+
+\begin{information}
+Note that the \opt{record} option automatically implements
+\opteqvalref{autoseeindex}{false} as the corresponding action can be
+implemented with \app{bib2gls}['s] \resourceopt{selection} option.
+\end{information}
+
+\optionvaldef{autoseeindex}{true}
+Enables automatic indexing using \gls{glssee} for the \gloskey{see}
+key (as per the base \sty{glossaries} package) and \gls{glsxtrindexseealso}
+for the \gloskey{seealso} key.
-Here's another example:
-\begin{verbatim}
-\GlsXtrAutoAddOnFormat[dual.\glslabel]{hyperbf}{}
-\end{verbatim}
-In this case \verb|\gls[format=hyperbf]{sample}| will now be
-equivalent to:
-\begin{verbatim}
-\glsadd[format=hyperbf]{dual.sample}\gls[format=hyperbf]{sample}
-\end{verbatim}
+For example, if an entry is defined as
+\begin{codebox}
+\gls{newglossaryentry}\marg{foo}\marg{\gloskeyval{name}{foo},
+ \gloskeyval{description}{},\gloskeyval{see}{bar,baz}}
+\end{codebox}
+then, with \opteqvalref{autoseeindex}{true} and the default
+\opt{indexcrossrefs} setting, this is equivalent to
+\begin{codebox}
+\gls{newglossaryentry}\marg{foo}\marg{\gloskeyval{name}{foo},\gloskeyval{description}{}}
+\gls{glssee}\marg{foo}\marg{bar,baz}
+\gls{glossariesextrasetup}\marg{\opteqvalref{indexcrossrefs}{true}}
+\gls{GlsXtrSetField}\marg{foo}\marg{see}\marg{bar,baz}
+\end{codebox}
+
+\optionvaldef{autoseeindex}{false}
+The value of the \gloskey{see} and \gloskey{seealso} keys will
+be stored in their corresponding fields (and can be accessed using
+commands like \gls{glsxtrusesee} and \gls{glsxtruseseealso}) but
+the cross-reference won't be automatically \indexed.
+
+\begin{information}
+Note that \opt{indexcrossrefs} isn't automatically implemented
+by the presence of the \gloskey{see} key when \opt{autoseeindex}
+is false.
+\end{information}
-\begin{important}
-\cs{GlsXtrAutoAddOnFormat} is not applied to \cs{glsadd}
-as it could cause an infinite loop.
-\end{important}
+For example, if an entry is defined as
+\begin{codebox}
+\gls{newglossaryentry}\marg{foo}\marg{\gloskeyval{name}{foo},
+ \gloskeyval{description}{},\gloskeyval{see}{bar,baz}}
+\end{codebox}
+then, with \opteqvalref{autoseeindex}{false} and the default
+\opt{indexcrossrefs} setting, this is equivalent to
+\begin{codebox}
+\gls{newglossaryentry}\marg{foo}\marg{\gloskeyval{name}{foo},
+ \gloskeyval{description}{}}
+\gls{GlsXtrSetField}\marg{foo}\marg{see}\marg{bar,baz}
+\end{codebox}
+
+It's therefore possible with this option to remove the cross-references from the
+location lists and set their position within the \idx{glossarystyle}.
+
+Another method of preventing the automatic indexing is to
+define the entries before the external indexing files have been
+opened with \gls{makeglossaries}. Since the appropriate file isn't
+open, the information can't be written to it. This will need
+the package option \optval{seenoindex}{ignore} to prevent an error occurring.
+
+% PACKAGE OPTION: record
+\optiondef{record}
+This setting indicates whether or not \app{bib2gls} is required.
+
+\begin{information}
+This option can only be set in the preamble and can't be used after
+\gls{GlsXtrLoadResources} or \gls{glsxtrresourcefile}.
+\end{information}
+
+With the recording setting on (\opteqvalref{record}{only},
+\opteqvalref{record}{nameref} or \opteqvalref{record}{hybrid}), any of the
+commands that would typically index the entry (such as \gls{gls},
+\gls{glstext} or \gls{glsadd}) will add a \record\ to
+the \ext{aux} file. \app{bib2gls} can then read this information to
+find out which entries have been used. (Remember that commands like
+\gls{glsentryname} don't index, so any use of these commands won't
+add a corresponding \record.) See \sectionref{sec:bib2gls} for further details.
-The \styfmt{glossaries-extra} package provides extra keys for
-commands like \cs{gls} and \cs{glstext}:
-\begin{description}
-\item[{\gloskey[glslink]{noindex}}] This is a boolean key. If true,
-this suppresses the indexing. (That is, it prevents \cs{gls} or
-whatever from adding a line to the external glossary file.)
-This is more useful than the \pkgopt{indexonlyfirst} package option
-provided by \styfmt{glossaries}, as the \gls{firstuse} might not be the most
-pertinent use. (If you want to apply \pkgopt{indexonlyfirst}
-to selected entries, rather than all of them, you can use
-the \catattr{indexonlyfirst} attribute, see
-\sectionref{sec:categories} for further details.)
-Note that the \gloskey[glslink]{noindex} key isn't available
-for \ics{glsadd} (and \ics{glsaddall}) since the whole purpose
-of that command is to index an entry.
-
-\item[{\gloskey[glslink]{wrgloss}}] (New to v1.14.)
-This is may only take the
-values \optfmt{before} or \optfmt{after}. By default, commands
-that both index and display link text (such as \cs{gls},
-\cs{glstext} and \cs{glslink}), perform the indexing before
-the link text as the indexing creates a whatsit that can cause
-problems if it occurs after the link text. However, it may
-be that in some cases (such as long phrases) you may actually
-want the indexing performed after the link text. In this
-case you can use \texttt{wrgloss=after} for specific
-instances. Note that this option doesn't
-have an effect if the indexing has been suppressed through
-other settings (such as \gloskey[glslink]{noindex}).
-
-The default value is set up using
-\begin{definition}[\DescribeMacro\glsxtrinitwrgloss]
-\cs{glsxtrinitwrgloss}
-\end{definition}
-which is defined as:
-\begin{verbatim}
-\newcommand*{\glsxtrinitwrgloss}{%
- \glsifattribute{\glslabel}{wrgloss}{after}%
- {%
- \glsxtrinitwrglossbeforefalse
- }%
- {%
- \glsxtrinitwrglossbeforetrue
- }%
-}
-\end{verbatim}
-This sets the conditional
-\begin{definition}
-\ics{ifglsxtrinitwrgloss}
-\end{definition}
-which is used to determine where to perform the indexing.
-
-This means you can set the \catattr{wrgloss}
-attribute to \optfmt{after} to automatically use this as
-the default for entries with that category attribute. (Note that
-adding \gloskey[glslink]{wrgloss} to the default options
-in \ics{GlsXtrSetDefaultGlsOpts} will override
-\cs{glsxtrinitwrgloss}.)
-
-\item[{\gloskey[glslink]{hyperoutside}}] (New to v1.21.) This is a
-boolean key. The default is \texttt{hyperoutside=true}, which puts
-the hyperlink outside \cs{glstextformat}, so that commands like
-\cs{gls} will effectively do
-\begin{alltt}
-\cs{hyperlink}\marg{target}\{\cs{glstextformat}\marg{link text}\}
-\end{alltt}
-This is the same behaviour as with the base \styfmt{glossaries}
-package. With \texttt{hyperoutside=false}, \cs{hyperlink} is placed
-inside the argument of \cs{glstextformat}:
-\begin{alltt}
-\cs{glstextformat}\{\cs{hyperlink}\marg{target}\marg{link text}\}
-\end{alltt}
-You can use the \catattr{hyperoutside} category attribute to set
-the default for a given category. This can be combined
-with the use of the \catattr{textformat} attribute to counteract
-any interference caused by \cs{hyperlink}.
-For example:
-\begin{verbatim}
-\glssetcategoryattribute{mathrelation}{hyperoutside}{false}
-\end{verbatim}
-will set \texttt{hyperoutside=false} for all entries that are
-assigned to the category \texttt{mathrelation} and
-\begin{verbatim}
-\glssetcategoryattribute{mathrelation}{textformat}{mathrel}
-\end{verbatim}
-will use \cs{mathrel} instead of \cs{glstextformat} resulting in:
-\begin{alltt}
-\cs{mathrel}\{\cs{hyperlink}\marg{target}\marg{link text}\}
-\end{alltt}
-for entries with the \gloskey{category} key set to
-\texttt{mathrelation}.
-
-\item[{\gloskey[glslink]{textformat}}] This key must have a
-control sequence name as its value. The command formed from
-this name must exist and must take one argument. (Use
-\texttt{relax} for default behaviour.) If set, this overrides
-the \catattr{textformat} attribute and \cs{glstextformat}.
-See the \sty{soul} example in \sectionref{sec:glsunset}.
-
-\item[{\gloskey[glslink]{prefix}}] Locally redefines
-\ics{glolinkprefix} to the given value. It should match the prefix
-for the desired glossary.
-
-\item[{\gloskey[glslink]{thevalue}}] Explicitly set the location to
-this value (see below).
-
-\item[{\gloskey[glslink]{theHvalue}}] Set the corresponding
-hyperlink location (see below).
+The hybrid method additionally performs the standard indexing action
+that's required for \app+{makeindex} or \app+{xindy} to work, but this
+can't be done until \app{bib2gls} has created the \ext{glstex} files
+that provide the entry definitions. In general, it's best to avoid
+the hybrid method.
+
+\optionvaldef{record}{off}
+Indexing is performed as per the base \sty{glossaries} package using
+either \gls{makeglossaries} or \gls{makenoidxglossaries}.
+This setting implements \opteqvalref{undefaction}{error}.
+
+\optionvaldef{record}{only}
+\Glsname{indexing} is performed by adding \app{bib2gls} \records\
+in the \ext{aux} file. Neither
+\gls{makeglossaries} nor \gls{makenoidxglossaries} is permitted.
+Use \gls{GlsXtrLoadResources} (or \gls{glsxtrresourcefile})
+to set up \app{bib2gls} \idxpl{resourceopt}. Glossaries should be
+displayed with the \idx{unsrtfam}, such as \gls{printunsrtglossary}.
+
+This setting implements \opteqvalref{undefaction}{warn},
+\opteqvalref{autoseeindex}{false}, \opteqvalref{indexcrossrefs}{false}
+\opteqvalref{sort}{none}, and automatically
+loads the supplementary \sty{glossaries-extra-bib2gls} package.
+(There should be no need to explicitly load \sty{glossaries-extra-bib2gls}.)
-\end{description}
+This option also defines the \gloskey{location} and \gloskey{group}
+keys that are set by \app{bib2gls} to provide the \idx{locationlist}
+and \idx{group} information required by the \idx{unsrtfam}.
-You can set the default options used by \ics{glslink}, \ics{gls}
-etc with:
-\begin{definition}[\DescribeMacro\GlsXtrSetDefaultGlsOpts]
-\cs{GlsXtrSetDefaultGlsOpts}\marg{options}
-\end{definition}
-For example, if you mostly don't want to index entries then
-you can do:
-\begin{verbatim}
-\GlsXtrSetDefaultGlsOpts{noindex}
-\end{verbatim}
-and then use, for example, \verb|\gls[noindex=false]{sample}|
-when you actually want the location added to the \gls{numberlist}.
-These defaults may be overridden by other settings (such as
-category attributes) in addition to any settings passed in the
-option argument of commands like \cs{glslink} and \cs{gls}.
-
-Note that if you don't want \emph{any} indexing, just omit
-\cs{makeglossaries} and \cs{printglossaries} (or analogous
-commands). If you want to adjust the default for
-\gloskey[glslink]{wrgloss}, it's better to do this by redefining
-\ics{glsxtrinitwrgloss} instead.
+The document build process is (assuming the file is called
+\filefmt{myDoc.tex}):
+\begin{terminal}
+pdflatex myDoc
+bib2gls myDoc
+pdflatex myDoc
+\end{terminal}
+If you want letter \idxpl{group} you will need the \switch{group}
+or \switch{g} switch when invoking \app{bib2gls}:
+\begin{terminal}
+pdflatex myDoc
+bib2gls \switch{g} myDoc
+pdflatex myDoc
+\end{terminal}
\begin{important}
-\cs{GlsXtrSetDefaultGlsOpts} doesn't affect \cs{glsadd}.
+Note that this setting will prevent the \gloskey{see} from
+automatically implementing \gls{glssee}. (\app{bib2gls} deals with the
+\gloskey{see} field.) You may explicitly use \gls{glssee} in the
+document, but \app{bib2gls} will ignore the cross-reference if the
+\gloskey{see} field was already set for that entry.
\end{important}
-If you want to change the default value of \gloskey[glsadd]{format},
-you can instead use:
-\begin{definition}[\GlsXtrSetDefaultNumberFormat]
-\cs{GlsXtrSetDefaultNumberFormat}\marg{format}
-\end{definition}
-This has the advantage of also working for \cs{glsadd}.
-For example, if you want all locations in the back matter to appear
-in italic (unless explicitly overridden):
-\begin{verbatim}
-\backmatter
-\GlsXtrSetDefaultNumberFormat{hyperit}
-\end{verbatim}
-
-Commands like \ics{gls} have star (\texttt{*}) and plus
-(\texttt{+}) modifiers as a short cut for \texttt{hyper=false}
-and \texttt{hyper=true}. The \styfmt{glossaries-extra} package
-provides a way to add a third modifier, if required, using
-\begin{definition}[\DescribeMacro\GlsXtrSetAltModifier]
-\cs{GlsXtrSetAltModifier}\marg{char}\marg{options}
-\end{definition}
-where \meta{char} is the character used as the modifier and
-\meta{options} is the default set of options (which may be
-overridden). Note that \meta{char} must be a single character
-(not a UTF-8 character, unless you are using \XeLaTeX\ or
-\LuaLaTeX).
+\optionvaldef{record}{nameref}
+As \opteqvalref{record}{only} but uses nameref \records, which
+include the current label information given by \gls{@currentlabel}
+and \gls{@currentHref}. This means that the title can be included in
+the \idxpl{entrylocation}, if available. This setting also supports
+location hypertargets that don't follow a simple
+\meta{h-prefix}\meta{\idxc{locationcounter}{the-counter}} format,
+which can't be used with other indexing options.
-\begin{important}
-When choosing the character \meta{char} take care of any
-changes in category code.
-\end{important}
+See \sectionref{sec:recordnameref} for further details of this
+option.
-Example:
-\begin{verbatim}
-\GlsXtrSetAltModifier{!}{noindex}
-\end{verbatim}
-This means that \verb|\gls!{sample}| will be equivalent to
-\verb|\gls[noindex]{sample}|. It's not possible to mix modifiers.
-For example, if you want to do
-\begin{verbatim}
-\gls[noindex,hyper=false]{sample}
-\end{verbatim}
-you can use \verb|\gls*[noindex]{sample}| or
-\verb|\gls![hyper=false]{sample}| but you can't combine the
-\texttt{*} and \texttt{!} modifiers.
-
-There is a new hook that's used each time indexing information is
-written to the external glossary files:
-\begin{definition}[\DescribeMacro\glsxtrdowrglossaryhook]
-\cs{glsxtrdowrglossaryhook}\marg{label}
-\end{definition}
-where \meta{label} is the entry's label. This does nothing by
-default but may be redefined. (See, for example, the
-accompanying sample file \texttt{sample-indexhook.tex},
-which uses this hook to determine which entries haven't been
-indexed.)
-
-There's also a new hook (from v1.26) that's used immediately
-before the options are set by the \cs{gls}-like and
-\cs{glstext}-like commands:
-\begin{definition}[\DescribeMacro\glslinkpresetkeys]
-\cs{glslinkpresetkeys}
-\end{definition}
-(The base package provides \ics{glslinkpostsetkeys} that's
-used immediately after the options are set.)
-
-As from version 1.30 there are also similar hooks for \cs{glsadd}:
-\begin{definition}[\DescribeMacro\glsaddpresetkeys]
-\cs{glsaddpresetkeys}
-\end{definition}
-and
-\begin{definition}[\DescribeMacro\glsaddpostsetkeys]
-\cs{glsaddpostsetkeys}
-\end{definition}
-For example, to default to using the \ctr{equation} counter in maths
-mode:
-\begin{verbatim}
-\renewcommand{\glslinkpresetkeys}{%
- \ifmmode \setkeys{glslink}{counter=equation}\fi}
-\renewcommand{\glsaddpresetkeys}{%
- \ifmmode \setkeys{glossadd}{counter=equation}\fi}
-\end{verbatim}
-In this case, the counter can be overridden with an explicit use of
-\gloskey{counter} in the optional argument of \cs{gls} or
-\cs{glsadd}. (As from version 1.37, a simpler method is to just use
-the \pkgopt{equations} package option.)
-
-Alternatively, to enforce this (overriding the option
-argument):
-\begin{verbatim}
-\renewcommand{\glslinkpostsetkeys}{%
- \ifmmode \setkeys{glslink}{counter=equation}\fi}
-\renewcommand{\glsaddpostsetkeys}{%
- \ifmmode \setkeys{glossadd}{counter=equation}\fi}
-\end{verbatim}
-
-As from version 1.14, there are two new keys for \cs{glsadd}:
-\gloskey[glsadd]{thevalue} and \gloskey[glsadd]{theHvalue}.
-These keys are designed for manually adding explicit locations
-rather than obtaining the value from the associated counter.
-As from version 1.19, these two keys are also available for commands
-like \cs{gls} and \cs{glslink}. The \gloskey[glsadd]{thevalue} keys is
-intended primarily for adding locations in supplementary material
-that can't be obtained from a counter.
-
-The principle key \gloskey[glslink]{thevalue} is for the location value. The
-other key \gloskey[glslink]{theHvalue} can be used to
-extract a prefix value for the first argument of commands like
-\ics{glsnoidxdisplayloc}. Its value must be in the format
-\meta{prefix}\meta{location}. In general, there's little need for
-this key as the prefix is typically associated with a counter that can be
-used to form hypertargets.
+\begin{information}
+This option requires \sty{hyperref}, otherwise it will fall back on the usual
+location \records.
+\end{information}
+
+Note that \gls{@currentHref} is always globally updated whenever
+\gls{refstepcounter} is used, but \gls{@currentlabel} isn't. This can
+cause some undesired side-effects with some settings. Remember also
+that the \opt{indexcounter} option increments the associated
+counter every time an entry is \indexed, which affects this option.
+If the \idx{locationcounter} is the default \ctr{page}, only the
+\location\ number is shown.
+
+\optionvaldef{record}{alsoindex}
+Deprecated synonym of \opteqvalref{record}{hybrid}.
+
+\optionvaldef{record}{hybrid}
+This is a hybrid setting that uses \app{bib2gls} to fetch entry
+information from \ext{bib} files, but uses \app+{makeindex} or
+\app+{xindy} to create the \idx{glossary} files (which are input with
+\gls{printglossary}). Note that this requires a slower and more
+complicated build process (see below).
+
+This hybrid approach is provided for the rare instances
+where an existing \app{xindy} rule or module is too complicated to convert to
+a \app{bib2gls} rule but the entries need to be fetched from a
+\ext{bib} file. There's no benefit in using this option with \app{makeindex}.
+
+This setting does not load \sty{glossaries-extra-bib2gls}, as
+\app{bib2gls} is only being used to fetch the entry definitions.
+
+\begin{information}
+Since it's redundant to make \app{bib2gls} also sort and collate
+locations (in addition to \app{xindy} performing these tasks), use the resource options
+\resourceoptval{sort}{none} and
+\resourceoptval{save-locations}{false} for a faster build.
+Many of the other \idxpl{resourceopt} are likely to be irrelevant.
+\end{information}
+
+This setting must be used with \gls{makeglossaries} but not with
+its optional argument.
+Each \idx{glossary} should be displayed using \gls{printglossary} (or
+\gls{printglossaries} for all of them).
\begin{important}
-If you use \gloskey[glsadd]{thevalue}, you must make sure that you
-use an indexing application that will accept the given value.
+This setting should not be used with \gls{makenoidxglossaries}.
\end{important}
-For example, \app{makeindex} will only accept locations in the form
-[\meta{num}\meta{sep}]*\meta{num} where \meta{num} is an arabic
-number (0, 1, \ldots), roman numeral (i, ii, \ldots\ or I, II,
-\ldots) or a character from a, \ldots, z or A, \ldots, Z, and
-[\meta{num}\meta{sep}]* indicates zero or more instances of a number
-followed by the recognised separator character (set with
-\cs{glsSetCompositor}). This means that \app{makeindex} won't
-accept, for example,
-\begin{verbatim}
-\glsadd[thevalue={Supplementary Material}]{sample}
-\end{verbatim}
-This location value will be accepted by \gls{bib2gls}, since it will
-allow any location and will only try forming ranges if the location
-matches any of its numerical patterns.
-In the case of \app{xindy}, you'll need to add a rule that can match
-the value. If you're using \sty{hyperref}, you may need to use the
-\gloskey[glslink]{format} key to prevent a hyperlink if one can't
-naturally be formed from the prefix, counter and location value.
-
-For example, suppose the file \texttt{suppl.tex} contains:
-\begin{verbatim}
-\documentclass{article}
-
-\usepackage{glossaries-extra}
-
-\newglossaryentry{sample}{name={sample},description={an example}}
-
-\renewcommand{\thepage}{S.\arabic{page}}
+You may need to change the transcript file used by \app{bib2gls} to
+avoid a clash with \app{xindy}['s] transcript file. This can be done
+with \app{bib2gls}['s] \switch{log-file} or \switch{t} option.
-\begin{document}
-First page.
-\newpage
-\gls{sample}.
-\end{document}
-\end{verbatim}
-This has an entry on page S.2. Suppose another document wants to
-include this location in the glossary. Then this can be done by
-setting \gloskey[glsadd]{thevalue} to \texttt{S.2}. For example:
-\begin{verbatim}
-\documentclass{article}
+The document build process is (assuming the file is called
+\filefmt{myDoc.tex}):
+\begin{terminal}
+pdflatex myDoc
+bib2gls myDoc
+pdflatex myDoc
+makeglossaries myDoc
+pdflatex myDoc
+\end{terminal}
+Note that, in this case, it's redundant to call \app{bib2gls} with the
+\switch{group} or \switch{g} switch as \app{xindy}
+will insert the group heading information into the corresponding
+\idx{glossary} file.
-\usepackage{glossaries-extra}
+\begin{information}
+If you want \app{bib2gls} to form the letter groups
+then this hybrid method is inappropriate.
+\end{information}
-\makeglossaries
+% PACKAGE OPTION: bibglsaux
+\optiondef{bibglsaux}
-\newglossaryentry{sample}{name={sample},description={an example}}
+Alternatively, this setting can be implemented with:
+\cmddef{glsxtrsetbibglsaux}
-\begin{document}
-Some \gls{sample} text.
+This option should only be used once. If used again no new file will
+be created. If the \meta{basename} value is empty, \records\ will be
+written to the normal \ext{aux} file.
-\printglossaries
-\glsadd[thevalue={S.2}]{sample}
-\end{document}
-\end{verbatim}
-This location value will be accepted by \app{makeindex} as it's in
-the form \meta{num}\meta{sep}\meta{num}.
-
-If you want hyperlinks, things are more complicated. First
-you need to set the \catattr{externallocation} attribute to the location of
-the PDF file. For example:
-\begin{verbatim}
-\glssetcategoryattribute{supplemental}{externallocation}{suppl.pdf}
-
-\newglossaryentry{sample}{category=supplemental,
- name={sample},description={an example}}
-\end{verbatim}
-Next you need to add \texttt{glsxtrsupphypernumber} as the format:
-\begin{verbatim}
-\glsadd[thevalue={S.2},format=glsxtrsupphypernumber]{sample}
-\end{verbatim}
-Both documents will need to use the \sty{hyperref} package.
-Remember that the counter used for the location also needs to match.
-If \cs{theH}\meta{counter} is defined in the other document
-and doesn't match in the referencing document, then you need
-to use \gloskey[glsadd]{theHvalue} to set the appropriate value.
-See the accompanying sample files \texttt{sample-suppl-hyp.tex}
-and \texttt{sample-suppl-main-hyp.tex} for an example that uses
-\sty{hyperref}.
+A document containing many \records\ can result in a large
+\ext+{aux} file with information that's only relevant to
+\app{bib2gls}. This option will create a new file called
+\metafilefmt{}{basename}{.aux} that will be used to store the
+\records. The file will be skipped by \LaTeX\ but will be picked up
+by \app{bib2gls} v3.0+ when it inputs the main \ext{aux} file. Note that
+this creates an extra write register.
\begin{important}
-The hyperlink for the supplementary location may or \emph{may not}
-take you to the relevant place in the external PDF file
-\emph{depending on your PDF viewer}. Some may not support external
-links, and some may take you to the first page or last visited page.
+You should still supply the main \ext{aux} file when you run
+\app{bib2gls} as \metafilefmt{}{basename}{.aux} will only contain
+the \records\ and not the other information that \app{bib2gls}
+requires (such as the \idxpl{resourceopt}).
\end{important}
-For example, if both \texttt{sample-suppl-hyp.pdf}
-and \texttt{sample-suppl-main-hyp.pdf} are in the same directory,
-then viewing \texttt{sample-suppl-main-hyp.pdf} in Evince will
-take you to the correct location in the linked document (when you
-click on the S.2 external link), but Okular will take you to the top
-of the first page of the linked document.
+% PACKAGE OPTION: equations
+\optiondef{equations}
+This setting will cause the default \idx{locationcounter} to automatically switch
+to \ctr{equation} when inside a numbered equation environment, such
+as \env{equation} or \env{align}. The counter can be explicitly
+overridden with the \glsopt{counter} \idx{glsopt}.
-This method can only be used where there is one external source
-for the designated category (identified by the
-\catattr{externallocation} attribute). For multiple sources, you need to use
-\gls{bib2gls} version 1.7+, which is the better method in general as it can
-automatically fetch the relevant locations from the \texttt{.aux}
-files of the designated external documents without the need to
-explicitly use \cs{glsadd}.
-
-\section{Cross-References (\qt{see} and \qt{see also})}
-\label{sec:see}
-
-The value of the \gloskey{see} key is now saved
-as a field. This isn't the case with \styfmt{glossaries}, where
-the \gloskey{see} value is simply used to directly
-write a line to the corresponding glossary file and is then
-discarded. This is why the \gloskey{see} key can't be
-used before \ics{makeglossaries} (since the file hasn't been opened
-yet).
-
-This modification allows \styfmt{glossaries-extra} to provide
-\begin{definition}[\DescribeMacro\glsxtraddallcrossrefs]
-\cs{glsxtraddallcrossrefs}
-\end{definition}
-which is used at the end of the document to automatically add
-any unused cross-references unless the package option
-\pkgopt{indexcrossrefs} was set to false.
-
-Note that even though the \gloskey{see} key will now
-work for entries defined in the \env{document} environment, it's still
-best to define entries in the preamble, and the \gloskey{see} key
-still can't perform any indexing before the file has been opened by
-\cs{makeglossaries}. Note that \styfmt{glossaries} v4.24 introduced
-the \pkgopt{seenoindex} package option, which can be used to
-suppress the error when the \gloskey{see} key is used before
-\cs{makeglossaries}, so \pkgopt[ignore]{seenoindex} will allow the
-\gloskey{see} value to be stored even though it may not be possible
-to index it at that point.
-
-As from version 1.06, you can display the cross-referenced
-information for a given entry using
-\begin{definition}[\DescribeMacro\glsxtrusesee]
-\cs{glsxtrusesee}\marg{label}
-\end{definition}
-This internally uses
-\begin{definition}[\DescribeMacro\glsxtruseseeformat]
-\cs{glsxtruseseeformat}\marg{tag}\marg{xr list}
-\end{definition}
-where \meta{tag} and \meta{xr list} are obtained from the value of
-the entry's \gloskey{see} field (if non-empty).
-By default, this just does \cs{glsseeformat}\oarg{tag}\marg{xr
-list}\verb|{}|, which is how the cross-reference is displayed in the
-\gls{numberlist}. Note that \cs{glsxtrusesee} does nothing if the
-\gloskey{see} field hasn't been set for the entry given by
-\meta{label}.
-
-As with the base \sty{glossaries} package, \cs{glsseeformat}
-is defined to do \texttt{\cs{emph}\marg{tag} \cs{glsseelist}\marg{xr
-list}}. The third argument is always ignored and is present for
-\app{makeindex}, which always requires a final argument to
-encapsulate the associated location. The command
-\begin{definition}
-\ics{glsseelist}\marg{xr list}
-\end{definition}
-used to iterate over the list of cross-reference labels is also
-unchanged from the base \sty{glossaries} package, with each item in
-the list formatted according to:
-\begin{definition}
-\ics{glsseeitem}\marg{label}
-\end{definition}
-This is defined by the \sty{glossaries} package to:
-\begin{alltt}
-\cs{glshyperlink}[\cs{glsseeitemformat}\marg{label}]\marg{label}
-\end{alltt}
-So the actual formatting for each cross-referenced entry is
-performed by \ics{glsseeitemformat}, which is redefined by
-\sty{glossaries-extra}, as described in
-\sectionref{sec:modifications}. This now displays the value
-of the \gloskey{text} field for abbreviations and the value
-of the \gloskey{name} field otherwise. There's no indication
-of the entry hierarchy, which could confuse the reader. Therefore,
-as from \sty{glossaries-extra} v1.37, there are some new commands
-that include the hierarchical information. You may prefer to
-redefine \cs{glsseeitemformat} to use one of this if you have
-sub-entries. For example:
-\begin{verbatim}
-\renewcommand*{\glsseeitemformat}[1]{\glsxtrhiername{#1}}
-\end{verbatim}
-
-The \styfmt{glossaries} package provides
-\begin{definition}[\DescribeMacro\glsseeitemformat]
-\cs{glsseeitemformat}\marg{label}
-\end{definition}
-to format items in a cross-reference list (identified with the
-\gloskey{see} key or \cs{glssee}). This was originally defined to
-use \cs{glsentryname}\marg{label} since it makes more sense for the
-cross-reference to match the way the term appears in the glossary.
-Unfortunately this caused a problem when the \gloskey{name} field
-was sanitized, which used to be the default setting, so
-\styfmt{glossaries} v3.0 changed the default definition of this
-command to use \cs{glsentrytext} instead. Since the \gloskey{name}
-and \gloskey{text} field are quite often the same, this change
-usually doesn't have a noticeable effect. However, now that the
-\gloskey{name} field is no longer sanitized (following the redesign
-of \styfmt{glossaries} v4.0) it makes more sense to restore this
-command to its original behaviour, but to take account of
-abbreviations \styfmt{glossaries-extra} redefines this as:
-\begin{verbatim}
-\renewcommand*{\glsseeitemformat}[1]{%
- \ifglshasshort{\glslabel}{\glsfmttext{#1}}{\glsfmtname{#1}}%
-}
-\end{verbatim}
-(Note that as from \styfmt{glossaries-extra} version 1.42, this now
-uses \cs{glsfmttext} and \cs{glsfmtname} instead of just referencing
-the \gloskey{text} and \gloskey{name} fields. This helps to ensure
-that any formatting is correctly applied.)
-
-If you want to restore the \styfmt{glossaries} v3.0+ definition just do:
-\begin{verbatim}
-\renewcommand*{\glsseeitemformat}[1]{\glsentrytext{#1}}
-\end{verbatim}
-
-The \sty{glossaries-extra} package provides \ics{glsxtrhiername}
-and its case-changing variants that may be used within
-the definition of \cs{glsseeitemformat} if required. These
-display the hierarchy for sub-entries rather than just the name,
-which may be more helpful in cross-references.
-\begin{definition}[\DescribeMacro\glsxtrhiername]
-\cs{glsxtrhiername}\marg{label}
-\end{definition}
-performs a recursive action:
-\begin{enumerate}
-\item If the entry given by \meta{label} has a parent, then
-\cs{glsxtrhiername}\marg{parent label} is done followed by
-\cs{glsxtrhiernamesep} then:
-\item If the entry given by \meta{label} is an abbreviation
-(that is, it has the \gloskey{short} field set) then
-the short form is displayed (using \cs{glsfmtshort})
-otherwise the name is displayed (using \cs{glsfmtname}).
-\end{enumerate}
-The first step above is skipped if the entry doesn't have a parent.
-Each level is separated by:
-\begin{definition}[\DescribeMacro\glsxtrhiernamesep]
-\cs{glsxtrhiernamesep}
-\end{definition}
-which defaults to \qt{\glsxtrhiernamesep}. This can be redefined as
-appropriate.
+% PACKAGE OPTION: floats
+\optiondef{floats}
+This setting will cause the default \idx{locationcounter} to automatically switch
+to the corresponding counter when inside a floating environment,
+such as \env{figure} or \env{table}. The counter can be explicitly
+overridden with the \glsopt{counter} \idx{glsopt}.
-There are some case-changing variants:
-\begin{definition}[\DescribeMacro\Glsxtrhiername]
-\cs{Glsxtrhiername}\marg{label}
-\end{definition}
-The top-level has the first letter changed to upper case
-(either \cs{Glsfmtshort} or \cs{Glsfmtname}). There's
-no case-change for sub-entries.
-
-\begin{definition}[\DescribeMacro\GlsXtrhiername]
-\cs{GlsXtrhiername}\marg{label}
-\end{definition}
-All levels have the first letter changed to upper case
-(either \cs{Glsfmtshort} or \cs{Glsfmtname}).
-
-\begin{definition}[\DescribeMacro\GLSxtrhiername]
-\cs{GLSxtrhiername}\marg{label}
-\end{definition}
-The top-level is converted to upper case
-(either \cs{GLSfmtshort} or \cs{GLSfmtname}). There's
-no case-change for sub-entries.
-
-\begin{definition}[\DescribeMacro\GLSXTRhiername]
-\cs{GLSXTRhiername}\marg{label}
-\end{definition}
-All levels are converted to upper case
-(either \cs{GLSfmtshort} or \cs{GLSfmtname}).
-
-Suppose you want to suppress the \gls*{numberlist}
-using \pkgopt{nonumberlist}. This will automatically prevent the
-cross-references from being displayed. The
-\pkgopt{seeautonumberlist} package option will automatically
-enable the \gls*{numberlist} for entries that have the \gloskey{see}
-key set, but this will also show the rest of the \gls*{numberlist}.
-
-Another approach in this situation is to use the post description
-hook with \cs{glsxtrusesee} to append the cross-reference after
-the description. For example:
-\begin{verbatim}
-\renewcommand*{\glsxtrpostdescgeneral}{%
- \ifglshasfield{see}{\glscurrententrylabel}
- {, \glsxtrusesee{\glscurrententrylabel}}%
- {}%
-}
-\end{verbatim}
-Now the cross-references can appear even though the \gls{numberlist}
-has been suppressed.
-
-As from v1.16, there's a separate \gloskey{seealso} key. Unlike
-\gloskey{see}, this doesn't have an optional part for the textual
-tag. The syntax \texttt{seealso=\marg{xr-labels}} works in much the same way as using
-\texttt{see=[\cs{seealsoname}]\marg{xr-labels}} but the information
-is stored in a separate field. If you need a different tag, use the
-\gloskey{see} key instead (or redefine \cs{seealsoname} or
-\cs{glsxtruseseealsoformat}, described below).
-
-You can display the formatted list of
-cross-references stored in the \gloskey{seealso} key using:
-\begin{definition}[\DescribeMacro\glsxtruseseealso]
-\cs{glsxtruseseealso}\marg{label}
-\end{definition}
-This works in much the same way as \cs{glsxtrusesee}
-but it internally uses
-\begin{definition}[\DescribeMacro\glsxtruseseeformat]
-\cs{glsxtruseseealsoformat}\marg{xr list}
-\end{definition}
+Remember that within floats it's the \gls{caption} command that actually uses
+\gls{refstepcounter}, so indexing before the caption will result in
+the wrong reference. The commands for use in captions and sections,
+such as \gls{glsfmttext} and \gls{glsfmtshort}, don't index. (See
+\sectionref{sec:headtitle}). You may
+want to consider using \gls{glsadd} after the caption (not before). For example:
+\begin{codebox}
+\cbeg{figure}[htbp]
+ \cmd{centering}
+ \cmd{includegraphics}\marg{example-image}
+ \gls{caption}\marg{Sample \gls{glsfmttext}\marg{foobar} figure}
+ \gls{glsadd}\marg{foobar}
+\cend{figure}
+\end{codebox}
+
+% PACKAGE OPTION: indexcounter
+\optiondef{indexcounter}
+This option defines the \idx{indexing} counter:
+\ctrdef*{wrglossary}
+which is incremented every time an entry is \indexed. This option
+automatically implements \optval{counter}{wrglossary}. This means
+that each \location\ will link to the relevant part of the page
+where the \idx{indexing} occurred (instead of to the top of the page).
+See the \app{bib2gls} documentation for the
+\resourceopt{save-index-counter} resource option for more details.
+
+\begin{warning}
+This option is primarily intended for use with
+\app{bib2gls} (v1.4+) and \sty{hyperref}. It can be used with
+\app{makeindex} or \app{xindy}, but it will interfere with the
+\idx{locationlist} collation, so you won't have ranges and you'll have
+duplicate page numbers present.
+\end{warning}
+
+This option works by incrementing \ctr{wrglossary} with
+\gls{refstepcounter} and adding \gls{label}. This can cause a problem if the
+\idx{indexing} occurs in an \env{equation} environment as \sty{amsmath}
+forbids multiple occurrences of \gls{label} (resulting in the
+\qt{Multiple \gls{label}'s} error). It's best to change the counter
+to \ctr{page} or \ctr{equation} when in maths mode with this option.
For example:
-\begin{verbatim}
-\renewcommand*{\glsxtrpostdescgeneral}{%
- \ifglshasfield{see}{\glscurrententrylabel}
- {, \glsxtrusesee{\glscurrententrylabel}}%
- {}%
- \ifglshasfield{seealso}{\glscurrententrylabel}
- { (\glsxtruseseealso{\glscurrententrylabel})}%
- {}%
-}
-\end{verbatim}
-
-The \gloskey{alias} key only contains a single label not a list, but
-if you want to ensure consistent formatting with \cs{glsxtrusesee}
-and \cs{glsxtruseseealso} you can use (from v1.42):
-\begin{definition}[\DescribeMacro\glsxtrusealias]
-\cs{glsxtrusealias}\marg{label}
-\end{definition}
-
-The actual unformatted comma-separated list \meta{xr-list}
-stored in the \gloskey{seealso} field can be accessed with:
-\begin{definition}[\DescribeMacro\glsxtrseealsolabels]
-\cs{glsxtrseealsolabels}\marg{label}
-\end{definition}
-This will just expand to the \meta{xr-labels} provided in the value
-of the \gloskey{seealso} key. There's no corresponding command to
-access the \gloskey{see} field. If you really need to access it, you
-can use commands like \cs{glsxtrfielduse}, but remember that it
-may start with \oarg{tag}, so it can't be automatically treated
-as a simple comma-separated list.
-
-As mentioned above, the base \styfmt{glossaries} package provides \ics{glsseelist},
-which requires a comma-separated list of labels as the argument.
-The argument isn't fully expanded, so it's not suitable to use, for
-example, \cs{glsxtrseealsolabels}\marg{label} as the argument.
-For convenience, \styfmt{glossaries-extra} provides
-\begin{definition}[\DescribeMacro\glsxtrseelist]
-\cs{glsxtrseelist}\marg{xr list}
-\end{definition}
-which fully expands its argument and passes it to \cs{glsseelist}.
-
-As from v1.47, \styfmt{glossaries-extra} redefines \cs{glsseelist}
-to make it more flexible. The base package provides
-\cs{glsseeitem}\marg{label} which is used to format each element in
-the list and \cs{glsseelastsep} for the separator between the final
-two items (\cs{glsseesep} is used between the other items). The
-modifications provide two additional commands:
-\begin{definition}[\DescribeMacro\glsseefirstitem]
-\cs{glsseefirstitem}\marg{label}
-\end{definition}
-This defaults to \cs{glsseeitem}\marg{label} and is used to format
-the first label in the list.
-\begin{definition}[\DescribeMacro\glsseelastoxfordsep]
-\cs{glsseelastoxfordsep}
-\end{definition}
-This defaults to \cs{glsseelastsep} and is used if the list consists
-of three or more labels.
-
-The \gloskey{seealso} key implements the automatic indexing using
-\begin{definition}[\DescribeMacro\glsxtrindexseealso]
-\cs{glsxtrindexseealso}\marg{label}\marg{xr list}
-\end{definition}
-which just does
-\begin{alltt}
-\cs{glssee}[\cs{seealsoname}]\marg{label}\marg{xr list}
-\end{alltt}
-unless the \pkgopt{xindy} option is used with \sty{glossaries}
-v4.30+, in which case a distinct \texttt{seealso} cross-reference
-class is used instead.
-
-The command that produces this \qt{see also} text is
-\begin{definition}[\DescribeMacro\seealsoname]
-\cs{seealsoname}
-\end{definition}
-If \ics{alsoname} (provided by language packages) is defined then
-\cs{seealsoname} will simply be defined to \cs{alsoname} otherwise
-it will be defined to \texttt{see also}.
-
-The language-sensitive \cs{alsoname} is used by general indexing
-packages, such as \sty{makeidx}, so if you redefine \cs{alsoname}
-the change will apply to normal indexes as well as glossaries. If
-you only want to change the text produced by the \gloskey{seealso}
-key without affecting general indexing (with \cs{index}) then
-redefine \cs{seealsoname} instead.
-
-\section{Entry Display Style Modifications}
-\label{sec:entryfmtmods}
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{glslinkpresetkeys}}\marg{\comment{}
+ \cmd{ifmmode} \gls{setupglslink}\marg{\glsoptval{counter}{page}}\cmd{fi}}
+\cmd{renewcommand}\marg{\gls{glsaddpresetkeys}}\marg{\comment{}
+ \cmd{ifmmode} \gls{setupglsadd}\marg{\glsoptval{counter}{page}}\cmd{fi}}
+\end{codebox}
+
+\section{Debugging}
+\label{sec:debuggingopts}
+
+% PACKAGE OPTION: debug
+\optiondef{debug}
+Enables debugging information for draft documents.
+This option is defined by the base \sty{glossaries} package, but is
+extended by \sty{glossaries-extra} to provide additional settings.
+If no value is provided, \optvalref{debug}{true} is assumed.
+The following values are available:
+
+\optionvaldef{debug}{false}
+This setting is provided by the \sty{glossaries} package and is the
+default. This switches off all debugging commands.
+
+\optionvaldef{debug}{true}
+This setting is provided by the \sty{glossaries} package and
+switches on logging information if an entry is \indexed\ before the
+relevant \idx{indexing} files have been opened (only applicable with
+\app+{makeindex} and \app+{xindy}). This option is extended by
+\sty{glossaries-extra} to also display the label of unknown entries
+before the \idx{unknowntag} marker.
+\begin{coderesult}
+\cmd{documentclass}\marg{article}
+\cmd{usepackage}[\opt{debug}]
+ \marg{glossaries-extra}
+\cbeg{document}
+\gls{gls}\marg{example}
+\cend{document}
+\tcblower
+\glsshowtargetfonttext{[example]}\glslink{idx.unknowntag}{??}
+\end{coderesult}
+This uses \gls{glsshowtargetfonttext} for the annotation, which is
+provided by \sty{glossaries}.
+
+\optionvaldef{debug}{showaccsupp}
+Provided by \sty{glossaries}, this setting shows accessibility
+information (\sty{glossaries-accsupp}).
+
+\optionvaldef{debug}{all}
+Implements all debugging options.
+
+\optionvaldef{debug}{showwrgloss}
+This setting is only available with \sty{glossaries-extra}.
+This implements \opteqvalref{debug}{true} and shows
+a marker~(\glsxtrwrglossmark) just before the write operation is
+performed by indexing commands. With \opteqvalref{record}{hybrid}
+there will be two marks: one for the write operation to the
+\ext{aux} file and one for the associated \idx{glossary} file used by
+\app{makeindex}\slash\app{xindy}. The marker is produced with the
+command:
+\cmddef*{glsxtrwrglossmark}
+
+If the \opt{indexcounter} option has been used, this setting will
+also mark where the \ctr{wrglossary} counter has been incremented.
+The marker is produced with the command:
+\cmddef*{glsxtrwrglosscountermark}
+This marker is also inserted before the location in the definition
+of \gls{glsxtrwrglossarylocfmt}.
+
+\optionvaldef{debug}{showtargets}
+This setting is provided by \sty{glossaries} and displays the
+hyperlink target names whenever any \idx{glossary}-related commands
+create a hyperlink or hypertarget (for example, \gls{gls},
+\gls{glstarget} or \gls{glshypernumber}). The default is to
+use marginal notes in \TeX's \qt{outer} mode and inline annotations
+for \qt{inner} or maths modes. This uses \gls{glsshowtargetinner}
+for inner and maths annotations and \gls{glsshowtargetouter} for the
+outer annotation.
+
+If there are many targets within a single paragraph this can lead to
+\qt{too many floats}, so \sty{glossaries-extra} provides a new
+package option \opt{showtargets} that can be used to easily switch
+to inline annotations for outer mode (rather than having to redefine
+\gls{glsshowtargetouter}).
+
+% PACKAGE OPTION: showtargets
+\optiondef{showtargets}
+Automatically implements \opteqvalref{debug}{showtargets} and
+adjusts the annotations according to the \meta{value}. The
+\sty{glossaries-extra} package provides supplementary commands to
+support this option.
+
+\cmddef*{glsxtrshowtargetouter}
+Formats annotations in outer mode. This is initially
+\gls{glsshowtargetouter} to match \opteqvalref{debug}{showtargets}.
+
+\cmddef*{glsxtrshowtargetinner}
+Formats annotations in inner mode. This is initially
+\gls{glsshowtargetinner} to match \opteqvalref{debug}{showtargets}.
+
+\cmddef*{glsshowtargetinnersymleft}
+Shows the left annotation and marker. This uses the left
+symbol marker:
+\cmddef*{glsxtrshowtargetsymbolleft}
+
+\cmddef*{glsshowtargetinnersymright}
+Shows the right marker and annotation. This uses the right
+symbol marker:
+\cmddef*{glsxtrshowtargetsymbolright}
+
+\optionvaldef{showtargets}{left}
+A marker is placed to the left of the link/target and a marginal
+note is used in outer mode.
+
+\optionvaldef{showtargets}{right}
+A marker is placed to the right of the link/target and a marginal
+note is used in outer mode.
+
+\optionvaldef{showtargets}{innerleft}
+A marker and annotation are placed to the left of the
+link/target in all modes.
+
+\optionvaldef{showtargets}{innerright}
+A marker and annotation are placed to the right of the
+link/target in all modes.
+
+\optionvaldef{showtargets}{annoteleft}
+Markers are placed on either side of the
+link/target with the annotation on the left in all modes.
+
+\optionvaldef{showtargets}{annoteright}
+Markers are placed on either side of the
+link/target with the annotation on the right in all modes.
+
+\chapter{Defining Entries}
+\label{sec:newentry}
+
+The base \sty{glossaries} package provides commands, such as
+\gls{newglossaryentry}, to define entries. The
+\sty{glossaries-extra} package provides some additional commands,
+described in \sectionref{sec:newentrydefs}. For abbreviations, see
+\sectionref{sec:abbreviations}. If you use \app{bib2gls}, it will
+write command definitions within the \ext{glstex} file. See the
+\app{bib2gls} user manual for further information about those
+commands.
-Recall from the \styfmt{glossaries} package that commands such as \cs{gls}
-display text at that point in the document (optionally with a
-hyperlink to the relevant line in the glossary). This text is
-referred to as the \qt{\gls{linktext}} regardless of whether or not it
-actually has a hyperlink. The actual text and the way it's displayed
-depends on the command used (such as \cs{gls}) and the entry format.
+The \sty{glossaries} user manual warns against using commands such
+as \gls{gls} within \idx{field} values. However, if you really need
+this, the \sty{glossaries-extra} package provides \gls{glsxtrp} (see
+\sectionref{sec:nested}). Alternatively, you may want to consider
+multi (compound) entries instead (see \sectionref{sec:multientries}).
+
+\section{Command Definitions}
+\label{sec:newentrydefs}
+
+\cmddef{longnewglossaryentry}
+This command is provided by the base \sty{glossaries} package to
+cater for entries with descriptions that contain paragraph breaks.
+(The \meta{key}\dequals\meta{value} interface doesn't support
+paragraph breaks in the value.) The base package only provides an
+unstarred version of this command, which automatically inserts
+\gls{leavevmode}\gls{unskip}\gls{nopostdesc} at the end of the
+description. The \sty{glossaries-extra} package replaces this with a
+single command:
+\cmddef{glsxtrpostlongdescription}
+which has the same effect, but can be redefined if required.
+
+The \sty{glossaries-extra} package provides a starred form:
+\cmddef{longnewglossaryentry*}
+This doesn't insert the hook at the end of the description.
+
+\begin{information}
+For a general purpose post-description hook, see \sectionref{sec:postdeschooks}.
+\end{information}
+
+Additionally, the \opt{symbols} package option provides
+\gls{glsxtrnewsymbol}, and the \opt{numbers} package option provides
+\gls{glsxtrnewnumber}. See \sectionref{sec:gloslistopts} for further
+details.
-The default entry format (\ics{glsentryfmt}) used in the
-\gls{linktext} by commands like \ics{gls}, \ics{glsxtrfull},
-\ics{glsxtrshort} and \ics{glsxtrlong} (but not commands like
-\ics{glslink}, \ics{glsfirst} and \cs{glstext}) is changed by
-\styfmt{glossaries-extra} to test for regular entries, which are
-determined as follows:
+\section{Glossary Entry Keys}
+\label{sec:newkeys}
+In addition to the \idxpl+{gloskey} provided by the base \sty{glossaries}
+package (summarised in \sectionref{sec:gloskeys}) the
+\sty{glossaries-extra} package provides:
-\begin{itemize}
-\item If an entry is assigned to a category that has the
-\catattr{regular} attribute set (see \sectionref{sec:categories}), the entry is considered a~regular
-entry, even if it has a~value for the \gloskey{short} key.
-In this case \cs{glsentryfmt} uses \ics{glsgenentryfmt}
-(provided by \styfmt{glossaries}), which uses the \gloskey{first}
-(or \gloskey{firstplural}) value on \gls{firstuse} and the
-\gloskey{text} (or \gloskey{plural}) value on subsequent use.
-
-\item An entry that doesn't have a~value for the \gloskey{short}
-key is assumed to be a~regular entry, even if the
-\catattr{regular} attribute isn't set to \qt{true} (since it can't
-be an abbreviation without the short form).
-In this case \cs{glsentryfmt} uses \ics{glsgenentryfmt}.
-
-\item If an entry does has a~value for the \gloskey{short} key
-and hasn't been marked as a~regular entry through the
-\catattr{regular} attribute, it's not considered a regular entry.
-In this case \cs{glsentryfmt} uses \ics{glsxtrgenabbrvfmt}
-(defined by \styfmt{glossaries-extra}) which is governed
-by the abbreviation style (see \sectionref{sec:abbrstyle}).
+% KEY: category
-\end{itemize}
+\optiondef{gloskey.category}
+Assigns the \idx{category} label. This should not contain any
+special or active characters as it's used to form command names.
+See \sectionref{sec:categories} for further details.
-This means that entries with a short
-form can be treated as regular entries rather than
-abbreviations if it's more appropriate for the desired style.
-
-As from version 1.04, \ics{glsentryfmt} now puts \ics{glsgenentry}
-in the argument of the new command
-\begin{definition}[\DescribeMacro\glsxtrregularfont]
-\cs{glsxtrregularfont}\marg{text}
-\end{definition}
-This just does its argument \meta{text} by default. This means that
-if you want regular entries in a different font but don't want
-that font to apply to abbreviations, then you can redefine
-\cs{glsxtrregularfont}. This is more precise than changing
-\ics{glstextformat} which is applied to all linking commands
-for all entries, unless overridden by the \catattr{textformat}
-attribute.
+% KEY: seealso
-For example:
-\begin{verbatim}
-\renewcommand*{\glsxtrregularfont}[1]{\textsf{#1}}
-\end{verbatim}
-You can access the label through \cs{glslabel}. For example,
-you can query the category:
-\begin{verbatim}
-\renewcommand*{\glsxtrregularfont}[1]{%
- \glsifcategory{\glslabel}{general}{\textsf{#1}}{#1}}
-\end{verbatim}
-or query the category attribute, for example, provide a custom
-attribute called \texttt{font}:
-\begin{verbatim}
-\glssetcategoryattribute{general}{font}{sf}
-
-\renewcommand*{\glsxtrregularfont}[1]{%
- \glsifattribute{\glslabel}{font}{sf}{\textsf{#1}}{#1}}
-\end{verbatim}
-As from version 1.21, it's simpler to just do, for example:
-\begin{verbatim}
-\glssetcategoryattribute{general}{textformat}{textsf}
-\end{verbatim}
-without redefining \cs{glsxtrregularfont}.
-
-As from version 1.30, there is also a command for abbreviations
-that encapsulates \cs{glsxtrgenabbrvfmt}:
-\begin{definition}[\DescribeMacro\glsxtrabbreviationfont]
-\cs{glsxtrabbreviationfont}\marg{text}
-\end{definition}
-This also just does its argument by default. Font changes
-made by abbreviation styles are within \meta{text}.
-
-The \cs{glspostlinkhook} provided by the \styfmt{glossaries} package to
-insert information after the \gls{linktext} produced by commands like \cs{gls} and \cs{glstext} is
-redefined to
-\begin{definition}[\DescribeMacro\glsxtrpostlinkhook]
-\cs{glsxtrpostlinkhook}
-\end{definition}
-This command will discard a following full stop (period) if the
-\catattr{discardperiod} attribute is set to \qt{true} for the
-current entry's category. It will also do
-\begin{definition}[\DescribeMacro\glsxtrpostlink]
-\cs{glsxtrpostlink}
-\end{definition}
-if a full stop hasn't be discarded and
-\begin{definition}[\DescribeMacro\glsxtrpostlinkendsentence]
-\cs{glsxtrpostlinkendsentence}
-\end{definition}
-if a full stop has been discarded.
-
-It may be that you want to check some other setting (rather
-than a category attribute) to determine whether or not to discard
-a following full stop. In which case you can redefine:
-\begin{definition}[\DescribeMacro\glsxtrifcustomdiscardperiod]
-\cs{glsxtrifcustomdiscardperiod}\marg{true}\marg{false}
-\end{definition}
-You can access the field's label using \cs{glslabel}.
-This command should do \meta{true} if the post-link hook
-should check if a period follows and \meta{false} otherwise.
-The default definition is simply:
-\begin{verbatim}
-\newcommand*{\glsxtrifcustomdiscardperiod}[2]{#2}
-\end{verbatim}
-which means that no additional checks are performed.
-(Only the recognised category attributes will be checked.)
+\optiondef{gloskey.seealso}
+This key is analogous to the \gloskey{see} key but the tag is always
+given by \gls{seealsoname}. The value \meta{xr-list} should be a
+comma-separated list of entry labels. As with the \gloskey{see} key, this key
+automatically indexes the cross-reference by default. The cross-reference will
+be displayed in the \idx{locationlist} using
+\gls{glsxtruseseealsoformat} (see \sectionref{sec:xr}).
+Use \opteqvalref{autoseeindex}{false} to prevent the automatic
+\idx{indexing}. (With \app{bib2gls}, adjust the \resourceopt{selection} criteria.)
\begin{important}
-Avoid the use of \cs{gls}-like and \cs{glstext}-like commands
-within the post-link hook as they will cause interference.
-Consider using commands like \cs{glsentrytext}, \cs{glsaccesstext}
-or \cs{glsxtrp} (\sectionref{sec:nested}) instead.
+With just the base \sty{glossaries} package, the \gloskey{see} key
+simply performs this automated indexing. With
+\sty{glossaries-extra} the value is also saved. Similarly with the
+\gloskey{seealso} key. The value isn't saved with explicit use of
+\gls{glsxtrindexseealso} or \gls{glssee}.
\end{important}
-By default \cs{glsxtrpostlink} just does \postlinkcat\ if it exists, where
-\meta{category} is the category label for the current entry.
-(For example, for the \category{general} category,
-\cs{glsxtrpostlinkgeneral} if it has been defined.)
-
-You can define the post-link hook command using \cs{newcommand}, for
-example:
-\begin{verbatim}
-\newcommand*{\glsxtrpostlinkgeneral}{%
- \glsxtrpostlinkAddDescOnFirstUse
-}
-\end{verbatim}
-or, as from v1.31, you can use
-\begin{definition}[\DescribeMacro\glsdefpostlink]
-\cs{glsdefpostlink}\marg{category}\marg{definition}
-\end{definition}
-This is simply a shortcut for:
-\begin{alltt}
-\cs{csdef}\{glsxtrpostlink\meta{category}\}\marg{definition}
-\end{alltt}
-Note that it doesn't check if the command has already been defined.
+% KEY: alias
-\begin{sloppypar}
-The sentence-ending hook is slightly more complicated.
-If the command \postlinkcat\ is defined the hook will do that
-and then insert a full stop with the space factor adjusted to match
-the end of sentence. If \postlinkcat\ hasn't
-been defined, the space factor is adjusted to match the end of
-sentence. This means that if you have, for example, an entry that
-ends with a full stop, a redundant following full stop will be
-discarded and the space factor adjusted (in case the entry is in
-uppercase) unless the entry is followed by additional material, in
-which case the following full stop is no longer redundant and needs
-to be reinserted.
-\end{sloppypar}
-
-There are some convenient commands you might want to use
-when customizing the post-\gls{linktext} category hooks:
-\begin{definition}[\DescribeMacro\glsxtrpostlinkAddDescOnFirstUse]
-\cs{glsxtrpostlinkAddDescOnFirstUse}
-\end{definition}
-This will add the description in parentheses on \gls{firstuse}.
-
-For example, suppose you want to append the description in
-parentheses on \gls{firstuse} for entries in the \category{symbol}
-category:
-\begin{verbatim}
-\newcommand*{\glsxtrpostlinksymbol}{%
- \glsxtrpostlinkAddDescOnFirstUse
-}
-\end{verbatim}
-
-\begin{definition}[\DescribeMacro\glsxtrpostlinkAddSymbolOnFirstUse]
-\cs{glsxtrpostlinkAddSymbolOnFirstUse}
-\end{definition}
-This will append the symbol (if defined) in parentheses on
-\gls{firstuse}. (Does nothing if the symbol hasn't been set.)
-
-\begin{definition}[\DescribeMacro\glsxtrpostlinkAddSymbolDescOnFirstUse]
-\cs{glsxtrpostlinkAddSymbolDescOnFirstUse}
-\end{definition}
-(New to v1.31.) On \gls{firstuse},
-this will append \cs{space}(\meta{symbol}, \meta{description}) if
-the symbol is defined otherwise it just appends
-\cs{space}(\meta{description}).
-
-If you want to provide your own custom format be aware that you
-can't use \ics{ifglsused} within the post-\gls{linktext} hook as by this point
-the \gls{firstuseflag} will have been unset. Instead you can use
-\begin{definition}[\DescribeMacro\glsxtrifwasfirstuse]
-\cs{glsxtrifwasfirstuse}\marg{true}\marg{false}
-\end{definition}
-This will do \meta{true} if the last used entry was the
-\gls{firstuse}
-for that entry, otherwise it will do \meta{false}. (Requires at
-least \styfmt{glossaries} v4.19 to work properly.) This command is
-locally set by commands like \cs{gls}, so don't rely on it outside
-of the post-\gls{linktext} hook.
+\optiondef{gloskey.alias}
+This is similar to the \gloskey{see} key but the value can only
+be a single entry label. In addition to automatically \idx{indexing} the
+cross-reference, this command will cause the entry with this key to
+have hyperlinks go to the aliased entry when referenced with
+commands like \gls{gls}. Whenever the entry is \indexed\ with
+commands like \gls{gls}, the \idx{indexing} will be performed on the
+target entry (the \gloskey{alias} value). See \sectionref{sec:xr}
+for further details.
\begin{important}
-Note that commands like \ics{glsfirst} and \ics{glsxtrfull} fake
-\gls{firstuse} for the benefit of the post-\gls{linktext} hooks by setting
-\cs{glsxtrifwasfirstuse} to \cs{@firstoftwo}.
-(Although, depending on the styles in use, they may not exactly match
-the text produced by \ics{gls}-like commands on \gls{firstuse}.)
-However, the \abbrstyle{short-postfootnote} style alters \cs{glsxtrfull}
-so that it fakes non-\gls{firstuse} otherwise the inline full format
-would include the footnote, which is inappropriate.
+Any entry that has a \gloskey{see}, \gloskey{seealso} or
+\gloskey{alias} key set will be added to the glossary by default
+when using \app{makeindex} or \app{xindy}. If you don't want this
+behaviour, use the \optval{autoseeindex}{false} package option and
+implement a \idx{postdeschook} to insert the cross-reference.
+Alternatively, consider switching to \app{bib2gls}.
\end{important}
-For example, if you want to place the description in a footnote
-after the \gls{linktext} on \gls{firstuse} for the \category{general} category:
-\begin{verbatim}
-\newcommand*{\glsxtrpostlinkgeneral}{%
- \glsxtrifwasfirstuse{\footnote{\glsentrydesc{\glslabel}}}{}%
+If you use \app{bib2gls} (see \sectionref{sec:bib2gls}) then most of
+the \idxpl{gloskey} can be used as analogous fields in the \ext+{bib}
+file. For example, instead of writing the following code in your
+\ext+{tex} file:
+\begin{codebox}
+\gls{newglossaryentry}\marg{duck}\marg{\gloskeyval{name}{duck},
+ \gloskeyval{description}{a waterbird with webbed feet}}
+\gls{newabbreviation}\marg{svm}\marg{SVM}\marg{support vector machine}
+\end{codebox}
+You would write the following in a \ext+{bib} file:
+\begin{codebox}
+\atentry{entry}\marg{duck,
+ \gloskeyval{name}{duck},
+ \gloskeyval{description}{a waterbird with webbed feet}
}
-\end{verbatim}
-
-The \abbrstyle{short-postfootnote} abbreviation style uses the
-post-\gls{linktext} hook to
-place the footnote after trailing punctuation characters.
-
-
-\section{Entry Counting Modifications}
-\label{sec:entrycountmods}
-
-If you are using \gls{bib2gls} you may find it more convenient
-to use the record count commands described in
-\sectionref{sec:bib2gls} instead.
-
-The \ics{glsenableentrycount} command is modified to allow
-for the \catattr{entrycount} attribute. This means that
-you not only need to enable entry counting with
-\cs{glsenableentrycount}, but you also need
-to set the appropriate attribute (see \sectionref{sec:categories}).
-
-For example, instead of just doing:
-\begin{verbatim}
-\glsenableentrycount
-\end{verbatim}
-you now need to do:
-\begin{verbatim}
-\glsenableentrycount
-\glssetcategoryattribute{abbreviation}{entrycount}{1}
-\end{verbatim}
-This will enable the entry counting for entries in the
-\category{abbreviation} category, but any entries assigned to
-other categories will be unchanged.
-
-Further information about entry counting, including the
-new per-unit feature, is described in \sectionref{sec:entrycount}.
-
-\section{First Use Flag}
-\label{sec:glsunset}
+\atentry{abbreviation}\marg{svm,
+ \gloskeyval{short}{SVM},
+ \gloskeyval{long}{support vector machine},
+}
+\end{codebox}
+
+There are, however, some keys that are considered
+\idxc{bib2glsinternalfield}{internal fields} by \app{bib2gls},
+in that they are defined as keys by
+\sty{glossaries-extra} and may be assigned in the \ext+{glstex}
+file that's input by \gls{GlsXtrLoadResources}, but
+they should not be used in the \ext+{bib} files.
+
+For example, the \gloskey{sort} key (which is recommended with
+\app{xindy} where the \gloskey{name} contains symbols) should not be
+used in the \ext{bib} file. Instead, use the
+\resourceopt{sort-field} resource option or the system of sort
+fallbacks to choose the most appropriate field to obtain the sort
+value (see \gallerypage{bib2gls-sorting}{Gallery: Sorting}). The
+\gloskey{group} and \gloskey{location} keys are also considered
+\idxc{bib2glsinternalfield}{internal fields} and are only applicable
+with the \idx{unsrtfam}.
+
+\begin{information}
+The \gloskey{group} and \gloskey{location} keys are defined by the
+\opteqvalref{record}{only} and \opteqvalref{record}{nameref} options
+and are only applicable with the \idx{unsrtfam}.
+\end{information}
+
+% KEY: group
+
+\optiondef{gloskey.group}
+This key is used by \app{bib2gls} within the \ext{glstex} file to
+set the \idx{group} label. This label is typically a by-product of
+the sorting method (see \sectionref{sec:glosgroups}). If it is
+explicitly set without reference to the order it can result in
+fragmented groups, see \gallerypage{logicaldivisions}{Gallery:
+Logical Glossary Divisions (type vs group vs parent)}. The group
+title can be set with \gls{glsxtrsetgrouptitle}. You will need to
+invoke \app{bib2gls} with the \switch{group} (or \switch{g}) switch
+to ensure that this key is set, when required.
-The \styfmt{glossaries} package provides
-\begin{definition}
-\ics{ifglsused}\marg{label}\marg{true}\marg{false}
-\end{definition}
-to determine whether or not an entry has been used. This requires
-the entry to have been defined. If the entry is undefined, then the
-underlying boolean variable doesn't exist and so is neither true
-nor false. This command will produce an error with the default
-\pkgopt[error]{undefaction} mode and a warning with
-\pkgopt[warn]{undefaction} and, where appropriate, displays ?? in
-the document text to denote an undefined reference. With both modes,
-neither \meta{true} nor \meta{false} will be performed if
-\meta{label} doesn't exist.
-
-The \pkgopt{record} option automatically implements
-\pkgopt[warn]{undefaction} since no entries will be defined until
-they have been selected by \gls{bib2gls}. In this case, you
-may prefer to use:
-\begin{definition}[\DescribeMacro\GlsXtrIfUnusedOrUndefined]
-\cs{GlsXtrIfUnusedOrUndefined}\marg{label}\marg{true}\marg{false}
-\end{definition}
-(new to v1.34) which does \meta{true} if the entry given by
-\meta{label} is undefined or if the entry is marked as unused.
-Remember that neither \cs{ifglsused} nor
-\cs{GlsXtrIfUnusedOrUndefined} should be used in the post-link
-hook as the \gls{firstuseflag} will have already been unset
-before the hook is performed. (Instead, \ics{glsxtrifwasfirstuse}
-should be used, see \sectionref{sec:entryfmtmods}.)
-
-There are two new commands provided with version 1.31+:
-\begin{definition}[\DescribeMacro\glslocalreseteach]
-\cs{glslocalreseteach}\marg{list}
-\end{definition}
-and
-\begin{definition}[\DescribeMacro\glslocalunseteach]
-\cs{glslocalunseteach}\marg{list}
-\end{definition}
-These behave like \cs{glslocalreset} and \cs{glslocalunset}
-but the argument is a comma-separated list of labels.
-
-The internal command used by \cs{glsunset} is modified first to
-allow for the changing in entry counting, described above, but
-also to allow for buffering pending unsets when commands like
-\cs{gls} are used in a context where changing a boolean variable
-can cause things to go wrong. One example of this is using
-\cs{gls} in one of the commands provided with the \isty{soul}
-package. For example:
-\begin{verbatim}
-\ul{Some text about \gls{html}.}
-\end{verbatim}
-This causes the confusing error:
-\begin{verbatim}
-Glossary entry `{html}' has not been defined.
-\end{verbatim}
-The simplest workaround is to put \verb|\gls{html}| inside the
-argument of \cs{mbox}. For example:
-\begin{verbatim}
-\ul{Some text about \mbox{\gls{html}}.}
-\end{verbatim}
-This can work provided it's not the first use of this entry.
-It if is, then unsetting the first use flag causes a problem
-and results in the error:
-\begin{verbatim}
-! Package soul Error: Reconstruction failed.
-\end{verbatim}
-The \styfmt{glossaries-extra} package provides a way of temporarily
-switching off \cs{glsunset} so that it just makes a note of the
-entry's label but doesn't actually perform the change:
-\begin{definition}[\DescribeMacro\GlsXtrStartUnsetBuffering]
-\cs{GlsXtrStartUnsetBuffering}
-\end{definition}
-The unstarred version doesn't check for duplicates, so the internal
-list may end up with multiple occurrences of the same label. The
-starred version only adds a label to the internal list if it's not
-already in it. Note that this buffering only applies to the
-global \cs{glsunset} and does not affect the local
-\cs{glslocalunset}.
-
-Later you can restore \cs{glsunset} and unset all buffered
-labels using:
-\begin{definition}[\DescribeMacro\GlsXtrStopUnsetBuffering]
-\cs{GlsXtrStopUnsetBuffering}
-\end{definition}
-The starred form \cs{GlsXtrStopUnsetBuffering*} uses
-\cs{glslocalunset} instead. For example:
-\begin{verbatim}
-\documentclass{article}
-
-\usepackage[T1]{fontenc}
-\usepackage{soul}
-\usepackage{glossaries-extra}
-
-\newabbreviation{html}{HTML}{hypertext markup language}
+\begin{important}
+Letter \idxpl{group} are a consequence of sorting, not the other way
+around.
+\end{important}
-\begin{document}
-\GlsXtrStartUnsetBuffering
-\ul{Some text about \mbox{\gls{html}}.}
-\GlsXtrStopUnsetBuffering
+% KEY: location
-Next use: \gls{html}.
-\end{document}
-\end{verbatim}
-Before you stop the unset buffering, you can iterate over the
-current buffer using
-\begin{definition}[\DescribeMacro\GlsXtrForUnsetBufferedList]
-\cs{GlsXtrForUnsetBufferedList}\marg{cs}
-\end{definition}
-where \meta{cs} is a control sequence that takes a single argument
-(which is the entry label). This is best used with the starred
-version \cs{GlsXtrStartUnsetBuffering*} to avoid duplicates.
-
-You can discard the buffer and restore \cs{glsunset} to its normal
-behaviour with (new to v1.42):
-\begin{definition}[\DescribeMacro\GlsXtrDiscardUnsetBuffering]
-\cs{GlsXtrDiscardUnsetBuffering}
-\end{definition}
+\optiondef{gloskey.location}
+Used by \app{bib2gls} to store the formatted \idx{locationlist}.
+The unformatted \idxc{internalfield}{internal location list} is stored in the
+\glosfield{loclist} field, as with \gls{printnoidxglossary}.
-\begin{important}
-Note that since the change in the first use flag now doesn't
-occur until \cs{GlsXtrStopUnsetBuffering}, multiple references
-of the same term within the buffering zone will always be
-treated as first use (if the term wasn't used before the
-buffering started).
-\end{important}
+With the \idx{unsrtfam}, if the \gloskey{location} field isn't set,
+then it will try the \glosfield{loclist} field instead, using the same
+method as \gls{printnoidxglossary} to display the \locations. If you
+don't want locations with \app{bib2gls}, either use
+\printglossopt{nonumberlist} or use the
+\resourceoptval{save-locations}{false} resource option.
-There can still be a problem here as content within \cs{mbox}
-can't break across a line so you may end up with an overfull
-line or excessive white space within the paragraph.
-
-An alternative is to use \cs{protect}:
-\begin{verbatim}
-\GlsXtrStartUnsetBuffering
-\ul{Some text about \protect\gls{html}.}
-\GlsXtrStopUnsetBuffering
-\end{verbatim}
-but the formatting (underlining in this example) won't be applied.
-Another possibility is:
-\begin{verbatim}
-\usepackage[T1]{fontenc}
-\usepackage{soul}
-\usepackage{glossaries-extra}
-
-\newabbreviation{html}{HTML}{hypertext markup language}
-
-\newrobustcmd{\gul}[1]{%
- {%
- \def\glsxtrabbreviationfont##1{\GlsXtrExpandedFmt{\ul}{##1}}%
- \def\glsxtrregularfont##1{\GlsXtrExpandedFmt{\ul}{##1}}%
- #1%
- }%
-}
+The base \sty{glossaries} package provides \gls{glsaddkey} and
+\gls{glsaddstoragekey} to allow custom keys to be defined. The
+\sty{glossaries-extra} package additionally provides:
-\begin{document}
-\ul{Some text about }\gls[textformat=gul]{html}.
+\cmddef{glsxtrprovidestoragekey}
+This is like \gls{glsaddstoragekey} but does nothing if the key has
+already been defined. As with \gls{glsaddstoragekey}, the starred
+version switches on field expansion for the given key (provided
+that it hasn't already been defined).
-Next use: \gls{html}.
-\end{document}
-\end{verbatim}
-This moves \cs{gls} outside of \cs{ul} and uses
-\gloskey[glslink]{textformat} to locally change the formatting
-command used by \cs{gls} (which is normally given by
-\cs{glstextformat} or the \catattr{textformat} attribute)
-to a custom command \cs{gul}, which locally changes the regular font
-and the default abbreviation font to use \cs{ul}. It then uses
-\begin{definition}[\DescribeMacro\GlsXtrExpandedFmt]
-\cs{GlsXtrExpandedFmt}\marg{cs}\marg{text}
-\end{definition}
-which (protected) fully expands \meta{text} before applying
-\meta{cs}, which must be a control sequence that takes a single
-argument. This allows \cs{ul} to move much further inside
-and increases its chances of working. It can still break if
-\meta{text} expands to something that \cs{ul} can't deal with.
-For example, if an abbreviation style is used that contains
-complex formatting or if the field value contains problematic
-content.
+\cmddef{glsxtrifkeydefined}
+Tests if the given key has been defined as a \idx{gloskey}.
\section{Plurals}
\label{sec:plurals}
Some languages, such as English, have a general rule that plurals
-are formed from the singular with a suffix appended. This isn't
+are formed from the singular with a suffix appended. This isn't
an absolute rule. There are plenty of exceptions (for example,
geese, children, churches, elves, fairies, sheep). The
\sty{glossaries} package allows the \gloskey{plural} key to be
@@ -2592,7 +22328,7 @@ the plural may be identical to the singular.
To make life easier for languages where the majority of plurals can
simply be formed by appending a suffix to the singular, the
\sty{glossaries} package lets the \gloskey{plural} field default
-to the value of the \gloskey{text} field with \ics{glspluralsuffix}
+to the value of the \gloskey{text} field with \gls{glspluralsuffix}
appended. This command is defined to be just the letter \qt{s}.
This means that the majority of terms don't need to have the
\gloskey{plural} supplied as well, and you only need to use it for the
@@ -2610,511 +22346,1238 @@ sense in the context).
If these fields are omitted, the \sty{glossaries} package follows
these rules:
\begin{itemize}
-\item If \gloskey{firstplural} is missing, then \cs{glspluralsuffix}
+\item If \gloskey{firstplural} is missing, then \gls{glspluralsuffix}
is appended to the \gloskey{first} field, if that field has been
supplied. If the \gloskey{first} field hasn't been supplied but the
\gloskey{plural} field has been supplied, then the \gloskey{firstplural}
field defaults to the \gloskey{plural} field. If the \gloskey{plural}
field hasn't been supplied, then both the \gloskey{plural} and
\gloskey{firstplural} fields default to the \gloskey{text} field (or
-\gloskey{name}, if no \gloskey{text} field) with \cs{glspluralsuffix}
+\gloskey{name}, if no \gloskey{text} field) with \gls{glspluralsuffix}
appended.
-\item If the \gloskey{longplural} field is missing, then
-\cs{glspluralsuffix} is appended to the \gloskey{long} field, if the
+\item If the \gloskey{longplural} field is missing, then
+\gls{glspluralsuffix} is appended to the \gloskey{long} field, if the
\gloskey{long} field has been supplied.
\item If the \gloskey{shortplural} field is missing then, \emph{with
-the base \sty{glossaries} acronym mechanism}, \ics{acrpluralsuffix}
+the base \sty{glossaries} acronym mechanism}, \gls{acrpluralsuffix}
is appended to the \gloskey{short} field.
\end{itemize}
-This \emph{last case is changed} with \styfmt{glossaries-extra}.
+The \emph{last case is changed} with \sty{glossaries-extra}.
With this extension package, the \gloskey{shortplural} field
-defaults to the \gloskey{short} field with \ics{abbrvpluralsuffix}
+defaults to the \gloskey{short} field with \gls{abbrvpluralsuffix}
appended unless overridden by category attributes. This
suffix command is set by the abbreviation styles. This means that
every time an abbreviation style is implemented,
-\cs{abbrvpluralsuffix} is redefined. In most cases its redefined to
-use
-\begin{definition}[\DescribeMacro\glsxtrabbrvpluralsuffix]
-\cs{glsxtrabbrvpluralsuffix}
-\end{definition}
-which defaults to just \cs{glspluralsuffix}. Some of the
-abbreviation styles have their own command for the plural suffix,
-such as \cs{glsxtrscsuffix},
-so if you want to completely strip all the plural suffixes used for
-abbreviations then you need to redefine \cs{glsxtrabbrvpluralsuffix}
-\emph{not} \cs{abbrvpluralsuffix}, which changes with the style. Redefining
-\cs{acrpluralsuffix} will have no affect, since it's not used by the
-new abbreviation mechanism.
-
-If you require a mixture (for example, in a multilingual document),
-there are two attributes that affect the short plural suffix
-formation. The first is \catattr{aposplural} which uses the suffix
-\begin{verbatim}
-'\abbrvpluralsuffix
-\end{verbatim}
-That is, an apostrophe followed by \cs{abbrvpluralsuffix} is
-appended. The second attribute is \catattr{noshortplural} which
-suppresses the suffix and simply sets \gloskey{shortplural} to the
-same as \gloskey{short}.
+\gls{abbrvpluralsuffix} is redefined, see \sectionref{sec:abbrvfieldslongshortpl}
+for further details.
-\section{Nested Links}
-\label{sec:nested}
+\section{Entry Aliases}
+\label{sec:alias}
-Complications arise when you use \ics{gls} in the
-value of the \gloskey{name} field (or \gloskey{text}
-or \gloskey{first} fields, if set). This tends to occur with
-abbreviations that extend other abbreviations. For example,
-SHTML is an abbreviation for SSI enabled HTML, where SSI
-is an abbreviation for Server Side Includes and HTML
-is an abbreviation for Hypertext Markup Language.
+An entry can be made an alias of another entry using the
+\gloskey{alias} key. The value should be the label of the other
+term. There's no check for the other's existence when the aliased
+entry is defined. This is to allow the possibility of defining the
+other entry after the aliased entry. (For example, when used with
+\app{bib2gls}.)
-Things can go wrong if we try the following with the
-\styfmt{glossaries} package:
-\begin{verbatim}
-\newacronym{ssi}{SSI}{Server Side Includes}
-\newacronym{html}{HTML}{Hypertext Markup Language}
-\newacronym{shtml}{S\gls{html}}{\gls{ssi} enabled \gls{html}}
-\end{verbatim}
+\cmddef*{glsxtraliashook}
+This hook is implemented when an entry is defined with the
+\gloskey{alias} key set. It does nothing by default. The value of
+the \gloskey{alias} field can be obtained with
+\code{\gls{glsxtralias}\margm{entry-label}}.
-The main problems are:
-\begin{enumerate}
-\item\label{itm:nestedfirstucprob} The first letter upper casing commands, such as \ics{Gls},
-won't work for the \texttt{shtml} entry on \gls{firstuse} if the
-long form is displayed before the short form (which is the
-default abbreviation style). This will attempt to do
-\begin{verbatim}
-\gls{\uppercase ssi} enabled \gls{html}
-\end{verbatim}
-which just doesn't work. Grouping the \verb|\gls{ssi}| doesn't
-work either as this will effectively try to do
-\begin{verbatim}
-\uppercase{\gls{ssi}} enabled \gls{html}
-\end{verbatim}
-This will upper case the label \texttt{ssi} so the entry won't be
-recognised. This problem will also occur if you use the all capitals
-version, such as \ics{GLS}.
+If an entry \meta{entry-1} is made an alias of \meta{entry-2} then:
+\begin{itemize}
+\item If the \gloskey{see} field wasn't provided when \meta{entry-1}
+was defined, the \gloskey{alias} key will automatically trigger
+\begin{compactcodebox}
+\gls{glssee}\margm{entry-1}\margm{entry-2}
+\end{compactcodebox}
-\item\label{itm:nonexpandprob} The long and abbreviated forms accessed through
-\ics{glsentrylong} and \ics{glsentryshort} are no longer expandable
-and so can't be used be used in contexts that require this,
-such as PDF bookmarks.
+\item If the \sty{hyperref} package has been loaded then
+\code{\gls{gls}\margm{entry-1}} will link to \meta{entry-2}'s target. (Unless
+the \catattr{targeturl} attribute has been set for \meta{entry-1}'s
+category.)
-\item\label{itm:nestedsortprob} The nested commands may end up in the \gloskey{sort} key,
-which will confuse the indexing.
+\item With \opteqvalref{record}{off} or
+\opteqvalref{record}{hybrid}, the \glsopt{noindex} setting will automatically be triggered
+when referencing \meta{entry-1} with commands like \gls{gls} or
+\gls{glstext}. This prevents \meta{entry-1} from having a
+\idx{locationlist} (aside from the cross-reference added with
+\gls{glssee}) unless it's been explicitly indexed with \gls{glsadd} or
+if the indexing has been explicitly set using
+\glsoptval{noindex}{false}.
+See \sectionref{sec:glssee} for adjusting the indexing hook.
-\item\label{itm:inconsistentfirstuseprob} The \texttt{shtml} entry produces inconsistent results
-depending on whether the \texttt{ssi} or \texttt{html} entries have
-been used. Suppose both \texttt{ssi} and \texttt{html} are used
-before \texttt{shtml}. For example:
-\begin{verbatim}
-This section discusses \gls{ssi}, \gls{html} and \gls{shtml}.
-\end{verbatim}
-This produces:
-\begin{quote}
-This section discusses server side includes (SSI), hypertext markup
-language (HTML) and SSI enabled HTML (SHTML).
-\end{quote}
-So the \gls{firstuse} of the \texttt{shtml} entry produces
-\qt{SSI enabled HTML (SHTML)}.
+Note that with \opteqvalref{record}{only}, the \idx{locationlist}
+for aliased entries is controlled with \app{bib2gls}['s] settings.
+\end{itemize}
-Now let's suppose the \texttt{html} entry is used before the
-\texttt{shtml} but the \texttt{ssi} entry is used after the
-\texttt{shtml} entry, for example:
-\begin{verbatim}
-The sample files are either \gls{html} or \gls{shtml}, but let's
-first discuss \gls{ssi}.
-\end{verbatim}
-This produces:
-\begin{quote}
-The sample files are either hypertext markup language (HTML) or
-server
-side includes (SSI) enabled HTML (SHTML), but let's first discuss
-SSI.
-\end{quote}
-So the \gls{firstuse} of the \texttt{shtml} entry now produces
-\qt{server side includes (SSI) enabled HTML (SHTML)}, which looks
-a bit strange.
+The value of the \gloskey{alias} field can be accessed with
+\gls{glsxtralias} (see \sectionref{sec:getsee}).
+
+\section{Setting or Updating Fields}
+\label{sec:setfields}
+
+See \sectionref{sec:getfields} for accessing field values and
+\sectionref{sec:fieldconditionals} for testing field values.
+
+\begin{warning}
+Modifications to fields only have an effect from that point onwards
+and may be localised to the current scope. If you are using
+\opteqvalref{docdef}{true}, any changes to the field values won't be
+saved in the \ext+{glsdefs} file.
+\end{warning}
+
+Some of these commands are subtly different from each other. For
+example, \gls{glsfielddef} (provided by the base \sty{glossaries}
+package), \gls{glsxtrdeffield} and \gls{GlsXtrSetField} all assign a
+value to a field, but \gls{glsfielddef} requires that both the entry
+and the field exists (so it can't be used to set an unknown \idx{internalfield}),
+\gls{GlsXtrSetField} requires that the entry
+exists (so it can be used to set an \idx{internalfield} that doesn't have
+an associated key provided that the entry has been defined), and
+\gls{glsxtrdeffield} doesn't perform any existence checks (which
+means that it can be used to assign \idxpl{internalfield} before the entry
+is actually defined).
+
+The commands described in this section don't require the \idx{field} to
+have an associated \idx{gloskey}, so you need to be
+careful not to misspell the field labels.
+
+\begin{information}
+Assigning or changing fields using the commands described here won't
+alter related fields. For example, if you use the \gloskey{text} key
+but not the \gloskey{plural} key when you define an entry with
+\gls{newglossaryentry}, the \gloskey{plural} key will automatically
+be set as well, but if you change the value of the \gloskey{text}
+field after the entry has been defined, the \gloskey{plural} field
+won't be changed. Particular care is required if the field
+contributes in some way to the \idx{indexing} information, as this
+information is typically initialised when the entry is first
+defined. This includes the \gloskey{sort} and \gloskey{parent} keys,
+which should not be changed after the entry has been defined.
+\end{information}
+
+With \app{bib2gls}, entries aren't defined on the first \LaTeX\ run.
+This means that commands that test for existence will produce a
+warning and (within the \env{document} environment) the \idx{unknowntag}
+unknown marker. For example:
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\cmd{usepackage}[\opt{record}]\marg{glossaries-extra}
+\gls{GlsXtrLoadResources}\oarg{\resourceoptval{src}{myentries},\resourceoptval{selection}{all}}
+\cbeg{document}
+Defining info
+\gls{glsxtrdeffield}\marg{sample}\marg{info}\marg{some information}.
+Defining note
+\gls{GlsXtrSetField}\marg{sample}\marg{note}\marg{some note}.
+\codepar
+Info: \gls{glsxtrusefield}\marg{sample}\marg{info}.
+Note: \gls{glsxtrusefield}\marg{sample}\marg{note}.
+\cend{document}
+\end{codebox}
+On the first \LaTeX\ run, this produces:
+\begin{resultbox}
+Defining info . Defining note \glslink{idx.unknowntag}{??}.
+
+Info: some information. Note: .
+\end{resultbox}
+At this point the \code{sample} entry hasn't been defined, so
+referencing it in \gls{GlsXtrSetField} results in a warning and the
+double question mark \idx{unknowntag} unknown marker in the text.
+The field (\code{note}) isn't saved,
+so nothing is shown when the field is referenced with
+\gls{glsxtrusefield}. Whereas \gls{glsxtrdeffield} does save the
+field with the label \code{info} associated with the label
+\code{sample}, even though the \code{sample} entry hasn't actually
+been defined. The field can then be later obtained with
+\gls{glsxtrusefield}. Once \app{bib2gls} has been run, the
+\code{sample} entry should now have its definition in the
+\ext{glstex} file, which is loaded by \gls{GlsXtrLoadResources} and
+the \code{note} field can be set.
+
+\cmddef{glsxtrdeffield}
+This uses \sty{etoolbox}'s \gls{csdef} command to locally set the \idx{field}
+given by its \idxc{internalfieldlabel}{internal label}
+\meta{field-label} to \meta{value} for the entry identified by
+\meta{entry-label}. No existence check is performed.
+
+\cmddef{glsxtredeffield}
+This is like \gls{glsxtrdeffield} but (protected) fully expands the
+value before assigning it to the field.
+
+\cmddef{glsxtrapptocsvfield}
+This command is designed for fields that should contain
+comma-separated lists. If the field hasn't been defined, this
+behaves like \gls{glsxtrdeffield} otherwise it will append a comma
+followed by \meta{element} (unexpanded) to the field value. No
+existence check is performed. This field can be iterated over using
+\gls{glsxtrforcsvfield} or formatted using \gls{glsxtrfieldformatcsvlist}.
+See \sectionref{sec:csvfields} for further details.
+
+\cmddef{glsxtrfieldlistadd}
+Appends the given value to the given entry's field (identified using
+the \idxc{internalfieldlabel}{field's internal label}) using
+\sty{etoolbox}['s] \gls{listcsadd}. The field value can later be
+iterated over using \gls{glsxtrfielddolistloop} or
+\gls{glsxtrfieldforlistloop}.
+
+\cmddef{glsxtrfieldlistgadd}
+As above but uses \gls{listcsgadd} to make a global change.
+
+\cmddef{glsxtrfieldlisteadd}
+As above but uses \gls{listcseadd} to expand the value.
+
+\cmddef{glsxtrfieldlistxadd}
+As above but uses \gls{listcsxadd} to make a global change.
+
+\cmddef{glsxtrsetfieldifexists}
+This is used by the commands \gls{GlsXtrSetField}, \gls{gGlsXtrSetField},
+\gls{xGlsXtrSetField}, \gls{eGlsXtrSetField},
+\gls{GlsXtrLetField}, \gls{csGlsXtrLetField} and
+\gls{GlsXtrLetFieldToField} to produce an error (or warning with
+\opteqvalref{undefaction}{warn}) if the entry doesn't exist. This
+can be redefined to add extra checks (for example, to prohibit
+changing certain fields).
+
+\cmddef{GlsXtrSetField}
+This uses \sty{etoolbox}'s \gls{csdef} command to locally set the \idx{field}
+given by its \idxc{internalfieldlabel}{internal label}
+\meta{field-label} to \meta{value} for the entry identified by
+\meta{entry-label}.
+
+This command is written to the \ext{glstex} file by \app{bib2gls} to
+set fields that don't have a corresponding key.
+
+\cmddef{gGlsXtrSetField}
+This is like \gls{GlsXtrSetField} but uses a global assignment.
+
+\cmddef{eGlsXtrSetField}
+This is like \gls{GlsXtrSetField} but (protected) fully expands the
+value first.
+
+\cmddef{xGlsXtrSetField}
+This is like \gls{eGlsXtrSetField} but uses a global assignment.
+
+
+\cmddef{GlsXtrLetField}
+This uses \sty{etoolbox}'s \gls{cslet} command to locally set the \idx{field}
+given by its \idxc{internalfieldlabel}{internal label}
+\meta{field-label} to \meta{cs} for the entry identified by
+\meta{entry-label}.
+
+\cmddef{csGlsXtrLetField}
+This uses \sty{etoolbox}'s \gls{csletcs} command to locally set the
+\idx{field} given by its \idxc{internalfieldlabel}{internal label}
+\meta{field-label} to the control sequence given by \meta{cs-name}
+for the entry identified by \meta{entry-label}.
+
+\cmddef{GlsXtrLetFieldToField}
+This assigns the field identified by its
+\idxc{internalfieldlabel}{internal label} \meta{field1-label} for
+the entry identified by \meta{entry1-label} to the value of the
+\idx{field} identified by \meta{field2-label} for the entry identified by
+\meta{entry2-label}
-Now let's suppose the \texttt{shtml} entry is used before (or
-without) the other two entries:
-\begin{verbatim}
-This article is an introduction to \gls{shtml}.
-\end{verbatim}
-This produces:
-\begin{quote}
-This article is an introduction to server side includes (SSI)
-enabled hypertext markup language (HTML) (SHTML).
-\end{quote}
-So the \gls{firstuse} of the \texttt{shtml} entry now produces
-\qt{server side includes (SSI) enabled hypertext markup language (HTML)
-(SHTML)}, which is even more strange.
-
-This is all aggravated by setting the style using the
-\styfmt{glossaries} package's
-\cs{setacronymstyle}. For example:
-\begin{verbatim}
-\setacronymstyle{long-short}
-\end{verbatim}
-as this references the label through the use of \cs{glslabel}
-when displaying the long and short forms, but this value
-changes with each use of \cs{gls}, so instead of displaying
-\qt{(SHTML)} at the end of the \gls{firstuse}, it now displays
-\qt{(HTML)}, since \cs{glslabel} has been changed to \texttt{html}
-by \verb|\gls{html}|.
+\chapter{Abbreviations}
+\label{sec:abbreviations}
-Another oddity occurs if you reset the \texttt{html} entry between
-uses of the \texttt{shtml} entry. For example:
-\begin{verbatim}
-\gls{shtml} ... \glsreset{html}\gls{shtml}
-\end{verbatim}
-The next use of \texttt{shtml} produces \qt{Shypertext markup
-language (HTML)}, which is downright weird.
+The acronym mechanism implemented by the base \sty+{glossaries}
+package is insufficiently flexible for some documents. The
+\sty{glossaries-extra} package provides a completely different
+mechanism to deal with abbreviations in a more flexible manner. The
+two methods are incompatible. However, the \sty{glossaries-extra}
+package provides predefined styles that emulate the appearance
+of the styles provided by the base package. If you have previously
+used just the base \sty+{glossaries} package, consult
+\tableref{tab:acrabbrvstyles} for the closest matching abbreviation
+style.
-Even without this, the short form has nested formatting commands,
-which amount to \verb|\acronymfont{S\acronymfont{HTML}}|. This
-may not be a problem for some styles, but if you use one of the
-\qt{sm} styles (that use \ics{textsmaller}), this will produce
-an odd result.
+\section{Defining Abbreviations}
+\label{sec:newabbr}
+
+Abbreviations are defined using:
+\cmddef{newabbreviation}
+where \meta{entry-label} is the entry's label (used in commands like
+\gls{gls}), \meta{short} is the short form (the abbreviation) and
+\meta{long} is the long form (what the abbreviation is short for).
+The optional argument \meta{options} may be used to set additional
+keys (as per the \idxc{gloskey}{options list} in \gls{newglossaryentry}), such as
+\gloskey{type} or \gloskey{category}.
+
+This command internally uses \gls{newglossaryentry} and sets the
+\gloskey{type} to \gls{glsxtrabbrvtype} and the
+\gloskey{category} to \cat{abbreviation}. The category (see
+\sectionref{sec:categories}) determines the abbreviation style.
+The style for a particular category is set using
+\gls{setabbreviationstyle}. If the optional argument is omitted, the
+\cat{abbreviation} category is assumed (see \sectionref{sec:abbrstyle} for
+further details).
+
+The following example document sets up three different abbreviation
+styles: \abbrstyle{long-short-sc} for the \cat{abbreviation}
+category, \abbrstyle{long-only-short-only} for the custom
+\code{genus} category, and \abbrstyle{short-nolong} for the custom
+\code{common} category. Note that the custom \code{title} category
+doesn't have an associated style.
+\begin{codebox}
+\gls{setabbreviationstyle}\marg{\abbrstyle{long-short-sc}}
+\gls{setabbreviationstyle}\oarg{genus}\marg{\abbrstyle{long-only-short-only}}
+\gls{setabbreviationstyle}\oarg{common}\marg{\abbrstyle{short-nolong}}
+\gls{newabbreviation}\marg{xml}\marg{xml}\marg{extensible markup language}
+\gls{newabbreviation}\oarg{\gloskeyval{category}{genus}}\marg{clostridium}\marg{C.}\marg{Clostridium}
+\gls{newabbreviation}\oarg{\gloskeyval{category}{genus}}\marg{myristica}\marg{M.}\marg{Myristica}
+\gls{newabbreviation}\oarg{\gloskeyval{category}{common}}\marg{html}\marg{HTML}\marg{hypertext markup language}
+\gls{newabbreviation}\oarg{\gloskeyval{category}{title}}\marg{dr}\marg{Dr}\marg{Doctor}
+\cbeg{document}
+First use: \gls{gls}\marg{xml}, \gls{gls}\marg{clostridium}, \gls{gls}\marg{myristica},
+\gls{gls}\marg{html}, \gls{gls}\marg{dr}.
+\codepar
+Next use: \gls{gls}\marg{xml}, \gls{gls}\marg{clostridium}, \gls{gls}\marg{myristica},
+\gls{gls}\marg{html}, \gls{gls}\marg{dr}.
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample*[title={Multiple abbreviation styles},
+ description={Example document with multiple abbreviation styles},
+ label={ex:multiabbrvstyles}
+]
+{%
+\cmd{usepackage}\marg{glossaries-extra}^^J%
+\gls{setabbreviationstyle}\marg{long-short-sc}^^J%
+\gls{setabbreviationstyle}\oarg{genus}\marg{long-only-short-only}^^J%
+\gls{setabbreviationstyle}\oarg{common}\marg{short-nolong}^^J%
+\gls{newabbreviation}\marg{xml}\marg{xml}\marg{extensible markup
+language}^^J%
+\gls{newabbreviation}\oarg{\gloskeyval{category}{genus}}\marg{clostridium}\marg{C.}\marg{Clostridium}^^J%
+\gls{newabbreviation}\oarg{\gloskeyval{category}{genus}}\marg{myristica}\marg{M.}\marg{Myristica}^^J%
+\gls{newabbreviation}\oarg{\gloskeyval{category}{common}}\marg{html}\marg{HTML}\marg{hypertext
+markup language}
+\gls{newabbreviation}\oarg{\gloskeyval{category}{title}}\marg{dr}\marg{Dr}\marg{Doctor}
+}
+{%
+First use: \gls{gls}\marg{xml}, \gls{gls}\marg{clostridium}, \gls{gls}\marg{myristica},
+\gls{gls}\marg{html}, \gls{gls}\marg{dr}.
+\codepar
+Next use: \gls{gls}\marg{xml}, \gls{gls}\marg{clostridium}, \gls{gls}\marg{myristica},
+\gls{gls}\marg{html}, \gls{gls}\marg{dr}.
+}
+\end{resultbox}
+
+If the category doesn't have an associated style, the style for the
+\cat{abbreviation} category will be used, as with the \code{dr} entry
+above, which uses the \abbrstyle{long-short-sc} style because no
+style has been associated with its custom \code{title} category.
+
+There are two categories that have an abbreviation style set by
+default: \cat{abbreviation} and \cat{acronym}. These are initialised
+as follows:
+\begin{codebox}
+\gls{setabbreviationstyle}\marg{\abbrstyle{long-short}}
+\gls{setabbreviationstyle}\oarg{\cat{acronym}}\marg{\abbrstyle{short}}
+\end{codebox}
+This means that abbreviations defined with the default
+\cat{abbreviation} category will show the long form followed by the
+short form in parentheses on \idx{firstuse}, and those defined with the
+\gloskey{category} set to \cat{acronym} will only show the short
+form (that is, the long form won't be shown on \idx{firstuse}).
+
+To make it easier to migrate a file containing entries defined with
+\gls{newacronym}, the \sty{glossaries-extra} package redefines
+\gls{newacronym} to do:
+\begin{codebox}
+\gls{newabbreviation}\oarg{\gloskey{type}=\gls{acronymtype},\gloskey{category}=\cat{acronym},\meta{options}}\margm{entry-label}\margm{short}\margm{long}
+\end{codebox}
+Note that this sets the \gloskey{category} to \cat{acronym}, which
+means that any abbreviations defined with \gls{newacronym} will use
+the \abbrstyle{short} style by default. If you want to use a
+different style, you need to set the abbreviation style for the
+\cat{acronym} category. For example, to use the
+\abbrstyle{long-short} style:
+\begin{codebox}
+\gls{setabbreviationstyle}\oarg{\cat{acronym}}\marg{\abbrstyle{long-short}}
+\end{codebox}
+This must be placed before the first instance of \gls{newacronym}.
+
+\begin{information}
+You can't use \gls{setacronymstyle} with \sty{glossaries-extra}.
+\end{information}
+
+If you have defined any acronym styles with
+\gls{newacronymstyle}, you will have to migrate them over to
+\gls{newabbreviationstyle}. However, most of the predefined
+abbreviation styles are flexible enough to adapt to common
+abbreviation formats. It is possible to revert \gls{newacronym} back
+to using the base \sty{glossaries} package's acronym mechanism
+(\sectionref{sec:acrorevert}), but it should generally not be
+necessary.
+
+Terms defined with \gls{newabbreviation} (and \gls{newacronym}) can
+be referenced in the main document text using commands like \gls{gls}.
+(If you want to use shortcut commands like \gls{ac}, use the
+\opteqvalref{shortcuts}{ac} package option.)
+Remember that you can use the \glsopt{prereset} and
+\glsopt{preunset} options to reset or unset the \idx{firstuseflag}
+(see \sectionref{sec:glsunset}). Alternatively, you can use the
+commands described in \sectionref{sec:abbrvfieldrefs}. For headings
+and captions, see \sectionref{sec:headingcommands}.
-\item\label{itm:indexingprob} Each time the \texttt{shtml} entry is used, the
-\texttt{html} entry will also be indexed and marked as used,
-and on \gls{firstuse} this will happen to both the \texttt{ssi}
-and \texttt{html} entries. This kind of duplication in the location
-list isn't usually particularly helpful to the reader.
+\begin{important}
+Avoid using \gls{glsfirst}, \gls{glsfirstplural}, \gls{glstext} and
+\gls{glsplural} with abbreviations. Many of the abbreviation styles
+are too complex to work with these commands (particularly the
+case-changing variants or with the \meta{insert} final optional
+argument or with \glsopt{innertextformat}). Instead, use commands
+like \gls{gls}, \gls{glsxtrshort}, \gls{glsxtrlong} and \gls{glsxtrfull}.
+\end{important}
-\item\label{itm:nestedhyplinkprob} If \sty{hyperref} is in use, you'll get nested hyperlinks
-and there's no consistent way of dealing with this across the
-available PDF viewers. If on the \gls{firstuse} case, the user
-clicks on the \qt{HTML} part of the \qt{SSI enabled HTML (SHTML)}
-link, they may be directed to the HTML entry in the glossary or
-they may be directed to the SHTML entry in the glossary.
+\subsection{Abbreviation Fields: \optfmt{long} and \optfmt{short}}
+\label{sec:abbrvfieldslongshort}
+
+The \meta{short} and \meta{long} arguments are internally assigned with the
+\gloskey{short} and \gloskey{long} keys (so don't use those keys in
+\meta{options}), but the short and long values may first be modified by
+category attributes, such as \catattr{markwords} or
+\catattr{markshortwords}. As with other entries, avoid nested links
+(see \sectionref{sec:nested}). This means avoid using the
+\idx{glslike} and \idx{glstextlike} commands within \meta{short} and
+\meta{long}.
+
+\begin{information}
+If an abbreviation can be formed by combining other
+entries, consider using the multi (compound) entry function
+(see \sectionref{sec:multientries}).
+\end{information}
+
+\subsection{Abbreviation Fields: \optfmt{longplural} and \optfmt{shortplural}}
+\label{sec:abbrvfieldslongshortpl}
+
+The \gloskey{longplural} key defaults to
+\meta{long}\gls{glspluralsuffix} and the \gloskey{shortplural} key
+defaults to \meta{short}\gls{abbrvpluralsuffix}. The
+\catattr{aposplural} attribute will instead set the
+\gloskey{shortplural} to \code{\meta{short}'\gls{abbrvpluralsuffix}}
+and the \catattr{noshortplural} attribute will set
+\gloskey{shortplural} to just \meta{short} (see
+\sectionref{sec:categories}). If these values are not appropriate,
+you will need to explicitly set the \gloskey{longplural} and
+\gloskey{shortplural} keys in \meta{options}.
+
+The short plural suffix \gls{abbrvpluralsuffix} is redefined by the
+abbreviation style. Some styles, such as the \abbrstyle{long-short} style,
+simply redefine \gls{abbrvpluralsuffix} to just:
+\cmddef{glsxtrabbrvpluralsuffix}
+which is defined to \gls{glspluralsuffix}.
+
+Some styles, such as the \abbrstyle{long-short-sc} style, redefine
+\gls{abbrvpluralsuffix} to include code to counteract the formatting
+of the abbreviation.
+
+\begin{information}
+If you want to change the default short plural suffix, you need to
+redefine \gls{glsxtrabbrvpluralsuffix} not \gls{abbrvpluralsuffix}.
+If you don't want the suffix added, then set the
+\catattr{noshortplural} attribute to \code{true}.
+\end{information}
+
+\subsection{Abbreviation Fields: \optfmt{name} and \optfmt{description}}
+\label{sec:abbrvfieldsnamedesc}
+
+The \gloskey{name} key is set according to the abbreviation style.
+There should not be any need to explicitly set it.
+Some styles require the \gloskey{description} key to be set in
+\meta{options}, but other styles will set the \gloskey{description}
+to the long form.
+
+\subsection{Abbreviation Fields: \optfmt{type}}
+\label{sec:abbrvfieldstype}
+
+Abbreviations can be assigned to a particular \idx{glossary} using
+the \gloskey{type} key in \meta{options}. The default for \gls{newabbreviation} is:
+\cmddef{glsxtrabbrvtype}
+This is initialised to \gls{glsdefaulttype} (the default glossary),
+but the \opt{abbreviations} package option will redefine it to
+\code{abbreviations}.
+
+The default \gloskey{type} for \gls{newacronym} is:
+\cmddef{acronymtype}
+This is initialised to \gls{glsdefaulttype},
+but the \opt{acronyms} package option will redefine it to
+\code{acronym}.
+
+\subsection{General Hooks}
+\label{sec:abbrvgeneralhooks}
+
+The following are general purpose hooks used within
+\gls{newabbreviation}. Note that there are additional hooks that are
+used by the abbreviation styles (see \sectionref{sec:abbrstyleinit}).
+
+\cmddef{glsxtrnewabbrevpresetkeyhook}
+This hook is provided for further customisation, if required.
+It's implemented before the entry is defined (before the
+\gloskey{shortplural} and \gloskey{longplural} keys supplied in
+\meta{options} are parsed).
+Does nothing by default. The arguments are a legacy throwback to old
+versions that didn't have \gls{glsxtrorgshort}.
+
+\cmddef{newabbreviationhook}
+This hook is performed just before the entry is defined.
+Does nothing by default.
+
+\section{Examples: \appfmt{makeindex} vs
+\appfmt{bib2gls}}
+\label{sec:abbrvmakeindexvsbib2gls}
+
+Example document using \app{makeindex}:
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\cmd{usepackage}\marg{glossaries-extra}
+\gls{makeglossaries}
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{an example}}
+\gls{newabbreviation}\marg{xml}\marg{XML}\marg{extensible markup language}
+\gls{newacronym}\marg{nasa}\marg{NASA}\marg{National Aeronautics and Space Administration}
+\cbeg{document}
+First use: \gls{gls}\marg{sample}, \gls{gls}\marg{xml} and \gls{gls}\marg{nasa}.
+Next use: \gls{gls}\marg{sample}, \gls{gls}\marg{xml} and \gls{gls}\marg{nasa}.
+\gls{printglossaries}
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample*[arara={pdflatex,makeglossaries,pdflatex,pdfcrop},
+ label{ex:newabbVSnewacVSnewentry},
+ title={\cmd{newabbreviation} vs \cmd{newacronym} vs \cmd{newglossaryentry}},
+ description={Example document illustrating the difference between
+ \cmd{newabbreviation}, \cmd{newacronym} and \cmd{newglossaryentry}}]
+{%
+\cmd{usepackage}\marg{glossaries-extra}^^J%
+\gls{makeglossaries}^^J%
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{an
+example}}^^J%
+\gls{newabbreviation}\marg{xml}\marg{XML}\marg{extensible markup
+language}^^J%
+\gls{newacronym}\marg{nasa}\marg{NASA}\marg{National Aeronautics and
+Space Administration}%
+}
+{%
+First use: \gls{gls}\marg{sample}, \gls{gls}\marg{xml} and \gls{gls}\marg{nasa}.
+Next use: \gls{gls}\marg{sample}, \gls{gls}\marg{xml} and
+\gls{gls}\marg{nasa}.^^J%
+\gls{printglossaries}
+}
+\end{resultbox}
+Note that the long form of NASA isn't displayed on the
+\idx{firstuse} of \code{\gls{gls}\marg{nasa}}. This is because the
+\cat{acronym} category uses the \abbrstyle{short} style by default.
+
+In the above example, all entries are placed in the main (default)
+glossary. The package options \opt{abbreviations} and \opt{acronyms}
+can be used to split them off into separate glossaries.
+
+If you use \app{bib2gls}, the analogous \ext!{bib} entry types are
+\atentry{abbreviation} and \atentry{acronym}. The above example can
+be rewritten to use \app{bib2gls}:
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\cbeg{filecontents*}\marg{\gls{jobname}.bib}
+\atentry{entry}\marg{sample,
+ \gloskeyval{name}{sample},
+ \gloskeyval{description}{an example}
+}
+\atentry{abbreviation}\marg{xml,
+ \gloskeyval{short}{XML},
+ \gloskeyval{long}{extensible markup language}
+}
+\atentry{acronym}\marg{nasa,
+ \gloskeyval{short}{NASA},
+ \gloskeyval{long}{National Aeronautics and Space Administration}
+}
+\cend{filecontents*}
+\cmd{usepackage}\oarg{\opt{record}}\marg{glossaries-extra}
+\gls{GlsXtrLoadResources}
+\cbeg{document}
+First use: \gls{gls}\marg{sample}, \gls{gls}\marg{xml} and \gls{gls}\marg{nasa}.
+Next use: \gls{gls}\marg{sample}, \gls{gls}\marg{xml} and \gls{gls}\marg{nasa}.
+\gls{printunsrtglossaries}
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample*[arara={pdflatex,bib2gls,pdflatex,pdfcrop},
+ label{ex:atabbVSatacVSatentry},
+ title={\code{@abbreviation} vs \code{@acronym} vs \code{@entry}},
+ description={Example document illustrating the difference between
+ \code{@abbreviation}, \code{@acronym} and \code{@entry}}]
+{%
+\cbeg{filecontents*}\marg{\gls{jobname}.bib}^^J%
+@entry{sample,^^J%
+ name={sample},^^J%
+ description={an example}^^J%
+}^^J%
+@abbreviation{xml,^^J%
+ short={XML},^^J%
+ long={extensible markup language}^^J%
+}^^J%
+@acronym{nasa,^^J%
+ short={NASA},^^J%
+ long={National Aeronautics and Space Administration}^^J%
+}^^J%
+\cend{filecontents*}^^J%
+\cmd{usepackage}\oarg{record}\marg{glossaries-extra}^^J%
+\gls{GlsXtrLoadResources}
+}
+{%
+First use: \gls{gls}\marg{sample}, \gls{gls}\marg{xml} and \gls{gls}\marg{nasa}.^^J%
+Next use: \gls{gls}\marg{sample}, \gls{gls}\marg{xml} and \gls{gls}\marg{nasa}.^^J%
+\gls{printunsrtglossaries}
+}
+\end{resultbox}
+
+\section{Referencing (Using) Abbreviations}
+\label{sec:abbrvfieldrefs}
+
+Since \gls{newabbreviation} internally uses \gls{newglossaryentry},
+you can reference abbreviations with the \gls{glslike} commands as with other entries.
+Remember that you can use the \glsopt{prereset} and
+\glsopt{preunset} options to reset or unset the \idx{firstuseflag}
+(see \sectionref{sec:glsunset}).
+
+In general it's best not to use \gls{glsfirst},
+\gls{glsfirstplural}, \gls{glstext}, \gls{glsplural} or their
+case-changing variants as many of the abbreviation styles are too
+complicated for those commands. If you specifically want the full
+form, use \gls{gls} with \glsopt{prereset} or use \gls{glsxtrfull}.
+If you specifically want the short form for a particular instance, use \gls{gls} with
+\glsopt{preunset} or use \gls{glsxtrshort}. If you only want the
+long form for a particular instance, use \gls{glsxtrlong}.
+
+If you never want the short form with \gls{gls}, use one of the \qt{noshort}
+styles, such as \abbrstyle{long-noshort}. If you never want the long
+form with \gls{gls}, use one of the \qt{nolong} styles, such as
+\abbrstyle{short-nolong}.
+
+\begin{information}
+If you need to use abbreviations in headings or captions, use
+commands like \gls{glsfmtshort} and \gls{glsfmtlong} (see
+\sectionref{sec:headingcommands}). Commands like \gls{glsentryname}
+are likely to contain non-expandable content.
+\end{information}
-\end{enumerate}
+Example:
+\begin{codebox}
+\cmd{usepackage}\oarg{colorlinks}\marg{hyperref}
+\cmd{usepackage}\marg{glossaries-extra}
+\gls{makeglossaries}
+\gls{newabbreviation}\marg{svm}\marg{SVM}\marg{support vector machine}
+\gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}
+\codepar
+\cbeg{document}
+\gls{tableofcontents}
+\cmd{section}\marg{Introducing the \gls{glsfmtlong}\marg{svm}}
+First use: \gls{gls}\marg{svm}.
+Next use: \gls{gls}\marg{svm}.
+\codepar
+\cmd{section}\marg{Introducing \gls{gls}\marg{html} (incorrect)}
+First use (not!): \gls{gls}\marg{html}.
+Next use: \gls{gls}\marg{html}.
+\codepar
+\gls{glsreset}\marg{html}
+\cmd{section}\marg{Introducing \gls{glsxtrshort}\marg{html} (incorrect)}
+First use: \gls{gls}\marg{html}.
+Next use: \gls{gls}\marg{html}.
+\codepar
+\gls{glsreset}\marg{html}
+\cmd{section}\marg{Introducing \gls{glsfmtshort}\marg{html}}
+First use: \gls{gls}\marg{html}.
+Next use: \gls{gls}\marg{html}.
+\codepar
+\gls{printglossaries}
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample*[arara={pdflatex,makeglossaries,pdflatex,pdfcrop},
+ label={ex:abbrhyper},
+ title={Referencing an abbreviation (with \styfmt{hyperref})},
+ description={Example document illustrating referencing an
+ abbreviation (with hyperref)}]
+{%
+\cmd{usepackage}\oarg{colorlinks}\marg{hyperref}^^J%
+\cmd{usepackage}\marg{glossaries-extra}^^J%
+\gls{makeglossaries}^^J%
+\gls{newabbreviation}\marg{svm}\marg{SVM}\marg{support vector machine}^^J%
+\gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup
+language}^^J%
+}
+{%
+\gls{tableofcontents}^^J%
+\cmd{section}\marg{Introducing the \gls{glsfmtlong}\marg{svm}}^^J%
+First use: \gls{gls}\marg{svm}.^^J%
+Next use: \gls{gls}\marg{svm}.
+\codepar
+\cmd{section}\marg{Introducing \gls{gls}\marg{html} (incorrect)}^^J%
+First use (not!): \gls{gls}\marg{html}.^^J%
+Next use: \gls{gls}\marg{html}.
+\codepar
+\gls{glsreset}\marg{html}^^J%
+\cmd{section}\marg{Introducing \gls{glsxtrshort}\marg{html} (incorrect)}^^J%
+First use: \gls{gls}\marg{html}.^^J%
+Next use: \gls{gls}\marg{html}.^^J%
+\codepar
+\gls{glsreset}\marg{html}^^J%
+\cmd{section}\marg{Introducing \gls{glsfmtshort}\marg{html}}^^J%
+First use: \gls{gls}\marg{html}.^^J%
+Next use: \gls{gls}\marg{html}.^^J%
+\gls{printglossaries}
+}
+\end{resultbox}
+In the above example, compare the first section heading (which
+references an abbreviation with \gls{glsfmtlong}) with the second
+section heading (which references an abbreviation with \gls{gls}).
+Note that the \idx{firstuse} of the \code{html} entry actually
+occurs in the table of contents, which results in the full form
+showing in the table of contents, but only the abbreviation is
+shown in the actual section~2 heading. The PDF bookmark shows the entry label
+(\code{html}) not the abbreviation (HTML).
+There is also a nested link for section~2 in the table of contents.
+In some PDF viewers (such as Okular), this will lead to section~2
+but, in others (such as Evince), it will lead to the HTML entry
+target in the glossary. Similarly for section~3.
+
+As with the base \sty{glossaries} package, the unformatted short and long forms
+can be obtained with \gls{glsentryshort} and \gls{glsentrylong} or,
+for the plural forms, \gls{glsentryshortpl} and
+\gls{glsentrylongpl}. These are analogous to commands like
+\gls{glsentrytext} and may be used in expandable contexts. The
+sentence case versions (\gls{Glsentryshort},
+\gls{Glsentrylong}, \gls{Glsentryshort}, and \gls{Glsentrylong}) are all robust
+in \sty{glossaries} v4.49 and lower. As from \sty{glossaries} v4.50,
+they can expand in PDF bookmarks, but outside of PDF bookmarks they
+will expand to a robust internal command.
-For these reasons it's better to use the simple expandable commands like
-\ics{glsentrytext} or \ics{glsentryshort} in the definition
-of other entries (although that doesn't fix the first problem).
-
-Alternatively use something like:
-\begin{verbatim}
-\newacronym
- [description={\acrshort{ssi} enabled \acrshort{html}}]
- {shtml}{SHTML}{SSI enabled HTML}
-\end{verbatim}
-with \styfmt{glossaries} or:
-\begin{verbatim}
-\newabbreviation
- [description={\glsxtrshort{ssi} enabled \glsxtrshort{html}}]
- {shtml}{SHTML}{SSI enabled HTML}
-\end{verbatim}
-with \styfmt{glossaries-extra}. This fixes all the above
-listed problems (as long as you don't use \ics{glsdesc}).
-Note that replacing \cs{gls} with \cs{acrshort} in the original
-example may fix the \gls{firstuse} issue, but it doesn't
-fix any of the other problems listed above.
-
-If it's simply that you want to use the abbreviation font, you can
-use \cs{glsabbrvfont}:
-\begin{verbatim}
-\setabbreviationstyle{long-short-sc}
-
-\newabbreviation{ssi}{ssi}{server-side includes}
-\newabbreviation{html}{html}{hypertext markup language}
-\newabbreviation{shtml}{shtml}{\glsabbrvfont{ssi} enabled
-\glsabbrvfont{html}}
-\end{verbatim}
-This will pick up the font style setting of the outer entry (shtml,
-in the above case). This isn't a problem in the above example as all
-the abbreviations use the same style.
-
-If the term can simply be treated as a series of previously defined
-entries, then consider using multi-entries (or compound sets). See
-\sectionref{sec:multientries} for further details.
-
-However, if you're really determined to use
-\ics{gls} in a field that may be included within
-some \gls{linktext}, \styfmt{glossaries-extra} patches internals
-used by the linking commands so that if \cs{gls} (or plural or
-case changing variants) occurs in the \gls{linktext} it will
-behave as though you used
-\texttt{\ics{glstext}[hyper=false,noindex]}
-instead. Grouping is also added so that, for example, when
-\verb|\gls{shtml}| is used for the first time the long form
-\begin{verbatim}
-\gls{ssi} enabled \gls{html}
-\end{verbatim}
-is treated as
-\begin{verbatim}
-{\glstext[hyper=false,noindex]{ssi}} enabled
-{\glstext[hyper=false,noindex]{html}}
-\end{verbatim}
-This overcomes problems~\ref{itm:inconsistentfirstuseprob},
-\ref{itm:indexingprob} and \ref{itm:nestedhyplinkprob} listed
-above, but still doesn't fix problems~\ref{itm:nestedfirstucprob}
-and \ref{itm:nonexpandprob}.
-Problem~\ref{itm:nestedsortprob} usually won't be an issue as most abbreviation
-styles set the \gloskey{sort} key to the short form, so using these
-commands in the long form but not the short form will only affect
-entries with a style that sorts according to the long form (such as
-\abbrstyle{long-noshort-desc}).
-
-Additionally, any instance of the long form commands, such
-as \ics{glsxtrlong} or \ics{acrlong} will be temporarily
-redefined to just use
-\begin{alltt}
-\{\ics{glsentrylong}\marg{label}\meta{insert}\}
-\end{alltt}
-(or case-changing versions). Similarly the short form commands,
-such as \ics{glsxtrshort} or \ics{acrshort} will use
-\ics{glsentryshort} in the argument of either \cs{glsabbrvfont}
-(for \cs{glsxtrshort}) or \cs{acronymfont} (for \cs{acrshort}).
-So if the \texttt{shtml} entry had instead been defined as:
-\begin{verbatim}
-\newacronym{shtml}{SHTML}{\acrshort{ssi} enabled \acrshort{html}}
-\end{verbatim}
-then (using the \abbrstyle{long-short} style) the \gls{firstuse}
-will be like
-\begin{verbatim}
-{\acronymfont{\glsentryshort{ssi}}} enabled
-{\acronymfont{\glsentryshort{html}}} (SHTML)
-\end{verbatim}
-whereas if the entry is defined as:
-\begin{verbatim}
-\newabbreviation{shtml}{SHTML}{\glsxtrshort{ssi} enabled
-\glsxtrshort{html}}
-\end{verbatim}
-then the \gls{firstuse} will be like:
-\begin{verbatim}
-{\glsabbrvfont{\glsentryshort{ssi}}} enabled
-{\glsabbrvfont{\glsentryshort{html}}} (SHTML)
-\end{verbatim}
-Note that the first optional argument of
-\cs{acrshort} or \cs{glsxtrshort} is ignored in this context.
-(The final optional argument will be inserted, if present.)
-The abbreviation style that governs \ics{glsabbrvfont} will be
-set for \ics{glsxtrshort}. Note that \cs{acrshort} doesn't
-set the abbreviation style.
-
-Alternatively you can use:
-\begin{definition}[\DescribeMacro\glsxtrp]
-\cs{glsxtrp}\marg{field}\marg{label}
-\end{definition}
-where \meta{field} is the field label and corresponds to a
-command in the form \cs{gls}\meta{field} (e.g.\ \cs{glstext}) or
-in the form \cs{glsxtr}\meta{field} (e.g.\ \cs{glsxtrshort}).
-
-There's a shortcut command for the most common fields:
-\begin{definition}[\DescribeMacro\glsps]
-\cs{glsps}\marg{label}
-\end{definition}
-which is equivalent to \verb|\glsxtrp{short}|\marg{label}, and
-\begin{definition}[\DescribeMacro\glspt]
-\cs{glspt}\marg{label}
-\end{definition}
-which is equivalent to \verb|\glsxtrp{text}|\marg{label}.
-
-The \cs{glsxtrp} command behaves much like the
-\cs{glsfmt}\meta{field} commands described in
-\sectionref{sec:headtitle} but the post-link hook is also
-suppressed and extra grouping is added. It automatically sets
-\gloskey[glslink]{hyper} to \texttt{false} and
-\gloskey[glslink]{noindex} to \texttt{true}. If you want to change
-this, you can use
-\begin{definition}[\DescribeMacro\glsxtrsetpopts]
-\cs{glsxtrsetpopts}\marg{options}
-\end{definition}
-For example:
-\begin{verbatim}
-\glsxtrsetpopts{hyper=false}
-\end{verbatim}
-will just switch off the hyperlinks but not the indexing.
-Be careful using this command or you can end up back to the
-original problem of nested links.
-
-The hyper link is re-enabled within glossaries. This is
-done through the command:
-\begin{definition}[\DescribeMacro\glossxtrsetpopts]
-\cs{glossxtrsetpopts}
-\end{definition}
-which by default just does
-\begin{verbatim}
-\glsxtrsetpopts{noindex}
-\end{verbatim}
-You can redefine this if you want to adjust the setting when
-\cs{glsxtrp} is used in the glossary. For example:
-\begin{verbatim}
-\renewcommand{\glossxtrsetpopts}{\glsxtrsetpopts{noindex=false}}
-\end{verbatim}
-
-For example,
-\begin{verbatim}
-\glsxtrp{short}{ssi}
-\end{verbatim}
-is equivalent to
-\begin{verbatim}
-{\let\glspostlinkhook\relax
- \glsxtrshort[hyper=false,noindex]{ssi}[]%
-}
-\end{verbatim}
-in the main body of the document or
-\begin{verbatim}
-{\let\glspostlinkhook\relax
- \glsxtrshort[noindex]{ssi}[]%
-}
-\end{verbatim}
-inside the glossary. (Note the post-link hook is locally disabled.)
-
-If \verb|\glsxtrp{short}{ssi}| occurs in a sectioning mark,
-it's equivalent to
-\begin{verbatim}
-{\glsxtrheadshort{ssi}}
-\end{verbatim}
-(which recognises the \catattr{headuc} attribute.)
-
-If \sty{hyperref} has been loaded, then the bookmark will
-use \cs{glsentry}\meta{field}
-(\verb|\glsentryshort{ssi}| in the above example).
-
-There are similar commands
-\begin{definition}[\DescribeMacro\Glsxtrp]
-\cs{Glsxtrp}\marg{field}\marg{label}
-\end{definition}
-for first letter upper case and
-\begin{definition}[\DescribeMacro\GLSxtrp]
-\cs{GLSxtrp}\marg{field}\marg{label}
-\end{definition}
-for all upper case.
+\begin{important}
+Don't use the base \sty{glossaries} package's acronym commands, such
+as \gls{acrshort}. These aren't compatible with \gls{newabbreviation}.
+\end{important}
+
+Each abbreviation style has a \idx{displayfullform}, which is the
+format produced with the \idx{firstuse} of \gls{gls}, and an
+\idx{inlinefullform}, which is the format produced by
+\gls{glsxtrfull}. For some styles, such as \abbrstyle{long-short},
+the \idxc{displayfullform}{display} and \idxc{inlinefullform}{inline} forms are identical.
+
+The example below demonstrates the difference between the
+\idx{firstuse} of \gls{gls} compared with the \idx{inlinefullform} for
+the \abbrstyle{footnote} abbreviation style. The
+example also uses \gls{glsfirst} to demonstrate that it produces an
+undesirable result with the selected abbreviation style.
+\begin{coderesult}
+\gls{setabbreviationstyle}\marg{footnote}
+\gls{newabbreviation}\marg{nasa}\marg{NASA}\marg{National Aeronautics and Space
+Administration}
+\codepar
+\cbeg{document}
+\gls{gls}\marg{nasa}\oarg{'s} space
+exploration\cmd{ldots}
+\codepar
+\gls{glsxtrfull}\marg{nasa}\oarg{'s} space
+exploration\cmd{ldots}
+\codepar
+\gls{glsfirst}\marg{nasa}\oarg{'s} space
+exploration\cmd{ldots}
+\cend{document}
+\tcblower
+\createexample*[fontsize={20},
+ label={ex:glsVSfullVSfirst},
+ title={First use of \cmd{gls} vs \cmd{glsxtrfull} vs \cmd{glsfirst}},
+ description={Example document illustrating the difference between
+ the first use of \cmd{gls} compared with \cmd{glsxtrfull} and
+ \cmd{glsfirst}}]
+{%
+\cmd{usepackage}\marg{glossaries-extra}^^J%
+\gls{setabbreviationstyle}\marg{footnote}^^J%
+\gls{newabbreviation}\marg{nasa}\marg{NASA}\marg{National Aeronautics and Space Administration}^^J%
+}
+{%
+\gls{gls}\marg{nasa}\oarg{'s} space exploration\cmd{ldots}^^J%
+\codepar
+\gls{glsxtrfull}\marg{nasa}\oarg{'s} space exploration\cmd{ldots}^^J%
+\codepar
+\gls{glsfirst}\marg{nasa}\oarg{'s} space exploration\cmd{ldots}^^J%
+}
+\end{coderesult}
+In the above, the \idx{firstuse} of \gls{gls} puts the long form in
+the footnote but correctly inserts the final optional argument
+before the footnote marker. The \idx{inlinefullform} (obtained with
+\gls{glsxtrfull}) doesn't use a footnote, but instead shows the long
+form in parentheses after the short form. The insert material is
+correctly placed after the short form.
+Compare this with the final line, which uses \gls{glsfirst}. This
+shows the long form in the footnote, but the inserted material can't
+be shifted before the footnote marker, which results in the strange
+\qt{NASA\textsuperscript{2}'s}.
+
+The following commands are included in the set of
+\idx{glstextlike} commands. They have the \idxc{glsopt}{same
+options} as \gls{glstext} and don't change the \idx{firstuseflag}.
+They will index (unless \glsopt{noindex} is used), create a
+hyperlink (if enabled), and use the \idx{postlinkhook}.
+
+\cmddef{glsxtrshort}
+Displays the short form using the abbreviation style's formatting.
+
+\cmddef{Glsxtrshort}
+As above, but \idx{sentencecase} version.
+
+\cmddef{GLSxtrshort}
+As above, but \idx{allcaps} version.
+
+\cmddef{glsxtrshortpl}
+Displays the short plural form using the abbreviation style's formatting.
+
+\cmddef{Glsxtrshortpl}
+As above, but \idx{sentencecase} version.
+
+\cmddef{GLSxtrshortpl}
+As above, but \idx{allcaps} version.
+
+\cmddef{glsxtrlong}
+Displays the long form using the abbreviation style's formatting.
+As from v1.49, this command simulates \idx{firstuse} by defining
+\gls{glsxtrifwasfirstuse} to do its first argument. This is done via
+the command:
+\cmddef{glsxtrsetlongfirstuse}
+which is defined as:
+\begin{compactcodebox}
+\cmd{newcommand}\marg{\gls{glsxtrsetlongfirstuse}}[1]\marg{\comment{}
+ \cmd{let}\gls{glsxtrifwasfirstuse}\gls+{@firstoftwo}\comment{}
+}
+\end{compactcodebox}
+This command takes the entry label as the argument, which is
+ignored by default.
+
+To restore the original behaviour, redefine this command as follows:
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{glsxtrsetlongfirstuse}}[1]\marg{\comment{}
+ \cmd{letcs}\gls{glsxtrifwasfirstuse}\marg{@secondoftwo}\comment{}
+}
+\end{codebox}
+This command is also used by the case-changing and plural variants
+listed below.
+
+\cmddef{Glsxtrlong}
+As above, but \idx{sentencecase} version.
+
+\cmddef{GLSxtrlong}
+As above, but \idx{allcaps} version.
+
+\cmddef{glsxtrlongpl}
+Displays the long plural form using the abbreviation style's formatting.
+
+\cmddef{Glsxtrlongpl}
+As above, but \idx{sentencecase} version.
+
+\cmddef{GLSxtrlongpl}
+As above, but \idx{allcaps} version.
+
+\cmddef{glsxtrfull}
+Displays the \idx{inlinefullform} using the abbreviation style's formatting.
+Depending on the style, this may not be the same as the text
+produced with the \idx{firstuse} of \gls{gls}.
+
+\cmddef{Glsxtrfull}
+As above, but \idx{sentencecase} version.
+
+\cmddef{GLSxtrfull}
+As above, but \idx{allcaps} version.
+
+\cmddef{glsxtrfullpl}
+Displays the \idxc{inlinefullform}{inline full plural form} using the abbreviation style's formatting.
+Depending on the style, this may not be the same as the text
+produced with the \idx{firstuse} of \gls{glspl}.
+
+\cmddef{Glsxtrfullpl}
+As above, but \idx{sentencecase} version.
+
+\cmddef{GLSxtrfullpl}
+As above, but \idx{allcaps} version.
+
+\cmddef{glsxtrsetupfulldefs}
+This hook is used within \gls{glsxtrfull}, \gls{glsxtrfullpl} and
+the case-changing variations to initialise
+\gls{glsxtrifwasfirstuse} in case it's required in the
+\idx{postlinkhook}. The default definition is to simulate
+\idx{firstuse}. Note that changing this can cause unexpected results
+with abbreviation styles that set the \idx{postlinkhook}, such as
+\abbrstyle{short-postlong-user}.
+
+\cmddef{glsxtrfullsaveinsert}
+This hook is used within \gls{glsxtrfull}, \gls{glsxtrfullpl} and
+the case-changing variations to initialise the \gls{glsinsert}
+placeholder. The default definition is to use
+\gls{glsxtrsaveinsert}. If the insert isn't saved, it can't be used
+within the \idx{postlinkhook} for the \gls{glsxtrfull} etc.
+This affects the behaviour of the \qt{post-hyphen} abbreviation
+styles, such as \abbrstyle{long-hyphen-postshort-hyphen}.
+
+\subsection{Prefixes}
+\label{sec:abbrprefixes}
+
+If you are using the \sty{glossaries-prefix} package (which can
+be loaded via the \opt{prefix} package option), then there are
+commands similar to \gls{glsxtrshort} and \gls{glsxtrlong} that
+insert the corresponding prefix and separator at the front if the
+short or long form, if the prefix has been set and is non-empty. In all cases, the
+separator is \gls{glsprefixsep}, as with \gls{pgls}.
\begin{important}
-If you use any of the case-changing commands, such as \ics{Gls}
-or \ics{Glstext}, (either all caps or first letter upper casing)
-don't use any of the linking commands, such as \ics{gls} or
-\ics{glstext}, in the definition of entries for any of the
-fields that may be used by those case-changing commands.
+These commands require \sty{glossaries-prefix}.
\end{important}
-You can, with care, protect against issue~\ref{itm:nestedfirstucprob} by
-inserting an empty group at the start if the long form starts with a
-command that breaks the first letter uppercasing commands like
-\cs{Gls}, but you still won't be able to use the all caps commands,
-such as \cs{GLS}.
+\cmddef{pglsxtrshort}
+As \gls{glsxtrshort} but inserts the \gloskey{prefix} field
+and separator, if the \gloskey{prefix} value is set and non-empty.
-If you \emph{really need} nested commands, the safest method is
-\begin{verbatim}
-\newabbreviation{shtml}{shtml}{{}\glsxtrp{short}{ssi} enabled
-\glsxtrp{short}{html}}
-\end{verbatim}
-but be aware that it may have some unexpected results occasionally.
+\cmddef{Pglsxtrshort}
+As \gls{pglsxtrshort} but \idx{sentencecase}. Note the initial
+\qt{P} in the command name, which matches \gls{Pgls} (similarly for
+the other prefix \idx{sentencecase} commands).
-Example document:
-\begin{verbatim}
-\documentclass{report}
+\cmddef{PGLSxtrshort}
+As \gls{pglsxtrshort} but \idx{allcaps}.
-\usepackage[utf8]{inputenc}
-\usepackage[T1]{fontenc}
-\usepackage{slantsc}
-\usepackage[colorlinks]{hyperref}
-\usepackage[nopostdot=false]{glossaries-extra}
+\cmddef{pglsxtrshortpl}
+As \gls{glsxtrshortpl} but inserts the \gloskey{prefixplural} field
+and separator, if the \gloskey{prefixplural} value is set and non-empty.
-\makeglossaries
+\cmddef{Pglsxtrshortpl}
+As \gls{pglsxtrshortpl} but \idx{sentencecase}.
-\setabbreviationstyle{long-short-sc}
+\cmddef{PGLSxtrshortpl}
+As \gls{pglsxtrshortpl} but \idx{allcaps}.
-\newabbreviation{ssi}{ssi}{server-side includes}
-\newabbreviation{html}{html}{hypertext markup language}
-\newabbreviation{shtml}{shtml}{{}\glsps{ssi} enabled {}\glsps{html}}
+\cmddef{pglsxtrlong}
+As \gls{glsxtrlong} but inserts the \gloskey{prefixfirst} field
+and separator, if the \gloskey{prefixfirst} value is set and non-empty.
-\pagestyle{headings}
+\cmddef{Pglsxtrlong}
+As \gls{pglsxtrlong} but \idx{sentencecase}.
-\glssetcategoryattribute{abbreviation}{headuc}{true}
-\glssetcategoryattribute{abbreviation}{glossdesc}{title}
+\cmddef{PGLSxtrlong}
+As \gls{pglsxtrlong} but \idx{allcaps}.
-\begin{document}
+\cmddef{pglsxtrlongpl}
+As \gls{glsxtrlongpl} but inserts the \gloskey{prefixfirstplural} field
+and separator, if the \gloskey{prefixfirstplural} value is set and non-empty.
-\tableofcontents
+\cmddef{Pglsxtrlongpl}
+As \gls{pglsxtrlongpl} but \idx{sentencecase}.
-\chapter{\glsfmtfull{shtml}}
+\cmddef{PGLSxtrlongpl}
+As \gls{pglsxtrlongpl} but \idx{allcaps}.
-First use: \gls{shtml}, \gls{ssi} and \gls{html}.
+\subsection{Abbreviation Shortcut Commands}
+\label{sec:abbrshortcuts}
-Next use: \gls{shtml}, \gls{ssi} and \gls{html}.
+The abbreviation shortcut commands can be enabled using
+the \opteqvalref{shortcuts}{abbreviations} package option (or
+\opteqvalref{shortcuts}{abbr} or \opteqvalref{shortcuts}{ac}).
+The provided shortcut commands listed in
+\tableref{tab:abbrshortcuts}. Note that
+\gls{glsxtrenablerecordcount} will switch the shortcuts that use the
+\gls{cgls}-like commands to the corresponding \gls{rgls}-like
+command.
-\newpage
-Next page.
+\begin{table}[htbp]
+\caption{Abbreviation Shortcut Commands}
+\label{tab:abbrshortcuts}
+\centering
+\begin{tabular}{lll}
+\bfseries Shortcut &
+\bfseries Shortcut &
+\bfseries Equivalent Command\\
+\bfseries (\opteqvalref{shortcuts}{abbreviations}) &
+\bfseries (\opteqvalref{shortcuts}{ac})\\
+\inlineglsdef{ab} & \inlineglsdef{ac} & \gls{cgls}\\
+\inlineglsdef{abp} & \inlineglsdef{acp} & \gls{cglspl}\\
+\inlineglsdef{as} & \inlineglsdef{acs} & \gls{glsxtrshort}\\
+\inlineglsdef{asp} & \inlineglsdef{acsp} & \gls{glsxtrshortpl}\\
+\inlineglsdef{al} & \inlineglsdef{acl} & \gls{glsxtrlong}\\
+\inlineglsdef{alp} & \inlineglsdef{aclp} & \gls{glsxtrlongpl}\\
+\inlineglsdef{af} & \inlineglsdef{acf} & \gls{glsxtrfull}\\
+\inlineglsdef{afp} & \inlineglsdef{acfp} & \gls{glsxtrfullpl}\\
+\inlineglsdef{Ab} & \inlineglsdef{Ac} & \gls{cgls}\\
+\inlineglsdef{Abp} & \inlineglsdef{Acp} & \gls{cglspl}\\
+\inlineglsdef{As} & \inlineglsdef{Acs} & \gls{Glsxtrshort}\\
+\inlineglsdef{Asp} & \inlineglsdef{Acsp} & \gls{Glsxtrshortpl}\\
+\inlineglsdef{Al} & \inlineglsdef{Acl} & \gls{Glsxtrlong}\\
+\inlineglsdef{Alp} & \inlineglsdef{Aclp} & \gls{Glsxtrlongpl}\\
+\inlineglsdef{Af} & \inlineglsdef{Acf} & \gls{Glsxtrfull}\\
+\inlineglsdef{Afp} & \inlineglsdef{Acfp} & \gls{Glsxtrfullpl}\\
+\inlineglsdef{AB} & \inlineglsdef{AC} & \gls{cGLS}\\
+\inlineglsdef{ABP} & \inlineglsdef{ACP} & \gls{cGLSpl}\\
+\inlineglsdef{AS} & \inlineglsdef{ACS} & \gls{GLSxtrshort}\\
+\inlineglsdef{ASP} & \inlineglsdef{ACSP} & \gls{GLSxtrshortpl}\\
+\inlineglsdef{AL} & \inlineglsdef{ACL} & \gls{GLSxtrlong}\\
+\inlineglsdef{ALP} & \inlineglsdef{ACLP} & \gls{GLSxtrlongpl}\\
+\inlineglsdef{AF} & \inlineglsdef{ACF} & \gls{GLSxtrfull}\\
+\inlineglsdef{AFP} & \inlineglsdef{ACFP} & \gls{GLSxtrfullpl}\\
+\inlineglsdef{newabbr} & \gls{newabbr} & \gls{newabbreviation}
+\end{tabular}
+\end{table}
+
+\section{Tagging Initials}
+\label{sec:tagging}
+
+Initial tagging allows you to highlight the initials that form the
+abbreviation when the long form is shown in the glossary.
+
+\cmddef{GlsXtrEnableInitialTagging}
+
+\begin{information}
+\gls{GlsXtrEnableInitialTagging} must be placed before the abbreviations are defined.
+\end{information}
+
+This command (robustly) defines \meta{cs} (a control sequence)
+to accept a single argument, which is the letter (or letters)
+that needs to be tagged. The normal behaviour of \meta{cs}
+within the document is to simply do its argument, but in the
+glossary it's activated for those categories that have
+the \catattr{tagging} attribute set to \qt{true}. For those
+cases it will use:
+\cmddef{glsxtrtagfont}
+This command defaults to \code{\gls{underline}\margm{text}}
+but may be redefined as required.
+
+The control sequence \meta{cs} can't already be defined when
+used with the unstarred version of
+\gls{GlsXtrEnableInitialTagging} for safety reasons.
+The starred version will overwrite any previous definition
+of \meta{cs}. As with redefining any commands, ensure that
+you don't redefine something important.
+
+The first argument of \gls{GlsXtrEnableInitialTagging} is a
+comma-separated list of category names. The \catattr{tagging}
+attribute will automatically be set to \code{true} for those categories.
+You can later set this attribute for other categories (see
+\sectionref{sec:categories}) but this must be done before the
+glossary is displayed.
+
+For example, the following uses initial tagging for both the \cat{acronym} and
+\cat{abbreviation} categories. The custom command \csfmt{itag} is
+defined as the tagging command.
+\begin{codebox}
+\gls{makeglossaries}
+\gls{GlsXtrEnableInitialTagging}\marg{\cat{acronym},\cat{abbreviation}}\marg{\cmd{itag}}
+\gls{setabbreviationstyle}\oarg{\cat{acronym}}\marg{\abbrstyle{short-nolong-desc}}
+\gls{newacronym}
+ \oarg{description=\marg{a system for detecting the location and
+ speed of ships, aircraft, etc, through the use of radio
+ waves}\comment{description of this term}
+ }
+ \marg{radar}\comment{identifying label}
+ \marg{radar}\comment{short form}
+ \marg{\cmd{itag}\marg{ra}dio \cmd{itag}\marg{d}etection \cmd{itag}\marg{a}nd \cmd{itag}\marg{r}anging}
+\codepar
+\gls{newabbreviation}\marg{xml}\marg{XML}
+ \marg{e\cmd{itag}\marg{x}tensible \cmd{itag}\marg{m}arkup \cmd{itag}\marg{l}anguage}
+\codepar
+\gls{newabbreviation}\oarg{\gloskeyval{category}{other}}\marg{tne}\marg{TNE}
+ \marg{\cmd{itag}\marg{t}agging \cmd{itag}\marg{n}ot \cmd{itag}\marg{e}nabled}
+\codepar
+\cbeg{document}
+First use: \gls{gls}\marg{radar}, \gls{gls}\marg{xml}, \gls{gls}\marg{tne}.
+\codepar
+Long form only: \gls{glsxtrlong}\marg{radar}, \gls{glsxtrlong}\marg{xml}, \gls{glsxtrlong}\marg{tne}.
+\gls{printglossaries}
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample*[arara={pdflatex,makeglossaries,pdflatex,pdfcrop},
+ label={ex:tagging},
+ title={Tagging abbreviation initials},
+ description={Example document illustrating the use of
+\cmd{GlsXtrEnableInitialTagging} to tag initial letters that form
+the abbreviation}]
+{%
+\cmd{usepackage}\marg{glossaries-extra}^^J%
+\gls{makeglossaries}^^J%
+\gls{GlsXtrEnableInitialTagging}\marg{acronym,abbreviation}\marg{\cmd{itag}}^^J%
+\gls{setabbreviationstyle}\oarg{acronym}\marg{short-nolong-desc}^^J%
+\gls{newacronym}^^J%
+ \oarg{description=\marg{a system for detecting the location and
+ speed of ships, aircraft, etc, through the use of radio
+ waves}\comment{description of this term}
+ }^^J
+ \marg{radar}\comment{identifying label}
+ \marg{radar}\comment{short form}
+ \marg{\cmd{itag}\marg{ra}dio \cmd{itag}\marg{d}etection
+\cmd{itag}\marg{a}nd \cmd{itag}\marg{r}anging}
+\codepar
+\gls{newabbreviation}\marg{xml}\marg{XML}^^J
+ \marg{e\cmd{itag}\marg{x}tensible \cmd{itag}\marg{m}arkup \cmd{itag}\marg{l}anguage}
+\codepar
+\gls{newabbreviation}\oarg{\gloskeyval{category}{other}}\marg{tne}\marg{TNE}^^J
+ \marg{\cmd{itag}\marg{t}agging \cmd{itag}\marg{n}ot \cmd{itag}\marg{e}nabled}
+}
+{%
+First use: \gls{gls}\marg{radar}, \gls{gls}\marg{xml}, \gls{gls}\marg{tne}.
+\codepar
+Long form only: \gls{glsxtrlong}\marg{radar}, \gls{glsxtrlong}\marg{xml}, \gls{glsxtrlong}\marg{tne}.^^J%
+\gls{printglossaries}
+}
+\end{resultbox}
+The underlining of the tagged letters only occurs in the
+glossary and then only for entries with the \catattr{tagging}
+attribute set.
+
+
+\section{Abbreviation Styles}
+\label{sec:abbrstyle}
+
+The style for a particular category is set using:
+\cmddef{setabbreviationstyle}
+If the \meta{category} is omitted, \cat{abbreviation} is assumed.
+Remember that \gls{newacronym} sets the \gloskey{category} to
+\cat{acronym} so with \gls{newacronym} you need to change the style with:
+\begin{codebox}
+\gls{setabbreviationstyle}\oarg{\cat{acronym}}\margm{style-name}
+\end{codebox}
+
+\begin{important}
+The abbreviation style must be set before the abbreviation with the
+corresponding category is defined. If you are using \app{bib2gls},
+the style must be set before \gls{GlsXtrLoadResources}.
+\end{important}
+
+The style associated with the \cat{abbreviation} category will be
+used if an abbreviation is defined with a category that doesn't have
+an associated style.
+
+Once you have defined an abbreviation with a given category, you
+can't subsequently change the style for that category. You can't
+have more than one style per category. The default style for the
+\cat{abbreviation} category is \abbrstyle{long-short} and the
+default style for the \cat{acronym} category is
+\abbrstyle{short-nolong}.
+
+In the example below, the custom \code{latin} category doesn't have
+an associated abbreviation style, so it uses the style assigned to
+the \cat{abbreviation} category, not the \cat{acronym} category.
+The only reason that the \qt{radar} abbreviation (defined with
+\gls{newacronym}) uses the style associated with the \cat{acronym}
+category is because the default definition of \gls{newacronym} sets
+\gloskeyval{category}{\cat{acronym}}.
+\begin{coderesult}
+\cmd{usepackage}[T1]\marg{fontenc}
+\cmd{usepackage}\marg{glossaries-extra}
+\gls{setabbreviationstyle}\marg{long-short-sc}
+\gls{newabbreviation}\marg{html}\marg{html}\marg{hypertext markup language}
+\gls{setabbreviationstyle}\oarg{\cat{acronym}}\marg{footnote}
+\gls{newacronym}\marg{radar}\marg{radar}\marg{radio detection and ranging}
+\gls{newacronym}\oarg{\gloskeyval{category}{latin}}\marg{ibid}\marg{ibid}\marg{ibidem}
+\cbeg{document}
+\gls{gls}\marg{html}, \gls{gls}\marg{radar} and \gls{gls}\marg{ibid}.
+\gls{printunsrtglossaries}
+\cend{document}
+\tcblower
+\createexample*[fontsize=20,
+ label={ex:fallbackabbrstyle},
+ title={Category without an associated abbreviation style},
+ description={Example document that has an abbreviation with a
+category that doesn't have an associated abbreviation style}]
+{%
+\cmd{usepackage}[T1]\marg{fontenc}^^J%
+\cmd{usepackage}\marg{glossaries-extra}^^J%
+\gls{setabbreviationstyle}\marg{long-short-sc}^^J%
+\gls{newabbreviation}\marg{html}\marg{html}\marg{hypertext markup language}^^J%
+\gls{setabbreviationstyle}\oarg{acronym}\marg{footnote}^^J%
+\gls{newacronym}\marg{radar}\marg{radar}\marg{radio detection and ranging}^^J%
+\gls{newacronym}\oarg{category=latin}\marg{ibid}\marg{ibid}\marg{ibidem}
+}
+{%
+\gls{gls}\marg{html}, \gls{gls}\marg{radar} and \gls{gls}\marg{ibid}.^^J%
+\gls{printunsrtglossaries}
+}
+\end{coderesult}
+
+\subsection{Predefined Abbreviation Styles}
+\label{sec:predefabbrstyles}
+
+There are two types of abbreviation styles: those that treat the
+abbreviation as a regular entry (so that \gls{gls} uses
+\gls{glsgenentryfmt} and is encapsulated with
+\gls{glsxtrregularfont}) and those that don't treat the abbreviation
+as a regular entry (so that \gls{gls} uses \gls{glsxtrgenabbrvfmt}
+and is encapsulated with \gls{glsxtrabbreviationfont}). See
+\sectionref{sec:entryfmt} for further details of those commands.
+
+\begin{information}
+The non-regular abbreviation styles allow for more complex formats
+than the regular styles.
+\end{information}
+
+The regular entry abbreviation styles set the \catattr{regular}
+attribute to \code{true} for the category assigned to each
+abbreviation with that style. This means that on \idx{firstuse},
+\gls{gls} uses the value of the \gloskey{first} field and on
+subsequent use \gls{gls} uses the value of the \gloskey{text} field
+(and analogously for the plural and case-changing versions).
+
+The non-regular abbreviation styles don't set the \catattr{regular}
+attribute, unless it has already been set, in which case it will be
+changed to \code{false}. The \gloskey{first} and \gloskey{text}
+fields (and their plural forms) are set, but they aren't used by
+commands like \gls{gls}, which instead use formatting commands, such
+as \gls{glsxtrfullformat} and \gls{glsxtrsubsequentfmt}, which are
+defined by the style.
+
+In both cases, the \idx{firstuse} of \gls{gls} may not match the
+text produced by \gls{glsfirst} (and likewise for the plural
+and case-changing versions).
+
+The \gloskey{short} and \gloskey{long} fields are set as appropriate
+and may be accessed through commands like \gls{glsxtrshort} and
+\gls{glsxtrlong}. These may appear slightly differently to the way
+the short or long form is displayed within \gls{gls}, depending on the
+style.
+
+The sample file
+\ctanmirrornofn{macros/latex/contrib/glossaries-extra/samples/sample-abbr-styles.pdf}{\filefmt{sample-abbr-styles.pdf}}
+demonstrates all predefined styles described here.
+
+\begin{important}
+For the \qt{sc} styles that use \gls{textsc}, be careful about your
+choice of fonts as some only have limited support. For example, you
+may not be able to combine bold and small-caps. If you're using
+\pdfLaTeX, I recommend that you at least use the \sty{fontenc}
+package with the \optfmt{T1} option or something similar.
+\end{important}
+
+The predefined styles have helper commands to make it easier to modify
+the format. These are described in \sectionref{sec:abbrvcmds}.
-\printglossaries
-\end{document}
-\end{verbatim}
-
-\section{Acronym Style Modifications}
-\label{sec:acronymmods}
-
-The \styfmt{glossaries-extra} package provides a new way of dealing
-with abbreviations and redefines \ics{newacronym} to
-use \cs{newabbreviation} (see \sectionref{sec:abbreviations}).
-The simplest way to update a document that uses
-\cs{newacronym} from \styfmt{glossaries} to
-\styfmt{glossaries-extra} is do just add
-\begin{verbatim}
-\setabbreviationstyle[acronym]{long-short}
-\end{verbatim}
-before you define any entries. If you have used commands like
-\ics{acrshort}, \ics{acrlong} and \ics{acrfull}, you need to
-substitute them with \ics{glsxtrshort}, \ics{glsxtrlong} and
-\ics{glsxtrfull}. (This includes plural and case-changing forms.)
-Your text editor's search and replace function should help with
-this. If you have used the \pkgopt{shortcuts} package option then
-use \pkgopt[ac]{shortcuts} in order to continue using the shortcut
-commands like \ics{ac}. With this setting, \ics{acs} will use
-\ics{glsxtrshort} instead of \ics{acrshort} etc.
-
-For example, the following document using just \styfmt{glossaries}
-\begin{verbatim}
-\documentclass{article}
-\usepackage[acronym,nopostdot,toc]{glossaries}
-\makeglossaries
-\setacronymstyle{long-short}
-\newacronym{html}{HTML}{hypertext markup language}
-\begin{document}
-\gls{html}
-\printglossaries
-\end{document}
-\end{verbatim}
-can be easily adapted to use \styfmt{glossaries-extra}:
-\begin{verbatim}
-\documentclass{article}
-\usepackage[acronym]{glossaries-extra}
-\makeglossaries
-\setabbreviationstyle[acronym]{long-short}
-\newacronym{html}{HTML}{hypertext markup language}
-\begin{document}
-\gls{html}
-\printglossaries
-\end{document}
-\end{verbatim}
Table~\ref{tab:acrabbrvstyles} lists the nearest equivalent
-\styfmt{glossaries-extra} abbreviation styles for
-the predefined acronym styles provided by \styfmt{glossaries}, but
-note that the new styles use different formatting commands. See
-\sectionref{sec:predefabbrvstyles} for further details.
+\sty{glossaries-extra} abbreviation styles for
+the predefined acronym styles provided by \sty{glossaries}, but
+note that the new styles use different formatting commands.
\begin{table}[htbp]
-\caption[Old Acronym Styles Verses New Abbreviation Styles]{Old Acronym Styles
-\cs{setacronymstyle}\marg{old-style-name} Verses New Abbreviation
-Styles \cs{setabbreviationstyle}\oarg{category}\marg{new-style-name}}
+\caption[Base Acronym Styles Verses New Abbreviation Styles]{Base Acronym Styles
+\glsfmttext{setacronymstyle}\margm{base-style-name} Verses New Abbreviation
+Styles \glsfmttext{setabbreviationstyle}\oargm{category}\margm{new-style-name}}
\label{tab:acrabbrvstyles}
\centering
-\begin{tabular}{@{}p{\dimexpr0.3\textwidth-2\tabcolsep}p{0.7\textwidth}@{}}
-\bfseries Old Style Name &
+\begin{tabular}{lp{0.7\textwidth}}
+\bfseries Base Style Name &
\bfseries New Style Name\\
\acrstyle{long-sc-short} & \abbrstyle{long-short-sc}\\
\acrstyle{long-sm-short} & \abbrstyle{long-short-sm}\\
\acrstyle{long-sp-short} & \abbrstyle{long-short} \newline with
-\ttfamily\cs{renewcommand}\{\cs{glsxtrfullsep}\}[1]\{\cs{glsacspace}\{\#1\}\}\\
+\code{\cmd{renewcommand}\marg{\gls{glsxtrfullsep}}\marg{\gls{glsabspace}}}\\
\acrstyle{short-long} & \abbrstyle{short-long}\\
\acrstyle{sc-short-long} & \abbrstyle{short-sc-long}\\
\acrstyle{sm-short-long} & \abbrstyle{short-sm-long}\\
@@ -3122,7 +23585,7 @@ Styles \cs{setabbreviationstyle}\oarg{category}\marg{new-style-name}}
\acrstyle{long-sc-short-desc} & \abbrstyle{long-short-sc-desc}\\
\acrstyle{long-sm-short-desc} & \abbrstyle{long-short-sm-desc}\\
\acrstyle{long-sp-short-desc} & \abbrstyle{long-short-desc} \newline with
-\ttfamily\cs{renewcommand}\{\cs{glsxtrfullsep}\}[1]\{\cs{glsacspace}\{\#1\}\}\\
+\code{\cmd{renewcommand}\marg{\gls{glsxtrfullsep}}\marg{\gls{glsabspace}}}\\
\acrstyle{short-long-desc} & \abbrstyle{short-long-desc}\\
\acrstyle{sc-short-long-desc} & \abbrstyle{short-sc-long-desc}\\
\acrstyle{sm-short-long-desc} & \abbrstyle{short-sm-long-desc}\\
@@ -3137,4513 +23600,9793 @@ Styles \cs{setabbreviationstyle}\oarg{category}\marg{new-style-name}}
\end{tabular}
\end{table}
-The reason for introducing the new style of abbreviation commands
-provided by \styfmt{glossaries-extra} is because the original
-acronym commands provided by \styfmt{glossaries} are too restrictive
-to work with the internal modifications made by
-\styfmt{glossaries-extra}. However, if you really want to restore
-the generic acronym function provided
-by \styfmt{glossaries} you can use
-\begin{definition}[\DescribeMacro\RestoreAcronyms]
-\cs{RestoreAcronyms}
-\end{definition}
-(before any use of \cs{newacronym}).
-
-\cs{RestoreAcronyms} should not be used in combination with the newer
-\styfmt{glossaries-extra} abbreviations. Don't combine old and
-new style entries with the same \gloskey{type}. The
-original \styfmt{glossaries} acronym mechanism doesn't work well
-with the newer \styfmt{glossaries-extra} commands.
+The example documents used to illustrate the predefined styles in
+the sub-sections below are all in the form (document class and
+options may vary):
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\cmd{usepackage}\oarg{T1}\marg{fontenc}
+\cmd{usepackage}\oarg{colorlinks}\marg{hyperref}
+\cmd{usepackage}\marg{glossaries-extra}
+\gls{setabbreviationstyle}\margm{style-name}
+\gls{newabbreviation}\oargm{options}\marg{ex}\margm{short}\marg{long form}
+\cbeg{document}
+First: \gls{gls}\marg{ex}[-insert]. Next: \gls{gls}\marg{ex}[-insert].
+Full: \gls{glsxtrfull}\marg{ex}[-insert].
+\gls{printunsrtglossaries}
+\cend{document}
+\end{codebox}
+where \meta{style-name} is the name of the abbreviation style,
+\meta{short} is either \qt{SHRT FM} or (for the \idx{smallcaps}
+examples) \qt{shrt fm}. The styles that require the
+\gloskey{description} or \gloskey{user1} key to be set will include that in
+\meta{options} otherwise the optional argument of
+\gls{newabbreviation} will be omitted.
+The examples with a style that requires
+\gls{textsmaller} will load \sty{relsize}.
+The \qt{hyphen} styles set the \catattr{markwords} and
+\catattr{markshortwords} attributes.
+Note that \sty{hyperref} is loaded with the \optfmt{colorlinks}
+option, so the hyperlink text will be red.
+
+The naming scheme for abbreviation styles is as follows:
+\begin{itemize}
+\item
+\meta{field1}[\code{-}\meta{modifier1}]\code{-}[post]\meta{field2}[\code{-}\meta{modifier2}][\code{-user}]
+
+This is for the parenthetical styles. The \code{-}\meta{modifier} parts may
+be omitted. These styles display \meta{field1} followed by
+\meta{field2} in parentheses. If \meta{field1} or \meta{field2} starts
+with \qt{no} then that element is omitted from the
+\idxc{displayfullform}{display style} (no
+parenthetical part) but is included in the \idxc{inlinefullform}{inline style}.
+
+If \code{post} is present then \meta{field2} is
+placed after the \gls{linktext} using the \idx{postlinkhook}.
+Note that this will use the singular form of \meta{field2} by
+default, even if \gls{glspl} is used. The corresponding non-post
+style will use the matching form for \meta{field2}.
+
+If the \code{-}\meta{modifier} part is present and is one of
+\code{sc}, \code{sm} or \code{em}, then the field has
+a font changing command applied to it.
+
+The modifier \code{-only} indicates that field is only present
+according to whether or not the entry has been used.
+
+The modifier \code{-hyphen} indicates the style will substitute
+inter-word spaces (that have been marked up with the
+\catattr{markwords} or \catattr{markshortwords} attributes) will be
+changed to spaces if the inserted material starts with a hyphen (but
+not for the set of \gls{glsxtrshort} and \gls{glsxtrlong} commands).
+
+If the \code{-user} part is present, then the value of the field
+given by \gls{glsxtruserfield} (\gloskey{user1}), if set, is inserted into the
+parenthetical material.
+
+Examples:
+ \begin{itemize}
+ \item\abbrstyle{long-noshort-sc}: \meta{field1} is the long
+form, the short form is set in \idx{smallcaps} but omitted in the display
+style.
+ \item\abbrstyle{long-em-short-em}: both the long form and the
+short form are emphasized. The short form is in parentheses.
+ \item\abbrstyle{long-short-em}: the
+short form is emphasized but not the long form. The short form is in parentheses.
+ \item\abbrstyle{long-short-user}: if the \gloskey{user1} key has
+been set, this produces the style \meta{long} (\meta{short},
+\meta{user1}) otherwise it just produces \meta{long} (\meta{short}).
+
+ \item\abbrstyle{long-hyphen-postshort-hyphen}: the short
+form and the inserted material (provided by the final optional
+argument of commands like \gls{gls}) is moved to the post-link hook.
+The long form is formatted according to \gls{glslonghyphenfont}
+(or \gls{glsfirstlonghyphenfont} on first use).
+The short form is formatted according to \gls{glsabbrvhyphenfont}
+(or \gls{glsfirstabbrvhyphenfont} on first use).
+ \end{itemize}
+
+\item \meta{style}\code{-noreg}
+
+Some styles set the \catattr{regular} attribute. In some cases,
+there's a version of the style that doesn't set this attribute.
+For example, \abbrstyle{long-em-noshort-em} sets the
+\catattr{regular} attribute. The
+\abbrstyle{long-em-noshort-em-noreg} style is a minor variation
+of that style that sets the attribute to \code{false}.
+
+There are a few \qt{noshort} styles, such as
+\abbrstyle{long-hyphen-noshort-noreg}, where there isn't a
+corresponding regular version. This is because the
+style won't work properly with the \catattr{regular} attribute set, but the
+naming scheme is maintained for consistency with the other
+\qt{noshort} styles.
+
+\item
+\meta{field1}[\code{-}\meta{modifier1}]\code{-}[\code{post}]\code{footnote}
+
+The display style uses \meta{field1} followed by a footnote with the
+other field in it. If \code{post} is present then the footnote is
+placed after the \gls{linktext} using the post-link hook.
+The inline style does \meta{field1} followed by the other field in
+parentheses.
+
+If \code{-}\meta{modifier1} is present, \meta{field1} has a
+font-changing command applied to it.
+
+Examples:
+\begin{itemize}
+\item \abbrstyle{short-footnote}: short form in the text with the
+long form in the footnote.
+\item \abbrstyle{short-sc-postfootnote}: short form in smallcaps
+with the long form in the footnote outside of the \gls{linktext}.
+\end{itemize}
\begin{important}
-If you use \cs{RestoreAcronyms}, don't use any of the commands
-provided by \styfmt{glossaries-extra} intended for abbreviations
-(such as \ics{glsxtrshort} or \ics{glsfmtshort}) with entries
-defined via \ics{newacronym} as it will cause unexpected
-results.
+Take care with the footnote styles. Remember that there are some
+situations where \gls{footnote} doesn't work.
\end{important}
-In general, there's rarely any need for \cs{RestoreAcronyms}. If you
-have a document that uses \ics{newacronymstyle}, then it's best to
-either stick with just \styfmt{glossaries} for that document or
-define an equivalent abbreviation style with
-\ics{newabbreviationstyle}. (See \sectionref{sec:newabbrvstyle} for
-further details.)
-
-\begin{definition}[\DescribeMacro\glsacspace]
-\cs{glsacspace}\marg{label}
-\end{definition}
-The space command \cs{glsacspace} used by the
-\acrstyle{long-sp-short} acronym style provided by \styfmt{glossaries}
-is modified so that it uses
-\begin{definition}[\DescribeMacro\glsacspacemax]
-\cs{glsacspacemax}
-\end{definition}
-instead of the hard-coded 3em. This is a command not a length
-and so can be changed using \cs{renewcommand}.
-
-Any of the new abbreviation styles that use \ics{glsxtrfullsep}
-(such as \abbrstyle{long-short}) can easily be changed to use
-\cs{glsacspace} with
-\begin{verbatim}
-\renewcommand*{\glsxtrfullsep}[1]{\glsacspace{#1}}
-\end{verbatim}
-
-The \gls{firstuse} acronym font command
-\begin{definition}[\firstacronymfont]
-\cs{firstacronymfont}\marg{text}
-\end{definition}
-is redefined to use the \gls{firstuse} abbreviation font command
-\ics{glsfirstabbrvfont}. This will be reset if you use
-\cs{RestoreAcronyms}.
-
-The subsequent use acronym font command
-\begin{definition}[\acronymfont]
-\cs{acronymfont}\marg{text}
-\end{definition}
-is redefined to use the subsequent use abbreviation font command
-\ics{glsabbrvfont}. This will be reset if you use
-\cs{RestoreAcronyms}.
-
-\section{Glossaries}
-\label{sec:glossaries}
+\item \meta{style}\code{-desc}
-The \ics{newignoredglossary}\marg{type} command now (as from v1.11) has a starred
-version that doesn't automatically switch off the hyperlinks.
-This starred version may be used with the \catattr{targeturl}
-attribute to create a link to an external URL. (See
-\sectionref{sec:categories} for further details.)
-As from v1.12 both the starred and unstarred version check
-that the glossary doesn't already exist. (The \styfmt{glossaries}
-package omits this check.)
-
-You can now provide an ignored glossary with:
-\begin{definition}[\DescribeMacro\provideignoredglossary]
-\cs{provideignoredglossary}\marg{type}
-\end{definition}
-which will only define the glossary if it doesn't already exist.
-This also has a starred version that doesn't automatically switch
-off hyperlinks.
-
-The individual glossary displaying commands \ics{printglossary},
-\ics{printnoidxglossary} and \cs{printunsrtglossary} have extra
-keys:
+Like \meta{style} but the \gloskey{description} key must be provided
+when defining abbreviations with this style.
+Examples:
\begin{itemize}
-\item \gloskey[printglossary]{target}. This is a boolean key which can
-be used to switch off the automatic hypertarget for each entry.
-Unlike \cs{glsdisablehyper} this doesn't switch off hyperlinks, so
-any cross-references within the glossary won't be affected. This is
-a way of avoiding duplicate target warnings if a glossary needs to
-be displayed multiple times.
-\item
-\gloskey[printglossary]{targetnameprefix}\texttt{=}\marg{prefix}. Another way
-of avoiding duplicate target names is to set a prefix
-used for the names. Unlike changing \cs{glolinkprefix} this doesn't affect
-any hyperlinks (such as those created with \cs{gls}).
+
+\item \abbrstyle{short-long-desc}: like \abbrstyle{short-long} but
+requires a description.
+\item \abbrstyle{short-em-footnote-desc}: like
+\abbrstyle{short-em-footnote} but requires a description.
+\end{itemize}
+\end{itemize}
+
+Not all combinations that fit the above syntax are provided.
+Pre-version 1.04 styles that didn't fit this naming scheme are either
+provided with a synonym (where the former name wasn't ambiguous) or
+provided with a deprecated synonym (where the former name was
+confusing).
+
+\subsubsection{Regular Styles}
+\label{sec:predefregabbrvstyles}
+
+The following abbreviation styles set the \catattr{regular}
+attribute to \code{true} for all categories that have abbreviations
+defined with any of these styles. This means that they are treated
+like ordinary entries and are encapsulated with
+\gls{glsxtrregularfont} not \gls{glsxtrabbreviationfont}. The
+\idx{glslike} commands are formatted according to
+\gls{glsgenentryfmt}.
+
+\paragraph{Short Styles}
+\label{sec:predefregabbrvstylesshort}These styles only show the
+short form on both \idx{firstuse} and \idx{subsequentuse}.
+See \sectionref{sec:abbrvcmdsgeneral} and
+\sectionref{sec:abbrvcmdsnolong} for style commands.
+
+\abbrstyledef{short-nolong}
+Only the short form is shown on \idx{firstuse} of the \idx{glslike}
+commands. The \idx{inlinefullform} uses the same
+parenthetical style as \abbrstyle{short-long} (\gls{glsxtrshortlongformat}).
+Font variations are available with \abbrstyle{short-sc-nolong},
+\abbrstyle{short-sm-nolong} and \abbrstyle{short-em-nolong}.
+
+\abbrvstyleexampleuc{short-nolong}
+
+The long form is formatted with \gls{glslongdefaultfont} for the
+\gls{glsxtrlong} set of commands.
+
+The short form is formatted with \gls{glsfirstabbrvdefaultfont}
+within the full form and with \gls{glsabbrvdefaultfont} for
+\idx{subsequentuse} and for the \gls{glsxtrshort} set of commands.
+
+The name is set to the short form (\gls{glsxtrshortnolongname}) and
+the description is set to the unencapsulated long form.
+
+\abbrstyledef{short}
+A synonym for \abbrstyle{short-nolong}.
+
+\abbrstyledef{short-nolong-desc}
+As \abbrstyle{short-nolong} but the description must be supplied in
+the optional argument of \gls{newabbreviation}.
+Font variations are available with \abbrstyle{short-sc-nolong-desc},
+\abbrstyle{short-sm-nolong-desc} and \abbrstyle{short-em-nolong-desc}.
+
+\abbrvstyleexampleucdesc{short-nolong-desc}
+
+The name is set to the short form followed by the long form in
+parentheses (\gls{glsxtrshortdescname}), and the sort is set to
+just the short form.
+
+\abbrstyledef{short-desc}
+A synonym for \abbrstyle{short-nolong-desc}.
+
+\abbrstyledef{nolong-short}
+The same as \abbrstyle{short-nolong} except for the
+\idx{inlinefullform}, which shows the same parenthetical style as
+\abbrstyle{long-short} (\gls{glsxtrlongshortformat}).
+Font variations are available with \abbrstyle{nolong-short-sc},
+\abbrstyle{nolong-short-sm} and \abbrstyle{nolong-short-em}.
+
+\abbrvstyleexampleuc{nolong-short}
+
+\abbrstyledef{short-sc-nolong}
+This style is like \abbrstyle{short-nolong} but it uses
+\gls{glsxtrscsuffix}, \gls{glsabbrvscfont} and
+\gls{glsfirstabbrvscfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexamplelc{short-sc-nolong}
+
+\abbrstyledef{short-sc}
+A synonym for \abbrstyle{short-sc-nolong}.
+
+\abbrstyledef{short-sc-nolong-desc}
+This style is like \abbrstyle{short-nolong-desc} but it uses
+\gls{glsxtrscsuffix}, \gls{glsabbrvscfont} and
+\gls{glsfirstabbrvscfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexamplelcdesc{short-sc-nolong-desc}
+
+\abbrstyledef{short-sc-desc}
+A synonym for \abbrstyle{short-sc-nolong-desc}.
+
+\abbrstyledef{nolong-short-sc}
+This style is like \abbrstyle{nolong-short} but it uses
+\gls{glsxtrscsuffix}, \gls{glsabbrvscfont} and
+\gls{glsfirstabbrvscfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexamplelc{nolong-short-sc}
+
+\abbrstyledef{short-sm-nolong}
+This style is like \abbrstyle{short-nolong} but it uses
+\gls{glsxtrsmsuffix}, \gls{glsabbrvsmfont} and
+\gls{glsfirstabbrvsmfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexamplesm{short-sm-nolong}
+
+\abbrstyledef{short-sm}
+A synonym for \abbrstyle{short-sm-nolong}.
+
+\abbrstyledef{short-sm-nolong-desc}
+This style is like \abbrstyle{short-nolong-desc} but it uses
+\gls{glsxtrsmsuffix}, \gls{glsabbrvsmfont} and
+\gls{glsfirstabbrvsmfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexamplesmdesc{short-sm-nolong-desc}
+
+\abbrstyledef{short-sm-desc}
+A synonym for \abbrstyle{short-sm-nolong-desc}.
+
+\abbrstyledef{nolong-short-sm}
+This style is like \abbrstyle{nolong-short} but it uses
+\gls{glsxtrsmsuffix}, \gls{glsabbrvsmfont} and
+\gls{glsfirstabbrvsmfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexamplesm{nolong-short-sm}
+
+\abbrstyledef{short-em-nolong}
+This style is like \abbrstyle{short-nolong} but it uses
+\gls{glsxtremsuffix}, \gls{glsabbrvemfont} and
+\gls{glsfirstabbrvemfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexampleuc{short-em-nolong}
+
+\abbrstyledef{short-em}
+A synonym for \abbrstyle{short-em-nolong}.
+
+\abbrstyledef{short-em-nolong-desc}
+This style is like \abbrstyle{short-nolong-desc} but it uses
+\gls{glsxtremsuffix}, \gls{glsabbrvemfont} and
+\gls{glsfirstabbrvemfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexampleucdesc{short-em-nolong-desc}
+
+\abbrstyledef{short-em-desc}
+A synonym for \abbrstyle{short-em-nolong-desc}.
+
+\abbrstyledef{nolong-short-em}
+This style is like \abbrstyle{nolong-short} but it uses
+\gls{glsxtremsuffix}, \gls{glsabbrvemfont} and
+\gls{glsfirstabbrvemfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexampleuc{nolong-short-em}
+
+\paragraph{Long Styles}
+\label{sec:predefregabbrvstyleslong}These styles only show the long
+form on both \idx{firstuse} and \idx{subsequentuse}. See
+\sectionref{sec:abbrvcmdsgeneral} and
+\sectionref{sec:abbrvcmdsnoshort} for style commands.
+
+\abbrstyledef{long-noshort-desc}
+Only the long form is shown on \idx{firstuse} and
+\idx{subsequentuse} of the \idx{glslike} commands
+(\gls{glsxtrlongformat}). The \idx{inlinefullform} uses the same
+parenthetical style as \abbrstyle{long-short}
+(\gls{glsxtrlongshortformat}).
+Font variations are available with \abbrstyle{long-noshort-sc-desc},
+\abbrstyle{long-noshort-sm-desc} and \abbrstyle{long-noshort-em-desc}.
+
+\abbrvstyleexampleucdesc{long-noshort-desc}
+
+The long form is formatted with \gls{glsfirstlongdefaultfont} on
+\idx{firstuse} and \gls{glslongdefaultfont} for \idx{subsequentuse}
+and for the \gls{glsxtrlong} set of commands.
+
+The short form is formatted with \gls{glsfirstabbrvdefaultfont}
+within the \idx{inlinefullform} and with \gls{glsabbrvdefaultfont}
+for the \gls{glsxtrshort} set of commands.
+
+The name is set to the long form (\gls{glsxtrlongnoshortdescname}) and
+the description must be supplied.
+
+\abbrstyledef{long-desc}
+A synonym for \abbrstyle{long-noshort-desc}.
+
+\abbrstyledef{long-noshort}
+This is like \abbrstyle{long-noshort-desc} but the name is set to
+the short form (\gls{glsxtrlongnoshortname}) and the description is
+set to the unencapsulated long form.
+
+\abbrvstyleexampleuc{long-noshort}
+
+\abbrstyledef{long}
+A synonym for \abbrstyle{long-noshort}.
+
+\abbrstyledef{long-noshort-sc}
+This style is like \abbrstyle{long-noshort} but it uses
+\gls{glsxtrscsuffix}, \gls{glsabbrvscfont} and
+\gls{glsfirstabbrvscfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexamplelc{long-noshort-sc}
+
+\abbrstyledef{long-noshort-sc-desc}
+This style is like \abbrstyle{long-noshort-desc} but it uses
+\gls{glsxtrscsuffix}, \gls{glsabbrvscfont} and
+\gls{glsfirstabbrvscfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexamplelcdesc{long-noshort-sc-desc}
+
+\abbrstyledef{long-noshort-sm}
+This style is like \abbrstyle{long-noshort} but it uses
+\gls{glsxtrsmsuffix}, \gls{glsabbrvsmfont} and
+\gls{glsfirstabbrvsmfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexamplesm{long-noshort-sm}
+
+\abbrstyledef{long-noshort-sm-desc}
+This style is like \abbrstyle{long-noshort-desc} but it uses
+\gls{glsxtrsmsuffix}, \gls{glsabbrvsmfont} and
+\gls{glsfirstabbrvsmfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexamplesmdesc{long-noshort-sm-desc}
+
+\abbrstyledef{long-noshort-em}
+This style is like \abbrstyle{long-noshort} but it uses
+\gls{glsxtremsuffix}, \gls{glsabbrvemfont} and
+\gls{glsfirstabbrvemfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexampleuc{long-noshort-em}
+
+\abbrstyledef{long-noshort-em-desc}
+This style is like \abbrstyle{long-noshort-desc} but it uses
+\gls{glsxtremsuffix}, \gls{glsabbrvemfont} and
+\gls{glsfirstabbrvemfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexampleucdesc{long-noshort-em-desc}
+
+\abbrstyledef{long-em-noshort-em}
+This style is like \abbrstyle{long-noshort} but it uses
+\gls{glsxtremsuffix}, \gls{glsabbrvemfont},
+\gls{glsfirstabbrvemfont}, \gls{glslongemfont} and
+\gls{glsfirstlongemfont} (see \sectionref{sec:abbrvcmdsfonts}).
+This emphasizes both the long and short forms.
+
+\abbrvstyleexampleuc{long-em-noshort-em}
+
+\abbrstyledef{long-em-noshort-em-desc}
+This style is like \abbrstyle{long-noshort-desc} but it uses
+\gls{glsxtremsuffix}, \gls{glsabbrvemfont},
+\gls{glsfirstabbrvemfont}, \gls{glslongemfont} and
+\gls{glsfirstlongemfont} (see \sectionref{sec:abbrvcmdsfonts}).
+This emphasizes both the long and short forms.
+
+\abbrvstyleexampleucdesc{long-em-noshort-em-desc}
+
+\subsubsection{Non-Regular Styles}
+\label{sec:predefnonregabbrvstyles}
+
+The following abbreviation styles will set the
+\catattr{regular} attribute to \code{false} if it has previously
+been set. If it hasn't already been set, it's left unset.
+Other attributes may also be set, depending on the style.
+
+The non-regular styles are too complicated to use
+\gls{glsgenentryfmt} as the display style (with the
+\idx{glslike} commands). Instead they use \gls{glsxtrgenabbrvfmt}. This
+means that these styles won't work if you provide your own custom
+display style (using \gls{defglsentryfmt}) that doesn't check for
+the \catattr{regular} attribute.
+
\begin{important}
-This doesn't include the navigation hyper group targets in styles such as
-\glostyle{listhypergroup}. The link name for these is given by
-\ics{glsnavhyperlinkname}.
+Avoid using \gls{glsfirst}, \gls{glsfirstplural},
+\gls{glstext} and \gls{glsplural} (or their case-changing variants)
+with these styles. There are also some styles that can be
+problematic with \gls{GLSname}.
\end{important}
-\item
-\gloskey[printglossary]{prefix}\texttt{=}\marg{prefix}. If you do
-actually want to locally change \cs{glolinkprefix}, you can use
-the \gloskey{prefix} key instead. You need to use the matching
-\gloskey[glslink]{prefix} key in commands like \cs{gls}.
+\paragraph{Long (Short) Styles}
+\label{sec:predefnonregabbrvstyleslongshort}These styles show the
+long form followed by the short form in parentheses on
+\idx{firstuse}. On \idx{subsequentuse} only the short form is shown.
+See \sectionref{sec:abbrvcmdsgeneral} and \sectionref{sec:abbrvcmdsparen}
+for style commands.
+
+\abbrstyledef{long-short}
+The \meta{insert} is placed after the long form on \idx{firstuse}
+of the \idx{glslike} commands and after the short form on \idx{subsequentuse}.
+The \idx{inlinefullform} is the same as the \idx{displayfullform}
+(\gls{glsxtrlongshortformat}).
+Font variations are available with \abbrstyle{long-short-sc},
+\abbrstyle{long-short-sm}, \abbrstyle{long-short-em} and
+\abbrstyle{long-em-short-em}.
+
+\abbrvstyleexampleuc{long-short}
+
+The long form is formatted with \gls{glsfirstlongdefaultfont}
+within the full form and with \gls{glslongdefaultfont} for the
+\gls{glsxtrlong} set of commands.
+
+The short form is formatted with \gls{glsfirstabbrvdefaultfont}
+within the full form and with \gls{glsabbrvdefaultfont} for
+\idx{subsequentuse} and for the \gls{glsxtrshort} set of commands.
+
+The name is set to the short form (\gls{glsxtrlongshortname}) and
+the description is set to the unencapsulated long form.
+
+\abbrstyledef{long-short-desc}
+As \abbrstyle{long-short} but the description must be supplied in
+the optional argument of \gls{newabbreviation}.
+Font variations are available with \abbrstyle{long-short-sc-desc},
+\abbrstyle{long-short-sm-desc}, \abbrstyle{long-short-em-desc} and
+\abbrstyle{long-em-short-em-desc}.
+
+\abbrvstyleexampleucdesc{long-short-desc}
+
+The name and sort are set to the long form followed by the short form in
+parentheses (\gls{glsxtrlongshortdescname} and
+\gls{glsxtrlongshortdescsort}).
+
+\abbrstyledef{long-short-sc}
+This style is like \abbrstyle{long-short} but it uses
+\gls{glsxtrscsuffix}, \gls{glsabbrvscfont} and
+\gls{glsfirstabbrvscfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexamplelc{long-short-sc}
+
+\abbrstyledef{long-short-sc-desc}
+This style is like \abbrstyle{long-short-desc} but it uses
+\gls{glsxtrscsuffix}, \gls{glsabbrvscfont} and
+\gls{glsfirstabbrvscfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexamplelcdesc{long-short-sc-desc}
+
+\abbrstyledef{long-short-sm}
+This style is like \abbrstyle{long-short} but it uses
+\gls{glsxtrsmsuffix}, \gls{glsabbrvsmfont} and
+\gls{glsfirstabbrvsmfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexamplesm{long-short-sm}
+
+\abbrstyledef{long-short-sm-desc}
+This style is like \abbrstyle{long-short-desc} but it uses
+\gls{glsxtrsmsuffix}, \gls{glsabbrvsmfont} and
+\gls{glsfirstabbrvsmfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexamplesmdesc{long-short-sm-desc}
+
+\abbrstyledef{long-short-em}
+This style is like \abbrstyle{long-short} but it uses
+\gls{glsxtremsuffix}, \gls{glsabbrvemfont} and
+\gls{glsfirstabbrvemfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexampleuc{long-short-em}
+
+\abbrstyledef{long-short-em-desc}
+This style is like \abbrstyle{long-short-desc} but it uses
+\gls{glsxtremsuffix}, \gls{glsabbrvemfont} and
+\gls{glsfirstabbrvemfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexampleucdesc{long-short-em-desc}
+
+\abbrstyledef{long-em-short-em}
+This style is like \abbrstyle{long-short} but it uses
+\gls{glsxtremsuffix}, \gls{glsabbrvemfont} and
+\gls{glsfirstabbrvemfont}, \gls{glsfirstlongemfont}
+and \gls{glslongemfont} (see \sectionref{sec:abbrvcmdsfonts}).
+That is, both the long and short forms are emphasized.
+
+\abbrvstyleexampleuc{long-em-short-em}
+
+\abbrstyledef{long-em-short-em-desc}
+This style is like \abbrstyle{long-short-desc} but it uses
+\gls{glsxtremsuffix}, \gls{glsabbrvemfont} and
+\gls{glsfirstabbrvemfont}, \gls{glsfirstlongemfont}
+and \gls{glslongemfont} (see \sectionref{sec:abbrvcmdsfonts}).
+That is, both the long and short forms are emphasized.
+
+\abbrvstyleexampleucdesc{long-em-short-em-desc}
+
+\paragraph{Long (Short, User) Styles}
+\label{sec:predefnonregabbrvstyleslongshortuser}These styles are like the
+long (short) styles in \sectionref{sec:predefnonregabbrvstyleslongshort}
+but additional content can be supplied in the field identified by
+\gls{glsxtruserfield}, which will be placed in the parenthetical
+content on \idx{firstuse} (if set).
+The \idx{inlinefullform} is the same as the \idx{displayfullform}.
+
+These styles use the commands \gls{glsxtrusersuffix},
+\gls{glsabbrvuserfont}, \gls{glsfirstabbrvuserfont},
+\gls{glslonguserfont} and \gls{glsfirstlonguserfont} (except where
+noted). See \sectionref{sec:abbrvcmdsgeneral} and
+\sectionref{sec:abbrvcmdsuser} for style commands.
-\item
-\gloskey[printglossary]{label}\texttt{=}\marg{label}. Labels
-the glossary with \texttt{\cs{label}\marg{label}} and also
-defines \cs{@currentlabelname} to the glossary's TOC title
-(to provide text for \cs{nameref}). You can also set the
-label before the glossary using:
-\begin{definition}[\DescribeMacro\glsxtrsetglossarylabel]
-\cs{glsxtrsetglossarylabel}\marg{label}
-\end{definition}
-but take care of duplicate labels if it's not scoped.
+If you need to change the font, you can redefine the associated
+commands (listed above). However, since \idx{smallcaps} are awkward
+because the short plural suffix needs to counteract the
+\idx{smallcaps}, \idx{smallcaps} versions are provided.
-\item
-\gloskey[printunsrtglossary]{groups}. This is a boolean key (new to
-v1.44) designed for use with \cs{printunsrtglossary} (and other
-\cs{printunsrt\ldots} variations). It has no
-effect with \cs{printglossary} and \cs{printnoidxglossary}.
-
-If true (default), group formation (group header and group skip)
-will be attempted if the \gloskey{group} key has been defined and set. Note
-that some styles ignore the header and group skip commands so there
-may not be a noticeable difference in those cases. If this key is
-set to false, no group formation will occur so there won't be any
-group markup to separate letter groups so there will be no visual
-separation regardless of style or the group skip setting.
+\abbrstyledef{long-short-user}
+This style is like \abbrstyle{long-short} but it includes the
+additional content in the parentheses on \idx{firstuse} or the
+\idx{inlinefullform}. The description is obtained from
+\gls{glsuserdescription}, which can be redefined to include the
+additional information, if required.
-\item
-\gloskey[printunsrtglossary]{leveloffset}. This key (new to
-v1.44) is designed for use with \cs{printunsrtglossary} (and other
-\cs{printunsrt\ldots} variations). It has no
-effect with \cs{printglossary} and \cs{printnoidxglossary}.
-
-The value may either be a simple integer \meta{n} to indicate assignment or in the form
-\texttt{++\meta{n}} to indicate an increment. This will locally
-assign or increment the level offset. The default value is~0. This
-will cause entries to be displayed as though their hierarchical
-level is $N$ more than it would normally be (where $N$ is the level
-offset). For example, a top-level entry (that is, an entry without a
-parent) would normally have a hierarchical level of~0. With a level
-offset of~1, it would be treated by the glossary style as though it
-was actually a level~1 entry. (Remember that some styles don't
-support hierarchical glossaries.)
-
-Note that the group formation (if supported) will still occur
-between entries that don't have a parent, regardless of the level
-offset. This can cause odd results but can be switched off with
-\gloskey[false]{groups}. See \href{https://dickimaw-books.com/gallery/index.php?label=bib2gls-inner}{Gallery: Inner or Nested
-Glossaries} for an example.
-\end{itemize}
+\abbrvstyleexampleucuser{long-short-user}
+
+\abbrstyledef{long-short-user-desc}
+This style is like \abbrstyle{long-short-user} but the description
+must be supplied. The name is obtained from
+\gls{glsxtrlongshortuserdescname}.
-\section{Glossary Style Modifications}
-\label{sec:glosstylemods}
+\abbrvstyleexampleucuserdesc{long-short-user-desc}
-The \sty{glossaries-extra-stylemods} package (more conveniently
-loaded through the \styfmt{glossaries-extra}
-\pkgopt{stylemods} option) modifies some of the predefined
-styles that are provided with the \styfmt{glossaries} package.
-These modifications are described in more detail in
-\sectionref{sec:stylemods}.
-
-The \sty{glossaries} package tries to determine the group
-title from its label by first checking if
-\cs{}\meta{label}\texttt{groupname} exists. If it doesn't exist,
-then the title is assumed to be the same as the label.
-For example, when typesetting the \qt{A} letter group,
-\sty{glossaries} first checks if \cs{Agroupname} exists.
-This could potentially cause conflict with another package
-that may have some other meaning for \cs{Agroupname}, so
-\sty{glossaries-extra} first checks for the existence
-of the internal command \cs{glsxtr@grouptitle@}\meta{label}
-which shouldn't clash with another package. You can set the
-group title using
-\begin{definition}[\DescribeMacro\glsxtrsetgrouptitle]
-\cs{glsxtrsetgrouptitle}\marg{label}\marg{title}
-\end{definition}
-For example:
-\begin{verbatim}
-\glsxtrsetgrouptitle{A}{A (a)}
-\end{verbatim}
-This uses a global assignment. If you need to scope the change
-you can use
-\begin{definition}[\DescribeMacro\glsxtrlocalsetgrouptitle]
-\cs{glsxtrlocalsetgrouptitle}\marg{label}\marg{title}
-\end{definition}
-
-\subsection{Style Hooks}
-\label{sec:stylehooks}
-
-The commands \ics{glossentryname} and \ics{glossentrydesc} are
-modified to take into account the \catattr{glossname},
-\catattr{glossnamefont}, \catattr{glossdesc} and \catattr{glossdescfont}
-attributes (see \sectionref{sec:categories}). This means you can
-make simple font or case-changing modifications to the name and description
-without defining a new glossary style.
+\begin{important}
+This style is incompatible with \gls{GLSname}.
+\end{important}
-(New to version 1.42.)
-The command \ics{glossentrysymbol} is modified to take into account
-the \catattr{glosssymbolfont} attribute. Note that, unlike the above, there's
-no corresponding attribute to change the case as it's usually not
-appropriate to change the case of a symbol (and for some symbols,
-such as pictographs, there's no concept of case). If
-\ics{texorpdfstring} has been defined \ics{glossentrysymbol} will
-be defined to do:
-\begin{alltt}
-\ics{texorpdfstring}\marg{\TeX\ code}\marg{PDF}
-\end{alltt}
-The \meta{\TeX\ code} part is robust and deals with the actual
-typesetting of the symbol. The \meta{PDF} part is simply:
-\begin{definition}[\DescribeMacro\glsentrypdfsymbol]
-\cs{glsentrypdfsymbol}\marg{label}
-\end{definition}
-which is defined to just do \cs{glsentrysymbol}\marg{label}. The
-chances are that the code in the \gloskey{symbol} key won't be valid
-in the PDF bookmarks, so you can redefine \cs{glsentrypdfsymbol} to
-use a more appropriate field. (If you do redefine this command,
-remember that it needs to fully expand.)
+If you need to use \gls{GLSname} with this style, you'll have to
+redefine \gls{glsxtrlongshortuserdescname} so that the field name
+doesn't include the entry label. For example:
+\begin{codebox}
+\cmd{newcommand}\marg{\gls{glsxtrlongshortuserdescname}}\marg{\%
+ \cmd{protect}\gls{glslonguserfont}\marg{\cmd{the}\gls{glslongtok}}\%
+ \cmd{space}(\cmd{protect}\gls{glsabbrvuserfont}\marg{\cmd{the}\gls{glsshorttok}})\%
+}
+\end{codebox}
-For example, if you are using \sty{glossaries-accsupp}, you could
-use the \gloskey{symbolaccess} field:
-\begin{verbatim}
-\renewcommand{\glsentrypdfsymbol}[1]{\glsentrysymbolaccess{#1}}
-\end{verbatim}
-Alternatively, if you are using \gls{bib2gls} you can use the \TeX\
-parser library to interpret a copy of the \gloskey{symbol} field and
-use that. For example, with the resource options:
-\begin{verbatim}
- replicate-fields={symbol=user1},
- interpret-fields={user1}
-\end{verbatim}
-This stores the interpreted value of the symbol in the
-\gloskey{user1} field, so you can then do:
-\begin{verbatim}
-\renewcommand{\glsentrypdfsymbol}[1]{\glsentryuseri{#1}}
-\end{verbatim}
-(You may need \XeLaTeX\ or \LuaLaTeX\ with this method.) This allows
-\cs{glossentrysymbol} to be used in a section heading with
-standalone definitions.
+\abbrstyledef{long-postshort-user}
+This style is like \abbrstyle{long-short-user} but the parenthetical
+material is placed in the \idx{postlinkhook}. Note that, unlike
+\abbrstyle{long-short-user}, the plural form isn't used in the
+parenthetical material. If you require this, you will need to
+redefine \gls{glsxtrpostusershortformat}.
-If you want to adapt a style to use another field instead
-of \gloskey{name}, you can use
-\begin{definition}[\DescribeMacro\glossentrynameother]
-\cs{glossentrynameother}\marg{label}\marg{field}
-\end{definition}
-This behaves just like \cs{glossentryname} (that is, it obeys the
-\catattr{glossname} attribute, uses either the \catattr{glossnamefont}
-attribute or \cs{glsnamefont} to format the text, and uses the post-name hook)
-but it uses the given \meta{field} instead of \gloskey{name}. The
-\meta{field} argument must be the internal field name (for example
-\texttt{desc} rather than \texttt{description}). See the key to
-field mappings table in the \styfmt{glossaries} user manual.
-
-There is a hook after \ics{glossentryname} and
-\ics{Glossentryname}:
-\begin{definition}[\DescribeMacro\glsxtrpostnamehook]
-\cs{glsxtrpostnamehook}\marg{label}
-\end{definition}
-By default this checks the \catattr{indexname} attribute.
-If the attribute exists for the category to which the label belongs,
-then the name is automatically indexed using
-\begin{definition}
-\ics{glsxtrdoautoindexname}\marg{label}\texttt{\{indexname\}}
-\end{definition}
-See \sectionref{sec:autoindex} for further details.
+\abbrvstyleexampleucuser{long-postshort-user}
-\begin{sloppypar}
-As from version 1.04, the post-name hook \cs{glsxtrpostnamehook}
-will also use \cs{glsxtrpostname}\meta{category} if it exists.
-You can use \ics{glscurrententrylabel} to obtain the entry label
-with the definition of this command. For example, suppose you are
-using a glossary style the doesn't display the symbol, you can
-insert the symbol after the name for a particular category, say,
-the \qt{symbol} category:
-\end{sloppypar}
-\begin{verbatim}
-\newcommand*{\glsxtrpostnamesymbol}{\space
- (\glsentrysymbol{\glscurrententrylabel})}
-\end{verbatim}
-For convenience, as from v1.31, you can use
-\begin{definition}[\DescribeMacro\glsdefpostname]
-\cs{glsdefpostname}\marg{category}\marg{definition}
-\end{definition}
-This is simply a shortcut for:
-\begin{alltt}
-\cs{csdef}\{glsxtrpostname\meta{category}\}\marg{definition}
-\end{alltt}
-Note that it doesn't check if the command has already been defined.
+\abbrstyledef{long-postshort-user-desc}
+This style is like \abbrstyle{long-postshort-user} but the description
+must be supplied. The name is obtained from
+\gls{glsxtrlongshortuserdescname}.
-As from version 1.25, the post-name hook also does
-\begin{definition}[\DescribeMacro\glsextrapostnamehook]
-\cs{glsextrapostnamehook}\marg{label}
-\end{definition}
-(before \cs{glsxtrpostname}\meta{category})
-to allow for additional non-category related code. This does nothing
-by default.
+\abbrvstyleexampleucuserdesc{long-postshort-user-desc}
-The post-description code used within the glossary is modified so
-that it also does
-\begin{definition}[\DescribeMacro\glsxtrpostdescription]
-\cs{glsxtrpostdescription}
-\end{definition}
-This occurs before the original \cs{glspostdescription}, so if the
-\pkgopt[false]{nopostdot} option is used, it will be inserted before
-the terminating full stop.
-
-This new command will do \cs{glsxtrpostdesc\meta{category}}
-if it exists, where \meta{category} is the category label associated
-with the current entry. For example \cs{glsxtrpostdescgeneral}
-for entries with the category set to \category{general}
-or \cs{glsxtrpostdescacronym} for entries with the category set to
-\category{acronym}.
-For convenience, as from v1.31, you can use
-\begin{definition}[\DescribeMacro\glsdefpostdesc]
-\cs{glsdefpostdesc}\marg{category}\marg{definition}
-\end{definition}
-This is simply a shortcut for:
-\begin{alltt}
-\cs{csdef}\{glsxtrpostdesc\meta{category}\}\marg{definition}
-\end{alltt}
-Note that it doesn't check if the command has already been defined.
+\begin{important}
+This style is incompatible with \gls{GLSname}.
+\end{important}
-Since both \cs{glossentry} and \cs{subglossentry} set
-\begin{definition}[\DescribeMacro\glscurrententrylabel]
-\cs{glscurrententrylabel}
-\end{definition}
-to the label for the current entry, you can use this within the
-definition of these post-description hooks if you need to reference
-the label.
+If you need to use \gls{GLSname} with this style, you'll have to
+redefine \gls{glsxtrshortlonguserdescname} so that the field name
+doesn't include the entry label, as for
+\abbrstyle{long-short-user-desc}.
+
+\abbrstyledef{long-postshort-sc-user}
+This style is like \abbrstyle{long-postshort-user} but it uses
+\gls{glsxtrscusersuffix}, \gls{glsabbrvscuserfont} and
+\gls{glsfirstabbrvscuserfont}.
+The name value is obtained from \gls{glsxtrlongshortscusername}.
+
+\abbrvstyleexamplelcuser{long-postshort-sc-user}
-For example, suppose you want to insert the plural form in brackets
-after the description in the glossary, but only for entries in the
-\category{general} category, then you could do:
-\begin{verbatim}
-\renewcommand{\glsxtrpostdescgeneral}{\space
- (plural: \glsentryplural{\glscurrententrylabel})}
-\end{verbatim}
-This means you don't have to define a custom glossary style, which
-you may find more complicated. (It also allows more flexibility if
-you decide to change the underlying glossary style.)
+\abbrstyledef{long-postshort-sc-user-desc}
+This style is like \abbrstyle{long-postshort-sc-user} but the description
+must be supplied. The name is obtained from
+\gls{glsxtrlongshortuserdescname}.
+
+\abbrvstyleexamplelcuserdesc{long-postshort-sc-user-desc}
\begin{important}
-This feature can't be used for glossary styles that ignore
-\cs{glspostdescription} or if you redefine
-\cs{glspostdescription} without including \cs{glsxtrpostdescription}.
-(For example, if you redefine \cs{glspostdescription} to do
-nothing instead of using the \pkgopt{nopostdot} option to suppress
-the terminating full stop.) See \sectionref{sec:stylemods} to patch
-the predefined styles provided by \styfmt{glossaries} that are missing
-\cs{glspostdescription}.
+This style is incompatible with \gls{GLSname}.
\end{important}
-\subsection{Number List}
-\label{sec:glosstylenumlist}
+If you need to use \gls{GLSname} with this style, you'll have to
+redefine \gls{glsxtrlongshortscuserdescname} so that the field name
+doesn't include the entry label.
+
+\paragraph{Short (Long) Styles}
+\label{sec:predefnonregabbrvstylesshortlong}These styles show the
+short form followed by the long form in parentheses on
+\idx{firstuse}. On \idx{subsequentuse} only the short form is shown.
+See \sectionref{sec:abbrvcmdsgeneral} and \sectionref{sec:abbrvcmdsparen}
+for style commands.
+
+\abbrstyledef{short-long}
+
+The \meta{insert} is placed after the short form on \idx{firstuse}
+and \idx{subsequentuse} of the \idx{glslike} commands.
+The \idx{inlinefullform} is the same as the \idx{displayfullform}
+(\gls{glsxtrshortlongformat}).
+Font variations are available with \abbrstyle{short-sc-long},
+\abbrstyle{short-sm-long}, \abbrstyle{short-em-long} and
+\abbrstyle{short-em-long-em}.
+
+\abbrvstyleexampleuc{short-long}
+
+The long form is formatted with \gls{glsfirstlongdefaultfont}
+within the full form and with \gls{glslongdefaultfont} for the
+\gls{glsxtrlong} set of commands.
+
+The short form is formatted with \gls{glsfirstabbrvdefaultfont}
+within the full form and with \gls{glsabbrvdefaultfont} for
+\idx{subsequentuse} and for the \gls{glsxtrshort} set of commands.
+
+The name is set to the short form (\gls{glsxtrlongshortname}) and
+the description is set to the unencapsulated long form.
+
+\abbrstyledef{short-long-desc}
+As \abbrstyle{short-long} but the description must be supplied in
+the optional argument of \gls{newabbreviation}.
+Font variations are available with \abbrstyle{short-sc-long-desc},
+\abbrstyle{short-sm-long-desc}, \abbrstyle{short-em-long-desc} and
+\abbrstyle{short-em-long-em-desc}.
+
+\abbrvstyleexampleucdesc{short-long-desc}
+
+The name is set to the short form followed by the long form in
+parentheses (\gls{glsxtrshortlongdescname}), and the sort is set to
+just the short form (\gls{glsxtrshortlongdescsort}).
+
+\abbrstyledef{short-sc-long}
+This style is like \abbrstyle{short-long} but it uses
+\gls{glsxtrscsuffix}, \gls{glsabbrvscfont} and
+\gls{glsfirstabbrvscfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexamplelc{short-sc-long}
+
+\abbrstyledef{short-sc-long-desc}
+This style is like \abbrstyle{short-long-desc} but it uses
+\gls{glsxtrscsuffix}, \gls{glsabbrvscfont} and
+\gls{glsfirstabbrvscfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexamplelcdesc{short-sc-long-desc}
+
+\abbrstyledef{short-sm-long}
+This style is like \abbrstyle{short-long} but it uses
+\gls{glsxtrsmsuffix}, \gls{glsabbrvsmfont} and
+\gls{glsfirstabbrvsmfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexamplesm{short-sm-long}
+
+\abbrstyledef{short-sm-long-desc}
+This style is like \abbrstyle{short-long-desc} but it uses
+\gls{glsxtrsmsuffix}, \gls{glsabbrvsmfont} and
+\gls{glsfirstabbrvsmfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexamplesmdesc{short-sm-long-desc}
+
+\abbrstyledef{short-em-long}
+This style is like \abbrstyle{short-long} but it uses
+\gls{glsxtremsuffix}, \gls{glsabbrvemfont} and
+\gls{glsfirstabbrvemfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexampleuc{short-em-long}
+
+\abbrstyledef{short-em-long-desc}
+This style is like \abbrstyle{short-long-desc} but it uses
+\gls{glsxtremsuffix}, \gls{glsabbrvemfont} and
+\gls{glsfirstabbrvemfont} (see \sectionref{sec:abbrvcmdsfonts}).
+
+\abbrvstyleexampleucdesc{short-em-long-desc}
+
+\abbrstyledef{short-em-long-em}
+This style is like \abbrstyle{short-long} but it uses
+\gls{glsxtremsuffix}, \gls{glsabbrvemfont} and
+\gls{glsfirstabbrvemfont}, \gls{glsfirstlongemfont}
+and \gls{glslongemfont} (see \sectionref{sec:abbrvcmdsfonts}).
+That is, both the long and short forms are emphasized.
+
+\abbrvstyleexampleuc{short-em-long-em}
+
+\abbrstyledef{short-em-long-em-desc}
+This style is like \abbrstyle{short-long-desc} but it uses
+\gls{glsxtremsuffix}, \gls{glsabbrvemfont} and
+\gls{glsfirstabbrvemfont}, \gls{glsfirstlongemfont}
+and \gls{glslongemfont} (see \sectionref{sec:abbrvcmdsfonts}).
+That is, both the long and short forms are emphasized.
+
+\abbrvstyleexampleucdesc{short-em-long-em-desc}
+
+\paragraph{Short (Long, User) Styles}
+\label{sec:predefnonregabbrvstylesshortlonguser}These styles are like the
+short (long) styles in
+\sectionref{sec:predefnonregabbrvstylesshortlong}
+but additional content can be supplied in the field identified by
+\gls{glsxtruserfield}, which will be placed in the parenthetical
+content on \idx{firstuse} (if set).
+The \idx{inlinefullform} is the same as the \idx{displayfullform}.
+
+These styles use the commands \gls{glsxtrusersuffix},
+\gls{glsabbrvuserfont}, \gls{glsfirstabbrvuserfont},
+\gls{glslonguserfont} and \gls{glsfirstlonguserfont} (except where
+noted). See \sectionref{sec:abbrvcmdsgeneral} and
+\sectionref{sec:abbrvcmdsuser} for style commands.
+
+\abbrstyledef{short-long-user}
+This style is like \abbrstyle{short-long} but it includes the
+additional content in the parentheses on \idx{firstuse} or the
+\idx{inlinefullform}.
+
+The description is obtained from
+\gls{glsuserdescription}, which can be redefined to include the
+additional information, if required.
-The \gls{numberlist} is now placed inside the argument of
-\begin{definition}[\DescribeMacro\GlsXtrFormatLocationList]
-\cs{GlsXtrFormatLocationList}\marg{number list}
-\end{definition}
-This is internally used by \cs{glossaryentrynumbers}. The
-\pkgopt{nonumberlist} option redefines \cs{glossaryentrynumbers} so that it
-doesn't display the \gls{numberlist}, but it still saves the
-\gls{numberlist} in case it's required.
+\abbrvstyleexampleucuser{short-long-user}
+
+\abbrstyledef{short-long-user-desc}
+This style is like \abbrstyle{short-long-user} but the description
+must be provided. The name is obtained from
+\gls{glsxtrshortlonguserdescname} and the sort value is obtained
+from \gls{glsxtrshortlongdescsort}.
+
+\abbrvstyleexampleucuserdesc{short-long-user-desc}
\begin{important}
-If you want to suppress the \gls{numberlist} always use the
-\pkgopt{nonumberlist} option instead of redefining
-\cs{glossaryentrynumbers} to do nothing.
+This style is incompatible with \gls{GLSname}.
\end{important}
-For example, to change the font for the entire
-\gls{numberlist} redefine \cs{GlsXtrFormatLocationList} as
-appropriate. Don't modify \cs{glossaryentrynumbers}.
+If you need to use \gls{GLSname} with this style, you'll have to
+redefine \gls{glsxtrshortlonguserdescname} so that the field name
+doesn't include the entry label. For example:
+\begin{codebox}
+\cmd{newcommand}\marg{\gls{glsxtrlongshortuserdescname}}\marg{\%
+ \cmd{protect}\gls{glsabbrvuserfont}\marg{\cmd{the}\gls{glsshorttok}}\%
+ \cmd{space}(\cmd{protect}\gls{glslonguserfont}\marg{\cmd{the}\gls{glslongtok}})\%
+}
+\end{codebox}
-Sometimes users like to insert \qt{page} or \qt{pages} in front of
-the \gls{numberlist}. This is quite fiddly to do with the base
-\styfmt{glossaries} package, but \styfmt{glossaries-extra}
-provides a way of doing this. First you need to enable this
-option and specify the text to display using:
-\begin{definition}[\DescribeMacro\GlsXtrEnablePreLocationTag]
-\cs{GlsXtrEnablePreLocationTag}\marg{page}\marg{pages}
-\end{definition}
-where \meta{page} is the text to display if the \gls{numberlist} only
-contains a single location and \meta{pages} is the text to display
-otherwise. For example:
-\begin{verbatim}
-\GlsXtrEnablePreLocationTag{Page: }{Pages: }
-\end{verbatim}
-An extra run is required when using this command.
+\abbrstyledef{short-postlong-user}
+This style is like \abbrstyle{short-long} but it includes the
+additional content in the parentheses on \idx{firstuse} or the
+\idx{inlinefullform}. The parenthetical content is placed in the
+\idx{postlinkhook} which can avoid overly long hyperlinks.
+
+The description is obtained from
+\gls{glsuserdescription}, which can be redefined to include the
+additional information, if required.
+
+\abbrvstyleexampleucuser{short-postlong-user}
+
+\abbrstyledef{short-postlong-user-desc}
+This style is like \abbrstyle{short-postlong-user} but the description
+must be provided. The name is obtained from
+\gls{glsxtrshortlonguserdescname}. The sort value is the short form.
+
+\abbrvstyleexampleucuserdesc{short-postlong-user-desc}
\begin{important}
-Use \texttt{glsignore} not \texttt{@gobble} as the format if you
-want to suppress the page number (and only index the entry once).
+This style is incompatible with \gls{GLSname}.
\end{important}
-See the accompanying sample file \texttt{sample-pages.tex}.
+If you need to use \gls{GLSname} with this style, you'll have to
+redefine \gls{glsxtrshortlonguserdescname} so that the field name
+doesn't include the entry label, as for \abbrstyle{short-long-user-desc}.
+
+\paragraph{Hyphen Styles}
+\label{sec:predefnonregabbrvstyleshyphen}These styles test
+if the inserted material start with a hyphen. See
+\sectionref{sec:abbrvcmdsgeneral}, \sectionref{sec:abbrvcmdsparen}
+and \sectionref{sec:abbrvcmdshyphen} for style commands.
+
+\begin{information}
+These styles are designed to be used with the \catattr{markwords}
+attribute and (if the short form has spaces) the
+\catattr{markshortwords} attribute. If the inserted material starts
+with a hyphen, the spaces will be replaced with hyphens. This
+replacement won't take place if the corresponding attribute wasn't
+used to mark the inter-word spaces.
+\end{information}
+
+Note that \gls{glsxtrshort} and \gls{glsxtrlong} (and their plural
+and case-changing variants) don't perform the inter-word space
+substitution. The \idx{inlinefullform} is slightly different from
+the \idx{displayfullform} for the \qt{post} styles.
+
+\abbrstyledef{long-hyphen-short-hyphen}
+This style is like \abbrstyle{long-short} but checks the inserted
+material for a leading hyphen. The description is the long form
+encapsulated with \gls{glslonghyphenfont}. The name is obtained from
+\gls{glsxtrlongshortname}, and the sort value is obtained from
+\gls{glsxtrlonghyphenshortsort}. The
+\idx{inlinefullform} is the same as the \idx{displayfullform}.
+
+\abbrvstyleexampleuchyp{long-hyphen-short-hyphen}
+
+\abbrstyledef{long-hyphen-postshort-hyphen}
+This style is like \abbrstyle{long-hyphen-short-hyphen} but places
+the insert and parenthetical material in the \idx{postlinkhook} for
+the \idx{displayfullform}.
+
+\abbrvstyleexampleuchyp{long-hyphen-postshort-hyphen}
+
+Note that the \idx{inlinefullform} (\gls{glsxtrfull}) doesn't show
+the insert in the \idx{postlinkhook}, but instead places it at the
+end of the \idx{linktext}. This is because only the
+\idx{glslike} commands (not the \idx{glstextlike} commands) set the
+placeholder \gls{glsinsert} to the supplied insert. If you want the
+insert to show in the parenthetical part of the \idx{postlinkhook} for the
+\idx{inlinefullform} you need to redefine
+\gls{glsxtrfullsaveinsert}:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glsxtrfullsaveinsert}}[2]\marg{\cmd{def}\gls{glsinsert}\marg{\#2}}
+\end{codebox}
+
+\abbrstyledef{long-hyphen-short-hyphen-desc}
+This style is like \abbrstyle{long-hyphen-short-hyphen} but the
+description must be supplied. The name is obtained from
+\gls{glsxtrlongshortdescname}, and the sort value is
+obtained from \gls{glsxtrlongshortdescsort}.
+
+\abbrvstyleexampleuchypdesc{long-hyphen-short-hyphen-desc}
+
+\abbrstyledef{long-hyphen-postshort-hyphen-desc}
+This style is like \abbrstyle{long-hyphen-short-hyphen-desc} but places
+the insert and parenthetical material in the \idx{postlinkhook} for
+the \idx{displayfullform}.
+
+\abbrvstyleexampleuchypdesc{long-hyphen-postshort-hyphen-desc}
+
+Note that as with the
+\abbrstyle{long-hyphen-postshort-hyphen} style, the insert isn't
+included in the \idx{postlinkhook} by default for the
+\idx{inlinefullform}. If you want the
+insert to show in the \idx{postlinkhook} for the
+\idx{inlinefullform} you need to redefine
+\gls{glsxtrfullsaveinsert}.
+
+\abbrstyledef{long-hyphen-noshort-desc-noreg}
+This style is like \abbrstyle{long-noshort-desc-noreg} but checks
+the inserted material for a leading hyphen. The description must be
+supplied. The name is obtained from \gls{glsxtrlongnoshortdescname},
+and the sort value is obtained from \gls{glsxtrlonghyphennoshortdescsort}.
+
+\abbrvstyleexampleuchypdesc{long-hyphen-noshort-desc-noreg}
+
+\abbrstyledef{long-hyphen-noshort-noreg}
+This style is like \abbrstyle{long-noshort-noreg} but checks
+the inserted material for a leading hyphen. The description is set
+to the unencapsulated long form. The name is obtained from \gls{glsxtrlongnoshortname},
+and the sort value is obtained from \gls{glsxtrlonghyphennoshortsort}.
+
+\abbrvstyleexampleuchyp{long-hyphen-noshort-noreg}
+
+\abbrstyledef{short-hyphen-long-hyphen}
+This style is like \abbrstyle{short-long} but checks the inserted
+material for a leading hyphen. The description is the long form
+encapsulated with \gls{glslonghyphenfont}. The name is obtained from
+\gls{glsxtrshortlongname} and the sort value is obtained from
+\gls{glsxtrshorthyphenlongsort}.
+
+\abbrvstyleexampleuchyp{short-hyphen-long-hyphen}
+
+\abbrstyledef{short-hyphen-postlong-hyphen}
+This style is like \abbrstyle{short-hyphen-long-hyphen} but the
+insert and parenthetical material are placed in the
+\idx{postlinkhook} for the \idx{displayfullform}.
+
+\abbrvstyleexampleuchyp{short-hyphen-postlong-hyphen}
+
+Note that as with the \abbrstyle{long-hyphen-postshort-hyphen} style,
+the insert isn't included in the \idx{postlinkhook} by default for
+the \idx{inlinefullform}. If you want the insert to show in the
+\idx{postlinkhook} for the \idx{inlinefullform} you need to redefine
+\gls{glsxtrfullsaveinsert} (as described above, for the
+\abbrstyle{long-hyphen-postshort-hyphen} style).
+
+\abbrstyledef{short-hyphen-long-hyphen-desc}
+This style is like \abbrstyle{short-hyphen-long-hyphen} but the
+description must be supplied. The name is obtained from
+\gls{glsxtrshortlongdescname}, and the sort is obtained from
+\gls{glsxtrshortlongdescsort}.
+
+\abbrvstyleexampleuchypdesc{short-hyphen-long-hyphen-desc}
+
+\abbrstyledef{short-hyphen-postlong-hyphen-desc}
+This style is like \abbrstyle{short-hyphen-long-hyphen-desc} but the
+insert and parenthetical material are placed in the
+\idx{postlinkhook} for the \idx{displayfullform}.
+
+\abbrvstyleexampleuchypdesc{short-hyphen-postlong-hyphen-desc}
+
+Note that as with the \abbrstyle{long-hyphen-postshort-hyphen} style,
+the insert isn't included in the \idx{postlinkhook} by default for
+the \idx{inlinefullform}. If you want the insert to show in the
+\idx{postlinkhook} for the \idx{inlinefullform} you need to redefine
+\gls{glsxtrfullsaveinsert} (as described above, for the
+\abbrstyle{long-hyphen-postshort-hyphen} style).
+
+\paragraph{Only Styles}
+\label{sec:predefnonregabbrvstylesonly}These styles only show the
+long form on \idx{firstuse} and only show the short form on
+\idx{subsequentuse}. The
+\idx{inlinefullform} is the same as the \idx{displayfullform}. See
+\sectionref{sec:abbrvcmdsgeneral}, \sectionref{sec:abbrvcmdsparen}
+and \sectionref{sec:abbrvcmdsonly} for style commands.
+
+The \idx{inlinefullform} uses a parenthetical style with the long
+form followed by the short form in parentheses.
+
+\abbrstyledef{long-only-short-only}
+The name is obtained from \gls{glsxtronlyname} and the sort value is
+just the short form. The description is the long form encapsulated
+with \gls{glslongonlyfont}.
+
+\abbrvstyleexampleuc{long-only-short-only}
+
+\abbrstyledef{long-only-short-only-desc}
+This is like \abbrstyle{long-only-short-only} but the description must
+be supplied. The name is obtained from \gls{glsxtronlydescname} and
+the sort is obtained from \gls{glsxtronlydescsort}.
+
+\abbrvstyleexampleucdesc{long-only-short-only-desc}
+
+\abbrstyledef{long-only-short-sc-only}
+This is like \abbrstyle{long-only-short-only} but uses
+\idx{smallcaps}. The name is obtained from \gls{glsxtrsconlyname},
+and it uses \gls{glsabbrvsconlyfont}, \gls{glsfirstabbrvsconlyfont}
+and \gls{glsxtrsconlysuffix} for the abbreviation fonts and plural
+suffix.
+
+\abbrvstyleexamplelc{long-only-short-sc-only}
+
+\abbrstyledef{long-only-short-sc-only-desc}
+This is like \abbrstyle{long-only-short-only-desc} but uses
+\idx{smallcaps}. The name is obtained from \gls{glsxtrsconlydescname},
+and the sort is obtained from \gls{glsxtrsconlydescsort}.
-Note that \gls{bib2gls} can be instructed to insert
-a prefix at the start of non-empty location lists, which
-can be used as an alternative to \cs{GlsXtrEnablePreLocationTag}.
+\abbrvstyleexamplelcdesc{long-only-short-sc-only-desc}
-\Glspl{locationlist} displayed with \cs{printnoidxglossary}
-internally use
-\begin{definition}[\DescribeMacro\glsnoidxdisplayloc]
-\cs{glsnoidxdisplayloc}\marg{prefix}\marg{counter}\marg{format}\marg{location}
-\end{definition}
-This command is provided by \styfmt{glossaries}, but is modified by
-\styfmt{glossaries-extra} to check for the start and end range
-formation identifiers \verb|(| and \verb|)| which are discarded to
-obtain the actual control sequence name that forms the location
-formatting command.
+\paragraph{Footnote Styles}
+\label{sec:predefnonregabbrvstylesfootnote}These styles show the
+short form (\gls{glsxtrshortformat}) with the long form as a footnote on
+\idx{firstuse}. On \idx{subsequentuse} only the short form is shown.
+See \sectionref{sec:abbrvcmdsgeneral} and \sectionref{sec:abbrvcmdsfootnote}
+for style commands.
+
+The \idx{inlinefullform} uses the same
+parenthetical style as \abbrstyle{short-long} (\gls{glsxtrshortlongformat}).
+Font variations are available with \abbrstyle{short-sc-footnote},
+\abbrstyle{short-sm-footnote} and \abbrstyle{short-em-footnote}.
-If the range identifiers aren't present, this just uses
-\begin{definition}[\DescribeMacro\glsxtrdisplaysingleloc]
-\cs{glsxtrdisplaysingleloc}\marg{format}\marg{location}
-\end{definition}
-otherwise it uses
-\begin{definition}[\DescribeMacro\glsxtrdisplaystartloc]
-\cs{glsxtrdisplaystartloc}\marg{format}\marg{location}
-\end{definition}
-for the start of a range (where the identifier has been stripped
-from \meta{format}) or
-\begin{definition}[\DescribeMacro\glsxtrdisplayendloc]
-\cs{glsxtrdisplayendloc}\marg{format}\marg{location}
-\end{definition}
-for the end of a range (where the identifier has been stripped
-from \meta{format}).
+\abbrstyledef{short-footnote}
+The \meta{insert} is placed after the short form on \idx{firstuse}
+and \idx{subsequentuse} of the \idx{glslike} commands.
-By default the start range command saves the format in
-\begin{definition}[\DescribeMacro\glsxtrlocrangefmt]
-\cs{glsxtrlocrangefmt}
-\end{definition}
-and does
-\begin{display}
-\cs{glsxtrdisplaysingleloc}\marg{format}\marg{location}
-\end{display}
-(If the format is empty, it will be replaced with
-\texttt{glsnumberformat}.)
+\abbrvstyleexampleucfn{short-footnote}
-The end command checks that the format matches the start of the
-range, does
-\begin{definition}[\DescribeMacro\glsxtrdisplayendlochook]
-\cs{glsxtrdisplayendlochook}\marg{format}\marg{location}
-\end{definition}
-(which does nothing by default), followed by
-\begin{display}
-\cs{glsxtrdisplaysingleloc}\marg{format}\marg{location}
-\end{display}
-and then sets \cs{glsxtrlocrangefmt} to empty.
+The long form is formatted with \gls{glsfirstlongfootnotefont}
+within the full form and with \gls{glslongfootnotefont} for the
+\gls{glsxtrlong} set of commands.
-This means that the list
-\begin{verbatim}
-\glsnoidxdisplayloc{}{page}{(textbf}{1},
-\glsnoidxdisplayloc{}{page}{textbf}{1},
-\glsnoidxdisplayloc{}{page}{)textbf}{1}.
-\end{verbatim}
-doesn't display any differently from
-\begin{verbatim}
-\glsnoidxdisplayloc{}{page}{textbf}{1},
-\glsnoidxdisplayloc{}{page}{textbf}{1},
-\glsnoidxdisplayloc{}{page}{textbf}{1}.
-\end{verbatim}
-but it does make it easier to define your own custom list handler
-that can accommodate the ranges.
+The short form is formatted with \gls{glsfirstabbrvdefaultfont}
+within the full form and with \gls{glsabbrvdefaultfont} for
+\idx{subsequentuse} and for the \gls{glsxtrshort} set of commands.
-\subsection{The \headingsty{glossaries-extra-stylemods} Package}
-\label{sec:stylemods}
+The name is set to the short form (\gls{glsxtrfootnotename}) and
+the description is set to the unencapsulated long form.
-As from v1.02, \styfmt{glossaries-extra} now includes the package
-\sty{glossaries-extra-stylemods} that will redefine the predefined
-styles to include the post-description hook (for those that are
-missing it). You will need to make sure the styles have already
-been defined before loading \styfmt{glossaries-extra}. For example:
-\begin{verbatim}
-\usepackage{glossaries-extra}
-\usepackage{glossary-longragged}
-\usepackage{glossaries-extra-stylemods}
-\end{verbatim}
-Alternatively you can load
-\texttt{glossary-}\meta{name}\texttt{.sty} at the same time by
-passing \meta{name} as a package option to
-\sty{glossaries-extra-stylemods}. For example:
-\begin{verbatim}
-\usepackage{glossaries-extra}
-\usepackage[longragged]{glossaries-extra-stylemods}
-\end{verbatim}
-Another option is to use the \pkgopt{stylemods} key when you
-load \styfmt{glossaries-extra}. You can omit a value if you only want to use
-the predefined styles that are automatically loaded by
-\styfmt{glossaries} (for example, the \glostyle{long3col} style):
-\begin{verbatim}
-\usepackage[style=long3col,stylemods]{glossaries-extra}
-\end{verbatim}
-Or the value of \pkgopt{stylemods} may be a comma-separated list
-of the style package identifiers. For example:
-\begin{verbatim}
-\usepackage[style=mcoltree,stylemods=mcols]{glossaries-extra}
-\end{verbatim}
-Remember to group the value if it contains any commas:
-\begin{verbatim}
-\usepackage[stylemods={mcols,longbooktabs}]{glossaries-extra}
-\end{verbatim}
-
-\paragraph{Inline Style}
-
-Note that the \glostyle{inline} style is dealt with slightly
-differently. The original definition provided by the
-\sty{glossary-inline} package uses \cs{glspostdescription} at the
-end of the glossary (not after each entry description) within the
-definition of \cs{glspostinline}. The style modification changes
-this so that \cs{glspostinline} just does a full stop followed by
-space factor adjustment, and the description
-\cs{glsinlinedescformat} and sub-entry description formats
-\cs{glsinlinesubdescformat} are redefined to include
-\cs{glsxtrpostdescription} (not \cs{glspostdescription}). This means
-that the modified \glostyle{inline} style isn't affected by the
-\pkgopt{nopostdot} option, but the post-description category hook
-can still be used.
+This style automatically sets the \catattr{nohyperfirst} attribute
+to \code{true} for the entry's category.
-\paragraph{Tabular Styles}
+\abbrstyledef{footnote}
+A synonym for \abbrstyle{short-footnote}.
-The \env{tabular}-like styles, such as \glostyle{long} are
-adjusted so that the \ics{ifglsnogroupskip} conditional (set with
-\pkgopt{nogroupskip}) is moved outside of the definition of
-\cs{glsgroupskip} to avoid problems that cause an \qt{Incomplete
-\cs{iftrue}} error with \cs{printunsrtglossary} and
-\cs{printnoidxglossary}. This means that if you want to change this
-conditional using \cs{setupglossaries} or using the
-\gloskey[printglossary]{nogroupskip} option in \cs{printglossary},
-\cs{printnoidxglossary} or \cs{printunsrtglossary}, you must also
-reset the glossary style.
-
-As from version 1.21, the hard-coded \cs{space} before the
-\gls{numberlist} in many of the predefined styles is replaced
-with
-\begin{definition}[\DescribeMacro\glsxtrprelocation]
-\cs{glsxtrprelocation}
-\end{definition}
-This just defaults to \cs{space} but may be redefined as required.
-For example:
-\begin{verbatim}
-\renewcommand{\glsxtrprelocation}{\dotfill}
-\end{verbatim}
-
-\paragraph{List Styles}
-
-The \glostyle{list} styles use
-\begin{definition}[\DescribeMacro\glslistprelocation]
-\cs{glslistprelocation}
-\end{definition}
-(which defaults to \cs{glsxtrprelocation}) for top-level items and
-\begin{definition}[\DescribeMacro\glslistchildprelocation]
-\cs{glslistchildprelocation}
-\end{definition}
-(which defaults to \cs{glslistprelocation}) for child items.
-
-As from v1.31, the description (including the post-description hook)
-is governed by:
-\begin{definition}[\DescribeMacro\glslistdesc]
-\cs{glslistdesc}\marg{label}
-\end{definition}
-for the \glostyle{list} and \glostyle{altlist} styles (but not the
-\glostyle{listdotted} variations).
+\abbrstyledef{short-footnote-desc}
+As \abbrstyle{short-footnote} but the description must be supplied in
+the optional argument of \gls{newabbreviation}.
-As from v1.47, the item is governed by:
-\begin{definition}[\DescribeMacro\glslistitem]
-\cs{glslistitem}\marg{label}
-\end{definition}
-The \glostyle{altlist} styles use:
-\begin{definition}[\DescribeMacro\glsaltlistitem]
-\cs{glsaltlistitem}\marg{label}
-\end{definition}
-which internally uses \cs{glslistitem}.
-The header item (for the list styles that should the group title) is governed by:
-\begin{definition}[\DescribeMacro\glslistgroupheaderitem]
-\cs{glslistgroupheaderitem}\marg{group-label}\marg{header code}
-\end{definition}
-This ignores the \meta{group-label} by default and simply places the
-second argument in the optional argument of \cs{item}. The
-\meta{header code} is the formatted group title, possibly including
-a hypertarget. The spacing after the group item is given by:
-\begin{definition}[\DescribeMacro\glslistgroupafterheader]
-\cs{glslistgroupafterheader}
-\end{definition}
+\abbrvstyleexampleucdescfn{short-footnote-desc}
-For just the \glostyle{list} style and its letter group variations
-(not the \glostyle{altlist} or \glostyle{listdotted} variations) the
-\gls{numberlist} for child entries is followed by
-\begin{definition}[\DescribeMacro\glslistchildpostlocation]
-\cs{glslistchildpostlocation}
-\end{definition}
-which defaults to a full stop.
+The name is set to the short form followed by the long form in
+parentheses (\gls{glsxtrfootnotedescname}), and the sort is set to
+just the short form (\gls{glsxtrfootnotedescsort}).
-The default value of \ics{glslistdottedwidth} is changed so that
-it's set at the start of the document (if it hasn't been changed in
-the preamble). This should take into account situations where
-\cs{hsize} isn't set until the start of the document.
+\abbrstyledef{footnote-desc}
+A synonym for \abbrstyle{short-footnote-desc}.
-The separator between groups (if not \pkgopt{nogroupskip}) is now
-given by:
-\begin{definition}[\DescribeMacro\glslistgroupskip]
-\cs{glslistgroupskip}
-\end{definition}
-This defaults to \cs{indexspace} with penalties to deter page
-breaks.
-This command isn't used if \pkgopt{nogroupskip} is set.
-
-The \sty{glossary-tree} package introduced new commands in
-v4.22, \ics{glstreegroupheaderfmt}
-and \ics{glstreenavigationfmt}, which are used to format
-the letter group headings and the navigation elements for the
-appropriate styles. These two new commands are defined in terms of
-\ics{glstreenamefmt} since that was the command originally used
-for the group headings and navigation. This now allows these
-different elements to be defined independently, but the most common
-redefinition is for \cs{glstreenamefmt} to remove the bold in the
-name. If the bold is still required for the group heading and navigation
-elements, then both other commands also need redefining. To simplify
-matters, if \cs{glstreenamefmt} has been defined, as from v1.31
-\sty{glossaries-extra-stylemods} defines:
-\begin{definition}[\DescribeMacro\glstreedefaultnamefmt]
-\cs{glstreedefaultnamefmt}\marg{text}
-\end{definition}
-which simply does \cs{textbf}\marg{text} and redefines
-\cs{glstreenamefmt}, \cs{glstreegroupheaderfmt} and
-\cs{glstreenavigationfmt} all in terms of
-\cs{glstreedefaultnamefmt}.
-
-This means that if you want to change
-all three to use a particular style you only need to redefine
-\cs{glstreedefaultnamefmt}, but if you only want to redefine
-\cs{glstreenamefmt} without affecting the other two commands, then
-you now can.
+\abbrstyledef{short-postfootnote}
+Similar to \abbrstyle{short-footnote} but the footnote command is
+placed in the \idx{postlinkhook}. This avoids the problem of nested
+hyperlinks caused by the footnote marker hyperlink being inside the
+\idx{linktext} (which is why the \abbrstyle{short-footnote} style
+switches on the \catattr{nohyperfirst} attribute). Using the
+\idx{postlinkhook} makes it possible to check for following
+punctuation so that the footnote marker can be shifted after the
+punctuation character.
-The separator between groups without headers is given by:
-\begin{definition}[\DescribeMacro\glstreegroupskip]
-\cs{glstreegroupskip}
-\end{definition}
-This defaults to just \ics{indexspace} without penalties. This
-command isn't used if \pkgopt{nogroupskip} is set. (The penalties
-introduced in v1.41 were moved to \cs{glstreeheadergroupskip} in
-v1.42 as they are inappropriate when there's no header.)
+\abbrvstyleexampleucfn{short-postfootnote}
-The separator between groups with headers is now given by (as from v1.42):
-\begin{definition}[\DescribeMacro\glstreeheadergroupskip]
-\cs{glstreegroupheaderskip}
-\end{definition}
-This defaults to \cs{glstreegroupskip} with penalties to deter page
-breaks after the group heading.
+\abbrstyledef{postfootnote}
+A synonym for \abbrstyle{short-postfootnote}.
-The styles that display the group titles now use:
-\begin{definition}[\DescribeMacro\glstreePreHeader]
-\cs{glstreePreHeader}\marg{label}\marg{title}
-\end{definition}
-where \meta{label} is the group label and \meta{title} is the group
-title. This does nothing by default
-and is inserted before the group title. You can redefine it to add
-the group title to the PDF bookmarks. For example, if the
-glossary title uses \cs{chapter} then:
-\begin{verbatim}
-\renewcommand{\glstreePreHeader}[2]{%
- \pdfbookmark[1]{#2}{\currentglossary.#1}%
-}
-\end{verbatim}
-will insert section-level bookmarks. The use of \cs{currentglossary}
-helps to provide unique bookmark labels in the event of multiple
-glossaries.
+\abbrstyledef{short-postfootnote-desc}
+Similar to \abbrstyle{short-footnote-desc} but the footnote command is
+placed in the \idx{postlinkhook} as with
+\abbrstyle{short-postfootnote}.
-The \sty{glossary-tree} package provides the commands
-\begin{definition}[\DescribeMacro\glstreepredesc]
-\cs{glstreepredesc}
-\end{definition}
-and
-\begin{definition}[\DescribeMacro\glstreechildpredesc]
-\cs{glstreechildpredesc}
-\end{definition}
-(which both default to a space) and uses them in the \glostyle{tree}-like
-styles, but not for the \glostyle{alttree} style. The
-\sty{glossaries-extra-stylemods} package modifies the
-\glostyle{alttree} style so that it has equivalent hooks:
-\begin{definition}[\DescribeMacro\glsalttreepredesc]
-\cs{glsalttreepredesc}
-\end{definition}
-and
-\begin{definition}[\DescribeMacro\glsalttreechildpredesc]
-\cs{glsalttreechildpredesc}
-\end{definition}
-These do nothing by default.
+\abbrvstyleexampleucdescfn{short-postfootnote-desc}
-The \glostyle{index}-like and \glostyle{tree}-like styles
-insert the pre-\gls{numberlist} space with
-\begin{definition}[\DescribeMacro\glstreeprelocation]
-\cs{glstreeprelocation}
-\end{definition}
-(which defaults to \cs{glsxtrprelocation}) for top-level items and
-\begin{definition}[\DescribeMacro\glstreechildprelocation]
-\cs{glstreechildprelocation}
-\end{definition}
-(which defaults to \cs{glstreeprelocation}) for child items.
-
-As from version 1.31, the \styfmt{glossaries-extra-stylemods}
-package also provides:
-\begin{definition}[\DescribeMacro\glstreenonamedesc]
-\cs{glstreenonamedesc}\marg{label}
-\end{definition}
-which is used by the \glostyle{treenoname} styles to display the
-pre-description separator, the description and the post-description
-hook. Similarly for the symbol:
-\begin{definition}[\DescribeMacro\glstreenonamesymbol]
-\cs{glstreenonamesymbol}\marg{label}
-\end{definition}
-The above are just used for top-level entries. Child entries don't
-have the name or symbol displayed for the \glostyle{treenoname}
-styles, so there's only a command for the child description:
-\begin{definition}[\DescribeMacro\glstreenonamechilddesc]
-\cs{glstreenonamechilddesc}\marg{label}
-\end{definition}
+\abbrstyledef{postfootnote-desc}
+A synonym for \abbrstyle{short-postfootnote-desc}.
-For the \glostyle{tree} styles (but not the \glostyle{treenoname} or
-\glostyle{alttree} styles), the description is displayed using:
-\begin{definition}[\DescribeMacro\glstreedesc]
-\cs{glstreedesc}\marg{label}
-\end{definition}
-and the symbol with:
-\begin{definition}[\DescribeMacro\glstreesymbol]
-\cs{glstreesymbol}\marg{label}
-\end{definition}
-Again the above two commands are just for top-level entries. The
-child entries use:
-\begin{definition}[\DescribeMacro\glstreechilddesc]
-\cs{glstreechilddesc}\marg{label}
-\end{definition}
-for the description and
-\begin{definition}[\DescribeMacro\glstreechildsymbol]
-\cs{glstreechildsymbol}\marg{label}
-\end{definition}
-for the symbol.
-As from version 1.41, there are now wrapper commands for
-\cs{glstreedesc} and \cs{glstreechilddesc} that check for
-the description and symbol to determine what separator to use
-before the page list. These are:
-\begin{definition}[\DescribeMacro\glstreeDescLoc]
-\cs{glstreeDescLoc}\marg{label}\marg{location}
-\end{definition}
-for top-level entries and
-\begin{definition}[\DescribeMacro\glstreeChildDescLoc]
-\cs{glstreeChildDescLoc}\marg{label}\marg{location}
-\end{definition}
-for sub-entries.
-
-If either the symbol or description is present these will use
-\cs{glstreeprelocation} or \cs{glstreechildprelocation},
-respectively. Otherwise, both will use (from v1.42):
-\begin{definition}[\DescribeMacro\glstreeNoDescSymbolPreLocation]
-\cs{glstreeNoDescSymbolPreLocation}
-\end{definition}
-The default is a space. This means that you could have, say, a
-comma followed by a space for terms that are simply an alias, but
-just have a space for terms that have a description that ends with a
-full stop (or that just have a symbol without a description) where
-the comma would be inappropriate.
+\abbrstyledef{short-sc-footnote}
+This style is like \abbrstyle{short-footnote} but it uses
+\gls{glsxtrscsuffix}, \gls{glsabbrvscfont} and
+\gls{glsfirstabbrvscfont} (see \sectionref{sec:abbrvcmdsfonts}).
-Note that version 1.42 has corrected an error that was introduced to
-v1.41 that caused the name to run into the location list if there
-was no symbol and no description.
+\abbrvstyleexamplelcfn{short-sc-footnote}
-As from version 1.05, the \styfmt{glossaries-extra-stylemods}
-package provides some additional commands for use with the
-\glostyle{alttree} style to make it easier to modify.
-These commands are only defined if the
-\sty{glossary-tree} package has already been loaded, which is
-typically the case unless the \pkgopt{notree} option has been used
-when loading \styfmt{glossaries}.
-
-\begin{definition}[\DescribeMacro\gglssetwidest]
-\cs{gglssetwidest}\oarg{level}\marg{name}
-\end{definition}
-(New to version 1.21.)
-This is like \cs{glssetwidest} (provided by \sty{glossary-tree})
-but performs a global assignment.
-
-\begin{definition}[\DescribeMacro\eglssetwidest]
-\cs{eglssetwidest}\oarg{level}\marg{name}
-\end{definition}
-This is like \cs{glssetwidest}
-but performs a protected expansion on \meta{name}. This has
-a localised effect. For a global setting, use
-\begin{definition}[\DescribeMacro\xglssetwidest]
-\cs{xglssetwidest}\oarg{level}\marg{name}
-\end{definition}
-The following only set the value if \meta{name} is wider than the
-current value (new to version 1.23). Local update:
-\begin{definition}[\DescribeMacro\glsupdatewidest]
-\cs{glsupdatewidest}\oarg{level}\marg{name}
-\end{definition}
-Global update:
-\begin{definition}[\DescribeMacro\gglsupdatewidest]
-\cs{gglsupdatewidest}\oarg{level}\marg{name}
-\end{definition}
-Locale update (expands \meta{name}):
-\begin{definition}[\DescribeMacro\eglsupdatewidest]
-\cs{eglsupdatewidest}\oarg{level}\marg{name}
-\end{definition}
-Global update (expands \meta{name}):
-\begin{definition}[\DescribeMacro\xglsupdatewidest]
-\cs{xglsupdatewidest}\oarg{level}\marg{name}
-\end{definition}
-
-
-The widest entry value can later be retrieved using
-\begin{definition}[\DescribeMacro\glsgetwidestname]
-\cs{glsgetwidestname}
-\end{definition}
-for the top-level entries and
-\begin{definition}[\DescribeMacro\glsgetwidestsubname]
-\cs{glsgetwidestsubname}\marg{level}
-\end{definition}
-for sub-entries, where \meta{level} is the level number.
-
-Note that if you are using \gls{bib2gls}, you can use the
-resource option \texttt{set-widest} which will try to determine the
-widest name of all the selected entries. This isn't guaranteed
-to work as it may depend on fonts or commands that \gls{bib2gls}
-can't replicate, but it should be suitable for names that just
-consist of text, and can be more efficient than iterating over all
-the defined entries using \TeX.
+\abbrstyledef{short-sc-footnote-desc}
+This style is like \abbrstyle{short-footnote-desc} but it uses
+\gls{glsxtrscsuffix}, \gls{glsabbrvscfont} and
+\gls{glsfirstabbrvscfont} (see \sectionref{sec:abbrvcmdsfonts}).
-The command \cs{glsfindwidesttoplevelname} provided by
-\sty{glossary-tree} has a CamelCase synonym:
-\begin{definition}[\DescribeMacro\glsFindWidestTopLevelName]
-\cs{glsFindWidestTopLevelName}\oarg{glossary list}
-\end{definition}
-Similar commands are also provided:
-\begin{definition}[\DescribeMacro\glsFindWidestUsedTopLevelName]
-\cs{glsFindWidestUsedTopLevelName}\oarg{glossary list}
-\end{definition}
-This has an additional check that the entry has been used.
-Naturally this is only useful if the glossaries that use
-the \glostyle{alttree} style occur at the end of the document.
-This command should be placed just before the start of the glossary.
-(Alternatively, place it at the end of the document and save
-the value in the auxiliary file for the next run.)
+\abbrvstyleexamplelcdescfn{short-sc-footnote-desc}
-\begin{definition}[\DescribeMacro\glsFindWidestUsedAnyName]
-\cs{glsFindWidestUsedAnyName}\oarg{glossary list}
-\end{definition}
-This is like the previous command but if doesn't check the
-\gloskey{parent} key. This is useful if all levels should have the
-same width for the name.
+\abbrstyledef{short-sc-postfootnote}
+This style is like \abbrstyle{short-postfootnote} but it uses
+\gls{glsxtrscsuffix}, \gls{glsabbrvscfont} and
+\gls{glsfirstabbrvscfont} (see \sectionref{sec:abbrvcmdsfonts}).
-\begin{definition}[\DescribeMacro\glsFindWidestAnyName]
-\cs{glsFindWidestAnyName}\oarg{glossary list}
-\end{definition}
-This is like the previous command but doesn't check if the entry
-has been used.
+\abbrvstyleexamplelcfn{short-sc-postfootnote}
-\begin{definition}[\DescribeMacro\glsFindWidestUsedLevelTwo]
-\cs{glsFindWidestUsedLevelTwo}\oarg{glossary list}
-\end{definition}
-This is like \cs{glsFindWidestUsedTopLevelName} but also sets
-the first two sub-levels as well. Any entry that has a
-great-grandparent is ignored.
+\abbrstyledef{short-sc-postfootnote-desc}
+This style is like \abbrstyle{short-postfootnote-desc} but it uses
+\gls{glsxtrscsuffix}, \gls{glsabbrvscfont} and
+\gls{glsfirstabbrvscfont} (see \sectionref{sec:abbrvcmdsfonts}).
-\begin{definition}[\DescribeMacro\glsFindWidestLevelTwo]
-\cs{glsFindWidestLevelTwo}\oarg{glossary list}
-\end{definition}
-This is like the previous command but doesn't check if the entry has
-been used.
+\abbrvstyleexamplelcdescfn{short-sc-postfootnote-desc}
-\begin{definition}[\DescribeMacro\glsFindWidestUsedAnyNameSymbol]
-\cs{glsFindWidestUsedAnyNameSymbol}\oarg{glossary
-list}\marg{register}
-\end{definition}
-This is like \cs{glsFindWidestUsedAnyName} but also measures the
-symbol. The length of the widest symbol is stored in
-\meta{register}.
+\abbrstyledef{short-sm-footnote}
+This style is like \abbrstyle{short-footnote} but it uses
+\gls{glsxtrsmsuffix}, \gls{glsabbrvsmfont} and
+\gls{glsfirstabbrvsmfont} (see \sectionref{sec:abbrvcmdsfonts}).
-\begin{definition}[\DescribeMacro\glsFindWidestAnyNameSymbol]
-\cs{glsFindWidestAnyNameSymbol}\oarg{glossary list}\marg{register}
-\end{definition}
-This is like the previous command but it doesn't check if the entry
-has been used.
+\abbrvstyleexamplesmfn{short-sm-footnote}
-\begin{definition}[\DescribeMacro\glsFindWidestUsedAnyNameSymbolLocation]
-\cs{glsFindWidestUsedAnyNameSymbolLocation}\oarg{glossary
-list}\marg{symbol register}\marg{location register}
-\end{definition}
-This is like \cs{glsFindWidestUsedAnyNameSymbol} but also
-measures the \gls{numberlist}. This requires
-\ics{glsentrynumberlist} (see the \styfmt{glossaries} user manual).
-The length of the widest symbol is stored in \meta{symbol register}
-and the length of the widest \gls*{numberlist} is stored in
-\meta{location register}.
-
-\begin{definition}[\DescribeMacro\glsFindWidestAnyNameSymbolLocation]
-\cs{glsFindWidestAnyNameSymbolLocation}\oarg{glossary
-list}\marg{symbol register}\marg{location register}
-\end{definition}
-This is like the previous command but it doesn't check if the entry
-has been used.
+\abbrstyledef{short-sm-footnote-desc}
+This style is like \abbrstyle{short-footnote-desc} but it uses
+\gls{glsxtrsmsuffix}, \gls{glsabbrvsmfont} and
+\gls{glsfirstabbrvsmfont} (see \sectionref{sec:abbrvcmdsfonts}).
-\begin{definition}[\DescribeMacro\glsFindWidestUsedAnyNameLocation]
-\cs{glsFindWidestUsedAnyNameLocation}\oarg{glossary
-list}\marg{register}
-\end{definition}
-This is like \cs{glsFindWidestUsedAnyNameSymbolLocation} but doesn't
-measure the symbol. The length of the widest \gls{numberlist}
-is stored in \meta{register}.
+\abbrvstyleexamplesmdescfn{short-sm-footnote-desc}
-\begin{definition}[\DescribeMacro\glsFindWidestAnyNameLocation]
-\cs{glsFindWidestAnyNameLocation}\oarg{glossary
-list}\marg{register}
-\end{definition}
-This is like the previous command but doesn't check if the entry has
-been used.
+\abbrstyledef{short-sm-postfootnote}
+This style is like \abbrstyle{short-postfootnote} but it uses
+\gls{glsxtrsmsuffix}, \gls{glsabbrvsmfont} and
+\gls{glsfirstabbrvsmfont} (see \sectionref{sec:abbrvcmdsfonts}).
-The layout of the symbol, description and \gls{numberlist}
-is governed by
-\begin{definition}[\DescribeMacro\glsxtralttreeSymbolDescLocation]
-\cs{glsxtralttreeSymbolDescLocation}\marg{label}\marg{number list}
-\end{definition}
-for top-level entries and
-\begin{definition}[\DescribeMacro\glsxtralttreeSubSymbolDescLocation]
-\cs{glsxtralttreeSubSymbolDescLocation}\marg{label}\marg{number list}
-\end{definition}
-for sub-entries.
+\abbrvstyleexamplesmfn{short-sm-postfootnote}
-There is now a user level command that performs the initialisation
-for the \glostyle{alttree} style:
-\begin{definition}[\DescribeMacro\glsxtralttreeInit]
-\cs{glsxtralttreeInit}
-\end{definition}
+\abbrstyledef{short-sm-postfootnote-desc}
+This style is like \abbrstyle{short-postfootnote-desc} but it uses
+\gls{glsxtrsmsuffix}, \gls{glsabbrvsmfont} and
+\gls{glsfirstabbrvsmfont} (see \sectionref{sec:abbrvcmdsfonts}).
-The paragraph indent for subsequent paragraphs in multi-paragraph
-descriptions is provided by the length
-\begin{definition}[\DescribeMacro\glsxtrAltTreeIndent]
-\cs{glsxtrAltTreeIndent}
-\end{definition}
+\abbrvstyleexamplesmdescfn{short-sm-postfootnote-desc}
-For additional commands that are available with the
-\glostyle{alttree} style, see the documented code
-(\nolinkurl{glossaries-extra-code.pdf}). See also
-the accompanying sample files \nolinkurl{sample-alttree.tex},
-\nolinkurl{sample-alttree-sym.tex} and
-\nolinkurl{sample-alttree-marginpar.tex}.
+\abbrstyledef{short-em-footnote}
+This style is like \abbrstyle{short-footnote} but it uses
+\gls{glsxtremsuffix}, \gls{glsabbrvemfont} and
+\gls{glsfirstabbrvemfont} (see \sectionref{sec:abbrvcmdsfonts}).
-\chapter{New Glossary Styles}
-\label{sec:newglossarystyles}
+\abbrvstyleexampleucfn{short-em-footnote}
-The \styfmt{glossaries-extra} package comes with some new styles.
-The associated style package needs to be loaded. This can be done
-with \cs{usepackage} but it's simpler to use the \pkgopt{stylemods}
-option.
+\abbrstyledef{short-em-footnote-desc}
+This style is like \abbrstyle{short-footnote-desc} but it uses
+\gls{glsxtremsuffix}, \gls{glsabbrvemfont} and
+\gls{glsfirstabbrvemfont} (see \sectionref{sec:abbrvcmdsfonts}).
-\section{\headingsty{glossary-bookindex} package}
-\label{sec:bookindex}
+\abbrvstyleexampleucdescfn{short-em-footnote-desc}
-As from v1.21, \styfmt{glossaries-extra} has a new supplementary
-package \sty{glossary-bookindex} which provides the glossary style
-\glostyle{bookindex}. This is very similar to the
-\glostyle{mcolindexgroup} style but is designed for indexes, so by
-default only the name and location list are displayed. You can
-either load this package explicitly and then set the style:
-\begin{verbatim}
-\usepackage{glossaries-extra}
-\usepackage{glossary-bookindex}
-\setglossarystyle{bookindex}
-\end{verbatim}
-or use both the \pkgopt{stylemods} and \sty{style} options:
-\begin{verbatim}
-\usepackage[stylemods=bookindex,style=bookindex]{glossaries-extra}
-\end{verbatim}
-The \glostyle{bookindex} style only supports a maximum
-hierarchical level of 2 (top-level, level~1 and level~2). It's
-primarily designed for use with \gls{bib2gls}. It may be used with
-other indexing options, but some features may not be present and
-UTF-8 characters may cause a problem with non-Unicode engines in
-letter group headings or PDF bookmarks. (\gls{bib2gls} uses numeric
-identifies by default to avoid these problems. If numbers show up in
-the group headings instead of the appropriate characters, check that
-you have used the \pkgopt{record} package option.)
-
-The number of columns is given by
-\begin{definition}[\DescribeMacro\glsxtrbookindexcols]
-\cs{glsxtrbookindexcols}
-\end{definition}
-which defaults to 2.
+\abbrstyledef{short-em-postfootnote}
+This style is like \abbrstyle{short-postfootnote} but it uses
+\gls{glsxtremsuffix}, \gls{glsabbrvemfont} and
+\gls{glsfirstabbrvemfont} (see \sectionref{sec:abbrvcmdsfonts}).
-This style uses the \env{multicols} environment. If
-the command
-\begin{definition}[\DescribeMacro\glsxtrbookindexcolspread]
-\cs{glsxtrbookindexcolspread}
-\end{definition}
-isn't empty then it's supplied as the optional argument
-following \verb|\begin{multicols}|\marg{n}. You can switch from
-\env{multicols} to \env{multicols*} by redefining
-\begin{definition}[\DescribeMacro\glsxtrbookindexmulticolsenv]
-\cs{glsxtrbookindexmulticolsenv}
-\end{definition}
-For example
-\begin{verbatim}
-\renewcommand{\glsxtrbookindexmulticolsenv}{multicols*}
-\end{verbatim}
-
-Each top-level entry is displayed using
-\begin{definition}[\DescribeMacro\glsxtrbookindexname]
-\cs{glsxtrbookindexname}\marg{label}
-\end{definition}
-where the entry is identified by \meta{label}. This just
-does \cs{glossentryname}\marg{label} by default.
-For example, if you want the symbol to be included:
-\begin{verbatim}
-\renewcommand*{\glsxtrbookindexname}[1]{%
- \glossentryname{#1}%
- \ifglshassymbol{#1}{\space (\glossentrysymbol{#1})}{}%
-}
-\end{verbatim}
-or if you want the description (if set):
-\begin{verbatim}
-\renewcommand*{\glsxtrbookindexname}[1]{%
- \glossentryname{#1}%
- \ifglshasdesc{#1}{\space \glossentrydesc{#1}\glspostdescription}{}%
-}
-\end{verbatim}
-(which picks up the post-description hook).
+\abbrvstyleexampleucfn{short-em-postfootnote}
-Alternatively you can use the \cs{glsxtrpostname\meta{category}}
-hook to append information after the name according to the entry's
-category.
+\abbrstyledef{short-em-postfootnote-desc}
+This style is like \abbrstyle{short-postfootnote-desc} but it uses
+\gls{glsxtremsuffix}, \gls{glsabbrvemfont} and
+\gls{glsfirstabbrvemfont} (see \sectionref{sec:abbrvcmdsfonts}).
-Sub-entries are displayed using
-\begin{definition}[\DescribeMacro\glsxtrbookindexsubname]
-\cs{glsxtrbookindexsubname}\marg{label}
-\end{definition}
-which just defaults to \cs{glsxtrbookindexname}\marg{label}.
-
-The separator used before the location list for top-level
-entries is given by
-\begin{definition}[\DescribeMacro\glsxtrbookindexprelocation]
-\cs{glsxtrbookindexprelocation}\marg{label}
-\end{definition}
-where \meta{label} is the entry's label. This checks if
-the \texttt{location} field has been set. If it has, it
-does
-\begin{verbatim}
-,\glsxtrprelocation
-\end{verbatim}
-otherwise it just does \cs{glsxtrprelocation} (which defaults
-to \cs{space}). If you're not using
-\gls{bib2gls}, the \gloskey{location} field won't be set.
-
-The separator used before the
-location list for sub-entries is given by
-\begin{definition}[\DescribeMacro\glsxtrbookindexsubprelocation]
-\cs{glsxtrbookindexsubprelocation}\marg{label}
-\end{definition}
-which defaults to \cs{glsxtrbookindexprelocation}\marg{label}.
+\abbrvstyleexampleucdescfn{short-em-postfootnote-desc}
-The actual location list is encapsulated with:
-\begin{definition}[\DescribeMacro\glsxtrbookindexlocation]
-\cs{glsxtrbookindexlocation}\marg{label}\marg{location list}
-\end{definition}
-for top-level entries and
-\begin{definition}[\DescribeMacro\glsxtrbookindexsublocation]
-\cs{glsxtrbookindexsublocation}\marg{label}\marg{location list}
-\end{definition}
-for sub-entries. These both just do \meta{location list} by default.
-The separator used between a top-level parent and child entry is
-given by
-\begin{definition}[\DescribeMacro\glsxtrbookindexparentchildsep]
-\cs{glsxtrbookindexparentchildsep}
-\end{definition}
-This defaults to \cs{nopagebreak}.
+\paragraph{Short Styles}
+\label{sec:predefnonregabbrvstylesshort}These styles only show the
+short form on both \idx{firstuse} and \idx{subsequentuse}.
+See \sectionref{sec:abbrvcmdsgeneral} and
+\sectionref{sec:abbrvcmdsnolong} for style commands.
+They are essentially identical to the corresponding regular style
+listed in \sectionref{sec:predefnonregabbrvstylesshort} except that
+they change the \catattr{regular} attribute to \code{false}.
-The separator used between a sub-level parent and child entry is
-given by
-\begin{definition}[\DescribeMacro\glsxtrbookindexparentsubchildsep]
-\cs{glsxtrbookindexparentsubchildsep}
-\end{definition}
-This defaults to \cs{glsxtrbookindexparentchildsep}.
-
-The separator between top-level entries is given by
-\begin{definition}[\DescribeMacro\glsxtrbookindexbetween]
-\cs{glsxtrbookindexbetween}\marg{label1}\marg{label2}
-\end{definition}
-This comes after the entry given by \meta{label1}, if the entry
-has no children, or after the last descendent otherwise,
-so it always comes immediately before the entry given
-by \meta{label2} unless the entry occurs at the start of
-a group. This does nothing by default.
+\abbrstyledef{short-nolong-noreg}
+This style is a non-regular version of the \abbrstyle{short-nolong} style.
-The separator between two level~1 entries is given by
-\begin{definition}[\DescribeMacro\glsxtrbookindexsubbetween]
-\cs{glsxtrbookindexsubbetween}\marg{label1}\marg{label2}
-\end{definition}
+\abbrstyledef{short-nolong-desc-noreg}
+This style is a non-regular version of the \abbrstyle{short-nolong-desc} style.
-The separator between two level~2 entries is given by
-\begin{definition}[\DescribeMacro\glsxtrbookindexsubsubbetween]
-\cs{glsxtrbookindexsubsubbetween}\marg{label1}\marg{label2}
-\end{definition}
-At the end of each letter group, the following hooks
-are done in order:
-\begin{definition}[\DescribeMacro\glsxtrbookindexsubsubatendgroup]
-\cs{glsxtrbookindexsubsubatendgroup}\marg{sub-sub-label}
-\end{definition}
-\begin{definition}[\DescribeMacro\glsxtrbookindexsubatendgroup]
-\cs{glsxtrbookindexsubatendgroup}\marg{sub-label}
-\end{definition}
-\begin{definition}[\DescribeMacro\glsxtrbookindexatendgroup]
-\cs{glsxtrbookindexatendgroup}\marg{label}
-\end{definition}
-where \meta{sub-sub-label} is the label of the last
-level~2 entry, \meta{sub-label} is the label of the last
-level~1 entry and \meta{label} is the label of the last
-level~0 entry.
-
-For example, the resource option \texttt{seealso=omit}
-instructs \gls{bib2gls} to omit the \texttt{seealso} cross-reference
-from the location list. (The \texttt{see} cross-reference
-will still be added unless you also have \texttt{see=omit}.)
-The \texttt{seealso} cross-reference can instead be appended after
-the child entries using:
-\begin{verbatim}
-\renewcommand{\glsxtrbookindexatendgroup}[1]{%
- \glsxtrifhasfield{seealso}{#1}{\glstreesubitem\glsxtruseseealso{#1}}{}%
-}
-\renewcommand{\glsxtrbookindexbetween}[2]{%
- \glsxtrbookindexatendgroup{#1}%
-}%
+\abbrstyledef{nolong-short-noreg}
+This style is a non-regular version of the \abbrstyle{nolong-short} style.
+
+\paragraph{Long Styles}
+\label{sec:predefnonregabbrvstyleslong}These styles only show the
+long form on both \idx{firstuse} and \idx{subsequentuse}.
+See \sectionref{sec:abbrvcmdsgeneral} and
+\sectionref{sec:abbrvcmdsnoshort} for style commands.
+They are essentially identical to the corresponding regular style
+listed in \sectionref{sec:predefnonregabbrvstyleslong} except that
+they change the \catattr{regular} attribute to \code{false}.
-\renewcommand{\glsxtrbookindexsubatendgroup}[1]{%
- \glsxtrifhasfield{seealso}{#1}{\glstreesubsubitem\glsxtruseseealso{#1}}{}%
+\abbrstyledef{long-noshort-desc-noreg}
+This style is a non-regular version of the \abbrstyle{long-noshort-desc} style.
+
+\abbrstyledef{long-noshort-noreg}
+This style is a non-regular version of the \abbrstyle{long-noshort} style.
+
+\abbrstyledef{long-em-noshort-em-noreg}
+This style is a non-regular version of the
+\abbrstyle{long-em-noshort-em} style.
+
+\abbrstyledef{long-em-noshort-em-desc-noreg}
+This style is a non-regular version of the
+\abbrstyle{long-em-noshort-em-desc} style.
+
+
+\subsubsection{Formatting Commands and Hooks}
+\label{sec:abbrvcmds}
+
+These commands are used by the predefined abbreviation styles. These
+are considered user commands, which you can redefine to customize
+the style.
+
+\paragraph{General}
+\label{sec:abbrvcmdsgeneral}These commands apply to all styles.
+
+\cmddef{ifglsxtrinsertinside}
+This conditional is used to determine whether the \meta{insert} part
+should go inside or outside of the style's font formatting commands.
+The default setting is false.
+
+\cmddef{glsxtrinsertinsidetrue}
+Set the insert inside conditional to true.
+
+\cmddef{glsxtrinsertinsidefalse}
+Set the insert inside conditional to false.
+
+\cmddef{glsxtrparen}
+Used for parenthetical content in the \idx{inlinefullform} and
+also, for some styles, the \idx{displayfullform}. Note that this formats the opening
+and closing parentheses according to the \idx{innerformatting}, but not the
+argument, which should already incorporate it. The default definition is:
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glsxtrparen}}[1]\marg{\%
+ \gls{glsxtrgenentrytextfmt}\marg{(}\#1\gls{glsxtrgenentrytextfmt}\marg{)}}
+\end{codebox}
+
+\cmddef{glsxtrfullsep}
+Separator placed before \gls{glsxtrparen}. This
+is a space by default, but it includes the \idx{innerformatting}.
+The argument (the entry label) is ignored by default:
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glsxtrfullsep}}[1]\marg{\gls{glsxtrgenentrytextfmt}\marg{ }}
+\end{codebox}
+You can redefine this to use \gls{glsabspace} if you want to have a
+non-breakable space if the short form is less than
+\gls{glsacspacemax} in width. (You can use \gls{glsacspace} instead,
+but note that \gls{glsacspace} doesn't incorporate the \idx{innerformatting}.)
+
+\cmddef{glsabbrvdefaultfont}
+Abbreviation font command used by styles that don't have specific
+font markup (for example, \abbrstyle{long-short} but not
+\abbrstyle{long-em-short-em}). This just does its argument.
+
+\cmddef{glsfirstabbrvdefaultfont}
+\Idx{firstuse} abbreviation font command used by styles that don't have specific
+font markup. This is defined to just use \gls{glsabbrvdefaultfont}.
+
+\cmddef{glsxtrdefaultrevert}
+This is the default definition of \gls{glsxtrrevert} used by styles
+that don't have specific font markup. If you redefine
+\gls{glsabbrvdefaultfont}, you will need to redefine
+\gls{glsxtrdefaultrevert} as applicable.
+
+\cmddef{glslongdefaultfont}
+Long form font command used by styles that don't have specific
+font markup. This just does its argument.
+
+\cmddef{glsfirstlongdefaultfont}
+\Idx{firstuse} long form font command used by styles that don't have specific
+font markup. This is defined to just use
+\gls{glslongdefaultfont}.
+
+\paragraph{Parenthetical Styles}
+\label{sec:abbrvcmdsparen}These commands apply to the parenthetical
+styles, such as \abbrstyle{long-short}.
+
+\cmddef{glsxtrlongshortname}
+This command should expand to the value of the \gloskey{name} key
+for styles like \abbrstyle{long-short}.
+The default definition is:
+\begin{codebox}
+\gls{glsxpabbrvfont}\marg{\cmd{the}\gls{glsshorttok}}\marg{\gls{glscategorylabel}}
+\end{codebox}
+
+\cmddef{glsxtrlongshortdescsort}
+This command should expand to the sort value used by styles such as
+\abbrstyle{long-short-desc}. The default definition is:
+\begin{codebox}
+\gls+{expandonce}\gls{glsxtrorglong}\cmd{space} (\gls{expandonce}\gls{glsxtrorgshort})
+\end{codebox}
+Note that this uses the original \meta{long} and \meta{short} values
+supplied to \gls{newabbreviation}.
+
+\begin{information}
+This command is irrelevant with the \idx{unsrtfam}.
+\end{information}
+
+\cmddef{glsxtrlongshortdescname}
+This command should expand to the name value used by styles such as
+\abbrstyle{long-short-desc}. The default definition is:
+\begin{codebox}
+\gls{glsxplongfont}\marg{\cmd{the}\gls{glslongtok}}\marg{\gls{glscategorylabel}}\%
+\cmd{protect}\gls{glsxtrfullsep}\marg{\cmd{the}\gls{glslabeltok}}\%
+\cmd{protect}\gls{glsxtrparen}
+ \marg{\gls{glsxpabbrvfont}\marg{\cmd{the}\gls{glsshorttok}}\marg{\gls{glscategorylabel}}}
+\end{codebox}
+This essentially expands to \meta{long} (\meta{short}) but includes the
+style font changing commands, the inner text formatting, and
+accessibility support.
+
+\cmddef{glsxtrshortlongname}
+This command should expand to the value of the \gloskey{name} key
+for styles like \abbrstyle{short-long}.
+The default definition is:
+\begin{codebox}
+\gls{glsxpabbrvfont}\marg{\cmd{the}\gls{glsshorttok}}\marg{\gls{glscategorylabel}}
+\end{codebox}
+
+\cmddef{glsxtrshortlongdescsort}
+This command should expand to the value of the \gloskey{sort} key
+for styles like \abbrstyle{short-long-desc}. The default definition
+is just \code{\gls+{expandonce}\gls{glsxtrorgshort}}.
+
+\begin{information}
+This command is irrelevant with the \idx{unsrtfam}.
+\end{information}
+
+\cmddef{glsxtrshortlongdescname}
+This command should expand to the value of the \gloskey{name} key
+for styles like \abbrstyle{short-long-desc}. The default definition
+is:
+\begin{codebox}
+\gls{glsxpabbrvfont}\marg{\cmd{the}\gls{glsshorttok}}\marg{\gls{glscategorylabel}}\%
+\cmd{protect}\gls{glsxtrfullsep}\marg{\cmd{the}\gls{glslabeltok}}\%
+\cmd{protect}\gls{glsxtrparen}
+ {\gls{glsxplongfont}\marg{\cmd{the}\gls{glslongtok}}\marg{\gls{glscategorylabel}}}
+\end{codebox}
+
+\paragraph{User Styles}
+\label{sec:abbrvcmdsuser}These commands apply to the \qt{user}
+styles, such as \abbrstyle{long-short-user}.
+
+\cmddef{glsxtruserfield}
+This command should expand to the \idxc{internalfieldlabel}{internal
+label} of the field used to store the additional information that
+should be shown in the parenthetical material on \idx{firstuse}. The
+default is \code{useri}, which corresponds to the \gloskey{user1}
+key.
+
+\cmddef{glsxtruserparensep}
+The separator used within the parenthetical content. This defaults
+to a comma followed by a space.
+
+\cmddef{glsxtruserfieldfmt}
+Used to encapsulate the value of the field given by
+\gls{glsxtruserfield} within \gls{glsxtruserparen} and
+\gls{GLSxtruserparen}. This simply does its argument by default.
+
+The \idx{innerformatting} with both \gls{glsxtruserparen} and
+\gls{GLSxtruserparen}, and the case-change with the latter, will be
+included in the argument of \gls{glsxtruserfieldfmt}.
+
+For example, to emphasize the user value and separate it with a
+semi-colon instead of a comma:
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{glsxtruserparensep}}\marg{; }
+\cmd{renewcommand}\marg{\gls{glsxtruserfieldfmt}}[1]\marg{\cmd{emph}\marg{\#1}}
+\end{codebox}
+
+\cmddef{glsabbrvuserfont}
+Formatting for the \qt{user} short form. This defaults to
+\gls{glsabbrvdefaultfont}.
+
+\cmddef{glsfirstabbrvuserfont}
+Formatting for the \qt{user} short form shown on \idx{firstuse}.
+This defaults to \gls{glsabbrvuserfont}.
+
+\cmddef{glsxtrusersuffix}
+Short plural suffix used by the \qt{user} styles. This defaults to
+\gls{glsxtrabbrvpluralsuffix}.
+
+\cmddef{glslonguserfont}
+Formatting for the \qt{user} long form. This defaults to
+\gls{glsabbrvdefaultfont}.
+
+\cmddef{glsfirstlonguserfont}
+Formatting for the \qt{user} short form shown on \idx{firstuse}.
+This defaults to \gls{glslonguserfont}.
+
+\cmddef{glsabbrvscuserfont}
+Formatting for the \qt{sc-user} short form. This uses
+\gls{glsabbrvscfont}, which in turn uses \gls{textsc} to
+apply a \idx{smallcaps} style, so your document font needs to
+support it.
+
+\begin{information}
+\gls{textsc} uses small capital glyphs for \idx{lowercase}
+characters. \Idx{uppercase} characters show as normal capitals.
+This means that you need to use \idx{lowercase} characters in the
+abbreviation.
+\end{information}
+
+\cmddef{glsfirstabbrvscuserfont}
+Formatting for the \qt{sc-user} short form shown on \idx{firstuse}.
+This defaults to \gls{glsabbrvscuserfont}.
+
+\cmddef{glsxtrscuserrevert}
+Counteracts the effect of \gls{glsabbrvscuserfont}. The default is
+\gls{glsxtrscrevert}. If you redefine \gls{glsabbrvscuserfont}, you
+will need to redefine \gls{glsxtrscuserrevert} as applicable.
+
+\cmddef{glsxtrscusersuffix}
+Short plural suffix used by the \qt{sc-user} styles. This defaults to
+\gls{glsxtrscsuffix}.
+
+\cmddef{glsuserdescription}
+The description field is set to this, where the \meta{text} argument
+is the long form, for the \qt{user} styles where the description is
+set by default. This is defined to ignore its second argument:
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glsuserdescription}}[2]\marg{\gls{glslonguserfont}\marg{\#1}}
+\end{codebox}
+If you want to include the information contained in the field
+identified by \gls{glsxtruserfield}, the second argument provides a
+way of accessing that field without relying on the \gls{glscurrententrylabel}
+placeholder. For example:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glsuserdescription}}[2]\marg{\%
+ \gls{glslonguserfont}\marg{\#1}\%
+ \gls{ifglshasfield}\marg{\gls{glsxtruserfield}}\marg{\#2}\%
+ \marg{, \gls{glscurrentfieldvalue}}\%
+ \marg{}\%
+}
+\end{codebox}
+
+\cmddef{glsxtruserparen}
+If the field given by \gls{glsxtruserfield} has been set, this
+essentially does:
+\begin{compactcodebox}
+\gls{glsxtrfullsep}\margm{entry-label}\gls{glsxtrparen}\marg{\meta{text}, \meta{user-value}}
+\end{compactcodebox}
+otherwise it does:
+\begin{compactcodebox}
+\gls{glsxtrfullsep}\margm{entry-label}\gls{glsxtrparen}\marg{\meta{text}}
+\end{compactcodebox}
+It's a little more complicated than this as the definition includes
+the \idx{innerformatting} around the comma and the field value
+(\meta{user-value}). The comma separator is given by
+\gls{glsxtruserparensep}, and the field value is encapsulated with
+\gls{glsxtruserfieldfmt} (with the \idx{innerformatting} inside).
+
+If you redefine this command, you will also need to redefine the
+following one in a similar manner.
+
+\cmddef{GLSxtruserparen}
+As above but the content of the field given by \gls{glsxtruserfield}
+is converted to \idx{allcaps}. Note that simply applying an
+\idx{uppercase} command to \gls{glsxtruserparen} can fail as
+it can cause the label to be converted to \idx{allcaps}, which
+is the reason why a separate command to internally perform the
+case-change is provided.
+
+\cmddef{glsxtrlongshortuserdescname}
+Expands to the value for the \gloskey{name} key for styles like
+\abbrstyle{long-short-user-desc}. The default definition is:
+\begin{codebox}
+\cmd{protect}\gls{glslonguserfont}\marg{\cmd{the}\gls{glslongtok}}\%
+\cmd{protect}\gls{glsxtruserparen}
+\marg{\cmd{protect}\gls{glsabbrvuserfont}\marg{\cmd{the}\gls{glsshorttok}}}\marg{\cmd{the}\gls{glslabeltok}}
+\end{codebox}
+
+\cmddef{glsxtrlongshortscusername}
+Expands to the value for the \gloskey{name} key for styles like
+\abbrstyle{long-postshort-sc-user} styles where the
+description is automatically set. The default
+definition is:
+\begin{codebox}
+\cmd{protect}\gls{glsabbrvscuserfont}\marg{\cmd{the}\gls{glsshorttok}}
+\end{codebox}
+
+\cmddef{glsxtrlongshortscuserdescname}
+Expands to the value for the \gloskey{name} key for styles like
+\abbrstyle{long-postshort-sc-user-desc}. The default definition is:
+\begin{codebox}
+\cmd{protect}\gls{glslonguserfont}\marg{\cmd{the}\gls{glslongtok}}\%
+\cmd{protect}\gls{glsxtruserparen}
+\marg{\cmd{protect}\gls{glsabbrvscuserfont}\marg{\cmd{the}\gls{glsshorttok}}}\marg{\cmd{the}\gls{glslabeltok}}
+\end{codebox}
+
+\cmddef{glsxtrshortlonguserdescname}
+Expands to the value for the \gloskey{name} key for styles like
+\abbrstyle{short-long-user-desc}. The default definition is:
+\begin{codebox}
+\cmd{protect}\gls{glsabbrvuserfont}\marg{\cmd{the}\gls{glsshorttok}}\%
+\cmd{protect}\gls{glsxtruserparen}
+ \marg{\cmd{protect}\gls{glslonguserfont}\marg{\cmd{the}\gls{glslongpltok}}}\%
+ \marg{\cmd{the}\gls{glslabeltok}}
+\end{codebox}
+
+\cmddef{glsxtruserlongshortformat}
+This command is used on the \idx{firstuse} of \gls{gls}
+or with \gls{glsxtrfull} by styles like
+\abbrstyle{long-short-user} to format the long form followed by the
+short form (with optional user information) in parentheses. The
+default definition is:
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glsxtruserlongshortformat}}[4]\marg{\%
+ \gls{glsxtrlongformat}\marg{\#1}\marg{\#2}\marg{\#3}\%
+ \gls{glsxtrusershortformat}\marg{\#1}\marg{\#4}\%
+}
+\end{codebox}
+
+\cmddef{Glsxtruserlongshortformat}
+As above but for \idx{sentencecase}.
+
+\cmddef{GLSxtruserlongshortformat}
+As above but for \idx{allcaps}.
+
+\cmddef{glsxtruserlongshortplformat}
+This command is used on the \idx{firstuse} of \gls{glspl}
+or with \gls{glsxtrfullpl} by styles like
+\abbrstyle{long-short-user} to format the plural long form followed by the
+plural short form (with optional user information) in parentheses. The
+default definition is:
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glsxtruserlongshortplformat}}[4]\marg{\%
+ \gls{glsxtrlongplformat}\marg{\#1}\marg{\#2}\marg{\#3}\%
+ \gls{glsxtrusershortplformat}\marg{\#1}\marg{\#4}\%
+}
+\end{codebox}
+
+\cmddef{Glsxtruserlongshortplformat}
+As above but for \idx{sentencecase}.
+
+\cmddef{GLSxtruserlongshortplformat}
+As above but for \idx{allcaps}.
+
+\cmddef{glsxtrusershortlongformat}
+This command is used on the \idx{firstuse} of \gls{gls}
+or with \gls{glsxtrfull} by styles like
+\abbrstyle{short-long-user} to format the short form followed by the
+long form (with optional user information) in parentheses. The
+default definition is:
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glsxtrusershortlongformat}}[4]\marg{\%
+ \gls{glsxtrshortformat}\marg{\#1}\marg{\#2}\marg{\#3}\%
+ \gls{glsxtruserlongformat}\marg{\#1}\marg{\#4}\%
+}
+\end{codebox}
+
+\cmddef{Glsxtrusershortlongformat}
+As above but for \idx{sentencecase}.
+
+\cmddef{GLSxtrusershortlongformat}
+As above but for \idx{allcaps}.
+
+\cmddef{glsxtrusershortlongplformat}
+This command is used on the \idx{firstuse} of \gls{glspl}
+or with \gls{glsxtrfullpl} by styles like
+\abbrstyle{short-long-user} to format the plural short form followed by the
+plural long form (with optional user information) in parentheses. The
+default definition is:
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glsxtrusershortlongplformat}}[4]\marg{\%
+ \gls{glsxtrshortplformat}\marg{\#1}\marg{\#2}\marg{\#3}\%
+ \gls{glsxtruserlongplformat}\marg{\#1}\marg{\#4}\%
}
+\end{codebox}
-\renewcommand{\glsxtrbookindexsubbetween}[2]{%
- \glsxtrbookindexsubatendgroup{#1}%
+\cmddef{Glsxtrusershortlongplformat}
+As above but for \idx{sentencecase}.
+
+\cmddef{GLSxtrusershortlongplformat}
+As above but for \idx{allcaps}.
+
+
+\cmddef{glsxtrusershortformat}
+Used to format the singular short form in parentheses (with
+\gls{glsxtruserparen}) on the \idx{firstuse} of \gls{gls} or
+\gls{Gls} or with \gls{glsxtrfull} or \gls{Glsxtrfull} for styles like
+\abbrstyle{long-short-user}. The default definition is:
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glsxtrusershortformat}}[2]\marg{\%
+ \gls{glsxtruserparen}\marg{\gls{glsxtrshortformat}\marg{\#1}\marg{}\marg{\#2}}\marg{\#1}\%
+}
+\end{codebox}
+
+\cmddef{glsxtrusershortplformat}
+As \gls{glsxtrusershortformat} but for the \idx{firstuse} of
+\gls{glspl} or with \gls{glsxtrfull} for styles like
+\abbrstyle{long-short-user}. This has a similar definition
+to the above but with \gls{glsxtrshortplformat}.
+
+\cmddef{GLSxtrusershortformat}
+As \gls{glsxtrusershortformat} but is used with the \idx{allcaps}
+\gls{GLS} or \gls{GLSxtrfull}. This uses \gls{GLSxtruserparen}
+instead of \gls{glsxtruserparen}.
+
+\cmddef{GLSxtrusershortplformat}
+As \gls{glsxtrusershortplformat} but is used with the \idx{allcaps}
+\gls{GLSpl} or \gls{GLSxtrfullpl}. This uses \gls{GLSxtruserparen}
+instead of \gls{glsxtruserparen}.
+
+\cmddef{glsxtrpostusershortformat}
+Used in the \idx{postlinkhook} to format the short form in
+parentheses for styles like \abbrstyle{long-postshort-user}. The default
+definition is:
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glsxtrpostusershortformat}}[2]\marg{\%
+ \gls{glsxtrifallcaps}
+ \marg{\gls{GLSxtrusershortformat}\marg{\#1}\marg{\#2}}\%
+ \marg{\gls{glsxtrusershortformat}\marg{\#1}\marg{\#2}}\%
+}
+\end{codebox}
+Note that this doesn't check if the plural form was used. If you
+require this, you will need to redefined this command to include
+\gls{glsifplural}:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glsxtrpostusershortformat}}[2]\marg{\%
+ \gls{glsifplural}
+ \marg{\%
+ \gls{glsxtrifallcaps}
+ \marg{\gls{GLSxtrusershortplformat}\marg{\#1}\marg{\#2}}\%
+ \marg{\gls{glsxtrusershortplformat}\marg{\#1}\marg{\#2}}\%
+ }\%
+ \marg{\%
+ \gls{glsxtrifallcaps}
+ \marg{\gls{GLSxtrusershortformat}\marg{\#1}\marg{\#2}}\%
+ \marg{\gls{glsxtrusershortformat}\marg{\#1}\marg{\#2}}\%
+ }\%
+}
+\end{codebox}
+
+\cmddef{glsxtruserlongformat}
+Used to format the singular long form in parentheses (with
+\gls{glsxtruserparen}) on the \idx{firstuse} of \gls{gls} or
+\gls{Gls} or with \gls{glsxtrfull} for styles like
+\abbrstyle{short-long-user}. The default definition is:
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glsxtruserlongformat}}[2]\marg{\%
+ \gls{glsxtruserparen}\marg{\gls{glsxtrlongformat}\marg{\#1}\marg{}\marg{\#2}}\marg{\#1}\%
+}
+\end{codebox}
+
+\cmddef{GLSxtruserlongformat}
+As \gls{glsxtruserlongformat} but \idx{allcaps}. This uses \gls{GLSxtruserparen}
+instead of \gls{glsxtruserparen}.
+
+\cmddef{glsxtruserlongplformat}
+As \gls{glsxtruserlongformat} but for the \idx{firstuse} of
+\gls{glspl} or with \gls{glsxtrfull} for styles like
+\abbrstyle{short-long-user}. This has a similar definition
+to \gls{glsxtruserlongformat} but with \gls{glsxtrlongplformat}.
+
+\cmddef{GLSxtruserlongplformat}
+As \gls{glsxtruserlongplformat} but \idx{allcaps}. This uses \gls{GLSxtruserparen}
+instead of \gls{glsxtruserparen}.
+
+\cmddef{glsxtrpostuserlongformat}
+Used in the \idx{postlinkhook} to format the long form in
+parentheses for styles like \abbrstyle{short-postlong-user}. The default
+definition is:
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glsxtrpostuserlongformat}}[2]\marg{\%
+ \gls{glsxtrifallcaps}
+ \marg{\gls{GLSxtruserlongformat}\marg{\#1}\marg{\#2}}\%
+ \marg{\gls{glsxtruserlongformat}\marg{\#1}\marg{\#2}}\%
}
+\end{codebox}
+Note that, as with \gls{glsxtrpostusershortformat}, this doesn't
+check if the plural form was used. If you require this, you will
+need to redefined this command to include \gls{glsifplural}.
-\renewcommand{\glsxtrbookindexsubsubatendgroup}[1]{%
- \glsxtrifhasfield{seealso}{#1}%
- {\glstreeitem\hspace*{40pt}\glsxtruseseealso{#1}}{}%
+\paragraph{Footnote Styles}
+\label{sec:abbrvcmdsfootnote}These commands are only used by the footnote styles.
+
+\cmddef{glsxtrfootnotename}
+This command should expand to the value of the \gloskey{name} key.
+The default definition is:
+\begin{codebox}
+\gls{glsxpabbrvfont}\marg{\cmd{the}\gls{glsshorttok}}\marg{\gls{glscategorylabel}}
+\end{codebox}
+
+\cmddef{glsxtrfootnotedescname}
+This command should expand to the value of the \gloskey{name} key
+for styles like \abbrstyle{footnote-desc}.
+The default definition is:
+\begin{codebox}
+\gls{glsxpabbrvfont}\marg{\cmd{the}\gls{glsshorttok}}\marg{\gls{glscategorylabel}}\%
+\cmd{protect}\gls{glsxtrfullsep}\marg{\cmd{the}\gls{glslabeltok}}\%
+\cmd{protect}\gls{glsxtrparen}
+ \marg{\gls{glsxplongfont}\marg{\cmd{the}\gls{glslongtok}}\marg{\gls{glscategorylabel}}}\%
+\end{codebox}
+
+\cmddef{glsxtrfootnotedescsort}
+This command should expand to the value of the \gloskey{sort} key
+for styles like \abbrstyle{footnote-desc}.
+The default definition is simply \code{\cmd{the}\gls{glsshorttok}}.
+
+\begin{information}
+This command is irrelevant with the \idx{unsrtfam}.
+\end{information}
+
+\cmddef{glslongfootnotefont}
+The formatting command used for the long form in the footnote
+styles. The default is to simply use \gls{glslongdefaultfont}.
+
+\cmddef{glsfirstlongfootnotefont}
+The formatting command used for the \idx{firstuse} long form in the footnote
+styles. The default is to simply use \gls{glslongfootnotefont}.
+
+\cmddef{glsxtrabbrvfootnote}
+The command that produces the footnote. The default definition
+ignores the first argument:
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glsxtrabbrvfootnote}}[2]\marg{\gls{footnote}\marg{\#2}}
+\end{codebox}
+
+
+\cmddef{glsxtrfootnotelongformat}
+This command is used within the footnote to display the long form
+formatted with \meta{fmt-cs} for the footnote styles on
+\idx{firstuse} of \gls{gls}, \gls{Gls} and \gls{GLS}. The default definition is simply:
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glsxtrfootnotelongformat}}[2]\marg{\%
+ \gls{glsxtrlongformat}\marg{\#1}\marg{}\marg{\#2}\%
}
+\end{codebox}
+For example, if the footnote should start with an \idx{uppercase}
+letter then simply redefine this to use \gls{Glsxtrlongformat}
+instead:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glsxtrfootnotelongformat}}[2]\marg{\%
+ \gls{Glsxtrlongformat}\marg{\#1}\marg{}\marg{\#2}\%
+}
+\end{codebox}
-\renewcommand{\glsxtrbookindexsubsubbetween}[2]{%
- \glsxtrbookindexsubsubatendgroup{#1}%
+\cmddef{glsxtrfootnotelongplformat}
+This command is used within the footnote to display the plural long form
+formatted with \meta{fmt-cs} for the footnote styles on
+\idx{firstuse} of \gls{glspl}, \gls{Glspl} and \gls{GLSpl}.
+The default definition is simply:
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glsxtrfootnotelongplformat}}[2]\marg{\%
+ \gls{glsxtrlongplformat}\marg{\#1}\marg{}\marg{\#2}\%
}
-\end{verbatim}
-This uses \cs{glstreesubitem} and \cs{glstreesubsubitem}
-to indent the cross-reference according to the next level down,
-so the cross-reference for a top-level entry is aligned with
-the sub-entries, and a level~1 entry has its cross-reference
-aligned with sub-sub-entries. In the event that a level~2
-entry has a cross-reference, this is indented a bit further
-(but it won't be aligned with any deeper level as the
-\glostyle{bookindex} style only supports a maximum of two
-sub-levels).
+\end{codebox}
-The \glostyle{bookindex} style uses group headings. (If you
-use \gls{bib2gls} remember to invoke it with the \verb|--group|
-or \verb|-g| switch.) The heading will use
-\begin{definition}[\DescribeMacro\glsxtrbookindexbookmark]
-\cs{glsxtrbookindexbookmark}\marg{group title}\marg{name}
-\end{definition}
-If \cs{pdfbookmark} has been defined, this will
-use that command to bookmark the group title. If
-\pkgopt[chapter]{section} is set (default if chapters are defined)
-then this uses level~1 otherwise it uses level~2. You can
-redefine this command if this isn't appropriate.
-If \cs{pdfbookmark} hasn't been defined, this command does nothin.
-
-The group heading is formatted according to
-\begin{definition}[\DescribeMacro\glsxtrbookindexformatheader]
-\cs{glsxtrbookindexformatheader}\marg{group title}
-\end{definition}
-which is defined as
-\begin{verbatim}
-\newcommand*{\glsxtrbookindexformatheader}[1]{%
- \par{\centering\glstreegroupheaderfmt{#1}\par}%
-}
-\end{verbatim}
-where \cs{glstreegroupheaderfmt} is provided by the
-\sty{glossary-tree} package, which is automatically loaded.
-Note that the entry names aren't encapsulated with
-\cs{glstreenamefmt}.
+\cmddef{glsxtrpostfootnotelongformat}
+This command is used for the \qt{postfootnote} styles. This is
+simply defined to do \gls{glsxtrfootnotelongformat}. Note that
+there's no plural equivalent as the \qt{postfootnote} styles don't
+check if the plural command (\gls{glspl} etc) was used.
-The \sty{glossary-bookindex} package provides some supplementary
-commands that aren't used by default, but may be used when
-adjusting the style. These commands should only be
-used within one of the \cs{print\ldots glossary} commands.
-(That is, they should only be used in glossary styles.)
-\begin{definition}[\DescribeMacro\glsxtrbookindexmarkentry]
-\cs{glsxtrbookindexmarkentry}\marg{label}
-\end{definition}
-This writes information to the \texttt{.aux} file that
-can be read on the next run to obtain the first and last entry on
-each page of the glossary.
+\paragraph{No-Long Styles}
+\label{sec:abbrvcmdsnolong}These commands are used by the
+\qt{nolong} styles.
-You can display the first entry
-associated with the current page using:
-\begin{definition}[\DescribeMacro\glsxtrbookindexfirstmark]
-\cs{glsxtrbookindexfirstmark}
-\end{definition}
-and the last entry associated with the current page
-using:
-\begin{definition}[\DescribeMacro\glsxtrbookindexlastmark]
-\cs{glsxtrbookindexlastmark}
-\end{definition}
-These do nothing if there are no entries marked on the current page
-(or if the document build isn't up to date).
+\cmddef{glsxtrshortnolongname}
+This command should expand to the value of the \gloskey{name} key
+for styles like \abbrstyle{short-nolong}.
+The default definition is:
+\begin{codebox}
+\gls{glsxpabbrvfont}\marg{\cmd{the}\gls{glsshorttok}}\marg{\gls{glscategorylabel}}
+\end{codebox}
-The entry is formatted using:
-\begin{definition}[\DescribeMacro\glsxtrbookindexfirstmarkfmt]
-\cs{glsxtrbookindexfirstmarkfmt}\marg{label}
-\end{definition}
-for the first instance and
-\begin{definition}[\DescribeMacro\glsxtrbookindexlastmarkfmt]
-\cs{glsxtrbookindexlastmarkfmt}\marg{label}
-\end{definition}
-for the last.
+\cmddef{glsxtrshortdescname}
+This command should expand to the value of the \gloskey{name} key
+for styles like \abbrstyle{short-nolong-desc}.
+The default definition is:
+\begin{codebox}
+\gls{glsxpabbrvfont}\marg{\cmd{the}\gls{glsshorttok}}\marg{\gls{glscategorylabel}}\%
+\cmd{protect}\gls{glsxtrfullsep}\marg{\cmd{the}\gls{glslabeltok}}\%
+\cmd{protect}\gls{glsxtrparen}
+ \marg{\gls{glsxplongfont}\marg{\cmd{the}\gls{glslongtok}}\marg{\gls{glscategorylabel}}}\%
+\end{codebox}
+
+\paragraph{No-Short Styles}
+\label{sec:abbrvcmdsnoshort}These commands are used by the
+\qt{noshort} styles.
-These commands are designed for use in page headers or footers
-where the page number is stable. For example, \cs{glsxtrbookindexname}
-can be redefined to mark the current entry:
-\begin{verbatim}
-\renewcommand{\glsxtrbookindexname}[1]{%
- \glsxtrbookindexmarkentry{#1}%
- \glossentryname{#1}%
+\cmddef{glsxtrlongnoshortdescname}
+This command should expand to the value of the \gloskey{name} key
+for styles like \abbrstyle{long-noshort-desc}.
+The default definition is:
+\begin{codebox}
+\gls{glsxplongfont}\marg{\cmd{the}\gls{glslongtok}}\marg{\gls{glscategorylabel}}
+\end{codebox}
+
+\cmddef{glsxtrlongnoshortname}
+This command should expand to the value of the \gloskey{name} key
+for styles like \abbrstyle{long-noshort}.
+The default definition is:
+\begin{codebox}
+\gls{glsxpabbrvfont}\marg{\cmd{the}\gls{glsshorttok}}\marg{\gls{glscategorylabel}}
+\end{codebox}
+
+\paragraph{Hyphen Styles}
+\label{sec:abbrvcmdshyphen}These are commands used by the \qt{hyphen}
+styles. They are designed to work with the \catattr{markwords}
+and \catattr{markshortwords} attributes.
+
+\cmddef{glsabbrvhyphenfont}
+The formatting command used for the short form in the hyphen
+styles. The default is to simply use \gls{glsabbrvdefaultfont}.
+
+\cmddef{glsfirstabbrvhyphenfont}
+The formatting command used for the short form in the hyphen
+styles on \idx{firstuse}. The default is to simply use
+\gls{glsabbrvhyphenfont}.
+
+\cmddef{glslonghyphenfont}
+The formatting command used for the long form in the hyphen
+styles. The default is to simply use \gls{glslongdefaultfont}.
+
+\cmddef{glsfirstlonghyphenfont}
+The formatting command used for the long form in the hyphen
+styles on \idx{firstuse}. The default is to simply use
+\gls{glslonghyphenfont}.
+
+\cmddef{glsxtrhyphensuffix}
+Short plural suffix used by the \qt{hyphen} styles. This defaults to
+\gls{glsxtrabbrvpluralsuffix}.
+
+\cmddef{glsxtrlonghyphenshortsort}
+Expands to the sort value for the styles like \abbrstyle{long-hyphen-short-hyphen}.
+This defaults to the original short value (\gls{glsxtrorgshort}).
+This command is irrelevant with the \idx{unsrtfam}.
+
+\cmddef{glsxtrshorthyphenlongsort}
+Expands to the sort value for the styles like \abbrstyle{short-hyphen-long-hyphen}.
+This defaults to the original short value (\gls{glsxtrorgshort}).
+This command is irrelevant with the \idx{unsrtfam}.
+
+\cmddef{glsxtrlonghyphennoshortsort}
+Expands to the sort value for the styles like
+\abbrstyle{long-hyphen-noshort-noreg}.
+This defaults to the original short value (\gls{glsxtrorgshort}).
+This command is irrelevant with the \idx{unsrtfam}.
+
+\cmddef{glsxtrlonghyphennoshortdescsort}
+Expands to the sort value for the styles like
+\abbrstyle{long-hyphen-noshort-desc-noreg}.
+This defaults to the original long value (\gls{glsxtrorglong}).
+This command is irrelevant with the \idx{unsrtfam}.
+
+\cmddef{glsxtrlonghyphenshort}
+Formats the long and short form for the full or \idx{firstuse}
+\abbrstyle{long-hyphen-short-hyphen} style. This uses
+\gls{glsxtrifhyphenstart} to test if the \meta{insert} starts with a
+hyphen. If it does, \gls{glsxtrwordsep} is locally set to
+\gls{glsxtrwordsephyphen} to replace the inter-word spaces with
+hyphens. The short form is placed in parentheses with
+\gls{glsxtrparen}, preceded by the \gls{glsxtrfullsep} separator.
+The \meta{insert} is placed after both the long and the short form.
+
+\cmddef{GLSxtrlonghyphenshort}
+As above, but the \meta{insert} is converted to \idx{allcaps}. The
+\meta{short} and \meta{long} arguments should be supplied as
+\idx{allcaps}. Note that it's not possible to simply do
+\gls{glsxtrlonghyphenshort} with
+\code{\gls{MakeUppercase}\margm{insert}} as the argument as this
+will interfere with the check to determine if \meta{insert} starts
+with a hyphen.
+
+\cmddef{glsxtrlonghyphennoshort}
+Formats the long form for the full or \idx{firstuse}
+\abbrstyle{long-hyphen-noshort-desc-noreg} style. This uses
+\gls{glsxtrifhyphenstart} to test if the \meta{insert} starts with a
+hyphen. If it does, \gls{glsxtrwordsep} is locally set to
+\gls{glsxtrwordsephyphen} to replace the inter-word spaces with
+hyphens. The \meta{insert} is placed after the long form.
+
+\cmddef{GLSxtrlonghyphennoshort}
+As above but converts \meta{insert} to \idx{allcaps}. The
+\meta{long} argument should already be in \idx{allcaps}.
+ Note that it's not possible to simply do
+\gls{glsxtrlonghyphennoshort} with
+\code{\gls{MakeUppercase}\margm{insert}} as the argument as this
+will interfere with the check to determine if \meta{insert} starts
+with a hyphen.
+
+\cmddef{glsxtrlonghyphen}
+Formats the long form for the full or \idx{firstuse}
+\abbrstyle{long-hyphen-postshort-hyphen} style. This is similar to
+the above, but the \meta{insert} argument is only used to check if
+it starts with a hyphen. The actual \meta{insert} is placed in the
+\idx{postlinkhook}.
+
+\cmddef{xpglsxtrposthyphenshort}
+This command is used in the \idx{postlinkhook} for the
+\abbrstyle{long-hyphen-postshort-hyphen} style on \idx{firstuse}.
+It expands the placeholder commands (\gls{glslabel} and \gls{glsinsert})
+and uses \gls{GLSxtrposthyphenshort} for \idx{allcaps} or
+\gls{glsxtrposthyphenshort} otherwise. Note that this doesn't show
+the plural by default. If you require the plural form, you need to
+redefine this to add a check with \gls{glsifplural}:
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{xpglsxtrposthyphenshort}}\marg{\%
+ \gls{glsifplural}
+ \marg{\%
+ \gls{glsxtrifallcaps}
+ \marg{\%
+ \gls{expandafter}\gls{GLSxtrposthyphenshortpl}\gls{expandafter}\gls{glslabel}
+ \gls{expandafter}\marg{\gls{glsinsert}}\%
+ }\%
+ \marg{\%
+ \gls{expandafter}\gls{glsxtrposthyphenshortpl}\gls{expandafter}\gls{glslabel}
+ \gls{expandafter}\marg{\gls{glsinsert}}\%
+ }\%
+ }\%
+ \marg{\%
+ \gls{glsxtrifallcaps}
+ \marg{\%
+ \gls{expandafter}\gls{GLSxtrposthyphenshort}\gls{expandafter}\gls{glslabel}
+ \gls{expandafter}\marg{\gls{glsinsert}}\%
+ }\%
+ \marg{\%
+ \gls{expandafter}\gls{glsxtrposthyphenshort}\gls{expandafter}\gls{glslabel}
+ \gls{expandafter}\marg{\gls{glsinsert}}\%
+ }\%
+ }\%
}
-\end{verbatim}
-If you only want to mark the top-level entries, remember
-to redefine \cs{glsxtrbookindexsubname} as it defaults
-to \cs{glsxtrbookindexname}:
-\begin{verbatim}
-\renewcommand{\glsxtrbookindexsubname}[1]{%
- \glossentryname{#1}%
+\end{codebox}
+
+\cmddef{glsxtrposthyphenshort}
+If \meta{insert} starts with a hyphen, \gls{glsxtrwordsep} is locally set to
+\gls{glsxtrwordsephyphen} to replace the inter-word spaces with
+hyphens. The \meta{insert} encapsulated with
+\gls{glsfirstlonghyphenfont} is then done (to complete the long
+form, which has already been displayed with \gls{glsxtrlonghyphen}
+in the \idx{linktext}). Then the short form followed by the
+\meta{insert} is placed in parentheses (with \gls{glsxtrparen}
+preceded by \gls{glsxtrfullsep}).
+
+\cmddef{GLSxtrposthyphenshort}
+As above but \idx{allcaps}.
+
+\cmddef{glsxtrposthyphenshortpl}
+As \gls{glsxtrposthyphenshort} but plural.
+
+\cmddef{GLSxtrposthyphenshortpl}
+As above but \idx{allcaps}.
+
+\cmddef{xpglsxtrposthyphensubsequent}
+This command is used in the \idx{postlinkhook} for the
+\abbrstyle{long-hyphen-postshort-hyphen} style on \idx{subsequentuse}.
+It expands the placeholder commands (\gls{glslabel} and \gls{glsinsert})
+and uses \gls{GLSxtrposthyphensubsequent} for \idx{allcaps} or
+\gls{glsxtrposthyphensubsequent} otherwise.
+
+\cmddef{glsxtrposthyphensubsequent}
+This command is used in the \idx{postlinkhook} for the
+\abbrstyle{long-hyphen-postshort-hyphen} style on \idx{subsequentuse}.
+Only the \meta{insert} is done.
+
+\cmddef{GLSxtrposthyphensubsequent}
+As above but \idx{allcaps}.
+
+\cmddef{glsxtrshorthyphenlong}
+Formats the short and long form for the full or \idx{firstuse}
+\abbrstyle{short-hyphen-long-hyphen} style. Similar to
+\gls{glsxtrlonghyphenshort} but the short and long forms are
+swapped.
+
+\cmddef{GLSxtrshorthyphenlong}
+As above, but the \meta{insert} is converted to \idx{allcaps}. The
+\meta{short} and \meta{long} arguments should be supplied as
+\idx{allcaps}. Note that it's not possible to simply do
+\gls{glsxtrshorthyphenlong} with
+\code{\gls{MakeUppercase}\margm{insert}} as the argument as this
+will interfere with the check to determine if \meta{insert} starts
+with a hyphen.
+
+\cmddef{glsxtrshorthyphen}
+Formats the short form for the full or \idx{firstuse}
+\abbrstyle{short-hyphen-postlong-hyphen} style. The \meta{insert}
+argument is only used to check if it starts with a hyphen. The
+actual \meta{insert} is placed in the \idx{postlinkhook}.
+
+\cmddef{xpglsxtrposthyphenlong}
+This command is used in the \idx{postlinkhook} for the
+\abbrstyle{short-hyphen-postlong-hyphen} style on \idx{firstuse}.
+It expands the placeholder commands (\gls{glslabel} and \gls{glsinsert})
+and uses \gls{GLSxtrposthyphenlong} for \idx{allcaps} or
+\gls{glsxtrposthyphenlong} otherwise. Note that this doesn't show
+the plural by default. If you require the plural form, you need to
+redefine this to add a check with \gls{glsifplural}:
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{xpglsxtrposthyphenlong}}\marg{\%
+ \gls{glsifplural}
+ \marg{\%
+ \gls{glsxtrifallcaps}
+ \marg{\%
+ \gls{expandafter}\gls{GLSxtrposthyphenlongpl}\gls{expandafter}\gls{glslabel}
+ \gls{expandafter}\marg{\gls{glsinsert}}\%
+ }\%
+ \marg{\%
+ \gls{expandafter}\gls{glsxtrposthyphenlongpl}\gls{expandafter}\gls{glslabel}
+ \gls{expandafter}\marg{\gls{glsinsert}}\%
+ }\%
+ }\%
+ \marg{\%
+ \gls{glsxtrifallcaps}
+ \marg{\%
+ \gls{expandafter}\gls{GLSxtrposthyphenlong}\gls{expandafter}\gls{glslabel}
+ \gls{expandafter}\marg{\gls{glsinsert}}\%
+ }\%
+ \marg{\%
+ \gls{expandafter}\gls{glsxtrposthyphenlong}\gls{expandafter}\gls{glslabel}
+ \gls{expandafter}\marg{\gls{glsinsert}}\%
+ }\%
+ }\%
}
-\end{verbatim}
+\end{codebox}
+
+\cmddef{glsxtrposthyphenlong}
+This command is used in the \idx{postlinkhook} for the
+\abbrstyle{short-hyphen-postlong-hyphen} style on \idx{firstuse}.
+Similar to \gls{glsxtrposthyphenshort} but shows the long form instead of
+the short form.
+
+\cmddef{GLSxtrposthyphenlong}
+As above but \idx{allcaps}.
+
+\cmddef{glsxtrposthyphenlongpl}
+As \gls{glsxtrposthyphenlong} but plural.
+
+\cmddef{GLSxtrposthyphenlongpl}
+As above but \idx{allcaps}.
+
+\paragraph{Only Styles}
+\label{sec:abbrvcmdsonly}These are commands used by the \qt{only}
+styles, such as \abbrstyle{long-only-short-only}.
+
+\cmddef{glsabbrvonlyfont}
+The formatting command used for the short form in the only
+styles. The default is to simply use \gls{glsabbrvdefaultfont}.
+
+\cmddef{glsfirstabbrvonlyfont}
+The formatting command used for the short form in the only
+styles on \idx{firstuse}. The default is to simply use
+\gls{glsabbrvonlyfont}.
+
+\cmddef{glslongonlyfont}
+The formatting command used for the long form in the only
+styles. The default is to simply use \gls{glslongdefaultfont}.
+
+\cmddef{glsfirstlongonlyfont}
+The formatting command used for the long form in the only
+styles on \idx{firstuse}. The default is to simply use
+\gls{glslongonlyfont}.
+
+\cmddef{glsxtronlysuffix}
+Short plural suffix used by the \qt{only} styles. This defaults to
+\gls{glsxtrabbrvpluralsuffix}.
+
+\cmddef{glsabbrvsconlyfont}
+The formatting command used for the short form in the \qt{sc-only}
+styles. The default is to simply use \gls{glsabbrvscfont}.
+
+\cmddef{glsfirstabbrvsconlyfont}
+The formatting command used for the short form in the \qt{sc-only}
+styles on \idx{firstuse}. The default is to simply use
+\gls{glsabbrvsconlyfont}.
+
+\cmddef{glsxtrsconlyrevert}
+Counteracts the effect of \gls{glsabbrvsconlyfont}. The default is
+\gls{glsxtrscrevert}. If you redefine \gls{glsabbrvsconlyfont}, you
+will need to redefine \gls{glsxtrsconlyrevert} as applicable.
+
+\cmddef{glsxtrsconlysuffix}
+Short plural suffix used by the \qt{sc-only} styles. This defaults to
+\gls{glsxtrscsuffix}.
+
+\cmddef{glsxtronlyname}
+Expands to the value for the \gloskey{name} key for the \qt{only}
+styles. The default definition is:
+\begin{codebox}
+\cmd{protect}\gls{glsabbrvonlyfont}\marg{\cmd{the}\gls{glsshorttok}}
+\end{codebox}
+
+\cmddef{glsxtronlydescname}
+Expands to the value for the \gloskey{name} key for the \qt{only}
+styles where the description should be described, such as
+\abbrstyle{long-only-short-only-desc}. The default definition is:
+\begin{codebox}
+\cmd{protect}\gls{glslongfont}\marg{\cmd{the}\gls{glslongtok}}
+\end{codebox}
+
+\cmddef{glsxtronlydescsort}
+Expands to the value for the \gloskey{sort} key for the \qt{only}
+styles where the description should be described, such as
+\abbrstyle{long-only-short-only-desc}. The default definition is
+\code{\cmd{the}\gls{glslongtok}}.
+
+\begin{information}
+This command is irrelevant with the \idx{unsrtfam}.
+\end{information}
+
+\cmddef{glsxtrsconlyname}
+Expands to the value for the \gloskey{name} key for the \qt{sc-only}
+styles. The default definition is:
+\begin{codebox}
+\cmd{protect}\gls{glsabbrvsconlyfont}\marg{\cmd{the}\gls{glsshorttok}}
+\end{codebox}
+
+\cmddef{glsxtrsconlydescname}
+Expands to the value for the \gloskey{name} key for the \qt{sc-only}
+styles where the description should be described. The default definition is
+to simply use \gls{glsxtronlydescname}.
+
+\cmddef{glsxtrsconlydescsort}
+Expands to the value for the \gloskey{sort} key for the \qt{sc-only}
+styles where the description should be described, such as
+\abbrstyle{long-only-short-only-desc}. The default definition is
+to simply use \gls{glsxtronlydescsort}.
+
+\begin{information}
+This command is irrelevant with the \idx{unsrtfam}.
+\end{information}
+
+\paragraph{Fonts}
+\label{sec:abbrvcmdsfonts}These are commands used by styles that
+use a particular font shape or size, identified by one of the
+following two-letter tags: \qt{sc} (\gls{textsc}), \qt{sm} (\gls{textsmaller})
+or \qt{em} (\gls{emph}).
+
+\begin{information}
+For the \qt{sc-user} styles, see \sectionref{sec:abbrvcmdsuser}.
+For the \qt{sc-only} styles, see \sectionref{sec:abbrvcmdsonly}.
+\end{information}
+
+\cmddef{glsabbrvscfont}
+Formatting for the \qt{sc} short form. This uses \gls{textsc} to
+apply a \idx{smallcaps} style, so your document font needs to
+support it.
+
+\begin{information}
+\gls{textsc} uses small capital glyphs for \idx{lowercase}
+characters. \Idx{uppercase} characters show as normal capitals.
+This means that you need to use \idx{lowercase} characters in the
+abbreviation.
+\end{information}
+
+\cmddef{glsfirstabbrvscfont}
+Formatting for the \qt{sc} short form shown on \idx{firstuse}.
+This defaults to \gls{glsabbrvscfont}.
+
+\cmddef{glsxtrscrevert}
+Counteracts the effect of \gls{glsabbrvscfont}. This defaults to
+\gls{glstextup}. If you redefine \gls{glsabbrvscfont}, you
+will need to redefine \gls{glsxtrscrevert} as applicable.
+
+\cmddef{glsxtrscsuffix}
+Short plural suffix used by the \qt{sc} styles. This needs to
+counteract the smallcaps, so it's defined as:
+\begin{codebox}
+\cmd{protect}\gls{glstextup}{\gls{glsxtrabbrvpluralsuffix}}
+\end{codebox}
+
+\cmddef{glsabbrvsmfont}
+Formatting for the \qt{sm} short form. This uses \gls{textsmaller},
+which is defined by the \sty{relsize} package. You will need to
+load that package if you want to use any of the \qt{sm} styles.
+
+\begin{information}
+\gls{textsmaller} reduces the font size, so if you want to use it to
+simulate \idx{smallcaps}, you need to use \idx{uppercase} characters
+in the abbreviation.
+\end{information}
+
+\cmddef{glsfirstabbrvsmfont}
+Formatting for the \qt{sm} short form shown on \idx{firstuse}.
+This defaults to \gls{glsabbrvsmfont}.
+
+\cmddef{glsxtrsmrevert}
+Counteracts the effect of \gls{glsabbrvsmfont}. This defaults to
+\gls{textlarger}. If you redefine \gls{glsabbrvsmfont}, you
+will need to redefine \gls{glsxtrsmrevert} as applicable.
+
+\cmddef{glsxtrsmsuffix}
+Short plural suffix used by the \qt{sm} styles. This defaults to
+\gls{glsxtrabbrvpluralsuffix}.
+
+\cmddef{glsabbrvemfont}
+Formatting for the \qt{em} short form. This uses \gls{emph}.
+
+\cmddef{glsfirstabbrvemfont}
+Formatting for the \qt{em} short form shown on \idx{firstuse}.
+This defaults to \gls{glsabbrvemfont}.
+
+\cmddef{glsxtremrevert}
+Counteracts the effect of \gls{glsabbrvemfont}. This defaults to
+\gls{textup}. If you redefine \gls{glsabbrvemfont}, you
+will need to redefine \gls{glsxtremrevert} as applicable.
+
+\cmddef{glsxtremsuffix}
+Short plural suffix used by the \qt{em} styles. This defaults to
+\gls{glsxtrabbrvpluralsuffix}.
+
+\cmddef{glslongemfont}
+Formatting for the \qt{em} long form. This uses \gls{emph}.
+
+\cmddef{glsfirstlongemfont}
+Formatting for the \qt{em} short form shown on \idx{firstuse}.
+This defaults to \gls{glslongemfont}.
+
+\subsection{Advanced Style Commands}
+\label{sec:advancedabbrstylecmds}
+
+These commands should typically not be needed in a document, but are
+provided for advanced users. See \sectionref{sec:abbrvcmds}
+for commands to adjust the predefined abbreviation styles.
+
+\cmddef{glssetabbrvfmt}
+Sets the current formatting commands
+(\sectionref{sec:abbrstylefmts}) associated with the abbreviation
+style associated with the given category. That is, the command
+redefinitions provided in the third argument (\meta{display
+definitions}) of \gls{newabbreviationstyle} are applied.
+
+If no abbreviation style has been set for the given category, the
+style associated with the \cat{abbreviation} category is used.
+
+This command is used:
+\begin{itemize}
+\item At the start of \gls{glsentryfmt} if the
+current entry has the \gloskey{short} field set. This ensures that the
+\idx{glslike} commands use the appropriate formatting.
+
+\item At the start of
+\gls{glsxtrassignfieldfont} if the current entry has the
+\gloskey{short} field set. This ensures that the
+\idx{glslike} commands use the appropriate formatting (where
+possible).
+
+\item At the start of \gls{glsxtrshort}, \gls{glsxtrlong}, \gls{glsxtrfull}
+and their plural and case-changing variants.
+
+\item At the start of \gls{glossentryname},
+\gls{glossentrynameother}, \gls{glossentrydesc},
+\gls{Glossentrydesc}, \gls{glossentrysymbol} and \gls{Glossentrysymbol}.
+\end{itemize}
-Then if you're using \sty{fancyhdr} you can set the page style
-to show the first and last entry for the current page with:
-\begin{verbatim}
- \pagestyle{fancy}%
- \lhead{\thepage}%
- \lfoot{\glsxtrbookindexfirstmark}%
- \cfoot{}%
- \rfoot{\glsxtrbookindexlastmark}%
-\end{verbatim}
-
-\section{\headingsty{glossary-longextra} package}
-\label{sec:longextra}
+\cmddef{glsuseabbrvfont}
+A robust command that applies the abbreviation font for the given
+category to the supplied text.
-As from version 1.37, the \styfmt{glossaries-extra} package comes
-with the supplementary package \sty{glossary-longextra} that
-provides additional styles, listed below, that use the
-\env{longtable} environment. If you know that your glossary won't
-span more than a page and you need to use it in a context that's
-incompatible with \env{longtable}, you can instead setup these styles
-to use \env{tabular} instead. In order to do this you must use
-\begin{definition}[\DescribeMacro\GlsLongExtraUseTabulartrue]
-\cs{GlsLongExtraUseTabulartrue}
-\end{definition}
-\emph{before the style is set}. For example:
-\begin{verbatim}
-\GlsLongExtraUseTabulartrue
-\setglossarystyle{long-name-desc}
-\end{verbatim}
-or
-\begin{verbatim}
-\GlsLongExtraUseTabulartrue
-\printunsrtglossary[style={long-name-desc}]
-\end{verbatim}
-If you use this setting, you can change the default vertical
-alignment with:
-\begin{definition}[\DescribeMacro\glslongextraTabularVAlign]
-\cs{glslongextraTabularVAlign}
-\end{definition}
-The default definition is \texttt{c}.
-
-The column titles are formatted according to:
-\begin{definition}[\DescribeMacro\glslongextraHeaderFmt]
-\cs{glslongextraHeaderFmt}\marg{text}
-\end{definition}
-which simply does \cs{textbf}\marg{text} by default.
-
-The name column has the title given by \ics{entryname} and
-the column alignment is given by:
-\begin{definition}[\DescribeMacro\glslongextraNameAlign]
-\cs{glslongextraNameAlign}
-\end{definition}
-which expands to \texttt{l} (left) by default.
-
-The symbol column (where applicable) has the title given by
-\ics{symbolname} and the column alignment is given by:
-\begin{definition}[\DescribeMacro\glslongextraSymbolAlign]
-\cs{glslongextraSymbolAlign}
-\end{definition}
-which expands to \texttt{c} (centred) by default.
-
-The location list column (where applicable) has the title given by
-\ics{pagelistname} and the column alignment is given by:
-\begin{definition}[\DescribeMacro\glslongextraLocationAlign]
-\cs{glslongextraLocationAlign}
-\end{definition}
-which expands to
-\begin{verbatim}
->{\raggedright}p{\glspagelistwidth}
-\end{verbatim}
-by default. (Ragged-right paragraph, \ics{glspagelistwidth} is
-defined in \sty{glossary-long}, which is automatically loaded.)
-
-The description column has the title given by \ics{descriptionname}
-and the column alignment is given by:
-\begin{definition}[\DescribeMacro\glslongextraDescAlign]
-\cs{glslongextraDescAlign}
-\end{definition}
-which expands to
-\begin{verbatim}
->{\raggedright}p{\glsdescwidth}
-\end{verbatim}
-by default. (Ragged-right paragraph, \ics{glsdescwidth} is
-defined in \sty{glossary-long}, which is automatically loaded.)
-
-Unlike the long styles provided by the base \styfmt{glossaries}
-package, these new styles try to determine the value of
-\cs{glsdescwidth} at the start of the glossary according to the
-number of columns provided by the style. The calculations are
-performed by the following commands:
-\begin{definition}[\DescribeMacro\glslongextraSetDescWidth]
-\cs{glslongextraSetDescWidth}
-\end{definition}
-This is used by the styles that have a name and description
-column. The value of \cs{glsdescwidth} is computed as:
-\[
- \cs{glsdescwidth} = \cs{linewidth} - 4\cs{tabcolsep} - W
-\]
-where $W$ is a guess at the width of the name column. This is first
-set to the width of the name column header:
-\begin{alltt}
-\cs{settowidth}\marg{width}\{\cs{glslongextraHeaderFmt}\cs{entryname}\}
-\end{alltt}
-If any names in that column are larger than this, then you need
-to specify the widest name using:
-\begin{definition}[\DescribeMacro\glslongextraSetWidest]
-\cs{glslongextraSetWidest}\marg{widest name}
-\end{definition}
-or
-\begin{definition}[\DescribeMacro\glslongextraUpdateWidest]
-\cs{glslongextraUpdateWidest}\marg{text}
-\end{definition}
-These work like the analogous commands \cs{glssetwidest} and
-\cs{glsupdatewidest} provided with the \glostyle{alttree} style, but
-in this case there's no hierarchy. The default widest name
-is obtained from the \glostyle{alttree} top-level name if set,
-otherwise it's empty, so you can use \gls{bib2gls}['s]
-\texttt{set-widest} option. If you have the entry counter enabled,
-you will need to include this with the name for the extra material to
-be taken into account.
-
-The name isn't shown for child entries by default, but if
-you change this and you want to use \gls{bib2gls}['s]
-\texttt{set-widest} option (for \gls{bib2gls} v1.8+) then you need to
-redefine:
-\begin{definition}[\DescribeMacro\glslongextraUpdateWidestChild]
-\cs{glslongextraUpdateWidestChild}\marg{level}\marg{text}
-\end{definition}
-This does nothing by default, but if you are including the child
-names then you need to redefine this command:
-\begin{verbatim}
-\renewcommand{\glslongextraUpdateWidestChild}[2]{%
- \glslongextraUpdateWidest{#2}%
-}
-\end{verbatim}
-
-If you prefer to set an explicit width for the description
-column then you need to redefine \cs{glslongextraSetDescWidth}. For
-example:
-\begin{verbatim}
-\renewcommand{\glslongextraSetDescWidth}{%
- \setlength{\glsdescwidth}{0.6\linewidth}%
-}
-\end{verbatim}
-
-The styles that have a name, symbol and description,
-\cs{glsdescwidth} is set with:
-\begin{definition}[\DescribeMacro\glslongextraSymSetDescWidth]
-\cs{glslongextraSymSetDescWidth}
-\end{definition}
-This first uses \cs{glslongextraSetDescWidth} and then subtracts
-2\cs{tabcolsep} and the width of the symbol column header from
-\cs{glsdescwidth}. This assumes that the symbol column header
-is larger than any of the symbols. If this isn't appropriate
-then you can redefine this command. For example:
-\begin{verbatim}
-\renewcommand{\glslongextraSymSetDescWidth}{%
- \glslongextraSetDescWidth
- \addtolength{\glsdescwidth}{-3cm}%
-}
-\end{verbatim}
-or
-\begin{verbatim}
-\renewcommand{\glslongextraSymSetDescWidth}{%
- \setlength{\glsdescwidth}{.5\linewidth}%
-}
-\end{verbatim}
-
-For the styles that have a name, description and location column,
-\cs{glsdescwidth} is set using:
-\begin{definition}[\DescribeMacro\glslongextraLocSetDescWidth]
-\cs{glslongextraLocSetDescWidth}
-\end{definition}
-This uses \cs{glslongextraSetDescWidth} and then subtracts
-2\cs{tabcolsep} and \cs{glspagelistwidth} from \cs{glsdescwidth}.
-You can redefine this command to set both \cs{glsdescwidth} and
-\cs{glspagelistwidth} if appropriate.
-
-For the styles that have a name, description, symbol and location
-column, \cs{glsdescwidth} is set using:
-\begin{definition}[\DescribeMacro\glslongextraSymLocSetDescWidth]
-\cs{glslongextraSymLocSetDescWidth}
-\end{definition}
-This uses \cs{glslongextraSymSetDescWidth} and then subtracts
-2\cs{tabcolsep} and \cs{glspagelistwidth} from
-\cs{glsdescwidth}. Again, you can redefine this command
-to explicitly set both lengths.
-
-In all cases, the top-level name is formatted according to:
-\begin{definition}[\DescribeMacro\glslongextraNameFmt]
-\cs{glslongextraNameFmt}\marg{label}
-\end{definition}
-This does
-\begin{alltt}
-\cs{glsentryitem}\marg{label}\cs{glstarget}\marg{label}\{\cs{glossentryname}\marg{label}\}
-\end{alltt}
-which includes the entry counter (if enabled), the target and the post-name link.
-
-The top-level description is formatted according to:
-\begin{definition}[\DescribeMacro\glslongextraDescFmt]
-\cs{glslongextraDescFmt}\marg{label}
-\end{definition}
-This does \cs{glossentrydesc}\marg{label} followed by the
-post-description hook.
-
-The styles that have a symbol column format the symbol using:
-\begin{definition}[\DescribeMacro\glslongextraSymbolFmt]
-\cs{glslongextraSymbolFmt}\marg{label}
-\end{definition}
-This just does \cs{glossentrysymbol}\marg{label}.
-
-The styles that have a location list column format the list using:
-\begin{definition}[\DescribeMacro\glslongextraLocationFmt]
-\cs{glslongextraLocationFmt}\marg{label}\marg{locations}
-\end{definition}
-This just does \meta{locations} and ignores the label.
-
-The child entries have their name formatted according to:
-\begin{definition}[\DescribeMacro\glslongextraSubNameFmt]
-\cs{glslongextraSubNameFmt}\marg{level}\marg{label}
-\end{definition}
-where \meta{level} is the hierarchical level. This defaults to:
-\begin{alltt}
-\cs{glssubentryitem}\marg{label}\cs{glstarget}\marg{label}\{\cs{strut}\}
-\end{alltt}
-This includes the sub-entry counter (if enabled) and the target
-but doesn't show the name. The child description is formatted according to:
-\begin{definition}[\DescribeMacro\glslongextraSubDescFmt]
-\cs{glslongextraSubDescFmt}\marg{level}\marg{label}
-\end{definition}
-which defaults to just \cs{glslongextraDescFmt}\marg{label}
-
-The child symbol is formatted (where appropriate) according to:
-\begin{definition}[\DescribeMacro\glslongextraSubSymbolFmt]
-\cs{glslongextraSubSymbolFmt}\marg{level}\marg{label}
-\end{definition}
-This just does \cs{glslongextraSymbolFmt}\marg{label} by default.
-
-The styles that have a location list column format the list for
-child entries using:
-\begin{definition}[\DescribeMacro\glslongextraLocationFmt]
-\cs{glslongextraSubLocationFmt}\meta{level}\marg{label}\marg{locations}
-\end{definition}
-This just does \meta{locations} and ignores the level and label.
-
-The letter group headings are formatted according to:
-\begin{definition}[\DescribeMacro\glslongextraGroupHeading]
-\cs{glslongextraGroupHeading}\marg{n}\marg{label}
-\end{definition}
-which does nothing by default. The first argument \meta{n} is the
-number of columns in the table. The second argument \meta{label}
-is the group label (not the title, although they may happen
-to be the same).
-
-This can be redefined to show the group heading. For example:
-\begin{verbatim}
-\renewcommand*{\glslongextraGroupHeading}[2]{%
- \glsxtrgetgrouptitle{#2}{\thisgrptitle}%
- \glslongextraHeaderFmt{\thisgrptitle}%
- \tabularnewline
- \noalign{\vskip\normalbaselineskip}%
-}
-\end{verbatim}
-This ignores the first argument and just puts the group
-title in the first column formatted according to
-\cs{glslongextraHeaderFmt} (to match the column header).
-
-Remember that you can also adjust the styles through category
-attributes. The name column's title is given by
-\cs{entryname}, the description column's title is given by
-\cs{descriptionname} and (where present) the symbol column's
-title is given by \cs{symbolname}, as for the other long styles
-that have headers.
+\cmddef{glsuselongfont}
+A robust command that applies the long font for the given
+category to the supplied text.
-\begin{description}
-\item{\glostyle{long-name-desc}} This is like the
-\glostyle{longragged-booktabs} style but doesn't show the location
-list (regardless of the \pkgopt{nonumberlist} option). The name is
-shown in the first column and the description in the second.
-
-The symbol is not displayed. The header
-row is produced with:
-\begin{definition}[\DescribeMacro\glslongextraNameDescHeader]
-\cs{glslongextraNameDescHeader}
-\end{definition}
-This essentially uses the same code as for \glostyle{longragged-booktabs}
-but makes it easier to adjust the header without having to define a
-new style. This is defined as:
-\begin{verbatim}
-\glslongextraNameDescTabularHeader\endhead
-\glslongextraNameDescTabularFooter\endfoot
-\end{verbatim}
-where:
-\begin{definition}[\DescribeMacro\glslongextraNameDescTabularHeader]
-\cs{glslongextraNameDescTabularHeader}
-\end{definition}
-sets up the header and
-\begin{definition}[\DescribeMacro\glslongextraNameDescTabularFooter]
-\cs{glslongextraNameDescTabularFooter}
-\end{definition}
-sets up the footer. If you have setup the \env{tabular} version
-of this style then the above two commands are used at the
-start and end of the \env{tabular} environment (and
-\cs{glslongextraNameDescHeader} isn't used).
-
-For example, to simply remove the header and footer (for the default
-\env{longtable} version of the style):
-\begin{verbatim}
-\renewcommand{\glslongextraNameDescHeader}{}
-\end{verbatim}
-Or to change the name alignment to centred:
-\begin{verbatim}
-\renewcommand{\glslongextraNameAlign}{c}
-\end{verbatim}
-
-\item{\glostyle{long-name-desc-loc}} This is like the
-\glostyle{long-name-desc} style but has a third column for the
-location list. The \env{longtable} header is given by:
-\begin{definition}[\DescribeMacro\glslongextraNameDescLocationHeader]
-\cs{glslongextraNameDescLocationHeader}
-\end{definition}
-which similarly defined in terms of the commands used for the
-\env{tabular} version:
-\begin{definition}[\DescribeMacro\glslongextraNameDescLocationTabularHeader]
-\cs{glslongextraNameDescLocationTabularHeader}
-\end{definition}
-and
-\begin{definition}[\DescribeMacro\glslongextraNameDescLocationTabularFooter]
-\cs{glslongextraNameDescLocationTabularFooter}
-\end{definition}
-
-\item{\glostyle{long-desc-name}} This is like the
-\glostyle{long-name-desc} style but swaps the columns. Note that
-if the entry counter is displayed it will appear at the start
-of the second column by default. The \env{longtable} header is formatted according
-to:
-\begin{definition}[\DescribeMacro\glslongextraDescNameHeader]
-\cs{glslongextraDescNameHeader}
-\end{definition}
-which similarly defined in terms of the commands used for the
-\env{tabular} version:
-\begin{definition}[\DescribeMacro\glslongextraDescNameTabularHeader]
-\cs{glslongextraDescNameTabularHeader}
-\end{definition}
-and
-\begin{definition}[\DescribeMacro\glslongextraDescNameTabularFooter]
-\cs{glslongextraDescNameTabularFooter}
-\end{definition}
-
-\item{\glostyle{long-loc-desc-name}} This has three columns
-containing the location list, description and name. The
-\env{longtable} header
-is formatted according to:
-\begin{definition}[\DescribeMacro\glslongextraLocationDescNameHeader]
-\cs{glslongextraLocationDescNameHeader}
-\end{definition}
-which similarly defined in terms of the commands used for the
-\env{tabular} version:
-\begin{definition}[\DescribeMacro\glslongextraLocationDescNameTabularHeader]
-\cs{glslongextraLocationDescNameTabularHeader}
-\end{definition}
-and
-\begin{definition}[\DescribeMacro\glslongextraLocationDescNameTabularFooter]
-\cs{glslongextraLocationDescNameTabularFooter}
-\end{definition}
-
-\item{\glostyle{long-name-desc-sym}} This is has three columns, with
-the name in the first, the description in the second and the symbol
-in the third.
-
-The \env{longtable} header row is produced with:
-\begin{definition}[\DescribeMacro\glslongextraNameDescSymHeader]
-\cs{glslongextraNameDescSymHeader}
-\end{definition}
-which similarly defined in terms of the commands used for the
-\env{tabular} version:
-\begin{definition}[\DescribeMacro\glslongextraNameDescSymTabularHeader]
-\cs{glslongextraNameDescSymTabularHeader}
-\end{definition}
-and
-\begin{definition}[\DescribeMacro\glslongextraNameDescSymTabularFooter]
-\cs{glslongextraNameDescSymTabularFooter}
-\end{definition}
-
-\item{\glostyle{long-name-desc-sym-loc}} This is has four columns, with
-the name in the first, the description in the second, the symbol
-in the third and the location list in the fourth.
-
-The \env{longtable} header row is produced with:
-\begin{definition}[\DescribeMacro\glslongextraNameDescSymLocationHeader]
-\cs{glslongextraNameDescSymLocationHeader}
-\end{definition}
-which similarly defined in terms of the commands used for the
-\env{tabular} version:
-\begin{definition}[\DescribeMacro\glslongextraNameDescSymLocationTabularHeader]
-\cs{glslongextraNameDescSymLocationTabularHeader}
-\end{definition}
-and
-\begin{definition}[\DescribeMacro\glslongextraNameDescSymLocationTabularFooter]
-\cs{glslongextraNameDescSymLocationTabularFooter}
-\end{definition}
-
-\item{\glostyle{long-name-sym-desc}} This is like the
-\glostyle{long-name-desc-sym} but the second and third column are
-swapped. The \env{longtable} header row is given by:
-\begin{definition}[\DescribeMacro\glslongextraNameSymDescHeader]
-\cs{glslongextraNameSymDescHeader}
-\end{definition}
-which similarly defined in terms of the commands used for the
-\env{tabular} version:
-\begin{definition}[\DescribeMacro\glslongextraNameSymDescTabularHeader]
-\cs{glslongextraNameSymDescTabularHeader}
-\end{definition}
-and
-\begin{definition}[\DescribeMacro\glslongextraNameSymDescTabularFooter]
-\cs{glslongextraNameSymDescTabularFooter}
-\end{definition}
-
-\item{\glostyle{long-name-sym-desc-loc}} This is like the
-\glostyle{long-name-desc-sym-loc} but the second and third column are
-swapped. The \env{longtable} header row is given by:
-\begin{definition}[\DescribeMacro\glslongextraNameSymDescLocationHeader]
-\cs{glslongextraNameSymDescLocationHeader}
-\end{definition}
-which similarly defined in terms of the commands used for the
-\env{tabular} version:
-\begin{definition}[\DescribeMacro\glslongextraNameSymDescLocationTabularHeader]
-\cs{glslongextraNameSymDescLocationTabularHeader}
-\end{definition}
-and
-\begin{definition}[\DescribeMacro\glslongextraNameSymDescLocationTabularFooter]
-\cs{glslongextraNameSymDescLocationTabularFooter}
-\end{definition}
-
-\item{\glostyle{long-sym-desc-name}} This has the symbol in the
-first column, the description in the second and the name in the
-third. The \env{longtable} header row is given by:
-\begin{definition}[\DescribeMacro\glslongextraSymDescNameHeader]
-\cs{glslongextraSymDescNameHeader}
-\end{definition}
-which similarly defined in terms of the commands used for the
-\env{tabular} version:
-\begin{definition}[\DescribeMacro\glslongextraSymDescNameTabularHeader]
-\cs{glslongextraSymDescNameTabularHeader}
-\end{definition}
-and
-\begin{definition}[\DescribeMacro\glslongextraSymDescNameTabularFooter]
-\cs{glslongextraSymDescNameTabularFooter}
-\end{definition}
-
-\item{\glostyle{long-loc-sym-desc-name}} This has the location list
-in the first column, symbol in the
-second column, the description in the third and the name in the
-fourth. The \env{longtable} header row is given by:
-\begin{definition}[\DescribeMacro\glslongextraLocationSymDescNameHeader]
-\cs{glslongextraLocationSymDescNameHeader}
-\end{definition}
-which similarly defined in terms of the commands used for the
-\env{tabular} version:
-\begin{definition}[\DescribeMacro\glslongextraLocationSymDescNameTabularHeader]
-\cs{glslongextraLocationSymDescNameTabularHeader}
-\end{definition}
-and
-\begin{definition}[\DescribeMacro\glslongextraLocationSymDescNameTabularFooter]
-\cs{glslongextraLocationSymDescNameTabularFooter}
-\end{definition}
-
-\item{\glostyle{long-desc-sym-name}} This has the description in the
-first column, the symbol in the second and the name in the
-third. The \env{longtable} header row is given by:
-\begin{definition}[\DescribeMacro\glslongextraDescSymNameHeader]
-\cs{glslongextraDescSymNameHeader}
-\end{definition}
-which similarly defined in terms of the commands used for the
-\env{tabular} version:
-\begin{definition}[\DescribeMacro\glslongextraDescSymNameTabularHeader]
-\cs{glslongextraDescSymNameTabularHeader}
-\end{definition}
-and
-\begin{definition}[\DescribeMacro\glslongextraDescSymNameTabularFooter]
-\cs{glslongextraDescSymNameTabularFooter}
-\end{definition}
-
-\item{\glostyle{long-loc-desc-sym-name}} This has the location list
-in the first column, the description in the
-second column, the symbol in the third and the name in the
-fourth. The \env{longtable} header row is given by:
-\begin{definition}[\DescribeMacro\glslongextraLocationDescSymNameHeader]
-\cs{glslongextraLocationDescSymNameHeader}
-\end{definition}
-which similarly defined in terms of the commands used for the
-\env{tabular} version:
-\begin{definition}[\DescribeMacro\glslongextraLocationDescSymNameTabularHeader]
-\cs{glslongextraLocationDescSymNameTabularHeader}
-\end{definition}
-and
-\begin{definition}[\DescribeMacro\glslongextraLocationDescSymNameTabularFooter]
-\cs{glslongextraLocationDescSymNameTabularFooter}
-\end{definition}
+\cmddef{GlsXtrUseAbbrStyleSetup}
+This implements the given abbreviation style's setup code.
+Note that this expects the placeholder macros and token registers to
+be set. This may be used in the \meta{setup} of
+\gls{newabbreviationstyle} to inherit the setup code of a related
+style.
-\end{description}
+\cmddef{GlsXtrUseAbbrStyleFmts}
+This implements the given abbreviation style's display
+definitions code. This may be used in the \meta{display
+definitions} of \gls{newabbreviationstyle} to inherit the formatting
+of a related style.
+
+\cmddef{xpglsxtrpostabbrvfootnote}
+This is used by styles like \abbrstyle{postfootnote} to ensure that
+the label and inner and outer formatting are expanded before being
+passed to \gls{glsxtrpostabbrvfootnote}, otherwise they may lose
+their definitions before the footnote text is typeset.
+
+\cmddef{glsxtrpostabbrvfootnote}
+This is used by the footnote styles that defer the footnote to the
+\idx{postlinkhook}. The default definition is:
+\begin{codebox}
+\cmd{newrobustcmd}*\marg{\gls{glsxtrpostabbrvfootnote}}[2]\marg{\%
+ \gls{glsxtrabbrvfootnote}\marg{\#1}\%
+ \marg{\#2\gls{glsxtrpostfootnotelongformat}\marg{\#1}\marg{\gls{glsfirstlongfootnotefont}}}\%
+}
+\end{codebox}
+The second argument will be the expansion of
+\gls{glsxtrassignlinktextfmt}, to allow the \idx{innerformatting}
+to be picked up, if required.
-\section{\headingsty{glossary-topic} package}
-\label{sec:topic}
+\cmddef{glsxtrifhyphenstart}
+This command is used by the hyphen styles to determine if the insert
+material starts with a hyphen. Does \meta{true} if \meta{text}
+starts with a hyphen otherwise does \meta{false}.
-As from version 1.40, the \styfmt{glossaries-extra} package comes
-with the supplementary package \sty{glossary-topic} that
-provides glossary styles designed for hierarchical glossaries
-where the top-level entries are topic titles. This package
-automatically loads the \sty{multicols} package. If the
-\sty{glossary-tree} package is also loaded then commands like
-\cs{glssetwidest} can be used on these styles in much the same way
-as for the \glostyle{alttree} style. If a widest value isn't set
-then these styles behave more like the \glostyle{tree} style.
-\begin{description}
-\item[\glostyle{topic}] This style is similar to the \glostyle{tree}
-style but the indentation doesn't start until the second
-sub-item level. The top-level entries have the name displayed
-in a larger font with the description following in a new paragraph.
-This style doesn't support the \pkgopt{nogroupskip} setting.
+\cmddef{GlsXtrWarnDeprecatedAbbrStyle}
+This command is used to generate a warning (with \gls{GlossariesExtraWarning})
+if a deprecated abbreviation style is used.
-\item[\glostyle{topicmcols}] This style is like the \glostyle{topic}
-style but the sub-entries are placed inside a \env{multicols}
-environment. The environment name is supplied in the value of
-the command:
-\begin{definition}[\DescribeMacro\glstopicColsEnv]
-\cs{glstopicColsEnv}
-\end{definition}
-You can change this to the starred form. For example:
-\begin{verbatim}
-\renewcommand{\glstopicColsEnv}{multicols*}
-\end{verbatim}
-The number of columns is given by the command:
-\begin{definition}[\DescribeMacro\glstopicCols]
-\cs{glstopicCols}
-\end{definition}
-The default value is 2.
-\end{description}
-Both styles use the following commands.
-\begin{definition}[\DescribeMacro\glstopicParIndent]
-\cs{glstopicParIndent}
-\end{definition}
-This command is a length that's used for the paragraph indentation
-in any multi-paragraph description for top-level entries, but not
-for the first paragraph (at the start of the description) which
-isn't indented.
+\subsection{Defining New Abbreviation Styles}
+\label{sec:newabbrvstyle}
-\begin{definition}[\DescribeMacro\glstopicSubIndent]
-\cs{glstopicSubIndent}
-\end{definition}
-This command is a length that's used to calculate the hanging
-indentation for sub-entries. The level~1 sub-entries don't indent
-the name. Level~$n$ sub-entries have the name indented by
-$(n-1)\times$\cs{glstopicSubIndent}. The hanging indent depends
-on whether or not a widest name has been set for the level.
+If none of the predefined styles suit your requirements, you can
+define your own custom style using:
+\cmddef{newabbreviationstyle}
+The first argument is the style name. This is used internally to
+form control sequences, so the name shouldn't contain any special
+characters.
-As from v1.46, there is also a length for additional indentation
-used in the second paragraph onwards for child entries with
-multi-paragraph descriptions:
-\begin{definition}[\DescribeMacro\glstopicSubItemParIndent]
-\cs{glstopicSubItemParIndent}
-\end{definition}
-This is initialised to \ics{parindent} when \sty{glossary-topic} is
-loaded.
+The second argument sets up the information that's required when an
+abbreviation is defined (which is why the style must be set before
+the abbreviations with that style are defined). The relevant
+commands for this argument are listed in
+\sectionref{sec:abbrstyleinit}.
+
+The third argument defines the commands that determine how
+the display style (\gls{gls}) and the inline style
+(\gls{glsxtrfull}) are formatted. The relevant
+commands for this argument are listed in
+\sectionref{sec:abbrstylefmts}.
+
+\cmddef{renewabbreviationstyle}
+Redefines an existing abbreviation style.
+
+\cmddef{letabbreviationstyle}
+Defines a synonym of an existing abbreviation style.
+
+\subsubsection{Style Initialisation Hooks}
+\label{sec:abbrstyleinit}
+
+The style initialisation hooks should be placed in the second
+argument (\meta{setup}) of \gls{newabbreviationstyle}. They ensure
+that all the fields are correctly initialised when the entry is
+defined with the underlying \gls{newglossaryentry} command. They may
+also be used to set category attributes.
+
+The following is prepended to \meta{setup} to initialise the final
+hook:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{GlsXtrPostNewAbbreviation}}\marg{}
+\end{codebox}
+
+When an entry is defined with \gls{newabbreviation}, the following
+steps are performed:
+\begin{enumerate}
+\item Token registers are initialised to the information provided in the
+arguments of \gls{newabbreviation}: \gls{glskeylisttok},
+\gls{glslabeltok}, \gls{glsshorttok} and \gls{glslongtok}.
-\begin{definition}[\DescribeMacro\glstopicInit]
-\cs{glstopicInit}
-\end{definition}
-Hook used at the start of the glossary. Does nothing by default.
+\item The commands \gls{glsxtrorgkeylist}, \gls{glsxtrorgshort} and \gls{glsxtrorglong} are
+defined to the options, short and long values supplied to
+\gls{newabbreviation}. (The \gls{glskeylisttok} \gls{glsshorttok} and \gls{glslongtok}
+token registers may be changed before the entry is actually defined.
+These commands may be used to obtain the original values.)
-Although the styles don't support letter groups by default, if you
-have many topics (top-level entries) and you feel that it would help
-the reader to divide them up into headed letter groups, you can
-redefine:
-\begin{definition}[\DescribeMacro\glstopicGroupHeading]
-\cs{glstopicGroupHeading}\marg{group label}
-\end{definition}
-This does nothing by default. If you want to redefine it, you can
-fetch the title corresponding to the group label with
-\cs{glsxtrgetgrouptitle}. For example:
-\begin{verbatim}
-\renewcommand*{\glstopicGroupHeading}[1]{%
- \glsxtrgetgrouptitle{#1}{\thisgrptitle}%
- \section*{\thisgrptitle}%
-}
-\end{verbatim}
-Remember that if you use \gls{bib2gls}, you will need the
-\verb|--group| (or \verb|-g|) switch to support this.
-
-\begin{definition}[\DescribeMacro\glstopicItem]
-\cs{glstopicItem}\marg{label}\marg{location list}
-\end{definition}
-Used to format the name, symbol, description and location list
-for the top-level entries. This starts with a paragraph break
-followed by:
-\begin{definition}[\DescribeMacro\glstopicPreSkip]
-\cs{glstopicPreSkip}
-\end{definition}
-which defaults to \cs{medskip}. There is then a hook:
-\begin{definition}[\DescribeMacro\glstopicMarker]
-\cs{glstopicMarker}\marg{label}
-\end{definition}
-which does nothing by default, but may be redefined. For example,
-to add a line to the table of contents.
-The name and symbol are set in the
-form of a title using:
-\begin{definition}[\DescribeMacro\glstopicTitle]
-\cs{glstopicTitle}\marg{label}
-\end{definition}
-This uses \cs{Glossentryname} which converts the first letter to
-upper case. If there's a symbol, this is added in parentheses.
-Both name and symbol (if present) are encapsulated by
-\begin{definition}[\DescribeMacro\glstopicTitleFont]
-\cs{glstopicTitleFont}\marg{text}
-\end{definition}
-This uses a bold, large font by default.
+\item \gls{ExtraCustomAbbreviationFields} is initialised to do
+nothing.
-If the entry has the description key set (tested with
-\cs{ifglshasdesc}) then a paragraph break is inserted followed by:
-\begin{definition}[\DescribeMacro\glstopicMidSkip]
-\cs{glstopicMidSkip}
-\end{definition}
-which defaults to \cs{smallskip}. This is followed by the
-description which is formatted according to:
-\begin{definition}[\DescribeMacro\glstopicDesc]
-\cs{glstopicDesc}\marg{label}
-\end{definition}
-This just does \cs{Glossentrydesc}\marg{label} followed
-by the post-description hook.
-
-A paragraph break followed by:
-\begin{definition}[\DescribeMacro\glstopicPostSkip]
-\cs{glstopicPostSkip}
-\end{definition}
-comes next regardless of whether or not the description was
-displayed. This defaults to \cs{smallskip}. This is then followed
-by:
-\begin{definition}[\DescribeMacro\glstopicLoc]
-\cs{glstopicLoc}\marg{label}\marg{location list}
-\end{definition}
-which may be used to display the location list, but does nothing by
-default.
+\item Accessibility settings are initialised, if required.
+These redefine \gls{ExtraCustomAbbreviationFields} to set the
+accessibility fields.
-The sub-entries first set up the paragraph and hanging indentations
-using:
-\begin{definition}[\DescribeMacro\glstopicAssignSubIndent]
-\cs{glstopicAssignSubIndent}\marg{level}
-\end{definition}
-This uses:
-\begin{definition}[\DescribeMacro\glstopicAssignWidest]
-\cs{glstopicAssignWidest}\marg{level}
-\end{definition}
-to determine if a widest name has been set for the given level.
+\item The command \gls{glscategorylabel} is defined to \code{abbreviation}.
+
+\item The options list is parsed for the following keys: \gloskey{category}
+and, if accessibility is enabled,
+\gloskey{access}, \gloskey{textaccess}, \gloskey{pluralaccess},
+\gloskey{firstaccess}, \gloskey{firstpluralaccess},
+\gloskey{shortaccess}, \gloskey{shortpluralaccess},
+\gloskey{longaccess}, and \gloskey{longpluralaccess}.
+
+\item The abbreviation style is applied for the category given by
+\gls{glscategorylabel} (which may have been changed when the options
+were parsed in the previous step) or the fallback if no abbreviation
+style is associated with that category. This performs both the
+\meta{setup} and \meta{display definitions} provided when the style
+was defined with \gls{newabbreviationstyle}.
+
+\item The long plural form is initialised to its default value
+(\meta{long}\gls{glspluralsuffix}).
+
+\item The \catattr{markwords} attribute, if set, is implemented for the
+singular long form. It will also mark
+the entry as having a description with formatting (using
+\gls{glsexclapplyinnerfmtfield}).
+
+\item The \catattr{markshortwords} attribute is implemented, if
+set, otherwise the \catattr{insertdots} attribute is implemented, if
+set, for the singular short form.
+
+\item The \catattr{aposplural} attribute is implemented, if
+set, otherwise the \catattr{noshortplural} attribute is implemented, if
+set. This step will set the default short plural.
+
+\item \gls{glsshorttok} is updated to reflect any changes.
+
+\item The \gls{glsxtrnewabbrevpresetkeyhook} hook is performed.
+
+\item The options list is parsed for the \gloskey{shortplural} and
+\gloskey{longplural} keys. The \gls{glskeylisttok} token is updated
+to only include the remaining keys that haven't yet been processed.
+
+\item The \catattr{markwords} attribute, if set, is implemented for the
+plural long form.
+
+\item The \catattr{markshortwords} attribute, if set, otherwise the
+\catattr{insertdots} attribute, if set, is implemented for the
+plural short form.
+
+\item The \gls{glsshortpltok} and \gls{glslongpltok} registers are
+set.
+
+\item \gls{newabbreviationhook} performed.
+
+\item The entry is defined using \gls{newglossaryentry} with the key value list:
+\begin{codebox}
+\gloskeyval{type}{\gls{glsxtrabbrvtype}},
+\gloskeyval{category}{abbreviation},
+\gloskeyval{short}{\cmd{the}\gls{glsshorttok}},
+\gloskeyval{shortplural}{\cmd{the}\gls{glsshortpltok}},
+\gloskeyval{long}{\cmd{the}\gls{glslongtok}},
+\gloskeyval{longplural}{\cmd{the}\gls{glslongpltok}},
+\gloskeyval{name}{\cmd{the}\gls{glsshorttok}},
+\gls{CustomAbbreviationFields},
+\gls{ExtraCustomAbbreviationFields}
+\cmd{the}\gls{glskeylisttok}
+\end{codebox}
+
+\item Add the \gloskey{name}, \gloskey{first},
+\gloskey{firstplural}, \gloskey{text} and \gloskey{plural} keys to
+the list of \idx{innerformatting} exclusions, as
+they include formatting commands.
+
+\item Final hook \gls{GlsXtrPostNewAbbreviation} performed.
+\end{enumerate}
-The sub-entry has its information displayed using:
-\begin{definition}[\DescribeMacro\glstopicSubItem]
-\cs{glstopicSubItem}\marg{level}\marg{label}\marg{location}
-\end{definition}
-This encapsulates the name with:
-\begin{definition}[\DescribeMacro\glstopicSubNameFont]
-\cs{glstopicSubNameFont}\marg{text}
-\end{definition}
-By default this just uses \cs{textbf}. This is followed by:
-\begin{definition}[\DescribeMacro\glstopicSubItemSep]
-\cs{glstopicSubItemSep}
-\end{definition}
-which defaults to \cs{quad}. The name and separator are
-passed in the \meta{text} argument of:
-\begin{definition}[\DescribeMacro\glstopicSubItemBox]
-\cs{glstopicSubItemBox}\marg{level}\marg{text}
-\end{definition}
-If a widest name was set for the given level, this will
-put \meta{text} inside a box of that width otherwise it just does
-\meta{text}.
+Note that when these hooks (except the last) are used, the entry hasn't yet been
+defined. However, some information will have already been picked up
+from the arguments of \gls{newabbreviation}. These can be accessed
+in the hooks using the following (but make sure they are fully
+expanded):
+\cmddef{glscategorylabel}
+Expands to the entry's category label.
+
+\cmddef{glskeylisttok}
+A token register that contains the options that were passed to
+\gls{newabbreviation} with pre-processed options removed.
+Use \code{\cmd{the}\gls{glskeylisttok}} to expand it.
+
+The original option list, as supplied to \gls{newabbreviation}, can
+be obtained with:
+\cmddef{glsxtrorgkeylist}
+(Not a token register.)
+
+\cmddef{glslabeltok}
+A token register that contains the entry's label. Use
+\code{\cmd{the}\gls{glslabeltok}} to expand it.
+
+\cmddef{glsshorttok}
+A token register that contains the short form (which may have been
+modified after being passed to \gls{newabbreviation}). Use
+\code{\cmd{the}\gls{glsshorttok}} to expand it.
+
+The original short form, as supplied to \gls{newabbreviation}, can
+be obtained with:
+\cmddef{glsxtrorgshort}
+(Not a token register.)
+
+\cmddef{glsshortpltok}
+A token register that contains the short plural form (which may
+have been obtained from the short form or modified after being
+passed to \gls{newabbreviation}). Use
+\code{\cmd{the}\gls{glsshortpltok}} to expand it.
+
+\cmddef{glslongtok}
+A token register that contains the long form (which may have been
+modified after being passed to \gls{newabbreviation}). Use
+\code{\cmd{the}\gls{glslongtok}} to expand it.
+
+The original long form, as supplied to \gls{newabbreviation}, can
+be obtained with:
+\cmddef{glsxtrorglong}
+(Not a token register.)
+
+\cmddef{glslongpltok}
+A token register that contains the long plural form (which may
+have been obtained from the long form or modified after being
+passed to \gls{newabbreviation}). Use
+\code{\cmd{the}\gls{glslongpltok}} to expand it.
+
+\cmddef{ExtraCustomAbbreviationFields}
+Expands to additional field definitions for the entry. This is used
+to add the accessibility fields (such as \gloskey{shortaccess}), if
+enabled. The abbreviation style may append (\gls{appto}) or prepend
+(\gls{preto}) additional information, if required, to this hook.
-This is followed by the symbol in parentheses if set. Then, if the
-description is set, the description and post-description hook are
-displayed followed by:
-\begin{definition}[\DescribeMacro\glstopicSubPreLocSep]
-\cs{glstopicSubPreLocSep}
-\end{definition}
-(This command isn't used if the description isn't set.)
+\begin{important}
+If you alter this hook, make sure that you include the trailing
+comma after each \code{\meta{key}\dequals\marg{value}}, including the last one.
+\end{important}
-Finally the location list is displayed using:
-\begin{definition}[\DescribeMacro\glstopicSubLoc]
-\cs{glstopicSubLoc}\marg{label}\marg{location}
-\end{definition}
-which just does \meta{location} by default.
+\cmddef{CustomAbbreviationFields}
+Expands to the default field definitions for the entry. Take care to
+protect any commands that shouldn't be expanded. The comma may be
+omitted from the final \code{\meta{key}\dequals\marg{value}}.
+
+\cmddef{GlsXtrPostNewAbbreviation}
+A hook that's used after the entry has been defined (at the end of
+\gls{newabbreviation}). This can be used to set category attributes,
+define the \idx{postlinkhook}, or mark the entry as having a complex
+style (with \gls{glsxtrsetcomplexstyle}).
+
+For example, the \abbrstyle{long-short} abbreviation style includes
+the following in \meta{setup}:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{GlsXtrPostNewAbbreviation}}\marg{\%
+ \gls{glsxtrsetcomplexstyle}\marg{\cmd{the}\gls{glslabeltok}}\marg{3}\%
+ \gls{glshasattribute}\marg{\cmd{the}\gls{glslabeltok}}\marg{regular}\%
+ \marg{\%
+ \gls{glssetattribute}\marg{\cmd{the}\gls{glslabeltok}}\marg{regular}\marg{false}\%
+ }\%
+ \marg{}\%
+}
+\end{codebox}
+Note that in the above, the commands within the definition of
+\gls{GlsXtrPostNewAbbreviation} are all expanded when that hook is
+used. However, if this hook defines other commands or hooks that
+will be used later, then make sure that the definitions of those
+commands use the inner hook's own placeholder commands.
+
+\begin{information}
+Remember that the \idx{postlinkhook} uses \gls{glslabel} to
+reference the current label. Don't use \gls{glslabeltok} as that
+will contain the label of the last abbreviation to be defined.
+\end{information}
+
+For example, the \abbrstyle{long-hyphen-postshort-hyphen} style has:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{GlsXtrPostNewAbbreviation}}\marg{\%
+ \gls{glsexclapplyinnerfmtfield}\marg{\cmd{the}\gls{glslabeltok}}\marg{desc}\%
+ \gls{csdef}\marg{glsxtrpostlink\gls{glscategorylabel}}\marg{\%
+ \gls{glsxtrifwasfirstuse}
+ \marg{\%
+ \gls{expandafter}\gls{glsxtrposthyphenshort}\gls{expandafter}\gls{glslabel}
+ \gls{expandafter}\marg{\gls{glsinsert}}\%
+ }\%
+ \marg{\%
+ \gls{expandafter}\gls{glsxtrposthyphensubsequent}\gls{expandafter}\gls{glslabel}
+ \gls{expandafter}\marg{\gls{glsinsert}}\%
+ }\%
+ }\%
+ \gls{glshasattribute}\marg{\cmd{the}\gls{glslabeltok}}\marg{regular}\%
+ \marg{\%
+ \gls{glssetattribute}\marg{\cmd{the}\gls{glslabeltok}}\marg{regular}\marg{false}\%
+ }\%
+ \marg{}\%
+}
+\end{codebox}
+In the above, \gls{glslabeltok} and \gls{glscategorylabel} are used
+in the parts that will be expanded at the end of
+\gls{newabbreviation}, but \gls{glslabel} and \gls{glsinsert} are
+used in the definition of the \idx{postlinkhook}, which won't be
+expanded until the entry is referenced in the document with a
+command such as \gls{gls}. (The use of \gls{expandafter} is included
+to assist \glsopt{innertextformat}.)
+
+\cmddef{glsxtrsetcomplexstyle}
+This command should go in the definition of
+\gls{GlsXtrPostNewAbbreviation} to indicate that the entry given by
+\meta{entry-label} has an abbreviation style that is
+complex. The second argument \meta{n} should be numeric and
+indicates why it doesn't work with \gls{glsfirst}, \gls{Glsfirst},
+\gls{GLSfirst}, \gls{glsfirstplural}, \gls{Glsfirstplural}
+or \gls{GLSfirstplural}: 1 (all caps doesn't work), 2 (all caps and
+insert doesn't work), 3 (insert doesn't work).
+
+\cmddef{glsfirstinnerfmtabbrvfont}
+This is a robust command that applies both \gls{glsfirstabbrvfont} and the inner
+formatting command \gls{glsxtrgenentrytextfmt}. This is used by the
+following command.
+
+\cmddef{glsfirstxpabbrvfont}
+If the \catattr{markshortwords} attribute is true, this does
+\code{\cmd{protect}\gls{glsfirstabbrvfont}\margm{text}}
+otherwise it does \code{\gls{glsfirstinnerfmtabbrvfont}\margm{text}}.
+
+This command is designed to be used within
+\gls{CustomAbbreviationFields} to set the \gloskey{first} and
+\gloskey{firstplural} keys, so it needs to partially expand
+within \gls{newabbreviation}. For example, the
+\abbrstyle{postfootnote} includes the following lines in the
+definition of \gls{CustomAbbreviationFields}:
+\begin{codebox}
+\gloskeyval{first}{\gls{glsfirstxpabbrvfont}\marg{\cmd{the}\gls{glsshorttok}}\marg{\gls{glscategorylabel}}},\%
+\gloskeyval{firstplural}{\gls{glsfirstxpabbrvfont}\marg{\cmd{the}\gls{glsshortpltok}}\marg{\gls{glscategorylabel}}},
+\end{codebox}
+This will be expanded before being passed to \gls{newglossaryentry}.
+If the \catattr{markshortwords} attribute is true, this will end up
+as:
+\begin{codebox}
+\gloskeyval{first}{\cmd{protect}\gls{glsfirstabbrvfont}\margm{short}},\%
+\gloskeyval{firstplural}{\cmd{protect}\gls{glsfirstabbrvfont}\margm{shortpl}}
+\end{codebox}
+otherwise it will end up as:
+\begin{codebox}
+\gloskeyval{first}{\gls{glsfirstinnerfmtabbrvfont}\margm{short}},\%
+\gloskeyval{firstplural}{\gls{glsfirstinnerfmtabbrvfont}\margm{shortpl}},\%
+\end{codebox}
+where \meta{short} and \meta{shortpl} are, respectively, the values
+in the \gls{glsshorttok} and \gls{glsshortpltok} registers.
+
+\begin{information}
+The placeholder registers and macros (such as \gls{glsshorttok} and
+\gls{glscategorylabel}) must be expanded before being passed to
+\gls{newglossaryentry} as their values are unreliable outside of
+\gls{newabbreviation}.
+\end{information}
+
+\cmddef{glsinnerfmtabbrvfont}
+This is a robust command that applies both \gls{glsabbrvfont} and the inner
+formatting command \gls{glsxtrgenentrytextfmt}. This is used by the
+following command.
+
+\cmddef{glsxpabbrvfont}
+If the \catattr{markshortwords} attribute is true, this does
+\code{\cmd{protect}\gls{glsabbrvfont}\margm{text}}
+otherwise it does \code{\gls{glsinnerfmtabbrvfont}\margm{text}}.
+This command is designed for the \gloskey{name}, \gloskey{text} and \gloskey{plural}
+keys within \gls{CustomAbbreviationFields}.
+
+\cmddef{glsfirstinnerfmtlongfont}
+This is a robust command that applies both \gls{glsfirstlongfont} and the inner
+formatting command \gls{glsxtrgenentrytextfmt}. This is used by the
+following command.
+
+\cmddef{glsfirstxplongfont}
+If the \catattr{markwords} attribute is true, this does
+\code{\cmd{protect}\gls{glsfirstlongfont}\margm{text}}
+otherwise it does \code{\gls{glsfirstinnerfmtlongfont}\margm{text}}.
+This command is designed for the \gloskey{first} and \gloskey{firstplural}
+keys within \gls{CustomAbbreviationFields}.
+
+\cmddef{glsinnerfmtlongfont}
+This is a robust command that applies both \gls{glslongfont} and the inner
+formatting command \gls{glsxtrgenentrytextfmt}. This is used by the
+following command.
+
+\cmddef{glsxplongfont}
+If the \catattr{markwords} attribute is true, this does
+\code{\cmd{protect}\gls{glslongfont}\margm{text}}
+otherwise it does \code{\gls{glsinnerfmtlongfont}\margm{text}}.
+This command is designed for the \gloskey{name}, \gloskey{text} and \gloskey{plural}
+keys within \gls{CustomAbbreviationFields} (if they should include
+the long form in their value, such as the
+\abbrstyle{long-noshort-desc} style).
+
+\cmddef{glsxtrAccSuppAbbrSetNoLongAttrs}
+If accessibility support has been enabled with \opt{accsupp}, this
+command will initialise support for the \gloskey{name},
+\gloskey{first}, \gloskey{firstplural},
+\gloskey{text} and \gloskey{plural} fields for the given category
+(using \gls{glsxtrprovideaccsuppcmd}).
+The \catattr{nameshortaccess}, \catattr{firstshortaccess} and \catattr{textshortaccess}
+attributes are set to \code{true}. (Does nothing if accessibility
+support has not been enabled.)
+
+This command is provided for abbreviation styles
+where the \gloskey{name}, \gloskey{first} and \gloskey{text} are
+just the formatted abbreviation. The
+\gloskey{first} field may just be the long form or may be a
+combination of short and long.
+
+\cmddef{glsxtrAccSuppAbbrSetNameLongAttrs}
+If accessibility support has been enabled with \opt{accsupp}, this
+command will initialise support for the
+\gloskey{first}, \gloskey{firstplural},
+\gloskey{text} and \gloskey{plural} fields for the given category
+(using \gls{glsxtrprovideaccsuppcmd}).
+The \catattr{firstshortaccess} and \catattr{textshortaccess}
+attributes are set to \code{true}. (Does nothing if accessibility
+support has not been enabled.)
+
+This command is provided for abbreviation styles
+where the \gloskey{first} and \gloskey{text} are
+just the formatted abbreviation. The
+\gloskey{name} field may just be the long form or may be a
+combination of short and long.
+
+\cmddef{glsxtrAccSuppAbbrSetFirstLongAttrs}
+If accessibility support has been enabled with \opt{accsupp}, this
+command will initialise support for the \gloskey{name},
+\gloskey{text} and \gloskey{plural} fields for the given category
+(using \gls{glsxtrprovideaccsuppcmd}).
+The \catattr{nameshortaccess} and \catattr{textshortaccess}
+attributes are set to \code{true}. (Does nothing if accessibility
+support has not been enabled.)
+
+This command is provided for abbreviation styles where the
+\gloskey{name} and \gloskey{text} are just the formatted
+abbreviation. The \gloskey{first} field may just be the long form or
+may be a combination of short and long.
+
+\cmddef{glsxtrAccSuppAbbrSetTextShortAttrs}
+If accessibility support has been enabled with \opt{accsupp}, this
+command will initialise support for the
+\gloskey{text} and \gloskey{plural} fields for the given category
+(using \gls{glsxtrprovideaccsuppcmd}).
+The \catattr{textshortaccess}
+attribute is set to \code{true}. (Does nothing if accessibility
+support has not been enabled.)
+
+This command is provided for abbreviation styles where the
+\gloskey{text} is just the formatted abbreviation. The
+\gloskey{name} and \gloskey{first} fields may just be the long form
+or may be a combination of short and long. The \gloskey{name} may
+also be short but followed by the long form in the description.
+
+\cmddef{glsxtrAccSuppAbbrSetNameShortAttrs}
+If accessibility support has been enabled with \opt{accsupp}, this
+command will initialise support for the
+\gloskey{name} field for the given category
+(using \gls{glsxtrprovideaccsuppcmd}).
+The \catattr{nameshortaccess}
+attribute is set to \code{true}. (Does nothing if accessibility
+support has not been enabled.)
+
+This command is provided for abbreviation styles where only the
+\gloskey{name} is just the formatted abbreviation. The
+\gloskey{first} and \gloskey{text} fields may just be the long form
+or may be a combination of short and long.
+
+\subsubsection{Style Formatting Commands}
+\label{sec:abbrstylefmts}
+
+The final \meta{display definitions} argument of
+\gls{newabbreviationstyle} should contain the redefinitions of the
+style commands listed here that are used to format abbreviations.
+
+Whenever an abbreviation style is activated with commands like
+\gls{setabbreviationstyle}, \gls{newabbreviation} or
+\gls{glssetabbrvfmt}, \meta{display definitions} are implemented.
-\chapter{Abbreviations}
-\label{sec:abbreviations}
+\begin{important}
+If you simply want to adjust the formatting of one of the predefined
+styles, you should redefine the associated commands listed in
+\sectionref{sec:abbrvcmds}.
+\end{important}
-The new abbreviation system provided by \styfmt{glossaries-extra}
-is more flexible than the acronym handling provided by the
-base \styfmt{glossaries} package. The \styfmt{glossaries-extra}
-package modifies the underlying formatting used by
-\cs{gls} (and its variants) so that terms that are recognised as
-abbreviations can have their formatting dealt with by the style. You
-therefore need to select an abbreviation style that ensures that
-\cs{gls} (and its variants) displays the desired output.
-See the file
-\href{http://mirrors.ctan.org/macros/latex/contrib/glossaries-extra/samples/sample-abbr-styles.pdf}{sample-abbr-styles.pdf}
-for samples of all provided abbreviation styles.
+The following initialisation is always prepended to
+\meta{display definitions} so you can omit them if the default is
+appropriate for your style:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glsxtrinlinefullformat}}\marg{\gls{glsxtrfullformat}}\%
+\cmd{renewcommand}*\marg{\gls{Glsxtrinlinefullformat}}\marg{\gls{Glsxtrfullformat}}\%
+\cmd{renewcommand}*\marg{\gls{GLSxtrinlinefullformat}}\marg{\gls{GLSxtrfullformat}}\%
+\cmd{renewcommand}*\marg{\gls{glsxtrinlinefullplformat}}\marg{\gls{glsxtrfullplformat}}\%
+\cmd{renewcommand}*\marg{\gls{Glsxtrinlinefullplformat}}\marg{\gls{Glsxtrfullplformat}}\%
+\cmd{renewcommand}*\marg{\gls{GLSxtrinlinefullplformat}}\marg{\gls{GLSxtrfullplformat}}\%
+\cmd{let}\gls{glsxtrsubsequentfmt}\gls{glsxtrdefaultsubsequentfmt}
+\cmd{let}\gls{glsxtrsubsequentplfmt}\gls{glsxtrdefaultsubsequentplfmt}
+\cmd{let}\gls{Glsxtrsubsequentfmt}\gls{Glsxtrdefaultsubsequentfmt}
+\cmd{let}\gls{Glsxtrsubsequentplfmt}\gls{Glsxtrdefaultsubsequentplfmt}
+\cmd{let}\gls{GLSxtrsubsequentfmt}\gls{GLSxtrdefaultsubsequentfmt}
+\cmd{let}\gls{GLSxtrsubsequentplfmt}\gls{GLSxtrdefaultsubsequentplfmt}
+\end{codebox}
+In the event that any styles omit defining the newer \gls{GLSxtrfullformat}
+or \gls{GLSxtrfullplformat}, these are also initialised to defaults
+but ideally they should have their definitions provided.
+
+The minimal set of commands that should have their definitions
+provided are the abbreviation plural suffix
+(\gls{abbrvpluralsuffix}) the \idxpl{displayfullform}:
+\gls{glsxtrfullformat}, \gls{glsxtrfullplformat} and their
+case-changing variants.
+
+The \idx{inlinefullform} commands only need to be provided if they
+behave differently from the \idx{displayfullform}. The subsequent
+use commands only need to be provided if the default (only show the
+short form) isn't suitable.
\begin{important}
-Don't use \ics{glsfirst}, \ics{Glsfirst} or \ics{GLSfirst} with
-abbreviations as they aren't flexible enough to handle some
-abbreviation styles and unexpected results may occur. (To a lesser
-degree, this also applies to \ics{glstext} etc.) Use commands
-like \cs{glsfmttext}, \cs{glsfmtshort} or \cs{glsfmtlong} in section headings or
-captions instead of \cs{gls}. If you don't want the full form to
-show on first use of \cs{gls} use one of the \qt{nolong} or
-\qt{noshort} styles.
+The content of \meta{display definitions} is placed within the
+definition of an internal control sequence, so remember to use
+\code{\#\#} instead of \code{\#} to reference command parameters.
\end{important}
-This lack of flexibility in \cs{glsfirst} can be demonstrated with
-the following document:
-\begin{verbatim}
-\documentclass{article}
+\paragraph{Suffix and Fonts}
+These are the generic suffix and font commands that vary according
+to the abbreviation style. The style should provide the appropriate
+definitions. The suffix should always be provided. The font commands
+are only required if the style applies any font formatting to either
+the long or short form.
+
+\cmddef{abbrvpluralsuffix}
+The plural suffix for the short form. For example, the
+\abbrstyle{long-short} style defines this to just use
+\gls{glsxtrabbrvpluralsuffix}, but the smallcaps styles, such as
+\abbrstyle{long-short-sc} define this to \gls{glsxtrscsuffix} in
+order to counteract the small caps font.
+
+\cmddef{glsfirstabbrvfont}
+The font formatting command for the short form on \idx{firstuse}. For example, the
+\abbrstyle{long-short-sc} style has:
+\begin{codebox}
+\cmd{renewcommand}*\gls{glsfirstabbrvfont}\oarg{1}\marg{\gls{glsfirstabbrvscfont}\marg{\#\#1}}
+\end{codebox}
+
+\cmddef{glsabbrvfont}
+The font formatting command for the short form. For example, the
+\abbrstyle{long-short-sc} style has:
+\begin{codebox}
+\cmd{renewcommand}*\gls{glsabbrvfont}\oarg{1}\marg{\gls{glsabbrvscfont}\marg{\#\#1}}
+\end{codebox}
+
+\cmddef{glsxtrrevert}
+This command is designed to counteract the effect of
+\gls{glsabbrvfont} if, for some reason, it shouldn't be applied to
+part of the abbreviation. For example, you may prefer not to have
+digits reduced with the smaller (\qt{sm}) styles.
+
+\cmddef{glsfirstlongfont}
+The font formatting command for the long form on \idx{firstuse}. For example, the
+\abbrstyle{long-short-sc} style has:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glsfirstlongfont}}[1]\marg{\gls{glsfirstlongdefaultfont}\marg{\#\#1}}
+\end{codebox}
+
+\cmddef{glslongfont}
+The font formatting command for the long form. For example, the
+\abbrstyle{long-short-sc} style has:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glslongfont}}[1]\marg{\gls{glslongdefaultfont}\marg{\#\#1}}
+\end{codebox}
+
+\paragraph{First Use Display Format}
+These commands always need to be provided.
+
+\cmddef{glsxtrfullformat}
+The singular \idx{displayfullform} used on the \idx{firstuse} of
+\gls{gls}.
+
+\cmddef{glsxtrfullplformat}
+The plural \idx{displayfullform} used on the \idx{firstuse} of
+\gls{glspl}.
+
+\cmddef{Glsxtrfullformat}
+The \idx{sentencecase} singular \idx{displayfullform} used on the \idx{firstuse} of
+\gls{Gls}.
+
+\cmddef{Glsxtrfullplformat}
+The \idx{sentencecase} plural \idx{displayfullform} used on the \idx{firstuse} of
+\gls{Glspl}.
+
+\cmddef{GLSxtrfullformat}
+The \idx{allcaps} singular \idx{displayfullform} used on the \idx{firstuse} of
+\gls{GLS}.
+
+\cmddef{GLSxtrfullplformat}
+The \idx{allcaps} plural \idx{displayfullform} used on the \idx{firstuse} of
+\gls{GLSpl}.
+
+\paragraph{Subsequent Use Display Format}
+These commands only need to be provided if the \idx{glslike}
+commands don't simply show the short form.
+
+\cmddef{glsxtrsubsequentfmt}
+The singular form for \idx{subsequentuse} of \gls{gls}.
+
+\cmddef{glsxtrsubsequentplfmt}
+The plural form for \idx{subsequentuse} of \gls{glspl}.
+
+\cmddef{Glsxtrsubsequentfmt}
+The \idx{sentencecase} singular form for \idx{subsequentuse} of \gls{Gls}.
+
+\cmddef{Glsxtrsubsequentplfmt}
+The \idx{sentencecase} plural form for \idx{subsequentuse} of
+\gls{Glspl}.
+
+\cmddef{GLSxtrsubsequentfmt}
+The \idx{allcaps} singular form for \idx{subsequentuse} of \gls{GLS}.
+
+\cmddef{GLSxtrsubsequentplfmt}
+The \idx{allcaps} plural form for \idx{subsequentuse} of \gls{GLSpl}.
+
+The defaults all show the short form and insert encapsulated with
+the \idx{innerformatting} \gls{glsxtrgenentrytextfmt} and
+\gls{glsabbrvfont}. The purpose of the \idx{innerformatting} is to get it
+as close as possible to the actual text so \gls{glsabbrvfont} is
+placed outside of \gls{glsxtrgenentrytextfmt}.
+
+The \catattr{markshortwords} attribute complicates matters as it
+inserts \gls{glsxtrword} and \gls{glsxtrwordsep} into the actual
+field value. In that case, the \idx{innerformatting} is within
+\gls{glsxtrword} and \gls{glsxtrwordsep}, so only the insert
+material needs to be formatted.
+
+If a custom style doesn't need to support \glsopt{innertextformat}
+or \gls{ifglsxtrinsertinside}, it can reduce the complexity by
+omitting the \idx{innerformatting} and conditionals, but this lack of
+support should be documented if the style is made generally
+available.
-\usepackage{glossaries-extra}
-\setabbreviationstyle{footnote}
-\newabbreviation{ex}{EX}{Example}
+\cmddef{glsxtrdefaultsubsequentfmt}
+The default singular form for \idx{subsequentuse} of \gls{gls}.
-\begin{document}
-Compare \gls{ex}['s] with \glsfirst{ex}['s].
-\end{document}
-\end{verbatim}
-The \gls{firstuse} \cs{gls} has the footnote marker after the
-inserted material \qt{EX's\textsuperscript{1}} but \cs{glsfirst} has
-it before the inserted material \qt{EX\textsuperscript{1}'s} which
-is inappropriate. Note that if the style is changed to
-\abbrstyle{postfootnote}, the footnote marker appears after the
-inserted material as \ics{footnote} is in the post-link hook.
-
-There are some instances where \cs{glstext} can be useful. It's used
-internally by \ics{glsfmttext}, which in turn is used by
-\ics{glsseelistformat} if the entry has a short form. If
-\cs{glsfmtshort} is used, this enforces the short form, but if
-\cs{glsfmttext} is used, then the long form will be used for the
-\qt{noshort} styles, which is more appropriate. In this particular
-situation, there's no need to worry about inserted material as the
-final optional argument isn't supported by \cs{glsfmttext}.
-
-Abbreviations include acronyms (words formed from initial letters,
-such as \qt{laser}),
-initialisms (initial letters of a phrase, such as \qt{html}, that
-aren't pronounced as words) and contractions (where
-parts of words are omitted, often replaced by an apostrophe, such as
-\qt{don't}).
-The \qt{acronym} code provided by the \styfmt{glossaries} package is
-misnamed as it's more often than not used for initialisms instead.
-Acronyms tend not to be \emph{expanded} on \gls{firstuse} (although they may
-need to be \emph{described} for readers unfamiliar with the term). They are therefore more like a regular term,
-which may or may not require a description in the glossary.
-
-The \styfmt{glossaries-extra} package corrects this misnomer, and
-provides better abbreviation handling, with
-\begin{definition}[\DescribeMacro\newabbreviation]
-\cs{newabbreviation}\oarg{options}\marg{label}\marg{short}\marg{long}
-\end{definition}
-
-This sets the \gloskey{category} key to \texttt{abbreviation} by
-default, but that value may be overridden in \meta{options}.
-The category may have attributes that modify the way abbreviations
-are defined. For example, the \catattr{insertdots} attribute will
-automatically insert full stops (periods) into \meta{short} or the
-\catattr{noshortplural} attribute will set the default value
-of the \gloskey{shortplural} key to just \meta{short} (without
-appending the plural suffix). See \sectionref{sec:categories} for
-further details.
+\cmddef{glsxtrdefaultsubsequentplfmt}
+The default plural form for \idx{subsequentuse} of \gls{glspl}.
-See \sectionref{sec:nested} regarding the pitfalls of using
-commands like \ics{gls} or \ics{glsxtrshort} within
-\meta{short} or \meta{long}.
+\cmddef{Glsxtrdefaultsubsequentfmt}
+The default \idx{sentencecase} singular form for \idx{subsequentuse} of \gls{Gls}.
-\begin{important}
-Make sure that you set the category attributes before defining new
-abbreviations or they may not be correctly applied.
-\end{important}
+\cmddef{Glsxtrdefaultsubsequentplfmt}
+The default \idx{sentencecase} plural form for \idx{subsequentuse}
+of \gls{Glspl}.
-The \ics{newacronym} command provided by the \styfmt{glossaries}
-package is redefined by \styfmt{glossaries-extra} to use
-\cs{newabbreviation} with the \gloskey{category} set to
-\texttt{acronym} (see also \sectionref{sec:acronymmods}) so
-\begin{definition}[\DescribeMacro\newacronym]
-\cs{newacronym}\oarg{options}\marg{label}\marg{short}\marg{long}
-\end{definition}
-is now equivalent to
-\begin{display}\raggedright\ttfamily
-\cs{newabbreviation}[type=\cs{acronymtype},category=acronym,\meta{options}]\marg{label}\marg{short}\marg{long}
-\end{display}
-
-\begin{sloppypar}
-The \cs{newabbreviation} command is superficially similar to the
-\styfmt{glossaries} package's \cs{newacronym} but you can apply
-different styles to different categories. The default style is
-\abbrstyle{short-nolong} for entries in the \category{acronym} category and
-\abbrstyle{short-long} for entries in the \category{abbreviation}
-category. (These aren't the same as the acronym styles provided by
-the \styfmt{glossaries} package, although they may produce similar
-results.)
-\end{sloppypar}
-
-The way the abbreviations are displayed by commands like \cs{gls}
-varies according to the abbreviation style. The styles are set
-according to the entry's category so, unlike the base
-\styfmt{glossaries} package, you can have different abbreviation
-styles within the same glossary.
-
-There are two types of full forms. The display full form, which is
-used on \gls{firstuse} by commands like \ics{gls} and the inline full
-form, which is used by commands like \ics{glsxtrfull}.
-For some of the abbreviation styles, such as \abbrstyle{long-short}, the display and inline forms
-are the same. In the case of styles such as \abbrstyle{short-nolong} or
-\abbrstyle{short-footnote}, the display and inline full forms are different.
-
-These formatting commands aren't stored in the \gloskey{short},
-\gloskey{shortplural}, \gloskey{long} or \gloskey{longplural}
-fields, which means they won't be used within commands like
-\cs{glsentryshort} (but they are used within commands like
-\cs{glsxtrshort} and \cs{glsfmtshort}).
-Note that \ics{glsxtrlong} and the case-changing variants don't use
-\cs{glsfirstlongfont}.
-
-You can apply the formatting command used for the short form
-to some arbitrary text using
-\begin{definition}[\DescribeMacro\glsuseabbrvfont]
-\cs{glsuseabbrvfont}\marg{text}\marg{category}
-\end{definition}
-where \meta{category} is the category label that identifies
-the abbreviation style. Similarly for the formatting command
-use by the long form:
-\begin{definition}[\DescribeMacro\glsuselongfont]
-\cs{glsuselongfont}\marg{text}\marg{category}
-\end{definition}
-
-You can't use the acronym commands provided by the base package with
-the new abbreviations provided by the \styfmt{glossaries-extra}
-package. The style commands that replace \cs{setacronymstyle},
-\cs{acrshort} etc are described in \sectionref{sec:abbrstyle}.
-The \pkgopt{acronymlists} package option and associated commands
-aren't supported. The \ics{forallacronyms} command, which iterates
-over all acronym lists, should be replaced with:
-\begin{definition}[\DescribeMacro\forallabbreviationlists]
-\cs{forallabbreviationlists}\marg{cs}\marg{body}
-\end{definition}
+\cmddef{GLSxtrdefaultsubsequentfmt}
+The default \idx{allcaps} singular form for \idx{subsequentuse} of \gls{GLS}.
-\section{Tagging Initials}
-\label{sec:tagging}
+\cmddef{GLSxtrdefaultsubsequentplfmt}
+The default \idx{allcaps} plural form for \idx{subsequentuse} of
+\gls{GLSpl}.
-If you would like to tag the initial letters in the long form
-such that those letters are underlined in the glossary but
-not in the main part of the document, you can use
-\begin{definition}[\DescribeMacro\GlsXtrEnableInitialTagging]
-\cs{GlsXtrEnableInitialTagging}\marg{categories}\marg{cs}
-\end{definition}
-before you define your abbreviations.
+\paragraph{Inline Full Format}
+These commands only need to be provided if the \idx{inlinefullform}
+is different from the \idx{displayfullform}.
-This command (robustly) defines \meta{cs} (a control sequence)
-to accept a single argument, which is the letter (or letters)
-that needs to be tagged. The normal behaviour of this command
-within the document is to simply do its argument, but in the
-glossary it's activated for those categories that have
-the \catattr{tagging} attribute set to \qt{true}. For those
-cases it will use
-\begin{definition}[\DescribeMacro\glsxtrtagfont]
-\cs{glsxtrtagfont}\marg{text}
-\end{definition}
-This command defaults to \ics{underline}\marg{text}
-but may be redefined as required.
+\cmddef{glsxtrinlinefullformat}
+The singular full form of \gls{glsxtrfull}.
-The control sequence \meta{cs} can't already be defined when
-used with the unstarred version of
-\cs{GlsXtrEnableInitialTagging} for safety reasons.
-The starred version will overwrite any previous definition
-of \meta{cs}. As with redefining any commands, ensure that
-you don't redefine something important. In fact, just forget
-the existence of the starred version and let's pretend I didn't
-mention it.
+\cmddef{glsxtrinlinefullplformat}
+The plural full form of \gls{glsxtrfullpl}.
-The first argument of \cs{GlsXtrEnableInitialTagging} is a
-comma-separated list of category names. The \catattr{tagging}
-attribute will automatically be set for those categories.
-You can later set this attribute for other categories (see
-\sectionref{sec:categories}) but this must be done before the
-glossary is displayed.
+\cmddef{Glsxtrinlinefullformat}
+The \idx{sentencecase} singular full form of \gls{Glsxtrfull}.
-The accompanying sample file \nolinkurl{sample-mixtures.tex}
-uses initial tagging for both the \category{acronym} and
-\category{abbreviation} categories:
-\begin{verbatim}
-\GlsXtrEnableInitialTagging{acronym,abbreviation}{\itag}
-\end{verbatim}
-This defines the command \cs{itag} which can be used in the
-definitions. For example:
-\begin{verbatim}
-\newacronym
- [description={a system for detecting the location and
- speed of ships, aircraft, etc, through the use of radio
- waves}% description of this term
- ]
- {radar}% identifying label
- {radar}% short form (i.e. the word)
- {\itag{ra}dio \itag{d}etection \itag{a}nd \itag{r}anging}
+\cmddef{Glsxtrinlinefullplformat}
+The \idx{sentencecase} plural full form of \gls{Glsxtrfullpl}.
-\newabbreviation{xml}{XML}
- {e\itag{x}tensible \itag{m}arkup \itag{l}anguage}
-\end{verbatim}
-The underlining of the tagged letters only occurs in the
-glossary and then only for entries with the \catattr{tagging}
-attribute set.
+\cmddef{GLSxtrinlinefullformat}
+The \idx{allcaps} singular full form of \gls{GLSxtrfull}.
-\section{Abbreviation Styles}
-\label{sec:abbrstyle}
+\cmddef{GLSxtrinlinefullplformat}
+The \idx{allcaps} plural full form of \gls{GLSxtrfullpl}.
-The abbreviation style must be set before abbreviations are defined
-using:
-\begin{definition}[\DescribeMacro\setabbreviationstyle]
-\cs{setabbreviationstyle}\oarg{category}\marg{style-name}
-\end{definition}
-where \meta{style-name} is the name of the style and \meta{category}
-is the category label (\texttt{abbreviation} by default). New
-abbreviations will pick up the current style according to their
-given category. If there is no style set for the category, the
-fallback is the style for the \texttt{abbreviation} category.
-Some styles may automatically modify one or more of the attributes
-associated with the given category. For example, the
-\abbrstyle{long-noshort} and \abbrstyle{short-nolong} styles set the
-\catattr{regular} attribute to \texttt{true}.
+\paragraph{Wrapper Commands}
+These are commands that can be used in the definitions of the above
+to ensure that the appropriate accessibility fields and inner
+formatting is supported.
-\begin{important}
-If you want to apply different styles to groups of abbreviations,
-assign a different category to each group and set the style for the
-given category.
-\end{important}
+\cmddef{glsxtrlongformat}
+This command is used in the definition of \gls{glsxtrlong} in some
+of the predefined abbreviation styles to format the \gloskey{long}
+value of the entry identified by \meta{entry-label} with the command
+\meta{fmt-cs}, which should take one argument.
-Note that \ics{setacronymstyle} is disabled by
-\styfmt{glossaries-extra}. Use
-\begin{alltt}
-\cs{setabbreviationstyle}[acronym]\marg{style-name}
-\end{alltt}
-instead. The original acronym interface can be restored with
-\ics{RestoreAcronyms} (see \sectionref{sec:acronymmods}). However the
-original acronym interface is incompatible with all the commands
-described here.
-
-Abbreviations can be used with the standard \styfmt{glossaries}
-commands, such as \ics{gls}, but don't use the acronym commands
-like \ics{acrshort} (which use \ics{acronymfont}). The short form can be
-produced with:
-\begin{definition}[\DescribeMacro\glsxtrshort]
-\cs{glsxtrshort}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-(Use this instead of \ics{acrshort}.)
-
-The long form can be produced with
-\begin{definition}[\DescribeMacro\glsxtrlong]
-\cs{glsxtrlong}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-(Use this instead of \ics{acrlong}.)
-
-The \emph{inline} full form can be produced with
-\begin{definition}[\DescribeMacro\glsxtrfull]
-\cs{glsxtrfull}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-(This this instead of \ics{acrfull}.)
+Accessibility support is implemented with \gls{glsaccesslong} if the
+\catattr{markwords} attribute is true otherwise with
+\gls{glsaccessfmtlong} using \gls{glsxtrgenentrytextfmt} for the
+\idx{innerformatting}.
-\begin{important}
-In general, it's best not to use commands like \ics{glsfirst}
-for abbreviations, especially if you use the \meta{insert}
-optional argument. Use either \cs{gls} (possibly with a reset)
-or \cs{glsxtrfull}.
-\end{important}
+This is then encapsulated (including or excluding the \meta{insert},
+according to \gls{ifglsxtrinsertinside}) with \meta{fmt-cs}. If the
+\meta{insert} content needs to be placed outside of \meta{fmt-cs}, it
+will be individually encapsulated with the \idx{innerformatting}.
-As mentioned earlier, the inline full form may not necessarily match the format used on
-\gls{firstuse} with \cs{gls}. For example, the
-\abbrstyle{short-nolong} style
-only displays the short form on \gls{firstuse}, but the full
-form will display the long form followed by the short form in
-parentheses.
+\cmddef{Glsxtrlongformat}
+As above, but \idx{sentencecase}.
+
+\cmddef{GLSxtrlongformat}
+As above, but \idx{allcaps}.
+
+\cmddef{glsxtrlongplformat}
+As \gls{glsxtrlongformat}, but for the \gloskey{longplural} field.
+
+\cmddef{Glsxtrlongplformat}
+As above, but \idx{sentencecase}.
+
+\cmddef{GLSxtrlongplformat}
+As above, but \idx{allcaps}.
+
+\cmddef{glsxtrlongformatgrp}
+As \gls{glsxtrlongformat}, but adds grouping around \meta{insert}
+(with the \idx{innerformatting} inside the group).
+
+\cmddef{Glsxtrlongformatgrp}
+As above, but \idx{sentencecase}.
+
+\cmddef{GLSxtrlongformatgrp}
+As above, but \idx{allcaps}.
+
+\cmddef{glsxtrlongplformatgrp}
+As \gls{glsxtrlongplformat}, but adds grouping around \meta{insert}
+(with the \idx{innerformatting} inside the group).
+
+\cmddef{Glsxtrlongplformatgrp}
+As above, but \idx{sentencecase}.
+
+\cmddef{GLSxtrlongplformatgrp}
+As above, but \idx{allcaps}.
+
+\cmddef{glsxtrshortformat}
+This command is used in the definition of \gls{glsxtrshort} and in
+some of the predefined abbreviation styles to format the
+\gloskey{short} value of the entry identified by \meta{entry-label}
+with the command \meta{fmt-cs}, which should take one argument.
+
+Accessibility support is implemented with \gls{glsaccessshort} if the
+\catattr{markshortwords} attribute is true otherwise with
+\gls{glsaccessfmtshort} using \gls{glsxtrgenentrytextfmt} for the
+\idx{innerformatting}.
+
+This is then encapsulated (including or excluding the \meta{insert},
+according to \gls{ifglsxtrinsertinside}) with \meta{fmt-cs}. If the
+\meta{insert} content needs to be placed outside of \meta{fmt-cs}, it
+will be individually encapsulated with the \idx{innerformatting}.
+
+\cmddef{Glsxtrshortformat}
+As above, but \idx{sentencecase}.
+
+\cmddef{GLSxtrshortformat}
+As above, but \idx{allcaps}.
+
+\cmddef{glsxtrshortplformat}
+As \gls{glsxtrshortformat}, but for the \gloskey{shortplural} field.
+
+\cmddef{Glsxtrshortplformat}
+As above, but \idx{sentencecase}.
+
+\cmddef{GLSxtrshortplformat}
+As above, but \idx{allcaps}.
+
+\cmddef{glsxtrshortformatgrp}
+As \gls{glsxtrshortformat}, but adds grouping around \meta{insert}
+(with the \idx{innerformatting} inside the group).
+
+\cmddef{Glsxtrshortformatgrp}
+As above, but \idx{sentencecase}.
+
+\cmddef{GLSxtrshortformatgrp}
+As above, but \idx{allcaps}.
+
+\cmddef{glsxtrshortplformatgrp}
+As \gls{glsxtrshortplformat}, but adds grouping around \meta{insert}
+(with the \idx{innerformatting} inside the group).
+
+\cmddef{Glsxtrshortplformatgrp}
+As above, but \idx{sentencecase}.
+
+\cmddef{GLSxtrshortplformatgrp}
+As above, but \idx{allcaps}.
+
+\cmddef{glsxtrlongshortformat}
+A shortcut designed for \meta{long} (\meta{short}) styles. This is
+defined as:
+\begin{codebox}
+\gls{glsxtrlongformat}\margm{entry-label}\margm{insert}\margm{long-fmt-cs}%
+\gls{glsxtrfullsep}\margm{entry-label}%
+\gls{glsxtrparen}\margm{\gls{glsxtrshortformat}\margm{entry-label}\marg{}\margm{short-fmt-cs}}%
+\end{codebox}
+Note that the \meta{insert} is only placed after the long form.
+
+\cmddef{Glsxtrlongshortformat}
+As above, but \idx{sentencecase}.
+
+\cmddef{GLSxtrlongshortformat}
+As above, but \idx{allcaps}.
+
+\cmddef{glsxtrlongshortplformat}
+As \gls{glsxtrlongshortformat} but uses the plural versions \gls{glsxtrlongplformat}
+and \gls{glsxtrshortplformat}.
+
+\cmddef{Glsxtrlongshortplformat}
+As above, but \idx{sentencecase}.
+
+\cmddef{GLSxtrlongshortplformat}
+As above, but \idx{allcaps}.
+
+\cmddef{glsxtrshortlongformat}
+A shortcut designed for \meta{short} (\meta{long}) styles. This is
+defined as:
+\begin{codebox}
+\gls{glsxtrshortformat}\margm{entry-label}\margm{insert}\margm{short-fmt-cs}%
+\gls{glsxtrfullsep}\margm{entry-label}%
+\gls{glsxtrparen}\margm{\gls{glsxtrlongformat}\margm{entry-label}\marg{}\margm{long-fmt-cs}}%
+\end{codebox}
+Note that the \meta{insert} is only placed after the short form.
+
+The syntax is the same as for \gls{glsxtrlongshortformat} even
+though \gls{glsxtrlongformat} and \gls{glsxtrshortformat} are
+flipped within the definition.
+
+\cmddef{Glsxtrshortlongformat}
+As above, but \idx{sentencecase}.
+
+\cmddef{GLSxtrshortlongformat}
+As above, but \idx{allcaps}.
+
+\cmddef{glsxtrshortlongplformat}
+As \gls{glsxtrshortlongformat} but uses the plural versions
+\gls{glsxtrshortplformat} and \gls{glsxtrlongplformat}.
+
+\cmddef{Glsxtrshortlongplformat}
+As above, but \idx{sentencecase}.
+
+\cmddef{GLSxtrshortlongplformat}
+As above, but \idx{allcaps}.
+
+\section{Restoring Base Acronym Mechanism}
+\label{sec:acrorevert}
+
+It's possible to revert \gls{newacronym} back to the definition
+provided by the base \sty{glossaries} package. However, if you do
+this, you will lose all the abbreviation features provided by
+\sty{glossaries-extra}.
\begin{important}
-If you want to use an abbreviation in a chapter or section
-title, use the commands described in \sectionref{sec:headtitle}
-instead.
+Where possible, avoid this. If you're simply trying to make the long form appear
+on \idx{firstuse} with \gls{newacronym}, set the abbreviation style using:
+\begin{codebox}
+\gls{setabbreviationstyle}\oarg{acronym}\marg{long-short}
+\end{codebox}
\end{important}
-The arguments \meta{options}, \meta{label} and \meta{insert} are the
-same as for commands such as \cs{glstext}. There are also analogous
-case-changing commands:
-
-First letter upper case short form:
-\begin{definition}[\DescribeMacro\Glsxtrshort]
-\cs{Glsxtrshort}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-
-First letter upper case long form:
-\begin{definition}[\DescribeMacro\Glsxtrlong]
-\cs{Glsxtrlong}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-
-First letter upper case inline full form:
-\begin{definition}[\DescribeMacro\Glsxtrfull]
-\cs{Glsxtrfull}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-
-All upper case short form:
-\begin{definition}[\DescribeMacro\Glsxtrshort]
-\cs{GLSxtrshort}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-
-All upper case long form:
-\begin{definition}[\DescribeMacro\Glsxtrlong]
-\cs{GLSxtrlong}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-
-All upper case inline full form:
-\begin{definition}[\DescribeMacro\GLSxtrfull]
-\cs{GLSxtrfull}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-
-Plural forms are also available.
-
-Short form plurals:
-\begin{definition}[\DescribeMacro\glsxtrshortpl]
-\cs{glsxtrshortpl}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-\begin{definition}[\DescribeMacro\Glsxtrshortpl]
-\cs{Glsxtrshortpl}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-\begin{definition}[\DescribeMacro\GLSxtrshortpl]
-\cs{GLSxtrshortpl}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-
-Long form plurals:
-\begin{definition}[\DescribeMacro\glsxtrlongpl]
-\cs{glsxtrlongpl}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-\begin{definition}[\DescribeMacro\Glsxtrlongpl]
-\cs{Glsxtrlongpl}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-\begin{definition}[\DescribeMacro\GLSxtrlongpl]
-\cs{GLSxtrlongpl}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-
-Full form plurals:
-\begin{definition}[\DescribeMacro\glsxtrfullpl]
-\cs{glsxtrfullpl}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-\begin{definition}[\DescribeMacro\Glsxtrfullpl]
-\cs{Glsxtrfullpl}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-\begin{definition}[\DescribeMacro\GLSxtrfullpl]
-\cs{GLSxtrfullpl}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
+If you really need to use the original base \sty{glossaries} package's acronym
+mechanism, it's better to stick with just \sty{glossaries} and not use
+\sty{glossaries-extra}. However, it may be that you need to use a
+\sty{glossaries-extra} feature, such as \gls{printunsrtglossary}, but you have a
+custom acronym style that you can't implement using the \sty{glossaries-extra}
+abbreviation mechanism. This is a rare edge case for unusual formats, as it should be
+possible to implement most common abbreviation formats using the
+predefined styles.
+
+\begin{warning}
+Unpredictable results will occur if \gls{RestoreAcronyms} or
+\gls{MakeAcronymsAbbreviations} are used after abbreviations or
+acronyms have been defined.
+\end{warning}
+
+\cmddef{RestoreAcronyms}
+Restores \gls{newacronym} back to the original base \sty{glossaries}
+interface. Note that this doesn't affect \gls{newabbreviation}.
+It also sets the \catattr{regular} attribute for the \cat{acronym}
+category to \code{false} and sets the acronym style to
+\code{long-short} (which is the default for the base package).
+
+The display style for each \idx{glossary} identified in the acronym lists
+is switched to the default acronym display style.
+
+\cmddef{MakeAcronymsAbbreviations}
+Counteracts \gls{RestoreAcronyms}.
+
+\chapter{Referencing (Using) Entries}
+\label{sec:glsref}
+
+Entries can be referenced using the \idx{glslike} and \idx{glstextlike}
+commands, as described in the base \sty{glossaries} manual. There are some
+additional commands provided by \sty{glossaries-extra}:
+\begin{itemize}
+\item abbreviation commands, such as \gls{glsxtrshort}
+ (see \sectionref{sec:abbreviations});
+\item commands for use in captions or section headings, such as
+\gls{glsfmttext} (see \sectionref{sec:headingcommands});
+\item commands, such as \gls{glsxtrp}, designed for use within
+fields to help mitigate the problems of nesting (see
+\sectionref{sec:nested});
+\item commands, such as \gls{mgls}, that are designed for
+referencing multi (or compound) entries (see
+\sectionref{sec:multientries});
+\item commands, such as \gls{glsaccessname}, used to incorporate
+accessibility support (see \sectionref{sec:glsaccessfield});
+\item commands, such as \gls{dgls}, that are designed for
+\app{bib2gls}['s] dual entries (see \sectionref{sec:dgls});
+\item commands, such as \gls{rgls}, that depend on the number of
+entry records (see \sectionref{sec:recordcount}).
+\end{itemize}
+Additionally, the entry counting commands, such as \gls{cgls},
+provided by the base \sty{glossaries} package are modified by
+\sty{glossaries-extra} (see \sectionref{sec:entrycount}).
+
+The \idx{glslike} commands are designed to produce text at that
+point in the document (the \idx{linktext},
+\sectionref{sec:entryfmtmods}), index the entry (to ensure that it
+appears in the glossary, \sectionref{sec:wrglossary}) and unset the
+\idx{firstuseflag} (which can alter the \idx{linktext},
+\sectionref{sec:glsunset}). Additional information can be appended
+automatically with the \idx{postlinkhook}
+(\sectionref{sec:postlinkhook}). The \idx{linktext} is given by the
+entry style (see \sectionref{sec:entryfmt}) or by the final argument
+of \gls{glsdisp}.
+
+The \idx{glstextlike} commands are designed to produce text at that
+point in the document (the \idx{linktext},
+\sectionref{sec:entryfmtmods}) and index the entry (to ensure that
+it appears in the glossary, \sectionref{sec:wrglossary}). Additional
+information can be appended automatically with the
+\idx{postlinkhook} (\sectionref{sec:postlinkhook}). The
+\idx{linktext} is determined by the calling command. For example,
+the corresponding field value (possibly encapsulated with
+\gls{glsxtrregularfont} and the inner formatting) for commands like
+\gls{glstext} or the final argument of \gls{glslink}.
+
+The \idx{glslike} and \idx{glstextlike} commands can all be used
+with a star (\code{*}) or plus (\code{+}) modifier. The star
+modifier automatically implements \glsoptval{hyper}{false}
+(disables the hyperlink) and the plus modifier automatically
+implements \glsoptval{hyper}{true} (forces the hyperlink on, if
+supported).
+
+With \sty{glossaries-extra}, it's possible to define an additional
+modifier for your own use with:
+\cmddef{GlsXtrSetAltModifier}
+The \meta{token} must be a single token, so a multi-byte \idx{utf8}
+character will required a native Unicode engine (\XeLaTeX\ or \LuaLaTeX).
+For example, the following:
+\begin{codebox}
+\gls{GlsXtrSetAltModifier}\marg{!}\marg{\glsoptval{format}{glsignore}}
+\end{codebox}
+means that \code{\gls{gls}!\margm{label}} will be equivalent to
+\code{\gls{gls}\oarg{\glsoptval{format}{glsignore}}\margm{label}}.
+
+It's also possible to redefine the star and plus modifiers:
+\cmddef{GlsXtrSetStarModifier}
+This sets the options to use for the star modifier.
+\cmddef{GlsXtrSetPlusModifier}
+This sets the options to use for the plus modifier.
+For example, the following:
+\begin{codebox}
+\gls{GlsXtrSetPlusModifier}\marg{\glsopt{noindex}}
+\end{codebox}
+means that the star modifier will now suppress \idx{indexing}
+instead of switching on the hyperlink.
+
+The \idx{glslike} and \idx{glstextlike} commands have a complicated
+internal structure, which can be viewed as a series of layers. The
+outermost common layer is:
+\begin{compactcodebox}
+\comment{save settings}
+\comment{initialise options, see \sectionref{sec:glsopts}}
+\gls{glslinkwrcontent}\margm{index \& fmt content}
+\comment{restore settings}
+\comment{\idx{postlinkhook}, see \sectionref{sec:postlinkhook}}
+\end{compactcodebox}
+The \meta{index \& fmt content} consists of the \idx{indexing}
+(see \sectionref{sec:wrglossary}) and the (possibly
+hyperlinked) formatted text, see \sectionref{sec:entryfmtmods}. The
+\meta{index \& fmt content} code is encapsulated with:
+\cmddef{glslinkwrcontent}
+In v1.48, this was added to scope the \idx{linktext} and
+\idx{indexing} code, which helped to prevent unwanted spacing caused
+by the \idx{whatsit} and also helped to
+prevent some setting leakage, in the event of nesting (see
+\sectionref{sec:nested}), but this caused spacing issues when used in
+math mode, so from v1.49 this command now simply does its argument.
+The \idx{whatsit} is now scoped with \gls{glsencapwrcontent} instead.
+
+The \gls{glsxtrp} command, designed for nested use, deals
+with the problem by suppressing the \idx{postlinkhook} and adding an
+outer group. For example,
+\code{\gls{glsxtrp}\marg{short}\marg{html}} behaves like:
+\begin{compactcodebox}
+\marg{\gls{let}\gls{glspostlinkhook}\gls{relax}
+ \gls{glsxtrshort}\oarg{noindex,nohyper}\marg{html}}
+\end{compactcodebox}
+
+Depending on the settings (the \glsopt{wrgloss} option or the
+\catattr{wrgloss} attribute), the indexing may come before the text:
+\begin{compactcodebox}
+\gls{glslinkwrcontent}\marg{\meta{index}\meta{fmt content}}
+\end{compactcodebox}
+or after the text:
+\begin{compactcodebox}
+\gls{glslinkwrcontent}\marg{\meta{fmt content}\meta{index}}
+\end{compactcodebox}
+or may be suppressed with \glsopt{noindex}:
+\begin{compactcodebox}
+\gls{glslinkwrcontent}\marg{\meta{fmt content}}
+\end{compactcodebox}
+The \meta{fmt content} part is described in
+\sectionref{sec:entryfmtmods}. The \meta{index} part is the actual
+\idx{indexing} (see \sectionref{sec:wrglossary}) but also increments
+the index count, if applicable. Both the associated \idx{whatsit} and
+increment are encapsulated with \gls{glsencapwrcontent}.
\begin{important}
-Be careful about using \cs{glsentryfull}, \cs{Glsentryfull},
-\cs{glsentryfullpl} and \cs{Glsentryfullpl}. These commands will use
-the currently applied style rather than the style in use when the
-entry was defined. If you have mixed styles, you'll need to use
-\ics{glsxtrfull} instead. Similarly for \cs{glsentryshort} etc.
+Avoid using \gls{glstext}, \gls{glsplural}, \gls{glsfirst} and
+\gls{glsfirstplural} (and their case-changing variants) with
+entries that have been defined with \gls{newabbreviation}. Some of the abbreviation
+styles are too complicated to work with those commands. Instead, use
+commands like \gls{glsxtrshort}, \gls{glsxtrfull} or use \gls{gls}
+with the \glsopt{prereset} or \glsopt{preunset} options.
\end{important}
-\section{Shortcut Commands}
-\label{sec:abbrshortcuts}
+The base \sty{glossaries} package provides a way to adjust the
+formatting of the \idx{linktext} for the \idx{glslike} commands
+according to the glossary type with \gls{defglsentryfmt}. The
+\sty{glossaries-extra} package changes the default entry formatting
+(\sectionref{sec:entryfmt}) and provides additional ways of
+modifying the displayed content (\sectionref{sec:entryfmtmods}).
+
+The heading commands (described in \sectionref{sec:headtitle}) are
+designed to prevent indexing or changes to the \idx{firstuseflag} if
+they appear in the table of contents (or list of figures, etc) or if
+they appear in the page header.
+
+Although the base \sty{glossaries} package warns against nested
+\idx{linktext}, the \sty{glossaries-extra} package provides
+\gls{glsxtrp} which can be used instead of \gls{gls} in field values
+to overcome some of the associated problems.
+See \sectionref{sec:nested} for further details.
+
+If you need to simply access a \idx{field} value without any formatting,
+see \sectionref{sec:getfields}. (See \sectionref{sec:setfields} to
+set \idx{field} values.) If you want to encapsulate the value with
+the appropriate accessibility tag, see \sectionref{sec:glsaccessfield}.
+
+Commands such as \gls{glsadd} (see \sectionref{sec:wrglossary}) and
+\gls{glssee} (see \sectionref{sec:xr}) are designed to only index (to
+ensure the entry appears in the glossary) without producing any text or changing
+the \idx{firstuseflag}.
+
+The \idx{glslike}, \idx{glstextlike} and \gls{glsadd} commands all have an initial
+optional argument that can be used to override the default actions.
+Some options are only applicable for particular subsets of
+referencing commands. For example, \glsopt{noindex} is pointless for
+\gls{glsadd} since the sole purpose of that command is to index.
+Whereas \glsopt{types} is only available with \gls{glsaddall}.
+
+\section{Options}
+\label{sec:glsopts}
+
+\glsadd[format=(]{idx.glsopt}%
+Some options are provided by the base \sty{glossaries} package, but
+there are some additional options provided by
+\sty{glossaries-extra}, which are listed in \sectionref{sec:xtrglsopts}.
+Below, \meta{option-list} indicates the options that are passed in
+the optional argument of the calling command (such as \gls{gls}).
+
+The order that the options are applied is:
+\begin{enumerate}
+\item \glsopt{prereset}, \glsopt{preunset} and \glsopt{postunset} options are
+initialised by \gls{glsinitreunsets};
+\item \glsopt{hyper} is initialised by \gls{glsxtrchecknohyperfirst}
+(\gls{glsfirst}-like only);
+\item \glsopt{wrgloss} option is initialised by \gls{glsxtrinitwrgloss}
+(not implemented by \gls{glsadd} or \gls{glsxtrfmt});
+\item \glsopt{hyperoutside} option is initialised by
+\gls{glsxtrinithyperoutside} (not implemented by \gls{glsadd}
+or \gls{glsxtrfmt});
+\item initialise \glsoptval{noindex}{false} (not \gls{glsadd});
+\item options identified by \gls{GlsXtrSetDefaultGlsOpts},
+\gls{GlsXtrAppToDefaultGlsOpts} or \gls{GlsXtrPreToDefaultGlsOpts} (not
+implemented by \gls{glsadd});
+\item (\gls{glsxtrfmt} only) options provided in
+\gls{GlsXtrFmtDefaultOptions};
+\item (\idx{glslike} only) the \opt{hyperfirst} package option,
+\catattr{nohyperfirst} attribute and \catattr{nohypernext}
+attributes are checked to determine if the \glsopt{hyper} option
+should be switched off (tests followed by \gls{glslinkcheckfirsthyperhook});
+\item \gls{glslinkpresetkeys} (not implemented by \gls{glsadd}
+or \gls{glsxtrfmt});
+\item (\gls{glsadd} only) \gls{glsaddpresetkeys};
+\item \meta{option-list};
+\item \gls{glslinkpostsetkeys} (provided by the base \sty{glossaries}
+package, not implemented by \gls{glsadd} or \gls{glsxtrfmt});
+\item (\gls{glsadd} only) \gls{glsaddpostsetkeys}.
+\end{enumerate}
-The abbreviation shortcut commands can be enabled using
-the \pkgopt[abbreviations]{shortcuts} package option
-(or \pkgopt[abbr]{shortcuts}) or \pkgopt[ac]{shortcuts}.
-(You can use both settings at the same time.)
-The provided shortcut commands listed in
-\tableref{tab:abbrshortcuts}.
+\subsection{Setting Up Defaults}
+\label{sec:defaultglsopts}
+
+You can (locally) set your preferred default options for the \idx{glslike} and
+\idx{glstextlike} commands using:
+\cmddef{GlsXtrSetDefaultGlsOpts}
+The \meta{options} may be any options that you can pass to those commands.
+These options also apply to \gls{glsxtrfmt} but not to \gls{glsadd}.
+
+\begin{information}
+Note that multiple instances of \gls{GlsXtrSetDefaultGlsOpts} will override each
+other.
+\end{information}
+
+If you want to add to the existing options, you can use one of the
+following commands (both may be scoped).
+
+\cmddef{GlsXtrAppToDefaultGlsOpts}
+Appends \meta{options} to the list of default options.
+
+\cmddef{GlsXtrPreToDefaultGlsOpts}
+Prepends \meta{options} to the list of default options.
+
+For example, to prevent indexing in the front matter and back matter but
+not in the main matter:
+\begin{codebox}
+\gls+{frontmatter}
+\gls{GlsXtrSetDefaultGlsOpts}\marg{\glsopt{noindex}}
+\ldots
+\gls+{mainmatter}
+\gls{GlsXtrSetDefaultGlsOpts}\marg{}
+\ldots
+\gls+{backmatter}
+\gls{GlsXtrSetDefaultGlsOpts}\marg{\glsopt{noindex}}
+\end{codebox}
+Note that \glsoptval{noindex}{false} is now set before the options
+given in \gls{GlsXtrSetDefaultGlsOpts} to ensure that the setting is
+correctly initialised, so as from v1.49 you can simply set an empty
+options list to reset the default. Prior to v1.49, it was necessary
+to ensure that the \glsopt{noindex} key was always present in the
+options list to avoid instability. So for pre v1.49, the line after
+\gls{mainmatter} in the above would need to be:
+\begin{codebox}
+\gls{GlsXtrSetDefaultGlsOpts}\marg{\glsoptval{noindex}{false}}
+\end{codebox}
+
+The default \idx{locationencap} is \encap{glsnumberformat} but can
+be changed (locally) with:
+\cmddef{GlsXtrSetDefaultNumberFormat}
+This can be overridden by explicitly setting the \glsopt{format}
+key.
+
+The default options for \gls{glsxtrfmt} only are given by:
+\cmddef{GlsXtrFmtDefaultOptions}
+This command should simply expand to the required list of options. These options
+are set after any options given in \gls{GlsXtrSetDefaultGlsOpts} and before
+\meta{option-list}.
+
+\cmddef{glslinkpresetkeys}
+This hook is performed after any settings provided in \gls{GlsXtrSetDefaultGlsOpts}
+but before \meta{option-list}.
+This hook also applies to \gls{glsxtrfmt} but not to \gls{glsadd}.
+
+Note that \gls{glslinkpostsetkeys}, provided by the
+base \sty{glossaries} package, is performed after \meta{option-list} is
+processed.
+
+\cmddef{glsaddpresetkeys}
+This hook, which is only used by \gls{glsadd}, is performed before
+\meta{option-list}.
+
+\cmddef{glsaddpostsetkeys}
+This hook, which is only used by \gls{glsadd}, is performed after
+\meta{option-list}.
+
+\cmddef{glsinitreunsets}
+This hook initialises the pre unset/reset options to:
+\glsoptval{prereset}{none} and \glsoptval{preunset}{none}. It also
+initialises the \glsopt{postunset} setting to perform the post-unset
+(where applicable) but it will retain the current local/global setting.
+
+This hook will also implement the local repeat unset feature of
+\gls{GlsXtrUnsetBufferEnableRepeatLocal}.
+
+\cmddef{glsxtrchecknohyperfirst}
+This hook is only used by \gls{glsfirst}, \gls{glsfirstplural} and
+their case-changing variants. The hook will implement
+\glsoptval{hyper}{false} if the \catattr{nohyperfirst} attribute is
+set to \code{true}.
+
+\cmddef{glsxtrinitwrgloss}
+This hook initialises the default setting of the \glsopt{wrgloss} option. If the
+\catattr{wrgloss} attribute is set to \code{after} then this implements
+\glsoptval{wrgloss}{after} otherwise it implements \glsoptval{wrgloss}{before}.
+This setting can subsequently be overridden by \gls{GlsXtrSetDefaultGlsOpts},
+\gls{glslinkpresetkeys}, the \meta{option-list} argument or
+\gls{glslinkpostsetkeys}.
+This hook also applies to \gls{glsxtrfmt} but not to \gls{glsadd}.
+
+If you prefer to have the default to place the \idx{indexing} after the
+\idx{linktext}, you can redefine this hook as follows:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glsxtrinitwrgloss}}\marg{\%
+ \gls{glsifattribute}\marg{\gls{glslabel}}\marg{\catattr{wrgloss}}\marg{before}\%
+ {\%
+ \gls+{glsxtrinitwrglossbeforetrue}
+ }\%
+ {\%
+ \gls+{glsxtrinitwrglossbeforefalse}
+ }\%
+}
+\end{codebox}
+
+\cmddef{glsxtrinithyperoutside}
+This hook initialises the default setting of the \glsopt{hyperoutside} option.
+If the \catattr{hyperoutside} attribute is set to \code{false} then this
+implements \glsoptval{hyperoutside}{false} otherwise it implements
+\glsoptval{hyperoutside}{true}.
+This setting can subsequently be overridden by \gls{GlsXtrSetDefaultGlsOpts},
+\gls{glslinkpresetkeys}, the \meta{option-list} argument or
+\gls{glslinkpostsetkeys}.
+This hook also applies to \gls{glsxtrfmt} but not to \gls{glsadd}.
+
+Within any of the hooks that are used by the \idx{glslike},
+\idx{glstextlike} or \gls{glsxtrfmt} commands, you can set options
+using:
+\cmddef{setupglslink}
+
+Within any of the hooks that are used by \idx{glsadd},
+you can set options with:
+\cmddef{setupglsadd}
+
+\subsection{Additional Options}
+\label{sec:xtrglsopts}
+
+Options for the \idx{glslike} and \idx{glstextlike} commands that are
+provided by the base \sty{glossaries} package also apply to new commands like
+\gls{glsxtrfmt} and \gls{glsfmttext}. In addition, the options below are
+provided by \sty{glossaries-extra}. Note that some options, such as
+\glsopt{postunset}, only apply to the \idx{glslike} commands.
+Options that relate to the hyperlink, formatting, \idx{firstuseflag}
+or whether\slash where (\glsopt{noindex}\slash\glsopt{wrgloss}) to
+perform \idx{indexing} aren't available for \gls{glsadd}.
+
+\optiondef{glsopt.hyperoutside}
+This boolean option determines whether the hyperlink should be inside or outside
+of \gls{glstextformat} (see \sectionref{sec:glstextformat}).
+If true, the \idx{linktext} is encapsulated as:
+\begin{codebox}
+\meta{hyperlink-cs}\margm{target}\marg{\gls{glstextformat}\margm{text}}
+\end{codebox}
+otherwise it's encapsulated as:
+\begin{codebox}
+\gls{glstextformat}\marg{\meta{hyperlink-cs}\margm{target}\margm{text}}
+\end{codebox}
+where \meta{hyperlink-cs} is the command that generates the
+hyperlink (if enabled).
+
+\optiondef{glsopt.textformat}
+The value of this key should be the name of a control sequence (without the
+leading backslash). If this option is set, the given control
+sequence will be used instead of \gls{glstextformat} to encapsulate
+the \idx{linktext}. Note that this control sequence should take a single
+argument (the \idx{linktext}). See \sectionref{sec:glstextformat}
+for further details.
-\begin{table}[htbp]
-\caption{Abbreviation Shortcut Commands}
-\label{tab:abbrshortcuts}
-\centering
-\begin{tabular}{lll}
-\bfseries Shortcut &
-\bfseries Shortcut &
-\bfseries Equivalent Command\\
-\bfseries (\pkgopt[abbreviations]{shortcuts}) &
-\bfseries (\pkgopt[ac]{shortcuts})\\
-\ics{ab} & \ics{ac} & \ics{cgls}\\
-\ics{abp} & \ics{acp} & \ics{cglspl}\\
-\ics{as} & \ics{acs} & \ics{glsxtrshort}\\
-\ics{asp} & \ics{acsp} & \ics{glsxtrshortpl}\\
-\ics{al} & \ics{acl} & \ics{glsxtrlong}\\
-\ics{alp} & \ics{aclp} & \ics{glsxtrlongpl}\\
-\ics{af} & \ics{acf} & \ics{glsxtrfull}\\
-\ics{afp} & \ics{acfp} & \ics{glsxtrfullpl}\\
-\ics{Ab} & \ics{Ac} & \ics{cgls}\\
-\ics{Abp} & \ics{Acp} & \ics{cglspl}\\
-\ics{As} & \ics{Acs} & \ics{Glsxtrshort}\\
-\ics{Asp} & \ics{Acsp} & \ics{Glsxtrshortpl}\\
-\ics{Al} & \ics{Acl} & \ics{Glsxtrlong}\\
-\ics{Alp} & \ics{Aclp} & \ics{Glsxtrlongpl}\\
-\ics{Af} & \ics{Acf} & \ics{Glsxtrfull}\\
-\ics{Afp} & \ics{Acfp} & \ics{Glsxtrfullpl}\\
-\ics{AB} & \ics{AC} & \ics{cGLS}\\
-\ics{ABP} & \ics{ACP} & \ics{cGLSpl}\\
-\ics{AS} & \ics{ACS} & \ics{GLSxtrshort}\\
-\ics{ASP} & \ics{ACSP} & \ics{GLSxtrshortpl}\\
-\ics{AL} & \ics{ACL} & \ics{GLSxtrlong}\\
-\ics{ALP} & \ics{ACLP} & \ics{GLSxtrlongpl}\\
-\ics{AF} & \ics{ACF} & \ics{GLSxtrfull}\\
-\ics{AFP} & \ics{ACFP} & \ics{GLSxtrfullpl}\\
-\ics{newabbr} & \ics{newabbr} & \ics{newabbreviation}
-\end{tabular}
-\end{table}
+\begin{information}
+This option will override the \catattr{textformat} attribute.
+\end{information}
+
+\optiondef{glsopt.innertextformat}
+The value of this key should be the name of a control sequence
+(without the leading backslash). The command
+\gls{glsxtrgenentrytextfmt} (which shouldn't be redefined) is
+assigned to this control sequence at the start of the \idx{glslike}
+and \idx{glstextlike} commands. This command is used within the
+predefined abbreviation styles and within \gls{glsgenentryfmt} to
+encapsulate the entry field values.
+
+\begin{information}
+Custom styles that don't use \gls{glsxtrgenentrytextfmt} won't
+support this key. See \sectionref{sec:innertextformat} for further
+details.
+\end{information}
+
+Some formatting commands require direct access to the actual text or
+else the content has to be placed inside a box (which inhibits
+line-breaking). These commands won't work with \glsopt{textformat}
+as the text is usually too deeply embedded. This option provides a
+way of using those problematic commands, however there's still no
+guarantee that they will work (for example, in the case of custom
+styles or where the field value itself contains commands).
+
+\optiondef{glsopt.postunset}
+This option only applies to the \idx{glslike} commands and indicates
+whether or not to unset the \idx{firstuseflag} after the
+\idx{linktext}. It may take one of three values: \optfmt{global}
+(behaves like \glsoptval{local}{false}), \optfmt{local} (behaves
+like \glsoptval{local}{true}) or \optfmt{none} (doesn't unset the
+\idx{firstuseflag} after the \idx{firstuse}). See
+\sectionref{sec:glsunset}.
+
+\optiondef{glsopt.prereset}
+This option may take one of three values: \optfmt{none} (no reset),
+\optfmt{local} or \optfmt{global}. This option (if not \optfmt{none})
+will reset the \idx{firstuseflag} before the \idx{linktext} and
+additionally change \gls{glsxtrifwasfirstuse} so that it indicates
+that this was the \idx{firstuse} of the entry. See
+\sectionref{sec:glsunset}.
+
+Note that this is different from using \gls{glslocalreset} or
+\gls{glsreset} before the \idx{glstextlike} commands. Normally
+\gls{glstext} and \gls{glsplural} will define
+\gls{glsxtrifwasfirstuse} so that it indicates that this was not the
+\idx{firstuse} of the entry (regardless of whether or not the entry
+has actually been used).
-\section{Predefined Abbreviation Styles}
-\label{sec:predefabbrvstyles}
+For example:
+\begin{codebox}
+\gls{glsdefpostlink}\marg{general}\marg{\gls{glsxtrpostlinkAddDescOnFirstUse}}
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},
+ \gloskeyval{first}{sample first use},\gloskeyval{description}{an example}}
+\cbeg{document}
+Text field: \gls{glstext}\marg{sample}.
+\codepar
+First use: \gls{gls}\marg{sample}. Next use: \gls{gls}\marg{sample}.
+\codepar
+Force reset: \gls{gls}\oarg{prereset}\marg{sample}.
+Used? \gls{ifglsused}\marg{sample}\marg{Yes}\marg{No}.
+\codepar
+Force reset: \gls{glstext}\oarg{prereset}\marg{sample}.
+Used? \gls{ifglsused}\marg{sample}\marg{Yes}\marg{No}.
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample[title={Illustrating the \optfmt{prereset} option},
+ label={ex:prereset},
+ description={Example document illustrating the use of the prereset option}]
+{\usepackage{glossaries-extra}^^J%
+\glsdefpostlink{general}{\glsxtrpostlinkAddDescOnFirstUse}^^J
+\newglossaryentry{sample}{name={sample},^^J
+ first={sample first use},^^J
+ description={an example}}
+}{%
+Text field: \glstext{sample}.
+
+First use: \gls{sample}. Next use: \gls{sample}.
+
+Force reset: \gls[prereset]{sample}.
+Used? \ifglsused{sample}{Yes}{No}.
+
+Force reset: \glstext[prereset]{sample}.
+Used? \ifglsused{sample}{Yes}{No}.
+}
+\end{resultbox}
+Note that \gls{gls} unsets the \idx{firstuseflag} (unless
+\glsoptval{postunset}{none}), so the sample entry is marked as used
+afterwards, but \gls{glstext} doesn't alter the \idx{firstuseflag},
+after the \idx{linktext} so the sample entry is still marked as unused afterwards.
+
+\optiondef{glsopt.preunset}
+This option may take one of three values: \optfmt{none} (no unset),
+\optfmt{local} or \optfmt{global}. This option (if not \optfmt{none})
+will unset the \idx{firstuseflag} before the \idx{linktext} and
+additionally change \gls{glsxtrifwasfirstuse} so that it indicates
+that this wasn't the \idx{firstuse} of the entry. See
+\sectionref{sec:glsunset}.
+
+\begin{information}
+The \glsopt{preunset} key is always performed after the
+\glsopt{prereset} key.
+\end{information}
+
+Note the effect of using a global reset but a local unset in the
+example below. Both options are performed, but the unset locally
+overrides the global reset.
+\begin{codebox}
+\gls{glsdefpostlink}\marg{general}\marg{\gls{glsxtrpostlinkAddDescOnFirstUse}}
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},
+ \gloskeyval{first}{sample first use},\gloskeyval{description}{an example}}
+\cbeg{document}
+\gls{gls}\marg{sample}. Used? \gls{ifglsused}\marg{sample}\marg{Yes}\marg{No}.
+\codepar
+\marg{\gls{glsfirst}\oarg{preunset=local,prereset=global}\marg{sample}.
+Used? \gls{ifglsused}\marg{sample}\marg{Yes}\marg{No}.
+}
+\codepar
+Used? \gls{ifglsused}\marg{sample}\marg{Yes}\marg{No}.
+\codepar
+\marg{\gls{gls}\oarg{preunset=local,prereset=global}\marg{sample}.
+Used? \gls{ifglsused}\marg{sample}\marg{Yes}\marg{No}.
+}
+\codepar
+Used? \gls{ifglsused}\marg{sample}\marg{Yes}\marg{No}.
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample[title={Combining \optfmt{prereset} and \optfmt{preunset}},
+ label={ex:preresetpreunset},
+ description={Example document illustrating the use of the prereset
+ and preunset options}]
+{\usepackage{glossaries-extra}^^J%
+\glsdefpostlink{general}{\glsxtrpostlinkAddDescOnFirstUse}^^J
+\newglossaryentry{sample}{name={sample},^^J
+ first={sample first use},^^J
+ description={an example}}
+}{%
+\gls{sample}. Used? \ifglsused{sample}{Yes}{No}.
+
+{\glsfirst[preunset=local,prereset=global]{sample}.
+Used? \ifglsused{sample}{Yes}{No}.
+}
-There are two types of abbreviation styles: those that treat the
-abbreviation as a regular entry (so that \ics{gls} uses
-\ics{glsgenentryfmt}) and those that don't treat the abbreviation as
-a regular entry (so that \ics{gls} uses \ics{glsxtrgenabbrvfmt}).
+Used? \ifglsused{sample}{Yes}{No}.
-The regular entry abbreviation styles set the \catattr{regular}
-attribute to \qt{true} for the category assigned to each
-abbreviation with that style. This means that on \gls{firstuse},
-\ics{gls} uses the value of the \gloskey{first} field and on
-subsequent use \ics{gls} uses the value of the \gloskey{text} field
-(and analogously for the plural and case-changing versions). The
-\gloskey{short} and \gloskey{long} fields are set as appropriate
-and may be accessed through commands like \ics{glsxtrshort}.
-
-The other abbreviation styles don't modify the \catattr{regular}
-attribute. The \gloskey{first} and \gloskey{text} fields (and their
-plural forms) are set and can be accessed through commands like
-\cs{glsfirst}, but they aren't used by commands like \ics{gls},
-which instead use the short form (stored in the \gloskey{short} key)
-and the display full format (through commands like
-\ics{glsxtrfullformat} that are defined by the style).
-
-In both cases, the \gls{firstuse} of \ics{gls} may not match the
-text produced by \ics{glsfirst} (and likewise for the plural
-and case-changing versions).
+{\gls[preunset=local,prereset=global]{sample}.
+Used? \ifglsused{sample}{Yes}{No}.
+}
-The sample file \nolinkurl{sample-abbr-styles.tex} demonstrates all
-predefined styles described here.
+Used? \ifglsused{sample}{Yes}{No}.
+}
+\end{resultbox}
+Remember that \gls{gls} globally unsets the \idx{firstuseflag}
+(unless changed with \glsopt{postunset}),
+which counteracts \glsoptval{prereset}{global}.
+
+\optiondef{glsopt.noindex}
+This is a boolean option that determines whether or not to suppress
+the normal \idx{indexing}. For example, to prevent
+any \locations\ in the front matter or back matter appearing in
+the glossary:
+\begin{codebox}
+\gls{frontmatter}
+\gls{GlsXtrSetDefaultGlsOpts}\marg{\glsopt{noindex}}
+\ldots
+\gls{mainmatter}
+\gls{GlsXtrSetDefaultGlsOpts}\marg{\glsoptval{noindex}{false}}
+\ldots
+\gls{backmatter}
+\gls{GlsXtrSetDefaultGlsOpts}\marg{\glsopt{noindex}}
+\end{codebox}
+Note that if you are using auto-indexing (see
+\sectionref{sec:autoindex}), \glsoptval{noindex}{false} will also
+suppress the auto-indexing.
+
+If you are using \app{bib2gls}, you may want to consider instead using
+\glsoptval{format}{glsignore} to create an ignored \location\
+that ensures the entry is selected without adding a \location\
+to the \idx{locationlist}. (Don't use this method for the other
+\idx{indexing} methods as you'll end up with invisible
+\locations\ with spurious commas in your \idxpl{locationlist}.)
+
+\optiondef{glsopt.wrgloss}
+This option may take one of two values, \optfmt{before} or \optfmt{after},
+which indicate whether the \idx{indexing} should occur before or
+after the \idx{linktext}. The \idx{indexing} creates a \idx{whatsit}
+that can interfere with spacing or cause other problems. The other thing to
+consider is where the \idx{linktext} is long, such as a phrase or
+full form of an abbreviation, that may be split by a page break.
+You will need to decide if you want the \idx{indexing} before the
+\idx{linktext}, so that the \location\ is at the end of the page
+where the text starts, or if you want the \idx{indexing} after the
+\idx{linktext}, so that the \location\ is at the start of the next
+page where the text ends.
+
+This option corresponds to a conditional:
+\cmddef*{ifglsxtrinitwrglossbefore}
+The hook \gls{glsxtrinitwrgloss} sets this conditional according to
+whether or not the \catattr{wrgloss} attribute has been set to
+\code{after}:
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glsxtrinitwrgloss}}\marg{\comment{}
+ \gls{glsifattribute}\marg{\gls{glslabel}}\marg{wrgloss}\marg{after}\comment{}
+ \marg{\gls{glsxtrinitwrglossbeforefalse}}\comment{}
+ \marg{\gls{glsxtrinitwrglossbeforetrue}}\comment{}
+}
+\end{codebox}
+
+\optiondef{glsopt.thevalue}
+Sets the \idx{entrylocation} to the given value instead of obtaining
+it from the \idx{locationcounter}. If you are using \sty{hyperref} you may also
+need to set the location's hypertarget with \glsopt{theHvalue}.
+
+\begin{information}
+This option is primarily intended for use with \app{bib2gls} to supply
+\locations\ that don't have an associated counter within the document, such
+as an external location. If you want to automatically add locations
+from a supplemental document to an entry's \idx{locationlist}, you
+can use the \resourceopt{supplemental-locations} resource option. See
+the \app{bib2gls} user manual for further details.
+\end{information}
+
+For example, to \idxc{indexing}{index} a \location\ in a supplementary document:
+\begin{codebox}
+\gls{glsadd}\oarg{\glsoptval{thevalue}{\marg{Suppl.\cmd{ }2.45}}}\marg{sample}
+\end{codebox}
+This will add \qt{Suppl.\ 2.45} to the \idx{locationlist}
+for the \qt{sample} entry.
\begin{important}
-For the \qt{sc} styles that use \ics{textsc}, be careful about your choice
-of fonts as some only have limited support. For
-example, you may not be able to combine bold and small-caps. I
-recommend that you at least use the \sty{fontenc} package with the
-\pkgoptfmt{T1} option or something similar.
+Note that the value must conform to the \idx{indexingapp}['s] location syntax.
+For \app+{makeindex}, this is limited to \code{Roman}, \code{roman},
+\code{arabic}, \code{alph} and \code{Alph}. With \app+{xindy}, the location
+syntax must be defined in the \app{xindy} module (standard location syntaxes are
+supplied by default). There's no restriction on the location syntax for
+\app{bib2gls}, although if it can't deduce a numerical value it won't be able to
+form a range.
\end{important}
-Many of the styles have helper commands in the form
-\cs{glsxtr...name} and \cs{glsxtr...sort} that are expanded within the
-\gloskey{name} and \gloskey{sort} fields when the abbreviation is defined.
-These commands may use the helper token registers available within
-\cs{newabbreviation}, such as \ics{glsshorttok}. The contents of a
-register can be accessed with \ics{the}\meta{register}. It's essential that
-these expand when the abbreviation is defined so don't hide them behind no-expandable content if you
-redefine these helper commands.
-
-The parenthetical styles, such as \abbrstyle{long-short},
-use
-\begin{definition}[\DescribeMacro\glsxtrparen]
-\cs{glsxtrparen}\marg{text}
-\end{definition}
-to set the parenthetical material. This just puts parentheses around
-the text: (\meta{text}).
-
-The basic abbreviation styles, such as \abbrstyle{long-short}
-and \abbrstyle{short-long} use
-\begin{definition}[\DescribeMacro\glsabbrvdefaultfont]
-\cs{glsabbrvdefaultfont}\marg{text}
-\end{definition}
-for the short form. This just does \meta{text} by default.
-(That is, no font change is applied.) On first use,
-\begin{definition}[\DescribeMacro\glsfirstabbrvdefaultfont]
-\cs{glsfirstabbrvdefaultfont}\marg{text}
-\end{definition}
-is used instead. By default, this just does
-\cs{glsabbrvdefaultfont}. The long form is formatted according to
-\begin{definition}[\DescribeMacro\glslongdefaultfont]
-\cs{glslongdefaultfont}\marg{text}
-\end{definition}
-which again just does \meta{text} (no font change). On first use,
-\begin{definition}[\DescribeMacro\glsfirstlongdefaultfont]
-\cs{glsfirstlongdefaultfont}\marg{text}
-\end{definition}
-is used instead. This just does \cs{glslongdefaultfont}.
-The plural suffix used for the short form is given by
-\begin{definition}[\DescribeMacro\glsxtrabbrvpluralsuffix]
-\cs{glsxtrabbrvpluralsuffix}
-\end{definition}
-which defaults to \ics{glspluralsuffix}.
-
-The small-cap styles, such as \abbrstyle{long-short-sc}
-and \abbrstyle{short-sc-long}, use
-\begin{definition}[\DescribeMacro\glsabbrvscfont]
-\cs{glsabbrvscfont}\marg{text}
-\end{definition}
-which uses \cs{textsc}.\footnote{For compatibility with earlier
-versions, \cs{glsabbrvscfont} is defined to \cs{glsxtrscfont},
-which is defined to use \cs{textsc}. Direct use of
-\cs{glsxtrscfont} is now deprecated. Likewise for similar commands.}
-On first use
-\begin{definition}[\DescribeMacro\glsabbrvdefaultfont]
-\cs{glsfirstabbrvscfont}\marg{text}
-\end{definition}
-is used instead. This uses \cs{glsabbrvscfont} by default.
-So redefine, \cs{glsabbrvscfont} to change first and subsequent uses or
-\cs{glsfirstabbrvscfont} to change just the first use.
-
-The long form for the small-cap styles uses \cs{glslongdefaultfont}
-or \cs{glsfirstlongdefaultfont}, as with the basic style.
-The suffix is given by
-\begin{definition}[\DescribeMacro\glsxtrscsuffix]
-\cs{glsxtrscsuffix}
-\end{definition}
-This is defined as
-\begin{verbatim}
-\newcommand*{\glsxtrscsuffix}{\glstextup{\glsxtrabbrvpluralsuffix}}
-\end{verbatim}
-The \ics{glstextup} command is provided by \styfmt{glossaries}
-and is used to switch off the small caps font for the suffix.
-If you override the default short plural using the
-\gloskey{shortplural} key when you define the abbreviation
-you will need to make the appropriate adjustment if necessary.
-(Remember that the default plural suffix behaviour can be modified
-through the use of the \catattr{aposplural} and
-\catattr{noshortplural} attributes. See
-\sectionref{sec:categories} for further details.)
-
-The small styles, such as \abbrstyle{long-short-sm}
-and \abbrstyle{short-sm-long}, use
-\begin{definition}[\DescribeMacro\glsabbrvsmfont]
-\cs{glsabbrvsmfont}\marg{text}
-\end{definition}
-which uses \cs{textsmaller}. (This requires the \sty{relsizes}
-package, which isn't loaded by \styfmt{glossaries-extra}, so must be
-loaded explicitly.)
-On first use
-\begin{definition}[\DescribeMacro\glsfirstabbrvsmfont]
-\cs{glsfirstabbrvsmfont}\marg{text}
-\end{definition}
-is used instead. This uses \cs{glsabbrvsmfont} by default.
-
-The long form for the smaller styles uses \cs{glslongdefaultfont}
-or \cs{glsfirstlongdefaultfont}, as with the basic style.
-The suffix is given by
-\begin{definition}[\DescribeMacro\glsxtrsmsuffix]
-\cs{glsxtrsmsuffix}
-\end{definition}
-which defaults to just \cs{glsxtrabbrvpluralsuffix}.
-
-The \qt{short-em} (emphasize short) styles, such as
-\abbrstyle{long-short-em} or \abbrstyle{short-em-long}, use
-\begin{definition}[\DescribeMacro\glsabbrvemfont]
-\cs{glsabbrvemfont}\marg{text}
-\end{definition}
-On first use
-\begin{definition}[\DescribeMacro\glsfirstabbrvemfont]
-\cs{glsfirstabbrvemfont}\marg{text}
-\end{definition}
-is used instead. This uses \cs{glsabbrvemfont} by default.
-The suffix is given by
-\begin{definition}[\DescribeMacro\glsxtremsuffix]
-\cs{glsxtremsuffix}
-\end{definition}
-which defaults to just \cs{glsxtrabbrvpluralsuffix}.
-The long form is as for the basic style unless the style
-is a \qt{long-em} style.
-
-The \qt{long-em} (emphasize long) styles, such as
-\abbrstyle{long-em-short-em} or \abbrstyle{short-em-long-em}, use
-\begin{definition}[\DescribeMacro\glsfirstlongemfont]
-\cs{glsfirstlongemfont}\marg{long-form}
-\end{definition}
-instead of \cs{glsfirstlongdefaultfont}\marg{long-form} and
-\begin{definition}[\DescribeMacro\glslongemfont]
-\cs{glslongemfont}\marg{long-form}
-\end{definition}
-instead of \cs{glslongdefaultfont}\marg{long-form}. The first form
-\cs{glsfirstlongemfont} is initialised to use \cs{glslongemfont}.
-
-The user styles have similar commands:
-\begin{definition}[\DescribeMacro\glsabbrvuserfont]
-\cs{glsabbrvuserfont}\marg{text}
-\end{definition}
-for the short form,
-\begin{definition}[\DescribeMacro\glsfirstabbrvuserfont]
-\cs{glsfirstabbrvuserfont}\marg{text}
-\end{definition}
-for the first use short form,
-\begin{definition}[\DescribeMacro\glslonguserfont]
-\cs{glslonguserfont}\marg{text}
-\end{definition}
-for the long form,
-\begin{definition}[\DescribeMacro\glsfirstlonguserfont]
-\cs{glsfirstlonguserfont}\marg{text}
-\end{definition}
-for the first use long form, and
-\begin{definition}[\DescribeMacro\glsxtrusersuffix]
-\cs{glsxtrusersuffix}
-\end{definition}
-for the short plural suffix.
-
-Similarly for the hyphen styles:
-\begin{definition}[\DescribeMacro\glsabbrvhyphenfont]
-\cs{glsabbrvhyphenfont}\marg{text}
-\end{definition}
-for the short form,
-\begin{definition}[\DescribeMacro\glsfirstabbrvhyphenfont]
-\cs{glsfirstabbrvhyphenfont}\marg{text}
-\end{definition}
-for the first use short form,
-\begin{definition}[\DescribeMacro\glslonghyphenfont]
-\cs{glslonghyphenfont}\marg{text}
-\end{definition}
-for the long form,
-\begin{definition}[\DescribeMacro\glsfirstlonghyphenfont]
-\cs{glsfirstlonghyphenfont}\marg{text}
-\end{definition}
-for the first use long form, and
-\begin{definition}[\DescribeMacro\glsxtrhyphensuffix]
-\cs{glsxtrhyphensuffix}
-\end{definition}
-for the short plural suffix.
-
-Similarly for the \qt{only} styles, such as
-\abbrstyle{long-only-short-only}:
-\begin{definition}[\DescribeMacro\glsabbrvonlyfont]
-\cs{glsabbrvonlyfont}\marg{text}
-\end{definition}
-for the short form,
-\begin{definition}[\DescribeMacro\glsfirstabbrvonlyfont]
-\cs{glsfirstabbrvonlyfont}\marg{text}
-\end{definition}
-for the first use short form,
-\begin{definition}[\DescribeMacro\glslongonlyfont]
-\cs{glslongonlyfont}\marg{text}
-\end{definition}
-for the long form,
-\begin{definition}[\DescribeMacro\glsfirstlongonlyfont]
-\cs{glsfirstlongonlyfont}\marg{text}
-\end{definition}
-for the first use long form, and
-\begin{definition}[\DescribeMacro\glsxtronlysuffix]
-\cs{glsxtronlysuffix}
-\end{definition}
-for the short plural suffix.
-
-The \qt{short-sc-only} styles, such as
-\abbrstyle{long-only-short-sc-only}:
-\begin{definition}[\DescribeMacro\glsabbrvsconlyfont]
-\cs{glsabbrvsconlyfont}\marg{text}
-\end{definition}
-for the short form (which uses \ics{glsabbrvscfont}), and
-\begin{definition}[\DescribeMacro\glsfirstabbrvsconlyfont]
-\cs{glsfirstabbrvsconlyfont}\marg{text}
-\end{definition}
-which uses \ics{glsabbrvsconlyfont}.
-The short plural suffix is obtained from:
-\begin{definition}[\DescribeMacro\glsxtrsconlysuffix]
-\cs{glsxtrsconlysuffix}
-\end{definition}
-This uses \ics{glsxtrscsuffix}. For other font types, use the
-one of \qt{short-only} styles and redefine \cs{glsabbrvonlyfont} as
-required. (The smallcaps style is a special case as its plural suffix is
-awkward.)
-
-The \qt{postshort-sc-user} styles, such as
-\abbrstyle{long-postshort-sc-user}:
-\begin{definition}[\DescribeMacro\glsabbrvscuserfont]
-\cs{glsabbrvscuserfont}\marg{text}
-\end{definition}
-for the short form (which uses \ics{glsabbrvscfont}), and
-\begin{definition}[\DescribeMacro\glsfirstabbrvscuserfont]
-\cs{glsfirstabbrvscuserfont}\marg{text}
-\end{definition}
-which uses \ics{glsabbrvscuserfont}.
-The short plural suffix is obtained from:
-\begin{definition}[\DescribeMacro\glsxtrscusersuffix]
-\cs{glsxtrscusersuffix}
-\end{definition}
-This uses \ics{glsxtrscsuffix}.
-
-Note that by default inserted material (provided in the final
-optional argument of commands like \cs{gls}), is placed outside the
-font command in the predefined styles. To move it inside, use:
-\begin{definition}[\DescribeMacro\glsxtrinsertinsidetrue]
-\cs{glsxtrinsertinsidetrue}
-\end{definition}
-This applies to all the predefined styles. For example:
-\begin{verbatim}
-\setabbreviationstyle{long-short}
-\renewcommand*{\glsfirstlongdefaultfont}[1]{\emph{#1}}
-\glsxtrinsertinsidetrue
-\end{verbatim}
-This will make the long form and the inserted text emphasized,
-whereas the default (without \cs{glsxtrinsertinsidetrue}) would
-place the inserted text outside of the emphasized font.
-
-Note that for some styles, such as the \abbrstyle{short-long}, the
-inserted text would be placed inside the font command for the short
-form (rather than the long form in the above example).
-
-Remember that \cs{textsc} renders \emph{lowercase} letters as small
-capitals. Uppercase letters are rendered as normal uppercase
-letters, so if you specify the short form in uppercase, you won't
-get small capitals unless you redefine \cs{glsabbrvscfont} to
-convert its argument to lowercase. For example:
-\begin{verbatim}
-\renewcommand*{\glsabbrvscfont}[1]{\textsc{\MakeLowercase{#1}}}
-\end{verbatim}
-
-If you want to
-easily switch between the \qt{sc} and \qt{sm} styles, you may find
-it easier to redefine this command to convert case:
-\begin{verbatim}
-\renewcommand*{\glsabbrvscfont}[1]{\textsc{\MakeTextLowercase{#1}}}
-\renewcommand*{\glsabbrvsmfont}[1]{\textsmaller{\MakeTextUppercase{#1}}}
-\end{verbatim}
-
-Some of the styles use
-\begin{definition}[\DescribeMacro\glsxtrfullsep]
-\cs{glsxtrfullsep}\marg{label}
-\end{definition}
-as a separator between the long and short forms. This is defined as
-a space by default, but may be changed as required. For example:
-\begin{verbatim}
-\renewcommand*{\glsxtrfullsep}[1]{~}
-\end{verbatim}
-or
-\begin{verbatim}
-\renewcommand*{\glsxtrfullsep}[1]{\glsacspace{#1}}
-\end{verbatim}
+If you want a hyperlink to an external file, you can use:
+\cmddef*{glsxtrsupphypernumber}
+as the formatting command for the \idx{locationencap}. For example:
+\begin{codebox}
+\gls{glsadd}\oarg{\glsoptval{thevalue}{S.2},\glsoptval{format}{glsxtrsupphypernumber}}\marg{sample}
+\end{codebox}
+The path to the external file needs to be set in the
+\catattr{externallocation} category attribute.
+
+\begin{information}
+The hyperlink for the supplementary location may or \emph{may not}
+take you to the relevant place in the external PDF file
+\emph{depending on your PDF viewer}. Some may not support external
+links, and some may take you to the first page or last visited page.
+\end{information}
-The new naming scheme for abbreviation styles is as follows:
+For example, if both \filefmt{sample-suppl-hyp.pdf}
+and \filefmt{sample-suppl-main-hyp.pdf} are in the same directory,
+then viewing \filefmt{sample-suppl-main-hyp.pdf} in Evince will
+take you to the correct location in the linked document (when you
+click on the S.2 external link), but Okular will take you to the top
+of the first page of the linked document.
+
+This method can only be used where there is one external source
+for the designated category (identified by the
+\catattr{externallocation} attribute). For multiple sources, you need to use
+\app{bib2gls} v1.7+, which is the better method in general as it can
+automatically fetch the relevant locations from the \ext{aux}
+files of the designated external documents without the need to
+explicitly use \gls{glsadd}.
+
+\optiondef{glsopt.theHvalue}
+Sets the hypertarget corresponding to the \location, which will be
+used if the \glsopt{format} supports hyperlinks. This is analogous
+to \sty{hyperref}['s] \theHcountername\ that provides the
+hypertarget for a reference to \thecountername.
+
+\begin{information}
+This option is primarily intended for use with the \glsopt{thevalue} option.
+\end{information}
+
+Unless you are using \opteqvalref{record}{nameref}, you must ensure
+that it's possible to form \meta{the-H-value} from
+\meta{h-prefix}\meta{thevalue} for some \meta{h-prefix} (where
+\meta{thevalue} is given by \glsopt{thevalue} or the value of the
+\location\ counter). This restriction is due to the limitations
+imposed by \app+{makeindex} and \app+{xindy}.
+
+\optiondef{glsopt.prefix}
+This option locally redefines \gls{glolinkprefix} to \meta{link-prefix}.
+If you are using \gls{printunsrtglossary} to redisplay a list (possibly in a
+different order) then you will need some way of changing the entry targets to
+avoid duplicate hyperlink targets. One way of achieving this is to redefine
+\gls{glolinkprefix} for the subsequent lists. You will then need to use the
+\glsopt{prefix} option in commands like \gls{gls} to ensure that the hyperlink
+for the \idx{linktext} points to the desired list.
+
+\begin{information}
+This option is intended for use with the \idx{unsrtfam} and
+\gls{glsxtrcopytoglossary} (which is used by \app{bib2gls}).
+The other \idx{indexing} methods don't support repeated lists.
+\end{information}
+\glsadd[format=)]{idx.glsopt}%
+
+\section{Case Changing}
+\label{sec:casechange}
+
+Case-changing commands, such as \gls{Gls} and \gls{GLS}, perform the
+conversion using commands provided by \sty{mfirstuc}. The underlying
+commands provided by \sty{mfirstuc} were redesigned in v2.08 to use
+the newer, better case-changing commands available with the \LaTeX3
+kernel. The base \sty{glossaries} package v4.50 and \sty{glossaries-extra}
+v1.49 were developed concurrently with \sty{mfirstuc} v2.08 to take
+advantage of the new features. Version 1.49 of
+\sty{glossaries-extra} was also developed concurrently with
+\app{bib2gls} v3.0 which, in turn, was developed alongside version
+0.9.2.7b of the \TeX\ parser library.
+
+It's not possible to upload all these new versions at the same time,
+so it will be necessary to stagger their deployment. The new
+case-changing features will work best when all these new versions
+are installed. In the interim, a reduced feature set will be used.
+
+\subsection{Sentence Case Commands}
+\label{sec:firstuc}
+
+Both the base \sty{glossaries} package and the
+\sty{glossaries-extra} package provide \idx{sentencecase} commands,
+which convert the first letter to \idx{uppercase}. These are
+provided for situations where an entry is referenced at the start of
+a sentence. Sentence-casing is also implemented when the attributes
+\catattr{glossname} or \catattr{glossdesc} are set to \code{firstuc}.
+
+The case conversion is performed using:
+\cmddef{glssentencecase}
+The default definition uses \gls{makefirstuc}, which is provided by
+the \sty{mfirstuc} package. This was originally part of the base
+\sty{glossaries} package, but was split into a separately
+distributed package in 2015. Back then, there was no expandable
+sentence-case command. There was also a problem with referencing
+entries where \idx{linktext} was encapsulated with a text-block
+command (which occurs, in particular, with acronym and abbreviation styles).
+The first letter of the text-block command's argument needed to be
+obtained, which resulted in some trickery that proved problematic
+with \idx{utf8}.
+
+The \LaTeX3 kernel now provides a suitable expandable command that
+works with \idx{utf8}, and \sty{mfirstuc} v2.08+ provides
+\gls{MFUsentencecase} that directly interfaces with it. If an older
+version of \sty{mfirstuc} is installed, \sty{glossaries} v4.50+ and
+\sty{glossaries-extra} v1.49+ will provide \gls{MFUsentencecase}. You can use this in
+expandable contents. For example:
+\begin{codebox}
+\cmd{section}\marg{\gls{MFUsentencecase}\marg{\gls{glsentrytext}\marg{label}}}
+\end{codebox}
+However, in the above example, it's simpler to do:
+\begin{codebox}
+\cmd{section}\marg{\gls{Glsfmttext}\marg{label}}
+\end{codebox}
+If \sty{hyperref} has been loaded, \code{\gls{Glsfmttext}\marg{label}}
+will now expand to:
+\begin{compactcodebox}
+\gls{MFUsentencecase}\marg{\gls{glsentrytext}\marg{label}}
+\end{compactcodebox}
+in the PDF bookmark.
+
+Internally, \gls{makefirstuc} now uses \gls{MFUsentencecase} to
+perform the case conversion, but it still parses its argument to
+determine if it starts with \code{\meta{cs}\margm{text}}. This means
+that with \sty{mfirstuc} v2.08+, you now don't have to worry about
+\idx{utf8} characters occurring at the start of the text.
+
+For example, with \sty{mfirstuc} v2.07 you would need to do
+something like:
+\begin{codebox}
+\gls{newglossaryentry}\marg{elite}\marg{\gloskeyval{name}{\marg{\'e}lite},
+ \gloskeyval{description}{...}}
+\end{codebox}
+in order for \code{\gls{Gls}\marg{elite}} to work. Whereas with
+\sty{mfirstuc} v2.08, you can now simply do:
+\begin{codebox}
+\gls{newglossaryentry}\marg{elite}\marg{\gloskeyval{name}{\'elite},
+ \gloskeyval{description}{...}}
+\end{codebox}
+(As from \sty{glossaries} v4.47, it should be possible to use
+\idx{utf8} characters in the label as well.)
+
+Whilst you can redefine \gls{glssentencecase} to use
+\gls{MFUsentencecase} directly (without using \gls{makefirstuc} as
+an intermediary), this may result in content being expanded that
+wouldn't have been expanded previously. In particularly, if
+\meta{cs} isn't robust and expands to content that includes labels
+then the case-change can fail. You also won't be able to take
+advantage of the blockers and mappings that are only recognised as
+such by \gls{makefirstuc}. If you use \gls{MFUsentencecase} instead,
+blockers and mappings will be treated as exclusions, which are
+likely to result in unwanted side-effects.
+
+Both \gls{makefirstuc} and \gls{MFUsentencecase} recognise
+exclusions. These are text-block commands which take a single
+mandatory argument that needs to be skipped. For example, in the
+following \code{\gls{glsadd}\marg{example}} needs to be skipped:
+\begin{codebox}
+\gls{MFUsentencecase}\marg{\gls{glsadd}\marg{example}some text}
+\end{codebox}
+Exclusions are identified with \gls{MFUexcl}. If you have an older
+version of \sty{mfirstuc}, this won't be defined, so
+\sty{glossaries} v4.50+ and \sty{glossaries-extra} v1.49+ provide:
+\cmddef{glsmfuexcl}
+This will use \gls{MFUexcl} with \sty{mfirstuc} v2.08+.
+With older versions, a definition will be provided that works with
+\gls{MFUsentencecase}, but exclusions won't be recognised by
+\gls{makefirstuc}.
+
+As from \sty{glossaries} v4.50, \gls{glsadd} will
+be identified as an exclusion (via \gls{glsmfuexcl}), but the
+optional argument will cause a problem if present. See the
+\sty{mfirstuc} v2.08+ manual for a workaround. Note that commands
+such as \gls{glsaddall} and \gls{glsaddeach} aren't identified as
+exclusions as they aren't expected to occur in text that may require
+a case-change.
+
+With glossary entry references, there are commands
+that take a label as the argument, which shouldn't have any
+case-changed applied, but also shouldn't be skipped. For example:
+\begin{codebox}
+\gls{makefirstuc}\marg{\gls{GLS}\marg{example} something}
+\end{codebox}
+In this situation, there shouldn't be any case-change as \gls{GLS}
+already implements a case-change. This type of command is referred
+to as a blocker in the \sty{mfirstuc} manual, as it indicates a
+command that should prevent any case-change if it's encountered at
+the start of the text. Blockers are identified with \gls{MFUblocker}.
+If you have an older version of \sty{mfirstuc}, this won't be
+defined, so \sty{glossaries} v4.50+ and \sty{glossaries-extra}
+v1.49+ provide:
+\cmddef{glsmfublocker}
+This will use \gls{MFUblocker} with \sty{mfirstuc} v2.08+.
+With older versions, it will simply use \gls{glsmfuexcl} which will
+instead identify the command as an exclusion and won't be recognised
+by \gls{makefirstuc}. See the \sty{mfirstuc} v2.08+ manual for
+further information about blockers.
+
+As from \sty{glossaries} v4.50+, commands like \gls{GLS} will be
+identified as blockers using \gls{glsmfublocker}, and
+\sty{glossaries-extra} now identifies similar commands, such as
+\gls{rGLS} as blockers.
+
+Finally, there are mappings. These are commands that should be
+substituted with another command, which is expected to perform the
+case-change. For example:
+\begin{codebox}
+\gls{makefirstuc}\marg{\gls{gls}\marg{example} something}
+\end{codebox}
+This shouldn't skip or block \gls{gls} but instead should convert
+the text to:
+\begin{codebox}
+\gls{Gls}\marg{example} something
+\end{codebox}
+This is implemented by adding a mapping from \gls{gls} to \gls{Gls}.
+Mappings are added using \gls{MFUaddmap}.
+If you have an older version of \sty{mfirstuc}, this won't be
+defined, so \sty{glossaries} v4.50+ and \sty{glossaries-extra}
+v1.49+ provide:
+\cmddef{glsmfuaddmap}
+This will use \gls{MFUaddmap} with \sty{mfirstuc} v2.08+.
+With older versions, it will simply use \gls{glsmfuexcl} which will
+instead identify the command as an exclusion and won't be recognised
+by \gls{makefirstuc}. See the \sty{mfirstuc} v2.08+ manual for
+further information about mappings.
+
+As from \sty{glossaries} v4.50+, commands like \gls{gls} will be
+mapped to the appropriate \idx{sentencecase} command using
+\gls{glsmfuaddmap}, and \sty{glossaries-extra} now identifies
+similar mappings, such as \gls{rgls} mapped to \gls{rGls}.
+
+In order to integrate the full set of features provided by
+\sty{mfirstuc} v2.08+, you will need both \sty{glossaries} v4.50+
+and \sty{glossaries-extra} v1.49+.
+
+\subsection{Lower Case}
+\label{sec:lowercase}
+
+\cmddef{glslowercase}
+This is defined by \sty{glossaries} v4.50+ to use the \LaTeX3 command
+to convert to \idx+{lowercase}. If an older version of
+\sty{glossaries} is present, then this command will be provided by
+\sty{glossaries-extra} but it will be defined to use
+\gls{MakeTextLowercase} instead. This command is primarily provided for use
+with \idx{smallcaps} styles to convert an abbreviation to
+\idx{lowercase}, but isn't actually used anywhere by default.
+
+\subsection{Upper Case}
+\label{sec:uppercase}
+
+\cmddef{glsuppercase}
+This is defined by \sty{glossaries} v4.50+ to use the \LaTeX3 command
+to convert to \idx+{uppercase} (\idx+{allcaps}). If an older version of
+\sty{glossaries} is present, then this command will be provided by
+\sty{glossaries-extra} but it will be defined to just use
+\gls{mfirstucMakeUppercase}, which is provided by \sty{mfirstuc}.
+This command is used by \idx{allcaps} commands such as
+\gls{GLSxtrusefield}.
+
+\subsection{Title Case}
+\label{sec:titlecase}
+
+\cmddef{glscapitalisewords}
+This is defined by \sty{glossaries} v4.48 to use \gls{capitalisewords}
+to convert to \idx+{titlecase}. If you experience any errors with
+\idx{titlecase} commands, such as \gls{glsentrytitlecase}, or
+attributes such as \catattr{glossdesc} then try redefining
+this command to use \code{\gls{capitalisefmtwords}*} instead. See the
+\sty{mfirstuc} manual for further details.
+
+\section{Entries in Sectioning Titles, Headers, Captions and Contents}
+\label{sec:headtitle}
+
+The \sty{glossaries} user manual cautions against using commands
+like \gls{gls} in chapter or section titles. The principle problems
+are:
\begin{itemize}
-\item
-\meta{field1}[\texttt{-}\meta{modifier1}]\texttt{-}[post]\meta{field2}[\texttt{-}\meta{modifier2}][\texttt{-user}]
+\item if you have a table of contents, the \idx{firstuseflag}
+will be unset in the contents rather than later in the document;
-This is for the parenthetical styles. The \texttt{-}\meta{modifier} parts may
-be omitted. These styles display \meta{field1} followed by
-\meta{field2} in parentheses. If \meta{field1} or \meta{field2} starts
-with \qt{no} then that element is omitted from the display style (no
-parenthetical part) but is included in the inline style.
+\item if you have the \idxpl{locationlist} displayed in the
+\idx{glossary}, unwanted \locations\ will be added to it
+corresponding to the table of contents (if present) and every page
+that contains the entry in the page header (if the page style in use
+adds the chapter or section title to the header);
-If the \texttt{-}\meta{modifier} part is present, then the field has
-a font changing command applied to it. The special modifier
-\texttt{-only} indicates that field is only present according to
-whether or not the entry has been used.
+\item if the page style in use adds the chapter or section title to
+the header and attempts to convert it to \idx{uppercase}, the entry label
+(in the argument of \gls{gls} etc) will be converted to \idx{uppercase}
+and the entry won't be recognised;
-If \texttt{post} is present then \meta{field2} is
-placed after the \gls{linktext} using the post-link hook.
+\item if you use \sty{hyperref}, commands like \gls{gls} can't be
+expanded to a simple string and only the label will appear in the
+PDF bookmark (with a warning from \sty{hyperref});
-If the \texttt{-user} part is present, then the \gloskey{user1}
-value, if provided, is inserted into the parenthetical material .
-(The field used for the inserted material may be changed.)
+\item if you use \sty{hyperref}, you will end up with nested hyperlinks
+in the table of contents.
+\end{itemize}
+Similar problems can also occur with captions (except for the page
+header and bookmark issues).
-Examples:
- \begin{itemize}
- \item\abbrstyle{long-noshort-sc}: \meta{field1} is the long
-form, the short form is set in smallcaps but omitted in the display
-style.
- \item\abbrstyle{long-em-short-em}: both the long form and the
-short form are emphasized. The short form is in parentheses.
- \item\abbrstyle{long-short-em}: the
-short form is emphasized but not the long form. The short form is in parentheses.
- \item\abbrstyle{long-short-user}: if the \gloskey{user1} key has
-been set, this produces the style \meta{long} (\meta{short},
-\meta{user1}) otherwise it just produces \meta{long} (\meta{short}).
+The \sty{glossaries-extra} package tries to resolve the header
+problem by modifying \gls{markright}, \gls{markboth} and \gls{@starttoc}.
+If this causes unwanted side-effects, you can restore their former
+definitions using:
+\cmddef{glsxtrRevertMarks}
+This will revert \gls{markright}, \gls{markboth} and \gls{@starttoc}
+back to the definitions in effect when \sty{glossaries-extra} was
+loaded. Alternatively, you can use:
+\cmddef{glsxtrRevertTocMarks}
+This will only revert \gls{@starttoc}.
+
+If you use \gls{glsxtrRevertMarks} or \gls{glsxtrRevertTocMarks},
+you will need to employ the simplistic approach, described in
+\sectionref{sec:simplisticapproach}, which is the method recommended
+by the \sty{glossaries} user manual. Otherwise, you can use the
+commands described in \sectionref{sec:headingcommands}, which
+provide a better solution.
+
+\subsection{Simplistic Approach}
+\label{sec:simplisticapproach}
- \item\abbrstyle{long-hyphen-postshort-hyphen}: the short
-form and the inserted material (provided by the final optional
-argument of commands like \cs{gls}) is moved to the post-link hook.
-The long form is formatted according to \cs{glslonghyphenfont}
-(or \cs{glsfirstlonghyphenfont} on first use).
-The short form is formatted according to \cs{glsabbrvhyphenfont}
-(or \cs{glsfirstabbrvhyphenfont} on first use).
- \end{itemize}
+To get around all these problems, the \sty{glossaries} user manual
+recommends using the expandable non-hyperlink commands, such as
+\gls{glsentrytext} (for regular entries) or \gls{glsentryshort}
+(for abbreviations). This is the simplest solution, but doesn't
+allow for special formatting that's applied to the entry through
+commands like \gls{glstext} or \gls{glsxtrshort}.
-\item \meta{style}\texttt{-noreg}
+For example:
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\codepar
+\cmd{usepackage}[colorlinks]\marg{hyperref}
+\cmd{usepackage}\marg{glossaries-extra}
+\codepar
+\gls{glsdefpostlink}\marg{general}\marg{\gls{glsxtrpostlinkAddDescOnFirstUse}}
+\codepar
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},
+ \gloskeyval{description}{an example}}
+\gls{newglossaryentry}\marg{alpha}\marg{\gloskeyval{name}{\cmd{ensuremath}\marg{\cmd{alpha}}},\gloskeyval{description}{alpha}}
+\codepar
+\cbeg{document}
+\gls{tableofcontents}
+\cmd{section}\marg{\gls{texorpdfstring}\marg{\gls{Glsentrytext}\marg{sample}
+ and \gls{glsentrytext}\marg{alpha}}\marg{Sample and alpha}}
+\codepar
+First use: \gls{gls}\marg{sample} and \gls{gls}\marg{alpha}.
+\codepar
+Next use: \gls{gls}\marg{sample} and \gls{gls}\marg{alpha}.
+\codepar
+\gls{printunsrtglossary}
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample*[arara={pdflatex,pdflatex,pdfcrop},
+ label={ex:simpleseccmds},
+ title={References in section headings (simplistic approach)},
+ description={Example document that uses a simplistic approach to
+ referencing entries in section titles}]
+{\cmd{usepackage}[colorlinks]\marg{hyperref}^^J%
+ \cmd{usepackage}\marg{glossaries-extra}^^J%
+ \codepar
+ \gls{glsdefpostlink}\marg{general}\marg{\gls{glsxtrpostlinkAddDescOnFirstUse}}^^J%
+ \codepar
+ \gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{an example}}^^J%
+ \gls{newglossaryentry}\marg{alpha}\marg{\gloskeyval{name}{\cmd{ensuremath}\marg{\cmd{alpha}}},\gloskeyval{description}{alpha}}
+}
+{%
+ \gls{tableofcontents}^^J%
+ \cmd{section}\marg{\gls{texorpdfstring}\marg{\gls{Glsentrytext}\marg{sample}
+and \gls{glsentrytext}\marg{alpha}}\marg{Sample and alpha}}^^J%
+ \codepar
+ First use: \gls{gls}\marg{sample} and \gls{gls}\marg{alpha}.^^J%
+ \codepar
+ Next use: \gls{gls}\marg{sample} and \gls{gls}\marg{alpha}.^^J%
+ \codepar
+ \gls{printunsrtglossary}
+}
+\end{resultbox}
+This solves some problems: it avoids nested links in the table of
+contents, the \idx{firstuseflag} isn't prematurely unset and the PDF
+bookmarks has a reasonable substitution, but it still isn't a
+complete solution as the above document will fail if the page style
+is changed to \code{headings} and a page break is inserted before
+the section (after \gls{tableofcontents}), which will lead to the error:
+\begin{transcript}
+Glossary entry `SAMPLE' has not been defined.
+\end{transcript}
+This is because the case-change applied to the header converts
+the label \qt{sample} to \qt{SAMPLE}, which doesn't correspond to a
+defined entry. (This can now be avoided with \sty{mfirstuc} v2.08+.)
+
+If the case conversion is applied by, then the case-change can
+be prevented by encapsulating the label with \gls{NoCaseChange}, but
+this ends up quite complicated. This is actually what the commands
+describe in \sectionref{sec:headingcommands} do when they are in a
+heading. This allows for older versions of \sty{mfirstuc} that don't
+recognise exclusions. See \sectionref{sec:casechange} for further
+details.
-Some styles set the \catattr{regular} attribute. In some cases,
-there's a version of the style that doesn't set this attribute.
-For example, \abbrstyle{long-em-noshort-em} sets the
-\catattr{regular} attribute. The
-\abbrstyle{long-em-noshort-em-noreg} style is a minor variation
-that style that doesn't set the attribute.
+\begin{information}
+The \gls{NoCaseChange} command was originally provided by the
+\sty{textcase} package to prevent \gls{MakeTextUppercase} from
+applying a case-change. The functionality of the \sty{textcase}
+package has now been absorbed into the \LaTeX\ kernel, which means
+that as from 2022, \sty{textcase} is deprecated and
+\gls{NoCaseChange} is defined by the kernel.
+\end{information}
-There are a few \qt{noshort} styles, such as
-\abbrstyle{long-hyphen-noshort-noreg}, that have
-\qt{-noreg} version without a regular version. This is because the
-style won't work properly with the \catattr{regular} set, but the
-naming scheme is maintained for consistency with the other
-\qt{noshort} styles.
+\subsection{New Commands Designed for Chapter/Section Headings or Captions}
+\label{sec:headingcommands}
-\item
-\meta{field1}[\texttt{-}\meta{modifier1}]\texttt{-}[\texttt{post}]\texttt{footnote}
+This section is irrelevant if you use \gls{glsxtrRevertMarks} to
+restore the definitions of \gls{markright},
+\gls{markboth} and \gls{@starttoc}. If you use
+\gls{glsxtrRevertTocMarks}, then this section is only applicable to
+\gls{markright} and \gls{markboth}.
+
+The commands listed here are provided for use within captions or
+section headings. They are designed to overcome some of the problems
+illustrated in the previous section. Note that they
+only have a single argument, the entry label. There are no optional
+arguments. Below, \qt{header} refers to page header text added with
+\gls{markright} or \gls{markboth}, and \qt{contents} refers to the
+table of contents or any other \qt{list of} that uses
+\gls{@starttoc}, such as the list of figures.
+
+Each command \csfmt{glsfmt\meta{field}} (such as \gls{glsfmttext} or
+\gls{glsfmtshort}) behaves like an analogous
+\csfmt{gls\meta{field}} or \csfmt{glsxtr\meta{field}} command (such
+as \gls{glstext} or \gls{glsxtrshort}) but with the options
+\glsopt{noindex} and \glsoptval{hyper}{false} and no insert.
+When they occur within a header, they are protected from having any
+case-change applied (which will interfere with the entry label).
+Since this means they won't appear in \idx{allcaps} in the header,
+the \catattr{headuc} attribute may be set to use the
+\idx{allcaps} \csfmt{GLS\meta{field}} or \csfmt{GLSxtr\meta{field}} instead (such
+as \gls{GLStext} or \gls{GLSxtrshort}).
+
+There is currently only support for the \gloskey{name},
+\gloskey{text}, \gloskey{plural}, \gloskey{first},
+\gloskey{firstplural}, \gloskey{short}, \gloskey{shortplural},
+\gloskey{long}, and \gloskey{longplural} fields, and also limited
+support for the full form of abbreviations. For other fields, you
+will need to follow the recommendation of the \sty{glossaries}
+manual (as discussed above in \sectionref{sec:simplisticapproach}).
+
+The previous example can be rewritten as follows:
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\codepar
+\cmd{usepackage}[colorlinks]\marg{hyperref}
+\cmd{usepackage}\marg{glossaries-extra}
+\codepar
+\gls{glsdefpostlink}\marg{general}\marg{\gls{glsxtrpostlinkAddDescOnFirstUse}}
+\codepar
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{an example}}
+\gls{newglossaryentry}\marg{alpha}\marg{\gloskeyval{name}{\cmd{ensuremath}\marg{\cmd{alpha}}},
+ \gloskeyval{description}{alpha}}
+\codepar
+\cbeg{document}
+\gls{tableofcontents}
+\cmd{section}\marg{\gls{Glsfmttext}\marg{sample} and \gls{glsfmttext}\marg{alpha}}
+\codepar
+First use: \gls{gls}\marg{sample} and \gls{gls}\marg{alpha}.
+\codepar
+Next use: \gls{gls}\marg{sample} and \gls{gls}\marg{alpha}.
+\codepar
+\gls{printunsrtglossary}
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample*[arara={pdflatex,pdflatex,pdfcrop},
+ label={ex:glsfmttext},
+ title={References in section headings using \cmd{glsfmttext}},
+ description={Example document that references entries in section titles}]
+{\cmd{usepackage}[colorlinks]\marg{hyperref}^^J%
+ \cmd{usepackage}\marg{glossaries-extra}^^J%
+ \codepar
+ \gls{glsdefpostlink}\marg{general}\marg{\gls{glsxtrpostlinkAddDescOnFirstUse}}^^J%
+ \codepar
+ \gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{an example}}^^J%
+ \gls{newglossaryentry}\marg{alpha}\marg{\gloskeyval{name}{\cmd{ensuremath}{\cmd{alpha}}},\gloskeyval{description}{alpha}}
+}
+{%
+\gls{tableofcontents}
+\cmd{section}\marg{\gls{Glsfmttext}\marg{sample} and \gls{glsfmttext}\marg{alpha}}
+\codepar
+First use: \gls{gls}\marg{sample} and \gls{gls}\marg{alpha}.
+\codepar
+Next use: \gls{gls}\marg{sample} and \gls{gls}\marg{alpha}.
+\codepar
+\gls{printunsrtglossary}
+}
+\end{resultbox}
+Note that this still results in \qt{Token not allowed in a PDF
+string} warnings from \sty{hyperref}. This is due to the maths shift and
+\csfmt{alpha}, and is something that would also occur if the section
+title explicitly contained \code{\$\cmd{alpha}\$}. If this is likely
+to happen, the issue can be solved by placing
+\gls{texorpdfstring} within the field value. For example:
+\begin{codebox}
+\gls{glsnoexpandfields}
+\gls{newglossaryentry}\marg{alpha}\marg{\gloskeyval{description}{alpha},
+ \gloskeyval{name}{\gls{texorpdfstring}\marg{\cmd{ensuremath}\marg{\cmd{alpha}}}\marg{alpha}}}
+\end{codebox}
+Note the need to prevent field expansion with \gls{glsnoexpandfields}, otherwise
+\gls{texorpdfstring} will be prematurely expanded while the entry is being
+defined.
+
+The options \glsopt{noindex} and \glsoptval{hyper}{false} are
+hard-coded when the commands listed below, such as
+\gls{glsfmtshort}, occur in the header or contents, but within the
+actual section title or caption in the document text, those options
+are obtained from:
+\cmddef{glsxtrtitleopts}
+This simply expands to the option list. For example, you may
+actually want a hyperlink and \idx{indexing} to occur in the
+document body, in which case redefine \gls{glsxtrtitleopts} to do
+nothing:
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\codepar
+\cmd{usepackage}[colorlinks]\marg{hyperref}
+\cmd{usepackage}\marg{glossaries-extra}
+\codepar
+\gls+{pagestyle}\marg{headings}
+\gls{glssetcategoryattribute}\marg{general}\marg{headuc}\marg{true}
+\gls{glsdefpostlink}\marg{general}\marg{\gls{glsxtrpostlinkAddDescOnFirstUse}}
+\codepar
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{an example}}
+\cmd{renewcommand}\marg{\gls{glsxtrtitleopts}}\marg{}
+\codepar
+\cbeg{document}
+\cmd{section}\marg{\gls{Glsfmttext}\marg{sample}}
+First use: \gls{gls}\marg{sample}.
+Next use: \gls{gls}\marg{sample}.
+\gls{printunsrtglossary}
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample*[arara={pdflatex,pdfcrop},
+ label={ex:glslinkinsechead},
+ title={Reference with hyperlink in section headings},
+ description={Example document that references an entry with a hyperlink in a section title}]
+{\cmd{usepackage}[colorlinks]\marg{hyperref}^^J%
+ \cmd{usepackage}\marg{glossaries-extra}^^J%
+ \codepar
+ \cmd{pagestyle}\marg{headings}^^J%
+ \gls{glssetcategoryattribute}\marg{general}\marg{headuc}\marg{true}^^J%
+ \gls{glsdefpostlink}\marg{general}\marg{\gls{glsxtrpostlinkAddDescOnFirstUse}}^^J%
+ \codepar
+ \gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{an example}}^^J%
+ \cmd{renewcommand}\marg{\gls{glsxtrtitleopts}}\marg{}
+}
+{%
+\cmd{section}\marg{\gls{Glsfmttext}\marg{sample}}^^J%
+First use: \gls{gls}\marg{sample}.
+Next use: \gls{gls}\marg{sample}.
+\codepar
+\gls{printunsrtglossary}
+}
+\end{resultbox}
-The display style uses \meta{field1} followed by a footnote with the
-other field in it. If \texttt{post} is present then the footnote is
-placed after the \gls{linktext} using the post-link hook.
-The inline style does \meta{field1} followed by the other field in
-parentheses.
-If \texttt{-}\meta{modifier1} is present, \meta{field1} has a
-font-changing command applied to it.
+% short
-Examples:
-\begin{itemize}
-\item \abbrstyle{short-footnote}: short form in the text with the
-long form in the footnote.
-\item \abbrstyle{short-sc-postfootnote}: short form in smallcaps
-with the long form in the footnote outside of the \gls{linktext}.
-\end{itemize}
+\cmddef{glsfmtshort}
+This normally behaves like \gls{glsxtrshort} but expands to just
+\gls{glsentryshort} in PDF bookmarks and is adjusted when appearing
+in the header or contents.
-\begin{important}
-Take care with the footnote styles. Remember that there are some
-situations where \ics{footnote} doesn't work.
-\end{important}
+\cmddef{Glsfmtshort}
+This normally behaves like \gls{Glsxtrshort} but expands to:
+\begin{compactcodebox}
+\gls{MFUsentencecase}\marg{\gls{glsentryshort}\margm{entry-label}}
+\end{compactcodebox}
+in PDF bookmarks and is adjusted when appearing in the header or contents.
-\item \meta{style}\texttt{-desc}
+\cmddef{GLSfmtshort}
+This normally behaves like \gls{GLSxtrshort} but expands to just
+\gls{glsentryshort} in PDF bookmarks and is adjusted when appearing
+in the header or contents.
-Like \meta{style} but the \gloskey{description} key must be provided
-when defining abbreviations with this style.
+% prefix short
-Examples:
-\begin{itemize}
+\cmddef{pglsfmtshort}
+As \gls{glsfmtshort} but inserts the \gloskey{prefix} field
+and separator, if the \gloskey{prefix} value is set and non-empty.
+Provided for use with \sty{glossaries-prefix}.
-\item \abbrstyle{short-long-desc}: like \abbrstyle{short-long} but
-requires a description.
-\item \abbrstyle{short-em-footnote-desc}: like
-\abbrstyle{short-em-footnote} but requires a description.
-\end{itemize}
-\end{itemize}
+\cmddef{Pglsfmtshort}
+As \gls{pglsfmtshort} but \idx{sentencecase}. Note the initial
+\qt{P} in the command name, which matches \gls{Pgls} (similarly for
+the other prefix \idx{sentencecase} commands).
-Not all combinations that fit the above syntax are provided.
-Pre-version 1.04 styles that didn't fit this naming scheme are either
-provided with a synonym (where the former name wasn't ambiguous) or
-provided with a deprecated synonym (where the former name was
-confusing).
-The deprecated style names generate a warning using:
-\begin{definition}[\DescribeMacro\GlsXtrWarnDeprecatedAbbrStyle]
-\cs{GlsXtrWarnDeprecatedAbbrStyle}\marg{old-name}\marg{new-name}
-\end{definition}
-where \meta{old-name} is the deprecated name and \meta{new-name} is
-the preferred name. You can suppress these warnings by redefining
-this command to do nothing.
-
-\subsection{Predefined Abbreviation Styles that Set the Regular
-Attribute}
-\label{sec:predefregabbrvstyles}
+\cmddef{PGLSfmtshort}
+As \gls{pglsfmtshort} but \idx{allcaps}.
-The following abbreviation styles set the \catattr{regular}
-attribute to \qt{true} for all categories that have abbreviations
-defined with any of these styles.
+% short plural
-\begin{description}
-\item[\abbrstyledef{short-nolong}]
-This only displays the short form on \gls{firstuse}. The \gloskey{name}
-is set to the short form through the command
-\begin{definition}[\DescribeMacro\glsxtrshortnolongname]
-\cs{glsxtrshortnolongname}
-\end{definition}
-(Similarly for the other
-\texttt{short}\meta{modifier}\texttt{-nolong}\meta{modifier} styles,
-unless indicated otherwise.)
-This command is expanded as the entry is defined, so any
-redefinition must be done before \cs{newabbreviation} (or
-\cs{newacronym}) for it to take effect. Make sure to \cs{protect}
-any formatting commands (or anything else that shouldn't be expanded).
-
-The \gloskey{description} is set to the
-long form. The inline full form displays
-\meta{short} (\meta{long}). The long form on its own can be
-displayed through commands like \ics{glsxtrlong}.
-
-\item[\abbrstyledef{short}] A synonym for \abbrstyle{short-nolong}.
-
-\item[\abbrstyledef{nolong-short}] Like \abbrstyle{short-nolong}
-but the inline full form displays
-\meta{long} (\meta{short}).
-
-\item[\abbrstyledef{short-sc-nolong}]
-Like \abbrstyle{short-nolong} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvscfont} (which defaults to \cs{textsc}).
-
-\item[\abbrstyledef{short-sc}] A synonym for \abbrstyle{short-sc-nolong}
-
-\item[\abbrstyledef{nolong-short-sc}] Like \abbrstyle{short-sc-nolong}
-but the inline full form displays
-\meta{long} (\meta{short}). The name is still obtained from
-\cs{glsxtrshortnolongname} (similarly for the other styles in the
-form \texttt{nolong}\meta{modifier}\texttt{-short}\meta{modifier}
-unless indicated otherwise).
-
-\item[\abbrstyledef{short-sm-nolong}]
-Like \abbrstyle{short-nolong} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvsmfont} (which defaults to \cs{textsmaller}).
-
-\item[\abbrstyledef{short-sm}] A synonym for \abbrstyle{short-sm-nolong}.
-
-\item[\abbrstyledef{nolong-short-sm}] Like \abbrstyle{short-sm-nolong}
-but the inline full form displays
-\meta{long} (\meta{short}).
-
-\item[\abbrstyledef{short-em-nolong}]
-Like \abbrstyle{short-nolong} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvemfont}.
-
-\item[\abbrstyledef{short-em}] A synonym for \abbrstyle{short-em-nolong}
-
-\item[\abbrstyledef{nolong-short-em}] Like \abbrstyle{short-em-nolong}
-but the inline full form displays
-\meta{long} (\meta{short}).
-
-\item[\abbrstyledef{short-nolong-desc}]
-Like the \abbrstyle{short-nolong} style, but the \gloskey{name} is set to
-the full form obtained by expanding
-\begin{definition}[\DescribeMacro\glsxtrshortdescname]
-\cs{glsxtrshortdescname}
-\end{definition}
-(Similarly for the other
-\texttt{short}\meta{modifier}\texttt{-nolong}\meta{modifier}\texttt{-desc}
-styles, unless indicated otherwise.) This command is expanded when the entry is defined, so
-\cs{protect} fragile and formatting commands and only redefine this
-command before \cs{newabbreviation} (or \cs{newacronym}).
-
-The \gloskey{description} must be supplied by the
-user. You may prefer to use the \abbrstyle{short-nolong} style with the
-post-description hook set to display the long form and override
-the \gloskey{description} key. (See the sample file
-\texttt{sample-acronym-desc.tex}.)
-
-\item[\abbrstyledef{short-desc}] A synonym for
-\abbrstyle{short-nolong-desc}.
-
-\item[\abbrstyledef{short-sc-nolong-desc}]
-Like \abbrstyle{short-nolong} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvscfont} (which defaults to \cs{textsc}).
-
-\item[\abbrstyledef{short-sc-desc}] A synonym for
-\abbrstyle{short-sc-nolong-desc}.
-
-\item[\abbrstyledef{short-sm-nolong-desc}]
-Like \abbrstyle{short-nolong-desc} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvsmfont} (which defaults to \cs{textsmaller}).
-
-\item[\abbrstyledef{short-sm-desc}] A synonym for
-\abbrstyle{short-sm-nolong-desc}.
-
-\item[\abbrstyledef{short-em-nolong-desc}]
-Like \abbrstyle{short-nolong-desc} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvemfont}.
-
-\item[\abbrstyledef{short-em-desc}] A synonym for
-\abbrstyle{short-em-nolong-desc}.
-
-\item[\abbrstyledef{long-noshort-desc}]
-This style only displays the long form, regardless of first or
-subsequent use of commands \ics{gls}. The short form may be
-accessed through commands like \ics{glsxtrshort}. The inline full
-form displays \meta{long} (\meta{short}).
-
-The \gloskey{sort} key are set to the long form.
-The \gloskey{name} key is also set to the long form, but this is
-done by expanding
-\begin{definition}[\DescribeMacro\glsxtrlongnoshortdescname]
-\cs{glsxtrlongnoshortdescname}
-\end{definition}
-(Similarly for the other
-\texttt{long}\meta{modifier}\texttt{-noshort}\meta{modifier}\texttt{-desc}
-styles, unless indicated otherwise.) This command should only be redefined before abbreviations
-are defined, and any fragile or formatting commands within it need protecting.
-
-The \gloskey{description} must be provided by the user. The predefined
-glossary styles won't display the short form. You can use the
-post-description hook to automatically append the short form to the
-description. The inline full form will display \meta{long}
-(\meta{short}).
-
-\item[\abbrstyledef{long-desc}] A synonym for
-\abbrstyle{long-noshort-desc}.
-
-\item[\abbrstyledef{long-noshort-sc-desc}]
-Like the \abbrstyle{long-noshort-desc} style but the short form (accessed
-through commands like \ics{glsxtrshort}) use \ics{glsabbrvscfont}.
-(This style was originally called \depabbrstyle{long-desc-sc}. Renamed in version
-1.04, but original name retained as a deprecated synonym for
-backward-compatibility.)
-
-\item[\abbrstyledef{long-noshort-sm-desc}]
-Like \abbrstyle{long-noshort-desc} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvsmfont}.
-(This style was originally called \depabbrstyle{long-desc-sm}. Renamed in version
-1.04, but original name retained as a deprecated synonym for
-backward-compatibility.)
-
-\item[\abbrstyledef{long-noshort-em-desc}]
-Like \abbrstyle{long-noshort-desc} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvemfont}. The long form isn't emphasized.
-(This style was originally called \depabbrstyle{long-desc-em}. Renamed in version
-1.04, but original name retained as a deprecated synonym for
-backward-compatibility.)
-
-\item[\abbrstyledef{long-em-noshort-em-desc}]
-New to version 1.04, like \abbrstyle{long-noshort-desc} but redefines
-\cs{glsabbrvfont} to use \ics{glsabbrvemfont}. The long form uses
-\ics{glsfirstlongemfont} and \ics{glslongemfont}.
-
-\item[\abbrstyledef{long-noshort}]
-This style doesn't really make sense if you don't use the short
-form anywhere in the document, but is provided for completeness.
-This is like the \abbrstyle{long-noshort-desc} style, but
-the \gloskey{sort} key is set to the short form. The \gloskey{name}
-key is also set to the short form, but this is done by expanding
-\begin{definition}[\DescribeMacro\glsxtrlongnoshortname]
-\cs{glsxtrlongnoshortname}
-\end{definition}
-(Similarly for other
-\texttt{long}\meta{modifier}\texttt{-noshort}\meta{modifier} styles,
-unless indicated otherwise.)
-This command should only be redefined before abbreviations are
-defined, and fragile or formatting commands should be protected.
-
-The \gloskey{description} is set to the long form.
-
-\item[\abbrstyledef{long}] A synonym for \abbrstyle{long-noshort}
-
-\item[\abbrstyledef{long-noshort-sc}]
-Like the \abbrstyle{long-noshort} style but the short form (accessed
-through commands like \ics{glsxtrshort}) use \ics{glsabbrvscfont}.
-(This style was originally called \depabbrstyle{long-sc}. Renamed in version
-1.04, but original name retained as a deprecated synonym for
-backward-compatibility.)
-
-\item[\abbrstyledef{long-noshort-sm}]
-Like \abbrstyle{long-noshort} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvsmfont}.
-(This style was originally called \depabbrstyle{long-sm}. Renamed in version
-1.04, but original name retained as a deprecated synonym for
-backward-compatibility.)
-
-\item[\abbrstyledef{long-noshort-em}]
-This style is like \abbrstyle{long-noshort} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvemfont}. The long form isn't emphasized.
-(This style was originally called \depabbrstyle{long-em}. Renamed in version
-1.04, but original name retained as a deprecated synonym for
-backward-compatibility.)
-
-\item[\abbrstyledef{long-em-noshort-em}]
-New to version 1.04, this style is like \abbrstyle{long-noshort} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvemfont}, \cs{glsfirstlongfont} to use
-\cs{glsfirstlongemfont} and \cs{glslongfont} to use
-\cs{glslongemfont}. The short form isn't used by commands like
-\ics{gls}, but can be obtained using \ics{glsxtrshort}.
-The related style \abbrstyledef{long-em-noshort-em-noreg}
-doesn't set the \catattr{regular} attribute.
+\cmddef{glsfmtshortpl}
+This normally behaves like \gls{glsxtrshortpl} but expands to just
+\gls{glsentryshortpl} in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+\cmddef{Glsfmtshortpl}
+This normally behaves like \gls{Glsxtrshortpl} but expands to:
+\begin{compactcodebox}
+\gls{MFUsentencecase}\marg{\gls{glsentryshortpl}\margm{entry-label}}
+\end{compactcodebox}
+in PDF bookmarks and is adjusted when appearing in the header or contents.
+
+\cmddef{GLSfmtshortpl}
+This normally behaves like \gls{GLSxtrshortpl} but expands to just
+\gls{glsentryshortpl} in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+% prefix short plural
+
+\cmddef{pglsfmtshortpl}
+As \gls{glsfmtshortpl} but inserts the \gloskey{prefixplural} field
+and separator, if the \gloskey{prefixplural} value is set and non-empty.
+Provided for use with \sty{glossaries-prefix}.
+
+\cmddef{Pglsfmtshortpl}
+As \gls{pglsfmtshortpl} but \idx{sentencecase}.
+
+\cmddef{PGLSfmtshortpl}
+As \gls{pglsfmtshortpl} but \idx{allcaps}.
+
+% long
+
+\cmddef{glsfmtlong}
+This normally behaves like \gls{glsxtrlong} but expands to just
+\gls{glsentrylong} in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+\cmddef{Glsfmtlong}
+This normally behaves like \gls{Glsxtrlong} but expands to:
+\begin{compactcodebox}
+\gls{MFUsentencecase}\marg{\gls{glsentrylong}\margm{entry-label}}
+\end{compactcodebox}
+in PDF bookmarks and is adjusted when appearing in the header or contents.
+
+\cmddef{GLSfmtlong}
+This normally behaves like \gls{GLSxtrlong} but expands to just
+\gls{glsentrylong} in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+% prefix long
+
+\cmddef{pglsfmtlong}
+As \gls{glsfmtlong} but inserts the \gloskey{prefixfirst} field
+and separator, if the \gloskey{prefixfirst} value is set and non-empty.
+Provided for use with \sty{glossaries-prefix}.
+
+\cmddef{Pglsfmtlong}
+As \gls{pglsfmtlong} but \idx{sentencecase}.
+
+\cmddef{PGLSfmtlong}
+As \gls{pglsfmtlong} but \idx{allcaps}.
+
+% long plural
+
+\cmddef{glsfmtlongpl}
+This normally behaves like \gls{glsxtrlongpl} but expands to just
+\gls{glsentrylongpl} in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+\cmddef{Glsfmtlongpl}
+This normally behaves like \gls{Glsxtrlongpl} but expands to:
+\begin{compactcodebox}
+\gls{MFUsentencecase}\marg{\gls{glsentrylongpl}\margm{entry-label}}
+\end{compactcodebox}
+in PDF bookmarks and is adjusted when appearing in the header or contents.
+
+\cmddef{GLSfmtlongpl}
+This normally behaves like \gls{GLSxtrlongpl} but expands to just
+\gls{glsentrylongpl} in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+% prefix long plural
+
+\cmddef{pglsfmtlongpl}
+As \gls{glsfmtlongpl} but inserts the \gloskey{prefixfirstplural} field
+and separator, if the \gloskey{prefixfirstplural} value is set and non-empty.
+Provided for use with \sty{glossaries-prefix}.
+
+\cmddef{Pglsfmtlongpl}
+As \gls{pglsfmtlongpl} but \idx{sentencecase}.
+
+\cmddef{PGLSfmtlongpl}
+As \gls{pglsfmtlongpl} but \idx{allcaps}.
+
+% full
+
+The full form is slightly different as it doesn't correspond to an
+individual \idx{field} but instead is formed from a combination of the
+short and long \idxpl{field} (the order depending on the abbreviation style).
+Since it's too complicated to simply expand to the appropriate
+style, a simple expandable command is provided for the PDF
+bookmarks:
+\cmddef{glspdffmtfull}
+This just expands to the long form followed by the short form in
+parentheses:
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{glspdffmtfull}}[1]\marg{\gls{glsentrylong}\marg{\#1}
+ (\gls{glsentryshort}\marg{\#1})}
+\end{compactcodebox}
+You will need to redefine this if you require the short form first.
+There is an analogous command for the plural:
+\cmddef{glspdffmtfullpl}
+This has a similar definition to \gls{glspdffmtfull} but uses
+\gls{glsentrylongpl} and \gls{glsentryshortpl}.
+
+\cmddef{glsfmtfull}
+This normally behaves like \gls{glsxtrfull} but expands to just
+\gls{glspdffmtfull} in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+\cmddef{Glsfmtfull}
+This normally behaves like \gls{Glsxtrfull} but expands to:
+\begin{compactcodebox}
+\gls{MFUsentencecase}\marg{\gls{glspdffmtfull}\margm{entry-label}}
+\end{compactcodebox}
+in PDF bookmarks and is adjusted when appearing in the header or contents.
+
+\cmddef{GLSfmtfull}
+This normally behaves like \gls{GLSxtrfull} but expands to just
+\gls{glspdffmtfull} in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+% full plural
+
+\cmddef{glsfmtfullpl}
+This normally behaves like \gls{glsxtrfullpl} but expands to just
+\gls{glspdffmtfullpl} in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+\cmddef{Glsfmtfullpl}
+This normally behaves like \gls{Glsxtrfullpl} but expands to:
+\begin{compactcodebox}
+\gls{MFUsentencecase}\marg{\gls{glspdffmtfullpl}\margm{entry-label}}
+\end{compactcodebox}
+in PDF bookmarks and is adjusted when appearing in the header or contents.
+
+\cmddef{GLSfmtfullpl}
+This normally behaves like \gls{GLSxtrfull} but expands to just
+\gls{glspdffmtfull} in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+% name
+
+\cmddef{glsfmtname}
+This normally behaves like \gls{glsname} but expands to just
+\gls{glsentryname} in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+\cmddef{Glsfmtname}
+This normally behaves like \gls{Glsname} but expands to:
+\begin{compactcodebox}
+\gls{MFUsentencecase}\marg{\gls{glsentryname}\margm{entry-label}}
+\end{compactcodebox}
+in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+\cmddef{GLSfmtname}
+This normally behaves like \gls{GLSname} but expands to just
+\gls{glsentryname} in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+% text
+
+\cmddef{glsfmttext}
+This normally behaves like \gls{glstext} but expands to just
+\gls{glsentrytext} in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+\cmddef{Glsfmttext}
+This normally behaves like \gls{Glstext} but expands to:
+\begin{compactcodebox}
+\gls{MFUsentencecase}\marg{\gls{glsentrytext}\margm{entry-label}}
+\end{compactcodebox}
+in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+\cmddef{GLSfmttext}
+This normally behaves like \gls{GLStext} but expands to just
+\gls{glsentrytext} in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+% plural
+
+\cmddef{glsfmtplural}
+This normally behaves like \gls{glsplural} but expands to just
+\gls{glsentryplural} in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+\cmddef{Glsfmtplural}
+This normally behaves like \gls{Glsplural} but expands to:
+\begin{compactcodebox}
+\gls{MFUsentencecase}\marg{\gls{glsentryplural}\margm{entry-label}}
+\end{compactcodebox}
+in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+\cmddef{GLSfmtplural}
+This normally behaves like \gls{GLSplural} but expands to just
+\gls{glsentryplural} in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+% first
+
+\cmddef{glsfmtfirst}
+This normally behaves like \gls{glsfirst} but expands to just
+\gls{glsentryfirst} in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+\cmddef{Glsfmtfirst}
+This normally behaves like \gls{Glsfirst} but expands to:
+\begin{compactcodebox}
+\gls{MFUsentencecase}\marg{\gls{glsentryfirst}\margm{entry-label}}
+\end{compactcodebox}
+in PDF bookmarks and is adjusted when appearing in the header or contents.
+
+\cmddef{GLSfmtfirst}
+This normally behaves like \gls{GLSfirst} but expands to just
+\gls{glsentryfirst} in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+% first plural
+
+\cmddef{glsfmtfirstpl}
+This normally behaves like \gls{glsfirstplural} but expands to just
+\gls{glsentryfirstplural} in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+\cmddef{Glsfmtfirstpl}
+This normally behaves like \gls{Glsfirstplural} but expands to:
+\begin{compactcodebox}
+\gls{MFUsentencecase}\marg{\gls{glsentryfirstplural}\margm{entry-label}}
+\end{compactcodebox}
+in PDF bookmarks and is adjusted when appearing in the header or contents.
+
+\cmddef{GLSfmtfirstpl}
+This normally behaves like \gls{GLSfirstplural} but expands to just
+\gls{glsentryfirstplural} in PDF bookmarks and is adjusted when appearing
+in the header or contents.
+
+\subsection{Advanced Commands}
+\label{sec:headingsadvanced}
+
+\begin{information}
+This section is intended for advanced users and package developers.
+\end{information}
+
+The commands described here are irrelevant if you use \gls{glsxtrRevertMarks} to
+restore the definitions of \gls{markright},
+\gls{markboth} and \gls{@starttoc}. If you use
+\gls{glsxtrRevertTocMarks}, then this section is only applicable to
+\gls{markright} and \gls{markboth}.
+
+If you need to know whether or not some code is inside a header or
+contents list, you can use:
+\cmddef{glsxtrifinmark}
+This does \meta{true} if the command occurs within \gls{markright},
+\gls{markboth} or \gls{@starttoc} otherwise does \meta{false}.
+
+If you need to know whether or not some code is inside a contents
+list (but not the header), you can use:
+\cmddef{glsxtrifintoc}
+This does \meta{true} if the command occurs within \gls{@starttoc}
+otherwise it does \meta{false}.
+(The modified definition of \gls{@starttoc} sets \gls{glsxtrifintoc}
+to \gls{@firstoftwo} at the start and to \gls{@secondoftwo} at
+the end.)
+
+If you need to know whether or not some code is in the PDF bookmarks
+or heading, you can use:
+\cmddef{glsxtrtitleorpdforheading}
+This does the applicable argument depending on whether the
+command occurs within a title\slash caption or PDF bookmark or
+heading.
+
+If this command occurs within the \ext+{toc} file, it will
+do its \meta{heading} argument but if \gls{glsxtrtitleorpdforheading}
+expands while it's being written to the \ext{toc} file, then it will
+expand to \meta{title}. This can be illustrated in the following
+document:
+\begin{codebox}
+\cmd{documentclass}\marg{report}
+\cmd{usepackage}\marg{lipsum}
+\cmd{usepackage}\marg{hyperref}
+\cmd{usepackage}\marg{glossaries-extra}
+\cmd{pagestyle}\marg{headings}
+\cbeg{document}
+\gls+{tableofcontents}
+\cmd{chapter}\marg{\gls{glsxtrtitleorpdforheading}\marg{Title}\marg{PDF}\marg{Heading}
+\gls{glsxtrifinmark}\marg{in mark}\marg{not in mark}}
+\cmd{lipsum}
+\cmd{chapter}\marg{\cmd{protect}\gls{glsxtrtitleorpdforheading}\marg{Title}\marg{PDF}\marg{Heading}
+\cmd{protect}\gls{glsxtrifinmark}\marg{in mark}\marg{not in mark}}
+\cmd{lipsum}
+\cend{document}
+\end{codebox}
+In the first case, \gls{glsxtrtitleorpdforheading} expands as it's
+being written to the \ext{toc} file, so it expands to \qt{Title}.
+In the second case, \gls{glsxtrtitleorpdforheading} is protected so
+that command is written to the \ext{toc} file. On the next \LaTeX,
+when the table of contents is displayed, this command will expand to
+\qt{Heading}, because it's in the \ext{toc} file. Similarly, in the
+first case, \gls{glsxtrifinmark} will expand to \qt{not in mark} as
+it's written to the \ext{toc} file, but in the second case it's
+expansion is prevented, so it will expand to \qt{in mark} in the table of
+contents.
+
+If \sty{gettitlestring} has been loaded (used by \sty{nameref} to
+provide \gls{nameref}) then adjustments for both \gls{glsxtrtitleorpdforheading}
+and \gls{glsxtrifinmark} will be added to \gls{GetTitleStringDisableCommands},
+but bear in mind that you will need to use the following for it to
+have an effect:
+\begin{codebox*}
+\gls{GetTitleStringSetup}\marg{expand}
+\end{codebox*}
+
+The commands described in \sectionref{sec:headingcommands}, such as
+\gls{glsfmtshort}, are essentially defined as:
+\begin{compactcodebox}
+\gls{texorpdfstring}
+ \marg{\cmd{glsxtrtitle\meta{field}}\margm{entry-label}}\comment{title}
+ \marg{\cmd{glsentry\meta{field}}\margm{entry-label}}\comment{bookmark}
+\end{compactcodebox}
+If \gls{texorpdfstring} isn't defined, then the definition is:
+\begin{compactcodebox}
+\cmd{glsxtrtitle\meta{field}}\margm{entry-label}
+\end{compactcodebox}
+For example, \gls{glsfmtshort} is defined as (with \sty{hyperref}):
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{glsfmtshort}}[1]\marg{\%
+ \gls{texorpdfstring}\marg{\gls{glsxtrtitleshort}\marg{\#1}}\marg{\gls{glsentryshort}\marg{\#1}}\%
+}
+\end{compactcodebox}
+This ensures that \gls{glsfmtshort} expands to just
+\gls{glsentryshort} within the PDF bookmarks. Provided the field
+value doesn't contain any problematic commands, this allows the
+actual value to be added to the bookmarks.
+
+Unfortunately the case-changing commands can't expand and therefore aren't
+appropriate for the bookmarks (which need to be a PDF string).
+This means that the \idx{sentencecase} and \idx{allcaps} commands
+also use the unmodified field value for the bookmark. For example,
+\gls{Glsfmtshort} is defined as:
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{Glsfmtshort}}[1]\marg{\%
+ \gls{texorpdfstring}\marg{\gls{Glsxtrtitleshort}\marg{\#1}}\marg{\gls{glsentryshort}\marg{\#1}}\%
+}
+\end{compactcodebox}
+
+The \csfmt{glsxtrtitle\meta{field}} set of commands all default to
+the corresponding \idx{glstextlike} command with the options given
+by \gls{glsxtrtitleopts} and an empty insert final argument. These
+title commands are redefined by \gls{glsxtrmarkhook} to the
+corresponding \csfmt{glsxtrhead\meta{field}} command. These
+\qt{head} commands use \gls{NoCaseChange} to prevent interference
+from page headers that convert to \idx{allcaps} (which can
+inappropriately convert the entry label to \idx{allcaps}). Instead,
+the \catattr{headuc} attribute needs to be set to \code{true} to use
+the appropriate \idx{allcaps} command. A shortcut command is
+provided to test for this attribute:
+\cmddef{glsxtrifheaduc}
+This is defined as:
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{glsxtrifheaduc}}[3]\marg{\%
+ \gls{glsxtrifintoc}\marg{\#3}\marg{\gls{glsifattribute}\marg{\#1}\marg{\catattr{headuc}}\marg{true}\marg{\#2}\marg{\#3}}\%
+}
+\end{compactcodebox}
+Since the header commands also end up in the contents, where the
+\idx{allcaps} conversion should not be applied, the definition
+includes \gls{glsxtrifintoc} to skip the check in the contents.
+
+\cmddef{glsxtrtitleshort}
+The normal behaviour of \gls{glsfmtshort}.
+This is redefined by \gls{glsxtrmarkhook} to \gls{glsxtrheadshort}.
+The default is:
+\begin{compactcodebox}
+\gls{glsxtrshort}\oarg{\glsopt{noindex},\glsoptval{hyper}{false}}\margm{entry-label}\oarg{}
+\end{compactcodebox}
+(This is performed indirectly via an internal command that ensures
+that \gls{glsxtrtitleopts} is expanded before being passed in the optional
+argument.)
+
+\cmddef{glsxtrheadshort}
+Used to display the short form in the page header. This is defined
+as:
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{glsxtrheadshort}}[1]\marg{\%
+ \cmd{protect}\gls{NoCaseChange}
+ \marg{\%
+ \gls{glsifattribute}\marg{\#1}\marg{\catattr{headuc}}\marg{true}\%
+ \marg{\%
+ \gls{GLSxtrshort}\oarg{\glsopt{noindex},\glsoptval{hyper}{false}}\marg{\#1}\oarg{}\%
+ }\%
+ \marg{\%
+ \gls{glsxtrshort}\oarg{\glsopt{noindex},\glsoptval{hyper}{false}}\marg{\#1}\oarg{}\%
+ }\%
+ }\%
+}
+\end{compactcodebox}
+The \idx{sentencecase} commands also check the \catattr{headuc}
+attribute.
-\end{description}
+\cmddef{Glsxtrtitleshort}
+The normal behaviour of \gls{Glsfmtshort}.
+This is redefined by \gls{glsxtrmarkhook} to \gls{Glsxtrheadshort}.
+The default is:
+\begin{compactcodebox}
+\gls{Glsxtrshort}\oarg{\glsopt{noindex},\glsoptval{hyper}{false}}\margm{entry-label}\oarg{}
+\end{compactcodebox}
+(Again, this is performed indirectly via an internal command that ensures
+that \gls{glsxtrtitleopts} is expanded before being passed in the optional
+argument.)
+
+\cmddef{Glsxtrheadshort}
+Used to display the \idx{sentencecase} short form in the page header. This is defined
+as:
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{Glsxtrheadshort}}[1]\marg{\%
+ \cmd{protect}\gls{NoCaseChange}
+ \marg{\%
+ \gls{glsifattribute}\marg{\#1}\marg{\catattr{headuc}}\marg{true}\%
+ \marg{\%
+ \gls{GLSxtrshort}\oarg{\glsopt{noindex},\glsoptval{hyper}{false}}\marg{\#1}\oarg{}\%
+ }\%
+ \marg{\%
+ \gls{Glsxtrshort}\oarg{\glsopt{noindex},\glsoptval{hyper}{false}}\marg{\#1}\oarg{}\%
+ }\%
+ }\%
+}
+\end{compactcodebox}
+
+\cmddef{GLSxtrtitleshort}
+The normal behaviour of \gls{GLSfmtshort}.
+This is redefined by \gls{glsxtrmarkhook} to \gls{GLSxtrheadshort}.
+The default uses \gls{GLSxtrshort} in a similar way to
+\gls{glsxtrtitleshort} and \gls{Glsxtrtitleshort}.
+
+\cmddef{GLSxtrheadshort}
+Used to display the \idx{allcaps} short form in the page header. In
+this case, there's no need to check to the \catattr{headuc}
+attribute, but the label needs to be protected from any potential
+case-change:
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{GLSxtrheadshort}}[1]\marg{\%
+ \cmd{protect}\gls{NoCaseChange}
+ \marg{\%
+ \gls{GLSxtrshort}\oarg{\glsopt{noindex},\glsoptval{hyper}{false}}\marg{\#1}\oarg{}\%
+ }\%
+}
+\end{compactcodebox}
-\subsection{Predefined Abbreviation Styles that Don't Set the Regular
-Attribute}
-\label{sec:predefnonregabbrvstyles}
+All the similar commands listed below are defined in an analogous
+way, except for the \sty{glossaries-prefix} commands, where only the
+\idx{sentencecase} title version is provided. This is because
+commands like \gls{Pglsfmtshort} have to determine whether or not to
+use \gls{glsfmtshort} or \gls{Glsfmtshort} depending on whether or
+not the prefix has been set. Whereas commands like
+\gls{pglsfmtshort} simply need to insert the prefix and separator if
+set and then use the corresponding \gls{glsfmtshort}.
-The following abbreviation styles will set the
-\catattr{regular} attribute to \qt{false} if it has previously
-been set. If it hasn't already been set, it's left unset.
-Other attributes may also be set, depending on the style.
+\cmddef{Pglsxtrtitleshort}
+The normal behaviour of \gls{Pglsfmtshort}.
-\begin{description}
-\item[\abbrstyledef{long-short}]
-On \gls{firstuse}, this style uses the format \meta{long} (\meta{short}).
-The inline and display full forms are the same. The
- \gloskey{sort} key is set to the short form. The \gloskey{name} is
-also set to the short form through
-\begin{definition}[\DescribeMacro\glsxtrlongshortname]
-\cs{glsxtrlongshortname}
-\end{definition}
-(Similarly for other
-\texttt{long}\meta{modifier}\texttt{-short}\meta{modifier} styles,
-unless indicated otherwise.)
-Any redefinition of this command must come before the abbreviations
-are defined as it expands on definition. Make sure you protect
-any commands that shouldn't be expanded. The long form can be
-referenced with \cs{the}\cs{glslongtok} and the short form
-can be referenced with \cs{the}\cs{glsshorttok}.
-
-The \gloskey{description} is set to the long form. The long and short
-forms are separated by \cs{glsxtrfullsep}. If you want to insert
-material within the parentheses (such as a~translation), try the
-\abbrstyle{long-short-user} style.
-
-\item[\abbrstyledef{long-short-sc}]
-Like \abbrstyle{long-short} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvscfont}.
-
-\item[\abbrstyledef{long-short-sm}]
-Like \abbrstyle{long-short} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvsmfont}.
-
-\item[\abbrstyledef{long-short-em}]
-Like \abbrstyle{long-short} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvemfont}.
-
-\item[\abbrstyledef{long-em-short-em}]
-New to version 1.04, this style is like \abbrstyle{long-short-em} but redefines \cs{glsfirstlongfont} to
-use \ics{glsfirstlongemfont}.
-
-\item[\abbrstyledef{long-only-short-only}]
-New to version 1.17, this style only shows the long form
-on first use and only shows the short form on subsequent use.
-The inline full form \cs{glsxtrfull} shows the long form
-followed by the short form in parentheses. The \gloskey{name}
-field is obtained from
-\begin{definition}[\DescribeMacro\glsxtronlyname]
-\cs{glsxtronlyname}
-\end{definition}
-Any redefinition of this command must come before the abbreviations
-are defined as it expands on definition. Make sure you protect
-any commands that shouldn't be expanded. The long form can be
-referenced with \cs{the}\cs{glslongtok} and the short form
-can be referenced with \cs{the}\cs{glsshorttok}.
-
-\item[\abbrstyledef{long-only-short-sc-only}]
-
-New to version 1.48, this is like \abbrstyle{long-only-short-only} but
-uses smallcaps for the short form. The name is obtained from:
-\begin{definition}[\DescribeMacro\glsxtrsconlyname]
-\cs{glsxtrsconlyname}
-\end{definition}
-
-\item[\abbrstyledef{long-only-short-only-desc}]
-New to version 1.17, this style is like
-\abbrstyle{long-only-short-only} but the user must supply the
-description. The \gloskey{name} field is obtained from
-\begin{definition}[\DescribeMacro\glsxtronlydescname]
-\cs{glsxtronlydescname}
-\end{definition}
-The sort value is obtained from:
-\begin{definition}[\DescribeMacro\glsxtronlydescsort]
-\cs{glsxtronlydescsort}
-\end{definition}
-
-Any redefinition of these commands must come before the abbreviations
-are defined as it expands on definition. Make sure you protect
-any commands that shouldn't be expanded. The long form can be
-referenced with \cs{the}\cs{glslongtok} and the short form
-can be referenced with \cs{the}\cs{glsshorttok}.
-
-
-\item[\abbrstyledef{long-only-short-sc-only-desc}]
-New to version 1.48, this style is like
-\abbrstyle{long-only-short-only-desc} but it uses smallcaps for the
-short form. The name is obtained from:
-\begin{definition}[\DescribeMacro\glsxtrsconlydescname]
-\cs{glsxtrsconlydescname}
-\end{definition}
-This defaults to \cs{glsxtronlydescname}.
-
-The sort value is obtained from:
-\begin{definition}[\DescribeMacro\glsxtrsconlydescsort]
-\cs{glsxtrsconlydescsort}
-\end{definition}
-This defaults to \cs{glsxtronlydescsort}.
-
-\item[\abbrstyledef{long-em-noshort-em-noreg}]
-New to version 1.17, this style is like
-\abbrstyle{long-em-noshort-em} but
-doesn't set the \catattr{regular} attribute.
-
-\item[\abbrstyledef{long-short-user}]
-This style was introduced in version 1.04. It's like the
-\abbrstyle{long-short} style but additional information can be
-inserted into the parenthetical material. This checks the value
-of the field given by
-\begin{definition}[\DescribeMacro\glsxtruserfield]
-\cs{glsxtruserfield}
-\end{definition}
-(which defaults to \texttt{useri}) using \ics{ifglshasfield}
-(provided by \styfmt{glossaries}). If the field hasn't been set,
-the style behaves like the \abbrstyle{long-short} style and
-produces \meta{long} (\meta{short}) but if the field has been set,
-the contents of that field are inserted within the parentheses in
-the form \meta{long} (\meta{short}, \meta{field-value}).
-The format is governed by
-\begin{definition}[\DescribeMacro\glsxtruserparen]
-\cs{glsxtruserparen}\marg{text}\marg{label}
-\end{definition}
-where \meta{text} is the short form (for the
-\abbrstyle{long-short-user} style) or the long form (for the
-\abbrstyle{short-long-user} style). This command first inserts
-a space using \cs{glsxtrfullsep} and then the parenthetical content
-(using \ics{glsxtrparen}).
-The \gloskey{description} is set to
-\begin{definition}[\DescribeMacro\glsuserdescription]
-\cs{glsuserdescription}\marg{long}\marg{label}
-\end{definition}
-The default definition ignores the \meta{label} and encapsulates
-\meta{long} with \cs{glslonguserfont}.
-
-The \gloskey{name} is obtained by expanding
-\cs{glsxtrlongshortname} (see above).
-The \meta{text} argument includes the font formatting command,
-\cs{glsfirstabbrvfont}\marg{short} in the case of the
-\abbrstyle{long-short-user} style and
-\cs{glsfirstlongfont}\marg{long} in the
-case of the \abbrstyle{short-long-user} style.
+\cmddef{Pglsxtrtitleshortpl}
+The normal behaviour of \gls{Pglsfmtshortpl}.
+
+\cmddef{Pglsxtrtitlelong}
+The normal behaviour of \gls{Pglsfmtlong}.
+
+\cmddef{Pglsxtrtitlelongpl}
+The normal behaviour of \gls{Pglsfmtlongpl}.
+
+% short plural
+
+\cmddef{glsxtrtitleshortpl}
+The title plural short form. (Normal behaviour of \gls{glsfmtshortpl}.)
+
+\cmddef{glsxtrheadshortpl}
+The header plural short form. (The behaviour of \gls{glsfmtshortpl}
+when it occurs in a header.)
+
+\cmddef{Glsxtrtitleshortpl}
+The title plural \idx{sentencecase} short form. (Normal behaviour of
+\gls{Glsfmtshortpl}.)
+
+\cmddef{Glsxtrheadshortpl}
+The header plural \idx{sentencecase} short form. (The behaviour of \gls{Glsfmtshortpl}
+when it occurs in a header.)
+
+\cmddef{GLSxtrtitleshortpl}
+The title plural \idx{allcaps} short form. (Normal behaviour of
+\gls{GLSfmtshortpl}.)
+
+\cmddef{GLSxtrheadshortpl}
+The header plural \idx{allcaps} short form. (The behaviour of \gls{GLSfmtshortpl}
+when it occurs in a header.)
+
+% long
+
+\cmddef{glsxtrtitlelong}
+The title long form. (Normal behaviour of \gls{glsfmtlong}.)
+
+\cmddef{glsxtrheadlong}
+The header long form. (The behaviour of \gls{glsfmtlong}
+when it occurs in a header.)
+
+\cmddef{Glsxtrtitlelong}
+The title \idx{sentencecase} long form. (Normal behaviour of
+\gls{Glsfmtlong}.)
+
+\cmddef{Glsxtrheadlong}
+The header \idx{sentencecase} long form. (The behaviour of \gls{Glsfmtlong}
+when it occurs in a header.)
+
+\cmddef{GLSxtrtitlelong}
+The title \idx{allcaps} long form. (Normal behaviour of
+\gls{GLSfmtlong}.)
+
+\cmddef{GLSxtrheadlong}
+The header \idx{allcaps} long form. (The behaviour of \gls{GLSfmtlong}
+when it occurs in a header.)
+
+% long plural
+
+\cmddef{glsxtrtitlelongpl}
+The title plural long form. (Normal behaviour of \gls{glsfmtlongpl}.)
+
+\cmddef{glsxtrheadlongpl}
+The header plural long form. (The behaviour of \gls{glsfmtlongpl}
+when it occurs in a header.)
+
+\cmddef{Glsxtrtitlelongpl}
+The title plural \idx{sentencecase} long form. (Normal behaviour of
+\gls{Glsfmtlongpl}.)
+
+\cmddef{Glsxtrheadlongpl}
+The header plural \idx{sentencecase} long form. (The behaviour of \gls{Glsfmtlongpl}
+when it occurs in a header.)
+
+\cmddef{GLSxtrtitlelongpl}
+The title plural \idx{allcaps} long form. (Normal behaviour of
+\gls{GLSfmtlongpl}.)
+
+\cmddef{GLSxtrheadlongpl}
+The header plural \idx{allcaps} long form. (The behaviour of \gls{GLSfmtlongpl}
+when it occurs in a header.)
+
+% full
+
+\cmddef{glsxtrtitlefull}
+The title full form. (Normal behaviour of \gls{glsfmtfull}.)
+
+\cmddef{glsxtrheadfull}
+The header full form. (The behaviour of \gls{glsfmtfull}
+when it occurs in a header.)
+
+\cmddef{Glsxtrtitlefull}
+The title \idx{sentencecase} full form. (Normal behaviour of
+\gls{Glsfmtfull}.)
+
+\cmddef{Glsxtrheadfull}
+The header \idx{sentencecase} full form. (The behaviour of \gls{Glsfmtfull}
+when it occurs in a header.)
+
+\cmddef{GLSxtrtitlefull}
+The title \idx{allcaps} full form. (Normal behaviour of
+\gls{GLSfmtfull}.)
+
+\cmddef{GLSxtrheadfull}
+The header \idx{allcaps} full form. (The behaviour of \gls{GLSfmtfull}
+when it occurs in a header.)
+
+% full plural
+
+\cmddef{glsxtrtitlefullpl}
+The title plural full form. (Normal behaviour of \gls{glsfmtfullpl}.)
+
+\cmddef{glsxtrheadfullpl}
+The header plural full form. (The behaviour of \gls{glsfmtfullpl}
+when it occurs in a header.)
+
+\cmddef{Glsxtrtitlefullpl}
+The title plural \idx{sentencecase} full form. (Normal behaviour of
+\gls{Glsfmtfullpl}.)
+
+\cmddef{Glsxtrheadfullpl}
+The header plural \idx{sentencecase} full form. (The behaviour of \gls{Glsfmtfullpl}
+when it occurs in a header.)
+
+\cmddef{GLSxtrtitlefullpl}
+The title plural \idx{allcaps} full form. (Normal behaviour of
+\gls{GLSfmtfullpl}.)
+
+\cmddef{GLSxtrheadfullpl}
+The header plural \idx{allcaps} full form. (The behaviour of \gls{GLSfmtfullpl}
+when it occurs in a header.)
+
+% name
+
+\cmddef{glsxtrtitlename}
+The title \gloskey{name} field. (Normal behaviour of \gls{glsfmtname}.)
+
+\cmddef{glsxtrheadname}
+The header \gloskey{name} field. (The behaviour of \gls{glsfmtname}
+when it occurs in a header.)
+
+\cmddef{Glsxtrtitlename}
+The title \idx{sentencecase} \gloskey{name} field. (Normal behaviour of
+\gls{Glsfmtname}.)
+
+\cmddef{Glsxtrheadname}
+The header \idx{sentencecase} \gloskey{name} field. (The behaviour of \gls{Glsfmtname}
+when it occurs in a header.)
+
+\cmddef{GLSxtrtitlename}
+The title \idx{allcaps} \gloskey{name} field. (Normal behaviour of
+\gls{GLSfmtname}.)
+
+\cmddef{GLSxtrheadname}
+The header \idx{allcaps} \gloskey{name} field. (The behaviour of \gls{GLSfmtname}
+when it occurs in a header.)
+
+% text
+
+\cmddef{glsxtrtitletext}
+The title \gloskey{text} field. (Normal behaviour of \gls{glsfmttext}.)
+
+\cmddef{glsxtrheadtext}
+The header \gloskey{text} field. (The behaviour of \gls{glsfmttext}
+when it occurs in a header.)
+
+\cmddef{Glsxtrtitletext}
+The title \idx{sentencecase} \gloskey{text} field. (Normal behaviour of
+\gls{Glsfmttext}.)
+
+\cmddef{Glsxtrheadtext}
+The header \idx{sentencecase} \gloskey{text} field. (The behaviour of \gls{Glsfmttext}
+when it occurs in a header.)
+
+\cmddef{GLSxtrtitletext}
+The title \idx{allcaps} \gloskey{text} field. (Normal behaviour of
+\gls{GLSfmttext}.)
+
+\cmddef{GLSxtrheadtext}
+The header \idx{allcaps} \gloskey{text} field. (The behaviour of \gls{GLSfmttext}
+when it occurs in a header.)
+
+% plural
+
+\cmddef{glsxtrtitleplural}
+The title \gloskey{plural} field. (Normal behaviour of \gls{glsfmtplural}.)
+
+\cmddef{glsxtrheadplural}
+The header \gloskey{plural} field. (The behaviour of \gls{glsfmtplural}
+when it occurs in a header.)
+
+\cmddef{Glsxtrtitleplural}
+The title \idx{sentencecase} \gloskey{plural} field. (Normal behaviour of
+\gls{Glsfmtplural}.)
+
+\cmddef{Glsxtrheadplural}
+The header \idx{sentencecase} \gloskey{plural} field. (The behaviour of \gls{Glsfmtplural}
+when it occurs in a header.)
+
+\cmddef{GLSxtrtitleplural}
+The title \idx{allcaps} \gloskey{plural} field. (Normal behaviour of
+\gls{GLSfmtplural}.)
+
+\cmddef{GLSxtrheadplural}
+The header \idx{allcaps} \gloskey{plural} field. (The behaviour of \gls{GLSfmtplural}
+when it occurs in a header.)
+
+% first
+
+\cmddef{glsxtrtitlefirst}
+The title \gloskey{first} field. (Normal behaviour of \gls{glsfmtfirst}.)
+
+\cmddef{glsxtrheadfirst}
+The header \gloskey{first} field. (The behaviour of \gls{glsfmtfirst}
+when it occurs in a header.)
+
+\cmddef{Glsxtrtitlefirst}
+The title \idx{sentencecase} \gloskey{first} field. (Normal behaviour of
+\gls{Glsfmtfirst}.)
+
+\cmddef{Glsxtrheadfirst}
+The header \idx{sentencecase} \gloskey{first} field. (The behaviour of \gls{Glsfmtfirst}
+when it occurs in a header.)
+
+\cmddef{GLSxtrtitlefirst}
+The title \idx{allcaps} \gloskey{first} field. (Normal behaviour of
+\gls{GLSfmtfirst}.)
+
+\cmddef{GLSxtrheadfirst}
+The header \idx{allcaps} \gloskey{first} field. (The behaviour of \gls{GLSfmtfirst}
+when it occurs in a header.)
+
+% firstplural
+
+\cmddef{glsxtrtitlefirstplural}
+The title \gloskey{firstplural} field. (Normal behaviour of \gls{glsfmtfirstpl}.)
+
+\cmddef{glsxtrheadfirstplural}
+The header \gloskey{firstplural} field. (The behaviour of \gls{glsfmtfirstpl}
+when it occurs in a header.)
+
+\cmddef{Glsxtrtitlefirstplural}
+The title \idx{sentencecase} \gloskey{firstplural} field. (Normal behaviour of
+\gls{Glsfmtfirstpl}.)
+
+\cmddef{Glsxtrheadfirstplural}
+The header \idx{sentencecase} \gloskey{firstplural} field. (The behaviour of \gls{Glsfmtfirstpl}
+when it occurs in a header.)
+
+\cmddef{GLSxtrtitlefirstplural}
+The title \idx{allcaps} \gloskey{firstplural} field. (Normal behaviour of
+\gls{GLSfmtfirstpl}.)
+
+\cmddef{GLSxtrheadfirstplural}
+The header \idx{allcaps} \gloskey{firstplural} field. (The behaviour of \gls{GLSfmtfirstpl}
+when it occurs in a header.)
+
+
+The definitions of \gls{markright}, \gls{markboth} and \gls{@starttoc}
+are saved (using \gls{let}) when \sty{glossaries-extra} loads.
+\cmddef{@glsxtr@org@markright}
+The previous definition of \gls{markright}.
+
+\cmddef{@glsxtr@org@markboth}
+The previous definition of \gls{markboth}.
+
+\cmddef{@glsxtr@org@@starttoc}
+The previous definition of \gls{@starttoc}.
+
+The \sty{glossaries-extra} definitions of \gls{markright},
+\gls{markboth} and \gls{@starttoc} all start and end with hooks that
+redefine commands that are sensitive to being in the header or
+contents.
+\cmddef{glsxtrmarkhook}
+This saves the original definitions and redefines the sensitive
+commands. This includes \gls{MakeUppercase} which is \gls{let} to
+\gls{MakeTextUppercase}.
+
+\cmddef{@glsxtrinmark}
+This redefines \gls{glsxtrifinmark} to just do its first argument
+(\meta{true}).
+\cmddef{@glsxtrnotinmark}
+This redefines \gls{glsxtrifinmark} to just do its second argument
+(\meta{false}).
+\cmddef{glsxtrrestoremarkhook}
+This restores the sensitive commands to the saved definitions.
+(For use where grouping will cause interference.)
+For example, \gls{markboth} is redefined as:
+\begin{compactcodebox}
+\cmd{renewcommand}*\marg{\gls{markboth}}[2]\marg{\%
+ \gls{glsxtrmarkhook}
+ \gls{@glsxtr@org@markboth}
+ \marg{\gls{@glsxtrinmark}\#1\gls{@glsxtrnotinmark}}\%
+ \marg{\gls{@glsxtrinmark}\#2\gls{@glsxtrnotinmark}}\%
+ \gls{glsxtrrestoremarkhook}
+}
+\end{compactcodebox}
+
+\section{Nested Links}
+\label{sec:nested}
+
+Complications arise when you use the \idx{glslike} commands in the
+value of the \gloskey{name} field (or \gloskey{text}
+or \gloskey{first} fields, if set). This tends to occur with
+abbreviations that extend other abbreviations. For example,
+SHTML is an abbreviation for SSI enabled HTML, where SSI
+is an abbreviation for Server Side Includes and HTML
+is an abbreviation for Hypertext Markup Language.
+
+For example, things can go wrong if the following is used with the
+\sty{glossaries} package:
+\begin{badcodebox}
+\gls{newacronym}\marg{ssi}\marg{SSI}\marg{Server Side Includes}
+\gls{newacronym}\marg{html}\marg{HTML}\marg{Hypertext Markup Language}
+\gls{newacronym}\marg{shtml}\marg{S\gls{gls}\marg{html}}\marg{\gls{gls}\marg{ssi} enabled \gls{gls}\marg{html}}
+\end{badcodebox}
+
+The main problems are:
+\begin{enumerate}
+\item\label{itm:nestedfirstucprob} With older versions of
+\sty{mfirstuc} and \sty{glossaries}, the \idx{sentencecase} commands,
+such as \gls{Gls}, won't work for the \code{shtml} entry on \idx{firstuse} if the
+long form is displayed before the short form (which is the
+default abbreviation style). This will attempt to do
+\begin{compactcodebox}
+\gls{gls}\marg{\gls+{uppercase} ssi} enabled \gls{gls}\marg{html}
+\end{compactcodebox}
+which just doesn't work. Grouping the \code{\gls{gls}\marg{ssi}} doesn't
+work either as this will effectively try to do:
+\begin{compactcodebox}
+\gls+{uppercase}\marg{\gls{gls}\marg{ssi}} enabled \gls{gls}\marg{html}
+\end{compactcodebox}
+This will upper case the label \code{ssi} so the entry won't be
+recognised. This problem will also occur if you use the \idx{allcaps}
+version, such as \code{\gls{GLS}\marg{shtml}}.
+
+With \sty{mfirstuc} v2.08+ and \sty{glossaries} v1.49+, this issue
+should now be resolved for \idx{sentencecase} where
+\code{\gls{gls}\marg{ssi}} will be mapped to
+\code{\gls{Gls}\marg{ssi}} within \code{\gls{Gls}\marg{shtml}}. The
+\idx{allcaps} command \code{\gls{GLS}\marg{shtml}} will treat
+\gls{gls} as an exclusion and so won't perform a case-change. See
+\sectionref{sec:casechange} for further details.
+
+\item\label{itm:nonexpandprob} The long and abbreviated forms accessed through
+\gls{glsentrylong} and \gls{glsentryshort} are no longer expandable
+and so can't be used be used in contexts that require this,
+such as PDF bookmarks.
+
+\item\label{itm:nestedsortprob} The nested commands may end up in the \gloskey{sort} key,
+which will confuse the indexing.
+
+\item\label{itm:inconsistentfirstuseprob} The \code{shtml} entry produces inconsistent results
+depending on whether the \code{ssi} or \code{html} entries have
+been used. Suppose both \code{ssi} and \code{html} are used
+before \code{shtml}. For example:
+\begin{coderesult}
+This section discusses
+\gls{gls}\marg{ssi}, \gls{gls}\marg{html} and
+\gls{gls}\marg{shtml}.
+\tcblower
+This section discusses server side includes (SSI), hypertext markup
+language (HTML) and SSI enabled HTML (SHTML).
+\end{coderesult}
+In the above, the \idx{firstuse} of the \code{shtml} entry produces
+\qt{SSI enabled HTML (SHTML)}.
+
+Now let's suppose the \code{html} entry is used before the
+\code{shtml} but the \code{ssi} entry is used after the
+\code{shtml} entry, for example:
+\begin{coderesult}
+The sample files are
+either \gls{gls}\marg{html} or
+\gls{gls}\marg{shtml}, but let's
+first discuss \gls{gls}\marg{ssi}.
+\tcblower
+The sample files are either hypertext markup language (HTML) or
+server
+side includes (SSI) enabled HTML (SHTML), but let's first discuss
+SSI.
+\end{coderesult}
+In this case, the \idx{firstuse} of the \code{shtml} entry now produces
+\qt{server side includes (SSI) enabled HTML (SHTML)}, which looks
+a bit cumbersome.
+
+Now let's suppose the \code{shtml} entry is used before (or
+without) the other two entries:
+\begin{coderesult}
+This article is an introduction
+to \gls{gls}\marg{shtml}.
+\tcblower
+This article is an introduction to server side includes (SSI)
+enabled hypertext markup language (HTML) (SHTML).
+\end{coderesult}
+Now the \idx{firstuse} of the \code{shtml} entry produces
+\qt{server side includes (SSI) enabled hypertext markup language (HTML)
+(SHTML)}, which looks strange.
+
+This is all aggravated when using just the base \sty{glossaries}
+package when the acronym style is set with
+\gls{setacronymstyle}. For example:
+\begin{compactcodebox}
+\gls{setacronymstyle}\marg{\acrstyle+{long-short}}
+\end{compactcodebox}
+as this references the label through the use of \gls{glslabel}
+when displaying the long and short forms, but this value
+changes with each use of \gls{gls}, so instead of displaying
+\qt{(SHTML)} at the end of the \gls{firstuse}, it now displays
+\qt{(HTML)}, since \gls{glslabel} has been changed to \code{html}
+by \code{\gls{gls}\marg{html}}.
+
+\begin{information}
+In v1.48, the \sty{glossaries-extra} package added grouping with
+\gls{glslinkwrcontent}, which scoped the \idx{linktext}.
+Unfortunately this grouping caused problems in math mode and had to
+be removed in v1.49. You can redefine \gls{glslinkwrcontent} to put the
+grouping back, but it still won't scope the definitions of the
+placeholder commands, such as \gls{glslabel}, which need to be
+outside of this scope for the benefit of the \idx{postlinkhook}.
+\end{information}
+
+Another oddity occurs if you reset the \code{html} entry between
+uses of the \code{shtml} entry. For example:
+\begin{compactcodebox}
+\gls{gls}\marg{shtml} ... \gls{glsreset}\marg{html}\gls{gls}\marg{shtml}
+\end{compactcodebox}
+The next use of \code{shtml} produces \qt{Shypertext markup
+language (HTML)}, which is downright weird. (This is a result of the
+short form being set to \code{S\gls{gls}\marg{html}}, but
+\code{\gls{gls}\marg{html}} is showing the full form.)
+
+Even without this, the short form has nested formatting commands,
+which amount to \code{\gls{acronymfont}\marg{S\gls{acronymfont}\marg{HTML}}}. This
+may not be a problem for some styles, but if you use one of the
+\qt{sm} styles (that use \gls{textsmaller}), this will produce
+an odd result.
+
+\item\label{itm:indexingprob} Each time the \code{shtml} entry is used, the
+\code{html} entry will also be indexed and marked as used,
+and on \idx{firstuse} this will happen to both the \code{ssi}
+and \code{html} entries. This kind of duplication in the location
+list isn't usually particularly helpful to the reader.
+
+\item\label{itm:nestedhyplinkprob} If \sty{hyperref} is in use, you'll get nested hyperlinks
+and there's no consistent way of dealing with this across the
+available PDF viewers. If on the \idx{firstuse} case, the user
+clicks on the \qt{HTML} part of the \qt{SSI enabled HTML (SHTML)}
+link, they may be directed to the HTML entry in the glossary or
+they may be directed to the SHTML entry in the glossary.
+
+\end{enumerate}
+
+For these reasons, with just the base \sty{glossaries} package, it's
+better to use the simple expandable commands like \gls{glsentrytext}
+or \gls{glsentryshort} in the definition of other entries.
+
+The \sty{glossaries-extra} package provides two other ways of
+dealing with these problems:
+\begin{enumerate}
+\item If the term can simply be treated as a
+series of previously defined entries, then consider using
+multi-entries (or compound sets), as described in
+\sectionref{sec:multientries}. This deals with all the issues,
+including case-changing.
+
+\item Use the partially-expandable \gls{glsxtrp}, described below.
+\end{enumerate}
+
+\cmddef{glsxtrp}
+where \meta{field} is the \idx{internalfieldlabel}.
+
+This command partially expands, so it will expand to
+just the \idx{field} value if it occurs in the PDF bookmarks.
+Otherwise it will behave much like the commands described in
+\sectionref{sec:headingcommands}, but with additional outer scoping and the
+\idx{postlinkhook} is suppressed.
+
+Rather than testing the existence of the given
+field, this tests the existence of \csfmt{gls\meta{field}} or
+\csfmt{glsxtr\meta{field}}, which means that it may be confused if
+the \meta{field} argument is set to something that isn't a field but
+happens to match either of those command names (such as \code{full}).
+
+Note that, as with commands like \gls{glsfmtshort}, there's no
+optional argument. The default settings are \glsopt{noindex} and
+\glsoptval{hyper}{false}. You can change this with:
+\cmddef{glsxtrsetpopts}
+The argument should be the new default options.
+
+At the start of each glossary, the default options are locally changed
+with:
+\cmddef{glossxtrsetpopts}
+This is defined as:
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{glossxtrsetpopts}}\marg{\%
+ \gls{glsxtrsetpopts}\marg{noindex}\%
+}
+\end{compactcodebox}
+This allows hyperlinks for any instance of \gls{glsxtrp} that occurs
+in the name or description, where it shouldn't be problematic.
+
+There are some shortcut commands for the most common fields:
+\cmddef{glsps}
+which is equivalent to
+\code{\gls{glsxtrp}\marg{short}\margm{entry-label}}, and
+\cmddef{glspt}
+which is equivalent to
+\code{\gls{glsxtrp}\marg{text}\margm{entry-label}}.
+
+There are also \idx{sentencecase} and \idx{allcaps} versions.
+\cmddef{Glsxtrp}
+This uses the corresponding \idx{sentencecase} command
+\csfmt{Gls\meta{field}} or \csfmt{Glsxtr\meta{field}}.
+
+\cmddef{GLSxtrp}
+This uses the corresponding \idx{allcaps} command
+\csfmt{GLS\meta{field}} or \csfmt{GLSxtr\meta{field}}.
For example:
-\begin{verbatim}
-\setabbreviationstyle[acronym]{long-short-user}
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\cmd{usepackage}\oarg{colorlinks}\marg{hyperref}
+\cmd{usepackage}\marg{glossaries-extra}
+\gls{setabbreviationstyle}\marg{long-em-short-em}
+\gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}
+\gls{newabbreviation}\marg{ssi}\marg{SSI}\marg{server-side includes}
+\gls{newabbreviation}\marg{shtml}\marg{SHTML}\marg{\gls{glsps}\marg{html} enabled
+\gls{glsps}\marg{ssi}}
+\cbeg{document}
+\gls{tableofcontents}
+\cmd{section}\marg{\gls{glsfmtlong}\marg{shtml}}
+First use: \gls{gls}\marg{shtml}, \gls{gls}\marg{html}, \gls{gls}\marg{ssi}.
+\codepar
+Next use: \gls{gls}\marg{shtml}, \gls{gls}\marg{html}, \gls{gls}\marg{ssi}.
+\codepar
+\gls{printunsrtglossaries}
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample*[arara={pdflatex,pdflatex,pdfcrop},
+ label={ex:nestedlinkglspl},
+ title={Nested link text with \cmd{glspl}},
+ description={Example document illustrating an entry that
+ references other entries within one of its fields}]
+{%
+\cmd{usepackage}\oarg{colorlinks}\marg{hyperref}^^J%
+\cmd{usepackage}\marg{glossaries-extra}^^J%
+\gls{setabbreviationstyle}\marg{long-em-short-em}^^J%
+\gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}^^J%
+\gls{newabbreviation}\marg{ssi}\marg{SSI}\marg{server-side includes}^^J%
+\gls{newabbreviation}\marg{shtml}\marg{SHTML}\marg{\gls{glsps}\marg{html} enabled
+\gls{glsps}\marg{ssi}}
+}
+{%
+\gls{tableofcontents}^^J%
+\cmd{section}\marg{\gls{glsfmtlong}\marg{shtml}}^^J%
+First use: \gls{gls}\marg{shtml}, \gls{gls}\marg{html}, \gls{gls}\marg{ssi}.
+\codepar
+Next use: \gls{gls}\marg{shtml}, \gls{gls}\marg{html}, \gls{gls}\marg{ssi}.
+\codepar
+\gls{printunsrtglossaries}
+}
+\end{resultbox}
-\newacronym{tug}{TUG}{\TeX\ User Group}
+The way that this works is as follows:
+\begin{itemize}
+\item \code{\gls{glsfmtlong}\marg{shtml}} expands to
+\code{\gls{glsentrylong}\marg{shtml}} within the PDF bookmarks,
+which expands to the value of the \gloskey{long} field:
+\begin{compactcodebox}
+\gls{glsps}\marg{html} enabled \gls{glsps}\marg{ssi}
+\end{compactcodebox}
+This means that \gls{glsps} (within the PDF bookmarks) in turn expands to
+\gls{glsentryshort}. So the bookmark text (which can't contain any
+formatting commands) ends up as \qt{HTML enabled SSI}.
+
+\item \code{\gls{glsfmtlong}\marg{shtml}} essentially
+behaves like \gls{glsxtrlong}, but with the \idx{indexing} and
+hyperlink suppressed. The \idx{linktext} is the value of the
+\gloskey{long} field encapsulated with the abbreviation style's
+formatting command (\gls{glslongemfont} in this case):
+\begin{compactcodebox}
+\gls{glslongemfont}\marg{\gls{glsps}\marg{html} enabled \gls{glsps}\marg{ssi}}
+\end{compactcodebox}
+This then becomes:
+\begin{compactcodebox}
+\gls{glslongemfont}\marg{\marg{\gls{let}\gls{glspostlinkhook}\gls{relax}
+ \gls{glsxtrshort}\marg{html}} enabled
+\marg{\gls{let}\gls{glspostlinkhook}\gls{relax}
+ \gls{glsxtrshort}\marg{ssi}}}
+\end{compactcodebox}
+Note the grouping and localised suppression of the
+\idx{postlinkhook}.
+\end{itemize}
-\newacronym
- [user1={German Speaking \TeX\ User Group}]
- {dante}{DANTE}{Deutschsprachige Anwendervereinigung \TeX\ e.V}
+Note that in the above example, with older versions of
+\sty{mfirstuc} and \sty{glossaries}, it's not possible to use
+\code{\gls{Glsxtrlong}\marg{shtml}} or similar. The problem here is
+that it will attempt to do:
+\begin{compactcodebox}
+\gls{makefirstuc}\marg{\gls{glsps}\marg{html} enabled \gls{glsps}\marg{ssi}}
+\end{compactcodebox}
+This will essentially end up as:
+\begin{compactcodebox}
+\gls{glsps}\marg{\gls{uppercase} html} enabled \gls{glsps}\marg{ssi}
+\end{compactcodebox}
+which doesn't work. If you want to protect against automated
+case-changes, such as using the \catattr{glossdesc} attribute,
+insert an empty brace at the start:
+\begin{compactcodebox}
+\gls{newabbreviation}\marg{shtml}\marg{SHTML}\marg{\marg{}\gls{glsps}\marg{html} enabled
+\gls{glsps}\marg{ssi}}
+\end{compactcodebox}
+Alternatively, upgrade to \sty{mfirstuc} v2.08+ and \sty{glossaries}
+v4.50+. See \sectionref{sec:casechange}.
+
+
+\section{Adjusting the Text Style}
+\label{sec:entryfmtmods}
-\end{verbatim}
-On first use, \verb|\gls{tug}| will appear as:
-\begin{quote}
-\TeX\ User Group (TUG)
-\end{quote}
-whereas \verb|\gls{dante}| will appear as:
-\begin{quote}
-Deutschsprachige Anwendervereinigung \TeX\ e.V (DANTE, German Speaking \TeX\ User Group)
-\end{quote}
+The \idx{glslike} and \idx{glstextlike} commands produce text that's
+essentially formatted either as (\glsoptval{hyperoutside}{true}):
+\begin{compactcodebox}
+\meta{hyper-cs}\margm{target}\marg{\meta{textformat-cs}\margm{content}}\meta{post-link hook}
+\end{compactcodebox}
+or (\glsoptval{hyperoutside}{false}):
+\begin{compactcodebox}
+\meta{textformat-cs}\marg{\meta{hyper-cs}\margm{target}\margm{content}}\meta{post-link hook}
+\end{compactcodebox}
+If hyperlinks are enabled then \meta{hyper-cs} creates the hyperlink
+based on \meta{target} with the hyperlink text given by the second
+argument. If hyperlinks aren't enabled then \meta{hyper-cs} ignores
+the \meta{target} argument and simply does the second argument.
+
+The \meta{content} part is the \idx{linktext}, which includes the
+final optional \meta{insert} (if supplied). The actual content
+depends on the command used (for example, \gls{gls} or
+\gls{glstext}). The \idx{glslike} commands all use
+the entry display style associated with the entry's \idx{glossary}
+type, (see \sectionref{sec:entryfmt}). The \idx{glstextlike} commands set the
+\meta{content} to the corresponding field value with the insert
+appended, all encapsulated with the inner formatting (see
+\sectionref{sec:innertextformat}), with appropriate case-changing,
+if required.
+
+The abbreviation commands (\gls{glsxtrshort}, \gls{glsxtrlong},
+\gls{glsxtrfull} etc) are considered part of the set of
+\idx{glstextlike} commands, but the content is set according to the
+abbreviation style (see \sectionref{sec:abbrstyle}).
+
+The commands \gls{glsdisp} and \gls{glslink} both have the content
+part explicitly set in their final argument. There's no insert
+optional argument as it can simply be included in the content part.
+The difference between them is that \gls{glsdisp} is considered a
+\idx{glslike} command (it unsets the \idx{firstuseflag},
+\sectionref{sec:glsunset}, and uses the entry display style,
+\sectionref{sec:entryfmt}), whereas \gls{glslink} is considered a
+\idx{glstextlike} command.
+
+The \meta{post-link hook} part is described in
+\sectionref{sec:postlinkhook}.
+
+The \meta{textformat-cs} command is the \emph{outer} formatting
+command, described in \sectionref{sec:glstextformat}. This doesn't
+include the \idx{postlinkhook}. If you want to include the
+\idx{postlinkhook} then you need to encapsulate the entire
+\idx{glslike} and \idx{glstextlike} command (including the final
+optional argument, if present, and following punctuation, if the
+\idx{postlinkhook} looks ahead for punctuation).
+
+Some sensitive formatting commands need to have the actual text in
+their argument (or else have the argument in an unbreakable box).
+The \meta{content} part is usually too complicated for these
+commands. To help support this type of command, there is also an
+\idxc{innerformatting}{inner format}, which is described in
+\sectionref{sec:innertextformat}. In general, unless you require one
+of these sensitive commands, avoid setting the inner text format as
+it requires support from the underlying style (either the entry
+format style or the abbreviation style), which may not be available.
+
+The following example document is ugly, but demonstrates the outer
+formatting (\texttt{type\-writer} font), middle formatting
+(\textbf{bold} for regular entries and \textit{italic} for
+abbreviations), inner formatting (highlighted in yellow), hyperlinks
+(red), and the \idx{catpostlinkhook} (the description follows in
+parentheses for general entries on \idx{firstuse}).
+\begin{codebox}
+\cmd{usepackage}\marg{courier}
+\cmd{usepackage}[T1]\marg{fontenc}
+\cmd{usepackage}\marg{xcolor}
+\cmd{usepackage}\marg{soul}
+\cmd{usepackage}[colorlinks]\marg{hyperref}
+\cmd{usepackage}[\opt{nogroupskip}]\marg{glossaries-extra}
+\comment{outer formatting:}
+\cmd{renewcommand}\marg{\gls{glstextformat}}[1]\marg{\cmd{texttt}\marg{\#1}}
+\comment{middle formatting:}
+\cmd{renewcommand}\marg{\gls{glsxtrregularfont}}[1]\marg{\cmd{textbf}\marg{\#1}}
+\cmd{renewcommand}\marg{\gls{glsxtrabbreviationfont}}[1]\marg{\cmd{textit}\marg{\#1}}
+\comment{inner formatting:}
+\cmd{renewcommand}\marg{\gls{glsxtrdefaultentrytextfmt}}[1]\marg{\cmd{hl}\marg{\#1}}
+\comment{post-link hook for 'general' category:}
+\gls{glsdefpostlink}\marg{\cat{general}}\marg{\gls{glsxtrpostlinkAddDescOnFirstUse}}
+\comment{define entries:}
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{an example}}
+\gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}
+\gls{newacronym}\marg{nasa}\marg{NASA}\marg{National Aeronautics and Space Administration}
+\cbeg{document}
+First use: \gls{gls}\marg{sample}, \gls{gls}\marg{html}, \gls{gls}\marg{nasa}.
+\codepar
+Next use: \gls{gls}\marg{sample}, \gls{gls}\marg{html}, \gls{gls}\marg{nasa}.
+\gls{printunsrtglossaries}
+\cend{document}
+\end{codebox}
+This produces:
+\begin{resultbox}
+\createexample*[fontsize={14},
+ label={ex:linktextstyles},
+title={Link text styles: outer, middle, inner, hyperlinks and post-link hook},
+ description={An example document that illustrates the outer, middle
+and inner formatting, hyperlinks and a category post-link hook}]
+{
+\cmd{usepackage}\marg{courier}^^J%
+\cmd{usepackage}[T1]\marg{fontenc}^^J%
+\cmd{usepackage}\marg{xcolor}^^J%
+\cmd{usepackage}\marg{soul}^^J%
+\cmd{usepackage}[colorlinks]\marg{hyperref}^^J%
+\cmd{usepackage}[nogroupskip]\marg{glossaries-extra}^^J%
+\% outer formatting:^^J%
+\cmd{renewcommand}\marg{\gls{glstextformat}}[1]\marg{\cmd{texttt}\marg{\#1}}^^J%
+\% middle formatting:^^J%
+\cmd{renewcommand}\marg{\gls{glsxtrregularfont}}[1]\marg{\cmd{textbf}\marg{\#1}}^^J%
+\cmd{renewcommand}\marg{\gls{glsxtrabbreviationfont}}[1]\marg{\cmd{textit}\marg{\#1}}^^J%
+\% inner formatting:^^J%
+\cmd{renewcommand}\marg{\gls{glsxtrdefaultentrytextfmt}}[1]\marg{\cmd{hl}\marg{\#1}}^^J%
+\% post-link hook for 'general' category:^^J%
+\gls{glsdefpostlink}\marg{general}\marg{\gls{glsxtrpostlinkAddDescOnFirstUse}}^^J%
+\% define entries:^^J%
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{an example}}^^J%
+\gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}^^J%
+\gls{newacronym}\marg{nasa}\marg{NASA}\marg{National Aeronautics and Space Administration}
+}
+{
+First use: \gls{gls}\marg{sample}, \gls{gls}\marg{html}, \gls{gls}\marg{nasa}.
+\codepar
+Next use: \gls{gls}\marg{sample}, \gls{gls}\marg{html}, \gls{gls}\marg{nasa}.
+\codepar
+\gls{printunsrtglossaries}
+}
+\end{resultbox}
+Note that the hyperlink, outer and middle formatting aren't applied
+to the \idx{postlinkhook}. The \cat{acronym} category has the
+\abbrstyle{short-nolong} abbreviation style, which sets the
+\catattr{regular} attribute to true. This means that the NASA entry
+uses the regular middle format (\gls{glsxtrregularfont}) not the
+abbreviation middle format (\gls{glsxtrabbreviationfont}).
+
+If you have a formatting command that needs to have its argument
+fully-expanded before being applied, you may be able to use:
+\cmddef{GlsXtrExpandedFmt}
+This fully-expands \meta{content} and does
+\code{\meta{cs}\margm{expanded-content}}, where \meta{cs} is a
+command that takes a single argument. For example, to use
+\sty{soul}['s] underlining command \gls{ul}:
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{glsxtrregularfont}}\oarg{1}\marg{\gls{GlsXtrExpandedFmt}\marg{\#1}}
+\end{codebox}
+(See \exampleref{ex:protectinnertextformat}.)
+This isn't guaranteed to work as the \idx{linktext} may contain
+fragile content.
+
+The inner formatting can be unpredictable. For example,
+abbreviation styles are complicated and so the inner formatting
+command is included in some of the field values, such as the
+\gloskey{name}, which is why the abbreviation name is highlighted in
+the \idx{glossary}. In the above example, the inner formatting is
+included in the \idx{catpostlinkhook}, but only because
+\gls{glsxtrpostlinkAddDescOnFirstUse} is designed to include it. If
+the \idx{catpostlinkhook} was simply defined as:
+\begin{codebox}
+\gls{glsdefpostlink}\marg{general}\marg{\%
+ \gls{glsxtrifwasfirstuse}\marg{ (\gls{glsentrydesc}\marg{\gls{glslabel}})}\marg{}}
+\end{codebox}
+then the inner formatting won't be applied, since it's not included
+in the hook. This is demonstrated in a slightly modified version of
+the above document (initial part of preamble that deals with loading packages and
+redefining formatting commands as before):
+\begin{codebox}
+\comment{post-link hook for 'general' category:}
+\gls{glsdefpostlink}\marg{general}\marg{\%
+ \gls{glsxtrifwasfirstuse}\marg{ (\gls{glsentrydesc}\marg{\gls{glslabel}})}\marg{}}
+\comment{this style sets the post-link hook for 'abbreviation' category:}
+\gls{setabbreviationstyle}\marg{\abbrstyle{long-postshort-user}}
+\comment{this style sets the post-link hook for 'acronym' category:}
+\gls{setabbreviationstyle}\oarg{\cat{acronym}}\marg{\abbrstyle{short-postfootnote}}
+\comment{define entries:}
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{an example}}
+\gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}
+\gls{newacronym}\marg{nasa}\marg{NASA}\marg{National Aeronautics and Space Administration}
+\cbeg{document}
+First use: \gls{gls}\marg{sample}, \gls{gls}\marg{html}, \gls{gls}\marg{nasa}.
+\codepar
+Next use: \gls{gls}\marg{sample}, \gls{gls}\marg{html}, \gls{gls}\marg{nasa}.
+\gls{printunsrtglossaries}
+\cend{document}
+\end{codebox}
+This produces:
+\begin{resultbox}
+\createexample*[graphicsopts={scale=0.5},fontsize={14},
+ label={ex:linktextstylescustom},
+ title={Link text styles: outer, middle, inner,
+hyperlinks and post-link hooks (custom and abbreviation style)},
+ description={An example document that illustrates the outer, middle
+and inner formatting, and hyperlinks, with a custom category
+post-link hook and abbreviation style that sets the category
+post-link hook}]
+{
+\cmd{usepackage}\marg{courier}^^J%
+\cmd{usepackage}[T1]\marg{fontenc}^^J%
+\cmd{usepackage}\marg{xcolor}^^J%
+\cmd{usepackage}\marg{soul}^^J%
+\cmd{usepackage}[colorlinks]\marg{hyperref}^^J%
+\cmd{usepackage}[nogroupskip]\marg{glossaries-extra}^^J%
+\% outer formatting:^^J%
+\cmd{renewcommand}\marg{\gls{glstextformat}}[1]\marg{\cmd{texttt}\marg{\#1}}^^J%
+\% middle formatting:^^J%
+\cmd{renewcommand}\marg{\gls{glsxtrregularfont}}[1]\marg{\cmd{textbf}\marg{\#1}}^^J%
+\cmd{renewcommand}\marg{\gls{glsxtrabbreviationfont}}[1]\marg{\cmd{textit}\marg{\#1}}^^J%
+\% inner formatting:^^J%
+\cmd{renewcommand}\marg{\gls{glsxtrdefaultentrytextfmt}}[1]\marg{\cmd{hl}\marg{\#1}}^^J%
+\% post-link hook for 'general' category:^^J%
+\gls{glsdefpostlink}\marg{general}\marg{\gls{glsxtrifwasfirstuse}\marg{
+(\gls{glsentrydesc}\marg{\gls{glslabel}})}\marg{}}^^J%
+\% this style sets the post-link hook for 'abbreviation' category:^^J%
+\gls{setabbreviationstyle}\marg{long-postshort-user}^^J%
+\% this style sets the post-link hook for 'acronym' category:^^J%
+\gls{setabbreviationstyle}\oarg{acronym}\marg{short-postfootnote}^^J%
+\% define entries:^^J%
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{an example}}^^J%
+\gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}^^J%
+\gls{newacronym}\marg{nasa}\marg{NASA}\marg{National Aeronautics and Space Administration}
+}
+{
+First use: \gls{gls}\marg{sample}, \gls{gls}\marg{html}, \gls{gls}\marg{nasa}.
+\codepar
+Next use: \gls{gls}\marg{sample}, \gls{gls}\marg{html}, \gls{gls}\marg{nasa}.
+\codepar
+\gls{printunsrtglossaries}
+}
+\end{resultbox}
+The \qt{post} abbreviation styles put some content into the
+\idx{postlinkhook} and provide support for the inner formatting.
+The above example sets the abbreviation style
+to \abbrstyle{long-postshort-user}. This sets up the
+\idx{postlinkhook} for the associated category
+(\cat{abbreviation}, in this case) to show the parenthetical
+material. Be aware that this will override
+any previous definition of that hook. This style supports the inner
+formatting (so the parenthetical material is highlighted).
+
+Similarly, the \abbrstyle{short-postfootnote} style is applied to
+the \cat{acronym} category, and sets the \idx{postlinkhook} for that
+category (which looks head for punctuation). The inner formatting is
+applied to the footnote text but not the marker.
+
+The \idx{postlinkhook} for the \cat{general} category is now much
+simpler and doesn't include support for the inner formatting, so
+it's not highlighted.
+
+None of the post-link content is incorporated into the
+hyperlink, outer or middle formatting.
+
+In general, it's better to adjust the abbreviation's style commands
+(see \sectionref{sec:abbrvcmds}) rather than use the middle
+or inner formatting if abbreviations need to be displayed in a particular
+font.
+
+\subsection{Outer Formatting}
+\label{sec:glstextformat}
+
+By default, the outer formatting is produced with \gls{glstextformat}, which is
+defined by the base \sty{glossaries} package. However it can be
+replaced by the \catattr{textformat} category attribute or by the
+\glsopt{textformat} option. The order of precedence (not cumulative) is:
+the option supplied to the \idx{glslike} or \idx{glstextlike}
+command, the category attribute, \gls{glstextformat}.
-The short form is formatted according to
-\begin{definition}[\DescribeMacro\glsabbrvuserfont]
-\cs{glsabbrvuserfont}\marg{text}
-\end{definition}
-and the plural suffix is given by
-\begin{definition}[\DescribeMacro\glsxtrusersuffix]
-\cs{glsxtrusersuffix}
-\end{definition}
-
-These may be redefined as appropriate. For example,
-if you want a~smallcaps style, you can just set these commands
-to those used by the \abbrstyle{long-short-sc} style:
-\begin{verbatim}
-\renewcommand{\glsabbruserfont}[1]{\glsabbrvscfont{#1}}
-\renewcommand{\glsxtrusersuffix}{\glsxtrscsuffix}
-\end{verbatim}
-
-\item[\abbrstyledef{long-noshort-noreg}]
-This style is like \abbrstyle{long-noshort} but it doesn't
-set the \catattr{regular} attribute.
-
-\item[\abbrstyledef{long-noshort-desc-noreg}]
-This style is like \abbrstyle{long-noshort-desc} but it doesn't
-set the \catattr{regular} attribute.
-
-\item[\abbrstyledef{long-short-desc}]
-On \gls{firstuse}, this style uses the format \meta{long} (\meta{short}).
-The inline and display full forms are the same. The \gloskey{name}
-is set to the full form. The \gloskey{sort} key is set to
-\meta{long} (\meta{short}). Before version 1.04, this was
-incorrectly set to the short form. If you want to revert back to
-this you can redefine
-\begin{definition}[\DescribeMacro\glsxtrlongshortdescsort]
-\cs{glsxtrlongshortdescsort}
-\end{definition}
For example:
-\begin{verbatim}
-\renewcommand*{\glsxtrlongshortdescsort}{\the\glsshorttok}
-\end{verbatim}
-The \gloskey{description} must be supplied by the user.
-The long and short forms are separated by \cs{glsxtrfullsep}. The \gloskey{name}
-field is obtained from
-\begin{definition}[\DescribeMacro\glsxtrlongshortdescname]
-\cs{glsxtrlongshortdescname}
-\end{definition}
-(Similarly for other
-\texttt{long}\meta{modifier}\texttt{-short}\meta{modifier}\texttt{-desc}
-styles, unless indicated otherwise.)
-Any redefinition of this command must come before the abbreviations
-are defined as it expands on definition. Make sure you protect
-any commands that shouldn't be expanded. The long form can be
-referenced with \cs{the}\cs{glslongtok} and the short form
-can be referenced with \cs{the}\cs{glsshorttok}.
-
-\item[\abbrstyledef{long-short-sc-desc}]
-Like \abbrstyle{long-short-desc} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvscfont}.
-
-\item[\abbrstyledef{long-short-sm-desc}]
-Like \abbrstyle{long-short-desc} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvsmfont}.
-
-\item[\abbrstyledef{long-short-em-desc}]
-Like \abbrstyle{long-short-desc} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvemfont}.
-
-\item[\abbrstyledef{long-em-short-em-desc}]
-New to version 1.04, this style is like \abbrstyle{long-short-em-desc} but redefines \cs{glsfirstlongfont} to
-use \ics{glsfirstlongemfont}.
-
-\item[\abbrstyledef{long-em-noshort-em-desc-noreg}]
-New to version 1.17, this style is like
-\abbrstyle{long-em-noshort-em-desc} but
-doesn't set the \catattr{regular} attribute.
-
-
-\item[\abbrstyledef{long-short-user-desc}]
-New to version 1.04, this style is like a~cross between the
-\abbrstyle{long-short-desc} style and the
-\abbrstyle{long-short-user} style. The display and inline forms are
-as for \abbrstyle{long-short-user} and the \gloskey{name} key is
-obtained from
-\begin{definition}[\DescribeMacro\glsxtrlongshortuserdescname]
-\cs{glsxtrlongshortuserdescname}
-\end{definition}
-Again, this should only be redefined before \cs{newabbreviation} (or
-\cs{newacronym}), and fragile and formatting commands need protecting.
-
-The \gloskey{description} key must be
-supplied in the optional argument of \cs{newabbreviation}
-(or \cs{newacronym}). The \gloskey{sort} key is set to \meta{long}
-(\meta{short}) as per the \abbrstyle{long-short-desc} style.
-
-\item[\abbrstyledef{short-nolong-noreg}]
-This is like \abbrstyle{short-nolong} but doesn't set the
-\catattr{regular} attribute.
-
-\item[\abbrstyledef{nolong-short-noreg}]
-This is like \abbrstyle{nolong-short} but doesn't set the
-\catattr{regular} attribute.
-
-\item[\abbrstyledef{short-long}]
-On \gls{firstuse}, this style uses the format \meta{short} (\meta{long}).
-The inline and display full forms are the same. The \gloskey{name}
-and \gloskey{sort} keys are set to the short form. The
-\gloskey{description} is set to the long form.
-The short and long forms are separated by \cs{glsxtrfullsep}.
-If you want to insert
-material within the parentheses (such as a~translation), try the
-\abbrstyle{short-long-user} style.
-
-The \gloskey{name} field is obtained from
-\begin{definition}[\DescribeMacro\glsxtrshortlongname]
-\cs{glsxtrshortlongname}
-\end{definition}
-(Similarly for other
-\texttt{short}\meta{modifier}\texttt{-long}\meta{modifier} styles,
-unless indicated otherwise.)
-Any redefinition of this command must come before the abbreviations
-are defined as it expands on definition. Make sure you protect
-any commands that shouldn't be expanded. The long form can be
-referenced with \cs{the}\cs{glslongtok} and the short form
-can be referenced with \cs{the}\cs{glsshorttok}.
-
-
-\item[\abbrstyledef{short-sc-long}]
-Like \abbrstyle{short-long} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvscfont}.
-
-\item[\abbrstyledef{short-sm-long}]
-Like \abbrstyle{short-long} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvsmfont}.
-
-\item[\abbrstyledef{short-em-long}]
-Like \abbrstyle{short-long} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvemfont}.
-
-\item[\abbrstyledef{short-em-long-em}]
-New to version 1.04, this style is like \abbrstyle{short-em-long} but redefines \cs{glsfirstlongfont} to
-use \ics{glsfirstlongemfont}.
-
-\item[\abbrstyledef{short-long-user}]
-New to version 1.04. This style is like the
-\abbrstyle{long-short-user} style but with the long and short forms
-switched. The parenthetical material is governed by the same command
-\ics{glsxtruserparen}, but the first argument supplied to it is
-the long form instead of the short form. The \gloskey{name} field is
-obtained by expanding
-\begin{definition}[\DescribeMacro\glsxtrshortlongname]
-\cs{glsxtrshortlongname}
-\end{definition}
-Again, this should only be redefined before \cs{newabbreviation} (or
-\cs{newacronym}) and commands that should be expanded need to be
-protected. The \gloskey{description} is set to
-\cs{glsuserdescription}\marg{long}\marg{label}.
-
-\item[\abbrstyledef{short-nolong-desc-noreg}]
-This style is like \abbrstyle{short-nolong-desc} but it doesn't
-set the \catattr{regular} attribute.
-
-\item[\abbrstyledef{short-long-desc}]
-On \gls{firstuse}, this style uses the format \meta{short} (\meta{long}).
-The inline and display full forms are the same. The \gloskey{name}
-is set to the full form. The
-\gloskey{description} must be supplied by the user.
-The short and long forms are separated by \cs{glsxtrfullsep}. The \gloskey{name}
-field is obtained from
-\begin{definition}[\DescribeMacro\glsxtrshortlongdescname]
-\cs{glsxtrshortlongdescname}
-\end{definition}
-(Similarly for other
-\texttt{short}\meta{modifier}\texttt{-long}\meta{modifier}\texttt{-desc}
-styles, unless indicated otherwise.)
-Any redefinition of this command must come before the abbreviations
-are defined as it expands on definition. Make sure you protect
-any commands that shouldn't be expanded. The long form can be
-referenced with \cs{the}\cs{glslongtok} and the short form
-can be referenced with \cs{the}\cs{glsshorttok}.
-
-\item[\abbrstyledef{short-sc-long-desc}]
-Like \abbrstyle{short-long-desc} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvscfont}.
-
-\item[\abbrstyledef{short-sm-long-desc}]
-Like \abbrstyle{short-long-desc} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvsmfont}.
-
-\item[\abbrstyledef{short-em-long-desc}]
-Like \abbrstyle{short-long-desc} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvemfont}.
-
-\item[\abbrstyledef{short-em-long-em-desc}]
-New to version 1.04, this style is like \abbrstyle{short-em-long-desc} but redefines \cs{glsfirstlongfont} to
-use \ics{glsfirstlongemfont}.
-
-\item[\abbrstyledef{short-long-user-desc}]
-New to version 1.04, this style is like a~cross between the
-\abbrstyle{short-long-desc} style and the
-\abbrstyle{short-long-user} style. The display and inline forms are
-as for \abbrstyle{short-long-user}, but the \gloskey{name} key is
-obtained from
-\begin{definition}[\DescribeMacro\glsxtrshortlonguserdescname]
-\cs{glsxtrshortlonguserdescname}
-\end{definition}
-Again, this should only be redefined before \cs{newabbreviation} (or
-\cs{newacronym}), and fragile and formatting commands need protecting.
-
-The \gloskey{description} key must be
-supplied in the optional argument of \cs{newabbreviation}
-(or \cs{newacronym}).
-
-\item[\abbrstyledef{short-footnote}]
-On \gls{firstuse}, this style displays the short form with the long form
-as a footnote. This style automatically sets the
-\catattr{nohyperfirst} attribute to \qt{true} for the supplied
-category, so the \gls{firstuse} won't be hyperlinked (but the footnote
-marker may be, if the \sty{hyperref} package is used).
-
-The inline full form uses the \meta{short}
-(\meta{long}) style. The \gloskey{name} is set to the short form.
-The \gloskey{description} is set to the long form. The
-\gloskey{name} key is obtained by expanding:
-\begin{definition}[\DescribeMacro\glsxtrfootnotename]
-\cs{glsxtrfootnotename}
-\end{definition}
-(Similarly for other
-\texttt{short\meta{modifier}-\meta{modifier}footnote} styles, unless
-indicated otherwise.) Again, this command should only be redefined
-before \cs{newabbreviation} (or \cs{newacronym}), and fragile or
-formatting commands should be protected from expansion.
-
-As from version 1.05, all the footnote styles use:
-\begin{definition}[\DescribeMacro\glsfirstlongfootnotefont]
-\cs{glsfirstlongfootnotefont}\marg{text}
-\end{definition}
-to format the long form on \gls{firstuse} or for the full form and
-\begin{definition}[\DescribeMacro\glslongfootnotefont]
-\cs{glslongfootnotefont}\marg{text}
-\end{definition}
-to format the long form elsewhere (for example, when used with
-\cs{glsxtrlong}).
-
-As from version 1.07, all the footnote styles use:
-\begin{definition}[\DescribeMacro\glsxtrabbrvfootnote]
-\cs{glsxtrabbrvfootnote}\marg{label}\marg{long}
-\end{definition}
-By default, this just does \ics{footnote}\marg{long} (the first
-argument is ignored). For example, to make the footnote text
-link to the relevant place in the glossary:
-\begin{verbatim}
-\renewcommand{\glsxtrabbrvfootnote}[2]{%
- \footnote{\glshyperlink[#2]{#1}}%
-}
-\end{verbatim}
-or to include the short form with a hyperlink:
-\begin{verbatim}
-\renewcommand{\glsxtrabbrvfootnote}[2]{%
- \footnote{\glshyperlink[\glsfmtshort{#1}]{#1}: #2}%
-}
-\end{verbatim}
-Note that I haven't used commands like \cs{glsxtrshort} to
-avoid interference (see \sectionref{sec:entryfmtmods}
-and \sectionref{sec:nested}).
-
-\item[\abbrstyledef{footnote}] A synonym for
-\abbrstyle{short-footnote}.
-
-\item[\abbrstyledef{short-sc-footnote}]
-Like \abbrstyle{short-footnote} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvscfont}.
-(This style was originally called \depabbrstyle{footnote-sc}. Renamed in version
-1.04, but original name retained as a deprecated synonym for
-backward-compatibility.)
-
-\item[\abbrstyledef{short-sc-footnote}]
-Like \abbrstyle{short-footnote} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvsmfont}.
-(This style was originally called \depabbrstyle{footnote-sm}. Renamed in version
-1.04, but original name retained as a deprecated synonym for
-backward-compatibility.)
-
-\item[\abbrstyledef{short-em-footnote}]
-Like \abbrstyle{short-footnote} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvemfont}.
-(This style was originally called \depabbrstyle{footnote-em}. Renamed in version
-1.04, but original name retained as a deprecated synonym for
-backward-compatibility.)
-
-\item[\abbrstyledef{short-footnote-desc}]
-(New to v1.42.)
-This is similar to \abbrstyle{short-footnote}, but the
-\gloskey{description} must be supplied by the user.
-The \gloskey{name} field is obtained from:
-\begin{definition}[\DescribeMacro\glsxtrfootnotedescname]
-\cs{glsxtrfootnotedescname}
-\end{definition}
-which defaults to \meta{short} followed by \meta{long} in
-parentheses, and the \gloskey{sort} field is obtained from:
-\begin{definition}[\DescribeMacro\glsxtrfootnotedescsort]
-\cs{glsxtrfootnotedescsort}
-\end{definition}
-which defaults to just the short form. (Similarly for other
-\texttt{short}\meta{modifier}\texttt{-[post]footnote}\texttt{-desc}
-styles, unless indicated otherwise.)
-
-Any redefinition of these commands must come before the abbreviations
-are defined as it expands on definition. Make sure you protect
-any commands that shouldn't be expanded. The long form can be
-referenced with \cs{the}\cs{glslongtok} and the short form
-can be referenced with \cs{the}\cs{glsshorttok}.
-
-\item[\abbrstyledef{footnote-desc}]
-A synonym for \abbrstyle{short-footnote-desc}.
+\begin{codebox}
+\cmd{usepackage}[colorlinks]\marg{hyperref}
+\cmd{usepackage}\marg{glossaries-extra}
+\gls{glsdefpostlink}\marg{general}\marg{ (\gls{glsentrydesc}\marg{\gls{glslabel}})}
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{an example}}
+\cmd{newcommand}\marg{\cmd{strong}}[1]\marg{\cmd{textbf}\marg{\cmd{color}\marg{green}\#1}}
+\cmd{renewcommand}\marg{\gls{glstextformat}}[1]\marg{\cmd{emph}\marg{\#1}}
+\cbeg{document}
+\gls{gls}\marg{sample}\oarg{-insert}. \cmd{strong}\marg{\gls{gls}\marg{sample}\oarg{-insert}}.
+\codepar
+\gls{glssetcategoryattribute}\marg{\cat{general}}\marg{\catattr{textformat}}\marg{strong}
+\gls{gls}\marg{sample}\oarg{-insert}.
+\gls{gls}\oarg{\glsoptval{hyperoutside}{false}}\marg{sample}\oarg{-insert}.
+\codepar
+\gls{gls}\oarg{\glsoptval{textformat}{textsf}}\marg{sample}\oarg{-insert}.
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample*[title={Changing the outer text format},
+ label={ex:textformat},
+ description={Example document illustrating the difference between
+\cmd{glstextformat}, the \optfmt{textformat} category attribute, and
+the \optfmt{textformat} option}]
+{\cmd{usepackage}[colorlinks]\marg{hyperref}^^J%
+\cmd{usepackage}\marg{glossaries-extra}^^J%
+\gls{glsdefpostlink}\marg{general}\marg{ (\gls{glsentrydesc}\marg{\gls{glslabel}})}^^J%
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{an example}}^^J%
+\cmd{newcommand}\marg{\cmd{strong}}[1]\marg{\cmd{textbf}\marg{\cmd{color}\marg{green}\#1}}
+\cmd{renewcommand}\marg{\gls{glstextformat}}[1]\marg{\cmd{emph}\marg{\#1}}
+}{%
+\gls{gls}\marg{sample}\oarg{-insert}. \cmd{strong}\marg{\gls{gls}\marg{sample}\oarg{-insert}}.
+\codepar
+\gls{glssetcategoryattribute}\marg{general}\marg{textformat}\marg{strong}
+\gls{gls}\marg{sample}\oarg{-insert}.
+\gls{gls}\oarg{hyperoutside=false}\marg{sample}\oarg{-insert}.
+\codepar
+\gls{gls}\oarg{textformat=textsf}\marg{sample}\oarg{-insert}.
+}
+\end{resultbox}
+The red text colour is from the hyperlink (red is the
+default with \sty{hyperref}['s] \optfmt{colorlinks} option).
+The green from the custom \csfmt{strong} command is cancelled by the
+hyperlink colour change when the hyperlink is inside \csfmt{strong}.
+
+After the \catattr{textformat} attribute is set, the
+\gls{glstextformat} command isn't used, which is why the remaining
+lines don't have any italic. The final line uses the
+\glsopt{textformat} option, which overrides the
+\catattr{textformat} attribute, so neither \gls{glstextformat} nor the custom
+\csfmt{strong} are used.
+
+Note that the only time that the \idx{postlinkhook} is included in
+the formatting is when the entire \gls{gls} command has been
+encapsulated.
+
+\subsection{Middle Formatting}
+\label{sec:middleformat}
+
+The middle formatting comes between the outer formatting
+(\sectionref{sec:glstextformat} above) and the \idx{innerformatting}
+(\sectionref{sec:innertextformat} below).
+
+The middle formatting is implemented by the entry format style
+(\sectionref{sec:entryfmt}) for the \idx{glslike} commands or is
+initialised by \gls{glsxtrassignfieldfont} for the \idx{glstextlike}
+commands.
-\item[\abbrstyledef{short-sc-footnote-desc}]
-Like \abbrstyle{short-footnote-desc} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvscfont}.
-
-\item[\abbrstyledef{short-sm-footnote-desc}]
-Like \abbrstyle{short-footnote-desc} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvsmfont}.
-
-\item[\abbrstyledef{short-em-footnote-desc}]
-Like \abbrstyle{short-footnote-desc} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvemfont}.
-
-\item[\abbrstyledef{short-postfootnote}]
-This is similar to the \abbrstyle{short-footnote} style but doesn't modify
-the category attribute. Instead it changes \postlinkcat\ to
-insert the footnote after the
-\gls{linktext} on \gls{firstuse}. This will also defer the footnote until after any
-following punctuation character that's recognised by
-\ics{glsxtrifnextpunc}.
-
-The inline full form uses the \meta{short}
-(\meta{long}) style. The \gloskey{name} is set to the short form.
-The \gloskey{description} is set to the long form.
-Note that this style will change \cs{glsxtrfull} (and its variants)
-so that it fakes non-\gls{firstuse}. (Otherwise the footnote would
-appear after the inline form.)
-
-\item[\abbrstyledef{postfootnote}] A synonym for
-\abbrstyle{short-postfootnote}.
+If you provide your own custom entry format style you will need to
+add support for the middle formatting, if required.
-\item[\abbrstyledef{short-sc-postfootnote}]
-Like \abbrstyle{short-postfootnote} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvscfont}.
-(This style was originally called \depabbrstyle{postfootnote-sc}. Renamed in version
-1.04, but original name retained as a deprecated synonym for
-backward-compatibility.)
-
-\item[\abbrstyledef{short-sm-postfootnote}]
-Like \abbrstyle{short-postfootnote} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvsmfont}.
-(This style was originally called \depabbrstyle{postfootnote-sm}. Renamed in version
-1.04, but original name retained as a deprecated synonym for
-backward-compatibility.)
-
-\item[\abbrstyledef{short-em-postfootnote}]
-Like \abbrstyle{short-postfootnote} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvemfont}.
-(This style was originally called \depabbrstyle{postfootnote-em}. Renamed in version
-1.04, but original name retained as a deprecated synonym for
-backward-compatibility.)
-
-\item[\abbrstyledef{short-postfootnote-desc}]
-(New to v1.42.)
-This is similar to \abbrstyle{short-postfootnote}, but the
-\gloskey{description} must be supplied by the user. The
-\gloskey{name} and \gloskey{sort} are set as for
-\abbrstyle{short-footnote-desc}.
-
-\item[\abbrstyledef{postfootnote-desc}]
-A synonym for \abbrstyle{short-postfootnote-desc}.
+\cmddef{glsxtrregularfont}
+The command to use for regular entries. This is initialised to just
+do its argument.
-\item[\abbrstyledef{short-sc-postfootnote-desc}]
-Like \abbrstyle{short-postfootnote-desc} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvscfont}.
-
-\item[\abbrstyledef{short-sm-postfootnote-desc}]
-Like \abbrstyle{short-postfootnote-desc} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvsmfont}.
-
-\item[\abbrstyledef{short-em-postfootnote-desc}]
-Like \abbrstyle{short-postfootnote-desc} but redefines \cs{glsabbrvfont} to
-use \ics{glsabbrvemfont}.
-
-\item[\abbrstyledef{short-postlong-user}]
-This style was introduced in version 1.12. It's like the
-\abbrstyle{short-long-user} style but defers the parenthetical
-material to after the link-text. This means that you don't have such
-a long hyperlink (which can cause problems for the DVI \LaTeX\ format)
-and it also means that the user supplied material can include a
-hyperlink to another location. The \gloskey{name} key is obtained
-from \cs{glsxtrshortlongname}.
-
-\item[\abbrstyledef{short-postlong-user-desc}]
-This style was introduced in version 1.12. It's like the above
-\abbrstyle{short-postlong-user} style but the \gloskey{description}
-must be specified. The \gloskey{name} is obtained from
-\cs{glsxtrshortlonguserdescname}.
-
-\item[\abbrstyledef{long-postshort-user}]
-This style was introduced in version 1.12. It's like the above
-\abbrstyle{short-postlong-user} style but the long form is shown
-first and the short form is in the parenthetical material (as for
-\abbrstyle{long-short-user}) style.
-
-\item[\abbrstyledef{long-postshort-user-desc}]
-This style was introduced in version 1.12. It's like the above
-\abbrstyle{long-postshort-user} style but the \gloskey{description}
-must be specified. The \gloskey{name} is obtained from
-\cs{glsxtrlongshortuserdescname}.
-
-\item[\abbrstyledef{long-postshort-sc-user}]
-This style (new to v1.48) is like \abbrstyle{long-postshort-user}
-but uses smallcaps for the short form.
-
-\item[\abbrstyledef{long-postshort-sc-user-desc}]
-This style (new to v1.48) is like \abbrstyle{long-postshort-user-desc}
-but uses smallcaps for the short form.
-
-\item[\abbrstyledef{long-hyphen-short-hyphen}]
-This style (new to v1.17) is designed to work with the \catattr{markwords}
-category attribute. The full form is formatted using
-\begin{definition}[\DescribeMacro\glsxtrlonghyphenshort]
-\cs{glsxtrlonghyphenshort}\marg{label}\marg{long}\marg{short}\marg{insert}
-\end{definition}
-where \meta{insert} is the inserted material
-provided in the final optional argument of commands like
-\cs{insert}. If \meta{insert} start with a hyphen, then this
-locally redefines \ics{glsxtrwordsep} to a hyphen, which means that
-if the \catattr{markwords} attribute is set then the long form
-will become hyphenated. (If this attribute isn't set, there's
-no alteration to the way the long form is displayed.)
-The \gloskey{name} key is obtained from \cs{glsxtrlongshortname}.
-
-Unlike the other \meta{long} (\meta{short}) type of styles,
-such as \abbrstyle{long-short}, this style
-also repeats the insertion in the parenthetical part, so that the
-first use form is:
-\begin{quote}
-\cs{glsfirstlonghyphenfont}\marg{long}\meta{insert}
-(\cs{glsfirstabbrvhyphenfont}\marg{short}\meta{insert})
-\end{quote}
-The space before the parenthetical material is actually given by
-\cs{glsxtrfullsep}\marg{label} which defaults to a space.
-The \meta{insert} may be moved into the formatting commands
-according to the conditional \cs{ifglsxtrinsertinside}.
-
-For example, if \texttt{ip} is defined using:
-\begin{verbatim}
-\glssetcategoryattribute{english}{markwords}{true}
-\setabbreviationstyle[english]{long-hyphen-short-hyphen}
-\newabbreviation[category=english]{ip}{IP}{Internet Protocol}
-\end{verbatim}
-then
-\begin{verbatim}
-\gls{ip}[-Adressen]
-\end{verbatim}
-will do
-\begin{quote}
-Internet-Protocol-Adressen (IP-Adressen)
-\end{quote}
-on first use, whereas
-\begin{verbatim}
-\gls{ip}[ Address]
-\end{verbatim}
-will do
+\cmddef{glsxtrabbreviationfont}
+The command to use for abbreviations that considered non-regular
+entries.
+
+The following document has a regular entry (sample), a regular
+abbreviation (radar, which uses \abbrstyle{short-nolong} the default
+\cat{acronym} style), and a non-regular abbreviation (HTML, which
+uses \abbrstyle{long-short} the default \cat{abbreviation} style):
+\begin{codebox}
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{an example}}
+\gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}
+\gls{newacronym}\marg{radar}\marg{radar}\marg{radio detection and ranging}
+\cmd{renewcommand}\marg{\gls{glsxtrregularfont}}[1]\marg{\cmd{emph}\marg{\#1}}
+\cmd{renewcommand}\marg{\gls{glsxtrabbreviationfont}}[1]\marg{\cmd{textbf}\marg{\#1}}
+\cbeg{document}
+\gls{gls}\marg{sample}, \gls{gls}\marg{html}, \gls{gls}\marg{radar}.
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample*[title={Middle formatting},
+ label={ex:middleformat},
+ description={Example document illustrating middle formatting
+applied with \cmd{glsxtrregularfont} for regular entries and
+\cmd{glsxtrabbreviationfont} for non-regular abbreviations}]
+{%
+\cmd{usepackage}\marg{glossaries-extra}
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{an example}}
+\gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}
+\gls{newacronym}\marg{radar}\marg{radar}\marg{radio detection and ranging}
+\cmd{renewcommand}\marg{\gls{glsxtrregularfont}}[1]\marg{\cmd{emph}\marg{\#1}}
+\cmd{renewcommand}\marg{\gls{glsxtrabbreviationfont}}[1]\marg{\cmd{textbf}\marg{\#1}}
+}
+{%
+\gls{gls}\marg{sample}, \gls{gls}\marg{html}, \gls{gls}\marg{radar}.
+}
+\end{resultbox}
+Note that even though radar is an abbreviation, it's considered a
+regular entry because it uses a regular style.
+
+\cmddef{glsxtrassignfieldfont}
+This command is used by all the \idx{glstextlike} commands to
+initialise the internal command used to encapsulate the field value.
+This will either be set to \gls{glsxtrregularfont} (for regular
+entries) or \gls{@firstofone} otherwise.
+
+Note that this doesn't use \gls{glsxtrabbreviationfont}
+as non-regular abbreviations are too complicated to work with
+\gls{glstext}, \gls{glsfirst}, \gls{glsplural}, \gls{glsfirstplural}
+or their case-changing variants. Instead, use the \idx{glslike}
+commands or the abbreviation commands, such as \gls{glsxtrshort}.
+
+\subsection{Inner Formatting}
+\label{sec:innertextformat}
+
+If you want to format the \idx{linktext}, the best method is to
+either use the outer formatting or encapsulate the entire
+\idx{glslike} or \idx{glstextlike} command, as described in
+\sectionref{sec:glstextformat}. However, there are some sensitive
+commands that don't work if the command argument doesn't simply
+contain text.
+
+\begin{information}
+Sometimes the issue may occur when the sensitive command that
+needs to encapsulate \gls{gls} doesn't like boolean variables being
+changed (which occurs when the \idx{firstuseflag} is unset). If this
+is the case, you may want to consider buffering as an alternative
+(see \sectionref{sec:unsetbuffer}).
+\end{information}
+
+For example, if the sample document from
+\sectionref{sec:glstextformat} is adjusted to include the \sty{soul}
+package and the following line is added to the document:
+\begin{codebox}
+\gls{gls}\oarg{\glsoptval{textformat}{hl}}\marg{sample}
+\end{codebox}
+then the document build will fail with the error:
\begin{quote}
-Internet Protocol Address (IP Address)
+! Package soul Error: Reconstruction failed.
\end{quote}
-on first use.
+Once solution is to do the following instead:
+\begin{codebox}
+\gls+{hl}\marg{\gls+{mbox}\marg{\gls{gls}\marg{sample}}}
+\end{codebox}
+This will now work, but the box will prevent hyphenation, so it's
+only useful if the \idx{linktext} is short, such as a symbol. If the
+\idx{linktext} is long (such as a phrase or the \idx{firstuse} of an
+abbreviation), this method can produce undesirable results with
+overfull or underfull lines.
+
+The \idx{innerformatting} is designed to provide a workaround, but it
+must be implemented deep within the entry style formatting. This
+means that if you provide your own custom style, you will need to
+add the appropriate commands if you want that style to support inner
+formatting. You may also need to switch to using
+\gls{MFUsentencecase} instead of \gls{makefirstuc} if any of the
+\idx{sentencecase} commands are required:
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{glssentencecase}}[1]\marg{\gls{MFUsentencecase}\marg{\#1}}
+\end{codebox}
+Although there's no guarantee that this will work for some
+particularly problematic formatting commands.
+
+With the default entry style, the above example can be changed to:
+\begin{codebox}
+\gls{gls}\oarg{\glsoptval{innertextformat}{hl}}\marg{sample}
+\end{codebox}
+
+\begin{warning}
+The inner formatting may be split up in order to move them into the
+arguments of internal commands, such as those used for
+case-changing. This can result in unwanted side-effects.
+\end{warning}
+
+The following uses \gls{fbox} (which draws a frame around its
+argument) and \sty{soul}['s] \gls{so} (which spaces out the letters):
+\begin{codebox}
+\comment{requires glossaries.sty v4.50+ and mfirstuc v2.08+}
+\cmd{renewcommand}\marg{\gls{glssentencecase}}[1]\marg{\gls{MFUsentencecase}\marg{\#1}}
+\gls{newacronym}\marg{radar}\marg{radar}\marg{radio detection and ranging}
+\cbeg{document}
+\gls{Gls}\oarg{\glsoptval{innertextformat}{fbox}}\marg{radar}['s] system\cmd{ldots}
+\codepar
+\gls{Gls}\oarg{\glsoptval{innertextformat}{so}}\marg{radar}['s] system\cmd{ldots}
+\codepar
+\gls{fbox}\marg{\gls{Gls}\marg{radar}['s]} system\cmd{ldots}
+\codepar
+\gls{so}\marg{\gls+{mbox}\marg{\gls{Gls}\marg{radar}['s]}} system\cmd{ldots}
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample*[title={Inner formatting},
+ label={ex:innerformat},
+ description={Example document illustrating inner formatting}]
+{%
+\comment{requires glossaries.sty v4.50+ and mfirstuc v2.08+}
+\cmd{usepackage}\marg{soul}^^J%
+\cmd{usepackage}\marg{glossaries-extra}^^J%
+\cmd{renewcommand}\marg{\gls{glssentencecase}}[1]\marg{\gls{MFUsentencecase}\marg{\#1}}^^J%
+\gls{newacronym}\marg{radar}\marg{radar}\marg{radio detection and ranging}
+}
+{%
+\gls{Gls}\oarg{innertextformat=fbox}\marg{radar}['s] system\cmd{ldots}
+\codepar
+\gls{Gls}\oarg{innertextformat=so}\marg{radar}['s] system\cmd{ldots}
+\codepar
+\gls{fbox}\marg{\gls{Gls}\marg{radar}['s]} system\cmd{ldots}
+\codepar
+\gls{so}\marg{\gls{mbox}\marg{\gls{Gls}\marg{radar}['s]}} system\cmd{ldots}
+}
+\end{resultbox}
+Note the fragmentation of the inner formatting. The use of
+\gls{mbox} in the final line prevents an error but the letters aren't
+spaced out. The only way to deal with this case is to use
+\gls{glsdisp} or \gls{glslink} with the text explicitly written:
+\begin{codebox}
+\gls{glslink}\marg{radar}\marg{\gls{so}\marg{Radar's}} system\cmd{ldots}
+\end{codebox}
+
+\begin{warning}
+The above example requires \sty{mfirstuc} v2.08+.
+\end{warning}
+
+Below are the commands used to support inner formatting.
+
+\cmddef{glsxtrgenentrytextfmt}
+This is the command that's used to encapsulate any content that
+should have the \idx{innerformatting} applied. It should not be redefined
+within the document as it's initialised within the
+\idx{glslike} and \idx{glstextlike} commands. It's used within
+\gls{glsgenentryfmt} and included in the helper commands used by the
+predefined abbreviation styles.
+
+Sometimes it may be necessary to include \gls{glsxtrgenentrytextfmt}
+within the actual field value to ensure that it's as close as
+possible to the text. This is performed automatically when an entry
+is defined if the \catattr{encapinnerfmt} or
+\catattr{encapnocaseinnerfmt} attributes are set. Note that even in
+this case, fragmentation will occur with \idx{sentencecase} commands
+like \gls{Gls} or with the insert optional argument, as in the above
+example with \gls{fbox} and \gls{so}.
+
+\cmddef{glsxtrdefaultentrytextfmt}
+This is the default command that \gls{glsxtrgenentrytextfmt} will be
+\gls{let} to within the \idx{glslike} and \idx{glstextlike} commands
+before their options are processed. This simply does its argument
+but may be redefined. (See \exampleref{ex:protectinnertextformat}.)
+
+\cmddef{glsxtrattrentrytextfmt}
+This command applies formatting according to whether or not the
+\catattr{innertextformat} attribute is set. It isn't used by default as it
+should rarely be needed and increases complexity. However, if you
+would like to provide support for the \catattr{innertextformat} attribute,
+you can redefine \gls{glsxtrdefaultentrytextfmt} to use
+\gls{glsxtrattrentrytextfmt}:
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{glsxtrdefaultentrytextfmt}}\marg{\gls{glsxtrattrentrytextfmt}}
+\end{codebox}
+
+\begin{information}
+This command expects the entry label to be stored in \gls{glslabel}
+(from which it obtains the category label).
+\end{information}
+
+The \idx{glslike} commands use \gls{glsxtrgenentrytextfmt} within
+\gls{glsgenentryfmt} for regular entries or within the
+abbreviation style commands for non-regular abbreviations
+(see \sectionref{sec:entryfmt}).
+
+The \idx{glstextlike} commands all essentially perform the following
+steps:
+\begin{enumerate}
+\item Initialise the middle formatting command \meta{field-font-cs} used for
+encapsulating the field with \gls{glsxtrassignfieldfont} (see
+\sectionref{sec:middleformat}).
+
+\item If \gls{glsifapplyinnerfmtfield} indicates that the field
+value should be encapsulated by \gls{glsxtrgenentrytextfmt}, then
+this essentially does (or appropriate case-change equivalent):
+\begin{codebox}
+\meta{field-font-cs}\marg{\cmd{glsaccessfmt\meta{field}}\margm{insert}\marg{\gls{glsxtrgenentrytextfmt}}\margm{entry-label}\margm{internal-field}}
+\end{codebox}
+otherwise it does:
+\begin{codebox}
+\meta{field-font-cs}\marg{\cmd{glsaccess\meta{field}}\margm{entry-label}\gls{glsxtrgenentrytextfmt}\margm{insert}}
+\end{codebox}
+(See \sectionref{sec:accsupp} for the \qt{access} commands.)
+\end{enumerate}
+
+For example, the \idx{linktext} for \gls{glstext} is:
+\begin{codebox}
+\gls{glsifapplyinnerfmtfield}\margm{entry-label}\marg{text}\%
+\marg{\%
+ \meta{field-font-cs}\marg{\gls{glsaccessfmttext}\margm{insert}\marg{\gls{glsxtrgenentrytextfmt}}\margm{entry-label}}\%
+}\%
+\marg{\%
+ \meta{field-font-cs}\marg{\gls{glsaccesstext}\margm{entry-label}\gls{glsxtrgenentrytextfmt}\margm{insert}}\%
+}
+\end{codebox}
+The \csfmt{glsaccessfmt\meta{field}} commands internally use
+\gls{glsfmtfield} to apply the \idx{innerformatting}.
+
+\cmddef{glsifapplyinnerfmtfield}
+This determines whether or not the field identified by its
+\idx{internalfieldlabel} for the given entry should have its value
+encapsulated by the \idx{innerformatting} command. False indicates that
+the field value already contains the \idx{innerformatting} command.
+
+\cmddef{glsexclapplyinnerfmtfield}
+Locally adds the given field identified by its
+\idx{internalfieldlabel} to the exclusion list for the given entry.
+
+\cmddef{glsfmtfield}
+This command applies the formatting command \meta{cs} (which takes one
+argument) to the entry's field value identified by the given
+\idx{internalfieldlabel}, including \meta{insert} appended.
+This ensures that the internal control sequence used to store the
+field's value is expanded before \meta{cs} is applied.
+
+\cmddef{Glsfmtfield}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSfmtfield}
+As above but \idx{allcaps}.
+
+\subsection{Post Link Hook}
+\label{sec:postlinkhook}
+
+The \idx{postlinkhook} is a convenient way of automatically
+appending content after each instant of the \idx{glslike} and
+\idx{glstextlike} commands. The simplest method of implementing
+this is with the \idx{catpostlinkhook}, which is only applied to
+entries that have the given category. For example, the following
+will place an asterisk (*) after all entries with the default
+\cat{general} category:
+\begin{codebox}
+\gls{glsdefpostlink}\marg{\cat{general}}\marg{*}
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{symbol}{X},
+ \gloskeyval{description}{an example}}
+\cbeg{document}
+\gls{Gls}\marg{sample}, \gls{glstext}\marg{sample}, \gls{glsdesc}\marg{sample}
+and \gls{glssymbol}\marg{sample}.
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample*[title={Category post-link hook},
+ label={ex:catpostlink},
+ description={Example document illustrating a simple category
+post-link hook}]
+{%
+\cmd{usepackage}\marg{glossaries-extra}^^J%
+\gls{glsdefpostlink}\marg{general}\marg{*}^^J%
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{symbol}{X},\gloskeyval{description}{an example}}
+}
+{%
+\gls{Gls}\marg{sample}, \gls{glstext}\marg{sample},
+\gls{glsdesc}\marg{sample} and \gls{glssymbol}\marg{sample}.
+}
+\end{resultbox}
+Typically, the \idx{catpostlinkhook} is more likely to include some
+conditional, such as to only insert text on \idx{firstuse}.
+For example, \gls{glsxtrpostlinkAddDescOnFirstUse} can be used to
+insert the description in parentheses after the \idx{firstuse}.
+
+\begin{warning}
+The \qt{post} abbreviation styles all set the \idx{catpostlinkhook},
+which will overwrite any previous definition for the abbreviation's
+category.
+\end{warning}
+
+Within the \idx{postlinkhook}, you can use the placeholder commands,
+such as \gls{glslabel} (see \sectionref{sec:entryfmt}), but note
+that you can't use \gls{ifglsused} to determine whether or not the
+entry has been used, since the \idx{postlinkhook} comes after the
+entry has been unset. Instead, use \gls{glsxtrifwasfirstuse}.
+Additional commands provided for use within the
+\idxpl{postlinkhook} are described in this section.
+
+The \idx{postlinkhook} is implemented with \gls{glspostlinkhook},
+which is defined by the base \sty{glossaries} package. It's used at
+the end of the \idx{glslike} and \idx{glstextlike} commands. The
+original base definition does nothing, but \sty{glossaries-extra}
+redefines this:
+\begin{compactcodebox}
+\cmd{renewcommand}*\marg{\gls{glspostlinkhook}}\marg{\%
+ \gls{ifglsentryexists}\marg{\gls{glslabel}}\marg{\gls{glsxtrpostlinkhook}}\marg{}\%
+}
+\end{compactcodebox}
+This uses:
+\cmddef{glsxtrpostlinkhook}
+which is the main \sty{glossaries-extra} \idx{postlinkhook}.
\begin{important}
-Note that the hyphenation isn't applied when using commands like
-\cs{glsxtrlong}. This means that
-\begin{verbatim}
-\glsxtrlong{ip}[-Adressen]
-\end{verbatim}
-will do
-\begin{quote}
-Internet Protocol-Adressen
-\end{quote}
+If you are migrating over from only using the base \sty{glossaries} package and
+you have redefined \gls{glspostlinkhook}, consider moving your
+modifications to the \idx{catpostlinkhook} or prepend to \gls{glsxtrpostlink},
+as some attributes and abbreviation styles rely on the features
+provided by \gls{glsxtrpostlinkhook}.
\end{important}
-If the \catattr{markwords} attribute hadn't been set, then the
-first use of
-\begin{verbatim}
-\gls{ip}[-Adressen]
-\end{verbatim}
-would do
-\begin{quote}
-Internet Protocol-Adressen (IP-Adressen)
-\end{quote}
-instead.
+The main \idx{postlinkhook} is defined as:
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{glsxtrpostlinkhook}}\marg{\%
+ \gls{glsxtrdiscardperiod}\marg{\gls{glslabel}}\%
+ \marg{\gls{glsxtrpostlinkendsentence}}\%
+ \marg{\gls{glsxtrifcustomdiscardperiod}
+ \marg{\gls{glsxtrifperiod}\marg{\gls{glsxtrpostlinkendsentence}}\marg{\gls{glsxtrpostlink}}}\%
+ \marg{\gls{glsxtrpostlink}}\%
+ }\%
+}
+\end{compactcodebox}
+This checks if a following \idx{fullstop} needs to be
+discarded and does the inner \idx{postlinkhook} \gls{glsxtrpostlink}.
+Note that \gls{glsxtrdiscardperiod} and \gls{glsxtrifperiod} look
+ahead for a following token, so if you need to modify this command,
+insert your custom code at the start or add it to
+the \idx{catpostlinkhook} instead.
+
+\cmddef{glsxtrdiscardperiod}
+This discards \meta{token} if it's a \idx{fullstop} and the
+entry's \idxpl{categoryattribute} indicate that a \idx{fullstop}
+should be discarded (such as \catattr{discardperiod}). If the
+punctuation character is discarded, this will then do
+\meta{discarded}, otherwise it will do \meta{no discard} and process \meta{token} as
+usual. If the \catattr{retainfirstuseperiod} attribute is set, then
+the following command is used to determine whether or not to discard
+\meta{token}.
+
+\cmddef{glsxtrdiscardperiodretainfirstuse}
+This was introduced in v1.49 and is defined as:
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{glsxtrdiscardperiodretainfirstuse}}[3]\marg{\comment{}
+ \gls{glsxtrifwassubsequentorshort}\marg{\gls{glsxtrifperiod}\marg{\#2}\marg{\#3}}\marg{\#3}\comment{}
+}
+\end{compactcodebox}
+This will only discard the \idx{fullstop} if it follows the
+\idx{subsequentuse} of a \idx{glslike} command or if it follows one
+of the \gls{glsxtrshort} set of commands.
+Note that this has a different effect from pre v1.49 with the
+\idx{glstextlike} commands, but it's more appropriate since it's
+typically only the short form that requires the period to be
+discarded. To restore the original behaviour:
+\begin{compactcodebox}
+\cmd{renewcommand}*\marg{\gls{glsxtrdiscardperiodretainfirstuse}}[3]\marg{\comment{}
+ \gls{glsxtrifwasfirstuse}\marg{\#3}\marg{\gls{glsxtrifperiod}\marg{\#2}\marg{\#3}}\comment{}
+}
+\end{compactcodebox}
+
+If you want your own custom code to determine whether or not to check
+for a period (instead of using known category attributes), you can
+redefine:
+\cmddef{glsxtrifcustomdiscardperiod}
+This should expand to \meta{true} if a check should be performed,
+otherwise it should expand to \meta{false}. The default definition
+simply does \meta{false}.
+
+\cmddef{glsxtrpostlinkendsentence}
+This is done if a \idx{fullstop} is discarded. If there is a
+\idx{catpostlinkhook} for the entry's category, that hook is
+performed (\gls{glsxtrpostlinkcat} not \gls{glsxtrpostlink}) and the
+\idx{fullstop} is put back followed by a space factor adjustment.
+Otherwise, just the space factor adjustment is done.
+
+The test to determine whether or not \meta{token} is a
+\idx{fullstop} is determined by:
+\cmddef{glsxtrifperiod}
+
+It may be useful to test for other punctuation characters. For
+example, styles such as \abbrstyle{short-postfootnote} will
+move the footnote after certain punctuation characters.
+\cmddef{glsxtrifnextpunc}
+This does \meta{true} if it's followed by one of the set of
+recognised punctuation characters, otherwise it does false. The set
+is initialised to \code{.,:;?!} (\idx{fullstop}, comma, colon,
+semi-colon, question mark, and exclamation mark).
+
+A convenient way of moving code after the punctuation character is
+to use:
+\cmddef{glsxtrdopostpunc}
+If \meta{token} is a recognised punctuation character,
+this will place \meta{code} after the token, otherwise it will be
+placed before the token.
+
+The earlier example can be adapted to put the asterisk after
+following punctuation:
+\begin{codebox}
+\gls{glsdefpostlink}\marg{\cat{general}}\marg{\gls{glsxtrdopostpunc}\marg{*}}
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{symbol}{X},
+ \gloskeyval{description}{an example}}
+\cbeg{document}
+\gls{Gls}\marg{sample}, \gls{glstext}\marg{sample},
+(\gls{glsdesc}\marg{sample}) and \gls{glssymbol}\marg{sample}.
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample*[title={Category post-link hook with punctuation
+lookahead},
+ label={ex:catpostlinkpunc},
+ description={Example document illustrating a category
+post-link hook that transfers content after a following punctuation
+character}]
+{%
+\cmd{usepackage}\marg{glossaries-extra}^^J%
+\gls{glsdefpostlink}\marg{general}\marg{\gls{glsxtrdopostpunc}\marg{*}}^^J%
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{symbol}{X},\gloskeyval{description}{an example}}
+}
+{%
+\gls{Gls}\marg{sample}, \gls{glstext}\marg{sample},
+(\gls{glsdesc}\marg{sample}) and \gls{glssymbol}\marg{sample}.
+}
+\end{resultbox}
+Note that the asterisk isn't moved after the closing parenthesis.
+This is because that character isn't included in the default list.
+
+You can add additional punctuation marks with:
+\cmddef{glsxtraddpunctuationmark}
+You may list multiple characters at the same time to add a batch,
+but don't add any separators (including spaces).
\begin{important}
-If the inserted material \meta{insert} is likely to contain commands like
-\cs{gls}, then use \abbrstyle{long-hyphen-postshort-hyphen}
-instead to avoid nested links.
+Note that each character must be a single token, which means a single-byte
+character for \pdfLaTeX. Multi-byte characters (\idx{utf8}) will
+required a native Unicode engine (\XeLaTeX\ or \LuaLaTeX).
\end{important}
-If you want the short version in small-caps, you can
-just redefine \cs{glsabbrvhyphenfont} and \cs{glsxtrhyphensuffix}
-to use the small-caps versions. For example:
-\begin{verbatim}
-\renewcommand{\glsabbrvhyphenfont}{\glsabbrvscfont}
-\renewcommand{\glsxtrhyphensuffix}{\glsxtrscsuffix}
-\end{verbatim}
-Similarly for other font-changing variations.
-
-\item[\abbrstyledef{long-hyphen-noshort-desc-noreg}]
-New to version 1.17, this style is like
-\abbrstyle{long-hyphen-short-hyphen-desc} except that the
-parenthetical part is omitted and the long form is displayed
-on subsequent use. The short form can be accessed
-with \cs{glsxtrshort} but just uses the default abbreviation font.
-There's no regular version of this style as the regular form
-doesn't have the flexibility to deal with the hyphen switch.
-The \gloskey{name} is obtained from \cs{glsxtrlongnoshortdescname}.
-
-\item[\abbrstyledef{long-hyphen-noshort-noreg}]
-New to version 1.17, this style is like
-\abbrstyle{long-hyphen-noshort-desc-noreg} but the
-name is set to the short form and the description is set to the long
-form.
-
-\item[\abbrstyledef{long-hyphen-short-hyphen-desc}]
-
-New to version 1.17.
-This is similar to \abbrstyle{long-hyphen-short-hyphen} but the user
-supplies the description. The \gloskey{name} is obtained from
-\cs{glsxtrlongshortdescname}.
-
-\item[\abbrstyledef{long-hyphen-postshort-hyphen}]
-
-New to version 1.17.
-This is similar to \abbrstyle{long-hyphen-short-hyphen} but the
-inserted and parenthetical material are moved to the post-link hook.
-On first use, \cs{gls}\marg{label}\oarg{insert} will do
-\begin{display}
-\cs{glsxtrlonghyphen}\marg{long}\marg{label}\marg{insert}\cs{glsxtrposthyphenshort}\marg{label}\meta{insert}
-\end{display}
-where
-\begin{definition}[\DescribeMacro\glsxtrposthyphenshort]
-\cs{glsxtrposthyphenshort}\marg{label}\meta{insert}
-\end{definition}
-is in the post-link hook. This uses the format:
-\begin{display}
-\meta{insert} (\cs{glsfirstabbrvhyphenfont}\marg{short}\meta{isnert})
-\end{display}
+For example:
+\begin{codebox}
+\gls{glsxtraddpunctuationmark}\marg{-'/}
+\end{codebox}
+This adds three extra punctuation marks (hyphen, apostrophe and
+slash). Note that this doesn't allow for closing double-quotes and
+will break \code{'{}'} (double apostrophe sequence for a closing
+double-quote) if found. The following will only work with
+\XeLaTeX\ or \LuaLaTeX:
+\begin{unicodebox}
+\cmd{usepackage}\marg{fontspec}
+\cmd{usepackage}\marg{glossaries-extra}
+\gls{glsxtraddpunctuationmark}\marg{\textrm{\textquotedblright}}
+\end{unicodebox}
+
+
+You can set the list with:
+\cmddef{glsxtrsetpunctuationmarks}
+This will remove the default set as well as any additional
+characters. As above, each character must be a single token with no
+separators in the list.
+For example:
+\begin{codebox}
+\gls{glsxtrsetpunctuationmarks}\marg{.?!}
+\end{codebox}
+This sets the list to just three punctuation characters (so comma,
+colon, and semi-colon are no longer recognised).
+
+\cmddef{glsxtrpostlink}
+This does the \idx{catpostlinkhook} (or nothing if it hasn't been
+defined):
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{glsxtrpostlink}}\marg{\%
+ \cmd{csuse}\marg{glsxtrpostlink\gls{glscategory}\marg{\gls{glslabel}}}\%
+}
+\end{compactcodebox}
+Customisation is best performed within the \idx{catpostlinkhook},
+which can be defined (or redefined) with:
+\cmddef{glsdefpostlink}
+The first argument is the category label and the second is the code
+to perform. Note that this doesn't check if the hook has already
+been defined for the category. The hook is a command in the form
+\gls{glsxtrpostlinkcat}. If the category label only consists
+of letters, you can also use \gls{newcommand} or \gls{renewcommand}
+instead.
+
+\cmddef{glspretopostlink}
+Similar to the above but prepends \meta{code} to the associated
+hook (or simply defines it, if the hook doesn't already exist).
+
+\cmddef{glsapptopostlink}
+Similar to the above but appends \meta{code} to the associated
+hook.
+
+\begin{warning}
+Take care not to choose category labels that will cause a conflict.
+For example, \code{endsentence} and \code{hook} will conflict with
+the commands \gls{glsxtrpostlinkendsentence} and \gls{glsxtrpostlinkhook}.
+\end{warning}
+
+If you want code in the \idx{postlinkhook} that's not dependent on
+the category, consider prepending it to \gls{glsxtrpostlink} or
+\gls{glsxtrpostlinkhook}. Don't append it to
+\gls{glsxtrpostlinkhook} otherwise it will interfere with the
+punctuation lookahead.
+
+For convenience, some commands are provided that may be of use in
+the \idx{catpostlinkhook}:
+
+\cmddef{glsxtrpostlinkAddDescOnFirstUse}
+This will add the \gloskey{description} in parentheses if the hook follows the
+\idx{firstuse} of the entry. This incorporates the inner formatting
+and description accessibility support, if provided.
+
+\cmddef{glsxtrpostlinkAddSymbolOnFirstUse}
+This will add the \gloskey{symbol} in parentheses if that field is
+set and the hook follows the \idx{firstuse} of the entry. This
+incorporates the inner formatting and symbol accessibility support,
+if provided.
+
+\cmddef{glsxtrpostlinkAddSymbolDescOnFirstUse}
+This will add the \gloskey{symbol}, if that field is set, and the
+\gloskey{description} (both within the same set of parentheses), if the hook follows
+the \idx{firstuse} of the entry. This incorporates the inner
+formatting and accessibility support, if provided.
+The separator between the symbol and description is given by:
+\cmddef{glsxtrpostlinkSymbolDescSep}
+The default is a comma followed by a space.
+
+For example:
+\begin{codebox}
+\gls{glsdefpostlink}\marg{\cat{general}}\marg{\gls{glsxtrpostlinkAddDescOnFirstUse}}
+\gls{glsdefpostlink}\marg{\cat{symbol}}\marg{\gls{glsxtrpostlinkAddSymbolOnFirstUse}}
+\gls{glsdefpostlink}\marg{\cat{number}}\marg{\gls{glsxtrpostlinkAddSymbolDescOnFirstUse}}
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{an example}}
+\gls{newglossaryentry}\marg{alpha}\marg{\gloskeyval{name}{alpha},\gloskeyval{symbol}{\cmd{ensuremath}\marg{\cmd{alpha}}},
+ \gloskeyval{description}{a symbol},\gloskeyval{category}{\cat{symbol}}}
+\gls{newglossaryentry}\marg{pi}\marg{\gloskeyval{name}{pi},\gloskeyval{symbol}{\cmd{ensuremath}\marg{\cmd{pi}}},
+ \gloskeyval{description}{a constant},\gloskeyval{category}{\cat{number}}}
+\cbeg{document}
+First use: \gls{gls}\marg{sample}, \gls{gls}\marg{alpha}, \gls{gls}\marg{pi}.
+\codepar
+Next use: \gls{gls}\marg{sample}, \gls{gls}\marg{alpha}, \gls{gls}\marg{pi}.
+\cend{document}
+\end{codebox}
+This produces:
+\begin{resultbox}
+\createexample*[title={Category post-link hooks},
+ label={ex:catpostlinkfirstuse},
+ description={Example document that uses category post-link hooks to
+append additional information after the link text on first use}]
+{%
+\cmd{usepackage}\marg{glossaries-extra}^^J%
+\gls{glsdefpostlink}\marg{general}\marg{\gls{glsxtrpostlinkAddDescOnFirstUse}}^^J%
+\gls{glsdefpostlink}\marg{symbol}\marg{\gls{glsxtrpostlinkAddSymbolOnFirstUse}}^^J%
+\gls{glsdefpostlink}\marg{number}\marg{\gls{glsxtrpostlinkAddSymbolDescOnFirstUse}}^^J%
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{an example}}^^J%
+\gls{newglossaryentry}\marg{alpha}\marg{\gloskeyval{name}{alpha},\gloskeyval{symbol}{\cmd{ensuremath}\marg{\cmd{alpha}}},^^J%
+ \gloskeyval{description}{a symbol},\gloskeyval{category}{symbol}}^^J%
+\gls{newglossaryentry}\marg{pi}\marg{\gloskeyval{name}{pi},\gloskeyval{symbol}{\cmd{ensuremath}\marg{\cmd{pi}}},^^J%
+ \gloskeyval{description}{a constant},\gloskeyval{category}{number}}
+}
+{%
+First use: \gls{gls}\marg{sample}, \gls{gls}\marg{alpha}, \gls{gls}\marg{pi}.
+\codepar
+Next use: \gls{gls}\marg{sample}, \gls{gls}\marg{alpha}, \gls{gls}\marg{pi}.
+}
+\end{resultbox}
+
+The following commands are also provided for use in the
+\idx{postlinkhook}:
+
+\cmddef{glsxtrcurrentfield}
+This expands to empty if the calling command isn't associated with
+one specific field (such as \gls{glslink}, the \idx{glslike}
+commands, the \idx{inlinefullform} commands) otherwise it will
+expand to the name of the key associated with the \emph{singular}
+form of the command. For example, this command will expand to
+\code{text} for both \gls{glstext} and \gls{glsplural}, to
+\code{description} for both \gls{glsdesc} and \gls{glsdescplural}, and
+to \code{short} for both \gls{glsxtrshort} and \gls{glsxtrshortpl}.
+Whereas it will expand to nothing for both \gls{gls} and
+\gls{glsxtrfull}.
+
+\cmddef{glsxtrifwasglslike}
+This expands to \meta{true} if the calling command was a \idx{glslike} command
+and to \meta{false} otherwise.
+
+\cmddef{glsxtrifwasglslikeandfirstuse}
+This expands to \meta{true} if the calling command was a \idx{glslike} command
+and was the \idx{firstuse} otherwise it expands to \meta{false}.
+This is simply a shortcut command that uses both
+\gls{glsxtrifwasglslike} and \gls{glsxtrifwasfirstuse}.
+
+\cmddef{glsxtrifwassubsequentuse}
+This expands to \meta{true} if the calling command was a \idx{glslike} command
+and was the \idx{subsequentuse} otherwise it expands to \meta{false}.
+This is simply a shortcut command that uses both
+\gls{glsxtrifwasglslike} and \gls{glsxtrifwasfirstuse}.
+
+\cmddef{glsxtrifwassubsequentorshort}
+This expands to \meta{true} if the calling command was a \idx{glslike} command
+and was the \idx{subsequentuse} or if the calling command set
+\gls{glsxtrcurrentfield} to \code{short}. Otherwise it expands to
+\meta{false}.
+
+\cmddef{glsxtrifallcaps}
+This simply does:
+\begin{compactcodebox}
+\gls{glscapscase}\margm{not all caps}\margm{not all caps}\margm{all caps}
+\end{compactcodebox}
+It's not usually necessary for the \idx{postlinkhook} to
+differentiate between no case-change and \idx+{sentencecase}, so this
+provides a convenient shortcut if only the \idx+{allcaps} case needs
+to be different.
+
+It's possible you may also want to reference the inserted material.
+For the \idx{glslike} commands, this can be obtained with the
+placeholder \gls{glsinsert}, but it's not normally set by the
+\idx{glstextlike} commands, which don't use the entry format style
+(\sectionref{sec:entryfmt}) and instead incorporate the inserted
+material at the end of the \idx{linktext}. If you want the \idx{postlinkhook} to
+be able to access the inserted material for the \idx{glstextlike}
+commands, you must first save it, by redefining the following:
+
+\cmddef{glsxtrsaveinsert}
+This is used by the \idx{glstextlike} commands to initialise \gls{glsinsert}.
+The default is:
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{glsxtrsaveinsert}}[2]\marg{\cmd{def}\gls{glsinsert}\marg{}}
+\end{compactcodebox}
+For example, to always save the insert:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glsxtrsaveinsert}}[2]\marg{\cmd{def}\gls{glsinsert}\marg{\#2}}
+\end{codebox}
+The first argument can be used to conditionally assign the insert.
+For example, the following will only save it for entries with the
+\cat{general} category:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glsxtrsaveinsert}}[2]\marg{\%
+ \gls{glsifcategory}\marg{\#1}\marg{\cat{general}}\marg{\cmd{def}\gls{glsinsert}\marg{\#2}}\marg{\cmd{def}\gls{glsinsert}\marg{}}\%
+}
+\end{codebox}
+
+If you only want to save the insert for the \gls{glsxtrfull} set of
+commands, you can redefine \gls{glsxtrfullsaveinsert} instead (see
+\sectionref{sec:abbrvfieldrefs}).
+
+\cmddef{glsxtrassignlinktextfmt}
+This contains the assignments required to ensure that \gls{glslabel},
+\gls{glstextformat} and \gls{glsxtrgenentrytextfmt} have the
+definitions they had within the \idx{linktext}. They would
+ordinarily still have those definitions within the
+\idx{postlinkhook}, but if, for example, the hook contains content
+that may be deferred, such as a footnote, then judicious use and
+expansion of \gls{glsxtrassignlinktextfmt} can allow the deferred
+code to pick up the label, outer and inner formatting.
+
+For example, the \idx{postlinkhook} might contain:
+\begin{codebox}
+\gls+{expandafter}\gls+{footnote}\gls{expandafter}
+ \marg{\gls{glsxtrassignlinktextfmt}\gls{glstextformat}\marg{\%
+ \gls{Glsaccessfmtdesc}\marg{}\marg{\gls{glsxtrgenentrytextfmt}}\marg{\gls{glslabel}}}.}
+\end{codebox}
+
+\subsection{Entry Format Style}
+\label{sec:entryfmt}
+
+\begin{information}
+This section is for advanced users. Minor modifications can be made
+by adjusting the outer formatting (\sectionref{sec:glstextformat}),
+the \idx{postlinkhook} (\sectionref{sec:postlinkhook}) or the
+abbreviation style commands (\sectionref{sec:abbrvcmds}).
+\end{information}
+
+The \idx{glslike} commands have the \idx{linktext} set to the entry
+format style corresponding to the entry's glossary \gloskey{type}.
+This can be changed with \gls{defglsentryfmt}, but the default style
+is given by \gls{glsentryfmt}, which is defined by the base
+\sty{glossaries} package. This uses the placeholder commands
+to determine the appropriate text. These are described in the
+\sty{glossaries} manual, but to recap they are: \gls{glslabel} (the entry's label),
+\gls{glscustomtext} (text provided by \gls{glsdisp} or empty
+otherwise), \gls{glsinsert} (supplied in the final optional argument
+except for \gls{glsdisp}, empty by default), \gls{glsifplural}, and
+\gls{glscapscase}.
+
+The \sty{glossaries-extra} package redefines \gls{glsentryfmt} to
+test whether or not the entry is an abbreviation and, if so, whether
+or not the entry should be treated as a regular entry:
+\begin{compactcodebox}
+\cmd{renewcommand}*\marg{\gls{glsentryfmt}}\marg{\%
+ \gls{ifglshasshort}\marg{\gls{glslabel}}
+ \marg{\gls{glssetabbrvfmt}\marg{\gls{glscategory}\marg{\gls{glslabel}}}}\marg{}\%
+ \gls{glsifregular}\marg{\gls{glslabel}}\%
+ \marg{\gls{glsxtrregularfont}\marg{\gls{glsgenentryfmt}}}\%
+ \marg{\%
+ \gls{ifglshasshort}\marg{\gls{glslabel}}\%
+ \marg{\gls{glsxtrabbreviationfont}\marg{\gls{glsxtrgenabbrvfmt}}}\%
+ \marg{\gls{glsxtrregularfont}\marg{\gls{glsgenentryfmt}}}\%
+ }\%
+}
+\end{compactcodebox}
+This uses \gls{ifglshasshort} to determine whether or not the entry
+is an abbreviation. If it is, then \gls{glssetabbrvfmt} is used to
+setup the abbreviation style commands for the entry's category.
+
+Then there's a check (with \gls{glsifregular}) to determine whether
+or not the entry should be treated as a regular entry. Note that if
+the \catattr{regular} attribute hasn't been set to \code{true}, the
+entry will still be treated as a regular entry if it doesn't have
+the \gloskey{short} field set.
+
+Regular entries are formatted according to:
+\cmddef{glsgenentryfmt}
+This is the generic regular entry format. It's encapsulated with
+\gls{glsxtrregularfont}, but note that if the entry is an
+abbreviation, it will still use the abbreviation style formatting
+commands, which are contained within the \gloskey{first},
+\gloskey{firstplural}, \gloskey{text} and \gloskey{plural} field
+values.
+
+The generic regular entry format \gls{glsgenentryfmt} is provided by
+the base \sty{glossaries} package, but is redefined by
+\sty{glossaries-extra} to support inner formatting
+(\sectionref{sec:innertextformat}) and accessibility
+(\sectionref{sec:accsupp}), if required.
+
+Abbreviations that aren't considered regular, are formatted
+according to:
+\cmddef{glsxtrgenabbrvfmt}
+This is the generic non-regular abbreviation format. It's
+encapsulated with \gls{glsxtrabbreviationfont}. Unlike \gls{glsgenentryfmt}
+this doesn't reference the \gloskey{first}, \gloskey{firstplural},
+\gloskey{text} or \gloskey{plural} fields, but instead uses the
+abbreviation formatting commands \gls{glsxtrfullformat},
+\gls{glsxtrsubsequentfmt} and their plural and case-changing variants.
+
+If you want to define your own custom entry format, you will need to
+consider whether or not your format should support regular and
+non-regular abbreviation styles. Further detail can be found in the
+documented code:
+\texdocref{glossaries-extra-code}
+
+\section{Hyperlinks}
+\label{sec:hyper}
+
+The \idx{glslike} and \idx{glstextlike} commands will automatically
+create a hyperlink by default, if \sty{hyperref} has been loaded
+(before \sty{glossaries}\slash \sty{glossaries-extra}). The
+hyperlink can be switched off with \glsoptval{hyper}{false} but will
+also be switched off if the entry was assigned to an
+\idx{ignoredglossary} that was defined with the unstarred
+\gls{newignoredglossary}.
+
+The \optval{hyperfirst}{false} package option and the category attributes
+\catattr{nohyper}, \catattr{nohyperfirst} and \catattr{nohypernext}
+can also be used to automatically switch off the hyperlink.
+See also the \glsopt{hyperoutside} option that determines whether
+the hyperlink should be inside or outside of the outer formatting.
+
+The hyperlink target is usually created by \gls{glstarget} which is
+used by all the predefined \idxpl{glossarystyle} by the standalone
+commands, such as \gls{GlsXtrStandaloneEntryName}.
+
+The target for an entry with the label \meta{entry-label} is in the
+form \meta{prefix}\meta{entry-label}. The \meta{prefix} is normally
+\gls{glolinkprefix} but may be changed with the \printglossopt{prefix}
+option when displaying the \idx{glossary}.
+
+The target can also be changed to a link to an external file with
+the \catattr{targeturl} category attribute.
+
+\section{Label Prefixes}
+\label{sec:labelprefixes}
+
+It's possible that you may want to prefix labels to ensure
+uniqueness. For example, this manual references both the
+\gls{makeglossaries} command and the \app{makeglossaries} Perl
+script. They are both defined as \idx{glossary} entries, but they
+can't both have the label \code{makeglossaries}. This manual uses
+\app{bib2gls} and is quite complicated, but a simplified version is
+as follows:
+\begin{codebox}
+\cmd{newcommand}\marg{\cmd{csfmt}}[1]\marg{\cmd{texttt}\marg{\glsbackslash\#1}}
+\cmd{newcommand}\marg{\cmd{appfmt}}[1]\marg{\cmd{texttt}\marg{\#1}}
+\gls{newglossaryentry}\marg{cs.makeglossaries}\marg{\gloskeyval{name}{\cmd{csfmt}\marg{makeglossaries}},
+ \gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{app.makeglossaries}\marg{\gloskeyval{name}{\cmd{appfmt}\marg{makeglossaries}},
+ \gloskeyval{description}{}}
+\end{codebox}
+So the label \code{cs.makeglossaries} refers to \gls{makeglossaries}
+and \code{app.makeglossaries} refers to \app{makeglossaries}.
+If you have a lot of prefixes like this, you may prefer to have a
+command that automatically adds the prefix. For example,
+\begin{codebox}
+\cmd{newcommand}*\marg{\cmd{cs}}[2][]\marg{\gls{gls}\oarg{\#1}\marg{cs.\#2}}
+\end{codebox}
+The problem with this is that the custom command \csfmt{cs}
+doesn't allow for the \cmdmod{star}, \cmdmod{plus} and
+\cmdmod{alt-mod} modifiers (such as \code{\gls{gls}*} or \code{\gls{gls}+}).
+Instead you can use:
+\cmddef{glsxtrnewgls}
+which defines the command
+\begin{compactcodebox}
+\meta{cs}\meta{modifier}\oargm{options}\margm{entry-label}\oargm{insert}
+\end{compactcodebox}
+that behaves like
+\begin{compactcodebox}
+\gls{gls}\meta{modifier}\oarg{\meta{default options},\meta{options}}\marg{\meta{prefix}\meta{entry-label}}\oargm{insert}
+\end{compactcodebox}
+For example:
+\begin{codebox}
+\gls{glsxtrnewgls}\marg{cs.}\marg{\cmd{cs}}
+\end{codebox}
+or (to default to no hyperlinks)
+\begin{codebox}
+\gls{glsxtrnewgls}\oarg{\glsoptval{hyper}{false}}\marg{sym.}\marg{\cmd{cs}}
+\end{codebox}
+now you can use \code{\cmd{cs}+\marg{M}} to behave like \code{\gls{gls}+\marg{cs.M}}.
+
+If you also want the plural and \idx{sentencecase}
+versions you can use
+\cmddef{glsxtrnewglslike}
+For example:
+\begin{codebox}
+\gls{glsxtrnewglslike}\oarg{\glsoptval{hyper}{false}}\marg{idx.}\marg{\cmd{idx}}\marg{\cmd{idxpl}}\marg{\cmd{Idx}}\marg{\cmd{Idxpl}}
+\end{codebox}
+For the \idx{allcaps} versions:
+\cmddef{glsxtrnewGLSlike}
+For example:
+\begin{codebox}
+\gls{glsxtrnewGLSlike}\oarg{\glsoptval{hyper}{false}}\marg{idx.}\marg{\cmd{IDX}}\marg{\cmd{IDXpl}}
+\end{codebox}
+
+For commands that require the link text to be specified, you can use:
+\cmddef{glsxtrnewglslink}
+which defines
+\code{\meta{cs}\oargm{options}\margm{label}\margm{text}} to behave
+like
+\code{\gls{glslink}\oarg{\meta{default-options},\meta{options}}\marg{\meta{prefix}\meta{label}}\margm{text}},
+or
+\cmddef{glsxtrnewglsdisp}
+which defines
+\code{\meta{cs}\oargm{options}\margm{label}\margm{text}} to behave
+like
+\code{\gls{glsdisp}\oarg{\meta{default-options},\meta{options}}\marg{\meta{prefix}\meta{label}}\margm{text}}.
+
+If you are using \app{bib2gls}, it can pick up the custom commands
+that are defined using the above, so it can detect dependencies when
+it parses fields such as \gloskey{description}.
+If you provide your own custom command with just
+\gls{newcommand} that has syntax that starts with
+\oargm{options}\margm{entry-label}, then you can notify \app{bib2gls} using:
+\cmddef{glsxtridentifyglslike}
+where \meta{label-prefix} is the prefix to apply to the label that's
+passed to the command \meta{cs}. The information is written to the
+\ext{aux} file so that \app{bib2gls} can add the given
+command to those it looks for when searching for dependencies.
+
+Another possibility when using \app{bib2gls} is to set up known
+label prefixes, see \sectionref{sec:dgls} for further details.
+
+If you use \app{bib2gls} with record counting, there are
+commands to \gls{glsxtrnewgls} for \gls{rgls}:
+\cmddef{glsxtrnewrgls}
+and for \gls{rgls}, \gls{rglspl}, \gls{rGls} and \gls{rGlspl}:
+\cmddef{glsxtrnewrglslike}
+and for \idx{allcaps}:
+\cmddef{glsxtrnewrGLSlike}
+
+Defining commands in this manner (rather than simply using
+\csfmt{newcommand}) also allows the command to be identified as a
+\idx{sentencecase} blocker to prevent the label from being converted
+or, in the case of \gls{glsxtrnewglslike} and
+\gls{glsxtrnewrglslike}, as a mapping. See
+\sectionref{sec:casechange} for further details.
+
+
+\section{Indexing}
+\label{sec:wrglossary}
+
+\Idx{indexing} is normally performed implicitly by the \idx{glslike}
+and \idx{glstextlike} commands, but this action can be prevented,
+such as by using the option \glsoptval{noindex}{true}. These commands also
+generate text (the \idx{linktext}, \sectionref{sec:entryfmtmods}).
+If you want to simply index an entry (to ensure that an entry is
+shown in the \idx{glossary}) without producing any text then you can use
+\gls{glsadd}. \Idx{indexing} is also performed by cross-referencing
+commands, such as \gls{glssee}. In the case of \app{makeindex},
+\gls{glssee} simply behaves like \gls{glsadd} with a special format
+and the \location\ set to Z (which pushes it to the end of the
+\idx{locationlist}). Entries in \idxpl{ignoredglossary} can only be
+\indexed\ with \app{bib2gls}.
+
+If you want \emph{all} defined entries to appear in the
+\idx{glossary}, regardless of whether or not they have been used in
+the document, then you can use \gls{glsaddall} or \gls{glsaddallunused}
+(both provided by the base \sty{glossaries} package). These both
+iterate over all entries (in all non-\idxpl{ignoredglossary}). In
+the first case (\gls{glsaddall}), every entry is \indexed\ with the
+\gls{glsadd} options provided in the optional argument of
+\gls{glsaddall}. In the second case (\gls{glsaddallunused}), only
+those entries that haven't been marked as \idxc{firstuseflag}{used}
+so far will be indexed using
+\code{\gls{glsadd}\oarg{\glsoptval{format}{glsignore}}\margm{label}}.
+See the \sty{glossaries} manual for further details of those
+commands.
+
+The \sty{glossaries-extra} package provides a similar command:
+\cmddef{glsaddallunindexed}
+This is like \gls{glsaddallunused} but indexes all entries that
+haven't been \indexed\ so far (again using the option \glsoptval{format}{glsignore}).
+This is preferable to \gls{glsaddallunused} if you have to reset the
+\idx{firstuseflag} for any entries. As with \gls{glsaddallunused},
+if this command is required, it should be placed near the end of the
+document. Indexing any entries after either of these commands are
+used will cause spurious commas in the \idxpl{locationlist}.
\begin{important}
-The singular short form is always used here, even with \cs{glspl}.
-(Unlike \abbrstyle{long-hyphen-long-hyphen}.)
+Iterative commands such as \gls{glsaddall}, \gls{glsaddallunused}
+and \gls{glsaddallunindexed}
+should not be used with \app{bib2gls}. Use the
+\resourceoptval{selection}{all} option instead.
\end{important}
-The part in the link-text on first use:
-\begin{definition}[\DescribeMacro\glsxtrlonghyphen]
-\cs{glsxtrlonghyphen}\marg{long}\marg{label}\marg{insert}
-\end{definition}
-checks if \meta{insert} starts with a hyphen. If it does, then
-\cs{glsxtrwordsep} is locally redefined to a hyphen. This command
-only uses \meta{insert} to test if it starts with a hyphen.
-The actual insertion code isn't typeset until the post-link
-hook and it's also localised, which means that you can use
-commands like \cs{gls} in \meta{insert} for this style without
-causing nested hyperlinks, but only for commands like \cs{gls}.
+If you want to index a specific subset of entries, rather than all
+entries for a given glossary, you can use:
+\cmddef{glsaddeach}
+This does \code{\gls{glsadd}\oargm{options}\margm{entry-label}} for
+each entry in the comma-separated \meta{entry label list}. This
+command may be used with \app{bib2gls}, although it may be simpler
+to adjust the selection criteria or use filtering.
+
+\cmddef{GlsXtrAutoAddOnFormat}
+This will make the \idx{glslike} and \idx{glstextlike} commands
+automatically use \code{\gls{glsadd}\oargm{gls\-add
+options}\margm{entry-label}} whenever a \idx{glslike} or
+\idx{glstextlike} command is used for the entry given by
+\meta{entry-label} when the \glsopt{format} matches
+one of the formats in the comma-separated \meta{format list}
+
+The optional argument \meta{label} defaults to \gls{glslabel} (which
+will match \meta{entry-label} that was used with \gls{gls} etc) and
+indicates the entry label to use in \gls{glsadd} and so needs to be
+expandable. The \meta{format list} is a comma-separated list
+of format values that will trigger the automated adding. The
+\meta{glsadd options} are the options to pass to \gls{glsadd} with
+\glsoptval{format}{\marg{format}} prepended to the list.
+
+For example, with:
+\begin{codebox}
+\gls{GlsXtrAutoAddOnFormat}\marg{hyperbf}\marg{\glsoptval{counter}{chapter}}
+\end{codebox}
+then \code{\gls{gls}\oarg{\glsoptval{format}{hyperbf}}\marg{sample}}
+will be equivalent to:
+\begin{compactcodebox}
+\gls{glsadd}\oarg{\glsoptval{format}{hyperbf},\glsoptval{counter}{chapter}}\marg{sample}\gls{gls}\oarg{\glsoptval{format}{hyperbf}}\marg{sample}
+\end{compactcodebox}
+Note that the explicit range markers will prevent a match
+unless you include them in \meta{format list} (in which case, be
+sure to add both the start and end formats).
+
+Here's another example:
+\begin{codebox}
+\gls{GlsXtrAutoAddOnFormat}\oarg{dual.\gls{glslabel}}\marg{hyperbf}\marg{}
+\end{codebox}
+In this case
+\code{\gls{gls}\oarg{\glsoptval{format}{hyperbf}}\marg{sample}} will
+now be equivalent to:
+\begin{codebox}
+\gls{glsadd}\oarg{\glsoptval{format}{hyperbf}}\marg{dual.sample}\gls{gls}\oarg{\glsoptval{format}{hyperbf}}\marg{sample}
+\end{codebox}
\begin{important}
-Don't use \cs{gls} in the \meta{insert} part for commands
-like \cs{glsxtrfull}, \cs{glsxtrshort} or \cs{glsxtrlong}.
+\gls{GlsXtrAutoAddOnFormat} is not applied to \gls{glsadd}
+as it could cause an infinite loop.
\end{important}
-The inline full display format used by commands like \cs{glsxtrfull}
-behaves differently to the first use of \cs{gls} with this style.
-It's better to use \cs{glsreset}\marg{label}\cs{gls}\marg{label}
-if you want to ensure the full format.
+In the context of \sty{glossaries} and \sty{glossaries-extra}, \idx{indexing}
+refers to the mechanism used to ensure that an entry
+is included in its associated glossary. (If you also want to use
+\gls{index}, see \sectionref{sec:autoindex}.) This includes any entries
+that simply cross-reference another entry. The default is to use
+\app{makeindex}, which is a general purpose \idx{indexingapp}. Each
+time an entry is \indexed, a line is added to an associated file
+that contains the \idx{indexing} information, which includes the
+sort value, the \idxc{hierarchicallevel}{hierarchical information}
+(if the entry has a parent) and an associated \location\ (the page
+number, by default). This information is used to sort the entries
+and collate the \locations\ into a compact \idx{locationlist}. The
+\opt{xindy} package option switches to using \app{xindy} syntax, but
+the process is much the same.
+
+Since both \app+{makeindex} and \app+{xindy} are general purpose
+\idxpl{indexingapp} they require an associated \location\ (or a
+cross-reference) since indexes are typically used to lookup the
+\locations\ in the document where the term occurs. Although
+\idxpl{glossary} are similar to indexes they can simply be used to provide
+brief summaries of each term without any \locations. The way that
+\app{makeindex} and \app{xindy} work means that valid \locations\
+(that is, \locations\ that conform to
+\app{makeindex}\slash\app{xindy} syntax) must be supplied even if no
+\idx{locationlist} is required. If an invalid \location\ is used, an
+error will occur during the \app{makeindex}\slash\app{xindy} step in
+the build process, even if the \location\ will eventually be ignored
+when typesetting the \idx{glossary}.
+
+All \idxpl{locationlist} can be suppressed with the
+\opt{nonumberlist} option (which simply discards the
+\idx{locationlist} for each entry), but there are occasions where
+only some \locations\ need to be suppressed. The main way of hiding
+a \location\ is to encapsulate the \location\ with a command that
+does nothing. The \gls{glsignore} command is used for this purpose
+(\glsoptval{format}{glsignore}). However, it's important to
+remember that even though the \location\ isn't shown, it's still
+present in the \idx{locationlist}. This means that you will end up
+with spurious commas if there's more than one item in the
+\idx{locationlist}.
+
+The \qt{noidx} method similarly writes indexing information, but in this case
+the information is written to the \ext{aux} file. Again, empty locations can
+cause spurious commas in the \idxpl{locationlist}.
+
+The only method that recognises \gls{glsignore} as a special
+\qt{\idx{ignoredlocation}} is \app{bib2gls}, where this format will trigger the
+entry's selection but won't add the \idx{ignoredlocation} to the
+\idx{locationlist}. This avoids the problem of spurious commas
+caused by invisible locations.
+
+The \location\ corresponds to a counter. The default is the
+\ctr{page} counter, but may be changed with the \opt{counter}
+package option, the \meta{counter} optional argument of
+\gls{newglossary}, the \gloskey{counter} key when defining an entry,
+or the \glsopt{counter} option when \idx{indexing} an entry.
+
+Note that \app{bib2gls} v3.0+ converts an empty \location\
+(which can occur when the \idx{locationcounter} is 0 and should be
+formatted as a Roman numeral) to an \idx{ignoredlocation}.
+For example, if you use \optval{counter}{\ctr{part}} but have \gls{gls}
+before the first \gls{part}. An empty \location\ will trigger an
+error with \app{makeindex} and \app{xindy}.
+
+\begin{warning}
+Since no entries are defined on the first \LaTeX\ run with
+\app{bib2gls}, there's no way of determining the entry's
+\idx{glossary} \gloskey{type} or of finding if the entry's \gloskey{counter}
+key has been set. This means that if the counter has been assigned
+to either the entry's \idx{glossary} or to the entry itself, the
+\idx{locationcounter} can't be implemented until the entry has
+been defined. A second build is required to ensure that the
+\locations\ use the correct counter.
+\end{warning}
+
+The \idx{locationcounter} must expand to syntax that's recognised by the
+\idx{indexingapp}. This is very restrictive with \app{makeindex},
+which only recognises Western Arabic (\gls{arabic}),
+\idx{lowercase} Roman numerals (\gls{roman}),
+\idx{uppercase} Roman numerals (\gls{Roman}),
+\idx{lowercase} Basic Latin (\gls{alph}) and
+\idx{uppercase} Basic Latin (\gls{Alph}), with optionally a
+separator (hyphen by default). With \app{xindy}, the syntax must be
+defined (see the \sty{glossaries} manual for further details).
+
+There's no restriction on the location syntax with \app{bib2gls}.
+The only limitation is that if \app{bib2gls} can't determine an
+associated numeric value according to its location parser, it won't form ranges.
+This means that with \app{bib2gls}, you can set arbitrary text as
+the \location\ (that's not related to a counter) with \glsopt{thevalue}.
+You can also use \glsopt{thevalue} with \app{makeindex} and
+\app{xindy}, but only if the value matches the required \location\
+syntax.
+
+Both \app{makeindex} and \app{xindy} order the \locations\ in the \idxpl{locationlist}.
+For example:
+\begin{codebox}
+\gls{makeglossaries}
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{an example}}
+\cbeg{document}
+\gls{gls}\oarg{\glsoptval{thevalue}{Z}}\marg{sample} (Z), \gls{gls}\oarg{\glsoptval{thevalue}{4}}\marg{sample} (4),
+\gls{gls}\oarg{\glsoptval{thevalue}{xi}}\marg{sample} (xi), \gls{gls}\oarg{\glsoptval{thevalue}{2}}\marg{sample} (2),
+\gls{gls}\oarg{\glsoptval{thevalue}{iii}}\marg{sample} (iii), \gls{gls}\oarg{\glsoptval{thevalue}{A}}\marg{sample} (A).
+\codepar
+\gls{printglossaries}
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample*[arara={pdflatex,makeglossaries,pdflatex,pdfcrop},
+ label={ex:mkidxloclistorder},
+title={Location list ordering (\appfmt{makeindex})},
+description={Example document with contrived locations that result
+in an ordered location list consisting of iii, xi, 2, 4, A, Z}]
+{%
+\cmd{usepackage}\marg{glossaries-extra}^^J%
+\gls{makeglossaries}^^J%
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{an example}}
+}
+{%
+\gls{gls}\oarg{thevalue=Z}\marg{sample} (Z), \gls{gls}\oarg{thevalue=4}\marg{sample} (4),^^J%
+\gls{gls}\oarg{thevalue=xi}\marg{sample} (xi), \gls{gls}\oarg{thevalue=2}\marg{sample} (2),^^J%
+\gls{gls}\oarg{thevalue=iii}\marg{sample} (iii), \gls{gls}\oarg{thevalue=A}\marg{sample} (A).^^J%
+\gls{printglossaries}
+}
+\end{resultbox}
+
+With \app{makeindex}, the \idx{locationlist} is grouped into the
+different number formats (\gls{roman}, \gls{arabic} and \gls{Alph}),
+with each group ordered numerically. The same result can be produced
+with \app{xindy} by adding the \opt{xindy} package option to the
+above example.
+
+With \app{bib2gls}, the \idx{locationlist} is always in order of
+\idx{indexing}. The above example document can be converted to use
+\app{bib2gls} as follows:
+\begin{codebox}
+\cbeg{filecontents*}\marg{\cmd{jobname}.bib}
+\atentry{entry}\marg{sample,\gloskeyval{name}{sample},\gloskeyval{description}{an example}}
+\cend{filecontents*}
+\cmd{usepackage}[\opt{record}]\marg{glossaries-extra}
+\gls{GlsXtrLoadResources}
+\cbeg{document}
+\gls{gls}\oarg{\glsoptval{thevalue}{Z}}\marg{sample} (Z), \gls{gls}\oarg{\glsoptval{thevalue}{4}}\marg{sample} (4),
+\gls{gls}\oarg{\glsoptval{thevalue}{xi}}\marg{sample} (xi), \gls{gls}\oarg{\glsoptval{thevalue}{2}}\marg{sample} (2),
+\gls{gls}\oarg{\glsoptval{thevalue}{iii}}\marg{sample} (iii), \gls{gls}\oarg{\glsoptval{thevalue}{A}}\marg{sample} (A).
+\gls{printunsrtglossaries}
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample*[arara={pdflatex,bib2gls,pdflatex,pdfcrop},
+ label={ex:b2gloclistorder},
+title={Location list ordering (\appfmt{bib2gls})},
+description={Example document with contrived locations that result
+in a location list consisting of Z, 4, xi, 2, ii, A, which
+corresponds to the record order}]
+{%
+\cbeg{filecontents*}\marg{\cmd{jobname}.bib}^^J%
+@entry\marg{sample,name=\marg{sample},description=\marg{an example}}^^J%
+\cend{filecontents*}^^J%
+\cmd{usepackage}[record]\marg{glossaries-extra}^^J%
+\gls{GlsXtrLoadResources}
+}
+{%
+\gls{gls}\oarg{thevalue=Z}\marg{sample} (Z), \gls{gls}\oarg{thevalue=4}\marg{sample} (4),^^J%
+\gls{gls}\oarg{thevalue=xi}\marg{sample} (xi), \gls{gls}\oarg{thevalue=2}\marg{sample} (2),^^J%
+\gls{gls}\oarg{thevalue=iii}\marg{sample} (iii), \gls{gls}\oarg{thevalue=A}\marg{sample} (A).^^J%
+\codepar
+\gls{printunsrtglossaries}
+}
+\end{resultbox}
+This example is contrived. For most documents, the order of \idx{indexing}
+will likely match the desired \idx{locationlist} order.
+
+Another important difference between \app{bib2gls} and the other
+indexing methods is the treatment of cross-references identified by
+the cross-reference keys \gloskey{see}, \gloskey{seealso} and
+\gloskey{alias}. With \app{bib2gls}, the cross-referencing
+information is picked up when \app{bib2gls} parses the \ext{bib}
+file and is used to establish dependencies, which ensures that when
+entries with cross-references are selected, their cross-referenced
+entries will also be selected.
+
+With the other methods, cross-references are added to an entry's
+\idx{locationlist} by \idx{indexing} the entry with a special
+format. The \gloskey{see}, \gloskey{seealso} and \gloskey{alias}
+keys automatically trigger this \idx{indexing} unless
+\optval{autoseeindex}{false}. See \sectionref{sec:xr} for further
+details.
-\item[\abbrstyledef{long-hyphen-postshort-hyphen-desc}]
+Every time an entry is \indexed, the following hook is also used:
+\cmddef{glsxtrdowrglossaryhook}
+This does nothing by default. The argument is the entry's label.
+
+The \idx{indexing} code is encapsulated with:
+\cmddef{glsencapwrcontent}
+This adds grouping, which helps to prevent spacing issues caused by
+the \idx{whatsit} that's created by the \idx{indexing}.
+
+The base \sty{glossaries} package always performs the \idx{indexing}
+before the \idx{linktext} for the \idx{glslike} and \idx{glstextlike}
+commands. This means that if a page break occurs in the middle of
+the \idx{linktext}, the \location\ will refer to the page number at
+the start of the \idx{linktext} (assuming the default \ctr{page}
+\idx{locationcounter}). With \sty{glossaries-extra}, you can use the
+option \glsoptval{wrgloss}{after} to have the \idx{indexing} occur after
+the \idx{linktext}. The \catattr{wrgloss} attribute can also be
+used. The default setting is initialised with \gls{glsxtrinitwrgloss}
+(see \sectionref{sec:defaultglsopts}).
+
+Every time an entry is \indexed, an \idx{internalfield} associated with the entry's
+label is globally updated to keep a count of the number of times the entry has
+been \indexed. The value can be accessed with:
+\cmddef{glsentryindexcount}
+This command will expand to 0 if the entry hasn't been \indexed\ or hasn't been
+defined. To test if the value is greater than 0 (that is, to test if the entry has been
+\indexed\ yet), use:
+\cmddef{glsifindexed}
+This expands to \meta{true} if the entry is defined and has been \indexed,
+otherwise it expands to \meta{false}. No warning or error occurs if
+the entry hasn't been defined.
+
+Note that the index count is a running total. This is not the same as the
+\record\ count saved by \app{bib2gls}['s] \switch{record-count}
+switch, which represents the total number of \records\ for the given
+entry from the previous \LaTeX\ run.
+
+The base \sty{glossaries} package defines:
+\cmddef{glswriteentry}
+This command conditionally writes the indexing code (supplied by the second
+argument \meta{code}).
+The original definition simply tests whether or not the \opt{indexonlyfirst} setting
+is on. The \sty{glossaries-extra} package redefines this command to perform additional
+checks to determine whether or not the \idx{indexing} code should be performed.
+
+The modified definition uses:
+\cmddef{glsxtrifindexing}
+to test the \glsopt{noindex} setting. This does \meta{false} if
+\glsoptval{noindex}{true}, otherwise it does \meta{true}.
+\cmddef{ifglsindexonlyfirst}
+This is a conditional that corresponds to the \opt{indexonlyfirst}
+package option. \Idx{firstuse} is tested using
+\gls{GlsXtrIfUnusedOrUndefined} rather than \gls{ifglsused}. The
+\catattr{indexonlyfirst} attribute is also tested. If the
+\qt{index only first} setting is on and the entry has been
+\idxc{firstuseflag}{used}, \meta{code} isn't performed but
+auto-indexing via \gls{glsxtrdoautoindexname} is still performed
+(see \sectionref{sec:autoindex}).
+
+\begin{warning}
+Since no entries are defined on the first \LaTeX\ run with
+\app{bib2gls}, there's no way of keeping track of whether or not an
+entry has been used or what its \gloskey{category} is, which is required to
+query the \catattr{indexonlyfirst} attribute, so for the first
+document build all instances will be \indexed. A second build is
+required for the \qt{index only first} feature.
+\end{warning}
+
+\section{Cross-Referencing}
+\label{sec:xr}
+
+The base \sty{glossaries} package only provides the \gloskey{see}
+key, which automatically \idxc{indexing}{indexes} the cross-reference using
+\gls{glssee}. The value of this key isn't saved and can't be
+accessed later. (The key was simply provided as a shortcut.)
+The \idx{indexing} ensures that the cross-reference is
+shown in the \idx{locationlist}.
-New to version 1.17.
-This is similar to \abbrstyle{long-hyphen-postshort-hyphen} but the
-user supplies the description. The \gloskey{name} is obtained from
-\cs{glsxtrlongshortdescname}.
+\begin{important}
+The auto-indexing feature of the \gloskey{see} key was intended as a
+shortcut where only entries required in the document are defined.
+If you want to have a large file containing entries that may or may not
+be required in the document, then using \gloskey{see},
+\gloskey{seealso} or \gloskey{alias} can cause unwanted entries to
+appear in the glossary. In this case, see
+\sectionref{sec:seenoindex}.
+\end{important}
+The \sty{glossaries-extra} package saves the value of the
+\gloskey{see} key and additionally provides the \gloskey{seealso}
+and \gloskey{alias} keys that perform similar functions. The values
+of the \gloskey{see}, \gloskey{seealso} and \gloskey{alias} keys can
+all be accessed at a later point in the document.
+
+If an entry with a cross-reference has been included in the
+glossary, there's no guarantee that the cross-referenced entry will
+also be included. It won't be included if it hasn't been indexed
+anywhere in the document. You can use the \opt{indexcrossrefs}
+package option to search for cross-references that require \idx{indexing}
+at the end of the document, but note that this can be time-consuming
+if you have a large number of entries.
+
+\begin{information}
+With \app{bib2gls} you can simply change the selection criteria
+(\resourceoptvalm{selection}{recorded and deps and see} or
+\resourceoptvalm{selection}{recorded and deps and see not
+also}) to ensure that all cross-referenced entries are included even
+if they haven't been \indexed\ in the document.
+\end{information}
+
+
+Example (\gloskey{see} and \gloskey{seealso} keys):
+\begin{codebox}
+\gls{newglossaryentry}\marg{pumpkin}\marg{\gloskeyval{name}{pumpkin},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{cucumber}\marg{\gloskeyval{name}{cucumber},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{melon}\marg{\gloskeyval{name}{melon},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{gourd}\marg{\gloskeyval{name}{gourd},\gloskeyval{description}{},
+ \gloskeyval{see}{pumpkin,cucumber,melon}}
+\gls{newglossaryentry}\marg{courgette}\marg{\gloskeyval{name}{courgette},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{marrow}\marg{\gloskeyval{name}{marrow},\gloskeyval{description}{},
+ \gloskeyval{seealso}{courgette}}
+\end{codebox}
+When the \code{gourd} entry is defined, the cross-reference will
+automatically be \indexed\ using \gls{glssee}. This means that the
+\code{gourd} entry will appear in the glossary, regardless of
+whether or not it is used in the document, with \qt{\emph{see}
+pumpkin, cucumber \& melon} in the \idx{locationlist}. If
+\code{gourd} is also \indexed\ in the document, then those
+\locations\ will also be added to the gourd's \idx{locationlist}.
+
+The cross-referenced entries (pumpkin, cucumber and melon) will only
+appear in the glossary if they are also \indexed\ in the document.
+This can be implemented automatically with \opt{indexcrossrefs}.
+
+The \gloskey{seealso} key in the \code{marrow} entry functions in
+much the same way, but it is \indexed\ with \gls{glsxtrindexseealso}.
+This means that the \code{marrow} entry will have \qt{\emph{see
+also} courgette} in its \idx{locationlist}.
+
+The \gloskey{see} key may optionally start with \oargm{tag} to
+replace the default \gls{seename} tag with \meta{tag}. The
+\gloskey{seealso} key doesn't permit this. For example, the
+following is permitted:
+\begin{codebox}
+\gls{newglossaryentry}\marg{gourd}\marg{\gloskeyval{name}{gourd},\gloskeyval{description}{},
+ \gloskeyval{see}{[related topics]pumpkin,cucumber,melon}}
+\end{codebox}
+but you can't replace \gloskey{see} with \gloskey{seealso} in the
+above as it would assume that the first label in the list is
+\code{[related topics]pumpkin} which is incorrect. The tag would
+have to be removed:
+\begin{codebox}
+\gls{newglossaryentry}\marg{gourd}\marg{\gloskeyval{name}{gourd},\gloskeyval{description}{},
+ \gloskeyval{seealso}{pumpkin,cucumber,melon}}
+\end{codebox}
+(You could then redefine \gls{seealsoname} to \code{related topics},
+if required or redefine \gls{glsxtruseseealsoformat} as applicable.)
+
+Example (\gloskey{alias} key):
+\begin{codebox}
+\gls{newglossaryentry}\marg{zucchini}\marg{\gloskeyval{name}{zucchini},\gloskeyval{description}{},
+ \gloskeyval{alias}{courgette}}
+\end{codebox}
+When the \code{zucchini} entry is defined, the \gloskey{alias} key
+will automatically \idxc{indexing}{index} zucchini with
+\code{\gls{glssee}\marg{zucchini}\marg{courgette}}. This means that
+the \code{zucchini} entry will be present in the glossary with
+\qt{\emph{see} courgette} in the \idx{locationlist}. If the
+\code{zucchini} entry is referenced in the document using a command
+like \gls{gls}, then the hyperlink (if enabled) will go to the
+\code{courgette} entry (not the \code{zucchini} entry) but the
+\code{zucchini} entry won't be indexed.
+
+If you want the \code{zucchini} entry \locations\ added to the
+\code{courgette} entry, you can redefine
+\gls{glsxtrsetaliasnoindex} (see \sectionref{sec:glssee}) or, with
+\app{bib2gls}, use the \resourceoptval{alias-loc}{transfer} setting.
+
+\begin{information}
+With \app{bib2gls}, cross-references are selected according to the
+\resourceopt{selection} criteria. See the \app{bib2gls} manual for
+further details.
+\end{information}
+
+\subsection{Entries that may not be required}
+\label{sec:seenoindex}
+
+If you have a file containing a large number of entry definitions
+shared across multiple documents, then the use of the \gloskey{see},
+\gloskey{seealso} or \gloskey{alias} key can cause unwanted entries
+to appear in the document. This can be demonstrated as follows.
+Suppose the file \filefmt{myentries.tex} contains:
+\begin{codebox}
+\gls{newglossaryentry}\marg{pumpkin}\marg{\gloskeyval{name}{pumpkin},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{cucumber}\marg{\gloskeyval{name}{cucumber},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{melon}\marg{\gloskeyval{name}{melon},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{gourd}\marg{\gloskeyval{name}{gourd},\gloskeyval{description}{},
+ \gloskeyval{see}{pumpkin,cucumber,melon}}
+\gls{newglossaryentry}\marg{cucurbit}\marg{\gloskeyval{name}{cucurbit},\gloskeyval{description}{},
+ \gloskeyval{see}{gourd}}
+\gls{newglossaryentry}\marg{courgette}\marg{\gloskeyval{name}{courgette},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{marrow}\marg{\gloskeyval{name}{marrow},\gloskeyval{description}{},
+ \gloskeyval{seealso}{courgette}}
+\gls{newglossaryentry}\marg{zucchini}\marg{\gloskeyval{name}{zucchini},\gloskeyval{description}{},
+ \gloskeyval{alias}{courgette}}
+\gls{newglossaryentry}\marg{broccoli}\marg{\gloskeyval{name}{broccoli},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{cauliflower}\marg{\gloskeyval{name}{cauliflower},\gloskeyval{description}{},
+ \gloskeyval{seealso}{broccoli}}
+\end{codebox}
+Some of these entries have a cross-reference key set, but not all of
+these entries are required in the document:
+\begin{codebox}
+\cmd{usepackage}[colorlinks]\marg{hyperref}
+\cmd{usepackage}\oarg{\opt{nostyles},\optval{stylemods}{bookindex},\optval{style}{bookindex}}
+ \marg{glossaries-extra}
+\gls{makeglossaries}
+\gls{loadglsentries}\marg{myentries}
+\cbeg{document}
+This document is only discussing \gls{glspl}\marg{courgette} (baby
+\gls{glspl}\marg{marrow}, also called a \gls{gls}\marg{zucchini}),
+\gls{glspl}\marg{pumpkin} and \gls{glspl}\marg{melon}.
+\gls{printglossaries}
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample[arara={pdflatex,makeglossaries,pdflatex,pdfcrop},
+ label={ex:autoseeindextrue},
+ title={Cross-references (\optfmt{autoseeindex\dequals true})},
+ description={Example document illustrating the cross-referencing
+fields with the default auto-indexing of the cross-referenced terms}]
+{%
+ \usepackage[colorlinks]{hyperref}^^J%
+ \usepackage[nostyles,stylemods=bookindex,style=bookindex]^^J%
+ {glossaries-extra}^^J%
+ \makeglossaries^^J%
+ \newglossaryentry{pumpkin}{name={pumpkin},description={}}^^J%
+ \newglossaryentry{cucumber}{name={cucumber},description={}}^^J%
+ \newglossaryentry{melon}{name={melon},description={}}^^J%
+ \newglossaryentry{gourd}{name={gourd},description={},^^J%
+ see={pumpkin,cucumber,melon}}^^J%
+ \newglossaryentry{cucurbit}{name={cucurbit},description={},^^J%
+ see={gourd}}^^J%
+ \newglossaryentry{courgette}{name={courgette},description={}}^^J%
+ \newglossaryentry{marrow}{name={marrow},description={},^^J%
+ seealso={courgette}}^^J%
+ \newglossaryentry{zucchini}{name={zucchini},description={},^^J%
+ alias={courgette}}^^J%
+ \newglossaryentry{broccoli}{name={broccoli},description={}}^^J%
+ \newglossaryentry{cauliflower}{name={cauliflower},description={},
+ seealso={broccoli}}^^J%
+}
+{
+This document is only discussing
+\glspl{courgette} (baby \glspl{marrow},
+also called a \gls{zucchini}),
+\glspl{pumpkin} and \glspl{melon}.^^J%
+\printglossaries
+}
+\end{resultbox}
+Note that the glossary includes cucurbit and gourd, which aren't
+referenced in the document. They could be useful as a redirect for
+the reader, but the gourd entry cross-references the
+cucumber entry, which isn't included in the glossary, so the
+hyperlink target is undefined. The cauliflower entry has also been
+included in the glossary, but in this case it's not useful for the
+reader as neither cauliflower nor broccoli (which it
+cross-references) are mentioned in the document. As with the
+cucumber cross-reference, the broccoli cross-reference hyperlink
+target is undefined.
+
+There are a number of methods to address some of these problems.
+The first method has the cross-referencing keys in the \ext{tex}
+file (as above), but disables the auto-indexing:
+\begin{codebox}
+\cmd{usepackage}[colorlinks]\marg{hyperref}
+\cmd{usepackage}\oarg{\optval{autoseeindex}{false},\opt{nostyles},\optval{stylemods}{bookindex},
+ \optval{style}{bookindex}}\marg{glossaries-extra}
+\gls{makeglossaries}
+\gls{loadglsentries}\marg{myentries}
+\cbeg{document}
+This document is only discussing \gls{glspl}\marg{courgette} (baby
+\gls{glspl}\marg{marrow}, also called a \gls{gls}\marg{zucchini}),
+\gls{glspl}\marg{pumpkin} and \gls{glspl}\marg{melon}.
+\gls{printglossaries}
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample[arara={pdflatex,makeglossaries,pdflatex,pdfcrop},
+ label={ex:autoseeindexfalse},
+ title={Cross-references (\optfmt{autoseeindex\dequals false})},
+ description={Example document illustrating the cross-referencing
+fields without the auto-indexing of the cross-referenced terms}]
+{%
+ \usepackage[colorlinks]{hyperref}^^J%
+ \usepackage[autoseeindex=false,nostyles,stylemods=bookindex,style=bookindex]^^J%
+ {glossaries-extra}^^J%
+ \makeglossaries^^J%
+ \newglossaryentry{pumpkin}{name={pumpkin},description={}}^^J%
+ \newglossaryentry{cucumber}{name={cucumber},description={}}^^J%
+ \newglossaryentry{melon}{name={melon},description={}}^^J%
+ \newglossaryentry{gourd}{name={gourd},description={},^^J%
+ see={pumpkin,cucumber,melon}}^^J%
+ \newglossaryentry{cucurbit}{name={cucurbit},description={},^^J%
+ see={gourd}}^^J%
+ \newglossaryentry{courgette}{name={courgette},description={}}^^J%
+ \newglossaryentry{marrow}{name={marrow},description={},^^J%
+ seealso={courgette}}^^J%
+ \newglossaryentry{zucchini}{name={zucchini},description={},^^J%
+ alias={courgette}}^^J%
+ \newglossaryentry{broccoli}{name={broccoli},description={}}^^J%
+ \newglossaryentry{cauliflower}{name={cauliflower},description={},
+ seealso={broccoli}}^^J%
+}
+{
+This document is only discussing
+\glspl{courgette} (baby \glspl{marrow},
+also called a \gls{zucchini}),
+\glspl{pumpkin} and \glspl{melon}.^^J%
+\printglossaries
+}
+\end{resultbox}
+This doesn't show the zucchini entry or any of
+the cross-references in the \idx{glossary} because the information
+hasn't been added to the \idx{indexing} files. One way around this
+is to insert the cross-reference in a \idx{postdeschook}.
+
+\begin{codebox}
+\cmd{usepackage}[colorlinks]\marg{hyperref}
+\cmd{usepackage}\oarg{\optval{autoseeindex}{false},\opt{nostyles},\optval{stylemods}{bookindex},
+ \optval{style}{bookindex}}\marg{glossaries-extra}
+\gls{makeglossaries}
+\gls{loadglsentries}\marg{myentries}
+\gls{glsdefpostdesc}\marg{general}\marg{\comment{}
+ \gls{glsxtrseelists}\marg{\gls{glscurrententrylabel}}\comment{}
+}
+\cbeg{document}
+This document is only discussing
+\gls{glspl}\marg{courgette} (baby \gls{glspl}\marg{marrow},
+also called a \gls{gls}\marg{zucchini}),
+\gls{glspl}\marg{pumpkin} and \gls{glspl}\marg{melon}.
+\gls{printglossaries}
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample[arara={pdflatex,makeglossaries,pdflatex,pdfcrop},
+ label={ex:autoseeindexfalsepostname},
+ title={Cross-references (\optfmt{autoseeindex\dequals false} and post-name hook)},
+ description={Example document illustrating the cross-referencing
+fields without the auto-indexing of the cross-referenced terms but
+using the post-name hook}]
+{%
+ \usepackage[colorlinks]{hyperref}^^J%
+ \usepackage[autoseeindex=false,nostyles,^^J%
+ stylemods=bookindex,style=bookindex]{glossaries-extra}^^J%
+ \makeglossaries^^J%
+ \newglossaryentry{pumpkin}{name={pumpkin},description={}}^^J%
+ \newglossaryentry{cucumber}{name={cucumber},description={}}^^J%
+ \newglossaryentry{melon}{name={melon},description={}}^^J%
+ \newglossaryentry{gourd}{name={gourd},description={},^^J%
+ see={pumpkin,cucumber,melon}}^^J%
+ \newglossaryentry{cucurbit}{name={cucurbit},description={},^^J%
+ see={gourd}}^^J%
+ \newglossaryentry{courgette}{name={courgette},description={}}^^J%
+ \newglossaryentry{marrow}{name={marrow},description={},^^J%
+ seealso={courgette}}^^J%
+ \newglossaryentry{zucchini}{name={zucchini},description={},^^J%
+ alias={courgette}}^^J%
+ \newglossaryentry{broccoli}{name={broccoli},description={}}^^J%
+ \newglossaryentry{cauliflower}{name={cauliflower},description={},
+ seealso={broccoli}}^^J%
+ \glsdefpostname{general}{\glsxtrseelists{\glscurrententrylabel}}^^J%
+}
+{
+This document is only discussing
+\glspl{courgette} (baby \glspl{marrow},
+also called a \gls{zucchini}),
+\glspl{pumpkin} and \glspl{melon}.^^J%
+\printglossaries^^J%
+}
+\end{resultbox}
+
+However, this still doesn't solve the problem that the zucchini
+entry isn't included in the glossary. It needs to be indexed, but
+\idx{indexing} has been suppressed. Firstly, because the automatic
+\idx{indexing} triggered by the \gloskey{alias} key has been
+suppressed with \optval{autoseeindex}{false}, and, secondly, because
+the presence of the \gloskey{alias} key automatically suppresses
+\idx{indexing} with the \idx{glslike} and \idx{glstextlike}
+commands. This doesn't cause a problem for the zucchini hyperlink,
+since the target is courgette (obtained from the \gloskey{alias} key).
+
+The second method is to not use those keys in the entry definitions
+and use \gls{glssee} or \gls{glsxtrindexseealso} within the document.
+For example, the file \filefmt{myentries.tex} now contains:
+\begin{codebox}
+\gls{newglossaryentry}\marg{pumpkin}\marg{\gloskeyval{name}{pumpkin},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{cucumber}\marg{\gloskeyval{name}{cucumber},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{melon}\marg{\gloskeyval{name}{melon},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{gourd}\marg{\gloskeyval{name}{gourd},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{cucurbit}\marg{\gloskeyval{name}{cucurbit},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{courgette}\marg{\gloskeyval{name}{courgette},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{marrow}\marg{\gloskeyval{name}{marrow},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{zucchini}\marg{\gloskeyval{name}{zucchini},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{broccoli}\marg{\gloskeyval{name}{broccoli},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{cauliflower}\marg{\gloskeyval{name}{cauliflower},\gloskeyval{description}{}}
+\end{codebox}
+The document:
+\begin{codebox}
+\cmd{usepackage}[colorlinks]\marg{hyperref}
+\cmd{usepackage}[\opt{nostyles},\optval{stylemods}{bookindex},\optval{style}{bookindex}]
+ \marg{glossaries-extra}
+\gls{makeglossaries}
+\gls{loadglsentries}\marg{myentries}
+\gls{glssee}\marg{gourd}\marg{pumpkin,melon,courgette}
+\gls{glssee}\marg{zucchini}\marg{courgette}
+\gls{GlsXtrSetField}\marg{zucchini}\marg{alias}\marg{courgette}
+\cbeg{document}
+This document is only discussing \gls{glspl}\marg{courgette} (baby
+\gls{glspl}\marg{marrow}, also called a \gls{gls}\marg{zucchini}),
+\gls{glspl}\marg{pumpkin} and \gls{glspl}\marg{melon}.
+\gls{printglossaries}
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample[arara={pdflatex,makeglossaries,pdflatex,pdfcrop},
+ label={ex:noxrfields},
+ title={Cross-references (no \optfmt{see}, \optfmt{seealso} or \optfmt{alias})},
+ description={Example document illustrating cross-references without
+ using the see, seealso or alias keys}
+ ]
+{%
+ \usepackage[colorlinks]{hyperref}^^J%
+ \usepackage[nostyles,stylemods=bookindex,style=bookindex]{glossaries-extra}^^J%
+ \makeglossaries^^J%
+ \newglossaryentry{pumpkin}{name={pumpkin},description={}}^^J%
+ \newglossaryentry{cucumber}{name={cucumber},description={}}^^J%
+ \newglossaryentry{melon}{name={melon},description={}}^^J%
+ \newglossaryentry{gourd}{name={gourd},description={}}^^J%
+ \newglossaryentry{cucurbit}{name={cucurbit},description={}}^^J%
+ \newglossaryentry{courgette}{name={courgette},description={}}^^J%
+ \newglossaryentry{marrow}{name={marrow},description={}}^^J%
+ \newglossaryentry{zucchini}{name={zucchini},description={}}^^J%
+ \newglossaryentry{broccoli}{name={broccoli},description={}}^^J%
+ \newglossaryentry{cauliflower}{name={cauliflower},description={}}^^J%
+ \glssee{gourd}{pumpkin,melon,courgette}^^J%
+ \glssee{zucchini}{courgette}^^J%
+ \GlsXtrSetField{zucchini}{alias}{courgette}^^J%
+}
+{
+This document is only discussing
+\glspl{courgette} (baby \glspl{marrow},
+also called a \gls{zucchini}),
+\glspl{pumpkin} and \glspl{melon}.^^J%
+\printglossaries
+}
+\end{resultbox}
+Note that aliases require the \gloskey{alias} field to be set. In
+this case, I've set it with \gls{GlsXtrSetField}. The gourd and
+zucchini entries have been included in the glossary because they
+were added with \gls{glssee}. The other entries are in the glossary
+because they were indexed when referenced with \gls{gls} or
+\gls{glspl}.
+
+Since cucumber isn't required in the document, I haven't included it
+in the cross-reference list for gourd. This method is flexible as it
+allows the cross-referencing to vary between documents. For example,
+another document may instead have:
+\begin{codebox}
+\gls{glsxtrindexseealso}\marg{pumpkin}\marg{courgette,melon}
+\gls{glsxtrindexseealso}\marg{melon}\marg{pumpkin,courgette}
+\gls{glsxtrindexseealso}\marg{courgette}\marg{pumpkin,melon}
+\end{codebox}
+
+The third method is to switch to \app{bib2gls}. The file
+\filefmt{myentries.tex} can be converted to \filefmt{myentries.bib}
+using:
+\begin{terminal}
+\app{convertgls2bib} \switch{index-conversion} myentries.tex myentries.bib
+\end{terminal}
+I've used the option \switch{index-conversion} (or \switch{i}) which will use
+\atentry{index} instead of \atentry{entry} for entries that have an
+empty description (which is the case in this example).
+This creates the file \filefmt{myentries.bib}, which contains the
+following (space compacted):
+\begin{codebox}
+\comment{Encoding: UTF-8}
+@index\marg{pumpkin, \gloskeyval{name}{pumpkin}}
+@index\marg{cucumber, \gloskeyval{name}{cucumber}}
+@index\marg{melon, \gloskeyval{name}{melon}}
+@index\marg{gourd, \gloskeyval{see}{pumpkin,cucumber,melon}, \gloskeyval{name}{gourd}}
+@index\marg{cucurbit, \gloskeyval{see}{gourd}, \gloskeyval{name}{cucurbit}}
+@index\marg{courgette, \gloskeyval{name}{courgette}}
+@index\marg{marrow, \gloskeyval{name}{marrow}, \gloskeyval{seealso}{courgette}}
+@index\marg{zucchini, \gloskeyval{name}{zucchini}, \gloskeyval{alias}{courgette}}
+@index\marg{broccoli, \gloskeyval{name}{broccoli}}
+@index\marg{cauliflower, \gloskeyval{name}{cauliflower}, \gloskeyval{seealso}{broccoli}}
+\end{codebox}
+The earlier example~\ref{ex:autoseeindextrue} on page~\pageref{ex:autoseeindextrue}
+can be rewritten as:
+\begin{codebox}
+\cmd{usepackage}[colorlinks]\marg{hyperref}
+\cmd{usepackage}\oarg{\opt{record},\opt{nostyles},\optval{stylemods}{bookindex},\optval{style}{bookindex}}
+ \marg{glossaries-extra}
+\gls{GlsXtrLoadResources}\oarg{\resourceoptval{src}{myentries}}
+\cbeg{document}
+This document is only discussing \gls{glspl}\marg{courgette} (baby
+\gls{glspl}\marg{marrow}, also called a \gls{gls}\marg{zucchini}),
+\gls{glspl}\marg{pumpkin} and \gls{glspl}\marg{melon}.
+\gls{printunsrtglossaries}
+\cend{document}
+\end{codebox}
+In order to support letter \idxpl{group}, \app{bib2gls} needs to be
+invoked with the \switch{group} switch. The result is:
+\begin{resultbox}
+\createexample*[arara={pdflatex,bib2gls: { group: on },pdflatex,pdfcrop},
+ label={ex:recordedanddeps},
+ title={Cross-references (\appfmt{bib2gls})},
+ description={Example document illustrating the cross-referencing
+fields with bib2gls and selection=recorded and deps}]
+{%
+\cbeg{filecontents*}{\cmd{jobname}.bib}^^J%
+\% Encoding: UTF-8^^J%
+@index{pumpkin, name = {pumpkin}}^^J%
+@index{cucumber, name = {cucumber}}^^J%
+@index{melon, name = {melon}}^^J%
+@index{gourd, see = {pumpkin,cucumber,melon}, name = {gourd}}^^J%
+@index{cucurbit, see = {gourd}, name = {cucurbit}}^^J%
+@index{courgette, name = {courgette}}^^J%
+@index{marrow, name = {marrow}, seealso = {courgette}}^^J%
+@index{zucchini, name = {zucchini}, alias = {courgette}}^^J%
+@index{broccoli, name = {broccoli}}^^J%
+@index{cauliflower, name = {cauliflower}, seealso = {broccoli}
+}^^J%
+\cend{filecontents*}^^J%
+\cmd{usepackage}[colorlinks]\marg{hyperref}^^J%
+\cmd{usepackage}\oarg{record,nostyles,stylemods=bookindex,style=bookindex}\marg{glossaries-extra}^^J%
+\gls{GlsXtrLoadResources}\oarg{src=\cmd{jobname}}
+}
+{
+This document is only discussing
+\gls{glspl}\marg{courgette} (baby \gls{glspl}\marg{marrow},
+also called a \gls{gls}\marg{zucchini}),
+\gls{glspl}\marg{pumpkin} and \gls{glspl}\marg{melon}.^^J%
+\gls{printunsrtglossaries}
+}
+\end{resultbox}
+This uses the default \resourceoptvalm{selection}{recorded and
+deps}, which selects entries that have \records,
+and their dependencies. Records correspond to the usual indexing
+performed by the \idx{glslike}, \idx{glstextlike} or \idx{glsadd}
+commands. With \app{bib2gls}, the cross-referencing fields don't
+trigger an index but identify dependencies.
+
+Note that the above doesn't include the gourd entry (which
+cross-references entries that have been indexed). The selection
+criteria can be changed to also include unrecorded entries that cross-reference
+selected entries. There are two options to choose from:
+\resourceoptvalm{selection}{recorded and deps and see}, which will
+apply to all cross-reference fields (\gloskey{see},
+\gloskey{seealso} and \gloskey{alias}, or
+\resourceoptvalm{selection}{recorded and deps and see not also},
+which doesn't consider the \gloskey{seealso} field.
+
+Changing the \idxpl!{resourceopt} in the above example to:
+\begin{codebox}
+\gls{GlsXtrLoadResources}\oarg{\resourceoptval{src}{myentries},
+ \resourceoptvalm{selection}{recorded and deps and see}}
+\end{codebox}
+results in:
+\begin{resultbox}
+\createexample*[arara={pdflatex,bib2gls: { group: on },pdflatex,pdfcrop},
+ label={ex:recordedanddepsandsee},
+ title={Cross-references (\appfmt{bib2gls} and
+ \optfmt{selection\dequals recorded and deps and see})},
+ description={Example document illustrating the cross-referencing
+fields with bib2gls and selection=recorded and deps and see}]
+{%
+\cbeg{filecontents*}{\cmd{jobname}.bib}^^J%
+\% Encoding: UTF-8^^J%
+@index{pumpkin, name = {pumpkin}}^^J%
+@index{cucumber, name = {cucumber}}^^J%
+@index{melon, name = {melon}}^^J%
+@index{gourd, see = {pumpkin,cucumber,melon}, name = {gourd}}^^J%
+@index{cucurbit, see = {gourd}, name = {cucurbit}}^^J%
+@index{courgette, name = {courgette}}^^J%
+@index{marrow, name = {marrow}, seealso = {courgette}}^^J%
+@index{zucchini, name = {zucchini}, alias = {courgette}}^^J%
+@index{broccoli, name = {broccoli}}^^J%
+@index{cauliflower, name = {cauliflower}, seealso = {broccoli}
+}^^J%
+\cend{filecontents*}^^J%
+\cmd{usepackage}[colorlinks]\marg{hyperref}^^J%
+\cmd{usepackage}\oarg{record,nostyles,stylemods=bookindex,style=bookindex}\marg{glossaries-extra}^^J%
+\gls{GlsXtrLoadResources}\oarg{src=\cmd{jobname},selection={recorded and deps and see}}
+}
+{
+This document is only discussing
+\gls{glspl}\marg{courgette} (baby \gls{glspl}\marg{marrow},
+also called a \gls{gls}\marg{zucchini}),
+\gls{glspl}\marg{pumpkin} and \gls{glspl}\marg{melon}.^^J%
+\gls{printunsrtglossaries}
+}
+\end{resultbox}
+This now includes the gourd entry because it cross-references
+pumpkin and melon, which have been \recorded\ in the document.
+The cucurbit entry is also included because it cross-references the
+(now selected) gourd entry. Note that the cucumber entry has been
+selected because the gourd entry depends on it. This means there are
+no broken links in the glossary, but it looks a bit odd as the
+cucumber entry has no \idx{locationlist}. As from \app{bib2gls}
+v3.0, this can be removed with one of the cross-reference pruning
+options, such as \resourceopt{prune-xr}.
+For example:
+\begin{codebox}
+\gls{GlsXtrLoadResources}\oarg{\resourceoptval{src}{myentries},
+ \resourceoptvalm{selection}{recorded and deps and see},\resourceopt{prune-xr}}
+\end{codebox}
+results in:
+\begin{resultbox}
+\createexample*[arara={pdflatex,bib2gls: { group: on },pdflatex,pdfcrop},
+ label={ex:recordedanddepsandseeprune},
+ title={Cross-references (\appfmt{bib2gls} and
+ \optfmt{selection\dequals recorded and deps and see}, \optfmt{prune-xr})},
+ description={Example document illustrating the cross-referencing
+fields with bib2gls and selection=recorded and deps and see and pruning}]
+{%
+\cbeg{filecontents*}{\cmd{jobname}.bib}^^J%
+\% Encoding: UTF-8^^J%
+@index{pumpkin, name = {pumpkin}}^^J%
+@index{cucumber, name = {cucumber}}^^J%
+@index{melon, name = {melon}}^^J%
+@index{gourd, see = {pumpkin,cucumber,melon}, name = {gourd}}^^J%
+@index{cucurbit, see = {gourd}, name = {cucurbit}}^^J%
+@index{courgette, name = {courgette}}^^J%
+@index{marrow, name = {marrow}, seealso = {courgette}}^^J%
+@index{zucchini, name = {zucchini}, alias = {courgette}}^^J%
+@index{broccoli, name = {broccoli}}^^J%
+@index{cauliflower, name = {cauliflower}, seealso = {broccoli}
+}^^J%
+\cend{filecontents*}^^J%
+\cmd{usepackage}[colorlinks]\marg{hyperref}^^J%
+\cmd{usepackage}\oarg{record,nostyles,stylemods=bookindex,style=bookindex}\marg{glossaries-extra}^^J%
+\gls{GlsXtrLoadResources}\oarg{src=\cmd{jobname},selection={recorded and deps and see},prune-xr}
+}
+{
+This document is only discussing
+\gls{glspl}\marg{courgette} (baby \gls{glspl}\marg{marrow},
+also called a \gls{gls}\marg{zucchini}),
+\gls{glspl}\marg{pumpkin} and \gls{glspl}\marg{melon}.^^J%
+\gls{printunsrtglossaries}
+}
+\end{resultbox}
+This has removed the unnecessary cucumber from the gourd's
+\gloskey{see} list, and so cucumber doesn't get selected.
+
+\begin{information}
+See the \app{bib2gls} user manual for further details on the
+cross-reference selection and pruning options.
+\end{information}
+
+\subsection{Accessing the Cross-Referencing Fields}
+\label{sec:getsee}
+
+If you have switched off the indexing of the cross-reference
+fields (with \optval{autoseeindex}{false}) or want to suppress the
+\idxpl{locationlist}, then you can adjust the glossary style or
+hooks to include the cross-references since they won't be shown
+otherwise.
+
+\cmddef{glsxtrseelists}
+If the entry given by \meta{entry-label} has the
+\gloskey{see}, \gloskey{seealso} or \gloskey{alias} fields set,
+this will display the cross reference
+according to \gls{glsxtruseseeformat} (for \gloskey{see} and
+\gloskey{alias}) or \gls{glsxtruseseealsoformat} (for
+\gloskey{seealso}). If any of these fields are set, the list is
+encapsulated with:
+\cmddef{glsxtrseelistsencap}
+This simply does a space followed by \meta{content}. If more than
+one of the fields are set (not recommended), then they will be
+displayed in the order: \gloskey{see}, \gloskey{seealso} and
+\gloskey{alias}. The entire set will be encapsulated with
+\gls{glsxtrseelistsencap} and each sub-list will be separated with:
+\cmddef{glsxtrseelistsdelim}
+which defaults to a comma followed by a space.
+
+\cmddef{glsxtrusesee}
+If the entry given by \meta{entry-label} has the
+\gloskey{see} field set, this will display the cross reference
+according to \gls{glsxtruseseeformat}, otherwise this does nothing.
+An error (or warning with \opteqvalref{undefaction}{warn}) will
+occur if the entry hasn't been defined.
+
+\cmddef{glsxtrusealias}
+As \gls{glsxtrusesee} but for the \gloskey{alias} field.
+
+\cmddef{glsxtruseseealso}
+If the entry given by \meta{entry-label} has the
+\gloskey{seealso} field set, this will display the cross reference
+according to \gls{glsxtruseseealsoformat}, otherwise this does nothing.
+An error (or warning with \opteqvalref{undefaction}{warn}) will
+occur if the entry hasn't been defined.
+
+\cmddef{glsxtralias}
+This expands to the value of the \gloskey{alias} field (which should
+be a single entry label) or empty if the field isn't set. If the
+entry isn't defined, this command will expand to \gls{relax}
+(without any error or warning). If you want to first test if the
+field is set, you can use \gls{glsxtrifhasfield}.
+
+\cmddef{glsxtrseealsolabels}
+This expands to the value of the \gloskey{seealso} field (which
+should be a comma-separated list of entry labels) or empty if the
+field isn't set. If the entry isn't defined, this command will
+expand to \gls{relax} (without any error or warning). If you want to
+first test if the field is set, you can use \gls{glsxtrifhasfield}.
+
+\cmddef{glsxtruseseealsoformat}
+This command is used to format a \qt{see also} cross-reference.
+This is simply defined to do:
+\begin{codebox*}
+\gls{glsseeformat}\oarg{\gls{seealsoname}}\margm{csv-list}\margm{}
+\end{codebox*}
+
+\subsection{Cross-Reference Indexing}
+\label{sec:glssee}
+
+\begin{information}
+If you are using \app{bib2gls}, see the \app{bib2gls} user manual
+for information about the \resourceopt{selection},
+\resourceopt{see}, \resourceopt{seealso}, \resourceopt{alias},
+\resourceopt{alias-loc} options.
+\end{information}
+
+The actual \idx{indexing} of the \gloskey{seealso} key is performed with:
+\cmddef{glsxtrindexseealso}
+which is analogous to \gls{glssee}. As with \gls{glssee}, this can
+also be used explicitly.
+
+With \app{makeindex}, \gls{glsxtrindexseealso} simply does:
+\begin{codebox*}
+\gls{glssee}\oarg{\gls{seealsoname}}\margm{entry-label}\margm{xr-list}
+\end{codebox*}
+With \app{xindy}, \gls{glsxtrindexseealso} behaves in an analogous
+way, using the appropriate cross-referencing markup.
+
+\cmddef{glsxtrsetaliasnoindex}
+This hook is used within the \idx{glslike} and \idx{glstextlike}
+commands to automatically switch off the \idx{indexing} for aliases.
+(The hook is performed after the options set by
+\gls{GlsXtrSetDefaultGlsOpts}.)
+
+By default, this hook just sets \glsoptval{noindex}{true}. If you would
+like to add \locations\ to the aliased \idx{locationlist} then you
+can redefine it to use:
+\cmddef{glsxtrindexaliased}
+For example:
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{glsxtrsetaliasnoindex}}\marg{\gls{glsxtrindexaliased}}
+\end{codebox}
+Note that this needs \glsoptval{noindex}{false} to ensure the
+\idx{indexing} takes place so don't simply append \gls{glsxtrindexaliased}
+to the definition of \gls{glsxtrsetaliasnoindex}.
+
+\begin{information}
+Don't use the above hooks with \app{bib2gls} as this function is
+disabled with \opteqvalref{record}{only} and
+\opteqvalref{record}{nameref}. Use the \resourceopt{alias-loc} resource option instead.
+\end{information}
+
+\cmddef{glsxtraddallcrossrefs}
+This is used at the end of the document if
+\optval{indexcrossrefs}{true} to automatically index any
+cross-references (identified in the \gloskey{see}, \gloskey{seealso}
+and \gloskey{alias} fields).
+This command iterates over all entries in all glossaries and, if an entry has
+been marked as used, does:
+\cmddef{glsxtraddunusedxrefs}
+which indexes any labels identified in the cross-reference fields of the entry
+given by \meta{entry-label} that haven't been marked as used.
+
+This can be time consuming if there are a large number of
+entries defined. If this is the case, you may want to consider
+switching to \app{bib2gls} and use either
+\resourceoptvalm{selection}{recorded and deps and see} or
+\resourceoptvalm{selection}{recorded and deps and see not also}.
+
+There should be no need to use \gls{glsxtraddallcrossrefs} explicitly, but you
+may want to redefine it to only iterate over specific glossaries.
+The unused entries are indexed using the \encap{glsxtrunusedformat}
+format.
+
+\cmddef{glsxtrunusedformat}
+This ignores its argument (the \location) and just does \gls{unskip}.
-\item[\abbrstyledef{short-hyphen-long-hyphen}]
-This style (new to v1.17) is like
-\abbrstyle{long-hyphen-short-hyphen}, except that the short form
-is displayed first followed by the long form in parentheses. The full form is formatted using
-\begin{definition}[\DescribeMacro\glsxtrshorthyphenlong]
-\cs{glsxtrshorthyphenlong}\marg{label}\marg{short}\marg{long}\marg{insert}
-\end{definition}
-which behaves in an analogous way to \cs{glsxtrlonghyphenshort}.
-The \gloskey{name} is obtained from \cs{glsxtrshortlongname}.
+\section{First Use Flag}
+\label{sec:glsunset}
-\item[\abbrstyledef{short-hyphen-long-hyphen-desc}]
+Each entry has an associated \idx{firstuseflag} (a conditional or
+boolean variable), which determines whether or not the entry has
+been marked as \qt{used}. Unsetting this flag means that the entry
+is marked as used. Resetting the flag means that the entry is marked
+as unused.
+
+The \idx{glslike} commands (which are the principle method of
+referencing an entry) all mark the entry as used after the
+\idx{linktext} is displayed but before the \idx{postlinkhook} is
+used.
+
+The purpose of this is to allow for additional information that
+needs to be shown when a term first appears in a document. For
+example, an abbreviation may need to have its full form shown on the
+instance. However, there are some cases where that additional
+information may need to be shown again or where the literal first
+instance of the term may need to be in its terse form. For example,
+if the term is used in the front matter.
+
+If any \idx{glslike} commands (which are robust) are used in section
+headings or captions, they can end up in the table of contents or
+corresponding \qt{list of \ldots} (such as the list of figures).
+This can cause the \idx{firstuseflag} to be unset too soon. For
+these situations, use the commands described in
+\sectionref{sec:headtitle} instead.
+
+The base \sty{glossaries} package provides commands to explicitly
+unset or reset the \idx{firstuseflag} either locally (confined to
+the current scope) or globally. These commands are:
+\gls{glsunset} (global unset), \gls{glslocalunset} (local unset),
+\gls{glsreset} (global reset) and \gls{glslocalreset} (local reset).
+
+The \sty{glossaries-extra} package adds hooks to the above commands.
+These do nothing by default, but are modified by \gls{glsenableentrycount}
+and \gls{glsenableentryunitcount} to perform the count increment or
+reset (see \sectionref{sec:entrycount}).
+
+\cmddef{glsxtrpostunset}
+This hook is added to \gls{glsunset}.
+
+\cmddef{glsxtrpostlocalunset}
+This hook is added to \gls{glslocalunset}.
+
+\cmddef{glsxtrpostreset}
+This hook is added to \gls{glsreset}.
+
+\cmddef{glsxtrpostlocalreset}
+This hook is added to \gls{glslocalreset}.
+
+The base package also provides commands to unset or reset
+all entries or all entries within particular glossaries:
+\gls{glsunsetall} and \gls{glsresetall}. For example, if you don't
+want the \idx{firstuse} in the front matter, you can unset all
+entries at the start of the front matter and reset them at the start
+of the main matter.
+\begin{codebox}
+\cmd{frontmatter}\gls{glsunsetall}
+\ldots
+\cmd{mainmatter}\gls{glsresetall}
+\end{codebox}
+
+With \sty{glossaries-extra} you can unset a specific subset of
+entries.
+\cmddef{glslocalunseteach}
+Locally unsets each entry in the given comma-separated list of entry labels.
+\cmddef{glslocalreseteach}
+Locally resets each entry in the given comma-separated list of entry labels.
+
+You can test if an entry has been marked as used with \gls{ifglsused}
+(but take care if you are using \app{bib2gls} or the
+\optval{undefaction}{warn} option, see below).
+This command allows the entry display style to vary the
+\idx{linktext} according to whether or not the entry has been marked
+as used. However, it can't be used within the \idx{postlinkhook} as
+by that time, the \idx{firstuseflag} will have already been unset.
+
+\begin{information}
+See the \sty{glossaries} user manual for further details of the
+above commands.
+\end{information}
+
+For example, in the following document the \qt{html} entry is first
+used in the abstract, which shows both the long and the short form,
+but it would be helpful for the full form to be reshown in the main
+section about web pages. This is achieved by resetting the
+\idx{firstuseflag}.
+\begin{codebox}
+\gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}
+\cbeg{document}
+ \cbeg{abstract}
+ This abstract mentions \gls{gls}\marg{html}.
+ \cend{abstract}
+ Some casual reference to \gls{gls}\marg{html}.
+ \cmd{section}\marg{Web Pages}
+ \gls{glsreset}\marg{html}This section is all about \gls{gls}\marg{html}.
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample*[title={Resetting the first use flag (\cmd{glsreset})},
+ label={ex:glsreset},
+ description={Example document illustrating the use of \cmd{glsreset}}]
+{\cmd{usepackage}\marg{glossaries-extra}^^J%
+ \gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}
+}{%
+ \cbeg{abstract}^^J
+ This abstract mentions \gls{gls}\marg{html}.^^J
+ \cend{abstract}^^J
+ Some casual reference to \gls{gls}\marg{html}.^^J
+ \cmd{section}\marg{Web Pages}^^J
+ \gls{glsreset}\marg{html}%
+ This section is all about \gls{gls}\marg{html}.
+}
+\end{resultbox}
+In the above example, an alternative is to use \gls{glsxtrfull}
+where you particularly want the full form, but some abbreviation
+styles have a different expansion with the
+\idxc{inlinefullform}{inline} \gls{glsxtrfull} form compared with
+the \idx{firstuse} of \gls{gls}.
+
+The \sty{glossaries-extra} package provides the options
+\glsopt{preunset} and \glsopt{prereset}, which can be used to unset
+or reset the \idx{firstuseflag} before the \idx{linktext}.
+This means that in the above example, the line:
+\begin{codebox}
+ \gls{glsreset}\marg{html}This section is all about \gls{gls}\marg{html}.
+\end{codebox}
+can be replaced with:
+\begin{codebox}
+This section is all about \gls{gls}\oarg{\glsopt{prereset}}\marg{html}.
+\end{codebox}
+
+As mentioned above, the \idx{firstuseflag} is unset before the
+\idx{postlinkhook}, so \gls{ifglsused} isn't helpful in the
+\idx{postlinkhook}. Instead, you can use:
+\cmddef{glsxtrifwasfirstuse}
+This command is initialised by the \idx{glslike} commands according
+to the value of the \idx{firstuseflag} before the \idx{linktext}.
+It's also initialised by the \idx{glstextlike} commands: not
+according to the value of the \idx{firstuseflag} but according to
+whether or not the \idx{glstextlike} command emulates \idx{firstuse}.
+
+For example, \gls{gls} will define \gls{glsxtrifwasfirstuse} to do
+its first argument if the \idx{firstuseflag} indicates the entry
+hasn't yet been used, otherwise it will define
+\gls{glsxtrifwasfirstuse} to do its second argument. Whereas
+\gls{glsfirst} will always define \gls{glsxtrifwasfirstuse} to do
+its first argument (unless used with \glsopt{preunset}) and
+\gls{glstext} will always define \gls{glsxtrifwasfirstuse} to do its
+second argument (unless used with \glsopt{prereset}), regardless of
+the state of the \idx{firstuseflag}.
+
+The \glsopt{preunset} and \glsopt{prereset} options will
+additionally redefine \gls{glsxtrifwasfirstuse} to match the option.
+See \sectionref{sec:postlinkhook} for further details about the
+\idx{postlinkhook}.
+
+If you want to check if the calling command was both the
+\idx{firstuse} and it was a \idx{glslike} command, you can use:
+\gls{glsxtrifwasglslikeandfirstuse}.
+
+The unset function performed by the \idx{glslike} commands before
+the \idx{postlinkhook} uses the global \gls{glsunset} by default.
+If you want \gls{glslocalunset} instead, you can use the
+\glsopt{local} option (provided by the base \sty{glossaries}
+package) or \glsoptval{postunset}{local}. To prevent the
+\idx{firstuseflag} from being unset after the \idx{linktext}, use
+\glsoptval{postunset}{none}.
+
+\begin{codebox}
+\gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}
+\cbeg{document}
+\marg{\% local scope
+\gls{gls}\oarg{\glsopt{local}}\marg{html}. Used? \gls{ifglsused}\marg{html}\marg{Yes}\marg{No}.
+}\% end scope
+\codepar
+Used? \gls{ifglsused}\marg{html}\marg{Yes}\marg{No}.
+\codepar
+\gls{gls}\oarg{\glsoptval{postunset}{none}}\marg{html}. Used? \gls{ifglsused}\marg{html}\marg{Yes}\marg{No}.
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample*[title={Local unset},
+ label={ex:glslocalunset},
+ description={Example document illustrating locally unsetting the
+first use flag}]
+{\cmd{usepackage}\marg{glossaries-extra}^^J%
+ \gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}
+}{%
+\marg{\% local scope^^J
+\gls{gls}\oarg{local}\marg{html}.^^J
+Used? \gls{ifglsused}\marg{html}\marg{Yes}\marg{No}.^^J
+}\% end scope^^J
+\codepar
+Used? \gls{ifglsused}\marg{html}\marg{Yes}\marg{No}.
+\codepar
+\gls{gls}\oarg{postunset=none}\marg{html}.
+Used? \gls{ifglsused}\marg{html}\marg{Yes}\marg{No}.
+}
+\end{resultbox}
-New to version 1.17.
-This is similar to \abbrstyle{short-hyphen-long-hyphen} but the
-user supplies the description.
-The \gloskey{name} is obtained from \cs{glsxtrshortlongdescname}.
+If you are using the \optval{undefaction}{warn} option (which is
+automatically implemented by the \opt{record} option), the
+\idx{firstuseflag} is undefined and so is neither true nor false, in
+which case \gls{ifglsused} will trigger an error or warning and do neither.
+In this situation, you may need to use the following command
+instead.
-\item[\abbrstyledef{short-hyphen-postlong-hyphen}]
-This style (new to v1.17) is like
-\abbrstyle{long-hyphen-postshort-hyphen}, but the
-short form is displayed first followed by the long form in
-parentheses.
-On first use, \cs{gls}\marg{label}\oarg{insert} will do
-\begin{display}
-\cs{glsxtrshorthyphen}\marg{short}\marg{label}\marg{insert}\cs{glsxtrposthyphenlong}\marg{label}\meta{insert}
-\end{display}
-where
-\begin{definition}[\DescribeMacro\glsxtrposthyphenlong]
-\cs{glsxtrposthyphenlong}\marg{label}\meta{insert}
-\end{definition}
-is in the post-link hook. These commands behave in an analogous
-manner to those used with \abbrstyle{long-hyphen-postshort-hyphen}.
-The \gloskey{name} is obtained from \cs{glsxtrshortlongname}.
+\cmddef{GlsXtrIfUnusedOrUndefined}
+This does \meta{true} if the entry hasn't been defined or hasn't been marked as
+\glsdisp{firstuseflag}{used}, otherwise does \meta{true}. Note
+that this command will generate an error or warning (according to
+\opt{undefaction}) if the entry hasn't been defined, but will
+still do \meta{true}. This is more useful than \gls{ifglsused}
+with \app{bib2gls} where the entries are never defined on the
+first \LaTeX\ run.
+
+\subsection{Buffering Unsets}
+\label{sec:unsetbuffer}
+
+Sometimes commands like \gls{gls} are used in a context where
+changing a boolean variable can cause things to go wrong.
+The outer, middle and inner formatting (see \sectionref{sec:entryfmtmods})
+can be used to change the font for the \idx{linktext}, but it may be
+that the \idx{glslike} command occurs within a block of text that
+needs to be encapsulated by such a command.
+
+One example of this is using \idx{gls} in one of the commands
+provided with the \sty{soul} package. For example:
+\begin{codebox}
+\gls{ul}\marg{Some text about \gls{gls}\marg{html}.}
+\end{codebox}
+This causes the confusing error:
+\begin{transcript}
+Glossary entry `\marg{html}' has not been defined.
+\end{transcript}
+The simplest workaround is to put \code{\gls{gls}\marg{html}} inside the
+argument of \gls{mbox}. For example:
+\begin{codebox}
+\gls{ul}\marg{Some text about \gls{mbox}\marg{\gls{gls}\marg{html}}.}
+\end{codebox}
+This can work provided it's not the \idx{firstuse} of this entry.
+It if is, then unsetting the \idx{firstuseflag} causes a problem
+and results in the error:
+\begin{transcript}
+! Package soul Error: Reconstruction failed.
+\end{transcript}
+The \sty{glossaries-extra} package provides a way of temporarily
+switching off \gls{glsunset} so that it just makes a note of the
+entry's label but doesn't actually perform the change.
+\cmddef{GlsXtrStartUnsetBuffering}
+This starts the buffering. The unstarred version doesn't check for
+duplicates, so the internal list may end up with multiple
+occurrences of the same label. The starred version only adds a label
+to the internal list if it's not already in it.
+If you are using entry counting (see \sectionref{sec:entrycount})
+the unstarred version is preferable to ensure the entry count is
+correct.
\begin{important}
-Don't use \cs{gls} in the \meta{insert} part for commands
-like \cs{glsxtrfull}, \cs{glsxtrshort} or \cs{glsxtrlong}.
+Buffering only applies to the global \gls{glsunset} and does not
+affect the local \gls{glslocalunset}.
\end{important}
-The inline full display format used by commands like \cs{glsxtrfull}
-behaves differently to the first use of \cs{gls} with this style.
-It's better to use \cs{glsreset}\marg{label}\cs{gls}\marg{label}
-if you want to ensure the full format.
+The buffer can be locally cleared with:
+\cmddef{GlsXtrClearUnsetBuffer}
+This doesn't stop buffering. It will simply discard the labels that
+have been buffered so far.
-\item[\abbrstyledef{short-hyphen-postlong-hyphen-desc}]
+In order to restore the normal behaviour of \gls{glsunset}, the
+buffering must be stopped or discarded.
+\cmddef{GlsXtrStopUnsetBuffering}
+This stops the buffering, restores \gls{glsunset}, and unsets all
+the buffered labels. The starred form uses \gls{glslocalunset} to
+unset the buffered labels.
-New to version 1.17.
-This is similar to \abbrstyle{short-hyphen-postlong-hyphen} but the
-user supplies the description. The \gloskey{name} is obtained from
-\cs{glsxtrshortlongdescname}.
+Before you stop the unset buffering, you can iterate over the
+current buffer.
+\cmddef{GlsXtrForUnsetBufferedList}
+This iterates over the currently buffered list of entry labels and
+performs \code{\csfmt{\meta{handler-cs}}\margm{entry-label}} for each label,
+where \meta{cs} is a control sequence that takes a single argument.
+This is best used with the starred version of
+\gls{GlsXtrStartUnsetBuffering}[*] to avoid duplicates.
+
+\cmddef{GlsXtrDiscardUnsetBuffering}
+This discards the buffer and restores \gls{glsunset} to its normal
+behaviour.
+
+It's possible to locally unset entries before use (analogous to
+\glsoptval{preunset}{local}) if the entry has already been
+encountered in the buffer. This will still be problematic for
+situations where changing a conditional causes a problem, but may be
+useful in some situations. This feature is enabled with:
+\cmddef{GlsXtrUnsetBufferEnableRepeatLocal}
+This may be placed before or after \gls{GlsXtrStartUnsetBuffering}
+but the locally collected list of unused entries will be cleared at
+the start of each instance of \gls{GlsXtrStartUnsetBuffering}.
+It will also be cleared by \gls{GlsXtrClearUnsetBuffer}.
+All entries that have been marked as unused can be reset with:
+\cmddef{GlsXtrResetLocalBuffer}
+This will perform a local reset on all the entries in the \qt{not
+used} list and do \gls{GlsXtrClearUnsetBuffer}.
+
+This feature can be switched off with:
+\cmddef{GlsXtrUnsetBufferDisableRepeatLocal}
+It's disabled by default.
+
+The way this feature works is as follows (while buffering is active):
+\begin{enumerate}
+\item Each time an entry is referenced with a \idx{glslike} command,
+the \gls{glsinitreunsets} hook checks if the current entry
+(identified by \gls{glslabel}) has been added to the buffer.
+(Bear in mind that the label is added to the buffer after the
+\idx{linktext} when \gls{glsunset} is used.)
+
+ \begin{enumerate}
+ \item If it has been added to the buffer, then this is an indication
+ that the entry has already been used within the buffer zone (that is,
+ an attempt has been made to globally unset the \idx{firstuseflag}).
+ A local unset is then performed, which is essentially equivalent to using the
+ \glsoptval{preunset}{local} option, so the reference will behave
+ like \idx{subsequentuse}.
+
+ \item If it hasn't been added to the buffer, then this is an
+ indication that the entry hasn't already been used within the
+ buffer zone, but it may or may not have been used before the
+ buffering started. If the \idx{firstuseflag} indicates that the
+ entry hasn't been used, the entry's label will be added to the
+ \qt{not used} list. The reference will behave like \idx{firstuse},
+ but the unset won't be performed afterwards (because buffering is
+ in progress).
+ \end{enumerate}
+
+\item The entries that are in the \qt{not used} list can be locally
+reset and both the buffer and the \qt{not used} list can be cleared
+with \gls{GlsXtrClearUnsetBuffer}.
+\end{enumerate}
+Note that this approach can't be used for situations where the
+change in conditional causes a problem, but it can be used in
+situations where the content of an environment or command is
+repeatedly processed, which upsets the \idx{firstuseflag}.
+
+For example, consider the following \cls{beamer} document:
+\begin{codebox}
+\cmd{documentclass}\marg{beamer}
+\cmd{usepackage}\marg{glossaries-extra}
+\gls{newabbreviation}\marg{svm}\marg{SVM}\marg{support vector machine}
+\gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}
+\cbeg{document}
+\cbeg{frame}
+ \cmd{frametitle}\marg{Frame 1}
+ \cbeg{itemize}
+ \cmd{item} \gls{gls}\marg{html} and \gls{gls}\marg{html}
+ \cend{itemize}
+\cend{frame}
+\cbeg{frame}
+ \cmd{frametitle}\marg{Frame 2}
+ \cbeg{itemize}
+ \cmd{item}<+-> \gls{gls}\marg{svm} and \gls{gls}\marg{svm}
+ \cmd{item}<+-> \gls{gls}\marg{svm} and \gls{gls}\marg{html}
+ \cend{itemize}
+\cend{frame}
+\cmd{frame}\marg{\gls{printunsrtglossaries}}
+\cend{document}
+\end{codebox}
+The first page isn't a problem as the frame doesn't have overlays.
+The first reference of the \qt{html} entry shows the full form
+and the next shows just the short form. The second page
+(which is the first of the overlays of the second frame) correctly
+shows the full form of the \qt{svm} entry for the first reference and
+the short form for the second reference, but on the third page
+(the second of the overlays) now has all instances of \qt{svm} showing as
+\idx{subsequentuse} (just the short form).
+
+I could put \gls{glslocalresetall} at the start of the frame, but
+that would reset the \qt{html} entry as well. Another workaround is
+to locally reset the first \qt{svm} entry with
+\glsopt{prereset}{local}, but that defeats the point of the
+\idx{firstuseflag}, which is intended to keep track of whether or
+not you have used an entry so that you don't have to.
+
+The frame can be placed inside a buffering zone:
+\begin{codebox}
+\gls{GlsXtrStartUnsetBuffering}
+\cbeg{frame}
+ \cmd{frametitle}\marg{Frame 2}
+ \cbeg{itemize}
+ \cmd{item}<+-> \gls{gls}\marg{svm} and \gls{gls}\marg{svm}
+ \cmd{item}<+-> \gls{gls}\marg{svm} and \gls{gls}\marg{html}
+ \cend{itemize}
+\cend{frame}
+\gls{GlsXtrStopUnsetBuffering}
+\end{codebox}
+This ensures that the \idx{firstuseflag} isn't reset until after the
+frame, but it means that all references to the \qt{svm} entry on
+both the second and third page show the full form.
+
+The \qt{repeat local} function can be used so that repeated
+references for the same entry can be locally unset before use.
+This can be enabled with \gls{GlsXtrUnsetBufferEnableRepeatLocal}
+which fixes the second page, but not the third page, which shows all
+references to \qt{svm} as the short form. What's needed is to
+locally reset and entries that are in the frame but haven't yet been
+used (\qt{svm}, in this case) at the start of the frame with
+\gls{GlsXtrResetLocalBuffer}:
+\begin{codebox}
+\gls{GlsXtrStartUnsetBuffering}
+\gls{GlsXtrUnsetBufferEnableRepeatLocal}
+\cbeg{frame}
+\gls{GlsXtrResetLocalBuffer}
+ \cmd{frametitle}\marg{Frame 2}
+ \cbeg{itemize}
+ \cmd{item}<+-> \gls{gls}\marg{svm} and \gls{gls}\marg{svm}
+ \cmd{item}<+-> \gls{gls}\marg{svm} and \gls{gls}\marg{html}
+ \cend{itemize}
+\cend{frame}
+\gls{GlsXtrStopUnsetBuffering}
+\end{codebox}
+Note that on the first overlay, the buffer and \qt{not used} list
+are both empty. On the second overlay, the buffer contains the
+\qt{svm} and \qt{html} labels and the \qt{not used} list just contains
+the \qt{svm} label. The reset performed by \gls{GlsXtrResetLocalBuffer}
+will reset \qt{svm} and then clear both the buffer and the \qt{not
+used} list. This means that the first \qt{svm} reference is once
+again considered \idx{firstuse} and it will once again be added to
+the \qt{not used} list (so that it would be reset again if there was
+a third overlay).
+\begin{resultbox}
+\createexample*
+ [arara={pdflatex,pdflatex},class={beamer},pages={1,2,3,4},
+ label={ex:unsetbeamer},
+ title={Abbreviations with \clsfmt{beamer} (unset buffering)},
+ description={An example document that uses beamer with buffering}
+ ]
+{\cmd{usepackage}\marg{glossaries-extra}^^J%
+\gls{newabbreviation}\marg{svm}\marg{SVM}\marg{support vector machine}^^J%
+\gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}
+}%
+{%
+\cbeg{frame}^^J
+ \cmd{frametitle}\marg{Frame 1}^^J
+ \cbeg{itemize}^^J
+ \cmd{item} \gls{gls}\marg{html} and \gls{gls}\marg{html}^^J
+ \cend{itemize}^^J
+\cend{frame}^^J%
+\gls{GlsXtrStartUnsetBuffering}^^J%
+\gls{GlsXtrUnsetBufferEnableRepeatLocal}^^J%
+\cbeg{frame}^^J%
+\gls{GlsXtrResetLocalBuffer}^^J
+ \cmd{frametitle}\marg{Frame 2}^^J
+ \cbeg{itemize}^^J
+ \cmd{item}<+-> \gls{gls}\marg{svm} and \gls{gls}\marg{svm}^^J
+ \cmd{item}<+-> \gls{gls}\marg{svm} and \gls{gls}\marg{html}^^J
+ \cend{itemize}^^J%
+\cend{frame}^^J%
+\gls{GlsXtrStopUnsetBuffering}^^J%
+\cmd{frame}\marg{\gls{printunsrtglossaries}}
+}
+\end{resultbox}
+This is quite cumbersome, but these commands could potentially be added to
+hooks at the start and end of problematic environments (but the
+buffering needs to be started and ended outside of the repeated
+content).
+
+The following example uses \gls{mbox} to protect \gls{gls} within
+the buffer zone:
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\codepar
+\cmd{usepackage}[T1]\marg{fontenc}
+\cmd{usepackage}\marg{soul}
+\cmd{usepackage}\marg{glossaries-extra}
+\codepar
+\gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}
+\codepar
+\cbeg{document}
+\gls{GlsXtrStartUnsetBuffering}
+\gls{ul}\marg{Some text about \gls{mbox}\marg{\gls{gls}\marg{html}}.
+Next use: \gls{mbox}\marg{\gls{gls}\marg{html}}.}
+\gls{GlsXtrStopUnsetBuffering}
+\codepar
+Next use: \gls{gls}\marg{html}.
+\cend{document}
+\end{codebox}
+This produces:
+\begin{resultbox}
+\createexample*[title={Buffering first use unsets with \cmd{mbox}},
+ label={ex:bufferingmbox},
+ description={Example document that uses buffering to defer
+unsetting the first use flag unset in problematic contexts. The use
+of box creates an overly long line}]
+{%
+\cmd{usepackage}[T1]\marg{fontenc}^^J%
+\cmd{usepackage}\marg{soul}^^J%
+\cmd{usepackage}\marg{glossaries-extra}^^J%
+\codepar
+\gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}
+}
+{\gls{GlsXtrStartUnsetBuffering}^^J%
+\gls{ul}\marg{Some text about \gls{mbox}\marg{\gls{gls}\marg{html}}.^^J%
+Next use: \gls{mbox}\marg{\gls{gls}\marg{html}}.}^^J%
+\gls{GlsXtrStopUnsetBuffering}^^J%
+\codepar
+Next use: \gls{gls}\marg{html}.
+}
+\end{resultbox}
+Note that the use of \gls{mbox} prevents line-breaking and the
+second instance of \code{\gls{gls}\marg{html}} is treated as
+\idx{firstuse}.
+
+\begin{warning}
+Note that since the change in the \idx{firstuseflag} now doesn't
+occur until \gls{GlsXtrStopUnsetBuffering}, multiple references
+of the same term within the buffering zone will always be
+treated as \idx{firstuse} (if the term wasn't used before the
+buffering started).
+\end{warning}
-\end{description}
+Other alternatives include using \gls{protect} and inner formatting
+(see \sectionref{sec:innertextformat} for limitations) or middle
+formatting (see \sectionref{sec:middleformat}) with
+\gls{GlsXtrExpandedFmt} (which can't be used with fragile
+\idx{linktext}). Both approaches are demonstrated in the following
+example:
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\codepar
+\cmd{usepackage}[T1]\marg{fontenc}
+\cmd{usepackage}\marg{soul}
+\cmd{usepackage}\marg{glossaries-extra}
+\codepar
+\gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}
+\comment{custom command to expand content before using \gls{ul}:}
+\cmd{newrobustcmd}\marg{\cmd{xpul}}[1]\marg{\gls{GlsXtrExpandedFmt}\marg{\gls{ul}}\marg{\#1}}
+\codepar
+\cbeg{document}
+First approach (inner formatting):
+\marg{\% scope
+ \cmd{renewcommand}\marg{\gls{glsxtrdefaultentrytextfmt}}[1]\marg{\gls{ul}\marg{\#1}}\%
+ \gls{ul}\marg{Some text about \gls{protect}\gls{gls}\marg{html}.
+ Next use: \gls{protect}\gls{gls}\marg{html}}
+}
+\codepar
+Next use: \gls{gls}\marg{html}.
+\codepar
+Second approach (middle formatting with expanded link text):
+\gls{glsresetall}
+\marg{\% scope
+ \cmd{renewcommand}\marg{\gls{glsxtrabbreviationfont}}[1]\marg{\cmd{xpul}\marg{\#1}}\%
+ \cmd{renewcommand}\marg{\gls{glsxtrregularfont}}[1]\marg{\cmd{xpul}\marg{\#1}}\%
+ \gls{ul}\marg{Some text about \gls{protect}\gls{gls}\marg{html}.
+ Next use: \gls{gls}\marg{html}.}
+}
+\codepar
+Next use: \gls{gls}\marg{html}.
+\cend{document}
+\end{codebox}
+This produces:
+\begin{resultbox}
+\createexample*[label={ex:protectinnertextformat},
+title={Alternatives to buffering},
+description={Example document illustrating inner and middle
+formatting alternatives to unset
+buffering where entries are referenced within sensitive formatting
+commands}]
+{%
+ \cmd{usepackage}[T1]\marg{fontenc}^^J%
+ \cmd{usepackage}\marg{soul}^^J%
+ \cmd{usepackage}\marg{glossaries-extra}^^J%
+ \codepar
+ \gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}^^J%
+ \% custom command to expand content before using \gls{ul}:^^J
+ \cmd{newrobustcmd}\marg{\cmd{xpul}}[1]\marg{\gls{GlsXtrExpandedFmt}\marg{\gls{ul}}\marg{\#1}}
+ \codepar
+}
+{%
+First approach (inner formatting):^^J%
+\marg{\% scope^^J
+ \cmd{renewcommand}\marg{\gls{glsxtrdefaultentrytextfmt}}[1]\marg{\gls{ul}\marg{\#1}}\%^^J
+ \gls{ul}\marg{Some text about \gls{protect}\gls{gls}\marg{html}.^^J
+ Next use: \gls{protect}\gls{gls}\marg{html}}^^J%
+}^^J%
+\codepar
+Next use: \gls{gls}\marg{html}.^^J%
+\codepar
+Second approach (middle formatting with expanded link text):^^J%
+\gls{glsresetall}^^J%
+\marg{\% scope^^J
+ \cmd{renewcommand}\marg{\gls{glsxtrabbreviationfont}}[1]\marg{\cmd{xpul}\marg{\#1}}\%^^J
+ \cmd{renewcommand}\marg{\gls{glsxtrregularfont}}[1]\marg{\cmd{xpul}\marg{\#1}}\%^^J
+ \gls{ul}\marg{Some text about \gls{protect}\gls{gls}\marg{html}.
+ Next use: \gls{gls}\marg{html}.}^^J%
+}
+\codepar
+Next use: \gls{gls}\marg{html}.
+}
+\end{resultbox}
+
+The change in the \idx{firstuseflag} isn't the only content within
+the \idx{glslike} commands that can cause a problem. The
+\idx{whatsit} caused by \idx{indexing} can also be problematic.
+Buffering can also be used to help with that situation. Indexing can
+be switched off at the start of the buffering and
+\gls{GlsXtrForUnsetBufferedList} can be used to perform the indexing
+outside of the problematic content. Note that this can cause a
+problem if the \location\ changes (for example, if a page break occurs
+within the buffering zone).
+
+Buffering can also be used to simply gather the labels that have
+been referenced with a \idx{glslike} command in order to, for
+example, display a \idx{mini-glossary} at the end of the block. See for
+example, \gallerypage{minigloss}{Gallery: Mini-Glossary}.
+
+\section{Accessing Fields}
+\label{sec:getfields}
+
+See \sectionref{sec:setfields} for setting fields after an entry has
+been defined, \sectionref{sec:csvfields} for fields that contain
+comma-separated lists or whose values may be contained within comma-separated lists,
+\sectionref{sec:getsee} for cross-referencing fields (\gloskey{see},
+\gloskey{seealso} and \gloskey{alias}),
+and \sectionref{sec:fieldconditionals} for testing
+field values. See also the base \sty{glossaries} package's commands,
+such as \gls{glsentryname} and \gls{glsletentryfield}.
+
+\cmddef{glsxtrusefield}
+This expands to the value of the \idx{field}
+(identified by its \idxc{internalfieldlabel}{internal label}
+\meta{field-label}) for the entry identified by \meta{entry-label}.
+Expands to \gls{relax} if the \idx{field} or entry are undefined.
+
+\cmddef{Glsxtrusefield}
+This is like \gls{glsxtrusefield} but converts the first character
+to \idx{uppercase} using \gls{makefirstuc} (provided by
+\sty{mfirstuc}) which is robust. If \sty{hyperref} is loaded,
+\code{\gls{Glsxtrusefield}\margm{entry-label}} will use the expandable:
+\begin{compactcodebox}
+\gls{MFUsentencecase}\marg{\gls{glsxtrusefield}\margm{entry-label}}
+\end{compactcodebox}
+in a PDF bookmark.
+
+\cmddef{GLSxtrusefield}
+This is like \gls{glsxtrusefield} but converts the field value to
+\idx{uppercase}. See \sectionref{sec:uppercase}.
+
+\cmddef{glsxtrfieldtitlecase}
+This is like \gls{glsxtrusefield} but converts the field value to
+\idx{titlecase}. This internally uses:
+\cmddef{glsxtrfieldtitlecasecs}
+This converts \meta{content} to \idx{titlecase} (expanding the first
+token once). If \gls{glscapitalisewords} has been defined, that will
+be used, otherwise \gls{capitalisewords} will be used.
+
+\cmddef{glsxtrentryparentname}
+Expands to the entry's parent \gloskey{name} if defined. Expands to
+nothing if the entry doesn't have a parent or if the entry isn't
+defined. If you simply require the parent label then use
+\gls{glsentryparent} or, to first test if the entry has a parent,
+either use \gls{ifglshasparent} or use \gls{glsxtrifhasfield} with
+the field label set to \code{parent}.
+
+\cmddef{glsxtrhiername}
+Displays the hierarchical name for the given entry. The
+cross-reference format \gls{glsseeitemformat} may be redefined to
+use this command to show the hierarchy, if required.
+
+This command has a recursive definition. If the entry given by
+\meta{entry-label} has a parent, then this command will do
+\code{\gls{glsxtrhiername}\margm{parent-label}} for the entry's parent and
+will then do the separator \gls{glsxtrhiernamesep}.
+
+Then, regardless of whether or not the entry has a parent, it will
+do \code{\gls{glsfmttext}\margm{entry-label}}, if the entry is an
+abbreviation (see \sectionref{sec:examplediffsabbrv}), or
+\code{\gls{glsfmtname}\margm{entry-label}} otherwise.
+
+\begin{information}
+If \sty{hyperref} is loaded, \gls{glsxtrhiername} will
+behave as \gls{glsentryname} in a PDF bookmark.
+\end{information}
+
+\cmddef{glsxtrhiernamesep}
+Separator symbol (\glsxtrhiernamesep) used between each name in
+commands like \gls{glsxtrhiername}.
+
+\cmddef{Glsxtrhiername}
+As \gls{glsxtrhiername} but the first name in the list has its first character
+converted to \idx{uppercase} using \gls{Glsfmttext} or
+\gls{Glsfmtname} (\idx{sentencecase}).
+If \sty{hyperref} is loaded, \gls{Glsxtrhiername} will expand to:
+\begin{compactcodebox}
+\gls{MFUsentencecase}\marg{\gls{glsentryname}\margm{entry-label}}
+\end{compactcodebox}
+in a PDF bookmark. The \gls{makefirstuc} mapping from
+\gls{glsxtrhiername} to \gls{Glsxtrhiername} is set with
+\gls{glsmfuaddmap}, if supported.
+
+\cmddef{GlsXtrhiername}
+As \gls{glsxtrhiername} but each name in the list has its first character
+converted to \idx{uppercase} using \gls{Glsfmttext} or \gls{Glsfmtname}.
+
+\cmddef{GLSxtrhiername}
+As \gls{glsxtrhiername} but the first name in the list is
+converted to \idx{uppercase} using \gls{GLSfmttext} or
+\gls{GLSfmtname}.
+
+\cmddef{GLSXTRhiername}
+As \gls{glsxtrhiername} but each name in the list is
+converted to \idx{uppercase} using \gls{GLSfmttext} or
+\gls{GLSfmtname} (\idx{allcaps}).
+
+\section{Encapsulation (Formatting) Based on Field Values}
+
+These commands assume that a given entry has a special purpose field
+that's used to store information on how to format text.
+
+\subsection{Foreign Language Field}
+\label{sec:foreignfield}
+
+\cmddef{GlsXtrForeignTextField}
+This command should expand to the \idx{internalfieldlabel} used to store a
+language tag (such as \code{en-GB} or \code{de-CH-1996}). The
+default value is \code{userii} (which corresponds to the
+\gloskey{user2} key).
+
+\cmddef{GlsXtrForeignText}
+If the entry given by \meta{entry-label} has the field identified by
+\gls{GlsXtrForeignTextField} set, then this command will encapsulate
+\meta{text} according to the language tag stored in that field.
+
+This uses \sty{tracklang}['s] interface to determine the language
+label that corresponds to the language tag. If the language label
+can be determined, the \meta{text} will be encapsulated with
+\gls{foreignlanguage} otherwise just \meta{text} is done.
+
+If \gls{foreignlanguage} isn't defined (that is, there's no language
+support for the document), this command simply does \meta{text}. If
+an old version of \sty{tracklang} is used, this command issues a
+warning and just does \meta{text}.
+
+If \sty{tracklang} can't determine the corresponding language label
+to use with \gls{foreignlanguage}, then a warning is issued with:
+\cmddef{GlsXtrUnknownDialectWarning}
+where \meta{locale} is the language tag supplied in the given field
+value and \meta{root language} is the root language that
+\sty{tracklang} has inferred from the tag.
+
+\begin{information}
+\gls{GlsXtrForeignText} requires \sty{tracklang} v1.3.6+.
+\end{information}
-\section{Defining New Abbreviation Styles}
-\label{sec:newabbrvstyle}
+For example:
+\begin{codebox}
+\cmd{usepackage}[main=british,brazilian,ngerman]\marg{babel}
+\cmd{usepackage}\marg{glossaries-extra}
+\gls{setabbreviationstyle}\marg{\abbrstyle{long-short-user}}
+\gls{newabbreviation}
+ \oarg{\gloskeyval{user1}{Associa\c{c}\~ao Brasileria de Normas T\'ecnicas},
+ \gloskeyval{user2}{pt-BR}
+ }
+ \marg{abnt}\marg{ABNT}\marg{Brazilian National Standards Organization}
+\codepar
+\gls{newabbreviation}
+ \oarg{\gloskeyval{user1}{Deutsches Institut f\"ur Normung e.V.},
+ \gloskeyval{user2}{de-DE-1996}}
+ \marg{din}\marg{DIN}\marg{German Institute for Standardization}
+\codepar
+\gls{newabbreviation}\marg{tug}\marg{TUG}\marg{\cmd{TeX}\cmd{ }User Group}
+\codepar
+\cmd{renewcommand}*\marg{\gls{glsxtruserparen}}[2]\marg{\%
+ \gls{glsxtrfullsep}\marg{\#2}\%
+ \gls{glsxtrparen}
+ \marg{\#1\%
+ \gls{ifglshasfield}\marg{\gls{glsxtruserfield}}\marg{\#2}\%
+ \marg{, \cmd{emph}\marg{\gls{GlsXtrForeignText}\marg{\#2}\marg{\gls{glscurrentfieldvalue}}}}\%
+ \marg{}\%
+ }\%
+}
+\codepar
+\cbeg{document}
+\gls{gls}\marg{abnt}, \gls{gls}\marg{din}, \gls{gls}\marg{tug}.
+\gls{printunsrtglossaries}
+\cend{document}
+\end{codebox}
+This produces:
+\begin{resultbox}
+\createexample*[title={Foreign language field encapsulation},
+ label={ex:foreignlangfmt},
+ description={Example document illustrating fields containing
+different languages that need encapsulating with the relevant
+language command}]
+{%
+\cmd{usepackage}[main=british,brazilian,ngerman]\marg{babel}^^J%
+\cmd{usepackage}\marg{glossaries-extra}^^J%
+\gls{setabbreviationstyle}\marg{long-short-user}^^J%
+\gls{newabbreviation}^^J%
+ \oarg{\gloskeyval{user1}{Associa\c{c}\~ao Brasileria de Normas T\'ecnicas},^^J%
+ \gloskeyval{user2}{pt-BR}^^J%
+ }^^J%
+ \marg{abnt}\marg{ABNT}\marg{Brazilian National Standards Organization}^^J%
+\codepar
+\gls{newabbreviation}^^J%
+ \oarg{\gloskeyval{user1}{Deutsches Institut f\"ur Normung e.V.},^^J%
+ \gloskeyval{user2}{de-DE-1996}}^^J%
+ \marg{din}\marg{DIN}\marg{German Institute for Standardization}^^J%
+\codepar
+\gls{newabbreviation}\marg{tug}\marg{TUG}\marg{\cmd{TeX}\cmd{ }User Group}^^J%
+\codepar
+\cmd{renewcommand}*\marg{\gls{glsxtruserparen}}[2]\marg{\%^^J%
+ \gls{glsxtrfullsep}\marg{\#2}\%^^J%
+ \gls{glsxtrparen}^^J%
+ \marg{\#1\%^^J%
+ \gls{ifglshasfield}\marg{\gls{glsxtruserfield}}\marg{\#2}\%^^J%
+ \marg{, \cmd{emph}\marg{\gls{GlsXtrForeignText}\marg{\#2}\marg{\gls{glscurrentfieldvalue}}}}\%^^J%
+ \marg{}\%^^J%
+ }\%^^J%
+}
+}
+{
+\gls{gls}\marg{abnt}, \gls{gls}\marg{din}, \gls{gls}\marg{tug}.^^J%
+\gls{printunsrtglossaries}
+}
+\end{resultbox}
+
+\subsection{Associated Entry Format}
+\label{sec:glsxtrfmt}
+
+An entry may have a particular formatting style associated with it
+(rather than a more general category-wide format). This needs to be
+provided by a text-block command that takes a single argument. The
+name (without the leading backslash) should be stored in the field
+identified by:
+\cmddef{GlsXtrFmtField}
+This command should expand to the \idx{internalfieldlabel} used to
+store the formatting command's control sequence name. The default
+value is \code{useri} (which corresponds to the \gloskey{user1} key).
+
+\cmddef{glsxtrfmt}
+This command behaves like:
+\begin{compactcodebox}
+\gls{glslink}\oargm{options}\margm{entry-label}\marg{\meta{fmt-link-text}}
+\end{compactcodebox}
+where the \idx{linktext} \meta{fmt-link-text} is formatted according to:
+\cmddef{glsxtrfmtdisplay}
+The default definition simply does \code{\cmd{\meta{csname}}\margm{text}\meta{insert}}
+where the control sequence name \meta{csname} is obtained from the
+field given by \gls{GlsXtrFmtField}. If the field hasn't been set,
+\gls{@firstofone} is used (which simply does its argument).
+The unstarred version assumes an empty \meta{insert}.
+The default \gls{glslink} options are given by \gls{GlsXtrFmtDefaultOptions}.
+
+\begin{information}
+The \idx{postlinkhook} is suppressed with \gls{glsxtrfmt}.
+\end{information}
+
+If you don't want the complexity of \gls{glslink}, a partially
+expandable command is provided that may be used in section headings:
+\cmddef{glsxtrentryfmt}
+If \sty{hyperref} has been loaded, this will expand to:
+\cmddef{glsxtrpdfentryfmt}
+within the PDF bookmarks, which just does \meta{text}. Otherwise
+\gls{glsxtrentryfmt} will format \meta{text} according to the
+control sequence name identified in the field given by \gls{GlsXtrFmtField} (or
+\code{@firstofone}, if not set).
+For example:
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\cmd{usepackage}[T1]\marg{fontenc}
+\cmd{usepackage}\marg{amsmath}
+\cmd{usepackage}[colorlinks]\marg{hyperref}
+\cmd{usepackage}[\opt{postdot},\optval{style}{\glostyle{index}}]\marg{glossaries-extra}
+\gls{makeglossaries}
+\cmd{newcommand}*\marg{\cmd{mtx}}[1]\marg{\cmd{boldsymbol}\marg{\#1}}
+\cmd{newcommand}*\marg{\cmd{mtxinv}}[1]\marg{\cmd{mtx}\marg{\#1}\cmd{sp}\marg{-1}}
+\codepar
+\gls{newglossaryentry}\marg{matrix}\marg{\%
+ \gloskeyval{name}{matrix},
+ \gloskeyval{symbol}{\cmd{ensuremath}\marg{\cmd{mtx}\marg{M}}},
+ \gloskeyval{plural}{matrices},
+ \gloskeyval{user1}{mtx},\comment{corresponds to \cmd{mtx}}
+ \gloskeyval{description}{rectangular array of values}
+}
+\codepar
+\gls{newglossaryentry}\marg{identitymatrix}\marg{\%
+ \gloskeyval{name}{identity matrix},
+ \gloskeyval{symbol}{\cmd{ensuremath}\marg{\cmd{mtx}\marg{I}}},
+ \gloskeyval{plural}{identity matrices},
+ \gloskeyval{description}{a diagonal matrix with all diagonal
+ elements equal to 1 and all other elements equal to 0}
+}
+\codepar
+\gls{newglossaryentry}\marg{matrixinv}\marg{\%
+ \gloskeyval{name}{matrix inverse},
+ \gloskeyval{symbol}{\cmd{ensuremath}\marg{\cmd{mtxinv}\marg{M}}},
+ \gloskeyval{user1}{mtxinv},\comment{corresponds to \cmd{mtxinv}}
+ \gloskeyval{description}{a square \gls{gls}\marg{matrix} such that
+ \$\cmd{mtx}\marg{M}\cmd{mtxinv}\marg{M}=\gls{glssymbol}\marg{identitymatrix}\$}
+}
+\cbeg{document}
+A \gls{gls}\marg{matrix} is denoted \gls{glssymbol}\marg{matrix}.
+The inverse is denoted \gls{glssymbol}\marg{matrixinv}.
+\cmd{[}
+ \gls{glsxtrfmt}\marg{matrix}\marg{A} \gls{glsxtrfmt}\marg{matrixinv}\marg{A}
+ = \gls{glssymbol}\marg{identitymatrix}
+\cmd{]}
+Compare \$\gls{glsxtrfmt}\marg{matrix}\marg{A}[\_0]\$
+with \$\gls{glsxtrfmt*}\marg{matrix}\marg{A}[\_0]\$.
+\cmd{printglossaries}
+\cend{document}
+\end{codebox}
+This produces:
+\begin{resultbox}
+\createexample*[title={Storing a formatting command in a field},
+ label={ex:glsxtrfmt},
+description={Example document that uses a field to store the
+formatting command associated with the glossary entry},
+arara={pdflatex,makeglossaries,pdflatex,pdfcrop}]
+{%
+\cmd{usepackage}[T1]\marg{fontenc}^^J%
+\cmd{usepackage}\marg{amsmath}^^J%
+\cmd{usepackage}[colorlinks]\marg{hyperref}^^J%
+\cmd{usepackage}[postdot,style=index]\marg{glossaries-extra}^^J%
+\codepar
+\gls{makeglossaries}^^J%
+\codepar
+\cmd{newcommand}*\marg{\cmd{mtx}}[1]\marg{\cmd{boldsymbol}\marg{\#1}}^^J%
+\cmd{newcommand}*\marg{\cmd{mtxinv}}[1]\marg{\cmd{mtx}\marg{\#1}\cmd{sp}\marg{-1}}^^J%
+\codepar
+\gls{newglossaryentry}\marg{matrix}\marg{\%^^J%
+ \gloskeyval{name}{matrix},^^J%
+ \gloskeyval{symbol}{\cmd{ensuremath}\marg{\cmd{mtx}\marg{M}}},^^J%
+ \gloskeyval{plural}{matrices},^^J%
+ \gloskeyval{user1}{mtx},^^J%
+ \gloskeyval{description}{rectangular array of values}^^J%
+}^^J%
+\codepar
+\gls{newglossaryentry}\marg{identitymatrix}\marg{\%^^J%
+ \gloskeyval{name}{identity matrix},^^J%
+ \gloskeyval{symbol}{\cmd{ensuremath}\marg{\cmd{mtx}\marg{I}}},^^J%
+ \gloskeyval{plural}{identity matrices},^^J%
+ \gloskeyval{description}{a diagonal matrix with all diagonal
+elements equal to^^J%
+ 1 and all other elements equal to 0}^^J%
+}
+\codepar
+\gls{newglossaryentry}\marg{matrixinv}\marg{\%^^J%
+ \gloskeyval{name}{matrix inverse},^^J%
+ \gloskeyval{symbol}{\cmd{ensuremath}\marg{\cmd{mtxinv}\marg{M}}},^^J%
+ \gloskeyval{user1}{mtxinv},^^J%
+ \gloskeyval{description}{a square \gls{gls}\marg{matrix} such
+that^^J%
+ \string$\cmd{mtx}\marg{M}\cmd{mtxinv}\marg{M}=\gls{glssymbol}\marg{identitymatrix}\string$}^^J%
+}^^J%
+}
+{%
+A \gls{gls}\marg{matrix} is denoted \gls{glssymbol}\marg{matrix}.^^J%
+The inverse is denoted \gls{glssymbol}\marg{matrixinv}.^^J%
+\cmd{[}^^J%
+ \gls{glsxtrfmt}\marg{matrix}\marg{A}^^J%
+ \gls{glsxtrfmt}\marg{matrixinv}\marg{A}^^J%
+ =^^J%
+ \gls{glssymbol}\marg{identitymatrix}^^J%
+\cmd{]}^^J%
+Compare \string$\gls{glsxtrfmt}\marg{matrix}\marg{A}[\string_0]\string$^^J%
+with \string$\gls{glsxtrfmt*}\marg{matrix}\marg{A}[\string_0]\string$.
+\cmd{printglossaries}
+}
+\end{resultbox}
+Note the difference between using \gls{glsxtrfmt*} vs \gls{glsxtrfmt}.
+
+There are also \idx{sentencecase} versions of the above commands:
+\cmddef{Glsxtrfmt}
+This is simply a shortcut for:
+\begin{compactcodebox}
+\gls{glsxtrfmt}\oargm{options}\margm{entry-label}\marg{\gls{glssentencecase}\margm{text}}
+\end{compactcodebox}
+Similarly for the starred form:
+\cmddef{Glsxtrfmt*}
+which is a shortcut for:
+\begin{compactcodebox}
+\gls{glsxtrfmt*}\oargm{options}\margm{entry-label}\marg{\gls{glssentencecase}\margm{text}}\oargm{insert}
+\end{compactcodebox}
+
+\cmddef{Glsxtrentryfmt}
+This is a shortcut for
+\begin{compactcodebox}
+\gls{glsxtrentryfmt}\margm{entry-label}\marg{\gls{glssentencecase}\margm{text}}
+\end{compactcodebox}
+but uses:
+\cmddef{Glsxtrpdfentryfmt}
+for the PDF bookmarks. This uses \gls{MFUsentencecase} to perform
+the case-change, which is expandable.
+
+If you are writing \gls{glsxtrfmt} or \gls{glsxtrentryfmt}
+explicitly in the document text, you can, of course, enter the
+appropriate case in \meta{text} directly. The purpose of providing
+the \idx{sentencecase} commands is to enable a mapping to be setup
+with \gls{MFUaddmap} in the event that \gls{glsxtrfmt} or
+\gls{glsxtrentryfmt} occur at the start of content, such as another
+entry's description, that will have \idx{sentencecase}
+automatically applied. This will require \sty{mfirstuc} v2.08+ to
+support the mapping. See the \sty{mfirstuc} manual for further details.
+
+
+\section{Comma-Separated Lists}
+\label{sec:csvfields}
+
+These commands are for field values that are comma-separated
+lists (for example, the field has been constructed with
+\gls{glsxtrapptocsvfield}) or for testing if field values are
+contained within comma-separated lists.
+
+\begin{information}
+If you are using \app{bib2gls}, you can sort field values that
+contain a comma-separated list of labels (such as the \gloskey{see}
+or \gloskey{seealso} field) with the \resourceopt{sort-label-list}
+option (provided \app{bib2gls} can access those fields). See the
+\app{bib2gls} manual for further details.
+\end{information}
+
+\cmddef{glsseelist}
+This is provided by the base \sty{glossaries} package to format the
+entry labels in \gloskey{see} cross-reference list. (It's used
+internally by \gls{glsseeformat}, which adds the \emph{see} prefix.) It may also be
+used for any comma-separated list of entry labels. Note that the
+argument isn't expanded. If expansion is required, use:
+\cmddef{glsxtrseelist}
+This fully expands its argument and passes the result to
+\gls{glsseelist}.
+With just the base \sty{glossaries} package, each item is encapsulated with
+\gls{glsseeitem}.
+The \sty{glossaries-extra} package redefines \gls{glsseelist} to make it more
+flexible and provides additional commands to further customize the
+formatting.
+
+\cmddef{glsxtrtaggedlist}
+This is a similar command that has an initial tag inserted before
+the start of the list. If the list only contains one element, the
+\meta{singular tag} is used. If the list contains more than one
+element, the \meta{plural tag} is used. The separator between the
+tag and the list is given by:
+\cmddef{glsxtrtaggedlistsep}
+The separators between the elements of the list and the formatting
+of each list element is as for \gls{glsseelist} (see below). If the list is
+empty, nothing is displayed. The \meta{label prefix} is inserted
+before the current item in the list to form the entry label.
+
+\begin{warning}
+Spaces in \meta{csv-list} are significant. Avoid unwanted leading or
+trailing spaces and empty labels.
+\end{warning}
+
+\cmddef{glsseeitemformat}
+The base \sty{glossaries} package just uses \gls{glsentryname} or
+\gls{glsentrytext} in this command. The \sty{glossaries-extra} package
+redefines this so that it does:
+\begin{codebox}
+\gls{ifglshasshort}\margm{entry-label}\marg{\gls{glsfmttext}\margm{entry-label}}
+\marg{\gls{glsfmtname}\margm{entry-label}}
+\end{codebox}
+Note that the use of \gls{glsfmttext} rather than \gls{glsentrytext}
+allows the abbreviation style to be used.
+
+With \sty{glossaries-extra}, the first item in \gls{glsseelist} will be encapsulated
+with:
+\cmddef{glsseefirstitem}
+The default definition is simply \code{\gls{glsseeitem}\margm{entry-label}} but
+can be redefined, for example to convert the first character to
+\idx{uppercase} if \idx{sentencecase} is required.
+
+\begin{information}
+If the label corresponds to a multi-entry, \gls{mglsseefirstitem}
+will be used instead (see \sectionref{sec:msee}). Similarly,
+\gls{mglsseeitem} will be used instead of \gls{glsseeitem} for a
+multi-entry label.
+\end{information}
+
+\cmddef{glsseesep}
+This is used between each entry in the list, except between the
+final pair.
+
+\cmddef{glsseelastsep}
+This is used between the penultimate and final item in the list.
+The default definition is:
+\begin{codebox}
+\cmd{space}\gls{andname}\cmd{space}
+\end{codebox}
+
+With \sty{glossaries-extra}, if there are at least three elements in
+the list, the separator between the final two elements will be given by:
+\cmddef{glsseelastoxfordsep}
+This just defaults to \gls{glsseelastsep} but may be redefined to
+include a comma, if preferred.
+
+
+\cmddef{glsxtrforcsvfield}
+This iterates over the comma-separated list stored in the given \idx{field}
+(identified by its \idxc{internalfieldlabel}{internal label})
+for the entry identified by \meta{entry-label} and performs
+\code{\meta{handler cs}\margm{element}} for each element of the
+list. This command uses \gls{glsxtrifhasfield} so the complete
+list can be obtained with \gls{glscurrentfieldvalue}. Does nothing
+if the field hasn't been set or the entry hasn't been defined. The
+unstarred version adds implicit grouping. The starred version
+doesn't.
+
+It's possible to prematurely break the loop at the end of the
+current iteration with:
+\cmddef{glsxtrendfor}
+If nested within another command that also uses \gls{@for}, use the
+unstarred version to localise the break. This command is simply set
+to \gls{@endfortrue}, which is provided by the \sty{xfor} package.
+
+\cmddef{glsxtrfieldformatcsvlist}
+This formats the comma-separated list stored in the given \idx{field}
+(identified by its \idxc{internalfieldlabel}{internal label})
+for the entry identified by \meta{entry-label} using \sty{datatool-base}['s]
+\gls{DTLformatlist}.
+This command uses \gls{glsxtrifhasfield} so the complete
+list can be obtained with \gls{glscurrentfieldvalue}.
+This adds implicit grouping. There is no starred version.
+
+The following demonstrates the difference between \gls{glsseelist}
+(which specifically requires a list of labels) and \gls{glsxtrfieldformatcsvlist}
+(which formats an arbitrary list):
+\begin{codebox}
+\cmd{usepackage}\oarg{colorlinks}\marg{hyperref}
+\cmd{usepackage}\oarg{\optval{autoseeindex}{false}}\marg{glossaries-extra}
+\gls{newglossaryentry}\marg{example}\marg{\gloskeyval{name}{example},\gloskeyval{description}{},
+ \gloskeyval{see}{another1,another2}}
+\gls{newglossaryentry}\marg{another1}\marg{\gloskeyval{name}{another one},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{another2}\marg{\gloskeyval{name}{another two},\gloskeyval{description}{}}
+\cbeg{document}
+\gls{glsxtrapptocsvfield}\marg{example}\marg{animals}\marg{duck}
+\gls{glsxtrapptocsvfield}\marg{example}\marg{animals}\marg{albatross}
+\gls{glsxtrapptocsvfield}\marg{example}\marg{animals}\marg{arara}
+Animal list: \gls{glsxtrfieldformatcsvlist}\marg{example}\marg{animals}
+\codepar
+See list: \gls{glsxtrifhasfield}\marg{see}\marg{example}
+ \marg{\gls{glsxtrseelist}\marg{\gls{glscurrentfieldvalue}}}\marg{not set}.
+\codepar
+\gls{printunsrtglossaries}
+\cend{document}
+\end{codebox}
+There's no \idx{indexing} in this document so I've used
+\optval{autoseeindex}{false} to avoid an error. This means there's no cross-reference
+list in the glossary but, as demonstrated, the \qt{see} list can be
+reproduced in the document. The result is:
+\begin{resultbox}
+\createexample*[title={Formatting lists contained in field values},
+ label={ex:fieldformatcsv},
+description={Example document that uses two different methods of
+sorting fields that contain a comma-separated list}]
+{%
+\cmd{usepackage}\oarg{colorlinks}\marg{hyperref}^^J%
+\cmd{usepackage}\oarg{autoseeindex=false}\marg{glossaries-extra}^^J%
+\gls{newglossaryentry}\marg{example}\marg{name=example,description={},^^J%
+ see={another1,another2}}^^J%
+\gls{newglossaryentry}\marg{another1}\marg{name={another one},description={}}^^J%
+\gls{newglossaryentry}\marg{another2}\marg{name={another two},description={}}^^J%
+}
+{%
+\gls{glsxtrapptocsvfield}\marg{example}\marg{animals}\marg{duck}^^J%
+\gls{glsxtrapptocsvfield}\marg{example}\marg{animals}\marg{albatross}^^J%
+\gls{glsxtrapptocsvfield}\marg{example}\marg{animals}\marg{arara}^^J%
+Animal list: \gls{glsxtrfieldformatcsvlist}\marg{example}\marg{animals}.^^J%
+\codepar
+See list: \gls{glsxtrifhasfield}\marg{see}\marg{example}\marg{\gls{glsxtrseelist}\marg{\gls{glscurrentfieldvalue}}}\marg{not set}.^^J%
+\codepar
+\gls{printunsrtglossaries}
+}
+\end{resultbox}
+This first constructs a comma-separated list in a custom \idx{internalfield}
+with the label \code{animals}. There's no associated key that can be
+used in \gls{newglossaryentry}. In this case, the \idx{field} could simply
+be set in one command. For example:
+\begin{codebox}
+\gls{glsxtrdeffield}\marg{example}\marg{animals}\marg{duck,albatross,arara}
+\end{codebox}
+The main reason for providing \gls{glsxtrapptocsvfield} is for the
+benefit of \app{bib2gls}, as it sometimes has to construct a field
+value list while it's writing the \ext{glstex} file, but there may
+be other uses in complex documents that construct field values
+through some custom function.
+
+\cmddef{GlsXtrIfValueInFieldCsvList}
+This does \meta{true} if the comma-separated list stored in the given \idx{field}
+(identified by its \idxc{internalfieldlabel}{internal label})
+contains the given \meta{value} (using \gls{DTLifinlist}
+provided by \sty{datatool-base}) or \meta{false} if the value isn't in the
+list or if the field hasn't been set or the entry hasn't been
+defined. The unstarred version adds implicit grouping. The starred
+version doesn't.
+
+This command internally uses \gls{glsxtrifhasfield}, so take care if
+it's nested. Within \meta{false}, you can test if \gls{glscurrentfieldvalue}
+is empty or undefined. If it's defined but not empty, then the field
+has been set but doesn't contain \meta{value}.
+
+\cmddef{GlsXtrIfFieldValueInCsvList}
+This command is essentially the other way around to the above.
+In this case, the comma-separated list is provided in the argument
+\meta{csv-list} and the search value is the field's value.
+This does \meta{true} if the value is found in \meta{csv-list} or
+\meta{false} if the value isn't in \meta{csv-list} or the field
+isn't set or the entry hasn't been defined. The unstarred version
+adds implicit grouping. The starred version doesn't.
+Again, this command internally uses \gls{glsxtrifhasfield}, so you
+can test \gls{glscurrentfieldvalue} in \meta{false} to determine
+whether or not the field has been set.
+
+\cmddef{xGlsXtrIfValueInFieldCsvList}
+As \gls{GlsXtrIfValueInFieldCsvList} but fully expands \meta{value}
+first.
+
+\section{List Fields}
+\label{sec:listfields}
+
+Comma-separated list fields are covered in
+\sectionref{sec:csvfields}. The commands in this section are for
+fields that store \sty{etoolbox} internal lists. Elements can be
+appended to these fields using commands \gls{glsxtrfieldlistadd},
+described in \sectionref{sec:setfields}. The commands listed below
+provide an easy interface to iterate over the field values. See the
+\sty{etoolbox} documentation for further details about internal
+lists.
+
+\cmddef{glsxtrfieldformatlist}
+Formats the list using the same separators
+as used by \sty{datatool}['s] \gls{DTLformatlist}.
+This internally uses \sty{etoolbox}['s] \gls{forlistcsloop} with the
+same handler macro as used with \gls{DTLformatlist}.
+
+\cmddef{glsxtrfielddolistloop}
+This uses \sty{etoolbox}['s] \gls{dolistcsloop}, which uses the
+command \csfmt{do} as the handler.
+
+\cmddef{glsxtrfieldforlistloop}
+This uses \sty{etoolbox}['s] \gls{forlistcsloop}, which uses the
+\meta{handler-cs} as the handler.
+
+\cmddef{glsxtrfieldifinlist}
+This uses \sty{etoolbox}['s] \gls{ifinlistcs} to test if \meta{item}
+is in the list.
+
+\cmddef{glsxtrfieldxifinlist}
+This uses \sty{etoolbox}['s] \gls{xifinlistcs} to test if \meta{item}
+is in the list.
+
+\section{Field Conditionals}
+\label{sec:fieldconditionals}
+
+\cmddef{GlsXtrIfFieldUndef}
+Tests if the given \idx{field} (identified by its
+\idxc{internalfieldlabel}{internal label}) is undefined for the
+entry given by \meta{entry-label}. Does \meta{true} if the entry
+doesn't exists or if entry exists but the field hasn't been set.
+Does \meta{false} if the field has been set, even if it has been set
+to empty. Unlike \gls{glsxtrifhasfield} there is no grouping or
+starred version and no assignment of \gls{glscurrentfieldvalue}.
+This is simply a shortcut that internally uses
+\sty{etoolbox}['s] \gls{ifcsundef}. The base \sty{glossaries}
+package provides a similar command \gls{ifglsfieldvoid}, which
+uses \sty{etoolbox}['s] \gls{ifcsvoid} instead.
+
+\cmddef{glsxtrifhasfield}
+This tests if the entry given by \meta{entry-label} has the
+\idx{field} identified by its \idxc{internalfieldlabel}{internal label}
+\meta{field-label} set. This is like \gls{ifglshasfield} but
+doesn't produce a warning if the entry or field doesn't exist.
+
+This command first assigns \gls{glscurrentfieldvalue} to the field
+value. If this is defined and not empty, \meta{true} is done otherwise
+\meta{false} is done. You can test \gls{glscurrentfieldvalue} within
+\meta{false} to find out whether it's undefined or empty using
+\sty{etoolbox}'s commands, such as \gls{ifundef} or
+\gls{ifdefempty}.
+
+The unstarred version adds implicit grouping to make nesting easier.
+The starred version doesn't (to make assignments easier).
+
+\begin{information}
+If you are simply displaying the value of the field (for example, in
+the \idx{postdeschook}) then use the unstarred version. If you are
+making an assignment based on the value of the field, then use the
+starred version.
+\end{information}
+
+\cmddef{GlsXtrIfFieldCmpNum}
+This command should only be used with fields that contain integer
+values. It internally uses \gls{glsxtrifhasfield} (the starred or
+unstarred version, to match the starred or unstarred version of
+\gls{GlsXtrIfFieldEqStr}) and tests if \gls{glscurrentfieldvalue}
+is equal to (\meta{op} is \code{=}), less than (\meta{op} is \code{<})
+or greater than (\meta{op} is \code{>}) the given number
+\meta{number}. If the field is empty or undefined, \gls{glscurrentfieldvalue}
+will be set to \code{0}. Remember that the unstarred version adds
+implicit grouping.
+
+\cmddef{GlsXtrIfFieldEqNum}
+This is a shortcut that uses \gls{GlsXtrIfFieldCmpNum} with
+\meta{op} set to \code{=}. The unstarred version adds implicit
+grouping.
+
+\cmddef{GlsXtrIfFieldNonZero}
+This is a shortcut that uses \gls{GlsXtrIfFieldCmpNum} with
+\meta{op} set to \code{=} and the final two arguments swapped.
+(So it's true if the field value is not zero.)
+The unstarred version adds implicit grouping.
+
+\cmddef{GlsXtrIfFieldEqStr}
+This internally uses \gls{glsxtrifhasfield} (the starred or
+unstarred version, to match the starred or unstarred version of
+\gls{GlsXtrIfFieldEqStr}) and tests if \gls{glscurrentfieldvalue}
+is equal to \meta{value}. Remember that the unstarred version adds
+implicit grouping.
+
+\cmddef{GlsXtrIfFieldEqXpStr}
+This is like \gls{GlsXtrIfFieldEqStr} but expands the string before
+the comparison. This also has an starred version that doesn't add
+implicit grouping.
+
+\cmddef{GlsXtrIfXpFieldEqXpStr}
+This is like \gls{GlsXtrIfFieldEqStr} but expands both the field
+value and the string before the comparison. This also has an starred
+version that doesn't add implicit grouping.
+
+\chapter{Counting References}
+\label{sec:countref}
-New abbreviation styles may be defined using:
-\begin{definition}[\DescribeMacro\newabbreviationstyle]
-\cs{newabbreviationstyle}\marg{name}\marg{setup}\marg{fmts}
-\end{definition}
-\begin{sloppypar}\noindent
-where \meta{name} is the name of the new style (as used in the
-mandatory argument of \ics{setabbreviationstyle}). This is similar
-but not identical to the \styfmt{glossaries} package's
-\ics{newacronymstyle} command.
-\end{sloppypar}
+There are three basic ways of counting entry references:
+\begin{enumerate}
+\item Counting the total number of times \gls{glsunset} is used
+(\gls{glsreset} resets the count unless \gls{glsresetcurrcountfalse}
+and is best avoided). This is provided by the base \sty{glossaries}
+package and is intended for documents where the term should be
+displayed differently if it's only been used a certain number of
+times. The information has to be written to the \ext{aux} file so
+that it's available on the next \LaTeX\ run.
+
+This method is extended by \sty{glossaries-extra} and is
+described in \sectionref{sec:entrycount}. This method relies on the
+document only using the \idx{glslike} commands and is
+inappropriate with \app{bib2gls}.
+
+\item Counting the total number of records. This method is
+only available with \app{bib2gls} and is intended
+for documents where the term should be displayed differently
+if it's only been \recorded\ (\indexed) a certain number of times.
+This is a more efficient method than entry counting.
+See \sectionref{sec:recordcount} for further details.
+
+\item Counting the number of times the \idx{glslike} or
+\idx{glstextlike} commands are used. Unlike the other two methods,
+this just provides a running total rather than the total from the
+previous \LaTeX\ run. This method is intended to make it more
+convenient to work with hooks like \gls{glslinkcheckfirsthyperhook},
+\gls{glslinkpostsetkeys} or \gls{glslinkpresetkeys}.
+See \sectionref{sec:linkcount} for further details.
+\end{enumerate}
+
+\section{Entry Counting (First Use Flag)}
+\label{sec:entrycount}
+
+\begin{information}
+If you are using \app{bib2gls}, you need to use record
+counting instead (see \sectionref{sec:recordcount}).
+\end{information}
+
+Entry counting is provided by the base \sty{glossaries} package and
+is enabled with \gls{glsenableentrycount}.
+This keeps a count of the number of times an entry is marked as
+used, which is done by hooking into the unset and reset commands
+(see \sectionref{sec:glsunset}). The current running total can be
+obtained with \gls{glsentrycurrcount}. The total from the end of the
+previous \LaTeX\ run can be obtained with \gls{glsentryprevcount}.
+
+Since entry counting relies on the \idx{firstuseflag}, it doesn't
+take the \idx{glstextlike} commands into account.
+
+\begin{warning}
+Entry counting is incompatible with \opteqvalref{docdef}{true}.
+\end{warning}
+
+The \sty{glossaries-extra} package modifies
+\gls{glsenableentrycount} to allow for the \catattr{entrycount}
+attribute. This means that you not only need to enable entry
+counting with \gls{glsenableentrycount}, but you also need to set
+the \catattr{entrycount} attribute (see below).
+
+Prior to v1.49, the associated counter was reset back to 0 when the
+\idx{firstuseflag} is reset. This behaviour is now only implemented if the
+following conditional is true:
+\cmddef{ifglsresetcurrcount}
+To (locally) change this conditional to true use:
+\cmddef{glsresetcurrcounttrue}
+To (locally) change this conditional to false use:
+\cmddef{glsresetcurrcountfalse}
+As from v1.49, the default is now false. Note that this conditional
+is also available with \sty{glossaries} v4.50+.
\begin{important}
-You can't use styles defined by
-\cs{newacronymstyle} with \styfmt{glossaries-extra} unless you have
-reverted \ics{newacronym} back to its generic definition from \styfmt{glossaries}
-(using \ics{RestoreAcronyms}). The acronym styles from the
-\styfmt{glossaries} package can't be used with abbreviations defined
-with \cs{newabbreviation}.
+Remember that entry counting only counts the number of times an
+entry is used by commands that change the \idx{firstuseflag}. (That
+is, all those commands that mark the entry as having been used.)
+There are many commands that don't modify this flag and they won't
+contribute to the entry use count.
\end{important}
-The \meta{setup} argument deals with the way the entry is defined
-and may set attributes for the given abbreviation
-category. This argument should redefine
-\begin{definition}[\DescribeMacro\CustomAbbreviationFields]
-\cs{CustomAbbreviationFields}
-\end{definition}
-to set the entry fields including the \gloskey{name} (defaults to
-the short form if omitted),
-\gloskey{sort}, \gloskey{first}, \gloskey{firstplural}. Other fields
-may also be set, such as \gloskey{text}, \gloskey{plural} and
-\gloskey{description}.
+With just the base \sty{glossaries} package, the associated entry
+counting commands, such as \gls{cgls}, are only available when entry
+counting has been activated with \gls{glsenableentrycount}. Whereas
+with \sty{glossaries-extra}, those commands are always available but
+behave in the same way as the corresponding \idx{glslike} commands
+if entry counting hasn't been activated. The commands provided by
+the \opt{shortcuts} options, such as \gls{ac} are defined to use
+\gls{cgls} instead of \gls{gls} etc so you can use them either with
+or without entry counting.
+
+In order to activate entry counting with \sty{glossaries-extra}, you
+not only need to use \gls{glsenableentrycount} but also need to
+specify the trigger value.
+
+\cmddef{GlsXtrEnableEntryCounting}
+This command is provided as a shortcut to activate entry counting
+and assign the trigger value. This command performs the following:
+\begin{itemize}
+\item enables entry counting with \gls{glsenableentrycount};
+\item redefines the \idx{glslike} commands to do the equivalent
+\gls{cgls} commands (so you don't need to keep track of which
+entries have entry counting enabled);
+\item sets the \catattr{entrycount} attribute to \meta{trigger-value}
+for all the supplied categories;
+\item disables the unit counting command (which is incompatible).
+\end{itemize}
+If you want to have different trigger values for different
+categories, you can set the \catattr{entrycount} attribute
+afterwards for the other category. For example:
+\begin{codebox}
+\gls{GlsXtrEnableEntryCounting}\marg{\cat{abbreviation},\cat{acronym}}\marg{1}
+\gls{glssetcategoryattribute}\marg{\cat{general}}\marg{2}
+\end{codebox}
+If you use \gls{GlsXtrEnableEntryCounting} multiple times, the
+repeated instances will simply set the \catattr{entrycount}
+attribute for the listed categories. So the above can also be written
+as:
+\begin{codebox}
+\gls{GlsXtrEnableEntryCounting}\marg{\cat{abbreviation},\cat{acronym}}\marg{1}
+\gls{GlsXtrEnableEntryCounting}\marg{\cat{general}}\marg{2}
+\end{codebox}
+
+The commands like \gls{cgls} behave like the corresponding
+\idx{glslike} command if the entry count at the end of the previous
+run was more than a trigger value. With just the base
+\sty{glossaries} package, this trigger value is 1. With
+\sty{glossaries-extra} you can specify a different value.
\begin{important}
-\cs{CustomAbbreviationFields} is expanded by \cs{newabbreviation}
-so take care to protect commands that shouldn't be expanded.
+The appropriate trigger value must be set for the required category
+or categories.
\end{important}
-For example, the \abbrstyle{long-short} style has the following in
-\meta{setup}:
-\begin{verbatim}
- \renewcommand*{\CustomAbbreviationFields}{%
- name={\protect\glsabbrvfont{\the\glsshorttok}},
- sort={\the\glsshorttok},
- first={\protect\glsfirstlongfont{\the\glslongtok}%
- \protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvfont{\the\glsshorttok}}},%
- firstplural={\protect\glsfirstlongfont{\the\glslongpltok}%
- \protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvfont{\the\glsshortpltok}}},%
- plural={\protect\glsabbrvfont{\the\glsshortpltok}},%
- description={\the\glslongtok}}%
-\end{verbatim}
-Note that the \gloskey{first} and \gloskey{firstplural} are
-set even though they're not used by \cs{gls}.
-
-The basic styles, such as \abbrstyle{long-short}, use commands like
-\cs{glsabbrvfont} (which are redefined whenever the style formatting
-is set) within \cs{CustomAbbreviationFields}. Other styles, such as
-\abbrstyle{long-em-short-em} directly use their own custom commands,
-such as \cs{glsabbrvemfont}. With these styles, commands like
-\cs{glsabbrvfont} still need to be defined as appropriate in the
-\meta{fmts} argument even if they're not used within
-\cs{CustomAbbreviationFields}.
-
-The \meta{setup} argument may also redefine
-\begin{definition}[\DescribeMacro\GlsXtrPostNewAbbreviation]
-\cs{GlsXtrPostNewAbbreviation}
-\end{definition}
-which can be used to assign attributes. (This will automatically
-be initialised to do nothing.)
-
-For example, the \abbrstyle{short-footnote} includes the following in
-\meta{setup}:
-\begin{verbatim}
- \renewcommand*{\GlsXtrPostNewAbbreviation}{%
- \glssetattribute{\the\glslabeltok}{nohyperfirst}{true}%
- \glshasattribute{\the\glslabeltok}{regular}%
- {%
- \glssetattribute{\the\glslabeltok}{regular}{false}%
- }%
- {}%
- }%
-\end{verbatim}
-This sets the \catattr{nohyperfirst} attribute to \qt{true}.
-It also unsets the \catattr{regular} attribute if it has
-previously been set. Note that the \catattr{nohyperfirst}
-attribute doesn't get unset by other styles, so take care
-not to switch styles for the same category.
-
-You can access the short, long, short plural and long plural
-values through the following token registers.
-
-Short value (defined by \styfmt{glossaries}):
-\begin{definition}[\DescribeMacro\glsshorttok]
-\cs{glsshorttok}
-\end{definition}
-
-Short plural value (defined by \styfmt{glossaries-extra}):
-\begin{definition}[\DescribeMacro\glsshortpltok]
-\cs{glsshortpltok}
-\end{definition}
-(This may be the default value or, if provided, the value provided by the user
-through the \gloskey{shortplural} key in the optional argument
-of \ics{newabbreviation}.)
-
-Long value (defined by \styfmt{glossaries}):
-\begin{definition}[\DescribeMacro\glslongtok]
-\cs{glslongtok}
-\end{definition}
-
-Long plural value (defined by \styfmt{glossaries-extra}):
-\begin{definition}[\DescribeMacro\glslongpltok]
-\cs{glslongpltok}
-\end{definition}
-(This may be the default value or, if provided, the value provided by the user
-through the \gloskey{longplural} key in the optional argument
-of \ics{newabbreviation}.)
-
-The short or long values may be modified by attributes (such as
-\catattr{markwords}). The above registers reflect the modification.
-If you want to access the original (unmodified) short or long form
-(as provided in the final two arguments of \cs{newabbreviation}),
-then use the commands:
-\begin{definition}[\DescribeMacro\glsxtrorgshort]
-\cs{glsxtrorgshort}
-\end{definition}
-for the short form and
-\begin{definition}[\DescribeMacro\glsxtrorglong]
-\cs{glsxtrorglong}
-\end{definition}
-for the long form. (These may be useful for the \gloskey{sort} key
-to avoid any formatting that may be added by the attribute setting.)
-
-There are two other registers available that are defined by
-\styfmt{glossaries}:
-
-\begin{definition}[\DescribeMacro\glslabeltok]
-\cs{glslabeltok}
-\end{definition}
-which contains the entry's label and
-\begin{definition}[\DescribeMacro\glskeylisttok]
-\cs{glskeylisttok}
-\end{definition}
-which contains the values provided in the optional argument
-of \ics{newabbreviation}.
-
-Remember put \cs{the} in front of the register command as in the
-examples above. The category label can be access through
-the command (not a register):
-\begin{definition}[\DescribeMacro\glscategorylabel]
-\cs{glscategorylabel}
-\end{definition}
-This may be used inside the definition of
-\cs{GlsXtrPostNewAbbreviation}.
-
-If you want to base a style on an existing style, you can use
-\begin{definition}[\DescribeMacro\GlsXtrUseAbbrStyleSetup]
-\cs{GlsXtrUseAbbrStyleSetup}\marg{name}
-\end{definition}
-where \meta{name} is the name of the existing style.
-For example, the \abbrstyle{long-noshort-sc-desc} style simply does
-\begin{verbatim}
-\GlsXtrUseAbbrStyleSetup{long-noshort-desc}
-\end{verbatim}
-within \meta{setup}.
-
-The \meta{fmts} argument deals with the way the entry is displayed
-in the document. This argument should redefine the following
+As with the \idx{glslike} commands, the \gls{cgls} set of commands
+may also be used with the star (\code{*}) or plus (\code{+}) modifiers or the
+modifier given by \gls{GlsXtrSetAltModifier}.
+
+If the entry count at the end of the previous run doesn't exceed
+the trigger value, the corresponding formatting command is used
+instead. For example, \gls{cgls} will use \gls{cglsformat}. The
+complete set of commands are:
+\cmddef{cgls}
+If the trigger value has been supplied for the entry's category
+and is exceeded, this behaves like \gls{gls} otherwise it uses:
+\cmddef{cglsformat}
+This is redefined by \sty{glossaries-extra} to test whether or not
+the entry has the \catattr{regular} attribute set or is an
+abbreviation:
+\begin{compactcodebox}
+\cmd{renewcommand}*\marg{\gls{cglsformat}}[2]\marg{\%
+ \gls{glsifregular}\marg{\#1}\marg{\gls{glsentryfirst}\marg{\#1}}\%
+ \marg{\gls{ifglshaslong}\marg{\#1}\marg{\gls{glsentrylong}\marg{\#1}}\marg{\gls{glsentryfirst}\marg{\#1}}}\#2\%
+}
+\end{compactcodebox}
+This show the first use value if the entry is regular otherwise it
+will show the long form. The insert is appended at the end.
+
+\cmddef{cglspl}
+If the trigger value has been supplied for the entry's category
+and is exceeded, this behaves like \gls{glspl} otherwise it uses:
+\cmddef{cglsplformat}
+This is like \gls{cglsformat} but uses the plural commands.
+
+\cmddef{cGls}
+If the trigger value has been supplied for the entry's category
+and is exceeded, this behaves like \gls{Gls} otherwise it uses:
+\cmddef{cGlsformat}
+This is like \gls{cglsformat} but uses the \idx{sentencecase}
commands.
-The default suffix for the plural short form (if not overridden by
-the \gloskey{shortplural} key):
-\begin{definition}[\DescribeMacro\abbrvpluralsuffix]
-\cs{abbrvpluralsuffix}
-\end{definition}
-(Note that this isn't used for the plural long form, which
-just uses the regular \cs{glspluralsuffix}.)
-
-The font used for the short form on \gls{firstuse} or in the full forms:
-\begin{definition}[\DescribeMacro\glsfirstabbrvfont]
-\cs{glsfirstabbrvfont}\marg{text}
-\end{definition}
-
-The font used for the short form on subsequent use or through
-commands like \ics{glsxtrshort}:
-\begin{definition}[\DescribeMacro\glsabbrvfont]
-\cs{glsabbrvfont}\marg{text}
-\end{definition}
-
-The font used for the long form on \gls{firstuse} or in the full forms:
-\begin{definition}[\DescribeMacro\glsfirstlongfont]
-\cs{glsfirstlongfont}\marg{text}
-\end{definition}
-
-The font used for the long form in commands like \cs{glsxtrlong}
-use:
-\begin{definition}[\DescribeMacro\glslongfont]
-\cs{glslongfont}\marg{text}
-\end{definition}
-
-Display full form singular no case-change (used by \ics{gls} on
-\gls{firstuse} for abbreviations without the \catattr{regular} attribute
-set):
-\begin{definition}[\DescribeMacro\glsxtrfullformat]
-\cs{glsxtrfullformat}\marg{label}\marg{insert}
-\end{definition}
-
-Display full form singular first letter converted to upper case
-(used by \ics{Gls} on \gls{firstuse} for abbreviations without the
-\catattr{regular} attribute set):
-\begin{definition}[\DescribeMacro\Glsxtrfullformat]
-\cs{Glsxtrfullformat}\marg{label}\marg{insert}
-\end{definition}
-
-Display full form plural no case-change
-(used by \ics{glspl} on \gls{firstuse} for abbreviations without the
-\catattr{regular} attribute set):
-\begin{definition}[\DescribeMacro\glsxtrfullplformat]
-\cs{glsxtrfullplformat}\marg{label}\marg{insert}
-\end{definition}
-
-Display full form plural first letter converted to upper case
-(used by \ics{Glspl} on \gls{firstuse} for abbreviations without the
-\catattr{regular} attribute set):
-\begin{definition}[\DescribeMacro\Glsxtrfullplformat]
-\cs{Glsxtrfullplformat}\marg{label}\marg{insert}
-\end{definition}
-
-In addition \meta{fmts} may also redefine the following commands that
-govern the inline full formats. If the style doesn't redefine them,
-they will default to the same as the display full forms.
-
-Inline singular no case-change (used by
-\ics{glsentryfull}, \ics{glsxtrfull} and \ics{GLSxtrfull}):
-\begin{definition}[\DescribeMacro\glsxtrinlinefullformat]
-\cs{glsxtrinlinefullformat}\marg{label}\marg{insert}
-\end{definition}
-
-Inline singular first letter converted to upper case (used by
-\ics{Glsentryfull} and \ics{Glsxtrfull}):
-\begin{definition}[\DescribeMacro\Glsxtrinlinefullformat]
-\cs{Glsxtrinlinefullformat}\marg{label}\marg{insert}
-\end{definition}
-
-Inline plural no case-change (used by
-\ics{glsentryfullpl}, \ics{glsxtrfullpl} and \ics{GLSxtrfullpl}):
-\begin{definition}[\DescribeMacro\glsxtrinlinefullplformat]
-\cs{glsxtrinlinefullplformat}\marg{label}\marg{insert}
-\end{definition}
-
-Inline plural first letter converted to upper case (used by
-\ics{Glsentryfullpl} and \ics{Glsxtrfullpl}):
-\begin{definition}[\DescribeMacro\Glsxtrinlinefullplformat]
-\cs{Glsxtrinlinefullplformat}\marg{label}\marg{insert}
-\end{definition}
-
-(New to version 1.17.)
-You can also modify the way the subsequent use is formatted by
-redefining the following four commands, but these won't be used for
-abbreviations with the \catattr{regular} attribute set. If the style
-doesn't redefine these commands, the default values are used.
-
-Singular with no case-change:
-\begin{definition}[\DescribeMacro\glsxtrsubsequentfmt]
-\cs{glsxtrsubsequentfmt}\marg{label}\marg{insert}
-\end{definition}
-
-Singular with first letter upper case:
-\begin{definition}[\DescribeMacro\Glsxtrsubsequentfmt]
-\cs{Glsxtrsubsequentfmt}\marg{label}\marg{insert}
-\end{definition}
-
-Plural with no case-change:
-\begin{definition}[\DescribeMacro\glsxtrsubsequentplfmt]
-\cs{glsxtrsubsequentplfmt}\marg{label}\marg{insert}
-\end{definition}
-
-Plural with first letter upper case:
-\begin{definition}[\DescribeMacro\Glsxtrsubsequentplfmt]
-\cs{Glsxtrsubsequentplfmt}\marg{label}\marg{insert}
-\end{definition}
-
-If you want to provide support for \sty{glossaries-accsupp}
-use the following \cs{glsaccess\meta{xxx}} commands
-(\sectionref{sec:accsupp}) within the definitions of
-\cs{glsxtrfullformat} etc instead of the analogous
-\cs{glsentry}\meta{xxx} commands. (If you don't use
-\sty{glossaries-accsupp}, they will just do the corresponding
-\cs{glsentry}\meta{xxx} command.)
-
-For example, the \abbrstyle{short-long} style has the following in
-\meta{fmts}:
-\begin{verbatim}
- \renewcommand*{\abbrvpluralsuffix}{\glsxtrabbrvpluralsuffix}%
- \renewcommand*{\glsabbrvfont}[1]{\glsabbrvdefaultfont{##1}}%
- \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvdefaultfont{##1}}%
- \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
- \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
- \renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfont{\glsaccesslong{##1}}}%
- }%
- \renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfont{\glsaccesslongpl{##1}}}%
- }%
- \renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfont{\glsaccesslong{##1}}}%
- }%
- \renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfont{\glsaccesslongpl{##1}}}%
- }%
-\end{verbatim}
-Since the inline full commands aren't redefined, they default
-to the same as the display versions.
-
-If you want to base a style on an existing style, you can use
-\begin{definition}[\DescribeMacro\GlsXtrUseAbbrStyleFmts]
-\cs{GlsXtrUseAbbrStyleFmts}\marg{name}
-\end{definition}
-within \meta{fmts}, where \meta{name} is the name of the existing
-style. For example, the \abbrstyle{long-short-desc} style has the
-following in \meta{fmts}:
-\begin{verbatim}
- \GlsXtrUseAbbrStyleFmts{long-short}%
-\end{verbatim}
-
-Here's an example of an abbreviation style that's based on
-\abbrstyle{long-short} that displays the short form within
-\cs{textsf}:
-\begin{verbatim}
-\newabbreviationstyle
-{custom-sf}% label
-{% setup
- \GlsXtrUseAbbrStyleSetup{short-long}%
-}%
-{% fmts
- \GlsXtrUseAbbrStyleFmts{short-long}%
- \renewcommand*{\glsabbrvfont}[1]{\textsf{##1}}%
-}
-\end{verbatim}
-Note that this wouldn't work if it was instead based on one of the
-modified versions such as \abbrstyle{short-sc-long} as they
-explicitly use their own formatting commands, such as
-\cs{glsabbrvemfont}. The base styles, such as \abbrstyle{short-long},
-use the more generic \cs{glsabbrvfont} etc which makes them easier
-to adapt than the modified styles.
-
-For further details, see the \qt{Abbreviations} section in the documented code
-(\nolinkurl{glossaries-extra-code.pdf}).
-
-\chapter{Entries in Sectioning Titles, Headers, Captions and Contents}
-\label{sec:headtitle}
+\cmddef{cGlspl}
+If the trigger value has been supplied for the entry's category
+and is exceeded, this behaves like \gls{Glspl} otherwise it uses:
+\cmddef{cGlsplformat}
+This is like \gls{cglsformat} but uses the plural \idx{sentencecase}
+commands.
-The \styfmt{glossaries} user manual cautions against using commands
-like \cs{gls} in chapter or section titles. The principle problems
-are:
+The \sty{glossaries-extra} package provides some additional
+commands:
+
+\cmddef{cGLS}
+If the trigger value has been supplied for the entry's category
+and is exceeded, this behaves like \gls{GLS} otherwise it uses:
+\cmddef{cGLSformat}
+This simply uses \gls{cglsformat} converted to \idx{uppercase}.
+
+\cmddef{cGLSpl}
+If the trigger value has been supplied for the entry's category
+and is exceeded, this behaves like \gls{GLSpl} otherwise it uses:
+\cmddef{cGLSplformat}
+This simply uses \gls{cglsplformat} converted to \idx{uppercase}.
+
+The test to determine whether or not an entry trips the trigger
+value is performed by:
+\cmddef{glsxtrifcounttrigger}
+This obtains the trigger value from the entry's \catattr{entrycount}
+attribute.
+
+\begin{important}
+Since these commands require information from the previous \LaTeX\
+run, and extra \LaTeX\ call must be added to the build process
+(before the relevant \idx{indexingapp}).
+\end{important}
+
+For example, in the following document the trigger value is set to
+1. The CSS entry is only used once (which doesn't exceed the
+trigger). The HTML entry is used twice (which does exceed the
+trigger). The sample entry is only used once, but entry counting
+hasn't been enabled on its category (the default \cat{general}).
+
+\begin{codebox}
+\cmd{usepackage}\oarg{colorlinks}\marg{hyperref}
+\cmd{usepackage}\marg{glossaries-extra}
+\gls{makeglossaries}
+\gls{GlsXtrEnableEntryCounting}\marg{\cat{abbreviation}}\marg{1}
+\gls{newabbreviation}\marg{css}\marg{CSS}\marg{cascading style sheet}
+\gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{an example}}
+\cbeg{document}
+First use: \gls{gls}\marg{css}, \gls{gls}\marg{html} and \gls{gls}\marg{sample}.
+Next use: \gls{gls}\marg{html}.
+\gls{printglossaries}
+\cend{document}
+\end{codebox}
+If the document is saved in a file called \filefmt{myDoc.tex} then
+the build process is:
+\begin{terminal}
+pdflatex myDoc
+pdflatex myDoc
+makeglossaries myDoc
+pdflatex myDoc
+\end{terminal}
+Note the second \LaTeX\ call before \app{makeglossaries}. The result
+is shown below:
+\begin{resultbox}
+\createexample*[arara={pdflatex,pdflatex,makeglossaries,pdflatex,pdfcrop},
+ label={ex:catentrycount},
+ title={Entry counting according to category},
+ description={Example document illustrating entry counting}]
+{%
+\cmd{usepackage}[colorlinks]\marg{hyperref}^^J%
+\cmd{usepackage}\marg{glossaries-extra}^^J%
+\gls{makeglossaries}^^J%
+\gls{GlsXtrEnableEntryCounting}\marg{abbreviation}\marg{1}^^J%
+\gls{newabbreviation}\marg{css}\marg{CSS}\marg{cascading style sheet}^^J%
+\gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}^^J%
+\gls{newglossaryentry}\marg{sample}\marg{name={sample},description={an example}}^^J%
+}
+{%
+First use: \gls{gls}\marg{css}, \gls{gls}\marg{html} and \gls{gls}\marg{sample}.^^J%
+Next use: \gls{gls}\marg{html}.^^J%
+\gls{printglossaries}
+}
+\end{resultbox}
+Note that the CSS entry only shows the long form, doesn't appear in
+the glossary and doesn't have a hyperlink. This is because the total
+count from the previous \LaTeX\ run doesn't exceed the value (1, in
+this case) that triggers the normal behaviour of \gls{gls}. The HTML
+entry has a total count of 2 from the previous \LaTeX\ run, so it's
+displayed as normal with the full form on \idx{firstuse} and has a
+hyperlink to its entry in the glossary.
+
+The sample entry is only used once, but it has the default \cat{general}
+category, which doesn't have the \catattr{entrycount} attribute set.
+
+Note that if the build process only had one \LaTeX\ call before
+running \app{makeglossaries}, the HTML entry would also not appear
+in the glossary. This is because on the first \LaTeX\ run, the total
+from the previous run is 0 (because there's no information in the
+\ext{aux} file).
+
+The \sty{glossaries-extra} package also provides the ability to
+count per sectional unit instead:
+\cmddef{glsenableentryunitcount}
+
+\begin{important}
+It's not possible to enable both document-wide entry counting
+(\gls{glsenableentrycount}) and unit entry counting
+(\gls{glsenableentryunitcount}).
+\end{important}
+
+The unit entry counting provides separate totals for each section unit. As above, this
+uses the \catattr{entrycount} attribute to provide the trigger value
+but also requires the \catattr{unitcount} attribute, which should be
+set to the name of the appropriate counter, such as \ctr{section} or
+\ctr{chapter}.
+
+\begin{warning}
+Due to the asynchronous nature of \TeX's output routine,
+discrepancies will occur in page spanning paragraphs if you
+use the \ctr{page} counter.
+\end{warning}
+
+As before, there is a command provided to enable the feature and set
+the corresponding attributes at the same time:
+\cmddef{GlsXtrEnableEntryUnitCounting}
+This command performs the following:
\begin{itemize}
-\item if you have a table of contents, the \gls{firstuseflag}
-will be unset in the contents rather than later in the document;
-\item if you have the location lists displayed in the glossary,
-unwanted locations will be added to it corresponding to the table of
-contents (if present) and every page that contains the entry in the
-page header (if the page style in use adds the chapter or section
-title to the header);
-\item if the page style in use adds the chapter or section title to
-the header and attempts to convert it to upper case, the entry label
-(in the argument of \cs{gls} etc) will be converted to upper case
-and the entry won't be recognised;
-\item if you use \sty{hyperref}, commands like \cs{gls} can't be
-expanded to a simple string and only the label will appear in the
-PDF bookmark (with a warning from \sty{hyperref});
-\item if you use \sty{hyperref}, you will end up with nested hyperlinks
-in the table of contents.
+\item enables unit entry counting with \gls{glsenableentryunitcount};
+\item redefines the \idx{glslike} commands to do the equivalent
+\gls{cgls} commands (so you don't need to keep track of which
+entries have entry counting enabled);
+\item sets the \catattr{entrycount} attribute to the supplied
+trigger for all the supplied categories;
+\item sets the \catattr{unitcount} attribute to the supplied
+counter for all the supplied categories;
+\item disables the document-wide counting command (which is incompatible).
\end{itemize}
-Similar problems can also occur with captions (except for the page
-header and bookmark issues).
+If you use \gls{GlsXtrEnableEntryUnitCounting} multiple times, the
+repeated instances will simply set the \catattr{entrycount}
+and \catattr{unitcount} attributes for the listed categories.
-\section{Simplistic Approach}
-\label{sec:simplisticapproach}
+The counter value is used as part of a label, which means
+that \thecountername\ needs to be expandable.
+Since \sty{hyperref} also has a similar requirement and provides
+\theHcountername\ as an expandable alternative,
+\sty{glossaries-extra} will use \theHcountername\
+if it exists otherwise it will use \thecountername.
-To get around all these problems, the \styfmt{glossaries} user manual
-recommends using the expandable non-hyperlink commands, such as
-\ics{glsentrytext} (for regular entries) or \ics{glsentryshort}
-(for abbreviations). This is the simplest solution, but doesn't
-allow for special formatting that's applied to the entry through
-commands like \cs{glstext} or \cs{glsxtrshort}. This means that if,
-for example, you are using one of the abbreviation styles that uses
-\ics{textsc} then the short form displayed with \cs{glsentryshort} won't use small
-caps. If you only have one abbreviation style in use, you can
-explicitly enclose \cs{glsentryshort}\marg{label} in the argument of
-\cs{glsabbrvfont}, like this:
-\begin{verbatim}
-\chapter{A Chapter about \glsabbrvfont{\glsentryshort{html}}}
-\end{verbatim}
-Or, if you are using \sty{hyperref}:
-\begin{verbatim}
-\chapter{A Chapter about
-\texorpdfstring{\glsabbrvfont{\glsentryshort{html}}}{\glsentryshort{html}}}
-\end{verbatim}
-
-Since this is a bit cumbersome, you might want to define a new
-command to do this for you. However, if you have mixed styles this
-won't work as commands like \cs{gls} and \cs{glsxtrshort} redefine
-\cs{glsabbrvfont} to match the entry's style before displaying it.
-In this case, the above example doesn't take into account the
-shifting definitions of \cs{glsabbrvfont} and will use whatever
-happens to be the last abbreviation style in use. More complicated
-solutions interfere with the upper casing used by the standard
-page styles that display the chapter or section title in the page
-header using \ics{MakeUppercase}.
-
-The \styfmt{glossaries-extra} package tries to resolve this by
-modifying \ics{markright} and \ics{markboth} and \cs{@starttoc}. If you don't like this
-change, you can restore their former definitions using
-\begin{definition}[\DescribeMacro\glsxtrRevertMarks]
-\cs{glsxtrRevertMarks}
-\end{definition}
-If you only want to restore \cs{@starttoc} you can use:
-\begin{definition}[\DescribeMacro\glsxtrRevertTocMarks]
-\cs{glsxtrRevertTocMarks}
-\end{definition}
-If you restore the header or table of contents commands, you'll have to use the \styfmt{glossaries} manual's
-recommendations of either simply using \cs{glsentryshort} (as above)
-or use the sectioning command's option argument to provide an
-alternative for the table of contents and page header. For example:
-\begin{verbatim}
-\chapter[A Chapter about \glsentryshort{html}]{A Chapter about \gls{html}}
-\end{verbatim}
-Alternatively, you need to find a way to insert \cs{glsxtrmarkhook} and
-\cs{@glsxtrinmark} at the start of the header or table of contents
-either scoped or afterwards cancelled with \cs{@glsxtrnotinmark} and
-\cs{glsxtrrestoremarkhook}.
-
-If you don't revert the mark commands back with
-\cs{glsxtrRevertMarks}, you can use the commands described below in
-the argument of sectioning commands. You can still use them even
-if the mark commands have been reverted, but only where they don't
-conflict with the page style.
-
-\section{New Commands Designed for Chapter/Section Headings}
-\label{sec:headingcommands}
+The commands for accessing the totals, \gls{glsentrycurrcount} and
+\gls{glsentryprevcount} have different definitions with unit entry
+counting and will expand to the total for the current unit.
+The overall totals can be obtained with additional commands:
+\cmddef{glsentryprevtotalcount}
+This expands to the overall total from the previous \LaTeX\ run.
-The commands listed below are designed for use in chapter or section
-headings. There are still limitations, but they provide a better
-solution. They all use \ics{texorpdfstring} if \sty{hyperref} has
-been loaded so that the expandable non-formatted version is added to
-the PDF bookmarks. Note that since the commands that convert the
-first letter to upper case aren't expandable, the non-case-changing
-version is used for the bookmarks. If the required field contains
-non-expandable (robust or fragile) commands that cause a problem for
-the bookmarks then \ics{texorpdfstring} will be needed as
-appropriate in that field. (Take care if the field has its value
-expanded before being assigned.)
-
-These commands essentially behave as though you have used
-\cs{glsxtrshort}, \cs{glstext} etc with the options
-\gloskey[glslink]{noindex} and \gloskey[glslink]{hyper\eq false}.
-The text produced won't be converted to upper case in the page
-headings by default. If you want the text converted to upper case
-you need to set the \catattr{headuc} attribute to \qt{true}
-for the appropriate category.
+\cmddef{glsentryprevmaxcount}
+This expands to the maximum per-unit total from the previous \LaTeX\ run.
+
+For example:
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\cmd{usepackage}[colorlinks]\marg{hyperref}
+\cmd{usepackage}\marg{glossaries-extra}
+\codepar
+\gls{GlsXtrEnableEntryUnitCounting}\marg{\cat{abbreviation}}\marg{2}\marg{section}
+\codepar
+\gls{makeglossaries}
+\comment{\gloskeyval{category}{abbreviation}:}
+\gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}
+\gls{newabbreviation}\marg{css}\marg{CSS}\marg{cascading style sheet}
+\codepar
+\comment{\gloskeyval{category}{general}:}
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{sample}}
+\codepar
+\cbeg{document}
+\cmd{section}\marg{Sample}
+\codepar
+Used once: \gls{gls}\marg{html}.
+\codepar
+Used three times: \gls{gls}\marg{css} and \gls{gls}\marg{css} and \gls{gls}\marg{css}.
+\codepar
+Used once: \gls{gls}\marg{sample}.
+\codepar
+\cmd{section}\marg{Another Sample}
+\codepar
+Used once: \gls{gls}\marg{css}.
+\codepar
+Used twice: \gls{gls}\marg{html} and \gls{gls}\marg{html}.
+\codepar
+\gls{printglossaries}
+\cend{document}
+\end{codebox}
+As before, if the document is in a file called \filefmt{myDoc.tex}
+then the build process is:
+\begin{terminal}
+pdflatex myDoc
+pdflatex myDoc
+makeglossaries myDoc
+pdflatex myDoc
+\end{terminal}
+The result is:
+\begin{resultbox}
+\createexample*[arara={pdflatex,pdflatex,makeglossaries,pdflatex,pdfcrop},
+ label={ex:catunitentrycount},
+ title={Entry unit counting (per section) according to category},
+ description={Example document illustrating entry unit counting (per section)}]
+{%
+\cmd{usepackage}[colorlinks]\marg{hyperref}^^J%
+\cmd{usepackage}\marg{glossaries-extra}^^J%
+\gls{GlsXtrEnableEntryUnitCounting}\marg{abbreviation}\marg{2}\marg{section}^^J%
+\gls{makeglossaries}^^J%
+\% category=abbreviation:^^J%
+\gls{newabbreviation}\marg{html}\marg{HTML}\marg{hypertext markup language}^^J%
+\gls{newabbreviation}\marg{css}\marg{CSS}\marg{cascading style sheet}^^J%
+\% category=general:^^J%
+\gls{newglossaryentry}\marg{sample}\marg{name={sample},description={an example}}^^J%
+}
+{%
+\cmd{section}\marg{Sample}
+\codepar
+Used once: \gls{gls}\marg{html}.
+\codepar
+Used three times: \gls{gls}\marg{css} and \gls{gls}\marg{css} and \gls{gls}\marg{css}.
+\codepar
+Used once: \gls{gls}\marg{sample}.
+\codepar
+\cmd{section}\marg{Another Sample}
+\codepar
+Used once: \gls{gls}\marg{css}.
+\codepar
+Used twice: \gls{gls}\marg{html} and \gls{gls}\marg{html}.
+\codepar
+\gls{printglossaries}
+}
+\end{resultbox}
+In this document, the CSS entry is used three times in the
+first section. This is more than the trigger value of 2, so
+\code{\gls{gls}\marg{css}} is expanded on \idx{firstuse} with the short
+form used on subsequent use, and the CSS entries in
+that section are added to the glossary. In the second section,
+the CSS entry is only used once, which trips the
+suppression trigger, so in that section, the long form
+is used and \code{\gls{gls}\marg{css}} doesn't get a line added to
+the glossary file.
+
+The HTML entry is used a total of three times, but the
+expansion and indexing suppression trigger is tripped
+in both sections because the per-unit total (1 for the first
+section and 2 for the second chapter) is less than or equal
+to the trigger value.
+
+The sample entry has only been used once, but it doesn't
+trip the indexing suppression because it's in the \cat{general}
+category, which hasn't been listed in
+\gls{GlsXtrEnableEntryUnitCounting}.
+
+The per-unit entry counting can be used for other purposes.
+In the following example document, the trigger value is set
+to zero, which means the index suppression won't be triggered,
+but the unit entry count is used to automatically suppress the
+hyperlink for commands like \gls{gls} by modifying the
+\gls{glslinkcheckfirsthyperhook}
+which is used at the end of the macro the determines whether
+or not to suppress the hyperlink.
+
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\cmd{usepackage}[colorlinks]\marg{hyperref}
+\cmd{usepackage}\marg{glossaries-extra}
+\gls{makeglossaries}
+\gls{GlsXtrEnableEntryUnitCounting}\marg{\cat{general}}\marg{0}\marg{page}
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{an example}}
+\codepar
+\cmd{renewcommand}*\marg{\gls{glslinkcheckfirsthyperhook}}\marg{\%
+ \cmd{ifnum}\gls{glsentrycurrcount}\gls{glslabel}>0
+ \gls{setupglslink}\marg{hyper=false}\%
+ \cmd{fi}
+}
+\codepar
+\cbeg{document}
+\codepar
+A \gls{gls}\marg{sample} entry. Next use: \gls{gls}\marg{sample}.
+\codepar
+\cmd{newpage}
+Next page: \gls{gls}\marg{sample}. Again: \gls{gls}\marg{sample}.
+\codepar
+\gls{printglossaries}
+\cend{document}
+\end{codebox}
+This only produces a hyperlink for the first instance of
+\code{\gls{gls}\marg{sample}} on each page.
+\begin{resultbox}
+\createexample*[pages={1,2},
+ label={ex:unitentrycounthyper},
+ arara={pdflatex,pdflatex,makeglossaries,pdflatex,pdfcrop},
+ title={Enabling unit counting to hook into hyperlink setting},
+ description={Example document that demonstrates how to
+ automatically switch off the hyperlink using unit counting}]
+{%
+\cmd{usepackage}[colorlinks]\marg{hyperref}^^J%
+\cmd{usepackage}\marg{glossaries-extra}^^J%
+\codepar
+\gls{makeglossaries}^^J%
+\codepar
+\gls{GlsXtrEnableEntryUnitCounting}\marg{general}\marg{0}\marg{page}^^J%
+\codepar
+\gls{newglossaryentry}\marg{sample}\marg{name={sample},description={an example}}^^J%
+\codepar
+\cmd{renewcommand}*\marg{\gls{glslinkcheckfirsthyperhook}}\marg{\%^^J
+ \cmd{ifnum}\gls{glsentrycurrcount}\gls{glslabel}>0^^J
+ \gls{setupglslink}\marg{hyper=false}\%^^J
+ \cmd{fi}^^J%
+}
+}
+{A \gls{gls}\marg{sample} entry. Next use: \gls{gls}\marg{sample}.
+\codepar
+\cmd{newpage}^^J%
+Next page: \gls{gls}\marg{sample}. Again: \gls{gls}\marg{sample}.
+\codepar
+\gls{printglossaries}
+}
+\end{resultbox}
+
+The earlier warning about using the \ctr{page} counter still
+applies. If the first instance of \gls{gls} occurs at the top of the
+page within a paragraph that started on the previous page, then
+the count will continue from the previous page.
+
+\section{Link Counting}
+\label{sec:linkcount}
+
+As from version 1.26, an alternative method of entry counting
+is to count the number of times the \idx{glslike} or
+\idx{glstextlike} commands are used. (The \qt{link} in this method's
+name refers to the use of the internal command \csfmt{@gls@link}
+not to \gls{hyperlink} although \csfmt{@gls@link} may use
+\gls{hyperlink} when displaying the \idx{linktext}.)
+
+To enable link counting use the preamble-only command:
+\cmddef{GlsXtrEnableLinkCounting}
+where \meta{categories} is a list of category labels. The optional
+argument \meta{parent counter} may be used to identify a parent
+counter (which must already be defined). If present, the associated
+link counter will be reset when the parent counter is incremented.
+This command automatically sets the \catattr{linkcount} attribute
+for the given categories. If the optional argument is
+present, it also sets the \catattr{linkcountmaster} attribute.
+
+When enabled, the \idx{glslike} and \idx{glstextlike} commands
+will increment the associated counter using
+\cmddef{glsxtrinclinkcounter}
+This just does
+\code{\gls{stepcounter}\margm{counter}} by default but if you
+need \gls{refstepcounter} instead, just redefine this command:
+\begin{codebox}
+\gls{renewcommand}*\marg{\gls{glsxtrinclinkcounter}}[1]\marg{\gls{refstepcounter}\marg{\#1}}
+\end{codebox}
+
+You can access the internal count register using:
+\cmddef{GlsXtrLinkCounterValue}
+where \meta{label} is the entry's label. This will expand
+to 0 if the register hasn't been defined.
+
+It's also possible to access the display value
+(\gls{thecounter}) using
+\cmddef{GlsXtrTheLinkCounter}
+(This will expand to 0 if the counter hasn't been defined.)
\begin{important}
-If you use one of the \ics{textsc} styles, be aware that the default
-fonts don't provide bold small-caps or italic small-caps. This
-means that if the chapter or section title style uses bold, this
-may override the small-caps setting, in which case the abbreviation
-will just appear as lower case bold. If the heading style uses
-italic, the abbreviation may appear in upright small-caps,
-\emph{even if you have set the \catattr{headuc} attribute} since
-the all-capitals form still uses \cs{glsabbrvfont}.
-You may want to consider using the \sty{slantsc} package in this
-case.
+In order to conserve resources, the counter is only defined
+when it first needs to be incremented so terms that have
+been defined but haven't been used in the document
+won't have the associated count register allocated.
\end{important}
-Display the short form:
-\begin{definition}[\DescribeMacro\glsfmtshort]
-\cs{glsfmtshort}\marg{label}
-\end{definition}
-
-Display the plural short form:
-\begin{definition}[\DescribeMacro\glsfmtshortpl]
-\cs{glsfmtshortpl}\marg{label}
-\end{definition}
-
-First letter upper case singular short form:
-\begin{definition}[\DescribeMacro\Glsfmtshort]
-\cs{Glsfmtshort}\marg{label}
-\end{definition}
-(No case-change applied to PDF bookmarks.)
-
-First letter upper case plural short form:
-\begin{definition}[\DescribeMacro\Glsfmtshortpl]
-\cs{Glsfmtshortpl}\marg{label}
-\end{definition}
-(No case-change applied to PDF bookmarks.)
-
-All caps singular short form:
-\begin{definition}[\DescribeMacro\GLSfmtshort]
-\cs{GLSfmtshort}\marg{label}
-\end{definition}
-(No case-change applied to PDF bookmarks.)
-
-All caps plural short form:
-\begin{definition}[\DescribeMacro\Glsfmtshortpl]
-\cs{Glsfmtshortpl}\marg{label}
-\end{definition}
-(No case-change applied to PDF bookmarks.)
-
-Display the long form:
-\begin{definition}[\DescribeMacro\glsfmtlong]
-\cs{glsfmtlong}\marg{label}
-\end{definition}
-
-Display the plural long form:
-\begin{definition}[\DescribeMacro\glsfmtlongpl]
-\cs{glsfmtlongpl}\marg{label}
-\end{definition}
-
-First letter upper case singular long form:
-\begin{definition}[\DescribeMacro\Glsfmtlong]
-\cs{Glsfmtlong}\marg{label}
-\end{definition}
-(No case-change applied to PDF bookmarks.)
-
-First letter upper case plural long form:
-\begin{definition}[\DescribeMacro\Glsfmtlongpl]
-\cs{Glsfmtlongpl}\marg{label}
-\end{definition}
-(No case-change applied to PDF bookmarks.)
-
-All caps singular long form:
-\begin{definition}[\DescribeMacro\GLSfmtlong]
-\cs{GLSfmtlong}\marg{label}
-\end{definition}
-(No case-change applied to PDF bookmarks.)
-
-All caps plural long form:
-\begin{definition}[\DescribeMacro\GLSfmtlongpl]
-\cs{GLSfmtlongpl}\marg{label}
-\end{definition}
-(No case-change applied to PDF bookmarks.)
-
-There are similar commands for the full form, but note that these
-use the \emph{inline} full form, which may be different from the
-full form used by \cs{gls}. The PDF version has to be a simple
-fully expandable command, so one of two commands that are unrelated to the style
-is used instead:
-\begin{definition}[\DescribeMacro\glspdffmtfull]
-\cs{glspdffmtfull}\marg{label}
-\end{definition}
-for the singular form or:
-\begin{definition}[\DescribeMacro\glspdffmtfullpl]
-\cs{glspdffmtfullpl}\marg{label}
-\end{definition}
-for the full form. These simply do the long form followed by the
-short form in parentheses.
-
-Display the full form:
-\begin{definition}[\DescribeMacro\glsfmtfull]
-\cs{glsfmtfull}\marg{label}
-\end{definition}
-
-Display the plural full form:
-\begin{definition}[\DescribeMacro\glsfmtfullpl]
-\cs{glsfmtfullpl}\marg{label}
-\end{definition}
-
-First letter upper case singular full form:
-\begin{definition}[\DescribeMacro\Glsfmtfull]
-\cs{Glsfmtfull}\marg{label}
-\end{definition}
-(No case-change applied to PDF bookmarks.)
-
-First letter upper case plural full form:
-\begin{definition}[\DescribeMacro\Glsfmtfullpl]
-\cs{Glsfmtfullpl}\marg{label}
-\end{definition}
-(No case-change applied to PDF bookmarks.)
-
-All caps singular full form:
-\begin{definition}[\DescribeMacro\GLSfmtfull]
-\cs{GLSfmtfull}\marg{label}
-\end{definition}
-(No case-change applied to PDF bookmarks.)
-
-All caps plural full form:
-\begin{definition}[\DescribeMacro\GLSfmtfullpl]
-\cs{GLSfmtfullpl}\marg{label}
-\end{definition}
-(No case-change applied to PDF bookmarks.)
-
-There are also equivalent commands for the value of the
-\gloskey{text} field:
-\begin{definition}[\DescribeMacro\glsfmttext]
-\cs{glsfmttext}\marg{label}
-\end{definition}
-
-First letter converted to upper case:
-\begin{definition}[\DescribeMacro\Glsfmttext]
-\cs{Glsfmttext}\marg{label}
-\end{definition}
-(No case-change applied to PDF bookmarks.)
-
-All caps:
-\begin{definition}[\DescribeMacro\GLSfmttext]
-\cs{GLSfmttext}\marg{label}
-\end{definition}
-(No case-change applied to PDF bookmarks.)
-
-The plural equivalents:
-\begin{definition}[\DescribeMacro\glsfmtplural]
-\cs{glsfmtplural}\marg{label}
-\end{definition}
-First letter upper case:
-\begin{definition}[\DescribeMacro\Glsfmtplural]
-\cs{Glsfmtplural}\marg{label}
-\end{definition}
-and all caps:
-\begin{definition}[\DescribeMacro\GLSfmtplural]
-\cs{GLSfmtplural}\marg{label}
-\end{definition}
-
-Likewise for the value of the
-\gloskey{name} field:
-\begin{definition}[\DescribeMacro\glsfmtname]
-\cs{glsfmtname}\marg{label}
-\end{definition}
-
-First letter converted to upper case:
-\begin{definition}[\DescribeMacro\Glsfmtname]
-\cs{Glsfmtname}\marg{label}
-\end{definition}
-(No case-change applied to PDF bookmarks.)
-
-All caps:
-\begin{definition}[\DescribeMacro\GLSfmtname]
-\cs{GLSfmtname}\marg{label}
-\end{definition}
-(No case-change applied to PDF bookmarks.)
-
-Similarly for the value of the
-\gloskey{first} field:
-\begin{definition}[\DescribeMacro\glsfmtfirst]
-\cs{glsfmtfirst}\marg{label}
-\end{definition}
-
-First letter converted to upper case:
-\begin{definition}[\DescribeMacro\Glsfmtfirst]
-\cs{Glsfmtfirst}\marg{label}
-\end{definition}
-(No case-change applied to PDF bookmarks.)
-
-All caps:
-\begin{definition}[\DescribeMacro\GLSfmtfirst]
-\cs{GLSfmtfirst}\marg{label}
-\end{definition}
-(No case-change applied to PDF bookmarks.)
-
-The plural equivalents:
-\begin{definition}[\DescribeMacro\glsfmtfirstpl]
-\cs{glsfmtfirstpl}\marg{label}
-\end{definition}
-First letter upper case:
-\begin{definition}[\DescribeMacro\Glsfmtfirstpl]
-\cs{Glsfmtfirstpl}\marg{label}
-\end{definition}
-and all caps:
-\begin{definition}[\DescribeMacro\GLSfmtfirstpl]
-\cs{GLSfmtfirstpl}\marg{label}
-\end{definition}
+You can test if the counter has been defined using:
+\cmddef{GlsXtrIfLinkCounterDef}
+This expands to \meta{true} if the link counter associated with the
+entry identified by \meta{entry-label} has been defined, otherwise
+expands to \meta{false}.
+
+The counter name can be obtained using
+\cmddef{GlsXtrLinkCounterName}
+This simply expands to the counter name associated with the
+entry given by \meta{entry-label} without any check for
+existence. For example, to change the display command
+(\gls{thecounter}) using \sty{etoolbox}:
+\begin{codebox}
+\gls{csdef}\marg{the\gls{GlsXtrLinkCounterName}\marg{duck}}\%
+ \marg{\gls{Roman}\marg{\gls{GlsXtrLinkCounterName}\marg{duck}}}
+\end{codebox}
+
+This is useful if you just want to change the display for
+specific entries but isn't convenient if you want to change the
+display for all entries. Instead, it's simpler to redefine
+\gls{GlsXtrTheLinkCounter}. For example:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{GlsXtrTheLinkCounter}}[1]\marg{\%
+ \gls{GlsXtrIfLinkCounterDef}\marg{\#1}\%
+ \marg{\gls{Roman}\marg{\gls{GlsXtrLinkCounterName}\marg{\#1}}}\%
+ \marg{0}\%
+}
+\end{codebox}
+In both cases, the redefinition should be implemented
+after \gls{GlsXtrEnableLinkCounting}.
+
+Here's an example document that uses link counting to disable
+the hyperlink after the first reference. This redefines
+\gls{glslinkpresetkeys} (which is used by both \gls{gls}
+and \gls{glstext}) instead of
+\gls{glslinkcheckfirsthyperhook} (which is used by \gls{gls}
+but not by \gls{glstext}).
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\codepar
+\cmd{usepackage}[colorlinks]\marg{hyperref}
+\cmd{usepackage}\marg{glossaries-extra}
+\codepar
+\gls{makeglossaries}
+\codepar
+\cmd{renewcommand}*\marg{\gls{glslinkpresetkeys}}\marg{\%
+ \cmd{ifnum}\gls{GlsXtrLinkCounterValue}\marg{\gls{glslabel}}>1
+ \gls{setupglslink}\marg{\glsoptval{hyper}{false}}\%
+ \cmd{fi}
+}
+\codepar
+\gls{GlsXtrEnableLinkCounting}\marg{\cat{general}}
+\codepar
+\gls{newglossaryentry}\marg{sample1}\marg{\gloskeyval{name}{sample1},\gloskeyval{description}{an example}}
+\gls{newglossaryentry}\marg{sample2}\marg{\gloskeyval{name}{sample2},\gloskeyval{description}{another example}}
+\codepar
+\gls{newabbreviation}\marg{ex}\marg{ex}\marg{example}
+\codepar
+\cbeg{document}
+\cmd{section}\marg{Sample Section}
+\codepar
+\gls{Gls}\marg{sample1}, \gls{gls}\marg{sample2} and \gls{gls}\marg{ex}.
+\gls{Glstext}\marg{sample1} and \gls{gls}\marg{ex} again.
+\codepar
+\cmd{section}\marg{Another Sample Section}
+\codepar
+\gls{Gls}\marg{sample1}, \gls{gls}\marg{sample2} and \gls{gls}\marg{ex}.
+\codepar
+\gls{printglossaries}
+\cend{document}
+\end{codebox}
+The use of \gls{glslinkpresetkeys}
+means that the options can override this. For example
+\begin{codebox}
+\gls{gls}\oarg{\glsoptval{hyper}{true}}\marg{sample1}
+\end{codebox}
+(or simply \code{\gls{gls}+\marg{sample1}})
+will override the \glsoptval{hyper}{false} setting in
+\gls{glslinkpresetkeys}. If \gls{glslinkpostsetkeys} is used
+instead, the \glsoptval{hyper}{false} setting will override
+the setting provided in the optional argument.
+The resulting document is shown below:
+\begin{resultbox}
+\createexample*[arara={pdflatex,makeglossaries,pdflatex,pdfcrop},
+ label={ex:linkcount},
+ title={Link counting used to selectively suppress hyperlinks},
+description={Example document that uses link counting to selectively suppress
+hyperlinks}]
+{%
+\cmd{usepackage}[colorlinks]\marg{hyperref}^^J%
+\cmd{usepackage}\marg{glossaries-extra}
+\codepar
+\gls{makeglossaries}
+\codepar
+\cmd{renewcommand}*\marg{\gls{glslinkpresetkeys}}\marg{\%^^J
+ \cmd{ifnum}\gls{GlsXtrLinkCounterValue}\marg{\gls{glslabel}}>1^^J
+ \gls{setupglslink}\marg{hyper=false}\%^^J%
+ \cmd{fi}
+}
+\codepar
+\gls{GlsXtrEnableLinkCounting}\marg{general}
+\codepar
+\gls{newglossaryentry}\marg{sample1}\marg{\gloskeyval{name}{sample1},\gloskeyval{description}{an
+example}}^^J%
+\gls{newglossaryentry}\marg{sample2}\marg{\gloskeyval{name}{sample2},\gloskeyval{description}{another example}}
+\codepar
+\gls{newabbreviation}\marg{ex}\marg{ex}\marg{example}
+\codepar
+}
+{\cmd{section}\marg{Sample Section}^^J%
+\codepar
+\gls{Gls}\marg{sample1}, \gls{gls}\marg{sample2} and \gls{gls}\marg{ex}.^^J%
+\gls{Glstext}\marg{sample1} and \gls{gls}\marg{ex} again.^^J%
+\codepar
+\cmd{section}\marg{Another Sample Section}^^J%
+\codepar
+\gls{Gls}\marg{sample1}, \gls{gls}\marg{sample2} and \gls{gls}\marg{ex}.^^J%
+\codepar
+\gls{printglossaries}
+}
+\end{resultbox}
+
+The \cat{abbreviation} category doesn't have the
+\catattr{linkcount} attribute set (since it's not
+listed in the argument of \gls{GlsXtrEnableLinkCounting}). This means that
+\gls{GlsXtrLinkCounterValue}
+always expands to 0 for the abbreviation (\code{ex}), so the
+inequality test:
+\begin{codebox}
+\cmd{ifnum}\gls{GlsXtrLinkCounterValue}\marg{\gls{glslabel}}>1
+\end{codebox}
+will always be false. This means that the abbreviation won't
+have \glsoptval{hyper}{false} applied. If the test is changed to
+\begin{codebox}
+\cmd{ifnum}\gls{GlsXtrLinkCounterValue}\marg{\gls{glslabel}}=1
+\cmd{else}
+ \gls{setupglslink}\marg{\glsoptval{hyper}{false}}\%
+\cmd{fi}
+\end{codebox}
+Then the abbreviation will always have \glsoptval{hyper}{false}
+applied.
+
+To reset the counter every section use the optional argument to set
+the parent counter:
+\begin{codebox}
+\gls{GlsXtrEnableLinkCounting}\oarg{section}\marg{\cat{general}}
+\end{codebox}
+
\chapter{Multi (or Compound) Entries}
\label{sec:multientries}
@@ -7662,159 +33405,152 @@ genus (for example, \emph{Clostridium}) and the species
(for example, \emph{botulinum} or \emph{perfringens}). The genus is
often abbreviated after \gls{firstuse}. For example, \emph{C.
botulinum}. However, if the name is defined as a single term
-consisting of both the genus and species then it's not possible to
+consisting of both the genus and species then it's not possible to
apply the abbreviation when a different species with the same genus
is used.
-
Consider the following document:
-\begin{verbatim}
-\documentclass{article}
-\usepackage{glossaries-extra}
-\setabbreviationstyle{long-only-short-only}
-\newabbreviation{cbot}{C. botulinum}{Clostridium botulinum}
-\newabbreviation{cperf}{C. perfringens}{Clostridium perfringens}
-\begin{document}
-\gls{cbot}, \gls{cbot}, \gls{cperf}.
-\end{document}
-\end{verbatim}
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\cmd{usepackage}\marg{glossaries-extra}
+\gls{setabbreviationstyle}\marg{\abbrstyle{long-only-short-only}}
+\gls{newabbreviation}\marg{cbot}\marg{C. botulinum}\marg{Clostridium botulinum}
+\gls{newabbreviation}\marg{cperf}\marg{C. perfringens}\marg{Clostridium perfringens}
+\cbeg{document}
+\gls{gls}\marg{cbot}, \gls{gls}\marg{cbot}, \gls{gls}\marg{cperf}.
+\cend{document}
+\end{codebox}
The result is:
-\begin{display}
+\begin{resultbox}
Clostridium botulinum, C. botulinum, Clostridium perfringens.
-\end{display}
+\end{resultbox}
However, it should more typically be:
-\begin{display}
+\begin{resultbox}
Clostridium botulinum, C. botulinum, C. perfringens.
-\end{display}
+\end{resultbox}
In this case, the genus should actually be a separate definition:
-\begin{verbatim}
-\documentclass{article}
-\usepackage{glossaries-extra}
-\setabbreviationstyle{long-only-short-only}
-\newabbreviation{clostridium}{C.}{Clostridium}
-\newglossaryentry{botulinum}{name={botulinum},description={}}
-\newglossaryentry{perfringens}{name=perfringens,description={}}
-\begin{document}
-\gls{clostridium} \gls{botulinum},
-\gls{clostridium} \gls{botulinum},
-\gls{clostridium} \gls{perfringens}.
-\end{document}
-\end{verbatim}
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\cmd{usepackage}\marg{glossaries-extra}
+\gls{setabbreviationstyle}\marg{\abbrstyle{long-only-short-only}}
+\gls{newabbreviation}\marg{clostridium}\marg{C.}\marg{Clostridium}
+\gls{newglossaryentry}\marg{botulinum}\marg{\gloskeyval{name}{botulinum},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{perfringens}\marg{\gloskeyval{name}{perfringens},\gloskeyval{description}{}}
+\cbeg{document}
+\gls{gls}\marg{clostridium} \gls{gls}\marg{botulinum},
+\gls{gls}\marg{clostridium} \gls{gls}\marg{botulinum},
+\gls{gls}\marg{clostridium} \gls{gls}\marg{perfringens}.
+\cend{document}
+\end{codebox}
+
This is quite awkward to write. This chapter describes how to
provide a shortcut for this kind of construct. Each term should be
defined as normal (as in the above example), and a \qt{multi-entry}
label is then defined with the list of labels of the entries that
-need to be referenced. This is done with the command:
-\begin{definition}[\DescribeMacro\multiglossaryentry]
-\cs{multiglossaryentry}\oarg{options}\marg{multi-label}\oarg{main
-label}\marg{label list}
-\end{definition}
-where \meta{multi-label} is the new label and \meta{label list} is
-the list of labels (corresponding to entries that have already been
-defined).
-
-The \meta{main label} may be omitted, in which case the
-main label will be assumed to be the final element in \meta{label
-list}. If \meta{main label} is present, it must
-also be listed in \meta{label list}. This is described in more
-detail in \sectionref{sec:mglsmain}.
+need to be referenced.
+
+\cmddef{multiglossaryentry}
+This defines a multi-entry set with the label
+\meta{multi-label}, consisting of the entries whose labels are
+listed in \meta{entry-label-list}, where the main entry (which must be
+present in \meta{entry-label-list}) is identified by \meta{main-label}.
+If \meta{main-label} is omitted, it's assumed to be the final label
+in \meta{entry-label-list}. The main entry is described in more detail in
+\sectionref{sec:mglsmain}.
+
+\begin{important}
+The entries in \meta{entry-label-list} must already be defined (using
+commands like \gls{newglossaryentry} or \gls{newabbreviation}).
+\end{important}
The \meta{options} are a comma-separated list of options to override
the current settings and are described in \sectionref{sec:multiglsoptions}.
The earlier example can now be modified to include the following:
-\begin{verbatim}
-\multiglossaryentry{cbot}{clostridium,botulinum}
-\multiglossaryentry{cperf}{clostridium,perfringens}
-\end{verbatim}
-These commands must come after the definitions of \texttt{clostridium},
-\texttt{botulinum} and \texttt{perfringens}.
-
-Once defined, a multi-entry set can be referenced using commands like:
-\begin{definition}[\DescribeMacro\mgls]
-\cs{mgls}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-This command essentially does \cs{gls}\marg{label} for each item in
+\begin{codebox}
+\gls{multiglossaryentry}\marg{cbot}\marg{clostridium,botulinum}
+\gls{multiglossaryentry}\marg{cperf}\marg{clostridium,perfringens}
+\end{codebox}
+These commands must come after the \code{clostridium},
+\code{botulinum} and \code{perfringens} definitions.
+
+Once defined, a multi-entry set can be referenced in the document using commands like:
+\cmddef{mgls}
+This command essentially does \code{\gls{gls}\margm{label}} for each item in
the \meta{label list} (with separators, see
\sectionref{sec:mglssep}). If the final optional argument
\meta{insert} is provided, it will be applied to the final
(non-skipped) element in the list. So the document body in the
above example, can be rewritten as:
-\begin{verbatim}
-\mgls{cbot}, \mgls{cbot}, \mgls{cperf}.
-\end{verbatim}
+\begin{codebox}
+\gls{mgls}\marg{cbot}, \gls{mgls}\marg{cbot}, \gls{mgls}\marg{cperf}.
+\end{codebox}
-There are some variants of \cs{mgls} listed in \sectionref{sec:mglslike}.
+There are some variants of \gls{mgls} listed in \sectionref{sec:mglslike}.
The available \meta{options} are listed in \sectionref{sec:mglsopts}. They are
-applied after the \cs{multiglossaryentry} options and will override
+applied after the \gls{multiglossaryentry} options and will override
settings for the individual entries.
\begin{important}
-You can't use \meta{multi-label} in commands like \cs{gls}
+You can't use \meta{multi-label} in commands like \gls{gls}
as this label represents a set of entry labels not a single entry.
\end{important}
-The \cs{multiglossaryentry} command will generate an error if the label has already
-been defined as a multi-entry. To do nothing if a multi-entry already exists,
-use:
-\begin{definition}[\DescribeMacro\providemultiglossaryentry]
-\cs{providemultiglossaryentry}\oarg{options}\marg{multi-label}\oarg{main
-label}\marg{label list}
-\end{definition}
-Notes and associated commands applying to \cs{multiglossaryentry}
-also apply to \cs{providemultiglossaryentry} unless otherwise
-stated.
+The \gls{multiglossaryentry} command will generate an error if the label has already
+been defined as a multi-entry.
+
+\cmddef{providemultiglossaryentry}
+This does nothing if a multi-entry set with the given label has
+already been defined otherwise it will act like
+\gls{multiglossaryentry}. Notes and associated commands applying to
+\gls{multiglossaryentry} also apply to
+\gls{providemultiglossaryentry} unless otherwise stated.
\begin{important}
-\cs{multiglossaryentry} may be placed anywhere after the \meta{label
-list} entries have been defined. A multi-entry label can't be
-referenced (with commands like \cs{mgls}) before it has been defined.
+\gls{multiglossaryentry} may be placed anywhere after the entries
+listed in \meta{label list} have been defined. A multi-entry label can't be
+referenced (with commands like \gls{mgls}) before it has been defined.
\end{important}
-There is limited support for \pkgopt[true]{docdef}. The multi-entry
-definition can be picked up from the \filetype{aux} file on the next
+There is limited support for \optval{docdef}{true}. The multi-entry
+definition can be picked up from the \ext{aux} file on the next
run to allow cross-references in any glossaries that occur at the
start of the document. Any changes made with commands like
-\cs{mglsSetMain} won't be carried over to the next run.
+\gls{mglsSetMain} won't be carried over to the next run.
-By default \cs{multiglossaryentry} will be localised to the current scope.
+By default \gls{multiglossaryentry} will be localised to the current scope.
If you want to globally define a multi-entry you need to first
switch on global definitions with:
-\begin{definition}[\DescribeMacro\multiglossaryentryglobaltrue]
-\cs{multiglossaryentryglobaltrue}
-\end{definition}
+\cmddef{multiglossaryentryglobaltrue}
To switch back to local definitions use:
-\begin{definition}[\DescribeMacro\multiglossaryentryglobalfalse]
-\cs{multiglossaryentryglobalfalse}
-\end{definition}
+\cmddef{multiglossaryentryglobalfalse}
+You can test if this setting is on with:
+\cmddef{ifmultiglossaryentryglobal}
If you want to change the multi-entry options (locally) you can use:
-\begin{definition}[\DescribeMacro\mglsSetOptions]
-\cs{mglsSetOptions}\marg{multi-label}\marg{new-options}
-\end{definition}
-This removes the original options. If you want to (locally) append to the
+\cmddef{mglsSetOptions}
+This removes the original options and replaces them with
+\meta{new-options}. If you want to (locally) append to the
existing options, use:
-\begin{definition}[\DescribeMacro\mglsSetOptions]
-\cs{mglsAddOptions}\marg{multi-label}\marg{new-options}
-\end{definition}
+\cmddef{mglsAddOptions}
-Note that \cs{multiglossaryentry} doesn't make any adjustments to
+Note that \gls{multiglossaryentry} doesn't make any adjustments to
the component entries. You will need to use the \gloskey{parent} key
when you define the entries if you want a hierarchical structure in
-your glossary. (See the example in \sectionref{sec:mglsexhier}.)
+your \idx{glossary}. (See the example in \sectionref{sec:mglsexhier}.)
If you don't want the other elements in the glossary, you can
-suppress the indexing with \optfmt{indexothers=false}
+suppress the indexing with \mglsoptval{indexothers}{false}
(\sectionref{sec:multiglsoptionsindexing}) or put them in an ignored
glossary. For example:
-\begin{verbatim}
-\newignoredglossary{common}
-\newabbreviation[type=common]{clostridium}{C.}{Clostridium}
-\end{verbatim}
+\begin{codebox}
+\gls{newignoredglossary}\marg{common}
+\gls{newabbreviation}\oarg{\gloskeyval{type}{common}}\marg{clostridium}\marg{C.}\marg{Clostridium}
+\end{codebox}
-The \meta{multi-label} can't be used in commands like \cs{gls} since
+The \meta{multi-label} can't be used in commands like \gls{gls} since
the label refers to a set of entry labels not to an individual
entry. Similarly, an individual entry label can't be used in
-commands like \cs{mgls}. It is possible (although potentially
+commands like \gls{mgls}. It is possible (although potentially
confusing) to use the same label for a multi-entry as for an
individual entry (see the example in
\sectionref{sec:exskippostlink}). Context will determine which is
@@ -7825,27 +33561,25 @@ multi-entry label.
If you don't want to have to keep track of which labels refer to
multi-entries and which refer to individual entries you can use:
-\begin{definition}[\DescribeMacro\GlsXtrMglsOrGls]
-\cs{GlsXtrMglsOrGls}\marg{mgls cs}\marg{gls
-cs}\meta{modifier}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-where \meta{mgls cs} is the \cs{mgls}-like command to use if
+\cmddef{GlsXtrMglsOrGls}
+where \meta{mgls cs} is the \gls{mgls}-like command to use if
\meta{label} has been defined as a multi-entry and \meta{gls cs} is
-the \cs{gls}-like command to use otherwise. The \meta{modifier} may
-be omitted, otherwise it is the modifier that may be used with
-\cs{mgls} or \cs{gls} (\texttt{*}, \texttt{+} or the character
-identified with \ics{GlsXtrSetAltModifier}). The modifier and remaining
-options are passed to the relevant command (\meta{mgls cs} or
-\meta{gls cs}).
+the \idx{glslike} or \idx{glstextlike} command to use otherwise.
+The \meta{modifier} may be omitted, otherwise it's the modifier
+that may be used with \gls{mgls} or \gls{gls} (asterisk \code{*},
+plus \code{+} or the token identified with \gls{GlsXtrSetAltModifier}). The
+modifier and remaining options are passed to the relevant command
+(\meta{mgls cs} or \meta{gls cs}).
You may prefer to define your own shortcut commands for common
-combinations. For example:
-\begin{verbatim}
-\newcommand{\ac}{\GlsXtrMglsOrGls{\mgls}{\gls}}
-\newcommand{\acpl}{\GlsXtrMglsOrGls{\mglsmainpl}{\glspl}}
-\newcommand{\Ac}{\GlsXtrMglsOrGls{\Mgls}{\Gls}}
-\newcommand{\Acpl}{\GlsXtrMglsOrGls{\Mglsmainpl}{\Glspl}}
-\end{verbatim}
+combinations. For example, (assuming these commands haven't already
+been defined by the \opt{shortcuts} option):
+\begin{codebox}
+\cmd{newcommand}\marg{\gls{ac}}\marg{\gls{GlsXtrMglsOrGls}\marg{\gls{mgls}}\marg{\gls{gls}}}
+\cmd{newcommand}\marg{\gls{acp}}\marg{\gls{GlsXtrMglsOrGls}\marg{\gls{mglsmainpl}}\marg{\gls{glspl}}}
+\cmd{newcommand}\marg{\gls{Ac}}\marg{\gls{GlsXtrMglsOrGls}\marg{\gls{Mgls}}\marg{\gls{Gls}}}
+\cmd{newcommand}\marg{\gls{Acp}}\marg{\gls{GlsXtrMglsOrGls}\marg{\gls{Mglsmainpl}}\marg{\gls{Glspl}}}
+\end{codebox}
\section{Examples}
\label{sec:mglsexamples}
@@ -7856,865 +33590,1101 @@ combinations. For example:
Bacteria names are represented by the genus (for example,
Clostridium) followed by the species (for example, botulinum).
This example has the genus as a parent of the species.
-\begin{verbatim}
-\documentclass{article}
-
-\usepackage[colorlinks]{hyperref}
-\usepackage[stylemods=bookindex,style=bookindex]{glossaries-extra}
-
-\makeglossaries
-
-\newcommand{\latinname}[1]{\emph{#1}}
-\glssetcategoriesattributes
- {genus,species}{textformat,glossnamefont}{latinname}
-
-\setabbreviationstyle[genus]{long-only-short-only-desc}
-\newabbreviation
- [category=genus,description={}]
- {clostridium}{C.}{Clostridium}
-
-\newglossaryentry{botulinum}{name=botulinum,category=species,
- description={},parent=clostridium}
-\newglossaryentry{perfringens}{name=perfringens,category=species,
- description={},parent=clostridium}
-\newglossaryentry{tetani}{name=tetani,category=species,
- description={},parent=clostridium}
-
-\multiglossaryentry{cbot}{clostridium,botulinum}
-\multiglossaryentry{cperf}{clostridium,perfringens}
-\multiglossaryentry{ctet}{clostridium,tetani}
-
-\multiglossaryentrysetup{indexothers=false,hyper=allmain}
-
-\begin{document}
-First use:
-\mgls{cbot}, \mgls{cperf}, \mgls{ctet}.
-
-Next use:
-\mgls{cbot}, \mgls{cperf}, \mgls{ctet}.
-\printglossaries
-\end{document}
-\end{verbatim}
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\codepar
+\cmd{usepackage}[colorlinks]\marg{hyperref}
+\cmd{usepackage}[\optval{stylemods}{bookindex},\optval{style}{\glostyle{bookindex}}]\marg{glossaries-extra}
+\codepar
+\gls{makeglossaries}
+\codepar
+\cmd{newcommand}\marg{\cmd{latinname}}[1]\marg{\cmd{emph}\marg{\#1}}
+\gls{glssetcategoriesattributes}
+ \marg{genus,species}\marg{\catattr{textformat},\catattr{glossnamefont}}\marg{latinname}
+\codepar
+\gls{setabbreviationstyle}\oarg{genus}\marg{\abbrstyle{long-only-short-only-desc}}
+\gls{newabbreviation}
+ \oarg{\gloskeyval{category}{genus},\gloskeyval{description}{}}
+ \marg{clostridium}\marg{C.}\marg{Clostridium}
+\codepar
+\gls{newglossaryentry}\marg{botulinum}\marg{\gloskeyval{name}{botulinum},\gloskeyval{category}{species},
+ \gloskeyval{description}{},\gloskeyval{parent}{clostridium}}
+\gls{newglossaryentry}\marg{perfringens}\marg{\gloskeyval{name}{perfringens},
+ \gloskeyval{category}{species},\gloskeyval{description}{},\gloskeyval{parent}{clostridium}}
+\gls{newglossaryentry}\marg{tetani}\marg{\gloskeyval{name}{tetani},\gloskeyval{category}{species},
+ \gloskeyval{description}{},\gloskeyval{parent}{clostridium}}
+\codepar
+\gls{multiglossaryentry}\marg{cbot}\marg{clostridium,botulinum}
+\gls{multiglossaryentry}\marg{cperf}\marg{clostridium,perfringens}
+\gls{multiglossaryentry}\marg{ctet}\marg{clostridium,tetani}
+\codepar
+\gls{multiglossaryentrysetup}\marg{\mglsoptval{indexothers}{false},\mglsoptval{hyper}{allmain}}
+\codepar
+\cbeg{document}
+First use: \gls{mgls}\marg{cbot}, \gls{mgls}\marg{cperf}, \gls{mgls}\marg{ctet}.
+\codepar
+Next use: \gls{mgls}\marg{cbot}, \gls{mgls}\marg{cperf}, \gls{mgls}\marg{ctet}.
+\gls{printglossaries}
+\cend{document}
+\end{codebox}
This suppresses the indexing of the non-main elements (in this case,
the genus). However the genus is included in the glossary (without a
-\gls{numberlist}) because it's the parent of the species (which are
+\gls{locationlist}) because it's the parent of the species (which are
indexed).
-
-The \optfmt{hyper=allmain} option makes the entire content of each
-\cs{mgls} a hyperlink to the main entry in the glossary. The
-resulting document text (before the glossary) is:
-\begin{quote}
+\begin{resultbox}
+\createexample*[title={Multi-entries: hierarchical},
+ label={ex:multientryhier},
+ description={Example document with hierarchical multi-entries},
+ arara={pdflatex,makeglossaries,pdflatex,pdfcrop}]
+{\cmd{usepackage}[colorlinks]\marg{hyperref}^^J%
+\cmd{usepackage}[stylemods=bookindex,style=bookindex]\marg{glossaries-extra}^^J%
+\codepar
+\gls{makeglossaries}^^J%
+\codepar
+\cmd{newcommand}\marg{\cmd{latinname}}[1]\marg{\cmd{emph}\marg{\#1}}^^J%
+\gls{glssetcategoriesattributes}^^J
+ \marg{genus,species}\marg{textformat,glossnamefont}\marg{latinname}^^J%
+\codepar
+\gls{setabbreviationstyle}\oarg{genus}\marg{long-only-short-only-desc}^^J%
+\gls{newabbreviation}^^J
+ \oarg{\gloskeyval{category}{genus},\gloskeyval{description}{}}^^J
+ \marg{clostridium}\marg{C.}\marg{Clostridium}^^J%
+\codepar
+\gls{newglossaryentry}\marg{botulinum}\marg{\gloskeyval{name}{botulinum},\gloskeyval{category}{species},^^J
+ \gloskeyval{description}{},\gloskeyval{parent}{clostridium}}^^J%
+\gls{newglossaryentry}\marg{perfringens}\marg{\gloskeyval{name}{perfringens},\gloskeyval{category}{species},^^J
+ \gloskeyval{description}{},\gloskeyval{parent}{clostridium}}^^J%
+\gls{newglossaryentry}\marg{tetani}\marg{\gloskeyval{name}{tetani},\gloskeyval{category}{species},^^J
+ \gloskeyval{description}{},\gloskeyval{parent}{clostridium}}^^J%
+\codepar
+\gls{multiglossaryentry}\marg{cbot}\marg{clostridium,botulinum}^^J%
+\gls{multiglossaryentry}\marg{cperf}\marg{clostridium,perfringens}^^J%
+\gls{multiglossaryentry}\marg{ctet}\marg{clostridium,tetani}^^J%
+\codepar
+\gls{multiglossaryentrysetup}\marg{indexothers=false,hyper=allmain}
+}
+{%
First use:
-\emph{Clostridium botulinum}, \emph{C. perfringens}, \emph{C. tetani}.
-
+\gls{mgls}\marg{cbot}, \gls{mgls}\marg{cperf}, \gls{mgls}\marg{ctet}.^^J%
+\codepar
Next use:
-\emph{C. botulinum}, \emph{C. perfringens}, \emph{C. tetani}.
-\end{quote}
+\gls{mgls}\marg{cbot}, \gls{mgls}\marg{cperf}, \gls{mgls}\marg{ctet}.^^J%
+\gls{printglossaries}
+}
+\end{resultbox}
+
+The \mglsoptval{hyper}{allmain} option makes the entire content of each
+\gls{mgls} a hyperlink to the main entry in the glossary.
\subsection{Example: Suffix}
\label{sec:mglsexsuffix}
This example has a minor modification to the previous one. In this
case the multi-entries are defined with a suffix:
-\begin{verbatim}
-\multiglossaryentry[firstsuffix=botulism]{cbot}{clostridium,botulinum}
-\multiglossaryentry[firstsuffix={gas gangrene}]{cperf}{clostridium,perfringens}
-\multiglossaryentry[firstsuffix=tetanus]{ctet}{clostridium,tetani}
-\end{verbatim}
+\begin{codebox}
+\gls{multiglossaryentry}\oarg{\mglsoptval{firstsuffix}{botulism}}\marg{cbot}\marg{clostridium,botulinum}
+\gls{multiglossaryentry}\oarg{\mglsoptval{firstsuffix}{gas gangrene}}\marg{cperf}\marg{clostridium,perfringens}
+\gls{multiglossaryentry}\oarg{\mglsoptval{firstsuffix}{tetanus}}\marg{ctet}\marg{clostridium,tetani}
+\end{codebox}
The rest of the document is as in \sectionref{sec:mglsexhier}.
-The document text is now:
-\begin{quote}
+\begin{resultbox}
+\createexample*[title={Multi-entries: hierarchical with first-use suffix},
+ label={ex:multientryhierfirstusesuffix},
+ description={Example document with hierarchical multi-entries that
+have a first-use suffix},
+ arara={pdflatex,makeglossaries,pdflatex,pdfcrop}]
+{\cmd{usepackage}[colorlinks]\marg{hyperref}^^J%
+\cmd{usepackage}[stylemods=bookindex,style=bookindex]\marg{glossaries-extra}^^J%
+\codepar
+\gls{makeglossaries}^^J%
+\codepar
+\cmd{newcommand}\marg{\cmd{latinname}}[1]\marg{\cmd{emph}\marg{\#1}}^^J%
+\gls{glssetcategoriesattributes}^^J
+ \marg{genus,species}\marg{textformat,glossnamefont}\marg{latinname}^^J%
+\codepar
+\gls{setabbreviationstyle}\oarg{genus}\marg{long-only-short-only-desc}^^J%
+\gls{newabbreviation}^^J
+ \oarg{\gloskeyval{category}{genus},\gloskeyval{description}{}}^^J
+ \marg{clostridium}\marg{C.}\marg{Clostridium}^^J%
+\codepar
+\gls{newglossaryentry}\marg{botulinum}\marg{\gloskeyval{name}{botulinum},\gloskeyval{category}{species},^^J
+ \gloskeyval{description}{},\gloskeyval{parent}{clostridium}}^^J%
+\gls{newglossaryentry}\marg{perfringens}\marg{\gloskeyval{name}{perfringens},\gloskeyval{category}{species},^^J
+ \gloskeyval{description}{},\gloskeyval{parent}{clostridium}}^^J%
+\gls{newglossaryentry}\marg{tetani}\marg{\gloskeyval{name}{tetani},\gloskeyval{category}{species},^^J
+ \gloskeyval{description}{},\gloskeyval{parent}{clostridium}}^^J%
+\codepar
+\gls{multiglossaryentry}\oarg{firstsuffix=botulism}\marg{cbot}\marg{clostridium,botulinum}^^J%
+\gls{multiglossaryentry}\oarg{firstsuffix=gas gangrene}\marg{cperf}\marg{clostridium,perfringens}^^J%
+\gls{multiglossaryentry}\oarg{firstsuffix=tetanus}\marg{ctet}\marg{clostridium,tetani}^^J%
+\codepar
+\gls{multiglossaryentrysetup}\marg{indexothers=false,hyper=allmain}
+}
+{%
First use:
-\emph{Clostridium botulinum} (botulism), \emph{C. perfringens} (gas
-gangrene), \emph{C. tetani} (tetanus).
-
+\gls{mgls}\marg{cbot}, \gls{mgls}\marg{cperf}, \gls{mgls}\marg{ctet}.^^J%
+\codepar
Next use:
-\emph{C. botulinum}, \emph{C. perfringens}, \emph{C. tetani}.
-\end{quote}
+\gls{mgls}\marg{cbot}, \gls{mgls}\marg{cperf}, \gls{mgls}\marg{ctet}.^^J%
+\gls{printglossaries}
+}
+\end{resultbox}
\subsection{Example: Category Suffix}
\label{sec:mglsexcatsuffix}
This is an alternative to the previous example. Instead of storing
-the extra information in the \optfmt{firstsuffix} key, the
+the extra information in the \mglsopt{firstsuffix} key, the
information is stored in the \gloskey{user1} key of the last
element (the species). A category suffix is used to look up the
field and append it.
-\begin{verbatim}
-\newglossaryentry{botulinum}{name=botulinum,category=species,
- user1={botulism},
- description={},parent=clostridium}
-\newglossaryentry{perfringens}{name=perfringens,category=species,
- user1={gas gangrene},
- description={},parent=clostridium}
-\newglossaryentry{tetani}{name=tetani,category=species,
- user1={tetanus},
- description={},parent=clostridium}
-
-\mglsdefcategorysuffix{bacteria}{%
- \mglsisfirstuse
- {\glsxtrifhasfield{useri}{\mglslastelementlabel}{ (\glscurrentfieldvalue)}{}}%
- {}%
-}
-
-\multiglossaryentry[category=bacteria]{cbot}{clostridium,botulinum}
-\multiglossaryentry[category=bacteria]{cperf}{clostridium,perfringens}
-\multiglossaryentry[category=bacteria]{ctet}{clostridium,tetani}
-\end{verbatim}
+\begin{codebox}
+\gls{newglossaryentry}\marg{botulinum}\marg{\gloskeyval{name}{botulinum},\gloskeyval{category}{species},
+ \gloskeyval{user1}{botulism},
+ \gloskeyval{description}{},\gloskeyval{parent}{clostridium}}
+\gls{newglossaryentry}\marg{perfringens}\marg{\gloskeyval{name}{perfringens},\gloskeyval{category}{species},
+ \gloskeyval{user1}{gas gangrene},
+ \gloskeyval{description}{},\gloskeyval{parent}{clostridium}}
+\gls{newglossaryentry}\marg{tetani}\marg{\gloskeyval{name}{tetani},\gloskeyval{category}{species},
+ \gloskeyval{user1}{tetanus},
+ \gloskeyval{description}{},\gloskeyval{parent}{clostridium}}
+\codepar
+\gls{mglsdefcategorysuffix}\marg{bacteria}\marg{\%
+ \gls{mglsisfirstuse}
+ \marg{\gls{glsxtrifhasfield}\marg{useri}\marg{\gls{mglslastelementlabel}}\marg{ (\gls{glscurrentfieldvalue})}{}}\%
+ \marg{}\%
+}
+\codepar
+\gls{multiglossaryentry}\oarg{category=bacteria}\marg{cbot}\marg{clostridium,botulinum}
+\gls{multiglossaryentry}\oarg{category=bacteria}\marg{cperf}\marg{clostridium,perfringens}
+\gls{multiglossaryentry}\oarg{category=bacteria}\marg{ctet}\marg{clostridium,tetani}
+\end{codebox}
The result is the same as the previous example.
+\begin{resultbox}
+\createexample*[title={Multi-entries: hierarchical with category suffix},
+ label={ex:multientryhiercatsuffix},
+ description={Example document with hierarchical multi-entries that
+have a category suffix},
+ arara={pdflatex,makeglossaries,pdflatex,pdfcrop}]
+{\cmd{usepackage}[colorlinks]\marg{hyperref}^^J%
+\cmd{usepackage}[stylemods=bookindex,style=bookindex]\marg{glossaries-extra}^^J%
+\codepar
+\gls{makeglossaries}^^J%
+\codepar
+\cmd{newcommand}\marg{\cmd{latinname}}[1]\marg{\cmd{emph}\marg{\#1}}^^J%
+\gls{glssetcategoriesattributes}^^J
+ \marg{genus,species}\marg{textformat,glossnamefont}\marg{latinname}^^J%
+\codepar
+\gls{setabbreviationstyle}\oarg{genus}\marg{long-only-short-only-desc}^^J%
+\gls{newabbreviation}^^J
+ \oarg{\gloskeyval{category}{genus},\gloskeyval{description}{}}^^J
+ \marg{clostridium}\marg{C.}\marg{Clostridium}^^J%
+\codepar
+\gls{newglossaryentry}\marg{botulinum}\marg{\gloskeyval{name}{botulinum},\gloskeyval{category}{species},^^J
+ \gloskeyval{user1}{botulism},^^J
+ \gloskeyval{description}{},\gloskeyval{parent}{clostridium}}^^J%
+\gls{newglossaryentry}\marg{perfringens}\marg{\gloskeyval{name}{perfringens},\gloskeyval{category}{species},^^J
+ \gloskeyval{user1}{gas gangrene},^^J
+ \gloskeyval{description}{},\gloskeyval{parent}{clostridium}}^^J%
+\gls{newglossaryentry}\marg{tetani}\marg{\gloskeyval{name}{tetani},\gloskeyval{category}{species},^^J
+ \gloskeyval{user1}{tetanus},^^J
+ \gloskeyval{description}{},\gloskeyval{parent}{clostridium}}^^J%
+\codepar
+\gls{mglsdefcategorysuffix}\marg{bacteria}\marg{\%^^J%
+ \gls{mglsisfirstuse}^^J
+ \marg{\gls{glsxtrifhasfield}\marg{useri}\marg{\gls{mglslastelementlabel}}\marg{ (\gls{glscurrentfieldvalue})}{}}\%^^J
+ \marg{}\%^^J%
+}
+\codepar
+\gls{multiglossaryentry}\oarg{category=bacteria}\marg{cbot}\marg{clostridium,botulinum}^^J%
+\gls{multiglossaryentry}\oarg{category=bacteria}\marg{cperf}\marg{clostridium,perfringens}^^J%
+\gls{multiglossaryentry}\oarg{category=bacteria}\marg{ctet}\marg{clostridium,tetani}^^J%
+\codepar
+\gls{multiglossaryentrysetup}\marg{indexothers=false,hyper=allmain}
+}
+{%
+First use:
+\gls{mgls}\marg{cbot}, \gls{mgls}\marg{cperf}, \gls{mgls}\marg{ctet}.^^J%
+\codepar
+Next use:
+\gls{mgls}\marg{cbot}, \gls{mgls}\marg{cperf}, \gls{mgls}\marg{ctet}.^^J%
+\gls{printglossaries}
+}
+\end{resultbox}
\subsection{Example: Separators}
\label{sec:mglsexsep}
The first example (\sectionref{sec:mglsexhier}) can be modified so
that the species are also abbreviations. In this case, the
-separators are modified to suppress the space (\cs{relax}) if both the genus and
-species are abbreviated, or to use a non-breaking space \verb|~| between
+separators are modified to suppress the space (\gls{relax}) if both the genus and
+species are abbreviated, or to use a \idx{nbsp} between
the genus short form (shown on subsequent use) and the species long
-form (shown on first use). If the genus is showing the long form
-(first use) then a normal space is used.
+form (shown on \idx{firstuse}). If the genus is showing the long form
+(\idx{firstuse}) then a normal space is used.
Note that the separator attributes apply to the category of the
element before the separator (not to the multi-entry category).
-\begin{verbatim}
-\glssetcategoryattribute{genus}{combinedfirstsepfirst}{\space}
-\glssetcategoryattribute{genus}{combinedfirstsep}{\space}
-\glssetcategoryattribute{genus}{combinedsepfirst}{~}
-\glssetcategoryattribute{genus}{combinedsep}{\relax}
-
-\setabbreviationstyle[species]{long-only-short-only-desc}
-
-\newabbreviation[category=species,
- description={},parent=clostridium]{botulinum}{bot.}{botulinum}
-\newabbreviation[category=species,
- description={},parent=clostridium]{perfringens}{per.}{perfringens}
-\newabbreviation[,category=species,
- description={},parent=clostridium]{tetani}{tet.}{tetani}
-\end{verbatim}
+\begin{codebox}
+\gls{glssetcategoryattribute}\marg{genus}\marg{\catattr{combinedfirstsepfirst}}\marg{\cmd{space}}
+\gls{glssetcategoryattribute}\marg{genus}\marg{\catattr{combinedfirstsep}}\marg{\cmd{space}}
+\gls{glssetcategoryattribute}\marg{genus}\marg{\catattr{combinedsepfirst}}\marg{\glssymbol{idx.nbsp}}
+\gls{glssetcategoryattribute}\marg{genus}\marg{\catattr{combinedsep}}\marg{\gls{relax}}
+\codepar
+\gls{setabbreviationstyle}\oarg{species}\marg{\abbrstyle{long-only-short-only-desc}}
+\codepar
+\gls{newabbreviation}\oarg{\gloskeyval{category}{species},
+ \gloskeyval{description}{},\gloskeyval{parent}{clostridium}}\marg{botulinum}\marg{bot.}\marg{botulinum}
+\gls{newabbreviation}\oarg{\gloskeyval{category}{species},
+ \gloskeyval{description}{},\gloskeyval{parent}{clostridium}}\marg{perfringens}\marg{per.}\marg{perfringens}
+\gls{newabbreviation}\oarg{\gloskeyval{category}{species},
+ \gloskeyval{description}{},\gloskeyval{parent}{clostridium}}\marg{tetani}\marg{tet.}\marg{tetani}
+\end{codebox}
This will cause a double dot at the end of the second sentence,
which can be suppressed using the \catattr{discardperiod} and
\catattr{retainfirstuseperiod} attributes.
-\begin{verbatim}
-\glssetcategoriesattributes{species}{discardperiod,retainfirstuseperiod}{true}
-\end{verbatim}
-This works because the final element's post-link hook is transferred
+\begin{codebox}
+\gls{glssetcategoriesattributes}\marg{species}\marg{\catattr{discardperiod},\catattr{retainfirstuseperiod}}\marg{true}
+\end{codebox}
+This works because the final element's \idx{postlinkhook} is transferred
to the multi-entry post-link hook, which can detect the sentence
-terminating period. If the post-link hook settings are changed, for
-example, to \optfmt{postlinks=all,mpostlink=false} then the feature
-won't work as the final element's post-link hook can't detect the
-period (because \cs{gls} is embedded too deeply inside the internal
-workings of \cs{mgls}).
-
-The result is:
-\begin{quote}
-First use: Clostridium botulinum, C.~perfringens, C.~tetani.
-
-Next use: C.bot., C.per., C.tet.
-\end{quote}
+terminating period. If the post-link hook settings are changed, for example, to
+\code{\mglsoptval{postlinks}{all},\mglsoptval{mpostlink}{false}} then the feature
+won't work as the final element's \idx{postlinkhook} can't detect the
+period (because \gls{gls} is embedded too deeply inside the internal
+workings of \gls{mgls}).
+\begin{resultbox}
+\createexample*[title={Multi-entries: separators},
+ label={ex:multientrysep},
+ description={Example document demonstrating multi-entry separators},
+ arara={pdflatex,makeglossaries,pdflatex,pdfcrop}]
+{\cmd{usepackage}[colorlinks]\marg{hyperref}^^J%
+\cmd{usepackage}[stylemods=bookindex,style=bookindex]\marg{glossaries-extra}
+\codepar
+\gls{makeglossaries}
+\codepar
+\cmd{newcommand}\marg{\cmd{latinname}}[1]\marg{\cmd{emph}\marg{\#1}}^^J%
+\gls{glssetcategoriesattributes}^^J
+ \marg{genus,species}\marg{textformat,glossnamefont}\marg{latinname}^^J%
+\codepar
+\% multi-entry category attributes:^^J%
+\gls{glssetcategoryattribute}\marg{genus}\marg{combinedfirstsepfirst}\marg{\cmd{space}}^^J%
+\gls{glssetcategoryattribute}\marg{genus}\marg{combinedfirstsep}\marg{\cmd{space}}^^J%
+\gls{glssetcategoryattribute}\marg{genus}\marg{combinedsepfirst}\marg{\string~}^^J%
+\gls{glssetcategoryattribute}\marg{genus}\marg{combinedsep}\marg{\gls{relax}}^^J%
+\codepar
+\gls{setabbreviationstyle}\oarg{genus}\marg{long-only-short-only-desc}^^J%
+\gls{newabbreviation}^^J
+ \oarg{\gloskeyval{category}{genus},\gloskeyval{description}{}}^^J
+ \marg{clostridium}\marg{C.}\marg{Clostridium}
+\codepar
+\gls{setabbreviationstyle}\oarg{species}\marg{long-only-short-only-desc}^^J%
+\codepar
+\gls{newabbreviation}\oarg{\gloskeyval{category}{species},^^J
+ \gloskeyval{description}{},\gloskeyval{parent}{clostridium}}\marg{botulinum}\marg{bot.}\marg{botulinum}^^J%
+\gls{newabbreviation}\oarg{\gloskeyval{category}{species},^^J
+ \gloskeyval{description}{},\gloskeyval{parent}{clostridium}}\marg{perfringens}\marg{per.}\marg{perfringens}^^J%
+\gls{newabbreviation}\oarg{\gloskeyval{category}{species},^^J
+ \gloskeyval{description}{},\gloskeyval{parent}{clostridium}}\marg{tetani}\marg{tet.}\marg{tetani}^^J%
+\gls{glssetcategoriesattributes}\marg{species}\marg{discardperiod,retainfirstuseperiod}\marg{true}^^J%
+\codepar
+\gls{multiglossaryentry}\marg{cbot}\marg{clostridium,botulinum}^^J%
+\gls{multiglossaryentry}\marg{cperf}\marg{clostridium,perfringens}^^J%
+\gls{multiglossaryentry}\marg{ctet}\marg{clostridium,tetani}^^J%
+\codepar
+\gls{multiglossaryentrysetup}\marg{indexothers=false,hyper=allmain}
+}
+{%
+First use:
+\gls{mgls}\marg{cbot}, \gls{mgls}\marg{cperf}, \gls{mgls}\marg{ctet}.^^J%
+\codepar
+Next use:
+\gls{mgls}\marg{cbot}, \gls{mgls}\marg{cperf}, \gls{mgls}\marg{ctet}.^^J%
+\gls{printglossaries}
+}
+\end{resultbox}
\subsection{Example: Skipping Elements (Fragment Element)}
\label{sec:exskipfirstsuffix}
This example is an alternative way of dealing with nested links
(see \sectionref{sec:nested}).
-\begin{verbatim}
-\documentclass{article}
-
-\usepackage[colorlinks]{hyperref}
-\usepackage[stylemods,style=long]{glossaries-extra}
-
-\makeglossaries
-
-\setabbreviationstyle{long-short-sc}
-\newabbreviation{ssi}{ssi}{server-side includes}
-\newabbreviation{html}{html}{hypertext markup language}
-
-\setabbreviationstyle[combinedabbrv]{long-only-short-sc-only}
-\newabbreviation
- [category=combinedabbrv,
- description={\glsxtrshort{ssi} enabled \glsxtrshort{html}}]
- {shtml-frag}{shtml}{enabled}
-
-\glssetcategoryattribute{combinedabbrv}{multioptions}
- {usedskipothers,firstsuffix={\glsxtrshort{\mglslastmainlabel}}}
-
-\multiglossaryentry
- [category={combinedabbrv}]
- {shtml}[shtml-frag]{ssi,shtml-frag,html}
-
-\begin{document}
-Individual elements first use: \gls{ssi} and \gls{html}.
-
-Individual elements next use: \gls{ssi} and \gls{html}.
-
-Multi-entry first use: \mgls{shtml}.
-
-Multi-entry next use: \mgls{shtml}.
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\codepar
+\cmd{usepackage}[colorlinks]\marg{hyperref}
+\cmd{usepackage}[\opt{stylemods},\optval{style}{\glostyle{long}}]\marg{glossaries-extra}
+\codepar
+\gls{makeglossaries}
+\codepar
+\gls{setabbreviationstyle}\marg{\abbrstyle{long-short-sc}}
+\gls{newabbreviation}\marg{ssi}\marg{ssi}\marg{server-side includes}
+\gls{newabbreviation}\marg{html}\marg{html}\marg{hypertext markup language}
+\codepar
+\gls{setabbreviationstyle}\oarg{combinedabbrv}\marg{\abbrstyle{long-only-short-sc-only}}
+\gls{newabbreviation}
+ \oarg{\gloskeyval{category}{combinedabbrv},
+ \gloskeyval{description}{\gls{glsxtrshort}\marg{ssi} enabled \gls{glsxtrshort}\marg{html}}}
+ \marg{shtml-frag}\marg{shtml}\marg{enabled}
+\codepar
+\gls{glssetcategoryattribute}\marg{combinedabbrv}\marg{multioptions}
+ \marg{\mglsoptval{usedskipothers},\mglsoptval{firstsuffix}{\gls{glsxtrshort}\marg{\gls{mglslastmainlabel}}}}
+\codepar
+\gls{multiglossaryentry}
+ \oarg{\mglsoptval{category}{combinedabbrv}}
+ \marg{shtml}\oarg{shtml-frag}\marg{ssi,shtml-frag,html}
+\codepar
+\cbeg{document}
+Individual elements first use: \gls{gls}\marg{ssi} and \gls{gls}{html}.
+\codepar
+Individual elements next use: \gls{gls}\marg{ssi} and \gls{gls}\marg{html}.
+\codepar
+Multi-entry first use: \gls{mgls}\marg{shtml}.
+\codepar
+Multi-entry next use: \gls{mgls}\marg{shtml}.
+\codepar
+Resetting all\gls{glsresetall}\gls{mglsreset}\marg{shtml}:
+\codepar
+Multi-entry first use: \gls{mgls}\marg{shtml}.
+\codepar
+Multi-entry next use: \gls{mgls}\marg{shtml}.
+\codepar
+Individual elements: \gls{gls}\marg{ssi} and \gls{gls}\marg{html}.
+\gls{printglossaries}
+\cend{document}
+\end{codebox}
-Resetting all\glsresetall\mglsreset{shtml}:
-
-Multi-entry first use: \mgls{shtml}.
-
-Multi-entry next use: \mgls{shtml}.
-
-Individual elements: \gls{ssi} and \gls{html}.
-\printglossaries
-\end{document}
-\end{verbatim}
This uses the \catattr{multioptions} attribute to skip \qt{other}
elements on subsequent use. The problematic abbreviation (SHTML) is
defined as a fragment that simply expands to \qt{enabled} on first
use. Note that the description has to be supplied for the glossary.
+The resulting document is shown below.
+\begin{resultbox}
+\createexample*[title={Multi-entries: skipping elements},
+ label={ex:multientryskip},
+ description={Example document demonstrating multi-entry sets with
+elements skipped},
+ arara={pdflatex,makeglossaries,pdflatex,pdfcrop}]
+{\cmd{usepackage}[colorlinks]\marg{hyperref}
+\cmd{usepackage}[stylemods,style=long]\marg{glossaries-extra}
+\codepar
+\gls{makeglossaries}
+\codepar
+\gls{setabbreviationstyle}\marg{long-short-sc}
+\gls{newabbreviation}\marg{ssi}\marg{ssi}\marg{server-side includes}
+\gls{newabbreviation}\marg{html}\marg{html}\marg{hypertext markup language}
+\codepar
+\gls{setabbreviationstyle}\oarg{combinedabbrv}\marg{long-only-short-sc-only}
+\gls{newabbreviation}
+ \oarg{\gloskeyval{category}{combinedabbrv},
+ \gloskeyval{description}{\gls{glsxtrshort}\marg{ssi} enabled \gls{glsxtrshort}\marg{html}}}
+ \marg{shtml-frag}\marg{shtml}\marg{enabled}
+\codepar
+\gls{glssetcategoryattribute}\marg{combinedabbrv}\marg{multioptions}^^J
+ \marg{usedskipothers,firstsuffix=\marg{\gls{glsxtrshort}\marg{\gls{mglslastmainlabel}}}}^^J%
+\codepar
+\gls{multiglossaryentry}
+ \oarg{category=combinedabbrv}
+ \marg{shtml}\oarg{shtml-frag}\marg{ssi,shtml-frag,html}
+}
+{Individual elements first use: \gls{gls}\marg{ssi} and \gls{gls}{html}.
+\codepar
+Individual elements next use: \gls{gls}\marg{ssi} and \gls{gls}\marg{html}.
+\codepar
+Multi-entry first use: \gls{mgls}\marg{shtml}.
+\codepar
+Multi-entry next use: \gls{mgls}\marg{shtml}.
+\codepar
+Resetting all\gls{glsresetall}\gls{mglsreset}\marg{shtml}:
+\codepar
+Multi-entry first use: \gls{mgls}\marg{shtml}.
+\codepar
+Multi-entry next use: \gls{mgls}\marg{shtml}.
+\codepar
+Individual elements: \gls{gls}\marg{ssi} and \gls{gls}\marg{html}.
+\gls{printglossaries}
+}
+\end{resultbox}
-The above produces (underlining added to mark the hyperlinks):
-\begin{quote}
-Individual elements first use: \uline{server-side includes (\textsc{ssi})} and
-\uline{hypertext markup language (\textsc{html})}.
-
-Individual elements next use: \uline{\textsc{ssi}} and
-\uline{\textsc{html}}.
-
-Multi-entry first use: \uline{\textsc{ssi}} \uline{enabled}
-\uline{\textsc{html}} (\uline{\textsc{shtml}}).
-
-Multi-entry next use: \uline{\textsc{shtml}}.
-
-Resetting all:
-
-Multi-entry first use: \uline{server-side includes (\textsc{ssi})}
-\uline{enabled} \uline{hypertext markup language (\textsc{html})}
-(\uline{\textsc{shtml}}).
-
-Multi-entry next use: \uline{\textsc{shtml}}.
-
-Individual elements: \uline{\textsc{ssi}} and \uline{\textsc{html}}.
-\end{quote}
-The key difference here from the example using \cs{glsps} at the end
+The key difference here from the example using \gls{glsps} at the end
of \sectionref{sec:nested} is that the individual elements hyperlink
-to their respective entries in the glossary on first use of \cs{mgls}.
+to their respective entries in the glossary on first use of \gls{mgls}.
-The problem is that with the \pkgopt{colorlinks} package option,
+The problem is that with the \optfmt{colorlinks} package option,
it's not obvious where the hyperlinks start and end. The suffix (\textsc{shtml})
will hyperlink to the \qt{shtml} entry in the glossary, so the
\qt{enabled} hyperlink is redundant. The simplest fix for this is to
-add \optfmt{hyper=notmainfirst} to the option list, which will prevent
+add \mglsoptval{hyper}{notmainfirst} to the option list, which will prevent
\qt{enabled} from being a hyperlink.
-Another problem occurs where \cs{mgls} is used before the individual elements are
+Another problem occurs where \gls{mgls} is used before the individual elements are
used, which leads to their full expansion with a confusing amount of
parentheses. A simple solution is to use the option
-\optfmt{mglsopts=unsetothers}, which will unset the other (not-main)
-elements first. This can be localised with \optfmt{presetlocal} but
-\cs{gls} will then unset the \gls{firstuseflag} globally, which
+\mglsoptval{mglsopts}{unsetothers}, which will unset the other (not-main)
+elements first. This can be localised with \mglsopt{presetlocal} but
+\gls{gls} will then unset the \idx{firstuseflag} globally, which
means that the other elements won't show the full form when they are
-first used on their on after \cs{mgls}. This can be switched to a
-local unset with \optfmt{others={local}}.
+first used on their on after \gls{mgls}. This can be switched to a
+local unset with \mglsoptval{others}{local}.
The complete set of options are now:
-\begin{verbatim}
-\glssetcategoryattribute{combinedabbrv}{multioptions}
- {%
- hyper=notmainfirst,
- mglsopts={presetlocal,unsetothers,others={local}},
- usedskipothers,
- firstsuffix={\glsxtrshort{\mglslastmainlabel}}
+\begin{codebox}
+\gls{glssetcategoryattribute}\marg{combinedabbrv}\marg{\catattr{multioptions}}
+ \marg{\%
+ \mglsoptval{hyper}{notmainfirst},
+ \mglsoptval{mglsopts}{\mglsopt{presetlocal},\mglsopt{unsetothers},\mglsoptval{others}{local}},
+ \mglsoptval{usedskipothers},
+ \mglsoptval{firstsuffix}\marg{\gls{glsxtrshort}\marg{\gls{mglslastmainlabel}}}
}
-\end{verbatim}
-This now produces (underlining added to mark the hyperlinks):
-\begin{quote}
-Individual elements first use: \uline{server-side includes (\textsc{ssi})} and
-\uline{hypertext markup language (\textsc{html})}.
-
-Individual elements next use: \uline{\textsc{ssi}} and
-\uline{\textsc{html}}.
-
-Multi-entry first use: \uline{\textsc{ssi}} \uline{enabled}
-\uline{\textsc{html}} (\uline{\textsc{shtml}}).
-
-Multi-entry next use: \uline{\textsc{shtml}}.
-
-Resetting all:
-
-Multi-entry first use: \uline{\textsc{ssi}}
-\uline{enabled} \uline{\textsc{html}}
-(\uline{\textsc{shtml}}).
-
-Multi-entry next use: \uline{\textsc{shtml}}.
+\end{codebox}
+\begin{resultbox}
+\createexample*[title={Multi-entries: skipping elements (unsetting
+others)},
+ label={ex:multientryskipunsetothers},
+ description={Example document demonstrating multi-entry sets with
+elements skipped and unset},
+ arara={pdflatex,makeglossaries,pdflatex,pdfcrop}]
+{\cmd{usepackage}[colorlinks]\marg{hyperref}^^J%
+\cmd{usepackage}[stylemods,style=long]\marg{glossaries-extra}
+\codepar
+\gls{makeglossaries}^^J%
+\codepar
+\gls{setabbreviationstyle}\marg{long-short-sc}^^J%
+\gls{newabbreviation}\marg{ssi}\marg{ssi}\marg{server-side
+includes}^^J%
+\gls{newabbreviation}\marg{html}\marg{html}\marg{hypertext markup language}
+\codepar
+\gls{setabbreviationstyle}\oarg{combinedabbrv}\marg{long-only-short-sc-only}^^J%
+\gls{newabbreviation}^^J
+ \oarg{\gloskeyval{category}{combinedabbrv},^^J
+ \gloskeyval{description}{\gls{glsxtrshort}\marg{ssi} enabled
+\gls{glsxtrshort}\marg{html}}}^^J
+ \marg{shtml-frag}\marg{shtml}\marg{enabled}
+\codepar
+\gls{glssetcategoryattribute}\marg{combinedabbrv}\marg{\catattr{multioptions}}^^J
+\marg{\%^^J
+ \mglsoptval{hyper}{notmainfirst},^^J
+ \mglsoptval{mglsopts}{\mglsopt{presetlocal},\mglsopt{unsetothers},\mglsoptval{others}{local}},^^J
+ \mglsoptval{usedskipothers},^^J
+ \mglsoptval{firstsuffix}\marg{\gls{glsxtrshort}\marg{\gls{mglslastmainlabel}}}^^J%
+}^^J%
+\codepar
+\gls{multiglossaryentry}^^J
+ \oarg{category=combinedabbrv}^^J
+ \marg{shtml}\oarg{shtml-frag}\marg{ssi,shtml-frag,html}
+}
+{Individual elements first use: \gls{gls}\marg{ssi} and \gls{gls}{html}.
+\codepar
+Individual elements next use: \gls{gls}\marg{ssi} and \gls{gls}\marg{html}.
+\codepar
+Multi-entry first use: \gls{mgls}\marg{shtml}.
+\codepar
+Multi-entry next use: \gls{mgls}\marg{shtml}.
+\codepar
+Resetting all\gls{glsresetall}\gls{mglsreset}\marg{shtml}:
+\codepar
+Multi-entry first use: \gls{mgls}\marg{shtml}.
+\codepar
+Multi-entry next use: \gls{mgls}\marg{shtml}.
+\codepar
+Individual elements: \gls{gls}\marg{ssi} and
+\gls{gls}\marg{html}.^^J%
+\gls{printglossaries}
+}
+\end{resultbox}
-Individual elements: \uline{server-side includes (\textsc{ssi})}
-and \uline{hypertext markup language (\textsc{html})}.
-\end{quote}
This method still has two main drawbacks: the description must be
added manually and the long form can't be accessed with
-\cs{glsxtrlong}. The next example provides an alternative approach.
+\gls{glsxtrlong}. The next example provides an alternative approach.
\subsection{Example: Skipping Elements (Prefix and Post-Link Hooks)}
\label{sec:exskippostlink}
This is a modified version of the previous example. In this case,
the main element isn't a fragment and also happens to have the same
-label as the multi-entry set. (\verb|\mgls{shtml}| references the
-multi-entry label and \verb|\gls{shtml}| references the individual
+label as the multi-entry set. (\code{\gls{mgls}\marg{shtml}} references the
+multi-entry label and \code{\gls{gls}\marg{shtml}} references the individual
entry.)
In this case, the nested parts are marked up with custom commands:
-\begin{verbatim}
-\newrobustcmd{\combinedpre}[1]{\glsps{#1}}
-\newrobustcmd{\combinedpost}[1]{\glsps{#1}}
+\begin{codebox}
+\cmd{newrobustcmd}\marg{\cmd{combinedpre}}[1]\marg{\gls{glsps}\marg{\#1}}
+\cmd{newrobustcmd}\marg{\cmd{combinedpost}}[1]\marg{\gls{glsps}\marg{\#1}}
+\codepar
+\gls{newabbreviation}\marg{shtml}\marg{shtml}
+\marg{\marg{}\cmd{combinedpre}\marg{ssi} enabled \cmd{combinedpost}\marg{html}}
+\end{codebox}
-\newabbreviation{shtml}{shtml}
-{{}\combinedpre{ssi} enabled \combinedpost{html}}
-\end{verbatim}
This means that it's no longer necessary to manually insert the
description and the long form can be accessed as usual with
-\cs{glsxtrshort}\verb|{shtml}|. Note that it is necessary to define
+\code{\gls{glsxtrshort}\marg{shtml}}. Note that it is necessary to define
the custom commands robustly otherwise they will need to be
protected against premature expansion:
-\begin{verbatim}
-\newcommand{\combinedpre}[1]{\glsps{#1}}
-\newcommand{\combinedpost}[1]{\glsps{#1}}
-
-\newabbreviation{shtml}{shtml}
-{{}\protect\combinedpre{ssi} enabled \protect\combinedpost{html}}
-\end{verbatim}
+\begin{codebox}
+\cmd{newcommand}\marg{\cmd{combinedpre}}[1]\marg{\gls{glsps}\marg{\#1}}
+\cmd{newcommand}\marg{\cmd{combinedpost}}[1]\marg{\gls{glsps}\marg{\#1}}
+\codepar
+\gls{newabbreviation}\marg{shtml}\marg{shtml}
+\marg{\marg{}\gls{protect}\cmd{combinedpre}\marg{ssi} enabled \gls{protect}\cmd{combinedpost}\marg{html}}
+\end{codebox}
In both cases, an initial empty group is added to guard
-against any first letter uppercase commands, such as \cs{Glsxtrlong}.
+against any \idx{sentencecase} commands, such as \gls{Glsxtrlong}.
The abbreviations all use the \abbrstyle{long-postshort-sc-user}
-style, which places the short form in the post-link hook on
-\gls{firstuse}. The \cs{gls} post-link hook for the main element
-can be transferred to the \cs{mgls} post-link using:
-\begin{verbatim}
-mpostlinkelement=main
-\end{verbatim}
+style, which places the short form in the post-link hook on
+\idx{firstuse}. The \gls{gls} \idx{postlinkhook} for the main element
+can be transferred to the \gls{mgls} post-link using:
+\begin{codebox}
+\mglsoptval{mpostlinkelement}{main}
+\end{codebox}
All elements have their individual post-link hooks suppressed by default.
As in the previous example, the other elements can be skipped on
subsequent use:
-\begin{verbatim}
-usedskipothers
-\end{verbatim}
-Within \cs{mgls}, the nested content needs to be suppressed, which
+\begin{codebox}
+\mglsopt{usedskipothers}
+\end{codebox}
+
+Within \gls{mgls}, the nested content needs to be suppressed, which
can be done by redefining the custom commands. This can be done in
-the multi-entry prefix. Since the entire content of \cs{mgls} (except for the
+the multi-entry prefix. Since the entire content of \gls{mgls} (except for the
final multi-entry post-link hook) occurs inside a group, this
redefinition will be localised.
The complete document is as follows:
-\begin{verbatim}
-\documentclass{article}
-
-\usepackage[colorlinks]{hyperref}
-\usepackage[stylemods,style=long]{glossaries-extra}
-
-\makeglossaries
-
-\setabbreviationstyle{long-postshort-sc-user}
-
-\newabbreviation{ssi}{ssi}{server-side includes}
-\newabbreviation{html}{html}{hypertext markup language}
-
-\newrobustcmd{\combinedpre}[1]{\glsps{#1}}
-\newrobustcmd{\combinedpost}[1]{\glsps{#1}}
-
-\newabbreviation{shtml}{shtml}
-{{}\combinedpre{ssi} enabled \combinedpost{html}}
-
-\glssetcategoryattribute{combinedabbrv}{multioptions}
- {%
- mpostlinkelement=main,
- usedskipothers
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\codepar
+\cmd{usepackage}[colorlinks]\marg{hyperref}
+\cmd{usepackage}[\opt{stylemods},\optval{style}{\glostyle{long}}]\marg{glossaries-extra}
+\codepar
+\gls{makeglossaries}
+\codepar
+\gls{setabbreviationstyle}\marg{\abbrstyle{long-postshort-sc-user}}
+\codepar
+\gls{newabbreviation}\marg{ssi}\marg{ssi}\marg{server-side includes}
+\gls{newabbreviation}\marg{html}\marg{html}\marg{hypertext markup language}
+\codepar
+\cmd{newrobustcmd}\marg{\cmd{combinedpre}}[1]\marg{\gls{glsps}\marg{\#1}}
+\cmd{newrobustcmd}\marg{\cmd{combinedpost}}[1]\marg{\gls{glsps}\marg{\#1}}
+\codepar
+\cmd{newabbreviation}\marg{shtml}\marg{shtml}
+\marg{\marg{}\cmd{combinedpre}\marg{ssi} enabled \cmd{combinedpost}\marg{html}}
+\codepar
+\gls{glssetcategoryattribute}\marg{combinedabbrv}\marg{\catattr{multioptions}}
+ \marg{\%
+ \mglsoptval{mpostlinkelement}{main},
+ \mglsopt{usedskipothers}
}
-
-\multiglossaryentry
- [category={combinedabbrv}]
- {shtml}[shtml]{ssi,shtml,html}
-
-\mglsdefcategoryprefix{combinedabbrv}{%
- \renewcommand{\combinedpre}[1]{\ignorespaces}%
- \renewcommand{\combinedpost}[1]{\unskip}%
+\codepar
+\gls{multiglossaryentry}
+ \oarg{\mglsoptval{category}{combinedabbrv}}
+ \marg{shtml}\oarg{shtml}\marg{ssi,shtml,html}
+\codepar
+\gls{mglsdefcategoryprefix}\marg{combinedabbrv}\marg{\%
+ \cmd{renewcommand}\marg{\cmd{combinedpre}}[1]\marg{\cmd{ignorespaces}}\%
+ \cmd{renewcommand}\marg{\cmd{combinedpost}}[1]\marg{\gls{unskip}}\%
}
-
-\begin{document}
-Individual elements first use: \gls{ssi} and \gls{html}.
-
-Individual elements next use: \gls{ssi} and \gls{html}.
-
-Multi-entry first use: \mgls{shtml}.
-
-Multi-entry next use: \mgls{shtml}.
-
-Individual entry first use: \gls{shtml}.
-
-Resetting all\glsresetall\mglsresetall:
-
-Multi-entry first use: \mgls{shtml}.
-
-Multi-entry next use: \mgls{shtml}.
-
-Individual elements: \gls{ssi} and \gls{html}.
-
-Resetting all\glsresetall\mglsresetall:
-
-Individual entry first use: \gls{shtml}.
-
-Multi-entry first use: \mgls{shtml}. (Wrong!)
-
-\printglossaries
-\end{document}
-\end{verbatim}
-This now produces (underlining added to mark the hyperlinks):
-\begin{quote}
-Individual elements first use: \uline{server-side includes}
-(\textsc{ssi}) and \uline{hypertext markup language} (\textsc{html}).
-
-Individual elements next use: \uline{\textsc{ssi}} and
-\uline{\textsc{html}}.
-
-Multi-entry first use: \uline{\textsc{ssi}} \uline{enabled}
-\uline{\textsc{html}} (\textsc{shtml}).
-
-Multi-entry next use: \uline{\textsc{shtml}}.
-
-Individual entry first use: \uline{\textsc{shtml}}.
-
-Resetting all:
-
-Multi-entry first use: \uline{server-side includes} \uline{enabled}
-\uline{hypertext markup language} (\textsc{shtml}).
-
-Multi-entry next use: \uline{\textsc{shtml}}.
-
-Individual elements: \uline{\textsc{ssi}} and \uline{\textsc{html}}.
-
-Resetting all:
-
-Individual entry first use: \uline{\textsc{ssi}} \uline{enabled}
-\uline{\textsc{html}} (\textsc{shtml}).
-
-Multi-entry first use: \uline{server-side includes}
-\uline{\textsc{shtml}} \uline{hypertext markup language}. (Wrong!)
-\end{quote}
-Note the last two paragraphs, which highlights what happens if
-\verb|\gls{shtml}| is used before \verb|\mgls{shtml}| when neither
-of the other elements (\texttt{ssi} and \texttt{html}) have been
-used. The final instance of \cs{mgls} has produced the wrong result.
-This is because it's the first use of the multi-entry \texttt{shtml} but
-not the first use of the individual entry \texttt{shtml}.
+\codepar
+\cbeg{document}
+Individual elements first use: \gls{gls}\marg{ssi} and \gls{gls}\marg{html}.
+\codepar
+Individual elements next use: \gls{gls}\marg{ssi} and \gls{gls}\marg{html}.
+\codepar
+Multi-entry first use: \gls{mgls}\marg{shtml}.
+\codepar
+Multi-entry next use: \gls{mgls}\marg{shtml}.
+\codepar
+Individual entry first use: \gls{gls}\marg{shtml}.
+\codepar
+Resetting all\gls{glsresetall}\gls{mglsresetall}:
+\codepar
+Multi-entry first use: \gls{mgls}\marg{shtml}.
+\codepar
+Multi-entry next use: \gls{mgls}\marg{shtml}.
+\codepar
+Individual elements: \gls{gls}\marg{ssi} and \gls{gls}\marg{html}.
+\codepar
+Resetting all\gls{glsresetall}\gls{mglsresetall}:
+\codepar
+Individual entry first use: \gls{gls}\marg{shtml}.
+\codepar
+Multi-entry first use: \gls{mgls}\marg{shtml}. (Wrong!)
+\codepar
+\gls{printglossaries}
+\cend{document}
+\end{codebox}
+This now produces:
+\begin{resultbox}
+\createexample*[title={Multi-entries: skipping elements (prefix and
+post-link hooks)},
+ label={ex:multientryskipprefixpostlink},
+ description={Example document demonstrating multi-entry sets with
+elements skipped and prefix and post-link hooks},
+ arara={pdflatex,makeglossaries,pdflatex,pdfcrop}]
+{\cmd{usepackage}[colorlinks]\marg{hyperref}^^J%
+\cmd{usepackage}[stylemods,style=long]\marg{glossaries-extra}^^J%
+\codepar
+\gls{makeglossaries}^^J%
+\codepar
+\gls{setabbreviationstyle}\marg{long-postshort-sc-user}^^J%
+\codepar
+\gls{newabbreviation}\marg{ssi}\marg{ssi}\marg{server-side
+includes}^^J%
+\gls{newabbreviation}\marg{html}\marg{html}\marg{hypertext markup
+language}^^J%
+\codepar
+\cmd{newrobustcmd}\marg{\cmd{combinedpre}}[1]\marg{\gls{glsps}\marg{\#1}}^^J%
+\cmd{newrobustcmd}\marg{\cmd{combinedpost}}[1]\marg{\gls{glsps}\marg{\#1}}^^J%
+\codepar
+\cmd{newabbreviation}\marg{shtml}\marg{shtml}^^J%
+\marg{\marg{}\cmd{combinedpre}\marg{ssi} enabled
+\cmd{combinedpost}\marg{html}}^^J%
+\codepar
+\gls{glssetcategoryattribute}\marg{combinedabbrv}\marg{multioptions}^^J
+ \marg{\%^^J
+ mpostlinkelement=main,^^J
+ usedskipothers^^J
+ }^^J%
+\codepar
+\gls{multiglossaryentry}^^J
+ \oarg{category=combinedabbrv}^^J
+ \marg{shtml}\oarg{shtml}\marg{ssi,shtml,html}^^J%
+\codepar
+\gls{mglsdefcategoryprefix}\marg{combinedabbrv}\marg{\%^^J
+ \cmd{renewcommand}\marg{\cmd{combinedpre}}[1]\marg{\cmd{ignorespaces}}\%^^J
+ \cmd{renewcommand}\marg{\cmd{combinedpost}}[1]\marg{\gls{unskip}}\%^^J%
+}
+}
+{%
+Individual elements first use: \gls{gls}\marg{ssi} and \gls{gls}\marg{html}.^^J%
+\codepar
+Individual elements next use: \gls{gls}\marg{ssi} and
+\gls{gls}\marg{html}.^^J%
+\codepar
+Multi-entry first use: \gls{mgls}\marg{shtml}.^^J%
+\codepar
+Multi-entry next use: \gls{mgls}\marg{shtml}.^^J%
+\codepar
+Individual entry first use: \gls{gls}\marg{shtml}.^^J%
+\codepar
+Resetting all\gls{glsresetall}\gls{mglsresetall}:^^J%
+\codepar
+Multi-entry first use: \gls{mgls}\marg{shtml}.^^J%
+\codepar
+Multi-entry next use: \gls{mgls}\marg{shtml}.^^J%
+\codepar
+Individual elements: \gls{gls}\marg{ssi} and
+\gls{gls}\marg{html}.^^J%
+\codepar
+Resetting all\gls{glsresetall}\gls{mglsresetall}:^^J%
+\codepar
+Individual entry first use: \gls{gls}\marg{shtml}.^^J%
+\codepar
+Multi-entry first use: \gls{mgls}\marg{shtml}. (Wrong!)^^J%
+\codepar
+\gls{printglossaries}
+}
+\end{resultbox}
+Note the last two paragraphs, which highlights what happens if
+\code{\gls{gls}\marg{shtml}} is used before \code{\gls{mgls}\marg{shtml}} when neither
+of the other elements (\code{ssi} and \code{html}) have been
+used. The final instance of \gls{mgls} has produced the wrong result.
+This is because it's the first use of the multi-entry \code{shtml} but
+not the first use of the individual entry \code{shtml}.
One way around this is to modify the prefix to ensure that the main
-element's \gls{firstuseflag} matches the multi-entry's first use
+element's \idx{firstuseflag} matches the multi-entry's first use
flag:
-\begin{verbatim}
-\mglsdefcategoryprefix{combinedabbrv}{%
- \renewcommand{\combinedpre}[1]{\ignorespaces}%
- \renewcommand{\combinedpost}[1]{\unskip}%
- \mglsisfirstuse
- {\glslocalreset{\mglscurrentmainlabel}}%
- {\glslocalunset{\mglscurrentmainlabel}}%
+\begin{codebox}
+\gls{mglsdefcategoryprefix}\marg{combinedabbrv}\marg{\%
+ \cmd{renewcommand}\marg{\cmd{combinedpre}}[1]\marg{\cmd{ignorespaces}}\%
+ \cmd{renewcommand}\marg{\cmd{combinedpost}}[1]\marg{\gls{unskip}}\%
+ \gls{mglsisfirstuse}
+ \marg{\gls{glslocalreset}\marg{\gls{mglscurrentmainlabel}}}\%
+ \marg{\gls{glslocalunset}\marg{\gls{mglscurrentmainlabel}}}\%
}
-\end{verbatim}
+\end{codebox}
-The \pkgopt[annoteleft]{showtargets} option can be used to mark up
+The \opteqvalref{showtargets}{annoteleft} option can be used to mark up
the links with the targets. For example, the first instance of
-\verb|\mgls{shtml}| will show as:
-\begin{quote}
+\code{\gls{mgls}\marg{shtml}} will show as:
+\begin{resultbox}
\newcommand{\markup}[2]{%
-{\glsshowtargetfont[#1]}%
+\glsshowtargetfonttext{[#1]}%
\glsxtrshowtargetsymbolleft#2\glsxtrshowtargetsymbolright}%
-Multi-entry first use: \markup{glo:ssi}{\textsc{ssi}}
+Multi-entry first use: \markup{glo:ssi}{\textsc{ssi}}
\markup{glo:shtml}{enabled}
\markup{glo:html}{\textsc{html}} (\textsc{shtml}).
-\end{quote}
+\end{resultbox}
Each entry has an individual hyperlink to its own glossary item,
which may be confusing. This can be made clearer by suppressing the
main element link on first use with:
-\begin{verbatim}
-hyper=notmainfirst
-\end{verbatim}
+\begin{codebox}
+\mglsoptval{hyper}{notmainfirst}
+\end{codebox}
(as in the previous example), and adjusting the abbreviation style
so that the parenthetical content in the post-link hook has a
hyperlink:
-\begin{verbatim}
-\renewcommand*{\glsxtruserparen}[2]{%
- \glsxtrfullsep{#2}%
- \glsxtrparen
- {\glshyperlink[#1]{#2}%
- \ifglshasfield{\glsxtruserfield}{#2}{, \glscurrentfieldvalue}{}%
- }%
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glsxtruserparen}}[2]\marg{\%
+ \gls{glsxtrfullsep}\marg{\#2}\%
+ \gls{glsxtrparen}
+ \marg{\gls{glshyperlink}\oarg{\#1}\marg{\#2}\%
+ \gls{ifglshasfield}\marg{\gls{glsxtruserfield}}\marg{\#2}\marg{, \gls{glscurrentfieldvalue}}\marg{}\%
+ }\%
}
-\end{verbatim}
+\end{codebox}
The remaining problem is how to deal with the possibility that
-\verb|\mgls{shtml}| may come before the \gls{firstuse} of the other
+\code{\gls{mgls}\marg{shtml}} may come before the \idx{firstuse} of the other
elements. For example:
-\begin{verbatim}
-Multi-entry first use: \mgls{shtml}.
-
-Individual elements: \gls{ssi} and \gls{html}.
-\end{verbatim}
+\begin{codebox}
+Multi-entry first use: \gls{mgls}\marg{shtml}.
+\codepar
+Individual elements: \gls{gls}{ssi} and \gls{gls}\marg{html}.
+\end{codebox}
This leads to:
-\begin{quote}
-Multi-entry first use: server-side includes enabled hypertext markup
+\begin{resultbox}
+Multi-entry first use: server-side includes enabled hypertext markup
language (\textsc{shtml}).
Individual elements: \textsc{ssi} and \textsc{html}.
-\end{quote}
+\end{resultbox}
+
This means that the abbreviations \textsc{ssi} and \textsc{html}
aren't explained in the document text. One way around this is to
-only locally unset the other element \glspl{firstuseflag}:
-\begin{verbatim}
-\glssetcategoryattribute{combinedabbrv}{multioptions}
- {%
- hyper=notmainfirst,
- mpostlinkelement=main,
- usedskipothers,
- mglsopts={others={local}}
+only locally unset the other element \idxpl{firstuseflag}:
+\begin{codebox}
+\gls{glssetcategoryattribute}\marg{combinedabbrv}\marg{\catattr{multioptions}}
+ \marg{\%
+ \mglsoptval{hyper}{notmainfirst},
+ \mglsoptval{mpostlinkelement}{main},
+ \mglsoptval{usedskipothers},
+ \mglsoptval{mglsopts}{\mglsoptval{others}{local}}
}
-\end{verbatim}
+\end{codebox}
With the above setting, the following:
-\begin{verbatim}
-\glsresetall\mglsresetall
-
-Multi-entry first use: \mgls{shtml}.
-
-Multi-entry next use: \mgls{shtml}.
-
-Individual elements: \gls{ssi} and \gls{html}.
-\end{verbatim}
+\begin{codebox}
+\gls{glsresetall}\gls{mglsresetall}
+\codepar
+Multi-entry first use: \gls{mgls}\marg{shtml}.
+\codepar
+Multi-entry next use: \gls{mgls}\marg{shtml}.
+\codepar
+Individual elements: \gls{gls}\marg{ssi} and \gls{gls}\marg{html}.
+\end{codebox}
will now produce:
-\begin{quote}
-Multi-entry first use: server-side includes enabled hypertext markup
+\begin{resultbox}
+Multi-entry first use: server-side includes enabled hypertext markup
language (\textsc{shtml}).
Multi-entry next use: \textsc{shtml}.
-Individual elements: server-side includes (\textsc{ssi}) and
+Individual elements: server-side includes (\textsc{ssi}) and
hypertext markup language (\textsc{html}).
-\end{quote}
+\end{resultbox}
\section{Main and Other Elements}
\label{sec:mglsmain}
The list of labels provided in the final argument of
-\cs{multiglossaryentry} consists of a main element and all the other
+\gls{multiglossaryentry} consists of a main element and all the other
elements. If the main element isn't identified in the optional
argument, it's assumed to be the final element in the list.
The main element allows you to determine which target to use if you
-want the entire content of \cs{mgls} to be a single hyperlink. You
+want the entire content of \gls{mgls} to be a single hyperlink. You
can also use the settings described in \sectionref{sec:multiglsoptions}
to only index the main element.
You can change the main element using:
-\begin{definition}[\DescribeMacro\mglsSetMain]
-\cs{mglsSetMain}\marg{multi-label}\marg{new-main-label}
-\end{definition}
+\gls{mglsSetMain}
The new main label provided in the second argument must be in the
list corresponding to \meta{multi-label}. This change is locally
applied to the current scope. Note that if you are using
-\gls{bib2gls}, this change in the document can't be detected.
+\app{bib2gls}, this change in the document can't be detected.
The main element can also be used to identify which element should
-be displayed in the plural with \cs{mglsmainpl}. For example:
-\begin{verbatim}
-\newglossaryentry{great}{name={great},description={}}
-\newglossaryentry{little}{name={little},description={}}
-\newglossaryentry{grebe}{name={grebe},description={}}
-
-\multiglossaryentry{greatgrebe}{great,grebe}
-\multiglossaryentry{littlegrebe}{little,grebe}
-\end{verbatim}
-In the above, two multi-entries are defined: \texttt{greatgrebe} and
-\texttt{littlegrebe}. In both cases the main element is
-\texttt{grebe} (the last element). Using \cs{mglspl} will show the
-plural for all elements, but using \cs{mglsmainpl} will only use the
+be displayed in the plural with \gls{mglsmainpl}. For example:
+\begin{codebox}
+\gls{newglossaryentry}\marg{great}\marg{\gloskeyval{name}{great},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{little}\marg{\gloskeyval{name}{little},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{grebe}\marg{\gloskeyval{name}{grebe},\gloskeyval{description}{}}
+\codepar
+\gls{multiglossaryentry}\marg{greatgrebe}\marg{great,grebe}
+\gls{multiglossaryentry}\marg{littlegrebe}\marg{little,grebe}
+\end{codebox}
+In the above, two multi-entries are defined: \code{greatgrebe} and
+\code{littlegrebe}. In both cases the main element is
+\code{grebe} (the last element). Using \gls{mglspl} will show the
+plural for all elements, but using \gls{mglsmainpl} will only use the
plural for the main element (grebe). For example:
-\begin{verbatim}
-Plural all: \mglspl{greatgrebe}, \mglspl{littlegrebe}.
-Plural main: \mglsmainpl{greatgrebe}, \mglsmainpl{littlegrebe}.
-\end{verbatim}
+\begin{codebox}
+Plural all: \gls{mglspl}\marg{greatgrebe}, \gls{mglspl}\marg{littlegrebe}.
+Plural main: \gls{mglsmainpl}\marg{greatgrebe}, \gls{mglsmainpl}\marg{littlegrebe}.
+\end{codebox}
produces:
-\begin{display}
+\begin{resultbox}
Plural all: greats grebes, littles grebes.
Plural main: great grebes, little grebes.
-\end{display}
+\end{resultbox}
\section{Prefixes and Suffixes}
\label{sec:mglsfixes}
A multi-entry may have associated prefixes and suffixes. These are
scoped and are placed outside of the hyperlinks and encapsulating
-commands. They are not affected by case-changing commands, such as
-\cs{Mgls}.
-If you want a prefix to obey case-changing, use the \cs{mpgls}-like
+commands. They are not affected by case-changing commands, such as \gls{Mgls}.
+If you want a prefix to obey case-changing, use the \gls{mpgls}-like
commands instead (\sectionref{sec:mpgls}).
The prefix is inserted with:
-\begin{definition}[\DescribeMacro\mglsprefix]
-\cs{mglsprefix}
-\end{definition}
+\cmddef{mglsprefix}
The default definition is:
-\begin{verbatim}
-\newcommand*{\mglsprefix}{%
- \ifdefempty\mglscurrentcategory
- {\mglscurrentprefix}%
- {%
- \mglshascategoryprefix{\mglscurrentcategory}%
- {\mglsusecategoryprefix{\mglscurrentcategory}}%
- {\mglscurrentprefix}%
- }%
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{mglsprefix}}\marg{\%
+ \gls{ifdefempty}\gls{mglscurrentcategory}
+ \marg{\gls{mglscurrentprefix}}\%
+ \marg{\%
+ \gls{mglshascategoryprefix}\marg{\gls{mglscurrentcategory}}\%
+ \marg{\gls{mglsusecategoryprefix}\marg{\gls{mglscurrentcategory}}}\%
+ \marg{\gls{mglscurrentprefix}}\%
+ }\%
}
-\end{verbatim}
+\end{compactcodebox}
This will insert the current prefix unless there is prefix command
associated with the current category.
The suffix is inserted with:
-\begin{definition}[\DescribeMacro\mglssuffix]
-\cs{mglssuffix}
-\end{definition}
-The command is defined as follows:
-\begin{verbatim}
-\newcommand*{\mglssuffix}{%
- \ifdefempty\mglscurrentcategory
- {\ifdefempty{\mglscurrentsuffix}{}{\space(\mglscurrentsuffix)}}%
- {%
- \mglshascategorysuffix{\mglscurrentcategory}%
- {\mglsusecategorysuffix{\mglscurrentcategory}}%
- {\ifdefempty{\mglscurrentsuffix}{}{\space(\mglscurrentsuffix)}}%
- }%
+\cmddef{mglssuffix}
+This command is defined as follows:
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{mglssuffix}}\marg{\%
+ \gls{ifdefempty}\gls{mglscurrentcategory}
+ \marg{\gls{ifdefempty}{\gls{mglscurrentsuffix}}\marg{}\marg{\cmd{space}(\gls{mglscurrentsuffix})}}\%
+ \marg{\%
+ \gls{mglshascategorysuffix}\marg{\gls{mglscurrentcategory}}\%
+ \marg{\gls{mglsusecategorysuffix}\marg{\gls{mglscurrentcategory}}}\%
+ \marg{\gls{ifdefempty}\marg{\gls{mglscurrentsuffix}}\marg{}\marg{\cmd{space}(\gls{mglscurrentsuffix})}}\%
+ }\%
}
-\end{verbatim}
+\end{compactcodebox}
If there is a suffix associated with the current category, that will
-be used, otherwise if the current suffix isn't empty this
+be used, otherwise if the current suffix isn't empty this
inserts a space followed by the current suffix in parentheses.
-You can access the label of the last (non-skipped) element with
-\ics{mglslastelementlabel}.
+You can access the label of the last (non-skipped) element with
+\gls{mglslastelementlabel}.
Note that in both cases the category corresponds to the multi-entry
category (see \sectionref{sec:multiglscategory}).
To define a category-dependent prefix, use:
-\begin{definition}[\DescribeMacro\mglsdefcategoryprefix]
-\cs{mglsdefcategoryprefix}\marg{category}\marg{definition}
-\end{definition}
-You can reference the current prefix with \cs{mglscurrentprefix}.
+\cmddef{mglsdefcategoryprefix}
+You can reference the current prefix with \gls{mglscurrentprefix}
+within \meta{definition}.
To define a category-dependent suffix, use:
-\begin{definition}[\DescribeMacro\mglsdefcategorysuffix]
-\cs{mglsdefcategorysuffix}\marg{category}\marg{definition}
-\end{definition}
-You can reference the current suffix with \cs{mglscurrentsuffix}.
+\cmddef{mglsdefcategorysuffix}
+You can reference the current suffix with \gls{mglscurrentsuffix}
+within \meta{definition}.
-The default definition of \cs{mglsprefix} tests if there is a
+The default definition of \gls{mglsprefix} tests if there is a
category prefix using:
-\begin{definition}[\DescribeMacro\mglshascategoryprefix]
-\cs{glshascategoryprefix}\marg{category}\marg{true}\marg{false}
-\end{definition}
-The category prefix is used with:
-\begin{definition}[\DescribeMacro\mglsusecategoryprefix]
-\cs{glsusecategoryprefix}\marg{category}
-\end{definition}
-
-The default definition of \cs{mglssuffix} tests if there is a
+\cmddef{mglshascategoryprefix}
+This does \meta{true} if a prefix has been assigned to the given
+category, otherwise it does \meta{false}.
+
+If you need to obtain the prefix for a particular category, you can
+use:
+\cmddef{mglsusecategoryprefix}
+This expands to the prefix, if set, for the given category or to nothing otherwise.
+
+The default definition of \gls{mglssuffix} tests if there is a
category suffix using:
-\begin{definition}[\DescribeMacro\mglshascategorysuffix]
-\cs{glshascategorysuffix}\marg{category}\marg{true}\marg{false}
-\end{definition}
-The category suffix is used with:
-\begin{definition}[\DescribeMacro\mglsusecategorysuffix]
-\cs{glsusecategorysuffix}\marg{category}
-\end{definition}
-
-The current prefix \cs{mglscurrentprefix} and \cs{mglscurrentsuffix}
+\cmddef{mglshascategorysuffix}
+This does \meta{true} if a suffix has been assigned to the given
+category, otherwise it does \meta{false}.
+
+If you need to obtain the suffix for a particular category, you can
+use:
+\cmddef{mglsusecategorysuffix}
+This expands to the suffix, if set, for the given category or to nothing otherwise.
+
+The current prefix \gls{mglscurrentprefix} and \gls{mglscurrentsuffix}
are obtained as follows:
\begin{itemize}
-\item if this is the first use of the multi-entry
+\item if this is the first use of the multi-entry
(\sectionref{sec:mglsfirstuse}) then the \meta{prefix} is set to the
-value of the \optfmt{firstprefix} option and the \meta{suffix} is
-set to the value of the \optfmt{firstsuffix} option;
+value of the \mglsopt{firstprefix} option and the \meta{suffix} is
+set to the value of the \mglsopt{firstsuffix} option;
\item otherwise the \meta{prefix} is set to the
-value of the \optfmt{usedprefix} option and the \meta{suffix} is
-set to the value of the \optfmt{usedsuffix} option.
+value of the \mglsopt{usedprefix} option and the \meta{suffix} is
+set to the value of the \mglsopt{usedsuffix} option.
\end{itemize}
\begin{important}
The prefix and suffix (if set) are placed outside of the hyperlink
and text formatting encapsulator. They are not affected by
-case-changing commands such as \cs{Mgls} or \cs{MGLS}.
+case-changing commands such as \gls{Mgls} or \gls{MGLS}.
\end{important}
For example:
-\begin{verbatim}
-\setabbreviationstyle{long-only-short-only}
-\newabbreviation{clostridium}{C.}{Clostridium}
-\newglossaryentry{botulinum}{name=botulinum,description={}}
-
-\multiglossaryentry[firstsuffix=botulism]
- {cbot}{clostridium,botulinum}
-\end{verbatim}
+\begin{codebox}
+\gls{setabbreviationstyle}\marg{\abbrstyle{long-only-short-only}}
+\gls{newabbreviation}\marg{clostridium}\marg{C.}\marg{Clostridium}
+\gls{newglossaryentry}\marg{botulinum}\marg{\gloskeyval{name}{botulinum},\gloskeyval{description}{}}
+\codepar
+\gls{multiglossaryentry}\oarg{\mglsoptval{firstsuffix}{botulism}}
+ \marg{cbot}\marg{clostridium,botulinum}
+\end{codebox}
On first use, this produces (assuming the \qt{clostridum} element
hasn't been used previously):
-\begin{quote}
+\begin{resultbox}
Clostridium botulinum (botulism).
-\end{quote}
+\end{resultbox}
On subsequent use, this produces:
-\begin{quote}
+\begin{resultbox}
C. botulinum.
-\end{quote}
+\end{resultbox}
\section{Separators}
\label{sec:mglssep}
-The separators between each instance of \cs{gls} are given by the
+The separators between each instance of \gls{gls} are given by the
following commands, which all take two arguments. The first argument
is the label of the previous element. The second argument is the
label of the following element.
-\begin{definition}[\DescribeMacro\glscombinedsep]
-\cs{glscombinedsep}\marg{prev label}\marg{next label}
-\end{definition}
+\cmddef{glscombinedsep}
This is inserted between two entries that have both been marked as used.
The default definition is:
-\begin{verbatim}
-\newcommand*{\glscombinedsep}[2]{%
- \glshasattribute{#1}{combinedsep}%
- {\glsgetattribute{#1}{combinedsep}}%
- { }%
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glscombinedsep}}[2]\marg{\%
+ \gls{glshasattribute}\marg{\#1}\marg{\catattr{combinedsep}}\%
+ \marg{\gls{glsgetattribute}\marg{\#1}\marg{\catattr{combinedsep}}}\%
+ \marg{ }%
}
-\end{verbatim}
+\end{codebox}
This will use the \catattr{combinedsep} attribute for the
\meta{prev label}'s category, if set. Otherwise this just does a
space. Note that this ignores the second argument.
-\begin{definition}[\DescribeMacro\glscombinedfirstsep]
-\cs{glscombinedfirstsep}\marg{prev label}\marg{next label}
-\end{definition}
+\cmddef{glscombinedfirstsep}
This is inserted between two entries where only the next entry has
been marked as used. The default definition is:
-\begin{verbatim}
-\newcommand*{\glscombinedfirstsep}[2]{%
- \glshasattribute{#1}{combinedfirstsep}%
- {\glsgetattribute{#1}{combinedfirstsep}}%
- {\glscombinedsep{#1}{#2}}%
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glscombinedfirstsep}}[2]\marg{\%
+ \gls{glshasattribute}\marg{\#1}\marg{\catattr{combinedfirstsep}}\%
+ \marg{\gls{glsgetattribute}\marg{\#1}\marg{\catattr{combinedfirstsep}}}\%
+ \marg{\gls{glscombinedsep}\marg{\#1}\marg{\#2}}\%
}
-\end{verbatim}
+\end{codebox}
This will use the \catattr{combinedfirstsep} attribute for
\meta{prev label}'s category, if set. If that attribute isn't set,
-\cs{glscombinedsep} is used.
+\gls{glscombinedsep} is used.
-\begin{definition}[\DescribeMacro\glscombinedsepfirst]
-\cs{glscombinedsepfirst}\marg{prev label}\marg{next label}
-\end{definition}
+\cmddef{glscombinedsepfirst}
This is inserted between two entries where only the previous entry has
been marked as used. The default definition is:
-\begin{verbatim}
-\newcommand*{\glscombinedsepfirst}[2]{%
- \glshasattribute{#1}{combinedsepfirst}%
- {\glsgetattribute{#1}{combinedsepfirst}}%
- {\glscombinedsep{#1}{#2}}%
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glscombinedsepfirst}}[2]\marg{\%
+ \gls{glshasattribute}\marg{\#1}\marg{\catattr{combinedsepfirst}}\%
+ \marg{\gls{glsgetattribute}\marg{\#1}\marg{\catattr{combinedsepfirst}}}\%
+ \marg{\gls{glscombinedsep}\marg{\#1}\marg{\#2}}\%
}
-\end{verbatim}
+\end{codebox}
This will use the \catattr{combinedsepfirst} attribute for
\meta{prev label}'s category, if set. If that attribute isn't set,
-\cs{glscombinedsep} is used.
+\gls{glscombinedsep} is used.
-\begin{definition}[\DescribeMacro\glscombinedfirstsepfirst]
-\cs{glscombinedfirstsepfirst}\marg{prev label}\marg{next label}
-\end{definition}
+\cmddef{glscombinedfirstsepfirst}
This is inserted between two entries where both have
been marked as used. The default definition is:
-\begin{verbatim}
-\newcommand*{\glscombinedfirstsepfirst}[2]{%
- \glshasattribute{#1}{combinedfirstsepfirst}%
- {\glsgetattribute{#1}{combinedfirstsepfirst}}%
- {\glscombinedsep{#1}{#2}}%
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glscombinedfirstsepfirst}}[2]\marg{\%
+ \gls{glshasattribute}\marg{\#1}\marg{\catattr{combinedfirstsepfirst}}\%
+ \marg{\gls{glsgetattribute}\marg{\#1}\marg{\catattr{combinedfirstsepfirst}}}\%
+ \marg{\gls{glscombinedsep}\marg{\#1}\marg{\#2}}\%
}
-\end{verbatim}
+\end{codebox}
This will use the \catattr{combinedfirstsepfirst} attribute for
\meta{prev label}'s category, if set. If that attribute isn't set,
-\cs{glscombinedsep} is used.
+\gls{glscombinedsep} is used.
These commands may be redefined as required.
For example, to have no space between two elements that have both
been marked as used and are both abbreviations (disregarding
category attributes):
-\begin{verbatim}
-\renewcommand*{\glscombinedfirstsepfirst}[2]{%
- \ifglshasshort{#1}{\ifglshasshort{#2}{}{\space}}{\space}%
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glscombinedfirstsepfirst}}[2]\marg{\%
+ \gls{ifglshasshort}\marg{\#1}\marg{\gls{ifglshasshort}\marg{\#2}\marg{}\marg{\cmd{space}}}\marg{\cmd{space}}\%
}
-\end{verbatim}
+\end{codebox}
There are some commands for redefining the above separators to
common combinations.
-\begin{definition}[\DescribeMacro\glssetcombinedsepabbrvnbsp]
-\cs{glssetcombinedsepabbrvnbsp}
-\end{definition}
+\cmddef{glssetcombinedsepabbrvnbsp}
This does the following:
-\begin{verbatim}
-\renewcommand*{\glscombinedsep}[2]{%
- \glshasattribute{#1}{combinedsep}%
- {\glsgetattribute{#1}{combinedsep}}%
- {\ifhasshort{#1}{~}{ }}%
-}%
-\renewcommand*{\glscombinedsepfirst}[2]{%
- \glshasattribute{##1}{combinedsepfirst}%
- {\glsgetattribute{##1}{combinedsepfirst}}%
- {\ifhasshort{#1}{~}{ }}%
-}%
-\renewcommand*{\glscombinedfirstsep}[2]{%
- \glshasattribute{#1}{combinedfirstsep}%
- {\glsgetattribute{#1}{combinedfirstsep}}%
- { }%
-}%
-\renewcommand*{\glscombinedfirstsepfirst}[2]{%
- \glshasattribute{##1}{combinedfirstsepfirst}%
- {\glsgetattribute{##1}{combinedfirstsepfirst}}%
- { }%
-}%
-\end{verbatim}
-This uses a non-breakable space \verb|~| following an abbreviation
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glscombinedsep}}[2]\marg{\%
+ \gls{glshasattribute}\marg{\#1}\marg{\catattr{combinedsep}}\%
+ \marg{\gls{glsgetattribute}\marg{\#1}\marg{\catattr{combinedsep}}}\%
+ \marg{\gls{ifglshasshort}\marg{\#1}\marg{\glssymbol{idx.nbsp}}\marg{ }}\%
+}\%
+\cmd{renewcommand}*\marg{\gls{glscombinedsepfirst}}[2]\marg{\%
+ \gls{glshasattribute}\marg{\#1}\marg{\catattr{combinedsepfirst}}\%
+ \marg{\gls{glsgetattribute}\marg{\#1}\marg{\catattr{combinedsepfirst}}}\%
+ \marg{\gls{ifglshasshort}\marg{\#1}\marg{\glssymbol{idx.nbsp}}\marg{ }}\%
+}\%
+\cmd{renewcommand}*\marg{\gls{glscombinedfirstsep}}[2]\marg{\%
+ \gls{glshasattribute}\marg{\#1}\marg{\catattr{combinedfirstsep}}\%
+ \marg{\gls{glsgetattribute}\marg{\#1}\marg{\catattr{combinedfirstsep}}}\%
+ \marg{ }\%
+}\%
+\cmd{renewcommand}*\marg{\gls{glscombinedfirstsepfirst}}[2]\marg{\%
+ \gls{glshasattribute}\marg{\#1}\marg{\catattr{combinedfirstsepfirst}}\%
+ \marg{\gls{glsgetattribute}\marg{\#1}\marg{\catattr{combinedfirstsepfirst}}}\%
+ \marg{ }\%
+}
+\end{codebox}
+This uses a \idx{nbsp} following an abbreviation
(that has already been marked as used). Note that if the associated
attributes are set the commands will behave according to the
attribute.
-\begin{definition}[\DescribeMacro\glssetcombinedsepabbrvnone]
-\cs{glssetcombinedsepabbrvnone}
-\end{definition}
-This does the following:
-\begin{verbatim}
-\renewcommand*{\glscombinedsep}[2]{%
- \glshasattribute{#1}{combinedsep}%
- {\glsgetattribute{#1}{combinedsep}}%
- {\ifhasshort{#1}{}{\ifhasshort{#2}{}{ }}}%
-}%
-\renewcommand*{\glscombinedsepfirst}[2]{%
- \glshasattribute{#1}{combinedsepfirst}%
- {\glsgetattribute{#1}{combinedsepfirst}}%
- {\ifhasshort{#1}{}{ }}%
-}%
-\renewcommand*{\glscombinedfirstsep}[2]{%
- \glshasattribute{##1}{combinedfirstsep}%
- {\glsgetattribute{##1}{combinedfirstsep}}%
- {\ifhasshort{##2}{}{ }}%
-}%
-\renewcommand*{\glscombinedfirstsepfirst}[2]{%
- \glshasattribute{##1}{combinedfirstsepfirst}%
- {\glsgetattribute{##1}{combinedfirstsepfirst}}%
- { }%
-}%
-\end{verbatim}
+\cmddef{glssetcombinedsepabbrvnone}
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glscombinedsep}}[2]\marg{\%
+ \gls{glshasattribute}\marg{\#1}\marg{\catattr{combinedsep}}\%
+ \marg{\gls{glsgetattribute}\marg{\#1}\marg{\catattr{combinedsep}}}\%
+ \marg{\gls{ifglshasshort}\marg{\#1}\marg{}\marg{\gls{ifglshasshort}\marg{\#2}\marg{}\marg{ }}}\%
+}\%
+\cmd{renewcommand}*\marg{\gls{glscombinedsepfirst}}[2]\marg{\%
+ \gls{glshasattribute}\marg{\#1}\marg{\catattr{combinedsepfirst}}\%
+ \marg{\gls{glsgetattribute}\marg{\#1}\marg{\catattr{combinedsepfirst}}}\%
+ \marg{\gls{ifglshasshort}\marg{\#1}\marg{}\marg{ }}\%
+}\%
+\cmd{renewcommand}*\marg{\gls{glscombinedfirstsep}}[2]\marg{\%
+ \gls{glshasattribute}\marg{\#1}\marg{\catattr{combinedfirstsep}}\%
+ \marg{\gls{glsgetattribute}\marg{\#1}\marg{\catattr{combinedfirstsep}}}\%
+ \marg{\gls{ifglshasshort}\marg{\#2}\marg{}\marg{ }}\%
+}\%
+\cmd{renewcommand}*\marg{\gls{glscombinedfirstsepfirst}}[2]\marg{\%
+ \gls{glshasattribute}\marg{\#1}\marg{\catattr{combinedfirstsepfirst}}\%
+ \marg{\gls{glsgetattribute}\marg{\#1}\marg{\catattr{combinedfirstsepfirst}}}\%
+ \marg{ }\%
+}
+\end{codebox}
This does nothing if either element are abbreviations that have already been
used. Note that if the associated attributes are set the commands
will behave according to the attribute.
-\begin{definition}[\DescribeMacro\glssetcombinedsepnarrow]
-\cs{glssetcombinedsepnarrow}\marg{width}\marg{narrow sep}
-\end{definition}
+\cmddef{glssetcombinedsepnarrow}
This is rather more complicated as it measures a field value and
-uses \meta{narrow sep} if the width is less than \meta{width}.
+uses \meta{narrow-sep} if the width is less than \meta{width}.
The field value is determined as follows:
\begin{itemize}
-\item on \gls{firstuse} the
+\item on \idx{firstuse} the
\gloskey{long} field is used if it is set otherwise the
\gloskey{first} field is used;
@@ -8724,270 +34694,210 @@ The field value is determined as follows:
\end{itemize}
Note that this doesn't take into account fonts, hooks, abbreviation
-styles or plural forms (e.g.\ \cs{mglspl}) or other field references
-(e.g.\ \cs{mglsname}). If the associated attributes are set the commands
+styles or plural forms (e.g.\ \gls{mglspl}) or other field references
+(e.g.\ \gls{mglsname}). If the associated attributes are set the commands
will behave according to the attribute.
-\section{\headingcs{mgls} Element Hooks}
+\section{\glsfmtname{mgls} Element Hooks}
\label{sec:mglselementhooks}
-The \cs{mgls}-like commands use the following hooks:
-\begin{definition}[\DescribeMacro\mglselementprehook]
-\cs{mglselementprehook}
-\end{definition}
+The \gls{mgls}-like commands use the following hooks:
+\cmddef{mglselementprehook}
This is done before each (non-skipped) element. (Default does nothing.)
-\begin{definition}[\DescribeMacro\mglselementposthook]
-\cs{mglselementposthook}
-\end{definition}
+
+\cmddef{mglselementposthook}
This is done after each (non-skipped) element. (Default does nothing.)
Note that this is different from the normal entry post-link hook
-\ics{glspostlinkhook}. If the individual entry post-link hook is enabled (see the
-\optfmt{postlinks} key in \sectionref{sec:multiglsoptions}), this will go before
-\cs{mglselementposthook}.
+\gls{glspostlinkhook}. If the individual entry post-link hook is enabled (see the
+\mglsopt{postlinks} key in \sectionref{sec:multiglsoptions}), this will go before
+\gls{mglselementposthook}.
The definitions of the following commands are scoped within the
-\cs{mgls}-like commands so they can't be accessed elsewhere
+\gls{mgls}-like commands so they can't be accessed elsewhere
(including in the post-link hook, see
\sectionref{sec:mglspostlinkhook}). They
may be used in the above hooks or in the separator commands (described in
\sectionref{sec:mglssep}) or in the command used to encapsulate the
entire content. They can also be used in the post-link hook (see
\sectionref{sec:entryfmtmods}) to determine if an entry is being
-used within a \cs{mgls}-like command.
-
-The multi-entry label is stored in:
-\begin{definition}[\DescribeMacro\mglscurrentmultilabel]
-\cs{mglscurrentmultilabel}
-\end{definition}
-
-The label of the main element:
-\begin{definition}[\DescribeMacro\mglscurrentmainlabel]
-\cs{mglscurrentmainlabel}
-\end{definition}
-
-The complete comma-separated list of elements:
-\begin{definition}[\DescribeMacro\mglscurrentlist]
-\cs{mglscurrentlist}
-\end{definition}
-
-Multi-entry options:
-\begin{definition}[\DescribeMacro\mglscurrentoptions]
-\cs{mglscurrentoptions}
-\end{definition}
-These are the options that were used when defining the multi-entry. This
-doesn't include options set with \cs{multiglossaryentrysetup}
-or those passed to \cs{mgls} (or whichever variant is being used).
-
-The current multi-entry category in effect is stored in:
-\begin{definition}[\DescribeMacro\mglscurrentcategory]
-\cs{mglscurrentcategory}
-\end{definition}
-
-The calling command control sequence name (e.g.\ \qt{mgls} or \qt{mglspl})
-can be obtained with:
-\begin{definition}[\DescribeMacro\glsxtrcurrentmglscsname]
-\cs{glsxtrcurrentmglscsname}
-\end{definition}
+used within a \gls{mgls}-like command.
+
+\cmddef{mglscurrentmultilabel}
+Expands to the multi-entry label.
+
+\cmddef{mglscurrentmainlabel}
+Expands to the label of the main element.
+
+\cmddef{mglscurrentlist}
+Expands to the complete comma-separated list of elements.
+
+\cmddef{mglscurrentoptions}
+Expands to the options used when the multi-entry was defined. This
+doesn't include options set with \gls{multiglossaryentrysetup}
+or those passed to \gls{mgls} (or whichever variant is being used).
+
+\cmddef{mglscurrentcategory}
+Expands to the multi-entry category current in effect.
+
+\cmddef{glsxtrcurrentmglscsname}
+Expands to the control sequence name of the calling command (for
+example, \code{mgls} or \code{mglspl}).
To test if the current multi-entry is the first use:
-\begin{definition}[\DescribeMacro\mglsisfirstuse]
-\cs{mglsisfirstuse}\marg{true}\marg{false}
-\end{definition}
+\cmddef{mglsisfirstuse}
This does \meta{true} if this is the first use otherwise it does
-\meta{false}. Note that this
-applies to the multi-entry first use flag not the
-\glspl{firstuseflag} of the individual elements.
+\meta{false}. Note that this applies to the multi-entry first use
+flag not the \idxpl{firstuseflag} of the individual elements.
At each iteration of the loop over the element list, the following
commands are set, which can be accessed in hooks such as
-\cs{mglselementprehook} or in hooks used by the underlying \cs{gls}
-etc commands. For example, if \cs{mglscurrentlabel} is defined then
-\cs{gls} is being used inside \cs{mgls}.
-
-The current element label:
-\begin{definition}[\DescribeMacro\mglscurrentlabel]
-\cs{mglscurrentlabel}
-\end{definition}
-
-This is a count register that is set to the element index:
-\begin{definition}[\DescribeMacro\mglselementindex]
-\cs{mglselementindex}
-\end{definition}
-
-The current multi-entry prefix:
-\begin{definition}[\DescribeMacro\mglscurrentprefix]
-\cs{mglscurrentprefix}
-\end{definition}
-
-The current multi-entry suffix:
-\begin{definition}[\DescribeMacro\mglscurrentsuffix]
-\cs{mglscurrentsuffix}
-\end{definition}
-
-\begin{definition}[\DescribeMacro\mglsiflast]
-\cs{mglsiflast}\marg{true}\marg{false}
-\end{definition}
+\gls{mglselementprehook} or in hooks used by the underlying \gls{gls}
+etc commands. For example, if \gls{mglscurrentlabel} is defined then
+\gls{gls} is being used inside \gls{mgls}.
+
+\cmddef{mglscurrentlabel}
+Expands to the current element label.
+
+\cmddef{mglselementindex}
+This is a count register that is set to the element index.
+
+\cmddef{mglscurrentprefix}
+Expands to the current multi-entry prefix.
+
+\cmddef{mglscurrentsuffix}
+Expands to the current multi-entry suffix.
+
+\cmddef{mglsiflast}
If this is the last iteration, does \meta{true} otherwise does
\meta{false}. This takes the skip options into account, so the last
iteration may not necessarily be when the element index is equal to
-the total number of elements.
+the total number of elements.
\section{Post-Link Hook}
\label{sec:mglspostlinkhook}
-There is a hook that occurs at the end the \cs{mgls}-like commands
-according to the \optfmt{mpostlink} setting (see
+There is a hook that occurs at the end the \gls{mgls}-like commands
+according to the \mglsopt{mpostlink} setting (see
\sectionref{sec:multiglsoptions}). The hook used depends on the
-\optfmt{mpostlinkelement} option.
+\mglsopt{mpostlinkelement} option.
These hooks can't access the commands described in \sectionref{sec:mglselementhooks}
as the hook occurs outside of the scope in which they are defined.
-The \optfmt{mpostlinkelement=custom} option uses:
-\begin{definition}[\DescribeMacro\mglscustompostlinkhook]
-\cs{mglscustompostlinkhook}
-\end{definition}
+The \mglsoptval{mpostlinkelement}{custom} option uses:
+\cmddef{mglscustompostlinkhook}
This does nothing by default.
-The \optfmt{mpostlinkelement=last} option uses:
-\begin{definition}[\DescribeMacro\mglslastelementpostlinkhook]
-\cs{mglslastelementpostlinkhook}
-\end{definition}
+The \mglsoptval{mpostlinkelement}{last} option uses:
+\cmddef{mglslastelementpostlinkhook}
which emulates the post-link hook of the last element.
-The \optfmt{mpostlinkelement=main} option uses:
-\begin{definition}[\DescribeMacro\mglslastmainpostlinkhook]
-\cs{mglslastmainpostlinkhook}
-\end{definition}
+The \mglsoptval{mpostlinkelement}{main} option uses:
+\cmddef{mglslastmainpostlinkhook}
which emulates the post-link hook of the main element.
-The default settings
-\optfmt{postlinks=none,mpostlink=true,mpostlinkelementlast} will
-suppress the individual element post-link hooks
-(\ics{glspostlinkhook}) and do the multi-entry post-link hook for
-the last element (\cs{mglslastelementpostlinkhook}).
+The default settings \code{\mglsoptval{postlinks}{none},
+\mglsoptval{mpostlink}{true}, \mglsoptval{mpostlinkelement}{last}} will
+suppress the individual element \idxpl{postlinkhook}
+(\gls{glspostlinkhook}) and do the multi-entry post-link hook for
+the last element (\gls{mglslastelementpostlinkhook}).
-If you have the final element's post-link hook enabled and the
+If you have the final element's \idx{postlinkhook} enabled and the
multi-entry post-link hook enabled (for example,
-\optfmt{postlinks=all, mpostlink=true, mpostlinkelement=last}), the
-final element's post-link hook will be done twice. Similarly for the
-main element with
-\optfmt{postlinks=all, mpostlink=true, mpostlinkelement=main}.
+\code{\mglsoptval{postlinks}{all}, \mglsoptval{mpostlink}{true},
+\mglsoptval{mpostlinkelement}{last}}), the final element's
+\idx{postlinkhook} will be done twice. Similarly for the main element with
+\code{\mglsoptval{postlinks}{all}, \mglsoptval{mpostlink}{true},
+\mglsoptval{mpostlinkelement}{main}}.
The following commands are available for use in these hooks and may
-also be used in \ics{mglssuffix}.
-
-The multi-entry label:
-\begin{definition}[\DescribeMacro\mglslastmultilabel]
-\cs{mglslastmultilabel}
-\end{definition}
-
-The multi-entry category (\sectionref{sec:multiglscategory}):
-\begin{definition}[\DescribeMacro\mglslastcategory]
-\cs{mglslastcategory}
-\end{definition}
-This will be empty if no category was assigned.
-
-\begin{definition}[\DescribeMacro\mglswasfirstuse]
-\cs{mglswasfirstuse}\marg{true}\marg{false}
-\end{definition}
-If that was the first use of the multi-entry (\sectionref{sec:mglsfirstuse})
+also be used in the definition of \gls{mglssuffix}.
+
+\cmddef{mglslastmultilabel}
+Expands to the multi-entry label.
+
+\cmddef{mglslastcategory}
+Expands to the multi-entry category (see
+\sectionref{sec:multiglscategory}). This will be empty if no
+category was assigned.
+
+\cmddef{mglswasfirstuse}
+If that was the first use of the multi-entry (see \sectionref{sec:mglsfirstuse})
this does \meta{true} otherwise it does \meta{false}.
\subsection{Last Element}
\label{sec:mglspostlinkhooklastelement}
The following commands relate to the last element.
-The label of the last non-skipped element:
-\begin{definition}[\DescribeMacro\mglslastelementlabel]
-\cs{mglslastelementlabel}
-\end{definition}
-If all elements were skipped or if the multi-entry wasn't defined,
-this will be empty.
+\cmddef{mglslastelementlabel}
+Expands to the label of the last non-skipped element. If all
+elements were skipped or if the multi-entry wasn't defined, this
+will be empty.
Test if the last element was skipped:
-\begin{definition}[\DescribeMacro\mglsiflastelementskipped]
-\cs{mglsiflastelementskipped}\marg{true}\marg{false}
-\end{definition}
+\cmddef{mglsiflastelementskipped}
If the last element was skipped this does \meta{true} otherwise it
does \meta{false}.
-If all elements were skipped or if the multi-entry wasn't defined,
+If all elements were skipped or if the multi-entry wasn't defined,
this will do \meta{true}.
Test if the last element was its first use:
-\begin{definition}[\DescribeMacro\mglsiflastelementwasfirstuse]
-\cs{mglsiflastelementwasfirstuse}\marg{true}\marg{false}
-\end{definition}
+\cmddef{mglsiflastelementwasfirstuse}
If the last non-skipped element was used for the first time this
does \meta{true} otherwise it does \meta{false}. (Corresponds to
-\cs{glsxtrifwasfirstuse}.)
-If all elements were skipped or if the multi-entry wasn't defined,
+\gls{glsxtrifwasfirstuse}.)
+If all elements were skipped or if the multi-entry wasn't defined,
this will do \meta{true}.
Test if the last element was plural:
-\begin{definition}[\DescribeMacro\mglsiflastelementwasplural]
-\cs{mglsiflastelementwasplural}\marg{true}\marg{false}
-\end{definition}
+\cmddef{mglsiflastelementwasplural}
If the last non-skipped element had the plural form displayed, this
does \meta{true} otherwise it does \meta{false}. (Corresponds to
-\cs{glsifplural}.)
-If all elements were skipped or if the multi-entry wasn't defined,
+\gls{glsifplural}.)
+If all elements were skipped or if the multi-entry wasn't defined,
this will do \meta{false}.
Test if the last element was had any case-changing applied:
-\begin{definition}[\DescribeMacro\mglsiflastelementcapscase]
-\cs{mglsiflastelementcapscase}\marg{no-change}\marg{firstuc}\marg{all caps}
-\end{definition}
-Corresponds to \cs{glscapscase} of the last non-skipped element.
-If all elements were skipped or if the multi-entry wasn't defined,
+\cmddef{mglsiflastelementcapscase}
+Corresponds to \gls{glscapscase} of the last non-skipped element.
+If all elements were skipped or if the multi-entry wasn't defined,
this will do \meta{no-change}.
\subsection{Main Element}
\label{sec:mglspostlinkhookmainelement}
The following commands relate to the main element.
-The label of the main element from the multi-entry that was just
-referenced:
-\begin{definition}[\DescribeMacro\mglslastmainlabel]
-\cs{mglslastmainlabel}
-\end{definition}
-If the main element was skipped or if the multi-entry
+\cmddef{mglslastmainlabel}
+Expands to the label of the main element from the multi-entry that
+was just referenced. If the main element was skipped or if the multi-entry
wasn't defined, this will be empty. If this is the same as
-\cs{mglslastelementlabel} then the main element was the last
+\gls{mglslastelementlabel} then the main element was the last
element.
Test if the main element was skipped:
-\begin{definition}[\DescribeMacro\mglsiflastmainskipped]
-\cs{mglsiflastmainskipped}\marg{true}\marg{false}
-\end{definition}
+\cmddef{mglsiflastmainskipped}
If the main element from the multi-entry that was just referenced
was skipped this does \meta{true} otherwise it does \meta{false}.
If the multi-entry wasn't defined, this will do \meta{true}.
Test if the main element was its first use:
-\begin{definition}[\DescribeMacro\mglsiflastmainwasfirstuse]
-\cs{mglsiflastmainwasfirstuse}\marg{true}\marg{false}
-\end{definition}
+\cmddef{mglsiflastmainwasfirstuse}
If the main element was used for the first time this
does \meta{true} otherwise it does \meta{false}. (Corresponds to
-\cs{glsxtrifwasfirstuse}.)
-If the main element was skipped or if the multi-entry wasn't defined,
+\gls{glsxtrifwasfirstuse}.)
+If the main element was skipped or if the multi-entry wasn't defined,
this will do \meta{true}.
Test if the main element was plural:
-\begin{definition}[\DescribeMacro\mglsiflastmainwasplural]
-\cs{mglsiflastmainwasplural}\marg{true}\marg{false}
-\end{definition}
+\cmddef{mglsiflastmainwasplural}
If the main element from the multi-entry that was just referenced
had its plural form displayed this does \meta{true} otherwise it
-does \meta{false}. (Corresponds to \cs{glsifplural}.) If the main
+does \meta{false}. (Corresponds to \gls{glsifplural}.) If the main
element was skipped or if the multi-entry wasn't defined, this will
do \meta{false}.
Test if the main element was had any case-changing applied:
-\begin{definition}[\DescribeMacro\mglsiflastmaincapscase]
-\cs{mglsiflastmaincapscase}\marg{no-change}\marg{firstuc}\marg{all caps}
-\end{definition}
-Corresponds to \cs{glscapscase} of the main element from the
+\cmddef{mglsiflastmaincapscase}
+Corresponds to \gls{glscapscase} of the main element from the
multi-entry that was just referenced. If the main element was
skipped or if the multi-entry wasn't defined, this will do
\meta{no-change}.
@@ -8996,104 +34906,104 @@ skipped or if the multi-entry wasn't defined, this will do
\label{sec:mglsfirstuse}
Each multi-entry set has an associated first use flag. This is
-independent of the \gls{firstuseflag} associated with the individual
-entries that make up the set. As with the \cs{gls}-like commands,
-\cs{mgls} unsets this flag. Unlike the \cs{glstext}-like commands, all
+independent of the \idx{firstuseflag} associated with the individual
+entries that make up the set. As with the \idx{glslike} commands,
+\gls{mgls} unsets this flag. Unlike the \idx{glstextlike} commands, all
the commands described in \sectionref{sec:mglslike} (including
-commands like \cs{mglsname}) unset this flag, even if the elements
-use commands like \cs{glsname} that don't unset the entry's
-\gls{firstuseflag}.
+commands like \gls{mglsname}) unset this flag, even if the elements
+use commands like \gls{glsname} that don't unset the entry's
+\idx{firstuseflag}.
You can determine whether or not a multi-entry set has been
marked as used with:
-\begin{definition}[\DescribeMacro\ifmglsused]
-\cs{ifmglsused}\marg{multi-label}\marg{true}\marg{false}
-\end{definition}
+\cmddef{ifmglsused}
+This does \meta{true} if the given multi-entry has been marked
+as used, otherwise it does \meta{false}.
+
You can (globally) unset the flag (mark the set as having been referenced)
with:
-\begin{definition}[\DescribeMacro\mglsunset]
-\cs{mglsunset}\marg{multi-label}
-\end{definition}
+\cmddef{mglsunset}
or reset it with:
-\begin{definition}[\DescribeMacro\mglsreset]
-\cs{mglsreset}\marg{multi-label}
-\end{definition}
+\cmddef{mglsreset}
There are also local versions of these commands:
-\begin{definition}[\DescribeMacro\mglslocalunset]
-\cs{mglslocalunset}\marg{multi-label}
-\end{definition}
-and
-\begin{definition}[\DescribeMacro\mglslocalreset]
-\cs{mglslocalreset}\marg{multi-label}
-\end{definition}
-
-To unset all multi-entries:
-\begin{definition}[\DescribeMacro\mglsunsetall]
-\cs{mglsunsetall}
-\end{definition}
-To reset all multi-entries:
-\begin{definition}[\DescribeMacro\mglsresetall]
-\cs{mglsresetall}
-\end{definition}
+\cmddef{mglslocalunset}
+which locally unsets the flag and
+\cmddef{mglslocalreset}
+which locally resets the flag.
+
+It's also possible to unset or reset all multi-entries.
+\cmddef{mglsunsetall}
+Unsets all multi-entries.
+\cmddef{mglsresetall}
+Resets all multi-entries.
+
+\begin{important}
Note that unsetting or resetting any of the individual element
-\glspl{firstuseflag} doesn't affect the multi-entry flag.
+\idxpl{firstuseflag} doesn't affect the multi-entry flag.
Similarly, unsetting or resetting the multi-entry flag doesn't
-affect the \glspl{firstuseflag} of the individual elements.
+affect the \idxpl{firstuseflag} of the individual elements.
+\end{important}
\section{Multi-Entry Category}
\label{sec:multiglscategory}
A multi-entry set may have an associated category set using the
-\optfmt{category} key described in \sectionref{sec:multiglsoptions}.
+\mglsopt{category} key described in \sectionref{sec:multiglsoptions}.
This isn't set by default, but if it is set the category may have
attributes set in the usual way. The multi-entry category is
independent of the individual entry categories. The following
-attribute is recognised by commands like \cs{mgls}:
+attribute is recognised by commands like \gls{mgls}:
-\begin{description}
-
-\item[\catattrdef{multioptions}] default options to apply to any
+\optiondef{catattr.multioptions}
+The value are the default options to apply to any
multi-entry set with the given category. These can be overridden
-by the first optional argument of \cs{multiglossaryentry} or by the
-\optfmt{setup} key in the first optional argument of commands like
-\cs{mgls}.
+by the first optional argument of \gls{multiglossaryentry} or by the
+\mglsopt{setup} key in the first optional argument of commands like
+\gls{mgls}.
+
+\optiondef{catattr.combinedfirstsep}
+The separator to use for \gls{glscombinedfirstsep}.
+
+\optiondef{catattr.combinedfirstsepfirst}
+The separator to use for \gls{glscombinedfirstsepfirst}.
+
+\optiondef{catattr.combinedsepfirst}
+The separator to use for \gls{glscombinedsepfirst}.
+
+\optiondef{catattr.combinedsep}
+The separator to use for \gls{glscombinedsep}.
-\end{description}
Note that you can't access the category or its attributes via the
-multi-entry label (for example, with \cs{glshasattribute}). If you
+multi-entry label (for example, with \gls{glshasattribute}). If you
need to access the current multi-entry's category within any of the
-\cs{mgls}-like hooks (\sectionref{sec:mglselementhooks}), you can
-obtain the category with \cs{mglscurrentcategory} and use commands
-like \cs{glshascategoryattribute}.
+\gls{mgls}-like hooks (\sectionref{sec:mglselementhooks}), you can
+obtain the category with \gls{mglscurrentcategory} and use commands
+like \gls{glshascategoryattribute}.
\section{Multi-Entry Settings}
\label{sec:multiglsoptions}
The settings that govern all multi-entries can be set using:
-\begin{definition}[\DescribeMacro\multiglossaryentrysetup]
-\cs{multiglossaryentrysetup}\marg{options}
-\end{definition}
-The \meta{options} are the same as for \cs{multiglossaryentry}.
-Options may also be set according to the multi-entry category
-attribute \catattr{multioptions}.
-
-Whenever the \cs{mgls}-like commands are used, options are applied in the
+\cmddef{multiglossaryentrysetup}
+The \meta{options} are the same as for \gls{multiglossaryentry}.
+
+Whenever the \gls{mgls}-like commands are used, options are applied in the
following order:
\begin{enumerate}
-\item general options identified by \cs{multiglossaryentrysetup};
+\item general options identified by \gls{multiglossaryentrysetup};
\item the category key is assigned if it's in the general options,
-\cs{multiglossaryentry} or \optfmt{setup} key;
+\gls{multiglossaryentry} or \mglsopt{setup} key;
\item \catattr{multioptions} category attribute (if set);
-\item any options provided in the first optional argument of
-\cs{multiglossaryentry};
+\item any options provided in the first optional argument of
+\gls{multiglossaryentry};
-\item any options provided in the \optfmt{setup} key in the first
-optional argument of the \cs{mgls}-like command.
+\item any options provided in the \mglsopt{setup} key in the first
+optional argument of the \gls{mgls}-like command.
\end{enumerate}
These options are described below.
@@ -9101,156 +35011,145 @@ These options are described below.
\subsection{Indexing}
\label{sec:multiglsoptionsindexing}
+\optiondef{mglsopt.indexmain}
+This setting may take one of the following values:
\begin{description}
-\item[\optfmt{indexmain}] This setting may take one of the following
-values:
- \begin{description}
\item[\optfmt{false}] don't index the main entry;
\item[\optfmt{true}] index the main entry;
- \item[\optfmt{first}] only index the main entry if it's the first
-use (of the main entry).
- \end{description}
- The default is \optfmt{true}.
-
-\item[\optfmt{indexothers}] This setting may take one of the following
-values:
- \begin{description}
+ \item[\optfmt{first}] only index the main entry if it's the
+\idx{firstuse} (of the main entry).
+\end{description}
+
+\optiondef{mglsopt.indexothers}
+This setting may take one of the following values:
+\begin{description}
\item[\optfmt{false}] don't index the other entries;
\item[\optfmt{true}] index the other entries;
\item[\optfmt{first}] only index the other entries if
-it's the first use (of the non-main entry).
- \end{description}
- The default is \optfmt{first}.
+it's the \idx{firstuse} (of the non-main entry).
\end{description}
\subsection{Location Formats (Encaps)}
\label{sec:multiglsoptionsencap}
-\begin{description}
-\item[\optfmt{encapmain}] This setting value should be the value to
- pass to \gloskey[glslink]{format} for the main entry. (The location
- encapsulator.) The default is \texttt{glsnumberformat}.
+\optiondef{mglsopt.encapmain}
+This setting value should be the value to
+pass to \glsopt{format} option (\idx{locationencap}) for the main entry.
-\item[\optfmt{encapothers}] This setting value should be the value to
- pass to \gloskey[glslink]{format} for the other (not main) entries. (The location
- encapsulator.) The default is \texttt{glsnumberformat}.
-\end{description}
+\optiondef{mglsopt.encapothers}
+This setting value should be the value to pass to \glsopt{format}
+option (\idx{locationencap}) for the other (not main) entries.
\subsection{Post-Link Hooks}
\label{sec:multiglsoptionspostlink}
+\optiondef{mglsopt.postlinks}
+This setting determines whether or not to enable the individual
+element's \idx{postlinkhook}. The value may be one of:
\begin{description}
-\item[\optfmt{postlinks}] This setting determines whether or not to
-enable the individual element's post-link hook
-(\ics{glspostlinkhook}). The value may be one of:
-\begin{description}
-\item[\optfmt{none}] suppress the post-link hook for all elements;
-\item[\optfmt{all}] don't suppress the post-link hook for all elements;
-\item[\optfmt{notlast}] only suppress the post-link hook for the
+\item[\optfmt{none}] suppress the \idx{postlinkhook} for all elements;
+\item[\optfmt{all}] don't suppress the \idx{postlinkhook} for all elements;
+\item[\optfmt{notlast}] only suppress the \idx{postlinkhook} for the
last element;
-\item[\optfmt{mainnotlast}] suppress the post-link hook for all
+\item[\optfmt{mainnotlast}] suppress the \idx{postlinkhook} for all
\qt{other} (not main) elements and for the last element (so only the
-main element will have its post-link hook as long as it's not the
+main element will have its \idx{postlinkhook} as long as it's not the
last element);
-\item[\optfmt{mainonly}] suppress the post-link hook for all
+\item[\optfmt{mainonly}] suppress the \idx{postlinkhook} for all
\qt{other} (not main) elements;
-\item[\optfmt{othernotlast}] suppress the post-link hook for the
+\item[\optfmt{othernotlast}] suppress the \idx{postlinkhook} for the
main element and for the last element (so only the other elements
-will have their post-link hook as long as the element isn't the last
+will have their \idx{postlinkhook} as long as the element isn't the last
one);
-\item[\optfmt{otheronly}] suppress the post-link hook for the main element.
+\item[\optfmt{otheronly}] suppress the \idx{postlinkhook} for the main element.
+\end{description}
+
+\optiondef{mglsopt.mpostlink}
+This setting determines whether or not to enable the multi-entry
+post-link hook (see \sectionref{sec:mglspostlinkhook}). The value
+may be one of:
+\begin{description}
+ \item[\optfmt{false}] suppress the multi-entry post-link hook;
+ \item[\optfmt{true}] enable the multi-entry post-link hook;
+ \item[\optfmt{firstonly}] enable the multi-entry post-link hook
+ only for the \idx{mfirstuse} of the multi-entry;
+ \item[\optfmt{usedonly}] enable the multi-entry post-link hook
+ only for the \idx{msubsequentuse} of the multi-entry.
\end{description}
-The default is \optfmt{postlinks=none}.
-
-\item[\optfmt{mpostlink}] This setting determines whether or not to
-enable the multi-entry post-link hook
-(\sectionref{sec:mglspostlinkhook}). The value may be one of:
- \begin{description}
- \item[\optfmt{false}] suppress the multi-entry post-link hook;
- \item[\optfmt{true}] enable the multi-entry post-link hook;
- \item[\optfmt{firstonly}] enable the multi-entry post-link hook
- only for the first use of the multi-entry;
- \item[\optfmt{usedonly}] enable the multi-entry post-link hook
- only for the subsequent (not first) use of the multi-entry.
- \end{description}
-The default is \optfmt{mpostlink=true}. If the value is omitted,
-\optfmt{true} is assumed.
-
-\item[\optfmt{mpostlinkelement}] This setting indicates which
+
+\optiondef{mglsopt.mpostlinkelement}
+This setting indicates which
post-link hook should be used if the multi-entry post-link hook has
been enabled. Allowed values:
- \begin{description}
- \item[\optfmt{last}] use \ics{mglslastelementpostlinkhook} (that
-is, use the post-link hook for the last element);
- \item[\optfmt{main}] use \ics{mglslastmainpostlinkhook} (that
-is, use the post-link hook for the main element);
- \item[\optfmt{custom}] use \ics{mglslastcustompostlinkhook}.
- \end{description}
+\begin{description}
+ \item[\optfmt{last}] use \gls{mglslastelementpostlinkhook} (that
+is, use the \idx{postlinkhook} for the last element);
+ \item[\optfmt{main}] use \gls{mglslastmainpostlinkhook} (that
+is, use the \idx{postlinkhook} for the main element);
+ \item[\optfmt{custom}] use \gls{mglscustompostlinkhook}.
\end{description}
-Note that some combinations may cause a repeated hook.
+
+\begin{warning}
+Some combinations may cause a repeated hook.
+\end{warning}
\subsection{Prefixes and Suffixes}
\label{sec:multiglsoptionsfixes}
See \sectionref{sec:mglsfixes} for more information on prefixes and
suffixes. Note that the prefixes and suffixes are not affected by
-case-changing commands such as \cs{Mgls} or \cs{MGLS}.
-If you want a prefix to obey case-changing, use the \cs{mpgls}-like
-commands instead (\sectionref{sec:mpgls}).
+case-changing commands such as \gls{Mgls} or \gls{MGLS}.
+If you want a prefix to obey case-changing, use the \gls{mpgls}-like
+commands instead (see \sectionref{sec:mpgls}).
-\begin{description}
-
-\item[firstprefix] The prefix to use on first use of the
-multi-entry.
+\optiondef{mglsopt.firstprefix}
+The prefix to use on \idx{mfirstuse} of the multi-entry.
-\item[usedprefix] The prefix to use on subsequent use of the
-multi-entry.
+\optiondef{mglsopt.usedprefix}
+The prefix to use on \idx{msubsequentuse} of the multi-entry.
-\item[firstsuffix] The suffix to use on first use of the
-multi-entry.
+\optiondef{mglsopt.firstsuffix}
+The suffix to use on \idx{mfirstuse} of the multi-entry.
-\item[usedsuffix] The suffix to use on subsequent use of the
-multi-entry.
-\end{description}
+\optiondef{mglsopt.usedsuffix}
+The suffix to use on \idx{msubsequentuse} of the multi-entry.
\subsection{Skipping Elements}
\label{sec:multiglsoptionsskip}
-\begin{description}
-
-\item[\optfmt{firstskipmain}] This is a boolean setting. If
-\optfmt{true}, the main element will be omitted on (multi-entry) first use.
+\begin{information}
+The skip options apply to the multi-entry first use flag not the
+individual element first use. See \sectionref{sec:mglsfirstuse}.
+\end{information}
-\item[\optfmt{firstskipothers}] This is a boolean setting. If
-\optfmt{true}, the other (non-main) elements will be omitted on
-(multi-entry) first use.
+\optiondef{mglsopt.firstskipmain}
+If \optfmt{true}, the main element will be omitted on (multi-entry)
+\idx{mfirstuse}.
-\item[\optfmt{usedskipmain}] This is a boolean setting. If
-\optfmt{true}, the main element will be omitted on (multi-entry) subsequent use.
+\optiondef{mglsopt.firstskipothers}
+If \optfmt{true}, the other (non-main) elements will be omitted on
+(multi-entry) \idx{mfirstuse}.
-\item[\optfmt{usedskipothers}] This is a boolean setting. If
-\optfmt{true}, the other (non-main) elements will be omitted on
-(multi-entry) subsequent use.
+\optiondef{mglsopt.usedskipmain}
+If \optfmt{true}, the main element will be omitted on (multi-entry)
+\idx{msubsequentuse}.
-\end{description}
-The skip options apply to the multi-entry first use flag not the
-individual element first use. See \sectionref{sec:mglsfirstuse}.
+\optiondef{mglsopt.usedskipothers}
+If \optfmt{true}, the other (non-main) elements will be omitted on
+(multi-entry) \idx{msubsequentuse}.
Note that it is technically possible to set the skip options so that
both the main and the other elements are skipped. However, by
default, this will generate a warning and only the final optional
argument (the \meta{insert}) will be displayed. There won't be a
loop over all elements so the commands set at each iteration, such
-as \cs{mglscurrentlabel}, won't be defined.
+as \gls{mglscurrentlabel}, won't be defined.
-The warning and the
-insertion of the \meta{insert} is done by:
-\begin{definition}[\DescribeMacro\glsxtrmglsWarnAllSkipped]
-\cs{glsxtrmglsWarnAllSkipped}\marg{message}\marg{insert}\marg{cs}
-\end{definition}
+The warning and the insertion of the \meta{insert} is done by:
+\cmddef{glsxtrmglsWarnAllSkipped}
where \meta{message} is the warning message and \meta{cs} is the
control sequence that encapsulates the entire content (including
-hyperlink and the \optfmt{textformat} setting, if enabled).
+hyperlink and the \mglsopt{textformat} setting, if enabled).
If, for some particular reason, you want this scenario, you can
redefine this command to omit the warning.
@@ -9258,454 +35157,384 @@ redefine this command to omit the warning.
\subsection{General}
\label{sec:multiglsoptionsgeneral}
+\optiondef{mglsopt.multi.hyper}
+This setting may take one of the following values:
\begin{description}
-\item[\optfmt{hyper}] This setting may take one of the following
-values:
- \begin{description}
\item[\optfmt{none}] no hyperlinks;
- \item[\optfmt{allmain}] encapsulate the entire content with
+ \item[\optfmt{allmain}] encapsulate the entire content with
a single hyperlink to the main entry's target;
\item[\optfmt{mainonly}] only hyperlink the main entry;
\item[\optfmt{individual}] hyperlink each entry individually;
\item[\optfmt{otheronly}] only hyperlink the other entries;
\item[\optfmt{notmainfirst}] don't hyperlink the main entry on
- multi-entry first use;
+ \idxn{mfirstuse};
\item[\optfmt{nototherfirst}] don't hyperlink the other entries on
- multi-entry first use;
+ \idxn{mfirstuse};
\item[\optfmt{notfirst}] don't hyperlink any entries on
- multi-entry first use.
- \end{description}
- The default is \optfmt{individual}.
+ \idxn{mfirstuse}.
+\end{description}
-\item[\optfmt{textformat}] This setting value should be the control
-sequence name (without the leading backslash) of the command used to
-encapsulate the entire content. The default is \texttt{@firstofone}.
+\optiondef{mglsopt.textformat}
+This setting value should be the control sequence name (without the
+leading backslash) of the command used to encapsulate the entire
+content.
-\item[\optfmt{category}] The category to apply to the
-multi-entry. This is independent of the categories of each of the elements.
-The default is no category. See \sectionref{sec:multiglscategory}.
+\optiondef{mglsopt.category}
+The category to apply to the multi-entry. This is independent of the
+categories of each of the elements. The default is no category. See
+\sectionref{sec:multiglscategory}.
-\item[\optfmt{mglsopts}] Default options to pass to \cs{mgls}.
-Note that \optfmt{setup} can't be used within this value.
+\optiondef{mglsopt.mglsopts}
+Default options to pass to commands like \gls{mgls}.
+Note that \mglsopt{setup} can't be used within this value.
-\end{description}
-
-\section{\headingcs{mgls} Options}
+\section{\glsfmtname{mgls} Options}
\label{sec:mglsopts}
-The \meta{options} for \cs{mgls} (and similar commands) are listed below.
-Any additional options provided will be appended to the \optfmt{all}
+The \meta{options} for \gls{mgls} (and similar commands) are listed below.
+Any additional options provided will be appended to the \mglsopt{all}
value. For example:
-\begin{verbatim}
-\mgls[counter=chapter]{cbot}
-\end{verbatim}
+\begin{codebox}
+\gls{mgls}\oarg{\glsoptval{counter}{chapter}}\marg{cbot}
+\end{codebox}
is equivalent to:
-\begin{verbatim}
-\mgls[all={counter=chapter}]{cbot}
-\end{verbatim}
+\begin{codebox}
+\gls{mgls}\oarg{\mglsoptval{all}{\glsoptval{counter}{chapter}}}\marg{cbot}
+\end{codebox}
Whereas:
-\begin{verbatim}
-\mgls[counter=chapter,all={counter=section}]{cbot}
-\end{verbatim}
+\begin{codebox}
+\gls{mgls}\oarg{\glsoptval{counter}{chapter},\mglsoptval{all}{\glsoptval{counter}{section}}}\marg{cbot}
+\end{codebox}
is treated as:
-\begin{verbatim}
-\mgls[all={counter=section,counter=chapter}]{cbot}
-\end{verbatim}
+\begin{codebox}
+\gls{mgls}\oarg{\mglsoptval{all}{\glsoptval{counter}{section},\glsoptval{counter}{chapter}}}\marg{cbot}
+\end{codebox}
which has the same effect as:
-\begin{verbatim}
-\mgls[all={counter=chapter}]{cbot}
-\end{verbatim}
-(The descriptions below reference \cs{gls} which is used internally
-by \cs{mgls}. Replace this with \cs{glspl} etc as applicable for the
-variants, such as \cs{mglspl}.)
-
-\begin{description}
-\item[\optfmt{setup}] The value should be a list of any options that
-can be passed to \cs{multiglossaryentrysetup}. These options will
-override any conflicting options that were supplied to \cs{multiglossaryentry}
-or \cs{multiglossaryentrysetup}. Note that \optfmt{mgls} can't be
+\begin{codebox}
+\gls{mgls}\oarg{\mglsoptval{all}{\glsoptval{counter}{chapter}}}\marg{cbot}
+\end{codebox}
+
+\begin{information}
+The descriptions below reference \gls{gls} which is used internally
+by \gls{mgls}. Replace this with \gls{glspl} etc as applicable for the
+variants, such as \gls{mglspl}.
+\end{information}
+
+\optiondef{mglsopt.setup}
+The value should be a list of any options that can be passed to
+\gls{multiglossaryentrysetup}. These options will override any
+conflicting options that were supplied to \gls{multiglossaryentry}
+or \gls{multiglossaryentrysetup}. Note that \mglsopt{mglsopts} can't be
used within this value.
-\item[\optfmt{all}] The value should be a list of any options that
-can be passed to \cs{gls}. These options will be passed to each
-instance of \cs{gls} and will override any conflicting setting in
-\optfmt{setup}.
-
-\item[\optfmt{main}] The value should be a list of any options that
-can be passed to \cs{gls}. These options will be passed to the
-instance of \cs{gls} used for the main label and will override any
-conflicting setting in \optfmt{all}.
-
-\item[\optfmt{others}] The value should be a list of any options that
-can be passed to \cs{gls}. These options will be passed to each
-instance of \cs{gls} used for the other (not main) labels and will
-override any conflicting setting in \optfmt{all}.
-
-\item[\optfmt{hyper}] a boolean option to determine whether or not
-to use hyperlinks (if supported). This may cause a conflict with
-other options, but is essentially provided to allow the starred
-version of \cs{mgls} to switch off all hyperlinks.
-
-\item[\optfmt{multiunset}] This only applies to the multi-entry
-first use flag, described in \sectionref{sec:mglsfirstuse}, not the
-\glspl{firstuseflag} of the elements. The value may be one of:
+\optiondef{mglsopt.all}
+The value should be a list of any options that can be passed to
+\gls{gls}. These options will be passed to each instance of
+\gls{gls} and will override any conflicting setting in
+\mglsopt{setup}.
+
+\optiondef{mglsopt.main}
+The value should be a list of any options that
+can be passed to \gls{gls}. These options will be passed to the
+instance of \gls{gls} used for the main label and will override any
+conflicting setting in \mglsopt{all}.
+
+\optiondef{mglsopt.others}
+The value should be a list of any options that
+can be passed to \gls{gls}. These options will be passed to each
+instance of \gls{gls} used for the other (not main) labels and will
+override any conflicting setting in \mglsopt{all}.
+
+\optiondef{mglsopt.hyper}
+A boolean option to determine whether or not to use hyperlinks (if
+supported). This may cause a conflict with other options, but is
+essentially provided to allow the starred version of \gls{mgls} to
+switch off all hyperlinks.
+
+\optiondef{mglsopt.multiunset}
+This only applies to the \idx{mfirstuseflag}, described in
+\sectionref{sec:mglsfirstuse}, not the \idxpl{firstuseflag} of the
+elements. The value may be one of:
\begin{description}
-\item \optfmt{global} globally unset the flag (default);
+\item \optfmt{global} globally unset the flag;
\item \optfmt{local} locally unset the flag;
\item \optfmt{none} don't unset the flag.
\end{description}
-\item[\optfmt{presetlocal}] a boolean option that governs whether or
-not the following options should have a local or global effect.
-The default is \optfmt{presetlocal=false} (global).
-
-\item[\optfmt{resetall}] a boolean option to determine whether or not
-to reset all entries in \meta{label list} \emph{before} using \cs{gls}.
-This option refers to the individual entry's \gls{firstuseflag} not
-the multi-set flag.
-
-\item[\optfmt{resetmain}] a boolean option to determine whether or not
-to reset the main entry \emph{before} using \cs{gls}.
-This option refers to the individual entry's \gls{firstuseflag} not
-the multi-set flag.
-
-\item[\optfmt{resetothers}] a boolean option to determine whether or not
-to reset the other (not main) entries \emph{before} using \cs{gls}.
-This option refers to the individual entry's \gls{firstuseflag} not
-the multi-set flag.
-
-\item[\optfmt{unsetall}] a boolean option to determine whether or not
-to unset all entries in \meta{label list} \emph{before} using \cs{gls}.
-This option refers to the individual entry's \gls{firstuseflag} not
-the multi-set flag.
-
-\item[\optfmt{unsetmain}] a boolean option to determine whether or not
-to unset the main entry \emph{before} using \cs{gls}.
-This option refers to the individual entry's \gls{firstuseflag} not
-the multi-set flag.
-
-\item[\optfmt{unsetothers}] a boolean option to determine whether or not
-to unset the other (not main) entries \emph{before} using \cs{gls}.
-This option refers to the individual entry's \gls{firstuseflag} not
-the multi-set flag.
-\end{description}
+\optiondef{mglsopt.presetlocal}
+A boolean option that governs whether or not the following options
+should have a local or global effect.
+
+\optiondef{mglsopt.resetall}
+A boolean option to determine whether or not to reset all elements
+\emph{before} using \gls{gls}. This option refers to the individual
+entry's \idx{firstuseflag} not the \idx{mfirstuseflag}.
+(This is similar to passing \glsopt{prereset} to each \gls{gls} but
+it's also applied to any skipped elements.)
+
+\optiondef{mglsopt.resetmain}
+A boolean option to determine whether or not
+to reset the main entry's \idx{firstuseflag} \emph{before} using
+\gls{gls}.
+
+\optiondef{mglsopt.resetothers}
+A boolean option to determine whether or not to reset the
+\idx{firstuseflag} of all the other (not main) elements
+\emph{before} using \gls{gls}.
+
+\optiondef{mglsopt.unsetall}
+A boolean option to determine whether or not to unset all elements
+\emph{before} using \gls{gls}. This option refers to the individual
+entry's \idx{firstuseflag} not the \idx{mfirstuseflag}.
+(This is similar to passing \glsopt{preunset} to each \gls{gls} but
+it's also applied to any skipped elements.)
+
+\optiondef{mglsopt.unsetmain}
+A boolean option to determine whether or not
+to unset the main entry's \idx{firstuseflag} \emph{before} using
+\gls{gls}.
+
+\optiondef{mglsopt.unsetothers}
+A boolean option to determine whether or not to unset the
+\idx{firstuseflag} of all the other (not main) elements
+\emph{before} using \gls{gls}.
+
The \optfmt{reset\ldots} options all use:
-\begin{definition}[\DescribeMacro\mglselementreset]
-\cs{mglselementreset}\marg{label}
-\end{definition}
+\cmddef{mglselementreset}
The \optfmt{unset\ldots} options all use:
-\begin{definition}[\DescribeMacro\mglselementunset]
-\cs{mglselementunset}\marg{label}
-\end{definition}
-These take the \optfmt{presetlocal} into account.
+\cmddef{mglselementunset}
+These take the \mglsopt{presetlocal} into account.
An alternative way of resetting the other elements is to use:
-\begin{definition}[\DescribeMacro\mglsunsetothers]
-\cs{mglsunsetothers}\marg{multi-label}
-\end{definition}
+\cmddef{mglsunsetothers}
or for a local reset:
-\begin{definition}[\DescribeMacro\mglslocalunsetothers]
-\cs{mglslocalunsetothers}\marg{multi-label}
-\end{definition}
+\cmddef{mglslocalunsetothers}
-\section{Variants of \headingcs{mgls}}
+\section{Variants of \glsfmtname{mgls}}
\label{sec:mglslike}
-The commands listed in this section all behave like \cs{mgls}. These
-(including \cs{mgls} itself) are collectively referred to as the
-\cs{mgls}-like commands. All commands unset the multi-entry first
-use flag (unless the \optfmt{multiunset=none} option is applied). Only
-those commands that use the \cs{gls}-like commands (such as \cs{gls}
-or \cs{glspl}) will unset the individual entry \gls{firstuseflag}.
+The commands listed in this section all behave like \gls{mgls}. These
+(including \gls{mgls} itself) are collectively referred to as the
+\gls{mgls}-like commands. All commands unset the \idx{mfirstuseflag}
+(unless the \mglsoptval{multiunset}{none} option is applied). Only
+those commands that use the \idx{glslike} commands (such as \gls{gls}
+or \gls{glspl}) will unset the individual entry's \idx{firstuseflag}.
-\subsection{\headingcs{gls}-like}
+\subsection{\glsfmtname{gls}-like}
\label{sec:mglsbasic}
-\begin{definition}[\DescribeMacro\mglspl]
-\cs{mglspl}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-This uses \cs{glspl} instead of \cs{gls} for each entry.
-
-\begin{definition}[\DescribeMacro\mglsmainpl]
-\cs{mglsmainpl}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-This uses \cs{glspl} instead of \cs{gls} for the main entry and
-\cs{gls} for all the other entries.
-
-\begin{definition}[\DescribeMacro\Mgls]
-\cs{Mgls}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-This uses \cs{Gls} for the first entry and \cs{gls} for the other
-entries.
+\cmddef{mglspl}
+This uses \gls{glspl} instead of \gls{gls} for each entry.
-\begin{definition}[\DescribeMacro\MGls]
-\cs{MGls}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-This uses \cs{Gls} for all entries.
+\cmddef{mglsmainpl}
+This uses \gls{glspl} instead of \gls{gls} for the main entry and
+\gls{gls} for all the other entries.
-\begin{definition}[\DescribeMacro\Mglspl]
-\cs{Mglspl}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-This uses \cs{Glspl} for the first entry and \cs{glspl} for the other
+\cmddef{Mgls}
+This uses \gls{Gls} for the first entry and \gls{gls} for the other
entries.
-\begin{definition}[\DescribeMacro\Mglsmainpl]
-\cs{Mglsmainpl}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-The first entry starts with an upper case. The plural form is used
-for the main entry.
-
-\begin{definition}[\DescribeMacro\MGlspl]
-\cs{MGlspl}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-This uses \cs{Glspl} for all entries.
-
-\begin{definition}[\DescribeMacro\MGlsmainpl]
-\cs{MGlsmainpl}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-This uses \cs{Glspl} for the main entry and \cs{Gls} for all other entries.
-
-\begin{definition}[\DescribeMacro\MGLS]
-\cs{MGLS}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-This uses \cs{GLS} instead of \cs{gls} for each entry.
-
-\begin{definition}[\DescribeMacro\MGLSpl]
-\cs{MGLSpl}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-This uses \cs{GLSpl} instead of \cs{gls} for each entry.
-
-\begin{definition}[\DescribeMacro\MGLSmainpl]
-\cs{MGLSmainpl}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-This uses all caps for all entries and \cs{GLSpl} for the main
-entry.
+\cmddef{MGls}
+This uses \gls{Gls} for all entries.
+
+\cmddef{Mglspl}
+This uses \gls{Glspl} for the first entry and \gls{glspl} for the
+remaining entries.
+
+\cmddef{Mglsmainpl}
+The first entry uses the appropriate \idx{sentencecase} command. The
+plural form is used for the main entry. So, if the first entry is
+also the main entry, \gls{Glspl} is used, otherwise \gls{Gls} is
+used. For the remaining entries, \gls{glspl} will be used if the
+entry is the main one, otherwise \gls{gls} will be used.
+
+\cmddef{MGlspl}
+This uses \gls{Glspl} for all entries.
+
+\cmddef{MGlsmainpl}
+This uses \gls{Glspl} for the main entry and \gls{Gls} for the other entries.
+
+\cmddef{MGLS}
+This uses \gls{GLS} for all entries.
+
+\cmddef{MGLSpl}
+This uses \gls{GLSpl} instead of \gls{gls} for each entry.
+
+\cmddef{MGLSmainpl}
+This uses \gls{GLSpl} for the main entry and \gls{GLS} for the others.
\subsection{Abbreviations}
\label{sec:mglsabbrv}
-\begin{definition}[\DescribeMacro\mglsshort]
-\cs{mglsshort}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-This will use \cs{glsxtrshort} for any entries that have the
-\gloskey{short} key set and will use \cs{glstext} otherwise.
-
-\begin{definition}[\DescribeMacro\mglslong]
-\cs{mglslong}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-This will use \cs{glsxtrlong} for any entries that have the
-\gloskey{long} key set and will use \cs{glstext} otherwise.
-
-\begin{definition}[\DescribeMacro\mglsfull]
-\cs{mglsfull}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-This will use \cs{glsxtrfull} for any entries that have the
-\gloskey{short} key set and will use \cs{glsfirst} otherwise.
-
-\begin{definition}[\DescribeMacro\Mglsshort]
-\cs{Mglsshort}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-As \cs{mglsshort} but with an initial capital on the first entry.
-
-\begin{definition}[\DescribeMacro\Mglslong]
-\cs{Mglslong}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-As \cs{mglslong} but with an initial capital on the first entry.
-
-\begin{definition}[\DescribeMacro\Mglsfull]
-\cs{Mglsfull}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-As \cs{mglsfull} but with an initial capital on the first entry.
+\cmddef{mglsshort}
+This will use \gls{glsxtrshort} for any entries that have the
+\gloskey{short} field set and will use \gls{glstext} otherwise.
+
+\cmddef{mglslong}
+This will use \gls{glsxtrlong} for any entries that have the
+\gloskey{long} field set and will use \gls{glstext} otherwise.
+
+\cmddef{mglsfull}
+This will use \gls{glsxtrfull} for any entries that have the
+\gloskey{short} field set and will use \gls{glsfirst} otherwise.
+
+\cmddef{Mglsshort}
+As \gls{mglsshort} but \idx{sentencecase} for the first entry.
+
+\cmddef{Mglslong}
+As \gls{mglslong} but \idx{sentencecase} for the first entry.
+
+\cmddef{Mglsfull}
+As \gls{mglsfull} but \idx{sentencecase} for the first entry.
\subsection{Other Fields}
\label{sec:mglsotherfields}
-\begin{definition}[\DescribeMacro\mglsname]
-\cs{mglsname}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-This uses \cs{glsname} instead of \cs{gls} for each entry.
-
-\begin{definition}[\DescribeMacro\MGlsname]
-\cs{MGlsname}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-This uses \cs{Glsname} instead of \cs{gls} for each entry.
-
-\begin{definition}[\DescribeMacro\Mglsname]
-\cs{Mglsname}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-This uses \cs{Glsname} instead of \cs{gls} for the first entry and
-\cs{glsname} for all the other entries.
-
-\begin{definition}[\DescribeMacro\mglssymbol]
-\cs{mglssymbol}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-This uses \cs{glssymbol} if the \gloskey{symbol} key has been set
-otherwise it uses \cs{gls} for each element.
-
-\begin{definition}[\DescribeMacro\MGlssymbol]
-\cs{MGlssymbol}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-This uses \cs{glssymbol} if the \gloskey{symbol} key has been set
-otherwise it uses \cs{Gls} for each element. (Note that no case
-change is applied to the symbol as this usually isn't appropriate.)
-
-\begin{definition}[\DescribeMacro\Mglssymbol]
-\cs{Mglssymbol}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-As above, but \cs{Gls} is only used for the first element (if it
-doesn't have the \gloskey{symbol} key set).
-
-\begin{definition}[\DescribeMacro\mglsusefield]
-\cs{mglsusefield}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-Use \texttt{\cs{glsdisp}\marg{label}\glsopenbrace\meta{field
-value}\meta{insert}\glsclosebrace} if the field given by:
-\begin{definition}[\DescribeMacro\mglsfield]
-\cs{mglsfield}
-\end{definition}
-exists, otherwise use \cs{gls}. By default, this is \texttt{useri}
-(corresponding to the \gloskey{user1} key). If you redefine
-\cs{mglsfield}, you will need to use the internal name.
-
-\begin{definition}[\DescribeMacro\Mglsusefield]
-\cs{Mglsusefield}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-As \cs{mglsusefield} but the first element starts with an initial
-uppercase.
-
-\begin{definition}[\DescribeMacro\MGlsusefield]
-\cs{MGlsusefield}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-As \cs{mglsusefield} but each element starts with an initial
-uppercase.
-
-You can use the pre-element hook \cs{mglselementprehook} to locally
-redefine \cs{mglsfirst}. Examples:
+\cmddef{mglsname}
+This uses \gls{glsname} for each entry.
+
+\cmddef{Mglsname}
+This uses \gls{Glsname} for the first entry and \gls{glsname} for
+the remaining entries.
+
+\cmddef{MGlsname}
+This uses \gls{Glsname} for each entry.
+
+\cmddef{mglssymbol}
+This uses \gls{glssymbol} for each entry if the \gloskey{symbol}
+field has been set, otherwise it uses \gls{gls}.
+
+\cmddef{MGlssymbol}
+This uses \gls{glssymbol} if the \gloskey{symbol} field has been set
+otherwise it uses \gls{Gls} for each element. (Note that no
+\idx{casechange} is applied to the symbol as this usually isn't appropriate.)
+
+\cmddef{Mglssymbol}
+As \gls{MGlssymbol}, but \gls{Gls} is only used for the first element (if it
+doesn't have the \gloskey{symbol} field set).
+
+\cmddef{mglsusefield}
+If the field given by \gls{mglsfield} exists for an element,
+\gls{glsdisp} will be used for that element, with the \idx{linktext}
+obtained from the field value (followed by the \meta{insert}),
+otherwise \gls{gls} will be used.
+
+\cmddef{mglsfield}
+This command expands to the \idx{internalfieldlabel} required by
+\gls{mglsusefield}. The default value is \code{useri}, which
+corresponds to the \gloskey{user1} key.
+
+\cmddef{Mglsusefield}
+As \gls{mglsusefield} but \idx{sentencecase} for the first
+element.
+
+\cmddef{MGlsusefield}
+As \gls{mglsusefield} but \idx{sentencecase} for each
+element.
+
+You can use the pre-element hook \gls{mglselementprehook} to locally
+redefine \gls{mglsfield}. Examples:
\begin{enumerate}
\item if the multi-category is \qt{sample} then use the
\gloskey{user2} field otherwise use the \gloskey{user1} field:
-\begin{verbatim}
-\renewcommand{\mglselementprehook}{%
- \ifdefstring{\mglscurrentcategory}{sample}%
- {\renewcommand{\mglsfield}{userii}}%
- {\renewcommand{\mglsfield}{useri}}%
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{mglselementprehook}}\marg{\%
+ \cmd{ifdefstring}\marg{\gls{mglscurrentcategory}}\marg{sample}\%
+ \marg{\cmd{renewcommand}\marg{\gls{mglsfield}}\marg{userii}}\%
+ \marg{\cmd{renewcommand}\marg{\gls{mglsfield}}\marg{useri}}\%
}
-\end{verbatim}
+\end{codebox}
\item if the element's category is \qt{sample} then use the
\gloskey{user2} field otherwise use the \gloskey{user1} field:
-\begin{verbatim}
-\renewcommand{\mglselementprehook}{%
- \glsifcategory{\mglscurrentlabel}{sample}%
- {\renewcommand{\mglsfield}{userii}}%
- {\renewcommand{\mglsfield}{useri}}%
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{mglselementprehook}}\marg{\%
+ \gls{glsifcategory}\marg{\gls{mglscurrentlabel}}\marg{sample}\%
+ \marg{\cmd{renewcommand}\marg{\gls{mglsfield}}\marg{userii}}\%
+ \marg{\cmd{renewcommand}\marg{\gls{mglsfield}}\marg{useri}}\%
}
-\end{verbatim}
+\end{codebox}
-\item if either the multi-entry's category or the element's category
-has the custom attribute \qt{mglsfield} set then use it otherwise use
+\item if either the multi-entry's category or the element's category
+has the custom attribute \qt{mglsfield} set then use it otherwise use
the \gloskey{user1} field:
-\begin{verbatim}
-\renewcommand{\mglselementprehook}{%
- \glshascategoryattribute{\mglscurrentcategory}{mglsfield}%
- {\renewcommand{\mglsfield}{\glsgetcategoryattribute{\mglscurrentcategory}{mglsfield}}}%
- {%
- \glshasattribute{\mglscurrentlabel}{mglsfield}%
- {\renewcommand{\mglsfield}{\glsgetattribute{\mglscurrentlabel}{mglsfield}}}%
- {\renewcommand{\mglsfield}{useri}}%
- }%
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{mglselementprehook}}\marg{\%
+ \gls{glshascategoryattribute}\marg{\gls{mglscurrentcategory}}\marg{mglsfield}\%
+ \marg{\cmd{renewcommand}\marg{\gls{mglsfield}}\marg{\gls{glsgetcategoryattribute}\marg{\gls{mglscurrentcategory}}\marg{mglsfield}}}\%
+ \marg{\%
+ \gls{glshasattribute}\marg{\gls{mglscurrentlabel}}\marg{mglsfield}\%
+ \marg{\cmd{renewcommand}\marg{\gls{mglsfield}}\marg{\gls{glsgetattribute}\marg{\gls{mglscurrentlabel}}\marg{mglsfield}}}\%
+ \marg{\cmd{renewcommand}\marg{\gls{mglsfield}}\marg{useri}}\%
+ }\%
}
-\end{verbatim}
+\end{codebox}
\end{enumerate}
-\subsection{Support for \headingsty{glossaries-prefix} (\headingcs{pgls})}
+\subsection{Support for \glsfmtname{pkg.glossaries-prefix} (\glsfmtname{pgls})}
\label{sec:mpgls}
If you load the \sty{glossaries-prefix} package (either after
-\styfmt{glossaries-extra}) or with the \pkgopt{prefix} package
+\sty{glossaries-extra}) or with the \opt{prefix} package
option, then the following commands will use one of the
-\cs{pgls}-like commands provided by that package. (See the
-\styfmt{glossaries} user manual for further details.)
-
-If the \styfmt{glossaries-prefix} package hasn't been loaded then
-\cs{gls} (or analogous case-changing variant) will be used instead
-and a warning is issued. The warning can be removed by redefining
-the following to do nothing:
-\begin{definition}[\DescribeMacro\mpglsWarning]
-\cs{mpglsWarning}
-\end{definition}
-
-\begin{definition}[\DescribeMacro\mpgls]
-\cs{mpgls}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-Uses \cs{pgls} for the first element and \cs{gls} for the remaining
+\gls{pgls}-like commands provided by that package. (See the
+\sty{glossaries} user manual for further details.)
+
+If the \sty{glossaries-prefix} package hasn't been loaded then
+\gls{gls} (or analogous case-changing variant) will be used instead
+and a warning is issued with:
+\cmddef{mpglsWarning}
+This may be redefined to do nothing to remove the warning.
+
+\cmddef{mpgls}
+Uses \gls{pgls} for the first element and \gls{gls} for the remaining
elements.
-\begin{definition}[\DescribeMacro\mpglspl]
-\cs{mpglspl}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-Uses \cs{pglspl} for the first element and \cs{glspl} for the remaining
+\cmddef{mpglspl}
+Uses \gls{pglspl} for the first element and \gls{glspl} for the remaining
elements.
-\begin{definition}[\DescribeMacro\mpglsmainpl]
-\cs{mpglsmainpl}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
+\cmddef{mpglsmainpl}
Only uses the plural form for the main element. The first element
-uses the prefixing command (\cs{pgls} or \cs{pglspl}, depending on
+uses the prefixing command (\gls{pgls} or \gls{pglspl}, depending on
whether the first element is the main element).
-\begin{definition}[\DescribeMacro\Mpgls]
-\cs{Mpgls}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-Uses \cs{Pgls} for the first element and \cs{gls} for the remaining
+\cmddef{Mpgls}
+Uses \gls{Pgls} for the first element and \gls{gls} for the remaining
elements.
-\begin{definition}[\DescribeMacro\Mpglsmainpl]
-\cs{Mpglsmainpl}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
+\cmddef{Mpglsmainpl}
Only uses the plural form for the main element. The first element
-uses the first-letter uppercase prefixing command
-(\cs{Pgls} or \cs{Pglspl}, depending on whether the first element is
-the main element).
+uses the \idx{sentencecase} prefixing command (\gls{Pgls} or
+\gls{Pglspl}, depending on whether the first element is the main
+element).
-\begin{definition}[\DescribeMacro\MPGls]
-\cs{MPGls}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-Uses \cs{Pgls} for the first element and \cs{Gls} for the remaining
+\cmddef{MPGls}
+Uses \gls{Pgls} for the first element and \gls{Gls} for the remaining
elements.
-\begin{definition}[\DescribeMacro\MPGlspl]
-\cs{MPGlspl}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-Uses \cs{Pglspl} for the first element and \cs{Glspl} for the remaining
+\cmddef{MPGlspl}
+Uses \gls{Pglspl} for the first element and \gls{Glspl} for the remaining
elements.
-\begin{definition}[\DescribeMacro\MPGlsmainpl]
-\cs{MPGlsmainpl}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
+\cmddef{MPGlsmainpl}
Only uses the plural form for the main element. The first element
-uses the prefixing command (\cs{Pgls} or \cs{Pglspl}, depending on
+uses the prefixing command (\gls{Pgls} or \gls{Pglspl}, depending on
whether the first element is the main element). All elements are
-converted to first letter uppercase.
+use \idx{sentencecase}.
-\begin{definition}[\DescribeMacro\MPGLS]
-\cs{MPGLS}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-Uses \cs{PGLS} for the first element and \cs{GLS} for the remaining
+\cmddef{MPGLS}
+Uses \gls{PGLS} for the first element and \gls{GLS} for the remaining
elements.
-\begin{definition}[\DescribeMacro\MPGLSpl]
-\cs{MPGLSpl}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
-Uses \cs{PGLSpl} for the first element and \cs{GLSpl} for the remaining
+\cmddef{MPGLSpl}
+Uses \gls{PGLSpl} for the first element and \gls{GLSpl} for the remaining
elements.
-\begin{definition}[\DescribeMacro\MPGLSmainpl]
-\cs{MPGLSmainpl}\oarg{options}\marg{multi-label}\oarg{insert}
-\end{definition}
+\cmddef{MPGLSmainpl}
Only uses the plural form for the main element. All elements are
-converted to uppercase. The first element uses the prefixing command
-(\cs{PGLS} or \cs{PGLSpl}, depending on whether the first element is
+converted to \idx{allcaps}. The first element uses the prefixing command
+(\gls{PGLS} or \gls{PGLSpl}, depending on whether the first element is
the main element).
\section{Cross-References}
@@ -9714,141 +35543,118 @@ the main element).
Multi-entry labels may be used in the cross-referencing keys
\gloskey{see} and \gloskey{seealso}. The formatting command will
use:
-\begin{definition}[\DescribeMacro\mglsseefirstitem]
-\cs{mglsseefirstitem}\marg{label}
-\end{definition}
+\cmddef{mglsseefirstitem}
for the first item in the list (if it's a multi-entry) and
-\begin{definition}[\DescribeMacro\mglsseeitem]
-\cs{mglsseeitem}\marg{label}
-\end{definition}
+\cmddef{mglsseeitem}
for any subsequent items that are multi-entries. The default
-definition of \cs{mglsseeitem} is:
-\begin{verbatim}
-\newcommand*{\mglsseeitem}[1]{%
- \mglsname[all={noindex},setup={hyper=allmain}]{#1}%
+definition of \gls{mglsseeitem} is:
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{mglsseeitem}}[1]\marg{\%
+ \gls{mglsname}\oarg{\mglsoptval{all}{noindex},\mglsoptvalm{setup}{hyper=allmain}}\marg{\#1}\%
}
-\end{verbatim}
+\end{compactcodebox}
This switches off indexing, sets the hyperlink to encompass the
entire multi-entry content and uses the \gloskey{name} field.
-The default definition of \cs{mglsseefirstitem} is simply
-\cs{mglsseeitem}.
+The default definition of \gls{mglsseefirstitem} is simply
+\gls{mglsseeitem}.
For example, to use the \gloskey{short} or \gloskey{text} fields:
-\begin{verbatim}
-\renewcommand*{\mglsseeitem}[1]{%
- \mglsshort[all={noindex},setup={hyper=allmain}]{#1}%
+\begin{compactcodebox}
+\cmd{renewcommand}*\marg{\gls{mglsseeitem}}[1]\marg{\%
+ \gls{mglsshort}\oarg{\mglsoptval{all}{noindex},\mglsoptvalm{setup}{hyper=allmain}}\marg{\#1}\%
}
-\end{verbatim}
+\end{compactcodebox}
A multi-entry label may also be used in the \gloskey{alias} key. The
hyperlink target will be the target for the main entry. For example:
-\begin{verbatim}
-\multiglossaryentry{cbot}{clostridium,botulinum}
-\newglossaryentry{botox}{name=botox,description={},alias={cbot}}
-\end{verbatim}
-In this case \verb|\gls{botox}| will hyperlink to the
-\texttt{botulinum} target.
+\begin{codebox}
+\gls{multiglossaryentry}\marg{cbot}\marg{clostridium,botulinum}
+\gls{newglossaryentry}\marg{botox}\marg{\gloskeyval{name}{botox},\gloskeyval{description}{},\gloskeyval{alias}{cbot}}
+\end{codebox}
+In this case \code{\gls{gls}\marg{botox}} will hyperlink to the
+\code{botulinum} target.
\begin{important}
Any multi-entries used in the cross-referencing keys must be defined
before the glossary is displayed. There is some support for
-\pkgopt[true]{docdef} but not for the other \pkgopt{docdef} settings.
+\optval{docdef}{true} but not for the other \opt{docdef} settings.
\end{important}
\section{Additional Commands}
\label{sec:multiextras}
You can test if a label represents a multi-entry using:
-\begin{definition}[\DescribeMacro\glsxtrifmulti]
-\cs{glsxtrifmulti}\marg{label}\marg{true}\marg{false}
-\end{definition}
-The following command will expand to the main entry label for
-the given multi-entry label:
-\begin{definition}[\DescribeMacro\glsxtrmultimain]
-\cs{glsxtrmultimain}\marg{multi-label}
-\end{definition}
-This will expand to nothing if the supplied \meta{multi-label}
-hasn't been defined as a multi-entry. Similarly, for the complete
-label list:
-\begin{definition}[\DescribeMacro\glsxtrmultilist]
-\cs{glsxtrmultilist}\marg{multi-label}
-\end{definition}
-
-To iterate over all the list of all elements:
-\begin{definition}[\DescribeMacro\mglsforelements]
-\cs{mglsforelements}\marg{multi-label}\marg{cs}\marg{body}
-\end{definition}
-This defines \meta{cs} to the current element label on each
+\cmddef{glsxtrifmulti}
+This does \meta{true} if a multi-entry has been defined with
+the label \meta{multi-label} otherwise it does \meta{false}.
+
+\cmddef{glsxtrmultimain}
+Expands to the main entry label for the multi-entry identified by
+\meta{multi-label} or nothing if not defined.
+
+\cmddef{glsxtrmultilist}
+Expands to the list of element labels for the multi-entry identified by
+\meta{multi-label} or nothing if not defined.
+
+\cmddef{mglsforelements}
+Iterates over all the list of element labels for the multi-entry identified by
+\meta{multi-label}. This defines \meta{cs} to the current element label on each
iteration of the loop, which can be used to reference the label in
-\meta{body}. This internally uses \cs{@for} (patched by the
-\sty{xfor} package).
-
-There is a similar command that skips the main element:
-\begin{definition}[\DescribeMacro\mglsforotherelements]
-\cs{mglsforotherelements}\marg{multi-label}\marg{cs}\marg{body}
-\end{definition}
-
-The total number of elements can be obtained with:
-\begin{definition}[\DescribeMacro\glsxtrmultitotalelements]
-\cs{glsxtrmultitotalelements}\marg{multi-label}
-\end{definition}
-This expands to the number, if \meta{multi-label} is defined,
-otherwise expands to nothing.
-
-The index of the main element can be obtained with:
-\begin{definition}[\DescribeMacro\glsxtrmultimainindex]
-\cs{glsxtrmultimainindex}\marg{multi-label}
-\end{definition}
-This expands to the index, if \meta{multi-label} is defined,
-otherwise expands to nothing. Indexing starts from 1 for the first
-element. The index of the final non-main element can be obtained
-with:
-\begin{definition}[\DescribeMacro\glsxtrmultilastotherindex]
-\cs{glsxtrmultilastotherindex}\marg{multi-label}
-\end{definition}
-
-The \cs{multiglossaryentry} command will write the label information
-to the \filetype{aux} file using:
-\begin{definition}[\DescribeMacro\writemultiglossentry]
-\cs{writemultiglossentry}\marg{options}\marg{multi-label}\marg{main-label}\marg{list}
-\end{definition}
-This is will write the following line to the \filetype{aux} file:
-\begin{definition}
-\cs{@glsxtr@multientry}\marg{options}\marg{multi-label}\marg{main-label}\marg{list}
-\end{definition}
-This is provided to support \pkgopt[true]{docdef} and also
+\meta{body}. This internally uses \gls{@for} (patched by the
+\sty{xfor} package, which allows the loop to be broken).
+
+\cmddef{mglsforotherelements}
+As \gls{mglsforelements} but skips the main entry label.
+
+\cmddef{glsxtrmultitotalelements}
+Expands to the total number of elements in the given multi-entry or nothing if
+\meta{multi-label} hasn't been defined.
+
+\cmddef{glsxtrmultimainindex}
+Expands to the index of the main element in the given multi-entry or nothing if
+\meta{multi-label} hasn't been defined. Indexing starts from 1 for the first
+element.
+
+\cmddef{glsxtrmultilastotherindex}
+Expands to the index of the final non-main element in the given
+multi-entry or nothing if \meta{multi-label} hasn't been defined.
+
+The \gls{multiglossaryentry} command will write the label information
+to the \ext{aux} file using:
+\cmddef{writemultiglossentry}
+This is will write the following line to the \ext+{aux} file:
+\cmddef{@glsxtr@multientry}
+This is provided to support \optval{docdef}{true} and also
for the benefit of any tools that require the
-information (such as \gls{bib2gls} or autocompletion tools).
+information (such as \app{bib2gls} or autocompletion tools).
If it's not required and causes too much clutter, it can
-be disabled by redefining \cs{writemultiglossentry} to do nothing.
+be disabled by redefining \gls{writemultiglossentry} to do nothing.
-\section{\headingapp{bib2gls}}
+\section{\glsfmtname{app.bib2gls}}
\label{sec:mbib2gls}
-In the \gls{bib2gls} v2.9+ user manual, these multi-entry sets are
+In the \app{bib2gls} v2.9+ user manual, these multi-entry sets are
referred to as \qt{compound entries} or \qt{compound sets} to
-differentiate them from \gls{bib2gls}['s] multi-entry types (such as
-\texttt{@dualentry}).
+differentiate them from \app{bib2gls}['s] multi-entry types (such as
+\atentry{dualentry}).
-Each instance of one of the \cs{mgls}-like commands is written to
-the \filetype{aux} file and so can be picked up by \gls{bib2gls}
-(at least version 2.9). The resource options can be used to
+Each instance of one of the \gls{mgls}-like commands is written to
+the \ext{aux} file and so can be picked up by \app{bib2gls}
+(at least version 2.9). The \idx{resourceopt} can be used to
determine whether or not to consider the other (non-main) elements
to be dependent on the main element.
-With \gls{bib2gls}, you can either define the compound entries in
-the document with \cs{multiglossaryentry} (or
-\cs{providemultiglossaryentry}) or you can use the \texttt{@compoundset}
-entry type in a \filetype{bib} file. Whichever method you use,
+With \app{bib2gls}, you can either define the compound entries in
+the document with \gls{multiglossaryentry} (or
+\gls{providemultiglossaryentry}) or you can use the \atentry{compoundset}
+entry type in a \ext{bib} file. Whichever method you use,
remember that the entries that form the elements of the set must be
-defined first. See the \gls{bib2gls} manual (v2.9+) for further details.
+defined first. See the \app{bib2gls} manual (v2.9+) for further details.
-You can use the resource option \optfmt{compound-adjust-name}
+You can use the resource option \resourceopt{compound-adjust-name}
to replace the \gloskey{name} field of the main entry to:
-\begin{definition}[\DescribeMacro\glsxtrmultientryadjustedname]
-\cs{glsxtrmultientryadjustedname}\marg{sublist1}\marg{name}\marg{sublist2}\marg{label}
-\end{definition}
-where \meta{label} is the label identifying the compound set,
+\cmddef{glsxtrmultientryadjustedname}
+where \meta{multi-label} is the label identifying the compound set,
\meta{name} was the value of the \gloskey{name} before adjustment,
\meta{sublist1} is the sub-list of other element labels
before the main element (empty if the main element is the first
@@ -9857,2490 +35663,7154 @@ other elements after the main element (empty if the main label is
the final element).
This command is defined in \sty{glossaries-extra-bib2gls}, which is
-automatically loaded with \pkgopt[only]{record} and
-\pkgopt[nameref]{record}. Case-changing versions of this command are
-also available. First letter uppercase:
-\begin{definition}[\DescribeMacro\Glsxtrmultientryadjustedname]
-\cs{Glsxtrmultientryadjustedname}\marg{sublist1}\marg{name}\marg{sublist2}\marg{label}
-\end{definition}
-Title case:
-\begin{definition}[\DescribeMacro\GlsXtrmultientryadjustedname]
-\cs{GlsXtrmultientryadjustedname}\marg{sublist1}\marg{name}\marg{sublist2}\marg{label}
-\end{definition}
-All uppercase:
-\begin{definition}[\DescribeMacro\GLSxtrmultientryadjustedname]
-\cs{GLSxtrmultientryadjustedname}\marg{sublist1}\marg{name}\marg{sublist2}\marg{label}
-\end{definition}
-
-Note that this command doesn't take the prefix or suffix into
+automatically loaded with \opteqvalref{record}{only} and
+\opteqvalref{record}{nameref}. Case-changing versions of this command are
+also available.
+
+\cmddef{Glsxtrmultientryadjustedname}
+This is a \idx{sentencecase} version of
+\gls{glsxtrmultientryadjustedname}.
+
+\cmddef{GlsXtrmultientryadjustedname}
+This is a \idx{titlecase} version of
+\gls{glsxtrmultientryadjustedname}.
+
+\cmddef{GLSxtrmultientryadjustedname}
+This is an \idx{allcaps} version of
+\gls{glsxtrmultientryadjustedname}.
+
+Note that the above commands don't take the prefix or suffix into
account (see \sectionref{sec:mglsfixes}).
The separator between each element in the sub-lists is produced
with:
-\begin{definition}[\DescribeMacro\glsxtrmultientryadjustednamesep]
-\cs{glsxtrmultientryadjustednamesep}\marg{pre label}\marg{post label}
-\end{definition}
-The default definition just uses \cs{glscombinedfirstsepfirst}.
+\cmddef{glsxtrmultientryadjustednamesep}
+The default definition just uses \gls{glscombinedfirstsepfirst}.
The separator between the last element of \meta{sublist1} and the
main element is produced with:
-\begin{definition}[\DescribeMacro\glsxtrmultientryadjustednamepresep]
-\cs{glsxtrmultientryadjustednamepresep}\marg{pre label}\marg{post label}
-\end{definition}
+\cmddef{glsxtrmultientryadjustednamepresep}
Similarly for the separator between the main element and the first
element of \meta{sublist2}:
-\begin{definition}[\DescribeMacro\glsxtrmultientryadjustednamepostsep]
-\cs{glsxtrmultientryadjustednamepostsep}\marg{pre label}\marg{post label}
-\end{definition}
-These both default to \cs{glsxtrmultientryadjustednamesep}.
+\cmddef{glsxtrmultientryadjustednamepostsep}
+These both default to \gls{glsxtrmultientryadjustednamesep}.
The \meta{name} is encapsulated with:
-\begin{definition}[\DescribeMacro\glsxtrmultientryadjustednamefmt]
-\cs{glsxtrmultientryadjustednamefmt}\marg{text}
-\end{definition}
-This just does its argument by default.
-If \meta{sublist1} is empty for the first letter upper case
+\cmddef{glsxtrmultientryadjustednamefmt}
+This just does its argument by default.
+If \meta{sublist1} is empty for the \idx{sentencecase}
version, then \meta{name} is encapsulated with:
-\begin{definition}[\DescribeMacro\Glsxtrmultientryadjustednamefmt]
-\cs{Glsxtrmultientryadjustednamefmt}\marg{text}
-\end{definition}
-This does \ics{makefirstuc}\marg{text} by default.
-For the title case version, the name is encapsulated with:
-\begin{definition}[\DescribeMacro\GlsXtrmultientryadjustednamefmt]
-\cs{GlsXtrmultientryadjustednamefmt}\marg{text}
-\end{definition}
-This uses \cs{glscapitalisewords} (provided by \styfmt{glossaries}
-v4.48+) if defined or \cs{capitalisewords} otherwise.
-The all uppercase version uses:
-\begin{definition}[\DescribeMacro\GLSxtrmultientryadjustednamefmt]
-\cs{GLSxtrmultientryadjustednamefmt}\marg{text}
-\end{definition}
-This uses \cs{mfirstucMakeUppercase} by default.
+\cmddef{Glsxtrmultientryadjustednamefmt}
+This does \gls{makefirstuc}\marg{text} by default.
+For the \idx{titlecase} version, the name is encapsulated with:
+\cmddef{GlsXtrmultientryadjustednamefmt}
+This uses \gls{glscapitalisewords}, if defined, or \gls{capitalisewords} otherwise.
+The \idx{allcaps} version uses:
+\cmddef{GLSxtrmultientryadjustednamefmt}
+This uses \gls{mfirstucMakeUppercase} by default.
Each element label in the sub-lists is encapsulated with:
-\begin{definition}[\DescribeMacro\glsxtrmultientryadjustednameother]
-\cs{glsxtrmultientryadjustednameother}\marg{label}
-\end{definition}
-This does \cs{glsentryname}\marg{label} by default.
-For the first letter uppercase version (where
+\cmddef{glsxtrmultientryadjustednameother}
+This does \code{\gls{glsentryname}\margm{label}} by default.
+For the \idx{sentencecase} version (where
\meta{sublist1} isn't empty), then the element label is encapsulated
with:
-\begin{definition}[\DescribeMacro\Glsxtrmultientryadjustednameother]
-\cs{Glsxtrmultientryadjustednameother}\marg{label}
-\end{definition}
-This does \cs{Glsentryname}\marg{label} by default.
-The title case version uses:
-\begin{definition}[\DescribeMacro\GlsXtrmultientryadjustednameother]
-\cs{GlsXtrmultientryadjustednameother}\marg{label}
-\end{definition}
-This does \ics{glsentrytitlecase}\marg{label}\verb|{name}| by
-default.
-The all uppercase version uses:
-\begin{definition}[\DescribeMacro\GLSxtrmultientryadjustednameother]
-\cs{GLSxtrmultientryadjustednameother}\marg{label}
-\end{definition}
+\cmddef{Glsxtrmultientryadjustednameother}
+This does \code{\gls{Glsentryname}\margm{label}} by default.
+The \idx{titlecase} version uses:
+\cmddef{GlsXtrmultientryadjustednameother}
+This does \code{\gls{glsentrytitlecase}\margm{label}\marg{name}} by
+default. The \idx{allcaps} version uses:
+\cmddef{GLSxtrmultientryadjustednameother}
This is defined as:
-\begin{verbatim}
-\newcommand*{\GLSxtrmultientryadjustednameother}[1]{%
- \mfirstucMakeUppercase{\glsentryname{#1}}}
-\end{verbatim}
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{GLSxtrmultientryadjustednameother}}[1]\marg{\%
+ \gls{mfirstucMakeUppercase}\marg{\gls{glsentryname}\marg{\#1}}}
+\end{compactcodebox}
-\chapter{Categories}
-\label{sec:categories}
+\chapter{Defining and Displaying Glossaries}
+\label{sec:glossaries}
-Each entry defined by \ics{newglossaryentry} (or commands that
-internally use it such as \ics{newabbreviation})
-is assigned a category
-through the \gloskey{category} key. You may add any category that
-you like, but since the category is a label used in the creation
-of some control sequences, avoid problematic characters within the
-category label. (So take care if you have \sty{babel} shorthands on
-that make some characters active.)
+As with the base \sty{glossaries} package, you need to establish the
+indexing method in the preamble and use the appropriate
+\csmetafmt{print}{\ldots}{glossary} command. For example, to use the
+\qt{noidx} method you need \gls{makenoidxglossaries} in the preamble
+and \gls{printnoidxglossary} in the document. Whereas if you want to
+use \app{makeindex} or \app{xindy}, you need \gls{makeglossaries} in
+the preamble and \gls{printglossary} in the document. The
+\sty{glossaries-extra} package provides a hybrid approach:
+\cmddef{makeglossaries}
+If the optional argument is present, then \meta{types} should be a
+comma-separated list of \idx{glossary} labels that should be
+processed by \app{makeindex} or \app{xindy} as per the normal
+behaviour of \gls{makeglossaries}. Any non-\idxpl{ignoredglossary}
+that are not listed in \meta{types} should be treated as though
+\gls{makenoidxglossaries} was used. This means that the
+\idxpl{glossary} listed in \meta{types} should be displayed using
+\gls{printglossary} and the other (non-\idxpl{ignoredglossary})
+should be displayed with \gls{printnoidxglossary}. See
+\file{sample-mixedsort.tex} for an example.
+
+If the optional argument is omitted, it will be treated as per the
+original \gls{makeglossaries} provided by the base \sty{glossaries}
+package. If the optional argument is present,
+\gls{glsindexingsetting} will be set to \code{makeindex-noidx} or
+\code{xindy-noidx}, depending on whether \app{makeindex} or
+\app{xindy} should be used.
+
+\begin{information}
+\Idxpl{glossary} can't be defined after \gls{makeglossaries}. This
+ensures that all the required \idx{indexing} files are opened.
+If you're not using \gls{makeglossaries}, \idxpl{glossary} need to
+be defined before any entries that should belong to them are
+defined.
+\end{information}
+
+The base \sty{glossaries} package provides \gls{newignoredglossary}
+to define an \idx{ignoredglossary} that doesn't have any associated
+\idx{indexing} files. This will automatically switch off hyperlinks
+for any entries assigned to the \idx{glossary} (since there will be
+no target). With \sty{glossaries-extra}, it's possible to have
+targets without using the \idx{indexing} methods provided by the
+base package. For example, it's possible to have standalone entries
+(see \sectionref{sec:glossentry}) or targets can be created with
+\gls{printunsrtglossary}, so \sty{glossaries-extra} provides a
+starred version.
+\cmddef{newignoredglossary*}
+This behaves like the unstarred version but doesn't disable
+hyperlinks. The \idx{glossary} will still be omitted by iterative
+commands, such as \gls{printunsrtglossaries}, and can't be used with
+\gls{printglossary} or \gls{printnoidxglossary}. If you use an
+\idx{ignoredglossary} with \gls{printunsrtglossary}, you will need
+to use the \printglossopt{title} option to override the default
+title, if required.
+
+\cmddef{provideignoredglossary}
+This is like \gls{newignoredglossary} but does nothing if the
+\idx{glossary} has already been defined.
+
+With the \idx{indexing} options provided by the base
+\sty{glossaries} package, if you want a term to appear in more than
+one \idx{glossary}, it's necessary to define a duplicate entry with
+a different label. With the \idx{unsrtfam}, the same entry can
+appear in multiple \idxpl{glossary}. This can be done by simply
+copying the entry's label to the required \idx{glossary} using:
+\cmddef{glsxtrcopytoglossary}
+This just adds the label to the target \idx{glossary}['s] internal
+comma-separated list that commands like \gls{printunsrtglossary}
+iterate over. The unstarred version locally adds the label. The
+starred version performs a global change.
+
+\begin{warning}
+\gls{glsxtrcopytoglossary} is not compatible with \opteqvalref{docdef}{true}.
+\end{warning}
+
+Note that the \gloskey{type} field will still be set to the original
+\idx{glossary}. This is considered the entry's primary glossary.
+There's no field that keeps track of the additional \idxpl{glossary}
+the entry has been copied to.
+
+If used with \gls{printglossary} or \gls{printnoidxglossary}, the
+entry will only be \indexed\ for its primary \idx{glossary}. It
+won't show up in the other \idxpl{glossary}, but will be found when
+using an iterative command, such as \gls{glsaddall}, over the target
+\idx{glossary}.
+
+The base \sty{glossaries} package provides \gls{forallglossaries} to
+iterate over a list of \idxpl{glossary} labels (all
+non-\idxpl{ignoredglossary} by default). This can also be used with
+\sty{glossaries-extra} but \gls{forallacronyms} is only for
+\idxpl{glossary} that have been declared as lists of acronyms, so
+it's inappropriate with the \sty{glossaries-extra} package. Instead,
+you can use the analogous command:
+\cmddef{forallabbreviationlists}
+Each instance of \gls{newabbreviation} will add the abbreviation's
+associated \idx{glossary} (identified by the \gloskey{type} key) to
+the internal list of labels (if not already added). Note that this
+won't take into account any \idxpl{glossary} that had
+abbreviations copied or moved to it.
+
+\section{Entry Page Reference}
+\label{sec:glspageref}
+
+The base \sty{glossaries} package provides \gls{glsrefentry}, which
+uses \gls{ref} to reference the entry's associated counter
+(enabled with \opt{entrycounter} or \opt{subentrycounter}, not the
+\idx{locationcounter}). The
+\sty{glossaries-extra} package additionally provides:
+\cmddef{glsxtrpageref}
+This works in the same way but uses \gls{pageref} instead of
+\gls{ref}. As with \gls{glsrefentry}, if the corresponding counter
+has not been enabled, this just does \code{\gls{gls}\margm{entry-label}}.
+
+\section{Glossary Preamble}
+\label{sec:glospreamble}
+
+The base package provides \gls{glossarypreamble}, which is used at
+the start of the \idx{glossary}. By default, this will use the preamble
+associated with the current \idx{glossary}. If you redefine
+\gls{glossarypreamble}, this will set the preamble for all
+glossaries. To set the preamble for a particular glossary, you can
+use \gls{setglossarypreamble}. With \sty{glossaries-extra}, you can
+additionally append to an existing preamble using:
+\cmddef{apptoglossarypreamble}
+This (locally) appends \meta{text} to the preamble for the
+\idx{glossary} identified by \meta{type}. If \meta{type} is omitted,
+\gls{glsdefaulttype} is assumed.
+
+\cmddef{pretoglossarypreamble}
+This (locally) prepends \meta{text} to the preamble for the
+\idx{glossary} identified by \meta{type}. If \meta{type} is omitted,
+\gls{glsdefaulttype} is assumed.
+
+\section{Options}
+\label{sec:printglossopts}
+
+In addition to the \idxc{printglossopt}{options} available with
+\gls{printglossary}, the following options are also provided. Some
+of these listed here are specific to \gls{printunsrtglossary} and
+\env{printunsrtglossarywrap}. Options provided by the base package
+that aren't available for the \idx{unsrtfam} are identified below.
+
+\optiondef{printgloss.sort}
+This option is only available for \gls{printnoidxglossary}. The
+\gls{printunsrtglossary} and \gls{printunsrtinnerglossary} commands
+simply iterate over the \idx{glossary}['s] internal list in the
+order in which the entries have been added to that \idx{glossary}.
+If you are using \app{bib2gls}, use the \resourceopt{sort} resource
+option instead.
+
+\optiondef{printgloss.title}
+This option is provided by the base \sty{glossaries} package to
+override the default title for the \idx{glossary}. This option
+is also available for \gls{printunsrtglossary} and
+\env{printunsrtglossarywrap} but not for
+\gls{printunsrtinnerglossary}.
+
+\optiondef{printgloss.toctitle}
+This option is provided by the base \sty{glossaries} package to
+override the default table of contents title for the \idx{glossary}. This option
+is also available for \gls{printunsrtglossary} and
+\env{printunsrtglossarywrap} but not for
+\gls{printunsrtinnerglossary}.
+
+\optiondef{printgloss.numberedsection}
+This option is provided by the base \sty{glossaries} package to
+indicate whether or not the section header used at the start of the
+\idx{glossary} should be numbered rather than unnumbered (and
+whether or not to automatically label the glossary with
+\code{\gls+{label}\marg{\gls{glsautoprefix}\meta{glossary-type}}}). The
+\opt{numberedsection} package option will change the default setting
+to match. This option is not available for
+\gls{printunsrtinnerglossary}.
+
+\optiondef{printgloss.style}
+This option is provided by the base \sty{glossaries} package to
+set the \idx{glossarystyle}. This option is not
+available for \gls{printunsrtinnerglossary}.
+
+\optiondef{printgloss.label}
+This option is provided by \sty{glossaries-extra} to add
+\code{\gls+{label}\margm{label}} after the section header. This is
+essentially like \optval{numberedsection}{nameref} but you supply
+the label. This option is not available for
+\gls{printunsrtinnerglossary}. Alternatively, you can use:
+\cmddef*{glsxtrsetglossarylabel} This will need to be scoped or
+changed between \idxpl{glossary} or use a command in \meta{label}
+that expands differently for each \idx{glossary} to avoid duplicate
+labels.
-The use of categories can give you more control over the way entries
-are displayed in the text or glossary. Note that an entry's category
-is independent of the glossary type. Be careful not to confuse
-\gloskey{category} with \gloskey{type}.
+\optiondef{printgloss.leveloffset}
+This option sets or increments the \idx{hierarchicallevel} offset. If
+\meta{offset} starts with \code{++} then the current offset is
+incremented by the given amount otherwise the current offset is
+set to \meta{offset}. For example, an entry with a normal
+\gls{hierarchicallevel} of 1 will be treated as though it has
+\gls{hierarchicallevel} $1+\meta{offset}$. Note that the
+\idx{glossarystyle} may not support the resulting
+\idx{hierarchicallevel}. This option is only available for the
+\idx{unsrtfam} and the \env{printunsrtglossarywrap}
+environment. See \sectionref{sec:printunsrtinner} for an example.
+
+\optiondef{printgloss.flatten}
+Treats all entries as though they have the same
+\idx{hierarchicallevel} (the value of \printglossopt{leveloffset}). This option is only available for the
+\idx{unsrtfam} and the \env{printunsrtglossarywrap}
+environment. Unlike the \resourceopt{flatten} resource option, this
+option doesn't actually remove the \gloskey{parent} field.
+
+\optiondef{printgloss.groups}
+This option is only applicable to the \idx{unsrtfam} and
+\env{printunsrtglossarywrap}. If set to false, it will prevent
+\idxpl{group} from being formed. If true (the default), \idxpl{group} will only be
+formed if they are supported. See \sectionref{sec:printunsrt}
+for further details.
-For multi-entry categories, see \sectionref{sec:multiglscategory}.
+\optiondef{printgloss.prefix}
+This option is provided by \sty{glossaries-extra} and simply
+redefines \gls{glolinkprefix} to expand to \meta{prefix}. If
+hyperlinks are supported and the \idx{glossarystyle} uses
+\gls{glstarget} to create the entry's hypertarget, the target name
+is obtained from \code{\gls{glolinkprefix}\meta{entry-label}}. If
+you are displaying multiple \idxpl{glossary} with shared entries (for
+example, using the \resourceopt{secondary} resource option with
+\app{bib2gls}), then changing the prefix can avoid duplicate targets.
+
+Note that this option will also affect the targets used by the
+\idx{glslike} and \idx{glstextlike} commands. This means that if you
+have, for example, \gls{gls} in the description of an entry, then
+its hyperlink will go to that entry's item in the current
+\idx{glossary}. Whereas referencing that entry outside of the
+\idx{glossary} will hyperlink to the \idx{glossary} that uses the prefix
+matching the setting at that point in the document.
+For example:
+\begin{codebox}
+\cmd{usepackage}\oarg{colorlinks}\marg{hyperref}
+\cmd{usepackage}\oarg{\optval{showtargets}{annoteleft},\optval{style}{\glostyle{tree}}}\marg{glossaries-extra}
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},
+ \gloskeyval{description}{an example description that references \gls{gls}\marg{another}}}
+\gls{newglossaryentry}\marg{another}\marg{\gloskeyval{name}{another},
+ \gloskeyval{description}{some other example description that references \gls{gls}\marg{sample}}}
+\cbeg{document}
+Link to glossary 1: \gls{gls}\marg{sample}.
+\codepar
+Link to glossary 2: \gls{gls}\oarg{\glsoptval{prefix}{other-}}\marg{sample}.
+\gls{printunsrtglossary}
+\gls{printunsrtglossary}\oarg{\printglossoptval{prefix}{other-}}
+\cend{document}
+\end{codebox}
+This uses the \opt{showtargets} package option to show the target
+names to the left of the hyperlink or hypertarget.
+The result is:
+\begin{resultbox}
+\createexample*[title={Changing the target prefix},
+ label={ex:targetprefixes},
+description={Example document that illustrates two glossaries with
+different target prefixes}]
+{\cmd{usepackage}\oarg{colorlinks}\marg{hyperref}^^J%
+\cmd{usepackage}\oarg{\optval{showtargets}{annoteleft},\optval{style}{\glostyle{tree}}}\marg{glossaries-extra}^^J%
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},^^J
+ \gloskeyval{description}{an example description that references \gls{gls}\marg{another}}}^^J%
+\gls{newglossaryentry}\marg{another}\marg{\gloskeyval{name}{another},^^J
+ \gloskeyval{description}{some other example description that references \gls{gls}\marg{sample}}}
+}{Link to glossary 1: \gls{gls}\marg{sample}.
+\codepar
+Link to glossary 2: \gls{gls}\oarg{\glsoptval{prefix}{other-}}\marg{sample}.^^J%
+\gls{printunsrtglossary}^^J%
+\gls{printunsrtglossary}\oarg{\printglossoptval{prefix}{other-}}
+}
+\end{resultbox}
+Within the main part of the document, the first reference to
+\qt{sample} has a hyperlink to the first \idx{glossary} (with the target
+\code{glo:sample}, which uses the default prefix), and the second
+reference has a hyperlink to the second \idx{glossary} (with the
+target \code{other-sample}).
+
+Within the \idxpl{glossary}, the \gls{gls} references use the
+current \idx{glossary} prefix, so the target is in the same
+\idx{glossary}.
+
+\optiondef{printgloss.targetnameprefix}
+This is similar to the previous option but only affects the prefix
+for the entry item's target and doesn't change the prefix for any
+references contained within the \idx{glossary}. This \emph{prepends} the
+given prefix to the default prefix.
+
+If the above example is modified to:
+\begin{codebox}
+Link to glossary 1: \gls{gls}\marg{sample}.
+\codepar
+Link to glossary 2: \gls{gls}\oarg{\glsoptval{prefix}{other-glo:}}\marg{sample}.
+\gls{printunsrtglossary}
+\gls{printunsrtglossary}\oarg{\printglossoptval{targetnameprefix}{other-}}
+\end{codebox}
+Then the result will be:
+\begin{resultbox}
+\createexample*[title={Prepending to the target prefix for just the entry
+item},
+ label={ex:targetprefixname},
+description={Example document that illustrates two glossaries with
+different target prefixes using targetprefixname}]
+{\cmd{usepackage}\oarg{colorlinks}\marg{hyperref}^^J%
+\cmd{usepackage}\oarg{\optval{showtargets}{annoteleft},\optval{style}{\glostyle{tree}}}\marg{glossaries-extra}^^J%
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},^^J
+ \gloskeyval{description}{an example description that references \gls{gls}\marg{another}}}^^J%
+\gls{newglossaryentry}\marg{another}\marg{\gloskeyval{name}{another},^^J
+ \gloskeyval{description}{some other example description that references \gls{gls}\marg{sample}}}
+}{Link to glossary 1: \gls{gls}\marg{sample}.
+\codepar
+Link to glossary 2: \gls{gls}\oarg{\glsoptval{prefix}{other-glo:}}\marg{sample}.^^J%
+\gls{printunsrtglossary}^^J%
+\gls{printunsrtglossary}\oarg{\printglossoptval{targetnameprefix}{other-}}
+}
+\end{resultbox}
-The default category assumed by
-\cs{newglossaryentry} is labelled \category{general}. Abbreviations
-defined with \cs{newabbreviation} have the category set to
-\category{abbreviation} by default. Abbreviations defined with
-\cs{newacronym} have the category set to \category{acronym} by
-default.
+Note that this has prepended \code{other-} to the existing
+\code{glo:}\ prefix. This is why the \glsopt{prefix} option in
+the second \gls{gls} reference had to be changed to match the
+appropriate hypertarget name. The \gls{gls}
+references in the second \idx{glossary} now point to the relevant
+line in the first \idx{glossary}.
-Additionally, if you have enabled \ics{newterm} with the
-\pkgopt{index} package option that command
-will set the category to \category{index} by default. If you have
-enabled \ics{glsxtrnewsymbol} with the \pkgopt{symbols} package
-option, that command will set the category to \category{symbol}. If you have
-enabled \ics{glsxtrnewnumber} with the \pkgopt{numbers} package
-option, that command will set the category to \category{number}.
-
-You can obtain the category label for a given entry using
-\begin{definition}[\DescribeMacro\glscategory]
-\cs{glscategory}\marg{label}
-\end{definition}
-This is equivalent to commands like \cs{glsentryname} and so may be
-used in an expandable context. No error is generated if the entry
-doesn't exist.
-
-You can test the category for a given entry using
-\begin{definition}[\DescribeMacro\glsifcategory]
-\cs{glsifcategory}\marg{entry-label}\marg{category-label}\marg{true
-part}\marg{false part}
-\end{definition}
-This is equivalent to
-\begin{alltt}
-\ics{ifglsfieldeq}\marg{entry-label}\{category\}\marg{category-label}\marg{true
-part}\marg{false part}
-\end{alltt}
-so any restrictions that apply to \cs{ifglsfieldeq} also apply to
-\cs{glsifcategory}.
-
-Each category may have a set of attributes. For example, the
-\category{general} and \category{acronym} categories have the
-attribute \catattr{regular} set to \qt{true} to indicate that all
-entries with either of those categories are regular entries (as
-opposed to abbreviations). This attribute is accessed by
-\cs{glsentryfmt} to determine whether to use \cs{glsgenentryfmt} or
-\cs{glsxtrgenabbrvfmt}.
-
-Other attributes recognised by \styfmt{glossaries-extra} are:
+It's possible to combine \printglossopt{targetnameprefix} with
+\printglossoptvalm{prefix}{} but that will also affect the \gls{gls}
+references within the \idx{glossary}.
-\begin{description}
+\optiondef{printgloss.target}
+This is a boolean option that can be used to switch off the
+automatic creation of the entry hypertargets but still allows
+hyperlinks within the \idx{glossary}. This can be used to prevent
+duplicate destinations for secondary \idxpl{glossary}.
-\item[\catattrdef{nohyperfirst}] When using commands like \ics{gls}
-this will automatically suppress the hyperlink on \gls{firstuse} for entries with a
-category that has this attribute set to \qt{true}.
-(This settings can be overridden by explicitly setting
-the \gloskey[glslink]{hyper} key on or off in the optional argument of
-commands like \cs{gls}.) As from version 1.07, \cs{glsfirst},
-\cs{Glsfirst}, \cs{GLSfirst} and their plural versions (which should ideally
-behave in a similar way to the \gls{firstuse} of \cs{gls} or
-\cs{glspl}) now honour
-this attribute (but not the package-wide \pkgopt[false]{hyperfirst}
-option, which matches the behaviour of \sty{glossaries}). If you
-want commands like \cs{glsfirst} to ignore the
-\catattr{nohyperfirst} attribute then just redefine
-\begin{definition}[\DescribeMacro\glsxtrchecknohyperfirst]
-\cs{glsxtrchecknohyperfirst}\marg{label}
-\end{definition}
-to do nothing.
-
-\item[\catattrdef{nohyper}] When using commands like \ics{gls}
-this will automatically suppress the hyperlink for entries with a
-category that has this attribute set to \qt{true}.
-(This settings can be overridden by explicitly setting
-the \gloskey[glslink]{hyper} key on or off in the optional argument of
-commands like \cs{gls}.)
-
-\item[\catattrdef{indexonlyfirst}] This is similar to the
-\pkgopt{indexonlyfirst} package option but only for entries
-that have a category with this attribute set to \qt{true}.
-
-\item[\catattrdef{wrgloss}] When using commands like \ics{gls},
-if this attribute is set to \qt{after}, it will automatically
-implement \gloskey[glslink]{wrgloss}\optfmt{=after}. (New to v1.14.)
-
-\item[\catattrdef{discardperiod}] If set to \qt{true}, the
-post-\gls{linktext} hook will
-discard a~full stop (period) that follows \emph{non-plural} commands like \cs{gls} or
-\cs{glstext}. (Provided for entries such as abbreviations that end
-with a full stop.) This attribute is only applicable to entries
-defined using \cs{newabbreviation} (or \cs{newacronym} if it's using
-\cs{newabbreviation}.) This attribute
-doesn't apply to the accessibility fields.
+\optiondef{printgloss.preamble}
+Redefines \gls{glossarypreamble} to \meta{text}.
-Note that this can cause a problem if you access a field that
-doesn't end with a full stop. For example:
-\begin{verbatim}
-\newabbreviation
- [user1={German Speaking \TeX\ User Group}]
- {dante}{DANTE e.V.}{Deutschsprachige Anwendervereinigung \TeX\
-e.V.}
-\end{verbatim}
-Here the \gloskey{short} and \gloskey{long} fields end with a full stop, but the
-\gloskey{user1} field doesn't. The simplest solution in this
-situation is to put the sentence terminator in the final optional
-argument. For example:
-\begin{verbatim}
-\glsuseri{dante}[.]
-\end{verbatim}
-This will bring the punctuation character inside the \gls{linktext}
-and it won't be discarded.
+\optiondef{printgloss.postamble}
+Redefines \gls{glossarypostamble} to \meta{text}.
-\item[\catattrdef{pluraldiscardperiod}] If this attribute is set to
-\qt{true} \emph{and} the \catattr{discardperiod} attribute is set to
-\qt{true}, this will behave as above for the plural commands like
-\cs{glspl} or \cs{glsplural}. This attribute is only applicable to entries
-defined using \cs{newabbreviation} (or \cs{newacronym} if it's using
-\cs{newabbreviation}.)
-
-\item[\catattrdef{retainfirstuseperiod}] If this attribute is set
-to \qt{true} then the full stop won't be discarded for
-\gls{firstuse} instances, even if \catattr{discardperiod} or
-\catattr{pluraldiscardperiod} are set. This is useful for
-\meta{short} (\meta{long}) abbreviation styles where only the short
-form has a trailing full stop. This attribute is only applicable to entries
-defined using \cs{newabbreviation} (or \cs{newacronym} if it's using
-\cs{newabbreviation}.) This attribute doesn't apply to the
-accessibility fields.
+\section{Displaying a Glossary Without Sorting or Indexing}
+\label{sec:printunsrt}
-\item[\catattrdef{markwords}] If this attribute is set to \qt{true}
-any entry defined using \ics{newabbreviation} will automatically
-have spaces in the long form replaced with
-\begin{definition}[\DescribeMacro\glsxtrwordsep]
-\cs{glsxtrwordsep}
-\end{definition}
-and each word is encapsulated with
-\begin{definition}[\DescribeMacro\glsxtrword]
-\cs{glsxtrword}\marg{word}
-\end{definition}
-For example:
-\begin{verbatim}
-\glssetcategoryattribute{abbreviation}{markwords}{true}
-\newabbreviation{ip}{IP}{Internet Protocol}
-\end{verbatim}
-is essentially the same as
-\begin{verbatim}
-\newabbreviation{ip}{IP}
-{\glsxtrword{Internet}\glsxtrwordsep\glsxtrword{Protocol}}
-\end{verbatim}
-The \qt{hyphen} styles, such as
-\abbrstyle{long-hyphen-short-hyphen}, take advantage of this
-markup. If the inserted material (provided in the final argument
-of commands like \ics{gls}) starts with a hyphen then
-\cs{glsxtrwordsep} is locally redefined to a hyphen. (The default
-value is a space). Note that this only applies to commands
-like \cs{gls} and not like \cs{glsxtrlong}. You can provide your own
-localised switch, if required. For example:
-\begin{verbatim}
-\newcommand{\hyplong}[2][]{%
- {\def\glsxtrwordsep{-}\glsxtrlong[#1]{#2}}}
-\end{verbatim}
+The base \sty{glossaries} package provides two ways of displaying a
+\idx{glossary}, depending on the \idx{indexing} option:
+\gls{printglossary} (used with \gls{makeglossaries}) or
+\gls{printnoidxglossary} (used with \gls{makenoidxglossaries}).
-This setting will also adjust the long plural. This attribute is only applicable to entries
-defined using \cs{newabbreviation} (or \cs{newacronym} if it's using
-\cs{newabbreviation}.)
+The \sty{glossaries-extra} package provides an alternative that
+doesn't require sorting or \idx{indexing}.
+\cmddef{printunsrtglossary}
+This behaves in a similar way to \gls{printnoidxglossary}, but it
+always lists all the defined entries for the given glossary in the
+order in which they were added to the glossary. Unlike
+\gls{printglossary}, you may use \gls{printunsrtglossary} with an
+\idx{ignoredglossary}.
\begin{important}
-This setting may result in the
-\cs{glsxtrword} and \cs{glsxtrwordsep} markup ending up in the
-\gloskey{sort} field, depending on the style in use.
+The \idx{unsrtfam} and \env{printunsrtglossarywrap} are not intended
+for use with \gls{makeglossaries} and \gls{makenoidxglossaries}.
+Mixing these different methods can result in unexpected behaviour.
\end{important}
-\item[\catattrdef{markshortwords}] This is similar to
-\catattr{markwords} but applies to the short form. (Only useful for
-abbreviations that contain spaces.) This attribute is only applicable to entries
-defined using \cs{newabbreviation} (or \cs{newacronym} if it's using
-\cs{newabbreviation}.)
-
-This setting will only adjust the short plural if the
-\gloskey{shortplural} key isn't used. This setting will
-take precedence over \catattr{insertdots}.
+There is also a starred version which has a mandatory argument:
+\cmddef{printunsrtglossary*}
+This is equivalent to:
+\begin{compactcodebox}
+\cmd{begingroup}
+ \meta{init-code}\gls{printunsrtglossary}\oargm{options}
+\cmd{endgroup}
+\end{compactcodebox}
+There's no significant difference between doing:
+\begin{compactcodebox}
+\marg{\meta{init-code}\gls{printunsrtglossary}\oargm{options}}
+\end{compactcodebox}
+and
+\begin{compactcodebox}
+\gls{printunsrtglossary*}\oargm{options}\margm{init-code}
+\end{compactcodebox}
+Note that unlike \gls{glossarypreamble}, the supplied \meta{init-code} is
+done before the \idx{glossary} header.
\begin{important}
-This setting may result in the
-\cs{glsxtrword} and \cs{glsxtrwordsep} markup ending up in the
-\gloskey{sort} field, depending on the style in use.
+If you want to use one of the \env{tabular}-like
+styles with \gls{printunsrtglossary}, make sure you load
+\sty{glossaries-extra-stylemods} which modifies
+the definition of \gls{glsgroupskip} to avoid the
+\qt{Incomplete \csfmt{iftrue}} error that may otherwise occur.
\end{important}
-\item[\catattrdef{insertdots}] If this attribute is set to \qt{true}
-any entry defined using \ics{newabbreviation} will automatically
-have full stops (periods) inserted after each letter. The entry will
-be defined with those dots present as though they had been present
-in the \meta{short} argument of \cs{newabbreviation} (rather than
-inserting them every time the entry is used). The short plural
-form defaults to the new dotted version of the original \meta{short}
-form with the plural suffix appended. \emph{This setting is incompatible
-with \catattr{markshortwords}.} This attribute is only applicable to entries
-defined using \cs{newabbreviation} (or \cs{newacronym} if it's using
-\cs{newabbreviation}.)
+As with \gls{printglossary} and \gls{printnoidxglossary}, there is
+also a command to print all non-\idxpl{ignoredglossary} in the order
+in which they were defined:
+\cmddef{printunsrtglossaries}
+
+This means you now have the option to simply list all entries on the
+first \LaTeX\ run without the need for a post-processor, however
+there will be no \idx{locationlist} in this case, as that has to be
+set by a post-processor such as \app{bib2gls} (see
+\sectionref{sec:bib2gls}).
+
+\begin{warning}
+No attempt is made to gather hierarchical elements.
+If child entries aren't defined immediately after their parent
+entry, they won't be together in the \idx{glossary} when using
+\gls{printunsrtglossary}.
+\end{warning}
+
+The way that \gls{printunsrtglossary} basically works is to iterate
+over every label in the \idx{glossary}['s] internal label list
+and format each entry according to the way the \idx{glossarystyle}
+would normally format the entry's \idx{hierarchicallevel} (described
+in more detail in \sectionref{sec:printunsrtadvanced}).
+If a change in letter group is detected, the letter group heading
+and group skip will be inserted.
+
+A label is appended to the \idx{glossary}['s] internal label list
+whenever an entry is defined. This means that the list will normally
+be in order of definition, but it's also possible to copy an entry's
+label to another \idx{glossary}['s] internal label list using
+\gls{glsxtrcopytoglossary}, which can be used to provide a different
+order.
+A simple example:
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\cmd{usepackage}\oarg{\optval{style}{\glostyle{treegroup}}}\marg{glossaries-extra}
+\gls{newglossaryentry}\marg{ant}\marg{\gloskeyval{name}{ant},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{gazelle}\marg{\gloskeyval{name}{gazelle},\gloskeyval{description}{}}
+\cbeg{document}
+\gls{printunsrtglossary}
+\cend{document}
+\end{codebox}
+The document build only requires one \LaTeX\ call in this case.
+\begin{resultbox}
+\createexample*[title={Displaying unsorted glossaries},
+ label={ex:printunsrt},
+description={Example document that doesn't require any external indexing}]
+{\cmd{usepackage}\oarg{\optval{style}{\glostyle{treegroup}}}\marg{glossaries-extra}^^J%
+\gls{newglossaryentry}\marg{ant}\marg{\gloskeyval{name}{ant},\gloskeyval{description}{}}^^J%
+\gls{newglossaryentry}\marg{gazelle}\marg{\gloskeyval{name}{gazelle},\gloskeyval{description}{}}^^J%
+}{\gls{printunsrtglossary}}
+\end{resultbox}
+Note the difference if the \opt{stylemods} option is used:
+\begin{codebox}
+\cmd{usepackage}\oarg{\opt{stylemods},\optval{style}{\glostyle{treegroup}}}\marg{glossaries-extra}
+\end{codebox}
+\begin{resultbox}
+\createexample*[title={Displaying unsorted glossaries with \optfmt{stylemods}},
+ label={ex:printunsrtstylemods},
+description={Example document that doesn't require any external
+indexing using the stylemods option}]
+{\cmd{usepackage}\oarg{\opt{stylemods},\optval{style}{\glostyle{treegroup}}}\marg{glossaries-extra}^^J%
+\gls{newglossaryentry}\marg{ant}\marg{\gloskeyval{name}{ant},\gloskeyval{description}{}}^^J%
+\gls{newglossaryentry}\marg{gazelle}\marg{\gloskeyval{name}{gazelle},\gloskeyval{description}{}}^^J%
+}{\gls{printunsrtglossary}}
+\end{resultbox}
+In this case, the \idx{group} headings are now numbers instead of
+letters. The styles provided with \sty{glossaries-extra} and those
+modified by \sty{glossaries-extra-stylemods} are designed to assist integration
+with \app{bib2gls}. Without these modifications,
+\gls{printunsrtglossary} behaves like the less sophisticated
+\gls{printnoidxglossary} which checks if the label is an integer
+less than 256 and uses \gls{char} to create the title (if no title
+has been provided).
+
+If you really want to use \gls{printunsrtglossary} without
+\app{bib2gls} and you want letter \idxpl{group} with
+\opt{stylemods} without having to define all the titles, you can use:
+\cmddef{glsxtrnoidxgroups}
+which will switch over to using the group titling method used with
+\gls{printnoidxglossary} (which only supports \idx{ascii}). This
+command is only available with \opteqvalref{record}{off} and can't
+be used with \gls{makeglossaries}.
+
+If, conversely, you don't want any \idxpl{group} formed, regardless
+of the \idx{glossarystyle}, you can disable them with
+\printglossoptval{groups}{false}.
+The above example can be modified so that the document contains:
+\begin{codebox}
+\gls{printunsrtglossary}\oarg{\printglossoptvalm{title}{Glossary 1}}
+\gls{glsxtrnoidxgroups}
+\gls{printunsrtglossary}\oarg{\printglossoptvalm{title}{Glossary 2}}
+\gls{printunsrtglossary}\oarg{\printglossoptval{groups}{false},\printglossoptvalm{title}{Glossary 3}}
+\gls{printunsrtglossary}\oarg{\printglossoptval{style}{tree},\printglossopt{nogroupskip},\printglossoptvalm{title}{Glossary 4}}
+\end{codebox}
+This repeats the same \idx{glossary}. The first is the same as the
+previous example. The second is the same as the example that didn't
+use \opt{stylemods}. The final two \idxpl{glossary} have the
+\idxpl{group} suppressed. Using \printglossoptval{groups}{false}
+(Glossary~3) is more efficient than using
+\printglossopt{nogroupskip} and switching to a style that doesn't
+show the header (Glossary~4).
+
+I've also switched to two column mode to display the result in a
+more compact form. The first two glossaries are shown on the left
+and the last two are on the right:
+\begin{resultbox}
+\createexample*[title={Displaying unsorted glossaries with different
+group settings},
+ label={ex:printunsrtgroup},
+description={Example document that doesn't require any external
+indexing with different group settings}]
+{\cmd{usepackage}\oarg{\opt{stylemods},\optval{style}{\glostyle{treegroup}}}\marg{glossaries-extra}^^J%
+\gls{newglossaryentry}\marg{ant}\marg{\gloskeyval{name}{ant},\gloskeyval{description}{}}^^J%
+\gls{newglossaryentry}\marg{gazelle}\marg{\gloskeyval{name}{gazelle},\gloskeyval{description}{}}^^J%
+}{\cmd{twocolumn}\gls{printunsrtglossary}\oarg{title=\marg{Glossary 1}}^^J%
+\gls{glsxtrnoidxgroups}^^J%
+\gls{printunsrtglossary}\oarg{title=\marg{Glossary 2}}^^J%
+\cmd{newpage}
+\gls{printunsrtglossary}\oarg{\printglossoptval{groups}{false},title=\marg{Glossary 3}}^^J%
+\gls{printunsrtglossary}\oarg{\printglossoptval{style}{tree},\printglossopt{nogroupskip},title=\marg{Glossary 4}}
+}
+\end{resultbox}
+
+The \idx{unsrtfam} were designed for use with \app{bib2gls},
+which uses more complex alphanumeric \idx{group} labels to allow for greater
+customization and to avoid conflict where there are multiple
+\idxpl{glossary} or \idxpl{hierarchicallevel} with potentially the
+same letter \idxpl{group}.
+
+The way that \app{bib2gls} works is to select entries from a
+\ext{bib} file, according to the document requirements, sort the
+entries, and then write the entry definitions
+(with commands like \gls{longnewglossaryentry*} or
+\gls{newabbreviation}) in the \ext{glstex} in the desired order,
+which is then input by \gls{GlsXtrLoadResources}.
+This means that \gls{printunsrtglossary} will display the
+entries in that order since, from \sty{glossaries-extra}['s] point
+of view, that's the order of definition.
+
+While it is possible to use \gls{printunsrtglossary} without
+\app{bib2gls}, as in the above example, for long or complex
+\idxpl{glossary} it's better to use \app{bib2gls} which can
+automatically assign appropriate titles to the \idxpl{group}.
+
+\Idxpl{group} and hierarchy are discussed in more detail in
+\sectionref{sec:printunsrtgroups}. See
+\sectionref{sec:printunsrtlocations} for \idxpl{locationlist} and
+\sectionref{sec:printunsrtinner}. Advanced commands and further
+detail about the way \gls{printunsrtglossary} works are covered in
+\sectionref{sec:printunsrtadvanced}.
+
+\subsection{Groups and Hierarchy}
+\label{sec:printunsrtgroups}
+
+\begin{information}
+See \gallerypage{logicaldivisions}{Gallery: Logical Glossary Divisions
+(type vs group vs parent)} for the difference between the
+\gloskey{group}, \gloskey{type} and \gloskey{parent} fields.
+\end{information}
+
+Here's a longer example that uses \opt{stylemods} to
+automatically load \sty{glossary-bookindex}:
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\cmd{usepackage}\oarg{\optval{stylemods}{bookindex},\optval{style}{\glostyle{bookindex}}}\marg{glossaries-extra}
+\gls{newglossaryentry}\marg{waterfowl}\marg{\gloskeyval{name}{waterfowl},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{ant}\marg{\gloskeyval{name}{ant},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{adder}\marg{\gloskeyval{name}{adder},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{duck}\marg{\gloskeyval{name}{duck},\gloskeyval{parent}{waterfowl},
+ \gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{zebra}\marg{\gloskeyval{name}{zebra},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{aardvark}\marg{\gloskeyval{name}{aardvark},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{gazelle}\marg{\gloskeyval{name}{gazelle},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{mallard}\marg{\gloskeyval{name}{mallard},\gloskeyval{parent}{duck},
+ \gloskeyval{description}{}}
+\codepar
+\gls{newglossary*}\marg{another}\marg{Another Glossary}
+\gls{glsxtrcopytoglossary}\marg{mallard}\marg{another}
+\gls{glsxtrcopytoglossary}\marg{aardvark}\marg{another}
+\gls{glsxtrcopytoglossary}\marg{zebra}\marg{another}
+\gls{glsxtrcopytoglossary}\marg{ant}\marg{another}
+\gls{glsxtrcopytoglossary}\marg{duck}\marg{another}
+\cbeg{document}
+\gls{printunsrtglossary}
+\gls{printunsrtglossary}\oarg{\printglossoptval{type}{another}}
+\cend{document}
+\end{codebox}
+Unlike the previous examples that defined the entries in
+alphabetical order, this example hasn't used any logical order.
+Note, in particular, that the child entries \qt{duck} and
+\qt{mallard} (which have the \gloskey{parent} key set) have not been
+defined immediately after their parent.
+
+The first \gls{printunsrtglossary} has the default
+\printglossoptval{type}{main} and lists all entries defined in the
+\code{main} \idx{glossary}, in the order in which they were defined. The
+second \gls{printunsrtglossary} lists all entries in the custom
+\code{another} \idx{glossary} and is in the order in which the
+entries were copied to that \idx{glossary}.
+
+The document build again simply requires one \LaTeX\ call. The
+result is shown in \exampleref{ex:unsrtcopygrp}.
+\begin{resultbox}[float]
+\createexample*[label={ex:unsrtcopygrp},
+title={Displaying unsorted glossaries with a copied list},
+description={Example document that doesn't require any external
+indexing that copies entries to another glossary. Entries are listed
+in order of definition with child entries indented, that results in a
+confusing list}]
+{\cmd{usepackage}\oarg{\optval{stylemods}{bookindex},\optval{style}{\glostyle{bookindex}}}\marg{glossaries-extra}^^J%
+\gls{newglossaryentry}\marg{waterfowl}\marg{\gloskeyval{name}{waterfowl},\gloskeyval{description}{}}^^J%
+\gls{newglossaryentry}\marg{ant}\marg{\gloskeyval{name}{ant},\gloskeyval{description}{}}^^J%
+\gls{newglossaryentry}\marg{adder}\marg{\gloskeyval{name}{adder},\gloskeyval{description}{}}^^J%
+\gls{newglossaryentry}\marg{duck}\marg{\gloskeyval{name}{duck},\gloskeyval{parent}{waterfowl},\gloskeyval{description}{}}^^J%
+\gls{newglossaryentry}\marg{zebra}\marg{\gloskeyval{name}{zebra},\gloskeyval{description}{}}^^J%
+\gls{newglossaryentry}\marg{aardvark}\marg{\gloskeyval{name}{aardvark},\gloskeyval{description}{}}^^J%
+\gls{newglossaryentry}\marg{gazelle}\marg{\gloskeyval{name}{gazelle},\gloskeyval{description}{}}^^J%
+\gls{newglossaryentry}\marg{mallard}\marg{\gloskeyval{name}{mallard},\gloskeyval{parent}{duck},\gloskeyval{description}{}}^^J%
+\codepar
+\gls{newglossary*}\marg{another}\marg{Another Glossary}^^J%
+\gls{glsxtrcopytoglossary}\marg{mallard}\marg{another}^^J%
+\gls{glsxtrcopytoglossary}\marg{aardvark}\marg{another}^^J%
+\gls{glsxtrcopytoglossary}\marg{zebra}\marg{another}^^J%
+\gls{glsxtrcopytoglossary}\marg{ant}\marg{another}^^J%
+\gls{glsxtrcopytoglossary}\marg{duck}\marg{another}
+}{\gls{printunsrtglossary}^^J%
+\gls{printunsrtglossary}\oarg{\printglossoptval{type}{another}}
+}
+\end{resultbox}
+
+There are some oddities in both lists. It's the \idx{glossarystyle}
+that determines the formatting of the entries according to the
+entry's \gls{hierarchicallevel}, but it looks strange for the duck
+and mallard entries to be indented when they don't follow after
+their parent entry.
+
+As the internal loop within \gls{printunsrtglossary} iterates over
+each entry, it tries to determine which \idxc{group}{letter group}
+the entry belongs to. If it's different from the \idx{group} for the
+previous entry (in the same hierarchical level), a \idx{group} header is
+added (which may or may not be displayed, depending on the
+\idx{glossarystyle}). This means than an unordered list of entries, such as in the
+above example, may contain repeated headers.
+
+The way that the \idx{group} is determined depends on whether or not
+the \gloskey{group} key has been defined. If it isn't defined (the
+default), then the \idx{group} label is obtained from the
+\idx{uppercase} character code of the first token of the
+\gloskey{sort} key. If the token doesn't have an \idx{uppercase}
+character code (indicating that it's not a letter) or if the sort
+value is empty then the label will be set to \code{glssymbols}
+(which corresponds to the symbol \idx{group}). This is the same way
+that \gls{printnoidxglossary} inserts \idxpl{group}.
+
+Remember that if the \gloskey{sort} key hasn't been set, it will be
+assigned automatically to the same value as the \gloskey{name} key
+(or with \optval{sort}{use} or \optval{sort}{def} to a numerical
+value). The \gloskey{sort} key will be empty if you use
+\optval{sort}{clear}. The \optval{sort}{none} setting simply skips
+the pre-processing of the \gloskey{sort} key (such as sanitizing).
+
+For example, the ant entry doesn't explicitly use the \gloskey{sort}
+key, so the sort value is obtained from the \gloskey{name} key,
+which is set to \code{ant}. The first token is \qt{a}, which is a
+letter. The \idx{group}['s] label is obtained from the letter's
+\idx{uppercase} character decimal code (65). There's no associated
+title (which can be assigned with \gls{glsxtrsetgrouptitle}), so the
+title is simply \qt{65} (with \opt{stylemods}, see earlier) or
+\qt{A} (without \opt{stylemods} or with \gls{glsxtrnoidxgroups}).
+
+The ant entry is followed by \qt{adder}. The same process determines
+that the \qt{adder} \idx{group} label is also 65. There's no
+change in the \idx{group} label from the previous entry (ant) so no
+header is inserted.
+
+By default, this \idx{group} check is omitted for child entries, which is
+why no group header is inserted before duck or mallard. So the next
+entry to be checked for a \idx{group} is the zebra entry, which has
+the group label 90 (the decimal code for \qt{Z}). Again there's no
+title associated with that label so the title is simply the label.
+
+The zebra entry is followed by aardvark which, following the same
+process, has the \idx{group} label 65. This is different from
+the previous group label (90) so a group header is inserted.
+This is why there are two \qt{90} letter \idxpl{group}.
\begin{important}
-If you explicitly override
-the short plural using the \gloskey{shortplural} key, you must
-explicitly insert the dots yourself (since there's no way for the
-code to determine if the plural has a suffix that shouldn't be
-followed by a dot).
+The \idx{unsrtfam} don't order the entries.
\end{important}
-This attribute is best used with the \catattr{discardperiod}
-attribute set to \qt{true}.
+If the \gloskey{group} key has been defined (which is the case with
+\opteqvalref{record}{only} and \opteqvalref{record}{nameref}) then
+the \idx{group} \emph{label} is obtained from the \gloskey{group}
+field. If the \gloskey{group} field is defined but empty then the
+entry will belong to the empty group. The value of the
+\gloskey{sort} field is now irrelevant.
+
+So, simply adding the \opt{record} option to the above example document will
+cause the group headers to disappear. This is because the
+\gloskey{group} key will now be defined but is empty for each entry.
+Even with a style like \glostyle{bookindex}, there won't be any
+\idx{group} headers.
+
+Provided the \gloskey{group} key has been defined, the field used to
+store the \idx{group} label is given by:
+\cmddef{glsxtrgroupfield}
+This expands to \code{group}, by default. However it's possible to
+use a different field in which to store the group label, in which
+case \gls{glsxtrgroupfield} will need to be redefined.
+For example:
+\begin{codebox}
+\marg{\gls{renewcommand}\marg{\gls{glsxtrgroupfield}}\marg{othergroup}\gls{printunsrtglossary}}
+\end{codebox}
+or
+\begin{codebox}
+\gls{printunsrtglossary*}\marg{\gls{renewcommand}\marg{\gls{glsxtrgroupfield}}\marg{othergroup}}
+\end{codebox}
+(but this still requires the \gloskey{group} key to be defined, even
+if it's not being used to store the \idx{group} label). With
+\app{bib2gls}, the \resourceopt{secondary} resource option (combined with
+\switch{group}) will store the \idx{group} label obtained from the
+secondary sort in the \glosfield{secondarygroup} field and adds the redefinition of
+\gls{glsxtrgroupfield} to the associated \idx{glossary} preamble.
+This prevents it from clashing with the \gloskey{group} field in
+the event that the secondary sort method has produced a different
+set of \idxpl{group} (which is likely).
+
+The follow example document uses \opt{record} to create the
+\gloskey{group} key and assigns \idx{group} labels with associated
+titles. Note that the \glosfield{secondarygroup} field doesn't have
+an associated key, so it needs to be set with a field assignment
+command, such as \gls{GlsXtrSetField}.
+\newcommand*{\examplegroupsdefs}{%
+\gls{glsxtrsetgrouptitle}\marg{group1label}\marg{Group 1}\newline
+\gls{glsxtrsetgrouptitle}\marg{group2label}\marg{Group 2}\newline
+\gls{glsxtrsetgrouptitle}\marg{group3label}\marg{Group 3}\newline
+\gls{glsxtrsetgrouptitle}\marg{group4label}\marg{Group 4}\newline
+\codepar
+\gls{newglossaryentry}\marg{waterfowl}\marg{\gloskeyval{name}{waterfowl},\gloskeyval{description}{},\newline\space
+ \gloskeyval{group}{group1label}}\newline
+\gls{newglossaryentry}\marg{ant}\marg{\gloskeyval{name}{ant},\gloskeyval{description}{},\newline\space
+ \gloskeyval{group}{group1label}}\newline
+\gls{GlsXtrSetField}\marg{ant}\marg{\glosfield{secondarygroup}}\marg{group4label}\newline
+\gls{newglossaryentry}\marg{adder}\marg{\gloskeyval{name}{adder},\gloskeyval{description}{},\newline\space
+ \gloskeyval{group}{group2label}}\newline
+\gls{newglossaryentry}\marg{duck}\marg{\gloskeyval{name}{duck},\gloskeyval{parent}{waterfowl},\newline\space
+ \gloskeyval{description}{},\gloskeyval{group}{group4label}}\newline
+\gls{GlsXtrSetField}\marg{duck}\marg{\glosfield{secondarygroup}}\marg{group2label}\newline
+\gls{newglossaryentry}\marg{zebra}\marg{\gloskeyval{name}{zebra},\gloskeyval{description}{},\newline\space
+ \gloskeyval{group}{group2label}}\newline
+\gls{GlsXtrSetField}\marg{zebra}\marg{\glosfield{secondarygroup}}\marg{group3label}\newline
+\gls{newglossaryentry}\marg{aardvark}\marg{\gloskeyval{name}{aardvark},\gloskeyval{description}{},\newline\space
+ \gloskeyval{group}{group2label}}\newline
+\gls{GlsXtrSetField}\marg{aardvark}\marg{\glosfield{secondarygroup}}\marg{group1label}\newline
+\gls{newglossaryentry}\marg{gazelle}\marg{\gloskeyval{name}{gazelle},\gloskeyval{description}{},\newline\space
+ \gloskeyval{group}{group1label}}\newline
+\gls{newglossaryentry}\marg{mallard}\marg{\gloskeyval{name}{mallard},\gloskeyval{parent}{duck},\newline\space
+ \gloskeyval{description}{},\gloskeyval{group}{group2label}}
+\gls{GlsXtrSetField}\marg{mallard}\marg{\glosfield{secondarygroup}}\marg{group3label}\newline
+\codepar
+\gls{newglossary*}\marg{another}\marg{Another Glossary}\newline
+\gls{glsxtrcopytoglossary}\marg{mallard}\marg{another}\newline
+\gls{glsxtrcopytoglossary}\marg{aardvark}\marg{another}\newline
+\gls{glsxtrcopytoglossary}\marg{zebra}\marg{another}\newline
+\gls{glsxtrcopytoglossary}\marg{ant}\marg{another}\newline
+\gls{glsxtrcopytoglossary}\marg{duck}\marg{another}\newline
+\gls{setglossarypreamble}\oarg{another}\marg{\cmd{renewcommand}\marg{\gls{glsxtrgroupfield}}\marg{secondarygroup}}
+}
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\cmd{usepackage}\oarg{\opt{record},\optval{stylemods}{bookindex},\optval{style}{\glostyle{bookindex}}}\marg{glossaries-extra}
+\codepar
+\examplegroupsdefs
+\cbeg{document}
+\gls{printunsrtglossary}
+\gls{printunsrtglossary}\oarg{\printglossoptval{type}{another}}
+\cend{document}
+\end{codebox}
+This is essentially mimicking the way that the
+\resourceopt{secondary} resource option sets the
+\glosfield{secondarygroup} field and adds the redefinition of
+\gls{glsxtrgroupfield} to the secondary \idx{glossary}['s] preamble.
+(Although in this case, there's no logical order.)
+The result is shown in \exampleref{ex:unsrtcustomgrp}.
+\begin{resultbox}[float]
+\createexample*[label={ex:unsrtcustomgrp},
+title={Displaying unsorted glossaries with custom groups},
+description={Example document that doesn't require any external
+indexing and has the group labels explicitly set}]
+{\cmd{usepackage}\oarg{\opt{record},\optval{stylemods}{bookindex},\optval{style}{\glostyle{bookindex}}}\marg{glossaries-extra}^^J%
+\codepar
+\examplegroupsdefs
+}{\gls{printunsrtglossary}^^J%
+\gls{printunsrtglossary}\oarg{\printglossoptval{type}{another}}
+}
+\end{resultbox}
+
+Note that even though the duck and mallard entries have the
+\gloskey{group} and \glosfield{secondarygroup} fields set, there's
+no group title for them in either \idx{glossary} because they are
+child entries.
+
+\cmddef{glsxtraddgroup}
+This command will perform \meta{code} if the entry identified by
+\meta{entry-label} should have \idx{group} support (provided the
+\gloskey{group} field has been set). The default
+definition is:
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{glsxtraddgroup}}[2]\marg{\%
+ \gls{ifglsxtrprintglossflatten}
+ \#2\%
+ \cmd{else}
+ \gls{ifglshasparent}\marg{\#1}\marg{}\marg{\#2}\%
+ \cmd{fi}
+}
+\end{compactcodebox}
+This means that only entries that don't have a parent (with
+\printglossoptval{flatten}{false}) or any entry
+(with \printglossoptval{flatten}{true}) will have the
+\idx{group} check performed. With \app{bib2gls}, the
+\resourceopt{group-level} will redefine \gls{glsxtraddgroup} to
+always do \meta{code}, which means that all entries will have the
+\idx{group} check performed.
-\item[\catattrdef{aposplural}] If this attribute is set to \qt{true},
-\ics{newabbreviation} will insert an apostrophe (') before
-the plural suffix for the \emph{short} plural form (unless explicitly
-overridden with the \gloskey{shortplural} key). The long plural form
-is unaffected by this setting. This setting overrides
-\catattr{noshortplural}. This attribute is only applicable to entries
-defined using \cs{newabbreviation} (or \cs{newacronym} if it's using
-\cs{newabbreviation}.) Check with your supervisor, publisher or
-editor if you want to use this attribute as this
-usage is controversial.
+\begin{important}
+If no group label has been provided no header will be added.
+\end{important}
+The above document can be modified to show the sub-\idx{group}
+headings:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glsxtraddgroup}}[2]\marg{\#2}
+\gls{printunsrtglossary}
+\cmd{renewcommand}*\marg{\gls{glsxtraddgroup}}[2]\marg{\%
+ \cmd{ifnum}\gls{glscurrententrylevel}<2 \#2\cmd{fi}}
+\gls{printunsrtglossary}\oarg{\printglossoptval{type}{another}}
+\end{codebox}
+The result is shown in \exampleref{ex:unsrtcustomsubgrp}.
+\begin{resultbox}[float]
+\createexample*[label={ex:unsrtcustomsubgrp},
+title={Displaying unsorted glossaries with custom groups and sub-group headings},
+description={Example document that doesn't require any external
+indexing and has the group labels explicitly set with sub-group
+headings}]
+{\cmd{usepackage}\oarg{\opt{record},\optval{stylemods}{bookindex},\optval{style}{\glostyle{bookindex}}}\marg{glossaries-extra}^^J%
+\codepar
+\examplegroupsdefs
+}{\cmd{renewcommand}*\marg{\gls{glsxtraddgroup}}[2]\marg{\#2}^^J%
+\gls{printunsrtglossary}^^J%
+\cmd{renewcommand}*\marg{\gls{glsxtraddgroup}}[2]\marg{\%^^J
+ \cmd{ifnum}\gls{glscurrententrylevel}<2 \#2\cmd{fi}^^J%
+}^^J%
+\gls{printunsrtglossary}\oarg{\printglossoptval{type}{another}}
+}
+\end{resultbox}
+
+Note that the mallard entry (which has \idx{hierarchicallevel}~2) has its
+group shown in the first \idx{glossary} (where the group is formed
+for all levels) but not in the second \idx{glossary} (where the
+redefinition of \gls{glsxtraddgroup} restricts \idx{group} formation to
+just level~0 and level~1).
+
+There's a small visual distinction between the \idx{group} titles in
+different \idxpl{hierarchicallevel} in the above. The top-level
+(level~0) groups have the title centred, whereas the sub-groups have
+their titles indented by the same amount as the corresponding
+sub-entries. This is due to the \idx{glossarystyle}. Other styles
+may use the same formatting for all \idxpl{hierarchicallevel}.
+
+The \idxpl{glossarystyle} provided with \sty{glossaries-extra} and
+the base styles patched by \sty{glossaries-extra-stylemods} all
+redefine:
+\cmddef{glssubgroupheading}
+to format the sub-group headings in a manner applicable to the style.
+For example, styles that don't show sub-entry names typically
+redefine this command to do nothing.
+
+A default definition that simply does
+\code{\gls{glsgroupheading}\margm{group-label}} is automatically
+initialised by \gls{setglossarystyle} (via
+\gls{glsxtrpreglossarystyle}) to allow for styles that don't
+redefine this command. The first two arguments refer to the
+\idx{hierarchicallevel}, where \meta{previous level} is the level of
+the previous \idx{group} and \meta{level} is the level of this new
+sub-\idx{group}. The \meta{parent-label} is the label of the current
+entry's parent, where the current entry is the first entry of the
+sub-\idx{group} that immediately follows the heading.
+
+The \glostyle{bookindex} style defines \gls{glssubgroupheading} to
+use the style's associated command
+\gls{glsxtrbookindexformatsubheader}. This can be redefined as
+required. For example, the following uses the parent entry's
+hierarchical information:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glsxtrbookindexformatsubheader}}[5]\marg{\%
+ \cmd{ifnum}\#2>1\gls{relax}
+ \gls{glstreesubsubitem}\gls{glstreegroupheaderfmt}\marg{\gls{GlsXtrhiername}\marg{\#3} / \#5}\%
+ \cmd{else}
+ \gls{glstreesubitem}\gls{glstreegroupheaderfmt}\marg{\gls{GlsXtrhiername}\marg{\#3} / \#5}\%
+ \cmd{fi}
+}
+\end{codebox}
+
+The above examples are contrived and demonstrate the need to define
+entries in a sensible order to achieve a sensible \idx{glossary}
+with \gls{printunsrtglossary}. If you want to use this approach to
+display a \idx{glossary}, you would need to make sure that you
+take care with the order that you define entries. This can be quite
+tedious for a large number of entries.
+
+To switch to \app{bib2gls}, the entry data needs to be provided in a
+\ext{bib} file. For example, the file \filefmt{animalfamilies.bib} might
+contain:
+\newcommand*{\examplegroupsbibdefs}{%
+\atentry{index}\marg{waterfowl,\gloskeyval{user1}{Anseriformes}}\newline
+\atentry{index}\marg{ant,\gloskeyval{user1}{Formicidae}}\newline
+\atentry{index}\marg{adder,\gloskeyval{user1}{Vipera berus}}\newline
+\atentry{index}\marg{duck,\gloskeyval{parent}{waterfowl},\gloskeyval{user1}{Anatidae}}\newline
+\atentry{index}\marg{zebra,\gloskeyval{user1}{Hippotigris}}\newline
+\atentry{index}\marg{aardvark,\gloskeyval{user1}{Orycteropus
+afer}}\newline
+\atentry{index}\marg{gazelle,\gloskeyval{user1}{Gazella}}\newline
+\atentry{index}\marg{mallard,\gloskeyval{parent}{duck},\gloskeyval{user1}{Anas platyrhynchos}}
+}
+\begin{codebox}
+\examplegroupsbibdefs
+\end{codebox}
+I've included some additional information stored in the
+\gloskey{user1} field that wasn't in the earlier examples. The
+document needs to use the \opt{record} option and
+\gls{GlsXtrLoadResources} in order for it to work properly with
+\app{bib2gls}:
+\begin{codebox}
+\cmd{usepackage}\oarg{\opt{record},\optval{stylemods}{bookindex},\optval{style}{bookindex}}
+ \marg{glossaries-extra}
+\gls{newglossary*}\marg{another}\marg{Another Glossary}
+\gls{GlsXtrLoadResources}\oarg{\resourceoptval{selection}{all},\comment{select all entries}
+ \resourceoptvalm{src}{animalfamilies},\comment{identify bib file(s)}
+ \resourceoptval{sort}{en-GB},\comment{sort method}
+ \resourceoptvalm{secondary}{la:user1:another}\comment{sort again and copy to `another'}
+}
+\gls{glsdefpostname}\marg{\cat{index}}\marg{
+ (\cmd{emph}\marg{\gls{glsentryuseri}\marg{\gls{glscurrententrylabel}}})}
+\cbeg{document}
+\gls{printunsrtglossary}
+\gls{printunsrtglossary}\oarg{\printglossoptval{type}{another}}
+\cend{document}
+\end{codebox}
+If this code is saved in the file \filefmt{myDoc.tex} then the build
+process is now:
+\begin{terminal}
+pdflatex myDoc
+bib2gls \switch{group} myDoc
+pdflatex myDoc
+\end{terminal}
+The \switch{group} (or \switch{g}) switch is important as it
+instructs \app{bib2gls} to set the \gloskey{group} field for the
+primary sort and the \glosfield{secondarygroup} for the secondary
+sort. The primary sort will sort entries according to \code{en-GB}
+(British English). This can simply be set to \code{en} without a
+region. The secondary sort will resort the entries, but this time
+according to \code{la} (Latin) using the \gloskey{user1} key as the
+sort value. The entry labels will then be copied to the custom
+\code{another} glossary.
+
+The \ext{glstex} file created by \app{bib2gls} (which will then be
+input by \gls{GlsXtrLoadResources} on the subsequent \LaTeX\ run)
+essentially contains the following code:
+\begin{codebox}
+\gls{glsxtrsetgrouptitle}\marg{6881280}\marg{W}
+\gls{glsxtrsetgrouptitle}\marg{5832704}\marg{G}
+\gls{glsxtrsetgrouptitle}\marg{5373952}\marg{A}
+\gls{glsxtrsetgrouptitle}\marg{7077888}\marg{Z}
+\gls{glsxtrsetgrouptitle}\marg{another5373952}\marg{A}
+\gls{glsxtrsetgrouptitle}\marg{another5767168}\marg{F}
+\gls{glsxtrsetgrouptitle}\marg{another6356992}\marg{O}
+\gls{glsxtrsetgrouptitle}\marg{another5898240}\marg{H}
+\gls{glsxtrsetgrouptitle}\marg{another6815744}\marg{V}
+\gls{glsxtrsetgrouptitle}\marg{another5832704}\marg{G}
+\codepar
+\gls{longnewglossaryentry*}\marg{aardvark}\marg{\gloskeyval{name}{aardvark},
+ \gloskeyval{user1}{Orycteropus afer},\gloskeyval{group}{5373952}}\marg{}
+\gls{longnewglossaryentry*}\marg{adder}\marg{\gloskeyval{name}{adder},
+ \gloskeyval{user1}{Vipera berus},\gloskeyval{group}{5373952}}\marg{}
+\gls{longnewglossaryentry*}\marg{ant}\marg{\gloskeyval{name}{ant},
+ \gloskeyval{user1}{Formicidae},\gloskeyval{group}{5373952}}\marg{}
+\gls{longnewglossaryentry*}\marg{gazelle}\marg{\gloskeyval{name}{gazelle},
+ \gloskeyval{user1}{Gazella},\gloskeyval{group}{5832704}}\marg{}
+\gls{longnewglossaryentry*}\marg{waterfowl}\marg{\gloskeyval{name}{waterfowl},
+ \gloskeyval{user1}{Anseriformes},\gloskeyval{group}{6881280}}\marg{}
+\gls{longnewglossaryentry*}\marg{duck}\marg{\gloskeyval{name}{duck},
+ \gloskeyval{parent}{waterfowl},\gloskeyval{user1}{Anatidae},\gloskeyval{group}{}}\marg{}
+\gls{longnewglossaryentry*}\marg{mallard}\marg{\gloskeyval{name}{mallard},
+ \gloskeyval{parent}{duck},\gloskeyval{user1}{Anas platyrhynchos},\gloskeyval{group}{}}\marg{}
+\gls{longnewglossaryentry*}\marg{zebra}\marg{\gloskeyval{name}{zebra},
+ \gloskeyval{user1}{Hippotigris},\gloskeyval{group}{7077888}}\marg{}
+\codepar
+\gls{apptoglossarypreamble}\oarg{another}
+ \marg{\cmd{renewcommand}\marg{\gls{glsxtrgroupfield}}\marg{\glosfield{secondarygroup}}}
+\gls{glsxtrcopytoglossary}\marg{waterfowl}\marg{another}
+\gls{GlsXtrSetField}\marg{waterfowl}\marg{\glosfield{secondarygroup}}\marg{another5373952}
+\gls{glsxtrcopytoglossary}\marg{duck}\marg{another}
+\gls{glsxtrcopytoglossary}\marg{mallard}\marg{another}
+\gls{glsxtrcopytoglossary}\marg{ant}\marg{another}
+\gls{GlsXtrSetField}\marg{ant}\marg{\glosfield{secondarygroup}}\marg{another5767168}
+\gls{glsxtrcopytoglossary}\marg{gazelle}\marg{another}
+\gls{GlsXtrSetField}\marg{gazelle}\marg{\glosfield{secondarygroup}}\marg{another5832704}
+\gls{glsxtrcopytoglossary}\marg{zebra}\marg{another}
+\gls{GlsXtrSetField}\marg{zebra}\marg{\glosfield{secondarygroup}}\marg{another5898240}
+\gls{glsxtrcopytoglossary}\marg{aardvark}\marg{another}
+\gls{GlsXtrSetField}\marg{aardvark}\marg{\glosfield{secondarygroup}}\marg{another6356992}
+\gls{glsxtrcopytoglossary}\marg{adder}\marg{another}
+\gls{GlsXtrSetField}\marg{adder}\marg{\glosfield{secondarygroup}}\marg{another6815744}
+\end{codebox}
+
+It's more complicated than this as helper commands are provided to
+make it easier to customize and the entries will all have
+\gloskeyval{category}{index} since they were defined with
+\atentry{index}, but this is basically like the preamble in the
+earlier examples, except that the ordering and \idxpl{group} are
+more logical. The result is shown in \exampleref{ex:bib2glsgrp}.
+
+\begin{resultbox}[float]
+\createexample*[label={ex:bib2glsgrp},
+arara={pdflatex,bib2gls: { group: on },pdflatex,pdfcrop},
+title={Displaying sorted glossaries with groups using \appfmt{bib2gls}},
+description={Example document that uses bib2gls to created a two
+differently sorted lists with the same entries}]
+{\cbeg{filecontents*}{animalfamilies.bib}^^J%
+\examplegroupsbibdefs^^J%
+\cend{filecontents*}^^J%
+\cmd{usepackage}\oarg{\opt{record},\optval{stylemods}{bookindex},\optval{style}{bookindex}}\marg{glossaries-extra}^^J%
+\gls{newglossary*}\marg{another}\marg{Another Glossary}^^J%
+\gls{GlsXtrLoadResources}\oarg{\resourceoptval{selection}{all},\comment{select all entries}
+ \resourceoptvalm{src}{animalfamilies},\comment{identify bib file(s)}
+ \resourceoptval{sort}{en-GB},\comment{sort method}
+ \resourceoptvalm{secondary}{la:user1:another}\comment{sort again and copy to `another'}
+}^^J%
+\gls{glsdefpostname}\marg{index}\marg{ ^^J
+ (\cmd{emph}\marg{\gls{glsentryuseri}\marg{\gls{glscurrententrylabel}}})}
+}{\gls{printunsrtglossary}^^J%
+\gls{printunsrtglossary}\oarg{\printglossoptval{type}{another}}
+}
+\end{resultbox}
+
+Note that the \gloskey{group} and \glosfield{secondarygroup} fields
+haven't been set for the child entries (duck and mallard). This is
+the default behaviour and it means that regardless of the definition
+you provide for \gls{glsxtraddgroup}, sub-groups won't be displayed.
+If you want those fields set for child entries, you need to use the
+\resourceopt{group-level} resource option. For example:
+\begin{codebox}
+\gls{GlsXtrLoadResources}\oarg{\resourceoptval{selection}{all},\comment{select all entries}
+ \strong{\resourceoptvalm{group-level}{<=1},\comment{\idxc{hierarchicallevel}{level}~0 and 1}}
+ \resourceoptvalm{src}{animalfamilies},\comment{identify bib file(s)}
+ \resourceoptval{sort}{en-GB},\comment{sort method}
+ \resourceoptvalm{secondary}{la:user1:another}\comment{sort again and copy}
+}
+\end{codebox}
+
+This will add support for level~0 (no parent) and level~1 (parent
+but no grandparent) entries. Deeper levels won't have support.
+The \switch{group} switch is still required.
+
+\subsection{Location Lists}
+\label{sec:printunsrtlocations}
+
+The \idx{unsrtfam} check for the existence of the \gloskey{location}
+and \glosfield{loclist} keys. These are both defined by the \opt{record}
+option. (The \glosfield{loclist} field is also used by
+\gls{makenoidxglossaries} but isn't defined as a key.)
+
+The \gloskey{location} field (if set) should contain the formatted
+\idx{locationlist}. This is checked first and used if not empty.
+Otherwise the \glosfield{loclist} field (if set) is used, but that
+will use the same method as \gls{printnoidxglossary} to format,
+which doesn't compact consecutive locations.
+
+It's possible to choose a different field for the formatted
+\idx{locationlist} by redefining:
+\cmddef{GlsXtrLocationField}
+This should expand to the \idx{internalfieldlabel}. If the field is
+not the default \gloskey{location} then the test for
+\glosfield{loclist} is omitted.
+
+Whichever field is used, the formatted \idx{locationlist} is passed
+to the appropriate \idx{glossarystyle} command (\gls{glossentry} or
+\gls{subglossentry}) encapsulated with \gls{glossaryentrynumbers}.
+
+If there's no location field or if the tested fields are empty, then
+an empty argument (with no \gls{glossaryentrynumbers} encapsulator)
+is passed to the \idx{glossarystyle} command. In this case, the
+\opt{nonumberlist} option is redundant as there's no
+\idx{locationlist} to suppress.
+
+\subsection{Advanced Commands}
+\label{sec:printunsrtadvanced}
+
+To provide a better understanding of how filtered and inner glossaries work, it’s
+useful to understand the difference between \gls{printglossary} (used
+with \app{makeindex} and \app{xindy}) and \gls{printunsrtglossary} (used with
+\app{bib2gls}).
+
+In the first case, \app{makeindex} or \app{xindy} is used to create a file that
+contains content in the form:
+\begin{codebox}
+\gls{glossarysection}\oarg{\gls{glossarytoctitle}}\marg{\gls{glossarytitle}}\comment{}
+\gls{glossarypreamble}
+\cbeg{\env{theglossary}}\gls{glossaryheader}
+\meta{content}
+\cend{\env{theglossary}}\gls{glossarypostamble}
+\end{codebox}
+where \meta{content} contains lines such as:
+\begin{codebox}
+\gls{glsgroupheading}\margm{group label}\gls{relax} \gls{glsresetentrylist}
+\gls{glossentry}\margm{entry label}\margm{location list}\comment{}
+\gls{subglossentry}\margm{level}\margm{entry label}\margm{location list}\comment{}
+\end{codebox}
+
+The \idx{group} headings (see \sectionref{sec:printunsrtgroups}) are
+typeset using \gls{glsgroupheading}.
+Top-level entries are typeset with \gls{glossentry} and child
+entries are typeset with \gls{subglossentry} where \meta{level} indicates the
+\idx{hierarchicallevel}. Both \app{makeindex} and \app{xindy} order the items so that
+the child entries are placed immediately after the corresponding
+parent entry.
+
+The \gls{printglossary} command essentially does:
+\begin{codebox}
+\meta{Set default title and style.}
+\cmd{bgroup}
+ \meta{Initial setup.}
+ \meta{Input the file created by \app{makeindex} or \app{xindy}.}
+\cmd{egroup}
+\end{codebox}
+
+The initial setup part sets the \idx{glossarystyle} (which
+determines the definitions of \env{theglossary},
+\gls{glossaryheader}, \gls{glsgroupheading}, \gls{glossentry} and
+\gls{subglossentry}), assigns the title (\gls{glossarytitle} and
+\gls{glossarytoctitle}) and defines \gls{currentglossary}. (There is
+some other stuff done both before and after the file is input, but
+that's not relevant here.)
+
+In the case of \app{bib2gls}, there isn't a glossary file to input.
+Instead, \app{bib2gls} is used to create a file that contains the
+entry definitions, which is input in the document preamble (via
+\gls{GlsXtrLoadResources}). The entries are defined in the required
+order and use internal \idxpl{field} to store the indexing
+information (such as the \idx{group} label and
+\idxpl{locationlist}). Now \gls{printunsrtglossary} is used to
+display the glossary, which essentially does:
+\begin{codebox}
+\meta{Set default title and style.}
+\cmd{bgroup}
+ \meta{Initial setup.}
+ \gls{glossarysection}\oarg{\gls{glossarytoctitle}}\marg{\gls{glossarytitle}}\comment{}
+ \gls{glossarypreamble}
+ \meta{Construct internal control sequence containing glossary content.}
+ \meta{Expand internal control sequence.}
+ \gls{glossarypostamble}
+\cmd{egroup}
+\end{codebox}
+
+The \meta{initial setup} is the same as for \gls{printglossary}. The key
+difference here is that there's no file containing the typeset
+\idx{glossary} that can be simply input. Instead it's necessary to iterate
+over the \idx{glossary}['s] internal label list. Some of the
+\idxpl{glossarystyle} use a \env{tabular}-like
+environment (such as \env{longtable}, which is used by the
+\glostyle{long} styles).
+It's always problematic having a loop inside a \env{tabular} context so
+\gls{printunsrtglossary} by-passes the problem by moving the loop outside
+of the \env{theglossary} environment. The command iterates over all
+entry labels (in the order in which they were added to the
+\idx{glossary}) and constructs an internal control sequence
+(\inlineglsdef{@glsxtr@doglossary}), which ends up
+containing:
+\begin{codebox}
+\cbeg{\env{theglossary}}\gls{glossaryheader}\gls{glsresetentrylist}
+\meta{content}
+\cend{\env{theglossary}}
+\end{codebox}
+
+The \meta{content} in this case is different as it doesn't
+explicitly contain \gls{glossentry} and \gls{subglossentry} but
+instead uses an internal handler that just takes the entry label as
+the argument. The \code{\gls{glsgroupheading}\margm{group label}}
+command is inserted whenever a top-level entry has the group field
+set to a label that's different to the previous top-level entry’s
+group field (and, if supported, sub-groups are similarly inserted
+with \gls{glssubgroupheading}, see
+\sectionref{sec:printunsrtgroups}). So the content is in the form:
+\begin{codebox}
+\gls{glsgroupheading}\margm{group label}\comment{}
+\cmd{\meta{internal cs handler}}\margm{entry label}\comment{}
+\cmd{\meta{internal cs handler}}\margm{entry label}\comment{}
+\ldots
+\gls{glsgroupheading}\margm{group label}\comment{}
+\cmd{\meta{internal cs handler}}\margm{entry label}\comment{}
+\cmd{\meta{internal cs handler}}\margm{entry label}\comment{}
+\ldots
+\end{codebox}
+
+There are hooks and commands available for use within those
+hooks that may be adjusted to customize the way the \idx{glossary}
+is displayed. These are described below.
+
+At each iteration (while the \idx{glossary} content is being
+constructed), the following steps are performed:
+\begin{enumerate}
+\item Store the current entry label in \gls{glscurrententrylabel}.
+\item If \gls{glscurrententrylabel} is empty, skip this iteration.
+\item Define placeholder commands:
+\cmddef{glscurrententrylevel}
+This is set to the current entry's \idx{hierarchicallevel} (taking
+\printglossopt{leveloffset} and \printglossopt{flatten} options
+into account);
+\cmddef{glscurrenttoplevelentry}
+This is set to the current entry label if \gls{glscurrententrylevel}
+is 0 (that is, it expands to the most recent top-level entry,
+allowing for \printglossopt{flatten} and \printglossopt{leveloffset});
+\cmddef{glscurrentrootentry}
+This is set to the current entry label if
+\printglossoptval{flatten}{true} or if the current entry doesn't have
+a parent (that is, it expands to the most recent top-level entry,
+allowing for \printglossopt{flatten} but not \printglossopt{leveloffset}).
+\item Perform the entry process hook:
+\cmddef{printunsrtglossaryentryprocesshook}
+This does nothing by default. Within the definition of this hook,
+you may use:
+\cmddef{printunsrtglossaryskipentry}
+This will cause the remainder of the current iteration to be
+skipped, which will prevent the current entry from being shown in
+the \idx{glossary}.
+\item If \printglossoptval{groups}{true}, use \gls{glsxtraddgroup}
+(see \sectionref{sec:printunsrtgroups}) to append the top-level group heading
+(\gls{glsgroupheading}) or the sub-group heading
+(\gls{glssubgroupheading}) to \gls{@glsxtr@doglossary}.
+\item Append
+\code{\cmd{\meta{internal cs handler}}\margm{entry label}} to \gls{@glsxtr@doglossary}.
+\end{enumerate}
-\item[\catattrdef{noshortplural}] If this attribute is set to
-\qt{true}, \ics{newabbreviation} won't append the plural suffix for
-the short plural form. This means the \gloskey{short} and
-\gloskey{shortplural} values will be the same unless explicitly
-overridden. \emph{This setting is incompatible with \catattr{aposplural}.} This attribute is only applicable to entries
-defined using \cs{newabbreviation} (or \cs{newacronym} if it's using
-\cs{newabbreviation}.)
+\begin{warning}
+The placeholders \gls{glscurrenttoplevelentry} and
+\gls{glscurrentrootentry} may not be an ancestor of the current
+entry. For example, if the \idx{glossary} doesn't have child entries
+immediately following their parent entry.
+\end{warning}
+
+Once the \idx{glossary} construction (\gls{@glsxtr@doglossary}) has been completed, the
+following hook is performed:
+\cmddef{printunsrtglossarypredoglossary}
+This does nothing by default. You can redefine this to show the
+definition of \gls{@glsxtr@doglossary} for debugging purposes:
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{printunsrtglossarypredoglossary}}\marg{\comment{}
+ \cmd{csshow}\marg{@glsxtr@doglossary}}
+\end{codebox}
+This will interrupt the \LaTeX\ run and display the definition in the
+transcript.
+
+The handler command \code{\cmd{\meta{internal cs handler}}} performs
+the following:
+\begin{codebox}
+\cmd{protected@xdef}\gls{glscurrententrylabel}\margm{entry-label}\comment{}
+\gls{printunsrtglossaryhandler}\gls{glscurrententrylabel}
+\end{codebox}
+This stores the entry's label in \gls{glscurrententrylabel} (which
+allows it to be referenced in style hooks, such as the
+\idx{postnamehook} or \idx{postdeschook}). Note that it uses a
+global definition to avoid scoping issues caused with
+\env{tabular}-like styles. The main handling of the
+entry is performed by:
+\cmddef{printunsrtglossaryhandler}
+This is simply defined to use:
+\cmddef{glsxtrunsrtdo}
+This displays the entry according to the current
+\idx{glossarystyle}, taking the \idx{hierarchicallevel} into account
+(as given by \gls{glscurrententrylevel}).
+
+The following are additional commands that may be useful in the
+above hooks.
+\cmddef{glsxtriflabelinlist}
+Does \meta{true} if the given label is in the given comma-separated
+list of labels, otherwise does \meta{false}. The label and list are fully
+expanded.
+
+\cmddef{ifglsxtrprintglossflatten}
+This conditional is set by the \printglossopt{flatten} option and
+can be used to test if the option has been set.
+
+For example, the following skips all entries that have the
+\gloskey{category} set to \cat{symbol}:
+\begin{codebox}
+\cmd{usepackage}\oarg{\optval{style}{index}}\marg{glossaries-extra}
+\gls{newglossaryentry}\marg{ant}\marg{\gloskeyval{name}{ant},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{pi}\marg{\gloskeyval{name}{\cmd{ensuremath}\marg{\cmd{pi}}},\gloskeyval{description}{},
+ \gloskeyval{category}{symbol}}
+\gls{newglossaryentry}\marg{aardvark}\marg{\gloskeyval{name}{aardvark},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{alpha}\marg{\gloskeyval{name}{\cmd{ensuremath}\marg{\cmd{alpha}}},\gloskeyval{description}{},
+ \gloskeyval{category}{symbol}}
+\cbeg{document}
+\cmd{renewcommand}\marg{\gls{printunsrtglossaryentryprocesshook}}\oarg{1}\marg{\%
+ \gls{glsifcategory}\marg{\#1}\marg{symbol}\%
+ \marg{\gls{printunsrtglossaryskipentry}}\%
+ \marg{}\%
+}
+\gls{printunsrtglossary}
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample*[title={Filtering by category},
+ label={ex:filterbycat},
+description={Example document that displays a glossary with entries
+filtered by category}]
+{\cmd{usepackage}\oarg{\optval{style}{index}}\marg{glossaries-extra}^^J
+\gls{newglossaryentry}\marg{ant}\marg{\gloskeyval{name}{ant},\gloskeyval{description}{}}^^J
+\gls{newglossaryentry}\marg{pi}\marg{\gloskeyval{name}{\cmd{ensuremath}\marg{\cmd{pi}}},\gloskeyval{description}{},^^J
+ \gloskeyval{category}{symbol}}^^J%
+\gls{newglossaryentry}\marg{aardvark}\marg{\gloskeyval{name}{aardvark},\gloskeyval{description}{}}
+}{\cmd{renewcommand}\marg{\gls{printunsrtglossaryentryprocesshook}}\oarg{1}\marg{\%^^J
+ \gls{glsifcategory}\marg{\#1}\marg{symbol}\%^^J
+ \marg{\gls{printunsrtglossaryskipentry}}\%^^J
+ \marg{}\%^^J
+}^^J%
+\gls{printunsrtglossary}
+}
+\end{resultbox}
-\item[\catattrdef{headuc}] If this attribute is set to \qt{true},
-commands like \ics{glsfmtshort} will use the upper case version
-in the page headers.
+\subsubsection{Inner Glossaries}
+\label{sec:printunsrtinner}
-\item[\catattrdef{tagging}] If this attribute is set to \qt{true},
-the tagging command defined by \ics{GlsXtrEnableInitialTagging}
-will be activated to use \ics{glsxtrtagfont} in the glossary
-(see \sectionref{sec:tagging}).
+\begin{information}
+See also \gallerypage{bib2gls-inner}{Gallery: Inner or Nested Glossaries}.
+\end{information}
+
+It's possible you may want to combine multiple \idxpl{glossary}
+sequentially, as sub-blocks of a single list. The inner part of
+\gls{printunsrtglossary} can be created with:
+\cmddef{printunsrtinnerglossary}
+This can't be used on its own, as it only forms a fragment. It
+doesn't include the section header, style
+initialisation, preamble, \env{theglossary} environment, header and
+postamble.
+
+As with \gls{printunsrtglossary}, \gls{printunsrtinnerglossary}
+constructs an internal control sequence containing the content, but
+it adds scoping to localise the effects of any supplied options. So
+it essentially does:
+\begin{codebox}
+\cmd{begingroup}
+ \meta{Initial setup (process options).}
+ \meta{pre-code}
+ \meta{Construct internal control sequence containing glossary content.}
+ \meta{Expand internal control sequence.}
+ \meta{post-code}
+\cmd{endgroup}
+\end{codebox}
+
+There are two ways this command may be used.
+\envdef{printunsrtglossarywrap}
+The \env{printunsrtglossarywrap} environment takes one optional
+argument that uses the same keys as \gls{printunsrtglossary} (see
+\sectionref{sec:printglossopts}). Note that in this case the
+\printglossopt{type} key simply provides a title (if one has been assigned to that
+\idx{glossary}). It doesn't indicate the content. There's no point
+using both \printglossopt{type} and \printglossopt{title}.
+
+The start of the environment sets up the glossary style and does the header:
+\begin{codebox}
+\meta{Set default title and style.}
+\meta{Initial setup.}
+\gls{glossarysection}\oarg{\gls{glossarytoctitle}}\marg{\gls{glossarytitle}}\comment{}
+\gls{glossarypreamble}
+\cbeg{\env{theglossary}}\gls{glossaryheader}\gls{glsresetentrylist}
+\end{codebox}
+The end of this wrapper environment ends \env{theglossary} and does the postamble:
+\begin{codebox}
+\cend{\env{theglossary}}\gls{glossarypostamble}
+\end{codebox}
+
+For example, the following has two \idxpl{glossary} but displays
+them as inner \idxpl{glossary}:
+\begin{codebox}
+\gls{newglossaryentry}\marg{ant}\marg{\gloskeyval{name}{ant},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{bee}\marg{\gloskeyval{name}{bee},\gloskeyval{description}{}}
+\gls{newignoredglossary*}\marg{other}
+\gls{newglossaryentry}\marg{duck}\marg{\gloskeyval{name}{duck},\gloskeyval{description}{}}
+\gls{newglossaryentry}\marg{goose}\marg{\gloskeyval{name}{goose},\gloskeyval{description}{}}
+\cbeg{document}
+\cbeg{\env{printunsrtglossarywrap}}\oarg{\printglossoptval{style}{index}}
+\gls{glstreeitem} First Glossary
+\gls{printunsrtinnerglossary}\oarg{\printglossoptval{leveloffset}{1}}\marg{}\marg{}
+\gls{glstreeitem} Second Glossary
+\gls{printunsrtinnerglossary}\oarg{\printglossoptval{type}{other},\printglossoptval{leveloffset}{1}}\marg{}\marg{}
+\cend{\env{printunsrtglossarywrap}}
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample*[title={Inner glossaries using \envfmt{printunsrtglossarywrap}},
+ label={ex:unsrtwrap},
+description={Example document illustrating two inner glossaries offset
+by 1 level}]
+{\cmd{usepackage}\marg{glossaries-extra}^^J%
+\gls{newglossaryentry}\marg{ant}\marg{\gloskeyval{name}{ant},\gloskeyval{description}{}}^^J%
+\gls{newglossaryentry}\marg{bee}\marg{\gloskeyval{name}{bee},\gloskeyval{description}{}}^^J%
+\gls{newignoredglossary*}\marg{other}^^J%
+\gls{newglossaryentry}\marg{duck}\marg{\gloskeyval{type}{other},\gloskeyval{name}{duck},\gloskeyval{description}{}}^^J%
+\gls{newglossaryentry}\marg{goose}\marg{\gloskeyval{type}{other},\gloskeyval{name}{goose},\gloskeyval{description}{}}
+}{\cbeg{\env{printunsrtglossarywrap}}\oarg{\printglossoptval{style}{index}}^^J%
+\gls{glstreeitem} First Glossary^^J%
+\gls{printunsrtinnerglossary}\oarg{\printglossoptval{leveloffset}{1}}\marg{}\marg{}^^J%
+\gls{glstreeitem} Second Glossary^^J%
+\gls{printunsrtinnerglossary}\oarg{\printglossoptval{type}{other},\printglossoptval{leveloffset}{1}}\marg{}\marg{}^^J%
+\cend{\env{printunsrtglossarywrap}}
+}
+\end{resultbox}
+
+The other way that \gls{printunsrtinnerglossary} can be used is
+within \gls{printunsrtglossary}.
+The handler function described in \sectionref{sec:printunsrtadvanced} that's used to
+process each entry to be displayed in the \idx{glossary}, is
+defined as:
+\begin{codebox}
+\cmd{newcommand}\marg{\gls{printunsrtglossaryhandler}}[1]\marg{\gls{glsxtrunsrtdo}\marg{\#1}}
+\end{codebox}
+
+It's possible to redefine this so that it also displays an inner
+glossary. The following example has the terms \qt{pictograph} and
+\qt{Greek symbol} in the \code{main} glossary. Two
+\idxpl{ignoredglossary} are created (which don't require a title)
+where the \idx{glossary} label matches an entry label in the
+\code{main} \idx{glossary}.
+\begin{codebox}
+\cmd{usepackage}\marg{fontawesome}
+\cmd{usepackage}\oarg{\optval{style}{\glostyle{tree}}}\marg{glossaries-extra}
+\gls{newglossaryentry}\marg{pictograph}\marg{\gloskeyval{name}{pictograph},
+ \gloskeyval{description}{picture or symbol representing a word or
+phrase}}
+\gls{newglossaryentry}\marg{mathgreek}\marg{\gloskeyval{name}{Greek symbol},
+ \gloskeyval{description}{mathematical constants or functions}}
+\gls{newignoredglossary*}\marg{pictograph}
+\gls{newignoredglossary*}\marg{mathgreek}
+\gls{newglossaryentry}\marg{cut}\marg{\gloskeyval{type}{pictograph},
+ \gloskeyval{name}{\cmd{faCut}},
+ \gloskeyval{description}{cut}}
+\gls{newglossaryentry}{paste}\marg{\gloskeyval{type}{pictograph},
+\gloskeyval{name}{\cmd{faPaste}},
+ \gloskeyval{description}{paste}}
+\gls{newglossaryentry}\marg{alpha}\marg{\gloskeyval{type}{mathgreek},
+ \gloskeyval{name}{\cmd{ensuremath}\marg{\cmd{alpha}}},
+ \gloskeyval{description}{alpha}}
+\gls{newglossaryentry}\marg{beta}\marg{\gloskeyval{type}{mathgreek},
+ \gloskeyval{name}{\cmd{ensuremath}\marg{\cmd{beta}}},
+ \gloskeyval{description}{beta}}
+\cbeg{document}
+\cmd{newcommand}\marg{\cmd{nestedhandler}}[1]\marg{\%
+ \gls{glsxtrunsrtdo}\marg{\#1}\%
+ \gls{ifglossaryexists}*\marg{\#1}\%
+ \marg{\%
+ \gls{printunsrtinnerglossary}\oarg{\printglossoptvalm{type}{\#1},\printglossoptvalm{leveloffset}{++1},
+ \printglossoptval{groups}{false}}\marg{}\marg{}\%
+ }\%
+ {}\%
+}
+\gls{printunsrtglossary*}\marg{\cmd{let}\gls{printunsrtglossaryhandler}\cmd{nestedhandler}}
+\cend{document}
+\end{codebox}
+
+This creates a custom command \csfmt{nestedhandler} that can be used as the handler to
+create nested \idxpl{glossary}. After each item in the glossary, if
+the entry's label matches the label of a defined glossary, that
+glossary is displayed with its \idx{hierarchicallevel} incremented
+by 1, which creates the illusion of child entries. The resulting
+document is shown in \exampleref{ex:nested}.
+
+\begin{resultbox}
+\createexample*[label={ex:nested},
+ title={Nested glossaries},
+ description={Example document with a glossary that has inner glossaries}]
+{%
+\cmd{usepackage}\marg{fontawesome}^^J%
+\cmd{usepackage}\oarg{\optval{style}{\glostyle{tree}}}\marg{glossaries-extra}^^J%
+\gls{newglossaryentry}\marg{pictograph}\marg{\gloskeyval{name}{pictograph},^^J
+ \gloskeyval{description}{picture or symbol representing a word or
+phrase}}^^J%
+\gls{newglossaryentry}\marg{mathgreek}\marg{\gloskeyval{name}{Greek
+symbol},^^J
+ \gloskeyval{description}{mathematical constants or functions}}^^J%
+\gls{newignoredglossary*}\marg{pictograph}^^J%
+\gls{newignoredglossary*}\marg{mathgreek}^^J%
+\gls{newglossaryentry}\marg{cut}\marg{\gloskeyval{type}{pictograph},^^J
+ \gloskeyval{name}{\cmd{faCut}},^^J
+ \gloskeyval{description}{cut}}^^J%
+\gls{newglossaryentry}{paste}\marg{\gloskeyval{type}{pictograph},^^J
+\gloskeyval{name}{\cmd{faPaste}},
+ \gloskeyval{description}{paste}}^^J%
+\gls{newglossaryentry}\marg{alpha}\marg{\gloskeyval{type}{mathgreek},^^J
+ \gloskeyval{name}{\cmd{ensuremath}\marg{\cmd{alpha}}},^^J
+ \gloskeyval{description}{alpha}}^^J%
+\gls{newglossaryentry}\marg{beta}\marg{\gloskeyval{type}{mathgreek},^^J
+ \gloskeyval{name}{\cmd{ensuremath}\marg{\cmd{beta}}},^^J
+ \gloskeyval{description}{beta}}
+}{%
+\cmd{newcommand}\marg{\cmd{nestedhandler}}[1]\marg{\%^^J
+ \gls{glsxtrunsrtdo}\marg{\#1}\%^^J
+ \gls{ifglossaryexists}*\marg{\#1}\%^^J
+ \marg{\%^^J
+ \gls{printunsrtinnerglossary}\oarg{\printglossoptvalm{type}{\#1},\printglossoptvalm{leveloffset}{++1},\printglossoptval{groups}{false}}\marg{}\marg{}\%^^J
+ }\%^^J
+ {}\%^^J%
+}^^J%
+\gls{printunsrtglossary*}\marg{\cmd{let}\gls{printunsrtglossaryhandler}\cmd{nestedhandler}}
+}
+\end{resultbox}
+
+\subsubsection{Per-Unit Glossaries}
+\label{sec:printunsrtunit}
+
+If you are using \app{bib2gls} then it's possible to only list
+entries that match a particular counter value. For example, you may
+want a \idx{mini-glossary} at the start of a section that only lists the
+entries that have been \recorded\ in that section. This can be done
+by using the handler to skip entries that don't have a matching
+record. It can also be implemented with record counting, as shown in
+\exampleref{ex:recordcountminigloss} in \sectionref{sec:recordcount}.
+
+It's also possible to make each \idx{indexing} instance automatically
+make a note of a particular counter using:
+\cmddef{GlsXtrRecordCounter}
+(This doesn't correspond to a \app{bib2gls} \record. That's dealt
+with by the indexing that comes first.)
+
+This command may only be used in the preamble (with \opt{record}) and indicates that
+whenever an entry is indexed, the following line should be added to
+the \ext+{aux} file:
+\cmddef{glsxtr@counterrecord}
+where \meta{value} is given by \gls{thecounter}.
+On the next \LaTeX\ run, this information is picked up from the
+\ext{aux} file and the information is added to the
+\glosfield{record.counter} field (stored as an \sty{etoolbox}
+internal list). This internal command is only used in the \ext{aux}
+file and has a user-level hook:
+\cmddef{glsxtrAddCounterRecordHook}
+This does nothing by default. If you want to redefined this, the
+redefinition must be placed in the document preamble before the
+\ext{aux} file is input.
+
+There are two ways of skipping an entry. The first is to redefine
+\gls{printunsrtglossaryentryprocesshook} to perform the test and use
+\gls{printunsrtglossaryskipentry} to skip an unwanted entry (as
+illustrated earlier). The second is to perform the test in
+\gls{printunsrtglossaryhandler}. The first method is the better
+option for large lists that may contain group headers. The example
+below uses the second method.
+
+The file \filefmt{myentries.bib} contains the following:
+\newcommand{\printunitexamplebib}{%
+\atentry{symbol}\marg{pi,\gloskeyval{name}{\cmd{ensuremath}\marg{\cmd{pi}}},\newline
+ \gloskeyval{description}{ratio of the length of the circumference
+ of a circle to its diameter}}\newline
+\atentry{symbol}\marg{root2,\gloskeyval{name}{\cmd{ensuremath}\marg{\cmd{surd}2}},\newline
+ \gloskeyval{description}{Pythagoras' constant}}\newline
+\atentry{symbol}\marg{zeta3,\gloskeyval{name}{\cmd{ensuremath}\marg{\cmd{zeta}(3)}},\newline
+ \gloskeyval{description}{Ap\cmd{'}ery's constant}}\newline
+\atentry{symbol}\marg{zero,\gloskeyval{name}{0},\newline
+ \gloskeyval{description}{nothing or nil}}\newline
+\atentry{symbol}\marg{one,\gloskeyval{name}{1},\newline
+ \gloskeyval{description}{single entity, unity}}
+}
+\begin{codebox}
+\printunitexamplebib
+\end{codebox}
+The document redefines the handler to only show entries in the current section:
+\begin{codebox}
+\cmd{usepackage}\oarg{\opt{record},\opt{stylemods},\optval{style}{index}}\marg{glossaries-extra}
+\gls{GlsXtrRecordCounter}\marg{\ctr{section}}
+\gls{GlsXtrLoadResources}\oarg{\resourceoptvalm{src}{myentries}}
+\cbeg{document}
+\cmd{renewcommand}\marg{\gls{printunsrtglossaryhandler}}[1]\marg{\%
+ \gls{glsxtrfieldxifinlist}\marg{\#1}\marg{record.section}\marg{\thecounter{section}}
+ \marg{\gls{glsxtrunsrtdo}\marg{\#1}}\%
+ \marg{}\%
+}
+\cmd{section}\marg{Sample}
+\gls{printunsrtglossary}
+This section discusses \gls{gls}\marg{pi}, \gls{gls}\marg{root2} and
+\gls{gls}\marg{zeta3}.
+\codepar
+\cmd{section}\marg{Another Sample}
+\gls{printunsrtglossary}
+This section discusses \gls{gls}\marg{one}, \gls{gls}\marg{pi} and
+\gls{gls}\marg{zero}.
+\cend{document}
+\end{codebox}
+If the document is saved in the file \filefmt{myDoc.tex} then the
+build process is:
+\begin{terminal}
+pdflatex myDoc
+bib2gls myDoc
+pdflatex myDoc
+\end{terminal}
+The first \LaTeX\ run adds the \records\ to the \ext{aux} file for
+\app{bib2gls} to pick up, but also adds the
+\gls{glsxtr@counterrecord} lines (which \app{bib2gls} ignores) that
+setup the
+\glslink{opt.glosfield.record.counter}{\fieldfmt{record.section}}
+list field for the given entry.
+
+This means that \gls{glsxtrfieldxifinlist} can be used to determine
+whether or not the current section number (\thecounter{section}) is in
+the list. If it is, then the entry is displayed in the current
+\idx{glossarystyle} using the default \gls{glsxtrunsrtdo}. Otherwise
+nothing is displayed.
+
+The following command is provided that performs something similar:
+\cmddef{printunsrtglossaryunit}
+This is equivalent to:
+\begin{compactcodebox}
+\gls{printunsrtglossary*}\oarg{\printglossoptval{type}{\gls{glsdefaulttype}},\#1}\marg{\comment{}
+ \gls{printunsrtglossaryunitsetup}\marg{\#2}\comment{}
+}%
+\end{compactcodebox}
+This initialises the hook via:
+\cmddef{printunsrtglossaryunitsetup}
+This is essentially does:
+\begin{compactcodebox}
+\comment{redefine handler to only show entries with a match:}
+\cmd{renewcommand}\marg{\gls{printunsrtglossaryhandler}}[1]\marg{\comment{}
+ \gls{glsxtrfieldxifinlist}\marg{\#1}\marg{record.\meta{counter-name}}\marg{\thecountername}
+ \marg{\gls{glsxtrunsrtdo}\marg{\#1}}\comment{}
+ \marg{}\comment{}
+}\comment{}
+\meta{assign target name prefixes (see below)}
+\comment{suppress section header:}
+\cmd{renewcommand}*\marg{\gls{glossarysection}}[2][]\marg{}\comment{}
+\comment{append vertical space after the glossary:}
+\cmd{appto}\gls{glossarypostamble}\marg{\gls{printunsrtglossaryunitpostskip}}\comment{}
+\end{compactcodebox}
+This is more complicated than the original example as it also
+suppresses the glossary section header and modifies the target name
+prefix. Additionally, the following is appended to the end of the \idx{glossary}:
+\cmddef{printunsrtglossaryunitpostskip}
+This simply does:
+\begin{compactcodebox}
+\gls{glspar}\cmd{medskip}\gls{glspar}
+\end{compactcodebox}
+which creates a small vertical space. The target name prefix
+(\printglossopt{targetnameprefix}) is assigned as follows. If
+\theHcountername\ has been defined, the prefix is:
+\begin{compactcodebox}
+record.\meta{counter-name}.\theHcountername.\gls{@gobble}
+\end{compactcodebox}
+otherwise the prefix is:
+\begin{compactcodebox}
+record.\meta{counter-name}.\thecountername.\gls{@gobble}
+\end{compactcodebox}
+The use of \gls{@gobble} at the end discards \gls{glolinkprefix}.
+
+The above example can be rewritten using
+\gls{printunsrtglossaryunit}. I've added
+\resourceopt{symbol-sort-fallback} to sort by the description and a
+full glossary at the end of the document.
+\begin{codebox}
+\cmd{usepackage}\oarg{\opt{record},\opt{stylemods},\optval{style}{index}}\marg{glossaries-extra}
+\gls{GlsXtrRecordCounter}\marg{\ctr{section}}
+\gls{GlsXtrLoadResources}\oarg{\resourceoptvalm{src}{myentries},
+ \resourceoptval{symbol-sort-fallback}{\gloskey{description}}
+}
+\cbeg{document}
+\cmd{section}\marg{Sample}
+\gls{printunsrtglossaryunit}\marg{\ctr{section}}
+This section discusses \gls{gls}\marg{pi}, \gls{gls}\marg{root2} and
+\gls{gls}\marg{zeta3}.
+\codepar
+\cmd{section}\marg{Another Sample}
+\gls{printunsrtglossaryunit}\marg{\ctr{section}}
+This section discusses \gls{gls}\marg{one}, \gls{gls}\marg{pi} and
+\gls{gls}\marg{zero}.
+\codepar
+\gls{printunsrtglossaries}
+\cend{document}
+\end{codebox}
+The build process is the same as before:
+\begin{terminal}
+pdflatex myDoc
+bib2gls myDoc
+pdflatex myDoc
+\end{terminal}
+The resulting document is shown in \exampleref{ex:minigloss}. Note
+that all glossaries show the \idxpl{locationlist}, which all contain
+the page number~1, since the example document is only one page long.
+
+\begin{resultbox}[float]
+\createexample*[label={ex:minigloss},
+ title={Sub-glossary for a given counter value},
+ description={Example document demonstrating a mini-glossary that
+only shows entries recorded in the current section},
+ arara={pdflatex,bib2gls,pdflatex,pdfcrop}
+]
+{\cbeg{filecontents*}\marg{\cmd{jobname}.bib}^^J%
+\printunitexamplebib^^J%
+\cend{filecontents*}^^J%
+\cmd{usepackage}\oarg{\opt{record},\opt{stylemods},\optval{style}{index}}\marg{glossaries-extra}^^J
+\gls{GlsXtrRecordCounter}\marg{\ctr{section}}^^J
+\gls{GlsXtrLoadResources}\oarg{\resourceoptvalm{src}{\cmd{jobname}},^^J
+ \resourceoptval{symbol-sort-fallback}{\gloskey{description}}^^J%
+}
+}{\cmd{section}\marg{Sample}^^J%
+\gls{printunsrtglossaryunit}\marg{section}^^J%
+This section discusses \gls{gls}\marg{pi}, \gls{gls}\marg{root2} and
+\gls{gls}\marg{zeta3}.
+\codepar
+\cmd{section}\marg{Another Sample}^^J%
+\gls{printunsrtglossaryunit}\marg{section}^^J%
+This section discusses \gls{gls}\marg{one}, \gls{gls}\marg{pi} and
+\gls{gls}\marg{zero}.
+\codepar
+\gls{printunsrtglossaries}
+}
+\end{resultbox}
+
+Other variations include creating a secondary \idx{glossary} that's
+ordered differently for the \idxpl{mini-glossary}. For example:
+\begin{codebox}
+\gls{newignoredglossary*}\marg{glossary2}
+\gls{GlsXtrLoadResources}\oarg{\resourceoptvalm{src}{\cmd{jobname}},
+ \resourceoptval{symbol-sort-fallback}{\gloskey{description}},
+ \resourceoptval{secondary}{use:glossary2}
+}
+\end{codebox}
+This orders the secondary glossary according to use (the first
+record for the entire document not for the given unit).
+The \idxpl{mini-glossary} will then need the \printglossopt{type} option:
+\begin{codebox}
+\gls{printunsrtglossaryunit}\oarg{\printglossoptval{type}{glossary2}}\marg{\ctr{section}}
+\end{codebox}
+
+There is an alternative method that ensures the
+\idxpl{mini-glossary} are ordered by use
+within the section. This can be done by redefining
+\gls{glsxtrAddCounterRecordHook} to create a \idx{glossary} for each
+unit (instead of using a secondary \idx{glossary}):
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{glsxtrAddCounterRecordHook}}[3]\marg{\comment{}
+ \gls{provideignoredglossary}\marg{\#2.\#3}\comment{}
+ \gls{glsxtrcopytoglossary}*\marg{\#1}\marg{\#2.\#3}\comment{}
+}
+\end{codebox}
+(Remember this needs to be done in the preamble, before the
+\ext{aux} file is input.)
+
+This creates a \idx{glossary} with the label
+\code{\meta{counter}.\meta{value}}, if it's not already defined, and
+adds the entry's label to it. This means that this \idx{glossary}
+will only contain the entries for the matching \meta{counter} and
+\meta{value}, and the entry labels are in the order they were added
+to the \ext{aux} file.
+
+The \idx{glossary} needs to be set appropriately. For example:
+\begin{codebox}
+\gls{printunsrtglossaryunit}\oarg{\printglossoptval{type}{section.\thecounter{section}}}\marg{\ctr{section}}
+\end{codebox}
+There's now no filtering required, but \gls{printunsrtglossaryunit}
+is still useful as it automatically suppresses the section header,
+alters the hyperlink prefix and adds extra spacing after the
+glossary. However, if you prefer, you can simply do something like:
+\begin{codebox}
+\gls{printunsrtglossary*}\oarg{\printglossoptval{type}{section.\thecounter{section}},
+ \printglossoptval{target}{false}}
+{\cmd{renewcommand}*\marg{\gls{glossarysection}}[2][]\marg{}}
+\gls{printunsrtglossaryunitpostskip}
+\end{codebox}
+This is done in \exampleref{ex:minigloss2}.
+
+\begin{resultbox}[float]
+\createexample*[label={ex:minigloss2},
+ title={Sub-glossary for a given counter value ordered by use in the section},
+ description={Example document demonstrating a mini-glossary that
+only shows entries recorded in the current section in the order they
+were recorded in that section},
+ arara={pdflatex,bib2gls,pdflatex,pdfcrop}
+]
+{\cbeg{filecontents*}\marg{\cmd{jobname}.bib}^^J%
+\printunitexamplebib^^J%
+\cend{filecontents*}^^J%
+\cmd{usepackage}\oarg{\opt{record},\opt{stylemods},\optval{style}{index}}\marg{glossaries-extra}^^J
+\gls{GlsXtrRecordCounter}\marg{\ctr{section}}^^J
+\gls{GlsXtrLoadResources}\oarg{\resourceoptvalm{src}{\cmd{jobname}},^^J
+ \resourceoptval{symbol-sort-fallback}{\gloskey{description}}^^J%
+}
+\codepar
+\cmd{renewcommand}\marg{\gls{glsxtrAddCounterRecordHook}}[3]\marg{\%^^J
+ \gls{provideignoredglossary}\marg{\#2.\#3}\%^^J
+ \gls{glsxtrcopytoglossary}*\marg{\#1}\marg{\#2.\#3}\%^^J%
+}
+\codepar
+\cmd{newcommand}\marg{\cmd{minigloss}}\marg{\%^^J
+ \gls{printunsrtglossary*}\oarg{\printglossoptval{type}{section.\cmd{thesection}},^^J
+ \printglossoptval{target}{false}}^^J
+ {\cmd{renewcommand}*\marg{\gls{glossarysection}}[2][]\marg{}}^^J
+ \gls{printunsrtglossaryunitpostskip}^^J%
+}
+}{\cmd{section}\marg{Sample}^^J%
+\cmd{minigloss}^^J%
+This section discusses \gls{gls}\marg{pi}, \gls{gls}\marg{root2} and
+\gls{gls}\marg{zeta3}.
+\codepar
+\cmd{section}\marg{Another Sample}^^J%
+\cmd{minigloss}^^J%
+This section discusses \gls{gls}\marg{one}, \gls{gls}\marg{pi} and
+\gls{gls}\marg{zero}.
+\codepar
+\gls{printunsrtglossaries}
+}
+\end{resultbox}
-\item[\catattrdef{entrycount}] Unlike the above attributes,
-this attribute isn't boolean but instead must be an integer
-value and is used in combination with \ics{glsenableentrycount}
-(see \sectionref{sec:entrycountmods}). Leave blank or undefined
-for categories that shouldn't have this facility enabled. The
-value of this attribute is used by \ics{glsxtrifcounttrigger}
-to determine how commands such as \ics{cgls} should behave.
-
-With \styfmt{glossaries}, commands like \cs{cgls} use \cs{cglsformat}
-only if the previous usage count for that entry was equal to~1.
-With \styfmt{glossaries-extra} the test is now for entries that
-have the \catattr{entrycount} attribute set and
-where the previous usage count for that entry is less than or
-equal to the value of that attribute.
-
-\item[\catattrdef{linkcount}] This attribute is set to
-\texttt{true} by \ics{GlsXtrEnableLinkCounting} (see
-\sectionref{sec:linkcount}).
+\section{Standalone Entry Items}
+\label{sec:glossentry}
-\item[\catattrdef{linkcountmaster}] This attribute is set to
-the name of the master counter by \ics{GlsXtrEnableLinkCounting}
-if the optional argument is provided (see
-\sectionref{sec:linkcount}).
+It may be that you don't want a list but would rather display
+entry details throughout the document. You can simply
+do \gls{glsentryname} followed by \gls{glsentrydesc}.
+(Remember that if you don't want a sorted list, use
+\optval{sort}{none} or \optval{sort}{clear} to skip the preprocessing of the
+\gloskey{sort} field.)
+For example, in the preamble provide a custom command to display the
+entry's name and description:
+\begin{codebox}
+\cmd{newcommand}\marg{\cmd{displayterm}}[1]\marg{\%
+ \cmd{par}\cmd{medskip}\cmd{par}\cmd{noindent}
+ Definition: \gls{glsentryname}\marg{\#1}.\cmd{par}
+ \gls{glsentrydesc}\marg{\#1}
+ \cmd{par}\cmd{medskip}
+}
+\end{codebox}
+define your entries, for example:
+\begin{codebox}
+\gls{newglossaryentry}\marg{function}\marg{\gloskeyval{name}{function},
+ \gloskeyval{description}{a relation or expression involving variables}
+}
+\end{codebox}
+and then later in the text:
+\begin{codebox}
+\cmd{displayterm}\marg{function}
+\end{codebox}
-\item[\catattrdef{glossdesc}] The \ics{glossentrydesc} command
-(used in the predefined glossary styles) is modified by
-\styfmt{glossaries-extra} to check for this attribute.
-The attribute may have one of the following values:
+However, if may be that you want to use \sty{hyperref} and
+have commands like \gls{gls} link back to the place where
+the term is described. Instead of using \gls{glsentryname}
+use:
+\cmddef{glsxtrglossentry}
+where \meta{entry-label} is the entry's label.
+
+This is designed to behave much like the way the name is displayed
+in the glossary. It performs the following:
\begin{itemize}
-\item \texttt{firstuc}: the first letter of the description will be
-converted to upper case (using \ics{Glsentrydesc}).
+\item Defines \gls{glscurrententrylabel} to the entry's label.
+This is usually done at the start of the glossary style commands
+\gls{glossentry} and \gls{subglossentry} and may be used by hooks,
+such as the \idx{postnamehook}. Here the definition is localised
+so that it's only available for use in \gls{glossentryname}.
-\item \texttt{title}: the description will be used in the argument
-of the title casing command. If you have at least
-\styfmt{glossaries} v4.48, the title casing is indirectly performed
-by \cs{glscapitalisewords}, which defaults to \ics{capitalisewords}
-(provided by \sty{mfirstuc}). You can either redefine
-\cs{glscapitalisewords} if you want the change to also affect
-\ics{glsentrytitlecase} or if you only want the change to apply to
-the attribute case-changing then redefine:
-\begin{definition}[\DescribeMacro\glsxtrfieldtitlecasecs]
-\cs{glsxtrfieldtitlecasecs}\marg{phrase cs}
-\end{definition}
-For example:
-\begin{verbatim}
-\newcommand*{\glsxtrfieldtitlecasecs}[1]{\xcapitalisefmtwords*{#1}}
-\end{verbatim}
-(Note that the argument to \cs{glsxtrfieldtitlecasecs}
-will be a control sequence whose replacement text is the
-entry's description, which is why \cs{xcapitalisefmtwords}
-is needed instead of \cs{capitalisefmtwords}.)
+\item Defines \gls{currentglossary} to the entry's glossary type.
+This is usually done at the start of commands like
+\gls{printglossary} and may be used by style hooks.
+Here the definition is localised so that it's only available for use
+in \gls{glsentryitem} and \gls{glssubentryitem}. The value is obtained
+by fully expanding:
+\cmddef{GlsXtrStandaloneGlossaryType}
+which defaults to the value of the \gloskey{type} field for the
+current entry.
-\end{itemize}
-Any other values of this attribute are ignored. Remember
-that there are design limitations for both the first letter
-uppercasing and the title casing commands. See the \sty{mfirstuc}
-user manual for further details.
-
-\item[\catattrdef{glossdescfont}] (New to version 1.04)
-In addition to the above, the modified \ics{glossentrydesc}
-command also checks this attribute. If set, it should be the name of
-a control sequence (without the leading backslash) that takes one
-argument. This control sequence will be applied to the description
-text. For example:
-\begin{verbatim}
-\glssetcategoryattribute{general}{glossdescfont}{emph}
-\end{verbatim}
-
-
-\item[\catattrdef{glossname}] As \catattr{glossdesc} but applies
-to \ics{glossentryname}. Additionally, if this attribute is
-set to \qt{uc} the name is converted to all capitals.
-
-\item[\catattrdef{indexname}] If set, the \cs{glsxtrpostnamehook} hook
-used at the end of \ics{glossentryname}
-will index the entry using \ics{index}. See
-\sectionref{sec:autoindex} for further details.
+\item Increments and display the entry counters
+if the \opt{entrycounter} or \opt{subentrycounter}
+package options are set. If the entry doesn't have a parent, then
+this does:
+\begin{compactcodebox}
+\gls{glsentryitem}\margm{entry-label}
+\end{compactcodebox}
+otherwise it does:
+\cmddef{GlsXtrStandaloneSubEntryItem}
+which defaults to \code{\gls{glssubentryitem}\margm{entry-label}} if the entry
+has a parent but not a grandparent.
-\item[\catattrdef{glossnamefont}] (New to version 1.04)
-In addition to the above, the modified \ics{glossentryname}
-command also checks this attribute. If set, it should be the name of
-a control sequence (without the leading backslash) that takes one
-argument. This control sequence will be applied to the name
-text. For example:
-\begin{verbatim}
-\glssetcategoryattribute{general}{glossnamefont}{emph}
-\end{verbatim}
-Note that this overrides \cs{glsnamefont} which will only
-be used if this attribute hasn't been set.
+This reflects the behaviour of the predefined hierarchical styles.
+A bug in pre-version~1.31 used \gls{glsentryitem} for all child levels,
+which doesn't match the hierarchical glossary styles. If you want to
+restore this behaviour, just do:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{GlsXtrStandaloneSubEntryItem}}[1]\marg{\comment{}
+ \gls{glssubentryitem}\marg{\#1}}
+\end{codebox}
-Remember that glossary styles may additionally apply a font change,
-such as the list styles which put the name in the optional argument
-of \cs{item}.
+\item Sets the hyper-target if supported (using \gls{glstarget})
+and displays the entry name using:
+\cmddef{GlsXtrStandaloneEntryName}
+which uses
+\code{\gls{glstarget}\margm{entry-label}\marg{\gls{glossentryname}\margm{entry-label}}}
+by default.
+Remember that \gls{glossentryname} uses \gls{glsnamefont} or picks up
+the style from category attributes such as
+\catattr{glossnamefont}.
+\end{itemize}
+If you have used \gls{nopostdesc} or \gls{glsxtrnopostpunc}
+in any of your description fields, you can use:
+\cmddef{glsxtractivatenopost}
+to make these commands behave as they normally do within a glossary.
+This needs to be placed before:
+\begin{compactcodebox}
+\gls{glossentrydesc}\margm{entry-label}\gls{glspostdescription}
+\end{compactcodebox}
+and scoped. Note that \gls{glsnonextpages} and \gls{glsnextpages} have no
+effect outside of the glossary and are not intended for use in a
+standalone context.
-\item[\catattrdef{glosssymbolfont}] (New to version 1.42.)
-This is similar to \catattr{glossnamefont} and
-\catattr{glossdescfont} but is used by \ics{glossentrysymbol}.
+It's also possible to select a different field (rather than
+using \gloskey{name}):
+\cmddef{glsxtrglossentryother}
+The \meta{field-label} must be given using its
+\idx{internalfieldlabel}. The \meta{header} argument is the code to
+pass to the third argument of \gls{glsxtrtitleorpdforheading}. It
+may be left empty in which case the default is determined as
+follows:
+\begin{itemize}
+\item If \csfmt{glsxtrhead\meta{field-label}} is defined (see
+\sectionref{sec:headingsadvanced}), then \meta{header}
+is \csfmt{glsxtrhead\meta{field-label}}\marg{entry-label}.
-\item[\catattrdef{textformat}] (New to version 1.21.)
-Commands like \cs{gls} and \cs{glstext} have the link text
-encapsulated in the argument of \cs{glstextformat} by default. If
-this attribute is set, the control sequence given by the attribute
-value will be used instead. As with the above, the attribute value
-should be the name (without the leading backslash) of a command that
-takes a single argument (the link text). Remember that the
-abbreviation styles may apply an additional font change.
+\item Otherwise \meta{header} is simply the field value.
+\end{itemize}
+The \gls{glsxtrglossentryother} command internally uses
+\cmddef{GlsXtrStandaloneEntryOther}
+instead of \gls{GlsXtrStandaloneEntryName}, which uses
+\code{\gls{glossentrynameother}\margm{entry-label}\marg{field-label}} instead of
+\code{\gls{glossentryname}\margm{entry-label}}.
-\item[\catattrdef{hyperoutside}] (New to v1.21.) The attribute value
-may be \texttt{false}, \texttt{true} or unset. If unset,
-\texttt{true} is assumed. This indicates the default setting
-of the \gloskey[glslink]{hyperoutside} key, described in
-\sectionref{sec:wrglossary}.
+If you have loaded the \sty{glossaries-accsupp} package (through the \opt{accsupp}
+option) then accessibility support will be provided if
+there's a corresponding command:
+\begin{compactcodebox}
+\cmd{gls\meta{field-label}accessdisplay}\margm{text}\margm{entry-label}
+\end{compactcodebox}
+(for example, \gls{glssymbolaccessdisplay}).
-\item[\catattrdef{dualindex}] If set, whenever a glossary entry
-has information written to the external glossary file
-through commands like \ics{gls} and \ics{glsadd}, a~corresponding
-line will be written to the indexing file using \ics{index}. See
-\sectionref{sec:autoindex} for further details.
+This means that my custom command can be changed to:
+\begin{codebox}
+\cmd{newcommand}\marg{\cmd{displayterm}}[1]\marg{\%
+ \cmd{par}\cmd{medskip}\cmd{par}\cmd{noindent}
+ Definition: \gls{glsxtrglossentry}\marg{\#1}.\cmd{par}
+ \gls{glsentrydesc}\marg{\#1}
+ \cmd{par}\cmd{medskip}
+}
+\end{codebox}
+If I want numbered definitions, then I can use the
+package options \opt{entrycounter} or \opt{subentrycounter}
+and remove the colon:
+\begin{codebox}
+\cmd{newcommand}\marg{\cmd{displayterm}}[1]\marg{\%
+ \cmd{par}\cmd{medskip}\cmd{par}\cmd{noindent}
+ Definition \gls{glsxtrglossentry}\marg{\#1}.\cmd{par}
+ \gls{glsentrydesc}\marg{\#1}
+ \cmd{par}\cmd{medskip}
+}
+\end{codebox}
+The counter label uses a dot after the number by default
+but this can be changed to a colon:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glsentrycounterlabel}}\marg{\gls{theglossaryentry}:\cmd{space}}
+\end{codebox}
+It's now possible to not only use \gls{gls} to link back to the
+definition but also use \gls{glsrefentry} to reference
+the counter and \gls{glsxtrpageref} to reference the page number.
-\item[\catattrdef{targeturl}] If set, the hyperlink generated by
-commands like \cs{gls} will be set to the URL provided by this
-attributes value. For example:
-\begin{verbatim}
-\glssetcategoryattribute{general}{targeturl}{master-doc.pdf}
-\end{verbatim}
-(See also the accompanying sample file
-\texttt{sample-external.tex}.) If the URL contains awkward
-characters (such as \verb|%| or \verb|~|) remember that the base
-\styfmt{glossaries} package provides commands like
-\ics{glspercentchar} and \cs{glstildechar} that expand to literal
-characters.
+If I want the description to behave more like it does
+in a glossary in need to make the following modification:
+\begin{codebox}
+\cmd{newcommand}\marg{\cmd{displayterm}}[1]\marg{\%
+ \cmd{par}\cmd{medskip}\cmd{par}\cmd{noindent}
+ Definition \gls{glsxtrglossentry}\marg{\#1}.\cmd{par}
+ \cmd{begingroup}
+ \gls{glsxtractivatenopost}
+ \gls{glossentrydesc}\marg{\#1}\gls{glspostdescription}
+ \cmd{endgroup}
+ \cmd{par}\cmd{medskip}
+}
+\end{codebox}
+(Note the grouping to localise \gls{glsxtractivatenopost}.)
-If you want to a named anchor within the target URL (notionally
-adding \texttt{\#}\meta{name} to the URL), then you also
-need to set \catattr{targetname} to the anchor \meta{name}. You may
-use \cs{glslabel} within \meta{name} which is set by commands
-like \cs{gls} to the entry's label.
+You can also use \gls{glsxtrglossentry} within section headings.
+For example:
+\begin{codebox}
+\cmd{section}\marg{\gls{glsxtrglossentry}\marg{function}}
+\end{codebox}
+
+If \gls{glsxtrglossentry} occurs in a section title and
+\sty{hyperref} has been loaded, then \gls{glsxtrglossentry}
+will expand in the PDF bookmark as:
+\cmddef{GlsXtrStandaloneEntryPdfName}
+This defaults to \code{\gls{glsentryname}\margm{entry-label}}
+The page headers and table of contents will use
+\cmddef{GlsXtrStandaloneEntryHeadName}
+which defaults to \code{\gls{glsxtrheadname}\margm{entry-label}}.
+For example, to ensure that the name is displayed in
+\idx{sentencecase} in the title, PDF bookmarks and heading:
+\begin{codebox}
+\gls{glssetcategoryattribute}\marg{\cat{general}}\marg{\catattr{glossname}}\marg{firstuc}
+\cmd{renewcommand}\marg{\gls{GlsXtrStandaloneEntryPdfName}}[1]\marg{\gls{Glsentryname}\marg{\#1}}
+\cmd{renewcommand}\marg{\gls{GlsXtrStandaloneEntryHeadName}}[1]\marg{\gls{Glsentryname}\marg{\#1}}
+\end{codebox}
+Note that this requires \sty{glossaries} v4.50+ to ensure that
+\gls{Glsentryname} expands. An alternative is to use
+\gls{Glsxtrusefield}.
+
+If \gls{glsxtrglossentryother} occurs in a section title and
+\sty{hyperref} has been loaded, then \gls{glsxtrglossentryother}
+will expand in the PDF bookmark as:
+\cmddef{GlsXtrStandaloneEntryPdfOther}
+This defaults to the value of the given field.
+The page headers and table of contents will use the \meta{header}
+argument, if not empty, otherwise it will use:
+\cmddef{GlsXtrStandaloneEntryHeadOther}
+This does \csfmt{glsxtrhead\meta{field-label}}, if it exists, or
+otherwise it just does the value of the given field (which can be
+obtained with \gls{glsxtrusefield}).
+
+If you're using a page style or table of contents that doesn't use
+\gls{markright} or \gls{markboth} or \gls{@starttoc} then you need
+to insert \gls{glsxtrmarkhook} and \gls{@glsxtrinmark} at the start
+of the header or table of contents either scoped or afterwards
+cancelled with \gls{@glsxtrnotinmark} and
+\gls{glsxtrrestoremarkhook}, see \sectionref{sec:headingsadvanced}.
-All the predefined glossary styles start each entry
-listing with \cs{glstarget} which sets the anchor to
-\verb|\glolinkprefix\glslabel|, so if you want entries to link
-to glossaries in the URL given by \catattr{targeturl}, you
-can just do:
-\begin{verbatim}
-\glssetcategoryattribute{general}{targetname}{\glolinkprefix\glslabel}
-\end{verbatim}
-(If the target document changed \cs{glolinkprefix} then you will
-need to adjust the above as appropriate.)
+\section{Glossary Style Modifications}
+\label{sec:glosstylemods}
-If the anchor is in the form \meta{name1}\texttt{.}\meta{name2}
-then use \catattr{targetname} for the \meta{name2} part and
-\catattr{targetcategory} for the \meta{name1} part.
+The \sty{glossaries-extra} package redefines \gls{setglossarystyle},
+and it now includes a hook that's performed before the style is set:
+\cmddef{glsxtrpreglossarystyle}
+This allows for new style commands that aren't provided by the base
+\sty{glossaries} package to be initialised in the
+event that a style that doesn't redefine them is used. The default
+definition is:
+\begin{compactcodebox}
+\cmd{newcommand}\marg{\gls{glsxtrpreglossarystyle}}\marg{\comment{}
+ \cmd{renewcommand}*\marg{\gls{glssubgroupheading}}[4]\marg{\gls{glsgroupheading}\marg{\#\#4}}\comment{}
+}
+\end{compactcodebox}
+If you prefer a different default, you can redefine this command as
+appropriate.
-For example:
-\begin{verbatim}
-\glssetcategoryattribute{general}{targeturl}{master-doc.pdf}
-\glssetcategoryattribute{general}{targetcategory}{page}
-\glssetcategoryattribute{general}{targetname}{7}
-\end{verbatim}
-will cause all link text for \texttt{general} entries to
-link to \texttt{master-doc.pdf\#page.7} (page 7 of that PDF).
-
-If you want a mixture in your document of entries that link to
-an internal glossary and entries that link to an external URL
-then you can use the starred form of \ics{newignoredglossary}
-for the external list. For example:
-\begin{verbatim}
-\newignoredglossary*{external}
+The commands \gls{glossentryname} and \gls{glossentrydesc} are
+modified to take into account the \catattr{glossname},
+\catattr{glossnamefont}, \catattr{glossdesc} and \catattr{glossdescfont}
+attributes (see \sectionref{sec:categories}). This means you can
+make simple font or case-changing modifications to the name and description
+without defining a new glossary style.
-\glssetcategoryattribute{external}{targeturl}{master-doc.pdf}
-\glssetcategoryattribute{general}{targetname}{\glolinkprefix\glslabel}
+The command \gls{glossentrysymbol} is modified to take into account
+the \catattr{glosssymbolfont} attribute. Note that, unlike the above, there's
+no corresponding attribute to change the case as it's usually not
+appropriate to change the case of a symbol (and for some symbols,
+such as pictographs, there's no concept of case). If
+\gls{texorpdfstring} has been defined \gls{glossentrysymbol} will
+be defined to do:
+\begin{codebox}
+\gls{texorpdfstring}\margm{\TeX\ code}\margm{PDF}
+\end{codebox}
+The \meta{\TeX\ code} part is robust and deals with the actual
+typesetting of the symbol. The \meta{PDF} part is simply:
+\cmddef{glsentrypdfsymbol}
+which is defined to just do \code{\gls{glsentrysymbol}\margm{entry-label}}. The
+chances are that the code in the \gloskey{symbol} key won't be valid
+in the PDF bookmarks, so you can redefine \gls{glsentrypdfsymbol} to
+use a more appropriate field. (If you do redefine this command,
+remember that it needs to fully expand.)
-\newglossaryentry{sample}{name={sample},description={local example}}
+For example, if you are using \sty{glossaries-accsupp}, you could
+use the \gloskey{symbolaccess} field:
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{glsentrypdfsymbol}}[1]\marg{\comment{}
+ \gls{glsentrysymbolaccess}\marg{\#1}}
+\end{codebox}
+Alternatively, if you are using \app{bib2gls} you can use the \TeX\
+parser library to interpret a copy of the \gloskey{symbol} field and
+use that. For example, with the \idxpl{resourceopt}:
+\begin{codebox}
+\resourceoptvalm{replicate-fields}{\gloskey{symbol}=\gloskey{user1}},
+\resourceoptval{interpret-fields}{\gloskey{user1}}
+\end{codebox}
+This copies the value of the \gloskey{symbol} field to the
+\gloskey{user1} field (\resourceopt{replicate-fields}) and then
+replaces the value of the \gloskey{user1} field with its interpreted
+value (\resourceopt{interpret-fields}).
+
+This means you can then do:
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{glsentrypdfsymbol}}[1]\marg{\comment{}
+ \gls{glsentryuseri}\marg{\#1}}
+\end{codebox}
+(You may need \XeLaTeX\ or \LuaLaTeX\ with this method.) This allows
+\gls{glossentrysymbol} to be used in a section heading with
+standalone definitions. See the \app{bib2gls} manual for further
+details about the \TeX\ interpreter.
-\newglossaryentry{sample2}{name={sample2},
- type=external,
- category=external,
- description={external example}}
-\end{verbatim}
+If you want to adapt a style to use another field instead
+of \gloskey{name}, you can use:
+\cmddef{glossentrynameother}
+This behaves just like \gls{glossentryname} (that is, it obeys the
+\catattr{glossname} attribute, uses either the
+\catattr{glossnamefont} attribute or \gls{glsnamefont} to format the
+text, and uses the \idx{postnamehook}) but the text is obtained from
+the field given \meta{field-label} instead of \gloskey{name}. The
+\meta{field-label} argument must be the \idx{internalfieldlabel} (for
+example \code{desc} rather than \code{description}).
+
+\subsection{Post-Name Hooks}
+\label{sec:postnamehooks}
+
+The \sty{glossaries-extra} package adds a hook to
+\gls{glossentryname} and \gls{Glossentryname} (which is used in \idxpl{glossarystyle}
+to display the entry's name):
+\cmddef{glsxtrpostnamehook}
+This is the main \idx{postnamehook}, which implements additional
+hooks to allow for customisation. By default, \gls{glsxtrpostnamehook}
+checks the \catattr{indexname} attribute.
+If the attribute exists for the category to which the entry belongs,
+then the name is automatically indexed using:
+\begin{compactcodebox}
+\gls{glsxtrdoautoindexname}\margm{entry-label}\marg{\catattr{indexname}}
+\end{compactcodebox}
+See \sectionref{sec:autoindex} for further details.
-\item[\catattrdef{externallocation}] The value should be the
-file name of the target document when manually indexing an
-external location (see \sectionref{sec:wrglossary}). In general,
-it's better to use \gls{bib2gls} v1.7+ which can handle multiple
-external sources and doesn't require this attribute.
+The post-name hook \gls{glsxtrpostnamehook} will also use:
+\cmddef{glsxtrpostnamecategory}
+if it exists.
+You can use \gls{glscurrententrylabel} to obtain the entry label
+with the definition of this command. For example, suppose you are
+using a glossary style the doesn't display the symbol, you can
+insert the symbol after the name for a particular category, say,
+the \qt{symbol} category:
+\begin{codebox}
+\cmd{newcommand}*\marg{\cmd{glsxtrpostnamesymbol}}\marg{\cmd{space}
+ (\gls{glsentrysymbol}\marg{\gls{glscurrententrylabel}})}
+\end{codebox}
+For convenience, you can use:
+\cmddef{glsdefpostname}
+This is simply a shortcut for:
+\begin{compactcodebox}
+\gls{csdef}\marg{\gls{glsxtrpostnamecategory}}\margm{definition}
+\end{compactcodebox}
+Note that it doesn't check if the command has already been defined.
-\end{description}
+The \idx{postnamehook} also does:
+\cmddef{glsextrapostnamehook}
+(before \gls{glsxtrpostnamecategory}) to allow for additional
+non-category related code. This does nothing by default.
+
+\subsection{Post-Description Hooks}
+\label{sec:postdeschooks}
+
+The \sty{glossaries} package provides the hook
+\gls{glspostdescription}, which is placed after the description in
+some of the predefined styles. The \sty{glossaries-extra-stylemods}
+package modifies the predefined styles to ensure that they all use
+this hook. This provides a convenient way to make slight
+adjustments, such as appending content after the description,
+without having to define a custom glossary style.
+
+The \sty{glossaries-extra} package redefines
+\gls{glspostdescription} so that it includes the following hook:
+
+\cmddef{glsxtrpostdescription}
+This new hook simply performs the \idx{catpostdeschook}:
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glsxtrpostdescription}}\marg{\comment{}
+ \cmd{csuse}\marg{glsxtrpostdesc\gls{glscategory}\marg{\gls{glscurrententrylabel}}}\comment{}
+}
+\end{codebox}
+
+\begin{information}
+The punctuation that is automatically inserted with \opt{postdot} or
+\opt{postpunc} is placed after \gls{glsxtrpostdescription}, not
+before.
+\end{information}
+
+If you want to modify the hook for all entries (without affecting
+the \opt{postpunc} or \opt{postdot} options), then redefine
+\gls{glsxtrpostdescription}.
+If you want to adjust this hook according to the entry's category,
+then you can simply redefine the \idx{catpostdeschook}.
+\cmddef{glsxtrpostdesccategory}
+Some common \idxpl{catpostdeschook} are provided:
+\cmddef*{glsxtrpostdescgeneral}
+The \idx{postdeschook} for the \cat{general} category.
+
+\cmddef*{glsxtrpostdescterm}
+The \idx{postdeschook} for the \cat{term} category.
+
+\cmddef*{glsxtrpostdescacronym}
+The \idx{postdeschook} for the \cat{acronym} category.
+
+\cmddef*{glsxtrpostdescabbreviation}
+The \idx{postdeschook} for the \cat{abbreviation} category.
+
+The above all do nothing by default. You can redefine them with
+\gls{renewcommand} or use:
+\cmddef{glsdefpostdesc}
+This will define (or redefine) \gls{glsxtrpostdesccategory}.
+The package options \opt{symbols}, \opt{numbers} and \opt{index}
+provide corresponding \idxpl{catpostdeschook}.
+
+You can reference the current entry within these hooks using
+\gls{glscurrententrylabel}, which is defined within the
+\idx{glossary} (any of the \csfmt{print\ldots glossary} commands)
+and also within the standalone commands, such as
+\gls{glsxtrglossentry}.
+
+\cmddef{glsxtrnopostpunc}
+Suppresses the post-description punctuation that is automatically
+inserted by package options \opt{postdot} or \opt{postpunc}.
+
+The \sty{glossaries} package provides \gls{nopostdesc}, which may be
+used in the \gloskey{description} to suppress the \idx{postdeschook}
+for that entry. This suppresses both the post-description
+punctuation and the additional \gls{glsxtrpostdescription} hook.
+If you only want to suppress to punctuation, then use
+\gls{glsxtrnopostpunc} instead.
+
+\begin{information}
+The \idxpl{postdeschook} are implemented by \gls{glspostdescription}
+within the glossary style. If this command isn't used in the style,
+then the additional hooks won't be available.
+\end{information}
+
+\cmddef{glsxtrrestorepostpunc}
+If this command is placed in the definition of
+\gls{glsxtrpostdescription} or added to the \idx{catpostlinkhook},
+then it will counter-act any use of \gls{glsxtrnopostpunc} to
+restore the post-description punctuation.
-If a term is defined using \ics{newabbreviation} and accessibility
-support has been supplied via the \pkgopt{accsupp} package option
-then the following attributes are also available. If
-\gloskey{shortaccess} isn't set its value will be obtained from:
-\begin{definition}[\DescribeMacro\glsdefaultshortaccess]
-\cs{glsdefaultshortaccess}\marg{short}\marg{long}
-\end{definition}
-This is defined by \sty{glossaries-accsupp} to just do \meta{long}
-but \sty{glossaries-extra} redefines it to do \meta{long}
-(\meta{short}). The \catattr{accessinsertdots},
-\catattr{accessaposplural} and \catattr{accessnoshortplural}
-attributes below refer to the \meta{short} form that's passed to
-this command.
-
-The following attributes are only applicable to entries
-defined using \cs{newabbreviation} (or \cs{newacronym} if it's using
-\cs{newabbreviation}). They have no effect if the \pkgopt{accsupp}
-package option hasn't been used.
+These commands have no effect outside of the glossary (except with
+standalone entries that use \gls{glsxtractivatenopost} and
+\gls{glspostdescription}, see \sectionref{sec:glossentry}).
-\begin{description}
-\item[\catattrdef{accessinsertdots}] If this attribute is set to
-\qt{true} and the \sty{glossaries-accsupp} package has been loaded
-(with the \pkgopt{accsupp} option), then this behaves like
-\catattr{insertdots} but for the \meta{short} part used in the \gloskey{shortaccess} field instead
-of the \gloskey{short} field.
-This setting will be overridden by an explicit use of
-the \gloskey{shortaccess} key in the optional argument
-of \cs{newabbreviation} (or \cs{newacronym}).
-
-\item[\catattrdef{accessaposplural}] This boolean attribute overrides
-\catattr{aposplural} for the \gloskey{shortpluralaccess} key.
-Has no effect if there's no accessibility support or if
-the \gloskey{shortaccess} key hasn't been set or if the
-\gloskey{shortpluralaccess} key is explicitly set. If
-the \catattr{aposplural} is set and this attribute isn't set
-and the \gloskey{shortaccess} key is set, then the
-\catattr{aposplural} setting governs the default
-\gloskey{shortpluralaccess} setting. If you want
-\catattr{aposplural} but don't want it applied to the accessibility
-support, set the \catattr{accessaposplural} attribute to \qt{false}. This attribute is only applicable to entries
-defined using \cs{newabbreviation} (or \cs{newacronym} if it's using
-\cs{newabbreviation}.)
-
-\item[\catattrdef{accessnoshortplural}] This boolean attribute overrides
-\catattr{noshortplural} for the \gloskey{shortpluralaccess} key.
-The same conditions apply as for \catattr{accessaposplural}. This attribute is only applicable to entries
-defined using \cs{newabbreviation} (or \cs{newacronym} if it's using
-\cs{newabbreviation}.)
-
-\item[\catattrdef{nameshortaccess}] If this attribute is set to
-\qt{true}, the \gloskey{access} field (used for the \gloskey{name}
-field's accessibility support) automatically assigned if it's not
-provided.
-
-\item[\catattrdef{textshortaccess}] Like \gloskey{nameshortaccess}
-but applies to the \gloskey{textaccess} field automatically assigned if it's not
-provided.
-
-\item[\catattrdef{firstshortaccess}] Like \gloskey{nameshortaccess}
-but applies to the \gloskey{firstaccess} field automatically assigned if it's not
-provided.
-
-\item[\catattrdef{combinedfirstsep}] The separator to use for
-\ics{glscombinefirstsep}.
-
-\item[\catattrdef{combinedfirstsepfirst}] The separator to use for
-\ics{glscombinedfirstsepfirst}.
-
-\item[\catattrdef{combinedsepfirst}] The separator to use for
-\ics{glscombinesepfirst}.
-
-\item[\catattrdef{combinedsep}] The separator to use for
-\ics{glscombinedsep}.
+\subsection{Number (Location) List}
+\label{sec:glosstylenumlist}
-\end{description}
+The \idx{locationlist} is now placed inside the argument of:
+\cmddef{GlsXtrFormatLocationList}
+This is internally used by \gls{glossaryentrynumbers}. The
+\opt{nonumberlist} option redefines \gls{glossaryentrynumbers} so that it
+doesn't display the \idx{numberlist}, but it still saves the
+\idx{numberlist} in case it's required. The desired font formatting
+for the \idx{locationlist} can now more easily be set by redefining
+\gls{GlsXtrFormatLocationList}, without interfering with
+\gls{glossaryentrynumbers}.
-An attribute can be set using:
-\begin{definition}[\DescribeMacro\glssetcategoryattribute]
-\cs{glssetcategoryattribute}\marg{category-label}\marg{attribute-label}\marg{value}
-\end{definition}
-where \meta{category-label} is the category label,
-\meta{attribute-label} is the attribute label and \meta{value} is
-the new value for the attribute. \emph{This will be localised to the
-current scope.} If you want a global definition use the following
-command instead.
-
-If you want to apply the same attribute to multiple categories then
-use:
-\begin{definition}[\DescribeMacro\glssetcategoriesattribute]
-\cs{glssetcategoriesattribute}\marg{category-label list}\marg{attribute-label}\marg{value}
-\end{definition}
-\emph{This has a global effect.}
-
-If you also want to set multiple attributes to the same value, then
-you can use:
-\begin{definition}[\DescribeMacro\glssetcategoriesattributes]
-\cs{glssetcategoriesattributes}\marg{category-label list}\marg{attribute-label list}\marg{value}
-\end{definition}
-\emph{This has a global effect.}
+\begin{important}
+If you want to suppress the \idx{numberlist} always use the
+\opt{nonumberlist} option instead of redefining
+\gls{glossaryentrynumbers} to do nothing.
+\end{important}
-For example:
-\begin{verbatim}
-\newcommand{\latinname}[1]{\emph{#1}}
-\glssetcategoriesattributes{genus,species}{textformat,glossnamefont}{latinname}
-\end{verbatim}
-
-There is a shortcut version to set the \catattr{regular} attribute
-to \qt{true}:
-\begin{definition}[\DescribeMacro\glssetregularcategory]
-\cs{glssetregularcategory}\marg{category-label}
-\end{definition}
-This internally uses \cs{glssetcategoryattribute} so it has a local
-effect.
-
-If you need to lookup the category label for a particular entry, you
-can use the shortcut command:
-\begin{definition}[\DescribeMacro\glssetattribute]
-\cs{glssetattribute}\marg{entry-label}\marg{attribute-label}\marg{value}
-\end{definition}
-This uses \cs{glssetcategoryattribute} with \cs{glscategory} to set
-the attribute. Note that this will affect all other entries that
-share this entry's category.
-
-The above use local assignments so they can be placed inside a group
-to limit their definition. As from v1.47, the value can be unset using:
-\begin{definition}[\DescribeMacro\glsunsetcategoryattribute]
-\cs{glsunsetcategoryattribute}\marg{category-label}\marg{attribute-label}
-\end{definition}
-
-You can fetch the value of an attribute for a particular category
-using:
-\begin{definition}[\DescribeMacro\glsgetcategoryattribute]
-\cs{glsgetcategoryattribute}\marg{category-label}\marg{attribute-label}
-\end{definition}
-Again there is a shortcut if you need to lookup the category label
-for a given entry:
-\begin{definition}[\DescribeMacro\glsgetattribute]
-\cs{glsgetattribute}\marg{entry-label}\marg{attribute-label}
-\end{definition}
-
-You can test if an attribute has been assigned to a given
-category using:
-\begin{definition}[\DescribeMacro\glshascategoryattribute]
-\cs{glshascategoryattribute}\marg{category-label}\marg{attribute-label}\marg{true
-code}\marg{false code}
-\end{definition}
-This uses \sty{etoolbox}'s
-\cs{ifcsvoid} and does \meta{true code} if the attribute has been
-set and isn't blank and isn't \cs{relax}. The shortcut if you need
-to lookup the category label from an entry is:
-\begin{definition}[\DescribeMacro\glshasattribute]
-\cs{glshasattribute}\marg{entry-label}\marg{attribute-label}\marg{true
-code}\marg{false code}
-\end{definition}
-
-You can test the value of an attribute for a particular category
-using:
-\begin{definition}[\DescribeMacro\glsifcategoryattribute]
-\cs{glsifcategoryattribute}\marg{category-label}\marg{attribute-label}\marg{value} \marg{true-part}\marg{false-part}
-\end{definition}
-This tests if the attribute (given by \meta{attribute-label}) for
-the category (given by \meta{category-label}) is set and equal to
-\meta{value}. If true, \meta{true-part} is done. If the attribute
-isn't set or is set but isn't equal to \meta{value}, \meta{false
-part} is done.
+Note that if you are using the \idx{unsrtfam} the \idx{locationlist}
+will only be present if the appropriate field has been set (see
+\sectionref{sec:printunsrtlocations}). There's no need to save
+locations with \app{bib2gls} or with \gls{printnoidxglossary}
+because this is performed automatically (unlike \gls{printglossary}
+where the trick with \gls{glossaryentrynumbers} is required to
+capture the \idx{locationlist}).
-For example:
-\begin{verbatim}
-\glsifcategoryattribute{general}{nohyper}{true}{NO HYPER}{HYPER}
-\end{verbatim}
-This does \qt{NO HYPER} if the \category{general} category has the
-\catattr{nohyper} attribute set to \texttt{true} otherwise if
-does \qt{HYPER}.
+Sometimes users like to insert \qt{page} or \qt{pages} in front of
+the \idx{locationlist}. This is quite fiddly to do with the base
+\sty{glossaries} package, but \sty{glossaries-extra}
+provides a way of doing this. First you need to enable this
+option and specify the text to display using:
+\cmddef{GlsXtrEnablePreLocationTag}
+where \meta{page tag} is the text to display if the \idx{locationlist} only
+contains a single location and \meta{pages tag} is the text to display
+otherwise. For example:
+\begin{codebox}
+\gls{GlsXtrEnablePreLocationTag}\marg{Page: }\marg{Pages: }
+\end{codebox}
+An extra run is required when using this command.
-With boolean-style attributes like \catattr{nohyper}, make sure you
-always test for \texttt{true} not \texttt{false} in case the attribute hasn't been set.
-
-Again there's a shortcut if you need to lookup the category label
-from a particular entry:
-\begin{definition}[\DescribeMacro\glsifattribute]
-\cs{glsifattribute}\marg{entry-label}\marg{attribute-label}\marg{value}\marg{true-part} \marg{false-part}
-\end{definition}
-
-There's also a shortcut to determine if a particular category has
-the \catattr{regular} attribute set to \qt{true}:
-\begin{definition}[\DescribeMacro\glsifregularcategory]
-\cs{glsifregularcategory}\marg{category-label}\marg{true-part}\marg{false-part}
-\end{definition}
-Alternatively, if you need to lookup the category for a particular
-entry:
-\begin{definition}[\DescribeMacro\glsifregular]
-\cs{glsifregular}\marg{entry-label}\marg{true-part}\marg{false-part}
-\end{definition}
-Note that if the \catattr{regular} attribute hasn't be set, the
-above do \meta{false-part}. There are also reverse commands that
-test if the \catattr{regular} attribute has been set to \qt{false}:
-\begin{definition}[\DescribeMacro\glsifnotregularcategory]
-\cs{glsifnotregularcategory}\marg{category-label}\marg{true-part}\marg{false-part}
-\end{definition}
-or for a particular entry:
-\begin{definition}[\DescribeMacro\glsifnotregular]
-\cs{glsifnotregular}\marg{entry-label}\marg{true-part}\marg{false-part}
-\end{definition}
-Again, if the \catattr{regular} attribute hasn't been set, the above
-do \meta{false-part}, so these reverse commands aren't logically
-opposite in the strict sense.
-
-You can iterate through all entries with a given category using:
-\begin{definition}
-\cs{glsforeachincategory}\oarg{glossary-labels}\marg{category-label} \marg{glossary-cs}\marg{label-cs}\marg{body}
-\end{definition}
-This iterates through all entries in the glossaries identified by
-the comma-separated list \meta{glossary-labels} that have the
-category given by \meta{category-label} and performs \meta{body} for
-each match. Within \meta{body}, you can use \meta{glossary-cs} and
-\meta{label-cs}
-(which much be control sequences) to access the current glossary and
-entry label. If \meta{glossary-labels} is omitted, all glossaries
-are assumed.
-
-Similarly, you can iterate through all entries that have a category
-with a given attribute using:
-\begin{definition}[\DescribeMacro\glsforeachwithattribute]
-\cs{glsforeachwithattribute}\oarg{glossary-labels}\marg{attribute-label} \marg{attribute-value}\marg{glossary-cs}\marg{label-cs}\marg{body}
-\end{definition}
-This will do \meta{body} for each entry that has a category with the
-attribute \meta{attribute-label} set to \meta{attribute-value}.
-The remaining arguments are as the previous command.
-
-You can change the category for a particular entry using the
-standard glossary field changing commands, such as
-\ics{glsfielddef}. Alternatively, you can use
-\begin{definition}[\DescribeMacro\glsxtrsetcategory]
-\cs{glsxtrsetcategory}\marg{entry-labels}\marg{category-label}
-\end{definition}
-This will change the category to \meta{category-label} for each
-entry listed in the comma-separated list \meta{entry-labels}. This
-command uses \ics{glsfieldxdef} so it will expand
-\meta{category-label} and make the change global.
-
-You can also change the category for all entries with a glossary or
-glossaries using:
-\begin{definition}[\DescribeMacro\glsxtrsetcategoryforall]
-\cs{glsxtrsetcategoryforall}\marg{glossary-labels}\marg{category-label}
-\end{definition}
-where \meta{glossary-labels} is a comma-separated list of glossary
-labels.
+\begin{important}
+Use \encap{glsignore} not \encap{@gobble} as the format if you
+want to suppress the page number (and only index the entry once).
+\end{important}
-\chapter{Counting References}
-\label{sec:countref}
+See the accompanying sample file \file{sample-pages.tex} for an
+example.
+
+\begin{information}
+Note that \app{bib2gls} the \resourceopt{loc-prefix} resource option
+inserts a prefix at the start of non-empty location lists, which
+can be used as an alternative to \gls{GlsXtrEnablePreLocationTag}.
+There is also a corresponding \resourceopt{loc-suffix} option to
+provide a suffix.
+\end{information}
+
+\Idxpl{locationlist} displayed with \gls{printnoidxglossary}
+internally use:
+\gls{glsnoidxdisplayloc}
+This command is provided by \sty{glossaries}, but is modified by
+\sty{glossaries-extra} to check for the start and end range
+formation identifiers \verb|(| and \verb|)| which are discarded to
+obtain the actual control sequence name that forms the location
+formatting command.
-There are three basic ways of counting entry references:
-\begin{enumerate}
-\item Counting the total number of times \cs{glsunset} is used
-(\cs{glsreset} resets the count and is best avoided).
-This is provided by the base \styfmt{glossaries} package and is
-intended for documents where the term should be displayed
-differently if it's only been used a certain number of times.
-The information has to be written to the \texttt{.aux} file
-so that it's available on the next \LaTeX\ run.
+If the range identifiers aren't present, this just uses
+\cmddef{glsxtrdisplaysingleloc}
+otherwise it uses
+\cmddef{glsxtrdisplaystartloc}
+for the start of a range (where the identifier has been stripped
+from \meta{format}) or
+\cmddef{glsxtrdisplayendloc}
+for the end of a range (where the identifier has been stripped
+from \meta{format}).
-This method is extended by \styfmt{glossaries-extra} and is
-described in \sectionref{sec:entrycount}.
+By default the start range command saves the format in:
+\cmddef{glsxtrlocrangefmt}
+and does:
+\begin{compactcodebox}
+\gls{glsxtrdisplaysingleloc}\margm{format}\margm{location}
+\end{compactcodebox}
+(If the format is empty, it will be replaced with \code{glsnumberformat}.)
-\item Counting the total number of records. This method is
-only available with \gls{bib2gls} and is intended
-for documents where the term should be displayed differently
-if it's only been recorded (indexed) a certain number of times.
-See \sectionref{sec:recordcount} for further details.
+The end command checks that the format matches the start of the
+range, does:
+\cmddef{glsxtrdisplayendlochook}
+(which does nothing by default), followed by:
+\begin{compactcodebox}
+\gls{glsxtrdisplaysingleloc}\margm{format}\margm{location}
+\end{compactcodebox}
+and then sets \gls{glsxtrlocrangefmt} to empty.
-\item Counting the number of times the \cs{gls}-like or
-\cs{glstext}-like commands are used. (That is, those commands
-that internally use \cs{@gls@link}.) Unlike the other two methods,
-this just provides a running total rather than the total from the
-previous \LaTeX\ run. This method is intended to make it more
-convenient to work with hooks like \cs{glslinkcheckfirsthyperhook},
-\cs{glslinkpostsetkeys} or \cs{glslinkpresetkeys}.
-See \sectionref{sec:linkcount} for further details.
-\end{enumerate}
-\section{Entry Counting (First Use Flag)}
-\label{sec:entrycount}
+This means that the list
+\begin{codebox}
+\gls{glsnoidxdisplayloc}\marg{}\marg{page}\marg{(textbf}\marg{1},
+\gls{glsnoidxdisplayloc}\marg{}\marg{page}\marg{textbf}\marg{1},
+\gls{glsnoidxdisplayloc}\marg{}\marg{page}\marg{)textbf}\marg{1}.
+\end{codebox}
+doesn't display any differently from
+\begin{codebox}
+\gls{glsnoidxdisplayloc}\marg{}\marg{page}\marg{textbf}\marg{1},
+\gls{glsnoidxdisplayloc}\marg{}\marg{page}\marg{textbf}\marg{1},
+\gls{glsnoidxdisplayloc}\marg{}\marg{page}\marg{textbf}\marg{1}.
+\end{codebox}
+but it does make it easier to define your own custom list handler
+that can accommodate the ranges.
+
+\subsection{Indexing Groups}
+\label{sec:glosgroups}
+
+The letter or symbol or number \idxpl{group} are a by-product of the
+\idx{indexingapp}. These are usually determined during the sorting
+according to the first (significant) character of the sort value. If
+the first character is an alphabetical character, the group is a
+letter group, with the group label the same as the letter. If the
+sort value is numeric, the group is a number group, with the label
+\code{glsnumbers}, otherwise the group is a symbol group with the label
+\code{glssymbols}.
+
+\begin{information}
+For the \idx{unsrtfam}, see \sectionref{sec:printunsrtgroups} for
+more details about how \idx{group} headers are inserted into the
+\idx{glossary}. Only those commands are able to support
+sub-\idxpl{group}.
+\end{information}
+
+With \app{xindy}, the number group is automatically provided with
+the \optval{xindy}{glsnumbers} package option. It can be suppressed
+with \optval{xindy}{\marg{glsnumbers=false}} (see the base
+\sty{glossaries} user manual for further details).
+
+With \app{bib2gls}, group formation requires \switch{group} (or
+\switch{g}). This setting is off by default to allow for a
+faster process where no groups are required. When this setting is
+on, there are additional groups, depending on the sort method. For
+example, if you use a date-time sort method, then you will have
+date-time groups.
+
+\begin{warning}
+Take care not to confusion \idxpl{group} with hierarchy.
+See \gallerypage{logicaldivisions}{Gallery: Logical Glossary Divisions
+(type vs group vs parent)} for the difference between the
+\gloskey{group}, \gloskey{type} and \gloskey{parent} fields.
+\end{warning}
+
+The base \sty{glossaries} package provides a simplistic way of
+assigning a title to a group to allow for the use of language-sensitive
+commands \gls{glssymbolsgroupname} and \gls{glsnumbersgroupname},
+which correspond to the \code{glssymbols} and \code{glsnumbers}
+groups. The more flexible groups that can be created with
+\app{bib2gls} require a better approach that is less likely to cause
+a conflict.
+
+\cmddef{glsxtrsetgrouptitle}
+Globally assigns the given title \meta{group-title} to the group identified
+by \meta{group-label}. This command is used implicitly within the
+\ext{glstex} file to assign titles to groups obtained by \app{bib2gls}.
+Judicious definitions of the helper commands provided by
+\app{bib2gls} can provide a more flexible way of assigning groups.
+
+\cmddef{glsxtrlocalsetgrouptitle}
+As above but the assignment is local.
+
+\cmddef{glsxtrgetgrouptitle}
+Obtains the title corresponding to the group identified by
+\meta{group-label} and stores the result in \meta{cs}. This command
+first checks if a title has been assigned by
+\gls{glsxtrgetgrouptitle} and then, for compatibility with the base
+\sty{glossaries} package, it will test for the existence of
+\csfmt{\meta{group-label}groupname} if \meta{group-label} is
+\code{glssymbols} or \code{glsnumbers} or a single character.
+If no title is obtained from any of these tests, then the title will
+be assumed to be the same as the label.
+
+\begin{information}
+The \gls{printnoidxglossary} command has a slightly different
+method, which uses the character code so it's not suitable with
+\idx{utf8}. In general, \gls{printnoidxglossary} is best avoided,
+where possible, and is inappropriate for locale-sensitive sorting.
+\end{information}
+
+\subsection{\stytext{glossaries-extra-stylemods}}
+\label{sec:stylemods}
-As mentioned in \sectionref{sec:entrycountmods},
-\styfmt{glossaries-extra} modifies the \ics{glsenableentrycount} command to allow
-for the \catattr{entrycount} attribute. This means that
-you not only need to enable entry counting with
-\ics{glsenableentrycount}, but you also need
-to set the appropriate attribute (see \sectionref{sec:categories}).
+The \sty{glossaries-extra-stylemods} package (more conveniently
+loaded through the \sty{glossaries-extra}
+\opt{stylemods} option) modifies some of the predefined
+styles that are provided with the \sty{glossaries} package.
\begin{important}
-Remember that entry counting only counts the number of times an
-entry is used by commands that change the \gls{firstuseflag}. (That
-is, all those commands that mark the entry as having been used.)
-There are many commands that don't modify this flag and they won't
-contribute to the entry use count.
+Any styles loaded after \sty{glossaries-extra-stylemods} won't be
+patched.
\end{important}
-With \styfmt{glossaries-extra}, you may use \ics{cgls} instead of
-\ics{gls} even if you haven't enabled entry counting. You will only
-get a warning if you use \cs{glsenableentrycount} without setting
-the \catattr{entrycount} attribute. (With \styfmt{glossaries},
-commands like \ics{cgls} will generate a warning if
-\cs{glsenableentrycount} hasn't been used.) The abbreviation
-shortcut \ics{ab} uses \cs{cgls} (see
-\sectionref{sec:abbrshortcuts}). The acronym shortcut
-\ics{ac} uses \cs{cgls} if it's been defined with
-\pkgopt[ac]{shortcuts} (or \pkgopt[all]{shortcuts})
-but uses \cs{gls} if it's been defined with
-\pkgopt[acronyms]{shortcuts} (or \pkgopt[acro]{shortcuts}).
-
-All upper case versions (not provided by \styfmt{glossaries}) are
-also available:
-\begin{definition}[\DescribeMacro\cGLS]
-\cs{cGLS}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
+The \opt{stylemods} option may be provided without a value, in which
+case all currently defined styles will be patched. Alternatively,
+you can supply a comma-separated list as the value, which indicates
+that, for each \meta{element} in the list, the package
+\styfmt{glossary\dhyphen\meta{element}} should be loaded and, if
+it's a package provided with the base \sty{glossaries} package,
+patched. For example:
+\begin{compactcodebox}
+\cmd{usepackage}\marg{glossaries-extra}
+\cmd{usepackage}\marg{glossary-longragged}
+\cmd{usepackage}\marg{glossary-mcols}
+\cmd{usepackage}\marg{glossaries-extra-stylemods}
+\gls{setglossarystyle}\marg{\glostyle{mcolindex}}
+\end{compactcodebox}
+is equivalent to:
+\begin{compactcodebox}
+\cmd{usepackage}\oarg{\optvalm{stylemods}{longragged,mcols},\optval{style}{\glostyle{mcolindex}}}\marg{glossaries-extra}
+\end{compactcodebox}
+You may prefer to combine \optval{stylemods} with \opt{nostyles} to
+reduce the overhead of loading unnecessary packages.
+
+The \sty{glossaries-extra-stylemods} package adjusts the predefined
+styles so that they all use \gls{glspostdescription} and replaces
+any hard-coded space before the \idx{locationlist} with
+\cmddef{glsxtrprelocation}
+You can therefore redefine that command in
+combination with \opt{postpunc} to alter the separator before the
+\idx{locationlist}. For example, to have a comma followed by
+\gls{hfil}:
+\begin{codebox}
+\cmd{usepackage}[\opteqvalref{postpunc}{comma},\opt{stylemods}]\marg{glossaries-extra}
+\cmd{renewcommand}\marg{\gls{glsxtrprelocation}}\marg{\gls{hfil}}
+\end{codebox}
+
+\begin{warning}
+Be careful with doing this as it will look odd if the \gls{locationlist} is
+missing.
+\end{warning}
+
+With \app{bib2gls} you can instead redefine \gls{glsxtrprelocation}
+to do nothing and set the location prefixes with \resourceopt{loc-prefix}
+which will only apply if the entry has a \gls{locationlist}.
+Alternatively, you could redefine \gls{glsxtrprelocation} to check
+if the \gloskey{location} field is set.
+
+\subsubsection{Inline Style}
+\label{sec:stylemodsinline}
+
+The patched \glostyle{inline} style is dealt with slightly
+differently. The original definition provided by the
+\sty{glossary-inline} package uses \gls{glspostdescription} at the
+end of the glossary (not after each entry description) within the
+definition of \gls{glspostinline}. The style modification changes
+this so that \gls{glspostinline} just does a full stop followed by
+space factor adjustment, and the description
+\gls{glsinlinedescformat} and sub-entry description formats
+\gls{glsinlinesubdescformat} are redefined to include
+\gls{glsxtrpostdescription} (not \gls{glspostdescription}). This means
+that the modified \glostyle{inline} style isn't affected by the
+\opt{nopostdot} option, but the \idx{catpostdeschook}
+can still be used.
+
+\subsubsection{Tabular Styles}
+\label{sec:stylemodstab}
+
+The \env{tabular}-like styles, such as \glostyle{long} are
+adjusted so that the \gls{ifglsnogroupskip} conditional (set with
+\opt{nogroupskip}) is moved outside of the definition of
+\gls{glsgroupskip} to avoid problems that cause an \qt{Incomplete
+\csfmt{iftrue}} error with \gls{printunsrtglossary} and
+\gls{printnoidxglossary}. This means that if you want to change this
+conditional using \gls{setupglossaries} or using the
+\printglossopt{nogroupskip} option in \gls{printglossary},
+\gls{printnoidxglossary} or \gls{printunsrtglossary}, you must also
+reset the \idx{glossarystyle}.
+
+\subsubsection{List Styles}
+\label{sec:stylemodslist}
+
+The \glostyle{list} styles use:
+\cmddef{glslistprelocation}
+(which defaults to \gls{glsxtrprelocation}) for top-level items and:
+\cmddef{glslistchildprelocation}
+(which defaults to \gls{glslistprelocation}) for child items.
+
+The description (including the post-description hook)
+is governed by:
+\cmddef{glslistdesc}
+for the \glostyle{list} and \glostyle{altlist} styles (but not the
+\glostyle{listdotted} variations).
+
+The hard-coded \code{\gls{item}\oargm{target and name}} is replaced
+with:
+\cmddef{glslistitem}
+The \glostyle{altlist} styles use:
+\cmddef{glsaltlistitem}
+which internally uses \gls{glslistitem}.
+The header item (for the list styles that should the group title,
+such as \glostyle{listgroup}) is governed by:
+\cmddef{glslistgroupheaderitem}
+This ignores the \meta{group-label} by default and simply places the
+second argument in the optional argument of \gls{item}. The
+\meta{header code} is the formatted group title, possibly including
+a hypertarget. The spacing after the group item is given by:
+\cmddef{glslistgroupafterheader}
+
+For just the \glostyle{list} style and its letter group variations
+(not the \glostyle{altlist} or \glostyle{listdotted} variations) the
+\idx{locationlist} for child entries is followed by:
+\cmddef{glslistchildpostlocation}
+which defaults to a \idx{fullstop}.
+
+The default value of \gls{glslistdottedwidth} is changed so that
+it's set at the start of the document (if it hasn't been changed in
+the preamble). This should take into account situations where
+\gls{hsize} isn't set until the start of the document.
+
+The separator between groups (if not \opt{nogroupskip}) is now
+given by:
+\cmddef{glslistgroupskip}
+This defaults to \gls{indexspace} with penalties to deter page
+breaks. This command isn't used if \opt{nogroupskip} is set.
+
+\subsubsection{Tree Styles}
+\label{sec:stylemodstree}
+
+The group headings for styles like \glostyle{treegroup} are
+formatted with:
+\cmddef{glstreegroupheaderfmt}
+The navigation elements for styles like \glostyle{treehypergroup} is
+formatted with:
+\cmddef{glstreenavigationfmt}
+The above two commands are defined in terms of \gls{glstreenamefmt},
+since that was the command originally used
+for the group headings and navigation. This now allows these
+different elements to be defined independently, but the most common
+redefinition is for \gls{glstreenamefmt} to remove the bold in the
+name. If the bold is still required for the group heading and navigation
+elements, then both other commands also need redefining. To simplify
+matters, all three commands have been defined to use:
+\cmddef{glstreedefaultnamefmt}
+This simply does \code{\gls+{textbf}\margm{text}}.
+
+This means that if you want to change all three to use a particular
+style you only need to redefine \gls{glstreedefaultnamefmt}, but if
+you only want to redefine \gls{glstreenamefmt} without affecting the
+other two commands, then you now can.
+
+The separator between groups without headers is given by:
+\cmddef{glstreegroupskip}
+This defaults to just \gls{indexspace} without penalties. This
+command isn't used if \opt{nogroupskip} is set. (The penalties
+introduced in v1.41 were moved to \gls{glstreegroupheaderskip} in
+v1.42 as they are inappropriate when there's no header.)
+
+The separator between groups with headers is now given by:
+\cmddef{glstreegroupheaderskip}
+This defaults to \gls{glstreegroupskip} with penalties to deter page
+breaks after the group heading.
+
+The styles that display the \idx{group} titles now use:
+\cmddef{glstreePreHeader}
+This does nothing by default and is inserted before the group title.
+You can redefine it to add the group title to the PDF bookmarks. For
+example, if the \idx{glossary} title uses \gls{chapter} then:
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{glstreePreHeader}}[2]\marg{\comment{}
+ \gls{pdfbookmark}\oarg{1}\marg{\#2}\marg{\gls{currentglossary}.\#1}\comment{}
+}
+\end{codebox}
+will insert section-level bookmarks. The use of \gls{currentglossary}
+helps to provide unique bookmark labels in the event of multiple
+glossaries.
+
+The \sty{glossary-tree} package provides the commands
+\cmddef{glstreepredesc}
and
-\begin{definition}[\DescribeMacro\cGLSpl]
-\cs{cGLSpl}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-These are analogous to \cs{cgls} and \cs{cglspl} but they
-use
-\begin{definition}[\DescribeMacro\cGLSformat]
-\cs{cGLSformat}\marg{label}\marg{insert}
-\end{definition}
+\cmddef{glstreechildpredesc}
+(which both default to a space) and uses them in the \glostyle{tree}-like
+styles, but not for the \glostyle{alttree} style. The
+\sty{glossaries-extra-stylemods} package modifies the
+\glostyle{alttree} style so that it has equivalent hooks:
+\cmddef{glsalttreepredesc}
and
-\begin{definition}[\DescribeMacro\cGLSplformat]
-\cs{cGLSplformat}\marg{label}\marg{insert}
-\end{definition}
-which convert the analogous \cs{cglsformat} and
-\cs{cglsplformat} to upper case.
+\cmddef{glsalttreechildpredesc}
+These do nothing by default.
-Just using \styfmt{glossaries}:
-\begin{verbatim}
-\documentclass{article}
+The \glostyle{index}-like and \glostyle{tree}-like styles
+insert the pre-\idx{locationlist} space with:
+\cmddef{glstreeprelocation}
+(which defaults to \gls{glsxtrprelocation}) for top-level items and
+\cmddef{glstreechildprelocation}
+(which defaults to \gls{glstreeprelocation}) for child items.
+
+The styles like \glostyle{treenoname} use:
+\cmddef{glstreenonamedesc}
+to display the
+pre-description separator, the description and the post-description
+hook. Similarly for the symbol:
+\cmddef{glstreenonamesymbol}
+The above are just used for top-level entries. Child entries don't
+have the name or symbol displayed for the \glostyle{treenoname}
+styles, so there's only a command for the child description:
+\cmddef{glstreenonamechilddesc}
-\usepackage{glossaries}
+For the \glostyle{tree} styles (but not the \glostyle{treenoname} or
+\glostyle{alttree} styles), the description is displayed using:
+\cmddef{glstreedesc}
+and the symbol with:
+\cmddef{glstreesymbol}
+Again the above two commands are just for top-level entries. The
+child entries use:
+\cmddef{glstreechilddesc}
+for the description and
+\cmddef{glstreechildsymbol}
+for the symbol.
+There are now wrapper commands for
+\gls{glstreedesc} and \gls{glstreechilddesc} that check for
+the description and symbol to determine what separator to use
+before the page list:
+\cmddef{glstreeDescLoc}
+for top-level entries and
+\cmddef{glstreeChildDescLoc}
+for sub-entries.
-\makeglossaries
+If either the symbol or description is present these will use
+\gls{glstreeprelocation} or \gls{glstreechildprelocation},
+respectively. Otherwise, both will use:
+\cmddef{glstreeNoDescSymbolPreLocation}
+The default is a space. This means that you could have, say, a
+comma followed by a space for terms that are simply an alias, but
+just have a space for terms that have a description that ends with a
+full stop (or that just have a symbol without a description) where
+the comma would be inappropriate.
-\glsenableentrycount
+\begin{information}
+Version 1.42 has corrected an error that was introduced to
+v1.41 that caused the name to run into the location list if there
+was no symbol and no description.
+\end{information}
-\newacronym{html}{HTML}{hypertext markup language}
-\newacronym{xml}{XML}{extensible markup language}
+There are some additional commands for use with the
+\glostyle{alttree} style to make it easier to modify.
+These commands are only defined if the
+\sty{glossary-tree} package has already been loaded, which is
+typically the case unless the \opt{notree} or \opt{nostyles} option has been used
+when loading \sty{glossaries}.
-\begin{document}
+\cmddef{gglssetwidest}
+This is like \gls{glssetwidest} but performs a global assignment.
-Used once: \cgls{html}.
+\cmddef{eglssetwidest}
+This is like \gls{glssetwidest} but expands \meta{name}.
-Used twice: \cgls{xml} and \cgls{xml}.
+\cmddef{xglssetwidest}
+This is like \gls{eglssetwidest} but performs a global assignment.
-\printglossaries
+The following only set the value if \meta{name} is wider than the
+current value. Local update:
+\cmddef{glsupdatewidest}
+Global update:
+\cmddef{gglsupdatewidest}
+Locale update (expands \meta{name}):
+\cmddef{eglsupdatewidest}
+Global update (expands \meta{name}):
+\cmddef{xglsupdatewidest}
+
+The widest entry value can later be retrieved using:
+\cmddef{glsgetwidestname}
+which expands to the widest top-level name and:
+\cmddef{glsgetwidestsubname}
+expands to either the widest name for the given
+\idx{hierarchicallevel} or to the widest top-level name, if no
+widest name set for \meta{level}.
+
+Note that if you are using \app{bib2gls}, you can use the
+resource option \resourceopt{set-widest} which will try to determine the
+widest name of all the selected entries. This isn't guaranteed
+to work as it may depend on fonts or commands that \app{bib2gls}
+can't replicate, but it should be suitable for names that just
+consist of text, and can be more efficient than iterating over all
+the defined entries using \TeX.
-\end{document}
-\end{verbatim}
+The command \gls{glsfindwidesttoplevelname} provided by
+\sty{glossary-tree} has a CamelCase synonym:
+\cmddef{glsFindWidestTopLevelName}
+Similar commands are also provided. If the optional \meta{glossary
+labels} is omitted, the list of all non-\idxpl{ignoredglossary} is
+assumed.
+\cmddef{glsFindWidestUsedTopLevelName}
+This has an additional check that the entry has been \idxc{firstuseflag}{used}.
+Naturally this is only useful if the glossaries that use
+the \glostyle{alttree} style occur at the end of the document.
+This command should be placed just before the start of the glossary.
+(Alternatively, place it at the end of the document and save
+the value in the auxiliary file for the next run.)
-If you switch to \styfmt{glossaries-extra} you must set the
-\catattr{entrycount} attribute:
-\begin{verbatim}
-\documentclass{article}
+\cmddef{glsFindWidestUsedAnyName}
+This is like the previous command but if doesn't check the
+\gloskey{parent} key. This is useful if all
+\idxpl{hierarchicallevel} should have the same width for the name.
-\usepackage{glossaries-extra}
+\cmddef{glsFindWidestAnyName}
+This is like the previous command but doesn't check if the entry
+has been used.
-\makeglossaries
+\cmddef{glsFindWidestUsedLevelTwo}
+This is like \gls{glsFindWidestUsedTopLevelName} but also sets
+the first two sub-levels as well. Any entry that has a
+great-grandparent is ignored.
-\glsenableentrycount
+\cmddef{glsFindWidestLevelTwo}
+This is like the previous command but doesn't check if the entry has
+been used.
-\glssetcategoryattribute{abbreviation}{entrycount}{1}
+\cmddef{glsFindWidestUsedAnyNameSymbol}
+This is like \gls{glsFindWidestUsedAnyName} but also measures the
+symbol. The length of the widest symbol is stored in
+\meta{register}.
-\newabbreviation{html}{HTML}{hypertext markup language}
-\newabbreviation{xml}{XML}{extensible markup language}
+\cmddef{glsFindWidestAnyNameSymbol}
+This is like the previous command but it doesn't check if the entry
+has been used.
-\begin{document}
+\cmddef{glsFindWidestUsedAnyNameSymbolLocation}
+This is like \gls{glsFindWidestUsedAnyNameSymbol} but also
+measures the \idx{locationlist}. This requires
+\gls{glsentrynumberlist}.
+The length of the widest symbol is stored in \meta{register1}
+and the length of the widest \idx{locationlist} is stored in
+\meta{register2}.
-Used once: \cgls{html}.
+\cmddef{glsFindWidestAnyNameSymbolLocation}
+This is like the previous command but it doesn't check if the entry
+has been used.
-Used twice: \cgls{xml} and \cgls{xml}.
+\cmddef{glsFindWidestUsedAnyNameLocation}
+This is like \gls{glsFindWidestUsedAnyNameSymbolLocation} but doesn't
+measure the symbol. The length of the widest \idx{locationlist}
+is stored in \meta{register}.
-\printglossaries
+\cmddef{glsFindWidestAnyNameLocation}
+This is like the previous command but doesn't check if the entry has
+been used.
-\end{document}
-\end{verbatim}
-
-When activated with \cs{glsenableentrycount}, commands such as
-\ics{cgls} now use
-\begin{definition}[\DescribeMacro\glsxtrifcounttrigger]
-\cs{glsxtrifcounttrigger}\marg{label}\marg{trigger code}\marg{normal
-code}
-\end{definition}
-to determine if the entry trips the entry count trigger.
-The \meta{trigger code} uses commands like \cs{cglsformat} and
-unsets the \gls{firstuseflag}. The \meta{normal code} is the code that
-would ordinarily be performed by whatever the equivalent
-command is (for example, \cs{cgls} will use \cs{cglsformat} in
-\meta{trigger code} but the usual \cs{gls} behaviour in \meta{normal
-code}).
+The layout of the symbol, description and \idx{locationlist}
+is governed by:
+\cmddef{glsxtralttreeSymbolDescLocation}
+for top-level entries and
+\cmddef{glsxtralttreeSubSymbolDescLocation}
+for sub-entries.
-The default definition is:
-\begin{verbatim}
-\newcommand*{\glsxtrifcounttrigger}[3]{%
- \glshasattribute{#1}{entrycount}%
- {%
- \ifnum\glsentryprevcount{#1}>\glsgetattribute{#1}{entrycount}\relax
- #3%
- \else
- #2%
- \fi
- }%
- {#3}%
-}
-\end{verbatim}
-This means that if an entry is assigned to a category that has
-the \catattr{entrycount} attribute then the \meta{trigger code}
-will be used if the previous count value
-(the number of times the entry was used on the last run) is greater
-than the value of the attribute.
-
-For example, to trigger normal use if the previous count value
-is greater than four:
-\begin{verbatim}
-\glssetcategoryattribute{abbreviation}{entrycount}{4}
-\end{verbatim}
-
-There is a convenient command provided to enable entry counting,
-set the \catattr{entrycount} attribute and redefine \ics{gls},
-etc to use \ics{cgls} etc:
-\begin{definition}[\DescribeMacro\GlsXtrEnableEntryCounting]
-\cs{GlsXtrEnableEntryCounting}\marg{categories}\marg{value}
-\end{definition}
-The first argument \meta{categories} is a comma-separated list
-of categories. For each category, the \catattr{entrycount}
-attribute is set to \meta{value}. In addition, this does:
-\begin{verbatim}
-\renewcommand*{\gls}{\cgls}%
-\renewcommand*{\Gls}{\cGls}%
-\renewcommand*{\glspl}{\cglspl}%
-\renewcommand*{\Glspl}{\cGlspl}%
-\renewcommand*{\GLS}{\cGLS}%
-\renewcommand*{\GLSpl}{\cGLSpl}%
-\end{verbatim}
-This makes it easier to enable entry-counting on existing
-documents.
-
-If you use \cs{GlsXtrEnableEntryCounting} more than once, subsequent uses will
-just set the \catattr{entrycount} attribute for each listed
-category.
+There is now a user level command that performs the initialisation
+for the \glostyle{alttree} style:
+\cmddef{glsxtralttreeInit}
+The paragraph indent for subsequent paragraphs in multi-paragraph
+descriptions is provided by the length:
+\cmddef{glsxtrAltTreeIndent}
-The above example document can then become:
-\begin{verbatim}
-\documentclass{article}
+For additional commands that are available with the
+\glostyle{alttree} style, see the documented code
+(\filefmt{glossaries-extra-code.pdf}). See also
+the accompanying sample files \file{sample-alttree.tex},
+\file{sample-alttree-sym.tex} and
+\file{sample-alttree-marginpar.tex}.
-\usepackage{glossaries-extra}
+\section{New Glossary Styles}
+\label{sec:newglossarystyles}
-\makeglossaries
+The \sty{glossaries-extra} package comes with some new styles.
+The associated style package needs to be loaded. This can be done
+with \csfmt{usepackage} but it's simpler to use the \opt{stylemods}
+option. For example:
+\begin{codebox}
+\cmd{usepackage}\oarg{\optval{stylemods}{bookindex},\optval{style}{bookindex}}\marg{glossaries-extra}
+\end{codebox}
+If you don't require any of the base styles, use \opt{nostyles} (but
+note that some style packages automatically load another style
+package if it the style builds on an existing one).
+
+\subsection{\stytext{glossary-bookindex} package}
+\label{sec:bookindex}
-\GlsXtrEnableEntryCounting{abbreviation}{1}
+\glsaddeach[format=(]{opt.glostyle.bookindex,pkg.glossary-bookindex}%
+The \inlineglsdef{pkg.glossary-bookindex} package provides the glossary style
+\inlineglsdef{opt.glostyle.bookindex}. This is very similar to the
+\glostyle{mcolindexgroup} style but is designed for indexes, so by
+default only the name and location list are displayed. This style is
+demonstrated in \exampleref{ex:bookindex} (using \app{bib2gls}).
+Note that some entries don't have \idxpl{locationlist} because they
+weren't \recorded\ in the document, but were included as
+dependencies. See \sectionref{sec:seenoindex} for dealing with
+cross-references that may not be required.
+
+\begin{resultbox}[float]
+\createexample*[label={ex:bookindex},
+arara={pdflatex,bib2gls: { group: on },pdflatex,pdfcrop},
+title={The \optfmt{bookindex} style},
+ description={Example document demonstrating the bookindex style}]
+{\cmd{usepackage}\oarg{record,nostyles,stylemods=bookindex,style=bookindex}\marg{glossaries-extra}^^J%
+\gls{GlsXtrLoadResources}\oarg{src=example-glossaries-xr,^^J
+ selection=\marg{recorded and deps and see not also}^^J%
+}
+}
+{\gls{glsaddeach}\marg{lorem,amet,adipiscing,placerat,arcu,vulputate}^^J%
+\gls{glsaddeach}\oarg{thevalue=2}\marg{arcu,consectetuer,donec,augue}^^J%
+\gls{glsaddeach}\oarg{thevalue=3}\marg{arcu,lorem,nulla}^^J%
+\gls{printunsrtglossary}
+}
+\end{resultbox}
-\newabbreviation{html}{HTML}{hypertext markup language}
-\newabbreviation{xml}{XML}{extensible markup language}
+The \glostyle{bookindex} style only supports a maximum
+\idx{hierarchicallevel} of 2 (top-level, level~1 and level~2). It's
+primarily designed for use with \app{bib2gls}. It may be used with
+other indexing options, but some features may not be present and
+\idx{utf8} characters may cause a problem with non-Unicode engines in
+letter group headings or PDF bookmarks. (\app{bib2gls} uses numeric
+identifies by default to avoid these problems, see \sectionref{sec:printunsrtgroups}.)
-\begin{document}
+The number of columns is given by:
+\cmddef{glsxtrbookindexcols}
+which defaults to 2.
-Used once: \gls{html}.
+This style uses the \env{multicols} environment. If
+the command:
+\cmddef{glsxtrbookindexcolspread}
+isn't empty then it's supplied as the optional argument
+following \code{\cbeg{multicols}\margm{n}}. You can switch from
+\env{multicols} to \env{multicols*} by redefining:
+\cmddef{glsxtrbookindexmulticolsenv}
+For example:
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{glsxtrbookindexmulticolsenv}}\marg{multicols*}
+\end{codebox}
-Used twice: \gls{xml} and \gls{xml}.
+Each top-level entry is displayed using:
+\cmddef{glsxtrbookindexname}
+This just does \code{\gls{glossentryname}\margm{entry-label}} by default.
+For example, if you want the symbol to be included:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glsxtrbookindexname}}[1]\marg{\comment{}
+ \gls{glossentryname}\marg{\#1}\comment{}
+ \gls{ifglshassymbol}\marg{\#1}\marg{\cmd{space} (\gls{glossentrysymbol}\marg{\#1})}\marg{}\comment{}
+}
+\end{codebox}
+or if you want the description (if set):
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glsxtrbookindexname}}[1]\marg{\comment{}
+ \gls{glossentryname}\marg{\#1}\comment{}
+ \gls{ifglshasdesc}\marg{\#1}\marg{\cmd{space} \gls{glossentrydesc}\marg{\#1}\gls{glspostdescription}}{}\comment{}
+}
+\end{codebox}
+(which picks up the \idx{postdeschook}).
-\printglossaries
+Alternatively you can use the \gls{glsxtrpostnamecategory}
+hook to append information after the name according to the entry's
+category.
-\end{document}
-\end{verbatim}
-
-The standard entry-counting function describe above counts
-the number of times an entry has been marked as used throughout
-the document. (The reset commands will reset the total back to
-zero.) If you prefer to count per sectional-unit, you can
-use
-\begin{definition}[\DescribeMacro\GlsXtrEnableEntryUnitCounting]
-\cs{GlsXtrEnableEntryUnitCounting}\marg{categories}\marg{value}\marg{counter-name}
-\end{definition}
-where \meta{categories} is a comma-separated list of categories
-to which this feature should be applied, \meta{value} is the
-trigger value and \meta{counter-name} is the name of the counter
-used by the sectional unit.
+Sub-entries are displayed using:
+\cmddef{glsxtrbookindexsubname}
+which just defaults to \code{\gls{glsxtrbookindexname}\margm{entry-label}}.
+
+The separator used before the \idx{locationlist} for top-level
+entries is given by:
+\cmddef{glsxtrbookindexprelocation}
+where \meta{entry-label} is the entry's label. This checks if
+the \gloskey{location} field has been set. If it has, it
+does:
+\begin{codebox}
+,\gls{glsxtrprelocation}
+\end{codebox}
+otherwise it just does \gls{glsxtrprelocation} (which defaults to
+\csfmt{space}) with no comma. If you're using \app{bib2gls}
+with \resourceoptval{save-locations}{false}, the
+\gloskey{location} field won't be set.
+
+The separator used before the \idx{locationlist} for sub-entries is given by:
+\cmddef{glsxtrbookindexsubprelocation}
+which defaults to \code{\gls{glsxtrbookindexprelocation}\marg{entry-label}}.
-\begin{important}
-Due to the asynchronous nature of \TeX's output routine,
-discrepancies will occur in page spanning paragraphs if you
-use the \ctr{page} counter.
-\end{important}
+The actual location list is encapsulated with:
+\cmddef{glsxtrbookindexlocation}
+for top-level entries and:
+\cmddef{glsxtrbookindexsublocation}
+for sub-entries. These both just do \meta{location list} by default.
-Note that you can't use both the document-wide counting and
-the per-unit counting in the same document.
+The separator used between a top-level parent and child entry is
+given by:
+\cmddef{glsxtrbookindexparentchildsep}
+This defaults to \csfmt{nopagebreak}.
-The counter value is used as part of a label, which means
-that \cs{the}\meta{counter-name} needs to be expandable.
-Since \sty{hyperref} also has a similar requirement and provides
-\cs{theH}\meta{counter-name} as an expandable alternative,
-\styfmt{glossaries-extra} will use \cs{theH}\meta{counter-name}
-if it exists otherwise it will use \cs{the}\meta{counter-name}.
-
-The per-unit counting function uses two attributes: \catattr{entrycount}
-(as before) and \catattr{unitcount} (the name of the counter).
-
-Both the original document-wide counting mechanism and the
-per-unit counting mechanism provide a command that can be
-used to access the current count value for this run:
-\begin{definition}[\DescribeMacro\glsentrycurrcount]
-\cs{glsentrycurrcount}\marg{label}
-\end{definition}
-and the final value from the previous run:
-\begin{definition}[\DescribeMacro\glsentryprevcount]
-\cs{glsentryprevcount}\marg{label}
-\end{definition}
-In the case of the per-unit counting, this is the final value
-\emph{for the current unit}. In both commands \meta{label}
-is the entry's label.
-
-The per-unit counting mechanism additionally provides:
-\begin{definition}[\DescribeMacro\glsentryprevtotalcount]
-\cs{glsentryprevtotalcount}\marg{label}
-\end{definition}
-which gives the sum of all the per-unit totals from the previous run
-for the entry given by \meta{label}, and
-\begin{definition}[\DescribeMacro\glsentryprevmaxcount]
-\cs{glsentryprevmaxcount}\marg{label}
-\end{definition}
-which gives the maximum per-unit total from the previous run.
-
-The above two commands are unavailable for the document-wide counting.
-
-Example of per-unit counting, where the unit is the chapter:
-\begin{verbatim}
-\documentclass{report}
-\usepackage{glossaries-extra}
-
-\GlsXtrEnableEntryUnitCounting{abbreviation}{2}{chapter}
-
-\makeglossaries
-
-\newabbreviation{html}{HTML}{hypertext markup language}
-\newabbreviation{css}{CSS}{cascading style sheet}
-
-\newglossaryentry{sample}{name={sample},description={sample}}
+The separator used between a sub-level parent and child entry is
+given by:
+\cmddef{glsxtrbookindexparentsubchildsep}
+This defaults to \gls{glsxtrbookindexparentchildsep}.
-\begin{document}
-\chapter{Sample}
+The separator between top-level entries is given by:
+\cmddef{glsxtrbookindexbetween}
+This comes after the entry given by \meta{entry1-label}, if the entry
+has no children, or after the last descendent otherwise,
+so it always comes immediately before the entry given
+by \meta{entry2-label} unless the entry occurs at the start of
+a group. This does nothing by default.
-Used once: \gls{html}.
+The separator between two level~1 entries is given by:
+\cmddef{glsxtrbookindexsubbetween}
-Used three times: \gls{css} and \gls{css} and \gls{css}.
+The separator between two level~2 entries is given by:
+\cmddef{glsxtrbookindexsubsubbetween}
-Used once: \gls{sample}.
+At the end of each letter \idx{group}, the following hooks
+are done in order:
+\cmddef{glsxtrbookindexsubsubatendgroup}
+where \meta{entry-label} is the label of the last level~2 entry
+\cmddef{glsxtrbookindexsubatendgroup}
+where \meta{entry-label} is the label of the last level~1 entry
+\cmddef{glsxtrbookindexatendgroup}
+where \meta{entry-label} is the label of the last level~0 entry.
+
+For example, the resource option \resourceoptval{seealso}{omit}
+instructs \app{bib2gls} to omit the \gloskey{seealso} cross-reference
+from the \idx{locationlist}. (The \gloskey{see} cross-reference
+will still be added unless you also have \resourceoptval{see}{omit}.)
+The \gloskey{seealso} cross-reference can instead be appended after
+the child entries using:
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{glsxtrbookindexatendgroup}}[1]\marg{\comment{}
+ \gls{glsxtrifhasfield}\marg{\gloskey{seealso}}\marg{\#1}\comment{}
+ \marg{\gls{glstreesubitem}\gls{glsxtruseseealso}\marg{\#1}}\marg{}\comment{}
+}
+\cmd{renewcommand}\marg{\gls{glsxtrbookindexbetween}}[2]\marg{\comment{}
+ \gls{glsxtrbookindexatendgroup}\marg{\#1}\comment{}
+}%
+\codepar
+\cmd{renewcommand}\marg{\gls{glsxtrbookindexsubatendgroup}}[1]\marg{\comment{}
+ \gls{glsxtrifhasfield}\marg{\gloskey{seealso}}\marg{\#1}\comment{}
+ \marg{\gls{glstreesubsubitem}\gls{glsxtruseseealso}\marg{\#1}}\marg{}\comment{}
+}
+\codepar
+\cmd{renewcommand}\marg{\gls{glsxtrbookindexsubbetween}}[2]\marg{\comment{}
+ \gls{glsxtrbookindexsubatendgroup}\marg{\#1}\comment{}
+}
+\codepar
+\cmd{renewcommand}\marg{\gls{glsxtrbookindexsubsubatendgroup}}[1]\marg{\comment{}
+ \gls{glsxtrifhasfield}\marg{\gloskey{seealso}}\marg{\#1}\comment{}
+ \marg{\gls{glstreeitem}\cmd{hspace}*\marg{40pt}\gls{glsxtruseseealso}\marg{\#1}}\marg{}\comment{}
+}
+\codepar
+\cmd{renewcommand}\marg{\gls{glsxtrbookindexsubsubbetween}}[2]\marg{\comment{}
+ \gls{glsxtrbookindexsubsubatendgroup}\marg{\#1}\comment{}
+}
+\end{codebox}
+This uses \gls{glstreesubitem} and \gls{glstreesubsubitem}
+to indent the cross-reference according to the next level down,
+so the cross-reference for a top-level entry is aligned with
+the sub-entries, and a level~1 entry has its cross-reference
+aligned with sub-sub-entries. In the event that a level~2
+entry has a cross-reference, this is indented a bit further
+(but it won't be aligned with any deeper level as the
+\glostyle{bookindex} style only supports a maximum of two
+sub-levels).
-\chapter{Another Sample}
+The \glostyle{bookindex} style uses group headings. (If you
+use \app{bib2gls} remember to invoke it with the \switch{group}
+or \switch{g} switch, see \sectionref{sec:printunsrtgroups}.) The heading will use:
+\cmddef{glsxtrbookindexbookmark}
+If \gls{pdfbookmark} has been defined, this will
+use that command to bookmark the group title. If
+\optval{section}{chapter} is set (default if chapters are defined)
+then this uses level~1 otherwise it uses level~2. You can
+redefine this command if this isn't appropriate.
+If \gls{pdfbookmark} hasn't been defined, this command does nothing.
-Used once: \gls{css}.
+The group heading is formatted according to:
+\cmddef{glsxtrbookindexformatheader}
+which is defined as:
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glsxtrbookindexformatheader}}[1]\marg{\comment{}
+ \cmd{par}\marg{\cmd{centering}\gls{glstreegroupheaderfmt}\marg{\#1}\cmd{par}}\comment{}
+}
+\end{codebox}
+where \gls{glstreegroupheaderfmt} is provided by the
+\sty{glossary-tree} package, which is automatically loaded.
+Note that the entry names aren't encapsulated with
+\gls{glstreenamefmt}.
-Used twice: \gls{html} and \gls{html}.
+The skip after a \idx{group} header is given by:
+\cmddef{glsxtrbookindexpregroupskip}
+The argument is the skip that would normally be inserted if there
+wasn't a group header.
-\printglossaries
-\end{document}
-\end{verbatim}
-In this document, the \texttt{css} entry is used three times in the
-first chapter. This is more than the trigger value of 2, so
-\verb|\gls{css}| is expanded on \gls{firstuse} with the short
-form used on subsequent use, and the \texttt{css} entries in
-that chapter are added to the glossary. In the second chapter,
-the \texttt{css} entry is only used once, which trips the
-suppression trigger, so in that chapter, the long form
-is used and \verb|\gls{css}| doesn't get a line added to
-the glossary file.
+The \sty{glossary-bookindex} package provides some supplementary
+commands that aren't used by default, but may be used when
+adjusting the style. These commands should only be
+used within one of the \csfmt{print\ldots glossary} commands.
+(That is, they should only be used in \idxpl{glossarystyle} or in
+hooks.)
+\cmddef{glsxtrbookindexmarkentry}
+This writes information to the \ext{aux} file that
+can be read on the next run to obtain the first and last entry on
+each page of the glossary.
-The \texttt{html} is used a total of three times, but the
-expansion and indexing suppression trigger is tripped
-in both chapters because the per-unit total (1 for the first
-chapter and 2 for the second chapter) is less than or equal
-to the trigger value.
+You can display the first entry associated with the current page using:
+\cmddef{glsxtrbookindexfirstmark}
+and the last entry associated with the current page using:
+\cmddef{glsxtrbookindexlastmark}
+These do nothing if there are no entries marked on the current page
+(or if the document build isn't up to date).
-The \texttt{sample} entry has only been used once, but it doesn't
-trip the indexing suppression because it's in the \category{general}
-category, which hasn't been listed in
-\cs{GlsXtrEnableEntryUnitCounting}.
+The entry is formatted using:
+\cmddef{glsxtrbookindexfirstmarkfmt}
+for the first instance and
+\cmddef{glsxtrbookindexlastmarkfmt}
+for the last.
-The per-unit entry counting can be used for other purposes.
-In the following example document the trigger value is set
-to zero, which means the index suppression won't be triggered,
-but the unit entry count is used to automatically suppress the
-hyperlink for commands like \ics{gls} by modifying the
-hook
-\begin{definition}[\DescribeMacro\glslinkcheckfirsthyperhook]
-\cs{glslinkcheckfirsthyperhook}
-\end{definition}
-which is used at the end of the macro the determines whether
-or not to suppress the hyperlink.
+These commands are designed for use in page headers or footers
+where the page number is stable. For example, \gls{glsxtrbookindexname}
+can be redefined to mark the current entry:
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{glsxtrbookindexname}}[1]\marg{\comment{}
+ \gls{glsxtrbookindexmarkentry}\marg{\#1}\comment{}
+ \gls{glossentryname}\marg{\#1}\comment{}
+}
+\end{codebox}
+If you only want to mark the top-level entries, remember
+to redefine \gls{glsxtrbookindexsubname} as it defaults
+to \gls{glsxtrbookindexname}:
+\begin{codebox}
+\gls{renewcommand}\marg{\gls{glsxtrbookindexsubname}}[1]\marg{\comment{}
+ \gls{glossentryname}\marg{\#1}\comment{}
+}
+\end{codebox}
-\begin{verbatim}
-\documentclass{article}
+Then if you're using \sty{fancyhdr} you can set the page style
+to show the first and last entry for the current page with:
+\begin{codebox}
+\cmd{pagestyle}\marg{fancy}\comment{}
+\cmd{lhead}\marg{\gls{thepage}}\comment{}
+\cmd{lfoot}\marg{\gls{glsxtrbookindexfirstmark}}\comment{}
+\cmd{cfoot}\marg{}\comment{}
+\cmd{rfoot}\marg{\gls{glsxtrbookindexlastmark}}\comment{}
+\end{codebox}
+\glsaddeach[format=)]{opt.glostyle.bookindex,pkg.glossary-bookindex}%
+
+\subsection{\stytext{glossary-longextra} package}
+\label{sec:longextra}
-\usepackage[colorlinks]{hyperref}
-\usepackage{glossaries-extra}
+\glsadd[format=(]{pkg.glossary-longextra}%
+The \inlineglsdef{pkg.glossary-longextra} package provides additional
+\env{tabular}-like styles similar to those provided by
+\sty{glossary-longbooktabs} (which is automatically loaded). These don't support
+\idxpl{hierarchicallevel} except for homographs (level~1 entries
+with the same name as their parent).
-\makeglossaries
+By default, these styles use the
+\env{longtable} environment, but if you know that your \idx{glossary} won't
+span more than a page and you need to use it in a context that's
+incompatible with \env{longtable}, you can instead setup these styles
+to use \env{tabular} instead. In order to do this you must use:
+\cmddef{GlsLongExtraUseTabulartrue}
+\emph{before the style is set}. If you later want to switch back to
+using \env{longtable} for another \idx{glossary}, use:
+\cmddef{GlsLongExtraUseTabularfalse}
+(or scope \gls{GlsLongExtraUseTabulartrue}). Again, the style must
+be set after this change to the conditional is implemented. You can
+test this setting with:
+\cmddef{ifGlsLongExtraUseTabular}
-\GlsXtrEnableEntryUnitCounting{general}{0}{page}
+For example:
+\begin{codebox}
+\gls{GlsLongExtraUseTabulartrue}
+\gls{setglossarystyle}\marg{\glostyle{long-name-desc}}
+\end{codebox}
+or
+\begin{codebox}
+\gls{GlsLongExtraUseTabulartrue}
+\gls{printunsrtglossary}\oarg{\printglossoptval{style}{\glostyle{long-name-desc}}}
+\end{codebox}
+If you switch to \env{tabular}, the default vertical
+alignment is obtained from:
+\cmddef{glslongextraTabularVAlign}
+This should expand to one of: \code{c} (centred), \code{t} (top) or
+\code{b} (bottom). The default is \code{c}.
+
+For either \env{tabular} or \env{longtable}, the column titles are
+formatted according to:
+\cmddef{glslongextraHeaderFmt}
+which simply does \code{\cmd{textbf}\margm{text}} by default.
+As with the \glostyle{long}-like styles, the header text for the
+columns are given by the language-sensitive commands:
+\gls{entryname}, \gls{descriptionname}, \gls{symbolname} and
+\gls{pagelistname}.
+
+Most styles show the \gloskey{name} which, as with other predefined
+styles, also includes the entry item number (if \opt{entrycounter} is
+on) and hypertarget anchor. These are all performed for top-level
+entries with:
+\cmddef{glslongextraNameFmt}
+This uses \gls{glossentryname}, so it supports the
+\idx{postnamehook} and associated attributes. Child entries are
+displayed with:
+\cmddef{glslongextraSubNameFmt}
+This includes the sub-entry item number (if \opt{subentrycounter} is
+on) and the hypertarget anchor. The actual name isn't shown by
+default.
-\newglossaryentry{sample}{name={sample},description={an example}}
+The horizontal alignment for the name column is obtained with:
+\cmddef{glslongextraNameAlign}
+This expands to \code{l} by default.
-\renewcommand*{\glslinkcheckfirsthyperhook}{%
- \ifnum\glsentrycurrcount\glslabel>0
- \setkeys{glslink}{hyper=false}%
- \fi
+For styles that show the \gloskey{description}, that's formatted
+with:
+\cmddef{glslongextraDescFmt}
+for top-level entries, which uses \gls{glossentrydesc} and the
+\idx{postdeschook}, and
+\cmddef{glslongextraSubDescFmt}
+for child entries (which just uses \gls{glslongextraDescFmt}).
+
+The horizontal alignment for the description column is obtained with:
+\cmddef{glslongextraDescAlign}
+This expands to
+\code{>\marg{\cmd{raggedright}}p\marg{\gls{glsdescwidth}}} by default.
+This means ragged-right paragraph style with width given by
+\gls{glsdescwidth}.
+(See the documentation for the \sty{array} package for information
+about this alignment syntax.) If a widest name has been set,
+\gls{glsdescwidth} will be calculated according to the best fit for
+the given style.
+
+If you are using \app{bib2gls}, you may be able to use the
+\resourceopt{set-widest} option, otherwise to set the widest name, use:
+\cmddef{glslongextraSetWidest}
+If you have already used \gls{glssetwidest} provided with the \glostyle{alttree}
+style, the default widest name will be obtained from that, but note
+that only level~0 is supported for the \sty{glossary-longextra}
+styles.
+
+You can update the widest name with:
+\cmddef{glslongextraUpdateWidest}
+This is like \gls{glslongextraSetWidest} but will only set the new
+value if it's wider than the current widest name.
+
+Although these styles don't support hierarchy, the following is
+provided for child entries:
+\cmddef{glslongextraUpdateWidestChild}
+This does nothing by default. If \gls{glslongextraSubNameFmt} is
+redefined to show the child name, then the above command will need
+to be redefined to use \gls{glslongextraUpdateWidest}.
+
+For styles that show the \idx{locationlist}, that's formatted
+with:
+\cmddef{glslongextraLocationFmt}
+for top-level entries. Child \idxpl{locationlist} are formatted
+with:
+\cmddef{glslongextraSubLocationFmt}
+Both of these simply do the \meta{location list} argument.
+
+The horizontal alignment for the \idx{locationlist} column is obtained with:
+\cmddef{glslongextraLocationAlign}
+This expands to
+\code{>\marg{\cmd{raggedright}}p\marg{\gls{glspagelistwidth}}} by default.
+This means ragged-right paragraph style with width given by
+\gls{glspagelistwidth}.
+
+For styles that show the \gloskey{symbol} (in addition to the
+\gloskey{name}), that's formatted with:
+\cmddef{glslongextraSymbolFmt}
+for top-level entries. This simply uses \gls{glossentrysymbol}.
+Child entries use:
+\cmddef{glslongextraSubSymbolFmt}
+which uses \gls{glslongextraSymbolFmt}.
+
+The horizontal alignment for the symbol column (except for the
+\glostyle{long-sym-desc} and \glostyle{long-desc-sym} styles) is obtained with:
+\cmddef{glslongextraSymbolAlign}
+This expands to \code{c} by default.
+
+Top-level \idx{group} headings are formatted with:
+\cmddef{glslongextraGroupHeading}
+The first argument is the total number of columns in the table. For
+example, 2 for the \glostyle{long-name-desc} style or 3 for the
+\glostyle{long-name-sym-desc} style. The second argument is the
+\idx{group}['s] label (not the title). This command does nothing by
+default. (If you are using \app{bib2gls}, remember that you need to
+use the \switch{group} or \switch{g} switch to support
+\idxpl{group}.)
+
+Sub-level \idxpl{group} are only supported with the \idx{unsrtfam}
+(see \sectionref{sec:printunsrtgroups}). When they are supported,
+the heading will be formatted with:
+\cmddef{glslongextraSubGroupHeading}
+
+The styles are sub-divided below into the set of elements that are shown in each
+column, which may consist of: \gloskey{name}, \gloskey{symbol},
+\gloskey{description} or \idx{locationlist}. There will be
+blank cells if any of the corresponding fields have not been set or
+if the \idx{locationlist} has been suppressed.
+
+\subsubsection{Name and Description Only}
+\label{sec:longextranamedesc}
+
+These styles don't display the symbol or \idx{locationlist},
+regardless of whether or not they have been set. In each case, the
+style starts with:
+\cmddef{glslongextraSetDescWidth}
+which updates \gls{glsdescwidth} according to the widest name,
+identified with \gls{glslongextraSetWidest}. The column header
+text is also taken into account. If a widest name hasn't been set
+and the column header is shorter than one or more names, the
+description column may be too wide.
+The value of \gls{glsdescwidth} is calculated as
+$\gls{linewidth}-4\gls{tabcolsep}-W$, where $W$ is the width of
+the widest name.
+
+If you want to set \gls{glsdescwidth} to a specific value, then redefine
+\gls{glslongextraSetDescWidth} with the desired length assignment.
+
+\optiondef{glostyle.long-name-desc}
+This has two columns: the name on the left and the description on
+the right.
+The table header is given by:
+\cmddef{glslongextraNameDescTabularHeader}
+which shows the column headers with horizontal rules.
+The table footer is given by:
+\cmddef{glslongextraNameDescTabularFooter}
+which just does a horizontal rule.
+With \env{longtable}, the table header and footer are set with:
+\cmddef{glslongextraNameDescHeader}
+which uses the above header and footer commands.
+
+\optiondef{glostyle.long-desc-name}
+This has two columns: the name on the right and the description on
+the left.
+The table header is given by:
+\cmddef{glslongextraDescNameTabularHeader}
+which shows the column headers with horizontal rules.
+The table footer is given by:
+\cmddef{glslongextraDescNameTabularFooter}
+which just does a horizontal rule.
+With \env{longtable}, the table header and footer are set with:
+\cmddef{glslongextraDescNameHeader}
+which uses the above header and footer commands.
+
+\subsubsection{Name, Symbol and Description Only}
+\label{sec:longextranamesymdesc}
+
+These styles don't show the \idx{locationlist}. In each case, the
+style starts with:
+\cmddef{glslongextraSymSetDescWidth}
+which updates \gls{glsdescwidth} according to the widest name,
+identified with \gls{glslongextraSetWidest}. This starts by
+calculating \gls{glsdescwidth} with \gls{glslongextraSetDescWidth}
+and then subtracts the width of the symbol column header text (which
+is assumed to be the widest text in that column).
+
+If you want to set \gls{glsdescwidth} to a specific value, then redefine
+\gls{glslongextraSymSetDescWidth} with the desired length assignment.
+
+\optiondef{glostyle.long-name-desc-sym}
+This has three columns: the name on the left, the description in the
+middle and the symbol on the right.
+The table header is given by:
+\cmddef{glslongextraNameDescSymTabularHeader}
+which shows the column headers with horizontal rules.
+The table footer is given by:
+\cmddef{glslongextraNameDescSymTabularFooter}
+which just does a horizontal rule.
+With \env{longtable}, the table header and footer are set with:
+\cmddef{glslongextraNameDescSymHeader}
+which uses the above header and footer commands.
+
+\optiondef{glostyle.long-name-sym-desc}
+This has three columns: the name on the left, the symbol in the
+middle and the description on the right.
+The table header is given by:
+\cmddef{glslongextraNameSymDescTabularHeader}
+which shows the column headers with horizontal rules.
+The table footer is given by:
+\cmddef{glslongextraNameSymDescTabularFooter}
+which just does a horizontal rule.
+With \env{longtable}, the table header and footer are set with:
+\cmddef{glslongextraNameSymDescHeader}
+which uses the above header and footer commands.
+
+\optiondef{glostyle.long-sym-desc-name}
+This has three columns: the name on the right, the description in the
+middle and the symbol on the left.
+The table header is given by:
+\cmddef{glslongextraSymDescNameTabularHeader}
+which shows the column headers with horizontal rules.
+The table footer is given by:
+\cmddef{glslongextraSymDescNameTabularFooter}
+which just does a horizontal rule.
+With \env{longtable}, the table header and footer are set with:
+\cmddef{glslongextraSymDescNameHeader}
+which uses the above header and footer commands.
+
+\optiondef{glostyle.long-desc-sym-name}
+This has three columns: the name on the right, the symbol in the
+middle and the description on the left.
+The table header is given by:
+\cmddef{glslongextraDescSymNameTabularHeader}
+which shows the column headers with horizontal rules.
+The table footer is given by:
+\cmddef{glslongextraDescSymNameTabularFooter}
+which just does a horizontal rule.
+With \env{longtable}, the table header and footer are set with:
+\cmddef{glslongextraDescSymNameHeader}
+which uses the above header and footer commands.
+
+\subsubsection{Name, Description and Location Only}
+\label{sec:longextranamedescloc}
+
+These styles don't display the symbol, regardless of whether or not
+the \gloskey{symbol} field has been set. In each case, the
+style starts with:
+\cmddef{glslongextraLocSetDescWidth}
+which updates \gls{glsdescwidth} according to the widest name,
+identified with \gls{glslongextraSetWidest}. This starts by
+calculating \gls{glsdescwidth} with \gls{glslongextraSetDescWidth}
+and then subtracts $2\gls{tabcolsep}-\gls{glspagelistwidth}$.
+
+If you want to set \gls{glsdescwidth} to a specific value, then redefine
+\gls{glslongextraLocSetDescWidth} with the desired length assignment.
+
+
+\optiondef{glostyle.long-name-desc-loc}
+This has three columns: the name on the left, the description in the
+middle and the \idx{locationlist} on the right.
+The table header is given by:
+\cmddef{glslongextraNameDescLocationTabularHeader}
+which shows the column headers with horizontal rules.
+The table footer is given by:
+\cmddef{glslongextraNameDescLocationTabularFooter}
+which just does a horizontal rule.
+With \env{longtable}, the table header and footer are set with:
+\cmddef{glslongextraNameDescLocationHeader}
+which uses the above header and footer commands.
+
+\optiondef{glostyle.long-loc-desc-name}
+This has three columns: the name on the right, the description in the
+middle and the \idx{locationlist} on the left.
+The table header is given by:
+\cmddef{glslongextraLocationDescNameTabularHeader}
+which shows the column headers with horizontal rules.
+The table footer is given by:
+\cmddef{glslongextraLocationDescNameTabularFooter}
+which just does a horizontal rule.
+With \env{longtable}, the table header and footer are set with:
+\cmddef{glslongextraLocationDescNameHeader}
+which uses the above header and footer commands.
+
+\subsubsection{Name, Description, Symbol and Location}
+\label{sec:longextranamedescsymloc}
+
+These styles show the name, description, symbol and
+\idx{locationlist}. In each case, the
+style starts with:
+\cmddef{glslongextraSymLocSetDescWidth}
+which updates \gls{glsdescwidth} according to the widest name,
+identified with \gls{glslongextraSetWidest}. This starts by
+calculating \gls{glsdescwidth} with \gls{glslongextraSymSetDescWidth}
+and then subtracts $2\gls{tabcolsep}-\gls{glspagelistwidth}$.
+
+If you want to set \gls{glsdescwidth} to a specific value, then redefine
+\gls{glslongextraSymLocSetDescWidth} with the desired length assignment.
+
+
+\optiondef{glostyle.long-name-desc-sym-loc}
+This has four columns, from left to right: the name, description,
+symbol and the \idx{locationlist}.
+The table header is given by:
+\cmddef{glslongextraNameDescSymLocationTabularHeader}
+which shows the column headers with horizontal rules.
+The table footer is given by:
+\cmddef{glslongextraNameDescSymLocationTabularFooter}
+which just does a horizontal rule.
+With \env{longtable}, the table header and footer are set with:
+\cmddef{glslongextraNameDescSymLocationHeader}
+which uses the above header and footer commands.
+
+\optiondef{glostyle.long-name-sym-desc-loc}
+This has four columns, from left to right: the name,
+symbol, description and the \idx{locationlist}.
+The table header is given by:
+\cmddef{glslongextraNameSymDescLocationTabularHeader}
+which shows the column headers with horizontal rules.
+The table footer is given by:
+\cmddef{glslongextraNameSymDescLocationTabularFooter}
+which just does a horizontal rule.
+With \env{longtable}, the table header and footer are set with:
+\cmddef{glslongextraNameSymDescLocationHeader}
+which uses the above header and footer commands.
+
+\optiondef{glostyle.long-loc-sym-desc-name}
+This has four columns, from left to right: the \idx{locationlist},
+symbol, description and the name.
+The table header is given by:
+\cmddef{glslongextraLocationSymDescNameTabularHeader}
+which shows the column headers with horizontal rules.
+The table footer is given by:
+\cmddef{glslongextraLocationSymDescNameTabularFooter}
+which just does a horizontal rule.
+With \env{longtable}, the table header and footer are set with:
+\cmddef{glslongextraLocationSymDescNameHeader}
+which uses the above header and footer commands.
+
+\optiondef{glostyle.long-loc-desc-sym-name}
+This has four columns, from left to right: the \idx{locationlist},
+description, symbol and the name.
+The table header is given by:
+\cmddef{glslongextraLocationDescSymNameTabularHeader}
+which shows the column headers with horizontal rules.
+The table footer is given by:
+\cmddef{glslongextraLocationDescSymNameTabularFooter}
+which just does a horizontal rule.
+With \env{longtable}, the table header and footer are set with:
+\cmddef{glslongextraLocationDescSymNameHeader}
+which uses the above header and footer commands.
+
+\subsubsection{Symbol and Description Only}
+\label{sec:longextrasymdesc}
+
+These are two-column styles designed to show only the symbol and
+description. However, if the \gloskey{symbol} isn't set then the
+name will be used instead. If this occurs, you may need to change
+the width of the description column.
+
+The horizontal alignment for the symbol column is obtained with:
+\cmddef{glslongextraSymbolNameAlign}
+which expands to \code{l} by default. Note that this is different
+from the alignment used for styles like
+\glostyle{long-name-sym-desc}.
+
+These styles have the entry item number (if \opt{entrycounter} is
+on) and the hypertarget anchor (if enabled) in the symbol column
+since there's no name shown (unless the symbol is missing).
+These are all performed by for
+top-level entries by:
+\cmddef{glslongextraSymbolTargetFmt}
+The symbol is formatted according to \gls{glslongextraSymbolFmt}.
+Child entries use:
+\cmddef{glslongextraSubSymbolTargetFmt}
+Unlike \gls{glslongextraSubNameFmt} this shows the field value
+(formatted with \gls{glslongextraSymbolFmt}).
+
+The following commands use the above if the \gloskey{symbol} field
+is set, otherwise they show the name.
+
+\cmddef{glslongextraSymbolOrName}
+Shows the symbol, if set, or the name otherwise, with the target.
+Child entries use:
+\cmddef{glslongextraSubSymbolOrName}
+Shows the symbol with \gls{glslongextraSubSymbolTargetFmt}, if set,
+or the name otherwise, with the target.
+
+In each case, the style starts with:
+\cmddef{glslongextraSymNoNameSetDescWidth}
+which calculates \gls{glsdescwidth} as
+$\gls{linewidth}-4\gls{tabcolsep}-W$, where $W$ is the
+width of the symbol column header. Note that this assumes the
+content of the symbol column isn't wider than the column header.
+
+If you want to set \gls{glsdescwidth} to a specific value, then redefine
+\gls{glslongextraSymNoNameSetDescWidth} with the desired length assignment.
+
+
+\optiondef{glostyle.long-sym-desc}
+The symbol is in the left column (or the name, if the symbol isn't
+set). The description is in the right.
+The \idx{locationlist} isn't shown.
+The table header is given by:
+\cmddef{glslongextraSymDescTabularHeader}
+which shows the column headers with horizontal rules.
+The table footer is given by:
+\cmddef{glslongextraSymDescTabularFooter}
+which just does a horizontal rule.
+With \env{longtable}, the table header and footer are set with:
+\cmddef{glslongextraSymDescHeader}
+which uses the above header and footer commands.
+
+\optiondef{glostyle.long-desc-sym}
+The symbol is in the right column (or the name, if the symbol isn't
+set). The description is in the left.
+The \idx{locationlist} isn't shown.
+The table header is given by:
+\cmddef{glslongextraDescSymTabularHeader}
+which shows the column headers with horizontal rules.
+The table footer is given by:
+\cmddef{glslongextraDescSymTabularFooter}
+which just does a horizontal rule.
+With \env{longtable}, the table header and footer are set with:
+\cmddef{glslongextraDescSymHeader}
+which uses the above header and footer commands.
+
+\subsubsection{Abbreviations Only}
+\label{sec:longextraabbr}
+
+These styles are designed for abbreviations. They display the short
+and long forms, rather than the name and description, although these
+may happen to match. They are primarily intended for
+\idxpl{mini-glossary} or similar summary lists.
+
+Although these styles don't show the name or description, they still
+use some of the name and description settings provided by
+\sty{glossary-longextra}.
+The column for the short form uses the same alignment as for the
+name columns (\gls{glslongextraNameAlign}). The column for the
+long form uses the same alignment as for the description columns
+(\gls{glslongextraDescAlign}) and has the width set to \gls{glsdescwidth}.
+However, the name and description formatting commands or attributes
+(such as \gls{glsnamefont}, \catattr{glossnamefont} or
+\catattr{glossname}) aren't used as the formatting is left to the
+abbreviation style.
+
+If the \gloskey{short} field hasn't been set, the short column will
+show the name instead, and if the \gloskey{long} field hasn't been
+set, the long column will show the description instead (using the
+same commands as for styles like \glostyle{long-name-desc}, which do
+use the associated formatting commands and attributes).
+
+These styles use the following commands:
+\cmddef{glslongextraShortHeader}
+The header for the column showing the short form. This is defined as:
+\begin{compactcodebox}
+\cmd{newcommand}\marg{\gls{glslongextraShortHeader}}\marg{\gls{entryname}}
+\end{compactcodebox}
+
+\cmddef{glslongextraLongHeader}
+The header for the column showing the long form. This is defined as:
+\begin{compactcodebox}
+\cmd{newcommand}\marg{\gls{glslongextraLongHeader}}\marg{\gls{descriptionname}}
+\end{compactcodebox}
+
+\cmddef{glslongextraShortTargetFmt}
+This governs the way that the short form should be displayed,
+including the target. This is defined as:
+\begin{compactcodebox}
+\cmd{newcommand}\marg{\gls{glslongextraShortTargetFmt}}[1]\marg{\comment{}
+ \gls{glsentryitem}\marg{\#1}\gls{glstarget}\marg{\#1}\marg{\marg{\gls{glsxtrshort}\oarg{\glsopt{noindex},\glsoptval{hyper}{false}}\marg{\#1}}}\comment{}
+ \gls{glsxtrpostnamehook}\marg{\#1}%
+}
+\end{compactcodebox}
+Note that the \idx{postnamehook} is included.
+
+\cmddef{glslongextraLongFmt}
+This governs the way that the long form should be displayed. This is defined as:
+\begin{compactcodebox}
+\cmd{newcommand}\marg{\gls{glslongextraLongFmt}}[1]\marg{\comment{}
+ \marg{\gls{glsxtrlong}\oarg{\glsopt{noindex},\glsopt{hyper}{false}}\marg{\#1}}\gls{glspostdescription}
+}
+\end{compactcodebox}
+Note that the \idx{postdeschook} is included.
+
+\cmddef{glslongextraSubShortTargetFmt}
+This governs the way that the short form for child entries should be
+displayed, including the target. This is defined as:
+\begin{compactcodebox}
+\cmd{newcommand}\marg{\gls{glslongextraSubShortTargetFmt}}[2]\marg{\comment{}
+ \gls{glssubentryitem}\marg{\#2}\gls{glstarget}\marg{\#2}\marg{\marg{\gls{glsxtrshort}\oarg{\glsopt{noindex},\glsoptval{hyper}{false}}\marg{\#2}}}\comment{}
+ \gls{glsxtrpostnamehook}\marg{\#2}%
}
+\end{compactcodebox}
+
+\cmddef{glslongextraSubLongFmt}
+This governs the way that the long form for child entries should be
+displayed. This is defined as:
+\begin{compactcodebox}
+\cmd{newcommand}\marg{\gls{glslongextraSubLongFmt}}[2]\marg{\gls{glslongextraLongFmt}\marg{\#2}}
+\end{compactcodebox}
+
+\cmddef{glslongextraShortNoNameSetDescWidth}
+This is used to compute the value of \gls{glsdescwidth} and assumes
+that none of the short forms are wider than
+\gls{glslongextraShortHeader}.
+
+\optiondef{glostyle.abbr-short-long}
+A two column style.
+The short form is in the left column. The long form is in the right.
+The \idx{locationlist} isn't shown.
+
+The table header is given by:
+\cmddef{glslongextraShortLongTabularHeader}
+which shows the column headers with horizontal rules.
+
+The table footer is given by:
+\cmddef{glslongextraShortLongTabularFooter}
+which just does a horizontal rule.
+With \env{longtable}, the table header and footer are set with:
+\cmddef{glslongextraShortLongHeader}
+which uses the above header and footer commands.
+
+\optiondef{glostyle.abbr-long-short}
+A two column style.
+The short form is in the right column. The long form is in the left.
+The \idx{locationlist} isn't shown.
+
+The table header is given by:
+\cmddef{glslongextraLongShortTabularHeader}
+which shows the column headers with horizontal rules.
+
+The table footer is given by:
+\cmddef{glslongextraLongShortTabularFooter}
+which just does a horizontal rule.
+With \env{longtable}, the table header and footer are set with:
+\cmddef{glslongextraLongShortHeader}
+which uses the above header and footer commands.
+
+\glsadd[format=)]{pkg.glossary-longextra}%
+
+\subsection{\stytext{glossary-topic} package}
+\label{sec:topic}
-\begin{document}
+\glsadd[format=(]{pkg.glossary-topic}%
+The \inlineglsdef{pkg.glossary-topic} package provides glossary
+styles designed for hierarchical \idxpl{glossary} where the top-level
+entries are topic titles. This package automatically loads the
+\sty{multicol} package. If the \sty{glossary-tree} package is also
+loaded then commands like \gls{glssetwidest} can be used on these
+styles in much the same way as for the \glostyle{alttree} style. If
+a widest value isn't set then these styles behave more like the
+\glostyle{tree} style.
+
+This package provides styles designed for \idxpl{glossary} that are lists
+of topics. That is, the top-level entries are considered topic
+titles (which may or may not have an associated symbol or
+description) and the sub-entries are items within that topic. By
+default the \idx{locationlist} isn't shown for the top-level entries but is
+shown after the description for sub-entries (unless suppressed with
+\opt{nonumberlist} or \resourceoptval{save-locations}{false}).
+
+The following styles are provided:
+\optiondef*{glostyle.topic}
+This style is similar to the \glostyle{tree}
+style but the indentation doesn't start until the second
+sub-item level. The top-level entries have the name displayed
+in a larger font with the description following in a new paragraph
+(see \exampleref{ex:topicstyle}).
+This style doesn't support the \opt{nogroupskip} setting.
+
+\newcommand{\topicexampledefs}{%
+\gls{newglossaryentry}\marg{pictograph}\marg{\gloskeyval{name}{pictograph},^^J
+ \gloskeyval{description}{picture or symbol representing a word or
+phrase}}^^J%
+\gls{newglossaryentry}\marg{copy}\marg{\gloskeyval{parent}{pictograph},^^J
+ \gloskeyval{name}{\cmd{faCopy}},^^J
+ \gloskeyval{description}{copy}}^^J%
+\gls{newglossaryentry}\marg{cut}\marg{\gloskeyval{parent}{pictograph},^^J
+ \gloskeyval{name}{\cmd{faCut}},^^J
+ \gloskeyval{description}{cut}}^^J%
+\gls{newglossaryentry}{edit}\marg{\gloskeyval{parent}{pictograph},^^J
+\gloskeyval{name}{\cmd{faEdit}},
+ \gloskeyval{description}{edit}}
+\gls{newglossaryentry}{paste}\marg{\gloskeyval{parent}{pictograph},^^J
+\gloskeyval{name}{\cmd{faPaste}},
+ \gloskeyval{description}{paste}}
+\codepar
+\gls{newglossaryentry}\marg{symbols}\marg{\gloskeyval{name}{Symbols},^^J
+ \gloskeyval{description}{mathematical constants or functions}}^^J%
+\gls{newglossaryentry}\marg{constant}\marg{\gloskeyval{parent}{symbols},^^J
+ \gloskeyval{name}{constant},^^J
+ \gloskeyval{description}{a fixed quantity or numerical value}}^^J%
+\gls{newglossaryentry}\marg{pi}\marg{\gloskeyval{parent}{constant},^^J
+ \gloskeyval{name}{\cmd{ensuremath}\marg{\cmd{pi}}},^^J
+ \gloskeyval{description}{ratio of the length of the circumference
+ of a circle to its diameter}}^^J%
+\gls{newglossaryentry}\marg{root2}\marg{\gloskeyval{parent}{constant},^^J
+ \gloskeyval{name}{\cmd{ensuremath}\marg{\cmd{surd}2}},^^J
+ \gloskeyval{description}{Pythagoras' constant}}^^J%
+\gls{newglossaryentry}\marg{function}\marg{\gloskeyval{parent}{symbols},^^J
+ \gloskeyval{name}{function},^^J
+ \gloskeyval{description}{a rule that assigns a value to every
+element of the domain}}^^J%
+\gls{newglossaryentry}\marg{cosx}\marg{\gloskeyval{parent}{function},^^J
+ \gloskeyval{name}{\cmd{ensuremath}\marg{\cmd{cos}(x)}},^^J
+ \gloskeyval{description}{cosine}}^^J%
+\gls{newglossaryentry}\marg{lnx}\marg{\gloskeyval{parent}{function},^^J
+ \gloskeyval{name}{\cmd{ensuremath}\marg{\cmd{ln}(x)}},^^J
+ \gloskeyval{description}{natural logarithm}}^^J%
+\gls{newglossaryentry}\marg{parameter}\marg{\gloskeyval{parent}{symbols},^^J
+ \gloskeyval{name}{parameter},^^J
+ \gloskeyval{description}{a constant or variable that distinguishes
+a specific form}}^^J%
+\gls{newglossaryentry}\marg{x}\marg{\gloskeyval{parent}{parameter},^^J
+ \gloskeyval{name}{\cmd{ensuremath}\marg{x}},^^J
+ \gloskeyval{description}{the abscissa value}}^^J%
+\gls{newglossaryentry}\marg{y}\marg{\gloskeyval{parent}{parameter},^^J
+ \gloskeyval{name}{\cmd{ensuremath}\marg{y}},^^J
+ \gloskeyval{description}{the ordinate value}}
+\gls{newglossaryentry}\marg{z}\marg{\gloskeyval{parent}{parameter},^^J
+ \gloskeyval{name}{\cmd{ensuremath}\marg{z}},^^J
+ \gloskeyval{description}{the applicate value}}
+}
+\begin{resultbox}[float]
+\createexample*[label={ex:topicstyle},
+ title={The \optfmt{topic} style},
+ description={Example document demonstrating the topic style}]
+{%
+\cmd{usepackage}\marg{fontawesome}^^J%
+\cmd{usepackage}\oarg{\opt{postdot},\optval{stylemods}{topic},\optval{style}{\glostyle{topic}}}\marg{glossaries-extra}^^J%
+\topicexampledefs
+}
+{\gls{printunsrtglossaries}}
+\end{resultbox}
-A \gls{sample} entry.
-Next use: \gls{sample}.
+\optiondef*{glostyle.topicmcols}
+This style is like the \glostyle{topic}
+style but the sub-entries are placed inside a \env{multicols}
+environment (unlike styles such as \glostyle{mcoltree} where the
+entire glossary content is within a single \env{multicols}
+environment). The environment name is supplied in the value of
+the command:
+\cmddef{glstopicColsEnv}
+This defaults to \code{multicols}. You can change this to the
+starred form. For example:
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{glstopicColsEnv}}\marg{multicols*}
+\end{codebox}
+The number of columns is given by the command:
+\cmddef{glstopicCols}
+This expands to 2, by default. This style is demonstrated in
+\exampleref*{ex:topicmcolsstyle}.
+
+\begin{resultbox}[float]
+\createexample*[label={ex:topicmcolsstyle},
+ title={The \optfmt{topicmcols} style},
+ description={Example document demonstrating the topicmcols style}]
+{%
+\cmd{usepackage}\marg{fontawesome}^^J%
+\cmd{usepackage}\oarg{\opt{postdot},\optval{stylemods}{topic},\optval{style}{\glostyle{topicmcols}}}\marg{glossaries-extra}^^J%
+\topicexampledefs
+}
+{\gls{printunsrtglossaries}}
+\end{resultbox}
+
+
+Both styles can have a widest name set like the \glostyle{alttree}
+style, using the commands provided by \sty{glossary-tree} and
+\sty{glossaries-extra-stylemods} or with the
+\resourceopt{set-widest} resource option. If a widest name is set,
+then the sub-entry names will be placed in a box of the given width
+otherwise they won't be placed in a box. In
+\exampleref{ex:topicmcolsstylewidest}, the widest names have been
+set for level~1 and level~2 using:
+\begin{codebox}
+\gls{glssetwidest}\oarg{1}\marg{parameter}
+\gls{glssetwidest}\oarg{2}\marg{\gls{glsentryname}\marg{cosine}}
+\end{codebox}
+Note that this doesn't change the indentation at the start of the
+level~2 items to match the width of the level~1 widest name.
+
+\begin{resultbox}[float]
+\createexample*[label={ex:topicmcolsstylewidest},
+ title={The \optfmt{topicmcols} style with the widest name set},
+ description={Example document demonstrating the topicmcols style}]
+{%
+\cmd{usepackage}\marg{fontawesome}^^J%
+\cmd{usepackage}\oarg{\opt{postdot},\optval{stylemods}{topic},\optval{style}{\glostyle{topicmcols}}}\marg{glossaries-extra}^^J%
+\topicexampledefs^^J%
+\gls{glssetwidest}\oarg{1}\marg{parameter}^^J%
+\gls{glssetwidest}\oarg{2}\marg{\gls{glsentryname}\marg{cosine}}
+}
+{\gls{printunsrtglossaries}}
+\end{resultbox}
-\newpage
-Next page: \gls{sample}.
-Again: \gls{sample}.
+Both of the above styles use the following commands.
+\cmddef{glstopicParIndent}
+This command is a length that's used for the paragraph indentation
+in any multi-paragraph description for top-level entries, but not
+for the first paragraph (at the start of the description) which
+isn't indented.
-\printglossaries
+\cmddef{glstopicSubIndent}
+This command is a length that's used to calculate the hanging
+indentation for sub-entries. The level~1 sub-entries don't indent
+the name. Level~$n$ sub-entries have the name indented by
+$(n-1)\times\gls{glstopicSubIndent}$. The hanging indent depends
+on whether or not a widest name has been set for the level.
-\end{document}
-\end{verbatim}
-This only produces a hyperlink for the first instance of
-\verb|\gls{sample}| on each page.
+There is also a length for additional indentation
+used in the second paragraph onwards for child entries with
+multi-paragraph descriptions:
+\cmddef{glstopicSubItemParIndent}
+This is initialised to \gls{parindent} when \sty{glossary-topic} is
+loaded.
-The earlier warning about using the \ctr{page} counter still
-applies. If the first instance of \cs{gls} occurs at the top of the
-page within a paragraph that started on the previous page, then
-the count will continue from the previous page.
+\cmddef{glstopicInit}
+This hook is used at the start of the glossary. It does nothing by
+default.
-\section{Link Counting}
-\label{sec:linkcount}
+Although the styles don't support letter \idxpl{group} by default, if you
+have many topics (top-level entries) and you feel that it would help
+the reader to divide them up into headed letter groups, you can
+redefine:
+\cmddef{glstopicGroupHeading}
+This does nothing by default. If you want to redefine it, you can
+fetch the title corresponding to the group label with
+\gls{glsxtrgetgrouptitle}. For example:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glstopicGroupHeading}}[1]\marg{\comment{}
+ \gls{glsxtrgetgrouptitle}\marg{\#1}\marg{\cmd{thisgrptitle}}\comment{}
+ \cmd{section}*\marg{\cmd{thisgrptitle}}\comment{}
+}
+\end{codebox}
+Remember that if you are using \app{bib2gls}, you will need the
+\switch{group} or \switch{g} switch to support \idxpl{group} (see
+\sectionref{sec:printunsrtgroups}).
+
+Sub-\idxpl{group} are only
+available with \app{bib2gls} and the \resourceopt{group-level}
+option. If they are supported, sub-group headings are formatted
+according to:
+\cmddef{glstopicSubGroupHeading}
+This formats the sub-group heading. Note that unlike
+\gls{glstopicGroupHeading} this command does actually format the
+sub-group heading by default. This means that it you use
+\resourceoptval{group-level}{all}, the top-level groups won't be
+displayed, but the sub-groups will be.
+
+Top-level entries are formatted according to:
+\cmddef{glstopicItem}
+This formats the name and (if provided) the symbol. The description
+(if set) will follow in a new paragraph. At the start of
+\gls{glstopicItem}, a vertical space is added with:
+\cmddef{glstopicPreSkip}
+which defaults to \csfmt{medskip}. There is then a hook:
+\cmddef{glstopicMarker}
+which does nothing by default, but may be redefined. For example,
+to add a line to the table of contents.
+The name and symbol are set in the form of a title using:
+\cmddef{glstopicTitle}
+This uses \gls{Glossentryname} which uses \idx{sentencecase}.
+If there's a symbol, this is added in parentheses.
+Both name and symbol (if present) are encapsulated by:
+\cmddef{glstopicTitleFont}
+This uses a bold, large font by default.
-As from version 1.26, an alternative method of entry counting
-is to count the number of times the \cs{gls}-like or
-\cs{glstext}-like commands are used. (The \qt{link} in this method's
-name refers to the use of the internal command \cs{@gls@link}
-not to \cs{hyperlink} although \cs{@gls@link} may use
-\cs{hyperlink} when displaying the \gls{linktext}.)
+If the entry has the description key set (tested with
+\gls{ifglshasdesc}) then a paragraph break is inserted followed by:
+\cmddef{glstopicMidSkip}
+which defaults to \csfmt{smallskip}. This is followed by the
+description which is formatted according to:
+\cmddef{glstopicDesc}
+This just does \code{\gls{Glossentrydesc}\marg{entry-label}} followed
+by the \idx{postdeschook}.
+There is then a paragraph break followed by:
+\cmddef{glstopicPostSkip}
+regardless of whether or not the description was
+displayed. This defaults to \csfmt{smallskip}. This is then followed
+by:
+\cmddef{glstopicLoc}
+which may be used to display the \idx{locationlist}, but does nothing by
+default.
-To enable link counting use the preamble-only command:
-\begin{definition}[\DescribeMacro\GlsXtrEnableLinkCounting]
-\cs{GlsXtrEnableLinkCounting}\oarg{master counter}\marg{categories}
-\end{definition}
-where \meta{categories} is a list of category labels. The optional
-argument \meta{master counter} may be used to identify a master
-counter (which must be defined). If present, the associated
-link counter will be reset when the master counter is incremented.
-This command automatically sets the \catattr{linkcount} attribute
-for the given categories. If the optional argument is
-present, it also sets the \catattr{linkcountmaster} attribute.
+The sub-entries first set up the paragraph and hanging indentations
+using:
+\cmddef{glstopicAssignSubIndent}
+This uses:
+\cmddef{glstopicAssignWidest}
+to determine if a widest name has been set for the given level.
-When enabled, commands like \cs{gls} and \cs{glstext}
-increment the associated counter using
-\begin{definition}[\DescribeMacro\glsxtrinclinkcounter]
-\cs{glsxtrinclinkcounter}\marg{counter name}
-\end{definition}
-This just does
-\texttt{\cs{stepcounter}\marg{counter name}} by default but if you
-need \cs{refstepcounter} instead, just redefine this command:
-\begin{verbatim}
-\renewcommand*{\glsxtrinclinkcounter}[1]{\refstepcounter{#1}}
-\end{verbatim}
-
-You can access the internal count register using
-\begin{definition}[\DescribeMacro\GlsXtrLinkCounterValue]
-\cs{GlsXtrLinkCounterValue}\marg{label}
-\end{definition}
-where \meta{label} is the entry's label. This will expand
-to 0 if the counter hasn't been defined.
+The sub-entry has its information displayed using:
+\cmddef{glstopicSubItem}
+This encapsulates the name with:
+\cmddef{glstopicSubNameFont}
+By default this just uses \csfmt{textbf}. This is followed by:
+\cmddef{glstopicSubItemSep}
+which defaults to \csfmt{quad}. The name and separator are
+passed in the \meta{text} argument of:
+\cmddef{glstopicSubItemBox}
+If a widest name was set for the given level, this will
+put \meta{text} inside a box of that width otherwise it just does
+\meta{text}.
-It's also possible to access the display value
-(\cs{the}\meta{counter}) using
-\begin{definition}[\DescribeMacro\GlsXtrTheLinkCounter]
-\cs{GlsXtrTheLinkCounter}\marg{counter}
-\end{definition}
-(This will expand to 0 if the counter hasn't been defined.)
+This is followed by the symbol in parentheses if set. Then, if the
+description is set, the description and \idx{postdeschook} are
+displayed followed by:
+\cmddef{glstopicSubPreLocSep}
+(This command isn't used if the description isn't set.)
-\begin{important}
-In order to conserve resources, the counter is only defined
-when it first needs to be incremented so terms that have
-been defined but haven't been used in the document
-won't have the associated count register allocated.
-\end{important}
+Finally the location list is displayed using:
+\cmddef{glstopicSubLoc}
+which just does \meta{location} by default.
+\glsadd[format=)]{pkg.glossary-topic}%
+
+\subsection{\stytext{glossary-table} package}
+\label{sec:table}
+
+\glsadd[format=(]{pkg.glossary-table}%
+The \inlineglsdef{pkg.glossary-table} package is new to version 1.49
+and is still experimental. It automatically loads
+\sty{glossary-longbooktabs}.
+
+It doesn't provide any general purpose
+styles, but instead provides one highly customized style
+\inlineglsdef{opt.glostyle.table} designed to
+work with a supplied command:
+\cmddef{printunsrttable}
+The aim of this command is to show the glossary as a
+\env{longtable}, where the caption is what would normally be the
+glossary header (\printglossopt{title}). What's normally the
+table of contents title (\printglossopt{toctitle}) will be
+added to the list of tables instead.
+
+This internally uses \gls{printunsrtglossary} with the style set to
+\glostyle{table} and is intended for use with \app{bib2gls}.
+It supports up to 1 \idx{hierarchicallevel}, but you will need the
+\resourceopt{save-child-count} resource option if you want the
+level~1 sub-entries to show. Deeper level entries are omitted.
+If you want any additional filtering, you can redefine:
+\cmddef*{glstableiffilter}
+This command should do \meta{true} if the entry identified by
+\meta{entry-label} should be skipped, otherwise it should do
+\meta{false}. For example, the following will filter entries that
+have the category set to \cat{general}:
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{glstableiffilter}}[1]{\comment{}
+ \gls{glsifcategory}\marg{\#1}\marg{general}}
+\end{codebox}
+Note that if this command is redefined to do neither \meta{true} nor
+\meta{false} or does both, it will interfere with the width
+calculations if \glstableopt{par} isn't set to the default
+\glstableoptval{par}{false}.
+
+Styles like \gloskey{long} create a \env{longtable} with one entry
+per row. The \glostyle{table} style allows multiple entries per row.
+A \qt{block} indicates a block of columns used to format one entry. One row of
+the table contains multiple blocks.
+
+An extra field may be added with the \glstableopt{other}
+key. If this value is empty, then no extra field will be added.
+Block styles that show the description will put this other field in
+before the description, in the same column as the description.
+Block styles that don't show the description, will put the other
+field after the name, in the same column as the name.
+Some block styles, such as \glstableblockstyle{symbol-name}
+and \glstableblockstyle{symbol-other} put
+the other field in its own column.
+
+The optional argument may have the options that can typically be
+passed to \gls{printunsrtglossary}, except that the
+\printglossopt{nogroupskip},
+\printglossopt{nonumberlist} and \printglossopt{style} options won't
+have an effect. If you want the \idx{locationlist}, it can simply be
+obtained from the \gloskey{location} field in the appropriate style hook.
+
+Additionally, the following options may also be used.
+
+\optiondef{printunsrttab.blocks}
+The value is the number of blocks in the table.
+The total number of columns in the table will be this value
+multiplied by the number of columns per block, which is determined
+by the block style. For example, the \glstableblockstyle{name-desc}
+has two columns, so if there are three blocks then there will be a
+total of six columns.
+
+\optiondef{printunsrttab.header}
+A boolean option to determine whether or not to show the header row.
+The header text is produced with one of the following commands:
+\cmddef*{glstablenameheader}
+Expands to the header for the name column. Just uses \gls{entryname}
+by default.
-You can test if the counter has been defined using:
-\begin{definition}[\DescribeMacro\GlsXtrIfLinkCounterDef]
-\cs{GlsXtrIfLinkCounterDef}\marg{label}\marg{true}\marg{false}
-\end{definition}
-where \meta{label} is the entry's label.
-
-The counter name can be obtained using
-\begin{definition}[\DescribeMacro\GlsXtrLinkCounterName]
-\cs{GlsXtrLinkCounterName}\marg{label}
-\end{definition}
-This simply expands to the counter name associated with the
-entry given by \meta{label} without any check for
-existence. For example, to change the display command
-(\cs{the}\meta{counter}) using \sty{etoolbox}:
-\begin{verbatim}
-\csdef{the\GlsXtrLinkCounterName{duck}}{\Roman{\GlsXtrLinkCounterName{duck}}}
-\end{verbatim}
-This is useful if you just want to change the display for
-specific entries but isn't convenient if you want to change the
-display for all entries. Instead, it's simpler to redefine
-\cs{GlsXtrTheLinkCounter}. For example:
-\begin{verbatim}
-\renewcommand*{\GlsXtrTheLinkCounter}[1]{%
- \GlsXtrIfLinkCounterDef{#1}%
- {\Roman{\GlsXtrLinkCounterName{#1}}}%
- {0}%
-}
-\end{verbatim}
-In both cases, the redefinition should be implemented
-after \cs{GlsXtrEnableLinkCounting}.
+\cmddef*{glstabledescheader}
+Expands to the header for the description column for block styles
+like \glstableblockstyle{name-desc} and
+\glstableblockstyle{name-symbol-desc}. Just uses
+\gls{descriptionname} by default.
-Here's an example document that uses link counting to disable
-the hyperlink after the first reference. This redefines
-\ics{glslinkpresetkeys} (which is used by both \cs{gls}
-and \cs{glstext}) instead of
-\cs{glslinkcheckfirsthyperhook} (which is used by \cs{gls}
-but not by \cs{glstext}).
+\cmddef*{glstablesymbolheader}
+Expands to the header for the symbol column for block styles like
+\glstableblockstyle{name-symbol} and
+\glstableblockstyle{name-symbol-desc}. Just uses \gls{symbolname} by
+default.
-\begin{verbatim}
-\documentclass{article}
+\cmddef*{glstableotherheader}
+Expands to the header for the other column. The default definition
+applies \gls{MFUsentencecase} to the other field label.
+
+\optiondef{printunsrttab.rules}
+A boolean option to determine whether or not to show the horizontal
+rules (provided by \sty{booktabs}). If used with
+\glstableoptval{header}{true}, there will be a rule above and below
+the header row. If used with
+\glstableoptval{header}{false}, there will only be one rule at the
+top of the table. In both cases, there will be a rule at the bottom
+of the table.
+
+\optiondef{printunsrttab.blocksep}
+The value is inserted into the alignment specifier list between
+blocks. For example, the default value of the pipe character will
+insert a vertical line. Set this value to empty to remove it.
+
+\optiondef{printunsrttab.par}
+Indicates whether or not the columns should be paragraphs. The value
+may be one of: \optfmt{false}, \optfmt{justified} or
+\optfmt{ragged}. The default \glstableoptval{par}{false} will just
+use one of the column specifiers \code{l}, \code{r} or \code{c}.
+The other values will use the \code{p} specifier, in which case
+the column widths will be calculated.
+
+\optiondef{printunsrttab.other}
+This should be set to the \idx{internalfieldlabel} of the other
+field or to empty if no other field should be included.
+
+\optiondef{printunsrttab.init}
+The \meta{code} will be added shortly before
+\gls{printunsrtglossary} is called and any local changes will be
+scoped.
+
+\optiondef{printunsrttab.block-style}
+The block style, which may be one of the following:
+
+\glstableblockstyledef{name-desc}
+Blocks have two columns with the name in the first column of the
+block and the description in the second. This is the default style.
+
+\glstableblockstyledef{desc-name}
+Blocks have two columns with the description in the first column of the
+block and the name in the second.
+
+\glstableblockstyledef{name-symbol}
+Blocks have two columns with the name in the first column of the
+block and the symbol in the second.
+
+\glstableblockstyledef{symbol-name}
+Blocks have two columns with the symbol in the first column of the
+block and the name in the second.
+
+\glstableblockstyledef{name-symbol-desc}
+Blocks have three columns with the name in the first column of the
+block, the symbol in the second, and the description in the third.
+
+\glstableblockstyledef{name-desc-symbol}
+Blocks have three columns with the name in the first column of the
+block, the description in the second, and the symbol in the third.
+
+\glstableblockstyledef{name}
+Blocks have one column with the name followed by the symbol and
+description in parentheses, if they have been set.
+
+\glstableblockstyledef{name-other}
+This is like \glstableblockstyle{name-desc} but puts the other field
+in the second column. The description and symbol aren't shown.
+Note that you will need to set the \glstableopt{other} key to the
+required field, otherwise you will end up with an empty column.
+
+\glstableblockstyledef{other-name}
+This is like \glstableblockstyle{desc-name} but puts the other field
+in the second column. The description and symbol aren't shown.
+Note that you will need to set the \glstableopt{other} key to the
+required field, otherwise you will end up with an empty column.
+
+\glstableblockstyledef{symbol-other}
+This is like \glstableblockstyle{name-other} but shows the
+symbol instead of the name.
+
+\glstableblockstyledef{other-symbol}
+This is like \glstableblockstyle{other-name} but shows the
+symbol instead of the name.
+
+The block styles alter the way the \glostyle{table} style sets up
+the \env{longtable} environment and the way that the entries are
+formatted. The top level \idx{glossarystyle} command
+\gls{glossentry} is defined to do the block according to the
+designated block style and then it will follow the block with the
+child entries, if the \glosfield{childlist} field has been set.
+
+\begin{information}
+The \gls{subglossentry} command is redefined to do nothing, but it
+won't be used as the child entries are all filtered out. If you
+don't use the \resourceopt{save-child-count} resource option, no
+child entries will be shown. There's no recursive descent down the
+\idxpl{hierarchicallevel}.
+\end{information}
+
+This means that the child entries will be listed at the end of the
+last column in the block. This can make the column quite wide.
+The child names aren't displayed by default but supports the
+\opt{subentrycounter} option. The child entries are
+listed in a \env{tabular} environment, which means they are
+contained in the same row as their parent and can't be broken across
+a page.
+
+\begin{warning}
+The remaining commands are undocumented as they are liable to
+change.
+\end{warning}
+
+The following example uses the \glstableblockstyle{name} block style,
+which only has one column per block. The name is followed by the
+description in parentheses (if set), which is then followed by the
+child list. I redefined \gls{glsnamefont} to make the name appear in
+bold, to highlight it.
+I've used the \glstableoptval{par}{ragged} option,
+otherwise the table will be too wide to fit the page.
+\begin{codebox}
+\cmd{usepackage}
+ [\opt{record},\optval{stylemods}{table},\opt{subentrycounter}]
+ \marg{glossaries-extra}
+\codepar
+\gls{GlsXtrLoadResources}\oarg{
+ \comment{entries in \file{example-glossaries-childnoname.bib}:}
+ \resourceoptval{src}{example-glossaries-childnoname},
+ \resourceoptval{selection}{all},
+ \resourceoptval{save-child-count}}
+\cbeg{document}
+\gls{printunsrttable}
+ \oarg{
+ \glstableoptval{block-style}{name},\glstableoptval{par}{ragged},
+ \printglossoptvalm{preamble}{Some preamble text},
+ \printglossoptvalm{postamble}{Some postamble text},
+ \glstableoptvalm{init}{\comment{}
+ \cmd{let}\gls{glsnamefont}\cmd{textbf}
+ \cmd{def}\gls{glstablenameheader}\marg{Summary}\comment{}
+ }
+ }
+\cend{document}
+\end{codebox}
+This creates a table with two entries per row.
+\begin{resultbox}
+\createexample*[label={ex:table},
+title={Two entries per row with \cmd{printunsrttable}},
+description={Example document with a tabular glossary with two
+entries per row. The child list is in the same cell as the parent.},
+arara={pdflatex,bib2gls,pdflatex,pdfcrop}
+]
+{%
+\cmd{usepackage}[record,stylemods=table,subentrycounter]\marg{glossaries-extra}
+\codepar
+\gls{GlsXtrLoadResources}\oarg{^^J
+ \comment{entries in example-glossaries-childnoname.bib:}
+ \resourceoptval{src}{example-glossaries-childnoname},^^J
+ \resourceoptval{selection}{all},^^J
+ \resourceoptval{save-child-count}}^^J%
+}
+{%
+\gls{printunsrttable}^^J%
+ \oarg{^^J
+ block-style=name,par=ragged,^^J
+ preamble=\marg{Some preamble text},^^J
+ postamble=\marg{Some postamble text},^^J
+ init=\marg{\comment{}
+ \cmd{let}\gls{glsnamefont}\cmd{textbf}
+ \cmd{def}\gls{glstablenameheader}\marg{Summary}\comment{}
+ }^^J%
+ }
+}
+\end{resultbox}
+Note that each row is as deep as the entry with the most children.
+So where a row has one column with two children and another with
+seven, the row is deep enough to accommodate the seven child
+entries, which leaves a gap below the smaller list of two children.
-\usepackage[colorlinks]{hyperref}
-\usepackage{glossaries-extra}
+\glsadd[format=)]{pkg.glossary-table}%
-\makeglossaries
+\chapter{Accessibility Support}
+\label{sec:accsupp}
-\renewcommand*{\glslinkpresetkeys}{%
- \ifnum\GlsXtrLinkCounterValue{\glslabel}>1
- \setkeys{glslink}{hyper=false}%
- \fi
+The \sty{glossaries} package comes with a supplementary package
+\sty{glossaries-accsupp} that helps provide accessibility support.
+The \sty{glossaries-extra} package provides additional support, but
+only if the \sty{glossaries-accsupp} package has already been loaded
+when the relevant commands are defined. The best and simplest way to do this
+is through the \opt{accsupp} package option.
+
+See the \ctanmirrornofn{macros/latex/contrib/glossaries/glossaries-user.html\#sec:accsupp}{\qt{Accessibility
+Support}} chapter in the \sty{glossaries} user
+guide for further information about \sty{glossaries-accsupp}.
+
+\section{Abbreviations}
+\label{sec:accessabbr}
+
+The accessibility fields relating to abbreviations are
+\gloskey{shortaccess}, \gloskey{shortpluralaccess},
+\gloskey{longaccess} and \gloskey{longpluralaccess}. These provide
+the replacement text for the corresponding \gloskey{short},
+\gloskey{shortplural}, \gloskey{long} and \gloskey{longplural}
+fields. The \gloskey{access} field provides the replacement text for
+the \gloskey{name} field.
+
+Some of these accessibility fields are automatically assigned by
+\gls{newabbreviation} if they haven't been set.
+
+\cmddef{glsxtrassignactualsetup}
+This command is used to locally redefine common formatting commands
+so that they can be stripped to obtain only the text. You can add
+additional commands with \gls{appto}. For example, the following
+eccentric example has some strange styling in the abbreviation:
+\begin{codebox}
+\gls{newabbreviation}\marg{foo}\marg{f\gls+{textsuperscript}\marg{o}\gls+{textsubscript}\marg{o}}\marg{furry old otters}
+\end{codebox}
+If an accessibility field is being automatically assigned with text
+obtained from the short value, then the subscript and superscript
+commands will need to be stripped. These need to be locally
+redefined to just do their arguments:
+\begin{codebox}
+\gls{appto}\gls{glsxtrassignactualsetup}\marg{\%
+ \gls+{letcs}\marg{\gls{textsuperscript}}\marg{@firstofone}\%
+ \gls{letcs}\marg{\gls{textsubscript}}\marg{@firstofone}\%
}
+\end{codebox}
+
+The attributes that specifically relate to accessibility in
+abbreviations are listed below. The \qt{actual short value} means
+the value obtained from the \gloskey{short} value after any markup
+commands have have locally redefined using
+\gls{glsxtrassignactualsetup}. The actual short value may then be
+modified by these attributes. Similarly, for the \qt{actual long value}.
+
+Finally, if \gloskey{shortaccess} hasn't already been set, it will be set to:
+\begin{codebox}
+\gls{glsdefaultshortaccess}\margm{actual long}\margm{actual short}
+\end{codebox}
+(with \gls{glsdefaultshortaccess} expanded). This command is
+provided by \sty{glossaries-accsupp} and is defined to do just
+\margm{actual long}. It was redefined by \sty{glossaries-extra}
+v1.42 to do \code{\margm{actual long} (\margm{actual short})}, but
+has been reverted back to its original definition in v1.49.
+
+\optiondef{catattr.accessinsertdots}
+If the \gloskey{shortaccess} key hasn't been set then this
+attribute will be checked. If true, the actual short value
+will have dots inserted (as per \catattr{insertdots}). Note that if
+this attribute hasn't been set but \catattr{insertdots} is true (and the
+\gloskey{shortaccess} key hasn't been set), then the actual short value
+will also have dots inserted.
+
+\optiondef{catattr.accessaposplural}
+If the \gloskey{shortpluralaccess} key hasn't been set then this
+attribute will be checked. If true, the actual short plural value
+will have the apostrophe suffix (similar to \catattr{aposplural} but
+using \gls{glsxtrabbrvpluralsuffix} instead of
+\gls{abbrvpluralsuffix}). Note that if this attribute hasn't been
+set but \catattr{aposplural} is true (and the
+\gloskey{shortpluralaccess} key hasn't been set), then the actual
+short plural value will also have the apostrophe suffix.
+
+\optiondef{catattr.accessnoshortplural}
+If the \gloskey{shortpluralaccess} key hasn't been set and the
+\catattr{accessaposplural} attribute hasn't been set, then this
+attribute will be checked. If true, the actual short plural value
+will be the same as the singular (as \catattr{noshortplural}). Note
+that if this attribute hasn't been set but \catattr{noshortplural}
+is true (and the \gloskey{shortpluralaccess} key hasn't been set), then
+the actual short plural value will also be the singular form.
+
+\optiondef{catattr.nameshortaccess}
+If the \gloskey{access} key hasn't been set and this attribute is
+true, then the \gloskey{access} field will be set to the same as the
+\gloskey{shortaccess}.
+
+\optiondef{catattr.textshortaccess}
+If the \gloskey{textaccess} key hasn't been set and this attribute is
+true, then the \gloskey{textaccess} field will be set to the same as the
+\gloskey{shortaccess}. Additionally, if the \gloskey{pluralaccess}
+key hasn't been set, then it will be set to the same as the
+\gloskey{shortpluralaccess} value.
+
+\optiondef{catattr.firstshortaccess}
+If the \gloskey{firstaccess} key hasn't been set and this attribute is
+true, then the \gloskey{firstaccess} field will be set to the same as the
+\gloskey{shortaccess}. Additionally, if the \gloskey{firstpluralaccess}
+key hasn't been set, then it will be set to the same as the
+\gloskey{shortpluralaccess} value.
+
+\section{Accessibility Wrappers}
+\label{sec:glsaccessfield}
+
+The glossary style commands such as \gls{glossentryname}
+incorporate accessibility support by using the
+\csfmt{glsaccess\meta{field}} commands instead of the corresponding
+\csfmt{glsentry\meta{field}} commands.
+
+If the \sty{glossaries-accsupp} package hasn't been loaded or if the
+relevant accessibility field hasn't been set, these commands
+simply do the corresponding \csfmt{glsentry\meta{field}} command.
+
+\cmddef{glsaccessname}
+This shows the \gloskey{name} field encapsulated with
+\gls{glsnameaccessdisplay} or just
+\gls{glsentryname}\margm{entry-label}.
+
+\cmddef{Glsaccessname}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessname}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccesstext}
+This shows the \gloskey{text} field encapsulated with
+\gls{glstextaccessdisplay} or just
+\gls{glsentrytext}\margm{entry-label}.
+
+\cmddef{Glsaccesstext}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccesstext}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessplural}
+This shows the \gloskey{plural} field encapsulated with
+\gls{glspluralaccessdisplay} or just
+\gls{glsentryplural}\margm{entry-label}.
+
+\cmddef{Glsaccessplural}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessplural}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessfirst}
+This shows the \gloskey{first} field encapsulated with
+\gls{glsfirstaccessdisplay} or just
+\gls{glsentryfirst}\margm{entry-label}.
+
+\cmddef{Glsaccessfirst}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessfirst}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessfirstplural}
+This shows the \gloskey{firstplural} field encapsulated with
+\gls{glsfirstpluralaccessdisplay} or just
+\gls{glsentryfirstplural}\margm{entry-label}.
+
+\cmddef{Glsaccessfirstplural}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessfirstplural}
+As above but \idx{allcaps}.
-\GlsXtrEnableLinkCounting{general}
+\cmddef{glsaccesssymbol}
+This shows the \gloskey{symbol} field encapsulated with
+\gls{glssymbolaccessdisplay} or just
+\gls{glsentrysymbol}\margm{entry-label}.
-\newglossaryentry{sample1}{name={sample1},description={an example}}
-\newglossaryentry{sample2}{name={sample2},description={another example}}
+\cmddef{Glsaccesssymbol}
+As above but \idx{sentencecase}.
-\newabbreviation{ex}{ex}{example}
+\cmddef{GLSaccesssymbol}
+As above but \idx{allcaps}.
-\begin{document}
+\cmddef{glsaccesssymbolplural}
+This shows the \gloskey{symbolplural} field encapsulated with
+\gls{glssymbolpluralaccessdisplay} or just
+\gls{glsentrysymbolplural}\margm{entry-label}.
-\section{Sample Section}
+\cmddef{Glsaccesssymbolplural}
+As above but \idx{sentencecase}.
-\Gls{sample1}, \gls{sample2} and \gls{ex}.
-\Glstext{sample1} and \gls{ex} again.
+\cmddef{GLSaccesssymbolplural}
+As above but \idx{allcaps}.
-\section{Another Sample Section}
+\cmddef{glsaccessdesc}
+This shows the \gloskey{description} field encapsulated with
+\gls{glsdescriptionaccessdisplay} or just
+\gls{glsentrydesc}\margm{entry-label}.
-\Gls{sample1}, \gls{sample2} and \gls{ex}.
+\cmddef{Glsaccessdesc}
+As above but \idx{sentencecase}.
-\printglossaries
+\cmddef{GLSaccessdesc}
+As above but \idx{allcaps}.
-\end{document}
-\end{verbatim}
-The use of \ics{glslinkpresetkeys}
-means that the options can override this. For example
-\begin{verbatim}
-\gls[hyper=true]{sample1}
-\end{verbatim}
-will override the \texttt{hyper=false} setting in
-\ics{glslinkpresetkeys}. If \ics{glslinkpostsetkeys} is used
-instead, the \texttt{hyper=false} setting will override
-the setting provided in the optional argument.
+\cmddef{glsaccessdescplural}
+This shows the \gloskey{descriptionplural} field encapsulated with
+\gls{glsdescriptionpluralaccessdisplay} or just
+\gls{glsentrydescplural}\margm{entry-label}.
-The \category{abbreviation} category doesn't have the
-\catattr{linkcount} attribute set (since it's not
-listed in the argument of \cs{GlsXtrEnableLinkCounting}). This means that
-\cs{GlsXtrLinkCounterValue}
-always expands to 0 for the abbreviation (\texttt{ex}), so the
-inequality test
-\begin{verbatim}
-\ifnum\GlsXtrLinkCounterValue{\glslabel}>1
-\end{verbatim}
-will always be false. This means that the abbreviation won't
-have \texttt{hyper=false} applied. If the test is changed to
-\begin{verbatim}
-\ifnum\GlsXtrLinkCounterValue{\glslabel}=1
-\else
- \setkeys{glslink}{hyper=false}%
-\fi
-\end{verbatim}
-Then the abbreviation will always have \texttt{hyper=false}
-applied.
+\cmddef{Glsaccessdescplural}
+As above but \idx{sentencecase}.
-To reset the counter every section use the optional argument to set
-the master counter:
-\begin{verbatim}
-\GlsXtrEnableLinkCounting[section]{general}
-\end{verbatim}
+\cmddef{GLSaccessdescplural}
+As above but \idx{allcaps}.
-\chapter{Auto-Indexing}
-\label{sec:autoindex}
+\cmddef{glsaccessshort}
+This shows the \gloskey{short} field encapsulated with
+\gls{glsshortaccessdisplay} or just
+\gls{glsentryshort}\margm{entry-label}.
-It's possible that you may also want a normal index as well as
-the glossary, and you may want entries to automatically be
-added to the index (as in this document).
-There are two attributes that govern this: \catattr{indexname}
-and \catattr{dualindex}.
+\cmddef{Glsaccessshort}
+As above but \idx{sentencecase}.
-\begin{important}
-The auto-indexing is designed for \gls{makeindex} syntax. If you've
-used the \pkgopt{xindy} package option, the automatic escaping of
-\gls{xindy} special characters in the \gloskey{sort} field may
-result in an incorrect sort value for the \cs{index} command used by
-the auto-indexing. Note also that \app{texindy} has a fixed set of
-special characters (corresponding to \gls{makeindex}['s] defaults)
-that can't be customized. You may want to consider using \gls{bib2gls} and
-its dual entries as an alternative approach.
-\end{important}
+\cmddef{GLSaccessshort}
+As above but \idx{allcaps}.
-\begin{sloppypar}
-The \ics{glsxtrpostnamehook} macro, used
-at the end of \ics{glossentryname} and \ics{Glossentryname},
-checks the \catattr{indexname} attribute for the category
-associated with that entry.
-Since \cs{glossentryname} is used in the default glossary
-styles, this makes a convenient way of automatically indexing
-each entry name at its location in the glossary without
-fiddling around with the value of the \gloskey{name} key.
-\end{sloppypar}
-
-The internal macro used by the \styfmt{glossaries} package to
-write the information to the external glossary file is
-modified to check for the \catattr{dualindex} attribute.
+\cmddef{glsaccessshortpl}
+This shows the \gloskey{shortplural} field encapsulated with
+\gls{glsshortpluralaccessdisplay} or just
+\gls{glsentryshortpl}\margm{entry-label}.
-In both cases, the indexing is done through
-\begin{definition}[\DescribeMacro\glsxtrdoautoindexname]
-\cs{glsxtrdoautoindexname}\marg{label}\marg{attribute-label}
-\end{definition}
-This uses the standard \ics{index} command with the sort value
-taken from the entry's \gloskey{sort} key and the actual value
-set to \cs{glsentryname}\marg{label}. As from v1.16, there are
-user-level commands available to change the sort and actual
-value used by the automated index.
+\cmddef{Glsaccessshortpl}
+As above but \idx{sentencecase}.
-The actual value is given by
-\begin{definition}[\DescribeMacro\glsxtrautoindexentry]
-\cs{glsxtrautoindexentry}\marg{label}
-\end{definition}
-where \meta{label} is the entry's label. The default definition
-is:
-\begin{verbatim}
-\newcommand*{\glsxtrautoindexentry}[1]{\string\glsentryname{#1}}
-\end{verbatim}
-Note the use of \cs{string} to prevent \cs{glsentryname} from
-being expanded as it's written to the index file.
+\cmddef{GLSaccessshortpl}
+As above but \idx{allcaps}.
-The sort value is assigned using:
-\begin{definition}[\DescribeMacro\glsxtrautoindexassignsort]
-\cs{glsxtrautoindexassignsort}\marg{cs}\marg{label}
-\end{definition}
-where \meta{label} is the entry label and \meta{cs} is the command
-which needs to be set to the sort value. The default definition is:
-\begin{verbatim}
-\newcommand*{\glsxtrautoindexassignsort}[2]{%
- \glsletentryfield{#1}{#2}{sort}%
-}
-\end{verbatim}
-After this macro is called, \meta{cs} is then processed to escape
-any of \app{makeindex}'s special characters. Note that this
-escaping is only performed on the sort not on the actual value.
-The escaping of the sort value is performed by
-\begin{definition}[\DescribeMacro\glsxtrautoindexesc]
-\cs{glsxtrautoindexesc}
-\end{definition}
-You can redefine this to do nothing if you want to omit the
-escaping. You may want to consider providing another field to obtain
-the appropriate sort value if the one provided in the \gloskey{sort}
-field isn't suitable (because it may already have had special
-characters escaped or it may be a numeric value in the case of
-sort by use or definition).
+\cmddef{glsaccesslong}
+This shows the \gloskey{long} field encapsulated with
+\gls{glslongaccessdisplay} or just
+\gls{glsentrylong}\margm{entry-label}.
-The command used to perform the actual indexing is:
-\begin{definition}[\DescribeMacro\glsxtrautoindex]
-\cs{glsxtrautoindex}\marg{text}
-\end{definition}
-This just does \cs{index}\marg{text} by default.
+\cmddef{Glsaccesslong}
+As above but \idx{sentencecase}.
-\begin{important}
-The entry's \gloskey{parent} field isn't referenced in this
-automated indexing.
-\end{important}
+\cmddef{GLSaccesslong}
+As above but \idx{allcaps}.
-For example, to index the value of the \gloskey{first} key,
-instead of the \gloskey{name} key:
-\begin{verbatim}
-\renewcommand*{\glsxtrautoindexentry}[1]{\string\glsentryfirst{#1}}
-\end{verbatim}
-and if the sort value also needs to be set to the \gloskey{long}
-field, if present, otherwise the \gloskey{sort} field:
-\begin{verbatim}
-\renewcommand*{\glsxtrautoindexassignsort}[2]{%
- \ifglshaslong{#2}%
- {\glsletentryfield{#1}{#2}{long}}%
- {\glsletentryfield{#1}{#2}{sort}}%
-}
-\end{verbatim}
+\cmddef{glsaccesslongpl}
+This shows the \gloskey{longplural} field encapsulated with
+\gls{glslongpluralaccessdisplay} or just
+\gls{glsentrylongpl}\margm{entry-label}.
-If the value of the attribute given by \meta{attribute-label}
-is \qt{true}, no encap
-will be added, otherwise the encap will be the
-attribute value. For example:
-\begin{verbatim}
-\glssetcategoryattribute{general}{indexname}{textbf}
-\end{verbatim}
-will set the encap to \texttt{textbf} which will display the
-relevant page number in bold whereas
-\begin{verbatim}
-\glssetcategoryattribute{general}{dualindex}{true}
-\end{verbatim}
-won't apply any formatting to the page number in the index.
+\cmddef{Glsaccesslongpl}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccesslongpl}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessuseri}
+This shows the \gloskey{user1} field encapsulated with
+\gls{glsuseriaccessdisplay} or just
+\gls{glsentryuseri}\margm{entry-label}.
+
+\cmddef{Glsaccessuseri}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessuseri}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessuserii}
+This shows the \gloskey{user2} field encapsulated with
+\gls{glsuseriiaccessdisplay} or just
+\gls{glsentryuserii}\margm{entry-label}.
+
+\cmddef{Glsaccessuserii}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessuserii}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessuseriii}
+This shows the \gloskey{user3} field encapsulated with
+\gls{glsuseriiiaccessdisplay} or just
+\gls{glsentryuseriii}\margm{entry-label}.
+
+\cmddef{Glsaccessuseriii}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessuseriii}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessuseriv}
+This shows the \gloskey{user4} field encapsulated with
+\gls{glsuserivaccessdisplay} or just
+\gls{glsentryuseriv}\margm{entry-label}.
+
+\cmddef{Glsaccessuseriv}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessuseriv}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessuserv}
+This shows the \gloskey{user5} field encapsulated with
+\gls{glsuservaccessdisplay} or just
+\gls{glsentryuserv}\margm{entry-label}.
+
+\cmddef{Glsaccessuserv}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessuserv}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessuservi}
+This shows the \gloskey{user6} field encapsulated with
+\gls{glsuserviaccessdisplay} or just
+\gls{glsentryuservi}\margm{entry-label}.
+
+\cmddef{Glsaccessuservi}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessuservi}
+As above but \idx{allcaps}.
+
+\section{Inner Formatting Wrappers}
+\label{sec:glsaccessfmtfield}
+
+These \csfmt{glsaccessfmt\meta{field}} commands are similar to the
+corresponding \csfmt{glsaccess\meta{field}} commands described
+above, but they format the field value using \gls{glsfmtfield},
+\gls{Glsfmtfield} or \gls{GLSfmtfield} with the
+supplied \meta{cs} encapsulating command.
+
+The default entry display style \gls{glsgenentryfmt}, and the predefined abbreviation
+styles all incorporate accessibility support by using these commands
+in order to support the \idx{innerformatting}.
+
+\cmddef{glsaccessfmtname}
+This shows the \gloskey{name} field formatted with \meta{cs} and, if
+accessibility support provided, encapsulated with
+\gls{glsnameaccessdisplay}.
+
+\cmddef{Glsaccessfmtname}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessfmtname}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessfmttext}
+This shows the \gloskey{text} field formatted with \meta{cs} and, if
+accessibility support provided, encapsulated with
+\gls{glstextaccessdisplay}.
+
+\cmddef{Glsaccessfmttext}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessfmttext}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessfmtplural}
+This shows the \gloskey{plural} field formatted with \meta{cs} and, if
+accessibility support provided, encapsulated with
+\gls{glspluralaccessdisplay}.
+
+\cmddef{Glsaccessfmtplural}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessfmtplural}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessfmtfirst}
+This shows the \gloskey{first} field formatted with \meta{cs} and, if
+accessibility support provided, encapsulated with
+\gls{glsfirstaccessdisplay}.
+
+\cmddef{Glsaccessfmtfirst}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessfmtfirst}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessfmtfirstplural}
+This shows the \gloskey{firstplural} field formatted with \meta{cs} and, if
+accessibility support provided, encapsulated with
+\gls{glsfirstpluralaccessdisplay}.
+
+\cmddef{Glsaccessfmtfirstplural}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessfmtfirstplural}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessfmtsymbol}
+This shows the \gloskey{symbol} field formatted with \meta{cs} and, if
+accessibility support provided, encapsulated with
+\gls{glssymbolaccessdisplay}.
+
+\cmddef{Glsaccessfmtsymbol}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessfmtsymbol}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessfmtsymbolplural}
+This shows the \gloskey{symbolplural} field formatted with \meta{cs} and, if
+accessibility support provided, encapsulated with
+\gls{glssymbolpluralaccessdisplay}.
+
+\cmddef{Glsaccessfmtsymbolplural}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessfmtsymbolplural}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessfmtdesc}
+This shows the \gloskey{description} field formatted with \meta{cs} and, if
+accessibility support provided, encapsulated with
+\gls{glsdescriptionaccessdisplay}.
+
+\cmddef{Glsaccessfmtdesc}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessfmtdesc}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessfmtdescplural}
+This shows the \gloskey{descriptionplural} field formatted with \meta{cs} and, if
+accessibility support provided, encapsulated with
+\gls{glsdescriptionpluralaccessdisplay}.
+
+\cmddef{Glsaccessfmtdescplural}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessfmtdescplural}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessfmtshort}
+This shows the \gloskey{short} field formatted with \meta{cs} and, if
+accessibility support provided, encapsulated with
+\gls{glsshortaccessdisplay}.
+
+\cmddef{Glsaccessfmtshort}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessfmtshort}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessfmtshortpl}
+This shows the \gloskey{shortplural} field formatted with \meta{cs} and, if
+accessibility support provided, encapsulated with
+\gls{glsshortpluralaccessdisplay}.
+
+\cmddef{Glsaccessfmtshortpl}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessfmtshortpl}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessfmtlong}
+This shows the \gloskey{long} field formatted with \meta{cs} and, if
+accessibility support provided, encapsulated with
+\gls{glslongaccessdisplay}.
+
+\cmddef{Glsaccessfmtlong}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessfmtlong}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessfmtlongpl}
+This shows the \gloskey{longplural} field formatted with \meta{cs} and, if
+accessibility support provided, encapsulated with
+\gls{glslongpluralaccessdisplay}.
+
+\cmddef{Glsaccessfmtlongpl}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessfmtlongpl}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessfmtuseri}
+This shows the \gloskey{user1} field formatted with \meta{cs} and, if
+accessibility support provided, encapsulated with
+\gls{glsuseriaccessdisplay}.
+
+\cmddef{Glsaccessfmtuseri}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessfmtuseri}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessfmtuserii}
+This shows the \gloskey{user2} field formatted with \meta{cs} and, if
+accessibility support provided, encapsulated with
+\gls{glsuseriiaccessdisplay}.
+
+\cmddef{Glsaccessfmtuserii}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessfmtuserii}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessfmtuseriii}
+This shows the \gloskey{user3} field formatted with \meta{cs} and, if
+accessibility support provided, encapsulated with
+\gls{glsuseriiiaccessdisplay}.
+
+\cmddef{Glsaccessfmtuseriii}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessfmtuseriii}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessfmtuseriv}
+This shows the \gloskey{user4} field formatted with \meta{cs} and, if
+accessibility support provided, encapsulated with
+\gls{glsuserivaccessdisplay}.
+
+\cmddef{Glsaccessfmtuseriv}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessfmtuseriv}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessfmtuserv}
+This shows the \gloskey{user5} field formatted with \meta{cs} and, if
+accessibility support provided, encapsulated with
+\gls{glsuservaccessdisplay}.
+
+\cmddef{Glsaccessfmtuserv}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessfmtuserv}
+As above but \idx{allcaps}.
+
+\cmddef{glsaccessfmtuservi}
+This shows the \gloskey{user6} field formatted with \meta{cs} and, if
+accessibility support provided, encapsulated with
+\gls{glsuserviaccessdisplay}.
+
+\cmddef{Glsaccessfmtuservi}
+As above but \idx{sentencecase}.
+
+\cmddef{GLSaccessfmtuservi}
+As above but \idx{allcaps}.
+
+\chapter{Categories}
+\label{sec:categories}
+
+\begin{information}
+For multi-entry categories, see \sectionref{sec:multiglscategory}.
+\end{information}
+
+Each entry defined by \gls{newglossaryentry} (or commands that
+internally use it such as \gls{newabbreviation}) is assigned a
+category through the \gloskey{category} key. You may add any
+category that you like, but since the category is a label used in
+the creation of some control sequences, avoid problematic characters
+within the category label. (So take care if you have \sty{babel}
+shorthands on that make some characters active.)
+
+The use of categories can give you more control over the way entries
+are displayed in the text or glossary. Note that an entry's category
+is independent of the glossary type. Be careful not to confuse
+\gloskey{category} with \gloskey{type}.
+
+\cmddef{glscategory}
+Expands to the category of the given entry or does nothing if the
+entry doesn't exist (analogous to \gls{glsentryname}).
+
+\cmddef{glsifcategory}
+Tests if the entry given by \meta{entry-label} has the
+\gloskey{category} set to \meta{category}.
+
+An entry may have its \gloskey{category} field changed using
+commands such as \gls{GlsXtrSetField} (see
+\sectionref{sec:setfields}). In addition, the following commands are
+provided to batch set the \gloskey{category} for a collection of
+entries.
+
+\cmddef{glsxtrsetcategory}
+Globally sets the \gloskey{category} field to the fully expanded \meta{category-label}
+for each entry listed in \meta{entry-labels}.
+
+\cmddef{glsxtrsetcategoryforall}
+Globally sets the \gloskey{category} field to the fully
+expanded \meta{category-label} for each entry belonging to the
+\idxpl{glossary} listed in \meta{glossary-labels}.
+
+There are also some iterative commands available:
+
+\cmddef{glsforeachincategory}
+This iterates through all entries in the \idxpl{glossary} identified by
+the comma-separated list \meta{glossary-labels} that have the
+category given by \meta{category-label} and performs \meta{body} for
+each match. Within \meta{body}, you can use \meta{glossary-cs} and
+\meta{label-cs} (which much be control sequences) to access the
+current glossary and entry label. If \meta{glossary-labels} is
+omitted, all glossaries are assumed.
+
+\cmddef{glsforeachwithattribute}
+This iterates over all entries in the given list of \idxpl{glossary}
+that have a category with the given \meta{attribute-label} set to
+\meta{attribute-value} and performs \meta{body} at each iteration.
+If \meta{glossary-types} is omitted, the list of all non-\idxpl{ignoredglossary}
+is assumed. The remaining arguments are as for
+\gls{glsforeachincategory}.
+
+\section{Known Categories}
+\label{sec:knowncategories}
+
+These are the category labels that are set or referenced by
+\sty{glossaries-extra}.
+
+\optiondef{cat.general}
+The default category assumed by \gls{newglossaryentry}.
+
+\optiondef{cat.abbreviation}
+The default category assumed by \gls{newabbreviation}.
+
+\optiondef{cat.acronym}
+The default category assumed by \gls{newacronym}.
+
+\optiondef{cat.index}
+The default category assumed by \gls{newterm}.
+
+\optiondef{cat.symbol}
+The default category assumed by \gls{glsxtrnewsymbol}.
+
+\optiondef{cat.number}
+The default category assumed by \gls{glsxtrnewnumber}.
+
+\section{Attributes}
+\label{sec:attributes}
+
+Each category may have a set of attributes, where each attribute has
+an associated value for its given category. An entry's attribute set
+corresponds to the attributes associated with the entry's category.
+
+As with the category, the attribute name is also a label. You can
+provide your own custom attributes, which you can set and access
+with the commands described in \sectionref{sec:attributecmds}.
+
+\subsection{Known Attributes}
+\label{sec:knownattributes}
+
+This section lists attributes that \sty{glossaries-extra} sets or
+accesses. If an attribute hasn't been set, a default is assumed.
+For boolean attributes, the test may simply be to determine if the
+attribute has been set to \code{true}, in which case any other value
+or a missing value will be interpreted as false. Conversely, the
+test may be to determine if the attribute has been set to
+\code{false}, in which case any other value or a missing value will
+be interpreted as true.
+
+\begin{information}
+See \sectionref{sec:multiglscategory} for attributes relating to
+multi-entry categories.
+\end{information}
+
+\subsubsection{Abbreviation Attributes}
+\label{sec:abbrattr}
+
+See \sectionref{sec:accessabbr} for abbreviation accessibility attributes.
+
+\optiondef{catattr.regular}
+This attribute indicates whether or not an entry should be
+considered a regular entry. This enables \gls{glsentryfmt} to
+determine whether to use \gls{glsgenentryfmt} or
+\gls{glsxtrgenabbrvfmt}.
+
+The \cat{general} and \cat{acronym} categories have the
+\catattr{regular} attribute automatically set to \code{true}.
+Some abbreviation styles change this value.
+
+\optiondef{catattr.discardperiod}
+If set to \qt{true}, the \idx{postlinkhook} will discard a
+\idx{fullstop} that follows \emph{non-plural} commands like
+\gls{gls} or \gls{glstext}(see \sectionref{sec:postlinkhook}).
+
+\begin{information}
+This attribute doesn't apply to the accessibility fields.
+See \sectionref{sec:accessabbr} for attributes related to
+accessibility support for abbreviations.
+\end{information}
+
+Note that this can cause a problem if you access a field that
+doesn't end with a full stop. For example:
+\begin{codebox}
+\gls{newabbreviation}
+ \oarg{\gloskeyval{user1}{German Speaking \cmd{TeX}\cmd{ }User Group}}
+ \marg{dante}\marg{DANTE e.V.}\marg{Deutschsprachige Anwendervereinigung
+ \cmd{TeX}\cmd{ }e.V.}
+\end{codebox}
+Here the \gloskey{short} and \gloskey{long} fields end with a full stop, but the
+\gloskey{user1} field doesn't. The simplest solution in this
+situation is to put the sentence terminator in the final optional
+argument. For example:
+\begin{codebox}
+\gls{glsuseri}\marg{dante}\oarg{.}
+\end{codebox}
+This will bring the punctuation character inside the \idx{linktext}
+and it won't be discarded.
+
+\optiondef{catattr.pluraldiscardperiod}
+If this attribute is set to
+\qt{true} \emph{and} the \catattr{discardperiod} attribute is set to
+\qt{true}, this will behave as above for the plural commands like
+\gls{glspl} or \gls{glsplural}.
+
+\optiondef{catattr.retainfirstuseperiod}
+If this attribute is set to \qt{true} then the discard is determined
+by \gls{glsxtrdiscardperiodretainfirstuse}, regardless of the
+\catattr{discardperiod} or \catattr{pluraldiscardperiod} attributes.
+This is useful for \meta{short} (\meta{long}) abbreviation styles
+where only the short form has a trailing \idx{fullstop}.
+
+\begin{information}
+This attribute doesn't apply to the accessibility fields.
+See \sectionref{sec:accessabbr} for attributes related to
+accessibility support for abbreviations.
+\end{information}
+
+\optiondef{catattr.markwords}
+If this attribute is set to \qt{true}
+any entry defined using \gls{newabbreviation} will automatically
+have spaces in the long form replaced with:
+\cmddef{glsxtrwordsep}
+and each word is encapsulated with:
+\cmddef{glsxtrword}
+For example:
+\begin{codebox}
+\gls{glssetcategoryattribute}\marg{\cat{abbreviation}}\marg{\catattr{markwords}}\marg{true}
+\gls{newabbreviation}\marg{ip}\marg{IP}\marg{Internet Protocol}
+\end{codebox}
+is essentially the same as
+\begin{codebox}
+\gls{newabbreviation}\marg{ip}\marg{IP}
+\marg{\gls{glsxtrword}\marg{Internet}\gls{glsxtrwordsep}\gls{glsxtrword}\marg{Protocol}}
+\end{codebox}
+The \qt{hyphen} styles, such as
+\abbrstyle{long-hyphen-short-hyphen}, take advantage of this
+markup. If the inserted material (provided in the final argument
+of \idx{glslike} commands) starts with a hyphen then
+\gls{glsxtrwordsep} is locally redefined to a hyphen. (The default
+value is a space). Note that this only applies to commands
+like \gls{gls} and not like \gls{glsxtrlong}. You can provide your own
+localised switch, if required. For example:
+\begin{codebox}
+\cmd{newcommand}\marg{\cmd{hyplong}}[2][]\marg{\%
+ \marg{\cmd{def}\gls{glsxtrwordsep}\marg{-}\gls{glsxtrlong}\oarg{\#1}\marg{\#2}}}
+\end{codebox}
+
+This setting will also adjust the long plural. This attribute is
+only applicable to entries defined using \gls{newabbreviation} (or
+\gls{newacronym} if it's using \gls{newabbreviation}.)
\begin{important}
-The location used in the index will always be the page number
-not the counter used in the glossary. (Unless some other loaded
-package has modified the definition of \cs{index} to use
-some thing else.)
+This setting may result in the \gls{glsxtrword} and
+\gls{glsxtrwordsep} markup ending up in the \gloskey{sort} field,
+depending on the style in use.
\end{important}
-By default the \gloskey[glslink]{format} key won't be used with
-the \catattr{dualindex} attribute. You can allow the
-\gloskey[glslink]{format} key to override the attribute value
-by using the preamble-only command:
-\begin{definition}[\DescribeMacro\GlsXtrEnableIndexFormatOverride]
-\cs{GlsXtrEnableIndexFormatOverride}
-\end{definition}
-If you use this command and \sty{hyperref} has been loaded,
-then the \env{theindex} environment will be modified to redefine
-\ics{glshypernumber} to allow formats that use that command.
+\optiondef{catattr.markshortwords}
+This is similar to
+\catattr{markwords} but applies to the short form. (Only useful for
+abbreviations that contain spaces.) This attribute is only applicable to entries
+defined using \gls{newabbreviation} (or \gls{newacronym} if it's using
+\gls{newabbreviation}.)
+
+This setting will only adjust the short plural if the
+\gloskey{shortplural} key isn't used. This setting will
+take precedence over \catattr{insertdots}.
\begin{important}
-The \catattr{dualindex} attribute will still be used on
-subsequent use even if the \catattr{indexonlyfirst} attribute
-(or \pkgopt{indexonlyfirst} package option) is set. However,
-the \catattr{dualindex} attribute will honour the
-\gloskey[glslink]{noindex} key.
+This setting may result in the
+\gls{glsxtrword} and \gls{glsxtrwordsep} markup ending up in the
+\gloskey{sort} field, depending on the style in use.
\end{important}
-The \cs{glsxtrdoautoindexname} command will attempt to escape any of
-\ics{makeindex}'s special characters, but there may be special cases
-where it fails, so take care. This assumes the default \gls{makeindex} actual,
-level, quote and encap values (unless any of the commands
-\ics{actualchar}, \ics{levelchar}, \ics{quotechar} or
-\ics{encapchar} have been defined before \styfmt{glossaries-extra}
-is loaded).
+\optiondef{catattr.insertdots}
+If this attribute is set to \qt{true}
+any entry defined using \gls{newabbreviation} will automatically
+have \idxpl{fullstop} inserted after each letter. The entry will
+be defined with those dots present as though they had been present
+in the \meta{short} argument of \gls{newabbreviation} (rather than
+inserting them every time the entry is used). The short plural
+form defaults to the new dotted version of the original \meta{short}
+form with the plural suffix appended. \emph{This setting is incompatible
+with \catattr{markshortwords}.} This attribute is only applicable to entries
+defined using \gls{newabbreviation} (or \gls{newacronym} if it's using
+\gls{newabbreviation}.)
-If this isn't the case, you can use the following preamble-only
-commands to set the correct characters.
\begin{important}
-Be very careful of possible shifting category codes!
+If you explicitly override
+the short plural using the \gloskey{shortplural} key, you must
+explicitly insert the dots yourself (since there's no way for the
+code to determine if the plural has a suffix that shouldn't be
+followed by a dot).
\end{important}
-\begin{definition}[\DescribeMacro\GlsXtrSetActualChar]
-\cs{GlsXtrSetActualChar}\marg{char}
-\end{definition}
-Set the actual character to \meta{char}.
+This attribute is best used with the \catattr{discardperiod}
+attribute set to \qt{true}.
-\begin{definition}[\DescribeMacro\GlsXtrSetLevelChar]
-\cs{GlsXtrSetLevelChar}\marg{char}
-\end{definition}
-Set the level character to \meta{char}.
+\optiondef{catattr.aposplural}
+If this attribute is set to \qt{true},
+\gls{newabbreviation} will insert an apostrophe (') before
+the plural suffix for the \emph{short} plural form (unless explicitly
+overridden with the \gloskey{shortplural} key). The long plural form
+is unaffected by this setting. This setting overrides
+\catattr{noshortplural}. This attribute is only applicable to entries
+defined using \gls{newabbreviation} (or \gls{newacronym} if it's using
+\gls{newabbreviation}.) Check with your supervisor, publisher or
+editor if you want to use this attribute as this
+usage is controversial.
-\begin{definition}[\DescribeMacro\GlsXtrSetEscChar]
-\cs{GlsXtrSetEscChar}\marg{char}
-\end{definition}
-Set the escape (quote) character to \meta{char}.
+\optiondef{catattr.noshortplural}
+If this attribute is set to
+\qt{true}, \gls{newabbreviation} won't append the plural suffix for
+the short plural form. This means the \gloskey{short} and
+\gloskey{shortplural} values will be the same unless explicitly
+overridden. \emph{This setting is incompatible with \catattr{aposplural}.} This attribute is only applicable to entries
+defined using \gls{newabbreviation} (or \gls{newacronym} if it's using
+\gls{newabbreviation}.)
+
+\optiondef{catattr.tagging}
+If this attribute is set to \qt{true},
+the tagging command defined by \gls{GlsXtrEnableInitialTagging}
+will be activated to use \gls{glsxtrtagfont} in the glossary
+(see \sectionref{sec:tagging})
+
+\subsubsection{Attributes that Alter \glsfmttext{glslink} Options}
+\label{sec:glsoptsattr}
+
+\optiondef{catattr.nohyperfirst}
+When used with the \idx{glslike} commands, if this attribute is set
+to \code{true}, this will automatically suppress the hyperlink on
+\idx{firstuse}.
+
+\begin{information}
+This settings can be overridden by explicitly setting
+the \glsopt{hyper} key on or off in the optional argument of
+the \idx{glslike} command.
+\end{information}
+
+As from version 1.07, \gls{glsfirst},
+\gls{Glsfirst}, \gls{GLSfirst} and their plural versions (which should ideally
+behave in a similar way to the \idx{firstuse} of \gls{gls} or
+\gls{glspl}) now honour
+this attribute (but not the package-wide \optval{hyperfirst}{false}
+option, which matches the behaviour of \sty{glossaries}). If you
+want commands like \gls{glsfirst} to ignore the
+\catattr{nohyperfirst} attribute then just redefine
+\gls{glsxtrchecknohyperfirst} to do nothing.
+
+\optiondef{catattr.nohypernext}
+If set to \code{true}, this will automatically set
+\glsoptval{hyper}{false} on \idx{subsequentuse} when using the \idx{glslike} commands.
+
+\optiondef{catattr.nohyper}
+If set to \code{true}, this will automatically set
+\glsoptval{hyper}{false} when using the \idx{glslike} or
+\idx{glstextlike} commands.
+
+\optiondef{catattr.indexonlyfirst}
+This is similar to the \opt{indexonlyfirst} package option but only
+for entries that have a category with this attribute set to
+\qt{true}.
+
+\optiondef{catattr.wrgloss}
+When using the \idx{glslike} or \idx{glstextlike} commands, this
+will automatically set \glsoptval{wrgloss}{after} it this attribute
+is set to \qt{after}.
+
+\optiondef{catattr.textformat}
+The \idx{glslike} and \idx{glstextlike} commands have the
+\idx{linktext} encapsulated in the argument of \gls{glstextformat} by default
+(the outer formatting, see \sectionref{sec:glstextformat}). If
+the \catattr{textformat} attribute is set, the control sequence given by the attribute
+value will be used instead. The attribute value
+should be the name (without the leading backslash) of a command that
+takes a single argument (the \idx{linktext}). Remember that the
+abbreviation styles may apply an additional font change.
-\begin{definition}[\DescribeMacro\GlsXtrSetEncapChar]
-\cs{GlsXtrSetEncapChar}\marg{char}
-\end{definition}
-Set the encap character to \meta{char}.
+\optiondef{catattr.hyperoutside}
+This boolean attribute may be \code{false}, \code{true} or unset. If unset,
+\code{true} is assumed. This indicates the default setting
+of the \glsopt{hyperoutside} option, described in
+\sectionref{sec:glsopts}.
+
+\subsubsection{Glossary Attributes}
+\label{sec:glossattr}
+
+\optiondef{catattr.glossdesc}
+This attribute is checked by the \gls{glossentrydesc} to determine
+whether or not to apply any \idx{casechange}. The value may be one
+of:
+\begin{deflist}
+\itemtitle{\optfmt{firstuc}}
+\begin{itemdesc}
+Applies \idx+{sentencecase}. That is, the first letter of the
+description will be converted to \idx{uppercase} (using \gls{Glsentrydesc}).
+\end{itemdesc}
+
+\itemtitle{\optfmt{title}}
+\begin{itemdesc}
+Applies \idx+{titlecase}.
+If you have at least \sty{glossaries} v4.48, the title casing is indirectly performed
+by \gls{glscapitalisewords}, which defaults to \gls{capitalisewords}
+(provided by \sty{mfirstuc}). You can either redefine
+\gls{glscapitalisewords} if you want the change to also affect
+\gls{glsentrytitlecase} or if you only want the change to apply to
+the attribute case-changing then redefine
+\gls{glsxtrfieldtitlecasecs}. For example:
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glsxtrfieldtitlecasecs}}[1]\marg{\gls{xcapitalisefmtwords}*\marg{\#1}}
+\end{codebox}
+(Note that the argument to \gls{glsxtrfieldtitlecasecs}
+will be a control sequence whose replacement text is the
+entry's description, which is why \gls{xcapitalisefmtwords}
+is needed instead of \gls{capitalisefmtwords}.)
+
+\begin{warning}
+If an error occurs with this setting, try redefining
+\gls{glsxtrfieldtitlecasecs} as shown above.
+\end{warning}
+\end{itemdesc}
+
+\end{deflist}
+Any other values of this attribute are ignored. Remember
+that there are design limitations for both the \idx{sentencecase} and the
+\idx{titlecase} commands. See the \sty{mfirstuc} user manual for further details.
+
+\begin{information}
+If you are using \app{bib2gls}, you can use the
+\resourceopt{description-case-change} setting instead.
+\end{information}
+
+\optiondef{catattr.glossdescfont}
+If set, the value should be the name of a control sequence (without
+the leading backslash) that takes one argument. This control
+sequence will be applied by \gls{glossentrydesc} to the description text. For example:
+\begin{codebox}
+\gls{glssetcategoryattribute}\marg{\cat{general}}\marg{\catattr{glossdescfont}}\marg{emph}
+\end{codebox}
+
+\optiondef{catattr.glossname}
+As \catattr{glossdesc} but applies to \gls{glossentryname}.
+Additionally, if this attribute is set to \qt{uc} the name is
+converted to \idx{allcaps}.
+
+\begin{information}
+If you are using \app{bib2gls}, you can use the
+\resourceopt{name-case-change} setting instead.
+\end{information}
+
+\optiondef{catattr.indexname}
+If set, the \idx{postnamehook} will index the entry using
+\gls{index}. See \sectionref{sec:autoindex} for further details.
+
+\optiondef{catattr.glossnamefont}
+As \catattr{glossdescfont} but applies to \gls{glossentryname}.
+Note that this overrides \gls{glsnamefont} which will only
+be used if this attribute hasn't been set.
+
+Remember that \idxpl{glossarystyle} may additionally apply a font change,
+such as the list styles which put the name in the optional argument
+of \gls{item}.
+
+\optiondef{catattr.glosssymbolfont}
+This is similar to \catattr{glossnamefont} and
+\catattr{glossdescfont} but is used by \gls{glossentrysymbol}.
+
+
+\subsubsection{Other Attributes}
+\label{sec:otherattr}
+
+\optiondef{catattr.headuc}
+If this attribute is set to \qt{true},
+commands like \gls{glsfmtshort} will use the upper case version
+in the page headers.
+
+\optiondef{catattr.entrycount}
+The value of this attribute (if set) must be an integer and is used
+in combination with \gls{glsenableentrycount}
+(see \sectionref{sec:entrycount}). Leave blank or undefined
+for categories that shouldn't have this facility enabled. The
+value of this attribute is used by \gls{glsxtrifcounttrigger}
+to determine how commands such as \gls{cgls} should behave.
+
+\optiondef{catattr.linkcount}
+This attribute is set to
+\code{true} by \gls{GlsXtrEnableLinkCounting} (see
+\sectionref{sec:linkcount}).
+
+\optiondef{catattr.linkcountmaster}
+This attribute is set by \gls{GlsXtrEnableLinkCounting} to
+the name of the counter that requires the link counter to be added
+to its reset list (see \sectionref{sec:linkcount}).
+
+\optiondef{catattr.dualindex}
+If this attribute is set, whenever a glossary entry
+has information written to the external glossary file
+through commands like \gls{gls} and \gls{glsadd}, a~corresponding
+line will be written to the indexing file using \gls{index}.
+The value may be \code{true} to simply enable this feature or the
+value may be the encap to use with \gls{index}. See
+\sectionref{sec:autoindex} for further details.
+
+\optiondef{catattr.targeturl}
+If set, the hyperlink generated by commands like \gls{gls} will be
+set to the URL provided by this attribute's value. For example:
+\begin{codebox}
+\gls{glssetcategoryattribute}\marg{\cat{general}}\marg{\catattr{targeturl}}\marg{master-doc.pdf}
+\end{codebox}
+(See also the accompanying sample file
+\file{sample-external.tex}.) If the URL contains awkward
+characters (such as \verb|%| or \verb|~|) remember that the base
+\sty{glossaries} package provides commands like
+\gls{glspercentchar} and \gls{glstildechar} that expand to literal
+characters.
+
+\optiondef{catattr.targetname}
+If you want to a named anchor within the target URL (notionally
+adding \code{\#\meta{name}} to the URL), then you also
+need to set \catattr{targetname} to the anchor \meta{name}. You may
+use \gls{glslabel} within \meta{name} which is set by commands
+like \gls{gls} to the entry's label.
+
+All the predefined \idxpl{glossarystyle} start each entry
+listing with \gls{glstarget} which sets the anchor to
+\code{\gls{glolinkprefix}\gls{glslabel}}, so if you want entries to link
+to glossaries in the URL given by \catattr{targeturl}, you
+can just do:
+\begin{codebox}
+\gls{glssetcategoryattribute}\marg{\cat{general}}\marg{\catattr{targetname}}\marg{\gls{glolinkprefix}\gls{glslabel}}
+\end{codebox}
+(If the target document changed \gls{glolinkprefix} then you will
+need to adjust the above as appropriate.)
+
+\optiondef{catattr.targetcategory}
+If the anchor is in the form \code{\meta{name1}.\meta{name2}}
+then use \catattr{targetname} for the \meta{name2} part and
+\catattr{targetcategory} for the \meta{name1} part.
+
+For example:
+\begin{codebox}
+\gls{glssetcategoryattribute}\marg{\cat{general}}\marg{\catattr{targeturl}}\marg{master-doc.pdf}
+\gls{glssetcategoryattribute}\marg{\cat{general}}\marg{\catattr{targetcategory}}\marg{page}
+\gls{glssetcategoryattribute}\marg{\cat{general}}\marg{\catattr{targetname}}\marg{7}
+\end{codebox}
+will cause all link text for \cat{general} entries to
+link to \filefmt{master-doc.pdf\#page.7} (page 7 of that PDF).
+
+If you want a mixture in your document of entries that link to
+an internal glossary and entries that link to an external URL
+then you can use \gls{newignoredglossary*}
+for the external list. For example:
+\begin{codebox}
+\gls{newignoredglossary*}\marg{external}
+\codepar
+\gls{glssetcategoryattribute}\marg{external}\marg{\catattr{targeturl}}\marg{master-doc.pdf}
+\gls{glssetcategoryattribute}\marg{\cat{general}}\marg{\catattr{targetname}}\marg{\gls{glolinkprefix}\gls{glslabel}}
+\codepar
+\gls{newglossaryentry}\marg{sample}\marg{\gloskeyval{name}{sample},\gloskeyval{description}{local example}}
+\codepar
+\gls{newglossaryentry}\marg{sample2}\marg{\gloskeyval{name}{sample2},
+ \gloskeyval{type}{external},
+ \gloskeyval{category}{external},
+ \gloskeyval{description}{external example}}
+\end{codebox}
+
+\optiondef{catattr.externallocation}
+The value should be the file name of the target document when
+manually indexing an external location with \glsopt{thevalue}. In
+general, it's better to use \app{bib2gls} v1.7+ which can handle
+multiple external sources and doesn't require this attribute.
+
+\subsection{Accessing and Setting Attributes}
+\label{sec:attributecmds}
+
+Attributes can be set using the following commands:
+
+\cmddef{glssetcategoryattribute}
+Locally sets the given attribute to \meta{value} for the given
+category.
+
+\cmddef{glssetcategoriesattribute}
+Globally sets the given attribute to \meta{value} for all the
+categories in the comma-separated list \meta{category list}.
+
+\cmddef{glssetcategoryattributes}
+Globally sets each attribute in the comma separated
+\meta{attribute list} to \meta{value} for the given \meta{category}.
+
+\cmddef{glssetcategoriesattributes}
+Globally sets each attribute in the comma separated
+\meta{attribute list} to \meta{value} for each
+category in the comma-separated list \meta{category list}.
+
+\cmddef{glssetattribute}
+Locally sets the given attribute to \meta{value} for the
+category associated with the entry identified by
+\meta{entry-label}. This command can't be used to assign an
+attribute for a multi-entry category.
+
+\cmddef{glssetregularcategory}
+A shortcut that sets the \catattr{regular} attribute to \code{true}
+for the given category using \gls{glssetcategoryattribute}.
+
+An attribute can be locally unset using:
+\cmddef{glsunsetcategoryattribute}
+
+Attribute values can be obtained with the following commands:
+
+\cmddef{glsgetcategoryattribute}
+Expands to the value of the given attribute for the given
+category. Expands to nothing if the attribute hasn't been set.
+
+\cmddef{glsgetattribute}
+Expands to the value of the given attribute for the category
+associated with the entry identified by \meta{entry-label}. Expands
+to nothing if the attribute hasn't been set. This command can't be
+used to assign an attribute for a multi-entry category.
+
+Attributes can be tested with the following commands.
+
+\cmddef{glshascategoryattribute}
+This uses \sty{etoolbox}['s] \gls{ifcsvoid} and does \meta{true} if
+the attribute has been set and isn't blank and isn't \gls{relax}
+otherwise it does \meta{false}.
+
+\cmddef{glshasattribute}
+As \gls{glshascategoryattribute} but the category is obtained from
+the given entry. This command can't be used to test an attribute
+associated with a multi-entry category.
-\chapter{\headingapp{bib2gls}: Managing Reference Databases}
-\label{sec:bib2gls}
-
-There is a new command line application called
-\gls{bib2gls}, which works in much the same way as
-a combination of \appfmt{bibtex} and
-\appfmt{makeindex}\slash\appfmt{xindy}.
-Instead of storing all your entry definitions in a \texttt{.tex} and
-loading them using \cs{input} or \cs{loadglsentries}, the entries
-can instead be stored in a \texttt{.bib} file and \gls{bib2gls} can
-selectively write the appropriate commands to a \texttt{.glstex}
-file which is loaded using \cs{glsxtrresourcefile} (or
-\cs{GlsXtrLoadResources}).
-
-This means that you can use a reference managing system, such as
-JabRef, to maintain the database and it reduces the \TeX\ overhead
-by only defining the entries that are actually required in the
-document. If you currently have a \texttt{.tex} file that contains
-hundreds of definitions, but you only use a dozen or so in your
-document, then the build time is needlessly slowed by the unrequired
-definitions that occur when the file is input. (You can convert an
-existing \texttt{.tex} file containing glossary definitions to a
-\texttt{.bib} file using \app{convertgls2bib}, supplied with
-\gls{bib2gls}.)
+\cmddef{glsifcategoryattribute}
+This tests if the given attribute for the given category is set and
+equal to \meta{value}. If true, \meta{true} is done. If the
+attribute isn't set or is set but isn't equal to \meta{value},
+\meta{false} is done.
+
+For example:
+\begin{codebox}
+\gls{glsifcategoryattribute}\marg{\cat{general}}\marg{\catattr{nohyper}}\marg{true}\marg{NO HYPER}\marg{HYPER}
+\end{codebox}
+This does \qt{NO HYPER} if the \cat{general} category has the
+\catattr{nohyper} attribute set to \code{true} otherwise if
+does \qt{HYPER}.
+
+\cmddef{glsifattribute}
+As \gls{glsifcategoryattribute} but the category is obtained from
+the given entry. This command can't be used to test an attribute
+associated with a multi-entry category.
+
+\cmddef{glsifregularcategory}
+A shortcut that tests if the given category has the
+\catattr{regular} attribute set to \code{true}.
+
+\cmddef{glsifnotregularcategory}
+A shortcut that tests if the given category has the
+\catattr{regular} attribute set to \code{false}.
+
+\begin{warning}
+If the \catattr{regular} attribute hasn't been set, both
+\gls{glsifregularcategory} and \gls{glsifnotregularcategory} will do
+\meta{false}. The choice of command needs to be determined by what
+outcome should occur if the attribute hasn't been set.
+\end{warning}
+
+\cmddef{glsifregular}
+As \gls{glsifregularcategory} but the category is obtained from
+the given entry. This command can't be used to test an attribute
+associated with a multi-entry category.
+
+\cmddef{glsifnotregular}
+As \gls{glsifnotregularcategory} but the category is obtained from
+the given entry. This command can't be used to test an attribute
+associated with a multi-entry category.
+
+\cmddef{glsifcategoryattributetrue}
+Expands to \meta{true} if the attribute is \code{true} and
+\meta{false} otherwise. Expands to \meta{false} if there's no such
+attribute for the given category.
+
+\cmddef{glsifattributetrue}
+As \gls{glsifcategoryattributetrue} but the category is obtained from
+the given entry. Expands to \meta{false} if the entry isn't defined.
+This command can't be used to test an attribute
+associated with a multi-entry category.
+
+\cmddef{glsifcategoryattributehasitem}
+Does \meta{true} if the category has the attribute (whose
+value is a comma-separated list) contains the given item and \meta{false}
+otherwise. Does \meta{false} if there's
+no such attribute for the given category. The item and list are
+expanded and passed to \sty{datatool}['s] \gls{DTLifinlist} to
+perform the test.
+
+
+\chapter{\apptext{bib2gls}: Managing Reference Databases}
+\label{sec:bib2gls}\glsadd[format=(]{app.bib2gls}
+
+The command line application \app{bib2gls} performs two functions in
+one:
+\begin{itemize}
+\item selects entries according to \records\ found in the \ext+{aux} file
+(similar to \BibTeX),
+\item hierarchically sorts entries and collates \idxpl{locationlist}
+(similar to \app{makeindex} or \app{xindy}).
+\end{itemize}
+Instead of storing all your entry definitions in a \ext+{tex} and
+loading them using \gls{input} or \gls{loadglsentries}, the entries
+can instead be stored in a \ext+{bib} file and \app{bib2gls} can
+selectively write the appropriate commands to a \ext+{glstex}
+file which is loaded using \gls{GlsXtrLoadResources}.
+
+This means that you can use a reference managing system to maintain
+the database and it reduces the \TeX\ overhead by only defining the
+entries that are actually required in the document. If you currently
+have a \ext{tex} file that contains hundreds of definitions, but
+you only use a dozen or so in your document, then the build time is
+needlessly slowed by the unrequired definitions that occur when the
+file is input. (You can convert an existing \ext{tex} file
+containing glossary definitions to a \ext{bib} file using
+\app{convertgls2bib}, supplied with \app{bib2gls}.)
There are some new commands and options added to
-\styfmt{glossaries-extra} to help assist the integration of
-\gls{bib2gls} into the document build process.
+\sty{glossaries-extra} to help assist the integration of
+\app{bib2gls} into the document build process.
-This chapter just provides a general overview of \gls{bib2gls}.
+This chapter just provides a general overview of \app{bib2gls}.
The full details and some sample documents are provided
-in the \gls{bib2gls} \href{http://mirrors.ctan.org/support/bib2gls/bib2gls.pdf}{manual}.
-
-An example of the contents of \texttt{.bib} file that stores
-glossary entries that can be extracted with \gls{bib2gls}:
-\begin{verbatim}
-@entry{bird,
- name={bird},
- description = {feathered animal},
- see={[see also]{duck,goose}}
-}
-
-@entry{duck,
- name={duck},
- description = {a waterbird with short legs}
-}
-
-@entry{goose,
- name="goose",
- plural="geese",
- description={a waterbird with a long neck}
-}
-\end{verbatim}
-
-The follow provides some abbreviations:
-\begin{verbatim}
-@string{ssi={server-side includes}}
-@string{html={hypertext markup language}}
-
-@abbreviation{shtml,
- short="shtml",
- long= ssi # " enabled " # html,
- description={a combination of \gls{html} and \gls{ssi}}
-}
-
-@abbreviation{html,
- short ="html",
- long = html,
- description={a markup language for creating web pages}
-}
-
-@abbreviation{ssi,
- short="ssi",
- long = ssi,
- description={a simple interpreted server-side scripting language}
-}
-\end{verbatim}
-
-Here are some symbols:
-\begin{verbatim}
-preamble{"\providecommand{\mtx}[1]{\boldsymbol{#1}}"}
-
-@symbol{M,
- name={$\mtx{M}$},
- text={\mtx{M}},
- description={a matrix}
-}
-
-@symbol{v,
- name={$\vec{v}$},
- text={\vec{v}},
- description={a vector}
-}
-
-@symbol{S,
- name={$\mathcal{S}$},
- text={\mathcal{S}},
- description={a set}
-}
-\end{verbatim}
-
-To ensure that \gls{bib2gls} can find out which entries have been
-used in the document, you need the \pkgopt{record} package option:
-\begin{verbatim}
-\usepackage[record]{glossaries-extra}
-\end{verbatim}
-If this option's value is omitted (as above), the normal indexing
-will be switched off, since \gls{bib2gls} can also sort the entries and
-collate the locations.
-
-If you still want to use an indexing application (for example, you
-need a custom \gls{xindy} rule), then just use
-\pkgopt[hybrid]{record} and continue to use \cs{makeglossaries}
-and \cs{printglossary} (or \cs{printglossaries}), but you also need
-to instruct \gls{bib2gls} to omit sorting to save time and
-to prevent the \gloskey{sort} key from being set.
-
-The \texttt{.glstex} file created by \gls{bib2gls} is loaded using:
-\begin{definition}[\DescribeMacro\glsxtrresourcefile]
-\cs{glsxtrresourcefile}\oarg{options}\marg{filename}
-\end{definition}
-(Don't include the file extension in \meta{filename}.)
-There's a shortcut version (recommended over the above) that sets \meta{filename} to use \cs{jobname}:
-\begin{definition}[\DescribeMacro\GlsXtrLoadResources]
-\cs{GlsXtrLoadResources}\oarg{options}
-\end{definition}
-On the first use, this command is a shortcut for
-\begin{alltt}
-\cs{glsxtrresourcefile}\oarg{options}\{\cs{jobname}\}
-\end{alltt}
-On subsequent use,\footnote{Version 1.11 only allowed one use
-of \cs{GlsXtrLoadResources} per document.}\ this command is a shortcut for
-\begin{alltt}
-\cs{glsxtrresourcefile}\oarg{options}\{\cs{jobname}-\meta{n}\}
-\end{alltt}
-where \meta{n} is the current value of
-\begin{definition}
-\cs{glsxtrresourcecount}
-\end{definition}
-which is incremented at the end of \cs{GlsXtrLoadResources}.
-Any advisory notes regarding \cs{glsxtrresourcefile} also
-apply to \cs{GlsXtrLoadResources}.
-
-The \cs{glsxtrresourcefile} command writes the line
-\begin{alltt}
-\cs{glsxtr@resource}\marg{options}\marg{filename}
-\end{alltt}
-to the \texttt{.aux} file and will input
-\meta{filename}\texttt{.glstex} if it exists.\footnote{v1.08 assumed
-\meta{filename}\texttt{.tex} but that's potentially dangerous if,
-for example, \meta{filename} happens to be the same as \cs{jobname}.
-The \texttt{.glstex} extension was enforced by version 1.11.}
-
-Since the \texttt{.glstex} file won't exist on the first \LaTeX\ run, the
-\pkgopt{record} package option additionally switches on
-\pkgopt[warn]{undefaction}. Any use of commands like \cs{gls} or
-\cs{glstext} will produce ?? in the document, since the entries are
-undefined at this point. Once \gls{bib2gls} has created the
-\texttt{.glstex} file the references should be resolved.
+in the \app{bib2gls} \ctansupportmirror{bib2gls/bib2gls.pdf}{manual}
+\texdocref{bib2gls}
+
+\hypertarget{examplebib}{}An example of the contents of \ext{bib} file that stores
+glossary entries that can be extracted with \app{bib2gls} called,
+say, \filefmt{terms.bib}:
+\newcommand{\termsbibcontent}{%
+\atentry{entry}\marg{bird,\newline\space
+ \gloskeyval{name}{bird},\newline\space
+ \gloskeyval{description}{feathered animal},\newline\space
+ \gloskeyval{see}{[see also]duck,goose}\newline
+}
+\codepar
+\atentry{entry}\marg{duck,\newline\space
+ \gloskeyval{name}{duck},\newline\space
+ \gloskeyval{description}{a waterbird with short legs}\newline
+}
+\codepar
+\atentry{entry}\marg{goose,\newline\space
+ \gloskey{name}=\glsquote{goose},\newline\space
+ \gloskey{plural}=\glsquote{geese},\newline\space
+ \gloskeyval{description}{a waterbird with a long neck}\newline
+}%
+}%
+\begin{codebox}
+\termsbibcontent
+\end{codebox}%
+The following provides some abbreviations in a file called,
+say, \filefmt{abbrvs.bib}:
+\newcommand{\abbrvsbibcontent}{%
+\atentry{string}\marg{ssi=\marg{server-side includes}}\newline
+\atentry{string}\marg{html=\marg{hypertext markup language}}
+\codepar
+\atentry{abbreviation}\marg{shtml,\newline\space
+ \gloskey{short}=\glsquote{shtml},\newline\space
+ \gloskey{long}= ssi \# \glsquote{ enabled } \# html,\newline\space
+ \gloskeyval{description}{a combination of \gls{gls}\marg{html} and
+\gls{gls}\marg{ssi}}\newline
+}
+\codepar
+\atentry{abbreviation}\marg{html,\newline\space
+ \gloskey{short} =\glsquote{html},\newline\space
+ \gloskey{long} = html,\newline\space
+ \gloskeyval{description}{a markup language for creating web
+pages}\newline
+}
+\codepar
+\atentry{abbreviation}\marg{ssi,\newline\space
+ \gloskey{short}=\glsquote{ssi},\newline\space
+ \gloskey{long} = ssi,\newline\space
+ \gloskeyval{description}{a simple interpreted server-side
+scripting language}\newline
+}%
+\codepar
+\atentry{abbreviation}\marg{xml,\newline\space
+ \gloskey{short}=\marg{xml},
+ \gloskey{long}=\marg{extensible markup language},
+ \gloskey{description}=\marg{a simple text-base format for
+ representing structured information}
+}%
+}%
+\begin{codebox}
+\abbrvsbibcontent
+\end{codebox}%
+The above defines \ext{bib} strings (with \atentry{string}) and uses
+string concatenation (with \code{\#}), which is a \BibTeX\
+feature. Another supported \ext{bib} feature is \atentry{preamble},
+which may be used to provide command definitions.
+
+Here are some symbols in a file called,
+say, \filefmt{symbols.bib}:
+\newcommand{\symbolsbibcontent}{%
+\atentry{preamble}\marg{\glsquote{\cmd{providecommand}\marg{\cmd{mtx}}[1]\marg{\cmd{boldsymbol}\marg{\#1}}}}
+\codepar
+\atentry{symbol}\marg{M,\newline\space
+ \gloskeyval{name}{\cmd{ensuremath}\marg{\cmd{mtx}\marg{M}}},\newline\space
+ \gloskeyval{description}{a matrix}\newline
+}
+\codepar
+\atentry{symbol}\marg{v,\newline\space
+ \gloskeyval{name}{\cmd{ensuremath}\marg{\cmd{vec}\marg{v}}},\newline\space
+ \gloskeyval{description}{a vector}\newline
+}
+\codepar
+\atentry{symbol}\marg{S,\newline\space
+ \gloskeyval{name}{\cmd{ensuremath}\marg{\cmd{mathcal}\marg{S}}},\newline\space
+ \gloskeyval{description}{a set}\newline
+}%
+}
+\begin{codebox}
+\symbolsbibcontent
+\end{codebox}%
+
+To ensure that \app{bib2gls} can find out which entries have been
+used in the document, you need the \opt{record} package option:
+\begin{codebox}
+\cmd{usepackage}\oarg{\opt{record}}\marg{glossaries-extra}
+\end{codebox}
+If you are using \sty{hyperref}, you may prefer to use
+\opteqvalref{record}{nameref}.
+
+The \ext{glstex} file created by \app{bib2gls} is loaded using:
+\cmddef{glsxtrresourcefile}
+where \meta{basename} is the basename (without the extension) of the
+\ext{glstex} file. This command will redefine \gls{glsindexingsetting}
+to \code{bib2gls} (or \code{bib2gls-xindy} or
+\code{bib2gls-makeindex} if \opteqvalref{record}{hybrid}).
+There's a shortcut version:
+\cmddef{GlsXtrLoadResources}
+This internally uses \gls{glsxtrresourcefile} and sets the
+\meta{basename} to \gls{jobname} in the first instance and to
+\code{\gls{jobname}-\meta{n}} on subsequent instances (where
+\meta{n} is incremented at the end of every \gls{GlsXtrLoadResources}).
+For example:
+\begin{codebox}
+\cmd{usepackage}\oarg{record}\marg{glossaries-extra}
+\gls{GlsXtrLoadResources}\oarg{\resourceoptvalm{src}{terms,moreterms}}
+\gls{GlsXtrLoadResources}\oarg{\resourceoptvalm{src}{symbols,constants}}
+\gls{GlsXtrLoadResources}\oarg{\resourceoptvalm{src}{abbreviations}}
+\end{codebox}
+is equivalent to:
+\begin{codebox}
+\cmd{usepackage}\oarg{record}\marg{glossaries-extra}
+\gls{glsxtrresourcefile}\oarg{\resourceoptvalm{src}{terms,moreterms}}\marg{\gls{jobname}}
+\gls{glsxtrresourcefile}\oarg{\resourceoptvalm{src}{symbols,constants}}\marg{\gls{jobname}-1}
+\gls{glsxtrresourcefile}\oarg{\resourceoptvalm{src}{abbreviations}}\marg{\gls{jobname}-2}
+\end{codebox}
+If required, the value of \meta{n} is stored in the count register:
+\cmddef{glsxtrresourcecount}
+although there should be little need to use this.
+
+\begin{information}
+Since \gls{GlsXtrLoadResources} is more convenient to use than
+\gls{glsxtrresourcefile}, all examples use
+\gls{GlsXtrLoadResources}.
+\end{information}
+
+The \gls{glsxtrresourcefile} command writes the following to
+the \ext{aux} file:
+\cmddef{glsxtr@resource}
+and will input \metafilefmt{}{filename}{.glstex} if it exists.
+(Version 1.08 assumed \metafilefmt{}{filename}{.tex} but that's
+potentially dangerous if, for example, \meta{filename} happens to be
+the same as \gls{jobname}. The \ext+{glstex} extension was enforced
+by version 1.11.)
+
+If you are using or developing a build system that needs to know
+which applications to run as part of the document build, you can
+search the \ext{aux} for for instances of \gls{glsxtr@resource}. For
+example, using \app{arara}:
+\begin{codebox}
+\% arara: bib2gls if found("aux", "glsxtr@resource")
+\end{codebox}
+
+Since the \ext{glstex} file won't exist on the first \LaTeX\ run, the
+\opt{record} package option additionally switches on
+\opteqvalref{undefaction}{warn}. Any use of commands like \gls{gls} or
+\gls{glstext} will produce \idx{unknowntag} in the document, since the entries are
+undefined at this point. Once \app{bib2gls} has created the
+\ext{glstex} file the references should be resolved.
This may cause a shift in the locations if the actual text produced
once the entry is defined is significantly larger than the
-placeholder ?? (as this can alter the page breaking).
+placeholder \idx{unknowntag} (as this can alter the page breaking).
+
+Note that as from v1.12, \gls{glsxtrresourcefile} temporarily
+switches the category code of \code{@} to 11 (letter) while it
+reads the file to allow for any internal commands.
+
+\begin{information}
+The package options \opteqvalref{record}{only} and
+\opteqvalref{record}{nameref} automatically load
+\sty{glossaries-extra-bib2gls}, which provides additional commands
+that are useful with \app{bib2gls}. Since they cover sorting and
+\idxpl{locationlist}, they're not relevant with the
+\opteqvalref{record}{hybrid} option.
+\end{information}
+
+These commands are provided by \sty{glossaries-extra}
+for use with \app{bib2gls}.
+
+The information provided with \gls{GlsXtrLoadResources}
+is written to the \ext{aux} file using:
+\begin{compactcodebox}
+\cmd{protected@write}\cmd{@auxout}\marg{\gls{glsxtrresourceinit}}\margm{information}
+\end{compactcodebox}
+where \meta{information} is the information to pass to
+\app{bib2gls}. The command in the second argument:
+\cmddef{glsxtrresourceinit}
+may be used to temporarily redefine commands before the
+information is written to the file. This does nothing
+by default, but may be redefined to allow the use of
+short commands for convenience. For example, with:
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{glsxtrresourceinit}}\marg{\cmd{let}\gls{u}\gls{glshex}}
+\end{codebox}
+you can just use, for example, \code{\gls{u} E6} instead of
+\code{\gls{string}\gls{u}E6} in the custom rule. This redefinition of \gls{u}
+is scoped so its original definition is restored after the write operation.
-Note that as from v1.12, \cs{glsxtrresourcefile} temporarily
-switches the category code of \texttt{@} to 11 (letter) while it
-reads the file to allow for any internal commands stored in the
-location field.
+\cmddef{glsxtrMFUsave}
+If you have \sty{mfirstuc} v2.08+, this command will be used on the
+first instance of \gls{glsxtrresourcefile}, and will add
+\gls{MFUsave} to the begin document hook and then disable itself.
+This is provided to help \app{bib2gls} v3.0+ pick up any of
+\sty{mfirstuc}['s] exclusions, blockers and mappings to assist with
+its \idx{sentencecase} function. The assumption is that all
+exclusions, blockers and mappings will be set up in the preamble. If
+there are any within the \env{document} environment that you want
+\app{bib2gls} to be aware of, redefine this command to do nothing
+before the first instance of \gls{glsxtrresourcefile} (or
+\gls{GlsXtrLoadResources}) and use \gls{MFUsaveatend} instead.
+
+If you have multiple resource commands and you want a default set of
+options you can supply them in the definition of:
+\cmddef{GlsXtrDefaultResourceOptions}
+For example:
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{GlsXtrDefaultResourceOptions}}\marg{\resourceoptval{selection}{all}}
+\end{codebox}
+This should be done before the resource commands to which the
+options should apply.
+
+\section{Indexing (Recording)}
+\label{sec:bib2glsindexing}
+
+As with \app{makeindex} and \app{xindy}, the \idx{glslike} and
+\idx{glstextlike} commands automatically index, but the underlying
+\idx{indexing} mechanism is more like that used with
+\gls{makenoidxglossaries}. Each indexing instance creates a \record\
+in the \ext+{aux} file, which \app{bib2gls} can then pick up when it
+parses the \ext{aux} file. Each record has an associated format (the
+\idx{locationencap}) which can be set with the \glsopt{format} key
+and an associated \idx{locationcounter} (as with the other indexing
+methods).
+
+The formatted \idx{locationlist} is stored in the \gloskey{location}
+field (unless \resourceoptval{save-locations}{false}). Additionally,
+the individual locations are stored in the \glosfield{loclist} field as
+an \sty{etoolbox} internal list (as with \gls{makenoidxglossaries}).
+This may be used to pick out individual locations to avoid the
+complexity of parsing the formatted list.
+
+See the \app{bib2gls} manual for information on how to separate the
+\idx{locationlist} into groups associated with different counters.
\section{Selection}
\label{sec:bib2glsselection}
-The default behaviour is for \gls{bib2gls} to select all entries
-that have a record in the \texttt{.aux} file, and any dependent
-entries (including parent and cross-references). The
-\texttt{glsignore} format (for example,
-\verb|\gls[format=glsignore]{duck}|) is recognised by \gls{bib2gls}
-as a special ignored record. This means that it will match
-the selection criteria but the record won't be added to
-the location list. This means that you won't get spurious
-commas in the location list (as can happen with the other indexing
+The default behaviour is for \app{bib2gls} to select all entries
+that have a \record\ in the \ext{aux} file, and any dependent
+entries (including parent and cross-references). The
+\code{glsignore} format (for example,
+\code{\gls{gls}\oarg{\glsoptval{format}{glsignore}}\marg{duck}}) is
+recognised by \app{bib2gls} as a special
+\idxc{ignoredlocation}{ignored record}. This means that it will
+match the selection criteria but the record won't be added to the
+location list. This means that you won't get spurious commas in the
+\idx{locationlist} (as can happen with the other \idx{indexing}
methods), so you can do, for example,
-\begin{verbatim}
-\GlsXtrSetDefaultNumberFormat{glsignore}
-\end{verbatim}
+\begin{codebox}
+\gls{GlsXtrSetDefaultNumberFormat}\marg{glsignore}
+\end{codebox}
at the start of the front matter and
-\begin{verbatim}
-\GlsXtrSetDefaultNumberFormat{glsnumberformat}
-\end{verbatim}
+\begin{codebox}
+\gls{GlsXtrSetDefaultNumberFormat}\marg{glsnumberformat}
+\end{codebox}
at the start of the main matter to prevent any records in the
-front matter from occurring in the location lists.
-
-\begin{important}
-Note that commands like \cs{glsaddall} and \cs{glsaddallunused} don't work with \gls{bib2gls} as the command
-has to iterate over the internal lists of defined entry labels, which will be empty on the first
-run and on subsequent runs will only contain those entries that have
-been selected by \gls{bib2gls}.
-\end{important}
-
-If you want to add all
-entries to the glossary, you need to tell \gls{bib2gls} this in the
-options list. For example:
-\begin{verbatim}
-\GlsXtrLoadResources[src={terms},selection={all}]
-\end{verbatim}
-This will add all entries, regardless of whether or not they
-have any records in the \texttt{.aux} file. Those that don't
-have any records will have an empty location list.
-See the \gls{bib2gls} user manual for more details of this option.
+front matter from occurring in the \idxpl{locationlist}.
+
+\begin{warning}
+Commands like \gls{glsaddall} and \gls{glsaddallunused} don't work
+with \app{bib2gls} as the command has to iterate over each
+\idx{glossary}['s] internal lists of defined entry labels, which
+will be empty on the first run and on subsequent runs will only
+contain those entries that have been selected by \app{bib2gls}.
+Use \resourceoptval{selection}{all} to select all entries instead.
+\end{warning}
+
+The \resourceopt{selection} option indicates which entries should be
+selected from the \ext{bib} files (listed in \resourceopt{src}).
+For example, \resourceoptval{selection}{all} indicates to select all
+entries, regardless of whether or not the entries have been
+referenced in the document. This will lead to empty
+\idxpl{locationlist} for some (or all) entries.
+The default setting is \resourceoptval{selection}{recorded and
+deps}, which indicates to select all entries that have \records\ and
+any dependent entries. See the \app{bib2gls} user manual for more
+details of this option.
\section{Sorting and Displaying the Glossary}
\label{sec:bib2glssortprint}
-There are many sorting options provided by \gls{bib2gls}.
+With \app{makeindex} and \app{xindy}, the terms (read from the
+associated input file) are sorted and the code to typeset the
+\idx{glossary} is written to an output file, which is then input by
+\gls{printglossary}. With \app{bib2gls}, the entries supplied in the
+\ext{bib} files are sorted and the entry definition code
+(\gls{longnewglossaryentry} or \gls{newabbreviation}) is written to
+the \ext{glstex} file in the order obtained by sorting. This means
+that the \idx{glossary}['s] internal list is in the required order,
+so the \idx{glossary} can be displayed with
+\gls{printunsrtglossary} (see \sectionref{sec:printunsrt}).
+
+The \idx{indexing} information, such as the \idx{locationlist} or
+letter groups, is stored in fields such as \gloskey{location} or
+\gloskey{group} (where applicable), so the information can be
+included by \gls{printunsrtglossary}, but it means that the
+information is also available for use elsewhere in the document (so
+the \opt{savenumberlist} package option provided by \sty{glossaries}
+is redundant).
+
+There are many sorting options provided by \app{bib2gls}.
The default is to sort according to the system locale.
If the document has a language setting, you can use
-\texttt{sort=doc} to instruct \gls{bib2gls} to sort according to
-that. (The language tag obtained from \sty{tracklang}'s
-interface is written to the \texttt{.aux} file.) For a multilingual
+\resourceoptval{sort}{doc} to instruct \app{bib2gls} to sort according to
+that. (The language tag obtained from \sty{tracklang}['s]
+interface is written to the \ext{aux} file.) For a multilingual
document you need to explicitly set the locale using a well-formed
language tag. For example:
-\begin{verbatim}
-\GlsXtrLoadResources[
- src=terms, % data in terms.bib
- sort=de-DE-1996 % sort according to this locale
-]
-\end{verbatim}
-The locale-sensitive sort methods usually ignore most
+\begin{codebox}
+\gls{GlsXtrLoadResources}\oarg{
+ \resourceoptval{src}{terms}, \comment{ data in terms.bib}
+ \resourceoptval{sort}{de-DE-1996} \comment{ sort according to this locale}
+}
+\end{codebox}
+The locale-sensitive sort methods usually ignore most
punctuation so for lists of symbols you may find it more
appropriate to use one of the letter-base sort methods
that sort according to the Unicode value of each character.
Alternatively you can provide a custom rule.
-See the \gls{bib2gls} manual for full details of all the available
+See the \app{bib2gls} manual for full details of all the available
sort methods.
-Since the \texttt{.glstex} file only defines those references
-required
-within the document (selected according to the \texttt{selection}
-option) and the definitions have been written in the
-order corresponding to \gls{bib2gls}['s] sorted list, the glossaries can
-simply be displayed using \cs{printunsrtglossary} (or
-\cs{printunsrtglossaries}), described in \sectionref{sec:printunsrt}.
-
-Suppose the \texttt{.bib} examples shown above have been stored in
-the files \texttt{terms.bib}, \texttt{abbrvs.bib} and
-\texttt{symbols.bib} which may either be in the current directory or
-on \TeX's path. Then the document might look like:
-\begin{verbatim}
-\documentclass{article}
-
-\usepackage[record]{glossaries-extra}
-
-\setabbreviationstyle{long-short-desc}
-
-\GlsXtrLoadResources[src={terms,abbrvs,symbols}]
-
-\begin{document}
-\gls{bird}
-
-\gls{shtml}
-
-\gls{M}
-
-\printunsrtglossaries
-\end{document}
-\end{verbatim}
+Suppose the \ext{bib} examples shown \hyperlink{examplebib}{earlier}
+have been stored in the files \filefmt{terms.bib},
+\filefmt{abbrvs.bib} and \filefmt{symbols.bib} which may either be in
+the current directory or on \TeX's path. Then the document might
+look like:
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\codepar
+\cmd{usepackage}\oarg{record}\marg{glossaries-extra}
+\codepar
+\gls{setabbreviationstyle}\marg{\abbrstyle{long-short-sc-desc}}
+\codepar
+\gls{GlsXtrLoadResources}\oarg{\resourceoptval{src}{terms,abbrvs,symbols}}
+\codepar
+\cbeg{document}
+\gls{gls}\marg{bird}
+\codepar
+\gls{gls}\marg{shtml}
+\codepar
+\gls{gls}\marg{M}
+\codepar
+\gls{gls}\marg{printunsrtglossaries}
+\cend{document}
+\end{codebox}
The document build process (assuming the document is called
-\texttt{mydoc}) is:
-\begin{verbatim}
+\filefmt{mydoc}) is:
+\begin{terminal}
pdflatex mydoc
bib2gls mydoc
pdflatex mydoc
-\end{verbatim}
+\end{terminal}
+\begin{resultbox}
+\createexample*[
+ label={ex:bib2gls},
+title={Using \appfmt{bib2gls}: one resource set},
+description={Example document using bib2gls with one resource set},
+arara={pdflatex,bib2gls,pdflatex,pdfcrop}
+]
+{\cbeg{filecontents*}{terms.bib}^^J%
+\termsbibcontent^^J%
+\cend{filecontents*}^^J%
+\cbeg{filecontents*}{abbrvs.bib}^^J%
+\abbrvsbibcontent^^J%
+\cend{filecontents*}^^J%
+\cbeg{filecontents*}{symbols.bib}^^J%
+\symbolsbibcontent^^J%
+\cend{filecontents*}^^J%
+\cmd{usepackage}\oarg{record}\marg{glossaries-extra}
+\codepar
+\gls{setabbreviationstyle}\marg{long-short-sc-desc}
+\codepar
+\gls{GlsXtrLoadResources}\oarg{src=\marg{terms,abbrvs,symbols}}
+\codepar
+}
+{\gls{gls}\marg{bird}
+\codepar
+\gls{gls}\marg{shtml}
+\codepar
+\gls{gls}\marg{M}
+\codepar
+\gls{printunsrtglossaries}
+}
+\end{resultbox}
This creates a single glossary containing the entries:
-\texttt{bird}, \texttt{duck}, \texttt{goose},
-\texttt{html}, \texttt{M}, \texttt{shtml} and \texttt{ssi} (in that
-order). The \texttt{bird}, \texttt{shtml} and \texttt{M} entries
-were added because \gls{bib2gls} detected (from the \texttt{.aux}
+\code{bird}, \code{duck}, \code{goose},
+\code{html}, \code{M}, \code{shtml} and \code{ssi} (in that
+order). The \code{bird}, \code{shtml} and \code{M} entries
+were added because \app{bib2gls} detected (from the \ext{aux}
file) that they had been used in the document. The other entries
-were added because \gls{bib2gls} detected (from the \texttt{.bib}
+were added because \app{bib2gls} detected (from the \ext{bib}
files) that they are referenced by the used entries. In the case of
-\texttt{duck} and \texttt{goose}, they are in the \gloskey{see}
-field for \texttt{bird}. In the case of \texttt{ssi} and
-\texttt{html}, they are referenced in the \gloskey{description}
-field of \texttt{shtml}. These cross-referenced entries won't have a
-location list when the glossary is first displayed, but depending on
-how they are referenced, they may pick up a location list on the
-next document build.
+\code{duck} and \code{goose}, they are in the \gloskey{see}
+field for \code{bird}. In the case of \code{ssi} and
+\code{html}, they are referenced in the \gloskey{description}
+field of \code{shtml}. These cross-referenced entries won't have a
+\idx{locationlist} when the \idx{glossary} is first displayed, but depending on
+how they are referenced, they may pick up a \idx{locationlist} on the
+next document build. The \code{xml} entry isn't required at all, and
+so hasn't been defined (from LaTeX's point of view).
The entries can be separated into different glossaries with
different sort methods:
-\begin{verbatim}
-\documentclass{article}
-
-\usepackage[record,abbreviations,symbols]{glossaries-extra}
-
-\setabbreviationstyle{long-short-desc}
-
-\GlsXtrLoadResources[src={terms},sort={en-GB},type=main]
-
-\GlsXtrLoadResources
- [src={abbrvs},sort={letter-nocase},type=abbreviations]
-
-\GlsXtrLoadResources
- [src={symbols},sort={use},type={symbols}]
-
-\begin{document}
-\gls{bird}
-
-\gls{shtml}
-
-\gls{M}
-
-\printunsrtglossaries
-\end{document}
-\end{verbatim}
-
-Or you can have multiple instance of \cs{GlsXtrLoadResources}
-with the same \texttt{type}, which will produce a glossary
-with ordered sub-blocks. For example:
-\begin{verbatim}
-\documentclass{article}
-
-\usepackage[record,style=indexgroup]{glossaries-extra}
-
-\setabbreviationstyle{long-short-desc}
-
-\GlsXtrLoadResources
- [src={abbrvs},sort={letter-nocase},type=main,
- group={Abbreviations}]
-
-\GlsXtrLoadResources
- [src={symbols},sort={use},type=main,
- group={Symbols}]
-
-\GlsXtrLoadResources[src={terms},sort={en-GB},type=main]
-
-\begin{document}
-\gls{bird}
-
-\gls{shtml}
-
-\gls{M}
+\begin{codebox}
+\cmd{usepackage}\oarg{\opt{record},\opt{abbreviations},\opt{symbols}}\marg{glossaries-extra}
+\codepar
+\gls{setabbreviationstyle}\marg{\abbrstyle{long-short-sc-desc}}
+\codepar
+\gls{GlsXtrLoadResources}\oarg{\resourceoptval{src}{terms},\resourceoptval{sort}{en-GB},\resourceoptval{type}{main}}
+\codepar
+\gls{GlsXtrLoadResources}
+ \oarg{\resourceoptval{src}{abbrvs},\resourceoptval{sort}{letter-nocase},\resourceoptval{type}{abbreviations}}
+\codepar
+\gls{GlsXtrLoadResources}
+ \oarg{\resourceoptval{src}{symbols},\resourceoptval{sort}{use},\resourceoptval{type}{symbols}}
+\codepar
+\cbeg{document}
+\gls{gls}\marg{bird}
+\codepar
+\gls{gls}\marg{shtml}
+\codepar
+\gls{gls}\marg{M}
+\codepar
+\gls{printunsrtglossaries}
+\cend{document}
+\end{codebox}
+
+\begin{resultbox}
+\createexample*
+[title={Using \appfmt{bib2gls}: multiple resource sets},
+ label={ex:bib2glsmultiresources},
+description={Example document using bib2gls with multiple resource sets},
+arara={pdflatex,bib2gls,pdflatex,pdfcrop}
+]
+{\cbeg{filecontents*}{terms.bib}^^J%
+\termsbibcontent
+\cend{filecontents*}^^J%
+\cbeg{filecontents*}{abbrvs.bib}^^J%
+\abbrvsbibcontent
+\cend{filecontents*}^^J%
+\cbeg{filecontents*}{symbols.bib}^^J%
+\symbolsbibcontent^^J%
+\cend{filecontents*}^^J%
+\cmd{usepackage}\oarg{record,abbreviations,symbols}\marg{glossaries-extra}
+\codepar
+\gls{setabbreviationstyle}\marg{long-short-sc-desc}
+\codepar
+\gls{GlsXtrLoadResources}\oarg{src=terms,sort=en-GB,type=main}
+\codepar
+\gls{GlsXtrLoadResources}
+ \oarg{src=abbrvs,sort=letter-nocase,type=abbreviations}
+\codepar
+\gls{GlsXtrLoadResources}
+ \oarg{src=symbols,sort=use,type=symbols}
+}
+{\gls{gls}\marg{bird}
+\codepar
+\gls{gls}\marg{shtml}
+\codepar
+\gls{gls}\marg{M}
+\codepar
+\gls{printunsrtglossaries}
+}
+\end{resultbox}
+
+
+Or you can have multiple instance of \gls{GlsXtrLoadResources}
+with the same \resourceopt{type}, which will produce a
+\idx{glossary} with ordered sub-blocks. For example:
+\begin{codebox}
+\cmd{usepackage}\oarg{\opt{record},\optval{style}{\glostyle{indexgroup}}}\marg{glossaries-extra}
+\codepar
+\gls{setabbreviationstyle}\marg{\abbrstyle{long-short-sc-desc}}
+\codepar
+\gls{GlsXtrLoadResources}
+ \oarg{\resourceoptval{src}{abbrvs},\resourceoptval{sort}{letter-nocase},\resourceoptval{type}{main},
+ \resourceoptval{group}{abbreviations}}
+\gls{glsxtrsetgrouptitle}\marg{abbreviations}\marg{Abbreviations}
+\codepar
+\gls{GlsXtrLoadResources}
+ \oarg{\resourceoptval{src}{symbols},\resourceoptval{sort}{use},\resourceoptval{type}{main},
+ \resourceoptval{group}{symbols}}
+\gls{glsxtrsetgrouptitle}\marg{symbols}\marg{Abbreviations}
+\codepar
+\gls{GlsXtrLoadResources}\oarg{\resourceoptval{src}{terms},\resourceoptval{sort}{en-GB},\resourceoptval{type}{main}}
+\codepar
+\cbeg{document}
+\gls{gls}\marg{bird}
+\codepar
+\gls{gls}\marg{shtml}
+\codepar
+\gls{gls}\marg{M}
+\codepar
+\gls{printunsrtglossaries}
+\cend{document}
+\end{codebox}
+This sets the \gloskey{group} field for each resource set to the
+label given by the \resourceopt{group} resource option.
-\printunsrtglossaries
-\end{document}
-\end{verbatim}
This will result in a glossary where the first group has
-the title \qt{Abbreviations}, the second group has the
-title \qt{Symbols} and then follow the usual letter groups.
-Note that for this example to work, you must run \gls{bib2gls}
-with the \verb|--group| (or \verb|-g|) switch. For example,
-if the document is called \texttt{myDoc.tex}:
-\begin{verbatim}
+the label \code{abbreviations} and title \qt{Abbreviations}, the second group has the
+label \code{symbols} and title \qt{Symbols} and then follow the usual letter groups.
+Note that for this example to work, you must run \app{bib2gls}
+with the \switch{group} (or \switch{g}) switch. For example,
+if the document is called \filefmt{myDoc.tex}:
+\begin{terminal}
pdflatex myDoc
-bib2gls -g myDoc
+bib2gls \switch{g} myDoc
pdflatex myDoc
-\end{verbatim}
-The value of the \gloskey{group} field must always be a label. You
-can set the corresponding title with \cs{glsxtrsetgrouptitle}
+\end{terminal}
+\begin{resultbox}
+\createexample*[title={Using \appfmt{bib2gls}: sub-blocks},
+ label={ex:bib2glssubblocks},
+description={Example document using bib2gls with multiple resource
+sets for a single glossary to create a glossary with sub-blocks},
+arara={pdflatex,bib2gls: { group: on },pdflatex,pdfcrop}
+]
+{\cbeg{filecontents*}{terms.bib}^^J%
+\termsbibcontent
+\cend{filecontents*}^^J%
+\cbeg{filecontents*}{abbrvs.bib}^^J%
+\abbrvsbibcontent
+\cend{filecontents*}^^J%
+\cbeg{filecontents*}{symbols.bib}^^J%
+\symbolsbibcontent^^J%
+\cend{filecontents*}^^J%
+\cmd{usepackage}\oarg{record,style=indexgroup}\marg{glossaries-extra}
+\codepar
+\gls{setabbreviationstyle}\marg{long-short-sc-desc}
+\codepar
+\gls{GlsXtrLoadResources}^^J
+ \oarg{src={abbrvs},sort=letter-nocase,type=main,^^J
+ group={abbreviations}}^^J%
+\gls{glsxtrsetgrouptitle}\marg{abbreviations}\marg{Abbreviations}
+\codepar
+\gls{GlsXtrLoadResources}^^J
+ \oarg{src={symbols},sort=use,type=main,group=symbols}^^J%
+\gls{glsxtrsetgrouptitle}\marg{symbols}\marg{Abbreviations}
+\codepar
+\gls{GlsXtrLoadResources}\oarg{src={terms},sort=en-GB,type=main}
+}
+{\gls{gls}\marg{bird}
+\codepar
+\gls{gls}\marg{shtml}
+\codepar
+\gls{gls}\marg{M}
+\codepar
+\gls{printunsrtglossaries}
+}
+\end{resultbox}
+
+\begin{important}
+The value of the \gloskey{group} field must always be a label (so
+avoid special characters). You
+can set the corresponding title with \code{glsxtrsetgrouptitle}
(see \sectionref{sec:glosstylemods}). If no title is set then the
label is used as the group title.
+\end{important}
You can provide your own custom sort rule. For example,
if you are using \XeLaTeX\ or \LuaLaTeX:
-\begin{alltt}
-\cs{GlsXtrLoadResources}[
- src=terms, % entries in terms.bib
- sort=custom, % custom sort rule
- sort-rule=\{% required with sort=custom
- < \ae;\AE\ < a;\'a;\aa;\"a,\"A;\'A;\AA;\"A < b,B
+\begin{codebox}
+\gls{GlsXtrLoadResources}\oarg{
+ \resourceoptvalm{src}{terms}, \comment{entries in terms.bib}
+ \resourceoptval{sort}{custom}, \comment{custom sort rule}
+ \resourceoptvalm{sort-rule}{\comment{required with sort=custom}
+ < \ae;\AE\ < a;\'a;\aa;\"a,\"A;\'A;\AA;\"A < b,B
< c;\'c,C;\'C < d,D < e;\'e,E;\'E < f,F < g,G
- < h,H < i;\'i,I;\'I < j,J < l;\l,L;\L < m,M < n,N
- < o;\"o;\o,O;\"O;\O\ < p,P < q,Q < r,R < s;\'s,S;\'S
+ < h,H < i;\'i,I;\'I < j,J < l;\l,L;\L < m,M < n,N
+ < o;\"o;\o,O;\"O;\O\ < p,P < q,Q < r,R < s;\'s,S;\'S
< t,T < u;\'u,U;\'U < v,V < w,W < x,X < y,Y <
- z;\.z,Z;\.Z
- \}
-]
-\end{alltt}
-Remember that if you are using \sty{inputenc} then extended
-characters, such as \'e or \o, are active and will expand when
-written to the \texttt{.aux} file. So with PDF\LaTeX\ the
-above would have to be changed to protect against expansion.
-Some of the options, including \texttt{sort-rule},
+ z;\.z,Z;\.Z
+ }
+}
+\end{codebox}
+
+\begin{warning}
+With old versions of the \LaTeX\ kernel, \idx{utf8} characters,
+such as \'e or \o, will expand when written to the \ext{aux} file.
+\end{warning}
+
+Some of the options, including \resourceopt{sort-rule},
allow Unicode characters to be indicated in the format
-\cs{u}\meta{hex} (or \cs{u}~\meta{hex}) \textbf{in the \texttt{.aux} file}. \gls{bib2gls}
+\gls{u}\meta{hex} (or \gls{u}~\meta{hex}). \app{bib2gls}
will recognise this as the character
-given by the hexadecimal value \meta{hex}. The \cs{u} also needs
-protection from expansion, so with a non-Unicode aware
-engine, the character \ae\ needs to be written as
-\texttt{\cs{string}\cs{u}E6} and so on. This is quite cumbersome,
-but you can use the shortcut \texttt{\ics{glshex} E6} instead, so
-the above needs to be written as:
-\begin{alltt}
-\cs{GlsXtrLoadResources}[
- src=terms, % entries in terms.bib
- sort=custom, % custom sort rule
- sort-rule=\{% required with sort=custom
- < \cs{glshex} E6;\cs{glshex} C6
- < a;\cs{glshex} E1;\cs{glshex} E5,\cs{glshex} E4,A;\cs{glshex} C1;\cs{glshex} C5;\cs{glshex} C4
- < b,B < c;\cs{glshex} 0107,C;\cs{glshex} 0106 < d,D
- < e;\cs{glshex} E9,E;\cs{glshex} C9 < f,F < g,G
- < h,H < i;\cs{glshex} ED,I;\cs{glshex} CD < j,J
- < l;\cs{glshex} 0142,L;\cs{glshex} 0141 < m,M < n,N
- < o;\cs{glshex} F6;\cs{glshex} F8,O;\cs{glshex} D6;\cs{glshex} D8
- < p,P < q,Q < r,R < s;\cs{glshex} 013F,S;\cs{glshex} 015A
- < t,T < u;\cs{glshex} FA,U;\cs{glshex} DA < v,V < w,W < x,X < y,Y
- < z;\cs{glshex} 017C,Z;\cs{glshex} 017B
- \}]
-\end{alltt}
-
-\section{The \headingsty{glossaries-extra-bib2gls} package}
-\label{sec:bib2glssty}
-
-The package option \pkgopt[only]{record} (or simply \pkgopt{record})
-automatically loads the supplementary package
-\sty{glossaries-extra-bib2gls}, which provides some commands
-that are specific to \gls{bib2gls}. The package isn't
-loaded by \pkgopt[hybrid]{record} as that option is intended
-for sorting with \gls{makeindex} or \gls{xindy} and it is expected
-that the sorting will be switched off (with the resource option
-\texttt{sort=none}).
+given by the hexadecimal value \meta{hex}.
-If \sty{glossaries-extra-bib2gls} is loaded via the
-\pkgopt{record} package option then the check for associated
-language resource files (see \sectionref{sec:lang}) will also
-search for the existence of
-\texttt{glossariesxtr-}\meta{script}\texttt{.ldf} for each
-document dialect (where \meta{script} is the four letter
-script identifier, such as \texttt{Latn}).
-
-This package provides some shortcut commands that use
-\ics{printunsrtglossary} if the relevant package option has defined
-the associated glossary: \ics{printunsrtabbreviations},
-\ics{printunsrtacronyms}, \ics{printunsrtsymbols},
-\ics{printunsrtnumbers} and \ics{printunsrtindex}.
-
-The \pkgopt{savenumberlist} package option doesn't have any effect
-with \gls{bib2gls}. The location lists are saved by default, so
-\sty{glossaries-extra-bib2gls} patches \ics{glsentrynumberlist} and
-\ics{glsdisplaynumberlist} to work with the \gloskey{location} field
-
-\begin{definition}[\DescribeMacro\glsxtrprovidecommand]
-\cs{glsxtrprovidecommand}\marg{cs}\oarg{n}\oarg{default}\marg{definition}
-\end{definition}
-This command is intended for use in \texttt{@preamble}.
-It's simply defined to \cs{providecommand} in
-\sty{glossaries-extra-bib2gls} but \gls{bib2gls}['s] interpreter
-treats it as \cs{renewcommand}. This means that you can
-override \gls{bib2gls}['s] internal definition of a command
-without overriding the command definition in the document
-(if it's already defined before the resource file is input).
-For example
-\begin{verbatim}
-@preamble{"\glsxtrprovidecommand{\int}{integral}"}
-\end{verbatim}
-This will force \gls{bib2gls} to treat \cs{int} as the word
-\qt{integral} to assist sorting but if this preamble code is written
-to the \texttt{.glstex} file (as it is by default) then it won't
-override the current definition (provided by the kernel or redefined
-by a package).
+\begin{important}
+The \meta{options} provided to \gls{GlsXtrLoadResources} will expand
+as they are written to the \ext{aux} file (unless protected). This
+includes \gls{u}, so with a non-Unicode aware engine or where the
+document source is required to be \idx{ascii}, the character \ae\
+needs to be written as \code{\gls{string}\gls{u} E6} and so on.
+Alternatively, use the shortcut \code{\gls{string}\gls{u} E6}.
+\end{important}
-The helper commands in the resource files are defined using
-\cs{providecommand}. For many of them, if you want to provide an
-alternative definition then you need to define the command before
-the resource file is loaded. There are a few that may be redefined
-afterwards but if you use \cs{renewcommand} then you will get an
-error on the first \LaTeX\ run when the \texttt{.glstex} file
-doesn't exist. In this case, you may prefer to use:
-\begin{definition}[\DescribeMacro\glsrenewcommand]
-\cs{glsrenewcommand}\marg{cs}\oarg{n}\oarg{default}\marg{definition}
-\end{definition}
-This behaves like \cs{renewcommand} but only generates a warning
-rather than an error if the command isn't already defined so it
-won't interrupt the document build.
+For example, the above can be rewritten as:
+\begin{codebox}
+\gls{GlsXtrLoadResources}\oarg{
+ \resourceoptvalm{src}{terms}, \comment{entries in terms.bib}
+ \resourceoptval{sort}{custom}, \comment{custom sort rule}
+ \resourceoptvalm{sort-rule}{\comment{required with sort=custom}
+ < \gls{glshex} E6;\gls{glshex} C6
+ < a;\gls{glshex} E1;\gls{glshex} E5,\gls{glshex} E4,A;\gls{glshex} C1;\gls{glshex} C5;\gls{glshex} C4
+ < b,B < c;\gls{glshex} 0107,C;\gls{glshex} 0106 < d,D
+ < e;\gls{glshex} E9,E;\gls{glshex} C9 < f,F < g,G
+ < h,H < i;\gls{glshex} ED,I;\gls{glshex} CD < j,J
+ < l;\gls{glshex} 0142,L;\gls{glshex} 0141 < m,M < n,N
+ < o;\gls{glshex} F6;\gls{glshex} F8,O;\gls{glshex} D6;\gls{glshex} D8
+ < p,P < q,Q < r,R < s;\gls{glshex} 013F,S;\gls{glshex} 015A
+ < t,T < u;\gls{glshex} FA,U;\gls{glshex} DA < v,V < w,W < x,X < y,Y
+ < z;\gls{glshex} 017C,Z;\gls{glshex} 017B
+ }
+}
+\end{codebox}
-\begin{definition}[\DescribeMacro\GlsXtrIndexCounterLink]
-\cs{GlsXtrIndexCounterLink}\marg{text}\marg{label}
-\end{definition}
-If the \ics{hyperref} command has been defined (that is,
-\sty{hyperref} has been loaded before \styfmt{glossaries-extra})
-then this command checks for the existence of the
-\texttt{indexcounter} field. If this field is set for the entry
-given by \meta{label}, this command does
-\cs{hyperref}\texttt{[wrglossary.\meta{value}]\marg{text}}, where
-\meta{value} is the value of the \texttt{indexcounter} field. If the
-field isn't set or if \cs{hyperref} hasn't been defined, this just
-does \meta{text}. This command is provided for use with the
-\pkgopt{indexcounter} package option combined with \gls{bib2gls}['s]
-\texttt{save-index-counter} resource option. See the \gls{bib2gls}
-manual for further details (at least version 1.4).
-
-If you use the \texttt{set-widest} resource option, \gls{bib2gls}
-v1.8+ will now use:
-\begin{definition}[\DescribeMacro\glsxtrSetWidest]
-\cs{glsxtrSetWidest}\marg{type}\marg{level}\marg{text}
-\end{definition}
-(if it has been defined) to set the widest name for the given
-glossary type and level. This allows for both the \glostyle{alttree}
-style and the styles provided by \sty{glossary-longextra}, which
-need to know the widest name.
-
-If \gls{bib2gls} can't determine the widest name (typically because
-the name field consists of commands that aren't recognised by the
-interpreter) then \gls{bib2gls} v1.8+ will now use:
-\begin{definition}[\DescribeMacro\glsxtrSetWidestFallback]
-\cs{glsxtrSetWidestFallback}\marg{max depth}\marg{list}
-\end{definition}
-(if defined). Currently the maximum hierarchical depth \meta{max
-depth} may only be 0 or 2. This command requires commands provided
-by the \sty{glossaries-extra-stylemods} package with the
-\glostyle{alttree} style enabled. In this case, it may be simpler
-to just use \ics{glssetwidest}.
+\section{Record Counting}
+\label{sec:recordcount}
-\subsection{Supplemental Locations}
-\label{sec:supplocations}
+As from version 1.1 of \app{bib2gls}, you can save the total
+record count for each entry by invoking \app{bib2gls}
+with the \switch{record-count} or \switch{record-count-unit}
+switches. These options will ensure that when each entry
+is written to the \ext{glstex} file \app{bib2gls} will
+additionally set the following internal fields for that entry:
+\begin{itemize}
+\item \glosfield{recordcount}: set to the total
+number of \records\ found for the entry;
+\item \glosfield{recordcount.counter}: set to the total
+number of \records\ found for the entry for the given counter.
+\end{itemize}
+If \switch{record-count-unit} is used then additionally:
+\begin{itemize}
+\item \glosfield{recordcount.counter.location}: set to the total
+number of \records\ found for the entry for the given counter with the
+given location.
+\end{itemize}
+Only use the unit counting option if the locations don't contain any special
+characters. With \sty{hyperref} use \theHcountername\ rather than
+\thecountername. Otherwise, if you really need unit counting with locations
+that may contain formatting commands, then you can try redefining:
+\cmddef{glsxtrdetoklocation}
+so that it detokenizes \meta{location} but take care when
+using \gls{GlsXtrLocationRecordCount} with commands like
+\gls{thepage} as they can end up becoming detokenized too early.
+
+Note that the record count includes \locations\ that \app{bib2gls}
+discards, such as \idxc{ignoredlocation}{ignored records}, duplicates and partial
+duplicates (unless you filter them out with
+\switch{record-count-rule}). It doesn't include cross-reference records. For
+example, suppose a document has an entry with the label \code{bird}
+that is \recorded\ (\indexed) as follows:
+\begin{description}
+\item[Page 1] two (2) instances of \code{\gls{gls}\marg{bird}};
+\item[Page 2] one (1) instance of \code{\gls{gls}\marg{bird}};
+\item[Page 3] four (4) instances of \code{\gls{gls}\marg{bird}};
+\item[Section 3] one (1) instance of
+\code{\gls{gls}\oarg{\glsoptval{counter}{section}}\marg{bird}}.
+\end{description}
-\begin{definition}[\DescribeMacro\glsxtrdisplaysupploc]
-\cs{glsxtrdisplaysupploc}\marg{prefix}\marg{counter}\marg{format}\marg{src}\marg{location}
-\end{definition}
-This is used by \gls{bib2gls} version 1.7+ for supplemental
-locations, instead of using \cs{glsxtrsupphypernumber} with the
-\catattr{externallocation} attribute. This command sets up the
-location counter and prefix (used in the formation of hyperlinks)
-and then uses
-\begin{definition}[\DescribeMacro\glsxtrmultisupplocation]
-\cs{glsxtrmultisupplocation}\marg{location}\marg{src}\marg{format}
-\end{definition}
-to format the actual location (with an external hyperlink, if
-supported).
+Then the total record count (stored in
+the \glosfield{recordcount} field) is $2+1+4+1=8$, the total for the
+\ctr{page} counter (stored in the
+\glosfielddisp{recordcount.counter}{recordcount.page} field) is
+$2+1+4=7$, and the total for the \ctr{section} counter (stored in
+the \glosfielddisp{recordcount.counter}{recordcount.section} field)
+is~1.
-\subsection{Nameref Record}
-\label{sec:recordnameref}
+With the unit counting on as well, the following fields are assigned:
+\begin{itemize}
+\item \glosfielddisp{recordcount.counter.location}{recordcount.page.1} is
+set to 2;
+\item \glosfielddisp{recordcount.counter.location}{recordcount.page.2} is
+set to 1;
+\item \glosfielddisp{recordcount.counter.location}{recordcount.page.3} is
+set to 4;
+\item \glosfielddisp{recordcount.counter.location}{recordcount.section.3}
+is set to~1.
+\end{itemize}
-Normally locations are recorded in the \texttt{.aux} file
-in the form:
-\begin{definition}
-\cs{glsxtr@record}\marg{label}\marg{prefix}\marg{counter}\marg{format}\marg{location}
-\end{definition}
-The \pkgopt[nameref]{record} option, which requires at least
-\gls{bib2gls} v1.8, instead uses:
-\begin{definition}
-\cs{glsxtr@record@nameref}\marg{label}\marg{prefix}\marg{counter}\marg{format}\marg{location}\marg{title}\marg{href}\marg{hcounter}
-\end{definition}
-where \meta{title} is obtained from \cs{@currentlabelname}
-and \meta{href} is obtained from \cs{@currentHref}. These
-commands require \sty{hyperref}. If they are undefined,
-\meta{title} and \meta{href} will be left empty and \gls{bib2gls}
-will treat it as a regular record.
+You can access these fields using the following commands which
+will expand to the field value if set or to 0 if unset:
+\cmddef{GlsXtrTotalRecordCount}
+This expands to the total record count for the entry given by
+\meta{label}. For example:
+\begin{codebox}
+\gls{GlsXtrTotalRecordCount}\marg{bird}
+\end{codebox}
+expands to 8.
-\begin{important}
-Be careful with this option as \meta{href} will globally change on every
-instance of \cs{refstepcounter} but \meta{title} won't necessarily
-change. It can therefore cause unexpected behaviour.
-\end{important}
+\cmddef{GlsXtrRecordCount}
+This expands to the \idxc{locationcounter}{counter} total for the entry given by
+\meta{entry-label} where \meta{counter} is the counter name.
+For example:
+\begin{codebox}
+\gls{GlsXtrRecordCount}\marg{bird}\marg{\ctr{page}}
+\end{codebox}
+expands to 7 and
+\begin{codebox}
+\gls{GlsXtrRecordCount}\marg{bird}\marg{\ctr{section}}
+\end{codebox}
+expands to 1.
-The final argument \meta{hcounter} is obtained from
-\cs{theH}\meta{counter} which provides the partial target name associated
-with the indexing counter. With the original
-\gls{makeindex}\slash \gls{xindy} approach, it's not possible to
-include this information in the location, so the base
-\sty{glossaries} package attempts to derive a prefix from which the
-\meta{hcounter} value can be reconstituted by appending the prefix.
-Unfortunately, not all definitions of \cs{theH}\meta{counter} are in
-the form \meta{prefix}\cs{the}\meta{counter} (most notably the
-\ctr{equation} counter with chapters) so this can fail.
+\cmddef{GlsXtrLocationRecordCount}
+This expands to the total for the given \location. For example
+\begin{codebox}
+\gls{GlsXtrLocationRecordCount}\marg{bird}\marg{\ctr{page}}\marg{3}
+\end{codebox}
+expands to 4. Be careful about using \gls{thepage} in the
+\meta{location} part. Remember that due to \TeX's asynchronous
+output routine, \gls{thepage} may not be correct.
-Since \gls{bib2gls} is customized specifically for use with
-\styfmt{glossaries-extra}, it's now possible to save
-\meta{hcounter}, so the \pkgopt[nameref]{record} option does this.
-By providing both \meta{href} and \meta{hcounter}, you can determine
-which target you would rather use. The default is to use
-\meta{hcounter}, which will take you to the place where the
-corresponding counter was incremented with \cs{refstepcounter}.
-However, you may choose to switch to using the \meta{href} target,
-which will take you to the nearest target before the indexing took
-place.
+There are commands analogous to the entry counting commands like
+\gls{cgls} and \gls{cglsformat} that are triggered by the record count.
+These are listed below. The test to determine if the entry's record count
+exceeds the trigger value (which should be stored in the
+\catattr{recordcount} attribute) is obtained with:
+\cmddef{glsxtrifrecordtrigger}
+If the \catattr{recordcount} attribute is set and \meta{total}
+exceeds the value given by the \catattr{recordcount} attribute, then
+this does \meta{true} otherwise it does \meta{false}. The
+\meta{total} is given by:
+\cmddef{glsxtrrecordtriggervalue}
+This should expand to the record count value that needs testing. The
+default definition is:
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{glsxtrrecordtriggervalue}}[1]\marg{\%
+ \gls{GlsXtrTotalRecordCount}\marg{\#1}\%
+}
+\end{compactcodebox}
+This command may be redefined as appropriate. For example, it may be
+redefined to use \gls{GlsXtrRecordCount} for a particular
+\idx{locationcounter} or to use \gls{GlsXtrLocationRecordCount} for
+a particular location.
+
+The \catattr{recordcount} attribute may be set with
+\gls{glssetcategoryattribute} or can be set for each listed category
+with:
+\cmddef{GlsXtrSetRecordCountAttribute}
+The value must be an integer.
+
+Commands like \gls{rgls} behave slightly differently to \gls{cgls}.
+It's necessary for the command to add a \record\ to the \ext{aux}
+file in order for the entry to be selected and for the record count
+to be correct on the next \app{bib2gls}+\LaTeX\ run (for the default
+\resourceoptvalm{selection}{recorded and deps}). The trigger record
+is created with \glsoptval{format}{glstriggerrecordformat},
+which \app{bib2gls} v1.1+ recognises as a special type of
+\idx{ignoredlocation} format. This corresponds to the command:
+\cmddef{glstriggerrecordformat}
+As with \gls{glsignore}, this command does nothing and is considered
+an ignored record (so it won't appear in the \idx{locationlist}),
+but it indicates to \app{bib2gls} that the entry must be selected
+and, if the \resourceopt{trigger-type} option has been set, the
+entry will be assigned to the \resourceopt{trigger-type} glossary.
+
+For example, to assign the entry to an \idx{ignoredglossary}:
+\begin{codebox}
+\gls{newignoredglossary}\marg{ignored}
+\gls{GlsXtrLoadResources}\oarg{\resourceoptval{trigger-type}{ignored}}
+\end{codebox}
+This ensures that the entry is defined but it won't show up the
+normal glossary.
+
+\begin{information}
+The \idx{postlinkhook} won't be implemented if the record trigger is
+tripped. (That is, if the \gls{rglsformat}-like command is used instead of
+the \idx{glslike} command.)
+\end{information}
+
+\cmddef{rgls}
+If the value has been supplied by the \catattr{recordcount}
+attribute and is exceeded, this behaves like \gls{gls} otherwise it
+creates a trigger record and uses:
+\cmddef{rglsformat}
+This has the same definition as \gls{cglsformat}.
+
+\cmddef{rglspl}
+If the value has been supplied by the \catattr{recordcount}
+attribute and is exceeded, this behaves like \gls{glspl} otherwise
+it creates a trigger record and uses:
+\cmddef{rglsplformat}
+which uses the appropriate plural fields.
+
+\cmddef{rGls}
+If the value has been supplied by the \catattr{recordcount}
+attribute and is exceeded, this behaves like \gls{Gls} otherwise it
+creates a trigger record and uses:
+\cmddef{rGlsformat}
+which performs the appropriate case-change.
+
+\cmddef{rGlspl}
+If the value has been supplied by the \catattr{recordcount}
+attribute and is exceeded, this behaves like \gls{Glspl} otherwise
+it creates a trigger record and uses:
+\cmddef{rGlsplformat}
+which uses the appropriate plural fields and case-change.
+
+\cmddef{rGLS}
+If the value has been supplied by the \catattr{recordcount}
+attribute and is exceeded, this behaves like \gls{GLS} otherwise it
+creates a trigger record and uses:
+\cmddef{rGLSformat}
+which performs the appropriate case-change.
+
+\cmddef{rGLSpl}
+If the value has been supplied by the \catattr{recordcount}
+attribute and is exceeded, this behaves like \gls{GLSpl} otherwise
+it creates a trigger record and uses:
+\cmddef{rGLSplformat}
+which uses the appropriate plural fields and case-change.
+
+To make it easier to switch on record counting for an existing
+document, you can use:
+\cmddef{glsxtrenablerecordcount}
+This redefines \gls{gls}, \gls{glspl}, \gls{Gls}, \gls{Glspl},
+\gls{GLS}, \gls{GLSpl} to \gls{rgls}, \gls{rglspl}, \gls{rGls},
+\gls{rGlspl}, \gls{rGLS}, \gls{rGLSpl}, respectively, for
+convenience. This command will also switch the shortcut commands
+such as \gls{ac} or \gls{ab}, if they have been enabled, from using
+the \gls{cgls}-like commands to the corresponding \gls{rgls}
+command.
+
+For example, using the earlier
+\hypertarget{examplebib}{\filefmt{terms.bib}, \filefmt{abbrvs.bib}
+and \filefmt{symbols.bib}} example files:
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\codepar
+\cmd{usepackage}\oarg{colorlinks}\marg{hyperref}
+\cmd{usepackage}\oarg{\opt{record}}\marg{glossaries-extra}
+\codepar
+\gls{newignoredglossary}\marg{ignored}
+\codepar
+\gls{setabbreviationstyle}\marg{\abbrstyle{long-short-sc-desc}}
+\gls{GlsXtrLoadResources}\oarg{
+ \resourceoptvalm{src}{terms,abbrvs,symbols},
+ \resourceoptval{trigger-type}{ignored},
+ \resourceoptvalm{category}{same as entry}
+}
+\codepar
+\gls{glsxtrenablerecordcount}
+\gls{GlsXtrSetRecordCountAttribute}\marg{\cat{general},\cat{abbreviation}}\marg{1}
+\codepar
+\gls{glsdefpostlink}\marg{entry}\marg{\gls{glsxtrpostlinkAddDescOnFirstUse}}
+\gls{glsdefpostlink}\marg{\cat{symbol}}\marg{\gls{glsxtrpostlinkAddDescOnFirstUse}}
+\codepar
+\cbeg{document}
+\gls{gls}\marg{bird}, \gls{gls}\marg{ssi}, \gls{gls}\marg{bird}, \gls{gls}\marg{html},
+\gls{gls}\marg{M}, \gls{gls}\marg{html}.
+\codepar
+\gls{printunsrtglossaries}
+\cend{document}
+\end{codebox}
+If the document is called \filefmt{myDoc.tex}, then the build
+process is:
+\begin{terminal}
+pdflatex myDoc
+bib2gls \switch{record-count} myDoc
+pdflatex myDoc
+\end{terminal}
+The \resourceoptvalm{category}{same as entry} resource option
+assigns the \gloskey{category} field to the \ext{bib} entry type
+(without the initial \code{@}). This means that the entries defined
+in \filefmt{terms.bib} (with \atentry{entry}) have their
+\gloskey{category} set to \code{entry}, the entries defined
+in \filefmt{abbrvs.bib} (with \atentry{abbreviation}) have their
+\gloskey{category} set to \code{abbreviation}, and the entries defined
+in \filefmt{symbols.bib} (with \atentry{symbol}) have their
+\gloskey{category} set to \code{symbol}.
+
+I've added \idxpl{postlinkhook} to the \catfmt{entry} and
+\catfmt{symbol} categories to show the description on
+\idx{firstuse} (but not for the \catfmt{abbreviation} category).
+\begin{resultbox}
+\createexample*[
+ label={ex:bib2glsrecordcounting},
+title={Using \appfmt{bib2gls}: record counting},
+description={Example document using bib2gls with multiple resource sets},
+arara={pdflatex,bib2gls: { recordcount: on },pdflatex,pdfcrop}
+]
+{\cbeg{filecontents*}{terms.bib}^^J%
+\termsbibcontent^^J%
+\cend{filecontents*}^^J%
+\cbeg{filecontents*}{abbrvs.bib}^^J%
+\abbrvsbibcontent^^J%
+\cend{filecontents*}^^J%
+\cbeg{filecontents*}{symbols.bib}^^J%
+\symbolsbibcontent^^J%
+\cend{filecontents*}^^J%
+\cmd{usepackage}\oarg{colorlinks}\marg{hyperref}^^J%
+\cmd{usepackage}\oarg{record}\marg{glossaries-extra}
+\codepar
+\gls{newignoredglossary}\marg{ignored}^^J%
+\gls{setabbreviationstyle}\marg{long-short-sc-desc}
+\codepar
+\gls{GlsXtrLoadResources}\oarg{^^J
+ \resourceoptvalm{src}{terms,abbrvs,symbols},^^J
+ \resourceoptval{trigger-type}{ignored},^^J
+ \resourceoptvalm{category}{same as entry}^^J%
+}
+\codepar
+\gls{glsxtrenablerecordcount}^^J%
+\gls{GlsXtrSetRecordCountAttribute}\marg{symbol,abbreviation}\marg{1}
+\codepar
+\gls{glsdefpostlink}\marg{entry}\marg{\gls{glsxtrpostlinkAddDescOnFirstUse}}^^J%
+\gls{glsdefpostlink}\marg{symbol}\marg{\gls{glsxtrpostlinkAddDescOnFirstUse}}
+}
+{\gls{gls}\marg{M}, \gls{gls}\marg{ssi}, \gls{gls}\marg{bird},
+\gls{gls}\marg{html},^^J%
+\gls{gls}\marg{M}, \gls{gls}\marg{html}.
+\codepar
+\gls{printunsrtglossaries}
+}
+\end{resultbox}
+In the above, \code{ssi} and \code{bird} only have one record.
+However, they have been treated differently. The \code{ssi} entry is
+using \gls{rglsformat} whereas the \code{bird} entry is using the
+normal \gls{gls} behaviour. This is because the record counting
+hasn't been applied to the custom \catfmt{entry} category, whereas
+it has been applied to the \catfmt{abbreviation} and
+\catfmt{symbol} categories.
+
+\subsection{Unit Record Counting}
+\label{sec:unitrecordcount}
+
+If you want unit record counting you need to remember to invoke
+\app{bib2gls} with \switch{record-count-unit} and you will also need
+to redefine \gls{glsxtrrecordtriggervalue} appropriately. For
+example, suppose you want to reset all abbreviations at the start of each
+chapter, so that the full form is shown again, but only if the
+abbreviation isn't used elsewhere in the chapter.
+
+This would require records with the \glsopt{counter} set to
+\ctr{chapter}. This can be done with the \opt{counter} package
+option:
+\begin{codebox}
+\cmd{usepackage}\oarg{\opt{record},\optval{counter}{\ctr{chapter}}}\marg{glossaries-extra}
+\end{codebox}
+However, this will have chapter numbers instead of page numbers in
+the \idxpl{locationlist}. If you don't want \idxpl{locationlist}
+then this isn't a problem. The list can simply be suppressed with
+\opt{nonumberlist}.
+
+If you want page numbers in the \idxpl{locationlist} then you will
+need to \record\ each entry with both the \ctr{page} and
+\ctr{chapter} counters. This can be done with the hook that occurs
+before the \gls{gls} options are set:
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{glslinkpresetkeys}}\marg{\comment{}
+ \gls{glsadd}\oarg{\glsoptval{format}{glsignore},\glsoptval{counter}{\ctr{chapter}}}\marg{\gls{glslabel}}}
+\end{codebox}
+Note that I've used the ignored location format to prevent the
+chapter number from being added to the \idx{locationlist}.
+An alternative is to use the \resourceoptval{loc-counters}{\ctr{page}} resource
+option to only show the locations that use the \ctr{page} counter.
+
+The definition of \gls{glsxtrrecordtriggervalue} needs to be changed
+so that it uses the total for the given location. If \sty{hyperref}
+is used, you will need \theHcounter{chapter}:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glsxtrrecordtriggervalue}}[1]\marg{\comment{}
+ \gls{GlsXtrLocationRecordCount}\marg{\#1}\marg{\ctr{chapter}}\marg{\theHcounter{chapter}}\comment{}
+}
+\end{codebox}
+otherwise use \thecounter{chapter}.
+
+Consider the following (using the abbreviations defined in the
+earlier \filefmt{abbrvs.bib}):
+\begin{codebox}
+\cbeg{document}
+\cmd{chapter}\marg{First}
+\gls{gls}\marg{html}. \gls{gls}\marg{html}. \gls{gls}\marg{html}. \gls{gls}\marg{ssi}.
+\codepar
+\cmd{chapter}\marg{Second}
+\gls{gls}\marg{html}. \gls{gls}\marg{ssi}. \gls{gls}\marg{ssi}.
+\gls{gls}\marg{xml}.
+\codepar
+\gls{printunsrtglossaries}
+\cend{document}
+\end{codebox}
+Note that the \code{xml} entry is only used once in the entire
+document, but it will still be added to the glossary.
+
+The previous example used the \resourceopt{trigger-type} resource
+option to move entries with the \encap{glstriggerrecordformat} encap
+(that is, they didn't exceed the trigger value) to another
+glossary. Unfortunately, using that option in this case will move
+all three abbreviations to the \resourceopt{trigger-type} glossary.
+The \code{ssi} entry is only used once in the first chapter (but is
+used twice in the second chapter), and the \code{html} is only used
+once in the second chapter (but is used three times in the first
+chapter). So all three will have \records\ in the \ext{aux} file
+with the special \encap{glstriggerrecordformat} format.
+
+A simple solution is to omit any entries that don't have the
+\gloskey{location} field set when displaying the glossary:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{printunsrtglossaryentryprocesshook}}[1]\marg{\comment{}
+ \gls{glsxtrifhasfield}*\marg{\gloskey{location}}\marg{\#1}
+ \marg{}\marg{\gls{printunsrtglossaryskipentry}}\comment{}
+}
+\gls{printunsrtglossaries}
+\end{codebox}
+An alternative is to test the total record count, but remember that
+each entry is being \recorded\ twice: once with the \ctr{page}
+counter and once with the \ctr{chapter} counter, so the total count
+for the \code{ssi} entry will be 2 not 1.
+
+\begin{warning}
+Take care not to strip entries from a
+\glslink{hierarchicallevel}{hierarchical glossary} as it will
+break the hierarchy and will cause formatting problems in the
+glossary.
+\end{warning}
+
+The complete document is:
+\begin{codebox}
+\cmd{documentclass}\marg{scrreport}
+\cmd{usepackage}\oarg{T1}\marg{fontenc}
+\cmd{usepackage}\oarg{colorlinks}\marg{hyperref}
+\cmd{usepackage}\oarg{\opt{record},\opt{postdot}}\marg{glossaries-extra}
+\codepar
+\gls{setabbreviationstyle}\marg{\abbrstyle{long-short-sc-desc}}
+\codepar
+\gls{GlsXtrLoadResources}\oarg{\resourceoptvalm{src}{abbrvs}}
+\codepar
+\cmd{preto}\marg{\cmd{chapter}}\marg{\gls{glsresetall}}
+\gls{glsxtrenablerecordcount}
+\gls{GlsXtrSetRecordCountAttribute}\marg{abbreviation}\marg{1}
+\codepar
+\cmd{renewcommand}\marg{\gls{glslinkpresetkeys}}\marg{\comment{}
+ \gls{glsadd}\oarg{\glsoptval{format}{glsignore},\glsoptval{counter}{\ctr{chapter}}}\marg{\gls{glslabel}}}
+\codepar
+\cmd{renewcommand}*\marg{\gls{glsxtrrecordtriggervalue}}[1]\marg{\comment{}
+ \gls{GlsXtrLocationRecordCount}\marg{\#1}\marg{\ctr{chapter}}\marg{\thecounter{chapter}}\comment{}
+}
+\cbeg{document}
+\cmd{chapter}\marg{First}
+\gls{gls}\marg{html}. \gls{gls}\marg{html}. \gls{gls}\marg{html}. \gls{gls}\marg{ssi}.
+\codepar
+\cmd{chapter}\marg{Second}
+\gls{gls}\marg{html}. \gls{gls}\marg{ssi}. \gls{gls}\marg{ssi}. \gls{gls}\marg{xml}.
+\codepar
+\cmd{renewcommand}*\marg{\gls{printunsrtglossaryentryprocesshook}}[1]\marg{\comment{}
+ \gls{glsxtrifhasfield}*\marg{\gloskey{location}}\marg{\#1}
+ \marg{}\marg{\gls{printunsrtglossaryskipentry}}\comment{}
+}
+\gls{printunsrtglossaries}
+\cend{document}
+\end{codebox}
+If the document is in a file called \filefmt{myDoc.tex} then the
+document build is:
+\begin{terminal}
+pdflatex myDoc
+bib2gls --record-count-unit myDoc
+pdflatex myDoc
+\end{terminal}
+\begin{resultbox}
+\createexample*[
+ label={ex:bib2glsunitrecordcounting},
+title={Using \appfmt{bib2gls}: unit record counting},class=scrreport,pages={1,2,3},
+description={Example document using bib2gls with unit records},
+arara={pdflatex,bib2gls: { recordcountunit: on },pdflatex,pdfcrop}
+]
+{\cbeg{filecontents*}{abbrvs.bib}^^J%
+\abbrvsbibcontent^^J%
+\cend{filecontents*}^^J%
+\cmd{usepackage}\oarg{T1}\marg{fontenc}^^J%
+\cmd{usepackage}\oarg{colorlinks}\marg{hyperref}^^J%
+\cmd{usepackage}\oarg{record,postdot}\marg{glossaries-extra}
+\codepar
+\cmd{renewcommand}\marg{\cmd{chapterpagestyle}}\marg{empty}\comment{to assist cropping}%
+\gls{setabbreviationstyle}\marg{long-short-sc-desc}
+\codepar
+\gls{GlsXtrLoadResources}\oarg{\resourceoptvalm{src}{abbrvs}}
+\codepar
+\cmd{preto}\marg{\cmd{chapter}}\marg{\gls{glsresetall}}^^J%
+\gls{glsxtrenablerecordcount}^^J%
+\gls{GlsXtrSetRecordCountAttribute}\marg{abbreviation}\marg{1}
+\codepar
+\cmd{renewcommand}\marg{\gls{glslinkpresetkeys}}\marg{\comment{}
+ \gls{glsadd}\oarg{format=glsignore,counter=chapter}\marg{\gls{glslabel}}}
+\codepar
+\cmd{renewcommand}*\marg{\gls{glsxtrrecordtriggervalue}}[1]\marg{\comment{}
+ \gls{GlsXtrLocationRecordCount}\marg{\#1}\marg{chapter}\marg{\cmd{theHchapter}}\comment{}%
+}
+}
+{\cmd{chapter}\marg{First}
+\gls{gls}\marg{html}. \gls{gls}\marg{html}. \gls{gls}\marg{html}. \gls{gls}\marg{ssi}.
+\codepar
+\cmd{chapter}\marg{Second}
+\gls{gls}\marg{html}. \gls{gls}\marg{ssi}. \gls{gls}\marg{ssi}.
+\gls{gls}\marg{xml}.
+\codepar
+\cmd{renewcommand}*\marg{\gls{printunsrtglossaryentryprocesshook}}[1]\marg{\comment{}
+ \gls{glsxtrifhasfield}*\marg{location}\marg{\#1}\marg{}\marg{\gls{printunsrtglossaryskipentry}}\comment{}%
+}^^J%
+\gls{printunsrtglossaries}
+}
+\end{resultbox}
+
+\subsection{Mini-Glossaries}
+\label{sec:unitrecordcountminigloss}
+
+Record counting doesn't have to be used with the \gls{rgls} set of
+commands. When \app{bib2gls} writes the code to the \ext{glstex}
+file to save the record counting information, it does it with helper
+commands that it provides in the \ext{glstex} file:
+\cmddef{bibglssettotalrecordcount}
+This sets the total record count and is defined in the
+\ext{glstex} file as:
+\begin{compactcodebox}
+\cmd{providecommand}*\marg{\gls{bibglssettotalrecordcount}}[2]\marg{\comment{}
+ \gls{GlsXtrSetField}\marg{\#1}\marg{\glosfield{recordcount}}\marg{\#2}\comment{}
+}
+\end{compactcodebox}
+\cmddef{bibglssetrecordcount}
+This sets the total for the given counter and is defined as:
+\begin{compactcodebox}
+\cmd{providecommand}*\marg{\gls{bibglssetrecordcount}}[3]\marg{\comment{}
+ \gls{GlsXtrSetField}\marg{\#1}\marg{\recordcounterfield{\#2}}\marg{\#3}\comment{}
+}
+\end{compactcodebox}
+The following is only available with \switch{record-count-unit}:
+\cmddef{bibglssetlocationrecordcount}
+This sets the total for the given location and is defined as:
+\begin{compactcodebox}
+\cmd{providecommand}*\marg{\gls{bibglssetlocationrecordcount}}[4]\marg{\comment{}
+ \gls{GlsXtrSetField}\marg{\#1}\marg{\recordcounterlocationfield{\#2}{\gls{glsxtrdetoklocation}\marg{\#3}}}\marg{\#4}\comment{}
+}
+\end{compactcodebox}
+
+By defining one of more of these commands before the \ext{glstex}
+file is input, it's possible to pick up the information, without the
+need to iterate over all entries later. For example, the following
+will create a \idx{mini-glossary} for each particular location and
+populate it with entries that have a record for that location.
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{bibglssetlocationrecordcount}}[4]\marg{\comment{}
+ \gls{GlsXtrSetField}\marg{\#1}\marg{\recordcounterlocationfield{\#2}{\#3}}\marg{\#4}\comment{}
+ \gls{provideignoredglossary}\marg{minigloss.\#2.\#3}\comment{}
+ \gls{glsxtrcopytoglossary}\marg{\#1}{minigloss.\#2.\#3}\comment{}
+}
+\end{codebox}
+I've omitted \gls{glsxtrdetoklocation} for clarity and because I'm
+confident the locations won't be problematic. The
+\idx{mini-glossary} can then be displayed at the start of the
+chapter with:
+\begin{codebox}
+\gls{printunsrtglossary}\oarg{\printglossoptval{type}{minigloss.chapter.\theHcounter{chapter}}}
+\end{codebox}
+
+The previous example can be altered to strip the \gls{rgls} commands
+and instead add a \idx{mini-glossary} at the start of each chapter
+(the redefinition of \gls{glslinkpresetkeys} remains to ensure there
+are locations with the \ctr{chapter} counter). I've also provided a
+command to make it easier to display the \idxpl{mini-glossary}:
+\begin{codebox}
+\cmd{newcommand}\marg{\cmd{minigloss}}\marg{\comment{}
+ \gls{printunsrtglossary*}\oarg{\printglossoptval{style}{\glostyle{abbr-short-long}},\printglossoptval{type}{minigloss.chapter.\theHcounter{chapter}},\printglossoptval{groups}{false},\printglossoptval{target}{false}}\comment{}
+ \marg{\cmd{renewcommand}\marg{\gls{glossarysection}}[2][]\marg{}\comment{}
+ \cmd{renewcommand}\marg{\gls{glslongextraShortLongTabularHeader}}\marg{\cmd{toprule}}\comment{}
+ }%
+}
+\end{codebox}
+The document build is the same.
+
+\begin{resultbox}
+\createexample*[label=ex:recordcountminigloss,class=scrreport,pages={1,2,3},
+title={Using \appfmt{bib2gls}: unit record counting mini-glossary},
+description={Example document using bib2gls to create a mini-glossary with unit records},
+arara={pdflatex,bib2gls: { recordcountunit: on },pdflatex,pdfcrop}
+]
+{\cbeg{filecontents*}{abbrvs.bib}^^J%
+\abbrvsbibcontent^^J%
+\cend{filecontents*}^^J%
+\cmd{usepackage}\oarg{T1}\marg{fontenc}^^J%
+\cmd{usepackage}\oarg{colorlinks}\marg{hyperref}^^J%
+\cmd{usepackage}\oarg{record,postdot,stylemods=longextra}\marg{glossaries-extra}
+\codepar
+\cmd{renewcommand}\marg{\cmd{chapterpagestyle}}\marg{empty}\comment{to assist cropping}%
+\gls{setabbreviationstyle}\marg{long-short-sc-desc}
+\codepar
+\cmd{newcommand}*\marg{\gls{bibglssetlocationrecordcount}}[4]\marg{\comment{}
+ \gls{GlsXtrSetField}\marg{\#1}\marg{recordcount.\#2.\#3}\marg{\#4}\comment{}
+ \gls{provideignoredglossary}\marg{minigloss.\#2.\#3}\comment{}
+ \gls{glsxtrcopytoglossary}\marg{\#1}{minigloss.\#2.\#3}\comment{}%
+}
+\codepar
+\gls{GlsXtrLoadResources}\oarg{\resourceoptvalm{src}{abbrvs}}
+\codepar
+\cmd{renewcommand}\marg{\gls{glslinkpresetkeys}}\marg{\comment{}
+ \gls{glsadd}\oarg{format=glsignore,counter=chapter}\marg{\gls{glslabel}}}^^J%
+\cmd{newcommand}\marg{\cmd{minigloss}}\marg{\comment{}
+ \gls{printunsrtglossary*}\oarg{style=abbr-short-long,type=minigloss.chapter.\cmd{theHchapter},groups=false,target=false}\comment{}
+ \marg{\cmd{renewcommand}\marg{\gls{glossarysection}}[2][]\marg{}\comment{}
+ \cmd{renewcommand}\marg{\gls{glslongextraShortLongTabularHeader}}\marg{\cmd{toprule}}\comment{}%
+}}
+}
+{\cmd{chapter}\marg{First}
+\cmd{minigloss}
+\gls{gls}\marg{html}. \gls{gls}\marg{html}. \gls{gls}\marg{html}. \gls{gls}\marg{ssi}.
+\codepar
+\cmd{chapter}\marg{Second}
+\cmd{minigloss}
+\gls{gls}\marg{html}. \gls{gls}\marg{ssi}. \gls{gls}\marg{ssi}.
+\gls{gls}\marg{xml}.
+\codepar
+\cmd{renewcommand}*\marg{\gls{printunsrtglossaryentryprocesshook}}[1]\marg{\comment{}
+ \gls{glsxtrifhasfield}*\marg{location}\marg{\#1}\marg{}\marg{\gls{printunsrtglossaryskipentry}}\comment{}%
+}^^J%
+\gls{printunsrtglossaries}
+}
+\end{resultbox}
-With \gls{bib2gls} v1.8+, normal locations are displayed using:
-\begin{definition}
-\cs{glsnoidxdisplayloc}\marg{prefix}\marg{counter}\marg{format}\marg{location}
-\end{definition}
-This is provided by the base \sty{glossaries} package and is simply
-defined to do:
-\begin{definition}
-\cs{setentrycounter}\oarg{prefix}\marg{counter}\cs{csuse}\marg{format}\marg{location}
-\end{definition}
-Earlier versions of \gls{bib2gls} only used this in the
-\gloskey{loclist} field and explicitly used \cs{setentrycounter} in
-the \gloskey{location} field followed by
-\cs{}\meta{format}\marg{location}, which follows the code that's created
-with the default \pkgopt{makeindex} setting.
-The \cs{setentrycounter} command sets up the prefix needed for
-\cs{glshypernumber} to reform the target name from the given
-location.
-
-The locations identified by \cs{glsxtr@record@nameref} are written
-by \gls{bib2gls} to the location list using:
-\begin{definition}[\DescribeMacro\glsxtrdisplaylocnameref]
-\cs{glsxtrdisplaylocnameref}\marg{prefix}\marg{counter}\marg{format}\marg{location}\marg{title}\marg{href}\marg{hcounter}\marg{file}
-\end{definition}
-With normal internal locations, \meta{file} will always be empty.
-With supplemental locations, \meta{file} will be the external file
-reference.
+\section{The \stytext{glossaries-extra-bib2gls} package}
+\label{sec:bib2glssty}
-The default definition is:
-\begin{verbatim}
-\newcommand*{\glsxtrdisplaylocnameref}[8]{%
- \ifstrequal{#2}{equation}%
- {\glsxtrnamereflink{#3}{(#4)}{#2.#7}{#8}}%
- {%
- \ifstrempty{#5}%
- {%
- \glsxtrnamereflink{#3}{#4}{#2.#7}{#8}%
- }%
- {%
- \ifstrequal{#2}{page}%
- {\glsxtrnamereflink{#3}{#4}{#2.#7}{#8}}%
- {\glsxtrnamereflink{#3}{#5}{#2.#7}{#8}}%
- }%
- }%
-}
-\end{verbatim}
-which uses:
-\begin{definition}[\DescribeMacro\glsxtrnamereflink]
-\cs{glsxtrnamereflink}\marg{format}\marg{title}\marg{target}\marg{file}
-\end{definition}
-This ignores the \meta{prefix}, \meta{counter} and \marg{location}
-arguments and instead creates a hyperlink with the target name obtained from \meta{target} (and \meta{file}, if not empty).
-
-Since pages and equations typically don't have titles, the default
-definition of \cs{glsxtrdisplaylocnameref} checks the counter was
-used as the location. If it's \ctr{page} or if \meta{title} is empty, then just the location is
-used as the hyperlink text. If the counter \ctr{equation}, then the
-text is the location in parentheses. Otherwise the text is obtained
-from \meta{title}.
+\pkgdef{glossaries-extra-bib2gls}
+\glsadd[format=(]{pkg.glossaries-extra-bib2gls}%
+The package options \opteqvalref{record}{only} (or simply
+\opt{record}) and \opteqvalref{record}{nameref} automatically
+loads the supplementary package \sty{glossaries-extra-bib2gls},
+which provides some commands that are specific to \app{bib2gls}, in
+particular to sorting and \idxpl{locationlist} which aren't relevant
+with \opteqvalref{record}{hybrid}.
-If \meta{file} is empty an internal link is created with:
-\begin{definition}[\DescribeMacro\glsxtrfmtinternalnameref]
-\cs{glsxtrfmtinternalnameref}\marg{target}\marg{format}\marg{title}
-\end{definition}
-otherwise an external link is created with:
-\begin{definition}[\DescribeMacro\glsxtrfmtexternalnameref]
-\cs{glsxtrfmtexternalnameref}\marg{target}\marg{format}\marg{title}\marg{file}
-\end{definition}
-The \meta{file} argument is set by \gls{bib2gls} for supplemental
-locations.
-
-Here's alternative definition that uses the \meta{prefix} and
-\meta{counter} to reform the target name (as
-\cs{glsnoidxdisplayloc}) but uses the \meta{title} as the hyperlink text:
-\begin{verbatim}
-\renewcommand*{\glsxtrdisplaylocnameref}[7]{%
- \glsxtrnamereflink{#3}{#5}{#6}{#7}%
-}
-\end{verbatim}
-which uses:
-\begin{definition}[\DescribeMacro\glsxtrnameloclink]
-\cs{glsxtrnameloclink}\marg{prefix}\marg{counter}\marg{format}\marg{location}\marg{title}\marg{file}
-\end{definition}
-This uses the same commands as \cs{glsxtrnamereflink}
-to produce the hyperlinks.
-
-In both cases, the link is encapsulated with the text-block command
-whose name is given by \meta{format}, but \cs{glshypernumber} is
-first locally redefined to \cs{@firstofone} to prevent a conflict with the
-usual location hyperlink formation. This means that if the
-\meta{format} is \texttt{hyperbf} then it will simply behave like
-\texttt{textbf}.
-
-For compactness, \gls{bib2gls} merges normal records if the
-\meta{prefix}, \meta{counter} and \meta{location} all match. (An
-order of precedence can be provided for format conflicts.) With
-nameref records, you can use the \verb|--merge-nameref-on| switch
-provided by \gls{bib2gls} v1.8+ to determine how to merge nameref
-records. This switch must be followed by one of the following
-keywords: \texttt{hcounter} (merge on \meta{hcounter}, default)
-\texttt{href} (merge on \meta{href}), \texttt{title} (merge
-on \meta{title}) and \texttt{location} (merge on \meta{location}, as
-regular records). In all cases, the \meta{counter} must also match.
+If \sty{glossaries-extra-bib2gls} is loaded via the
+\opt{record} package option then the check for associated
+language files (see \sectionref{sec:lang}) will also
+search for the existence of
+\metafilefmt{glossariesxtr-}{script}{.ldf} for each
+document dialect (where \meta{script} is the four letter
+script identifier, such as \code{Latn}).
+
+\subsection{Displaying Glossaries}
+\label{sec:printunsrtshortcuts}
+
+\Idxpl{glossary} are displayed with the \idx{unsrtfam} (see
+\sectionref{sec:printunsrt}). Some styles, such as
+\glostyle{bookindex}, are customized for use with \app{bib2gls}.
+
+
+The following commands are shortcuts that use
+\gls{printunsrtglossary}. However, they are only defined if a
+corresponding package option has been set \emph{before}
+\sty{glossaries-extra-bib2gls} is loaded. This means that the
+options must be passed as a package option, not using
+\gls{glossariesextrasetup}, if the shortcut commands are required.
+
+\cmddef{printunsrtabbreviations}
+This shortcut is provided if the \opt{abbreviations} package
+option has been used. This is a shortcut for:
+\begin{codebox}
+\gls{printunsrtglossary}\oarg{type=abbreviations,\meta{options}}
+\end{codebox}
+
+\cmddef{printunsrtacronyms}
+This shortcut is provided if the \opt{acronyms} (or
+\opt{acronym}) package option has been used. This is a shortcut for:
+\begin{codebox}
+\gls{printunsrtglossary}\oarg{type=\gls{acronymtype},\meta{options}}
+\end{codebox}
+
+\cmddef{printunsrtsymbols}
+This shortcut is provided if the \opt{symbols} package
+option has been used. This is a shortcut for:
+\begin{codebox}
+\gls{printunsrtglossary}\oarg{type=symbols,\meta{options}}
+\end{codebox}
+
+\cmddef{printunsrtnumbers}
+This shortcut is provided if the \opt{numbers} package
+option has been used. This is a shortcut for:
+\begin{codebox}
+\gls{printunsrtglossary}\oarg{type=numbers,\meta{options}}
+\end{codebox}
+
+\cmddef{printunsrtindex}
+This shortcut is provided if the \opt{index} package
+option has been used. This is a shortcut for:
+\begin{codebox}
+\gls{printunsrtglossary}\oarg{type=index,\meta{options}}
+\end{codebox}
\subsection{Helper Commands for Resource Options}
\label{sec:resourcecommands}
-\begin{definition}[\DescribeMacro\glshex]
-\cs{glshex}
-\end{definition}
-This is just defined as \verb|\string\u|, which is required
-when you need to indicate a Unicode character in the form
-\cs{u}\meta{hex} in some of
-the resource options (as illustrated above).
-
-\begin{definition}[\DescribeMacro\glscapturedgroup]
-\cs{glscapturedgroup}
-\end{definition}
-This is just defined as \verb|\string\$| and is used for
-the captured group reference in a replacement part of a regular
-expression substitution (requires at least \gls{bib2gls} version 1.5). For example:
-\begin{verbatim}
-sort-replace={{([a-zA-Z])\string\.}{\glscapturedgroup1}}
-\end{verbatim}
-This only removes a full stop that follows any of the characters
+\cmddef{glshex}
+This simply expands to \code{\gls{string}\gls{u}\meta{hex}}, which
+is used to identify the Unicode character \meta{hex} in the value of
+some \idxpl{resourceopt}.
+
+\cmddef{glshashchar}
+This expands to a literal \idx{sym.hash} character (similar to
+\gls{glsbackslash}).
+
+\cmddef{glscapturedgroup}
+This simply expands to \code{\gls{string}\gls{dollar}\meta{n}}
+which is used to indicate the \meta{n}th captured group in a regular expression
+replacement in the value of some \idxpl{resourceopt} (requires
+\app{bib2gls} v1.5+), such as \resourceopt{sort-replace}. For example:
+\begin{codebox}
+\resourceoptvalm{sort-replace}{\marg{([a-zA-Z])\gls{string}\cmd{.}}\marg{\gls{glscapturedgroup}1}}
+\end{codebox}
+This removes a full stop that follows any of the characters
a,\ldots,z or A,\ldots,Z.
-If you use the \texttt{save-child-count} resource option,
-you can test if the \texttt{childcount} field is non-zero using:
-\begin{definition}[\DescribeMacro{\GlsXtrIfHasNonZeroChildCount}]
-\cs{GlsXtrIfHasNonZeroChildCount}\marg{label}\marg{true}\marg{false}
-\end{definition}
-This internally uses \cs{GlsXtrIfFieldNonZero} and will do
-\meta{false} if the field isn't set. Within \meta{true} and
-\meta{false} you can use \cs{glscurrentfieldvalue} to access the
-value. (It will be 0 in \meta{false} if the field isn't set.)
-As from v1.47, there is also a starred version which uses
-\cs{GlsXtrIfFieldNonZero*} (don't add grouping).
-
-
-A convenient shortcut for use in the \texttt{entry-type-aliases}
-setting:
-\begin{definition}[\DescribeMacro\GlsXtrBibTeXEntryAliases]
-\cs{GlsXtrBibTeXEntryAliases}
-\end{definition}
-This provides aliases for Bib\TeX's standard entry types to
-\gls{bib2gls}['s] \texttt{@bibtexentry} entry type (requires at
-least \gls{bib2gls} version 1.4).
-
-You may also want to provide storage keys for Bib\TeX's standard
+A convenient shortcut for use in the \resourceopt{entry-type-aliases}
+setting:
+\cmddef{GlsXtrBibTeXEntryAliases}
+This provides aliases for \BibTeX's standard entry types (such as
+\atentry{article} and \atentry{book}) to \app{bib2gls}['s]
+\atentry{bibtexentry} entry type (requires \app{bib2gls} v1.4+).
+
+You may also want to provide storage keys for \BibTeX's standard
fields rather than having to alias them all. This can be done with:
-\begin{definition}[\DescribeMacro\GlsXtrProvideBibTeXFields]
-\cs{GlsXtrProvideBibTeXFields}
-\end{definition}
-Note that Bib\TeX's \texttt{type} field clashes with the \sty{glossaries}
+\cmddef{GlsXtrProvideBibTeXFields}
+This defines each \BibTeX\ field, such as \fieldfmt{author}, as a
+glossary entry key:
+\begin{compactcodebox}
+ \gls{glsaddstoragekey}\marg{address}\marg{}\marg{\inlineglsdef{glsxtrbibaddress}}\%
+ \gls{glsaddstoragekey}\marg{author}\marg{}\marg{\inlineglsdef{glsxtrbibauthor}}\%
+ \gls{glsaddstoragekey}\marg{booktitle}\marg{}\marg{\inlineglsdef{glsxtrbibbooktitle}}\%
+ \gls{glsaddstoragekey}\marg{chapter}\marg{}\marg{\inlineglsdef{glsxtrbibchapter}}\%
+ \gls{glsaddstoragekey}\marg{edition}\marg{}\marg{\inlineglsdef{glsxtrbibedition}}\%
+ \gls{glsaddstoragekey}\marg{howpublished}\marg{}\marg{\inlineglsdef{glsxtrbibhowpublished}}\%
+ \gls{glsaddstoragekey}\marg{institution}\marg{}\marg{\inlineglsdef{glsxtrbibinstitution}}\%
+ \gls{glsaddstoragekey}\marg{journal}\marg{}\marg{\inlineglsdef{glsxtrbibjournal}}\%
+ \gls{glsaddstoragekey}\marg{month}\marg{}\marg{\inlineglsdef{glsxtrbibmonth}}\%
+ \gls{glsaddstoragekey}\marg{note}\marg{}\marg{\inlineglsdef{glsxtrbibnote}}\%
+ \gls{glsaddstoragekey}\marg{number}\marg{}\marg{\inlineglsdef{glsxtrbibnumber}}\%
+ \gls{glsaddstoragekey}\marg{organization}\marg{}\marg{\inlineglsdef{glsxtrbiborganization}}\%
+ \gls{glsaddstoragekey}\marg{pages}\marg{}\marg{\inlineglsdef{glsxtrbibpages}}\%
+ \gls{glsaddstoragekey}\marg{publisher}\marg{}\marg{\inlineglsdef{glsxtrbibpublisher}}\%
+ \gls{glsaddstoragekey}\marg{school}\marg{}\marg{\inlineglsdef{glsxtrbibschool}}\%
+ \gls{glsaddstoragekey}\marg{series}\marg{}\marg{\inlineglsdef{glsxtrbibseries}}\%
+ \gls{glsaddstoragekey}\marg{title}\marg{}\marg{\inlineglsdef{glsxtrbibtitle}}\%
+ \gls{glsaddstoragekey}\marg{bibtextype}\marg{}\marg{\inlineglsdef{glsxtrbibtype}}\%
+ \gls{glsaddstoragekey}\marg{volume}\marg{}\marg{\inlineglsdef{glsxtrbibvolume}}\%
+\end{compactcodebox}
+This command should be placed before the first
+\gls{GlsXtrLoadResources}.
+
+\begin{warning}
+\BibTeX's \fieldfmt{type} field clashes with the \sty{glossaries}
package's \gloskey{type} key, so this command provides the key
-\texttt{bibtextype} instead. You can alias it with
-\texttt{field-aliases={type=bibtextype}} in the resource options.
-Each storage key is provided with a convenient command to access the
-value in the form \cs{glsxtrbib}\meta{field}. For example,
-\cs{glsxtrbibaddress}. The \texttt{bibtextype} field can be accessed
-with \cs{glsxtrbibtype}. Each of these commands takes the entry
-label as the sole argument.
-
-The \sty{glossaries-extra-bib2gls} package also provides definitions
-of the missing mathematical Greek commands: \ics{Alpha},
-\ics{Beta}, \ics{Epsilon}, \ics{Zeta}, \ics{Eta}, \ics{Iota},
-\ics{Kappa}, \ics{Mu}, \ics{Nu}, \ics{Omicron}, \ics{Rho},
-\ics{Tau}, \ics{Chi}, \ics{Digamma}, \ics{omicron}.
-These are all defined with \cs{providecommand}, so they won't override
-any definitions provided by any package loaded before
-\sty{glossaries-extra}. Since \gls{bib2gls}['s] interpreter
-recognises these commands, using them instead of explicitly using
-the Latin characters with the same shape helps to keep the Greek
-symbols together when sorting.
-Similarly, if \sty{upgreek} has been loaded, the missing upright
-Greek commands are also provided.
-
-The remaining commands provide common rule blocks for use in
-the \texttt{sort-rule} resource option. If you want a rule for
+\fieldfmt{bibtextype} instead. You can alias it with
+\resourceoptvalm{field-aliases}{\gloskey{type}=\fieldfmt{bibtextype}}
+in the \idxpl{resourceopt}.
+\end{warning}
+
+\subsubsection{Custom Sort}
+\label{sec:customsort}
+
+There are many locale alphabetical rules provided with
+\app{bib2gls}, such as \resourceoptval{sort}{de-1996} for German new
+orthography. However, it may be that your particular locale isn't
+supported, or you want a rule that covers multiple scripts or
+non-alphabetic symbols.
+
+The \resourceoptval{sort}{custom} setting combined with
+\resourceopt{sort-rule} provides a way to define your own sort rule.
+For example, suppose I have a file called \filefmt{animals.bib} that
+contains:
+\newcommand{\animalsbib}{%
+ \atentry{index}\marg{bee}\newline
+ \atentry{index}\marg{lion}\newline
+ \atentry{index}\marg{ant}\newline
+ \atentry{index}\marg{cow}\newline
+ \atentry{index}\marg{goose}\newline
+ \atentry{index}\marg{zebu}\newline
+ \atentry{index}\marg{egret}\newline
+ \atentry{index}\marg{elk}\newline
+ \atentry{index}\marg{llama}\newline
+ \atentry{index}\marg{lynx}\newline
+ \atentry{index}\marg{bat}%
+}
+\begin{codebox}
+\animalsbib
+\end{codebox}
+Here's a very limited rule that only recognises five letters:
+\begin{codebox}
+\cmd{usepackage}\oarg{\opt{record},\opt{nostyles},\optval{stylemods}{bookindex},\optval{style}{\glostyle{bookindex}}}
+\marg{glossaries-extra}
+\codepar
+\cmd{newcommand}\marg{\gls{bibglssetlastgrouptitle}}[2]\marg{\%
+ \gls{glsxtrsetgrouptitle}\marg{\#1\#2}\marg{Other}\%
+}
+\gls{GlsXtrLoadResources}\oarg{\resourceoptval{src}{animals},\resourceoptval{selection}{all},
+ \resourceoptval{sort}{custom},\resourceoptvalm{sort-rule}{ < a,A < b,B < e,E < l,L < ll,Ll,LL < z,Z}}
+\codepar
+\cbeg{document}
+\gls{printunsrtglossaries}
+\cend{document}
+\end{codebox}
+Any characters that aren't included in the rule (such as \qt{c} and
+\qt{g}) are placed at the end. I've defined \gls{bibglssetlastgrouptitle}
+to label that final group of characters \qt{Other}. If the document
+is in a file called \filefmt{myDoc.tex}, the build process is:
+\begin{terminal}
+pdflatex myDoc
+bib2gls \switch{g} myDoc
+pdflatex myDoc
+\end{terminal}
+The result is:
+\begin{resultbox}
+\createexample*[arara={pdflatex,bib2gls: { group : on },pdflatex,pdfcrop},
+ label={ex:bib2glscustomsort},
+ title={Using \appfmt{bib2gls}: simple custom sort rule},
+ description={Example document that provides a simplistic custom
+sort rule}
+]
+{\cbeg{filecontents*}{animals.bib}^^J%
+\animalsbib^^J%
+\cend{filecontents*}^^J%
+\cmd{usepackage}\oarg{\opt{record},\opt{nostyles},\optval{stylemods}{bookindex},\optval{style}{\glostyle{bookindex}}}^^J
+\marg{glossaries-extra}
+\codepar
+\cmd{newcommand}\marg{\gls{bibglssetlastgrouptitle}}[2]\marg{\%^^J
+ \gls{glsxtrsetgrouptitle}\marg{\#1\#2}\marg{Other}\%^^J%
+}
+\gls{GlsXtrLoadResources}\oarg{\resourceoptval{src}{animals},\resourceoptval{selection}{all},^^J
+ \resourceoptval{sort}{custom},\resourceoptvalm{sort-rule}{ < a,A < b,B < e,E < l,L < ll,Ll,LL < z,Z}}
+}
+{\gls{printunsrtglossaries}}
+\end{resultbox}
+Note that \qt{egret} has been placed after \qt{elk}. This is because
+\qt{l} is included in the rule but \qt{g} isn't. Whereas \qt{lynx}
+comes before \qt{llama} because there's a separate \qt{ll} group
+after the \qt{l} group.
+
+The commands listed below provide common rule blocks for use in
+the \resourceopt{sort-rule} resource option. If you want a rule for
a specific locale, you can provide similar commands in a file called
-\texttt{glossariesxtr-}\meta{tag}\texttt{.ldf}, where \meta{tag}
+\metafilefmt{glossariesxtr-}{tag}{.ldf}, where \meta{tag}
identifies the dialect, locale, region or root language. See the
-description of \cs{IfTrackedLanguageFileExists} in the
+description of \gls{IfTrackedLanguageFileExists} in the
\sty{tracklang} documentation for further details. If this file is
on \TeX's path and the \sty{tracklang} package (automatically loaded
-by \styfmt{glossaries}) detects that the document has requested that
+by \sty{glossaries}) detects that the document has requested that
language or locale, then the file will automatically be loaded.
For example, if you want to provide a rule block for Welsh, then
-create a file called \texttt{glossariesxtr-welsh.ldf} that contains:
-\begin{verbatim}
-\ProvidesGlossariesExtraLang{welsh}[2018/02/23 v1.0]
-
-\@ifpackageloaded{glossaries-extra-bib2gls}
-{
- \newcommand{\glsxtrWelshRules}{%
- \glsxtrLatinA
- \string<b,B
- \string<c,C
- \string<ch,CH
- \string<d,D
- \string<dd,DD
- \string<\glsxtrLatinE
- \string<f,F
- \string<ff,FF
- \string<g,G
- \string<ng,NG
- \string<\glsxtrLatinH
- \string<\glsxtrLatinI
- \string<j,J
- \string<\glsxtrLatinL
- \string<ll,LL
- \string<\glsxtrLatinM
- \string<\glsxtrLatinN
- \string<\glsxtrLatinO
- \string<\glsxtrLatinP
- \string<ph,PH
- \string<r,R
- \string<rh,RH
- \string<\glsxtrLatinS
- \string<\glsxtrLatinT
- \string<th,TH
- \string<u,U
- \string<w,W
- \string<y,Y
- }
-}
-{}% glossaries-extra-bib2gls.sty not loaded
-\end{verbatim}
-(The use of \cs{string} is in case the \texttt{<} character
+create a file called \filefmt{glossariesxtr-welsh.ldf} that contains:
+\begin{codebox}
+\gls{ProvidesGlossariesExtraLang}\marg{welsh}[2018/02/23 v1.0]
+\codepar
+\cmd{@ifpackageloaded}\marg{glossaries-extra-bib2gls}
+\marg{
+ \cmd{newcommand}\marg{\cmd{glsxtrWelshRules}}\marg{\%
+ \gls{glsxtrLatinA}
+ \gls{string}<b,B
+ \gls{string}<c,C
+ \gls{string}<ch,CH
+ \gls{string}<d,D
+ \gls{string}<dd,DD
+ \gls{string}<\gls{glsxtrLatinE}
+ \gls{string}<f,F
+ \gls{string}<ff,FF
+ \gls{string}<g,G
+ \gls{string}<ng,NG
+ \gls{string}<\gls{glsxtrLatinH}
+ \gls{string}<\gls{glsxtrLatinI}
+ \gls{string}<j,J
+ \gls{string}<\gls{glsxtrLatinL}
+ \gls{string}<ll,Ll,LL
+ \gls{string}<\gls{glsxtrLatinM}
+ \gls{string}<\gls{glsxtrLatinN}
+ \gls{string}<\gls{glsxtrLatinO}
+ \gls{string}<\gls{glsxtrLatinP}
+ \gls{string}<ph,PH
+ \gls{string}<r,R
+ \gls{string}<rh,RH
+ \gls{string}<\gls{glsxtrLatinS}
+ \gls{string}<\gls{glsxtrLatinT}
+ \gls{string}<th,TH
+ \gls{string}<u,U
+ \gls{string}<w,W
+ \gls{string}<y,Y
+ }
+}
+\marg{}\comment{glossaries-extra-bib2gls.sty not loaded}
+\end{codebox}
+(The use of \gls{string} is in case the \code{<} character
has been made active.) You can provide more than one rule-block
-per local, to allow for loanwords or foreign words. For example,
-you could provide \cs{glsxtrWelshIRules}, \cs{glsxtrWelshIIRules}
+per local, to allow for loanwords or foreign words. For example,
+you could provide \csfmt{glsxtrWelshIRules}, \csfmt{glsxtrWelshIIRules}
etc.
If the rules are for a particular script (independent of language
or region) then they can be provided in a file given by
-\texttt{glossariesxtr-}\meta{script}\texttt{.ldf} instead. For
-example, the file \texttt{glossariesxtr-Cyrl.ldf} could contain:
-\begin{verbatim}
-\ProvidesGlossariesExtraLang{Cyrl}[2018/02/23 v1.0]
-\newcommand*{\glsxtrGeneralCyrillicIRules}{%
- % Cyrillic rules
-}
-\newcommand*{\glsxtrGeneralCyrillicIIRules}{%
- % an alternative set of Cyrillic rules
-}
-\end{verbatim}
-(Remember that the required document language scripts need to be tracked
+\metafilefmt{glossariesxtr-}{script}{.ldf} instead. For
+example, the file \filefmt{glossariesxtr-Cyrl.ldf} could contain:
+\begin{codebox}
+\gls{ProvidesGlossariesExtraLang}\marg{Cyrl}[2018/02/23 v1.0]
+\cmd{newcommand}*\marg{\cmd{glsxtrGeneralCyrillicIRules}}\marg{\%
+ \comment{Cyrillic rules}
+}
+\cmd{newcommand}*\marg{\cmd{glsxtrGeneralCyrillicIIRules}}\marg{\%
+ \comment{an alternative set of Cyrillic rules}
+}
+\end{codebox}
+Remember that the required document language scripts need to be tracked
through the \sty{tracklang} package, in order for these files to be
automatically loaded. This essentially means ensuring you load the
appropriate language package before \sty{tracklang} is loaded by
the base \sty{glossaries} package or any other package that uses it.
-See the \sty{tracklang} documentation for further details.)
+See the \sty{tracklang} documentation for further details.
Alternatively, if the rules are specific to a subject rather than
a region or language, then you can provide a supplementary
-package. For example, if you have a package called, say,
+package. For example, if you have a package called, say,
\styfmt{mapsymbols} that provides map symbols, then the file
-\texttt{mapsymbols.sty} might contain:
-\begin{verbatim}
-\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{mapsymbols}
-% some package or font loading stuff here to provide
-% the appropriate symbols
-\newcommand{\Stadium}{...}
-\newcommand{\Battlefield}{...}
-\newcommand{\Harbour}{...}
-% etc
-
-% Provide a rule block:
-\newcommand{\MapSymbolOrder}{%
- \glshex 2694 % crossed-swords 0x2694
- \string< \glshex 2693 % anchor 0x2693
- \string< \glshex 26BD % football 0x26BD
-}
-\end{verbatim}
-and the supplementary file \texttt{mapsymbols.bib} can provide
-the appropriate definitions for \gls{bib2gls}:
-\begin{verbatim}
-@preamble{"\glsxtrprovidecommand{\Harbour}{\char"2693}
-\glsxtrprovidecommand{\Battlefield}{\char"2694}
-\glsxtrprovidecommand{\Stadium}{\char"26BD}"}
-\end{verbatim}
+\filefmt{mapsymbols.sty} might contain:
+\begin{codebox}
+\cmd{ProvidesPackage}\marg{mapsymbols}
+\comment{some package or font loading stuff here to provide}
+\comment{the appropriate symbols}
+\cmd{newcommand}\marg{\cmd{Stadium}}\marg{...}
+\cmd{newcommand}\marg{\cmd{Battlefield}}\marg{...}
+\cmd{newcommand}\marg{\cmd{Harbour}}\marg{...}
+\comment{etc}
+\codepar
+\comment{Provide a rule block:}
+\cmd{newcommand}\marg{\cmd{MapSymbolOrder}}\marg{\%
+ \gls{glshex} 2694 \comment{crossed-swords 0x2694}
+ \gls{string}< \gls{glshex} 2693 \comment{anchor 0x2693}
+ \gls{string}< \gls{glshex} 26BD \comment{football 0x26BD}
+}
+\end{codebox}
+and the supplementary file \filefmt{mapsymbols.bib} can provide
+the appropriate definitions for \app{bib2gls}:
+\begin{codebox}
+\atentry{preamble}\marg{"\gls{glsxtrprovidecommand}\marg{\cmd{Harbour}}\marg{\cmd{char}"2693}
+\gls{glsxtrprovidecommand}\marg{\cmd{Battlefield}}\marg{\cmd{char}"2694}
+\gls{glsxtrprovidecommand}\marg{\cmd{Stadium}}\marg{\cmd{char}"26BD}"}
+\end{codebox}
Now both the preamble and rule block can be used in the resource
set:
-\begin{verbatim}
-\usepackage{mapsymbols}% my custom package
-\usepackage[record]{glossaries-extra}
-
-\GlsXtrLoadResources[
- src={mapsymbols,% <--- my custom mapsymbols.bib
- entries% data in entries.bib
+\begin{codebox}
+\cmd{usepackage}\marg{mapsymbols}\comment{my custom package}
+\cmd{usepackage}[\opt{record}]\marg{glossaries-extra}
+\codepar
+\gls{GlsXtrLoadResources}\oarg{
+ \resourceoptvalm{src}{mapsymbols,\comment{<--- \textbf{my custom mapsymbols.bib}}
+ entries\comment{data in entries.bib}
},
- sort={custom},
- sort-rule={\glsxtrcontrolrules % control codes
- ;\glsxtrspacerules % space characters
- ;\glsxtrnonprintablerules % non-printable characters
- ;\glsxtrcombiningdiacriticrules % combining diacritics
- ,\glsxtrhyphenrules % hyphens
- <\glsxtrgeneralpuncrules % general punctuation
- <\glsxtrdigitrules % 0, ..., 9
- <\glsxtrfractionrules % fraction symbols
- <\MapSymbolOrder % <--- custom map symbols
- <\glsxtrMathItalicGreekIrules % math-greek symbols
- <\glsxtrGeneralLatinIrules % Latin letters
+ \resourceoptval{sort}{custom},
+ \resourceoptvalm{sort-rule}{\gls{glsxtrcontrolrules} \comment{control codes}
+ ;\gls{glsxtrspacerules} \comment{space characters}
+ ;\gls{glsxtrnonprintablerules} \comment{non-printable characters}
+ ;\gls{glsxtrcombiningdiacriticrules} \comment{combining diacritics}
+ ,\gls{glsxtrhyphenrules} \comment{hyphens}
+ <\gls{glsxtrgeneralpuncrules} \comment{general punctuation}
+ <\gls{glsxtrdigitrules} \comment{0, ..., 9}
+ <\gls{glsxtrfractionrules} \comment{fraction symbols}
+ <\cmd{MapSymbolOrder} \comment{<--- \textbf{custom map symbols}}
+ <\gls{glsxtrMathItalicGreekIrules} \comment{math-greek symbols}
+ <\gls{glsxtrGeneralLatinIrules} \comment{Latin letters}
}
-]
-\end{verbatim}
+}
+\end{codebox}
+(As before, you may need to use \gls{string} in front of characters
+like \code{<} if they have been made active.)
The following commands are provided by
\sty{glossaries-extra-bib2gls}. They should be separated by
-the rule separator characters \texttt{;}~(semi-colon) or \texttt{,}~(comma)
-or \verb|&|~(ampersand) or \texttt{<}~(less than). See Java's
+the rule separator characters \code{;}~(semi-colon) or \code{,}~(comma)
+or \verb|&|~(ampersand) or \code{<}~(less than). See Java's
\href{http://docs.oracle.com/javase/8/docs/api/java/text/RuleBasedCollator.html}{Rule\-Based\-Collator}
documentation for details of the rule syntax.
For example, the following will place the mathematical Greek
-symbols (\ics{alpha}, \ics{Alpha}, \ics{beta}, \ics{Beta} etc)
+symbols (\gls{alpha}, \gls{Alpha}, \gls{beta}, \gls{Beta} etc)
in a block before Latin characters:
-\begin{verbatim}
-sort-rule={\glsxtrcontrolrules
- ;\glsxtrspacerules
- ;\glsxtrnonprintablerules
- ;\glsxtrcombiningdiacriticrules
- ,\glsxtrhyphenrules
- <\glsxtrgeneralpuncrules
- <\glsxtrdigitrules
- <\glsxtrfractionrules
- <\glsxtrMathItalicGreekIrules
- <\glsxtrGeneralLatinIVrules
- <\glsxtrLatinAA
- <\glsxtrLatinOslash
-}
-\end{verbatim}
-
-\begin{definition}[\DescribeMacro\glsxtrcontrolrules]
-\cs{glsxtrcontrolrules}
-\end{definition}
+\begin{codebox}
+\resourceoptvalm{sort-rule}{\gls{glsxtrcontrolrules}
+ ;\gls{glsxtrspacerules}
+ ;\gls{glsxtrnonprintablerules}
+ ;\gls{glsxtrcombiningdiacriticrules}
+ ,\gls{glsxtrhyphenrules}
+ <\gls{glsxtrgeneralpuncrules}
+ <\gls{glsxtrdigitrules}
+ <\gls{glsxtrfractionrules}
+ <\gls{glsxtrMathItalicGreekIrules}
+ <\gls{glsxtrGeneralLatinIVrules}
+ <\gls{glsxtrLatinAA}
+ <\gls{glsxtrLatinOslash}
+}
+\end{codebox}
+
+\paragraph{Non-Letters}
+\label{sec:bib2glscustomsortnonletters}
+
+\cmddef{glsxtrcontrolrules}
These are control characters that are usually placed at the start of
a rule in the ignored section. They typically won't occur in
any sort values, but if they do they should normally be ignored.
-\begin{definition}[\DescribeMacro\glsxtrspacerules]
-\cs{glsxtrspacerules}
-\end{definition}
+\cmddef{glsxtrspacerules}
These are space characters. They typically come after the control
-characters with the two blocks separated by a \texttt{;}~(semi-colon).
+characters with the two blocks separated by a \code{;}~(semi-colon).
-\begin{definition}[\DescribeMacro\glsxtrnonprintablerules]
-\cs{glsxtrnonprintablerules}
-\end{definition}
+\cmddef{glsxtrnonprintablerules}
These are non-printable characters (BOM, tabs, line feed and
carriage return). They typically come after the spaces separated by
-a \texttt{;}~(semi-colon). These characters aren't checked for by
-\gls{bib2gls} when it determines whether or not to use the
+a \code{;}~(semi-colon). These characters aren't checked for by
+\app{bib2gls} when it determines whether or not to use the
interpreter, so a~TAB or newline character may end up in the sort
value if it wasn't interpreted.
-\begin{definition}[\DescribeMacro\glsxtrcombiningdiacriticrules]
-\cs{glsxtrcombiningdiacriticrules}
-\end{definition}
+\cmddef{glsxtrcombiningdiacriticrules}
These are combining diacritic marks which typically follow
-the space and non-printable blocks (separated by a semi-colon). This command is
+the space and non-printable blocks (separated by a semi-colon). This command is
defined in terms of sub-block commands:
-\begin{verbatim}
-\newcommand*{\glsxtrcombiningdiacriticrules}{%
- \glsxtrcombiningdiacriticIrules\string;
- \glsxtrcombiningdiacriticIIrules\string;
- \glsxtrcombiningdiacriticIIIrules\string;
- \glsxtrcombiningdiacriticIVrules
-}
-\end{verbatim}
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{glsxtrcombiningdiacriticrules}}\marg{\%
+ \gls{glsxtrcombiningdiacriticIrules}\gls{string};
+ \gls{glsxtrcombiningdiacriticIIrules}\gls{string};
+ \gls{glsxtrcombiningdiacriticIIIrules}\gls{string};
+ \gls{glsxtrcombiningdiacriticIVrules}
+}
+\end{compactcodebox}
If you prefer, you can use the sub-blocks directly in your
-required ordered.
+required ordered.
-\begin{definition}[\DescribeMacro\glsxtrcombiningdiacriticIrules]
-\cs{glsxtrcombiningdiacriticIrules}
-\end{definition}
+\cmddef{glsxtrcombiningdiacriticIrules}
This contains the combining diacritics: acute, grave, breve,
-circumflex, caron, ring, vertical line above, diaeresis (umlaut),
+circumflex, caron, ring, vertical line above, diaeresis (umlaut),
double acute, tilde, dot above, combining macron.
-\begin{definition}[\DescribeMacro\glsxtrcombiningdiacriticIIrules]
-\cs{glsxtrcombiningdiacriticIIrules}
-\end{definition}
+\cmddef{glsxtrcombiningdiacriticIIrules}
This contains the combining diacritics: short solidus overlay,
cedilla, ogonek, dot below, low line, overline, hook above,
double vertical line above, double grave accent, candrabindu,
inverted breve, turned comma above, comma above, reversed comma
above, comma above right, grave accent below, acute accent below.
-\begin{definition}[\DescribeMacro\glsxtrcombiningdiacriticIIIrules]
-\cs{glsxtrcombiningdiacriticIIIrules}
-\end{definition}
+\cmddef{glsxtrcombiningdiacriticIIIrules}
This contains the combining diacritics: left tack below, right tack
below, left angle above, horn, left half ring below, up tack below,
down tack below, plus sign below, minus sign below, palatalized hook
@@ -12355,10 +42825,8 @@ perispomeni, Greek dialytika tonos, Greek ypogegrammeni, double
tilde, double inverted breve, Cyrillic titlo, Cyrillic
palatalization, Cyrillic dasia pneumata, Cyrillic psili pneumata.
-\begin{definition}[\DescribeMacro\glsxtrcombiningdiacriticIVrules]
-\cs{glsxtrcombiningdiacriticIVrules}
-\end{definition}
-This contains the combining diacritics:
+\cmddef{glsxtrcombiningdiacriticIVrules}
+This contains the combining diacritics:
left harpoon above, right harpoon above, long vertical line overlay,
short vertical line overlay, anticlockwise arrow above, clockwise
arrow above, left arrow above, right arrow above, ring overlay,
@@ -12367,3183 +42835,2141 @@ above, four dots above, enclosing circle, enclosing square,
enclosing diamond, enclosing circle backslash, left right arrow
above.
-\begin{definition}[\DescribeMacro\glsxtrhyphenrules]
-\cs{glsxtrhyphenrules}
-\end{definition}
+\cmddef{glsxtrhyphenrules}
This contains hyphens (including the minus sign 0x2212). This rule
block typically comes after the diacritic rules separated by a
comma.
-\begin{definition}[\DescribeMacro\glsxtrgeneralpuncrules]
-\cs{glsxtrgeneralpuncrules}
-\end{definition}
+\cmddef{glsxtrgeneralpuncrules}
This contains punctuation characters. This rule
block typically comes after the hyphen rules separated by a
-less than (\texttt{<}). As with the combining diacritics, this
+less than (\code{<}). As with the combining diacritics, this
command is defined in terms of sub-blocks which may be used directly
instead if a different order is required:
-\begin{verbatim}
-\newcommand*{\glsxtrgeneralpuncrules}{%
- \glsxtrgeneralpuncIrules
- \string<\glsxtrcurrencyrules
- \string<\glsxtrgeneralpuncIIrules
-}
-\end{verbatim}
-
-\begin{definition}[\DescribeMacro\glsxtrgeneralpuncIrules]
-\cs{glsxtrgeneralpuncIrules}
-\end{definition}
-This is the first punctuation sub-block containing:
-underscore, macron, comma, semi-colon, colon, exclamation mark,
+\begin{codebox}
+\cmd{newcommand}*\marg{\gls{glsxtrgeneralpuncrules}}\marg{\%
+ \gls{glsxtrgeneralpuncIrules}
+ \gls{string}<\gls{glsxtrcurrencyrules}
+ \gls{string}<\gls{glsxtrgeneralpuncIIrules}
+}
+\end{codebox}
+
+\cmddef{glsxtrgeneralpuncIrules}
+This is defined as:
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{glsxtrgeneralpuncIrules}}\marg{\comment{}
+ \gls{glsxtrgeneralpuncmarksrules}
+ \cmd{string}<\gls{glsxtrgeneralpuncaccentsrules}
+ \cmd{string}<\gls{glsxtrgeneralpuncquoterules}
+ \cmd{string}<\gls{glsxtrgeneralpuncbracketrules}
+ \cmd{string}<\gls{glsxtrgeneralpuncsignrules}
+}
+\end{compactcodebox}
+
+\cmddef{glsxtrgeneralpuncmarksrules}
+This contains: underscore, macron, comma, semi-colon, colon, exclamation mark,
inverted exclamation mark, question mark, inverted question mark,
-solidus, full stop, acute accent, grave accent, circumflex accent,
-diaersis, tilde, middle dot, cedilla, straight apostrophe, straight
-double quote, left guillemet, right guillemet, left parenthesis,
+solidus, \idx{fullstop}.
+
+\cmddef{glsxtrgeneralpuncaccentsrules}
+This contains: acute accent, grave accent, circumflex accent,
+diaeresis, tilde, middle dot, cedilla.
+
+\cmddef{glsxtrgeneralpuncquoterules}
+This contains: straight apostrophe, straight
+double quote, left guillemet, right guillemet.
+
+\cmddef{glsxtrgeneralpuncbracketrules}
+This contains: left parenthesis,
right parenthesis, left square bracket, right square bracket, left
-curly bracket, right curly bracket, section sign, pilcrow sign,
+curly bracket, right curly bracket.
+
+\cmddef{glsxtrgeneralpuncsignrules}
+This contains: section sign, pilcrow sign,
copyright sign, registered sign, at sign.
-\begin{definition}[\DescribeMacro\glsxtrcurrencyrules]
-\cs{glsxtrcurrencyrules}
-\end{definition}
+\cmddef{glsxtrcurrencyrules}
This sub-block contains some currency symbols:
currency sign, Thai currency symbol baht, cent sign, colon sign,
cruzeiro sign, dollar sign, dong sign, euro sign, French franc sign,
lira sign, mill sign, naira sign, peseta sign, pound sign, rupee
sign, new sheqel sign, won sign, yen sign.
-\begin{definition}[\DescribeMacro\glsxtrgeneralpuncIIrules]
-\cs{glsxtrgeneralpuncIIrules}
-\end{definition}
+\cmddef{glsxtrgeneralpuncIIrules}
This sub-block contains some other punctuation symbols:
asterisk, backslash, ampersand, hash sign, percent sign, plus sign,
plus-minus sign, division sign, multiplication sign, less-than sign,
equals sign, greater-than sign, not sign, vertical bar (pipe),
broken bar, degree sign, micron sign.
-\begin{definition}[\DescribeMacro\glsxtrdigitrules]
-\cs{glsxtrdigitrules}
-\end{definition}
+\cmddef{glsxtrdigitrules}
This rule block contains the Basic Latin digits (0, \ldots, 9)
and the subscript and superscript digits (\textsubscript{0}
\textsuperscript{0} etc) made equivalent to the
corresponding Basic Latin digit. The digit block typically
comes after the punctuation rules separated by a less than
-(\texttt{<}).
+(\code{<}).
-\begin{definition}[\DescribeMacro\glsxtrBasicDigitrules]
-\cs{glsxtrBasicDigitrules}
-\end{definition}
+\cmddef{glsxtrBasicDigitrules}
This rule block contains just the Basic Latin digits (0, \ldots, 9).
-\begin{definition}[\DescribeMacro\glsxtrSubScriptDigitrules]
-\cs{glsxtrSubScriptDigitrules}
-\end{definition}
+\cmddef{glsxtrSubScriptDigitrules}
This rule block contains just the subscript digits
(\textsubscript{0} \ldots\ \textsubscript{9}).
-\begin{definition}[\DescribeMacro\glsxtrSuperScriptDigitrules]
-\cs{glsxtrSuperScriptDigitrules}
-\end{definition}
+\cmddef{glsxtrSuperScriptDigitrules}
This rule block contains just the superscript digits
(\textsuperscript{0} \ldots\ \textsuperscript{9}).
-\begin{definition}[\DescribeMacro\glsxtrfractionrules]
-\cs{glsxtrfractionrules}
-\end{definition}
-This rule block contains vulgar fraction characters. The digit block
-typically comes after the digit rules separated by a less than
-(\texttt{<}).
+\cmddef{glsxtrfractionrules}
+This rule block contains vulgar fraction characters from the Unicode
+Number Forms block. The digit block typically comes after the digit
+rules separated by a less than (\code{<}).
+
+\cmddef{glsxtrIgnorableRules}
+A shortcut that expands to the ignorable rules:
+\begin{compactcodebox}
+ \gls{glsxtrcontrolrules}
+ ;\gls{glsxtrspacerules}
+ ;\gls{glsxtrnonprintablerules}
+\end{compactcodebox}
+
+\cmddef{glsxtrGeneralInitRules}
+A shortcut that expands to common initial rules:
+\begin{compactcodebox}
+ \gls{glsxtrIgnorableRules}
+ ;\gls{glsxtrcombiningdiacriticrules}
+ ;\gls{glsxtrhyphenrules}
+ <\gls{glsxtrgeneralpuncrules}
+ <\gls{glsxtrdigitrules}
+ <\gls{glsxtrfractionrules}
+\end{compactcodebox}
+Note that this includes the combining diacritic rules, which won't
+be appropriate for languages with accented characters.
There are a number of Latin rule blocks. Some of these included
extended characters or ligatures (such as \ss\ or \oe) but they don't
include accented characters. If you require a Latin rule block
-that includes accented characters, digraphs, trigraphs or
+that includes accented characters, digraphs, trigraphs or
other extended characters, then it's best to provide
-similar commands in a \texttt{glossariesxtr-}\meta{tag}\texttt{.ldf}
+similar commands in a \metafilefmt{glossariesxtr-}{tag}{.ldf}
file for the particular language or region.
-\begin{definition}[\DescribeMacro\glsxtrGeneralLatinIrules]
-\cs{glsxtrGeneralLatinIrules}
-\end{definition}
+\paragraph{Latin Letters}
+\label{sec:bib2glscustomsortlatin}
+
+\cmddef{glsxtrGeneralLatinIrules}
This is just the basic (non-extended) Latin alphabet with the superscript
and subscript Latin letters (\textsuperscript{a} \textsubscript{a}
etc) treated as the equivalent basic Latin letter. (If you don't
want the subscripts and superscripts included you can redefine
-\cs{glsxtrLatinA} etc to omit them.)
-
-\begin{definition}[\DescribeMacro\glsxtrGeneralLatinIIrules]
-\cs{glsxtrGeneralLatinIIrules}
-\end{definition}
-This is like \cs{glsxtrGeneralLatinIrules} but it includes eth
-(Ð) between `D' and `E' and eszett (\ss) treated as `ss'.
-
-\begin{definition}[\DescribeMacro\glsxtrGeneralLatinIIIrules]
-\cs{glsxtrGeneralLatinIIIrules}
-\end{definition}
-This is like \cs{glsxtrGeneralLatinIrules} but it includes eth
-(Ð) between `D' and `E' and eszett (\ss) treated as `sz'.
-
-\begin{definition}[\DescribeMacro\glsxtrGeneralLatinIVrules]
-\cs{glsxtrGeneralLatinIVrules}
-\end{definition}
-This is like \cs{glsxtrGeneralLatinIrules} but it includes eth
-(Ð) between `D' and `E', ae-ligature (\ae) is treated as `ae',
-oe-ligature (\oe) is treated as `oe', eszett (\ss) treated as `ss'
-and thorn (þ) is treated as `th'.
-
-\begin{definition}[\DescribeMacro\glsxtrGeneralLatinVrules]
-\cs{glsxtrGeneralLatinVrules}
-\end{definition}
-This is like \cs{glsxtrGeneralLatinIrules} but it includes eth
-(Ð) between `D' and `E', eszett (\ss) treated as `ss'
-and thorn (þ) treated as `th'.
-
-\begin{definition}[\DescribeMacro\glsxtrGeneralLatinVIrules]
-\cs{glsxtrGeneralLatinVIrules}
-\end{definition}
-This is like \cs{glsxtrGeneralLatinIrules} but it includes eth
-(Ð) between `D' and `E', eszett (\ss) treated as `sz'
-and thorn (þ) treated as `th'.
-
-\begin{definition}[\DescribeMacro\glsxtrGeneralLatinVIIrules]
-\cs{glsxtrGeneralLatinVIIrules}
-\end{definition}
-This is like \cs{glsxtrGeneralLatinIrules} but it includes
-ae-ligature (\ae) between `A' and `B', eth (Ð) between `D' and
-`E', insular G (Ᵹ) instead of `G', oe-ligature between `O' and `P',
-long~s (ſ) equivalent to `s', thorn (þ) between `T' and `U' and wynn (Ƿ)
-instead of W.
-
-\begin{definition}[\DescribeMacro\glsxtrGeneralLatinVIIIrules]
-\cs{glsxtrGeneralLatinVIIIrules}
-\end{definition}
-This is like \cs{glsxtrGeneralLatinIrules} but ae-ligature (\ae) is treated as `ae',
-oe-ligature (\oe) is treated as `oe', eszett (\ss) treated as `ss',
-thorn (þ) is treated as `th', \O\ is treated as `O' and
-`\L' is treated as `L'.
-
-\begin{definition}[\DescribeMacro\glsxtrLatinA]
-\cs{glsxtrLatinA}
-\end{definition}
-A mini-rule that just covers `A' but includes the sub- and
+\gls{glsxtrLatinA} etc to omit them.)
+
+\cmddef{glsxtrGeneralLatinIIrules}
+This is like \gls{glsxtrGeneralLatinIrules} but it includes eth
+(\Eth) between \qt{D} and \qt{E} and eszett (\ss) treated as \qt{ss}.
+
+\cmddef{glsxtrGeneralLatinIIIrules}
+This is like \gls{glsxtrGeneralLatinIrules} but it includes eth
+(\Eth) between \qt{D} and \qt{E} and eszett (\ss) treated as \qt{sz}.
+
+\cmddef{glsxtrGeneralLatinIVrules}
+This is like \gls{glsxtrGeneralLatinIrules} but it includes eth
+(\Eth) between \qt{D} and \qt{E}, ae-ligature (\ae) is treated
+as \qt{ae}, oe-ligature (\oe) is treated as \qt{oe}, eszett (\ss)
+treated as \qt{ss} and thorn (\thorn) is treated as \qt{th}.
+
+\cmddef{glsxtrGeneralLatinVrules}
+This is like \gls{glsxtrGeneralLatinIrules} but it includes eth
+(\Eth) between \qt{D} and \qt{E}, eszett (\ss) treated as \qt{ss}
+and thorn (\thorn) treated as \qt{th}.
+
+\cmddef{glsxtrGeneralLatinVIrules}
+This is like \gls{glsxtrGeneralLatinIrules} but it includes eth
+(\Eth) between \qt{D} and \qt{E}, eszett (\ss) treated as \qt{sz}
+and thorn (\thorn) treated as \qt{th}.
+
+\cmddef{glsxtrGeneralLatinVIIrules}
+This is like \gls{glsxtrGeneralLatinIrules} but it includes
+ae-ligature (\ae) between \qt{A} and \qt{B}, eth (\Eth) between \qt{D} and
+\qt{E}, insular G (\insularg) instead of \qt{G}, oe-ligature (\oe)
+between \qt{O} and \qt{P}, long~s (\longs) equivalent to \qt{s},
+thorn (\thorn) between \qt{T} and \qt{U} and wynn (\wynn)
+instead of \qt{W}.
+
+\cmddef{glsxtrGeneralLatinVIIIrules}
+This is like \gls{glsxtrGeneralLatinIrules} but ae-ligature (\ae) is
+treated as \qt{ae}, oe-ligature (\oe) is treated as \qt{oe}, eszett
+(\ss) treated as \qt{ss}, thorn (\thorn) is treated as \qt{th}, \O\
+is treated as \qt{O} and \qt{\L} is treated as \qt{L}.
+
+\cmddef{glsxtrGeneralLatinAtoMrules}
+A mini-rule subset of General Latin~I rules that just covers A--M.
+
+\cmddef{glsxtrGeneralLatinNtoZrules}
+A mini-rule subset of General Latin~I rules that just covers N--Z.
+
+\cmddef{glsxtrGeneralLatinAtoGrules}
+A mini-rule subset of General Latin~I rules that just covers A--G.
+
+\cmddef{glsxtrGeneralLatinHtoMrules}
+A mini-rule subset of General Latin~I rules that just covers H--M.
+
+\cmddef{glsxtrGeneralLatinNtoSrules}
+A mini-rule subset of General Latin~I rules that just covers N--S.
+
+\cmddef{glsxtrGeneralLatinTtoZrules}
+A mini-rule subset of General Latin~I rules that just covers T--Z.
+
+\cmddef{glsxtrLatinA}
+A mini-rule that just covers \qt{A} but includes the sub- and
superscript A.
-\begin{definition}[\DescribeMacro\glsxtrLatinE]
-\cs{glsxtrLatinE}
-\end{definition}
-A mini-rule that just covers `E' but includes the
-subscript E.
-
-\begin{definition}[\DescribeMacro\glsxtrLatinH]
-\cs{glsxtrLatinH}
-\end{definition}
-A mini-rule that just covers `H' but includes the
-subscript H.
-
-\begin{definition}[\DescribeMacro\glsxtrLatinK]
-\cs{glsxtrLatinK}
-\end{definition}
-A mini-rule that just covers `K' but includes the
-subscript K.
-
-\begin{definition}[\DescribeMacro\glsxtrLatinI]
-\cs{glsxtrLatinI}
-\end{definition}
-A mini-rule that just covers `I' but includes the
-superscript I.
-
-\begin{definition}[\DescribeMacro\glsxtrLatinL]
-\cs{glsxtrLatinL}
-\end{definition}
-A mini-rule that just covers `L' but includes the
-subscript L.
-
-\begin{definition}[\DescribeMacro\glsxtrLatinM]
-\cs{glsxtrLatinM}
-\end{definition}
-A mini-rule that just covers `M' but includes the
-subscript M.
-
-\begin{definition}[\DescribeMacro\glsxtrLatinN]
-\cs{glsxtrLatinN}
-\end{definition}
-A mini-rule that just covers `N' but includes the
-sub- and superscript N.
-
-\begin{definition}[\DescribeMacro\glsxtrLatinO]
-\cs{glsxtrLatinO}
-\end{definition}
-A mini-rule that just covers `O' but includes the
-sub- and superscript O.
-
-\begin{definition}[\DescribeMacro\glsxtrLatinP]
-\cs{glsxtrLatinP}
-\end{definition}
-A mini-rule that just covers `P' but includes the
-subscript P.
-
-\begin{definition}[\DescribeMacro\glsxtrLatinS]
-\cs{glsxtrLatinS}
-\end{definition}
-A mini-rule that just covers `S' but includes the
-subscript S.
-
-\begin{definition}[\DescribeMacro\glsxtrLatinT]
-\cs{glsxtrLatinT}
-\end{definition}
-A mini-rule that just covers `T' but includes the
-subscript T.
-
-\begin{definition}[\DescribeMacro\glsxtrLatinX]
-\cs{glsxtrLatinX}
-\end{definition}
-A mini-rule that just covers `X' but includes the
-subscript X.
-
-\begin{definition}[\DescribeMacro\glsxtrLatinEszettSs]
-\cs{glsxtrLatinEszettSs}
-\end{definition}
-A mini-rule that just covers eszett (\ss) and makes long~s (ſ) followed
-by short `s' equivalent to `\ss'. (This is used in the above blocks
-that treat `\ss' as `ss'.)
-
-\begin{definition}[\DescribeMacro\glsxtrLatinEszettSz]
-\cs{glsxtrLatinEszettSz}
-\end{definition}
-A mini-rule that just covers eszett (\ss) and makes long~s (ſ) followed
-by `z' equivalent to `\ss'. (This is used in the above blocks
-that treat `\ss' as `sz'.)
-
-\begin{definition}[\DescribeMacro\glsxtrLatinEth]
-\cs{glsxtrLatinEth}
-\end{definition}
-A mini-rule for eth (Ð) so you don't need to remember the
+\cmddef{glsxtrLatinE}
+A mini-rule that just covers \qt{E} but includes the subscript E.
+
+\cmddef{glsxtrLatinH}
+A mini-rule that just covers \qt{H} but includes the subscript H.
+
+\cmddef{glsxtrLatinK}
+A mini-rule that just covers \qt{K} but includes the subscript K.
+
+\cmddef{glsxtrLatinI}
+A mini-rule that just covers \qt{I} but includes the subscript I.
+
+\cmddef{glsxtrLatinM}
+A mini-rule that just covers \qt{M} but includes the subscript M.
+
+\cmddef{glsxtrLatinN}
+A mini-rule that just covers \qt{N} but includes the sub- and
+superscript N.
+
+\cmddef{glsxtrLatinO}
+A mini-rule that just covers \qt{O} but includes the sub- and
+superscript O.
+
+\cmddef{glsxtrLatinP}
+A mini-rule that just covers \qt{P} but includes the subscript P.
+
+\cmddef{glsxtrLatinS}
+A mini-rule that just covers \qt{S} but includes the subscript S.
+
+\cmddef{glsxtrLatinT}
+A mini-rule that just covers \qt{T} but includes the subscript T.
+
+\cmddef{glsxtrLatinX}
+A mini-rule that just covers \qt{X} but includes the subscript X.
+
+\cmddef{glsxtrLatinEszettSs}
+A mini-rule that just covers eszett (\ss) and makes \qt{\longs s} (long~s followed
+by short~s) equivalent to \qt{\ss}. (This is used in the above blocks
+that treat \qt{\ss} as \qt{ss}.)
+
+\cmddef{glsxtrLatinEszettSz}
+A mini-rule that just covers eszett (\ss) and makes \qt{\longs z} (long~s followed
+by z) equivalent to \qt{\ss}. (This is used in the above blocks
+that treat \qt{\ss} as \qt{sz}.)
+
+\cmddef{glsxtrLatinEth}
+A mini-rule for eth (\Eth, \eth) so you don't need to remember the
Unicode values.
-\begin{definition}[\DescribeMacro\glsxtrLatinThorn]
-\cs{glsxtrLatinThorn}
-\end{definition}
-A mini-rule for thorn (þ) so you don't need to remember the
+\cmddef{glsxtrLatinThorn}
+A mini-rule for thorn (\Thorn, \thorn) so you don't need to remember the
Unicode values.
-\begin{definition}[\DescribeMacro\glsxtrLatinAELigature]
-\cs{glsxtrLatinAELigature}
-\end{definition}
-A mini-rule for ae-ligature (\ae) so you don't need to remember the
+\cmddef{glsxtrLatinAELigature}
+A mini-rule for ae-ligature (\AE, \ae) so you don't need to remember the
Unicode values.
-\begin{definition}[\DescribeMacro\glsxtrLatinOELigature]
-\cs{glsxtrLatinOELigature}
-\end{definition}
-A mini-rule for oe-ligature (\oe) so you don't need to remember the
+\cmddef{glsxtrLatinOELigature}
+A mini-rule for oe-ligature (\OE, \oe) so you don't need to remember the
Unicode values.
-\begin{definition}[\DescribeMacro\glsxtrLatinOslash]
-\cs{glsxtrLatinOslash}
-\end{definition}
-A mini-rule for `\O' so you don't need to remember the
+\cmddef{glsxtrLatinOslash}
+A mini-rule for o-slash (\O, \o) so you don't need to remember the
Unicode values.
-\begin{definition}[\DescribeMacro\glsxtrLatinLslash]
-\cs{glsxtrLatinLslash}
-\end{definition}
-A mini-rule for `\L' so you don't need to remember the
+\cmddef{glsxtrLatinLslash}
+A mini-rule for l-slash (\L, \l) so you don't need to remember the
Unicode values.
-\begin{definition}[\DescribeMacro\glsxtrLatinWynn]
-\cs{glsxtrLatinWynn}
-\end{definition}
-A mini-rule for wynn (Ƿ) so you don't need to remember the
+\cmddef{glsxtrLatinWynn}
+A mini-rule for wynn (\Wynn, \wynn) so you don't need to remember the
Unicode values.
-\begin{definition}[\DescribeMacro\glsxtrLatinInsularG]
-\cs{glsxtrLatinInsularG}
-\end{definition}
-A mini-rule for insular G (Ᵹ) so you don't need to remember the
+\cmddef{glsxtrLatinInsularG}
+A mini-rule for insular-G (\InsularG, \insularg) so you don't need to remember the
Unicode values.
-\begin{definition}[\DescribeMacro\glsxtrLatinSchwa]
-\cs{glsxtrLatinSchwa}
-\end{definition}
-A mini-rule that just covers schwa (Ə) but includes the
-subscript schwa. (Not used in any of the provided Latin rule blocks
-described above.)
+\cmddef{glsxtrLatinSchwa}
+A mini-rule for schwa (\Schwa, \schwa, \textsuperscript\schwa) so
+you don't need to remember the Unicode values. (Not used in any of
+the provided Latin rule blocks described above.)
-\begin{definition}[\DescribeMacro\glsxtrLatinAA]
-\cs{glsxtrLatinAA}
-\end{definition}
-A mini-rule for `\AA' so you don't need to remember the
+\cmddef{glsxtrLatinAA}
+A mini-rule for \qt{a with ring above} (\AA, \aa) so you don't need to remember the
Unicode values. (Not used in any of the provided Latin rule blocks
described above.)
-\begin{definition}[\DescribeMacro\glsxtrMathGreekIrules]
-\cs{glsxtrMathGreekIrules}
-\end{definition}
-A rule block for mathematical Greek (\ics{alpha}, \ics{beta} etc)
-and upright Greek (\ics{upalpha}, etc, from the \sty{upgreek}
-package) characters that includes digamma (\ics{digamma} and
-\ics{Digamma}) between epsilon and zeta. The upright and italic
+\paragraph{Math Greek}
+\label{sec:bib2glscustomsortmathgreek}
+
+\cmddef{glsxtrMathGreekIrules}
+A rule block for mathematical Greek (\gls{alpha}, \gls{beta} etc)
+and upright Greek (\gls{upalpha}, etc, from the \sty{upgreek}
+package) characters that includes digamma (\gls{digamma} and
+\gls{Digamma}) between epsilon and zeta. The upright and italic
versions are gathered together into the same letter group.
-\begin{definition}[\DescribeMacro\glsxtrMathGreekIIrules]
-\cs{glsxtrMathGreekIIrules}
-\end{definition}
-As \cs{glsxtrMathGreekIrules} but doesn't include digamma.
-
-\begin{definition}[\DescribeMacro\glsxtrMathUpGreekIrules]
-\cs{glsxtrMathUpGreekIrules}
-\end{definition}
-A rule block for upright Greek (\ics{upalpha}, etc, from
-the \sty{upgreek} package)
-characters that includes digamma (\ics{digamma} and \ics{Digamma})
-between epsilon and zeta.
+\cmddef{glsxtrMathGreekIIrules}
+As \gls{glsxtrMathGreekIrules} but doesn't include digamma.
+
+\cmddef{glsxtrMathUpGreekIrules}
+A rule block for upright Greek (\gls{upalpha}, etc, from the
+\sty{upgreek} package) characters that includes digamma
+(\gls{digamma} and \gls{Digamma}) between epsilon and zeta.
-\begin{definition}[\DescribeMacro\glsxtrMathUpGreekIIrules]
-\cs{glsxtrMathUpGreekIIrules}
-\end{definition}
-A rule block for upright Greek (\ics{upalpha}, etc, from
+\cmddef{glsxtrMathUpGreekIIrules}
+A rule block for upright Greek (\gls{upalpha}, etc, from
the \sty{upgreek} package) that doesn't include digamma.
-\begin{definition}[\DescribeMacro\glsxtrMathItalicGreekIrules]
-\cs{glsxtrMathItalicGreekIrules}
-\end{definition}
-A rule block for mathematical Greek (\ics{alpha}, \ics{Alpha}, etc)
-characters that includes digamma (\ics{diagamma} and \ics{Digamma})
-between epsilon and zeta. Note that even though the upper case
-\cs{Delta} etc are actually rendered upright by \LaTeX,
-\gls{bib2gls}['s] interpreter treats them as italic to help keep
-them close to the lower case versions.
-
-\begin{definition}[\DescribeMacro\glsxtrMathItalicGreekIIrules]
-\cs{glsxtrMathItalicGreekIIrules}
-\end{definition}
-A rule block for mathematical Greek (\ics{alpha}, \ics{Alpha}, etc)
-characters that doesn't include digamma.
+\cmddef{glsxtrMathItalicGreekIrules}
+A rule block for mathematical Greek (\gls{alpha}, \gls{Alpha}, etc)
+characters that includes digamma (\gls{digamma} and \gls{Digamma})
+between epsilon and zeta. Note that even though the \idx{uppercase}
+\gls{Delta} etc are actually rendered upright by \LaTeX,
+\app{bib2gls}['s] interpreter treats them as italic to help keep
+them close to the \idx{lowercase} versions.
-\begin{definition}[\DescribeMacro\glsxtrMathItalicUpperGreekIrules]
-\cs{glsxtrMathItalicUpperGreekIrules}
-\end{definition}
-A rule block for upper case mathematical Greek (\ics{Alpha},
-\ics{Beta}, etc) characters that includes digamma (\ics{Digamma})
-between epsilon and zeta.
+\cmddef{glsxtrMathItalicGreekIIrules}
+A rule block for mathematical Greek (\gls{alpha}, \gls{Alpha}, etc)
+characters that doesn't include digamma.
-\begin{definition}[\DescribeMacro\glsxtrMathItalicUpperGreekIIrules]
-\cs{glsxtrMathItalicUpperGreekIIrules}
-\end{definition}
-A rule block for upper case mathematical Greek (\ics{Alpha},
-\ics{Beta}, etc) characters that doesn't include digamma.
-
-\begin{definition}[\DescribeMacro\glsxtrMathItalicLowerGreekIrules]
-\cs{glsxtrMathItalicLowerGreekIrules}
-\end{definition}
-A rule block for lower case mathematical Greek (\ics{alpha},
-\ics{beta}, etc) characters that includes digamma (\ics{digamma})
+\cmddef{glsxtrMathItalicUpperGreekIrules}
+A rule block for \idx{uppercase} mathematical Greek (\gls{Alpha},
+\gls{Beta}, etc) characters that includes digamma (\gls{Digamma})
between epsilon and zeta.
-\begin{definition}[\DescribeMacro\glsxtrMathItalicLowerGreekIIrules]
-\cs{glsxtrMathItalicLowerGreekIIrules}
-\end{definition}
-A rule block for lower case mathematical Greek (\ics{alpha},
-\ics{beta}, etc) characters that doesn't include digamma.
-
-Additionally, there are commands in the form \cs{glsxtrUpAlpha},
-\cs{glsxtrUpBeta} etc and \cs{glsxtrMathItalicAlpha},
-\cs{glsxtrMathItalicBeta} etc
-that just cover the upper and lower case forms of a special
-Greek character (\cs{Upalpha}, \cs{upalpha} etc and \cs{Alpha},
-\cs{alpha} etc) as well as the following:
-
-\begin{definition}[\DescribeMacro\glsxtrMathItalicPartial]
-\cs{glsxtrMathItalicPartial}
-\end{definition}
-The partial derivative symbol ($\partial$).
-
-\begin{definition}[\DescribeMacro\glsxtrMathItalicNabla]
-\cs{glsxtrMathItalicNabla}
-\end{definition}
-The nabla symbol ($\nabla$).
+\cmddef{glsxtrMathItalicUpperGreekIIrules}
+A rule block for \idx{uppercase} mathematical Greek (\gls{Alpha},
+\gls{Beta}, etc) characters that doesn't include digamma.
+\cmddef{glsxtrMathItalicLowerGreekIrules}
+A rule block for \idx{lowercase} mathematical Greek (\gls{alpha},
+\gls{beta}, etc) characters that includes digamma (\gls{digamma})
+between epsilon and zeta.
-\section{Supplementary Commands}
-\label{sec:bib2glssupplementarycommands}
+\cmddef{glsxtrMathItalicLowerGreekIIrules}
+A rule block for lower case mathematical Greek (\gls{alpha},
+\gls{beta}, etc) characters that doesn't include digamma.
+
+Additionally, there are commands that just cover the \idx{uppercase} and
+\idx{lowercase} forms of a special
+Greek character (\gls{Upalpha}, \gls{upalpha} etc and \gls{Alpha},
+\gls{alpha} etc):
+\inlineglsdef{glsxtrUpAlpha},
+\inlineglsdef{glsxtrMathItalicAlpha},
+\inlineglsdef{glsxtrUpBeta},
+\inlineglsdef{glsxtrMathItalicBeta},
+\inlineglsdef{glsxtrUpGamma},
+\inlineglsdef{glsxtrMathItalicGamma},
+\inlineglsdef{glsxtrUpDelta},
+\inlineglsdef{glsxtrMathItalicDelta},
+\inlineglsdef{glsxtrUpEpsilon},
+\inlineglsdef{glsxtrMathItalicEpsilon},
+\inlineglsdef{glsxtrUpDigamma},
+\inlineglsdef{glsxtrMathItalicDigamma},
+\inlineglsdef{glsxtrUpZeta},
+\inlineglsdef{glsxtrMathItalicZeta},
+\inlineglsdef{glsxtrUpEta},
+\inlineglsdef{glsxtrMathItalicEta},
+\inlineglsdef{glsxtrUpTheta},
+\inlineglsdef{glsxtrMathItalicTheta},
+\inlineglsdef{glsxtrUpIota},
+\inlineglsdef{glsxtrMathItalicIota},
+\inlineglsdef{glsxtrUpKappa},
+\inlineglsdef{glsxtrMathItalicKappa},
+\inlineglsdef{glsxtrUpLambda},
+\inlineglsdef{glsxtrMathItalicLambda},
+\inlineglsdef{glsxtrUpMu},
+\inlineglsdef{glsxtrMathItalicMu},
+\inlineglsdef{glsxtrUpNu},
+\inlineglsdef{glsxtrMathItalicNu},
+\inlineglsdef{glsxtrUpXi},
+\inlineglsdef{glsxtrMathItalicXi},
+\inlineglsdef{glsxtrUpOmicron},
+\inlineglsdef{glsxtrMathItalicOmicron},
+\inlineglsdef{glsxtrUpPi},
+\inlineglsdef{glsxtrMathItalicPi},
+\inlineglsdef{glsxtrUpRho},
+\inlineglsdef{glsxtrMathItalicRho},
+\inlineglsdef{glsxtrUpSigma},
+\inlineglsdef{glsxtrMathItalicSigma},
+\inlineglsdef{glsxtrUpTau},
+\inlineglsdef{glsxtrMathItalicTau},
+\inlineglsdef{glsxtrUpUpsilon},
+\inlineglsdef{glsxtrMathItalicUpsilon},
+\inlineglsdef{glsxtrUpPhi},
+\inlineglsdef{glsxtrMathItalicPhi},
+\inlineglsdef{glsxtrUpChi},
+\inlineglsdef{glsxtrMathItalicChi},
+\inlineglsdef{glsxtrUpPsi},
+\inlineglsdef{glsxtrMathItalicPsi},
+\inlineglsdef{glsxtrUpOmega}, and
+\inlineglsdef{glsxtrMathItalicOmega}.
+
+Additionally, there are commands for math italic partial
+differential $\partial$ (0x1D715)
+\inlineglsdef{glsxtrMathItalicPartial} and nabla $\nabla$ (0x1D6FB)
+\inlineglsdef{glsxtrMathItalicNabla}.
+
+
+\subsection{Commands Used Within Resource Files}
+\label{sec:glstexcmds}
+
+A \ext{glstex} file will typically start with \gls{glsnoexpandfields},
+since supporting field expansion is only necessary where entry
+definitions may be programmatically performed within a loop or
+some other command. (This may be suppressed.)
+
+If you use the \resourceopt{set-widest} resource option, \app{bib2gls}
+v1.8+ will write the following command in the \ext{glstex} file:
+\cmddef{glsxtrSetWidest}
+This sets the widest name for the given
+\idx{glossary} type and \idx{hierarchicallevel}. This supports both
+the \glostyle{alttree} style and the styles provided by
+\sty{glossary-longextra}, which need to know the widest name.
+
+If \app{bib2gls} can't determine the widest name (typically because
+the \gloskey{name} field consists of commands that aren't recognised by the
+interpreter) then \app{bib2gls} v1.8+ will write the following to
+the \ext{glstex} file:
+\cmddef{glsxtrSetWidestFallback}\marg{max depth}\marg{list}
+Currently the maximum hierarchical depth \meta{max
+depth} may only be 0 or 2. This command requires commands provided
+by the \sty{glossaries-extra-stylemods} package with the
+\glostyle{alttree} style enabled. In this case, it may be simpler
+to just use \gls{glssetwidest}.
+
+The \ext{glstex} files may also contain instances of
+\gls{glsxtrprovidestoragekey} to provide new \idxpl{gloskey} or
+\gls{provideignoredglossary} to provide \idxpl{glossary} to ensure
+they are defined.
+
+The \csfmt{bibgls\ldots} commands provided by \app{bib2gls} are
+defined in the \ext{glstex} files with \gls{providecommand}. See the
+\app{bib2gls} manual for further details of those commands.
+
+\subsection{Hierarchy}
+\label{sec:bib2glshier}
+
+The \gloskey{parent} key identifies a parent entry (by its label),
+so determining if an entry has a parent can easily be achieved by
+testing if the \gloskey{parent} field has been set (using
+\gls{ifglshasparent} or a command like \gls{glsxtrifhasfield}).
+
+The other way around, testing if an entry has any children, is much
+harder. The base \sty{glossaries} package provides
+\gls{ifglshaschildren}, which is very inefficient as it has to
+iterate over all entries in the entry's \idx{glossary} to determine
+which ones have a matching \gloskey{parent} field.
+
+It's much easier with \app{bib2gls}, as there are
+\idxpl{resourceopt} available to save this information. The
+\resourceopt{save-child-count} option saves the child count for each
+entry in the \glosfield{childcount} internal field. This total only
+includes the child entries that have been selected by the
+\idx{resourceset}.
+
+\cmddef{GlsXtrIfHasNonZeroChildCount}
+A shortcut that uses \gls{GlsXtrIfFieldNonZero} to test if the value
+supplied in the \glosfield{childcount} field is non-zero. The
+starred form uses the starred form of \gls{GlsXtrIfFieldNonZero}.
-These commands are provided by \styfmt{glossaries-extra}
-for use with \gls{bib2gls}.
+\subsection{Supplemental Locations}
+\label{sec:supplocations}
-The information provided with \cs{GlsXtrLoadResources}
-is written to the \texttt{.aux} file using
-\begin{alltt}
-\cs{protected@write}\cs{@auxout}\{\cs{glsxtrresourceinit}\}\marg{information}
-\end{alltt}
-where \meta{information} is the information to pass to
-\gls{bib2gls}. The command in the second argument
-\begin{definition}[\DescribeMacro\glsxtrresourceinit]
-\cs{glsxtrresourceinit}
-\end{definition}
-may be used to temporarily redefine commands before the
-information is written to the file. This does nothing
-by default, but may be redefined to allow the use of
-short commands for convenience. For example, with:
-\begin{verbatim}
-\renewcommand{\glsxtrresourceinit}{\let\u\glshex}
-\end{verbatim}
-you can just use, for example, \verb|\u E6| instead of
-\verb|\string\uE6| in the custom rule. This redefinition of \cs{u}
-is scoped so its original definition is restored after the write operation.
+Locations in external documents can be manually added by explicitly
+setting \glsopt{thevalue} when an entry is \indexed. However, this
+is a bit inconvenient so \app{bib2gls} provides a way to do this
+automatically. Both the main document and the supplemental document
+need to use the \opt{record} option, and the entries provided via
+\resourceopt{src} in the main document must have the same labels as
+those in the supplementary document. The supplemental document is
+identified by the \resourceopt{supplemental-locations} resource
+option. See the \app{bib2gls} manual for further details.
+
+\cmddef{glsxtrdisplaysupploc}
+This is used by \app{bib2gls} version v1.7+ for supplemental
+locations, instead of using \gls{glsxtrsupphypernumber} with the
+\catattr{externallocation} attribute. This command sets up the
+\idx{locationcounter} and prefix (used in the formation of hyperlinks)
+and then uses:
+\cmddef{glsxtrmultisupplocation}
+to format the actual \location\ (with an external hyperlink, if
+supported). The \meta{format} (the original \idx{locationencap}) is
+ignored by default.
+
+\subsection{Nameref Records}
+\label{sec:recordnameref}
-If you have multiple resource commands and you want a default set of
-options you can supply them in the definition of:
-\begin{definition}[\DescribeMacro\GlsXtrDefaultResourceOptions]
-\cs{GlsXtrDefaultResourceOptions}
-\end{definition}
-For example:
-\begin{verbatim}
-\renewcommand{\GlsXtrDefaultResourceOptions}{selection=all}
-\end{verbatim}
-This should be done before the resource commands.
+Nameref \records\ include the current title and hypertarget. These
+\records\ are enabled with \opteqvalref{record}{nameref} and provide a
+more reliable way of saving the \location\ hypertarget, which can't be
+obtained with \app{makeindex} or \app{xindy}.
-It's possible to specify label prefixes. For example, modifying
-the earlier example:
-\begin{verbatim}
-\documentclass{article}
+This option is best used with \optval{counter}{\ctr{chapter}} or
+\optval{counter}{\ctr{section}} if you want the title included in the
+location list. If the indexing counter is the default
+\ctr{page}, only the \location\ number is shown. Similarly for
+\optval{counter}{\ctr{equation}} (or \optval{equations}{true}).
-\usepackage[record,style=indexgroup]{glossaries-extra}
+Normally locations are \recorded\ in the \ext{aux} file
+in the form:
+\cmddef{glsxtr@record}
+This is similar to the command used with \gls{makenoidxglossaries}
+and provides the same information about the \location\ and how to
+form the hypertarget as is passed to \app{makeindex} and
+\app{xindy}. The \opteqvalref{record}{nameref} option, which requires at least
+\app{bib2gls} v1.8, instead uses:
+\cmddef{glsxtr@record@nameref}
+where \meta{title} is obtained from \gls{@currentlabelname}
+and \meta{href} is obtained from \gls{@currentHref}. These
+commands require \sty{hyperref}. If they are undefined,
+\meta{title} and \meta{href} will be left empty and \app{bib2gls}
+will treat it as a regular \record.
-\setabbreviationstyle{long-short-desc}
+\begin{important}
+Be careful with this option as \meta{href} will globally change on every
+instance of \gls{refstepcounter} but \meta{title} won't necessarily
+change. It can therefore cause unexpected behaviour.
+\end{important}
-\GlsXtrLoadResources
- [src={abbrvs},sort={letter-nocase},type=main,
- label-prefix={abr.},
- group={Abbreviations}]
+The final argument \meta{hcounter} is obtained from
+\csfmt{theH}\meta{counter} which provides the partial target name associated
+with the \idx{locationcounter}. With the original
+\app{makeindex}\slash \app{xindy} approach, it's not possible to
+include this information in the location, so the base
+\sty{glossaries} package attempts to derive a prefix from which the
+\meta{hcounter} value can be reconstituted by appending the prefix.
+Unfortunately, not all definitions of \csfmt{theH}\meta{counter} are in
+the form \meta{prefix}\gls{thecounter} (most notably the
+\ctr{equation} counter with chapters) so this can fail.
-\GlsXtrLoadResources
- [src={symbols},sort={use},type=main,
- label-prefix={sym.},
- group={Symbols}]
+Since \app{bib2gls} is customized specifically for use with
+\sty{glossaries-extra}, it's now possible to save
+\meta{hcounter}, so the \opt{record}{nameref} option does this.
+By providing both \meta{href} and \meta{hcounter}, you can determine
+which target you would rather use. The default is to use
+\meta{hcounter}, which will take you to the place where the
+corresponding counter was incremented with \gls{refstepcounter}.
+However, you may choose to switch to using the \meta{href} target,
+which will take you to the nearest target before the indexing took
+place.
-\GlsXtrLoadResources[src={terms},sort={en-GB},type=main
- label-prefix={trm.}]
+With \app{bib2gls} v1.8+, normal locations are displayed using:
+\cmddef{glsnoidxdisplayloc}
+This is provided by the base \sty{glossaries} package and is simply
+defined to do:
+\begin{compactcodebox}
+\gls{setentrycounter}\oargm{prefix}\margm{counter}\cmd{csuse}\margm{format}\margm{location}
+\end{compactcodebox}
+Earlier versions of \app{bib2gls} only used this in the
+\glosfield{loclist} field and explicitly used \gls{setentrycounter} in
+the \gloskey{location} field followed by
+\csfmt{}\meta{format}\marg{location}, which follows the code that's created
+with the default \opt{makeindex} setting.
+The \gls{setentrycounter} command sets up the prefix needed for
+\gls{glshypernumber} to reform the target name from the given
+\location.
+
+The \locations\ identified by \gls{glsxtr@record@nameref} are written
+by \app{bib2gls} to the \idx{locationlist} using:
+\cmddef{glsxtrdisplaylocnameref}
+With normal internal locations, \meta{file} will always be empty.
+With supplemental locations, \meta{file} will be the external file
+reference. If \sty{hyperref} hasn't been loaded, this command
+behaves like \gls{glsnoidxdisplayloc}, so it will simply encapsulate
+the location with the given formatting command.
+
+If \sty{hyperref} has been loaded, then \gls{glsxtrdisplaylocnameref}
+will try to work out the appropriate hyperlink anchor and text. The
+\meta{prefix} argument is redundant.
+It first defines the following commands:
+\cmddef{glsxtrrecentanchor}
+This expands to the \meta{href} argument, which corresponds to the
+\gls{@currentHref} value at the time the location was \recorded.
+If this is used as the anchor, the link will go to the most recent anchor
+before the record was created. This is more likely to match the
+given title, but won't necessarily match the corresponding counter.
+
+For example, if the record was created with
+\glsoptval{counter}{\ctr{section}} but occurred in a table caption,
+then \gls{glsxtrrecentanchor} and the title will correspond to the
+table caption. If you have defined
+\glsdisp{glsxtrcounterlocfmt}{\csfmt{glsxtrsectionlocfmt}} to show
+the section number (see below), then this may cause some confusion if clicking
+on the section number leads to a table caption. However, it will
+lead to the closest location to where the record was created, which
+may be preferred.
+
+\cmddef{glsxtrlocationanchor}
+This expands to the anchor that corresponds to the record's
+\idx{locationcounter}, which is constructed from the \meta{counter}
+and \meta{hcounter} arguments.
+
+In the above example with the \ctr{section} counter,
+\meta{hcounter} will be the value of \theHcounter{section} when the
+record was created, so the constructed anchor will be
+\code{section.\meta{hcounter}} which corresponds to the anchor at
+the start of the section. However, if you haven't defined
+\glsdisp{glsxtrcounterlocfmt}{\csfmt{glsxtrsectionlocfmt}}, then the
+title will correspond to the table caption, which may be a little
+confusing.
+
+The actual anchor used is obtained from the expansion of:
+\cmddef{glsxtractualanchor}
+This is initialised to the value of \gls{glsxtrlocationanchor} but
+may be changed by:
+\cmddef{glsxtrsetactualanchor}
+The argument is the counter name, which may be used to set choose an
+alternative anchor depending on the counter. This command does
+nothing by default, which means that \gls{glsxtrlocationanchor}
+will be used.
+
+For example, to switch to \gls{glsxtrrecentanchor} if the counter is
+\ctrfmt{page}:
+\begin{codebox}
+\cmd{renewcommand}\marg{\gls{glsxtrsetactualanchor}}[1]\marg{\comment{}
+ \cmd{ifstrequal}\marg{\#1}\marg{page}
+ {\cmd{let}\gls{glsxtractualanchor}\gls{glsxtrrecentanchor}}%
+ {}%
+}
+\end{codebox}
+
+\begin{information}
+If you are using \opt{indexcounter} then the recent
+anchor will be the one created by the \ctr{wrglossary} increment
+just before the \idx{indexing} occurs. This means that with
+\glsoptval{counter}{wrglossary}, the location anchor and recent
+anchor will be the same. With other counters, the recent anchor will
+be the closest anchor to the place where \idx{indexing} occurred.
+\end{information}
+
+To allow for different formatting according to the counter name,
+\gls{glsxtrdisplaylocnameref} first checks for the existence of:
+\cmddef{glsxtrcounterlocfmt}
+If this command is defined, the location will be displayed using:
+\begin{compactcodebox}
+\gls{glsxtrnamereflink}\margm{format}{\gls{glsxtrcounterlocfmt}\margm{location}\margm{title}}\margm{href}\margm{file}
+\end{compactcodebox}
+Note the above warning about the possible mismatch of the title with
+the anchor. For example, if the following is defined for the
+\ctr{section} counter:
+\begin{compactcodebox}
+\cmd{newcommand}\marg{\glsdisp{glsxtrcounterlocfmt}{\csfmt{glsxtrsectionlocfmt}}}[2]\marg{\cmd{S}\#1 (\#2)}
+\end{compactcodebox}
+then this could lead to the section number followed by the table
+caption. A more compact form that omits the title is better:
+\begin{codebox}
+\cmd{newcommand}\marg{\glsdisp{glsxtrcounterlocfmt}{\csfmt{glsxtrsectionlocfmt}}}[2]\marg{\cmd{S}\#1}
+\end{codebox}
+
+The following location formats are predefined.
+The \ctr{equation} counter:
+\cmddef{glsxtrequationlocfmt}
+This simply expands to \code{(\meta{location})} since equations
+typically don't have a title, but are usually enclosed in
+parentheses.
-\begin{document}
-\gls{trm.bird}
+\cmddef{glsxtrwrglossarylocfmt}
+This is used when the \opt{indexcounter} option creates records with the
+\ctr{wrglossary} counter. This ensures that the page name is shown
+rather than the value of the \ctr{wrglossary} counter.
-\gls{abr.shtml}
+If the corresponding \gls{glsxtrcounterlocfmt} hasn't been defined,
+\gls{glsxtrdisplaylocnameref} will do one of the following:
+\begin{itemize}
+\item if \meta{title} is empty or the counter is \ctr{page},
+\gls{glsxtrnamereflink} with the title set to the location;
+
+\item otherwise it will do:
+\cmddef{glsxtrtitlednamereflink}
+which uses \gls{glsxtrnamereflink} with the given \meta{title}
+and \gls{glsxtrrecentanchor} as the anchor. This has a better chance
+of matching the title with the anchor, but it's not guaranteed as
+some anchors are created without a title.
+This is defined as:
+\begin{compactcodebox}
+\cmd{newcommand}\marg{\gls{glsxtrtitlednamereflink}}[4]\marg{\comment{}
+ \gls{glsxtrnamereflink}\marg{\#1}\marg{\#2}\marg{\gls{glsxtrrecentanchor}}\marg{\#4}\comment{}
+}
+\end{compactcodebox}
+This shows the formatted title with the recent anchor. The location
+isn't shown. If you would prefer to just show the location and use
+the anchor corresponding to the location counter:
+\begin{compactcodebox}
+\cmd{renewcommand}\marg{\gls{glsxtrtitlednamereflink}}[4]\marg{\comment{}
+ \gls{glsxtrnamereflink}\marg{\#1}\marg{\#2}\marg{\gls{glsxtrlocationanchor}}\marg{\#3}\comment{}
+}
+\end{compactcodebox}
+\end{itemize}
-\gls{sym.M}
+If \meta{file} is empty an internal link is created with:
+\cmddef{glsxtrfmtinternalnameref}
+otherwise an external link is created with:
+\cmddef{glsxtrfmtexternalnameref}
+The \meta{file} argument is set by \app{bib2gls} for supplemental
+locations (obtained from \resourceopt{supplemental-locations}).
+
+The link is encapsulated with the text-block command
+whose name is given by \meta{format}, but \gls{glshypernumber} is
+first locally redefined to \gls{@firstofone} to prevent a conflict with the
+usual \location\ hyperlink formation. This means that if the
+\meta{format} is \gls{hyperbf} then it will simply behave like
+\gls{textbf}.
+
+The following command is provided but not used by default:
+\cmddef{glsxtrnameloclink}
+This creates a hyperlink to the target in the given external file obtained from the
+\meta{prefix}, \meta{counter} and \meta{location} but uses
+\meta{text} as the hyperlink text. As with regular indexing, this
+will fail if the target name can't be formed by prefixing the
+location value.
+
+For compactness, \app{bib2gls} merges normal records if the
+\meta{prefix}, \meta{counter} and \meta{location} all match. (An
+order of precedence can be provided for format conflicts.) With
+\optfmt{nameref} records, you can use the \switch{merge-nameref-on} switch
+provided by \app{bib2gls} v1.8+ to determine how to merge \optfmt{nameref}
+records. This switch must be followed by one of the following
+keywords: \code{hcounter} (merge on \meta{hcounter}, default)
+\code{href} (merge on \meta{href}), \code{title} (merge
+on \meta{title}) and \code{location} (merge on \meta{location}, as
+regular records). In all cases, the \meta{counter} must also match.
-\printunsrtglossaries
-\end{document}
-\end{verbatim}
-If you do something like this, you may find it more convenient
-to define custom commands that set the prefix. For example:
-\begin{verbatim}
-\newcommand*{\sym}[2][]{\gls[#1]{sym.#2}}
-\end{verbatim}
-The problem with this is that the custom command \cs{sym}
-doesn't allow for modifiers (such as \cs{gls*} or \cs{gls+}).
-Instead you can use:
-\begin{definition}[\DescribeMacro\glsxtrnewgls]
-\cs{glsxtrnewgls}\oarg{default options}\marg{prefix}\marg{cs}
-\end{definition}
-which defines the command \meta{cs} that behaves like
-\begin{alltt}
-\cs{gls}\meta{modifier}[\meta{default options},\meta{options}]\{\meta{prefix}\meta{label}\}\oarg{insert}
-\end{alltt}
-For example:
-\begin{verbatim}
-\glsxtrnewgls{sym.}{\sym}
-\end{verbatim}
-or (to default to no hyperlinks)
-\begin{verbatim}
-\glsxtrnewgls[hyper=false]{sym.}{\sym}
-\end{verbatim}
-now you can use \verb|\sym+{M}| to behave like \verb|\gls+{sym.M}|.
-If you also want the plural and first letter upper case
-versions you can use
-\begin{definition}[\DescribeMacro\glsxtrnewglslike]
-\cs{glsxtrnewglslike}\oarg{default
-options}\marg{prefix}\marg{\cs{gls}-like cs}\marg{\cs{glspl}-like cs}\marg{\cs{Gls}-like cs}\marg{\cs{Glspl}-like cs}
-\end{definition}
-For example:
-\begin{verbatim}
-\glsxtrnewglslike[hyper=false]{idx.}{\idx}{\idxpl}{\Idx}{\Idxpl}
-\end{verbatim}
-For the all caps versions:
-\begin{definition}[\DescribeMacro\glsxtrnewGLSlike]
-\cs{glsxtrnewGLSlike}\oarg{default
-options}\marg{prefix}\marg{\cs{GLS}-like cs}\marg{\cs{GLSpl}-like cs}
-\end{definition}
-For example:
-\begin{verbatim}
-\glsxtrnewGLSlike[hyper=false]{idx.}{\IDX}{\IDXpl}
-\end{verbatim}
-
-There's an analogous command for \cs{rgls}:
-\begin{definition}[\DescribeMacro\glsxtrnewrgls]
-\cs{glsxtrnewrgls}\oarg{default options}\marg{prefix}\marg{cs}
-\end{definition}
-and for \cs{rgls}, \cs{rglspl}, \cs{rGls}
-and \cs{rGlspl}:
-\begin{definition}[\DescribeMacro\glsxtrnewrglslike]
-\cs{glsxtrnewrglslike}\oarg{default
-options}\marg{prefix}\marg{\cs{rgls}-like cs}\marg{\cs{rglspl}-like
-cs}\marg{\cs{rGls}-like cs}\marg{\cs{rGlspl}-like cs}
-\end{definition}
-and for the all caps:
-\begin{definition}[\DescribeMacro\glsxtrnewrGLSlike]
-\cs{glsxtrnewrGLSlike}\oarg{default
-options}\marg{prefix}\marg{\cs{rGLS}-like cs}\marg{\cs{rGLSpl}-like cs}
-\end{definition}
-
-If you provide your own custom command with just
-\cs{newcommand} that has syntax that starts with
-\oarg{options}\marg{label}, then you can notify \gls{bib2gls} using:
-\begin{definition}[\DescribeMacro\glsxtridentifyglslike]
-\cs{glsxtridentifyglslike}\marg{prefix}\marg{command}
-\end{definition}
-This writes information to the \texttt{.aux} file so that
-\gls{bib2gls} can search for the given command when looking
-for dependencies.
-
-Another possibility is to set up known label prefixes, with each
-one identified by:
-\begin{definition}[\DescribeMacro\glsxtraddlabelprefix]
-\cs{glsxtraddlabelprefix}\marg{prefix}
-\end{definition}
-These should be listed in order of precedence. Since no entries
-are defined on the first \LaTeX\ run, the final prefix should
-be the fallback. You can prepend a prefix to the list using:
-\begin{definition}[\DescribeMacro\glsxtrprependlabelprefix]
-\cs{glsxtrprependlabelprefix}\marg{prefix}
-\end{definition}
+\subsection{Dual Entry Commands}
+\label{sec:dgls}
+
+Dual entries can be defined with entry types like \atentry{dualentry} or
+\atentry{dualindexabbreviation}. A single entry definition within
+the \ext{bib} file creates two dependent entries that may be
+referenced within the document and assigned to different
+\idxpl{glossary}. The default \resourceoptvalm{selection}{recorded
+and deps} will ensure that dependent entries are selected, even if
+they don't have any \records.
+For example, the following \ext{bib} entry:
+\begin{codebox}
+\atentry{dualindexsymbol}\marg{L,
+ \gloskeyval{name}{Lagrangian function},
+ \gloskeyval{symbol}{\cmd{ensuremath}\marg{L}},
+ \gloskeyval{description}{a function of generalized co-ordinates}
+}
+\end{codebox}
+is essentially like:
+\begin{codebox}
+\atentry{index}\marg{L,
+ \gloskeyval{name}{Lagrangian function},
+ \gloskeyval{symbol}{\cmd{ensuremath}\marg{L}},
+ \gloskeyval{description}{a function of generalized co-ordinates}
+}
+\atentry{symbol}\marg{dual.L,
+ \gloskeyval{name}{\cmd{ensuremath}\marg{L}},
+ \gloskeyval{symbol}{Lagrangian function},
+ \gloskeyval{description}{a function of generalized co-ordinates}
+}
+\end{codebox}
+but additionally the two entries (the primary \code{L} and the dual
+\code{dual.L}) are dependent. The following document only references
+the primary entry, but the dependency ensures that that the dual is
+also selected:
+\begin{codebox}
+\cmd{usepackage}\oarg{\opt{record},\opt{symbols},\opt{nostyles},
+ \optvalm{stylemods}{tree,bookindex}}\marg{glossaries-extra}
+\gls{GlsXtrLoadResources}\oarg{\resourceoptval{src}{entries},\resourceoptval{dual-type}{symbols}}
+\gls{glsdefpostlink}\marg{index}\marg{\gls{glsxtrpostlinkAddDescOnFirstUse}}
+\gls{glsdefpostname}\marg{index}\marg{\%
+ \gls{ifglshassymbol}\marg{\gls{glscurrententrylabel}}
+ \marg{ (\gls{glsentrysymbol}\marg{\gls{glscurrententrylabel}})}\marg{}}
+\cbeg{document}
+Primary: \gls{gls}\marg{L}.
+\gls{printunsrtglossary}\oarg{\printglossoptval{type}{symbols},\printglossoptval{style}{\glostyle{tree}}}
+\gls{printunsrtglossary}\oarg{\printglossoptval{title}{Index},\printglossoptval{style}{bookindex}}
+\cend{document}
+\end{codebox}
+The dependency ensures that the dual entry \code{dual.L} is
+selected, and the \resourceopt{dual-type} setting adds the dual
+entry to the \code{symbols} glossary (which was defined with the
+\opt{symbols} package option).
+
+It may be useful to have a hyperlink from the entry in one \idx{glossary}
+to its dependent in the other \idx{glossary}. This can be achieved
+by instructing \app{bib2gls} to save the label of the entry's
+opposite using \resourceopt{dual-field}. The value of this
+\idx{resourceopt} indicates the field in which to
+save the label. If omitted, \code{dual} is assumed.
+
+The \idx{glossarystyle} can then be adapted to check if the field
+has been set and, if so, to create a hyperlink. The following
+command is provided to assist with this:
+\cmddef{GlsXtrDualBackLink}
+This is defined as:
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{GlsXtrDualBackLink}}[2]\marg{\%
+ \gls{glsxtrifhasfield}\marg{\gls{GlsXtrDualField}}\marg{\#2}\%
+ \marg{\gls{glshyperlink}\oarg{\#1}\marg{\gls{glscurrentfieldvalue}}}\%
+ \marg{\#1}\%
+}
+\end{compactcodebox}
+This obtains the field from:
+\cmddef{GlsXtrDualField}
+This expands to \code{dual}, which is the default for
+\resourceopt{dual-field} if no value is supplied.
+
+The above example can be adapted as follows:
+\begin{codebox}
+\cmd{usepackage}\oarg{colorlinks}\marg{hyperref}
+\cmd{usepackage}\oarg{\opt{record},\opt{symbols},\opt{nostyles},\optvalm{stylemods}{tree,bookindex}}\marg{glossaries-extra}
+\gls{GlsXtrLoadResources}\oarg{\resourceoptval{src}{entries},%
+ \resourceoptval{dual-type}{symbols},\resourceopt{dual-field}%
+}
+\gls{glsdefpostlink}\marg{index}\marg{\gls{glsxtrpostlinkAddSymbolOnFirstUse}}
+\gls{glsdefpostname}\marg{index}\marg{\%
+ \gls{ifglshassymbol}\marg{\gls{glscurrententrylabel}}
+ \marg{ (\gls{GlsXtrDualBackLink}\marg{\gls{glsentrysymbol}\marg{\gls{glscurrententrylabel}}}\marg{\gls{glscurrententrylabel}})}\marg{}}
+\cbeg{document}
+Primary: \gls{gls}\marg{L}.
+\gls{printunsrtglossary}\oarg{\printglossoptval{type}{symbols},\printglossoptval{style}{\glostyle{tree}}}
+\gls{printunsrtglossary}\oarg{\printglossoptval{title}{Index},\printglossoptval{style}{bookindex}}
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample*[title={Using \appfmt{bib2gls}: dual backlinks},
+ label={ex:bib2glsdualbacklinks},
+ description={Example document that has backlinks in the glossaries
+between the primary and dual entries},
+ arara={pdflatex,bib2gls,pdflatex,pdfcrop}]
+{\cbeg{filecontents*}\marg{\cmd{jobname}.bib}^^J%
+\atentry{dualindexsymbol}\marg{L,^^J
+ \gloskeyval{name}{Lagrangian function},^^J
+ \gloskeyval{symbol}{\cmd{ensuremath}\marg{L}},^^J
+ \gloskeyval{description}{a function of generalized co-ordinates}^^J%
+}^^J%
+\cend{filecontents*}^^J%
+\cmd{usepackage}\oarg{colorlinks}\marg{hyperref}^^J%
+\cmd{usepackage}\oarg{\opt{record},\opt{symbols},\opt{nostyles},\optvalm{stylemods}{tree,bookindex}}\marg{glossaries-extra}^^J%
+\gls{GlsXtrLoadResources}\oarg{\resourceoptval{src}{\cmd{jobname}},^^J
+ \resourceoptval{dual-type}{symbols},\resourceopt{dual-field}^^J%
+}^^J%
+\gls{glsdefpostlink}\marg{index}\marg{\gls{glsxtrpostlinkAddSymbolOnFirstUse}}^^J%
+\gls{glsdefpostname}\marg{index}\marg{\%^^J
+ \gls{ifglshassymbol}\marg{\gls{glscurrententrylabel}}^^J
+ \marg{ (\gls{GlsXtrDualBackLink}\marg{\gls{glsentrysymbol}\marg{\gls{glscurrententrylabel}}}\marg{\gls{glscurrententrylabel}})}\marg{}}
+}{Primary: \gls{gls}\marg{L}.^^J%
+\gls{printunsrtglossary}\oarg{\printglossoptval{type}{symbols},\printglossoptval{style}{\glostyle{tree}}}^^J%
+\gls{printunsrtglossary}\oarg{\printglossoptval{title}{Index},\printglossoptval{style}{bookindex}}
+}
+\end{resultbox}
+This checks if the \gloskey{symbol} key has been set in both the
+\idx{catpostlinkhook} and the \idx{catpostnamehook} to append the
+symbol in parentheses. In addition, the \idx{catpostnamehook} adds a
+link to the corresponding dual entry.
+
+If you prefer instead to have the backlink on the \gloskey{name} in both
+\idxpl{glossary}, then this can more easily be achieved with a
+\idx{resourceopt} such as \resourceopt{dual-backlink}.
+
+The commands described below were designed for use with \app{bib2gls}['s] dual
+entries, but may also be used in other contexts where a label may
+potentially have a number of possible prefixes.
+
+It's possible to use commands like \gls{glsxtrnewgls} to create
+\idx{glslike} commands that automatically insert a label prefix
+(such as \code{dual.}\ for dual entries).
+The commands described in this section provide a similar set of
+\idx{glslike} commands that iterate over a set of possible prefixes
+until a match is found.
+
+Each possible prefix (which may be empty) is identified by:
+\cmddef{glsxtraddlabelprefix}\marg{prefix}
+These should be listed in order of precedence.
+
+You can prepend a prefix to the list using:
+\cmddef{glsxtrprependlabelprefix}
which gives it the highest order of precedence.
-The \meta{prefix} argument may be empty. You can clear the list
-with:
-\begin{definition}[\DescribeMacro\glsxtrclearlabelprefixes]
-\cs{glsxtrclearlabelprefixes}
-\end{definition}
+The list of known prefixes can be (locally) cleared with:
+\cmddef{glsxtrclearlabelprefixes}
You can test if a prefix is already in the list with:
-\begin{definition}[\DescribeMacro\glsxtrifinlabelprefixlist]
-\cs{glsxtrifinlabelprefixlist}\marg{prefix}\marg{true}\marg{false}
-\end{definition}
+\cmddef{glsxtrifinlabelprefixlist}
+This does \meta{true} if the given prefix has been added to the
+list. No expansion is performed on \meta{label-prefix}.
+
+In the event that there's no match for any of the prefixes (which
+will occur on the first \LaTeX\ run before the \ext{glstex} file has
+been created), the fallback is determined by the conditional:
+\cmddef{ifGlsXtrPrefixLabelFallbackLast}
+If true, this will fallback on the last prefix, otherwise it will
+fallback on the first. This conditional can be set to true with:
+\cmddef{GlsXtrPrefixLabelFallbackLasttrue}
+and to false with:
+\cmddef{GlsXtrPrefixLabelFallbackLastfalse}
+The default is true.
+
+\begin{information}
+As from v1.49, all possible matches will be \recorded\ using a
+special syntax if none are found. This ensures there will be at
+least one match on the first run. However, note that this requires
+\app{bib2gls} v3.0+.
+\end{information}
+
In general it's best to avoid adding multiple instances of the same
prefix, so you can check with this command before adding a prefix to
the list. However, it can be useful to repeat a prefix at
-the end of the list so that it can be used as a fallback for entries
+the start or end of the list so that it can be used as a fallback for entries
that haven't yet been defined.
With the list of possible prefixes set up (including an empty
prefix if necessary), you can use:
-\begin{definition}[\DescribeMacro\dgls]
-\cs{dgls}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
+\cmddef{dgls}
which behaves like
-\begin{alltt}
-\cs{gls}\oarg{options}\{\meta{prefix}\meta{label}\}\oarg{insert}
-\end{alltt}
+\begin{compactcodebox}
+\gls{gls}\oargm{options}\marg{\meta{prefix}\marg{entry-label}}\oargm{insert}
+\end{compactcodebox}
where \meta{prefix} is the first prefix in the list such that
-\meta{prefix}\meta{label} matches a defined entry (or the last entry
-in the prefix list if none match).
+\meta{prefix}\meta{label} matches a defined entry. This requires
+\app{bib2gls} v3.0+ to work properly on the first \LaTeX\ run (when
+no entries are defined).
There are also analogous commands for the plural and case-changing
versions:
-\begin{definition}[\DescribeMacro\dglspl]
-\cs{dglspl}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-(uses \cs{glspl}),
-\begin{definition}[\DescribeMacro\dGls]
-\cs{dGls}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-(uses \cs{Gls}),
-\begin{definition}[\DescribeMacro\dGlspl]
-\cs{dGlspl}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-(uses \cs{Glspl}),
-\begin{definition}[\DescribeMacro\dGLS]
-\cs{dGLS}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-(uses \cs{GLS}),
-\begin{definition}[\DescribeMacro\dGLSpl]
-\cs{dGLSpl}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-(uses \cs{GLSpl}),
-\begin{definition}[\DescribeMacro\dglslink]
-\cs{dglslink}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-(uses \cs{glslink}),
-\begin{definition}[\DescribeMacro\dglsdisp]
-\cs{dglsdisp}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-(uses \cs{glsdisp}).
-
-These commands are essentially provided for a mixture of single and
-dual entries. Suppose the file \texttt{entries.bib} contains:
-\begin{verbatim}
-@index{duck}
-@dualindexabbreviation{svm,
- short={SVM},
- long={support vector machine}
-}
-@dualindexsymbol{pi,
- symbol={\ensuremath{\pi}},
- description={ratio of a circle's circumference to its
- diameter}
-}
-\end{verbatim}
+\cmddef{dglspl}
+(uses \gls{glspl}),
+\cmddef{dGls}
+(uses \gls{Gls}),
+\cmddef{dGlspl}
+(uses \gls{Glspl}),
+\cmddef{dGLS}
+(uses \gls{GLS}),
+\cmddef{dGLSpl}
+(uses \gls{GLSpl}),
+\cmddef{dglslink}
+(uses \gls{glslink}),
+\cmddef{dGlslink}
+(uses \gls{Glslink}),
+\cmddef{dglsdisp}
+(uses \gls{glsdisp}) and
+\cmddef{dGlsdisp}
+(uses \gls{Glsdisp}).
+
+If you want to use a specific field you can instead use:
+\cmddef{dglsfield}
+This will find the first match that has the given field set (that
+is, the field value has been defined and is not empty or \gls{relax}).
+The field should be identified by its \idx{internalfieldlabel}.
+There are also case-changing versions:
+\cmddef{dGlsfield}
+which applies a \idx{sentencecase} change and
+\cmddef{dGLSfield}
+which applies \idx{allcaps}. Note that at least one of the potential
+labels must have the given field set in order for the reference to be
+correctly resolved. For example:
+\begin{codebox}
+\gls{dglsfield}\marg{pi}\marg{symbol}
+\end{codebox}
+If you find this a bit long-winded to type and you want to provide a
+shorter command that recognises the modifiers, then you can use:
+\cmddef{newdglsfield}
+For example:
+\begin{codebox}
+\gls{newdglsfield}\marg{symbol}\marg{\cmd{sym}}
+\cmd{sym}\marg{pi}
+\end{codebox}
+If you also want \idx{sentencecase} and \idx{allcaps} versions use:
+\cmddef{newdglsfieldlike}
+where \meta{cs} is the command without a case-change (which will use
+\gls{dglsfield}), \meta{Cs} is the \idx{sentencecase} command
+(which will use \gls{dGlsfield}) and \meta{CS} is the \idx{allcaps}
+command (which will use \gls{dGLSfield}). This will also use
+\gls{glsmfuaddmap} and \gls{glsmfublocker} to establish the
+\idx{sentencecase} mapping from \meta{cs} to \meta{Cs} and block the
+\idx{casechange} for \meta{CS}.
+
+\begin{information}
+No expansion is performed on \meta{default-options} or \meta{field}
+while the new commands are being defined.
+\end{information}
+
+This family of \gls{dglsfield} commands all define:
+\cmddef{dglsfieldcurrentfieldlabel}
+This expands to the given field label.
+
+If the requested field isn't set (according to \gls{ifcsvoid}) then
+the fallback field will be tried instead.
+\cmddef{dglsfieldfallbackfieldlabel}
+This expands to the fallback field, which defaults to the
+\gloskey{text} field.
+
+If you need to know whether the requested field or the fallback
+field was used, the following will be set to the actual field used.
+\cmddef{dglsfieldactualfieldlabel}
+
+For example, suppose the file \filefmt{entries.bib} contains:
+\begin{codebox}
+\atentry{index}\marg{duck}
+\atentry{dualindexabbreviation}\marg{svm,
+ \gloskeyval{short}{SVM},
+ \gloskeyval{long}{support vector machine}
+}
+\atentry{dualindexsymbol}\marg{pi,
+ \gloskeyval{symbol}{\cmd{ensuremath}\marg{\cmd{pi}}},
+ description={ratio of a circle's circumference to its diameter}
+}
+\end{codebox}
and suppose the document code is:
-\begin{verbatim}
-\documentclass{article}
-\usepackage{hyperref}
-\usepackage[record,abbreviations,symbols]{glossaries-extra}
-
-\newcommand{\bibglsnewdualindexsymbolsecondary}[5]{%
- \longnewglossaryentry*{#1}{name={#3},category={symbol},
- type={symbols},symbol={#4},#2}{#5}%
+\begin{codebox}
+\cmd{documentclass}\marg{article}
+\cmd{usepackage}\marg{hyperref}
+\cmd{usepackage}\oarg{\opt{record},\opt{abbreviations},\opt{symbols}}\marg{glossaries-extra}
+\codepar
+\cmd{newcommand}\marg{\gls{bibglsnewdualindexsymbolsecondary}}[5]\marg{\%
+ \gls{longnewglossaryentry}*\marg{\#1}\marg{\gloskeyval{name}{\#3},\gloskeyval{category}{symbol},
+ \gloskeyval{type}{symbols},\gloskeyval{symbol}{\#4},\#2}\marg{\#5}\%
}
-
-\GlsXtrLoadResources[src=entries]
-
-\begin{document}
-First use: \gls{duck}, \gls{svm}, \gls{pi}.
-Next use: \gls{duck}, \gls{svm}, \gls{pi}.
-\printunsrtglossaries
-\end{document}
-\end{verbatim}
-This uses the default empty primary prefix and \texttt{dual.}\ for
-the dual prefix, so \verb|\gls{svm}| is referencing the primary
-entry, which is (essentially) an \texttt{@index} type not an
+\codepar
+\gls{GlsXtrLoadResources}\oarg{\resourceoptval{src}{entries}}
+\codepar
+\cbeg{document}
+First use: \gls{gls}\marg{duck}, \gls{gls}\marg{svm}, \gls{gls}\marg{pi}.
+Next use: \gls{gls}\marg{duck}, \gls{gls}\marg{svm}, \gls{gls}\marg{pi}.
+\gls{printunsrtglossaries}
+\cend{document}
+\end{codebox}
+This uses the default empty primary prefix and \code{dual.}\ for
+the dual prefix, so \code{\gls{gls}\marg{svm}} is referencing the primary
+entry, which is (essentially) an \atentry{index} type not an
abbreviation. It therefore doesn't follow the abbreviation style, and
it also hyperlinks to the index not to the list of abbreviations.
-Similarly for \verb|\gls{pi}|, which references the primary
-\texttt{@index} entry rather than the symbol.
+Similarly for \code{\gls{gls}\marg{pi}}, which references the primary
+\atentry{index} entry rather than the symbol.
What's really needed is:
-\begin{verbatim}
-\gls{duck}, \gls{dual.svm}, \gls{dual.pi}.
-\end{verbatim}
-or with
-\begin{verbatim}
-\GlsXtrLoadResources[src=entries,
- label-prefix={idx.},
- dual-prefix={}
-]
-\end{verbatim}
+\begin{codebox}
+\gls{gls}\marg{duck}, \gls{gls}\marg{dual.svm}, \gls{gls}\marg{dual.pi}.
+\end{codebox}
+or use \resourceopt{label-prefix} and \resourceopt{dual-prefix} to
+set the label prefixes:
+\begin{codebox}
+\gls{GlsXtrLoadResources}\oarg{\resourceoptval{src}{entries},
+ \resourceoptvalm{label-prefix}{idx.},\resourceoptvalm{dual-prefix}{}
+}
+\end{codebox}
then only the entries without a dual need a prefix:
-\begin{verbatim}
-\gls{idx.duck}, \gls{svm}, \gls{pi}.
-\end{verbatim}
-Using \cs{glsxtrnewglslike}, as earlier, this can be simplified to:
-\begin{verbatim}
-\idx{duck}, \gls{svm}, \gls{pi}.
-\end{verbatim}
+\begin{codebox}
+\gls{gls}\marg{idx.duck}, \gls{gls}\marg{svm}, \gls{gls}\marg{pi}.
+\end{codebox}
+Using \gls{glsxtrnewgls} or \gls{glsxtrnewglslike} (see \sectionref{sec:labelprefixes})
+to define the custom \csfmt{idx}:
+\begin{codebox}
+\gls{glsxtrnewgls}\marg{idx.}\marg{\cmd{idx}}
+\end{codebox}
+the entry references can be simplified to:
+\begin{codebox}
+\cmd{idx}\marg{duck}, \gls{gls}{svm}, \gls{gls}{pi}.
+\end{codebox}
but this requires remembering which terms have duals.
-An alternative is to use \cs{dgls} instead:
-\begin{verbatim}
-\documentclass{article}
-\usepackage{hyperref}
-\usepackage[record,abbreviations,symbols]{glossaries-extra}
-
-\newcommand{\bibglsnewdualindexsymbolsecondary}[5]{%
- \longnewglossaryentry*{#1}{name={#3},category={symbol},
- type={symbols},symbol={#4},#2}{#5}%
+An alternative is to use \gls{dgls} instead:
+\begin{codebox}
+\gls{GlsXtrLoadResources}\oarg{\resourceoptval{src}{entries},
+ \resourceoptval{combine-dual-locations}{primary}}
+\codepar
+\gls{glsxtraddlabelprefix}\marg{dual.}
+\gls{glsxtraddlabelprefix}\marg{}
+\codepar
+\cbeg{document}
+First use: \gls{dgls}\marg{duck}, \gls{dgls}\marg{svm}, \gls{dgls}\marg{pi}.
+Next use: \gls{dgls}\marg{duck}, \gls{dgls}\marg{svm}, \gls{dgls}\marg{pi}.
+\gls{printunsrtglossaries}
+\cend{document}
+\end{codebox}
+\begin{resultbox}
+\createexample*[arara={pdflatex,bib2gls,pdflatex,pdfcrop},
+ label={ex:bib2glsduallabelprefixes},
+ title={Using \appfmt{bib2gls}: dual entry label prefixes},
+ description={Example document that uses bib2gls's dual entries with
+the primary and dual prefixes identified}
+]
+{%
+\cbeg{filecontents*}\marg{\cmd{jobname}.bib}^^J%
+\atentry{index}\marg{duck}^^J%
+\atentry{dualindexabbreviation}\marg{svm,^^J
+ \gloskeyval{short}{SVM},^^J
+ \gloskeyval{long}{support vector machine}^^J%
+}^^J
+\atentry{dualindexsymbol}\marg{pi,^^J
+ \gloskeyval{symbol}{\cmd{ensuremath}\marg{\cmd{pi}}},^^J
+ description={ratio of a circle's circumference to its
+diameter}^^J%
+}^^J%
+\cend{filecontents*}^^J%
+\cmd{usepackage}\marg{hyperref}^^J%
+\cmd{usepackage}\oarg{\opt{record},\opt{abbreviations},\opt{symbols}}\marg{glossaries-extra}
+\codepar
+\cmd{newcommand}\marg{\gls{bibglsnewdualindexsymbolsecondary}}[5]\marg{\%^^J
+ \gls{longnewglossaryentry}*\marg{\#1}\marg{\gloskeyval{name}{\#3},\gloskeyval{category}{symbol},^^J
+ \gloskeyval{type}{symbols},\gloskeyval{symbol}{\#4},\#2}\marg{\#5}\%^^J%
}
+\codepar
+\gls{GlsXtrLoadResources}\oarg{\resourceoptval{src}{\cmd{jobname}},^^J
+ \resourceoptval{combine-dual-locations}{primary}}^^J%
+\gls{glsxtraddlabelprefix}\marg{dual.}^^J%
+\gls{glsxtraddlabelprefix}\marg{}
+}
+{First use: \gls{dgls}\marg{duck}, \gls{dgls}\marg{svm},
+\gls{dgls}\marg{pi}.^^J%
+Next use: \gls{dgls}\marg{duck}, \gls{dgls}\marg{svm},
+\gls{dgls}\marg{pi}.^^J%
+\gls{printunsrtglossaries}
+}
+\end{resultbox}
-\GlsXtrLoadResources[src=entries]
-
-\glsxtraddlabelprefix{dual.}
-\glsxtraddlabelprefix{}
-
-\begin{document}
-First use: \dgls{duck}, \dgls{svm}, \dgls{pi}.
-Next use: \dgls{duck}, \dgls{svm}, \dgls{pi}.
-\printunsrtglossaries
-\end{document}
-\end{verbatim}
-On the first \LaTeX\ call (when the \texttt{.glstex} file doesn't exist),
-neither \texttt{dual.svm} nor \texttt{svm} exists, so \cs{dgls}
+On the first \LaTeX\ call (when the \ext{glstex} file doesn't exist),
+neither \code{dual.svm} nor \code{svm} exists, so \gls{dgls}
uses the last prefix (which is empty in this case). This means
-that on the first \LaTeX\ run, \verb|\dgls{svm}| behaves like
-\verb|\gls{svm}|, which adds a record for the primary
-\texttt{svm} entry. The default primary-dual dependency means
-that this will cause both the primary (\texttt{svm}) and dual
-(\texttt{dual.svm}) entry to be selected. The location will be
-added to the primary entry's location list, unless overridden
-by resource options, such as \texttt{combine-dual-locations}.
-
-Once \gls{bib2gls} has been run and the \texttt{.glstex} file
-exists, then \texttt{dual.svm} exists. So \verb|\dgls{svm}| will
-again first try \texttt{dual.svm} (as \texttt{dual.} is the
+that on the first \LaTeX\ run, \code{\gls{dgls}\marg{svm}} behaves like
+\code{\gls{gls}\marg{svm}}, which adds a record for the primary
+\code{svm} entry. The default primary-dual dependency means
+that this will cause both the primary (\code{svm}) and dual
+(\code{dual.svm}) entry to be selected. The \location\ will be
+added to the primary entry's \idx{locationlist}, unless overridden
+by resource options, such as \resourceopt{combine-dual-locations}.
+
+Once \app{bib2gls} has been run and the \ext{glstex} file
+exists, then \code{dual.svm} exists. So \code{\gls{dgls}\marg{svm}} will
+again first try \code{dual.svm} (as \code{dual.}\ is the
first in the list of label prefixes). That now exists, so
-\verb|\dgls{svm}| now behaves like \verb|\gls{dual.svm}|, which
+\code{\gls{dgls}\marg{svm}} now behaves like \code{\gls{gls}\marg{dual.svm}}, which
follows the abbreviation style and hyperlinks to the list
of abbreviations.
-
-Similarly for the index-symbol combination \texttt{dual.pi} and
-\texttt{pi}. In the case of \verb|\dgls{duck}|, the label
-\texttt{dual.duck} never exists, so that's never selected.
-The empty prefix is the only one that matches, so
-\verb|\dgls{duck}| always behaves like \verb|\gls{duck}|.
-
-If you haven't used \texttt{combine-dual-locations} an extra
-\gls{bib2gls}+\LaTeX\ run may be required to correct the location
+Similarly for the index-symbol combination \code{dual.pi} and
+\code{pi}.
+
+In the case of \code{\gls{dgls}\marg{duck}}, which doesn't have a
+dual, the label \code{dual.duck} never exists, so that's never
+selected. However, when there's no match, such as when the
+\ext{glstex} file doesn't exist, the duck entry will be \recorded\
+with both the \code{dual.}\ prefix and the empty prefix. This allows
+\app{bib2gls} to test which prefix+label combination matches.
+
+\begin{warning}
+If you haven't used \resourceopt{combine-dual-locations} an extra
+\app{bib2gls}+\LaTeX\ run may be required to correct the location
lists.
+\end{warning}
If you change the label prefixes, remember to update the
-corresponding \cs{glsxtraddlabelprefix}\marg{prefix}.
+corresponding \code{\gls{glsxtraddlabelprefix}\margm{label-prefix}}.
If no prefixes have been added to the list (or if the list is
cleared), just an empty prefix is assumed.
-As from version 1.8, \gls{bib2gls} provides hooks that identify
-the label prefixes in the \texttt{.glstex} file:
-\begin{alltt}
-\ics{bibglstertiaryprefixlabel}\marg{prefix}
-\ics{bibglsdualprefixlabel}\marg{prefix}
-\ics{bibglsprimaryprefixlabel}\marg{prefix}
-\end{alltt}
+Note that \app{bib2gls} v1.8+ provides hooks that identify
+the label prefixes in the \ext{glstex} file:
+\begin{compactcodebox}
+\inlineglsdef{bibglstertiaryprefixlabel}\margm{label-prefix}
+\inlineglsdef{bibglsdualprefixlabel}\margm{label-prefix}
+\inlineglsdef{bibglsprimaryprefixlabel}\margm{label-prefix}
+\end{compactcodebox}
These do nothing by default, but they can be defined before
the resource file is loaded to set up the prefix list. For
example:
-\begin{verbatim}
-\newcommand{\bibglsprimaryprefixlabel}[1]{\glsxtraddlabelprefix{#1}}
-\newcommand{\bibglsdualprefixlabel}[1]{\glsxtrprependlabelprefix{#1}}
-\GlsXtrLoadResources[src=entries]
-\end{verbatim}
+\begin{codebox}
+\cmd{newcommand}\marg{\gls{bibglsprimaryprefixlabel}}[1]\marg{\%
+ \gls{glsxtraddlabelprefix}\marg{\#1}}
+\cmd{newcommand}\marg{\gls{bibglsdualprefixlabel}}[1]\marg{\%
+ \gls{glsxtrprependlabelprefix}\marg{\#1}}
+\gls{GlsXtrLoadResources}\oarg{\resourceoptval{src}{entries}}
+\end{codebox}
Remember that this will only have an effect once the
-\texttt{.glstex} file has been created. The prefix list will be empty
+\ext{glstex} file has been created. The prefix list will be empty
on the first run (which is treated as a single empty prefix).
If this isn't a suitable fallback, it may be necessary to add one
after all the resource commands:
-\begin{verbatim}
-\newcommand{\bibglsprimaryprefixlabel}[1]{\glsxtraddlabelprefix{#1}}
-\newcommand{\bibglsdualprefixlabel}[1]{\glsxtrprependlabelprefix{#1}}
-\GlsXtrLoadResources[src=entries,label-prefix={idx.}]
-\glsxtraddlabelprefix{idx.}
-\end{verbatim}
+\begin{codebox}
+\cmd{newcommand}\marg{\gls{bibglsprimaryprefixlabel}}[1]\marg{\%
+ \gls{glsxtraddlabelprefix}\marg{\#1}}
+\cmd{newcommand}\marg{\gls{bibglsdualprefixlabel}}[1]\marg{\%
+ \gls{glsxtrprependlabelprefix}\marg{\#1}}
+\gls{GlsXtrLoadResources}\oarg{\resourceoptval{src}{entries},\resourceoptvalm{label-prefix}{idx.}}
+\gls{glsxtraddlabelprefix}\marg{idx.}
+\end{codebox}
Although this rather defeats the purpose of using the hooks as you
still have to keep track of the fallback prefix.
-\section{Record Counting}
-\label{sec:recordcount}
-
-As from version 1.1 of \gls{bib2gls}, you can save the total
-record count for each entry by invoking \gls{bib2gls}
-with the \texttt{-{}-record-count} or \texttt{-{}-record-count-unit}
-switches. These options will ensure that when each entry
-is written to the \texttt{.glstex} file \gls{bib2gls} will
-additionally set the following internal fields for that entry:
-\begin{itemize}
-\item \texttt{recordcount}: set to the total
-number of records found for the entry;
-\item \texttt{recordcount.\meta{counter}}: set to the total
-number of records found for the entry for the given counter.
-\end{itemize}
-If \texttt{-{}-record-count-unit} is used then additionally:
-\begin{itemize}
-\item \texttt{recordcount.\meta{counter}.\meta{location}}: set to the total
-number of records found for the entry for the given counter with the
-given location.
-\end{itemize}
-Only use the unit counting option if the locations don't contain any special
-characters. If you really need it with locations that may contain
-formatting commands, then you can try redefining:
-\begin{definition}[\DescribeMacro\glsxtrdetoklocation]
-\cs{glsxtrdetoklocation}\marg{location}
-\end{definition}
-so that it detokenizes \meta{location} but take care when
-using \cs{GlsXtrLocationRecordCount} with commands like
-\cs{thepage} as they can end up becoming detokenized
-too early.
-
-Note that the record count includes locations that \gls{bib2gls}
-discards, such as ignored records, duplicates and partial
-duplicates. It doesn't include cross-reference records. For
-example, if \verb|\gls{bird}| is used twice on page~1, once on
-page~2 and fours times on page~3, and
-\verb|\gls[counter=section]{bird}| is used once in section~3, then
-the total record count (stored in the \texttt{recordcount} field) is
-$2+1+4+1=8$, the total for the \texttt{page} counter (stored in the
-\texttt{recordcount.page} field) is $2+1+4=7$, and the total for the
-\texttt{section} counter (stored in the \texttt{recordcount.section}
-field) is 1.
-
-With the unit counting on as well, the field
-\texttt{recordcount.page.1} is set to 2, \texttt{recordcount.page.2}
-is set to 1, \texttt{recordcount.page.3} is set to 4 and
-\texttt{recordcount.section.3} is set to 1.
-
-You can access these fields using the following commands which
-will expand to the field value if set or to 0 if unset:
-\begin{definition}[\DescribeMacro\GlsXtrTotalRecordCount]
-\cs{GlsXtrTotalRecordCount}\marg{label}
-\end{definition}
-This expands to the total record count for the entry given by
-\meta{label}.
-\begin{verbatim}
-\GlsXtrTotalRecordCount{bird}
-\end{verbatim}
-expands to 8.
-
-\begin{definition}[\DescribeMacro\GlsXtrRecordCount]
-\cs{GlsXtrRecordCount}\marg{label}\marg{counter}
-\end{definition}
-This expands to the counter total for the entry given by
-\meta{label} where \meta{counter} is the counter name.
-For example:
-\begin{verbatim}
-\GlsXtrRecordCount{bird}{page}
-\end{verbatim}
-expands to 7 and
-\begin{verbatim}
-\GlsXtrRecordCount{bird}{section}
-\end{verbatim}
-expands to 1.
-
-\begin{definition}[\DescribeMacro\GlsXtrLocationRecordCount]
-\cs{GlsXtrLocationRecordCount}\marg{label}\marg{counter}\marg{location}
-\end{definition}
-This expands to the total for the given location. For example
-\begin{verbatim}
-\GlsXtrLocationRecordCount{bird}{page}{3}
-\end{verbatim}
-expands to 4. Be careful about using \cs{thepage} in the
-\meta{location} part. Remember that due to \TeX's asynchronous
-output routine, \cs{thepage} may not be correct.
+\subsection{Supplementary Commands}
+\label{sec:bib2glssupplementarycommands}
-There are commands analogous to the entry counting commands like
-\cs{cgls} and \cs{cglsformat} that are triggered by the record count.
-These are listed below.
-
-\begin{definition}[\DescribeMacro\rgls]
-\cs{rgls}\meta{modifier}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-\begin{definition}[\DescribeMacro\rglspl]
-\cs{rglspl}\meta{modifier}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-\begin{definition}[\DescribeMacro\rGls]
-\cs{rGls}\meta{modifier}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-\begin{definition}[\DescribeMacro\rGlspl]
-\cs{rGlspl}\meta{modifier}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-\begin{definition}[\DescribeMacro\rGLS]
-\cs{rGLS}\meta{modifier}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-\begin{definition}[\DescribeMacro\rGLSpl]
-\cs{rGLSpl}\meta{modifier}\oarg{options}\marg{label}\oarg{insert}
-\end{definition}
-These commands check the \catattr{recordcount} attribute
-which, if set, should be a number. For example:
-\begin{verbatim}
-\glssetcategoryattribute{abbreviation}{recordcount}{1}
-\end{verbatim}
-For convenience, you can use
-\begin{definition}[\DescribeMacro\GlsXtrSetRecordCountAttribute]
-\cs{GlsXtrSetRecordCountAttribute}\marg{category list}\marg{n}
-\end{definition}
-to set the \catattr{recordcount} attribute to \meta{n}
-for all the categories listed in \meta{category list}.
-
-The \cs{rgls}-like commands use
-\begin{definition}[\DescribeMacro\glsxtrifrecordtrigger]
-\cs{glsxtrifrecordtrigger}\marg{label}\marg{trigger
-code}\marg{normal}
-\end{definition}
-to determine whether the \cs{rgls}-like command should behave like
-its \cs{gls} counterpart (\meta{normal}) or whether it should
-instead use \meta{trigger code}.
-
-This command checks if the \catattr{recordcount} attribute is set.
-If not is just does \meta{normal}, otherwise it tests
-if
-\begin{definition}[\DescribeMacro\glsxtrrecordtriggervalue]
-\cs{glsxtrrecordtriggervalue}\marg{label}
-\end{definition}
-is greater than the value given in the \catattr{recordcount}
-attribute for that entry's category. If true, this does
-\meta{normal} otherwise it does \meta{trigger code}.
-The default definition of the trigger value command is:
-\begin{verbatim}
-\newcommand*{\glsxtrrecordtriggervalue}[1]{%
- \GlsXtrTotalRecordCount{#1}%
-}
-\end{verbatim}
-The \meta{trigger code} part writes a record with
-the \gloskey[glslink]{format} set to \texttt{glstriggerrecordformat} (which
-\gls{bib2gls} v1.1+ recognises as a special type of ignored location
-format) and does \meta{trigger format}. Then it
-unsets the \gls{firstuseflag}. Note that it doesn't
-implement the post-link hook. This ensures that the record
-count is correct on the next run.
-
-The \meta{trigger format} depends on the \cs{rgls}-like
-command used and will be one of the following:
-\begin{definition}[\DescribeMacro\rglsformat]
-\cs{rglsformat}\marg{label}\marg{insert}
-\end{definition}
-\begin{definition}[\DescribeMacro\rglsplformat]
-\cs{rglsplformat}\marg{label}\marg{insert}
-\end{definition}
-\begin{definition}[\DescribeMacro\rGlsformat]
-\cs{rGlsformat}\marg{label}\marg{insert}
-\end{definition}
-\begin{definition}[\DescribeMacro\rGlsplformat]
-\cs{rGlsplformat}\marg{label}\marg{insert}
-\end{definition}
-\begin{definition}[\DescribeMacro\rGLSformat]
-\cs{rGLSformat}\marg{label}\marg{insert}
-\end{definition}
-\begin{definition}[\DescribeMacro\rGLSplformat]
-\cs{rGLSplformat}\marg{label}\marg{insert}
-\end{definition}
-These all behave much like their \cs{cglsformat} counterparts. If
-the entry's \catattr{regular} attribute is set or if the entry
-doesn't have a long form, the first or first plural is used,
-otherwise the long or long plural form is used.
-
-You can use
-\begin{definition}[\DescribeMacro\glsxtrenablerecordcount]
-\cs{glsxtrenablerecordcount}
-\end{definition}
-to redefine \cs{gls}, \cs{glspl}, \cs{Gls}, \cs{Glspl},
-\cs{GLS}, \cs{GLSpl} to \cs{rgls}, \cs{rglspl}, \cs{rGls}, \cs{rGlspl},
-\cs{rGLS}, \cs{rGLSpl}, respectively, for convenience.
-
-If you don't want the entries that use \meta{trigger code}
-to appear in the glossary, you need to use the resource option
-\texttt{trigger-type} to assign them to another glossary.
+\cmddef{glsdisplaynumberlist}
+This command is provided by the base \sty{glossaries} package, but
+it requires hooking into the \idx{locationlist} formatting within
+the \idx{glossary} to obtain the list. This information is more
+easily available with \app{bib2gls}, which stores the formatted
+\idx{locationlist} in the \gloskey{location} field, so
+\sty{glossaries-extra-bib2gls} redefines this command to use that
+field value. Likewise for:
+\cmddef{glsentrynumberlist}
+which is redefined to simply do:
+\begin{compactcodebox}
+\gls{glsxtrusefield}\marg{\#1}\marg{\gloskey{location}}
+\end{compactcodebox}
+
+\cmddef{IfTeXParserLib}
+This command is defined by \sty{glossaries-extra-bib2gls} to expand
+to \code{\LaTeX\ code}, but is defined by the \TeX\
+parser library used by \app{bib2gls}['s] to expand to \code{\TeX\
+parser lib code}. May be used in the \atentry{preamble} or in field
+values to provide \app{bib2gls} with alternative content.
+
+\cmddef{glsxtrprovidecommand}
+This command is intended for use in \atentry{preamble}.
+It's simply defined to \gls{providecommand} in
+\sty{glossaries-extra-bib2gls} but \app{bib2gls}['s] interpreter
+treats it as \gls{renewcommand}. This means that you can
+override \app{bib2gls}['s] internal definition of a command
+without overriding the command definition in the document
+(if it's already defined before the \idx{resourcefile} is input).
For example:
-\begin{verbatim}
-\documentclass{article}
+\begin{codebox}
+\atentry{preamble}\marg{"\gls{glsxtrprovidecommand}\marg{\cmd{int}}\marg{integral}"}
+\end{codebox}
+This will force \app{bib2gls} to treat \csfmt{int} as the word
+\qt{integral} to assist sorting but if this preamble code is written
+to the \ext{glstex} file (as it is by default) then it won't
+override the current definition (provided by the kernel or redefined
+by a package).
-\usepackage[record]{glossaries-extra}
+The helper commands in the \idxpl{resourcefile} are defined using
+\gls{providecommand}. For many of them, if you want to provide an
+alternative definition then you need to define the command before
+the \idx{resourcefile} is loaded. There are a few that may be redefined
+afterwards but if you use \gls{renewcommand} then you will get an
+error on the first \LaTeX\ run when the \ext{glstex} file
+doesn't exist. In this case, you may prefer to use:
+\cmddef{glsrenewcommand}
+This behaves like \gls{renewcommand} but only generates a warning
+rather than an error if the command isn't already defined so it
+won't interrupt the document build.
-\newignoredglossary{ignored}
+\cmddef{GlsXtrIndexCounterLink}
+For use with the \opt{indexcounter} package option and the
+\resourceopt{save-index-counter} resource option.
+This command creates a hyperlink (if supported) to the target obtained from
+the \glosfield{indexcounter} field (which will be set in the
+\ext{glstex} file, if applicable).
-\GlsXtrLoadResources[
- src=example-glossaries-acronym,
- trigger-type=ignored,
- category=abbreviation
-]
+If then \glosfield{indexcounter} field is set for the entry
+given by \meta{entry-label}, this command does
+\code{\gls{hyperref}\oarg{wrglossary.\meta{value}}\margm{text}}, where
+\meta{value} is the value of the \glosfield{indexcounter} field. If the
+field isn't set or if \gls{hyperref} hasn't been defined, this just
+does \meta{text}. See the \app{bib2gls} manual (v1.4+) for further details.
-\glsxtrenablerecordcount
-\GlsXtrSetRecordCountAttribute{abbreviation}{1}
+The \sty{glossaries-extra-bib2gls} package also provides definitions
+of the missing mathematical Greek commands: \inlineglsdef{Alpha},
+\inlineglsdef{Beta}, \inlineglsdef{Epsilon}, \inlineglsdef{Zeta},
+\inlineglsdef{Eta}, \inlineglsdef{Iota},
+\inlineglsdef{Kappa}, \inlineglsdef{Mu}, \inlineglsdef{Nu},
+\inlineglsdef{Omicron}, \inlineglsdef{Rho},
+\inlineglsdef{Tau}, \inlineglsdef{Chi}, \inlineglsdef{Digamma},
+\inlineglsdef{omicron}.
+These are all defined with \gls{providecommand}, so they won't override
+any definitions provided by any package loaded before
+\sty{glossaries-extra}. Since \app{bib2gls}['s] interpreter
+recognises these commands, using them instead of explicitly using
+the Latin characters with the same shape helps to keep the Greek
+symbols together when sorting.
+Similarly, if \sty{upgreek} has been loaded, the missing upright
+Greek commands are also provided: \inlineglsdef{Upalpha},
+\inlineglsdef{Upbeta}, \inlineglsdef{Upepsilon}, \inlineglsdef{Upzeta},
+\inlineglsdef{Upeta}, \inlineglsdef{Upiota},
+\inlineglsdef{Upkappa}, \inlineglsdef{Upmu}, \inlineglsdef{Upnu},
+\inlineglsdef{Upomicron}, \inlineglsdef{Uprho},
+\inlineglsdef{Uptau}, \inlineglsdef{Upchi}, \inlineglsdef{upomicron}.
-\begin{document}
-\gls{lid}. \gls{stc}. \gls{lid}. \gls{aeu}.
-\gls{upa}. \gls{aeu}.
+\glsadd[format=)]{pkg.glossaries-extra-bib2gls}%
+\glsadd[format=)]{app.bib2gls}% end of bib2gls chapter
-\printunsrtglossaries
-\end{document}
-\end{verbatim}
-In the above, \texttt{stc} and \texttt{upa} both only have
-one record, so they are assigned to the \texttt{ignored}
-glossary instead of the \texttt{main} one.
-
-\chapter{Miscellaneous New Commands}
-\label{sec:miscnew}
-
-The \styfmt{glossaries} package provides \ics{glsrefentry} entry to
-cross-reference entries when used with the \pkgopt{entrycounter} or
-\pkgopt{subentrycounter} options. The \styfmt{glossaries-extra}
-package provides a supplementary command
-\begin{definition}[\DescribeMacro\glsxtrpageref]
-\cs{glsxtrpageref}\marg{label}
-\end{definition}
-that works in the same way except that it uses \ics{pageref}
-instead of \ics{ref}.
-
-You can copy an entry to another glossary using
-\begin{definition}[\DescribeMacro\glsxtrcopytoglossary]
-\cs{glsxtrcopytoglossary}\marg{entry-label}\marg{glossary-type}
-\end{definition}
-This appends \meta{entry-label} to the end of the internal
-list for the glossary given by \meta{glossary-type}.
-Be careful if you use the \sty{hyperref} package as this
-may cause duplicate hypertargets. You will need to change
-\cs{glolinkprefix} to another value or disable hyperlinks
-when you display the duplicate. Alternatively, use the new
-\gloskey[printglossary]{target} key to switch off the targets:
-\begin{verbatim}
-\printunsrtglossary[target=false]
-\end{verbatim}
-
-The \styfmt{glossaries} package allows you to set preamble code
-for a given glossary type using \cs{setglossarypreamble}. This
-overrides any previous setting. With \styfmt{glossaries-extra}
-(as from v1.12) you can instead append to the preamble
-using
-\begin{definition}[\DescribeMacro\apptoglossarypreamble]
-\cs{apptoglossarypreamble}\oarg{type}\marg{code}
-\end{definition}
-or prepend using
-\begin{definition}[\DescribeMacro\pretoglossarypreamble]
-\cs{pretoglossarypreamble}\oarg{type}\marg{code}
-\end{definition}
-
-\section{Entry Fields}
-\label{sec:fields}
-
-A field may now be used to store the name of a text-block command
-that takes a single argument. The field is given by
-\begin{definition}[\DescribeMacro\GlsXtrFmtField]
-\cs{GlsXtrFmtField}
-\end{definition}
-The default value is \texttt{\GlsXtrFmtField}. Note that the
-value must be the control sequence name \emph{without the initial
-backslash}.
+\chapter{Auto-Indexing}
+\label{sec:autoindex}
-For example:
-\begin{verbatim}
-\newcommand*{\mtx}[1]{\boldsymbol{#1}}
-\newcommand*{\mtxinv}[1]{\mtx{#1}\sp{-1}}
-
-\newglossaryentry{matrix}{%
- name={matrix},
- symbol={\ensuremath{\mtx{M}}},
- plural={matrices},
- user1={mtx},
- description={rectangular array of values}
-}
-
-\newglossaryentry{identitymatrix}{%
- name={identity matrix},
- symbol={\ensuremath{\mtx{I}}},
- plural={identity matrices},
- description={a diagonal matrix with all diagonal elements equal to
-1 and all other elements equal to 0}
-}
-
-\newglossaryentry{matrixinv}{%
- name={matrix inverse},
- symbol={\ensuremath{\mtxinv{M}}},
- user1={mtxinv},
- description={a square \gls{matrix} such that
- $\mtx{M}\mtxinv{M}=\glssymbol{identitymatrix}$}
-}
-\end{verbatim}
-
-There are two commands provided that allow you to apply the
-command to an argument:
-\begin{definition}[\DescribeMacro\glsxtrfmt]
-\cs{glsxtrfmt}\oarg{options}\marg{label}\marg{text}
-\end{definition}
-This effectively does
-\begin{alltt}
-\cs{glslink}[\meta{default-options},\meta{options}]\marg{label}\{\cs{glsxtrfmtdisplay}\marg{cs name}\marg{text}\{\}\}
-\end{alltt}
-where \meta{cs name} is the control
-sequence name supplied in the provided field, which must be defined
-to take a single required argument. Although it effectively
-acts like \cs{glslink} it misses out the post-link hook.
-
-The default \meta{default-options} are given by
-\begin{definition}[\DescribeMacro\GlsXtrFmtDefaultOptions]
-\cs{GlsXtrFmtDefaultOptions}
-\end{definition}
-This is defined as \texttt{\GlsXtrFmtDefaultOptions} but may
-be redefined as appropriate. Note that the replacement text of
-\cs{GlsXtrFmtDefaultOptions} is prepended to the optional
-argument of \cs{glslink}.
-
-As from version 1.23, there's also a starred version of
-this command that has a final optional argument:
-\begin{definition}[\DescribeMacro{\glsxtrfmt*}]
-\cs{glsxtrfmt*}\oarg{options}\marg{label}\marg{text}\oarg{insert}
-\end{definition}
-Both the starred and unstarred versions use:
-\begin{definition}[\DescribeMacro\glsxtrfmtdisplay]
-\cs{glsxtrfmtdisplay}\marg{cs name}\marg{text}\marg{insert}
-\end{definition}
-within the link text.
-In the case of the unstarred version \meta{insert} will be empty.
-It will also be empty if the final option argument is
-missing from the starred form. If the entry given by \meta{label}
-is undefined \cs{glsxtrfmt} and \cs{glsxtrfmt*} will issue
-an error (or warning if \pkgopt[warn]{undefaction}).
-There won't be a warning or error if the entry is defined by
-the given field is missing. In either case,
-(the entry is undefined or the field is missing) \meta{cs name}
-will be \texttt{@firstofone} otherwise it will be the
-field value. The default definition is:
-\begin{verbatim}
-\newcommand{\glsxtrfmtdisplay}[3]{\csuse{#1}{#2}#3}
-\end{verbatim}
-which puts \meta{text} inside the argument of the control sequence
-and \meta{insert} outside it (but it will still be inside the
-link text).
+It's possible that you may also want a normal index as well as
+the glossary, and you may want entries to automatically be
+added to the index (as in this document).
+There are two attributes that govern this: \catattr{indexname}
+and \catattr{dualindex}.
\begin{important}
-Remember that nested links cause a problem so avoid using
-commands like \cs{gls} or \cs{glsxtrfmt} within \meta{text}.
+The auto-indexing is designed for \app+{makeindex} syntax. If you've
+used the \opt{xindy} package option, the automatic escaping of
+\app+{xindy} special characters in the \gloskey{sort} field may
+result in an incorrect sort value for the \gls{index} command used by
+the auto-indexing. Note also that \app{texindy} has a fixed set of
+special characters (corresponding to \app{makeindex}['s] defaults)
+that can't be customized. You may want to consider using \app{bib2gls} and
+its dual entries as an alternative approach.
\end{important}
-For example:
-\begin{verbatim}
-\[
- \glsxtrfmt{matrix}{A}
- \glsxtrfmt{matrixinv}{A}
- =
- \glssymbol{identitymatrix}
-\]
-\end{verbatim}
-If the default options are set to \texttt{noindex} then
-\cs{glsxtrfmt} won't index, but will create a hyperlink (if
-\sty{hyperref} has been loaded). This can be changed so that
-it also suppresses the hyperlink:
-\begin{verbatim}
-\renewcommand{\GlsXtrFmtDefaultOptions}{hyper=false,noindex}
-\end{verbatim}
-
-Note that \cs{glsxtrfmt} won't work with PDF bookmarks. Instead
-you can use
-\begin{definition}[\DescribeMacro\glsxtrentryfmt]
-\cs{glsxtrentryfmt}\marg{label}\marg{text}
-\end{definition}
-If \sty{hyperref} is used, this uses \cs{texorpdfstring} and will expand to
-\begin{definition}[\DescribeMacro\glsxtrpdfentryfmt]
-\cs{glsxtrpdfentryfmt}\marg{label}\marg{text}
-\end{definition}
-within the PDF bookmarks, but in the document it will do
-\meta{cs}\marg{text} if a control sequence name has been provided
-or just \meta{text} otherwise. The PDF bookmark version simply does
-\meta{text}. It may be redefined, but remember that it needs to
-expand fully.
-
-The \styfmt{glossaries} package provides \cs{glsaddstoragekey} to
-add new keys. This command will cause an error if the key has
-already been defined. The \styfmt{glossaries-extra} package provides
-a supplementary command that will only define the key if it doesn't
-already exist:
-\begin{definition}[\DescribeMacro\glsxtrprovidestoragekey]
-\cs{glsxtrprovidestoragekey}\marg{key}\marg{default}\marg{cs}
-\end{definition}
-If the key has already been defined, it will still provide the command given in
-the third argument \meta{cs} (if it hasn't already been defined). Unlike
-\cs{glsaddstoragekey}, \meta{cs} may be left empty if you're happy
-to just use \cs{glsfieldfetch} to fetch the value of this new key.
-
-You can test if a key has been provided with:
-\begin{definition}[\DescribeMacro\glsxtrifkeydefined]
-\cs{glsxtrifkeydefined}\marg{key}\marg{true}\marg{false}
-\end{definition}
-This tests if \meta{key} is available for use in the
-\meta{key}=\value{value} list in the second argument of
-\cs{newglossaryentry} (or the optional argument of
-commands like \cs{newabbreviation}). The corresponding
-field may not have been set for any of the entries if no
-default was provided.
-
-There are now commands provided to set individual fields. Note that
-these only change the specified field, not any related values. For
-example, changing the value of the \gloskey{text} field won't update
-the \gloskey{plural} field. There are also some fields that
-should really only be set when entries are defined (such
-as the \gloskey{parent} field). Unexpected results may occur
-if they are subsequently changed.
-
-\begin{definition}[\DescribeMacro\GlsXtrSetField]
-\cs{GlsXtrSetField}\marg{label}\marg{field}\marg{value}
-\end{definition}
-Sets the field given by \meta{field} to \meta{value} for the entry
-given by \meta{label}. No expansion is performed. It's not
-necessary for the field to have been defined as a key. You
-can access the value later with \cs{glsxtrusefield}. Note that
-\cs{glsxtrifkeydefined} only tests if a key has been defined for use
-with commands like \cs{newglossaryentry}. If a field without a
-corresponding key is assigned a value, the key remains undefined.
-This command is robust.
-
-\cs{GlsXtrSetField} uses
-\begin{definition}[\DescribeMacro\glsxtrsetfieldifexists]
-\cs{glsxtrsetfieldifexists}\marg{label}\marg{field}\marg{code}
-\end{definition}
-where \meta{label} is the entry label and \meta{code} is the
-assignment code.
-
-This command just uses \ics{glsdoifexists}\marg{label}\marg{code}
-(ignoring the \meta{field} argument), so by default it causes an
-error if the entry doesn't exist. This can be changed to a warning
-with \pkgopt[warn]{undefaction}. You can redefine
-\cs{glsxtrsetfieldifexists} to simply do \meta{code} if you want to
-skip the existence check. Alternatively you can instead use
-\begin{definition}[\DescribeMacro\glsxtrdeffield]
-\cs{glsxtrdeffield}\marg{label}\marg{field}\meta{arguments}\marg{replacement text}
-\end{definition}
-This simply uses \sty{etoolbox}'s \cs{csdef} without any checks.
-This command isn't robust. There is also a version that uses
-\cs{protected@csedef} instead:\footnote{Pre version 1.28 used
-\cs{csedef}.}
-\begin{definition}[\DescribeMacro\glsxtredeffield]
-\cs{glsxtredeffield}\marg{label}\marg{field}\meta{arguments}\marg{replacement text}
-\end{definition}
-
-The following command was added to \styfmt{glossaries-extra} v1.47
-primarily for the convenience of \gls{bib2gls}:
-\begin{definition}[\DescribeMacro\glsxtrapptocsvfield]
-\cs{glsxtrapptocsvfield}\marg{label}\marg{field}\marg{value}
-\end{definition}
-There's no check for the existence of either the entry or the field.
-If the entry identified by \meta{label} has the given field set then
-this command will append a comma followed by \meta{value} to the
-existing value, otherwise it will set the field to just
-\meta{value}. This uses \cs{csdef} or \cs{csappto} so the effect can
-be localised.
-
-\begin{definition}[\DescribeMacro\gGlsXtrSetField]
-\cs{gGlsXtrSetField}\marg{label}\marg{field}\marg{value}
-\end{definition}
-As \cs{GlsXtrSetField} but globally.
-
-\begin{definition}[\DescribeMacro\eGlsXtrSetField]
-\cs{eGlsXtrSetField}\marg{label}\marg{field}\marg{value}
-\end{definition}
-As \cs{GlsXtrSetField} but uses protected expansion.
-
-\begin{definition}[\DescribeMacro\xGlsXtrSetField]
-\cs{xGlsXtrSetField}\marg{label}\marg{field}\marg{value}
-\end{definition}
-As \cs{gGlsXtrSetField} but uses protected expansion.
-
-\begin{definition}[\DescribeMacro\GlsXtrLetField]
-\cs{GlsXtrLetField}\marg{label}\marg{field}\marg{cs}
-\end{definition}
-Sets the field given by \meta{field} to the replacement text of \meta{cs}
-for the entry given by \meta{label} (using \cs{let}).
-
-\begin{definition}[\DescribeMacro\csGlsXtrLetField]
-\cs{csGlsXtrLetField}\marg{label}\marg{field}\marg{cs name}
-\end{definition}
-As \cs{GlsXtrLetField} but the control sequence name is supplied
-instead.
-
-\begin{definition}[\DescribeMacro\GlsXtrLetFieldToField]
-\cs{GlsXtrLetFieldToField}\marg{label-1}\marg{field-1}\marg{label-2}\marg{field-2}
-\end{definition}
-Sets the field given by \meta{field-1} for the entry given by
-\meta{label-1} to the field given by \meta{field-2} for the entry
-given by \meta{label-2}. There's no check for the existence of
-\meta{label-2}, but
-\cs{glsxtrsetfieldifexists}\marg{label-1}\marg{field-1}\marg{code}
-is still used, as for \cs{GlsXtrSetField}.
-
-The \styfmt{glossaries} package provides \ics{ifglshasfield}
-to determine if a field has been set. The \styfmt{glossaries-extra}
-package provides a simpler version:
-\begin{definition}[\DescribeMacro\glsxtrifhasfield]
-\cs{glsxtrifhasfield}\marg{field}\marg{label}\marg{true}\marg{false}
-\end{definition}
-(New to v1.19.) Note that in this case the \meta{field} must be the
-\emph{internal} field label (for example, \texttt{useri} rather than
-\texttt{user1}).
-Unlike \cs{ifglshasfield}, this version doesn't complain if the
-entry (given by \meta{label}) or the field don't exist and
-will simply do \meta{false}. If the field does exist for the given
-entry and it's not empty, the \meta{true} part is done otherwise it
-does \meta{false}. Within \meta{true} you may use
-\begin{definition}[\DescribeMacro\glscurrentfieldvalue]
-\cs{glscurrentfieldvalue}
-\end{definition}
-to access the field value. This command includes grouping
-which scopes the \meta{true} and \meta{false} parts.
-The starred version
-\begin{definition}[\DescribeMacro{\glsxtrifhasfield*}]
-\cs{glsxtrifhasfield*}\marg{field}\marg{label}\marg{true}\marg{false}
-\end{definition}
-omits the implicit grouping.
+The \gls{glsxtrpostnamehook} macro, used at the end of
+\gls{glossentryname} and \gls{Glossentryname}, checks the
+\catattr{indexname} attribute for the category associated with that
+entry. Since \gls{glossentryname} is used in the default glossary
+styles, this makes a convenient way of automatically indexing each
+entry name at its location in the glossary without fiddling around
+with the value of the \gloskey{name} key.
-\begin{important}
-Be careful of keys that use \cs{relax} as the default value
-(such as the \gloskey{symbol}). Use \cs{ifglshassymbol} instead.
-\end{important}
-
-There is also a version that simply uses \cs{ifcsundef}. It
-doesn't save the field value, but can be used if you only
-need to check if the field is defined without accessing it:
-\begin{definition}[\DescribeMacro\GlsXtrIfFieldUndef]
-\cs{GlsXtrIfFieldUndef}\marg{field}\marg{label}\marg{true}\marg{false}
-\end{definition}
+The internal macro used by the \sty{glossaries} package to
+write the information to the external glossary file is
+modified to check for the \catattr{dualindex} attribute.
-\begin{important}
-There's a difference between an undefined field and an unset field.
-An undefined field hasn't been assigned any value (no
-associated internal control sequence has been defined). If a defined
-field has been defined to empty, then it's considered unset.
-\cs{GlsXtrIfFieldUndef} implement \meta{false} for a defined
-but empty field whereas \cs{glsxtrifhasfield} and \cs{ifglshasfield}
-will implement \meta{false} a defined but empty field.
-Remember that any keys that may be used in \cs{newglossaryentry}
-will have a default value if not provided. In many cases, the
-default value is empty, so only use \cs{GlsXtrIfFieldUndef}
-for fields that can only be defined through commands like
-\cs{GlsXtrSetField}.
-\end{important}
+In both cases, the indexing is done through:
+\cmddef{glsxtrdoautoindexname}
+This uses the standard \gls{index} command with the sort value
+taken from the entry's \gloskey{sort} key and the actual value
+set to \code{\gls{glsentryname}\margm{entry-label}}. There are
+user-level commands available to change the sort and actual
+value used by the automated index.
-You can test if a field value equals a string using
-\begin{definition}[\DescribeMacro{\GlsXtrIfFieldEqStr}]
-\cs{GlsXtrIfFieldEqStr}\marg{field}\marg{label}\marg{text}\marg{true}\marg{false}
-\end{definition}
-If the entry exists and has the given field set to the
-given text then this does \meta{true} otherwise it does
-\meta{false}. This uses \cs{glsxtrifhasfield}
-to test if the field exists and then compares the replacement
-text of \cs{glscurrentfieldvalue} with \meta{text} using
-\sty{etoolbox}'s \cs{ifdefstring}. Version 1.39 introduced
-a starred form of this command, which uses the starred form
-of \cs{glsxtrifhasfield}.
-
-As from version 1.31, there's a similar command:
-\begin{definition}[\DescribeMacro{\GlsXtrIfFieldEqXpStr}]
-\cs{GlsXtrIfFieldEqXpStr}\marg{field}\marg{label}\marg{text}\marg{true}\marg{false}
-\end{definition}
-This is like \cs{GlsXtrIfFieldEqStr} but first (protected) fully
-expands \meta{text} (but not the field value). If you want to
-compare the (protected) full expansion of both the field value and \meta{text}
-use:
-\begin{definition}[\DescribeMacro{\GlsXtrIfXpFieldEqXpStr}]
-\cs{GlsXtrIfXpFieldEqXpStr}\marg{field}\marg{label}\marg{text}\marg{true}\marg{false}
-\end{definition}
-Again, version 1.39 introduced a starred form of these commands,
-which use the starred form of \cs{glsxtrifhasfield}.
-
-As from v1.42, you can test if the field value is contained in a
-comma-separated list with:
-\begin{definition}[\DescribeMacro\GlsXtrIfFieldValueInCsvList]
-\cs{GlsXtrIfFieldValueInCsvList}\marg{label}\marg{field}\marg{list}\marg{true}\marg{false}
-\end{definition}
-The unstarred version uses the unstarred form of
-\cs{glsxtrifhasfield} (which adds grouping so \meta{true} and
-\meta{false} will be localised). The starred version uses
-\cs{glsxtrifhasfield*}. If the field value (without expansion) is
-contained in \meta{list} then \meta{true} is done otherwise
-\meta{false} is done. If the field hasn't been set \meta{false} is
-done. This internally uses \cs{DTLifinlist} provided by
-\sty{datatool-base} which performs a one level expansion on
-\meta{list}. See the \sty{datatool} documentation for further
-details.
+The actual value is given by:
+\cmddef{glsxtrautoindexentry}
+where \meta{entry-label} is the entry's label. The default definition
+is:
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{glsxtrautoindexentry}}[1]\marg{\gls{string}\gls{glsentryname}\marg{\#1}}
+\end{compactcodebox}
+Note the use of \gls{string} to prevent \gls{glsentryname} from
+being expanded as it's written to the index file.
-This command is intended for fields that contain a label. For
-example, to test if the category is one of a set of labels:
-\begin{verbatim}
-\GlsXtrIfFieldValueInCsvList{examplelabel}{category}%
- {abbreviation,acronym}% set of labels
- {true part}{false part}
-\end{verbatim}
-
-As from v1.31, if a field represents a numeric (integer) value, you
-can use the following two numeric tests. If the field is set, it must
-expand to an integer. You may use \cs{glscurrentfieldvalue}
-within \meta{true} or \meta{false} to access the actual value. Both \meta{true}
-and \meta{false} are scoped. If the field is undefined or empty,
-the value is assumed to be 0, and \cs{glscurrentfieldvalue} is set
-accordingly. As from version 1.39, these numeric tests have
-starred versions. The unstarred versions add implicit grouping.
-The starred versions don't.
-
-As from v1.47 there's a similar command:
-\begin{definition}[\DescribeMacro\GlsXtrIfValueInFieldCsvList]
-\cs{GlsXtrIfValueInFieldCsvList}\marg{label}\marg{field}\marg{value}\marg{true}\marg{false}
-\end{definition}
-This is essentially the opposite situation where the list is stored
-in the given field and \meta{value} is the element to find in the
-list. Again the unstarred versions add implicit grouping. Note that
-the \meta{value} isn't expanded. If you need it to be fully expanded
-before searching for it use:
-\begin{definition}[\DescribeMacro\xGlsXtrIfValueInFieldCsvList]
-\cs{xGlsXtrIfValueInFieldCsvList}\marg{label}\marg{field}\marg{value}\marg{true}\marg{false}
-\end{definition}
-(To add a value to a field containing a comma-separated list, use
-\cs{glsxtrapptocsvfield}. To iterate over the field use \cs{glsxtrforcsvfield}.)
-
-To test if the value is non-zero:
-\begin{definition}[\DescribeMacro{\GlsXtrIfFieldNonZero}]
-\cs{GlsXtrIfFieldNonZero}\marg{field}\marg{label}\marg{true}\marg{false}
-\end{definition}
-Alternatively, you can test if the field expands to a specific
-number using:
-\begin{definition}[\DescribeMacro{\GlsXtrIfFieldEqNum}]
-\cs{GlsXtrIfFieldEqNum}\marg{field}\marg{label}\marg{n}\marg{true}\marg{false}
-\end{definition}
-This does \meta{true} if the field value equals \meta{n}
-(using \cs{ifnum} for the comparison) otherwise it does
-\meta{false}. For a more general numeric comparison you
-can use:
-\begin{definition}[\DescribeMacro{\GlsXtrIfFieldCmpNum}]
-\cs{GlsXtrIfFieldCmpNum}\marg{field}\marg{label}\marg{comparison}\marg{n}\marg{true}\marg{false}
-\end{definition}
-where \meta{comparison} is one of \texttt{=}, \texttt{<} or
-\texttt{>}.
-
-The \styfmt{glossaries} package provides \ics{glsfieldfetch} which
-can be used to fetch the value of the given field and store it in a
-control sequence. The \styfmt{glossaries-extra} package provides
-another way of accessing the field value:
-\begin{definition}[\DescribeMacro\glsxtrusefield]
-\cs{glsxtrusefield}\marg{entry-label}\marg{field-label}
-\end{definition}
-This works in the same way as commands like \cs{glsentrytext} but
-the field label is specified in the first argument. Note that the
-\meta{field-label} corresponds to the internal field tag, which
-isn't always the same as the key name. See Table~4.1 of the
-\sty{glossaries} manual. No error occurs if the entry or field
-haven't been defined. This command is not robust.
-
-There is also a version that converts the first letter to uppercase
-(analogous to \cs{Glsentrytext}):
-\begin{definition}[\DescribeMacro\Glsxtrusefield]
-\cs{Glsxtrusefield}\marg{entry-label}\marg{field-label}
-\end{definition}
-and, as from v1.37, a command that converts the entire value to upper case:
-\begin{definition}[\DescribeMacro\GLSxtrusefield]
-\cs{GLSxtrusefield}\marg{entry-label}\marg{field-label}
-\end{definition}
-
-If you want to use a field to store a list that can be used
-as an \sty{etoolbox} internal list, you can use the following
-command that adds an item to the field using \sty{etoolbox}'s
-\cs{listcsadd}:
-\begin{definition}[\DescribeMacro\glsxtrfieldlistadd]
-\cs{glsxtrfieldlistadd}\marg{label}\marg{field}\marg{item}
-\end{definition}
-where \meta{label} is the entry's label, \meta{field} is
-the entry's field and \meta{item} is the item to add. There
-are analogous commands that use \cs{listgadd}, \cs{listeadd}
-and \cs{listxadd}:
-\begin{definition}[\DescribeMacro\glsxtrfieldlistgadd]
-\cs{glsxtrfieldlistgadd}\marg{label}\marg{field}\marg{item}
-\end{definition}
-\begin{definition}[\DescribeMacro\glsxtrfieldlisteadd]
-\cs{glsxtrfieldlisteadd}\marg{label}\marg{field}\marg{item}
-\end{definition}
-\begin{definition}[\DescribeMacro\glsxtrfieldlistxadd]
-\cs{glsxtrfieldlistxadd}\marg{label}\marg{field}\marg{item}
-\end{definition}
-You can then iterate over the list using:
-\begin{definition}[\DescribeMacro\glsxtrfielddolistloop]
-\cs{glsxtrfielddolistloop}\marg{label}\marg{field}
-\end{definition}
-or
-\begin{definition}[\DescribeMacro\glsxtrfieldforlistloop]
-\cs{glsxtrfieldforlistloop}\marg{label}\marg{field}\marg{handler}
-\end{definition}
-that internally use \cs{dolistcsloop} and \cs{forlistloop},
-respectively. You can use \ics{listbreak} to break out of the loop
-(see the \sty{etoolbox} manual for further details).
-
-For fields that contain comma-separated lists use
-\cs{glsxtrforcsvfield} instead.
-
-New to v1.42:
-\begin{definition}[\DescribeMacro\glsxtrfieldformatlist]
-\cs{glsxtrfieldformatlist}\marg{label}\marg{field}
-\end{definition}
-Like \sty{datatool-base}'s \ics{DTLformatlist}, this iterates over
-an (\sty{etoolbox}) internal list and formats each item. Uses all
-the same helper commands as \cs{DTLformatlist} (the same list handler
-macro is used). Unlike the \sty{datatool-base} command, this command
-has no starred version. Grouping is automatically applied.
-
-For example, with \gls{bib2gls}['s] \texttt{save-child-count}
-resource option:
-\begin{verbatim}
-\newcommand*{\listchildren}[1]{%
- \GlsXtrIfFieldNonZero{childcount}{#1}%
- {child count: \glscurrentfieldvalue; children:
- \let\DTLlistformatitem\glsfmtname
- \glsxtrfieldformatlist{#1}{childlist}%
- }%
- {no children}%
+The sort value is assigned using:
+\cmddef{glsxtrautoindexassignsort}
+where \meta{entry-label} is the entry label and \meta{cs} is the command
+which needs to be set to the sort value. The default definition is:
+\begin{compactcodebox}
+\cmd{newcommand}*\marg{\gls{glsxtrautoindexassignsort}}[2]\marg{\%
+ \gls{glsletentryfield}\marg{\#1}\marg{\#2}\marg{\gloskey{sort}}\%
}
-\end{verbatim}
-For fields that contain a comma-separated list use \cs{glsxtrfieldformatcsvlist}
-instead.
+\end{compactcodebox}
+After this macro is called, \meta{cs} is then processed to escape
+any of \app{makeindex}['s] special characters. Note that this
+escaping is only performed on the sort not on the actual value.
+The escaping of the sort value is performed by
+\cmddef{glsxtrautoindexesc}
+You can redefine this to do nothing if you want to omit the
+escaping. You may want to consider providing another field to obtain
+the appropriate sort value if the one provided in the \gloskey{sort}
+field isn't suitable (because it may already have had special
+characters escaped or it may be a numeric value in the case of
+sort by use or definition).
-There are also commands that use \cs{ifinlistcs}:
-\begin{definition}[\DescribeMacro\glsxtrfieldifinlist]
-\cs{glsxtrfieldifinlist}\marg{label}\marg{field}\marg{item}\marg{true}\marg{false}
-\end{definition}
-and \cs{xifinlistcs}
-\begin{definition}[\DescribeMacro\glsxtrfieldxifinlist]
-\cs{glsxtrfieldxifinlist}\marg{label}\marg{field}\marg{item}\marg{true}\marg{false}
-\end{definition}
-
-See the \sty{etoolbox}'s user manual for further
-details of these commands, in particular the limitations
-of \cs{ifinlist}.
-
-If the field has a comma-separated list value instead, you
-can iterate over it using:
-\begin{definition}[\DescribeMacro\glsxtrforcsvfield]
-\cs{glsxtrforcsvfield}\marg{label}\marg{field}\marg{handler}
-\end{definition}
-where again \meta{handler} is a control sequence that takes
-a single argument. Unlike the \sty{etoolbox} loops, this
-doesn't ignore empty elements nor does it discard leading / trailing
-spaces. Internally it uses \cs{@for} (modified by \sty{xfor}
-which is automatically loaded by \sty{glossaries}). The
-\sty{xfor} package modifies the behaviour of \cs{@for} to allow
-the loop to be broken prematurely using \cs{@endfortrue}.
-The \cs{glsxtrforcsvfield} command locally defines
-a user level command:
-\begin{definition}[\DescribeMacro\glsxtrendfor]
-\cs{glsxtrendfor}
-\end{definition}
-which is just a synonym for \cs{@endfortrue}.
-
-The loop is performed within the true part of \cs{glsxtrifhasfield}
-so scoping is automatically applied. If you don't want scoping use
-\cs{glsxtrforcsvfield*} which will use \cs{glsxtrifhasfield*}
-instead but take care if you nest these starred commands as
-unexpected results can occur without the scoping.
-
-New to v1.42:
-\begin{definition}[\DescribeMacro\glsxtrfieldformatcsvlist]
-\cs{glsxtrfieldformatcsvlist}\marg{label}\marg{field}
-\end{definition}
-Like \cs{glsxtrfieldformatcsvlist} but for fields that contain
-comma-separated lists.
-
-As from version 1.32, if the field given by
-\begin{definition}[\DescribeMacro\GlsXtrForeignTextField]
-\cs{GlsXtrForeignTextField}
-\end{definition}
-(which defaults to \texttt{userii}) contains a locale tag, then
-\begin{definition}[\DescribeMacro\GlsXtrForeignText]
-\cs{GlsXtrForeignText}\marg{entry label}\marg{text}
-\end{definition}
-can be used to encapsulate \meta{text} in
-\cs{foreignlanguage}\marg{dialect}\marg{text} where \meta{dialect}
-is obtained from the locale tag through \sty{tracklang}'s
-\ics{GetTrackedDialectFromLanguageTag} command. You need at least
-\sty{tracklang} v1.3.6 for this to work properly. The \meta{dialect}
-must be one that's tracked (which typically means that \sty{babel}
-or \sty{polyglossia} has been loaded with the appropriate setting
-for that language). If \cs{foreignlanguage} hasn't been defined,
-this just does \meta{text}.
-For example:
-\begin{verbatim}
-\documentclass{article}
+The command used to perform the actual indexing is:
+\cmddef{glsxtrautoindex}
+This just does \code{\gls{index}\margm{text}} by default.
-\usepackage[main=british,brazilian,ngerman]{babel}
-\usepackage{glossaries-extra}
+\begin{important}
+The entry's \gloskey{parent} field isn't referenced in this
+automated indexing.
+\end{important}
-\setabbreviationstyle{long-short-user}
-\newabbreviation
- [user1={Associa\c{c}\~ao Brasileria de Normas T\'ecnicas},
- user2= {pt-BR}
- ]
- {abnt}{ABNT}{Brazilian National Standards Organization}
-
-\newabbreviation
- [user1={Deutsches Institut f\"ur Normung e.V.},
- user2={de-DE-1996}]
- {din}{DIN}{German Institute for Standardization}
-
-\renewcommand*{\glsxtruserparen}[2]{%
- \glsxtrfullsep{#2}%
- \glsxtrparen
- {#1%
- \ifglshasfield{\glsxtruserfield}{#2}%
- {, \emph{\GlsXtrForeignText{#2}{\glscurrentfieldvalue}}}%
- {}%
- }%
+For example, to index the value of the \gloskey{first} key,
+instead of the \gloskey{name} key:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glsxtrautoindexentry}}[1]\marg{\gls{string}\gls{glsentryfirst}\marg{\#1}}
+\end{codebox}
+and if the sort value also needs to be set to the \gloskey{long}
+field, if present, otherwise the \gloskey{sort} field:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{glsxtrautoindexassignsort}}[2]\marg{\%
+ \gls{ifglshaslong}\marg{\#2}\%
+ \marg{\gls{glsletentryfield}\marg{\#1}\marg{\#2}\marg{\gloskey{long}}}\%
+ \marg{\gls{glsletentryfield}\marg{\#1}\marg{\#2}\marg{\gloskey{sort}}}\%
}
+\end{codebox}
-\begin{document}
-\gls{abnt}, \gls{din}.
-\end{document}
-\end{verbatim}
-
-
-When using the \pkgopt{record} option, in addition to recording the
-usual location, you can also record the current value
-of another counter at the same time using the preamble-only command:
-\begin{definition}[\DescribeMacro\GlsXtrRecordCounter]
-\cs{GlsXtrRecordCounter}\marg{counter name}
-\end{definition}
-For example:
-\begin{verbatim}
-\usepackage[record]{glossaries-extra}
-\GlsXtrRecordCounter{section}
-\end{verbatim}
-Each time an entry is referenced with commands like \cs{gls}
-or \cs{glstext}, the \texttt{.aux} file will not only contain
-the \cs{glsxtr@record} command but also
-\begin{alltt}
-\cs{glsxtr@counterrecord}\marg{label}\{section\}\marg{n}
-\end{alltt}
-where \meta{n} is the current expansion of \cs{thesection}
-and \meta{label} is the entry's label. On the next run, when the
-\texttt{.aux} file is run, this command will do
-\begin{alltt}
-\cs{glsxtrfieldlistgadd}\marg{label}\{record.\meta{counter}\}\marg{n}
-\end{alltt}
-In the above example, if \verb|\gls{bird}| is used in section~1.2
-this would be
-\begin{verbatim}
-\glsxtrfieldlistgadd{bird}{record.section}{1.2}
-\end{verbatim}
-Note that there's no key corresponding to this new
-\texttt{record.section} field, but its value can be
-accessed with \cs{glsxtrfielduse} or the list can be
-iterated over with \cs{glsxtrfielddolistloop} etc.
-
-\section{Display All Entries Without Sorting or Indexing}
-\label{sec:printunsrt}
-
-\begin{definition}[\DescribeMacro\printunsrtglossary]
-\cs{printunsrtglossary}\oarg{options}
-\end{definition}
-This behaves like \cs{printnoidxglossary} but never sorts the
-entries and always lists all the defined entries for the given
-glossary (and doesn't require \cs{makenoidxglossaries}).
-If you want to use one of the \env{tabular}-like
-styles with \cs{printunsrtglossary}, make sure you load
-\sty{glossaries-extra-stylemods} which modifies
-the definition of \cs{glsgroupskip} to avoid the
-\qt{Incomplete \cs{iftrue}} error that may otherwise occur.
-
-There's also a starred form
-\begin{definition}[\DescribeMacro{\printunsrtglossary*}]
-\cs{printunsrtglossary}*\oarg{options}\marg{code}
-\end{definition}
-which is equivalent to
-\begin{alltt}
-\cs{begingroup}
- \meta{code}\cs{printunsrtglossary}\oarg{options}\%
-\cs{endgroup}
-\end{alltt}
-Note that unlike \cs{glossarypreamble}, the supplied \meta{code} is
-done before the glossary header.
-
-This means you now have the option to simply list all entries on the
-first \LaTeX\ run without the need for a post-processor, however
-there will be no \gls{numberlist} in this case, as that has to be
-set by a post-processor such as \gls{bib2gls} (see
-\sectionref{sec:bib2gls}).
+If the value of the attribute is \qt{true}, no encap
+will be added, otherwise the encap will be the
+attribute value. For example:
+\begin{codebox}
+\gls{glssetcategoryattribute}\marg{\cat{general}}\marg{\catattr{indexname}}\marg{textbf}
+\end{codebox}
+will set the encap to \code{textbf} which will display the
+relevant page number in bold whereas
+\begin{codebox}
+\gls{glssetcategoryattribute}\marg{\cat{general}}\marg{\catattr{dualindex}}\marg{true}
+\end{codebox}
+won't apply any formatting to the page number in the index.
\begin{important}
-No attempt is made to gather hierarchical elements.
-If child entries aren't defined immediately after their parent
-entry, they won't be together in the glossary when using
-\cs{printunsrtglossary}.
+The location used in the index will always be the page number
+not the counter used in the glossary. (Unless some other loaded
+package has modified the definition of \gls{index} to use
+some thing else.)
\end{important}
-There's a difference in behaviour depending on whether or not the
-\gloskey{group} key is defined. If not defined (default), the
-group label will be formed from the first letter of the
-\gloskey{name} field. The corresponding group title will be obtained
-as discussed in \sectionref{sec:glosstylemods}. This can lead to an
-odd effect if you are using a style that separates letter groups
-when the ordering isn't alphabetical.
-
-If the \gloskey{group} key is defined (which it is with the
-\pkgopt{record} option) then the group label will be obtained from
-the value of that field. If the field is empty, \emph{no grouping is
-performed}, even if the style supports it. (That is, there won't be
-a header or a vertical separation.) If the \gloskey{group} field is
-non-empty, then the corresponding title is obtained as described
-earlier.
-
-In either case, if the \gloskey[printunsrtglossary]{groups} option is set
-to false then no group formation will be performed.
-
-If you want to use a different field for the group label, you can redefine
-\begin{definition}[\DescribeMacro\glsxtrgroupfield]
-\cs{glsxtrgroupfield}
-\end{definition}
-to the relevant internal field label, but the \gloskey{group}
-\emph{key} must still be defined (through the \pkgopt{record} option
-or with commands like \cs{glsaddstoragekey}) to ensure that
-\cs{printunsrtglossary} uses \cs{glsxtrgroupfield}. (This method is
-used by \gls{bib2gls} for secondary entries, which have the group
-label stored in the \texttt{secondarygroup} internal field.)
-
-If you have any entries with the \gloskey{see} key set, you will
-need the \sty{glossaries} package option \pkgopt[ignore]{seenoindex}
-or \pkgopt[warn]{seenoindex} to prevent an error occurring from the
-automated \cs{glssee} normally triggered by this key. The
-\pkgopt[only]{record} package option will automatically deal with
-this.
-
-For example:
-\begin{verbatim}
-\documentclass{article}
-
-\usepackage{glossaries-extra}
-
-\newglossaryentry{zebra}{name={zebra},description={stripy animal}}
-\newglossaryentry{ant}{name={ant},description={an insect}}
-
-\begin{document}
-\gls{ant} and \gls{zebra}
-
-\printunsrtglossaries
-\end{document}
-\end{verbatim}
-In the above, zebra will be listed before ant as it was defined
-first.
-
-If you allow document definitions with the \pkgopt{docdefs} option,
-the document will require a second \LaTeX\ run if the entries are
-defined after \cs{printunsrtglossary}.
-
-The optional argument is as for \cs{printnoidxglossary} (except for
-the \gloskey[printnoidxglossary]{sort} key, which isn't available).
+By default the \glsopt{format} key won't be used with
+the \catattr{dualindex} attribute. You can allow the
+\glsopt{format} key to override the attribute value
+by using the preamble-only command:
+\cmddef{GlsXtrEnableIndexFormatOverride}
+If you use this command and \sty{hyperref} has been loaded,
+then the \env{theindex} environment will be modified to redefine
+\gls{glshypernumber} to allow formats that use that command.
-All glossaries may be displayed in the order of their definition
-using:
-\begin{definition}[\DescribeMacro\printunsrtglossaries]
-\cs{printunsrtglossaries}
-\end{definition}
-which is analogous to \cs{printnoidxglossaries}. This just
-iterates over all defined glossaries (that aren't on the ignored
-list) and does \cs{printunsrtglossary}[type=\meta{type}].
-
-\subsection{Hooks}
-\label{sec:printunsrthooks}
-
-To avoid complications caused by \env{tabular}-like glossary
-styles, \cs{printunsrtglossary} iterates over all entries
-in the selected glossary and appends the appropriate code
-to an internal command. Once the construction of this
-command is complete, then it's performed to display the
-glossary. This puts the loop outside the style code.
-For convenience, there's a hook used within the loop:
-\begin{definition}[\DescribeMacro\printunsrtglossaryentryprocesshook]
-\cs{printunsrtglossaryentryprocesshook}\marg{label}
-\end{definition}
-This hook should not display any content, but may be used
-to perform calculations. For example, to calculate widths.
-Within this hook you can use:
-\begin{definition}[\DescribeMacro\printunsrtglossaryskipentry]
-\cs{printunsrtglossaryskipentry}
-\end{definition}
-to skip the current entry. This will prevent the entry from
-being added to the internal command.
-
-There's another hook immediately before the internal command
-containing the glossary code is performed:
-\begin{definition}[\DescribeMacro\printunsrtglossarypredoglossary]
-\cs{printunsrtglossarypredoglossary}
-\end{definition}
-
-The internal command uses
-\begin{definition}[\DescribeMacro\printunsrtglossaryhandler]
-\cs{printunsrtglossaryhandler}\marg{label}
-\end{definition}
-to display each item in the list, where \meta{label} is the current label.
-
-By default the handler just does
-\begin{definition}[\DescribeMacro\glsxtrunsrtdo]
-\cs{glsxtrunsrtdo}\marg{label}
-\end{definition}
-which determines whether to use \cs{glossentry} or
-\cs{subglossentry} and checks the \gloskey{location} and
-\gloskey{loclist} fields for the \gls{numberlist}. If you want to
-use a different field to be used instead of \gloskey{location}
-then redefine:
-\begin{definition}[\DescribeMacro\GlsXtrLocationField]
-\cs{GlsXtrLocationField}
-\end{definition}
-to the internal name of the desired field. For example:
-\begin{verbatim}
-\renewcommand{\GlsXtrLocationField}{primarylocation}
-\end{verbatim}
\begin{important}
-Note that if the given location field is undefined or unset,
-the handler will fallback on the \gloskey{loclist} field.
+The \catattr{dualindex} attribute will still be used on
+subsequent use even if the \catattr{indexonlyfirst} attribute
+(or \opt{indexonlyfirst} package option) is set. However,
+the \catattr{dualindex} attribute will honour the
+\glsopt{noindex} key.
\end{important}
-You can instruct \gls{bib2gls} to omit setting the \gloskey{loclist}
-field with the resource option \texttt{--save-loclist=false}
-to prevent it from being used as a fallback.
-
-\subsection{Filtering}
-\label{sec:printunsrtfilter}
-
-You can redefine the handler used by \cs{printunsrtglossary} if required. For example,
-you may want to filter entries according to the category
-label. You can test if a label is contained in a comma-separated
-list of labels using:
-\begin{definition}[\DescribeMacro\glsxtriflabelinlist]
-\cs{glsxtriflabelinlist}\marg{label}\marg{label list}\marg{true}\marg{false}
-\end{definition}
-The \meta{label} and \meta{label list} will be fully expanded.
+The \gls{glsxtrdoautoindexname} command will attempt to escape any of
+\app{makeindex}'s special characters, but there may be special cases
+where it fails, so take care. This assumes the default \app{makeindex} actual,
+level, quote and encap values (unless any of the commands
+\gls{actualchar}, \gls{levelchar}, \gls{quotechar} or
+\gls{encapchar} have been defined before \sty{glossaries-extra}
+is loaded).
+
+If this isn't the case, you can use the following preamble-only
+commands to set the correct characters.
\begin{important}
-If you redefine the handler to exclude entries, you may end
-up with an empty glossary. This could cause a problem for
-the list-based styles.
+Be very careful of possible shifting category codes!
\end{important}
-For example, if the preamble includes:
-\begin{verbatim}
-\usepackage[record,style=index]{glossaries-extra}
-\GlsXtrRecordCounter{section}
-\end{verbatim}
-then you can print the glossary but first redefine the handler
-to only select entries that include the current section number
-in the \texttt{record.section} field:
-\begin{verbatim}
-\renewcommand{\printunsrtglossaryhandler}[1]{%
- \glsxtrfieldxifinlist{#1}{record.section}{\thesection}
- {\glsxtrunsrtdo{#1}}%
- {}%
-}
-\end{verbatim}
-
-Alternatively you can use the starred form of
-\cs{printunsrtglossary} which will localise the change:
-
-\begin{verbatim}
-\printunsrtglossary*{%
- \renewcommand{\printunsrtglossaryhandler}[1]{%
- \glsxtrfieldxifinlist{#1}{record.section}{\thesection}
- {\glsxtrunsrtdo{#1}}%
- {}%
- }%
-}
-\end{verbatim}
-
-If you are using the \sty{hyperref} package and want to
-display the same glossary more than once, you can also
-add a temporary redefinition of \cs{glolinkprefix} to
-avoid duplicate hypertarget names. For example:
-
-\begin{verbatim}
-\printunsrtglossary*{%
- \renewcommand{\printunsrtglossaryhandler}[1]{%
- \glsxtrfieldxifinlist{#1}{record.section}{\thesection}
- {\glsxtrunsrtdo{#1}}%
- {}%
- }%
- \ifcsundef{theHsection}%
- {%
- \renewcommand*{\glolinkprefix}{record.\csuse{thesection}.}%
- }%
- {%
- \renewcommand*{\glolinkprefix}{record.\csuse{theHsection}.}%
- }%
-}
-\end{verbatim}
-Note that this will cause a problem if your descriptions
-contain commands like \cs{gls} that need to link an entry that
-doesn't appear in the summary. In this case, it's a better approach
-to use:
-\begin{verbatim}
-\printunsrtglossary*{%
- \renewcommand{\printunsrtglossaryhandler}[1]{%
- \glsxtrfieldxifinlist{#1}{record.section}{\thesection}
- {\glsxtrunsrtdo{#1}}%
- {}%
- }%
- \ifcsundef{theHsection}%
- {%
- \setkeys{printgloss}{targetnameprefix={record.\csuse{thesection}.}}%
- }%
- {%
- \setkeys{printgloss}{targetnameprefix={record.\csuse{theHsection}.}}%
- }%
-}
-\end{verbatim}
-
-If it's a short summary at the start of a section, you might
-also want to suppress the glossary header and add some vertical
-space afterwards:
-\begin{verbatim}
-\printunsrtglossary*{%
- \renewcommand{\printunsrtglossaryhandler}[1]{%
- \glsxtrfieldxifinlist{#1}{record.section}{\thesection}
- {\glsxtrunsrtdo{#1}}%
- {}%
- }%
- \ifcsundef{theHsection}%
- {%
- \renewcommand*{\glolinkprefix}{record.\csuse{thesection}.}%
- }%
- {%
- \renewcommand*{\glolinkprefix}{record.\csuse{theHsection}.}%
- }%
- \renewcommand*{\glossarysection}[2][]{}%
- \appto\glossarypostamble{\glspar\medskip\glspar}%
-}
-\end{verbatim}
-
-There's a shortcut command that essentially does this:
-\begin{definition}[\DescribeMacro\printunsrtglossaryunit]
-\cs{printunsrtglossaryunit}\oarg{options}\marg{counter name}
-\end{definition}
-The above example can simply be replaced with:
-\begin{verbatim}
-\printunsrtglossaryunit{section}
-\end{verbatim}
-
-This shortcut command is actually defined to use \cs{printunsrtglossary*} with
-\begin{definition}[\DescribeMacro\printunsrtglossaryunitsetup]
-\cs{printunsrtglossaryunitsetup}\marg{counter name}
-\end{definition}
-so if you want to just make some minor modifications you can
-do
-\begin{verbatim}
-\printunsrtglossary*{\printunsrtglossaryunitsetup{section}%
- \renewcommand*{\glossarysection}[2][]{\subsection*{Summary}}%
-}
-\end{verbatim}
-which will start the list with a subsection header with the
-title \qt{Summary} (overriding the glossary's title).
-
-Note that this shortcut command is only available with the
-\pkgopt{record} (or \pkgopt[hybrid]{record}) package option.
-
-This temporary change in the hypertarget prefix means you
-need to explicitly use \cs{hyperlink} to create a link to it
-as commands like \cs{gls} will try to link to the target
-created with the default definition of \cs{gloslinkprefix}.
-This isn't a problem if you want a primary glossary of all terms
-produced using just \cs{printunsrtglossary} (in the front or back
-matter) which can be the target for all glossary references
-and then just use \cs{printunsrtglossaryunit} for a quick
-summary at the start of a section etc.
-
-\section{Partial Glossaries}
-\label{sec:printunsrtinner}
-
-It's possible that you may require greater customisation over the
-way the glossary is displayed that can't be simply achieved with the
-hooks or glossary styles. This section describes a command and
-environment provided to assist with this, but note that they aren't
-compatible with tabular-like glossary styles, such as
-\glostyle{long} or \glostyle{super}, due to their complexity and
-internal scoping that interferes with alignment. You will also need
-to take care with list styles (provided in the \sty{glossary-list}
-package).
-
-To get a better understanding of how this works, it's useful to
-consider how a glossary with \gls{makeindex} works. Here's a simple
-example document:
-\begin{verbatim}
-\documentclass{article}
-
-\usepackage{glossaries}
-
-\makeglossaries
-
-\newglossaryentry{cabbage}{name={cabbage},
- description={vegetable with thick green or purple leaves}}
-
-\newglossaryentry{broccoli}{name={broccoli},
- description={vegetable with heads of small green or purple flower buds}}
-
-\begin{document}
-\Gls{cabbage} and \gls{broccoli}.
-
-\printglossary
-\end{document}
-\end{verbatim}
-When the document is built, \gls{makeindex} creates a file that
-contains:
-\begin{alltt}
-\ics{glossarysection}[\ics{glossarytoctitle}]\mgroup{\ics{glossarytitle}}\ics{glossarypreamble}
-\cs{begin}\mgroup{theglossary}\ics{glossaryheader}
-\ics{glsgroupheading}\mgroup{B}\cs{relax} \ics{glsresetentrylist}
-\ics{glossentry}\mgroup{broccoli}\marg{location list}\ics{glsgroupskip}
-\ics{glsgroupheading}\mgroup{C}\cs{relax} \ics{glsresetentrylist}
-\ics{glossentry}\mgroup{cabbage}\marg{location list}\%
-\cs{end}\mgroup{theglossary}\ics{glossarypostamble}
-\end{alltt}
-The \cs{printglossary} command defines the commands shown
-above after it's detected the glossary type, the title and style. It
-then inputs the file.
-
-The \cs{printunsrtglossary} command performs the same preliminary
-setup but there's no file to input. Instead it then does the section
-heading (\cs{glossarysection}) and preamble (\cs{glossarypreamble})
-and constructs a control sequence that contains
-\texttt{\cs{begin}\mgroup{theglossary}} \meta{content}
-\texttt{\cs{end}\mgroup{theglossary}}.
-
-The letter group markup (\cs{glsgroupheading} and \cs{glsgroupskip})
-is inserted whenever the group label changes between top-level
-entries. In this case, \meta{content} doesn't explicitly contain
-\cs{glossentry} but uses a handler function instead. For example,
-instead of:
-\begin{alltt}
-\ics{glossentry}\mgroup{broccoli}\marg{location list}
-\end{alltt}
-the \meta{content} will contain:
-\begin{alltt}
-\meta{internal handler}\mgroup{broccoli}
-\end{alltt}
-This internal handler uses \ics{printunsrtglossaryhandler} to
-determine the required information (location list, hierarchical
-level) that's needed to typeset the entry (using \cs{glossentry} or
-\cs{subglossentry}).
-
-\begin{definition}
-\cs{begin}\mgroup{printunsrtglossarywrap}\oarg{options}\newline
-\meta{content}
-\cs{end}\mgroup{printunsrtglossarywrap}
-\end{definition}
-The \env{printunsrtglossarywrap} environment provides a wrapper in
-which you can place the actual glossary code. The optional argument
-is the same as for \cs{printunsrtglossary}, but note that in this
-case the \gloskey[printglossary]{type} key simply provides the
-glossary title and doesn't identify the content.
-
-This environment essentially does:
-\begin{alltt}
-\meta{initial setup}
-\ics{glossarysection}[\ics{glossarytoctitle}]\mgroup{\ics{glossarytitle}}\ics{glossarypreamble}
-\cs{begin}\mgroup{theglossary}\ics{glossaryheader}\cs{glsresetentrylist}
-\meta{content}
-\cs{end}\mgroup{theglossary}\cs{glossarypreamble}
-\end{alltt}
-where \meta{initial setup} is much the same code as used by
-\cs{printglossary} and \cs{printunsrtglossary}. Most importantly,
-\meta{initial setup} sets the current glossary style, which
-determines the definition of \env{theglossary}, \cs{glossentry} and
-\cs{subglossentry}.
-
-Whilst it is possible to explicitly use the commands that create
-letter group headings and the handler within \meta{content}, it
-would be quite laborious and prone to error to do so for anything
-other than a very short list. This can be illustrated with the
-following silly example:
-\begin{verbatim}
-\begin{printunsrtglossarywrap}[style=indexgroup]%
-\glsgroupheading{W}%
-\gdef\glscurrententrylabel{cabbage}%
-\printunsrtglossaryhandler\glscurrententrylabel
-\glsgroupskip
-\glsgroupheading{Z}%
-\gdef\glscurrententrylabel{broccoli}%
-\printunsrtglossaryhandler\glscurrententrylabel
-\end{printunsrtglossarywrap}
-\end{verbatim}
-This trivial example will work with a tabular-like style, such as
-\glostyle{long} (although the group headings will be ignored). A
-more practical example that uses a loop within \meta{content} won't.
-
-\begin{definition}
-\ics{printunsrtinnerglossary}\oarg{options}\marg{pre-code}\marg{post-code}
-\end{definition}
-This command is provided for use within
-\env{printunsrtglossarywrap}. The optional argument \meta{options}
-is similar to \cs{printunsrtglossary} but the following keys are
-unavailable: \gloskey[printglossary]{title},
-\gloskey[printglossary]{toctitle}, \gloskey[printglossary]{style},
-\gloskey[printglossary]{numberedsection} and \gloskey[printglossary]{label}.
-
-This will do:
-\begin{alltt}
- \cs{begingroup}
- \meta{initial setup}
- \meta{pre-code}
- \meta{content}
- \meta{post-code}
- \cs{endgroup}
-\end{alltt}
-where \meta{initial setup} processes the options and assigns
-\ics{currentglossary}, \meta{pre-code} is some preliminary code and
-\meta{post-code} is some final code before the end of the scoping.
-The \meta{content} is the sequence of code that
-\cs{printunsrtglossary} would normally insert within the
-\env{theglossary} environment.
-
-For example:
-\begin{verbatim}
-\begin{printunsrtglossarywrap}[style=indexgroup]
-\printunsrtinnerglossary[type=main]{}{}
-\end{printunsrtglossarywrap}
-\end{verbatim}
-This produces a result very similar to that obtained with just:
-\begin{verbatim}
-\printunsrtglossary[style=indexgroup,type=main]
-\end{verbatim}
-The first case is unsuitable for use with a tabular-style. It will
-also cause a problem with a list style when used with \gls{bib2gls}
-(where the inner content will be empty on the first \LaTeX\ run
-which will cause a missing \cs{item} error).
-
-This partial glossary command is more useful when you need to apply
-filtering (which can be set up in the \meta{pre-code} argument as in
-\cs{printunsrtglossary*}) or if you have multiple glossaries. For
-example:
-\begin{verbatim}
-\begin{printunsrtglossarywrap}[style=list]
-\item[Animals]
-\printunsrtinnerglossary[type=animal]{}{}
-\item[Vegetables]
-\printunsrtinnerglossary[type=vegetable]{}{}
-\item[Minerals]
-\printunsrtinnerglossary[type=mineral]{}{}
-\end{printunsrtglossarywrap}
-\end{verbatim}
-In this case, the \glostyle{list} style doesn't cause a problem as
-there will be three instances of \cs{item} on the first \LaTeX\ run.
-
-Here's another example:
-\begin{verbatim}
-\begin{printunsrtglossarywrap}[style=indexgroup]
-\glsgroupheading{animal}%
-\printunsrtinnerglossary[type=animal]{}{}
-\glsgroupskip
-\glsgroupheading{vegetable}%
-\printunsrtinnerglossary[type=vegetable]{}{}
-\glsgroupskip
-\glsgroupheading{mineral}%
-\printunsrtinnerglossary[type=mineral]{}{}
-\end{printunsrtglossarywrap}
-\end{verbatim}
-Note that in both of the above cases, the inner glossaries have been
-arranged manually (animal, then vegetable and then mineral).
-
-It's also possible to use \cs{printunsrtinnerglossary} within the
-handler function used by \cs{printunsrtglossary}. The internal
-scoping within \cs{printunsrtinnerglossary} helps to reduce
-interference.
-
-This is a rather more complicated example that requires
-\gls{bib2gls}. Suppose I have a file called
-\nolinkurl{topictitles.bib} that contains:
-\begin{verbatim}
-@indexplural{animal}
-@indexplural{mineral}
-@indexplural{vegetable}
-\end{verbatim}
-And also a file called \nolinkurl{topics.bib} that contains entries
-like:
-\begin{verbatim}
-@entry{zebra,
- name={zebra},
- description={striped African horse},
- category={animal}
-}
-
-@entry{broccoli,
- name={broccoli},
- description={vegetable with heads of small green or purple flower buds},
- category={vegetable}
-}
-
-@entry{quartz,
- name={quartz},
- description={hard mineral consisting of silica},
- category={mineral}
-}
-\end{verbatim}
-Note that the category labels in the second file match the entry
-labels in the first file.
-
-The simplest way of creating a hierarchical glossary from this data
-is to input both files and copy the \gloskey{category} field to the
-\gloskey{parent} field:
-\begin{verbatim}
-\GlsXtrLoadResources[src={topictitles,topics},
- replicate-fields={category=parent}]
-\end{verbatim}
-The glossary can then simply be displayed with:
-\begin{verbatim}
-\printunsrtglossary[style=indexgroup]
-\end{verbatim}
-This will now be ordered: animal (followed by animal child entries),
-mineral (followed by mineral child entries), vegetable (followed by
-vegetable child entries).
-
-Suppose (for some strange reason) that I now need the ordering to be
-vegetable, mineral, animal (that is, reverse alphabetical) but the
-child entries still need to be in the normal alphabetical order.
-
-It's not possible to use different sort methods for different
-hierarchical levels with \gls{bib2gls}, but it is possible to
-simulate it.
-
-Instead of making the entries within \nolinkurl{topics.bib} children
-of the entries defined in \nolinkurl{topictitles.bib}, I'm now going
-to create separate glossaries for each type:
-\begin{verbatim}
-\newignoredglossary*{animal}
-\newignoredglossary*{mineral}
-\newignoredglossary*{vegetable}
-\end{verbatim}
-The entries in \nolinkurl{topictitles.bib} go in the default main
-glossary and are sorted in reverse:
-\begin{verbatim}
-\GlsXtrLoadResources[src=topictitles,type=main,selection=all,
- sort=en-GB-reverse]
-\end{verbatim}
-Note that I've selected all entries in this example. It becomes more
-complicated with the default selection criteria. (See the
-\nolinkurl{sample-nested.tex} example provided with \gls{bib2gls}
-v2.3+.)
-
-Now the entries in \nolinkurl{topics.bib} are selected but the
-\gloskey{type} field is set to the \gloskey{category} field:
-\begin{verbatim}
-\GlsXtrLoadResources[src=topics,type={same as category},selection=all,
- sort=en-GB]
-\end{verbatim}
-The aim here is to use \cs{printunsrtglossary} to list all the
-entries in the main glossary (that is, all the topic titles) and use
-a handler that tests if there is a glossary that has the same label
-as the current entry label. If one exists, it's then listed using
-\cs{printunsrtinnerglossary} with the level offset shifted to give a
-hierarchical appearance:
-\begin{verbatim}
-\newcommand{\nestedhandler}[1]{%
- \glsxtrunsrtdo{#1}%
- \ifglossaryexists*{#1}%
- {%
- \printunsrtinnerglossary[type={#1},leveloffset=++1]{}{}%
- }%
- {}%
-}
-
-\printunsrtglossary*[type=main,style=index]{%
- \let\printunsrtglossaryhandler\nestedhandler
-}
-\end{verbatim}
-
-I've used \cs{newignoredglossary*} as I don't need to specify a
-title for any of those glossaries nor do I need to use those glossaries with
-\cs{printunsrtglossaries}. With \gls{bib2gls} v2.3+, I can omit the
-three \cs{newignoredglossary*} lines and use the
-\texttt{-{}-provide-glossaries} switch which will make \gls{bib2gls}
-automatically provide any unknown glossaries (with
-\cs{provideignoredglossary}) in the \texttt{.glstex} file.
-
-\section{Standalone Entry Items}
-\label{sec:glossentry}
-
-It may be that you don't want a list but would rather display
-entry details throughout the document. You can simply
-do \cs{glsentryname} followed by \cs{glsentrydesc}.
-(Remember that if you don't want a sorted list, use
-\pkgopt[none]{sort} to skip the construction of the
-\gloskey{sort} field.)
-For example, in the preamble provide a custom command:
-\begin{verbatim}
-\newcommand{\displayterm}[1]{%
- \par\medskip\par\noindent
- Definition: \glsentryname{#1}.\par
- \glsentrydesc{#1}
- \par\medskip
-}
-\end{verbatim}
-define your entries
-\begin{verbatim}
-\newglossaryentry{function}{name={function},
- description={a relation or expression involving variables}
-}
-\end{verbatim}
-and then later in the text:
-\begin{verbatim}
-\displayterm{function}
-\end{verbatim}
-
-However, if may be that you want to use \sty{hyperref} and
-have commands like \cs{gls} link back to the place where
-the term is described. Instead of using \cs{glsentryname}
-use
-\begin{definition}[\DescribeMacro\glsxtrglossentry]
-\cs{glsxtrglossentry}\marg{label}
-\end{definition}
-where \meta{label} is the entry's label.
-
-This is designed to behave much like the way the name is displayed
-in the glossary. It performs the following:
-\begin{itemize}
-\item Defines \cs{glscurrententrylabel} to the entry's label.
-This is usually done at the start of the glossary style commands
-\cs{glossentry} and \cs{subglossentry} and may be used by hooks,
-such as the post-name hooks. Here the definition is localised
-so that it's only available for use in \cs{glossentryname}.
-
-\item Defines \cs{currentglossary} to the entry's glossary type.
-This is usually done at the start of commands like
-\cs{printglossary} and may be used by style hooks.
-Here the definition is localised so that it's only available for use
-in \cs{glsentryitem} and \cs{glssubentryitem}. The value is obtained
-by fully expanding:
-\begin{definition}[\DescribeMacro\GlsXtrStandaloneGlossaryType]
-\cs{GlsXtrStandaloneGlossaryType}
-\end{definition}
-which defaults to the value of the \gloskey{type} field for the
-current entry.
-
-\item Increments and display the entry counters
- if the \pkgopt{entrycounter} or \pkgopt{subentrycounter}
- package options are set. If the entry doesn't have a parent, then
- this does
- \begin{itemize}
- \item \cs{glsentryitem}\marg{label}
- \end{itemize}
- otherwise it does (as from v1.31)
- \begin{itemize}
- \item \ics{GlsXtrStandaloneSubEntryItem}\marg{label}
-which defaults to \cs{glssubentryitem}\marg{label} if the entry
-has a parent but not a grandparent.
- \end{itemize}
- This reflects the behaviour of the predefined hierarchical styles.
-A bug in pre-version~1.31 used \cs{glsentryitem} for all child levels,
-which doesn't match the hierarchical glossary styles. If you want to
-restore this behaviour, just do:
-\begin{verbatim}
-\renewcommand*{\GlsXtrStandaloneSubEntryItem}[1]{\glssubentryitem{#1}}
-\end{verbatim}
-
-\item Sets the hyper-target if supported (using \cs{glstarget})
-and displays the entry name using:
-\begin{definition}[\DescribeMacro\GlsXtrStandaloneEntryName]
-\cs{GlsXtrStandaloneEntryName}\marg{label}
-\end{definition}
- which uses
- \cs{glstarget}\marg{label}\{\cs{glossentryname}\marg{label}\}
- by default.
- Remember that \cs{glossentryname} uses \cs{glsnamefont} or picks up
- the style from category attributes such as
- \catattr{glossnamefont}.
-\end{itemize}
-If you have used \ics{nopostdesc} or \ics{glsxtrnopostpunc}
-in any of your description fields, you can use
-\begin{definition}[\DescribeMacro\glsxtractivatenopost]
-\cs{glsxtractivatenopost}
-\end{definition}
-to make these commands behave as they normally do within a glossary.
-This needs to be placed before
-\begin{alltt}
-\cs{glossentrydesc}\marg{label}\cs{glspostdescription}
-\end{alltt}
-and scoped. Note that \cs{glsnonextpages} and \cs{glsnextpages} have no
-effect outside of the glossary and are not intended for use in a
-standalone context.
-
-It's also possible to select a different field (rather than
-using \gloskey{name}):
-\begin{definition}[\DescribeMacro\glsxtrglossentryother]
-\cs{glsxtrglossentryother}\marg{header}\marg{label}\marg{field}
-\end{definition}
-The \meta{field} must be given using its internal field label
-which may not be the same as the key used to set the field.
-See the key to field mappings table in the \styfmt{glossaries}
-user manual. The \meta{header} argument is the code
-to pass to the third argument of \cs{glsxtrtitleorpdforheading}.
-It may be left empty in which case the default is determined as follows:
-\begin{itemize}
-\item If \cs{glsxtrhead\meta{field}} is defined, then \meta{header}
-is \cs{glsxtrhead\meta{field}}\marg{label}.
-\item Otherwise \meta{header} is simply the field value.
-\end{itemize}
-The \cs{glsxtrglossentryother} command internally uses
-\begin{definition}[\DescribeMacro\GlsXtrStandaloneEntryOther]
-\cs{GlsXtrStandaloneEntryOther}\marg{label}\marg{field}
-\end{definition}
-instead of \cs{GlsXtrStandaloneEntryName}, which uses
-\cs{glossentrynameother}\marg{label}\marg{field} instead of
-\cs{glossentryname}\marg{label}.
-
-If you have loaded the
-\sty{glossaries-accsupp} package (through the \pkgopt{accsupp}
-option) then accessibility support will be provided if
-there's a corresponding command
-\begin{alltt}
-\cs{gls\meta{field}accessdisplay}\marg{text}\marg{label}
-\end{alltt}
-(for example, \cs{glssymbolaccessdisplay}).
-
-This means that my custom command can be changed to:
-\begin{verbatim}
-\newcommand{\displayterm}[1]{%
- \par\medskip\par\noindent
- Definition: \glsxtrglossentry{#1}.\par
- \glsentrydesc{#1}
- \par\medskip
-}
-\end{verbatim}
-If I want numbered definitions, then I can use the
-package options \sty{entrycounter} or \sty{subentrycounter}
-and remove the colon:
-\begin{verbatim}
-\newcommand{\displayterm}[1]{%
- \par\medskip\par\noindent
- Definition \glsxtrglossentry{#1}.\par
- \glsentrydesc{#1}
- \par\medskip
-}
-\end{verbatim}
-The counter label uses a dot after the number by default
-but this can be changed to a colon:
-\begin{verbatim}
-\renewcommand*{\glsentrycounterlabel}{\theglossaryentry:\space}
-\end{verbatim}
-It's now possible to not only use \cs{gls} to link back to the
-definition but also use \cs{glsrefentry} to reference
-the counter and \cs{glsxtrpageref} to reference the page number.
-
-If I want the description to behave more like it does
-in a glossary in need to make the following modification:
-\begin{verbatim}
-\newcommand{\displayterm}[1]{%
- \par\medskip\par\noindent
- Definition \glsxtrglossentry{#1}.\par
- \begingroup
- \glsxtractivatenopost
- \glossentrydesc{#1}\glspostdescription
- \endgroup
- \par\medskip
-}
-\end{verbatim}
-(Note the grouping to localise \cs{glsxtractivatenopost}.)
-
-You can also use \cs{glsxtrglossentry} within section headings.
-For example:
-\begin{verbatim}
-\section{\glsxtrglossentry{function}}
-\end{verbatim}
-This will use \cs{glsentryname} in PDF bookmarks (if
-\cs{texorpdfstring} is defined) and will use \cs{glsxtrheadname} in
-page headers and table of contents. (If you're using a page style or
-table of contents that doesn't use \cs{markright} or \cs{markbook}
-or \cs{@starttoc} then you need to insert \cs{glsxtrmarkhook} and
-\cs{@glsxtrinmark} at the start of the header or table of contents
-either scoped or afterwards cancelled with \cs{@glsxtrnotinmark} and
-\cs{glsxtrrestoremarkhook}.)
-
-\section{Entry Aliases}
-\label{sec:alias}
-
-An entry can be made an alias of another entry using the
-\gloskey{alias} key. The value should be the label of the other
-term. There's no check for the other's existence when the aliased
-entry is defined. This is to allow the possibility of defining the
-other entry after the aliased entry. (For example, when used with
-\gls{bib2gls}.)
+\cmddef{GlsXtrSetActualChar}
+Set the actual character to \meta{char}.
-If an entry \meta{entry-1} is made an alias of \meta{entry-2} then:
-\begin{itemize}
-\item If the \gloskey{see} field wasn't provided when \meta{entry-1}
-was defined, the \gloskey{alias} key will automatically trigger
-\begin{alltt}
-\cs{glssee}\marg{entry-1}\marg{entry-2}
-\end{alltt}
-\item If the \sty{hyperref} package has been loaded then
-\cs{gls}\marg{entry-1} will link to \meta{entry-2}'s target. (Unless
-the \catattr{targeturl} attribute has been set for \meta{entry-1}'s
-category.)
-\item With \pkgopt[off]{record} or \pkgopt[hybrid]{record}, the \gloskey[glslink]{noindex} setting will automatically be triggered
-when referencing \meta{entry-1} with commands like \cs{gls} or
-\cs{glstext}. This prevents \meta{entry-1} from have a
-\gls{locationlist} (aside from the cross-reference added with
-\cs{glssee}) unless it's been explicitly indexed with \cs{glsadd} or
-if the indexing has been explicitly set using
-\texttt{noindex=false}.
+\cmddef{GlsXtrSetLevelChar}
+Set the level character to \meta{char}.
-Note that with \pkgopt[only]{record}, the \gls{locationlist}
-for aliased entries is controlled with \gls{bib2gls}['s] settings.
-\end{itemize}
+\cmddef{GlsXtrSetEscChar}
+Set the escape (quote) character to \meta{char}.
-The index suppression trigger is performed by
-\begin{definition}[\DescribeMacro\glsxtrsetaliasnoindex]
-\cs{glsxtrsetaliasnoindex}
-\end{definition}
-This is performed after the default options provided by
-\ics{GlsXtrSetDefaultGlsOpts} have been set.
-With \pkgopt[only]{record}, \cs{glsxtrsetaliasnoindex} will
-default to do nothing.
-
-Within the definition of \cs{glsxtrsetaliasnoindex} you can use
-\begin{definition}[\DescribeMacro\glsxtrindexaliased]
-\cs{glsxtrindexaliased}
-\end{definition}
-to index \meta{entry-2}.
-
-The index suppression command can be redefined to index the main
-term instead. For example:
-\begin{verbatim}
-\renewcommand{\glsxtrsetaliasnoindex}{%
- \glsxtrindexaliased
- \setkeys{glslink}{noindex}%
-}
-\end{verbatim}
-
-The value of the \gloskey{alias} field can be accessed using
-\begin{definition}[\DescribeMacro\glsxtralias]
-\cs{glsxtralias}\marg{label}
-\end{definition}
+\cmddef{GlsXtrSetEncapChar}
+Set the encap character to \meta{char}.
\chapter{On-the-Fly Document Definitions}
\label{sec:onthefly}
\begin{important}
The commands described here may superficially look like
-\meta{word}\cs{index}\marg{word}, but they behave rather
-differently. If you want to use \cs{index} then just use
-\cs{index}.
+\code{\meta{word}\gls{index}\margm{word}}, but they behave rather
+differently. If you want to use \gls{index} then just use
+\gls{index}.
\end{important}
-The \styfmt{glossaries} package advises against defining entries
+The base \sty{glossaries} package advises against defining entries
in the \env{document} environment. As mentioned in
-\sectionref{sec:pkgopts} above, this ability is disabled by
-default with \styfmt{glossaries-extra} but can be enabled using
-the \pkgopt{docdefs} package options.
+\sectionref{sec:refindexopts}, this ability is disabled by
+default with \sty{glossaries-extra} but can be enabled using
+the \opt{docdef} package options.
-Although this can be problematic, the \styfmt{glossaries-extra}
+Although this can be problematic, the \sty{glossaries-extra}
package provides a way of defining and using entries within
the \env{document} environment without the tricks used with the
-\pkgopt{docdefs} option. \emph{There are limitations with this
+\opt{docdef} option. \emph{There are limitations with this
approach, so take care with it.} This function is disabled by
default, but can be enabled using the preamble-only command:
-\begin{definition}[\DescribeMacro\GlsXtrEnableOnTheFly]
-\cs{GlsXtrEnableOnTheFly}
-\end{definition}
-When used, this defines the commands described below.
-
-\begin{important}
-The commands \cs{glsxtr}, \cs{glsxtrpl}, \cs{Glsxtr}
-and \cs{Glsxtrpl} can't be used after the glossaries have been
-displayed (through \ics{printglossary} etc). It's best not to mix
-these commands with the standard glossary commands, such
-as \cs{gls} or there may be unexpected results.
-\end{important}
+\cmddef{GlsXtrEnableOnTheFly}
+When used, this defines the commands described below. The starred
+version was provided to help support \idx{utf8} with \sty{inputenc}.
+Recent versions of the \LaTeX\ kernel now provide better support.
+Both \sty{glossaries} and \sty{glossaries-extra} have been updated
+to help integrate the new kernel features, so the unstarred version
+may also work with \idx{utf8}.
+
+\begin{warning}
+If you use the starred version of \gls{GlsXtrEnableOnTheFly}
+don't use any commands in the \meta{label}, even if they expand
+to just text.
+\end{warning}
-\begin{definition}[\DescribeMacro\glsxtr]
-\cs{glsxtr}\oarg{gls-options}\oarg{dfn-options}\marg{label}
-\end{definition}
-If an entry with the label \meta{label} has already been defined,
-this just does \cs{gls}\oarg{gls-options}\marg{label}. If
-\meta{label} hasn't been defined, this will define the entry
+\cmddef{glsxtr}
+If an entry with the label \meta{entry-label} has already been defined,
+this just does \code{\gls{gls}\oargm{gls-options}\margm{entry-label}}. If
+\meta{entry-label} hasn't been defined, this will define the entry
using:
-\begin{alltt}
-\cs{newglossaryentry}\marg{label}\{name=\marg{label},
- category=\cs{glsxtrcat},
- description=\{\cs{nopostdesc}\},
- \meta{dfn-options}\}
-\end{alltt}
+\begin{compactcodebox}
+\gls{newglossaryentry}\margm{entry-label}\marg{\gloskeyval{name}{entry-label},
+ \gloskeyval{category}{\gls{glsxtrcat}},
+ \gloskeyval{description}{\gls{nopostdesc}},
+ \meta{dfn-options}}
+\end{compactcodebox}
\begin{important}
The \meta{label} must contain any non-expandable commands, such as
formatting commands or problematic characters.
If the term requires any of these, they must be omitted from the
-\meta{label} and placed in the \gloskey{name} key must be provided
-in the optional argument \meta{dfn-options}.
+\meta{entry-label} and placed in the \gloskey{name} key within
+the optional argument \meta{dfn-options}.
\end{important}
The second optional argument \meta{dfn-options} should be empty
if the entry has already been defined, since it's too late for
-them. If it's not empty, a~warning will be generated with
-\begin{definition}[\DescribeMacro\GlsXtrWarning]
-\cs{GlsXtrWarning}\marg{dfn-options}\marg{label}
-\end{definition}
-
+them. If it's not empty, a~warning will be generated with:
+\cmddef{GlsXtrWarning}
For example, this warning will be generated on the second instance
-of \cs{glsxtr} below:
-\begin{verbatim}
-\glsxtr[][plural=geese]{goose}
-% ... later
-\glsxtr[][plural=geese]{goose}
-\end{verbatim}
+of \gls{glsxtr} below:
+\begin{codebox}
+\gls{glsxtr}\oarg{}\oarg{\gloskey{plural}{geese}}\marg{goose}
+\comment{... later}
+\gls{glsxtr}\oarg{}\oarg{\gloskey{plural}{geese}}\marg{goose}
+\end{codebox}
If you are considering doing something like:
-\begin{verbatim}
-\newcommand*{\goose}{\glsxtr[][plural=geese]{goose}}
-\renewcommand*{\GlsXtrWarning}[2]{}
-% ... later
-\goose\ some more text here
-\end{verbatim}
+\begin{codebox}
+\cmd{newcommand}*\marg{\cmd{goose}}\marg{\gls{glsxtr}\oarg{}\oarg{\gloskeyval{plural}{geese}}\marg{goose}}
+\cmd{renewcommand}*\marg{\gls{GlsXtrWarning}}[2]\marg{}
+\comment{... later}
+\cmd{goose}\cmd{ }some more text here
+\end{codebox}
then don't bother. It's simpler and less problematic to just
-define the entries in the preamble with \ics{newglossaryentry}
-and then use \cs{gls} in the document.
-
-There are plural and case-changing alternatives to \cs{glsxtr}:
-\begin{definition}[\DescribeMacro\glsxtrpl]
-\cs{glsxtrpl}\oarg{gls-options}\oarg{dfn-options}\marg{label}
-\end{definition}
-This is like \cs{glsxtr} but uses \cs{glspl} instead of \cs{gls}.
-
-\begin{definition}[\DescribeMacro\Glsxtr]
-\cs{Glsxtr}\oarg{gls-options}\oarg{dfn-options}\marg{label}
-\end{definition}
-This is like \cs{glsxtr} but uses \cs{Gls} instead of \cs{gls}.
-
-\begin{definition}[\DescribeMacro\Glsxtrpl]
-\cs{Glsxtrpl}\oarg{gls-options}\oarg{dfn-options}\marg{label}
-\end{definition}
-This is like \cs{glsxtr} but uses \cs{Glspl} instead of \cs{gls}.
-
-If you use UTF-8 and don't want the inconvenient of needing
-to use an ASCII-only label, then it's better to use
-\XeLaTeX\ or \LuaLaTeX\ instead of \LaTeX\ (or \pdfLaTeX).
-If you really desperately want to use UTF-8 entry labels without
-switching to \XeLaTeX\ or \LuaLaTeX\ then there is a starred
-version of \cs{GlsXtrEnableOnTheFly} that allows you to
-use UTF-8 characters in \meta{label}, but it's experimental and
-may not work in some cases.
+define the entries in the preamble with \gls{newglossaryentry}
+and then use \gls{gls} in the document.
+
+There are also plural and case-changing alternatives to \gls{glsxtr}.
+\cmddef{glsxtrpl}
+This is like \gls{glsxtr} but uses \gls{glspl} instead of \gls{gls}.
+\cmddef{Glsxtr}
+This is like \gls{glsxtr} but uses \gls{Gls} instead of \gls{gls}.
+\cmddef{Glsxtrpl}
+This is like \gls{glsxtr} but uses \gls{Glspl} instead of \gls{gls}.
+
+The category is set to:
+\cmddef{glsxtrcat}
+This should simply expand to the required category label.
+The default definition is \code{general}.
\begin{important}
-If you use the starred version of \cs{GlsXtrEnableOnTheFly}
-don't use any commands in the \meta{label}, even if they expand
-to just text.
-\end{important}
-
-\chapter{Supplemental Packages}
-\label{sec:supplemental}
-
-The \styfmt{glossaries} bundle provides additional support packages
-\sty{glossaries-prefix} (for prefixing) and \sty{glossaries-accsupp}
-(for accessibility support). These packages aren't automatically
-loaded.
-
-\section{Prefixes or Determiners}
-\label{sec:prefix}
-
-If prefixing is required, you can simply load
-\sty{glossaries-prefix} after \styfmt{glossaries-extra}. For example:
-\begin{verbatim}
-\documentclass{article}
-
-\usepackage{glossaries-extra}
-\usepackage{glossaries-prefix}
-
-\makeglossaries
-
-\newabbreviation
- [prefix={an\space},
- prefixfirst={a~}]
- {svm}{SVM}{support vector machine}
-
-\begin{document}
-
-First use: \pgls{svm}.
-Next use: \pgls{svm}.
-
-\printglossaries
-
-\end{document}
-\end{verbatim}
-
-\section{Accessibility Support}
-\label{sec:accsupp}
-
-\begin{important}
-The \sty{glossaries-accsupp} package is still experimental and so
-accessibility features are liable to change.
+The commands \gls{glsxtr}, \gls{glsxtrpl}, \gls{Glsxtr}
+and \gls{Glsxtrpl} can't be used after the \idxpl{glossary} have been
+displayed (through \gls{printglossary} etc). It's best not to mix
+these commands with the standard glossary commands, such
+as \gls{gls} or there may be unexpected results.
\end{important}
-The \sty{glossaries-accsupp} package needs to be loaded before
-\styfmt{glossaries-extra} or through the \pkgopt{accsupp} package
-option:
-\begin{verbatim}
-\usepackage[accsupp]{glossaries-extra}
-\end{verbatim}
-If you don't load \sty{glossaries-accsupp} or you load
-\sty{glossaries-accsupp} after \styfmt{glossaries-extra}
-the new \cs{glsaccess}\meta{xxx} commands described below will
-simply be equivalent to the corresponding \cs{glsentry}\meta{xxx}
-commands. Other accessibility features, such as the attributes used
-by \ics{newabbreviation} also won't work if \sty{glossaries-accsupp}
-is loaded too late.
-
-The following \cs{glsaccess}\meta{xxx} commands add accessibility information wrapped around
-the corresponding \cs{glsentry}\meta{xxx} commands. There is
-no check for existence of the entry nor do any of these commands
-add formatting, hyperlinks or indexing information.
-
-\begin{definition}[\DescribeMacro\glsaccessname]
-\cs{glsaccessname}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{name} field for the entry
-identified by \meta{label}.
-
-If the \sty{glossaries-accsupp} package isn't loaded, this is
-simply defined as:
-\begin{verbatim}
-\newcommand*{\glsaccessname}[1]{\glsentryname{#1}}
-\end{verbatim}
-otherwise it's defined as:
-\begin{verbatim}
-\newcommand*{\glsaccessname}[1]{%
- \glsnameaccessdisplay
- {%
- \glsentryname{#1}%
- }%
- {#1}%
-}
-\end{verbatim}
-(\ics{glsnameaccessdisplay} is defined by the
-\sty{glossaries-accsupp} package.) The first letter upper case
-version is:
-\begin{definition}[\DescribeMacro\Glsaccessname]
-\cs{Glsaccessname}\marg{label}
-\end{definition}
-Without the \sty{glossaries-accsupp} package this is just defined
-as:
-\begin{verbatim}
-\newcommand*{\Glsaccessname}[1]{\Glsentryname{#1}}
-\end{verbatim}
-With the \sty{glossaries-accsupp} package this is defined as:
-\begin{verbatim}
-\newcommand*{\Glsaccessname}[1]{%
- \glsnameaccessdisplay
- {%
- \Glsentryname{#1}%
- }%
- {#1}%
-}
-\end{verbatim}
-
-The following commands are all defined in an analogous manner.
-\begin{definition}[\DescribeMacro\glsaccesstext]
-\cs{glsaccesstext}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{text} field.
-
-\begin{definition}[\DescribeMacro\Glsaccesstext]
-\cs{Glsaccesstext}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{text} field with the first
-letter converted to upper case.
-
-\begin{definition}[\DescribeMacro\glsaccessplural]
-\cs{glsaccessplural}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{plural} field.
-
-\begin{definition}[\DescribeMacro\Glsaccessplural]
-\cs{Glsaccessplural}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{plural} field
-with the first letter converted to upper case.
-
-\begin{definition}[\DescribeMacro\glsaccessfirst]
-\cs{glsaccessfirst}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{first} field.
-
-\begin{definition}[\DescribeMacro\Glsaccessfirst]
-\cs{Glsaccessfirst}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{first} field
-with the first letter converted to upper case.
-
-\begin{definition}[\DescribeMacro\glsaccessfirstplural]
-\cs{glsaccessfirstplural}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{firstplural} field.
-
-\begin{definition}[\DescribeMacro\Glsaccessfirstplural]
-\cs{Glsaccessfirstplural}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{firstplural} field
-with the first letter converted to upper case.
-
-\begin{definition}[\DescribeMacro\glsaccesssymbol]
-\cs{glsaccesssymbol}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{symbol} field.
-
-\begin{definition}[\DescribeMacro\Glsaccesssymbol]
-\cs{Glsaccesssymbol}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{symbol} field
-with the first letter converted to upper case.
-
-\begin{definition}[\DescribeMacro\glsaccesssymbolplural]
-\cs{glsaccesssymbolplural}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{symbolplural} field.
-
-\begin{definition}[\DescribeMacro\Glsaccesssymbolplural]
-\cs{Glsaccesssymbolplural}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{symbolplural} field
-with the first letter converted to upper case.
-
-\begin{definition}[\DescribeMacro\glsaccessdesc]
-\cs{glsaccessdesc}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{description} field.
-
-\begin{definition}[\DescribeMacro\Glsaccessdesc]
-\cs{Glsaccessdesc}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{description} field
-with the first letter converted to upper case.
-
-\begin{definition}[\DescribeMacro\glsaccessdescplural]
-\cs{glsaccessdescplural}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{descriptionplural} field.
-
-\begin{definition}[\DescribeMacro\Glsaccessdescplural]
-\cs{Glsaccessdescplural}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{descriptionplural} field
-with the first letter converted to upper case.
-
-\begin{definition}[\DescribeMacro\glsaccessshort]
-\cs{glsaccessshort}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{short} field.
-
-\begin{definition}[\DescribeMacro\Glsaccessshort]
-\cs{Glsaccessshort}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{short} field with the first
-letter converted to upper case.
-
-\begin{definition}[\DescribeMacro\glsaccessshortpl]
-\cs{glsaccessshortpl}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{shortplural} field.
-
-\begin{definition}[\DescribeMacro\Glsaccessshortpl]
-\cs{Glsaccessshortpl}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{shortplural} field with the first
-letter converted to upper case.
-
-\begin{definition}[\DescribeMacro\glsaccesslong]
-\cs{glsaccesslong}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{long} field.
-
-\begin{definition}[\DescribeMacro\Glsaccesslong]
-\cs{Glsaccesslong}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{long} field with the first
-letter converted to upper case.
-
-\begin{definition}[\DescribeMacro\glsaccesslongpl]
-\cs{glsaccesslongpl}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{longplural} field.
-
-\begin{definition}[\DescribeMacro\Glsaccesslongpl]
-\cs{Glsaccesslongpl}\marg{label}
-\end{definition}
-This displays the value of the \gloskey{longplural} field with the first
-letter converted to upper case.
-
-\chapter{Sample Files}
+\chapter{Supplementary Files}
+\label{sec:extrafiles}
+
+The \sty{glossaries-extra} package comes with some additional files.
+Those listed in \sectionref{sec:exampleglossariesfiles} provide
+dummy entries for testing various styles. They should be placed on
+\TeX's path.
+
+There are also some sample files listed in \sectionref{sec:samples}.
+These should be located in the package documentation directory.
+
+\section{Dummy Files for Testing}
+\label{sec:exampleglossariesfiles}
+
+The base \sty{glossaries} package provides files with dummy entries
+for testing. The \sty{glossaries-extra} package provides an
+additional file with entries.
+
+\filedef{example-glossaries-xr.tex}
+This file contains entries that have the \gloskey{see}, \gloskey{seealso} or
+\gloskey{alias} keys set.
+
+There are also \ext+{bib} files corresponding to all the available
+\ext+{tex} files for use with \app{bib2gls}.
+
+\filedef{example-glossaries-acronym.bib}
+Corresponds to \filefmt{example-glossaries-acronym.tex}
+\filedef{example-glossaries-acronym-desc.bib}
+Corresponds to \filefmt{example-glossaries-acronym-desc.tex}
+\filedef{example-glossaries-acronyms-lang.bib}
+Corresponds to \filefmt{example-glossaries-acronyms-lang.tex}
+\filedef{example-glossaries-brief.bib}
+Corresponds to \filefmt{example-glossaries-brief.tex}
+\filedef{example-glossaries-childmultipar.bib}
+Corresponds to \filefmt{example-glossaries-childmultipar.tex}
+\filedef{example-glossaries-childnoname.bib}
+Corresponds to \filefmt{example-glossaries-childnoname.tex}
+\filedef{example-glossaries-cite.bib}
+Corresponds to \filefmt{example-glossaries-cite.tex}
+\filedef{example-glossaries-images.bib}
+Corresponds to \filefmt{example-glossaries-images.tex}
+\filedef{example-glossaries-long.bib}
+Corresponds to \filefmt{example-glossaries-long.tex}
+\filedef{example-glossaries-longchild.bib}
+Corresponds to \filefmt{example-glossaries-longchild.tex}
+\filedef{example-glossaries-multipar.bib}
+Corresponds to \filefmt{example-glossaries-multipar.tex}
+\filedef{example-glossaries-parent.bib}
+Corresponds to \filefmt{example-glossaries-parent.tex}
+\filedef{example-glossaries-symbolnames.bib}
+Corresponds to \filefmt{example-glossaries-symbolnames.tex}
+\filedef{example-glossaries-symbols.bib}
+Corresponds to \filefmt{example-glossaries-symbols.tex}
+\filedef{example-glossaries-url.bib}
+Corresponds to \filefmt{example-glossaries-url.tex}
+\filedef{example-glossaries-xr.bib}
+Corresponds to \filefmt{example-glossaries-xr.tex}
+
+\section{Sample Files}
\label{sec:samples}
-The following sample files are provided with this package:
-\begin{description}
-\item[sample.tex] Simple sample file that uses one of the dummy
-files provided by the \styfmt{glossaries} package for testing.
-
-\item[sample-abbr-styles.tex] Demonstrates all predefined
-abbreviation styles.
-
-\item[sample-mixture.tex] General entries, acronyms and initialisms
-all treated differently.
-
-\item[sample-name-font] Categories and attributes are used to
+The \sty{glossaries-extra} package comes with some sample files
+that are listed below. There are also sample files provided with the
+\sty{glossaries} package and with \app{bib2gls}. See also
+the \gallery{Dickimaw Books Gallery}.
+
+\filedef{sample.tex}
+Simple sample file that uses one of the dummy
+files provided by the \sty{glossaries} package for testing.
+\begin{terminal}
+pdflatex sample
+makeglossaries sample
+pdflatex sample
+pdflatex sample
+\end{terminal}
+
+\filedef{sample-abbr-styles.tex}
+\begin{terminal}
+pdflatex sample-abbr-styles
+makeglossaries sample-abbr-styles
+pdflatex sample-abbr-styles
+pdflatex sample-abbr-styles
+\end{terminal}
+Demonstrates all predefined abbreviation styles.
+
+\filedef{sample-mixture.tex}
+\begin{terminal}
+pdflatex sample-mixture
+makeglossaries sample-mixture
+pdflatex sample-mixture
+makeglossaries sample-mixture
+pdflatex sample-mixture
+\end{terminal}
+General entries, acronyms and initialisms all treated differently.
+
+\filedef{sample-name-font.tex}
+\begin{terminal}
+pdflatex sample-name-font
+makeglossaries sample-name-font
+pdflatex sample-name-font
+pdflatex sample-name-font
+\end{terminal}
+Categories and attributes are used to
customize the way different entries appear.
-\item[sample-abbrv.tex] General abbreviations.
-
-\item[sample-acronym.tex] Acronyms aren't initialisms and don't
-expand on \gls{firstuse}.
-
-\item[sample-acronym-desc.tex] Acronyms that have a separate long
-form and description.
-
-\item[sample-crossref.tex] Unused entries that have been
-cross-referenced automatically are added at the end of the document.
-
-\item[sample-indexhook.tex] Use the index hook to track
-which entries have been indexed (and therefore find out
-which ones haven't been indexed).
-
-\item[sample-footnote.tex] Footnote abbreviation style that moves
-the footnote marker outside of the hyperlink generated by \cs{gls}
+\filedef{sample-abbrv.tex}
+\begin{terminal}
+pdflatex sample-abbrv
+makeglossaries sample-abbrv
+pdflatex sample-abbrv
+pdflatex sample-abbrv
+\end{terminal}
+General abbreviations.
+
+\filedef{sample-acronym.tex}
+\begin{terminal}
+pdflatex sample-acronym
+makeglossaries sample-acronym
+pdflatex sample-acronym
+\end{terminal}
+Acronyms aren't initialisms and don't expand on \idx{firstuse}.
+
+\filedef{sample-acronym-desc.tex}
+\begin{terminal}
+pdflatex sample-acronym-desc
+makeglossaries sample-acronym-desc
+pdflatex sample-acronym-desc
+makeglossaries sample-acronym-desc
+pdflatex sample-acronym-desc
+\end{terminal}
+Acronyms that have a separate long form and description.
+
+\filedef{sample-crossref.tex}
+\begin{terminal}
+pdflatex sample-crossref
+makeglossaries sample-crossref
+pdflatex sample-crossref
+\end{terminal}
+Unused entries that have been cross-referenced automatically are
+added at the end of the document.
+
+\filedef{sample-indexhook.tex}
+\begin{terminal}
+pdflatex sample-indexhook
+makeglossaries sample-indexhook
+pdflatex sample-indexhook
+\end{terminal}
+Use the index hook to track which entries have been indexed (and
+therefore find out which ones haven't been indexed).
+
+\filedef{sample-footnote.tex}
+\begin{terminal}
+pdflatex sample-footnote
+makeglossaries sample-footnote
+pdflatex sample-footnote
+\end{terminal}
+Footnote abbreviation style that moves
+the footnote marker outside of the hyperlink generated by \gls{gls}
and moves it after certain punctuation characters for neatness.
-\item[sample-undef.tex] Warn on undefined entries instead of
+\filedef{sample-undef.tex}
+\begin{terminal}
+pdflatex sample-undef
+makeglossaries sample-undef
+pdflatex sample-undef
+pdflatex sample-undef
+\end{terminal}
+Warn on undefined entries instead of
generating an error.
-\item[sample-mixed-abbrv-styles.tex] Different abbreviation styles
-for different entries.
-
-\item[sample-initialisms.tex] Automatically insert dots into
-initialisms.
-
-\item[sample-postdot.tex] Another initialisms example.
-
-\item[sample-postlink.tex] Automatically inserting text after
-the \gls{linktext} produced by commands like \cs{gls} (outside
+\filedef{sample-mixed-abbrv-styles.tex}
+\begin{terminal}
+pdflatex sample-mixed-abbrv-styles
+makeglossaries sample-mixed-abbrv-styles
+pdflatex sample-mixed-abbrv-styles
+\end{terminal}
+Different abbreviation styles for different entries.
+
+\filedef{sample-initialisms.tex}
+\begin{terminal}
+pdflatex sample-initialisms
+makeglossaries sample-initialisms
+pdflatex sample-initialisms
+\end{terminal}
+Automatically insert dots into initialisms.
+
+\filedef{sample-postdot.tex}
+\begin{terminal}
+pdflatex sample-postdot
+makeglossaries sample-postdot
+pdflatex sample-postdot
+\end{terminal}
+Another initialisms example.
+
+\filedef{sample-postlink.tex}
+\begin{terminal}
+pdflatex sample-postlink
+makeglossaries sample-postlink
+pdflatex sample-postlink
+\end{terminal}
+Automatically inserting text after
+the \idx{linktext} produced by commands like \gls{gls} (outside
of hyperlink, if present).
-\item[sample-header.tex] Using entries in section/chapter headings.
-
-\item[sample-autoindex.tex] Using the \catattr{dualindex} and
-\catattr{indexname} attributes to automatically add glossary
-entries to the index (in addition to the glossary \gls{locationlist}).
-
-\item[sample-autoindex-hyp.tex] As previous but uses \sty{hyperref}.
-
-\item[sample-nested.tex] Using \ics{gls} within the
-value of the \gloskey{name} key.
-
-\item[sample-entrycount.tex] Enable entry-use counting (only index
-if used more than $n$ times, see \sectionref{sec:entrycount}).
-
-\item[sample-unitentrycount.tex] Enable use of per-unit entry-use counting
-(\sectionref{sec:entrycount}).
-
-\item[sample-onelink.tex] Using the per-unit entry counting
-(\sectionref{sec:entrycount})
-to only have one hyperlink per entry per page.
-
-\item[sample-linkcount.tex] Using link counting
-(\sectionref{sec:linkcount})
+\filedef{sample-header.tex}
+\begin{terminal}
+pdflatex sample-header
+makeglossaries sample-header
+pdflatex sample-header
+pdflatex sample-header
+\end{terminal}
+Using entries in section\slash chapter headings.
+
+\filedef{sample-autoindex.tex}
+\begin{terminal}
+pdflatex sample-autoindex
+makeglossaries sample-autoindex
+pdflatex sample-autoindex
+makeindex sample-autoindex
+pdflatex sample-autoindex
+\end{terminal}
+Using the \catattr{dualindex} and \catattr{indexname} attributes to
+automatically add glossary entries to the index (in addition to the
+glossary \idx{locationlist}).
+
+\filedef{sample-autoindex-hyp.tex}
+\begin{terminal}
+pdflatex sample-autoindex-hyp
+makeglossaries sample-autoindex-hyp
+pdflatex sample-autoindex-hyp
+makeindex sample-autoindex-hyp
+pdflatex sample-autoindex-hyp
+\end{terminal}
+As previous but uses \sty{hyperref}.
+
+\filedef{sample-nested.tex}
+\begin{terminal}
+pdflatex sample-nested
+makeglossaries sample-nested
+pdflatex sample-nested
+\end{terminal}
+Using \gls{gls} within the value of the \gloskey{name} key.
+
+\filedef{sample-entrycount.tex}
+\begin{terminal}
+pdflatex sample-entrycount
+pdflatex sample-entrycount
+makeglossaries sample-entrycount
+pdflatex sample-entrycount
+\end{terminal}
+Enable entry-use counting (only index if used more than $n$ times,
+see \sectionref{sec:entrycount}).
+
+\filedef{sample-unitentrycount.tex}
+\begin{terminal}
+pdflatex sample-unitentrycount
+pdflatex sample-unitentrycount
+makeglossaries sample-unitentrycount
+pdflatex sample-unitentrycount
+\end{terminal}
+Enable use of per-unit entry-use counting (\sectionref{sec:entrycount}).
+
+\filedef{sample-onelink.tex}
+\begin{terminal}
+pdflatex sample-onelink
+makeglossaries sample-onelink
+pdflatex sample-onelink
+\end{terminal}
+Using the per-unit entry counting (\sectionref{sec:entrycount}) to
+only have one hyperlink per entry per page.
+
+\filedef{sample-linkcount.tex}
+\begin{terminal}
+pdflatex sample-linkcount
+makeglossaries sample-linkcount
+pdflatex sample-linkcount
+\end{terminal}
+Using link counting (\sectionref{sec:linkcount})
to only have one hyperlink per entry.
-\item[sample-pages.tex] Insert \qt{page} or \qt{pages} before the
-location list.
-
-\item[sample-altmodifier.tex] Set the default options for
-commands like \cs{gls} and add an alternative modifier.
-
-\item[sample-mixedsort.tex] Uses the optional argument
-of \cs{makeglossaries} to allow a mixture of \cs{printglossary}
-and \cs{printnoidxglossary}.
-
-\item[sample-external.tex] Uses the \catattr{targeturl} attribute
-to allow for entries that should link to an external URL
-rather than to an internal glossary.
-
-\item[sample-fmt.tex] Provides text-block commands associated
-with entries in order to use \cs{glsxtrfmt}.
-
-\item[sample-alias.tex] Uses the \gloskey{alias} key.
-(See \sectionref{sec:alias}.)
-
-\item[sample-alttree.tex] Uses the \sty{glossaries-extra-stylemods}
-package with the \glostyle{alttree} style (see \sectionref{sec:stylemods}).
-
-\item[sample-alttree-sym.tex] Another \glostyle{alttree} example
-that measures the symbol widths.
-
-\item[sample-alttree-marginpar.tex] Another \glostyle{alttree} example
-that puts the \gls{numberlist} in the margin.
-
-\item[sample-onthefly.tex] Using on-the-fly commands. Terms with
-accents must have the \gloskey{name} key explicitly set.
-
-\item[sample-onthefly-xetex.tex] Using on-the-fly commands
-with \XeLaTeX. Terms with UTF-8 characters don't need to
-have the \gloskey{name} key explicitly set. Terms that contain
-commands must have the \gloskey{name} key explicitly set
+\filedef{sample-pages.tex}
+\begin{terminal}
+pdflatex sample-pages
+makeglossaries sample-pages
+pdflatex sample-pages
+pdflatex sample-pages
+\end{terminal}
+Insert \qt{page} or \qt{pages} before the \idx{locationlist}.
+
+\filedef{sample-altmodifier.tex}
+\begin{terminal}
+pdflatex sample-altmodifier
+makeglossaries sample-altmodifier
+pdflatex sample-altmodifier
+pdflatex sample-altmodifier
+\end{terminal}
+Set the default options for commands like \gls{gls} and add an
+alternative modifier.
+
+\filedef{sample-mixedsort.tex}
+\begin{terminal}
+pdflatex sample-mixedsort
+pdflatex sample-mixedsort
+\end{terminal}
+Uses the optional argument of \gls{makeglossaries} to allow a
+mixture of \gls{printglossary} and \gls{printnoidxglossary}.
+
+\filedef{sample-external.tex}
+\begin{terminal}
+pdflatex sample-external
+makeglossaries sample-external
+pdflatex sample-external
+\end{terminal}
+Uses the \catattr{targeturl} attribute to allow for entries that
+should link to an external URL rather than to an internal glossary.
+
+\filedef{sample-fmt.tex}
+\begin{terminal}
+pdflatex sample-fmt
+makeglossaries sample-fmt
+pdflatex sample-fmt
+\end{terminal}
+Provides text-block commands associated
+with entries in order to use \gls{glsxtrfmt}.
+
+\filedef{sample-alias.tex}
+\begin{terminal}
+pdflatex sample-alias
+makeglossaries sample-alias
+pdflatex sample-alias
+\end{terminal}
+Uses the \gloskey{alias} key (see \sectionref{sec:alias}).
+
+\filedef{sample-alttree.tex}
+\begin{terminal}
+pdflatex sample-alttree
+makeglossaries sample-alttree
+pdflatex sample-alttree
+\end{terminal}
+Uses the \sty{glossaries-extra-stylemods} package with the
+\glostyle{alttree} style (see \sectionref{sec:stylemods}).
+
+\filedef{sample-alttree-sym.tex}
+\begin{terminal}
+pdflatex sample-alttree-sym
+makeglossaries sample-alttree-sym
+pdflatex sample-alttree-sym
+\end{terminal}
+Another \glostyle{alttree} example that measures the symbol widths.
+
+\filedef{sample-alttree-marginpar.tex}
+\begin{terminal}
+pdflatex sample-alttree-marginpar
+makeglossaries sample-alttree-marginpar
+pdflatex sample-alttree-marginpar
+\end{terminal}
+Another \glostyle{alttree} example
+that puts the \idx{locationlist} in the margin.
+
+\filedef{sample-onthefly.tex}
+\begin{terminal}
+pdflatex sample-onthefly
+makeglossaries sample-onthefly
+pdflatex sample-onthefly
+\end{terminal}
+Using on-the-fly commands. Terms with accents must have the
+\gloskey{name} key explicitly set.
+
+\filedef{sample-onthefly-xetex.tex}
+\begin{terminal}
+xelatex sample-onthefly-xetex
+makeglossaries sample-onthefly-xetex
+xelatex sample-onthefly-xetex
+\end{terminal}
+Using on-the-fly commands with \XeLaTeX. Terms with UTF-8 characters
+don't need to have the \gloskey{name} key explicitly set. Terms that
+contain commands must have the \gloskey{name} key explicitly set
with the commands removed from the label.
-\item[sample-onthefly-utf8.tex] Tries to emulate the previous
+\filedef{sample-onthefly-utf8.tex}
+\begin{terminal}
+pdflatex sample-onthefly-utf8
+makeglossaries sample-onthefly-utf8
+pdflatex sample-onthefly-utf8
+\end{terminal}
+Tries to emulate the previous
sample file for use with \LaTeX\ through the starred version
-of \ics{GlsXtrEnableOnTheFly}. This is a bit iffy and may not
-always work. Terms that contain commands must have the
-\gloskey{name} key explicitly set with the commands removed from
+of \gls{GlsXtrEnableOnTheFly}. This is a bit iffy and may not
+always work. Terms that contain commands must have the
+\gloskey{name} key explicitly set with the commands removed from
the label.
-\item[sample-accsupp.tex] Integrate \sty{glossaries-accsupp}.
-
-\item[sample-prefix.tex] Integrate \sty{glossaries-prefix}.
-
-\item[sample-suppl-main.tex] Uses \gloskey[glsadd]{thevalue} to
-reference a location in the supplementary file
-\texttt{sample-suppl.tex}.
-
-\item[sample-suppl-main-hyp.tex] A more complicated version to the
+\filedef{sample-accsupp.tex}
+\begin{terminal}
+pdflatex sample-accsupp
+makeglossaries sample-accsupp
+pdflatex sample-accsupp
+\end{terminal}
+Integrate \sty{glossaries-accsupp}.
+
+\filedef{sample-prefix.tex}
+\begin{terminal}
+pdflatex sample-prefix
+makeglossaries sample-prefix
+pdflatex sample-prefix
+\end{terminal}
+Integrate \sty{glossaries-prefix}.
+
+\filedef{sample-suppl-main.tex}
+\begin{terminal}
+pdflatex sample-suppl
+pdflatex sample-suppl-main
+makeglossaries sample-suppl-main
+pdflatex sample-suppl-main
+\end{terminal}
+Uses \glsopt{thevalue} to reference a location in the supplementary
+file \inlineglsdef{file.sample-suppl.tex}.
+
+\filedef{sample-suppl-main-hyp.tex}
+\begin{terminal}
+pdflatex sample-suppl-hyp
+makeglossaries sample-suppl-hyp
+pdflatex sample-suppl-hyp
+pdflatex sample-suppl-main-hyp
+makeglossaries sample-suppl-main-hyp
+pdflatex sample-suppl-main-hyp
+\end{terminal}
+A more complicated version to the
above that uses the \sty{hyperref} package to reference a location
-in the supplementary file \texttt{sample-suppl-hyp.tex}.
+in the supplementary file \inlineglsdef{file.sample-suppl-hyp.tex}.
-\end{description}
\chapter{Multi-Lingual Support}
\label{sec:lang}
-There's only one command provided by \styfmt{glossaries-extra}
+There's only one command provided by \sty{glossaries-extra}
that you're likely to want to change in your document and that's
-\ics{abbreviationsname} (\sectionref{sec:pkgopts}) if you use
-the \pkgopt{abbreviations} package option to automatically
-create the glossary labelled \texttt{abbreviations}. If this
+\gls{abbreviationsname} if you use
+the \opt{abbreviations} package option to automatically
+create the glossary labelled \code{abbreviations}. If this
command doesn't already exist, it will be defined to
\qt{Abbreviations} if \sty{babel} hasn't been loaded, otherwise
-it will be defined as \cs{acronymname} (provided by
-\styfmt{glossaries}).
+it will be defined as \gls{acronymname} (provided by
+\sty{glossaries}), which is language-sensitive.
-You can redefine it in the usual way. For example:
-\begin{verbatim}
-\renewcommand*{\abbreviationsname}{List of Abbreviations}
-\end{verbatim}
+You can redefine \gls{abbreviationsname} in the usual way. For example:
+\begin{codebox}
+\cmd{renewcommand}*\marg{\gls{abbreviationsname}}\marg{List of Abbreviations}
+\end{codebox}
Or using \sty{babel} or \sty{polyglossia} captions hook:
-\begin{verbatim}
-\appto\captionsenglish{%
- \renewcommand*{\abbreviationsname}{List of Abbreviations}%
+\begin{codebox}
+\cmd{appto}\cmd{captionsenglish}\marg{\comment{}
+ \cmd{renewcommand}*\marg{\gls{abbreviationsname}}\marg{List of Abbreviations}\comment{}
}
-\end{verbatim}
+\end{codebox}
-Alternatively you can use the \gloskey[printglossary]{title}
+Alternatively you can use the \printglossopt{title}
key when you print the list of abbreviations. For example:
-\begin{verbatim}
-\printabbreviations[title={List of Abbreviations}]
-\end{verbatim}
+\begin{codebox}
+\gls{printabbreviations}\oarg{\printglossoptvalm{title}{List of Abbreviations}}
+\end{codebox}
or
-\begin{verbatim}
-\printglossary[type=abbreviations,title={List of Abbreviations}]
-\end{verbatim}
+\begin{codebox}
+\gls{printabbreviations}\oarg{\printglossopt{type}{abbreviations},\printglossoptvalm{title}{List of Abbreviations}}
+\end{codebox}
The other fixed text commands are the diagnostic messages, which
shouldn't appear in the final draft of your document.
-The \styfmt{glossaries-extra} package has the facility to load
+The \sty{glossaries-extra} package has the facility to load
language modules (whose filename is in the form
-\texttt{glossariesxtr\dhyphen}\meta{language}\texttt{.ldf}) if they exist,
+\metafilefmt{glossariesxtr\dhyphen}{language}{.\ext+{ldf}}) if they exist,
but won't warn if they don't. If \sty{glossaries-extra-bib2gls} is
-loaded via the \pkgopt{record} package option then the check for
+loaded via the \opt{record} package option then the check for
language resource files will additionally search for an associated
language script file given by
-\texttt{glossariesxtr-}\meta{script}\texttt{.ldf} where
+\metafilefmt{glossariesxtr-}{script}{.\ext{ldf}} where
\meta{script} is the four letter script identifier, such as
-\texttt{Latn}, associated with the given dialect. There's no warning if the
+\code{Latn}, associated with the given dialect. There's no warning if the
associated file isn't found. The script file is loaded after the
dialect file.
If you want to write your own language module, you just need to
create a file called
-\texttt{glossariesxtr\dhyphen}\meta{lang}\texttt{.ldf}, where \meta{lang}
+\metafilefmt{glossariesxtr\dhyphen}{lang}{.\ext{ldf}}, where \meta{lang}
identifies the language or dialect (see the \sty{tracklang}
-package). For example, \nolinkurl{glossariesxtr-french.ldf}.
-
+package). For example, \filefmt{glossariesxtr-french.ldf}.
+The file should start with:
+\cmddef{ProvidesGlossariesExtraLang}
The simplest code for this file is:
-\begin{verbatim}
-\ProvidesGlossariesExtraLang{french}[2015/12/09 v1.0]
-
-\newcommand*{\glossariesxtrcaptionsfrench}{%
- \def\abbreviationsname{Abr\'eviations}%
+\begin{codebox}
+\gls{ProvidesGlossariesExtraLang}\marg{french}\oarg{2015/12/09 v1.0}
+\codepar
+\cmd{newcommand}*\marg{\cmd{glossariesxtrcaptionsfrench}}\marg{\comment{}
+ \cmd{def}\gls{abbreviationsname}\marg{Abr\cmd{'}eviations}\comment{}
}
-\glossariesxtrcaptionsfrench
-
-\ifcsdef{captions\CurrentTrackedDialect}
-{%
- \csappto{captions\CurrentTrackedDialect}%
- {%
- \glossariesxtrcaptionsfrench
- }%
-}%
-{%
- \ifcsdef{captions\CurrentTrackedLanguage}
- {%
- \csappto{captions\CurrentTrackedLanguage}%
- {%
- \glossariesxtrcaptionsfrench
- }%
- }%
- {}%
+\cmd{glossariesxtrcaptionsfrench}
+\codepar
+\cmd{ifcsdef}\marg{captions\gls+{CurrentTrackedDialect}}
+\marg{\comment{}
+ \cmd{csappto}\marg{captions\gls{CurrentTrackedDialect}}\comment{}
+ \marg{\comment{}
+ \cmd{glossariesxtrcaptionsfrench}
+ }\comment{}
+}\comment{}
+\marg{\comment{}
+ \cmd{ifcsdef}\marg{captions\gls+{CurrentTrackedLanguage}}
+ \marg{\comment{}
+ \cmd{csappto}\marg{captions\gls{CurrentTrackedLanguage}}\comment{}
+ \marg{\comment{}
+ \cmd{glossariesxtrcaptionsfrench}
+ }\comment{}
+ }\comment{}
+ \marg{}\comment{}
}
-\end{verbatim}
+\end{codebox}
-You can adapt this for other languages by replacing
-all instances of the language identifier \texttt{french} and
-the translated text \verb|Abr\'eviations| as appropriate.
-You can also use the \texttt{.ldf} file to provide rule
-blocks for a particular language for use with \gls{bib2gls}['s] custom
+You can adapt this for other languages by replacing
+all instances of the language identifier \code{french} and
+the translated text \code{Abr\cmd{'}eviations} as appropriate.
+You can also use the \ext+{ldf} file to provide rule
+blocks for a particular language for use with \app{bib2gls}['s] custom
sort rule. See \sectionref{sec:bib2glssty} for further details.
-This \texttt{.ldf} file then needs to be put somewhere on \TeX's
-path so that it can be found by \styfmt{glossaries-extra}.
-You might also want to consider uploading it to CTAN so that
+\begin{information}
+For further information on \sty{tracklang}, see the \sty{tracklang}
+documentation or \dickimawhref{latex/tracklang/}{Localisation with
+\filefmt{tracklang.tex}}.
+\end{information}
+
+This \ext{ldf} file then needs to be put somewhere on \TeX's
+path so that it can be found by \sty{glossaries-extra}.
+You might also want to consider uploading it to \ctanref{}{CTAN} so that
it can be useful to others. (Please don't send it to me. I already
have more packages than I am able to maintain.)
If you additionally want to provide translations for the diagnostic
messages used when a glossary is missing, you need to redefine
the following commands:
-\begin{definition}[\DescribeMacro\GlsXtrNoGlsWarningHead]
-\cs{GlsXtrNoGlsWarningHead}\marg{label}\marg{file}
-\end{definition}
+\cmddef{GlsXtrNoGlsWarningHead}
This produces the following text in English:
\begin{quote}
-\GlsXtrNoGlsWarningHead{\meta{label}}{\meta{file}}
+\GlsXtrNoGlsWarningHead{\meta{glossary-label}}{\meta{file}}
\end{quote}
-\begin{definition}[\DescribeMacro\GlsXtrNoGlsWarningEmptyStart]
-\cs{GlsXtrNoGlsWarningEmptyStart}
-\end{definition}
+\cmddef{GlsXtrNoGlsWarningEmptyStart}
This produces the following text in English:
\begin{quote}
\GlsXtrNoGlsWarningEmptyStart
\end{quote}
-\begin{definition}[\DescribeMacro\GlsXtrNoGlsWarningEmptyMain]
-\cs{GlsXtrNoGlsWarningEmptyMain}
-\end{definition}
+\cmddef{GlsXtrNoGlsWarningEmptyMain}
This produces the following text in English:
\begin{quote}
\GlsXtrNoGlsWarningEmptyMain
\end{quote}
-\begin{definition}[\DescribeMacro\GlsXtrNoGlsWarningEmptyNotMain]
-\cs{GlsXtrNoGlsWarningEmptyNotMain}\marg{label}
-\end{definition}
+\cmddef{GlsXtrNoGlsWarningEmptyNotMain}
This produces the following text in English:
\begin{quote}
-\GlsXtrNoGlsWarningEmptyNotMain{\meta{label}}
+\GlsXtrNoGlsWarningEmptyNotMain{\meta{glossary-label}}
\end{quote}
-\begin{definition}[\DescribeMacro\GlsXtrNoGlsWarningCheckFile]
-\cs{GlsXtrNoGlsWarningCheckFile}\marg{file}
-\end{definition}
+\cmddef{GlsXtrNoGlsWarningCheckFile}
This produces the following text in English:
\begin{quote}
\GlsXtrNoGlsWarningCheckFile{\meta{file}}
\end{quote}
-\begin{definition}[\DescribeMacro\GlsXtrNoGlsWarningMisMatch]
-\cs{GlsXtrNoGlsWarningMisMatch}
-\end{definition}
+\cmddef{GlsXtrNoGlsWarningMisMatch}
This produces the following text in English:
\begin{quote}
\GlsXtrNoGlsWarningMisMatch
\end{quote}
-\begin{definition}[\DescribeMacro\GlsXtrNoGlsWarningNoOut]
-\cs{GlsXtrNoGlsWarningNoOut}\marg{file}
-\end{definition}
+\cmddef{GlsXtrNoGlsWarningNoOut}
This produces the following text in English:
\begin{quote}
\GlsXtrNoGlsWarningNoOut{\meta{file}}
\end{quote}
-\begin{definition}[\DescribeMacro\GlsXtrNoGlsWarningTail]
-\cs{GlsXtrNoGlsWarningTail}
-\end{definition}
+\cmddef{GlsXtrNoGlsWarningTail}
This produces the following text in English:
\begin{quote}
\GlsXtrNoGlsWarningTail
\end{quote}
-\begin{definition}[\DescribeMacro\GlsXtrNoGlsWarningBuildInfo]
-\cs{GlsXtrNoGlsWarningBuildInfo}
-\end{definition}
+\cmddef{GlsXtrNoGlsWarningBuildInfo}
This is advice on how to generate the glossary files.
-\begin{definition}[\DescribeMacro\GlsXtrNoGlsWarningAutoMake]
-\cs{GlsXtrNoGlsWarningAutoMake}\marg{label}
-\end{definition}
-This is the message produced when the \pkgopt{automake} option
+\cmddef{GlsXtrNoGlsWarningAutoMake}
+This is the message produced when the \opt{automake} option
is used, but the document needs a rerun or the shell escape
setting doesn't permit the execution of the external application.
This command also generates a warning in the transcript file.
-See the documented code (\nolinkurl{glossaries-extra-code.pdf})
+See the documented code (\filefmt{glossaries-extra-code.pdf})
for further details.
-\printglossaries
-\PrintIndex
-
+\part{Summaries and Index}
+\backmatter
+\printterms[title={Terms}]
+\printcommonoptions[label=sec:gloskeys]{idx.gloskey}
+\printcommonoptions{idx.glosfield}
+\printcommonoptions{idx.glsopt}
+\printcommonoptions{idx.mglsopt}
+\printcommonoptions{idx.printglossopt}
+\printcommonoptions{idx.abbrvstyle}
+\printcommonoptions{idx.glossarystyle}
+\printsummary
+
+\printuserguideindex
\end{document}
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra.dtx b/macros/latex/contrib/glossaries-extra/glossaries-extra.dtx
index 530455599f..ff8449fc09 100644
--- a/macros/latex/contrib/glossaries-extra/glossaries-extra.dtx
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra.dtx
@@ -1,25 +1,28 @@
%\iffalse
% glossaries-extra.dtx generated using makedtx version 1.2 (c) Nicola Talbot
% Command line args:
-% -comment ".*\.tex"
-% -comment ".*\.bib"
+% -doc "glossaries-extra-codedoc.tex"
% -setambles ".*\.bib=>\nopreamble\nopostamble"
-% -author "Nicola Talbot"
% -macrocode ".*\.tex"
% -macrocode ".*\.bib"
-% -codetitle "Main Package Code (\\styfmt{glossaries-extra.sty})"
-% -doc "glossaries-extra-codedoc.tex"
+% -comment ".*\.tex"
+% -comment ".*\.bib"
+% -codetitle "Main Package Code (glossaries-extra.sty)"
+% -section "section"
+% -author "Nicola Talbot"
% -src "glossaries-extra.sty\Z=>glossaries-extra.sty"
+% -src "(.+)\.def\Z=>\1.def"
% -src "glossaries-extra-bib2gls.sty\Z=>glossaries-extra-bib2gls.sty"
% -src "glossaries-extra-stylemods.sty\Z=>glossaries-extra-stylemods.sty"
% -src "glossary-bookindex.sty\Z=>glossary-bookindex.sty"
% -src "glossary-longextra.sty\Z=>glossary-longextra.sty"
% -src "glossary-topic.sty\Z=>glossary-topic.sty"
+% -src "glossary-table.sty\Z=>glossary-table.sty"
% -src "(example-glossaries-.+\.tex)\Z=>\1"
% -src "(example-glossaries-.+\.bib)\Z=>\1"
-% -section "chapter"
+% -src "(glossar.+-2021-11-22.sty)\Z=>\1"
% glossaries-extra
-% Created on 2021/11/22 21:22
+% Created on 2022/10/19 17:47
%\fi
%\iffalse
%<*package>
@@ -42,198 +45,118 @@
%\fi
% \iffalse
% Doc-Source file to use with LaTeX2e
-% Copyright (C) 2021 Nicola Talbot, all rights reserved.
+% Copyright (C) 2022 Nicola Talbot, all rights reserved.
% \fi
% \iffalse
%<*driver>
-\documentclass[report,widecs]{nlctdoc}
-
\iffalse
glossaries-extra-codedoc.tex is a stub file used by makedtx to create
glossaries-extra.dtx
\fi
-\usepackage{alltt}
-\usepackage{pifont}
-\usepackage[utf8]{inputenc}
-\usepackage[T1]{fontenc}
-\usepackage[colorlinks,
- bookmarks,
- hyperindex=false,
- pdfauthor={Nicola L.C. Talbot},
- pdftitle={glossaries-extra.sty: an extension to the glossaries
-package},
- pdfkeywords={LaTeX,package,glossary,abbreviations}]{hyperref}
-\usepackage[nonumberlist,nopostdot=false]{glossaries-extra}
+\documentclass{article}
+\usepackage{doc}
-\RecordChanges
-
-\makeglossaries
-
-\renewcommand*{\main}[1]{\hyperpage{#1}}
-\newcommand*{\htextbf}[1]{\textbf{\hyperpage{#1}}}
-\newcommand*{\itermdef}[1]{\index{#1|htextbf}}
-
-\newglossaryentry{xindy}{
- name={\appfmt{xindy}\index{xindy|htextbf}},
- sort={xindy},
- text={\protect\app{xindy}},
- description={An flexible indexing application with multilingual
- support written in Perl}
-}
-
-\newglossaryentry{makeindex}{%
- name={\appfmt{makeindex}\index{makeindex|htextbf}},%
- sort={makeindex},%
- text={\protect\app{makeindex}},%
- description={An indexing application},
-}
-
-\newglossaryentry{bib2gls}{%
-name={\appfmt{bib2gls}\index{bib2gls=\appfmt{bib2gls}|htextbf}},%
-sort={bib2gls},%
-text={\appfmt{bib2gls}\iapp{bib2gls}},%
-description={A command line Java application that selects
-entries from a .bib file and converts them to glossary
-definitions (like \appfmt{bibtex} but also performs hierarchical
-sorting and collation, thus omitting the need for \gls{xindy} or
-\gls{makeindex}). Further details at:
-\url{http://www.dickimaw-books.com/software/bib2gls/}.}%
-}
-
-\let\glsd\glsuseri
-\let\glsation\glsuserii
-
-\newglossaryentry{firstuse}{%
- name={First use\ifirstuse},
- sort={first use},%
- text={first use},%
- user1={first used},
- description={The first time a glossary entry is used (from the start
- of the document or after a reset) with one of the
- following commands: \ics{gls}, \ics{Gls}, \ics{GLS}, \ics{glspl},
- \ics{Glspl}, \ics{GLSpl} or \ics{glsdisp}.
- \glsadd{firstuseflag}\glsadd{firstusetext}%
- \glsseeformat{firstuseflag,firstusetext}{}\nopostdesc}%
-}
-
-\newglossaryentry{firstuseflag}{%
-name={First use flag\ifirstuseflag},
-sort={first use flag},%
-text={first use flag},%
-description={A conditional that determines whether or not the entry
-has been used according to the rules of \gls{firstuse}}%
-}
-
-\newglossaryentry{firstusetext}{%
-name={First use text\ifirstusetext},
-sort={first use text},%
-text={first use text},%
-description={The text that is displayed on \gls{firstuse}, which is
-governed by the \gloskey{first} and \gloskey{firstplural} keys of
-\ics{newglossaryentry}. (May be overridden by
-\ics{glsdisp}.)\nopostdesc}%
-}
-
-\doxitem{Option}{option}{package options}
-\doxitem{Counter}{counter}{glossary counters}
-\doxitem{AbbrvStyle}{abbrvstyle}{abbreviation styles}
-\doxitem{Style}{style}{glossary styles}
+\CheckSum{69102}
+\RecordChanges
+\PageIndex
+\SetupDoc{reportchangedates}
\setcounter{IndexColumns}{2}
-\CheckSum{30886}
-
-\newcommand*{\ifirstuse}{\iterm{first use}}
-\newcommand*{\firstuse}{\gls{firstuse}}
-\newcommand*{\firstuseflag}{\gls{firstuseflag}}
-\newcommand*{\firstusetext}{\gls{firstusetext}}
-
-\newcommand*{\ifirstuseflag}{\iterm{first use>flag}}
-\newcommand*{\ifirstusetext}{\iterm{first use>text}}
-
-\newcommand*{\istkey}[1]{\appfmt{#1}\index{makeindex=\appfmt{makeindex}>#1=\texttt{#1}}}
-\newcommand*{\locfmt}[1]{\texttt{#1}\SpecialMainIndex{#1}}
-\newcommand*{\mkidxspch}{\index{makeindex=\appfmt{makeindex}>special characters}}
-
-\newcommand*{\igloskey}[2][newglossaryentry]{\icsopt{#1}{#2}}
-\newcommand*{\gloskey}[2][newglossaryentry]{\csopt{#1}{#2}}
-
-\newcommand*{\stylefmt}[1]{\textsf{#1}}
+\usepackage[T1]{fontenc}
+\usepackage{etoolbox}
+\usepackage{tcolorbox}
+\usepackage[colorlinks]{hyperref}
-\newcommand*{\glostyle}[1]{\stylefmt{#1}%
- \index{glossary styles:>#1=\protect\stylefmt{#1}|main}}
+\definecolor{defbackground}{rgb}{1,1,0.75}
-\newcommand*{\acrstyle}[1]{\stylefmt{#1}%
- \index{acronym styles (glossaries):>#1=\protect\stylefmt{#1}|main}}
+\newtcolorbox{definition}{halign=flush left,
+ colframe=black,colback=defbackground,
+ fontupper=\ttfamily,
+ before upper={\frenchspacing\obeylines},
+ after={\par\noindent\ignorespacesafterend}
+}
-\newcommand*{\abbrstyle}[1]{\stylefmt{#1}%
- \index{abbreviation styles:>#1=\protect\stylefmt{#1}|main}}
+\NewDocElement{Option}{option}
+\NewDocElement{AbbrvStyle}{abbrvstyle}
+\NewDocElement{Style}{style}
-\newcommand*{\category}[1]{\textsf{#1}\index{entry categories:>#1={\protect\sffamily#1}|main}}
+\pdfstringdefDisableCommands{%
+ \let\sty\@firstofone
+ \let\app\@firstofone
+ \let\ctr\@firstofone
+ \let\category\@firstofone
+ \let\catattr\@firstofone
+ \let\glostyle\@firstofone
+ \let\abbrstyle\@firstofone
+ \let\pkgoptfmt\@firstofone
+ \renewcommand{\marg}[1]{\string<#1\string>}%
+ \renewcommand{\oarg}[1]{\string[#1\string]}%
+}
-\newcommand*{\catattr}[1]{\textsf{#1}\index{category attributes:>#1={\protect\sffamily#1}|main}}
+\newcommand{\sty}[1]{\textsf{#1}}
+\newcommand{\app}[1]{\texttt{#1}}
+\newcommand{\ctr}[1]{\textsf{#1}}
+\newcommand{\env}[1]{\textsf{#1}}
+\newcommand{\category}[1]{\textsf{#1}}
+\newcommand{\catattr}[1]{\textsf{#1}}
+\newcommand{\glostyle}[1]{\textsf{#1}}
+\newcommand{\abbrstyle}[1]{\textsf{#1}}
+\newcommand{\pkgoptfmt}[1]{\textsf{#1}}
+\newcommand{\pkgopt}[2][]{\pkgoptfmt{#2\ifstrempty{#1}{}{=#1}}}
+\newcommand{\gloskey}[2][]{\textsf{#2}}
+\newcommand{\qt}[1]{``#1''}
+\newcommand{\sectionref}[1]{\S\ref{#1}}
+\newcommand{\dequals}{=}
-\GlossaryPrologue{%
- \chapter*{{Change History}}%
- \markboth{{Change History}}{{Change History}}%
- \phantomsection
- \addcontentsline{toc}{chapter}{Change History}%
- \raggedright
-}
+\providecommand\marg[1]{%
+ \allowbreak{\ttfamily\char`\{}\meta{#1}{\ttfamily\char`\}}}
+\providecommand\oarg[1]{%
+ \allowbreak{\ttfamily[}\meta{#1}{\ttfamily]}}
-\title{glossaries-extra.sty v1.48:
+\title{glossaries-extra.sty v1.49:
documented code}
\author{Nicola L.C. Talbot\\[10pt]
Dickimaw Books\\
\url{http://www.dickimaw-books.com/}}
-\date{2021-11-22}
+\date{2022-10-14}
\begin{document}
\DocInput{glossaries-extra.dtx}
\end{document}
%</driver>
%\fi
-%\MakeShortVerb{"}
-%\DeleteShortVerb{\|}
+%\maketitle
%
-% \maketitle
-%
-%\begin{abstract}
%This is the documented code for the \sty{glossaries-extra} package.
-%See glossaries-extra-manual.pdf for the user manual.
-%
-%\begin{important}
-%This package is experimental and not stable. It's provided for
-%testing purposes only. Future versions may not be compatible with
-%this version. Once it has stabilised I'll add it to CTAN, at which
-%point compatibility with the first stable version will be
-%maintained.
-%\end{important}
-%\end{abstract}
+%See \texttt{glossaries-extra-manual.pdf} for the user manual.
%
%\tableofcontents
%
-%\StopEventually{%
-% \printglossaries
-% \PrintChanges
-% \PrintIndex
-%}
-%
+%\StopEventually{\PrintChanges \PrintIndex}
%
%
-%\chapter{Main Package Code (\styfmt{glossaries-extra.sty})}
+%\section{Main Package Code (glossaries-extra.sty)}
%\iffalse
% \begin{macrocode}
%<*glossaries-extra.sty>
% \end{macrocode}
%\fi
%\changes{0.1}{2015-11-22}{Initial experimental release}
-%\section{Package Initialisation and Options}
+%\subsection{Package Initialisation and Options}
% \begin{macrocode}
\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{glossaries-extra}[2021/11/22 v1.48 (NLCT)]
+% \end{macrocode}
+% Rollback releases:
+% \begin{macrocode}
+\DeclareRelease{v1.48}{2021-11-22}{glossaries-extra-2021-11-22.sty}
+\DeclareCurrentRelease{v1.49}{2022-10-14}
+% \end{macrocode}
+% Declare package:
+% \begin{macrocode}
+\ProvidesPackage{glossaries-extra}[2022/10/14 v1.49 (NLCT)]
% \end{macrocode}
% Requires \sty{xkeyval} to define package options.
% \begin{macrocode}
@@ -243,21 +166,21 @@ Dickimaw Books\\
% \begin{macrocode}
\RequirePackage{etoolbox}
% \end{macrocode}
-% Has \styfmt{glossaries} already been loaded?
+% Has \sty{glossaries} already been loaded?
% \begin{macrocode}
\@ifpackageloaded{glossaries}
{%
% \end{macrocode}
% Already loaded so pass any options to \cs{setupglossaries}.
% This means that the options that can only be set when
-% \styfmt{glossaries} is loaded can't be used.
+% \sty{glossaries} is loaded can't be used.
% \begin{macrocode}
\newcommand{\glsxtr@dooption}[1]{\setupglossaries{#1}}%
\let\@glsxtr@declareoption\@gls@declareoption
}
{%
% \end{macrocode}
-% Not already loaded, so pass options to \styfmt{glossaries}.
+% Not already loaded, so pass options to \sty{glossaries}.
% \begin{macrocode}
\newcommand{\glsxtr@dooption}[1]{%
\PassOptionsToPackage{#1}{glossaries}%
@@ -293,7 +216,7 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%\begin{macro}{\glsxtr@warnonexistsordo}
-% If user wants \pkgopt[warn]{undefaction}, then \styfmt{glossaries}
+% If user wants \pkgopt[warn]{undefaction}, then \sty{glossaries}
% v4.19 is required.
% \begin{macrocode}
\newcommand*{\glsxtr@warnonexistsordo}[1]{}
@@ -664,6 +587,15 @@ Dickimaw Books\\
%\changes{1.19}{2017-09-09}{Use \cs{@glsrecordlocref} instead of \cs{@glslocref}}
% \begin{macrocode}
\newcommand*\@glsxtr@dorecord{%
+ \@@glsxtr@dorecord\@gls@label\glsxtr@record\@glsxtr@do@nameref@record
+}
+% \end{macrocode}
+%\end{macro}
+
+%\begin{macro}{\@@glsxtr@dorecord}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*\@@glsxtr@dorecord[3]{%
\global\let\@glsrecordlocref\theglsentrycounter
\let\@glsxtr@orgprefix\@glo@counterprefix
\ifx\theglsentrycounter\theHglsentrycounter
@@ -677,28 +609,26 @@ Dickimaw Books\\
\protected@edef\@glsxtr@theHentrycounter{\theHglsentrycounter}%
\@onelevel@sanitize\@glsxtr@theentrycounter
\@onelevel@sanitize\@glsxtr@theHentrycounter
- \protected@edef\@do@gls@getcounterprefix{\noexpand\@gls@getcounterprefix
+ \@xp@gls@getcounterprefix
{\@glsxtr@theentrycounter}{\@glsxtr@theHentrycounter}%
- }%
- \@do@gls@getcounterprefix
\fi
% \end{macrocode}
%\changes{1.30}{2018-04-25}{don't suppress expansion of \cs{@glsrecordlocref}}
%\changes{1.29}{2018-04-09}{don't suppress expansion of
%\cs{@glsrecordlocref} if counter isn't page}
%Don't protect the \cs{@glsrecordlocref} from premature expansion.
-%If the counter isn't \counter{page} then it needs expanding. If the
+%If the counter isn't \ctr{page} then it needs expanding. If the
%location includes \cs{thepage} then \cs{protected@write} will
%automatically deal with it.
%\changes{1.37}{2018-11-30}{added check for record=nameref}
% \begin{macrocode}
\ifx\@glsxtr@record@setting\@glsxtr@record@setting@nameref
- \@glsxtr@do@nameref@record
- {\@gls@label}{\@glo@counterprefix}{\@gls@counter}{\@glsnumberformat}%
+ #3%
+ {#1}{\@glo@counterprefix}{\@gls@counter}{\@glsnumberformat}%
{\@glsrecordlocref}%
\else
- \protected@write\@auxout{}{\string\glsxtr@record
- {\@gls@label}{\@glo@counterprefix}{\@gls@counter}{\@glsnumberformat}%
+ \@bibgls@write@aux{}{\string#2%
+ {#1}{\@glo@counterprefix}{\@gls@counter}{\@glsnumberformat}%
{\@glsrecordlocref}}%
\fi
\@glsxtr@counterrecordhook
@@ -723,21 +653,18 @@ Dickimaw Books\\
{\@gls@label}{}{\@gls@counter}{\@glsnumberformat}%
{\theglsentrycounter}%
\else
- \protected@write\@auxout{}{\string\glsxtr@record
+ \@bibgls@write@aux{}{\string\glsxtr@record
{\@gls@label}{}{\@gls@counter}{\@glsnumberformat}%
{\theglsentrycounter}}%
\fi
\else
- \edef\@do@gls@getcounterprefix{\noexpand\@gls@getcounterprefix
- {\theglsentrycounter}{\theHglsentrycounter}%
- }%
- \@do@gls@getcounterprefix
+ \@xp@gls@getcounterprefix{\theglsentrycounter}{\theHglsentrycounter}%
\ifx\@glsxtr@record@setting\@glsxtr@record@setting@nameref
\@glsxtr@do@nameref@record
{\@gls@label}{\@glo@counterprefix}{\@gls@counter}%
{\@glsnumberformat}{\theglsentrycounter}%
\else
- \protected@write\@auxout{}{\string\glsxtr@record
+ \@bibgls@write@aux{}{\string\glsxtr@record
{\@gls@label}{\@glo@counterprefix}{\@gls@counter}{\@glsnumberformat}%
{\theglsentrycounter}}%
\fi
@@ -790,7 +717,7 @@ Dickimaw Books\\
\newcommand*{\@glsxtr@do@nameref@record}[5]{%
\gls@ifnotmeasuring
{%
- \protected@write\@auxout{}{\string\glsxtr@record@nameref
+ \@bibgls@write@aux{}{\string\glsxtr@record@nameref
{#1}{#2}{#3}{#4}{#5}%
{\csuse{@currentlabelname}}{\csuse{@currentHref}}%
{\theHglsentrycounter}}%
@@ -837,7 +764,7 @@ Dickimaw Books\\
\@@glsxtrwrglossmark
\def\@gls@xref{#2}%
\@onelevel@sanitize\@gls@xref
- \protected@write\@auxout{}{\string\glsxtr@recordsee{#1}{\@gls@xref}}%
+ \@bibgls@write@aux{}{\string\glsxtr@recordsee{#1}{\@gls@xref}}%
}
% \end{macrocode}
%\end{macro}
@@ -1135,6 +1062,79 @@ Dickimaw Books\\
% \end{macrocode}
%\end{option}
%
+%
+%\begin{option}{bibglsaux}
+%\changes{1.49}{2022-10-14}{new}
+%Provide an option to put the records in a different aux file that
+%will only be read by bib2gls and not by \LaTeX. A large number of
+%records in the aux file can slow down the document build as \LaTeX\
+%has to parse it all. This will require an extra write register, so
+%may not be so desirable for documents with small glossaries but a
+%large number of temporary files.
+% \begin{macrocode}
+\define@key{glossaries-extra.sty}{bibglsaux}{%
+ \glsxtrsetbibglsaux{#1}%
+}
+% \end{macrocode}
+%\end{option}
+%
+%\begin{macro}{\glsxtrsetbibglsaux}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glsxtrsetbibglsaux}[1]{%
+ \renewcommand{\@glsxtr@setup@bibglsaux}{\@@glsxtr@setup@bibglsaux{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsxtr@setup@bibglsaux}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\@glsxtr@setup@bibglsaux}{%
+ \renewcommand{\glsxtrsetbibglsaux}[1]{%
+ \@@glsxtr@setup@bibglsaux{##1}%
+ }%
+}
+\AtBeginDocument{\@glsxtr@setup@bibglsaux}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@@glsxtr@setup@bibglsaux}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\@@glsxtr@setup@bibglsaux}[1]{%
+ \ifstrempty{#1}%
+ {\renewcommand{\@bibgls@write@aux}{\protected@write\@auxout}}%
+ {\@set@bibgls@write@aux{#1.aux}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@bibgls@write@aux}
+%\changes{1.49}{2022-10-14}{new}
+%Just used for writing records.
+% \begin{macrocode}
+\newcommand{\@bibgls@write@aux}{\protected@write\@auxout}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@set@bibgls@write@aux}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\@set@bibgls@write@aux}[1]{%
+ \protected@write\@auxout{}%
+ {\string\providecommand{\string\@bibgls@input}[1]{}}%
+ \protected@write\@auxout{}{\string\@bibgls@input{#1}}%
+ \global\newwrite\@bibgls@auxout
+ \openout\@bibgls@auxout=#1
+ \AtEndDocument{\closeout\@bibgls@auxout}%
+ \gdef\@bibgls@write@aux{\protected@write\@bibgls@auxout}%
+ \gdef\@set@bibgls@write@aux##1{\GlossariesExtraWarning{repeated
+ invocation of bibglsaux option ignored}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\changes{1.06}{2016-06-18}{docdef option changed to choice}
%Version 1.06 changes the \pkgopt{docdef} option to a choice rather
%than boolean setting. The available values are: false, true or
@@ -1221,7 +1221,7 @@ Dickimaw Books\\
% \begin{macrocode}
\@glsxtrindexcrossrefsfalse
% \end{macrocode}
-% But allow \gloskey{see} key to switch it on automatically.
+% But allow \gloskey{see} and \gloskey{seealso} keys to switch it on automatically.
%\begin{macro}{\@glsxtr@autoindexcrossrefs}
%\changes{1.0}{2016-01-24}{new}
% \begin{macrocode}
@@ -1414,7 +1414,7 @@ Dickimaw Books\\
\disable@keys{glossaries-extra.sty}{abbreviations}%
% \end{macrocode}
% If the \pkgopt{acronym} option hasn't been used, change
-% \ics{acronymtype} to \ics{glsxtrabbrvtype}.
+% \cs{acronymtype} to \cs{glsxtrabbrvtype}.
%\changes{0.4}{2015-12-03}{added redefinition of \cs{acronymtype}}
% \begin{macrocode}
\ifglsacronym
@@ -1434,37 +1434,95 @@ Dickimaw Books\\
% \end{macrocode}
%\end{option}
%
+%\begin{macro}{\shortcut@gls}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\shortcut@gls}{\cgls}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\shortcut@glspl}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\shortcut@glspl}{\cglspl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\shortcut@Gls}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\shortcut@Gls}{\cGls}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\shortcut@Glspl}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\shortcut@Glspl}{\cGlspl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\shortcut@GLS}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\shortcut@GLS}{\cGLS}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\shortcut@GLSpl}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\shortcut@GLSpl}{\cGLSpl}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GlsXtrDefineAbbreviationShortcuts}
% Enable shortcut commands for the abbreviations. Unlike the analogous
-% command provided by \styfmt{glossaries}, this uses \cs{newcommand}
+% command provided by \sty{glossaries}, this uses \cs{newcommand}
% instead of \cs{let} as a safety feature (except for \cs{newabbr}
% which is also provided with \cs{GlsXtrDefineAcShortcuts}).
% \begin{macrocode}
\newcommand*{\GlsXtrDefineAbbreviationShortcuts}{%
- \newcommand*{\ab}{\cgls}%
- \newcommand*{\abp}{\cglspl}%
+ \newcommand*{\ab}{\shortcut@gls}%
+ \newcommand*{\abp}{\shortcut@glspl}%
\newcommand*{\as}{\glsxtrshort}%
\newcommand*{\asp}{\glsxtrshortpl}%
\newcommand*{\al}{\glsxtrlong}%
\newcommand*{\alp}{\glsxtrlongpl}%
\newcommand*{\af}{\glsxtrfull}%
\newcommand*{\afp}{\glsxtrfullpl}%
- \newcommand*{\Ab}{\cGls}%
- \newcommand*{\Abp}{\cGlspl}%
+ \newcommand*{\Ab}{\shortcut@Gls}%
+ \newcommand*{\Abp}{\shortcut@Glspl}%
\newcommand*{\As}{\Glsxtrshort}%
\newcommand*{\Asp}{\Glsxtrshortpl}%
\newcommand*{\Al}{\Glsxtrlong}%
\newcommand*{\Alp}{\Glsxtrlongpl}%
\newcommand*{\Af}{\Glsxtrfull}%
\newcommand*{\Afp}{\Glsxtrfullpl}%
- \newcommand*{\AB}{\cGLS}%
- \newcommand*{\ABP}{\cGLSpl}%
+ \newcommand*{\AB}{\shortcut@GLS}%
+ \newcommand*{\ABP}{\shortcut@GLSpl}%
\newcommand*{\AS}{\GLSxtrshort}%
\newcommand*{\ASP}{\GLSxtrshortpl}%
\newcommand*{\AL}{\GLSxtrlong}%
\newcommand*{\ALP}{\GLSxtrlongpl}%
\newcommand*{\AF}{\GLSxtrfull}%
\newcommand*{\AFP}{\GLSxtrfullpl}%
+ \glsmfuaddmap{\ab}{\Ab}%
+ \glsmfublocker{\AB}%
+ \glsmfuaddmap{\abp}{\Abp}%
+ \glsmfublocker{\ABP}%
+ \glsmfuaddmap{\as}{\As}%
+ \glsmfublocker{\AS}%
+ \glsmfuaddmap{\asp}{\Asp}%
+ \glsmfublocker{\ASP}%
+ \glsmfuaddmap{\al}{\Al}%
+ \glsmfublocker{\AL}%
+ \glsmfuaddmap{\alp}{\Alp}%
+ \glsmfublocker{\ALP}%
+ \glsmfuaddmap{\af}{\Af}%
+ \glsmfublocker{\AF}%
+ \glsmfuaddmap{\afp}{\Afp}%
+ \glsmfublocker{\AFP}%
% \end{macrocode}
%\changes{1.23}{2017-11-12}{changed \cs{newabbr} definition to use \cs{providecommand}}
% \begin{macrocode}
@@ -1479,34 +1537,50 @@ Dickimaw Books\\
%
%\begin{macro}{\GlsXtrDefineAcShortcuts}
% Enable shortcut commands for the abbreviations, but uses the
-% analogous commands provided by \styfmt{glossaries}.
+% analogous commands provided by \sty{glossaries}.
%\changes{1.17}{2017-08-09}{new}
% \begin{macrocode}
\newcommand*{\GlsXtrDefineAcShortcuts}{%
- \newcommand*{\ac}{\cgls}%
- \newcommand*{\acp}{\cglspl}%
+ \newcommand*{\ac}{\shortcut@gls}%
+ \newcommand*{\acp}{\shortcut@glspl}%
\newcommand*{\acs}{\glsxtrshort}%
\newcommand*{\acsp}{\glsxtrshortpl}%
\newcommand*{\acl}{\glsxtrlong}%
\newcommand*{\aclp}{\glsxtrlongpl}%
\newcommand*{\acf}{\glsxtrfull}%
\newcommand*{\acfp}{\glsxtrfullpl}%
- \newcommand*{\Ac}{\cGls}%
- \newcommand*{\Acp}{\cGlspl}%
+ \newcommand*{\Ac}{\shortcut@Gls}%
+ \newcommand*{\Acp}{\shortcut@Glspl}%
\newcommand*{\Acs}{\Glsxtrshort}%
\newcommand*{\Acsp}{\Glsxtrshortpl}%
\newcommand*{\Acl}{\Glsxtrlong}%
\newcommand*{\Aclp}{\Glsxtrlongpl}%
\newcommand*{\Acf}{\Glsxtrfull}%
\newcommand*{\Acfp}{\Glsxtrfullpl}%
- \newcommand*{\AC}{\cGLS}%
- \newcommand*{\ACP}{\cGLSpl}%
+ \newcommand*{\AC}{\shortcut@GLS}%
+ \newcommand*{\ACP}{\shortcut@GLSpl}%
\newcommand*{\ACS}{\GLSxtrshort}%
\newcommand*{\ACSP}{\GLSxtrshortpl}%
\newcommand*{\ACL}{\GLSxtrlong}%
\newcommand*{\ACLP}{\GLSxtrlongpl}%
\newcommand*{\ACF}{\GLSxtrfull}%
\newcommand*{\ACFP}{\GLSxtrfullpl}%
+ \glsmfuaddmap{\ac}{\Ac}%
+ \glsmfublocker{\AC}%
+ \glsmfuaddmap{\acp}{\Acp}%
+ \glsmfublocker{\ACP}%
+ \glsmfuaddmap{\acs}{\Acs}%
+ \glsmfublocker{\ACS}%
+ \glsmfuaddmap{\acsp}{\Acsp}%
+ \glsmfublocker{\ACSP}%
+ \glsmfuaddmap{\acl}{\Acl}%
+ \glsmfublocker{\ACL}%
+ \glsmfuaddmap{\aclp}{\Aclp}%
+ \glsmfublocker{\ACLP}%
+ \glsmfuaddmap{\acf}{\Acf}%
+ \glsmfublocker{\ACF}%
+ \glsmfuaddmap{\acfp}{\Acfp}%
+ \glsmfublocker{\ACFP}%
% \end{macrocode}
%\changes{1.23}{2017-11-12}{changed \cs{newabbr} definition to use \cs{providecommand}}
% \begin{macrocode}
@@ -1558,7 +1632,7 @@ Dickimaw Books\\
%\end{macro}
%
%\begin{option}{shortcuts}
-%Provide \pkgopt{shortcuts} option. Unlike the \styfmt{glossaries}
+%Provide \pkgopt{shortcuts} option. Unlike the \sty{glossaries}
%version, this is a choice rather than a boolean key but it also provides
%\pkgopt[true]{shortcuts} and \pkgopt[false]{shortcuts}, which are
%equivalent to \pkgopt[all]{shortcuts} and
@@ -1570,7 +1644,7 @@ Dickimaw Books\\
% \begin{macrocode}
\define@choicekey{glossaries-extra.sty}{shortcuts}%
[\@glsxtr@shortcutsval\@glsxtr@shortcutsnr]%
- {acronyms,acro,abbreviations,abbr,other,all,true,ac,none,false}[true]{%
+ {acronyms,acro,abbreviations,abbr,other,all,true,ac,acother,abother,none,false}[true]{%
\ifcase\@glsxtr@shortcutsnr\relax % acronyms
\renewcommand*{\@glsxtr@setupshortcuts}{%
\glsacrshortcutstrue
@@ -1623,6 +1697,24 @@ Dickimaw Books\\
\glsacrshortcutstrue
\GlsXtrDefineAcShortcuts
}%
+ \or % acother
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added shortcuts=acother}
+% \begin{macrocode}
+ \renewcommand*{\@glsxtr@setupshortcuts}{%
+ \glsacrshortcutstrue
+ \GlsXtrDefineAcShortcuts
+ \GlsXtrDefineOtherShortcuts
+ }%
+ \or % abother
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added shortcuts=abother}
+% \begin{macrocode}
+ \renewcommand*{\@glsxtr@setupshortcuts}{%
+ \glsacrshortcutstrue
+ \GlsXtrDefineAbbreviationShortcuts
+ \GlsXtrDefineOtherShortcuts
+ }%
% \end{macrocode}
%Leave none and false as last option.
% \begin{macrocode}
@@ -1641,7 +1733,7 @@ Dickimaw Books\\
%\end{macro}
%
%\sty{glossaries-accsupp} can't be loaded after
-%\styfmt{glossaries-extra}. \sty{glossaries-accsupp} v4.29+ checks
+%\sty{glossaries-extra}. \sty{glossaries-accsupp} v4.29+ checks
%\cs{@glsxtr@doaccsupp} to determine if it's been loaded too late.
%
%\begin{option}{accsupp}
@@ -1794,7 +1886,7 @@ Dickimaw Books\\
%\begin{macro}{\GlsXtrInternalLocationHyperlink}
%\changes{1.29}{2018-04-09}{new}
%\begin{definition}
-%\cs{glsxtrinternallocationhyperlink}\marg{counter}\marg{prefix}\marg{location}
+%\cs{GlsXtrInternalLocationHyperlink}\marg{counter}\marg{prefix}\marg{location}
%\end{definition}
%The first two arguments are always control sequences.
% \begin{macrocode}
@@ -1821,7 +1913,7 @@ Dickimaw Books\\
%methods but it will interfere with the number list collation.
%This option automatically implements \pkgopt[wrglossary]{counter}.
%
-%Since \styfmt{glossaries} automatically loads \sty{amsmath}, there
+%Since \sty{glossaries} automatically loads \sty{amsmath}, there
%may be a problem if the indexing occurs in the \env{equation}
%environment, because only one \cs{label} is allowed in each
%instance of that environment. It's best to change the counter when
@@ -1838,12 +1930,13 @@ Dickimaw Books\\
\renewcommand*{\glsxtr@inc@wrglossaryctr}[1]{%
% \end{macrocode}
%Only increment if the current counter is \ctr{wrglossary}.
-%\changes{1.30}{2018-04-25}{added check for \ctrfmt{wrglossary} counter}
+%\changes{1.30}{2018-04-25}{added check for \ctr{wrglossary} counter}
% \begin{macrocode}
\ifdefstring\@gls@counter{wrglossary}%
{%
\refstepcounter{wrglossary}%
\label{wrglossary.\thewrglossary}%
+ \@@glsxtrwrglosscountermark{\thewrglossary}%
}%
{}%
}%
@@ -1879,12 +1972,35 @@ Dickimaw Books\\
%
%\begin{macro}{\glsxtrwrglossmark}
%\changes{1.21}{2017-11-03}{new}
-%Does nothing by default.
% \begin{macrocode}
\newcommand*{\glsxtrwrglossmark}{\ensuremath{\cdot}}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\@glsxtrwrglosscountermark}
+%\changes{1.49}{2022-10-14}{new}
+%Marks the place where wrglossary counter is incremented.
+%Does nothing by default.
+% \begin{macrocode}
+\newcommand*{\@glsxtrwrglosscountermark}[1]{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@@glsxtrwrglosscountermark}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@@glsxtrwrglosscountermark}[1]{}
+\AtBeginDocument{\renewcommand*{\@@glsxtrwrglosscountermark}{\@glsxtrwrglosscountermark}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrwrglosscountermark}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrwrglosscountermark}[1]{\glsshowtargetfonttext{[#1]}}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\@glsxtr@doshowtarget}
%\changes{1.48}{2021-11-22}{new}
% \begin{macrocode}
@@ -1892,6 +2008,24 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtrundefdebug}
+%\changes{1.49}{2022-10-14}{new}
+%Don't do anything until after the document environment has begun.
+% \begin{macrocode}
+\newcommand*{\glsxtrundefdebug}[1]{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsxtrundefdebug}
+%\changes{1.49}{2022-10-14}{new}
+%Use the same font as the targets.
+% \begin{macrocode}
+\newcommand*{\@glsxtrundefdebug}[1]{%
+ \if@gls@debug \glsshowtargetfonttext{[#1]}\fi
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{option}{debug}
%\changes{1.21}{2017-11-03}{new}
% Provide extra debug options.
@@ -1903,20 +2037,26 @@ Dickimaw Books\\
\ifcase\@glsxtr@debugnr\relax % true
\glsxtr@dooption{debug=true}%
\renewcommand*{\@glsxtrwrglossmark}{}%
+ \renewcommand*{\@glsxtrwrglosscountermark}[1]{}%
\or % false
\glsxtr@dooption{debug=false}%
\renewcommand*{\@glsxtrwrglossmark}{}%
- \let\@glsxtr@doshowtarget\@secondoftwo
+ \renewcommand*{\@glsxtrwrglosscountermark}[1]{}%
+ \let\@glsxtr@doshowtarget\@secondoftwo
\or % showtargets
\glsxtr@dooption{debug=showtargets}%
- \def\@glsxtr@doshowtarget{\@glsxtrshowtargetleft}%
+ \def\@glsxtr@doshowtarget{\@glsxtrshowtargetleft}%
\or % showwrgloss
\glsxtr@dooption{debug=true}%
\renewcommand*{\@glsxtrwrglossmark}{\glsxtrwrglossmark}%
+ \renewcommand*{\@glsxtrwrglosscountermark}{\glsxtrwrglosscountermark}%
\or % all
- \glsxtr@dooption{debug=showtargets,debug=showaccsupp}%
+ \glsxtr@dooption{debug=true,debug=showaccsupp}%
+ % debug=showwrgloss:
\renewcommand*{\@glsxtrwrglossmark}{\glsxtrwrglossmark}%
- \def\@glsxtr@doshowtarget{\@glsxtrshowtargetleft}%
+ \renewcommand*{\@glsxtrwrglosscountermark}{\glsxtrwrglosscountermark}%
+ % debug=showtargets:
+ \def\@glsxtr@doshowtarget{\@glsxtrshowtargetleft}%
\or % showaccsupp
\glsxtr@dooption{debug=showaccsupp}%
\fi
@@ -2005,18 +2145,35 @@ Dickimaw Books\\
% \end{macrocode}
%\end{option}
%
-% Pass all other options to \styfmt{glossaries}.
+% Pass all other options to \sty{glossaries}.
+%\begin{macro}{\glsxtr@processunknownoptions}
+%\changes{1.49}{2022-10-14}{new}
+% Need to compensate for the problem identified in
+%\url{https://www.dickimaw-books.com/bugtracker.php?key=171}
% \begin{macrocode}
-\DeclareOptionX*{%
- \expandafter\glsxtr@dooption\expandafter{\CurrentOption}}
+\newcommand*{\glsxtr@processunknownoptions}{}
+% \end{macrocode}
+%\end{macro}
+% \begin{macrocode}
+\@ifpackageloaded{glossaries}
+{%
+ \DeclareOptionX*{%
+ \edef\glsxtr@processunknownoptions{%
+ \noexpand\setupglossaries{\expandonce\CurrentOption}}}
+}
+{%
+ \DeclareOptionX*{%
+ \expandafter\glsxtr@dooption\expandafter{\CurrentOption}}
+}
% \end{macrocode}
% Process options.
% \begin{macrocode}
\ProcessOptionsX
% \end{macrocode}
-% Load \styfmt{glossaries} if not already loaded.
+% Load \sty{glossaries} if not already loaded.
% \begin{macrocode}
\RequirePackage{glossaries}
+\glsxtr@processunknownoptions
% \end{macrocode}
% Load the \sty{glossaries-accsupp} package if required.
% \begin{macrocode}
@@ -2031,6 +2188,183 @@ Dickimaw Books\\
\@glsxtr@defpostpunc
% \end{macrocode}
%
+%\begin{macro}{\glsindexsetting}
+%\changes{1.49}{2022-10-14}{new}
+%This command was new to \sty{glossaries} v4.50 so may not be
+%defined. Note that \pkgopt[only]{record} and
+%\pkgopt[nameref]{record} implement \pkgopt[none]{sort}, which will
+%change the default definition of \cs{glsindexingsetting}.
+% \begin{macrocode}
+\let\@glsxtr@org@indexingsetting\glsindexingsetting
+\providecommand{\glsindexingsetting}{\ifglsxindy xindy\else makeindex\fi}
+\ifx\@glsxtr@org@indexingsetting\glsindexingsetting
+ \renewcommand{\glsindexingsetting}{%
+ \@glsxtr@if@record@only{bib2gls}{\ifglsxindy xindy\else makeindex\fi}%
+ }
+\else
+ \@glsxtr@if@record@only{\renewcommand{\glsindexingsetting}{bib2gls}}{}%
+\fi
+% \end{macrocode}
+%\end{macro}
+%
+%
+%The following commands are new to \sty{glossaries} v4.50, so
+%provide them if an older version is present.
+%\begin{macro}{\glssentencecase}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\providecommand{\glssentencecase}[1]{\makefirstuc{#1}}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\glslowercase}
+%\changes{1.49}{2022-10-14}{new}
+%This uses \cs{MakeTextLowercase} because if \cs{glslowercase} isn't
+%defined then \sty{textcase} has been loaded and we might have an
+%older kernel.
+% \begin{macrocode}
+\providecommand{\glslowercase}[1]{\MakeTextLowercase{#1}}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\glsuppercase}
+%\changes{1.49}{2022-10-14}{new}
+%Not using \cs{unexpanded} because ditto the above.
+% \begin{macrocode}
+\providecommand{\glsuppercase}[1]{\mfirstucMakeUppercase{#1}}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\@Glsentryfield}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\providecommand{\@Glsentryfield}[2]{%
+ \glstexorpdfstring{\@Gls@entry@field{#1}{#2}}%
+ {\MFUsentencecase{\@gls@entry@field{#1}{#2}}}%
+}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\glstexorpdfstring}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\ifdef\glstexorpdfstring
+{}
+{
+ \ifdef\texorpdfstring
+ {\newcommand{\glstexorpdfstring}{\texorpdfstring}}
+ {\newcommand{\glstexorpdfstring}[2]{#1}}
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsxtr@org@MakeUppercase}
+%Save the original definition of \cs{MakeUppercase} in case it needs
+%to be restored.
+% \begin{macrocode}
+\let\@glsxtr@org@MakeUppercase\MakeUppercase
+% \end{macrocode}
+%\end{macro}
+%
+%If \sty{mfirstuc} v2.08+ is installed, provide interface commands.
+%The simplest method is to test the existence of
+%\cs{MFUsentencecase}, which is provided by \sty{mfirstuc} v2.08+
+%but also by \sty{glossaries} v4.50+. So it may be defined because
+%\sty{glossaries} v4.50+ is installed, in which case \cs{glsmfuexcl}
+%etc are also defined, but it may be defined because \sty{mfirstuc}
+%v2.08+ is installed but an older version of \sty{glossaries} may be
+%present, in which case \cs{glsmfuexcl} etc won't be defined.
+% \begin{macrocode}
+\ExplSyntaxOn
+\ifdef\MFUsentencecase
+{%
+% \end{macrocode}
+% Automatically identify exclusions, blockers and mappings.
+%\begin{macro}{\glsmfuexcl}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \providecommand{\glsmfuexcl}[1]{\MFUexcl{#1}}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\glsmfublocker}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \providecommand{\glsmfublocker}[1]{\MFUblocker{#1}}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\glsmfuaddmap}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \providecommand{\glsmfuaddmap}[2]{\MFUaddmap{#1}{#2}}
+% \end{macrocode}
+%\end{macro}
+%Don't alter \cs{MakeUppercase}
+%\begin{macro}{\@glsxtr@saveMakeUppercase}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand{\@glsxtr@saveMakeUppercase}{}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\@glsxtr@restoreMakeUppercase}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand{\@glsxtr@restoreMakeUppercase}{}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\@glsxtr@assignMakeUppercase}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand{\@glsxtr@assignMakeUppercase}{}
+% \end{macrocode}
+%\end{macro}
+% \begin{macrocode}
+}
+{
+% \end{macrocode}
+%Provide \cs{MFUsentencecase} for use where expandable contexts are
+%required.
+%\begin{macro}{\MFUsentencecase}
+% \begin{macrocode}
+ \providecommand{\MFUsentencecase}[1]{\text_titlecase_first:n{#1}}
+% \end{macrocode}
+%\end{macro}
+%Provide support for exclusions with \cs{MFUsentencecase}.
+%\begin{macro}{\glsmfuexcl}
+% \begin{macrocode}
+ \providecommand{\glsmfuexcl}[1]{
+ \tl_if_in:NnF \l_text_case_exclude_arg_tl {#1}
+ {
+ \tl_put_right:Nn \l_text_case_exclude_arg_tl {#1}
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%Just treat blockers and mappings as exclusions.
+%\begin{macro}{\glsmfublocker}
+% \begin{macrocode}
+ \providecommand{\glsmfublocker}[1]{\glsmfuexcl{#1}}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\glsmfuaddmap}
+% \begin{macrocode}
+ \providecommand{\glsmfuaddmap}[2]{\glsmfuexcl{#1}\glsmfublocker{#2}}
+% \end{macrocode}
+%\end{macro}
+%With old versions of \sty{mfirstuc}, save and restore
+%\cs{MakeUppercase} in the heading hooks.
+% \begin{macrocode}
+ \newcommand{\@glsxtr@saveMakeUppercase}{%
+ \let\@glsxtr@org@MakeUppercase\MakeUppercase
+ }
+ \newcommand{\@glsxtr@restoreMakeUppercase}{%
+ \let\MakeUppercase\@glsxtr@org@MakeUppercase
+ }
+ \newcommand{\@glsxtr@assignMakeUppercase}{%
+ \let\MakeUppercase\MakeTextUppercase
+ }
+}
+% \end{macrocode}
+%Finished \LaTeX3 code.
+% \begin{macrocode}
+\ExplSyntaxOff
+% \end{macrocode}
+%
%\begin{macro}{\glsdoshowtarget}
%\changes{1.48}{2021-11-22}{new}
%Added to \sty{glossaries} v4.50 so many not be defined.
@@ -2042,23 +2376,30 @@ Dickimaw Books\\
%
%\begin{macro}{\glsxtrshowtargetsymbolright}
%\changes{1.48}{2021-11-22}{new}
+%\changes{1.49}{2022-10-14}{added check for math mode}
% \begin{macrocode}
-\newcommand{\glsxtrshowtargetsymbolright}{{\tiny$\triangleleft$}}%
+\newcommand{\glsxtrshowtargetsymbolright}{%
+ \ifmmode \mbox{\tiny$\triangleleft$}\else {\tiny$\triangleleft$}\fi
+}
% \end{macrocode}
%\end{macro}
%
%\begin{macro}{\glsxtrshowtargetsymbolleft}
%\changes{1.48}{2021-11-22}{new}
+%\changes{1.49}{2022-10-14}{added check for math mode}
% \begin{macrocode}
-\newcommand{\glsxtrshowtargetsymbolleft}{{\tiny$\triangleright$}}%
+\newcommand{\glsxtrshowtargetsymbolleft}{%
+ \ifmmode \mbox{\tiny$\triangleright$}\else {\tiny$\triangleright$}\fi
+}
% \end{macrocode}
%\end{macro}
%
%\begin{macro}{\glsshowtargetinner}
%\changes{1.48}{2021-11-22}{new}
+%\changes{1.49}{2022-10-14}{added check for math mode}
%Only added to \sty{glossaries} in v4.50 so may not be defined.
% \begin{macrocode}
-\providecommand*{\glsshowtargetinner}[1]{{\glsshowtargetfont [#1]}}
+\providecommand*{\glsshowtargetinner}[1]{\glsshowtargetfonttext{[#1]}}
% \end{macrocode}
%\end{macro}
%
@@ -2070,7 +2411,18 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
-%\begin{macro}{\glsshowtargetinnercontentsymleft}
+%\begin{macro}{\glsshowtargetfonttext}
+%\changes{1.49}{2022-10-14}{new}
+%Text-block command that checks for math-mode.
+%Only added to \sty{glossaries} in v4.50 so may not be defined.
+% \begin{macrocode}
+\providecommand*{\glsshowtargetfonttext}[1]{%
+ \ifmmode \nfss@text{\glsshowtargetfont #1}\else {\glsshowtargetfont #1}\fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsshowtargetinnersymleft}
%\changes{1.48}{2021-11-22}{new}
% \begin{macrocode}
\newcommand*{\glsshowtargetinnersymleft}[1]{%
@@ -2078,7 +2430,7 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
-%\begin{macro}{\glsshowtargetinnercontentsymright}
+%\begin{macro}{\glsshowtargetinnersymright}
%\changes{1.48}{2021-11-22}{new}
% \begin{macrocode}
\newcommand*{\glsshowtargetinnersymright}[1]{%
@@ -2309,6 +2661,31 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\@xp@gls@getcounterprefix}
+%This command is provided by \sty{glossaries} v4.50 so may not be
+%defined. Provide a similar command in case the new version hasn't
+%been installed.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\providecommand*\@xp@gls@getcounterprefix[2]{%
+ \bgroup
+ \glswrglossdisableanchorcmds
+ \protected@edef\@do@gls@getcounterprefix{%
+ \noexpand\egroup
+ \noexpand\@gls@getcounterprefix{#1}{#2}%
+ }%
+ \@do@gls@getcounterprefix
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glswrglossdisableanchorcmds}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\providecommand{\glswrglossdisableanchorcmds}{\let\glstexorpdfstring\@secondoftwo}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\@gls@getcounterprefix}
%\changes{1.37}{2018-11-30}{new}
%This command is provided by the base \sty{glossaries} package, but
@@ -2319,9 +2696,14 @@ Dickimaw Books\\
%Unfortunately, not all targets are in this form, so the links fail.
%With \pkgopt[nameref]{record}, the complete target name can be
%saved, so this modification adjusts the warning.
+%
+%The expansion should now be performed in
+%\cs{@xp@gls@getcounterprefix}. Any commands that were using
+%\cs{@gls@getcounterprefix} directly need to be use
+%\cs{@xp@gls@getcounterprefix} instead.
% \begin{macrocode}
\renewcommand*\@gls@getcounterprefix[2]{%
- \protected@edef\@gls@thisloc{#1}\protected@edef\@gls@thisHloc{#2}%
+ \def\@gls@thisloc{#1}\def\@gls@thisHloc{#2}%
\ifx\@gls@thisloc\@gls@thisHloc
\def\@glo@counterprefix{}%
\else
@@ -2376,11 +2758,12 @@ Dickimaw Books\\
% \begin{macrocode}
\AtBeginDocument{%
\disable@keys{glossaries-extra.sty}{abbreviations,docdef,record}%
+ \def\glsxtrundefdebug{\@glsxtrundefdebug}%
\def\@glsxtrundeftag{\glsxtrundeftag}%
}
% \end{macrocode}
%
-%\section{Extra Utilities}
+%\subsection{Extra Utilities}
%
%\begin{macro}{\GlsXtrIfUnusedOrUndefined}
%\changes{1.34}{2018-07-29}{new}
@@ -2399,7 +2782,7 @@ Dickimaw Books\\
%\end{macro}
%
%Starred form of \cs{ifglossaryexists} was only introduced to
-%\styfmt{glossaries} v4.46 so provide it if it hasn't been defined.
+%\sty{glossaries} v4.46 so provide it if it hasn't been defined.
% \begin{macrocode}
\ifdef\s@ifglossaryexists
{}
@@ -2438,7 +2821,7 @@ Dickimaw Books\\
% Provide command to determine if any entries have been added to the
% glossary (where the glossary label is provided in the first
% argument). The entries are stored in the comma-separated list
-% \cs{glolist@\meta{type}}. If this hasn't been defined, the glosary
+% \cs{glolist@\meta{type}}. If this hasn't been defined, the glossary
% doesn't exist. If it has been defined and is simply a comma, the
% glossary exists and is empty. (It's initialised to a comma.)
%\changes{0.4}{2015-12-03}{new}
@@ -2456,6 +2839,32 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\GlsXtrIfInGlossary}
+%\begin{definition}
+%\cs{GlsXtrIfInGlossary}\marg{label}\marg{type}\marg{true}\marg{false}
+%\end{definition}
+%\changes{1.49}{?}{new}
+%Test if the given entry is in the given glossary list. This may not
+%correspond to the \gloskey{type} key as the entry may have been
+%copied to the list. Does \meta{false} and issues warning if the glossary doesn't
+%exist.
+% \begin{macrocode}
+\newcommand*{\GlsXtrIfInGlossary}[4]{%
+ \ifcsdef{glolist@#2}%
+ {%
+ \protected@edef\@glsxtr@tmp{#1}%
+ \letcs\@glsxtr@tmplist{glolist@#2}%
+ \expandafter\DTLifinlist\expandafter{\@glsxtr@tmp}{\@glsxtr@tmplist}%
+ {#3}{#4}%
+ }%
+ {%
+ \glsxtrundefaction{Glossary type `#1' doesn't exist}{}%
+ #4%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsxtrifkeydefined}
%\changes{1.12}{2017-02-03}{new}
%Tests if the key given in the first argument has been defined.
@@ -2557,6 +2966,9 @@ Dickimaw Books\\
%
%\begin{macro}{\glsxtrfmt}
%\changes{1.12}{2017-02-03}{new}
+%\begin{definition}
+%\cs{glsxtrfmt}\oarg{options}\marg{entry-label}\marg{text}\oarg{insert}
+%\end{definition}
%The post-link hook isn't done. This now has a starred form
%that checks for a final optional argument.
% \begin{macrocode}
@@ -2628,6 +3040,37 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsxtrfmt}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{Glsxtrfmt}\oarg{options}\marg{entry-label}\marg{text}\oarg{insert}
+%\end{definition}
+%As \cs{glsxtrfmt} but applies a sentence-case change to
+%\meta{text}. This is provided to allow a mapping with
+%\sty{mfirstuc} v2.08+ in the event that an automated case-change is
+%required.
+% \begin{macrocode}
+\newrobustcmd*{\Glsxtrfmt}{\@ifstar\s@Glsxtrfmt\@Glsxtrfmt}
+\glsmfuaddmap{\glsxtrfmt}{\Glsxtrfmt}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\@Glsxtrfmt}
+%\changes{1.49}{2022-10-14}{new}
+%Unstarred form.
+% \begin{macrocode}
+\newcommand*{\@Glsxtrfmt}[3][]{\@@glsxtrfmt{#1}{#2}{\glssentencecase{#3}}{}}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\s@Glsxtrfmt}
+%\changes{1.49}{2022-10-14}{new}
+%Starred form.
+% \begin{macrocode}
+\newcommand*{\s@Glsxtrfmt}[3][]{%
+ \new@ifnextchar[{\s@@glsxtrfmt{#1}{#2}{\glssentencecase{#3}}}%
+ {\@@glsxtrfmt{#1}{#2}{\glssentencecase{#3}}{}}%
+}
+% \end{macrocode}
+%\end{macro}
%\begin{macro}{\glsxtrfmtdisplay}
%\changes{1.23}{2017-11-12}{new}
%The command used internally by \cs{glsxtrfmt} to do the actual
@@ -2643,21 +3086,15 @@ Dickimaw Books\\
%\changes{1.12}{2017-02-03}{new}
%No link or indexing.
% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\glsxtrentryfmt}[2]{%
- \texorpdfstring{\@glsxtrentryfmt{#1}{#2}}{\glsxtrpdfentryfmt{#1}{#2}}%
- }
-}
-{
- \newcommand*{\glsxtrentryfmt}{\@glsxtrentryfmt}
+\newcommand*{\glsxtrentryfmt}[2]{%
+ \glstexorpdfstring{\@glsxtrentryfmt{#1}{#2}}{\glsxtrpdfentryfmt{#1}{#2}}%
}
% \end{macrocode}
%\end{macro}
%
%\begin{macro}{\glsxtrpdfentryfmt}
%\changes{1.42}{2020-02-03}{new}
-%Use for the PDF bookmarks.
+%Used for the PDF bookmarks.
% \begin{macrocode}
\newcommand*{\glsxtrpdfentryfmt}[2]{#2}
% \end{macrocode}
@@ -2692,6 +3129,27 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsxtrentryfmt}
+%\changes{1.49}{2022-10-14}{new}
+%Sentence-case version.
+% \begin{macrocode}
+\newcommand*{\Glsxtrentryfmt}[2]{%
+ \glstexorpdfstring
+ {\@glsxtrentryfmt{#1}{\glssentencecase{#2}}}%
+ {\Glsxtrpdfentryfmt{#1}{#2}}%
+}
+\glsmfuaddmap{\glsxtrentryfmt}{\Glsxtrentryfmt}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrpdfentryfmt}
+%\changes{1.49}{2022-10-14}{new}
+%Used for the PDF bookmarks.
+% \begin{macrocode}
+\newcommand*{\Glsxtrpdfentryfmt}[2]{\MFUsentencecase{#2}}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsxtrfieldlistadd}
%\changes{1.12}{2017-02-03}{new}
%If a field stores an etoolbox internal list (e.g.
@@ -2807,7 +3265,7 @@ Dickimaw Books\\
%\end{macro}
%
%\begin{macro}{\@glsxtrforcsvfield}
-%\changes{1.47}{2017-11-14}{new}
+%\changes{1.47}{2021-11-04}{new}
%Unstarred version.
% \begin{macrocode}
\newcommand*{\@glsxtrforcsvfield}[3]{%
@@ -2822,7 +3280,7 @@ Dickimaw Books\\
%\end{macro}
%
%\begin{macro}{\s@glsxtrforcsvfield}
-%\changes{1.47}{2017-11-14}{new}
+%\changes{1.47}{2021-11-04}{new}
%Starred version.
% \begin{macrocode}
\newcommand*{\s@glsxtrforcsvfield}[3]{%
@@ -3158,41 +3616,29 @@ Dickimaw Books\\
%\changes{1.12}{2017-02-03}{new}
%\changes{1.37}{2018-11-30}{fixed internal command and added check for
%\cs{texorpdfstring}}
+%\changes{1.49}{2022-10-14}{now using \cs{@Glsentryfield}}
%Provide a user-level alternative to \cs{@Gls@entry@field}.
+%Now uses \cs{MFUsentencecase} in PDF bookmarks.
% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\Glsxtrusefield}[2]{%
- \texorpdfstring
- {\@Gls@entry@field{#1}{#2}}
- {\@gls@entry@field{#1}{#2}}%
- }
-}
-{
- \newcommand*{\Glsxtrusefield}[2]{%
- \@Gls@entry@field{#1}{#2}%
- }
+\newcommand*{\Glsxtrusefield}[2]{%
+ \@Glsentryfield{#1}{#2}%
}
+\glsmfuaddmap{\glsxtrusefield}{\Glsxtrusefield}
% \end{macrocode}
%\end{macro}
%
%\begin{macro}{\GLSxtrusefield}
%\changes{1.37}{2018-11-30}{new}
+%\changes{1.49}{2022-10-14}{added uppercase PDF bookmark alternative}
%As above but convert to all caps.
+%Note that with \sty{mfirstuc} v2.08+, \cs{mfirstucMakeUppercase}
+%is expandable, so therefore \cs{glsuppercase} should also be
+%expandable.
% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\GLSxtrusefield}[2]{%
- \texorpdfstring
- {\glsdoifexists{#1}{\mfirstucMakeUppercase{\@gls@entry@field{#1}{#2}}}}%
- {\@gls@entry@field{#1}{#2}}%
- }
-}
-{
- \newcommand*{\GLSxtrusefield}[2]{%
- \glsdoifexists{#1}{\mfirstucMakeUppercase{\@gls@entry@field{#1}{#2}}}%
- }
+\newcommand*{\GLSxtrusefield}[2]{%
+ \glsuppercase{\csuse{glo@\glsdetoklabel{#1}@#2}}%
}
+\glsmfublocker{\GLSxtrusefield}
% \end{macrocode}
%\end{macro}
%
@@ -3228,7 +3674,7 @@ Dickimaw Books\\
%\begin{macro}{\glsxtrapptocsvfield}
%\changes{1.47}{2021-11-04}{new}
% Similar to the above but will append value with a leading comma if
-% the field is already defined. This is used by \gls{bib2gls}.
+% the field is already defined. This is used by \app{bib2gls}.
% There's no check if the entry has been defined. (Because of the
% way that bib2gls's save-from-alias etc options are
% implemented, the entry may not have yet been written to the glstex
@@ -3264,8 +3710,9 @@ Dickimaw Books\\
%\begin{macro}{\GlsXtrLetField}
%\changes{1.12}{2017-02-03}{new}
%Uses \cs{cslet} instead. Third argument should be a macro.
+%\changes{1.49}{2022-10-14}{corrected spelling}
% \begin{macrocode}
-\newrobustcmd*{\GlstrLetField}[3]{%
+\newrobustcmd*{\GlsXtrLetField}[3]{%
\glsxtrsetfieldifexists{#1}{#2}%
{\cslet{glo@\glsdetoklabel{#1}@#2}{#3}}%
}
@@ -3656,14 +4103,35 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
-%\section{Modifications to Commands Provided by \styfmt{glossaries}}
-% Some of the commands provided by \styfmt{glossaries} are modified
+%\subsection{Modifications to Commands Provided by \sty{glossaries}}
+% Some of the commands provided by \sty{glossaries} are modified
% to take into account new options or to change default behaviour.
%
+%\begin{macro}{\@p@glossarysection}
+%Phantom section only needs to be added for starred section
+%commands.
+%\changes{1.49}{2022-10-14}{moved \cs{phantomsection}}
+% \begin{macrocode}
+\renewcommand*{\@p@glossarysection}[2]{%
+ \glsclearpage
+ \ifdefempty\@@glossarysecstar
+ {%
+ \csname\@@glossarysec\endcsname{#2}%
+ }%
+ {%
+ \phantomsection
+ \@gls@toc{#1}{\@@glossarysec}%
+ \csname\@@glossarysec\endcsname*{#2}%
+ }%
+ \@@glossaryseclabel
+}
+% \end{macrocode}
+%\end{macro}
+%
% The original \cs{@gls@entry@field} causes a problem for undefined
% entries when used in section headings or captions. Since entries
% must be defined with just the base package this isn't a
-% significant issue, but it will cause a problem with \gls{bib2gls}
+% significant issue, but it will cause a problem with \app{bib2gls}
% where no entries are defined on the first \LaTeX\ call, so
% redefine \cs{@gls@entry@field} to use \cs{csuse} instead of
% \cs{csname}.
@@ -3702,6 +4170,84 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\@gls@noexpand@field}
+%\changes{1.49}{2022-10-14}{added redefinition}
+%Add check for encapinnerfmt, encapnocase and encapnocaseinnerfmt
+% \begin{macrocode}
+\renewcommand{\@@gls@noexpand@field}[3]{%
+ \glsifcategoryattributehasitem{\@glo@category}{encapnocaseinnerfmt}{#2}%
+ {%
+ \csxdef{glo@#1@#2}{\noexpand\NoCaseChange{\noexpand\glsxtrgenentrytextfmt
+ {\expandonce{#3}}}}%
+ \glsexclapplyinnerfmtfield{#1}{#2}%
+ }%
+ {%
+ \glsifcategoryattributehasitem{\@glo@category}{encapnocase}{#2}%
+ {%
+ \glsifcategoryattributehasitem{\@glo@category}{encapinnerfmt}{#2}%
+ {%
+ \csxdef{glo@#1@#2}{\noexpand\NoCaseChange{\noexpand\glsxtrgenentrytextfmt
+ {\expandonce{#3}}}}%
+ \glsexclapplyinnerfmtfield{#1}{#2}%
+ }%
+ {%
+ \csxdef{glo@#1@#2}{\noexpand\NoCaseChange{\expandonce{#3}}}%
+ }%
+ }%
+ {%
+ \glsifcategoryattributehasitem{\@glo@category}{encapinnerfmt}{#2}%
+ {%
+ \csxdef{glo@#1@#2}{\noexpand\glsxtrgenentrytextfmt{\expandonce{#3}}}%
+ \glsexclapplyinnerfmtfield{#1}{#2}%
+ }%
+ {%
+ \expandafter\global\expandafter\let\csname glo@#1@#2\endcsname#3%
+ }%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@@gls@expand@field}
+%\changes{1.49}{2022-10-14}{added redefinition}
+%Add check for encapinnerfmt, encapnocase and encapnocaseinnerfmt
+% \begin{macrocode}
+\renewcommand{\@@gls@expand@field}[3]{%
+ \glsifcategoryattributehasitem{\@glo@category}{encapnocaseinnerfmt}{#2}%
+ {%
+ \protected@csxdef{glo@#1@#2}{\noexpand\NoCaseChange
+ {\noexpand\glsxtrgenentrytextfmt{#3}}}%
+ \glsexclapplyinnerfmtfield{#1}{#2}%
+ }%
+ {%
+ \glsifcategoryattributehasitem{\@glo@category}{encapnocase}{#2}%
+ {%
+ \glsifcategoryattributehasitem{\@glo@category}{encapinnerfmt}{#2}%
+ {%
+ \protected@csxdef{glo@#1@#2}{\noexpand\NoCaseChange
+ {\noexpand\glsxtrgenentrytextfmt{#3}}}%
+ \glsexclapplyinnerfmtfield{#1}{#2}%
+ }%
+ {%
+ \protected@csxdef{glo@#1@#2}{\noexpand\NoCaseChange{#3}}%
+ }%
+ }%
+ {%
+ \glsifcategoryattributehasitem{\@glo@category}{encapinnerfmt}{#2}%
+ {%
+ \protected@csxdef{glo@#1@#2}{\noexpand\glsxtrgenentrytextfmt{#3}}%
+ \glsexclapplyinnerfmtfield{#1}{#2}%
+ }%
+ {%
+ \protected@csxdef{glo@#1@#2}{#3}%
+ }%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
%Provide a starred version of \cs{longnewglossaryentry} that doesn't
%automatically insert \verb|\leavevmode\unskip\nopostdesc| at the
%end of the description. The unstarred version is modified to use
@@ -3973,10 +4519,21 @@ Dickimaw Books\\
%
%\begin{macro}{\glsxtrcopytoglossary}
%Adds an entry label to another glossary list. First argument is
-%entry label. Second argument is glossary label.
+%entry label. Second argument is glossary label. The starred version
+%globally adds the entry label.
%\changes{1.12}{2017-02-03}{new}
+%\changes{1.49}{2022-10-14}{added starred form}
% \begin{macrocode}
-\newcommand*{\glsxtrcopytoglossary}[2]{%
+\newcommand*{\glsxtrcopytoglossary}{%
+ \@ifstar\s@glsxtrcopytoglossary\@glsxtrcopytoglossary
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsxtrcopytoglossary}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@glsxtrcopytoglossary}[2]{%
\glsdoifexists{#1}%
{%
\ifcsdef{glolist@#2}
@@ -3994,25 +4551,54 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
-%\subsection{Existence Checks}
+%\begin{macro}{\s@glsxtrcopytoglossary}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\s@glsxtrcopytoglossary}[2]{%
+ \glsdoifexists{#1}%
+ {%
+ \ifcsdef{glolist@#2}
+ {%
+ \protected@csxappto{glolist@#2}{#1,}%
+ }%
+ {%
+ \glsxtrundefaction{Glossary type `#2' doesn't exist}{}%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\subsubsection{Existence Checks}
%\begin{macro}{\glsdoifexists}
% Modify \cs{glsdoifexists} to take account of the
% \pkgopt{undefaction} setting.
+%\changes{1.08}{2016-12-13}{now defines \cs{glslabel}}
+%\changes{1.46}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}}
+%\changes{1.49}{2022-10-14}{added \cs{glsxtrundefdebug}}
% \begin{macrocode}
\renewcommand{\glsdoifexists}[2]{%
- \ifglsentryexists{#1}{#2}%
- {%
+ \ifglsentryexists{#1}{#2}{\glsxtr@doifexists{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtr@doifexists}
+%Provide a robust command for the error/warning in case
+%\cs{glsdoifexists} is expanded.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newrobustcmd{\glsxtr@doifexists}[1]{%
% \end{macrocode}
% Define \cs{glslabel} in case it's needed after this command (for
% example in the post-link hook).
-%\changes{1.08}{2016-12-13}{now defines \cs{glslabel}}
-%\changes{1.46}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}}
% \begin{macrocode}
- \protected@edef\glslabel{\glsdetoklabel{#1}}%
- \glsxtrundefaction{Glossary entry `\glslabel'
- has not been defined}{You need to define a glossary entry before
- you can reference it.}%
- }%
+ \protected@edef\glslabel{\glsdetoklabel{#1}}%
+ \expandafter\glsxtrundefdebug\expandafter
+ {\expandafter\detokenize\expandafter{\glslabel}}%
+ \glsxtrundefaction{Glossary entry `\glslabel'
+ has not been defined}{You need to define a glossary entry before
+ you can reference it.}%
}
% \end{macrocode}
%\end{macro}
@@ -4022,9 +4608,19 @@ Dickimaw Books\\
% \pkgopt{undefaction} setting.
% \begin{macrocode}
\renewcommand{\glsdoifnoexists}[2]{%
- \ifglsentryexists{#1}{%
- \glsxtrundefaction{Glossary entry `\glsdetoklabel{#1}'
- has already been defined}{}}{#2}%
+ \ifglsentryexists{#1}{\glsxtr@doifnoexists{#1}}{#2}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtr@doifnoexists}
+%Provide a robust command for the error/warning in case
+%\cs{glsdoifnoexists} is expanded.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newrobustcmd{\glsxtr@doifnoexists}[1]{%
+ \glsxtrundefaction{Glossary entry `\glsdetoklabel{#1}'
+ has already been defined}%
}
% \end{macrocode}
%\end{macro}
@@ -4032,7 +4628,7 @@ Dickimaw Books\\
%\begin{macro}{\glsdoifexistsordo}
% Modify \cs{glsdoifexistsordo} to take account of the
% \pkgopt{undefaction} setting. This command was introduced in
-% \styfmt{glossaries} version 4.19, so check if it has been defined first.
+% \sty{glossaries} version 4.19, so check if it has been defined first.
% \begin{macrocode}
\ifdef\glsdoifexistsordo
{%
@@ -4092,8 +4688,8 @@ Dickimaw Books\\
%\end{macro}
%
%There are now three types of cross-references: the \gloskey{see} key (as
-%original), the \gloskey{alias} key (from \styfmt{glossaries-extra} v1.12)
-% and the \gloskey{seealso} key (from \styfmt{glossaries-extra} v1.16).
+%original), the \gloskey{alias} key (from \sty{glossaries-extra} v1.12)
+% and the \gloskey{seealso} key (from \sty{glossaries-extra} v1.16).
% The original \gloskey{see} key needs to have a corresponding field
% (which it doesn't with the base \sty{glossaries} package).
%
@@ -4117,6 +4713,70 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtrseelistsencap}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glsxtrseelistsencap}\marg{content}
+%\end{definition}
+%Encapsulates cross-reference list.
+% \begin{macrocode}
+\newcommand*{\glsxtrseelistsencap}[1]{\space #1}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrseelistsdelim}
+%\changes{1.49}{2022-10-14}{new}
+%Delimiter in cross-reference list.
+% \begin{macrocode}
+\newcommand*{\glsxtrseelistsdelim}{, }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrseelists}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glsxtrseelists}\marg{label}
+%\end{definition}
+% \begin{macrocode}
+\newcommand*{\glsxtrseelists}[1]{%
+ \glsdoifexists{#1}%
+ {%
+ \def\@glsxtr@seelists{}%
+ \letcs{\@glo@see}{glo@\glsdetoklabel{#1}@see}%
+ \ifdefempty\@glo@see
+ {}%
+ {%
+ \protected@edef\@glsxtr@seelists{%
+ \noexpand\glsxtr@usesee\@glo@see\noexpand\@end@glsxtr@usesee
+ }%
+ }%
+ \letcs{\@glo@see}{glo@\glsdetoklabel{#1}@seealso}%
+ \ifdefempty\@glo@see
+ {}%
+ {%
+ \ifdefempty\@glsxtr@seelists{}%
+ {\appto\@glsxtr@seelists{\glsxtrseelistsdelim}}%
+ \protected@edef\@glsxtr@seelists{%
+ \noexpand\glsxtruseseealsoformat{\@glo@see}%
+ }%
+ }%
+ \letcs{\@glo@see}{glo@\glsdetoklabel{#1}@alias}%
+ \ifdefempty\@glo@see
+ {}%
+ {%
+ \ifdefempty\@glsxtr@seelists{}%
+ {\appto\@glsxtr@seelists{\glsxtrseelistsdelim}}%
+ \protected@edef\@glsxtr@seelists{%
+ \noexpand\glsxtruseseeformat{\noexpand\seename}{\@glo@see}%
+ }%
+ }%
+ \ifdefempty\@glsxtr@seelists{}%
+ {\glsxtrseelistsencap\@glsxtr@seelists}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsxtrusesee}
%\changes{1.06}{2016-06-18}{new}
%Apply \cs{glsseeformat} to the \gloskey{see} key if not empty.
@@ -4171,11 +4831,11 @@ Dickimaw Books\\
%\changes{1.37}{2018-11-30}{removed reference to \cs{glslabel}}
%\changes{1.42}{2020-02-03}{switched to using \cs{glsfmttext} and
%\cs{glsfmtname}}
-%\styfmt{glossaries} originally defined \cs{glsseeitemformat}
+%\sty{glossaries} originally defined \cs{glsseeitemformat}
%to use \cs{glsentryname} but in v3.0 this was switched to
%use \cs{glsentrytext} due to problems occurring with the
%\gloskey{name} field being sanitized. Since this is no longer a
-%problem, \styfmt{glossaries-extra} restored the original
+%problem, \sty{glossaries-extra} restored the original
%definition as it makes more sense to use the \gloskey{name}
%in the cross-reference list. Unfortunately this doesn't take style
%changes into account, so as from v1.42, this now uses
@@ -4201,12 +4861,26 @@ Dickimaw Books\\
%use this command to show the hierarchy, if required. This now uses
%\cs{glsfmttext} and \cs{glsfmtname} instead of \cs{glsaccessshort}
%and \cs{glsaccessname} to allow for style formatting.
+%\changes{1.49}{2022-10-14}{added \cs{expandafter}s}
+%\changes{1.49}{2022-10-14}{added \cs{glstexorpdfstring}}
% \begin{macrocode}
\newcommand*{\glsxtrhiername}[1]{%
+ \glstexorpdfstring
+ {\@glsxtrhiername{#1}}%
+ {\glsentryname{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\@glsxtrhiername}
+%Provide robust inner command.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newrobustcmd*{\@glsxtrhiername}[1]{%
\glsdoifexists{#1}%
{%
\glsxtrifhasfield{parent}{#1}%
- {\glsxtrhiername{\glscurrentfieldvalue}\glsxtrhiernamesep}%
+ {\expandafter\glsxtrhiername\expandafter
+ {\glscurrentfieldvalue}\glsxtrhiernamesep}%
{}%
\ifglshasshort{#1}{\glsfmttext{#1}}{\glsfmtname{#1}}%
}%
@@ -4222,18 +4896,33 @@ Dickimaw Books\\
%\cs{Glsxtrhiername}\marg{label}
%\end{definition}
%As above but displays the top-level name with an initial capital.
+%\changes{1.49}{2022-10-14}{added \cs{expandafter}s}
+%\changes{1.49}{2022-10-14}{added \cs{glstexorpdfstring}}
% \begin{macrocode}
\newcommand*{\Glsxtrhiername}[1]{%
+ \glstexorpdfstring
+ {\@Glsxtrhiername{#1}}%
+ {\MFUsentencecase{\glsentryname{#1}}}%
+}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\@Glsxtrhiername}
+%\changes{1.49}{2022-10-14}{new}
+%Provide robust inner command.
+% \begin{macrocode}
+\newrobustcmd*{\@Glsxtrhiername}[1]{%
\glsdoifexists{#1}%
{%
\glsxtrifhasfield{parent}{#1}%
{%
- \Glsxtrhiername{\glscurrentfieldvalue}\glsxtrhiernamesep
+ \expandafter\Glsxtrhiername\expandafter
+ {\glscurrentfieldvalue}\glsxtrhiernamesep
\ifglshasshort{#1}{\glsfmttext{#1}}{\glsfmtname{#1}}%
}%
{\ifglshasshort{#1}{\Glsfmttext{#1}}{\Glsfmtname{#1}}}%
}%
}
+\glsmfuaddmap{\glsxtrhiername}{\Glsxtrhiername}
% \end{macrocode}
%\end{macro}
%
@@ -4247,16 +4936,31 @@ Dickimaw Books\\
%As above but converts the first letter of each name to a capital.
%(Note that this isn't applying title case, just capitalising the
%start of each hierarchical element.)
+%\changes{1.49}{2022-10-14}{added \cs{expandafter}s}
+%\changes{1.49}{2022-10-14}{added \cs{glstexorpdfstring}}
% \begin{macrocode}
\newcommand*{\GlsXtrhiername}[1]{%
+ \glstexorpdfstring
+ {\@GlsXtrhiername{#1}}%
+ {\glsentryname{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\@GlsXtrhiername}
+%\changes{1.49}{2022-10-14}{new}
+%Provide robust inner command.
+% \begin{macrocode}
+\newrobustcmd*{\@GlsXtrhiername}[1]{%
\glsdoifexists{#1}%
{%
\glsxtrifhasfield{parent}{#1}%
- {\GlsXtrhiername{\glscurrentfieldvalue}\glsxtrhiernamesep}%
+ {\expandafter\GlsXtrhiername\expandafter
+ {\glscurrentfieldvalue}\glsxtrhiernamesep}%
{}%
\ifglshasshort{#1}{\Glsfmttext{#1}}{\Glsfmtname{#1}}%
}%
}
+\glsmfublocker{\GlsXtrhiername}
% \end{macrocode}
%\end{macro}
%
@@ -4268,18 +4972,33 @@ Dickimaw Books\\
%\cs{GLSxtrhiername}\marg{label}
%\end{definition}
%As above but displays the top-level name in all-caps.
+%\changes{1.49}{2022-10-14}{added \cs{expandafter}s}
+%\changes{1.49}{2022-10-14}{added \cs{glstexorpdfstring}}
% \begin{macrocode}
\newcommand*{\GLSxtrhiername}[1]{%
+ \glstexorpdfstring
+ {\@GLSxtrhiername{#1}}%
+ {\GLSxtrusefield{#1}{name}}%
+}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\@GLSxtrhiername}
+%\changes{1.49}{2022-10-14}{new}
+%Provide robust inner command.
+% \begin{macrocode}
+\newrobustcmd*{\@GLSxtrhiername}[1]{%
\glsdoifexists{#1}%
{%
\glsxtrifhasfield{parent}{#1}%
{%
- \GLSxtrhiername{\glscurrentfieldvalue}\glsxtrhiernamesep
+ \expandafter\GLSxtrhiername\expandafter
+ {\glscurrentfieldvalue}\glsxtrhiernamesep
\ifglshasshort{#1}{\glsfmttext{#1}}{\glsfmtname{#1}}%
}%
{\ifglshasshort{#1}{\GLSfmttext{#1}}{\GLSfmtname{#1}}}%
}%
}
+\glsmfublocker{\GLSxtrhiername}
% \end{macrocode}
%\end{macro}
%
@@ -4291,18 +5010,36 @@ Dickimaw Books\\
%\cs{GLSXTRhiername}\marg{label}
%\end{definition}
%As above but displays all names in all-caps.
+%\changes{1.49}{2022-10-14}{added \cs{expandafter}s}
+%\changes{1.49}{2022-10-14}{added \cs{glstexorpdfstring}}
% \begin{macrocode}
\newcommand*{\GLSXTRhiername}[1]{%
- \glsdoifexists{#1}%
- {%
- \glsxtrifhasfield{parent}{#1}%
- {\GLSXTRhiername{\glscurrentfieldvalue}\glsxtrhiernamesep}%
- {}
- \ifglshasshort{#1}{\GLSfmttext{#1}}{\GLSfmtname{#1}}%
- }%
+ \glstexorpdfstring
+ {\@GLSXTRhiername{#1}}%
+ {\GLSxtrusefield{#1}{name}}%
}
% \end{macrocode}
%\end{macro}
+%\begin{macro}{\@GLSXTRhiername}
+%\changes{1.49}{2022-10-14}{new}
+%Provide robust inner command.
+% \begin{macrocode}
+\newrobustcmd*{\@GLSXTRhiername}[1]{%
+ \glsdoifexists{#1}%
+ {%
+ \glsxtrifhasfield{parent}{#1}%
+ {\expandafter\GLSXTRhiername\expandafter
+ {\glscurrentfieldvalue}\glsxtrhiernamesep}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{removed unwanted eol}
+% \begin{macrocode}
+ {}%
+ \ifglshasshort{#1}{\GLSfmttext{#1}}{\GLSfmtname{#1}}%
+ }%
+}
+\glsmfublocker{\GLSXTRhiername}
+% \end{macrocode}
+%\end{macro}
%
%\begin{macro}{\glsxtrhiernamesep}
%\changes{1.37}{2018-11-30}{new}
@@ -4404,6 +5141,61 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtrtaggedlistsep}
+%\changes{1.49}{2022-10-14}{new}
+%Separator between the tag and the list in \cs{glsxtrtaggedlist}
+% \begin{macrocode}
+\newcommand{\glsxtrtaggedlistsep}{\space}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\glsxtrtaggedlist}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glsxtrtaggedlist}\marg{singular tag}\marg{plural
+%tag}\marg{label prefix}\marg{label list}
+%\end{definition}
+%Similar to the above but the tag is selected depending on how many
+%items there are in the list.
+% \begin{macrocode}
+\newrobustcmd*{\glsxtrtaggedlist}[4]{%
+ \begingroup
+ \protected@edef\@gls@taggedlist@labels{#4}%
+ \let\@gls@dolast\relax
+ \let\@gls@donext\relax
+ \let\@glsseeitem\@glsxtr@seefirstitem
+ \let\@glsseelastsep\glsseelastsep
+ \def\@gls@taggedlist@content{}%
+ \let\@gls@taggedlist@tag\relax
+ \@for\@gls@thislabel:=\@gls@taggedlist@labels\do{%
+ \ifx\@xfor@nextelement\@nnil
+ \ifx\@gls@dolast\relax
+ \else
+ \eappto\@gls@taggedlist@content{\expandonce\@gls@dolast}%
+ \fi
+ \else
+ \ifx\@gls@dolast\relax
+ \else
+ \eappto\@gls@taggedlist@content{\expandonce\@gls@donext}%
+ \fi
+ \fi
+ \protected@eappto\@gls@taggedlist@content{\noexpand\@glsseeitem
+ {#3\@gls@thislabel}}%
+ \let\@gls@dolast\@glsseelastsep
+ \let\@gls@donext\glsseesep
+ \let\@glsseeitem\@glsxtr@seeitem
+ \let\@glsseelastsep\glsseelastoxfordsep
+ \ifx\@gls@taggedlist@tag\relax
+ \def\@gls@taggedlist@tag{#1\glsxtrtaggedlistsep}%
+ \else
+ \def\@gls@taggedlist@tag{#2\glsxtrtaggedlistsep}%
+ \fi
+ }%
+ \@gls@taggedlist@tag\@gls@taggedlist@content
+ \endgroup
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\@glsxtr@seeitem}
%\changes{1.48}{2021-11-22}{new}
% \begin{macrocode}
@@ -4458,7 +5250,7 @@ Dickimaw Books\\
%\changes{1.16}{2017-06-15}{new}
%\changes{1.42}{2020-02-03}{add check for \cs{alsoname}}
%In case this command hasn't been defined. Languages packages
-%actually provide \ics{alsoname} so use that if it's defined.
+%actually provide \cs{alsoname} so use that if it's defined.
% \begin{macrocode}
\ifdef\alsoname
{\providecommand{\seealsoname}{\alsoname}}
@@ -4498,21 +5290,24 @@ Dickimaw Books\\
%This doesn't increment the associated counter.
% \begin{macrocode}
\newrobustcmd*{\glsxtrindexseealso}[2]{%
- \ifx\@glsxtr@record@setting\@glsxtr@record@setting@alsoindex
- \@glsxtr@recordsee{#1}{#2}%
- \fi
- \glsdoifexists{#1}%
+ \glsxtr@wrglossary@encap{#1}
{%
- \@@glsxtrwrglossmark
- \def\@gls@xref{#2}%
- \@onelevel@sanitize\@gls@xref
- \@gls@checkmkidxchars\@gls@xref
- \gls@glossary{\csname glo@#1@type\endcsname}{%
- (indexentry
- :tkey (\csname glo@#1@index\endcsname)
- :xref (\string"\@gls@xref\string")
- :attr \string"seealso\string"
- )
+ \ifx\@glsxtr@record@setting\@glsxtr@record@setting@alsoindex
+ \@glsxtr@recordsee{#1}{#2}%
+ \fi
+ \glsdoifexists{#1}%
+ {%
+ \@@glsxtrwrglossmark
+ \def\@gls@xref{#2}%
+ \@onelevel@sanitize\@gls@xref
+ \@gls@checkmkidxchars\@gls@xref
+ \gls@glossary{\csname glo@#1@type\endcsname}{%
+ (indexentry
+ :tkey (\csname glo@#1@index\endcsname)
+ :xref (\string"\@gls@xref\string")
+ :attr \string"seealso\string"
+ )
+ }%
}%
}%
}
@@ -4575,6 +5370,7 @@ Dickimaw Books\\
{\csxdef{glo@\@glo@label @alias}{}}%
{%
\csxdef{glo@\@glo@label @alias}{\@glo@alias}%
+ \glsxtraliashook{\@glo@label}%
}%
}
% \end{macrocode}
@@ -4614,6 +5410,7 @@ Dickimaw Books\\
{%
\protected@edef\@do@glssee{\noexpand\glssee{\@glo@label}{\@glo@alias}}%
\@do@glssee
+ \glsxtraliashook{\@glo@label}%
}%
{}%
}%
@@ -4681,6 +5478,13 @@ Dickimaw Books\\
}
% \end{macrocode}
%
+%\begin{macro}{\glsxtraliashook}
+%\changes{1.49}{2022-10-14}{new}
+%Provide a hook that's used when the alias field is provided.
+% \begin{macrocode}
+\newcommand*{\glsxtraliashook}[1]{}
+% \end{macrocode}
+%\end{macro}
%
% Add all unused cross-references at the end of the document.
% \begin{macrocode}
@@ -4696,14 +5500,22 @@ Dickimaw Books\\
{%
\forglsentries[\@glo@type]{\@glo@label}%
{%
- \ifglsused{\@glo@label}%
- {\expandafter\@glsxtr@addunusedxrefs\expandafter{\@glo@label}}{}%
+ \ifglsused{\@glo@label}{\glsxtraddunusedxrefs{\@glo@label}}{}%
}%
}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtraddunusedxrefs}
+%\changes{1.49}{2022-10-14}{new}
+%Added user-level command in case user wants to redefine
+%\cs{glsxtraddallcrossrefs}
+% \begin{macrocode}
+\newcommand*{\glsxtraddunusedxrefs}[1]{\expandafter\@glsxtr@addunusedxrefs\expandafter{#1}}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\@glsxtr@addunusedxrefs}
% If the given entry has a \gloskey{see} or \gloskey{seealso} field add all unused
% cross-references. (The \gloskey{alias} field isn't checked.)
@@ -4767,10 +5579,10 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
-%\subsection{Document Definitions}
+%\subsubsection{Document Definitions}
%
%\begin{macro}{\gls@begindocdefs}
-%This command was only introduced to \styfmt{glossaries} v4.37, so
+%This command was only introduced to \sty{glossaries} v4.37, so
%it may not be defined. If it has been defined, redefine it to check
%\cs{@glsxtr@docdefval} so that it only inputs the \texttt{.glsdefs}
%file if \pkgopt[true]{docdef}.
@@ -4835,6 +5647,7 @@ Dickimaw Books\\
% \begin{macrocode}
\let\glsxtr@orgmakenoidxglossaries\makenoidxglossaries
\renewcommand{\makenoidxglossaries}{%
+ \def\glsindexingsetting{noidx}%
\@domakeglossaries
{%
\ifdefequal\@glsxtr@record@setting\@glsxtr@record@setting@off
@@ -4892,11 +5705,38 @@ Dickimaw Books\\
{You may only use \string\makenoidxglossaries\ space with the
record=off option}%
}%
+ \let\gls@warn@noidx@incompatible\@gls@warn@noidx@incompatible
}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\gls@warn@noidx@incompatible}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\gls@warn@noidx@incompatible}[2]{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@warn@noidx@incompatible}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@gls@warn@noidx@incompatible}[2]{%
+ #2\GlossariesExtraWarning{#1\space is incompatible with \string\makenoidxglossaries}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\gls@warn@noidxmakegloss@incompatible}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\gls@warn@noidxmakegloss@incompatible}[2]{%
+ \gls@warn@noidx@incompatible{#1}{#2}%
+ \gls@warn@makegloss@incompatible{#1}{#2}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\gls@defdocnewglossaryentry}
% Modify \cs{gls@defdocnewglossaryentry} so that it checks
% the \pkgopt{docdef} value.
@@ -5039,6 +5879,7 @@ Dickimaw Books\\
\def\glsxtr@keylist{##1}%
\@Glsxtr
}
+ \glsmfuaddmap{\glsxtr}{\Glsxtr}
% \end{macrocode}
%\end{macro}
%
@@ -5093,6 +5934,7 @@ Dickimaw Books\\
\def\glsxtr@keylist{##1}%
\@Glsxtrpl
}
+ \glsmfuaddmap{\glsxtrpl}{\Glsxtrpl}
% \end{macrocode}
%\end{macro}
%
@@ -5162,7 +6004,7 @@ Dickimaw Books\\
\@onlypreamble\GlsXtrEnableOnTheFly
% \end{macrocode}
%
-%\subsection{Existing Glossary Style Modifications}
+%\subsubsection{Existing Glossary Style Modifications}
%
% Modify \cs{setglossarystyle} to keep track of the current style.
% This allows the \cs{glossaries-extra-stylemods} package to reset the
@@ -5175,7 +6017,18 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
-% Modify \cs{setglossarystyle} to set \cs{@glsxtr@current@style}.
+%\begin{macro}{\glsxtrpreglossarystyle}
+%\changes{1.49}{2022-10-14}{new}
+%A hook to initialise default definitions for style commands.
+% \begin{macrocode}
+\newcommand{\glsxtrpreglossarystyle}{%
+ \renewcommand*{\glssubgroupheading}[4]{\glsgroupheading{##4}}%
+}
+% \end{macrocode}
+%\end{macro}
+% Modify \cs{setglossarystyle} to set \cs{@glsxtr@current@style}
+% and reset \cs{glssubgroupheading} in case the style doesn't
+% support it.
%\begin{macro}{\setglossarystyle}
% \begin{macrocode}
\renewcommand*{\setglossarystyle}[1]{%
@@ -5184,12 +6037,16 @@ Dickimaw Books\\
\PackageError{glossaries-extra}{Glossary style `#1' undefined}{}%
}%
{%
+ \glsxtrpreglossarystyle
\csname @glsstyle@#1\endcsname
% \end{macrocode}
% Only set the current style if it exists.
% \begin{macrocode}
\protected@edef\@glsxtr@current@style{#1}%
}%
+% \end{macrocode}
+% Set this as the default, if a default hasn't been set.
+% \begin{macrocode}
\ifx\@glossary@default@style\relax
\protected@edef\@glossary@default@style{#1}%
\fi
@@ -5197,7 +6054,7 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
-% In case we have an old version of \styfmt{glossaries}:
+% In case we have an old version of \sty{glossaries}:
% \begin{macrocode}
\ifdef\@glossary@default@style
{}
@@ -5435,7 +6292,7 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
-%\subsection{Entry Formatting, Hyperlinks and Indexing}
+%\subsubsection{Entry Formatting, Hyperlinks and Indexing}
%
%\begin{macro}{\glsentryfmt}
% Change default entry format. Use the generic format for regular
@@ -5480,13 +6337,471 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%Some formatting commands (such as highlighting or letter spacing) may
+%require expandable content in the argument, so also provide a formatting
+%command for use within \cs{glsgenentryfmt} for those instances.
+%
+%\begin{macro}{\glsxtrdefaultentrytextfmt}
+%\changes{1.49}{2022-10-14}{new}
+%This is the default command that \cs{glsxtrgenentrytextfmt} is initialised to
+%within \cs{@gls@link}.
+% \begin{macrocode}
+\newcommand{\glsxtrdefaultentrytextfmt}[1]{#1}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrattrentrytextfmt}
+%\changes{1.49}{2022-10-14}{new}
+%Provide a convenient command that applies the formatting according to
+%the category attribute. This isn't used by default as this inner formatting
+%should rarely be needed and increases complexity.
+% \begin{macrocode}
+\newcommand{\glsxtrattrentrytextfmt}[1]{%
+ \glshasattribute{\glslabel}{innertextformat}%
+ {%
+ \csuse{\glsgetattribute{\glslabel}{innertextformat}}{#1}%
+ }%
+ {#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrgenentrytextfmt}
+%\changes{1.49}{2022-10-14}{new}
+%This command is a user-level command to allow it to be included in custom
+%formats or styles but it should not be redefined at the user level
+%as it's redefined within \cs{@gls@link} (similar to other style commands, such
+%as \cs{glscapscase}. Redefine \cs{glsxtrdefaultentrytextfmt} to change
+%the default definition for this command.
+% \begin{macrocode}
+\newcommand*{\glsxtrgenentrytextfmt}{\glsxtrdefaultentrytextfmt}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsfmtfield}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glsfmtfield}\marg{insert}\marg{cs}\marg{label}\marg{field}
+%\end{definition}
+%Provide a convenient way of applying a formatting command to the actual
+%field contents. No check for existence.
+%
+%Note this command intentionally isn't robust, as it's possible that
+%a user may want to redefine an abbreviation command to use
+%\cs{MakeLowercase}, for example, to use smallcaps when
+%abbreviations have been defined with the short version in capitals.
+%Using \cs{newrobustcmd} will break that case.
+% \begin{macrocode}
+\newcommand*{\glsfmtfield}[4]{%
+ \expandafter\expandafter\expandafter
+ #2\expandafter\expandafter\expandafter
+ {\csname glo@\glsdetoklabel{#3}@#4\endcsname #1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsfmtfield}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{Glsfmtfield}\marg{insert}\marg{cs}\marg{label}\marg{field}
+%\end{definition}
+%As above but convert first letter to uppercase.
+%Note that if the formatting command can go outside of \cs{makefirstuc}
+%then it can simply be applied around the appropriate command that expands
+%to the field value. For example,
+%\begin{verbatim}
+%\emph{\Glsentrytext{label}}
+%\end{verbatim}
+%instead of
+%\begin{verbatim}
+%\Glsfmtfield{}{\emph}{sample}{text}
+%\end{verbatim}
+%
+%Note this command intentionally isn't robust for the same reason as
+%above. The expansion allows \cs{makefirstuc} to pick up any
+%mappings or blockers before the content is passed to
+%\cs{MFUsentencecase}.
+% \begin{macrocode}
+\newcommand*{\Glsfmtfield}[4]{%
+ \ifx#2\@firstofone
+ \expandafter\expandafter\expandafter
+ \glssentencecase\expandafter\expandafter\expandafter
+ {%
+ \csname glo@\glsdetoklabel{#3}@#4\endcsname #1%
+ }%
+ \else
+ \expandafter\expandafter\expandafter
+ \glssentencecase\expandafter\expandafter\expandafter
+ {%
+ \expandafter\expandafter\expandafter
+ #2\expandafter\expandafter\expandafter
+ {\csname glo@\glsdetoklabel{#3}@#4\endcsname #1}%
+ }%
+ \fi
+}
+\glsmfuaddmap{\glsfmtfield}{\Glsfmtfield}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSfmtfield}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{GLSfmtfield}\marg{insert}\marg{cs}\marg{label}\marg{field}
+%\end{definition}
+%As above but convert all to uppercase.
+%The expansion is in case we have an older kernel.
+% \begin{macrocode}
+\newcommand*{\GLSfmtfield}[4]{%
+ \ifx#2\@firstofone
+ \expandafter\expandafter\expandafter
+ \glsuppercase\expandafter\expandafter\expandafter
+ {%
+ \csname glo@\glsdetoklabel{#3}@#4\endcsname #1%
+ }%
+ \else
+ \expandafter\expandafter\expandafter
+ \glsuppercase\expandafter\expandafter\expandafter
+ {%
+ \expandafter\expandafter\expandafter
+ #2\expandafter\expandafter\expandafter
+ {\csname glo@\glsdetoklabel{#3}@#4\endcsname #1}%
+ }%
+ \fi
+}
+\glsmfublocker{\GLSfmtfield}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsfmtinsert}
+%\changes{1.49}{2022-10-14}{new}
+%Formats \cs{glsinsert}.
+% \begin{macrocode}
+\newcommand*{\glsfmtinsert}{%
+ \ifdefempty\glsinsert{}%
+ {\expandafter\glsxtrgenentrytextfmt\expandafter{\glsinsert}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSfmtinsert}
+%\changes{1.49}{2022-10-14}{new}
+%As above but all caps.
+% \begin{macrocode}
+\newcommand*{\GLSfmtinsert}{%
+ \ifdefempty\glsinsert{}%
+ {%
+ \expandafter\glsuppercase\expandafter
+ {\expandafter\glsxtrgenentrytextfmt\expandafter{\glsinsert}}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsifapplyinnerfmtfield}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glsifapplyinnerfmtfield}\marg{label}\marg{field}\marg{true}\marg{false}
+%\end{definition}
+%Does \meta{true} if \cs{glsgenentryfmt} should encapsulate the
+%given field with the inner format otherwise does \meta{false}.
+% \begin{macrocode}
+\newcommand*{\glsifapplyinnerfmtfield}[4]{%
+ \ifcsundef{@glo@\glsdetoklabel{#1}@innerfmt@fields}%
+ {#3}%
+ {\xifinlistcs{#2}{@glo@\glsdetoklabel{#1}@innerfmt@fields}{#4}{#3}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsexclapplyinnerfmtfield}
+%\changes{1.49}{2022-10-14}{new}
+%Adds the field to the exclusion list. This typically means that the
+%field value already contains the inner formatting.
+% \begin{macrocode}
+\newcommand*{\glsexclapplyinnerfmtfield}[2]{%
+ \listcseadd{@glo@\glsdetoklabel{#1}@innerfmt@fields}{#2}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsgenentryfmt}
+%\changes{1.49}{2022-10-14}{added redefinition}
+% Redefine to use \cs{glsxtrgenentrytextfmt}
+% \begin{macrocode}
+\renewcommand*{\glsgenentryfmt}{%
+ \ifdefempty\glscustomtext
+ {%
+ \glsifplural
+ {%
+% \end{macrocode}
+% Plural form
+% \begin{macrocode}
+ \glscapscase
+ {%
+% \end{macrocode}
+% Don't adjust case
+% \begin{macrocode}
+ \ifglsused\glslabel
+ {%
+% \end{macrocode}
+% Subsequent use
+% \begin{macrocode}
+ \glsifapplyinnerfmtfield{\glslabel}{plural}%
+ {%
+ \expandafter\glsaccessfmtplural\expandafter{\glsinsert}%
+ {\glsxtrgenentrytextfmt}{\glslabel}%
+ }%
+ {\glsaccessplural{\glslabel}\glsfmtinsert}%
+ }%
+ {%
+% \end{macrocode}
+% First use
+% \begin{macrocode}
+ \glsifapplyinnerfmtfield{\glslabel}{firstpl}%
+ {%
+ \expandafter\glsaccessfmtfirstplural\expandafter{\glsinsert}%
+ {\glsxtrgenentrytextfmt}{\glslabel}%
+ }%
+ {\glsaccessfirstplural{\glslabel}\glsfmtinsert}%
+ }%
+ }%
+ {%
+% \end{macrocode}
+% Make first letter upper case
+% \begin{macrocode}
+ \ifglsused\glslabel
+ {%
+% \end{macrocode}
+% Subsequent use.
+% \begin{macrocode}
+ \glsifapplyinnerfmtfield{\glslabel}{plural}%
+ {%
+ \expandafter\Glsaccessfmtplural\expandafter
+ {\glsinsert}{\glsxtrgenentrytextfmt}{\glslabel}%
+ }%
+ {\Glsaccessplural{\glslabel}\glsfmtinsert}%
+ }%
+ {%
+% \end{macrocode}
+% First use
+% \begin{macrocode}
+ \glsifapplyinnerfmtfield{\glslabel}{firstpl}%
+ {%
+ \expandafter\Glsaccessfmtfirstplural\expandafter
+ {\glsinsert}{\glsxtrgenentrytextfmt}{\glslabel}%
+ }%
+ {\Glsaccessfirstplural{\glslabel}\glsfmtinsert}%
+ }%
+ }%
+ {%
+% \end{macrocode}
+% Make all upper case
+% \begin{macrocode}
+ \ifglsused\glslabel
+ {%
+% \end{macrocode}
+% Subsequent use
+% \begin{macrocode}
+ \glsifapplyinnerfmtfield{\glslabel}{plural}%
+ {%
+ \expandafter\GLSaccessfmtplural\expandafter
+ {\glsinsert}{\glsxtrgenentrytextfmt}{\glslabel}%
+ }%
+ {\GLSaccessplural{\glslabel}\GLSfmtinsert}%
+ }%
+ {%
+% \end{macrocode}
+% First use
+% \begin{macrocode}
+ \glsifapplyinnerfmtfield{\glslabel}{firstpl}%
+ {%
+ \expandafter\GLSaccessfmtfirstplural\expandafter
+ {\glsinsert}{\glsxtrgenentrytextfmt}{\glslabel}%
+ }%
+ {\GLSaccessfirstplural{\glslabel}\GLSfmtinsert}%
+ }%
+ }%
+ }%
+ {%
+% \end{macrocode}
+% Singular form
+% \begin{macrocode}
+ \glscapscase
+ {%
+% \end{macrocode}
+% Don't adjust case
+% \begin{macrocode}
+ \ifglsused\glslabel
+ {%
+% \end{macrocode}
+% Subsequent use
+% \begin{macrocode}
+ \glsifapplyinnerfmtfield{\glslabel}{text}%
+ {%
+ \expandafter\glsaccessfmttext\expandafter
+ {\glsinsert}{\glsxtrgenentrytextfmt}{\glslabel}%
+ }%
+ {\glsaccesstext{\glslabel}\glsfmtinsert}%
+ }%
+ {%
+% \end{macrocode}
+% First use
+% \begin{macrocode}
+ \glsifapplyinnerfmtfield{\glslabel}{first}%
+ {%
+ \expandafter\glsaccessfmtfirst\expandafter
+ {\glsinsert}{\glsxtrgenentrytextfmt}{\glslabel}%
+ }%
+ {\glsaccessfirst{\glslabel}\glsfmtinsert}%
+ }%
+ }%
+ {%
+% \end{macrocode}
+% Make first letter upper case
+% \begin{macrocode}
+ \ifglsused\glslabel
+ {%
+% \end{macrocode}
+% Subsequent use
+% \begin{macrocode}
+ \glsifapplyinnerfmtfield{\glslabel}{text}%
+ {%
+ \expandafter\Glsaccessfmttext\expandafter
+ {\glsinsert}{\glsxtrgenentrytextfmt}{\glslabel}%
+ }%
+ {\Glsaccesstext{\glslabel}\glsfmtinsert}%
+ }%
+ {%
+% \end{macrocode}
+% First use
+% \begin{macrocode}
+ \glsifapplyinnerfmtfield{\glslabel}{first}%
+ {%
+ \expandafter\Glsaccessfmtfirst\expandafter
+ {\glsinsert}{\glsxtrgenentrytextfmt}{\glslabel}%
+ }%
+ {\Glsaccessfirst{\glslabel}\glsfmtinsert}%
+ }%
+ }%
+ {%
+% \end{macrocode}
+% Make all upper case
+% \begin{macrocode}
+ \ifglsused\glslabel
+ {%
+% \end{macrocode}
+% Subsequent use
+% \begin{macrocode}
+ \glsifapplyinnerfmtfield{\glslabel}{text}%
+ {%
+ \expandafter\GLSaccessfmttext\expandafter
+ {\glsinsert}{\glsxtrgenentrytextfmt}{\glslabel}%
+ }%
+ {\GLSaccesstext{\glslabel}\GLSfmtinsert}%
+ }%
+ {%
+% \end{macrocode}
+% First use
+% \begin{macrocode}
+ \glsifapplyinnerfmtfield{\glslabel}{first}%
+ {%
+ \expandafter\GLSaccessfmtfirst\expandafter
+ {\glsinsert}{\glsxtrgenentrytextfmt}{\glslabel}%
+ }%
+ {\GLSaccessfirst{\glslabel}\GLSfmtinsert}%
+ }%
+ }%
+ }%
+ }%
+ {%
+% \end{macrocode}
+% Custom text provided in \cs{glsdisp}, in which case the formatting
+% should already be applied.
+% \begin{macrocode}
+ \glscustomtext
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
% Commands like \cs{glsifplural} are only used by the \cs{gls}-like
-% commands in the \styfmt{glossaries} package, but it might be useful
-% for the postlink hook to know if the user has used, say,
+% commands in the \sty{glossaries} package, but it might be useful
+% for the post-link hook to know if the user has used, say,
% \cs{glsfirst} or \cs{glsplural}. This can provide better
% consistency with the formatting of the \cs{gls}-like commands,
% even though they don't use \cs{glsentryfmt}.
%
+%\begin{macro}{\glsxtrifwasglslike}
+%\changes{1.49}{2022-10-14}{new}
+%For use in the post-link hook, this indicates whether or not
+%the hook follows a \cs{gls}-like command.
+% \begin{macrocode}
+\newcommand*{\glsxtrifwasglslike}[2]{#2}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrifwasglslikeandfirstuse}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrifwasglslikeandfirstuse}[2]{%
+ \glsxtrifwasglslike
+ {%
+ \glsxtrifwasfirstuse{#1}{#2}%
+ }{#2}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrifwassubsequentuse}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrifwassubsequentuse}[2]{%
+ \glsxtrifwasglslike
+ {%
+ \glsxtrifwasfirstuse{#2}{#1}%
+ }{#2}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrifallcaps}
+%\changes{1.49}{2022-10-14}{new}
+%Shortcut.
+% \begin{macrocode}
+\newcommand*{\glsxtrifallcaps}[2]{\glscapscase{#2}{#1}{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrcurrentfield}
+%\changes{1.49}{2022-10-14}{new}
+%Another placeholder to find out information about the calling
+%command. This will be empty for the \cs{gls} and
+%\cs{glsxtrfull} set of commands and will be the singular field otherwise.
+% \begin{macrocode}
+\newcommand*{\glsxtrcurrentfield}{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtr@shortfieldname}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtr@shortfieldname}{short}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrifwassubsequentorshort}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrifwassubsequentorshort}[2]{%
+ \glsxtrifwasglslike
+ {%
+ \glsxtrifwasfirstuse{#2}{#1}%
+ }%
+ {\ifdefequal\glsxtrcurrentfield\glsxtr@shortfieldname{#1}{#2}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\@gls@field@link}
% Redefine \cs{@gls@field@link} so that commands like \cs{glsfirst}
% can setup \cs{glsxtrifwasfirstuse} etc to allow the postlink hook
@@ -5514,6 +6829,10 @@ Dickimaw Books\\
%Save local setting.
% \begin{macrocode}
\@gls@save@glslocal
+% \end{macrocode}
+%Initialise preunset, prereset and postunset
+% \begin{macrocode}
+ \glsinitreunsets
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
\def\glscustomtext{#4}%
\@glsxtr@field@linkdefs
@@ -5536,6 +6855,7 @@ Dickimaw Books\\
% \begin{macrocode}
\let\@glsxtr@org@gls@\@gls@
\def\@gls@#1#2{%
+ \def\glsxtrcurrentfield{}%
\@glsxtr@record{#1}{#2}{glslink}%
\@glsxtr@org@gls@{#1}{#2}%
}%
@@ -5548,6 +6868,7 @@ Dickimaw Books\\
% \begin{macrocode}
\let\@glsxtr@org@glspl@\@glspl@
\def\@glspl@#1#2{%
+ \def\glsxtrcurrentfield{}%
\@glsxtr@record{#1}{#2}{glslink}%
\@glsxtr@org@glspl@{#1}{#2}%
}%
@@ -5560,6 +6881,7 @@ Dickimaw Books\\
% \begin{macrocode}
\let\@glsxtr@org@Gls@\@Gls@
\def\@Gls@#1#2{%
+ \def\glsxtrcurrentfield{}%
\@glsxtr@record{#1}{#2}{glslink}%
\@glsxtr@org@Gls@{#1}{#2}%
}%
@@ -5572,6 +6894,7 @@ Dickimaw Books\\
% \begin{macrocode}
\let\@glsxtr@org@Glspl@\@Glspl@
\def\@Glspl@#1#2{%
+ \def\glsxtrcurrentfield{}%
\@glsxtr@record{#1}{#2}{glslink}%
\@glsxtr@org@Glspl@{#1}{#2}%
}%
@@ -5584,6 +6907,7 @@ Dickimaw Books\\
% \begin{macrocode}
\let\@glsxtr@org@GLS@\@GLS@
\def\@GLS@#1#2{%
+ \def\glsxtrcurrentfield{}%
\@glsxtr@record{#1}{#2}{glslink}%
\@glsxtr@org@GLS@{#1}{#2}%
}%
@@ -5597,6 +6921,7 @@ Dickimaw Books\\
% \begin{macrocode}
\let\@glsxtr@org@GLSpl@\@GLSpl@
\def\@GLSpl@#1#2{%
+ \def\glsxtrcurrentfield{}%
\@glsxtr@record{#1}{#2}{glslink}%
\@glsxtr@org@GLSpl@{#1}{#2}%
}%
@@ -5611,12 +6936,13 @@ Dickimaw Books\\
%argument.
% \begin{macrocode}
\renewcommand*{\@glsdisp}[3][]{%
+ \def\glsxtrcurrentfield{}%
\@glsxtr@record{#1}{#2}{glslink}%
\glsdoifexists{#2}{%
\let\do@gls@link@checkfirsthyper\@gls@link@checkfirsthyper
\let\glsifplural\@secondoftwo
\let\glscapscase\@firstofthree
- \def\glscustomtext{#3}%
+ \def\glscustomtext{\glsxtrgenentrytextfmt{#3}}%
\def\glsinsert{}%
\def\@glo@text{\csname gls@\glstype @entryfmt\endcsname}%
\@gls@link[#1]{#2}{\@glo@text}%
@@ -5627,11 +6953,12 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
-%\begin{macro}{\@gls@@link@}
+%\begin{macro}{\@gls@@link}
%\changes{1.08}{2016-12-13}{added \cs{@glsxtr@record}}
%Redefine to include \cs{@glsxtr@record}
% \begin{macrocode}
\renewcommand*{\@gls@@link}[3][]{%
+ \def\glsxtrcurrentfield{}%
\@glsxtr@record{#1}{#2}{glslink}%
\glsdoifexistsordo{#2}%
{%
@@ -5641,8 +6968,9 @@ Dickimaw Books\\
% Post-link hook commands need initialising.
% \begin{macrocode}
\def\glscustomtext{#3}%
+ \def\glsinsert{}%
\@glsxtr@field@linkdefs
- \@gls@link[#1]{#2}{#3}%
+ \@gls@link[#1]{#2}{\glsxtrgenentrytextfmt{#3}}%
}%
{%
\glstextformat{#3}%
@@ -5678,7 +7006,128 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
-% Define a \gloskey[glslink]{wrgloss} key to determine whether to
+%\begin{macro}{\setupglslink}
+%\changes{1.49}{2022-10-14}{new}
+%Shortcut command to set glslink options.
+% \begin{macrocode}
+\newcommand*{\setupglslink}[1]{\setkeys{glslink}{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\setupglsadd}
+%\changes{1.49}{2022-10-14}{new}
+%Shortcut command to set glsadd options.
+% \begin{macrocode}
+\newcommand*{\setupglsadd}[1]{\setkeys{glsadd}{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@do@glsprereset}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@gls@do@glsprereset}[1]{}
+% \end{macrocode}
+%\end{macro}
+%
+% \begin{macrocode}
+\define@choicekey{glslink}{prereset}%
+[\@glsxtr@preresetval\@glsxtr@preresetnr]%
+{none,local,global}[local]%
+{%
+ \ifcase\@glsxtr@preresetnr
+ \let\@gls@do@glsprereset\@gobble
+ \or
+ \def\@gls@do@glsprereset{%
+ \let\@gls@link@postkeys@checkfirsthyper\do@gls@link@checkfirsthyper
+ \let\glsxtrifwasfirstuse\@firstoftwo\glslocalreset}%
+ \or
+ \def\@gls@do@glsprereset{%
+ \let\@gls@link@postkeys@checkfirsthyper\do@gls@link@checkfirsthyper
+ \let\glsxtrifwasfirstuse\@firstoftwo\glsreset}%
+ \fi
+}
+% \end{macrocode}
+%
+%\begin{macro}{\@gls@do@glspreunset}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@gls@do@glspreunset}[1]{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@glslink@hyper@update@hook}
+%\changes{1.49}{2022-10-14}{new}
+%This hook was only introduced to \sty{glossaries} v4.50, so if
+%isn't defined, need to patch the hyper key.
+% \begin{macrocode}
+\ifdef\@gls@glslink@hyper@update@hook
+{%
+ \renewcommand*{\@gls@glslink@hyper@update@hook}{%
+ \let\@gls@if@glslink@hyper@updated\@firstoftwo
+ }
+}
+{
+ \newcommand*{\@gls@glslink@hyper@update@hook}{%
+ \let\@gls@if@glslink@hyper@updated\@firstoftwo
+ }
+ \renewcommand*{\KV@glslink@hyper}[1]{%
+ \XKV@plfalse\XKV@sttrue
+ \XKV@checkchoice[\XKV@resa ]{#1}{true,false}%
+ {\csname KV@glslink@hyper\XKV@resa\endcsname\@gls@glslink@hyper@update@hook}%
+ }
+}
+% \end{macrocode}
+%\end{macro}
+%
+% \begin{macrocode}
+\define@choicekey{glslink}{preunset}%
+[\@glsxtr@preunsetval\@glsxtr@preunsetnr]%
+{none,local,global}[local]%
+{%
+ \ifcase\@glsxtr@preunsetnr
+ \let\@gls@do@glspreunset\@gobble
+ \or
+ \def\@gls@do@glspreunset{%
+ \let\@gls@link@postkeys@checkfirsthyper\do@gls@link@checkfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo\glslocalunset}%
+ \or
+ \def\@gls@do@glspreunset{%
+ \let\@gls@link@postkeys@checkfirsthyper\do@gls@link@checkfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo\glsunset}%
+ \fi
+}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\define@choicekey{glslink}{postunset}%
+[\@glsxtr@postunsetval\@glsxtr@postunsetnr]%
+{none,local,global}[global]%
+{%
+ \ifcase\@glsxtr@postunsetnr
+ \let\@gls@restore@glslocal\@gls@ignore@restore@glslocal
+ \or
+ \let\@gls@restore@glslocal\@gls@default@restore@glslocal
+ \KV@glslink@localtrue
+ \or
+ \let\@gls@restore@glslocal\@gls@default@restore@glslocal
+ \KV@glslink@localfalse
+ \fi
+}
+% \end{macrocode}
+%
+%\begin{macro}{\glsinitreunsets}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\glsinitreunsets}{%
+ \let\@gls@do@glspreunset\@gobble
+ \let\@gls@do@glsprereset\@gobble
+ \let\@gls@restore@glslocal\@gls@default@restore@glslocal
+ \@glsxtrbuffer@check@repeats
+}
+% \end{macrocode}
+%\end{macro}
+%
+% Define \gloskey[glslink]{wrgloss} key to determine whether to
% write the glossary information before or after the link text.
% \begin{macrocode}
\define@choicekey{glslink}{wrgloss}%
@@ -5713,6 +7162,29 @@ Dickimaw Books\\
%
%\end{macro}
%
+%\begin{macro}{\@glsxtr@current@textformat@csname}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@glsxtr@current@textformat@csname}{glstextformat}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsxtr@current@innertextformat@csname}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@glsxtr@current@innertextformat@csname}{glsxtrdefaultentrytextfmt}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrassignlinktextfmt}
+%\changes{1.49}{2022-10-14}{new}
+%Used to assign \cs{glstextformat} and \cs{glsxtrgenentrytextfmt}
+%in the post-link hook for \qt{postfootnote} abbreviation styles.
+% \begin{macrocode}
+\newcommand*{\glsxtrassignlinktextfmt}{}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\@glsxtr@local@textformat}
%\changes{1.30}{2018-04-25}{new}
%Provide a key to locally change the text format.
@@ -5721,6 +7193,24 @@ Dickimaw Books\\
\ifcsdef{#1}
{%
\letcs{\@glsxtr@local@textformat}{#1}%
+ \def\@glsxtr@current@textformat@csname{#1}%
+ }%
+ {%
+ \PackageError{glossaries-extra}{Unknown control sequence name `#1'}{}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsxtr@local@innertextformat}
+%\changes{1.49}{2022-10-14}{new}
+%Provide a key to locally change the inner text format.
+% \begin{macrocode}
+\define@key{glslink}{innertextformat}{%
+ \ifcsdef{#1}
+ {%
+ \letcs{\@glsxtr@local@innertextformat}{#1}%
+ \def\@glsxtr@current@innertextformat@csname{#1}%
}%
{%
\PackageError{glossaries-extra}{Unknown control sequence name `#1'}{}%
@@ -5832,13 +7322,31 @@ Dickimaw Books\\
%
%\begin{macro}{\glslinkwrcontent}
%\changes{1.48}{2021-11-22}{new}
-%This may resolve \href{https://www.dickimaw-books.com/bugtracker.php?key=189}{issue \#189}
-%but it may have unexpected consequences. This is currently provided
-%as a trial. If it causes a problem then redefine without the
-%grouping. If no issues are reported it will be added to the base
-%package.
+%\changes{1.49}{2022-10-14}{removed grouping}
+%This was defined to add grouping to resolve \href{https://www.dickimaw-books.com/bugtracker.php?key=189}{issue \#189}
+%but had unexpected consequences
+%(\href{https://www.dickimaw-books.com/bugtracker.php?key=194}{issue
+%\#194}) so the grouping has been removed and transferred to
+%\cs{glsencapwrcontent}.
% \begin{macrocode}
-\providecommand*{\glslinkwrcontent}[1]{{#1}}
+\providecommand*{\glslinkwrcontent}[1]{#1}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glslink@prefix@label}
+%\changes{1.49}{2022-10-14}{new}
+% Hyperlink using current prefix and label.
+% \begin{macrocode}
+\newcommand*{\@glslink@prefix@label}[1]{%
+ \@glslink{\glolinkprefix\glslabel}{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@noglslink@prefix@label}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@noglslink@prefix@label}[1]{%
+ \glsdonohyperlink{\glolinkprefix\glslabel}{#1}}
% \end{macrocode}
%\end{macro}
%
@@ -5867,6 +7375,10 @@ Dickimaw Books\\
% \begin{macrocode}
\@gls@save@glslocal
% \end{macrocode}
+%Initialise preunset, prereset and postunset
+% \begin{macrocode}
+ \glsinitreunsets
+% \end{macrocode}
%Save current value of \cs{glolinkprefix}:
% \begin{macrocode}
\let\@glsxtr@org@glolinkprefix\glolinkprefix
@@ -5874,6 +7386,12 @@ Dickimaw Books\\
%Initialise \cs{@glsxtr@local@textformat}
% \begin{macrocode}
\let\@glsxtr@local@textformat\relax
+ \def\@glsxtr@current@textformat@csname{glstextformat}%
+% \end{macrocode}
+%Initialise inner text format (1.49):
+% \begin{macrocode}
+ \let\@glsxtr@local@innertextformat\glsxtrdefaultentrytextfmt
+ \def\@glsxtr@current@innertextformat@csname{glsxtrdefaultentrytextfmt}%
% \end{macrocode}
% Initialise thevalue and theHvalue (v1.19).
% \begin{macrocode}
@@ -5909,6 +7427,11 @@ Dickimaw Books\\
\do@glsdisablehyperinlist
\do@gls@link@checkfirsthyper
% \end{macrocode}
+% Provide way of finding if hyper key has been explicitly set.
+% \begin{macrocode}
+ \let\@gls@if@glslink@hyper@updated\@secondoftwo
+ \let\@gls@link@postkeys@checkfirsthyper\relax
+% \end{macrocode}
%User hook before options are set (new to v1.26):
% \begin{macrocode}
\glslinkpresetkeys
@@ -5925,6 +7448,20 @@ Dickimaw Books\\
% \begin{macrocode}
\glslinkpostsetkeys
% \end{macrocode}
+%Reset/unset if required:
+% \begin{macrocode}
+ \@gls@do@glsprereset{#2}%
+ \@gls@do@glspreunset{#2}%
+% \end{macrocode}
+% If the hyper setting hasn't changed, and reset/unset option has
+% been used, need to perform another check.
+% \begin{macrocode}
+ \@gls@if@glslink@hyper@updated{}{\@gls@link@postkeys@checkfirsthyper}%
+% \end{macrocode}
+%Set inner text format (1.49):
+% \begin{macrocode}
+ \let\glsxtrgenentrytextfmt\@glsxtr@local@innertextformat
+% \end{macrocode}
% Check \gloskey[glslink]{thevalue} and \gloskey[glslink]{theHvalue}
% before saving (v1.19).
% \begin{macrocode}
@@ -5951,6 +7488,7 @@ Dickimaw Books\\
\ifcsdef{\@glsxtr@attrval}%
{%
\letcs{\@glsxtr@textformat}{\@glsxtr@attrval}%
+ \let\@glsxtr@current@textformat@csname\@glsxtr@attrval
}%
{%
\GlossariesExtraWarning{Unknown control sequence name
@@ -5966,6 +7504,15 @@ Dickimaw Books\\
\let\@glsxtr@textformat\@glsxtr@local@textformat
\fi
% \end{macrocode}
+%Setup formatting assignments for use in post-link hook.
+% \begin{macrocode}
+ \edef\glsxtrassignlinktextfmt{%
+ \noexpand\def\noexpand\glslabel{\expandonce\glslabel}%
+ \noexpand\letcs\noexpand\glstextformat{\@glsxtr@current@textformat@csname}%
+ \noexpand\letcs\noexpand\glsxtrgenentrytextfmt
+ {\@glsxtr@current@innertextformat@csname}%
+ }%
+% \end{macrocode}
% Encapsulate link text and indexing.
% \begin{macrocode}
\glslinkwrcontent
@@ -5974,22 +7521,22 @@ Dickimaw Books\\
% Do write if it should occur before the link text:
% \begin{macrocode}
\ifglsxtrinitwrglossbefore
- \@do@wrglossary{#2}%
+ \glsxtr@wrglossary@encap{#2}{\@do@wrglossary{#2}}%
\fi
% \end{macrocode}
% Do the link text:
% \begin{macrocode}
\ifKV@glslink@hyper
\ifglsxtr@hyperoutside
- \@glslink{\glolinkprefix\glslabel}{\@glsxtr@textformat{#3}}%
+ \@glslink@prefix@label{\@glsxtr@textformat{#3}}%
\else
- \@glsxtr@textformat{\@glslink{\glolinkprefix\glslabel}{#3}}%
+ \@glsxtr@textformat{\@glslink@prefix@label{#3}}%
\fi
\else
\ifglsxtr@hyperoutside
- \glsdonohyperlink{\glolinkprefix\glslabel}{\@glsxtr@textformat{#3}}%
+ \@noglslink@prefix@label{\@glsxtr@textformat{#3}}%
\else
- \@glsxtr@textformat{\glsdonohyperlink{\glolinkprefix\glslabel}{#3}}%
+ \@glsxtr@textformat{\@noglslink@prefix@label{#3}}%
\fi
\fi
% \end{macrocode}
@@ -5997,7 +7544,7 @@ Dickimaw Books\\
% \begin{macrocode}
\ifglsxtrinitwrglossbefore
\else
- \@do@wrglossary{#2}%
+ \glsxtr@wrglossary@encap{#2}{\@do@wrglossary{#2}}%
\fi
}%
% \end{macrocode}
@@ -6091,7 +7638,7 @@ Dickimaw Books\\
%\changes{1.37}{2018-11-30}{ensure that \cs{glsadd} performs indexing}
% \begin{macrocode}
\KV@glslink@noindexfalse
- \@@do@wrglossary{#2}%
+ \glsxtr@wrglossary@encap{#2}{\@@do@wrglossary{#2}}%
}%
\endgroup
}%
@@ -6111,14 +7658,17 @@ Dickimaw Books\\
%\end{macro}
%
%\begin{macro}{\@glsxtr@field@linkdefs}
-% Default settings for \cs{@gls@field@link}
+% Default settings for \cs{@gls@field@link}.
%\changes{0.3}{2015-12-02}{new}
+%\changes{1.49}{2022-10-14}{removed \cs{glsinsert}}
+%Note that from v1.49, \cs{glsinsert} is set with
+%\cs{glsxtrsaveinsert}.
% \begin{macrocode}
\newcommand*{\@glsxtr@field@linkdefs}{%
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsxtrifwasfirstuse\@secondoftwo
\let\glsifplural\@secondoftwo
\let\glscapscase\@firstofthree
- \let\glsinsert\@empty
}
% \end{macrocode}
%\end{macro}
@@ -6153,14 +7703,51 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtrsaveinsert}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glsxtrsaveinsert}\marg{entry-label}\marg{insert}
+%\end{definition}
+%The insert argument isn't saved in \cs{glsinsert} for the
+%\cs{glslike} commands, but provide a way to save it if it is
+%required for the post-link hook. The default is to set
+%\cs{glsinsert} to empty. This means that the insert won't appear in
+%the post-link hook with commands like \cs{glsxtrfull} for the
+%hyphen abbreviation styles. The entry label is provided in case the
+%insert should only be saved for certain entries, such as those with
+%a particular category.
+% \begin{macrocode}
+\newcommand*{\glsxtrsaveinsert}[2]{\def\glsinsert{}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrfullsaveinsert}
+%\changes{1.49}{2022-10-14}{new}
+%As above but specifically for commands like \cs{glsxtrfull}
+% \begin{macrocode}
+\newcommand*{\glsxtrfullsaveinsert}{\glsxtrsaveinsert}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\@glstext@}
%\changes{0.5.2}{2015-12-08}{added accessibility support}
%\changes{1.04}{2016-05-02}{set abbreviation and regular format}
% The abbreviation format may also need setting.
% \begin{macrocode}
\def\@glstext@#1#2[#3]{%
+ \def\glsxtrcurrentfield{text}%
\glsxtrassignfieldfont{#2}%
- \@gls@field@link{#1}{#2}{\@gls@field@font{\glsaccesstext{#2}#3}}%
+ \glsxtrsaveinsert{#2}{#3}%
+ \@gls@field@link{#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{text}%
+ {%
+ \@gls@field@font{\glsaccessfmttext{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\glsaccesstext{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6173,9 +7760,24 @@ Dickimaw Books\\
% The abbreviation format may also need setting.
% \begin{macrocode}
\def\@GLStext@#1#2[#3]{%
+ \def\glsxtrcurrentfield{text}%
\glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link[\let\glscapscase\@thirdofthree]{#1}{#2}%
- {\@gls@field@font{\GLSaccesstext{#2}\mfirstucMakeUppercase{#3}}}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{text}%
+ {%
+ \@gls@field@font{\GLSaccessfmttext{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \ifx\glscapscase\@thirdofthree
+ \@gls@field@font{\GLSaccesstext{#2}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#3}}}%
+ \else
+ \@gls@field@font{\glsaccesstext{#2}\glsxtrgenentrytextfmt{#3}}%
+ \fi
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6188,9 +7790,19 @@ Dickimaw Books\\
% The abbreviation format may also need setting.
% \begin{macrocode}
\def\@Glstext@#1#2[#3]{%
+ \def\glsxtrcurrentfield{text}%
\glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link[\let\glscapscase\@secondofthree]{#1}{#2}%
- {\@gls@field@font{\Glsaccesstext{#2}#3}}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{text}%
+ {%
+ \@gls@field@font{\Glsaccessfmttext{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\Glsaccesstext{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6215,16 +7827,27 @@ Dickimaw Books\\
% The abbreviation format may also need setting.
% \begin{macrocode}
\def\@glsfirst@#1#2[#3]{%
+ \def\glsxtrcurrentfield{first}%
\glsxtrassignfieldfont{#2}%
% \end{macrocode}
% Ensure that \cs{glsfirst} honours the \catattr{nohyperfirst} attribute.
%\changes{1.07}{2016-08-15}{added check for nohyperfirst attribute}
% \begin{macrocode}
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
[\let\glsxtrifwasfirstuse\@firstoftwo
\glsxtrchecknohyperfirst{#2}%
+ \glsxtr@check@complexstyle{#2}{#3}%
]{#1}{#2}%
- {\@gls@field@font{\glsaccessfirst{#2}#3}}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{first}%
+ {%
+ \@gls@field@font{\glsaccessfmtfirst{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\glsaccessfirst{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6237,17 +7860,29 @@ Dickimaw Books\\
% The abbreviation format may also need setting.
% \begin{macrocode}
\def\@Glsfirst@#1#2[#3]{%
+ \def\glsxtrcurrentfield{first}%
\glsxtrassignfieldfont{#2}%
% \end{macrocode}
% Ensure that \cs{Glsfirst} honours the \catattr{nohyperfirst} attribute.
%\changes{1.07}{2016-08-15}{added check for nohyperfirst attribute}
% \begin{macrocode}
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
[\let\glsxtrifwasfirstuse\@firstoftwo
\let\glscapscase\@secondofthree
\glsxtrchecknohyperfirst{#2}%
+ \glsxtr@check@complexstyle{#2}{#3}%
]%
- {#1}{#2}{\@gls@field@font{\Glsaccessfirst{#2}#3}}%
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{first}%
+ {%
+ \@gls@field@font{\Glsaccessfmtfirst{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\Glsaccessfirst{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6260,17 +7895,40 @@ Dickimaw Books\\
% The abbreviation format may also need setting.
% \begin{macrocode}
\def\@GLSfirst@#1#2[#3]{%
+ \def\glsxtrcurrentfield{first}%
\glsxtrassignfieldfont{#2}%
% \end{macrocode}
% Ensure that \cs{GLSfirst} honours the \catattr{nohyperfirst} attribute.
%\changes{1.07}{2016-08-15}{added check for nohyperfirst attribute}
% \begin{macrocode}
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
[\let\glsxtrifwasfirstuse\@firstoftwo
\let\glscapscase\@thirdofthree
\glsxtrchecknohyperfirst{#2}%
+ \glsxtr@check@complexstyle{#2}{#3}%
]%
- {#1}{#2}{\@gls@field@font{\GLSaccessfirst{#2}\mfirstucMakeUppercase{#3}}}%
+ {#1}{#2}%
+ {%
+ \ifx\glscapscase\@thirdofthree
+ \glsifapplyinnerfmtfield{#2}{first}%
+ {%
+ \@gls@field@font{\GLSaccessfmtfirst{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\GLSaccessfirst{#2}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#3}}}%
+ }%
+ \else
+ \glsifapplyinnerfmtfield{#2}{first}%
+ {%
+ \@gls@field@font{\glsaccessfmtfirst{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\glsaccessfirst{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ \fi
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6285,9 +7943,22 @@ Dickimaw Books\\
% The abbreviation format may also need setting.
% \begin{macrocode}
\def\@glsplural@#1#2[#3]{%
+ \def\glsxtrcurrentfield{text}%
\glsxtrassignfieldfont{#2}%
- \@gls@field@link[\let\glsifplural\@firstoftwo]{#1}{#2}%
- {\@gls@field@font{\glsaccessplural{#2}#3}}%
+ \glsxtrsaveinsert{#2}{#3}%
+ \@gls@field@link
+ [\let\glsifplural\@firstoftwo
+ \glsxtr@check@complexstyle{#2}{#3}%
+ ]{#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{plural}%
+ {%
+ \@gls@field@font{\glsaccessfmtplural{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\glsaccessplural{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6302,12 +7973,24 @@ Dickimaw Books\\
% The abbreviation format may also need setting.
% \begin{macrocode}
\def\@Glsplural@#1#2[#3]{%
+ \def\glsxtrcurrentfield{text}%
\glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
[\let\glsifplural\@firstoftwo
\let\glscapscase\@secondofthree
+ \glsxtr@check@complexstyle{#2}{#3}%
]%
- {#1}{#2}{\@gls@field@font{\Glsaccessplural{#2}#3}}%
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{plural}%
+ {%
+ \@gls@field@font{\Glsaccessfmtplural{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\Glsaccessplural{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6322,12 +8005,35 @@ Dickimaw Books\\
% The abbreviation format may also need setting.
% \begin{macrocode}
\def\@GLSplural@#1#2[#3]{%
+ \def\glsxtrcurrentfield{text}%
\glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
[\let\glsifplural\@firstoftwo
\let\glscapscase\@thirdofthree
+ \glsxtr@check@complexstyle{#2}{#3}%
]%
- {#1}{#2}{\@gls@field@font{\GLSaccessplural{#2}\mfirstucMakeUppercase{#3}}}%
+ {#1}{#2}%
+ {%
+ \ifx\glscapscase\@thirdofthree
+ \glsifapplyinnerfmtfield{#2}{plural}%
+ {%
+ \@gls@field@font{\GLSaccessfmtplural{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\GLSaccessplural{#2}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#3}}}%
+ }%
+ \else
+ \glsifapplyinnerfmtfield{#2}{plural}%
+ {%
+ \@gls@field@font{\glsaccessfmtplural{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\glsaccessplural{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ \fi
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6340,17 +8046,29 @@ Dickimaw Books\\
% The abbreviation format may also need setting.
% \begin{macrocode}
\def\@glsfirstplural@#1#2[#3]{%
+ \def\glsxtrcurrentfield{first}%
\glsxtrassignfieldfont{#2}%
% \end{macrocode}
% Ensure that \cs{glsfirstplural} honours the \catattr{nohyperfirst} attribute.
%\changes{1.07}{2016-08-15}{added check for nohyperfirst attribute}
% \begin{macrocode}
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
[\let\glsxtrifwasfirstuse\@firstoftwo
\let\glsifplural\@firstoftwo
\glsxtrchecknohyperfirst{#2}%
+ \glsxtr@check@complexstyle{#2}{#3}%
]%
- {#1}{#2}{\@gls@field@font{\glsaccessfirstplural{#2}#3}}%
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{firstpl}%
+ {%
+ \@gls@field@font{\glsaccessfmtfirstplural{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\glsaccessfirstplural{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6364,18 +8082,30 @@ Dickimaw Books\\
% The abbreviation format may also need setting.
% \begin{macrocode}
\def\@Glsfirstplural@#1#2[#3]{%
+ \def\glsxtrcurrentfield{first}%
\glsxtrassignfieldfont{#2}%
% \end{macrocode}
% Ensure that \cs{glsfirstplural} honours the \catattr{nohyperfirst} attribute.
%\changes{1.07}{2016-08-15}{added check for nohyperfirst attribute}
% \begin{macrocode}
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
[\let\glsxtrifwasfirstuse\@firstoftwo
\let\glsifplural\@firstoftwo
\let\glscapscase\@secondofthree
\glsxtrchecknohyperfirst{#2}%
+ \glsxtr@check@complexstyle{#2}{#3}%
]%
- {#1}{#2}{\@gls@field@font{\Glsaccessfirstplural{#2}#3}}%
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{firstpl}%
+ {%
+ \@gls@field@font{\Glsaccessfmtfirstplural{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\Glsaccessfirstplural{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6389,19 +8119,41 @@ Dickimaw Books\\
% The abbreviation format may also need setting.
% \begin{macrocode}
\def\@GLSfirstplural@#1#2[#3]{%
+ \def\glsxtrcurrentfield{first}%
\glsxtrassignfieldfont{#2}%
% \end{macrocode}
% Ensure that \cs{glsfirstplural} honours the \catattr{nohyperfirst} attribute.
%\changes{1.07}{2016-08-15}{added check for nohyperfirst attribute}
% \begin{macrocode}
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
[\let\glsxtrifwasfirstuse\@firstoftwo
\let\glsifplural\@firstoftwo
\let\glscapscase\@thirdofthree
\glsxtrchecknohyperfirst{#2}%
+ \glsxtr@check@complexstyle{#2}{#3}%
]%
- {#1}{#2}%
- {\@gls@field@font{\GLSaccessfirstplural{#2}\mfirstucMakeUppercase{#3}}}%
+ {#1}{#2}%
+ {%
+ \ifx\glscapscase\@thirdofthree
+ \glsifapplyinnerfmtfield{#2}{firstpl}%
+ {%
+ \@gls@field@font{\GLSaccessfmtfirstplural{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\GLSaccessfirstplural{#2}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#3}}}%
+ }%
+ \else
+ \glsifapplyinnerfmtfield{#2}{firstpl}%
+ {%
+ \@gls@field@font{\glsaccessfmtfirstplural{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\glsaccessfirstplural{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ \fi
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6413,8 +8165,19 @@ Dickimaw Books\\
% The abbreviation format may also need setting.
% \begin{macrocode}
\def\@glsname@#1#2[#3]{%
+ \def\glsxtrcurrentfield{name}%
\glsxtrassignfieldfont{#2}%
- \@gls@field@link{#1}{#2}{\@gls@field@font{\glsaccessname{#2}#3}}%
+ \glsxtrsaveinsert{#2}{#3}%
+ \@gls@field@link{#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{name}%
+ {%
+ \@gls@field@font{\glsaccessfmtname{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\glsaccessname{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6427,10 +8190,20 @@ Dickimaw Books\\
% The abbreviation format may also need setting.
% \begin{macrocode}
\def\@Glsname@#1#2[#3]{%
+ \def\glsxtrcurrentfield{name}%
\glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
- [\let\glscapscase\@secondoftwo]{#1}{#2}%
- {\@gls@field@font{\Glsaccessname{#2}#3}}%
+ [\let\glscapscase\@secondofthree]{#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{name}%
+ {%
+ \@gls@field@font{\Glsaccessfmtname{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\Glsaccessname{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6443,10 +8216,21 @@ Dickimaw Books\\
% The abbreviation format may also need setting.
% \begin{macrocode}
\def\@GLSname@#1#2[#3]{%
+ \def\glsxtrcurrentfield{name}%
\glsxtrassignfieldfont{#2}%
- \@gls@field@link[\let\glscapscase\@thirdoftwo]%
- {#1}{#2}%
- {\@gls@field@font{\GLSaccessname{#2}\mfirstucMakeUppercase{#3}}}%
+ \glsxtrsaveinsert{#2}{#3}%
+ \@gls@field@link[\let\glscapscase\@thirdofthree]%
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{name}%
+ {%
+ \@gls@field@font{\GLSaccessfmtname{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\GLSaccessname{#2}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#3}}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6456,8 +8240,19 @@ Dickimaw Books\\
%\changes{1.04}{2016-05-02}{set abbreviation and regular format}
% \begin{macrocode}
\def\@glsdesc@#1#2[#3]{%
+ \def\glsxtrcurrentfield{description}%
\glsxtrassignfieldfont{#2}%
- \@gls@field@link{#1}{#2}{\@gls@field@font{\glsaccessdesc{#2}#3}}%
+ \glsxtrsaveinsert{#2}{#3}%
+ \@gls@field@link{#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{desc}%
+ {%
+ \@gls@field@font{\glsaccessfmtdesc{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\glsaccessdesc{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6469,10 +8264,20 @@ Dickimaw Books\\
%\changes{1.04}{2016-05-02}{set abbreviation and regular format}
% \begin{macrocode}
\def\@Glsdesc@#1#2[#3]{%
+ \def\glsxtrcurrentfield{description}%
\glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
- [\let\glscapscase\@secondoftwo]{#1}{#2}%
- {\@gls@field@font{\Glsaccessdesc{#2}#3}}%
+ [\let\glscapscase\@secondofthree]{#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{desc}%
+ {%
+ \@gls@field@font{\Glsaccessfmtdesc{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\Glsaccessdesc{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6484,9 +8289,21 @@ Dickimaw Books\\
%\changes{1.04}{2016-05-02}{set abbreviation and regular format}
% \begin{macrocode}
\def\@GLSdesc@#1#2[#3]{%
+ \def\glsxtrcurrentfield{description}%
\glsxtrassignfieldfont{#2}%
- \@gls@field@link[\let\glscapscase\@thirdoftwo]%
- {#1}{#2}{\@gls@field@font{\GLSaccessdesc{#2}\mfirstucMakeUppercase{#3}}}%
+ \glsxtrsaveinsert{#2}{#3}%
+ \@gls@field@link[\let\glscapscase\@thirdofthree]%
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{desc}%
+ {%
+ \@gls@field@font{\GLSaccessfmtdesc{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\GLSaccessdesc{#2}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#3}}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6498,11 +8315,22 @@ Dickimaw Books\\
%\changes{1.04}{2016-05-02}{set abbreviation and regular format}
% \begin{macrocode}
\def\@glsdescplural@#1#2[#3]{%
+ \def\glsxtrcurrentfield{description}%
\glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
- [\let\glscapscase\@secondoftwo
+ [\let\glscapscase\@secondofthree
\let\glsifplural\@firstoftwo
- ]{#1}{#2}{\@gls@field@font{\glsaccessdescplural{#2}#3}}%
+ ]{#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{descplural}%
+ {%
+ \@gls@field@font{\glsaccessfmtdescpl{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\glsaccessdescplural{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6514,11 +8342,22 @@ Dickimaw Books\\
%\changes{1.04}{2016-05-02}{set abbreviation and regular format}
% \begin{macrocode}
\def\@Glsdescplural@#1#2[#3]{%
+ \def\glsxtrcurrentfield{description}%
\glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
- [\let\glscapscase\@secondoftwo
+ [\let\glscapscase\@secondofthree
\let\glsifplural\@firstoftwo
- ]{#1}{#2}{\@gls@field@font{\Glsaccessdescplural{#2}#3}}%
+ ]{#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{descplural}%
+ {%
+ \@gls@field@font{\Glsaccessfmtdescpl{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\Glsaccessdescplural{#2}#3}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6529,14 +8368,25 @@ Dickimaw Books\\
%\changes{0.5.2}{2015-12-08}{added accessibility support}
%\changes{1.04}{2016-05-02}{set abbreviation and regular format}
% \begin{macrocode}
-\def\@GLSdesc@#1#2[#3]{%
+\def\@GLSdescplural@#1#2[#3]{%
+ \def\glsxtrcurrentfield{description}%
\glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
- [\let\glscapscase\@thirdoftwo
+ [\let\glscapscase\@thirdofthree
\let\glsifplural\@firstoftwo
]%
- {#1}{#2}%
- {\@gls@field@font{\GLSaccessdescplural{#2}\mfirstucMakeUppercase{#3}}}%
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{descplural}%
+ {%
+ \@gls@field@font{\GLSaccessfmtdescplural{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\GLSaccessdescplural{#2}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#3}}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6546,8 +8396,19 @@ Dickimaw Books\\
%\changes{1.04}{2016-05-02}{set regular format}
% \begin{macrocode}
\def\@glssymbol@#1#2[#3]{%
+ \def\glsxtrcurrentfield{symbol}%
\glsxtrassignfieldfont{#2}%
- \@gls@field@link{#1}{#2}{\@gls@field@font{\glsaccesssymbol{#2}#3}}%
+ \glsxtrsaveinsert{#2}{#3}%
+ \@gls@field@link{#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{symbol}%
+ {%
+ \@gls@field@font{\glsaccessfmtsymbol{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\glsaccesssymbol{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6559,10 +8420,21 @@ Dickimaw Books\\
%\changes{1.04}{2016-05-02}{set regular format}
% \begin{macrocode}
\def\@Glssymbol@#1#2[#3]{%
+ \def\glsxtrcurrentfield{symbol}%
\glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
- [\let\glscapscase\@secondoftwo]%
- {#1}{#2}{\@gls@field@font{\Glsaccesssymbol{#2}#3}}%
+ [\let\glscapscase\@secondofthree]%
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{symbol}%
+ {%
+ \@gls@field@font{\Glsaccessfmtsymbol{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\Glsaccesssymbol{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6574,9 +8446,21 @@ Dickimaw Books\\
%\changes{1.04}{2016-05-02}{set regular format}
% \begin{macrocode}
\def\@GLSsymbol@#1#2[#3]{%
+ \def\glsxtrcurrentfield{symbol}%
\glsxtrassignfieldfont{#2}%
- \@gls@field@link[\let\glscapscase\@thirdoftwo]%
- {#1}{#2}{\@gls@field@font{\GLSaccesssymbol{#2}\mfirstucMakeUppercase{#3}}}%
+ \glsxtrsaveinsert{#2}{#3}%
+ \@gls@field@link[\let\glscapscase\@thirdofthree]%
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{symbol}%
+ {%
+ \@gls@field@font{\GLSaccessfmtsymbol{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\GLSaccesssymbol{#2}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#3}}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6588,11 +8472,22 @@ Dickimaw Books\\
%\changes{1.04}{2016-05-02}{set regular format}
% \begin{macrocode}
\def\@glssymbolplural@#1#2[#3]{%
+ \def\glsxtrcurrentfield{symbol}%
\glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
- [\let\glscapscase\@secondoftwo
+ [\let\glscapscase\@secondofthree
\let\glsifplural\@firstoftwo
- ]{#1}{#2}{\@gls@field@font{\glsaccesssymbolplural{#2}#3}}%
+ ]{#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{symbolplural}%
+ {%
+ \@gls@field@font{\glsaccessfmtsymbolplural{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\glsaccesssymbolplural{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6604,11 +8499,22 @@ Dickimaw Books\\
%\changes{1.04}{2016-05-02}{set regular format}
% \begin{macrocode}
\def\@Glssymbolplural@#1#2[#3]{%
+ \def\glsxtrcurrentfield{symbol}%
\glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
- [\let\glscapscase\@secondoftwo
+ [\let\glscapscase\@secondofthree
\let\glsifplural\@firstoftwo
- ]{#1}{#2}{\@gls@field@font{\Glsaccesssymbolplural{#2}#3}}%
+ ]{#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{symbolplural}%
+ {%
+ \@gls@field@font{\Glsaccessfmtsymbolplural{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\Glsaccesssymbolplural{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6619,14 +8525,48 @@ Dickimaw Books\\
%\changes{0.5.2}{2015-12-08}{added accessibility support}
%\changes{1.04}{2016-05-02}{set regular format}
% \begin{macrocode}
-\def\@GLSsymbol@#1#2[#3]{%
+\def\@GLSsymbolplural@#1#2[#3]{%
+ \def\glsxtrcurrentfield{symbol}%
\glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
- [\let\glscapscase\@thirdoftwo
+ [\let\glscapscase\@thirdofthree
\let\glsifplural\@firstoftwo
]%
- {#1}{#2}%
- {\@gls@field@font{\GLSaccesssymbolplural{#2}\mfirstucMakeUppercase{#3}}}%
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{symbolplural}%
+ {%
+ \@gls@field@font{\GLSaccessfmtsymbolplural{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\GLSaccesssymbolplural{#2}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#3}}}%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsuseri@}
+% User 1 field.
+%\changes{1.49}{2022-10-14}{added redefinition}
+% \begin{macrocode}
+\def\@glsuseri@#1#2[#3]{%
+ \def\glsxtrcurrentfield{user1}%
+ \glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
+ \@gls@field@link
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{useri}%
+ {%
+ \@gls@field@font{\glsaccessfmtuseri{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\glsaccessuseri{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6637,10 +8577,20 @@ Dickimaw Books\\
%\changes{1.04}{2016-05-02}{set regular format}
% \begin{macrocode}
\def\@Glsuseri@#1#2[#3]{%
+ \def\glsxtrcurrentfield{user1}%
\glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
- [\let\glscapscase\@secondoftwo]{#1}{#2}%
- {\@gls@field@font{\Glsentryuseri{#2}#3}}%
+ [\let\glscapscase\@secondofthree]{#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{useri}%
+ {%
+ \@gls@field@font{\Glsaccessfmtuseri{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\Glsaccessuseri{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6651,9 +8601,48 @@ Dickimaw Books\\
%\changes{1.04}{2016-05-02}{set regular format}
% \begin{macrocode}
\def\@GLSuseri@#1#2[#3]{%
+ \def\glsxtrcurrentfield{user1}%
\glsxtrassignfieldfont{#2}%
- \@gls@field@link[\let\glscapscase\@thirdoftwo]%
- {#1}{#2}{\@gls@field@font{\mfirstucMakeUppercase{\glsentryuseri{#2}#3}}}%
+ \glsxtrsaveinsert{#2}{#3}%
+ \@gls@field@link[\let\glscapscase\@thirdofthree]%
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{useri}%
+ {%
+ \@gls@field@font{\GLSaccessfmtuseri{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \ifx\glscapscase\@thirdofthree
+ \@gls@field@font{\GLSaccessuseri{#2}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#3}}}%
+ \else
+ \@gls@field@font{\glsaccessuseri{#2}\glsxtrgenentrytextfmt{#3}}%
+ \fi
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsuserii@}
+% User 2 field.
+%\changes{1.49}{2022-10-14}{added redefinition}
+% \begin{macrocode}
+\def\@glsuserii@#1#2[#3]{%
+ \def\glsxtrcurrentfield{user2}%
+ \glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
+ \@gls@field@link
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{userii}%
+ {%
+ \@gls@field@font{\glsaccessfmtuserii{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\glsaccessuserii{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6664,10 +8653,21 @@ Dickimaw Books\\
%\changes{1.04}{2016-05-02}{set regular format}
% \begin{macrocode}
\def\@Glsuserii@#1#2[#3]{%
+ \def\glsxtrcurrentfield{user2}%
\glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
- [\let\glscapscase\@secondoftwo]%
- {#1}{#2}{\@gls@field@font{\Glsentryuserii{#2}#3}}%
+ [\let\glscapscase\@secondofthree]%
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{userii}%
+ {%
+ \@gls@field@font{\Glsaccessfmtuserii{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\Glsaccessuserii{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6678,9 +8678,48 @@ Dickimaw Books\\
%\changes{1.04}{2016-05-02}{set regular format}
% \begin{macrocode}
\def\@GLSuserii@#1#2[#3]{%
+ \def\glsxtrcurrentfield{user2}%
\glsxtrassignfieldfont{#2}%
- \@gls@field@link[\let\glscapscase\@thirdoftwo]%
- {#1}{#2}{\@gls@field@font{\mfirstucMakeUppercase{\glsentryuserii{#2}#3}}}%
+ \glsxtrsaveinsert{#2}{#3}%
+ \@gls@field@link[\let\glscapscase\@thirdofthree]%
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{userii}%
+ {%
+ \@gls@field@font{\GLSaccessfmtuserii{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \ifx\glscapscase\@thirdofthree
+ \@gls@field@font{\GLSaccessuserii{#2}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#3}}}%
+ \else
+ \@gls@field@font{\glsaccessuserii{#2}\glsxtrgenentrytextfmt{#3}}%
+ \fi
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsuseriii@}
+% User 3 field.
+%\changes{1.49}{2022-10-14}{added redefinition}
+% \begin{macrocode}
+\def\@glsuseriii@#1#2[#3]{%
+ \def\glsxtrcurrentfield{user3}%
+ \glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
+ \@gls@field@link
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{useriii}%
+ {%
+ \@gls@field@font{\glsaccessfmtuseriii{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\glsaccessuseriii{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6691,10 +8730,21 @@ Dickimaw Books\\
%\changes{1.04}{2016-05-02}{set regular format}
% \begin{macrocode}
\def\@Glsuseriii@#1#2[#3]{%
+ \def\glsxtrcurrentfield{user3}%
\glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
- [\let\glscapscase\@secondoftwo]%
- {#1}{#2}{\@gls@field@font{\Glsentryuseriii{#2}#3}}%
+ [\let\glscapscase\@secondofthree]%
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{useriii}%
+ {%
+ \@gls@field@font{\Glsaccessfmtuseriii{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\Glsaccessuseriii{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6705,9 +8755,48 @@ Dickimaw Books\\
%\changes{1.04}{2016-05-02}{set regular format}
% \begin{macrocode}
\def\@GLSuseriii@#1#2[#3]{%
+ \def\glsxtrcurrentfield{user3}%
\glsxtrassignfieldfont{#2}%
- \@gls@field@link[\let\glscapscase\@thirdoftwo]%
- {#1}{#2}{\@gls@field@font{\mfirstucMakeUppercase{\glsentryuseriii{#2}#3}}}%
+ \glsxtrsaveinsert{#2}{#3}%
+ \@gls@field@link[\let\glscapscase\@thirdofthree]%
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{useriii}%
+ {%
+ \@gls@field@font{\GLSaccessfmtuseriii{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \ifx\glscapscase\@thirdofthree
+ \@gls@field@font{\GLSaccessuseriii{#2}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#3}}}%
+ \else
+ \@gls@field@font{\glsaccessuseriii{#2}\glsxtrgenentrytextfmt{#3}}%
+ \fi
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsuseriv@}
+% User 4 field.
+%\changes{1.49}{2022-10-14}{added redefinition}
+% \begin{macrocode}
+\def\@glsuseriv@#1#2[#3]{%
+ \def\glsxtrcurrentfield{user4}%
+ \glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
+ \@gls@field@link
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{useriv}%
+ {%
+ \@gls@field@font{\glsaccessfmtuseriv{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\glsaccessuseriv{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6718,10 +8807,21 @@ Dickimaw Books\\
%\changes{1.04}{2016-05-02}{set regular format}
% \begin{macrocode}
\def\@Glsuseriv@#1#2[#3]{%
+ \def\glsxtrcurrentfield{user4}%
\glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
- [\let\glscapscase\@secondoftwo]%
- {#1}{#2}{\@gls@field@font{\Glsentryuseriv{#2}#3}}%
+ [\let\glscapscase\@secondofthree]%
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{useriv}%
+ {%
+ \@gls@field@font{\Glsaccessfmtuseriv{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\Glsaccessuseriv{#2}#3}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6732,10 +8832,48 @@ Dickimaw Books\\
%\changes{1.04}{2016-05-02}{set regular format}
% \begin{macrocode}
\def\@GLSuseriv@#1#2[#3]{%
+ \def\glsxtrcurrentfield{user4}%
\glsxtrassignfieldfont{#2}%
- \@gls@field@link[\let\glscapscase\@thirdoftwo]%
- {#1}{#2}%
- {\@gls@field@font{\mfirstucMakeUppercase{\glsentryuseriv{#2}#3}}}%
+ \glsxtrsaveinsert{#2}{#3}%
+ \@gls@field@link[\let\glscapscase\@thirdofthree]%
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{useriv}%
+ {%
+ \@gls@field@font{\GLSaccessfmtuseriv{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \ifx\glscapscase\@thirdofthree
+ \@gls@field@font{\GLSaccessuseriv{#2}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#3}}}%
+ \else
+ \@gls@field@font{\glsaccessuseriv{#2}\glsxtrgenentrytextfmt{#3}}%
+ \fi
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsuserv@}
+% User 5 field.
+%\changes{1.49}{2022-10-14}{added redefinition}
+% \begin{macrocode}
+\def\@glsuserv@#1#2[#3]{%
+ \def\glsxtrcurrentfield{user5}%
+ \glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
+ \@gls@field@link
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{userv}%
+ {%
+ \@gls@field@font{\glsaccessfmtuserv{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\glsaccessuserv{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6746,10 +8884,21 @@ Dickimaw Books\\
%\changes{1.04}{2016-05-02}{set regular format}
% \begin{macrocode}
\def\@Glsuserv@#1#2[#3]{%
+ \def\glsxtrcurrentfield{user5}%
\glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
- [\let\glscapscase\@secondoftwo]%
- {#1}{#2}{\@gls@field@font{\Glsentryuserv{#2}#3}}%
+ [\let\glscapscase\@secondofthree]%
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{userv}%
+ {%
+ \@gls@field@font{\Glsfmtfield{#3}{\glsxtrgenentrytextfmt}{#2}{userv}}%
+ }%
+ {%
+ \@gls@field@font{\Glsentryuserv{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6760,9 +8909,48 @@ Dickimaw Books\\
%\changes{1.04}{2016-05-02}{set regular format}
% \begin{macrocode}
\def\@GLSuserv@#1#2[#3]{%
+ \def\glsxtrcurrentfield{user5}%
\glsxtrassignfieldfont{#2}%
- \@gls@field@link[\let\glscapscase\@thirdoftwo]%
- {#1}{#2}{\@gls@field@font{\mfirstucMakeUppercase{\glsentryuserv{#2}#3}}}%
+ \glsxtrsaveinsert{#2}{#3}%
+ \@gls@field@link[\let\glscapscase\@thirdofthree]%
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{userv}%
+ {%
+ \@gls@field@font{\GLSaccessfmtuserv{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \ifx\glscapscase\@thirdofthree
+ \@gls@field@font{\GLSaccessuserv{#2}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#3}}}%
+ \else
+ \@gls@field@font{\glsaccessuserv{#2}\glsxtrgenentrytextfmt{#3}}%
+ \fi
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsuservi@}
+% User 6 field.
+%\changes{1.49}{2022-10-14}{added redefinition}
+% \begin{macrocode}
+\def\@glsuservi@#1#2[#3]{%
+ \def\glsxtrcurrentfield{user6}%
+ \glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
+ \@gls@field@link
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{uservi}%
+ {%
+ \@gls@field@font{\glsaccessfmtuservi{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\glsaccessuservi{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6773,10 +8961,21 @@ Dickimaw Books\\
%\changes{1.04}{2016-05-02}{set regular format}
% \begin{macrocode}
\def\@Glsuservi@#1#2[#3]{%
+ \def\glsxtrcurrentfield{user6}%
\glsxtrassignfieldfont{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\@gls@field@link
- [\let\glscapscase\@secondoftwo]%
- {#1}{#2}{\@gls@field@font{\Glsentryuservi{#2}#3}}%
+ [\let\glscapscase\@secondofthree]%
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{uservi}%
+ {%
+ \@gls@field@font{\Glsaccessfmtuservi{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \@gls@field@font{\Glsaccessuservi{#2}\glsxtrgenentrytextfmt{#3}}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6787,9 +8986,25 @@ Dickimaw Books\\
%\changes{1.04}{2016-05-02}{set regular format}
% \begin{macrocode}
\def\@GLSuservi@#1#2[#3]{%
+ \def\glsxtrcurrentfield{user6}%
\glsxtrassignfieldfont{#2}%
- \@gls@field@link[\let\glscapscase\@thirdoftwo]%
- {#1}{#2}{\@gls@field@font{\mfirstucMakeUppercase{\glsentryuservi{#2}#3}}}%
+ \glsxtrsaveinsert{#2}{#3}%
+ \@gls@field@link[\let\glscapscase\@thirdofthree]%
+ {#1}{#2}%
+ {%
+ \glsifapplyinnerfmtfield{#2}{uservi}%
+ {%
+ \@gls@field@font{\GLSaccessfmtuservi{#3}{\glsxtrgenentrytextfmt}{#2}}%
+ }%
+ {%
+ \ifx\glscapscase\@thirdofthree
+ \@gls@field@font{\GLSaccessuservi{#2}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#3}}}%
+ \else
+ \@gls@field@font{\glsaccessuservi{#2}\glsxtrgenentrytextfmt{#3}}%
+ \fi
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -6819,15 +9034,19 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%The following acr commands don't support innertextformat.
+%
%\begin{macro}{\@acrshort}
%\changes{0.3}{2015-12-02}{added redefinition}
% No case change.
% \begin{macrocode}
\def\@acrshort#1#2[#3]{%
+ \def\glsxtrcurrentfield{short}%
\@glsxtr@base@acrcmd\acrshort\glsxtrshort
\glsdoifexists{#2}%
{%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsxtrifwasfirstuse\@secondoftwo
\let\glsifplural\@secondoftwo
\let\glscapscase\@firstofthree
@@ -6847,10 +9066,12 @@ Dickimaw Books\\
% First letter uppercase.
% \begin{macrocode}
\def\@Acrshort#1#2[#3]{%
+ \def\glsxtrcurrentfield{short}%
\@glsxtr@base@acrcmd\Acrshort\Glsxtrshort
\glsdoifexists{#2}%
{%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsxtrifwasfirstuse\@secondoftwo
\let\glsifplural\@secondoftwo
\let\glscapscase\@secondofthree
@@ -6870,16 +9091,18 @@ Dickimaw Books\\
% All uppercase.
% \begin{macrocode}
\def\@ACRshort#1#2[#3]{%
+ \def\glsxtrcurrentfield{short}%
\@glsxtr@base@acrcmd\ACRshort\GLSxtrshort
\glsdoifexists{#2}%
{%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsxtrifwasfirstuse\@secondoftwo
\let\glsifplural\@secondoftwo
\let\glscapscase\@thirdofthree
\let\glsinsert\@empty
\def\glscustomtext{%
- \mfirstucMakeUppercase{\acronymfont{\glsaccessshort{#2}}#3}%
+ \glsuppercase{\acronymfont{\glsaccessshort{#2}}#3}%
}%
\@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
}%
@@ -6893,10 +9116,12 @@ Dickimaw Books\\
% No case change.
% \begin{macrocode}
\def\@acrshortpl#1#2[#3]{%
+ \def\glsxtrcurrentfield{short}%
\@glsxtr@base@acrcmd\acrshortpl\glsxtrshortpl
\glsdoifexists{#2}%
{%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsxtrifwasfirstuse\@secondoftwo
\let\glsifplural\@firstoftwo
\let\glscapscase\@firstofthree
@@ -6916,10 +9141,12 @@ Dickimaw Books\\
% First letter uppercase.
% \begin{macrocode}
\def\@Acrshortpl#1#2[#3]{%
+ \def\glsxtrcurrentfield{short}%
\@glsxtr@base@acrcmd\Acrshortpl\Glsxtrshortpl
\glsdoifexists{#2}%
{%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsxtrifwasfirstuse\@secondoftwo
\let\glsifplural\@firstoftwo
\let\glscapscase\@secondofthree
@@ -6939,16 +9166,18 @@ Dickimaw Books\\
% All uppercase.
% \begin{macrocode}
\def\@ACRshortpl#1#2[#3]{%
+ \def\glsxtrcurrentfield{short}%
\@glsxtr@base@acrcmd\ACRshortpl\GLSxtrshortpl
\glsdoifexists{#2}%
{%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsxtrifwasfirstuse\@secondoftwo
\let\glsifplural\@firstoftwo
\let\glscapscase\@thirdofthree
\let\glsinsert\@empty
\def\glscustomtext{%
- \mfirstucMakeUppercase{\acronymfont{\glsaccessshortpl{#2}}#3}%
+ \glsuppercase{\acronymfont{\glsaccessshortpl{#2}}#3}%
}%
\@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
}%
@@ -6962,10 +9191,12 @@ Dickimaw Books\\
% No case change.
% \begin{macrocode}
\def\@acrlong#1#2[#3]{%
+ \def\glsxtrcurrentfield{long}%
\@glsxtr@base@acrcmd\acrlong\glsxtrlong
\glsdoifexists{#2}%
{%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsxtrifwasfirstuse\@secondoftwo
\let\glsifplural\@secondoftwo
\let\glscapscase\@firstofthree
@@ -6985,10 +9216,12 @@ Dickimaw Books\\
% First letter uppercase.
% \begin{macrocode}
\def\@Acrlong#1#2[#3]{%
+ \def\glsxtrcurrentfield{long}%
\@glsxtr@base@acrcmd\Acrlong\Glsxtrlong
\glsdoifexists{#2}%
{%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsxtrifwasfirstuse\@secondoftwo
\let\glsifplural\@secondoftwo
\let\glscapscase\@secondofthree
@@ -7008,16 +9241,18 @@ Dickimaw Books\\
% All uppercase.
% \begin{macrocode}
\def\@ACRlong#1#2[#3]{%
+ \def\glsxtrcurrentfield{long}%
\@glsxtr@base@acrcmd\ACRlong\GLSxtrlong
\glsdoifexists{#2}%
{%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsxtrifwasfirstuse\@secondoftwo
\let\glsifplural\@secondoftwo
\let\glscapscase\@thirdofthree
\let\glsinsert\@empty
\def\glscustomtext{%
- \mfirstucMakeUppercase{\acronymfont{\glsaccesslong{#2}}#3}%
+ \glsuppercase{\acronymfont{\glsaccesslong{#2}}#3}%
}%
\@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
}%
@@ -7031,10 +9266,12 @@ Dickimaw Books\\
% No case change.
% \begin{macrocode}
\def\@acrlongpl#1#2[#3]{%
+ \def\glsxtrcurrentfield{long}%
\@glsxtr@base@acrcmd\acrlongpl\glsxtrlongpl
\glsdoifexists{#2}%
{%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsxtrifwasfirstuse\@secondoftwo
\let\glsifplural\@firstoftwo
\let\glscapscase\@firstofthree
@@ -7054,10 +9291,12 @@ Dickimaw Books\\
% First letter uppercase.
% \begin{macrocode}
\def\@Acrlongpl#1#2[#3]{%
+ \def\glsxtrcurrentfield{long}%
\@glsxtr@base@acrcmd\Acrlongpl\Glsxtrlongpl
\glsdoifexists{#2}%
{%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsxtrifwasfirstuse\@secondoftwo
\let\glsifplural\@firstoftwo
\let\glscapscase\@secondofthree
@@ -7077,16 +9316,18 @@ Dickimaw Books\\
% All uppercase.
% \begin{macrocode}
\def\@ACRlongpl#1#2[#3]{%
+ \def\glsxtrcurrentfield{long}%
\@glsxtr@base@acrcmd\ACRlongpl\GLSxtrlongpl
\glsdoifexists{#2}%
{%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsxtrifwasfirstuse\@secondoftwo
\let\glsifplural\@firstoftwo
\let\glscapscase\@thirdofthree
\let\glsinsert\@empty
\def\glscustomtext{%
- \mfirstucMakeUppercase{\acronymfont{\glsaccesslongpl{#2}}#3}%
+ \glsuppercase{\acronymfont{\glsaccesslongpl{#2}}#3}%
}%
\@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
}%
@@ -7106,6 +9347,7 @@ Dickimaw Books\\
%\changes{1.42}{2020-02-03}{added redefinition}
% \begin{macrocode}
\def\@acrfull#1#2[#3]{%
+ \def\glsxtrcurrentfield{}%
\@glsxtr@base@acrcmd\acrfull\glsxtrfull
\acrfullfmt{#1}{#2}{#3}%
}
@@ -7116,6 +9358,7 @@ Dickimaw Books\\
%\changes{1.42}{2020-02-03}{added redefinition}
% \begin{macrocode}
\def\@Acrfull#1#2[#3]{%
+ \def\glsxtrcurrentfield{}%
\@glsxtr@base@acrcmd\Acrfull\Glsxtrfull
\Acrfullfmt{#1}{#2}{#3}%
}
@@ -7126,6 +9369,7 @@ Dickimaw Books\\
%\changes{1.42}{2020-02-03}{added redefinition}
% \begin{macrocode}
\def\@ACRfull#1#2[#3]{%
+ \def\glsxtrcurrentfield{}%
\@glsxtr@base@acrcmd\ACRfull\GLSxtrfull
\ACRfullfmt{#1}{#2}{#3}%
}
@@ -7136,6 +9380,7 @@ Dickimaw Books\\
%\changes{1.42}{2020-02-03}{added redefinition}
% \begin{macrocode}
\def\@acrfullpl#1#2[#3]{%
+ \def\glsxtrcurrentfield{}%
\@glsxtr@base@acrcmd\acrfullpl\glsxtrfullpl
\acrfullplfmt{#1}{#2}{#3}%
}
@@ -7146,6 +9391,7 @@ Dickimaw Books\\
%\changes{1.42}{2020-02-03}{added redefinition}
% \begin{macrocode}
\def\@Acrfullpl#1#2[#3]{%
+ \def\glsxtrcurrentfield{}%
\@glsxtr@base@acrcmd\Acrfullpl\Glsxtrfullpl
\Acrfullplfmt{#1}{#2}{#3}%
}
@@ -7156,6 +9402,7 @@ Dickimaw Books\\
%\changes{1.42}{2020-02-03}{added redefinition}
% \begin{macrocode}
\def\@ACRfullpl#1#2[#3]{%
+ \def\glsxtrcurrentfield{}%
\@glsxtr@base@acrcmd\ACRfullpl\GLSxtrfullpl
\ACRfullplfmt{#1}{#2}{#3}%
}
@@ -7177,10 +9424,11 @@ Dickimaw Books\\
\gls@assign@field{#2}{\@glo@label}{#1}{\@glo@tmp}%
}%
\newcommand*{#3}[1]{\@gls@entry@field{##1}{#1}}%
- \newcommand*{#4}[1]{\@Gls@entry@field{##1}{#1}}%
+ \newcommand*{#4}[1]{\@Glsentryfield{##1}{#1}}%
% \end{macrocode}
-% Now for the commands with links. First the version with no case
-% change (same as before):
+% Now for the commands with links. These currently don't support the
+% inner text format.
+% First the version with no case change:
% \begin{macrocode}
\ifcsdef{@gls@user@#1@}%
{%
@@ -7197,7 +9445,10 @@ Dickimaw Books\\
{\csuse{@gls@user@#1@}{##1}{##2}}%
{\csuse{@gls@user@#1@}{##1}{##2}[]}}%
\csdef{@gls@user@#1@}##1##2[##3]{%
- \@gls@field@link{##1}{##2}{#3{##2}##3}%
+ \def\glsxtrcurrentfield{#1}%
+ \glsxtrassignfieldfont{##2}%
+ \glsxtrsaveinsert{##2}{##3}%
+ \@gls@field@link{##1}{##2}{\@gls@field@font{#3{##2}##3}}%
}%
\newrobustcmd*{#5}{%
\expandafter\@gls@hyp@opt\csname @gls@user@#1\endcsname}%
@@ -7221,8 +9472,11 @@ Dickimaw Books\\
{\csuse{@Gls@user@#1@}{##1}{##2}}%
{\csuse{@Gls@user@#1@}{##1}{##2}[]}}%
\csdef{@Gls@user@#1@}##1##2[##3]{%
+ \def\glsxtrcurrentfield{#1}%
+ \glsxtrassignfieldfont{##2}%
+ \glsxtrsaveinsert{##2}{##3}%
\@gls@field@link[\let\glscapscase\@secondofthree]%
- {##1}{##2}{#4{##2}##3}%
+ {##1}{##2}{\@gls@field@font{#4{##2}##3}}%
}%
\newrobustcmd*{#6}{%
\expandafter\@gls@hyp@opt\csname @Gls@user@#1\endcsname}%
@@ -7245,12 +9499,21 @@ Dickimaw Books\\
{\csuse{@GLS@user@#1@}{##1}{##2}}%
{\csuse{@GLS@user@#1@}{##1}{##2}[]}}%
\csdef{@GLS@user@#1@}##1##2[##3]{%
+ \def\glsxtrcurrentfield{#1}%
+ \glsxtrassignfieldfont{##2}%
+ \glsxtrsaveinsert{##2}{##3}%
\@gls@field@link[\let\glscapscase\@thirdofthree]%
- {##1}{##2}{\mfirstucMakeUppercase{#3{##2}##3}}%
+ {##1}{##2}{\@gls@field@font{\glsuppercase{#3{##2}##3}}}%
}%
\newrobustcmd*{#7}{%
\expandafter\@gls@hyp@opt\csname @GLS@user@#1\endcsname}%
}%
+% \end{macrocode}
+%Add mappings.
+% \begin{macrocode}
+ \glsmfuaddmap{#3}{#4}%
+ \glsmfuaddmap{#5}{#6}%
+ \glsmfublocker{#7}%
}%
{%
\PackageError{glossaries-extra}{Key `#1' already exists}{}%
@@ -7260,13 +9523,22 @@ Dickimaw Books\\
%\end{macro}
%
%\begin{macro}{\@gls@link@nocheckfirsthyper}
-% Old versions of \styfmt{glossaries} don't define
+% Old versions of \sty{glossaries} don't define
% this, so provide it just in case it hasn't been defined.
% \begin{macrocode}
\providecommand*{\@gls@link@nocheckfirsthyper}{}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\@gls@link@postkeys@checkfirsthyper}
+%\changes{1.49}{2022-10-14}{new}
+%Need another check after preunset and postunset options have been
+%applied.
+% \begin{macrocode}
+\newcommand*{\@gls@link@postkeys@checkfirsthyper}{}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\@gls@link@checkfirsthyper}
% Modify check to determine if the hyperlink should be automatically
% suppressed, but save the original in case the acronyms are restored.
@@ -7291,17 +9563,21 @@ Dickimaw Books\\
{\let\glsxtrifwasfirstuse\@secondoftwo}
{\let\glsxtrifwasfirstuse\@firstoftwo}%
% \end{macrocode}
+%Similarly for \cs{glsxtrifwasglslike}
+% \begin{macrocode}
+ \let\glsxtrifwasglslike\@firstoftwo
+% \end{macrocode}
% Store the category label for convenience.
%\changes{1.46}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}}
% \begin{macrocode}
\protected@edef\glscategorylabel{\glscategory{\glslabel}}%
- \ifglsused{\glslabel}%
+ \glsxtrifwasfirstuse
{%
- \glsifcategoryattribute{\glscategorylabel}{nohypernext}{true}%
+ \glsifcategoryattribute{\glscategorylabel}{nohyperfirst}{true}%
{\KV@glslink@hyperfalse}{}%
}%
{%
- \glsifcategoryattribute{\glscategorylabel}{nohyperfirst}{true}%
+ \glsifcategoryattribute{\glscategorylabel}{nohypernext}{true}%
{\KV@glslink@hyperfalse}{}%
}%
\glslinkcheckfirsthyperhook
@@ -7310,7 +9586,7 @@ Dickimaw Books\\
%\end{macro}
%
%\begin{macro}{\do@glsdisablehyperinlist}
-% This command was introduced in \styfmt{glossaries} v4.19. If it
+% This command was introduced in \sty{glossaries} v4.19. If it
% hasn't been defined, we're using an earlier version, in which case
% the \catattr{nohyper} attribute can't be implemented.
% \begin{macrocode}
@@ -7353,6 +9629,25 @@ Dickimaw Books\\
\else
\let\@gls@do@glsunset\glsunset
\fi
+ \let\ifKV@glslink@local\if@org@KV@glslink@local
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@default@restore@glslocal}
+%\changes{1.49}{2022-10-14}{new}
+%Save default definition of \cs{@gls@restore@glslocal}
+% \begin{macrocode}
+\let\@gls@default@restore@glslocal\@gls@restore@glslocal
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@ignore@restore@glslocal}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@gls@ignore@restore@glslocal}{%
+ \let\@gls@do@glsunset\@gobble
+ \let\ifKV@glslink@local\if@org@KV@glslink@local
}
% \end{macrocode}
%\end{macro}
@@ -7365,8 +9660,19 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\@gls@default@glslink@opts}
+%\changes{1.49}{2022-10-14}{new}
+%The noindex setting needs to be initialised, so it's now always set
+%to false first before applying the default options. Otherwise, if
+%noindex is explicitly set in a command like \cs{gls} then it won't
+%get reset if the default option list doesn't set it.
+% \begin{macrocode}
+\newcommand*{\@gls@default@glslink@opts}{}
+% \end{macrocode}
+%\end{macro}
+%
%If \cs{@gls@setdefault@glslink@opts} has been defined
-%(\styfmt{glossaries} v4.20) use it to set the default keys in
+%(\sty{glossaries} v4.20) use it to set the default keys in
%\cs{@glslink}.
%\begin{macro}{\@gls@setdefault@glslink@opts}
%\changes{0.5.4}{2015-12-15}{new}
@@ -7375,6 +9681,7 @@ Dickimaw Books\\
{
\renewcommand*{\@gls@setdefault@glslink@opts}{%
\KV@glslink@noindexfalse
+ \expandafter\setupglslink\expandafter{\@gls@default@glslink@opts}%
\@glsxtrsetaliasnoindex
}
}
@@ -7385,6 +9692,7 @@ Dickimaw Books\\
% \begin{macrocode}
\newcommand*{\@gls@setdefault@glslink@opts}{%
\KV@glslink@noindexfalse
+ \expandafter\setupglslink\expandafter{\@gls@default@glslink@opts}%
\@glsxtrsetaliasnoindex
}
\preto\do@glsdisablehyperinlist{\@gls@setdefault@glslink@opts}
@@ -7442,7 +9750,7 @@ Dickimaw Books\\
% \begin{macrocode}
\protected@edef\@gls@counter{\csname glo@\glsdetoklabel{\glslabel}@counter\endcsname}%
\glsxtr@saveentrycounter
- \@@do@wrglossary{\glsxtralias{\glslabel}}%
+ \glsxtr@wrglossary@encap{\glsxtralias{\glslabel}}{\@@do@wrglossary{\glsxtralias{\glslabel}}}%
\endgroup
\fi
}
@@ -7474,10 +9782,23 @@ Dickimaw Books\\
% Set the default options for \cs{glslink} etc.
% \begin{macrocode}
\newcommand*{\GlsXtrSetDefaultGlsOpts}[1]{%
- \renewcommand*{\@gls@setdefault@glslink@opts}{%
- \setkeys{glslink}{#1}%
- \@glsxtrsetaliasnoindex
- }%
+ \renewcommand*{\@gls@default@glslink@opts}{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GlsXtrAppToDefaultGlsOpts}
+% \begin{macrocode}
+\newcommand*{\GlsXtrAppToDefaultGlsOpts}[1]{%
+ \appto\@gls@default@glslink@opts{,#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GlsXtrPreToDefaultGlsOpts}
+% \begin{macrocode}
+\newcommand*{\GlsXtrPreToDefaultGlsOpts}[1]{%
+ \preto\@gls@default@glslink@opts{#1,}%
}
% \end{macrocode}
%\end{macro}
@@ -7491,6 +9812,80 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtr@wrglossary@encap}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glsxtr@@wrglossary@encap}\marg{label}\marg{whatsit}
+%\end{definition}
+%Encapsulate indexing whatsit and increment indexed count.
+%See also \cs{glsxtrdowrglossaryhook}
+% \begin{macrocode}
+\newcommand*{\glsxtr@wrglossary@encap}[2]{\glsencapwrcontent{#2\@glsxtr@inc@indexcount{#1}}}
+% \end{macrocode}
+%\end{macro}
+%
+% Keep track of how many times an entry has been indexed. This doesn't test if
+% the entry has been defined to allow for the first \LaTeX\ run before calling
+% \app{bib2gls}.
+%\begin{macro}{\@glsxtr@inc@indexcount}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@glsxtr@inc@indexcount}[1]{%
+ \ifcsdef{glo@\glsdetoklabel{#1}@indexed}
+ {%
+ \csxdef{glo@\glsdetoklabel{#1}@indexed}{%
+ \expandafter\number\expandafter\numexpr\csname glo@\glsdetoklabel{#1}@indexed\endcsname+1}%
+ }%
+ {%
+ \csgdef{glo@\glsdetoklabel{#1}@indexed}{1}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsentryindexcount}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\glsentryindexcount}[1]{%
+ \ifcsdef{glo@\glsdetoklabel{#1}@indexed}
+ {\csuse{glo@\glsdetoklabel{#1}@indexed}}%
+ {0}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsifindexed}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\glsifindexed}[3]{%
+ \ifcsdef{glo@\glsdetoklabel{#1}@indexed}%
+ {\expandafter\ifnum\csname glo@\glsdetoklabel{#1}@indexed\endcsname>0 #2\else#3\fi}%
+ {#3}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsaddallunindexed}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\glsaddallunindexed}[1][\@glo@types]{%
+ \forallglsentries[#1]{\@glo@entry}%
+ {%
+ \glsifindexed{\@glo@entry}{}{\glsadd[format=glsignore]{\@glo@entry}}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsencapwrcontent}
+%\changes{1.49}{2022-10-14}{new}
+%This command was added to \sty{glossaries} v4.50 so may not be
+%defined.
+% \begin{macrocode}
+\providecommand*{\glsencapwrcontent}[1]{{#1}}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glswriteentry}
% Redefine to test for \catattr{indexonlyfirst} category attribute.
%\changes{1.44}{2020-03-23}{replaced \cs{ifglsused} with \cs{GlsXtrIfUnusedOrUndefined}}
@@ -7521,7 +9916,7 @@ Dickimaw Books\\
%
%\begin{macro}{\@@do@@wrglossary}
% Hook into glossary indexing command so that it can also use
-% \ics{index} at the same time if required and add user hook.
+% \cs{index} at the same time if required and add user hook.
% \begin{macrocode}
\appto\@@do@@wrglossary{\@glsxtr@do@@wrindex
\glsxtrdowrglossaryhook{\@gls@label}%
@@ -7563,7 +9958,10 @@ Dickimaw Books\\
% \begin{macrocode}
\newcommand*{\@gls@alt@hyp@opt}[1]{%
\let\glslinkvar\@firstofthree
- \let\@gls@hyp@opt@cs#1\relax
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{changed \cs{let} to \cs{def} for \cs{@gls@hyp@opt@cs}}
+% \begin{macrocode}
+ \def\@gls@hyp@opt@cs{#1}%
\@ifstar{\s@gls@hyp@opt}%
{\@ifnextchar+%
{\@firstoftwo{\p@gls@hyp@opt}}%
@@ -7627,7 +10025,7 @@ Dickimaw Books\\
{}%
{%
% \end{macrocode}
-%Let \gls{bib2gls} know the modifier.
+%Let \app{bib2gls} know the modifier.
%\changes{1.37}{2018-11-30}{write modifier to aux}
% \begin{macrocode}
\protected@write\@auxout{}{\string\providecommand{\string\@glsxtr@altmodifier}[1]{}}%
@@ -7637,6 +10035,32 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\GlsXtrSetPlusModifier}
+% Allow user to override the plus modifier.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\GlsXtrSetPlusModifier}[1]{%
+ \renewcommand*{\p@gls@hyp@opt}[1][]{%
+ \let\glslinkvar\@thirdofthree
+ \@gls@hyp@opt@cs[#1,##1]%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GlsXtrSetStarModifier}
+% Allow user to override the star modifier.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\GlsXtrSetStarModifier}[1]{%
+ \renewcommand*{\s@gls@hyp@opt}[1][]{%
+ \let\glslinkvar\@secondofthree
+ \@gls@hyp@opt@cs[#1,##1]%
+ }
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsxtr@org@dohyperlink}
%\changes{1.21}{2017-11-03}{new}
% \begin{macrocode}
@@ -7646,7 +10070,7 @@ Dickimaw Books\\
%
%\begin{macro}{\glsnavhyperlink}
%\changes{1.21}{2017-11-03}{patched}
-%Since \ics{glsnavhyperlink} uses \cs{@glslink}, it's necessary to
+%Since \cs{glsnavhyperlink} uses \cs{@glslink}, it's necessary to
%patch it uses \cs{glsdohyperlink} instead of \cs{glsxtrdohyperlink}.
%The simplest way to achieve this is to locally let
%\cs{glsxtrdohyperlink} to \cs{glsdohyperlink}.
@@ -7741,8 +10165,8 @@ Dickimaw Books\\
% Unpleasant complications can occur if the \gloskey{text} or
% \gloskey{first} key etc contains \cs{gls}, particularly if there
% are hyperlinks. To get around this problem, patch
-% \cs{glsdohyperlink} so that it temporarily makes \ics{gls} behave
-% like \ics{glstext}\oarg{hyper=false,noindex}. (This will be
+% \cs{glsdohyperlink} so that it temporarily makes \cs{gls} behave
+% like \cs{glstext}\oarg{hyper=false,noindex}. (This will be
% overridden if the user explicitly cancels either of those options
% in the optional argument of \cs{gls} or using the plus version.)
% This also patches the short form commands like \cs{acrshort}
@@ -7814,7 +10238,7 @@ Dickimaw Books\\
%\begin{macro}{\glsxtrhyperlink}
%\changes{1.19}{2017-09-09}{new}
-%Allows integration with the base \styfmt{glossaries} package's
+%Allows integration with the base \sty{glossaries} package's
%\pkgopt[showtargets]{debug} option.
% \begin{macrocode}
\newcommand{\glsxtrhyperlink}[2]{%
@@ -7849,7 +10273,7 @@ Dickimaw Books\\
%\begin{macro}{\glsdisablehyper}
%\changes{0.5.4}{2015-12-15}{added}
%\changes{1.21}{2017-11-03}{changed to use \cs{def} rather than \cs{let}}
-% Redefine in case we have an old version of \styfmt{glossaries}.
+% Redefine in case we have an old version of \sty{glossaries}.
%This now uses \cs{def} rather than \cs{let} to allow for
%redefinitions of \cs{glsdonohyperlink}.
% \begin{macrocode}
@@ -7877,8 +10301,8 @@ Dickimaw Books\\
%\end{macro}
%
%\begin{macro}{\glsdonohyperlink}
-% This command was only introduced in \styfmt{glossaries} v4.20, so it may
-% not be defined (therefore use \cs{def}). For older \styfmt{glossaries} versions, this won't be
+% This command was only introduced in \sty{glossaries} v4.20, so it may
+% not be defined (therefore use \cs{def}). For older \sty{glossaries} versions, this won't be
% used if \sty{hyperref} hasn't been loaded, which means the
% indexing will still take place. The generated text is scoped
% (the link text in \cs{hyperlink} is also scoped, so it's
@@ -8021,7 +10445,7 @@ Dickimaw Books\\
\def\@GLSxtr@p@short@#1#2[#3]{%
{%
\glssetabbrvfmt{\glscategory{#2}}%
- \mfirstucMakeUppercase{\glsabbrvfont{\glsentryshort{#2}}#3}%
+ \glsuppercase{\glsabbrvfont{\glsentryshort{#2}}#3}%
}%
}
% \end{macrocode}
@@ -8057,7 +10481,7 @@ Dickimaw Books\\
\def\@GLSxtr@p@shortpl@#1#2[#3]{%
{%
\glssetabbrvfmt{\glscategory{#2}}%
- \mfirstucMakeUppercase{\glsabbrvfont{\glsentryshortpl{#2}}#3}%
+ \glsuppercase{\glsabbrvfont{\glsentryshortpl{#2}}#3}%
}%
}
% \end{macrocode}
@@ -8081,7 +10505,7 @@ Dickimaw Books\\
%\changes{0.5.4}{2015-12-15}{new}
% \begin{macrocode}
\def\@GLSxtr@p@long@#1#2[#3]{%
- {\mfirstucMakeUppercase{\glslongfont{\glsentrylong{#2}}#3}}}
+ {\glsuppercase{\glslongfont{\glsentrylong{#2}}#3}}}
% \end{macrocode}
%\end{macro}
%
@@ -8103,7 +10527,7 @@ Dickimaw Books\\
%\changes{0.5.4}{2015-12-15}{new}
% \begin{macrocode}
\def\@GLSxtr@p@longpl@#1#2[#3]{%
- {\mfirstucMakeUppercase{\glslongfont{\glsentrylongpl{#2}}#3}}}
+ {\glsuppercase{\glslongfont{\glsentrylongpl{#2}}#3}}}
% \end{macrocode}
%\end{macro}
%
@@ -8125,7 +10549,7 @@ Dickimaw Books\\
%\changes{0.5.4}{2015-12-15}{new}
% \begin{macrocode}
\def\@GLSxtr@p@acrshort@#1#2[#3]{%
- {\mfirstucMakeUppercase{\acronymfont{\glsentryshort{#2}}#3}}}
+ {\glsuppercase{\acronymfont{\glsentryshort{#2}}#3}}}
% \end{macrocode}
%\end{macro}
%
@@ -8147,7 +10571,7 @@ Dickimaw Books\\
%\changes{0.5.4}{2015-12-15}{new}
% \begin{macrocode}
\def\@GLSxtr@p@acrshortpl@#1#2[#3]{%
- {\mfirstucMakeUppercase{\acronymfont{\glsentryshortpl{#2}}#3}}}
+ {\glsuppercase{\acronymfont{\glsentryshortpl{#2}}#3}}}
% \end{macrocode}
%\end{macro}
%
@@ -8169,7 +10593,7 @@ Dickimaw Books\\
%\changes{0.5.4}{2015-12-15}{new}
% \begin{macrocode}
\def\@GLSxtr@p@acrlong@#1#2[#3]{%
- {\mfirstucMakeUppercase{\glsentrylong{#2}#3}}}
+ {\glsuppercase{\glsentrylong{#2}#3}}}
% \end{macrocode}
%\end{macro}
%
@@ -8191,7 +10615,7 @@ Dickimaw Books\\
%\changes{0.5.4}{2015-12-15}{new}
% \begin{macrocode}
\def\@GLSxtr@p@acrlongpl@#1#2[#3]{%
- {\mfirstucMakeUppercase{\glsentrylongpl{#2}#3}}}
+ {\glsuppercase{\glsentrylongpl{#2}#3}}}
% \end{macrocode}
%\end{macro}
%
@@ -8306,13 +10730,29 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtrifintoc}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glsxtrifintoc}[2]{#2}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrifheaduc}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrifheaduc}[3]{%
+ \glsxtrifintoc{#3}{\glsifattribute{#1}{headuc}{true}{#2}{#3}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsxtr@entry@p}
%\changes{1.07}{2016-08-15}{new}
% \begin{macrocode}
\newrobustcmd*{\glsxtr@headentry@p}[2]{%
- \glsifattribute{#1}{headuc}{true}%
+ \glsxtrifheaduc{#1}%
{%
- \mfirstucMakeUppercase{\@gls@entry@field{#1}{#2}}%
+ \glsuppercase{\@gls@entry@field{#1}{#2}}%
}%
{%
\@gls@entry@field{#1}{#2}%
@@ -8325,42 +10765,16 @@ Dickimaw Books\\
%\changes{1.07}{2016-08-15}{new}
%Not robust as it needs to expand somewhat.
% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand{\glsxtrp}[2]{%
- \protect\NoCaseChange
- {%
- \protect\texorpdfstring
- {%
- \protect\glsxtrifinmark
- {%
- \ifcsdef{glsxtrhead#1}%
- {%
- {\protect\csuse{glsxtrhead#1}{#2}}%
- }%
- {%
- \glsxtr@headentry@p{#2}{#1}%
- }%
- }%
- {%
- \@glsxtrp{#1}{#2}%
- }%
- }%
- {%
- \protect\@gls@entry@field{#2}{#1}%
- }%
- }%
- }
-}
-{
- \newcommand{\glsxtrp}[2]{%
- \protect\NoCaseChange
+\newcommand{\glsxtrp}[2]{%
+ \protect\NoCaseChange
+ {%
+ \protect\glstexorpdfstring
{%
\protect\glsxtrifinmark
{%
\ifcsdef{glsxtrhead#1}%
{%
- {\protect\csuse{glsxtrhead#1}}%
+ {\protect\csuse{glsxtrhead#1}{#2}}%
}%
{%
\glsxtr@headentry@p{#2}{#1}%
@@ -8370,7 +10784,10 @@ Dickimaw Books\\
\@glsxtrp{#1}{#2}%
}%
}%
- }
+ {%
+ \protect\@gls@entry@field{#2}{#1}%
+ }%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -8391,47 +10808,24 @@ Dickimaw Books\\
%
%\begin{macro}{\Glsxtrp}
%\changes{1.07}{2016-08-15}{new}
-%As above but use first letter upper case (but not for the
-%bookmarks, which can't process \cs{uppercase}).
+%As above but use first letter upper case.
% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand{\Glsxtrp}[2]{%
- \protect\NoCaseChange
- {%
- \protect\texorpdfstring
- {%
- \protect\glsxtrifinmark
- {%
- \ifcsdef{Glsxtrhead#1}%
- {%
- {\protect\csuse{Glsxtrhead#1}{#2}}%
- }%
- {%
- \protect\@Gls@entry@field{#2}{#1}%
- }%
- }%
- {%
- \@Glsxtrp{#1}{#2}%
- }%
- }%
- {%
- \protect\@gls@entry@field{#2}{#1}%
- }%
- }%
- }
-}
-{
- \newcommand{\Glsxtrp}[2]{%
- \protect\NoCaseChange
+\newcommand{\Glsxtrp}[2]{%
+ \protect\NoCaseChange
+ {%
+ \protect\glstexorpdfstring
{%
\protect\glsxtrifinmark
{%
\ifcsdef{Glsxtrhead#1}%
{%
- {\protect\csuse{Glsxtrhead#1}}%
+ {\protect\csuse{Glsxtrhead#1}{#2}}%
}%
{%
+% \end{macrocode}
+% \cs{@Gls@entry@field} is robust as from \sty{glossaries} v4.50,
+% but continue to use \cs{protect} in case an older version is installed.
+% \begin{macrocode}
\protect\@Gls@entry@field{#2}{#1}%
}%
}%
@@ -8439,49 +10833,25 @@ Dickimaw Books\\
\@Glsxtrp{#1}{#2}%
}%
}%
- }
+ {%
+ \MFUsentencecase{\@gls@entry@field{#2}{#1}}%
+ }%
+ }%
}
+\glsmfuaddmap{\glsxtrp}{\Glsxtrp}
% \end{macrocode}
%\end{macro}
%
%\begin{macro}{\GLSxtrp}
%\changes{1.07}{2016-08-15}{new}
-%As above but all upper case (but not for the
-%bookmarks, which can't process \cs{uppercase}).
+%As above but all upper case. The bookmarks use
+%\cs{glsuppercase}, which is expandable as from
+%\sty{mfirstuc} v2.08+.
% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand{\GLSxtrp}[2]{%
- \protect\NoCaseChange
- {%
- \protect\texorpdfstring
- {%
- \protect\glsxtrifinmark
- {%
- \ifcsdef{GLSxtr#1}%
- {%
- {\protect\GLSxtrshort[noindex,hyper=false]{#1}[]}%
- }%
- {%
- \protect\mfirstucMakeUppercase
- {%
- \protect\@gls@entry@field{#2}{#1}%
- }%
- }%
- }%
- {%
- \@GLSxtrp{#1}{#2}%
- }%
- }%
- {%
- \protect\@gls@entry@field{#2}{#1}%
- }%
- }%
- }
-}
-{
- \newcommand{\GLSxtrp}[2]{%
- \protect\NoCaseChange
+\newcommand{\GLSxtrp}[2]{%
+ \protect\NoCaseChange
+ {%
+ \protect\glstexorpdfstring
{%
\protect\glsxtrifinmark
{%
@@ -8490,7 +10860,7 @@ Dickimaw Books\\
{\protect\GLSxtrshort[noindex,hyper=false]{#1}[]}%
}%
{%
- \protect\mfirstucMakeUppercase
+ \protect\glsuppercase
{%
\protect\@gls@entry@field{#2}{#1}%
}%
@@ -8500,23 +10870,27 @@ Dickimaw Books\\
\@GLSxtrp{#1}{#2}%
}%
}%
- }
+ {%
+ \protect\GLSxtrusefield{#2}{#1}%
+ }%
+ }%
}
+\glsmfublocker{\GLSxtrp}
% \end{macrocode}
%\end{macro}
%
%
-%\subsection{Entry Counting}
+%\subsubsection{Entry Counting}
%
-% The (use) entry counting mechanism from \styfmt{glossaries} is adjusted
+% The (use) entry counting mechanism from \sty{glossaries} is adjusted
% here to work with category attributes. Provide a convenient
% command to enable entry counting, set the \catattr{entrycount}
-% attribute for given categories and redefine \ics{gls} etc to
+% attribute for given categories and redefine \cs{gls} etc to
% use \cs{cgls} instead. This form of entry counting is provided to
% adjust the formatting if the number of times an entry has been
% used (through commands that unset the first use flag) doesn't
% exceeding the specified threshold. For link counting, see
-% \sectionref{sec:linkcount}.
+%\sectionref{sec:linkcount}.
%
% First adjust definitions of the unset and reset commands to
% provide a hook, but changing the flag can cause problems in
@@ -8569,8 +10943,12 @@ Dickimaw Books\\
% \begin{macrocode}
\newcommand*{\@GlsXtrStartUnsetBuffering}{%
\let\@glsxtr@org@unset@buffer\@glsxtr@unset@buffer
- \def\@glsxtr@unset@buffer{}%
+ \GlsXtrClearUnsetBuffer
\let\@glsunset\@glsxtrbuffer@unset
+ \let\org@glsxtrbuffer@check@repeats\@glsxtrbuffer@check@repeats
+ \renewcommand*{\@glsxtrbuffer@check@repeats}{%
+ \@@glsxtrbuffer@check@repeats
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -8581,8 +10959,12 @@ Dickimaw Books\\
% \begin{macrocode}
\newcommand*{\s@GlsXtrStartUnsetBuffering}{%
\let\@glsxtr@org@unset@buffer\@glsxtr@unset@buffer
- \def\@glsxtr@unset@buffer{}%
+ \GlsXtrClearUnsetBuffer
\let\@glsunset\@glsxtrbuffer@nodup@unset
+ \let\org@glsxtrbuffer@check@repeats\@glsxtrbuffer@check@repeats
+ \renewcommand*{\@glsxtrbuffer@check@repeats}{%
+ \@@glsxtrbuffer@check@repeats
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -8613,6 +10995,79 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\@glsxtrbuffer@check@repeats}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@glsxtrbuffer@check@repeats}{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@@glsxtrbuffer@check@repeats}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@@glsxtrbuffer@check@repeats}{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@@glsxtrbuffer@check@repeats@notused}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@@glsxtrbuffer@check@repeats@notused}{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@@glsxtrbuffer@do@check@repeat}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newrobustcmd*{\@@glsxtrbuffer@do@check@repeat}{%
+ \expandafter\ifinlist\expandafter{\glslabel}{\@glsxtr@unset@buffer}%
+ {\@glslocalunset{\glslabel}}%
+ {\GlsXtrIfUnusedOrUndefined\glslabel
+ {\listxadd\@@glsxtrbuffer@check@repeats@notused{\glslabel}}{}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GlsXtrUnsetBufferEnableRepeatLocal}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\GlsXtrUnsetBufferEnableRepeatLocal}{%
+ \def\@@glsxtrbuffer@check@repeats{\@@glsxtrbuffer@do@check@repeat}%
+ \def\@@glsxtrbuffer@check@repeats@notused{}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GlsXtrUnsetBufferDisableRepeatLocal}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\GlsXtrUnsetBufferDisableRepeatLocal}{%
+ \def\@@glsxtrbuffer@check@repeats{}%
+ \def\@@glsxtrbuffer@check@repeats@notused{}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GlsXtrResetLocalBuffer}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\GlsXtrResetLocalBuffer}{%
+ \forlistloop\@glslocalreset\@@glsxtrbuffer@check@repeats@notused
+ \GlsXtrClearUnsetBuffer
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GlsXtrClearUnsetBuffer}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\GlsXtrClearUnsetBuffer}{%
+ \def\@@glsxtrbuffer@check@repeats@notused{}%
+ \def\@glsxtr@unset@buffer{}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GlsXtrStopUnsetBuffering}
%\changes{1.30}{2018-04-25}{new}
% \begin{macrocode}
@@ -8630,6 +11085,7 @@ Dickimaw Books\\
\let\@glsunset\@glsxtr@unset
\forlistloop\@glsunset\@glsxtr@unset@buffer
\let\@glsxtr@unset@buffer\@glsxtr@org@unset@buffer
+ \let\@glsxtrbuffer@check@repeats\org@glsxtrbuffer@check@repeats
}
% \end{macrocode}
%\end{macro}
@@ -8641,6 +11097,7 @@ Dickimaw Books\\
\newcommand*{\s@GlsXtrStopUnsetBuffering}{%
\forlistloop\@glslocalunset\@glsxtr@unset@buffer
\let\@glsunset\@glsxtr@unset
+ \let\@glsxtrbuffer@check@repeats\org@glsxtrbuffer@check@repeats
}
% \end{macrocode}
%\end{macro}
@@ -8652,6 +11109,7 @@ Dickimaw Books\\
\newcommand*{\GlsXtrDiscardUnsetBuffering}{%
\let\@glsunset\@glsxtr@unset
\let\@glsxtr@unset@buffer\@glsxtr@org@unset@buffer
+ \let\@glsxtrbuffer@check@repeats\org@glsxtrbuffer@check@repeats
}
% \end{macrocode}
%\end{macro}
@@ -8801,6 +11259,17 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\ifglsresetcurrcount}
+%\changes{1.49}{2022-10-14}{new}
+%Determine whether or not to reset the entry counter when the first
+%use flag is reset. This conditional will already be defined with
+%\sty{glossaries} v4.50+.
+% \begin{macrocode}
+\ifdef\glsresetcurrcountfalse{}{\newif\ifglsresetcurrcount}
+\glsresetcurrcountfalse
+% \end{macrocode}
+%\end{macro}
+%
% Redefine the entry counting commands to take into account the
%\catattr{entrycount} attribute.
%\begin{macro}{\glsenableentrycount}
@@ -8850,12 +11319,16 @@ Dickimaw Books\\
\let\@glsxtr@entrycount@org@reset\glsxtrpostreset
\renewcommand*{\glsxtrpostreset}[1]{%
\@glsxtr@entrycount@org@reset{##1}%
- \csgdef{glo@\glsdetoklabel{##1}@currcount}{0}%
+ \ifglsresetcurrcount
+ \csgdef{glo@\glsdetoklabel{##1}@currcount}{0}%
+ \fi
}%
\let\@glsxtr@entrycount@org@localreset\glsxtrpostlocalreset
\renewcommand*{\glsxtrpostlocalreset}[1]{%
\@glsxtr@entrycount@org@localreset{##1}%
- \csdef{glo@\glsdetoklabel{##1}@currcount}{0}%
+ \ifglsresetcurrcount
+ \csdef{glo@\glsdetoklabel{##1}@currcount}{0}%
+ \fi
}%
% \end{macrocode}
% Modifications to take into account the attributes that govern
@@ -8887,6 +11360,21 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\@@newglossaryentry@defcounters}
+%\changes{1.49}{2022-10-14}{new}
+%Allow for docdef=restricted.
+% \begin{macrocode}
+\renewcommand*{\@@newglossaryentry@defcounters}{%
+ \csdef{glo@\@glo@label @currcount}{0}%
+ \ifnum\@glsxtr@docdefval=2\relax
+ \ifcsdef{glo@\@glo@label @prevcount}{}{\csdef{glo@\@glo@label @prevcount}{0}}%
+ \else
+ \csdef{glo@\@glo@label @prevcount}{0}%
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\@gls@write@entrycounts}
% Modify this command so that it only writes the information for
% entries with the \catattr{entrycount} attribute and issue
@@ -9059,11 +11547,12 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
-% Add all upper case versions not provided by \styfmt{glossaries}.
+% Add all upper case versions not provided by \sty{glossaries}.
%\begin{macro}{\cGLS}
%\changes{0.5}{2015-12-07}{new}
% \begin{macrocode}
\newrobustcmd*{\cGLS}{\@gls@hyp@opt\@cGLS}
+\glsmfublocker{\cGLS}
% \end{macrocode}
%\end{macro}
%\begin{macro}{\@cGLS}
@@ -9090,7 +11579,7 @@ Dickimaw Books\\
% text.
% \begin{macrocode}
\newcommand*{\cGLSformat}[2]{%
- \expandafter\mfirstucMakeUppercase\expandafter{\cglsformat{#1}{#2}}%
+ \expandafter\glsuppercase\expandafter{\cglsformat{#1}{#2}}%
}
% \end{macrocode}
%\end{macro}
@@ -9099,6 +11588,7 @@ Dickimaw Books\\
%\changes{0.5}{2015-12-07}{new}
% \begin{macrocode}
\newrobustcmd*{\cGLSpl}{\@gls@hyp@opt\@cGLSpl}
+\glsmfublocker{\cGLSpl}
% \end{macrocode}
%\end{macro}
%\begin{macro}{\@cGLSpl}
@@ -9125,7 +11615,7 @@ Dickimaw Books\\
% text.
% \begin{macrocode}
\newcommand*{\cGLSplformat}[2]{%
- \expandafter\mfirstucMakeUppercase\expandafter{\cglsplformat{#1}{#2}}%
+ \expandafter\glsuppercase\expandafter{\cglsplformat{#1}{#2}}%
}
% \end{macrocode}
%\end{macro}
@@ -9394,11 +11884,12 @@ Dickimaw Books\\
{%
% \end{macrocode}
%\changes{1.46}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}}
+%\changes{1.49}{2022-10-14}{added \cs{ifglsresetcurrcount}}
% \begin{macrocode}
\protected@edef\@glsxtr@csname{\@glsxtr@currentunitcount{##1}}%
\ifcsundef{\@glsxtr@csname}%
{}%
- {\csgdef{\@glsxtr@csname}{0}}%
+ {\ifglsresetcurrcount\csgdef{\@glsxtr@csname}{0}\fi}%
}%
{}%
}%
@@ -9409,11 +11900,12 @@ Dickimaw Books\\
{%
% \end{macrocode}
%\changes{1.46}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}}
+%\changes{1.49}{2022-10-14}{added \cs{ifglsresetcurrcount}}
% \begin{macrocode}
\protected@edef\@glsxtr@csname{\@glsxtr@currentunitcount{##1}}%
\ifcsundef{\@glsxtr@csname}%
{}%
- {\csdef{\@glsxtr@csname}{0}}%
+ {\ifglsresetcurrcount\csdef{\@glsxtr@csname}{0}\fi}%
}%
{}%
}%
@@ -9564,13 +12056,13 @@ Dickimaw Books\\
%\end{macro}
%
%
-%\subsection{Acronym Modifications}
+%\subsubsection{Acronym Modifications}
% It's more consistent to use the abbreviation code for acronyms,
% but make some adjustments to allow for continued use of the
-% \styfmt{glossaries} package's custom acronym format. (For example,
+% \sty{glossaries} package's custom acronym format. (For example,
% user may already have defined some acronym styles with
% \cs{newacronymstyle} which they would like to continue to use.)
-% The original \styfmt{glossaries} acronym code can be restored
+% The original \sty{glossaries} acronym code can be restored
% with \cs{RestoreAcronyms}, but adjust \cs{SetGenericNewAcronym}
% so that \cs{newacronym} adds the category.
%
@@ -9628,14 +12120,14 @@ Dickimaw Books\\
\glslink[##1]{##2}{\Genacrfullformat{##2}{##3}}}%
\renewcommand*{\ACRfullfmt}[3]{%
\glslink[##1]{##2}{%
- \mfirstucMakeUppercase{\genacrfullformat{##2}{##3}}}}%
+ \glsuppercase{\genacrfullformat{##2}{##3}}}}%
\renewcommand*{\acrfullplfmt}[3]{%
\glslink[##1]{##2}{\genplacrfullformat{##2}{##3}}}%
\renewcommand*{\Acrfullplfmt}[3]{%
\glslink[##1]{##2}{\Genplacrfullformat{##2}{##3}}}%
\renewcommand*{\ACRfullplfmt}[3]{%
\glslink[##1]{##2}{%
- \mfirstucMakeUppercase{\genplacrfullformat{##2}{##3}}}}%
+ \glsuppercase{\genplacrfullformat{##2}{##3}}}}%
\renewcommand*{\glsentryfull}[1]{\genacrfullformat{##1}{}}%
\renewcommand*{\Glsentryfull}[1]{\Genacrfullformat{##1}{}}%
\renewcommand*{\glsentryfullpl}[1]{\genplacrfullformat{##1}{}}%
@@ -9674,7 +12166,7 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
-%Need to provide a replacement for \ics{forallacronyms} since
+%Need to provide a replacement for \cs{forallacronyms} since
%\cs{@glsacronymlists} isn't available.
%
%\begin{macro}{\@glsxtr@abbrlists}
@@ -9785,7 +12277,7 @@ Dickimaw Books\\
% \end{macrocode}
%
%\begin{macro}{\RestoreAcronyms}
-% Restore acronyms to \styfmt{glossaries} interface.
+% Restore acronyms to \sty{glossaries} interface.
% \begin{macrocode}
\newcommand*{\RestoreAcronyms}{%
% \end{macrocode}
@@ -9849,15 +12341,30 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
-%\subsection{Indexing and Displaying Glossaries}
+%\begin{macro}{\glsabspace}
+%\changes{1.49}{2022-10-14}{new}
+% Similar to \cs{glsacspace} but includes inner formatting.
+% \begin{macrocode}
+\newrobustcmd*{\glsabspace}[1]{%
+ \settowidth{\dimen@}{(\glsfirstabbrvfont{\glsentryshort{#1}})}%
+ \ifdim\dimen@<\glsacspacemax
+ \glsxtrgenentrytextfmt{~}%
+ \else
+ \glsxtrgenentrytextfmt{ }%
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\subsubsection{Indexing and Displaying Glossaries}
%From time-to-time users ask if they can have one glossary sorted
%normally and another sorted by definition or usage. With the
-% base \styfmt{glossaries} package this can only be achieved with the
+% base \sty{glossaries} package this can only be achieved with the
% \qt{noidx} commands (Option~1). This is an attempt to mix and
% match.
%
%First we need a list of the glossaries that require
-%\gls{makeindex}\slash\gls{xindy}.
+%\app{makeindex}\slash\app{xindy}.
%\begin{macro}{\@glsxtr@reg@glosslist}
%\changes{1.0}{2016-01-24}{new}
% \begin{macrocode}
@@ -9900,6 +12407,14 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\@gls@automake@types}
+%\changes{1.49}{2022-10-14}{new}
+%Added to \sty{glossaries} v4.50 so may not be defined.
+% \begin{macrocode}
+\providecommand{\@gls@automake@types}{\@glo@types}
+% \end{macrocode}
+%\end{macro}
+%
% Redefine \cs{makeglossaries} to take an optional argument.
% This should be empty for the usual behaviour (all glossaries
% need processing with an indexing application) or a comma-separated
@@ -9911,6 +12426,15 @@ Dickimaw Books\\
%\changes{1.42}{2020-02-03}{added \cs{@domakeglossaries}}
% \begin{macrocode}
\renewcommand*{\makeglossaries}[1][]{%
+ \ifx\@glsxtr@record@setting\@glsxtr@record@setting@alsoindex
+ \edef\glsindexingsetting{bib2gls-\ifglsxindy xindy\else makeindex\fi}%
+ \else
+ \ifglsxindy
+ \def\glsindexingsetting{xindy}%
+ \else
+ \def\glsindexingsetting{makeindex}%
+ \fi
+ \fi
\@domakeglossaries
{%
\@glsxtr@if@record@only
@@ -9939,13 +12463,20 @@ Dickimaw Books\\
{You may only use the hybrid \string\makeglossaries[...]\space with
record=off option}%
\else
+ \appto\glsindexingsetting{-noidx}%
% \end{macrocode}
%\cs{@gls@@automake@immediate} was introduced to \sty{glossaries}
%v4.42 so it may not be defined.
%\changes{1.46}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}}
% \begin{macrocode}
- \ifdef\@gls@@automake@immediate{\@gls@@automake@immediate}{}%
\protected@edef\@glsxtr@reg@glosslist{#1}%
+% \end{macrocode}
+% \cs{@gls@@automake@immediate} uses \cs{@gls@automake@types}
+% as from v4.50. Older versions use \cs{@glo@types} which will
+% include the noidx glossaries.
+% \begin{macrocode}
+ \let\@gls@automake@types\@glsxtr@reg@glosslist
+ \ifdef\@gls@@automake@immediate{\@gls@@automake@immediate}{}%
\ifundef{\glswrite}{\newwrite\glswrite}{}%
\protected@write\@auxout{}{\string\providecommand
\string\@glsorder[1]{}}
@@ -10136,17 +12667,41 @@ Dickimaw Books\\
\ifdef\@glo@check@sortallowed{\@glo@check@sortallowed\makeglossaries}{}%
\fi
}%
+% \end{macrocode}
+% Prohibit the use of \cs{glsxtrnoidxgroups}.
+% \begin{macrocode}
+ \prohibit@glsxtrnoidxgroups
+% \end{macrocode}
+% Activate warnings for incompatible options.
+% \begin{macrocode}
+ \let\gls@warn@makegloss@incompatible\@gls@warn@makegloss@incompatible
}%
}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\gls@warn@makegloss@incompatible}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\gls@warn@makegloss@incompatible}[2]{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@warn@makegloss@incompatible}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@gls@warn@makegloss@incompatible}[2]{%
+ #2\GlossariesExtraWarning{#1\space is incompatible with \string\makeglossaries}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%The optional argument version of \cs{makeglossaries} needs an
%adjustment to \cs{@printglossary} to allow \cs{@glo@assign@sortkey}
%to pick up the glossary type.
%
-%Earlier versions of \styfmt{glossaries-extra} simply saved the
+%Earlier versions of \sty{glossaries-extra} simply saved the
%original version of \cs{@printglossary} with \cs{let}
%\cs{@glsxtr@orgprintglossary}. This was later changed to actually
%defining \cs{@glsxtr@orgprintglossary} to something similar with
@@ -10192,7 +12747,7 @@ Dickimaw Books\\
\ifx\@glossary@default@style\relax
\GlossariesWarning{No default glossary style provided \MessageBreak
for the glossary `\@glo@type'. \MessageBreak
- Using deprecated fallback. \MessageBreak
+ Using fallback. \MessageBreak
To fix this set the style with \MessageBreak
\string\setglossarystyle\space or use the \MessageBreak
style key=value option}%
@@ -10259,7 +12814,7 @@ Dickimaw Books\\
%
%\begin{macro}{\@glsxtr@nopostpunc}
%Provide a command that works like \cs{nopostdesc} but only
-%switches of the punctuation without suppressing the post-description
+%switches off the punctuation without suppressing the post-description
%hook.
%\changes{1.22}{2017-11-08}{new}
% \begin{macrocode}
@@ -10368,6 +12923,20 @@ Dickimaw Books\\
}
% \end{macrocode}
%
+%\changes{1.49}{2022-10-14}{added \texttt{preamble} key for \texttt{printgloss}}
+% \begin{macrocode}
+\define@key{printgloss}{preamble}{%
+ \renewcommand{\glossarypreamble}{#1}%
+}
+% \end{macrocode}
+%
+%\changes{1.49}{2022-10-14}{added \texttt{postamble} key for \texttt{printgloss}}
+% \begin{macrocode}
+\define@key{printgloss}{postamble}{%
+ \renewcommand{\glossarypostamble}{#1}%
+}
+% \end{macrocode}
+%
%\begin{macro}{\glsxtrsetglossarylabel}
%\changes{1.39}{2019-03-22}{new}
%Set the label for subsequent glossaries. If the label is
@@ -10394,6 +12963,8 @@ Dickimaw Books\\
% \begin{macrocode}
\define@key{printgloss}{leveloffset}{%
\@glsxtr@assign@leveloffset#1\relax
+ \gls@warn@noidxmakegloss@incompatible{option `leveloffset'}
+ {\@glsxtr@leveloffset=0\relax}%
}
% \end{macrocode}
%
@@ -10432,10 +13003,27 @@ Dickimaw Books\\
%
%\changes{1.44}{2020-03-23}{added groups key}
% \begin{macrocode}
-\define@boolkey{printgloss}[glsxtr@printgloss@]{groups}[true]{}
+\define@boolkey{printgloss}[glsxtr@printgloss@]{groups}[true]{%
+ \ifglsxtr@printgloss@groups
+ \else
+ \gls@warn@noidxmakegloss@incompatible{option `groups'}%
+ {\glsxtr@printgloss@groupstrue}%
+ \fi
+}
\glsxtr@printgloss@groupstrue
% \end{macrocode}
%
+%\changes{1.49}{2022-10-14}{added flatten key}
+% \begin{macrocode}
+\define@boolkey{printgloss}[glsxtrprintgloss]{flatten}[true]{%
+ \ifglsxtrprintglossflatten
+ \gls@warn@noidxmakegloss@incompatible{option `flatten'}%
+ {\glsxtrprintglossflattenfalse}%
+ \fi
+}
+\glsxtrprintglossflattenfalse
+% \end{macrocode}
+%
%\begin{macro}{\glsdohypertarget}
%\changes{1.20}{2017-09-11}{added redefinition}
%Redefine to insert \cs{@glsxtrhypernameprefix} before the target
@@ -10662,6 +13250,44 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtrnoidxgroups}
+%\changes{1.49}{2022-10-14}{new}
+%Provide the ability to switch from unsrt to noidx code, but only
+%for record=off.
+% \begin{macrocode}
+\newcommand*{\glsxtrnoidxgroups}{%
+ \ifdefequal\@glsxtr@record@setting\@glsxtr@record@setting@off
+ {%
+ \let\@gls@getgrouptitle\@gls@noidx@getgrouptitle
+ \let\glsxtr@org@getgrouptitle\@gls@getgrouptitle
+ }%
+ {\PackageError{glossaries-extra}{Can't use
+ \string\glsxtrunsrtgrouptonoidx\space with record=\@glsxtr@record@setting}
+ {\string\glsxtrunsrtgrouptonoidx\space is only available with record=off}}%
+ \global\let\prohibit@glsxtrnoidxgroups\@glsxtrnoidxgroups@nomakegloss
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsxtrnoidxgroups@nomakegloss}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\@glsxtrnoidxgroups@nomakegloss}{%
+ \PackageError{glossaries-extra}{Can't use
+ \string\glsxtrunsrtgrouptonoidx\space with \string\makeglossaries}{}
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\prohibit@glsxtrnoidxgroups}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\prohibit@glsxtrnoidxgroups}{%
+ \global\let\glsxtrnoidxgroups\@glsxtrnoidxgroups@nomakegloss
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsxtrgetgrouptitle}
%\changes{1.14}{2017-04-18}{new}
%Provide a user-level command to fetch the group title. The first
@@ -10669,10 +13295,10 @@ Dickimaw Books\\
%sequence in which to store the title.
% \begin{macrocode}
\newrobustcmd{\glsxtrgetgrouptitle}[2]{%
- \protected@edef\@glsxtr@titlelabel{glsxtr@grouptitle@#1}%
- \@onelevel@sanitize\@glsxtr@titlelabel
- \ifcsdef{\@glsxtr@titlelabel}
- {\letcs{#2}{\@glsxtr@titlelabel}}%
+ \protected@edef\@glsxtr@titlecsname{glsxtr@grouptitle@#1}%
+ \@onelevel@sanitize\@glsxtr@titlecsname
+ \ifcsdef{\@glsxtr@titlecsname}
+ {\letcs{#2}{\@glsxtr@titlecsname}}%
{\glsxtr@org@getgrouptitle{#1}{#2}}%
}
\let\@gls@getgrouptitle\glsxtrgetgrouptitle
@@ -11267,12 +13893,16 @@ Dickimaw Books\\
%enforces a .glstex extension to avoid conflict.
% \begin{macrocode}
\newcommand*{\glsxtrresourcefile}[2][]{%
+ \@glsxtr@if@record@only
+ {\renewcommand{\glsindexingsetting}{bib2gls}}%
+ {\edef\glsindexingsetting{bib2gls-\ifglsxindy xindy\else makeindex\fi}}%
% \end{macrocode}
%The \pkgopt{record} option can't be set after this command.
%\changes{1.21}{2017-11-03}{now disables record key}
% \begin{macrocode}
\disable@keys{glossaries-extra.sty}{record}%
\glsxtr@writefields
+ \glsxtr@save@mfu
\ifdefempty\GlsXtrDefaultResourceOptions
{%
\protected@write\@auxout{\glsxtrresourceinit}%
@@ -11367,6 +13997,40 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtrMFUsave}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrMFUsave}{%
+ \ifdef\MFUsave
+ {%
+ \AtBeginDocument{\MFUsave}%
+ }%
+ {%
+ \GlossariesExtraWarning{mfirstuc.sty too old,
+ \string\glsxtrMFUsave\space has no effect. You need to upgrade
+ to mfirstuc v2.08}%
+ }%
+ \let\glsxtrMFUsave\relax
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtr@save@mfu}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\ifdef\MFUsave
+{
+ \newcommand*{\glsxtr@save@mfu}{%
+ \glsxtrMFUsave
+ \let\glsxtr@save@mfu\relax
+ }
+}
+{
+ \newcommand*{\glsxtr@save@mfu}{}
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsxtr@fields}
%\changes{1.11}{2017-01-19}{new}
% \begin{macrocode}
@@ -11457,19 +14121,20 @@ Dickimaw Books\\
\protected@write\@auxout{}{\string\glsxtr@pluralsuffixes
{\glspluralsuffix}{\abbrvpluralsuffix}{\acrpluralsuffix}%
{\glsxtrabbrvpluralsuffix}}%
- \ifdef\inputencodingname
- {%
- \protected@write\@auxout{}{\string\glsxtr@texencoding{\inputencodingname}}%
- }%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{encoding test replaced \cs{ifdef} with
+%\cs{ifdefvoid} and reversed args}
+% \begin{macrocode}
+ \ifdefvoid\inputencodingname
{%
% \end{macrocode}
-%If \sty{fontspec} has been loaded, assume UTF-8. (The encoding can
-%be changed with \cs{XeTeXinputencoding}, but I can't work out how
-%to determine the current encoding.)
+%Assume UTF-8.
+%\changes{1.49}{2022-10-14}{removed test for \sty{fontspec}}
% \begin{macrocode}
- \@ifpackageloaded{fontspec}%
- {\protected@write\@auxout{}{\string\glsxtr@texencoding{utf8}}}%
- {}%
+ \protected@write\@auxout{}{\string\glsxtr@texencoding{utf8}}%
+ }%
+ {%
+ \protected@write\@auxout{}{\string\glsxtr@texencoding{\inputencodingname}}%
}%
\protected@write\@auxout{}{\string\glsxtr@shortcutsval{\@glsxtr@shortcutsval}}%
% \end{macrocode}
@@ -11497,7 +14162,7 @@ Dickimaw Books\\
% \end{macrocode}
%If \cs{makeglossaries} is also used, allow makeindex/xindy to
%also be run, otherwise disable the error message about requiring
-%\cs{makeglossaries} with \pkgopt[true]{automake}.
+%\cs{makeglossaries} with \pkgopt{automake}.
% \begin{macrocode}
\ifx\@gls@doautomake\@gls@doautomake@err
\let\@gls@doautomake\relax
@@ -11522,14 +14187,22 @@ Dickimaw Books\\
%
%\begin{macro}{\@glsxtr@do@automake@err}
%\changes{1.14}{2017-04-18}{new}
+%\sty{glossaries} v4.50+ now provides \cs{@gls@do@automake@err} so
+%use that if defined.
% \begin{macrocode}
-\newcommand*{\@gls@doautomake@err}{%
- \PackageError{glossaries}{You must use
- \string\makeglossaries\space with automake=true}
- {%
- Either remove the automake=true setting or
- add \string\makeglossaries\space to your document preamble.%
- }%
+\ifdef{\@gls@do@automake@err}
+{
+ \let\@gls@doautomake@err\@gls@do@automake@err
+}
+{
+ \newcommand*{\@gls@doautomake@err}{%
+ \PackageError{glossaries}{You must use
+ \string\makeglossaries\space with automake=true}
+ {%
+ Either remove the automake=true setting or
+ add \string\makeglossaries\space to your document preamble.%
+ }%
+ }
}
% \end{macrocode}
%\end{macro}
@@ -11557,10 +14230,19 @@ Dickimaw Books\\
% \begin{macrocode}
\newcommand*{\glsxtr@counterrecord}[3]{%
\glsxtrfieldlistgadd{#1}{record.#2}{#3}%
+ \glsxtrAddCounterRecordHook{#1}{#2}{#3}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtrAddCounterRecordHook}
+%\changes{1.49}{2022-10-14}{new}
+%User hook.
+% \begin{macrocode}
+\newcommand{\glsxtrAddCounterRecordHook}[3]{}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\@glsxtr@counterrecordhook}
%\changes{1.12}{2017-02-03}{new}
%Hook used by \cs{@glsxtr@dorecord}.
@@ -11585,7 +14267,7 @@ Dickimaw Books\\
%\changes{1.12}{2017-02-03}{new}
% \begin{macrocode}
\newcommand*{\@glsxtr@docounterrecord}[1]{%
- \protected@write\@auxout{}{\string\glsxtr@counterrecord
+ \@bibgls@write@aux{}{\string\glsxtr@counterrecord
{\@gls@label}{#1}{\csuse{the#1}}}%
}
% \end{macrocode}
@@ -11606,8 +14288,8 @@ Dickimaw Books\\
\newcommand*{\glsxtrglossentry}[1]{%
\glsxtrtitleorpdforheading
{\@glsxtrglossentry{#1}}%
- {\glsentryname{#1}}%
- {\glsxtrheadname{#1}}%
+ {\GlsXtrStandaloneEntryPdfName{#1}}%
+ {\GlsXtrStandaloneEntryHeadName{#1}}%
}
% \end{macrocode}
%\end{macro}
@@ -11634,8 +14316,26 @@ Dickimaw Books\\
\endgroup
}%
}%
- {\glsentryname{#1}}%
- {\glsxtrheadname{#1}}%
+ {\GlsXtrStandaloneEntryPdfName{#1}}%
+ {\GlsXtrStandaloneEntryHeadName{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GlsXtrStandaloneEntryHeadName}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\GlsXtrStandaloneEntryHeadName}[1]{%
+ \glsxtrheadname{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GlsXtrStandaloneEntryPdfName}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\GlsXtrStandaloneEntryPdfName}[1]{%
+ \glsentryname{#1}%
}
% \end{macrocode}
%\end{macro}
@@ -11682,31 +14382,49 @@ Dickimaw Books\\
\newcommand*{\glsxtrglossentryother}[3]{%
\ifstrempty{#1}%
{%
- \ifcsdef{glsxtrhead#3}%
- {%
- \glsxtrtitleorpdforheading
- {\@glsxtrglossentryother{#2}{#3}{#1}}%
- {\@gls@entry@field{#2}{#3}}%
- {\csuse{glsxtrhead#3}{#2}}%
- }%
- {%
- \glsxtrtitleorpdforheading
- {\@glsxtrglossentryother{#2}{#3}{#1}}%
- {\@gls@entry@field{#2}{#3}}%
- {\@gls@entry@field{\NoCaseChange{#2}}{#3}}%
- }%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{use default header if first argument empty}
+% \begin{macrocode}
+ \glsxtrtitleorpdforheading
+ {\@glsxtrglossentryother{#2}{#3}{\GlsXtrStandaloneEntryHeadOther{#3}{#2}}}%
+ {\GlsXtrStandaloneEntryPdfOther{#2}{#3}}%
+ {\GlsXtrStandaloneEntryHeadOther{#3}{#2}}%
}%
{%
\glsxtrtitleorpdforheading
{\@glsxtrglossentryother{#2}{#3}{#1}}%
- {\@gls@entry@field{#2}{#3}}%
+ {\GlsXtrStandaloneEntryPdfOther{#2}{#3}}%
{#1}%
}%
}
% \end{macrocode}
%\end{macro}
+%
+%\begin{macro}{\GlsXtrStandaloneEntryHeadOther}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\GlsXtrStandaloneEntryHeadOther}[2]{%
+ \ifcsdef{glsxtrhead#2}%
+ {\csuse{glsxtrhead#2}{#1}}%
+ {\@gls@entry@field{\NoCaseChange{#1}}{#2}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GlsXtrStandaloneEntryPdfOther}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\GlsXtrStandaloneEntryPdfOther}[2]{%
+ \@gls@entry@field{#1}{#2}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\@glsxtrglossentryother}
%\changes{1.22}{2017-11-08}{new}
+%\begin{definition}
+%\cs{\@glsxtrglossentryother}\marg{entry-label}\marg{field}\marg{header}
+%\end{definition}
%As \cs{@glsxtrglossentry} but uses a different field.
% \begin{macrocode}
\newrobustcmd*{\@glsxtrglossentryother}[3]{%
@@ -11723,11 +14441,14 @@ Dickimaw Books\\
\ifglshasparent{#1}%
{\GlsXtrStandaloneSubEntryItem{#1}}%
{\glsentryitem{#1}}%
- \GlsXtrStandaloneEntryOther{#1}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{bug fix: corrected arguments to \cs{GlsXtrStandaloneEntryOther}}
+% \begin{macrocode}
+ \GlsXtrStandaloneEntryOther{#1}{#2}%
\endgroup
}%
}%
- {\@gls@entry@field{#1}{#2}}%
+ {\GlsXtrStandaloneEntryPdfOther{#1}{#2}}%
{#3}%
}
% \end{macrocode}
@@ -11814,50 +14535,47 @@ Dickimaw Books\\
}%
{%
% \end{macrocode}
-%\changes{1.16}{2017-06-15}{corrected misspelt command}
+% Setup local commands.
% \begin{macrocode}
- \key@ifundefined{glossentry}{group}%
- {\let\@gls@getgrouptitle\@gls@noidx@getgrouptitle}%
- {\let\@gls@getgrouptitle\@glsxtr@unsrt@getgrouptitle}%
- \def\@gls@currentlettergroup{}%
+ \@glsxtr@unsrt@gloss@init
% \end{macrocode}
%A loop within the tabular-like styles can cause problems, so
-%move the loop outside.
+%move the loop outside. The entire glossary will be saved in
+%\cs{@glsxtr@doglossary}, which will be built up in the loop.
% \begin{macrocode}
\def\@glsxtr@doglossary{%
\begin{theglossary}%
\glossaryheader
\glsresetentrylist
}%
+% \end{macrocode}
+% Iterate over all entries in the current glossary and add the relevant commands to
+% \cs{@glsxtr@doglossary}.
+% \begin{macrocode}
\expandafter\@for\expandafter\glscurrententrylabel\expandafter
:\expandafter=\csname glolist@\@glo@type\endcsname\do{%
\ifdefempty{\glscurrententrylabel}
{}%
{%
% \end{macrocode}
-%Provide a hook (for example to measure width).
+%Initialise hooks
% \begin{macrocode}
- \let\glsxtr@process\@firstofone
- \let\printunsrtglossaryskipentry
- \@glsxtr@printunsrtglossaryskipentry
- \printunsrtglossaryentryprocesshook{\glscurrententrylabel}%
+ \@gls@xtr@initprocess
% \end{macrocode}
-%Don't check group for child entries.
+%Process this entry (unless it has been skipped).
% \begin{macrocode}
\glsxtr@process
{%
\ifglsxtr@printgloss@groups
% \end{macrocode}
-% This still uses \cs{ifglshasparent} to determine whether or not to
-% check for a change in the letter group. (It doesn't take the level
-% offset into account because \app{bib2gls} only saves the group
-% information for parentless entries.)
+% Check if the group heading should be added and, if so, add it.
+% \cs{@glsxtr@groupheading} will be empty if no group heading.
% \begin{macrocode}
- \ifglshasparent{\glscurrententrylabel}{}%
+ \glsxtraddgroup\glscurrententrylabel
{%
- \@glsxtr@checkgroup\glscurrententrylabel
- \expandafter\appto\expandafter\@glsxtr@doglossary\expandafter
- {\@glsxtr@groupheading}%
+ \@glsxtr@checkgroup\glscurrententrylabel
+ \expandafter\appto\expandafter\@glsxtr@doglossary\expandafter
+ {\@glsxtr@groupheading}%
}%
\fi
% \end{macrocode}
@@ -11877,6 +14595,89 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\@glsxtr@unsrt@gloss@init}
+%\changes{1.49}{2022-10-14}{new}
+%Initialise hooks needed at the start.
+% \begin{macrocode}
+\newcommand*{\@glsxtr@unsrt@gloss@init}{%
+% \end{macrocode}
+%Determine how to obtain the group information.
+%\changes{1.16}{2017-06-15}{corrected misspelt command}
+% \begin{macrocode}
+ \key@ifundefined{glossentry}{group}%
+ {\let\@gls@getgrouptitle\@gls@noidx@getgrouptitle}%
+ {\let\@gls@getgrouptitle\@glsxtr@unsrt@getgrouptitle}%
+% \end{macrocode}
+%Initialise current group information.
+% \begin{macrocode}
+ \def\@gls@currentlettergroup{}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{save hierarchical level information}
+%Need to keep track of the current group hierarchical level
+% \begin{macrocode}
+ \def\@gls@currentlettergroup@level{-1}%
+% \end{macrocode}
+%and the current entry hierarchical level.
+% \begin{macrocode}
+ \def\glscurrententrylevel{-1}%
+% \end{macrocode}
+% Initialise the root entry. This will be the most recent entry that
+% doesn't have a parent.
+% \begin{macrocode}
+ \def\glscurrentrootentry{}%
+% \end{macrocode}
+% Initialise the top-level entry. This will be the most recent entry that
+% had level=0 (after adjustment).
+% \begin{macrocode}
+ \def\glscurrenttoplevelentry{}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@xtr@initprocess}
+%\changes{1.49}{2022-10-14}{new}
+%Initialise hooks needed for each iteration of the process loop.
+% \begin{macrocode}
+\newcommand*{\@gls@xtr@initprocess}{%
+% \end{macrocode}
+%Save the current hierarchical level (adjusted).
+% \begin{macrocode}
+ \ifglsxtrprintglossflatten
+ \edef\glscurrententrylevel{\number\@glsxtr@leveloffset}%
+ \else
+ \edef\glscurrententrylevel{%
+ \number\numexpr\csname glo@\glscurrententrylabel @level\endcsname
+ + \@glsxtr@leveloffset}%
+ \fi
+% \end{macrocode}
+%If this level 0, update \cs{glscurrenttoplevelentry}
+% \begin{macrocode}
+ \ifnum\glscurrententrylevel=0\relax
+ \let\glscurrenttoplevelentry\glscurrententrylabel
+ \fi
+% \end{macrocode}
+%If this entry doesn't have a parent, update \cs{glscurrentrootentry}
+% \begin{macrocode}
+ \ifglsxtrprintglossflatten
+ \let\glscurrentrootentry\glscurrententrylabel
+ \else
+ \ifglshasparent{\glscurrententrylabel}{}%
+ {\let\glscurrentrootentry\glscurrententrylabel}%
+ \fi
+% \end{macrocode}
+%Initialise to do the current entry.
+% \begin{macrocode}
+ \let\glsxtr@process\@firstofone
+% \end{macrocode}
+%Provide a way to skip the current entry. This will redefine
+%\cs{glsxtr@process} to ignore its argument.
+% \begin{macrocode}
+ \let\printunsrtglossaryskipentry\@glsxtr@printunsrtglossaryskipentry
+ \printunsrtglossaryentryprocesshook{\glscurrententrylabel}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\printunsrtinnerglossary}
%\changes{1.44}{2020-03-23}{new}
%Similar to \cs{printunsrtglossary} but doesn't add the section
@@ -11916,7 +14717,7 @@ Dickimaw Books\\
\ifx\@glossary@default@style\relax
\GlossariesWarning{No default glossary style provided \MessageBreak
for the glossary `\@glo@type'. \MessageBreak
- Using deprecated fallback. \MessageBreak
+ Using fallback. \MessageBreak
To fix this set the style with \MessageBreak
\string\setglossarystyle\space or use the \MessageBreak
style key=value option}%
@@ -11989,43 +14790,42 @@ Dickimaw Books\\
\GlossariesExtraWarning{No entries defined in glossary `\@glo@type'}%
}%
{%
- \key@ifundefined{glossentry}{group}%
- {\let\@gls@getgrouptitle\@gls@noidx@getgrouptitle}%
- {\let\@gls@getgrouptitle\@glsxtr@unsrt@getgrouptitle}%
- \def\@gls@currentlettergroup{}%
+% \end{macrocode}
+% Setup local commands.
+% \begin{macrocode}
+ \@glsxtr@unsrt@gloss@init
% \end{macrocode}
%No header or reset.
% \begin{macrocode}
\def\@glsxtr@doglossary{}%
+% \end{macrocode}
+% Iterate over all entries in the current glossary and add the relevant commands to
+% \cs{@glsxtr@doglossary}.
+% \begin{macrocode}
\expandafter\@for\expandafter\glscurrententrylabel\expandafter
:\expandafter=\csname glolist@\@glo@type\endcsname\do{%
\ifdefempty{\glscurrententrylabel}
{}%
{%
% \end{macrocode}
-%Provide a hook (for example to measure width).
+%Initialise hooks
% \begin{macrocode}
- \let\glsxtr@process\@firstofone
- \let\printunsrtglossaryskipentry
- \@glsxtr@printunsrtglossaryskipentry
- \printunsrtglossaryentryprocesshook{\glscurrententrylabel}%
+ \@gls@xtr@initprocess
% \end{macrocode}
-%Don't check group for child entries.
+%Process this entry (unless it has been skipped).
% \begin{macrocode}
\glsxtr@process
{%
\ifglsxtr@printgloss@groups
% \end{macrocode}
-% This still uses \cs{ifglshasparent} to determine whether or not to
-% check for a change in the letter group. (It doesn't take the level
-% offset into account because \app{bib2gls} only saves the group
-% information for parentless entries.)
+% Check if the group heading should be added and, if so, add it.
+% \cs{@glsxtr@groupheading} will be empty if no group heading.
% \begin{macrocode}
- \ifglshasparent{\glscurrententrylabel}{}%
+ \glsxtraddgroup\glscurrententrylabel
{%
- \@glsxtr@checkgroup\glscurrententrylabel
- \expandafter\appto\expandafter\@glsxtr@doglossary\expandafter
- {\@glsxtr@groupheading}%
+ \@glsxtr@checkgroup\glscurrententrylabel
+ \expandafter\appto\expandafter\@glsxtr@doglossary\expandafter
+ {\@glsxtr@groupheading}%
}%
\fi
% \end{macrocode}
@@ -12046,6 +14846,24 @@ Dickimaw Books\\
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtraddgroup}
+%\changes{1.49}{2022-10-14}{new}
+%Now that \app{bib2gls} v3.0+ has the ability to store group labels
+%for sub-levels, provide a way to allow for this. This checks if the entry has
+%a parent, which was used originally, unless the flatten option has been used.
+%\app{bib2gls} will redefine this in the .glstex file if the
+%group-level setting is used.
+% \begin{macrocode}
+\newcommand*{\glsxtraddgroup}[2]{%
+ \ifglsxtrprintglossflatten
+ #2%
+ \else
+ \ifglshasparent{#1}{}{#2}%
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
%
%\begin{macro}{\printunsrtglossaryentryprocesshook}
%\changes{1.21}{2017-11-03}{new}
@@ -12064,7 +14882,7 @@ can only be used within \string\printunsrtglossaryentryprocesshook}{}%
% \end{macrocode}
%\end{macro}
%
-%\begin{macro}{\printunsrtglossaryentryprocesshook}
+%\begin{macro}{\@glsxtr@printunsrtglossaryskipentry}
%\changes{1.21}{2017-11-03}{new}
% \begin{macrocode}
\newcommand*{\@glsxtr@printunsrtglossaryskipentry}{%
@@ -12152,11 +14970,18 @@ can only be used within \string\printunsrtglossaryentryprocesshook}{}%
\renewcommand*{\@glsxtrhypernameprefix}{record.#1.\csuse{theH#1}.\@gobble}%
}%
\renewcommand*{\glossarysection}[2][]{}%
- \appto\glossarypostamble{\glspar\medskip\glspar}%
+ \appto\glossarypostamble{\printunsrtglossaryunitpostskip}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\printunsrtglossaryunitpostskip}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\printunsrtglossaryunitpostskip}{\glspar\medskip\glspar}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\print@noop@unsrtglossaryunit}
%\changes{1.12}{2017-02-03}{new}
% \begin{macrocode}
@@ -12212,7 +15037,8 @@ can only be used within \string\printunsrtglossaryentryprocesshook}{}%
%formerly in \cs{@glsxtr@noidx@do}.) Now that this is no longer
%within a tabular environment, the global definitions aren't needed.
%The result is now stored in \cs{@glsxtr@groupheading}, which will
-%be empty if no heading is required.
+%be empty if no heading is required. The current hierarchical level
+%must have first been saved to \cs{glscurrententrylevel}.
% \begin{macrocode}
\newcommand*{\@glsxtr@checkgroup}[1]{%
\def\@glsxtr@groupheading{}%
@@ -12228,20 +15054,56 @@ can only be used within \string\printunsrtglossaryentryprocesshook}{}%
\protected@edef\@glo@thislettergrp{%
\csuse{glo@\glsdetoklabel{#1}@\glsxtrgroupfield}}%
}%
- \ifdefequal{\@glo@thislettergrp}{\@gls@currentlettergroup}%
+% \end{macrocode}
+%Need to keep track of the current group for the current level.
+% \begin{macrocode}
+ \ifcsundef{@gls@currentlettergroup\romannumeral\glscurrententrylevel}%
+ {\csdef{@gls@currentlettergroup\romannumeral\glscurrententrylevel}{}}{}%
+% \end{macrocode}
+%Has the group label changed for the current level?
+% \begin{macrocode}
+ \ifcsequal{@glo@thislettergrp}{@gls@currentlettergroup\romannumeral\glscurrententrylevel}%
{}%
{%
- \ifdefempty{\@gls@currentlettergroup}{}%
- {\def\@glsxtr@groupheading{\glsgroupskip}}%
- \protected@eappto\@glsxtr@groupheading{%
- \noexpand\glsgroupheading{\expandonce\@glo@thislettergrp}%
+ \ifdefempty\@glo@thislettergrp
+ {}%
+ {%
+ \ifnum\glscurrententrylevel>0\relax
+ \protected@eappto\@glsxtr@groupheading{%
+ \noexpand\glssubgroupheading
+ {\@gls@currentlettergroup@level}{\glscurrententrylevel}%
+ {\csuse{glo@\glsdetoklabel{#1}@parent}}%
+ {\expandonce\@glo@thislettergrp}%
+ }%
+ \else
+ \ifdefempty{\@gls@currentlettergroup}{}%
+ {%
+ \def\@glsxtr@groupheading{\glsgroupskip}%
+ }%
+ \protected@eappto\@glsxtr@groupheading{%
+ \noexpand\glsgroupheading{\expandonce\@glo@thislettergrp}%
+ }%
+ \fi
+ \let\@gls@currentlettergroup@level\glscurrententrylevel
+ \cslet{@gls@currentlettergroup\romannumeral\glscurrententrylevel}\@glo@thislettergrp
}%
}%
- \let\@gls@currentlettergroup\@glo@thislettergrp
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glssubgroupheading}
+%\begin{definition}
+%\cs{glssubgroupheading}\marg{previous level}\marg{level}\marg{parent}\marg{group label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+%Default definition uses the same format as the top-level heading.
+%Note that this won't include the group skip.
+% \begin{macrocode}
+\newcommand*{\glssubgroupheading}[4]{\glsgroupheading{#4}}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GlsXtrLocationField}
%\changes{1.37}{2018-11-30}{new}
%Stores the internal name of the location field.
@@ -12254,7 +15116,7 @@ can only be used within \string\printunsrtglossaryentryprocesshook}{}%
%\changes{1.11}{2017-01-19}{new}
%Minor modification of \cs{@gls@noidx@do} to check for location
%field if present, but also need to check for the \gloskey{group}
-%field.
+%field and flatten option.
% \begin{macrocode}
\newcommand{\@glsxtr@noidx@do}[1]{%
\ifglsentryexists{#1}%
@@ -12265,7 +15127,11 @@ can only be used within \string\printunsrtglossaryentryprocesshook}{}%
% Use level number to determine whether or not this entry has a
% parent.
% \begin{macrocode}
- \gls@level=\numexpr\csuse{glo@\glsdetoklabel{#1}@level}+\@glsxtr@leveloffset\relax
+ \ifglsxtrprintglossflatten
+ \gls@level=\@glsxtr@leveloffset\relax
+ \else
+ \gls@level=\numexpr\csuse{glo@\glsdetoklabel{#1}@level}+\@glsxtr@leveloffset\relax
+ \fi
\ifnum\gls@level>0
\let\@glsxtr@ifischild\@firstoftwo
\else
@@ -12281,16 +15147,27 @@ can only be used within \string\printunsrtglossaryentryprocesshook}{}%
{%
\ifdefvoid{\@gls@location}%
{%
- \ifdefvoid{\@gls@loclist}%
- {%
- \expandafter\subglossentry\expandafter{\number\gls@level}{#1}{}%
- }%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{check if location field has been changed}
+%If \cs{GlsXtrLocationField} has been changed then don't fallback on
+%\gloskey{loclist}.
+% \begin{macrocode}
+ \ifdefstring{\GlsXtrLocationField}{location}%
{%
- \expandafter\subglossentry\expandafter{\number\gls@level}{#1}%
+ \ifdefvoid{\@gls@loclist}%
{%
- \glossaryentrynumbers{\glsnoidxloclist{\@gls@loclist}}%
+ \expandafter\subglossentry\expandafter{\number\gls@level}{#1}{}%
+ }%
+ {%
+ \expandafter\subglossentry\expandafter{\number\gls@level}{#1}%
+ {%
+ \glossaryentrynumbers{\glsnoidxloclist{\@gls@loclist}}%
+ }%
}%
}%
+ {%
+ \expandafter\subglossentry\expandafter{\number\gls@level}{#1}{}%
+ }%
}%
{%
\expandafter\subglossentry\expandafter
@@ -12303,16 +15180,27 @@ can only be used within \string\printunsrtglossaryentryprocesshook}{}%
% \begin{macrocode}
\ifdefvoid{\@gls@location}%
{%
- \ifdefvoid{\@gls@loclist}
- {%
- \glossentry{#1}{}%
- }%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{check if location field has been changed}
+%If \cs{GlsXtrLocationField} has been changed then don't fallback on
+%\gloskey{loclist}.
+% \begin{macrocode}
+ \ifdefstring{\GlsXtrLocationField}{location}%
{%
- \glossentry{#1}%
+ \ifdefvoid{\@gls@loclist}
{%
- \glossaryentrynumbers{\glsnoidxloclist{\@gls@loclist}}%
+ \glossentry{#1}{}%
+ }%
+ {%
+ \glossentry{#1}%
+ {%
+ \glossaryentrynumbers{\glsnoidxloclist{\@gls@loclist}}%
+ }%
}%
}%
+ {%
+ \glossentry{#1}{}%
+ }%
}%
{%
\glossentry{#1}%
@@ -12344,6 +15232,15 @@ can only be used within \string\printunsrtglossaryentryprocesshook}{}%
%help make it unique, but it might feasibly contain
%\gloskey[glslink]{thevalue} where the value might contain commands.)
%
+%\begin{macro}{\glsxtrdoidentify}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrdoidentify}[1]{%
+ \ifdefequal\@glsxtr@record@setting\@glsxtr@record@setting@off{}{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\@glsxtr@providenewgls}
%\changes{1.37}{2018-11-30}{new}
% \begin{macrocode}
@@ -12357,11 +15254,12 @@ can only be used within \string\printunsrtglossaryentryprocesshook}{}%
%\begin{macro}{\glsxtridentifyglslike}
%\changes{1.37}{2018-11-30}{new}
%Identify the command given in the second argument for the benefit
-%of \gls{bib2gls}.
+%of \app{bib2gls} and also identify command as a blocker for
+%\cs{makefirstuc}.
% \begin{macrocode}
\newcommand{\glsxtridentifyglslike}[2]{%
- \ifdefequal\@glsxtr@record@setting\@glsxtr@record@setting@off
- {}%
+ \glsmfublocker{#2}%
+ \glsxtrdoidentify
{%
\@glsxtr@providenewgls
\protected@write\@auxout{}{\string\@glsxtr@newglslike{#1}{\string#2}}%
@@ -12370,10 +15268,137 @@ can only be used within \string\printunsrtglossaryentryprocesshook}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\@glsxtr@providenewglsfamily}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@glsxtr@providenewglsfamily}{%
+ \protected@write\@auxout{}{\string\providecommand{\string\@glsxtr@newglslikefamily}[8]{}}%
+ \let\@glsxtr@providenewglsfamily\relax
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtridentifyglsfamily}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glsxtridentifyglsfamily}\marg{options}\marg{prefix}\marg{gls}\marg{glspl}\marg{Gls}\marg{Glspl}\marg{GLS}\marg{GLSpl}
+%\end{definition}
+%Identify the family of commands for the benefit
+%of \app{bib2gls} and also establishes a sentence-case mapping.
+% \begin{macrocode}
+\newcommand{\glsxtridentifyglsfamily}[8]{%
+ \glsmfuaddmap{#3}{#5}%
+ \glsmfuaddmap{#4}{#6}%
+ \glsmfublocker{#7}%
+ \glsmfublocker{#8}%
+ \glsxtrdoidentify
+ {%
+ \@glsxtr@providenewglsfamily
+ \protected@write\@auxout{}{\string\@glsxtr@newglslikefamily{\detokenize{#1}}{\detokenize{#2}}{\detokenize{#3}}{\detokenize{#4}}{\detokenize{#5}}{\detokenize{#6}}{\detokenize{#7}}{\detokenize{#8}}}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsxtr@providenewglslink}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@glsxtr@providenewglslink}{%
+ \protected@write\@auxout{}{\string\providecommand{\string\@glsxtr@newglslink}[2]{}}%
+ \let\@glsxtr@providenewglslink\relax
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtridentifyglslink}
+%\changes{1.49}{2022-10-14}{new}
+%Identify the command given in the second argument for the benefit
+%of \app{bib2gls} and identify the command as a blocker for
+%\cs{makefirstuc}.
+% \begin{macrocode}
+\newcommand{\glsxtridentifyglslink}[2]{%
+ \glsmfublocker{#2}%
+ \glsxtrdoidentify
+ {%
+ \@glsxtr@providenewglslink
+ \protected@write\@auxout{}{\string\@glsxtr@newglslink{#1}{\string#2}}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsxtrnewglslink}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{@glsxtrnewglslink}\oarg{options}\marg{prefix}\marg{cs}\marg{inner cs
+%name}
+%\end{definition}
+% \begin{macrocode}
+\newcommand*{\@glsxtrnewglslink}[4]{%
+ \ifdef{#3}%
+ {%
+ \PackageError{glossaries-extra}{Command \string#3\space already
+defined}{}%
+ }%
+ {%
+% \end{macrocode}
+%Write information to the aux file for bib2gls.
+% \begin{macrocode}
+ \glsxtridentifyglslink{#2}{#3}%
+ \ifcsdef{@#4link@#2}%
+ {%
+ \advance\@glsxtrnewgls@inner by \@ne
+ \def\@glsxtrnewgls@innercsname{@#4link\number\@glsxtrnewgls@inner @#2}%
+ }%
+ {\def\@glsxtrnewgls@innercsname{@#4link@#2}}%
+ \expandafter\newrobustcmd\expandafter*\expandafter
+ #3\expandafter{\expandafter\@gls@hyp@opt\csname\@glsxtrnewgls@innercsname\endcsname}%
+ \ifstrempty{#1}%
+ {%
+ \expandafter\newcommand\expandafter*\csname\@glsxtrnewgls@innercsname\endcsname[2][]{%
+ \csname #4\endcsname{##1}{#2##2}%
+ }%
+ }%
+ {%
+ \expandafter\newcommand\expandafter*\csname\@glsxtrnewgls@innercsname\endcsname[2][]{%
+ \csname #4\endcsname{#1,##1}{#2##2}%
+ }%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrnewglslink}
+%\begin{definition}
+%\cs{glsxtrnewglslink}\oarg{options}\marg{prefix}\marg{cs}
+%\end{definition}
+%The first argument prepends to the options and the second argument is the prefix.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newrobustcmd*{\glsxtrnewglslink}[3][]{%
+ \@glsxtrnewglslink{#1}{#2}{#3}{@gls@@link}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrnewglsdisp}
+%\begin{definition}
+%\cs{glsxtrnewglsdisp}\oarg{options}\marg{prefix}\marg{cs}
+%\end{definition}
+%The first argument prepends to the options and the second argument is the prefix.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newrobustcmd*{\glsxtrnewglsdisp}[3][]{%
+ \@glsxtrnewglslink{#1}{#2}{#3}{@glsdisp}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\@glsxtrnewgls}
%\changes{1.21}{2017-11-03}{new}
%\begin{definition}
-%\cs{glsxtrnewgls}\oarg{options}\marg{prefix}\marg{cs}\marg{inner cs
+%\cs{@glsxtrnewgls}\oarg{options}\marg{prefix}\marg{cs}\marg{inner cs
%name}
%\end{definition}
%
@@ -12437,6 +15462,7 @@ defined}{}%
%\changes{1.21}{2017-11-03}{new}
% \begin{macrocode}
\newrobustcmd*{\glsxtrnewglslike}[6][]{%
+ \glsxtridentifyglsfamily{#1}{#2}{#3}{#4}{#5}{#6}{}{}%
\@glsxtrnewgls{#1}{#2}{#3}{gls}%
\@glsxtrnewgls{#1}{#2}{#4}{glspl}%
\@glsxtrnewgls{#1}{#2}{#5}{Gls}%
@@ -12452,6 +15478,7 @@ defined}{}%
%\changes{1.21}{2017-11-03}{new}
% \begin{macrocode}
\newrobustcmd*{\glsxtrnewGLSlike}[4][]{%
+ \glsxtridentifyglsfamily{#1}{#2}{}{}{}{}{#3}{#4}%
\@glsxtrnewgls{#1}{#2}{#3}{GLS}%
\@glsxtrnewgls{#1}{#2}{#4}{GLSpl}%
}
@@ -12473,6 +15500,7 @@ defined}{}%
%\changes{1.21}{2017-11-03}{new}
% \begin{macrocode}
\newrobustcmd*{\glsxtrnewrglslike}[6][]{%
+ \glsxtridentifyglsfamily{#1}{#2}{#3}{#4}{#5}{#6}{}{}%
\@glsxtrnewgls{#1}{#2}{#3}{rgls}%
\@glsxtrnewgls{#1}{#2}{#4}{rglspl}%
\@glsxtrnewgls{#1}{#2}{#5}{rGls}%
@@ -12486,6 +15514,7 @@ defined}{}%
%As \cs{glsxtrnewGLSlike} but for \cs{rGLS} etc.
% \begin{macrocode}
\newrobustcmd*{\glsxtrnewrGLSlike}[4][]{%
+ \glsxtridentifyglsfamily{#1}{#2}{}{}{}{}{#3}{#4}%
\@glsxtrnewgls{#1}{#2}{#3}{rGLS}%
\@glsxtrnewgls{#1}{#2}{#4}{rGLSpl}%
}
@@ -12553,6 +15582,12 @@ defined}{}%
\renewcommand*{\Glspl}{\rGlspl}%
\renewcommand*{\GLS}{\rGLS}%
\renewcommand*{\GLSpl}{\rGLSpl}%
+ \renewcommand{\shortcut@gls}{\rgls}%
+ \renewcommand{\shortcut@glspl}{\rglspl}%
+ \renewcommand{\shortcut@Gls}{\rGls}%
+ \renewcommand{\shortcut@Glspl}{\rGlspl}%
+ \renewcommand{\shortcut@GLS}{\rGLS}%
+ \renewcommand{\shortcut@GLSpl}{\rGLSpl}%
}
% \end{macrocode}
%\end{macro}
@@ -12622,6 +15657,10 @@ defined}{}%
%Save local setting.
% \begin{macrocode}
\@gls@save@glslocal
+% \end{macrocode}
+%Initialise preunset, prereset and postunset
+% \begin{macrocode}
+ \glsinitreunsets
\glsxtrinitwrgloss
\glslinkpresetkeys
\setkeys{glslink}{#1}%
@@ -12637,12 +15676,12 @@ defined}{}%
\glslinkwrcontent
{%
\ifglsxtrinitwrglossbefore
- \@do@wrglossary{#2}%
+ \glsxtr@wrglossary@encap{#2}{\@do@wrglossary{#2}}%
\fi
#3%
\ifglsxtrinitwrglossbefore
\else
- \@do@wrglossary{#2}%
+ \glsxtr@wrglossary@encap{#2}{\@do@wrglossary{#2}}%
\fi
}%
\@gls@restore@glslocal
@@ -12723,6 +15762,7 @@ defined}{}%
%\changes{1.21}{2017-11-03}{new}
% \begin{macrocode}
\newrobustcmd*{\rGls}{\@gls@hyp@opt\@rGls}
+\glsmfuaddmap{\rgls}{\rGls}
% \end{macrocode}
%\end{macro}
%\begin{macro}{\@rGls}
@@ -12752,6 +15792,7 @@ defined}{}%
%\changes{1.21}{2017-11-03}{new}
% \begin{macrocode}
\newrobustcmd*{\rGlspl}{\@gls@hyp@opt\@rGlspl}
+\glsmfuaddmap{\rglspl}{\rGlspl}
% \end{macrocode}
%\end{macro}
%\begin{macro}{\@rGlspl}
@@ -12782,6 +15823,7 @@ defined}{}%
%\changes{1.21}{2017-11-03}{new}
% \begin{macrocode}
\newrobustcmd*{\rGLS}{\@gls@hyp@opt\@rGLS}
+\glsmfublocker{\rGLS}%
% \end{macrocode}
%\end{macro}
%\begin{macro}{\@rGLS}
@@ -12812,6 +15854,7 @@ defined}{}%
%\changes{1.21}{2017-11-03}{new}
% \begin{macrocode}
\newrobustcmd*{\rGLSpl}{\@gls@hyp@opt\@rGLSpl}
+\glsmfublocker{\rGLSpl}%
% \end{macrocode}
%\end{macro}
%\begin{macro}{\@rGLSpl}
@@ -12886,7 +15929,7 @@ defined}{}%
%\changes{1.21}{2017-11-03}{new}
% \begin{macrocode}
\newcommand*{\rGLSformat}[2]{%
- \expandafter\mfirstucMakeUppercase\expandafter{\rglsformat{#1}{#2}}%
+ \expandafter\glsuppercase\expandafter{\rglsformat{#1}{#2}}%
}
% \end{macrocode}
%\end{macro}
@@ -12895,12 +15938,12 @@ defined}{}%
%\changes{1.21}{2017-11-03}{new}
% \begin{macrocode}
\newcommand*{\rGLSplformat}[2]{%
- \expandafter\mfirstucMakeUppercase\expandafter{\rglsplformat{#1}{#2}}%
+ \expandafter\glsuppercase\expandafter{\rglsplformat{#1}{#2}}%
}
% \end{macrocode}
%\end{macro}
%
-%\section{Link Counting}
+%\subsection{Link Counting}
%\label{sec:linkcount}
%This is different to the entry counting provided by the base
%package (which counts the number of times the first use flag is
@@ -13033,16 +16076,20 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
-%\section{Integration with glossaries-accsupp}
+%\subsection{Integration with glossaries-accsupp}
% Provide better integration with the \sty{glossaries-accsupp}
% package. (Must be loaded before the main code of
-% \styfmt{glossaries-extra} either explicitly or through the
+% \sty{glossaries-extra} either explicitly or through the
% \pkgopt{accsupp} package option.)
%
% These commands have their definitions set according to whether
-% or not \styfmt{glossaries-extra} has been loaded.
+% or not \sty{glossaries-extra} has been loaded.
%\changes{0.5.2}{2015-12-08}{fixed typo in glossaries-accsupp and tidied up code to use
% just one \cs{@ifpackageloaded}}
+%
+%To allow for formatting commands that need to go inside all other commands
+%(such as the commands provided by \sty{soul}), also add version
+% of each command that takes a text-block command as an argument.
% \begin{macrocode}
\@ifpackageloaded{glossaries-accsupp}
{
@@ -13063,6 +16110,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtname}
+%\begin{definition}
+%\cs{glsaccessfmtname}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtname}[3]{%
+ \glsnameaccessdisplay
+ {%
+ \glsfmtfield{#1}{#2}{#3}{name}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccessname}
% Display the \gloskey{name} value (no link and no check for existence)
% with the first letter converted to upper case.
@@ -13078,6 +16141,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtname}
+%\begin{definition}
+%\cs{Glsaccessfmtname}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtname}[3]{%
+ \glsnameaccessdisplay
+ {%
+ \Glsfmtfield{#1}{#2}{#3}{name}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccessname}
% Display the \gloskey{name} value (no link and no check for existence)
% converted to upper case.
@@ -13086,13 +16165,29 @@ defined}{}%
\newcommand*{\GLSaccessname}[1]{%
\glsnameaccessdisplay
{%
- \mfirstucMakeUppercase{\glsentryname{#1}}%
+ \glsuppercase{\glsentryname{#1}}%
}%
{#1}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\GLSaccessfmtname}
+%\begin{definition}
+%\cs{GLSaccessfmtname}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtname}[3]{%
+ \glsnameaccessdisplay
+ {%
+ \GLSfmtfield{#1}{#2}{#3}{name}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsaccesstext}
% Display the \gloskey{text} value (no link and no check for existence).
%\changes{0.3}{2015-12-02}{new}
@@ -13107,6 +16202,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmttext}
+%\begin{definition}
+%\cs{glsaccessfmttext}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmttext}[3]{%
+ \glstextaccessdisplay
+ {%
+ \glsfmtfield{#1}{#2}{#3}{text}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccesstext}
% Display the \gloskey{text} value (no link and no check for existence)
% with the first letter converted to upper case.
@@ -13122,6 +16233,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmttext}
+%\begin{definition}
+%\cs{Glsaccessfmttext}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmttext}[3]{%
+ \glstextaccessdisplay
+ {%
+ \Glsfmtfield{#1}{#2}{#3}{text}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccesstext}
% Display the \gloskey{text} value (no link and no check for existence)
% converted to upper case.
@@ -13130,13 +16257,29 @@ defined}{}%
\newcommand*{\GLSaccesstext}[1]{%
\glstextaccessdisplay
{%
- \mfirstucMakeUppercase{\glsentrytext{#1}}%
+ \glsuppercase{\glsentrytext{#1}}%
}%
{#1}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\GLSaccessfmttext}
+%\begin{definition}
+%\cs{GLSaccessfmttext}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmttext}[3]{%
+ \glstextaccessdisplay
+ {%
+ \GLSfmtfield{#1}{#2}{#3}{text}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsaccessplural}
% Display the \gloskey{plural} value (no link and no check for existence).
%\changes{0.3}{2015-12-02}{new}
@@ -13151,6 +16294,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtplural}
+%\begin{definition}
+%\cs{glsaccessfmtplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtplural}[3]{%
+ \glspluralaccessdisplay
+ {%
+ \glsfmtfield{#1}{#2}{#3}{plural}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccessplural}
% Display the \gloskey{plural} value (no link and no check for existence)
% with the first letter converted to upper case.
@@ -13166,6 +16325,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtplural}
+%\begin{definition}
+%\cs{Glsaccessfmtplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtplural}[3]{%
+ \glspluralaccessdisplay
+ {%
+ \Glsfmtfield{#1}{#2}{#3}{plural}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccessplural}
% Display the \gloskey{plural} value (no link and no check for existence)
% converted to upper case.
@@ -13174,13 +16349,29 @@ defined}{}%
\newcommand*{\GLSaccessplural}[1]{%
\glspluralaccessdisplay
{%
- \mfirstucMakeUppercase{\glsentryplural{#1}}%
+ \glsuppercase{\glsentryplural{#1}}%
}%
{#1}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\GLSaccessfmtplural}
+%\begin{definition}
+%\cs{GLSaccessfmtplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtplural}[3]{%
+ \glspluralaccessdisplay
+ {%
+ \GLSfmtfield{#1}{#2}{#3}{plural}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsaccessfirst}
% Display the \gloskey{first} value (no link and no check for existence).
%\changes{0.3}{2015-12-02}{new}
@@ -13195,6 +16386,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtfirst}
+%\begin{definition}
+%\cs{glsaccessfmtfirst}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtfirst}[3]{%
+ \glsfirstaccessdisplay
+ {%
+ \glsfmtfield{#1}{#2}{#3}{first}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccessfirst}
% Display the \gloskey{first} value (no link and no check for existence)
% with the first letter converted to upper case.
@@ -13210,6 +16417,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtfirst}
+%\begin{definition}
+%\cs{Glsaccessfmtfirst}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtfirst}[3]{%
+ \glsfirstaccessdisplay
+ {%
+ \Glsfmtfield{#1}{#2}{#3}{first}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccessfirst}
% Display the \gloskey{first} value (no link and no check for existence)
% converted to upper case.
@@ -13218,13 +16441,29 @@ defined}{}%
\newcommand*{\GLSaccessfirst}[1]{%
\glsfirstaccessdisplay
{%
- \mfirstucMakeUppercase{\glsentryfirst{#1}}%
+ \glsuppercase{\glsentryfirst{#1}}%
}%
{#1}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\GLSaccessfmtfirst}
+%\begin{definition}
+%\cs{GLSaccessfmtfirst}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtfirst}[3]{%
+ \glsfirstaccessdisplay
+ {%
+ \GLSfmtfield{#1}{#2}{#3}{first}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsaccessfirstplural}
% Display the \gloskey{firstplural} value (no link and no check for existence).
%\changes{0.3}{2015-12-02}{new}
@@ -13239,6 +16478,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtfirstplural}
+%\begin{definition}
+%\cs{glsaccessfmtfirstplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtfirstplural}[3]{%
+ \glsfirstpluralaccessdisplay
+ {%
+ \glsfmtfield{#1}{#2}{#3}{firstpl}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccessfirstplural}
% Display the \gloskey{firstplural} value (no link and no check for existence)
% with the first letter converted to upper case.
@@ -13254,6 +16509,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtfirstplural}
+%\begin{definition}
+%\cs{Glsaccessfmtfirstplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtfirstplural}[3]{%
+ \glsfirstpluralaccessdisplay
+ {%
+ \Glsfmtfield{#1}{#2}{#3}{firstpl}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccessfirstplural}
% Display the \gloskey{firstplural} value (no link and no check for existence)
% converted to upper case.
@@ -13262,13 +16533,29 @@ defined}{}%
\newcommand*{\GLSaccessfirstplural}[1]{%
\glsfirstpluralaccessdisplay
{%
- \mfirstucMakeUppercase{\glsentryfirstplural{#1}}%
+ \glsuppercase{\glsentryfirstplural{#1}}%
}%
{#1}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\GLSaccessfmtfirstplural}
+%\begin{definition}
+%\cs{GLSaccessfmtfirstplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtfirstplural}[3]{%
+ \glsfirstpluralaccessdisplay
+ {%
+ \GLSfmtfield{#1}{#2}{#3}{firstpl}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsaccesssymbol}
% Display the \gloskey{symbol} value (no link and no check for existence).
%\changes{0.3}{2015-12-02}{new}
@@ -13283,6 +16570,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtsymbol}
+%\begin{definition}
+%\cs{glsaccessfmtsymbol}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtsymbol}[3]{%
+ \glssymbolaccessdisplay
+ {%
+ \glsfmtfield{#1}{#2}{#3}{symbol}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccesssymbol}
% Display the \gloskey{symbol} value (no link and no check for existence)
% with the first letter converted to upper case.
@@ -13298,6 +16601,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtsymbol}
+%\begin{definition}
+%\cs{Glsaccessfmtsymbol}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtsymbol}[3]{%
+ \glssymbolaccessdisplay
+ {%
+ \Glsfmtfield{#1}{#2}{#3}{symbol}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccesssymbol}
% Display the \gloskey{symbol} value (no link and no check for existence)
% converted to upper case.
@@ -13306,13 +16625,29 @@ defined}{}%
\newcommand*{\GLSaccesssymbol}[1]{%
\glssymbolaccessdisplay
{%
- \mfirstucMakeUppercase{\glsentrysymbol{#1}}%
+ \glsuppercase{\glsentrysymbol{#1}}%
}%
{#1}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\GLSaccessfmtsymbol}
+%\begin{definition}
+%\cs{GLSaccessfmtsymbol}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtsymbol}[3]{%
+ \glssymbolaccessdisplay
+ {%
+ \GLSfmtfield{#1}{#2}{#3}{symbol}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsaccesssymbolplural}
% Display the \gloskey{symbolplural} value (no link and no check for existence).
%\changes{0.3}{2015-12-02}{new}
@@ -13327,6 +16662,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtsymbolplural}
+%\begin{definition}
+%\cs{glsaccessfmtsymbolplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtsymbolplural}[3]{%
+ \glssymbolpluralaccessdisplay
+ {%
+ \glsfmtfield{#1}{#2}{#3}{symbolplural}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccesssymbolplural}
% Display the \gloskey{symbolplural} value (no link and no check for existence)
% with the first letter converted to upper case.
@@ -13342,6 +16693,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtsymbolplural}
+%\begin{definition}
+%\cs{Glsaccessfmtsymbolplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtsymbolplural}[3]{%
+ \glssymbolpluralaccessdisplay
+ {%
+ \Glsfmtfield{#1}{#2}{#3}{symbolplural}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccesssymbolplural}
% Display the \gloskey{symbolplural} value (no link and no check for existence)
% converted to upper case.
@@ -13350,13 +16717,29 @@ defined}{}%
\newcommand*{\GLSaccesssymbolplural}[1]{%
\glssymbolpluralaccessdisplay
{%
- \mfirstucMakeUppercase{\glsentrysymbolplural{#1}}%
+ \glsuppercase{\glsentrysymbolplural{#1}}%
}%
{#1}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\GLSaccessfmtsymbolplural}
+%\begin{definition}
+%\cs{GLSaccessfmtsymbolplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtsymbolplural}[3]{%
+ \glssymbolpluralaccessdisplay
+ {%
+ \GLSfmtfield{#1}{#2}{#3}{symbolplural}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsaccessdesc}
% Display the \gloskey{desc} value (no link and no check for existence).
%\changes{0.3}{2015-12-02}{new}
@@ -13371,6 +16754,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtdesc}
+%\begin{definition}
+%\cs{glsaccessfmtdesc}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtdesc}[3]{%
+ \glsdescaccessdisplay
+ {%
+ \glsfmtfield{#1}{#2}{#3}{desc}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccessdesc}
% Display the \gloskey{desc} value (no link and no check for existence)
% with the first letter converted to upper case.
@@ -13386,6 +16785,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtdesc}
+%\begin{definition}
+%\cs{Glsaccessfmtdesc}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtdesc}[3]{%
+ \glsdescaccessdisplay
+ {%
+ \Glsfmtfield{#1}{#2}{#3}{desc}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccessdesc}
% Display the \gloskey{desc} value (no link and no check for existence)
% converted to upper case.
@@ -13394,13 +16809,29 @@ defined}{}%
\newcommand*{\GLSaccessdesc}[1]{%
\glsdescriptionaccessdisplay
{%
- \mfirstucMakeUppercase{\glsentrydesc{#1}}%
+ \glsuppercase{\glsentrydesc{#1}}%
}%
{#1}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\GLSaccessfmtdesc}
+%\begin{definition}
+%\cs{GLSaccessfmtdesc}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtdesc}[3]{%
+ \glsdescaccessdisplay
+ {%
+ \GLSfmtfield{#1}{#2}{#3}{desc}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsaccessdescplural}
% Display the \gloskey{descplural} value (no link and no check for existence).
%\changes{0.3}{2015-12-02}{new}
@@ -13415,6 +16846,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtdescplural}
+%\begin{definition}
+%\cs{glsaccessfmtdescplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtdescplural}[3]{%
+ \glsdescpluralaccessdisplay
+ {%
+ \glsfmtfield{#1}{#2}{#3}{descplural}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccessdescplural}
% Display the \gloskey{descplural} value (no link and no check for existence)
% with the first letter converted to upper case.
@@ -13430,6 +16877,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtdescplural}
+%\begin{definition}
+%\cs{Glsaccessfmtdescplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtdescplural}[3]{%
+ \glsdescpluralaccessdisplay
+ {%
+ \Glsfmtfield{#1}{#2}{#3}{descplural}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccessdescplural}
% Display the \gloskey{descplural} value (no link and no check for existence)
% converted to upper case.
@@ -13438,13 +16901,29 @@ defined}{}%
\newcommand*{\GLSaccessdescplural}[1]{%
\glsdescriptionpluralaccessdisplay
{%
- \mfirstucMakeUppercase{\glsentrydescplural{#1}}%
+ \glsuppercase{\glsentrydescplural{#1}}%
}%
{#1}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\GLSaccessfmtdescplural}
+%\begin{definition}
+%\cs{GLSaccessfmtdescplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtdescplural}[3]{%
+ \glsdescpluralaccessdisplay
+ {%
+ \GLSfmtfield{#1}{#2}{#3}{descplural}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsaccessshort}
% Display the short form (no link and no check for existence).
%\changes{0.3}{2015-12-02}{new}
@@ -13459,6 +16938,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtshort}
+%\begin{definition}
+%\cs{glsaccessfmtshort}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtshort}[3]{%
+ \glsshortaccessdisplay
+ {%
+ \glsfmtfield{#1}{#2}{#3}{short}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccessshort}
% Display the short form with first letter converted to uppercase
% (no link and no check for existence).
@@ -13474,6 +16969,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtshort}
+%\begin{definition}
+%\cs{Glsaccessfmtshort}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtshort}[3]{%
+ \glsshortaccessdisplay
+ {%
+ \Glsfmtfield{#1}{#2}{#3}{short}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccessshort}
% Display the \gloskey{short} value (no link and no check for existence)
% converted to upper case.
@@ -13482,13 +16993,29 @@ defined}{}%
\newcommand*{\GLSaccessshort}[1]{%
\glsshortaccessdisplay
{%
- \mfirstucMakeUppercase{\glsentryshort{#1}}%
+ \glsuppercase{\glsentryshort{#1}}%
}%
{#1}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\GLSaccessfmtshort}
+%\begin{definition}
+%\cs{GLSaccessfmtshort}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtshort}[3]{%
+ \glsshortaccessdisplay
+ {%
+ \GLSfmtfield{#1}{#2}{#3}{short}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsaccessshortpl}
% Display the short plural form (no link and no check for existence).
%\changes{0.3}{2015-12-02}{new}
@@ -13503,6 +17030,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtshortpl}
+%\begin{definition}
+%\cs{glsaccessfmtshortpl}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtshortpl}[3]{%
+ \glsshortpluralaccessdisplay
+ {%
+ \glsfmtfield{#1}{#2}{#3}{shortpl}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccessshortpl}
% Display the short plural form with first letter converted to
% uppercase (no link and no check for existence).
@@ -13518,6 +17061,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtshortpl}
+%\begin{definition}
+%\cs{Glsaccessfmtshortpl}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtshortpl}[3]{%
+ \glsshortpluralaccessdisplay
+ {%
+ \Glsfmtfield{#1}{#2}{#3}{shortpl}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccessshortpl}
% Display the \gloskey{shortplural} value (no link and no check for existence)
% converted to upper case.
@@ -13526,13 +17085,29 @@ defined}{}%
\newcommand*{\GLSaccessshortpl}[1]{%
\glsshortpluralaccessdisplay
{%
- \mfirstucMakeUppercase{\glsentryshortpl{#1}}%
+ \glsuppercase{\glsentryshortpl{#1}}%
}%
{#1}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\GLSaccessfmtshortpl}
+%\begin{definition}
+%\cs{GLSaccessfmtshortpl}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtshortpl}[3]{%
+ \glsshortpluralaccessdisplay
+ {%
+ \GLSfmtfield{#1}{#2}{#3}{shortpl}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsaccesslong}
% Display the long form (no link and no check for existence).
%\changes{0.3}{2015-12-02}{new}
@@ -13543,17 +17118,48 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtlong}
+%\begin{definition}
+%\cs{glsaccessfmtlong}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtlong}[3]{%
+ \glslongaccessdisplay
+ {%
+ \glsfmtfield{#1}{#2}{#3}{long}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccesslong}
% Display the long form (no link and no check for existence).
%\changes{0.3}{2015-12-02}{new}
% \begin{macrocode}
-
\newcommand*{\Glsaccesslong}[1]{%
\glslongaccessdisplay{\Glsentrylong{#1}}{#1}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtlong}
+%\begin{definition}
+%\cs{Glsaccessfmtlong}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtlong}[3]{%
+ \glslongaccessdisplay
+ {%
+ \Glsfmtfield{#1}{#2}{#3}{long}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccesslong}
% Display the \gloskey{long} value (no link and no check for existence)
% converted to upper case.
@@ -13562,13 +17168,29 @@ defined}{}%
\newcommand*{\GLSaccesslong}[1]{%
\glslongaccessdisplay
{%
- \mfirstucMakeUppercase{\glsentrylong{#1}}%
+ \glsuppercase{\glsentrylong{#1}}%
}%
{#1}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\GLSaccessfmtlong}
+%\begin{definition}
+%\cs{GLSaccessfmtlong}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtlong}[3]{%
+ \glslongaccessdisplay
+ {%
+ \GLSfmtfield{#1}{#2}{#3}{long}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsaccesslongpl}
% Display the long plural form (no link and no check for existence).
%\changes{0.5.2}{2015-12-08}{new}
@@ -13579,6 +17201,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtlongpl}
+%\begin{definition}
+%\cs{glsaccessfmtlongpl}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtlongpl}[3]{%
+ \glslongpluralaccessdisplay
+ {%
+ \glsfmtfield{#1}{#2}{#3}{longpl}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccesslongpl}
% Display the long plural form (no link and no check for existence).
%\changes{0.5.2}{2015-12-08}{new}
@@ -13590,6 +17228,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtlongpl}
+%\begin{definition}
+%\cs{Glsaccessfmtlongpl}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtlongpl}[3]{%
+ \glslongpluralaccessdisplay
+ {%
+ \Glsfmtfield{#1}{#2}{#3}{longpl}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccesslongpl}
% Display the \gloskey{longplural} value (no link and no check for existence)
% converted to upper case.
@@ -13598,14 +17252,880 @@ defined}{}%
\newcommand*{\GLSaccesslongpl}[1]{%
\glslongpluralaccessdisplay
{%
- \mfirstucMakeUppercase{\glsentrylongpl{#1}}%
+ \glsuppercase{\glsentrylongpl{#1}}%
}%
{#1}%
}
% \end{macrocode}
%\end{macro}
%
-% Keys for accessibility support.
+%\begin{macro}{\GLSaccessfmtlongpl}
+%\begin{definition}
+%\cs{GLSaccessfmtlongpl}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtlongpl}[3]{%
+ \glslongpluralaccessdisplay
+ {%
+ \GLSfmtfield{#1}{#2}{#3}{longpl}%
+ }%
+ {#3}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%The user accessibility fields were added to
+%\sty{glossaries-accsupp} v4.45 so these may not be defined.
+%
+%USER1
+%\begin{macro}{\glsaccessuseri}
+% Display the \gloskey{user1} value (no link and no check for existence).
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuseriaccessdisplay
+ {
+ \newcommand*{\glsaccessuseri}[1]{%
+ \glsuseriaccessdisplay
+ {%
+ \glsentryuseri{#1}%
+ }%
+ {#1}%
+ }
+ }
+ {
+ \newcommand*{\glsaccessuseri}[1]{%
+ \glsentryuseri{#1}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsaccessfmtuseri}
+%\begin{definition}
+%\cs{glsaccessfmtuseri}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuseriaccessdisplay
+ {
+ \newcommand*{\glsaccessfmtuseri}[3]{%
+ \glsuseriaccessdisplay
+ {%
+ \glsfmtfield{#1}{#2}{#3}{useri}%
+ }%
+ {#3}%
+ }
+ }
+ {
+ \newcommand*{\glsaccessfmtuseri}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{useri}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessuseri}
+% Display the \gloskey{user1} value (no link and no check for existence)
+% with the first letter converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuseriaccessdisplay
+ {
+ \newcommand*{\Glsaccessuseri}[1]{%
+ \glsuseriaccessdisplay
+ {%
+ \Glsentryuseri{#1}%
+ }%
+ {#1}%
+ }
+ }
+ {
+ \newcommand*{\Glsaccessuseri}[1]{%
+ \Glsentryuseri{#1}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessfmtuseri}
+%\begin{definition}
+%\cs{Glsaccessfmtuseri}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuseriaccessdisplay
+ {
+ \newcommand*{\Glsaccessfmtuseri}[3]{%
+ \glsuseriaccessdisplay
+ {%
+ \Glsfmtfield{#1}{#2}{#3}{useri}%
+ }%
+ {#3}%
+ }
+ }
+ {
+ \newcommand*{\Glsaccessfmtuseri}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{useri}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessuseri}
+% Display the \gloskey{user1} value (no link and no check for existence)
+% converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuseriaccessdisplay
+ {
+ \newcommand*{\GLSaccessuseri}[1]{%
+ \glsuseriaccessdisplay
+ {%
+ \glsuppercase{\glsentryuseri{#1}}%
+ }%
+ {#1}%
+ }
+ }
+ {
+ \newcommand*{\GLSaccessuseri}[1]{%
+ \glsuppercase{\glsentryuseri{#1}}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtuseri}
+%\begin{definition}
+%\cs{GLSaccessfmtuseri}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuseriaccessdisplay
+ {
+ \newcommand*{\GLSaccessfmtuseri}[3]{%
+ \glsuseriaccessdisplay
+ {%
+ \GLSfmtfield{#1}{#2}{#3}{useri}%
+ }%
+ {#3}%
+ }
+ }
+ {
+ \newcommand*{\GLSaccessfmtuseri}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{useri}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%USER2
+%\begin{macro}{\glsaccessuserii}
+% Display the \gloskey{user2} value (no link and no check for existence).
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuseriiaccessdisplay
+ {
+ \newcommand*{\glsaccessuserii}[1]{%
+ \glsuseriiaccessdisplay
+ {%
+ \glsentryuserii{#1}%
+ }%
+ {#1}%
+ }
+ }
+ {
+ \newcommand*{\glsaccessuserii}[1]{%
+ \glsentryuserii{#1}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsaccessfmtuserii}
+%\begin{definition}
+%\cs{glsaccessfmtuserii}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuseriiaccessdisplay
+ {
+ \newcommand*{\glsaccessfmtuserii}[3]{%
+ \glsuseriiaccessdisplay
+ {%
+ \glsfmtfield{#1}{#2}{#3}{userii}%
+ }%
+ {#3}%
+ }
+ }
+ {
+ \newcommand*{\glsaccessfmtuserii}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{userii}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessuserii}
+% Display the \gloskey{user2} value (no link and no check for existence)
+% with the first letter converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuseriiaccessdisplay
+ {
+ \newcommand*{\Glsaccessuserii}[1]{%
+ \glsuseriiaccessdisplay
+ {%
+ \Glsentryuserii{#1}%
+ }%
+ {#1}%
+ }
+ }
+ {
+ \newcommand*{\Glsaccessuserii}[1]{%
+ \Glsentryuserii{#1}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessfmtuserii}
+%\begin{definition}
+%\cs{Glsaccessfmtuserii}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuseriiaccessdisplay
+ {
+ \newcommand*{\Glsaccessfmtuserii}[3]{%
+ \glsuseriiaccessdisplay
+ {%
+ \Glsfmtfield{#1}{#2}{#3}{userii}%
+ }%
+ {#3}%
+ }
+ }
+ {
+ \newcommand*{\Glsaccessfmtuserii}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{userii}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessuserii}
+% Display the \gloskey{user2} value (no link and no check for existence)
+% converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuseriiaccessdisplay
+ {
+ \newcommand*{\GLSaccessuserii}[1]{%
+ \glsuseriiaccessdisplay
+ {%
+ \glsuppercase{\glsentryuserii{#1}}%
+ }%
+ {#1}%
+ }
+ }
+ {
+ \newcommand*{\GLSaccessuserii}[1]{%
+ \glsuppercase{\glsentryuserii{#1}}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtuserii}
+%\begin{definition}
+%\cs{GLSaccessfmtuserii}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuseriiaccessdisplay
+ {
+ \newcommand*{\GLSaccessfmtuserii}[3]{%
+ \glsuseriiaccessdisplay
+ {%
+ \GLSfmtfield{#1}{#2}{#3}{userii}%
+ }%
+ {#3}%
+ }
+ }
+ {
+ \newcommand*{\GLSaccessfmtuserii}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{userii}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%USER3
+%\begin{macro}{\glsaccessuseriii}
+% Display the \gloskey{user3} value (no link and no check for existence).
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuseriiiaccessdisplay
+ {
+ \newcommand*{\glsaccessuseriii}[1]{%
+ \glsuseriiiaccessdisplay
+ {%
+ \glsentryuseriii{#1}%
+ }%
+ {#1}%
+ }
+ }
+ {
+ \newcommand*{\glsaccessuseriii}[1]{%
+ \glsentryuseriii{#1}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsaccessfmtuseriii}
+%\begin{definition}
+%\cs{glsaccessfmtuseriii}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuseriiiaccessdisplay
+ {
+ \newcommand*{\glsaccessfmtuseriii}[3]{%
+ \glsuseriiiaccessdisplay
+ {%
+ \glsfmtfield{#1}{#2}{#3}{useriii}%
+ }%
+ {#3}%
+ }
+ }
+ {
+ \newcommand*{\glsaccessfmtuseriii}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{useriii}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessuseriii}
+% Display the \gloskey{user3} value (no link and no check for existence)
+% with the first letter converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuseriiiaccessdisplay
+ {
+ \newcommand*{\Glsaccessuseriii}[1]{%
+ \glsuseriiiaccessdisplay
+ {%
+ \Glsentryuseriii{#1}%
+ }%
+ {#1}%
+ }
+ }
+ {
+ \newcommand*{\Glsaccessuseriii}[1]{%
+ \Glsentryuseriii{#1}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessfmtuseriii}
+%\begin{definition}
+%\cs{Glsaccessfmtuseriii}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuseriiiaccessdisplay
+ {
+ \newcommand*{\Glsaccessfmtuseriii}[3]{%
+ \glsuseriiiaccessdisplay
+ {%
+ \Glsfmtfield{#1}{#2}{#3}{useriii}%
+ }%
+ {#3}%
+ }
+ }
+ {
+ \newcommand*{\Glsaccessfmtuseriii}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{useriii}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessuseriii}
+% Display the \gloskey{user3} value (no link and no check for existence)
+% converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuseriiiaccessdisplay
+ {
+ \newcommand*{\GLSaccessuseriii}[1]{%
+ \glsuseriiiaccessdisplay
+ {%
+ \glsuppercase{\glsentryuseriii{#1}}%
+ }%
+ {#1}%
+ }
+ }
+ {
+ \newcommand*{\GLSaccessuseriii}[1]{%
+ \glsuppercase{\glsentryuseriii{#1}}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtuseriii}
+%\begin{definition}
+%\cs{GLSaccessfmtuseriii}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuseriiiaccessdisplay
+ {
+ \newcommand*{\GLSaccessfmtuseriii}[3]{%
+ \glsuseriiiaccessdisplay
+ {%
+ \GLSfmtfield{#1}{#2}{#3}{useriii}%
+ }%
+ {#3}%
+ }
+ }
+ {
+ \newcommand*{\GLSaccessfmtuseriii}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{useriii}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%USER4
+%\begin{macro}{\glsaccessuseriv}
+% Display the \gloskey{user4} value (no link and no check for existence).
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuserivaccessdisplay
+ {
+ \newcommand*{\glsaccessuseriv}[1]{%
+ \glsuserivaccessdisplay
+ {%
+ \glsentryuseriv{#1}%
+ }%
+ {#1}%
+ }
+ }
+ {
+ \newcommand*{\glsaccessuseriv}[1]{%
+ \glsentryuseriv{#1}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsaccessfmtuseriv}
+%\begin{definition}
+%\cs{glsaccessfmtuseriv}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuserivaccessdisplay
+ {
+ \newcommand*{\glsaccessfmtuseriv}[3]{%
+ \glsuserivaccessdisplay
+ {%
+ \glsfmtfield{#1}{#2}{#3}{useriv}%
+ }%
+ {#3}%
+ }
+ }
+ {
+ \newcommand*{\glsaccessfmtuseriv}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{useriv}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessuseriv}
+% Display the \gloskey{user4} value (no link and no check for existence)
+% with the first letter converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuserivaccessdisplay
+ {
+ \newcommand*{\Glsaccessuseriv}[1]{%
+ \glsuserivaccessdisplay
+ {%
+ \Glsentryuseriv{#1}%
+ }%
+ {#1}%
+ }
+ }
+ {
+ \newcommand*{\Glsaccessuseriv}[1]{%
+ \Glsentryuseriv{#1}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessfmtuseriv}
+%\begin{definition}
+%\cs{Glsaccessfmtuseriv}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuserivaccessdisplay
+ {
+ \newcommand*{\Glsaccessfmtuseriv}[3]{%
+ \glsuserivaccessdisplay
+ {%
+ \Glsfmtfield{#1}{#2}{#3}{useriv}%
+ }%
+ {#3}%
+ }
+ }
+ {
+ \newcommand*{\Glsaccessfmtuseriv}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{useriv}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessuseriv}
+% Display the \gloskey{user4} value (no link and no check for existence)
+% converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuserivaccessdisplay
+ {
+ \newcommand*{\GLSaccessuseriv}[1]{%
+ \glsuserivaccessdisplay
+ {%
+ \glsuppercase{\glsentryuseriv{#1}}%
+ }%
+ {#1}%
+ }
+ }
+ {
+ \newcommand*{\GLSaccessuseriv}[1]{%
+ \glsuppercase{\glsentryuseriv{#1}}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtuseriv}
+%\begin{definition}
+%\cs{GLSaccessfmtuseriv}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuserivaccessdisplay
+ {
+ \newcommand*{\GLSaccessfmtuseriv}[3]{%
+ \glsuserivaccessdisplay
+ {%
+ \GLSfmtfield{#1}{#2}{#3}{useriv}%
+ }%
+ {#3}%
+ }
+ }
+ {
+ \newcommand*{\GLSaccessfmtuseriv}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{useriv}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%USER5
+%\begin{macro}{\glsaccessuserv}
+% Display the \gloskey{user5} value (no link and no check for existence).
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuservaccessdisplay
+ {
+ \newcommand*{\glsaccessuserv}[1]{%
+ \glsuservaccessdisplay
+ {%
+ \glsentryuserv{#1}%
+ }%
+ {#1}%
+ }
+ }
+ {
+ \newcommand*{\glsaccessuserv}[1]{%
+ \glsentryuserv{#1}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsaccessfmtuserv}
+%\begin{definition}
+%\cs{glsaccessfmtuserv}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuservaccessdisplay
+ {
+ \newcommand*{\glsaccessfmtuserv}[3]{%
+ \glsuservaccessdisplay
+ {%
+ \glsfmtfield{#1}{#2}{#3}{userv}%
+ }%
+ {#3}%
+ }
+ }
+ {
+ \newcommand*{\glsaccessfmtuserv}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{userv}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessuserv}
+% Display the \gloskey{user5} value (no link and no check for existence)
+% with the first letter converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuservaccessdisplay
+ {
+ \newcommand*{\Glsaccessuserv}[1]{%
+ \glsuservaccessdisplay
+ {%
+ \Glsentryuserv{#1}%
+ }%
+ {#1}%
+ }
+ }
+ {
+ \newcommand*{\Glsaccessuserv}[1]{%
+ \Glsentryuserv{#1}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessfmtuserv}
+%\begin{definition}
+%\cs{Glsaccessfmtuserv}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuservaccessdisplay
+ {
+ \newcommand*{\Glsaccessfmtuserv}[3]{%
+ \glsuservaccessdisplay
+ {%
+ \Glsfmtfield{#1}{#2}{#3}{userv}%
+ }%
+ {#3}%
+ }
+ }
+ {
+ \newcommand*{\Glsaccessfmtuserv}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{userv}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessuserv}
+% Display the \gloskey{user5} value (no link and no check for existence)
+% converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuservaccessdisplay
+ {
+ \newcommand*{\GLSaccessuserv}[1]{%
+ \glsuservaccessdisplay
+ {%
+ \glsuppercase{\glsentryuserv{#1}}%
+ }%
+ {#1}%
+ }
+ }
+ {
+ \newcommand*{\GLSaccessuserv}[1]{%
+ \glsuppercase{\glsentryuserv{#1}}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtuserv}
+%\begin{definition}
+%\cs{GLSaccessfmtuserv}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuservaccessdisplay
+ {
+ \newcommand*{\GLSaccessfmtuserv}[3]{%
+ \glsuservaccessdisplay
+ {%
+ \GLSfmtfield{#1}{#2}{#3}{userv}%
+ }%
+ {#3}%
+ }
+ }
+ {
+ \newcommand*{\GLSaccessfmtuserv}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{userv}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%USER6
+%\begin{macro}{\glsaccessuservi}
+% Display the \gloskey{user6} value (no link and no check for existence).
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuserviaccessdisplay
+ {
+ \newcommand*{\glsaccessuservi}[1]{%
+ \glsuserviaccessdisplay
+ {%
+ \glsentryuservi{#1}%
+ }%
+ {#1}%
+ }
+ }
+ {
+ \newcommand*{\glsaccessuservi}[1]{%
+ \glsentryuservi{#1}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsaccessfmtuservi}
+%\begin{definition}
+%\cs{glsaccessfmtuservi}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuserviaccessdisplay
+ {
+ \newcommand*{\glsaccessfmtuservi}[3]{%
+ \glsuserviaccessdisplay
+ {%
+ \glsfmtfield{#1}{#2}{#3}{uservi}%
+ }%
+ {#3}%
+ }
+ }
+ {
+ \newcommand*{\glsaccessfmtuservi}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{uservi}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessuservi}
+% Display the \gloskey{user6} value (no link and no check for existence)
+% with the first letter converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuserviaccessdisplay
+ {
+ \newcommand*{\Glsaccessuservi}[1]{%
+ \glsuserviaccessdisplay
+ {%
+ \Glsentryuservi{#1}%
+ }%
+ {#1}%
+ }
+ }
+ {
+ \newcommand*{\Glsaccessuservi}[1]{%
+ \Glsentryuservi{#1}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessfmtuservi}
+%\begin{definition}
+%\cs{Glsaccessfmtuservi}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuserviaccessdisplay
+ {
+ \newcommand*{\Glsaccessfmtuservi}[3]{%
+ \glsuserviaccessdisplay
+ {%
+ \Glsfmtfield{#1}{#2}{#3}{uservi}%
+ }%
+ {#3}%
+ }
+ }
+ {
+ \newcommand*{\Glsaccessfmtuservi}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{uservi}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessuservi}
+% Display the \gloskey{user6} value (no link and no check for existence)
+% converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuserviaccessdisplay
+ {
+ \newcommand*{\GLSaccessuservi}[1]{%
+ \glsuserviaccessdisplay
+ {%
+ \glsuppercase{\glsentryuservi{#1}}%
+ }%
+ {#1}%
+ }
+ }
+ {
+ \newcommand*{\GLSaccessuservi}[1]{%
+ \glsuppercase{\glsentryuservi{#1}}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtuservi}
+%\begin{definition}
+%\cs{GLSaccessfmtuservi}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \ifdef\glsuserviaccessdisplay
+ {
+ \newcommand*{\GLSaccessfmtuservi}[3]{%
+ \glsuserviaccessdisplay
+ {%
+ \GLSfmtfield{#1}{#2}{#3}{uservi}%
+ }%
+ {#3}%
+ }
+ }
+ {
+ \newcommand*{\GLSaccessfmtuservi}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{uservi}%
+ }
+ }
+% \end{macrocode}
+%\end{macro}
+%
+% Keys for accessibility support while pre-parsing in
+% \cs{newabbreviation}.
% \begin{macrocode}
\define@key{glsxtrabbrv}{access}{%
\def\@gls@nameaccess{#1}%
@@ -13654,8 +18174,9 @@ defined}{}%
}
% \end{macrocode}
%
+%\changes{1.49}{2022-10-14}{corrected name of longpluralaccess field}
% \begin{macrocode}
- \define@key{glsxtrabbrv}{shortlonglaccess}{%
+ \define@key{glsxtrabbrv}{longpluralaccess}{%
\def\@gls@longaccesspl{#1}%
}
% \end{macrocode}
@@ -13682,19 +18203,19 @@ defined}{}%
%\end{definition}
%\changes{1.31}{2018-05-09}{new}
% \begin{macrocode}
-\newcommand*{\@gls@ifaccessattribute@set}[3]{%
- \glsifcategoryattribute{\glscategorylabel}{access#1}{true}%
- {#2}%
- {%
- \glsifcategoryattribute{\glscategorylabel}{access#1}{false}%
- {#3}%
+ \newcommand*{\@gls@ifaccessattribute@set}[3]{%
+ \glsifcategoryattribute{\glscategorylabel}{access#1}{true}%
+ {#2}%
{%
- \glsifcategoryattribute{\glscategorylabel}{#1}{true}%
- {#2}%
+ \glsifcategoryattribute{\glscategorylabel}{access#1}{false}%
{#3}%
+ {%
+ \glsifcategoryattribute{\glscategorylabel}{#1}{true}%
+ {#2}%
+ {#3}%
+ }%
}%
- }%
-}
+ }
% \end{macrocode}
%\end{macro}
%
@@ -13707,18 +18228,22 @@ defined}{}%
%
%\begin{macro}{\glsdefaultshortaccess}
%\changes{1.42}{2020-02-03}{new}
+%\changes{1.49}{2022-10-14}{reverted to original definition}
%\begin{definition}
%\cs{glsdefaultshortaccess}\marg{long}\marg{short}
%\end{definition}
-%This command was only introduced to \sty{glossaries-accsupp} 1.42
-%so it may not be defined.
+%This command was only introduced to \sty{glossaries-accsupp} 4.45
+%so it may not be defined. This was defined to do \verb|#1 (#2)| but
+%the original definition is more appropriate, so has been reverted
+%back to the definition provided by \sty{glossaries-accsupp}.
% \begin{macrocode}
- \def\glsdefaultshortaccess#1#2{#1 (#2)}
+ \providecommand*{\glsdefaultshortaccess}[2]{#1}
% \end{macrocode}
%\end{macro}
%
%\begin{macro}{\glsxtrassignactualsetup}
%\changes{1.42}{2020-02-03}{new}
+%\changes{1.49}{2022-10-14}{added \cs{glstextup}}
% \begin{macrocode}
\newcommand{\glsxtrassignactualsetup}{%
\let\@\empty
@@ -13731,43 +18256,25 @@ defined}{}%
\let\textrm\@firstofone
\let\textsf\@firstofone
\let\texttt\@firstofone
+ \let\glstextup\@firstofone
}
% \end{macrocode}
%\end{macro}
%
%\begin{macro}{\@gls@assign@actual}
%\changes{1.42}{2020-02-03}{new}
+%\changes{1.49}{2022-10-14}{removed use of \cs{pdfstringdef}}
% \begin{macrocode}
- \ifdef\pdfstringdef
- {
- \newcommand{\@gls@assign@actual}{%
- \begingroup
- \glsxtrassignactualsetup
- \pdfstringdef\@gls@actualshort{\glsxtrorgshort}%
- \pdfstringdef\@gls@actuallong{\glsxtrorglong}%
- \pdfstringdef\@gls@actualshortpl{\@gls@shortpl}%
- \pdfstringdef\@gls@actuallongpl{\@gls@longpl}%
- \protected@edef\@gls@tmp{\endgroup
- \def\noexpand\@gls@actualshort{\expandonce\@gls@actualshort}%
- \def\noexpand\@gls@actuallong{\expandonce\@gls@actuallong}%
- \def\noexpand\@gls@actualshortpl{\expandonce\@gls@actualshortpl}%
- \def\noexpand\@gls@actuallongpl{\expandonce\@gls@actuallongpl}%
- }%
- \@gls@tmp
- }
- }
- {
- \newcommand{\@gls@assign@actual}{%
- \begingroup
- \glsxtrassignactualsetup
- \protected@edef\@gls@tmp{\endgroup
- \def\noexpand\@gls@actualshort{\glsxtrorgshort}%
- \def\noexpand\@gls@actuallong{\glsxtrorglong}%
- \def\noexpand\@gls@actualshortpl{\@gls@shortpl}%
- \def\noexpand\@gls@actuallongpl{\@gls@longpl}%
- }%
- \@gls@tmp
- }
+ \newcommand{\@gls@assign@actual}{%
+ \begingroup
+ \glsxtrassignactualsetup
+ \protected@edef\@gls@tmp{\endgroup
+ \def\noexpand\@gls@actualshort{\glsxtrorgshort}%
+ \def\noexpand\@gls@actuallong{\glsxtrorglong}%
+ \def\noexpand\@gls@actualshortpl{\@gls@shortpl}%
+ \def\noexpand\@gls@actuallongpl{\@gls@longpl}%
+ }%
+ \@gls@tmp
}
% \end{macrocode}
%\end{macro}
@@ -14022,6 +18529,18 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtname}
+%\begin{definition}
+%\cs{glsaccessfmtname}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtname}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{name}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccessname}
% Display the \gloskey{name} value (no link and no check for existence)
% with the first letter converted to upper case.
@@ -14030,13 +18549,37 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtname}
+%\begin{definition}
+%\cs{Glsaccessfmtname}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtname}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{name}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccessname}
% Display the \gloskey{name} value (no link and no check for existence).
% converted to upper case.
%\changes{0.5.2}{2015-12-08}{new}
% \begin{macrocode}
\newcommand*{\GLSaccessname}[1]{%
- \protect\mfirstucMakeUppercase{\glsentryname{#1}}}
+ \protect\glsuppercase{\glsentryname{#1}}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtname}
+%\begin{definition}
+%\cs{GLSaccessfmtname}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtname}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{name}%
+ }
% \end{macrocode}
%\end{macro}
%
@@ -14047,6 +18590,18 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmttext}
+%\begin{definition}
+%\cs{glsaccessfmttext}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmttext}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{text}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccesstext}
% Display the \gloskey{text} value (no link and no check for existence)
% with the first letter converted to upper case.
@@ -14055,13 +18610,37 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmttext}
+%\begin{definition}
+%\cs{Glsaccessfmttext}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmttext}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{text}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccesstext}
% Display the \gloskey{text} value (no link and no check for existence).
% converted to upper case.
%\changes{0.5.2}{2015-12-08}{new}
% \begin{macrocode}
\newcommand*{\GLSaccesstext}[1]{%
- \protect\mfirstucMakeUppercase{\glsentrytext{#1}}}
+ \protect\glsuppercase{\glsentrytext{#1}}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmttext}
+%\begin{definition}
+%\cs{GLSaccessfmttext}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmttext}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{text}%
+ }
% \end{macrocode}
%\end{macro}
%
@@ -14072,6 +18651,18 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtplural}
+%\begin{definition}
+%\cs{glsaccessfmtplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtplural}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{plural}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccessplural}
% Display the \gloskey{plural} value (no link and no check for existence)
% with the first letter converted to upper case.
@@ -14080,13 +18671,37 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtplural}
+%\begin{definition}
+%\cs{Glsaccessfmtplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtplural}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{plural}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccessplural}
% Display the \gloskey{plural} value (no link and no check for existence).
% converted to upper case.
%\changes{0.5.2}{2015-12-08}{new}
% \begin{macrocode}
\newcommand*{\GLSaccessplural}[1]{%
- \protect\mfirstucMakeUppercase{\glsentryplural{#1}}}
+ \protect\glsuppercase{\glsentryplural{#1}}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtplural}
+%\begin{definition}
+%\cs{GLSaccessfmtplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtplural}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{plural}%
+ }
% \end{macrocode}
%\end{macro}
%
@@ -14097,6 +18712,18 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtfirst}
+%\begin{definition}
+%\cs{glsaccessfmtfirst}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtfirst}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{first}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccessfirst}
% Display the \gloskey{first} value (no link and no check for existence)
% with the first letter converted to upper case.
@@ -14105,13 +18732,37 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtfirst}
+%\begin{definition}
+%\cs{Glsaccessfmtfirst}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtfirst}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{first}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccessfirst}
% Display the \gloskey{first} value (no link and no check for existence).
% converted to upper case.
%\changes{0.5.2}{2015-12-08}{new}
% \begin{macrocode}
\newcommand*{\GLSaccessfirst}[1]{%
- \protect\mfirstucMakeUppercase{\glsentryfirst{#1}}}
+ \protect\glsuppercase{\glsentryfirst{#1}}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtfirst}
+%\begin{definition}
+%\cs{GLSaccessfmtfirst}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtfirst}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{first}%
+ }
% \end{macrocode}
%\end{macro}
%
@@ -14122,6 +18773,18 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtfirstplural}
+%\begin{definition}
+%\cs{glsaccessfmtfirstplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtfirstplural}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{firstpl}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccessfirstplural}
% Display the \gloskey{firstplural} value (no link and no check for existence)
% with the first letter converted to upper case.
@@ -14130,13 +18793,37 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtfirstplural}
+%\begin{definition}
+%\cs{Glsaccessfmtfirstplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtfirstplural}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{firstpl}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccessfirstplural}
% Display the \gloskey{firstplural} value (no link and no check for existence).
% converted to upper case.
%\changes{0.5.2}{2015-12-08}{new}
% \begin{macrocode}
\newcommand*{\GLSaccessfirstplural}[1]{%
- \protect\mfirstucMakeUppercase{\glsentryfirstplural{#1}}}
+ \protect\glsuppercase{\glsentryfirstplural{#1}}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtfirstplural}
+%\begin{definition}
+%\cs{GLSaccessfmtfirstplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtfirstplural}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{firstpl}%
+ }
% \end{macrocode}
%\end{macro}
%
@@ -14147,6 +18834,18 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtsymbol}
+%\begin{definition}
+%\cs{glsaccessfmtsymbol}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtsymbol}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{symbol}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccesssymbol}
% Display the \gloskey{symbol} value (no link and no check for existence)
% with the first letter converted to upper case.
@@ -14155,13 +18854,37 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtsymbol}
+%\begin{definition}
+%\cs{Glsaccessfmtsymbol}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtsymbol}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{symbol}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccesssymbol}
% Display the \gloskey{symbol} value (no link and no check for existence).
% converted to upper case.
%\changes{0.5.2}{2015-12-08}{new}
% \begin{macrocode}
\newcommand*{\GLSaccesssymbol}[1]{%
- \protect\mfirstucMakeUppercase{\glsentrysymbol{#1}}}
+ \protect\glsuppercase{\glsentrysymbol{#1}}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtsymbol}
+%\begin{definition}
+%\cs{GLSaccessfmtsymbol}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtsymbol}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{symbol}%
+ }
% \end{macrocode}
%\end{macro}
%
@@ -14172,6 +18895,18 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtsymbolplural}
+%\begin{definition}
+%\cs{glsaccessfmtsymbolplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtsymbolplural}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{symbolplural}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccesssymbolplural}
% Display the \gloskey{symbolplural} value (no link and no check for existence)
% with the first letter converted to upper case.
@@ -14180,13 +18915,37 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtsymbolplural}
+%\begin{definition}
+%\cs{Glsaccessfmtsymbolplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtsymbolplural}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{symbolplural}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccesssymbolplural}
% Display the \gloskey{symbolplural} value (no link and no check for existence).
% converted to upper case.
%\changes{0.5.2}{2015-12-08}{new}
% \begin{macrocode}
\newcommand*{\GLSaccesssymbolplural}[1]{%
- \protect\mfirstucMakeUppercase{\glsentrysymbolplural{#1}}}
+ \protect\glsuppercase{\glsentrysymbolplural{#1}}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtsymbolplural}
+%\begin{definition}
+%\cs{GLSaccessfmtsymbolplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtsymbolplural}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{symbolplural}%
+ }
% \end{macrocode}
%\end{macro}
%
@@ -14197,6 +18956,18 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtdesc}
+%\begin{definition}
+%\cs{glsaccessfmtdesc}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtdesc}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{desc}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccessdesc}
% Display the \gloskey{desc} value (no link and no check for existence)
% with the first letter converted to upper case.
@@ -14205,13 +18976,37 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtdesc}
+%\begin{definition}
+%\cs{Glsaccessfmtdesc}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtdesc}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{desc}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccessdesc}
% Display the \gloskey{desc} value (no link and no check for existence).
% converted to upper case.
%\changes{0.5.2}{2015-12-08}{new}
% \begin{macrocode}
\newcommand*{\GLSaccessdesc}[1]{%
- \protect\mfirstucMakeUppercase{\glsentrydesc{#1}}}
+ \protect\glsuppercase{\glsentrydesc{#1}}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtdesc}
+%\begin{definition}
+%\cs{GLSaccessfmtdesc}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtdesc}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{desc}%
+ }
% \end{macrocode}
%\end{macro}
%
@@ -14222,6 +19017,18 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtdescplural}
+%\begin{definition}
+%\cs{glsaccessfmtdescplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtdescplural}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{descplural}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccessdescplural}
% Display the \gloskey{descplural} value (no link and no check for existence)
% with the first letter converted to upper case.
@@ -14230,13 +19037,37 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtdescplural}
+%\begin{definition}
+%\cs{Glsaccessfmtdescplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtdescplural}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{descplural}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccessdescplural}
% Display the \gloskey{descplural} value (no link and no check for existence).
% converted to upper case.
%\changes{0.5.2}{2015-12-08}{new}
% \begin{macrocode}
\newcommand*{\GLSaccessdescplural}[1]{%
- \protect\mfirstucMakeUppercase{\glsentrydescplural{#1}}}
+ \protect\glsuppercase{\glsentrydescplural{#1}}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtdescplural}
+%\begin{definition}
+%\cs{GLSaccessfmtdescplural}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtdescplural}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{descplural}%
+ }
% \end{macrocode}
%\end{macro}
%
@@ -14247,6 +19078,18 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtshort}
+%\begin{definition}
+%\cs{glsaccessfmtshort}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtshort}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{short}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccessshort}
% Display the short form with first letter converted to uppercase
% (no link and no check for existence).
@@ -14255,13 +19098,37 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtshort}
+%\begin{definition}
+%\cs{Glsaccessfmtshort}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtshort}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{short}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccessshort}
% Display the \gloskey{short} value (no link and no check for existence).
% converted to upper case.
%\changes{0.5.2}{2015-12-08}{new}
% \begin{macrocode}
\newcommand*{\GLSaccessshort}[1]{%
- \protect\mfirstucMakeUppercase{\glsentryshort{#1}}}
+ \protect\glsuppercase{\glsentryshort{#1}}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtshort}
+%\begin{definition}
+%\cs{GLSaccessfmtshort}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtshort}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{short}%
+ }
% \end{macrocode}
%\end{macro}
%
@@ -14272,6 +19139,18 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtshortpl}
+%\begin{definition}
+%\cs{glsaccessfmtshortpl}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtshortpl}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{shortpl}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccessshortpl}
% Display the short plural form with first letter converted to
% uppercase (no link and no check for existence).
@@ -14280,13 +19159,37 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtshortpl}
+%\begin{definition}
+%\cs{Glsaccessfmtshortpl}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtshortpl}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{shortpl}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccessshortpl}
% Display the \gloskey{shortplural} value (no link and no check for existence).
% converted to upper case.
%\changes{0.5.2}{2015-12-08}{new}
% \begin{macrocode}
\newcommand*{\GLSaccessshortpl}[1]{%
- \protect\mfirstucMakeUppercase{\glsentryshortpl{#1}}}
+ \protect\glsuppercase{\glsentryshortpl{#1}}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtshortpl}
+%\begin{definition}
+%\cs{GLSaccessfmtshortpl}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtshortpl}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{shortpl}%
+ }
% \end{macrocode}
%\end{macro}
%
@@ -14297,6 +19200,18 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtlong}
+%\begin{definition}
+%\cs{glsaccessfmtlong}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtlong}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{long}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccesslong}
% Display the long form (no link and no check for existence).
% \begin{macrocode}
@@ -14304,13 +19219,37 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtlong}
+%\begin{definition}
+%\cs{Glsaccessfmtlong}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtlong}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{long}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccesslong}
% Display the \gloskey{long} value (no link and no check for existence).
% converted to upper case.
%\changes{0.5.2}{2015-12-08}{new}
% \begin{macrocode}
\newcommand*{\GLSaccesslong}[1]{%
- \protect\mfirstucMakeUppercase{\glsentrylong{#1}}}
+ \protect\glsuppercase{\glsentrylong{#1}}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtlong}
+%\begin{definition}
+%\cs{GLSaccessfmtlong}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtlong}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{long}%
+ }
% \end{macrocode}
%\end{macro}
%
@@ -14321,6 +19260,18 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsaccessfmtlongpl}
+%\begin{definition}
+%\cs{glsaccessfmtlongpl}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtlongpl}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{longpl}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\Glsaccesslongpl}
% Display the long plural form (no link and no check for existence).
% \begin{macrocode}
@@ -14328,13 +19279,421 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\Glsaccessfmtlongpl}
+%\begin{definition}
+%\cs{Glsaccessfmtlongpl}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtlongpl}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{longpl}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GLSaccesslongpl}
% Display the \gloskey{longplural} value (no link and no check for existence).
% converted to upper case.
%\changes{0.5.2}{2015-12-08}{new}
% \begin{macrocode}
\newcommand*{\GLSaccesslongpl}[1]{%
- \protect\mfirstucMakeUppercase{\glsentrylongpl{#1}}}
+ \protect\glsuppercase{\glsentrylongpl{#1}}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtlongpl}
+%\begin{definition}
+%\cs{GLSaccessfmtlongpl}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtlongpl}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{longpl}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%USER1
+%\begin{macro}{\glsaccessuseri}
+% Display the \gloskey{user1} value (no link and no check for existence).
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessuseri}[1]{\glsentryuseri{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsaccessfmtuseri}
+%\begin{definition}
+%\cs{glsaccessfmtuseri}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtuseri}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{useri}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessuseri}
+% Display the \gloskey{user1} value (no link and no check for existence)
+% with the first letter converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessuseri}[1]{\Glsentryuseri{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessfmtuseri}
+%\begin{definition}
+%\cs{Glsaccessfmtuseri}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtuseri}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{useri}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessuseri}
+% Display the \gloskey{user1} value (no link and no check for existence).
+% converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessuseri}[1]{%
+ \protect\glsuppercase{\glsentryuseri{#1}}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtuseri}
+%\begin{definition}
+%\cs{GLSaccessfmtuseri}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtuseri}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{useri}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%USER2
+%\begin{macro}{\glsaccessuserii}
+% Display the \gloskey{user2} value (no link and no check for existence).
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessuserii}[1]{\glsentryuserii{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsaccessfmtuserii}
+%\begin{definition}
+%\cs{glsaccessfmtuserii}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtuserii}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{userii}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessuserii}
+% Display the \gloskey{user2} value (no link and no check for existence)
+% with the first letter converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessuserii}[1]{\Glsentryuserii{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessfmtuserii}
+%\begin{definition}
+%\cs{Glsaccessfmtuserii}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtuserii}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{userii}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessuserii}
+% Display the \gloskey{user2} value (no link and no check for existence).
+% converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessuserii}[1]{%
+ \protect\glsuppercase{\glsentryuserii{#1}}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtuserii}
+%\begin{definition}
+%\cs{GLSaccessfmtuserii}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtuserii}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{userii}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%USER3
+%\begin{macro}{\glsaccessuseriii}
+% Display the \gloskey{user3} value (no link and no check for existence).
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessuseriii}[1]{\glsentryuseriii{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsaccessfmtuseriii}
+%\begin{definition}
+%\cs{glsaccessfmtuseriii}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtuseriii}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{useriii}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessuseriii}
+% Display the \gloskey{user3} value (no link and no check for existence)
+% with the first letter converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessuseriii}[1]{\Glsentryuseriii{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessfmtuseriii}
+%\begin{definition}
+%\cs{Glsaccessfmtuseriii}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtuseriii}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{useriii}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessuseriii}
+% Display the \gloskey{user3} value (no link and no check for existence).
+% converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessuseriii}[1]{%
+ \protect\glsuppercase{\glsentryuseriii{#1}}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtuseriii}
+%\begin{definition}
+%\cs{GLSaccessfmtuseriii}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtuseriii}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{useriii}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%USER4
+%\begin{macro}{\glsaccessuseriv}
+% Display the \gloskey{user4} value (no link and no check for existence).
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessuseriv}[1]{\glsentryuseriv{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsaccessfmtuseriv}
+%\begin{definition}
+%\cs{glsaccessfmtuseriv}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtuseriv}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{useriv}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessuseriv}
+% Display the \gloskey{user4} value (no link and no check for existence)
+% with the first letter converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessuseriv}[1]{\Glsentryuseriv{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessfmtuseriv}
+%\begin{definition}
+%\cs{Glsaccessfmtuseriv}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtuseriv}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{useriv}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessuseriv}
+% Display the \gloskey{user4} value (no link and no check for existence).
+% converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessuseriv}[1]{%
+ \protect\glsuppercase{\glsentryuseriv{#1}}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtuseriv}
+%\begin{definition}
+%\cs{GLSaccessfmtuseriv}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtuseriv}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{useriv}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%USER5
+%\begin{macro}{\glsaccessuserv}
+% Display the \gloskey{user5} value (no link and no check for existence).
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessuserv}[1]{\glsentryuserv{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsaccessfmtuserv}
+%\begin{definition}
+%\cs{glsaccessfmtuserv}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtuserv}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{userv}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessuserv}
+% Display the \gloskey{user5} value (no link and no check for existence)
+% with the first letter converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessuserv}[1]{\Glsentryuserv{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessfmtuserv}
+%\begin{definition}
+%\cs{Glsaccessfmtuserv}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtuserv}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{userv}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessuserv}
+% Display the \gloskey{user5} value (no link and no check for existence).
+% converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessuserv}[1]{%
+ \protect\glsuppercase{\glsentryuserv{#1}}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtuserv}
+%\begin{definition}
+%\cs{GLSaccessfmtuserv}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtuserv}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{userv}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%USER6
+%\begin{macro}{\glsaccessuservi}
+% Display the \gloskey{user6} value (no link and no check for existence).
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessuservi}[1]{\glsentryuservi{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsaccessfmtuservi}
+%\begin{definition}
+%\cs{glsaccessfmtuservi}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsaccessfmtuservi}[3]{%
+ \glsfmtfield{#1}{#2}{#3}{uservi}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessuservi}
+% Display the \gloskey{user6} value (no link and no check for existence)
+% with the first letter converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessuservi}[1]{\Glsentryuservi{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsaccessfmtuservi}
+%\begin{definition}
+%\cs{Glsaccessfmtuservi}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\Glsaccessfmtuservi}[3]{%
+ \Glsfmtfield{#1}{#2}{#3}{uservi}%
+ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessuservi}
+% Display the \gloskey{user6} value (no link and no check for existence).
+% converted to upper case.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessuservi}[1]{%
+ \protect\glsuppercase{\glsentryuservi{#1}}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSaccessfmtuservi}
+%\begin{definition}
+%\cs{GLSaccessfmtuservi}\marg{insert}\marg{cs}\marg{label}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\GLSaccessfmtuservi}[3]{%
+ \GLSfmtfield{#1}{#2}{#3}{uservi}%
+ }
% \end{macrocode}
%\end{macro}
%
@@ -14391,8 +19750,87 @@ defined}{}%
}
% \end{macrocode}
%\end{macro}
-%
-%\section{Categories}
+%Identify sentence-case mappings:
+% \begin{macrocode}
+\glsmfuaddmap{\glsaccessname}{\Glsaccessname}
+\glsmfuaddmap{\glsaccessfmtname}{\Glsaccessfmtname}
+\glsmfublocker{\GLSaccessname}
+\glsmfublocker{\GLSaccessfmtname}
+\glsmfuaddmap{\glsaccesstext}{\Glsaccesstext}
+\glsmfuaddmap{\glsaccessfmttext}{\Glsaccessfmttext}
+\glsmfublocker{\GLSaccesstext}
+\glsmfublocker{\GLSaccessfmttext}
+\glsmfuaddmap{\glsaccessplural}{\Glsaccessplural}
+\glsmfuaddmap{\glsaccessfmtplural}{\Glsaccessfmtplural}
+\glsmfublocker{\GLSaccessplural}
+\glsmfublocker{\GLSaccessfmtplural}
+\glsmfuaddmap{\glsaccessfirst}{\Glsaccessfirst}
+\glsmfuaddmap{\glsaccessfmtfirst}{\Glsaccessfmtfirst}
+\glsmfublocker{\GLSaccessfirst}
+\glsmfublocker{\GLSaccessfmtfirst}
+\glsmfuaddmap{\glsaccessfirstplural}{\Glsaccessfirstplural}
+\glsmfuaddmap{\glsaccessfmtfirstplural}{\Glsaccessfmtfirstplural}
+\glsmfublocker{\GLSaccessfirstplural}
+\glsmfublocker{\GLSaccessfmtfirstplural}
+\glsmfuaddmap{\glsaccesssymbol}{\Glsaccesssymbol}
+\glsmfuaddmap{\glsaccessfmtsymbol}{\Glsaccessfmtsymbol}
+\glsmfublocker{\GLSaccesssymbol}
+\glsmfublocker{\GLSaccessfmtsymbol}
+\glsmfuaddmap{\glsaccesssymbolplural}{\Glsaccesssymbolplural}
+\glsmfuaddmap{\glsaccessfmtsymbolplural}{\Glsaccessfmtsymbolplural}
+\glsmfublocker{\GLSaccesssymbolplural}
+\glsmfublocker{\GLSaccessfmtsymbolplural}
+\glsmfuaddmap{\glsaccessdesc}{\Glsaccessdesc}
+\glsmfuaddmap{\glsaccessfmtdesc}{\Glsaccessfmtdesc}
+\glsmfublocker{\GLSaccessdesc}
+\glsmfublocker{\GLSaccessfmtdesc}
+\glsmfuaddmap{\glsaccessdescplural}{\Glsaccessdescplural}
+\glsmfuaddmap{\glsaccessfmtdescplural}{\Glsaccessfmtdescplural}
+\glsmfublocker{\GLSaccessdescplural}
+\glsmfublocker{\GLSaccessfmtdescplural}
+\glsmfuaddmap{\glsaccessshort}{\Glsaccessshort}
+\glsmfuaddmap{\glsaccessfmtshort}{\Glsaccessfmtshort}
+\glsmfublocker{\GLSaccessshort}
+\glsmfublocker{\GLSaccessfmtshort}
+\glsmfuaddmap{\glsaccessshortpl}{\Glsaccessshortpl}
+\glsmfuaddmap{\glsaccessfmtshortpl}{\Glsaccessfmtshortpl}
+\glsmfublocker{\GLSaccessshortpl}
+\glsmfublocker{\GLSaccessfmtshortpl}
+\glsmfuaddmap{\glsaccesslong}{\Glsaccesslong}
+\glsmfuaddmap{\glsaccessfmtlong}{\Glsaccessfmtlong}
+\glsmfublocker{\GLSaccesslong}
+\glsmfublocker{\GLSaccessfmtlong}
+\glsmfuaddmap{\glsaccesslongpl}{\Glsaccesslongpl}
+\glsmfuaddmap{\glsaccessfmtlongpl}{\Glsaccessfmtlongpl}
+\glsmfublocker{\GLSaccesslongpl}
+\glsmfublocker{\GLSaccessfmtlongpl}
+\glsmfuaddmap{\glsaccessuseri}{\Glsaccessuseri}
+\glsmfuaddmap{\glsaccessfmtuseri}{\Glsaccessfmtuseri}
+\glsmfublocker{\GLSaccessuseri}
+\glsmfublocker{\GLSaccessfmtuseri}
+\glsmfuaddmap{\glsaccessuserii}{\Glsaccessuserii}
+\glsmfuaddmap{\glsaccessfmtuserii}{\Glsaccessfmtuserii}
+\glsmfublocker{\GLSaccessuserii}
+\glsmfublocker{\GLSaccessfmtuserii}
+\glsmfuaddmap{\glsaccessuseriii}{\Glsaccessuseriii}
+\glsmfuaddmap{\glsaccessfmtuseriii}{\Glsaccessfmtuseriii}
+\glsmfublocker{\GLSaccessuseriii}
+\glsmfublocker{\GLSaccessfmtuseriii}
+\glsmfuaddmap{\glsaccessuseriv}{\Glsaccessuseriv}
+\glsmfuaddmap{\glsaccessfmtuseriv}{\Glsaccessfmtuseriv}
+\glsmfublocker{\GLSaccessuseriv}
+\glsmfublocker{\GLSaccessfmtuseriv}
+\glsmfuaddmap{\glsaccessuserv}{\Glsaccessuserv}
+\glsmfuaddmap{\glsaccessfmtuserv}{\Glsaccessfmtuserv}
+\glsmfublocker{\GLSaccessuserv}
+\glsmfublocker{\GLSaccessfmtuserv}
+\glsmfuaddmap{\glsaccessuservi}{\Glsaccessuservi}
+\glsmfuaddmap{\glsaccessfmtuservi}{\Glsaccessfmtuservi}
+\glsmfublocker{\GLSaccessuservi}
+\glsmfublocker{\GLSaccessfmtuservi}
+% \end{macrocode}
+%
+%\subsection{Categories}
%\begin{macro}{\glscategory}
% Add a new storage key that can be used to indicate a category. The
% default category is \category{general}.
@@ -14460,6 +19898,22 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glssetcategoryattributes}
+%\begin{definition}
+%\cs{glssetcategoryattributes}\marg{category}\marg{attribute list}\marg{value}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% Similar to above, but globally apply to each attribute in the list
+% to the given category.
+% \begin{macrocode}
+\newcommand*{\glssetcategoryattributes}[3]{%
+ \@for\@gls@thisattrlabel:=#2\do{%
+ \csgdef{@glsxtr@categoryattr@@#1@\@gls@thisattrlabel}{#3}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsgetcategoryattribute}
%\begin{definition}
%\cs{glsgetcategoryattribute}\marg{category}\marg{attribute-label}
@@ -14575,6 +20029,69 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%Provide expandable test to determine if attribute is set to true.
+%\begin{macro}{\@glsxtr@truevalue}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@glsxtr@truevalue}{true}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsifcategoryattributetrue}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glsifcategoryattributetrue}\marg{category-label}\marg{attribute}\marg{true}\marg{false}
+%\end{definition}
+%Does \meta{false} if the entry hasn't been defined.
+% \begin{macrocode}
+\newcommand*{\glsifcategoryattributetrue}[4]{%
+ \ifcsequal{@glsxtr@categoryattr@@#1@#2}%
+ {@glsxtr@truevalue}%
+ {#3}{#4}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsifattributetrue}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glsifattributetrue}\marg{label}\marg{attribute}\marg{true}\marg{false}
+%\end{definition}
+%Does \meta{false} if the entry hasn't been defined.
+% \begin{macrocode}
+\newcommand*{\glsifattributetrue}[4]{%
+ \ifcsundef{glo@\glsdetoklabel{#1}@category}%
+ {#4}
+ {\ifcsequal
+ {@glsxtr@categoryattr@@\csname glo@\glsdetoklabel{#1}@category\endcsname @#2}%
+ {@glsxtr@truevalue}%
+ {#3}{#4}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsifcategoryattributehasitem}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glsifcategoryattributehasitem}\marg{category}\marg{attribute-label}\marg{item}\marg{true
+%part}\marg{false part}
+%\end{definition}
+% True if category has the attribute (whose value is a
+% comma-separated list) contains the given item. The \meta{item} is expanded.
+% \begin{macrocode}
+\newrobustcmd{\glsifcategoryattributehasitem}[5]{%
+ \ifcsundef{@glsxtr@categoryattr@@#1@#2}%
+ {#5}%
+ {%
+ \protected@edef\gls@tmp{%
+ \noexpand\DTLifinlist{#3}{\csuse{@glsxtr@categoryattr@@#1@#2}}}%
+ \gls@tmp{#4}{#5}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
% Set attributes for the default \category{general} category:
% \begin{macrocode}
\glssetcategoryattribute{general}{regular}{true}
@@ -15006,7 +20523,7 @@ defined}{}%
% Hide the label from the upper-casing command.
% \begin{macrocode}
\letcs{\glo@name}{glo@\glsdetoklabel{#1}@name}%
- \@glsxtr@glossnamefont{\mfirstucMakeUppercase{\glo@name}}%
+ \@glsxtr@glossnamefont{\glsuppercase{\glo@name}}%
}%
{#1}%
}%
@@ -15067,12 +20584,12 @@ defined}{}%
% Hide the label from the upper-casing command.
% \begin{macrocode}
\letcs{\glo@name}{glo@\glsdetoklabel{#1}@name}%
- \@glsxtr@glossnamefont{\mfirstucMakeUppercase{\glo@name}}%
+ \@glsxtr@glossnamefont{\glsuppercase{\glo@name}}%
}%
{%
% \end{macrocode}
-% This little trick is used by \styfmt{glossaries} to allow the user to
-% redefine \ics{glsnamefont} to use \cs{makefirstuc}. Support it
+% This little trick is used by \sty{glossaries} to allow the user to
+% redefine \cs{glsnamefont} to use \cs{makefirstuc}. Support it
% even though they can now use the \catattr{firstuc} attribute.
% \begin{macrocode}
\letcs{\glo@name}{glo@\glsdetoklabel{#1}@name}%
@@ -15171,7 +20688,7 @@ defined}{}%
%\end{macro}
%
% Provide a convenient way to also index the entries using the
-% standard \ics{index} mechanism. This may use different actual,
+% standard \cs{index} mechanism. This may use different actual,
% encap and escape characters to those used for the glossaries.
%
%\begin{macro}{\glsxtrpostnamehook}
@@ -15303,7 +20820,7 @@ defined}{}%
{%
\letcs{\glo@name}{glo@\glsdetoklabel{#1}@#2}%
\@glsxtr@accessdisplay
- {\@glsxtr@glossnamefont{\mfirstucMakeUppercase{\glo@name}}}%
+ {\@glsxtr@glossnamefont{\glsuppercase{\glo@name}}}%
{#1}%
}%
{%
@@ -15317,7 +20834,7 @@ defined}{}%
% \end{macrocode}
% Do post-name hook.
% \begin{macrocode}
- \glsxtrpostnamehook{#1}%
+ \glsxtrpostnamehook{#1}%
}%
}
% \end{macrocode}
@@ -15333,7 +20850,7 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
-%If overriding is enabled, the \ics{glshypernumber} command will have to
+%If overriding is enabled, the \cs{glshypernumber} command will have to
%be redefined in the index to use \cs{hyperpage} instead.
%\begin{macro}{\GlsXtrEnableIndexFormatOverride}
% \begin{macrocode}
@@ -15606,25 +21123,25 @@ defined}{}%
%\end{macro}
%
% Set if defined. (For example, if \sty{doc} package has been
-% loaded.) Actual character \ics{actualchar}:
+% loaded.) Actual character \cs{actualchar}:
% \begin{macrocode}
\ifdef\actualchar
{\expandafter\GlsXtrSetActualChar\expandafter{\actualchar}}
{}
% \end{macrocode}
-% Quote character \ics{quotechar}:
+% Quote character \cs{quotechar}:
% \begin{macrocode}
\ifdef\quotechar
{\expandafter\GlsXtrSetEscChar\expandafter{\quotechar}}
{}
% \end{macrocode}
-% Level character \ics{levelchar}:
+% Level character \cs{levelchar}:
% \begin{macrocode}
\ifdef\levelchar
{\expandafter\GlsXtrSetLevelChar\expandafter{\levelchar}}
{}
% \end{macrocode}
-% Encap character \ics{encapchar}:
+% Encap character \cs{encapchar}:
% \begin{macrocode}
\ifdef\encapchar
{\expandafter\GlsXtrSetEncapChar\expandafter{\encapchar}}
@@ -15683,20 +21200,14 @@ defined}{}%
% entry definitions.
%\changes{0.5.2}{2015-12-08}{added}
% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \renewcommand*{\glossentrysymbol}[1]{%
- \texorpdfstring{\@glossentrysymbol{#1}}{\glsentrypdfsymbol{#1}}%
- }
-}
-{
- \renewcommand*{\glossentrysymbol}[1]{\@glossentrysymbol{#1}}
+\renewcommand*{\glossentrysymbol}[1]{%
+ \glstexorpdfstring{\@glossentrysymbol{#1}}{\glsentrypdfsymbol{#1}}%
}
% \end{macrocode}
%\end{macro}
%
%\begin{macro}{\glsentrypdfsymbol}
-%\changes{1.4.2}{??}{new}
+%\changes{1.42}{2020-02-13}{new}
%May be redefined to a field that expands to a value that's more
%suitable for PDF bookmarks.
% \begin{macrocode}
@@ -15705,7 +21216,7 @@ defined}{}%
%\end{macro}
%
%\begin{macro}{\@glossentrysymbol}
-%\changes{1.4.2}{??}{new}
+%\changes{1.42}{2020-02-13}{new}
%There are no case-changing attributes as it's less usual for
%symbols.
%\changes{1.46}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}}
@@ -15859,7 +21370,7 @@ defined}{}%
%\end{macro}
%
%\begin{macro}{\@glsxtr@activate@initialtagging}
-% Used in \cs{printglossary} but at least v4.19 of \styfmt{glossaries}
+% Used in \cs{printglossary} but at least v4.19 of \sty{glossaries}
% required.
%\changes{0.5.2}{2015-12-08}{new}
% \begin{macrocode}
@@ -15887,7 +21398,7 @@ defined}{}%
%\end{macro}
%
%\begin{macro}{\@gls@preglossaryhook}
-% This macro was introduced in \styfmt{glossaries} version 4.19, so it
+% This macro was introduced in \sty{glossaries} version 4.19, so it
% may not be defined. If it hasn't been defined this feature is
% unavailable. A check is added for the entry's existence to prevent
% errors from occurring if the user removes an entry or changes the
@@ -15949,6 +21460,8 @@ defined}{}%
%\end{macro}
%
%\begin{macro}{\glsxtrpostdescterm}
+%This is redundant as it doesn't match any common categories.
+%\cs{newterm} sets the category to index.
% \begin{macrocode}
\newcommand*{\glsxtrpostdescterm}{}
% \end{macrocode}
@@ -16042,6 +21555,48 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glspretopostlink}
+%\changes{1.49}{2022-10-14}{new}
+%Similar to the above but prepend.
+% \begin{macrocode}
+\newcommand*{\glspretopostlink}[2]{%
+% \end{macrocode}
+% \cs{ifthenelse} is used to ensure that the expanded value is
+% tested. (The category label must be fully expandable.)
+% \begin{macrocode}
+ \ifthenelse{\equal{#1}{}}%
+ {\PackageError{glossaries-extra}
+ {Invalid empty category label in \string\glspretopostlink}{}}%
+ {%
+ \ifcsundef{glsxtrpostlink#1}
+ {\csdef{glsxtrpostlink#1}{#2}}%
+ {\cspreto{glsxtrpostlink#1}{#2}}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsapptopostlink}
+%\changes{1.49}{2022-10-14}{new}
+%Similar to the above but append.
+% \begin{macrocode}
+\newcommand*{\glsapptopostlink}[2]{%
+% \end{macrocode}
+% \cs{ifthenelse} is used to ensure that the expanded value is
+% tested. (The category label must be fully expandable.)
+% \begin{macrocode}
+ \ifthenelse{\equal{#1}{}}%
+ {\PackageError{glossaries-extra}
+ {Invalid empty category label in \string\glspretopostlink}{}}%
+ {%
+ \ifcsundef{glsxtrpostlink#1}
+ {\csdef{glsxtrpostlink#1}{#2}}%
+ {\csappto{glsxtrpostlink#1}{#2}}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsxtrpostlinkendsentence}
%\changes{0.3}{2015-12-02}{new}
% Done by \cs{glsxtrpostlinkhook} if a full stop is discarded.
@@ -16072,9 +21627,11 @@ defined}{}%
% first use, for the convenience of users wanting to add this to the
% post link hook.
%\changes{1.25}{2017-11-24}{changed to use \cs{glsxtrparen}}
+%\changes{1.49}{2022-10-14}{added inner formatting}
% \begin{macrocode}
\newcommand*{\glsxtrpostlinkAddDescOnFirstUse}{%
- \glsxtrifwasfirstuse{\space\glsxtrparen{\glsaccessdesc{\glslabel}}}{}%
+ \glsxtrifwasfirstuse{\glsxtrgenentrytextfmt{ }%
+ \glsxtrparen{\glsaccessfmtdesc{}{\glsxtrgenentrytextfmt}{\glslabel}}}{}%
}
% \end{macrocode}
%\end{macro}
@@ -16085,12 +21642,14 @@ defined}{}%
% first use, for the convenience of users wanting to add this to the
% post link hook.
%\changes{1.25}{2017-11-24}{changed to use \cs{glsxtrparen}}
+%\changes{1.49}{2022-10-14}{added inner formatting}
% \begin{macrocode}
\newcommand*{\glsxtrpostlinkAddSymbolOnFirstUse}{%
\glsxtrifwasfirstuse
{%
\ifglshassymbol{\glslabel}%
- {\space\glsxtrparen{\glsaccesssymbol{\glslabel}}}%
+ {\glsxtrgenentrytextfmt{ }%
+ \glsxtrparen{\glsaccessfmtsymbol{}{\glsxtrgenentrytextfmt}{\glslabel}}}%
{}%
}%
{}%
@@ -16108,12 +21667,13 @@ defined}{}%
\newcommand*{\glsxtrpostlinkAddSymbolDescOnFirstUse}{%
\glsxtrifwasfirstuse
{%
- \space\glsxtrparen
+ \glsxtrgenentrytextfmt{ }\glsxtrparen
{%
\ifglshassymbol{\glslabel}%
- {\glsaccesssymbol{\glslabel}, }%
+ {\glsaccessfmtsymbol{}{\glsxtrgenentrytextfmt}{\glslabel}%
+ \expandafter\glsxtrgenentrytextfmt\expandafter{\glsxtrpostlinkSymbolDescSep}}%
{}%
- \glsaccessdesc{\glslabel}%
+ \glsaccessfmtdesc{}{\glsxtrgenentrytextfmt}{\glslabel}%
}%
}%
{}%
@@ -16121,6 +21681,23 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtrpostlinkSymbolDescSep}
+%\changes{1.49}{2022-10-14}{new}
+% Separator used in the above
+% \begin{macrocode}
+\newcommand*{\glsxtrpostlinkSymbolDescSep}{, }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrdiscardperiodretainfirstuse}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrdiscardperiodretainfirstuse}[3]{%
+ \glsxtrifwassubsequentorshort{\glsxtrifperiod{#2}{#3}}{#3}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsxtrdiscardperiod}
% Discard following period (if present) if the
% \catattr{discardperiod} attribute is true. If a period is
@@ -16133,26 +21710,8 @@ defined}{}%
%\changes{1.01}{2016-02-02}{added check for first use}
% \begin{macrocode}
\newcommand*{\glsxtrdiscardperiod}[3]{%
- \glsxtrifwasfirstuse
- {%
- \glsifattribute{#1}{retainfirstuseperiod}{true}%
- {#3}%
- {%
- \glsifattribute{#1}{discardperiod}{true}%
- {%
- \glsifplural
- {%
- \glsifattribute{#1}{pluraldiscardperiod}{true}%
- {\glsxtrifperiod{#2}{#3}}%
- {#3}%
- }%
- {%
- \glsxtrifperiod{#2}{#3}%
- }%
- }%
- {#3}%
- }%
- }%
+ \glsifattribute{#1}{retainfirstuseperiod}{true}%
+ {\glsxtrdiscardperiodretainfirstuse{#1}{#2}{#3}}%
{%
\glsifattribute{#1}{discardperiod}{true}%
{%
@@ -16206,7 +21765,7 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
-%\begin{macro}{\glsxtrifpunc}
+%\begin{macro}{\glsxtrifnextpunc}
%\begin{definition}
%\cs{glsxtrifnextpunc}\marg{true part}\marg{false part}
%\end{definition}
@@ -16271,14 +21830,15 @@ defined}{}%
%\end{macro}
%
%\begin{macro}{\glsxtrdopostpunc}
+%\changes{1.49}{2022-10-14}{made robust}
%\begin{definition}
%\cs{glsxtrdopostpunc}\marg{code}
%\end{definition}
-% If this is followed be a punctuation character, do \meta{code}
+% If this is followed by a punctuation character, do \meta{code}
% after the character otherwise do \meta{code} before whatever comes
% next.
% \begin{macrocode}
-\newcommand{\glsxtrdopostpunc}[1]{%
+\newrobustcmd{\glsxtrdopostpunc}[1]{%
\glsxtrifnextpunc{\@glsxtr@swaptwo{#1}}{#1}%
}
% \end{macrocode}
@@ -16290,9 +21850,9 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
-%\section{Abbreviations}
+%\subsection{Abbreviations}
%
-%The \qt{acronym} code from \styfmt{glossaries} is misnamed as it's more
+%The \qt{acronym} code from \sty{glossaries} is misnamed as it's more
%often used for other forms of abbreviations. This code corrects
%this inconsistency, but rather than just having synonyms, provide
% commands for abbreviations that have a similar, but not identical,
@@ -16306,16 +21866,20 @@ defined}{}%
\protected@edef\glscategorylabel{#1}%
}
% \end{macrocode}
+%\changes{1.49}{2022-10-14}{split shortplural and longplural into separate
+%family}
+% The shortplural and longplural are parsed separately, so are now
+% in another key family.
% Save the short plural form. This may be needed before the entry is
% defined.
% \begin{macrocode}
-\define@key{glsxtrabbrv}{shortplural}{%
+\define@key{glsxtrabbrvpl}{shortplural}{%
\def\@gls@shortpl{#1}%
}
% \end{macrocode}
% Similarly for the long plural form.
% \begin{macrocode}
-\define@key{glsxtrabbrv}{longplural}{%
+\define@key{glsxtrabbrvpl}{longplural}{%
\def\@gls@longpl{#1}%
}
% \end{macrocode}
@@ -16375,14 +21939,20 @@ defined}{}%
%\begin{macro}{\glsxtrwordsep}
%\changes{1.17}{2017-08-09}{new}
% \begin{macrocode}
-\newcommand*{\glsxtrwordsep}{\space}
+\newcommand*{\glsxtrwordsep}{\glsxtrgenentrytextfmt{ }}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\glsxtrwordsephyphen}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrwordsephyphen}{\glsxtrgenentrytextfmt{-}}
% \end{macrocode}
%\end{macro}
%Each word is marked with
%\begin{macro}{\glsxtrword}
%\changes{1.17}{2017-08-09}{new}
% \begin{macrocode}
-\newcommand*{\glsxtrword}[1]{#1}
+\newcommand*{\glsxtrword}[1]{\glsxtrgenentrytextfmt{#1}}
% \end{macrocode}
%\end{macro}
%\begin{macro}{\@glsxtr@markwordseps}
@@ -16440,9 +22010,13 @@ defined}{}%
\def\glsxtrorgshort{#3}%
\def\glsxtrorglong{#4}%
% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glsxtrorgkeylist}}
+% \begin{macrocode}
+ \def\glsxtrorgkeylist{#1}%
+% \end{macrocode}
%\changes{1.31}{2018-05-09}{added \cs{ExtraCustomAbbreviationFields}}
-%Provide extra settings for hooks (if modified, this command must
-%end with a comma).
+%Provide extra settings for hooks. Make sure to append a comma if
+%this hook is changed.
% \begin{macrocode}
\def\ExtraCustomAbbreviationFields{}%
% \end{macrocode}
@@ -16459,7 +22033,11 @@ defined}{}%
% \end{macrocode}
% Ignore the shortplural and longplural keys.
% \begin{macrocode}
- \setkeys*{glsxtrabbrv}[shortplural,longplural]{#1}%
+ \setkeys*{glsxtrabbrv}{#1}%
+% \end{macrocode}
+% Save remaining keys, just in case any hook also uses \cs{setkeys}
+% \begin{macrocode}
+ \let\@glsxtrabbrv@rmkeys\XKV@rm
% \end{macrocode}
% Set the abbreviation style.
% \begin{macrocode}
@@ -16482,31 +22060,37 @@ defined}{}%
}%
% \end{macrocode}
% Set the default long plural
+%\changes{1.49}{2022-10-14}{bug fix: markwords doesn't include plural suffix}
% \begin{macrocode}
\def\@gls@longpl{#4\glspluralsuffix}%
- \let\@gls@default@longpl\@gls@longpl
% \end{macrocode}
% Has the \catattr{markwords} attribute been set?
% \begin{macrocode}
\glsifcategoryattribute{\glscategorylabel}{markwords}{true}%
{%
\@glsxtr@markwordseps\@gls@long{#4}%
- \expandafter\def\expandafter\@gls@longpl\expandafter
- {\@gls@long\glspluralsuffix}%
- \let\@gls@default@longpl\@gls@longpl
% \end{macrocode}
% Update \cs{glslongtok}.
% \begin{macrocode}
\expandafter\glslongtok\expandafter{\@gls@long}%
+% \end{macrocode}
+% Mark this entry as having a description with formatting.
+% \begin{macrocode}
+ \glsexclapplyinnerfmtfield{\the\glslabeltok}{desc}%
}%
{}%
% \end{macrocode}
% Has the \catattr{markshortwords} attribute been set? (Not
% compatible with \catattr{insertdots}.)
% \begin{macrocode}
+ \let\@glsxtr@if@markshortwords\@secondoftwo
\glsifcategoryattribute{\glscategorylabel}{markshortwords}{true}%
{%
- \@glsxtr@markwordseps\@gls@short{#3}%
+% \end{macrocode}
+% Don't mark words until the default plural has been obtained.
+% \begin{macrocode}
+ \let\@glsxtr@if@markshortwords\@firstoftwo
+ \def\@gls@short{#3}%
}%
{%
% \end{macrocode}
@@ -16541,11 +22125,17 @@ defined}{}%
{%
\let\@gls@shortpl\@gls@short
}%
- {%
+ {%
\expandafter\def\expandafter\@gls@shortpl\expandafter{\@gls@short
\abbrvpluralsuffix}%
}%
}%
+ \@glsxtr@if@markshortwords
+ {%
+ \expandafter\@glsxtr@markwordseps\expandafter\@gls@short
+ \expandafter{\@gls@short}%
+ }%
+ {}%
% \end{macrocode}
% Update \cs{glsshorttok}:
% \begin{macrocode}
@@ -16557,29 +22147,52 @@ defined}{}%
% \end{macrocode}
% Get the short and long plurals provided by user in optional
% argument to override defaults, if necessary.
-% Ignore the category key (already obtained).
+% Save the default short plural.
% \begin{macrocode}
- \setkeys*{glsxtrabbrv}[category]{#1}%
+ \let\@gls@default@shortpl\@gls@shortpl
+ \let\XKV@rm\@glsxtrabbrv@rmkeys
+ \setrmkeys*{glsxtrabbrvpl}%
% \end{macrocode}
-% Save in case required.
+% Update \cs{glskeylisttok} so that it only has the remaining keys.
% \begin{macrocode}
- \let\@gls@org@longpl\@gls@longpl
- \let\@gls@org@shortpl\@gls@shortpl
+ \expandafter\glskeylisttok\expandafter{\XKV@rm}%
% \end{macrocode}
-% Has the plural been explicitly set?
+% Save in case required.
% \begin{macrocode}
- \ifx\@gls@default@longpl\@gls@longpl
- \else
+ \let\@gls@org@longpl\@gls@longpl
+ \let\@gls@org@shortpl\@gls@shortpl
% \end{macrocode}
% Has the \catattr{markwords} attribute been set?
% \begin{macrocode}
- \glsifcategoryattribute{\glscategorylabel}{markwords}{true}%
- {%
- \expandafter\@glsxtr@markwordseps\expandafter\@gls@longpl\expandafter
- {\@gls@longpl}%
- }%
- {}%
- \fi
+ \glsifcategoryattribute{\glscategorylabel}{markwords}{true}%
+ {%
+ \expandafter\@glsxtr@markwordseps\expandafter\@gls@longpl\expandafter
+ {\@gls@longpl}%
+ }%
+ {}%
+% \end{macrocode}
+% Has the \catattr{markshortwords} attribute been set?
+% \begin{macrocode}
+ \@glsxtr@if@markshortwords
+ {%
+ \expandafter\@glsxtr@markwordseps\expandafter\@gls@shortpl
+ \expandafter{\@gls@shortpl}%
+ }%
+ {%
+% \end{macrocode}
+% Has the \catattr{insertdots} attribute been set?
+% \begin{macrocode}
+ \ifx\@gls@default@shortpl\@gls@shortpl
+ \else
+ \glsifcategoryattribute{\glscategorylabel}{insertdots}{true}%
+ {%
+ \expandafter\@glsxtr@insertdots\expandafter\@gls@shortpl
+ \expandafter{\@gls@shortpl}%
+ \appto\@gls@shortpl{\@}%
+ }%
+ {}%
+ \fi
+ }%
% \end{macrocode}
% Set the plural token registers so the values can be accessed by
% the abbreviation styles.
@@ -16601,8 +22214,8 @@ defined}{}%
\protected@edef\@do@newglossaryentry{%
\noexpand\newglossaryentry{\the\glslabeltok}%
{%
- type=\glsxtrabbrvtype,%
- category=abbreviation,%
+ type={\glsxtrabbrvtype},%
+ category={\glscategorylabel},%
short={\the\glsshorttok},%
shortplural={\the\glsshortpltok},%
long={\the\glslongtok},%
@@ -16610,13 +22223,13 @@ defined}{}%
name={\the\glsshorttok},%
\CustomAbbreviationFields,%
% \end{macrocode}
-% Hook may override abbreviation style default settings (this hook
-% must end with a comma if set).
+% Hook may override abbreviation style default settings.
% \begin{macrocode}
\ExtraCustomAbbreviationFields
% \end{macrocode}
% Any explicit fields set in the optional argument override all
-% other settings.
+% other settings, except for the ones that have already been
+% processed.
% \begin{macrocode}
\the\glskeylisttok
}%
@@ -16626,6 +22239,16 @@ defined}{}%
% Obtain the type and add it to the list of abbreviations.
% \begin{macrocode}
\@glsxtr@addabbreviationlist{\glsentrytype{\the\glslabeltok}}%
+% \end{macrocode}
+% Exclude name, first, firstpl, text and plural fields from inner
+% fmt as they include formatting commands. The description may also
+% need adding, depending on the style.
+% \begin{macrocode}
+ \glsexclapplyinnerfmtfield{\the\glslabeltok}{first}%
+ \glsexclapplyinnerfmtfield{\the\glslabeltok}{firstpl}%
+ \glsexclapplyinnerfmtfield{\the\glslabeltok}{text}%
+ \glsexclapplyinnerfmtfield{\the\glslabeltok}{plural}%
+ \glsexclapplyinnerfmtfield{\the\glslabeltok}{name}%
\GlsXtrPostNewAbbreviation
}
% \end{macrocode}
@@ -16663,55 +22286,150 @@ defined}{}%
%\changes{1.17}{2017-08-09}{new}
%For the parenthetical styles.
% \begin{macrocode}
-\newcommand*{\glsxtrparen}[1]{(#1)}
+\newcommand*{\glsxtrparen}[1]{%
+ \glsxtrgenentrytextfmt{(}#1\glsxtrgenentrytextfmt{)}}
% \end{macrocode}
%\end{macro}
%
%\begin{macro}{\glsxtrfullformat}
% Full format without case change.
+%\changes{1.49}{2022-10-14}{added check for insert inside and inner fmt}
% \begin{macrocode}
\newcommand*{\glsxtrfullformat}[2]{%
- \glsfirstlongfont{\glsaccesslong{#1}}#2\glsxtrfullsep{#1}%
- \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshort{#1}}}%
+ \ifglsxtrinsertinside
+ \glsfirstlongfont{\glsaccessfmtlong{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ \glsfirstlongfont{\glsaccessfmtlong{}{\glsxtrgenentrytextfmt}{#1}}%
+ \glsxtrgenentrytextfmt{#2}%
+ \fi
+ \glsxtrfullsep{#1}%
+ \glsxtrparen{\protect\glsfirstabbrvfont
+ {\glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{#1}}}%
}
% \end{macrocode}
%\end{macro}
%
%\begin{macro}{\Glsxtrfullformat}
% Full format with case change.
+%\changes{1.49}{2022-10-14}{added check for insert inside and inner fmt}
% \begin{macrocode}
\newcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstlongfont{\Glsaccesslong{#1}}#2\glsxtrfullsep{#1}%
- \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshort{#1}}}%
+ \ifglsxtrinsertinside
+ \glsfirstlongfont{\Glsaccessfmtlong{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ \glsfirstlongfont{\Glsaccessfmtlong{}{\glsxtrgenentrytextfmt}{#1}}%
+ \glsxtrgenentrytextfmt{#2}%
+ \fi
+ \glsxtrfullsep{#1}%
+ \glsxtrparen{\protect\glsfirstabbrvfont
+ {\glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{#1}}}%
}
+\glsmfuaddmap{\glsxtrfullformat}{\Glsxtrfullformat}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrfullformat}
+% Full format with all caps.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtrfullformat}[2]{%
+ \ifglsxtrinsertinside
+ \glsfirstlongfont{\GLSaccessfmtlong{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ \glsfirstlongfont{\GLSaccessfmtlong{}{\glsxtrgenentrytextfmt}{#1}}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ \glsxtrfullsep{#1}%
+ \glsxtrparen{\protect\glsfirstabbrvfont
+ {\GLSaccessfmtshort{}{\glsxtrgenentrytextfmt}{#1}}}%
+}
+\glsmfublocker{\GLSxtrfullformat}
% \end{macrocode}
%\end{macro}
%
%\begin{macro}{\glsxtrfullplformat}
% Plural full format without case change.
+%\changes{1.49}{2022-10-14}{added check for insert inside and inner fmt}
% \begin{macrocode}
\newcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstlongfont{\glsaccesslongpl{#1}}#2\glsxtrfullsep{#1}%
- \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshortpl{#1}}}%
+ \ifglsxtrinsertinside
+ \glsfirstlongfont{\glsaccessfmtlongpl{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ \glsfirstlongfont{\glsaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{#1}}%
+ \glsxtrgenentrytextfmt{#2}%
+ \fi
+ \glsxtrfullsep{#1}%
+ \glsxtrparen{\protect\glsfirstabbrvfont
+ {\glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{#1}}}%
}
% \end{macrocode}
%\end{macro}
%
%\begin{macro}{\Glsxtrfullplformat}
% Plural full format with case change.
+%\changes{1.49}{2022-10-14}{added check for insert inside and inner fmt}
% \begin{macrocode}
\newcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstlongfont{\Glsaccesslongpl{#1}}#2\glsxtrfullsep{#1}%
- \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshortpl{#1}}}%
+ \ifglsxtrinsertinside
+ \glsfirstlongfont{\Glsaccessfmtlongpl{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ \glsfirstlongfont{\Glsaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{#1}}%
+ \glsxtrgenentrytextfmt{#2}%
+ \fi
+ \glsxtrfullsep{#1}%
+ \glsxtrparen{\protect\glsfirstabbrvfont
+ {\glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{#1}}}%
}
+\glsmfuaddmap{\glsxtrfullplformat}{\Glsxtrfullplformat}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrfullplformat}
+% Full format with all caps.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtrfullplformat}[2]{%
+ \ifglsxtrinsertinside
+ \glsfirstlongfont{\GLSaccessfmtlongpl{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ \glsfirstlongfont{\GLSaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{#1}}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ \glsxtrfullsep{#1}%
+ \glsxtrparen{\protect\glsfirstabbrvfont
+ {\GLSaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{#1}}}%
+}
+\glsmfublocker{\GLSxtrfullplformat}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtr@fullformat@fallback}
+% Fallback for custom styles that don't implement all caps version.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtr@fullformat@fallback}[2]{%
+ \glsuppercase{\glsxtrfullformat{##1}{##2}}%
+}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\GLSxtr@fullplformat@fallback}
+% Fallback for custom styles that don't implement all caps version.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtr@fullplformat@fallback}[2]{%
+ \glsuppercase{\glsxtrfullplformat{##1}{##2}}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%
%\begin{macro}{\glsxtrfullsep}
% Separator used by full format is a space by default. The argument
% is the entry's label.
+%\changes{1.49}{2022-10-14}{added inner fmt}
% \begin{macrocode}
-\newcommand*{\glsxtrfullsep}[1]{\space}
+\newcommand*{\glsxtrfullsep}[1]{\glsxtrgenentrytextfmt{ }}
% \end{macrocode}
%\end{macro}
%
@@ -16732,6 +22450,14 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\GLSxtrinlinefullformat}
+% Full format with all caps.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtrinlinefullformat}{\GLSxtrfullformat}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsxtrfullplformat}
% Plural full format without case change.
% \begin{macrocode}
@@ -16746,10 +22472,20 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\GLSxtrinlinefullplformat}
+% Full format with all caps.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtrinlinefullplformat}{\GLSxtrfullplformat}
+% \end{macrocode}
+%\end{macro}
+%
% Redefine \cs{glsentryfull} etc to use the inline format.
-% Since these commands as supposed to be expandable, they can only
+% Since these commands are supposed to be expandable, they can only
% use the currently applied style. If there are mixed styles, you'll
% need to use the \cs{glsxtrfull} set of commands instead.
+% If expandable sentence case is required, use \cs{MFUsentencecase}
+% on the non-case-change version.
%\begin{macro}{\glsentryfull}
% \begin{macrocode}
\renewcommand*{\glsentryfull}[1]{\glsxtrinlinefullformat{#1}{}}
@@ -16759,6 +22495,7 @@ defined}{}%
%\begin{macro}{\Glsentryfull}
% \begin{macrocode}
\renewcommand*{\Glsentryfull}[1]{\Glsxtrinlinefullformat{#1}{}}
+\glsmfuaddmap{\glsentryfull}{\Glsentryfull}
% \end{macrocode}
%\end{macro}
%
@@ -16771,6 +22508,7 @@ defined}{}%
%\begin{macro}{\Glsentryfullpl}
% \begin{macrocode}
\renewcommand*{\Glsentryfullpl}[1]{\Glsxtrinlinefullplformat{#1}{}}
+\glsmfuaddmap{\glsentryfullpl}{\Glsentryfullpl}
% \end{macrocode}
%\end{macro}
%
@@ -16782,6 +22520,28 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsfirstinnerfmtabbrvfont}
+%\changes{1.49}{2022-10-14}{new}
+%Include inner formatting command.
+% \begin{macrocode}
+\newrobustcmd*{\glsfirstinnerfmtabbrvfont}[1]{%
+ \glsfirstabbrvfont{\glsxtrgenentrytextfmt{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsfirstxpabbrvfont}
+%\changes{1.49}{2022-10-14}{new}
+%Expand to appropriate formatting command.
+% \begin{macrocode}
+\newcommand*{\glsfirstxpabbrvfont}[2]{%
+ \glsifcategoryattributetrue{#2}{markshortwords}%
+ {\protect\glsfirstabbrvfont{#1}}%
+ {\glsfirstinnerfmtabbrvfont{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsfirstabbrvdefaultfont}
% Font changing command used for the abbreviation on first use or in
% the full format.
@@ -16801,6 +22561,28 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsinnerfmtabbrvfont}
+%\changes{1.49}{2022-10-14}{new}
+%Include inner formatting command.
+% \begin{macrocode}
+\newrobustcmd*{\glsinnerfmtabbrvfont}[1]{%
+ \glsabbrvfont{\glsxtrgenentrytextfmt{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxpabbrvfont}
+%\changes{1.49}{2022-10-14}{new}
+%Expand to appropriate formatting command.
+% \begin{macrocode}
+\newcommand*{\glsxpabbrvfont}[2]{%
+ \glsifcategoryattributetrue{#2}{markshortwords}%
+ {\protect\glsabbrvfont{#1}}%
+ {\glsinnerfmtabbrvfont{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsabbrvdefaultfont}
%\changes{0.3}{2015-12-02}{renamed from \cs{abbrvdefaultfont}}
% \begin{macrocode}
@@ -16817,6 +22599,28 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsinnerfmtlongfont}
+%\changes{1.49}{2022-10-14}{new}
+%Include inner formatting command.
+% \begin{macrocode}
+\newrobustcmd*{\glsinnerfmtlongfont}[1]{%
+ \glslongfont{\glsxtrgenentrytextfmt{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxplongfont}
+%\changes{1.49}{2022-10-14}{new}
+%Expand to appropriate formatting command.
+% \begin{macrocode}
+\newcommand*{\glsxplongfont}[2]{%
+ \glsifcategoryattributetrue{#2}{markwords}%
+ {\protect\glslongfont{#1}}%
+ {\glsinnerfmtlongfont{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glslongdefaultfont}
% Default font changing command used for the long form in commands like
%\changes{1.04}{2016-05-02}{new}
@@ -16834,6 +22638,28 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsfirstinnerfmtlongfont}
+%\changes{1.49}{2022-10-14}{new}
+%Include inner formatting command.
+% \begin{macrocode}
+\newrobustcmd*{\glsfirstinnerfmtlongfont}[1]{%
+ \glsfirstlongfont{\glsxtrgenentrytextfmt{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsfirstxplongfont}
+%\changes{1.49}{2022-10-14}{new}
+%Expand to appropriate formatting command.
+% \begin{macrocode}
+\newcommand*{\glsfirstxplongfont}[2]{%
+ \glsifcategoryattributetrue{#2}{markwords}%
+ {\protect\glsfirstlongfont{#1}}%
+ {\glsfirstinnerfmtlongfont{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsfirstlongdefaultfont}
%\changes{0.5}{2015-12-07}{new}
% \begin{macrocode}
@@ -16857,6 +22683,20 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtrrevert}
+%\changes{1.49}{2022-10-14}{new}
+% Provide a way to counteract the abbreviation font.
+% \begin{macrocode}
+\newcommand*{\glsxtrrevert}[1]{\glsxtrdefaultrevert{#1}}%
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\glsxtrdefaultrevert}
+%\changes{1.49}{2022-10-14}{new}
+%The default simply does its argument.
+% \begin{macrocode}
+\newcommand*{\glsxtrdefaultrevert}[1]{#1}%
+% \end{macrocode}
+%\end{macro}
%\begin{macro}{\glsxtrfull}
% Full form (no case-change).
% \begin{macrocode}
@@ -16871,6 +22711,7 @@ defined}{}%
% Low-level macro:
% \begin{macrocode}
\def\@glsxtr@full#1#2[#3]{%
+ \def\glsxtrcurrentfield{}%
% \end{macrocode}
%If the \pkgopt{record} option has been used, the information needs
%to be written to the aux file regardless of whether the entry
@@ -16882,9 +22723,13 @@ defined}{}%
{%
\glssetabbrvfmt{\glscategory{#2}}%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsifplural\@secondoftwo
\let\glscapscase\@firstofthree
- \let\glsinsert\@empty
+ \glsxtrfullsaveinsert{#2}{#3}%
+% \end{macrocode}
+% The innertextformat support should be provided within the inline command.
+% \begin{macrocode}
\def\glscustomtext{\glsxtrinlinefullformat{#2}{#3}}%
% \end{macrocode}
% What should \cs{glsxtrifwasfirstuse} be set to here? Where the inline
@@ -16918,19 +22763,25 @@ defined}{}%
\new@ifnextchar[{\@Glsxtr@full{#1}{#2}}%
{\@Glsxtr@full{#1}{#2}[]}%
}
+\glsmfuaddmap{\glsxtrfull}{\Glsxtrfull}
% \end{macrocode}
%\end{macro}
%\begin{macro}{\@Glsxtr@full}
% Low-level macro:
% \begin{macrocode}
\def\@Glsxtr@full#1#2[#3]{%
+ \def\glsxtrcurrentfield{}%
\glsdoifexists{#2}%
{%
\glssetabbrvfmt{\glscategory{#2}}%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsifplural\@secondoftwo
\let\glscapscase\@secondofthree
- \let\glsinsert\@empty
+ \glsxtrfullsaveinsert{#2}{#3}%
+% \end{macrocode}
+% The innertextformat support should be provided within the inline command.
+% \begin{macrocode}
\def\glscustomtext{\Glsxtrinlinefullformat{#2}{#3}}%
\glsxtrsetupfulldefs
\@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
@@ -16954,19 +22805,25 @@ defined}{}%
% Low-level macro:
% \begin{macrocode}
\def\@GLSxtr@full#1#2[#3]{%
+ \def\glsxtrcurrentfield{}%
\glsdoifexists{#2}%
{%
\glssetabbrvfmt{\glscategory{#2}}%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsifplural\@secondoftwo
\let\glscapscase\@thirdofthree
- \let\glsinsert\@empty
- \def\glscustomtext{\mfirstucMakeUppercase{\glsxtrinlinefullformat{#2}{#3}}}%
+ \glsxtrfullsaveinsert{#2}{#3}%
+% \end{macrocode}
+% The innertextformat support should be provided within the inline command.
+% \begin{macrocode}
+ \def\glscustomtext{\GLSxtrinlinefullformat{#2}{#3}}%
\glsxtrsetupfulldefs
\@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
}%
\glspostlinkhook
}
+\glsmfublocker{\GLSxtrfull}
% \end{macrocode}
%\end{macro}
%
@@ -16984,6 +22841,7 @@ defined}{}%
% Low-level macro:
% \begin{macrocode}
\def\@glsxtr@fullpl#1#2[#3]{%
+ \def\glsxtrcurrentfield{}%
% \end{macrocode}
%If the \pkgopt{record} option has been used, the information needs
%to be written to the aux file regardless of whether the entry
@@ -16995,9 +22853,13 @@ defined}{}%
{%
\glssetabbrvfmt{\glscategory{#2}}%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsifplural\@firstoftwo
\let\glscapscase\@firstofthree
- \let\glsinsert\@empty
+ \glsxtrfullsaveinsert{#2}{#3}%
+% \end{macrocode}
+% The innertextformat support should be provided within the inline command.
+% \begin{macrocode}
\def\glscustomtext{\glsxtrinlinefullplformat{#2}{#3}}%
\glsxtrsetupfulldefs
\@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
@@ -17015,12 +22877,14 @@ defined}{}%
\new@ifnextchar[{\@Glsxtr@fullpl{#1}{#2}}%
{\@Glsxtr@fullpl{#1}{#2}[]}%
}
+\glsmfuaddmap{\glsxtrfullpl}{\Glsxtrfullpl}
% \end{macrocode}
%\end{macro}
%\begin{macro}{\@Glsxtr@fullpl}
% Low-level macro:
% \begin{macrocode}
\def\@Glsxtr@fullpl#1#2[#3]{%
+ \def\glsxtrcurrentfield{}%
% \end{macrocode}
%If the \pkgopt{record} option has been used, the information needs
%to be written to the aux file regardless of whether the entry
@@ -17032,9 +22896,13 @@ defined}{}%
{%
\glssetabbrvfmt{\glscategory{#2}}%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsifplural\@firstoftwo
\let\glscapscase\@secondofthree
- \let\glsinsert\@empty
+ \glsxtrfullsaveinsert{#2}{#3}%
+% \end{macrocode}
+% The innertextformat support should be provided within the inline command.
+% \begin{macrocode}
\def\glscustomtext{\Glsxtrinlinefullplformat{#2}{#3}}%
\glsxtrsetupfulldefs
\@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
@@ -17052,12 +22920,14 @@ defined}{}%
\new@ifnextchar[{\@GLSxtr@fullpl{#1}{#2}}%
{\@GLSxtr@fullpl{#1}{#2}[]}%
}
+\glsmfublocker{\GLSxtrfullpl}
% \end{macrocode}
%\end{macro}
%\begin{macro}{\@GLSxtr@fullpl}
% Low-level macro:
% \begin{macrocode}
\def\@GLSxtr@fullpl#1#2[#3]{%
+ \def\glsxtrcurrentfield{}%
% \end{macrocode}
%If the \pkgopt{record} option has been used, the information needs
%to be written to the aux file regardless of whether the entry
@@ -17068,11 +22938,15 @@ defined}{}%
\glsdoifexists{#2}%
{%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsifplural\@firstoftwo
\let\glscapscase\@thirdofthree
- \let\glsinsert\@empty
+ \glsxtrfullsaveinsert{#2}{#3}%
+% \end{macrocode}
+% The innertextformat support should be provided within the inline command.
+% \begin{macrocode}
\def\glscustomtext{%
- \mfirstucMakeUppercase{\glsxtrinlinefullplformat{#2}{#3}}}%
+ \GLSxtrinlinefullplformat{#2}{#3}}%
\glsxtrsetupfulldefs
\@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
}%
@@ -17096,6 +22970,7 @@ defined}{}%
% Read in the final optional argument:
% \begin{macrocode}
\def\@glsxtrshort#1#2[#3]{%
+ \def\glsxtrcurrentfield{short}%
% \end{macrocode}
%If the \pkgopt{record} option has been used, the information needs
%to be written to the aux file regardless of whether the entry
@@ -17110,13 +22985,13 @@ defined}{}%
% \begin{macrocode}
\glssetabbrvfmt{\glscategory{#2}}%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsxtrifwasfirstuse\@secondoftwo
\let\glsifplural\@secondoftwo
\let\glscapscase\@firstofthree
- \let\glsinsert\@empty
+ \glsxtrsaveinsert{#2}{#3}%
\def\glscustomtext{%
- \glsabbrvfont{\glsaccessshort{#2}\ifglsxtrinsertinside#3\fi}%
- \ifglsxtrinsertinside\else#3\fi
+ \glsxtrshortformat{#2}{#3}{\glsabbrvfont}%
}%
\@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
}%
@@ -17128,6 +23003,7 @@ defined}{}%
%\begin{macro}{\Glsxtrshort}
% \begin{macrocode}
\newrobustcmd*{\Glsxtrshort}{\@gls@hyp@opt\ns@Glsxtrshort}
+\glsmfuaddmap{\glsxtrshort}{\Glsxtrshort}
% \end{macrocode}
% Define the un-starred form. Need to determine if there is
% a final optional argument
@@ -17139,6 +23015,7 @@ defined}{}%
% Read in the final optional argument:
% \begin{macrocode}
\def\@Glsxtrshort#1#2[#3]{%
+ \def\glsxtrcurrentfield{short}%
% \end{macrocode}
%If the \pkgopt{record} option has been used, the information needs
%to be written to the aux file regardless of whether the entry
@@ -17150,13 +23027,13 @@ defined}{}%
{%
\glssetabbrvfmt{\glscategory{#2}}%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsxtrifwasfirstuse\@secondoftwo
\let\glsifplural\@secondoftwo
\let\glscapscase\@secondofthree
- \let\glsinsert\@empty
+ \glsxtrsaveinsert{#2}{#3}%
\def\glscustomtext{%
- \glsabbrvfont{\Glsaccessshort{#2}\ifglsxtrinsertinside#3\fi}%
- \ifglsxtrinsertinside\else#3\fi
+ \Glsxtrshortformat{#2}{#3}{\glsabbrvfont}%
}%
\@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
}%
@@ -17168,6 +23045,7 @@ defined}{}%
%\begin{macro}{\GLSxtrshort}
% \begin{macrocode}
\newrobustcmd*{\GLSxtrshort}{\@gls@hyp@opt\ns@GLSxtrshort}
+\glsmfublocker{\GLSxtrshort}
% \end{macrocode}
% Define the un-starred form. Need to determine if there is
% a final optional argument
@@ -17179,6 +23057,7 @@ defined}{}%
% Read in the final optional argument:
% \begin{macrocode}
\def\@GLSxtrshort#1#2[#3]{%
+ \def\glsxtrcurrentfield{short}%
% \end{macrocode}
%If the \pkgopt{record} option has been used, the information needs
%to be written to the aux file regardless of whether the entry
@@ -17190,16 +23069,12 @@ defined}{}%
{%
\glssetabbrvfmt{\glscategory{#2}}%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsxtrifwasfirstuse\@secondoftwo
\let\glsifplural\@secondoftwo
\let\glscapscase\@thirdofthree
- \let\glsinsert\@empty
- \def\glscustomtext{%
- \mfirstucMakeUppercase
- {\glsabbrvfont{\glsaccessshort{#2}\ifglsxtrinsertinside#3\fi}%
- \ifglsxtrinsertinside\else#3\fi
- }%
- }%
+ \glsxtrsaveinsert{#2}{#3}%
+ \def\glscustomtext{\GLSxtrshortformat{#2}{#3}{\glsabbrvfont}}%
\@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
}%
\glspostlinkhook
@@ -17207,6 +23082,18 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtrsetlongfirstuse}
+% Assigns \cs{glsxtrifwasfirstuse} for the long commands.
+%The argument is the entry label. This now makes commands such as
+%\cs{glsxtrlong} simulate first use.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glsxtrsetlongfirstuse}[1]{%
+ \let\glsxtrifwasfirstuse\@firstoftwo
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsxtrlong}
% \begin{macrocode}
\newrobustcmd*{\glsxtrlong}{\@gls@hyp@opt\ns@glsxtrlong}
@@ -17221,6 +23108,7 @@ defined}{}%
% Read in the final optional argument:
% \begin{macrocode}
\def\@glsxtrlong#1#2[#3]{%
+ \def\glsxtrcurrentfield{long}%
% \end{macrocode}
%If the \pkgopt{record} option has been used, the information needs
%to be written to the aux file regardless of whether the entry
@@ -17231,13 +23119,13 @@ defined}{}%
\glsdoifexists{#2}%
{%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
- \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsifplural\@secondoftwo
\let\glscapscase\@firstofthree
- \let\glsinsert\@empty
+ \glsxtrsetlongfirstuse{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\def\glscustomtext{%
- \glslongfont{\glsaccesslong{#2}\ifglsxtrinsertinside#3\fi}%
- \ifglsxtrinsertinside\else#3\fi
+ \glsxtrlongformat{#2}{#3}{\glslongfont}%
}%
\@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
}%
@@ -17249,6 +23137,7 @@ defined}{}%
%\begin{macro}{\Glsxtrlong}
% \begin{macrocode}
\newrobustcmd*{\Glsxtrlong}{\@gls@hyp@opt\ns@Glsxtrlong}
+\glsmfuaddmap{\glsxtrlong}{\Glsxtrlong}
% \end{macrocode}
% Define the un-starred form. Need to determine if there is
% a final optional argument
@@ -17260,23 +23149,25 @@ defined}{}%
% Read in the final optional argument:
% \begin{macrocode}
\def\@Glsxtrlong#1#2[#3]{%
+ \def\glsxtrcurrentfield{long}%
% \end{macrocode}
%If the \pkgopt{record} option has been used, the information needs
%to be written to the aux file regardless of whether the entry
%exists (unless indexing has been switched off).
%\changes{1.30}{2018-04-25}{added \cs{@glsxtr@record}}
+%\changes{1.49}{2022-10-14}{now simulates first use}
% \begin{macrocode}
\@glsxtr@record{#1}{#2}{glslink}%
\glsdoifexists{#2}%
{%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
- \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsifplural\@secondoftwo
\let\glscapscase\@secondofthree
- \let\glsinsert\@empty
+ \glsxtrsetlongfirstuse{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\def\glscustomtext{%
- \glslongfont{\Glsaccesslong{#2}\ifglsxtrinsertinside#3\fi}%
- \ifglsxtrinsertinside\else#3\fi
+ \Glsxtrlongformat{#2}{#3}{\glslongfont}%
}%
\@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
}%
@@ -17288,6 +23179,7 @@ defined}{}%
%\begin{macro}{\GLSxtrlong}
% \begin{macrocode}
\newrobustcmd*{\GLSxtrlong}{\@gls@hyp@opt\ns@GLSxtrlong}
+\glsmfublocker{\GLSxtrlong}
% \end{macrocode}
% Define the un-starred form. Need to determine if there is
% a final optional argument
@@ -17299,6 +23191,7 @@ defined}{}%
% Read in the final optional argument:
% \begin{macrocode}
\def\@GLSxtrlong#1#2[#3]{%
+ \def\glsxtrcurrentfield{long}%
% \end{macrocode}
%If the \pkgopt{record} option has been used, the information needs
%to be written to the aux file regardless of whether the entry
@@ -17309,15 +23202,13 @@ defined}{}%
\glsdoifexists{#2}%
{%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
- \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsifplural\@secondoftwo
\let\glscapscase\@thirdofthree
- \let\glsinsert\@empty
+ \glsxtrsetlongfirstuse{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\def\glscustomtext{%
- \mfirstucMakeUppercase
- {\glslongfont{\glsaccesslong{#2}\ifglsxtrinsertinside#3\fi}%
- \ifglsxtrinsertinside\else#3\fi
- }%
+ \GLSxtrlongformat{#2}{#3}{\glslongfont}%
}%
\@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
}%
@@ -17342,6 +23233,7 @@ defined}{}%
% Read in the final optional argument:
% \begin{macrocode}
\def\@glsxtrshortpl#1#2[#3]{%
+ \def\glsxtrcurrentfield{short}%
% \end{macrocode}
%If the \pkgopt{record} option has been used, the information needs
%to be written to the aux file regardless of whether the entry
@@ -17353,13 +23245,13 @@ defined}{}%
{%
\glssetabbrvfmt{\glscategory{#2}}%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsxtrifwasfirstuse\@secondoftwo
\let\glsifplural\@firstoftwo
\let\glscapscase\@firstofthree
- \let\glsinsert\@empty
+ \glsxtrsaveinsert{#2}{#3}%
\def\glscustomtext{%
- \glsabbrvfont{\glsaccessshortpl{#2}\ifglsxtrinsertinside#3\fi}%
- \ifglsxtrinsertinside\else#3\fi
+ \glsxtrshortplformat{#2}{#3}{\glsabbrvfont}%
}%
\@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
}%
@@ -17372,6 +23264,7 @@ defined}{}%
%\changes{0.3}{2015-12-02}{new}
% \begin{macrocode}
\newrobustcmd*{\Glsxtrshortpl}{\@gls@hyp@opt\ns@Glsxtrshortpl}
+\glsmfuaddmap{\glsxtrshortpl}{\Glsxtrshortpl}
% \end{macrocode}
% Define the un-starred form. Need to determine if there is
% a final optional argument
@@ -17383,6 +23276,7 @@ defined}{}%
% Read in the final optional argument:
% \begin{macrocode}
\def\@Glsxtrshortpl#1#2[#3]{%
+ \def\glsxtrcurrentfield{short}%
% \end{macrocode}
%If the \pkgopt{record} option has been used, the information needs
%to be written to the aux file regardless of whether the entry
@@ -17394,13 +23288,13 @@ defined}{}%
{%
\glssetabbrvfmt{\glscategory{#2}}%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsxtrifwasfirstuse\@secondoftwo
\let\glsifplural\@firstoftwo
\let\glscapscase\@secondofthree
- \let\glsinsert\@empty
+ \glsxtrsaveinsert{#2}{#3}%
\def\glscustomtext{%
- \glsabbrvfont{\Glsaccessshortpl{#2}\ifglsxtrinsertinside#3\fi}%
- \ifglsxtrinsertinside\else#3\fi
+ \Glsxtrshortplformat{#2}{#3}{\glsabbrvfont}%
}%
\@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
}%
@@ -17413,6 +23307,7 @@ defined}{}%
%\changes{0.3}{2015-12-02}{new}
% \begin{macrocode}
\newrobustcmd*{\GLSxtrshortpl}{\@gls@hyp@opt\ns@GLSxtrshortpl}
+\glsmfublocker{\GLSxtrshortpl}
% \end{macrocode}
% Define the un-starred form. Need to determine if there is
% a final optional argument
@@ -17424,6 +23319,7 @@ defined}{}%
% Read in the final optional argument:
% \begin{macrocode}
\def\@GLSxtrshortpl#1#2[#3]{%
+ \def\glsxtrcurrentfield{short}%
% \end{macrocode}
%If the \pkgopt{record} option has been used, the information needs
%to be written to the aux file regardless of whether the entry
@@ -17435,15 +23331,13 @@ defined}{}%
{%
\glssetabbrvfmt{\glscategory{#2}}%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsxtrifwasfirstuse\@secondoftwo
\let\glsifplural\@firstoftwo
\let\glscapscase\@thirdofthree
- \let\glsinsert\@empty
+ \glsxtrsaveinsert{#2}{#3}%
\def\glscustomtext{%
- \mfirstucMakeUppercase
- {\glsabbrvfont{\glsaccessshortpl{#2}\ifglsxtrinsertinside#3\fi}%
- \ifglsxtrinsertinside\else#3\fi
- }%
+ \GLSxtrshortplformat{#2}{#3}{\glsabbrvfont}%
}%
\@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
}%
@@ -17468,6 +23362,7 @@ defined}{}%
% Read in the final optional argument:
% \begin{macrocode}
\def\@glsxtrlongpl#1#2[#3]{%
+ \def\glsxtrcurrentfield{long}%
% \end{macrocode}
%If the \pkgopt{record} option has been used, the information needs
%to be written to the aux file regardless of whether the entry
@@ -17478,13 +23373,13 @@ defined}{}%
\glsdoifexists{#2}%
{%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
- \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsifplural\@firstoftwo
\let\glscapscase\@firstofthree
- \let\glsinsert\@empty
+ \glsxtrsetlongfirstuse{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\def\glscustomtext{%
- \glslongfont{\glsaccesslongpl{#2}\ifglsxtrinsertinside#3\fi}%
- \ifglsxtrinsertinside\else#3\fi
+ \glsxtrlongplformat{#2}{#3}{\glslongfont}%
}%
\@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
}%
@@ -17497,6 +23392,7 @@ defined}{}%
%\changes{0.3}{2015-12-02}{new}
% \begin{macrocode}
\newrobustcmd*{\Glsxtrlongpl}{\@gls@hyp@opt\ns@Glsxtrlongpl}
+\glsmfuaddmap{\glsxtrlongpl}{\Glsxtrlongpl}
% \end{macrocode}
% Define the un-starred form. Need to determine if there is
% a final optional argument
@@ -17508,6 +23404,7 @@ defined}{}%
% Read in the final optional argument:
% \begin{macrocode}
\def\@Glsxtrlongpl#1#2[#3]{%
+ \def\glsxtrcurrentfield{long}%
% \end{macrocode}
%If the \pkgopt{record} option has been used, the information needs
%to be written to the aux file regardless of whether the entry
@@ -17518,13 +23415,13 @@ defined}{}%
\glsdoifexists{#2}%
{%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
- \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsifplural\@firstoftwo
\let\glscapscase\@secondofthree
- \let\glsinsert\@empty
+ \glsxtrsetlongfirstuse{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\def\glscustomtext{%
- \glslongfont{\Glsaccesslongpl{#2}\ifglsxtrinsertinside#3\fi}%
- \ifglsxtrinsertinside\else#3\fi
+ \Glsxtrlongplformat{#2}{#3}{\glslongfont}%
}%
\@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
}%
@@ -17537,6 +23434,7 @@ defined}{}%
%\changes{0.3}{2015-12-02}{new}
% \begin{macrocode}
\newrobustcmd*{\GLSxtrlongpl}{\@gls@hyp@opt\ns@GLSxtrlongpl}
+\glsmfublocker{\GLSxtrlongpl}
% \end{macrocode}
% Define the un-starred form. Need to determine if there is
% a final optional argument
@@ -17548,6 +23446,7 @@ defined}{}%
% Read in the final optional argument:
% \begin{macrocode}
\def\@GLSxtrlongpl#1#2[#3]{%
+ \def\glsxtrcurrentfield{long}%
% \end{macrocode}
%If the \pkgopt{record} option has been used, the information needs
%to be written to the aux file regardless of whether the entry
@@ -17558,15 +23457,13 @@ defined}{}%
\glsdoifexists{#2}%
{%
\let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
- \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsxtrifwasglslike\@secondoftwo
\let\glsifplural\@firstoftwo
\let\glscapscase\@thirdofthree
- \let\glsinsert\@empty
+ \glsxtrsetlongfirstuse{#2}%
+ \glsxtrsaveinsert{#2}{#3}%
\def\glscustomtext{%
- \mfirstucMakeUppercase
- {\glslongfont{\glsaccesslongpl{#2}\ifglsxtrinsertinside#3\fi}%
- \ifglsxtrinsertinside\else#3\fi
- }%
+ \GLSxtrlongplformat{#2}{#3}{\glslongfont}%
}%
\@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
}%
@@ -17609,6 +23506,10 @@ defined}{}%
%\begin{macro}{\glsxtrgenabbrvfmt}
% Similar to \cs{glsgenacfmt}, but for abbreviations.
%\changes{1.17}{2017-08-09}{added check for \cs{ifglsxtrinsertinside}}
+% The expansion is to ensure that \cs{glsinsert} is expanded before being
+% passed to \cs{glsfmtfield} etc in the event that an inner command
+% is being used (which typically signifies a complex formatting command
+% such as those provided by \sty{soul}).
% \begin{macrocode}
\newcommand*{\glsxtrgenabbrvfmt}{%
\ifdefempty\glscustomtext
@@ -17628,20 +23529,22 @@ defined}{}%
% \end{macrocode}
% Subsequent plural form, don't adjust case:
% \begin{macrocode}
- \glsxtrsubsequentplfmt{\glslabel}{\glsinsert}%
+ \expandafter\glsxtrsubsequentplfmt\expandafter\glslabel
+ \expandafter{\glsinsert}%
}%
{%
% \end{macrocode}
% Subsequent plural form, make first letter upper case:
% \begin{macrocode}
- \Glsxtrsubsequentplfmt{\glslabel}{\glsinsert}%
+ \expandafter\Glsxtrsubsequentplfmt\expandafter\glslabel
+ \expandafter{\glsinsert}%
}%
{%
% \end{macrocode}
% Subsequent plural form, all caps:
% \begin{macrocode}
- \mfirstucMakeUppercase
- {\glsxtrsubsequentplfmt{\glslabel}{\glsinsert}}%
+ \expandafter\GLSxtrsubsequentplfmt\expandafter\glslabel
+ \expandafter{\glsinsert}%
}%
}%
{%
@@ -17653,20 +23556,22 @@ defined}{}%
% \end{macrocode}
% Subsequent singular form, don't adjust case:
% \begin{macrocode}
- \glsxtrsubsequentfmt{\glslabel}{\glsinsert}%
+ \expandafter\glsxtrsubsequentfmt\expandafter\glslabel
+ \expandafter{\glsinsert}%
}%
{%
% \end{macrocode}
% Subsequent singular form, make first letter upper case:
% \begin{macrocode}
- \Glsxtrsubsequentfmt{\glslabel}{\glsinsert}%
+ \expandafter\Glsxtrsubsequentfmt\expandafter
+ \glslabel\expandafter{\glsinsert}%
}%
{%
% \end{macrocode}
% Subsequent singular form, all caps:
% \begin{macrocode}
- \mfirstucMakeUppercase
- {\glsxtrsubsequentfmt{\glslabel}{\glsinsert}}%
+ \expandafter\GLSxtrsubsequentfmt\expandafter
+ \glslabel\expandafter{\glsinsert}%
}%
}%
}%
@@ -17684,20 +23589,22 @@ defined}{}%
% \end{macrocode}
% First use plural form, don't adjust case:
% \begin{macrocode}
- \glsxtrfullplformat{\glslabel}{\glsinsert}%
+ \expandafter\glsxtrfullplformat\expandafter\glslabel
+ \expandafter{\glsinsert}%
}%
{%
% \end{macrocode}
% First use plural form, make first letter upper case:
% \begin{macrocode}
- \Glsxtrfullplformat{\glslabel}{\glsinsert}%
+ \expandafter\Glsxtrfullplformat\expandafter\glslabel
+ \expandafter{\glsinsert}%
}%
{%
% \end{macrocode}
% First use plural form, all caps:
% \begin{macrocode}
- \mfirstucMakeUppercase
- {\glsxtrfullplformat{\glslabel}{\glsinsert}}%
+ \expandafter\GLSxtrfullplformat\expandafter\glslabel
+ \expandafter{\glsinsert}%
}%
}%
{%
@@ -17709,27 +23616,31 @@ defined}{}%
% \end{macrocode}
% First use singular form, don't adjust case:
% \begin{macrocode}
- \glsxtrfullformat{\glslabel}{\glsinsert}%
+ \expandafter\glsxtrfullformat\expandafter\glslabel
+ \expandafter{\glsinsert}%
}%
{%
% \end{macrocode}
% First use singular form, make first letter upper case:
% \begin{macrocode}
- \Glsxtrfullformat{\glslabel}{\glsinsert}%
+ \expandafter\Glsxtrfullformat\expandafter\glslabel
+ \expandafter{\glsinsert}%
}%
{%
% \end{macrocode}
% First use singular form, all caps:
% \begin{macrocode}
- \mfirstucMakeUppercase
- {\glsxtrfullformat{\glslabel}{\glsinsert}}%
+ \expandafter\GLSxtrfullformat\expandafter\glslabel
+ \expandafter{\glsinsert}%
}%
}%
}%
}%
{%
% \end{macrocode}
-% User supplied text.
+% Custom text provided in \cs{glsdisp}. (The insert is most likely
+% to be empty at this point.) Any inner formatting can be supplied with the custom
+% text.
% \begin{macrocode}
\glscustomtext
}%
@@ -17742,8 +23653,22 @@ defined}{}%
%\changes{1.17}{2017-08-09}{new}
% \begin{macrocode}
\newcommand*{\glsxtrsubsequentfmt}[2]{%
- \glsabbrvfont{\glsaccessshort{#1}\ifglsxtrinsertinside #2\fi}%
- \ifglsxtrinsertinside \else#2\fi
+ \glsifattribute{#1}{markshortwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ \glsabbrvfont{\glsaccessshort{#1}\glsxtrgenentrytextfmt{#2}}%
+ \else
+ \glsabbrvfont{\glsaccessshort{#1}}\glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
+ {%
+ \ifglsxtrinsertinside
+ \glsabbrvfont{\glsaccessfmtshort{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ \glsabbrvfont{\glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{#1}}%
+ \glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
}
\let\glsxtrdefaultsubsequentfmt\glsxtrsubsequentfmt
% \end{macrocode}
@@ -17754,8 +23679,22 @@ defined}{}%
%\changes{1.17}{2017-08-09}{new}
% \begin{macrocode}
\newcommand*{\glsxtrsubsequentplfmt}[2]{%
- \glsabbrvfont{\glsaccessshortpl{#1}\ifglsxtrinsertinside #2\fi}%
- \ifglsxtrinsertinside \else#2\fi
+ \glsifattribute{#1}{markshortwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ \glsabbrvfont{\glsaccessshortpl{#1}\glsxtrgenentrytextfmt{#2}}%
+ \else
+ \glsabbrvfont{\glsaccessshortpl{#1}}\glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
+ {%
+ \ifglsxtrinsertinside
+ \glsabbrvfont{\glsaccessfmtshortpl{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ \glsabbrvfont{\glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{#1}}%
+ \glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
}
\let\glsxtrdefaultsubsequentplfmt\glsxtrsubsequentplfmt
% \end{macrocode}
@@ -17766,10 +23705,25 @@ defined}{}%
%\changes{1.17}{2017-08-09}{new}
% \begin{macrocode}
\newcommand*{\Glsxtrsubsequentfmt}[2]{%
- \glsabbrvfont{\Glsaccessshort{#1}\ifglsxtrinsertinside #2\fi}%
- \ifglsxtrinsertinside \else#2\fi
+ \glsifattribute{#1}{markshortwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ \glsabbrvfont{\Glsaccessshort{#1}\glsxtrgenentrytextfmt{#2}}%
+ \else
+ \glsabbrvfont{\Glsaccessshort{#1}}\glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
+ {%
+ \ifglsxtrinsertinside
+ \glsabbrvfont{\Glsaccessfmtshort{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ \glsabbrvfont{\Glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{#1}}%
+ \glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
}
\let\Glsxtrdefaultsubsequentfmt\Glsxtrsubsequentfmt
+\glsmfuaddmap{\glsxtrsubsequentfmt}{\Glsxtrsubsequentfmt}
% \end{macrocode}
%\end{macro}
%
@@ -17778,14 +23732,87 @@ defined}{}%
%\changes{1.17}{2017-08-09}{new}
% \begin{macrocode}
\newcommand*{\Glsxtrsubsequentplfmt}[2]{%
- \glsabbrvfont{\Glsaccessshortpl{#1}\ifglsxtrinsertinside #2\fi}%
- \ifglsxtrinsertinside \else#2\fi
+ \glsifattribute{#1}{markshortwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ \glsabbrvfont{\Glsaccessshortpl{#1}\glsxtrgenentrytextfmt{#2}}%
+ \else
+ \glsabbrvfont{\Glsaccessshortpl{#1}}\glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
+ {%
+ \ifglsxtrinsertinside
+ \glsabbrvfont{\Glsaccessfmtshortpl{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ \glsabbrvfont{\Glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{#1}}%
+ \glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
}
\let\Glsxtrdefaultsubsequentplfmt\Glsxtrsubsequentplfmt
+\glsmfuaddmap{\glsxtrsubsequentplfmt}{\Glsxtrsubsequentplfmt}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrsubsequentfmt}
+% Subsequent use format (singular, all caps).
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtrsubsequentfmt}[2]{%
+ \glsifattribute{#1}{markshortwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ \glsabbrvfont{\GLSaccessshort{#1}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ \glsabbrvfont{\GLSaccessshort{#1}}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+ {%
+ \ifglsxtrinsertinside
+ \glsabbrvfont{\GLSaccessfmtshort{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ \glsabbrvfont{\GLSaccessfmtshort{}{\glsxtrgenentrytextfmt}{#1}}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+}
+\glsmfublocker{\GLSxtrsubsequentfmt}
+\let\GLSxtrdefaultsubsequentfmt\GLSxtrsubsequentfmt
% \end{macrocode}
%\end{macro}
%
-%\subsection{Abbreviation Styles Setup}
+%\begin{macro}{\GLSxtrsubsequentplfmt}
+% Subsequent use format (plural, all caps).
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtrsubsequentplfmt}[2]{%
+ \glsifattribute{#1}{markshortwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ \glsabbrvfont{\GLSaccessshortpl{#1}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ \glsabbrvfont{\GLSaccessshortpl{#1}}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+ {%
+ \ifglsxtrinsertinside
+ \glsabbrvfont{\GLSaccessfmtshortpl{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ \glsabbrvfont{\GLSaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{#1}}%
+ \glsuppercase{\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+}
+\glsmfublocker{\GLSxtrsubsequentplfmt}
+\let\GLSxtrdefaultsubsequentplfmt\GLSxtrsubsequentplfmt
+% \end{macrocode}
+%\end{macro}
+%
+%\subsubsection{Abbreviation Styles Setup}
%
%\begin{macro}{\setabbreviationstyle}
% \begin{macrocode}
@@ -17850,6 +23877,122 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtrsetcomplexstyle}
+%\changes{1.49}{2022-10-14}{new}
+%Identify an entry as having a complex abbreviation style that
+%doesn't work with \cs{GLSfirst} etc. The argument is the entry
+%label. The second argument should be numeric: 1 (all caps doesn't
+%work), 2 (all caps and insert don't work), 3 (insert doesn't work).
+% \begin{macrocode}
+\newcommand*{\glsxtrsetcomplexstyle}[2]{%
+ \csdef{@glsxtr@has@complexstyle@#1}{#2}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtr@do@ifcomplexstyle@allcaps}
+%\changes{1.49}{2022-10-14}{new}
+%Do second argument if entry identified by first argument has a
+%problem with all caps. Does nothing otherwise.
+% \begin{macrocode}
+\newcommand*{\glsxtr@do@ifcomplexstyle@allcaps}[2]{%
+ \ifcsdef{@glsxtr@has@complexstyle@#1}%
+ {%
+ \ifnum\csuse{@glsxtr@has@complexstyle@#1}<1
+ \else
+ \ifnum\csuse{@glsxtr@has@complexstyle@#1}<3
+ #2%
+ \fi
+ \fi
+ }%
+ {}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtr@do@ifcomplexstyle@insert}
+%\changes{1.49}{2022-10-14}{new}
+%Do second argument if entry identified by first argument has a
+%problem with the insert argument. Does nothing otherwise.
+% \begin{macrocode}
+\newcommand*{\glsxtr@do@ifcomplexstyle@insert}[2]{%
+ \ifcsdef{@glsxtr@has@complexstyle@#1}%
+ {%
+ \ifnum\csuse{@glsxtr@has@complexstyle@#1}<2
+ \else
+ #2%
+ \fi
+ }%
+ {}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GlossariesAbbrStyleTooComplexWarning}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\GlossariesAbbrStyleTooComplexWarning}[2]{%
+ \GlossariesExtraWarning{Abbreviation style used by `#1' too complex #2}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtr@check@complexstyle}
+%\changes{1.49}{2022-10-14}{new}
+%The first argument is the label the second is the insert.
+% \begin{macrocode}
+\newcommand*{\glsxtr@check@complexstyle}[2]{%
+ \ifx\glscapscase\@thirdofthree
+ \glsxtr@do@ifcomplexstyle@allcaps{#1}%
+ {%
+ \glsxtrifwasfirstuse
+ {%
+ \glsifplural
+ {%
+ \GlossariesAbbrStyleTooComplexWarning{#1}{for \string\GLSfirstplural.
+ Use \string\GLSpl{#1} or \string\GLSxtrfullpl{#1} instead.
+ Switching off all-caps%
+ }%
+ }%
+ {%
+ \GlossariesAbbrStyleTooComplexWarning{#1}{for \string\GLSfirst.
+ Use \string\GLS{#1} or \string\GLSxtrfull{#1} instead.
+ Switching off all-caps%
+ }%
+ }%
+ }%
+ {%
+ \glsifplural
+ {%
+ \GlossariesAbbrStyleTooComplexWarning{#1}{for \string\GLSplural.
+ Use \string\GLSpl{#1} or \string\GLSxtrshortpl{#1} instead.
+ Switching off all-caps%
+ }%
+ }%
+ {%
+ \GlossariesAbbrStyleTooComplexWarning{#1}{for \string\GLStext.
+ Use \string\GLS{#1} or \string\GLSxtrshort{#1} instead.
+ Switching off all-caps%
+ }%
+ }%
+ }%
+ \let\glscapscase\@firstofthree
+ }%
+ \fi
+ \ifstrempty{#2}{}%
+ {%
+ \glsxtr@do@ifcomplexstyle@insert{#1}%
+ {%
+ \GlossariesAbbrStyleTooComplexWarning{#1}%
+ {to support insert argument with commands like \string\glsfirst\space or
+ \string\glstext. Unexpected results may occur. Use commands
+ like \string\gls\space or \string\glsxtrshort\space instead}%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\newabbreviationstyle}
% This is different from \cs{newacronymstyle}. The first argument is
% the label, the second argument sets the information required when
@@ -17877,8 +24020,16 @@ defined}{}%
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}{\glsxtrfullformat}%
\renewcommand*{\Glsxtrinlinefullformat}{\Glsxtrfullformat}%
+ \renewcommand*{\GLSxtrinlinefullformat}{\GLSxtrfullformat}%
\renewcommand*{\glsxtrinlinefullplformat}{\glsxtrfullplformat}%
\renewcommand*{\Glsxtrinlinefullplformat}{\Glsxtrfullplformat}%
+ \renewcommand*{\GLSxtrinlinefullplformat}{\GLSxtrfullplformat}%
+% \end{macrocode}
+%In the event that some custom styles predate the introduction of
+%the all caps versions, provide default definitions:
+% \begin{macrocode}
+ \renewcommand*{\GLSxtrfullformat}{\GLSxtr@fullformat@fallback}%
+ \renewcommand*{\GLSxtrfullplformat}{\GLSxtr@fullplformat@fallback}%
% \end{macrocode}
% Reset \cs{glsxtrsubsequentfmt} etc in case a style changes this.
% \begin{macrocode}
@@ -17886,6 +24037,8 @@ defined}{}%
\let\glsxtrsubsequentplfmt\glsxtrdefaultsubsequentplfmt
\let\Glsxtrsubsequentfmt\Glsxtrdefaultsubsequentfmt
\let\Glsxtrsubsequentplfmt\Glsxtrdefaultsubsequentplfmt
+ \let\GLSxtrsubsequentfmt\GLSxtrdefaultsubsequentfmt
+ \let\GLSxtrsubsequentplfmt\GLSxtrdefaultsubsequentplfmt
#3}%
}%
}
@@ -17914,8 +24067,26 @@ defined}{}%
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}{\glsxtrfullformat}%
\renewcommand*{\Glsxtrinlinefullformat}{\Glsxtrfullformat}%
+ \renewcommand*{\GLSxtrinlinefullformat}{\GLSxtrfullformat}%
\renewcommand*{\glsxtrinlinefullplformat}{\glsxtrfullplformat}%
\renewcommand*{\Glsxtrinlinefullplformat}{\Glsxtrfullplformat}%
+ \renewcommand*{\GLSxtrinlinefullplformat}{\GLSxtrfullplformat}%
+% \end{macrocode}
+%In the event that some custom styles predate the introduction of
+%the all caps versions, provide default definitions:
+% \begin{macrocode}
+ \renewcommand*{\GLSxtrfullformat}{\GLSxtr@fullformat@fallback}%
+ \renewcommand*{\GLSxtrfullplformat}{\GLSxtr@fullplformat@fallback}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{reset subsequent fmts}
+% Reset \cs{glsxtrsubsequentfmt} etc in case a style changes this.
+% \begin{macrocode}
+ \let\glsxtrsubsequentfmt\glsxtrdefaultsubsequentfmt
+ \let\glsxtrsubsequentplfmt\glsxtrdefaultsubsequentplfmt
+ \let\Glsxtrsubsequentfmt\Glsxtrdefaultsubsequentfmt
+ \let\Glsxtrsubsequentplfmt\Glsxtrdefaultsubsequentplfmt
+ \let\GLSxtrsubsequentfmt\GLSxtrdefaultsubsequentfmt
+ \let\GLSxtrsubsequentplfmt\GLSxtrdefaultsubsequentplfmt
#3}%
}%
}
@@ -17991,19 +24162,26 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
-%\subsection{Predefined Styles (Default Font)}
+%\subsubsection{Predefined Styles}
% Define some common styles. These will set the \gloskey{first},
% \gloskey{firstplural}, \gloskey{text} and \gloskey{plural}
% keys, even if the \catattr{regular} attribute isn't set to
% \qt{true}. If this attribute is set, commands like \cs{gls} will
% use them as per a regular entry, otherwise those keys will be
% ignored unless explicitly invoked by the user with commands like
-% \cs{glsfirst}. In order for the first letter uppercase versions to
+% \cs{glsfirst}. In order for the sentence case versions to
% work correctly, \cs{glsxtrfullformat} needs to be expanded when
% those keys are set. The final optional argument of \cs{glsfirst}
% will behave differently to the final optional argument of \cs{gls}
% with some styles.
%
+%v1.49 has introduced innertextformat for formatting commands that
+%need access to the actual text (which is normally too deeply
+%embedded). The styles have been modified to allow for this. The all
+%caps versions also now need to be implemented within the styles as
+%again the text is now to deeply embedded for the case change to
+%otherwise work.
+%
%\begin{macro}{\ifglsxtrinsertinside}
%\changes{1.02}{2016-04-25}{new}
% Switch to determine if the insert text should be inside or outside
@@ -18013,16 +24191,6723 @@ defined}{}%
\glsxtrinsertinsidefalse
% \end{macrocode}
%\end{macro}
+%The abbreviation styles are now defined in the file
+%\texttt{glossaries-extra-abbrstyles.def}, which needs to be input
+%here:
+% \begin{macrocode}
+\input{glossaries-extra-abbrstyles.def}
+% \end{macrocode}
+%
+%\subsection{Using Entries in Headings}
+%
+% There are four main problems with using entries in sectioning
+% commands: they can mess with the first use flag if they end up in
+% the table of contents, they can add unwanted numbers to the
+% entry's location list, the label is corrupted if used inside
+% \cs{MakeUppercase} (which is used by the default headings style)
+% and they need to be expandable for PDF bookmarks. The
+% \sty{glossaries} package therefore recommends the use of the
+% expandable commands, such as \cs{glsentryshort}, instead but this
+% doesn't reflect the formatting since it doesn't include
+% \cs{glsabbrvfont}. The commands below are an attempt to get around
+% these problems.
+%
+% The PDF bookmark issue can easily be fixed with \sty{hyperref}'s
+% \cs{texorpdfstring} which can simply use the expandable command
+% in the PDF string case. The \TeX\ string case can now use
+% \cs{glsxtrshort} with the \gloskey[glslink]{noindex} key set, which
+% prevents the unwanted additions to the location list, and the
+% \gloskey[glslink]{hyper} key set to false, which prevents the problem of
+% nested links. This just leaves one thing left that needs to be
+% dealt with, and that's what to do if the heading style
+% uses \cs{MakeUppercase}.
+%
+% Note that \sty{glossaries} automatically loads \sty{textcase}
+% unless \sty{mfirstuc} 2.08+ is detected, so
+% the label can be protected from case change with \sty{textcase}'s
+% \cs{NoCaseChange}. This means that we don't have a problem
+% provided the page style uses \cs{MakeTextUppercase}, but the
+% default heading page style uses \cs{MakeUppercase}. (With newer
+% versions of \sty{mfirstuc}, exclusions are used to protect labels).
+%
+% To get around this, save the original definition of \cs{markboth}
+% and \cs{markright} and adjust it so that \cs{MakeUppercase} is
+% temporarily redefined to \cs{MakeTextUppercase}. Some packages or
+% classes redefine these commands, so we can't just assume they
+% still have the original kernel definition. This only needs to be
+% done with old versions of \sty{mfirstuc}.
+%
+%\begin{macro}{\markright}
+% Save original definition:
+% \begin{macrocode}
+\let\@glsxtr@org@markright\markright
+% \end{macrocode}
+% Redefine (grouping not added in case it interferes with the
+% original code):
+% \begin{macrocode}
+\renewcommand*{\markright}[1]{%
+ \glsxtrmarkhook
+ \@glsxtr@org@markright{\@glsxtrinmark#1\@glsxtrnotinmark}%
+ \glsxtrrestoremarkhook
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\markboth}
+% Save original definition:
+% \begin{macrocode}
+\let\@glsxtr@org@markboth\markboth
+% \end{macrocode}
+% Redefine (grouping not added in case it interferes with the
+% original code):
+% \begin{macrocode}
+\renewcommand*{\markboth}[2]{%
+ \glsxtrmarkhook
+ \@glsxtr@org@markboth
+ {\@glsxtrinmark#1\@glsxtrnotinmark}%
+ {\@glsxtrinmark#2\@glsxtrnotinmark}%
+ \glsxtrrestoremarkhook
+}
+% \end{macrocode}
+%\end{macro}
+%
+%Also do this for \cs{@starttoc}
+%\begin{macro}{\@starttoc}
+% Save original definition:
+% \begin{macrocode}
+\let\@glsxtr@org@@starttoc\@starttoc
+% \end{macrocode}
+% Redefine:
+% \begin{macrocode}
+\renewcommand*{\@starttoc}[1]{%
+ \let\glsxtrifintoc\@firstoftwo
+ \glsxtrmarkhook
+ \@glsxtrinmark
+ \@glsxtr@org@@starttoc{#1}%
+ \@glsxtrnotinmark
+ \glsxtrrestoremarkhook
+ \let\glsxtrifintoc\@secondoftwo
+}
+% \end{macrocode}
+%\end{macro}
+%
+% If this causes a problem provide a simple way of switching back to
+% the original definitions:
+%\begin{macro}{\glsxtrRevertMarks}
+% \begin{macrocode}
+\newcommand*{\glsxtrRevertMarks}{%
+ \let\markright\@glsxtr@org@markright
+ \let\markboth\@glsxtr@org@markboth
+ \let\@starttoc\@glsxtr@org@@starttoc
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrRevertTocMarks}
+%\changes{1.31}{2018-05-09}{new}
+%Just restores \cs{@starttoc}.
+% \begin{macrocode}
+\newcommand*{\glsxtrRevertTocMarks}{%
+ \let\@starttoc\@glsxtr@org@@starttoc
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrifinmark}
+%\changes{1.07}{2016-08-15}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrifinmark}[2]{#2}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsxtrinmark}
+%\changes{1.07}{2016-08-15}{new}
+% \begin{macrocode}
+\newrobustcmd*{\@glsxtrinmark}{%
+ \let\glsxtrifinmark\@firstoftwo
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsxtrnotinmark}
+%\changes{1.07}{2016-08-15}{new}
+% \begin{macrocode}
+\newrobustcmd*{\@glsxtrnotinmark}{%
+ \let\glsxtrifinmark\@secondoftwo
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrtitleorpdforheading}
+%\changes{1.21}{2017-11-03}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrtitleorpdforheading}[3]{%
+ \glsxtrifinmark{#3}{\glstexorpdfstring{#1}{#2}}}
+% \end{macrocode}
+%\end{macro}
+%
+%\changes{1.49}{2022-10-14}{add gettitlestring patch for \cs{glsxtrtitleorpdforheading}}
+%This will require \verb|\GetTitleStringSetup{expand}| to work.
+% \begin{macrocode}
+\ifdef\GetTitleStringDisableCommands
+{\GetTitleStringDisableCommands{\let\glsxtrtitleorpdforheading\@thirdofthree
+ \let\glsxtrifinmark\@firstoftwo}}
+{}
+% \end{macrocode}
+%
+%\begin{macro}{\glsxtrmarkhook}
+% Hook used in new definition of \cs{markboth} and \cs{markright}
+% to make some changes to apply to the marks:
+% \begin{macrocode}
+\newcommand*{\glsxtrmarkhook}{%
+% \end{macrocode}
+% Save current definitions:
+% \begin{macrocode}
+ \@glsxtr@saveMakeUppercase
+ \let\@glsxtr@org@glsxtrtitleorpdforheading\glsxtrtitleorpdforheading
+ \let\@glsxtr@org@glsxtrtitleshort\glsxtrtitleshort
+ \let\@glsxtr@org@glsxtrtitleshortpl\glsxtrtitleshortpl
+ \let\@glsxtr@org@Glsxtrtitleshort\Glsxtrtitleshort
+ \let\@glsxtr@org@Glsxtrtitleshortpl\Glsxtrtitleshortpl
+ \let\@glsxtr@org@GLSxtrtitleshort\GLSxtrtitleshort
+ \let\@glsxtr@org@GLSxtrtitleshortpl\GLSxtrtitleshortpl
+ \let\@glsxtr@org@glsxtrtitlename\glsxtrtitlename
+ \let\@glsxtr@org@Glsxtrtitlename\Glsxtrtitlename
+ \let\@glsxtr@org@glsxtrtitletext\glsxtrtitletext
+ \let\@glsxtr@org@Glsxtrtitletext\Glsxtrtitletext
+ \let\@glsxtr@org@GLSxtrtitletext\GLSxtrtitletext
+ \let\@glsxtr@org@glsxtrtitleplural\glsxtrtitleplural
+ \let\@glsxtr@org@Glsxtrtitleplural\Glsxtrtitleplural
+ \let\@glsxtr@org@GLSxtrtitleplural\GLSxtrtitleplural
+ \let\@glsxtr@org@glsxtrtitlefirst\glsxtrtitlefirst
+ \let\@glsxtr@org@Glsxtrtitlefirst\Glsxtrtitlefirst
+ \let\@glsxtr@org@glsxtrtitlefirstplural\glsxtrtitlefirstplural
+ \let\@glsxtr@org@Glsxtrtitlefirstplural\Glsxtrtitlefirstplural
+ \let\@glsxtr@org@GLSxtrtitlefirstplural\GLSxtrtitlefirstplural
+ \let\@glsxtr@org@glsxtrtitlelong\glsxtrtitlelong
+ \let\@glsxtr@org@glsxtrtitlelongpl\glsxtrtitlelongpl
+ \let\@glsxtr@org@Glsxtrtitlelong\Glsxtrtitlelong
+ \let\@glsxtr@org@Glsxtrtitlelongpl\Glsxtrtitlelongpl
+ \let\@glsxtr@org@glsxtrtitlefull\glsxtrtitlefull
+ \let\@glsxtr@org@glsxtrtitlefullpl\glsxtrtitlefullpl
+ \let\@glsxtr@org@Glsxtrtitlefull\Glsxtrtitlefull
+ \let\@glsxtr@org@Glsxtrtitlefullpl\Glsxtrtitlefullpl
+ \let\@glsxtr@org@GLSxtrtitlefull\GLSxtrtitlefull
+ \let\@glsxtr@org@GLSxtrtitlefullpl\GLSxtrtitlefullpl
+% \end{macrocode}
+% New definitions
+% \begin{macrocode}
+ \let\glsxtrifinmark\@firstoftwo
+ \@glsxtr@assignMakeUppercase
+ \let\glsxtrtitleorpdforheading\@thirdofthree
+ \let\glsxtrtitleshort\glsxtrheadshort
+ \let\glsxtrtitleshortpl\glsxtrheadshortpl
+ \let\Glsxtrtitleshort\Glsxtrheadshort
+ \let\Glsxtrtitleshortpl\Glsxtrheadshortpl
+ \let\GLSxtrtitleshort\GLSxtrheadshort
+ \let\GLSxtrtitleshortpl\GLSxtrheadshortpl
+ \let\glsxtrtitlename\glsxtrheadname
+ \let\Glsxtrtitlename\Glsxtrheadname
+ \let\GLSxtrtitlename\GLSxtrheadname
+ \let\glsxtrtitletext\glsxtrheadtext
+ \let\Glsxtrtitletext\Glsxtrheadtext
+ \let\GLSxtrtitletext\GLSxtrheadtext
+ \let\glsxtrtitleplural\glsxtrheadplural
+ \let\Glsxtrtitleplural\Glsxtrheadplural
+ \let\GLSxtrtitleplural\GLSxtrheadplural
+ \let\glsxtrtitlefirst\glsxtrheadfirst
+ \let\Glsxtrtitlefirst\Glsxtrheadfirst
+ \let\GLSxtrtitlefirst\GLSxtrheadfirst
+ \let\glsxtrtitlefirstplural\glsxtrheadfirstplural
+ \let\Glsxtrtitlefirstplural\Glsxtrheadfirstplural
+ \let\GLSxtrtitlefirstplural\GLSxtrheadfirstplural
+ \let\glsxtrtitlelong\glsxtrheadlong
+ \let\glsxtrtitlelongpl\glsxtrheadlongpl
+ \let\Glsxtrtitlelong\Glsxtrheadlong
+ \let\Glsxtrtitlelongpl\Glsxtrheadlongpl
+ \let\glsxtrtitlefull\glsxtrheadfull
+ \let\glsxtrtitlefullpl\glsxtrheadfullpl
+ \let\Glsxtrtitlefull\Glsxtrheadfull
+ \let\Glsxtrtitlefullpl\Glsxtrheadfullpl
+ \let\GLSxtrtitlefull\GLSxtrheadfull
+ \let\GLSxtrtitlefullpl\GLSxtrheadfullpl
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrrestoremarkhook}
+% Hook used in new definition of \cs{markboth} and \cs{markright}
+% to restore the modified definitions. (This is in case the original
+% \cs{markboth} and \cs{markright} shouldn't be grouped for some
+% reason. There already is some grouping within those original
+% definitions, but some of the code lies outside that grouping, and
+% possibly there's a reason for it.)
+% \begin{macrocode}
+\newcommand*{\glsxtrrestoremarkhook}{%
+ \let\glsxtrifinmark\@secondoftwo
+ \@glsxtr@restoreMakeUppercase
+ \let\glsxtrtitleorpdforheading\@glsxtr@org@glsxtrtitleorpdforheading
+ \let\glsxtrtitleshort\@glsxtr@org@glsxtrtitleshort
+ \let\glsxtrtitleshortpl\@glsxtr@org@glsxtrtitleshortpl
+ \let\Glsxtrtitleshort\@glsxtr@org@Glsxtrtitleshort
+ \let\Glsxtrtitleshortpl\@glsxtr@org@Glsxtrtitleshortpl
+ \let\GLSxtrtitleshort\@glsxtr@org@GLSxtrtitleshort
+ \let\GLSxtrtitleshortpl\@glsxtr@org@GLSxtrtitleshortpl
+ \let\glsxtrtitlename\@glsxtr@org@glsxtrtitlename
+ \let\Glsxtrtitlename\@glsxtr@org@Glsxtrtitlename
+ \let\GLSxtrtitlename\@glsxtr@org@GLSxtrtitlename
+ \let\glsxtrtitletext\@glsxtr@org@glsxtrtitletext
+ \let\Glsxtrtitletext\@glsxtr@org@Glsxtrtitletext
+ \let\GLSxtrtitletext\@glsxtr@org@GLSxtrtitletext
+ \let\glsxtrtitleplural\@glsxtr@org@glsxtrtitleplural
+ \let\Glsxtrtitleplural\@glsxtr@org@Glsxtrtitleplural
+ \let\GLSxtrtitleplural\@glsxtr@org@GLSxtrtitleplural
+ \let\glsxtrtitlefirst\@glsxtr@org@glsxtrtitlefirst
+ \let\Glsxtrtitlefirst\@glsxtr@org@Glsxtrtitlefirst
+ \let\GLSxtrtitlefirst\@glsxtr@org@GLSxtrtitlefirst
+ \let\glsxtrtitlefirstplural\@glsxtr@org@glsxtrtitlefirstplural
+ \let\Glsxtrtitlefirstplural\@glsxtr@org@Glsxtrtitlefirstplural
+ \let\GLSxtrtitlefirstplural\@glsxtr@org@GLSxtrtitlefirstplural
+ \let\glsxtrtitlelong\@glsxtr@org@glsxtrtitlelong
+ \let\glsxtrtitlelongpl\@glsxtr@org@glsxtrtitlelongpl
+ \let\Glsxtrtitlelong\@glsxtr@org@Glsxtrtitlelong
+ \let\Glsxtrtitlelongpl\@glsxtr@org@Glsxtrtitlelongpl
+ \let\glsxtrtitlefull\@glsxtr@org@glsxtrtitlefull
+ \let\glsxtrtitlefullpl\@glsxtr@org@glsxtrtitlefullpl
+ \let\Glsxtrtitlefull\@glsxtr@org@Glsxtrtitlefull
+ \let\Glsxtrtitlefullpl\@glsxtr@org@Glsxtrtitlefullpl
+ \let\GLSxtrtitlefull\@glsxtr@org@GLSxtrtitlefull
+ \let\GLSxtrtitlefullpl\@glsxtr@org@GLSxtrtitlefullpl
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\changes{0.5.1}{2015-12-07}{removed \cs{ifglsxtruseuchead}}
+% Instead of using one document-wide conditional, use
+% \catattr{headuc} attribute to determine whether or not to use the
+% all upper case form.
+%
+%\begin{macro}{\glsxtrtitleopts}
+%\changes{1.49}{2022-10-14}{new}
+%Make it possible to change the default options within the title
+%(but not the page header or table of contents).
+% \begin{macrocode}
+\newcommand*{\glsxtrtitleopts}{noindex,hyper=false}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtr@title@field}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glsxtr@title@field}\marg{cs}\marg{label}
+%\end{definition}
+%Used by all the \cs{glsxtrtitle\meta{field}} commands for
+%consistency.
+% \begin{macrocode}
+\newcommand*{\glsxtr@title@field}[2]{%
+ \expandafter#1\expandafter[\glsxtrtitleopts]{#2}[]%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrheadshort}
+% Command used to display short form in the page header.
+%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
+% \begin{macrocode}
+\newcommand*{\glsxtrheadshort}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsxtrifheaduc{#1}%
+ {%
+ \GLSxtrshort[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \glsxtrshort[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrtitleshort}
+% Command to display short form of abbreviation in section title.
+% \begin{macrocode}
+\newrobustcmd*{\glsxtrtitleshort}[1]{%
+ \glsxtr@title@field\glsxtrshort{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrheadshortpl}
+% Command used to display plural short form in the page header.
+% If you want the text converted to upper case, this needs to be
+% redefined to use \cs{GLSxtrshortpl} instead. If you are using a
+% smallcaps style, the default fonts don't provide italic smallcaps.
+%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
+% \begin{macrocode}
+\newcommand*{\glsxtrheadshortpl}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsxtrifheaduc{#1}%
+ {%
+ \GLSxtrshortpl[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \glsxtrshortpl[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrtitleshortpl}
+% Command to display plural short form of abbreviation in section title.
+%\changes{1.03}{2016-04-27}{bug fix: changed \cs{glsxtrshort} to
+%\cs{glsxtrshortpl}}
+% \begin{macrocode}
+\newrobustcmd*{\glsxtrtitleshortpl}[1]{%
+ \glsxtr@title@field\glsxtrshortpl{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrheadshort}
+% Command used to display short form in the page header with the
+% first letter converted to upper case.
+%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
+% \begin{macrocode}
+\newcommand*{\Glsxtrheadshort}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsxtrifheaduc{#1}%
+ {%
+ \GLSxtrshort[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \Glsxtrshort[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrtitleshort}
+% Command to display short form of abbreviation in section title
+% with the first letter converted to upper case.
+% \begin{macrocode}
+\newrobustcmd*{\Glsxtrtitleshort}[1]{%
+ \glsxtr@title@field\Glsxtrshort{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrheadshort}
+%\changes{1.49}{2022-10-14}{new}
+%There's no need to check for the headuc attribute.
+% \begin{macrocode}
+\newcommand*{\GLSxtrheadshort}[1]{%
+ \protect\NoCaseChange
+ {%
+ \GLSxtrshort[noindex,hyper=false]{#1}[]%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrtitleshort}
+%\changes{1.42}{2020-02-03}{new}
+% Command to display short form of abbreviation in section title
+% in all upper case.
+% \begin{macrocode}
+\newrobustcmd*{\GLSxtrtitleshort}[1]{%
+ \glsxtr@title@field\GLSxtrshort{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrheadshortpl}
+%\changes{1.49}{2022-10-14}{new}
+%There's no need to check for the headuc attribute.
+% \begin{macrocode}
+\newcommand*{\GLSxtrheadshortpl}[1]{%
+ \protect\NoCaseChange
+ {%
+ \GLSxtrshortpl[noindex,hyper=false]{#1}[]%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrheadshortpl}
+% Command used to display plural short form in the page header with the
+% first letter converted to upper case.
+%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
+% \begin{macrocode}
+\newcommand*{\Glsxtrheadshortpl}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsxtrifheaduc{#1}%
+ {%
+ \GLSxtrshortpl[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \Glsxtrshortpl[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrtitleshortpl}
+% Command to display plural short form of abbreviation in section title
+% with the first letter converted to upper case.
+% \begin{macrocode}
+\newrobustcmd*{\Glsxtrtitleshortpl}[1]{%
+ \glsxtr@title@field\Glsxtrshortpl{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrtitleshortpl}
+%\changes{1.42}{2020-02-03}{new}
+% Command to display plural short form of abbreviation in section title
+% in all upper case.
+% \begin{macrocode}
+\newrobustcmd*{\GLSxtrtitleshortpl}[1]{%
+ \glsxtr@title@field\GLSxtrshortpl{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrheadname}
+% As above but for the \gloskey{name} value.
+%\changes{1.21}{2017-11-03}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrheadname}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsxtrifheaduc{#1}%
+ {%
+ \GLSname[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \glsname[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrtitlename}
+% Command to display \gloskey{name} value in section title.
+%\changes{1.21}{2017-11-03}{new}
+% \begin{macrocode}
+\newrobustcmd*{\glsxtrtitlename}[1]{%
+ \glsxtr@title@field\glsname{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrheadname}
+% First letter converted to upper case
+%\changes{1.21}{2017-11-03}{new}
+% \begin{macrocode}
+\newcommand*{\Glsxtrheadname}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsxtrifheaduc{#1}%
+ {%
+ \GLSname[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \Glsname[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrtitlename}
+% Command to display \gloskey{name} value in section title
+% with the first letter changed to upper case.
+%\changes{1.21}{2017-11-03}{new}
+% \begin{macrocode}
+\newrobustcmd*{\Glsxtrtitlename}[1]{%
+ \glsxtr@title@field\Glsname{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrheadname}
+%\changes{1.49}{2022-10-14}{new}
+%There's no need to check for the headuc attribute.
+% \begin{macrocode}
+\newcommand*{\GLSxtrheadname}[1]{%
+ \protect\NoCaseChange
+ {%
+ \GLSname[noindex,hyper=false]{#1}[]%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrtitlename}
+% Command to display \gloskey{name} value in section title
+% in all upper case.
+%\changes{1.42}{2020-02-03}{new}
+% \begin{macrocode}
+\newrobustcmd*{\GLSxtrtitlename}[1]{%
+ \glsxtr@title@field\GLSname{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrheadtext}
+% As above but for the \gloskey{text} value.
+%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
+% \begin{macrocode}
+\newcommand*{\glsxtrheadtext}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsxtrifheaduc{#1}%
+ {%
+ \GLStext[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \glstext[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrtitletext}
+% Command to display \gloskey{text} value in section title.
+% \begin{macrocode}
+\newrobustcmd*{\glsxtrtitletext}[1]{%
+ \glsxtr@title@field\glstext{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%
+%\begin{macro}{\Glsxtrheadtext}
+% First letter converted to upper case
+%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
+% \begin{macrocode}
+\newcommand*{\Glsxtrheadtext}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsxtrifheaduc{#1}%
+ {%
+ \GLStext[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \Glstext[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrtitletext}
+% Command to display \gloskey{text} value in section title
+% with the first letter changed to upper case.
+% \begin{macrocode}
+\newrobustcmd*{\Glsxtrtitletext}[1]{%
+ \glsxtr@title@field\Glstext{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrheadtext}
+%\changes{1.49}{2022-10-14}{new}
+%There's no need to check for the headuc attribute.
+% \begin{macrocode}
+\newcommand*{\GLSxtrheadtext}[1]{%
+ \protect\NoCaseChange
+ {%
+ \GLStext[noindex,hyper=false]{#1}[]%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrtitletext}
+% Command to display \gloskey{text} value in section title
+% in all upper case.
+%\changes{1.42}{2020-02-03}{new}
+% \begin{macrocode}
+\newrobustcmd*{\GLSxtrtitletext}[1]{%
+ \glsxtr@title@field\GLStext{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrheadplural}
+% As above but for the \gloskey{plural} value.
+%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
+% \begin{macrocode}
+\newcommand*{\glsxtrheadplural}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsxtrifheaduc{#1}%
+ {%
+ \GLSplural[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \glsplural[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrtitleplural}
+% Command to display \gloskey{plural} value in section title.
+% \begin{macrocode}
+\newrobustcmd*{\glsxtrtitleplural}[1]{%
+ \glsxtr@title@field\glsplural{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrheadplural}
+% Convert first letter to upper case.
+%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
+% \begin{macrocode}
+\newcommand*{\Glsxtrheadplural}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsxtrifheaduc{#1}%
+ {%
+ \GLSplural[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \Glsplural[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrtitleplural}
+% Command to display \gloskey{plural} value in section title
+% with the first letter changed to upper case.
+% \begin{macrocode}
+\newrobustcmd*{\Glsxtrtitleplural}[1]{%
+ \glsxtr@title@field\Glsplural{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrheadplural}
+%\changes{1.49}{2022-10-14}{new}
+%There's no need to check for the headuc attribute.
+% \begin{macrocode}
+\newcommand*{\GLSxtrheadplural}[1]{%
+ \protect\NoCaseChange
+ {%
+ \GLSplural[noindex,hyper=false]{#1}[]%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrtitleplural}
+%\changes{1.42}{2020-02-03}{new}
+% Command to display \gloskey{plural} value in section title
+% in all upper case.
+% \begin{macrocode}
+\newrobustcmd*{\GLSxtrtitleplural}[1]{%
+ \glsxtr@title@field\GLSplural{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrheadfirst}
+% As above but for the \gloskey{first} value.
+%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
+% \begin{macrocode}
+\newcommand*{\glsxtrheadfirst}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsxtrifheaduc{#1}%
+ {%
+ \GLSfirst[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \glsfirst[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrtitlefirst}
+% Command to display \gloskey{first} value in section title.
+% \begin{macrocode}
+\newrobustcmd*{\glsxtrtitlefirst}[1]{%
+ \glsxtr@title@field\glsfirst{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrheadfirst}
+% First letter converted to upper case
+%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
+% \begin{macrocode}
+\newcommand*{\Glsxtrheadfirst}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsxtrifheaduc{#1}%
+ {%
+ \GLSfirst[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \Glsfirst[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrtitlefirst}
+% Command to display \gloskey{first} value in section title
+% with the first letter changed to upper case.
+% \begin{macrocode}
+\newrobustcmd*{\Glsxtrtitlefirst}[1]{%
+ \glsxtr@title@field\Glsfirst{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrheadfirst}
+%\changes{1.49}{2022-10-14}{new}
+%There's no need to check for the headuc attribute.
+% \begin{macrocode}
+\newcommand*{\GLSxtrheadfirst}[1]{%
+ \protect\NoCaseChange
+ {%
+ \GLSfirst[noindex,hyper=false]{#1}[]%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrtitlefirst}
+%\changes{1.42}{2020-02-03}{new}
+% Command to display \gloskey{first} value in section title
+% in all upper case.
+% \begin{macrocode}
+\newrobustcmd*{\GLSxtrtitlefirst}[1]{%
+ \glsxtr@title@field\GLSfirst{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrheadfirstplural}
+% As above but for the \gloskey{firstplural} value.
+%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
+% \begin{macrocode}
+\newcommand*{\glsxtrheadfirstplural}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsxtrifheaduc{#1}%
+ {%
+ \GLSfirstplural[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \glsfirstplural[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrtitlefirstplural}
+% Command to display \gloskey{firstplural} value in section title.
+% \begin{macrocode}
+\newrobustcmd*{\glsxtrtitlefirstplural}[1]{%
+ \glsxtr@title@field\glsfirstplural{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrheadfirstplural}
+% First letter converted to upper case
+%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
+% \begin{macrocode}
+\newcommand*{\Glsxtrheadfirstplural}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsxtrifheaduc{#1}%
+ {%
+ \GLSfirstplural[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \Glsfirstplural[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrtitlefirstplural}
+% Command to display \gloskey{first} value in section title
+% with the first letter changed to upper case.
+% \begin{macrocode}
+\newrobustcmd*{\Glsxtrtitlefirstplural}[1]{%
+ \glsxtr@title@field\Glsfirstplural{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrheadfirstplural}
+%\changes{1.49}{2022-10-14}{new}
+%There's no need to check for the headuc attribute.
+% \begin{macrocode}
+\newcommand*{\GLSxtrheadfirstplural}[1]{%
+ \protect\NoCaseChange
+ {%
+ \GLSfirstplural[noindex,hyper=false]{#1}[]%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrtitlefirstplural}
+%\changes{1.42}{2020-02-03}{new}
+% Command to display \gloskey{first} value in section title
+% in all upper case.
+% \begin{macrocode}
+\newrobustcmd*{\GLSxtrtitlefirstplural}[1]{%
+ \glsxtr@title@field\GLSfirstplural{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrheadlong}
+% Command used to display long form in the page header.
+%\changes{1.02}{2016-04-25}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrheadlong}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsxtrifheaduc{#1}%
+ {%
+ \GLSxtrlong[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \glsxtrlong[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrtitlelong}
+% Command to display long form of abbreviation in section title.
+%\changes{1.02}{2016-04-25}{new}
+% \begin{macrocode}
+\newrobustcmd*{\glsxtrtitlelong}[1]{%
+ \glsxtr@title@field\glsxtrlong{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrheadlongpl}
+% Command used to display plural long form in the page header.
+% If you want the text converted to upper case, this needs to be
+% redefined to use \cs{GLSxtrlongpl} instead. If you are using a
+% smallcaps style, the default fonts don't provide italic smallcaps.
+%\changes{1.02}{2016-04-25}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrheadlongpl}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsxtrifheaduc{#1}%
+ {%
+ \GLSxtrlongpl[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \glsxtrlongpl[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrtitlelongpl}
+% Command to display plural long form of abbreviation in section title.
+%\changes{1.02}{2016-04-25}{new}
+%\changes{1.03}{2016-04-27}{bug fix: changed \cs{glsxtrlong} to
+%\cs{glsxtrlongpl}}
+% \begin{macrocode}
+\newrobustcmd*{\glsxtrtitlelongpl}[1]{%
+ \glsxtr@title@field\glsxtrlongpl{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrheadlong}
+% Command used to display long form in the page header with the
+% first letter converted to upper case.
+%\changes{1.02}{2016-04-25}{new}
+% \begin{macrocode}
+\newcommand*{\Glsxtrheadlong}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsxtrifheaduc{#1}%
+ {%
+ \GLSxtrlong[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \Glsxtrlong[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrtitlelong}
+% Command to display long form of abbreviation in section title
+% with the first letter converted to upper case.
+%\changes{1.02}{2016-04-25}{new}
+% \begin{macrocode}
+\newrobustcmd*{\Glsxtrtitlelong}[1]{%
+ \glsxtr@title@field\Glsxtrlong{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrtitlelong}
+% Command to display long form of abbreviation in section title
+% in all upper case.
+%\changes{1.42}{2020-02-03}{new}
+% \begin{macrocode}
+\newrobustcmd*{\GLSxtrtitlelong}[1]{%
+ \glsxtr@title@field\GLSxtrlong{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrheadlong}
+%\changes{1.49}{2022-10-14}{new}
+%There's no need to check for the headuc attribute.
+% \begin{macrocode}
+\newcommand*{\GLSxtrheadlong}[1]{%
+ \protect\NoCaseChange
+ {%
+ \GLSxtrlong[noindex,hyper=false]{#1}[]%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrheadlongpl}
+% Command used to display plural long form in the page header with the
+% first letter converted to upper case.
+%\changes{1.02}{2016-04-25}{new}
+% \begin{macrocode}
+\newcommand*{\Glsxtrheadlongpl}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsxtrifheaduc{#1}%
+ {%
+ \GLSxtrlongpl[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \Glsxtrlongpl[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrtitlelongpl}
+% Command to display plural long form of abbreviation in section title
+% with the first letter converted to upper case.
+%\changes{1.02}{2016-04-25}{new}
+% \begin{macrocode}
+\newrobustcmd*{\Glsxtrtitlelongpl}[1]{%
+ \glsxtr@title@field\Glsxtrlongpl{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrtitlelongpl}
+% Command to display plural long form of abbreviation in section title
+% in all upper case.
+%\changes{1.42}{2020-02-03}{new}
+% \begin{macrocode}
+\newrobustcmd*{\GLSxtrtitlelongpl}[1]{%
+ \glsxtr@title@field\GLSxtrlongpl{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrheadlongpl}
+%\changes{1.49}{2022-10-14}{new}
+%There's no need to check for the headuc attribute.
+% \begin{macrocode}
+\newcommand*{\GLSxtrheadlongpl}[1]{%
+ \protect\NoCaseChange
+ {%
+ \GLSxtrlongpl[noindex,hyper=false]{#1}[]%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrheadfull}
+% Command used to display full form in the page header.
+%\changes{1.02}{2016-04-25}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrheadfull}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsxtrifheaduc{#1}%
+ {%
+ \GLSxtrfull[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \glsxtrfull[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrtitlefull}
+% Command to display full form of abbreviation in section title.
+%\changes{1.02}{2016-04-25}{new}
+% \begin{macrocode}
+\newrobustcmd*{\glsxtrtitlefull}[1]{%
+ \glsxtr@title@field\glsxtrfull{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrheadfullpl}
+% Command used to display plural full form in the page header.
+% If you want the text converted to upper case, this needs to be
+% redefined to use \cs{GLSxtrfullpl} instead. If you are using a
+% smallcaps style, the default fonts don't provide italic smallcaps.
+%\changes{1.02}{2016-04-25}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrheadfullpl}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsxtrifheaduc{#1}%
+ {%
+ \GLSxtrfullpl[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \glsxtrfullpl[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrtitlefullpl}
+% Command to display plural full form of abbreviation in section title.
+%\changes{1.02}{2016-04-25}{new}
+% \begin{macrocode}
+\newrobustcmd*{\glsxtrtitlefullpl}[1]{%
+ \glsxtr@title@field\glsxtrfullpl{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrheadfull}
+% Command used to display full form in the page header with the
+% first letter converted to upper case.
+%\changes{1.02}{2016-04-25}{new}
+% \begin{macrocode}
+\newcommand*{\Glsxtrheadfull}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsxtrifheaduc{#1}%
+ {%
+ \GLSxtrfull[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \Glsxtrfull[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrtitlefull}
+% Command to display full form of abbreviation in section title
+% with the first letter converted to upper case.
+%\changes{1.02}{2016-04-25}{new}
+% \begin{macrocode}
+\newrobustcmd*{\Glsxtrtitlefull}[1]{%
+ \glsxtr@title@field\Glsxtrfull{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrheadfull}
+%\changes{1.49}{2022-10-14}{new}
+%There's no need to check for the headuc attribute.
+% \begin{macrocode}
+\newcommand*{\GLSxtrheadfull}[1]{%
+ \protect\NoCaseChange
+ {%
+ \GLSxtrfull[noindex,hyper=false]{#1}[]%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrtitlefull}
+% Command to display full form of abbreviation in section title
+% in all upper case.
+%\changes{1.42}{2020-02-03}{new}
+% \begin{macrocode}
+\newrobustcmd*{\GLSxtrtitlefull}[1]{%
+ \glsxtr@title@field\GLSxtrfull{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrheadfullpl}
+% Command used to display plural full form in the page header with the
+% first letter converted to upper case.
+%\changes{1.02}{2016-04-25}{new}
+% \begin{macrocode}
+\newcommand*{\Glsxtrheadfullpl}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsxtrifheaduc{#1}%
+ {%
+ \GLSxtrfullpl[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \Glsxtrfullpl[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrtitlefullpl}
+% Command to display plural full form of abbreviation in section title
+% with the first letter converted to upper case.
+%\changes{1.02}{2016-04-25}{new}
+% \begin{macrocode}
+\newrobustcmd*{\Glsxtrtitlefullpl}[1]{%
+ \glsxtr@title@field\Glsxtrfullpl{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrheadfullpl}
+%\changes{1.49}{2022-10-14}{new}
+%There's no need to check for the headuc attribute.
+% \begin{macrocode}
+\newcommand*{\GLSxtrheadfullpl}[1]{%
+ \protect\NoCaseChange
+ {%
+ \GLSxtrfullpl[noindex,hyper=false]{#1}[]%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrtitlefullpl}
+% Command to display plural full form of abbreviation in section title
+% in all upper case.
+%\changes{1.42}{2020-02-03}{new}
+% \begin{macrocode}
+\newrobustcmd*{\GLSxtrtitlefullpl}[1]{%
+ \glsxtr@title@field\GLSxtrfullpl{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsfmtshort}
+% Provide a way of using the formatted short form in section
+% headings. If \sty{hyperref} has been loaded, use
+% \cs{texorpdfstring} for convenience in PDF bookmarks.
+%\changes{0.2}{2015-11-30}{new}
+%\changes{0.4}{2015-12-03}{changed to use \cs{glsxtrshort}}
+%\changes{0.5}{2015-12-07}{changed to use \cs{glsxtrtitleshort}}
+%\changes{0.5}{2015-12-07}{renamed from \cs{glsentryfmtshort}}
+% \begin{macrocode}
+\newcommand*{\glsfmtshort}[1]{%
+ \glstexorpdfstring
+ {\glsxtrtitleshort{#1}}%
+ {\glsentryshort{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%Similarly for the plural version.
+%\begin{macro}{\glsfmtshortpl}
+%\changes{0.2}{2015-11-30}{new}
+%\changes{0.4}{2015-12-03}{changed to use \cs{glsxtrshortpl}}
+%\changes{0.5}{2015-12-07}{changed to use \cs{glsxtrtitleshortpl}}
+%\changes{0.5}{2015-12-07}{renamed from \cs{glsentryfmtshortpl}}
+% \begin{macrocode}
+\newcommand*{\glsfmtshortpl}[1]{%
+ \glstexorpdfstring
+ {\glsxtrtitleshortpl{#1}}%
+ {\glsentryshortpl{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+% Use the expandable \cs{MFUsentencecase} in the PDF bookmark.
+%\begin{macro}{\Glsfmtshort}
+% Singular form (first letter uppercase).
+%\changes{0.2}{2015-11-30}{new}
+%\changes{0.4}{2015-12-03}{changed to use \cs{Glsxtrshort}}
+%\changes{0.5}{2015-12-07}{changed to use \cs{Glsxtrtitleshort}}
+%\changes{0.5}{2015-12-07}{renamed from \cs{Glsentryfmtshort}}
+%\changes{1.49}{2022-10-14}{added \cs{MFUsentencecase}}
+% \begin{macrocode}
+\newcommand*{\Glsfmtshort}[1]{%
+ \glstexorpdfstring
+ {\Glsxtrtitleshort{#1}}%
+ {\MFUsentencecase{\glsentryshort{#1}}}%
+}
+\glsmfuaddmap{\glsfmtshort}{\Glsfmtshort}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\Glsfmtshortpl}
+%Plural form (first letter uppercase).
+%\changes{0.2}{2015-11-30}{new}
+%\changes{0.4}{2015-12-03}{changed to use \cs{glsxtrshortpl}}
+%\changes{0.5}{2015-12-07}{changed to use \cs{Glsxtrtitleshortpl}}
+%\changes{0.5}{2015-12-07}{renamed from \cs{Glsentryfmtshortpl}}
+%\changes{1.49}{2022-10-14}{added \cs{MFUsentencecase}}
+% \begin{macrocode}
+\newcommand*{\Glsfmtshortpl}[1]{%
+ \glstexorpdfstring
+ {\Glsxtrtitleshortpl{#1}}%
+ {\MFUsentencecase{\glsentryshortpl{#1}}}%
+}
+\glsmfuaddmap{\glsfmtshortpl}{\Glsfmtshortpl}
+% \end{macrocode}
+%\end{macro}
+%
+% Similarly for all-caps.
+%\begin{macro}{\GLSfmtshort}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\GLSfmtshort}[1]{%
+ \glstexorpdfstring
+ {\GLSxtrtitleshort{#1}}%
+ {\GLSxtrusefield{#1}{short}}%
+}
+\glsmfublocker{\GLSfmtshort}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSfmtshortpl}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\GLSfmtshortpl}[1]{%
+ \glstexorpdfstring
+ {\GLSxtrtitleshortpl{#1}}%
+ {\GLSxtrusefield{#1}{shortpl}}%
+}
+\glsmfublocker{\GLSfmtshortpl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsfmtname}
+%As above but for the \gloskey{name} value.
+%\changes{1.21}{2017-11-03}{new}
+% \begin{macrocode}
+\newcommand*{\glsfmtname}[1]{%
+ \glstexorpdfstring
+ {\glsxtrtitlename{#1}}%
+ {\glsentryname{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsfmtname}
+%First letter converted to upper case.
+%\changes{1.21}{2017-11-03}{new}
+%\changes{1.49}{2022-10-14}{added \cs{MFUsentencecase}}
+% \begin{macrocode}
+\newcommand*{\Glsfmtname}[1]{%
+ \glstexorpdfstring
+ {\Glsxtrtitlename{#1}}%
+ {\MFUsentencecase{\glsentryname{#1}}}%
+}
+\glsmfuaddmap{\glsfmtname}{\Glsfmtname}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSfmtname}
+%All upper case.
+%\changes{1.42}{2020-02-03}{new}
+% \begin{macrocode}
+\newcommand*{\GLSfmtname}[1]{%
+ \glstexorpdfstring
+ {\GLSxtrtitlename{#1}}%
+ {\GLSxtrusefield{#1}{name}}%
+}
+\glsmfublocker{\GLSfmtname}
+% \end{macrocode}
+%\end{macro}
+%
+%
+%\begin{macro}{\glsfmttext}
+%As above but for the \gloskey{text} value.
+%\changes{0.5}{2015-12-07}{new}
+% \begin{macrocode}
+\newcommand*{\glsfmttext}[1]{%
+ \glstexorpdfstring
+ {\glsxtrtitletext{#1}}%
+ {\glsentrytext{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsfmttext}
+%First letter converted to upper case.
+%\changes{0.5}{2015-12-07}{new}
+%\changes{1.49}{2022-10-14}{added \cs{MFUsentencecase}}
+% \begin{macrocode}
+\newcommand*{\Glsfmttext}[1]{%
+ \glstexorpdfstring
+ {\Glsxtrtitletext{#1}}%
+ {\MFUsentencecase{\glsentrytext{#1}}}%
+}
+\glsmfuaddmap{\glsfmttext}{\Glsfmttext}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSfmttext}
+%All upper case.
+%\changes{1.42}{2020-02-03}{new}
+% \begin{macrocode}
+\newcommand*{\GLSfmttext}[1]{%
+ \glstexorpdfstring
+ {\GLSxtrtitletext{#1}}%
+ {\GLSxtrusefield{#1}{text}}%
+}
+\glsmfublocker{\GLSfmttext}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsfmtplural}
+%As above but for the \gloskey{plural} value.
+%\changes{0.5}{2015-12-07}{new}
+% \begin{macrocode}
+\newcommand*{\glsfmtplural}[1]{%
+ \glstexorpdfstring
+ {\glsxtrtitleplural{#1}}%
+ {\glsentryplural{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsfmtplural}
+%First letter converted to upper case.
+%\changes{0.5}{2015-12-07}{new}
+%\changes{1.49}{2022-10-14}{added \cs{MFUsentencecase}}
+% \begin{macrocode}
+\newcommand*{\Glsfmtplural}[1]{%
+ \glstexorpdfstring
+ {\Glsxtrtitleplural{#1}}%
+ {\MFUsentencecase{\glsentryplural{#1}}}%
+}
+\glsmfuaddmap{\glsfmtplural}{\Glsfmtplural}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSfmtplural}
+%All upper case.
+%\changes{1.42}{2020-02-03}{new}
+% \begin{macrocode}
+\newcommand*{\GLSfmtplural}[1]{%
+ \glstexorpdfstring
+ {\GLSxtrtitleplural{#1}}%
+ {\GLSxtrusefield{#1}{plural}}%
+}
+\glsmfublocker{\GLSfmtplural}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsfmtfirst}
+%As above but for the \gloskey{first} value.
+%\changes{0.5}{2015-12-07}{new}
+% \begin{macrocode}
+\newcommand*{\glsfmtfirst}[1]{%
+ \glstexorpdfstring
+ {\glsxtrtitlefirst{#1}}%
+ {\glsentryfirst{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsfmtfirst}
+%First letter converted to upper case.
+%\changes{0.5}{2015-12-07}{new}
+%\changes{1.49}{2022-10-14}{added \cs{MFUsentencecase}}
+% \begin{macrocode}
+\newcommand*{\Glsfmtfirst}[1]{%
+ \glstexorpdfstring
+ {\Glsxtrtitlefirst{#1}}%
+ {\MFUsentencecase{\glsentryfirst{#1}}}%
+}
+\glsmfuaddmap{\glsfmtfirst}{\Glsfmtfirst}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSfmtfirst}
+%All upper case.
+%\changes{1.42}{2020-02-03}{new}
+% \begin{macrocode}
+\newcommand*{\GLSfmtfirst}[1]{%
+ \glstexorpdfstring
+ {\GLSxtrtitlefirst{#1}}%
+ {\GLSxtrusefield{#1}{first}}%
+}
+\glsmfublocker{\GLSfmtfirst}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsfmtfirstpl}
+%As above but for the \gloskey{firstplural} value.
+%\changes{0.5}{2015-12-07}{new}
+% \begin{macrocode}
+\newcommand*{\glsfmtfirstpl}[1]{%
+ \glstexorpdfstring
+ {\glsxtrtitlefirstplural{#1}}%
+ {\GLSxtrusefield{#1}{firstpl}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsfmtfirstpl}
+%First letter converted to upper case.
+%\changes{0.5}{2015-12-07}{new}
+%\changes{1.49}{2022-10-14}{added \cs{MFUsentencecase}}
+% \begin{macrocode}
+\newcommand*{\Glsfmtfirstpl}[1]{%
+ \glstexorpdfstring
+ {\Glsxtrtitlefirstplural{#1}}%
+ {\MFUsentencecase{\glsentryfirstplural{#1}}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSfmtfirstpl}
+%All upper case.
+%\changes{1.42}{2020-02-03}{new}
+% \begin{macrocode}
+\newcommand*{\GLSfmtfirstpl}[1]{%
+ \glstexorpdfstring
+ {\GLSxtrtitlefirstplural{#1}}%
+ {\GLSxtrusefield{#1}{firstpl}}%
+}
+\glsmfublocker{\GLSfmtfirstpl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsfmtlong}
+%As above but for the \gloskey{long} value.
+%\changes{1.02}{2016-04-25}{new}
+% \begin{macrocode}
+\newcommand*{\glsfmtlong}[1]{%
+ \glstexorpdfstring
+ {\glsxtrtitlelong{#1}}%
+ {\glsentrylong{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsfmtlong}
+%First letter converted to upper case.
+%\changes{1.02}{2016-04-25}{new}
+%\changes{1.49}{2022-10-14}{added \cs{MFUsentencecase}}
+% \begin{macrocode}
+\newcommand*{\Glsfmtlong}[1]{%
+ \glstexorpdfstring
+ {\Glsxtrtitlelong{#1}}%
+ {\MFUsentencecase{\glsentrylong{#1}}}%
+}
+\glsmfuaddmap{\glsfmtlong}{\Glsfmtlong}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSfmtlong}
+%All upper case.
+%\changes{1.42}{2020-02-03}{new}
+% \begin{macrocode}
+\newcommand*{\GLSfmtlong}[1]{%
+ \glstexorpdfstring
+ {\GLSxtrtitlelong{#1}}%
+ {\GLSxtrusefield{#1}{long}}%
+}
+\glsmfublocker{\GLSfmtlong}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsfmtlongpl}
+%As above but for the \gloskey{longplural} value.
+%\changes{1.02}{2016-04-25}{new}
+% \begin{macrocode}
+\newcommand*{\glsfmtlongpl}[1]{%
+ \glstexorpdfstring
+ {\glsxtrtitlelongpl{#1}}%
+ {\glsentrylongpl{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsfmtlongpl}
+%First letter converted to upper case.
+%\changes{1.02}{2016-04-25}{new}
+%\changes{1.49}{2022-10-14}{added \cs{MFUsentencecase}}
+% \begin{macrocode}
+\newcommand*{\Glsfmtlongpl}[1]{%
+ \glstexorpdfstring
+ {\Glsxtrtitlelongpl{#1}}%
+ {\MFUsentencecase{\glsentrylongpl{#1}}}%
+}
+\glsmfuaddmap{\glsfmtlongpl}{\Glsfmtlongpl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSfmtlongpl}
+%All upper case.
+%\changes{1.42}{2020-02-03}{new}
+% \begin{macrocode}
+\newcommand*{\GLSfmtlongpl}[1]{%
+ \glstexorpdfstring
+ {\GLSxtrtitlelongpl{#1}}%
+ {\GLSxtrusefield{#1}{longpl}}%
+}
+\glsmfublocker{\GLSfmtlongpl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glspdffmtfull}
+%\changes{1.42}{2020-02-03}{new}
+%Can't use \cs{glsxtrinlinefullformat} in PDF bookmarks as it's not
+%fully expandable. This command is for the PDF part of
+%\cs{texorpdfstring} for the full form.
+% \begin{macrocode}
+\newcommand*{\glspdffmtfull}[1]{\glsentrylong{#1} (\glsentryshort{#1})}%
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\glspdffmtfullpl}
+%\changes{1.42}{2020-02-03}{new}
+%Likewise for plural.
+% \begin{macrocode}
+\newcommand*{\glspdffmtfullpl}[1]{\glsentrylongpl{#1} (\glsentryshortpl{#1})}%
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\glsfmtfull}
+%In-line full format.
+%\changes{1.02}{2016-04-25}{new}
+%\changes{1.42}{2020-02-03}{switched pdf case to use \cs{glspdffmtfull}}
+% \begin{macrocode}
+\newcommand*{\glsfmtfull}[1]{%
+ \glstexorpdfstring
+ {\glsxtrtitlefull{#1}}%
+ {\glspdffmtfull{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsfmtfull}
+%First letter converted to upper case.
+%\changes{1.02}{2016-04-25}{new}
+%\changes{1.42}{2020-02-03}{switched pdf case to use \cs{glspdffmtfull}}
+%\changes{1.49}{2022-10-14}{added \cs{MFUsentencecase}}
+% \begin{macrocode}
+\newcommand*{\Glsfmtfull}[1]{%
+ \glstexorpdfstring
+ {\Glsxtrtitlefull{#1}}%
+ {\MFUsentencecase{\glspdffmtfull{#1}{}}}%
+}
+\glsmfuaddmap{\glsfmtfull}{\Glsfmtfull}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSfmtfull}
+%All upper case. This explicitly uses \cs{text\_uppercase:n} in case
+%an old version of \sty{glossaries} or \sty{mfirstuc} is present.
+%\changes{1.42}{2020-02-03}{new}
+%\changes{1.49}{2022-10-14}{add upper case bookmark}
+% \begin{macrocode}
+\ExplSyntaxOn
+\newcommand*{\GLSfmtfull}[1]{%
+ \glstexorpdfstring
+ {\GLSxtrtitlefull{#1}}%
+ {\text_uppercase:n{\glspdffmtfull{#1}}}%
+}
+\ExplSyntaxOff
+\glsmfublocker{\GLSfmtfull}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsfmtfullpl}
+%In-line full plural format.
+%\changes{1.02}{2016-04-25}{new}
+%\changes{1.42}{2020-02-03}{switched pdf case to use \cs{glspdffmtfullpl}}
+% \begin{macrocode}
+\newcommand*{\glsfmtfullpl}[1]{%
+ \glstexorpdfstring
+ {\glsxtrtitlefullpl{#1}}%
+ {\glspdffmtfullpl{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsfmtfullpl}
+%First letter converted to upper case.
+%\changes{1.02}{2016-04-25}{new}
+%\changes{1.42}{2020-02-03}{switched pdf case to use \cs{glspdffmtfullpl}}
+%\changes{1.49}{2022-10-14}{added \cs{MFUsentencecase}}
+% \begin{macrocode}
+\newcommand*{\Glsfmtfullpl}[1]{%
+ \glstexorpdfstring
+ {\Glsxtrtitlefullpl{#1}}%
+ {\MFUsentencecase{\glspdffmtfullpl{#1}{}}}%
+}
+\glsmfuaddmap{\glsfmtfullpl}{\Glsfmtfullpl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSfmtfullpl}
+%All upper case. This explicitly uses \cs{text\_uppercase:n} in case
+%an old version of \sty{glossaries} or \sty{mfirstuc} is present.
+%\changes{1.42}{2020-02-03}{new}
+%\changes{1.49}{2022-10-14}{add upper case bookmark}
+% \begin{macrocode}
+\ExplSyntaxOn
+\newcommand*{\GLSfmtfullpl}[1]{%
+ \glstexorpdfstring
+ {\GLSxtrtitlefullpl{#1}}%
+ {\text_uppercase:n{\glspdffmtfullpl{#1}{}}}%
+}
+\ExplSyntaxOff
+\glsmfublocker{\GLSfmtfullpl}
+% \end{macrocode}
+%\end{macro}
+%
+%\subsection{Prefixes}
+%Provide support for \sty{glossaries-prefix}.
+%
+%\begin{macro}{\pglsprefix}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{pglsprefix}\marg{entry-label}\marg{prefix-field}
+%\end{definition}
+%A shortcut way of inserting the prefix and separator if they are
+%required. If this needs to be redefined, use \cs{ifglsfieldvoid}
+%for an expandable test.
+% \begin{macrocode}
+\newcommand{\pglsprefix}[2]{%
+ \ifcsempty{glo@\glsdetoklabel{#1}@#2}{}%
+ {\csuse{glo@\glsdetoklabel{#1}@#2}\glsprefixsep}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Pglsprefix}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{Pglsprefix}\marg{entry-label}\marg{prefix-field}
+%\end{definition}
+%Similar to \cs{pglsprefix} but sentence case. The conditional is
+%omitted as it will have to already be checked.
+% \begin{macrocode}
+\newcommand{\Pglsprefix}[2]{%
+ \Glsxtrusefield{#1}{#2}\glsprefixsep
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\PGLSprefix}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{PGLSprefix}\marg{entry-label}\marg{prefix-field}
+%\end{definition}
+%As \cs{pglsprefix} but all caps.
+% \begin{macrocode}
+\newcommand{\PGLSprefix}[2]{%
+ \ifcsempty{glo@\glsdetoklabel{#1}@#2}{}%
+ {\glsuppercase{\csuse{glo@\glsdetoklabel{#1}@#2}\glsprefixsep}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%Abbreviations. Short form uses prefix and prefixplural fields.
+%\begin{macro}{\pglsxtrshort}
+%\changes{1.49}{2022-10-14}{new}
+%No case-change.
+% \begin{macrocode}
+\newrobustcmd*{\pglsxtrshort}{\@gls@hyp@opt\ns@pglsxtrshort}
+\newcommand*{\ns@pglsxtrshort}[2][]{%
+ \new@ifnextchar[{\@pglsxtrshort{#1}{#2}}{\@pglsxtrshort{#1}{#2}[]}%
+}
+\def\@pglsxtrshort#1#2[#3]{%
+ \pglsprefix{#2}{prefix}%
+ \@glsxtrshort{#1}{#2}[#3]%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Pglsxtrshort}
+%\changes{1.49}{2022-10-14}{new}
+%Sentence case.
+% \begin{macrocode}
+\newrobustcmd*{\Pglsxtrshort}{\@gls@hyp@opt\ns@Pglsxtrshort}
+\newcommand*{\ns@Pglsxtrshort}[2][]{%
+ \new@ifnextchar[{\@Pglsxtrshort{#1}{#2}}{\@Pglsxtrshort{#1}{#2}[]}%
+}
+\def\@Pglsxtrshort#1#2[#3]{%
+ \ifglshasprefix{#2}%
+ {%
+ \Pglsprefix{#2}{prefix}%
+ \@glsxtrshort{#1}{#2}[#3]%
+ }%
+ {\@Glsxtrshort{#1}{#2}[#3]}%
+}
+\glsmfuaddmap{\pglsxtrshort}{\Pglsxtrshort}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\PGLSxtrshort}
+%\changes{1.49}{2022-10-14}{new}
+%All-caps is also fairly simple.
+% \begin{macrocode}
+\newrobustcmd*{\PGLSxtrshort}{\@gls@hyp@opt\ns@PGLSxtrshort}
+\newcommand*{\ns@PGLSxtrshort}[2][]{%
+ \new@ifnextchar[{\@PGLSxtrshort{#1}{#2}}{\@PGLSxtrshort{#1}{#2}[]}%
+}
+\def\@PGLSxtrshort#1#2[#3]{%
+ \PGLSprefix{#2}{prefix}%
+ \@GLSxtrshort{#1}{#2}[#3]%
+}
+\glsmfublocker{\PGLSxtrshort}
+% \end{macrocode}
+%\end{macro}
+%
+%Short plural.
+%\begin{macro}{\pglsxtrshortpl}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newrobustcmd*{\pglsxtrshortpl}{\@gls@hyp@opt\ns@pglsxtrshortpl}
+\newcommand*{\ns@pglsxtrshortpl}[2][]{%
+ \new@ifnextchar[{\@pglsxtrshortpl{#1}{#2}}{\@pglsxtrshortpl{#1}{#2}[]}%
+}
+\def\@pglsxtrshortpl#1#2[#3]{%
+ \pglsprefix{#2}{prefixplural}%
+ \@glsxtrshortpl{#1}{#2}[#3]%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Pglsxtrshortpl}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newrobustcmd*{\Pglsxtrshortpl}{\@gls@hyp@opt\ns@Pglsxtrshortpl}
+\newcommand*{\ns@Pglsxtrshortpl}[2][]{%
+ \new@ifnextchar[{\@Pglsxtrshortpl{#1}{#2}}{\@Pglsxtrshortpl{#1}{#2}[]}%
+}
+\def\@Pglsxtrshortpl#1#2[#3]{%
+ \ifglshasprefixplural{#2}%
+ {%
+ \Pglsprefix{#2}{prefixplural}%
+ \@glsxtrshortpl{#1}{#2}[#3]%
+ }%
+ {\@Glsxtrshortpl{#1}{#2}[#3]}%
+}
+\glsmfuaddmap{\pglsxtrshortpl}{\Pglsxtrshortpl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\PGLSxtrshortpl}
+%\changes{1.49}{2022-10-14}{new}
+%All-caps is also fairly simple.
+% \begin{macrocode}
+\newrobustcmd*{\PGLSxtrshortpl}{\@gls@hyp@opt\ns@PGLSxtrshortpl}
+\newcommand*{\ns@PGLSxtrshortpl}[2][]{%
+ \new@ifnextchar[{\@PGLSxtrshortpl{#1}{#2}}{\@PGLSxtrshortpl{#1}{#2}[]}%
+}
+\def\@PGLSxtrshortpl#1#2[#3]{%
+ \PGLSprefix{#2}{prefixplural}%
+ \@GLSxtrshortpl{#1}{#2}[#3]%
+}
+\glsmfublocker{\PGLSxtrshortpl}
+% \end{macrocode}
+%\end{macro}
+%
+%Long form uses prefixfirst and prefixfirstplural fields.
+%\begin{macro}{\pglsxtrlong}
+%\changes{1.49}{2022-10-14}{new}
+%No case-change.
+% \begin{macrocode}
+\newrobustcmd*{\pglsxtrlong}{\@gls@hyp@opt\ns@pglsxtrlong}
+\newcommand*{\ns@pglsxtrlong}[2][]{%
+ \new@ifnextchar[{\@pglsxtrlong{#1}{#2}}{\@pglsxtrlong{#1}{#2}[]}%
+}
+\def\@pglsxtrlong#1#2[#3]{%
+ \pglsprefix{#2}{prefixfirst}%
+ \@glsxtrlong{#1}{#2}[#3]%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Pglsxtrlong}
+%\changes{1.49}{2022-10-14}{new}
+%Sentence case.
+% \begin{macrocode}
+\newrobustcmd*{\Pglsxtrlong}{\@gls@hyp@opt\ns@Pglsxtrlong}
+\newcommand*{\ns@Pglsxtrlong}[2][]{%
+ \new@ifnextchar[{\@Pglsxtrlong{#1}{#2}}{\@Pglsxtrlong{#1}{#2}[]}%
+}
+\def\@Pglsxtrlong#1#2[#3]{%
+ \ifglshasprefixfirst{#2}%
+ {%
+ \Pglsprefix{#2}{prefixfirst}%
+ \@glsxtrlong{#1}{#2}[#3]%
+ }%
+ {\@Glsxtrlong{#1}{#2}[#3]}%
+}
+\glsmfuaddmap{\pglsxtrlong}{\Pglsxtrlong}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\PGLSxtrlong}
+%\changes{1.49}{2022-10-14}{new}
+%All-caps is also fairly simple.
+% \begin{macrocode}
+\newrobustcmd*{\PGLSxtrlong}{\@gls@hyp@opt\ns@PGLSxtrlong}
+\newcommand*{\ns@PGLSxtrlong}[2][]{%
+ \new@ifnextchar[{\@PGLSxtrlong{#1}{#2}}{\@PGLSxtrlong{#1}{#2}[]}%
+}
+\def\@PGLSxtrlong#1#2[#3]{%
+ \PGLSprefix{#2}{prefixfirst}%
+ \@GLSxtrlong{#1}{#2}[#3]%
+}
+\glsmfublocker{\PGLSxtrlong}
+% \end{macrocode}
+%\end{macro}
+%
+%Long plural.
+%\begin{macro}{\pglsxtrlongpl}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newrobustcmd*{\pglsxtrlongpl}{\@gls@hyp@opt\ns@pglsxtrlongpl}
+\newcommand*{\ns@pglsxtrlongpl}[2][]{%
+ \new@ifnextchar[{\@pglsxtrlongpl{#1}{#2}}{\@pglsxtrlongpl{#1}{#2}[]}%
+}
+\def\@pglsxtrlongpl#1#2[#3]{%
+ \pglsprefix{#2}{prefixfirstplural}%
+ \@glsxtrlongpl{#1}{#2}[#3]%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Pglsxtrlongpl}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newrobustcmd*{\Pglsxtrlongpl}{\@gls@hyp@opt\ns@Pglsxtrlongpl}
+\newcommand*{\ns@Pglsxtrlongpl}[2][]{%
+ \new@ifnextchar[{\@Pglsxtrlongpl{#1}{#2}}{\@Pglsxtrlongpl{#1}{#2}[]}%
+}
+\def\@Pglsxtrlongpl#1#2[#3]{%
+ \ifglshasprefixfirstplural{#2}%
+ {%
+ \Pglsprefix{#2}{prefixfirstplural}%
+ \@glsxtrlongpl{#1}{#2}[#3]%
+ }%
+ {\@Glsxtrlongpl{#1}{#2}[#3]}%
+}
+\glsmfuaddmap{\pglsxtrlongpl}{\Pglsxtrlongpl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\PGLSxtrlongpl}
+%\changes{1.49}{2022-10-14}{new}
+%All-caps is also fairly simple.
+% \begin{macrocode}
+\newrobustcmd*{\PGLSxtrlongpl}{\@gls@hyp@opt\ns@PGLSxtrlongpl}
+\newcommand*{\ns@PGLSxtrlongpl}[2][]{%
+ \new@ifnextchar[{\@PGLSxtrlongpl{#1}{#2}}{\@PGLSxtrlongpl{#1}{#2}[]}%
+}
+\def\@PGLSxtrlongpl#1#2[#3]{%
+ \PGLSprefix{#2}{prefixfirstplural}%
+ \@GLSxtrlongpl{#1}{#2}[#3]%
+}
+\glsmfublocker{\PGLSxtrlongpl}
+% \end{macrocode}
+%\end{macro}
+%
+%Title commands (analogous to \cs{glsfmtshort} etc).
+%\begin{macro}{\pglsfmtshort}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\pglsfmtshort}[1]{%
+ \pglsprefix{#1}{prefix}%
+ \glsfmtshort{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Pglsfmtshort}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\Pglsfmtshort}[1]{%
+ \glstexorpdfstring
+ {\Pglsxtrtitleshort{#1}}%
+ {\MFUsentencecase{%
+ \pglsprefix{#1}{prefix}%
+ \glsentryshort{#1}}%
+ }%
+}
+\glsmfuaddmap{\pglsfmtshort}{\Pglsfmtshort}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Pglsxtrtitleshort}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newrobustcmd*{\Pglsxtrtitleshort}[1]{%
+ \glsxtr@title@field\Pglsxtrshort{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\PGLSfmtshort}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\PGLSfmtshort}[1]{%
+ \PGLSprefix{#1}{prefix}%
+ \GLSfmtshort{#1}%
+}
+\glsmfublocker{\PGLSfmtshort}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\pglsfmtshortpl}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\pglsfmtshortpl}[1]{%
+ \pglsprefix{#1}{prefixplural}%
+ \glsfmtshortpl{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Pglsfmtshortpl}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\Pglsfmtshortpl}[1]{%
+ \glstexorpdfstring
+ {\Pglsxtrtitleshortpl{#1}}%
+ {\MFUsentencecase
+ {%
+ \pglsprefix{#1}{prefixplural}%
+ \glsentryshortpl{#1}%
+ }%
+ }%
+}
+\glsmfuaddmap{\pglsfmtshortpl}{\Pglsfmtshortpl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Pglsxtrtitleshortpl}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newrobustcmd*{\Pglsxtrtitleshortpl}[1]{%
+ \glsxtr@title@field\Pglsxtrshortpl{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\PGLSfmtshortpl}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\PGLSfmtshortpl}[1]{%
+ \PGLSprefix{#1}{prefixplural}%
+ \GLSfmtshortpl{#1}%
+}
+\glsmfublocker{\PGLSfmtshortpl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\pglsfmtlong}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\pglsfmtlong}[1]{%
+ \pglsprefix{#1}{prefixfirst}%
+ \glsfmtlong{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Pglsfmtlong}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\Pglsfmtlong}[1]{%
+ \glstexorpdfstring
+ {\Pglsxtrtitlelong{#1}}%
+ {\MFUsentencecase{%
+ \pglsprefix{#1}{prefixfirst}%
+ \glsentrylong{#1}}%
+ }%
+}
+\glsmfuaddmap{\pglsfmtlong}{\Pglsfmtlong}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Pglsxtrtitlelong}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newrobustcmd*{\Pglsxtrtitlelong}[1]{%
+ \glsxtr@title@field\Pglsxtrlong{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\PGLSfmtlong}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\PGLSfmtlong}[1]{%
+ \PGLSprefix{#1}{prefixfirst}%
+ \GLSfmtlong{#1}%
+}
+\glsmfublocker{\PGLSfmtlong}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\pglsfmtlongpl}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\pglsfmtlongpl}[1]{%
+ \pglsprefix{#1}{prefixfirstplural}%
+ \glsfmtlongpl{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Pglsfmtlongpl}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\Pglsfmtlongpl}[1]{%
+ \glstexorpdfstring
+ {\Pglsxtrtitlelongpl{#1}}%
+ {\MFUsentencecase
+ {%
+ \pglsprefix{#1}{prefixfirstplural}%
+ \glsentrylongpl{#1}%
+ }%
+ }%
+}
+\glsmfuaddmap{\pglsfmtlongpl}{\Pglsfmtlongpl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Pglsxtrtitlelongpl}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newrobustcmd*{\Pglsxtrtitlelongpl}[1]{%
+ \glsxtr@title@field\Pglsxtrlongpl{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\PGLSfmtlongpl}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\PGLSfmtlongpl}[1]{%
+ \PGLSprefix{#1}{prefixfirstplural}%
+ \GLSfmtlongpl{#1}%
+}
+\glsmfublocker{\PGLSfmtlongpl}
+% \end{macrocode}
+%\end{macro}
+%
+%\subsection{Multi (Combined/Compound) Entries}
+%(I'd rather call these combined or compound entries but \cs{cgls} is
+%already taken.)
+%
+%New to version 1.48, the commands here provide a way of referencing
+%multiple entries as a single unit. For example, biological
+%organisms are often referred to by their genus and species, such as
+%\emph{Clostridium botulinum} and \emph{Clostridium perfringens}
+%(where the genus is Clostridium). The genus is often abbreviated
+%after first use, regardless of which species in the genus is being
+%referenced. For example, \qt{\emph{Clostridium botulinum} and
+%\emph{C. perfringens}}. This can't be supported by any abbreviation
+%styles unless the genus and species names are defined separately.
+%For example:
+%\begin{verbatim}
+%\setabbreviationstyle{long-only-short-only}
+%\newabbreviation{clostridium}{C.}{Clostridium}
+%\newglossaryentry{botulinum}{name={botulinum},description={}}
+%\newglossaryentry{perfringens}{name={perfringens},description={}}
+%\end{verbatim}
+%This means that the entries then need to be referenced using a
+%rather cumbersome method:
+%\begin{verbatim}
+%\gls{clostridium} \gls{botulinum} and \gls{clostridum}
+%\gls{perfringens}
+%\end{verbatim}
+%This section provides a command that will provide a way of defining
+%a label that represents a combination of entries (which must all be
+%first defined). For example:
+%\begin{verbatim}
+%\multiglossaryentry{cbot}{clostridium,botulinum}
+%\end{verbatim}
+%This label can then be referenced using \cs{mgls}, which internally
+%uses \cs{gls} for each component. The last component in the list is
+%considered the \qt{main} component (not to be confused with the
+%main glossary). If this isn't the case, the label of the main
+%component should be added in the optional argument before the label
+%list. Note that the multi-label (\texttt{cbot} in this case) can't be
+%referenced using commands like \cs{gls}.
+%
+%First define the general set of options that should be applied to
+%all multi-entries. These can be set with:
+%\begin{macro}{\multiglossaryentrysetup}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\multiglossaryentrysetup}[1]{\setkeys{glsxtrcombined}{#1}}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\@gls@combined@indexmain}
+%\changes{1.48}{2021-11-22}{new}
+%Numeric value: 0=false (don't index main component), 1=true (always
+%index main component), 2=first (only index main component on first
+%use). Default: 1 (true);
+% \begin{macrocode}
+\newcommand*{\@gls@combined@indexmain}{1}
+\define@choicekey{glsxtrcombined}{indexmain}%
+ [\@gls@combined@indexmain@val\@gls@combined@indexmain]
+ {false,true,first}[true]{}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\@gls@combined@indexothers}
+%\changes{1.48}{2021-11-22}{new}
+%Numeric value: 0=false (don't index other components), 1=true (always
+%index other components), 2=first (only index other components on first
+%use). Default: 2 (first);
+% \begin{macrocode}
+\newcommand*{\@gls@combined@indexothers}{2}
+\define@choicekey{glsxtrcombined}{indexothers}%
+ [\@gls@combined@indexothers@val\@gls@combined@indexothers]
+ {false,true,first}[true]{}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\@gls@combined@hyper}
+%\changes{1.48}{2021-11-22}{new}
+%Numeric value: 0=none (\cs{mgls} doesn't create a hyperlink),
+% 1=allmain (all content hyperlinks to the main component),
+% 2=mainonly (only the main component has a hyperlink),
+% 3=individual (each component has a hyperlink to their own target).
+% Default: 3.
+% \begin{macrocode}
+\newcommand*{\@gls@combined@hyper}{3}
+\define@choicekey{glsxtrcombined}{hyper}%
+ [\@gls@combined@hyper@val\@gls@combined@hyper]
+ {none,allmain,mainonly,individual,otheronly,notmainfirst,nototherfirst,notfirst}{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@combined@encapmain}
+%\changes{1.48}{2021-11-22}{new}
+%Location encap value for main component (corresponding to format key in \cs{gls}).
+% \begin{macrocode}
+\newcommand*{\@gls@combined@encapmain}{glsnumberformat}
+\define@key{glsxtrcombined}{encapmain}{%
+ \renewcommand*{\@gls@combined@encapmain}{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@combined@encapothers}
+%\changes{1.48}{2021-11-22}{new}
+%Location encap value for other components (corresponding to format key in \cs{gls}).
+% \begin{macrocode}
+\newcommand*{\@gls@combined@encapothers}{glsnumberformat}
+\define@key{glsxtrcombined}{encapothers}{%
+ \renewcommand*{\@gls@combined@encapothers}{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@combined@textformat}
+%\changes{1.48}{2021-11-22}{new}
+%Encapsulate entire content with the command identified by the given
+%control sequence name.
+% \begin{macrocode}
+\newcommand*{\@gls@combined@textformat}{@firstofone}
+\define@key{glsxtrcombined}{textformat}{%
+ \renewcommand*{\@gls@combined@textformat}{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@combined@category}
+%\changes{1.48}{2021-11-22}{new}
+%Assign a category to the combined set.
+% \begin{macrocode}
+\newcommand*{\@gls@combined@category}{}
+\define@key{glsxtrcombined}{category}{%
+ \renewcommand*{\@gls@combined@category}{#1}%
+}
+% \end{macrocode}
+%Pre-options family:
+% \begin{macrocode}
+\define@key{glsxtrcombinedpreopts}{category}{%
+ \renewcommand*{\@gls@combined@category}{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@combined@mglsopts}
+%\changes{1.48}{2021-11-22}{new}
+%Default options to pass to \cs{mgls}.
+% \begin{macrocode}
+\newcommand*{\@gls@combined@mglsopts}{}
+\define@key{glsxtrcombined}{mglsopts}{%
+ \renewcommand*{\@gls@combined@mglsopts}{#1}%
+}
+\define@key{glsxtrcombinedpreopts}{mglsopts}{%
+ \@gls@combined@mglsopts@do
+ {%
+ \renewcommand*{\@gls@combined@mglsopts}{#1}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@combined@mglsopts@do}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@gls@combined@mglsopts@do}[1]{#1}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mgls@disable@mglsopts}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\mgls@disable@mglsopts}{%
+ \let\@gls@combined@mglsopts@do\@gls@combined@mglsopts@do@not
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mgls@enable@mglsopts}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\mgls@enable@mglsopts}{%
+ \let\@gls@combined@mglsopts@do\@firstofone
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@combined@mglsopts@do}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@gls@combined@mglsopts@do@not}[1]{%
+ \PackageError{glossaries-extra}{`mglsopts' key not permitted inside
+ `setup' value}{}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@combined@firstprefix}
+%\changes{1.48}{2021-11-22}{new}
+%Prefix for multi-entry first use.
+% \begin{macrocode}
+\newcommand*{\@gls@combined@firstprefix}{}
+\define@key{glsxtrcombined}{firstprefix}{%
+ \renewcommand*{\@gls@combined@firstprefix}{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@combined@usedprefix}
+%\changes{1.48}{2021-11-22}{new}
+%Prefix for multi-entry subsequent first use.
+% \begin{macrocode}
+\newcommand*{\@gls@combined@usedprefix}{}
+\define@key{glsxtrcombined}{usedprefix}{%
+ \renewcommand*{\@gls@combined@usedprefix}{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@combined@firstsuffix}
+%\changes{1.48}{2021-11-22}{new}
+%Suffix for multi-entry first use.
+% \begin{macrocode}
+\newcommand*{\@gls@combined@firstsuffix}{}
+\define@key{glsxtrcombined}{firstsuffix}{%
+ \renewcommand*{\@gls@combined@firstsuffix}{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@combined@usedsuffix}
+%\changes{1.48}{2021-11-22}{new}
+%Suffix for multi-entry subsequent first use.
+% \begin{macrocode}
+\newcommand*{\@gls@combined@usedsuffix}{}
+\define@key{glsxtrcombined}{usedsuffix}{%
+ \renewcommand*{\@gls@combined@usedsuffix}{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@combined@firstskipmain}
+%\changes{1.48}{2021-11-22}{new}
+%Skip the main element on first use (multi-entry first use not
+%element first use).
+% \begin{macrocode}
+\define@boolkey{glsxtrcombined}{firstskipmain}[true]{}
+\KV@glsxtrcombined@firstskipmainfalse
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@combined@firstskipothers}
+%\changes{1.48}{2021-11-22}{new}
+%Skip the other elements on first use (multi-entry first use not
+%element first use).
+% \begin{macrocode}
+\define@boolkey{glsxtrcombined}{firstskipothers}[true]{}
+\KV@glsxtrcombined@firstskipothersfalse
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@combined@usedskipmain}
+%\changes{1.48}{2021-11-22}{new}
+%Skip the main element on subsequent use (multi-entry subsequent use not
+%element subsequent use).
+% \begin{macrocode}
+\define@boolkey{glsxtrcombined}{usedskipmain}[true]{}
+\KV@glsxtrcombined@usedskipmainfalse
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@combined@usedskipothers}
+%\changes{1.48}{2021-11-22}{new}
+%Skip the other elements on subsequent use (multi-entry subsequent use not
+%element subsequent use).
+% \begin{macrocode}
+\define@boolkey{glsxtrcombined}{usedskipothers}[true]{}
+\KV@glsxtrcombined@usedskipothersfalse
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@combined@postlinks}
+%\changes{1.48}{2021-11-22}{new}
+%Determine whether or not to use the individual element post-link hooks.
+% \begin{macrocode}
+\newcommand*{\@gls@combined@postlinks@nr}{0}
+\define@choicekey{glsxtrcombined}{postlinks}%
+ [\@gls@combined@postlinks@val\@gls@combined@postlinks@nr]
+ {none,all,notlast,mainnotlast,mainonly,othernotlast,otheronly}{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@combined@mpostlink}
+%\changes{1.48}{2021-11-22}{new}
+%Determine whether or not to use the multi-entry post-link hook.
+% \begin{macrocode}
+\newcommand*{\@gls@combined@mpostlink@nr}{1}
+\define@choicekey{glsxtrcombined}{mpostlink}%
+ [\@gls@combined@mpostlink@val\@gls@combined@mpostlink@nr]
+ {false,true,firstonly,usedonly}[true]{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@gls@combined@mpostlinkelement}
+%\changes{1.48}{2021-11-22}{new}
+%Determine which element to use for the post-link hook.
+% \begin{macrocode}
+\newcommand*{\@gls@combined@mpostlinkelement@nr}{0}
+\define@choicekey{glsxtrcombined}{mpostlinkelement}%
+ [\@gls@combined@mpostlinkelement@val\@gls@combined@mpostlinkelement@nr]
+ {last,main,custom}{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrifmulti}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrifmulti}[3]{\ifcsdef{@gls@combined@#1@main}{#2}{#3}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrmultimain}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrmultimain}[1]{\csuse{@gls@combined@#1@main}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrmultilist}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrmultilist}[1]{\csuse{@gls@combined@#1@list}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrmultitotalelements}
+%\changes{1.48}{2021-11-22}{new}
+%Total number of elements.
+% \begin{macrocode}
+\newcommand*{\glsxtrmultitotalelements}[1]{\csuse{@gls@combined@#1@total}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrmultimainindex}
+%\changes{1.48}{2021-11-22}{new}
+%Index of main element (starting from 1). If the main element is the
+%last element in the list then this should equal the total number of
+%elements.
+% \begin{macrocode}
+\newcommand*{\glsxtrmultimainindex}[1]{\csuse{@gls@combined@#1@mainindex}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrmultilastotherindex}
+%\changes{1.48}{2021-11-22}{new}
+%Index of the last non-main element.
+% \begin{macrocode}
+\newcommand*{\glsxtrmultilastotherindex}[1]{\csuse{@gls@combined@#1@lastotherindex}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\ifmultiglossaryentryglobal}
+%\changes{1.48}{2021-11-22}{new}
+%Make definitions global.
+% \begin{macrocode}
+\newif\ifmultiglossaryentryglobal
+\multiglossaryentryglobalfalse
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglselementindex}
+%\changes{1.48}{2021-11-22}{new}
+% Count register to keep track of the current element index.
+% \begin{macrocode}
+\newcount\mglselementindex
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\multiglossaryentry}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{multiglossaryentry}\oarg{options}\marg{multi-label}\oarg{main label}\marg{label
+%list}
+%\end{definition}
+%Defines the label \meta{multi-label} that can be used in \cs{mgls}.
+% \begin{macrocode}
+\newrobustcmd{\multiglossaryentry}[1][]{%
+ \def\@gls@combined@current@opts{#1}%
+ \ifnum\@glsxtr@docdefval=1\relax
+ \let\@multi@glossentry@donext\@defmultiglossaryentry
+ \else
+ \let\@multi@glossentry@donext\@multiglossaryentry
+ \fi
+ \@multi@glossentry@donext
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@multiglossaryentry}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@multiglossaryentry}[1]{%
+ \def\@gls@combined@current@label{#1}%
+ \@multi@glossaryentry
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@multi@glossaryentry}
+%\changes{1.48}{2021-11-22}{new}
+% Check for existence.
+% \begin{macrocode}
+\newcommand*{\@multi@glossaryentry}[2][]{%
+ \ifcsdef{@gls@combined@\@gls@combined@current@label @main}%
+ {\PackageError{glossaries-extra}%
+ {Multi-entry label `\@gls@combined@current@label' already defined}%
+ {}%
+ }%
+ {%
+ \@multi@glossary@entry{#1}{#2}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@defmultiglossaryentry}
+%\changes{1.48}{2021-11-22}{new}
+%Used if document definitions are on.
+% \begin{macrocode}
+\newcommand*{\@defmultiglossaryentry}[1]{%
+ \def\@gls@combined@current@label{#1}%
+ \@def@multi@glossaryentry
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@def@multi@glossaryentry}
+%\changes{1.48}{2021-11-22}{new}
+%Used if document definitions are on.
+% \begin{macrocode}
+\newcommand*{\@def@multi@glossaryentry}[2][]{%
+ \let\@def@multi@glossaryentry@do\@multi@glossary@entry
+ \ifundef\@glsxtr@docdefs@multilist
+ {%
+ \gdef\@glsxtr@docdefs@multilist{}%
+ \listxadd
+ {\@glsxtr@docdefs@multilist}{\expandonce\@gls@combined@current@label}%
+ }%
+ {%
+ \xifinlist{\@gls@combined@current@label}{\@glsxtr@docdefs@multilist}%
+ {%
+ \PackageError{glossaries-extra}%
+ {Multi-entry label `\@gls@combined@current@label' already defined}%
+ {}%
+ \let\@def@multi@glossaryentry@do\@gobbletwo
+ }%
+ {%
+ \listxadd
+ {\@glsxtr@docdefs@multilist}{\expandonce\@gls@combined@current@label}%
+ }%
+ }%
+ \@def@multi@glossaryentry@do{#1}{#2}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@multi@glossary@doifexists}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@multi@glossary@doifexists}{\glsdoifexists}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\providemultiglossaryentry}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{providemultiglossaryentry}\oarg{options}\marg{multi-label}\oarg{main label}\marg{label
+%list}
+%\end{definition}
+%Defines a multi-entry unless it has already been defined.
+% \begin{macrocode}
+\newrobustcmd{\providemultiglossaryentry}[2][]{%
+ \def\@gls@combined@current@opts{#1}%
+ \def\@gls@combined@current@label{#2}%
+ \ifcsdef{@gls@combined@\@gls@combined@current@label @main}%
+ {\def\@multi@glossentry@donext{\@provide@multi@glossaryentry@noop}}%
+ {%
+ \ifnum\@glsxtr@docdefval=1\relax
+ \def\@multi@glossentry@donext{\@def@multi@glossaryentry}%
+ \else
+ \def\@multi@glossentry@donext{\@multi@glossaryentry}%
+ \fi
+ }%
+ \@multi@glossentry@donext
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@provide@multi@glossaryentry@noop}
+%\changes{1.48}{2021-11-22}{new}
+% Do nothing.
+% \begin{macrocode}
+\newcommand*{\@provide@multi@glossaryentry@noop}[2][]{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@multi@glossaryentry@list}
+%\changes{1.48}{2021-11-22}{new}
+% List of all defined multi-entry sets.
+% \begin{macrocode}
+\newcommand*{\@multi@glossaryentry@list}{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@multi@glossary@entry}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@multi@glossary@entry}[2]{%
+ \protected@edef\@gls@combined@current@main{#1}%
+% \end{macrocode}
+% Fully expand list.
+% \begin{macrocode}
+ \protected@edef\@gls@combined@currentlist{#2}%
+% \end{macrocode}
+% Count items in list, check they are all defined, and find last item at the same time.
+% \begin{macrocode}
+ \mglselementindex=0\relax
+ \@for\@gls@tmp:=\@gls@combined@currentlist\do{%
+ \advance\mglselementindex by 1\relax
+ \@multi@glossary@doifexists{\@gls@tmp}{}%
+ \let\@gls@combined@finalitem\@gls@tmp
+ \ifdefvoid\@gls@combined@current@main
+ {}%
+ {%
+ \ifx\@gls@combined@current@main\@gls@tmp
+ \ifmultiglossaryentryglobal
+ \global\cslet{@gls@combined@\@gls@combined@current@label @main}%
+ \@gls@combined@current@main
+ \csxdef{@gls@combined@\@gls@combined@current@label @mainindex}%
+ {\the\mglselementindex}%
+ \else
+ \cslet{@gls@combined@\@gls@combined@current@label @main}%
+ \@gls@combined@current@main
+ \csedef{@gls@combined@\@gls@combined@current@label @mainindex}%
+ {\the\mglselementindex}%
+ \fi
+ \else
+ \ifmultiglossaryentryglobal
+ \csxdef{@gls@combined@\@gls@combined@current@label @lastotherindex}%
+ {\the\mglselementindex}%
+ \else
+ \csedef{@gls@combined@\@gls@combined@current@label @lastotherindex}%
+ {\the\mglselementindex}%
+ \fi
+ \fi
+ }%
+ }%
+ \ifmultiglossaryentryglobal
+ \csxdef{@gls@combined@\@gls@combined@current@label @total}%
+ {\the\mglselementindex}%
+ \else
+ \csedef{@gls@combined@\@gls@combined@current@label @total}%
+ {\the\mglselementindex}%
+ \fi
+ \ifnum\mglselementindex<2\relax
+ \PackageError{glossaries-extra}{At least 2 labels required in
+ multi-entry element list (\number\mglselementindex\space found)}{}%
+ \else
+ \ifdefvoid\@gls@combined@current@main
+ {}%
+ {%
+% \end{macrocode}
+% If \cs{@gls@combined@\meta{label}@main} hasn't been set then it
+% wasn't included in the list.
+% \begin{macrocode}
+ \ifcsundef{@gls@combined@\@gls@combined@current@label @main}%
+ {\PackageError{glossaries-extra}%
+ {Main element `\@gls@combined@current@main' not found in list}%
+ {The final element `\@gls@combined@finalitem' will be used instead}
+% \end{macrocode}
+% Set to empty so that the default (final element) is used instead.
+% \begin{macrocode}
+ \let\@gls@combined@current@main\@empty
+ }%
+ {}%
+ }%
+ \ifdefvoid\@gls@combined@current@main
+ {%
+% \end{macrocode}
+% Set main to final element.
+% \begin{macrocode}
+ \ifmultiglossaryentryglobal
+ \global\cslet{@gls@combined@\@gls@combined@current@label @main}%
+ \@gls@combined@finalitem
+ \global\csletcs{@gls@combined@\@gls@combined@current@label @mainindex}%
+ {@gls@combined@\@gls@combined@current@label @total}%
+ \csxdef{@gls@combined@\@gls@combined@current@label @lastotherindex}%
+ {\the\numexpr\mglselementindex-1 }%
+ \else
+ \cslet{@gls@combined@\@gls@combined@current@label @main}%
+ \@gls@combined@finalitem
+ \csletcs{@gls@combined@\@gls@combined@current@label @mainindex}%
+ {@gls@combined@\@gls@combined@current@label @total}%
+ \csedef{@gls@combined@\@gls@combined@current@label @lastotherindex}%
+ {\the\numexpr\mglselementindex-1 }%
+ \fi
+ }%
+ {}%
+ \ifmultiglossaryentryglobal
+% \end{macrocode}
+% Globally define element list.
+% \begin{macrocode}
+ \global\cslet{@gls@combined@\@gls@combined@current@label @list}%
+ \@gls@combined@currentlist
+% \end{macrocode}
+% Globally define options.
+% \begin{macrocode}
+ \protected@csxdef{@gls@combined@\@gls@combined@current@label @options}%
+ {\@gls@combined@current@opts}%
+% \end{macrocode}
+% Global conditional definition.
+% \begin{macrocode}
+ \expandafter\@ifdefinable
+ \csname if@gls@combined@\@gls@combined@current@label @flag\endcsname
+ {\expandafter\global\expandafter
+ \newif\csname if@gls@combined@\@gls@combined@current@label @flag\endcsname}%
+ \expandafter\global
+ \csname @gls@combined@\@gls@combined@current@label @flagfalse\endcsname
+ \else
+% \end{macrocode}
+% Locally define element list.
+% \begin{macrocode}
+ \cslet{@gls@combined@\@gls@combined@current@label @list}%
+ \@gls@combined@currentlist
+% \end{macrocode}
+% Locally define options.
+% \begin{macrocode}
+ \protected@csedef{@gls@combined@\@gls@combined@current@label @options}%
+ {\@gls@combined@current@opts}%
+% \end{macrocode}
+% Local conditional definition.
+% \begin{macrocode}
+ \newboolean{@gls@combined@\@gls@combined@current@label @flag}%
+ \csname @gls@combined@\@gls@combined@current@label @flagfalse\endcsname
+ \fi
+ \fi
+ \writemultiglossentry
+ {\@gls@combined@current@opts}{\@gls@combined@current@label}%
+ {\csuse{@gls@combined@\@gls@combined@current@label @main}}{#2}%
+% \end{macrocode}
+%Append label to list.
+% \begin{macrocode}
+ \ifmultiglossaryentryglobal
+ \ifdefempty\@multi@glossaryentry@list
+ {\let\@multi@glossaryentry@list\@gls@combined@current@label}%
+ {%
+ \eappto\@multi@glossaryentry@list{,\expandonce\@gls@combined@current@label}%
+ }%
+ \else
+ \ifdefempty\@multi@glossaryentry@list
+ {\global\let\@multi@glossaryentry@list\@gls@combined@current@label}%
+ {%
+ \xappto\@multi@glossaryentry@list{,\expandonce\@gls@combined@current@label}%
+ }%
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsxtr@multientry}
+%\begin{definition}
+%\cs{@glsxtr@multientry}\marg{options}\marg{multilabel}\marg{main}\marg{list}
+%\end{definition}
+%Information for aux file. Useful for \app{bib2gls} and also for
+%\pkgopt{docdef}.
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@glsxtr@multientry}[4]{%
+ \ifnum\@glsxtr@docdefval=1\relax
+ \bgroup
+ \def\@gls@combined@current@opts{#1}%
+ \def\@gls@combined@current@label{#2}%
+ \let\@multi@glossary@doifexists\@secondoftwo
+ \let\writemultiglossentry\@gobblefour
+ \multiglossaryentryglobaltrue
+ \@multi@glossary@entry{#3}{#4}%
+ \egroup
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\writemultiglossentry}
+%\changes{1.48}{2021-11-22}{new}
+%This can be redefined to do nothing if the information isn't
+%required.
+% \begin{macrocode}
+\newcommand*{\writemultiglossentry}[4]{%
+ \protected@write\@auxout{}{\string\@glsxtr@multientry{#1}{#2}{#3}{#4}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\ifmglsused}
+%\changes{1.48}{2021-11-22}{new}
+% Determines whether or not the multi-entry set has been referenced
+% by commands like \cs{mgls} or \cs{mglsname}.
+% \begin{macrocode}
+\newcommand*{\ifmglsused}[3]{%
+ \ifbool{@gls@combined@#1@flag}{#2}{#3}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsunset}
+%\changes{1.48}{2021-11-22}{new}
+%Unset the flag.
+% \begin{macrocode}
+\newcommand*{\mglsunset}[1]{%
+ \gls@ifnotmeasuring
+ {%
+ \glsxtrifmulti{#1}{\@mglsunset{#1}}%
+ {%
+ \glsxtrundefaction{Multi entry `#1' hasn't been defined}%
+ {You need to define `#1' with \string\multiglossaryentry}%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@mglsunset}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@mglsunset}[1]{%
+ \expandafter\global\csname @gls@combined@#1@flagtrue\endcsname
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsreset}
+%\changes{1.48}{2021-11-22}{new}
+%Unset the flag.
+% \begin{macrocode}
+\newcommand*{\mglsreset}[1]{%
+ \gls@ifnotmeasuring
+ {%
+ \glsxtrifmulti{#1}{\@mglsreset{#1}}%
+ {%
+ \glsxtrundefaction{Multi entry `#1' hasn't been defined}%
+ {You need to define `#1' with \string\multiglossaryentry}%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@mglsreset}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@mglsreset}[1]{%
+ \expandafter\global\csname @gls@combined@#1@flagfalse\endcsname
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglslocalunset}
+%\changes{1.48}{2021-11-22}{new}
+%Unset the flag.
+% \begin{macrocode}
+\newcommand*{\mglslocalunset}[1]{%
+ \gls@ifnotmeasuring
+ {%
+ \glsxtrifmulti{#1}{\@mglslocalunset{#1}}%
+ {%
+ \glsxtrundefaction{Multi entry `#1' hasn't been defined}%
+ {You need to define `#1' with \string\multiglossaryentry}%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@mglslocalunset}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@mglslocalunset}[1]{%
+ \csname @gls@combined@#1@flagtrue\endcsname
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglslocalreset}
+%\changes{1.48}{2021-11-22}{new}
+%Unset the flag.
+% \begin{macrocode}
+\newcommand*{\mglslocalreset}[1]{%
+ \gls@ifnotmeasuring
+ {%
+ \glsxtrifmulti{#1}{\@mglslocalreset{#1}}%
+ {%
+ \glsxtrundefaction{Multi entry `#1' hasn't been defined}%
+ {You need to define `#1' with \string\multiglossaryentry}%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@mglslocalreset}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@mglslocalreset}[1]{%
+ \csname @gls@combined@#1@flagfalse\endcsname
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsunsetall}
+%\changes{1.48}{2021-11-22}{new}
+%Unset all.
+% \begin{macrocode}
+\newcommand*{\mglsunsetall}{%
+ \@for\@mgls@thislabel:=\@multi@glossaryentry@list\do{\mglsunset\@mgls@thislabel}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsresetall}
+%\changes{1.48}{2021-11-22}{new}
+%Reset all.
+% \begin{macrocode}
+\newcommand*{\mglsresetall}{%
+ \@for\@mgls@thislabel:=\@multi@glossaryentry@list\do{\mglsreset\@mgls@thislabel}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsSetMain}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{mglsSetName}\marg{multi-label}\marg{new main}
+%\end{definition}
+%Allow the main label to be changed (local).
+% \begin{macrocode}
+\newrobustcmd{\mglsSetMain}[2]{%
+ \ifcsundef{@gls@combined@#1@main}%
+ {\PackageError{glossaries-extra}{Multi-entry label `#1' not defined}{}}%
+ {%
+ \protected@edef\@gls@combined@current@main{#2}%
+ \letcs\@gls@combined@currentlist{@gls@combined@#1@list}%
+% \end{macrocode}
+% Check that the given label is in the list of elements and update
+% main and last other element index.
+% \begin{macrocode}
+ \mglselementindex=0\relax
+ \count@=0\relax
+ \@for\@gls@tmp:=\@gls@combined@currentlist\do{%
+ \advance\mglselementindex by 1\relax
+ \ifx\@gls@combined@current@main\@gls@tmp
+ \count@=\mglselementindex\relax
+ \let\@gls@combined@finalitem\@gls@tmp
+ \ifmultiglossaryentryglobal
+ \global\cslet{@gls@combined@#1@main}\@gls@combined@current@main
+ \csxdef{@gls@combined@#1@mainindex}{\the\mglselementindex}%
+ \else
+ \cslet{@gls@combined@#1@main}\@gls@combined@current@main
+ \csedef{@gls@combined@#1@mainindex}{\the\mglselementindex}%
+ \fi
+ \else
+ \ifmultiglossaryentryglobal
+ \csxdef{@gls@combined@#1@lastotherindex}{\the\mglselementindex}%
+ \else
+ \csedef{@gls@combined@#1@lastotherindex}{\the\mglselementindex}%
+ \fi
+ \fi
+ }%
+ \ifnum\count@=0\relax
+ \PackageError{glossaries-extra}{Label `#2' is not in `#1' set
+ (\@gls@combined@currentlist)}{}%
+% \end{macrocode}
+% Default to final item.
+% \begin{macrocode}
+ \ifmultiglossaryentryglobal
+ \global\cslet{@gls@combined@#1@main}\@gls@combined@finalitem
+ \csxdef{@gls@combined@#1@mainindex}{\the\mglselementindex}%
+ \csxdef{@gls@combined@#1@lastotherindex}{%
+ \number\numexpr\mglselementindex-1 }%
+ \else
+ \cslet{@gls@combined@#1@main}\@gls@combined@finalitem
+ \csedef{@gls@combined@#1@mainindex}{\the\mglselementindex}%
+ \csedef{@gls@combined@#1@lastotherindex}{%
+ \number\numexpr\mglselementindex-1 }%
+ \fi
+ \fi
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsSetOptions}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{mglsSetOptions}\marg{multi-label}\marg{new options}
+%\end{definition}
+%Allow the options to be changed (local). No expansion is applied.
+% \begin{macrocode}
+\newrobustcmd{\mglsSetOptions}[2]{%
+ \ifcsundef{@gls@combined@#1@main}%
+ {\PackageError{glossaries-extra}{Multi-entry label `#1' not defined}{}}%
+ {%
+ \csdef{@gls@combined@#1@options}{#2}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsAddOptions}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{mglsAddOptions}\marg{multi-label}\marg{extra options}
+%\end{definition}
+%Allow the options to be changed (local). No expansion is applied.
+% \begin{macrocode}
+\newrobustcmd{\mglsAddOptions}[2]{%
+ \ifcsundef{@gls@combined@#1@main}%
+ {\PackageError{glossaries-extra}{Multi-entry label `#1' not defined}{}}%
+ {%
+ \ifcsempty{@gls@combined@#1@options}%
+ {\csdef{@gls@combined@#1@options}{#2}}%
+ {\csappto{@gls@combined@#1@options}{,#2}}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%Options for \cs{mgls}:
+%\begin{macro}{\@mgls@all}
+%\changes{1.48}{2021-11-22}{new}
+%Options to apply to all elements.
+% \begin{macrocode}
+\newcommand*{\@mgls@all}{}
+\define@key{mgls}{all}{\renewcommand*{\@mgls@all}{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@mgls@main}
+%\changes{1.48}{2021-11-22}{new}
+%Options to apply to the main element only.
+% \begin{macrocode}
+\newcommand*{\@mgls@main}{}
+\define@key{mgls}{main}{\renewcommand*{\@mgls@main}{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@mgls@others}
+%\changes{1.48}{2021-11-22}{new}
+%Options to apply to the other (no main) elements.
+% \begin{macrocode}
+\newcommand*{\@mgls@others}{}
+\define@key{mgls}{others}{\renewcommand*{\@mgls@others}{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@mgls@setup}
+%\changes{1.48}{2021-11-22}{new}
+%Options to apply to \cs{multiglossaryentrysetup}.
+% \begin{macrocode}
+\newcommand*{\@mgls@setup}{}
+\define@key{mgls}{setup}{%
+ \@mgls@setup@do{\renewcommand*{\@mgls@setup}{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@mgls@setup@do}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@mgls@setup@do}[1]{#1}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@mgls@setup@do@not}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@mgls@setup@do@not}[1]{%
+ \PackageError{glossaries-extra}{`setup' key not permitted inside
+ `mglsopts' value}{}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mgls@disable@setup}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\mgls@disable@setup}{%
+ \let\@mgls@setup@do\@mgls@setup@do@not
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mgls@enable@setup}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\mgls@enable@setup}{%
+ \let\@mgls@setup@do\@firstofone
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@mgls@unsetaction}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand\@mgls@unsetaction{0}
+\define@choicekey{mgls}{multiunset}[\@mgls@unsetaction@val\@mgls@unsetaction]%
+ {global,local,none}{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\ifKV@mgls@presetlocal}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\define@boolkey{mgls}{presetlocal}[true]{}
+\KV@mgls@presetlocalfalse
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@mgls@hyper}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@mgls@hyper}{}
+\define@choicekey{mgls}{hyper}[\@mgls@hyper@val\@mgls@hyper@nr]{true,false}[true]%
+{%
+ \renewcommand*{\@mgls@hyper}{hyper=#1}%
+ \ifnum\@mgls@hyper@nr=1\relax
+ \let\@mgls@hyperlink\@secondoftwo
+ \else
+ \let\@mgls@hyperlink\@@mgls@hyperlink
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@@mgls@hyperlink}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@@mgls@hyperlink}[2]{%
+ \ifx\@glslink\glsdonohyperlink
+ #2%
+ \else
+ \glsxtr@org@dohyperlink{\glolinkprefix#1}{#2}%
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@mgls@hyperlink}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\let\@mgls@hyperlink\@@mgls@hyperlink
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsforelements}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{mglsforelements}\marg{multi-label}\marg{cs}\marg{body}
+%\end{definition}
+% \begin{macrocode}
+\newcommand*{\mglsforelements}[3]{%
+ \expandafter\@for\expandafter#2\expandafter:\expandafter
+ =\csname @gls@combined@#1@list\endcsname\do{#3}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsforotherelements}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{mglsforotherelements}\marg{multi-label}\marg{cs}\marg{body}
+%\end{definition}
+% \begin{macrocode}
+\newcommand*{\mglsforotherelements}[3]{%
+ \expandafter\@for\expandafter#2\expandafter:\expandafter
+ =\csname @gls@combined@#1@list\endcsname\do
+ {\expandafter\ifdefequal\csname @gls@combined@#1@main\endcsname{#2}{}{#3}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsunsetothers}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\mglsunsetothers}[1]{%
+ \mglsforotherelements{#1}{\@gls@tmp}{\glsunset{\@gls@tmp}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglslocalunsetothers}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\mglslocalunsetothers}[1]{%
+ \mglsforotherelements{#1}{\@gls@tmp}{\glslocalunset{\@gls@tmp}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglselementreset}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\mglselementreset}[1]{%
+ \ifKV@mgls@presetlocal
+ \glslocalreset{#1}%
+ \else
+ \glsreset{#1}%
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglselementunset}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\mglselementunset}[1]{%
+ \ifKV@mgls@presetlocal
+ \glslocalunset{#1}%
+ \else
+ \glsunset{#1}%
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@mgls@resetall}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@mgls@resetall}{}
+\define@choicekey{mgls}{resetall}%
+[\@mgls@resetall@val\@mgls@resetall@nr]{false,true}[true]%
+{%
+ \ifcase\@mgls@resetall@nr\relax
+ \renewcommand*{\@mgls@resetall}{}%
+ \or
+ \renewcommand*{\@mgls@resetall}{%
+ \@for\@gls@resetlabel:=\mglscurrentlist\do{\mglselementreset\@gls@resetlabel}}%
+ \renewcommand*{\@mgls@unsetall}{}%
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@mgls@resetmain}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@mgls@resetmain}{}
+\define@choicekey{mgls}{resetmain}
+[\@mgls@resetmain@val\@mgls@resetmain@nr]{false,true}[true]%
+{%
+ \ifcase\@mgls@resetmain@nr\relax
+ \renewcommand*{\@mgls@resetmain}{}%
+ \or
+ \renewcommand*{\@mgls@resetmain}{\mglselementreset\mglscurrentmainlabel}%
+ \renewcommand*{\@mgls@unsetmain}{}%
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@mgls@resetothers}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@mgls@resetothers}{}
+\define@choicekey{mgls}{resetothers}
+[\@mgls@resetothers@val\@mgls@resetothers@nr]{false,true}[true]%
+{%
+ \ifcase\@mgls@resetothers@nr\relax
+ \renewcommand*{\@mgls@resetothers}{}%
+ \or
+ \renewcommand*{\@mgls@resetothers}{%
+ \@for\@gls@resetlabel:=\mglscurrentlist\do{%
+ \ifx\@gls@resetlabel\mglscurrentmainlabel
+ \else
+ \mglselementreset\@gls@resetlabel
+ \fi
+ }%
+ }%
+ \renewcommand*{\@mgls@unsetothers}{}%
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@mgls@unsetall}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@mgls@unsetall}{}
+\define@choicekey{mgls}{unsetall}%
+[\@mgls@unsetall@val\@mgls@unsetall@nr]{false,true}[true]%
+{%
+ \ifcase\@mgls@unsetall@nr\relax
+ \renewcommand*{\@mgls@unsetall}{}%
+ \or
+ \renewcommand*{\@mgls@unsetall}{%
+ \@for\@gls@unsetlabel:=\mglscurrentlist\do{\mglselementunset\@gls@unsetlabel}}%
+ \renewcommand*{\@mgls@resetall}{}%
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@mgls@unsetmain}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@mgls@unsetmain}{}
+\define@choicekey{mgls}{unsetmain}
+[\@mgls@unsetmain@val\@mgls@unsetmain@nr]{false,true}[true]%
+{%
+ \ifcase\@mgls@unsetmain@nr\relax
+ \renewcommand*{\@mgls@unsetmain}{}%
+ \or
+ \renewcommand*{\@mgls@unsetmain}{\mglselementunset\mglscurrentmainlabel}%
+ \renewcommand*{\@mgls@resetmain}{}%
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@mgls@unsetothers}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@mgls@unsetothers}{}
+\define@choicekey{mgls}{unsetothers}
+[\@mgls@unsetothers@val\@mgls@unsetothers@nr]{false,true}[true]%
+{%
+ \ifcase\@mgls@unsetothers@nr\relax
+ \renewcommand*{\@mgls@unsetothers}{}%
+ \or
+ \renewcommand*{\@mgls@unsetothers}{%
+ \@for\@gls@unsetlabel:=\mglscurrentlist\do{%
+ \ifx\@gls@unsetlabel\mglscurrentmainlabel
+ \else
+ \mglselementunset\@gls@unsetlabel
+ \fi
+ }%
+ }%
+ \renewcommand*{\@mgls@resetothers}{}%
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtr@setup@docurrent}
+%\changes{1.48}{2021-11-22}{new}
+%Set up the commands to determine whether or not to do the current
+%element.
+% \begin{macrocode}
+\newcommand{\glsxtr@setup@docurrent}{%
+% \end{macrocode}
+% \cs{mglscurrentlabel} expands to the label of the current element.
+% Should this element be skipped?
+% \begin{macrocode}
+ \ifx\mglscurrentlabel\mglscurrentmainlabel
+% \end{macrocode}
+% Main element. Should it be skipped?
+% \begin{macrocode}
+ \mglsisfirstuse
+ {%
+ \ifKV@glsxtrcombined@firstskipmain
+ \let\@mgls@do@current@element\@gobble
+ \else
+ \let\@mgls@do@current@element\@firstofone
+ \fi
+ }%
+ {%
+ \ifKV@glsxtrcombined@usedskipmain
+ \let\@mgls@do@current@element\@gobble
+ \else
+ \let\@mgls@do@current@element\@firstofone
+ \fi
+ }%
+ \else
+% \end{macrocode}
+% Other element. Should it be skipped?
+% \begin{macrocode}
+ \mglsisfirstuse
+ {%
+ \ifKV@glsxtrcombined@firstskipothers
+ \let\@mgls@do@current@element\@gobble
+ \else
+ \let\@mgls@do@current@element\@firstofone
+ \fi
+ }%
+ {%
+ \ifKV@glsxtrcombined@usedskipothers
+ \let\@mgls@do@current@element\@gobble
+ \else
+ \let\@mgls@do@current@element\@firstofone
+ \fi
+ }%
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtr@mgls@checklastelement}
+%\changes{1.48}{2021-11-22}{new}
+% If the last element is skipped, \cs{mglsiflast} needs
+% adjusting.
+% The first argument should be either "first" or "used".
+% The second argument is the multi-element label.
+% \begin{macrocode}
+\newcommand*{\glsxtr@mgls@checklastelement}[2]{%
+ \ifbool{KV@glsxtrcombined@#1skipmain}%
+ {%
+ \ifbool{KV@glsxtrcombined@#1skipothers}%
+ {%
+% \end{macrocode}
+% This condition has already been checked for.
+% \begin{macrocode}
+ }%
+ {%
+% \end{macrocode}
+% Main skipped. The last item will be the last other element.
+% \begin{macrocode}
+ \ifnum\mglselementindex=\glsxtrmultilastotherindex{#2}\relax
+ \let\mglsiflast\@firstoftwo
+ \else
+ \let\mglsiflast\@secondoftwo
+ \fi
+ }%
+ }%
+ {%
+% \end{macrocode}
+% Main not skipped.
+% \begin{macrocode}
+ \ifbool{KV@glsxtrcombined@#1skipothers}%
+ {%
+% \end{macrocode}
+% Others skipped. The main element is the only item.
+% \begin{macrocode}
+ \ifnum\mglselementindex=\glsxtrmultimainindex{#2}\relax
+ \let\mglsiflast\@firstoftwo
+ \else
+ \let\mglsiflast\@secondoftwo
+ \fi
+ }%
+ {%
+% \end{macrocode}
+% None skipped. This isn't the last element.
+% \begin{macrocode}
+ \let\mglsiflast\@secondoftwo
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrmglsWarnAllSkipped}
+%\changes{1.48}{2021-11-22}{new}
+%Warning if all elements are skipped. The first argument is the
+%warning message, the second argument is the inserted content (final
+%optional argument), the third command is the encapsulation command
+%(which may be a hyperlink).
+% \begin{macrocode}
+\newcommand{\glsxtrmglsWarnAllSkipped}[3]{%
+ \GlossariesExtraWarning{#1}%
+ #3{#2}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtr@mgls@applyopts}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtr@mgls@applyopts}[1]{%
+ \edef\@mgls@dooptions{\noexpand\setkeys*{mgls}{\expandonce#1}}%
+ \@mgls@dooptions
+% \end{macrocode}
+% Append any unknown options to all.
+% \begin{macrocode}
+ \ifdefvoid\XKV@rm{}{\eappto\@mgls@all{,\expandonce\XKV@rm}}%
+% \end{macrocode}
+% If setup key has been used, check for pre-option keys:
+% \begin{macrocode}
+ \ifdefvoid\@mgls@setup
+ {}%
+ {%
+ \edef\@mgls@dooptions{%
+ \noexpand\setkeys*{glsxtrcombinedpreopts}{\expandonce\@mgls@setup}}%
+ \mgls@disable@mglsopts
+ \@mgls@dooptions
+ \mgls@enable@mglsopts
+% \end{macrocode}
+% Save remaining setup options.
+% \begin{macrocode}
+ \ifx\@mgls@setupoptions\@empty
+ \let\@mgls@setupoptions\XKV@rm
+ \else
+ \eappto\@mgls@setupoptions{,\expandonce\XKV@rm}%
+ \fi
+ }%
+% \end{macrocode}
+% Apply gls unset/reset options.
+% \begin{macrocode}
+ \@mgls@resetall
+ \@mgls@unsetall
+ \@mgls@resetmain
+ \@mgls@unsetmain
+ \@mgls@resetothers
+ \@mgls@unsetothers
+% \end{macrocode}
+% Disable.
+% \begin{macrocode}
+ \let\@mgls@resetall\@empty
+ \let\@mgls@resetmain\@empty
+ \let\@mgls@resetothers\@empty
+ \let\@mgls@unsetall\@empty
+ \let\@mgls@unsetmain\@empty
+ \let\@mgls@unsetothers\@empty
+% \end{macrocode}
+% First use flags.
+% \begin{macrocode}
+ \ifmglsused\mglscurrentmultilabel
+ {\let\mglsisfirstuse\@secondoftwo}%
+ {\let\mglsisfirstuse\@firstoftwo}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@firstofthree}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\providecommand{\@firstofthree}[3]{#1}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@secondofthree}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\providecommand{\@secondofthree}[3]{#2}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@thirdofthree}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\providecommand{\@thirdofthree}[3]{#3}
+% \end{macrocode}
+%\end{macro}
+%
+%The main internal command for referencing multi-entries:
+%\begin{macro}{\glsxtr@mgls@inner}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{glsxtr@mgls@inner}\marg{options}\marg{label}\marg{insert}\marg{first
+%cs}\marg{not first cs}\marg{main first cs}\marg{main other cs}
+%\end{definition}
+% \begin{macrocode}
+\newcommand*{\glsxtr@mgls@inner}[7]{%
+ \let\mglslastmainlabel\@empty
+ \let\mglsiflastmainwasfirstuse\@firstoftwo
+ \let\mglsiflastmainwasplural\@secondoftwo
+ \let\mglsiflastmaincapscase\@firstofthree
+ \let\mglsiflastmainskipped\@firstoftwo
+ \bgroup
+ \ifcsundef{@gls@combined@#2@main}%
+ {%
+ \glsxtrundefaction{Multi entry `#2' hasn't been defined}%
+ {You need to define `#2' with \string\multiglossaryentry}%
+ \gdef\@mgls@post@hookdefs{%
+ \protected@edef\mglslastmultilabel{#2}%
+ \let\mglswasfirstuse\@firstoftwo
+ \let\mglslastcategory\@empty
+ \let\mglsiflastelementskipped\@firstoftwo
+ \let\mglsiflastelementwasfirstuse\@firstoftwo
+ \let\mglsiflastelementwasplural\@secondoftwo
+ \let\mglsiflastelementcapscase\@firstofthree
+ \let\mglslastelementlabel\@empty
+ \let\mgls@do@postlinkhook\relax
+ }%
+ }%
+ {%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{initialise hooks}
+% Initialise hooks in case component entries haven't been defined
+% (which may happen with \app{bib2gls}).
+% \begin{macrocode}
+ \let\glsxtrifwasfirstuse\@firstoftwo
+ \let\glsifplural\@secondoftwo
+ \let\glscapscase\@firstofthree
+% \end{macrocode}
+% Save information for hooks.
+% \begin{macrocode}
+ \protected@edef\mglscurrentmultilabel{#2}%
+ \letcs\mglscurrentmainlabel{@gls@combined@#2@main}%
+ \letcs\mglscurrentlist{@gls@combined@#2@list}%
+ \letcs\mglscurrentoptions{@gls@combined@#2@options}%
+% \end{macrocode}
+% Initialise (may be changed if \texttt{multiunset} is present):
+% \begin{macrocode}
+ \ifmglsused\mglscurrentmultilabel
+ {\let\mglsisfirstuse\@secondoftwo}%
+ {\let\mglsisfirstuse\@firstoftwo}%
+% \end{macrocode}
+% Only obtain pre-option keys:
+% \begin{macrocode}
+ \edef\@mgls@dooptions{%
+ \noexpand\setkeys*{glsxtrcombinedpreopts}{\expandonce\mglscurrentoptions}}%
+ \@mgls@dooptions
+% \end{macrocode}
+% Save remaining setup options.
+% \begin{macrocode}
+ \let\@mgls@setupoptions\XKV@rm
+% \end{macrocode}
+% Apply \cs{mgls} options.
+% \begin{macrocode}
+ \mgls@disable@setup
+ \ifdefvoid\@gls@combined@mglsopts
+ {}%
+ {\glsxtr@mgls@applyopts\@gls@combined@mglsopts}%
+ \mgls@enable@setup
+% \end{macrocode}
+% Apply options provided in \verb|#1|.
+% \begin{macrocode}
+ \ifstrempty{#1}{}{\def\@mgls@options{#1}\glsxtr@mgls@applyopts\@mgls@options}%
+% \end{macrocode}
+% Check for attribute settings.
+% \begin{macrocode}
+ \ifx\@gls@combined@category\empty
+% \end{macrocode}
+% No category
+% \begin{macrocode}
+ \else
+% \end{macrocode}
+% Attribute options:
+% \begin{macrocode}
+ \glshascategoryattribute{\@gls@combined@category}{multioptions}%
+ {%
+ \letcs\@mgls@attroptions{@glsxtr@categoryattr@@\@gls@combined@category
+ @multioptions}%
+% \end{macrocode}
+% Only obtain pre-option keys:
+% \begin{macrocode}
+ \let\@gls@combined@mglsopts\@empty
+ \edef\@mgls@dooptions{%
+ \noexpand\setkeys*{glsxtrcombinedpreopts}{\expandonce\@mgls@attroptions}}%
+ \@mgls@dooptions
+% \end{macrocode}
+% Append remaining options:
+% \begin{macrocode}
+ \eappto\@mgls@setupoptions{,\expandonce\XKV@rm}%
+ \ifx\@gls@combined@mglsopts\@empty
+ \else
+% \end{macrocode}
+% mgls options found:
+% \begin{macrocode}
+ \let\@mgls@setup\@empty
+ \mgls@disable@setup
+ \glsxtr@mgls@applyopts\@gls@combined@mglsopts
+ \mgls@enable@setup
+ \fi
+ }%
+ {}%
+ \fi
+% \end{macrocode}
+% Apply setup options.
+% \begin{macrocode}
+ \edef\@mgls@dooptions{%
+ \noexpand\setkeys{glsxtrcombined}{\expandonce\@mgls@setupoptions}}%
+ \@mgls@dooptions
+% \end{macrocode}
+% Provide local user-level access to category:
+% \begin{macrocode}
+ \let\mglscurrentcategory\@gls@combined@category
+% \end{macrocode}
+% Should the entire content be a hyperlink?
+% \begin{macrocode}
+ \ifnum\@gls@combined@hyper=1\relax
+ \def\@mgls@combinedlink{\@mgls@hyperlink{\mglscurrentmainlabel}}%
+ \else
+ \def\@mgls@combinedlink{\@firstofone}%
+ \fi
+% \end{macrocode}
+% Entire content encapsulator.
+% \begin{macrocode}
+ \def\@gls@combined@encapsulator##1{%
+ \@mgls@combinedlink{\csuse{\@gls@combined@textformat}{##1}}}%
+% \end{macrocode}
+% Initialise.
+% \begin{macrocode}
+ \let\@mgls@do@current@element\@firstofone
+% \end{macrocode}
+% Check if all elements are being skipped.
+% \begin{macrocode}
+ \mglsisfirstuse
+ {%
+ \ifKV@glsxtrcombined@firstskipmain
+ \ifKV@glsxtrcombined@firstskipothers
+% \end{macrocode}
+% Just do the warning and insert. This will ignore the loop.
+% \begin{macrocode}
+ \let\@gls@org@combined@encapsulator\@gls@combined@encapsulator
+ \def\@gls@combined@encapsulator##1{%
+ \glsxtrmglsWarnAllSkipped{All elements skipped for
+ first use of multi-entry `#2'}{#3}%
+ {\@gls@org@combined@encapsulator}%
+ }%
+ \let\@mgls@do@current@element\@gobble
+ \fi
+ \fi
+ }%
+ {%
+ \ifKV@glsxtrcombined@usedskipmain
+ \ifKV@glsxtrcombined@usedskipothers
+% \end{macrocode}
+% Just do the warning and insert. This will ignore the loop.
+% \begin{macrocode}
+ \let\@gls@org@combined@encapsulator\@gls@combined@encapsulator
+ \def\@gls@combined@encapsulator##1{%
+ \glsxtrmglsWarnAllSkipped{All elements skipped for
+ subsequent use of multi-entry `#2'}{#3}%
+ {\@gls@org@combined@encapsulator}%
+ }%
+ \let\@mgls@do@current@element\@gobble
+ \fi
+ \fi
+ }%
+% \end{macrocode}
+% Determine prefix and suffix.
+% \begin{macrocode}
+ \mglsisfirstuse
+ {%
+ \let\mglscurrentprefix\@gls@combined@firstprefix
+ \let\mglscurrentsuffix\@gls@combined@firstsuffix
+ }%
+ {%
+ \let\mglscurrentprefix\@gls@combined@usedprefix
+ \let\mglscurrentsuffix\@gls@combined@usedsuffix
+ }%
+% \end{macrocode}
+%Set up post-link hook used after current scope.
+% \begin{macrocode}
+ \xdef\@mgls@post@hookdefs{%
+ \noexpand\def\noexpand\mglslastmultilabel{\expandonce\mglscurrentmultilabel}%
+ \noexpand\def\noexpand\mglslastcategory{\mglscurrentcategory}%
+ }%
+ \ifx\@mgls@do@current@element\@gobble
+ \gappto\@mgls@post@hookdefs{%
+ \let\mglsiflastelementskipped\@firstoftwo
+ \let\mglslastelementlabel\@empty
+ \let\mglsiflastelementwasfirstuse\@firstoftwo
+ \let\mglsiflastelementwasplural\@secondoftwo
+ \let\mglsiflastelementcapscase\@firstofthree
+ }%
+ \fi
+ \mglsisfirstuse
+ {%
+ \gappto\@mgls@post@hookdefs{\let\mglswasfirstuse\@firstoftwo}%
+% \end{macrocode}
+% Determine if the multi-entry post-link hook should be applied.
+% \begin{macrocode}
+ \ifcase\@gls@combined@mpostlink@nr\relax
+% \end{macrocode}
+% \texttt{mpostlink=false}.
+% \begin{macrocode}
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\relax}%
+ \or
+% \end{macrocode}
+% \texttt{mpostlink=true}.
+% \begin{macrocode}
+ \ifcase\@gls@combined@mpostlinkelement@nr\relax
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastelementpostlinkhook}%
+ \or
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastmainpostlinkhook}%
+ \or
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglscustompostlinkhook}%
+ \fi
+ \or
+% \end{macrocode}
+% \texttt{mpostlink=firstonly}.
+% \begin{macrocode}
+ \ifcase\@gls@combined@mpostlinkelement@nr\relax
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastelementpostlinkhook}%
+ \or
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastmainpostlinkhook}%
+ \or
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglscustompostlinkhook}%
+ \fi
+ \or
+% \end{macrocode}
+% \texttt{mpostlink=usedonly}.
+% \begin{macrocode}
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\relax}%
+ \fi
+ }%
+ {%
+ \gappto\@mgls@post@hookdefs{\let\mglswasfirstuse\@secondoftwo}%
+% \end{macrocode}
+% Determine if the multi-entry post-link hook should be applied.
+% \begin{macrocode}
+ \ifcase\@gls@combined@mpostlink@nr\relax
+% \end{macrocode}
+% \texttt{mpostlink=false}.
+% \begin{macrocode}
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\relax}%
+ \or
+% \end{macrocode}
+% \texttt{mpostlink=true}.
+% \begin{macrocode}
+ \ifcase\@gls@combined@mpostlinkelement@nr\relax
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastelementpostlinkhook}%
+ \or
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastmainpostlinkhook}%
+ \or
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglscustompostlinkhook}%
+ \fi
+ \or
+% \end{macrocode}
+% \texttt{mpostlink=firstonly}.
+% \begin{macrocode}
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\relax}%
+ \or
+% \end{macrocode}
+% \texttt{mpostlink=usedonly}.
+% \begin{macrocode}
+ \ifcase\@gls@combined@mpostlinkelement@nr\relax
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastelementpostlinkhook}%
+ \or
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastmainpostlinkhook}%
+ \or
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglscustompostlinkhook}%
+ \fi
+ \fi
+ }%
+% \end{macrocode}
+% Save current post-link hook.
+% \begin{macrocode}
+ \let\mgls@org@postlinkhook\glspostlinkhook
+% \end{macrocode}
+% Prefix.
+% \begin{macrocode}
+ \mglsprefix
+% \end{macrocode}
+% Initialise last element label (for \cs{mglssuffix}).
+% \begin{macrocode}
+ \let\mglslastelementlabel\@empty
+ \@gls@combined@encapsulator
+ {%
+% \end{macrocode}
+% Save previous label.
+% \begin{macrocode}
+ \def\@mgls@previouslabel{}%
+ \mglselementindex=0\relax
+ \@for\mglscurrentlabel:=\mglscurrentlist\do{%
+ \advance\mglselementindex by 1\relax
+ \glsxtr@setup@docurrent
+% \end{macrocode}
+% Is this the last element?
+% \begin{macrocode}
+ \ifx\@xfor@nextelement\@nnil
+ \let\mglsiflast\@firstoftwo
+ \else
+ \let\mglsiflast\@secondoftwo
+% \end{macrocode}
+% Are any elements being skipped?
+% \begin{macrocode}
+ \mglsisfirstuse
+ {%
+ \glsxtr@mgls@checklastelement{first}{#2}%
+ }%
+ {%
+ \glsxtr@mgls@checklastelement{used}{#2}%
+ }%
+ \fi
+% \end{macrocode}
+% Should the element post-link hook be used?
+% \begin{macrocode}
+ \ifcase\@gls@combined@postlinks@nr\relax
+% \end{macrocode}
+% \texttt{postlinks=none}
+% \begin{macrocode}
+ \let\glspostlinkhook\relax
+ \or
+% \end{macrocode}
+% \texttt{postlinks=all}
+% \begin{macrocode}
+ \let\glspostlinkhook\mgls@org@postlinkhook
+ \or
+% \end{macrocode}
+% \texttt{postlinks=notlast}
+% \begin{macrocode}
+ \mglsiflast
+ {%
+ \let\glspostlinkhook\relax
+ }%
+ {%
+ \let\glspostlinkhook\mgls@org@postlinkhook
+ }%
+ \or
+% \end{macrocode}
+% \texttt{postlinks=mainnotlast}
+% \begin{macrocode}
+ \ifx\mglscurrentlabel\mglscurrentmainlabel
+ \mglsiflast
+ {%
+ \let\glspostlinkhook\relax
+ }%
+ {%
+ \let\glspostlinkhook\mgls@org@postlinkhook
+ }%
+ \else
+ \let\glspostlinkhook\relax
+ \fi
+ \or
+% \end{macrocode}
+% \texttt{postlinks=mainonly}
+% \begin{macrocode}
+ \ifx\mglscurrentlabel\mglscurrentmainlabel
+ \let\glspostlinkhook\mgls@org@postlinkhook
+ \else
+ \let\glspostlinkhook\relax
+ \fi
+ \or
+% \end{macrocode}
+% \texttt{postlinks=othernotlast}
+% \begin{macrocode}
+ \ifx\mglscurrentlabel\mglscurrentmainlabel
+ \let\glspostlinkhook\relax
+ \else
+ \mglsiflast
+ {%
+ \let\glspostlinkhook\relax
+ }%
+ {%
+ \let\glspostlinkhook\mgls@org@postlinkhook
+ }%
+ \fi
+ \or
+% \end{macrocode}
+% \texttt{postlinks=otheronly}
+% \begin{macrocode}
+ \ifx\mglscurrentlabel\mglscurrentmainlabel
+ \let\glspostlinkhook\relax
+ \else
+ \let\glspostlinkhook\mgls@org@postlinkhook
+ \fi
+ \fi
+% \end{macrocode}
+% Save the last element for the multi-entry post-link hook.
+% \begin{macrocode}
+ \mglsiflast
+ {%
+ \xappto\@mgls@post@hookdefs{%
+ \noexpand\def\noexpand\mglslastelementlabel
+ {\expandonce\mglscurrentlabel}}%
+ }%
+ {}%
+% \end{macrocode}
+% Do current element:
+% \begin{macrocode}
+ \@mgls@do@current@element
+ {%
+% \end{macrocode}
+% Pre element hook.
+% \begin{macrocode}
+ \mglselementprehook
+% \end{macrocode}
+% Is this the first use of the current element?
+% \begin{macrocode}
+ \GlsXtrIfUnusedOrUndefined{\mglscurrentlabel}%
+ {\let\@mgls@current@iffirstuse\@firstoftwo}%
+ {\let\@mgls@current@iffirstuse\@secondoftwo}%
+ \ifx\mglscurrentlabel\mglscurrentmainlabel
+% \end{macrocode}
+% Main element.
+% Location encap option:
+% \begin{macrocode}
+ \edef\@mgls@current@options{format=\@gls@combined@encapmain}%
+% \end{macrocode}
+%Indexing option:
+% \begin{macrocode}
+ \ifcase\@gls@combined@indexmain
+ \appto\@mgls@current@options{,noindex}%
+ \or
+ \appto\@mgls@current@options{,noindex=false}%
+ \or
+ \@mgls@current@iffirstuse
+ {\appto\@mgls@current@options{,noindex=false}}%
+ {\appto\@mgls@current@options{,noindex}}%
+ \fi
+% \end{macrocode}
+% Hyperlink option:
+% \begin{macrocode}
+ \ifcase\@gls@combined@hyper\relax
+ \appto\@mgls@current@options{,hyper=false}% none
+ \or
+ \appto\@mgls@current@options{,hyper=false}% allmain
+ \or
+ \eappto\@mgls@current@options{,\@mgls@hyper}% mainonly
+ \or
+ \eappto\@mgls@current@options{,\@mgls@hyper}% individual
+ \or
+ \appto\@mgls@current@options{,hyper=false}% otheronly
+ \or
+ \mglsisfirstuse
+ {%
+ \appto\@mgls@current@options{,hyper=false}% notmainfirst
+ }%
+ {%
+ \eappto\@mgls@current@options{,\@mgls@hyper}% notmainfirst
+ }%
+ \or
+ \eappto\@mgls@current@options{,\@mgls@hyper}% nototherfirst
+ \or
+ \mglsisfirstuse
+ {%
+ \appto\@mgls@current@options{,hyper=false}% notfirst
+ }%
+ {%
+ \eappto\@mgls@current@options{,\@mgls@hyper}% notfirst
+ }%
+ \fi
+% \end{macrocode}
+%Append all and then main:
+% \begin{macrocode}
+ \eappto\@mgls@current@options{,\@mgls@all,\@mgls@main}%
+ \else
+% \end{macrocode}
+% Other element.
+% Location encap option:
+% \begin{macrocode}
+ \edef\@mgls@current@options{format=\@gls@combined@encapothers}%
+% \end{macrocode}
+% Indexing option:
+% \begin{macrocode}
+ \ifcase\@gls@combined@indexothers\relax
+ \appto\@mgls@current@options{,noindex}%
+ \or
+ \appto\@mgls@current@options{,noindex=false}%
+ \or
+ \@mgls@current@iffirstuse
+ {\appto\@mgls@current@options{,noindex=false}}%
+ {\appto\@mgls@current@options{,noindex}}%
+ \fi
+% \end{macrocode}
+% Hyperlink option:
+% \begin{macrocode}
+ \ifcase\@gls@combined@hyper\relax
+ \appto\@mgls@current@options{,hyper=false}% none
+ \or
+ \appto\@mgls@current@options{,hyper=false}% allmain
+ \or
+ \appto\@mgls@current@options{,hyper=false}% mainonly
+ \or
+ \eappto\@mgls@current@options{,\@mgls@hyper}% individual
+ \or
+ \eappto\@mgls@current@options{,\@mgls@hyper}% otheronly
+ \or
+ \eappto\@mgls@current@options{,\@mgls@hyper}% notmainfirst
+ \or
+ \mglsisfirstuse
+ {%
+ \appto\@mgls@current@options{,hyper=false}% nototherfirst
+ }%
+ {%
+ \eappto\@mgls@current@options{,\@mgls@hyper}% nototherfirst
+ }%
+ \or
+ \mglsisfirstuse
+ {%
+ \appto\@mgls@current@options{,hyper=false}% notfirst
+ }%
+ {%
+ \eappto\@mgls@current@options{,\@mgls@hyper}% notfirst
+ }%
+ \fi
+% \end{macrocode}
+%Append all and then others:
+% \begin{macrocode}
+ \eappto\@mgls@current@options{,\@mgls@all,\@mgls@others}%
+ \fi
+% \end{macrocode}
+% Is this the first element?
+% \begin{macrocode}
+ \ifx\@mgls@previouslabel\empty
+ \ifx\mglscurrentlabel\mglscurrentmainlabel
+ \let\@mgls@cs#6\relax
+ \else
+ \let\@mgls@cs#4\relax
+ \fi
+ \else
+% \end{macrocode}
+% Not the first element so add separator.
+% \begin{macrocode}
+ \@mgls@previous@iffirstuse
+ {%
+ \@mgls@current@iffirstuse
+ {\glscombinedfirstsepfirst{\@mgls@previouslabel}{\mglscurrentlabel}}%
+ {\glscombinedfirstsep{\@mgls@previouslabel}{\mglscurrentlabel}}%
+ }%
+ {%
+ \@mgls@current@iffirstuse
+ {\glscombinedsepfirst{\@mgls@previouslabel}{\mglscurrentlabel}}%
+ {\glscombinedsep{\@mgls@previouslabel}{\mglscurrentlabel}}%
+ }%
+ \ifx\mglscurrentlabel\mglscurrentmainlabel
+ \let\@mgls@cs#7\relax
+ \else
+ \let\@mgls@cs#5\relax
+ \fi
+ \fi
+% \end{macrocode}
+% Is this the last element?
+% \begin{macrocode}
+ \mglsiflast
+ {\expandafter\@mgls@cs\expandafter{\@mgls@current@options}{\mglscurrentlabel}[#3]}%
+ {\expandafter\@mgls@cs\expandafter{\@mgls@current@options}{\mglscurrentlabel}[]}%
+% \end{macrocode}
+% Is this the main element? If so, save information for post-link
+% hook.
+% \begin{macrocode}
+ \ifx\mglscurrentlabel\mglscurrentmainlabel
+ \xappto\@mgls@post@hookdefs{%
+ \noexpand\def\noexpand\mglslastmainlabel
+ {\expandonce\mglscurrentmainlabel}%
+ }%
+ \glsxtrifwasfirstuse
+ {%
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastmainwasfirstuse\@firstoftwo}%
+ }%
+ {%
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastmainwasfirstuse\@secondoftwo}%
+ }%
+ \glsifplural
+ {%
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastmainwasplural\@firstoftwo}%
+ }%
+ {%
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastmainwasplural\@secondoftwo}%
+ }%
+ \glscapscase
+ {%
+ \gappto\@mgls@post@hookdefs{%
+ \let\mglsiflastmaincapscase\@firstofthree
+ }%
+ }%
+ {%
+ \gappto\@mgls@post@hookdefs{%
+ \let\mglsiflastmaincapscase\@secondofthree
+ }%
+ }%
+ {%
+ \gappto\@mgls@post@hookdefs{%
+ \let\mglsiflastmaincapscase\@thirdofthree
+ }%
+ }%
+ \fi
+ \let\@mgls@previouslabel\mglscurrentlabel
+ \let\@mgls@previous@iffirstuse\@mgls@current@iffirstuse
+ }%
+% \end{macrocode}
+% Post element hook.
+% \begin{macrocode}
+ \mglselementposthook
+ }%
+ \ifx\mglslastmainlabel\@empty
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastmainskipped\@firstoftwo}%
+ \else
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastmainskipped\@secondoftwo}%
+ \fi
+% \end{macrocode}
+% Encapsulator may introduce grouping so check here.
+% \begin{macrocode}
+ \ifx\@mgls@do@current@element\@gobble
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastelementskipped\@firstoftwo}%
+ \else
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastelementskipped\@secondoftwo}%
+ \fi
+ \glsxtrifwasfirstuse
+ {%
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastelementwasfirstuse\@firstoftwo}%
+ }%
+ {%
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastelementwasfirstuse\@secondoftwo}%
+ }%
+ \glsifplural
+ {%
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastelementwasplural\@firstoftwo}%
+ }%
+ {%
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastelementwasplural\@secondoftwo}%
+ }%
+ \glscapscase
+ {%
+ \gappto\@mgls@post@hookdefs{%
+ \let\mglsiflastelementcapscase\@firstofthree
+ }%
+ }%
+ {%
+ \gappto\@mgls@post@hookdefs{%
+ \let\mglsiflastelementcapscase\@secondofthree
+ }%
+ }%
+ {%
+ \gappto\@mgls@post@hookdefs{%
+ \let\mglsiflastelementcapscase\@thirdofthree
+ }%
+ }%
+ }%
+% \end{macrocode}
+% Suffix needs post-link hook commands.
+% \begin{macrocode}
+ \@mgls@post@hookdefs
+ \mglssuffix
+% \end{macrocode}
+%Unset multi-entry first use flag after current scope.
+% \begin{macrocode}
+ \ifcase\@mgls@unsetaction\relax
+ \xappto\@mgls@post@hookdefs{%
+ \noexpand\mglsunset{\expandonce\mglscurrentmultilabel}}%
+ \or
+ \xappto\@mgls@post@hookdefs{%
+ \noexpand\mglslocalunset{\expandonce\mglscurrentmultilabel}}%
+ \fi
+ }%
+ \glsxtrmglswrite{#2}%
+ \egroup
+ \@mgls@post@hookdefs
+ \mgls@do@postlinkhook
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglscustompostlinkhook}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\mglscustompostlinkhook}{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglslastelementpostlinkhook}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\mglslastelementpostlinkhook}{%
+ \let\glsxtrifwasfirstuse\mglsiflastelementwasfirstuse
+ \let\glsifplural\mglsiflastelementwasplural
+ \let\glscapscase\mglsiflastelementcapscase
+ \let\glslabel\mglslastelementlabel
+ \glspostlinkhook
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglslastmainpostlinkhook}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\mglslastmainpostlinkhook}{%
+ \let\glsxtrifwasfirstuse\mglsiflastmainwasfirstuse
+ \let\glsifplural\mglsiflastmainwasplural
+ \let\glscapscase\mglsiflastmaincapscase
+ \let\glslabel\mglslastmainlabel
+ \glspostlinkhook
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsdefcategoryprefix}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\mglsdefcategoryprefix}[2]{%
+ \csdef{mglsprefix@#1}{#2}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglshascategoryprefix}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\mglshascategoryprefix}[3]{%
+ \ifcsdef{mglsprefix@#1}{#2}{#3}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsusecategoryprefix}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\mglsusecategoryprefix}[1]{%
+ \csuse{mglsprefix@#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsprefix}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\mglsprefix}{%
+ \ifdefempty\mglscurrentcategory
+ {\mglscurrentprefix}%
+ {%
+ \mglshascategoryprefix{\mglscurrentcategory}%
+ {\mglsusecategoryprefix{\mglscurrentcategory}}%
+ {\mglscurrentprefix}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsdefcategorysuffix}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\mglsdefcategorysuffix}[2]{%
+ \csdef{mglssuffix@#1}{#2}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglshascategorysuffix}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\mglshascategorysuffix}[3]{%
+ \ifcsdef{mglssuffix@#1}{#2}{#3}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsusecategorysuffix}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\mglsusecategorysuffix}[1]{%
+ \csuse{mglssuffix@#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglssuffix}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\mglssuffix}{%
+ \ifdefempty\mglscurrentcategory
+ {\ifdefempty{\mglscurrentsuffix}{}{\space(\mglscurrentsuffix)}}%
+ {%
+ \mglshascategorysuffix{\mglscurrentcategory}%
+ {\mglsusecategorysuffix{\mglscurrentcategory}}%
+ {\ifdefempty{\mglscurrentsuffix}{}{\space(\mglscurrentsuffix)}}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglselementprehook}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\mglselementprehook}{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglselementposthook}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\mglselementposthook}{}
+% \end{macrocode}
+%\end{macro}
+%
+%Separators.
+%\begin{macro}{\glscombinedsep}
+%\changes{1.48}{2021-11-22}{new}
+%Separator between two elements that have been marked as used.
+%This takes the two element labels as arguments.
+% \begin{macrocode}
+\newcommand*{\glscombinedsep}[2]{%
+ \glshasattribute{#1}{combinedsep}%
+ {\glsgetattribute{#1}{combinedsep}}%
+ { }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glscombinedfirstsepfirst}
+%\changes{1.48}{2021-11-22}{new}
+%Separator following and preceding a first use.
+% \begin{macrocode}
+\newcommand*{\glscombinedfirstsepfirst}[2]{%
+ \glshasattribute{#1}{combinedfirstsepfirst}%
+ {\glsgetattribute{#1}{combinedfirstsepfirst}}%
+ {\glscombinedsep{#1}{#2}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glscombinedfirstsep}
+%\changes{1.48}{2021-11-22}{new}
+%Separator following a first use.
+% \begin{macrocode}
+\newcommand*{\glscombinedfirstsep}[2]{%
+ \glshasattribute{#1}{combinedfirstsep}%
+ {\glsgetattribute{#1}{combinedfirstsep}}%
+ {\glscombinedsep{#1}{#2}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glscombinedsepfirst}
+%\changes{1.48}{2021-11-22}{new}
+%Separator preceding a first use.
+% \begin{macrocode}
+\newcommand*{\glscombinedsepfirst}[2]{%
+ \glshasattribute{#1}{combinedsepfirst}%
+ {\glsgetattribute{#1}{combinedsepfirst}}%
+ {\glscombinedsep{#1}{#2}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glssetcombinedsepabbrvnbsp}
+%\changes{1.48}{2021-11-22}{new}
+%Provide shortcut for using non-breakable space following an
+%abbreviation that has already been used.
+%\changes{1.49}{2022-10-14}{corrected spelling of \cs{ifglshasshort}}
+% \begin{macrocode}
+\newcommand*{\glssetcombinedsepabbrvnbsp}{%
+ \renewcommand*{\glscombinedsep}[2]{%
+ \glshasattribute{##1}{combinedsep}%
+ {\glsgetattribute{##1}{combinedsep}}%
+ {\ifglshasshort{##1}{~}{ }}%
+ }%
+ \renewcommand*{\glscombinedsepfirst}[2]{%
+ \glshasattribute{##1}{combinedsepfirst}%
+ {\glsgetattribute{##1}{combinedsepfirst}}%
+ {\ifglshasshort{##1}{~}{ }}%
+ }%
+ \renewcommand*{\glscombinedfirstsep}[2]{%
+ \glshasattribute{##1}{combinedfirstsep}%
+ {\glsgetattribute{##1}{combinedfirstsep}}%
+ { }%
+ }%
+ \renewcommand*{\glscombinedfirstsepfirst}[2]{%
+ \glshasattribute{##1}{combinedfirstsepfirst}%
+ {\glsgetattribute{##1}{combinedfirstsepfirst}}%
+ { }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glssetcombinedsepabbrvnone}
+%\changes{1.48}{2021-11-22}{new}
+%Provide shortcut for using nothing if either on next use are
+%abbreviations (otherwise use space).
+%\changes{1.49}{2022-10-14}{corrected spelling of \cs{ifglshasshort}}
+% \begin{macrocode}
+\newcommand*{\glssetcombinedsepabbrvnone}{%
+ \renewcommand*{\glscombinedsep}[2]{%
+ \glshasattribute{##1}{combinedsep}%
+ {\glsgetattribute{##1}{combinedsep}}%
+ {\ifglshasshort{##1}{}{\ifglshasshort{##2}{}{ }}}%
+ }%
+ \renewcommand*{\glscombinedsepfirst}[2]{%
+ \glshasattribute{##1}{combinedsepfirst}%
+ {\glsgetattribute{##1}{combinedsepfirst}}%
+ {\ifglshasshort{##1}{}{ }}%
+ }%
+ \renewcommand*{\glscombinedfirstsep}[2]{%
+ \glshasattribute{##1}{combinedfirstsep}%
+ {\glsgetattribute{##1}{combinedfirstsep}}%
+ {\ifglshasshort{##2}{}{ }}%
+ }%
+ \renewcommand*{\glscombinedfirstsepfirst}[2]{%
+ \glshasattribute{##1}{combinedfirstsepfirst}%
+ {\glsgetattribute{##1}{combinedfirstsepfirst}}%
+ { }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glssetcombinedsepnarrow}
+%\changes{1.48}{2021-11-22}{new}
+%\changes{1.49}{2022-10-14}{corrected spelling of \cs{ifglshasshort}}
+%Measures both.
+% \begin{macrocode}
+\newcommand*{\glssetcombinedsepnarrow}[2]{%
+ \renewcommand*{\glscombinedsep}[2]{%
+ \glshasattribute{##1}{combinedsep}%
+ {\glsgetattribute{##1}{combinedsep}}%
+ {%
+ \ifglshasshort{##1}%
+ {\settowidth{\dimen@}{\glsentryshort{##1}}}%
+ {\settowidth{\dimen@}{\glsentrytext{##1}}}%
+ \ifdim\dimen@<#1\relax
+ #2%
+ \else
+ \ifglshasshort{##2}%
+ {\settowidth{\dimen@}{\glsentryshort{##2}}}%
+ {\settowidth{\dimen@}{\glsentrytext{##2}}}%
+ \ifdim\dimen@<#1\relax
+ #2%
+ \else
+ \space
+ \fi
+ \fi
+ }%
+ }%
+ \renewcommand*{\glscombinedsepfirst}[2]{%
+ \glshasattribute{##1}{combinedsepfirst}%
+ {\glsgetattribute{##1}{combinedsepfirst}}%
+ {%
+ \ifglshasshort{##1}%
+ {\settowidth{\dimen@}{\glsentryshort{##1}}}%
+ {\settowidth{\dimen@}{\glsentrytext{##1}}}%
+ \ifdim\dimen@<#1\relax
+ #2%
+ \else
+ \ifhaslong{##2}%
+ {\settowidth{\dimen@}{\glsentrylong{##2}}}%
+ {\settowidth{\dimen@}{\glsentryfirst{##2}}}%
+ \ifdim\dimen@<#1\relax
+ #2%
+ \else
+ \space
+ \fi
+ \fi
+ }%
+ }%
+ \renewcommand*{\glscombinedfirstsep}[2]{%
+ \glshasattribute{##1}{combinedfirstsep}%
+ {\glsgetattribute{##1}{combinedfirstsep}}%
+ {%
+ \ifhaslong{##1}%
+ {\settowidth{\dimen@}{\glsentrylong{##1}}}%
+ {\settowidth{\dimen@}{\glsentryfirst{##1}}}%
+ \ifdim\dimen@<#1\relax
+ #2%
+ \else
+ \ifglshasshort{##2}%
+ {\settowidth{\dimen@}{\glsentryshort{##2}}}%
+ {\settowidth{\dimen@}{\glsentrytext{##2}}}%
+ \ifdim\dimen@<#1\relax
+ #2%
+ \else
+ \space
+ \fi
+ \fi
+ }%
+ }%
+ \renewcommand*{\glscombinedfirstsepfirst}[2]{%
+ \glshasattribute{##1}{combinedfirstsepfirst}%
+ {\glsgetattribute{##1}{combinedfirstsepfirst}}%
+ {%
+ \ifhaslong{##1}%
+ {\settowidth{\dimen@}{\glsentrylong{##1}}}%
+ {\settowidth{\dimen@}{\glsentryfirst{##1}}}%
+ \ifdim\dimen@<#1\relax
+ #2%
+ \else
+ \ifhaslong{##2}%
+ {\settowidth{\dimen@}{\glsentrylong{##2}}}%
+ {\settowidth{\dimen@}{\glsentryfirst{##2}}}%
+ \ifdim\dimen@<#1\relax
+ #2%
+ \else
+ \space
+ \fi
+ \fi
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsxtr@mglswrite}
+%\changes{1.48}{2021-11-22}{new}
+%Write information to the aux file for \app{bib2gls} to pick up, but
+%only need to do it once per label since it only indicates which multi-entry
+%has been referenced without any additional information.
+% \begin{macrocode}
+\newcommand{\glsxtrmglswrite}[1]{%
+ \ifx\@glsxtr@record@setting\@glsxtr@record@setting@off
+ \else
+ \protected@edef\@glsxtr@mglslabel{#1}%
+ \ifdef\@glsxtr@mglsreflist
+ {%
+ \expandafter\DTLifinlist\expandafter{\@glsxtr@mglslabel}%
+ {\@glsxtr@mglsreflist}{}%
+ {%
+ \xappto\@glsxtr@mglsreflist{,\expandonce\@glsxtr@mglslabel}%
+ \if@mgls@writeseparaterefs
+ \protected@write\@auxout{}{\string\@glsxtr@mglsrefs{#1}}%
+ \fi
+ }%
+ }%
+ {%
+ \global\let\@glsxtr@mglsreflist\@glsxtr@mglslabel
+ \if@mgls@writeseparaterefs
+ \protected@write\@auxout{}{\string\@glsxtr@mglsrefs{#1}}%
+ \else
+ \AtEndDocument{\immediate\protected@write\@auxout{}%
+ {\string\@glsxtr@mglsrefs{\@glsxtr@mglsreflist}}}%
+ \fi
+ \@mgls@disable@writeseparateref@cond
+ }%
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsxtr@mglsrefs}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand{\@glsxtr@mglsrefs}[1]{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\if@mgls@writeseparaterefs}
+%\changes{1.48}{2021-11-22}{new}
+%If this conditional is changed, it must be done before the first
+%instance of any \cs{mgls}-like command.
+% \begin{macrocode}
+\newif\if@mgls@writeseparaterefs \@mgls@writeseparaterefsfalse
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsWriteSeparateRefsTrue}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand{\mglsWriteSeparateRefsTrue}{\global\@mgls@writeseparaterefstrue}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsWriteSeparateRefsFalse}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand{\mglsWriteSeparateRefsFalse}{\global\@mgls@writeseparaterefsfalse}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@mgls@disable@writeseparateref@cond}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@mgls@disable@writeseparateref@cond}{%
+ \gdef\mglsWriteSeparateRefsTrue{\PackageError{glossaries-extra}%
+ {Too late to use \string\mglsWriteSeparateRefsTrue}%
+ {\string\mglsWriteSeparateRefsTrue\space can only be used before
+ the first instance of any \string\mgls-like command}}%
+ \gdef\mglsWriteSeparateRefsFalse{\PackageError{glossaries-extra}%
+ {Too late to use \string\mglsWriteSeparateRefsFalse}%
+ {\string\mglsWriteSeparateRefsFalse\space can only be used before
+ the first instance of any \string\mgls-like command}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtr@newmgls}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand{\glsxtr@newmgls}[5]{%
+ \edef\@glsxr@newmgls@do{%
+ \noexpand\newrobustcmd*{\expandonce{\csname #1\endcsname}}%
+ {\noexpand\@gls@hyp@opt\expandonce{\csname ns@glsxtr@#1\endcsname}}%
+ \noexpand\newcommand*{\expandonce{\csname ns@glsxtr@#1\endcsname}}[2][]{%
+ \noexpand\new@ifnextchar[%
+ {\expandonce{\csname glsxtr@#1\endcsname}{####1}{####2}}%
+ {\expandonce{\csname glsxtr@#1\endcsname}{####1}{####2}[]}%
+ }%
+ \noexpand\def\expandonce{\csname glsxtr@#1\endcsname}####1####2[####3]{%
+ \noexpand\def\noexpand\glsxtrcurrentmglscsname{#1}%
+ \noexpand\glsxtr@mgls@inner{####1}{####2}{####3}%
+ {\noexpand#2}{\noexpand#3}{\noexpand#4}{\noexpand#5}%
+ }%
+ }%
+ \@glsxr@newmgls@do
+ \ifx\@glsxtr@record@setting\@glsxtr@record@setting@off
+ \else
+% \end{macrocode}
+% Provide a way for \app{bib2gls} to recognise the command (this will
+% make it easier to add extra commands without having to modify
+% \app{bib2gls}).
+% \begin{macrocode}
+ \ifdef\@glsxtr@mglslikelist
+ {\xappto\@glsxtr@mglslikelist{,#1}}%
+ {%
+ \gdef\@glsxtr@mglslikelist{#1}%
+ \AtEndDocument{\immediate\protected@write\@auxout{}%
+ {\string\@glsxtr@mglslike{\@glsxtr@mglslikelist}}}%
+ }%
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsxtr@mglslike}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@glsxtr@mglslike}[1]{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GlsXtrMglsOrGls}
+%\begin{definition}
+%\cs{GlsXtrMglsOrGls}\marg{mgls cs}\marg{gls cs}\meta{modifier}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+%\changes{1.48}{2021-11-22}{new}
+%\changes{1.49}{2022-10-14}{removed spurious \cs{PLUS}}
+% \begin{macrocode}
+\newcommand*{\GlsXtrMglsOrGls}[2]{%
+ \def\@glsxtr@mgls@or@gls@mcs{#1}%
+ \def\@glsxtr@mgls@or@gls@gcs{#2}%
+ \@ifstar{\s@GlsXtrMglsOrGls}%
+ {%
+ \@ifnextchar+{\@firstoftwo{\p@GlsXtrMglsOrGls}}%
+ {%
+ \ifdefempty\@gls@alt@hyp@opt@char\@GlsXtrMglsOrGls\alt@GlsXtrMglsOrGls
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\alt@GlsXtrMglsOrGls}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\alt@GlsXtrMglsOrGls}{
+ \expandafter\@ifnextchar\@gls@alt@hyp@opt@char
+ {\@firstoftwo{\@alt@GlsXtrMglsOrGls}}{\@GlsXtrMglsOrGls}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@GlsXtrMglsOrGls}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@GlsXtrMglsOrGls}[2][]{%
+ \glsxtrifmulti{#2}%
+ {\@glsxtr@mgls@or@gls@mcs[#1]{#2}}%
+ {\@glsxtr@mgls@or@gls@gcs[#1]{#2}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\s@GlsXtrMglsOrGls}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\s@GlsXtrMglsOrGls}[2][]{%
+ \glsxtrifmulti{#2}%
+ {\@glsxtr@mgls@or@gls@mcs*[#1]{#2}}%
+ {\@glsxtr@mgls@or@gls@gcs*[#1]{#2}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\p@GlsXtrMglsOrGls}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\p@GlsXtrMglsOrGls}[2][]{%
+ \glsxtrifmulti{#2}%
+ {\@glsxtr@mgls@or@gls@mcs+[#1]{#2}}%
+ {\@glsxtr@mgls@or@gls@gcs+[#1]{#2}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@alt@GlsXtrMglsOrGls}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\@alt@GlsXtrMglsOrGls}[2][]{%
+ \glsxtrifmulti{#2}%
+ {\expandafter\@glsxtr@mgls@or@gls@mcs\@gls@alt@hyp@opt@char[#1]{#2}}%
+ {\expandafter\@glsxtr@mgls@or@gls@gcs\@gls@alt@hyp@opt@char[#1]{#2}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mgls}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{mgls}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% Use \cs{gls} for all elements.
+% \begin{macrocode}
+\glsxtr@newmgls{mgls}{\@gls@}{\@gls@}{\@gls@}{\@gls@}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglspl}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{mglspl}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% Use \cs{glspl} for all elements.
+% \begin{macrocode}
+\glsxtr@newmgls{mglspl}{\@glspl@}{\@glspl@}{\@glspl@}{\@glspl@}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsmainpl}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{mglsmainpl}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% Only use \cs{glspl} for the main element, otherwise use \cs{gls}.
+% \begin{macrocode}
+\glsxtr@newmgls{mglsmainpl}{\@gls@}{\@gls@}{\@glspl@}{\@glspl@}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Mgls}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{Mgls}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+%Use \cs{Gls} for first element and \cs{gls} for others.
+% \begin{macrocode}
+\glsxtr@newmgls{Mgls}{\@Gls@}{\@gls@}{\@Gls@}{\@gls@}%
+\glsmfuaddmap{\mgls}{\Mgls}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Mglspl}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{Mglspl}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+%Use \cs{Glspl} for first element and \cs{glspl} for others.
+% \begin{macrocode}
+\glsxtr@newmgls{Mglspl}{\@Glspl@}{\@glspl@}{\@Glspl@}{\@glspl@}%
+\glsmfuaddmap{\mglspl}{\Mglspl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Mglsmainpl}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{Mglsmainpl}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+%Upper case the first element, no case change for others.
+%Use plural for the main element only.
+% \begin{macrocode}
+\glsxtr@newmgls{Mglsmainpl}{\@Gls@}{\@gls@}{\@Glspl@}{\@glspl@}%
+\glsmfuaddmap{\mglsmainpl}{\Mglsmainpl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\MGls}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{MGls}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+%Use \cs{Gls} for all elements.
+% \begin{macrocode}
+\glsxtr@newmgls{MGls}{\@Gls@}{\@Gls@}{\@Gls@}{\@Gls@}%
+\glsmfublocker{\MGls}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\MGlspl}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{MGlspl}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+%Use \cs{Glspl} for all elements.
+% \begin{macrocode}
+\glsxtr@newmgls{MGlspl}{\@Glspl@}{\@Glspl@}{\@Glspl@}{\@Glspl@}%
+\glsmfublocker{\MGlspl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\MGlsmainpl}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{MGlsmainpl}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+%Start all elements with upper case. Only use plural for main
+%element.
+% \begin{macrocode}
+\glsxtr@newmgls{MGlsmainpl}{\@Gls@}{\@Gls@}{\@Glspl@}{\@Glspl@}%
+\glsmfublocker{\MGlsmainpl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\MGLS}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{MGLS}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+%Use \cs{GLS} for all elements.
+% \begin{macrocode}
+\glsxtr@newmgls{MGLS}{\@GLS@}{\@GLS@}{\@GLS@}{\@GLS@}%
+\glsmfublocker{\MGLS}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\MGLSpl}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{MGLSpl}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+%Use \cs{GLSpl} for all elements.
+% \begin{macrocode}
+\glsxtr@newmgls{MGLSpl}{\@GLSpl@}{\@GLSpl@}{\@GLSpl@}{\@GLSpl@}%
+\glsmfublocker{\MGLSpl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\MGLSmainpl}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{MGLSmainpl}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+%Upper case all elements. Only use plural for main element.
+% \begin{macrocode}
+\glsxtr@newmgls{MGLSmainpl}{\@GLS@}{\@GLS@}{\@GLSpl@}{\@GLSpl@}%
+\glsmfublocker{\MGLSmainpl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glslongortext@}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\def\@glslongortext#1#2[#3]{%
+ \ifglshaslong{#2}{\@glsxtrlong{#1}{#2}[#3]}{\@glstext@{#1}{#2}[#3]}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsshortortext@}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\def\@glsshortortext#1#2[#3]{%
+ \ifglshasshort{#2}{\@glsxtrshort{#1}{#2}[#3]}{\@glstext@{#1}{#2}[#3]}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsfullorfirst@}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\def\@glsfullorfirst#1#2[#3]{%
+ \ifglshasshort{#2}{\@glsxtr@full{#1}{#2}[#3]}{\@glsfirst@{#1}{#2}[#3]}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@Glslongortext@}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\def\@Glslongortext#1#2[#3]{%
+ \ifglshaslong{#2}{\@Glsxtrlong{#1}{#2}[#3]}{\@Glstext@{#1}{#2}[#3]}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@Glsshortortext@}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\def\@Glsshortortext#1#2[#3]{%
+ \ifglshasshort{#2}{\@Glsxtrshort{#1}{#2}[#3]}{\@Glstext@{#1}{#2}[#3]}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@Glsfullorfirst@}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\def\@Glsfullorfirst#1#2[#3]{%
+ \ifglshasshort{#2}{\@Glsxtr@full{#1}{#2}[#3]}{\@Glsfirst@{#1}{#2}[#3]}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsshort}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{mglsshort}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% Use short or text for all elements.
+% \begin{macrocode}
+\glsxtr@newmgls{mglsshort}%
+{\@glsshortortext}{\@glsshortortext}{\@glsshortortext}{\@glsshortortext}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglslong}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{mglslong}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% Use long or text for all elements.
+% \begin{macrocode}
+\glsxtr@newmgls{mglslong}%
+{\@glslongortext}{\@glslongortext}{\@glslongortext}{\@glslongortext}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsfull}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{mglsfull}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% Use full or first for all elements.
+% \begin{macrocode}
+\glsxtr@newmgls{mglsfull}%
+{\@glsfullorfirst}{\@glsfullorfirst}{\@glsfullorfirst}{\@glsfullorfirst}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Mglsshort}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{Mglsshort}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% Use short or text for all elements with initial cap on first element.
+% \begin{macrocode}
+\glsxtr@newmgls{Mglsshort}%
+{\@Glsshortortext}{\@glsshortortext}{\@Glsshortortext}{\@glsshortortext}%
+\glsmfuaddmap{\mglsshort}{\Mglsshort}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Mglslong}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{Mglslong}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% Use long or text for all elements with initial cap on first
+% element.
+% \begin{macrocode}
+\glsxtr@newmgls{Mglslong}%
+{\@Glslongortext}{\@glslongortext}{\@Glslongortext}{\@glslongortext}%
+\glsmfuaddmap{\mglslong}{\Mglslong}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Mglsfull}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{Mglsfull}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% Use full or first for all elements with initial cap on first
+% element.
+% \begin{macrocode}
+\glsxtr@newmgls{Mglsfull}%
+{\@Glsfullorfirst}{\@glsfullorfirst}{\@Glsfullorfirst}{\@glsfullorfirst}%
+\glsmfuaddmap{\mglsfull}{\Mglsfull}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsname}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{mglsname}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% Use name for all elements.
+% \begin{macrocode}
+\glsxtr@newmgls{mglsname}%
+ {\@glsname@}{\@glsname@}{\@glsname@}{\@glsname@}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Mglsname}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{Mglsname}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% Use name for all elements with initial cap on first
+% element.
+% \begin{macrocode}
+\glsxtr@newmgls{Mglsname}%
+ {\@Glsname@}{\@glsname@}{\@Glsname@}{\@glsname@}%
+\glsmfuaddmap{\mglsname}{\Mglsname}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\MGlsname}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{MGlsname}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% Use name for all elements with initial cap on all
+% elements.
+% \begin{macrocode}
+\glsxtr@newmgls{MGlsname}%
+ {\@Glsname@}{\@Glsname@}{\@Glsname@}{\@Glsname@}%
+\glsmfublocker{\MGlsname}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glssymbolorgls}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\def\@glssymbolorgls#1#2[#3]{%
+ \ifglshassymbol{#2}{\@glssymbol@{#1}{#2}[#3]}{\@gls@{#1}{#2}[#3]}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glssymbolorGls}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\def\@glssymbolorGls#1#2[#3]{%
+ \ifglshassymbol{#2}{\@glssymbol@{#1}{#2}[#3]}{\@Gls@{#1}{#2}[#3]}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglssymbol}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{mglssymbol}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% Use \cs{glssymbol} if the \gloskey{symbol} key is set otherwise
+% use \cs{gls}.
+% \begin{macrocode}
+\glsxtr@newmgls{mglssymbol}%
+ {\@glssymbolorgls}{\@glssymbolorgls}{\@glssymbolorgls}{\@glssymbolorgls}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Mglssymbol}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{Mglssymbol}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% As above but initial the first element if it's not a symbol.
+% \begin{macrocode}
+\glsxtr@newmgls{Mglssymbol}%
+ {\@glssymbolorGls}{\@glssymbolorgls}{\@glssymbolorGls}{\@glssymbolorgls}%
+\glsmfuaddmap{\mglssymbol}{\Mglssymbol}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\MGlssymbol}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{MGlssymbol}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% As above but initial each element if it's not a symbol.
+% \begin{macrocode}
+\glsxtr@newmgls{MGlssymbol}%
+ {\@glssymbolorGls}{\@glssymbolorGls}{\@glssymbolorGls}{\@glssymbolorGls}%
+\glsmfublocker{\MGlssymbol}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsfield}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand{\mglsfield}{useri}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\@glsfieldorgls}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\def\@glsfieldorgls#1#2[#3]{%
+ \glsxtrifhasfield{\mglsfield}{#2}%
+ {\@glsdisp[#1]{#2}{\glscurrentfieldvalue#3}}%
+ {\@gls@{#1}{#2}[#3]}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@Glsfieldorgls}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\def\@Glsfieldorgls#1#2[#3]{%
+ \glsxtrifhasfield{\mglsfield}{#2}%
+ {\@glsdisp[#1]{#2}{%
+ \expandafter\glssentencecase\expandafter{\glscurrentfieldvalue#3}}}%
+ {\@Gls@{#1}{#2}[#3]}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mglsusefield}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{mglsusefield}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% Use the field given by \cs{mglsfield}.
+% \begin{macrocode}
+\glsxtr@newmgls{mglsusefield}%
+ {\@glsfieldorgls}{\@glsfieldorgls}{\@glsfieldorgls}{\@glsfieldorgls}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Mglsusefield}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{Mglsusefield}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% As above but use initial cap for first element only.
+% \begin{macrocode}
+\glsxtr@newmgls{Mglsusefield}%
+ {\@Glsfieldorgls}{\@glsfieldorgls}{\@Glsfieldorgls}{\@glsfieldorgls}%
+\glsmfuaddmap{\mglsusefield}{\Mglsusefield}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\MGlsusefield}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{MGlsusefield}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% As above but use initial cap for all elements.
+% \begin{macrocode}
+\glsxtr@newmgls{MGlsusefield}%
+ {\@Glsfieldorgls}{\@Glsfieldorgls}{\@Glsfieldorgls}{\@Glsfieldorgls}%
+\glsmfublocker{\MGlsusefield}
+% \end{macrocode}
+%\end{macro}
+%
+% Use commands provided by \sty{glossaries-prefix} if it has been
+% loaded.
+%\begin{macro}{\mpglsWarning}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\newcommand*{\mpglsWarning}{%
+ \GlossariesExtraWarning{glossaries-prefix.sty is required for
+ \string\mpgls\space family of commands}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@pglsorgls}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\def\@pglsorgls#1#2[#3]{%
+ \ifdef\@pgls@{\@pgls@{#1}{#2}[#3]}{\mpglsWarning\@gls@{#1}{#2}[#3]}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@pglsorglspl}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\def\@pglsorglspl#1#2[#3]{%
+ \ifdef\@pglspl@{\@pglspl@{#1}{#2}[#3]}{\mpglsWarning\@glspl@{#1}{#2}[#3]}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@Pglsorgls}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\def\@Pglsorgls#1#2[#3]{%
+ \ifdef\@Pgls@{\@Pgls@{#1}{#2}[#3]}{\mpglsWarning\@Gls@{#1}{#2}[#3]}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@pglsorglspl}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\def\@pglsorglspl#1#2[#3]{%
+ \ifdef\@pglspl@{\@pglspl@{#1}{#2}[#3]}{\mpglsWarning\@glspl@{#1}{#2}[#3]}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@Pglsorglspl}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\def\@Pglsorglspl#1#2[#3]{%
+ \ifdef\@Pglspl@{\@Pglspl@{#1}{#2}[#3]}{\mpglsWarning\@Glspl@{#1}{#2}[#3]}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@PGLSorgls}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\def\@PGLSorgls#1#2[#3]{%
+ \ifdef\@PGLS@{\@PGLS@{#1}{#2}[#3]}{\mpglsWarning\@GLS@{#1}{#2}[#3]}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@PGLSorglspl}
+%\changes{1.48}{2021-11-22}{new}
+% \begin{macrocode}
+\def\@PGLSorglspl#1#2[#3]{%
+ \ifdef\@PGLSpl@{\@PGLSpl@{#1}{#2}[#3]}{\mpglsWarning\@GLSpl@{#1}{#2}[#3]}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mpgls}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{mpgls}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% Use \cs{pgls} for the first element and \cs{gls} for the remainder.
+% \begin{macrocode}
+\glsxtr@newmgls{mpgls}{\@pglsorgls@}{\@gls@}{\@pglsorgls@}{\@gls@}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mpglspl}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{mpglspl}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% Use \cs{pglspl} for the first element and \cs{glspl} for the remainder.
+% \begin{macrocode}
+\glsxtr@newmgls{mpglspl}{\@pglsorglspl@}{\@glspl@}{\@pglsorglspl@}{\@glspl@}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\mpglsmainpl}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{mpglsmainpl}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+%Only use plural for main element and only use prefixing command for
+%first element.
+% \begin{macrocode}
+\glsxtr@newmgls{mpglsmainpl}{\@pglsorgls@}{\@gls@}{\@pglsorglspl@}{\@glspl@}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Mpgls}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{Mpgls}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% Use \cs{Pgls} for the first element and \cs{gls} for the remainder.
+% \begin{macrocode}
+\glsxtr@newmgls{Mpgls}{\@Pglsorgls@}{\@gls@}{\@Pglsorgls@}{\@gls@}%
+\glsmfuaddmap{\mpgls}{\Mpgls}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Mpglspl}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{Mpglspl}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% Use \cs{Pglspl} for the first element and \cs{glspl} for the remainder.
+% \begin{macrocode}
+\glsxtr@newmgls{Mpglspl}{\@Pglsorglspl@}{\@glspl@}{\@Pglsorglspl@}{\@glspl@}%
+\glsmfuaddmap{\mpglspl}{\Mpglspl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Mpglsmainpl}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{Mpglsmainpl}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+%Only use plural for main element and only use first letter
+%uppercase prefixing command for first element.
+% \begin{macrocode}
+\glsxtr@newmgls{Mpglsmainpl}{\@Pglsorgls@}{\@gls@}{\@Pglsorglspl@}{\@glspl@}%
+\glsmfuaddmap{\mpglsmainpl}{\Mpglsmainpl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\MPGls}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{MPGls}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+%Use \cs{Pgls} for the first element and \cs{Gls} for the remainder.
+% \begin{macrocode}
+\glsxtr@newmgls{MPGls}{\@Pglsorgls@}{\@Gls@}{\@Pglsorgls@}{\@Gls@}%
+\glsmfublocker{\MPGls}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\MPGlspl}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{MPGlspl}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% Use \cs{Pglspl} for the first element and \cs{Glspl} for the remainder.
+% \begin{macrocode}
+\glsxtr@newmgls{MPGlspl}{\@Pglsorglspl@}{\@Glspl@}{\@Pglsorglspl@}{\@Glspl@}%
+\glsmfublocker{\MPGlspl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\MPGlsmainpl}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{MPGlsmainpl}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+%Only use plural for main element and first letter uppercase all
+%elements.
+% \begin{macrocode}
+\glsxtr@newmgls{MPGlsmainpl}{\@Pglsorgls@}{\@Gls@}{\@Pglsorglspl@}{\@Glspl@}%
+\glsmfublocker{\MPGlsmainpl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\MPGLS}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{MPGLS}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% Use \cs{PGLS} for the first element and \cs{GLS} for the remainder.
+% \begin{macrocode}
+\glsxtr@newmgls{MPGLS}{\@PGLSorgls@}{\@GLS@}{\@PGLSorgls@}{\@GLS@}%
+\glsmfublocker{\MPGLS}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\MPGLSpl}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{MPGLSpl}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% Use \cs{PGLSpl} for the first element and \cs{GLSpl} for the remainder.
+% \begin{macrocode}
+\glsxtr@newmgls{MPGLSpl}{\@PGLSorglspl@}{\@GLSpl@}{\@PGLSorglspl@}{\@GLSpl@}%
+\glsmfublocker{\MPGLSpl}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\MPGLSmainpl}
+%\changes{1.48}{2021-11-22}{new}
+%\begin{definition}
+%\cs{MPGLSmainpl}\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+%Only use plural for main element and uppercase all elements.
+% \begin{macrocode}
+\glsxtr@newmgls{MPGLSmainpl}{\@PGLSorgls@}{\@GLS@}{\@PGLSorglspl@}{\@GLSpl@}%
+\glsmfublocker{\MPGLSmainpl}
+% \end{macrocode}
+%\end{macro}
+%
+%Not currently implementing any other variations.
+%
+%\subsection{Multi-Lingual Support}
+% Add the facility to load language modules, if they are installed,
+% but none are provided with this package.
+%
+%\begin{macro}{\RequireGlossariesExtraLang}
+%\changes{0.5.3}{2015-12-09}{new}
+% \begin{macrocode}
+\newcommand*{\RequireGlossariesExtraLang}[1]{%
+ \@ifundefined{ver@glossariesxtr-#1.ldf}{\input{glossariesxtr-#1.ldf}}{}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\ProvidesGlossariesExtraLang}
+%\changes{0.5.3}{2015-12-09}{new}
+% \begin{macrocode}
+\newcommand*{\ProvidesGlossariesExtraLang}[1]{%
+ \ProvidesFile{glossariesxtr-#1.ldf}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+% Load any required language modules that are available. This
+% doesn't generate any warning if none are found, since they're not
+% essential. (The only command that really needs defining for the
+% document is \cs{abbreviationsname}, which can simply be
+% redefined. However, with \app{bib2gls} it might be useful to
+% provide custom rules for a particular locale.)
+%
+%\begin{macro}{\glsxtr@loaddialect}
+%The dialect label should be stored in \cs{this@dialect}
+%before using this command.
+%\changes{1.27}{2018-02-26}{new}
+% \begin{macrocode}
+\newcommand{\glsxtr@loaddialect}{%
+ \IfTrackedLanguageFileExists{\this@dialect}%
+ {glossariesxtr-}% prefix
+ {.ldf}%
+ {%
+ \RequireGlossariesExtraLang{\CurrentTrackedTag}%
+ }%
+ {}% not found
+% \end{macrocode}
+% If \sty{glossaries-extra-bib2gls} has been loaded,
+% \cs{@glsxtrdialecthook} will check for the associated script,
+% otherwise it will do nothing.
+% \begin{macrocode}
+ \@glsxtrdialecthook
+}
+% \end{macrocode}
+%\end{macro}
+% \begin{macrocode}
+\@ifpackageloaded{tracklang} {%
+ \AnyTrackedLanguages
+ {%
+ \ForEachTrackedDialect{\this@dialect}{\glsxtr@loaddialect}%
+ }%
+ {}%
+} {}
+% \end{macrocode}
+% The style needs to be set at the end to ensure that
+% \cs{setglossarystyle} has been redefined and extra style commands
+% have been defined.
+% Load \sty{glossaries-extra-stylemods} if required.
+% \begin{macrocode}
+\@glsxtr@redefstyles
+% \end{macrocode}
+% and set the style:
+% \begin{macrocode}
+\@glsxtr@do@style
+% \end{macrocode}
+%\iffalse
+% \begin{macrocode}
+%</glossaries-extra.sty>
+% \end{macrocode}
+%\fi
+%\iffalse
+% \begin{macrocode}
+%<*glossaries-extra-abbrstyles.def>
+% \end{macrocode}
+%\fi
+%\section{Predefined Abbreviation Styles (glossaries-extra-abbrstyles.def)}
+%\changes{1.49}{??}{added glossaries-extra-abbrstyles.def}
+% \begin{macrocode}
+\ProvidesFile{glossaries-extra-abbrstyles.def}[2022/06/16 v1.48b (NLCT)]
+% \end{macrocode}
+%This file contains the predefined abbreviation styles.
+%Some helper commands first.
%
%\begin{macro}{\glsxtrlongshortname}
%\changes{1.25}{2017-11-24}{new}
% \begin{macrocode}
\newcommand*{\glsxtrlongshortname}{%
- \protect\glsabbrvfont{\the\glsshorttok}%
+ \glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
}
% \end{macrocode}
%\end{macro}
%
+%Provide convenient wrappers for common formats.
+%\begin{macro}{\glsxtrlongformat}
+%\begin{definition}
+%\cs{glsxtrlongformat}\marg{label}\marg{insert}\marg{longfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrlongformat}[3]{%
+% \end{macrocode}
+%Don't add inner formatting if markwords attribute set as the inner formatting
+%is implemented within \cs{glsxtrword} and \cs{glsxtrwordsep}.
+% \begin{macrocode}
+ \glsifattribute{#1}{markwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\glsaccesslong{#1}\glsxtrgenentrytextfmt{#2}}%
+ \else
+ #3{\glsaccesslong{#1}}\glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
+ {%
+ \ifglsxtrinsertinside
+ #3{\glsaccessfmtlong{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ #3{\glsaccessfmtlong{}{\glsxtrgenentrytextfmt}{#1}}%
+ \glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrlongplformat}
+%\begin{definition}
+%\cs{glsxtrlongplformat}\marg{label}\marg{insert}\marg{longfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrlongplformat}[3]{%
+ \glsifattribute{#1}{markwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\glsaccesslongpl{#1}\glsxtrgenentrytextfmt{#2}}%
+ \else
+ #3{\glsaccesslongpl{#1}}\glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
+ {%
+ \ifglsxtrinsertinside
+ #3{\glsaccessfmtlongpl{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ #3{\glsaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{#1}}%
+ \glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrlongformat}
+%\begin{definition}
+%\cs{Glsxtrlongformat}\marg{label}\marg{insert}\marg{longfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\Glsxtrlongformat}[3]{%
+ \glsifattribute{#1}{markwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\Glsaccesslong{#1}\glsxtrgenentrytextfmt{#2}}%
+ \else
+ #3{\Glsaccesslong{#1}}\glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
+ {%
+ \ifglsxtrinsertinside
+ #3{\Glsaccessfmtlong{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ #3{\Glsaccessfmtlong{}{\glsxtrgenentrytextfmt}{#1}}%
+ \glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrlongplformat}
+%\begin{definition}
+%\cs{Glsxtrlongplformat}\marg{label}\marg{insert}\marg{longfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\Glsxtrlongplformat}[3]{%
+ \glsifattribute{#1}{markwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\Glsaccesslongpl{#1}\glsxtrgenentrytextfmt{#2}}%
+ \else
+ #3{\Glsaccesslongpl{#1}}\glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
+ {%
+ \ifglsxtrinsertinside
+ #3{\Glsaccessfmtlongpl{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ #3{\Glsaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{#1}}%
+ \glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrlongformat}
+%\begin{definition}
+%\cs{GLSxtrlongformat}\marg{label}\marg{insert}\marg{longfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtrlongformat}[3]{%
+ \glsifattribute{#1}{markwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\GLSaccesslong{#1}\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ #3{\GLSaccesslong{#1}}\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+ {%
+ \ifglsxtrinsertinside
+ #3{\GLSaccessfmtlong{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ #3{\GLSaccessfmtlong{}{\glsxtrgenentrytextfmt}{#1}}%
+ \mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrlongplformat}
+%\begin{definition}
+%\cs{GLSxtrlongplformat}\marg{label}\marg{insert}\marg{longfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtrlongplformat}[3]{%
+ \glsifattribute{#1}{markwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\GLSaccesslongpl{#1}\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ #3{\GLSaccesslongpl{#1}}\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+ {%
+ \ifglsxtrinsertinside
+ #3{\GLSaccessfmtlongpl{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ #3{\GLSaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{#1}}%
+ \mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrlongformatgrp}
+%\begin{definition}
+%\cs{glsxtrlongformatgrp}\marg{label}\marg{insert}\marg{longfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+%Add grouping around insert.
+% \begin{macrocode}
+\newcommand*{\glsxtrlongformatgrp}[3]{%
+ \glsifattribute{#1}{markwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\glsaccesslong{#1}{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ #3{\glsaccesslong{#1}}{\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+ {%
+ #3{\glsaccessfmtlong{}{\glsxtrgenentrytextfmt}{#1}}%
+ \ifglsxtrinsertinside
+ {#3{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ {\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrlongplformatgrp}
+%\begin{definition}
+%\cs{glsxtrlongformatplgrp}\marg{label}\marg{insert}\marg{longfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+%Add grouping around insert.
+% \begin{macrocode}
+\newcommand*{\glsxtrlongplformatgrp}[3]{%
+ \glsifattribute{#1}{markwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\glsaccesslongpl{#1}{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ #3{\glsaccesslongpl{#1}}{\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+ {%
+ #3{\glsaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{#1}}%
+ \ifglsxtrinsertinside
+ {#3{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ {\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrlongformatgrp}
+%\begin{definition}
+%\cs{Glsxtrlongformatgrp}\marg{label}\marg{insert}\marg{longfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+%Add grouping around insert.
+% \begin{macrocode}
+\newcommand*{\Glsxtrlongformatgrp}[3]{%
+ \glsifattribute{#1}{markwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\Glsaccesslong{#1}{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ #3{\Glsaccesslong{#1}}{\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+ {%
+ #3{\Glsaccessfmtlong{}{\glsxtrgenentrytextfmt}{#1}}%
+ \ifglsxtrinsertinside
+ {#3{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ {\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrlongplformatgrp}
+%\begin{definition}
+%\cs{Glsxtrlongformatplgrp}\marg{label}\marg{insert}\marg{longfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+%Add grouping around insert.
+% \begin{macrocode}
+\newcommand*{\Glsxtrlongplformatgrp}[3]{%
+ \glsifattribute{#1}{markwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\Glsaccesslongpl{#1}{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ #3{\Glsaccesslongpl{#1}}{\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+ {%
+ #3{\Glsaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{#1}}%
+ \ifglsxtrinsertinside
+ {#3{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ {\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrlongformatgrp}
+%\begin{definition}
+%\cs{GLSxtrlongformatgrp}\marg{label}\marg{insert}\marg{longfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+%Add grouping around insert.
+% \begin{macrocode}
+\newcommand*{\GLSxtrlongformatgrp}[3]{%
+ \glsifattribute{#1}{markwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\GLSaccesslong{#1}{\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}}%
+ \else
+ #3{\GLSaccesslong{#1}}{\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}%
+ \fi
+ }%
+ {%
+ #3{\GLSaccessfmtlong{}{\glsxtrgenentrytextfmt}{#1}}%
+ \ifglsxtrinsertinside
+ {\mfirstucMakeUppercase{#3{\glsxtrgenentrytextfmt{#2}}}}%
+ \else
+ {\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrlongplformatgrp}
+%\begin{definition}
+%\cs{GLSxtrlongformatplgrp}\marg{label}\marg{insert}\marg{longfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+%Add grouping around insert.
+% \begin{macrocode}
+\newcommand*{\GLSxtrlongplformatgrp}[3]{%
+ \glsifattribute{#1}{markwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\GLSaccesslongpl{#1}{\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}}%
+ \else
+ #3{\GLSaccesslongpl{#1}}{\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}%
+ \fi
+ }%
+ {%
+ #3{\GLSaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{#1}}%
+ \ifglsxtrinsertinside
+ {\mfirstucMakeUppercase{#3{\glsxtrgenentrytextfmt{#2}}}}%
+ \else
+ {\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrshortformat}
+%\begin{definition}
+%\cs{glsxtrshortformat}\marg{label}\marg{insert}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrshortformat}[3]{%
+ \glsifattribute{#1}{markshortwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\glsaccessshort{#1}\glsxtrgenentrytextfmt{#2}}%
+ \else
+ #3{\glsaccessshort{#1}}\glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
+ {%
+ \ifglsxtrinsertinside
+ #3{\glsaccessfmtshort{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ #3{\glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{#1}}%
+ \glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrshortplformat}
+%\begin{definition}
+%\cs{glsxtrshortplformat}\marg{label}\marg{insert}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrshortplformat}[3]{%
+ \glsifattribute{#1}{markshortwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\glsaccessshortpl{#1}\glsxtrgenentrytextfmt{#2}}%
+ \else
+ #3{\glsaccessshortpl{#1}}\glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
+ {%
+ \ifglsxtrinsertinside
+ #3{\glsaccessfmtshortpl{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ #3{\glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{#1}}%
+ \glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrshortformat}
+%\begin{definition}
+%\cs{Glsxtrshortformat}\marg{label}\marg{insert}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\Glsxtrshortformat}[3]{%
+ \glsifattribute{#1}{markshortwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\Glsaccessshort{#1}\glsxtrgenentrytextfmt{#2}}%
+ \else
+ #3{\Glsaccessshort{#1}}\glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
+ {%
+ \ifglsxtrinsertinside
+ #3{\Glsaccessfmtshort{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ #3{\Glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{#1}}%
+ \glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrshortplformat}
+%\begin{definition}
+%\cs{Glsxtrshortplformat}\marg{label}\marg{insert}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\Glsxtrshortplformat}[3]{%
+ \glsifattribute{#1}{markshortwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\Glsaccessshortpl{#1}\glsxtrgenentrytextfmt{#2}}%
+ \else
+ #3{\Glsaccessshortpl{#1}}\glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
+ {%
+ \ifglsxtrinsertinside
+ #3{\Glsaccessfmtshortpl{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ #3{\Glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{#1}}%
+ \glsxtrgenentrytextfmt{#2}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrshortformat}
+%\begin{definition}
+%\cs{GLSxtrshortformat}\marg{label}\marg{insert}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtrshortformat}[3]{%
+ \glsifattribute{#1}{markshortwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\GLSaccessshort{#1}\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ #3{\GLSaccessshort{#1}}\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+ {%
+ \ifglsxtrinsertinside
+ #3{\GLSaccessfmtshort{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ #3{\GLSaccessfmtshort{}{\glsxtrgenentrytextfmt}{#1}}%
+ \mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrshortplformat}
+%\begin{definition}
+%\cs{GLSxtrshortplformat}\marg{label}\marg{insert}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtrshortplformat}[3]{%
+ \glsifattribute{#1}{markshortwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\GLSaccessshortpl{#1}\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ #3{\GLSaccessshortpl{#1}}\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+ {%
+ \ifglsxtrinsertinside
+ #3{\GLSaccessfmtshortpl{#2}{\glsxtrgenentrytextfmt}{#1}}%
+ \else
+ #3{\GLSaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{#1}}%
+ \mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrshortformatgrp}
+%\begin{definition}
+%\cs{glsxtrshortformatgrp}\marg{label}\marg{insert}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+%Add grouping around insert.
+% \begin{macrocode}
+\newcommand*{\glsxtrshortformatgrp}[3]{%
+ \glsifattribute{#1}{markshortwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\glsaccessshort{#1}{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ #3{\glsaccessshort{#1}}{\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+ {%
+ #3{\glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{#1}}%
+ \ifglsxtrinsertinside
+ {#3{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ {\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrshortplformatgrp}
+%\begin{definition}
+%\cs{glsxtrshortplformatgrp}\marg{label}\marg{insert}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+%Add grouping around insert.
+% \begin{macrocode}
+\newcommand*{\glsxtrshortplformatgrp}[3]{%
+ \glsifattribute{#1}{markshortwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\glsaccessshortpl{#1}{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ #3{\glsaccessshortpl{#1}}{\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+ {%
+ #3{\glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{#1}}%
+ \ifglsxtrinsertinside
+ {#3{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ {\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrshortformatgrp}
+%\begin{definition}
+%\cs{Glsxtrshortformatgrp}\marg{label}\marg{insert}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+%Add grouping around insert.
+% \begin{macrocode}
+\newcommand*{\Glsxtrshortformatgrp}[3]{%
+ \glsifattribute{#1}{markshortwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\Glsaccessshort{#1}{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ #3{\Glsaccessshort{#1}}{\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+ {%
+ #3{\Glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{#1}}%
+ \ifglsxtrinsertinside
+ {#3{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ {\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrshortplformatgrp}
+%\begin{definition}
+%\cs{Glsxtrshortplformatgrp}\marg{label}\marg{insert}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+%Add grouping around insert.
+% \begin{macrocode}
+\newcommand*{\Glsxtrshortplformatgrp}[3]{%
+ \glsifattribute{#1}{markshortwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\Glsaccessshortpl{#1}{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ #3{\Glsaccessshortpl{#1}}{\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+ {%
+ #3{\Glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{#1}}%
+ \ifglsxtrinsertinside
+ {#3{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ {\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrshortformatgrp}
+%\begin{definition}
+%\cs{GLSxtrshortformatgrp}\marg{label}\marg{insert}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+%Add grouping around insert.
+% \begin{macrocode}
+\newcommand*{\GLSxtrshortformatgrp}[3]{%
+ \glsifattribute{#1}{markshortwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\GLSaccessshort{#1}{\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}}%
+ \else
+ #3{\GLSaccessshort{#1}}{\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}%
+ \fi
+ }%
+ {%
+ #3{\GLSaccessfmtshort{}{\glsxtrgenentrytextfmt}{#1}}%
+ \ifglsxtrinsertinside
+ {\mfirstucMakeUppercase{#3{\glsxtrgenentrytextfmt{#2}}}}%
+ \else
+ {\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrshortplformatgrp}
+%\begin{definition}
+%\cs{GLSxtrshortplformatgrp}\marg{label}\marg{insert}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+%Add grouping around insert.
+% \begin{macrocode}
+\newcommand*{\GLSxtrshortplformatgrp}[3]{%
+ \glsifattribute{#1}{markshortwords}{true}%
+ {%
+ \ifglsxtrinsertinside
+ #3{\GLSaccessshortpl{#1}{\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}}%
+ \else
+ #3{\GLSaccessshortpl{#1}}{\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}%
+ \fi
+ }%
+ {%
+ #3{\GLSaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{#1}}%
+ \ifglsxtrinsertinside
+ {\mfirstucMakeUppercase{#3{\glsxtrgenentrytextfmt{#2}}}}%
+ \else
+ {\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}%
+ \fi
+ }%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrlongshortformat}
+%\begin{definition}
+%\cs{glsxtrlongshortformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrlongshortformat}[4]{%
+ \glsxtrlongformat{#1}{#2}{#3}%
+ \glsxtrfullsep{#1}%
+ \glsxtrparen{\glsxtrshortformat{#1}{}{#4}}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrlongshortplformat}
+%\begin{definition}
+%\cs{glsxtrlongshortplformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrlongshortplformat}[4]{%
+ \glsxtrlongplformat{#1}{#2}{#3}%
+ \glsxtrfullsep{#1}%
+ \glsxtrparen{\glsxtrshortplformat{#1}{}{#4}}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrlongshortformat}
+%\begin{definition}
+%\cs{Glsxtrlongshortformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\Glsxtrlongshortformat}[4]{%
+ \Glsxtrlongformat{#1}{#2}{#3}%
+ \glsxtrfullsep{#1}%
+ \glsxtrparen{\glsxtrshortformat{#1}{}{#4}}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrlongshortplformat}
+%\begin{definition}
+%\cs{Glsxtrlongshortplformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\Glsxtrlongshortplformat}[4]{%
+ \Glsxtrlongplformat{#1}{#2}{#3}%
+ \glsxtrfullsep{#1}%
+ \glsxtrparen{\glsxtrshortplformat{#1}{}{#4}}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrlongshortformat}
+%\begin{definition}
+%\cs{GLSxtrlongshortformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtrlongshortformat}[4]{%
+ \GLSxtrlongformat{#1}{#2}{#3}%
+ \glsxtrfullsep{#1}%
+ \glsxtrparen{\GLSxtrshortformat{#1}{}{#4}}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrlongshortplformat}
+%\begin{definition}
+%\cs{GLSxtrlongshortplformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtrlongshortplformat}[4]{%
+ \GLSxtrlongplformat{#1}{#2}{#3}%
+ \glsxtrfullsep{#1}%
+ \glsxtrparen{\GLSxtrshortplformat{#1}{}{#4}}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrshortlongformat}
+%\begin{definition}
+%\cs{glsxtrshortlongformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrshortlongformat}[4]{%
+ \glsxtrshortformat{#1}{#2}{#4}%
+ \glsxtrfullsep{#1}%
+ \glsxtrparen{\glsxtrlongformat{#1}{}{#3}}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrshortlongplformat}
+%\begin{definition}
+%\cs{glsxtrshortlongplformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrshortlongplformat}[4]{%
+ \glsxtrshortplformat{#1}{#2}{#4}%
+ \glsxtrfullsep{#1}%
+ \glsxtrparen{\glsxtrlongplformat{#1}{}{#3}}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrshortlongformat}
+%\begin{definition}
+%\cs{Glsxtrshortlongformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\Glsxtrshortlongformat}[4]{%
+ \Glsxtrshortformat{#1}{#2}{#4}%
+ \glsxtrfullsep{#1}%
+ \glsxtrparen{\glsxtrlongformat{#1}{}{#3}}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrshortlongplformat}
+%\begin{definition}
+%\cs{Glsxtrshortlongplformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\Glsxtrshortlongplformat}[4]{%
+ \Glsxtrshortplformat{#1}{#2}{#4}%
+ \glsxtrfullsep{#1}%
+ \glsxtrparen{\glsxtrlongplformat{#1}{}{#3}}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrshortlongformat}
+%\begin{definition}
+%\cs{GLSxtrshortlongformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtrshortlongformat}[4]{%
+ \GLSxtrshortformat{#1}{#2}{#4}%
+ \glsxtrfullsep{#1}%
+ \glsxtrparen{\GLSxtrlongformat{#1}{}{#3}}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrshortlongplformat}
+%\begin{definition}
+%\cs{GLSxtrshortlongplformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtrshortlongplformat}[4]{%
+ \GLSxtrshortplformat{#1}{#2}{#4}%
+ \glsxtrfullsep{#1}%
+ \glsxtrparen{\GLSxtrlongplformat{#1}{}{#3}}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrfootnotelongformat}
+%\begin{definition}
+%\cs{glsxtrfootnotelongformat}\marg{label}\marg{longfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrfootnotelongformat}[2]{%
+ \glsxtrlongformat{#1}{}{#2}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrfootnotelongplformat}
+%\begin{definition}
+%\cs{glsxtrfootnotelongplformat}\marg{label}\marg{longfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrfootnotelongplformat}[2]{%
+ \glsxtrlongplformat{#1}{}{#2}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrpostfootnotelongformat}
+%\begin{definition}
+%\cs{glsxtrpostfootnotelongformat}\marg{label}\marg{longfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrpostfootnotelongformat}{%
+ \glsxtrfootnotelongformat
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrpostusershortformat}
+%\begin{definition}
+%\cs{glsxtruserpostshortformat}\marg{label}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrpostusershortformat}[2]{%
+ \glsxtrifallcaps
+ {\GLSxtrusershortformat{#1}{#2}}%
+ {\glsxtrusershortformat{#1}{#2}}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrusershortformat}
+%\begin{definition}
+%\cs{glsxtrusershortformat}\marg{label}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrusershortformat}[2]{%
+ \glsxtruserparen{\glsxtrshortformat{#1}{}{#2}}{#1}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrusershortplformat}
+%\begin{definition}
+%\cs{glsxtrusershortplformat}\marg{label}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrusershortplformat}[2]{%
+ \glsxtruserparen{\glsxtrshortplformat{#1}{}{#2}}{#1}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrusershortformat}
+%\begin{definition}
+%\cs{GLSxtrusershortformat}\marg{label}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtrusershortformat}[2]{%
+ \GLSxtruserparen{\GLSxtrshortformat{#1}{}{#2}}{#1}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrusershortplformat}
+%\begin{definition}
+%\cs{GLSxtrusershortplformat}\marg{label}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtrusershortplformat}[2]{%
+ \GLSxtruserparen{\GLSxtrshortplformat{#1}{}{#2}}{#1}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrpostuserlongformat}
+%\begin{definition}
+%\cs{glsxtruserpostlongformat}\marg{label}\marg{longfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrpostuserlongformat}[2]{%
+ \glsxtrifallcaps
+ {\GLSxtruserlongformat{#1}{#2}}%
+ {\glsxtruserlongformat{#1}{#2}}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtruserlongformat}
+%\begin{definition}
+%\cs{glsxtruserlongformat}\marg{label}\marg{longfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtruserlongformat}[2]{%
+ \glsxtruserparen{\glsxtrlongformat{#1}{}{#2}}{#1}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtruserlongformat}
+%\begin{definition}
+%\cs{GLSxtruserlongformat}\marg{label}\marg{longfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtruserlongformat}[2]{%
+ \GLSxtruserparen{\GLSxtrlongformat{#1}{}{#2}}{#1}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtruserlongplformat}
+%\begin{definition}
+%\cs{glsxtruserlongplformat}\marg{label}\marg{longfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtruserlongplformat}[2]{%
+ \glsxtruserparen{\glsxtrlongplformat{#1}{}{#2}}{#1}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtruserlongplformat}
+%\begin{definition}
+%\cs{GLSxtruserlongplformat}\marg{label}\marg{longfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtruserlongplformat}[2]{%
+ \GLSxtruserparen{\GLSxtrlongplformat{#1}{}{#2}}{#1}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtruserlongshortformat}
+%\begin{definition}
+%\cs{glsxtruserlongshortformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtruserlongshortformat}[4]{%
+ \glsxtrlongformat{#1}{#2}{#3}%
+ \glsxtrusershortformat{#1}{#4}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtruserlongshortplformat}
+%\begin{definition}
+%\cs{glsxtruserlongshortplformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtruserlongshortplformat}[4]{%
+ \glsxtrlongplformat{#1}{#2}{#3}%
+ \glsxtrusershortplformat{#1}{#4}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtruserlongshortformat}
+%\begin{definition}
+%\cs{Glsxtruserlongshortformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\Glsxtruserlongshortformat}[4]{%
+ \Glsxtrlongformat{#1}{#2}{#3}%
+ \glsxtrusershortformat{#1}{#4}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtruserlongshortplformat}
+%\begin{definition}
+%\cs{Glsxtruserlongshortplformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\Glsxtruserlongshortplformat}[4]{%
+ \Glsxtrlongplformat{#1}{#2}{#3}%
+ \glsxtrusershortplformat{#1}{#4}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtruserlongshortformat}
+%\begin{definition}
+%\cs{GLSxtruserlongshortformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtruserlongshortformat}[4]{%
+ \GLSxtrlongformat{#1}{#2}{#3}%
+ \GLSxtrusershortformat{#1}{#4}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtruserlongshortplformat}
+%\begin{definition}
+%\cs{GLSxtruserlongshortplformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtruserlongshortplformat}[4]{%
+ \GLSxtrlongplformat{#1}{#2}{#3}%
+ \GLSxtrusershortplformat{#1}{#4}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrusershortlongformat}
+%\begin{definition}
+%\cs{glsxtrusershortlongformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrusershortlongformat}[4]{%
+ \glsxtrshortformat{#1}{#2}{#3}%
+ \glsxtruserlongformat{#1}{#4}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrusershortlongplformat}
+%\begin{definition}
+%\cs{glsxtrusershortlongplformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrusershortlongplformat}[4]{%
+ \glsxtrshortplformat{#1}{#2}{#3}%
+ \glsxtruserlongplformat{#1}{#4}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrusershortlongformat}
+%\begin{definition}
+%\cs{Glsxtrusershortlongformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\Glsxtrusershortlongformat}[4]{%
+ \Glsxtrshortformat{#1}{#2}{#3}%
+ \glsxtruserlongformat{#1}{#4}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\Glsxtrusershortlongplformat}
+%\begin{definition}
+%\cs{Glsxtrusershortlongplformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\Glsxtrusershortlongplformat}[4]{%
+ \Glsxtrshortplformat{#1}{#2}{#3}%
+ \glsxtruserlongplformat{#1}{#4}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrusershortlongformat}
+%\begin{definition}
+%\cs{GLSxtrusershortlongformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtrusershortlongformat}[4]{%
+ \GLSxtrshortformat{#1}{#2}{#3}%
+ \GLSxtruserlongformat{#1}{#4}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrusershortlongplformat}
+%\begin{definition}
+%\cs{GLSxtrusershortlongplformat}\marg{label}\marg{insert}\marg{longfmtcs}\marg{shortfmtcs}
+%\end{definition}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\GLSxtrusershortlongplformat}[4]{%
+ \GLSxtrshortplformat{#1}{#2}{#3}%
+ \GLSxtruserlongplformat{#1}{#4}%
+}%
+% \end{macrocode}
+%\end{macro}
+%
+%\subsection{Predefined Styles (Default Font)}
%\changes{1.17}{2017-08-09}{removed some inconsistencies in the abbreviation
%styles}
%\begin{abbrvstyle}{long-short}
@@ -18039,24 +30924,25 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrlongshortname},
sort={\the\glsshorttok},
- first={\protect\glsfirstlongfont{\the\glslongtok}%
+ first={\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvfont{\the\glsshorttok}}},%
- firstplural={\protect\glsfirstlongfont{\the\glslongpltok}%
+ \protect\glsxtrparen{\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}}},%
+ firstplural={\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvfont{\the\glsshortpltok}}},%
+ \protect\glsxtrparen{\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}},%
% \end{macrocode}
%\changes{1.15}{2017-05-10}{fixed spelling of \cs{glsabbrvfont}}
%\changes{1.42}{2020-02-03}{added missing text key}
% \begin{macrocode}
- plural={\protect\glsabbrvfont{\the\glsshortpltok}},%
- text={\protect\glsabbrvfont{\the\glsshorttok}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
description={\the\glslongtok}}%
% \end{macrocode}
%\changes{0.5.1}{2015-12-07}{switch off regular attribute if set}
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -18074,30 +30960,34 @@ defined}{}%
\renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvdefaultfont{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
\renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrrevert}[1]{\glsxtrdefaultrevert{##1}}%
% \end{macrocode}
% The first use full form and the inline full form are the same for
% this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstlongfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvfont{\glsaccessshort{##1}}}%
+ \glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstlongfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvfont{\glsaccessshortpl{##1}}}%
+ \glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstlongfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvfont{\glsaccessshort{##1}}}%
+ \Glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstlongfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvfont{\glsaccessshortpl{##1}}}%
+ \Glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
}
% \end{macrocode}
@@ -18121,8 +31011,9 @@ defined}{}%
%\changes{1.17}{2017-08-09}{new}
% \begin{macrocode}
\newcommand*{\glsxtrlongshortdescname}{%
- \protect\glslongfont{\the\glslongtok}
- \glsxtrparen{\protect\glsabbrvfont{\the\glsshorttok}}%
+ \glsxplongfont{\the\glslongtok}{\glscategorylabel}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \protect\glsxtrparen{\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}}%
}
% \end{macrocode}
%\end{macro}
@@ -18143,27 +31034,28 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrlongshortdescname},
sort={\glsxtrlongshortdescsort},%
- first={\protect\glsfirstlongfont{\the\glslongtok}%
+ first={\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvfont{\the\glsshorttok}}},%
- firstplural={\protect\glsfirstlongfont{\the\glslongpltok}%
+ \protect\glsxtrparen{\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}}},%
+ firstplural={\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvfont{\the\glsshortpltok}}},%
+ \protect\glsxtrparen{\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}},%
% \end{macrocode}
%The \gloskey{text} key should only have the short form.
%\changes{1.07}{2016-08-15}{added missing text key}
% \begin{macrocode}
- text={\protect\glsabbrvfont{\the\glsshorttok}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
% \end{macrocode}
%\changes{1.07}{2016-08-15}{fixed misspelling of \cs{glsabbrvfont}}
% \begin{macrocode}
- plural={\protect\glsabbrvfont{\the\glsshortpltok}}%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}%
}%
% \end{macrocode}
%\changes{0.5.1}{2015-12-07}{switch off regular attribute if set}
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -18181,7 +31073,7 @@ defined}{}%
%\changes{1.25}{2017-11-24}{new}
% \begin{macrocode}
\newcommand*{\glsxtrshortlongname}{%
- \protect\glsabbrvfont{\the\glsshorttok}%
+ \glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
}
% \end{macrocode}
%\end{macro}
@@ -18202,18 +31094,18 @@ defined}{}%
name={\glsxtrshortlongname},
sort={\the\glsshorttok},
description={\the\glslongtok},%
- first={\protect\glsfirstabbrvfont{\the\glsshorttok}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlongfont{\the\glslongtok}}},%
- firstplural={\protect\glsfirstabbrvfont{\the\glsshortpltok}%
+ \protect\glsxtrparen{\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}}},%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlongfont{\the\glslongpltok}}},%
+ \protect\glsxtrparen{\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}}},%
% \end{macrocode}
%\changes{1.15}{2017-05-10}{fixed spelling of \cs{glsabbrvfont}}
%\changes{1.42}{2020-02-03}{added missing text key}
% \begin{macrocode}
- text={\protect\glsabbrvfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvfont{\the\glsshortpltok}}}%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
% \end{macrocode}
%\changes{0.5.1}{2015-12-07}{switch off regular attribute if set}
% Unset the \catattr{regular} attribute if it has been set.
@@ -18241,26 +31133,28 @@ defined}{}%
% this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfont{\glsaccesslong{##1}}}%
+ \glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfont{\glsaccesslongpl{##1}}}%
+ \glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfont{\glsaccesslong{##1}}}%
+ \Glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfont{\glsaccesslongpl{##1}}}%
+ \Glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
}
% \end{macrocode}
@@ -18269,7 +31163,7 @@ defined}{}%
%\begin{macro}{\glsxtrshortlongdescsort}
%\changes{1.17}{2017-08-09}{new}
% \begin{macrocode}
-\newcommand*{\glsxtrshortlongdescsort}{\the\glsshorttok}
+\newcommand*{\glsxtrshortlongdescsort}{\expandonce\glsxtrorgshort}
% \end{macrocode}
%\end{macro}
%
@@ -18277,8 +31171,9 @@ defined}{}%
%\changes{1.17}{2017-08-09}{new}
% \begin{macrocode}
\newcommand*{\glsxtrshortlongdescname}{%
- \protect\glsabbrvfont{\the\glsshorttok}
- \glsxtrparen{\protect\glslongfont{\the\glslongtok}}%
+ \glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \protect\glsxtrparen{\glsxplongfont{\the\glslongtok}{\glscategorylabel}}%
}
% \end{macrocode}
%\end{macro}
@@ -18299,27 +31194,28 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrshortlongdescname},
sort={\glsxtrshortlongdescsort},
- first={\protect\glsfirstabbrvfont{\the\glsshorttok}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlongfont{\the\glslongtok}}},%
- firstplural={\protect\glsfirstabbrvfont{\the\glsshortpltok}%
+ \protect\glsxtrparen{\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}}},%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlongfont{\the\glslongpltok}}},%
+ \protect\glsxtrparen{\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}}},%
% \end{macrocode}
%\changes{1.07}{2016-08-15}{added text key}
% \begin{macrocode}
- text={\protect\glsabbrvfont{\the\glsshorttok}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
% \end{macrocode}
%\changes{1.07}{2016-08-15}{fixed misspelling of \cs{glsabbrvfont} in plural
%key}
% \begin{macrocode}
- plural={\protect\glsabbrvfont{\the\glsshortpltok}}%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}%
}%
% \end{macrocode}
%\changes{0.5.1}{2015-12-07}{switch off regular attribute if set}
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -18364,11 +31260,38 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtrpostabbrvfootnote}
+%\changes{1.49}{??}{new}
+%Used by post-footnote style to include formatting.
+% \begin{macrocode}
+\newrobustcmd*{\glsxtrpostabbrvfootnote}[2]{%
+ \glsxtrabbrvfootnote{#1}%
+ {#2\glsxtrpostfootnotelongformat{#1}{\glsfirstlongfootnotefont}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\xpglsxtrpostabbrvfootnote}
+%\changes{1.49}{??}{new}
+%Perform all the appropriate expansions to ensure \cs{glslabel} and
+%\cs{glsxtrassignlinktextfmt} are expanded
+% as they may be lost by the time the footnote occurs.
+% \begin{macrocode}
+\newcommand*{\xpglsxtrpostabbrvfootnote}{%
+ \expandafter\expandafter\expandafter
+ \glsxtrpostabbrvfootnote
+ \expandafter\expandafter\expandafter
+ {\expandafter\glslabel\expandafter}\expandafter
+ {\glsxtrassignlinktextfmt}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsxtrfootnotename}
%\changes{1.25}{2017-11-24}{new}
% \begin{macrocode}
\newcommand*{\glsxtrfootnotename}{%
- \protect\glsabbrvfont{\the\glsshorttok}%
+ \glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
}
% \end{macrocode}
%\end{macro}
@@ -18381,7 +31304,10 @@ defined}{}%
% \end{macrocode}
% Set accessibility attributes if enabled. (Add
% \catattr{firstshortaccess} since long form is hidden in a
-% footnote on first use.)
+% footnote on first use.) The inner formatting isn't be applied to
+% the footnote text because the innertextformat key value may have
+% gone out of scope by that the time the footnote text is processed.
+% (Neither is the outer formatting applied.)
% \begin{macrocode}
\glsxtrAccSuppAbbrSetNoLongAttrs\glscategorylabel
% \end{macrocode}
@@ -18395,18 +31321,18 @@ defined}{}%
%\changes{1.07}{2016-08-15}{changed first forms to use
%\cs{glsfirstlongfootnotefont}}
% \begin{macrocode}
- first={\protect\glsfirstabbrvfont{\the\glsshorttok}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
\protect\glsxtrabbrvfootnote{\the\glslabeltok}%
{\protect\glsfirstlongfootnotefont{\the\glslongtok}}},%
- firstplural={\protect\glsfirstabbrvfont{\the\glsshortpltok}%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}%
\protect\glsxtrabbrvfootnote{\the\glslabeltok}%
{\protect\glsfirstlongfootnotefont{\the\glslongpltok}}},%
% \end{macrocode}
%\changes{1.15}{2017-05-10}{fixed spelling of \cs{glsabbrvfont}}
%\changes{1.42}{2020-02-03}{added missing text key}
% \begin{macrocode}
- text={\protect\glsabbrvfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvfont{\the\glsshortpltok}}}%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
% \end{macrocode}
% Switch off hyperlinks on first use to prevent nested hyperlinks,
% and unset the \catattr{regular} attribute if it has been set.
@@ -18436,52 +31362,62 @@ defined}{}%
% as a footnote.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortformat{##1}{##2}{\glsfirstabbrvfont}%
\protect\glsxtrabbrvfootnote{##1}%
- {\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ {\glsxtrfootnotelongformat{##1}{\glsfirstlongfootnotefont}}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortplformat{##1}{##2}{\glsfirstabbrvfont}%
\protect\glsxtrabbrvfootnote{##1}%
- {\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ {\glsxtrfootnotelongplformat{##1}{\glsfirstlongfootnotefont}}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortformat{##1}{##2}{\glsfirstabbrvfont}%
\protect\glsxtrabbrvfootnote{##1}%
- {\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ {\glsxtrfootnotelongformat{##1}{\glsfirstlongfootnotefont}}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortplformat{##1}{##2}{\glsfirstabbrvfont}%
\protect\glsxtrabbrvfootnote{##1}%
- {\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ {\glsxtrfootnotelongplformat{##1}{\glsfirstlongfootnotefont}}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshortformat{##1}{##2}{\glsfirstabbrvfont}%
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsxtrfootnotelongformat{##1}{\glsfirstlongfootnotefont}}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshortplformat{##1}{##2}{\glsfirstabbrvfont}%
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsxtrfootnotelongplformat{##1}{\glsfirstlongfootnotefont}}%
}%
% \end{macrocode}
% The first use full form and the inline full form use the short
% (long) style.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ \glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ \glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ \Glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ \Glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvfont}%
}%
}
% \end{macrocode}
@@ -18497,9 +31433,9 @@ defined}{}%
%\changes{1.42}{2020-02-03}{new}
% \begin{macrocode}
\newcommand*{\glsxtrfootnotedescname}{%
- \protect\glsabbrvfont{\the\glsshorttok}%
+ \glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \protect\glsxtrparen{\protect\glslongfont{\the\glslongtok}}%
+ \protect\glsxtrparen{\glsxplongfont{\the\glslongtok}{\glscategorylabel}}%
}
% \end{macrocode}
%\end{macro}
@@ -18527,14 +31463,14 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrfootnotedescname},
sort={\glsxtrfootnotedescsort},
- first={\protect\glsfirstabbrvfont{\the\glsshorttok}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
\protect\glsxtrabbrvfootnote{\the\glslabeltok}%
{\protect\glsfirstlongfootnotefont{\the\glslongtok}}},%
- firstplural={\protect\glsfirstabbrvfont{\the\glsshortpltok}%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}%
\protect\glsxtrabbrvfootnote{\the\glslabeltok}%
{\protect\glsfirstlongfootnotefont{\the\glslongpltok}}},%
- text={\protect\glsabbrvfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvfont{\the\glsshortpltok}}}%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
% \end{macrocode}
% Switch off hyperlinks on first use to prevent nested hyperlinks,
% and unset the \catattr{regular} attribute if it has been set.
@@ -18585,14 +31521,14 @@ defined}{}%
name={\glsxtrfootnotename},
sort={\the\glsshorttok},
description={\the\glslongtok},%
- first={\protect\glsfirstabbrvfont{\the\glsshorttok}},%
- firstplural={\protect\glsfirstabbrvfont{\the\glsshortpltok}},%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},%
% \end{macrocode}
%\changes{1.15}{2017-05-10}{fixed spelling of \cs{glsabbrvfont}}
%\changes{1.42}{2020-02-03}{added missing text key}
% \begin{macrocode}
- text={\protect\glsabbrvfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvfont{\the\glsshortpltok}}}%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
% \end{macrocode}
% Make this category insert a footnote after the link if this was
% the first use, and
@@ -18601,16 +31537,25 @@ defined}{}%
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
\csdef{glsxtrpostlink\glscategorylabel}{%
- \glsxtrifwasfirstuse
+% \end{macrocode}
+%\changes{1.02}{2016-04-25}{added redef of \cs{glsxtrsetupfulldefs}}
+% The footnote needs to be suppressed in the inline form.
+%Previously this was done by redefining {glsxtrsetupfulldefs} but
+%that interferes with other styles. Instead, this now uses \cs{glsxtrifwasglslike}
+%\changes{1.49}{??}{removed redef of \cs{glsxtrsetupfulldefs}}
+% \begin{macrocode}
+ \glsxtrifwasglslikeandfirstuse
{%
% \end{macrocode}
-% Needs the specific font command here as the style may have been
-% lost by the time the footnote occurs.
+% Ensure \cs{glslabel} and \cs{glsxtrassignlinktextfmt} are expanded
+% as they may be lost by the time the footnote occurs.
% \begin{macrocode}
- \glsxtrdopostpunc{\protect\glsxtrabbrvfootnote{\glslabel}%
- {\glsfirstlongfootnotefont{\glsentrylong{\glslabel}}}}%
- }%
- {}%
+ \glsxtrdopostpunc{\expandafter\expandafter\expandafter
+ \glsxtrpostabbrvfootnote
+ \expandafter\expandafter\expandafter
+ {\expandafter\glslabel\expandafter}\expandafter
+ {\glsxtrassignlinktextfmt}}%
+ }{}%
}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
@@ -18618,14 +31563,6 @@ defined}{}%
}%
{}%
}%
-% \end{macrocode}
-%\changes{1.02}{2016-04-25}{added redef of \cs{glsxtrsetupfulldefs}}
-% The footnote needs to be suppressed in the inline form, so
-% \cs{glsxtrfull} must set the first use switch off.
-% \begin{macrocode}
- \renewcommand*{\glsxtrsetupfulldefs}{%
- \let\glsxtrifwasfirstuse\@secondoftwo
- }%
}%
{%
% \end{macrocode}
@@ -18642,20 +31579,22 @@ defined}{}%
% deferred.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortformat{##1}{##2}{\glsfirstabbrvfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortplformat{##1}{##2}{\glsfirstabbrvfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortformat{##1}{##2}{\glsfirstabbrvfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortplformat{##1}{##2}{\glsfirstabbrvfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshortformat{##1}{##2}{\glsfirstabbrvfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshortplformat{##1}{##2}{\glsfirstabbrvfont}%
}%
% \end{macrocode}
% The first use full form and the inline full form use the short
@@ -18664,24 +31603,28 @@ defined}{}%
%\cs{glsfirstlongfootnotefont}}
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ \glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ \glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ \Glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ \Glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvfont}%
}%
}
% \end{macrocode}
@@ -18710,30 +31653,37 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrfootnotedescname},
sort={\glsxtrfootnotedescsort},
- first={\protect\glsfirstabbrvfont{\the\glsshorttok}},%
- firstplural={\protect\glsfirstabbrvfont{\the\glsshortpltok}},%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},%
% \end{macrocode}
%\changes{1.15}{2017-05-10}{fixed spelling of \cs{glsabbrvfont}}
%\changes{1.42}{2020-02-03}{added missing text key}
% \begin{macrocode}
- text={\protect\glsabbrvfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvfont{\the\glsshortpltok}}}%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
% \end{macrocode}
% Make this category insert a footnote after the link if this was
% the first use, and
% unset the \catattr{regular} attribute if it has been set.
%\changes{0.5.1}{2015-12-07}{switch off regular attribute if set}
+%\changes{1.02}{2016-04-25}{added redef of \cs{glsxtrsetupfulldefs}}
+%Previously this was done by redefining {glsxtrsetupfulldefs} but
+%that interferes with other styles. Instead, this now uses \cs{glsxtrifwasglslike}
+%\changes{1.49}{??}{removed redef of \cs{glsxtrsetupfulldefs}}
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
\csdef{glsxtrpostlink\glscategorylabel}{%
- \glsxtrifwasfirstuse
+ \glsxtrifwasglslikeandfirstuse
{%
% \end{macrocode}
-% Needs the specific font command here as the style may have been
-% lost by the time the footnote occurs.
+% Ensure \cs{glslabel} and \cs{glsxtrassignlinktextfmt} are expanded
+% as they may be lost by the time the footnote occurs.
% \begin{macrocode}
- \glsxtrdopostpunc{\protect\glsxtrabbrvfootnote{\glslabel}%
- {\glsfirstlongfootnotefont{\glsentrylong{\glslabel}}}}%
+ \glsxtrdopostpunc{\expandafter\expandafter\expandafter
+ \glsxtrpostabbrvfootnote
+ \expandafter\expandafter\expandafter
+ {\expandafter\glslabel\expandafter}\expandafter
+ {\glsxtrassignlinktextfmt}}%
}%
{}%
}%
@@ -18743,14 +31693,6 @@ defined}{}%
}%
{}%
}%
-% \end{macrocode}
-%\changes{1.02}{2016-04-25}{added redef of \cs{glsxtrsetupfulldefs}}
-% The footnote needs to be suppressed in the inline form, so
-% \cs{glsxtrfull} must set the first use switch off.
-% \begin{macrocode}
- \renewcommand*{\glsxtrsetupfulldefs}{%
- \let\glsxtrifwasfirstuse\@secondoftwo
- }%
}%
{%
\GlsXtrUseAbbrStyleFmts{postfootnote}%
@@ -18769,7 +31711,7 @@ defined}{}%
%\changes{1.25}{2017-11-24}{new}
% \begin{macrocode}
\newcommand*{\glsxtrshortnolongname}{%
- \protect\glsabbrvfont{\the\glsshorttok}%
+ \glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
}
% \end{macrocode}
%\end{macro}
@@ -18794,10 +31736,10 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrshortnolongname},
sort={\the\glsshorttok},
- first={\protect\glsfirstabbrvfont{\the\glsshorttok}},
- firstplural={\protect\glsfirstabbrvfont{\the\glsshortpltok}},
- text={\protect\glsabbrvfont{\the\glsshorttok}},
- plural={\protect\glsabbrvfont{\the\glsshortpltok}},
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},
description={\the\glslongtok}}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
\glssetattribute{\the\glslabeltok}{regular}{true}}%
@@ -18818,48 +31760,50 @@ defined}{}%
%\changes{0.2}{2015-11-30}{switched inline full form to short (long)}
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \protect\glsfirstabbrvfont{\glsaccessshort{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfont{\glsaccesslong{##1}}}%
+ \glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \protect\glsfirstabbrvfont{\glsaccessshortpl{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfont{\glsaccesslongpl{##1}}}%
+ \glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \protect\glsfirstabbrvfont{\glsaccessshort{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfont{\Glsaccesslong{##1}}}%
+ \Glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \protect\glsfirstabbrvfont{\glsaccessshortpl{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfont{\Glsaccesslongpl{##1}}}%
+ \Glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
% \end{macrocode}
% The first use full form only displays the short form, but it
% typically won't be used as the \catattr{regular} attribute is set by this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortformat{##1}{##2}{\glsfirstabbrvfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortplformat{##1}{##2}{\glsfirstabbrvfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortformat{##1}{##2}{\glsfirstabbrvfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortplformat{##1}{##2}{\glsfirstabbrvfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshortformat{##1}{##2}{\glsfirstabbrvfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshortplformat{##1}{##2}{\glsfirstabbrvfont}%
}%
}
% \end{macrocode}
@@ -18907,9 +31851,9 @@ defined}{}%
%manual}
% \begin{macrocode}
\newcommand*{\glsxtrshortdescname}{%
- \protect\glsabbrvfont{\the\glsshorttok}%
+ \glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \protect\glsxtrparen{\protect\glslongfont{\the\glslongtok}}%
+ \protect\glsxtrparen{\glsxplongfont{\the\glslongtok}{\glscategorylabel}}%
}
% \end{macrocode}
%\end{macro}
@@ -18935,10 +31879,10 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrshortdescname},
sort={\the\glsshorttok},
- first={\protect\glsfirstabbrvfont{\the\glsshorttok}},
- firstplural={\protect\glsfirstabbrvfont{\the\glsshortpltok}},
- text={\protect\glsabbrvfont{\the\glsshorttok}},
- plural={\protect\glsabbrvfont{\the\glsshortpltok}}}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
\glssetattribute{\the\glslabeltok}{regular}{true}}%
}%
@@ -18957,44 +31901,50 @@ defined}{}%
% long form in parentheses.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfont{\glsaccesslong{##1}}}%
+ \glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfont{\glsaccesslongpl{##1}}}%
+ \glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfont{\glsaccesslong{##1}}}%
+ \Glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfont{\glsaccesslongpl{##1}}}%
+ \Glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
% \end{macrocode}
% The first use full form only displays the short form, but it
% typically won't be used as the \catattr{regular} attribute is set by this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortformat{##1}{##2}{\glsfirstabbrvfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortplformat{##1}{##2}{\glsfirstabbrvfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortformat{##1}{##2}{\glsfirstabbrvfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortplformat{##1}{##2}{\glsfirstabbrvfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshortformat{##1}{##2}{\glsfirstabbrvfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshortplformat{##1}{##2}{\glsfirstabbrvfont}%
}%
}
% \end{macrocode}
@@ -19046,28 +31996,28 @@ defined}{}%
% short form in parentheses.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \protect\glsfirstlongfont{\glsaccesslong{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvfont{\glsaccessshort{##1}}}%
+ \glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \protect\glsfirstlongfont{\glsaccesslongpl{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvfont{\glsaccessshortpl{##1}}}%
+ \glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \protect\glsfirstlongfont{\glsaccesslong{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvfont{\Glsaccessshort{##1}}}%
+ \Glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \protect\glsfirstlongfont{\glsaccesslongpl{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvfont{\Glsaccessshortpl{##1}}}%
+ \Glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
}
% \end{macrocode}
@@ -19101,7 +32051,7 @@ defined}{}%
%\changes{1.25}{2017-11-24}{new}
% \begin{macrocode}
\newcommand*{\glsxtrlongnoshortdescname}{%
- \protect\glslongfont{\the\glslongtok}%
+ \glsxplongfont{\the\glslongtok}{\glscategorylabel}%
}
% \end{macrocode}
%\end{macro}
@@ -19118,10 +32068,10 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrlongnoshortdescname},
sort={\the\glslongtok},
- first={\protect\glsfirstlongfont{\the\glslongtok}},
- firstplural={\protect\glsfirstlongfont{\the\glslongpltok}},
- text={\glslongfont{\the\glslongtok}},
- plural={\glslongfont{\the\glslongpltok}}%
+ first={\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}},
+ firstplural={\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}},
+ text={\glsxplongfont{\the\glslongtok}{\glscategorylabel}},
+ plural={\glsxplongfont{\the\glslongpltok}{\glscategorylabel}}%
}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
\glssetattribute{\the\glslabeltok}{regular}{true}}%
@@ -19141,64 +32091,72 @@ defined}{}%
% is set).
% \begin{macrocode}
\renewcommand*{\glsxtrsubsequentfmt}[2]{%
- \glslongfont{\glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \glsxtrlongformat{##1}{##2}{\glslongfont}%
}%
\renewcommand*{\glsxtrsubsequentplfmt}[2]{%
- \glslongfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \glsxtrlongplformat{##1}{##2}{\glslongfont}%
}%
\renewcommand*{\Glsxtrsubsequentfmt}[2]{%
- \glslongfont{\Glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \Glsxtrlongformat{##1}{##2}{\glslongfont}%
}%
\renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
- \glslongfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \Glsxtrlongplformat{##1}{##2}{\glslongfont}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentfmt}[2]{%
+ \GLSxtrlongformat{##1}{##2}{\glslongfont}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentplfmt}[2]{%
+ \GLSxtrlongplformat{##1}{##2}{\glslongfont}%
}%
% \end{macrocode}
% The inline full form displays the long format followed by the
% short form in parentheses.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstlongfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshort{##1}}}%
+ \glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstlongfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshortpl{##1}}}%
+ \glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstlongfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshort{##1}}}%
+ \Glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstlongfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshortpl{##1}}}%
+ \Glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongfont}{\glsfirstabbrvfont}%
}%
% \end{macrocode}
% The first use full form only displays the long form, but it
% typically won't be used as the \catattr{regular} attribute is set by this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstlongfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongformat{##1}{##2}{\glsfirstlongfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstlongfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongplformat{##1}{##2}{\glsfirstlongfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstlongfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongformat{##1}{##2}{\glsfirstlongfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstlongfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongplformat{##1}{##2}{\glsfirstlongfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrlongformat{##1}{##2}{\glsfirstlongfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrlongplformat{##1}{##2}{\glsfirstlongfont}%
}%
}
% \end{macrocode}
@@ -19239,7 +32197,7 @@ defined}{}%
%\changes{1.25}{2017-11-24}{new}
% \begin{macrocode}
\newcommand*{\glsxtrlongnoshortname}{%
- \protect\glsabbrvfont{\the\glsshorttok}%
+ \glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
}
% \end{macrocode}
%\end{macro}
@@ -19263,10 +32221,10 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrlongnoshortname},
sort={\the\glsshorttok},
- first={\protect\glsfirstlongfont{\the\glslongtok}},
- firstplural={\protect\glsfirstlongfont{\the\glslongpltok}},
- text={\glslongfont{\the\glslongtok}},
- plural={\glslongfont{\the\glslongpltok}},%
+ first={\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}},
+ firstplural={\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}},
+ text={\glsxplongfont{\the\glslongtok}{\glscategorylabel}},
+ plural={\glsxplongfont{\the\glslongpltok}{\glscategorylabel}},%
description={\the\glslongtok}%
}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
@@ -19344,13 +32302,34 @@ defined}{}%
%\begin{macro}{\glsxtrscsuffix}
%\changes{0.5}{2015-12-07}{new}
%\changes{1.42}{2020-02-03}{added \cs{protect}}
-%\cs{protect} needs to come inside \cs{\glsxtrscsuffix} to avoid
+%\cs{protect} needs to come inside \cs{glsxtrscsuffix} to avoid
%interfering with all caps.
% \begin{macrocode}
\newcommand*{\glsxtrscsuffix}{\protect\glstextup{\glsxtrabbrvpluralsuffix}}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtrscrevert}
+%\changes{1.49}{??}{new}
+%Cancel smallcaps.
+% \begin{macrocode}
+\newcommand*{\glsxtrscrevert}[1]{\glstextup{#1}}%
+% \end{macrocode}
+%\end{macro}
+%
+%v1.49: the following now use commands like
+%\cs{glsfirstinnerfmtabbrvfont} instead of
+%\cs{glsfirstabbrvscfont} etc. This makes it easier to apply the inner
+%formatting. The scoping added in v1.48 with \cs{glslinkwrcontent}
+%should prevent formatting leakage in the event of nested commands.
+%The only problem will be if commands like \cs{glsentryfirst} are
+%used, but those aren't designed for consistent formatting. It will
+%also make it easier to locally redefine \cs{glsfirstinnerfmtabbrvfont}
+%to strip the formatting if those commands are used (rather than
+%having to define all the possible abbreviation style formatting
+%commands). Since these new commands are robust they don't need
+%protecting.
+%
%\begin{abbrvstyle}{long-short-sc}
%\changes{1.42}{2020-02-03}{added missing text key}
% \begin{macrocode}
@@ -19366,16 +32345,17 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrlongshortname},
sort={\the\glsshorttok},
- first={\protect\glsfirstlongdefaultfont{\the\glslongtok}%
+ first={\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvscfont{\the\glsshorttok}}},%
- firstplural={\protect\glsfirstlongdefaultfont{\the\glslongpltok}%
+ \protect\glsxtrparen{\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}}},%
+ firstplural={\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvscfont{\the\glsshortpltok}}},%
- text={\protect\glsabbrvscfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvscfont{\the\glsshortpltok}},%
+ \protect\glsxtrparen{\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},%
description={\the\glslongtok}}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -19391,6 +32371,7 @@ defined}{}%
\renewcommand*{\abbrvpluralsuffix}{\glsxtrscsuffix}%
\renewcommand*\glsabbrvfont[1]{\glsabbrvscfont{##1}}%
\renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvscfont{##1}}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtrscrevert{##1}}%
% \end{macrocode}
% Use the default long fonts.
% \begin{macrocode}
@@ -19401,25 +32382,28 @@ defined}{}%
% this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvscfont{\glsaccessshort{##1}}}%
+ \glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvscfont{\glsaccessshortpl{##1}}}%
+ \glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstlongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvscfont{\glsaccessshort{##1}}}%
+ \Glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstlongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvscfont{\glsaccessshortpl{##1}}}%
+ \Glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
}
% \end{macrocode}
@@ -19439,20 +32423,21 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrlongshortdescname},
sort={\glsxtrlongshortdescsort},%
- first={\protect\glsfirstlongdefaultfont{\the\glslongtok}%
+ first={\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvscfont{\the\glsshorttok}}},%
- firstplural={\protect\glsfirstlongdefaultfont{\the\glslongpltok}%
+ \protect\glsxtrparen{\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}}},%
+ firstplural={\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvscfont{\the\glsshortpltok}}},%
- text={\protect\glsabbrvscfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvscfont{\the\glsshortpltok}}%
+ \protect\glsxtrparen{\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}%
}%
% \end{macrocode}
%\changes{0.5.1}{2015-12-07}{switch off regular attribute if set}
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -19486,18 +32471,19 @@ defined}{}%
name={\glsxtrshortlongname},
sort={\the\glsshorttok},
description={\the\glslongtok},%
- first={\protect\glsfirstabbrvscfont{\the\glsshorttok}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongtok}}},%
- firstplural={\protect\glsfirstabbrvscfont{\the\glsshortpltok}%
+ \protect\glsxtrparen{\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}}},%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongpltok}}},%
- text={\protect\glsabbrvscfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvscfont{\the\glsshortpltok}}}%
+ \protect\glsxtrparen{\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
% \end{macrocode}
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -19515,31 +32501,34 @@ defined}{}%
\renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvscfont{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
\renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtrscrevert{##1}}%
% \end{macrocode}
% The first use full form and the inline full form are the same for
% this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvscfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ \glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvscfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ \glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvscfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ \Glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvscfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ \Glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
}
% \end{macrocode}
@@ -19560,19 +32549,20 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrshortlongdescname},
sort={\glsxtrshortlongdescsort},
- first={\protect\glsfirstabbrvscfont{\the\glsshorttok}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongtok}}},%
- firstplural={\protect\glsfirstabbrvscfont{\the\glsshortpltok}%
+ \protect\glsxtrparen{\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}}},%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongpltok}}},%
- text={\protect\glsabbrvscfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvscfont{\the\glsshortpltok}}%
+ \protect\glsxtrparen{\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}%
}%
% \end{macrocode}
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -19603,10 +32593,10 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrshortnolongname},
sort={\the\glsshorttok},
- first={\protect\glsfirstabbrvscfont{\the\glsshorttok}},
- firstplural={\protect\glsfirstabbrvscfont{\the\glsshortpltok}},
- text={\protect\glsabbrvscfont{\the\glsshorttok}},
- plural={\protect\glsabbrvscfont{\the\glsshortpltok}},
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},
description={\the\glslongtok}}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
\glssetattribute{\the\glslabeltok}{regular}{true}}%
@@ -19621,56 +32611,59 @@ defined}{}%
\renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvscfont{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
\renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtrscrevert{##1}}%
% \end{macrocode}
% The inline full form displays the short form followed by the
% long form in parentheses.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \protect\glsfirstabbrvscfont{\glsaccessshort{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ \glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \protect\glsfirstabbrvscfont{\glsaccessshortpl{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ \glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
% \end{macrocode}
%\changes{1.21}{2017-11-03}{corrected first letter uppercasing}
% \begin{macrocode}
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \protect\glsfirstabbrvscfont{\Glsaccessshort{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ \Glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \protect\glsfirstabbrvscfont{\Glsaccessshortpl{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ \Glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
% \end{macrocode}
% The first use full form only displays the short form, but it
% typically won't be used as the \catattr{regular} attribute is set by this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvscfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortformat{##1}{##2}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvscfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortplformat{##1}{##2}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvscfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortformat{##1}{##2}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvscfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortplformat{##1}{##2}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshortformat{##1}{##2}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshortplformat{##1}{##2}{\glsfirstabbrvscfont}%
}%
}
% \end{macrocode}
@@ -19699,10 +32692,10 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrshortdescname},
sort={\the\glsshorttok},
- first={\protect\glsfirstabbrvscfont{\the\glsshorttok}},
- firstplural={\protect\glsfirstabbrvscfont{\the\glsshortpltok}},
- text={\protect\glsabbrvscfont{\the\glsshorttok}},
- plural={\protect\glsabbrvscfont{\the\glsshortpltok}}}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
\glssetattribute{\the\glslabeltok}{regular}{true}}%
}%
@@ -19716,49 +32709,56 @@ defined}{}%
\renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvscfont{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
\renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtrscrevert{##1}}%
% \end{macrocode}
% The inline full form displays the short format followed by the
% long form in parentheses.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvscfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ \glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvscfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ \glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvscfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ \Glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvscfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ \Glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
% \end{macrocode}
% The first use full form only displays the short form, but it
% typically won't be used as the \catattr{regular} attribute is set by this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvscfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortformat{##1}{##2}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvscfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortplformat{##1}{##2}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvscfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortformat{##1}{##2}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvscfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortplformat{##1}{##2}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshortformat{##1}{##2}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshortplformat{##1}{##2}{\glsfirstabbrvscfont}%
}%
}
% \end{macrocode}
@@ -19784,28 +32784,28 @@ defined}{}%
% short form in parentheses.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \protect\glsfirstlongdefaultfont{\glsaccesslong{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvscfont{\glsaccessshort{##1}}}%
+ \glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \protect\glsfirstlongdefaultfont{\glsaccesslongpl{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvscfont{\glsaccessshortpl{##1}}}%
+ \glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \protect\glsfirstlongdefaultfont{\Glsaccesslong{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvscfont{\glsaccessshort{##1}}}%
+ \Glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \protect\glsfirstlongdefaultfont{\Glsaccesslongpl{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvscfont{\glsaccessshortpl{##1}}}%
+ \Glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
}
% \end{macrocode}
@@ -19822,10 +32822,10 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrlongnoshortname},
sort={\the\glsshorttok},
- first={\protect\glsfirstlongdefaultfont{\the\glslongtok}},
- firstplural={\protect\glsfirstlongdefaultfont{\the\glslongpltok}},
- text={\protect\glslongdefaultfont{\the\glslongtok}},
- plural={\protect\glslongdefaultfont{\the\glslongpltok}},%
+ first={\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}},
+ firstplural={\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}},
+ text={\glsxplongfont{\the\glslongtok}{\glscategorylabel}},
+ plural={\glsxplongfont{\the\glslongpltok}{\glscategorylabel}},%
description={\the\glslongtok}%
}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
@@ -19841,69 +32841,78 @@ defined}{}%
\renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvscfont{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
\renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtrscrevert{##1}}%
% \end{macrocode}
% The format for subsequent use (not used when the regular attribute
% is set).
% \begin{macrocode}
\renewcommand*{\glsxtrsubsequentfmt}[2]{%
- \glslongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \glsxtrlongformat{##1}{##2}{\glslongdefaultfont}%
}%
\renewcommand*{\glsxtrsubsequentplfmt}[2]{%
- \glslongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \glsxtrlongplformat{##1}{##2}{\glslongdefaultfont}%
}%
\renewcommand*{\Glsxtrsubsequentfmt}[2]{%
- \glslongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \Glsxtrlongformat{##1}{##2}{\glslongdefaultfont}%
}%
\renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
- \glslongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \Glsxtrlongplformat{##1}{##2}{\glslongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentfmt}[2]{%
+ \GLSxtrlongformat{##1}{##2}{\glslongdefaultfont}%
+ }%
+ \renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
+ \GLSxtrlongplformat{##1}{##2}{\glslongdefaultfont}%
}%
% \end{macrocode}
% The inline full form displays the long format followed by the
% short form in parentheses.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvscfont{\glsaccessshort{##1}}}%
+ \glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvscfont{\glsaccessshortpl{##1}}}%
+ \glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstlongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvscfont{\glsaccessshort{##1}}}%
+ \Glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstlongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvscfont{\glsaccessshortpl{##1}}}%
+ \Glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
% \end{macrocode}
% The first use full form only displays the long form, but it
% typically won't be used as the \catattr{regular} attribute is set by this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongplformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongplformat{##1}{##2}{\glsfirstlongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrlongformat{##1}{##2}{\glsfirstlongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrlongplformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
}
% \end{macrocode}
@@ -19919,7 +32928,7 @@ defined}{}%
%\changes{1.04}{2016-05-02}{renamed from \qt{long-desc-sc}}
% The smallcaps font will only be used if
% the short form is explicitly invoked through commands like
-% \cs{glsshort}.
+% \cs{glsxtrshort}.
% \begin{macrocode}
\newabbreviationstyle{long-noshort-sc-desc}%
{%
@@ -19935,69 +32944,78 @@ defined}{}%
\renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvscfont{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
\renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtrscrevert{##1}}%
% \end{macrocode}
% The format for subsequent use (not used when the regular attribute
% is set).
% \begin{macrocode}
\renewcommand*{\glsxtrsubsequentfmt}[2]{%
- \glslongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \glsxtrlongformat{##1}{##2}{\glslongdefaultfont}%
}%
\renewcommand*{\glsxtrsubsequentplfmt}[2]{%
- \glslongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \glsxtrlongplformat{##1}{##2}{\glslongdefaultfont}%
}%
\renewcommand*{\Glsxtrsubsequentfmt}[2]{%
- \glslongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \Glsxtrlongformat{##1}{##2}{\glslongdefaultfont}%
}%
\renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
- \glslongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \Glsxtrlongplformat{##1}{##2}{\glslongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentfmt}[2]{%
+ \GLSxtrlongformat{##1}{##2}{\glslongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentplfmt}[2]{%
+ \GLSxtrlongplformat{##1}{##2}{\glslongdefaultfont}%
}%
% \end{macrocode}
% The inline full form displays the long format followed by the
% short form in parentheses.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvscfont{\glsaccessshort{##1}}}%
+ \glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvscfont{\glsaccessshortpl{##1}}}%
+ \glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstlongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvscfont{\glsaccessshort{##1}}}%
+ \Glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstlongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvscfont{\glsaccessshortpl{##1}}}%
+ \Glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvscfont}%
}%
% \end{macrocode}
% The first use full form only displays the long form, but it
% typically won't be used as the \catattr{regular} attribute is set by this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongplformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongplformat{##1}{##2}{\glsfirstlongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrlongformat{##1}{##2}{\glsfirstlongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrlongplformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
}
% \end{macrocode}
@@ -20027,14 +33045,14 @@ defined}{}%
name={\glsxtrfootnotename},
sort={\the\glsshorttok},
description={\the\glslongtok},%
- first={\protect\glsfirstabbrvscfont{\the\glsshorttok}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
\protect\glsxtrabbrvfootnote{\the\glslabeltok}%
{\protect\glsfirstlongfootnotefont{\the\glslongtok}}},%
- firstplural={\protect\glsfirstabbrvscfont{\the\glsshortpltok}%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}%
\protect\glsxtrabbrvfootnote{\the\glslabeltok}%
{\protect\glsfirstlongfootnotefont{\the\glslongpltok}}},%
- text={\protect\glsabbrvscfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvscfont{\the\glsshortpltok}}}%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
% \end{macrocode}
% Switch off hyperlinks on first use to prevent nested hyperlinks,
% and unset the \catattr{regular} attribute if it has been set.
@@ -20059,57 +33077,68 @@ defined}{}%
\renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvscfont{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongfootnotefont{##1}}%
\renewcommand*{\glslongfont}[1]{\glslongfootnotefont{##1}}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtrscrevert{##1}}%
% \end{macrocode}
% The full format displays the short form followed by the long form
% as a footnote.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvscfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortformat{##1}{##2}{\glsfirstabbrvscfont}%
\protect\glsxtrabbrvfootnote{##1}%
- {\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ {\glsxtrfootnotelongformat{##1}{\glsfirstlongfootnotefont}}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvscfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortplformat{##1}{##2}{\glsfirstabbrvscfont}%
\protect\glsxtrabbrvfootnote{##1}%
- {\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ {\glsxtrfootnotelongplformat{##1}{\glsfirstlongfootnotefont}}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvscfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortformat{##1}{##2}{\glsfirstabbrvscfont}%
\protect\glsxtrabbrvfootnote{##1}%
- {\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ {\glsxtrfootnotelongformat{##1}{\glsfirstlongfootnotefont}}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvscfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortplformat{##1}{##2}{\glsfirstabbrvscfont}%
\protect\glsxtrabbrvfootnote{##1}%
- {\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ {\glsxtrfootnotelongplformat{##1}{\glsfirstlongfootnotefont}}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshortformat{##1}{##2}{\glsfirstabbrvscfont}%
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsxtrfootnotelongformat{##1}{\glsfirstlongfootnotefont}}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshortplformat{##1}{##2}{\glsfirstabbrvscfont}%
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsxtrfootnotelongplformat{##1}{\glsfirstlongfootnotefont}}%
}%
% \end{macrocode}
% The first use full form and the inline full form use the short
% (long) style.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvscfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ \glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvscfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ \glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvscfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ \Glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvscfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ \Glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvscfont}%
}%
}
% \end{macrocode}
@@ -20137,14 +33166,14 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrfootnotedescname},
sort={\glsxtrfootnotedescsort},
- first={\protect\glsfirstabbrvscfont{\the\glsshorttok}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
\protect\glsxtrabbrvfootnote{\the\glslabeltok}%
{\protect\glsfirstlongfootnotefont{\the\glslongtok}}},%
- firstplural={\protect\glsfirstabbrvscfont{\the\glsshortpltok}%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}%
\protect\glsxtrabbrvfootnote{\the\glslabeltok}%
{\protect\glsfirstlongfootnotefont{\the\glslongpltok}}},%
- text={\protect\glsabbrvscfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvscfont{\the\glsshortpltok}}}%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
% \end{macrocode}
% Switch off hyperlinks on first use to prevent nested hyperlinks,
% and unset the \catattr{regular} attribute if it has been set.
@@ -20183,25 +33212,24 @@ defined}{}%
name={\glsxtrfootnotename},
sort={\the\glsshorttok},
description={\the\glslongtok},%
- first={\protect\glsfirstabbrvscfont{\the\glsshorttok}},%
- firstplural={\protect\glsfirstabbrvscfont{\the\glsshortpltok}},%
- text={\protect\glsabbrvscfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvscfont{\the\glsshortpltok}}}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
% \end{macrocode}
% Make this category insert a footnote after the link if this was
% the first use, and
% unset the \catattr{regular} attribute if it has been set.
+% The footnote needs to be suppressed in the inline form.
+%Previously this was done by redefining {glsxtrsetupfulldefs} but
+%that interferes with other styles. Instead, this now uses \cs{glsxtrifwasglslike}
+%\changes{1.49}{??}{removed redef of \cs{glsxtrsetupfulldefs}}
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
\csdef{glsxtrpostlink\glscategorylabel}{%
- \glsxtrifwasfirstuse
+ \glsxtrifwasglslikeandfirstuse
{%
-% \end{macrocode}
-% Needs the specific font command here as the style may have been
-% lost by the time the footnote occurs.
-% \begin{macrocode}
- \glsxtrdopostpunc{\protect\glsxtrabbrvfootnote{\glslabel}%
- {\glsfirstlongfootnotefont{\glsentrylong{\glslabel}}}}%
+ \glsxtrdopostpunc{\xpglsxtrpostabbrvfootnote}%
}%
{}%
}%
@@ -20211,13 +33239,6 @@ defined}{}%
}%
{}%
}%
-% \end{macrocode}
-% The footnote needs to be suppressed in the inline form, so
-% \cs{glsxtrfull} must set the first use switch off.
-% \begin{macrocode}
- \renewcommand*{\glsxtrsetupfulldefs}{%
- \let\glsxtrifwasfirstuse\@secondoftwo
- }%
}%
{%
% \end{macrocode}
@@ -20229,49 +33250,56 @@ defined}{}%
\renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvscfont{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongfootnotefont{##1}}%
\renewcommand*{\glslongfont}[1]{\glslongfootnotefont{##1}}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtrscrevert{##1}}%
% \end{macrocode}
% The full format displays the short form. The long form is
% deferred.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvscfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortformat{##1}{##2}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvscfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortplformat{##1}{##2}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvscfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortformat{##1}{##2}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvscfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortplformat{##1}{##2}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshortformat{##1}{##2}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshortplformat{##1}{##2}{\glsfirstabbrvscfont}%
}%
% \end{macrocode}
% The first use full form and the inline full form use the short
% (long) style.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvscfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ \glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvscfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ \glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvscfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ \Glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvscfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvscfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ \Glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvscfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvscfont}%
}%
}
% \end{macrocode}
@@ -20299,25 +33327,24 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrfootnotedescname},
sort={\glsxtrfootnotedescsort},
- first={\protect\glsfirstabbrvscfont{\the\glsshorttok}},%
- firstplural={\protect\glsfirstabbrvscfont{\the\glsshortpltok}},%
- text={\protect\glsabbrvscfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvscfont{\the\glsshortpltok}}}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
% \end{macrocode}
% Make this category insert a footnote after the link if this was
% the first use, and
% unset the \catattr{regular} attribute if it has been set.
+% The footnote needs to be suppressed in the inline form.
+%Previously this was done by redefining {glsxtrsetupfulldefs} but
+%that interferes with other styles. Instead, this now uses \cs{glsxtrifwasglslike}
+%\changes{1.49}{??}{removed redef of \cs{glsxtrsetupfulldefs}}
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
\csdef{glsxtrpostlink\glscategorylabel}{%
- \glsxtrifwasfirstuse
+ \glsxtrifwasglslikeandfirstuse
{%
-% \end{macrocode}
-% Needs the specific font command here as the style may have been
-% lost by the time the footnote occurs.
-% \begin{macrocode}
- \glsxtrdopostpunc{\protect\glsxtrabbrvfootnote{\glslabel}%
- {\glsfirstlongfootnotefont{\glsentrylong{\glslabel}}}}%
+ \glsxtrdopostpunc{\xpglsxtrpostabbrvfootnote}%
}%
{}%
}%
@@ -20327,13 +33354,6 @@ defined}{}%
}%
{}%
}%
-% \end{macrocode}
-% The footnote needs to be suppressed in the inline form, so
-% \cs{glsxtrfull} must set the first use switch off.
-% \begin{macrocode}
- \renewcommand*{\glsxtrsetupfulldefs}{%
- \let\glsxtrifwasfirstuse\@secondoftwo
- }%
}%
{%
\GlsXtrUseAbbrStyleFmts{short-sc-postfootnote}%
@@ -20379,6 +33399,12 @@ defined}{}%
\newcommand*{\glsxtrsmsuffix}{\glsxtrabbrvpluralsuffix}
% \end{macrocode}
%\end{macro}
+%\begin{macro}{\glsxtrsmrevert}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrsmrevert}[1]{\textlarger{#1}}
+% \end{macrocode}
+%\end{macro}
%
%\begin{abbrvstyle}{long-short-sm}
%\changes{0.5}{2015-12-07}{new}
@@ -20396,16 +33422,17 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrlongshortname},
sort={\the\glsshorttok},
- first={\protect\glsfirstlongdefaultfont{\the\glslongtok}%
+ first={\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvsmfont{\the\glsshorttok}}},%
- firstplural={\protect\glsfirstlongdefaultfont{\the\glslongpltok}%
+ \protect\glsxtrparen{\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}}},%
+ firstplural={\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvsmfont{\the\glsshortpltok}}},%
- text={\protect\glsabbrvsmfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvsmfont{\the\glsshortpltok}},%
+ \protect\glsxtrparen{\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},%
description={\the\glslongtok}}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -20420,6 +33447,7 @@ defined}{}%
\renewcommand*\glsabbrvfont[1]{\glsabbrvsmfont{##1}}%
\renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvsmfont{##1}}%
\renewcommand*{\abbrvpluralsuffix}{\glsxtrsmsuffix}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtrsmrevert{##1}}%
% \end{macrocode}
% Use the default long fonts.
% \begin{macrocode}
@@ -20430,25 +33458,28 @@ defined}{}%
% this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvsmfont{\glsaccessshort{##1}}}%
+ \glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvsmfont{\glsaccessshortpl{##1}}}%
+ \glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstlongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvsmfont{\glsaccessshort{##1}}}%
+ \Glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstlongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvsmfont{\glsaccessshortpl{##1}}}%
+ \Glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
}
% \end{macrocode}
@@ -20469,19 +33500,20 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrlongshortdescname},
sort={\glsxtrlongshortdescsort},%
- first={\protect\glsfirstlongdefaultfont{\the\glslongtok}%
+ first={\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvsmfont{\the\glsshorttok}}},%
- firstplural={\protect\glsfirstlongdefaultfont{\the\glslongpltok}%
+ \protect\glsxtrparen{\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}}},%
+ firstplural={\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvsmfont{\the\glsshortpltok}}},%
- text={\protect\glsabbrvsmfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvsmfont{\the\glsshortpltok}}%
+ \protect\glsxtrparen{\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}%
}%
% \end{macrocode}
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -20516,18 +33548,19 @@ defined}{}%
name={\glsxtrshortlongname},
sort={\the\glsshorttok},
description={\the\glslongtok},%
- first={\protect\glsfirstabbrvsmfont{\the\glsshorttok}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongtok}}},%
- firstplural={\protect\glsfirstabbrvsmfont{\the\glsshortpltok}%
+ \protect\glsxtrparen{\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}}},%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongpltok}}},%
- text={\protect\glsabbrvsmfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvsmfont{\the\glsshortpltok}}}%
+ \protect\glsxtrparen{\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
% \end{macrocode}
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -20542,6 +33575,7 @@ defined}{}%
\renewcommand*\glsabbrvfont[1]{\glsabbrvsmfont{##1}}%
\renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvsmfont{##1}}%
\renewcommand*{\abbrvpluralsuffix}{\glsxtrsmsuffix}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtrsmrevert{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
\renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
% \end{macrocode}
@@ -20549,26 +33583,28 @@ defined}{}%
% this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvsmfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ \glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvsmfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ \glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvsmfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ \Glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvsmfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ \Glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
}
% \end{macrocode}
@@ -20590,19 +33626,20 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrshortlongdescname},
sort={\glsxtrshortlongdescsort},
- first={\protect\glsfirstabbrvsmfont{\the\glsshorttok}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongtok}}},%
- firstplural={\protect\glsfirstabbrvsmfont{\the\glsshortpltok}%
+ \protect\glsxtrparen{\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}}},%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongpltok}}},%
- text={\protect\glsabbrvsmfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvsmfont{\the\glsshortpltok}}%
+ \protect\glsxtrparen{\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}%
}%
% \end{macrocode}
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -20634,10 +33671,10 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrshortnolongname},
sort={\the\glsshorttok},
- first={\protect\glsfirstabbrvsmfont{\the\glsshorttok}},
- firstplural={\protect\glsfirstabbrvsmfont{\the\glsshortpltok}},
- text={\protect\glsabbrvsmfont{\the\glsshorttok}},
- plural={\protect\glsabbrvsmfont{\the\glsshortpltok}},
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},
description={\the\glslongtok}}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
\glssetattribute{\the\glslabeltok}{regular}{true}}%
@@ -20649,6 +33686,7 @@ defined}{}%
\renewcommand*\glsabbrvfont[1]{\glsabbrvsmfont{##1}}%
\renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvsmfont{##1}}%
\renewcommand*{\abbrvpluralsuffix}{\glsxtrsmsuffix}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtrsmrevert{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
\renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
% \end{macrocode}
@@ -20656,51 +33694,53 @@ defined}{}%
% long form in parentheses.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \protect\glsfirstabbrvsmfont{\glsaccessshort{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ \glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \protect\glsfirstabbrvsmfont{\glsaccessshortpl{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ \glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
% \end{macrocode}
%\changes{1.21}{2017-11-03}{corrected first letter uppercasing}
% \begin{macrocode}
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \protect\glsfirstabbrvsmfont{\Glsaccessshort{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ \Glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \protect\glsfirstabbrvsmfont{\Glsaccessshortpl{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ \Glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
% \end{macrocode}
% The first use full form only displays the short form, but it
% typically won't be used as the \catattr{regular} attribute is set by this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvsmfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortformat{##1}{##2}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvsmfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortplformat{##1}{##2}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvsmfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortformat{##1}{##2}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvsmfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortplformat{##1}{##2}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshortformat{##1}{##2}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshortplformat{##1}{##2}{\glsfirstabbrvsmfont}%
}%
}
% \end{macrocode}
@@ -20730,10 +33770,10 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrshortdescname},
sort={\the\glsshorttok},
- first={\protect\glsfirstabbrvsmfont{\the\glsshorttok}},
- firstplural={\protect\glsfirstabbrvsmfont{\the\glsshortpltok}},
- text={\protect\glsabbrvsmfont{\the\glsshorttok}},
- plural={\protect\glsabbrvsmfont{\the\glsshortpltok}}}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
\glssetattribute{\the\glslabeltok}{regular}{true}}%
}%
@@ -20744,6 +33784,7 @@ defined}{}%
\renewcommand*\glsabbrvfont[1]{\glsabbrvsmfont{##1}}%
\renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvsmfont{##1}}%
\renewcommand*{\abbrvpluralsuffix}{\glsxtrsmsuffix}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtrsmrevert{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
\renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
% \end{macrocode}
@@ -20751,44 +33792,50 @@ defined}{}%
% long form in parentheses.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvsmfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ \glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvsmfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ \glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvsmfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ \Glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvsmfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ \Glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
% \end{macrocode}
% The first use full form only displays the short form, but it
% typically won't be used as the \catattr{regular} attribute is set by this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvsmfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortformat{##1}{##2}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvsmfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortplformat{##1}{##2}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvsmfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortformat{##1}{##2}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvsmfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortplformat{##1}{##2}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshortformat{##1}{##2}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshortplformat{##1}{##2}{\glsfirstabbrvsmfont}%
}%
}
% \end{macrocode}
@@ -20814,28 +33861,28 @@ defined}{}%
% short form in parentheses.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \protect\glsfirstlongdefaultfont{\glsaccesslong{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvsmfont{\glsaccessshort{##1}}}%
+ \glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \protect\glsfirstlongdefaultfont{\glsaccesslongpl{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvsmfont{\glsaccessshortpl{##1}}}%
+ \glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \protect\glsfirstlongdefaultfont{\Glsaccesslong{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvsmfont{\glsaccessshort{##1}}}%
+ \Glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \protect\glsfirstlongdefaultfont{\Glsaccesslongpl{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvsmfont{\glsaccessshortpl{##1}}}%
+ \Glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
}
% \end{macrocode}
@@ -20846,7 +33893,7 @@ defined}{}%
%\changes{1.04}{2016-05-02}{renamed from \qt{long-sm}}
% The smallcaps font will only be used if
% the short form is explicitly invoked through commands like
-% \cs{glsshort}.
+% \cs{glsxtrshort}.
% \begin{macrocode}
\newabbreviationstyle{long-noshort-sm}%
{%
@@ -20860,10 +33907,10 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrlongnoshortname},
sort={\the\glsshorttok},
- first={\protect\glsfirstlongdefaultfont{\the\glslongtok}},
- firstplural={\protect\glsfirstlongdefaultfont{\the\glslongpltok}},
- text={\protect\glslongdefaultfont{\the\glslongtok}},
- plural={\protect\glslongdefaultfont{\the\glslongpltok}},%
+ first={\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}},
+ firstplural={\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}},
+ text={\glsxplongfont{\the\glslongtok}{\glscategorylabel}},
+ plural={\glsxplongfont{\the\glslongpltok}{\glscategorylabel}},%
description={\the\glslongtok}%
}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
@@ -20876,6 +33923,7 @@ defined}{}%
\renewcommand*\glsabbrvfont[1]{\glsabbrvsmfont{##1}}%
\renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvsmfont{##1}}%
\renewcommand*{\abbrvpluralsuffix}{\glsxtrsmsuffix}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtrsmrevert{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
\renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
% \end{macrocode}
@@ -20883,64 +33931,72 @@ defined}{}%
% is set).
% \begin{macrocode}
\renewcommand*{\glsxtrsubsequentfmt}[2]{%
- \glslongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \glsxtrlongformat{##1}{##2}{\glslongdefaultfont}%
}%
\renewcommand*{\glsxtrsubsequentplfmt}[2]{%
- \glslongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \glsxtrlongplformat{##1}{##2}{\glslongdefaultfont}%
}%
\renewcommand*{\Glsxtrsubsequentfmt}[2]{%
- \glslongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \Glsxtrlongformat{##1}{##2}{\glslongdefaultfont}%
}%
\renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
- \glslongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \Glsxtrlongplformat{##1}{##2}{\glslongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentfmt}[2]{%
+ \GLSxtrlongformat{##1}{##2}{\glslongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentplfmt}[2]{%
+ \GLSxtrlongplformat{##1}{##2}{\glslongdefaultfont}%
}%
% \end{macrocode}
% The inline full form displays the long format followed by the
% short form in parentheses.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvsmfont{\glsaccessshort{##1}}}%
+ \glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvsmfont{\glsaccessshortpl{##1}}}%
+ \glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstlongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvsmfont{\glsaccessshort{##1}}}%
+ \Glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstlongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvsmfont{\glsaccessshortpl{##1}}}%
+ \Glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
% \end{macrocode}
% The first use full form only displays the long form, but it
% typically won't be used as the \catattr{regular} attribute is set by this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongplformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongplformat{##1}{##2}{\glsfirstlongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrlongformat{##1}{##2}{\glsfirstlongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrlongplformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
}
% \end{macrocode}
@@ -20957,7 +34013,7 @@ defined}{}%
%\changes{1.04}{2016-05-02}{renamed from \cs{long-desc-sm}}
% The smaller font will only be used if
% the short form is explicitly invoked through commands like
-% \cs{glsshort}.
+% \cs{glsxtrshort}.
% \begin{macrocode}
\newabbreviationstyle{long-noshort-sm-desc}%
{%
@@ -20970,6 +34026,7 @@ defined}{}%
\renewcommand*\glsabbrvfont[1]{\glsabbrvsmfont{##1}}%
\renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvsmfont{##1}}%
\renewcommand*{\abbrvpluralsuffix}{\glsxtrsmsuffix}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtrsmrevert{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
\renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
% \end{macrocode}
@@ -20977,64 +34034,72 @@ defined}{}%
% is set).
% \begin{macrocode}
\renewcommand*{\glsxtrsubsequentfmt}[2]{%
- \glslongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \glsxtrlongformat{##1}{##2}{\glslongdefaultfont}%
}%
\renewcommand*{\glsxtrsubsequentplfmt}[2]{%
- \glslongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \glsxtrlongplformat{##1}{##2}{\glslongdefaultfont}%
}%
\renewcommand*{\Glsxtrsubsequentfmt}[2]{%
- \glslongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \Glsxtrlongformat{##1}{##2}{\glslongdefaultfont}%
}%
\renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
- \glslongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \Glsxtrlongplformat{##1}{##2}{\glslongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentfmt}[2]{%
+ \GLSxtrlongformat{##1}{##2}{\glslongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentplfmt}[2]{%
+ \GLSxtrlongplformat{##1}{##2}{\glslongdefaultfont}%
}%
% \end{macrocode}
% The inline full form displays the long format followed by the
% short form in parentheses.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvsmfont{\glsaccessshort{##1}}}%
+ \glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvsmfont{\glsaccessshortpl{##1}}}%
+ \glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstlongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvsmfont{\glsaccessshort{##1}}}%
+ \Glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstlongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvsmfont{\glsaccessshortpl{##1}}}%
+ \Glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvsmfont}%
}%
% \end{macrocode}
% The first use full form only displays the long form, but it
% typically won't be used as the \catattr{regular} attribute is set by this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongplformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongplformat{##1}{##2}{\glsfirstlongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrlongformat{##1}{##2}{\glsfirstlongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrlongplformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
}
% \end{macrocode}
@@ -21064,14 +34129,14 @@ defined}{}%
name={\glsxtrfootnotename},
sort={\the\glsshorttok},
description={\the\glslongtok},%
- first={\protect\glsfirstabbrvsmfont{\the\glsshorttok}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
\protect\glsxtrabbrvfootnote{\the\glslabeltok}%
{\protect\glsfirstlongfootnotefont{\the\glslongtok}}},%
- firstplural={\protect\glsfirstabbrvsmfont{\the\glsshortpltok}%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}%
\protect\glsxtrabbrvfootnote{\the\glslabeltok}%
{\protect\glsfirstlongfootnotefont{\the\glslongpltok}}},%
- text={\protect\glsabbrvsmfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvsmfont{\the\glsshortpltok}}}%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
% \end{macrocode}
% Switch off hyperlinks on first use to prevent nested hyperlinks,
% and unset the \catattr{regular} attribute if it has been set.
@@ -21093,6 +34158,7 @@ defined}{}%
\renewcommand*\glsabbrvfont[1]{\glsabbrvsmfont{##1}}%
\renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvsmfont{##1}}%
\renewcommand*{\abbrvpluralsuffix}{\glsxtrsmsuffix}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtrsmrevert{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongfootnotefont{##1}}%
\renewcommand*{\glslongfont}[1]{\glslongfootnotefont{##1}}%
% \end{macrocode}
@@ -21100,52 +34166,62 @@ defined}{}%
% as a footnote.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvsmfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortformat{##1}{##2}{\glsfirstabbrvsmfont}%
\protect\glsxtrabbrvfootnote{##1}%
- {\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ {\glsxtrfootnotelongformat{##1}{\glsfirstlongfootnotefont}}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvsmfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortplformat{##1}{##2}{\glsfirstabbrvsmfont}%
\protect\glsxtrabbrvfootnote{##1}%
- {\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ {\glsxtrfootnotelongplformat{##1}{\glsfirstlongfootnotefont}}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvsmfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortformat{##1}{##2}{\glsfirstabbrvsmfont}%
\protect\glsxtrabbrvfootnote{##1}%
- {\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ {\glsxtrfootnotelongformat{##1}{\glsfirstlongfootnotefont}}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvsmfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortplformat{##1}{##2}{\glsfirstabbrvsmfont}%
\protect\glsxtrabbrvfootnote{##1}%
- {\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ {\glsxtrfootnotelongplformat{##1}{\glsfirstlongfootnotefont}}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshortformat{##1}{##2}{\glsfirstabbrvsmfont}%
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsxtrfootnotelongformat{##1}{\glsfirstlongfootnotefont}}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshortplformat{##1}{##2}{\glsfirstabbrvsmfont}%
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsxtrfootnotelongplformat{##1}{\glsfirstlongfootnotefont}}%
}%
% \end{macrocode}
% The first use full form and the inline full form use the short
% (long) style.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvsmfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ \glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvsmfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ \glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvsmfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ \Glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvsmfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ \Glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvsmfont}%
}%
}
% \end{macrocode}
@@ -21173,14 +34249,14 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrfootnotedescname},
sort={\glsxtrfootnotedescsort},
- first={\protect\glsfirstabbrvsmfont{\the\glsshorttok}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
\protect\glsxtrabbrvfootnote{\the\glslabeltok}%
{\protect\glsfirstlongfootnotefont{\the\glslongtok}}},%
- firstplural={\protect\glsfirstabbrvsmfont{\the\glsshortpltok}%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}%
\protect\glsxtrabbrvfootnote{\the\glslabeltok}%
{\protect\glsfirstlongfootnotefont{\the\glslongpltok}}},%
- text={\protect\glsabbrvsmfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvsmfont{\the\glsshortpltok}}}%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
% \end{macrocode}
% Switch off hyperlinks on first use to prevent nested hyperlinks,
% and unset the \catattr{regular} attribute if it has been set.
@@ -21219,25 +34295,24 @@ defined}{}%
name={\glsxtrfootnotename},
sort={\the\glsshorttok},
description={\the\glslongtok},%
- first={\protect\glsfirstabbrvsmfont{\the\glsshorttok}},%
- firstplural={\protect\glsfirstabbrvsmfont{\the\glsshortpltok}},%
- text={\protect\glsabbrvsmfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvsmfont{\the\glsshortpltok}}}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
% \end{macrocode}
% Make this category insert a footnote after the link if this was
% the first use, and
% unset the \catattr{regular} attribute if it has been set.
+% The footnote needs to be suppressed in the inline form.
+%Previously this was done by redefining {glsxtrsetupfulldefs} but
+%that interferes with other styles. Instead, this now uses \cs{glsxtrifwasglslike}
+%\changes{1.49}{??}{removed redef of \cs{glsxtrsetupfulldefs}}
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
\csdef{glsxtrpostlink\glscategorylabel}{%
- \glsxtrifwasfirstuse
+ \glsxtrifwasglslikeandfirstuse
{%
-% \end{macrocode}
-% Needs the specific font command here as the style may have been
-% lost by the time the footnote occurs.
-% \begin{macrocode}
- \glsxtrdopostpunc{\protect\glsxtrabbrvfootnote{\glslabel}%
- {\glsfirstlongfootnotefont{\glsentrylong{\glslabel}}}}%
+ \glsxtrdopostpunc{\xpglsxtrpostabbrvfootnote}%
}%
{}%
}%
@@ -21247,13 +34322,6 @@ defined}{}%
}%
{}%
}%
-% \end{macrocode}
-% The footnote needs to be suppressed in the inline form, so
-% \cs{glsxtrfull} must set the first use switch off.
-% \begin{macrocode}
- \renewcommand*{\glsxtrsetupfulldefs}{%
- \let\glsxtrifwasfirstuse\@secondoftwo
- }%
}%
{%
% \end{macrocode}
@@ -21262,6 +34330,7 @@ defined}{}%
\renewcommand*\glsabbrvfont[1]{\glsabbrvsmfont{##1}}%
\renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvsmfont{##1}}%
\renewcommand*{\abbrvpluralsuffix}{\glsxtrsmsuffix}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtrsmrevert{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongfootnotefont{##1}}%
\renewcommand*{\glslongfont}[1]{\glslongfootnotefont{##1}}%
% \end{macrocode}
@@ -21269,44 +34338,50 @@ defined}{}%
% deferred.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvsmfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortformat{##1}{##2}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvsmfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortplformat{##1}{##2}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvsmfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortformat{##1}{##2}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvsmfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortplformat{##1}{##2}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshortformat{##1}{##2}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshortplformat{##1}{##2}{\glsfirstabbrvsmfont}%
}%
% \end{macrocode}
% The first use full form and the inline full form use the short
% (long) style.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvsmfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ \glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvsmfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ \glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvsmfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ \Glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvsmfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvsmfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ \Glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvsmfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvsmfont}%
}%
}
% \end{macrocode}
@@ -21334,25 +34409,28 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrfootnotedescname},
sort={\glsxtrfootnotedescsort},
- first={\protect\glsfirstabbrvsmfont{\the\glsshorttok}},%
- firstplural={\protect\glsfirstabbrvsmfont{\the\glsshortpltok}},%
- text={\protect\glsabbrvsmfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvsmfont{\the\glsshortpltok}}}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
% \end{macrocode}
% Make this category insert a footnote after the link if this was
% the first use, and
% unset the \catattr{regular} attribute if it has been set.
+% The footnote needs to be suppressed in the inline form.
+%Previously this was done by redefining {glsxtrsetupfulldefs} but
+%that interferes with other styles. Instead, this now uses \cs{glsxtrifwasglslike}
+%\changes{1.49}{??}{removed redef of \cs{glsxtrsetupfulldefs}}
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
\csdef{glsxtrpostlink\glscategorylabel}{%
- \glsxtrifwasfirstuse
+ \glsxtrifwasglslikeandfirstuse
{%
% \end{macrocode}
-% Needs the specific font command here as the style may have been
+% Ensure \cs{glslabel} is expanded as it may be
% lost by the time the footnote occurs.
% \begin{macrocode}
- \glsxtrdopostpunc{\protect\glsxtrabbrvfootnote{\glslabel}%
- {\glsfirstlongfootnotefont{\glsentrylong{\glslabel}}}}%
+ \glsxtrdopostpunc{\xpglsxtrpostabbrvfootnote}%
}%
{}%
}%
@@ -21362,13 +34440,6 @@ defined}{}%
}%
{}%
}%
-% \end{macrocode}
-% The footnote needs to be suppressed in the inline form, so
-% \cs{glsxtrfull} must set the first use switch off.
-% \begin{macrocode}
- \renewcommand*{\glsxtrsetupfulldefs}{%
- \let\glsxtrifwasfirstuse\@secondoftwo
- }%
}%
{%
\GlsXtrUseAbbrStyleFmts{short-sm-postfootnote}%
@@ -21377,7 +34448,7 @@ defined}{}%
%\end{abbrvstyle}
%
%\subsection{Predefined Styles (Emphasized)}
-% These styles use \ics{emph} for the short form.
+% These styles use \cs{emph} for the short form.
%\begin{macro}{\glsabbrvemfont}
%\changes{1.04}{2016-05-02}{new}
% \begin{macrocode}
@@ -21413,6 +34484,13 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtremrevert}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtremrevert}[1]{\textup{#1}}%
+% \end{macrocode}
+%\end{macro}
+%
%\begin{abbrvstyle}{long-short-em}
%\changes{0.5}{2015-12-07}{new}
% The long form is just set in the default long font.
@@ -21430,16 +34508,17 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrlongshortname},
sort={\the\glsshorttok},
- first={\protect\glsfirstlongdefaultfont{\the\glslongtok}%
+ first={\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\the\glsshorttok}}},%
- firstplural={\protect\glsfirstlongdefaultfont{\the\glslongpltok}%
+ \protect\glsxtrparen{\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}}},%
+ firstplural={\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\the\glsshortpltok}}},%
- text={\protect\glsabbrvemfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvemfont{\the\glsshortpltok}},%
+ \protect\glsxtrparen{\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},%
description={\the\glslongtok}}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -21454,6 +34533,7 @@ defined}{}%
\renewcommand*\glsabbrvfont[1]{\glsabbrvemfont{##1}}%
\renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvemfont{##1}}%
\renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtremrevert{##1}}%
% \end{macrocode}
% Use the default long fonts.
% \begin{macrocode}
@@ -21464,25 +34544,28 @@ defined}{}%
% this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ \glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ \glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstlongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ \Glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstlongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ \Glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
}
% \end{macrocode}
@@ -21503,19 +34586,20 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrlongshortdescname},
sort={\glsxtrlongshortdescsort},%
- first={\protect\glsfirstlongdefaultfont{\the\glslongtok}%
+ first={\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\the\glsshorttok}}},%
- firstplural={\protect\glsfirstlongdefaultfont{\the\glslongpltok}%
+ \protect\glsxtrparen{\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}}},%
+ firstplural={\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\the\glsshortpltok}}},%
- text={\protect\glsabbrvemfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvemfont{\the\glsshortpltok}}%
+ \protect\glsxtrparen{\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}%
}%
% \end{macrocode}
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -21550,22 +34634,24 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrlongshortname},
sort={\the\glsshorttok},
- first={\protect\glsfirstlongemfont{\the\glslongtok}%
+ first={\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\the\glsshorttok}}},%
- firstplural={\protect\glsfirstlongemfont{\the\glslongpltok}%
+ \protect\glsxtrparen{\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}}},%
+ firstplural={\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\the\glsshortpltok}}},%
+ \protect\glsxtrparen{\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}},%
% \end{macrocode}
%\changes{1.15}{2017-05-10}{fixed spelling of \cs{glsabbrvfont}}
% \begin{macrocode}
- text={\protect\glsabbrvemfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvemfont{\the\glsshortpltok}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},%
description={\protect\glslongemfont{\the\glslongtok}}}%
% \end{macrocode}
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsexclapplyinnerfmtfield{\the\glslabeltok}{desc}%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -21578,6 +34664,7 @@ defined}{}%
%\changes{1.42}{2020-02-03}{removed \cs{protect} from \cs{glsxtremsuffix}}
% \begin{macrocode}
\renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtremrevert{##1}}%
\renewcommand*{\glsabbrvfont}[1]{\glsabbrvemfont{##1}}%
\renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvemfont{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongemfont{##1}}%
@@ -21587,25 +34674,28 @@ defined}{}%
% this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstlongemfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ \glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstlongemfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ \glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstlongemfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ \Glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstlongemfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ \Glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
}%
}
% \end{macrocode}
@@ -21626,19 +34716,20 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrlongshortdescname},
sort={\glsxtrlongshortdescsort},%
- first={\protect\glsfirstlongemfont{\the\glslongtok}%
+ first={\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\the\glsshorttok}}},%
- firstplural={\protect\glsfirstlongemfont{\the\glslongpltok}%
+ \protect\glsxtrparen{\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}}},%
+ firstplural={\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\the\glsshortpltok}}},%
- text={\protect\glsabbrvemfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvemfont{\the\glsshortpltok}}%
+ \protect\glsxtrparen{\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}%
}%
% \end{macrocode}
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -21670,18 +34761,19 @@ defined}{}%
name={\glsxtrshortlongname},
sort={\the\glsshorttok},
description={\the\glslongtok},%
- first={\protect\glsfirstabbrvemfont{\the\glsshorttok}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongtok}}},%
- firstplural={\protect\glsfirstabbrvemfont{\the\glsshortpltok}%
+ \protect\glsxtrparen{\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}}},%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongpltok}}},%
- text={\protect\glsabbrvemfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvemfont{\the\glsshortpltok}}}%
+ \protect\glsxtrparen{\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
% \end{macrocode}
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -21696,6 +34788,7 @@ defined}{}%
%\changes{1.42}{2020-02-03}{removed \cs{protect} from \cs{glsxtremsuffix}}
% \begin{macrocode}
\renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtremrevert{##1}}%
\renewcommand*\glsabbrvfont[1]{\glsabbrvemfont{##1}}%
\renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvemfont{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
@@ -21705,26 +34798,28 @@ defined}{}%
% this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvemfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ \glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvemfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ \glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvemfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ \Glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvemfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ \Glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
}
% \end{macrocode}
@@ -21746,19 +34841,20 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrshortlongdescname},
sort={\glsxtrshortlongdescsort},
- first={\protect\glsfirstabbrvemfont{\the\glsshorttok}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongtok}}},%
- firstplural={\protect\glsfirstabbrvemfont{\the\glsshortpltok}%
+ \protect\glsxtrparen{\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}}},%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongpltok}}},%
- text={\protect\glsabbrvemfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvemfont{\the\glsshortpltok}}%
+ \protect\glsxtrparen{\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}%
}%
% \end{macrocode}
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -21791,21 +34887,23 @@ defined}{}%
name={\glsxtrshortlongname},
sort={\the\glsshorttok},
description={\protect\glslongemfont{\the\glslongtok}},%
- first={\protect\glsfirstabbrvemfont{\the\glsshorttok}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlongemfont{\the\glslongtok}}},%
- firstplural={\protect\glsfirstabbrvemfont{\the\glsshortpltok}%
+ \protect\glsxtrparen{\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}}},%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlongemfont{\the\glslongpltok}}},%
+ \protect\glsxtrparen{\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}}},%
% \end{macrocode}
%\changes{1.15}{2017-05-10}{fixed spelling of \cs{glsabbrvfont}}
% \begin{macrocode}
- text={\protect\glsabbrvemfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvemfont{\the\glsshortpltok}}}%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
% \end{macrocode}
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsexclapplyinnerfmtfield{\the\glslabeltok}{desc}%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -21818,6 +34916,7 @@ defined}{}%
%\changes{1.42}{2020-02-03}{removed \cs{protect} from \cs{glsxtremsuffix}}
% \begin{macrocode}
\renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtremrevert{##1}}%
\renewcommand*{\glsabbrvfont}[1]{\glsabbrvemfont{##1}}%
\renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvemfont{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongemfont{##1}}%
@@ -21827,26 +34926,28 @@ defined}{}%
% this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvemfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongemfont{\glsaccesslong{##1}}}%
+ \glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvemfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongemfont{\glsaccesslongpl{##1}}}%
+ \glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvemfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongemfont{\glsaccesslong{##1}}}%
+ \Glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvemfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongemfont{\glsaccesslongpl{##1}}}%
+ \Glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
}%
}
% \end{macrocode}
@@ -21867,19 +34968,20 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrshortlongdescname},%
sort={\glsxtrshortlongdescsort},%
- first={\protect\glsfirstabbrvemfont{\the\glsshorttok}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlongemfont{\the\glslongtok}}},%
- firstplural={\protect\glsfirstabbrvemfont{\the\glsshortpltok}%
+ \protect\glsxtrparen{\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}}},%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlongemfont{\the\glslongpltok}}},%
- text={\protect\glsabbrvemfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvemfont{\the\glsshortpltok}}%
+ \protect\glsxtrparen{\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}%
}%
% \end{macrocode}
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -21908,10 +35010,10 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrshortnolongname},
sort={\the\glsshorttok},
- first={\protect\glsfirstabbrvemfont{\the\glsshorttok}},
- firstplural={\protect\glsfirstabbrvemfont{\the\glsshortpltok}},
- text={\protect\glsabbrvemfont{\the\glsshorttok}},
- plural={\protect\glsabbrvemfont{\the\glsshortpltok}},
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},
description={\the\glslongtok}}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
\glssetattribute{\the\glslabeltok}{regular}{true}}%
@@ -21921,6 +35023,7 @@ defined}{}%
%\changes{1.42}{2020-02-03}{removed \cs{protect} from \cs{glsxtremsuffix}}
% \begin{macrocode}
\renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtremrevert{##1}}%
\renewcommand*\glsabbrvfont[1]{\glsabbrvemfont{##1}}%
\renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvemfont{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
@@ -21930,51 +35033,50 @@ defined}{}%
% long form in parentheses.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \protect\glsfirstabbrvemfont{\glsaccessshort{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ \glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \protect\glsfirstabbrvemfont{\glsaccessshortpl{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ \glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
-% \end{macrocode}
-%\changes{1.21}{2017-11-03}{new}
-% \begin{macrocode}
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \protect\glsfirstabbrvemfont{\Glsaccessshort{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ \Glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \protect\glsfirstabbrvemfont{\Glsaccessshortpl{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ \Glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
% \end{macrocode}
% The first use full form only displays the short form, but it
% typically won't be used as the \catattr{regular} attribute is set by this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvemfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortformat{##1}{##2}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvemfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortplformat{##1}{##2}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvemfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortformat{##1}{##2}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvemfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortplformat{##1}{##2}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshortformat{##1}{##2}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshortplformat{##1}{##2}{\glsfirstabbrvemfont}%
}%
}
% \end{macrocode}
@@ -22007,10 +35109,10 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrshortdescname},
sort={\the\glsshorttok},
- first={\protect\glsfirstabbrvemfont{\the\glsshorttok}},
- firstplural={\protect\glsfirstabbrvemfont{\the\glsshortpltok}},
- text={\protect\glsabbrvemfont{\the\glsshorttok}},
- plural={\protect\glsabbrvemfont{\the\glsshortpltok}}}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
\glssetattribute{\the\glslabeltok}{regular}{true}}%
}%
@@ -22019,6 +35121,7 @@ defined}{}%
%\changes{1.42}{2020-02-03}{removed \cs{protect} from \cs{glsxtremsuffix}}
% \begin{macrocode}
\renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtremrevert{##1}}%
\renewcommand*\glsabbrvfont[1]{\glsabbrvemfont{##1}}%
\renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvemfont{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
@@ -22028,44 +35131,50 @@ defined}{}%
% long form in parentheses.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvemfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ \glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvemfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ \glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvemfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ \Glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvemfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ \Glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
% \end{macrocode}
% The first use full form only displays the short form, but it
% typically won't be used as the \catattr{regular} attribute is set by this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvemfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortformat{##1}{##2}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvemfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortplformat{##1}{##2}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvemfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortformat{##1}{##2}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvemfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortplformat{##1}{##2}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshortformat{##1}{##2}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshortplformat{##1}{##2}{\glsfirstabbrvemfont}%
}%
}
% \end{macrocode}
@@ -22091,28 +35200,28 @@ defined}{}%
% short form in parentheses.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \protect\glsfirstlongdefaultfont{\glsaccesslong{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ \glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \protect\glsfirstlongdefaultfont{\glsaccesslongpl{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ \glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \protect\glsfirstlongdefaultfont{\Glsaccesslong{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ \Glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \protect\glsfirstlongdefaultfont{\Glsaccesslongpl{##1}%
- \ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ \Glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
}
% \end{macrocode}
@@ -22122,7 +35231,7 @@ defined}{}%
%\changes{0.5}{2015-12-07}{new}
%\changes{1.04}{2016-05-02}{renamed from \qt{long-em}}
% The short form is explicitly invoked through commands like
-% \cs{glsshort}.
+% \cs{glsxtrshort}.
% \begin{macrocode}
\newabbreviationstyle{long-noshort-em}%
{%
@@ -22136,10 +35245,10 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrlongnoshortname},
sort={\the\glsshorttok},
- first={\protect\glsfirstlongdefaultfont{\the\glslongtok}},
- firstplural={\protect\glsfirstlongdefaultfont{\the\glslongpltok}},
- text={\protect\glslongdefaultfont{\the\glslongtok}},
- plural={\protect\glslongdefaultfont{\the\glslongpltok}},%
+ first={\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}},
+ firstplural={\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}},
+ text={\glsxplongfont{\the\glslongtok}{\glscategorylabel}},
+ plural={\glsxplongfont{\the\glslongpltok}{\glscategorylabel}},%
description={\the\glslongtok}%
}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
@@ -22150,6 +35259,7 @@ defined}{}%
%\changes{1.42}{2020-02-03}{removed \cs{protect} from \cs{glsxtremsuffix}}
% \begin{macrocode}
\renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtremrevert{##1}}%
\renewcommand*\glsabbrvfont[1]{\glsabbrvemfont{##1}}%
\renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvemfont{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
@@ -22159,64 +35269,72 @@ defined}{}%
% is set).
% \begin{macrocode}
\renewcommand*{\glsxtrsubsequentfmt}[2]{%
- \glslongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \glsxtrlongformat{##1}{##2}{\glslongdefaultfont}%
}%
\renewcommand*{\glsxtrsubsequentplfmt}[2]{%
- \glslongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \glsxtrlongplformat{##1}{##2}{\glslongdefaultfont}%
}%
\renewcommand*{\Glsxtrsubsequentfmt}[2]{%
- \glslongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \Glsxtrlongformat{##1}{##2}{\glslongdefaultfont}%
}%
\renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
- \glslongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \Glsxtrlongplformat{##1}{##2}{\glslongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentfmt}[2]{%
+ \GLSxtrlongformat{##1}{##2}{\glslongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentplfmt}[2]{%
+ \GLSxtrlongplformat{##1}{##2}{\glslongdefaultfont}%
}%
% \end{macrocode}
% The inline full form displays the long format followed by the
% short form in parentheses.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ \glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ \glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstlongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ \Glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstlongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ \Glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
% \end{macrocode}
% The first use full form only displays the long form, but it
% typically won't be used as the \catattr{regular} attribute is set by this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongplformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongplformat{##1}{##2}{\glsfirstlongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrlongformat{##1}{##2}{\glsfirstlongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrlongplformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
}
% \end{macrocode}
@@ -22231,7 +35349,7 @@ defined}{}%
%\begin{abbrvstyle}{long-em-noshort-em}
%\changes{1.04}{2016-05-02}{new}
% The short form is explicitly invoked through commands like
-% \cs{glsshort}.
+% \cs{glsxtrshort}.
% \begin{macrocode}
\newabbreviationstyle{long-em-noshort-em}%
{%
@@ -22245,13 +35363,14 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrlongnoshortname},
sort={\the\glsshorttok},
- first={\protect\glsfirstlongemfont{\the\glslongtok}},
- firstplural={\protect\glsfirstlongemfont{\the\glslongpltok}},
- text={\protect\glslongemfont{\the\glslongtok}},
- plural={\protect\glslongemfont{\the\glslongpltok}},%
+ first={\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}},
+ firstplural={\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}},
+ text={\glsxplongfont{\the\glslongtok}{\glscategorylabel}},
+ plural={\glsxplongfont{\the\glslongpltok}{\glscategorylabel}},%
description={\protect\glslongemfont{\the\glslongtok}}%
}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsexclapplyinnerfmtfield{\the\glslabeltok}{desc}%
\glssetattribute{\the\glslabeltok}{regular}{true}}%
}%
{%
@@ -22259,6 +35378,7 @@ defined}{}%
%\changes{1.42}{2020-02-03}{removed \cs{protect} from \cs{glsxtremsuffix}}
% \begin{macrocode}
\renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtremrevert{##1}}%
\renewcommand*\glsabbrvfont[1]{\glsabbrvemfont{##1}}%
\renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvemfont{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongemfont{##1}}%
@@ -22268,64 +35388,72 @@ defined}{}%
% is set).
% \begin{macrocode}
\renewcommand*{\glsxtrsubsequentfmt}[2]{%
- \glslongemfont{\glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \glsxtrlongformat{##1}{##2}{\glslongemfont}%
}%
\renewcommand*{\glsxtrsubsequentplfmt}[2]{%
- \glslongemfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \glsxtrlongplformat{##1}{##2}{\glslongemfont}%
}%
\renewcommand*{\Glsxtrsubsequentfmt}[2]{%
- \glslongemfont{\Glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \Glsxtrlongformat{##1}{##2}{\glslongemfont}%
}%
\renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
- \glslongemfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \Glsxtrlongplformat{##1}{##2}{\glslongemfont}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentfmt}[2]{%
+ \GLSxtrlongformat{##1}{##2}{\glslongemfont}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentplfmt}[2]{%
+ \GLSxtrlongplformat{##1}{##2}{\glslongemfont}%
}%
% \end{macrocode}
% The inline full form displays the long format followed by the
% short form in parentheses.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstlongemfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ \glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstlongemfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ \glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstlongemfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ \Glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstlongemfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ \Glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
}%
% \end{macrocode}
% The first use full form only displays the long form, but it
% typically won't be used as the \catattr{regular} attribute is set by this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstlongemfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongformat{##1}{##2}{\glsfirstlongemfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstlongemfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongplformat{##1}{##2}{\glsfirstlongemfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstlongemfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongformat{##1}{##2}{\glsfirstlongemfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstlongemfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongplformat{##1}{##2}{\glsfirstlongemfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrlongformat{##1}{##2}{\glsfirstlongemfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrlongplformat{##1}{##2}{\glsfirstlongemfont}%
}%
}
% \end{macrocode}
@@ -22367,7 +35495,7 @@ defined}{}%
%\changes{0.5}{2015-12-07}{new}
% The emphasized font will only be used if
% the short form is explicitly invoked through commands like
-% \cs{glsshort}.
+% \cs{glsxtrshort}.
% \begin{macrocode}
\newabbreviationstyle{long-noshort-em-desc}%
{%
@@ -22378,6 +35506,7 @@ defined}{}%
%\changes{1.42}{2020-02-03}{removed \cs{protect} from \cs{glsxtremsuffix}}
% \begin{macrocode}
\renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtremrevert{##1}}%
\renewcommand*\glsabbrvfont[1]{\glsabbrvemfont{##1}}%
\renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvemfont{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
@@ -22387,64 +35516,72 @@ defined}{}%
% is set).
% \begin{macrocode}
\renewcommand*{\glsxtrsubsequentfmt}[2]{%
- \glslongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \glsxtrlongformat{##1}{##2}{\glslongdefaultfont}%
}%
\renewcommand*{\glsxtrsubsequentplfmt}[2]{%
- \glslongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \glsxtrlongplformat{##1}{##2}{\glslongdefaultfont}%
}%
\renewcommand*{\Glsxtrsubsequentfmt}[2]{%
- \glslongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \Glsxtrlongformat{##1}{##2}{\glslongdefaultfont}%
}%
\renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
- \glslongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \Glsxtrlongplformat{##1}{##2}{\glslongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentfmt}[2]{%
+ \GLSxtrlongformat{##1}{##2}{\glslongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentplfmt}[2]{%
+ \GLSxtrlongplformat{##1}{##2}{\glslongdefaultfont}%
}%
% \end{macrocode}
% The inline full form displays the long format followed by the
% short form in parentheses.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ \glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ \glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstlongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ \Glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstlongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ \Glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongdefaultfont}{\glsfirstabbrvemfont}%
}%
% \end{macrocode}
% The first use full form only displays the long form, but it
% typically won't be used as the \catattr{regular} attribute is set by this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongplformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongplformat{##1}{##2}{\glsfirstlongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrlongformat{##1}{##2}{\glsfirstlongdefaultfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrlongplformat{##1}{##2}{\glsfirstlongdefaultfont}%
}%
}
% \end{macrocode}
@@ -22467,10 +35604,10 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrlongnoshortdescname},
sort={\the\glslongtok},
- first={\protect\glsfirstlongemfont{\the\glslongtok}},
- firstplural={\protect\glsfirstlongemfont{\the\glslongpltok}},
- text={\glslongemfont{\the\glslongtok}},
- plural={\glslongemfont{\the\glslongpltok}}%
+ first={\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}},
+ firstplural={\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}},
+ text={\glsxplongfont{\the\glslongtok}{\glscategorylabel}},
+ plural={\glsxplongfont{\the\glslongpltok}{\glscategorylabel}}%
}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
\glssetattribute{\the\glslabeltok}{regular}{true}}%
@@ -22480,6 +35617,7 @@ defined}{}%
%\changes{1.42}{2020-02-03}{removed \cs{protect} from \cs{glsxtremsuffix}}
% \begin{macrocode}
\renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtremrevert{##1}}%
\renewcommand*\glsabbrvfont[1]{\glsabbrvemfont{##1}}%
\renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvemfont{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongemfont{##1}}%
@@ -22489,64 +35627,72 @@ defined}{}%
% is set).
% \begin{macrocode}
\renewcommand*{\glsxtrsubsequentfmt}[2]{%
- \glslongemfont{\glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \glsxtrlongformat{##1}{##2}{\glslongemfont}%
}%
\renewcommand*{\glsxtrsubsequentplfmt}[2]{%
- \glslongemfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \glsxtrlongplformat{##1}{##2}{\glslongemfont}%
}%
\renewcommand*{\Glsxtrsubsequentfmt}[2]{%
- \glslongemfont{\Glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \Glsxtrlongformat{##1}{##2}{\glslongemfont}%
}%
\renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
- \glslongemfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
- \ifglsxtrinsertinside \else##2\fi
+ \Glsxtrlongplformat{##1}{##2}{\glslongemfont}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentfmt}[2]{%
+ \GLSxtrlongformat{##1}{##2}{\glslongemfont}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentplfmt}[2]{%
+ \GLSxtrlongplformat{##1}{##2}{\glslongemfont}%
}%
% \end{macrocode}
% The inline full form displays the long format followed by the
% short form in parentheses.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstlongemfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ \glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstlongemfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ \glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstlongemfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ \Glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstlongemfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ \Glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongemfont}{\glsfirstabbrvemfont}%
}%
% \end{macrocode}
% The first use full form only displays the long form, but it
% typically won't be used as the \catattr{regular} attribute is set by this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstlongemfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongformat{##1}{##2}{\glsfirstlongemfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstlongemfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongplformat{##1}{##2}{\glsfirstlongemfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstlongemfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongformat{##1}{##2}{\glsfirstlongemfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstlongemfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongplformat{##1}{##2}{\glsfirstlongemfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrlongformat{##1}{##2}{\glsfirstlongemfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrlongplformat{##1}{##2}{\glsfirstlongemfont}%
}%
}
% \end{macrocode}
@@ -22594,14 +35740,14 @@ defined}{}%
name={\glsxtrfootnotename},
sort={\the\glsshorttok},
description={\the\glslongtok},%
- first={\protect\glsfirstabbrvemfont{\the\glsshorttok}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
\protect\glsxtrabbrvfootnote{\the\glslabeltok}%
{\protect\glsfirstlongfootnotefont{\the\glslongtok}}},%
- firstplural={\protect\glsfirstabbrvemfont{\the\glsshortpltok}%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}%
\protect\glsxtrabbrvfootnote{\the\glslabeltok}%
{\protect\glsfirstlongfootnotefont{\the\glslongpltok}}},%
- text={\protect\glsabbrvemfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvemfont{\the\glsshortpltok}}}%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
% \end{macrocode}
% Switch off hyperlinks on first use to prevent nested hyperlinks,
% and unset the \catattr{regular} attribute if it has been set.
@@ -22621,6 +35767,7 @@ defined}{}%
%\changes{1.42}{2020-02-03}{removed \cs{protect} from \cs{glsxtremsuffix}}
% \begin{macrocode}
\renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtremrevert{##1}}%
\renewcommand*\glsabbrvfont[1]{\glsabbrvemfont{##1}}%
\renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvemfont{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongfootnotefont{##1}}%
@@ -22630,52 +35777,61 @@ defined}{}%
% as a footnote.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvemfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortformat{##1}{##2}{\glsfirstabbrvemfont}%
\protect\glsxtrabbrvfootnote{##1}%
- {\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ {\glsxtrfootnotelongformat{##1}{\glsfirstlongfootnotefont}}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvemfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortplformat{##1}{##2}{\glsfirstabbrvemfont}%
\protect\glsxtrabbrvfootnote{##1}%
- {\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ {\glsxtrfootnotelongplformat{##1}{\glsfirstlongfootnotefont}}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvemfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortformat{##1}{##2}{\glsfirstabbrvemfont}%
\protect\glsxtrabbrvfootnote{##1}%
- {\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ {\glsxtrfootnotelongformat{##1}{\glsfirstlongfootnotefont}}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvemfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortplformat{##1}{##2}{\glsfirstabbrvemfont}%
\protect\glsxtrabbrvfootnote{##1}%
- {\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ {\glsxtrfootnotelongplformat{##1}{\glsfirstlongfootnotefont}}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshortformat{##1}{##2}{\glsfirstabbrvemfont}%
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsxtrfootnotelongformat{##1}{\glsfirstlongfootnotefont}}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshortplformat{##1}{##2}{\glsfirstabbrvemfont}%
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsxtrfootnotelongplformat{##1}{\glsfirstlongfootnotefont}}%
}%
% \end{macrocode}
-% The first use full form and the inline full form use the short
-% (long) style.
+% The first use inline full form uses the short (long) style.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvemfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ \glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvemfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ \glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvemfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ \Glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvemfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ \Glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvemfont}%
}%
}
% \end{macrocode}
@@ -22703,14 +35859,14 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrfootnotedescname},
sort={\glsxtrfootnotedescsort},
- first={\protect\glsfirstabbrvemfont{\the\glsshorttok}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}%
\protect\glsxtrabbrvfootnote{\the\glslabeltok}%
{\protect\glsfirstlongfootnotefont{\the\glslongtok}}},%
- firstplural={\protect\glsfirstabbrvemfont{\the\glsshortpltok}%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}%
\protect\glsxtrabbrvfootnote{\the\glslabeltok}%
{\protect\glsfirstlongfootnotefont{\the\glslongpltok}}},%
- text={\protect\glsabbrvemfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvemfont{\the\glsshortpltok}}}%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
% \end{macrocode}
% Switch off hyperlinks on first use to prevent nested hyperlinks,
% and unset the \catattr{regular} attribute if it has been set.
@@ -22749,25 +35905,27 @@ defined}{}%
name={\glsxtrfootnotename},
sort={\the\glsshorttok},
description={\the\glslongtok},%
- first={\protect\glsfirstabbrvemfont{\the\glsshorttok}},%
- firstplural={\protect\glsfirstabbrvemfont{\the\glsshortpltok}},%
- text={\protect\glsabbrvemfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvemfont{\the\glsshortpltok}}}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
% \end{macrocode}
% Make this category insert a footnote after the link if this was
% the first use, and
% unset the \catattr{regular} attribute if it has been set.
+%Previously this was done by redefining {glsxtrsetupfulldefs} but
+%that interferes with other styles. Instead, this now uses \cs{glsxtrifwasglslike}
+%\changes{1.49}{??}{removed redef of \cs{glsxtrsetupfulldefs}}
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
\csdef{glsxtrpostlink\glscategorylabel}{%
- \glsxtrifwasfirstuse
+ \glsxtrifwasglslikeandfirstuse
{%
% \end{macrocode}
-% Needs the specific font command here as the style may have been
+% Ensure \cs{glslabel} is expanded as it may be
% lost by the time the footnote occurs.
% \begin{macrocode}
- \glsxtrdopostpunc{\protect\glsxtrabbrvfootnote{\glslabel}%
- {\glsfirstlongfootnotefont{\glsentrylong{\glslabel}}}}%
+ \glsxtrdopostpunc{\xpglsxtrpostabbrvfootnote}%
}%
{}%
}%
@@ -22777,19 +35935,13 @@ defined}{}%
}%
{}%
}%
-% \end{macrocode}
-% The footnote needs to be suppressed in the inline form, so
-% \cs{glsxtrfull} must set the first use switch off.
-% \begin{macrocode}
- \renewcommand*{\glsxtrsetupfulldefs}{%
- \let\glsxtrifwasfirstuse\@secondoftwo
- }%
}%
{%
% \end{macrocode}
%\changes{1.42}{2020-02-03}{removed \cs{protect} from \cs{glsxtremsuffix}}
% \begin{macrocode}
\renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtremrevert{##1}}%
\renewcommand*\glsabbrvfont[1]{\glsabbrvemfont{##1}}%
\renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvemfont{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongfootnotefont{##1}}%
@@ -22799,44 +35951,49 @@ defined}{}%
% deferred.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvemfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortformat{##1}{##2}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvemfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortplformat{##1}{##2}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvemfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortformat{##1}{##2}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvemfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortplformat{##1}{##2}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshortformat{##1}{##2}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshortplformat{##1}{##2}{\glsfirstabbrvemfont}%
}%
% \end{macrocode}
-% The first use full form and the inline full form use the short
-% (long) style.
+% The inline full form uses the short (long) style.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvemfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ \glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvemfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ \glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvemfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ \Glsxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvemfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvemfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
- \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ \Glsxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrshortlongformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvemfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrshortlongplformat{##1}{##2}%
+ {\glsfirstlongfootnotefont}{\glsfirstabbrvemfont}%
}%
}
% \end{macrocode}
@@ -22864,25 +36021,23 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrfootnotedescname},
sort={\glsxtrfootnotedescsort},
- first={\protect\glsfirstabbrvemfont{\the\glsshorttok}},%
- firstplural={\protect\glsfirstabbrvemfont{\the\glsshortpltok}},%
- text={\protect\glsabbrvemfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvemfont{\the\glsshortpltok}}}%
+ first={\glsfirstxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ firstplural={\glsfirstxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}}%
% \end{macrocode}
% Make this category insert a footnote after the link if this was
% the first use, and
% unset the \catattr{regular} attribute if it has been set.
+%Previously this was done by redefining {glsxtrsetupfulldefs} but
+%that interferes with other styles. Instead, this now uses \cs{glsxtrifwasglslike}
+%\changes{1.49}{??}{removed redef of \cs{glsxtrsetupfulldefs}}
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
\csdef{glsxtrpostlink\glscategorylabel}{%
- \glsxtrifwasfirstuse
+ \glsxtrifwasglslikeandfirstuse
{%
-% \end{macrocode}
-% Needs the specific font command here as the style may have been
-% lost by the time the footnote occurs.
-% \begin{macrocode}
- \glsxtrdopostpunc{\protect\glsxtrabbrvfootnote{\glslabel}%
- {\glsfirstlongfootnotefont{\glsentrylong{\glslabel}}}}%
+ \glsxtrdopostpunc{\xpglsxtrpostabbrvfootnote}%
}%
{}%
}%
@@ -22892,13 +36047,6 @@ defined}{}%
}%
{}%
}%
-% \end{macrocode}
-% The footnote needs to be suppressed in the inline form, so
-% \cs{glsxtrfull} must set the first use switch off.
-% \begin{macrocode}
- \renewcommand*{\glsxtrsetupfulldefs}{%
- \let\glsxtrifwasfirstuse\@secondoftwo
- }%
}%
{%
\GlsXtrUseAbbrStyleFmts{short-em-postfootnote}%
@@ -22918,12 +36066,28 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtruserparensep}
+%\changes{1.49}{??}{new}
+% Separator used inside parenthetical content.
+% \begin{macrocode}
+\newcommand*{\glsxtruserparensep}{, }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtruserfieldfmt}
+%\changes{1.49}{??}{new}
+% Used to format the value of the field given by \cs{glsxtruserfield}.
+% \begin{macrocode}
+\newcommand*{\glsxtruserfieldfmt}[1]{#1}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsxtruserparen}
%\changes{1.04}{2016-05-02}{new}
% The format of the parenthetical information.
% The first argument is the long/short form. The second argument
% is the entry's label. If \cs{glscurrentfieldvalue} has been
-% defined, then we have at least \styfmt{glossaries} v4.23, which makes
+% defined, then we have at least \sty{glossaries} v4.23, which makes
% it easier for the user to adjust this.
% \begin{macrocode}
\ifdef\glscurrentfieldvalue
@@ -22931,14 +36095,55 @@ defined}{}%
\newcommand*{\glsxtruserparen}[2]{%
\glsxtrfullsep{#2}%
\glsxtrparen
- {#1\ifglshasfield{\glsxtruserfield}{#2}{, \glscurrentfieldvalue}{}}%
+ {#1\ifglshasfield{\glsxtruserfield}{#2}%
+ {\expandafter\glsxtrgenentrytextfmt\expandafter{\glsxtruserparensep}%
+ \glsxtruserfieldfmt{\expandafter\glsxtrgenentrytextfmt\expandafter{\glscurrentfieldvalue}}%
+ }{}%
+ }%
}
}
{
\newcommand*{\glsxtruserparen}[2]{%
\glsxtrfullsep{#2}%
\glsxtrparen
- {#1\ifglshasfield{\glsxtruserfield}{#2}{, \@glo@thisvalue}{}}%
+ {#1\ifglshasfield{\glsxtruserfield}{#2}%
+ {\expandafter\glsxtrgenentrytextfmt\expandafter{\glsxtruserparensep}%
+ \glsxtruserfieldfmt{\expandafter\glsxtrgenentrytextfmt\expandafter{\@glo@thisvalue}}%
+ }{}%
+ }%
+ }
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtruserparen}
+%\changes{1.49}{??}{new}
+% As above but converts the user supplied information to all-caps.
+% The first argument should be provided in all-caps if required.
+% \begin{macrocode}
+\ifdef\glscurrentfieldvalue
+{
+ \newcommand*{\GLSxtruserparen}[2]{%
+ \glsxtrfullsep{#2}%
+ \glsxtrparen
+ {#1\ifglshasfield{\glsxtruserfield}{#2}%
+ {\expandafter\glsxtrgenentrytextfmt\expandafter{\glsxtruserparensep}%
+ \glsxtruserfieldfmt{\expandafter\mfirstucMakeUppercase\expandafter{\expandafter
+ \glsxtrgenentrytextfmt\expandafter{\glscurrentfieldvalue}}}%
+ }{}%
+ }%
+ }
+}
+{
+ \newcommand*{\GLSxtruserparen}[2]{%
+ \glsxtrfullsep{#2}%
+ \glsxtrparen
+ {#1\ifglshasfield{\glsxtruserfield}{#2}%
+ {\expandafter\glsxtrgenentrytextfmt\expandafter{\glsxtruserparensep}%
+ \glsxtruserfieldfmt{\expandafter\mfirstucMakeUppercase\expandafter{\expandafter
+ \glsxtrgenentrytextfmt\expandafter{\@glo@thisvalue}}}%
+ }{}%
+ }%
}
}
% \end{macrocode}
@@ -23024,6 +36229,8 @@ defined}{}%
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsexclapplyinnerfmtfield{\the\glslabeltok}{desc}%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{2}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -23046,24 +36253,28 @@ defined}{}%
% this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstlonguserfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtruserparen{\glsfirstabbrvuserfont{\glsaccessshort{##1}}}{##1}%
+ \glsxtruserlongshortformat{##1}{##2}%
+ {\glsfirstlonguserfont}{\glsfirstabbrvuserfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstlonguserfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtruserparen{\glsfirstabbrvuserfont{\glsaccessshortpl{##1}}}{##1}%
+ \glsxtruserlongshortplformat{##1}{##2}%
+ {\glsfirstlonguserfont}{\glsfirstabbrvuserfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstlonguserfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtruserparen{\glsfirstabbrvuserfont{\glsaccessshort{##1}}}{##1}%
+ \Glsxtruserlongshortformat{##1}{##2}%
+ {\glsfirstlonguserfont}{\glsfirstabbrvuserfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstlonguserfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtruserparen{\glsfirstabbrvuserfont{\glsaccessshortpl{##1}}}{##1}%
+ \Glsxtruserlongshortplformat{##1}{##2}%
+ {\glsfirstlonguserfont}{\glsfirstabbrvuserfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtruserlongshortformat{##1}{##2}%
+ {\glsfirstlonguserfont}{\glsfirstabbrvuserfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtruserlongshortplformat{##1}{##2}%
+ {\glsfirstlonguserfont}{\glsfirstabbrvuserfont}%
}%
}
% \end{macrocode}
@@ -23097,12 +36308,11 @@ defined}{}%
description={\protect\glsuserdescription{\the\glslongtok}%
{\the\glslabeltok}}}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsexclapplyinnerfmtfield{\the\glslabeltok}{desc}%
\csdef{glsxtrpostlink\glscategorylabel}{%
\glsxtrifwasfirstuse
{%
- \glsxtruserparen
- {\glsfirstabbrvuserfont{\glsentryshort{\glslabel}}}%
- {\glslabel}%
+ \glsxtrpostusershortformat{\glslabel}{\glsfirstabbrvuserfont}%
}%
{}%
}%
@@ -23127,43 +36337,22 @@ defined}{}%
%First use full form:
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstlonguserfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongformat{##1}{##2}{\glsfirstlonguserfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstlonguserfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongplformat{##1}{##2}{\glsfirstlonguserfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstlonguserfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongformat{##1}{##2}{\glsfirstlonguserfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstlonguserfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- }%
-% \end{macrocode}
-% In-line format:
-% \begin{macrocode}
- \renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstlonguserfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtruserparen{\glsfirstabbrvuserfont{\glsaccessshort{##1}}}{##1}%
+ \Glsxtrlongplformat{##1}{##2}{\glsfirstlonguserfont}%
}%
- \renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstlonguserfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtruserparen{\glsfirstabbrvuserfont{\glsaccessshortpl{##1}}}{##1}%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrlongformat{##1}{##2}{\glsfirstlonguserfont}%
}%
- \renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstlonguserfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtruserparen{\glsfirstabbrvuserfont{\glsaccessshort{##1}}}{##1}%
- }%
- \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstlonguserfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtruserparen{\glsfirstabbrvuserfont{\glsaccessshortpl{##1}}}{##1}%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrlongplformat{##1}{##2}{\glsfirstlonguserfont}%
}%
}
% \end{macrocode}
@@ -23189,8 +36378,14 @@ defined}{}%
\newcommand*{\glsxtrscusersuffix}{\glsxtrscsuffix}
% \end{macrocode}
%\end{macro}
+%\begin{macro}{\glsxtrscuserrevert}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrscuserrevert}{\glsxtrscrevert}
+% \end{macrocode}
+%\end{macro}
%
-%\begin{macro}{\glsxtrscusername}
+%\begin{macro}{\glsxtrlongshortscusername}
%\changes{1.48}{2021-11-22}{new}
% The default name format for this style.
% \begin{macrocode}
@@ -23201,8 +36396,8 @@ defined}{}%
%\end{macro}
%
%\begin{abbrvstyle}{long-postshort-sc-user}
-%\changes{1.48}{2017-02-03}{new}
-%Like \abbrstyle{long-short-sc-user} but uses smallcaps.
+%\changes{1.48}{2021-11-22}{new}
+%Like \abbrstyle{long-postshort-sc-user} but uses smallcaps.
% \begin{macrocode}
\newabbreviationstyle{long-postshort-sc-user}%
{%
@@ -23223,12 +36418,11 @@ defined}{}%
description={\protect\glsuserdescription{\the\glslongtok}%
{\the\glslabeltok}}}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsexclapplyinnerfmtfield{\the\glslabeltok}{desc}%
\csdef{glsxtrpostlink\glscategorylabel}{%
\glsxtrifwasfirstuse
{%
- \glsxtruserparen
- {\glsfirstabbrvscuserfont{\glsentryshort{\glslabel}}}%
- {\glslabel}%
+ \glsxtrpostusershortformat{\glslabel}{\glsfirstabbrvscuserfont}%
}%
{}%
}%
@@ -23249,47 +36443,54 @@ defined}{}%
\renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvscuserfont{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlonguserfont{##1}}%
\renewcommand*{\glslongfont}[1]{\glslonguserfont{##1}}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtrscuserrevert{##1}}%
% \end{macrocode}
%First use full form:
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstlonguserfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongformat{##1}{##2}{\glsfirstlonguserfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstlonguserfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongplformat{##1}{##2}{\glsfirstlonguserfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstlonguserfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongformat{##1}{##2}{\glsfirstlonguserfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstlonguserfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongplformat{##1}{##2}{\glsfirstlonguserfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrlongformat{##1}{##2}{\glsfirstlonguserfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrlongplformat{##1}{##2}{\glsfirstlonguserfont}%
}%
% \end{macrocode}
% In-line format:
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstlonguserfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtruserparen{\glsfirstabbrvscuserfont{\glsaccessshort{##1}}}{##1}%
+ \glsxtruserlongshortformat{##1}{##2}%
+ {\glsfirstlonguserfont}{\glsfirstabbrvscuserfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstlonguserfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtruserparen{\glsfirstabbrvscuserfont{\glsaccessshortpl{##1}}}{##1}%
+ \glsxtruserlongshortplformat{##1}{##2}%
+ {\glsfirstlonguserfont}{\glsfirstabbrvscuserfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstlonguserfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtruserparen{\glsfirstabbrvscuserfont{\glsaccessshort{##1}}}{##1}%
+ \Glsxtruserlongshortformat{##1}{##2}%
+ {\glsfirstlonguserfont}{\glsfirstabbrvscuserfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstlonguserfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtruserparen{\glsfirstabbrvscuserfont{\glsaccessshortpl{##1}}}{##1}%
+ \Glsxtruserlongshortplformat{##1}{##2}%
+ {\glsfirstlonguserfont}{\glsfirstabbrvscuserfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtruserlongshortformat{##1}{##2}%
+ {\glsfirstlonguserfont}{\glsfirstabbrvscuserfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtruserlongshortplformat{##1}{##2}%
+ {\glsfirstlonguserfont}{\glsfirstabbrvscuserfont}%
}%
}
% \end{macrocode}
@@ -23335,9 +36536,7 @@ defined}{}%
\csdef{glsxtrpostlink\glscategorylabel}{%
\glsxtrifwasfirstuse
{%
- \glsxtruserparen
- {\glsfirstabbrvuserfont{\glsentryshort{\glslabel}}}%
- {\glslabel}%
+ \glsxtrpostusershortformat{\glslabel}{\glsfirstabbrvuserfont}%
}%
{}%
}%
@@ -23391,9 +36590,7 @@ defined}{}%
\csdef{glsxtrpostlink\glscategorylabel}{%
\glsxtrifwasfirstuse
{%
- \glsxtruserparen
- {\glsfirstabbrvscuserfont{\glsentryshort{\glslabel}}}%
- {\glslabel}%
+ \glsxtrpostusershortformat{\glslabel}{\glsfirstabbrvscuserfont}%
}%
{}%
}%
@@ -23439,12 +36636,11 @@ defined}{}%
description={\protect\glsuserdescription{\the\glslongtok}%
{\the\glslabeltok}}}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsexclapplyinnerfmtfield{\the\glslabeltok}{desc}%
\csdef{glsxtrpostlink\glscategorylabel}{%
\glsxtrifwasfirstuse
{%
- \glsxtruserparen
- {\glsfirstlonguserfont{\glsentrylong{\glslabel}}}%
- {\glslabel}%
+ \glsxtrpostuserlongformat{\glslabel}{\glsfirstlonguserfont}%
}%
{}%
}%
@@ -23469,44 +36665,26 @@ defined}{}%
%First use full form:
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvuserfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortformat{##1}{##2}{\glsfirstabbrvuserfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvuserfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrshortplformat{##1}{##2}{\glsfirstabbrvuserfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvuserfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortformat{##1}{##2}{\glsfirstabbrvuserfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvuserfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrshortplformat{##1}{##2}{\glsfirstabbrvuserfont}%
}%
-% \end{macrocode}
-% In-line format:
-% \begin{macrocode}
- \renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvuserfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtruserparen{\glsfirstlonguserfont{\glsaccesslong{##1}}}{##1}%
- }%
- \renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvuserfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtruserparen{\glsfirstlonguserfont{\glsaccesslongpl{##1}}}{##1}%
- }%
- \renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvuserfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtruserparen{\glsfirstlonguserfont{\glsaccesslong{##1}}}{##1}%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshortformat{##1}{##2}{\glsfirstabbrvuserfont}%
}%
- \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvuserfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtruserparen{\glsfirstlonguserfont{\glsaccesslongpl{##1}}}{##1}%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshortplformat{##1}{##2}{\glsfirstabbrvuserfont}%
}%
+% \end{macrocode}
+% In-line format should be the same.
+% \begin{macrocode}
}
% \end{macrocode}
%\end{abbrvstyle}
@@ -23552,9 +36730,7 @@ defined}{}%
\csdef{glsxtrpostlink\glscategorylabel}{%
\glsxtrifwasfirstuse
{%
- \glsxtruserparen
- {\glsfirstlonguserfont{\glsentrylong{\glslabel}}}%
- {\glslabel}%
+ \glsxtrpostuserlongformat{\glslabel}{\glsfirstlonguserfont}%
}%
{}%
}%
@@ -23602,6 +36778,7 @@ defined}{}%
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{2}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -23652,6 +36829,8 @@ defined}{}%
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsexclapplyinnerfmtfield{\the\glslabeltok}{desc}%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{2}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -23674,24 +36853,28 @@ defined}{}%
% this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstabbrvuserfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtruserparen{\glsfirstlonguserfont{\glsaccesslong{##1}}}{##1}%
+ \glsxtrusershortlongformat{##1}{##2}%
+ {\glsfirstlonguserfont}{\glsfirstabbrvuserfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstabbrvuserfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtruserparen{\glsfirstlonguserfont{\glsaccesslongpl{##1}}}{##1}%
+ \glsxtrusershortlongplformat{##1}{##2}%
+ {\glsfirstlonguserfont}{\glsfirstabbrvuserfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstabbrvuserfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtruserparen{\glsfirstlonguserfont{\glsaccesslong{##1}}}{##1}%
+ \Glsxtrusershortlongformat{##1}{##2}%
+ {\glsfirstlonguserfont}{\glsfirstabbrvuserfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstabbrvuserfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtruserparen{\glsfirstlonguserfont{\glsaccesslongpl{##1}}}{##1}%
+ \Glsxtrusershortlongplformat{##1}{##2}%
+ {\glsfirstlonguserfont}{\glsfirstabbrvuserfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrusershortlongformat{##1}{##2}%
+ {\glsfirstlonguserfont}{\glsfirstabbrvuserfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrusershortlongplformat{##1}{##2}%
+ {\glsfirstlonguserfont}{\glsfirstabbrvuserfont}%
}%
}
% \end{macrocode}
@@ -23728,6 +36911,7 @@ defined}{}%
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{2}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -23781,6 +36965,11 @@ defined}{}%
%\end{definition}
%The \meta{long} and \meta{short} arguments may be the plural form.
%The \meta{long} argument may also be the first letter uppercase form.
+%This unfortunately doesn't fit in with the new \cs{glsxtrshortformat}
+%etc commands, but is retained for backward-compatibility.
+%This means that the inserted part has to have a separate encapsulation for the
+%inner format. The \meta{long} and \meta{short} arguments will need to include
+%the inner format.
% \begin{macrocode}
\newcommand*{\glsxtrlonghyphenshort}[4]{%
% \end{macrocode}
@@ -23788,18 +36977,89 @@ defined}{}%
% \begin{macrocode}
{%
% \end{macrocode}
-% If \meta{insert} starts with a hyphen, redefine \ics{glsxtrwordsep}
+% If \meta{insert} starts with a hyphen, redefine \cs{glsxtrwordsep}
% to a hyphen. The inserted material is also inserted into the
% parenthetical part. (The inserted material is grouped as a
% precautionary measure.) No change is made to \cs{glsxtrwordsep} if
% \meta{insert} doesn't start with a hyphen.
% \begin{macrocode}
- \glsxtrifhyphenstart{#4}{\def\glsxtrwordsep{-}}{}%
- \glsfirstlonghyphenfont{#2\ifglsxtrinsertinside{#4}\fi}%
- \ifglsxtrinsertinside\else{#4}\fi
+ \glsxtrifhyphenstart{#4}{\let\glsxtrwordsep\glsxtrwordsephyphen}{}%
+ \glsfirstlonghyphenfont{#2\ifglsxtrinsertinside
+ {\glsxtrgenentrytextfmt{#4}}\fi}%
+ \ifglsxtrinsertinside\else{\glsxtrgenentrytextfmt{#4}}\fi
\glsxtrfullsep{#1}%
- \glsxtrparen{\glsfirstabbrvhyphenfont{#3\ifglsxtrinsertinside{#4}\fi}%
- \ifglsxtrinsertinside\else{#4}\fi}%
+ \glsxtrparen{\glsfirstabbrvhyphenfont{#3\ifglsxtrinsertinside
+ {\glsxtrgenentrytextfmt{#4}}\fi}%
+ \ifglsxtrinsertinside\else{\glsxtrgenentrytextfmt{#4}}\fi}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrlonghyphenshort}
+%\changes{1.49}{??}{new}
+%As above but convert the insert to uppercase. The long and short
+%should already have the case-change applied.
+% \begin{macrocode}
+\newcommand*{\GLSxtrlonghyphenshort}[4]{%
+ {%
+ \glsxtrifhyphenstart{#4}{\let\glsxtrwordsep\glsxtrwordsephyphen}{}%
+ \glsfirstlonghyphenfont{#2\ifglsxtrinsertinside
+ {\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#4}}}\fi}%
+ \ifglsxtrinsertinside\else
+ {\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#4}}}%
+ \fi
+ \glsxtrfullsep{#1}%
+ \glsxtrparen{\glsfirstabbrvhyphenfont{#3\ifglsxtrinsertinside
+ {\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#4}}}\fi}%
+ \ifglsxtrinsertinside\else
+ {\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#4}}}%
+ \fi}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrshorthyphennolong}
+%\changes{1.49}{??}{new}
+%\begin{definition}
+%\cs{glsxtrshorthyphennolong}\marg{label}\marg{short}\marg{insert}
+%\end{definition}
+%The \meta{short} argument may be the plural form and may also be the first letter uppercase form.
+%
+%As \cs{glsxtrlonghyphenshort} but where only the short form should
+%be shown.
+% \begin{macrocode}
+\newcommand*{\glsxtrshorthyphennolong}[3]{%
+% \end{macrocode}
+% Grouping is needed to localise the redefinitions.
+% \begin{macrocode}
+ {%
+% \end{macrocode}
+% If \meta{insert} starts with a hyphen, redefine \cs{glsxtrwordsep}
+% to a hyphen.
+% \begin{macrocode}
+ \glsxtrifhyphenstart{#3}{\let\glsxtrwordsep\glsxtrwordsephyphen}{}%
+ \glsfirstabbrvhyphenfont{#2\ifglsxtrinsertinside
+ {\glsxtrgenentrytextfmt{#3}}\fi}%
+ \ifglsxtrinsertinside\else{\glsxtrgenentrytextfmt{#3}}\fi
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrshorthyphennolong}
+%\changes{1.49}{??}{new}
+%As above but all-caps.
+% \begin{macrocode}
+\newcommand*{\GLSxtrshorthyphennolong}[3]{%
+ {%
+ \glsxtrifhyphenstart{#3}{\let\glsxtrwordsep\glsxtrwordsephyphen}{}%
+ \glsfirstabbrvhyphenfont{#2\ifglsxtrinsertinside
+ {\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#3}}}\fi}%
+ \ifglsxtrinsertinside\else
+ {\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#3}}}%
+ \fi
}%
}
% \end{macrocode}
@@ -23836,6 +37096,12 @@ defined}{}%
\newcommand*{\glsxtrhyphensuffix}{\glsxtrabbrvpluralsuffix}
% \end{macrocode}
%\end{macro}
+%\begin{macro}{\glsxtrlonghyphenshortsort}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrlonghyphenshortsort}{\expandonce\glsxtrorgshort}
+% \end{macrocode}
+%\end{macro}
%
%\begin{abbrvstyle}{long-hyphen-short-hyphen}
%\changes{1.17}{2017-08-09}{new}
@@ -23853,13 +37119,13 @@ defined}{}%
% \begin{macrocode}
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrlongshortname},
- sort={\the\glsshorttok},
+ sort={\glsxtrlonghyphenshortsort},
first={\protect\glsfirstlonghyphenfont{\the\glslongtok}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvhyphenfont{\the\glsshorttok}}},%
+ \protect\glsxtrparen{\protect\glsfirstabbrvhyphenfont{\the\glsshorttok}}},%
firstplural={\protect\glsfirstlonghyphenfont{\the\glslongpltok}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvhyphenfont{\the\glsshortpltok}}},%
+ \protect\glsxtrparen{\protect\glsfirstabbrvhyphenfont{\the\glsshortpltok}}},%
text={\protect\glsabbrvhyphenfont{\the\glsshorttok}},%
plural={\protect\glsabbrvhyphenfont{\the\glsshortpltok}},%
description={\protect\glslonghyphenfont{\the\glslongtok}}}%
@@ -23867,6 +37133,8 @@ defined}{}%
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsexclapplyinnerfmtfield{\the\glslabeltok}{desc}%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -23885,18 +37153,218 @@ defined}{}%
% this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsxtrlonghyphenshort{##1}{\glsaccesslong{##1}}{\glsaccessshort{##1}}{##2}%
+ \glsxtrlonghyphenshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \glsaccesslong{##1}%
+ }%
+ {%
+ \glsaccessfmtlong{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \glsaccessshort{##1}%
+ }%
+ {%
+ \glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsxtrlonghyphenshort{##1}{\glsaccesslongpl{##1}}%
- {\glsaccessshortpl{##1}}{##2}%
+ \glsxtrlonghyphenshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \glsaccesslongpl{##1}%
+ }%
+ {%
+ \glsaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \glsaccessshortpl{##1}%
+ }%
+ {%
+ \glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsxtrlonghyphenshort{##1}{\Glsaccesslong{##1}}{\glsaccessshort{##1}}{##2}%
+ \glsxtrlonghyphenshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \Glsaccesslong{##1}%
+ }%
+ {%
+ \Glsaccessfmtlong{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \glsaccessshort{##1}%
+ }%
+ {%
+ \glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsxtrlonghyphenshort{##1}{\Glsaccesslongpl{##1}}%
- {\glsaccessshortpl{##1}}{##2}%
+ \glsxtrlonghyphenshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \Glsaccesslongpl{##1}%
+ }%
+ {%
+ \Glsaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \glsaccessshortpl{##1}%
+ }%
+ {%
+ \glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrlonghyphenshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \GLSaccesslong{##1}%
+ }%
+ {%
+ \GLSaccessfmtlong{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \GLSaccessshort{##1}%
+ }%
+ {%
+ \GLSaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrlonghyphenshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \GLSaccesslongpl{##1}%
+ }%
+ {%
+ \GLSaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \GLSaccessshortpl{##1}%
+ }%
+ {%
+ \GLSaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+% \end{macrocode}
+%Subsequent form also needs checking for a hyphen in case the short
+%form has spaces.
+% \begin{macrocode}
+ \renewcommand*{\glsxtrsubsequentfmt}[2]{%
+ \glsxtrshorthyphennolong{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \glsaccessshort{##1}%
+ }%
+ {%
+ \glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\glsxtrsubsequentplfmt}[2]{%
+ \glsxtrshorthyphennolong{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \glsaccessshortpl{##1}%
+ }%
+ {%
+ \glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\Glsxtrsubsequentfmt}[2]{%
+ \glsxtrshorthyphennolong{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \Glsaccessshort{##1}%
+ }%
+ {%
+ \Glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
+ \glsxtrshorthyphennolong{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \Glsaccessshortpl{##1}%
+ }%
+ {%
+ \Glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentfmt}[2]{%
+ \GLSxtrshorthyphennolong{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \GLSaccessshort{##1}%
+ }%
+ {%
+ \GLSaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentplfmt}[2]{%
+ \GLSxtrshorthyphennolong{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \GLSaccessshortpl{##1}%
+ }%
+ {%
+ \GLSaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
}
% \end{macrocode}
@@ -23921,10 +37389,10 @@ defined}{}%
sort={\glsxtrlongshortdescsort},
first={\protect\glsfirstlonghyphenfont{\the\glslongtok}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvhyphenfont{\the\glsshorttok}}},%
+ \protect\glsxtrparen{\protect\glsfirstabbrvhyphenfont{\the\glsshorttok}}},%
firstplural={\protect\glsfirstlonghyphenfont{\the\glslongpltok}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstabbrvhyphenfont{\the\glsshortpltok}}},%
+ \protect\glsxtrparen{\protect\glsfirstabbrvhyphenfont{\the\glsshortpltok}}},%
text={\protect\glsabbrvhyphenfont{\the\glsshorttok}},%
plural={\protect\glsabbrvhyphenfont{\the\glsshortpltok}}%
}%
@@ -23932,6 +37400,7 @@ defined}{}%
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -23950,6 +37419,10 @@ defined}{}%
%\begin{definition}
%\cs{glsxtrlonghyphennoshort}\marg{label}\marg{long}\marg{insert}
%\end{definition}
+%As with \cs{glsxtrlonghyphenshort} this doesn't fit in with the
+%new \cs{glsxtrshortformat} so the inserted part has to have a separate encapsulation for the
+%inner format. The \meta{long} argument will need to include
+%the inner format.
% \begin{macrocode}
\newcommand*{\glsxtrlonghyphennoshort}[3]{%
% \end{macrocode}
@@ -23957,20 +37430,45 @@ defined}{}%
% \begin{macrocode}
{%
% \end{macrocode}
-% If \meta{insert} starts with a hyphen, redefine \ics{glsxtrwordsep}
+% If \meta{insert} starts with a hyphen, redefine \cs{glsxtrwordsep}
% to a hyphen. The inserted material is also inserted into the
% parenthetical part. (The inserted material is grouped as a
% precautionary measure.) No change is made to \cs{glsxtrwordsep} if
% \meta{insert} doesn't start with a hyphen.
% \begin{macrocode}
- \glsxtrifhyphenstart{#3}{\def\glsxtrwordsep{-}}{}%
- \glsfirstlonghyphenfont{#2\ifglsxtrinsertinside{#3}\fi}%
- \ifglsxtrinsertinside\else{#3}\fi
+ \glsxtrifhyphenstart{#3}{\let\glsxtrwordsep\glsxtrwordsephyphen}{}%
+ \glsfirstlonghyphenfont{#2\ifglsxtrinsertinside
+ {\glsxtrgenentrytextfmt{#3}}\fi}%
+ \ifglsxtrinsertinside\else{\glsxtrgenentrytextfmt{#3}}\fi
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrlonghyphennoshort}
+%\changes{1.49}{??}{new}
+%As above but convert insert to all-caps.
+% \begin{macrocode}
+\newcommand*{\GLSxtrlonghyphennoshort}[3]{%
+ {%
+ \glsxtrifhyphenstart{#3}{\let\glsxtrwordsep\glsxtrwordsephyphen}{}%
+ \glsfirstlonghyphenfont{#2\ifglsxtrinsertinside
+ {\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#3}}}\fi}%
+ \ifglsxtrinsertinside\else
+ {\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#3}}}%
+ \fi
}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtrlonghyphennoshortdescsort}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrlonghyphennoshortdescsort}{\expandonce\glsxtrorglong}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{abbrvstyle}{long-hyphen-noshort-desc-noreg}
%\changes{1.17}{2017-08-09}{new}
%\changes{1.42}{2020-02-03}{added missing text key}
@@ -23985,7 +37483,7 @@ defined}{}%
{%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrlongnoshortdescname},
- sort={\expandonce\glsxtrorglong},
+ sort={\glsxtrlonghyphennoshortdescsort},
first={\protect\glsfirstlonghyphenfont{\the\glslongtok}},%
firstplural={\protect\glsfirstlonghyphenfont{\the\glslongpltok}},%
text={\protect\glslonghyphenfont{\the\glslongtok}},%
@@ -24003,7 +37501,6 @@ defined}{}%
}%
}%
{%
- \GlsXtrUseAbbrStyleFmts{long-hyphen-short-hyphen}%
% \end{macrocode}
% In case the user wants to mix and match font styles, these are
% redefined here.
@@ -24014,64 +37511,315 @@ defined}{}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlonghyphenfont{##1}}%
\renewcommand*{\glslongfont}[1]{\glslonghyphenfont{##1}}%
% \end{macrocode}
-% The format for subsequent use (not used when the regular attribute
-% is set).
-% \begin{macrocode}
- \renewcommand*{\glsxtrsubsequentfmt}[2]{%
- \glsxtrlonghyphennoshort{##1}{\glsaccesslong{##1}}{##2}%
- }%
- \renewcommand*{\glsxtrsubsequentplfmt}[2]{%
- \glsxtrlonghyphennoshort{##1}{\glsaccesslongpl{##1}}{##2}%
- }%
- \renewcommand*{\Glsxtrsubsequentfmt}[2]{%
- \glsxtrlonghyphennoshort{##1}{\Glsaccesslong{##1}}{##2}%
- }%
- \renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
- \glsxtrlonghyphennoshort{##1}{\Glsaccesslongpl{##1}}{##2}%
- }%
-% \end{macrocode}
% The inline full form displays the long format followed by the
-% short form in parentheses.
+% short form in parentheses (as long-hyphen-short-hyphen).
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsxtrlonghyphennoshort{##1}{\glsaccesslong{##1}}{##2}%
- \glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshort{##1}}}%
+ \glsxtrlonghyphenshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \glsaccesslong{##1}%
+ }%
+ {%
+ \glsaccessfmtlong{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \glsaccessshort{##1}%
+ }%
+ {%
+ \glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsxtrlonghyphennoshort{##1}{\glsaccesslongpl{##1}}{##2}%
- \glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshortpl{##1}}}%
+ \glsxtrlonghyphenshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \glsaccesslongpl{##1}%
+ }%
+ {%
+ \glsaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \glsaccessshortpl{##1}%
+ }%
+ {%
+ \glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsxtrlonghyphennoshort{##1}{\Glsaccesslong{##1}}{##2}%
- \glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshort{##1}}}%
+ \glsxtrlonghyphenshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \Glsaccesslong{##1}%
+ }%
+ {%
+ \Glsaccessfmtlong{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \glsaccessshort{##1}%
+ }%
+ {%
+ \glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsxtrlonghyphennoshort{##1}{\Glsaccesslongpl{##1}}{##2}%
- \glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshortpl{##1}}}%
+ \glsxtrlonghyphenshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \Glsaccesslongpl{##1}%
+ }%
+ {%
+ \Glsaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \glsaccessshortpl{##1}%
+ }%
+ {%
+ \glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrlonghyphenshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \GLSaccesslong{##1}%
+ }%
+ {%
+ \GLSaccessfmtlong{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \GLSaccessshort{##1}%
+ }%
+ {%
+ \GLSaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrlonghyphenshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \GLSaccesslongpl{##1}%
+ }%
+ {%
+ \GLSaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \GLSaccessshortpl{##1}%
+ }%
+ {%
+ \GLSaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
% \end{macrocode}
% The first use full form only displays the long form.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsxtrlonghyphennoshort{##1}{\glsaccesslong{##1}}{##2}%
+ \glsxtrlonghyphennoshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \glsaccesslong{##1}%
+ }%
+ {%
+ \glsaccessfmtlong{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsxtrlonghyphennoshort{##1}{\glsaccesslongpl{##1}}{##2}%
+ \glsxtrlonghyphennoshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \glsaccesslongpl{##1}%
+ }%
+ {%
+ \glsaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsxtrlonghyphennoshort{##1}{\Glsaccesslong{##1}}{##2}%
+ \glsxtrlonghyphennoshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \Glsaccesslong{##1}%
+ }%
+ {%
+ \Glsaccessfmtlong{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsxtrlonghyphennoshort{##1}{\Glsaccesslongpl{##1}}{##2}%
+ \glsxtrlonghyphennoshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \Glsaccesslongpl{##1}%
+ }%
+ {%
+ \Glsaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrlonghyphennoshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \GLSaccesslong{##1}%
+ }%
+ {%
+ \GLSaccessfmtlong{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrlonghyphennoshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \GLSaccesslongpl{##1}%
+ }%
+ {%
+ \GLSaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+% \end{macrocode}
+% The format for subsequent use (not used when the regular attribute
+% is set).
+% \begin{macrocode}
+ \renewcommand*{\glsxtrsubsequentfmt}[2]{%
+ \glsxtrlonghyphennoshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \glsaccesslong{##1}%
+ }%
+ {%
+ \glsaccessfmtlong{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\glsxtrsubsequentplfmt}[2]{%
+ \glsxtrlonghyphennoshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \glsaccesslongpl{##1}%
+ }%
+ {%
+ \glsaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\Glsxtrsubsequentfmt}[2]{%
+ \glsxtrlonghyphennoshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \Glsaccesslong{##1}%
+ }%
+ {%
+ \Glsaccessfmtlong{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
+ \glsxtrlonghyphennoshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \Glsaccesslongpl{##1}%
+ }%
+ {%
+ \Glsaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentfmt}[2]{%
+ \GLSxtrlonghyphennoshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \GLSaccesslong{##1}%
+ }%
+ {%
+ \GLSaccessfmtlong{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentplfmt}[2]{%
+ \GLSxtrlonghyphennoshort{##1}%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \GLSaccesslongpl{##1}%
+ }%
+ {%
+ \GLSaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
}
% \end{macrocode}
%\end{abbrvstyle}
%
+%\begin{macro}{\glsxtrlonghyphennoshortsort}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrlonghyphennoshortsort}{\expandonce\glsxtrorgshort}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{abbrvstyle}{long-hyphen-noshort-noreg}
%\changes{1.17}{2017-08-09}{new}
% It doesn't really make a great deal of sense to have a long-only
@@ -24091,7 +37839,7 @@ defined}{}%
% \begin{macrocode}
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrlongnoshortname},
- sort={\the\glsshorttok},
+ sort={\glsxtrlonghyphennoshortsort},
first={\protect\glsfirstlonghyphenfont{\the\glslongtok}},%
firstplural={\protect\glsfirstlonghyphenfont{\the\glslongpltok}},%
text={\protect\glslonghyphenfont{\the\glslongtok}},%
@@ -24126,13 +37874,16 @@ defined}{}%
%Used by \abbrstyle{long-hyphen-postshort-hyphen}. The \meta{insert}
%is check to determine if it starts with a hyphen but isn't used
%here as it's moved to the post-link hook.
+%
+%The \meta{long} argument will need to include
+%the inner format.
% \begin{macrocode}
\newcommand*{\glsxtrlonghyphen}[3]{%
% \end{macrocode}
% Grouping is needed to localise the redefinitions.
% \begin{macrocode}
{%
- \glsxtrifhyphenstart{#3}{\def\glsxtrwordsep{-}}{}%
+ \glsxtrifhyphenstart{#3}{\let\glsxtrwordsep\glsxtrwordsephyphen}{}%
\glsfirstlonghyphenfont{#1}%
}%
}
@@ -24151,29 +37902,176 @@ defined}{}%
% \begin{macrocode}
\newcommand*{\glsxtrposthyphenshort}[2]{%
{%
- \glsxtrifhyphenstart{#2}{\def\glsxtrwordsep{-}}{}%
- \ifglsxtrinsertinside{\glsfirstlonghyphenfont{#2}}\else{#2}\fi
+ \glsxtrifhyphenstart{#2}{\let\glsxtrwordsep\glsxtrwordsephyphen}{}%
+ \ifglsxtrinsertinside
+ {\glsfirstlonghyphenfont{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ {\glsxtrgenentrytextfmt{#2}}%
+ \fi
\glsxtrfullsep{#1}%
\glsxtrparen
- {\glsfirstabbrvhyphenfont{\glsentryshort{#1}\ifglsxtrinsertinside{#2}\fi}%
- \ifglsxtrinsertinside\else{#2}\fi
+ {%
+ \glsxtrshortformat{#1}{#2}{\glsfirstabbrvhyphenfont}%
}%
}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\GLSxtrposthyphenshort}
+%\changes{1.49}{??}{new}
+%As above but all caps.
+% \begin{macrocode}
+\newcommand*{\GLSxtrposthyphenshort}[2]{%
+ {%
+ \glsxtrifhyphenstart{#2}{\let\glsxtrwordsep\glsxtrwordsephyphen}{}%
+ \ifglsxtrinsertinside
+ {\glsfirstlonghyphenfont{\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}}%
+ \else
+ {\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}%
+ \fi
+ \glsxtrfullsep{#1}%
+ \glsxtrparen
+ {%
+ \GLSxtrshortformat{#1}{#2}{\glsfirstabbrvhyphenfont}%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrposthyphenshortpl}
+%\changes{1.49}{??}{new}
+%As above but plural.
+% \begin{macrocode}
+\newcommand*{\glsxtrposthyphenshortpl}[2]{%
+ {%
+ \glsxtrifhyphenstart{#2}{\let\glsxtrwordsep\glsxtrwordsephyphen}{}%
+ \ifglsxtrinsertinside
+ {\glsfirstlonghyphenfont{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ {\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ \glsxtrfullsep{#1}%
+ \glsxtrparen
+ {%
+ \glsxtrshortplformat{#1}{#2}{\glsfirstabbrvhyphenfont}%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrposthyphenshortpl}
+%\changes{1.49}{??}{new}
+%As above but all caps.
+% \begin{macrocode}
+\newcommand*{\GLSxtrposthyphenshortpl}[2]{%
+ {%
+ \glsxtrifhyphenstart{#2}{\let\glsxtrwordsep\glsxtrwordsephyphen}{}%
+ \ifglsxtrinsertinside
+ {\glsfirstlonghyphenfont{\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}}%
+ \else
+ {\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}%
+ \fi
+ \glsxtrfullsep{#1}%
+ \glsxtrparen
+ {%
+ \GLSxtrshortplformat{#1}{#2}{\glsfirstabbrvhyphenfont}%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\xpglsxtrposthyphenshort}
+%\changes{1.49}{??}{new}
+%Expand placeholders and check for all caps.
+% \begin{macrocode}
+\newcommand*{\xpglsxtrposthyphenshort}{%
+ \glsxtrifallcaps
+ {%
+ \expandafter\GLSxtrposthyphenshort\expandafter\glslabel
+ \expandafter{\glsinsert}%
+ }%
+ {%
+ \expandafter\glsxtrposthyphenshort\expandafter\glslabel
+ \expandafter{\glsinsert}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsxtrposthyphensubsequent}
%\changes{1.17}{2017-08-09}{new}
%\begin{definition}
%\cs{glsxtrposthyphensubsequent}\marg{label}\marg{insert}
%\end{definition}
%Format in the post-link hook for subsequent use. The label is
-%ignored by default.
+%ignored by default. This just does the insert part with appropriate formatting.
% \begin{macrocode}
\newcommand*{\glsxtrposthyphensubsequent}[2]{%
- \glsabbrvfont{\ifglsxtrinsertinside {#2}\fi}%
- \ifglsxtrinsertinside \else{#2}\fi
+ \ifglsxtrinsertinside
+ \glsabbrvfont{{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ {\glsxtrgenentrytextfmt{#2}}%
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrposthyphensubsequent}
+%\changes{1.49}{??}{new}
+%As above but all caps.
+% \begin{macrocode}
+\newcommand*{\GLSxtrposthyphensubsequent}[2]{%
+ \ifglsxtrinsertinside
+ \glsabbrvfont{{\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}}%
+ \else
+ {\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}%
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\xpglsxtrposthyphensubsequent}
+%\changes{1.49}{??}{new}
+%Expand placeholders and check for all caps.
+% \begin{macrocode}
+\newcommand*{\xpglsxtrposthyphensubsequent}{%
+ \glsxtrifallcaps
+ {%
+ \expandafter\GLSxtrposthyphensubsequent\expandafter\glslabel
+ \expandafter{\glsinsert}%
+ }%
+ {%
+ \expandafter\glsxtrposthyphensubsequent\expandafter\glslabel
+ \expandafter{\glsinsert}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrshorthyphennoinsert}
+%\changes{1.17}{2017-08-09}{new}
+%\begin{definition}
+%\cs{glsxtrshorthyphennoinsert}\marg{label}\marg{short}\marg{insert}
+%\end{definition}
+%As with \cs{glsxtrshorthyphennolong} but doesn't actually show the
+%insert.
+% \begin{macrocode}
+\newcommand*{\glsxtrshorthyphennoinsert}[3]{%
+% \end{macrocode}
+% Grouping is needed to localise the redefinitions.
+% \begin{macrocode}
+ {%
+% \end{macrocode}
+% If \meta{insert} starts with a hyphen, redefine \cs{glsxtrwordsep}
+% to a hyphen.
+% \begin{macrocode}
+ \glsxtrifhyphenstart{#3}{\let\glsxtrwordsep\glsxtrwordsephyphen}{}%
+ \glsfirstabbrvhyphenfont{#2}%
+ }%
}
% \end{macrocode}
%\end{macro}
@@ -24195,23 +38093,24 @@ defined}{}%
% \begin{macrocode}
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrlongshortname},
- sort={\the\glsshorttok},
+ sort={\glsxtrlonghyphenshortsort},
first={\protect\glsfirstlonghyphenfont{\the\glslongtok}},%
firstplural={\protect\glsfirstlonghyphenfont{\the\glslongpltok}},%
text={\protect\glsabbrvhyphenfont{\the\glsshorttok}},%
plural={\protect\glsabbrvhyphenfont{\the\glsshortpltok}},%
description={\protect\glslonghyphenfont{\the\glslongtok}}}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsexclapplyinnerfmtfield{\the\glslabeltok}{desc}%
\csdef{glsxtrpostlink\glscategorylabel}{%
\glsxtrifwasfirstuse
{%
- \glsxtrposthyphenshort{\glslabel}{\glsinsert}%
+ \xpglsxtrposthyphenshort
}%
{%
% \end{macrocode}
% Put the insertion into the post-link:
% \begin{macrocode}
- \glsxtrposthyphensubsequent{\glslabel}{\glsinsert}%
+ \xpglsxtrposthyphensubsequent
}%
}%
\glshasattribute{\the\glslabeltok}{regular}%
@@ -24232,57 +38131,188 @@ defined}{}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlonghyphenfont{##1}}%
\renewcommand*{\glslongfont}[1]{\glslonghyphenfont{##1}}%
% \end{macrocode}
-% Subsequent use needs to omit the insertion:
+% Subsequent use needs to omit the insertion but it needs to perform
+% the space-hyphen substitution:
% \begin{macrocode}
\renewcommand*{\glsxtrsubsequentfmt}[2]{%
- \glsabbrvfont{\glsaccessshort{##1}}%
+ \glsxtrshorthyphennoinsert{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \glsaccessshort{##1}%
+ }%
+ {%
+ \glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
\renewcommand*{\glsxtrsubsequentplfmt}[2]{%
- \glsabbrvfont{\glsaccessshortpl{##1}}%
+ \glsxtrshorthyphennoinsert{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \glsaccessshortpl{##1}%
+ }%
+ {%
+ \glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
\renewcommand*{\Glsxtrsubsequentfmt}[2]{%
- \glsabbrvfont{\Glsaccessshort{##1}}%
+ \glsxtrshorthyphennoinsert{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \Glsaccessshort{##1}%
+ }%
+ {%
+ \Glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
\renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
- \glsabbrvfont{\Glsaccessshortpl{##1}}%
+ \glsxtrshorthyphennoinsert{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \Glsaccessshortpl{##1}%
+ }%
+ {%
+ \Glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentfmt}[2]{%
+ \glsxtrshorthyphennoinsert{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \GLSaccessshort{##1}%
+ }%
+ {%
+ \GLSaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentplfmt}[2]{%
+ \glsxtrshorthyphennoinsert{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \GLSaccessshortpl{##1}%
+ }%
+ {%
+ \GLSaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
% \end{macrocode}
% First use full form:
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsxtrlonghyphen{\glsaccesslong{##1}}{##1}{##2}%
+ \glsxtrlonghyphen
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \glsaccesslong{##1}%
+ }%
+ {%
+ \glsaccessfmtlong{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##1}{##2}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsxtrlonghyphen{\glsaccesslongpl{##1}}{##1}{##2}%
+ \glsxtrlonghyphen
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \glsaccesslongpl{##1}%
+ }%
+ {%
+ \glsaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##1}{##2}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsxtrlonghyphen{\Glsaccesslong{##1}}{##1}{##2}%
+ \glsxtrlonghyphen
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \Glsaccesslong{##1}%
+ }%
+ {%
+ \Glsaccessfmtlong{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##1}{##2}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsxtrlonghyphen{\Glsaccesslongpl{##1}}{##1}{##2}%
+ \glsxtrlonghyphen
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \Glsaccesslongpl{##1}%
+ }%
+ {%
+ \Glsaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##1}{##2}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \glsxtrlonghyphen
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \GLSaccesslong{##1}%
+ }%
+ {%
+ \GLSaccessfmtlong{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##1}{##2}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \glsxtrlonghyphen
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \GLSaccesslongpl{##1}%
+ }%
+ {%
+ \GLSaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##1}{##2}%
}%
% \end{macrocode}
% In-line format.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstlonghyphenfont{\glsaccesslong{##1}%
- \ifglsxtrinsertinside{##2}\fi}%
- \ifglsxtrinsertinside \else{##2}\fi
+ \glsxtrlongformatgrp{##1}{##2}{\glsfirstlonghyphenfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstlonghyphenfont{\glsaccesslongpl{##1}%
- \ifglsxtrinsertinside{##2}\fi}%
- \ifglsxtrinsertinside \else{##2}\fi
+ \glsxtrlongplformatgrp{##1}{##2}{\glsfirstlonghyphenfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstlonghyphenfont{\Glsaccesslong{##1}%
- \ifglsxtrinsertinside{##2}\fi}%
- \ifglsxtrinsertinside \else{##2}\fi
+ \Glsxtrlongformatgrp{##1}{##2}{\glsfirstlonghyphenfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstlonghyphenfont{\Glsaccesslongpl{##1}%
- \ifglsxtrinsertinside{##2}\fi}%
- \ifglsxtrinsertinside \else{##2}\fi
+ \Glsxtrlongplformatgrp{##1}{##2}{\glsfirstlonghyphenfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrlongformatgrp{##1}{##2}{\glsfirstlonghyphenfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrlongplformatgrp{##1}{##2}{\glsfirstlonghyphenfont}%
}%
}
% \end{macrocode}
@@ -24314,13 +38344,13 @@ defined}{}%
\csdef{glsxtrpostlink\glscategorylabel}{%
\glsxtrifwasfirstuse
{%
- \glsxtrposthyphenshort{\glslabel}{\glsinsert}%
+ \xpglsxtrposthyphenshort
}%
{%
% \end{macrocode}
% Put the insertion into the post-link:
% \begin{macrocode}
- \glsxtrposthyphensubsequent{\glslabel}{\glsinsert}%
+ \xpglsxtrposthyphensubsequent
}%
}%
\glshasattribute{\the\glslabeltok}{regular}%
@@ -24343,6 +38373,11 @@ defined}{}%
%\end{definition}
%The \meta{long} and \meta{short} arguments may be the plural form.
%The \meta{long} argument may also be the first letter uppercase form.
+%
+%As with \cs{glsxtrlonghyphenshort} this doesn't fit in with the
+%new \cs{glsxtrshortformat} so the inserted part has to have a separate encapsulation for the
+%inner format. The \meta{long} argument will need to include
+%the inner format.
% \begin{macrocode}
\newcommand*{\glsxtrshorthyphenlong}[4]{%
% \end{macrocode}
@@ -24355,17 +38390,50 @@ defined}{}%
% parenthetical part. (The inserted material is grouped as a
% precautionary measure.)
% \begin{macrocode}
- \glsxtrifhyphenstart{#4}{\def\glsxtrwordsep{-}}{}%
- \glsfirstabbrvhyphenfont{#2\ifglsxtrinsertinside{#4}\fi}%
- \ifglsxtrinsertinside\else{#4}\fi
+ \glsxtrifhyphenstart{#4}{\let\glsxtrwordsep\glsxtrwordsephyphen}{}%
+ \glsfirstabbrvhyphenfont{#2\ifglsxtrinsertinside
+ {\glsxtrgenentrytextfmt{#4}}\fi}%
+ \ifglsxtrinsertinside\else{\glsxtrgenentrytextfmt{#4}}\fi
\glsxtrfullsep{#1}%
- \glsxtrparen{\glsfirstlonghyphenfont{#3\ifglsxtrinsertinside{#4}\fi}%
- \ifglsxtrinsertinside\else{#4}\fi}%
+ \glsxtrparen{\glsfirstlonghyphenfont{#3%
+ \ifglsxtrinsertinside{\glsxtrgenentrytextfmt{#4}}\fi}%
+ \ifglsxtrinsertinside\else{\glsxtrgenentrytextfmt{#4}}\fi}%
}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\GLSxtrshorthyphenlong}
+%\changes{1.49}{??}{new}
+%As above but convert insert to all-caps. The long and short form
+%arguments should be provided as all-caps.
+% \begin{macrocode}
+\newcommand*{\GLSxtrshorthyphenlong}[4]{%
+ {%
+ \glsxtrifhyphenstart{#4}{\let\glsxtrwordsep\glsxtrwordsephyphen}{}%
+ \glsfirstabbrvhyphenfont{#2\ifglsxtrinsertinside
+ {\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#4}}}\fi}%
+ \ifglsxtrinsertinside\else
+ {\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#4}}}%
+ \fi
+ \glsxtrfullsep{#1}%
+ \glsxtrparen{\glsfirstlonghyphenfont{#3%
+ \ifglsxtrinsertinside{\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#4}}}\fi}%
+ \ifglsxtrinsertinside\else
+ {\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#4}}}%
+ \fi}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrshorthyphenlongsort}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrshorthyphenlongsort}{\expandonce\glsxtrorgshort}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{abbrvstyle}{short-hyphen-long-hyphen}
%\changes{1.17}{2017-08-09}{new}
%\changes{1.42}{2020-02-03}{added missing text key}
@@ -24382,13 +38450,13 @@ defined}{}%
% \begin{macrocode}
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrshortlongname},
- sort={\the\glsshorttok},
+ sort={\glsxtrshorthyphenlongsort},
first={\protect\glsfirstabbrvhyphenfont{\the\glsshorttok}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlonghyphenfont{\the\glslongtok}}},%
+ \protect\glsxtrparen{\protect\glsfirstlonghyphenfont{\the\glslongtok}}},%
firstplural={\protect\glsfirstabbrvhyphenfont{\the\glsshortpltok}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlonghyphenfont{\the\glslongpltok}}},%
+ \protect\glsxtrparen{\protect\glsfirstlonghyphenfont{\the\glslongpltok}}},%
text={\protect\glsabbrvhyphenfont{\the\glsshorttok}},%
plural={\protect\glsabbrvhyphenfont{\the\glsshortpltok}},%
description={\protect\glslonghyphenfont{\the\glslongtok}}}%
@@ -24396,6 +38464,8 @@ defined}{}%
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsexclapplyinnerfmtfield{\the\glslabeltok}{desc}%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -24414,18 +38484,218 @@ defined}{}%
% this style.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsxtrshorthyphenlong{##1}{\glsaccessshort{##1}}{\glsaccesslong{##1}}{##2}%
+ \glsxtrshorthyphenlong{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \glsaccessshort{##1}%
+ }%
+ {%
+ \glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \glsaccesslong{##1}%
+ }%
+ {%
+ \glsaccessfmtlong{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
\glsxtrshorthyphenlong{##1}%
- {\glsaccessshortpl{##1}}{\glsaccesslongpl{##1}}{##2}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \glsaccessshortpl{##1}%
+ }%
+ {%
+ \glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {%
+ \glsifattribute{##1}{marklongwords}{true}%
+ {%
+ \glsaccesslongpl{##1}%
+ }%
+ {%
+ \glsaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsxtrshorthyphenlong{##1}{\glsaccessshort{##1}}{\Glsaccesslong{##1}}{##2}%
+ \glsxtrshorthyphenlong{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \Glsaccessshort{##1}%
+ }%
+ {%
+ \Glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \glsaccesslong{##1}%
+ }%
+ {%
+ \glsaccessfmtlong{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
\glsxtrshorthyphenlong{##1}%
- {\glsaccessshortpl{##1}}{\Glsaccesslongpl{##1}}{##2}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \Glsaccessshortpl{##1}%
+ }%
+ {%
+ \Glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \glsaccesslongpl{##1}%
+ }%
+ {%
+ \glsaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrshorthyphenlong{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \GLSaccessshort{##1}%
+ }%
+ {%
+ \GLSaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \GLSaccesslong{##1}%
+ }%
+ {%
+ \GLSaccessfmtlong{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrshorthyphenlong{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \GLSaccessshortpl{##1}%
+ }%
+ {%
+ \GLSaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {%
+ \glsifattribute{##1}{markwords}{true}%
+ {%
+ \GLSaccesslongpl{##1}%
+ }%
+ {%
+ \GLSaccessfmtlongpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+% \end{macrocode}
+%Subsequent form also needs checking for a hyphen in case the short
+%form has spaces.
+% \begin{macrocode}
+ \renewcommand*{\glsxtrsubsequentfmt}[2]{%
+ \glsxtrshorthyphennolong{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \glsaccessshort{##1}%
+ }%
+ {%
+ \glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\glsxtrsubsequentplfmt}[2]{%
+ \glsxtrshorthyphennolong{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \glsaccessshortpl{##1}%
+ }%
+ {%
+ \glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\Glsxtrsubsequentfmt}[2]{%
+ \glsxtrshorthyphennolong{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \Glsaccessshort{##1}%
+ }%
+ {%
+ \Glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
+ \glsxtrshorthyphennolong{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \Glsaccessshortpl{##1}%
+ }%
+ {%
+ \Glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentfmt}[2]{%
+ \GLSxtrshorthyphennolong{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \GLSaccessshort{##1}%
+ }%
+ {%
+ \GLSaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentplfmt}[2]{%
+ \GLSxtrshorthyphennolong{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \GLSaccessshortpl{##1}%
+ }%
+ {%
+ \GLSaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
}
% \end{macrocode}
@@ -24450,10 +38720,10 @@ defined}{}%
sort={\glsxtrshortlongdescsort},
first={\protect\glsfirstabbrvhyphenfont{\the\glsshorttok}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlonghyphenfont{\the\glslongtok}}},%
+ \protect\glsxtrparen{\protect\glsfirstlonghyphenfont{\the\glslongtok}}},%
firstplural={\protect\glsfirstabbrvhyphenfont{\the\glsshortpltok}%
\protect\glsxtrfullsep{\the\glslabeltok}%
- \glsxtrparen{\protect\glsfirstlonghyphenfont{\the\glslongpltok}}},%
+ \protect\glsxtrparen{\protect\glsfirstlonghyphenfont{\the\glslongpltok}}},%
text={\protect\glsabbrvhyphenfont{\the\glsshorttok}},%
plural={\protect\glsabbrvhyphenfont{\the\glsshortpltok}}%
}%
@@ -24461,6 +38731,7 @@ defined}{}%
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsxtrsetcomplexstyle{\the\glslabeltok}{3}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -24480,7 +38751,7 @@ defined}{}%
%\cs{glsxtrshorthyphen}\marg{short}\marg{label}\marg{insert}
%\end{definition}
%Used by \abbrstyle{short-hyphen-postlong-hyphen}. The \meta{insert}
-%is check to determine if it starts with a hyphen but isn't used
+%is checked to determine if it starts with a hyphen but isn't used
%here as it's moved to the post-link hook.
% \begin{macrocode}
\newcommand*{\glsxtrshorthyphen}[3]{%
@@ -24488,7 +38759,7 @@ defined}{}%
% Grouping is needed to localise the redefinitions.
% \begin{macrocode}
{%
- \glsxtrifhyphenstart{#3}{\def\glsxtrwordsep{-}}{}%
+ \glsxtrifhyphenstart{#3}{\let\glsxtrwordsep\glsxtrwordsephyphen}{}%
\glsfirstabbrvhyphenfont{#1}%
}%
}
@@ -24507,18 +38778,98 @@ defined}{}%
% \begin{macrocode}
\newcommand*{\glsxtrposthyphenlong}[2]{%
{%
- \glsxtrifhyphenstart{#2}{\def\glsxtrwordsep{-}}{}%
- \ifglsxtrinsertinside{\glsfirstabbrvhyphenfont{#2}}\else{#2}\fi
+ \glsxtrifhyphenstart{#2}{\let\glsxtrwordsep\glsxtrwordsephyphen}{}%
+ \ifglsxtrinsertinside
+ {\glsfirstabbrvhyphenfont{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ {\glsxtrgenentrytextfmt{#2}}%
+ \fi
\glsxtrfullsep{#1}%
\glsxtrparen
- {\glsfirstlonghyphenfont{\glsentrylong{#1}\ifglsxtrinsertinside{#2}\fi}%
- \ifglsxtrinsertinside\else{#2}\fi
- }%
+ {\glsxtrlongformatgrp{#1}{#2}{\glsfirstlonghyphenfont}}%
}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\GLSxtrposthyphenlong}
+%\changes{1.49}{??}{new}
+%As above but all-caps.
+% \begin{macrocode}
+\newcommand*{\GLSxtrposthyphenlong}[2]{%
+ {%
+ \glsxtrifhyphenstart{#2}{\let\glsxtrwordsep\glsxtrwordsephyphen}{}%
+ \ifglsxtrinsertinside
+ {\glsfirstabbrvhyphenfont{\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}}%
+ \else
+ {\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}%
+ \fi
+ \glsxtrfullsep{#1}%
+ \glsxtrparen
+ {\GLSxtrlongformatgrp{#1}{#2}{\glsfirstlonghyphenfont}}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%Plural versions in case they are required.
+%\begin{macro}{\glsxtrposthyphenlongpl}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrposthyphenlongpl}[2]{%
+ {%
+ \glsxtrifhyphenstart{#2}{\let\glsxtrwordsep\glsxtrwordsephyphen}{}%
+ \ifglsxtrinsertinside
+ {\glsfirstabbrvhyphenfont{\glsxtrgenentrytextfmt{#2}}}%
+ \else
+ {\glsxtrgenentrytextfmt{#2}}%
+ \fi
+ \glsxtrfullsep{#1}%
+ \glsxtrparen
+ {\glsxtrlongplformatgrp{#1}{#2}{\glsfirstlonghyphenfont}}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GLSxtrposthyphenlongpl}
+%\changes{1.49}{??}{new}
+%As above but all-caps.
+% \begin{macrocode}
+\newcommand*{\GLSxtrposthyphenlongpl}[2]{%
+ {%
+ \glsxtrifhyphenstart{#2}{\let\glsxtrwordsep\glsxtrwordsephyphen}{}%
+ \ifglsxtrinsertinside
+ {\glsfirstabbrvhyphenfont{\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}}%
+ \else
+ {\mfirstucMakeUppercase{\glsxtrgenentrytextfmt{#2}}}%
+ \fi
+ \glsxtrfullsep{#1}%
+ \glsxtrparen
+ {\GLSxtrlongplformatgrp{#1}{#2}{\glsfirstlonghyphenfont}}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\xpglsxtrposthyphenlong}
+%\changes{1.49}{??}{new}
+%Expand placeholders and check for all caps.
+% \begin{macrocode}
+\newcommand*{\xpglsxtrposthyphenlong}{%
+ \glsxtrifallcaps
+ {%
+ \expandafter\GLSxtrposthyphenlong\expandafter\glslabel
+ \expandafter{\glsinsert}%
+ }%
+ {%
+ \expandafter\glsxtrposthyphenlong\expandafter\glslabel
+ \expandafter{\glsinsert}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{abbrvstyle}{short-hyphen-postlong-hyphen}
%\changes{1.17}{2017-08-09}{new}
%\changes{1.42}{2020-02-03}{added missing text key}
@@ -24536,23 +38887,24 @@ defined}{}%
% \begin{macrocode}
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrshortlongname},
- sort={\the\glsshorttok},
+ sort={\glsxtrshorthyphenlongsort},
first={\protect\glsfirstabbrvhyphenfont{\the\glsshorttok}},%
firstplural={\protect\glsfirstabbrvhyphenfont{\the\glsshortpltok}},%
text={\protect\glsabbrvhyphenfont{\the\glsshorttok}},%
plural={\protect\glsabbrvhyphenfont{\the\glsshortpltok}},%
description={\protect\glslonghyphenfont{\the\glslongtok}}}%
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsexclapplyinnerfmtfield{\the\glslabeltok}{desc}%
\csdef{glsxtrpostlink\glscategorylabel}{%
\glsxtrifwasfirstuse
{%
- \glsxtrposthyphenlong{\glslabel}{\glsinsert}%
+ \xpglsxtrposthyphenlong
}%
{%
% \end{macrocode}
% Put the insertion into the post-link:
% \begin{macrocode}
- \glsxtrposthyphensubsequent{\glslabel}{\glsinsert}%
+ \xpglsxtrposthyphensubsequent
}%
}%
\glshasattribute{\the\glslabeltok}{regular}%
@@ -24573,59 +38925,189 @@ defined}{}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlonghyphenfont{##1}}%
\renewcommand*{\glslongfont}[1]{\glslonghyphenfont{##1}}%
% \end{macrocode}
-% Subsequent use needs to omit the insertion:
+% Subsequent use needs to omit the insertion but it needs to perform
+% the space-hyphen substitution:
% \begin{macrocode}
\renewcommand*{\glsxtrsubsequentfmt}[2]{%
- \glsabbrvfont{\glsaccessshort{##1}}%
+ \glsxtrshorthyphennoinsert{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \glsaccessshort{##1}%
+ }%
+ {%
+ \glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
\renewcommand*{\glsxtrsubsequentplfmt}[2]{%
- \glsabbrvfont{\glsaccessshortpl{##1}}%
+ \glsxtrshorthyphennoinsert{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \glsaccessshortpl{##1}%
+ }%
+ {%
+ \glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
\renewcommand*{\Glsxtrsubsequentfmt}[2]{%
- \glsabbrvfont{\Glsaccessshort{##1}}%
+ \glsxtrshorthyphennoinsert{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \Glsaccessshort{##1}%
+ }%
+ {%
+ \Glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
\renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
- \glsabbrvfont{\Glsaccessshortpl{##1}}%
+ \glsxtrshorthyphennoinsert{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \Glsaccessshortpl{##1}%
+ }%
+ {%
+ \Glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentfmt}[2]{%
+ \glsxtrshorthyphennoinsert{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \GLSaccessshort{##1}%
+ }%
+ {%
+ \GLSaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
+ }%
+ \renewcommand*{\GLSxtrsubsequentplfmt}[2]{%
+ \glsxtrshorthyphennoinsert{##1}%
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \GLSaccessshortpl{##1}%
+ }%
+ {%
+ \GLSaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##2}%
}%
% \end{macrocode}
% First use full form:
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsxtrshorthyphen{\glsaccessshort{##1}}{##1}{##2}%
+ \glsxtrshorthyphen
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \glsaccessshort{##1}%
+ }%
+ {%
+ \glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##1}{##2}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsxtrshorthyphen{\glsaccessshortpl{##1}}{##1}{##2}%
+ \glsxtrshorthyphen
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \glsaccessshortpl{##1}%
+ }%
+ {%
+ \glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##1}{##2}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsxtrshorthyphen{\Glsaccessshort{##1}}{##1}{##2}%
+ \glsxtrshorthyphen
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \Glsaccessshort{##1}%
+ }%
+ {%
+ \Glsaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##1}{##2}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsxtrshorthyphen{\Glsaccessshortpl{##1}}{##1}{##2}%
+ \glsxtrshorthyphen
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \Glsaccessshortpl{##1}%
+ }%
+ {%
+ \Glsaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }{##1}{##2}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \glsxtrshorthyphen
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \GLSaccessshort{##1}%
+ }%
+ {%
+ \GLSaccessfmtshort{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }%
+ {##1}{##2}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \glsxtrshorthyphen
+ {%
+ \glsifattribute{##1}{markshortwords}{true}%
+ {%
+ \GLSaccessshortpl{##1}%
+ }%
+ {%
+ \GLSaccessfmtshortpl{}{\glsxtrgenentrytextfmt}{##1}%
+ }%
+ }{##1}{##2}%
}%
% \end{macrocode}
% In-line format. Commands like \cs{glsxtrfull} set \cs{glsinsert}
% to empty. The entire link-text (provided by the following
-% commands) is stored in \cs{glscustomtext}.
+% commands) is stored in \cs{glscustomtext}. Note that unless the
+% insert is saved, it won't appear in the post-link hook.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvhyphenfont{\glsaccessshort{##1}%
- \ifglsxtrinsertinside{##2}\fi}%
- \ifglsxtrinsertinside \else{##2}\fi
+ \glsxtrshortformatgrp{##1}{##2}{\glsfirstabbrvhyphenfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvhyphenfont{\glsaccessshortpl{##1}%
- \ifglsxtrinsertinside{##2}\fi}%
- \ifglsxtrinsertinside \else{##2}\fi
+ \glsxtrshortplformatgrp{##1}{##2}{\glsfirstabbrvhyphenfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstabbrvhyphenfont{\Glsaccessshort{##1}%
- \ifglsxtrinsertinside{##2}\fi}%
- \ifglsxtrinsertinside \else{##2}\fi
+ \Glsxtrshortformatgrp{##1}{##2}{\glsfirstabbrvhyphenfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstabbrvhyphenfont{\Glsaccessshortpl{##1}%
- \ifglsxtrinsertinside{##2}\fi}%
- \ifglsxtrinsertinside \else{##2}\fi
+ \Glsxtrshortplformatgrp{##1}{##2}{\glsfirstabbrvhyphenfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrshortformatgrp{##1}{##2}{\glsfirstabbrvhyphenfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrshortplformatgrp{##1}{##2}{\glsfirstabbrvhyphenfont}%
}%
}
% \end{macrocode}
@@ -24657,13 +39139,13 @@ defined}{}%
\csdef{glsxtrpostlink\glscategorylabel}{%
\glsxtrifwasfirstuse
{%
- \glsxtrposthyphenlong{\glslabel}{\glsinsert}%
+ \xpglsxtrposthyphenlong
}%
{%
% \end{macrocode}
% Put the insertion into the post-link:
% \begin{macrocode}
- \glsxtrposthyphensubsequent{\glslabel}{\glsinsert}%
+ \xpglsxtrposthyphensubsequent
}%
}%
\glshasattribute{\the\glslabeltok}{regular}%
@@ -24740,15 +39222,16 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtronlyname},
sort={\the\glsshorttok},
- first={\protect\glsfirstlongonlyfont{\the\glslongtok}},%
- firstplural={\protect\glsfirstlongonlyfont{\the\glslongpltok}},%
- text={\protect\glsabbrvonlyfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvonlyfont{\the\glsshortpltok}},%
+ first={\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}},%
+ firstplural={\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}},%
description={\protect\glslongonlyfont{\the\glslongtok}}}%
% \end{macrocode}
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsexclapplyinnerfmtfield{\the\glslabeltok}{desc}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -24769,47 +39252,49 @@ defined}{}%
% The first use full form doesn't show the short form.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstlongonlyfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongformat{##1}{##2}{\glsfirstlongonlyfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstlongonlyfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongplformat{##1}{##2}{\glsfirstlongonlyfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstlongonlyfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongformat{##1}{##2}{\glsfirstlongonlyfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstlongonlyfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongplformat{##1}{##2}{\glsfirstlongonlyfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrlongformat{##1}{##2}{\glsfirstlongonlyfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrlongplformat{##1}{##2}{\glsfirstlongonlyfont}%
}%
% \end{macrocode}
% The inline full form does show the short form.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstlongonlyfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvonlyfont{\glsaccessshort{##1}}}%
+ \glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongonlyfont}{\glsfirstabbrvonlyfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstlongonlyfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvonlyfont{\glsaccessshortpl{##1}}}%
+ \glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongonlyfont}{\glsfirstabbrvonlyfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstlongonlyfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvonlyfont{\glsaccessshortpl{##1}}}%
+ \Glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongonlyfont}{\glsfirstabbrvonlyfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstlongonlyfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvonlyfont{\Glsaccessshortpl{##1}}}%
+ \Glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongonlyfont}{\glsfirstabbrvonlyfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongonlyfont}{\glsfirstabbrvonlyfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongonlyfont}{\glsfirstabbrvonlyfont}%
}%
}
% \end{macrocode}
@@ -24846,10 +39331,10 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtronlydescname},
sort={\glsxtronlydescsort},%
- first={\protect\glsfirstlongonlyfont{\the\glslongtok}},%
- firstplural={\protect\glsfirstlongonlyfont{\the\glslongpltok}},%
- text={\protect\glsabbrvonlyfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvonlyfont{\the\glsshortpltok}}%
+ first={\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}},%
+ firstplural={\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}%
}%
% \end{macrocode}
% Unset the \catattr{regular} attribute if it has been set.
@@ -24889,6 +39374,14 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtrsconlyrevert}
+%\changes{1.49}{??}{new}
+% \begin{macrocode}
+\newcommand*{\glsxtrsconlyrevert}{\glsxtrscrevert}
+% \end{macrocode}
+%\end{macro}
+%
+%
%\begin{macro}{\glsxtrsconlyname}
%\changes{1.48}{2021-11-22}{new}
% The default name format for this style.
@@ -24914,8 +39407,8 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrsconlyname},
sort={\the\glsshorttok},
- first={\protect\glsfirstlongonlyfont{\the\glslongtok}},%
- firstplural={\protect\glsfirstlongonlyfont{\the\glslongpltok}},%
+ first={\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}},%
+ firstplural={\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}},%
text={\protect\glsabbrvsconlyfont{\the\glsshorttok}},%
plural={\protect\glsabbrvsconlyfont{\the\glsshortpltok}},%
description={\protect\glslongonlyfont{\the\glslongtok}}}%
@@ -24923,6 +39416,7 @@ defined}{}%
% Unset the \catattr{regular} attribute if it has been set.
% \begin{macrocode}
\renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glsexclapplyinnerfmtfield{\the\glslabeltok}{desc}%
\glshasattribute{\the\glslabeltok}{regular}%
{%
\glssetattribute{\the\glslabeltok}{regular}{false}%
@@ -24936,51 +39430,54 @@ defined}{}%
\renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvsconlyfont{##1}}%
\renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongonlyfont{##1}}%
\renewcommand*{\glslongfont}[1]{\glslongonlyfont{##1}}%
+ \renewcommand*\glsxtrrevert[1]{\glsxtrsconlyrevert{##1}}%
% \end{macrocode}
% The first use full form doesn't show the short form.
% \begin{macrocode}
\renewcommand*{\glsxtrfullformat}[2]{%
- \glsfirstlongonlyfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongformat{##1}{##2}{\glsfirstlongonlyfont}%
}%
\renewcommand*{\glsxtrfullplformat}[2]{%
- \glsfirstlongonlyfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \glsxtrlongplformat{##1}{##2}{\glsfirstlongonlyfont}%
}%
\renewcommand*{\Glsxtrfullformat}[2]{%
- \glsfirstlongonlyfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongformat{##1}{##2}{\glsfirstlongonlyfont}%
}%
\renewcommand*{\Glsxtrfullplformat}[2]{%
- \glsfirstlongonlyfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
+ \Glsxtrlongplformat{##1}{##2}{\glsfirstlongonlyfont}%
+ }%
+ \renewcommand*{\GLSxtrfullformat}[2]{%
+ \GLSxtrlongformat{##1}{##2}{\glsfirstlongonlyfont}%
+ }%
+ \renewcommand*{\GLSxtrfullplformat}[2]{%
+ \GLSxtrlongplformat{##1}{##2}{\glsfirstlongonlyfont}%
}%
% \end{macrocode}
% The inline full form does show the short form.
% \begin{macrocode}
\renewcommand*{\glsxtrinlinefullformat}[2]{%
- \glsfirstlongonlyfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvsconlyfont{\glsaccessshort{##1}}}%
+ \glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongonlyfont}{\glsfirstabbrvsconlyfont}%
}%
\renewcommand*{\glsxtrinlinefullplformat}[2]{%
- \glsfirstlongonlyfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvsconlyfont{\glsaccessshortpl{##1}}}%
+ \glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongonlyfont}{\glsfirstabbrvsconlyfont}%
}%
\renewcommand*{\Glsxtrinlinefullformat}[2]{%
- \glsfirstlongonlyfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvsconlyfont{\glsaccessshortpl{##1}}}%
+ \Glsxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongonlyfont}{\glsfirstabbrvsconlyfont}%
}%
\renewcommand*{\Glsxtrinlinefullplformat}[2]{%
- \glsfirstlongonlyfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
- \ifglsxtrinsertinside\else##2\fi
- \glsxtrfullsep{##1}%
- \glsxtrparen{\protect\glsfirstabbrvsconlyfont{\Glsaccessshortpl{##1}}}%
+ \Glsxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongonlyfont}{\glsfirstabbrvsconlyfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullformat}[2]{%
+ \GLSxtrlongshortformat{##1}{##2}%
+ {\glsfirstlongonlyfont}{\glsfirstabbrvsconlyfont}%
+ }%
+ \renewcommand*{\GLSxtrinlinefullplformat}[2]{%
+ \GLSxtrlongshortplformat{##1}{##2}%
+ {\glsfirstlongonlyfont}{\glsfirstabbrvsconlyfont}%
}%
}
% \end{macrocode}
@@ -25015,10 +39512,10 @@ defined}{}%
\renewcommand*{\CustomAbbreviationFields}{%
name={\glsxtrsconlydescname},
sort={\glsxtrsconlydescsort},%
- first={\protect\glsfirstlongonlyfont{\the\glslongtok}},%
- firstplural={\protect\glsfirstlongonlyfont{\the\glslongpltok}},%
- text={\protect\glsabbrvsconlyfont{\the\glsshorttok}},%
- plural={\protect\glsabbrvsconlyfont{\the\glsshortpltok}}%
+ first={\glsfirstxplongfont{\the\glslongtok}{\glscategorylabel}},%
+ firstplural={\glsfirstxplongfont{\the\glslongpltok}{\glscategorylabel}},%
+ text={\glsxpabbrvfont{\the\glsshorttok}{\glscategorylabel}},%
+ plural={\glsxpabbrvfont{\the\glsshortpltok}{\glscategorylabel}}%
}%
% \end{macrocode}
% Unset the \catattr{regular} attribute if it has been set.
@@ -25037,5027 +39534,9 @@ defined}{}%
% \end{macrocode}
%\end{abbrvstyle}
%
-%\section{Using Entries in Headings}
-%
-% There are four main problems with using entries in sectioning
-% commands: they can mess with the first use flag if they end up in
-% the table of contents, they can add unwanted numbers to the
-% entry's location list, the label is corrupted if used inside
-% \ics{MakeUppercase} (which is used by the default headings style)
-% and they need to be expandable for PDF bookmarks. The
-% \styfmt{glossaries} package therefore recommends the use of the
-% expandable commands, such as \cs{glsentryshort}, instead but this
-% doesn't reflect the formatting since it doesn't include
-% \cs{glsabbrvfont}. The commands below are an attempt to get around
-% these problems.
-%
-% The PDF bookmark issue can easily be fixed with \sty{hyperref}'s
-% \cs{texorpdfstring} which can simply use the expandable command
-% in the PDF string case. The \TeX\ string case can now use
-% \cs{glsxtrshort} with the \gloskey[glslink]{noindex} key set, which
-% prevents the unwanted additions to the location list, and the
-% \gloskey[glslink]{hyper} key set to false, which prevents the problem of
-% nested links. This just leaves one thing left that needs to be
-% dealt with, and that's what to do if the heading style
-% uses \cs{MakeUppercase}.
-%
-% Note that \styfmt{glossaries} automatically loads \sty{textcase}, so
-% the label can be protected from case change with \sty{textcase}'s
-% \cs{NoCaseChange}. This means that we don't have a problem
-% provided the page style uses \cs{MakeTextUppercase}, but the
-% default heading page style uses \cs{MakeUppercase}.
-%
-% To get around this, save the original definition of \cs{markboth}
-% and \cs{markright} and adjust it so that \cs{MakeUppercase} is
-% temporarily redefined to \cs{MakeTextUppercase}. Some packages or
-% classes redefine these commands, so we can't just assume they
-% still have the original kernel definition.
-%
-%\begin{macro}{\markright}
-% Save original definition:
-% \begin{macrocode}
-\let\@glsxtr@org@markright\markright
-% \end{macrocode}
-% Redefine (grouping not added in case it interferes with the
-% original code):
-% \begin{macrocode}
-\renewcommand*{\markright}[1]{%
- \glsxtrmarkhook
- \@glsxtr@org@markright{\@glsxtrinmark#1\@glsxtrnotinmark}%
- \glsxtrrestoremarkhook
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\markboth}
-% Save original definition:
-% \begin{macrocode}
-\let\@glsxtr@org@markboth\markboth
-% \end{macrocode}
-% Redefine (grouping not added in case it interferes with the
-% original code):
-% \begin{macrocode}
-\renewcommand*{\markboth}[2]{%
- \glsxtrmarkhook
- \@glsxtr@org@markboth
- {\@glsxtrinmark#1\@glsxtrnotinmark}%
- {\@glsxtrinmark#2\@glsxtrnotinmark}%
- \glsxtrrestoremarkhook
-}
-% \end{macrocode}
-%\end{macro}
-%
-%Also do this for \cs{@starttoc}
-%\begin{macro}{\@starttoc}
-% Save original definition:
-% \begin{macrocode}
-\let\@glsxtr@org@@starttoc\@starttoc
-% \end{macrocode}
-% Redefine:
-% \begin{macrocode}
-\renewcommand*{\@starttoc}[1]{%
- \glsxtrmarkhook
- \@glsxtrinmark
- \@glsxtr@org@@starttoc{#1}%
- \@glsxtrnotinmark
- \glsxtrrestoremarkhook
-}
-% \end{macrocode}
-%\end{macro}
-%
-% If this causes a problem provide a simple way of switching back to
-% the original definitions:
-%\begin{macro}{\glsxtrRevertMarks}
-% \begin{macrocode}
-\newcommand*{\glsxtrRevertMarks}{%
- \let\markright\@glsxtr@org@markright
- \let\markboth\@glsxtr@org@markboth
- \let\@starttoc\@glsxtr@org@@starttoc
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrRevertTocMarks}
-%\changes{1.31}{2018-05-09}{new}
-%Just restores \cs{@starttoc}.
-% \begin{macrocode}
-\newcommand*{\glsxtrRevertTocMarks}{%
- \let\@starttoc\@glsxtr@org@@starttoc
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrifinmark}
-%\changes{1.07}{2016-08-15}{new}
-% \begin{macrocode}
-\newcommand*{\glsxtrifinmark}[2]{#2}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@glsxtrinmark}
-%\changes{1.07}{2016-08-15}{new}
-% \begin{macrocode}
-\newrobustcmd*{\@glsxtrinmark}{%
- \let\glsxtrifinmark\@firstoftwo
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@glsxtrnotinmark}
-%\changes{1.07}{2016-08-15}{new}
-% \begin{macrocode}
-\newrobustcmd*{\@glsxtrnotinmark}{%
- \let\glsxtrifinmark\@secondoftwo
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrtitleorpdforheading}
-%\changes{1.21}{2017-11-03}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\glsxtrtitleorpdforheading}[3]{\texorpdfstring{#1}{#2}}
-}
-{
- \newcommand*{\glsxtrtitleorpdforheading}[3]{#1}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrmarkhook}
-% Hook used in new definition of \cs{markboth} and \cs{markright}
-% to make some changes to apply to the marks:
-% \begin{macrocode}
-\newcommand*{\glsxtrmarkhook}{%
-% \end{macrocode}
-% Save current definitions:
-% \begin{macrocode}
- \let\@glsxtr@org@MakeUppercase\MakeUppercase
- \let\@glsxtr@org@glsxtrtitleorpdforheading\glsxtrtitleorpdforheading
- \let\@glsxtr@org@glsxtrtitleshort\glsxtrtitleshort
- \let\@glsxtr@org@glsxtrtitleshortpl\glsxtrtitleshortpl
- \let\@glsxtr@org@Glsxtrtitleshort\Glsxtrtitleshort
- \let\@glsxtr@org@Glsxtrtitleshortpl\Glsxtrtitleshortpl
- \let\@glsxtr@org@glsxtrtitlename\glsxtrtitlename
- \let\@glsxtr@org@Glsxtrtitlename\Glsxtrtitlename
- \let\@glsxtr@org@glsxtrtitletext\glsxtrtitletext
- \let\@glsxtr@org@Glsxtrtitletext\Glsxtrtitletext
- \let\@glsxtr@org@glsxtrtitleplural\glsxtrtitleplural
- \let\@glsxtr@org@Glsxtrtitleplural\Glsxtrtitleplural
- \let\@glsxtr@org@glsxtrtitlefirst\glsxtrtitlefirst
- \let\@glsxtr@org@Glsxtrtitlefirst\Glsxtrtitlefirst
- \let\@glsxtr@org@glsxtrtitlefirstplural\glsxtrtitlefirstplural
- \let\@glsxtr@org@Glsxtrtitlefirstplural\Glsxtrtitlefirstplural
- \let\@glsxtr@org@glsxtrtitlelong\glsxtrtitlelong
- \let\@glsxtr@org@glsxtrtitlelongpl\glsxtrtitlelongpl
- \let\@glsxtr@org@Glsxtrtitlelong\Glsxtrtitlelong
- \let\@glsxtr@org@Glsxtrtitlelongpl\Glsxtrtitlelongpl
- \let\@glsxtr@org@glsxtrtitlefull\glsxtrtitlefull
- \let\@glsxtr@org@glsxtrtitlefullpl\glsxtrtitlefullpl
- \let\@glsxtr@org@Glsxtrtitlefull\Glsxtrtitlefull
- \let\@glsxtr@org@Glsxtrtitlefullpl\Glsxtrtitlefullpl
-% \end{macrocode}
-% New definitions
-% \begin{macrocode}
- \let\glsxtrifinmark\@firstoftwo
- \let\MakeUppercase\MakeTextUppercase
- \let\glsxtrtitleorpdforheading\@thirdofthree
- \let\glsxtrtitleshort\glsxtrheadshort
- \let\glsxtrtitleshortpl\glsxtrheadshortpl
- \let\Glsxtrtitleshort\Glsxtrheadshort
- \let\Glsxtrtitleshortpl\Glsxtrheadshortpl
- \let\glsxtrtitlename\glsxtrheadname
- \let\Glsxtrtitlename\Glsxtrheadname
- \let\glsxtrtitletext\glsxtrheadtext
- \let\Glsxtrtitletext\Glsxtrheadtext
- \let\glsxtrtitleplural\glsxtrheadplural
- \let\Glsxtrtitleplural\Glsxtrheadplural
- \let\glsxtrtitlefirst\glsxtrheadfirst
- \let\Glsxtrtitlefirst\Glsxtrheadfirst
- \let\glsxtrtitlefirstplural\glsxtrheadfirstplural
- \let\Glsxtrtitlefirstplural\Glsxtrheadfirstplural
- \let\glsxtrtitlelong\glsxtrheadlong
- \let\glsxtrtitlelongpl\glsxtrheadlongpl
- \let\Glsxtrtitlelong\Glsxtrheadlong
- \let\Glsxtrtitlelongpl\Glsxtrheadlongpl
- \let\glsxtrtitlefull\glsxtrheadfull
- \let\glsxtrtitlefullpl\glsxtrheadfullpl
- \let\Glsxtrtitlefull\Glsxtrheadfull
- \let\Glsxtrtitlefullpl\Glsxtrheadfullpl
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrrestoremarkhook}
-% Hook used in new definition of \cs{markboth} and \cs{markright}
-% to restore the modified definitions. (This is in case the original
-% \cs{markboth} and \cs{markright} shouldn't be grouped for some
-% reason. There already is some grouping within those original
-% definitions, but some of the code lies outside that grouping, and
-% possibly there's a reason for it.)
-% \begin{macrocode}
-\newcommand*{\glsxtrrestoremarkhook}{%
- \let\glsxtrifinmark\@secondoftwo
- \let\MakeUppercase\@glsxtr@org@MakeUppercase
- \let\glsxtrtitleorpdforheading\@glsxtr@org@glsxtrtitleorpdforheading
- \let\glsxtrtitleshort\@glsxtr@org@glsxtrtitleshort
- \let\glsxtrtitleshortpl\@glsxtr@org@glsxtrtitleshortpl
- \let\Glsxtrtitleshort\@glsxtr@org@Glsxtrtitleshort
- \let\Glsxtrtitleshortpl\@glsxtr@org@Glsxtrtitleshortpl
- \let\glsxtrtitlename\@glsxtr@org@glsxtrtitlename
- \let\Glsxtrtitlename\@glsxtr@org@Glsxtrtitlename
- \let\glsxtrtitletext\@glsxtr@org@glsxtrtitletext
- \let\Glsxtrtitletext\@glsxtr@org@Glsxtrtitletext
- \let\glsxtrtitleplural\@glsxtr@org@glsxtrtitleplural
- \let\Glsxtrtitleplural\@glsxtr@org@Glsxtrtitleplural
- \let\glsxtrtitlefirst\@glsxtr@org@glsxtrtitlefirst
- \let\Glsxtrtitlefirst\@glsxtr@org@Glsxtrtitlefirst
- \let\glsxtrtitlefirstplural\@glsxtr@org@glsxtrtitlefirstplural
- \let\Glsxtrtitlefirstplural\@glsxtr@org@Glsxtrtitlefirstplural
- \let\glsxtrtitlelong\@glsxtr@org@glsxtrtitlelong
- \let\glsxtrtitlelongpl\@glsxtr@org@glsxtrtitlelongpl
- \let\Glsxtrtitlelong\@glsxtr@org@Glsxtrtitlelong
- \let\Glsxtrtitlelongpl\@glsxtr@org@Glsxtrtitlelongpl
- \let\glsxtrtitlefull\@glsxtr@org@glsxtrtitlefull
- \let\glsxtrtitlefullpl\@glsxtr@org@glsxtrtitlefullpl
- \let\Glsxtrtitlefull\@glsxtr@org@Glsxtrtitlefull
- \let\Glsxtrtitlefullpl\@glsxtr@org@Glsxtrtitlefullpl
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\changes{0.5.1}{2015-12-07}{removed \cs{ifglsxtruseuchead}}
-% Instead of using one document-wide conditional, use
-% \catattr{headuc} attribute to determine whether or not to use the
-% all upper case form.
-%
-%\begin{macro}{\glsxtrheadshort}
-% Command used to display short form in the page header.
-%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
-% \begin{macrocode}
-\newcommand*{\glsxtrheadshort}[1]{%
- \protect\NoCaseChange
- {%
- \glsifattribute{#1}{headuc}{true}%
- {%
- \GLSxtrshort[noindex,hyper=false]{#1}[]%
- }%
- {%
- \glsxtrshort[noindex,hyper=false]{#1}[]%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrtitleshort}
-% Command to display short form of abbreviation in section title and
-% table of contents.
-% \begin{macrocode}
-\newrobustcmd*{\glsxtrtitleshort}[1]{%
- \glsxtrshort[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrheadshortpl}
-% Command used to display plural short form in the page header.
-% If you want the text converted to upper case, this needs to be
-% redefined to use \cs{GLSxtrshortpl} instead. If you are using a
-% smallcaps style, the default fonts don't provide italic smallcaps.
-%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
-% \begin{macrocode}
-\newcommand*{\glsxtrheadshortpl}[1]{%
- \protect\NoCaseChange
- {%
- \glsifattribute{#1}{headuc}{true}%
- {%
- \GLSxtrshortpl[noindex,hyper=false]{#1}[]%
- }%
- {%
- \glsxtrshortpl[noindex,hyper=false]{#1}[]%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrtitleshortpl}
-% Command to display plural short form of abbreviation in section title and
-% table of contents.
-%\changes{1.03}{2016-04-27}{bug fix: changed \cs{glsxtrshort} to
-%\cs{glsxtrshortpl}}
-% \begin{macrocode}
-\newrobustcmd*{\glsxtrtitleshortpl}[1]{%
- \glsxtrshortpl[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsxtrheadshort}
-% Command used to display short form in the page header with the
-% first letter converted to upper case.
-%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
-% \begin{macrocode}
-\newcommand*{\Glsxtrheadshort}[1]{%
- \protect\NoCaseChange
- {%
- \glsifattribute{#1}{headuc}{true}%
- {%
- \GLSxtrshort[noindex,hyper=false]{#1}[]%
- }%
- {%
- \Glsxtrshort[noindex,hyper=false]{#1}[]%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsxtrtitleshort}
-% Command to display short form of abbreviation in section title and
-% table of contents with the first letter converted to upper case.
-% \begin{macrocode}
-\newrobustcmd*{\Glsxtrtitleshort}[1]{%
- \Glsxtrshort[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\GLSxtrtitleshort}
-%\changes{1.42}{2020-02-03}{new}
-% Command to display short form of abbreviation in section title and
-% table of contents in all upper case.
-% \begin{macrocode}
-\newrobustcmd*{\GLSxtrtitleshort}[1]{%
- \GLSxtrshort[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsxtrheadshortpl}
-% Command used to display plural short form in the page header with the
-% first letter converted to upper case.
-%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
-% \begin{macrocode}
-\newcommand*{\Glsxtrheadshortpl}[1]{%
- \protect\NoCaseChange
- {%
- \glsifattribute{#1}{headuc}{true}%
- {%
- \GLSxtrshortpl[noindex,hyper=false]{#1}[]%
- }%
- {%
- \Glsxtrshortpl[noindex,hyper=false]{#1}[]%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsxtrtitleshortpl}
-% Command to display plural short form of abbreviation in section title and
-% table of contents with the first letter converted to upper case.
-% \begin{macrocode}
-\newrobustcmd*{\Glsxtrtitleshortpl}[1]{%
- \Glsxtrshortpl[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\GLSxtrtitleshortpl}
-%\changes{1.42}{2020-02-03}{new}
-% Command to display plural short form of abbreviation in section title and
-% table of contents in all upper case.
-% \begin{macrocode}
-\newrobustcmd*{\GLSxtrtitleshortpl}[1]{%
- \GLSxtrshortpl[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrheadname}
-% As above but for the \gloskey{name} value.
-%\changes{1.21}{2017-11-03}{new}
-% \begin{macrocode}
-\newcommand*{\glsxtrheadname}[1]{%
- \protect\NoCaseChange
- {%
- \glsifattribute{#1}{headuc}{true}%
- {%
- \GLSname[noindex,hyper=false]{#1}[]%
- }%
- {%
- \glsname[noindex,hyper=false]{#1}[]%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrtitlename}
-% Command to display \gloskey{name} value in section title and
-% table of contents.
-%\changes{1.21}{2017-11-03}{new}
-% \begin{macrocode}
-\newrobustcmd*{\glsxtrtitlename}[1]{%
- \glsname[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsxtrheadname}
-% First letter converted to upper case
-%\changes{1.21}{2017-11-03}{new}
-% \begin{macrocode}
-\newcommand*{\Glsxtrheadname}[1]{%
- \protect\NoCaseChange
- {%
- \glsifattribute{#1}{headuc}{true}%
- {%
- \GLSname[noindex,hyper=false]{#1}[]%
- }%
- {%
- \Glsname[noindex,hyper=false]{#1}[]%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsxtrtitlename}
-% Command to display \gloskey{name} value in section title and
-% table of contents with the first letter changed to upper case.
-%\changes{1.21}{2017-11-03}{new}
-% \begin{macrocode}
-\newrobustcmd*{\Glsxtrtitlename}[1]{%
- \Glsname[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\GLSxtrtitlename}
-% Command to display \gloskey{name} value in section title and
-% table of contents in all upper case.
-%\changes{1.42}{2020-02-03}{new}
-% \begin{macrocode}
-\newrobustcmd*{\GLSxtrtitlename}[1]{%
- \GLSname[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrheadtext}
-% As above but for the \gloskey{text} value.
-%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
-% \begin{macrocode}
-\newcommand*{\glsxtrheadtext}[1]{%
- \protect\NoCaseChange
- {%
- \glsifattribute{#1}{headuc}{true}%
- {%
- \GLStext[noindex,hyper=false]{#1}[]%
- }%
- {%
- \glstext[noindex,hyper=false]{#1}[]%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrtitletext}
-% Command to display \gloskey{text} value in section title and
-% table of contents.
-% \begin{macrocode}
-\newrobustcmd*{\glsxtrtitletext}[1]{%
- \glstext[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%
-%\begin{macro}{\Glsxtrheadtext}
-% First letter converted to upper case
-%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
-% \begin{macrocode}
-\newcommand*{\Glsxtrheadtext}[1]{%
- \protect\NoCaseChange
- {%
- \glsifattribute{#1}{headuc}{true}%
- {%
- \GLStext[noindex,hyper=false]{#1}[]%
- }%
- {%
- \Glstext[noindex,hyper=false]{#1}[]%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsxtrtitletext}
-% Command to display \gloskey{text} value in section title and
-% table of contents with the first letter changed to upper case.
-% \begin{macrocode}
-\newrobustcmd*{\Glsxtrtitletext}[1]{%
- \Glstext[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\GLSxtrtitletext}
-% Command to display \gloskey{text} value in section title and
-% table of contents in all upper case.
-%\changes{1.42}{2020-02-03}{new}
-% \begin{macrocode}
-\newrobustcmd*{\GLSxtrtitletext}[1]{%
- \GLStext[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrheadplural}
-% As above but for the \gloskey{plural} value.
-%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
-% \begin{macrocode}
-\newcommand*{\glsxtrheadplural}[1]{%
- \protect\NoCaseChange
- {%
- \glsifattribute{#1}{headuc}{true}%
- {%
- \GLSplural[noindex,hyper=false]{#1}[]%
- }%
- {%
- \glsplural[noindex,hyper=false]{#1}[]%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrtitleplural}
-% Command to display \gloskey{plural} value in section title and
-% table of contents.
-% \begin{macrocode}
-\newrobustcmd*{\glsxtrtitleplural}[1]{%
- \glsplural[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsxtrheadplural}
-% Convert first letter to upper case.
-%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
-% \begin{macrocode}
-\newcommand*{\Glsxtrheadplural}[1]{%
- \protect\NoCaseChange
- {%
- \glsifattribute{#1}{headuc}{true}%
- {%
- \GLSplural[noindex,hyper=false]{#1}[]%
- }%
- {%
- \Glsplural[noindex,hyper=false]{#1}[]%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsxtrtitleplural}
-% Command to display \gloskey{plural} value in section title and
-% table of contents with the first letter changed to upper case.
-% \begin{macrocode}
-\newrobustcmd*{\Glsxtrtitleplural}[1]{%
- \Glsplural[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\GLSxtrtitleplural}
-%\changes{1.42}{2020-02-03}{new}
-% Command to display \gloskey{plural} value in section title and
-% table of contents in all upper case.
-% \begin{macrocode}
-\newrobustcmd*{\GLSxtrtitleplural}[1]{%
- \GLSplural[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrheadfirst}
-% As above but for the \gloskey{first} value.
-%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
-% \begin{macrocode}
-\newcommand*{\glsxtrheadfirst}[1]{%
- \protect\NoCaseChange
- {%
- \glsifattribute{#1}{headuc}{true}%
- {%
- \GLSfirst[noindex,hyper=false]{#1}[]%
- }%
- {%
- \glsfirst[noindex,hyper=false]{#1}[]%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrtitlefirst}
-% Command to display \gloskey{first} value in section title and
-% table of contents.
-% \begin{macrocode}
-\newrobustcmd*{\glsxtrtitlefirst}[1]{%
- \glsfirst[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsxtrheadfirst}
-% First letter converted to upper case
-%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
-% \begin{macrocode}
-\newcommand*{\Glsxtrheadfirst}[1]{%
- \protect\NoCaseChange
- {%
- \glsifattribute{#1}{headuc}{true}%
- {%
- \GLSfirst[noindex,hyper=false]{#1}[]%
- }%
- {%
- \Glsfirst[noindex,hyper=false]{#1}[]%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsxtrtitlefirst}
-% Command to display \gloskey{first} value in section title and
-% table of contents with the first letter changed to upper case.
-% \begin{macrocode}
-\newrobustcmd*{\Glsxtrtitlefirst}[1]{%
- \Glsfirst[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\GLSxtrtitlefirst}
-%\changes{1.42}{2020-02-03}{new}
-% Command to display \gloskey{first} value in section title and
-% table of contents in all upper case.
-% \begin{macrocode}
-\newrobustcmd*{\GLSxtrtitlefirst}[1]{%
- \GLSfirst[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrheadfirstplural}
-% As above but for the \gloskey{firstplural} value.
-%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
-% \begin{macrocode}
-\newcommand*{\glsxtrheadfirstplural}[1]{%
- \protect\NoCaseChange
- {%
- \glsifattribute{#1}{headuc}{true}%
- {%
- \GLSfirstplural[noindex,hyper=false]{#1}[]%
- }%
- {%
- \glsfirstplural[noindex,hyper=false]{#1}[]%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrtitlefirstplural}
-% Command to display \gloskey{firstplural} value in section title and
-% table of contents.
-% \begin{macrocode}
-\newrobustcmd*{\glsxtrtitlefirstplural}[1]{%
- \glsfirstplural[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsxtrheadfirstplural}
-% First letter converted to upper case
-%\changes{0.5.1}{2015-12-07}{now uses headuc attribute}
-% \begin{macrocode}
-\newcommand*{\Glsxtrheadfirstplural}[1]{%
- \protect\NoCaseChange
- {%
- \glsifattribute{#1}{headuc}{true}%
- {%
- \GLSfirstplural[noindex,hyper=false]{#1}[]%
- }%
- {%
- \Glsfirstplural[noindex,hyper=false]{#1}[]%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsxtrtitlefirstplural}
-% Command to display \gloskey{first} value in section title and
-% table of contents with the first letter changed to upper case.
-% \begin{macrocode}
-\newrobustcmd*{\Glsxtrtitlefirstplural}[1]{%
- \Glsfirstplural[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\GLSxtrtitlefirstplural}
-%\changes{1.42}{2020-02-03}{new}
-% Command to display \gloskey{first} value in section title and
-% table of contents in all upper case.
-% \begin{macrocode}
-\newrobustcmd*{\GLSxtrtitlefirstplural}[1]{%
- \GLSfirstplural[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrheadlong}
-% Command used to display long form in the page header.
-%\changes{1.02}{2016-04-25}{new}
-% \begin{macrocode}
-\newcommand*{\glsxtrheadlong}[1]{%
- \protect\NoCaseChange
- {%
- \glsifattribute{#1}{headuc}{true}%
- {%
- \GLSxtrlong[noindex,hyper=false]{#1}[]%
- }%
- {%
- \glsxtrlong[noindex,hyper=false]{#1}[]%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrtitlelong}
-% Command to display long form of abbreviation in section title and
-% table of contents.
-%\changes{1.02}{2016-04-25}{new}
-% \begin{macrocode}
-\newrobustcmd*{\glsxtrtitlelong}[1]{%
- \glsxtrlong[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrheadlongpl}
-% Command used to display plural long form in the page header.
-% If you want the text converted to upper case, this needs to be
-% redefined to use \cs{GLSxtrlongpl} instead. If you are using a
-% smallcaps style, the default fonts don't provide italic smallcaps.
-%\changes{1.02}{2016-04-25}{new}
-% \begin{macrocode}
-\newcommand*{\glsxtrheadlongpl}[1]{%
- \protect\NoCaseChange
- {%
- \glsifattribute{#1}{headuc}{true}%
- {%
- \GLSxtrlongpl[noindex,hyper=false]{#1}[]%
- }%
- {%
- \glsxtrlongpl[noindex,hyper=false]{#1}[]%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrtitlelongpl}
-% Command to display plural long form of abbreviation in section title and
-% table of contents.
-%\changes{1.02}{2016-04-25}{new}
-%\changes{1.03}{2016-04-27}{bug fix: changed \cs{glsxtrlong} to
-%\cs{glsxtrlongpl}}
-% \begin{macrocode}
-\newrobustcmd*{\glsxtrtitlelongpl}[1]{%
- \glsxtrlongpl[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsxtrheadlong}
-% Command used to display long form in the page header with the
-% first letter converted to upper case.
-%\changes{1.02}{2016-04-25}{new}
-% \begin{macrocode}
-\newcommand*{\Glsxtrheadlong}[1]{%
- \protect\NoCaseChange
- {%
- \glsifattribute{#1}{headuc}{true}%
- {%
- \GLSxtrlong[noindex,hyper=false]{#1}[]%
- }%
- {%
- \Glsxtrlong[noindex,hyper=false]{#1}[]%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsxtrtitlelong}
-% Command to display long form of abbreviation in section title and
-% table of contents with the first letter converted to upper case.
-%\changes{1.02}{2016-04-25}{new}
-% \begin{macrocode}
-\newrobustcmd*{\Glsxtrtitlelong}[1]{%
- \Glsxtrlong[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\GLSxtrtitlelong}
-% Command to display long form of abbreviation in section title and
-% table of contents in all upper case.
-%\changes{1.42}{2020-02-03}{new}
-% \begin{macrocode}
-\newrobustcmd*{\GLSxtrtitlelong}[1]{%
- \GLSxtrlong[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsxtrheadlongpl}
-% Command used to display plural long form in the page header with the
-% first letter converted to upper case.
-%\changes{1.02}{2016-04-25}{new}
-% \begin{macrocode}
-\newcommand*{\Glsxtrheadlongpl}[1]{%
- \protect\NoCaseChange
- {%
- \glsifattribute{#1}{headuc}{true}%
- {%
- \GLSxtrlongpl[noindex,hyper=false]{#1}[]%
- }%
- {%
- \Glsxtrlongpl[noindex,hyper=false]{#1}[]%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsxtrtitlelongpl}
-% Command to display plural long form of abbreviation in section title and
-% table of contents with the first letter converted to upper case.
-%\changes{1.02}{2016-04-25}{new}
-% \begin{macrocode}
-\newrobustcmd*{\Glsxtrtitlelongpl}[1]{%
- \Glsxtrlongpl[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\GLSxtrtitlelongpl}
-% Command to display plural long form of abbreviation in section title and
-% table of contents in all upper case.
-%\changes{1.42}{2020-02-03}{new}
-% \begin{macrocode}
-\newrobustcmd*{\GLSxtrtitlelongpl}[1]{%
- \GLSxtrlongpl[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrheadfull}
-% Command used to display full form in the page header.
-%\changes{1.02}{2016-04-25}{new}
-% \begin{macrocode}
-\newcommand*{\glsxtrheadfull}[1]{%
- \protect\NoCaseChange
- {%
- \glsifattribute{#1}{headuc}{true}%
- {%
- \GLSxtrfull[noindex,hyper=false]{#1}[]%
- }%
- {%
- \glsxtrfull[noindex,hyper=false]{#1}[]%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrtitlefull}
-% Command to display full form of abbreviation in section title and
-% table of contents.
-%\changes{1.02}{2016-04-25}{new}
-% \begin{macrocode}
-\newrobustcmd*{\glsxtrtitlefull}[1]{%
- \glsxtrfull[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrheadfullpl}
-% Command used to display plural full form in the page header.
-% If you want the text converted to upper case, this needs to be
-% redefined to use \cs{GLSxtrfullpl} instead. If you are using a
-% smallcaps style, the default fonts don't provide italic smallcaps.
-%\changes{1.02}{2016-04-25}{new}
-% \begin{macrocode}
-\newcommand*{\glsxtrheadfullpl}[1]{%
- \protect\NoCaseChange
- {%
- \glsifattribute{#1}{headuc}{true}%
- {%
- \GLSxtrfullpl[noindex,hyper=false]{#1}[]%
- }%
- {%
- \glsxtrfullpl[noindex,hyper=false]{#1}[]%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrtitlefullpl}
-% Command to display plural full form of abbreviation in section title and
-% table of contents.
-%\changes{1.02}{2016-04-25}{new}
-% \begin{macrocode}
-\newrobustcmd*{\glsxtrtitlefullpl}[1]{%
- \glsxtrfullpl[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsxtrheadfull}
-% Command used to display full form in the page header with the
-% first letter converted to upper case.
-%\changes{1.02}{2016-04-25}{new}
-% \begin{macrocode}
-\newcommand*{\Glsxtrheadfull}[1]{%
- \protect\NoCaseChange
- {%
- \glsifattribute{#1}{headuc}{true}%
- {%
- \GLSxtrfull[noindex,hyper=false]{#1}[]%
- }%
- {%
- \Glsxtrfull[noindex,hyper=false]{#1}[]%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsxtrtitlefull}
-% Command to display full form of abbreviation in section title and
-% table of contents with the first letter converted to upper case.
-%\changes{1.02}{2016-04-25}{new}
-% \begin{macrocode}
-\newrobustcmd*{\Glsxtrtitlefull}[1]{%
- \Glsxtrfull[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\GLSxtrtitlefull}
-% Command to display full form of abbreviation in section title and
-% table of contents in all upper case.
-%\changes{1.42}{2020-02-03}{new}
-% \begin{macrocode}
-\newrobustcmd*{\GLSxtrtitlefull}[1]{%
- \GLSxtrfull[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsxtrheadfullpl}
-% Command used to display plural full form in the page header with the
-% first letter converted to upper case.
-%\changes{1.02}{2016-04-25}{new}
-% \begin{macrocode}
-\newcommand*{\Glsxtrheadfullpl}[1]{%
- \protect\NoCaseChange
- {%
- \glsifattribute{#1}{headuc}{true}%
- {%
- \GLSxtrfullpl[noindex,hyper=false]{#1}[]%
- }%
- {%
- \Glsxtrfullpl[noindex,hyper=false]{#1}[]%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsxtrtitlefullpl}
-% Command to display plural full form of abbreviation in section title and
-% table of contents with the first letter converted to upper case.
-%\changes{1.02}{2016-04-25}{new}
-% \begin{macrocode}
-\newrobustcmd*{\Glsxtrtitlefullpl}[1]{%
- \Glsxtrfullpl[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\GLSxtrtitlefullpl}
-% Command to display plural full form of abbreviation in section title and
-% table of contents in all upper case.
-%\changes{1.42}{2020-02-03}{new}
-% \begin{macrocode}
-\newrobustcmd*{\GLSxtrtitlefullpl}[1]{%
- \GLSxtrfullpl[noindex,hyper=false]{#1}[]%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsfmtshort}
-% Provide a way of using the formatted short form in section
-% headings. If \sty{hyperref} has been loaded, use
-% \cs{texorpdfstring} for convenience in PDF bookmarks.
-%\changes{0.2}{2015-11-30}{new}
-%\changes{0.4}{2015-12-03}{changed to use \cs{glsxtrshort}}
-%\changes{0.5}{2015-12-07}{changed to use \cs{glsxtrtitleshort}}
-%\changes{0.5}{2015-12-07}{renamed from \cs{glsentryfmtshort}}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\glsfmtshort}[1]{%
- \texorpdfstring
- {\glsxtrtitleshort{#1}}%
- {\glsentryshort{#1}}%
- }
-}
-{
- \newcommand*{\glsfmtshort}[1]{%
- \glsxtrtitleshort{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%Similarly for the plural version.
-%\begin{macro}{\glsfmtshortpl}
-%\changes{0.2}{2015-11-30}{new}
-%\changes{0.4}{2015-12-03}{changed to use \cs{glsxtrshortpl}}
-%\changes{0.5}{2015-12-07}{changed to use \cs{glsxtrtitleshortpl}}
-%\changes{0.5}{2015-12-07}{renamed from \cs{glsentryfmtshortpl}}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\glsfmtshortpl}[1]{%
- \texorpdfstring
- {\glsxtrtitleshortpl{#1}}%
- {\glsentryshortpl{#1}}%
- }
-}
-{
- \newcommand*{\glsfmtshortpl}[1]{%
- \glsxtrtitleshortpl{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-% The case-changing version isn't suitable for PDF bookmarks, so the
-% PDF alternative uses the non-case-changing version.
-%\begin{macro}{\Glsfmtshort}
-% Singular form (first letter uppercase).
-%\changes{0.2}{2015-11-30}{new}
-%\changes{0.4}{2015-12-03}{changed to use \cs{Glsxtrshort}}
-%\changes{0.5}{2015-12-07}{changed to use \cs{Glsxtrtitleshort}}
-%\changes{0.5}{2015-12-07}{renamed from \cs{Glsentryfmtshort}}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\Glsfmtshort}[1]{%
- \texorpdfstring
- {\Glsxtrtitleshort{#1}}%
- {\glsentryshort{#1}}%
- }
-}
-{
- \newcommand*{\Glsfmtshort}[1]{%
- \Glsxtrtitleshort{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%\begin{macro}{\Glsfmtshortpl}
-%Plural form (first letter uppercase).
-%\changes{0.2}{2015-11-30}{new}
-%\changes{0.4}{2015-12-03}{changed to use \cs{glsxtrshortpl}}
-%\changes{0.5}{2015-12-07}{changed to use \cs{Glsxtrtitleshortpl}}
-%\changes{0.5}{2015-12-07}{renamed from \cs{Glsentryfmtshortpl}}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\Glsfmtshortpl}[1]{%
- \texorpdfstring
- {\Glsxtrtitleshortpl{#1}}%
- {\glsentryshortpl{#1}}%
- }
-}
-{
- \newcommand*{\Glsfmtshortpl}[1]{%
- \Glsxtrtitleshortpl{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsfmtname}
-%As above but for the \gloskey{name} value.
-%\changes{1.21}{2017-11-03}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\glsfmtname}[1]{%
- \texorpdfstring
- {\glsxtrtitlename{#1}}%
- {\glsentryname{#1}}%
- }
-}
-{
- \newcommand*{\glsfmtname}[1]{%
- \glsxtrtitlename{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsfmtname}
-%First letter converted to upper case.
-%\changes{1.21}{2017-11-03}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\Glsfmtname}[1]{%
- \texorpdfstring
- {\Glsxtrtitlename{#1}}%
- {\glsentryname{#1}}%
- }
-}
-{
- \newcommand*{\Glsfmtname}[1]{%
- \Glsxtrtitlename{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\GLSfmtname}
-%All upper case.
-%\changes{1.42}{2020-02-03}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\GLSfmtname}[1]{%
- \texorpdfstring
- {\GLSxtrtitlename{#1}}%
- {\glsentryname{#1}}%
- }
-}
-{
- \newcommand*{\GLSfmtname}[1]{%
- \GLSxtrtitlename{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%
-%\begin{macro}{\glsfmttext}
-%As above but for the \gloskey{text} value.
-%\changes{0.5}{2015-12-07}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\glsfmttext}[1]{%
- \texorpdfstring
- {\glsxtrtitletext{#1}}%
- {\glsentrytext{#1}}%
- }
-}
-{
- \newcommand*{\glsfmttext}[1]{%
- \glsxtrtitletext{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsfmttext}
-%First letter converted to upper case.
-%\changes{0.5}{2015-12-07}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\Glsfmttext}[1]{%
- \texorpdfstring
- {\Glsxtrtitletext{#1}}%
- {\glsentrytext{#1}}%
- }
-}
-{
- \newcommand*{\Glsfmttext}[1]{%
- \Glsxtrtitletext{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\GLSfmttext}
-%All upper case.
-%\changes{1.42}{2020-02-03}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\GLSfmttext}[1]{%
- \texorpdfstring
- {\GLSxtrtitletext{#1}}%
- {\glsentrytext{#1}}%
- }
-}
-{
- \newcommand*{\GLSfmttext}[1]{%
- \GLSxtrtitletext{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsfmtplural}
-%As above but for the \gloskey{plural} value.
-%\changes{0.5}{2015-12-07}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\glsfmtplural}[1]{%
- \texorpdfstring
- {\glsxtrtitleplural{#1}}%
- {\glsentryplural{#1}}%
- }
-}
-{
- \newcommand*{\glsfmtplural}[1]{%
- \glsxtrtitleplural{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsfmtplural}
-%First letter converted to upper case.
-%\changes{0.5}{2015-12-07}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\Glsfmtplural}[1]{%
- \texorpdfstring
- {\Glsxtrtitleplural{#1}}%
- {\glsentryplural{#1}}%
- }
-}
-{
- \newcommand*{\Glsfmtplural}[1]{%
- \Glsxtrtitleplural{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\GLSfmtplural}
-%All upper case.
-%\changes{1.42}{2020-02-03}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\GLSfmtplural}[1]{%
- \texorpdfstring
- {\GLSxtrtitleplural{#1}}%
- {\glsentryplural{#1}}%
- }
-}
-{
- \newcommand*{\GLSfmtplural}[1]{%
- \GLSxtrtitleplural{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsfmtfirst}
-%As above but for the \gloskey{first} value.
-%\changes{0.5}{2015-12-07}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\glsfmtfirst}[1]{%
- \texorpdfstring
- {\glsxtrtitlefirst{#1}}%
- {\glsentryfirst{#1}}%
- }
-}
-{
- \newcommand*{\glsfmtfirst}[1]{%
- \glsxtrtitlefirst{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsfmtfirst}
-%First letter converted to upper case.
-%\changes{0.5}{2015-12-07}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\Glsfmtfirst}[1]{%
- \texorpdfstring
- {\Glsxtrtitlefirst{#1}}%
- {\glsentryfirst{#1}}%
- }
-}
-{
- \newcommand*{\Glsfmtfirst}[1]{%
- \Glsxtrtitlefirst{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\GLSfmtfirst}
-%All upper case.
-%\changes{1.42}{2020-02-03}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\GLSfmtfirst}[1]{%
- \texorpdfstring
- {\GLSxtrtitlefirst{#1}}%
- {\glsentryfirst{#1}}%
- }
-}
-{
- \newcommand*{\GLSfmtfirst}[1]{%
- \Glsxtrtitlefirst{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsfmtfirstpl}
-%As above but for the \gloskey{firstplural} value.
-%\changes{0.5}{2015-12-07}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\glsfmtfirstpl}[1]{%
- \texorpdfstring
- {\glsxtrtitlefirstplural{#1}}%
- {\glsentryfirstplural{#1}}%
- }
-}
-{
- \newcommand*{\glsfmtfirstpl}[1]{%
- \glsxtrtitlefirstplural{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsfmtfirstpl}
-%First letter converted to upper case.
-%\changes{0.5}{2015-12-07}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\Glsfmtfirstpl}[1]{%
- \texorpdfstring
- {\Glsxtrtitlefirstplural{#1}}%
- {\glsentryfirstplural{#1}}%
- }
-}
-{
- \newcommand*{\Glsfmtfirstpl}[1]{%
- \Glsxtrtitlefirstplural{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\GLSfmtfirstpl}
-%All upper case.
-%\changes{1.42}{2020-02-03}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\GLSfmtfirstpl}[1]{%
- \texorpdfstring
- {\GLSxtrtitlefirstplural{#1}}%
- {\glsentryfirstplural{#1}}%
- }
-}
-{
- \newcommand*{\GLSfmtfirstpl}[1]{%
- \GLSxtrtitlefirstplural{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsfmtlong}
-%As above but for the \gloskey{long} value.
-%\changes{1.02}{2016-04-25}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\glsfmtlong}[1]{%
- \texorpdfstring
- {\glsxtrtitlelong{#1}}%
- {\glsentrylong{#1}}%
- }
-}
-{
- \newcommand*{\glsfmtlong}[1]{%
- \glsxtrtitlelong{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsfmtlong}
-%First letter converted to upper case.
-%\changes{1.02}{2016-04-25}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\Glsfmtlong}[1]{%
- \texorpdfstring
- {\Glsxtrtitlelong{#1}}%
- {\glsentrylong{#1}}%
- }
-}
-{
- \newcommand*{\Glsfmtlong}[1]{%
- \Glsxtrtitlelong{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\GLSfmtlong}
-%All upper case.
-%\changes{1.42}{2020-02-03}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\GLSfmtlong}[1]{%
- \texorpdfstring
- {\GLSxtrtitlelong{#1}}%
- {\glsentrylong{#1}}%
- }
-}
-{
- \newcommand*{\GLSfmtlong}[1]{%
- \GLSxtrtitlelong{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsfmtlongpl}
-%As above but for the \gloskey{longplural} value.
-%\changes{1.02}{2016-04-25}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\glsfmtlongpl}[1]{%
- \texorpdfstring
- {\glsxtrtitlelongpl{#1}}%
- {\glsentrylongpl{#1}}%
- }
-}
-{
- \newcommand*{\glsfmtlongpl}[1]{%
- \glsxtrtitlelongpl{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsfmtlongpl}
-%First letter converted to upper case.
-%\changes{1.02}{2016-04-25}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\Glsfmtlongpl}[1]{%
- \texorpdfstring
- {\Glsxtrtitlelongpl{#1}}%
- {\glsentrylongpl{#1}}%
- }
-}
-{
- \newcommand*{\Glsfmtlongpl}[1]{%
- \Glsxtrtitlelongpl{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\GLSfmtlongpl}
-%All upper case.
-%\changes{1.42}{2020-02-03}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\GLSfmtlongpl}[1]{%
- \texorpdfstring
- {\GLSxtrtitlelongpl{#1}}%
- {\glsentrylongpl{#1}}%
- }
-}
-{
- \newcommand*{\GLSfmtlongpl}[1]{%
- \GLSxtrtitlelongpl{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glspdffmtfull}
-%\changes{1.42}{2020-02-03}{new}
-%Can't use \cs{glsxtrinlinefullformat} in PDF bookmarks as it's not
-%fully expandable. This command is for the PDF part of
-%\cs{texorpdfstring} for the full form.
-% \begin{macrocode}
-\newcommand*{\glspdffmtfull}[1]{\glsentrylong{#1} (\glsentryshort{#1})}%
-% \end{macrocode}
-%\end{macro}
-%\begin{macro}{\glspdffmtfullpl}
-%\changes{1.42}{2020-02-03}{new}
-%Likewise for plural.
-% \begin{macrocode}
-\newcommand*{\glspdffmtfullpl}[1]{\glsentrylongpl{#1} (\glsentryshortpl{#1})}%
-% \end{macrocode}
-%\end{macro}
-%\begin{macro}{\glsfmtfull}
-%In-line full format.
-%\changes{1.02}{2016-04-25}{new}
-%\changes{1.42}{2020-02-03}{switched pdf case to use \cs{glspdffmtfull}}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\glsfmtfull}[1]{%
- \texorpdfstring
- {\glsxtrtitlefull{#1}}%
- {\glspdffmtfull{#1}}%
- }
-}
-{
- \newcommand*{\glsfmtfull}[1]{%
- \glsxtrtitlefull{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsfmtfull}
-%First letter converted to upper case.
-%\changes{1.02}{2016-04-25}{new}
-%\changes{1.42}{2020-02-03}{switched pdf case to use \cs{glspdffmtfull}}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\Glsfmtfull}[1]{%
- \texorpdfstring
- {\Glsxtrtitlefull{#1}}%
- {\glspdffmtfull{#1}{}}%
- }
-}
-{
- \newcommand*{\Glsfmtfull}[1]{%
- \Glsxtrtitlefull{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\GLSfmtfull}
-%All upper case.
-%\changes{1.42}{2020-02-03}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\GLSfmtfull}[1]{%
- \texorpdfstring
- {\GLSxtrtitlefull{#1}}%
- {\glspdffmtfull{#1}}%
- }
-}
-{
- \newcommand*{\GLSfmtfull}[1]{%
- \GLSxtrtitlefull{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsfmtfullpl}
-%In-line full plural format.
-%\changes{1.02}{2016-04-25}{new}
-%\changes{1.42}{2020-02-03}{switched pdf case to use \cs{glspdffmtfullpl}}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\glsfmtfullpl}[1]{%
- \texorpdfstring
- {\glsxtrtitlefullpl{#1}}%
- {\glspdffmtfullpl{#1}}%
- }
-}
-{
- \newcommand*{\glsfmtfullpl}[1]{%
- \glsxtrtitlefullpl{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Glsfmtfullpl}
-%First letter converted to upper case.
-%\changes{1.02}{2016-04-25}{new}
-%\changes{1.42}{2020-02-03}{switched pdf case to use \cs{glspdffmtfullpl}}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\Glsfmtfullpl}[1]{%
- \texorpdfstring
- {\Glsxtrtitlefullpl{#1}}%
- {\glspdffmtfullpl{#1}{}}%
- }
-}
-{
- \newcommand*{\Glsfmtfullpl}[1]{%
- \Glsxtrtitlefullpl{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\GLSfmtfullpl}
-%All upper case.
-%\changes{1.42}{2020-02-03}{new}
-% \begin{macrocode}
-\ifdef\texorpdfstring
-{
- \newcommand*{\GLSfmtfullpl}[1]{%
- \texorpdfstring
- {\GLSxtrtitlefullpl{#1}}%
- {\glspdffmtfullpl{#1}{}}%
- }
-}
-{
- \newcommand*{\GLSfmtfullpl}[1]{%
- \GLSxtrtitlefullpl{#1}}
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\section{Multi (Combined/Compound) Entries}
-%(I'd rather call these combined or compound entries but \cs{cgls} is
-%already taken.)
-%
-%New to version 1.48, the commands here provide a way of referencing
-%multiple entries as a single unit. For example, biological
-%organisms are often referred to by their genus and species, such as
-%\emph{Clostridium botulinum} and \emph{Clostridium perfringens}
-%(where the genus is Clostridium). The genus is often abbreviated
-%after first use, regardless of which species in the genus is being
-%referenced. For example, \qt{\emph{Clostridium botulinum} and
-%\emph{C. perfringens}}. This can't be supported by any abbreviation
-%styles unless the genus and species names are defined separately.
-%For example:
-%\begin{verbatim}
-%\setabbreviationstyle{long-only-short-only}
-%\newabbreviation{clostridium}{C.}{Clostridium}
-%\newglossaryentry{botulinum}{name={botulinum},description={}}
-%\newglossaryentry{perfringens}{name={perfringens},description={}}
-%\end{verbatim}
-%This means that the entries then need to be referenced using a
-%rather cumbersome method:
-%\begin{verbatim}
-%\gls{clostridium} \gls{botulinum} and \gls{clostridum}
-%\gls{perfringens}
-%\end{verbatim}
-%This section provides a command that will provide a way of defining
-%a label that represents a combination of entries (which must all be
-%first defined). For example:
-%\begin{verbatim}
-%\multiglossaryentry{cbot}{clostridium,botulinum}
-%\end{verbatim}
-%This label can then be referenced using \cs{mgls}, which internally
-%uses \cs{gls} for each component. The last component in the list is
-%considered the \qt{main} component (not to be confused with the
-%main glossary). If this isn't the case, the label of the main
-%component should be added in the optional argument before the label
-%list. Note that the multi-label (\texttt{cbot} in this case) can't be
-%referenced using commands like \cs{gls}.
-%
-%First define the general set of options that should be applied to
-%all multi-entries. These can be set with:
-%\begin{macro}{\multiglossaryentrysetup}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\multiglossaryentrysetup}[1]{\setkeys{glsxtrcombined}{#1}}
-% \end{macrocode}
-%\end{macro}
-%\begin{macro}{\@gls@combined@indexmain}
-%\changes{1.48}{2021-11-22}{new}
-%Numeric value: 0=false (don't index main component), 1=true (always
-%index main component), 2=first (only index main component on first
-%use). Default: 1 (true);
-% \begin{macrocode}
-\newcommand*{\@gls@combined@indexmain}{1}
-\define@choicekey{glsxtrcombined}{indexmain}%
- [\@gls@combined@indexmain@val\@gls@combined@indexmain]
- {false,true,first}[true]{}
-% \end{macrocode}
-%\end{macro}
-%\begin{macro}{\@gls@combined@indexothers}
-%\changes{1.48}{2021-11-22}{new}
-%Numeric value: 0=false (don't index other components), 1=true (always
-%index other components), 2=first (only index other components on first
-%use). Default: 2 (first);
-% \begin{macrocode}
-\newcommand*{\@gls@combined@indexothers}{2}
-\define@choicekey{glsxtrcombined}{indexothers}%
- [\@gls@combined@indexothers@val\@gls@combined@indexothers]
- {false,true,first}[true]{}
-% \end{macrocode}
-%\end{macro}
-%\begin{macro}{\@gls@combined@hyper}
-%\changes{1.48}{2021-11-22}{new}
-%Numeric value: 0=none (\cs{mgls} doesn't create a hyperlink),
-% 1=allmain (all content hyperlinks to the main component),
-% 2=mainonly (only the main component has a hyperlink),
-% 3=individual (each component has a hyperlink to their own target).
-% Default: 3.
-% \begin{macrocode}
-\newcommand*{\@gls@combined@hyper}{3}
-\define@choicekey{glsxtrcombined}{hyper}%
- [\@gls@combined@hyper@val\@gls@combined@hyper]
- {none,allmain,mainonly,individual,otheronly,notmainfirst,nototherfirst,notfirst}{}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@gls@combined@encapmain}
-%\changes{1.48}{2021-11-22}{new}
-%Location encap value for main component (corresponding to format key in \cs{gls}).
-% \begin{macrocode}
-\newcommand*{\@gls@combined@encapmain}{glsnumberformat}
-\define@key{glsxtrcombined}{encapmain}{%
- \renewcommand*{\@gls@combined@encapmain}{#1}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@gls@combined@encapothers}
-%\changes{1.48}{2021-11-22}{new}
-%Location encap value for other components (corresponding to format key in \cs{gls}).
-% \begin{macrocode}
-\newcommand*{\@gls@combined@encapothers}{glsnumberformat}
-\define@key{glsxtrcombined}{encapothers}{%
- \renewcommand*{\@gls@combined@encapothers}{#1}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@gls@combined@textformat}
-%\changes{1.48}{2021-11-22}{new}
-%Encapsulate entire content with the command identified by the given
-%control sequence name.
-% \begin{macrocode}
-\newcommand*{\@gls@combined@textformat}{@firstofone}
-\define@key{glsxtrcombined}{textformat}{%
- \renewcommand*{\@gls@combined@textformat}{#1}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@gls@combined@category}
-%\changes{1.48}{2021-11-22}{new}
-%Assign a category to the combined set.
-% \begin{macrocode}
-\newcommand*{\@gls@combined@category}{}
-\define@key{glsxtrcombined}{category}{%
- \renewcommand*{\@gls@combined@category}{#1}%
-}
-% \end{macrocode}
-%Pre-options family:
-% \begin{macrocode}
-\define@key{glsxtrcombinedpreopts}{category}{%
- \renewcommand*{\@gls@combined@category}{#1}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@gls@combined@mglsopts}
-%\changes{1.48}{2021-11-22}{new}
-%Default options to pass to \cs{mgls}.
-% \begin{macrocode}
-\newcommand*{\@gls@combined@mglsopts}{}
-\define@key{glsxtrcombined}{mglsopts}{%
- \renewcommand*{\@gls@combined@mglsopts}{#1}%
-}
-\define@key{glsxtrcombinedpreopts}{mglsopts}{%
- \@gls@combined@mglsopts@do
- {%
- \renewcommand*{\@gls@combined@mglsopts}{#1}%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@gls@combined@mglsopts@do}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@gls@combined@mglsopts@do}[1]{#1}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mgls@disable@mglsopts}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\mgls@disable@mglsopts}{%
- \let\@gls@combined@mglsopts@do\@gls@combined@mglsopts@do@not
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mgls@enable@mglsopts}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\mgls@enable@mglsopts}{%
- \let\@gls@combined@mglsopts@do\@firstofone
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@gls@combined@mglsopts@do}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@gls@combined@mglsopts@do@not}[1]{%
- \PackageError{glossaries-extra}{`mglsopts' key not permitted inside
- `setup' value}{}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@gls@combined@firstprefix}
-%\changes{1.48}{2021-11-22}{new}
-%Prefix for multi-entry first use.
-% \begin{macrocode}
-\newcommand*{\@gls@combined@firstprefix}{}
-\define@key{glsxtrcombined}{firstprefix}{%
- \renewcommand*{\@gls@combined@firstprefix}{#1}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@gls@combined@usedprefix}
-%\changes{1.48}{2021-11-22}{new}
-%Prefix for multi-entry subsequent first use.
-% \begin{macrocode}
-\newcommand*{\@gls@combined@usedprefix}{}
-\define@key{glsxtrcombined}{usedprefix}{%
- \renewcommand*{\@gls@combined@usedprefix}{#1}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@gls@combined@firstsuffix}
-%\changes{1.48}{2021-11-22}{new}
-%Suffix for multi-entry first use.
-% \begin{macrocode}
-\newcommand*{\@gls@combined@firstsuffix}{}
-\define@key{glsxtrcombined}{firstsuffix}{%
- \renewcommand*{\@gls@combined@firstsuffix}{#1}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@gls@combined@usedsuffix}
-%\changes{1.48}{2021-11-22}{new}
-%Suffix for multi-entry subsequent first use.
-% \begin{macrocode}
-\newcommand*{\@gls@combined@usedsuffix}{}
-\define@key{glsxtrcombined}{usedsuffix}{%
- \renewcommand*{\@gls@combined@usedsuffix}{#1}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@gls@combined@firstskipmain}
-%\changes{1.48}{2021-11-22}{new}
-%Skip the main element on first use (multi-entry first use not
-%element first use).
-% \begin{macrocode}
-\define@boolkey{glsxtrcombined}{firstskipmain}[true]{}
-\KV@glsxtrcombined@firstskipmainfalse
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@gls@combined@firstskipothers}
-%\changes{1.48}{2021-11-22}{new}
-%Skip the other elements on first use (multi-entry first use not
-%element first use).
-% \begin{macrocode}
-\define@boolkey{glsxtrcombined}{firstskipothers}[true]{}
-\KV@glsxtrcombined@firstskipothersfalse
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@gls@combined@usedskipmain}
-%\changes{1.48}{2021-11-22}{new}
-%Skip the main element on subsequent use (multi-entry subsequent use not
-%element subsequent use).
-% \begin{macrocode}
-\define@boolkey{glsxtrcombined}{usedskipmain}[true]{}
-\KV@glsxtrcombined@usedskipmainfalse
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@gls@combined@usedskipothers}
-%\changes{1.48}{2021-11-22}{new}
-%Skip the other elements on subsequent use (multi-entry subsequent use not
-%element subsequent use).
-% \begin{macrocode}
-\define@boolkey{glsxtrcombined}{usedskipothers}[true]{}
-\KV@glsxtrcombined@usedskipothersfalse
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@gls@combined@postlinks}
-%\changes{1.48}{2021-11-22}{new}
-%Determine whether or not to use the individual element post-link hooks.
-% \begin{macrocode}
-\newcommand*{\@gls@combined@postlinks@nr}{0}
-\define@choicekey{glsxtrcombined}{postlinks}%
- [\@gls@combined@postlinks@val\@gls@combined@postlinks@nr]
- {none,all,notlast,mainnotlast,mainonly,othernotlast,otheronly}{}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@gls@combined@mpostlink}
-%\changes{1.48}{2021-11-22}{new}
-%Determine whether or not to use the multi-entry post-link hook.
-% \begin{macrocode}
-\newcommand*{\@gls@combined@mpostlink@nr}{1}
-\define@choicekey{glsxtrcombined}{mpostlink}%
- [\@gls@combined@mpostlink@val\@gls@combined@mpostlink@nr]
- {false,true,firstonly,usedonly}[true]{}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@gls@combined@mpostlinkelement}
-%\changes{1.48}{2021-11-22}{new}
-%Determine which element to use for the post-link hook.
-% \begin{macrocode}
-\newcommand*{\@gls@combined@mpostlinkelement@nr}{0}
-\define@choicekey{glsxtrcombined}{mpostlinkelement}%
- [\@gls@combined@mpostlinkelement@val\@gls@combined@mpostlinkelement@nr]
- {last,main,custom}{}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrifmulti}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\glsxtrifmulti}[3]{\ifcsdef{@gls@combined@#1@main}{#2}{#3}}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrmultimain}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\glsxtrmultimain}[1]{\csuse{@gls@combined@#1@main}}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrmultilist}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\glsxtrmultilist}[1]{\csuse{@gls@combined@#1@list}}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrmultitotalelements}
-%\changes{1.48}{2021-11-22}{new}
-%Total number of elements.
-% \begin{macrocode}
-\newcommand*{\glsxtrmultitotalelements}[1]{\csuse{@gls@combined@#1@total}}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrmultimainindex}
-%\changes{1.48}{2021-11-22}{new}
-%Index of main element (starting from 1). If the main element is the
-%last element in the list then this should equal the total number of
-%elements.
-% \begin{macrocode}
-\newcommand*{\glsxtrmultimainindex}[1]{\csuse{@gls@combined@#1@mainindex}}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrmultilastotherindex}
-%\changes{1.48}{2021-11-22}{new}
-%Index of the last non-main element.
-% \begin{macrocode}
-\newcommand*{\glsxtrmultilastotherindex}[1]{\csuse{@gls@combined@#1@lastotherindex}}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\ifmultiglossaryentryglobal}
-%\changes{1.48}{2021-11-22}{new}
-%Make definitions global.
-% \begin{macrocode}
-\newif\ifmultiglossaryentryglobal
-\multiglossaryentryglobalfalse
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglselementindex}
-%\changes{1.48}{2021-11-22}{new}
-% Count register to keep track of the current element index.
-% \begin{macrocode}
-\newcount\mglselementindex
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\multiglossaryentry}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{multiglossaryentry}\oarg{options}\marg{multi-label}\oarg{main label}\marg{label
-%list}
-%\end{definition}
-%Defines the label \meta{multi-label} that can be used in \cs{mgls}.
-% \begin{macrocode}
-\newrobustcmd{\multiglossaryentry}[1][]{%
- \def\@gls@combined@current@opts{#1}%
- \ifnum\@glsxtr@docdefval=1\relax
- \let\@multi@glossentry@donext\@defmultiglossaryentry
- \else
- \let\@multi@glossentry@donext\@multiglossaryentry
- \fi
- \@multi@glossentry@donext
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@multiglossaryentry}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@multiglossaryentry}[1]{%
- \def\@gls@combined@current@label{#1}%
- \@multi@glossaryentry
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@multi@glossaryentry}
-%\changes{1.48}{2021-11-22}{new}
-% Check for existence.
-% \begin{macrocode}
-\newcommand*{\@multi@glossaryentry}[2][]{%
- \ifcsdef{@gls@combined@\@gls@combined@current@label @main}%
- {\PackageError{glossaries-extra}%
- {Multi-entry label `\@gls@combined@current@label' already defined}%
- {}%
- }%
- {%
- \@multi@glossary@entry{#1}{#2}%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@defmultiglossaryentry}
-%\changes{1.48}{2021-11-22}{new}
-%Used if document definitions are on.
-% \begin{macrocode}
-\newcommand*{\@defmultiglossaryentry}[1]{%
- \def\@gls@combined@current@label{#1}%
- \@def@multi@glossaryentry
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@def@multi@glossaryentry}
-%\changes{1.48}{2021-11-22}{new}
-%Used if document definitions are on.
-% \begin{macrocode}
-\newcommand*{\@def@multi@glossaryentry}[2][]{%
- \let\@def@multi@glossaryentry@do\@multi@glossary@entry
- \ifundef\@glsxtr@docdefs@multilist
- {%
- \gdef\@glsxtr@docdefs@multilist{}%
- \listxadd
- {\@glsxtr@docdefs@multilist}{\expandonce\@gls@combined@current@label}%
- }%
- {%
- \xifinlist{\@gls@combined@current@label}{\@glsxtr@docdefs@multilist}%
- {%
- \PackageError{glossaries-extra}%
- {Multi-entry label `\@gls@combined@current@label' already defined}%
- {}%
- \let\@def@multi@glossaryentry@do\@gobbletwo
- }%
- {%
- \listxadd
- {\@glsxtr@docdefs@multilist}{\expandonce\@gls@combined@current@label}%
- }%
- }%
- \@def@multi@glossaryentry@do{#1}{#2}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@multi@glossary@doifexists}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@multi@glossary@doifexists}{\glsdoifexists}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\providemultiglossaryentry}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{providemultiglossaryentry}\oarg{options}\marg{multi-label}\oarg{main label}\marg{label
-%list}
-%\end{definition}
-%Defines a multi-entry unless it has already been defined.
-% \begin{macrocode}
-\newrobustcmd{\providemultiglossaryentry}[2][]{%
- \def\@gls@combined@current@opts{#1}%
- \def\@gls@combined@current@label{#2}%
- \ifcsdef{@gls@combined@\@gls@combined@current@label @main}%
- {\def\@multi@glossentry@donext{\@provide@multi@glossaryentry@noop}}%
- {%
- \ifnum\@glsxtr@docdefval=1\relax
- \def\@multi@glossentry@donext{\@def@multi@glossaryentry}%
- \else
- \def\@multi@glossentry@donext{\@multi@glossaryentry}%
- \fi
- }%
- \@multi@glossentry@donext
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@provide@multi@glossaryentry@noop}
-%\changes{1.48}{2021-11-22}{new}
-% Do nothing.
-% \begin{macrocode}
-\newcommand*{\@provide@multi@glossaryentry@noop}[2][]{}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@multi@glossaryentry@list}
-%\changes{1.48}{2021-11-22}{new}
-% List of all defined multi-entry sets.
-% \begin{macrocode}
-\newcommand*{\@multi@glossaryentry@list}{}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@multi@glossary@entry}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@multi@glossary@entry}[2]{%
- \protected@edef\@gls@combined@current@main{#1}%
-% \end{macrocode}
-% Fully expand list.
-% \begin{macrocode}
- \protected@edef\@gls@combined@currentlist{#2}%
-% \end{macrocode}
-% Count items in list, check they are all defined, and find last item at the same time.
-% \begin{macrocode}
- \mglselementindex=0\relax
- \@for\@gls@tmp:=\@gls@combined@currentlist\do{%
- \advance\mglselementindex by 1\relax
- \@multi@glossary@doifexists{\@gls@tmp}{}%
- \let\@gls@combined@finalitem\@gls@tmp
- \ifdefvoid\@gls@combined@current@main
- {}%
- {%
- \ifx\@gls@combined@current@main\@gls@tmp
- \ifmultiglossaryentryglobal
- \global\cslet{@gls@combined@\@gls@combined@current@label @main}%
- \@gls@combined@current@main
- \csxdef{@gls@combined@\@gls@combined@current@label @mainindex}%
- {\the\mglselementindex}%
- \else
- \cslet{@gls@combined@\@gls@combined@current@label @main}%
- \@gls@combined@current@main
- \csedef{@gls@combined@\@gls@combined@current@label @mainindex}%
- {\the\mglselementindex}%
- \fi
- \else
- \ifmultiglossaryentryglobal
- \csxdef{@gls@combined@\@gls@combined@current@label @lastotherindex}%
- {\the\mglselementindex}%
- \else
- \csedef{@gls@combined@\@gls@combined@current@label @lastotherindex}%
- {\the\mglselementindex}%
- \fi
- \fi
- }%
- }%
- \ifmultiglossaryentryglobal
- \csxdef{@gls@combined@\@gls@combined@current@label @total}%
- {\the\mglselementindex}%
- \else
- \csedef{@gls@combined@\@gls@combined@current@label @total}%
- {\the\mglselementindex}%
- \fi
- \ifnum\mglselementindex<2\relax
- \PackageError{glossaries-extra}{At least 2 labels required in
- multi-entry element list (\number\mglselementindex\space found)}{}%
- \else
- \ifdefvoid\@gls@combined@current@main
- {}%
- {%
-% \end{macrocode}
-% If \cs{@gls@combined@\meta{label}@main} hasn't been set then it
-% wasn't included in the list.
-% \begin{macrocode}
- \ifcsundef{@gls@combined@\@gls@combined@current@label @main}%
- {\PackageError{glossaries-extra}%
- {Main element `\@gls@combined@current@main' not found in list}%
- {The final element `\@gls@combined@finalitem' will be used instead}
-% \end{macrocode}
-% Set to empty so that the default (final element) is used instead.
-% \begin{macrocode}
- \let\@gls@combined@current@main\@empty
- }%
- {}%
- }%
- \ifdefvoid\@gls@combined@current@main
- {%
-% \end{macrocode}
-% Set main to final element.
-% \begin{macrocode}
- \ifmultiglossaryentryglobal
- \global\cslet{@gls@combined@\@gls@combined@current@label @main}%
- \@gls@combined@finalitem
- \global\csletcs{@gls@combined@\@gls@combined@current@label @mainindex}%
- {@gls@combined@\@gls@combined@current@label @total}%
- \csxdef{@gls@combined@\@gls@combined@current@label @lastotherindex}%
- {\the\numexpr\mglselementindex-1 }%
- \else
- \cslet{@gls@combined@\@gls@combined@current@label @main}%
- \@gls@combined@finalitem
- \csletcs{@gls@combined@\@gls@combined@current@label @mainindex}%
- {@gls@combined@\@gls@combined@current@label @total}%
- \csedef{@gls@combined@\@gls@combined@current@label @lastotherindex}%
- {\the\numexpr\mglselementindex-1 }%
- \fi
- }%
- {}%
- \ifmultiglossaryentryglobal
-% \end{macrocode}
-% Globally define element list.
-% \begin{macrocode}
- \global\cslet{@gls@combined@\@gls@combined@current@label @list}%
- \@gls@combined@currentlist
-% \end{macrocode}
-% Globally define options.
-% \begin{macrocode}
- \protected@csxdef{@gls@combined@\@gls@combined@current@label @options}%
- {\@gls@combined@current@opts}%
-% \end{macrocode}
-% Global conditional definition.
-% \begin{macrocode}
- \expandafter\@ifdefinable
- \csname if@gls@combined@\@gls@combined@current@label @flag\endcsname
- {\expandafter\global\expandafter
- \newif\csname if@gls@combined@\@gls@combined@current@label @flag\endcsname}%
- \expandafter\global
- \csname @gls@combined@\@gls@combined@current@label @flagfalse\endcsname
- \else
-% \end{macrocode}
-% Locally define element list.
-% \begin{macrocode}
- \cslet{@gls@combined@\@gls@combined@current@label @list}%
- \@gls@combined@currentlist
-% \end{macrocode}
-% Locally define options.
-% \begin{macrocode}
- \protected@csedef{@gls@combined@\@gls@combined@current@label @options}%
- {\@gls@combined@current@opts}%
-% \end{macrocode}
-% Local conditional definition.
-% \begin{macrocode}
- \newboolean{@gls@combined@\@gls@combined@current@label @flag}%
- \csname @gls@combined@\@gls@combined@current@label @flagfalse\endcsname
- \fi
- \fi
- \writemultiglossentry
- {\@gls@combined@current@opts}{\@gls@combined@current@label}%
- {\csuse{@gls@combined@\@gls@combined@current@label @main}}{#2}%
-% \end{macrocode}
-%Append label to list.
-% \begin{macrocode}
- \ifmultiglossaryentryglobal
- \ifdefempty\@multi@glossaryentry@list
- {\let\@multi@glossaryentry@list\@gls@combined@current@label}%
- {%
- \eappto\@multi@glossaryentry@list{,\expandonce\@gls@combined@current@label}%
- }%
- \else
- \ifdefempty\@multi@glossaryentry@list
- {\global\let\@multi@glossaryentry@list\@gls@combined@current@label}%
- {%
- \xappto\@multi@glossaryentry@list{,\expandonce\@gls@combined@current@label}%
- }%
- \fi
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@glsxtr@multientry}
-%\begin{definition}
-%\cs{@glsxtr@multientry}\marg{options}\marg{multilabel}\marg{main}\marg{list}
-%\end{definition}
-%Information for aux file. Useful for \app{bib2gls} and also for
-%\pkgopt{docdef}.
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@glsxtr@multientry}[4]{%
- \ifnum\@glsxtr@docdefval=1\relax
- \bgroup
- \def\@gls@combined@current@opts{#1}%
- \def\@gls@combined@current@label{#2}%
- \let\@multi@glossary@doifexists\@secondoftwo
- \let\writemultiglossentry\@gobblefour
- \multiglossaryentryglobaltrue
- \@multi@glossary@entry{#3}{#4}%
- \egroup
- \fi
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\writemultiglossentry}
-%\changes{1.48}{2021-11-22}{new}
-%This can be redefined to do nothing if the information isn't
-%required.
-% \begin{macrocode}
-\newcommand*{\writemultiglossentry}[4]{%
- \protected@write\@auxout{}{\string\@glsxtr@multientry{#1}{#2}{#3}{#4}}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\ifmglsused}
-%\changes{1.48}{2021-11-22}{new}
-% Determines whether or not the multi-entry set has been referenced
-% by commands like \cs{mgls} or \cs{mglsname}.
-% \begin{macrocode}
-\newcommand*{\ifmglsused}[3]{%
- \ifbool{@gls@combined@#1@flag}{#2}{#3}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsunset}
-%\changes{1.48}{2021-11-22}{new}
-%Unset the flag.
-% \begin{macrocode}
-\newcommand*{\mglsunset}[1]{%
- \gls@ifnotmeasuring
- {%
- \glsxtrifmulti{#1}{\@mglsunset{#1}}%
- {%
- \glsxtrundefaction{Multi entry `#1' hasn't been defined}%
- {You need to define `#1' with \string\multiglossaryentry}%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@mglsunset}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@mglsunset}[1]{%
- \expandafter\global\csname @gls@combined@#1@flagtrue\endcsname
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsreset}
-%\changes{1.48}{2021-11-22}{new}
-%Unset the flag.
-% \begin{macrocode}
-\newcommand*{\mglsreset}[1]{%
- \gls@ifnotmeasuring
- {%
- \glsxtrifmulti{#1}{\@mglsreset{#1}}%
- {%
- \glsxtrundefaction{Multi entry `#1' hasn't been defined}%
- {You need to define `#1' with \string\multiglossaryentry}%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@mglsreset}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@mglsreset}[1]{%
- \expandafter\global\csname @gls@combined@#1@flagfalse\endcsname
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglslocalunset}
-%\changes{1.48}{2021-11-22}{new}
-%Unset the flag.
-% \begin{macrocode}
-\newcommand*{\mglslocalunset}[1]{%
- \gls@ifnotmeasuring
- {%
- \glsxtrifmulti{#1}{\@mglslocalunset{#1}}%
- {%
- \glsxtrundefaction{Multi entry `#1' hasn't been defined}%
- {You need to define `#1' with \string\multiglossaryentry}%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@mglslocalunset}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@mglslocalunset}[1]{%
- \csname @gls@combined@#1@flagtrue\endcsname
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglslocalreset}
-%\changes{1.48}{2021-11-22}{new}
-%Unset the flag.
-% \begin{macrocode}
-\newcommand*{\mglslocalreset}[1]{%
- \gls@ifnotmeasuring
- {%
- \glsxtrifmulti{#1}{\@mglslocalreset{#1}}%
- {%
- \glsxtrundefaction{Multi entry `#1' hasn't been defined}%
- {You need to define `#1' with \string\multiglossaryentry}%
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@mglslocalreset}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@mglslocalreset}[1]{%
- \csname @gls@combined@#1@flagfalse\endcsname
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsunsetall}
-%\changes{1.48}{2021-11-22}{new}
-%Unset all.
-% \begin{macrocode}
-\newcommand*{\mglsunsetall}{%
- \@for\@mgls@thislabel:=\@multi@glossaryentry@list\do{\mglsunset\@mgls@thislabel}%
-}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsresetall}
-%\changes{1.48}{2021-11-22}{new}
-%Reset all.
-% \begin{macrocode}
-\newcommand*{\mglsresetall}{%
- \@for\@mgls@thislabel:=\@multi@glossaryentry@list\do{\mglsreset\@mgls@thislabel}%
-}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsSetMain}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{mglsSetName}\marg{multi-label}\marg{new main}
-%\end{definition}
-%Allow the main label to be changed (local).
-% \begin{macrocode}
-\newrobustcmd{\mglsSetMain}[2]{%
- \ifcsundef{@gls@combined@#1@main}%
- {\PackageError{glossaries-extra}{Multi-entry label `#1' not defined}{}}%
- {%
- \protected@edef\@gls@combined@current@main{#2}%
- \letcs\@gls@combined@currentlist{@gls@combined@#1@list}%
-% \end{macrocode}
-% Check that the given label is in the list of elements and update
-% main and last other element index.
-% \begin{macrocode}
- \mglselementindex=0\relax
- \count@=0\relax
- \@for\@gls@tmp:=\@gls@combined@currentlist\do{%
- \advance\mglselementindex by 1\relax
- \ifx\@gls@combined@current@main\@gls@tmp
- \count@=\mglselementindex\relax
- \let\@gls@combined@finalitem\@gls@tmp
- \ifmultiglossaryentryglobal
- \global\cslet{@gls@combined@#1@main}\@gls@combined@current@main
- \csxdef{@gls@combined@#1@mainindex}{\the\mglselementindex}%
- \else
- \cslet{@gls@combined@#1@main}\@gls@combined@current@main
- \csedef{@gls@combined@#1@mainindex}{\the\mglselementindex}%
- \fi
- \else
- \ifmultiglossaryentryglobal
- \csxdef{@gls@combined@#1@lastotherindex}{\the\mglselementindex}%
- \else
- \csedef{@gls@combined@#1@lastotherindex}{\the\mglselementindex}%
- \fi
- \fi
- }%
- \ifnum\count@=0\relax
- \PackageError{glossaries-extra}{Label `#2' is not in `#1' set
- (\@gls@combined@currentlist)}{}%
-% \end{macrocode}
-% Default to final item.
-% \begin{macrocode}
- \ifmultiglossaryentryglobal
- \global\cslet{@gls@combined@#1@main}\@gls@combined@finalitem
- \csxdef{@gls@combined@#1@mainindex}{\the\mglselementindex}%
- \csxdef{@gls@combined@#1@lastotherindex}{%
- \number\numexpr\mglselementindex-1 }%
- \else
- \cslet{@gls@combined@#1@main}\@gls@combined@finalitem
- \csedef{@gls@combined@#1@mainindex}{\the\mglselementindex}%
- \csedef{@gls@combined@#1@lastotherindex}{%
- \number\numexpr\mglselementindex-1 }%
- \fi
- \fi
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsSetOptions}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{mglsSetOptions}\marg{multi-label}\marg{new options}
-%\end{definition}
-%Allow the options to be changed (local). No expansion is applied.
-% \begin{macrocode}
-\newrobustcmd{\mglsSetOptions}[2]{%
- \ifcsundef{@gls@combined@#1@main}%
- {\PackageError{glossaries-extra}{Multi-entry label `#1' not defined}{}}%
- {%
- \csdef{@gls@combined@#1@options}{#2}%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsAddOptions}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{mglsAddOptions}\marg{multi-label}\marg{extra options}
-%\end{definition}
-%Allow the options to be changed (local). No expansion is applied.
-% \begin{macrocode}
-\newrobustcmd{\mglsAddOptions}[2]{%
- \ifcsundef{@gls@combined@#1@main}%
- {\PackageError{glossaries-extra}{Multi-entry label `#1' not defined}{}}%
- {%
- \ifcsempty{@gls@combined@#1@options}%
- {\csdef{@gls@combined@#1@options}{#2}}%
- {\csappto{@gls@combined@#1@options}{,#2}}%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%Options for \cs{mgls}:
-%\begin{macro}{\@mgls@all}
-%\changes{1.48}{2021-11-22}{new}
-%Options to apply to all elements.
-% \begin{macrocode}
-\newcommand*{\@mgls@all}{}
-\define@key{mgls}{all}{\renewcommand*{\@mgls@all}{#1}}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@mgls@main}
-%\changes{1.48}{2021-11-22}{new}
-%Options to apply to the main element only.
-% \begin{macrocode}
-\newcommand*{\@mgls@main}{}
-\define@key{mgls}{main}{\renewcommand*{\@mgls@main}{#1}}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@mgls@others}
-%\changes{1.48}{2021-11-22}{new}
-%Options to apply to the other (no main) elements.
-% \begin{macrocode}
-\newcommand*{\@mgls@others}{}
-\define@key{mgls}{others}{\renewcommand*{\@mgls@others}{#1}}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@mgls@setup}
-%\changes{1.48}{2021-11-22}{new}
-%Options to apply to \cs{multiglossaryentrysetup}.
-% \begin{macrocode}
-\newcommand*{\@mgls@setup}{}
-\define@key{mgls}{setup}{%
- \@mgls@setup@do{\renewcommand*{\@mgls@setup}{#1}}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@mgls@setup@do}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@mgls@setup@do}[1]{#1}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@mgls@setup@do@not}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@mgls@setup@do@not}[1]{%
- \PackageError{glossaries-extra}{`setup' key not permitted inside
- `mglsopts' value}{}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mgls@disable@setup}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\mgls@disable@setup}{%
- \let\@mgls@setup@do\@mgls@setup@do@not
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mgls@enable@setup}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\mgls@enable@setup}{%
- \let\@mgls@setup@do\@firstofone
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@mgls@unsetaction}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand\@mgls@unsetaction{0}
-\define@choicekey{mgls}{multiunset}[\@mgls@unsetaction@val\@mgls@unsetaction]%
- {global,local,none}{}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\ifKV@mgls@presetlocal}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\define@boolkey{mgls}{presetlocal}[true]{}
-\KV@mgls@presetlocalfalse
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@mgls@hyper}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@mgls@hyper}{}
-\define@choicekey{mgls}{hyper}[\@mgls@hyper@val\@mgls@hyper@nr]{true,false}[true]%
-{%
- \renewcommand*{\@mgls@hyper}{hyper=#1}%
- \ifnum\@mgls@hyper@nr=1\relax
- \let\@mgls@hyperlink\@secondoftwo
- \else
- \let\@mgls@hyperlink\@@mgls@hyperlink
- \fi
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@@mgls@hyperlink}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@@mgls@hyperlink}[2]{%
- \ifx\@glslink\glsdonohyperlink
- #2%
- \else
- \glsxtr@org@dohyperlink{\glolinkprefix#1}{#2}%
- \fi
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@mgls@hyperlink}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\let\@mgls@hyperlink\@@mgls@hyperlink
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsforelements}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{mglsforelements}\marg{multi-label}\marg{cs}\marg{body}
-%\end{definition}
-% \begin{macrocode}
-\newcommand*{\mglsforelements}[3]{%
- \expandafter\@for\expandafter#2\expandafter:\expandafter
- =\csname @gls@combined@#1@list\endcsname\do{#3}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsforotherelements}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{mglsforotherelements}\marg{multi-label}\marg{cs}\marg{body}
-%\end{definition}
-% \begin{macrocode}
-\newcommand*{\mglsforotherelements}[3]{%
- \expandafter\@for\expandafter#2\expandafter:\expandafter
- =\csname @gls@combined@#1@list\endcsname\do
- {\expandafter\ifdefequal\csname @gls@combined@#1@main\endcsname{#2}{}{#3}}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsunsetothers}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\mglsunsetothers}[1]{%
- \mglsforotherelements{#1}{\@gls@tmp}{\glsunset{\@gls@tmp}}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglslocalunsetothers}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\mglslocalunsetothers}[1]{%
- \mglsforotherelements{#1}{\@gls@tmp}{\glslocalunset{\@gls@tmp}}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglselementreset}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\mglselementreset}[1]{%
- \ifKV@mgls@presetlocal
- \glslocalreset{#1}%
- \else
- \glsreset{#1}%
- \fi
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglselementunset}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\mglselementunset}[1]{%
- \ifKV@mgls@presetlocal
- \glslocalunset{#1}%
- \else
- \glsunset{#1}%
- \fi
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@mgls@resetall}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@mgls@resetall}{}
-\define@choicekey{mgls}{resetall}%
-[\@mgls@resetall@val\@mgls@resetall@nr]{false,true}[true]%
-{%
- \ifcase\@mgls@resetall@nr\relax
- \renewcommand*{\@mgls@resetall}{}%
- \or
- \renewcommand*{\@mgls@resetall}{%
- \@for\@gls@resetlabel:=\mglscurrentlist\do{\mglselementreset\@gls@resetlabel}}%
- \renewcommand*{\@mgls@unsetall}{}%
- \fi
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@mgls@resetmain}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@mgls@resetmain}{}
-\define@choicekey{mgls}{resetmain}
-[\@mgls@resetmain@val\@mgls@resetmain@nr]{false,true}[true]%
-{%
- \ifcase\@mgls@resetmain@nr\relax
- \renewcommand*{\@mgls@resetmain}{}%
- \or
- \renewcommand*{\@mgls@resetmain}{\mglselementreset\mglscurrentmainlabel}%
- \renewcommand*{\@mgls@unsetmain}{}%
- \fi
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@mgls@resetothers}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@mgls@resetothers}{}
-\define@choicekey{mgls}{resetothers}
-[\@mgls@resetothers@val\@mgls@resetothers@nr]{false,true}[true]%
-{%
- \ifcase\@mgls@resetothers@nr\relax
- \renewcommand*{\@mgls@resetothers}{}%
- \or
- \renewcommand*{\@mgls@resetothers}{%
- \@for\@gls@resetlabel:=\mglscurrentlist\do{%
- \ifx\@gls@resetlabel\mglscurrentmainlabel
- \else
- \mglselementreset\@gls@resetlabel
- \fi
- }%
- }%
- \renewcommand*{\@mgls@unsetothers}{}%
- \fi
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@mgls@unsetall}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@mgls@unsetall}{}
-\define@choicekey{mgls}{unsetall}%
-[\@mgls@unsetall@val\@mgls@unsetall@nr]{false,true}[true]%
-{%
- \ifcase\@mgls@unsetall@nr\relax
- \renewcommand*{\@mgls@unsetall}{}%
- \or
- \renewcommand*{\@mgls@unsetall}{%
- \@for\@gls@unsetlabel:=\mglscurrentlist\do{\mglselementunset\@gls@unsetlabel}}%
- \renewcommand*{\@mgls@resetall}{}%
- \fi
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@mgls@unsetmain}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@mgls@unsetmain}{}
-\define@choicekey{mgls}{unsetmain}
-[\@mgls@unsetmain@val\@mgls@unsetmain@nr]{false,true}[true]%
-{%
- \ifcase\@mgls@unsetmain@nr\relax
- \renewcommand*{\@mgls@unsetmain}{}%
- \or
- \renewcommand*{\@mgls@unsetmain}{\mglselementunset\mglscurrentmainlabel}%
- \renewcommand*{\@mgls@resetmain}{}%
- \fi
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@mgls@unsetothers}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@mgls@unsetothers}{}
-\define@choicekey{mgls}{unsetothers}
-[\@mgls@unsetothers@val\@mgls@unsetothers@nr]{false,true}[true]%
-{%
- \ifcase\@mgls@unsetothers@nr\relax
- \renewcommand*{\@mgls@unsetothers}{}%
- \or
- \renewcommand*{\@mgls@unsetothers}{%
- \@for\@gls@unsetlabel:=\mglscurrentlist\do{%
- \ifx\@gls@unsetlabel\mglscurrentmainlabel
- \else
- \mglselementunset\@gls@unsetlabel
- \fi
- }%
- }%
- \renewcommand*{\@mgls@resetothers}{}%
- \fi
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtr@setup@docurrent}
-%\changes{1.48}{2021-11-22}{new}
-%Set up the commands to determine whether or not to do the current
-%element.
-% \begin{macrocode}
-\newcommand{\glsxtr@setup@docurrent}{%
-% \end{macrocode}
-% \cs{mglscurrentlabel} expands to the label of the current element.
-% Should this element be skipped?
-% \begin{macrocode}
- \ifx\mglscurrentlabel\mglscurrentmainlabel
-% \end{macrocode}
-% Main element. Should it be skipped?
-% \begin{macrocode}
- \mglsisfirstuse
- {%
- \ifKV@glsxtrcombined@firstskipmain
- \let\@mgls@do@current@element\@gobble
- \else
- \let\@mgls@do@current@element\@firstofone
- \fi
- }%
- {%
- \ifKV@glsxtrcombined@usedskipmain
- \let\@mgls@do@current@element\@gobble
- \else
- \let\@mgls@do@current@element\@firstofone
- \fi
- }%
- \else
-% \end{macrocode}
-% Other element. Should it be skipped?
-% \begin{macrocode}
- \mglsisfirstuse
- {%
- \ifKV@glsxtrcombined@firstskipothers
- \let\@mgls@do@current@element\@gobble
- \else
- \let\@mgls@do@current@element\@firstofone
- \fi
- }%
- {%
- \ifKV@glsxtrcombined@usedskipothers
- \let\@mgls@do@current@element\@gobble
- \else
- \let\@mgls@do@current@element\@firstofone
- \fi
- }%
- \fi
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtr@mgls@checklastelement}
-%\changes{1.48}{2021-11-22}{new}
-% If the last element is skipped, \cs{mglsiflast} needs
-% adjusting.
-% The first argument should be either "first" or "used".
-% The second argument is the multi-element label.
-% \begin{macrocode}
-\newcommand*{\glsxtr@mgls@checklastelement}[2]{%
- \ifbool{KV@glsxtrcombined@#1skipmain}%
- {%
- \ifbool{KV@glsxtrcombined@#1skipothers}%
- {%
-% \end{macrocode}
-% This condition has already been checked for.
-% \begin{macrocode}
- }%
- {%
-% \end{macrocode}
-% Main skipped. The last item will be the last other element.
-% \begin{macrocode}
- \ifnum\mglselementindex=\glsxtrmultilastotherindex{#2}\relax
- \let\mglsiflast\@firstoftwo
- \else
- \let\mglsiflast\@secondoftwo
- \fi
- }%
- }%
- {%
-% \end{macrocode}
-% Main not skipped.
-% \begin{macrocode}
- \ifbool{KV@glsxtrcombined@#1skipothers}%
- {%
-% \end{macrocode}
-% Others skipped. The main element is the only item.
-% \begin{macrocode}
- \ifnum\mglselementindex=\glsxtrmultimainindex{#2}\relax
- \let\mglsiflast\@firstoftwo
- \else
- \let\mglsiflast\@secondoftwo
- \fi
- }%
- {%
-% \end{macrocode}
-% None skipped. This isn't the last element.
-% \begin{macrocode}
- \let\mglsiflast\@secondoftwo
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtrmglsWarnAllSkipped}
-%\changes{1.48}{2021-11-22}{new}
-%Warning if all elements are skipped. The first argument is the
-%warning message, the second argument is the inserted content (final
-%optional argument), the third command is the encapsulation command
-%(which may be a hyperlink).
-% \begin{macrocode}
-\newcommand{\glsxtrmglsWarnAllSkipped}[3]{%
- \GlossariesExtraWarning{#1}%
- #3{#2}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtr@mgls@applyopts}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\glsxtr@mgls@applyopts}[1]{%
- \edef\@mgls@dooptions{\noexpand\setkeys*{mgls}{\expandonce#1}}%
- \@mgls@dooptions
-% \end{macrocode}
-% Append any unknown options to all.
-% \begin{macrocode}
- \ifdefvoid\XKV@rm{}{\eappto\@mgls@all{,\expandonce\XKV@rm}}%
-% \end{macrocode}
-% If setup key has been used, check for pre-option keys:
-% \begin{macrocode}
- \ifdefvoid\@mgls@setup
- {}%
- {%
- \edef\@mgls@dooptions{%
- \noexpand\setkeys*{glsxtrcombinedpreopts}{\expandonce\@mgls@setup}}%
- \mgls@disable@mglsopts
- \@mgls@dooptions
- \mgls@enable@mglsopts
-% \end{macrocode}
-% Save remaining setup options.
-% \begin{macrocode}
- \ifx\@mgls@setupoptions\@empty
- \let\@mgls@setupoptions\XKV@rm
- \else
- \eappto\@mgls@setupoptions{,\expandonce\XKV@rm}%
- \fi
- }%
-% \end{macrocode}
-% Apply gls unset/reset options.
-% \begin{macrocode}
- \@mgls@resetall
- \@mgls@unsetall
- \@mgls@resetmain
- \@mgls@unsetmain
- \@mgls@resetothers
- \@mgls@unsetothers
-% \end{macrocode}
-% Disable.
-% \begin{macrocode}
- \let\@mgls@resetall\@empty
- \let\@mgls@resetmain\@empty
- \let\@mgls@resetothers\@empty
- \let\@mgls@unsetall\@empty
- \let\@mgls@unsetmain\@empty
- \let\@mgls@unsetothers\@empty
-% \end{macrocode}
-% First use flags.
-% \begin{macrocode}
- \ifmglsused\mglscurrentmultilabel
- {\let\mglsisfirstuse\@secondoftwo}%
- {\let\mglsisfirstuse\@firstoftwo}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@firstofthree}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\providecommand{\@firstofthree}[3]{#1}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@secondofthree}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\providecommand{\@secondofthree}[3]{#2}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@thirdofthree}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\providecommand{\@thirdofthree}[3]{#3}
-% \end{macrocode}
-%\end{macro}
-%
-%The main internal command for referencing multi-entries:
-%\begin{macro}{\glsxtr@mgls@inner}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{glsxtr@mgls@inner}\marg{options}\marg{label}\marg{insert}\marg{first
-%cs}\marg{not first cs}\marg{main first cs}\marg{main other cs}
-%\end{definition}
-% \begin{macrocode}
-\newcommand*{\glsxtr@mgls@inner}[7]{%
- \let\mglslastmainlabel\@empty
- \let\mglsiflastmainwasfirstuse\@firstoftwo
- \let\mglsiflastmainwasplural\@secondoftwo
- \let\mglsiflastmaincapscase\@firstofthree
- \let\mglsiflastmainskipped\@firstoftwo
- \bgroup
- \ifcsundef{@gls@combined@#2@main}%
- {%
- \glsxtrundefaction{Multi entry `#2' hasn't been defined}%
- {You need to define `#2' with \string\multiglossaryentry}%
- \gdef\@mgls@post@hookdefs{%
- \protected@edef\mglslastmultilabel{#2}%
- \let\mglswasfirstuse\@firstoftwo
- \let\mglslastcategory\@empty
- \let\mglsiflastelementskipped\@firstoftwo
- \let\mglsiflastelementwasfirstuse\@firstoftwo
- \let\mglsiflastelementwasplural\@secondoftwo
- \let\mglsiflastelementcapscase\@firstofthree
- \let\mglslastelementlabel\@empty
- \let\mgls@do@postlinkhook\relax
- }%
- }%
- {%
- \protected@edef\mglscurrentmultilabel{#2}%
- \letcs\mglscurrentmainlabel{@gls@combined@#2@main}%
- \letcs\mglscurrentlist{@gls@combined@#2@list}%
- \letcs\mglscurrentoptions{@gls@combined@#2@options}%
-% \end{macrocode}
-% Initialise (may be changed if \texttt{multiunset} is present):
-% \begin{macrocode}
- \ifmglsused\mglscurrentmultilabel
- {\let\mglsisfirstuse\@secondoftwo}%
- {\let\mglsisfirstuse\@firstoftwo}%
-% \end{macrocode}
-% Only obtain pre-option keys:
-% \begin{macrocode}
- \edef\@mgls@dooptions{%
- \noexpand\setkeys*{glsxtrcombinedpreopts}{\expandonce\mglscurrentoptions}}%
- \@mgls@dooptions
-% \end{macrocode}
-% Save remaining setup options.
-% \begin{macrocode}
- \let\@mgls@setupoptions\XKV@rm
-% \end{macrocode}
-% Apply \cs{mgls} options.
-% \begin{macrocode}
- \mgls@disable@setup
- \ifdefvoid\@gls@combined@mglsopts
- {}%
- {\glsxtr@mgls@applyopts\@gls@combined@mglsopts}%
- \mgls@enable@setup
-% \end{macrocode}
-% Apply options provided in \verb|#1|.
-% \begin{macrocode}
- \ifstrempty{#1}{}{\def\@mgls@options{#1}\glsxtr@mgls@applyopts\@mgls@options}%
-% \end{macrocode}
-% Check for attribute settings.
-% \begin{macrocode}
- \ifx\@gls@combined@category\empty
-% \end{macrocode}
-% No category
-% \begin{macrocode}
- \else
-% \end{macrocode}
-% Attribute options:
-% \begin{macrocode}
- \glshascategoryattribute{\@gls@combined@category}{multioptions}%
- {%
- \letcs\@mgls@attroptions{@glsxtr@categoryattr@@\@gls@combined@category
- @multioptions}%
-% \end{macrocode}
-% Only obtain pre-option keys:
-% \begin{macrocode}
- \let\@gls@combined@mglsopts\@empty
- \edef\@mgls@dooptions{%
- \noexpand\setkeys*{glsxtrcombinedpreopts}{\expandonce\@mgls@attroptions}}%
- \@mgls@dooptions
-% \end{macrocode}
-% Append remaining options:
-% \begin{macrocode}
- \eappto\@mgls@setupoptions{,\expandonce\XKV@rm}%
- \ifx\@gls@combined@mglsopts\@empty
- \else
-% \end{macrocode}
-% mgls options found:
-% \begin{macrocode}
- \let\@mgls@setup\@empty
- \mgls@disable@setup
- \glsxtr@mgls@applyopts\@gls@combined@mglsopts
- \mgls@enable@setup
- \fi
- }%
- {}%
- \fi
-% \end{macrocode}
-% Apply setup options.
-% \begin{macrocode}
- \edef\@mgls@dooptions{%
- \noexpand\setkeys{glsxtrcombined}{\expandonce\@mgls@setupoptions}}%
- \@mgls@dooptions
-% \end{macrocode}
-% Provide local user-level access to category:
-% \begin{macrocode}
- \let\mglscurrentcategory\@gls@combined@category
-% \end{macrocode}
-% Should the entire content be a hyperlink?
-% \begin{macrocode}
- \ifnum\@gls@combined@hyper=1\relax
- \def\@mgls@combinedlink{\@mgls@hyperlink{\mglscurrentmainlabel}}%
- \else
- \def\@mgls@combinedlink{\@firstofone}%
- \fi
-% \end{macrocode}
-% Entire content encapsulator.
-% \begin{macrocode}
- \def\@gls@combined@encapsulator##1{%
- \@mgls@combinedlink{\csuse{\@gls@combined@textformat}{##1}}}%
-% \end{macrocode}
-% Initialise.
-% \begin{macrocode}
- \let\@mgls@do@current@element\@firstofone
-% \end{macrocode}
-% Check if all elements are being skipped.
-% \begin{macrocode}
- \mglsisfirstuse
- {%
- \ifKV@glsxtrcombined@firstskipmain
- \ifKV@glsxtrcombined@firstskipothers
-% \end{macrocode}
-% Just do the warning and insert. This will ignore the loop.
-% \begin{macrocode}
- \let\@gls@org@combined@encapsulator\@gls@combined@encapsulator
- \def\@gls@combined@encapsulator##1{%
- \glsxtrmglsWarnAllSkipped{All elements skipped for
- first use of multi-entry `#2'}{#3}%
- {\@gls@org@combined@encapsulator}%
- }%
- \let\@mgls@do@current@element\@gobble
- \fi
- \fi
- }%
- {%
- \ifKV@glsxtrcombined@usedskipmain
- \ifKV@glsxtrcombined@usedskipothers
-% \end{macrocode}
-% Just do the warning and insert. This will ignore the loop.
-% \begin{macrocode}
- \let\@gls@org@combined@encapsulator\@gls@combined@encapsulator
- \def\@gls@combined@encapsulator##1{%
- \glsxtrmglsWarnAllSkipped{All elements skipped for
- subsequent use of multi-entry `#2'}{#3}%
- {\@gls@org@combined@encapsulator}%
- }%
- \let\@mgls@do@current@element\@gobble
- \fi
- \fi
- }%
-% \end{macrocode}
-% Determine prefix and suffix.
-% \begin{macrocode}
- \mglsisfirstuse
- {%
- \let\mglscurrentprefix\@gls@combined@firstprefix
- \let\mglscurrentsuffix\@gls@combined@firstsuffix
- }%
- {%
- \let\mglscurrentprefix\@gls@combined@usedprefix
- \let\mglscurrentsuffix\@gls@combined@usedsuffix
- }%
-% \end{macrocode}
-%Set up post-link hook used after current scope.
-% \begin{macrocode}
- \xdef\@mgls@post@hookdefs{%
- \noexpand\def\noexpand\mglslastmultilabel{\expandonce\mglscurrentmultilabel}%
- \noexpand\def\noexpand\mglslastcategory{\mglscurrentcategory}%
- }%
- \ifx\@mgls@do@current@element\@gobble
- \gappto\@mgls@post@hookdefs{%
- \let\mglsiflastelementskipped\@firstoftwo
- \let\mglslastelementlabel\@empty
- \let\mglsiflastelementwasfirstuse\@firstoftwo
- \let\mglsiflastelementwasplural\@secondoftwo
- \let\mglsiflastelementcapscase\@firstofthree
- }%
- \fi
- \mglsisfirstuse
- {%
- \gappto\@mgls@post@hookdefs{\let\mglswasfirstuse\@firstoftwo}%
-% \end{macrocode}
-% Determine if the multi-entry post-link hook should be applied.
-% \begin{macrocode}
- \ifcase\@gls@combined@mpostlink@nr\relax
-% \end{macrocode}
-% \texttt{mpostlink=false}.
-% \begin{macrocode}
- \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\relax}%
- \or
-% \end{macrocode}
-% \texttt{mpostlink=true}.
-% \begin{macrocode}
- \ifcase\@gls@combined@mpostlinkelement@nr\relax
- \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastelementpostlinkhook}%
- \or
- \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastmainpostlinkhook}%
- \or
- \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglscustompostlinkhook}%
- \fi
- \or
-% \end{macrocode}
-% \texttt{mpostlink=firstonly}.
-% \begin{macrocode}
- \ifcase\@gls@combined@mpostlinkelement@nr\relax
- \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastelementpostlinkhook}%
- \or
- \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastmainpostlinkhook}%
- \or
- \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglscustompostlinkhook}%
- \fi
- \or
-% \end{macrocode}
-% \texttt{mpostlink=usedonly}.
-% \begin{macrocode}
- \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\relax}%
- \fi
- }%
- {%
- \gappto\@mgls@post@hookdefs{\let\mglswasfirstuse\@secondoftwo}%
-% \end{macrocode}
-% Determine if the multi-entry post-link hook should be applied.
-% \begin{macrocode}
- \ifcase\@gls@combined@mpostlink@nr\relax
-% \end{macrocode}
-% \texttt{mpostlink=false}.
-% \begin{macrocode}
- \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\relax}%
- \or
-% \end{macrocode}
-% \texttt{mpostlink=true}.
-% \begin{macrocode}
- \ifcase\@gls@combined@mpostlinkelement@nr\relax
- \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastelementpostlinkhook}%
- \or
- \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastmainpostlinkhook}%
- \or
- \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglscustompostlinkhook}%
- \fi
- \or
-% \end{macrocode}
-% \texttt{mpostlink=firstonly}.
-% \begin{macrocode}
- \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\relax}%
- \or
-% \end{macrocode}
-% \texttt{mpostlink=usedonly}.
-% \begin{macrocode}
- \ifcase\@gls@combined@mpostlinkelement@nr\relax
- \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastelementpostlinkhook}%
- \or
- \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastmainpostlinkhook}%
- \or
- \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglscustompostlinkhook}%
- \fi
- \fi
- }%
-% \end{macrocode}
-% Save current post-link hook.
-% \begin{macrocode}
- \let\mgls@org@postlinkhook\glspostlinkhook
-% \end{macrocode}
-% Prefix.
-% \begin{macrocode}
- \mglsprefix
-% \end{macrocode}
-% Initialise last element label (for \cs{mglssuffix}).
-% \begin{macrocode}
- \let\mglslastelementlabel\@empty
- \@gls@combined@encapsulator
- {%
-% \end{macrocode}
-% Save previous label.
-% \begin{macrocode}
- \def\@mgls@previouslabel{}%
- \mglselementindex=0\relax
- \@for\mglscurrentlabel:=\mglscurrentlist\do{%
- \advance\mglselementindex by 1\relax
- \glsxtr@setup@docurrent
-% \end{macrocode}
-% Is this the last element?
-% \begin{macrocode}
- \ifx\@xfor@nextelement\@nnil
- \let\mglsiflast\@firstoftwo
- \else
- \let\mglsiflast\@secondoftwo
-% \end{macrocode}
-% Are any elements being skipped?
-% \begin{macrocode}
- \mglsisfirstuse
- {%
- \glsxtr@mgls@checklastelement{first}{#2}%
- }%
- {%
- \glsxtr@mgls@checklastelement{used}{#2}%
- }%
- \fi
-% \end{macrocode}
-% Should the element post-link hook be used?
-% \begin{macrocode}
- \ifcase\@gls@combined@postlinks@nr\relax
-% \end{macrocode}
-% \texttt{postlinks=none}
-% \begin{macrocode}
- \let\glspostlinkhook\relax
- \or
-% \end{macrocode}
-% \texttt{postlinks=all}
-% \begin{macrocode}
- \let\glspostlinkhook\mgls@org@postlinkhook
- \or
-% \end{macrocode}
-% \texttt{postlinks=notlast}
-% \begin{macrocode}
- \mglsiflast
- {%
- \let\glspostlinkhook\relax
- }%
- {%
- \let\glspostlinkhook\mgls@org@postlinkhook
- }%
- \or
-% \end{macrocode}
-% \texttt{postlinks=mainnotlast}
-% \begin{macrocode}
- \ifx\mglscurrentlabel\mglscurrentmainlabel
- \mglsiflast
- {%
- \let\glspostlinkhook\relax
- }%
- {%
- \let\glspostlinkhook\mgls@org@postlinkhook
- }%
- \else
- \let\glspostlinkhook\relax
- \fi
- \or
-% \end{macrocode}
-% \texttt{postlinks=mainonly}
-% \begin{macrocode}
- \ifx\mglscurrentlabel\mglscurrentmainlabel
- \let\glspostlinkhook\mgls@org@postlinkhook
- \else
- \let\glspostlinkhook\relax
- \fi
- \or
-% \end{macrocode}
-% \texttt{postlinks=othernotlast}
-% \begin{macrocode}
- \ifx\mglscurrentlabel\mglscurrentmainlabel
- \let\glspostlinkhook\relax
- \else
- \mglsiflast
- {%
- \let\glspostlinkhook\relax
- }%
- {%
- \let\glspostlinkhook\mgls@org@postlinkhook
- }%
- \fi
- \or
-% \end{macrocode}
-% \texttt{postlinks=otheronly}
-% \begin{macrocode}
- \ifx\mglscurrentlabel\mglscurrentmainlabel
- \let\glspostlinkhook\relax
- \else
- \let\glspostlinkhook\mgls@org@postlinkhook
- \fi
- \fi
-% \end{macrocode}
-% Save the last element for the multi-entry post-link hook.
-% \begin{macrocode}
- \mglsiflast
- {%
- \xappto\@mgls@post@hookdefs{%
- \noexpand\def\noexpand\mglslastelementlabel
- {\expandonce\mglscurrentlabel}}%
- }%
- {}%
-% \end{macrocode}
-% Do current element:
-% \begin{macrocode}
- \@mgls@do@current@element
- {%
-% \end{macrocode}
-% Pre element hook.
-% \begin{macrocode}
- \mglselementprehook
-% \end{macrocode}
-% Is this the first use of the current element?
-% \begin{macrocode}
- \GlsXtrIfUnusedOrUndefined{\mglscurrentlabel}%
- {\let\@mgls@current@iffirstuse\@firstoftwo}%
- {\let\@mgls@current@iffirstuse\@secondoftwo}%
- \ifx\mglscurrentlabel\mglscurrentmainlabel
-% \end{macrocode}
-% Main element.
-% Location encap option:
-% \begin{macrocode}
- \edef\@mgls@current@options{format=\@gls@combined@encapmain}%
-% \end{macrocode}
-%Indexing option:
-% \begin{macrocode}
- \ifcase\@gls@combined@indexmain
- \appto\@mgls@current@options{,noindex}%
- \or
- \appto\@mgls@current@options{,noindex=false}%
- \or
- \@mgls@current@iffirstuse
- {\appto\@mgls@current@options{,noindex=false}}%
- {\appto\@mgls@current@options{,noindex}}%
- \fi
-% \end{macrocode}
-% Hyperlink option:
-% \begin{macrocode}
- \ifcase\@gls@combined@hyper\relax
- \appto\@mgls@current@options{,hyper=false}% none
- \or
- \appto\@mgls@current@options{,hyper=false}% allmain
- \or
- \eappto\@mgls@current@options{,\@mgls@hyper}% mainonly
- \or
- \eappto\@mgls@current@options{,\@mgls@hyper}% individual
- \or
- \appto\@mgls@current@options{,hyper=false}% otheronly
- \or
- \mglsisfirstuse
- {%
- \appto\@mgls@current@options{,hyper=false}% notmainfirst
- }%
- {%
- \eappto\@mgls@current@options{,\@mgls@hyper}% notmainfirst
- }%
- \or
- \eappto\@mgls@current@options{,\@mgls@hyper}% nototherfirst
- \or
- \mglsisfirstuse
- {%
- \appto\@mgls@current@options{,hyper=false}% notfirst
- }%
- {%
- \eappto\@mgls@current@options{,\@mgls@hyper}% notfirst
- }%
- \fi
-% \end{macrocode}
-%Append all and then main:
-% \begin{macrocode}
- \eappto\@mgls@current@options{,\@mgls@all,\@mgls@main}%
- \else
-% \end{macrocode}
-% Other element.
-% Location encap option:
-% \begin{macrocode}
- \edef\@mgls@current@options{format=\@gls@combined@encapothers}%
-% \end{macrocode}
-% Indexing option:
-% \begin{macrocode}
- \ifcase\@gls@combined@indexothers\relax
- \appto\@mgls@current@options{,noindex}%
- \or
- \appto\@mgls@current@options{,noindex=false}%
- \or
- \@mgls@current@iffirstuse
- {\appto\@mgls@current@options{,noindex=false}}%
- {\appto\@mgls@current@options{,noindex}}%
- \fi
-% \end{macrocode}
-% Hyperlink option:
-% \begin{macrocode}
- \ifcase\@gls@combined@hyper\relax
- \appto\@mgls@current@options{,hyper=false}% none
- \or
- \appto\@mgls@current@options{,hyper=false}% allmain
- \or
- \appto\@mgls@current@options{,hyper=false}% mainonly
- \or
- \eappto\@mgls@current@options{,\@mgls@hyper}% individual
- \or
- \eappto\@mgls@current@options{,\@mgls@hyper}% otheronly
- \or
- \eappto\@mgls@current@options{,\@mgls@hyper}% notmainfirst
- \or
- \mglsisfirstuse
- {%
- \appto\@mgls@current@options{,hyper=false}% nototherfirst
- }%
- {%
- \eappto\@mgls@current@options{,\@mgls@hyper}% nototherfirst
- }%
- \or
- \mglsisfirstuse
- {%
- \appto\@mgls@current@options{,hyper=false}% notfirst
- }%
- {%
- \eappto\@mgls@current@options{,\@mgls@hyper}% notfirst
- }%
- \fi
-% \end{macrocode}
-%Append all and then others:
-% \begin{macrocode}
- \eappto\@mgls@current@options{,\@mgls@all,\@mgls@others}%
- \fi
-% \end{macrocode}
-% Is this the first element?
-% \begin{macrocode}
- \ifx\@mgls@previouslabel\empty
- \ifx\mglscurrentlabel\mglscurrentmainlabel
- \let\@mgls@cs#6\relax
- \else
- \let\@mgls@cs#4\relax
- \fi
- \else
-% \end{macrocode}
-% Not the first element so add separator.
-% \begin{macrocode}
- \@mgls@previous@iffirstuse
- {%
- \@mgls@current@iffirstuse
- {\glscombinedfirstsepfirst{\@mgls@previouslabel}{\mglscurrentlabel}}%
- {\glscombinedfirstsep{\@mgls@previouslabel}{\mglscurrentlabel}}%
- }%
- {%
- \@mgls@current@iffirstuse
- {\glscombinedsepfirst{\@mgls@previouslabel}{\mglscurrentlabel}}%
- {\glscombinedsep{\@mgls@previouslabel}{\mglscurrentlabel}}%
- }%
- \ifx\mglscurrentlabel\mglscurrentmainlabel
- \let\@mgls@cs#7\relax
- \else
- \let\@mgls@cs#5\relax
- \fi
- \fi
-% \end{macrocode}
-% Is this the last element?
-% \begin{macrocode}
- \mglsiflast
- {\expandafter\@mgls@cs\expandafter{\@mgls@current@options}{\mglscurrentlabel}[#3]}%
- {\expandafter\@mgls@cs\expandafter{\@mgls@current@options}{\mglscurrentlabel}[]}%
-% \end{macrocode}
-% Is this the main element? If so, save information for post-link
-% hook.
-% \begin{macrocode}
- \ifx\mglscurrentlabel\mglscurrentmainlabel
- \xappto\@mgls@post@hookdefs{%
- \noexpand\def\noexpand\mglslastmainlabel
- {\expandonce\mglscurrentmainlabel}%
- }%
- \glsxtrifwasfirstuse
- {%
- \gappto\@mgls@post@hookdefs{\let\mglsiflastmainwasfirstuse\@firstoftwo}%
- }%
- {%
- \gappto\@mgls@post@hookdefs{\let\mglsiflastmainwasfirstuse\@secondoftwo}%
- }%
- \glsifplural
- {%
- \gappto\@mgls@post@hookdefs{\let\mglsiflastmainwasplural\@firstoftwo}%
- }%
- {%
- \gappto\@mgls@post@hookdefs{\let\mglsiflastmainwasplural\@secondoftwo}%
- }%
- \glscapscase
- {%
- \gappto\@mgls@post@hookdefs{%
- \let\mglsiflastmaincapscase\@firstofthree
- }%
- }%
- {%
- \gappto\@mgls@post@hookdefs{%
- \let\mglsiflastmaincapscase\@secondofthree
- }%
- }%
- {%
- \gappto\@mgls@post@hookdefs{%
- \let\mglsiflastmaincapscase\@thirdofthree
- }%
- }%
- \fi
- \let\@mgls@previouslabel\mglscurrentlabel
- \let\@mgls@previous@iffirstuse\@mgls@current@iffirstuse
- }%
-% \end{macrocode}
-% Post element hook.
-% \begin{macrocode}
- \mglselementposthook
- }%
- \ifx\mglslastmainlabel\@empty
- \gappto\@mgls@post@hookdefs{\let\mglsiflastmainskipped\@firstoftwo}%
- \else
- \gappto\@mgls@post@hookdefs{\let\mglsiflastmainskipped\@secondoftwo}%
- \fi
-% \end{macrocode}
-% Encapsulator may introduce grouping so check here.
-% \begin{macrocode}
- \ifx\@mgls@do@current@element\@gobble
- \gappto\@mgls@post@hookdefs{\let\mglsiflastelementskipped\@firstoftwo}%
- \else
- \gappto\@mgls@post@hookdefs{\let\mglsiflastelementskipped\@secondoftwo}%
- \fi
- \glsxtrifwasfirstuse
- {%
- \gappto\@mgls@post@hookdefs{\let\mglsiflastelementwasfirstuse\@firstoftwo}%
- }%
- {%
- \gappto\@mgls@post@hookdefs{\let\mglsiflastelementwasfirstuse\@secondoftwo}%
- }%
- \glsifplural
- {%
- \gappto\@mgls@post@hookdefs{\let\mglsiflastelementwasplural\@firstoftwo}%
- }%
- {%
- \gappto\@mgls@post@hookdefs{\let\mglsiflastelementwasplural\@secondoftwo}%
- }%
- \glscapscase
- {%
- \gappto\@mgls@post@hookdefs{%
- \let\mglsiflastelementcapscase\@firstofthree
- }%
- }%
- {%
- \gappto\@mgls@post@hookdefs{%
- \let\mglsiflastelementcapscase\@secondofthree
- }%
- }%
- {%
- \gappto\@mgls@post@hookdefs{%
- \let\mglsiflastelementcapscase\@thirdofthree
- }%
- }%
- }%
-% \end{macrocode}
-% Suffix needs post-link hook commands.
-% \begin{macrocode}
- \@mgls@post@hookdefs
- \mglssuffix
-% \end{macrocode}
-%Unset multi-entry first use flag after current scope.
-% \begin{macrocode}
- \ifcase\@mgls@unsetaction\relax
- \xappto\@mgls@post@hookdefs{%
- \noexpand\mglsunset{\expandonce\mglscurrentmultilabel}}%
- \or
- \xappto\@mgls@post@hookdefs{%
- \noexpand\mglslocalunset{\expandonce\mglscurrentmultilabel}}%
- \fi
- }%
- \glsxtrmglswrite{#2}%
- \egroup
- \@mgls@post@hookdefs
- \mgls@do@postlinkhook
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglscustompostlinkhook}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\mglscustompostlinkhook}{}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglslastelementpostlinkhook}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\mglslastelementpostlinkhook}{%
- \let\glsxtrifwasfirstuse\mglsiflastelementwasfirstuse
- \let\glsifplural\mglsiflastelementwasplural
- \let\glscapscase\mglsiflastelementcapscase
- \let\glslabel\mglslastelementlabel
- \glspostlinkhook
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglslastmainpostlinkhook}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\mglslastmainpostlinkhook}{%
- \let\glsxtrifwasfirstuse\mglsiflastmainwasfirstuse
- \let\glsifplural\mglsiflastmainwasplural
- \let\glscapscase\mglsiflastmaincapscase
- \let\glslabel\mglslastmainlabel
- \glspostlinkhook
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsdefcategoryprefix}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\mglsdefcategoryprefix}[2]{%
- \csdef{mglsprefix@#1}{#2}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglshascategoryprefix}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\mglshascategoryprefix}[3]{%
- \ifcsdef{mglsprefix@#1}{#2}{#3}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsusecategoryprefix}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\mglsusecategoryprefix}[1]{%
- \csuse{mglsprefix@#1}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsprefix}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\mglsprefix}{%
- \ifdefempty\mglscurrentcategory
- {\mglscurrentprefix}%
- {%
- \mglshascategoryprefix{\mglscurrentcategory}%
- {\mglsusecategoryprefix{\mglscurrentcategory}}%
- {\mglscurrentprefix}%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsdefcategorysuffix}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\mglsdefcategorysuffix}[2]{%
- \csdef{mglssuffix@#1}{#2}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglshascategorysuffix}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\mglshascategorysuffix}[3]{%
- \ifcsdef{mglssuffix@#1}{#2}{#3}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsusecategorysuffix}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\mglsusecategorysuffix}[1]{%
- \csuse{mglssuffix@#1}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglssuffix}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\mglssuffix}{%
- \ifdefempty\mglscurrentcategory
- {\ifdefempty{\mglscurrentsuffix}{}{\space(\mglscurrentsuffix)}}%
- {%
- \mglshascategorysuffix{\mglscurrentcategory}%
- {\mglsusecategorysuffix{\mglscurrentcategory}}%
- {\ifdefempty{\mglscurrentsuffix}{}{\space(\mglscurrentsuffix)}}%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglselementprehook}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\mglselementprehook}{}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglselementposthook}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\mglselementposthook}{}
-% \end{macrocode}
-%\end{macro}
-%
-%Separators.
-%\begin{macro}{\glscombinedsep}
-%\changes{1.48}{2021-11-22}{new}
-%Separator between two elements that have been marked as used.
-%This takes the two element labels as arguments.
-% \begin{macrocode}
-\newcommand*{\glscombinedsep}[2]{%
- \glshasattribute{#1}{combinedsep}%
- {\glsgetattribute{#1}{combinedsep}}%
- { }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glscombinedfirstsepfirst}
-%\changes{1.48}{2021-11-22}{new}
-%Separator following and preceding a first use.
-% \begin{macrocode}
-\newcommand*{\glscombinedfirstsepfirst}[2]{%
- \glshasattribute{#1}{combinedfirstsepfirst}%
- {\glsgetattribute{#1}{combinedfirstsepfirst}}%
- {\glscombinedsep{#1}{#2}}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glscombinedfirstsep}
-%\changes{1.48}{2021-11-22}{new}
-%Separator following a first use.
-% \begin{macrocode}
-\newcommand*{\glscombinedfirstsep}[2]{%
- \glshasattribute{#1}{combinedfirstsep}%
- {\glsgetattribute{#1}{combinedfirstsep}}%
- {\glscombinedsep{#1}{#2}}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glscombinedsepfirst}
-%\changes{1.48}{2021-11-22}{new}
-%Separator preceding a first use.
-% \begin{macrocode}
-\newcommand*{\glscombinedsepfirst}[2]{%
- \glshasattribute{#1}{combinedsepfirst}%
- {\glsgetattribute{#1}{combinedsepfirst}}%
- {\glscombinedsep{#1}{#2}}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glssetcombinedsepabbrvnbsp}
-%\changes{1.48}{2021-11-22}{new}
-%Provide shortcut for using non-breakable space following an
-%abbreviation that has already been used.
-% \begin{macrocode}
-\newcommand*{\glssetcombinedsepabbrvnbsp}{%
- \renewcommand*{\glscombinedsep}[2]{%
- \glshasattribute{##1}{combinedsep}%
- {\glsgetattribute{##1}{combinedsep}}%
- {\ifhasshort{##1}{~}{ }}%
- }%
- \renewcommand*{\glscombinedsepfirst}[2]{%
- \glshasattribute{##1}{combinedsepfirst}%
- {\glsgetattribute{##1}{combinedsepfirst}}%
- {\ifhasshort{##1}{~}{ }}%
- }%
- \renewcommand*{\glscombinedfirstsep}[2]{%
- \glshasattribute{##1}{combinedfirstsep}%
- {\glsgetattribute{##1}{combinedfirstsep}}%
- { }%
- }%
- \renewcommand*{\glscombinedfirstsepfirst}[2]{%
- \glshasattribute{##1}{combinedfirstsepfirst}%
- {\glsgetattribute{##1}{combinedfirstsepfirst}}%
- { }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glssetcombinedsepabbrvnone}
-%\changes{1.48}{2021-11-22}{new}
-%Provide shortcut for using nothing if either on next use are
-%abbreviations (otherwise use space).
-% \begin{macrocode}
-\newcommand*{\glssetcombinedsepabbrvnone}{%
- \renewcommand*{\glscombinedsep}[2]{%
- \glshasattribute{##1}{combinedsep}%
- {\glsgetattribute{##1}{combinedsep}}%
- {\ifhasshort{##1}{}{\ifhasshort{##2}{}{ }}}%
- }%
- \renewcommand*{\glscombinedsepfirst}[2]{%
- \glshasattribute{##1}{combinedsepfirst}%
- {\glsgetattribute{##1}{combinedsepfirst}}%
- {\ifhasshort{##1}{}{ }}%
- }%
- \renewcommand*{\glscombinedfirstsep}[2]{%
- \glshasattribute{##1}{combinedfirstsep}%
- {\glsgetattribute{##1}{combinedfirstsep}}%
- {\ifhasshort{##2}{}{ }}%
- }%
- \renewcommand*{\glscombinedfirstsepfirst}[2]{%
- \glshasattribute{##1}{combinedfirstsepfirst}%
- {\glsgetattribute{##1}{combinedfirstsepfirst}}%
- { }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glssetcombinedsepnarrow}
-%\changes{1.48}{2021-11-22}{new}
-%Measures both.
-% \begin{macrocode}
-\newcommand*{\glssetcombinedsepnarrow}[2]{%
- \renewcommand*{\glscombinedsep}[2]{%
- \glshasattribute{##1}{combinedsep}%
- {\glsgetattribute{##1}{combinedsep}}%
- {%
- \ifhasshort{##1}%
- {\settowidth{\dimen@}{\glsentryshort{##1}}}%
- {\settowidth{\dimen@}{\glsentrytext{##1}}}%
- \ifdim\dimen@<#1\relax
- #2%
- \else
- \ifhasshort{##2}%
- {\settowidth{\dimen@}{\glsentryshort{##2}}}%
- {\settowidth{\dimen@}{\glsentrytext{##2}}}%
- \ifdim\dimen@<#1\relax
- #2%
- \else
- \space
- \fi
- \fi
- }%
- }%
- \renewcommand*{\glscombinedsepfirst}[2]{%
- \glshasattribute{##1}{combinedsepfirst}%
- {\glsgetattribute{##1}{combinedsepfirst}}%
- {%
- \ifhasshort{##1}%
- {\settowidth{\dimen@}{\glsentryshort{##1}}}%
- {\settowidth{\dimen@}{\glsentrytext{##1}}}%
- \ifdim\dimen@<#1\relax
- #2%
- \else
- \ifhaslong{##2}%
- {\settowidth{\dimen@}{\glsentrylong{##2}}}%
- {\settowidth{\dimen@}{\glsentryfirst{##2}}}%
- \ifdim\dimen@<#1\relax
- #2%
- \else
- \space
- \fi
- \fi
- }%
- }%
- \renewcommand*{\glscombinedfirstsep}[2]{%
- \glshasattribute{##1}{combinedfirstsep}%
- {\glsgetattribute{##1}{combinedfirstsep}}%
- {%
- \ifhaslong{##1}%
- {\settowidth{\dimen@}{\glsentrylong{##1}}}%
- {\settowidth{\dimen@}{\glsentryfirst{##1}}}%
- \ifdim\dimen@<#1\relax
- #2%
- \else
- \ifhasshort{##2}%
- {\settowidth{\dimen@}{\glsentryshort{##2}}}%
- {\settowidth{\dimen@}{\glsentrytext{##2}}}%
- \ifdim\dimen@<#1\relax
- #2%
- \else
- \space
- \fi
- \fi
- }%
- }%
- \renewcommand*{\glscombinedfirstsepfirst}[2]{%
- \glshasattribute{##1}{combinedfirstsepfirst}%
- {\glsgetattribute{##1}{combinedfirstsepfirst}}%
- {%
- \ifhaslong{##1}%
- {\settowidth{\dimen@}{\glsentrylong{##1}}}%
- {\settowidth{\dimen@}{\glsentryfirst{##1}}}%
- \ifdim\dimen@<#1\relax
- #2%
- \else
- \ifhaslong{##2}%
- {\settowidth{\dimen@}{\glsentrylong{##2}}}%
- {\settowidth{\dimen@}{\glsentryfirst{##2}}}%
- \ifdim\dimen@<#1\relax
- #2%
- \else
- \space
- \fi
- \fi
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@glsxtr@mglswrite}
-%\changes{1.48}{2021-11-22}{new}
-%Write information to the aux file for \app{bib2gls} to pick up, but
-%only need to do it once per label since it only indicates which multi-entry
-%has been referenced without any additional information.
-% \begin{macrocode}
-\newcommand{\glsxtrmglswrite}[1]{%
- \ifx\@glsxtr@record@setting\@glsxtr@record@setting@off
- \else
- \protected@edef\@glsxtr@mglslabel{#1}%
- \ifdef\@glsxtr@mglsreflist
- {%
- \expandafter\DTLifinlist\expandafter{\@glsxtr@mglslabel}%
- {\@glsxtr@mglsreflist}{}%
- {%
- \xappto\@glsxtr@mglsreflist{,\expandonce\@glsxtr@mglslabel}%
- \if@mgls@writeseparaterefs
- \protected@write\@auxout{}{\string\@glsxtr@mglsrefs{#1}}%
- \fi
- }%
- }%
- {%
- \global\let\@glsxtr@mglsreflist\@glsxtr@mglslabel
- \if@mgls@writeseparaterefs
- \protected@write\@auxout{}{\string\@glsxtr@mglsrefs{#1}}%
- \else
- \AtEndDocument{\immediate\protected@write\@auxout{}%
- {\string\@glsxtr@mglsrefs{\@glsxtr@mglsreflist}}}%
- \fi
- \@mgls@disable@writeseparateref@cond
- }%
- \fi
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@glsxtr@mglsrefs}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand{\@glsxtr@mglsrefs}[1]{}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\if@mgls@writeseparaterefs}
-%\changes{1.48}{2021-11-22}{new}
-%If this conditional is changed, it must be done before the first
-%instance of any \cs{mgls}-like command.
-% \begin{macrocode}
-\newif\if@mgls@writeseparaterefs \@mgls@writeseparaterefsfalse
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsWriteSeparateRefsTrue}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand{\mglsWriteSeparateRefsTrue}{\global\@mgls@writeseparaterefstrue}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsWriteSeparateRefsFalse}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand{\mglsWriteSeparateRefsFalse}{\global\@mgls@writeseparaterefsfalse}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@mgls@disable@writeseparateref@cond}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@mgls@disable@writeseparateref@cond}{%
- \gdef\mglsWriteSeparateRefsTrue{\PackageError{glossaries-extra}%
- {Too late to use \string\mglsWriteSeparateRefsTrue}%
- {\string\mglsWriteSeparateRefsTrue\space can only be used before
- the first instance of any \string\mgls-like command}}%
- \gdef\mglsWriteSeparateRefsFalse{\PackageError{glossaries-extra}%
- {Too late to use \string\mglsWriteSeparateRefsFalse}%
- {\string\mglsWriteSeparateRefsFalse\space can only be used before
- the first instance of any \string\mgls-like command}}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\glsxtr@newmgls}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand{\glsxtr@newmgls}[5]{%
- \edef\@glsxr@newmgls@do{%
- \noexpand\newrobustcmd*{\expandonce{\csname #1\endcsname}}%
- {\noexpand\@gls@hyp@opt\expandonce{\csname ns@glsxtr@#1\endcsname}}%
- \noexpand\newcommand*{\expandonce{\csname ns@glsxtr@#1\endcsname}}[2][]{%
- \noexpand\new@ifnextchar[%
- {\expandonce{\csname glsxtr@#1\endcsname}{####1}{####2}}%
- {\expandonce{\csname glsxtr@#1\endcsname}{####1}{####2}[]}%
- }%
- \noexpand\def\expandonce{\csname glsxtr@#1\endcsname}####1####2[####3]{%
- \noexpand\def\noexpand\glsxtrcurrentmglscsname{#1}%
- \noexpand\glsxtr@mgls@inner{####1}{####2}{####3}%
- {\noexpand#2}{\noexpand#3}{\noexpand#4}{\noexpand#5}%
- }%
- }%
- \@glsxr@newmgls@do
- \ifx\@glsxtr@record@setting\@glsxtr@record@setting@off
- \else
-% \end{macrocode}
-% Provide a way for \app{bib2gls} to recognise the command (this will
-% make it easier to add extra commands without having to modify
-% \app{bib2gls}).
-% \begin{macrocode}
- \ifdef\@glsxtr@mglslikelist
- {\xappto\@glsxtr@mglslikelist{,#1}}%
- {%
- \gdef\@glsxtr@mglslikelist{#1}%
- \AtEndDocument{\immediate\protected@write\@auxout{}%
- {\string\@glsxtr@mglslike{\@glsxtr@mglslikelist}}}%
- }%
- \fi
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@glsxtr@mglslike}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@glsxtr@mglslike}[1]{}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\GlsXtrMglsOrGls}
-%\begin{definition}
-%\cs{GlsXtrMglsOrGls}\marg{mgls cs}\marg{gls cs}\meta{modifier}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\GlsXtrMglsOrGls}[2]{%
- \def\@glsxtr@mgls@or@gls@mcs{#1}%
- \def\@glsxtr@mgls@or@gls@gcs{#2}%
- \@ifstar{\s@GlsXtrMglsOrGls}%
- {%
- \@ifnextchar+{\PLUS\@firstoftwo{\p@GlsXtrMglsOrGls}}%
- {%
- \ifdefempty\@gls@alt@hyp@opt@char\@GlsXtrMglsOrGls\alt@GlsXtrMglsOrGls
- }%
- }%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\alt@GlsXtrMglsOrGls}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\alt@GlsXtrMglsOrGls}{
- \expandafter\@ifnextchar\@gls@alt@hyp@opt@char
- {\@firstoftwo{\@alt@GlsXtrMglsOrGls}}{\@GlsXtrMglsOrGls}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@GlsXtrMglsOrGls}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@GlsXtrMglsOrGls}[2][]{%
- \glsxtrifmulti{#2}%
- {\@glsxtr@mgls@or@gls@mcs[#1]{#2}}%
- {\@glsxtr@mgls@or@gls@gcs[#1]{#2}}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\s@GlsXtrMglsOrGls}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\s@GlsXtrMglsOrGls}[2][]{%
- \glsxtrifmulti{#2}%
- {\@glsxtr@mgls@or@gls@mcs*[#1]{#2}}%
- {\@glsxtr@mgls@or@gls@gcs*[#1]{#2}}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\p@GlsXtrMglsOrGls}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\p@GlsXtrMglsOrGls}[2][]{%
- \glsxtrifmulti{#2}%
- {\@glsxtr@mgls@or@gls@mcs+[#1]{#2}}%
- {\@glsxtr@mgls@or@gls@gcs+[#1]{#2}}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@alt@GlsXtrMglsOrGls}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\@alt@GlsXtrMglsOrGls}[2][]{%
- \glsxtrifmulti{#2}%
- {\expandafter\@glsxtr@mgls@or@gls@mcs\@gls@alt@hyp@opt@char[#1]{#2}}%
- {\expandafter\@glsxtr@mgls@or@gls@gcs\@gls@alt@hyp@opt@char[#1]{#2}}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mgls}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{mgls}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% Use \cs{gls} for all elements.
-% \begin{macrocode}
-\glsxtr@newmgls{mgls}{\@gls@}{\@gls@}{\@gls@}{\@gls@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglspl}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{mglspl}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% Use \cs{glspl} for all elements.
-% \begin{macrocode}
-\glsxtr@newmgls{mglspl}{\@glspl@}{\@glspl@}{\@glspl@}{\@glspl@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsmainpl}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{mglsmainpl}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% Only use \cs{glspl} for the main element, otherwise use \cs{gls}.
-% \begin{macrocode}
-\glsxtr@newmgls{mglsmainpl}{\@gls@}{\@gls@}{\@glspl@}{\@glspl@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Mgls}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{Mgls}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-%Use \cs{Gls} for first element and \cs{gls} for others.
-% \begin{macrocode}
-\glsxtr@newmgls{Mgls}{\@Gls@}{\@gls@}{\@Gls@}{\@gls@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Mglspl}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{Mglspl}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-%Use \cs{Glspl} for first element and \cs{glspl} for others.
-% \begin{macrocode}
-\glsxtr@newmgls{Mglspl}{\@Glspl@}{\@glspl@}{\@Glspl@}{\@glspl@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Mglsmainpl}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{Mglsmainpl}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-%Upper case the first element, no case change for others.
-%Use plural for the main element only.
-% \begin{macrocode}
-\glsxtr@newmgls{Mglsmainpl}{\@Gls@}{\@gls@}{\@Glspl@}{\@glspl@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\MGls}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{MGls}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-%Use \cs{Gls} for all elements.
-% \begin{macrocode}
-\glsxtr@newmgls{MGls}{\@Gls@}{\@Gls@}{\@Gls@}{\@Gls@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\MGlspl}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{MGlspl}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-%Use \cs{Glspl} for all elements.
-% \begin{macrocode}
-\glsxtr@newmgls{MGlspl}{\@Glspl@}{\@Glspl@}{\@Glspl@}{\@Glspl@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\MGlsmainpl}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{MGlsmainpl}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-%Start all elements with upper case. Only use plural for main
-%element.
-% \begin{macrocode}
-\glsxtr@newmgls{MGlsmainpl}{\@Gls@}{\@Gls@}{\@Glspl@}{\@Glspl@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\MGLS}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{MGLS}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-%Use \cs{GLS} for all elements.
-% \begin{macrocode}
-\glsxtr@newmgls{MGLS}{\@GLS@}{\@GLS@}{\@GLS@}{\@GLS@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\MGLSpl}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{MGLSpl}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-%Use \cs{GLSpl} for all elements.
-% \begin{macrocode}
-\glsxtr@newmgls{MGLSpl}{\@GLSpl@}{\@GLSpl@}{\@GLSpl@}{\@GLSpl@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\MGLSmainpl}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{MGLSmainpl}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-%Upper case all elements. Only use plural for main element.
-% \begin{macrocode}
-\glsxtr@newmgls{MGLSmainpl}{\@GLS@}{\@GLS@}{\@GLSpl@}{\@GLSpl@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@glslongortext@}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\def\@glslongortext#1#2[#3]{%
- \ifglshaslong{#2}{\@glsxtrlong{#1}{#2}[#3]}{\@glstext@{#1}{#2}[#3]}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@glsshortortext@}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\def\@glsshortortext#1#2[#3]{%
- \ifglshasshort{#2}{\@glsxtrshort{#1}{#2}[#3]}{\@glstext@{#1}{#2}[#3]}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@glsfullorfirst@}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\def\@glsfullorfirst#1#2[#3]{%
- \ifglshasshort{#2}{\@glsxtr@full{#1}{#2}[#3]}{\@glsfirst@{#1}{#2}[#3]}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@Glslongortext@}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\def\@Glslongortext#1#2[#3]{%
- \ifglshaslong{#2}{\@Glsxtrlong{#1}{#2}[#3]}{\@Glstext@{#1}{#2}[#3]}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@Glsshortortext@}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\def\@Glsshortortext#1#2[#3]{%
- \ifglshasshort{#2}{\@Glsxtrshort{#1}{#2}[#3]}{\@Glstext@{#1}{#2}[#3]}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@Glsfullorfirst@}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\def\@Glsfullorfirst#1#2[#3]{%
- \ifglshasshort{#2}{\@Glsxtr@full{#1}{#2}[#3]}{\@Glsfirst@{#1}{#2}[#3]}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsshort}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{mglsshort}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% Use short or text for all elements.
-% \begin{macrocode}
-\glsxtr@newmgls{mglsshort}%
-{\@glsshortortext}{\@glsshortortext}{\@glsshortortext}{\@glsshortortext}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglslong}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{mglslong}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% Use long or text for all elements.
-% \begin{macrocode}
-\glsxtr@newmgls{mglslong}%
-{\@glslongortext}{\@glslongortext}{\@glslongortext}{\@glslongortext}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsfull}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{mglsfull}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% Use full or first for all elements.
-% \begin{macrocode}
-\glsxtr@newmgls{mglsfull}%
-{\@glsfullorfirst}{\@glsfullorfirst}{\@glsfullorfirst}{\@glsfullorfirst}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Mglsshort}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{Mglsshort}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% Use short or text for all elements with initial cap on first element.
-% \begin{macrocode}
-\glsxtr@newmgls{Mglsshort}%
-{\@Glsshortortext}{\@glsshortortext}{\@Glsshortortext}{\@glsshortortext}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Mglslong}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{Mglslong}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% Use long or text for all elements with initial cap on first
-% element.
-% \begin{macrocode}
-\glsxtr@newmgls{Mglslong}%
-{\@Glslongortext}{\@glslongortext}{\@Glslongortext}{\@glslongortext}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Mglsfull}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{Mglsfull}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% Use full or first for all elements with initial cap on first
-% element.
-% \begin{macrocode}
-\glsxtr@newmgls{Mglsfull}%
-{\@Glsfullorfirst}{\@glsfullorfirst}{\@Glsfullorfirst}{\@glsfullorfirst}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsname}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{mglsname}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% Use name for all elements.
-% \begin{macrocode}
-\glsxtr@newmgls{mglsname}%
- {\@glsname@}{\@glsname@}{\@glsname@}{\@glsname@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Mglsname}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{Mglsname}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% Use name for all elements with initial cap on first
-% element.
-% \begin{macrocode}
-\glsxtr@newmgls{Mglsname}%
- {\@Glsname@}{\@glsname@}{\@Glsname@}{\@glsname@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\MGlsname}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{MGlsname}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% Use name for all elements with initial cap on all
-% elements.
-% \begin{macrocode}
-\glsxtr@newmgls{MGlsname}%
- {\@Glsname@}{\@Glsname@}{\@Glsname@}{\@Glsname@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@glssymbolorgls}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\def\@glssymbolorgls#1#2[#3]{%
- \ifglshassymbol{#2}{\@glssymbol@{#1}{#2}[#3]}{\@gls@{#1}{#2}[#3]}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@glssymbolorGls}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\def\@glssymbolorGls#1#2[#3]{%
- \ifglshassymbol{#2}{\@glssymbol@{#1}{#2}[#3]}{\@Gls@{#1}{#2}[#3]}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglssymbol}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{mglssymbol}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% Use \cs{glssymbol} if the \gloskey{symbol} key is set otherwise
-% use \cs{gls}.
-% \begin{macrocode}
-\glsxtr@newmgls{mglssymbol}%
- {\@glssymbolorgls}{\@glssymbolorgls}{\@glssymbolorgls}{\@glssymbolorgls}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Mglssymbol}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{Mglssymbol}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% As above but initial the first element if it's not a symbol.
-% \begin{macrocode}
-\glsxtr@newmgls{Mglssymbol}%
- {\@glssymbolorGls}{\@glssymbolorgls}{\@glssymbolorGls}{\@glssymbolorgls}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\MGlssymbol}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{MGlssymbol}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% As above but initial each element if it's not a symbol.
-% \begin{macrocode}
-\glsxtr@newmgls{MGlssymbol}%
- {\@glssymbolorGls}{\@glssymbolorGls}{\@glssymbolorGls}{\@glssymbolorGls}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsfield}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand{\mglsfield}{useri}
-% \end{macrocode}
-%\end{macro}
-%\begin{macro}{\@glsfieldorgls}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\def\@glsfieldorgls#1#2[#3]{%
- \glsxtrifhasfield{\mglsfield}{#2}%
- {\@glsdisp[#1]{#2}{\glscurrentfieldvalue#3}}%
- {\@gls@{#1}{#2}[#3]}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@Glsfieldorgls}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\def\@Glsfieldorgls#1#2[#3]{%
- \glsxtrifhasfield{\mglsfield}{#2}%
- {\@glsdisp[#1]{#2}{\xmakefirstuc\glscurrentfieldvalue#3}}%
- {\@Gls@{#1}{#2}[#3]}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mglsusefield}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{mglsusefield}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% Use the field given by \cs{\mglsfield}.
-% \begin{macrocode}
-\glsxtr@newmgls{mglsusefield}%
- {\@glsfieldorgls}{\@glsfieldorgls}{\@glsfieldorgls}{\@glsfieldorgls}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Mglsusefield}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{Mglsusefield}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% As above but use initial cap for first element only.
-% \begin{macrocode}
-\glsxtr@newmgls{Mglsusefield}%
- {\@Glsfieldorgls}{\@glsfieldorgls}{\@Glsfieldorgls}{\@glsfieldorgls}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\MGlsusefield}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{MGlsusefield}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% As above but use initial cap for all elements.
-% \begin{macrocode}
-\glsxtr@newmgls{MGlsusefield}%
- {\@Glsfieldorgls}{\@Glsfieldorgls}{\@Glsfieldorgls}{\@Glsfieldorgls}%
-% \end{macrocode}
-%\end{macro}
-%
-% Use commands provided by \sty{glossaries-prefix} if it has been
-% loaded.
-%\begin{macro}{\mpglsWarning}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\newcommand*{\mpglsWarning}{%
- \GlossariesExtraWarning{glossaries-prefix.sty is required for
- \string\mpgls\space family of commands (either load after
- glossaries-extra.sty or use the `prefix' package option)}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@pglsorgls}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\def\@pglsorgls#1#2[#3]{%
- \ifdef\@pgls@{\@pgls@{#1}{#2}[#3]}{\mpglsWarning\@gls@{#1}{#2}[#3]}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@pglsorglspl}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\def\@pglsorglspl#1#2[#3]{%
- \ifdef\@pglspl@{\@pglspl@{#1}{#2}[#3]}{\mpglsWarning\@glspl@{#1}{#2}[#3]}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@Pglsorgls}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\def\@Pglsorgls#1#2[#3]{%
- \ifdef\@Pgls@{\@Pgls@{#1}{#2}[#3]}{\mpglsWarning\@Gls@{#1}{#2}[#3]}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@pglsorglspl}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\def\@pglsorglspl#1#2[#3]{%
- \ifdef\@pglspl@{\@pglspl@{#1}{#2}[#3]}{\mpglsWarning\@glspl@{#1}{#2}[#3]}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@Pglsorglspl}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\def\@Pglsorglspl#1#2[#3]{%
- \ifdef\@Pglspl@{\@Pglspl@{#1}{#2}[#3]}{\mpglsWarning\@Glspl@{#1}{#2}[#3]}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@PGLSorgls}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\def\@PGLSorgls#1#2[#3]{%
- \ifdef\@PGLS@{\@PGLS@{#1}{#2}[#3]}{\mpglsWarning\@GLS@{#1}{#2}[#3]}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\@PGLSorglspl}
-%\changes{1.48}{2021-11-22}{new}
-% \begin{macrocode}
-\def\@PGLSorglspl#1#2[#3]{%
- \ifdef\@PGLSpl@{\@PGLSpl@{#1}{#2}[#3]}{\mpglsWarning\@GLSpl@{#1}{#2}[#3]}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mpgls}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{mpgls}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% Use \cs{pgls} for the first element and \cs{gls} for the remainder.
-% \begin{macrocode}
-\glsxtr@newmgls{mpgls}{\@pglsorgls@}{\@gls@}{\@pglsorgls@}{\@gls@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mpglspl}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{mpglspl}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% Use \cs{pglspl} for the first element and \cs{glspl} for the remainder.
-% \begin{macrocode}
-\glsxtr@newmgls{mpglspl}{\@pglsorglspl@}{\@glspl@}{\@pglsorglspl@}{\@glspl@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\mpglsmainpl}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{mpglsmainpl}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-%Only use plural for main element and only use prefixing command for
-%first element.
-% \begin{macrocode}
-\glsxtr@newmgls{mpglsmainpl}{\@pglsorgls@}{\@gls@}{\@pglsorglspl@}{\@glspl@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Mpgls}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{Mpgls}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% Use \cs{Pgls} for the first element and \cs{gls} for the remainder.
-% \begin{macrocode}
-\glsxtr@newmgls{Mpgls}{\@Pglsorgls@}{\@gls@}{\@Pglsorgls@}{\@gls@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Mpglspl}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{Mpglspl}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% Use \cs{Pglspl} for the first element and \cs{glspl} for the remainder.
-% \begin{macrocode}
-\glsxtr@newmgls{Mpglspl}{\@Pglsorglspl@}{\@glspl@}{\@Pglsorglspl@}{\@glspl@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\Mpglsmainpl}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{Mpglsmainpl}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-%Only use plural for main element and only use first letter
-%uppercase prefixing command for first element.
-% \begin{macrocode}
-\glsxtr@newmgls{Mpglsmainpl}{\@Pglsorgls@}{\@gls@}{\@Pglsorglspl@}{\@glspl@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\MPGls}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{MPGls}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-%Use \cs{Pgls} for the first element and \cs{Gls} for the remainder.
-% \begin{macrocode}
-\glsxtr@newmgls{MPGls}{\@Pglsorgls@}{\@Gls@}{\@Pglsorgls@}{\@Gls@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\MPGlspl}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{MPGlspl}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% Use \cs{Pglspl} for the first element and \cs{Glspl} for the remainder.
-% \begin{macrocode}
-\glsxtr@newmgls{MPGlspl}{\@Pglsorglspl@}{\@Glspl@}{\@Pglsorglspl@}{\@Glspl@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\MPGlsmainpl}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{MPGlsmainpl}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-%Only use plural for main element and first letter uppercase all
-%elements.
-% \begin{macrocode}
-\glsxtr@newmgls{MPGlsmainpl}{\@Pglsorgls@}{\@Gls@}{\@Pglsorglspl@}{\@Glspl@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\MPGLS}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{MPGLS}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% Use \cs{PGLS} for the first element and \cs{GLS} for the remainder.
-% \begin{macrocode}
-\glsxtr@newmgls{MPGLS}{\@PGLSorgls@}{\@GLS@}{\@PGLSorgls@}{\@GLS@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\MPGLSpl}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{MPGLSpl}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-% Use \cs{PGLSpl} for the first element and \cs{GLSpl} for the remainder.
-% \begin{macrocode}
-\glsxtr@newmgls{MPGLSpl}{\@PGLSorglspl@}{\@GLSpl@}{\@PGLSorglspl@}{\@GLSpl@}%
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\MPGLSmainpl}
-%\changes{1.48}{2021-11-22}{new}
-%\begin{definition}
-%\cs{MPGLSmainpl}\oarg{options}\marg{label}\oarg{insert}
-%\end{definition}
-%Only use plural for main element and uppercase all elements.
-% \begin{macrocode}
-\glsxtr@newmgls{MPGLSmainpl}{\@PGLSorgls@}{\@GLS@}{\@PGLSorglspl@}{\@GLSpl@}%
-% \end{macrocode}
-%\end{macro}
-%
-%Not currently implementing any other variations.
-%
-%\section{Multi-Lingual Support}
-% Add the facility to load language modules, if they are installed,
-% but none are provided with this package.
-%
-%\begin{macro}{\RequireGlossariesExtraLang}
-%\changes{0.5.3}{2015-12-09}{new}
-% \begin{macrocode}
-\newcommand*{\RequireGlossariesExtraLang}[1]{%
- \@ifundefined{ver@glossariesxtr-#1.ldf}{\input{glossariesxtr-#1.ldf}}{}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-%\begin{macro}{\ProvidesGlossariesExtraLang}
-%\changes{0.5.3}{2015-12-09}{new}
-% \begin{macrocode}
-\newcommand*{\ProvidesGlossariesExtraLang}[1]{%
- \ProvidesFile{glossariesxtr-#1.ldf}%
-}
-% \end{macrocode}
-%\end{macro}
-%
-% Load any required language modules that are available. This
-% doesn't generate any warning if none are found, since they're not
-% essential. (The only command that really needs defining for the
-% document is \ics{abbreviationsname}, which can simply be
-% redefined. However, with \app{bib2gls} it might be useful to
-% provide custom rules for a particular locale.)
-%
-%\begin{macro}{\glsxtr@loaddialect}
-%The dialect label should be stored in \cs{this@dialect}
-%before using this command.
-%\changes{1.27}{2018-02-26}{new}
-% \begin{macrocode}
-\newcommand{\glsxtr@loaddialect}{%
- \IfTrackedLanguageFileExists{\this@dialect}%
- {glossariesxtr-}% prefix
- {.ldf}%
- {%
- \RequireGlossariesExtraLang{\CurrentTrackedTag}%
- }%
- {}% not found
-% \end{macrocode}
-% If \sty{glossaries-extra-bib2gls} has been loaded,
-% \cs{@glsxtrdialecthook} will check for the associated script,
-% otherwise it will do nothing.
-% \begin{macrocode}
- \@glsxtrdialecthook
-}
-% \end{macrocode}
-%\end{macro}
-% \begin{macrocode}
-\@ifpackageloaded{tracklang} {%
- \AnyTrackedLanguages
- {%
- \ForEachTrackedDialect{\this@dialect}{\glsxtr@loaddialect}%
- }%
- {}%
-} {}
-% \end{macrocode}
-% Load \sty{glossaries-extra-stylemods} if required.
-% \begin{macrocode}
-\@glsxtr@redefstyles
-% \end{macrocode}
-% and set the style:
-% \begin{macrocode}
-\@glsxtr@do@style
-% \end{macrocode}
%\iffalse
% \begin{macrocode}
-%</glossaries-extra.sty>
+%</glossaries-extra-abbrstyles.def>
% \end{macrocode}
%\fi
%\iffalse
@@ -30065,13 +39544,21 @@ defined}{}%
%<*glossaries-extra-bib2gls.sty>
% \end{macrocode}
%\fi
+%\section{Commands Specific to bib2gls (glossaries-extra-bib2gls.sty)}
%\changes{1.27}{2018-02-26}{added glossaries-extra-bib2gls.sty}
-%\section{glossaries-extra-bib2gls.sty}
%This package provides additional support for \app{bib2gls} and is
%automatically loaded by the record option.
% \begin{macrocode}
\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{glossaries-extra-bib2gls}[2021/11/22 v1.48 (NLCT)]
+% \end{macrocode}
+% Rollback releases:
+% \begin{macrocode}
+\DeclareRelease{v1.48}{2021-11-22}{glossaries-extra-bib2gls-2021-11-22.sty}
+\DeclareCurrentRelease{v1.49}{2022-10-14}
+% \end{macrocode}
+% Declare package:
+% \begin{macrocode}
+\ProvidesPackage{glossaries-extra-bib2gls}[2022/10/14 v1.49 (NLCT)]
% \end{macrocode}
%Provide convenient shortcut commands for predefined glossary types.
%\begin{macro}{\printunsrtacronyms}
@@ -30152,6 +39639,16 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\IfTeXParserLib}
+%\changes{1.49}{2022-10-14}{new}
+%This is defined by the \TeX\ parser library to behave like
+%\cs{@firstoftwo}. May be used to provide different code in fields
+%that may be interpreted.
+% \begin{macrocode}
+\providecommand{\IfTeXParserLib}[2]{#2}
+% \end{macrocode}
+%\end{macro}
+%
%These are some convenient macros for use with custom rules.
%\begin{macro}{\glshex}
%\changes{1.21}{2017-11-03}{new}
@@ -30167,6 +39664,16 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glshashchar}
+%\changes{1.49}{2022-10-14}{new}
+% Expands to a literal hash character (similar to \cs{glsbackslash})
+% \begin{macrocode}
+\ifdef\glshashchar
+{}
+{\edef\glshashchar{\expandafter\@gobble\string\#}}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\GlsXtrIfHasNonZeroChildCount}
%\changes{1.31}{2018-05-09}{new}
%\changes{1.47}{2021-11-04}{added starred version}
@@ -30234,7 +39741,13 @@ defined}{}%
%
%\begin{macro}{\glsxtr@wrglossarylocation}
%\changes{1.29}{2018-04-09}{new}
+%\begin{definition}
+%\cs{glsxtr@wrglossarylocation}\marg{wr-loc}\marg{page}
+%\end{definition}
%For use with \pkgopt{indexcounter} and \app{bib2gls}.
+%This just expands to \meta{wr-loc} to allow \cs{glsnoidxdisplayloc}
+%to obtain the hyperlink target. The page number obtained when
+%\app{bib2gls} parses the aux file.
% \begin{macrocode}
\newcommand*{\glsxtr@wrglossarylocation}[2]{#1}
% \end{macrocode}
@@ -30276,6 +39789,7 @@ defined}{}%
%
%\begin{macro}{\GlsXtrDualBackLink}
%\changes{1.30}{2018-04-25}{new}
+%\changes{1.49}{2022-10-14}{corrected false part}
%\begin{definition}
%\cs{GlsXtrDualBackLink}\marg{text}\marg{label}
%\end{definition}
@@ -30284,7 +39798,7 @@ defined}{}%
\newcommand*{\GlsXtrDualBackLink}[2]{%
\glsxtrifhasfield{\GlsXtrDualField}{#2}%
{\glshyperlink[#1]{\glscurrentfieldvalue}}%
- {#2}%
+ {#1}%
}
% \end{macrocode}
%\end{macro}
@@ -30395,26 +39909,34 @@ defined}{}%
{
% \end{macrocode}
% Default action uses \meta{hcounter}. Equations and pages typically don't
-% have a title, so check the counter name (otherwise the title may
-% section or chapter title, which may be confusing). As from v1.42,
+% have a title, so check the counter name (otherwise the title may be the
+% section or chapter title, which can be confusing). As from v1.42,
% this now checks if the control sequence
-% \cs{glsxtr\meta{counter}locfmt} is defined.
+% \cs{glsxtr\meta{counter}locfmt} is defined. The prefix argument is
+% redundant.
% \begin{macrocode}
\newcommand*{\glsxtrdisplaylocnameref}[8]{%
+ \def\glsxtrrecentanchor{#6}%
+ \def\glsxtrlocationanchor{#2.#7}%
+% \end{macrocode}
+% Initialise \cs{glsxtractualanchor}:
+% \begin{macrocode}
+ \let\glsxtractualanchor\glsxtrlocationanchor
+ \glsxtrsetactualanchor{#2}%
\ifcsdef{glsxtr#2locfmt}%
- {\glsxtrnamereflink{#3}{\csuse{glsxtr#2locfmt}{#4}{#5}}{#2.#7}{#8}}%
+ {\glsxtrnamereflink{#3}{\csuse{glsxtr#2locfmt}{#4}{#5}}{\glsxtractualanchor}{#8}}%
{%
\ifstrempty{#5}%
{%
% \end{macrocode}
%No title, so just use the location as the link text.
% \begin{macrocode}
- \glsxtrnamereflink{#3}{#4}{#2.#7}{#8}%
+ \glsxtrnamereflink{#3}{#4}{\glsxtractualanchor}{#8}%
}%
{%
\ifstrequal{#2}{page}%
- {\glsxtrnamereflink{#3}{#4}{#2.#7}{#8}}%
- {\glsxtrnamereflink{#3}{#5}{#2.#7}{#8}}%
+ {\glsxtrnamereflink{#3}{#4}{\glsxtractualanchor}{#8}}%
+ {\glsxtrtitlednamereflink{#3}{#4}{#5}{#8}}%
}%
}%
}
@@ -30422,6 +39944,26 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtractualanchor}
+%\changes{1.49}{2022-10-14}{new}
+%Does nothing by default. May be redefined to override the default.
+% \begin{macrocode}
+\newcommand{\glsxtrsetactualanchor}[1]{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrtitlednamereflink}
+%\begin{definition}
+%\cs{glsxtrtitlednamereflink}\marg{format}\marg{location}\marg{title}\marg{file}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glsxtrtitlednamereflink}[4]{%
+ \glsxtrnamereflink{#1}{#2}{\glsxtrrecentanchor}{#4}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsxtrequationlocfmt}
%\changes{1.42}{2020-02-03}{new}
%\begin{definition}
@@ -30432,6 +39974,20 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtrwrglossarylocfmt}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glsxtrwrglossarylocfmt}\marg{location}\marg{title}
+%\end{definition}
+% \begin{macrocode}
+\newcommand*{\glsxtrwrglossarylocfmt}[2]{%
+ {\@@glsxtrwrglosscountermark{#1}%
+ \let\glsxtr@wrglossarylocation\@secondoftwo
+ #1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsxtrnamereflink}
%\changes{1.37}{2018-11-30}{new}
%\begin{definition}
@@ -30461,7 +40017,7 @@ defined}{}%
%\begin{macro}{\glsxtrnameloclink}
%\changes{1.37}{2018-11-30}{new}
%\begin{definition}
-%\cs{glsxtrnamerefloclink}\marg{prefix}\marg{counter}\marg{format}\marg{location}\marg{text}\marg{external
+%\cs{glsxtrnameloclink}\marg{prefix}\marg{counter}\marg{format}\marg{location}\marg{text}\marg{external
%file}
%\end{definition}
%Like \cs{@gls@numberlink}, this creates a hyperlink to the
@@ -30546,7 +40102,7 @@ defined}{}%
%\begin{definition}
%\cs{glsxtrSetWidest}\marg{type}\marg{level}\marg{text}
%\end{definition}
-%As from \gls{bib2gls} v1.8, this is used by the \texttt{set-widest}
+%As from \app{bib2gls} v1.8, this is used by the \texttt{set-widest}
%resource option for the \glostyle{alttree} and the styles
%provided by the \sty{glossary-longextra} package.
% \begin{macrocode}
@@ -30677,7 +40233,7 @@ defined}{}%
%\begin{definition}
%\cs{glsxtrSetWidestFallback}\marg{max depth}\marg{list}
%\end{definition}
-%Used when \gls{bib2gls} can't determine the widest name.
+%Used when \app{bib2gls} can't determine the widest name.
%The \meta{list} argument is a comma-separated list of glossary
%labels. The \meta{max depth} refers to the maximum hierarchical
%depth. This will either be 0 (only top-level entries) or 2
@@ -30786,10 +40342,10 @@ defined}{}%
%
%\begin{macro}{\@glsxtr@prefixlabellist}
%\changes{1.37}{2018-11-30}{new}
-%This is provided for the benefit of \gls{bib2gls}. It's possible
+%This is provided for the benefit of \app{bib2gls}. It's possible
%that the user may add more prefixes after the start of the
%document, but that can lead to inconsistencies. The final element
-%of the list (the fallback) is the only prefix of interest for \gls{bib2gls}.
+%of the list (the fallback) is the only prefix of interest for \app{bib2gls}.
% \begin{macrocode}
\AtBeginDocument{%
\protected@write\@auxout{}{\string\providecommand{\string\@glsxtr@prefixlabellist}[1]{}}%
@@ -30798,31 +40354,225 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+% Before v1.49, the last label was used as a fallback, but this
+% doesn't make sense when the first matching label is used when
+% entries are defined. The selection should be deferred to
+% \app{bib2gls}, which means passing the list of label choices to
+% \app{bib2gls}.
+%
+%\begin{macro}{\@glsxtr@dglsnomatch}
+%\changes{1.49}{2022-10-14}{new}
+%No match found so record all possibilities. Requires \app{bib2gls} v3.0+.
+%This will add the final insert argument but won't be able to apply
+%any case-changing etc.
+% \begin{macrocode}
+\def\@glsxtr@dglsnomatch#1#2[#3]{%
+ \begingroup
+% \end{macrocode}
+% This is a cut-down version of \cs{@@glsxtr@record}.
+% Use the fallback label in the event any hooks have to reference
+% \cs{glslabel}. This is mainly to prevent an undefined control
+% sequence error. It can't be relied on as the actual label.
+% \begin{macrocode}
+ \let\glslabel\@gls@thislabel
+ \let\@glsnumberformat\@glsxtr@defaultnumberformat
+ \def\@glsxtr@thevalue{}%
+ \def\@glsxtr@theHvalue{\@glsxtr@thevalue}%
+ \let\@glsxtr@org@theHvalue\@glsxtr@theHvalue
+ \let\@gls@counter\glscounter
+ \if@glsxtr@equations
+ \@glsxtr@use@equation@counter
+ \fi
+ \@gls@setdefault@glslink@opts
+ \@glsxtr@glslink@prekeys
+ \setkeys{glslink}{#1}%
+ \glsxtr@do@autoadd{glslink}%
+% \end{macrocode}
+% Can't increment associated counter.
+% \begin{macrocode}
+ \ifKV@glslink@noindex
+ \GlossariesExtraWarning{Can't obtain a match for prefix
+ candidates: \@glsxtr@prefixedlist. Check the label spelling or rerun}%
+ \else
+ \ifdefempty{\@glsxtr@thevalue}%
+ {%
+ \ifx\@glsxtr@org@theHvalue\@glsxtr@theHvalue
+ \else
+ \let\theHglsentrycounter\@glsxtr@theHvalue
+ \fi
+ }%
+ {%
+ \let\theglsentrycounter\@glsxtr@thevalue
+ \let\theHglsentrycounter\@glsxtr@theHvalue
+ }%
+ \glsxtr@saveentrycounter
+ \@@glsxtr@dorecord\@glsxtr@prefixedlist
+ \glsxtr@select@entry\glsxtr@do@select@nameref@record
+% \end{macrocode}
+% Issue warning.
+% \begin{macrocode}
+ \GlossariesExtraWarning{Can't obtain a match for prefix
+ candidates: \@glsxtr@prefixedlist. Check the label spelling, use bib2gls v3.0+ to
+ select entry and rerun LaTeX}%
+ \fi
+ \@glsxtrundeftag#3%
+ \endgroup
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtr@select@entry}
+%\changes{1.49}{2022-10-14}{new}
+%Instruction to \app{bib2gls} to select the first found label in the
+%list.
+% \begin{macrocode}
+\newcommand*{\glsxtr@select@entry}[5]{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtr@select@entry@nameref}
+%\changes{1.49}{2022-10-14}{new}
+%Instruction to \app{bib2gls} to select the first found label in the
+%list as though it has a record.
+% \begin{macrocode}
+\newcommand*{\glsxtr@select@entry@nameref}[8]{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtr@do@select@nameref@record}
+%\changes{1.49}{2022-10-14}{new}
+%Instruction to \app{bib2gls} to select the first found label in the
+%list as though it has a record.
+% \begin{macrocode}
+\newcommand*{\glsxtr@do@select@nameref@record}[5]{%
+ \gls@ifnotmeasuring
+ {%
+ \protected@write\@auxout{}{\string\glsxtr@select@entry@nameref
+ {#1}{#2}{#3}{#4}{#5}%
+ {\csuse{@currentlabelname}}{\csuse{@currentHref}}%
+ {\theHglsentrycounter}}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\ifGlsXtrPrefixLabelFallbackLast}
+%\changes{1.49}{2022-10-14}{new}
+% Determine whether the first or last label should be used as the
+% fallback in the event that there's no match on any prefixes.
+% \begin{macrocode}
+\newif\ifGlsXtrPrefixLabelFallbackLast
+\GlsXtrPrefixLabelFallbackLasttrue
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\@glsxtr@get@prefixedlabel}
%\changes{1.37}{2018-11-30}{new}
%Iterate through all the prefixes and find the first
%prefix and label combination that exists. If none found, this could
-%mean that it's the first \LaTeX\ run, so the last prefix in the
-%list needs to be the fallback one. Grouping is used in case
-%of a nested for loop.
+%mean that it's the first \LaTeX\ run.
% \begin{macrocode}
\newcommand*{\@glsxtr@get@prefixedlabel}[1]{%
+% \end{macrocode}
+% Grouping is used in case of a nested for loop.
+% \begin{macrocode}
\begingroup
% \end{macrocode}
+%\changes{1.46}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}}
%Initialise to the unprefixed label in the event that the list is
%empty.
-%\changes{1.46}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}}
% \begin{macrocode}
\protected@edef\@gls@thislabel{#1}%
+% \end{macrocode}
+%Save the first label.
+% \begin{macrocode}
+ \let\@glsxtr@prefixedfirstlabel\@gls@thislabel
+ \def\@glsxtr@set@prefixedfirstlabel{%
+ \let\@glsxtr@prefixedfirstlabel\@gls@thislabel
+ \let\@glsxtr@set@prefixedfirstlabel\relax
+ }%
+% \end{macrocode}
+%List of labels in the event that no combination is found.
+% \begin{macrocode}
+ \let\@glsxtr@prefixedlist\@empty
+% \end{macrocode}
+% Iterate over all labels.
+% \begin{macrocode}
+ \count@=0\relax
\@for\@glsxtr@prefix:=\@glsxtr@labelprefixes\do
{%
+ \advance\count@ by 1\relax
\protected@edef\@gls@thislabel{\@glsxtr@prefix#1}%
- \ifglsentryexists{\@gls@thislabel}{\@endfortrue}{}%
+ \@glsxtr@set@prefixedfirstlabel
+% \end{macrocode}
+% Check if this label exists.
+% \begin{macrocode}
+ \ifglsentryexists{\@gls@thislabel}%
+ {%
+ \@endfortrue
+% \end{macrocode}
+% Found a label that exists. Clear the list.
+% \begin{macrocode}
+ \let\@glsxtr@prefixedlist\@empty
+ }%
+ {%
+% \end{macrocode}
+% Append or prepend to list.
+% \begin{macrocode}
+ \ifdefempty\@glsxtr@prefixedlist
+ {\let\@glsxtr@prefixedlist\@gls@thislabel}%
+ {%
+ \ifGlsXtrPrefixLabelFallbackLast
+ \epreto\@glsxtr@prefixedlist{\expandonce\@gls@thislabel,}%
+ \else
+ \eappto\@glsxtr@prefixedlist{,\expandonce\@gls@thislabel}%
+ \fi
+ }%
+ }%
}%
+ \if@endfor
+% \end{macrocode}
+% Loop ended prematurely, which means label was found.
+% \begin{macrocode}
+ \else
+ \ifnum\count@>1\relax
+ \ifGlsXtrPrefixLabelFallbackLast
+ \else
+% \end{macrocode}
+% Fallback on first label.
+% \begin{macrocode}
+ \let\@gls@thislabel\@glsxtr@prefixedfirstlabel
+ \fi
+ \else
+% \end{macrocode}
+% Only one prefix so assume that one.
+% \begin{macrocode}
+ \let\@glsxtr@prefixedlist\@empty
+ \fi
+ \fi
% \end{macrocode}
%\changes{1.46}{2021-09-20}{changed \cs{x} to \cs{@glo@tmp}}
% \begin{macrocode}
- \edef\@glo@tmp{\endgroup\noexpand\def\noexpand\@gls@thislabel{\@gls@thislabel}}\@glo@tmp
+ \edef\@glo@tmp{\endgroup
+ \noexpand\def\noexpand\@glsxtr@prefixedlist{\expandonce\@glsxtr@prefixedlist}%
+ \noexpand\def\noexpand\@gls@thislabel{\expandonce\@gls@thislabel}}\@glo@tmp
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@@dgls@}
+%\changes{1.49}{2022-10-14}{new}
+%Used by all the \cs{dgls}-like commands to find the first match.
+% \begin{macrocode}
+\newcommand*{\@@dgls@}[3]{%
+ \@glsxtr@get@prefixedlabel{#2}%
+ \ifx\@glsxtr@prefixedlist\@empty
+ \let\@dgls@@next#3%
+ \else
+ \let\@dgls@@next\@glsxtr@dglsnomatch
+ \fi
+ \new@ifnextchar[{\@dgls@@next{#1}{\@gls@thislabel}}%
+ {\@dgls@@next{#1}{\@gls@thislabel}[]}%
}
% \end{macrocode}
%\end{macro}
@@ -30841,10 +40591,7 @@ defined}{}%
%\begin{macro}{\@dgls}
%\changes{1.37}{2018-11-30}{new}
% \begin{macrocode}
-\newcommand*{\@dgls}[2][]{%
- \@glsxtr@get@prefixedlabel{#2}%
- \new@ifnextchar[{\@gls@{#1}{\@gls@thislabel}}{\@gls@{#1}{\@gls@thislabel}[]}%
-}
+\newcommand*{\@dgls}[2][]{\@@dgls@{#1}{#2}{\@gls@}}
% \end{macrocode}
%\end{macro}
%
@@ -30857,42 +40604,35 @@ defined}{}%
%\begin{macro}{\@dglspl}
%\changes{1.37}{2018-11-30}{new}
% \begin{macrocode}
-\newcommand*{\@dglspl}[2][]{%
- \@glsxtr@get@prefixedlabel{#2}%
- \new@ifnextchar[{\@glspl@{#1}{\@gls@thislabel}}{\@glspl@{#1}{\@gls@thislabel}[]}%
-}
+\newcommand*{\@dglspl}[2][]{\@@dgls@{#1}{#2}{\@glspl@}}
% \end{macrocode}
%\end{macro}
%
%\begin{macro}{\dGls}
% \begin{macrocode}
\newrobustcmd*{\dGls}{\@gls@hyp@opt\@dGls}
+\glsmfuaddmap{\dgls}{\dGls}
% \end{macrocode}
%\end{macro}
%
%\begin{macro}{\@dGls}
%\changes{1.37}{2018-11-30}{new}
% \begin{macrocode}
-\newcommand*{\@dGls}[2][]{%
- \@glsxtr@get@prefixedlabel{#2}%
- \new@ifnextchar[{\@Gls@{#1}{\@gls@thislabel}}{\@Gls@{#1}{\@gls@thislabel}[]}%
-}
+\newcommand*{\@dGls}[2][]{\@@dgls@{#1}{#2}{\@Gls@}}
% \end{macrocode}
%\end{macro}
%
%\begin{macro}{\dGlspl}
% \begin{macrocode}
\newrobustcmd*{\dGlspl}{\@gls@hyp@opt\@dGlspl}
+\glsmfuaddmap{\dglspl}{\dGlspl}
% \end{macrocode}
%\end{macro}
%
%\begin{macro}{\@dGlspl}
%\changes{1.37}{2018-11-30}{new}
% \begin{macrocode}
-\newcommand*{\@dGlspl}[2][]{%
- \@glsxtr@get@prefixedlabel{#2}%
- \new@ifnextchar[{\@Glspl@{#1}{\@gls@thislabel}}{\@Glspl@{#1}{\@gls@thislabel}[]}%
-}
+\newcommand*{\@dGlspl}[2][]{\@@dgls@{#1}{#2}{\@Glspl@}}
% \end{macrocode}
%\end{macro}
%
@@ -30900,16 +40640,14 @@ defined}{}%
%\changes{1.37}{2018-11-30}{new}
% \begin{macrocode}
\newrobustcmd*{\dGLS}{\@gls@hyp@opt\@dGLS}
+\glsmfublocker{\dGLS}
% \end{macrocode}
%\end{macro}
%
%\begin{macro}{\@dGLS}
%\changes{1.37}{2018-11-30}{new}
% \begin{macrocode}
-\newcommand*{\@dGLS}[2][]{%
- \@glsxtr@get@prefixedlabel{#2}%
- \new@ifnextchar[{\@GLS@{#1}{\@gls@thislabel}}{\@GLS@{#1}{\@gls@thislabel}[]}%
-}
+\newcommand*{\@dGLS}[2][]{\@@dgls@{#1}{#2}{\@GLS@}}
% \end{macrocode}
%\end{macro}
%
@@ -30917,16 +40655,14 @@ defined}{}%
%\changes{1.37}{2018-11-30}{new}
% \begin{macrocode}
\newrobustcmd*{\dGLSpl}{\@gls@hyp@opt\@dGLSpl}
+\glsmfublocker{\dGLSpl}
% \end{macrocode}
%\end{macro}
%
%\begin{macro}{\@dGLSpl}
%\changes{1.37}{2018-11-30}{new}
% \begin{macrocode}
-\newcommand*{\@dGLSpl}[2][]{%
- \@glsxtr@get@prefixedlabel{#2}%
- \new@ifnextchar[{\@GLSpl@{#1}{\@gls@thislabel}}{\@GLSpl@{#1}{\@gls@thislabel}[]}%
-}
+\newcommand*{\@dGLSpl}[2][]{\@@dgls@{#1}{#2}{\@GLSpl@}}
% \end{macrocode}
%\end{macro}
%
@@ -30934,24 +40670,438 @@ defined}{}%
%\changes{1.37}{2018-11-30}{new}
%Like \cs{glslink} but tries the prefixes.
% \begin{macrocode}
-\newrobustcmd*{\dglslink}[3][]{%
+\newrobustcmd*{\dglslink}{\@gls@hyp@opt\@dglslink}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@dglslink}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@dglslink}[3][]{%
\@glsxtr@get@prefixedlabel{#2}%
\glslink[#1]{\@gls@thislabel}{#3}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\dGlslink}
+%\changes{1.49}{2022-10-14}{new}
+%Sentence-case version to provide a mapping.
+% \begin{macrocode}
+\newrobustcmd*{\dGlslink}{\@gls@hyp@opt\@dGlslink}
+\glsmfuaddmap{\dglslink}{\dGlslink}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@dGlslink}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@dGlslink}[3][]{%
+ \dglslink[#1]{#2}{\glssentencecase{#3}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\dglsdisp}
%\changes{1.37}{2018-11-30}{new}
%Like \cs{glsdisp} but tries the prefixes.
% \begin{macrocode}
-\newrobustcmd*{\dglsdisp}[3][]{%
+\newrobustcmd*{\dglsdisp}{\@gls@hyp@opt\@dglsdisp}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@dglsdisp}
+%\changes{1.49}{2022-10-14}{new}
+%Like \cs{glsdisp} but tries the prefixes.
+% \begin{macrocode}
+\newcommand*{\@dglsdisp}[3][]{%
\@glsxtr@get@prefixedlabel{#2}%
\glsdisp[#1]{\@gls@thislabel}{#3}%
}
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\dGlsdisp}
+%\changes{1.49}{2022-10-14}{new}
+%Sentence-case version to provide a mapping.
+% \begin{macrocode}
+\newrobustcmd*{\dGlsdisp}{\@gls@hyp@opt\@dGlsdisp}
+\glsmfuaddmap{\dglsdisp}{\dGlsdisp}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@dGlsdisp}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@dGlsdisp}[3][]{%
+ \dglsdisp[#1]{#2}{\glssentencecase{#3}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%Similar to the above but searches for a match with the given field
+%set.
+%\begin{macro}{\@glsxtr@get@prefixedlabel@field}
+%\changes{1.49}{2022-10-14}{new}
+%The second argument is the field's internal label.
+% \begin{macrocode}
+\newcommand*{\@glsxtr@get@prefixedlabel@field}[2]{%
+ \protected@edef\dglsfieldcurrentfieldlabel{#2}%
+ \let\dglsfieldactualfieldlabel\dglsfieldcurrentfieldlabel
+% \end{macrocode}
+% Grouping is used in case of a nested for loop.
+% \begin{macrocode}
+ \begingroup
+% \end{macrocode}
+%Initialise to the unprefixed label in the event that the list is
+%empty.
+% \begin{macrocode}
+ \protected@edef\@gls@thislabel{#1}%
+% \end{macrocode}
+%Save the first label.
+% \begin{macrocode}
+ \let\@glsxtr@prefixedfirstlabel\@gls@thislabel
+ \def\@glsxtr@set@prefixedfirstlabel{%
+ \let\@glsxtr@prefixedfirstlabel\@gls@thislabel
+ \let\@glsxtr@set@prefixedfirstlabel\relax
+ }%
+% \end{macrocode}
+%Initialise fallback label.
+% \begin{macrocode}
+ \let\@gls@fallbacklabel\relax
+% \end{macrocode}
+%List of labels in the event that no combination is found.
+% \begin{macrocode}
+ \let\@glsxtr@prefixedlist\@empty
+% \end{macrocode}
+% Iterate over all labels.
+% \begin{macrocode}
+ \count@=0\relax
+ \@for\@glsxtr@prefix:=\@glsxtr@labelprefixes\do
+ {%
+ \advance\count@ by 1\relax
+ \protected@edef\@gls@thislabel{\@glsxtr@prefix#1}%
+ \@glsxtr@set@prefixedfirstlabel
+% \end{macrocode}
+% Check if this label exists.
+% \begin{macrocode}
+ \ifglsentryexists{\@gls@thislabel}%
+ {%
+% \end{macrocode}
+% Found a label that exists. Has the field been set?
+% \begin{macrocode}
+ \ifcsvoid{glo@\glsdetoklabel{\@gls@thislabel}@#2}%
+ {%
+% \end{macrocode}
+%Field hasn't been set. Has a fallback been set yet?
+% \begin{macrocode}
+ \ifx\@gls@fallbacklabel\relax
+ \ifcsvoid
+ {glo@\glsdetoklabel{\@gls@thislabel}@\dglsfieldfallbackfieldlabel}%
+ {}%
+ {%
+ \let\@gls@fallbacklabel\@gls@thislabel
+ }%
+ \fi
+ }%
+ {%
+ \@endfortrue
+% \end{macrocode}
+% The field has been set. Clear the list.
+% \begin{macrocode}
+ \let\@glsxtr@prefixedlist\@empty
+ }%
+ }%
+ {%
+% \end{macrocode}
+% Append or prepend to list.
+% \begin{macrocode}
+ \ifdefempty\@glsxtr@prefixedlist
+ {\let\@glsxtr@prefixedlist\@gls@thislabel}%
+ {%
+ \ifGlsXtrPrefixLabelFallbackLast
+ \epreto\@glsxtr@prefixedlist{\expandonce\@gls@thislabel,}%
+ \else
+ \eappto\@glsxtr@prefixedlist{,\expandonce\@gls@thislabel}%
+ \fi
+ }%
+ }%
+ }%
+ \if@endfor
+% \end{macrocode}
+% Loop ended prematurely, which means label was found.
+% \begin{macrocode}
+ \else
+% \end{macrocode}
+% Label not found. Was the fallback field found?
+% \begin{macrocode}
+ \ifx\@gls@fallbacklabel\relax
+% \end{macrocode}
+% No field fallback found.
+% \begin{macrocode}
+ \ifnum\count@>1\relax
+ \ifGlsXtrPrefixLabelFallbackLast
+ \else
+% \end{macrocode}
+% Fallback on first label.
+% \begin{macrocode}
+ \let\@gls@thislabel\@glsxtr@prefixedfirstlabel
+ \fi
+ \else
+% \end{macrocode}
+% Only one prefix so assume that one.
+% \begin{macrocode}
+ \let\@glsxtr@prefixedlist\@empty
+ \fi
+ \else
+% \end{macrocode}
+% Fallback field was found.
+% \begin{macrocode}
+ \let\@gls@thislabel\@gls@fallbacklabel
+ \let\dglsfieldactualfieldlabel\dglsfieldfallbackfieldlabel
+ \fi
+ \fi
+% \end{macrocode}
+%\changes{1.46}{2021-09-20}{changed \cs{x} to \cs{@glo@tmp}}
+% \begin{macrocode}
+ \edef\@glo@tmp{\endgroup
+ \noexpand\def\noexpand\@glsxtr@prefixedlist{\expandonce\@glsxtr@prefixedlist}%
+ \noexpand\def\noexpand\@gls@thislabel{\expandonce\@gls@thislabel}%
+ \noexpand\def\noexpand\dglsfieldactualfieldlabel
+ {\expandonce\dglsfieldactualfieldlabel}%
+ }%
+ \@glo@tmp
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@@dgls@@field}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{@@dgls@@field}\marg{options}\marg{label}\marg{field}\marg{cs}
+%\end{definition}
+% \begin{macrocode}
+\newcommand*{\@@dgls@@field}[4]{%
+ \@glsxtr@get@prefixedlabel@field{#2}{#3}%
+ \ifx\@glsxtr@prefixedlist\@empty
+ \let\@dgls@@next#4%
+ \else
+ \let\@dgls@@next\@glsxtr@dglsnomatch
+ \fi
+ \new@ifnextchar[{\@dgls@@next{#1}{\@gls@thislabel}}%
+ {\@dgls@@next{#1}{\@gls@thislabel}[]}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\dglsfieldcurrentfieldlabel}
+%\changes{1.49}{2022-10-14}{new}
+%Set by the \cs{dglsfield} commands to the current field label.
+%This is the field requested in the argument of \cs{dglsfield}.
+% \begin{macrocode}
+\newcommand*{\dglsfieldcurrentfieldlabel}{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\dglsfieldfallbackfieldlabel}
+%\changes{1.49}{2022-10-14}{new}
+%The field to use if the required field isn't set.
+% \begin{macrocode}
+\newcommand*{\dglsfieldfallbackfieldlabel}{text}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\dglsfieldactualfieldlabel}
+%\changes{1.49}{2022-10-14}{new}
+%This is the field that's actually used.
+% \begin{macrocode}
+\newcommand*{\dglsfieldactualfieldlabel}{\dglsfieldcurrentfieldlabel}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\dglsfield}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{dglsfield}\oarg{options}\marg{label}\marg{field}\oarg{insert}
+%\end{definition}
+% \begin{macrocode}
+\newrobustcmd*{\dglsfield}{\@gls@hyp@opt\@dglsfield}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@dglsfield}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@dglsfield}[3][]{%
+ \@@dgls@@field{#1}{#2}{#3}{\@dgls@field}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@dgls@field}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\def\@dgls@field#1#2[#3]{%
+ \@gls@field@link{#1}{#2}{\glsxtrusefield{#2}{\dglsfieldactualfieldlabel}#3}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\dGlsfield}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{dGlsfield}\oarg{options}\marg{label}\marg{field}\oarg{insert}
+%\end{definition}
+% \begin{macrocode}
+\newrobustcmd*{\dGlsfield}{\@gls@hyp@opt\@dGlsfield}
+\glsmfuaddmap{\dglsfield}{\dGlsfield}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@dGlsfield}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@dGlsfield}[3][]{%
+ \@@dgls@@field{#1}{#2}{#3}{\@dGls@field}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@dGls@field}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\def\@dGls@field#1#2[#3]{%
+ \@gls@field@link{#1}{#2}{\Glsxtrusefield{#2}{\dglsfieldactualfieldlabel}#3}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\dGLSfield}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{dGlsfield}\oarg{options}\marg{label}\marg{field}\oarg{insert}
+%\end{definition}
+% \begin{macrocode}
+\newrobustcmd*{\dGLSfield}{\@gls@hyp@opt\@dGLSfield}
+\glsmfublocker{\dGLSfield}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@dGLSfield}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@dGLSfield}[3][]{%
+ \@@dgls@@field{#1}{#2}{#3}{\@dGLS@field}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@dGLS@field}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\def\@dGLS@field#1#2[#3]{%
+ \@gls@field@link{#1}{#2}{\GLSxtrusefield{#2}{\dglsfieldactualfieldlabel}#3}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\d@inner@glsfield}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{d@inner@glsfield}\marg{default options}\marg{field}\meta{modifier}%
+%\oarg{options}\marg{label}\oarg{insert}
+%\end{definition}
+% \begin{macrocode}
+\newrobustcmd*{\d@inner@glsfield}[2]{%
+ \ifstrempty{#1}
+ {\def\@d@inner@glsfield@opts{}}%
+ {\def\@d@inner@glsfield@opts{#1,}}%
+ \def\dglsfieldcurrentfieldlabel{#2}%
+ \@gls@hyp@opt\@d@inner@glsfield
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@d@inner@glsfield}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@d@inner@glsfield}[2][]{%
+ \expandafter\@@dgls@@field\expandafter
+ {\@d@inner@glsfield@opts#1}{#2}{\dglsfieldcurrentfieldlabel}{\@dgls@field}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\d@inner@Glsfield}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newrobustcmd*{\d@inner@Glsfield}[2]{%
+ \ifstrempty{#1}
+ {\def\@d@inner@glsfield@opts{}}%
+ {\def\@d@inner@glsfield@opts{#1,}}%
+ \def\dglsfieldcurrentfieldlabel{#2}%
+ \@gls@hyp@opt\@d@inner@Glsfield
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@d@inner@Glsfield}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@d@inner@Glsfield}[2][]{%
+ \expandafter\@@dgls@@field\expandafter
+ {\@d@inner@glsfield@opts#1}{#2}{\dglsfieldcurrentfieldlabel}{\@dGls@field}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\d@inner@GLSfield}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newrobustcmd*{\d@inner@GLSfield}[2]{%
+ \ifstrempty{#1}
+ {\def\@d@inner@glsfield@opts{}}%
+ {\def\@d@inner@glsfield@opts{#1,}}%
+ \def\dglsfieldcurrentfieldlabel{#2}%
+ \@gls@hyp@opt\@d@inner@GLSfield
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@d@inner@GLSfield}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand*{\@d@inner@GLSfield}[2][]{%
+ \expandafter\@@dgls@@field\expandafter
+ {\@d@inner@glsfield@opts#1}{#2}{\dglsfieldcurrentfieldlabel}{\@dGLS@field}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\newdglsfield}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{newdglsfield}\oarg{options}\marg{field}\marg{cs}
+%\end{definition}
+% \begin{macrocode}
+\newrobustcmd*{\newdglsfield}[3][]{%
+ \newrobustcmd*{#3}{\d@inner@glsfield{#1}{#2}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\newdglsfieldlike}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{newdglsfieldlike}\oarg{options}\marg{field}\marg{cs}\marg{Cs}\marg{CS}
+%\end{definition}
+% \begin{macrocode}
+\newrobustcmd*{\newdglsfieldlike}[5][]{%
+ \newrobustcmd*{#3}{\d@inner@glsfield{#1}{#2}}%
+ \newrobustcmd*{#4}{\d@inner@Glsfield{#1}{#2}}%
+ \newrobustcmd*{#5}{\d@inner@GLSfield{#1}{#2}}%
+ \glsmfuaddmap{#3}{#4}%
+ \glsmfublocker{#5}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%Multi (compound/combined) entry commands used by \app{bib2gls}.
%\begin{macro}{\glsxtrmultientryadjustedname}
%\begin{definition}
@@ -31000,6 +41150,7 @@ defined}{}%
\@glsxtrmultientryadjustedname{#1}{#2}{#3}{#4}%
\egroup
}
+\glsmfuaddmap{\glsxtrmultientryadjustedname}{\Glsxtrmultientryadjustedname}
% \end{macrocode}
%\end{macro}
%
@@ -31019,6 +41170,7 @@ defined}{}%
\@glsxtrmultientryadjustedname{#1}{#2}{#3}{#4}%
\egroup
}
+\glsmfublocker{\GlsXtrmultientryadjustedname}
% \end{macrocode}
%\end{macro}
%
@@ -31038,6 +41190,7 @@ defined}{}%
\@glsxtrmultientryadjustedname{#1}{#2}{#3}{#4}%
\egroup
}
+\glsmfublocker{\GLSxtrmultientryadjustedname}
% \end{macrocode}
%\end{macro}
%
@@ -31122,7 +41275,7 @@ defined}{}%
%\begin{macro}{\Glsxtrmultientryadjustednamefmt}
%\changes{1.48}{2021-11-22}{new}
% \begin{macrocode}
-\newcommand*{\Glsxtrmultientryadjustednamefmt}[1]{\makefirstuc{#1}}
+\newcommand*{\Glsxtrmultientryadjustednamefmt}[1]{\glssentencecase{#1}}
% \end{macrocode}
%\end{macro}
%
@@ -31158,14 +41311,14 @@ defined}{}%
%\changes{1.48}{2021-11-22}{new}
% \begin{macrocode}
\newcommand*{\GLSxtrmultientryadjustednameother}[1]{%
- \mfirstucMakeUppercase{\glsentryname{#1}}}
+ \glsuppercase{\glsentryname{#1}}}
% \end{macrocode}
%\end{macro}
%
%\begin{macro}{\GLSxtrmultientryadjustednamefmt}
%\changes{1.48}{2021-11-22}{new}
% \begin{macrocode}
-\newcommand*{\GLSxtrmultientryadjustednamefmt}[1]{\mfirstucMakeUppercase{#1}}
+\newcommand*{\GLSxtrmultientryadjustednamefmt}[1]{\glsuppercase{#1}}
% \end{macrocode}
%\end{macro}
%
@@ -31406,7 +41559,7 @@ defined}{}%
%of \cs{IfTrackedLanguageFileExists} in the \sty{tracklang} manual
%for the allowed forms of \meta{tag}. The simplest is to just use
%the root language label or ISO code. The file will then be automatically loaded
-%by \styfmt{glossaries-extra} if the document has support for that
+%by \sty{glossaries-extra} if the document has support for that
%language.
%
%When combining these blocks of rules, remember to separate them
@@ -31416,7 +41569,7 @@ defined}{}%
% ;\glsxtrspacerules
% ;\glsxtrnonprintablerules
% ;\glsxtrcombiningdiacriticrules
-% ,\glsxtrhyphenrules
+% ;\glsxtrhyphenrules
% <\glsxtrgeneralpuncrules
% <\glsxtrdigitrules
% <\glsxtrfractionrules
@@ -31425,6 +41578,34 @@ defined}{}%
%}
%\end{verbatim}
%
+%\begin{macro}{\glsxtrIgnorableRules}
+%\changes{1.49}{2022-10-14}{new}
+%A shortcut command for common ignorable characters.
+% \begin{macrocode}
+\newcommand{\glsxtrIgnorableRules}{%
+ \glsxtrcontrolrules
+ \string;\glsxtrspacerules
+ \string;\glsxtrnonprintablerules
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrGeneralInitRules}
+%\changes{1.49}{2022-10-14}{new}
+%A shortcut command for common initial rules for ignorables,
+%diacritics, punctuation and digits.
+% \begin{macrocode}
+\newcommand{\glsxtrGeneralInitRules}{%
+ \glsxtrIgnorableRules
+ \string;\glsxtrcombiningdiacriticrules
+ \string;\glsxtrhyphenrules
+ \string<\glsxtrgeneralpuncrules
+ \string<\glsxtrdigitrules
+ \string<\glsxtrfractionrules
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsxtrcontrolrules}
%\changes{1.27}{2018-02-26}{new}
%These are control characters that are usually placed at the start
@@ -31671,6 +41852,20 @@ defined}{}%
%First set of general punctuation.
% \begin{macrocode}
\newcommand*{\glsxtrgeneralpuncIrules}{%
+ \glsxtrgeneralpuncmarksrules
+ \string<\glsxtrgeneralpuncaccentsrules
+ \string<\glsxtrgeneralpuncquoterules
+ \string<\glsxtrgeneralpuncbracketrules
+ \string<\glsxtrgeneralpuncsignrules
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrgeneralpuncmarksrules}
+%\changes{1.49}{2022-10-14}{new}
+%Punctuation marks subset.
+% \begin{macrocode}
+\newcommand*{\glsxtrgeneralpuncmarksrules}{%
\string'\glshex 005F\string'% underscore
\string<\glshex 00AF% macron
\string<\string'\glshex 002C\string'% comma
@@ -31682,18 +41877,45 @@ defined}{}%
\string<\glshex 00BF% inverted question mark
\string<\string'\glshex 002F\string'% solidus
\string<\string'\glshex 002E\string'% full stop
- \string<\glshex 00B4% acute accent
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrgeneralpuncaccentsrules}
+%\changes{1.49}{2022-10-14}{new}
+%Punctuation marks subset: accent characters.
+% \begin{macrocode}
+\newcommand*{\glsxtrgeneralpuncaccentsrules}{%
+ \glshex 00B4% acute accent
\string<\string'\glshex 0060\string'% grave accent
\string<\string'\glshex 005E\string'% circumflex accent
\string<\glshex 00A8% diaersis
\string<\string'\glshex 007E\string'% tilde
\string<\glshex 00B7% middle dot
\string<\glshex 00B8% cedilla
- \string<\string'\glshex 0027\string'% straight apostrophe
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrgeneralpuncquoterules}
+%\changes{1.49}{2022-10-14}{new}
+%Punctuation marks subset: quotes.
+% \begin{macrocode}
+\newcommand*{\glsxtrgeneralpuncquoterules}{%
+ \string'\glshex 0027\string'% straight apostrophe
\string<\string'\glshex 0022\string'% straight double quote
\string<\glshex 00AB% left guillemet
\string<\glshex 00BB% right guillemet
- \string<\string'\glshex 0028\string'% left parenthesis
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrgeneralpuncbracketrules}
+%\changes{1.49}{2022-10-14}{new}
+%Punctuation marks subset: brackets.
+% \begin{macrocode}
+\newcommand*{\glsxtrgeneralpuncbracketrules}{%
+ \string'\glshex 0028\string'% left parenthesis
\string=\glshex 207D\string=\glshex 208D% super/subscript left parenthesis
\string<\string'\glshex 0029\string'% right parenthesis
\string=\glshex 207E\string=\glshex 208E% super/subscript right parenthesis
@@ -31701,7 +41923,16 @@ defined}{}%
\string<\string'\glshex 005D\string'% right square bracket
\string<\string'\glshex 007B\string'% left curly bracket
\string<\string'\glshex 007D\string'% right curly bracket
- \string<\glshex 00A7% section sign
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrgeneralpuncsignrules}
+%\changes{1.49}{2022-10-14}{new}
+%Punctuation marks subset: signs.
+% \begin{macrocode}
+\newcommand*{\glsxtrgeneralpuncsignrules}{%
+ \glshex 00A7% section sign
\string<\glshex 00B6% pilcrow sign
\string<\glshex 00A9% copyright sign
\string<\glshex 00AE% registered sign
@@ -32078,6 +42309,115 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%Fragments.
+%\begin{macro}{\glsxtrGeneralLatinAtoMrules}
+%\changes{1.49}{2022-10-14}{new}
+%Basic Latin alphabet A--M.
+% \begin{macrocode}
+\newcommand*{\glsxtrGeneralLatinAtoMrules}{%
+ \glsxtrLatinA
+ \string<b,B%
+ \string<c,C%
+ \string<d,D%
+ \string<\glsxtrLatinE
+ \string<f,F%
+ \string<g,G%
+ \string<\glsxtrLatinH
+ \string<\glsxtrLatinI
+ \string<j,J%
+ \string<\glsxtrLatinK
+ \string<\glsxtrLatinL
+ \string<\glsxtrLatinM
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrGeneralLatinNtoZrules}
+%\changes{1.49}{2022-10-14}{new}
+%Basic Latin alphabet N--Z.
+% \begin{macrocode}
+\newcommand*{\glsxtrGeneralLatinNtoZrules}{%
+ \string<\glsxtrLatinN
+ \string<\glsxtrLatinO
+ \string<\glsxtrLatinP
+ \string<q,Q%
+ \string<r,R%
+ \string<\glsxtrLatinS
+ \string<\glsxtrLatinT
+ \string<u,U%
+ \string<v,V%
+ \string<w,W%
+ \string<\glsxtrLatinX
+ \string<y,Y%
+ \string<z,Z
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrGeneralLatinAtoGrules}
+%\changes{1.49}{2022-10-14}{new}
+%Basic Latin alphabet A--G.
+% \begin{macrocode}
+\newcommand*{\glsxtrGeneralLatinAtoGrules}{%
+ \glsxtrLatinA
+ \string<b,B%
+ \string<c,C%
+ \string<d,D%
+ \string<\glsxtrLatinE
+ \string<f,F%
+ \string<g,G%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrGeneralLatinHtoMrules}
+%\changes{1.49}{2022-10-14}{new}
+%Basic Latin alphabet H--M.
+% \begin{macrocode}
+\newcommand*{\glsxtrGeneralLatinHtoMrules}{%
+ \string<\glsxtrLatinH
+ \string<\glsxtrLatinI
+ \string<j,J%
+ \string<\glsxtrLatinK
+ \string<\glsxtrLatinL
+ \string<\glsxtrLatinM
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrGeneralLatinNtoSrules}
+%\changes{1.49}{2022-10-14}{new}
+%Basic Latin alphabet N--S.
+% \begin{macrocode}
+\newcommand*{\glsxtrGeneralLatinNtoSrules}{%
+ \string<\glsxtrLatinN
+ \string<\glsxtrLatinO
+ \string<\glsxtrLatinP
+ \string<q,Q%
+ \string<r,R%
+ \string<\glsxtrLatinS
+}
+% \end{macrocode}
+%\end{macro}
+%
+%
+%\begin{macro}{\glsxtrGeneralLatinTtoZrules}
+%\changes{1.49}{2022-10-14}{new}
+%Basic Latin alphabet T--Z.
+% \begin{macrocode}
+\newcommand*{\glsxtrGeneralLatinTtoZrules}{%
+ \string<\glsxtrLatinT
+ \string<u,U%
+ \string<v,V%
+ \string<w,W%
+ \string<\glsxtrLatinX
+ \string<y,Y%
+ \string<z,Z
+}
+% \end{macrocode}
+%\end{macro}
+%
+%
%\begin{macro}{\glsxtrLatinA}
%\changes{1.27}{2018-02-26}{new}
% \begin{macrocode}
@@ -32207,20 +42547,22 @@ defined}{}%
%
%\begin{macro}{\glsxtrLatinEszettSs}
%\changes{1.27}{2018-02-26}{new}
+%\SS=ss
% \begin{macrocode}
\newcommand*{\glsxtrLatinEszettSs}{%
\glshex 00DF% eszett
- \string=\glshex 017Fs % long S s
+ \string=\glshex 017Fs % "long S"s
}
% \end{macrocode}
%\end{macro}
%
%\begin{macro}{\glsxtrLatinEszettSz}
%\changes{1.27}{2018-02-26}{new}
+%\SS=sz
% \begin{macrocode}
\newcommand*{\glsxtrLatinEszettSz}{%
\glshex 00DF% eszett
- \string= \glshex 017Fz % long S z
+ \string= \glshex 017Fz % "long S"z
}
% \end{macrocode}
%\end{macro}
@@ -33363,7 +43705,7 @@ defined}{}%
%If \cs{glsxtr@loaddialect} has been defined, then
%\sty{glossaries-extra-bib2gls} has been loaded after
%\sty{glossaries-extra}. (For example, through
-%\ics{glossariesextrasetup}.) Not recommended, but if this has been
+%\cs{glossariesextrasetup}.) Not recommended, but if this has been
%done try to find the associated language resources.
% \begin{macrocode}
\ifdef\glsxtr@loaddialect
@@ -33390,16 +43732,24 @@ defined}{}%
%<*glossaries-extra-stylemods.sty>
% \end{macrocode}
%\fi
-%\chapter{Style Adjustments (\styfmt{glossaries-extra-stylemods.sty})}
+%\section{Style Adjustments (\sty{glossaries-extra-stylemods.sty})}
% This package adjusts the predefined styles so that they include the post
% description hook. Also, some other minor adjustments may be made
% to make existing styles more flexible.
%
-%\section{Package Initialisation}
+%\subsection{Package Initialisation}
% First identify package:
% \begin{macrocode}
\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{glossaries-extra-stylemods}[2021/11/22 v1.48 (NLCT)]
+% \end{macrocode}
+% Rollback releases:
+% \begin{macrocode}
+\DeclareRelease{v1.48}{2021-11-22}{glossaries-extra-stylemods-2021-11-22.sty}
+\DeclareCurrentRelease{v1.49}{2022-10-14}
+% \end{macrocode}
+% Declare package:
+% \begin{macrocode}
+\ProvidesPackage{glossaries-extra-stylemods}[2022/10/14 v1.49 (NLCT)]
% \end{macrocode}
% Provide package options to automatically load required predefined
% styles. The simplest method is to just test for the existence of
@@ -33414,8 +43764,8 @@ defined}{}%
%
%\begin{option}{all}
%\changes{1.21}{2017-11-03}{new}
-%\changes{1.38}{2018-12-01}{added \styfmt{glossary-longextra}}
-%\changes{1.40}{2019-03-22}{added \styfmt{glossary-topic}}
+%\changes{1.38}{2018-12-01}{added \sty{glossary-longextra}}
+%\changes{1.40}{2019-03-22}{added \sty{glossary-topic}}
%Provide all known styles.
% \begin{macrocode}
\DeclareOption{all}{%
@@ -33485,7 +43835,7 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
-%\section{List-Like Styles}
+%\subsection{List-Like Styles}
% The list-like styles mostly already use the post description hook.
% Only the \glostyle{listdotted} style need modifying to add this.
% \begin{macrocode}
@@ -33615,6 +43965,13 @@ defined}{}%
{\glslistinit\begin{description}}{\end{description}}%
\renewcommand*{\glossaryheader}{}%
\renewcommand*{\glsgroupheading}[1]{}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}. This
+% does nothing as the sub-entries don't have the name displayed for
+% the list styles.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{}%
\renewcommand*{\glossentry}[2]{%
\glslistitem{##1}\glslistdesc{##1}\glslistprelocation ##2}%
\renewcommand*{\subglossentry}[3]{%
@@ -33665,10 +44022,15 @@ defined}{}%
\ifdef{\@glsstyle@listgroup}
{%
% \end{macrocode}
-%\begin{macro}{\glslistgroupafterheader}
+%\begin{macro}{\glslistgroupheaderitem}
%\changes{1.47}{2021-11-04}{new}
% \begin{macrocode}
\newcommand{\glslistgroupheaderitem}[2]{\item[{#2}]}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\glslistgroupafterheader}
+%\changes{1.47}{2021-11-04}{new}
+% \begin{macrocode}
\newcommand{\glslistgroupafterheader}{%
\mbox{}\par\nobreak\@afterheading
}
@@ -33741,7 +44103,7 @@ defined}{}%
{}
% \end{macrocode}
%
-%\section{Longtable Styles}
+%\subsection{Longtable Styles}
% The three and four column styles require adjustment to add the
% post-description hook. The two column styles need the hard-coded
% \cs{space} changed to \cs{glsxtrprelocation}.
@@ -33754,6 +44116,13 @@ defined}{}%
{\end{longtable}}%
\renewcommand*{\glossaryheader}{}%
\renewcommand*{\glsgroupheading}[1]{}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}. This
+% does nothing as the sub-entries don't have the name displayed for
+% the long styles.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{}%
\renewcommand{\glossentry}[2]{%
\glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
\glossentrydesc{##1}\glspostdescription
@@ -33784,6 +44153,13 @@ defined}{}%
{\end{longtable}}%
\renewcommand*{\glossaryheader}{}%
\renewcommand*{\glsgroupheading}[1]{}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}. This
+% does nothing as the sub-entries don't have the name displayed for
+% the long styles.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{}%
\renewcommand{\glossentry}[2]{%
\glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
\glossentrydesc{##1}\glspostdescription & ##2\tabularnewline
@@ -33818,6 +44194,13 @@ defined}{}%
{\end{longtable}}%
\renewcommand*{\glossaryheader}{}%
\renewcommand*{\glsgroupheading}[1]{}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}. This
+% does nothing as the sub-entries don't have the name displayed for
+% the long styles.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{}%
\renewcommand{\glossentry}[2]{%
\glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
\glossentrydesc{##1}\glspostdescription &
@@ -33847,7 +44230,7 @@ defined}{}%
%styles in \sty{glossary-long}, so no adjustments are needed for
%that package.
%
-%\section{Long Ragged Styles}
+%\subsection{Long Ragged Styles}
% The three and four column styles require adjustment for the
% post-description hook, but not the two column styles. However, the
% two-column styles need to have \cs{space} replaced with
@@ -33861,6 +44244,13 @@ defined}{}%
{\end{longtable}}%
\renewcommand*{\glossaryheader}{}%
\renewcommand*{\glsgroupheading}[1]{}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}. This
+% does nothing as the sub-entries don't have the name displayed for
+% the longragged styles.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{}%
\renewcommand{\glossentry}[2]{%
\glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
\glossentrydesc{##1}\glspostdescription\glsxtrprelocation ##2%
@@ -33894,6 +44284,13 @@ defined}{}%
{\end{longtable}}%
\renewcommand*{\glossaryheader}{}%
\renewcommand*{\glsgroupheading}[1]{}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}. This
+% does nothing as the sub-entries don't have the name displayed for
+% the longragged styles.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{}%
\renewcommand{\glossentry}[2]{%
\glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
\glossentrydesc{##1}\glspostdescription & ##2\tabularnewline
@@ -33927,6 +44324,13 @@ defined}{}%
{\end{longtable}}%
\renewcommand*{\glossaryheader}{}%
\renewcommand*{\glsgroupheading}[1]{}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}. This
+% does nothing as the sub-entries don't have the name displayed for
+% the longragged styles.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{}%
\renewcommand{\glossentry}[2]{%
\glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
\glossentrydesc{##1}\glspostdescription & \glossentrysymbol{##1} &
@@ -33951,7 +44355,7 @@ defined}{}%
{}
% \end{macrocode}
%
-%\section{Supertabular Styles}
+%\subsection{Supertabular Styles}
% The three and four column styles require adjustment to add the
% post-description hook. The two column styles need the hard-coded
% \cs{space} changed to \cs{glsxtrprelocation}.
@@ -33965,6 +44369,13 @@ defined}{}%
{\end{supertabular}}%
\renewcommand*{\glossaryheader}{}%
\renewcommand*{\glsgroupheading}[1]{}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}. This
+% does nothing as the sub-entries don't have the name displayed for
+% the super styles.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{}%
\renewcommand{\glossentry}[2]{%
\glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
\glossentrydesc{##1}\glspostdescription
@@ -33996,6 +44407,13 @@ defined}{}%
{\end{supertabular}}%
\renewcommand*{\glossaryheader}{}%
\renewcommand*{\glsgroupheading}[1]{}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}. This
+% does nothing as the sub-entries don't have the name displayed for
+% the super styles.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{}%
\renewcommand{\glossentry}[2]{%
\glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
\glossentrydesc{##1}\glspostdescription & ##2\tabularnewline
@@ -34029,6 +44447,13 @@ defined}{}%
\end{supertabular}}%
\renewcommand*{\glossaryheader}{}%
\renewcommand*{\glsgroupheading}[1]{}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}. This
+% does nothing as the sub-entries don't have the name displayed for
+% the super styles.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{}%
\renewcommand{\glossentry}[2]{%
\glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
\glossentrydesc{##1}\glspostdescription &
@@ -34053,7 +44478,7 @@ defined}{}%
{}
% \end{macrocode}
%
-%\section{Super Ragged Styles}
+%\subsection{Super Ragged Styles}
% The three and four column styles require adjustment for the
% post-description hook, but not the two column styles. However, the
% two-column styles need to have \cs{space} replaced with
@@ -34068,6 +44493,13 @@ defined}{}%
{\end{supertabular}}%
\renewcommand*{\glossaryheader}{}%
\renewcommand*{\glsgroupheading}[1]{}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}. This
+% does nothing as the sub-entries don't have the name displayed for
+% the super styles.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{}%
\renewcommand{\glossentry}[2]{%
\glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
\glossentrydesc{##1}\glspostdescription\glsxtrprelocation ##2%
@@ -34101,6 +44533,13 @@ defined}{}%
{\end{supertabular}}%
\renewcommand*{\glossaryheader}{}%
\renewcommand*{\glsgroupheading}[1]{}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}. This
+% does nothing as the sub-entries don't have the name displayed for
+% the super styles.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{}%
\renewcommand{\glossentry}[2]{%
\glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
\glossentrydesc{##1}\glspostdescription &
@@ -34159,7 +44598,7 @@ defined}{}%
{}
% \end{macrocode}
%
-%\section{Inline Style}
+%\subsection{Inline Style}
% The \glostyle{inline} style is dealt with slightly differently.
% The \cs{glspostdescription} hook is actually in
% \cs{glspostinline}, which is called at the end of the glossary.
@@ -34187,7 +44626,7 @@ defined}{}%
{}
% \end{macrocode}
%
-%\section{Tree Styles}
+%\subsection{Tree Styles}
% Redefine both \cs{glstreenamefmt} and \cs{glstreegroupheaderfmt}
% in terms of \cs{glstreedefaultnamefmt} to make it easier to change
% both at the same time or only change one without affecting the
@@ -34232,6 +44671,17 @@ defined}{}%
\newcommand{\glstreePreHeader}[2]{}
% \end{macrocode}
%\end{macro}
+%
+%\begin{macro}{\glstreeSubPreHeader}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glstreeSubPreHeader}\marg{previous group level}\marg{level}\marg{parent label}\marg{group label}\marg{title}
+%\end{definition}
+% \begin{macrocode}
+ \newcommand{\glstreeSubPreHeader}[5]{}
+% \end{macrocode}
+%\end{macro}
+%
% \begin{macrocode}
}
{}
@@ -34288,6 +44738,11 @@ defined}{}%
{\par}%
\renewcommand*{\glossaryheader}{}%
\renewcommand*{\glsgroupheading}[1]{}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{}%
\renewcommand*{\glossentry}[2]{%
\item\glsentryitem{##1}%
\glstreenamefmt{\glstarget{##1}{\glossentryname{##1}}}%
@@ -34320,14 +44775,57 @@ defined}{}%
% \begin{macrocode}
\ifdef{\@glsstyle@indexgroup}
{%
+% \end{macrocode}
+% Provide formatting command for sub-headings to make it easier to
+% adjust.
+%\begin{macro}{\glsindexsubgroupitem}
+%\begin{definition}
+%\cs{glsindexsubgroupitem}\marg{previous group level}\marg{level}\marg{parent label}\marg{group label}\marg{title}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsindexsubgroupitem}[5]{%
+ \ifcase#2\relax
+% \end{macrocode}
+%This case shouldn't occur as \cs{glsgroupheading} will be used
+%instead, but include for completeness.
+% \begin{macrocode}
+ \item \glstreegroupheaderfmt{#5}%
+ \glstreegroupheaderskip
+ \or
+ \smallskip
+ \subitem \glstreegroupheaderfmt{#5}%
+ \smallskip
+ \else
+ \smallskip
+ \subsubitem \glstreegroupheaderfmt{#5}%
+ \smallskip
+ \fi
+ }
+% \end{macrocode}
+%\end{macro}
+% \begin{macrocode}
\renewglossarystyle{indexgroup}{%
\setglossarystyle{index}%
+% \end{macrocode}
+% Group heading.
+% \begin{macrocode}
\renewcommand*{\glsgroupheading}[1]{%
\glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
\glstreePreHeader{##1}{\glsxtr@grptitle}%
\item\glstreegroupheaderfmt{\glsxtr@grptitle}%
\glstreegroupheaderskip\@afterheading
}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{%
+ \glsxtrgetgrouptitle{##4}{\glsxtr@grptitle}%
+ \glstreeSubPreHeader{##1}{##2}{##3}{##4}{\glsxtr@grptitle}%
+ \glsindexsubgroupitem{##1}{##2}{##3}{##4}{\glsxtr@grptitle}%
+ \@afterheading
+ }%
}
}
{}
@@ -34344,12 +44842,26 @@ defined}{}%
\renewcommand*{\glossaryheader}{%
\item\glstreenavigationfmt{\glsnavigation}%
\glstreegroupheaderskip\@afterheading}%
+% \end{macrocode}
+% Group heading.
+% \begin{macrocode}
\renewcommand*{\glsgroupheading}[1]{%
\glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
\glstreePreHeader{##1}{\glsxtr@grptitle}%
\item\glstreegroupheaderfmt
{\glsnavhypertarget{##1}{\glsxtr@grptitle}}%
\glstreegroupheaderskip\@afterheading}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{%
+ \glsxtrgetgrouptitle{##4}{\glsxtr@grptitle}%
+ \glstreeSubPreHeader{##1}{##2}{##3}{##4}{\glsxtr@grptitle}%
+ \glsindexsubgroupitem{##1}{##2}{##3}{##4}%
+ {\glsnavhypertarget{##4}{\glsxtr@grptitle}}%
+ \@afterheading
+ }%
}%
}
{}
@@ -34368,13 +44880,13 @@ defined}{}%
%\begin{macro}{\glsxtrtreepredesc}
%\changes{1.46}{2021-09-20}{new}
% \begin{macrocode}
-\newcommand{\glsxtrtreepredesc}{\glstreepredesc}
+ \newcommand{\glsxtrtreepredesc}{\glstreepredesc}
% \end{macrocode}
%\end{macro}
%\begin{macro}{\glsxtrtreechildpredesc}
%\changes{1.46}{2021-09-20}{new}
% \begin{macrocode}
-\newcommand{\glsxtrtreechildpredesc}{\glstreechildpredesc}
+ \newcommand{\glsxtrtreechildpredesc}{\glstreechildpredesc}
% \end{macrocode}
%\end{macro}
%Provide a command for use with the \glostyle{tree} styles that displays
@@ -34456,6 +44968,7 @@ defined}{}%
}%
% \end{macrocode}
%\end{macro}
+%Redefine tree style.
% \begin{macrocode}
\renewglossarystyle{tree}{%
\renewenvironment{theglossary}%
@@ -34463,7 +44976,18 @@ defined}{}%
\setlength{\parskip}{0pt plus 0.3pt}}%
{}%
\renewcommand*{\glossaryheader}{}%
+% \end{macrocode}
+% Group heading.
+% \begin{macrocode}
\renewcommand*{\glsgroupheading}[1]{}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{}%
+% \end{macrocode}
+% Top level entry.
+% \begin{macrocode}
\renewcommand{\glossentry}[2]{%
\hangindent0pt\relax
\parindent0pt\relax
@@ -34471,6 +44995,9 @@ defined}{}%
\glstreesymbol{##1}%
\glstreeDescLoc{##1}{##2}\par
}%
+% \end{macrocode}
+% Sub entries.
+% \begin{macrocode}
\renewcommand{\subglossentry}[3]{%
\hangindent##1\glstreeindent\relax
\parindent##1\glstreeindent\relax
@@ -34494,13 +45021,42 @@ defined}{}%
% \begin{macrocode}
\ifdef{\@glsstyle@treegroup}
{%
+% \end{macrocode}
+% Provide formatting command for sub-headings to make it easier to
+% adjust.
+%\begin{macro}{\glstreesubgroupitem}
+%\begin{definition}
+%\cs{glstreesubgroupitem}\marg{previous group level}\marg{level}\marg{parent label}\marg{group label}\marg{title}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glstreesubgroupitem}[5]{%
+ \par\smallskip\noindent\hspace{#2\glstreeindent}%
+ \glstreegroupheaderfmt{#5}\smallskip\par
+ }
+% \end{macrocode}
+%\end{macro}
+% Redefine treegroup style.
+% \begin{macrocode}
\renewglossarystyle{treegroup}{%
\setglossarystyle{tree}%
+% \end{macrocode}
+% Group heading.
+% \begin{macrocode}
\renewcommand{\glsgroupheading}[1]{%
\glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
\glstreePreHeader{##1}{\glsxtr@grptitle}%
\par\noindent\glstreegroupheaderfmt{\glsxtr@grptitle}%
\glstreegroupheaderskip\@afterheading}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{%
+ \glsxtrgetgrouptitle{##4}{\glsxtr@grptitle}%
+ \glstreeSubPreHeader{##1}{##2}{##3}{##4}{\glsxtr@grptitle}%
+ \glstreesubgroupitem{##1}{##2}{##3}{##4}{\glsxtr@grptitle}%
+ }%
}
}
{}
@@ -34517,6 +45073,9 @@ defined}{}%
\renewcommand*{\glossaryheader}{%
\par\noindent\glstreenavigationfmt{\glsnavigation}%
\glstreegroupheaderskip\@afterheading}%
+% \end{macrocode}
+% Group heading.
+% \begin{macrocode}
\renewcommand*{\glsgroupheading}[1]{%
\glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
\glstreePreHeader{##1}{\glsxtr@grptitle}%
@@ -34524,6 +45083,16 @@ defined}{}%
\glstreegroupheaderfmt
{\glsnavhypertarget{##1}{\glsxtr@grptitle}}%
\glstreegroupheaderskip\@afterheading}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{%
+ \glsxtrgetgrouptitle{##4}{\glsxtr@grptitle}%
+ \glstreeSubPreHeader{##1}{##2}{##3}{##4}{\glsxtr@grptitle}%
+ \glstreesubgroupitem{##1}{##2}{##3}{##4}%
+ {\glsnavhypertarget{##4}{\glsxtr@grptitle}}%
+ }%
}
}
{}
@@ -34581,6 +45150,7 @@ defined}{}%
}
% \end{macrocode}
%\end{macro}
+%Redefine treenoname style
% \begin{macrocode}
\renewglossarystyle{treenoname}{%
\renewenvironment{theglossary}%
@@ -34588,7 +45158,15 @@ defined}{}%
\setlength{\parskip}{0pt plus 0.3pt}}%
{}%
\renewcommand*{\glossaryheader}{}%
+% \end{macrocode}
+% Group heading.
+% \begin{macrocode}
\renewcommand*{\glsgroupheading}[1]{}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{}%
\renewcommand{\glossentry}[2]{%
\hangindent0pt\relax
\parindent0pt\relax
@@ -34615,7 +45193,8 @@ defined}{}%
% \end{macrocode}
%
% The \glostyle{treenonamegroup} style is redefined to discourage a page
-% break after the heading.
+% break after the heading. There are no sub-groups as sub-entries
+% don't have the name shown.
%\changes{1.21}{2017-11-03}{redefined \texttt{treenonamegroup} to discourage
%breaks after group headings}
% \begin{macrocode}
@@ -34888,7 +45467,7 @@ defined}{}%
%
%\begin{macro}{\glsFindWidestTopLevelName}
%CamelCase is easier for long command names. Provide a CamelCase
-%synonym of \ics{glsfindwidesttoplevelname}.
+%synonym of \cs{glsfindwidesttoplevelname}.
% \begin{macrocode}
\let\glsFindWidestTopLevelName\glsfindwidesttoplevelname
% \end{macrocode}
@@ -35164,7 +45743,7 @@ defined}{}%
%\begin{macro}{\glsFindWidestUsedAnyNameSymbolLocation}
%\changes{1.05}{2016-06-10}{new}
% Like the \cs{glsFindWidestUsedAnyNameSymbol} but also measures the
-% location list. This requires \ics{glsentrynumberlist}.
+% location list. This requires \cs{glsentrynumberlist}.
% The length of the widest symbol is stored in the second argument
% should be a length register. The length of the widest location
% list is stored in the third argument, which should also be a
@@ -35280,7 +45859,7 @@ defined}{}%
%\begin{macro}{\glsFindWidestAnyNameLocation}
%\changes{1.05}{2016-06-10}{new}
% Like the \cs{glsFindWidestAnyNameLocation} but doesn't
-% check the \gls{firstuse} flag.
+% check the first use flag.
% \begin{macrocode}
\newrobustcmd*{\glsFindWidestAnyNameLocation}[2][\@glo@types]{%
\dimen@=0pt\relax
@@ -35369,6 +45948,11 @@ defined}{}%
{\par}%
\renewcommand*{\glossaryheader}{}%
\renewcommand*{\glsgroupheading}[1]{}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{}%
\renewcommand{\glossentry}[2]{%
\ifnum\@gls@prevlevel=0\relax
\else
@@ -35426,7 +46010,24 @@ defined}{}%
%breaks after group headings}
% \begin{macrocode}
\ifdef{\@glsstyle@alttreegroup}
-{%
+{
+% \end{macrocode}
+%\begin{macro}{\glsalttreesubgroupitem}
+%\begin{definition}
+%\cs{glsalttreesubgroupheader}\marg{previous group level}\marg{group
+%level}\marg{parent label}\marg{group label}\marg{title}\marg{width}
+%\end{definition}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+ \newcommand*{\glsalttreesubgroupheader}[6]{%
+ \par\smallskip
+ \makebox[0pt][r]{\glstreenamebox{#6}%
+ {\glstreegroupheaderfmt{#5}}}%
+ \smallskip\par
+ }
+% \end{macrocode}
+%\end{macro}
+% \begin{macrocode}
\renewglossarystyle{alttreegroup}{%
\setglossarystyle{alttree}%
\renewcommand{\glsgroupheading}[1]{\par
@@ -35442,6 +46043,52 @@ defined}{}%
% \begin{macrocode}
\glstreegroupheaderskip
}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{%
+ \glsxtrgetgrouptitle{##4}{\glsxtr@grptitle}%
+ \glstreeSubPreHeader{##1}{##2}{##3}{##4}{\glsxtr@grptitle}%
+% \end{macrocode}
+%This is similar to \cs{subglossentry}
+% \begin{macrocode}
+ \ifnum\@gls@prevlevel=##2\relax
+ \else
+ \ifcsundef{@glswidestname\romannumeral##2}%
+ {%
+ \settowidth{\gls@tmplen}{\glstreenamefmt{\@glswidestname\space}}%
+ }%
+ {%
+ \settowidth{\gls@tmplen}{\glstreenamefmt{%
+ \csname @glswidestname\romannumeral##2\endcsname\space}}%
+ }%
+ \ifnum\@gls@prevlevel<##2\relax
+ \setlength\glstreeindent\gls@tmplen
+ \addtolength\glstreeindent\parindent
+ \parindent\glstreeindent
+ \else
+ \ifnum\@gls@prevlevel=0\relax
+ \glsxtrComputeTreeIndent{##2}%
+ \else
+ \ifcsundef{@glswidestname\romannumeral##2}%
+ {%
+ \settowidth{\glstreeindent}{\glstreenamefmt{\@glswidestname\space}}%
+ }%
+ {%
+ \settowidth{\glstreeindent}{\glstreenamefmt{%
+ \csname @glswidestname\romannumeral##2\endcsname\space}}%
+ }%
+ \fi
+ \addtolength\parindent{-\glstreeindent}%
+ \setlength\glstreeindent\parindent
+ \fi
+ \fi
+ \glsxtrAltTreeSetSubHangIndent{##2}%
+ \glsalttreesubgroupheader{##1}{##2}{##3}{##4}{\glsxtr@grptitle}{\gls@tmplen}%
+ \def\@gls@prevlevel{##2}%
+ \par
+ }%
}%
}%
{%
@@ -35481,13 +46128,60 @@ defined}{}%
% \begin{macrocode}
\glstreegroupheaderskip
}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{%
+ \glsxtrgetgrouptitle{##4}{\glsxtr@grptitle}%
+ \glstreeSubPreHeader{##1}{##2}{##3}{##4}{\glsxtr@grptitle}%
+% \end{macrocode}
+%This is similar to \cs{subglossentry}
+% \begin{macrocode}
+ \ifnum\@gls@prevlevel=##2\relax
+ \else
+ \ifcsundef{@glswidestname\romannumeral##2}%
+ {%
+ \settowidth{\gls@tmplen}{\glstreenamefmt{\@glswidestname\space}}%
+ }%
+ {%
+ \settowidth{\gls@tmplen}{\glstreenamefmt{%
+ \csname @glswidestname\romannumeral##2\endcsname\space}}%
+ }%
+ \ifnum\@gls@prevlevel<##2\relax
+ \setlength\glstreeindent\gls@tmplen
+ \addtolength\glstreeindent\parindent
+ \parindent\glstreeindent
+ \else
+ \ifnum\@gls@prevlevel=0\relax
+ \glsxtrComputeTreeIndent{##2}%
+ \else
+ \ifcsundef{@glswidestname\romannumeral##2}%
+ {%
+ \settowidth{\glstreeindent}{\glstreenamefmt{\@glswidestname\space}}%
+ }%
+ {%
+ \settowidth{\glstreeindent}{\glstreenamefmt{%
+ \csname @glswidestname\romannumeral##2\endcsname\space}}%
+ }%
+ \fi
+ \addtolength\parindent{-\glstreeindent}%
+ \setlength\glstreeindent\parindent
+ \fi
+ \fi
+ \glsxtrAltTreeSetSubHangIndent{##2}%
+ \glsalttreesubgroupheader{##1}{##2}{##3}{##4}%
+ {\glsnavhypertarget{##4}{\glsxtr@grptitle}}{\gls@tmplen}%
+ \def\@gls@prevlevel{##2}%
+ \par
+ }%
}
}%
{%
}
% \end{macrocode}
%
-%\section{Multicolumn Styles}
+%\subsection{Multicolumn Styles}
%Adjust \glostyle{mcolindexgroup} to discourage page breaks after
%the group headings.
%\changes{1.21}{2017-11-03}{redefined \texttt{mcolindexgroup} to discourage
@@ -35497,12 +46191,25 @@ defined}{}%
{%
\renewglossarystyle{mcolindexgroup}{%
\setglossarystyle{mcolindex}%
+% \end{macrocode}
+% Group heading as \glostyle{indexgroup}.
+% \begin{macrocode}
\renewcommand*{\glsgroupheading}[1]{%
\glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
\glstreePreHeader{##1}{\glsxtr@grptitle}%
\item\glstreegroupheaderfmt{\glsxtr@grptitle}%
\glstreegroupheaderskip\@afterheading
}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{%
+ \glsxtrgetgrouptitle{##4}{\glsxtr@grptitle}%
+ \glstreeSubPreHeader{##1}{##2}{##3}{##4}{\glsxtr@grptitle}%
+ \glsindexsubgroupitem{##1}{##2}{##3}{##4}{\glsxtr@grptitle}%
+ \@afterheading
+ }%
}
}%
{%
@@ -35523,6 +46230,9 @@ defined}{}%
% \begin{macrocode}
\glstreegroupheaderskip\@afterheading
}%
+% \end{macrocode}
+% Group heading.
+% \begin{macrocode}
\renewcommand*{\glsgroupheading}[1]{%
\glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
\glstreePreHeader{##1}{\glsxtr@grptitle}%
@@ -35530,6 +46240,17 @@ defined}{}%
{\glsnavhypertarget{##1}{\glsxtr@grptitle}}%
\glstreegroupheaderskip\@afterheading
}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{%
+ \glsxtrgetgrouptitle{##4}{\glsxtr@grptitle}%
+ \glstreeSubPreHeader{##1}{##2}{##3}{##4}{\glsxtr@grptitle}%
+ \glsindexsubgroupitem{##1}{##2}{##3}{##4}%
+ {\glsnavhypertarget{##4}{\glsxtr@grptitle}}%
+ \@afterheading
+ }%
}
}%
{%
@@ -35550,6 +46271,9 @@ defined}{}%
\setlength{\parskip}{0pt plus 0.3pt}%
\let\item\glstreeitem}%
{\end{multicols}}%
+% \end{macrocode}
+% Group heading.
+% \begin{macrocode}
\renewcommand*{\glsgroupheading}[1]{%
\glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
\glstreePreHeader{##1}{\glsxtr@grptitle}%
@@ -35557,6 +46281,17 @@ defined}{}%
{\glsnavhypertarget{##1}{\glsxtr@grptitle}}%
\glstreegroupheaderskip\@afterheading
}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{%
+ \glsxtrgetgrouptitle{##4}{\glsxtr@grptitle}%
+ \glstreeSubPreHeader{##1}{##2}{##3}{##4}{\glsxtr@grptitle}%
+ \glsindexsubgroupitem{##1}{##2}{##3}{##4}%
+ {\glsnavhypertarget{##4}{\glsxtr@grptitle}}%
+ \@afterheading
+ }%
}
}%
{%
@@ -35570,12 +46305,24 @@ defined}{}%
{%
\renewglossarystyle{mcoltreegroup}{%
\setglossarystyle{mcoltree}%
+% \end{macrocode}
+% Group heading.
+% \begin{macrocode}
\renewcommand{\glsgroupheading}[1]{%
\glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
\glstreePreHeader{##1}{\glsxtr@grptitle}%
\par\noindent\glstreegroupheaderfmt{\glsxtr@grptitle}%
\glstreegroupheaderskip\@afterheading
}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{%
+ \glsxtrgetgrouptitle{##4}{\glsxtr@grptitle}%
+ \glstreeSubPreHeader{##1}{##2}{##3}{##4}{\glsxtr@grptitle}%
+ \glstreesubgroupitem{##1}{##2}{##3}{##4}{\glsxtr@grptitle}%
+ }%
}
}%
{%
@@ -35593,6 +46340,9 @@ defined}{}%
\par\noindent\glstreenavigationfmt{\glsnavigation}%
\glstreegroupheaderskip
}%
+% \end{macrocode}
+% Group heading.
+% \begin{macrocode}
\renewcommand*{\glsgroupheading}[1]{%
\glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
\glstreePreHeader{##1}{\glsxtr@grptitle}%
@@ -35600,6 +46350,16 @@ defined}{}%
\glstreegroupheaderfmt{\glsnavhypertarget{##1}{\glsxtr@grptitle}}%
\glstreegroupheaderskip\@afterheading
}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{%
+ \glsxtrgetgrouptitle{##4}{\glsxtr@grptitle}%
+ \glstreeSubPreHeader{##1}{##2}{##3}{##4}{\glsxtr@grptitle}%
+ \glstreesubgroupitem{##1}{##2}{##3}{##4}%
+ {\glsnavhypertarget{##4}{\glsxtr@grptitle}}%
+ }%
}
}%
{%
@@ -35621,6 +46381,9 @@ defined}{}%
\setlength{\parskip}{0pt plus 0.3pt}%
}%
{\end{multicols}}%
+% \end{macrocode}
+% Group heading.
+% \begin{macrocode}
\renewcommand*{\glsgroupheading}[1]{%
\glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
\glstreePreHeader{##1}{\glsxtr@grptitle}%
@@ -35628,6 +46391,16 @@ defined}{}%
\glstreegroupheaderfmt{\glsnavhypertarget{##1}{\glsxtr@grptitle}}%
\glstreegroupheaderskip\@afterheading
}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{%
+ \glsxtrgetgrouptitle{##4}{\glsxtr@grptitle}%
+ \glstreeSubPreHeader{##1}{##2}{##3}{##4}{\glsxtr@grptitle}%
+ \glstreesubgroupitem{##1}{##2}{##3}{##4}%
+ {\glsnavhypertarget{##4}{\glsxtr@grptitle}}%
+ }%
}
}%
{%
@@ -35636,6 +46409,8 @@ defined}{}%
%Similarly for \glostyle{mcoltreenonamegroup}.
%\changes{1.21}{2017-11-03}{redefined \texttt{mcoltreenonamegroup} to discourage
%breaks after group headings}
+%There are no sub-groups for this style as it doesn't show the name
+%of the child entries.
% \begin{macrocode}
\ifdef{\@glsstyle@mcoltreenonamegroup}
{%
@@ -35742,6 +46517,52 @@ defined}{}%
\glstreegroupheaderfmt{\glsxtr@grptitle}%
\glstreegroupheaderskip
}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{%
+ \glsxtrgetgrouptitle{##4}{\glsxtr@grptitle}%
+ \glstreeSubPreHeader{##1}{##2}{##3}{##4}{\glsxtr@grptitle}%
+% \end{macrocode}
+%This is similar to \cs{subglossentry}
+% \begin{macrocode}
+ \ifnum\@gls@prevlevel=##2\relax
+ \else
+ \ifcsundef{@glswidestname\romannumeral##2}%
+ {%
+ \settowidth{\gls@tmplen}{\glstreenamefmt{\@glswidestname\space}}%
+ }%
+ {%
+ \settowidth{\gls@tmplen}{\glstreenamefmt{%
+ \csname @glswidestname\romannumeral##2\endcsname\space}}%
+ }%
+ \ifnum\@gls@prevlevel<##2\relax
+ \setlength\glstreeindent\gls@tmplen
+ \addtolength\glstreeindent\parindent
+ \parindent\glstreeindent
+ \else
+ \ifnum\@gls@prevlevel=0\relax
+ \glsxtrComputeTreeIndent{##2}%
+ \else
+ \ifcsundef{@glswidestname\romannumeral##2}%
+ {%
+ \settowidth{\glstreeindent}{\glstreenamefmt{\@glswidestname\space}}%
+ }%
+ {%
+ \settowidth{\glstreeindent}{\glstreenamefmt{%
+ \csname @glswidestname\romannumeral##2\endcsname\space}}%
+ }%
+ \fi
+ \addtolength\parindent{-\glstreeindent}%
+ \setlength\glstreeindent\parindent
+ \fi
+ \fi
+ \glsxtrAltTreeSetSubHangIndent{##2}%
+ \glsalttreesubgroupheader{##1}{##2}{##3}{##4}{\glsxtr@grptitle}{\gls@tmplen}%
+ \def\@gls@prevlevel{##2}%
+ \par
+ }%
}
}%
{%
@@ -35773,6 +46594,53 @@ defined}{}%
\glstreegroupheaderfmt{\glsnavhypertarget{##1}{\glsxtr@grptitle}}%
\glstreegroupheaderskip
}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{%
+ \glsxtrgetgrouptitle{##4}{\glsxtr@grptitle}%
+ \glstreeSubPreHeader{##1}{##2}{##3}{##4}{\glsxtr@grptitle}%
+% \end{macrocode}
+%This is similar to \cs{subglossentry}
+% \begin{macrocode}
+ \ifnum\@gls@prevlevel=##2\relax
+ \else
+ \ifcsundef{@glswidestname\romannumeral##2}%
+ {%
+ \settowidth{\gls@tmplen}{\glstreenamefmt{\@glswidestname\space}}%
+ }%
+ {%
+ \settowidth{\gls@tmplen}{\glstreenamefmt{%
+ \csname @glswidestname\romannumeral##2\endcsname\space}}%
+ }%
+ \ifnum\@gls@prevlevel<##2\relax
+ \setlength\glstreeindent\gls@tmplen
+ \addtolength\glstreeindent\parindent
+ \parindent\glstreeindent
+ \else
+ \ifnum\@gls@prevlevel=0\relax
+ \glsxtrComputeTreeIndent{##2}%
+ \else
+ \ifcsundef{@glswidestname\romannumeral##2}%
+ {%
+ \settowidth{\glstreeindent}{\glstreenamefmt{\@glswidestname\space}}%
+ }%
+ {%
+ \settowidth{\glstreeindent}{\glstreenamefmt{%
+ \csname @glswidestname\romannumeral##2\endcsname\space}}%
+ }%
+ \fi
+ \addtolength\parindent{-\glstreeindent}%
+ \setlength\glstreeindent\parindent
+ \fi
+ \fi
+ \glsxtrAltTreeSetSubHangIndent{##2}%
+ \glsalttreesubgroupheader{##1}{##2}{##3}{##4}%
+ {\glsnavhypertarget{##4}{\glsxtr@grptitle}}{\gls@tmplen}%
+ \def\@gls@prevlevel{##2}%
+ \par
+ }%
}
}%
{%
@@ -35804,6 +46672,53 @@ defined}{}%
\glstreegroupheaderfmt{\glsnavhypertarget{##1}{\glsxtr@grptitle}}%
\glstreegroupheaderskip
}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{%
+ \glsxtrgetgrouptitle{##4}{\glsxtr@grptitle}%
+ \glstreeSubPreHeader{##1}{##2}{##3}{##4}{\glsxtr@grptitle}%
+% \end{macrocode}
+%This is similar to \cs{subglossentry}
+% \begin{macrocode}
+ \ifnum\@gls@prevlevel=##2\relax
+ \else
+ \ifcsundef{@glswidestname\romannumeral##2}%
+ {%
+ \settowidth{\gls@tmplen}{\glstreenamefmt{\@glswidestname\space}}%
+ }%
+ {%
+ \settowidth{\gls@tmplen}{\glstreenamefmt{%
+ \csname @glswidestname\romannumeral##2\endcsname\space}}%
+ }%
+ \ifnum\@gls@prevlevel<##2\relax
+ \setlength\glstreeindent\gls@tmplen
+ \addtolength\glstreeindent\parindent
+ \parindent\glstreeindent
+ \else
+ \ifnum\@gls@prevlevel=0\relax
+ \glsxtrComputeTreeIndent{##2}%
+ \else
+ \ifcsundef{@glswidestname\romannumeral##2}%
+ {%
+ \settowidth{\glstreeindent}{\glstreenamefmt{\@glswidestname\space}}%
+ }%
+ {%
+ \settowidth{\glstreeindent}{\glstreenamefmt{%
+ \csname @glswidestname\romannumeral##2\endcsname\space}}%
+ }%
+ \fi
+ \addtolength\parindent{-\glstreeindent}%
+ \setlength\glstreeindent\parindent
+ \fi
+ \fi
+ \glsxtrAltTreeSetSubHangIndent{##2}%
+ \glsalttreesubgroupheader{##1}{##2}{##3}{##4}%
+ {\glsnavhypertarget{##4}{\glsxtr@grptitle}}{\gls@tmplen}%
+ \def\@gls@prevlevel{##2}%
+ \par
+ }%
}
}%
{%
@@ -35827,12 +46742,19 @@ defined}{}%
%<*glossary-bookindex.sty>
% \end{macrocode}
%\fi
-%\chapter{bookindex style (\styfmt{glossary-bookindex.sty})}
+%\section{bookindex style (\sty{glossary-bookindex.sty})}
%\changes{1.21}{2017-11-03}{new}
-%\section{Package Initialisation and Options}
% \begin{macrocode}
\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{glossary-bookindex}[2021/11/22 v1.48 (NLCT)]
+% \end{macrocode}
+% Rollback releases:
+% \begin{macrocode}
+\DeclareRelease{v1.48}{2021-11-22}{glossary-bookindex-2021-11-22.sty}
+\DeclareCurrentRelease{v1.49}{2022-10-14}
+% \end{macrocode}
+% Declare package:
+% \begin{macrocode}
+\ProvidesPackage{glossary-bookindex}[2022/10/14 v1.49 (NLCT)]
% \end{macrocode}
%Load required packages.
% \begin{macrocode}
@@ -35957,7 +46879,7 @@ defined}{}%
%\end{macro}
%\begin{macro}{\glsxtrbookindexatendgroup}
%\changes{1.21}{2017-11-03}{new}
-%At the end of a letter group. The argument is the index of the last
+%At the end of a letter group. The argument is the label of the last
%top-level entry.
% \begin{macrocode}
\newcommand{\glsxtrbookindexatendgroup}[1]{}
@@ -35965,7 +46887,7 @@ defined}{}%
%\end{macro}
%\begin{macro}{\glsxtrbookindexsubatendgroup}
%\changes{1.21}{2017-11-03}{new}
-%At the end of a letter group. The argument is the index of the last
+%At the end of a letter group. The argument is the label of the last
%level~1 entry.
% \begin{macrocode}
\newcommand{\glsxtrbookindexsubatendgroup}[1]{}
@@ -35973,7 +46895,7 @@ defined}{}%
%\end{macro}
%\begin{macro}{\glsxtrbookindexsubsubatendgroup}
%\changes{1.21}{2017-11-03}{new}
-%At the end of a letter group. The argument is the index of the last
+%At the end of a letter group. The argument is the label of the last
%level~2 entry.
% \begin{macrocode}
\newcommand{\glsxtrbookindexsubsubatendgroup}[1]{}
@@ -35988,16 +46910,70 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtrbookindexpregroupskip}
+%\changes{1.49}{2022-10-14}{new}
+%After group header. The argument is the skip that would normally
+%be inserted if there wasn't a group header.
+% \begin{macrocode}
+\newcommand{\glsxtrbookindexpregroupskip}[1]{#1}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrbookindexpostgroupskip}
+%\changes{1.49}{2022-10-14}{new}
+%After group header.
+% \begin{macrocode}
+\newcommand{\glsxtrbookindexpostgroupskip}{\indexspace}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrbookindexpresubgroupskip}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glsxtrbookindexpresubgroupskip}\marg{default}\marg{prev group
+%level}\marg{group level}
+%\end{definition}
+%Before sub-group separator.
+%The first argument is the skip that would normally be used at this
+%point if there wasn't a header.
+% \begin{macrocode}
+\newcommand{\glsxtrbookindexpresubgroupskip}[3]{\par\medskip}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glsxtrbookindexpostsubgroupskip}
+%\changes{1.49}{2022-10-14}{new}
+%After sub-group separator.
+% \begin{macrocode}
+\newcommand{\glsxtrbookindexpostsubgroupskip}[2]{\par\medskip}
+% \end{macrocode}
+%\end{macro}
+%
%Format group title.
%\begin{macro}{\glsxtrbookindexformatheader}
%\changes{1.21}{2017-11-03}{new}
-%Group separator.
+%Group header.
% \begin{macrocode}
\newcommand*{\glsxtrbookindexformatheader}[1]{%
\par{\centering\glstreegroupheaderfmt{#1}\par}%
}
% \end{macrocode}
%\end{macro}
+%Format sub-group title.
+%\begin{macro}{\glsxtrbookindexformatsubheader}
+%\changes{1.49}{2022-10-14}{new}
+%Sub-group header. This defaults to the same format as the
+%top-level group.
+% \begin{macrocode}
+\newcommand*{\glsxtrbookindexformatsubheader}[5]{%
+ \ifnum#2>1\relax
+ \glstreesubsubitem\glstreegroupheaderfmt{#5}%
+ \else
+ \glstreesubitem\glstreegroupheaderfmt{#5}%
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
%\begin{macro}{\glsxtrbookindexbookmark}
%\changes{1.21}{2017-11-03}{new}
%Book mark group heading if supported.
@@ -36016,6 +46992,24 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glsxtrbookindexsubbookmark}
+%\changes{1.49}{2022-10-14}{new}
+%Book mark sub-group heading if supported.
+% \begin{macrocode}
+\ifdef\pdfbookmark
+{%
+ \newcommand*{\glsxtrbookindexsubbookmark}[3]{%
+ \ifdefstring{\@@glossarysec}{chapter}%
+ {\expandafter\pdfbookmark\expandafter[\number\numexpr#1+1]{#3}{#2}}%
+ {\expandafter\pdfbookmark\expandafter[\number\numexpr#1+2]{#3}{#2}}%
+ }
+}
+{%
+ \newcommand*{\glsxtrbookindexsubbookmark}[3]{}
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glsxtrbookindexbookmarkprefix}
%\changes{1.42}{2020-02-03}{new}
%Make the bookmark label prefix used for letter groups depend on the glossary label
@@ -36039,6 +47033,7 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{style}{bookindex}
%Define the style.
% \begin{macrocode}
\newglossarystyle{bookindex}{%
@@ -36114,10 +47109,15 @@ defined}{}%
\let\@glsxtr@bookindex@subsep\glsxtrbookindexparentsubchildsep
\let\@glsxtr@bookindex@subbetween\@gobble
\let\@glsxtr@bookindex@subsubbetween\@gobble
- \edef\@glsxtr@bookindex@between{%
+% \end{macrocode}
+%The second argument of \cs{glsxtrbookindexbetween} will be supplied
+%as the argument to \cs{@glsxtr@bookindex@between}.
+%\changes{1.49}{2022-10-14}{replaced \cs{edef} with \cs{protected@edef}}
+% \begin{macrocode}
+ \protected@edef\@glsxtr@bookindex@between{%
\noexpand\glsxtrbookindexbetween{##1}%
}%
- \edef\@glsxtr@bookindex@atendgroup{%
+ \protected@edef\@glsxtr@bookindex@atendgroup{%
\noexpand\glsxtrbookindexatendgroup{##1}%
}%
\let\@glsxtr@bookindex@subatendgroup\relax
@@ -36203,7 +47203,7 @@ defined}{}%
\@glsxtr@bookindex@subsubatendgroup
\@glsxtr@bookindex@subatendgroup
\@glsxtr@bookindex@atendgroup
- \@glsxtr@bookindexgroupskip
+ \glsxtrbookindexpregroupskip\@glsxtr@bookindexgroupskip
% \end{macrocode}
% Update separators.
% \begin{macrocode}
@@ -36226,10 +47226,45 @@ defined}{}%
% Format the group title.
% \begin{macrocode}
\glsxtrbookindexformatheader{\glsxtrcurrentgrptitle}%
- \nopagebreak\indexspace\nopagebreak\@afterheading
+ \nopagebreak\glsxtrbookindexpostgroupskip\nopagebreak\@afterheading
}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}[4]{%
+% \end{macrocode}
+% Do end group hooks.
+% \begin{macrocode}
+ \@glsxtr@bookindex@subsubatendgroup
+ \@glsxtr@bookindex@subatendgroup
+ \@glsxtr@bookindex@atendgroup
+ \glsxtrbookindexpresubgroupskip\@glsxtr@bookindexgroupskip{##1}{##2}%
+% \end{macrocode}
+% Update separators.
+% \begin{macrocode}
+ \let\@glsxtr@bookindexgroupskip\glsxtrbookindexgroupskip
+ \let\@glsxtr@bookindex@between\@gobble
+ \let\@glsxtr@bookindex@atendgroup\relax
+ \let\@glsxtr@bookindex@subatendgroup\relax
+ \let\@glsxtr@bookindex@subsubatendgroup\relax
+% \end{macrocode}
+% Get group title.
+% \begin{macrocode}
+ \glsxtrgetgrouptitle{##4}{\glsxtrcurrentgrptitle}%
+% \end{macrocode}
+% Do the PDF bookmark if supported.
+% \begin{macrocode}
+ \glsxtrbookindexsubbookmark{##2}{##4}{\glsxtrcurrentgrptitle}%
+% \end{macrocode}
+% Format the group title.
+% \begin{macrocode}
+ \glsxtrbookindexformatsubheader{##1}{##2}{##3}{##4}{\glsxtrcurrentgrptitle}%
+ \nopagebreak\glsxtrbookindexpostsubgroupskip{##1}{##2}\nopagebreak\@afterheading
+ }
}
% \end{macrocode}
+%\end{style}
% Some supplementary commands that may be useful.
% These store the entry label for the current page. Since the page
% number is needed in the control sequence, this uses
@@ -36322,13 +47357,20 @@ defined}{}%
%<*glossary-longextra.sty>
% \end{macrocode}
%\fi
-%\chapter{longextra styles (\styfmt{glossary-longextra.sty})}
+%\section{longextra styles (\sty{glossary-longextra.sty})}
%\changes{1.37}{2018-11-30}{new}
-%\section{Package Initialisation and Options}
%Provides additional long styles.
% \begin{macrocode}
\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{glossary-longextra}[2021/11/22 v1.48 (NLCT)]
+% \end{macrocode}
+% Rollback releases:
+% \begin{macrocode}
+\DeclareRelease{v1.48}{2021-11-22}{glossary-longextra-2021-11-22.sty}
+\DeclareCurrentRelease{v1.49}{2022-10-14}
+% \end{macrocode}
+% Declare package:
+% \begin{macrocode}
+\ProvidesPackage{glossary-longextra}[2022/10/14 v1.49 (NLCT)]
% \end{macrocode}
%Load required packages.
% \begin{macrocode}
@@ -36373,6 +47415,35 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glslongextraSymbolTargetFmt}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glslongextraSymbolTargetFmt}\marg{label}
+%\end{definition}
+%Governs the way the symbol is displayed if it needs to include the
+%target.
+% \begin{macrocode}
+\newcommand{\glslongextraSymbolTargetFmt}[1]{%
+ \glsentryitem{#1}\glstarget{#1}{\glslongextraSymbolFmt{#1}}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glslongextraSymbolOrName}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glslongextraSymbolOrName}\marg{label}
+%\end{definition}
+%Governs the way the symbol is displayed if it needs to include the
+%target.
+% \begin{macrocode}
+\newcommand{\glslongextraSymbolOrName}[1]{%
+ \ifglshassymbol{#1}%
+ {\glslongextraSymbolTargetFmt{#1}}%
+ {\glslongextraNameFmt{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glslongextraLocationFmt}
%\changes{1.37}{2018-11-30}{new}
%\begin{definition}
@@ -36384,6 +47455,34 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glslongextraShortTargetFmt}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glslongextraShortTargetFmt}\marg{label}
+%\end{definition}
+%Governs the way the short form is displayed if it needs to include the
+%target.
+% \begin{macrocode}
+\newcommand{\glslongextraShortTargetFmt}[1]{%
+ \glsentryitem{#1}\glstarget{#1}{{\glsxtrshort[noindex,hyper=false]{#1}}}%
+ \glsxtrpostnamehook{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glslongextraLongFmt}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glslongextraLongFmt}\marg{label}
+%\end{definition}
+%Governs the way the long form is displayed.
+% \begin{macrocode}
+\newcommand{\glslongextraLongFmt}[1]{%
+ {\glsxtrlong[noindex,hyper=false]{#1}}\glspostdescription
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glslongextraSubNameFmt}
%\changes{1.37}{2018-11-30}{new}
%\begin{definition}
@@ -36424,6 +47523,62 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glslongextraSubSymbolTargetFmt}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glslongextraSubSymbolTargetFmt}\marg{level}\marg{label}
+%\end{definition}
+%Governs the way the child symbol is displayed if the target is
+%required.
+% \begin{macrocode}
+\newcommand{\glslongextraSubSymbolTargetFmt}[2]{%
+ \glssubentryitem{#2}\glstarget{#2}{\glslongextraSymbolFmt{#2}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glslongextraSubSymbolOrName}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glslongextraSubSymbolOrName}\marg{level}\marg{label}
+%\end{definition}
+%Shows the symbol or the name (if the symbol isn't set) as the
+%target for sub-entries.
+% \begin{macrocode}
+\newcommand{\glslongextraSubSymbolOrName}[2]{%
+ \ifglshassymbol{#2}%
+ {\glslongextraSubSymbolTargetFmt{#1}{#2}}%
+ {\glslongextraSubNameFmt{#1}{#2}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glslongextraSubShortTargetFmt}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glslongextraSubShortTargetFmt}\marg{level}\marg{label}
+%\end{definition}
+%Governs the way the short form is displayed if it needs to include the
+%target.
+% \begin{macrocode}
+\newcommand{\glslongextraSubShortTargetFmt}[2]{%
+ \glssubentryitem{#2}\glstarget{#2}{{\glsxtrshort[noindex,hyper=false]{#2}}}%
+ \glsxtrpostnamehook{#2}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glslongextraSubLongFmt}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glslongextraSubLongFmt}\marg{label}
+%\end{definition}
+%Governs the way the long form is displayed.
+% \begin{macrocode}
+\newcommand{\glslongextraSubLongFmt}[2]{\glslongextraLongFmt{#2}}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glslongextraSubLocationFmt}
%\changes{1.37}{2018-11-30}{new}
%\begin{definition}
@@ -36459,6 +47614,15 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glslongextraSymbolNameAlign}
+%\changes{1.49}{2022-10-14}{new}
+%Alignment for the symbol column when it's being used instead of the
+%name.
+% \begin{macrocode}
+\newcommand{\glslongextraSymbolNameAlign}{l}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glslongextraLocationAlign}
%\changes{1.37}{2018-11-30}{new}
%Alignment for the location column.
@@ -36477,6 +47641,17 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glslongextraSubGroupHeading}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glslongextraSubGroupHeading}\marg{number of columns}\marg{prev group level}\marg{group
+%level}\marg{parent entry}\marg{group label}
+%\end{definition}
+% \begin{macrocode}
+\newcommand*{\glslongextraSubGroupHeading}[5]{}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glslongextraHeaderFormat}
%\changes{1.37}{2018-11-30}{new}
%Format for the column headers.
@@ -36615,6 +47790,25 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glslongextraSymNoNameSetDescWidth}
+%\changes{1.49}{2022-10-14}{new}
+% Computes the value of \cs{glsdescwidth} for the styles that only
+% have symbol and description columns.
+% \begin{macrocode}
+\newcommand{\glslongextraSymNoNameSetDescWidth}{%
+% \end{macrocode}
+% Now work out the symbol column width. This is assuming that the
+% column title will be the widest text in the column.
+% \begin{macrocode}
+ \settowidth{\gls@tmplen}{\glslongextraHeaderFmt\symbolname}%
+% \end{macrocode}
+% Subtract 4\cs{tabcolsep} and the symbol header width.
+% \begin{macrocode}
+ \setlength{\glsdescwidth}{\dimexpr\linewidth-4\tabcolsep-\gls@tmplen}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\glslongextraLocSetDescWidth}
%\changes{1.37}{2018-11-30}{new}
% Computes the value of \cs{glsdescwidth} for the styles that only
@@ -36651,6 +47845,26 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
+%\begin{macro}{\glslongextraShortNoNameSetDescWidth}
+%\changes{1.49}{2022-10-14}{new}
+% Computes the value of \cs{glsdescwidth} for the styles that only
+% have short and long columns. The long form will essentially be
+% treated like a description column.
+% \begin{macrocode}
+\newcommand{\glslongextraShortNoNameSetDescWidth}{%
+% \end{macrocode}
+% Now work out the short column width. This is assuming that the
+% column title will be the widest text in the column.
+% \begin{macrocode}
+ \settowidth{\gls@tmplen}{\glslongextraHeaderFmt\glslongextraShortHeader}%
+% \end{macrocode}
+% Subtract 4\cs{tabcolsep} and the above header width.
+% \begin{macrocode}
+ \setlength{\glsdescwidth}{\dimexpr\linewidth-4\tabcolsep-\gls@tmplen}%
+}
+% \end{macrocode}
+%\end{macro}
+%
%\begin{macro}{\ifGlsLongExtraUseTabular}
%\changes{1.37}{2018-11-30}{new}
%If true use \env{tabular} instead of \env{longtable}. Obviously
@@ -36668,7 +47882,7 @@ defined}{}%
\newcommand*{\glslongextraTabularVAlign}{c}
% \end{macrocode}
%\end{macro}
-%\begin{abbrvstyle}{long-name-desc}
+%\begin{style}{long-name-desc}
%\changes{1.37}{2018-11-30}{new}
%Two column style with multi-lined descriptions and header.
%This is similar to the \glostyle{longragged-booktabs} style.
@@ -36705,10 +47919,21 @@ defined}{}%
\renewcommand*{\glossaryheader}{\glslongextraNameDescHeader}%
\fi
\renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{2}{##1}}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}{\glslongextraSubGroupHeading{2}}%
+% \end{macrocode}
+%Top-level entry.
+% \begin{macrocode}
\renewcommand{\glossentry}[2]{%
\glslongextraNameFmt{##1} &
\glslongextraDescFmt{##1}\tabularnewline
}%
+% \end{macrocode}
+%Child entry.
+% \begin{macrocode}
\renewcommand{\subglossentry}[3]{%
\glslongextraSubNameFmt{##1}{##2}
&
@@ -36722,7 +47947,7 @@ defined}{}%
\fi
}
% \end{macrocode}
-%\end{abbrvstyle}
+%\end{style}
%
%\begin{macro}{\glslongextraNameDescLocationHeader}
%\changes{1.37}{2018-11-30}{new}
@@ -36756,7 +47981,7 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
-%\begin{abbrvstyle}{long-name-desc-loc}
+%\begin{style}{long-name-desc-loc}
%\changes{1.37}{2018-11-30}{new}
%Three columns: name, description and location list.
% \begin{macrocode}
@@ -36796,6 +48021,11 @@ defined}{}%
\renewcommand*{\glossaryheader}{\glslongextraNameDescLocationHeader}%
\fi
\renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{3}{##1}}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}{\glslongextraSubGroupHeading{3}}%
\renewcommand{\glossentry}[2]{%
\glslongextraNameFmt{##1} &
\glslongextraDescFmt{##1} &
@@ -36814,7 +48044,7 @@ defined}{}%
\fi
}
% \end{macrocode}
-%\end{abbrvstyle}
+%\end{style}
%
%\begin{macro}{\glslongextraDescNameHeader}
%\changes{1.37}{2018-11-30}{new}
@@ -36847,7 +48077,7 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
-%\begin{abbrvstyle}{long-desc-name}
+%\begin{style}{long-desc-name}
%\changes{1.37}{2018-11-30}{new}
%Like \glostyle{name-desc} but swaps the columns.
% \begin{macrocode}
@@ -36883,6 +48113,11 @@ defined}{}%
\renewcommand*{\glossaryheader}{\glslongextraDescNameHeader}%
\fi
\renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{2}{##1}}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}{\glslongextraSubGroupHeading{2}}%
\renewcommand{\glossentry}[2]{%
\glslongextraDescFmt{##1} &
\glslongextraNameFmt{##1}\tabularnewline
@@ -36898,7 +48133,7 @@ defined}{}%
\fi
}
% \end{macrocode}
-%\end{abbrvstyle}
+%\end{style}
%
%\begin{macro}{\glslongextraLocationDescNameHeader}
%\changes{1.37}{2018-11-30}{new}
@@ -36932,7 +48167,7 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
-%\begin{abbrvstyle}{long-loc-desc-name}
+%\begin{style}{long-loc-desc-name}
%\changes{1.37}{2018-11-30}{new}
%Three columns: location, description and name.
% \begin{macrocode}
@@ -36969,6 +48204,11 @@ defined}{}%
\renewcommand*{\glossaryheader}{\glslongextraLocationDescNameHeader}%
\fi
\renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{3}{##1}}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}{\glslongextraSubGroupHeading{3}}%
\renewcommand{\glossentry}[2]{%
\glslongextraLocationFmt{##1}{##2} &
\glslongextraDescFmt{##1} &
@@ -36986,7 +48226,7 @@ defined}{}%
\fi
}
% \end{macrocode}
-%\end{abbrvstyle}
+%\end{style}
%
%\begin{macro}{\glslongextraNameDescSymHeader}
%\changes{1.37}{2018-11-30}{new}
@@ -37020,7 +48260,7 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
-%\begin{abbrvstyle}{long-name-desc-sym}
+%\begin{style}{long-name-desc-sym}
%\changes{1.37}{2018-11-30}{new}
%Three column style with symbol in the third column.
% \begin{macrocode}
@@ -37060,6 +48300,11 @@ defined}{}%
\renewcommand*{\glossaryheader}{\glslongextraNameDescSymHeader}%
\fi
\renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{3}{##1}}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}{\glslongextraSubGroupHeading{3}}%
\renewcommand{\glossentry}[2]{%
\glslongextraNameFmt{##1} &
\glslongextraDescFmt{##1} &
@@ -37078,7 +48323,7 @@ defined}{}%
\fi
}
% \end{macrocode}
-%\end{abbrvstyle}
+%\end{style}
%
%\begin{macro}{\glslongextraNameDescSymLocationHeader}
%\changes{1.37}{2018-11-30}{new}
@@ -37113,7 +48358,7 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
-%\begin{abbrvstyle}{long-name-desc-sym-loc}
+%\begin{style}{long-name-desc-sym-loc}
%\changes{1.37}{2018-11-30}{new}
%Four columns: name, description and location
% \begin{macrocode}
@@ -37155,6 +48400,11 @@ defined}{}%
\renewcommand*{\glossaryheader}{\glslongextraNameDescSymLocationHeader}%
\fi
\renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{4}{##1}}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}{\glslongextraSubGroupHeading{4}}%
\renewcommand{\glossentry}[2]{%
\glslongextraNameFmt{##1} &
\glslongextraDescFmt{##1} &
@@ -37175,7 +48425,7 @@ defined}{}%
\fi
}
% \end{macrocode}
-%\end{abbrvstyle}
+%\end{style}
%
%\begin{macro}{\glslongextraNameSymDescHeader}
%\changes{1.37}{2018-11-30}{new}
@@ -37209,7 +48459,7 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
-%\begin{abbrvstyle}{long-name-sym-desc}
+%\begin{style}{long-name-sym-desc}
%\changes{1.37}{2018-11-30}{new}
%Three column style with symbol in the second column.
% \begin{macrocode}
@@ -37249,6 +48499,11 @@ defined}{}%
\renewcommand*{\glossaryheader}{\glslongextraNameSymDescHeader}%
\fi
\renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{3}{##1}}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}{\glslongextraSubGroupHeading{3}}%
\renewcommand{\glossentry}[2]{%
\glslongextraNameFmt{##1} &
\glslongextraSymbolFmt{##1} &
@@ -37266,7 +48521,7 @@ defined}{}%
\fi
}
% \end{macrocode}
-%\end{abbrvstyle}
+%\end{style}
%
%\begin{macro}{\glslongextraNameSymDescLocationHeader}
%\changes{1.37}{2018-11-30}{new}
@@ -37301,7 +48556,7 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
-%\begin{abbrvstyle}{long-name-sym-desc-loc}
+%\begin{style}{long-name-sym-desc-loc}
%\changes{1.37}{2018-11-30}{new}
%Four column style with symbol in the second column.
% \begin{macrocode}
@@ -37343,6 +48598,11 @@ defined}{}%
\renewcommand*{\glossaryheader}{\glslongextraNameSymDescLocationHeader}%
\fi
\renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{4}{##1}}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}{\glslongextraSubGroupHeading{4}}%
\renewcommand{\glossentry}[2]{%
\glslongextraNameFmt{##1} &
\glslongextraSymbolFmt{##1} &
@@ -37362,7 +48622,7 @@ defined}{}%
\fi
}
% \end{macrocode}
-%\end{abbrvstyle}
+%\end{style}
%
%\begin{macro}{\glslongextraSymDescNameHeader}
%\changes{1.37}{2018-11-30}{new}
@@ -37396,7 +48656,7 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
-%\begin{abbrvstyle}{long-sym-desc-name}
+%\begin{style}{long-sym-desc-name}
%\changes{1.37}{2018-11-30}{new}
%Three column style with symbol in the first column, description in
%the second and name in the third.
@@ -37437,6 +48697,11 @@ defined}{}%
\renewcommand*{\glossaryheader}{\glslongextraSymDescNameHeader}%
\fi
\renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{3}{##1}}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}{\glslongextraSubGroupHeading{3}}%
\renewcommand{\glossentry}[2]{%
\glslongextraSymbolFmt{##1} &
\glslongextraDescFmt{##1} &
@@ -37454,7 +48719,7 @@ defined}{}%
\fi
}
% \end{macrocode}
-%\end{abbrvstyle}
+%\end{style}
%
%\begin{macro}{\glslongextraLocationSymDescNameHeader}
%\changes{1.37}{2018-11-30}{new}
@@ -37489,7 +48754,7 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
-%\begin{abbrvstyle}{long-loc-sym-desc-name}
+%\begin{style}{long-loc-sym-desc-name}
%\changes{1.37}{2018-11-30}{new}
%Four column style with location list, symbol, description and name.
% \begin{macrocode}
@@ -37531,6 +48796,11 @@ defined}{}%
\renewcommand*{\glossaryheader}{\glslongextraLocationSymDescNameHeader}%
\fi
\renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{4}{##1}}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}{\glslongextraSubGroupHeading{4}}%
\renewcommand{\glossentry}[2]{%
\glslongextraLocationFmt{##1}{##2} &
\glslongextraSymbolFmt{##1} &
@@ -37550,7 +48820,7 @@ defined}{}%
\fi
}
% \end{macrocode}
-%\end{abbrvstyle}
+%\end{style}
%
%\begin{macro}{\glslongextraDescSymNameHeader}
%\changes{1.37}{2018-11-30}{new}
@@ -37584,7 +48854,7 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
-%\begin{abbrvstyle}{long-desc-sym-name}
+%\begin{style}{long-desc-sym-name}
%\changes{1.37}{2018-11-30}{new}
%Three column style with description in the first column, symbol in
%the second and name in the third.
@@ -37625,6 +48895,11 @@ defined}{}%
\renewcommand*{\glossaryheader}{\glslongextraDescSymNameHeader}%
\fi
\renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{3}{##1}}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}{\glslongextraSubGroupHeading{3}}%
\renewcommand{\glossentry}[2]{%
\glslongextraDescFmt{##1} &
\glslongextraSymbolFmt{##1} &
@@ -37642,7 +48917,7 @@ defined}{}%
\fi
}
% \end{macrocode}
-%\end{abbrvstyle}
+%\end{style}
%
%\begin{macro}{\glslongextraLocationDescSymNameHeader}
%\changes{1.37}{2018-11-30}{new}
@@ -37677,7 +48952,7 @@ defined}{}%
% \end{macrocode}
%\end{macro}
%
-%\begin{abbrvstyle}{long-loc-desc-sym-name}
+%\begin{style}{long-loc-desc-sym-name}
%\changes{1.37}{2018-11-30}{new}
%Four column style with location list, description, symbol and name.
% \begin{macrocode}
@@ -37719,6 +48994,11 @@ defined}{}%
\renewcommand*{\glossaryheader}{\glslongextraLocationDescSymNameHeader}%
\fi
\renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{4}{##1}}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}{\glslongextraSubGroupHeading{4}}%
\renewcommand{\glossentry}[2]{%
\glslongextraLocationFmt{##1}{##2} &
\glslongextraDescFmt{##1} &
@@ -37738,7 +49018,411 @@ defined}{}%
\fi
}
% \end{macrocode}
-%\end{abbrvstyle}
+%\end{style}
+%
+%\begin{style}{long-sym-desc}
+%\changes{1.49}{2022-10-14}{new}
+%Two column style with symbol in the first column and description in
+%the second. The name isn't shown unless the symbol is missing.
+% \begin{macrocode}
+\newglossarystyle{long-sym-desc}%
+{%
+ \ifGlsLongExtraUseTabular
+ \renewenvironment{theglossary}%
+ {%
+ \glslongextraSymNoNameSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{tabular}[\glslongextraTabularVAlign]{%
+ \expandonce\glslongextraSymbolNameAlign
+ \expandonce\glslongextraDescAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {%
+ \glslongextraSymDescTabularFooter
+ \end{tabular}%
+ }%
+ \renewcommand*{\glossaryheader}{\glslongextraSymDescTabularHeader}%
+ \else
+ \renewenvironment{theglossary}%
+ {%
+ \glspatchLToutput
+ \glslongextraSymNoNameSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{longtable}{%
+ \expandonce\glslongextraSymbolNameAlign
+ \expandonce\glslongextraDescAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {\end{longtable}}%
+ \renewcommand*{\glossaryheader}{\glslongextraSymDescHeader}%
+ \fi
+ \renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{3}{##1}}%
+% \end{macrocode}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}{\glslongextraSubGroupHeading{3}}%
+ \renewcommand{\glossentry}[2]{%
+ \glslongextraSymbolOrName{##1} &
+ \glslongextraDescFmt{##1}\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ \glslongextraSubSymbolOrName{##1}{##2} &
+ \glslongextraSubDescFmt{##1}{##2}\tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{\glspenaltygroupskip}%
+ \fi
+}
+% \end{macrocode}
+%\end{style}
+%
+%\begin{macro}{\glslongextraSymDescHeader}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glslongextraSymDescHeader}{%
+ \glslongextraSymDescTabularHeader\endhead
+ \glslongextraSymDescTabularFooter\endfoot
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glslongextraSymDescTabularHeader}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glslongextraSymDescTabularHeader}{%
+ \toprule
+ \glslongextraHeaderFmt\symbolname &
+ \glslongextraHeaderFmt\descriptionname\tabularnewline
+ \midrule
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glslongextraSymDescTabularFooter}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glslongextraSymDescTabularFooter}{%
+ \bottomrule
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{style}{long-desc-sym}
+%\changes{1.49}{2022-10-14}{new}
+%Two column style with description in the first column and symbol in
+%the second. The name isn't shown.
+% \begin{macrocode}
+\newglossarystyle{long-desc-sym}%
+{%
+ \ifGlsLongExtraUseTabular
+ \renewenvironment{theglossary}%
+ {%
+ \glslongextraSymNoNameSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{tabular}[\glslongextraTabularVAlign]{%
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraSymbolNameAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {%
+ \glslongextraDescSymTabularFooter
+ \end{tabular}%
+ }%
+ \renewcommand*{\glossaryheader}{\glslongextraDescSymTabularHeader}%
+ \else
+ \renewenvironment{theglossary}%
+ {%
+ \glspatchLToutput
+ \glslongextraSymNoNameSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{longtable}{%
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraSymbolNameAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {\end{longtable}}%
+ \renewcommand*{\glossaryheader}{\glslongextraDescSymHeader}%
+ \fi
+ \renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{3}{##1}}%
+% \end{macrocode}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}{\glslongextraSubGroupHeading{3}}%
+ \renewcommand{\glossentry}[2]{%
+ \glslongextraDescFmt{##1} &
+ \glslongextraSymbolOrName{##1}\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ \glslongextraSubDescFmt{##1}{##2} &
+ \glslongextraSubSymbolOrName{##1}{##2}\tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{\glspenaltygroupskip}%
+ \fi
+}
+% \end{macrocode}
+%\end{style}
+%
+%\begin{macro}{\glslongextraDescSymHeader}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glslongextraDescSymHeader}{%
+ \glslongextraDescSymTabularHeader\endhead
+ \glslongextraDescSymTabularFooter\endfoot
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glslongextraDescSymTabularHeader}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glslongextraDescSymTabularHeader}{%
+ \toprule
+ \glslongextraHeaderFmt\descriptionname &
+ \glslongextraHeaderFmt\symbolname\tabularnewline
+ \midrule
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glslongextraDescSymTabularFooter}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glslongextraDescSymTabularFooter}{%
+ \bottomrule
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{style}{abbr-short-long}
+%\changes{1.49}{2022-10-14}{new}
+%Two column style with the short field in the first column and the
+%long field in the second. The name, symbol and description aren't shown
+%(although the abbreviation style may mean that they will happen to
+%be shown if they are the same as the short or long field).
+% \begin{macrocode}
+\newglossarystyle{abbr-short-long}%
+{%
+ \ifGlsLongExtraUseTabular
+ \renewenvironment{theglossary}%
+ {%
+ \glslongextraShortNoNameSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{tabular}[\glslongextraTabularVAlign]{%
+ \expandonce\glslongextraNameAlign
+ \expandonce\glslongextraDescAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {%
+ \glslongextraShortLongTabularFooter
+ \end{tabular}%
+ }%
+ \renewcommand*{\glossaryheader}{\glslongextraShortLongTabularHeader}%
+ \else
+ \renewenvironment{theglossary}%
+ {%
+ \glspatchLToutput
+ \glslongextraShortNoNameSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{longtable}{%
+ \expandonce\glslongextraNameAlign
+ \expandonce\glslongextraDescAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {\end{longtable}}%
+ \renewcommand*{\glossaryheader}{\glslongextraShortLongHeader}%
+ \fi
+ \renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{3}{##1}}%
+% \end{macrocode}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}{\glslongextraSubGroupHeading{3}}%
+ \renewcommand{\glossentry}[2]{%
+ \ifglshasshort{##1}%
+ {\glslongextraShortTargetFmt{##1}}%
+ {\glslongextraNameFmt{##1}}%
+ &
+ \ifglshaslong{##1}%
+ {\glslongextraLongFmt{##1}}%
+ {\glslongextraDescFmt{##1}}%
+ \tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ \ifglshasshort{##2}%
+ {\glslongextraSubShortTargetFmt{##1}{##2}}%
+ {\glslongextraSubNameFmt{##1}{##2}}%
+ &
+ \ifglshaslong{##2}%
+ {\glslongextraSubLongFmt{##1}{##2}}%
+ {\glslongextraSubDescFmt{##1}{##2}}%
+ \tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{\glspenaltygroupskip}%
+ \fi
+}
+% \end{macrocode}
+%\end{style}
+%
+%\begin{macro}{\glslongextraShortLongHeader}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glslongextraShortLongHeader}{%
+ \glslongextraShortLongTabularHeader\endhead
+ \glslongextraShortLongTabularFooter\endfoot
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glslongextraShortHeader}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glslongextraShortHeader}{\entryname}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\glslongextraLongHeader}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glslongextraLongHeader}{\descriptionname}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\glslongextraShortLongTabularHeader}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glslongextraShortLongTabularHeader}{%
+ \toprule
+ \glslongextraHeaderFmt\glslongextraShortHeader &
+ \glslongextraHeaderFmt\glslongextraLongHeader\tabularnewline
+ \midrule
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glslongextraShortLongTabularFooter}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glslongextraShortLongTabularFooter}{%
+ \bottomrule
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{style}{abbr-long-short}
+%\changes{1.49}{2022-10-14}{new}
+%Two column style with the short field in the first column and the
+%long field in the second. The name, symbol and description aren't shown
+%(although the abbreviation style may mean that they will happen to
+%be shown if they are the same as the short or long field).
+% \begin{macrocode}
+\newglossarystyle{abbr-long-short}%
+{%
+ \ifGlsLongExtraUseTabular
+ \renewenvironment{theglossary}%
+ {%
+ \glslongextraShortNoNameSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{tabular}[\glslongextraTabularVAlign]{%
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraNameAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {%
+ \glslongextraLongShortTabularFooter
+ \end{tabular}%
+ }%
+ \renewcommand*{\glossaryheader}{\glslongextraLongShortTabularHeader}%
+ \else
+ \renewenvironment{theglossary}%
+ {%
+ \glspatchLToutput
+ \glslongextraShortNoNameSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{longtable}{%
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraNameAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {\end{longtable}}%
+ \renewcommand*{\glossaryheader}{\glslongextraLongShortHeader}%
+ \fi
+ \renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{3}{##1}}%
+% \end{macrocode}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}{\glslongextraSubGroupHeading{3}}%
+ \renewcommand{\glossentry}[2]{%
+ \ifglshaslong{##1}%
+ {\glslongextraLongFmt{##1}}%
+ {\glslongextraDescFmt{##1}}%
+ &
+ \ifglshasshort{##1}%
+ {\glslongextraShortTargetFmt{##1}}%
+ {\glslongextraNameFmt{##1}}%
+ \tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ \ifglshaslong{##2}%
+ {\glslongextraSubLongFmt{##1}{##2}}%
+ {\glslongextraSubDescFmt{##1}{##2}}%
+ &
+ \ifglshasshort{##2}%
+ {\glslongextraSubShortTargetFmt{##1}{##2}}%
+ {\glslongextraSubNameFmt{##1}{##2}}%
+ \tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{\glspenaltygroupskip}%
+ \fi
+}
+% \end{macrocode}
+%\end{style}
+%
+%\begin{macro}{\glslongextraLongShortHeader}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glslongextraLongShortHeader}{%
+ \glslongextraLongShortTabularHeader\endhead
+ \glslongextraLongShortTabularFooter\endfoot
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glslongextraLongShortTabularHeader}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glslongextraLongShortTabularHeader}{%
+ \toprule
+ \glslongextraHeaderFmt\glslongextraLongHeader &
+ \glslongextraHeaderFmt\glslongextraShortHeader\tabularnewline
+ \midrule
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glslongextraLongShortTabularFooter}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glslongextraLongShortTabularFooter}{%
+ \bottomrule
+}
+% \end{macrocode}
+%\end{macro}
%
%\iffalse
% \begin{macrocode}
@@ -37750,14 +49434,21 @@ defined}{}%
%<*glossary-topic.sty>
% \end{macrocode}
%\fi
-%\chapter{topic styles (\styfmt{glossary-topic.sty})}
+%\section{topic styles (\sty{glossary-topic.sty})}
%\changes{1.40}{2019-03-22}{new}
-%\section{Package Initialisation and Options}
%Provides \qt{topic} styles where top-level entries are considered a
%topic.
% \begin{macrocode}
\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{glossary-topic}[2021/11/22 v1.48 (NLCT)]
+% \end{macrocode}
+% Rollback releases:
+% \begin{macrocode}
+\DeclareRelease{v1.48}{2021-11-22}{glossary-topic-2021-11-22.sty}
+\DeclareCurrentRelease{v1.49}{2022-10-14}
+% \end{macrocode}
+% Declare package:
+% \begin{macrocode}
+\ProvidesPackage{glossary-topic}[2022/10/14 v1.49 (NLCT)]
% \end{macrocode}
%Load required package.
% \begin{macrocode}
@@ -37781,6 +49472,11 @@ defined}{}%
\def\glstopic@prevlevel{-1}%
\glstopicGroupHeading{##1}%
}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}{\glstopicSubGroupHeading}%
\renewcommand{\glossentry}[2]{%
\hangindent0pt\relax
\parindent\glstopicParIndent\relax
@@ -37834,6 +49530,26 @@ defined}{}%
\newcommand*{\glstopicGroupHeading}[1]{}
% \end{macrocode}
%\end{macro}
+%\begin{macro}{\glstopicSubGroupHeading}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glstopicSubGroupHeading}\marg{prev group level}\marg{group
+%level}\marg{parent entry}\marg{group label}
+%\end{definition}
+% \begin{macrocode}
+\newcommand*{\glstopicSubGroupHeading}[4]{%
+ \begingroup
+ \glspar\glstopicPreSkip\glspar\noindent
+ \glsxtrgetgrouptitle{#4}{\glstopicsubgrouptitle}%
+ \glstopicAssignSubIndent{#2}%
+ \glstopicSubItemBox{#2}{\glstopicTitleFont{\glstopicsubgrouptitle}}%
+ \glstopicSubItemSep
+ \glspar\nobreak\glstopicPostSkip
+ \par
+ \endgroup
+}
+% \end{macrocode}
+%\end{macro}
%\begin{macro}{\glstopicItem}
%\changes{1.40}{2019-03-22}{new}
%\begin{definition}
@@ -37849,7 +49565,8 @@ defined}{}%
}%
\ifglshasdesc{#1}%
{\glspar\nobreak\glstopicMidSkip\glspar\nobreak
- \@afterheading\glstopicDesc{#1}\glspar\glstopicPostSkip}%
+ \@afterheading\glstopicDesc{#1}\glspar\glstopicPostSkip
+ }%
{\glspar\nobreak\glstopicPostSkip}%
\glstopicLoc{#1}{#2}%
}
@@ -38100,6 +49817,11 @@ defined}{}%
\def\glstopic@prevlevel{-1}%
\glstopicGroupHeading{##1}%
}%
+% \end{macrocode}
+%\changes{1.49}{2022-10-14}{added \cs{glssubgroupheading}}
+% Sub-groups are only supported with \cs{printunsrtglossary}.
+% \begin{macrocode}
+ \renewcommand*{\glssubgroupheading}{\glstopicSubGroupHeading}%
\renewcommand{\glossentry}[2]{%
\ifnum\glstopic@prevlevel>0\relax\glstopic@postchildren\fi
\def\glstopic@prevlevel{0}%
@@ -38143,6 +49865,1956 @@ defined}{}%
%\fi
%\iffalse
% \begin{macrocode}
+%<*glossary-table.sty>
+% \end{macrocode}
+%\fi
+%\section{table styles (\sty{glossary-table.sty})}
+%\changes{1.49}{2022-10-14}{new}
+%Intended for use with \app{bib2gls}. This is still experimental.
+% \begin{macrocode}
+\NeedsTeXFormat{LaTeX2e}
+% \end{macrocode}
+% Declare package:
+% \begin{macrocode}
+\ProvidesPackage{glossary-table}[2022/10/14 v1.49 (NLCT)]
+% \end{macrocode}
+%Load required packages.
+% \begin{macrocode}
+\RequirePackage{glossary-longbooktabs}
+% \end{macrocode}
+%\begin{macro}{\glstableblockperrowcount}
+%\changes{1.49}{2022-10-14}{new}
+%Number of blocks (entries) per row.
+% \begin{macrocode}
+\newcount\glstableblockperrowcount
+\glstableblockperrowcount=2\relax
+% \end{macrocode}
+%\end{macro}
+%Add a key to allow this value to be changed.
+% \begin{macrocode}
+\define@key{printglosstable}{blocks}{\glstableblockperrowcount=#1\relax}
+% \end{macrocode}
+%
+%\begin{macro}{\glstablecurrentblockindex}
+%Keep track of current block (entry) index.
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcount\glstablecurrentblockindex
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstabletotalcols}
+%\changes{1.49}{2022-10-14}{new}
+%Total number of columns. This will be updated at the start of
+%\cs{printunsrttable}, but is a user level command so that it can be
+%used in any hooks.
+% \begin{macrocode}
+\newcount\glstabletotalcols
+\glstabletotalcols=4\relax
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstablenameheader}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstablenameheader}{\entryname}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstabledescheader}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstabledescheader}{\descriptionname}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableotherheader}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableotherheader}{\MFUsentencecase{\glstableotherfield}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstablesymbolheader}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstablesymbolheader}{\symbolname}
+% \end{macrocode}
+%\end{macro}
+%
+%Provide boolean option to suppress header.
+% \begin{macrocode}
+\define@boolkey{printglosstable}{header}[true]{}
+\KV@printglosstable@headertrue
+% \end{macrocode}
+%
+%Provide boolean option to suppress rules.
+% \begin{macrocode}
+\define@boolkey{printglosstable}{rules}[true]{}
+\KV@printglosstable@rulestrue
+% \end{macrocode}
+%
+% \begin{macrocode}
+\define@key{printglosstable}{blocksep}{\renewcommand{\glstable@blockalignsep}{#1}}
+% \end{macrocode}
+%
+%\begin{macro}{\glstable@blockalignsep}
+%\changes{1.49}{2022-10-14}{new}
+%Alignment spec between blocks.
+% \begin{macrocode}
+\newcommand{\glstable@blockalignsep}{|}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{environment}{glstablesubentries}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newenvironment{glstablesubentries}{\begin{tabular}[t]{l}}{\end{tabular}}
+% \end{macrocode}
+%\end{environment}
+%
+%\begin{macro}{\glstablePreChildren}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstablePreChildren}{\glstableifpar{\par}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableblocksubentrysep}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableblocksubentrysep}{\\}
+% \end{macrocode}
+%\end{macro}
+%
+%Provide boolean option to allow paragraph cells.
+% \begin{macrocode}
+\define@choicekey{printglosstable}{par}
+[\@glstable@par@val\@glstable@par@n]
+{false,justified,ragged}
+{%
+ \ifcase\@glstable@par@n
+ \renewcommand{\glstable@parcase}[3]{##1}%
+ \or
+ \renewcommand{\glstable@parcase}[3]{##2}%
+ \or
+ \renewcommand{\glstable@parcase}[3]{##3}%
+ \fi
+}
+% \end{macrocode}
+%
+%\begin{macro}{\glstable@parcase}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstable@parcase}[3]{#1}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableifpar}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableifpar}[1]{\glstable@parcase{}{#1}{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableleftalign}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableleftalign}[1]{%
+ \glstable@parcase{l}{p{#1}}{>{\protect\raggedright}p{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstablerightalign}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstablerightalign}[1]{%
+ \glstable@parcase{r}{p{#1}}{>{\protect\raggedleft}p{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstablecenteralign}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstablecenteralign}[1]{%
+ \glstable@parcase{c}{p{#1}}{>{\protect\centering}p{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstablenamecolalign}
+%\changes{1.49}{2022-10-14}{new}
+%The alignment for the name column.
+% \begin{macrocode}
+\newcommand{\glstablenamecolalign}{\glstableleftalign{\glstablenamewidth}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstabledesccolalign}
+%\changes{1.49}{2022-10-14}{new}
+%The alignment for the description column.
+% \begin{macrocode}
+\newcommand{\glstabledesccolalign}{\glstableleftalign{\glstabledescwidth}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstablesymbolcolalign}
+%\changes{1.49}{2022-10-14}{new}
+%The alignment for the symbol column.
+% \begin{macrocode}
+\newcommand{\glstablesymbolcolalign}{\glstablecenteralign{\glstablesymbolwidth}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableNameTarget}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableNameTarget}[1]{%
+ \glstarget{#1}{\glstableNameFmt{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableNameFmt}
+%\changes{1.49}{2022-10-14}{new}
+%Entry item needs to be included in measuring to ensure there's
+%enough room for it as well.
+% \begin{macrocode}
+\newcommand{\glstableNameFmt}[1]{\glsentryitem{#1}\glossentryname{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableSubNameTarget}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableSubNameTarget}[1]{%
+ \glstarget{#1}{\glstableSubNameFmt{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableSubNameFmt}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableSubNameFmt}[1]{%
+ \glssubentryitem{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableotherfield}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableotherfield}{}
+% \end{macrocode}
+%\end{macro}
+%
+%Add an extra key to allow this value to be changed.
+% \begin{macrocode}
+\define@key{printglosstable}{other}{\renewcommand{\glstableotherfield}{#1}}
+% \end{macrocode}
+%
+%\begin{macro}{\glstableOther}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableOther}[1]{%
+ \glsxtrusefield{#1}{\glstableotherfield}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableNameSingleFmt}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableNameSingleFmt}[1]{%
+ \glstableNameTarget{#1}%
+ \ifglshasdesc{#1}%
+ {%
+ \glstableNameSinglePostName
+ \glstableNameSingleSuppl
+ {%
+ \ifglshassymbol{#1}%
+ {\glstableSymbolFmt{#1}\glstableNameSingleSymSep}%
+ {}%
+ \ifdefempty\glstableotherfield{}%
+ {%
+ \GlsXtrIfFieldUndef{\glstableotherfield}{#1}{}%
+ {\glstableOther{#1}\glstableOtherSep}%
+ }%
+ \glstableDescFmt{#1}%
+ }%
+ }%
+ {%
+ \ifglshassymbol{#1}%
+ {%
+ \glstableNameSinglePostName
+ \glstableNameSingleSuppl{\glstableSymbolFmt{#1}}%
+ \ifdefempty\glstableotherfield{}%
+ {%
+ \GlsXtrIfFieldUndef{\glstableotherfield}{#1}{}%
+ {\glstableNameSingleSymSep\glstableOther{#1}}%
+ }%
+ }%
+ {%
+ \ifdefempty\glstableotherfield{}%
+ {%
+ \glstableNameSinglePostName
+ \GlsXtrIfFieldUndef{\glstableotherfield}{#1}{}%
+ {\glstableOther{#1}}%
+ }%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableNameSingleSuppl}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableNameSingleSuppl}[1]{(#1)}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableNameSinglePostName}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableNameSinglePostName}{ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableNameSingleSymSep}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableNameSingleSymSep}{ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableOtherSep}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableOtherSep}{, }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableSubNameSingleFmt}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableSubNameSingleFmt}[1]{%
+ \glstableSubNameTarget{#1}%
+ \GlsXtrIfFieldUndef{desc}{#1}{}%
+ {%
+ \GlsXtrIfFieldUndef{symbol}{#1}{}{}%
+ {%
+ \glstableNameSinglePostSubName
+ \glstableNameSingleSubSuppl{\glstableSubSymbolFmt{#1}}%
+ }%
+ }%
+ {%
+ \glstableNameSinglePostSubName
+ \glstableNameSingleSubSuppl
+ {%
+ \GlsXtrIfFieldUndef{symbol}{#1}{}%
+ {\glstableSubSymbolFmt{#1}\glstableNameSingleSymSep}%
+ \glstableSubDescFmt{#1}%
+ }%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableNameSingleSubSuppl}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableNameSingleSubSuppl}[1]{#1}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableNameSinglePostSubName}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableNameSinglePostSubName}{ }
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableNameNoDesc}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableNameNoDesc}[1]{%
+ \glstableNameTarget{#1}%
+ \ifdefempty\glstableotherfield{}%
+ {%
+ \GlsXtrIfFieldUndef{\glstableotherfield}{#1}{}%
+ {\glstableOtherSep\glstableOther{#1}}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableSubNameNoDesc}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableSubNameNoDesc}[1]{%
+ \glstableSubNameTarget{#1}%
+ \ifdefempty\glstableotherfield{}%
+ {%
+ \GlsXtrIfFieldUndef{\glstableotherfield}{#1}{}%
+ {\glstableOtherSep\glstableOther{#1}}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableSymbolFmt}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableSymbolFmt}[1]{\glossentrysymbol{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableSubSymbolFmt}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableSubSymbolFmt}[1]{\glstableSymbolFmt{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableSymbolNameTarget}
+%\changes{1.49}{2022-10-14}{new}
+%Where the symbol takes place of the name.
+% \begin{macrocode}
+\newcommand{\glstableSymbolNameTarget}[1]{%
+ \glstarget{#1}{\glstableSymbolNameFmt{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableSymbolNameFmt}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableSymbolNameFmt}[1]{\glsentryitem{#1}\glossentrysymbol{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableSubSymbolNameTarget}
+%\changes{1.49}{2022-10-14}{new}
+%Where the symbol takes place of the name.
+% \begin{macrocode}
+\newcommand{\glstableSubSymbolNameTarget}[1]{%
+ \glstarget{#1}{\glstableSubSymbolNameFmt{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableSubSymbolNameFmt}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableSubSymbolNameFmt}[1]{\glssubentryitem{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableDesc}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableDesc}[1]{%
+ \ifdefempty\glstableotherfield{}%
+ {%
+ \GlsXtrIfFieldUndef{\glstableotherfield}{#1}{}%
+ {\glstableOther{#1}\ifglshasdesc{#1}{\glstableOtherSep}{}}%
+ }%
+ \glstableDescFmt{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableDescFmt}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableDescFmt}[1]{\glossentrydesc{#1}\glspostdescription}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableSubDesc}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableSubDesc}[1]{\glstableDesc{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableSubDescFmt}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableSubDescFmt}[1]{\glstableDescFmt{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableOtherNoDesc}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableOtherNoDesc}[1]{%
+ \ifdefempty\glstableotherfield{}%
+ {%
+ \GlsXtrIfFieldUndef{\glstableotherfield}{#1}{}%
+ {\glstableOther{#1}}%
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableSubOtherNoDesc}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableSubOtherNoDesc}[1]{%
+ \glstableOtherNoDesc{#1}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableHeaderFmt}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableHeaderFmt}[1]{\textbf{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+% \begin{macrocode}
+\define@key{printglosstable}{block-style}
+{\glstablesetstyle{#1}}
+% \end{macrocode}
+%
+%\begin{macro}{\glstablecolsperblock}
+%\changes{1.49}{2022-10-14}{new}
+%Number of columns per block (entry).
+%Assigned by block style.
+% \begin{macrocode}
+\newcount\glstablecolsperblock
+\glstablecolsperblock=2\relax
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableblockheader}
+%\changes{1.49}{2022-10-14}{new}
+%The column header, which may cover multiple columns.
+%Redefined by block style.
+% \begin{macrocode}
+\newcommand{\glstableblockheader}{}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\glstableblockalign}
+%\changes{1.49}{2022-10-14}{new}
+%The column alignment.
+%The default assumes two columns per entry (name and description)
+%Redefined by the block style.
+% \begin{macrocode}
+\newcommand{\glstableblockalign}{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableblockentry}
+%\changes{1.49}{2022-10-14}{new}
+%The entry item, which may cover multiple columns.
+%Redefined by block style.
+% \begin{macrocode}
+\newcommand{\glstableblockentry}[1]{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableblocksubentry}
+%\changes{1.49}{2022-10-14}{new}
+%The sub-entry is in the final column of the block (requires children to be saved)
+%Redefined by block style.
+% \begin{macrocode}
+\newcommand{\glstableblocksubentry}[1]{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableinitlengthupdates}
+%\changes{1.49}{2022-10-14}{new}
+%Block style command.
+% \begin{macrocode}
+\newcommand{\glstableinitlengthupdates}{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstablelengthupdate}
+%\changes{1.49}{2022-10-14}{new}
+%Block style command.
+% \begin{macrocode}
+\newcommand{\glstablelengthupdate}[1]{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstablefinishlengthupdates}
+%\changes{1.49}{2022-10-14}{new}
+%Block style command.
+% \begin{macrocode}
+\newcommand{\glstablefinishlengthupdates}{}
+% \end{macrocode}
+%\end{macro}
+%
+%
+%\begin{macro}{\glstablesetstyle}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstablesetstyle}[1]{%
+ \ifcsdef{@glstable@style@#1}%
+ {\csuse{@glstable@style@#1}}%
+ {\PackageError{glossary-table}{Unknown style `#1'}{}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstablenewstyle}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstablenewstyle}[2]{%
+ \ifcsdef{@glstable@style@#1}%
+ {\PackageError{glossary-table}{style `#1' already defined}{}}%
+ {\csdef{@glstable@style@#1}{#2}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%Provide some common layouts.
+% \begin{macrocode}
+\glstablenewstyle{name-desc}{%
+% \end{macrocode}
+% 2 columns per block (name, description).
+% \begin{macrocode}
+ \glstablecolsperblock=2\relax
+% \end{macrocode}
+% Initialise length registers (need to calculate max name
+% width if par align).
+% \begin{macrocode}
+ \renewcommand{\glstableinitlengthupdates}{%
+ \ifKV@printglosstable@header
+ \settowidth{\glstablenamewidth}%
+ {\glstableHeaderFmt\glstablenameheader}%
+ \else
+ \setlength{\glstablenamewidth}{0pt}%
+ \fi
+ \setlength{\glstabledescwidth}{0pt}%
+ }%
+% \end{macrocode}
+% Update width in unsrt hook.
+% \begin{macrocode}
+ \renewcommand{\glstablelengthupdate}[1]{%
+ \glstablemeasureandupdate{\glstablenamewidth}{\glstableNameFmt{##1}}%
+ }%
+% \end{macrocode}
+% Finally set the description width to the remaining available.
+% \begin{macrocode}
+ \renewcommand{\glstablefinishlengthupdates}{%
+ \setlength{\glstabledescwidth}{\dimexpr\glstableblockwidth
+ - \glstablenamewidth}%
+ \ifdim\glstabledescwidth<0pt\relax
+ \setlength{\glstablenamewidth}{\dimexpr0.5\glstableblockwidth}%
+ \setlength{\glstabledescwidth}{\glstablenamewidth}%
+ \fi
+ }%
+% \end{macrocode}
+% How to format the top-level entry in the block.
+% \begin{macrocode}
+ \renewcommand{\glstableblockentry}[1]{%
+ \glstableNameTarget{##1} & \glstableDesc{##1}}%
+% \end{macrocode}
+% How to format the entry's children.
+% \begin{macrocode}
+ \renewcommand{\glstableblocksubentry}[1]{%
+ \glstableSubNameTarget{##1} & \glstableSubDesc{##1}}%
+% \end{macrocode}
+% How to format the block's header row, if required.
+% \begin{macrocode}
+ \renewcommand{\glstableblockheader}{%
+ \glstableHeaderFmt\glstablenameheader &
+ \glstableHeaderFmt\glstabledescheader}%
+% \end{macrocode}
+% Set the block's column alignments.
+% \begin{macrocode}
+ \renewcommand{\glstableblockalign}{\glstablenamecolalign\glstabledesccolalign}%
+}
+% \end{macrocode}
+%Set the default style.
+% \begin{macrocode}
+\glstablesetstyle{name-desc}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\glstablenewstyle{name}{%
+% \end{macrocode}
+% 1 columns per block (name optionally with symbol and description).
+% \begin{macrocode}
+ \glstablecolsperblock=1\relax
+% \end{macrocode}
+% Initialise length registers (no calculation required, column width
+% same as block width).
+% \begin{macrocode}
+ \renewcommand{\glstableinitlengthupdates}{}%
+% \end{macrocode}
+% No measuring required.
+% \begin{macrocode}
+ \renewcommand{\glstablelengthupdate}[1]{}%
+% \end{macrocode}
+% Set the name width to the amount available.
+% \begin{macrocode}
+ \renewcommand{\glstablefinishlengthupdates}{%
+ \setlength{\glstablenamewidth}{\glstableblockwidth}%
+ }%
+% \end{macrocode}
+% How to format the top-level entry in the block.
+% \begin{macrocode}
+ \renewcommand{\glstableblockentry}[1]{%
+ \glstableNameSingleFmt{##1}}%
+% \end{macrocode}
+% How to format the entry's children.
+% \begin{macrocode}
+ \renewcommand{\glstableblocksubentry}[1]{%
+ \glstableSubNameSingleFmt{##1}}%
+% \end{macrocode}
+% How to format the block's header row, if required.
+% \begin{macrocode}
+ \renewcommand{\glstableblockheader}{%
+ \glstableHeaderFmt\glstablenameheader}%
+% \end{macrocode}
+% Set the block's column alignments.
+% \begin{macrocode}
+ \renewcommand{\glstableblockalign}{\glstablenamecolalign}%
+}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\glstablenewstyle{name-symbol}{%
+% \end{macrocode}
+% 2 columns per block (name and symbol).
+% \begin{macrocode}
+ \glstablecolsperblock=2\relax
+% \end{macrocode}
+% Initialise length registers (need to calculate max symbol
+% width if par align). This assumes the symbol requires the minimal
+% width and any leftover can be assigned to the name.
+% \begin{macrocode}
+ \renewcommand{\glstableinitlengthupdates}{%
+ \ifKV@printglosstable@header
+ \settowidth{\glstablesymbolwidth}%
+ {\glstableHeaderFmt\glstablesymbolheader}%
+ \else
+ \setlength{\glstablesymbolwidth}{0pt}%
+ \fi
+ \setlength{\glstablenamewidth}{0pt}%
+ }%
+% \end{macrocode}
+% Update widths in unsrt hook.
+% \begin{macrocode}
+ \renewcommand{\glstablelengthupdate}[1]{%
+ \glstablemeasureandupdate{\glstablesymbolwidth}{\glstableSymbolFmt{##1}}%
+ }%
+% \end{macrocode}
+% Finally set the name width to the remaining available.
+% \begin{macrocode}
+ \renewcommand{\glstablefinishlengthupdates}{%
+ \setlength{\glstablenamewidth}{\dimexpr\glstableblockwidth
+ - \glstablesymbolwidth}%
+ \ifdim\glstablenamewidth<0pt\relax
+ \setlength{\glstablenamewidth}{\dimexpr0.5\glstableblockwidth}%
+ \setlength{\glstablesymbolwidth}{\glstablenamewidth}%
+ \fi
+ }%
+% \end{macrocode}
+% How to format the top-level entry in the block.
+% \begin{macrocode}
+ \renewcommand{\glstableblockentry}[1]{%
+ \glstableNameNoDesc{##1} & \glstableSymbolFmt{##1}}%
+% \end{macrocode}
+% How to format the entry's children.
+% \begin{macrocode}
+ \renewcommand{\glstableblocksubentry}[1]{%
+ \glstableSubNameNoDesc{##1} & \glstableSubSymbolFmt{##1}}%
+% \end{macrocode}
+% How to format the block's header row, if required.
+% \begin{macrocode}
+ \renewcommand{\glstableblockheader}{%
+ \glstableHeaderFmt\glstablenameheader &
+ \glstableHeaderFmt\glstablesymbolheader}%
+% \end{macrocode}
+% Set the block's column alignments.
+% \begin{macrocode}
+ \renewcommand{\glstableblockalign}{\glstablenamecolalign\glstablesymbolcolalign}%
+}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\glstablenewstyle{desc-name}{%
+% \end{macrocode}
+% 2 columns per block (description, name).
+% \begin{macrocode}
+ \glstablecolsperblock=2\relax
+% \end{macrocode}
+% Initialise length registers (need to calculate max name
+% width if par align).
+% \begin{macrocode}
+ \renewcommand{\glstableinitlengthupdates}{%
+ \ifKV@printglosstable@header
+ \settowidth{\glstablenamewidth}%
+ {\glstableHeaderFmt\glstablenameheader}%
+ \else
+ \setlength{\glstablenamewidth}{0pt}%
+ \fi
+ \setlength{\glstabledescwidth}{0pt}%
+ }%
+% \end{macrocode}
+% Update width in unsrt hook.
+% \begin{macrocode}
+ \renewcommand{\glstablelengthupdate}[1]{%
+ \glstablemeasureandupdate{\glstablenamewidth}{\glstableNameFmt{##1}}%
+ }%
+% \end{macrocode}
+% Finally set the description width to the remaining available.
+% \begin{macrocode}
+ \renewcommand{\glstablefinishlengthupdates}{%
+ \setlength{\glstabledescwidth}{\dimexpr\glstableblockwidth
+ - \glstablenamewidth}%
+ \ifdim\glstabledescwidth<0pt\relax
+ \setlength{\glstablenamewidth}{\dimexpr0.5\glstableblockwidth}%
+ \setlength{\glstabledescwidth}{\glstablenamewidth}%
+ \fi
+ }%
+% \end{macrocode}
+% How to format the top-level entry in the block.
+% \begin{macrocode}
+ \renewcommand{\glstableblockentry}[1]{%
+ \glstableDesc{##1} &
+ \glstableNameTarget{##1}%
+ }%
+% \end{macrocode}
+% How to format the entry's children.
+% \begin{macrocode}
+ \renewcommand{\glstableblocksubentry}[1]{%
+ \glstableSubDesc{##1} &
+ \glstableSubNameTarget{##1}%
+ }%
+% \end{macrocode}
+% How to format the block's header row, if required.
+% \begin{macrocode}
+ \renewcommand{\glstableblockheader}{%
+ \glstableHeaderFmt\glstabledescheader &
+ \glstableHeaderFmt\glstablenameheader
+ }%
+% \end{macrocode}
+% Set the block's column alignments.
+% \begin{macrocode}
+ \renewcommand{\glstableblockalign}{\glstabledesccolalign\glstablenamecolalign}%
+}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\glstablenewstyle{symbol-name}{%
+% \end{macrocode}
+% 2 columns per block (symbol, name).
+% \begin{macrocode}
+ \glstablecolsperblock=2\relax
+% \end{macrocode}
+% Initialise length registers (need to calculate max symbol
+% width if par align).
+% \begin{macrocode}
+ \renewcommand{\glstableinitlengthupdates}{%
+ \ifKV@printglosstable@header
+ \settowidth{\glstablesymbolwidth}%
+ {\glstableHeaderFmt\glstablesymbolheader}%
+ \else
+ \setlength{\glstablesymbolwidth}{0pt}%
+ \fi
+ \setlength{\glstablenamewidth}{0pt}%
+ }%
+% \end{macrocode}
+% Update widths in unsrt hook.
+% \begin{macrocode}
+ \renewcommand{\glstablelengthupdate}[1]{%
+ \glstablemeasureandupdate{\glstablesymbolwidth}{\glstableSymbolFmt{##1}}%
+ }%
+% \end{macrocode}
+% Finally set the name width to the remaining available.
+% \begin{macrocode}
+ \renewcommand{\glstablefinishlengthupdates}{%
+ \setlength{\glstablenamewidth}{\dimexpr\glstableblockwidth
+ - \glstablesymbolwidth}%
+ \ifdim\glstablenamewidth<0pt\relax
+ \setlength{\glstablenamewidth}{\dimexpr0.5\glstableblockwidth}%
+ \setlength{\glstablesymbolwidth}{\glstablenamewidth}%
+ \fi
+ }%
+% \end{macrocode}
+% How to format the top-level entry in the block.
+% \begin{macrocode}
+ \renewcommand{\glstableblockentry}[1]{%
+ \glstableSymbolFmt{##1} &
+ \glstableNameNoDesc{##1}%
+ }%
+% \end{macrocode}
+% How to format the entry's children.
+% \begin{macrocode}
+ \renewcommand{\glstableblocksubentry}[1]{%
+ \glstableSubSymbolFmt{##1} &
+ \glstableSubNameNoDesc{##1}%
+ }%
+% \end{macrocode}
+% How to format the block's header row, if required.
+% \begin{macrocode}
+ \renewcommand{\glstableblockheader}{%
+ \glstableHeaderFmt\glstablesymbolheader &
+ \glstableHeaderFmt\glstablenameheader
+ }%
+% \end{macrocode}
+% Set the block's column alignments.
+% \begin{macrocode}
+ \renewcommand{\glstableblockalign}{\glstablesymbolcolalign\glstablenamecolalign}%
+}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\glstablenewstyle{name-symbol-desc}{%
+% \end{macrocode}
+% 3 columns per block (name, symbol, description).
+% \begin{macrocode}
+ \glstablecolsperblock=3\relax
+% \end{macrocode}
+% Initialise length registers (need to calculate max name and symbol
+% widths if par align).
+% \begin{macrocode}
+ \renewcommand{\glstableinitlengthupdates}{%
+ \ifKV@printglosstable@header
+ \settowidth{\glstablenamewidth}%
+ {\glstableHeaderFmt\glstablenameheader}%
+ \settowidth{\glstablesymbolwidth}%
+ {\glstableHeaderFmt\glstablesymbolheader}%
+ \else
+ \setlength{\glstablenamewidth}{0pt}%
+ \setlength{\glstablesymbolwidth}{0pt}%
+ \fi
+ \setlength{\glstabledescwidth}{0pt}%
+ }%
+% \end{macrocode}
+% Update widths in unsrt hook.
+% \begin{macrocode}
+ \renewcommand{\glstablelengthupdate}[1]{%
+ \glstablemeasureandupdate{\glstablenamewidth}{\glstableNameFmt{##1}}%
+ \glstablemeasureandupdate{\glstablesymbolwidth}{\glstableSymbolFmt{##1}}%
+ }%
+% \end{macrocode}
+% Finally set the description width to the remaining available.
+% \begin{macrocode}
+ \renewcommand{\glstablefinishlengthupdates}{%
+ \setlength{\glstabledescwidth}{\dimexpr\glstableblockwidth
+ - \glstablesymbolwidth - \glstablenamewidth}%
+ \ifdim\glstabledescwidth<0pt\relax
+ \setlength{\glstablenamewidth}{\dimexpr0.5\glstableblockwidth
+ - 0.5\glstablesymbolwidth}%
+ \setlength{\glstabledescwidth}{\glstablenamewidth}%
+ \fi
+ }%
+% \end{macrocode}
+% How to format the top-level entry in the block.
+% \begin{macrocode}
+ \renewcommand{\glstableblockentry}[1]{%
+ \glstableNameTarget{##1} &
+ \glstableSymbolFmt{##1} &
+ \glstableDesc{##1}}%
+% \end{macrocode}
+% How to format the entry's children.
+% \begin{macrocode}
+ \renewcommand{\glstableblocksubentry}[1]{%
+ \glstableSubNameTarget{##1} &
+ \glstableSubSymbolFmt{##1} &
+ \glstableSubDesc{##1}}%
+% \end{macrocode}
+% How to format the block's header row, if required.
+% \begin{macrocode}
+ \renewcommand{\glstableblockheader}{%
+ \glstableHeaderFmt\glstablenameheader &
+ \glstableHeaderFmt\glstablesymbolheader &
+ \glstableHeaderFmt\glstabledescheader}%
+% \end{macrocode}
+% Set the block's column alignments.
+% \begin{macrocode}
+ \renewcommand{\glstableblockalign}{%
+ \glstablenamecolalign\glstablesymbolcolalign\glstabledesccolalign}%
+}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\glstablenewstyle{name-desc-symbol}{%
+% \end{macrocode}
+% 3 columns per block (name, description, symbol).
+% \begin{macrocode}
+ \glstablecolsperblock=3\relax
+% \end{macrocode}
+% Initialise length registers (need to calculate max name and symbol
+% widths if par align).
+% \begin{macrocode}
+ \renewcommand{\glstableinitlengthupdates}{%
+ \ifKV@printglosstable@header
+ \settowidth{\glstablenamewidth}%
+ {\glstableHeaderFmt\glstablenameheader}%
+ \settowidth{\glstablesymbolwidth}%
+ {\glstableHeaderFmt\glstablesymbolheader}%
+ \else
+ \setlength{\glstablenamewidth}{0pt}%
+ \setlength{\glstablesymbolwidth}{0pt}%
+ \fi
+ \setlength{\glstabledescwidth}{0pt}%
+ }%
+% \end{macrocode}
+% Update widths in unsrt hook.
+% \begin{macrocode}
+ \renewcommand{\glstablelengthupdate}[1]{%
+ \glstablemeasureandupdate{\glstablenamewidth}{\glstableNameFmt{##1}}%
+ \glstablemeasureandupdate{\glstablesymbolwidth}{\glstableSymbolFmt{##1}}%
+ }%
+% \end{macrocode}
+% Finally set the description width to the remaining available.
+% \begin{macrocode}
+ \renewcommand{\glstablefinishlengthupdates}{%
+ \setlength{\glstabledescwidth}{\dimexpr\glstableblockwidth
+ - \glstablesymbolwidth - \glstablenamewidth}%
+ \ifdim\glstabledescwidth<0pt\relax
+ \setlength{\glstablenamewidth}{\dimexpr0.5\glstableblockwidth
+ - 0.5\glstablesymbolwidth}%
+ \setlength{\glstabledescwidth}{\glstablenamewidth}%
+ \fi
+ }%
+% \end{macrocode}
+% How to format the top-level entry in the block.
+% \begin{macrocode}
+ \renewcommand{\glstableblockentry}[1]{%
+ \glstableNameTarget{##1} &
+ \glstableDesc{##1} &
+ \glstableSymbolFmt{##1}%
+ }%
+% \end{macrocode}
+% How to format the entry's children.
+% \begin{macrocode}
+ \renewcommand{\glstableblocksubentry}[1]{%
+ \glstableSubNameTarget{##1} &
+ \glstableSubDesc{##1} &
+ \glstableSubSymbolFmt{##1}%
+ }%
+% \end{macrocode}
+% How to format the block's header row, if required.
+% \begin{macrocode}
+ \renewcommand{\glstableblockheader}{%
+ \glstableHeaderFmt\glstablenameheader &
+ \glstableHeaderFmt\glstabledescheader &
+ \glstableHeaderFmt\glstablesymbolheader
+ }%
+% \end{macrocode}
+% Set the block's column alignments.
+% \begin{macrocode}
+ \renewcommand{\glstableblockalign}{%
+ \glstablenamecolalign\glstabledesccolalign\glstablesymbolcolalign}%
+}
+% \end{macrocode}
+%
+%As name-desc but the other field is put in the description column.
+% \begin{macrocode}
+\glstablenewstyle{name-other}{%
+% \end{macrocode}
+% 2 columns per block (name, other).
+% \begin{macrocode}
+ \glstablecolsperblock=2\relax
+% \end{macrocode}
+% Initialise length registers (need to calculate max name
+% width if par align).
+% \begin{macrocode}
+ \renewcommand{\glstableinitlengthupdates}{%
+ \ifKV@printglosstable@header
+ \settowidth{\glstablenamewidth}%
+ {\glstableHeaderFmt\glstablenameheader}%
+ \else
+ \setlength{\glstablenamewidth}{0pt}%
+ \fi
+ \setlength{\glstabledescwidth}{0pt}%
+ }%
+% \end{macrocode}
+% Update width in unsrt hook.
+% \begin{macrocode}
+ \renewcommand{\glstablelengthupdate}[1]{%
+ \glstablemeasureandupdate{\glstablenamewidth}{\glstableNameFmt{##1}}%
+ }%
+% \end{macrocode}
+% Finally set the description width to the remaining available.
+% \begin{macrocode}
+ \renewcommand{\glstablefinishlengthupdates}{%
+ \setlength{\glstabledescwidth}{\dimexpr\glstableblockwidth
+ - \glstablenamewidth}%
+ \ifdim\glstabledescwidth<0pt\relax
+ \setlength{\glstablenamewidth}{\dimexpr0.5\glstableblockwidth}%
+ \setlength{\glstabledescwidth}{\glstablenamewidth}%
+ \fi
+ }%
+% \end{macrocode}
+% How to format the top-level entry in the block.
+% \begin{macrocode}
+ \renewcommand{\glstableblockentry}[1]{%
+ \glstableNameTarget{##1} & \glstableOtherNoDesc{##1}}%
+% \end{macrocode}
+% How to format the entry's children.
+% \begin{macrocode}
+ \renewcommand{\glstableblocksubentry}[1]{%
+ \glstableSubNameTarget{##1} & \glstableSubOtherNoDesc{##1}}%
+% \end{macrocode}
+% How to format the block's header row, if required.
+% \begin{macrocode}
+ \renewcommand{\glstableblockheader}{%
+ \glstableHeaderFmt\glstablenameheader &
+ \glstableHeaderFmt\glstableotherheader}%
+% \end{macrocode}
+% Set the block's column alignments.
+% \begin{macrocode}
+ \renewcommand{\glstableblockalign}{\glstablenamecolalign\glstabledesccolalign}%
+}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\glstablenewstyle{other-name}{%
+% \end{macrocode}
+% 2 columns per block (other, name).
+% \begin{macrocode}
+ \glstablecolsperblock=2\relax
+% \end{macrocode}
+% Initialise length registers (need to calculate max name
+% width if par align).
+% \begin{macrocode}
+ \renewcommand{\glstableinitlengthupdates}{%
+ \ifKV@printglosstable@header
+ \settowidth{\glstablenamewidth}%
+ {\glstableHeaderFmt\glstablenameheader}%
+ \else
+ \setlength{\glstablenamewidth}{0pt}%
+ \fi
+ \setlength{\glstabledescwidth}{0pt}%
+ }%
+% \end{macrocode}
+% Update width in unsrt hook.
+% \begin{macrocode}
+ \renewcommand{\glstablelengthupdate}[1]{%
+ \glstablemeasureandupdate{\glstablenamewidth}{\glstableNameFmt{##1}}%
+ }%
+% \end{macrocode}
+% Finally set the description width to the remaining available.
+% \begin{macrocode}
+ \renewcommand{\glstablefinishlengthupdates}{%
+ \setlength{\glstabledescwidth}{\dimexpr\glstableblockwidth
+ - \glstablenamewidth}%
+ \ifdim\glstabledescwidth<0pt\relax
+ \setlength{\glstablenamewidth}{\dimexpr0.5\glstableblockwidth}%
+ \setlength{\glstabledescwidth}{\glstablenamewidth}%
+ \fi
+ }%
+% \end{macrocode}
+% How to format the top-level entry in the block.
+% \begin{macrocode}
+ \renewcommand{\glstableblockentry}[1]{%
+ \glstableOtherNoDesc{##1} &
+ \glstableNameTarget{##1}}%
+% \end{macrocode}
+% How to format the entry's children.
+% \begin{macrocode}
+ \renewcommand{\glstableblocksubentry}[1]{%
+ \glstableSubOtherNoDesc{##1} &
+ \glstableSubNameTarget{##1}}%
+% \end{macrocode}
+% How to format the block's header row, if required.
+% \begin{macrocode}
+ \renewcommand{\glstableblockheader}{%
+ \glstableHeaderFmt\glstableotherheader &
+ \glstableHeaderFmt\glstablenameheader}%
+% \end{macrocode}
+% Set the block's column alignments.
+% \begin{macrocode}
+ \renewcommand{\glstableblockalign}{\glstabledesccolalign\glstablenamecolalign}%
+}
+% \end{macrocode}
+%
+%As name-other but the use the symbol in place of the name.
+% \begin{macrocode}
+\glstablenewstyle{symbol-other}{%
+% \end{macrocode}
+% 2 columns per block (symbol, other).
+% \begin{macrocode}
+ \glstablecolsperblock=2\relax
+% \end{macrocode}
+% Initialise length registers (need to calculate max symbol
+% width if par align).
+% \begin{macrocode}
+ \renewcommand{\glstableinitlengthupdates}{%
+ \ifKV@printglosstable@header
+ \settowidth{\glstablesymbolwidth}%
+ {\glstableHeaderFmt\glstablesymbolheader}%
+ \else
+ \setlength{\glstablesymbolwidth}{0pt}%
+ \fi
+ \setlength{\glstabledescwidth}{0pt}%
+ }%
+% \end{macrocode}
+% Update width in unsrt hook.
+% \begin{macrocode}
+ \renewcommand{\glstablelengthupdate}[1]{%
+ \glstablemeasureandupdate{\glstablesymbolwidth}{\glstableSymbolNameFmt{##1}}%
+ }%
+% \end{macrocode}
+% Finally set the description width to the remaining available.
+% \begin{macrocode}
+ \renewcommand{\glstablefinishlengthupdates}{%
+ \setlength{\glstabledescwidth}{\dimexpr\glstableblockwidth
+ - \glstablesymbolwidth}%
+ \ifdim\glstabledescwidth<0pt\relax
+ \setlength{\glstablesymbolwidth}{\dimexpr0.5\glstableblockwidth}%
+ \setlength{\glstabledescwidth}{\glstablesymbolwidth}%
+ \fi
+ }%
+% \end{macrocode}
+% How to format the top-level entry in the block.
+% \begin{macrocode}
+ \renewcommand{\glstableblockentry}[1]{%
+ \glstableSymbolNameTarget{##1} & \glstableOtherNoDesc{##1}}%
+% \end{macrocode}
+% How to format the entry's children.
+% \begin{macrocode}
+ \renewcommand{\glstableblocksubentry}[1]{%
+ \glstableSubSymbolNameTarget{##1} & \glstableSubOtherNoDesc{##1}}%
+% \end{macrocode}
+% How to format the block's header row, if required.
+% \begin{macrocode}
+ \renewcommand{\glstableblockheader}{%
+ \glstableHeaderFmt\glstablesymbolheader &
+ \glstableHeaderFmt\glstableotherheader}%
+% \end{macrocode}
+% Set the block's column alignments.
+% \begin{macrocode}
+ \renewcommand{\glstableblockalign}{\glstablesymbolcolalign\glstabledesccolalign}%
+}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\glstablenewstyle{other-symbol}{%
+% \end{macrocode}
+% 2 columns per block (other-symbol).
+% \begin{macrocode}
+ \glstablecolsperblock=2\relax
+% \end{macrocode}
+% Initialise length registers (need to calculate max symbol
+% width if par align).
+% \begin{macrocode}
+ \renewcommand{\glstableinitlengthupdates}{%
+ \ifKV@printglosstable@header
+ \settowidth{\glstablesymbolwidth}%
+ {\glstableHeaderFmt\glstablesymbolheader}%
+ \else
+ \setlength{\glstablesymbolwidth}{0pt}%
+ \fi
+ \setlength{\glstabledescwidth}{0pt}%
+ }%
+% \end{macrocode}
+% Update width in unsrt hook.
+% \begin{macrocode}
+ \renewcommand{\glstablelengthupdate}[1]{%
+ \glstablemeasureandupdate{\glstablesymbolwidth}{\glstableSymbolNameFmt{##1}}%
+ }%
+% \end{macrocode}
+% Finally set the description width to the remaining available.
+% \begin{macrocode}
+ \renewcommand{\glstablefinishlengthupdates}{%
+ \setlength{\glstabledescwidth}{\dimexpr\glstableblockwidth
+ - \glstablesymbolwidth}%
+ \ifdim\glstabledescwidth<0pt\relax
+ \setlength{\glstablesymbolwidth}{\dimexpr0.5\glstableblockwidth}%
+ \setlength{\glstabledescwidth}{\glstablesymbolwidth}%
+ \fi
+ }%
+% \end{macrocode}
+% How to format the top-level entry in the block.
+% \begin{macrocode}
+ \renewcommand{\glstableblockentry}[1]{%
+ \glstableOtherNoDesc{##1} & \glstableSymbolNameTarget{##1}}%
+% \end{macrocode}
+% How to format the entry's children.
+% \begin{macrocode}
+ \renewcommand{\glstableblocksubentry}[1]{%
+ \glstableSubOtherNoDesc{##1} &
+ \glstableSubSymbolNameTarget{##1}}%
+% \end{macrocode}
+% How to format the block's header row, if required.
+% \begin{macrocode}
+ \renewcommand{\glstableblockheader}{%
+ \glstableHeaderFmt\glstableotherheader &
+ \glstableHeaderFmt\glstablesymbolheader}%
+% \end{macrocode}
+% Set the block's column alignments.
+% \begin{macrocode}
+ \renewcommand{\glstableblockalign}{\glstabledesccolalign\glstablesymbolcolalign}%
+}
+% \end{macrocode}
+%
+%
+%\begin{macro}{\glstablecaption}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glstablecaption}\marg{toc title}\marg{title}\marg{label}
+%\end{definition}
+% \begin{macrocode}
+\newcommand{\glstablecaption}[3]{%
+ \caption[#1]{#3#2}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstablepostnextcaption}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstablepostnextcaption}{ Cont./}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstablenextcaption}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glstablenextcaption}\marg{toc title}\marg{title}
+%\end{definition}
+% \begin{macrocode}
+\newcommand{\glstablenextcaption}[2]{%
+ \caption[]{#1\glstablepostnextcaption}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstablefoot}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glstablefoot}\marg{postamble}
+%\end{definition}
+% \begin{macrocode}
+\newcommand{\glstablefoot}[1]{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstablelastfoot}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glstablelastfoot}\marg{postamble}
+%\end{definition}
+% \begin{macrocode}
+\newcommand{\glstablelastfoot}[1]{\glstablerowspan{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstablehead}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glstablehead}\marg{preamble}
+%\end{definition}
+% \begin{macrocode}
+\newcommand{\glstablehead}[1]{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstablefirsthead}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glstablefirsthead}\marg{preamble}
+%\end{definition}
+% \begin{macrocode}
+\newcommand{\glstablefirsthead}[1]{\glstablerowspan{#1}}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstablerowspan}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glstablerowspan}\marg{text}
+%\end{definition}
+% \begin{macrocode}
+\newcommand{\glstablerowspan}[1]{%
+ \multicolumn{\glstabletotalcols}{c}{\parbox{\LTcapwidth}{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstable@begin}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstable@begin}{%
+ \PackageError{glossary-table}{table style can only be used with
+ \string\printunsrttable}{}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstable@filter}
+%\changes{1.49}{2022-10-14}{new}
+%Filter all child entries, but take level offset into account and
+%apply custom handler.
+% \begin{macrocode}
+\newcommand{\glstable@filter}[1]{%
+ \ifnum\glscurrententrylevel>0\relax
+ \printunsrtglossaryskipentry
+ \else
+ \glstableiffilter{#1}%
+ {\printunsrtglossaryskipentry}%
+ {%
+ \glstableifpar{\glstablelengthupdate{#1}}%
+ }%
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableiffilter}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableiffilter}[3]{#3}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstablenamewidth}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newlength\glstablenamewidth
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableblockwidth}
+%\changes{1.49}{2022-10-14}{new}
+%Maximum width available for each block.
+% \begin{macrocode}
+\newlength\glstableblockwidth
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstabledescwidth}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newlength\glstabledescwidth
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstablesymbolwidth}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newlength\glstablesymbolwidth
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableifmeasuring}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glstableifmeasuring}\marg{true}\marg{false}
+%\end{definition}
+% \begin{macrocode}
+\newcommand{\glstableifmeasuring}[2]{#2}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstable@stepentry}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstable@stepentry}[1]{%
+ \ifglsentrycounter
+ \stepcounter{glossaryentry}%
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstable@stepsubentry}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstable@stepsubentry}[1]{%
+ \ifglssubentrycounter
+ \stepcounter{glossarysubentry}%
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstablemeasureandupdate}
+%\changes{1.49}{2022-10-14}{new}
+%\begin{definition}
+%\cs{glstablemeasureandupdate}\marg{len reg}\marg{text}
+%\end{definition}
+% \begin{macrocode}
+\newcommand{\glstablemeasureandupdate}[2]{%
+ \let\glstableifmeasuring\@firstoftwo
+% \end{macrocode}
+%Disable unset and indexing
+% \begin{macrocode}
+ \let\@glsunset\@glsxtrbuffer@unset
+ \let\@gls@org@noindex\ifKV@glslink@noindex
+ \KV@glslink@noindextrue
+% \end{macrocode}
+%Disable targets and links
+% \begin{macrocode}
+ \let\@glstable@org@target\glstarget
+ \let\glstarget\@secondoftwo
+ \let\@glstable@org@link\@glslink
+ \let\@glslink\@secondoftwo
+% \end{macrocode}
+%Disable ref step and label
+% \begin{macrocode}
+ \let\glstable@org@stepentry\glsstepentry
+ \let\glsstepentry\glstable@stepentry
+ \let\glstable@org@stepsubentry\glsstepsubentry
+ \let\glsstepsubentry\glstable@stepsubentry
+% \end{macrocode}
+%Measure.
+% \begin{macrocode}
+ \settowidth{\dimen@}{#2}%
+% \end{macrocode}
+%Update if wider.
+% \begin{macrocode}
+ \ifdim\dimen@>#1\relax
+ \setlength{#1}{\dimen@}%
+ \fi
+% \end{macrocode}
+%Restore
+% \begin{macrocode}
+ \let\ifKV@glslink@noindex\@gls@org@noindex
+ \let\@glsunset\@glsxtr@unset
+ \let\glstarget\@glstable@org@target
+ \let\@glslink\@glstable@org@link
+ \let\glsstepentry\glstable@org@stepentry
+ \let\glsstepsubentry\glstable@org@stepsubentry
+ \let\glstableifmeasuring\@secondoftwo
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstable@ifhaspreamble}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstable@ifhaspreamble}[2]{%
+ \ifdefempty\glossarypreamble
+ {#2}%
+ {%
+ \ifx\@glstable@defaultpreamble\glossarypreamble
+ \ifcsvoid{@glossarypreamble@\currentglossary}{#2}{#1}%
+ \else
+ #1%
+ \fi
+ }%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%Need the type, preamble and postamble.
+% \begin{macrocode}
+\define@key{printglosstable}{type}{\renewcommand{\@glo@type}{#1}}
+\define@key{printglosstable}{preamble}{\renewcommand{\glossarypreamble}{#1}}
+\define@key{printglosstable}{postamble}{\renewcommand{\glossarypostamble}{#1}}
+% \end{macrocode}
+%
+%Allow localised initialisation.
+%\begin{macro}{\glstable@init}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand\glstable@init{}
+% \end{macrocode}
+%\end{macro}
+% \begin{macrocode}
+\define@key{printglosstable}{init}{\renewcommand{\glstable@init}{#1}}
+% \end{macrocode}
+%
+%The default setting is groups=false, unlike the usual default for
+%\cs{printunsrtglossary}. Support for groups isn't fully
+%implemented.
+% \begin{macrocode}
+\define@choicekey{printglosstable}{groups}
+[\@glstable@groups@val\@glstable@groups@n]
+{false,true}[true]%
+{%
+ \ifnum\@glstable@groups@n=0\relax
+ \let\glstable@groupheading\@gobble
+ \glsxtr@printgloss@groupsfalse
+ \else
+ \let\glstable@groupheading\glstablegroupheading
+ \glsxtr@printgloss@groupstrue
+ \fi
+}
+% \end{macrocode}
+%
+%\begin{macro}{\glstable@groupheading}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstable@groupheading}[1]{}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstablegroupheading}
+%\changes{1.49}{2022-10-14}{new}
+%This isn't quite working as it puts a spurious line above if it
+%occurs at the start of a new row.
+% \begin{macrocode}
+\newcommand{\glstablegroupheading}[1]{%
+ \glstablefinishrow
+ \multicolumn{\glstabletotalcols}{c}{%
+ \glsxtrgetgrouptitle{#1}{\glsxtrcurrentgrptitle}%
+ \glstableGroupHeaderFmt\glsxtrcurrentgrptitle
+ }%
+ \\*%
+}
+% \end{macrocode}
+%\end{macro}
+%\begin{macro}{\@glstable@defaultpreamble}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\let\@glstable@defaultpreamble\glossarypreamble
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableGroupHeaderFmt}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableGroupHeaderFmt}{\glstableHeaderFmt}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\printunsrttable}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newrobustcmd*{\printunsrttable}[1][]{%
+ \bgroup
+% \end{macrocode}
+%Initialise glossary type.
+% \begin{macrocode}
+ \def\@glo@type{\glsdefaulttype}%
+% \end{macrocode}
+%Initialise title.
+% \begin{macrocode}
+ \def\glossarytitle{%
+ \ifcsdef{@glotype@\@glo@type @title}%
+ {\csuse{@glotype@\@glo@type @title}}%
+ {\glossaryname}%
+ }%
+ \def\glossarytoctitle{\glossarytitle}%
+% \end{macrocode}
+%Initialise preamble.
+% \begin{macrocode}
+ \let\glossarypreamble\@glstable@defaultpreamble
+% \end{macrocode}
+%Set table keys.
+% \begin{macrocode}
+ \setkeys*{printglosstable}{#1}%
+ \let\currentglossary\@glo@type
+ \protected@edef\glstable@opts{type=\@glo@type,style=table}%
+ \ifdefempty\XKV@rm{}{\epreto\glstable@opts{\expandonce\XKV@rm,}}%
+% \end{macrocode}
+%Calculate the total number of columns.
+% \begin{macrocode}
+ \glstabletotalcols=\numexpr\glstablecolsperblock*\glstableblockperrowcount\relax
+% \end{macrocode}
+%If the widest name is non-void, calculate the remaining width
+%available for the blocks.
+% \begin{macrocode}
+ \glstableifpar
+ {%
+ \glstableblockwidth=\dimexpr\linewidth/\glstableblockperrowcount
+ -\glstablecolsperblock\tabcolsep\relax
+ \glstableinitlengthupdates
+ }%
+% \end{macrocode}
+%If no vertical line required between blocks, \cs{glstablefinishrow}
+%can simply do a new line.
+% \begin{macrocode}
+ \ifdefempty\glstable@blockalignsep{\def\glstable@finishrow{}}{}%
+% \end{macrocode}
+%Build the header row.
+% \begin{macrocode}
+ \def\glstable@alignment{}%
+ \ifKV@printglosstable@rules
+ \def\glstable@header{\toprule}%
+ \else
+ \def\glstable@header{}%
+ \fi
+ \global\glstablecurrentblockindex=0\relax
+ \loop
+% \end{macrocode}
+%Add to alignment spec.
+% \begin{macrocode}
+ \ifnum\glstablecurrentblockindex>0\relax
+ \protected@eappto\glstable@alignment{\glstable@blockalignsep}%
+ \fi
+ \protected@eappto\glstable@alignment{\glstableblockalign}%
+ \ifKV@printglosstable@header
+% \end{macrocode}
+%Add to header.
+% \begin{macrocode}
+ \ifnum\glstablecurrentblockindex>0\relax
+ \appto\glstable@header{&}%
+ \fi
+ \eappto\glstable@header{\expandonce\glstableblockheader}%
+ \fi
+% \end{macrocode}
+%Increment loop counter
+% \begin{macrocode}
+ \advance\glstablecurrentblockindex by 1\relax
+ \ifnum\glstablecurrentblockindex<\glstableblockperrowcount
+ \repeat
+ \ifKV@printglosstable@header
+% \end{macrocode}
+%Append cr to header.
+% \begin{macrocode}
+ \appto\glstable@header{\tabularnewline}%
+ \ifKV@printglosstable@rules
+ \appto\glstable@header{\midrule}%
+ \fi
+ \fi
+ \protected@edef\glstable@begin{%
+ \noexpand\begin{longtable}{\expandonce\glstable@alignment}%
+ \noexpand\glstablecaption
+ {\noexpand\glossarytoctitle}{\noexpand\glossarytitle}%
+ {\noexpand\@@glossaryseclabel}%
+ \noexpand\tabularnewline
+ }%
+% \end{macrocode}
+%Add preamble if set.
+% \begin{macrocode}
+ \glstable@ifhaspreamble
+ {%
+ \eappto\glstable@begin{\noexpand\glstablefirsthead
+ {\expandonce\glossarypreamble}%
+ \noexpand\tabularnewline
+ \expandonce\glstable@header
+ \noexpand\endfirsthead
+ \noexpand\glstablenextcaption
+ {\noexpand\glossarytoctitle}{\noexpand\glossarytitle}%
+ {\expandonce\glossarypreamble}%
+ }%
+ }%
+ {%
+ \eappto\glstable@begin{%
+ \expandonce\glstable@header
+ \noexpand\endfirsthead
+ \noexpand\glstablenextcaption
+ {\noexpand\glossarytoctitle}{\noexpand\glossarytitle}%
+ }%
+ }%
+ \eappto\glstable@begin{%
+ \noexpand\tabularnewline
+ \expandonce\glstable@header
+ \noexpand\endhead
+ }%
+% \end{macrocode}
+%Add postamble if set.
+% \begin{macrocode}
+ \ifdefvoid\glossarypostamble
+ {%
+% \end{macrocode}
+%Just add rule, if required.
+% \begin{macrocode}
+ \ifKV@printglosstable@rules
+ \appto\glstable@begin{\bottomrule\endfoot}%
+ \fi
+ }
+ {%
+ \ifKV@printglosstable@rules
+ \eappto\glstable@begin{%
+ \noexpand\bottomrule
+ \noexpand\glstablefoot{\expandonce\glossarypostamble}%
+ \noexpand\tabularnewline
+ \noexpand\endfoot
+ \noexpand\bottomrule
+ \noexpand\glstablelastfoot{\expandonce\glossarypostamble}%
+ \noexpand\tabularnewline
+ \noexpand\endlastfoot
+ }%
+ \else
+ \eappto\glstable@begin{%
+ \noexpand\glstablefoot{\expandonce\glossarypostamble}%
+ \noexpand\tabularnewline
+ \noexpand\endfoot
+ \noexpand\glstablelastfoot{\expandonce\glossarypostamble}%
+ \noexpand\tabularnewline
+ \noexpand\endlastfoot
+ }%
+ \fi
+ }%
+% \end{macrocode}
+%Initialisation hook.
+% \begin{macrocode}
+ \glstable@init
+% \end{macrocode}
+%Set up filtering.
+% \begin{macrocode}
+ \let\printunsrtglossaryentryprocesshook\glstable@filter
+% \end{macrocode}
+%Disable preamble and postamble commands as their content has
+%already been added to the table specs.
+% \begin{macrocode}
+ \let\glossarypostamble\relax
+ \let\glossarypreamble\relax
+% \end{macrocode}
+%Disable the section command as the title and toc title are now in
+%the caption.
+% \begin{macrocode}
+ \renewcommand{\glossarysection}[2][]{}%
+% \end{macrocode}
+%The glossary will be empty on the first \LaTeX\ run as the entries
+%won't be defined until \app{bib2gls} has selected them.
+% \begin{macrocode}
+ \glsxtrifemptyglossary{\currentglossary}
+ {%
+ \GlossariesExtraWarning{Glossary `\currentglossary' is empty}%
+% \end{macrocode}
+%Just do the table header and footer to allow it to be added to the
+%list of tables and have the label added to the aux file.
+% \begin{macrocode}
+ \edef\@glsxtr@tmp{\noexpand\setkeys{printgloss}{\expandonce\glstable@opts}}%
+ \@glsxtr@tmp
+ \glstableifpar{\glstablefinishlengthupdates}%
+ \global\glstablecurrentblockindex=0\relax
+ \glstable@begin
+ \glstablefinishrow
+ \end{longtable}%
+ }%
+ {%
+ \expandafter\printunsrtglossary\expandafter[\glstable@opts]\relax
+ }%
+ \egroup
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstable@child}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstable@child}[1]{%
+ \ifdefempty\glstable@dochildren{}%
+ {\appto\glstable@dochildren{\glstableblocksubentrysep}}%
+ \appto\glstable@dochildren{\glstableblocksubentry{#1}}%
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstableChildEntries}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstableChildEntries}[1]{%
+ \def\glstable@dochildren{}%
+ \GlsXtrIfHasNonZeroChildCount*{#1}%
+ {%
+ \glsxtrfieldforlistloop{#1}{childlist}{\glstable@child}%
+ \preto\glstable@dochildren{%
+ \glstablePreChildren
+ \begin{glstablesubentries}%
+ }%
+ \appto\glstable@dochildren{\end{glstablesubentries}}%
+ }%
+ {}%
+ \glstable@dochildren
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstable@n@amps}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstable@n@amps}[1]{%
+ \ifnum#1>0\relax
+ \count@=0\relax
+ \loop
+ \advance\count@ by 1\relax
+ \appto\glstable@endblock{&}%
+ \ifnum\count@<#1
+ \repeat
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%TODO: this needs to do nothing if it occurs are the start of a new
+%row. The position of \cs{tabularnewline} may need changing within
+%\cs{printunsrttable} and the table style.
+%\begin{macro}{\glstablefinishrow}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstablefinishrow}{%
+ \glstable@finishrow
+ \tabularnewline
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\glstable@finishrow}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\glstable@finishrow}{%
+ \def\glstable@endblock{}%
+ \@glstable@finishrow
+ \glstable@endblock
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glstable@finishrow}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newcommand{\@glstable@finishrow}{%
+ \ifnum\glstablecurrentblockindex>0
+ \ifnum\glstablecurrentblockindex<\glstableblockperrowcount
+ \expandafter\glstable@n@amps\expandafter{%
+ \numexpr
+ (\glstableblockperrowcount-\glstablecurrentblockindex)
+ * (\glstablecolsperblock -1)
+ }%
+ \fi
+ \global\glstablecurrentblockindex=0
+ \fi
+}
+% \end{macrocode}
+%\end{macro}
+%
+%\begin{style}{table}
+%\changes{1.49}{2022-10-14}{new}
+% \begin{macrocode}
+\newglossarystyle{table}%
+{%
+ \renewenvironment{theglossary}%
+ {%
+ \glstableifpar{\glstablefinishlengthupdates}%
+ \global\glstablecurrentblockindex=0\relax
+ \glstable@begin
+ }
+ {%
+ \glstablefinishrow
+ \end{longtable}%
+ }%
+ \renewcommand*{\glossaryheader}{}%
+ \renewcommand*{\glsgroupheading}[1]{\glstable@groupheading{##1}}%
+ \renewcommand*{\glssubgroupheading}[4]{}%
+ \renewcommand*{\glsgroupskip}{}%
+ \renewcommand{\glossentry}[2]{%
+ \global\advance\glstablecurrentblockindex by 1\relax
+ \ifnum\glstableblockperrowcount=\glstablecurrentblockindex
+ \gdef\glstable@endblock{%
+ \global\glstablecurrentblockindex=0\relax
+ \tabularnewline
+ }%
+ \else
+ \gdef\glstable@endblock{&}%
+ \fi
+ \glstableblockentry{##1}%
+ \glstableChildEntries{##1}%
+ \glstable@endblock
+ }%
+ \renewcommand{\subglossentry}[3]{}%
+}
+% \end{macrocode}
+%\end{style}
+%\iffalse
+% \begin{macrocode}
+%</glossary-table.sty>
+% \end{macrocode}
+%\fi
+%\iffalse
+% \begin{macrocode}
%<*example-glossaries-xr.tex>
% \end{macrocode}
%\fi
@@ -41043,5 +54715,19676 @@ amet, libero}
%</example-glossaries-xr.bib>
% \end{macrocode}
%\fi
+%\iffalse
+% \begin{macrocode}
+%<*glossaries-extra-2021-11-22.sty>
+% \end{macrocode}
+%\fi
+%\section{Rollback Files}
+% \subsection{Rollback v1.48 (glossaries-extra-2021-11-22.sty)}
+% Version 1.48 preserved for rollback.
+% \begin{macrocode}
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{glossaries-extra}[2021/11/22 v1.48 (NLCT)]
+\RequirePackage{xkeyval}
+\RequirePackage{etoolbox}
+\@ifpackageloaded{glossaries}
+{%
+ \newcommand{\glsxtr@dooption}[1]{\setupglossaries{#1}}%
+ \let\@glsxtr@declareoption\@gls@declareoption
+}
+{%
+ \newcommand{\glsxtr@dooption}[1]{%
+ \PassOptionsToPackage{#1}{glossaries}%
+ }%
+ \PassOptionsToPackage{toc}{glossaries}
+ \PassOptionsToPackage{nopostdot}{glossaries}
+ \PassOptionsToPackage{noredefwarn}{glossaries}
+ \@ifpackageloaded{polyglossia}%
+ {}%
+ {%
+ \@ifpackageloaded{babel}%
+ {\PassOptionsToPackage{translate=babel}{glossaries}}%
+ {}%
+ }%
+ \newcommand*{\@glsxtr@declareoption}[2]{%
+ \DeclareOptionX{#1}{#2}%
+ \DeclareOption{#1}{#2}%
+ }
+}
+\newcommand*{\glsxtrundefaction}[2]{%
+ \@glsxtrundeftag\PackageError{glossaries-extra}{#1}{#2}%
+}
+\newcommand*{\glsxtr@warnonexistsordo}[1]{}
+\newcommand*{\glsxtrundeftag}{??}
+\newcommand*{\@glsxtrundeftag}{}
+\newcommand*{\@glsxtr@warn@undefaction}[2]{%
+ \@glsxtrundeftag\GlossariesExtraWarning{#1}%
+}
+\newcommand*{\@glsxtr@err@undefaction}[2]{%
+ \@glsxtrundeftag\PackageError{glossaries-extra}{#1}{#2}%
+}
+\newcommand*{\@glsxtr@warn@onexistsordo}[1]{%
+ \GlossariesExtraWarning{\string#1\space hasn't been defined, so
+ some errors won't be converted to warnings.
+ (This most likely means your version of
+ glossaries.sty is below version 4.19.)}%
+}
+
+\newcommand*{\@glsxtr@redef@forglsentries}{}
+\newcommand*{\@glsxtr@do@redef@forglsentries}{%
+ \renewcommand*{\forglsentries}[3][\glsdefaulttype]{%
+ \protected@edef\@@glo@list{\csname glolist@##1\endcsname}%
+ \ifdefstring{\@@glo@list}{,}%
+ {%
+ \GlossariesExtraWarning{No entries defined in glossary `##1'}%
+ }%
+ {%
+ \@for##2:=\@@glo@list\do
+ {%
+ \ifdefempty{##2}{}{##3}%
+ }%
+ }%
+ }%
+}%
+\define@choicekey{glossaries-extra.sty}{undefaction}%
+ [\glsxtr@undefaction@val\glsxtr@undefaction@nr]%
+ {warn,error}%
+ {%
+ \ifcase\glsxtr@undefaction@nr\relax
+ \let\glsxtrundefaction\@glsxtr@warn@undefaction
+ \let\glsxtr@warnonexistsordo\@glsxtr@warn@onexistsordo
+ \let\@glsxtr@redef@forglsentries\@glsxtr@do@redef@forglsentries
+ \or
+ \let\glsxtrundefaction\@glsxtr@err@undefaction
+ \let\glsxtr@warnonexistsordo\@gobble
+ \let\@glsxtr@redef@forglsentries\relax
+ \fi
+ }
+\newcommand*{\@glsxtr@record}[3]{}
+\newcommand*{\glsxtr@recordsee}[2]{}
+\newcommand*{\@glsxtr@defaultnumberformat}{glsnumberformat}%
+\newcommand*{\GlsXtrSetDefaultNumberFormat}[1]{%
+ \renewcommand*{\@glsxtr@defaultnumberformat}{#1}%
+}%
+\newcommand*{\@glsxtr@do@record@wrglossary}[1]{%
+ \begingroup
+ \ifKV@glslink@noindex
+ \else
+ \protected@edef\@gls@label{\glsdetoklabel{#1}}%
+ \let\glslabel\@gls@label
+ \glswriteentry{#1}%
+ {%
+ \ifdefempty{\@glsxtr@thevalue}%
+ {%
+ \ifx\@glsxtr@org@theHvalue\@glsxtr@theHvalue
+ \else
+ \let\theHglsentrycounter\@glsxtr@theHvalue
+ \fi
+ \glsxtr@saveentrycounter
+ \let\@@do@@wrglossary\@glsxtr@dorecord
+ }%
+ {%
+ \let\theglsentrycounter\@glsxtr@thevalue
+ \let\theHglsentrycounter\@glsxtr@theHvalue
+ \let\@@do@@wrglossary\@glsxtr@dorecordnodefer
+ }%
+ \ifx\@glsxtr@record@setting\@glsxtr@record@setting@alsoindex
+ \glsxtr@@do@wrglossary{#1}%
+ \else
+ \@@glsxtrwrglossmark
+ \glsxtr@inc@wrglossaryctr{#1}%
+ \@@do@@wrglossary
+ \fi
+ }%
+ \fi
+ \endgroup
+}
+\newcommand*{\glsxtr@do@alsoindex@wrglossary}[1]{%
+ \glsxtr@@do@wrglossary{#1}%
+ \@glsxtr@do@record@wrglossary{#1}%
+}
+\newcommand*{\@@glsxtr@record}[3]{%
+ \protected@edef\@gls@label{\glsdetoklabel{#2}}%
+ \let\glslabel\@gls@label
+ \ifglsentryexists{#2}{}%
+ {%
+ \@@glsxtrwrglossmark
+ \begingroup
+ \let\@glsnumberformat\@glsxtr@defaultnumberformat
+ \def\@glsxtr@thevalue{}%
+ \def\@glsxtr@theHvalue{\@glsxtr@thevalue}%
+ \let\@glsxtr@org@theHvalue\@glsxtr@theHvalue
+ \let\@gls@counter\glscounter
+ \if@glsxtr@equations
+ \@glsxtr@use@equation@counter
+ \fi
+ \@gls@setdefault@glslink@opts
+ \csuse{@glsxtr@#3@prekeys}%
+ \setkeys{#3}{#1}%
+ \glsxtr@do@autoadd{#3}%
+ \csuse{@glsxtr@#3@postkeys}%
+ \glsxtr@inc@wrglossaryctr{#2}%
+ \ifKV@glslink@noindex
+ \else
+ \glswriteentry{#2}%
+ {%
+ \ifdefempty{\@glsxtr@thevalue}%
+ {%
+ \ifx\@glsxtr@org@theHvalue\@glsxtr@theHvalue
+ \else
+ \let\theHglsentrycounter\@glsxtr@theHvalue
+ \fi
+ \glsxtr@saveentrycounter
+ \let\@@do@@wrglossary\@glsxtr@dorecord
+ }%
+ {%
+ \let\theglsentrycounter\@glsxtr@thevalue
+ \let\theHglsentrycounter\@glsxtr@theHvalue
+ \let\@@do@@wrglossary\@glsxtr@dorecordnodefer
+ }%
+ \ifx\@glsxtr@record@setting\@glsxtr@record@setting@alsoindex
+ \glsxtr@@do@wrglossary{#2}%
+ \else
+ \@@do@@wrglossary
+ \fi
+ }%
+ \fi
+ \endgroup
+ }%
+}
+\newcommand{\@glsxtr@glslink@prekeys}{\glslinkpresetkeys}
+\newcommand{\@glsxtr@glslink@postkeys}{\glslinkpostsetkeys}
+\newcommand{\@glsxtr@glossadd@prekeys}{\glsaddpresetkeys}
+\newcommand{\@glsxtr@glossadd@postkeys}{\glsaddpostsetkeys}
+\newcommand*\@glsxtr@dorecord{%
+ \global\let\@glsrecordlocref\theglsentrycounter
+ \let\@glsxtr@orgprefix\@glo@counterprefix
+ \ifx\theglsentrycounter\theHglsentrycounter
+ \def\@glo@counterprefix{}%
+ \else
+ \protected@edef\@glsxtr@theentrycounter{\theglsentrycounter}%
+ \protected@edef\@glsxtr@theHentrycounter{\theHglsentrycounter}%
+ \@onelevel@sanitize\@glsxtr@theentrycounter
+ \@onelevel@sanitize\@glsxtr@theHentrycounter
+ \protected@edef\@do@gls@getcounterprefix{\noexpand\@gls@getcounterprefix
+ {\@glsxtr@theentrycounter}{\@glsxtr@theHentrycounter}%
+ }%
+ \@do@gls@getcounterprefix
+ \fi
+ \ifx\@glsxtr@record@setting\@glsxtr@record@setting@nameref
+ \@glsxtr@do@nameref@record
+ {\@gls@label}{\@glo@counterprefix}{\@gls@counter}{\@glsnumberformat}%
+ {\@glsrecordlocref}%
+ \else
+ \protected@write\@auxout{}{\string\glsxtr@record
+ {\@gls@label}{\@glo@counterprefix}{\@gls@counter}{\@glsnumberformat}%
+ {\@glsrecordlocref}}%
+ \fi
+ \@glsxtr@counterrecordhook
+ \let\@glo@counterprefix\@glsxtr@orgprefix
+}
+\newcommand*\@glsxtr@dorecordnodefer{%
+ \ifx\theglsentrycounter\theHglsentrycounter
+ \ifx\@glsxtr@record@setting\@glsxtr@record@setting@nameref
+ \@glsxtr@do@nameref@record
+ {\@gls@label}{}{\@gls@counter}{\@glsnumberformat}%
+ {\theglsentrycounter}%
+ \else
+ \protected@write\@auxout{}{\string\glsxtr@record
+ {\@gls@label}{}{\@gls@counter}{\@glsnumberformat}%
+ {\theglsentrycounter}}%
+ \fi
+ \else
+ \edef\@do@gls@getcounterprefix{\noexpand\@gls@getcounterprefix
+ {\theglsentrycounter}{\theHglsentrycounter}%
+ }%
+ \@do@gls@getcounterprefix
+ \ifx\@glsxtr@record@setting\@glsxtr@record@setting@nameref
+ \@glsxtr@do@nameref@record
+ {\@gls@label}{\@glo@counterprefix}{\@gls@counter}%
+ {\@glsnumberformat}{\theglsentrycounter}%
+ \else
+ \protected@write\@auxout{}{\string\glsxtr@record
+ {\@gls@label}{\@glo@counterprefix}{\@gls@counter}{\@glsnumberformat}%
+ {\theglsentrycounter}}%
+ \fi
+ \fi
+ \@glsxtr@counterrecordhook
+}
+\newcommand{\@glsxtr@ifnum@mmode}[2]{%
+ \ifmmode
+ \ifst@rred
+ #2%
+ \else
+ \if@display #1\else #2\fi
+ \fi
+ \else
+ #2%
+ \fi
+}
+\newcommand*{\@glsxtr@do@nameref@record}[5]{%
+ \gls@ifnotmeasuring
+ {%
+ \protected@write\@auxout{}{\string\glsxtr@record@nameref
+ {#1}{#2}{#3}{#4}{#5}%
+ {\csuse{@currentlabelname}}{\csuse{@currentHref}}%
+ {\theHglsentrycounter}}%
+ }%
+}
+\newcommand*{\@@glsxtr@recordcounter}{%
+ \@glsxtr@noop@recordcounter
+}
+\newcommand*{\@glsxtr@noop@recordcounter}[1]{%
+ \PackageError{glossaries-extra}{\string\GlsXtrRecordCounter\space
+ requires record=only or record=hybrid package option}{}%
+}
+\newcommand*{\@glsxtr@op@recordcounter}[1]{%
+ \protected@eappto\@glsxtr@counterrecordhook{\noexpand\@glsxtr@docounterrecord{#1}}%
+}
+\newcommand*{\@glsxtr@recordsee}[2]{%
+ \@@glsxtrwrglossmark
+ \def\@gls@xref{#2}%
+ \@onelevel@sanitize\@gls@xref
+ \protected@write\@auxout{}{\string\glsxtr@recordsee{#1}{\@gls@xref}}%
+}
+\newcommand{\printunsrtglossaryunit}{%
+ \print@noop@unsrtglossaryunit
+}
+\newcommand*{\glsxtr@setup@record}{\let\@@do@wrglossary\glsxtr@@do@wrglossary}
+\newcommand*{\glsxtr@indexonly@saveentrycounter}{%
+ \ifKV@glslink@noindex
+ \else
+ \glsxtr@saveentrycounter
+ \fi
+}
+\newcommand*{\glsxtr@addloclistfield}{%
+ \key@ifundefined{glossentry}{loclist}%
+ {%
+ \define@key{glossentry}{loclist}{\def\@glo@loclist{##1}}%
+ \appto\@gls@keymap{,{loclist}{loclist}}%
+ \appto\@newglossaryentryprehook{\def\@glo@loclist{}}%
+ \appto\@newglossaryentryposthook{%
+ \gls@assign@field{}{\@glo@label}{loclist}{\@glo@loclist}%
+ }%
+ \glssetnoexpandfield{loclist}%
+ }%
+ {}%
+ \key@ifundefined{glossentry}{location}%
+ {%
+ \define@key{glossentry}{location}{\def\@glo@location{##1}}%
+ \appto\@gls@keymap{,{location}{location}}%
+ \appto\@newglossaryentryprehook{\def\@glo@location{}}%
+ \appto\@newglossaryentryposthook{%
+ \gls@assign@field{}{\@glo@label}{location}{\@glo@location}%
+ }%
+ \glssetnoexpandfield{location}%
+ }%
+ {}%
+ \key@ifundefined{glossentry}{group}%
+ {%
+ \define@key{glossentry}{group}{\def\@glo@group{##1}}%
+ \appto\@gls@keymap{,{group}{group}}%
+ \appto\@newglossaryentryprehook{\def\@glo@group{}}%
+ \appto\@newglossaryentryposthook{%
+ \gls@assign@field{}{\@glo@label}{group}{\@glo@group}%
+ }%
+ \glssetnoexpandfield{group}%
+ }%
+ {}%
+}
+\newcommand*{\@glsxtr@record@setting}{off}
+\newcommand*{\@glsxtr@record@setting@alsoindex}{alsoindex}
+\newcommand*{\@glsxtr@record@setting@only}{only}
+\newcommand*{\@glsxtr@record@setting@nameref}{nameref}
+\newcommand*{\@glsxtr@if@record@only}[2]{%
+ \ifx\@glsxtr@record@setting\@glsxtr@record@setting@only
+ #1%
+ \else
+ \ifx\@glsxtr@record@setting\@glsxtr@record@setting@nameref
+ #1%
+ \else
+ #2%
+ \fi
+ \fi
+}
+\newcommand*{\@glsxtr@record@setting@off}{off}
+\newcommand\@glsxtr@warn@hybrid@noprintgloss{%
+ \ifdefstring{\@glo@types}{,}%
+ {%
+ \GlossariesExtraWarningNoLine{No glossaries have been defined}%
+ }%
+ {%
+ \GlossariesExtraWarningNoLine{No \string\printglossary\space
+ or \string\printglossaries\space
+ found. ^^JYou have requested the hybrid setting
+ record=\@glsxtr@record@setting\space which requires a
+ combination of bib2gls (to fetch entries) and makeindex/xindy
+ (to sort and collate the entries). If you only want to use
+ bib2gls then change the option to record=only or record=nameref}%
+ }%
+}
+\newcommand*{\@glsxtr@record@only@setup}{%
+ \def\glsxtr@setup@record{%
+ \@glsxtr@autoseeindexfalse
+ \let\@do@seeglossary\@glsxtr@recordsee
+ \let\@glsxtr@record\@@glsxtr@record
+ \let\@@do@wrglossary\@glsxtr@do@record@wrglossary
+ \let\@gls@saveentrycounter\relax
+ \let\glsxtrundefaction\@glsxtr@warn@undefaction
+ \let\glsxtr@warnonexistsordo\@glsxtr@warn@onexistsordo
+ \glsxtr@addloclistfield
+ \renewcommand*{\@glsxtr@autoindexcrossrefs}{}%
+ \let\@@glsxtr@recordcounter\@glsxtr@op@recordcounter
+ \def\printunsrtglossaryunit{\print@op@unsrtglossaryunit}%
+ \def\glsxtrsetaliasnoindex{}%
+ \ifdef\@gls@setupsort@none{\@gls@setupsort@none}{}%
+ \def\glsxtrNoGlossaryWarning{\@glsxtr@record@noglossarywarning}%
+ \RequirePackage{glossaries-extra-bib2gls}[=v1.48]%
+ }%
+}
+\define@choicekey{glossaries-extra.sty}{record}
+ [\@glsxtr@record@setting\glsxtr@record@nr]%
+ {off,only,alsoindex,nameref,hybrid}%
+ [only]%
+ {%
+ \ifcase\glsxtr@record@nr\relax
+ \def\glsxtr@setup@record{%
+ \renewcommand*{\@do@seeglossary}{\@glsxtr@doseeglossary}%
+ \renewcommand*{\@glsxtr@record}[3]{}%
+ \let\@@do@wrglossary\glsxtr@@do@wrglossary
+ \let\@gls@saveentrycounter\glsxtr@indexonly@saveentrycounter
+ \let\glsxtrundefaction\@glsxtr@err@undefaction
+ \let\glsxtr@warnonexistsordo\@gobble
+ \let\@@glsxtr@recordcounter\@glsxtr@noop@recordcounter
+ \def\printunsrtglossaryunit{\print@noop@unsrtglossaryunit}%
+ \undef\glsxtrsetaliasnoindex
+ }%
+ \or
+ \@glsxtr@record@only@setup
+ \or
+ \def\glsxtr@setup@record{%
+ \renewcommand*{\@glsxtr@record@setting@alsoindex}{alsoindex}%
+ \renewcommand*{\@do@seeglossary}{\@glsxtr@dosee@alsoindex@glossary}%
+ \let\@glsxtr@record\@@glsxtr@record
+ \let\@@do@wrglossary\glsxtr@do@alsoindex@wrglossary
+ \let\@gls@saveentrycounter\glsxtr@indexonly@saveentrycounter
+ \let\glsxtrundefaction\@glsxtr@warn@undefaction
+ \let\glsxtr@warnonexistsordo\@glsxtr@warn@onexistsordo
+ \glsxtr@addloclistfield
+ \let\@@glsxtr@recordcounter\@glsxtr@op@recordcounter
+ \def\printunsrtglossaryunit{\print@op@unsrtglossaryunit}%
+ \undef\glsxtrsetaliasnoindex
+ }%
+ \or
+ \@glsxtr@record@only@setup
+ \ifundef\hyperlink
+ {\GlossariesExtraWarning{You have requested record=nameref but
+ the document doesn't support hyperlinks}}%
+ {}%
+ \or
+ \def\glsxtr@setup@record{%
+ \renewcommand*{\@glsxtr@record@setting@alsoindex}{hybrid}%
+ \renewcommand*{\@do@seeglossary}{\@glsxtr@dosee@alsoindex@glossary}%
+ \let\@glsxtr@record\@@glsxtr@record
+ \let\@@do@wrglossary\glsxtr@do@alsoindex@wrglossary
+ \let\@gls@saveentrycounter\glsxtr@indexonly@saveentrycounter
+ \let\glsxtrundefaction\@glsxtr@warn@undefaction
+ \let\glsxtr@warnonexistsordo\@glsxtr@warn@onexistsordo
+ \glsxtr@addloclistfield
+ \let\@@glsxtr@recordcounter\@glsxtr@op@recordcounter
+ \def\printunsrtglossaryunit{\print@op@unsrtglossaryunit}%
+ \undef\glsxtrsetaliasnoindex
+ }%
+ \fi
+ }
+\newcommand*{\@glsxtr@docdefval}{0}
+\newcommand*{\if@glsxtrdocdef}{\ifnum\@glsxtr@docdefval>0 }
+\newcommand*{\@glsxtrdocdeftrue}{\def\@glsxtr@docdefval{1}}
+\newcommand*{\@glsxtrdocdeffalse}{\def\@glsxtr@docdefval{0}}
+\define@choicekey{glossaries-extra.sty}{docdef}
+ [\@glsxtr@docdefsetting\@glsxtr@docdefval]%
+ {false,true,restricted,atom}[true]%
+{%
+ \ifnum\@glsxtr@docdefval>1\relax
+ \renewcommand*{\@glsdoifexistsorwarn}{\glsdoifexists}%
+ \else
+ \renewcommand*{\@glsdoifexistsorwarn}{\glsdoifexistsorwarn}%
+ \fi
+}
+\newcommand*{\if@glsxtrdocdefrestricted}{\ifnum\@glsxtr@docdefval>1 }
+\newcommand*{\@glsdoifexistsorwarn}{\glsdoifexistsorwarn}
+\define@boolkey{glossaries-extra.sty}[@glsxtr]{indexcrossrefs}[true]{%
+ \if@glsxtrindexcrossrefs
+ \else
+ \renewcommand*{\@glsxtr@autoindexcrossrefs}{}%
+ \fi
+}
+\@glsxtrindexcrossrefsfalse
+\newcommand*{\@glsxtr@autoindexcrossrefs}{\@glsxtrindexcrossrefstrue}
+\define@boolkey{glossaries-extra.sty}[@glsxtr@]{autoseeindex}[true]{%
+}
+\@glsxtr@autoseeindextrue
+\define@boolkey{glossaries-extra.sty}[@glsxtr@]{equations}[true]{%
+}
+\@glsxtr@equationsfalse
+\let\glsxtr@float\@float
+\let\glsxtr@dblfloat\@dblfloat
+\define@boolkey{glossaries-extra.sty}[@glsxtr@]{floats}[true]{%
+ \if@glsxtr@floats
+ \renewcommand*{\@float}[1]{\renewcommand{\glscounter}{##1}\glsxtr@float{##1}}%
+ \renewcommand*{\@dblfloat}[1]{\renewcommand{\glscounter}{##1}\glsxtr@dblfloat{##1}}%
+ \else
+ \let\@float\glsxtr@float
+ \let\@dblfloat\glsxtr@dblfloat
+ \fi
+}
+\@glsxtr@floatsfalse
+\newcommand*{\GlossariesExtraWarning}[1]{\PackageWarning{glossaries-extra}{#1}}
+\newcommand*{\GlossariesExtraWarningNoLine}[1]{%
+ \PackageWarningNoLine{glossaries-extra}{#1}}
+\@glsxtr@declareoption{nowarn}{%
+ \let\GlossariesExtraWarning\@gobble
+ \let\GlossariesExtraWarningNoLine\@gobble
+ \glsxtr@dooption{nowarn}%
+}
+\newcommand*{\@glsxtr@defpostpunc}{}
+\@glsxtr@declareoption{postdot}{%
+ \glsxtr@dooption{nopostdot=false}%
+ \renewcommand*{\@glsxtr@defpostpunc}{%
+ \renewcommand*{\glspostdescription}{%
+ \ifglsnopostdot\else.\spacefactor\sfcode`\. \fi}%
+ }%
+}
+
+\define@choicekey{glossaries-extra.sty}{nopostdot}{true,false}[true]{%
+ \glsxtr@dooption{nopostdot=#1}%
+ \renewcommand*{\@glsxtr@defpostpunc}{%
+ \renewcommand*{\glspostdescription}{%
+ \ifglsnopostdot\else.\spacefactor\sfcode`\. \fi}%
+ }%
+}
+\define@key{glossaries-extra.sty}{postpunc}{%
+ \glsxtr@dooption{nopostdot=false}%
+ \ifstrequal{#1}{dot}%
+ {%
+ \renewcommand*{\@glsxtr@defpostpunc}{%
+ \renewcommand*{\glspostdescription}{.\spacefactor\sfcode`\. }%
+ }%
+ }%
+ {%
+ \ifstrequal{#1}{comma}%
+ {%
+ \renewcommand*{\@glsxtr@defpostpunc}{%
+ \renewcommand*{\glspostdescription}{,}%
+ }%
+ }%
+ {%
+ \ifstrequal{#1}{none}%
+ {%
+ \glsxtr@dooption{nopostdot=true}%
+ \renewcommand*{\@glsxtr@defpostpunc}{%
+ \renewcommand*{\glspostdescription}{}%
+ }%
+ }%
+ {%
+ \renewcommand*{\@glsxtr@defpostpunc}{%
+ \renewcommand*{\glspostdescription}{#1}%
+ }%
+ }%
+ }%
+ }%
+}
+\newcommand*{\glsxtrabbrvtype}{\glsdefaulttype}
+\newcommand*{\@glsxtr@abbreviationsdef}{}
+
+\newcommand*{\@glsxtr@doabbreviationsdef}{%
+ \@ifpackageloaded{babel}%
+ {\providecommand{\abbreviationsname}{\acronymname}}%
+ {\providecommand{\abbreviationsname}{Abbreviations}}%
+ \newglossary[glg-abr]{abbreviations}{gls-abr}{glo-abr}{\abbreviationsname}%
+ \renewcommand*{\glsxtrabbrvtype}{abbreviations}%
+ \newcommand*{\printabbreviations}[1][]{%
+ \printglossary[type=\glsxtrabbrvtype,##1]%
+ }%
+ \disable@keys{glossaries-extra.sty}{abbreviations}%
+ \ifglsacronym
+ \else
+ \renewcommand*{\acronymtype}{\glsxtrabbrvtype}%
+ \fi
+}%
+\@glsxtr@declareoption{abbreviations}{%
+ \let\@glsxtr@abbreviationsdef\@glsxtr@doabbreviationsdef
+}
+\newcommand*{\GlsXtrDefineAbbreviationShortcuts}{%
+ \newcommand*{\ab}{\cgls}%
+ \newcommand*{\abp}{\cglspl}%
+ \newcommand*{\as}{\glsxtrshort}%
+ \newcommand*{\asp}{\glsxtrshortpl}%
+ \newcommand*{\al}{\glsxtrlong}%
+ \newcommand*{\alp}{\glsxtrlongpl}%
+ \newcommand*{\af}{\glsxtrfull}%
+ \newcommand*{\afp}{\glsxtrfullpl}%
+ \newcommand*{\Ab}{\cGls}%
+ \newcommand*{\Abp}{\cGlspl}%
+ \newcommand*{\As}{\Glsxtrshort}%
+ \newcommand*{\Asp}{\Glsxtrshortpl}%
+ \newcommand*{\Al}{\Glsxtrlong}%
+ \newcommand*{\Alp}{\Glsxtrlongpl}%
+ \newcommand*{\Af}{\Glsxtrfull}%
+ \newcommand*{\Afp}{\Glsxtrfullpl}%
+ \newcommand*{\AB}{\cGLS}%
+ \newcommand*{\ABP}{\cGLSpl}%
+ \newcommand*{\AS}{\GLSxtrshort}%
+ \newcommand*{\ASP}{\GLSxtrshortpl}%
+ \newcommand*{\AL}{\GLSxtrlong}%
+ \newcommand*{\ALP}{\GLSxtrlongpl}%
+ \newcommand*{\AF}{\GLSxtrfull}%
+ \newcommand*{\AFP}{\GLSxtrfullpl}%
+ \providecommand*{\newabbr}{\newabbreviation}%
+ \let\GlsXtrDefineAbbreviationShortcuts\relax
+}
+\newcommand*{\GlsXtrDefineAcShortcuts}{%
+ \newcommand*{\ac}{\cgls}%
+ \newcommand*{\acp}{\cglspl}%
+ \newcommand*{\acs}{\glsxtrshort}%
+ \newcommand*{\acsp}{\glsxtrshortpl}%
+ \newcommand*{\acl}{\glsxtrlong}%
+ \newcommand*{\aclp}{\glsxtrlongpl}%
+ \newcommand*{\acf}{\glsxtrfull}%
+ \newcommand*{\acfp}{\glsxtrfullpl}%
+ \newcommand*{\Ac}{\cGls}%
+ \newcommand*{\Acp}{\cGlspl}%
+ \newcommand*{\Acs}{\Glsxtrshort}%
+ \newcommand*{\Acsp}{\Glsxtrshortpl}%
+ \newcommand*{\Acl}{\Glsxtrlong}%
+ \newcommand*{\Aclp}{\Glsxtrlongpl}%
+ \newcommand*{\Acf}{\Glsxtrfull}%
+ \newcommand*{\Acfp}{\Glsxtrfullpl}%
+ \newcommand*{\AC}{\cGLS}%
+ \newcommand*{\ACP}{\cGLSpl}%
+ \newcommand*{\ACS}{\GLSxtrshort}%
+ \newcommand*{\ACSP}{\GLSxtrshortpl}%
+ \newcommand*{\ACL}{\GLSxtrlong}%
+ \newcommand*{\ACLP}{\GLSxtrlongpl}%
+ \newcommand*{\ACF}{\GLSxtrfull}%
+ \newcommand*{\ACFP}{\GLSxtrfullpl}%
+ \providecommand*{\newabbr}{\newabbreviation}%
+ \let\GlsXtrDefineAcShortcuts\relax
+}
+\newcommand*{\GlsXtrDefineOtherShortcuts}{%
+ \newcommand*{\newentry}{\newglossaryentry}%
+ \ifdef\printsymbols
+ {%
+ \newcommand*{\newsym}{\glsxtrnewsymbol}%
+ }{}%
+ \ifdef\printnumbers
+ {%
+ \newcommand*{\newnum}{\glsxtrnewnumber}%
+ }{}%
+ \let\GlsXtrDefineOtherShortcuts\relax
+}
+\newcommand*{\@glsxtr@setupshortcuts}{}
+\newcommand*{\@glsxtr@shortcutsval}{\ifglsacrshortcuts acro\else none\fi}%
+\define@choicekey{glossaries-extra.sty}{shortcuts}%
+ [\@glsxtr@shortcutsval\@glsxtr@shortcutsnr]%
+ {acronyms,acro,abbreviations,abbr,other,all,true,ac,none,false}[true]{%
+ \ifcase\@glsxtr@shortcutsnr\relax % acronyms
+ \renewcommand*{\@glsxtr@setupshortcuts}{%
+ \glsacrshortcutstrue
+ \DefineAcronymSynonyms
+ }%
+ \or % acro
+ \renewcommand*{\@glsxtr@setupshortcuts}{%
+ \glsacrshortcutstrue
+ \DefineAcronymSynonyms
+ }%
+ \or % abbreviations
+ \renewcommand*{\@glsxtr@setupshortcuts}{%
+ \GlsXtrDefineAbbreviationShortcuts
+ }%
+ \or % abbr
+ \renewcommand*{\@glsxtr@setupshortcuts}{%
+ \GlsXtrDefineAbbreviationShortcuts
+ }%
+ \or % other
+ \renewcommand*{\@glsxtr@setupshortcuts}{%
+ \GlsXtrDefineOtherShortcuts
+ }%
+ \or % all
+ \renewcommand*{\@glsxtr@setupshortcuts}{%
+ \glsacrshortcutstrue
+ \GlsXtrDefineAcShortcuts
+ \GlsXtrDefineAbbreviationShortcuts
+ \GlsXtrDefineOtherShortcuts
+ }%
+ \or % true
+ \renewcommand*{\@glsxtr@setupshortcuts}{%
+ \glsacrshortcutstrue
+ \GlsXtrDefineAcShortcuts
+ \GlsXtrDefineAbbreviationShortcuts
+ \GlsXtrDefineOtherShortcuts
+ }%
+ \or % ac
+ \renewcommand*{\@glsxtr@setupshortcuts}{%
+ \glsacrshortcutstrue
+ \GlsXtrDefineAcShortcuts
+ }%
+ \else % none, false
+ \renewcommand*{\@glsxtr@setupshortcuts}{}%
+ \fi
+ }
+\newcommand*{\@glsxtr@doaccsupp}{}
+\@glsxtr@declareoption{accsupp}{%
+ \renewcommand*{\@glsxtr@doaccsupp}{\RequirePackage{glossaries-accsupp}}}
+\newcommand*{\@glsxtr@doloadprefix}{}
+\@glsxtr@declareoption{prefix}{%
+ \renewcommand*{\@glsxtr@doloadprefix}{\RequirePackage{glossaries-prefix}}}
+\newcommand{\glsxtrNoGlossaryWarning}[1]{%
+ \GlossariesExtraWarning{Glossary `#1' is missing}%
+ \@glsxtr@defaultnoglossarywarning{#1}%
+}
+\define@choicekey{glossaries-extra.sty}{nomissingglstext}
+ [\@glsxtr@nomissingglstextval\@glsxtr@nomissingglstextnr]%
+ {true,false}[true]{%
+ \ifcase\@glsxtr@nomissingglstextnr\relax % true
+ \renewcommand{\glsxtrNoGlossaryWarning}[1]{\null}%
+ \else % false
+ \renewcommand{\glsxtrNoGlossaryWarning}[1]{%
+ \@glsxtr@defaultnoglossarywarning{#1}%
+ }%
+ \fi
+ }
+\newcommand*{\@glsxtr@redefstyles}{}
+\define@key{glossaries-extra.sty}{stylemods}[default]{%
+ \ifstrequal{#1}{default}%
+ {%
+ \renewcommand*{\@glsxtr@redefstyles}{%
+ \RequirePackage{glossaries-extra-stylemods}}%
+ }%
+ {%
+ \ifstrequal{#1}{all}%
+ {%
+ \renewcommand*{\@glsxtr@redefstyles}{%
+ \PassOptionsToPackage{all}{glossaries-extra-stylemods}%
+ \RequirePackage{glossaries-extra-stylemods}%
+ }%
+ }%
+ {%
+ \renewcommand*{\@glsxtr@redefstyles}{}%
+ \@for\@glsxtr@tmp:=#1\do{%
+ \IfFileExists{glossary-\@glsxtr@tmp.sty}%
+ {%
+ \eappto\@glsxtr@redefstyles{%
+ \noexpand\RequirePackage{glossary-\@glsxtr@tmp}}%
+ }%
+ {%
+ \PackageError{glossaries-extra}%
+ {Glossaries style package `glossary-\@glsxtr@tmp.sty'
+ doesn't exist (did you mean to use the `style' key?)}%
+ {The list of values (#1) in the `stylemods' key should
+ match the glossary-xxx.sty files provided with
+ glossaries.sty}%
+ }%
+ }%
+ \appto\@glsxtr@redefstyles{\RequirePackage{glossaries-extra-stylemods}[=v1.48]}%
+ }
+ }%
+}
+\newcommand*{\@glsxtr@do@style}{}
+\define@key{glossaries-extra.sty}{style}{%
+ \renewcommand*{\@glsxtr@do@style}{%
+ \setkeys{glossaries.sty}{style={#1}}%
+ \setglossarystyle{#1}%
+ }%
+}
+\newcommand*{\glsxtr@inc@wrglossaryctr}[1]{}
+\newcommand*{\GlsXtrInternalLocationHyperlink}[3]{%
+ \glsxtrhyperlink{#1#2#3}{#3}%
+}
+\newcommand*{\@glsxtr@wrglossary@locationhyperlink}[3]{%
+ \pageref{wrglossary.#3}%
+}
+\@glsxtr@declareoption{indexcounter}{%
+ \glsxtr@dooption{counter=wrglossary}%
+ \ifundef\c@wrglossary
+ {%
+ \newcounter{wrglossary}%
+ \renewcommand{\thewrglossary}{\arabic{wrglossary}}%
+ }%
+ {}%
+ \renewcommand*{\glsxtr@inc@wrglossaryctr}[1]{%
+ \ifdefstring\@gls@counter{wrglossary}%
+ {%
+ \refstepcounter{wrglossary}%
+ \label{wrglossary.\thewrglossary}%
+ }%
+ {}%
+ }%
+ \renewcommand*{\GlsXtrInternalLocationHyperlink}[3]{%
+ \ifdefstring\glsentrycounter{wrglossary}%
+ {%
+ \@glsxtr@wrglossary@locationhyperlink{##1}{##2}{##3}%
+ }%
+ {\glsxtrhyperlink{##1##2##3}{##3}}%
+ }%
+}
+\newcommand*{\@glsxtrwrglossmark}{}
+\newcommand*{\@@glsxtrwrglossmark}{}
+\AtBeginDocument{\renewcommand*{\@@glsxtrwrglossmark}{\@glsxtrwrglossmark}}
+\newcommand*{\glsxtrwrglossmark}{\ensuremath{\cdot}}
+\newcommand\@glsxtr@doshowtarget[2]{#2}
+\define@choicekey{glossaries-extra.sty}{debug}
+ [\@glsxtr@debugval\@glsxtr@debugnr]%
+ {true,false,showtargets,showwrgloss,all,showaccsupp}[true]{%
+ \ifcase\@glsxtr@debugnr\relax % true
+ \glsxtr@dooption{debug=true}%
+ \renewcommand*{\@glsxtrwrglossmark}{}%
+ \or % false
+ \glsxtr@dooption{debug=false}%
+ \renewcommand*{\@glsxtrwrglossmark}{}%
+ \let\@glsxtr@doshowtarget\@secondoftwo
+ \or % showtargets
+ \glsxtr@dooption{debug=showtargets}%
+ \def\@glsxtr@doshowtarget{\@glsxtrshowtargetleft}%
+ \or % showwrgloss
+ \glsxtr@dooption{debug=true}%
+ \renewcommand*{\@glsxtrwrglossmark}{\glsxtrwrglossmark}%
+ \or % all
+ \glsxtr@dooption{debug=showtargets,debug=showaccsupp}%
+ \renewcommand*{\@glsxtrwrglossmark}{\glsxtrwrglossmark}%
+ \def\@glsxtr@doshowtarget{\@glsxtrshowtargetleft}%
+ \or % showaccsupp
+ \glsxtr@dooption{debug=showaccsupp}%
+ \fi
+ }
+\newcommand*{\glsxtrshowtargetouter}{\glsshowtargetouter}
+\newcommand*{\glsxtrshowtargetinner}[1]{\glsshowtargetinner{#1}}
+\newcommand{\@glsxtrshowtargetleft}[2]{\@glsshowtarget{#1}#2\@glsxtrshowtargetmark}%
+\newcommand{\@glsxtrshowtargetright}[2]{\@glsxtrshowtargetmark#2\@glsshowtarget{#1}}%
+\newcommand{\@glsxtrshowtargetmark}{}%
+\define@choicekey{glossaries-extra.sty}{showtargets}
+ [\@glsxtr@showtargetsval\@glsxtr@showtargetsnr]%
+ {left,right,innerleft,innerright,annoteleft,annoteright}%
+ {%
+ \glsxtr@dooption{debug=showtargets}%
+ \ifcase\@glsxtr@showtargetsnr\relax
+ \def\@glsxtr@doshowtarget{\@glsxtrshowtargetleft}%
+ \def\glsxtrshowtargetouter{\glsshowtargetouter}%
+ \def\glsxtrshowtargetinner{\glsshowtargetinner}%
+ \let\@glsxtrshowtargetmark\empty
+ \or
+ \def\@glsxtr@doshowtarget{\@glsxtrshowtargetright}%
+ \def\glsxtrshowtargetouter{\glsshowtargetouter}%
+ \def\glsxtrshowtargetinner{\glsshowtargetinner}%
+ \let\@glsxtrshowtargetmark\empty
+ \or
+ \def\@glsxtr@doshowtarget{\@glsxtrshowtargetleft}%
+ \def\glsxtrshowtargetouter{\glsxtrshowtargetinner}%
+ \def\glsxtrshowtargetinner{\glsshowtargetinnersymleft}%
+ \let\@glsxtrshowtargetmark\empty
+ \or
+ \def\@glsxtr@doshowtarget{\@glsxtrshowtargetright}%
+ \def\glsxtrshowtargetouter{\glsxtrshowtargetinner}%
+ \def\glsxtrshowtargetinner{\glsshowtargetinnersymright}%
+ \let\@glsxtrshowtargetmark\empty
+ \or
+ \def\@glsxtr@doshowtarget{\@glsxtrshowtargetleft}%
+ \def\glsxtrshowtargetouter{\glsxtrshowtargetinner}%
+ \def\glsxtrshowtargetinner{\glsshowtargetinnersymleft}%
+ \def\@glsxtrshowtargetmark{\@glsshowtargetmarkfmt\glsxtrshowtargetsymbolright}%
+ \or
+ \def\@glsxtr@doshowtarget{\@glsxtrshowtargetright}%
+ \def\glsxtrshowtargetouter{\glsxtrshowtargetinner}%
+ \def\glsxtrshowtargetinner{\glsshowtargetinnersymright}%
+ \def\@glsxtrshowtargetmark{\@glsshowtargetmarkfmt\glsxtrshowtargetsymbolleft}%
+ \fi
+ }
+\DeclareOptionX*{%
+ \expandafter\glsxtr@dooption\expandafter{\CurrentOption}}
+\ProcessOptionsX
+\RequirePackage{glossaries}
+\@glsxtr@doaccsupp
+\@glsxtr@doloadprefix
+\@glsxtr@defpostpunc
+\def\glsdoshowtarget{\@glsxtr@doshowtarget}
+\newcommand{\glsxtrshowtargetsymbolright}{{\tiny$\triangleleft$}}%
+\newcommand{\glsxtrshowtargetsymbolleft}{{\tiny$\triangleright$}}%
+\providecommand*{\glsshowtargetinner}[1]{{\glsshowtargetfont [#1]}}
+\providecommand*{\glsshowtargetfont}{\ttfamily\footnotesize}
+\newcommand*{\glsshowtargetinnersymleft}[1]{%
+ \glsshowtargetinner{#1}\allowbreak\glsxtrshowtargetsymbolleft}
+\newcommand*{\glsshowtargetinnersymright}[1]{%
+ \glsxtrshowtargetsymbolright\allowbreak\glsshowtargetinner{#1}}
+\providecommand*{\glsshowtargetouter}[1]{%
+ \glsshowtargetsymbol\marginpar{\glsshowtargetsymbol\glsshowtargetfont #1}}
+\providecommand*{\@glsshowtarget}[1]{}
+\def\glsshowtarget#1{%
+ \glsxtrtitleorpdforheading
+ {%
+ \ifmmode
+ \nfss@text{\glsxtrshowtargetinner{#1}}%
+ \else
+ \ifinner
+ \glsxtrshowtargetinner{#1}%
+ \else
+ \glsxtrshowtargetouter{#1}%
+ \fi
+ \fi
+ }%
+ {[#1]}%
+ {{\protect\glsshowtargetinner{#1}}}%
+}
+\newcommand*{\@glsshowtargetmarkfmt}[1]{%
+ \glsxtrtitleorpdforheading
+ {%
+ \ifmmode \nfss@text{#1}\else #1\fi
+ }%
+ {}%
+ {\ifmmode \nfss@text{#1}\else #1\fi}%
+}
+\let\@glsxtr@org@doseeglossary\@do@seeglossary
+\newcommand*{\@glsxtr@doseeglossary}[2]{%
+ \glsdoifexists{#1}%
+ {%
+ \@@glsxtrwrglossmark
+ \@glsxtr@org@doseeglossary{#1}{#2}%
+ }%
+}
+\newcommand*{\@glsxtr@dosee@alsoindex@glossary}[2]{%
+ \@glsxtr@recordsee{#1}{#2}%
+ \@glsxtr@doseeglossary{#1}{#2}%
+}
+\let\@glsxtr@org@gloautosee\@glo@autosee
+\if@glsxtr@autoseeindex
+\else
+ \ifdef\@glsxtr@org@gloautosee
+ {}%
+ {\PackageError{glossaries-extra}{`autoseeindex=false' package
+ option requires at least v4.30 of glossaries.sty}%
+ {You need to update the glossaries.sty package}%
+ }
+\fi
+\ifdef\@glo@autosee
+{%
+ \renewcommand*{\@glo@autosee}{%
+ \if@glsxtr@autoseeindex\@glsxtr@org@gloautosee\fi}%
+}%
+{}
+\renewcommand*{\gls@checkseeallowed}{%
+ \if@glsxtr@autoseeindex\@gls@see@noindex\fi
+}
+\@glsxtr@abbreviationsdef
+\let\@glsxtr@abbreviationsdef\relax
+\@glsxtr@setupshortcuts
+\@glsxtr@redef@forglsentries
+\renewcommand{\glsxtr@dooption}[1]{\setupglossaries{#1}}%
+\disable@keys{glossaries-extra.sty}{accsupp}
+\newcommand*{\glossariesextrasetup}[1]{%
+ \let\glsxtr@setup@record\relax
+ \let\@glsxtr@setupshortcuts\relax
+ \let\@glsxtr@redef@forglsentries\relax
+ \let\@glsxtr@doloadprefix\relax
+ \setkeys{glossaries-extra.sty}{#1}%
+ \@glsxtr@abbreviationsdef
+ \let\@glsxtr@abbreviationsdef\relax
+ \@glsxtr@setupshortcuts
+ \glsxtr@setup@record
+ \@glsxtr@redef@forglsentries
+ \@glsxtr@doloadprefix
+}
+\let\glsxtr@org@@do@wrglossary\@@do@wrglossary
+\newcommand*{\glsxtr@@do@wrglossary}[1]{%
+ \@@glsxtrwrglossmark
+ \glsxtr@inc@wrglossaryctr{#1}%
+ \glsxtr@org@@do@wrglossary{#1}%
+}
+\let\glsxtr@saveentrycounter\@gls@saveentrycounter
+\let\@gls@saveentrycounter\glsxtr@indexonly@saveentrycounter
+\renewcommand*\@gls@getcounterprefix[2]{%
+ \protected@edef\@gls@thisloc{#1}\protected@edef\@gls@thisHloc{#2}%
+ \ifx\@gls@thisloc\@gls@thisHloc
+ \def\@glo@counterprefix{}%
+ \else
+ \def\@gls@get@counterprefix##1.#1##2\end@getprefix{%
+ \def\@glo@tmp{##2}%
+ \ifx\@glo@tmp\@empty
+ \def\@glo@counterprefix{}%
+ \else
+ \def\@glo@counterprefix{##1}%
+ \fi
+ }%
+ \@gls@get@counterprefix#2.#1\end@getprefix
+ \ifx\@glo@counterprefix\@empty
+ \ifx\@glsxtr@record@setting\@glsxtr@record@setting@nameref
+ \else
+ \GlossariesExtraWarning{Hyper target `#2' can't be formed by
+ prefixing^^Jlocation `#1'. You need to modify the
+ definition of \string\theH\@gls@counter^^Jotherwise you
+ will get the warning: "`name{\@gls@counter.#1}' has been^^J
+ referenced but does not exist"%
+ \ifx\@glsxtr@record@setting\@glsxtr@record@setting@only
+ . You may want to consider using record=nameref instead%
+ \fi}%
+ \fi
+ \fi
+ \fi
+}
+\newcommand*{\@glsxtrdialecthook}{}
+\glsxtr@setup@record
+\AtBeginDocument{%
+ \disable@keys{glossaries-extra.sty}{abbreviations,docdef,record}%
+ \def\@glsxtrundeftag{\glsxtrundeftag}%
+}
+\newcommand*{\GlsXtrIfUnusedOrUndefined}[3]{%
+ \ifglsentryexists{#1}%
+ {\ifbool{glo@\glsdetoklabel{#1}@flag}{#3}{#2}}%
+ {#2}%
+}
+\ifdef\s@ifglossaryexists
+{}
+{
+ \renewcommand{\ifglossaryexists}{%
+ \@ifstar\s@ifglossaryexists\@ifglossaryexists
+ }
+ \newcommand{\@ifglossaryexists}[3]{%
+ \ifcsundef{@glotype@#1@out}{#3}{#2}%
+ }
+ \newcommand{\s@ifglossaryexists}[3]{%
+ \ifcsundef{glolist@#1}{#3}{#2}%
+ }
+}
+\newcommand{\glsxtrifemptyglossary}[3]{%
+ \ifcsdef{glolist@#1}%
+ {%
+ \ifcsstring{glolist@#1}{,}{#2}{#3}%
+ }%
+ {%
+ \glsxtrundefaction{Glossary type `#1' doesn't exist}{}%
+ #2%
+ }%
+}
+\newcommand*{\glsxtrifkeydefined}[3]{%
+ \key@ifundefined{glossentry}{#1}{#3}{#2}%
+}
+\newcommand*{\glsxtrprovidestoragekey}{%
+ \@ifstar\@sglsxtr@provide@storagekey\@glsxtr@provide@storagekey
+}
+\newcommand*{\@glsxtr@provide@storagekey}[3]{%
+ \key@ifundefined{glossentry}{#1}%
+ {%
+ \define@key{glossentry}{#1}{\csdef{@glo@#1}{##1}}%
+ \appto\@gls@keymap{,{#1}{#1}}%
+ \appto\@newglossaryentryprehook{\csdef{@glo@#1}{#2}}%
+ \appto\@newglossaryentryposthook{%
+ \letcs{\@glo@tmp}{@glo@#1}%
+ \gls@assign@field{#2}{\@glo@label}{#1}{\@glo@tmp}%
+ }%
+ \ifblank{#3}
+ {}%
+ {%
+ \newcommand*{#3}[1]{\@gls@entry@field{##1}{#1}}%
+ }%
+ }%
+ {%
+ \ifblank{#3}
+ {}%
+ {%
+ \providecommand*{#3}[1]{\@gls@entry@field{##1}{#1}}%
+ }%
+ }%
+}
+\newcommand*{\s@glsxtr@provide@storagekey}[1]{%
+ \key@ifundefined{glossentry}{#1}%
+ {%
+ \expandafter\newcommand\expandafter*\expandafter
+ {\csname gls@assign@#1@field\endcsname}[2]{%
+ \@@gls@expand@field{##1}{#1}{##2}%
+ }%
+ }%
+ {}%
+ \@glsxtr@provide@addstoragekey{#1}%
+}
+\newcommand{\GlsXtrFmtField}{useri}
+\newcommand{\GlsXtrFmtDefaultOptions}{noindex}
+\newrobustcmd*{\glsxtrfmt}{\@ifstar\s@glsxtrfmt\@glsxtrfmt}
+\newcommand*{\@glsxtrfmt}[3][]{\@@glsxtrfmt{#1}{#2}{#3}{}}
+\newcommand*{\s@glsxtrfmt}[3][]{%
+ \new@ifnextchar[{\s@@glsxtrfmt{#1}{#2}{#3}}%
+ {\@@glsxtrfmt{#1}{#2}{#3}{}}%
+}
+\def\s@@glsxtrfmt#1#2#3[#4]{\@@glsxtrfmt{#1}{#2}{#3}{#4}}
+\newcommand*{\@@glsxtrfmt}[4]{%
+ \begingroup
+ \def\glslabel{#2}%
+ \glsdoifexistsordo{#2}%
+ {%
+ \ifglshasfield{\GlsXtrFmtField}{#2}%
+ {%
+ \let\do@gls@link@checkfirsthyper\relax
+ \expandafter\@gls@link\expandafter[\GlsXtrFmtDefaultOptions,#1]{#2}%
+ {\glsxtrfmtdisplay{\glscurrentfieldvalue}{#3}{#4}}%
+ }%
+ {\glsxtrfmtdisplay{@firstofone}{#3}{#4}}%
+ }%
+ {%
+ \begingroup
+ \@gls@setdefault@glslink@opts
+ \setkeys{glslink}{\GlsXtrFmtDefaultOptions,#1}%
+ \ifKV@glslink@noindex\else\glsadd{#2}\fi
+ \endgroup
+ \glsxtrfmtdisplay{@firstofone}{#3}{#4}%
+ }%
+ \endgroup
+}
+\newcommand{\glsxtrfmtdisplay}[3]{\csuse{#1}{#2}#3}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\glsxtrentryfmt}[2]{%
+ \texorpdfstring{\@glsxtrentryfmt{#1}{#2}}{\glsxtrpdfentryfmt{#1}{#2}}%
+ }
+}
+{
+ \newcommand*{\glsxtrentryfmt}{\@glsxtrentryfmt}
+}
+\newcommand*{\glsxtrpdfentryfmt}[2]{#2}
+\newrobustcmd*{\@glsxtrentryfmt}[2]{%
+ {%
+ \protected@edef\glslabel{#1}%
+ \glsdoifexistsordo{#1}%
+ {%
+ \ifglshasfield{\GlsXtrFmtField}{#1}%
+ {%
+ \csuse{\glscurrentfieldvalue}{#2}%
+ }%
+ {#2}%
+ }%
+ {#2}%
+ }%
+}
+\newcommand*{\glsxtrfieldlistadd}[3]{%
+ \listcsadd{glo@\glsdetoklabel{#1}@#2}{#3}%
+}
+\newcommand*{\glsxtrfieldlistgadd}[3]{%
+ \listcsgadd{glo@\glsdetoklabel{#1}@#2}{#3}%
+}
+\newcommand*{\glsxtrfieldlisteadd}[3]{%
+ \listcseadd{glo@\glsdetoklabel{#1}@#2}{#3}%
+}
+\newcommand*{\glsxtrfieldlistxadd}[3]{%
+ \listcsxadd{glo@\glsdetoklabel{#1}@#2}{#3}%
+}
+\newcommand*{\glsxtrfielddolistloop}[2]{%
+ \dolistcsloop{glo@\glsdetoklabel{#1}@#2}%
+}
+\newcommand*{\glsxtrfieldforlistloop}[3]{%
+ \forlistcsloop{#3}{glo@\glsdetoklabel{#1}@#2}%
+}
+\newrobustcmd*{\glsxtrfieldformatlist}[2]{%
+ \begingroup
+ \def\@dtl@formatlist@itemsep{}%
+ \def\@dtl@formatlist@lastitem{}%
+ \def\@dtl@formatlist@prelastitem{}%
+ \def\@dtl@formatlist@prelastitemsep{}%
+ \forlistcsloop{\@dtl@formatlist@handler}{glo@\glsdetoklabel{#1}@#2}%
+ \@dtl@formatlist@prelastitem\@dtl@formatlist@lastitem
+ \endgroup
+}
+\newcommand*{\glsxtrfieldifinlist}[5]{%
+ \ifinlistcs{#3}{glo@\glsdetoklabel{#1}@#2}{#4}{#5}%
+}
+\newcommand*{\glsxtrfieldxifinlist}[5]{%
+ \xifinlistcs{#3}{glo@\glsdetoklabel{#1}@#2}{#4}{#5}%
+}
+\newcommand*{\glsxtrforcsvfield}{%
+ \@ifstar\s@glsxtrforcsvfield\@glsxtrforcsvfield
+}
+\newcommand*{\@glsxtrforcsvfield}[3]{%
+ \@glsxtrifhasfield{#2}{#1}%
+ {%
+ \let\glsxtrendfor\@endfortrue
+ \@for\@glsxtr@label:=\glscurrentfieldvalue\do
+ {\expandafter#3\expandafter{\@glsxtr@label}}}%
+ {}%
+}
+\newcommand*{\s@glsxtrforcsvfield}[3]{%
+ \s@glsxtrifhasfield{#2}{#1}%
+ {%
+ \let\glsxtrendfor\@endfortrue
+ \@for\@glsxtr@label:=\glscurrentfieldvalue\do
+ {\expandafter#3\expandafter{\@glsxtr@label}}}%
+ {}%
+}
+\newrobustcmd*{\glsxtrfieldformatcsvlist}[2]{%
+ \@glsxtrifhasfield{#2}{#1}%
+ {\@dtlformatlist\glscurrentfieldvalue}%
+ {}%
+}
+\newcommand*{\GlsXtrIfFieldValueInCsvList}{%
+ \@ifstar\s@GlsXtrIfFieldValueInCsvList\@GlsXtrIfFieldValueInCsvList
+}
+\newcommand*{\@GlsXtrIfFieldValueInCsvList}[5]{%
+ \@glsxtrifhasfield{#2}{#1}%
+ {%
+ \expandafter\DTLifinlist\expandafter{\glscurrentfieldvalue}%
+ {#3}{#4}{#5}%
+ }%
+ {#5}%
+}
+\newcommand*{\s@GlsXtrIfFieldValueInCsvList}[5]{%
+ \s@glsxtrifhasfield{#2}{#1}%
+ {%
+ \expandafter\DTLifinlist\expandafter{\glscurrentfieldvalue}%
+ {#3}{#4}{#5}%
+ }%
+ {#5}%
+}
+\newcommand*{\GlsXtrIfValueInFieldCsvList}{%
+ \@ifstar\s@GlsXtrIfValueInFieldCsvList\@GlsXtrIfValueInFieldCsvList
+}
+\newcommand*{\@GlsXtrIfValueInFieldCsvList}[5]{%
+ \@glsxtrifhasfield{#2}{#1}%
+ {%
+ \DTLifinlist{#3}{\glscurrentfieldvalue}{#4}{#5}%
+ }%
+ {#5}%
+}
+\newcommand*{\s@GlsXtrIfValueInFieldCsvList}[5]{%
+ \s@glsxtrifhasfield{#2}{#1}%
+ {%
+ \DTLifinlist{#3}{\glscurrentfieldvalue}{#4}{#5}%
+ }%
+ {#5}%
+}
+\newcommand*{\xGlsXtrIfValueInFieldCsvList}{%
+ \@ifstar\s@xGlsXtrIfValueInFieldCsvList\@xGlsXtrIfValueInFieldCsvList
+}
+\newcommand*{\@xGlsXtrIfValueInFieldCsvList}[5]{%
+ \@glsxtrifhasfield{#2}{#1}%
+ {%
+ \protected@edef\@gls@tmp{#3}%
+ \expandafter\DTLifinlist\expandafter{\@gls@tmp}{\glscurrentfieldvalue}{#4}{#5}%
+ }%
+ {#5}%
+}
+\newcommand*{\s@xGlsXtrIfValueInFieldCsvList}[5]{%
+ \s@glsxtrifhasfield{#2}{#1}%
+ {%
+ \protected@edef\@gls@tmp{#3}%
+ \expandafter\DTLifinlist\expandafter{\@gls@tmp}{\glscurrentfieldvalue}{#4}{#5}%
+ }%
+ {#5}%
+}
+\newrobustcmd{\glsxtrifhasfield}{%
+ \@ifstar{\s@glsxtrifhasfield}{\@glsxtrifhasfield}%
+}
+\newcommand{\@glsxtrifhasfield}[4]{%
+ {\s@glsxtrifhasfield{#1}{#2}{#3}{#4}}%
+}
+\newcommand{\s@glsxtrifhasfield}[4]{%
+ \letcs{\glscurrentfieldvalue}{glo@\glsdetoklabel{#2}@#1}%
+ \ifundef\glscurrentfieldvalue
+ {#4}%
+ {%
+ \ifdefempty\glscurrentfieldvalue{#4}{#3}%
+ }%
+}
+\newcommand{\GlsXtrIfFieldNonZero}{%
+ \@ifstar\s@GlsXtrIfFieldNonZero\@GlsXtrIfFieldNonZero
+}
+\newcommand{\@GlsXtrIfFieldNonZero}[4]{%
+ \@GlsXtrIfFieldCmpNum{#1}{#2}{=}{0}{#4}{#3}%
+}
+\newcommand{\s@GlsXtrIfFieldNonZero}[4]{%
+ \s@GlsXtrIfFieldCmpNum{#1}{#2}{=}{0}{#4}{#3}%
+}
+\newcommand{\GlsXtrIfFieldEqNum}{%
+ \@ifstar\s@GlsXtrIfFieldEqNum\@GlsXtrIfFieldEqNum
+}
+\newcommand{\@GlsXtrIfFieldEqNum}[5]{%
+ \@GlsXtrIfFieldCmpNum{#1}{#2}{=}{#3}{#4}{#5}%
+}
+\newcommand{\s@GlsXtrIfFieldEqNum}[5]{%
+ \s@GlsXtrIfFieldCmpNum{#1}{#2}{=}{#3}{#4}{#5}%
+}
+\newcommand{\GlsXtrIfFieldCmpNum}{%
+ \@ifstar\s@GlsXtrIfFieldCmpNum\@GlsXtrIfFieldCmpNum
+}
+\newcommand{\@GlsXtrIfFieldCmpNum}[6]{%
+ {%
+ \letcs{\glscurrentfieldvalue}{glo@\glsdetoklabel{#2}@#1}%
+ \ifundef\glscurrentfieldvalue
+ {\def\glscurrentfieldvalue{0}}%
+ {%
+ \ifdefempty\glscurrentfieldvalue
+ {\def\glscurrentfieldvalue{0}}%
+ {}%
+ }%
+ \ifnum\glscurrentfieldvalue#3#4\relax #5\else #6\fi
+ }%
+}
+\newcommand{\s@GlsXtrIfFieldCmpNum}[6]{%
+ \letcs{\glscurrentfieldvalue}{glo@\glsdetoklabel{#2}@#1}%
+ \ifundef\glscurrentfieldvalue
+ {\def\glscurrentfieldvalue{0}}%
+ {%
+ \ifdefempty\glscurrentfieldvalue
+ {\def\glscurrentfieldvalue{0}}%
+ {}%
+ }%
+ \ifnum\glscurrentfieldvalue#3#4\relax #5\else #6\fi
+}
+\newcommand{\GlsXtrIfFieldUndef}[2]{%
+ \ifcsundef{glo@\glsdetoklabel{#2}@#1}%
+}
+\newcommand*{\glsxtrusefield}[2]{%
+ \@gls@entry@field{#1}{#2}%
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\Glsxtrusefield}[2]{%
+ \texorpdfstring
+ {\@Gls@entry@field{#1}{#2}}
+ {\@gls@entry@field{#1}{#2}}%
+ }
+}
+{
+ \newcommand*{\Glsxtrusefield}[2]{%
+ \@Gls@entry@field{#1}{#2}%
+ }
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\GLSxtrusefield}[2]{%
+ \texorpdfstring
+ {\glsdoifexists{#1}{\mfirstucMakeUppercase{\@gls@entry@field{#1}{#2}}}}%
+ {\@gls@entry@field{#1}{#2}}%
+ }
+}
+{
+ \newcommand*{\GLSxtrusefield}[2]{%
+ \glsdoifexists{#1}{\mfirstucMakeUppercase{\@gls@entry@field{#1}{#2}}}%
+ }
+}
+\newcommand*{\glsxtrentryparentname}[1]{%
+ \ifcsdef{glo@\glsdetoklabel{#1}@parent}%
+ {\csuse{glo@\csuse{glo@\glsdetoklabel{#1}@parent}@name}}%
+ {}%
+}
+\newcommand*{\glsxtrdeffield}[2]{\csdef{glo@\glsdetoklabel{#1}@#2}}
+\newcommand*{\glsxtredeffield}[2]{\protected@csedef{glo@\glsdetoklabel{#1}@#2}}
+\newcommand*{\glsxtrapptocsvfield}[3]{%
+ \ifcsdef{glo@\glsdetoklabel{#1}@#2}%
+ {\csappto{glo@\glsdetoklabel{#1}@#2}{,#3}}%
+ {\csdef{glo@\glsdetoklabel{#1}@#2}{#3}}%
+}
+\newcommand*{\glsxtrsetfieldifexists}[3]{\glsdoifexists{#1}{#3}}
+\newrobustcmd*{\GlsXtrSetField}[3]{%
+ \glsxtrsetfieldifexists{#1}{#2}%
+ {\csdef{glo@\glsdetoklabel{#1}@#2}{#3}}%
+}
+\newrobustcmd*{\GlstrLetField}[3]{%
+ \glsxtrsetfieldifexists{#1}{#2}%
+ {\cslet{glo@\glsdetoklabel{#1}@#2}{#3}}%
+}
+\newrobustcmd*{\csGlsXtrLetField}[3]{%
+ \glsxtrsetfieldifexists{#1}{#2}%
+ {\csletcs{glo@\glsdetoklabel{#1}@#2}{#3}}%
+}
+\newrobustcmd*{\GlsXtrLetFieldToField}[4]{%
+ \glsxtrsetfieldifexists{#1}{#2}%
+ {\csletcs{glo@\glsdetoklabel{#1}@#2}{glo@\glsdetoklabel{#3}@#4}}%
+}
+\newrobustcmd*{\gGlsXtrSetField}[3]{%
+ \glsxtrsetfieldifexists{#1}{#2}%
+ {\csgdef{glo@\glsdetoklabel{#1}@#2}{#3}}%
+}
+\newrobustcmd*{\xGlsXtrSetField}[3]{%
+ \glsxtrsetfieldifexists{#1}{#2}%
+ {\protected@csxdef{glo@\glsdetoklabel{#1}@#2}{#3}}%
+}
+\newrobustcmd*{\eGlsXtrSetField}[3]{%
+ \glsxtrsetfieldifexists{#1}{#2}%
+ {\protected@csedef{glo@\glsdetoklabel{#1}@#2}{#3}}%
+}
+\newcommand*{\GlsXtrIfFieldEqStr}{%
+ \@ifstar\s@GlsXtrIfFieldEqStr\@GlsXtrIfFieldEqStr
+}
+\newrobustcmd*{\@GlsXtrIfFieldEqStr}[5]{%
+ \@glsxtrifhasfield{#1}{#2}%
+ {%
+ \ifdefstring{\glscurrentfieldvalue}{#3}{#4}{#5}%
+ }%
+ {#5}%
+}
+\newrobustcmd*{\s@GlsXtrIfFieldEqStr}[5]{%
+ \s@glsxtrifhasfield{#1}{#2}%
+ {%
+ \ifdefstring{\glscurrentfieldvalue}{#3}{#4}{#5}%
+ }%
+ {#5}%
+}
+\newcommand*{\GlsXtrIfFieldEqXpStr}{%
+ \@ifstar\s@GlsXtrIfFieldEqXpStr\@GlsXtrIfFieldEqXpStr
+}
+\newrobustcmd*{\@GlsXtrIfFieldEqXpStr}[5]{%
+ \@glsxtrifhasfield{#1}{#2}%
+ {%
+ \protected@edef\@gls@tmp{#3}%
+ \ifdefequal{\glscurrentfieldvalue}{\@gls@tmp}{#4}{#5}%
+ }%
+ {#5}%
+}
+\newrobustcmd*{\s@GlsXtrIfFieldEqXpStr}[5]{%
+ \s@glsxtrifhasfield{#1}{#2}%
+ {%
+ \protected@edef\@gls@tmp{#3}%
+ \ifdefequal{\glscurrentfieldvalue}{\@gls@tmp}{#4}{#5}%
+ }%
+ {#5}%
+}
+\newcommand*{\GlsXtrIfXpFieldEqXpStr}{%
+ \@ifstar\s@GlsXtrIfXpFieldEqXpStr\@GlsXtrIfXpFieldEqXpStr
+}
+\newrobustcmd*{\@GlsXtrIfXpFieldEqXpStr}[5]{%
+ \@glsxtrifhasfield{#1}{#2}%
+ {%
+ \protected@edef\@gls@tmp{\glscurrentfieldvalue}%
+ \let\glscurrentfieldvalue\@gls@tmp
+ \protected@edef\@gls@tmp{#3}%
+ \ifdefequal{\glscurrentfieldvalue}{\@gls@tmp}{#4}{#5}%
+ }%
+ {#5}%
+}
+\newrobustcmd*{\s@GlsXtrIfXpFieldEqXpStr}[5]{%
+ \s@glsxtrifhasfield{#1}{#2}%
+ {%
+ \protected@edef\@gls@tmp{\glscurrentfieldvalue}%
+ \let\glscurrentfieldvalue\@gls@tmp
+ \protected@edef\@gls@tmp{#3}%
+ \ifdefequal{\glscurrentfieldvalue}{\@gls@tmp}{#4}{#5}%
+ }%
+ {#5}%
+}
+\ifdef\foreignlanguage
+{
+ \ifdef\GetTrackedDialectFromLanguageTag
+ {
+ \newcommand{\GlsXtrForeignText}[2]{%
+ \let\@glsxtr@org@currentfieldvalue\glscurrentfieldvalue
+ \glsxtrifhasfield{\GlsXtrForeignTextField}{#1}%
+ {%
+ \expandafter\GetTrackedDialectFromLanguageTag\expandafter
+ {\glscurrentfieldvalue}{\@glsxtr@dialect}%
+ \let\@glsxtr@locale\glscurrentfieldvalue
+ \let\glscurrentfieldvalue\@glsxtr@org@currentfieldvalue
+ \ifdefempty\@glsxtr@dialect
+ {%
+ \ifundef\TrackedDialectClosestSubMatch
+ {%
+ \GlossariesExtraWarning{Can't obtain dialect label
+ (tracklang v1.3.6+ required)}%
+ }%
+ {\let\@glsxtr@dialect\TrackedDialectClosestSubMatch}%
+ }%
+ {}%
+ \ifdefempty\@glsxtr@dialect
+ {%
+ }%
+ {%
+ \ifcsundef{captions\@glsxtr@dialect}{}%
+ {%
+ \IfTrackedDialectHasMapping{\@glsxtr@dialect}%
+ {%
+ \edef\@glsxtr@dialect{%
+ \GetTrackedDialectToMapping{\@glsxtr@dialect}}%
+ \ifcsundef{captions\@glsxtr@dialect}{}%
+ {%
+ \ifcsundef{captions\@tracklang@lang}{}%
+ {%
+ \let\@glsxtr@dialect\@tracklang@lang
+ }%
+ }%
+ }%
+ {%
+ \ifcsundef{captions\@tracklang@lang}{}%
+ {%
+ \let\@glsxtr@dialect\@tracklang@lang
+ }%
+ }%
+ }%
+ }%
+ \ifdefempty\@glsxtr@dialect
+ {%
+ \GlsXtrUnknownDialectWarning{\@glsxtr@locale}{\@tracklang@lang}%
+ #2%
+ }%
+ {\foreignlanguage{\@glsxtr@dialect}{#2}}%
+ }%
+ {#2}% key not set
+ }
+ }
+ {
+ \newcommand{\GlsXtrForeignText}[2]{%
+ \GlossariesExtraWarning{Can't encapsulate foreign text:
+ tracklang v1.3.6+ required}%
+ #2%
+ }
+ }
+}
+{
+ \newcommand{\GlsXtrForeignText}[2]{#2}
+}
+\newcommand*{\GlsXtrForeignTextField}{userii}
+\newcommand*{\GlsXtrUnknownDialectWarning}[2]{%
+ \GlossariesExtraWarning{Can't determine valid dialect label
+ for locale `#1' (root language: #2)}%
+}
+\ifdef\GlsEntryCounterLabelPrefix
+{%
+ \newcommand*{\glsxtrpageref}[1]{%
+ \ifglsentrycounter
+ \pageref{\GlsEntryCounterLabelPrefix\glsdetoklabel{#1}}%
+ \else
+ \ifglssubentrycounter
+ \pageref{\GlsEntryCounterLabelPrefix\glsdetoklabel{#1}}%
+ \else
+ \gls{#1}%
+ \fi
+ \fi
+ }
+}%
+{%
+ \newcommand*{\glsxtrpageref}[1]{%
+ \ifglsentrycounter
+ \pageref{glsentry-\glsdetoklabel{#1}}%
+ \else
+ \ifglssubentrycounter
+ \pageref{glsentry-\glsdetoklabel{#1}}%
+ \else
+ \gls{#1}%
+ \fi
+ \fi
+ }
+}%
+\newcommand{\apptoglossarypreamble}[2][\glsdefaulttype]{%
+ \ifcsdef{glolist@#1}%
+ {%
+ \ifcsundef{@glossarypreamble@#1}%
+ {\csdef{@glossarypreamble@#1}{}}%
+ {}%
+ \csappto{@glossarypreamble@#1}{#2}%
+ }%
+ {%
+ \GlossariesExtraWarning{Glossary `#1' is not defined}%
+ }%
+}
+\newcommand{\preglossarypreamble}[2][\glsdefaulttype]{%
+ \ifcsdef{glolist@#1}%
+ {%
+ \ifcsundef{@glossarypreamble@#1}%
+ {\csdef{@glossarypreamble@#1}{}}%
+ {}%
+ \cspreto{@glossarypreamble@#1}{#2}%
+ }%
+ {%
+ \GlossariesExtraWarning{Glossary `#1' is not defined}%
+ }%
+}
+\ifdef\@gls@entry@field
+{
+ \renewcommand*{\@gls@entry@field}[2]{\csuse{glo@\glsdetoklabel{#1}@#2}}
+}
+{}
+\renewcommand*{\ifglsused}[3]{%
+ \glsdoifexists{#1}{\ifbool{glo@\glsdetoklabel{#1}@flag}{#2}{#3}}%
+}
+\renewcommand*{\longnewglossaryentry}{%
+ \@ifstar\@glsxtr@s@longnewglossaryentry\@glsxtr@longnewglossaryentry
+}
+\newcommand{\@glsxtr@s@longnewglossaryentry}[3]{%
+ \glsdoifnoexists{#1}%
+ {%
+ \bgroup
+ \let\@org@newglossaryentryprehook\@newglossaryentryprehook
+ \long\def\@newglossaryentryprehook{%
+ \long\def\@glo@desc{#3}%
+ \@org@newglossaryentryprehook
+ }%
+ \renewcommand*{\gls@assign@desc}[1]{%
+ \global\cslet{glo@\glsdetoklabel{#1}@desc}{\@glo@desc}%
+ \global\cslet{glo@\glsdetoklabel{#1}@descplural}{\@glo@descplural}%
+ }
+ \gls@defglossaryentry{#1}{#2}%
+ \egroup
+ }%
+}
+\newcommand{\@glsxtr@longnewglossaryentry}[3]{%
+ \glsdoifnoexists{#1}%
+ {%
+ \bgroup
+ \let\@org@newglossaryentryprehook\@newglossaryentryprehook
+ \long\def\@newglossaryentryprehook{%
+ \long\def\@glo@desc{#3\glsxtrpostlongdescription}%
+ \@org@newglossaryentryprehook
+ }%
+ \renewcommand*{\gls@assign@desc}[1]{%
+ \global\cslet{glo@\glsdetoklabel{#1}@desc}{\@glo@desc}%
+ \global\cslet{glo@\glsdetoklabel{#1}@descplural}{\@glo@descplural}%
+ }
+ \gls@defglossaryentry{#1}{#2}%
+ \egroup
+ }%
+}
+\newcommand*{\glsxtrpostlongdescription}{\leavevmode\unskip\nopostdesc}
+\renewcommand{\newignoredglossary}{%
+ \@ifstar\glsxtr@s@newignoredglossary\glsxtr@org@newignoredglossary
+}
+\newcommand*{\glsxtr@org@newignoredglossary}[1]{%
+ \ifcsdef{glolist@#1}
+ {%
+ \glsxtrundefaction{Glossary type `#1' already exists}{}%
+ }%
+ {%
+ \ifdefempty\@ignored@glossaries
+ {%
+ \protected@edef\@ignored@glossaries{#1}%
+ }%
+ {%
+ \protected@eappto\@ignored@glossaries{,#1}%
+ }%
+ \csgdef{glolist@#1}{,}%
+ \ifcsundef{gls@#1@entryfmt}%
+ {%
+ \defglsentryfmt[#1]{\glsentryfmt}%
+ }%
+ {}%
+ \ifdefempty\@gls@nohyperlist
+ {%
+ \renewcommand*{\@gls@nohyperlist}{#1}%
+ }%
+ {%
+ \protected@eappto\@gls@nohyperlist{,#1}%
+ }%
+ }%
+}
+\newcommand*{\glsxtr@s@newignoredglossary}[1]{%
+ \ifcsdef{glolist@#1}
+ {%
+ \glsxtrundefaction{Glossary type `#1' already exists}{}%
+ }%
+ {%
+ \ifdefempty\@ignored@glossaries
+ {%
+ \protected@edef\@ignored@glossaries{#1}%
+ }%
+ {%
+ \protected@eappto\@ignored@glossaries{,#1}%
+ }%
+ \csgdef{glolist@#1}{,}%
+ \ifcsundef{gls@#1@entryfmt}%
+ {%
+ \defglsentryfmt[#1]{\glsentryfmt}%
+ }%
+ {}%
+ }%
+}
+\glsifusetranslator
+{%
+ \renewcommand*{\glssettoctitle}[1]{%
+ \ifcsdef{gls@tr@set@#1@toctitle}%
+ {%
+ \csuse{gls@tr@set@#1@toctitle}%
+ }%
+ {%
+ \ifcsdef{@glotype@#1@title}%
+ {\def\glossarytoctitle{\csname @glotype@#1@title\endcsname}}%
+ {\def\glossarytoctitle{\glossarytitle}}%
+ }%
+ }%
+}
+{
+ \renewcommand*{\glssettoctitle}[1]{%
+ \ifcsdef{@glotype@#1@title}%
+ {\def\glossarytoctitle{\csname @glotype@#1@title\endcsname}}%
+ {\def\glossarytoctitle{\glossarytitle}}%
+ }
+}
+\newcommand{\provideignoredglossary}{%
+ \@ifstar\glsxtr@s@provideignoredglossary\glsxtr@provideignoredglossary
+}
+\newcommand*{\glsxtr@provideignoredglossary}[1]{%
+ \ifcsdef{glolist@#1}
+ {}%
+ {%
+ \ifdefempty\@ignored@glossaries
+ {%
+ \protected@edef\@ignored@glossaries{#1}%
+ }%
+ {%
+ \protected@eappto\@ignored@glossaries{,#1}%
+ }%
+ \csgdef{glolist@#1}{,}%
+ \ifcsundef{gls@#1@entryfmt}%
+ {%
+ \defglsentryfmt[#1]{\glsentryfmt}%
+ }%
+ {}%
+ \ifdefempty\@gls@nohyperlist
+ {%
+ \renewcommand*{\@gls@nohyperlist}{#1}%
+ }%
+ {%
+ \protected@eappto\@gls@nohyperlist{,#1}%
+ }%
+ }%
+}
+\newcommand*{\glsxtr@s@provideignoredglossary}[1]{%
+ \ifcsdef{glolist@#1}
+ {}%
+ {%
+ \ifdefempty\@ignored@glossaries
+ {%
+ \protected@edef\@ignored@glossaries{#1}%
+ }%
+ {%
+ \protected@eappto\@ignored@glossaries{,#1}%
+ }%
+ \csgdef{glolist@#1}{,}%
+ \ifcsundef{gls@#1@entryfmt}%
+ {%
+ \defglsentryfmt[#1]{\glsentryfmt}%
+ }%
+ {}%
+ }%
+}
+\newcommand*{\glsxtrcopytoglossary}[2]{%
+ \glsdoifexists{#1}%
+ {%
+ \ifcsdef{glolist@#2}
+ {%
+ \protected@cseappto{glolist@#2}{#1,}%
+ }%
+ {%
+ \glsxtrundefaction{Glossary type `#2' doesn't exist}{}%
+ }%
+ }%
+}
+\renewcommand{\glsdoifexists}[2]{%
+ \ifglsentryexists{#1}{#2}%
+ {%
+ \protected@edef\glslabel{\glsdetoklabel{#1}}%
+ \glsxtrundefaction{Glossary entry `\glslabel'
+ has not been defined}{You need to define a glossary entry before
+ you can reference it.}%
+ }%
+}
+\renewcommand{\glsdoifnoexists}[2]{%
+ \ifglsentryexists{#1}{%
+ \glsxtrundefaction{Glossary entry `\glsdetoklabel{#1}'
+ has already been defined}{}}{#2}%
+}
+\ifdef\glsdoifexistsordo
+{%
+ \renewcommand{\glsdoifexistsordo}[3]{%
+ \ifglsentryexists{#1}{#2}%
+ {%
+ \glsxtrundefaction{Glossary entry `\glsdetoklabel{#1}'
+ has not been defined}{You need to define a glossary entry
+ before you can use it.}%
+ #3%
+ }%
+ }%
+}
+{%
+ \glsxtr@warnonexistsordo\glsdoifexistsordo
+ \newcommand{\glsdoifexistsordo}[3]{%
+ \ifglsentryexists{#1}{#2}%
+ {%
+ \glsxtrundefaction{Glossary entry `\glsdetoklabel{#1}'
+ has not been defined}{You need to define a glossary entry
+ before you can use it.}%
+ #3%
+ }%
+ }%
+}
+\ifdef\doifglossarynoexistsordo
+{%
+ \renewcommand{\doifglossarynoexistsordo}[3]{%
+ \ifglossaryexists*{#1}%
+ {%
+ \glsxtrundefaction{Glossary type `#1' already exists}{}%
+ #3%
+ }%
+ {#2}%
+ }%
+}
+{%
+ \glsxtr@warnonexistsordo\doifglossarynoexistsordo
+ \newcommand{\doifglossarynoexistsordo}[3]{%
+ \ifglossaryexists*{#1}%
+ {%
+ \glsxtrundefaction{Glossary type `#1' already exists}{}%
+ #3%
+ }%
+ {#2}%
+ }%
+}
+
+\appto\@newglossaryentryposthook{%
+ \ifdefvoid\@glo@see
+ {\csxdef{glo@\@glo@label @see}{}}%
+ {%
+ \csxdef{glo@\@glo@label @see}{\@glo@see}%
+ \if@glsxtr@autoseeindex
+ \@glsxtr@autoindexcrossrefs
+ \fi
+ }%
+}
+\appto\@gls@keymap{,{see}{see}}
+\newcommand*{\glsxtrusesee}[1]{%
+ \glsdoifexists{#1}%
+ {%
+ \letcs{\@glo@see}{glo@\glsdetoklabel{#1}@see}%
+ \ifdefempty\@glo@see
+ {}%
+ {%
+ \expandafter\glsxtr@usesee\@glo@see\@end@glsxtr@usesee
+ }%
+ }%
+}
+\newcommand*{\glsxtr@usesee}[1][\seename]{%
+ \@glsxtr@usesee[#1]%
+}
+\def\@glsxtr@usesee[#1]#2\@end@glsxtr@usesee{%
+ \glsxtruseseeformat{#1}{#2}%
+}
+\newcommand*{\glsxtruseseeformat}[2]{%
+ \glsseeformat[#1]{#2}{}%
+}
+\renewcommand*{\glsseeitemformat}[1]{%
+ \ifglshasshort{#1}{\glsfmttext{#1}}{\glsfmtname{#1}}%
+}
+\newcommand*{\glsxtrhiername}[1]{%
+ \glsdoifexists{#1}%
+ {%
+ \glsxtrifhasfield{parent}{#1}%
+ {\glsxtrhiername{\glscurrentfieldvalue}\glsxtrhiernamesep}%
+ {}%
+ \ifglshasshort{#1}{\glsfmttext{#1}}{\glsfmtname{#1}}%
+ }%
+}
+\newcommand*{\Glsxtrhiername}[1]{%
+ \glsdoifexists{#1}%
+ {%
+ \glsxtrifhasfield{parent}{#1}%
+ {%
+ \Glsxtrhiername{\glscurrentfieldvalue}\glsxtrhiernamesep
+ \ifglshasshort{#1}{\glsfmttext{#1}}{\glsfmtname{#1}}%
+ }%
+ {\ifglshasshort{#1}{\Glsfmttext{#1}}{\Glsfmtname{#1}}}%
+ }%
+}
+\newcommand*{\GlsXtrhiername}[1]{%
+ \glsdoifexists{#1}%
+ {%
+ \glsxtrifhasfield{parent}{#1}%
+ {\GlsXtrhiername{\glscurrentfieldvalue}\glsxtrhiernamesep}%
+ {}%
+ \ifglshasshort{#1}{\Glsfmttext{#1}}{\Glsfmtname{#1}}%
+ }%
+}
+\newcommand*{\GLSxtrhiername}[1]{%
+ \glsdoifexists{#1}%
+ {%
+ \glsxtrifhasfield{parent}{#1}%
+ {%
+ \GLSxtrhiername{\glscurrentfieldvalue}\glsxtrhiernamesep
+ \ifglshasshort{#1}{\glsfmttext{#1}}{\glsfmtname{#1}}%
+ }%
+ {\ifglshasshort{#1}{\GLSfmttext{#1}}{\GLSfmtname{#1}}}%
+ }%
+}
+\newcommand*{\GLSXTRhiername}[1]{%
+ \glsdoifexists{#1}%
+ {%
+ \glsxtrifhasfield{parent}{#1}%
+ {\GLSXTRhiername{\glscurrentfieldvalue}\glsxtrhiernamesep}%
+ {}
+ \ifglshasshort{#1}{\GLSfmttext{#1}}{\GLSfmtname{#1}}%
+ }%
+}
+\newcommand*{\glsxtrhiernamesep}{\,{\small$\triangleright$}\,}
+\newcommand*{\glsxtruseseealso}[1]{%
+ \glsdoifexists{#1}%
+ {%
+ \letcs{\@glo@see}{glo@\glsdetoklabel{#1}@seealso}%
+ \ifdefempty\@glo@see
+ {}%
+ {%
+ \expandafter\glsxtruseseealsoformat\expandafter{\@glo@see}%
+ }%
+ }%
+}
+\newcommand*{\glsxtrusealias}[1]{%
+ \glsdoifexists{#1}%
+ {%
+ \letcs{\@glo@see}{glo@\glsdetoklabel{#1}@alias}%
+ \ifdefempty\@glo@see
+ {}%
+ {%
+ \glsxtruseseeformat{\seename}{\@glo@see}%
+ }%
+ }%
+}
+\newcommand*{\glsxtruseseealsoformat}[1]{%
+ \glsseeformat[\seealsoname]{#1}{}%
+}
+\newrobustcmd{\glsxtrseelist}[1]{%
+ \protected@edef\@glo@tmp{\noexpand\glsseelist{#1}}\@glo@tmp
+}
+\renewrobustcmd*{\glsseelist}[1]{%
+ \let\@gls@dolast\relax
+ \let\@gls@donext\relax
+ \let\@glsseeitem\@glsxtr@seefirstitem
+ \let\@glsseelastsep\glsseelastsep
+ \@for\@gls@thislabel:=#1\do{%
+ \ifx\@xfor@nextelement\@nnil
+ \@gls@dolast
+ \else
+ \@gls@donext
+ \fi
+ \expandafter\@glsseeitem\expandafter{\@gls@thislabel}%
+ \let\@gls@dolast\@glsseelastsep
+ \let\@gls@donext\glsseesep
+ \let\@glsseeitem\@glsxtr@seeitem
+ \let\@glsseelastsep\glsseelastoxfordsep
+ }%
+}
+\newcommand*{\@glsxtr@seeitem}[1]{%
+ \glsxtrifmulti{#1}{\mglsseeitem{#1}}{\glsseeitem{#1}}%
+}
+\newcommand*{\@glsxtr@seefirstitem}[1]{%
+ \glsxtrifmulti{#1}{\mglsseefirstitem{#1}}{\glsseefirstitem{#1}}%
+}
+\newcommand*{\mglsseeitem}[1]{%
+ \mglsname[all={noindex},setup={hyper=allmain}]{#1}%
+}
+\newcommand*{\mglsseefirstitem}{\mglsseeitem}
+\newcommand*{\glsseefirstitem}{\glsseeitem}
+\newcommand*{\glsseelastoxfordsep}{\glsseelastsep}
+\ifdef\alsoname
+{\providecommand{\seealsoname}{\alsoname}}
+{\providecommand{\seealsoname}{see also}}
+\ifdef\@xdycrossrefhook
+{
+ \appto\@xdycrossrefhook{%
+ \write\glswrite{(define-crossref-class \string"seealso\string"
+ :unverified )}%
+ \write\glswrite{(markup-crossref-list
+ :class \string"seealso\string"^^J\space\space\space
+ :open \string"\string\glsxtruseseealsoformat\glsopenbrace\string"
+ :close \string"\glsclosebrace\string")}%
+ }
+ \appto\@xdylocationclassorder{\space\string"seealso\string"}
+ \newrobustcmd*{\glsxtrindexseealso}[2]{%
+ \ifx\@glsxtr@record@setting\@glsxtr@record@setting@alsoindex
+ \@glsxtr@recordsee{#1}{#2}%
+ \fi
+ \glsdoifexists{#1}%
+ {%
+ \@@glsxtrwrglossmark
+ \def\@gls@xref{#2}%
+ \@onelevel@sanitize\@gls@xref
+ \@gls@checkmkidxchars\@gls@xref
+ \gls@glossary{\csname glo@#1@type\endcsname}{%
+ (indexentry
+ :tkey (\csname glo@#1@index\endcsname)
+ :xref (\string"\@gls@xref\string")
+ :attr \string"seealso\string"
+ )
+ }%
+ }%
+ }
+}
+{
+ \newrobustcmd*{\glsxtrindexseealso}{\glssee[\seealsoname]}
+}
+\ifdef\gls@set@xr@key
+{
+ \define@key{glossentry}{alias}{%
+ \gls@set@xr@key{alias}{\@glo@alias}{#1}%
+ }
+ \define@key{glossentry}{seealso}{%
+ \gls@set@xr@key{seealso}{\@glo@seealso}{#1}%
+ }
+ \appto\@gls@keymap{,{alias}{alias},{seealso}{seealso}}
+ \appto\@newglossaryentryprehook{\def\@glo@alias{}\def\@glo@seealso{}}%
+ \appto\@newglossaryentryposthook{%
+ \ifdefvoid\@glo@seealso
+ {\csxdef{glo@\@glo@label @seealso}{}}%
+ {%
+ \csxdef{glo@\@glo@label @seealso}{\@glo@seealso}%
+ \if@glsxtr@autoseeindex
+ \@glsxtr@autoindexcrossrefs
+ \fi
+ }%
+ \ifdefvoid\@glo@alias
+ {\csxdef{glo@\@glo@label @alias}{}}%
+ {%
+ \csxdef{glo@\@glo@label @alias}{\@glo@alias}%
+ }%
+ }
+ \newcommand*{\glsxtralias}[1]{\@gls@entry@field{#1}{alias}}
+ \newcommand*{\glsxtrseealsolabels}[1]{\@gls@entry@field{#1}{seealso}}
+ \appto\@glo@autoseehook{%
+ \ifdefvoid\@glo@alias
+ {%
+ \ifdefvoid\@glo@seealso
+ {}%
+ {%
+ \protected@edef\@do@glssee{\noexpand\glsxtrindexseealso
+ {\@glo@label}{\@glo@seealso}}%
+ \@do@glssee
+ }%
+ }%
+ {%
+ \ifdefvoid\@glo@see
+ {%
+ \protected@edef\@do@glssee{\noexpand\glssee{\@glo@label}{\@glo@alias}}%
+ \@do@glssee
+ }%
+ {}%
+ }%
+ }%
+}
+{
+ \glsaddstoragekey*{alias}{}{\glsxtralias}
+ \glsaddstoragekey*{seealso}{}{\glsxtrseealsolabels}
+ \appto\@newglossaryentryposthook{%
+ \ifcsvoid{glo@\@glo@label @alias}%
+ {%
+ \ifcsvoid{glo@\@glo@label @seealso}%
+ {}%
+ {%
+ \protected@edef\@do@glssee{\noexpand\glsxtrindexseealso
+ {\@glo@label}{\csuse{glo@\@glo@label @seealso}}}%
+ \@do@glssee
+ }%
+ }%
+ {%
+ \ifdefvoid\@glo@see
+ {%
+ \protected@edef\@do@glssee{\noexpand\glssee
+ {\@glo@label}{\csuse{glo@\@glo@label @alias}}}%
+ \@do@glssee
+ }%
+ {}%
+ }%
+ }
+}
+\AtEndDocument{\if@glsxtrindexcrossrefs\glsxtraddallcrossrefs\fi}
+\newcommand*{\glsxtraddallcrossrefs}{%
+ \forallglossaries{\@glo@type}%
+ {%
+ \forglsentries[\@glo@type]{\@glo@label}%
+ {%
+ \ifglsused{\@glo@label}%
+ {\expandafter\@glsxtr@addunusedxrefs\expandafter{\@glo@label}}{}%
+ }%
+ }%
+}
+\newcommand*{\@glsxtr@addunusedxrefs}[1]{%
+ \letcs{\@glo@see}{glo@\glsdetoklabel{#1}@see}%
+ \ifdefvoid\@glo@see
+ {}%
+ {%
+ \expandafter\glsxtr@addunused\@glo@see\@end@glsxtr@addunused
+ }%
+ \letcs{\@glo@see}{glo@\glsdetoklabel{#1}@seealso}%
+ \ifdefvoid\@glo@see
+ {}%
+ {%
+ \expandafter\glsxtr@addunused\@glo@see\@end@glsxtr@addunused
+ }%
+}
+\newcommand*{\glsxtr@addunused}[1][]{%
+ \@glsxtr@addunused
+}
+\def\@glsxtr@addunused#1\@end@glsxtr@addunused{%
+ \@for\@glsxtr@label:=#1\do
+ {%
+ \glsxtrifmulti\@glsxtr@label
+ {%
+ \letcs\@glsxtr@labellist{@gls@combined@\@glsxtr@label @list}%
+ \@for\@glsxtr@multilabel:=\@glsxtr@labellist\do
+ {\@glsxtr@addunused\@glsxtr@multilabel\@end@glsxtr@addunused}%
+ }%
+ {%
+ \ifglsused{\@glsxtr@label}{}%
+ {%
+ \glsadd[format=glsxtrunusedformat]{\@glsxtr@label}%
+ \glsunset{\@glsxtr@label}%
+ \expandafter\@glsxtr@addunusedxrefs\expandafter{\@glsxtr@label}%
+ }%
+ }%
+ }%
+}
+\newcommand*{\glsxtrunusedformat}[1]{\unskip}
+\ifdef\gls@begindocdefs
+{%
+ \renewcommand*{\gls@begindocdefs}{%
+ \ifnum\@glsxtr@docdefval=1\relax
+ \@gls@enablesavenonumberlist
+ \edef\@gls@restoreat{%
+ \noexpand\catcode`\noexpand\@=\number\catcode`\@\relax}%
+ \makeatletter
+ \InputIfFileExists{\jobname.glsdefs}{}{}%
+ \@gls@restoreat
+ \undef\@gls@restoreat
+ \gls@defdocnewglossaryentry
+ \else
+ \ifnum\@glsxtr@docdefval=3\relax
+ \@gls@enablesavenonumberlist
+ \let\gls@checkseeallowed\relax
+ \let\newglossaryentry\new@atom@glossaryentry
+ \global\newwrite\@gls@deffile
+ \immediate\openout\@gls@deffile=\jobname.glsdefs
+ \forallglsentries{\@glsentry}{\@gls@writedef{\@glsentry}}%
+ \fi
+ \fi
+ }
+}
+{%
+ \ifnum\@glsxtr@docdefval=3\relax
+ \PackageError{glossaries-extra}{Package option
+ `docdef=\@glsxtr@docdefsetting' requires at least version 4.37
+ of the base glossaries.sty package}{}
+ \fi
+}
+\newrobustcmd{\new@atom@glossaryentry}[2]{%
+ \gls@defglossaryentry{#1}{#2}%
+ \@gls@writedef{#1}%
+}
+\let\glsxtr@orgmakenoidxglossaries\makenoidxglossaries
+\renewcommand{\makenoidxglossaries}{%
+ \@domakeglossaries
+ {%
+ \ifdefequal\@glsxtr@record@setting\@glsxtr@record@setting@off
+ {%
+ \glsxtr@orgmakenoidxglossaries
+ \renewcommand{\@do@seeglossary}[2]{%
+ \@@glsxtrwrglossmark
+ \protected@edef\@gls@label{\glsdetoklabel{##1}}%
+ \protected@write\@auxout{}{%
+ \string\@gls@reference
+ {\csname glo@\@gls@label @type\endcsname}%
+ {\@gls@label}%
+ {%
+ \string\glsseeformat##2{}%
+ }%
+ }%
+ }%
+ \if@glsxtrdocdefrestricted
+ \renewcommand*{\@gls@reference}[3]{%
+ \ifcsundef{@glsref@##1}{\csgdef{@glsref@##1}{}}{}%
+ \ifinlistcs{##2}{@glsref@##1}%
+ {}%
+ {\listcsgadd{@glsref@##1}{##2}}%
+ \ifcsundef{glo@\glsdetoklabel{##2}@loclist}%
+ {\csgdef{glo@\glsdetoklabel{##2}@loclist}{}}%
+ {}%
+ \listcsgadd{glo@\glsdetoklabel{##2}@loclist}{##3}%
+ }%
+ \else
+ \@glsxtrdocdeffalse
+ \fi
+ \disable@keys{glossaries-extra.sty}{docdef}%
+ }%
+ {%
+ \PackageError{glossaries-extra}{\string\makenoidxglossaries\space
+ not permitted\MessageBreak
+ with record=\@glsxtr@record@setting\space package option}%
+ {You may only use \string\makenoidxglossaries\ space with the
+ record=off option}%
+ }%
+ }%
+}
+\renewcommand*{\gls@defdocnewglossaryentry}{%
+ \ifcase\@glsxtr@docdefval
+ \renewcommand*{\newglossaryentry}[2]{%
+ \PackageError{glossaries-extra}{Glossary entries must
+ be \MessageBreak defined in the preamble with \MessageBreak
+ package option `docdef=false'\MessageBreak(consider using
+ `docdef=restricted')}{Move your glossary definitions to
+ the preamble. You can also put them in a \MessageBreak separate file
+ and load them with \string\loadglsentries.}%
+ }%
+ \or
+ \let\gls@checkseeallowed\relax
+ \let\newglossaryentry\new@glossaryentry
+ \else
+ \let\gls@checkseeallowed\relax
+ \fi
+}%
+\newcommand*{\GlsXtrEnableOnTheFly}{%
+ \@ifstar\@sGlsXtrEnableOnTheFly\@GlsXtrEnableOnTheFly
+}
+\newcommand*{\@sGlsXtrEnableOnTheFly}{%
+ \renewcommand*{\glsdetoklabel}[1]{%
+ \expandafter\@glsxtr@ifcsstart\string##1 \@glsxtr@end@
+ {%
+ \expandafter\detokenize\expandafter{##1}%
+ }%
+ {\detokenize{##1}}%
+ }%
+ \@GlsXtrEnableOnTheFly
+}
+\def\@glsxtr@ifcsstart#1#2\@glsxtr@end@#3#4{%
+ \expandafter\if\glsbackslash#1%
+ #3%
+ \else
+ #4%
+ \fi
+}
+\newcommand*{\glsxtrstarflywarn}{%
+ \GlossariesExtraWarning{Experimental starred version of
+ \string\GlsXtrEnableOnTheFly\space in use (please ensure you have
+ read the warnings in the glossaries-extra user manual)}%
+}
+\newcommand*{\@GlsXtrEnableOnTheFly}{%
+ \newcommand*{\glsxtrcat}{general}
+ \newcommand*{\glsxtr}[1][]{%
+ \def\glsxtr@keylist{##1}%
+ \@glsxtr
+ }
+ \newcommand*{\@glsxtr}[2][]{%
+ \ifglsentryexists{##2}%
+ {%
+ \ifblank{##1}{}{\GlsXtrWarning{##1}{##2}}%
+ }%
+ {%
+ \gls@defglossaryentry{##2}{name={##2},category=\glsxtrcat,
+ description={\nopostdesc},##1}%
+ }%
+ \expandafter\gls\expandafter[\glsxtr@keylist]{##2}%
+ }
+ \newcommand*{\Glsxtr}[1][]{%
+ \def\glsxtr@keylist{##1}%
+ \@Glsxtr
+ }
+ \newcommand*{\@Glsxtr}[2][]{%
+ \ifglsentryexists{##2}%
+ {%
+ \ifblank{##1}{}{\GlsXtrWarning{##1}{##2}}%
+ }%
+ {%
+ \gls@defglossaryentry{##2}{name={##2},category=\glsxtrcat,
+ description={\nopostdesc},##1}%
+ }%
+ \expandafter\Gls\expandafter[\glsxtr@keylist]{##2}%
+ }
+ \newcommand*{\glsxtrpl}[1][]{%
+ \def\glsxtr@keylist{##1}%
+ \@glsxtrpl
+ }
+ \newcommand*{\@glsxtrpl}[2][]{%
+ \ifglsentryexists{##2}%
+ {%
+ \ifblank{##1}{}{\GlsXtrWarning{##1}{##2}}%
+ }%
+ {%
+ \gls@defglossaryentry{##2}{name={##2},category=\glsxtrcat,
+ description={\nopostdesc},##1}%
+ }%
+ \expandafter\glspl\expandafter[\glsxtr@keylist]{##2}%
+ }
+ \newcommand*{\Glsxtrpl}[1][]{%
+ \def\glsxtr@keylist{##1}%
+ \@Glsxtrpl
+ }
+ \newcommand*{\@Glsxtrpl}[2][]{%
+ \ifglsentryexists{##2}
+ {%
+ \ifblank{##1}{}{\GlsXtrWarning{##1}{##2}}%
+ }%
+ {%
+ \gls@defglossaryentry{##2}{name={##2},category=\glsxtrcat,
+ description={\nopostdesc},##1}%
+ }%
+ \expandafter\Glspl\expandafter[\glsxtr@keylist]{##2}%
+ }
+ \newcommand*{\GlsXtrWarning}[2]{%
+ \def\@glsxtr@optlist{##1}%
+ \@onelevel@sanitize\@glsxtr@optlist
+ \GlossariesExtraWarning{The options `\@glsxtr@optlist' have
+ been ignored for entry `##2' as it has already been defined}%
+ }
+ \renewcommand\@printglossary[2]{%
+ \def\@glsxtr@printglossopts{##1}%
+ \@glsxtr@orgprintglossary{##1}{##2}%
+ \def\@glsxtr{\@glsxtr@disabledflycommand\glsxtr}%
+ \def\@glsxtrpl{\@glsxtr@disabledflycommand\glsxtrpl}%
+ \def\@Glsxtr{\@glsxtr@disabledflycommand\Glsxtr}%
+ \def\@Glsxtrpl{\@glsxtr@disabledflycommand\Glsxtrpl}%
+ }
+ \newcommand*{\@glsxtr@disabledflycommand}[1]{%
+ \PackageError{glossaries-extra}%
+ {\string##1\space can't be used after any of the \MessageBreak
+ glossaries have been displayed}%
+ {The on-the-fly commands enabled by
+ \string\GlsXtrEnableOnTheFly\space may only be used \MessageBreak
+ before the glossaries. If you want to use any entries \MessageBreak
+ after any of the glossaries, you must use the standard \MessageBreak
+ method of first defining the entry and then using the \MessageBreak
+ entry with commands like \string\gls}%
+ \@@glsxtr@disabledflycommand
+ }%
+ \newcommand*{\@@glsxtr@disabledflycommand}[2][]{##2}
+ \let\GlsXtrEnableOnTheFly\relax
+}
+\@onlypreamble\GlsXtrEnableOnTheFly
+\newcommand*{\@glsxtr@current@style}{\@glossary@default@style}
+\renewcommand*{\setglossarystyle}[1]{%
+ \ifcsundef{@glsstyle@#1}%
+ {%
+ \PackageError{glossaries-extra}{Glossary style `#1' undefined}{}%
+ }%
+ {%
+ \csname @glsstyle@#1\endcsname
+ \protected@edef\@glsxtr@current@style{#1}%
+ }%
+ \ifx\@glossary@default@style\relax
+ \protected@edef\@glossary@default@style{#1}%
+ \fi
+}
+\ifdef\@glossary@default@style
+{}
+{%
+ \let\@glossary@default@style\relax
+}
+\ifdef\glslistdottedwidth
+{%
+ \ifdim\glslistdottedwidth=.5\hsize
+ \setlength{\glslistdottedwidth}{-\dimexpr\maxdimen-1sp\relax}
+ \AtBeginDocument{%
+ \ifdim\glslistdottedwidth=-\dimexpr\maxdimen-1sp\relax
+ \setlength{\glslistdottedwidth}{.5\columnwidth}%
+ \fi
+ }%
+ \fi
+}
+{}%
+\ifdef\glsdescwidth
+{%
+ \ifdim\glsdescwidth=.6\hsize
+ \setlength{\glsdescwidth}{-\dimexpr\maxdimen-1sp\relax}
+ \AtBeginDocument{%
+ \ifdim\glsdescwidth=-\dimexpr\maxdimen-1sp\relax
+ \setlength{\glsdescwidth}{.6\columnwidth}%
+ \fi
+ }%
+ \fi
+}
+{}%
+\ifdef\glspagelistwidth
+{%
+ \ifdim\glspagelistwidth=.1\hsize
+ \setlength{\glspagelistwidth}{-\dimexpr\maxdimen-1sp\relax}
+ \AtBeginDocument{%
+ \ifdim\glspagelistwidth=-\dimexpr\maxdimen-1sp\relax
+ \setlength{\glspagelistwidth}{.1\columnwidth}%
+ \fi
+ }%
+ \fi
+}
+{}%
+\def\org@glossaryentrynumbers#1{#1\gls@save@numberlist{#1}}%
+\ifx\org@glossaryentrynumbers\glossaryentrynumbers
+ \glsnonumberlistfalse
+ \renewcommand*{\glossaryentrynumbers}[1]{%
+ \ifglsentryexists{\glscurrententrylabel}%
+ {%
+ \@glsxtrpreloctag
+ \GlsXtrFormatLocationList{#1}%
+ \@glsxtrpostloctag
+ \gls@save@numberlist{#1}%
+ }{}%
+ }%
+\else
+ \glsnonumberlisttrue
+ \renewcommand*{\glossaryentrynumbers}[1]{%
+ \ifglsentryexists{\glscurrententrylabel}%
+ {%
+ \gls@save@numberlist{#1}%
+ }{}%
+ }%
+\fi
+\newcommand*{\GlsXtrFormatLocationList}[1]{#1}
+\newcommand*{\GlsXtrEnablePreLocationTag}[2]{%
+ \let\@glsxtrpreloctag\@@glsxtrpreloctag
+ \let\@glsxtrpostloctag\@@glsxtrpostloctag
+ \renewcommand*{\@glsxtr@pagetag}{#1}%
+ \renewcommand*{\@glsxtr@pagestag}{#2}%
+ \renewcommand*{\@glsxtr@savepreloctag}[2]{%
+ \csgdef{@glsxtr@preloctag@##1}{##2}%
+ }%
+ \renewcommand*{\@glsxtr@doloctag}{%
+ \ifcsundef{@glsxtr@preloctag@\glscurrententrylabel}%
+ {%
+ \GlossariesWarning{Missing pre-location tag for `\glscurrententrylabel'.
+ Rerun required}%
+ }%
+ {%
+ \csuse{@glsxtr@preloctag@\glscurrententrylabel}%
+ }%
+ }%
+}
+\@onlypreamble\GlsXtrEnablePreLocationTag
+\newcommand*{\@@glsxtrpreloctag}{%
+ \let\@glsxtr@org@delimN\delimN
+ \let\@glsxtr@org@delimR\delimR
+ \let\@glsxtr@org@glsignore\glsignore
+ \gdef\@glsxtr@thisloctag{\@glsxtr@pagetag}%
+ \renewcommand*{\delimN}{%
+ \gdef\@glsxtr@thisloctag{\@glsxtr@pagestag}%
+ \@glsxtr@org@delimN}%
+ \renewcommand*{\delimR}{%
+ \gdef\@glsxtr@thisloctag{\@glsxtr@pagestag}%
+ \@glsxtr@org@delimR}%
+ \renewcommand*{\glsignore}[1]{%
+ \gdef\@glsxtr@thisloctag{\relax}%
+ \@glsxtr@org@glsignore{##1}}%
+ \@glsxtr@doloctag
+}
+\newcommand*{\@glsxtrpreloctag}{}
+\newcommand*{\@glsxtr@pagetag}{}%
+\newcommand*{\@glsxtr@pagestag}{}%
+\newcommand*{\@@glsxtrpostloctag}{%
+ \let\delimN\@glsxtr@org@delimN
+ \let\delimR\@glsxtr@org@delimR
+ \let\glsignore\@glsxtr@org@glsignore
+ \protected@write\@auxout{}%
+ {\string\@glsxtr@savepreloctag{\glscurrententrylabel}{\@glsxtr@thisloctag}}%
+}
+\newcommand*{\@glsxtrpostloctag}{}
+\newcommand*{\@glsxtr@savepreloctag}[2]{}
+\protected@write\@auxout{}{%
+ \string\providecommand\string\@glsxtr@savepreloctag[2]{}}
+\newcommand*{\@glsxtr@doloctag}{}
+\renewcommand*{\KV@printgloss@nonumberlist}[1]{%
+ \XKV@plfalse
+ \XKV@sttrue
+ \XKV@checkchoice[\XKV@resa]{#1}{true,false}%
+ {%
+ \csname glsnonumberlist\XKV@resa\endcsname
+ \ifglsnonumberlist
+ \def\glossaryentrynumbers##1{\gls@save@numberlist{##1}}%
+ \else
+ \def\glossaryentrynumbers##1{%
+ \@glsxtrpreloctag
+ \GlsXtrFormatLocationList{##1}%
+ \@glsxtrpostloctag
+ \gls@save@numberlist{##1}}%
+ \fi
+ }%
+}
+\renewcommand*{\glsentryfmt}{%
+ \ifglshasshort{\glslabel}{\glssetabbrvfmt{\glscategory{\glslabel}}}{}%
+ \glsifregular{\glslabel}%
+ {\glsxtrregularfont{\glsgenentryfmt}}%
+ {%
+ \ifglshasshort{\glslabel}%
+ {\glsxtrabbreviationfont{\glsxtrgenabbrvfmt}}%
+ {\glsxtrregularfont{\glsgenentryfmt}}%
+ }%
+}
+\newcommand*{\glsxtrregularfont}[1]{#1}
+\newcommand*{\glsxtrabbreviationfont}[1]{#1}
+\renewcommand{\@gls@field@link}[4][]{%
+ \@glsxtr@record{#2}{#3}{glslink}%
+ \glsdoifexists{#3}%
+ {%
+ \let\glsxtrorg@ifKV@glslink@hyper\ifKV@glslink@hyper
+ \@gls@save@glslocal
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \def\glscustomtext{#4}%
+ \@glsxtr@field@linkdefs
+ #1%
+ \@gls@link[#2]{#3}{#4}%
+ \let\ifKV@glslink@hyper\glsxtrorg@ifKV@glslink@hyper
+ \@gls@restore@glslocal
+ }%
+ \glspostlinkhook
+}
+\let\@glsxtr@org@gls@\@gls@
+\def\@gls@#1#2{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \@glsxtr@org@gls@{#1}{#2}%
+}%
+\let\@glsxtr@org@glspl@\@glspl@
+\def\@glspl@#1#2{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \@glsxtr@org@glspl@{#1}{#2}%
+}%
+\let\@glsxtr@org@Gls@\@Gls@
+\def\@Gls@#1#2{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \@glsxtr@org@Gls@{#1}{#2}%
+}%
+\let\@glsxtr@org@Glspl@\@Glspl@
+\def\@Glspl@#1#2{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \@glsxtr@org@Glspl@{#1}{#2}%
+}%
+\let\@glsxtr@org@GLS@\@GLS@
+\def\@GLS@#1#2{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \@glsxtr@org@GLS@{#1}{#2}%
+}%
+\let\@glsxtr@org@GLSpl@\@GLSpl@
+\def\@GLSpl@#1#2{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \@glsxtr@org@GLSpl@{#1}{#2}%
+}%
+\renewcommand*{\@glsdisp}[3][]{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \glsdoifexists{#2}{%
+ \let\do@gls@link@checkfirsthyper\@gls@link@checkfirsthyper
+ \let\glsifplural\@secondoftwo
+ \let\glscapscase\@firstofthree
+ \def\glscustomtext{#3}%
+ \def\glsinsert{}%
+ \def\@glo@text{\csname gls@\glstype @entryfmt\endcsname}%
+ \@gls@link[#1]{#2}{\@glo@text}%
+ \@gls@do@glsunset{#2}%
+ }%
+ \glspostlinkhook
+}
+\renewcommand*{\@gls@@link}[3][]{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \glsdoifexistsordo{#2}%
+ {%
+ \let\do@gls@link@checkfirsthyper\relax
+ \def\glscustomtext{#3}%
+ \@glsxtr@field@linkdefs
+ \@gls@link[#1]{#2}{#3}%
+ }%
+ {%
+ \glstextformat{#3}%
+ }%
+ \glspostlinkhook
+}
+\newcommand*{\glsxtrinitwrgloss}{%
+ \glsifattribute{\glslabel}{wrgloss}{after}%
+ {%
+ \glsxtrinitwrglossbeforefalse
+ }%
+ {%
+ \glsxtrinitwrglossbeforetrue
+ }%
+}
+\newif\ifglsxtrinitwrglossbefore
+\glsxtrinitwrglossbeforetrue
+\define@choicekey{glslink}{wrgloss}%
+[\@glsxtr@wrglossval\@glsxtr@wrglossnr]%
+{before,after}%
+{%
+ \ifcase\@glsxtr@wrglossnr\relax
+ \glsxtrinitwrglossbeforetrue
+ \or
+ \glsxtrinitwrglossbeforefalse
+ \fi
+}
+\define@key{glslink}{thevalue}{\def\@glsxtr@thevalue{#1}}
+\define@key{glslink}{theHvalue}{\def\@glsxtr@theHvalue{#1}}
+\define@boolkey{glslink}[glsxtr@]{hyperoutside}[true]{}
+\glsxtr@hyperoutsidetrue
+\define@key{glslink}{textformat}{%
+ \ifcsdef{#1}
+ {%
+ \letcs{\@glsxtr@local@textformat}{#1}%
+ }%
+ {%
+ \PackageError{glossaries-extra}{Unknown control sequence name `#1'}{}%
+ }%
+}
+\define@key{glslink}{prefix}{\def\glolinkprefix{#1}}
+\newcommand*{\glsxtrinithyperoutside}{%
+ \glsifattribute{\glslabel}{hyperoutside}{false}%
+ {%
+ \glsxtr@hyperoutsidefalse
+ }%
+ {%
+ \glsxtr@hyperoutsidetrue
+ }%
+}
+\newcommand*{\glsxtr@inc@linkcount}{}
+\newcommand*{\glslinkpresetkeys}{}
+\newrobustcmd*{\GlsXtrExpandedFmt}[2]{%
+ \protected@edef\@glsxtr@tmp{#2}%
+ \expandafter#1\expandafter{\@glsxtr@tmp}%
+}
+\newcommand*{\@glsxtr@use@equation@counter}{%
+ \@glsxtr@ifnum@mmode{\def\@gls@counter{equation}}{}%
+}
+\newcommand*{\glsxtr@do@autoadd}[1]{}
+\newcommand*{\GlsXtrAutoAddOnFormat}[3][\glslabel]{%
+ \renewcommand*{\glsxtr@do@autoadd}[1]{%
+ \begingroup
+ \protected@edef\@glsxtr@do@autoadd{%
+ \noexpand\ifstrequal{##1}{glslink}%
+ {%
+ \noexpand\DTLifinlist{\@glsnumberformat}{#2}{\noexpand\glsadd[format={\@glsnumberformat},#3]{#1}}{}%
+ }%
+ {}%
+ }%
+ \@glsxtr@do@autoadd
+ \endgroup
+ }%
+}
+\providecommand*{\glslinkwrcontent}[1]{{#1}}
+\def\@gls@link[#1]#2#3{%
+ \leavevmode
+ \protected@edef\glslabel{\glsdetoklabel{#2}}%
+ \def\@gls@link@opts{#1}%
+ \let\@gls@link@label\glslabel
+ \let\@glsnumberformat\@glsxtr@defaultnumberformat
+ \protected@edef\@gls@counter{\csname glo@\glslabel @counter\endcsname}%
+ \protected@edef\glstype{\csname glo@\glslabel @type\endcsname}%
+ \let\org@ifKV@glslink@hyper\ifKV@glslink@hyper
+ \@gls@save@glslocal
+ \let\@glsxtr@org@glolinkprefix\glolinkprefix
+ \let\@glsxtr@local@textformat\relax
+ \def\@glsxtr@thevalue{}%
+ \def\@glsxtr@theHvalue{\@glsxtr@thevalue}%
+ \glsxtrinitwrgloss
+ \glsxtrinithyperoutside
+ \@gls@setdefault@glslink@opts
+ \glsxtr@inc@linkcount
+ \if@glsxtr@equations
+ \@glsxtr@use@equation@counter
+ \fi
+ \do@glsdisablehyperinlist
+ \do@gls@link@checkfirsthyper
+ \glslinkpresetkeys
+ \setkeys{glslink}{#1}%
+ \glsxtr@do@autoadd{glslink}%
+ \glslinkpostsetkeys
+ \ifdefempty{\@glsxtr@thevalue}%
+ {%
+ \@gls@saveentrycounter
+ }%
+ {%
+ \let\theglsentrycounter\@glsxtr@thevalue
+ \def\theHglsentrycounter{\@glsxtr@theHvalue}%
+ }%
+ \@gls@setsort{\glslabel}%
+ \ifx\@glsxtr@local@textformat\relax
+ \glshasattribute{\glslabel}{textformat}%
+ {%
+ \protected@edef\@glsxtr@attrval{\glsgetattribute{\glslabel}{textformat}}%
+ \ifcsdef{\@glsxtr@attrval}%
+ {%
+ \letcs{\@glsxtr@textformat}{\@glsxtr@attrval}%
+ }%
+ {%
+ \GlossariesExtraWarning{Unknown control sequence name
+ `\@glsxtr@attrval' supplied in textformat attribute
+ for entry `\glslabel'. Reverting to default \string\glstextformat}%
+ \let\@glsxtr@textformat\glstextformat
+ }%
+ }%
+ {%
+ \let\@glsxtr@textformat\glstextformat
+ }%
+ \else
+ \let\@glsxtr@textformat\@glsxtr@local@textformat
+ \fi
+ \glslinkwrcontent
+ {%
+ \ifglsxtrinitwrglossbefore
+ \@do@wrglossary{#2}%
+ \fi
+ \ifKV@glslink@hyper
+ \ifglsxtr@hyperoutside
+ \@glslink{\glolinkprefix\glslabel}{\@glsxtr@textformat{#3}}%
+ \else
+ \@glsxtr@textformat{\@glslink{\glolinkprefix\glslabel}{#3}}%
+ \fi
+ \else
+ \ifglsxtr@hyperoutside
+ \glsdonohyperlink{\glolinkprefix\glslabel}{\@glsxtr@textformat{#3}}%
+ \else
+ \@glsxtr@textformat{\glsdonohyperlink{\glolinkprefix\glslabel}{#3}}%
+ \fi
+ \fi
+ \ifglsxtrinitwrglossbefore
+ \else
+ \@do@wrglossary{#2}%
+ \fi
+ }%
+ \let\glolinkprefix\@glsxtr@org@glolinkprefix
+ \let\ifKV@glslink@hyper\org@ifKV@glslink@hyper
+ \@gls@restore@glslocal
+}
+\define@key{glossadd}{thevalue}{\def\@glsxtr@thevalue{#1}}
+\define@key{glossadd}{theHvalue}{\def\@glsxtr@theHvalue{#1}}
+\newcommand*{\glsaddpresetkeys}{}
+
+\newcommand*{\glsaddpostsetkeys}{}
+\renewrobustcmd*{\glsadd}[2][]{%
+ \glsxtrifinmark
+ {}%
+ {%
+ \@gls@adjustmode
+ \begingroup
+ \@glsxtr@record{#1}{#2}{glossadd}%
+ \glsdoifexists{#2}%
+ {%
+ \let\@glsnumberformat\@glsxtr@defaultnumberformat
+ \protected@edef\@gls@counter{\csname glo@\glsdetoklabel{#2}@counter\endcsname}%
+ \def\@glsxtr@thevalue{}%
+ \def\@glsxtr@theHvalue{\@glsxtr@thevalue}%
+ \glsaddpresetkeys
+ \setkeys{glossadd}{#1}%
+ \glsaddpostsetkeys
+ \ifdefempty{\@glsxtr@thevalue}%
+ {%
+ \@gls@saveentrycounter
+ }%
+ {%
+ \let\theglsentrycounter\@glsxtr@thevalue
+ \def\theHglsentrycounter{\@glsxtr@theHvalue}%
+ }%
+ \@gls@setsort{#2}%
+ \KV@glslink@noindexfalse
+ \@@do@wrglossary{#2}%
+ }%
+ \endgroup
+ }%
+}
+\newrobustcmd{\glsaddeach}[2][]{%
+ \@for\@gls@thislabel:=#2\do{\glsadd[#1]{\@gls@thislabel}}%
+}
+\newcommand*{\@glsxtr@field@linkdefs}{%
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@secondoftwo
+ \let\glscapscase\@firstofthree
+ \let\glsinsert\@empty
+}
+\newcommand*{\glsxtrassignfieldfont}[1]{%
+ \ifglsentryexists{#1}%
+ {%
+ \ifglshasshort{#1}%
+ {%
+ \glssetabbrvfmt{\glscategory{#1}}%
+ \glsifregular{#1}%
+ {\let\@gls@field@font\glsxtrregularfont}%
+ {\let\@gls@field@font\@firstofone}%
+ }%
+ {%
+ \glsifnotregular{#1}%
+ {\let\@gls@field@font\@firstofone}%
+ {\let\@gls@field@font\glsxtrregularfont}%
+ }%
+ }%
+ {%
+ \let\@gls@field@font\@gobble
+ }%
+}
+\def\@glstext@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link{#1}{#2}{\@gls@field@font{\glsaccesstext{#2}#3}}%
+}
+\def\@GLStext@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link[\let\glscapscase\@thirdofthree]{#1}{#2}%
+ {\@gls@field@font{\GLSaccesstext{#2}\mfirstucMakeUppercase{#3}}}%
+}
+\def\@Glstext@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link[\let\glscapscase\@secondofthree]{#1}{#2}%
+ {\@gls@field@font{\Glsaccesstext{#2}#3}}%
+}
+\newcommand*{\glsxtrchecknohyperfirst}[1]{%
+ \glsifattribute{#1}{nohyperfirst}{true}{\KV@glslink@hyperfalse}{}%
+}
+\def\@glsfirst@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glsxtrifwasfirstuse\@firstoftwo
+ \glsxtrchecknohyperfirst{#2}%
+ ]{#1}{#2}%
+ {\@gls@field@font{\glsaccessfirst{#2}#3}}%
+}
+\def\@Glsfirst@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glsxtrifwasfirstuse\@firstoftwo
+ \let\glscapscase\@secondofthree
+ \glsxtrchecknohyperfirst{#2}%
+ ]%
+ {#1}{#2}{\@gls@field@font{\Glsaccessfirst{#2}#3}}%
+}
+\def\@GLSfirst@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glsxtrifwasfirstuse\@firstoftwo
+ \let\glscapscase\@thirdofthree
+ \glsxtrchecknohyperfirst{#2}%
+ ]%
+ {#1}{#2}{\@gls@field@font{\GLSaccessfirst{#2}\mfirstucMakeUppercase{#3}}}%
+}
+\def\@glsplural@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link[\let\glsifplural\@firstoftwo]{#1}{#2}%
+ {\@gls@field@font{\glsaccessplural{#2}#3}}%
+}
+\def\@Glsplural@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glsifplural\@firstoftwo
+ \let\glscapscase\@secondofthree
+ ]%
+ {#1}{#2}{\@gls@field@font{\Glsaccessplural{#2}#3}}%
+}
+\def\@GLSplural@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glsifplural\@firstoftwo
+ \let\glscapscase\@thirdofthree
+ ]%
+ {#1}{#2}{\@gls@field@font{\GLSaccessplural{#2}\mfirstucMakeUppercase{#3}}}%
+}
+\def\@glsfirstplural@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glsxtrifwasfirstuse\@firstoftwo
+ \let\glsifplural\@firstoftwo
+ \glsxtrchecknohyperfirst{#2}%
+ ]%
+ {#1}{#2}{\@gls@field@font{\glsaccessfirstplural{#2}#3}}%
+}
+\def\@Glsfirstplural@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glsxtrifwasfirstuse\@firstoftwo
+ \let\glsifplural\@firstoftwo
+ \let\glscapscase\@secondofthree
+ \glsxtrchecknohyperfirst{#2}%
+ ]%
+ {#1}{#2}{\@gls@field@font{\Glsaccessfirstplural{#2}#3}}%
+}
+\def\@GLSfirstplural@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glsxtrifwasfirstuse\@firstoftwo
+ \let\glsifplural\@firstoftwo
+ \let\glscapscase\@thirdofthree
+ \glsxtrchecknohyperfirst{#2}%
+ ]%
+ {#1}{#2}%
+ {\@gls@field@font{\GLSaccessfirstplural{#2}\mfirstucMakeUppercase{#3}}}%
+}
+\def\@glsname@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link{#1}{#2}{\@gls@field@font{\glsaccessname{#2}#3}}%
+}
+\def\@Glsname@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glscapscase\@secondoftwo]{#1}{#2}%
+ {\@gls@field@font{\Glsaccessname{#2}#3}}%
+}
+\def\@GLSname@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link[\let\glscapscase\@thirdoftwo]%
+ {#1}{#2}%
+ {\@gls@field@font{\GLSaccessname{#2}\mfirstucMakeUppercase{#3}}}%
+}
+\def\@glsdesc@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link{#1}{#2}{\@gls@field@font{\glsaccessdesc{#2}#3}}%
+}
+\def\@Glsdesc@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glscapscase\@secondoftwo]{#1}{#2}%
+ {\@gls@field@font{\Glsaccessdesc{#2}#3}}%
+}
+\def\@GLSdesc@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link[\let\glscapscase\@thirdoftwo]%
+ {#1}{#2}{\@gls@field@font{\GLSaccessdesc{#2}\mfirstucMakeUppercase{#3}}}%
+}
+\def\@glsdescplural@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glscapscase\@secondoftwo
+ \let\glsifplural\@firstoftwo
+ ]{#1}{#2}{\@gls@field@font{\glsaccessdescplural{#2}#3}}%
+}
+\def\@Glsdescplural@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glscapscase\@secondoftwo
+ \let\glsifplural\@firstoftwo
+ ]{#1}{#2}{\@gls@field@font{\Glsaccessdescplural{#2}#3}}%
+}
+\def\@GLSdesc@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glscapscase\@thirdoftwo
+ \let\glsifplural\@firstoftwo
+ ]%
+ {#1}{#2}%
+ {\@gls@field@font{\GLSaccessdescplural{#2}\mfirstucMakeUppercase{#3}}}%
+}
+\def\@glssymbol@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link{#1}{#2}{\@gls@field@font{\glsaccesssymbol{#2}#3}}%
+}
+\def\@Glssymbol@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glscapscase\@secondoftwo]%
+ {#1}{#2}{\@gls@field@font{\Glsaccesssymbol{#2}#3}}%
+}
+\def\@GLSsymbol@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link[\let\glscapscase\@thirdoftwo]%
+ {#1}{#2}{\@gls@field@font{\GLSaccesssymbol{#2}\mfirstucMakeUppercase{#3}}}%
+}
+\def\@glssymbolplural@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glscapscase\@secondoftwo
+ \let\glsifplural\@firstoftwo
+ ]{#1}{#2}{\@gls@field@font{\glsaccesssymbolplural{#2}#3}}%
+}
+\def\@Glssymbolplural@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glscapscase\@secondoftwo
+ \let\glsifplural\@firstoftwo
+ ]{#1}{#2}{\@gls@field@font{\Glsaccesssymbolplural{#2}#3}}%
+}
+\def\@GLSsymbol@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glscapscase\@thirdoftwo
+ \let\glsifplural\@firstoftwo
+ ]%
+ {#1}{#2}%
+ {\@gls@field@font{\GLSaccesssymbolplural{#2}\mfirstucMakeUppercase{#3}}}%
+}
+\def\@Glsuseri@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glscapscase\@secondoftwo]{#1}{#2}%
+ {\@gls@field@font{\Glsentryuseri{#2}#3}}%
+}
+\def\@GLSuseri@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link[\let\glscapscase\@thirdoftwo]%
+ {#1}{#2}{\@gls@field@font{\mfirstucMakeUppercase{\glsentryuseri{#2}#3}}}%
+}
+\def\@Glsuserii@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glscapscase\@secondoftwo]%
+ {#1}{#2}{\@gls@field@font{\Glsentryuserii{#2}#3}}%
+}
+\def\@GLSuserii@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link[\let\glscapscase\@thirdoftwo]%
+ {#1}{#2}{\@gls@field@font{\mfirstucMakeUppercase{\glsentryuserii{#2}#3}}}%
+}
+\def\@Glsuseriii@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glscapscase\@secondoftwo]%
+ {#1}{#2}{\@gls@field@font{\Glsentryuseriii{#2}#3}}%
+}
+\def\@GLSuseriii@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link[\let\glscapscase\@thirdoftwo]%
+ {#1}{#2}{\@gls@field@font{\mfirstucMakeUppercase{\glsentryuseriii{#2}#3}}}%
+}
+\def\@Glsuseriv@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glscapscase\@secondoftwo]%
+ {#1}{#2}{\@gls@field@font{\Glsentryuseriv{#2}#3}}%
+}
+\def\@GLSuseriv@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link[\let\glscapscase\@thirdoftwo]%
+ {#1}{#2}%
+ {\@gls@field@font{\mfirstucMakeUppercase{\glsentryuseriv{#2}#3}}}%
+}
+\def\@Glsuserv@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glscapscase\@secondoftwo]%
+ {#1}{#2}{\@gls@field@font{\Glsentryuserv{#2}#3}}%
+}
+\def\@GLSuserv@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link[\let\glscapscase\@thirdoftwo]%
+ {#1}{#2}{\@gls@field@font{\mfirstucMakeUppercase{\glsentryuserv{#2}#3}}}%
+}
+\def\@Glsuservi@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link
+ [\let\glscapscase\@secondoftwo]%
+ {#1}{#2}{\@gls@field@font{\Glsentryuservi{#2}#3}}%
+}
+\def\@GLSuservi@#1#2[#3]{%
+ \glsxtrassignfieldfont{#2}%
+ \@gls@field@link[\let\glscapscase\@thirdoftwo]%
+ {#1}{#2}{\@gls@field@font{\mfirstucMakeUppercase{\glsentryuservi{#2}#3}}}%
+}
+\newcommand*{\@@glsxtr@base@acrcmd@warn}[2]{%
+ \GlossariesExtraWarning{Base acronym command \string#1\space
+ should not be used with new abbreviation definitions. Use
+ \string#2\space instead}%
+}
+\let\@glsxtr@base@acrcmd\@@glsxtr@base@acrcmd@warn
+\def\@acrshort#1#2[#3]{%
+ \@glsxtr@base@acrcmd\acrshort\glsxtrshort
+ \glsdoifexists{#2}%
+ {%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@secondoftwo
+ \let\glscapscase\@firstofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \acronymfont{\glsaccessshort{#2}}#3%
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\def\@Acrshort#1#2[#3]{%
+ \@glsxtr@base@acrcmd\Acrshort\Glsxtrshort
+ \glsdoifexists{#2}%
+ {%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@secondoftwo
+ \let\glscapscase\@secondofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \acronymfont{\Glsaccessshort{#2}}#3%
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\def\@ACRshort#1#2[#3]{%
+ \@glsxtr@base@acrcmd\ACRshort\GLSxtrshort
+ \glsdoifexists{#2}%
+ {%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@secondoftwo
+ \let\glscapscase\@thirdofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \mfirstucMakeUppercase{\acronymfont{\glsaccessshort{#2}}#3}%
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\def\@acrshortpl#1#2[#3]{%
+ \@glsxtr@base@acrcmd\acrshortpl\glsxtrshortpl
+ \glsdoifexists{#2}%
+ {%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@firstoftwo
+ \let\glscapscase\@firstofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \acronymfont{\glsaccessshortpl{#2}}#3%
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\def\@Acrshortpl#1#2[#3]{%
+ \@glsxtr@base@acrcmd\Acrshortpl\Glsxtrshortpl
+ \glsdoifexists{#2}%
+ {%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@firstoftwo
+ \let\glscapscase\@secondofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \acronymfont{\Glsaccessshortpl{#2}}#3%
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\def\@ACRshortpl#1#2[#3]{%
+ \@glsxtr@base@acrcmd\ACRshortpl\GLSxtrshortpl
+ \glsdoifexists{#2}%
+ {%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@firstoftwo
+ \let\glscapscase\@thirdofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \mfirstucMakeUppercase{\acronymfont{\glsaccessshortpl{#2}}#3}%
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\def\@acrlong#1#2[#3]{%
+ \@glsxtr@base@acrcmd\acrlong\glsxtrlong
+ \glsdoifexists{#2}%
+ {%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@secondoftwo
+ \let\glscapscase\@firstofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \acronymfont{\glsaccesslong{#2}}#3%
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\def\@Acrlong#1#2[#3]{%
+ \@glsxtr@base@acrcmd\Acrlong\Glsxtrlong
+ \glsdoifexists{#2}%
+ {%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@secondoftwo
+ \let\glscapscase\@secondofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \acronymfont{\Glsaccesslong{#2}}#3%
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\def\@ACRlong#1#2[#3]{%
+ \@glsxtr@base@acrcmd\ACRlong\GLSxtrlong
+ \glsdoifexists{#2}%
+ {%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@secondoftwo
+ \let\glscapscase\@thirdofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \mfirstucMakeUppercase{\acronymfont{\glsaccesslong{#2}}#3}%
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\def\@acrlongpl#1#2[#3]{%
+ \@glsxtr@base@acrcmd\acrlongpl\glsxtrlongpl
+ \glsdoifexists{#2}%
+ {%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@firstoftwo
+ \let\glscapscase\@firstofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \acronymfont{\glsaccesslongpl{#2}}#3%
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\def\@Acrlongpl#1#2[#3]{%
+ \@glsxtr@base@acrcmd\Acrlongpl\Glsxtrlongpl
+ \glsdoifexists{#2}%
+ {%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@firstoftwo
+ \let\glscapscase\@secondofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \acronymfont{\Glsaccesslongpl{#2}}#3%
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\def\@ACRlongpl#1#2[#3]{%
+ \@glsxtr@base@acrcmd\ACRlongpl\GLSxtrlongpl
+ \glsdoifexists{#2}%
+ {%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@firstoftwo
+ \let\glscapscase\@thirdofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \mfirstucMakeUppercase{\acronymfont{\glsaccesslongpl{#2}}#3}%
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\def\@acrfull#1#2[#3]{%
+ \@glsxtr@base@acrcmd\acrfull\glsxtrfull
+ \acrfullfmt{#1}{#2}{#3}%
+}
+\def\@Acrfull#1#2[#3]{%
+ \@glsxtr@base@acrcmd\Acrfull\Glsxtrfull
+ \Acrfullfmt{#1}{#2}{#3}%
+}
+\def\@ACRfull#1#2[#3]{%
+ \@glsxtr@base@acrcmd\ACRfull\GLSxtrfull
+ \ACRfullfmt{#1}{#2}{#3}%
+}
+\def\@acrfullpl#1#2[#3]{%
+ \@glsxtr@base@acrcmd\acrfullpl\glsxtrfullpl
+ \acrfullplfmt{#1}{#2}{#3}%
+}
+\def\@Acrfullpl#1#2[#3]{%
+ \@glsxtr@base@acrcmd\Acrfullpl\Glsxtrfullpl
+ \Acrfullplfmt{#1}{#2}{#3}%
+}
+\def\@ACRfullpl#1#2[#3]{%
+ \@glsxtr@base@acrcmd\ACRfullpl\GLSxtrfullpl
+ \ACRfullplfmt{#1}{#2}{#3}%
+}
+\renewcommand*{\@glsaddkey}[7]{%
+ \key@ifundefined{glossentry}{#1}%
+ {%
+ \define@key{glossentry}{#1}{\csdef{@glo@#1}{##1}}%
+ \appto\@gls@keymap{,{#1}{#1}}%
+ \appto\@newglossaryentryprehook{\csdef{@glo@#1}{#2}}%
+ \appto\@newglossaryentryposthook{%
+ \letcs{\@glo@tmp}{@glo@#1}%
+ \gls@assign@field{#2}{\@glo@label}{#1}{\@glo@tmp}%
+ }%
+ \newcommand*{#3}[1]{\@gls@entry@field{##1}{#1}}%
+ \newcommand*{#4}[1]{\@Gls@entry@field{##1}{#1}}%
+ \ifcsdef{@gls@user@#1@}%
+ {%
+ \PackageError{glossaries}%
+ {Can't define `\string#5' as helper command
+ `\expandafter\string\csname @gls@user@#1@\endcsname' already
+ exists}%
+ {}%
+ }%
+ {%
+ \expandafter\newcommand\expandafter*\expandafter
+ {\csname @gls@user@#1\endcsname}[2][]{%
+ \new@ifnextchar[%
+ {\csuse{@gls@user@#1@}{##1}{##2}}%
+ {\csuse{@gls@user@#1@}{##1}{##2}[]}}%
+ \csdef{@gls@user@#1@}##1##2[##3]{%
+ \@gls@field@link{##1}{##2}{#3{##2}##3}%
+ }%
+ \newrobustcmd*{#5}{%
+ \expandafter\@gls@hyp@opt\csname @gls@user@#1\endcsname}%
+ }%
+ \ifcsdef{@Gls@user@#1@}%
+ {%
+ \PackageError{glossaries}%
+ {Can't define `\string#6' as helper command
+ `\expandafter\string\csname @Gls@user@#1@\endcsname' already
+ exists}%
+ {}%
+ }%
+ {%
+ \expandafter\newcommand\expandafter*\expandafter
+ {\csname @Gls@user@#1\endcsname}[2][]{%
+ \new@ifnextchar[%
+ {\csuse{@Gls@user@#1@}{##1}{##2}}%
+ {\csuse{@Gls@user@#1@}{##1}{##2}[]}}%
+ \csdef{@Gls@user@#1@}##1##2[##3]{%
+ \@gls@field@link[\let\glscapscase\@secondofthree]%
+ {##1}{##2}{#4{##2}##3}%
+ }%
+ \newrobustcmd*{#6}{%
+ \expandafter\@gls@hyp@opt\csname @Gls@user@#1\endcsname}%
+ }%
+ \ifcsdef{@GLS@user@#1@}%
+ {%
+ \PackageError{glossaries}%
+ {Can't define `\string#7' as helper command
+ `\expandafter\string\csname @GLS@user@#1@\endcsname' already
+ exists}%
+ {}%
+ }%
+ {%
+ \expandafter\newcommand\expandafter*\expandafter
+ {\csname @GLS@user@#1\endcsname}[2][]{%
+ \new@ifnextchar[%
+ {\csuse{@GLS@user@#1@}{##1}{##2}}%
+ {\csuse{@GLS@user@#1@}{##1}{##2}[]}}%
+ \csdef{@GLS@user@#1@}##1##2[##3]{%
+ \@gls@field@link[\let\glscapscase\@thirdofthree]%
+ {##1}{##2}{\mfirstucMakeUppercase{#3{##2}##3}}%
+ }%
+ \newrobustcmd*{#7}{%
+ \expandafter\@gls@hyp@opt\csname @GLS@user@#1\endcsname}%
+ }%
+ }%
+ {%
+ \PackageError{glossaries-extra}{Key `#1' already exists}{}%
+ }%
+}
+\providecommand*{\@gls@link@nocheckfirsthyper}{}
+\let\@glsxtr@org@checkfirsthyper\@gls@link@checkfirsthyper
+\renewcommand*{\@gls@link@checkfirsthyper}{%
+ \ifglsused{\glslabel}%
+ {\let\glsxtrifwasfirstuse\@secondoftwo}
+ {\let\glsxtrifwasfirstuse\@firstoftwo}%
+ \protected@edef\glscategorylabel{\glscategory{\glslabel}}%
+ \ifglsused{\glslabel}%
+ {%
+ \glsifcategoryattribute{\glscategorylabel}{nohypernext}{true}%
+ {\KV@glslink@hyperfalse}{}%
+ }%
+ {%
+ \glsifcategoryattribute{\glscategorylabel}{nohyperfirst}{true}%
+ {\KV@glslink@hyperfalse}{}%
+ }%
+ \glslinkcheckfirsthyperhook
+}
+\ifdef\do@glsdisablehyperinlist
+{%
+ \let\@glsxtr@do@glsdisablehyperinlist\do@glsdisablehyperinlist
+ \renewcommand*{\do@glsdisablehyperinlist}{%
+ \@glsxtr@do@glsdisablehyperinlist
+ \glsifattribute{\glslabel}{nohyper}{true}{\KV@glslink@hyperfalse}{}%
+ }
+}
+{}
+\define@boolkey{glslink}{noindex}[true]{}
+\KV@glslink@noindexfalse
+\providecommand*{\@gls@save@glslocal}{%
+ \let\if@org@KV@glslink@local\ifKV@glslink@local
+}
+\providecommand*{\@gls@restore@glslocal}{%
+ \ifKV@glslink@local
+ \let\@gls@do@glsunset\glslocalunset
+ \else
+ \let\@gls@do@glsunset\glsunset
+ \fi
+}
+\providecommand*{\@gls@do@glsunset}[1]{\glsunset{#1}}
+\ifdef\@gls@setdefault@glslink@opts
+{
+ \renewcommand*{\@gls@setdefault@glslink@opts}{%
+ \KV@glslink@noindexfalse
+ \@glsxtrsetaliasnoindex
+ }
+}
+{
+ \newcommand*{\@gls@setdefault@glslink@opts}{%
+ \KV@glslink@noindexfalse
+ \@glsxtrsetaliasnoindex
+ }
+ \preto\do@glsdisablehyperinlist{\@gls@setdefault@glslink@opts}
+}
+\providecommand*{\glsxtrsetaliasnoindex}{%
+ \KV@glslink@noindextrue
+}
+\newcommand*{\@glsxtrsetaliasnoindex}{%
+ \ifcsvoid{glo@\glsdetoklabel{\glslabel}@alias}%
+ {}%
+ {%
+ \let\glsxtrindexaliased\@glsxtrindexaliased
+ \glsxtrsetaliasnoindex
+ \let\glsxtrindexaliased\@no@glsxtrindexaliased
+ }%
+}
+\newcommand{\@glsxtrindexaliased}{%
+ \ifKV@glslink@noindex
+ \else
+ \begingroup
+ \let\@glsnumberformat\@glsxtr@defaultnumberformat
+ \protected@edef\@gls@counter{\csname glo@\glsdetoklabel{\glslabel}@counter\endcsname}%
+ \glsxtr@saveentrycounter
+ \@@do@wrglossary{\glsxtralias{\glslabel}}%
+ \endgroup
+ \fi
+}
+\newcommand{\@no@glsxtrindexaliased}{%
+ \PackageError{glossaries-extra}{\string\glsxtrindexaliased\space
+ not permitted outside definition of \string\glsxtrsetaliasnoindex}%
+ {}%
+}
+\let\glsxtrindexaliased\@no@glsxtrindexaliased
+\newcommand*{\GlsXtrSetDefaultGlsOpts}[1]{%
+ \renewcommand*{\@gls@setdefault@glslink@opts}{%
+ \setkeys{glslink}{#1}%
+ \@glsxtrsetaliasnoindex
+ }%
+}
+\newcommand*{\glsxtrifindexing}[2]{%
+ \ifKV@glslink@noindex #2\else #1\fi
+}
+\renewcommand*{\glswriteentry}[2]{%
+ \glsxtrifindexing
+ {%
+ \ifglsindexonlyfirst
+ \GlsXtrIfUnusedOrUndefined{#1}
+ {#2}%
+ {\glsxtrdoautoindexname{#1}{dualindex}}%
+ \else
+ \glsifattribute{#1}{indexonlyfirst}{true}%
+ {%
+ \GlsXtrIfUnusedOrUndefined{#1}%
+ {#2}%
+ {\glsxtrdoautoindexname{#1}{dualindex}}%
+ }%
+ {#2}%
+ \fi
+ }%
+ {}%
+}
+\appto\@@do@@wrglossary{\@glsxtr@do@@wrindex
+ \glsxtrdowrglossaryhook{\@gls@label}%
+}
+\appto\gls@noidxglossary{\@glsxtr@do@@wrindex
+ \glsxtrdowrglossaryhook{\@gls@label}%
+}
+\newcommand*{\@glsxtr@do@@wrindex}{%
+ \glsxtrdoautoindexname{\@gls@label}{dualindex}%
+}
+\newcommand*{\glsxtrdowrglossaryhook}[1]{}
+\newcommand*{\@gls@alt@hyp@opt}[1]{%
+ \let\glslinkvar\@firstofthree
+ \let\@gls@hyp@opt@cs#1\relax
+ \@ifstar{\s@gls@hyp@opt}%
+ {\@ifnextchar+%
+ {\@firstoftwo{\p@gls@hyp@opt}}%
+ {%
+ \expandafter\@ifnextchar\@gls@alt@hyp@opt@char
+ {\@firstoftwo{\@alt@gls@hyp@opt}}%
+ {#1}%
+ }%
+ }%
+}
+\newcommand*{\@alt@gls@hyp@opt}[1][]{%
+ \let\glslinkvar\@firstofthree
+ \expandafter\@gls@hyp@opt@cs\expandafter[\@gls@alt@hyp@opt@keys,#1]}
+\newcommand*{\@gls@alt@hyp@opt@char}{}
+\newcommand*{\@gls@alt@hyp@opt@keys}{}
+\newcommand*{\GlsXtrSetAltModifier}[2]{%
+ \let\@gls@hyp@opt\@gls@alt@hyp@opt
+ \ifstrequal{#1}{+}%
+ {\PackageError{glossaries-extra}%
+ {Can't use '#1' as modifier (it's already in use)}{}}%
+ {%
+ \ifstrequal{#1}{*}%
+ {\PackageError{glossaries-extra}%
+ {Can't use '#1' as modifier (it's already in use)}{}}%
+ {}%
+ }%
+ \def\@gls@alt@hyp@opt@char{#1}%
+ \def\@gls@alt@hyp@opt@keys{#2}%
+ \ifdefequal\@glsxtr@record@setting\@glsxtr@record@setting@off
+ {}%
+ {%
+ \protected@write\@auxout{}{\string\providecommand{\string\@glsxtr@altmodifier}[1]{}}%
+ \protected@write\@auxout{}{\string\@glsxtr@altmodifier{#1}}%
+ }%
+}
+\let\glsxtr@org@dohyperlink\glsdohyperlink
+\ifdef\glsnavhyperlink
+{
+ \renewcommand*{\glsnavhyperlink}[3][\@glo@type]{%
+ \protected@edef\gls@grplabel{#2}\protected@edef\@gls@grptitle{#3}%
+ {%
+ \let\glsxtrdohyperlink\glsxtr@org@dohyperlink
+ \@glslink{\glsnavhyperlinkname{#1}{#2}}{#3}%
+ }%
+ }%
+}
+{}
+\ifdef\@@gls@navhypertarget
+{}
+{%
+ \renewcommand*{\glsnavhypertarget}{\protect\@@gls@navhypertarget}
+ \newcommand*{\@@gls@navhypertarget}[3][\@glo@type]{%
+ \@glsnavhypertarget{#1}{#2}{#3}%
+ }
+}%
+\ifdef\@glsnavhypertarget
+{%
+ \renewcommand*{\@glsnavhypertarget}[3]{%
+ \protected@write\@auxout{}{\string\@gls@hypergroup{#1}{#2}}%
+ \@glsxtr@do@org@target{\glsnavhyperlinkname{#1}{#2}}{#3}%
+ \ifcsdef{@gls@hypergrouplist@#1}%
+ {%
+ \letcs\@gls@list{@gls@hypergrouplist@#1}%
+ \protected@edef\@gls@thishypernavlabel{#2}%
+ \expandafter\DTLifinlist\expandafter{\@gls@thishypernavlabel}\@gls@list{}%
+ {%
+ \GlossariesWarningNoLine{Navigation panel
+ for glossary type `#1'^^Jmissing group `#2'}%
+ \gdef\gls@hypergrouprerun{%
+ \GlossariesWarningNoLine{Navigation panel
+ has changed. Rerun LaTeX}}%
+ }%
+ }%
+ {%
+ \GlossariesWarningNoLine{Navigation panel
+ for glossary type `#1'^^Jmissing group `#2'}%
+ \gdef\gls@hypergrouprerun{%
+ \GlossariesWarningNoLine{Navigation panel
+ has changed. Rerun LaTeX}}%
+ }%
+ }%
+}
+{}
+\newcommand*{\glsxtrdohyperlink}[2]{%
+ \glshasattribute{\glslabel}{targeturl}%
+ {%
+ \glshasattribute{\glslabel}{targetname}%
+ {%
+ \glshasattribute{\glslabel}{targetcategory}%
+ {%
+ \hyperref{\glsgetattribute{\glslabel}{targeturl}}%
+ {\glsgetattribute{\glslabel}{targetcategory}}%
+ {\glsgetattribute{\glslabel}{targetname}}%
+ {{\glsxtrprotectlinks#2}}%
+ }%
+ {%
+ \hyperref{\glsgetattribute{\glslabel}{targeturl}}%
+ {}%
+ {\glsgetattribute{\glslabel}{targetname}}%
+ {{\glsxtrprotectlinks#2}}%
+ }%
+ }%
+ {%
+ \href{\glsgetattribute{\glslabel}{targeturl}}%
+ {{\glsxtrprotectlinks#2}}%
+ }%
+ }%
+ {%
+ \glsfieldfetch{\glslabel}{alias}{\gloaliaslabel}%
+ \ifdefvoid\gloaliaslabel
+ {%
+ \glsxtrhyperlink{#1}{{\glsxtrprotectlinks#2}}%
+ }%
+ {%
+ \glsxtrifmulti\gloaliaslabel
+ {%
+ \letcs\gloaliaslabel{@gls@combined@\gloaliaslabel @main}%
+ }%
+ {}%
+ \glsxtrhyperlink
+ {\glolinkprefix\glsdetoklabel{\gloaliaslabel}}%
+ {{\glsxtrprotectlinks#2}}%
+ }%
+ }%
+}
+
+\newcommand{\glsxtrhyperlink}[2]{%
+ \glsdoshowtarget{#1}{\hyperlink{#1}{#2}}%
+}%
+\renewrobustcmd*{\glshyperlink}[2][\glsentrytext{\@glo@label}]{%
+ \glsdoifexists{#2}%
+ {%
+ \def\@glo@label{#2}%
+ {\protected@edef\glslabel{#2}%
+ \@glslink{\glolinkprefix\glslabel}{#1}}%
+ }%
+}
+\renewcommand{\glsdisablehyper}{%
+ \KV@glslink@hyperfalse
+ \def\@glslink{\glsdonohyperlink}%
+ \let\@glstarget\@secondoftwo
+}
+\renewcommand{\glsenablehyper}{%
+ \KV@glslink@hypertrue
+ \def\@glslink{\glsxtrdohyperlink}%
+ \def\@glstarget{\glsdohypertarget}%
+}
+\def\glsdonohyperlink#1#2{{\glsxtrprotectlinks #2}}
+\ifcsundef{hyperlink}%
+{%
+ \def\@glslink{\glsdonohyperlink}
+}%
+{%
+ \def\@glslink{\glsxtrdohyperlink}
+}
+\newcommand*{\glsxtrprotectlinks}{%
+ \KV@glslink@hyperfalse
+ \KV@glslink@noindextrue
+ \let\@gls@\@glsxtr@p@text@
+ \let\@Gls@\@Glsxtr@p@text@
+ \let\@GLS@\@GLSxtr@p@text@
+ \let\@glspl@\@glsxtr@p@plural@
+ \let\@Glspl@\@Glsxtr@p@plural@
+ \let\@GLSpl@\@GLSxtr@p@plural@
+ \let\@glsxtrshort\@glsxtr@p@short@
+ \let\@Glsxtrshort\@Glsxtr@p@short@
+ \let\@GLSxtrshort\@GLSxtr@p@short@
+ \let\@glsxtrlong\@glsxtr@p@long@
+ \let\@Glsxtrlong\@Glsxtr@p@long@
+ \let\@GLSxtrlong\@GLSxtr@p@long@
+ \let\@glsxtrshortpl\@glsxtr@p@shortpl@
+ \let\@Glsxtrshortpl\@Glsxtr@p@shortpl@
+ \let\@GLSxtrshortpl\@GLSxtr@p@shortpl@
+ \let\@glsxtrlongpl\@glsxtr@p@longpl@
+ \let\@Glsxtrlongpl\@Glsxtr@p@longpl@
+ \let\@GLSxtrlongpl\@GLSxtr@p@longpl@
+ \let\@acrshort\@glsxtr@p@acrshort@
+ \let\@Acrshort\@Glsxtr@p@acrshort@
+ \let\@ACRshort\@GLSxtr@p@acrshort@
+ \let\@acrshortpl\@glsxtr@p@acrshortpl@
+ \let\@Acrshortpl\@Glsxtr@p@acrshortpl@
+ \let\@ACRshortpl\@GLSxtr@p@acrshortpl@
+ \let\@acrlong\@glsxtr@p@acrlong@
+ \let\@Acrlong\@Glsxtr@p@acrlong@
+ \let\@ACRlong\@GLSxtr@p@acrlong@
+ \let\@acrlongpl\@glsxtr@p@acrlongpl@
+ \let\@Acrlongpl\@Glsxtr@p@acrlongpl@
+ \let\@ACRlongpl\@GLSxtr@p@acrlongpl@
+}
+\def\@glsxtr@p@text@#1#2[#3]{{\@glstext@{#1}{#2}[#3]}}
+\def\@Glsxtr@p@text@#1#2[#3]{{\@Glstext@{#1}{#2}[#3]}}
+\def\@GLSxtr@p@text@#1#2[#3]{{\@GLStext@{#1}{#2}[#3]}}
+\def\@glsxtr@p@plural@#1#2[#3]{{\@glsplural@{#1}{#2}[#3]}}
+\def\@Glsxtr@p@plural@#1#2[#3]{{\@Glsplural@{#1}{#2}[#3]}}
+\def\@GLSxtr@p@plural@#1#2[#3]{{\@GLSplural@{#1}{#2}[#3]}}
+\def\@glsxtr@p@short@#1#2[#3]{%
+ {%
+ \glssetabbrvfmt{\glscategory{#2}}%
+ \glsabbrvfont{\glsentryshort{#2}}#3%
+ }%
+}
+\def\@Glsxtr@p@short@#1#2[#3]{%
+ {%
+ \glssetabbrvfmt{\glscategory{#2}}%
+ \glsabbrvfont{\Glsentryshort{#2}}#3%
+ }%
+}
+\def\@GLSxtr@p@short@#1#2[#3]{%
+ {%
+ \glssetabbrvfmt{\glscategory{#2}}%
+ \mfirstucMakeUppercase{\glsabbrvfont{\glsentryshort{#2}}#3}%
+ }%
+}
+\def\@glsxtr@p@shortpl@#1#2[#3]{%
+ {%
+ \glssetabbrvfmt{\glscategory{#2}}%
+ \glsabbrvfont{\glsentryshortpl{#2}}#3%
+ }%
+}
+\def\@Glsxtr@p@shortpl@#1#2[#3]{%
+ {%
+ \glssetabbrvfmt{\glscategory{#2}}%
+ \glsabbrvfont{\Glsentryshortpl{#2}}#3%
+ }%
+}
+\def\@GLSxtr@p@shortpl@#1#2[#3]{%
+ {%
+ \glssetabbrvfmt{\glscategory{#2}}%
+ \mfirstucMakeUppercase{\glsabbrvfont{\glsentryshortpl{#2}}#3}%
+ }%
+}
+\def\@glsxtr@p@long@#1#2[#3]{{\glsentrylong{#2}#3}}
+\def\@Glsxtr@p@long@#1#2[#3]{{\Glsentrylong{#2}#3}}
+\def\@GLSxtr@p@long@#1#2[#3]{%
+ {\mfirstucMakeUppercase{\glslongfont{\glsentrylong{#2}}#3}}}
+\def\@glsxtr@p@longpl@#1#2[#3]{{\glsentrylongpl{#2}#3}}
+\def\@Glsxtr@p@longpl@#1#2[#3]{{\glslongfont{\Glsentrylongpl{#2}}#3}}
+\def\@GLSxtr@p@longpl@#1#2[#3]{%
+ {\mfirstucMakeUppercase{\glslongfont{\glsentrylongpl{#2}}#3}}}
+\def\@glsxtr@p@acrshort@#1#2[#3]{{\acronymfont{\glsentryshort{#2}}#3}}
+\def\@Glsxtr@p@acrshort@#1#2[#3]{{\acronymfont{\Glsentryshort{#2}}#3}}
+\def\@GLSxtr@p@acrshort@#1#2[#3]{%
+ {\mfirstucMakeUppercase{\acronymfont{\glsentryshort{#2}}#3}}}
+\def\@glsxtr@p@acrshortpl@#1#2[#3]{{\acronymfont{\glsentryshortpl{#2}}#3}}
+\def\@Glsxtr@p@acrshortpl@#1#2[#3]{{\acronymfont{\Glsentryshortpl{#2}}#3}}
+\def\@GLSxtr@p@acrshortpl@#1#2[#3]{%
+ {\mfirstucMakeUppercase{\acronymfont{\glsentryshortpl{#2}}#3}}}
+\def\@glsxtr@p@acrlong@#1#2[#3]{{\glsentrylong{#2}#3}}
+\def\@Glsxtr@p@acrlong@#1#2[#3]{{\Glsentrylong{#2}#3}}
+\def\@GLSxtr@p@acrlong@#1#2[#3]{%
+ {\mfirstucMakeUppercase{\glsentrylong{#2}#3}}}
+\def\@glsxtr@p@acrlongpl@#1#2[#3]{{\glsentrylongpl{#2}#3}}
+\def\@Glsxtr@p@acrlongpl@#1#2[#3]{{\Glsentrylongpl{#2}#3}}
+\def\@GLSxtr@p@acrlongpl@#1#2[#3]{%
+ {\mfirstucMakeUppercase{\glsentrylongpl{#2}#3}}}
+\newcommand*{\@glsxtrp@opt}{hyper=false,noindex}
+\newcommand*{\glsxtrsetpopts}[1]{%
+ \renewcommand*{\@glsxtrp@opt}{#1}%
+}
+\newcommand*{\glossxtrsetpopts}{%
+ \glsxtrsetpopts{noindex}%
+}
+\newrobustcmd*{\@@glsxtrp}[2]{%
+ {%
+ \let\glspostlinkhook\relax
+ \csname#1\expandafter\endcsname\expandafter[\@glsxtrp@opt]{#2}[]%
+ }%
+}
+\newrobustcmd*{\@glsxtrp}[2]{%
+ \ifcsdef{gls#1}%
+ {%
+ \@@glsxtrp{gls#1}{#2}%
+ }%
+ {%
+ \ifcsdef{glsxtr#1}%
+ {%
+ \@@glsxtrp{glsxtr#1}{#2}%
+ }%
+ {%
+ \PackageError{glossaries-extra}{`#1' not recognised by
+ \string\glsxtrp}{}%
+ }%
+ }%
+}
+\newrobustcmd*{\@Glsxtrp}[2]{%
+ \ifcsdef{Gls#1}%
+ {%
+ \@@glsxtrp{Gls#1}{#2}%
+ }%
+ {%
+ \ifcsdef{Glsxtr#1}%
+ {%
+ \@@glsxtrp{Glsxtr#1}{#2}%
+ }%
+ {%
+ \PackageError{glossaries-extra}{`#1' not recognised by
+ \string\Glsxtrp}{}%
+ }%
+ }%
+}
+\newrobustcmd*{\@GLSxtrp}[2]{%
+ \ifcsdef{GLS#1}%
+ {%
+ \@@glsxtrp{GLS#1}{#2}%
+ }%
+ {%
+ \ifcsdef{GLSxtr#1}%
+ {%
+ \@@glsxtrp{GLSxtr#1}{#2}%
+ }%
+ {%
+ \PackageError{glossaries-extra}{`#1' not recognised by
+ \string\GLSxtrp}{}%
+ }%
+ }%
+}
+\newrobustcmd*{\glsxtr@headentry@p}[2]{%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \mfirstucMakeUppercase{\@gls@entry@field{#1}{#2}}%
+ }%
+ {%
+ \@gls@entry@field{#1}{#2}%
+ }%
+}
+\ifdef\texorpdfstring
+{
+ \newcommand{\glsxtrp}[2]{%
+ \protect\NoCaseChange
+ {%
+ \protect\texorpdfstring
+ {%
+ \protect\glsxtrifinmark
+ {%
+ \ifcsdef{glsxtrhead#1}%
+ {%
+ {\protect\csuse{glsxtrhead#1}{#2}}%
+ }%
+ {%
+ \glsxtr@headentry@p{#2}{#1}%
+ }%
+ }%
+ {%
+ \@glsxtrp{#1}{#2}%
+ }%
+ }%
+ {%
+ \protect\@gls@entry@field{#2}{#1}%
+ }%
+ }%
+ }
+}
+{
+ \newcommand{\glsxtrp}[2]{%
+ \protect\NoCaseChange
+ {%
+ \protect\glsxtrifinmark
+ {%
+ \ifcsdef{glsxtrhead#1}%
+ {%
+ {\protect\csuse{glsxtrhead#1}}%
+ }%
+ {%
+ \glsxtr@headentry@p{#2}{#1}%
+ }%
+ }%
+ {%
+ \@glsxtrp{#1}{#2}%
+ }%
+ }%
+ }
+}
+\newcommand*{\glsps}{\glsxtrp{short}}
+\newcommand*{\glspt}{\glsxtrp{text}}
+\ifdef\texorpdfstring
+{
+ \newcommand{\Glsxtrp}[2]{%
+ \protect\NoCaseChange
+ {%
+ \protect\texorpdfstring
+ {%
+ \protect\glsxtrifinmark
+ {%
+ \ifcsdef{Glsxtrhead#1}%
+ {%
+ {\protect\csuse{Glsxtrhead#1}{#2}}%
+ }%
+ {%
+ \protect\@Gls@entry@field{#2}{#1}%
+ }%
+ }%
+ {%
+ \@Glsxtrp{#1}{#2}%
+ }%
+ }%
+ {%
+ \protect\@gls@entry@field{#2}{#1}%
+ }%
+ }%
+ }
+}
+{
+ \newcommand{\Glsxtrp}[2]{%
+ \protect\NoCaseChange
+ {%
+ \protect\glsxtrifinmark
+ {%
+ \ifcsdef{Glsxtrhead#1}%
+ {%
+ {\protect\csuse{Glsxtrhead#1}}%
+ }%
+ {%
+ \protect\@Gls@entry@field{#2}{#1}%
+ }%
+ }%
+ {%
+ \@Glsxtrp{#1}{#2}%
+ }%
+ }%
+ }
+}
+\ifdef\texorpdfstring
+{
+ \newcommand{\GLSxtrp}[2]{%
+ \protect\NoCaseChange
+ {%
+ \protect\texorpdfstring
+ {%
+ \protect\glsxtrifinmark
+ {%
+ \ifcsdef{GLSxtr#1}%
+ {%
+ {\protect\GLSxtrshort[noindex,hyper=false]{#1}[]}%
+ }%
+ {%
+ \protect\mfirstucMakeUppercase
+ {%
+ \protect\@gls@entry@field{#2}{#1}%
+ }%
+ }%
+ }%
+ {%
+ \@GLSxtrp{#1}{#2}%
+ }%
+ }%
+ {%
+ \protect\@gls@entry@field{#2}{#1}%
+ }%
+ }%
+ }
+}
+{
+ \newcommand{\GLSxtrp}[2]{%
+ \protect\NoCaseChange
+ {%
+ \protect\glsxtrifinmark
+ {%
+ \ifcsdef{GLSxtr#1}%
+ {%
+ {\protect\GLSxtrshort[noindex,hyper=false]{#1}[]}%
+ }%
+ {%
+ \protect\mfirstucMakeUppercase
+ {%
+ \protect\@gls@entry@field{#2}{#1}%
+ }%
+ }%
+ }%
+ {%
+ \@GLSxtrp{#1}{#2}%
+ }%
+ }%
+ }
+}
+\newcommand*{\@glsxtr@unset}[1]{%
+ \@@glsunset{#1}%
+ \glsxtrpostunset{#1}%
+}%
+\let\@glsunset\@glsxtr@unset
+\newcommand*{\glsxtrpostunset}[1]{}
+\newcommand*{\GlsXtrStartUnsetBuffering}{%
+ \@ifstar\s@GlsXtrStartUnsetBuffering\@GlsXtrStartUnsetBuffering
+}
+\newcommand*{\@GlsXtrStartUnsetBuffering}{%
+ \let\@glsxtr@org@unset@buffer\@glsxtr@unset@buffer
+ \def\@glsxtr@unset@buffer{}%
+ \let\@glsunset\@glsxtrbuffer@unset
+}
+\newcommand*{\s@GlsXtrStartUnsetBuffering}{%
+ \let\@glsxtr@org@unset@buffer\@glsxtr@unset@buffer
+ \def\@glsxtr@unset@buffer{}%
+ \let\@glsunset\@glsxtrbuffer@nodup@unset
+}
+\newcommand*{\@glsxtrbuffer@unset}[1]{%
+ \listxadd\@glsxtr@unset@buffer{#1}%
+}
+\newcommand*{\@glsxtrbuffer@nodup@unset}[1]{%
+ \expandafter\ifinlist\expandafter{#1}{\@glsxtr@unset@buffer}{}%
+ {\listxadd\@glsxtr@unset@buffer{#1}}%
+}
+\newcommand*{\GlsXtrStopUnsetBuffering}{%
+ \@ifstar\s@GlsXtrStopUnsetBuffering\@GlsXtrStopUnsetBuffering
+}
+\newcommand*{\@GlsXtrStopUnsetBuffering}{%
+ \let\@glsunset\@glsxtr@unset
+ \forlistloop\@glsunset\@glsxtr@unset@buffer
+ \let\@glsxtr@unset@buffer\@glsxtr@org@unset@buffer
+}
+\newcommand*{\s@GlsXtrStopUnsetBuffering}{%
+ \forlistloop\@glslocalunset\@glsxtr@unset@buffer
+ \let\@glsunset\@glsxtr@unset
+}
+\newcommand*{\GlsXtrDiscardUnsetBuffering}{%
+ \let\@glsunset\@glsxtr@unset
+ \let\@glsxtr@unset@buffer\@glsxtr@org@unset@buffer
+}
+\newcommand*{\GlsXtrForUnsetBufferedList}[1]{%
+ \forlistloop#1\@glsxtr@unset@buffer
+}
+\renewcommand*{\@glslocalunset}[1]{%
+ \@@glslocalunset{#1}%
+ \glsxtrpostlocalunset{#1}%
+}%
+\newcommand*{\glsxtrpostlocalunset}[1]{}
+\renewcommand*{\@glsreset}[1]{%
+ \@@glsreset{#1}%
+ \glsxtrpostreset{#1}%
+}%
+\newcommand*{\glsxtrpostreset}[1]{}
+\renewcommand*{\@glslocalreset}[1]{%
+ \@@glslocalreset{#1}%
+ \glsxtrpostlocalreset{#1}%
+}%
+\newcommand*{\glsxtrpostlocalreset}[1]{}
+\newcommand*{\glslocalreseteach}[1]{%
+ \gls@ifnotmeasuring
+ {%
+ \@for\@gls@thislabel:=#1\do{%
+ \glsdoifexists{\@gls@thislabel}%
+ {%
+ \@glslocalreset{\@gls@thislabel}%
+ }%
+ }%
+ }%
+}
+\newcommand*{\glslocalunseteach}[1]{%
+ \gls@ifnotmeasuring
+ {%
+ \@for\@gls@thislabel:=#1\do{%
+ \glsdoifexists{\@gls@thislabel}%
+ {%
+ \@glslocalunset{\@gls@thislabel}%
+ }%
+ }%
+ }%
+}
+\newcommand*{\GlsXtrEnableEntryCounting}[2]{%
+ \glsenableentrycount
+ \renewcommand*{\gls}{\cgls}%
+ \renewcommand*{\Gls}{\cGls}%
+ \renewcommand*{\glspl}{\cglspl}%
+ \renewcommand*{\Glspl}{\cGlspl}%
+ \renewcommand*{\GLS}{\cGLS}%
+ \renewcommand*{\GLSpl}{\cGLSpl}%
+ \@glsxtr@setentrycountunsetattr{#1}{#2}%
+ \let\GlsXtrEnableEntryCounting\@glsxtr@setentrycountunsetattr
+ \renewcommand*{\GlsXtrEnableEntryUnitCounting}[3]{%
+ \PackageError{glossaries-extra}{\string\GlsXtrEnableEntryUnitCounting\space
+ can't be used with \string\GlsXtrEnableEntryCounting}%
+ {Use one or other but not both commands}}%
+}
+\newcommand*{\@glsxtr@setentrycountunsetattr}[2]{%
+ \@for\@glsxtr@cat:=#1\do
+ {%
+ \ifdefempty{\@glsxtr@cat}{}%
+ {%
+ \glssetcategoryattribute{\@glsxtr@cat}{entrycount}{#2}%
+ }%
+ }%
+}
+\renewcommand*{\glsenableentrycount}{%
+ \appto\@newglossaryentry@defcounters{\@@newglossaryentry@defcounters}%
+ \renewcommand*{\gls@defdocnewglossaryentry}{%
+ \renewcommand*\newglossaryentry[2]{%
+ \PackageError{glossaries}{\string\newglossaryentry\space
+ may only be used in the preamble when entry counting has
+ been activated}{If you use \string\glsenableentrycount\space
+ you must place all entry definitions in the preamble not in
+ the document environment}%
+ }%
+ }%
+ \newcommand*{\glsentrycurrcount}[1]{%
+ \ifcsundef{glo@\glsdetoklabel{##1}@currcount}%
+ {0}{\@gls@entry@field{##1}{currcount}}%
+ }%
+ \newcommand*{\glsentryprevcount}[1]{%
+ \ifcsundef{glo@\glsdetoklabel{##1}@prevcount}%
+ {0}{\@gls@entry@field{##1}{prevcount}}%
+ }%
+ \let\@glsxtr@entrycount@org@unset\glsxtrpostunset
+ \renewcommand*{\glsxtrpostunset}[1]{%
+ \@glsxtr@entrycount@org@unset{##1}%
+ \@gls@increment@currcount{##1}%
+ }%
+ \let\@glsxtr@entrycount@org@localunset\glsxtrpostlocalunset
+ \renewcommand*{\glsxtrpostlocalunset}[1]{%
+ \@glsxtr@entrycount@org@localunset{##1}%
+ \@gls@local@increment@currcount{##1}%
+ }%
+ \let\@glsxtr@entrycount@org@reset\glsxtrpostreset
+ \renewcommand*{\glsxtrpostreset}[1]{%
+ \@glsxtr@entrycount@org@reset{##1}%
+ \csgdef{glo@\glsdetoklabel{##1}@currcount}{0}%
+ }%
+ \let\@glsxtr@entrycount@org@localreset\glsxtrpostlocalreset
+ \renewcommand*{\glsxtrpostlocalreset}[1]{%
+ \@glsxtr@entrycount@org@localreset{##1}%
+ \csdef{glo@\glsdetoklabel{##1}@currcount}{0}%
+ }%
+ \let\@cgls@\@@cgls@
+ \let\@cglspl@\@@cglspl@
+ \let\@cGls@\@@cGls@
+ \let\@cGlspl@\@@cGlspl@
+ \let\@cGLS@\@@cGLS@
+ \let\@cGLSpl@\@@cGLSpl@
+ \AtEndDocument{\@gls@write@entrycounts}%
+ \renewcommand*{\@gls@entry@count}[2]{%
+ \csgdef{glo@\glsdetoklabel{##1}@prevcount}{##2}%
+ }%
+ \let\glsenableentrycount\relax
+ \renewcommand*{\glsenableentryunitcount}{%
+ \PackageError{glossaries-extra}{\string\glsenableentryunitcount\space
+ can't be used with \string\glsenableentrycount}%
+ {Use one or other but not both commands}%
+ }%
+}
+\renewcommand*{\@gls@write@entrycounts}{%
+ \immediate\write\@auxout
+ {\string\providecommand*{\string\@gls@entry@count}[2]{}}%
+ \count@=0\relax
+ \forallglsentries{\@glsentry}{%
+ \glshasattribute{\@glsentry}{entrycount}%
+ {%
+ \ifglsused{\@glsentry}%
+ {%
+ \immediate\write\@auxout
+ {\string\@gls@entry@count{\@glsentry}{\glsentrycurrcount{\@glsentry}}}%
+ }%
+ {}%
+ \advance\count@ by \@ne
+ }%
+ {}%
+ }%
+ \ifnum\count@=0
+ \GlossariesExtraWarningNoLine{Entry counting has been enabled
+ \MessageBreak with \string\glsenableentrycount\space but the
+ \MessageBreak attribute `entrycount' hasn't
+ \MessageBreak been assigned to any of the defined
+ \MessageBreak entries}%
+ \fi
+}
+\newcommand*{\glsxtrifcounttrigger}[3]{%
+ \glshasattribute{#1}{entrycount}%
+ {%
+ \ifnum\glsentryprevcount{#1}>\glsgetattribute{#1}{entrycount}\relax
+ #3%
+ \else
+ #2%
+ \fi
+ }%
+ {#3}%
+}
+\def\@@cgls@#1#2[#3]{%
+ \glsxtrifcounttrigger{#2}%
+ {%
+ \cglsformat{#2}{#3}%
+ \glsunset{#2}%
+ }%
+ {%
+ \@gls@{#1}{#2}[#3]%
+ }%
+}%
+\def\@@cglspl@#1#2[#3]{%
+ \glsxtrifcounttrigger{#2}%
+ {%
+ \cglsplformat{#2}{#3}%
+ \glsunset{#2}%
+ }%
+ {%
+ \@glspl@{#1}{#2}[#3]%
+ }%
+}%
+\def\@@cGls@#1#2[#3]{%
+ \glsxtrifcounttrigger{#2}%
+ {%
+ \cGlsformat{#2}{#3}%
+ \glsunset{#2}%
+ }%
+ {%
+ \@Gls@{#1}{#2}[#3]%
+ }%
+}%
+\def\@@cGlspl@#1#2[#3]{%
+ \glsxtrifcounttrigger{#2}%
+ {%
+ \cGlsplformat{#2}{#3}%
+ \glsunset{#2}%
+ }%
+ {%
+ \@Glspl@{#1}{#2}[#3]%
+ }%
+}%
+\def\@@cGLS@#1#2[#3]{%
+ \glsxtrifcounttrigger{#2}%
+ {%
+ \cGLSformat{#2}{#3}%
+ \glsunset{#2}%
+ }%
+ {%
+ \@GLS@{#1}{#2}[#3]%
+ }%
+}%
+\def\@@cGLSpl@#1#2[#3]{%
+ \glsxtrifcounttrigger{#2}%
+ {%
+ \cGLSplformat{#2}{#3}%
+ \glsunset{#2}%
+ }%
+ {%
+ \@GLSpl@{#1}{#2}[#3]%
+ }%
+}%
+\def\@cgls@#1#2[#3]{\@gls@{#1}{#2}[#3]}
+\def\@cGls@#1#2[#3]{\@Gls@{#1}{#2}[#3]}
+\def\@cglspl@#1#2[#3]{\@glspl@{#1}{#2}[#3]}
+\def\@cGlspl@#1#2[#3]{\@Glspl@{#1}{#2}[#3]}
+\newrobustcmd*{\cGLS}{\@gls@hyp@opt\@cGLS}
+\newcommand*{\@cGLS}[2][]{%
+ \new@ifnextchar[{\@cGLS@{#1}{#2}}{\@cGLS@{#1}{#2}[]}%
+}
+\def\@cGLS@#1#2[#3]{\@GLS@{#1}{#2}[#3]}
+\newcommand*{\cGLSformat}[2]{%
+ \expandafter\mfirstucMakeUppercase\expandafter{\cglsformat{#1}{#2}}%
+}
+\newrobustcmd*{\cGLSpl}{\@gls@hyp@opt\@cGLSpl}
+\newcommand*{\@cGLSpl}[2][]{%
+ \new@ifnextchar[{\@cGLSpl@{#1}{#2}}{\@cGLSpl@{#1}{#2}[]}%
+}
+\def\@cGLSpl@#1#2[#3]{\@GLSpl@{#1}{#2}[#3]}
+\newcommand*{\cGLSplformat}[2]{%
+ \expandafter\mfirstucMakeUppercase\expandafter{\cglsplformat{#1}{#2}}%
+}
+\renewcommand*{\cglsformat}[2]{%
+ \glsifregular{#1}
+ {\glsentryfirst{#1}}%
+ {\ifglshaslong{#1}{\glsentrylong{#1}}{\glsentryfirst{#1}}}#2%
+}
+\renewcommand*{\cGlsformat}[2]{%
+ \glsifregular{#1}
+ {\Glsentryfirst{#1}}%
+ {\ifglshaslong{#1}{\Glsentrylong{#1}}{\Glsentryfirst{#1}}}#2%
+}
+\renewcommand*{\cglsplformat}[2]{%
+ \glsifregular{#1}
+ {\glsentryfirstplural{#1}}%
+ {\ifglshaslong{#1}{\glsentrylongpl{#1}}{\glsentryfirstplural{#1}}}#2%
+}
+\renewcommand*{\cGlsplformat}[2]{%
+ \glsifregular{#1}
+ {\Glsentryfirstplural{#1}}%
+ {\ifglshaslong{#1}{\Glsentrylongpl{#1}}{\Glsentryfirstplural{#1}}}#2%
+}
+\newcommand*{\@@newglossaryentry@defunitcounters}{%
+ \protected@edef\@glo@countunit{\csuse{@glsxtr@categoryattr@@\@glo@category @unitcount}}%
+ \ifdefvoid\@glo@countunit
+ {}%
+ {%
+ \@glsxtr@ifunitcounter{\@glo@countunit}%
+ {}%
+ {\expandafter\@glsxtr@addunitcounter\expandafter{\@glo@countunit}}%
+ }%
+}
+\newcommand*{\@glsxtr@unitcountlist}{}
+\newcommand*{\@glsxtr@addunitcounter}[1]{%
+ \listadd{\@glsxtr@unitcountlist}{#1}%
+ \ifcsundef{glsxtr@theunit@#1}
+ {%
+ \ifcsdef{theH#1}%
+ {\csdef{glsxtr@theunit@#1}{\csuse{theH#1}}}%
+ {\csdef{glsxtr@theunit@#1}{\csuse{the#1}}}%
+ }%
+ {}%
+}
+\newcommand*{\@glsxtr@ifunitcounter}[3]{%
+ \xifinlist{#1}{\@glsxtr@unitcountlist}{#2}{#3}%
+}
+\newcommand*\@glsxtr@currentunitcount[1]{%
+ glo@\glsdetoklabel{#1}@currunit@\glsgetattribute{#1}{unitcount}.%
+ \csuse{glsxtr@theunit@\glsgetattribute{#1}{unitcount}}%
+}
+\newcommand*\@glsxtr@previousunitcount[1]{%
+ glo@\glsdetoklabel{#1}@prevunit@\glsgetattribute{#1}{unitcount}.%
+ \csuse{glsxtr@theunit@\glsgetattribute{#1}{unitcount}}%
+}
+\newcommand*{\@gls@increment@currunitcount}[1]{%
+ \glshasattribute{#1}{unitcount}%
+ {%
+ \protected@edef\@glsxtr@csname{\@glsxtr@currentunitcount{#1}}%
+ \ifcsundef{\@glsxtr@csname}%
+ {%
+ \csgdef{\@glsxtr@csname}{1}%
+ \listcsxadd
+ {glo@\glsdetoklabel{#1}@unitlist}%
+ {\glsgetattribute{#1}{unitcount}.%
+ \csuse{glsxtr@theunit@\glsgetattribute{#1}{unitcount}}%
+ }%
+ }%
+ {%
+ \csxdef{\@glsxtr@csname}%
+ {\number\numexpr\csname\@glsxtr@csname\endcsname+1}%
+ }%
+ }%
+ {}%
+}
+\newcommand*{\@gls@local@increment@currunitcount}[1]{%
+ \glshasattribute{#1}{unitcount}%
+ {%
+ \protected@edef\@glsxtr@csname{\@glsxtr@currentunitcount{#1}}%
+ \ifcsundef{\@glsxtr@csname}%
+ {%
+ \csdef{\@glsxtr@csname}{1}%
+ \listcseadd
+ {glo@\glsdetoklabel{#1}@unitlist}%
+ {\glsgetattribute{#1}{unitcount}.%
+ \csuse{glsxtr@theunit@\glsgetattribute{#1}{unitcount}}%
+ }%
+ }%
+ {%
+ \csedef{\@glsxtr@csname}%
+ {\number\numexpr\csname\@glsxtr@csname\endcsname+1}%
+ }%
+ }%
+ {}%
+}
+\newcommand*{\@glsxtr@currunitcount}[2]{%
+ \ifcsundef
+ {glo@\glsdetoklabel{#1}@currunit@#2}%
+ {0}%
+ {\csuse{glo@\glsdetoklabel{#1}@currunit@#2}}%
+}%
+\newcommand*{\@glsxtr@prevunitcount}[2]{%
+ \ifcsundef
+ {glo@\glsdetoklabel{#1}@prevunit@#2}%
+ {0}%
+ {\csuse{glo@\glsdetoklabel{#1}@prevunit@#2}}%
+}%
+\newcommand*{\glsenableentryunitcount}{%
+ \appto\@newglossaryentry@defcounters{\@@newglossaryentry@defunitcounters}%
+ \renewcommand*{\gls@defdocnewglossaryentry}{%
+ \renewcommand*\newglossaryentry[2]{%
+ \PackageError{glossaries}{\string\newglossaryentry\space
+ may only be used in the preamble when entry counting has
+ been activated}{If you use \string\glsenableentryunitcount\space
+ you must place all entry definitions in the preamble not in
+ the document environment}%
+ }%
+ }%
+ \newcommand*{\glsentrycurrcount}[1]{%
+ \@glsxtr@currunitcount{##1}{\glsgetattribute{##1}{unitcount}.%
+ \csuse{glsxtr@theunit@\glsgetattribute{##1}{unitcount}}}%
+ }%
+ \newcommand*{\glsentryprevcount}[1]{%
+ \@glsxtr@prevunitcount{##1}{\glsgetattribute{##1}{unitcount}.%
+ \csuse{glsxtr@theunit@\glsgetattribute{##1}{unitcount}}}%
+ }%
+ \newcommand*{\glsentryprevtotalcount}[1]{%
+ \ifcsundef{glo@\glsdetoklabel{##1}@prevunittotal}%
+ {0}%
+ {%
+ \number\csuse{glo@\glsdetoklabel{##1}@prevunittotal}
+ }%
+ }%
+ \newcommand*{\glsentryprevmaxcount}[1]{%
+ \ifcsundef{glo@\glsdetoklabel{##1}@prevunitmax}%
+ {0}%
+ {%
+ \number\csuse{glo@\glsdetoklabel{##1}@prevunitmax}
+ }%
+ }%
+ \let\@glsxtr@entryunitcount@org@unset\glsxtrpostunset
+ \renewcommand*{\glsxtrpostunset}[1]{%
+ \@glsxtr@entryunitcount@org@unset{##1}%
+ \@gls@increment@currunitcount{##1}%
+ }%
+ \let\@glsxtr@entryunitcount@org@localunset\glsxtrpostlocalunset
+ \renewcommand*{\glsxtrpostlocalunset}[1]{%
+ \@glsxtr@entryunitcount@org@localunset{##1}%
+ \@gls@local@increment@currunitcount{##1}%
+ }%
+ \let\@glsxtr@entryunitcount@org@reset\glsxtrpostreset
+ \renewcommand*{\glsxtrpostreset}[1]{%
+ \glshasattribute{##1}{unitcount}%
+ {%
+ \protected@edef\@glsxtr@csname{\@glsxtr@currentunitcount{##1}}%
+ \ifcsundef{\@glsxtr@csname}%
+ {}%
+ {\csgdef{\@glsxtr@csname}{0}}%
+ }%
+ {}%
+ }%
+ \let\@glsxtr@entryunitcount@org@localreset\glsxtrpostlocalreset
+ \renewcommand*{\glsxtrpostlocalreset}[1]{%
+ \@glsxtr@entryunitcount@org@localreset{##1}%
+ \glshasattribute{##1}{unitcount}%
+ {%
+ \protected@edef\@glsxtr@csname{\@glsxtr@currentunitcount{##1}}%
+ \ifcsundef{\@glsxtr@csname}%
+ {}%
+ {\csdef{\@glsxtr@csname}{0}}%
+ }%
+ {}%
+ }%
+ \let\@cgls@\@@cgls@
+ \let\@cglspl@\@@cglspl@
+ \let\@cGls@\@@cGls@
+ \let\@cGlspl@\@@cGlspl@
+ \let\@cGLS@\@@cGLS@
+ \let\@cGLSpl@\@@cGLSpl@
+ \AtEndDocument{\@gls@write@entryunitcounts}%
+ \renewcommand*{\@gls@entry@unitcount}[3]{%
+ \csgdef{glo@\glsdetoklabel{##1}@prevunit@##3}{##2}%
+ \ifcsundef{glo@\glsdetoklabel{##1}@prevunittotal}%
+ {\csgdef{glo@\glsdetoklabel{##1}@prevunittotal}{##2}}%
+ {%
+ \csxdef{glo@\glsdetoklabel{##1}@prevunittotal}{
+ \number\numexpr\csuse{glo@\glsdetoklabel{##1}@prevunittotal}+##2}%
+ }%
+ \ifcsundef{glo@\glsdetoklabel{##1}@prevunitmax}%
+ {\csgdef{glo@\glsdetoklabel{##1}@prevunitmax}{##2}}%
+ {%
+ \ifnum\csuse{glo@\glsdetoklabel{##1}@prevunitmax}<##2
+ \csgdef{glo@\glsdetoklabel{##1}@prevunitmax}{##2}%
+ \fi
+ }%
+ }%
+ \let\glsenableentryunitcount\relax
+ \renewcommand*{\glsenableentrycount}{%
+ \PackageError{glossaries-extra}{\string\glsenableentrycount\space
+ can't be used with \string\glsenableentryunitcount}%
+ {Use one or other but not both commands}%
+ }%
+}
+\@onlypreamble\glsenableentryunitcount
+\newcommand*{\@gls@entry@unitcount}[3]{}
+\newcommand*{\@gls@write@entryunitcounts@do}[1]{%
+ \immediate\write\@auxout
+ {\string\@gls@entry@unitcount
+ {\@glsentry}%
+ {\@glsxtr@currunitcount{\@glsentry}{#1}%
+ }%
+ {#1}}%
+}
+\newcommand*{\@gls@write@entryunitcounts}{%
+ \immediate\write\@auxout
+ {\string\providecommand*{\string\@gls@entry@unitcount}[3]{}}%
+ \count@=0\relax
+ \forallglsentries{\@glsentry}{%
+ \glshasattribute{\@glsentry}{unitcount}%
+ {%
+ \ifglsused{\@glsentry}%
+ {%
+ \forlistcsloop
+ {\@gls@write@entryunitcounts@do}%
+ {glo@\glsdetoklabel{\@glsentry}@unitlist}%
+ }%
+ {}%
+ \advance\count@ by \@ne
+ }%
+ {}%
+ }%
+ \ifnum\count@=0
+ \GlossariesExtraWarningNoLine{Entry counting has been enabled
+ \MessageBreak with \string\glsenableentryunitcount\space but the
+ \MessageBreak attribute `unitcount' hasn't
+ \MessageBreak been assigned to any of the defined
+ \MessageBreak entries}%
+ \fi
+}
+\newcommand*{\GlsXtrEnableEntryUnitCounting}[3]{%
+ \glsenableentryunitcount
+ \renewcommand*{\gls}{\cgls}%
+ \renewcommand*{\Gls}{\cGls}%
+ \renewcommand*{\glspl}{\cglspl}%
+ \renewcommand*{\Glspl}{\cGlspl}%
+ \renewcommand*{\GLS}{\cGLS}%
+ \renewcommand*{\GLSpl}{\cGLSpl}%
+ \@glsxtr@setentryunitcountunsetattr{#1}{#2}{#3}%
+ \let\GlsXtrEnableEntryUnitCounting\@glsxtr@setentryunitcountunsetattr
+ \renewcommand*{\GlsXtrEnableEntryCounting}[2]{%
+ \PackageError{glossaries-extra}{\string\GlsXtrEnableEntryCounting\space
+ can't be used with \string\GlsXtrEnableEntryUnitCounting}%
+ {Use one or other but not both commands}}%
+}
+\newcommand*{\@glsxtr@setentryunitcountunsetattr}[3]{%
+ \@for\@glsxtr@cat:=#1\do
+ {%
+ \ifdefempty{\@glsxtr@cat}{}%
+ {%
+ \glssetcategoryattribute{\@glsxtr@cat}{entrycount}{#2}%
+ \glssetcategoryattribute{\@glsxtr@cat}{unitcount}{#3}%
+ }%
+ }%
+}
+\renewcommand*{\SetGenericNewAcronym}{%
+ \ifdefequal\@addtoacronymlists\@glsxtr@org@addtoacronynlists
+ {}%
+ {%
+ \GlossariesWarning{\string\SetGenericNewAcronym\space used
+ without restoring base acronym functions with
+ \string\RestoreAcronyms}%
+ }%
+ \let\@Gls@entryname\@Gls@acrentryname
+ \renewcommand{\newacronym}[4][]{%
+ \ifdefempty{\@glsacronymlists}%
+ {%
+ \def\@glo@type{\acronymtype}%
+ \setkeys{glossentry}{##1}%
+ \DeclareAcronymList{\@glo@type}%
+ }%
+ {}%
+ \glskeylisttok{##1}%
+ \glslabeltok{##2}%
+ \glsshorttok{##3}%
+ \glslongtok{##4}%
+ \newacronymhook
+ \protected@edef\@do@newglossaryentry{%
+ \noexpand\newglossaryentry{\the\glslabeltok}%
+ {%
+ type=\acronymtype,%
+ name={\expandonce{\acronymentry{##2}}},%
+ sort={\acronymsort{\the\glsshorttok}{\the\glslongtok}},%
+ text={\the\glsshorttok},%
+ short={\the\glsshorttok},%
+ shortplural={\the\glsshorttok\noexpand\acrpluralsuffix},%
+ long={\the\glslongtok},%
+ longplural={\the\glslongtok\noexpand\acrpluralsuffix},%
+ category=acronym,
+ \GenericAcronymFields,%
+ \the\glskeylisttok
+ }%
+ }%
+ \@do@newglossaryentry
+ }%
+ \renewcommand*{\acrfullfmt}[3]{%
+ \glslink[##1]{##2}{\genacrfullformat{##2}{##3}}}%
+ \renewcommand*{\Acrfullfmt}[3]{%
+ \glslink[##1]{##2}{\Genacrfullformat{##2}{##3}}}%
+ \renewcommand*{\ACRfullfmt}[3]{%
+ \glslink[##1]{##2}{%
+ \mfirstucMakeUppercase{\genacrfullformat{##2}{##3}}}}%
+ \renewcommand*{\acrfullplfmt}[3]{%
+ \glslink[##1]{##2}{\genplacrfullformat{##2}{##3}}}%
+ \renewcommand*{\Acrfullplfmt}[3]{%
+ \glslink[##1]{##2}{\Genplacrfullformat{##2}{##3}}}%
+ \renewcommand*{\ACRfullplfmt}[3]{%
+ \glslink[##1]{##2}{%
+ \mfirstucMakeUppercase{\genplacrfullformat{##2}{##3}}}}%
+ \renewcommand*{\glsentryfull}[1]{\genacrfullformat{##1}{}}%
+ \renewcommand*{\Glsentryfull}[1]{\Genacrfullformat{##1}{}}%
+ \renewcommand*{\glsentryfullpl}[1]{\genplacrfullformat{##1}{}}%
+ \renewcommand*{\Glsentryfullpl}[1]{\Genplacrfullformat{##1}{}}%
+}
+\let\@glsxtr@org@setacronymstyle\setacronymstyle
+\let\@glsxtr@org@newacronymstyle\newacronymstyle
+\let\@glsxtr@acronymlists\@glsacronymlists
+\let\@glsxtr@org@addtoacronynlists\@addtoacronymlists
+\let\@glsxtr@org@setacronymlists\SetAcronymLists
+\newcommand{\@glsxtr@abbrlists}{}
+\newcommand*{\forallabbreviationlists}[2]{%
+ \@for#1:=\@glsxtr@abbrlists\do{\ifdefempty{#1}{}{#2}}%
+}
+\newcommand*{\@glsxtr@addabbreviationlist}[1]{%
+ \protected@edef\@glo@type{#1}%
+ \ifdefempty\@glsxtr@abbrlists
+ {\let\@glsxtr@abbrlists\@glo@type}%
+ {%
+ \ifdefequal\@glsxtr@abbrlists\@glo@type
+ {}%
+ {%
+ \expandafter\DTLifinlist\expandafter{\@glo@type}{\@glsxtr@abbrlists}{}%
+ {\protected@eappto\@glsxtr@abbrlists{,\@glo@type}}%
+ }%
+ }%
+}
+\renewcommand*{\forallacronyms}[2]{%
+ \@glsxtr@base@acrcmd\forallacronyms\forallabbreviationlists
+ \@for#1:=\@glsacronymlists\do{\ifx#1\@empty\else#2\fi}%
+}
+\newcommand*{\MakeAcronymsAbbreviations}{%
+ \@for\@gls@type:=\@glsacronymlists\do{%
+ \csgdef{gls@\@gls@type @entryfmt}{\glsentryfmt}%
+ }%
+ \let\@glsxtr@acronymlists\@glsacronymlists
+ \let\@glsacronymlists\@empty
+ \let\@addtoacronymlists\@gobble
+ \let\SetAcronymLists\@gobble
+ \let\@glsxtr@base@acrcmd\@@glsxtr@base@acrcmd@warn
+ \renewcommand*{\newacronym}[4][]{%
+ \glsxtr@newabbreviation{type=\acronymtype,category=acronym,##1}{##2}{##3}{##4}%
+ }%
+ \renewcommand*{\firstacronymfont}[1]{\glsfirstabbrvfont{##1}}%
+ \renewcommand*{\acronymfont}[1]{\glsabbrvfont{##1}}%
+ \renewcommand*{\setacronymstyle}[1]{%
+ \PackageError{glossaries-extra}{\string\setacronymstyle{##1}
+ unavailable.
+ Use \string\setabbreviationstyle[acronym]\space instead.
+ The original acronym interface can be restored with
+ \string\RestoreAcronyms}{}%
+ }%
+ \renewcommand*{\newacronymstyle}[1]{%
+ \GlossariesExtraWarning{New acronym style `##1' won't be
+ available unless you restore the original acronym interface with
+ \string\RestoreAcronyms}%
+ \@glsxtr@org@newacronymstyle{##1}%
+ }%
+}
+\MakeAcronymsAbbreviations
+\newcommand*{\RestoreAcronyms}{%
+ \let\@glsacronymlists\@glsxtr@acronymlists
+ \let\@addtoacronymlists\@glsxtr@org@addtoacronynlists
+ \let\SetAcronymLists\@glsxtr@org@setacronymlists
+ \let\@glsxtr@base@acrcmd\@gobbletwo
+ \@for\@gls@type:=\@glsacronymlists\do{%
+ \SetDefaultAcronymDisplayStyle{\@gls@type}%
+ }%
+ \SetGenericNewAcronym
+ \renewcommand{\firstacronymfont}[1]{\acronymfont{##1}}%
+ \renewcommand{\acronymfont}[1]{##1}%
+ \let\setacronymstyle\@glsxtr@org@setacronymstyle
+ \let\newacronymstyle\@glsxtr@org@newacronymstyle
+ \renewcommand*\@gls@link@checkfirsthyper{%
+ \ifglsused{\glslabel}%
+ {\let\glsxtrifwasfirstuse\@secondoftwo}
+ {\let\glsxtrifwasfirstuse\@firstoftwo}%
+ \@glsxtr@org@checkfirsthyper
+ }
+ \glssetcategoryattribute{acronym}{regular}{false}%
+ \setacronymstyle{long-short}%
+}
+\renewcommand*{\glsacspace}[1]{%
+ \settowidth{\dimen@}{(\firstacronymfont{\glsentryshort{#1}})}%
+ \ifdim\dimen@<\glsacspacemax~\else\space\fi
+}
+\newcommand*{\glsacspacemax}{3em}
+\newcommand*{\@glsxtr@reg@glosslist}{}
+\let\@glsxtr@org@makeglossaries\makeglossaries
+\providecommand\@makeglossaries@warn@noprintglossary{%
+ \ifdefstring{\@glo@types}{,}%
+ {%
+ \GlossariesWarningNoLine{No glossaries have been defined}%
+ }%
+ {%
+ \GlossariesWarningNoLine{No \string\printglossary\space
+ or \string\printglossaries\space
+ found. ^^J(Remove \string\makeglossaries\space if you
+ don't want any glossaries.) ^^JThis document will not
+ have a glossary}%
+ }%
+}%
+\providecommand{\@domakeglossaries}[1]{#1}
+\renewcommand*{\makeglossaries}[1][]{%
+ \@domakeglossaries
+ {%
+ \@glsxtr@if@record@only
+ {%
+ \PackageError{glossaries-extra}{\string\makeglossaries\space
+ not permitted\MessageBreak with record=\@glsxtr@record@setting\space
+ package option}%
+ {You may only use \string\makeglossaries\space with
+ record=off or record=hybrid options}%
+ }%
+ {%
+ \ifblank{#1}%
+ {%
+ \@glsxtr@org@makeglossaries
+ \ifx\@glsxtr@record@setting\@glsxtr@record@setting@alsoindex
+ \let\warn@noprintglossary\@glsxtr@warn@hybrid@noprintgloss
+ \fi
+ }%
+ {%
+ \ifx\@glsxtr@record@setting\@glsxtr@record@setting@alsoindex
+ \PackageError{glossaries-extra}{\string\makeglossaries[#1]\space
+ not permitted\MessageBreak with record=\@glsxtr@record@setting\space package option}%
+ {You may only use the hybrid \string\makeglossaries[...]\space with
+ record=off option}%
+ \else
+ \ifdef\@gls@@automake@immediate{\@gls@@automake@immediate}{}%
+ \protected@edef\@glsxtr@reg@glosslist{#1}%
+ \ifundef{\glswrite}{\newwrite\glswrite}{}%
+ \protected@write\@auxout{}{\string\providecommand
+ \string\@glsorder[1]{}}
+ \protected@write\@auxout{}{\string\providecommand
+ \string\@istfilename[1]{}}
+ \protected@write\@auxout{}{\string\@istfilename{\istfilename}}%
+ \protected@write\@auxout{}{\string\@glsorder{\glsorder}}
+ \protected@write\@auxout{}{\string\glsxtr@makeglossaries{#1}}
+ \write\@auxout{\string\providecommand\string\@gls@reference[3]{}}%
+ \@for\@glo@type:=#1\do{%
+ \ifdefempty{\@glo@type}{}{\@makeglossary{\@glo@type}}%
+ }%
+ \renewcommand*\newglossary[4][]{%
+ \PackageError{glossaries}{New glossaries
+ must be created before \string\makeglossaries}{You need
+ to move \string\makeglossaries\space after all your
+ \string\newglossary\space commands}}%
+ \let\@makeglossary\@gobble
+ \renewcommand\makeglossaries[1][]{}%
+ \@disable@onlypremakeg
+ \let\gls@checkseeallowed\relax
+ \renewcommand*{\@do@seeglossary}[2]{%
+ \glsdoifexists{##1}%
+ {%
+ \protected@edef\@gls@label{\glsdetoklabel{##1}}%
+ \protected@edef\@gls@type{\csname glo@\@gls@label @type\endcsname}%
+ \expandafter\DTLifinlist\expandafter{\@gls@type}{\@glsxtr@reg@glosslist}%
+ {\@glsxtr@org@doseeglossary{##1}{##2}}%
+ {%
+ \@@glsxtrwrglossmark
+ \protected@write\@auxout{}{%
+ \string\@gls@reference
+ {\gls@type}{\@gls@label}{\string\glsseeformat##2{}}%
+ }%
+ }%
+ }%
+ }%
+ \let\@glsxtr@@do@@wrglossary\@@do@@wrglossary
+ \def\@@do@@wrglossary{%
+ \protected@edef\@gls@type{\csname glo@\@gls@label @type\endcsname}%
+ \expandafter\DTLifinlist\expandafter{\@gls@type}{\@glsxtr@reg@glosslist}%
+ {\@glsxtr@@do@@wrglossary}%
+ {\gls@noidxglossary}%
+ }%
+ \let\warn@nomakeglossaries\relax
+ \let\warn@noprintglossary\@makeglossaries@warn@noprintglossary
+ \renewcommand{\@gls@noref@warn}[1]{%
+ \protected@edef\@gls@type{##1}%
+ \expandafter\DTLifinlist\expandafter{\@gls@type}{\@glsxtr@reg@glosslist}%
+ {%
+ \GlossariesExtraWarning{Can't use
+ \string\printnoidxglossary[type={\@gls@type}]
+ when `\@gls@type' is listed in the optional argument of
+ \string\makeglossaries}%
+ }%
+ {%
+ \GlossariesWarning{Empty glossary for
+ \string\printnoidxglossary[type={##1}].
+ Rerun may be required (or you may have forgotten to use
+ commands like \string\gls)}%
+ }%
+ }%
+ \renewcommand*{\glsdisplaynumberlist}[1]{%
+ \expandafter\DTLifinlist\expandafter{##1}{\@glsxtr@reg@glosslist}%
+ {\@glsxtr@idx@displaynumberlist{##1}}%
+ {\@glsxtr@noidx@displaynumberlist{##1}}%
+ }%
+ \renewcommand*{\glsentrynumberlist}[1]{%
+ \expandafter\DTLifinlist\expandafter{##1}{\@glsxtr@reg@glosslist}%
+ {\@glsxtr@idx@entrynumberlist{##1}}%
+ {\@glsxtr@noidx@entrynumberlist{##1}}%
+ }%
+ \renewcommand*{\glsnumberlistloop}[2]{%
+ \expandafter\DTLifinlist\expandafter{##1}{\@glsxtr@reg@glosslist}%
+ {%
+ \PackageError{glossaries-extra}{\string\glsnumberlistloop\space
+ not available for glossary `##1'}{}%
+ }%
+ {\@glsxtr@noidx@numberlistloop{##1}{##2}}%
+ }%
+ \renewcommand*{\glsprestandardsort}[3]{%
+ \expandafter\DTLifinlist\expandafter{##2}{\@glsxtr@reg@glosslist}%
+ {%
+ \glsdosanitizesort
+ }%
+ {%
+ \ifglssanitizesort
+ \@gls@noidx@sanitizesort
+ \else
+ \@gls@noidx@nosanitizesort
+ \fi
+ }%
+ }%
+ \renewcommand*\new@glossaryentry[2]{%
+ \PackageError{glossaries-extra}{Glossary entries must be defined
+ in the preamble\MessageBreak when you use the optional argument
+ of \string\makeglossaries}{Either move your definitions to the
+ preamble or don't use the optional argument of
+ \string\makeglossaries}%
+ }%
+ \let\@glo@assign@sortkey\@glsxtr@mixed@assign@sortkey
+ \renewcommand*{\@printgloss@setsort}{%
+ \expandafter\@glsxtr@gettype\expandafter,\@glsxtr@printglossopts,%
+ type=\glsdefaulttype,\@end@glsxtr@gettype
+ \def\@glo@sorttype{\@glo@default@sorttype}%
+ }%
+ \ifglsautomake
+ \renewcommand*{\@gls@doautomake}{%
+ \@for\@gls@type:=\@glsxtr@reg@glosslist\do{%
+ \ifdefempty{\@gls@type}{}{\@gls@automake{\@gls@type}}%
+ }%
+ }%
+ \fi
+ \ifdef\@glo@check@sortallowed{\@glo@check@sortallowed\makeglossaries}{}%
+ \fi
+ }%
+ }%
+ }%
+}
+\ifdef\@printgloss@checkexists
+{\newcommand{\glsxtr@printgloss@checkexists}{\@printgloss@checkexists}}
+{\newcommand{\glsxtr@printgloss@checkexists}[2]{#2}}
+\newcommand{\@glsxtr@orgprintglossary}[2]{%
+ \def\@glo@type{\glsdefaulttype}%
+ \def\glossarytitle{%
+ \ifcsdef{@glotype@\@glo@type @title}%
+ {\csuse{@glotype@\@glo@type @title}}%
+ {\glossaryname}}%
+ \def\glossarytoctitle{\glossarytitle}%
+ \let\org@glossarytitle\glossarytitle
+ \def\@glossarystyle{%
+ \ifx\@glossary@default@style\relax
+ \GlossariesWarning{No default glossary style provided \MessageBreak
+ for the glossary `\@glo@type'. \MessageBreak
+ Using deprecated fallback. \MessageBreak
+ To fix this set the style with \MessageBreak
+ \string\setglossarystyle\space or use the \MessageBreak
+ style key=value option}%
+ \fi
+ }%
+ \def\gls@dotoctitle{\glssettoctitle{\@glo@type}}%
+ \let\@org@glossaryentrynumbers\glossaryentrynumbers
+ \bgroup
+ \@printgloss@setsort
+ \setkeys{printgloss}{#1}%
+ \ifx\glossarytitle\org@glossarytitle
+ \else
+ \cslet{@glotype@\@glo@type @title}{\glossarytitle}%
+ \fi
+ \let\currentglossary\@glo@type
+ \let\org@glossaryentrynumbers\glossaryentrynumbers
+ \let\glsnonextpages\@glsnonextpages
+ \let\glsnextpages\@glsnextpages
+ \glsxtractivatenopost
+ \gls@dotoctitle
+ \@glossarystyle
+ \let\gls@org@glossaryentryfield\glossentry
+ \let\gls@org@glossarysubentryfield\subglossentry
+ \renewcommand{\glossentry}[1]{%
+ \protected@xdef\glscurrententrylabel{\glsdetoklabel{##1}}%
+ \gls@org@glossaryentryfield{##1}%
+ }%
+ \renewcommand{\subglossentry}[2]{%
+ \protected@xdef\glscurrententrylabel{\glsdetoklabel{##2}}%
+ \gls@org@glossarysubentryfield{##1}{##2}%
+ }%
+ \@gls@preglossaryhook
+ \glsxtr@printgloss@checkexists{\@glo@type}{#2}%
+ \egroup
+ \global\let\glossaryentrynumbers\@org@glossaryentrynumbers
+ \global\let\warn@noprintglossary\relax
+}
+\newcommand*{\glsxtractivatenopost}{%
+ \let\nopostdesc\@nopostdesc
+ \let\glsxtrnopostpunc\@glsxtr@nopostpunc
+}
+\newrobustcmd*{\glsxtrnopostpunc}{}
+\newcommand{\@glsxtr@nopostpunc}{%
+ \let\@@glsxtr@org@postdescription\glspostdescription
+ \ifglsnopostdot
+ \renewcommand{\glspostdescription}{%
+ \glsnopostdottrue
+ \let\glspostdescription\@@glsxtr@org@postdescription
+ \let\glsxtrrestorepostpunc\@glsxtr@restore@postpunc
+ \glsxtrpostdescription
+ \@glsxtr@nopostpunc@postdesc}%
+ \else
+ \renewcommand{\glspostdescription}{%
+ \let\glspostdescription\@@glsxtr@org@postdescription
+ \let\glsxtrrestorepostpunc\@glsxtr@restore@postpunc
+ \glsxtrpostdescription
+ \@glsxtr@nopostpunc@postdesc}%
+ \fi
+ \glsnopostdotfalse
+}
+\newcommand*{\@glsxtr@nopostpunc@postdesc}{}
+\newcommand*{\@glsxtr@restore@postpunc}{%
+ \def\@glsxtr@nopostpunc@postdesc{%
+ \@glsxtr@org@postdescription
+ \let\@glsxtr@nopostpunc@postdesc\@empty
+ \let\glsxtrrestorepostpunc\@empty
+ }%
+}
+\newcommand*{\glsxtrrestorepostpunc}{}
+\renewcommand{\@printglossary}[2]{%
+ \def\@glsxtr@printglossopts{#1}%
+ \@glsxtr@orgprintglossary{#1}{#2}%
+}
+\define@choicekey{printgloss}{target}
+[\@glsxtr@printglossval\@glsxtr@printglossnr]%
+{true,false}[true]%
+{%
+ \ifcase\@glsxtr@printglossnr
+ \def\@glstarget{\glsdohypertarget}%
+ \else
+ \let\@glstarget\@secondoftwo
+ \fi
+}
+\newcommand{\@glsxtrhypernameprefix}{}
+\define@key{printgloss}{targetnameprefix}{%
+ \renewcommand{\@glsxtrhypernameprefix}{#1}%
+}
+\define@key{printgloss}{prefix}{%
+ \renewcommand{\glolinkprefix}{#1}%
+}
+\define@key{printgloss}{label}{%
+ \glsxtrsetglossarylabel{#1}%
+}
+\newcommand{\glsxtrsetglossarylabel}[1]{%
+ \renewcommand*{\@@glossaryseclabel}{%
+ \protected@edef\@currentlabelname{\glossarytoctitle}%
+ \label{#1}%
+ }%
+}
+\newcount\@glsxtr@leveloffset
+\define@key{printgloss}{leveloffset}{%
+ \@glsxtr@assign@leveloffset#1\relax
+}
+\newcommand*{\@glsxtr@assign@leveloffset}{%
+ \@ifnextchar+{\p@glsxtr@assign@leveloffset}{\np@glsxtr@assign@leveloffset}%
+}
+\newcommand*{\p@glsxtr@assign@leveloffset}[1]{%
+ \@ifnextchar+{\pp@glsxtr@assign@leveloffset}{\np@glsxtr@assign@leveloffset}%
+}
+\def\np@glsxtr@assign@leveloffset#1\relax{\@glsxtr@leveloffset=#1\relax}
+\def\pp@glsxtr@assign@leveloffset#1\relax{\advance\@glsxtr@leveloffset by #1\relax}
+\define@boolkey{printgloss}[glsxtr@printgloss@]{groups}[true]{}
+\glsxtr@printgloss@groupstrue
+\let\@glsxtr@org@glsdohypertarget\glsdohypertarget
+\renewcommand{\glsdohypertarget}[2]{%
+ \@glsxtr@org@glsdohypertarget{\@glsxtrhypernameprefix#1}{#2}%
+}
+\ifx\@glstarget\@glsxtr@org@glsdohypertarget
+ \def\@glstarget{\glsdohypertarget}%
+\fi
+\newcommand{\@glsxtr@do@org@target}[2]{%
+ {%
+ \let\glsdohypertarget\@glsxtr@org@glsdohypertarget
+ \@glstarget{#1}{#2}%
+ }%
+}
+\newcommand*{\glsxtr@makeglossaries}[1]{}
+\def\@glsxtr@gettype#1,type=#2,#3\@end@glsxtr@gettype{%
+ \def\@glo@type{#2}%
+}
+\newcommand\@glsxtr@mixed@assign@sortkey[1]{%
+ \protected@edef\@glo@type{\@glo@type}%
+ \expandafter\DTLifinlist\expandafter{\@glo@type}{\@glsxtr@reg@glosslist}%
+ {%
+ \@glo@no@assign@sortkey{#1}%
+ }%
+ {%
+ \@@glo@assign@sortkey{#1}%
+ }%
+}%
+\let\@glsxtr@idx@displaynumberlist\glsdisplaynumberlist
+\newcommand*{\@glsxtr@noidx@displaynumberlist}[1]{%
+ \letcs{\@gls@loclist}{glo@\glsdetoklabel{#1}@loclist}%
+ \ifdef\@gls@loclist
+ {%
+ \def\@gls@noidxloclist@sep{%
+ \def\@gls@noidxloclist@sep{%
+ \def\@gls@noidxloclist@sep{%
+ \glsnumlistsep
+ }%
+ \def\@gls@noidxloclist@finalsep{\glsnumlistlastsep}%
+ }%
+ }%
+ \def\@gls@noidxloclist@finalsep{}%
+ \def\@gls@noidxloclist@prev{}%
+ \forlistloop{\glsnoidxdisplayloclisthandler}{\@gls@loclist}%
+ \@gls@noidxloclist@finalsep
+ \@gls@noidxloclist@prev
+ }%
+ {%
+ \glsxtrundeftag
+ \glsdoifexists{#1}%
+ {%
+ \GlossariesWarning{Missing location list for `#1'. Either
+ a rerun is required or you haven't referenced the entry.}%
+ }%
+ }%
+}%
+
+\newcommand*{\@glsxtr@noidx@numberlistloop}[3]{%
+ \letcs{\@gls@loclist}{glo@\glsdetoklabel{#1}@loclist}%
+ \let\@gls@org@glsnoidxdisplayloc\glsnoidxdisplayloc
+ \let\@gls@org@glsseeformat\glsseeformat
+ \let\glsnoidxdisplayloc#2\relax
+ \let\glsseeformat#3\relax
+ \ifdef\@gls@loclist
+ {%
+ \forlistloop{\glsnoidxnumberlistloophandler}{\@gls@loclist}%
+ }%
+ {%
+ \glsxtrundeftag
+ \glsdoifexists{#1}%
+ {%
+ \GlossariesWarning{Missing location list for `##1'. Either
+ a rerun is required or you haven't referenced the entry.}%
+ }%
+ }%
+ \let\glsnoidxdisplayloc\@gls@org@glsnoidxdisplayloc
+ \let\glsseeformat\@gls@org@glsseeformat
+}%
+\newcommand*{\@glsxtr@noidx@entrynumberlist}[1]{%
+ \letcs{\@gls@loclist}{glo@\glsdetoklabel{#1}@loclist}%
+ \ifdef\@gls@loclist
+ {%
+ \glsnoidxloclist{\@gls@loclist}%
+ }%
+ {%
+ \glsxtrundeftag
+ \glsdoifexists{#1}%
+ {%
+ \GlossariesWarning{Missing location list for `#1'. Either
+ a rerun is required or you haven't referenced the entry.}%
+ }%
+ }%
+}%
+\newcommand*{\@glsxtr@idx@entrynumberlist}[1]{\glsentrynumberlist{#1}}
+\renewcommand*{\@gls@noidx@getgrouptitle}[2]{%
+ \protected@edef\@glsxtr@titlelabel{#1}%
+ \ifdefvoid\@glsxtr@titlelabel
+ {}%
+ {%
+ \protected@edef\@glsxtr@titlelabel{\csuse{glsxtr@grouptitle@#1}}%
+ }%
+ \ifdefvoid{\@glsxtr@titlelabel}%
+ {%
+ \DTLifint{#1}%
+ {%
+ \ifnum#1<256\relax
+ \edef#2{\char#1\relax}%
+ \else
+ \edef#2{#1}%
+ \fi
+ }%
+ {%
+ \ifcsundef{#1groupname}%
+ {\def#2{#1}}%
+ {\letcs#2{#1groupname}}%
+ }%
+ }%
+ {%
+ \let#2\@glsxtr@titlelabel
+ }%
+}
+\let\glsxtr@org@getgrouptitle\@gls@getgrouptitle
+\newrobustcmd{\glsxtrgetgrouptitle}[2]{%
+ \protected@edef\@glsxtr@titlelabel{glsxtr@grouptitle@#1}%
+ \@onelevel@sanitize\@glsxtr@titlelabel
+ \ifcsdef{\@glsxtr@titlelabel}
+ {\letcs{#2}{\@glsxtr@titlelabel}}%
+ {\glsxtr@org@getgrouptitle{#1}{#2}}%
+}
+\let\@gls@getgrouptitle\glsxtrgetgrouptitle
+\newcommand{\glsxtrsetgrouptitle}[2]{%
+ \protected@edef\@glsxtr@titlelabel{glsxtr@grouptitle@#1}%
+ \@onelevel@sanitize\@glsxtr@titlelabel
+ \protected@csxdef{\@glsxtr@titlelabel}{#2}%
+}
+\newcommand{\glsxtrlocalsetgrouptitle}[2]{%
+ \protected@edef\@glsxtr@titlelabel{glsxtr@grouptitle@#1}%
+ \@onelevel@sanitize\@glsxtr@titlelabel
+ \protected@csedef{\@glsxtr@titlelabel}{#2}%
+}
+\renewcommand*{\glsnavigation}{%
+ \def\@gls@between{}%
+ \ifcsundef{@gls@hypergrouplist@\@glo@type}%
+ {%
+ \def\@gls@list{}%
+ }%
+ {%
+ \expandafter\let\expandafter\@gls@list
+ \csname @gls@hypergrouplist@\@glo@type\endcsname
+ }%
+ \@for\@gls@tmp:=\@gls@list\do{%
+ \@gls@between
+ \glsxtrgetgrouptitle{\@gls@tmp}{\@gls@grptitle}%
+ \glsnavhyperlink{\@gls@tmp}{\@gls@grptitle}%
+ \let\@gls@between\glshypernavsep
+ }%
+}
+\renewcommand*{\@print@noidx@glossary}{%
+ \ifcsdef{@glsref@\@glo@type}%
+ {%
+ \ifcsdef{@glo@sortmacro@\@glo@sorttype}%
+ {%
+ \csuse{@glo@sortmacro@\@glo@sorttype}{\@glo@type}%
+ }%
+ {%
+ \PackageError{glossaries}{Unknown sort handler `\@glo@sorttype'}{}%
+ }%
+ \glossarysection[\glossarytoctitle]{\glossarytitle}%
+ \glossarypreamble
+ \def\@gls@currentlettergroup{}%
+ \begin{theglossary}%
+ \glossaryheader
+ \glsresetentrylist
+ \forlistcsloop{\@gls@noidx@do}{@glsref@\@glo@type}%
+ \end{theglossary}%
+ \glossarypostamble
+ }%
+ {%
+ \glsxtrifemptyglossary{\@glo@type}%
+ {}%
+ {\glossarysection[\glossarytoctitle]{\glossarytitle}}%
+ \@gls@noref@warn{\@glo@type}%
+ }%
+}
+\renewcommand*{\glsnoidxdisplayloc}[4]{%
+ \setentrycounter[#1]{#2}%
+ \@glsxtr@display@loc#3\empty\end@glsxtr@display@loc{#4}%
+}
+\def\@glsxtr@display@loc#1#2\end@glsxtr@display@loc#3{%
+ \ifx#1(\relax
+ \glsxtrdisplaystartloc{#2}{#3}%
+ \else
+ \ifx#1)\relax
+ \glsxtrdisplayendloc{#2}{#3}%
+ \else
+ \glsxtrdisplaysingleloc{#1#2}{#3}%
+ \fi
+ \fi
+}
+\newcommand*{\glsxtrdisplaysingleloc}[2]{%
+ \csuse{#1}{#2}%
+}
+\newcommand*{\glsxtrdisplaystartloc}[2]{%
+ \protected@edef\glsxtrlocrangefmt{#1}%
+ \ifx\glsxtrlocrangefmt\empty
+ \def\glsxtrlocrangefmt{glsnumberformat}%
+ \fi
+ \expandafter\glsxtrdisplaysingleloc
+ \expandafter{\glsxtrlocrangefmt}{#2}%
+}
+\newcommand*{\glsxtrdisplayendloc}[2]{%
+ \protected@edef\@glsxtr@tmp{#1}%
+ \ifdefempty{\@glsxtr@tmp}{\def\@glsxtr@tmp{glsnumberformat}}{}%
+ \ifx\glsxtrlocrangefmt\@glsxtr@tmp
+ \else
+ \GlossariesExtraWarning{Mismatched end location range
+ (start=\glsxtrlocrangefmt, end=\@glsxtr@tmp)}%
+ \fi
+ \expandafter\glsxtrdisplayendlochook\expandafter{\@glsxtr@tmp}{#2}%
+ \expandafter\glsxtrdisplaysingleloc
+ \expandafter{\glsxtrlocrangefmt}{#2}%
+ \def\glsxtrlocrangefmt{}%
+}
+\newcommand*{\glsxtrdisplayendlochook}[2]{}
+\newcommand*{\glsxtrlocrangefmt}{}
+\renewcommand*{\setentrycounter}[2][]{%
+ \def\glsxtrcounterprefix{#1}%
+ \ifx\glsxtrcounterprefix\@empty
+ \def\@glo@counterprefix{.}%
+ \else
+ \def\@glo@counterprefix{.#1.}%
+ \fi
+ \def\glsentrycounter{#2}%
+}
+\def\@gls@removespaces#1 #2\@nil{%
+ \toks@=\expandafter{\the\toks@#1}%
+ \ifx\\#2\\%
+ \edef\@glo@tmp{\the\toks@}%
+ \ifx\@glo@tmp\empty
+ \else
+ \expandafter\glsxtrlocationhyperlink\expandafter
+ \glsentrycounter\expandafter\@glo@counterprefix\expandafter{\the\toks@}%
+ \fi
+ \else
+ \@gls@ReturnAfterFi{%
+ \@gls@removespaces#2\@nil
+ }%
+ \fi
+}
+\newcommand*{\glsxtrlocationhyperlink}[3]{%
+ \ifdefvoid\glsxtrsupplocationurl
+ {%
+ \GlsXtrInternalLocationHyperlink{#1}{#2}{#3}%
+ }%
+ {%
+ \hyperref{\glsxtrsupplocationurl}{}{#1#2#3}{#3}%
+ }%
+}
+\newcommand*{\glsxtrsupphypernumber}[1]{%
+ {%
+ \glshasattribute{\glscurrententrylabel}{externallocation}%
+ {%
+ \def\glsxtrsupplocationurl{%
+ \glsgetattribute{\glscurrententrylabel}{externallocation}}%
+ }%
+ {%
+ \def\glsxtrsupplocationurl{}%
+ }%
+ \glshypernumber{#1}%
+ }%
+}
+\renewcommand{\@print@glossary}{%
+ \makeatletter
+ \@input@{\jobname.\csname @glotype@\@glo@type @in\endcsname}%
+ \IfFileExists{\jobname.\csname @glotype@\@glo@type @in\endcsname}%
+ {}%
+ {\glsxtrNoGlossaryWarning{\@glo@type}}%
+ \ifglsxindy
+ \ifcsundef{@xdy@\@glo@type @language}%
+ {%
+ \edef\@do@auxoutstuff{%
+ \noexpand\AtEndDocument{%
+ \noexpand\immediate\noexpand\write\@auxout{%
+ \string\providecommand\string\@xdylanguage[2]{}}%
+ \noexpand\immediate\noexpand\write\@auxout{%
+ \string\@xdylanguage{\@glo@type}{\@xdy@main@language}}%
+ }%
+ }%
+ }%
+ {%
+ \edef\@do@auxoutstuff{%
+ \noexpand\AtEndDocument{%
+ \noexpand\immediate\noexpand\write\@auxout{%
+ \string\providecommand\string\@xdylanguage[2]{}}%
+ \noexpand\immediate\noexpand\write\@auxout{%
+ \string\@xdylanguage{\@glo@type}{\csname @xdy@\@glo@type
+ @language\endcsname}}%
+ }%
+ }%
+ }%
+ \@do@auxoutstuff
+ \edef\@do@auxoutstuff{%
+ \noexpand\AtEndDocument{%
+ \noexpand\immediate\noexpand\write\@auxout{%
+ \string\providecommand\string\@gls@codepage[2]{}}%
+ \noexpand\immediate\noexpand\write\@auxout{%
+ \string\@gls@codepage{\@glo@type}{\gls@codepage}}%
+ }%
+ }%
+ \@do@auxoutstuff
+ \fi
+ \renewcommand*{\@warn@nomakeglossaries}{%
+ \GlossariesWarningNoLine{\string\makeglossaries\space
+ hasn't been used,^^Jthe glossaries will not be updated}%
+ }%
+}
+\newcommand{\GlsXtrNoGlsWarningHead}[2]{%
+ This document is incomplete. The external file associated with
+ the glossary `#1' (which should be called \texttt{#2})
+ hasn't been created.%
+}
+\newcommand{\GlsXtrNoGlsWarningEmptyStart}{%
+ This has probably happened because there are no entries defined
+ in this glossary.%
+}
+\newcommand{\GlsXtrNoGlsWarningEmptyMain}{%
+ If you don't want this glossary,
+ add \texttt{nomain} to your package option list when you load
+ \texttt{glossaries-extra.sty}. For example:%
+}
+\newcommand{\GlsXtrNoGlsWarningEmptyNotMain}[1]{%
+ Did you forget to use \texttt{type=#1} when you defined your
+ entries? If you tried to load entries into this glossary with
+ \texttt{\string\loadglsentries} did you remember to use
+ \texttt{[#1]} as the optional argument? If you did, check that
+ the definitions in the file you loaded all had the type set
+ to \texttt{\string\glsdefaulttype}.%
+}
+\newcommand{\GlsXtrNoGlsWarningCheckFile}[1]{%
+ Check the contents of the file \texttt{#1}. If
+ it's empty, that means you haven't indexed any of your entries in this
+ glossary (using commands like \texttt{\string\gls} or
+ \texttt{\string\glsadd}) so this list can't be generated.
+ If the file isn't empty, the document build process hasn't been
+ completed.%
+}
+\newcommand{\GlsXtrNoGlsWarningAutoMake}[1]{%
+ You may need to rerun \LaTeX. If you already have, it may be that
+ \TeX's shell escape doesn't allow you to run
+ \ifglsxindy xindy\else makeindex\fi. Check the
+ transcript file \texttt{\jobname.log}. If the shell escape is
+ disabled, try one of the following:
+
+ \begin{itemize}
+ \item Run the external (Lua) application:
+
+ \texttt{makeglossaries-lite \string"\jobname\string"}
+
+ \item Run the external (Perl) application:
+
+ \texttt{makeglossaries \string"\jobname\string"}
+ \end{itemize}
+
+ Then rerun \LaTeX\ on this document.
+ \GlossariesExtraWarning{Rerun required to build the
+ glossary `#1' or check TeX's shell escape allows
+ you to run \ifglsxindy xindy\else makeindex\fi}%
+}
+\newcommand{\GlsXtrNoGlsWarningMisMatch}{%
+ You need to either replace \texttt{\string\makenoidxglossaries}
+ with \texttt{\string\makeglossaries} or replace
+ \texttt{\string\printglossary} (or \texttt{\string\printglossaries}) with
+ \texttt{\string\printnoidxglossary}
+ (or \texttt{\string\printnoidxglossaries}) and then rebuild
+ this document.%
+}
+\newcommand{\GlsXtrNoGlsWarningBuildInfo}{%
+ Try one of the following:
+ \begin{itemize}
+ \item Add \texttt{automake} to your package option list when you load
+ \texttt{glossaries-extra.sty}. For example:
+
+ \texttt{\string\usepackage[automake]%
+ \glsopenbrace glossaries-extra\glsclosebrace}
+
+ \item Run the external (Lua) application:
+
+ \texttt{makeglossaries-lite.lua \string"\jobname\string"}
+
+ \item Run the external (Perl) application:
+
+ \texttt{makeglossaries \string"\jobname\string"}
+ \end{itemize}
+
+ Then rerun \LaTeX\ on this document.%
+}
+\newcommand{\GlsXtrRecordWarning}[1]{%
+ \texttt{\string\printglossary} doesn't work
+ with the \texttt{record=\@glsxtr@record@setting} package option
+ use\par\texttt{\string\printunsrtglossary[type=#1]}\par
+ instead (or change the package option).%
+}
+\newcommand{\GlsXtrNoGlsWarningTail}{%
+ This message will be removed once the problem has been fixed.%
+}
+\newcommand{\GlsXtrNoGlsWarningNoOut}[1]{%
+ The file \texttt{#1} doesn't exist. This most likely means you haven't used
+ \texttt{\string\makeglossaries} or you have used
+ \texttt{\string\nofiles}. If this is just a draft version of the
+ document, you can suppress this message using the
+ \texttt{nomissingglstext} package option.%
+}
+\newcommand*{\@glsxtr@defaultnoglossarywarning}[1]{%
+ \glossarysection[\glossarytoctitle]{\glossarytitle}
+ \GlsXtrNoGlsWarningHead{#1}{\jobname.\csname @glotype@\@glo@type @in\endcsname}
+ \par
+ \glsxtrifemptyglossary{#1}%
+ {%
+ \GlsXtrNoGlsWarningEmptyStart\space
+ \ifthenelse{\equal{#1}{main}}{\GlsXtrNoGlsWarningEmptyMain\par
+ \medskip
+ \noindent\texttt{\string\usepackage[nomain\ifglsacronym ,acronym\fi]%
+ \glsopenbrace glossaries-extra\glsclosebrace}
+ \medskip
+ }%
+ {\GlsXtrNoGlsWarningEmptyNotMain{#1}}%
+ }%
+ {%
+ \IfFileExists{\jobname.\csname @glotype@\@glo@type @out\endcsname}
+ {%
+ \GlsXtrNoGlsWarningCheckFile
+ {\jobname.\csname @glotype@\@glo@type @out\endcsname}
+
+ \ifglsautomake
+
+ \GlsXtrNoGlsWarningAutoMake{#1}
+
+ \else
+
+ \ifthenelse{\equal{#1}{main}}%
+ {%
+ \GlsXtrNoGlsWarningEmptyMain\par
+ \medskip
+ \noindent\texttt{\string\usepackage[nomain]%
+ \glsopenbrace glossaries-extra\glsclosebrace}
+ \medskip
+ }%
+ {}%
+
+ \ifdefequal\makeglossaries\@no@makeglossaries
+ {%
+ \GlsXtrNoGlsWarningMisMatch
+ }%
+ {%
+ \GlsXtrNoGlsWarningBuildInfo
+ }%
+ \fi
+ }%
+ {%
+ \GlsXtrNoGlsWarningNoOut
+ {\jobname.\csname @glotype@\@glo@type @out\endcsname}%
+ }%
+ }%
+ \par
+ \GlsXtrNoGlsWarningTail
+}
+\newcommand*{\@glsxtr@record@noglossarywarning}[1]{%
+ \GlossariesExtraWarning{\string\printglossary\space doesn't work\MessageBreak
+ with record=\@glsxtr@record@setting\space package option\MessageBreak(use
+ \string\printunsrtglossary[type=#1])\MessageBreak
+ instead (or change the package option)}%
+ \glossarysection[\glossarytoctitle]{\glossarytitle}
+ \GlsXtrRecordWarning{#1}
+ \GlsXtrNoGlsWarningTail
+}
+\newcommand*{\GlsXtrDefaultResourceOptions}{}
+\newcommand*{\glsxtrresourcefile}[2][]{%
+ \disable@keys{glossaries-extra.sty}{record}%
+ \glsxtr@writefields
+ \ifdefempty\GlsXtrDefaultResourceOptions
+ {%
+ \protected@write\@auxout{\glsxtrresourceinit}%
+ {\string\glsxtr@resource{#1}{#2}}%
+ }%
+ {%
+ \protected@write\@auxout{\glsxtrresourceinit}%
+ {\string\glsxtr@resource{\GlsXtrDefaultResourceOptions,#1}{#2}}%
+ }%
+ \let\@glsxtr@org@see@noindex\@gls@see@noindex
+ \let\@gls@see@noindex\relax
+ \IfFileExists{#2.glstex}%
+ {%
+ \edef\@bibgls@restoreat{\noexpand\catcode\noexpand`\noexpand\@=\number\catcode`\@}%
+ \makeatletter
+ \@input{#2.glstex}%
+ \@bibgls@restoreat
+ \@glsxtr@check@bibgls@nameref
+ }%
+ {%
+ \GlossariesExtraWarning{No file `#2.glstex'}%
+ }%
+ \let\@gls@see@noindex\@glsxtr@org@see@noindex
+}
+\@onlypreamble\glsxtrresourcefile
+\newcommand{\@glsxtr@check@bibgls@nameref}{%
+ \ifx\@glsxtr@record@setting\@glsxtr@record@setting@nameref
+ \ifdef\bibglshrefchar
+ {}%
+ {%
+ \GlossariesExtraWarning{record=nameref requires at least
+ version 1.8 of bib2gls}%
+ }%
+ \fi
+ \let\@glsxtr@check@bibgls@nameref\relax
+}
+\newcommand*{\glsxtrresourceinit}{}
+\newcount\glsxtrresourcecount
+\newcommand*{\GlsXtrLoadResources}[1][]{%
+ \ifnum\glsxtrresourcecount=0\relax
+ \glsxtrresourcefile[#1]{\jobname}%
+ \else
+ \glsxtrresourcefile[#1]{\jobname-\the\glsxtrresourcecount}%
+ \fi
+ \advance\glsxtrresourcecount by 1\relax
+}
+\newcommand*{\glsxtr@resource}[2]{}
+\newcommand*{\glsxtr@fields}[1]{}
+\newcommand*{\glsxtr@texencoding}[1]{}
+\newcommand*{\glsxtr@langtag}[1]{}
+\newcommand*{\glsxtr@pluralsuffixes}[4]{}
+\newcommand*{\glsxtr@shortcutsval}[1]{}
+\newcommand*{\glsxtr@linkprefix}[1]{}
+\newcommand*{\glsxtr@writefields}{%
+ \protected@write\@auxout{}%
+ {\string\providecommand*{\string\glsxtr@fields}[1]{}}%
+ \protected@write\@auxout{}%
+ {\string\providecommand*{\string\glsxtr@resource}[2]{}}%
+ \protected@write\@auxout{}%
+ {\string\providecommand*{\string\glsxtr@pluralsuffixes}[4]{}}%
+ \protected@write\@auxout{}%
+ {\string\providecommand*{\string\glsxtr@shortcutsval}[1]{}}%
+ \protected@write\@auxout{}%
+ {\string\providecommand*{\string\glsxtr@linkprefix}[1]{}}%
+ \protected@write\@auxout{}{\string\glsxtr@fields{\@gls@keymap}}%
+ \protected@write\@auxout{}%
+ {\string\providecommand*{\string\glsxtr@record}[5]{}}%
+ \ifx\@glsxtr@record@setting\@glsxtr@record@setting@nameref
+ \protected@write\@auxout{}%
+ {\string\providecommand*{\string\glsxtr@record@nameref}[8]{}}%
+ \fi
+ \ifdef\CurrentTrackedLanguageTag
+ {%
+ \protected@write\@auxout{}{%
+ \string\glsxtr@langtag{\CurrentTrackedLanguageTag}}%
+ }%
+ {}%
+ \protected@write\@auxout{}{\string\glsxtr@pluralsuffixes
+ {\glspluralsuffix}{\abbrvpluralsuffix}{\acrpluralsuffix}%
+ {\glsxtrabbrvpluralsuffix}}%
+ \ifdef\inputencodingname
+ {%
+ \protected@write\@auxout{}{\string\glsxtr@texencoding{\inputencodingname}}%
+ }%
+ {%
+ \@ifpackageloaded{fontspec}%
+ {\protected@write\@auxout{}{\string\glsxtr@texencoding{utf8}}}%
+ {}%
+ }%
+ \protected@write\@auxout{}{\string\glsxtr@shortcutsval{\@glsxtr@shortcutsval}}%
+ \AtBeginDocument
+ {\protected@write\@auxout{}{\string\glsxtr@linkprefix{\glolinkprefix}}}%
+ \let\glsxtr@writefields\relax
+ \ifglsautomake
+ \IfFileExists{\jobname.aux}%
+ {\immediate\write18{bib2gls \jobname}}{}%
+ \ifx\@gls@doautomake\@gls@doautomake@err
+ \let\@gls@doautomake\relax
+ \fi
+ \fi
+ \@glsxtr@if@record@only
+ {\ifdefstring{\glsorder}{letter}%
+ {\GlossariesExtraWarningNoLine{Package option `order=letter' isn't
+ supported with `record=\@glsxtr@record@setting'. Use `break-at=none'
+ resource option instead}}%
+ {}%
+ }%
+ {}%
+}
+\newcommand*{\@gls@doautomake@err}{%
+ \PackageError{glossaries}{You must use
+ \string\makeglossaries\space with automake=true}
+ {%
+ Either remove the automake=true setting or
+ add \string\makeglossaries\space to your document preamble.%
+ }%
+}
+\newcommand*{\glsxtr@record}[5]{}
+\newcommand*{\glsxtr@record@nameref}[8]{}
+\newcommand*{\glsxtr@counterrecord}[3]{%
+ \glsxtrfieldlistgadd{#1}{record.#2}{#3}%
+}
+\newcommand*{\@glsxtr@counterrecordhook}{}
+\newcommand*{\GlsXtrRecordCounter}[1]{%
+ \@@glsxtr@recordcounter{#1}%
+}
+\@onlypreamble\GlsXtrRecordCounter
+\newcommand*{\@glsxtr@docounterrecord}[1]{%
+ \protected@write\@auxout{}{\string\glsxtr@counterrecord
+ {\@gls@label}{#1}{\csuse{the#1}}}%
+}
+\newcommand*{\glsxtrglossentry}[1]{%
+ \glsxtrtitleorpdforheading
+ {\@glsxtrglossentry{#1}}%
+ {\glsentryname{#1}}%
+ {\glsxtrheadname{#1}}%
+}
+\newrobustcmd*{\@glsxtrglossentry}[1]{%
+ \glsxtrtitleorpdforheading
+ {%
+ \glsdoifexists{#1}%
+ {%
+ \begingroup
+ \protected@edef\glscurrententrylabel{\glsdetoklabel{#1}}%
+ \protected@edef\currentglossary{\GlsXtrStandaloneGlossaryType}%
+ \ifglshasparent{#1}%
+ {\GlsXtrStandaloneSubEntryItem{#1}}%
+ {\glsentryitem{#1}}%
+ \GlsXtrStandaloneEntryName{#1}%
+ \endgroup
+ }%
+ }%
+ {\glsentryname{#1}}%
+ {\glsxtrheadname{#1}}%
+}
+\newcommand*{\GlsXtrStandaloneEntryName}[1]{%
+ \glstarget{#1}{\glossentryname{#1}}%
+}
+\newcommand{\GlsXtrStandaloneGlossaryType}{\glsentrytype{\glscurrententrylabel}}
+\newcommand*{\GlsXtrStandaloneSubEntryItem}[1]{%
+ \GlsXtrIfFieldEqNum{level}{#1}{1}{\glssubentryitem{#1}}{}%
+}
+\newcommand*{\glsxtrglossentryother}[3]{%
+ \ifstrempty{#1}%
+ {%
+ \ifcsdef{glsxtrhead#3}%
+ {%
+ \glsxtrtitleorpdforheading
+ {\@glsxtrglossentryother{#2}{#3}{#1}}%
+ {\@gls@entry@field{#2}{#3}}%
+ {\csuse{glsxtrhead#3}{#2}}%
+ }%
+ {%
+ \glsxtrtitleorpdforheading
+ {\@glsxtrglossentryother{#2}{#3}{#1}}%
+ {\@gls@entry@field{#2}{#3}}%
+ {\@gls@entry@field{\NoCaseChange{#2}}{#3}}%
+ }%
+ }%
+ {%
+ \glsxtrtitleorpdforheading
+ {\@glsxtrglossentryother{#2}{#3}{#1}}%
+ {\@gls@entry@field{#2}{#3}}%
+ {#1}%
+ }%
+}
+\newrobustcmd*{\@glsxtrglossentryother}[3]{%
+ \glsxtrtitleorpdforheading
+ {%
+ \glsdoifexists{#1}%
+ {%
+ \begingroup
+ \protected@edef\glscurrententrylabel{\glsdetoklabel{#1}}%
+ \protected@edef\currentglossary{\GlsXtrStandaloneGlossaryType}%
+ \ifglshasparent{#1}%
+ {\GlsXtrStandaloneSubEntryItem{#1}}%
+ {\glsentryitem{#1}}%
+ \GlsXtrStandaloneEntryOther{#1}%
+ \endgroup
+ }%
+ }%
+ {\@gls@entry@field{#1}{#2}}%
+ {#3}%
+}
+\newcommand*{\GlsXtrStandaloneEntryOther}[2]{%
+ \glstarget{#1}{\glossentrynameother{#1}{#2}}%
+}
+\ifdef\@printgloss@checkexists
+{
+ \newcommand*{\printunsrtglossary}{%
+ \let\@printgloss@checkexists\@printgloss@checkexists@allowignored
+ \@ifstar\s@printunsrtglossary\@printunsrtglossary
+ }
+}
+{
+ \newcommand*{\printunsrtglossary}{%
+ \@ifstar\s@printunsrtglossary\@printunsrtglossary
+ }
+}
+\newcommand*{\@printunsrtglossary}[1][]{%
+ \@printglossary{type=\glsdefaulttype,#1}{\@print@unsrt@glossary}%
+}
+\newcommand*{\s@printunsrtglossary}[2][]{%
+ \begingroup
+ #2%
+ \@printglossary{type=\glsdefaulttype,#1}{\@print@unsrt@glossary}%
+ \endgroup
+}
+\newcommand*{\printunsrtglossaries}{%
+ \forallglossaries{\@@glo@type}{\printunsrtglossary[type=\@@glo@type]}%
+}
+
+\newcommand*{\@print@unsrt@glossary}{%
+ \glossarysection[\glossarytoctitle]{\glossarytitle}%
+ \glossarypreamble
+ \glsxtrifemptyglossary{\@glo@type}%
+ {%
+ \GlossariesExtraWarning{No entries defined in glossary `\@glo@type'}%
+ }%
+ {%
+ \key@ifundefined{glossentry}{group}%
+ {\let\@gls@getgrouptitle\@gls@noidx@getgrouptitle}%
+ {\let\@gls@getgrouptitle\@glsxtr@unsrt@getgrouptitle}%
+ \def\@gls@currentlettergroup{}%
+ \def\@glsxtr@doglossary{%
+ \begin{theglossary}%
+ \glossaryheader
+ \glsresetentrylist
+ }%
+ \expandafter\@for\expandafter\glscurrententrylabel\expandafter
+ :\expandafter=\csname glolist@\@glo@type\endcsname\do{%
+ \ifdefempty{\glscurrententrylabel}
+ {}%
+ {%
+ \let\glsxtr@process\@firstofone
+ \let\printunsrtglossaryskipentry
+ \@glsxtr@printunsrtglossaryskipentry
+ \printunsrtglossaryentryprocesshook{\glscurrententrylabel}%
+ \glsxtr@process
+ {%
+ \ifglsxtr@printgloss@groups
+ \ifglshasparent{\glscurrententrylabel}{}%
+ {%
+ \@glsxtr@checkgroup\glscurrententrylabel
+ \expandafter\appto\expandafter\@glsxtr@doglossary\expandafter
+ {\@glsxtr@groupheading}%
+ }%
+ \fi
+ \protected@eappto\@glsxtr@doglossary{%
+ \noexpand\@printunsrt@glossary@handler{\glscurrententrylabel}}%
+ }%
+ }%
+ }%
+ \appto\@glsxtr@doglossary{\end{theglossary}}%
+ \printunsrtglossarypredoglossary
+ \@glsxtr@doglossary
+ }%
+ \glossarypostamble
+}
+\newcommand*{\printunsrtinnerglossary}[3][]{%
+ \begingroup
+ \def\@glsxtr@printglossopts{#1}%
+ \def\@glo@type{\glsdefaulttype}%
+ \setkeys{printgloss}[title,toctitle,style,numberedsection,sort,label]{#1}%
+ \let\currentglossary\@glo@type
+ #2%
+ \@print@unsrt@innerglossary
+ #3%
+ \endgroup
+}
+\newenvironment{printunsrtglossarywrap}[1][]%
+{%
+ \def\@glsxtr@printglossopts{#1}%
+ \def\@glo@type{\glsdefaulttype}%
+ \def\glossarytitle{\csname @glotype@\@glo@type @title\endcsname}%
+ \def\glossarytoctitle{\glossarytitle}%
+ \let\org@glossarytitle\glossarytitle
+ \def\@glossarystyle{%
+ \ifx\@glossary@default@style\relax
+ \GlossariesWarning{No default glossary style provided \MessageBreak
+ for the glossary `\@glo@type'. \MessageBreak
+ Using deprecated fallback. \MessageBreak
+ To fix this set the style with \MessageBreak
+ \string\setglossarystyle\space or use the \MessageBreak
+ style key=value option}%
+ \fi
+ }%
+ \def\gls@dotoctitle{\glssettoctitle{\@glo@type}}%
+ \let\@org@glossaryentrynumbers\glossaryentrynumbers
+ \@printgloss@setsort
+ \setkeys{printgloss}{#1}%
+ \ifglossaryexists*{\@glo@type}%
+ {%
+ \ifx\glossarytitle\org@glossarytitle
+ \else
+ \expandafter\let\csname @glotype@\@glo@type @title\endcsname
+ \glossarytitle
+ \fi
+ \let\currentglossary\@glo@type
+ }%
+ {}%
+ \let\org@glossaryentrynumbers\glossaryentrynumbers
+ \let\glsnonextpages\@glsnonextpages
+ \let\glsnextpages\@glsnextpages
+ \let\nopostdesc\@nopostdesc
+ \gls@dotoctitle
+ \@glossarystyle
+ \let\gls@org@glossaryentryfield\glossentry
+ \let\gls@org@glossarysubentryfield\subglossentry
+ \renewcommand{\glossentry}[1]{%
+ \protected@xdef\glscurrententrylabel{\glsdetoklabel{##1}}%
+ \gls@org@glossaryentryfield{##1}%
+ }%
+ \renewcommand{\subglossentry}[2]{%
+ \protected@xdef\glscurrententrylabel{\glsdetoklabel{##2}}%
+ \gls@org@glossarysubentryfield{##1}{##2}%
+ }%
+ \@gls@preglossaryhook
+ \glossarysection[\glossarytoctitle]{\glossarytitle}%
+ \glossarypreamble
+ \begin{theglossary}%
+ \glossaryheader
+ \glsresetentrylist
+}%
+{%
+ \end{theglossary}%
+ \glossarypostamble
+ \global\let\glossaryentrynumbers\@org@glossaryentrynumbers
+ \global\let\warn@noprintglossary\relax
+}
+\newcommand*{\@print@unsrt@innerglossary}{%
+ \glsxtrifemptyglossary{\@glo@type}%
+ {%
+ \GlossariesExtraWarning{No entries defined in glossary `\@glo@type'}%
+ }%
+ {%
+ \key@ifundefined{glossentry}{group}%
+ {\let\@gls@getgrouptitle\@gls@noidx@getgrouptitle}%
+ {\let\@gls@getgrouptitle\@glsxtr@unsrt@getgrouptitle}%
+ \def\@gls@currentlettergroup{}%
+ \def\@glsxtr@doglossary{}%
+ \expandafter\@for\expandafter\glscurrententrylabel\expandafter
+ :\expandafter=\csname glolist@\@glo@type\endcsname\do{%
+ \ifdefempty{\glscurrententrylabel}
+ {}%
+ {%
+ \let\glsxtr@process\@firstofone
+ \let\printunsrtglossaryskipentry
+ \@glsxtr@printunsrtglossaryskipentry
+ \printunsrtglossaryentryprocesshook{\glscurrententrylabel}%
+ \glsxtr@process
+ {%
+ \ifglsxtr@printgloss@groups
+ \ifglshasparent{\glscurrententrylabel}{}%
+ {%
+ \@glsxtr@checkgroup\glscurrententrylabel
+ \expandafter\appto\expandafter\@glsxtr@doglossary\expandafter
+ {\@glsxtr@groupheading}%
+ }%
+ \fi
+ \protected@eappto\@glsxtr@doglossary{%
+ \noexpand\@printunsrt@glossary@handler{\glscurrententrylabel}}%
+ }%
+ }%
+ }%
+ \printunsrtglossarypredoglossary
+ \@glsxtr@doglossary
+ }%
+}
+\newcommand*{\printunsrtglossaryentryprocesshook}[1]{}
+\newcommand*{\printunsrtglossaryskipentry}{%
+ \PackageError{glossaries-extra}{\string\printunsrtglossaryskipentry\space
+can only be used within \string\printunsrtglossaryentryprocesshook}{}%
+}
+\newcommand*{\@glsxtr@printunsrtglossaryskipentry}{%
+ \let\glsxtr@process\@gobble
+}
+\newcommand*{\printunsrtglossarypredoglossary}{}
+\newcommand{\@printunsrt@glossary@handler}[1]{%
+ \protected@xdef\glscurrententrylabel{#1}%
+ \printunsrtglossaryhandler\glscurrententrylabel
+}
+\newcommand{\printunsrtglossaryhandler}[1]{%
+ \glsxtrunsrtdo{#1}%
+}
+\newrobustcmd*{\glsxtriflabelinlist}[4]{%
+ \protected@edef\@glsxtr@doiflabelinlist{\noexpand\@gls@ifinlist{#1}{#2}}%
+ \@glsxtr@doiflabelinlist{#3}{#4}%
+}
+\newcommand{\print@op@unsrtglossaryunit}[2][]{%
+ \s@printunsrtglossary[type=\glsdefaulttype,#1]{%
+ \printunsrtglossaryunitsetup{#2}%
+ }%
+}
+\newcommand*{\printunsrtglossaryunitsetup}[1]{%
+ \renewcommand{\printunsrtglossaryhandler}[1]{%
+ \glsxtrfieldxifinlist{##1}{record.#1}{\csuse{the#1}}
+ {\glsxtrunsrtdo{##1}}%
+ {}%
+ }%
+ \ifcsundef{theH#1}%
+ {%
+ \renewcommand*{\@glsxtrhypernameprefix}{record.#1.\csuse{the#1}.\@gobble}%
+ }%
+ {%
+ \renewcommand*{\@glsxtrhypernameprefix}{record.#1.\csuse{theH#1}.\@gobble}%
+ }%
+ \renewcommand*{\glossarysection}[2][]{}%
+ \appto\glossarypostamble{\glspar\medskip\glspar}%
+}
+\newcommand{\print@noop@unsrtglossaryunit}[2][]{%
+ \PackageError{glossaries-extra}{\string\printunsrtglossaryunit\space
+ requires the record=only or record=alsoindex package option}{}%
+}
+\newrobustcmd*{\@glsxtr@unsrt@getgrouptitle}[2]{%
+ \protected@edef\@glsxtr@titlelabel{glsxtr@grouptitle@#1}%
+ \@onelevel@sanitize\@glsxtr@titlelabel
+ \ifcsdef{\@glsxtr@titlelabel}
+ {\letcs{#2}{\@glsxtr@titlelabel}}%
+ {\def#2{#1}}%
+}
+\newcommand{\glsxtrunsrtdo}{\@glsxtr@noidx@do}
+\newcommand*{\glsxtrgroupfield}{group}
+\newcommand*{\@glsxtr@checkgroup}[1]{%
+ \def\@glsxtr@groupheading{}%
+ \key@ifundefined{glossentry}{group}%
+ {%
+ \letcs{\@gls@sort}{glo@\glsdetoklabel{#1}@sort}%
+ \expandafter\glo@grabfirst\@gls@sort{}{}\@nil
+ }%
+ {%
+ \protected@edef\@glo@thislettergrp{%
+ \csuse{glo@\glsdetoklabel{#1}@\glsxtrgroupfield}}%
+ }%
+ \ifdefequal{\@glo@thislettergrp}{\@gls@currentlettergroup}%
+ {}%
+ {%
+ \ifdefempty{\@gls@currentlettergroup}{}%
+ {\def\@glsxtr@groupheading{\glsgroupskip}}%
+ \protected@eappto\@glsxtr@groupheading{%
+ \noexpand\glsgroupheading{\expandonce\@glo@thislettergrp}%
+ }%
+ }%
+ \let\@gls@currentlettergroup\@glo@thislettergrp
+}
+\newcommand*{\GlsXtrLocationField}{location}
+\newcommand{\@glsxtr@noidx@do}[1]{%
+ \ifglsentryexists{#1}%
+ {%
+ \global\letcs{\@gls@loclist}{glo@\glsdetoklabel{#1}@loclist}%
+ \global\letcs{\@gls@location}{glo@\glsdetoklabel{#1}@\GlsXtrLocationField}%
+ \gls@level=\numexpr\csuse{glo@\glsdetoklabel{#1}@level}+\@glsxtr@leveloffset\relax
+ \ifnum\gls@level>0
+ \let\@glsxtr@ifischild\@firstoftwo
+ \else
+ \let\@glsxtr@ifischild\@secondoftwo
+ \fi
+ \@glsxtr@ifischild
+ {%
+ \ifdefvoid{\@gls@location}%
+ {%
+ \ifdefvoid{\@gls@loclist}%
+ {%
+ \expandafter\subglossentry\expandafter{\number\gls@level}{#1}{}%
+ }%
+ {%
+ \expandafter\subglossentry\expandafter{\number\gls@level}{#1}%
+ {%
+ \glossaryentrynumbers{\glsnoidxloclist{\@gls@loclist}}%
+ }%
+ }%
+ }%
+ {%
+ \expandafter\subglossentry\expandafter
+ {\number\gls@level}{#1}{\glossaryentrynumbers{\@gls@location}}%
+ }%
+ }%
+ {%
+ \ifdefvoid{\@gls@location}%
+ {%
+ \ifdefvoid{\@gls@loclist}
+ {%
+ \glossentry{#1}{}%
+ }%
+ {%
+ \glossentry{#1}%
+ {%
+ \glossaryentrynumbers{\glsnoidxloclist{\@gls@loclist}}%
+ }%
+ }%
+ }%
+ {%
+ \glossentry{#1}%
+ {%
+ \glossaryentrynumbers{\@gls@location}%
+ }%
+ }%
+ }%
+ }%
+ {}%
+}
+\newcount\@glsxtrnewgls@inner
+\newcommand*{\@glsxtr@providenewgls}{%
+ \protected@write\@auxout{}{\string\providecommand{\string\@glsxtr@newglslike}[2]{}}%
+ \let\@glsxtr@providenewgls\relax
+}
+\newcommand{\glsxtridentifyglslike}[2]{%
+ \ifdefequal\@glsxtr@record@setting\@glsxtr@record@setting@off
+ {}%
+ {%
+ \@glsxtr@providenewgls
+ \protected@write\@auxout{}{\string\@glsxtr@newglslike{#1}{\string#2}}%
+ }%
+}
+\newcommand*{\@glsxtrnewgls}[4]{%
+ \ifdef{#3}%
+ {%
+ \PackageError{glossaries-extra}{Command \string#3\space already
+defined}{}%
+ }%
+ {%
+ \glsxtridentifyglslike{#2}{#3}%
+ \ifcsdef{@#4like@#2}%
+ {%
+ \advance\@glsxtrnewgls@inner by \@ne
+ \def\@glsxtrnewgls@innercsname{@#4like\number\@glsxtrnewgls@inner @#2}%
+ }%
+ {\def\@glsxtrnewgls@innercsname{@#4like@#2}}%
+ \expandafter\newrobustcmd\expandafter*\expandafter
+ #3\expandafter{\expandafter\@gls@hyp@opt\csname\@glsxtrnewgls@innercsname\endcsname}%
+ \ifstrempty{#1}%
+ {%
+ \expandafter\newcommand\expandafter*\csname\@glsxtrnewgls@innercsname\endcsname[2][]{%
+ \new@ifnextchar[%
+ {\csname @#4@\endcsname{##1}{#2##2}}%
+ {\csname @#4@\endcsname{##1}{#2##2}[]}%
+ }%
+ }%
+ {%
+ \expandafter\newcommand\expandafter*\csname\@glsxtrnewgls@innercsname\endcsname[2][]{%
+ \new@ifnextchar[%
+ {\csname @#4@\endcsname{#1,##1}{#2##2}}%
+ {\csname @#4@\endcsname{#1,##1}{#2##2}[]}%
+ }%
+ }%
+ }%
+}
+\newrobustcmd*{\glsxtrnewgls}[3][]{%
+ \@glsxtrnewgls{#1}{#2}{#3}{gls}%
+}
+\newrobustcmd*{\glsxtrnewglslike}[6][]{%
+ \@glsxtrnewgls{#1}{#2}{#3}{gls}%
+ \@glsxtrnewgls{#1}{#2}{#4}{glspl}%
+ \@glsxtrnewgls{#1}{#2}{#5}{Gls}%
+ \@glsxtrnewgls{#1}{#2}{#6}{Glspl}%
+}
+\newrobustcmd*{\glsxtrnewGLSlike}[4][]{%
+ \@glsxtrnewgls{#1}{#2}{#3}{GLS}%
+ \@glsxtrnewgls{#1}{#2}{#4}{GLSpl}%
+}
+\newrobustcmd*{\glsxtrnewrgls}[3][]{%
+ \@glsxtrnewgls{#1}{#2}{#3}{rgls}%
+}
+\newrobustcmd*{\glsxtrnewrglslike}[6][]{%
+ \@glsxtrnewgls{#1}{#2}{#3}{rgls}%
+ \@glsxtrnewgls{#1}{#2}{#4}{rglspl}%
+ \@glsxtrnewgls{#1}{#2}{#5}{rGls}%
+ \@glsxtrnewgls{#1}{#2}{#6}{rGlspl}%
+}
+\newrobustcmd*{\glsxtrnewrGLSlike}[4][]{%
+ \@glsxtrnewgls{#1}{#2}{#3}{rGLS}%
+ \@glsxtrnewgls{#1}{#2}{#4}{rGLSpl}%
+}
+\newcommand*{\GlsXtrTotalRecordCount}[1]{%
+ \ifcsdef{glo@\glsdetoklabel{#1}@recordcount}%
+ {\csname glo@\glsdetoklabel{#1}@recordcount\endcsname}%
+ {0}%
+}
+\newcommand*{\GlsXtrRecordCount}[2]{%
+ \ifcsdef{glo@\glsdetoklabel{#1}@recordcount.#2}%
+ {\csname glo@\glsdetoklabel{#1}@recordcount.#2\endcsname}%
+ {0}%
+}
+\newcommand*{\GlsXtrLocationRecordCount}[3]{%
+ \ifcsdef{glo@\glsdetoklabel{#1}@recordcount.#2.\glsxtrdetoklocation{#3}}%
+ {\csname glo@\glsdetoklabel{#1}@recordcount.#2.\glsxtrdetoklocation{#3}\endcsname}%
+ {0}%
+}
+\newcommand*{\glsxtrdetoklocation}[1]{#1}
+\newcommand*{\glsxtrenablerecordcount}{%
+ \renewcommand*{\gls}{\rgls}%
+ \renewcommand*{\Gls}{\rGls}%
+ \renewcommand*{\glspl}{\rglspl}%
+ \renewcommand*{\Glspl}{\rGlspl}%
+ \renewcommand*{\GLS}{\rGLS}%
+ \renewcommand*{\GLSpl}{\rGLSpl}%
+}
+\newcommand*{\glsxtrrecordtriggervalue}[1]{%
+ \GlsXtrTotalRecordCount{#1}%
+}
+\newcommand*{\GlsXtrSetRecordCountAttribute}[2]{%
+ \@for\@glsxtr@cat:=#1\do
+ {%
+ \ifdefempty{\@glsxtr@cat}{}%
+ {%
+ \glssetcategoryattribute{\@glsxtr@cat}{recordcount}{#2}%
+ }%
+ }%
+}
+\newcommand*{\glsxtrifrecordtrigger}[3]{%
+ \glshasattribute{#1}{recordcount}%
+ {%
+ \ifnum\glsxtrrecordtriggervalue{#1}>\glsgetattribute{#1}{recordcount}\relax
+ #3%
+ \else
+ #2%
+ \fi
+ }%
+ {#3}%
+}
+\newcommand*{\@glsxtr@rglstrigger@record}[3]{%
+ \protected@edef\glslabel{\glsdetoklabel{#2}}%
+ \let\@gls@link@label\glslabel
+ \def\@glsxtr@thevalue{}%
+ \def\@glsxtr@theHvalue{\@glsxtr@thevalue}%
+ \def\@glsnumberformat{glstriggerrecordformat}%
+ \protected@edef\@gls@counter{\csname glo@\glslabel @counter\endcsname}%
+ \protected@edef\glstype{\csname glo@\glslabel @type\endcsname}%
+ \def\@glsxtr@thevalue{}%
+ \def\@glsxtr@theHvalue{\@glsxtr@thevalue}%
+ \@gls@save@glslocal
+ \glsxtrinitwrgloss
+ \glslinkpresetkeys
+ \setkeys{glslink}{#1}%
+ \glslinkpostsetkeys
+ \ifdefempty{\@glsxtr@thevalue}%
+ {%
+ \@gls@saveentrycounter
+ }%
+ {%
+ \let\theglsentrycounter\@glsxtr@thevalue
+ \def\theHglsentrycounter{\@glsxtr@theHvalue}%
+ }%
+ \glslinkwrcontent
+ {%
+ \ifglsxtrinitwrglossbefore
+ \@do@wrglossary{#2}%
+ \fi
+ #3%
+ \ifglsxtrinitwrglossbefore
+ \else
+ \@do@wrglossary{#2}%
+ \fi
+ }%
+ \@gls@restore@glslocal
+ \@gls@do@glsunset{#2}%
+}
+\newcommand*{\glstriggerrecordformat}[1]{}
+\newrobustcmd*{\rgls}{\@gls@hyp@opt\@rgls}
+\newcommand*{\@rgls}[2][]{%
+ \new@ifnextchar[{\@rgls@{#1}{#2}}{\@rgls@{#1}{#2}[]}%
+}
+\def\@rgls@#1#2[#3]{%
+ \glsxtrifrecordtrigger{#2}%
+ {%
+ \@glsxtr@rglstrigger@record{#1}{#2}{\rglsformat{#2}{#3}}%
+ }%
+ {%
+ \@gls@{#1}{#2}[#3]%
+ }%
+}%
+\newrobustcmd*{\rglspl}{\@gls@hyp@opt\@rglspl}
+\newcommand*{\@rglspl}[2][]{%
+ \new@ifnextchar[{\@rglspl@{#1}{#2}}{\@rglspl@{#1}{#2}[]}%
+}
+\def\@rglspl@#1#2[#3]{%
+ \glsxtrifrecordtrigger{#2}%
+ {%
+ \@glsxtr@rglstrigger@record{#1}{#2}{\rglsplformat{#2}{#3}}%
+ }%
+ {%
+ \@glspl@{#1}{#2}[#3]%
+ }%
+}%
+\newrobustcmd*{\rGls}{\@gls@hyp@opt\@rGls}
+\newcommand*{\@rGls}[2][]{%
+ \new@ifnextchar[{\@rGls@{#1}{#2}}{\@rGls@{#1}{#2}[]}%
+}
+\def\@rGls@#1#2[#3]{%
+ \glsxtrifrecordtrigger{#2}%
+ {%
+ \@glsxtr@rglstrigger@record{#1}{#2}{\rGlsformat{#2}{#3}}%
+ }%
+ {%
+ \@Gls@{#1}{#2}[#3]%
+ }%
+}%
+\newrobustcmd*{\rGlspl}{\@gls@hyp@opt\@rGlspl}
+\newcommand*{\@rGlspl}[2][]{%
+ \new@ifnextchar[{\@rGlspl@{#1}{#2}}{\@rGlspl@{#1}{#2}[]}%
+}
+\def\@rGlspl@#1#2[#3]{%
+ \glsxtrifrecordtrigger{#2}%
+ {%
+ \@glsxtr@rglstrigger@record{#1}{#2}{\rGlsplformat{#2}{#3}}%
+ }%
+ {%
+ \@Glspl@{#1}{#2}[#3]%
+ }%
+}%
+\newrobustcmd*{\rGLS}{\@gls@hyp@opt\@rGLS}
+\newcommand*{\@rGLS}[2][]{%
+ \new@ifnextchar[{\@rGLS@{#1}{#2}}{\@rGLS@{#1}{#2}[]}%
+}
+\def\@rGLS@#1#2[#3]{%
+ \glsxtrifrecordtrigger{#2}%
+ {%
+ \@glsxtr@rglstrigger@record{#1}{#2}{\rGLSformat{#2}{#3}}%
+ }%
+ {%
+ \@GLS@{#1}{#2}[#3]%
+ }%
+}%
+\newrobustcmd*{\rGLSpl}{\@gls@hyp@opt\@rGLSpl}
+\newcommand*{\@rGLSpl}[2][]{%
+ \new@ifnextchar[{\@rGLSpl@{#1}{#2}}{\@rGLSpl@{#1}{#2}[]}%
+}
+\def\@rGLSpl@#1#2[#3]{%
+ \glsxtrifrecordtrigger{#2}%
+ {%
+ \@glsxtr@rglstrigger@record{#1}{#2}{\rGLSplformat{#2}{#3}}%
+ }%
+ {%
+ \@GLSpl@{#1}{#2}[#3]%
+ }%
+}%
+\newcommand*{\rglsformat}[2]{%
+ \glsifregular{#1}
+ {\glsentryfirst{#1}}%
+ {\ifglshaslong{#1}{\glsentrylong{#1}}{\glsentryfirst{#1}}}#2%
+}
+\newcommand*{\rglsplformat}[2]{%
+ \glsifregular{#1}
+ {\glsentryfirstplural{#1}}%
+ {\ifglshaslong{#1}{\glsentrylongplural{#1}}{\glsentryfirstplural{#1}}}#2%
+}
+\newcommand*{\rGlsformat}[2]{%
+ \glsifregular{#1}
+ {\Glsentryfirst{#1}}%
+ {\ifglshaslong{#1}{\Glsentrylong{#1}}{\Glsentryfirst{#1}}}#2%
+}
+\newcommand*{\rGlsplformat}[2]{%
+ \glsifregular{#1}
+ {\Glsentryfirstplural{#1}}%
+ {\ifglshaslong{#1}{\Glsentrylongplural{#1}}{\Glsentryfirstplural{#1}}}#2%
+}
+\newcommand*{\rGLSformat}[2]{%
+ \expandafter\mfirstucMakeUppercase\expandafter{\rglsformat{#1}{#2}}%
+}
+\newcommand*{\rGLSplformat}[2]{%
+ \expandafter\mfirstucMakeUppercase\expandafter{\rglsplformat{#1}{#2}}%
+}
+\newcommand{\@glsxtr@do@inc@linkcount}{%
+ \glsifattribute{\glslabel}{linkcount}{true}%
+ {%
+ \ifcsdef{c@glsxtr@linkcount@\glslabel}{}%
+ {%
+ \newcounter{glsxtr@linkcount@\glslabel}%
+ \glshasattribute{\glslabel}{linkcountmaster}%
+ {%
+ \begingroup
+ \edef\@glo@tmp{\endgroup\noexpand\@addtoreset{glsxtr@linkcount@\glslabel}%
+ {\glsgetattribute{\glslabel}{linkcountmaster}}}%
+ \@glo@tmp
+ }%
+ {}%
+ }%
+ \glsxtrinclinkcounter{glsxtr@linkcount@\glslabel}%
+ }%
+ {}%
+}
+\newcommand*{\glsxtrinclinkcounter}[1]{\stepcounter{#1}}
+\newcommand*{\GlsXtrLinkCounterValue}[1]{%
+ \ifcsundef{c@glsxtr@linkcount@#1}{0}{\csname c@glsxtr@linkcount@#1\endcsname}%
+}
+\newcommand*{\GlsXtrTheLinkCounter}[1]{%
+ \ifcsundef{theglsxtr@linkcount@#1}{0}%
+ {\csname theglsxtr@linkcount@#1\endcsname}%
+}
+\newcommand*{\GlsXtrIfLinkCounterDef}[3]{%
+ \ifcsundef{theglsxtr@linkcount@#1}{#3}{#2}%
+}
+\newcommand*{\GlsXtrLinkCounterName}[1]{glsxtr@linkcount@#1}
+\newcommand*{\GlsXtrEnableLinkCounting}[2][]{%
+ \let\glsxtr@inc@linkcount\@glsxtr@do@inc@linkcount
+ \@for\@glsxtr@label:=#2\do
+ {%
+ \glssetcategoryattribute{\@glsxtr@label}{linkcount}{true}%
+ \ifstrempty{#1}{}%
+ {%
+ \ifcsundef{c@#1}%
+ {\@nocounterr{#1}}%
+ {\glssetcategoryattribute{\@glsxtr@label}{linkcountmaster}{#1}}%
+ }%
+ }%
+}
+\@onlypreamble\GlsXtrEnableLinkCounting
+\@ifpackageloaded{glossaries-accsupp}
+{
+ \newcommand*{\glsaccessname}[1]{%
+ \glsnameaccessdisplay
+ {%
+ \glsentryname{#1}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\Glsaccessname}[1]{%
+ \glsnameaccessdisplay
+ {%
+ \Glsentryname{#1}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\GLSaccessname}[1]{%
+ \glsnameaccessdisplay
+ {%
+ \mfirstucMakeUppercase{\glsentryname{#1}}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\glsaccesstext}[1]{%
+ \glstextaccessdisplay
+ {%
+ \glsentrytext{#1}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\Glsaccesstext}[1]{%
+ \glstextaccessdisplay
+ {%
+ \Glsentrytext{#1}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\GLSaccesstext}[1]{%
+ \glstextaccessdisplay
+ {%
+ \mfirstucMakeUppercase{\glsentrytext{#1}}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\glsaccessplural}[1]{%
+ \glspluralaccessdisplay
+ {%
+ \glsentryplural{#1}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\Glsaccessplural}[1]{%
+ \glspluralaccessdisplay
+ {%
+ \Glsentryplural{#1}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\GLSaccessplural}[1]{%
+ \glspluralaccessdisplay
+ {%
+ \mfirstucMakeUppercase{\glsentryplural{#1}}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\glsaccessfirst}[1]{%
+ \glsfirstaccessdisplay
+ {%
+ \glsentryfirst{#1}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\Glsaccessfirst}[1]{%
+ \glsfirstaccessdisplay
+ {%
+ \Glsentryfirst{#1}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\GLSaccessfirst}[1]{%
+ \glsfirstaccessdisplay
+ {%
+ \mfirstucMakeUppercase{\glsentryfirst{#1}}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\glsaccessfirstplural}[1]{%
+ \glsfirstpluralaccessdisplay
+ {%
+ \glsentryfirstplural{#1}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\Glsaccessfirstplural}[1]{%
+ \glsfirstpluralaccessdisplay
+ {%
+ \Glsentryfirstplural{#1}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\GLSaccessfirstplural}[1]{%
+ \glsfirstpluralaccessdisplay
+ {%
+ \mfirstucMakeUppercase{\glsentryfirstplural{#1}}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\glsaccesssymbol}[1]{%
+ \glssymbolaccessdisplay
+ {%
+ \glsentrysymbol{#1}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\Glsaccesssymbol}[1]{%
+ \glssymbolaccessdisplay
+ {%
+ \Glsentrysymbol{#1}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\GLSaccesssymbol}[1]{%
+ \glssymbolaccessdisplay
+ {%
+ \mfirstucMakeUppercase{\glsentrysymbol{#1}}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\glsaccesssymbolplural}[1]{%
+ \glssymbolpluralaccessdisplay
+ {%
+ \glsentrysymbolplural{#1}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\Glsaccesssymbolplural}[1]{%
+ \glssymbolpluralaccessdisplay
+ {%
+ \Glsentrysymbolplural{#1}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\GLSaccesssymbolplural}[1]{%
+ \glssymbolpluralaccessdisplay
+ {%
+ \mfirstucMakeUppercase{\glsentrysymbolplural{#1}}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\glsaccessdesc}[1]{%
+ \glsdescriptionaccessdisplay
+ {%
+ \glsentrydesc{#1}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\Glsaccessdesc}[1]{%
+ \glsdescriptionaccessdisplay
+ {%
+ \Glsentrydesc{#1}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\GLSaccessdesc}[1]{%
+ \glsdescriptionaccessdisplay
+ {%
+ \mfirstucMakeUppercase{\glsentrydesc{#1}}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\glsaccessdescplural}[1]{%
+ \glsdescriptionpluralaccessdisplay
+ {%
+ \glsentrydescplural{#1}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\Glsaccessdescplural}[1]{%
+ \glsdescriptionpluralaccessdisplay
+ {%
+ \Glsentrydescplural{#1}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\GLSaccessdescplural}[1]{%
+ \glsdescriptionpluralaccessdisplay
+ {%
+ \mfirstucMakeUppercase{\glsentrydescplural{#1}}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\glsaccessshort}[1]{%
+ \glsshortaccessdisplay
+ {%
+ \glsentryshort{#1}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\Glsaccessshort}[1]{%
+ \glsshortaccessdisplay
+ {%
+ \Glsentryshort{#1}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\GLSaccessshort}[1]{%
+ \glsshortaccessdisplay
+ {%
+ \mfirstucMakeUppercase{\glsentryshort{#1}}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\glsaccessshortpl}[1]{%
+ \glsshortpluralaccessdisplay
+ {%
+ \glsentryshortpl{#1}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\Glsaccessshortpl}[1]{%
+ \glsshortpluralaccessdisplay
+ {%
+ \Glsentryshortpl{#1}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\GLSaccessshortpl}[1]{%
+ \glsshortpluralaccessdisplay
+ {%
+ \mfirstucMakeUppercase{\glsentryshortpl{#1}}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\glsaccesslong}[1]{%
+ \glslongaccessdisplay{\glsentrylong{#1}}{#1}%
+ }
+
+ \newcommand*{\Glsaccesslong}[1]{%
+ \glslongaccessdisplay{\Glsentrylong{#1}}{#1}%
+ }
+ \newcommand*{\GLSaccesslong}[1]{%
+ \glslongaccessdisplay
+ {%
+ \mfirstucMakeUppercase{\glsentrylong{#1}}%
+ }%
+ {#1}%
+ }
+ \newcommand*{\glsaccesslongpl}[1]{%
+ \glslongpluralaccessdisplay{\glsentrylongpl{#1}}{#1}%
+ }
+
+ \newcommand*{\Glsaccesslongpl}[1]{%
+ \glslongpluralaccessdisplay{\Glsentrylongpl{#1}}{#1}%
+ }
+ \newcommand*{\GLSaccesslongpl}[1]{%
+ \glslongpluralaccessdisplay
+ {%
+ \mfirstucMakeUppercase{\glsentrylongpl{#1}}%
+ }%
+ {#1}%
+ }
+ \define@key{glsxtrabbrv}{access}{%
+ \def\@gls@nameaccess{#1}%
+ }
+ \define@key{glsxtrabbrv}{textaccess}{%
+ \def\@gls@textaccess{#1}%
+ }
+ \define@key{glsxtrabbrv}{pluralaccess}{%
+ \def\@gls@pluralaccess{#1}%
+ }
+ \define@key{glsxtrabbrv}{firstaccess}{%
+ \def\@gls@firstaccess{#1}%
+ }
+ \define@key{glsxtrabbrv}{firstpluralaccess}{%
+ \def\@gls@firstpluralaccess{#1}%
+ }
+ \define@key{glsxtrabbrv}{shortaccess}{%
+ \def\@gls@shortaccess{#1}%
+ }
+ \define@key{glsxtrabbrv}{shortpluralaccess}{%
+ \def\@gls@shortaccesspl{#1}%
+ }
+ \define@key{glsxtrabbrv}{longaccess}{%
+ \def\@gls@longaccess{#1}%
+ }
+ \define@key{glsxtrabbrv}{shortlonglaccess}{%
+ \def\@gls@longaccesspl{#1}%
+ }
+ \newcommand*{\@gls@initaccesskeys}{%
+ \def\@gls@nameaccess{}%
+ \def\@gls@textaccess{}%
+ \def\@gls@pluralaccess{}%
+ \def\@gls@firstaccess{}%
+ \def\@gls@firstpluralaccess{}%
+ \def\@gls@shortaccess{}%
+ \def\@gls@shortaccesspl{}%
+ \def\@gls@longaccess{}%
+ \def\@gls@longaccesspl{}%
+ }
+\newcommand*{\@gls@ifaccessattribute@set}[3]{%
+ \glsifcategoryattribute{\glscategorylabel}{access#1}{true}%
+ {#2}%
+ {%
+ \glsifcategoryattribute{\glscategorylabel}{access#1}{false}%
+ {#3}%
+ {%
+ \glsifcategoryattribute{\glscategorylabel}{#1}{true}%
+ {#2}%
+ {#3}%
+ }%
+ }%
+}
+ \def\glsdefaultshortaccess#1#2{#1 (#2)}
+ \newcommand{\glsxtrassignactualsetup}{%
+ \let\@\empty
+ \let\emph\@firstofone
+ \let\textbf\@firstofone
+ \let\textmd\@firstofone
+ \let\textit\@firstofone
+ \let\textsl\@firstofone
+ \let\textsc\@firstofone
+ \let\textrm\@firstofone
+ \let\textsf\@firstofone
+ \let\texttt\@firstofone
+ }
+ \ifdef\pdfstringdef
+ {
+ \newcommand{\@gls@assign@actual}{%
+ \begingroup
+ \glsxtrassignactualsetup
+ \pdfstringdef\@gls@actualshort{\glsxtrorgshort}%
+ \pdfstringdef\@gls@actuallong{\glsxtrorglong}%
+ \pdfstringdef\@gls@actualshortpl{\@gls@shortpl}%
+ \pdfstringdef\@gls@actuallongpl{\@gls@longpl}%
+ \protected@edef\@gls@tmp{\endgroup
+ \def\noexpand\@gls@actualshort{\expandonce\@gls@actualshort}%
+ \def\noexpand\@gls@actuallong{\expandonce\@gls@actuallong}%
+ \def\noexpand\@gls@actualshortpl{\expandonce\@gls@actualshortpl}%
+ \def\noexpand\@gls@actuallongpl{\expandonce\@gls@actuallongpl}%
+ }%
+ \@gls@tmp
+ }
+ }
+ {
+ \newcommand{\@gls@assign@actual}{%
+ \begingroup
+ \glsxtrassignactualsetup
+ \protected@edef\@gls@tmp{\endgroup
+ \def\noexpand\@gls@actualshort{\glsxtrorgshort}%
+ \def\noexpand\@gls@actuallong{\glsxtrorglong}%
+ \def\noexpand\@gls@actualshortpl{\@gls@shortpl}%
+ \def\noexpand\@gls@actuallongpl{\@gls@longpl}%
+ }%
+ \@gls@tmp
+ }
+ }
+ \newcommand{\@gls@setup@default@access}{%
+ \@gls@assign@actual
+ \ifdefempty\@gls@shortaccess
+ {%
+ \@gls@ifaccessattribute@set{insertdots}%
+ {%
+ \expandafter\@glsxtr@insertdots\expandafter\@gls@actualshort\expandafter
+ {\@gls@actualshort}%
+ }%
+ {}%
+ \ifdefempty\@gls@longaccess
+ {%
+ \protected@edef\@gls@shortaccess{\glsdefaultshortaccess
+ {\expandonce\@gls@actuallong}{\expandonce\@gls@actualshort}}%
+ }%
+ {%
+ \protected@edef\@gls@shortaccess{\glsdefaultshortaccess
+ {\expandonce\@gls@longaccess}{\expandonce\@gls@actualshort}}%
+ }%
+ \eappto\ExtraCustomAbbreviationFields{shortaccess={\@gls@shortaccess},}%
+ \ifdefempty\@gls@shortaccesspl
+ {%
+ \@gls@ifaccessattribute@set{aposplural}%
+ {%
+ \expandafter\def\expandafter\@gls@shortaccesspl\expandafter{%
+ \@gls@actualshort'\glsxtrabbrvpluralsuffix}%
+ }%
+ {%
+ \@gls@ifaccessattribute@set{noshortplural}%
+ {%
+ \let\@gls@shortaccesspl\@gls@shortaccess
+ }%
+ {%
+ \let\@gls@shortaccesspl\@gls@actualshortpl
+ }%
+ }%
+ \ifdefempty\@gls@longaccesspl
+ {%
+ \protected@edef\@gls@shortaccesspl{\glsdefaultshortaccess
+ {\expandonce\@gls@actuallongpl}{\expandonce\@gls@actualshortpl}}%
+ }%
+ {%
+ \protected@edef\@gls@shortaccesspl{\glsdefaultshortaccess
+ {\expandonce\@gls@longaccesspl}{\expandonce\@gls@actualshort}}%
+ }%
+ \eappto\ExtraCustomAbbreviationFields{shortpluralaccess={\@gls@shortaccesspl},}%
+ }%
+ {}%
+ }%
+ {%
+ \ifdefempty\@gls@shortaccesspl
+ {\let\@gls@shortaccesspl\@gls@shortaccess}%
+ {}%
+ }%
+ \ifdefempty\@gls@nameaccess
+ {%
+ \glsifcategoryattribute{\glscategorylabel}{nameshortaccess}{true}%
+ {%
+ \eappto\ExtraCustomAbbreviationFields{access={\@gls@shortaccess},}%
+ }%
+ {}%
+ }%
+ {}%
+ \ifdefempty\@gls@textaccess
+ {%
+ \glsifcategoryattribute{\glscategorylabel}{textshortaccess}{true}%
+ {%
+ \eappto\ExtraCustomAbbreviationFields{textaccess={\@gls@shortaccess},}%
+ }%
+ {}%
+ }%
+ {}%
+ \ifdefempty\@gls@pluralaccess
+ {%
+ \glsifcategoryattribute{\glscategorylabel}{textshortaccess}{true}%
+ {%
+ \eappto\ExtraCustomAbbreviationFields{%
+ pluralaccess={\@gls@shortaccesspl},%
+ }%
+ }%
+ {}%
+ }%
+ {}%
+ \ifdefempty\@gls@firstaccess
+ {%
+ \glsifcategoryattribute{\glscategorylabel}{firstshortaccess}{true}%
+ {%
+ \eappto\ExtraCustomAbbreviationFields{firstaccess={\@gls@shortaccess},}%
+ }%
+ {}%
+ }%
+ {}%
+ \ifdefempty\@gls@firstpluralaccess
+ {%
+ \glsifcategoryattribute{\glscategorylabel}{firstshortaccess}{true}%
+ {%
+ \eappto\ExtraCustomAbbreviationFields{%
+ firstpluralaccess={\@gls@shortaccesspl},%
+ }%
+ }%
+ {}%
+ }%
+ {}%
+ }
+ \newcommand*{\glsxtrprovideaccsuppcmd}[2]{%
+ \ifcsundef{glsxtr#1#2accsupp}%
+ {\csdef{glsxtr#1#2accsupp}{\glsshortaccsupp}}%
+ {}%
+ }
+ \newcommand*{\glsxtrAccSuppAbbrSetNoLongAttrs}[1]{%
+ \glssetcategoryattribute{#1}{nameshortaccess}{true}%
+ \glssetcategoryattribute{#1}{firstshortaccess}{true}%
+ \glssetcategoryattribute{#1}{textshortaccess}{true}%
+ \glsxtrprovideaccsuppcmd{#1}{name}%
+ \glsxtrprovideaccsuppcmd{#1}{first}%
+ \glsxtrprovideaccsuppcmd{#1}{firstpl}%
+ \glsxtrprovideaccsuppcmd{#1}{text}%
+ \glsxtrprovideaccsuppcmd{#1}{plural}%
+ }
+ \newcommand*{\glsxtrAccSuppAbbrSetFirstLongAttrs}[1]{%
+ \glssetcategoryattribute{#1}{nameshortaccess}{true}%
+ \glssetcategoryattribute{#1}{textshortaccess}{true}%
+ \glsxtrprovideaccsuppcmd{#1}{name}%
+ \glsxtrprovideaccsuppcmd{#1}{text}%
+ \glsxtrprovideaccsuppcmd{#1}{plural}%
+ }
+ \newcommand*{\glsxtrAccSuppAbbrSetTextShortAttrs}[1]{%
+ \glssetcategoryattribute{#1}{textshortaccess}{true}%
+ \glsxtrprovideaccsuppcmd{#1}{text}%
+ \glsxtrprovideaccsuppcmd{#1}{plural}%
+ }
+ \newcommand*{\glsxtrAccSuppAbbrSetNameShortAttrs}[1]{%
+ \glssetcategoryattribute{#1}{nameshortaccess}{true}%
+ \glsxtrprovideaccsuppcmd{#1}{name}%
+ }
+ \newcommand*{\glsxtrAccSuppAbbrSetNameLongAttrs}[1]{%
+ \glssetcategoryattribute{#1}{firstshortaccess}{true}%
+ \glssetcategoryattribute{#1}{textshortaccess}{true}%
+ \glsxtrprovideaccsuppcmd{#1}{first}%
+ \glsxtrprovideaccsuppcmd{#1}{firstpl}%
+ \glsxtrprovideaccsuppcmd{#1}{text}%
+ \glsxtrprovideaccsuppcmd{#1}{plural}%
+ }
+}
+{
+ \newcommand*{\glsaccessname}[1]{\glsentryname{#1}}
+ \newcommand*{\Glsaccessname}[1]{\Glsentryname{#1}}
+ \newcommand*{\GLSaccessname}[1]{%
+ \protect\mfirstucMakeUppercase{\glsentryname{#1}}}
+ \newcommand*{\glsaccesstext}[1]{\glsentrytext{#1}}
+ \newcommand*{\Glsaccesstext}[1]{\Glsentrytext{#1}}
+ \newcommand*{\GLSaccesstext}[1]{%
+ \protect\mfirstucMakeUppercase{\glsentrytext{#1}}}
+ \newcommand*{\glsaccessplural}[1]{\glsentryplural{#1}}
+ \newcommand*{\Glsaccessplural}[1]{\Glsentryplural{#1}}
+ \newcommand*{\GLSaccessplural}[1]{%
+ \protect\mfirstucMakeUppercase{\glsentryplural{#1}}}
+ \newcommand*{\glsaccessfirst}[1]{\glsentryfirst{#1}}
+ \newcommand*{\Glsaccessfirst}[1]{\Glsentryfirst{#1}}
+ \newcommand*{\GLSaccessfirst}[1]{%
+ \protect\mfirstucMakeUppercase{\glsentryfirst{#1}}}
+ \newcommand*{\glsaccessfirstplural}[1]{\glsentryfirstplural{#1}}
+ \newcommand*{\Glsaccessfirstplural}[1]{\Glsentryfirstplural{#1}}
+ \newcommand*{\GLSaccessfirstplural}[1]{%
+ \protect\mfirstucMakeUppercase{\glsentryfirstplural{#1}}}
+ \newcommand*{\glsaccesssymbol}[1]{\glsentrysymbol{#1}}
+ \newcommand*{\Glsaccesssymbol}[1]{\Glsentrysymbol{#1}}
+ \newcommand*{\GLSaccesssymbol}[1]{%
+ \protect\mfirstucMakeUppercase{\glsentrysymbol{#1}}}
+ \newcommand*{\glsaccesssymbolplural}[1]{\glsentrysymbolplural{#1}}
+ \newcommand*{\Glsaccesssymbolplural}[1]{\Glsentrysymbolplural{#1}}
+ \newcommand*{\GLSaccesssymbolplural}[1]{%
+ \protect\mfirstucMakeUppercase{\glsentrysymbolplural{#1}}}
+ \newcommand*{\glsaccessdesc}[1]{\glsentrydesc{#1}}
+ \newcommand*{\Glsaccessdesc}[1]{\Glsentrydesc{#1}}
+ \newcommand*{\GLSaccessdesc}[1]{%
+ \protect\mfirstucMakeUppercase{\glsentrydesc{#1}}}
+ \newcommand*{\glsaccessdescplural}[1]{\glsentrydescplural{#1}}
+ \newcommand*{\Glsaccessdescplural}[1]{\Glsentrydescplural{#1}}
+ \newcommand*{\GLSaccessdescplural}[1]{%
+ \protect\mfirstucMakeUppercase{\glsentrydescplural{#1}}}
+ \newcommand*{\glsaccessshort}[1]{\glsentryshort{#1}}
+ \newcommand*{\Glsaccessshort}[1]{\Glsentryshort{#1}}
+ \newcommand*{\GLSaccessshort}[1]{%
+ \protect\mfirstucMakeUppercase{\glsentryshort{#1}}}
+ \newcommand*{\glsaccessshortpl}[1]{\glsentryshortpl{#1}}
+ \newcommand*{\Glsaccessshortpl}[1]{\Glsentryshortpl{#1}}
+ \newcommand*{\GLSaccessshortpl}[1]{%
+ \protect\mfirstucMakeUppercase{\glsentryshortpl{#1}}}
+ \newcommand*{\glsaccesslong}[1]{\glsentrylong{#1}}
+ \newcommand*{\Glsaccesslong}[1]{\Glsentrylong{#1}}
+ \newcommand*{\GLSaccesslong}[1]{%
+ \protect\mfirstucMakeUppercase{\glsentrylong{#1}}}
+ \newcommand*{\glsaccesslongpl}[1]{\glsentrylongpl{#1}}
+ \newcommand*{\Glsaccesslongpl}[1]{\Glsentrylongpl{#1}}
+ \newcommand*{\GLSaccesslongpl}[1]{%
+ \protect\mfirstucMakeUppercase{\glsentrylongpl{#1}}}
+ \newcommand*{\@gls@initaccesskeys}{}
+ \newcommand{\@gls@setup@default@access}{}
+ \newcommand*{\glsxtrAccSuppAbbrSetNoLongAttrs}[1]{}
+ \newcommand*{\glsxtrAccSuppAbbrSetFirstLongAttrs}[1]{}
+ \newcommand*{\glsxtrAccSuppAbbrSetTextShortAttrs}[1]{}
+ \newcommand*{\glsxtrAccSuppAbbrSetNameShortAttrs}[1]{}
+ \newcommand*{\glsxtrAccSuppAbbrSetNameLongAttrs}[1]{}
+}
+\glsaddstoragekey{category}{general}{\glscategory}
+\newcommand{\glsifcategory}[4]{%
+ \ifglsfieldeq{#1}{category}{#2}{#3}{#4}%
+}
+\newcommand*{\glssetcategoryattribute}[3]{%
+ \csdef{@glsxtr@categoryattr@@#1@#2}{#3}%
+}
+\newcommand*{\glssetcategoriesattribute}[3]{%
+ \@for\@gls@thiscatlabel:=#1\do{%
+ \csgdef{@glsxtr@categoryattr@@\@gls@thiscatlabel @#2}{#3}%
+ }%
+}
+\newcommand*{\glssetcategoriesattributes}[3]{%
+ {%
+ \@for\@gls@thisattrlabel:=#2\do{%
+ \glssetcategoriesattribute{#1}{\@gls@thisattrlabel}{#3}%
+ }%
+ }%
+}
+\newcommand*{\glsgetcategoryattribute}[2]{%
+ \csuse{@glsxtr@categoryattr@@#1@#2}%
+}
+\newcommand*{\glsunsetcategoryattribute}[2]{%
+ \csundef{@glsxtr@categoryattr@@#1@#2}%
+}
+\newcommand*{\glshascategoryattribute}[4]{%
+ \ifcsvoid{@glsxtr@categoryattr@@#1@#2}{#4}{#3}%
+}
+\newcommand*{\glssetattribute}[3]{%
+ \glssetcategoryattribute{\glscategory{#1}}{#2}{#3}%
+}
+\newcommand*{\glsgetattribute}[2]{%
+ \glsgetcategoryattribute{\glscategory{#1}}{#2}%
+}
+\newcommand*{\glshasattribute}[4]{%
+ \ifglsentryexists{#1}%
+ {\glshascategoryattribute{\glscategory{#1}}{#2}{#3}{#4}}%
+ {#4}%
+}
+\newcommand{\glsifcategoryattribute}[5]{%
+ \ifcsundef{@glsxtr@categoryattr@@#1@#2}%
+ {#5}%
+ {\ifcsstring{@glsxtr@categoryattr@@#1@#2}{#3}{#4}{#5}}%
+}
+\newcommand{\glsifattribute}[5]{%
+ \ifglsentryexists{#1}%
+ {\glsifcategoryattribute{\glscategory{#1}}{#2}{#3}{#4}{#5}}%
+ {#5}%
+}
+\glssetcategoryattribute{general}{regular}{true}
+\glssetcategoryattribute{acronym}{regular}{true}
+\newcommand*{\glssetregularcategory}[1]{%
+ \glssetcategoryattribute{#1}{regular}{true}%
+}
+\newcommand{\glsifregularcategory}[3]{%
+ \glsifcategoryattribute{#1}{regular}{true}{#2}{#3}%
+}
+\newcommand{\glsifnotregularcategory}[3]{%
+ \glsifcategoryattribute{#1}{regular}{false}{#2}{#3}%
+}
+\newcommand{\glsifregular}[3]{%
+ \glsifregularcategory{\glscategory{#1}}{#2}{#3}%
+}
+\newcommand{\glsifnotregular}[3]{%
+ \glsifnotregularcategory{\glscategory{#1}}{#2}{#3}%
+}
+\newcommand{\glsforeachincategory}[5][\@glo@types]{%
+ \forallglossaries[#1]{#3}%
+ {%
+ \forglsentries[#3]{#4}%
+ {%
+ \glsifcategory{#4}{#2}{#5}{}%
+ }%
+ }%
+}
+\newcommand{\glsforeachwithattribute}[6][\@glo@types]{%
+ \forallglossaries[#1]{#4}%
+ {%
+ \forglsentries[#4]{#5}%
+ {%
+ \glsifattribute{#5}{#2}{#3}{#6}{}%
+ }%
+ }%
+}
+\ifdef\newterm
+{%
+ \renewcommand*{\newterm}[2][]{%
+ \newglossaryentry{#2}%
+ {type={index},category=index,name={#2},%
+ description={\glsxtrpostdescription\nopostdesc},#1}%
+ }
+ \glssetcategoryattribute{index}{regular}{true}
+ \newcommand*{\glsxtrpostdescindex}{}
+}
+{}
+\ifdef\printsymbols
+{%
+ \newcommand*{\glsxtrnewsymbol}[3][]{%
+ \newglossaryentry{#2}{name={#3},sort={#2},type=symbols,category=symbol,#1}%
+ }
+ \glssetcategoryattribute{symbol}{regular}{true}
+ \newcommand*{\glsxtrpostdescsymbol}{}
+}
+{}
+\ifdef\printnumbers
+{%
+\ifdef\printnumbers
+ \newcommand*{\glsxtrnewnumber}[3][]{%
+ \newglossaryentry{#2}{name={#3},sort={#2},type=numbers,category=number,#1}%
+ }
+ \glssetcategoryattribute{number}{regular}{true}
+ \newcommand*{\glsxtrpostdescnumber}{}
+}
+{}
+\newcommand*{\glsxtrsetcategory}[2]{%
+ \@for\@glsxtr@label:=#1\do
+ {%
+ \glsfieldxdef{\@glsxtr@label}{category}{#2}%
+ }%
+}
+\newcommand*{\glsxtrsetcategoryforall}[2]{%
+ \forallglossaries[#1]{\@glsxtr@type}{%
+ \forglsentries[\@glsxtr@type]{\@glsxtr@label}%
+ {%
+ \glsfieldxdef{\@glsxtr@label}{category}{#2}%
+ }%
+ }%
+}
+\newcommand*{\glsxtrfieldtitlecase}[2]{%
+ \expandafter\glsxtrfieldtitlecasecs\expandafter
+ {\csname glo@\glsdetoklabel{#1}@#2\endcsname}%
+}
+\ifdef\glscapitalisewords
+{
+ \newcommand*{\glsxtrfieldtitlecasecs}[1]{%
+ \expandafter\glscapitalisewords\expandafter{#1}}
+}
+{
+ \newcommand*{\glsxtrfieldtitlecasecs}[1]{\xcapitalisewords{#1}}
+}
+\@ifpackageloaded{glossaries-accsupp}
+{
+ \renewcommand*{\glossentrydesc}[1]{%
+ \glsdoifexistsorwarn{#1}%
+ {%
+ \glssetabbrvfmt{\glscategory{#1}}%
+ \glshasattribute{#1}{glossdescfont}%
+ {%
+ \protected@edef\@glsxtr@attrval{\glsgetattribute{#1}{glossdescfont}}%
+ \ifcsdef{\@glsxtr@attrval}%
+ {%
+ \letcs{\@glsxtr@glossdescfont}{\@glsxtr@attrval}%
+ }%
+ {%
+ \GlossariesExtraWarning{Unknown control sequence name
+ `\@glsxtr@attrval' supplied in glossdescfont attribute
+ for entry `#1'. Ignoring}%
+ \let\@glsxtr@glossdescfont\@firstofone
+ }%
+ }%
+ {\let\@glsxtr@glossdescfont\@firstofone}%
+ \glsifattribute{#1}{glossdesc}{firstuc}%
+ {%
+ \@glsxtr@glossdescfont{\Glsaccessdesc{#1}}%
+ }%
+ {%
+ \glsifattribute{#1}{glossdesc}{title}%
+ {%
+ \@glsxtr@do@titlecaps@warn
+ \glsdescriptionaccessdisplay
+ {%
+ \@glsxtr@glossdescfont{\glsxtrfieldtitlecase{#1}{desc}}%
+ }%
+ {#1}%
+ }%
+ {%
+ \@glsxtr@glossdescfont{\glsaccessdesc{#1}}%
+ }%
+ }%
+ }%
+ }
+}
+{
+ \renewcommand*{\glossentrydesc}[1]{%
+ \glsdoifexistsorwarn{#1}%
+ {%
+ \glssetabbrvfmt{\glscategory{#1}}%
+ \glshasattribute{#1}{glossdescfont}%
+ {%
+ \protected@edef\@glsxtr@attrval{\glsgetattribute{#1}{glossdescfont}}%
+ \ifcsdef{\@glsxtr@attrval}%
+ {%
+ \letcs{\@glsxtr@glossdescfont}{\@glsxtr@attrval}%
+ }%
+ {%
+ \GlossariesExtraWarning{Unknown control sequence name
+ `\@glsxtr@attrval' supplied in glossdescfont attribute
+ for entry `#1'. Ignoring}%
+ \let\@glsxtr@glossdescfont\@firstofone
+ }%
+ }%
+ {\let\@glsxtr@glossdescfont\@firstofone}%
+ \glsifattribute{#1}{glossdesc}{firstuc}%
+ {%
+ \@glsxtr@glossdescfont{\Glsentrydesc{#1}}%
+ }%
+ {%
+ \glsifattribute{#1}{glossdesc}{title}%
+ {%
+ \@glsxtr@do@titlecaps@warn
+ \@glsxtr@glossdescfont{\glsxtrfieldtitlecase{#1}{desc}}%
+ }%
+ {%
+ \@glsxtr@glossdescfont{\glsentrydesc{#1}}%
+ }%
+ }%
+ }%
+ }
+}
+\@ifpackageloaded{glossaries-accsupp}
+{
+ \renewcommand*{\glossentryname}[1]{%
+ \@glsdoifexistsorwarn{#1}%
+ {%
+ \glssetabbrvfmt{\glscategory{#1}}%
+ \glshasattribute{#1}{glossnamefont}%
+ {%
+ \protected@edef\@glsxtr@attrval{\glsgetattribute{#1}{glossnamefont}}%
+ \ifcsdef{\@glsxtr@attrval}%
+ {%
+ \letcs{\@glsxtr@glossnamefont}{\@glsxtr@attrval}%
+ }%
+ {%
+ \GlossariesExtraWarning{Unknown control sequence name
+ `\@glsxtr@attrval' supplied in glossnamefont attribute
+ for entry `#1'. Reverting to default \string\glsnamefont}%
+ \let\@glsxtr@glossnamefont\glsnamefont
+ }%
+ }%
+ {\let\@glsxtr@glossnamefont\glsnamefont}%
+ \glsifattribute{#1}{glossname}{firstuc}%
+ {%
+ \glsnameaccessdisplay
+ {%
+ \@glsxtr@glossnamefont{\Glsentryname{#1}}%
+ }%
+ {#1}%
+ }%
+ {%
+ \glsifattribute{#1}{glossname}{title}%
+ {%
+ \@glsxtr@do@titlecaps@warn
+ \glsnameaccessdisplay
+ {%
+ \@glsxtr@glossnamefont{\glsxtrfieldtitlecase{#1}{name}}%
+ }%
+ {#1}%
+ }%
+ {%
+ \glsifattribute{#1}{glossname}{uc}%
+ {%
+ \glsnameaccessdisplay
+ {%
+ \letcs{\glo@name}{glo@\glsdetoklabel{#1}@name}%
+ \@glsxtr@glossnamefont{\mfirstucMakeUppercase{\glo@name}}%
+ }%
+ {#1}%
+ }%
+ {%
+ \letcs{\glo@name}{glo@\glsdetoklabel{#1}@name}%
+ \glsnameaccessdisplay
+ {%
+ \expandafter\@glsxtr@glossnamefont\expandafter{\glo@name}%
+ }%
+ {#1}%
+ }%
+ }%
+ }%
+ \glsxtrpostnamehook{#1}%
+ }%
+ }
+}
+{
+ \renewcommand*{\glossentryname}[1]{%
+ \@glsdoifexistsorwarn{#1}%
+ {%
+ \glssetabbrvfmt{\glscategory{#1}}%
+ \glshasattribute{#1}{glossnamefont}%
+ {%
+ \protected@edef\@glsxtr@attrval{\glsgetattribute{#1}{glossnamefont}}%
+ \ifcsdef{\@glsxtr@attrval}%
+ {%
+ \letcs{\@glsxtr@glossnamefont}{\@glsxtr@attrval}%
+ }%
+ {%
+ \GlossariesExtraWarning{Unknown control sequence name
+ `\@glsxtr@attrval' supplied in glossnamefont attribute
+ for entry `#1'. Reverting to default \string\glsnamefont}%
+ \let\@glsxtr@glossnamefont\glsnamefont
+ }%
+ }%
+ {\let\@glsxtr@glossnamefont\glsnamefont}%
+ \glsifattribute{#1}{glossname}{firstuc}%
+ {%
+ \@glsxtr@glossnamefont{\Glsentryname{#1}}%
+ }%
+ {%
+ \glsifattribute{#1}{glossname}{title}%
+ {%
+ \@glsxtr@do@titlecaps@warn
+ \@glsxtr@glossnamefont{\glsxtrfieldtitlecase{#1}{name}}%
+ }%
+ {%
+ \glsifattribute{#1}{glossname}{uc}%
+ {%
+ \letcs{\glo@name}{glo@\glsdetoklabel{#1}@name}%
+ \@glsxtr@glossnamefont{\mfirstucMakeUppercase{\glo@name}}%
+ }%
+ {%
+ \letcs{\glo@name}{glo@\glsdetoklabel{#1}@name}%
+ \expandafter\@glsxtr@glossnamefont\expandafter{\glo@name}%
+ }%
+ }%
+ }%
+ \glsxtrpostnamehook{#1}%
+ }%
+ }
+}
+\@ifpackageloaded{glossaries-accsupp}
+{
+ \renewcommand*{\Glossentryname}[1]{%
+ \@glsdoifexistsorwarn{#1}%
+ {%
+ \glssetabbrvfmt{\glscategory{#1}}%
+ \glshasattribute{#1}{glossnamefont}%
+ {%
+ \protected@edef\@glsxtr@attrval{\glsgetattribute{#1}{glossnamefont}}%
+ \ifcsdef{\@glsxtr@attrval}%
+ {%
+ \letcs{\@glsxtr@glossnamefont}{\@glsxtr@attrval}%
+ }%
+ {%
+ \GlossariesExtraWarning{Unknown control sequence name
+ `\@glsxtr@attrval' supplied in glossnamefont attribute
+ for entry `#1'. Reverting to default \string\glsnamefont}%
+ \let\@glsxtr@glossnamefont\glsnamefont
+ }%
+ }%
+ {\let\@glsxtr@glossnamefont\glsnamefont}%
+ \glsnameaccessdisplay
+ {%
+ \@glsxtr@glossnamefont{\Glsentryname{#1}}%
+ }%
+ {#1}%
+ \glsxtrpostnamehook{#1}%
+ }%
+ }
+}
+{
+ \renewcommand*{\Glossentryname}[1]{%
+ \@glsdoifexistsorwarn{#1}%
+ {%
+ \glssetabbrvfmt{\glscategory{#1}}%
+ \glshasattribute{#1}{glossnamefont}%
+ {%
+ \protected@edef\@glsxtr@attrval{\glsgetattribute{#1}{glossnamefont}}%
+ \ifcsdef{\@glsxtr@attrval}%
+ {%
+ \letcs{\@glsxtr@glossnamefont}{\@glsxtr@attrval}%
+ }%
+ {%
+ \GlossariesExtraWarning{Unknown control sequence name
+ `\@glsxtr@attrval' supplied in glossnamefont attribute
+ for entry `#1'. Reverting to default \string\glsnamefont}%
+ \let\@glsxtr@glossnamefont\glsnamefont
+ }%
+ }%
+ {\let\@glsxtr@glossnamefont\glsnamefont}%
+ \@glsxtr@glossnamefont{\Glsentryname{#1}}%
+ \glsxtrpostnamehook{#1}%
+ }%
+ }
+}
+\newcommand*{\glsxtrpostnamehook}[1]{%
+ \let\@glsnumberformat\@glsxtr@defaultnumberformat
+ \glsxtrdoautoindexname{#1}{indexname}%
+ \glsextrapostnamehook{#1}%
+ \csuse{glsxtrpostname\glscategory{#1}}%
+}
+\newcommand*{\glsextrapostnamehook}[1]{}%
+\newcommand*{\glsdefpostname}[2]{%
+ \csdef{glsxtrpostname#1}{#2}%
+}
+\@ifpackageloaded{glossaries-accsupp}
+{
+ \newcommand*{\glsxtr@setaccessdisplay}[1]{%
+ \ifcsdef{gls#1accessdisplay}%
+ {\letcs\@glsxtr@accessdisplay{gls#1accessdisplay}}%
+ {%
+ \protected@edef\@gls@thisval{#1}%
+ \@for\@gls@map:=\@gls@keymap\do{%
+ \protected@edef\@this@key{\expandafter\@secondoftwo\@gls@map}%
+ \ifdefequal{\@this@key}{\@gls@thisval}%
+ {%
+ \protected@edef\@gls@thisval{\expandafter\@firstoftwo\@gls@map}%
+ \@endfortrue
+ }%
+ {}%
+ }%
+ \ifcsdef{gls\@gls@thisval accessdisplay}%
+ {\letcs\@glsxtr@accessdisplay{gls\@gls@thisval accessdisplay}}%
+ {\let\@glsxtr@accessdisplay\@firstoftwo}%
+ }%
+ }
+}
+{%
+ \newcommand*{\glsxtr@setaccessdisplay}[1]{%
+ \let\@glsxtr@accessdisplay\@firstoftwo}
+}
+\newrobustcmd*{\glossentrynameother}[2]{%
+ \@glsdoifexistsorwarn{#1}%
+ {%
+ \glsxtr@setaccessdisplay{#2}%
+ \glssetabbrvfmt{\glscategory{#1}}%
+ \glshasattribute{#1}{glossnamefont}%
+ {%
+ \protected@edef\@glsxtr@attrval{\glsgetattribute{#1}{glossnamefont}}%
+ \ifcsdef{\@glsxtr@attrval}%
+ {%
+ \letcs{\@glsxtr@glossnamefont}{\@glsxtr@attrval}%
+ }%
+ {%
+ \GlossariesExtraWarning{Unknown control sequence name
+ `\@glsxtr@attrval' supplied in glossnamefont attribute
+ for entry `#1'. Reverting to default \string\glsnamefont}%
+ \let\@glsxtr@glossnamefont\glsnamefont
+ }%
+ }%
+ {\let\@glsxtr@glossnamefont\glsnamefont}%
+ \glsifattribute{#1}{glossname}{firstuc}%
+ {%
+ \@glsxtr@accessdisplay
+ {\@glsxtr@glossnamefont{\@Gls@entry@field{#1}{#2}}}%
+ {#1}%
+ }%
+ {%
+ \glsifattribute{#1}{glossname}{title}%
+ {%
+ \@glsxtr@do@titlecaps@warn
+ \@glsxtr@accessdisplay
+ {\@glsxtr@glossnamefont{\glsxtrfieldtitlecase{#1}{#2}}}%
+ {#1}%
+ }%
+ {%
+ \glsifattribute{#1}{glossname}{uc}%
+ {%
+ \letcs{\glo@name}{glo@\glsdetoklabel{#1}@#2}%
+ \@glsxtr@accessdisplay
+ {\@glsxtr@glossnamefont{\mfirstucMakeUppercase{\glo@name}}}%
+ {#1}%
+ }%
+ {%
+ \letcs{\glo@name}{glo@\glsdetoklabel{#1}@#2}%
+ \@glsxtr@accessdisplay
+ {\expandafter\@glsxtr@glossnamefont\expandafter{\glo@name}}%
+ {#1}%
+ }%
+ }%
+ }%
+ \glsxtrpostnamehook{#1}%
+ }%
+}
+\newif\if@glsxtr@format@override
+\@glsxtr@format@overridefalse
+\@ifpackageloaded{hyperref}
+{
+ \ifHy@hyperindex
+ \newcommand*{\GlsXtrEnableIndexFormatOverride}{%
+ \@glsxtr@format@overridetrue
+ \appto\theindex{\let\glshypernumber\@firstofone}%
+ }
+ \else
+ \newcommand*{\GlsXtrEnableIndexFormatOverride}{%
+ \@glsxtr@format@overridetrue
+ \appto\theindex{\let\glshypernumber\hyperpage}%
+ }
+ \fi
+}
+{
+ \newcommand*{\GlsXtrEnableIndexFormatOverride}{%
+ \@glsxtr@format@overridetrue
+ }
+}
+\@onlypreamble\GlsXtrEnableIndexFormatOverride
+\newcommand*{\glsxtrdoautoindexname}[2]{%
+ \glshasattribute{#1}{#2}%
+ {%
+ \@glsxtr@autoindex@setname{#1}%
+ \protected@edef\@glsxtr@attrval{\glsgetattribute{#1}{#2}}%
+ \if@glsxtr@format@override
+ \ifx\@glsnumberformat\@glsxtr@defaultnumberformat
+ \else
+ \let\@glsxtr@attrval\@glsnumberformat
+ \fi
+ \fi
+ \ifdefstring{\@glsxtr@attrval}{true}%
+ {}%
+ {\protected@eappto\@glo@name{\@glsxtr@autoindex@encap\@glsxtr@attrval}}%
+ \expandafter\glsxtrautoindex\expandafter{\@glo@name}%
+ }%
+ {}%
+}
+\newcommand*{\glsxtrautoindex}{\index}
+\newcommand{\glsxtrautoindexesc}{%
+ \@gls@checkmkidxchars\@glo@sort
+ \@glsxtr@autoindex@doextra@esc\@glo@sort
+}
+\newcommand*{\@glsxtr@autoindex@setname}[1]{%
+ \protected@edef\@glo@name{\glsxtrautoindexentry{#1}}%
+ \glsxtrautoindexassignsort{\@glo@sort}{#1}%
+ \glsxtrautoindexesc
+ \epreto\@glo@name{\@glo@sort\@glsxtr@autoindex@at}%
+}
+\newcommand*{\glsxtrautoindexentry}[1]{\string\glsentryname{#1}}
+\newcommand*{\glsxtrautoindexassignsort}[2]{%
+ \glsletentryfield{#1}{#2}{sort}%
+}
+\newcommand*{\@glsxtr@autoindex@doextra@esc}[1]{%
+ \ifx\@glsxtr@autoindex@esc\@gls@quotechar
+ \else
+ \def\@gls@checkedmkidx{}%
+ \edef\@@glsxtr@checkspch{%
+ \noexpand\@glsxtr@autoindex@escquote\expandonce{#1}%
+ \noexpand\@empty\@glsxtr@autoindex@esc\noexpand\@nnil
+ \@glsxtr@autoindex@esc\noexpand\@empty\noexpand\@glsxtr@endescspch}%
+ \@@glsxtr@checkspch
+ \let#1\@gls@checkedmkidx\relax
+ \fi
+ \ifx\@glsxtr@autoindex@at\@gls@actualchar
+ \else
+ \def\@gls@checkedmkidx{}%
+ \edef\@@glsxtr@checkspch{%
+ \noexpand\@glsxtr@autoindex@escat\expandonce{#1}%
+ \noexpand\@empty\@glsxtr@autoindex@at\noexpand\@nnil
+ \@glsxtr@autoindex@at\noexpand\@empty\noexpand\@glsxtr@endescspch}%
+ \@@glsxtr@checkspch
+ \let#1\@gls@checkedmkidx\relax
+ \fi
+ \ifx\@glsxtr@autoindex@level\@gls@levelchar
+ \else
+ \def\@gls@checkedmkidx{}%
+ \edef\@@glsxtr@checkspch{%
+ \noexpand\@glsxtr@autoindex@esclevel\expandonce{#1}%
+ \noexpand\@empty\@glsxtr@autoindex@level\noexpand\@nnil
+ \@glsxtr@autoindex@level\noexpand\@empty\noexpand\@glsxtr@endescspch}%
+ \@@glsxtr@checkspch
+ \let#1\@gls@checkedmkidx\relax
+ \fi
+ \ifx\@glsxtr@autoindex@encap\@gls@encapchar
+ \else
+ \def\@gls@checkedmkidx{}%
+ \edef\@@glsxtr@checkspch{%
+ \noexpand\@glsxtr@autoindex@escencap\expandonce{#1}%
+ \noexpand\@empty\@glsxtr@autoindex@encap\noexpand\@nnil
+ \@glsxtr@autoindex@encap\noexpand\@empty\noexpand\@glsxtr@endescspch}%
+ \@@glsxtr@checkspch
+ \let#1\@gls@checkedmkidx\relax
+ \fi
+}
+\newcommand*{\@glsxtr@autoindex@at}{}
+\newcommand*{\GlsXtrSetActualChar}[1]{%
+ \gdef\@glsxtr@autoindex@at{#1}%
+ \def\@glsxtr@autoindex@escat##1#1##2#1##3\@glsxtr@endescspch{%
+ \@@glsxtr@autoindex@escspch{#1}{\@glsxtr@autoindex@escat}{##1}{##2}{##3}%
+ }%
+}
+\@onlypreamble\GlsXtrSetActualChar
+\makeatother
+\GlsXtrSetActualChar{@}
+\makeatletter
+\newcommand*{\@glsxtr@autoindex@encap}{}
+\newcommand*{\GlsXtrSetEncapChar}[1]{%
+ \gdef\@glsxtr@autoindex@encap{#1}%
+ \def\@glsxtr@autoindex@escencap##1#1##2#1##3\@glsxtr@endescspch{%
+ \@@glsxtr@autoindex@escspch{#1}{\@glsxtr@autoindex@escencap}{##1}{##2}{##3}%
+ }%
+}
+\GlsXtrSetEncapChar{|}
+\@onlypreamble\GlsXtrSetEncapChar
+\newcommand*{\@glsxtr@autoindex@level}{}
+\newcommand*{\GlsXtrSetLevelChar}[1]{%
+ \gdef\@glsxtr@autoindex@level{#1}%
+ \def\@glsxtr@autoindex@esclevel##1#1##2#1##3\@glsxtr@endescspch{%
+ \@@glsxtr@autoindex@escspch{#1}{\@glsxtr@autoindex@esclevel}{##1}{##2}{##3}%
+ }%
+}
+\GlsXtrSetLevelChar{!}
+\@onlypreamble\GlsXtrSetLevelChar
+\newcommand*{\@glsxtr@autoindex@esc}{"}
+\newcommand*{\GlsXtrSetEscChar}[1]{%
+ \gdef\@glsxtr@autoindex@esc{#1}%
+ \def\@glsxtr@autoindex@escquote##1#1##2#1##3\@glsxtr@endescspch{%
+ \@@glsxtr@autoindex@escspch{#1}{\@glsxtr@autoindex@escquote}{##1}{##2}{##3}%
+ }%
+}
+\GlsXtrSetEscChar{"}
+\@onlypreamble\GlsXtrSetEscChar
+\ifdef\actualchar
+ {\expandafter\GlsXtrSetActualChar\expandafter{\actualchar}}
+ {}
+\ifdef\quotechar
+ {\expandafter\GlsXtrSetEscChar\expandafter{\quotechar}}
+ {}
+\ifdef\levelchar
+ {\expandafter\GlsXtrSetLevelChar\expandafter{\levelchar}}
+ {}
+\ifdef\encapchar
+ {\expandafter\GlsXtrSetEncapChar\expandafter{\encapchar}}
+ {}
+\def\@glsxtr@gobbleto@endescspch#1\@glsxtr@endescspch{}
+\newcommand*{\@@glsxtr@autoindex@escspch}[5]{%
+ \@gls@tmpb=\expandafter{\@gls@checkedmkidx}%
+ \toks@={#3}%
+ \ifx\@nnil#3\relax
+ \def\@@glsxtr@checkspch{\@glsxtr@gobbleto@endescspch#5\@glsxtr@endescspch}%
+ \else
+ \ifx\@nnil#4\relax
+ \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@}%
+ \def\@@glsxtr@checkspch{\@glsxtr@gobbleto@endescspch
+ #4#5\@glsxtr@endescspch}%
+ \else
+ \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@
+ \@glsxtr@autoindex@esc#1}%
+ \def\@@glsxtr@checkspch{#2#5#1\@nnil#1\@glsxtr@endescspch}%
+ \fi
+ \fi
+ \@@glsxtr@checkspch
+}
+\renewcommand*{\Glossentrydesc}[1]{%
+ \glsdoifexistsorwarn{#1}%
+ {%
+ \glssetabbrvfmt{\glscategory{#1}}%
+ \Glsaccessdesc{#1}%
+ }%
+}
+\ifdef\texorpdfstring
+{
+ \renewcommand*{\glossentrysymbol}[1]{%
+ \texorpdfstring{\@glossentrysymbol{#1}}{\glsentrypdfsymbol{#1}}%
+ }
+}
+{
+ \renewcommand*{\glossentrysymbol}[1]{\@glossentrysymbol{#1}}
+}
+\newcommand{\glsentrypdfsymbol}[1]{\glsentrysymbol{#1}}
+\newrobustcmd*{\@glossentrysymbol}[1]{%
+ \glsdoifexistsorwarn{#1}%
+ {%
+ \begingroup
+ \glssetabbrvfmt{\glscategory{#1}}%
+ \glshasattribute{#1}{glosssymbolfont}%
+ {%
+ \protected@edef\@glsxtr@attrval{\glsgetattribute{#1}{glosssymbolfont}}%
+ \ifcsdef{\@glsxtr@attrval}%
+ {%
+ \letcs{\@glsxtr@glosssymbolfont}{\@glsxtr@attrval}%
+ }%
+ {%
+ \GlossariesExtraWarning{Unknown control sequence name
+ `\@glsxtr@attrval' supplied in glosssymbolfont attribute
+ for entry `#1'. Ignoring}%
+ \let\@glsxtr@glosssymbolfont\@firstofone
+ }%
+ }%
+ {\let\@glsxtr@glosssymbolfont\@firstofone}%
+ \@glsxtr@glosssymbolfont{\glsaccesssymbol{#1}}%
+ \endgroup
+ }%
+}
+\renewcommand*{\Glossentrysymbol}[1]{%
+ \glsdoifexistsorwarn{#1}%
+ {%
+ \glssetabbrvfmt{\glscategory{#1}}%
+ \Glsaccesssymbol{#1}%
+ }%
+}
+\newcommand*{\GlsXtrEnableInitialTagging}{%
+ \@ifstar\s@glsxtr@enabletagging\@glsxtr@enabletagging
+}
+\@onlypreamble\GlsXtrEnableInitialTagging
+\newcommand*{\s@glsxtr@enabletagging}[2]{%
+ \undef#2%
+ \@glsxtr@enabletagging{#1}{#2}%
+}
+\newcommand*{\@glsxtr@enabletagging}[2]{%
+ \@for\@glsxtr@cat:=#1\do
+ {%
+ \ifdefempty\@glsxtr@cat
+ {}%
+ {\glssetcategoryattribute{\@glsxtr@cat}{tagging}{true}}%
+ }%
+ \newrobustcmd*#2[1]{##1}%
+ \def\@glsxtr@taggingcs{#2}%
+ \renewcommand*\@glsxtr@activate@initialtagging{%
+ \let#2\@glsxtr@tag
+ }%
+ \ifundef\@gls@preglossaryhook
+ {\GlossariesExtraWarning{Initial tagging requires at least
+ glossaries.sty v4.19 to work correctly}}%
+ {}%
+}
+\ifundef\mfu@checkword@do
+{
+ \newcommand*{\mfu@checkword@do}[1]{%
+ \ifdefstring{\mfu@checkword@arg}{#1}%
+ {%
+ \let\@mfu@domakefirstuc\@firstofone
+ \listbreak
+ }%
+ {}%
+ }
+ \ifundef\mfu@checkword
+ {
+ \newcommand{\@glsxtr@do@titlecaps@warn}{%
+ \GlossariesExtraWarning{mfirstuc.sty too old. Title Caps
+ support not available}%
+ \let\@glsxtr@do@titlecaps@warn\relax
+ }
+ }
+ {
+ \renewcommand*{\mfu@checkword}[1]{%
+ \def\mfu@checkword@arg{#1}%
+ \let\@mfu@domakefirstuc\makefirstuc
+ \forlistloop\mfu@checkword@do\@mfu@nocaplist
+ }
+ }
+}
+{}% no patch required
+\newcommand*{\@glsxtr@do@titlecaps@warn}{}
+\newcommand*\@glsxtr@activate@initialtagging{}
+\newrobustcmd*{\@glsxtr@tag}[1]{%
+ \glsifattribute{\glscurrententrylabel}{tagging}{true}%
+ {\glsxtrtagfont{#1}}{#1}%
+}
+\newcommand*{\glsxtrtagfont}[1]{\underline{#1}}
+\ifdef\@gls@preglossaryhook
+{
+ \renewcommand*{\@gls@preglossaryhook}{%
+ \@glsxtr@activate@initialtagging
+ \ifundef\@glsxtr@org@postdescription
+ {%
+ \let\@glsxtr@org@postdescription\glspostdescription
+ \renewcommand*{\glspostdescription}{%
+ \ifglsentryexists{\glscurrententrylabel}%
+ {%
+ \glsxtrpostdescription
+ \@glsxtr@org@postdescription
+ }%
+ {}%
+ }%
+ }%
+ {}%
+ \glossxtrsetpopts
+ }%
+}
+{}
+\newcommand*{\glsxtrpostdescription}{%
+ \csuse{glsxtrpostdesc\glscategory{\glscurrententrylabel}}%
+}
+\newcommand*{\glsxtrpostdescgeneral}{}
+\newcommand*{\glsxtrpostdescterm}{}
+\newcommand*{\glsxtrpostdescacronym}{}
+\newcommand*{\glsxtrpostdescabbreviation}{}
+\newcommand*{\glsdefpostdesc}[2]{%
+ \csdef{glsxtrpostdesc#1}{#2}%
+}
+\renewcommand*{\glspostlinkhook}{%
+ \ifglsentryexists{\glslabel}{\glsxtrpostlinkhook}{}%
+}
+\newcommand*{\glsxtrpostlinkhook}{%
+ \glsxtrdiscardperiod{\glslabel}%
+ {\glsxtrpostlinkendsentence}%
+ {\glsxtrifcustomdiscardperiod
+ {\glsxtrifperiod{\glsxtrpostlinkendsentence}{\glsxtrpostlink}}%
+ {\glsxtrpostlink}%
+ }%
+}
+\newcommand*{\glsxtrifcustomdiscardperiod}[2]{#2}
+\newcommand*{\glsxtrpostlink}{%
+ \csuse{glsxtrpostlink\glscategory{\glslabel}}%
+}
+\newcommand*{\glsdefpostlink}[2]{%
+ \ifthenelse{\equal{#1}{}}%
+ {\PackageError{glossaries-extra}
+ {Invalid empty category label in \string\glsdefpostlink}{}}%
+ {\csdef{glsxtrpostlink#1}{#2}}%
+}
+\newcommand*{\glsxtrpostlinkendsentence}{%
+ \ifcsdef{glsxtrpostlink\glscategory{\glslabel}}
+ {%
+ \csuse{glsxtrpostlink\glscategory{\glslabel}}%
+ .\spacefactor\sfcode`\. \relax
+ }%
+ {%
+ \spacefactor\sfcode`\. \relax
+ }%
+}
+\newcommand*{\glsxtrpostlinkAddDescOnFirstUse}{%
+ \glsxtrifwasfirstuse{\space\glsxtrparen{\glsaccessdesc{\glslabel}}}{}%
+}
+\newcommand*{\glsxtrpostlinkAddSymbolOnFirstUse}{%
+ \glsxtrifwasfirstuse
+ {%
+ \ifglshassymbol{\glslabel}%
+ {\space\glsxtrparen{\glsaccesssymbol{\glslabel}}}%
+ {}%
+ }%
+ {}%
+}
+\newcommand*{\glsxtrpostlinkAddSymbolDescOnFirstUse}{%
+ \glsxtrifwasfirstuse
+ {%
+ \space\glsxtrparen
+ {%
+ \ifglshassymbol{\glslabel}%
+ {\glsaccesssymbol{\glslabel}, }%
+ {}%
+ \glsaccessdesc{\glslabel}%
+ }%
+ }%
+ {}%
+}
+\newcommand*{\glsxtrdiscardperiod}[3]{%
+ \glsxtrifwasfirstuse
+ {%
+ \glsifattribute{#1}{retainfirstuseperiod}{true}%
+ {#3}%
+ {%
+ \glsifattribute{#1}{discardperiod}{true}%
+ {%
+ \glsifplural
+ {%
+ \glsifattribute{#1}{pluraldiscardperiod}{true}%
+ {\glsxtrifperiod{#2}{#3}}%
+ {#3}%
+ }%
+ {%
+ \glsxtrifperiod{#2}{#3}%
+ }%
+ }%
+ {#3}%
+ }%
+ }%
+ {%
+ \glsifattribute{#1}{discardperiod}{true}%
+ {%
+ \glsifplural
+ {%
+ \glsifattribute{#1}{pluraldiscardperiod}{true}%
+ {\glsxtrifperiod{#2}{#3}}%
+ {#3}%
+ }%
+ {%
+ \glsxtrifperiod{#2}{#3}%
+ }%
+ }%
+ {#3}%
+ }%
+}
+\newcommand*{\glsxtrifperiod}[1]{\new@ifnextchar.{\@firstoftwo{#1}}}
+\newcommand*{\glsxtr@punclist}{.,:;?!}
+\newcommand*{\glsxtraddpunctuationmark}[1]{\appto\glsxtr@punclist{#1}}
+\newcommand*{\glsxtrsetpunctuationmarks}[1]{\def\glsxtr@punclist{#1}}
+\newcommand*{\glsxtrifnextpunc}[2]{%
+ \def\reserved@a{#1}%
+ \def\reserved@b{#2}%
+ \futurelet\@glspunc@token\glsxtr@ifnextpunc
+}
+\newcommand*{\glsxtr@ifnextpunc}{%
+ \glsxtr@ifpunctoken{\@glspunc@token}{\let\reserved@b\reserved@a}{}%
+ \reserved@b
+}
+\newcommand*{\glsxtr@ifpunctoken}[1]{%
+ \expandafter\@glsxtr@ifpunctoken\expandafter#1\glsxtr@punclist\@nnil
+}
+\def\@glsxtr@ifpunctoken#1#2{%
+ \let\reserved@d=#2%
+ \ifx\reserved@d\@nnil
+ \let\glsxtr@next\@glsxtr@notfoundinlist
+ \else
+ \ifx#1\reserved@d
+ \let\glsxtr@next\@glsxtr@foundinlist
+ \else
+ \let\glsxtr@next\@glsxtr@ifpunctoken
+ \fi
+ \fi
+ \glsxtr@next#1%
+}
+\def\@glsxtr@foundinlist#1\@nnil{\@firstoftwo}
+\def\@glsxtr@notfoundinlist#1{\@secondoftwo}
+\newcommand{\glsxtrdopostpunc}[1]{%
+ \glsxtrifnextpunc{\@glsxtr@swaptwo{#1}}{#1}%
+}
+\newcommand{\@glsxtr@swaptwo}[2]{#2#1}
+\define@key{glsxtrabbrv}{category}{%
+ \protected@edef\glscategorylabel{#1}%
+}
+\define@key{glsxtrabbrv}{shortplural}{%
+ \def\@gls@shortpl{#1}%
+}
+\define@key{glsxtrabbrv}{longplural}{%
+ \def\@gls@longpl{#1}%
+}
+\newtoks\glsshortpltok
+\newtoks\glslongpltok
+\newcommand*{\@glsxtr@insertdots}[2]{%
+ \def#1{}%
+ \@glsxtr@insert@dots#1#2\@nnil
+}
+\newcommand*{\@glsxtr@insert@dots}[2]{%
+ \ifx\@nnil#2\relax
+ \let\@glsxtr@insert@dots@next\@gobble
+ \else
+ \ifx\relax#2\relax
+ \else
+ \appto#1{#2.}%
+ \fi
+ \let\@glsxtr@insert@dots@next\@glsxtr@insert@dots
+ \fi
+ \@glsxtr@insert@dots@next#1%
+}
+\newcommand*{\glsxtrwordsep}{\space}
+\newcommand*{\glsxtrword}[1]{#1}
+\newcommand*{\@glsxtr@markwordseps}[2]{%
+ \def#1{}%
+ \@glsxtr@mark@wordseps#1#2 \@nnil
+}
+\def\@glsxtr@mark@wordseps#1#2 #3{%
+ \ifdefempty{#1}%
+ {\def#1{\protect\glsxtrword{#2}}}%
+ {\appto#1{\protect\glsxtrwordsep\protect\glsxtrword{#2}}}%
+ \ifx\@nnil#3\relax
+ \let\@glsxtr@mark@wordseps@next\relax
+ \else
+ \def\@glsxtr@mark@wordseps@next{%
+ \@glsxtr@mark@wordseps#1#3}%
+ \fi
+ \@glsxtr@mark@wordseps@next
+}
+\newcommand*{\newabbreviation}[4][]{%
+ \glsxtr@newabbreviation{#1}{#2}{#3}{#4}%
+}
+\newcommand*{\glsxtr@newabbreviation}[4]{%
+ \glskeylisttok{#1}%
+ \glslabeltok{#2}%
+ \glsshorttok{#3}%
+ \glslongtok{#4}%
+ \def\glsxtrorgshort{#3}%
+ \def\glsxtrorglong{#4}%
+ \def\ExtraCustomAbbreviationFields{}%
+ \@gls@initaccesskeys
+ \def\glscategorylabel{abbreviation}%
+ \setkeys*{glsxtrabbrv}[shortplural,longplural]{#1}%
+ \ifcsdef{@glsabbrv@current@\glscategorylabel}%
+ {%
+ \let\@glsxtr@orgwarndep\GlsXtrWarnDeprecatedAbbrStyle
+ \let\GlsXtrWarnDeprecatedAbbrStyle\@gobbletwo
+ \glsxtr@applyabbrvstyle{\csname @glsabbrv@current@\glscategorylabel\endcsname}%
+ \let\GlsXtrWarnDeprecatedAbbrStyle\@glsxtr@orgwarndep
+ }%
+ {%
+ \glsxtr@applyabbrvstyle{\@glsabbrv@current@abbreviation}%
+ }%
+ \def\@gls@longpl{#4\glspluralsuffix}%
+ \let\@gls@default@longpl\@gls@longpl
+ \glsifcategoryattribute{\glscategorylabel}{markwords}{true}%
+ {%
+ \@glsxtr@markwordseps\@gls@long{#4}%
+ \expandafter\def\expandafter\@gls@longpl\expandafter
+ {\@gls@long\glspluralsuffix}%
+ \let\@gls@default@longpl\@gls@longpl
+ \expandafter\glslongtok\expandafter{\@gls@long}%
+ }%
+ {}%
+ \glsifcategoryattribute{\glscategorylabel}{markshortwords}{true}%
+ {%
+ \@glsxtr@markwordseps\@gls@short{#3}%
+ }%
+ {%
+ \glsifcategoryattribute{\glscategorylabel}{insertdots}{true}%
+ {%
+ \@glsxtr@insertdots\@gls@short{#3}%
+ \appto\@gls@short{\@}%
+ }%
+ {\def\@gls@short{#3}}%
+ }%
+ \glsifcategoryattribute{\glscategorylabel}{aposplural}{true}%
+ {%
+ \expandafter\def\expandafter\@gls@shortpl\expandafter{\@gls@short
+ '\abbrvpluralsuffix}%
+ }%
+ {%
+ \glsifcategoryattribute{\glscategorylabel}{noshortplural}{true}%
+ {%
+ \let\@gls@shortpl\@gls@short
+ }%
+ {%
+ \expandafter\def\expandafter\@gls@shortpl\expandafter{\@gls@short
+ \abbrvpluralsuffix}%
+ }%
+ }%
+ \expandafter\glsshorttok\expandafter{\@gls@short}%
+ \glsxtrnewabbrevpresetkeyhook{#1}{#2}{#3}%
+ \setkeys*{glsxtrabbrv}[category]{#1}%
+ \let\@gls@org@longpl\@gls@longpl
+ \let\@gls@org@shortpl\@gls@shortpl
+ \ifx\@gls@default@longpl\@gls@longpl
+ \else
+ \glsifcategoryattribute{\glscategorylabel}{markwords}{true}%
+ {%
+ \expandafter\@glsxtr@markwordseps\expandafter\@gls@longpl\expandafter
+ {\@gls@longpl}%
+ }%
+ {}%
+ \fi
+ \expandafter\glsshortpltok\expandafter{\@gls@shortpl}%
+ \expandafter\glslongpltok\expandafter{\@gls@longpl}%
+ \@gls@setup@default@access
+ \newabbreviationhook
+ \protected@edef\@do@newglossaryentry{%
+ \noexpand\newglossaryentry{\the\glslabeltok}%
+ {%
+ type=\glsxtrabbrvtype,%
+ category=abbreviation,%
+ short={\the\glsshorttok},%
+ shortplural={\the\glsshortpltok},%
+ long={\the\glslongtok},%
+ longplural={\the\glslongpltok},%
+ name={\the\glsshorttok},%
+ \CustomAbbreviationFields,%
+ \ExtraCustomAbbreviationFields
+ \the\glskeylisttok
+ }%
+ }%
+ \@do@newglossaryentry
+ \@glsxtr@addabbreviationlist{\glsentrytype{\the\glslabeltok}}%
+ \GlsXtrPostNewAbbreviation
+}
+\newcommand*{\glsxtrnewabbrevpresetkeyhook}[3]{}
+\newcommand*{\GlsXtrPostNewAbbreviation}{}
+\newcommand*{\newabbreviationhook}{}
+\newcommand*{\CustomAbbreviationFields}{}
+\newcommand*{\glsxtrparen}[1]{(#1)}
+\newcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstlongfont{\glsaccesslong{#1}}#2\glsxtrfullsep{#1}%
+ \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshort{#1}}}%
+}
+\newcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstlongfont{\Glsaccesslong{#1}}#2\glsxtrfullsep{#1}%
+ \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshort{#1}}}%
+}
+\newcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstlongfont{\glsaccesslongpl{#1}}#2\glsxtrfullsep{#1}%
+ \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshortpl{#1}}}%
+}
+\newcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstlongfont{\Glsaccesslongpl{#1}}#2\glsxtrfullsep{#1}%
+ \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshortpl{#1}}}%
+}
+\newcommand*{\glsxtrfullsep}[1]{\space}
+\newcommand*{\glsxtrinlinefullformat}{\glsxtrfullformat}
+\newcommand*{\Glsxtrinlinefullformat}{\Glsxtrfullformat}
+\newcommand*{\glsxtrinlinefullplformat}{\glsxtrfullplformat}
+\newcommand*{\Glsxtrinlinefullplformat}{\Glsxtrfullplformat}
+\renewcommand*{\glsentryfull}[1]{\glsxtrinlinefullformat{#1}{}}
+\renewcommand*{\Glsentryfull}[1]{\Glsxtrinlinefullformat{#1}{}}
+\renewcommand*{\glsentryfullpl}[1]{\glsxtrinlinefullplformat{#1}{}}
+\renewcommand*{\Glsentryfullpl}[1]{\Glsxtrinlinefullplformat{#1}{}}
+\newcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvdefaultfont{#1}}
+\newcommand*{\glsfirstabbrvdefaultfont}[1]{\glsabbrvdefaultfont{#1}}
+\newcommand*{\glsabbrvfont}[1]{\glsabbrvdefaultfont{#1}}
+\newcommand*{\glsabbrvdefaultfont}[1]{#1}
+\newcommand*{\glslongfont}[1]{\glslongdefaultfont{#1}}
+\newcommand*{\glslongdefaultfont}[1]{#1}
+\newcommand*{\glsfirstlongfont}[1]{\glslongfont{#1}}
+\newcommand*{\glsfirstlongdefaultfont}[1]{\glslongdefaultfont{#1}}
+\newcommand*{\glsxtrabbrvpluralsuffix}{\glspluralsuffix}
+\newcommand*{\abbrvpluralsuffix}{\glsxtrabbrvpluralsuffix}
+\newrobustcmd*{\glsxtrfull}{\@gls@hyp@opt\ns@glsxtrfull}
+\newcommand*\ns@glsxtrfull[2][]{%
+ \new@ifnextchar[{\@glsxtr@full{#1}{#2}}%
+ {\@glsxtr@full{#1}{#2}[]}%
+}
+\def\@glsxtr@full#1#2[#3]{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \glsdoifexists{#2}%
+ {%
+ \glssetabbrvfmt{\glscategory{#2}}%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsifplural\@secondoftwo
+ \let\glscapscase\@firstofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{\glsxtrinlinefullformat{#2}{#3}}%
+ \glsxtrsetupfulldefs
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\newcommand*{\glsxtrsetupfulldefs}{%
+ \let\glsxtrifwasfirstuse\@firstoftwo
+}
+\newrobustcmd*{\Glsxtrfull}{\@gls@hyp@opt\ns@Glsxtrfull}
+\newcommand*\ns@Glsxtrfull[2][]{%
+ \new@ifnextchar[{\@Glsxtr@full{#1}{#2}}%
+ {\@Glsxtr@full{#1}{#2}[]}%
+}
+\def\@Glsxtr@full#1#2[#3]{%
+ \glsdoifexists{#2}%
+ {%
+ \glssetabbrvfmt{\glscategory{#2}}%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsifplural\@secondoftwo
+ \let\glscapscase\@secondofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{\Glsxtrinlinefullformat{#2}{#3}}%
+ \glsxtrsetupfulldefs
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\newrobustcmd*{\GLSxtrfull}{\@gls@hyp@opt\ns@GLSxtrfull}
+\newcommand*\ns@GLSxtrfull[2][]{%
+ \new@ifnextchar[{\@GLSxtr@full{#1}{#2}}%
+ {\@GLSxtr@full{#1}{#2}[]}%
+}
+\def\@GLSxtr@full#1#2[#3]{%
+ \glsdoifexists{#2}%
+ {%
+ \glssetabbrvfmt{\glscategory{#2}}%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsifplural\@secondoftwo
+ \let\glscapscase\@thirdofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{\mfirstucMakeUppercase{\glsxtrinlinefullformat{#2}{#3}}}%
+ \glsxtrsetupfulldefs
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\newrobustcmd*{\glsxtrfullpl}{\@gls@hyp@opt\ns@glsxtrfullpl}
+\newcommand*\ns@glsxtrfullpl[2][]{%
+ \new@ifnextchar[{\@glsxtr@fullpl{#1}{#2}}%
+ {\@glsxtr@fullpl{#1}{#2}[]}%
+}
+\def\@glsxtr@fullpl#1#2[#3]{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \glsdoifexists{#2}%
+ {%
+ \glssetabbrvfmt{\glscategory{#2}}%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsifplural\@firstoftwo
+ \let\glscapscase\@firstofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{\glsxtrinlinefullplformat{#2}{#3}}%
+ \glsxtrsetupfulldefs
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\newrobustcmd*{\Glsxtrfullpl}{\@gls@hyp@opt\ns@Glsxtrfullpl}
+\newcommand*\ns@Glsxtrfullpl[2][]{%
+ \new@ifnextchar[{\@Glsxtr@fullpl{#1}{#2}}%
+ {\@Glsxtr@fullpl{#1}{#2}[]}%
+}
+\def\@Glsxtr@fullpl#1#2[#3]{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \glsdoifexists{#2}%
+ {%
+ \glssetabbrvfmt{\glscategory{#2}}%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsifplural\@firstoftwo
+ \let\glscapscase\@secondofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{\Glsxtrinlinefullplformat{#2}{#3}}%
+ \glsxtrsetupfulldefs
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\newrobustcmd*{\GLSxtrfullpl}{\@gls@hyp@opt\ns@GLSxtrfullpl}
+\newcommand*\ns@GLSxtrfullpl[2][]{%
+ \new@ifnextchar[{\@GLSxtr@fullpl{#1}{#2}}%
+ {\@GLSxtr@fullpl{#1}{#2}[]}%
+}
+\def\@GLSxtr@fullpl#1#2[#3]{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \glsdoifexists{#2}%
+ {%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsifplural\@firstoftwo
+ \let\glscapscase\@thirdofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \mfirstucMakeUppercase{\glsxtrinlinefullplformat{#2}{#3}}}%
+ \glsxtrsetupfulldefs
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\newrobustcmd*{\glsxtrshort}{\@gls@hyp@opt\ns@glsxtrshort}
+\newcommand*{\ns@glsxtrshort}[2][]{%
+ \new@ifnextchar[{\@glsxtrshort{#1}{#2}}{\@glsxtrshort{#1}{#2}[]}%
+}
+\def\@glsxtrshort#1#2[#3]{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \glsdoifexists{#2}%
+ {%
+ \glssetabbrvfmt{\glscategory{#2}}%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@secondoftwo
+ \let\glscapscase\@firstofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \glsabbrvfont{\glsaccessshort{#2}\ifglsxtrinsertinside#3\fi}%
+ \ifglsxtrinsertinside\else#3\fi
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\newrobustcmd*{\Glsxtrshort}{\@gls@hyp@opt\ns@Glsxtrshort}
+\newcommand*{\ns@Glsxtrshort}[2][]{%
+ \new@ifnextchar[{\@Glsxtrshort{#1}{#2}}{\@Glsxtrshort{#1}{#2}[]}%
+}
+\def\@Glsxtrshort#1#2[#3]{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \glsdoifexists{#2}%
+ {%
+ \glssetabbrvfmt{\glscategory{#2}}%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@secondoftwo
+ \let\glscapscase\@secondofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \glsabbrvfont{\Glsaccessshort{#2}\ifglsxtrinsertinside#3\fi}%
+ \ifglsxtrinsertinside\else#3\fi
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\newrobustcmd*{\GLSxtrshort}{\@gls@hyp@opt\ns@GLSxtrshort}
+\newcommand*{\ns@GLSxtrshort}[2][]{%
+ \new@ifnextchar[{\@GLSxtrshort{#1}{#2}}{\@GLSxtrshort{#1}{#2}[]}%
+}
+\def\@GLSxtrshort#1#2[#3]{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \glsdoifexists{#2}%
+ {%
+ \glssetabbrvfmt{\glscategory{#2}}%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@secondoftwo
+ \let\glscapscase\@thirdofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \mfirstucMakeUppercase
+ {\glsabbrvfont{\glsaccessshort{#2}\ifglsxtrinsertinside#3\fi}%
+ \ifglsxtrinsertinside\else#3\fi
+ }%
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\newrobustcmd*{\glsxtrlong}{\@gls@hyp@opt\ns@glsxtrlong}
+\newcommand*{\ns@glsxtrlong}[2][]{%
+ \new@ifnextchar[{\@glsxtrlong{#1}{#2}}{\@glsxtrlong{#1}{#2}[]}%
+}
+\def\@glsxtrlong#1#2[#3]{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \glsdoifexists{#2}%
+ {%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@secondoftwo
+ \let\glscapscase\@firstofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \glslongfont{\glsaccesslong{#2}\ifglsxtrinsertinside#3\fi}%
+ \ifglsxtrinsertinside\else#3\fi
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\newrobustcmd*{\Glsxtrlong}{\@gls@hyp@opt\ns@Glsxtrlong}
+\newcommand*{\ns@Glsxtrlong}[2][]{%
+ \new@ifnextchar[{\@Glsxtrlong{#1}{#2}}{\@Glsxtrlong{#1}{#2}[]}%
+}
+\def\@Glsxtrlong#1#2[#3]{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \glsdoifexists{#2}%
+ {%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@secondoftwo
+ \let\glscapscase\@secondofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \glslongfont{\Glsaccesslong{#2}\ifglsxtrinsertinside#3\fi}%
+ \ifglsxtrinsertinside\else#3\fi
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\newrobustcmd*{\GLSxtrlong}{\@gls@hyp@opt\ns@GLSxtrlong}
+\newcommand*{\ns@GLSxtrlong}[2][]{%
+ \new@ifnextchar[{\@GLSxtrlong{#1}{#2}}{\@GLSxtrlong{#1}{#2}[]}%
+}
+\def\@GLSxtrlong#1#2[#3]{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \glsdoifexists{#2}%
+ {%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@secondoftwo
+ \let\glscapscase\@thirdofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \mfirstucMakeUppercase
+ {\glslongfont{\glsaccesslong{#2}\ifglsxtrinsertinside#3\fi}%
+ \ifglsxtrinsertinside\else#3\fi
+ }%
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\newrobustcmd*{\glsxtrshortpl}{\@gls@hyp@opt\ns@glsxtrshortpl}
+\newcommand*{\ns@glsxtrshortpl}[2][]{%
+ \new@ifnextchar[{\@glsxtrshortpl{#1}{#2}}{\@glsxtrshortpl{#1}{#2}[]}%
+}
+\def\@glsxtrshortpl#1#2[#3]{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \glsdoifexists{#2}%
+ {%
+ \glssetabbrvfmt{\glscategory{#2}}%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@firstoftwo
+ \let\glscapscase\@firstofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \glsabbrvfont{\glsaccessshortpl{#2}\ifglsxtrinsertinside#3\fi}%
+ \ifglsxtrinsertinside\else#3\fi
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\newrobustcmd*{\Glsxtrshortpl}{\@gls@hyp@opt\ns@Glsxtrshortpl}
+\newcommand*{\ns@Glsxtrshortpl}[2][]{%
+ \new@ifnextchar[{\@Glsxtrshortpl{#1}{#2}}{\@Glsxtrshortpl{#1}{#2}[]}%
+}
+\def\@Glsxtrshortpl#1#2[#3]{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \glsdoifexists{#2}%
+ {%
+ \glssetabbrvfmt{\glscategory{#2}}%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@firstoftwo
+ \let\glscapscase\@secondofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \glsabbrvfont{\Glsaccessshortpl{#2}\ifglsxtrinsertinside#3\fi}%
+ \ifglsxtrinsertinside\else#3\fi
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\newrobustcmd*{\GLSxtrshortpl}{\@gls@hyp@opt\ns@GLSxtrshortpl}
+\newcommand*{\ns@GLSxtrshortpl}[2][]{%
+ \new@ifnextchar[{\@GLSxtrshortpl{#1}{#2}}{\@GLSxtrshortpl{#1}{#2}[]}%
+}
+\def\@GLSxtrshortpl#1#2[#3]{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \glsdoifexists{#2}%
+ {%
+ \glssetabbrvfmt{\glscategory{#2}}%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@firstoftwo
+ \let\glscapscase\@thirdofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \mfirstucMakeUppercase
+ {\glsabbrvfont{\glsaccessshortpl{#2}\ifglsxtrinsertinside#3\fi}%
+ \ifglsxtrinsertinside\else#3\fi
+ }%
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\newrobustcmd*{\glsxtrlongpl}{\@gls@hyp@opt\ns@glsxtrlongpl}
+\newcommand*{\ns@glsxtrlongpl}[2][]{%
+ \new@ifnextchar[{\@glsxtrlongpl{#1}{#2}}{\@glsxtrlongpl{#1}{#2}[]}%
+}
+\def\@glsxtrlongpl#1#2[#3]{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \glsdoifexists{#2}%
+ {%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@firstoftwo
+ \let\glscapscase\@firstofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \glslongfont{\glsaccesslongpl{#2}\ifglsxtrinsertinside#3\fi}%
+ \ifglsxtrinsertinside\else#3\fi
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\newrobustcmd*{\Glsxtrlongpl}{\@gls@hyp@opt\ns@Glsxtrlongpl}
+\newcommand*{\ns@Glsxtrlongpl}[2][]{%
+ \new@ifnextchar[{\@Glsxtrlongpl{#1}{#2}}{\@Glsxtrlongpl{#1}{#2}[]}%
+}
+\def\@Glsxtrlongpl#1#2[#3]{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \glsdoifexists{#2}%
+ {%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@firstoftwo
+ \let\glscapscase\@secondofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \glslongfont{\Glsaccesslongpl{#2}\ifglsxtrinsertinside#3\fi}%
+ \ifglsxtrinsertinside\else#3\fi
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\newrobustcmd*{\GLSxtrlongpl}{\@gls@hyp@opt\ns@GLSxtrlongpl}
+\newcommand*{\ns@GLSxtrlongpl}[2][]{%
+ \new@ifnextchar[{\@GLSxtrlongpl{#1}{#2}}{\@GLSxtrlongpl{#1}{#2}[]}%
+}
+\def\@GLSxtrlongpl#1#2[#3]{%
+ \@glsxtr@record{#1}{#2}{glslink}%
+ \glsdoifexists{#2}%
+ {%
+ \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ \let\glsifplural\@firstoftwo
+ \let\glscapscase\@thirdofthree
+ \let\glsinsert\@empty
+ \def\glscustomtext{%
+ \mfirstucMakeUppercase
+ {\glslongfont{\glsaccesslongpl{#2}\ifglsxtrinsertinside#3\fi}%
+ \ifglsxtrinsertinside\else#3\fi
+ }%
+ }%
+ \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}%
+ }%
+ \glspostlinkhook
+}
+\newcommand*{\glssetabbrvfmt}[1]{%
+ \ifcsdef{@glsabbrv@current@#1}%
+ {\glsxtr@applyabbrvfmt{\csname @glsabbrv@current@#1\endcsname}}%
+ {\glsxtr@applyabbrvfmt{\@glsabbrv@current@abbreviation}}%
+}
+\newrobustcmd*{\glsuseabbrvfont}[2]{{\glssetabbrvfmt{#2}\glsabbrvfont{#1}}}
+\newrobustcmd*{\glsuselongfont}[2]{{\glssetabbrvfmt{#2}\glslongfont{#1}}}
+\newcommand*{\glsxtrgenabbrvfmt}{%
+ \ifdefempty\glscustomtext
+ {%
+ \ifglsused\glslabel
+ {%
+ \glsifplural
+ {%
+ \glscapscase
+ {%
+ \glsxtrsubsequentplfmt{\glslabel}{\glsinsert}%
+ }%
+ {%
+ \Glsxtrsubsequentplfmt{\glslabel}{\glsinsert}%
+ }%
+ {%
+ \mfirstucMakeUppercase
+ {\glsxtrsubsequentplfmt{\glslabel}{\glsinsert}}%
+ }%
+ }%
+ {%
+ \glscapscase
+ {%
+ \glsxtrsubsequentfmt{\glslabel}{\glsinsert}%
+ }%
+ {%
+ \Glsxtrsubsequentfmt{\glslabel}{\glsinsert}%
+ }%
+ {%
+ \mfirstucMakeUppercase
+ {\glsxtrsubsequentfmt{\glslabel}{\glsinsert}}%
+ }%
+ }%
+ }%
+ {%
+ \glsifplural
+ {%
+ \glscapscase
+ {%
+ \glsxtrfullplformat{\glslabel}{\glsinsert}%
+ }%
+ {%
+ \Glsxtrfullplformat{\glslabel}{\glsinsert}%
+ }%
+ {%
+ \mfirstucMakeUppercase
+ {\glsxtrfullplformat{\glslabel}{\glsinsert}}%
+ }%
+ }%
+ {%
+ \glscapscase
+ {%
+ \glsxtrfullformat{\glslabel}{\glsinsert}%
+ }%
+ {%
+ \Glsxtrfullformat{\glslabel}{\glsinsert}%
+ }%
+ {%
+ \mfirstucMakeUppercase
+ {\glsxtrfullformat{\glslabel}{\glsinsert}}%
+ }%
+ }%
+ }%
+ }%
+ {%
+ \glscustomtext
+ }%
+}
+\newcommand*{\glsxtrsubsequentfmt}[2]{%
+ \glsabbrvfont{\glsaccessshort{#1}\ifglsxtrinsertinside #2\fi}%
+ \ifglsxtrinsertinside \else#2\fi
+}
+\let\glsxtrdefaultsubsequentfmt\glsxtrsubsequentfmt
+\newcommand*{\glsxtrsubsequentplfmt}[2]{%
+ \glsabbrvfont{\glsaccessshortpl{#1}\ifglsxtrinsertinside #2\fi}%
+ \ifglsxtrinsertinside \else#2\fi
+}
+\let\glsxtrdefaultsubsequentplfmt\glsxtrsubsequentplfmt
+\newcommand*{\Glsxtrsubsequentfmt}[2]{%
+ \glsabbrvfont{\Glsaccessshort{#1}\ifglsxtrinsertinside #2\fi}%
+ \ifglsxtrinsertinside \else#2\fi
+}
+\let\Glsxtrdefaultsubsequentfmt\Glsxtrsubsequentfmt
+\newcommand*{\Glsxtrsubsequentplfmt}[2]{%
+ \glsabbrvfont{\Glsaccessshortpl{#1}\ifglsxtrinsertinside #2\fi}%
+ \ifglsxtrinsertinside \else#2\fi
+}
+\let\Glsxtrdefaultsubsequentplfmt\Glsxtrsubsequentplfmt
+\newcommand*{\setabbreviationstyle}[2][abbreviation]{%
+ \ifcsundef{@glsabbrv@dispstyle@setup@#2}
+ {%
+ \PackageError{glossaries-extra}{Undefined abbreviation style `#2'}{}%
+ }%
+ {%
+ \ifcsstring{@glsabbrv@current@#1}{#2}%
+ {%
+ }%
+ {%
+ \def\@glsxtr@dostylewarn{}%
+ \glsforeachincategory{#1}{\@gls@type}{\@gls@label}%
+ {%
+ \def\@glsxtr@dostylewarn{\GlossariesWarning{Abbreviation
+ style has been switched \MessageBreak
+ for category `#1', \MessageBreak
+ but there have already been entries \MessageBreak
+ defined for this category. Unwanted \MessageBreak
+ side-effects may result}}%
+ \@endfortrue
+ }%
+ \@glsxtr@dostylewarn
+ \csdef{@glsabbrv@current@#1}{#2}%
+ \protected@edef\glscategorylabel{#1}%
+ \glsxtr@applyabbrvstyle{#2}%
+ }%
+ }%
+}
+\newcommand*{\glsxtr@applyabbrvstyle}[1]{%
+ \csuse{@glsabbrv@dispstyle@setup@#1}%
+ \csuse{@glsabbrv@dispstyle@fmts@#1}%
+}
+\newcommand*{\glsxtr@applyabbrvfmt}[1]{%
+ \csuse{@glsabbrv@dispstyle@fmts@#1}%
+}
+\newcommand*{\newabbreviationstyle}[3]{%
+ \ifcsdef{@glsabbrv@dispstyle@setup@#1}
+ {%
+ \PackageError{glossaries-extra}{Abbreviation style `#1' already
+ defined}{}%
+ }%
+ {%
+ \csdef{@glsabbrv@dispstyle@setup@#1}{%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{}%
+ #2}%
+ \csdef{@glsabbrv@dispstyle@fmts@#1}{%
+ \renewcommand*{\glsxtrinlinefullformat}{\glsxtrfullformat}%
+ \renewcommand*{\Glsxtrinlinefullformat}{\Glsxtrfullformat}%
+ \renewcommand*{\glsxtrinlinefullplformat}{\glsxtrfullplformat}%
+ \renewcommand*{\Glsxtrinlinefullplformat}{\Glsxtrfullplformat}%
+ \let\glsxtrsubsequentfmt\glsxtrdefaultsubsequentfmt
+ \let\glsxtrsubsequentplfmt\glsxtrdefaultsubsequentplfmt
+ \let\Glsxtrsubsequentfmt\Glsxtrdefaultsubsequentfmt
+ \let\Glsxtrsubsequentplfmt\Glsxtrdefaultsubsequentplfmt
+ #3}%
+ }%
+}
+\newcommand*{\renewabbreviationstyle}[3]{%
+ \ifcsundef{@glsabbrv@dispstyle@setup@#1}
+ {%
+ \PackageError{glossaries-extra}{Abbreviation style `#1' not defined}{}%
+ }%
+ {%
+ \csdef{@glsabbrv@dispstyle@setup@#1}{%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{}%
+ #2}%
+ \csdef{@glsabbrv@dispstyle@fmts@#1}{%
+ \renewcommand*{\glsxtrinlinefullformat}{\glsxtrfullformat}%
+ \renewcommand*{\Glsxtrinlinefullformat}{\Glsxtrfullformat}%
+ \renewcommand*{\glsxtrinlinefullplformat}{\glsxtrfullplformat}%
+ \renewcommand*{\Glsxtrinlinefullplformat}{\Glsxtrfullplformat}%
+ #3}%
+ }%
+}
+\newcommand*{\letabbreviationstyle}[2]{%
+ \csletcs{@glsabbrv@dispstyle@setup@#1}{@glsabbrv@dispstyle@setup@#2}%
+ \csletcs{@glsabbrv@dispstyle@fmts@#1}{@glsabbrv@dispstyle@fmts@#2}%
+}
+\newcommand*{\@glsxtr@deprecated@abbrstyle}[2]{%
+ \csdef{@glsabbrv@dispstyle@setup@#1}{%
+ \GlsXtrWarnDeprecatedAbbrStyle{#1}{#2}%
+ \csuse{@glsabbrv@dispstyle@setup@#2}%
+ }%
+ \csletcs{@glsabbrv@dispstyle@fmts@#1}{@glsabbrv@dispstyle@fmts@#2}%
+}
+\newcommand*{\GlsXtrWarnDeprecatedAbbrStyle}[2]{%
+ \GlossariesExtraWarning{Deprecated abbreviation style name `#1',
+ use `#2' instead}%
+}
+\newcommand*{\GlsXtrUseAbbrStyleSetup}[1]{%
+ \ifcsundef{@glsabbrv@dispstyle@setup@#1}%
+ {%
+ \PackageError{glossaries-extra}%
+ {Unknown abbreviation style definitions `#1'}{}%
+ }%
+ {%
+ \csname @glsabbrv@dispstyle@setup@#1\endcsname
+ }%
+}
+\newcommand*{\GlsXtrUseAbbrStyleFmts}[1]{%
+ \ifcsundef{@glsabbrv@dispstyle@fmts@#1}%
+ {%
+ \PackageError{glossaries-extra}%
+ {Unknown abbreviation style formats `#1'}{}%
+ }%
+ {%
+ \csname @glsabbrv@dispstyle@fmts@#1\endcsname
+ }%
+}
+\newif\ifglsxtrinsertinside
+\glsxtrinsertinsidefalse
+\newcommand*{\glsxtrlongshortname}{%
+ \protect\glsabbrvfont{\the\glsshorttok}%
+}
+\newabbreviationstyle{long-short}%
+{%
+ \glsxtrAccSuppAbbrSetFirstLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongshortname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstlongfont{\the\glslongtok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvfont{\the\glsshorttok}}},%
+ firstplural={\protect\glsfirstlongfont{\the\glslongpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvfont{\the\glsshortpltok}}},%
+ plural={\protect\glsabbrvfont{\the\glsshortpltok}},%
+ text={\protect\glsabbrvfont{\the\glsshorttok}},%
+ description={\the\glslongtok}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrabbrvpluralsuffix}%
+ \renewcommand*{\glsabbrvfont}[1]{\glsabbrvdefaultfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvdefaultfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstlongfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstlongfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstlongfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstlongfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvfont{\glsaccessshortpl{##1}}}%
+ }%
+}
+\setabbreviationstyle{long-short}
+\newcommand*{\glsxtrlongshortdescsort}{%
+ \expandonce\glsxtrorglong\space (\expandonce\glsxtrorgshort)%
+}
+\newcommand*{\glsxtrlongshortdescname}{%
+ \protect\glslongfont{\the\glslongtok}
+ \glsxtrparen{\protect\glsabbrvfont{\the\glsshorttok}}%
+}
+\newabbreviationstyle{long-short-desc}%
+{%
+ \glsxtrAccSuppAbbrSetTextShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongshortdescname},
+ sort={\glsxtrlongshortdescsort},%
+ first={\protect\glsfirstlongfont{\the\glslongtok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvfont{\the\glsshorttok}}},%
+ firstplural={\protect\glsfirstlongfont{\the\glslongpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvfont{\the\glsshortpltok}}},%
+ text={\protect\glsabbrvfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvfont{\the\glsshortpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{long-short}%
+}
+\newcommand*{\glsxtrshortlongname}{%
+ \protect\glsabbrvfont{\the\glsshorttok}%
+}
+\newabbreviationstyle{short-long}%
+{%
+ \glsxtrAccSuppAbbrSetFirstLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortlongname},
+ sort={\the\glsshorttok},
+ description={\the\glslongtok},%
+ first={\protect\glsfirstabbrvfont{\the\glsshorttok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlongfont{\the\glslongtok}}},%
+ firstplural={\protect\glsfirstabbrvfont{\the\glsshortpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlongfont{\the\glslongpltok}}},%
+ text={\protect\glsabbrvfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrabbrvpluralsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvdefaultfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvdefaultfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfont{\glsaccesslongpl{##1}}}%
+ }%
+}
+\newcommand*{\glsxtrshortlongdescsort}{\the\glsshorttok}
+\newcommand*{\glsxtrshortlongdescname}{%
+ \protect\glsabbrvfont{\the\glsshorttok}
+ \glsxtrparen{\protect\glslongfont{\the\glslongtok}}%
+}
+\newabbreviationstyle{short-long-desc}%
+{%
+ \glsxtrAccSuppAbbrSetTextShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortlongdescname},
+ sort={\glsxtrshortlongdescsort},
+ first={\protect\glsfirstabbrvfont{\the\glsshorttok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlongfont{\the\glslongtok}}},%
+ firstplural={\protect\glsfirstabbrvfont{\the\glsshortpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlongfont{\the\glslongpltok}}},%
+ text={\protect\glsabbrvfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvfont{\the\glsshortpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{short-long}%
+}
+\newcommand*{\glsfirstlongfootnotefont}[1]{\glslongfootnotefont{#1}}%
+\newcommand*{\glslongfootnotefont}[1]{\glslongdefaultfont{#1}}%
+\newcommand*{\glsxtrabbrvfootnote}[2]{\footnote{#2}}
+\newcommand*{\glsxtrfootnotename}{%
+ \protect\glsabbrvfont{\the\glsshorttok}%
+}
+\newabbreviationstyle{footnote}%
+{%
+ \glsxtrAccSuppAbbrSetNoLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrfootnotename},
+ sort={\the\glsshorttok},
+ description={\the\glslongtok},%
+ first={\protect\glsfirstabbrvfont{\the\glsshorttok}%
+ \protect\glsxtrabbrvfootnote{\the\glslabeltok}%
+ {\protect\glsfirstlongfootnotefont{\the\glslongtok}}},%
+ firstplural={\protect\glsfirstabbrvfont{\the\glsshortpltok}%
+ \protect\glsxtrabbrvfootnote{\the\glslabeltok}%
+ {\protect\glsfirstlongfootnotefont{\the\glslongpltok}}},%
+ text={\protect\glsabbrvfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{nohyperfirst}{true}%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrabbrvpluralsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvdefaultfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvdefaultfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongfootnotefont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongfootnotefont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+}
+\letabbreviationstyle{short-footnote}{footnote}
+\newcommand*{\glsxtrfootnotedescname}{%
+ \protect\glsabbrvfont{\the\glsshorttok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \protect\glsxtrparen{\protect\glslongfont{\the\glslongtok}}%
+}
+\newcommand*{\glsxtrfootnotedescsort}{\the\glsshorttok}
+\newabbreviationstyle{short-footnote-desc}%
+{%
+ \glsxtrAccSuppAbbrSetNameLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrfootnotedescname},
+ sort={\glsxtrfootnotedescsort},
+ first={\protect\glsfirstabbrvfont{\the\glsshorttok}%
+ \protect\glsxtrabbrvfootnote{\the\glslabeltok}%
+ {\protect\glsfirstlongfootnotefont{\the\glslongtok}}},%
+ firstplural={\protect\glsfirstabbrvfont{\the\glsshortpltok}%
+ \protect\glsxtrabbrvfootnote{\the\glslabeltok}%
+ {\protect\glsfirstlongfootnotefont{\the\glslongpltok}}},%
+ text={\protect\glsabbrvfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{nohyperfirst}{true}%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{footnote}%
+}
+\letabbreviationstyle{footnote-desc}{short-footnote-desc}
+\newabbreviationstyle{postfootnote}%
+{%
+ \glsxtrAccSuppAbbrSetNoLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrfootnotename},
+ sort={\the\glsshorttok},
+ description={\the\glslongtok},%
+ first={\protect\glsfirstabbrvfont{\the\glsshorttok}},%
+ firstplural={\protect\glsfirstabbrvfont{\the\glsshortpltok}},%
+ text={\protect\glsabbrvfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \csdef{glsxtrpostlink\glscategorylabel}{%
+ \glsxtrifwasfirstuse
+ {%
+ \glsxtrdopostpunc{\protect\glsxtrabbrvfootnote{\glslabel}%
+ {\glsfirstlongfootnotefont{\glsentrylong{\glslabel}}}}%
+ }%
+ {}%
+ }%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+ \renewcommand*{\glsxtrsetupfulldefs}{%
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrabbrvpluralsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvdefaultfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvdefaultfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongfootnotefont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongfootnotefont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+}
+\letabbreviationstyle{short-postfootnote}{postfootnote}
+\newabbreviationstyle{short-postfootnote-desc}%
+{%
+ \glsxtrAccSuppAbbrSetNameLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrfootnotedescname},
+ sort={\glsxtrfootnotedescsort},
+ first={\protect\glsfirstabbrvfont{\the\glsshorttok}},%
+ firstplural={\protect\glsfirstabbrvfont{\the\glsshortpltok}},%
+ text={\protect\glsabbrvfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \csdef{glsxtrpostlink\glscategorylabel}{%
+ \glsxtrifwasfirstuse
+ {%
+ \glsxtrdopostpunc{\protect\glsxtrabbrvfootnote{\glslabel}%
+ {\glsfirstlongfootnotefont{\glsentrylong{\glslabel}}}}%
+ }%
+ {}%
+ }%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+ \renewcommand*{\glsxtrsetupfulldefs}{%
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{postfootnote}%
+}
+\letabbreviationstyle{postfootnote-desc}{short-postfootnote-desc}
+\newcommand*{\glsxtrshortnolongname}{%
+ \protect\glsabbrvfont{\the\glsshorttok}%
+}
+\newabbreviationstyle{short}%
+{%
+ \glsxtrAccSuppAbbrSetNoLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortnolongname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstabbrvfont{\the\glsshorttok}},
+ firstplural={\protect\glsfirstabbrvfont{\the\glsshortpltok}},
+ text={\protect\glsabbrvfont{\the\glsshorttok}},
+ plural={\protect\glsabbrvfont{\the\glsshortpltok}},
+ description={\the\glslongtok}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{regular}{true}}%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrabbrvpluralsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvdefaultfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvdefaultfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \protect\glsfirstabbrvfont{\glsaccessshort{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \protect\glsfirstabbrvfont{\glsaccessshortpl{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \protect\glsfirstabbrvfont{\glsaccessshort{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfont{\Glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \protect\glsfirstabbrvfont{\glsaccessshortpl{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfont{\Glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+}
+\setabbreviationstyle[acronym]{short}
+\letabbreviationstyle{short-nolong}{short}
+\newabbreviationstyle{short-nolong-noreg}%
+{%
+ \GlsXtrUseAbbrStyleSetup{short-nolong}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{short-nolong}%
+}
+\newcommand*{\glsxtrshortdescname}{%
+ \protect\glsabbrvfont{\the\glsshorttok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \protect\glsxtrparen{\protect\glslongfont{\the\glslongtok}}%
+}
+\newabbreviationstyle{short-desc}%
+{%
+ \glsxtrAccSuppAbbrSetNoLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortdescname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstabbrvfont{\the\glsshorttok}},
+ firstplural={\protect\glsfirstabbrvfont{\the\glsshortpltok}},
+ text={\protect\glsabbrvfont{\the\glsshorttok}},
+ plural={\protect\glsabbrvfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{regular}{true}}%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrabbrvpluralsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvdefaultfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvdefaultfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+}
+\letabbreviationstyle{short-nolong-desc}{short-desc}
+\newabbreviationstyle{short-nolong-desc-noreg}%
+{%
+ \GlsXtrUseAbbrStyleSetup{short-nolong-desc}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{short-nolong-desc}%
+}
+\newabbreviationstyle{nolong-short}%
+{%
+ \GlsXtrUseAbbrStyleSetup{short-nolong}%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{short-nolong}%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \protect\glsfirstlongfont{\glsaccesslong{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \protect\glsfirstlongfont{\glsaccesslongpl{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \protect\glsfirstlongfont{\glsaccesslong{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvfont{\Glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \protect\glsfirstlongfont{\glsaccesslongpl{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvfont{\Glsaccessshortpl{##1}}}%
+ }%
+}
+\newabbreviationstyle{nolong-short-noreg}%
+{%
+ \GlsXtrUseAbbrStyleSetup{nolong-short}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{nolong-short}%
+}
+\newcommand*{\glsxtrlongnoshortdescname}{%
+ \protect\glslongfont{\the\glslongtok}%
+}
+\newabbreviationstyle{long-desc}%
+{%
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongnoshortdescname},
+ sort={\the\glslongtok},
+ first={\protect\glsfirstlongfont{\the\glslongtok}},
+ firstplural={\protect\glsfirstlongfont{\the\glslongpltok}},
+ text={\glslongfont{\the\glslongtok}},
+ plural={\glslongfont{\the\glslongpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{regular}{true}}%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrabbrvpluralsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvdefaultfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvdefaultfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrsubsequentfmt}[2]{%
+ \glslongfont{\glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\glsxtrsubsequentplfmt}[2]{%
+ \glslongfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\Glsxtrsubsequentfmt}[2]{%
+ \glslongfont{\Glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
+ \glslongfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstlongfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstlongfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstlongfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstlongfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstlongfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstlongfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstlongfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstlongfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+}
+\letabbreviationstyle{long-noshort-desc}{long-desc}
+\newabbreviationstyle{long-noshort-desc-noreg}%
+{%
+ \GlsXtrUseAbbrStyleSetup{long-noshort-desc}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{long-noshort-desc}%
+}
+\newcommand*{\glsxtrlongnoshortname}{%
+ \protect\glsabbrvfont{\the\glsshorttok}%
+}
+\newabbreviationstyle{long}%
+{%
+ \glsxtrAccSuppAbbrSetNameShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongnoshortname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstlongfont{\the\glslongtok}},
+ firstplural={\protect\glsfirstlongfont{\the\glslongpltok}},
+ text={\glslongfont{\the\glslongtok}},
+ plural={\glslongfont{\the\glslongpltok}},%
+ description={\the\glslongtok}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{regular}{true}}%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{long-desc}%
+}
+\letabbreviationstyle{long-noshort}{long}
+\newabbreviationstyle{long-noshort-noreg}%
+{%
+ \GlsXtrUseAbbrStyleSetup{long-noshort}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{long-noshort}%
+}
+\newcommand*{\glsxtrscfont}[1]{\textsc{#1}}
+\newcommand*{\glsabbrvscfont}{\glsxtrscfont}
+\newcommand*{\glsxtrfirstscfont}[1]{\glsabbrvscfont{#1}}
+\newcommand*{\glsfirstabbrvscfont}{\glsxtrfirstscfont}
+\newcommand*{\glsxtrscsuffix}{\protect\glstextup{\glsxtrabbrvpluralsuffix}}
+\newabbreviationstyle{long-short-sc}%
+{%
+ \glsxtrAccSuppAbbrSetFirstLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongshortname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstlongdefaultfont{\the\glslongtok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvscfont{\the\glsshorttok}}},%
+ firstplural={\protect\glsfirstlongdefaultfont{\the\glslongpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvscfont{\the\glsshortpltok}}},%
+ text={\protect\glsabbrvscfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvscfont{\the\glsshortpltok}},%
+ description={\the\glslongtok}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrscsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvscfont{##1}}%
+ \renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvscfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvscfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvscfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstlongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvscfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstlongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvscfont{\glsaccessshortpl{##1}}}%
+ }%
+}
+\newabbreviationstyle{long-short-sc-desc}%
+{%
+ \glsxtrAccSuppAbbrSetTextShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongshortdescname},
+ sort={\glsxtrlongshortdescsort},%
+ first={\protect\glsfirstlongdefaultfont{\the\glslongtok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvscfont{\the\glsshorttok}}},%
+ firstplural={\protect\glsfirstlongdefaultfont{\the\glslongpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvscfont{\the\glsshortpltok}}},%
+ text={\protect\glsabbrvscfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvscfont{\the\glsshortpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{long-short-sc}%
+}
+\newabbreviationstyle{short-sc-long}%
+{%
+ \glsxtrAccSuppAbbrSetFirstLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortlongname},
+ sort={\the\glsshorttok},
+ description={\the\glslongtok},%
+ first={\protect\glsfirstabbrvscfont{\the\glsshorttok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongtok}}},%
+ firstplural={\protect\glsfirstabbrvscfont{\the\glsshortpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongpltok}}},%
+ text={\protect\glsabbrvscfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvscfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrscsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvscfont{##1}}%
+ \renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvscfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvscfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvscfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvscfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvscfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ }%
+}
+\newabbreviationstyle{short-sc-long-desc}%
+{%
+ \glsxtrAccSuppAbbrSetTextShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortlongdescname},
+ sort={\glsxtrshortlongdescsort},
+ first={\protect\glsfirstabbrvscfont{\the\glsshorttok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongtok}}},%
+ firstplural={\protect\glsfirstabbrvscfont{\the\glsshortpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongpltok}}},%
+ text={\protect\glsabbrvscfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvscfont{\the\glsshortpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{short-sc-long}%
+}
+\newabbreviationstyle{short-sc}%
+{%
+ \glsxtrAccSuppAbbrSetNoLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortnolongname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstabbrvscfont{\the\glsshorttok}},
+ firstplural={\protect\glsfirstabbrvscfont{\the\glsshortpltok}},
+ text={\protect\glsabbrvscfont{\the\glsshorttok}},
+ plural={\protect\glsabbrvscfont{\the\glsshortpltok}},
+ description={\the\glslongtok}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{regular}{true}}%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrscsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvscfont{##1}}%
+ \renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvscfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \protect\glsfirstabbrvscfont{\glsaccessshort{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \protect\glsfirstabbrvscfont{\glsaccessshortpl{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \protect\glsfirstabbrvscfont{\Glsaccessshort{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \protect\glsfirstabbrvscfont{\Glsaccessshortpl{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvscfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvscfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvscfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvscfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+}
+\letabbreviationstyle{short-sc-nolong}{short-sc}
+\newabbreviationstyle{short-sc-desc}%
+{%
+ \glsxtrAccSuppAbbrSetNameLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortdescname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstabbrvscfont{\the\glsshorttok}},
+ firstplural={\protect\glsfirstabbrvscfont{\the\glsshortpltok}},
+ text={\protect\glsabbrvscfont{\the\glsshorttok}},
+ plural={\protect\glsabbrvscfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{regular}{true}}%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrscsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvscfont{##1}}%
+ \renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvscfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvscfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvscfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvscfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvscfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvscfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvscfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvscfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvscfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+}
+\letabbreviationstyle{short-sc-nolong-desc}{short-sc-desc}
+\newabbreviationstyle{nolong-short-sc}%
+{%
+ \GlsXtrUseAbbrStyleSetup{short-sc-nolong}%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{short-sc-nolong}%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \protect\glsfirstlongdefaultfont{\glsaccesslong{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvscfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \protect\glsfirstlongdefaultfont{\glsaccesslongpl{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvscfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \protect\glsfirstlongdefaultfont{\Glsaccesslong{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvscfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \protect\glsfirstlongdefaultfont{\Glsaccesslongpl{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvscfont{\glsaccessshortpl{##1}}}%
+ }%
+}
+\newabbreviationstyle{long-noshort-sc}%
+{%
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongnoshortname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstlongdefaultfont{\the\glslongtok}},
+ firstplural={\protect\glsfirstlongdefaultfont{\the\glslongpltok}},
+ text={\protect\glslongdefaultfont{\the\glslongtok}},
+ plural={\protect\glslongdefaultfont{\the\glslongpltok}},%
+ description={\the\glslongtok}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{regular}{true}}%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrscsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvscfont{##1}}%
+ \renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvscfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrsubsequentfmt}[2]{%
+ \glslongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\glsxtrsubsequentplfmt}[2]{%
+ \glslongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\Glsxtrsubsequentfmt}[2]{%
+ \glslongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
+ \glslongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvscfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvscfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstlongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvscfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstlongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvscfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+}
+\@glsxtr@deprecated@abbrstyle{long-sc}{long-noshort-sc}
+\newabbreviationstyle{long-noshort-sc-desc}%
+{%
+ \GlsXtrUseAbbrStyleSetup{long-noshort-desc}%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrscsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvscfont{##1}}%
+ \renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvscfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrsubsequentfmt}[2]{%
+ \glslongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\glsxtrsubsequentplfmt}[2]{%
+ \glslongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\Glsxtrsubsequentfmt}[2]{%
+ \glslongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
+ \glslongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvscfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvscfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstlongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvscfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstlongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvscfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+}
+\@glsxtr@deprecated@abbrstyle{long-desc-sc}{long-noshort-sc-desc}
+\newabbreviationstyle{short-sc-footnote}%
+{%
+ \glsxtrAccSuppAbbrSetNoLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrfootnotename},
+ sort={\the\glsshorttok},
+ description={\the\glslongtok},%
+ first={\protect\glsfirstabbrvscfont{\the\glsshorttok}%
+ \protect\glsxtrabbrvfootnote{\the\glslabeltok}%
+ {\protect\glsfirstlongfootnotefont{\the\glslongtok}}},%
+ firstplural={\protect\glsfirstabbrvscfont{\the\glsshortpltok}%
+ \protect\glsxtrabbrvfootnote{\the\glslabeltok}%
+ {\protect\glsfirstlongfootnotefont{\the\glslongpltok}}},%
+ text={\protect\glsabbrvscfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvscfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{nohyperfirst}{true}%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrscsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvscfont{##1}}%
+ \renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvscfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongfootnotefont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongfootnotefont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvscfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvscfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvscfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvscfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvscfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvscfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvscfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvscfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+}
+\@glsxtr@deprecated@abbrstyle{footnote-sc}{short-sc-footnote}
+\newabbreviationstyle{short-sc-footnote-desc}%
+{%
+ \glsxtrAccSuppAbbrSetNameLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrfootnotedescname},
+ sort={\glsxtrfootnotedescsort},
+ first={\protect\glsfirstabbrvscfont{\the\glsshorttok}%
+ \protect\glsxtrabbrvfootnote{\the\glslabeltok}%
+ {\protect\glsfirstlongfootnotefont{\the\glslongtok}}},%
+ firstplural={\protect\glsfirstabbrvscfont{\the\glsshortpltok}%
+ \protect\glsxtrabbrvfootnote{\the\glslabeltok}%
+ {\protect\glsfirstlongfootnotefont{\the\glslongpltok}}},%
+ text={\protect\glsabbrvscfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvscfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{nohyperfirst}{true}%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{short-sc-footnote}%
+}
+\newabbreviationstyle{short-sc-postfootnote}%
+{%
+ \glsxtrAccSuppAbbrSetNoLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrfootnotename},
+ sort={\the\glsshorttok},
+ description={\the\glslongtok},%
+ first={\protect\glsfirstabbrvscfont{\the\glsshorttok}},%
+ firstplural={\protect\glsfirstabbrvscfont{\the\glsshortpltok}},%
+ text={\protect\glsabbrvscfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvscfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \csdef{glsxtrpostlink\glscategorylabel}{%
+ \glsxtrifwasfirstuse
+ {%
+ \glsxtrdopostpunc{\protect\glsxtrabbrvfootnote{\glslabel}%
+ {\glsfirstlongfootnotefont{\glsentrylong{\glslabel}}}}%
+ }%
+ {}%
+ }%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+ \renewcommand*{\glsxtrsetupfulldefs}{%
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrscsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvscfont{##1}}%
+ \renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvscfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongfootnotefont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongfootnotefont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvscfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvscfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvscfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvscfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvscfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvscfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvscfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvscfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+}
+\@glsxtr@deprecated@abbrstyle{postfootnote-sc}{short-sc-postfootnote}
+\newabbreviationstyle{short-sc-postfootnote-desc}%
+{%
+ \glsxtrAccSuppAbbrSetNameLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrfootnotedescname},
+ sort={\glsxtrfootnotedescsort},
+ first={\protect\glsfirstabbrvscfont{\the\glsshorttok}},%
+ firstplural={\protect\glsfirstabbrvscfont{\the\glsshortpltok}},%
+ text={\protect\glsabbrvscfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvscfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \csdef{glsxtrpostlink\glscategorylabel}{%
+ \glsxtrifwasfirstuse
+ {%
+ \glsxtrdopostpunc{\protect\glsxtrabbrvfootnote{\glslabel}%
+ {\glsfirstlongfootnotefont{\glsentrylong{\glslabel}}}}%
+ }%
+ {}%
+ }%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+ \renewcommand*{\glsxtrsetupfulldefs}{%
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{short-sc-postfootnote}%
+}
+\newcommand*{\glsxtrsmfont}[1]{\textsmaller{#1}}
+\newcommand*{\glsabbrvsmfont}{\glsxtrsmfont}
+\newcommand*{\glsxtrfirstsmfont}[1]{\glsabbrvsmfont{#1}}
+\newcommand*{\glsfirstabbrvsmfont}{\glsxtrfirstsmfont}
+\newcommand*{\glsxtrsmsuffix}{\glsxtrabbrvpluralsuffix}
+\newabbreviationstyle{long-short-sm}%
+{%
+ \glsxtrAccSuppAbbrSetFirstLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongshortname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstlongdefaultfont{\the\glslongtok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvsmfont{\the\glsshorttok}}},%
+ firstplural={\protect\glsfirstlongdefaultfont{\the\glslongpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvsmfont{\the\glsshortpltok}}},%
+ text={\protect\glsabbrvsmfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvsmfont{\the\glsshortpltok}},%
+ description={\the\glslongtok}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvsmfont{##1}}%
+ \renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvsmfont{##1}}%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrsmsuffix}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvsmfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvsmfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstlongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvsmfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstlongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvsmfont{\glsaccessshortpl{##1}}}%
+ }%
+}
+\newabbreviationstyle{long-short-sm-desc}%
+{%
+ \glsxtrAccSuppAbbrSetTextShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongshortdescname},
+ sort={\glsxtrlongshortdescsort},%
+ first={\protect\glsfirstlongdefaultfont{\the\glslongtok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvsmfont{\the\glsshorttok}}},%
+ firstplural={\protect\glsfirstlongdefaultfont{\the\glslongpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvsmfont{\the\glsshortpltok}}},%
+ text={\protect\glsabbrvsmfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvsmfont{\the\glsshortpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{long-short-sm}%
+}
+\newabbreviationstyle{short-sm-long}%
+{%
+ \glsxtrAccSuppAbbrSetFirstLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortlongname},
+ sort={\the\glsshorttok},
+ description={\the\glslongtok},%
+ first={\protect\glsfirstabbrvsmfont{\the\glsshorttok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongtok}}},%
+ firstplural={\protect\glsfirstabbrvsmfont{\the\glsshortpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongpltok}}},%
+ text={\protect\glsabbrvsmfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvsmfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvsmfont{##1}}%
+ \renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvsmfont{##1}}%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrsmsuffix}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvsmfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvsmfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvsmfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvsmfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ }%
+}
+\newabbreviationstyle{short-sm-long-desc}%
+{%
+ \glsxtrAccSuppAbbrSetTextShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortlongdescname},
+ sort={\glsxtrshortlongdescsort},
+ first={\protect\glsfirstabbrvsmfont{\the\glsshorttok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongtok}}},%
+ firstplural={\protect\glsfirstabbrvsmfont{\the\glsshortpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongpltok}}},%
+ text={\protect\glsabbrvsmfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvsmfont{\the\glsshortpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{short-sm-long}%
+}
+\newabbreviationstyle{short-sm}%
+{%
+ \glsxtrAccSuppAbbrSetNameLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortnolongname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstabbrvsmfont{\the\glsshorttok}},
+ firstplural={\protect\glsfirstabbrvsmfont{\the\glsshortpltok}},
+ text={\protect\glsabbrvsmfont{\the\glsshorttok}},
+ plural={\protect\glsabbrvsmfont{\the\glsshortpltok}},
+ description={\the\glslongtok}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{regular}{true}}%
+}%
+{%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvsmfont{##1}}%
+ \renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvsmfont{##1}}%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrsmsuffix}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \protect\glsfirstabbrvsmfont{\glsaccessshort{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \protect\glsfirstabbrvsmfont{\glsaccessshortpl{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \protect\glsfirstabbrvsmfont{\Glsaccessshort{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \protect\glsfirstabbrvsmfont{\Glsaccessshortpl{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvsmfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvsmfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvsmfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvsmfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+}
+\letabbreviationstyle{short-sm-nolong}{short-sm}
+\newabbreviationstyle{short-sm-desc}%
+{%
+ \glsxtrAccSuppAbbrSetNoLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortdescname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstabbrvsmfont{\the\glsshorttok}},
+ firstplural={\protect\glsfirstabbrvsmfont{\the\glsshortpltok}},
+ text={\protect\glsabbrvsmfont{\the\glsshorttok}},
+ plural={\protect\glsabbrvsmfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{regular}{true}}%
+}%
+{%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvsmfont{##1}}%
+ \renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvsmfont{##1}}%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrsmsuffix}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvsmfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvsmfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvsmfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvsmfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvsmfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvsmfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvsmfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvsmfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+}
+\letabbreviationstyle{short-sm-nolong-desc}{short-sm-desc}
+\newabbreviationstyle{nolong-short-sm}%
+{%
+ \GlsXtrUseAbbrStyleSetup{short-sm-nolong}%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{short-sm-nolong}%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \protect\glsfirstlongdefaultfont{\glsaccesslong{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvsmfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \protect\glsfirstlongdefaultfont{\glsaccesslongpl{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvsmfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \protect\glsfirstlongdefaultfont{\Glsaccesslong{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvsmfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \protect\glsfirstlongdefaultfont{\Glsaccesslongpl{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvsmfont{\glsaccessshortpl{##1}}}%
+ }%
+}
+\newabbreviationstyle{long-noshort-sm}%
+{%
+ \glsxtrAccSuppAbbrSetNameShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongnoshortname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstlongdefaultfont{\the\glslongtok}},
+ firstplural={\protect\glsfirstlongdefaultfont{\the\glslongpltok}},
+ text={\protect\glslongdefaultfont{\the\glslongtok}},
+ plural={\protect\glslongdefaultfont{\the\glslongpltok}},%
+ description={\the\glslongtok}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{regular}{true}}%
+}%
+{%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvsmfont{##1}}%
+ \renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvsmfont{##1}}%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrsmsuffix}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrsubsequentfmt}[2]{%
+ \glslongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\glsxtrsubsequentplfmt}[2]{%
+ \glslongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\Glsxtrsubsequentfmt}[2]{%
+ \glslongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
+ \glslongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvsmfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvsmfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstlongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvsmfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstlongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvsmfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+}
+\@glsxtr@deprecated@abbrstyle{long-sm}{long-noshort-sm}
+\newabbreviationstyle{long-noshort-sm-desc}%
+{%
+ \GlsXtrUseAbbrStyleSetup{long-noshort-desc}%
+}%
+{%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvsmfont{##1}}%
+ \renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvsmfont{##1}}%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrsmsuffix}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrsubsequentfmt}[2]{%
+ \glslongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\glsxtrsubsequentplfmt}[2]{%
+ \glslongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\Glsxtrsubsequentfmt}[2]{%
+ \glslongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
+ \glslongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvsmfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvsmfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstlongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvsmfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstlongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvsmfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+}
+\@glsxtr@deprecated@abbrstyle{long-desc-sm}{long-noshort-sm-desc}
+\newabbreviationstyle{short-sm-footnote}%
+{%
+ \glsxtrAccSuppAbbrSetNoLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrfootnotename},
+ sort={\the\glsshorttok},
+ description={\the\glslongtok},%
+ first={\protect\glsfirstabbrvsmfont{\the\glsshorttok}%
+ \protect\glsxtrabbrvfootnote{\the\glslabeltok}%
+ {\protect\glsfirstlongfootnotefont{\the\glslongtok}}},%
+ firstplural={\protect\glsfirstabbrvsmfont{\the\glsshortpltok}%
+ \protect\glsxtrabbrvfootnote{\the\glslabeltok}%
+ {\protect\glsfirstlongfootnotefont{\the\glslongpltok}}},%
+ text={\protect\glsabbrvsmfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvsmfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{nohyperfirst}{true}%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvsmfont{##1}}%
+ \renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvsmfont{##1}}%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrsmsuffix}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongfootnotefont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongfootnotefont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvsmfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvsmfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvsmfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvsmfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvsmfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvsmfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvsmfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvsmfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+}
+\@glsxtr@deprecated@abbrstyle{footnote-sm}{short-sm-footnote}
+\newabbreviationstyle{short-sm-footnote-desc}%
+{%
+ \glsxtrAccSuppAbbrSetNameLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrfootnotedescname},
+ sort={\glsxtrfootnotedescsort},
+ first={\protect\glsfirstabbrvsmfont{\the\glsshorttok}%
+ \protect\glsxtrabbrvfootnote{\the\glslabeltok}%
+ {\protect\glsfirstlongfootnotefont{\the\glslongtok}}},%
+ firstplural={\protect\glsfirstabbrvsmfont{\the\glsshortpltok}%
+ \protect\glsxtrabbrvfootnote{\the\glslabeltok}%
+ {\protect\glsfirstlongfootnotefont{\the\glslongpltok}}},%
+ text={\protect\glsabbrvsmfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvsmfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{nohyperfirst}{true}%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{short-sm-footnote}%
+}
+\newabbreviationstyle{short-sm-postfootnote}%
+{%
+ \glsxtrAccSuppAbbrSetNoLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrfootnotename},
+ sort={\the\glsshorttok},
+ description={\the\glslongtok},%
+ first={\protect\glsfirstabbrvsmfont{\the\glsshorttok}},%
+ firstplural={\protect\glsfirstabbrvsmfont{\the\glsshortpltok}},%
+ text={\protect\glsabbrvsmfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvsmfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \csdef{glsxtrpostlink\glscategorylabel}{%
+ \glsxtrifwasfirstuse
+ {%
+ \glsxtrdopostpunc{\protect\glsxtrabbrvfootnote{\glslabel}%
+ {\glsfirstlongfootnotefont{\glsentrylong{\glslabel}}}}%
+ }%
+ {}%
+ }%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+ \renewcommand*{\glsxtrsetupfulldefs}{%
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ }%
+}%
+{%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvsmfont{##1}}%
+ \renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvsmfont{##1}}%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrsmsuffix}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongfootnotefont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongfootnotefont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvsmfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvsmfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvsmfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvsmfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvsmfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvsmfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvsmfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvsmfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+}
+\@glsxtr@deprecated@abbrstyle{postfootnote-sm}{short-sm-postfootnote}
+\newabbreviationstyle{short-sm-postfootnote-desc}%
+{%
+ \glsxtrAccSuppAbbrSetNameLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrfootnotedescname},
+ sort={\glsxtrfootnotedescsort},
+ first={\protect\glsfirstabbrvsmfont{\the\glsshorttok}},%
+ firstplural={\protect\glsfirstabbrvsmfont{\the\glsshortpltok}},%
+ text={\protect\glsabbrvsmfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvsmfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \csdef{glsxtrpostlink\glscategorylabel}{%
+ \glsxtrifwasfirstuse
+ {%
+ \glsxtrdopostpunc{\protect\glsxtrabbrvfootnote{\glslabel}%
+ {\glsfirstlongfootnotefont{\glsentrylong{\glslabel}}}}%
+ }%
+ {}%
+ }%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+ \renewcommand*{\glsxtrsetupfulldefs}{%
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{short-sm-postfootnote}%
+}
+\newcommand*{\glsabbrvemfont}[1]{\emph{#1}}%
+\newcommand*{\glsfirstabbrvemfont}[1]{\glsabbrvemfont{#1}}%
+\newcommand*{\glsxtremsuffix}{\glsxtrabbrvpluralsuffix}
+\newcommand*{\glsfirstlongemfont}[1]{\glslongemfont{#1}}%
+\newcommand*{\glslongemfont}[1]{\emph{#1}}%
+\newabbreviationstyle{long-short-em}%
+{%
+ \glsxtrAccSuppAbbrSetFirstLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongshortname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstlongdefaultfont{\the\glslongtok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\the\glsshorttok}}},%
+ firstplural={\protect\glsfirstlongdefaultfont{\the\glslongpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\the\glsshortpltok}}},%
+ text={\protect\glsabbrvemfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvemfont{\the\glsshortpltok}},%
+ description={\the\glslongtok}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvemfont{##1}}%
+ \renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvemfont{##1}}%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstlongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstlongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ }%
+}
+\newabbreviationstyle{long-short-em-desc}%
+{%
+ \glsxtrAccSuppAbbrSetTextShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongshortdescname},
+ sort={\glsxtrlongshortdescsort},%
+ first={\protect\glsfirstlongdefaultfont{\the\glslongtok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\the\glsshorttok}}},%
+ firstplural={\protect\glsfirstlongdefaultfont{\the\glslongpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\the\glsshortpltok}}},%
+ text={\protect\glsabbrvemfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvemfont{\the\glsshortpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{long-short-em}%
+}
+\newabbreviationstyle{long-em-short-em}%
+{%
+ \glsxtrAccSuppAbbrSetFirstLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongshortname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstlongemfont{\the\glslongtok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\the\glsshorttok}}},%
+ firstplural={\protect\glsfirstlongemfont{\the\glslongpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\the\glsshortpltok}}},%
+ text={\protect\glsabbrvemfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvemfont{\the\glsshortpltok}},%
+ description={\protect\glslongemfont{\the\glslongtok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*{\glsabbrvfont}[1]{\glsabbrvemfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvemfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongemfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongemfont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstlongemfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstlongemfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstlongemfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstlongemfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ }%
+}
+\newabbreviationstyle{long-em-short-em-desc}%
+{%
+ \glsxtrAccSuppAbbrSetTextShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongshortdescname},
+ sort={\glsxtrlongshortdescsort},%
+ first={\protect\glsfirstlongemfont{\the\glslongtok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\the\glsshorttok}}},%
+ firstplural={\protect\glsfirstlongemfont{\the\glslongpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\the\glsshortpltok}}},%
+ text={\protect\glsabbrvemfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvemfont{\the\glsshortpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{long-em-short-em}%
+}
+\newabbreviationstyle{short-em-long}%
+{%
+ \glsxtrAccSuppAbbrSetFirstLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortlongname},
+ sort={\the\glsshorttok},
+ description={\the\glslongtok},%
+ first={\protect\glsfirstabbrvemfont{\the\glsshorttok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongtok}}},%
+ firstplural={\protect\glsfirstabbrvemfont{\the\glsshortpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongpltok}}},%
+ text={\protect\glsabbrvemfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvemfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvemfont{##1}}%
+ \renewcommand*\glsfirstabbrvfont[1]{\glsfirstabbrvemfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvemfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvemfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvemfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvemfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ }%
+}
+\newabbreviationstyle{short-em-long-desc}%
+{%
+ \glsxtrAccSuppAbbrSetTextShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortlongdescname},
+ sort={\glsxtrshortlongdescsort},
+ first={\protect\glsfirstabbrvemfont{\the\glsshorttok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongtok}}},%
+ firstplural={\protect\glsfirstabbrvemfont{\the\glsshortpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlongdefaultfont{\the\glslongpltok}}},%
+ text={\protect\glsabbrvemfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvemfont{\the\glsshortpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{short-em-long}%
+}
+\newabbreviationstyle{short-em-long-em}%
+{%
+ \glsxtrAccSuppAbbrSetFirstLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortlongname},
+ sort={\the\glsshorttok},
+ description={\protect\glslongemfont{\the\glslongtok}},%
+ first={\protect\glsfirstabbrvemfont{\the\glsshorttok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlongemfont{\the\glslongtok}}},%
+ firstplural={\protect\glsfirstabbrvemfont{\the\glsshortpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlongemfont{\the\glslongpltok}}},%
+ text={\protect\glsabbrvemfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvemfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*{\glsabbrvfont}[1]{\glsabbrvemfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvemfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongemfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongemfont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvemfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongemfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvemfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongemfont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvemfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongemfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvemfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongemfont{\glsaccesslongpl{##1}}}%
+ }%
+}
+\newabbreviationstyle{short-em-long-em-desc}%
+{%
+ \glsxtrAccSuppAbbrSetTextShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortlongdescname},%
+ sort={\glsxtrshortlongdescsort},%
+ first={\protect\glsfirstabbrvemfont{\the\glsshorttok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlongemfont{\the\glslongtok}}},%
+ firstplural={\protect\glsfirstabbrvemfont{\the\glsshortpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlongemfont{\the\glslongpltok}}},%
+ text={\protect\glsabbrvemfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvemfont{\the\glsshortpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{short-em-long-em}%
+}
+\newabbreviationstyle{short-em}%
+{%
+ \glsxtrAccSuppAbbrSetNoLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortnolongname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstabbrvemfont{\the\glsshorttok}},
+ firstplural={\protect\glsfirstabbrvemfont{\the\glsshortpltok}},
+ text={\protect\glsabbrvemfont{\the\glsshorttok}},
+ plural={\protect\glsabbrvemfont{\the\glsshortpltok}},
+ description={\the\glslongtok}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{regular}{true}}%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvemfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvemfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \protect\glsfirstabbrvemfont{\glsaccessshort{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \protect\glsfirstabbrvemfont{\glsaccessshortpl{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \protect\glsfirstabbrvemfont{\Glsaccessshort{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \protect\glsfirstabbrvemfont{\Glsaccessshortpl{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvemfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvemfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvemfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvemfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+}
+\letabbreviationstyle{short-em-nolong}{short-em}
+\newabbreviationstyle{short-em-desc}%
+{%
+ \glsxtrAccSuppAbbrSetNoLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortdescname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstabbrvemfont{\the\glsshorttok}},
+ firstplural={\protect\glsfirstabbrvemfont{\the\glsshortpltok}},
+ text={\protect\glsabbrvemfont{\the\glsshorttok}},
+ plural={\protect\glsabbrvemfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{regular}{true}}%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvemfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvemfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvemfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvemfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvemfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvemfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongdefaultfont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvemfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvemfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvemfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvemfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+}
+\letabbreviationstyle{short-em-nolong-desc}{short-em-desc}
+\newabbreviationstyle{nolong-short-em}%
+{%
+ \GlsXtrUseAbbrStyleSetup{short-em-nolong}%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{short-em-nolong}%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \protect\glsfirstlongdefaultfont{\glsaccesslong{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \protect\glsfirstlongdefaultfont{\glsaccesslongpl{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \protect\glsfirstlongdefaultfont{\Glsaccesslong{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \protect\glsfirstlongdefaultfont{\Glsaccesslongpl{##1}%
+ \ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ }%
+}
+\newabbreviationstyle{long-noshort-em}%
+{%
+ \glsxtrAccSuppAbbrSetNameShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongnoshortname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstlongdefaultfont{\the\glslongtok}},
+ firstplural={\protect\glsfirstlongdefaultfont{\the\glslongpltok}},
+ text={\protect\glslongdefaultfont{\the\glslongtok}},
+ plural={\protect\glslongdefaultfont{\the\glslongpltok}},%
+ description={\the\glslongtok}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{regular}{true}}%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvemfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvemfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrsubsequentfmt}[2]{%
+ \glslongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\glsxtrsubsequentplfmt}[2]{%
+ \glslongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\Glsxtrsubsequentfmt}[2]{%
+ \glslongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
+ \glslongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstlongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstlongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+}
+\@glsxtr@deprecated@abbrstyle{long-em}{long-noshort-em}
+\newabbreviationstyle{long-em-noshort-em}%
+{%
+ \glsxtrAccSuppAbbrSetNameShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongnoshortname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstlongemfont{\the\glslongtok}},
+ firstplural={\protect\glsfirstlongemfont{\the\glslongpltok}},
+ text={\protect\glslongemfont{\the\glslongtok}},
+ plural={\protect\glslongemfont{\the\glslongpltok}},%
+ description={\protect\glslongemfont{\the\glslongtok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{regular}{true}}%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvemfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvemfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongemfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongemfont{##1}}%
+ \renewcommand*{\glsxtrsubsequentfmt}[2]{%
+ \glslongemfont{\glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\glsxtrsubsequentplfmt}[2]{%
+ \glslongemfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\Glsxtrsubsequentfmt}[2]{%
+ \glslongemfont{\Glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
+ \glslongemfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstlongemfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstlongemfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstlongemfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstlongemfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstlongemfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstlongemfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstlongemfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstlongemfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+}
+\newabbreviationstyle{long-em-noshort-em-noreg}%
+{%
+ \glsxtrAccSuppAbbrSetNameShortAttrs\glscategorylabel
+ \GlsXtrUseAbbrStyleSetup{long-em-noshort-em}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{long-em-noshort-em}%
+}
+\newabbreviationstyle{long-noshort-em-desc}%
+{%
+ \GlsXtrUseAbbrStyleSetup{long-noshort-desc}%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvemfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvemfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongdefaultfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongdefaultfont{##1}}%
+ \renewcommand*{\glsxtrsubsequentfmt}[2]{%
+ \glslongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\glsxtrsubsequentplfmt}[2]{%
+ \glslongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\Glsxtrsubsequentfmt}[2]{%
+ \glslongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
+ \glslongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstlongdefaultfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstlongdefaultfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstlongdefaultfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+}
+\@glsxtr@deprecated@abbrstyle{long-desc-em}{long-noshort-em-desc}
+\newabbreviationstyle{long-em-noshort-em-desc}%
+{%
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongnoshortdescname},
+ sort={\the\glslongtok},
+ first={\protect\glsfirstlongemfont{\the\glslongtok}},
+ firstplural={\protect\glsfirstlongemfont{\the\glslongpltok}},
+ text={\glslongemfont{\the\glslongtok}},
+ plural={\glslongemfont{\the\glslongpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{regular}{true}}%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvemfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvemfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongemfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongemfont{##1}}%
+ \renewcommand*{\glsxtrsubsequentfmt}[2]{%
+ \glslongemfont{\glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\glsxtrsubsequentplfmt}[2]{%
+ \glslongemfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\Glsxtrsubsequentfmt}[2]{%
+ \glslongemfont{\Glsaccesslong{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
+ \glslongemfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside ##2\fi}%
+ \ifglsxtrinsertinside \else##2\fi
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstlongemfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstlongemfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstlongemfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstlongemfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvemfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstlongemfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstlongemfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstlongemfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstlongemfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+}
+\newabbreviationstyle{long-em-noshort-em-desc-noreg}%
+{%
+ \GlsXtrUseAbbrStyleSetup{long-em-noshort-em-desc}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{long-em-noshort-em-desc}%
+}
+\newabbreviationstyle{short-em-footnote}%
+{%
+ \glsxtrAccSuppAbbrSetNoLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrfootnotename},
+ sort={\the\glsshorttok},
+ description={\the\glslongtok},%
+ first={\protect\glsfirstabbrvemfont{\the\glsshorttok}%
+ \protect\glsxtrabbrvfootnote{\the\glslabeltok}%
+ {\protect\glsfirstlongfootnotefont{\the\glslongtok}}},%
+ firstplural={\protect\glsfirstabbrvemfont{\the\glsshortpltok}%
+ \protect\glsxtrabbrvfootnote{\the\glslabeltok}%
+ {\protect\glsfirstlongfootnotefont{\the\glslongpltok}}},%
+ text={\protect\glsabbrvemfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvemfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{nohyperfirst}{true}%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvemfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvemfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongfootnotefont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongfootnotefont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvemfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvemfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvemfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvemfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \protect\glsxtrabbrvfootnote{##1}%
+ {\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvemfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvemfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvemfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvemfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+}
+\@glsxtr@deprecated@abbrstyle{footnote-em}{short-em-footnote}
+\newabbreviationstyle{short-em-footnote-desc}%
+{%
+ \glsxtrAccSuppAbbrSetNameLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrfootnotedescname},
+ sort={\glsxtrfootnotedescsort},
+ first={\protect\glsfirstabbrvemfont{\the\glsshorttok}%
+ \protect\glsxtrabbrvfootnote{\the\glslabeltok}%
+ {\protect\glsfirstlongfootnotefont{\the\glslongtok}}},%
+ firstplural={\protect\glsfirstabbrvemfont{\the\glsshortpltok}%
+ \protect\glsxtrabbrvfootnote{\the\glslabeltok}%
+ {\protect\glsfirstlongfootnotefont{\the\glslongpltok}}},%
+ text={\protect\glsabbrvemfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvemfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glssetattribute{\the\glslabeltok}{nohyperfirst}{true}%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{short-em-footnote}%
+}
+\newabbreviationstyle{short-em-postfootnote}%
+{%
+ \glsxtrAccSuppAbbrSetNoLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrfootnotename},
+ sort={\the\glsshorttok},
+ description={\the\glslongtok},%
+ first={\protect\glsfirstabbrvemfont{\the\glsshorttok}},%
+ firstplural={\protect\glsfirstabbrvemfont{\the\glsshortpltok}},%
+ text={\protect\glsabbrvemfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvemfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \csdef{glsxtrpostlink\glscategorylabel}{%
+ \glsxtrifwasfirstuse
+ {%
+ \glsxtrdopostpunc{\protect\glsxtrabbrvfootnote{\glslabel}%
+ {\glsfirstlongfootnotefont{\glsentrylong{\glslabel}}}}%
+ }%
+ {}%
+ }%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+ \renewcommand*{\glsxtrsetupfulldefs}{%
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtremsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvemfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvemfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongfootnotefont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongfootnotefont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvemfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvemfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvemfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvemfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvemfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvemfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvemfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslong{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvemfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi\glsxtrfullsep{##1}%
+ \glsxtrparen{\glsfirstlongfootnotefont{\glsaccesslongpl{##1}}}%
+ }%
+}
+\@glsxtr@deprecated@abbrstyle{postfootnote-em}{short-em-postfootnote}
+\newabbreviationstyle{short-em-postfootnote-desc}%
+{%
+ \glsxtrAccSuppAbbrSetNameLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrfootnotedescname},
+ sort={\glsxtrfootnotedescsort},
+ first={\protect\glsfirstabbrvemfont{\the\glsshorttok}},%
+ firstplural={\protect\glsfirstabbrvemfont{\the\glsshortpltok}},%
+ text={\protect\glsabbrvemfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvemfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \csdef{glsxtrpostlink\glscategorylabel}{%
+ \glsxtrifwasfirstuse
+ {%
+ \glsxtrdopostpunc{\protect\glsxtrabbrvfootnote{\glslabel}%
+ {\glsfirstlongfootnotefont{\glsentrylong{\glslabel}}}}%
+ }%
+ {}%
+ }%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+ \renewcommand*{\glsxtrsetupfulldefs}{%
+ \let\glsxtrifwasfirstuse\@secondoftwo
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{short-em-postfootnote}%
+}
+\newcommand*{\glsxtruserfield}{useri}
+\ifdef\glscurrentfieldvalue
+{
+ \newcommand*{\glsxtruserparen}[2]{%
+ \glsxtrfullsep{#2}%
+ \glsxtrparen
+ {#1\ifglshasfield{\glsxtruserfield}{#2}{, \glscurrentfieldvalue}{}}%
+ }
+}
+{
+ \newcommand*{\glsxtruserparen}[2]{%
+ \glsxtrfullsep{#2}%
+ \glsxtrparen
+ {#1\ifglshasfield{\glsxtruserfield}{#2}{, \@glo@thisvalue}{}}%
+ }
+}
+\newcommand*{\glsabbrvuserfont}[1]{\glsabbrvdefaultfont{#1}}
+\newcommand*{\glsfirstabbrvuserfont}[1]{\glsabbrvuserfont{#1}}
+\newcommand*{\glslonguserfont}[1]{\glslongdefaultfont{#1}}
+\newcommand*{\glsfirstlonguserfont}[1]{\glslonguserfont{#1}}
+\newcommand*{\glsxtrusersuffix}{\glsxtrabbrvpluralsuffix}
+\newcommand*{\glsuserdescription}[2]{\glslonguserfont{#1}}
+\newabbreviationstyle{long-short-user}%
+{%
+ \glsxtrAccSuppAbbrSetFirstLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongshortname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstlonguserfont{\the\glslongtok}%
+ \protect\glsxtruserparen{\protect\glsfirstabbrvuserfont{\the\glsshorttok}}%
+ {\the\glslabeltok}},%
+ firstplural={\protect\glsfirstlonguserfont{\the\glslongpltok}%
+ \protect\glsxtruserparen
+ {\protect\glsfirstabbrvuserfont{\the\glsshortpltok}}{\the\glslabeltok}},%
+ text={\protect\glsabbrvuserfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvuserfont{\the\glsshortpltok}},%
+ description={\protect\glsuserdescription{\the\glslongtok}%
+ {\the\glslabeltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrusersuffix}%
+ \renewcommand*{\glsabbrvfont}[1]{\glsabbrvuserfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvuserfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlonguserfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslonguserfont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstlonguserfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtruserparen{\glsfirstabbrvuserfont{\glsaccessshort{##1}}}{##1}%
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstlonguserfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtruserparen{\glsfirstabbrvuserfont{\glsaccessshortpl{##1}}}{##1}%
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstlonguserfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtruserparen{\glsfirstabbrvuserfont{\glsaccessshort{##1}}}{##1}%
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstlonguserfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtruserparen{\glsfirstabbrvuserfont{\glsaccessshortpl{##1}}}{##1}%
+ }%
+}
+\newabbreviationstyle{long-postshort-user}%
+{%
+ \glsxtrAccSuppAbbrSetFirstLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongshortname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstlonguserfont{\the\glslongtok}},%
+ firstplural={\protect\glsfirstlonguserfont{\the\glslongpltok}},%
+ text={\protect\glsabbrvuserfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvuserfont{\the\glsshortpltok}},%
+ description={\protect\glsuserdescription{\the\glslongtok}%
+ {\the\glslabeltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \csdef{glsxtrpostlink\glscategorylabel}{%
+ \glsxtrifwasfirstuse
+ {%
+ \glsxtruserparen
+ {\glsfirstabbrvuserfont{\glsentryshort{\glslabel}}}%
+ {\glslabel}%
+ }%
+ {}%
+ }%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrusersuffix}%
+ \renewcommand*{\glsabbrvfont}[1]{\glsabbrvuserfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvuserfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlonguserfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslonguserfont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstlonguserfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstlonguserfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstlonguserfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstlonguserfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstlonguserfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtruserparen{\glsfirstabbrvuserfont{\glsaccessshort{##1}}}{##1}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstlonguserfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtruserparen{\glsfirstabbrvuserfont{\glsaccessshortpl{##1}}}{##1}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstlonguserfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtruserparen{\glsfirstabbrvuserfont{\glsaccessshort{##1}}}{##1}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstlonguserfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtruserparen{\glsfirstabbrvuserfont{\glsaccessshortpl{##1}}}{##1}%
+ }%
+}
+\newcommand*{\glsabbrvscuserfont}{\glsabbrvscfont}%
+\newcommand*{\glsfirstabbrvscuserfont}{\glsabbrvscuserfont}%
+\newcommand*{\glsxtrscusersuffix}{\glsxtrscsuffix}
+\newcommand*{\glsxtrlongshortscusername}{%
+ \protect\glsabbrvscuserfont{\the\glsshorttok}%
+}
+\newabbreviationstyle{long-postshort-sc-user}%
+{%
+ \glsxtrAccSuppAbbrSetFirstLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongshortscusername},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstlonguserfont{\the\glslongtok}},%
+ firstplural={\protect\glsfirstlonguserfont{\the\glslongpltok}},%
+ text={\protect\glsabbrvscuserfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvscuserfont{\the\glsshortpltok}},%
+ description={\protect\glsuserdescription{\the\glslongtok}%
+ {\the\glslabeltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \csdef{glsxtrpostlink\glscategorylabel}{%
+ \glsxtrifwasfirstuse
+ {%
+ \glsxtruserparen
+ {\glsfirstabbrvscuserfont{\glsentryshort{\glslabel}}}%
+ {\glslabel}%
+ }%
+ {}%
+ }%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrscusersuffix}%
+ \renewcommand*{\glsabbrvfont}[1]{\glsabbrvscuserfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvscuserfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlonguserfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslonguserfont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstlonguserfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstlonguserfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstlonguserfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstlonguserfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstlonguserfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtruserparen{\glsfirstabbrvscuserfont{\glsaccessshort{##1}}}{##1}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstlonguserfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtruserparen{\glsfirstabbrvscuserfont{\glsaccessshortpl{##1}}}{##1}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstlonguserfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtruserparen{\glsfirstabbrvscuserfont{\glsaccessshort{##1}}}{##1}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstlonguserfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtruserparen{\glsfirstabbrvscuserfont{\glsaccessshortpl{##1}}}{##1}%
+ }%
+}
+\newcommand*{\glsxtrlongshortuserdescname}{%
+ \protect\glslonguserfont{\the\glslongtok}%
+ \protect\glsxtruserparen
+ {\protect\glsabbrvuserfont{\the\glsshorttok}}{\the\glslabeltok}%
+}
+\newabbreviationstyle{long-postshort-user-desc}%
+{%
+ \glsxtrAccSuppAbbrSetTextShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongshortuserdescname},
+ sort={\the\glslongtok},
+ first={\protect\glsfirstlonguserfont{\the\glslongtok}},%
+ firstplural={\protect\glsfirstlonguserfont{\the\glslongpltok}},%
+ text={\protect\glsabbrvuserfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvuserfont{\the\glsshortpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \csdef{glsxtrpostlink\glscategorylabel}{%
+ \glsxtrifwasfirstuse
+ {%
+ \glsxtruserparen
+ {\glsfirstabbrvuserfont{\glsentryshort{\glslabel}}}%
+ {\glslabel}%
+ }%
+ {}%
+ }%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{long-postshort-user}%
+}
+\newcommand*{\glsxtrlongshortscuserdescname}{%
+ \protect\glslonguserfont{\the\glslongtok}%
+ \protect\glsxtruserparen
+ {\protect\glsabbrvscuserfont{\the\glsshorttok}}{\the\glslabeltok}%
+}
+\newabbreviationstyle{long-postshort-sc-user-desc}%
+{%
+ \glsxtrAccSuppAbbrSetTextShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongshortscuserdescname},
+ sort={\the\glslongtok},
+ first={\protect\glsfirstlonguserfont{\the\glslongtok}},%
+ firstplural={\protect\glsfirstlonguserfont{\the\glslongpltok}},%
+ text={\protect\glsabbrvscuserfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvscuserfont{\the\glsshortpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \csdef{glsxtrpostlink\glscategorylabel}{%
+ \glsxtrifwasfirstuse
+ {%
+ \glsxtruserparen
+ {\glsfirstabbrvscuserfont{\glsentryshort{\glslabel}}}%
+ {\glslabel}%
+ }%
+ {}%
+ }%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{long-postshort-sc-user}%
+}
+\newabbreviationstyle{short-postlong-user}%
+{%
+ \glsxtrAccSuppAbbrSetFirstLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortlongname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstlonguserfont{\the\glslongtok}},%
+ firstplural={\protect\glsfirstlonguserfont{\the\glslongpltok}},%
+ text={\protect\glsabbrvuserfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvuserfont{\the\glsshortpltok}},%
+ description={\protect\glsuserdescription{\the\glslongtok}%
+ {\the\glslabeltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \csdef{glsxtrpostlink\glscategorylabel}{%
+ \glsxtrifwasfirstuse
+ {%
+ \glsxtruserparen
+ {\glsfirstlonguserfont{\glsentrylong{\glslabel}}}%
+ {\glslabel}%
+ }%
+ {}%
+ }%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrusersuffix}%
+ \renewcommand*{\glsabbrvfont}[1]{\glsabbrvuserfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvuserfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlonguserfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslonguserfont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvuserfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvuserfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvuserfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvuserfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvuserfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtruserparen{\glsfirstlonguserfont{\glsaccesslong{##1}}}{##1}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvuserfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtruserparen{\glsfirstlonguserfont{\glsaccesslongpl{##1}}}{##1}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvuserfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtruserparen{\glsfirstlonguserfont{\glsaccesslong{##1}}}{##1}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvuserfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtruserparen{\glsfirstlonguserfont{\glsaccesslongpl{##1}}}{##1}%
+ }%
+}
+\newcommand*{\glsxtrshortlonguserdescname}{%
+ \protect\glsabbrvuserfont{\the\glsshorttok}%
+ \protect\glsxtruserparen
+ {\protect\glslonguserfont{\the\glslongpltok}}%
+ {\the\glslabeltok}%
+}
+\newabbreviationstyle{short-postlong-user-desc}%
+{%
+ \glsxtrAccSuppAbbrSetTextShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortlonguserdescname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstlonguserfont{\the\glslongtok}},%
+ firstplural={\protect\glsfirstlonguserfont{\the\glslongpltok}},%
+ text={\protect\glsabbrvuserfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvuserfont{\the\glsshortpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \csdef{glsxtrpostlink\glscategorylabel}{%
+ \glsxtrifwasfirstuse
+ {%
+ \glsxtruserparen
+ {\glsfirstlonguserfont{\glsentrylong{\glslabel}}}%
+ {\glslabel}%
+ }%
+ {}%
+ }%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{short-postlong-user}%
+}
+\newabbreviationstyle{long-short-user-desc}%
+{%
+ \glsxtrAccSuppAbbrSetTextShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongshortuserdescname},
+ sort={\glsxtrlongshortdescsort},%
+ first={\protect\glsfirstlonguserfont{\the\glslongtok}%
+ \protect\glsxtruserparen{\protect\glsfirstabbrvuserfont{\the\glsshorttok}}%
+ {\the\glslabeltok}},%
+ firstplural={\protect\glsfirstlonguserfont{\the\glslongpltok}%
+ \protect\glsxtruserparen
+ {\protect\glsfirstabbrvuserfont{\the\glsshortpltok}}{\the\glslabeltok}},%
+ text={\protect\glsabbrvfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvfont{\the\glsshortpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{long-short-user}%
+}
+\newabbreviationstyle{short-long-user}%
+{%
+ \glsxtrAccSuppAbbrSetFirstLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortlongname},
+ sort={\the\glsshorttok},
+ description={\protect\glsuserdescription{\the\glslongtok}%
+ {\the\glslabeltok}},%
+ first={\protect\glsfirstabbrvuserfont{\the\glsshorttok}%
+ \protect\glsxtruserparen{\protect\glsfirstlonguserfont{\the\glslongtok}}%
+ {\the\glslabeltok}},%
+ firstplural={\protect\glsfirstabbrvuserfont{\the\glsshortpltok}%
+ \protect\glsxtruserparen{\protect\glsfirstlonguserfont{\the\glslongpltok}}%
+ {\the\glslabeltok}},%
+ text={\protect\glsabbrvuserfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvuserfont{\the\glsshortpltok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrusersuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvuserfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvuserfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlonguserfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslonguserfont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstabbrvuserfont{\glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtruserparen{\glsfirstlonguserfont{\glsaccesslong{##1}}}{##1}%
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstabbrvuserfont{\glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtruserparen{\glsfirstlonguserfont{\glsaccesslongpl{##1}}}{##1}%
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstabbrvuserfont{\Glsaccessshort{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtruserparen{\glsfirstlonguserfont{\glsaccesslong{##1}}}{##1}%
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstabbrvuserfont{\Glsaccessshortpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtruserparen{\glsfirstlonguserfont{\glsaccesslongpl{##1}}}{##1}%
+ }%
+}
+\newabbreviationstyle{short-long-user-desc}%
+{%
+ \glsxtrAccSuppAbbrSetTextShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortlonguserdescname},
+ sort={\glsxtrshortlongdescsort},%
+ first={\protect\glsfirstabbrvuserfont{\the\glsshorttok}%
+ \protect\glsxtruserparen{\protect\glsfirstlonguserfont{\the\glslongtok}}%
+ {\the\glslabeltok}},%
+ firstplural={\protect\glsfirstabbrvuserfont{\the\glsshortpltok}%
+ \protect\glsxtruserparen{\protect\glsfirstlonguserfont{\the\glslongpltok}}%
+ {\the\glslabeltok}},%
+ text={\protect\glsabbrvfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvfont{\the\glsshortpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{short-long-user}%
+}
+\newrobustcmd*{\glsxtrifhyphenstart}[3]{%
+ \ifx\glsinsert#1\relax
+ \expandafter\@glsxtrifhyphenstart#1\relax\relax
+ \@end@glsxtrifhyphenstart{#2}{#3}%
+ \else
+ \@glsxtrifhyphenstart#1\relax\relax\@end@glsxtrifhyphenstart{#2}{#3}%
+ \fi
+}
+\def\@glsxtrifhyphenstart#1#2\@end@glsxtrifhyphenstart#3#4{%
+ \ifx-#1\relax#3\else #4\fi
+}
+\newcommand*{\glsxtrlonghyphenshort}[4]{%
+ {%
+ \glsxtrifhyphenstart{#4}{\def\glsxtrwordsep{-}}{}%
+ \glsfirstlonghyphenfont{#2\ifglsxtrinsertinside{#4}\fi}%
+ \ifglsxtrinsertinside\else{#4}\fi
+ \glsxtrfullsep{#1}%
+ \glsxtrparen{\glsfirstabbrvhyphenfont{#3\ifglsxtrinsertinside{#4}\fi}%
+ \ifglsxtrinsertinside\else{#4}\fi}%
+ }%
+}
+\newcommand*{\glsabbrvhyphenfont}{\glsabbrvdefaultfont}%
+\newcommand*{\glsfirstabbrvhyphenfont}{\glsabbrvhyphenfont}%
+\newcommand*{\glslonghyphenfont}{\glslongdefaultfont}%
+\newcommand*{\glsfirstlonghyphenfont}{\glslonghyphenfont}%
+\newcommand*{\glsxtrhyphensuffix}{\glsxtrabbrvpluralsuffix}
+\newabbreviationstyle{long-hyphen-short-hyphen}%
+{%
+ \glsxtrAccSuppAbbrSetFirstLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongshortname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstlonghyphenfont{\the\glslongtok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvhyphenfont{\the\glsshorttok}}},%
+ firstplural={\protect\glsfirstlonghyphenfont{\the\glslongpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvhyphenfont{\the\glsshortpltok}}},%
+ text={\protect\glsabbrvhyphenfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvhyphenfont{\the\glsshortpltok}},%
+ description={\protect\glslonghyphenfont{\the\glslongtok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrhyphensuffix}%
+ \renewcommand*{\glsabbrvfont}[1]{\glsabbrvhyphenfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvhyphenfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlonghyphenfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslonghyphenfont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsxtrlonghyphenshort{##1}{\glsaccesslong{##1}}{\glsaccessshort{##1}}{##2}%
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsxtrlonghyphenshort{##1}{\glsaccesslongpl{##1}}%
+ {\glsaccessshortpl{##1}}{##2}%
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsxtrlonghyphenshort{##1}{\Glsaccesslong{##1}}{\glsaccessshort{##1}}{##2}%
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsxtrlonghyphenshort{##1}{\Glsaccesslongpl{##1}}%
+ {\glsaccessshortpl{##1}}{##2}%
+ }%
+}
+\newabbreviationstyle{long-hyphen-short-hyphen-desc}%
+{%
+ \glsxtrAccSuppAbbrSetTextShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongshortdescname},
+ sort={\glsxtrlongshortdescsort},
+ first={\protect\glsfirstlonghyphenfont{\the\glslongtok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvhyphenfont{\the\glsshorttok}}},%
+ firstplural={\protect\glsfirstlonghyphenfont{\the\glslongpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstabbrvhyphenfont{\the\glsshortpltok}}},%
+ text={\protect\glsabbrvhyphenfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvhyphenfont{\the\glsshortpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{long-hyphen-short-hyphen}%
+}
+\newcommand*{\glsxtrlonghyphennoshort}[3]{%
+ {%
+ \glsxtrifhyphenstart{#3}{\def\glsxtrwordsep{-}}{}%
+ \glsfirstlonghyphenfont{#2\ifglsxtrinsertinside{#3}\fi}%
+ \ifglsxtrinsertinside\else{#3}\fi
+ }%
+}
+\newabbreviationstyle{long-hyphen-noshort-desc-noreg}%
+{%
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongnoshortdescname},
+ sort={\expandonce\glsxtrorglong},
+ first={\protect\glsfirstlonghyphenfont{\the\glslongtok}},%
+ firstplural={\protect\glsfirstlonghyphenfont{\the\glslongpltok}},%
+ text={\protect\glslonghyphenfont{\the\glslongtok}},%
+ plural={\protect\glslonghyphenfont{\the\glslongpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{long-hyphen-short-hyphen}%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrabbrvpluralsuffix}%
+ \renewcommand*\glsabbrvfont[1]{\glsabbrvdefaultfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvdefaultfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlonghyphenfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslonghyphenfont{##1}}%
+ \renewcommand*{\glsxtrsubsequentfmt}[2]{%
+ \glsxtrlonghyphennoshort{##1}{\glsaccesslong{##1}}{##2}%
+ }%
+ \renewcommand*{\glsxtrsubsequentplfmt}[2]{%
+ \glsxtrlonghyphennoshort{##1}{\glsaccesslongpl{##1}}{##2}%
+ }%
+ \renewcommand*{\Glsxtrsubsequentfmt}[2]{%
+ \glsxtrlonghyphennoshort{##1}{\Glsaccesslong{##1}}{##2}%
+ }%
+ \renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
+ \glsxtrlonghyphennoshort{##1}{\Glsaccesslongpl{##1}}{##2}%
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsxtrlonghyphennoshort{##1}{\glsaccesslong{##1}}{##2}%
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsxtrlonghyphennoshort{##1}{\glsaccesslongpl{##1}}{##2}%
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsxtrlonghyphennoshort{##1}{\Glsaccesslong{##1}}{##2}%
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsxtrlonghyphennoshort{##1}{\Glsaccesslongpl{##1}}{##2}%
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsxtrlonghyphennoshort{##1}{\glsaccesslong{##1}}{##2}%
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsxtrlonghyphennoshort{##1}{\glsaccesslongpl{##1}}{##2}%
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsxtrlonghyphennoshort{##1}{\Glsaccesslong{##1}}{##2}%
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsxtrlonghyphennoshort{##1}{\Glsaccesslongpl{##1}}{##2}%
+ }%
+}
+\newabbreviationstyle{long-hyphen-noshort-noreg}%
+{%
+ \glsxtrAccSuppAbbrSetNameShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongnoshortname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstlonghyphenfont{\the\glslongtok}},%
+ firstplural={\protect\glsfirstlonghyphenfont{\the\glslongpltok}},%
+ text={\protect\glslonghyphenfont{\the\glslongtok}},%
+ plural={\protect\glslonghyphenfont{\the\glslongpltok}},%
+ description={\the\glslongtok}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{long-hyphen-noshort-desc-noreg}%
+}
+\newcommand*{\glsxtrlonghyphen}[3]{%
+ {%
+ \glsxtrifhyphenstart{#3}{\def\glsxtrwordsep{-}}{}%
+ \glsfirstlonghyphenfont{#1}%
+ }%
+}
+\newcommand*{\glsxtrposthyphenshort}[2]{%
+ {%
+ \glsxtrifhyphenstart{#2}{\def\glsxtrwordsep{-}}{}%
+ \ifglsxtrinsertinside{\glsfirstlonghyphenfont{#2}}\else{#2}\fi
+ \glsxtrfullsep{#1}%
+ \glsxtrparen
+ {\glsfirstabbrvhyphenfont{\glsentryshort{#1}\ifglsxtrinsertinside{#2}\fi}%
+ \ifglsxtrinsertinside\else{#2}\fi
+ }%
+ }%
+}
+\newcommand*{\glsxtrposthyphensubsequent}[2]{%
+ \glsabbrvfont{\ifglsxtrinsertinside {#2}\fi}%
+ \ifglsxtrinsertinside \else{#2}\fi
+}
+\newabbreviationstyle{long-hyphen-postshort-hyphen}%
+{%
+ \glsxtrAccSuppAbbrSetFirstLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongshortname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstlonghyphenfont{\the\glslongtok}},%
+ firstplural={\protect\glsfirstlonghyphenfont{\the\glslongpltok}},%
+ text={\protect\glsabbrvhyphenfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvhyphenfont{\the\glsshortpltok}},%
+ description={\protect\glslonghyphenfont{\the\glslongtok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \csdef{glsxtrpostlink\glscategorylabel}{%
+ \glsxtrifwasfirstuse
+ {%
+ \glsxtrposthyphenshort{\glslabel}{\glsinsert}%
+ }%
+ {%
+ \glsxtrposthyphensubsequent{\glslabel}{\glsinsert}%
+ }%
+ }%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrabbrvpluralsuffix}%
+ \renewcommand*{\glsabbrvfont}[1]{\glsabbrvhyphenfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvhyphenfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlonghyphenfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslonghyphenfont{##1}}%
+ \renewcommand*{\glsxtrsubsequentfmt}[2]{%
+ \glsabbrvfont{\glsaccessshort{##1}}%
+ }%
+ \renewcommand*{\glsxtrsubsequentplfmt}[2]{%
+ \glsabbrvfont{\glsaccessshortpl{##1}}%
+ }%
+ \renewcommand*{\Glsxtrsubsequentfmt}[2]{%
+ \glsabbrvfont{\Glsaccessshort{##1}}%
+ }%
+ \renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
+ \glsabbrvfont{\Glsaccessshortpl{##1}}%
+ }%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsxtrlonghyphen{\glsaccesslong{##1}}{##1}{##2}%
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsxtrlonghyphen{\glsaccesslongpl{##1}}{##1}{##2}%
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsxtrlonghyphen{\Glsaccesslong{##1}}{##1}{##2}%
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsxtrlonghyphen{\Glsaccesslongpl{##1}}{##1}{##2}%
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstlonghyphenfont{\glsaccesslong{##1}%
+ \ifglsxtrinsertinside{##2}\fi}%
+ \ifglsxtrinsertinside \else{##2}\fi
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstlonghyphenfont{\glsaccesslongpl{##1}%
+ \ifglsxtrinsertinside{##2}\fi}%
+ \ifglsxtrinsertinside \else{##2}\fi
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstlonghyphenfont{\Glsaccesslong{##1}%
+ \ifglsxtrinsertinside{##2}\fi}%
+ \ifglsxtrinsertinside \else{##2}\fi
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstlonghyphenfont{\Glsaccesslongpl{##1}%
+ \ifglsxtrinsertinside{##2}\fi}%
+ \ifglsxtrinsertinside \else{##2}\fi
+ }%
+}
+\newabbreviationstyle{long-hyphen-postshort-hyphen-desc}%
+{%
+ \glsxtrAccSuppAbbrSetTextShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrlongshortdescname},
+ sort={\glsxtrlongshortdescsort},%
+ first={\protect\glsfirstlonghyphenfont{\the\glslongtok}},%
+ firstplural={\protect\glsfirstlonghyphenfont{\the\glslongpltok}},%
+ text={\protect\glsabbrvhyphenfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvhyphenfont{\the\glsshortpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \csdef{glsxtrpostlink\glscategorylabel}{%
+ \glsxtrifwasfirstuse
+ {%
+ \glsxtrposthyphenshort{\glslabel}{\glsinsert}%
+ }%
+ {%
+ \glsxtrposthyphensubsequent{\glslabel}{\glsinsert}%
+ }%
+ }%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{long-hyphen-postshort-hyphen}%
+}
+\newcommand*{\glsxtrshorthyphenlong}[4]{%
+ {%
+ \glsxtrifhyphenstart{#4}{\def\glsxtrwordsep{-}}{}%
+ \glsfirstabbrvhyphenfont{#2\ifglsxtrinsertinside{#4}\fi}%
+ \ifglsxtrinsertinside\else{#4}\fi
+ \glsxtrfullsep{#1}%
+ \glsxtrparen{\glsfirstlonghyphenfont{#3\ifglsxtrinsertinside{#4}\fi}%
+ \ifglsxtrinsertinside\else{#4}\fi}%
+ }%
+}
+\newabbreviationstyle{short-hyphen-long-hyphen}%
+{%
+ \glsxtrAccSuppAbbrSetFirstLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortlongname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstabbrvhyphenfont{\the\glsshorttok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlonghyphenfont{\the\glslongtok}}},%
+ firstplural={\protect\glsfirstabbrvhyphenfont{\the\glsshortpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlonghyphenfont{\the\glslongpltok}}},%
+ text={\protect\glsabbrvhyphenfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvhyphenfont{\the\glsshortpltok}},%
+ description={\protect\glslonghyphenfont{\the\glslongtok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrhyphensuffix}%
+ \renewcommand*{\glsabbrvfont}[1]{\glsabbrvhyphenfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvhyphenfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlonghyphenfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslonghyphenfont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsxtrshorthyphenlong{##1}{\glsaccessshort{##1}}{\glsaccesslong{##1}}{##2}%
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsxtrshorthyphenlong{##1}%
+ {\glsaccessshortpl{##1}}{\glsaccesslongpl{##1}}{##2}%
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsxtrshorthyphenlong{##1}{\glsaccessshort{##1}}{\Glsaccesslong{##1}}{##2}%
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsxtrshorthyphenlong{##1}%
+ {\glsaccessshortpl{##1}}{\Glsaccesslongpl{##1}}{##2}%
+ }%
+}
+\newabbreviationstyle{short-hyphen-long-hyphen-desc}%
+{%
+ \glsxtrAccSuppAbbrSetTextShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortlongdescname},
+ sort={\glsxtrshortlongdescsort},
+ first={\protect\glsfirstabbrvhyphenfont{\the\glsshorttok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlonghyphenfont{\the\glslongtok}}},%
+ firstplural={\protect\glsfirstabbrvhyphenfont{\the\glsshortpltok}%
+ \protect\glsxtrfullsep{\the\glslabeltok}%
+ \glsxtrparen{\protect\glsfirstlonghyphenfont{\the\glslongpltok}}},%
+ text={\protect\glsabbrvhyphenfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvhyphenfont{\the\glsshortpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{short-hyphen-long-hyphen}%
+}
+\newcommand*{\glsxtrshorthyphen}[3]{%
+ {%
+ \glsxtrifhyphenstart{#3}{\def\glsxtrwordsep{-}}{}%
+ \glsfirstabbrvhyphenfont{#1}%
+ }%
+}
+\newcommand*{\glsxtrposthyphenlong}[2]{%
+ {%
+ \glsxtrifhyphenstart{#2}{\def\glsxtrwordsep{-}}{}%
+ \ifglsxtrinsertinside{\glsfirstabbrvhyphenfont{#2}}\else{#2}\fi
+ \glsxtrfullsep{#1}%
+ \glsxtrparen
+ {\glsfirstlonghyphenfont{\glsentrylong{#1}\ifglsxtrinsertinside{#2}\fi}%
+ \ifglsxtrinsertinside\else{#2}\fi
+ }%
+ }%
+}
+\newabbreviationstyle{short-hyphen-postlong-hyphen}%
+{%
+ \glsxtrAccSuppAbbrSetFirstLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortlongname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstabbrvhyphenfont{\the\glsshorttok}},%
+ firstplural={\protect\glsfirstabbrvhyphenfont{\the\glsshortpltok}},%
+ text={\protect\glsabbrvhyphenfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvhyphenfont{\the\glsshortpltok}},%
+ description={\protect\glslonghyphenfont{\the\glslongtok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \csdef{glsxtrpostlink\glscategorylabel}{%
+ \glsxtrifwasfirstuse
+ {%
+ \glsxtrposthyphenlong{\glslabel}{\glsinsert}%
+ }%
+ {%
+ \glsxtrposthyphensubsequent{\glslabel}{\glsinsert}%
+ }%
+ }%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrabbrvpluralsuffix}%
+ \renewcommand*{\glsabbrvfont}[1]{\glsabbrvhyphenfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvhyphenfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlonghyphenfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslonghyphenfont{##1}}%
+ \renewcommand*{\glsxtrsubsequentfmt}[2]{%
+ \glsabbrvfont{\glsaccessshort{##1}}%
+ }%
+ \renewcommand*{\glsxtrsubsequentplfmt}[2]{%
+ \glsabbrvfont{\glsaccessshortpl{##1}}%
+ }%
+ \renewcommand*{\Glsxtrsubsequentfmt}[2]{%
+ \glsabbrvfont{\Glsaccessshort{##1}}%
+ }%
+ \renewcommand*{\Glsxtrsubsequentplfmt}[2]{%
+ \glsabbrvfont{\Glsaccessshortpl{##1}}%
+ }%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsxtrshorthyphen{\glsaccessshort{##1}}{##1}{##2}%
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsxtrshorthyphen{\glsaccessshortpl{##1}}{##1}{##2}%
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsxtrshorthyphen{\Glsaccessshort{##1}}{##1}{##2}%
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsxtrshorthyphen{\Glsaccessshortpl{##1}}{##1}{##2}%
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvhyphenfont{\glsaccessshort{##1}%
+ \ifglsxtrinsertinside{##2}\fi}%
+ \ifglsxtrinsertinside \else{##2}\fi
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvhyphenfont{\glsaccessshortpl{##1}%
+ \ifglsxtrinsertinside{##2}\fi}%
+ \ifglsxtrinsertinside \else{##2}\fi
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstabbrvhyphenfont{\Glsaccessshort{##1}%
+ \ifglsxtrinsertinside{##2}\fi}%
+ \ifglsxtrinsertinside \else{##2}\fi
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstabbrvhyphenfont{\Glsaccessshortpl{##1}%
+ \ifglsxtrinsertinside{##2}\fi}%
+ \ifglsxtrinsertinside \else{##2}\fi
+ }%
+}
+\newabbreviationstyle{short-hyphen-postlong-hyphen-desc}%
+{%
+ \glsxtrAccSuppAbbrSetTextShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrshortlongdescname},
+ sort={\glsxtrshortlongdescsort},%
+ first={\protect\glsfirstabbrvhyphenfont{\the\glsshorttok}},%
+ firstplural={\protect\glsfirstabbrvhyphenfont{\the\glsshortpltok}},%
+ text={\protect\glsabbrvhyphenfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvhyphenfont{\the\glsshortpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \csdef{glsxtrpostlink\glscategorylabel}{%
+ \glsxtrifwasfirstuse
+ {%
+ \glsxtrposthyphenlong{\glslabel}{\glsinsert}%
+ }%
+ {%
+ \glsxtrposthyphensubsequent{\glslabel}{\glsinsert}%
+ }%
+ }%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{short-hyphen-postlong-hyphen}%
+}
+\newcommand*{\glsabbrvonlyfont}{\glsabbrvdefaultfont}%
+\newcommand*{\glsfirstabbrvonlyfont}{\glsabbrvonlyfont}%
+\newcommand*{\glslongonlyfont}{\glslongdefaultfont}%
+\newcommand*{\glsfirstlongonlyfont}{\glslongonlyfont}%
+\newcommand*{\glsxtronlysuffix}{\glsxtrabbrvpluralsuffix}
+\newcommand*{\glsxtronlyname}{%
+ \protect\glsabbrvonlyfont{\the\glsshorttok}%
+}
+\newabbreviationstyle{long-only-short-only}%
+{%
+ \glsxtrAccSuppAbbrSetFirstLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtronlyname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstlongonlyfont{\the\glslongtok}},%
+ firstplural={\protect\glsfirstlongonlyfont{\the\glslongpltok}},%
+ text={\protect\glsabbrvonlyfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvonlyfont{\the\glsshortpltok}},%
+ description={\protect\glslongonlyfont{\the\glslongtok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtronlysuffix}%
+ \renewcommand*{\glsabbrvfont}[1]{\glsabbrvonlyfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvonlyfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongonlyfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongonlyfont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstlongonlyfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstlongonlyfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstlongonlyfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstlongonlyfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstlongonlyfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvonlyfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstlongonlyfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvonlyfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstlongonlyfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvonlyfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstlongonlyfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvonlyfont{\Glsaccessshortpl{##1}}}%
+ }%
+}
+\newcommand*{\glsxtronlydescsort}{\the\glslongtok}
+\newcommand*{\glsxtronlydescname}{%
+ \protect\glslongfont{\the\glslongtok}%
+}
+\newabbreviationstyle{long-only-short-only-desc}%
+{%
+ \glsxtrAccSuppAbbrSetTextShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtronlydescname},
+ sort={\glsxtronlydescsort},%
+ first={\protect\glsfirstlongonlyfont{\the\glslongtok}},%
+ firstplural={\protect\glsfirstlongonlyfont{\the\glslongpltok}},%
+ text={\protect\glsabbrvonlyfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvonlyfont{\the\glsshortpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{long-only-short-only}%
+}
+\newcommand*{\glsabbrvsconlyfont}{\glsabbrvscfont}%
+\newcommand*{\glsfirstabbrvsconlyfont}{\glsabbrvsconlyfont}%
+\newcommand*{\glsxtrsconlysuffix}{\glsxtrscsuffix}
+\newcommand*{\glsxtrsconlyname}{%
+ \protect\glsabbrvsconlyfont{\the\glsshorttok}%
+}
+\newabbreviationstyle{long-only-short-sc-only}%
+{%
+ \glsxtrAccSuppAbbrSetFirstLongAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrsconlyname},
+ sort={\the\glsshorttok},
+ first={\protect\glsfirstlongonlyfont{\the\glslongtok}},%
+ firstplural={\protect\glsfirstlongonlyfont{\the\glslongpltok}},%
+ text={\protect\glsabbrvsconlyfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvsconlyfont{\the\glsshortpltok}},%
+ description={\protect\glslongonlyfont{\the\glslongtok}}}%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \renewcommand*{\abbrvpluralsuffix}{\glsxtrsconlysuffix}%
+ \renewcommand*{\glsabbrvfont}[1]{\glsabbrvsconlyfont{##1}}%
+ \renewcommand*{\glsfirstabbrvfont}[1]{\glsfirstabbrvsconlyfont{##1}}%
+ \renewcommand*{\glsfirstlongfont}[1]{\glsfirstlongonlyfont{##1}}%
+ \renewcommand*{\glslongfont}[1]{\glslongonlyfont{##1}}%
+ \renewcommand*{\glsxtrfullformat}[2]{%
+ \glsfirstlongonlyfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrfullplformat}[2]{%
+ \glsfirstlongonlyfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullformat}[2]{%
+ \glsfirstlongonlyfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\Glsxtrfullplformat}[2]{%
+ \glsfirstlongonlyfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ }%
+ \renewcommand*{\glsxtrinlinefullformat}[2]{%
+ \glsfirstlongonlyfont{\glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvsconlyfont{\glsaccessshort{##1}}}%
+ }%
+ \renewcommand*{\glsxtrinlinefullplformat}[2]{%
+ \glsfirstlongonlyfont{\glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvsconlyfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullformat}[2]{%
+ \glsfirstlongonlyfont{\Glsaccesslong{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvsconlyfont{\glsaccessshortpl{##1}}}%
+ }%
+ \renewcommand*{\Glsxtrinlinefullplformat}[2]{%
+ \glsfirstlongonlyfont{\Glsaccesslongpl{##1}\ifglsxtrinsertinside##2\fi}%
+ \ifglsxtrinsertinside\else##2\fi
+ \glsxtrfullsep{##1}%
+ \glsxtrparen{\protect\glsfirstabbrvsconlyfont{\Glsaccessshortpl{##1}}}%
+ }%
+}
+\newcommand*{\glsxtrsconlydescsort}{\glsxtronlydescsort}
+\newcommand*{\glsxtrsconlydescname}{\glsxtronlydescname}
+\newabbreviationstyle{long-only-short-sc-only-desc}%
+{%
+ \glsxtrAccSuppAbbrSetTextShortAttrs\glscategorylabel
+ \renewcommand*{\CustomAbbreviationFields}{%
+ name={\glsxtrsconlydescname},
+ sort={\glsxtrsconlydescsort},%
+ first={\protect\glsfirstlongonlyfont{\the\glslongtok}},%
+ firstplural={\protect\glsfirstlongonlyfont{\the\glslongpltok}},%
+ text={\protect\glsabbrvsconlyfont{\the\glsshorttok}},%
+ plural={\protect\glsabbrvsconlyfont{\the\glsshortpltok}}%
+ }%
+ \renewcommand*{\GlsXtrPostNewAbbreviation}{%
+ \glshasattribute{\the\glslabeltok}{regular}%
+ {%
+ \glssetattribute{\the\glslabeltok}{regular}{false}%
+ }%
+ {}%
+ }%
+}%
+{%
+ \GlsXtrUseAbbrStyleFmts{long-only-short-sc-only}%
+}
+\let\@glsxtr@org@markright\markright
+\renewcommand*{\markright}[1]{%
+ \glsxtrmarkhook
+ \@glsxtr@org@markright{\@glsxtrinmark#1\@glsxtrnotinmark}%
+ \glsxtrrestoremarkhook
+}
+\let\@glsxtr@org@markboth\markboth
+\renewcommand*{\markboth}[2]{%
+ \glsxtrmarkhook
+ \@glsxtr@org@markboth
+ {\@glsxtrinmark#1\@glsxtrnotinmark}%
+ {\@glsxtrinmark#2\@glsxtrnotinmark}%
+ \glsxtrrestoremarkhook
+}
+\let\@glsxtr@org@@starttoc\@starttoc
+\renewcommand*{\@starttoc}[1]{%
+ \glsxtrmarkhook
+ \@glsxtrinmark
+ \@glsxtr@org@@starttoc{#1}%
+ \@glsxtrnotinmark
+ \glsxtrrestoremarkhook
+}
+\newcommand*{\glsxtrRevertMarks}{%
+ \let\markright\@glsxtr@org@markright
+ \let\markboth\@glsxtr@org@markboth
+ \let\@starttoc\@glsxtr@org@@starttoc
+}
+\newcommand*{\glsxtrRevertTocMarks}{%
+ \let\@starttoc\@glsxtr@org@@starttoc
+}
+\newcommand*{\glsxtrifinmark}[2]{#2}
+\newrobustcmd*{\@glsxtrinmark}{%
+ \let\glsxtrifinmark\@firstoftwo
+}
+\newrobustcmd*{\@glsxtrnotinmark}{%
+ \let\glsxtrifinmark\@secondoftwo
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\glsxtrtitleorpdforheading}[3]{\texorpdfstring{#1}{#2}}
+}
+{
+ \newcommand*{\glsxtrtitleorpdforheading}[3]{#1}
+}
+\newcommand*{\glsxtrmarkhook}{%
+ \let\@glsxtr@org@MakeUppercase\MakeUppercase
+ \let\@glsxtr@org@glsxtrtitleorpdforheading\glsxtrtitleorpdforheading
+ \let\@glsxtr@org@glsxtrtitleshort\glsxtrtitleshort
+ \let\@glsxtr@org@glsxtrtitleshortpl\glsxtrtitleshortpl
+ \let\@glsxtr@org@Glsxtrtitleshort\Glsxtrtitleshort
+ \let\@glsxtr@org@Glsxtrtitleshortpl\Glsxtrtitleshortpl
+ \let\@glsxtr@org@glsxtrtitlename\glsxtrtitlename
+ \let\@glsxtr@org@Glsxtrtitlename\Glsxtrtitlename
+ \let\@glsxtr@org@glsxtrtitletext\glsxtrtitletext
+ \let\@glsxtr@org@Glsxtrtitletext\Glsxtrtitletext
+ \let\@glsxtr@org@glsxtrtitleplural\glsxtrtitleplural
+ \let\@glsxtr@org@Glsxtrtitleplural\Glsxtrtitleplural
+ \let\@glsxtr@org@glsxtrtitlefirst\glsxtrtitlefirst
+ \let\@glsxtr@org@Glsxtrtitlefirst\Glsxtrtitlefirst
+ \let\@glsxtr@org@glsxtrtitlefirstplural\glsxtrtitlefirstplural
+ \let\@glsxtr@org@Glsxtrtitlefirstplural\Glsxtrtitlefirstplural
+ \let\@glsxtr@org@glsxtrtitlelong\glsxtrtitlelong
+ \let\@glsxtr@org@glsxtrtitlelongpl\glsxtrtitlelongpl
+ \let\@glsxtr@org@Glsxtrtitlelong\Glsxtrtitlelong
+ \let\@glsxtr@org@Glsxtrtitlelongpl\Glsxtrtitlelongpl
+ \let\@glsxtr@org@glsxtrtitlefull\glsxtrtitlefull
+ \let\@glsxtr@org@glsxtrtitlefullpl\glsxtrtitlefullpl
+ \let\@glsxtr@org@Glsxtrtitlefull\Glsxtrtitlefull
+ \let\@glsxtr@org@Glsxtrtitlefullpl\Glsxtrtitlefullpl
+ \let\glsxtrifinmark\@firstoftwo
+ \let\MakeUppercase\MakeTextUppercase
+ \let\glsxtrtitleorpdforheading\@thirdofthree
+ \let\glsxtrtitleshort\glsxtrheadshort
+ \let\glsxtrtitleshortpl\glsxtrheadshortpl
+ \let\Glsxtrtitleshort\Glsxtrheadshort
+ \let\Glsxtrtitleshortpl\Glsxtrheadshortpl
+ \let\glsxtrtitlename\glsxtrheadname
+ \let\Glsxtrtitlename\Glsxtrheadname
+ \let\glsxtrtitletext\glsxtrheadtext
+ \let\Glsxtrtitletext\Glsxtrheadtext
+ \let\glsxtrtitleplural\glsxtrheadplural
+ \let\Glsxtrtitleplural\Glsxtrheadplural
+ \let\glsxtrtitlefirst\glsxtrheadfirst
+ \let\Glsxtrtitlefirst\Glsxtrheadfirst
+ \let\glsxtrtitlefirstplural\glsxtrheadfirstplural
+ \let\Glsxtrtitlefirstplural\Glsxtrheadfirstplural
+ \let\glsxtrtitlelong\glsxtrheadlong
+ \let\glsxtrtitlelongpl\glsxtrheadlongpl
+ \let\Glsxtrtitlelong\Glsxtrheadlong
+ \let\Glsxtrtitlelongpl\Glsxtrheadlongpl
+ \let\glsxtrtitlefull\glsxtrheadfull
+ \let\glsxtrtitlefullpl\glsxtrheadfullpl
+ \let\Glsxtrtitlefull\Glsxtrheadfull
+ \let\Glsxtrtitlefullpl\Glsxtrheadfullpl
+}
+\newcommand*{\glsxtrrestoremarkhook}{%
+ \let\glsxtrifinmark\@secondoftwo
+ \let\MakeUppercase\@glsxtr@org@MakeUppercase
+ \let\glsxtrtitleorpdforheading\@glsxtr@org@glsxtrtitleorpdforheading
+ \let\glsxtrtitleshort\@glsxtr@org@glsxtrtitleshort
+ \let\glsxtrtitleshortpl\@glsxtr@org@glsxtrtitleshortpl
+ \let\Glsxtrtitleshort\@glsxtr@org@Glsxtrtitleshort
+ \let\Glsxtrtitleshortpl\@glsxtr@org@Glsxtrtitleshortpl
+ \let\glsxtrtitlename\@glsxtr@org@glsxtrtitlename
+ \let\Glsxtrtitlename\@glsxtr@org@Glsxtrtitlename
+ \let\glsxtrtitletext\@glsxtr@org@glsxtrtitletext
+ \let\Glsxtrtitletext\@glsxtr@org@Glsxtrtitletext
+ \let\glsxtrtitleplural\@glsxtr@org@glsxtrtitleplural
+ \let\Glsxtrtitleplural\@glsxtr@org@Glsxtrtitleplural
+ \let\glsxtrtitlefirst\@glsxtr@org@glsxtrtitlefirst
+ \let\Glsxtrtitlefirst\@glsxtr@org@Glsxtrtitlefirst
+ \let\glsxtrtitlefirstplural\@glsxtr@org@glsxtrtitlefirstplural
+ \let\Glsxtrtitlefirstplural\@glsxtr@org@Glsxtrtitlefirstplural
+ \let\glsxtrtitlelong\@glsxtr@org@glsxtrtitlelong
+ \let\glsxtrtitlelongpl\@glsxtr@org@glsxtrtitlelongpl
+ \let\Glsxtrtitlelong\@glsxtr@org@Glsxtrtitlelong
+ \let\Glsxtrtitlelongpl\@glsxtr@org@Glsxtrtitlelongpl
+ \let\glsxtrtitlefull\@glsxtr@org@glsxtrtitlefull
+ \let\glsxtrtitlefullpl\@glsxtr@org@glsxtrtitlefullpl
+ \let\Glsxtrtitlefull\@glsxtr@org@Glsxtrtitlefull
+ \let\Glsxtrtitlefullpl\@glsxtr@org@Glsxtrtitlefullpl
+}
+\newcommand*{\glsxtrheadshort}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \GLSxtrshort[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \glsxtrshort[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+\newrobustcmd*{\glsxtrtitleshort}[1]{%
+ \glsxtrshort[noindex,hyper=false]{#1}[]%
+}
+\newcommand*{\glsxtrheadshortpl}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \GLSxtrshortpl[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \glsxtrshortpl[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+\newrobustcmd*{\glsxtrtitleshortpl}[1]{%
+ \glsxtrshortpl[noindex,hyper=false]{#1}[]%
+}
+\newcommand*{\Glsxtrheadshort}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \GLSxtrshort[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \Glsxtrshort[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+\newrobustcmd*{\Glsxtrtitleshort}[1]{%
+ \Glsxtrshort[noindex,hyper=false]{#1}[]%
+}
+\newrobustcmd*{\GLSxtrtitleshort}[1]{%
+ \GLSxtrshort[noindex,hyper=false]{#1}[]%
+}
+\newcommand*{\Glsxtrheadshortpl}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \GLSxtrshortpl[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \Glsxtrshortpl[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+\newrobustcmd*{\Glsxtrtitleshortpl}[1]{%
+ \Glsxtrshortpl[noindex,hyper=false]{#1}[]%
+}
+\newrobustcmd*{\GLSxtrtitleshortpl}[1]{%
+ \GLSxtrshortpl[noindex,hyper=false]{#1}[]%
+}
+\newcommand*{\glsxtrheadname}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \GLSname[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \glsname[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+\newrobustcmd*{\glsxtrtitlename}[1]{%
+ \glsname[noindex,hyper=false]{#1}[]%
+}
+\newcommand*{\Glsxtrheadname}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \GLSname[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \Glsname[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+\newrobustcmd*{\Glsxtrtitlename}[1]{%
+ \Glsname[noindex,hyper=false]{#1}[]%
+}
+\newrobustcmd*{\GLSxtrtitlename}[1]{%
+ \GLSname[noindex,hyper=false]{#1}[]%
+}
+\newcommand*{\glsxtrheadtext}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \GLStext[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \glstext[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+\newrobustcmd*{\glsxtrtitletext}[1]{%
+ \glstext[noindex,hyper=false]{#1}[]%
+}
+\newcommand*{\Glsxtrheadtext}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \GLStext[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \Glstext[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+\newrobustcmd*{\Glsxtrtitletext}[1]{%
+ \Glstext[noindex,hyper=false]{#1}[]%
+}
+\newrobustcmd*{\GLSxtrtitletext}[1]{%
+ \GLStext[noindex,hyper=false]{#1}[]%
+}
+\newcommand*{\glsxtrheadplural}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \GLSplural[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \glsplural[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+\newrobustcmd*{\glsxtrtitleplural}[1]{%
+ \glsplural[noindex,hyper=false]{#1}[]%
+}
+\newcommand*{\Glsxtrheadplural}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \GLSplural[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \Glsplural[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+\newrobustcmd*{\Glsxtrtitleplural}[1]{%
+ \Glsplural[noindex,hyper=false]{#1}[]%
+}
+\newrobustcmd*{\GLSxtrtitleplural}[1]{%
+ \GLSplural[noindex,hyper=false]{#1}[]%
+}
+\newcommand*{\glsxtrheadfirst}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \GLSfirst[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \glsfirst[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+\newrobustcmd*{\glsxtrtitlefirst}[1]{%
+ \glsfirst[noindex,hyper=false]{#1}[]%
+}
+\newcommand*{\Glsxtrheadfirst}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \GLSfirst[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \Glsfirst[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+\newrobustcmd*{\Glsxtrtitlefirst}[1]{%
+ \Glsfirst[noindex,hyper=false]{#1}[]%
+}
+\newrobustcmd*{\GLSxtrtitlefirst}[1]{%
+ \GLSfirst[noindex,hyper=false]{#1}[]%
+}
+\newcommand*{\glsxtrheadfirstplural}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \GLSfirstplural[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \glsfirstplural[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+\newrobustcmd*{\glsxtrtitlefirstplural}[1]{%
+ \glsfirstplural[noindex,hyper=false]{#1}[]%
+}
+\newcommand*{\Glsxtrheadfirstplural}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \GLSfirstplural[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \Glsfirstplural[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+\newrobustcmd*{\Glsxtrtitlefirstplural}[1]{%
+ \Glsfirstplural[noindex,hyper=false]{#1}[]%
+}
+\newrobustcmd*{\GLSxtrtitlefirstplural}[1]{%
+ \GLSfirstplural[noindex,hyper=false]{#1}[]%
+}
+\newcommand*{\glsxtrheadlong}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \GLSxtrlong[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \glsxtrlong[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+\newrobustcmd*{\glsxtrtitlelong}[1]{%
+ \glsxtrlong[noindex,hyper=false]{#1}[]%
+}
+\newcommand*{\glsxtrheadlongpl}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \GLSxtrlongpl[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \glsxtrlongpl[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+\newrobustcmd*{\glsxtrtitlelongpl}[1]{%
+ \glsxtrlongpl[noindex,hyper=false]{#1}[]%
+}
+\newcommand*{\Glsxtrheadlong}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \GLSxtrlong[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \Glsxtrlong[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+\newrobustcmd*{\Glsxtrtitlelong}[1]{%
+ \Glsxtrlong[noindex,hyper=false]{#1}[]%
+}
+\newrobustcmd*{\GLSxtrtitlelong}[1]{%
+ \GLSxtrlong[noindex,hyper=false]{#1}[]%
+}
+\newcommand*{\Glsxtrheadlongpl}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \GLSxtrlongpl[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \Glsxtrlongpl[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+\newrobustcmd*{\Glsxtrtitlelongpl}[1]{%
+ \Glsxtrlongpl[noindex,hyper=false]{#1}[]%
+}
+\newrobustcmd*{\GLSxtrtitlelongpl}[1]{%
+ \GLSxtrlongpl[noindex,hyper=false]{#1}[]%
+}
+\newcommand*{\glsxtrheadfull}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \GLSxtrfull[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \glsxtrfull[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+\newrobustcmd*{\glsxtrtitlefull}[1]{%
+ \glsxtrfull[noindex,hyper=false]{#1}[]%
+}
+\newcommand*{\glsxtrheadfullpl}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \GLSxtrfullpl[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \glsxtrfullpl[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+\newrobustcmd*{\glsxtrtitlefullpl}[1]{%
+ \glsxtrfullpl[noindex,hyper=false]{#1}[]%
+}
+\newcommand*{\Glsxtrheadfull}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \GLSxtrfull[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \Glsxtrfull[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+\newrobustcmd*{\Glsxtrtitlefull}[1]{%
+ \Glsxtrfull[noindex,hyper=false]{#1}[]%
+}
+\newrobustcmd*{\GLSxtrtitlefull}[1]{%
+ \GLSxtrfull[noindex,hyper=false]{#1}[]%
+}
+\newcommand*{\Glsxtrheadfullpl}[1]{%
+ \protect\NoCaseChange
+ {%
+ \glsifattribute{#1}{headuc}{true}%
+ {%
+ \GLSxtrfullpl[noindex,hyper=false]{#1}[]%
+ }%
+ {%
+ \Glsxtrfullpl[noindex,hyper=false]{#1}[]%
+ }%
+ }%
+}
+\newrobustcmd*{\Glsxtrtitlefullpl}[1]{%
+ \Glsxtrfullpl[noindex,hyper=false]{#1}[]%
+}
+\newrobustcmd*{\GLSxtrtitlefullpl}[1]{%
+ \GLSxtrfullpl[noindex,hyper=false]{#1}[]%
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\glsfmtshort}[1]{%
+ \texorpdfstring
+ {\glsxtrtitleshort{#1}}%
+ {\glsentryshort{#1}}%
+ }
+}
+{
+ \newcommand*{\glsfmtshort}[1]{%
+ \glsxtrtitleshort{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\glsfmtshortpl}[1]{%
+ \texorpdfstring
+ {\glsxtrtitleshortpl{#1}}%
+ {\glsentryshortpl{#1}}%
+ }
+}
+{
+ \newcommand*{\glsfmtshortpl}[1]{%
+ \glsxtrtitleshortpl{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\Glsfmtshort}[1]{%
+ \texorpdfstring
+ {\Glsxtrtitleshort{#1}}%
+ {\glsentryshort{#1}}%
+ }
+}
+{
+ \newcommand*{\Glsfmtshort}[1]{%
+ \Glsxtrtitleshort{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\Glsfmtshortpl}[1]{%
+ \texorpdfstring
+ {\Glsxtrtitleshortpl{#1}}%
+ {\glsentryshortpl{#1}}%
+ }
+}
+{
+ \newcommand*{\Glsfmtshortpl}[1]{%
+ \Glsxtrtitleshortpl{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\glsfmtname}[1]{%
+ \texorpdfstring
+ {\glsxtrtitlename{#1}}%
+ {\glsentryname{#1}}%
+ }
+}
+{
+ \newcommand*{\glsfmtname}[1]{%
+ \glsxtrtitlename{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\Glsfmtname}[1]{%
+ \texorpdfstring
+ {\Glsxtrtitlename{#1}}%
+ {\glsentryname{#1}}%
+ }
+}
+{
+ \newcommand*{\Glsfmtname}[1]{%
+ \Glsxtrtitlename{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\GLSfmtname}[1]{%
+ \texorpdfstring
+ {\GLSxtrtitlename{#1}}%
+ {\glsentryname{#1}}%
+ }
+}
+{
+ \newcommand*{\GLSfmtname}[1]{%
+ \GLSxtrtitlename{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\glsfmttext}[1]{%
+ \texorpdfstring
+ {\glsxtrtitletext{#1}}%
+ {\glsentrytext{#1}}%
+ }
+}
+{
+ \newcommand*{\glsfmttext}[1]{%
+ \glsxtrtitletext{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\Glsfmttext}[1]{%
+ \texorpdfstring
+ {\Glsxtrtitletext{#1}}%
+ {\glsentrytext{#1}}%
+ }
+}
+{
+ \newcommand*{\Glsfmttext}[1]{%
+ \Glsxtrtitletext{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\GLSfmttext}[1]{%
+ \texorpdfstring
+ {\GLSxtrtitletext{#1}}%
+ {\glsentrytext{#1}}%
+ }
+}
+{
+ \newcommand*{\GLSfmttext}[1]{%
+ \GLSxtrtitletext{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\glsfmtplural}[1]{%
+ \texorpdfstring
+ {\glsxtrtitleplural{#1}}%
+ {\glsentryplural{#1}}%
+ }
+}
+{
+ \newcommand*{\glsfmtplural}[1]{%
+ \glsxtrtitleplural{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\Glsfmtplural}[1]{%
+ \texorpdfstring
+ {\Glsxtrtitleplural{#1}}%
+ {\glsentryplural{#1}}%
+ }
+}
+{
+ \newcommand*{\Glsfmtplural}[1]{%
+ \Glsxtrtitleplural{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\GLSfmtplural}[1]{%
+ \texorpdfstring
+ {\GLSxtrtitleplural{#1}}%
+ {\glsentryplural{#1}}%
+ }
+}
+{
+ \newcommand*{\GLSfmtplural}[1]{%
+ \GLSxtrtitleplural{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\glsfmtfirst}[1]{%
+ \texorpdfstring
+ {\glsxtrtitlefirst{#1}}%
+ {\glsentryfirst{#1}}%
+ }
+}
+{
+ \newcommand*{\glsfmtfirst}[1]{%
+ \glsxtrtitlefirst{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\Glsfmtfirst}[1]{%
+ \texorpdfstring
+ {\Glsxtrtitlefirst{#1}}%
+ {\glsentryfirst{#1}}%
+ }
+}
+{
+ \newcommand*{\Glsfmtfirst}[1]{%
+ \Glsxtrtitlefirst{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\GLSfmtfirst}[1]{%
+ \texorpdfstring
+ {\GLSxtrtitlefirst{#1}}%
+ {\glsentryfirst{#1}}%
+ }
+}
+{
+ \newcommand*{\GLSfmtfirst}[1]{%
+ \Glsxtrtitlefirst{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\glsfmtfirstpl}[1]{%
+ \texorpdfstring
+ {\glsxtrtitlefirstplural{#1}}%
+ {\glsentryfirstplural{#1}}%
+ }
+}
+{
+ \newcommand*{\glsfmtfirstpl}[1]{%
+ \glsxtrtitlefirstplural{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\Glsfmtfirstpl}[1]{%
+ \texorpdfstring
+ {\Glsxtrtitlefirstplural{#1}}%
+ {\glsentryfirstplural{#1}}%
+ }
+}
+{
+ \newcommand*{\Glsfmtfirstpl}[1]{%
+ \Glsxtrtitlefirstplural{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\GLSfmtfirstpl}[1]{%
+ \texorpdfstring
+ {\GLSxtrtitlefirstplural{#1}}%
+ {\glsentryfirstplural{#1}}%
+ }
+}
+{
+ \newcommand*{\GLSfmtfirstpl}[1]{%
+ \GLSxtrtitlefirstplural{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\glsfmtlong}[1]{%
+ \texorpdfstring
+ {\glsxtrtitlelong{#1}}%
+ {\glsentrylong{#1}}%
+ }
+}
+{
+ \newcommand*{\glsfmtlong}[1]{%
+ \glsxtrtitlelong{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\Glsfmtlong}[1]{%
+ \texorpdfstring
+ {\Glsxtrtitlelong{#1}}%
+ {\glsentrylong{#1}}%
+ }
+}
+{
+ \newcommand*{\Glsfmtlong}[1]{%
+ \Glsxtrtitlelong{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\GLSfmtlong}[1]{%
+ \texorpdfstring
+ {\GLSxtrtitlelong{#1}}%
+ {\glsentrylong{#1}}%
+ }
+}
+{
+ \newcommand*{\GLSfmtlong}[1]{%
+ \GLSxtrtitlelong{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\glsfmtlongpl}[1]{%
+ \texorpdfstring
+ {\glsxtrtitlelongpl{#1}}%
+ {\glsentrylongpl{#1}}%
+ }
+}
+{
+ \newcommand*{\glsfmtlongpl}[1]{%
+ \glsxtrtitlelongpl{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\Glsfmtlongpl}[1]{%
+ \texorpdfstring
+ {\Glsxtrtitlelongpl{#1}}%
+ {\glsentrylongpl{#1}}%
+ }
+}
+{
+ \newcommand*{\Glsfmtlongpl}[1]{%
+ \Glsxtrtitlelongpl{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\GLSfmtlongpl}[1]{%
+ \texorpdfstring
+ {\GLSxtrtitlelongpl{#1}}%
+ {\glsentrylongpl{#1}}%
+ }
+}
+{
+ \newcommand*{\GLSfmtlongpl}[1]{%
+ \GLSxtrtitlelongpl{#1}}
+}
+\newcommand*{\glspdffmtfull}[1]{\glsentrylong{#1} (\glsentryshort{#1})}%
+\newcommand*{\glspdffmtfullpl}[1]{\glsentrylongpl{#1} (\glsentryshortpl{#1})}%
+\ifdef\texorpdfstring
+{
+ \newcommand*{\glsfmtfull}[1]{%
+ \texorpdfstring
+ {\glsxtrtitlefull{#1}}%
+ {\glspdffmtfull{#1}}%
+ }
+}
+{
+ \newcommand*{\glsfmtfull}[1]{%
+ \glsxtrtitlefull{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\Glsfmtfull}[1]{%
+ \texorpdfstring
+ {\Glsxtrtitlefull{#1}}%
+ {\glspdffmtfull{#1}{}}%
+ }
+}
+{
+ \newcommand*{\Glsfmtfull}[1]{%
+ \Glsxtrtitlefull{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\GLSfmtfull}[1]{%
+ \texorpdfstring
+ {\GLSxtrtitlefull{#1}}%
+ {\glspdffmtfull{#1}}%
+ }
+}
+{
+ \newcommand*{\GLSfmtfull}[1]{%
+ \GLSxtrtitlefull{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\glsfmtfullpl}[1]{%
+ \texorpdfstring
+ {\glsxtrtitlefullpl{#1}}%
+ {\glspdffmtfullpl{#1}}%
+ }
+}
+{
+ \newcommand*{\glsfmtfullpl}[1]{%
+ \glsxtrtitlefullpl{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\Glsfmtfullpl}[1]{%
+ \texorpdfstring
+ {\Glsxtrtitlefullpl{#1}}%
+ {\glspdffmtfullpl{#1}{}}%
+ }
+}
+{
+ \newcommand*{\Glsfmtfullpl}[1]{%
+ \Glsxtrtitlefullpl{#1}}
+}
+\ifdef\texorpdfstring
+{
+ \newcommand*{\GLSfmtfullpl}[1]{%
+ \texorpdfstring
+ {\GLSxtrtitlefullpl{#1}}%
+ {\glspdffmtfullpl{#1}{}}%
+ }
+}
+{
+ \newcommand*{\GLSfmtfullpl}[1]{%
+ \GLSxtrtitlefullpl{#1}}
+}
+\newcommand*{\multiglossaryentrysetup}[1]{\setkeys{glsxtrcombined}{#1}}
+\newcommand*{\@gls@combined@indexmain}{1}
+\define@choicekey{glsxtrcombined}{indexmain}%
+ [\@gls@combined@indexmain@val\@gls@combined@indexmain]
+ {false,true,first}[true]{}
+\newcommand*{\@gls@combined@indexothers}{2}
+\define@choicekey{glsxtrcombined}{indexothers}%
+ [\@gls@combined@indexothers@val\@gls@combined@indexothers]
+ {false,true,first}[true]{}
+\newcommand*{\@gls@combined@hyper}{3}
+\define@choicekey{glsxtrcombined}{hyper}%
+ [\@gls@combined@hyper@val\@gls@combined@hyper]
+ {none,allmain,mainonly,individual,otheronly,notmainfirst,nototherfirst,notfirst}{}
+\newcommand*{\@gls@combined@encapmain}{glsnumberformat}
+\define@key{glsxtrcombined}{encapmain}{%
+ \renewcommand*{\@gls@combined@encapmain}{#1}%
+}
+\newcommand*{\@gls@combined@encapothers}{glsnumberformat}
+\define@key{glsxtrcombined}{encapothers}{%
+ \renewcommand*{\@gls@combined@encapothers}{#1}%
+}
+\newcommand*{\@gls@combined@textformat}{@firstofone}
+\define@key{glsxtrcombined}{textformat}{%
+ \renewcommand*{\@gls@combined@textformat}{#1}%
+}
+\newcommand*{\@gls@combined@category}{}
+\define@key{glsxtrcombined}{category}{%
+ \renewcommand*{\@gls@combined@category}{#1}%
+}
+\define@key{glsxtrcombinedpreopts}{category}{%
+ \renewcommand*{\@gls@combined@category}{#1}%
+}
+\newcommand*{\@gls@combined@mglsopts}{}
+\define@key{glsxtrcombined}{mglsopts}{%
+ \renewcommand*{\@gls@combined@mglsopts}{#1}%
+}
+\define@key{glsxtrcombinedpreopts}{mglsopts}{%
+ \@gls@combined@mglsopts@do
+ {%
+ \renewcommand*{\@gls@combined@mglsopts}{#1}%
+ }%
+}
+\newcommand*{\@gls@combined@mglsopts@do}[1]{#1}
+\newcommand*{\mgls@disable@mglsopts}{%
+ \let\@gls@combined@mglsopts@do\@gls@combined@mglsopts@do@not
+}
+\newcommand*{\mgls@enable@mglsopts}{%
+ \let\@gls@combined@mglsopts@do\@firstofone
+}
+\newcommand*{\@gls@combined@mglsopts@do@not}[1]{%
+ \PackageError{glossaries-extra}{`mglsopts' key not permitted inside
+ `setup' value}{}%
+}
+\newcommand*{\@gls@combined@firstprefix}{}
+\define@key{glsxtrcombined}{firstprefix}{%
+ \renewcommand*{\@gls@combined@firstprefix}{#1}%
+}
+\newcommand*{\@gls@combined@usedprefix}{}
+\define@key{glsxtrcombined}{usedprefix}{%
+ \renewcommand*{\@gls@combined@usedprefix}{#1}%
+}
+\newcommand*{\@gls@combined@firstsuffix}{}
+\define@key{glsxtrcombined}{firstsuffix}{%
+ \renewcommand*{\@gls@combined@firstsuffix}{#1}%
+}
+\newcommand*{\@gls@combined@usedsuffix}{}
+\define@key{glsxtrcombined}{usedsuffix}{%
+ \renewcommand*{\@gls@combined@usedsuffix}{#1}%
+}
+\define@boolkey{glsxtrcombined}{firstskipmain}[true]{}
+\KV@glsxtrcombined@firstskipmainfalse
+\define@boolkey{glsxtrcombined}{firstskipothers}[true]{}
+\KV@glsxtrcombined@firstskipothersfalse
+\define@boolkey{glsxtrcombined}{usedskipmain}[true]{}
+\KV@glsxtrcombined@usedskipmainfalse
+\define@boolkey{glsxtrcombined}{usedskipothers}[true]{}
+\KV@glsxtrcombined@usedskipothersfalse
+\newcommand*{\@gls@combined@postlinks@nr}{0}
+\define@choicekey{glsxtrcombined}{postlinks}%
+ [\@gls@combined@postlinks@val\@gls@combined@postlinks@nr]
+ {none,all,notlast,mainnotlast,mainonly,othernotlast,otheronly}{}
+\newcommand*{\@gls@combined@mpostlink@nr}{1}
+\define@choicekey{glsxtrcombined}{mpostlink}%
+ [\@gls@combined@mpostlink@val\@gls@combined@mpostlink@nr]
+ {false,true,firstonly,usedonly}[true]{}
+\newcommand*{\@gls@combined@mpostlinkelement@nr}{0}
+\define@choicekey{glsxtrcombined}{mpostlinkelement}%
+ [\@gls@combined@mpostlinkelement@val\@gls@combined@mpostlinkelement@nr]
+ {last,main,custom}{}
+\newcommand*{\glsxtrifmulti}[3]{\ifcsdef{@gls@combined@#1@main}{#2}{#3}}
+\newcommand*{\glsxtrmultimain}[1]{\csuse{@gls@combined@#1@main}}
+\newcommand*{\glsxtrmultilist}[1]{\csuse{@gls@combined@#1@list}}
+\newcommand*{\glsxtrmultitotalelements}[1]{\csuse{@gls@combined@#1@total}}
+\newcommand*{\glsxtrmultimainindex}[1]{\csuse{@gls@combined@#1@mainindex}}
+\newcommand*{\glsxtrmultilastotherindex}[1]{\csuse{@gls@combined@#1@lastotherindex}}
+\newif\ifmultiglossaryentryglobal
+\multiglossaryentryglobalfalse
+\newcount\mglselementindex
+\newrobustcmd{\multiglossaryentry}[1][]{%
+ \def\@gls@combined@current@opts{#1}%
+ \ifnum\@glsxtr@docdefval=1\relax
+ \let\@multi@glossentry@donext\@defmultiglossaryentry
+ \else
+ \let\@multi@glossentry@donext\@multiglossaryentry
+ \fi
+ \@multi@glossentry@donext
+}
+\newcommand*{\@multiglossaryentry}[1]{%
+ \def\@gls@combined@current@label{#1}%
+ \@multi@glossaryentry
+}
+\newcommand*{\@multi@glossaryentry}[2][]{%
+ \ifcsdef{@gls@combined@\@gls@combined@current@label @main}%
+ {\PackageError{glossaries-extra}%
+ {Multi-entry label `\@gls@combined@current@label' already defined}%
+ {}%
+ }%
+ {%
+ \@multi@glossary@entry{#1}{#2}%
+ }%
+}
+\newcommand*{\@defmultiglossaryentry}[1]{%
+ \def\@gls@combined@current@label{#1}%
+ \@def@multi@glossaryentry
+}
+\newcommand*{\@def@multi@glossaryentry}[2][]{%
+ \let\@def@multi@glossaryentry@do\@multi@glossary@entry
+ \ifundef\@glsxtr@docdefs@multilist
+ {%
+ \gdef\@glsxtr@docdefs@multilist{}%
+ \listxadd
+ {\@glsxtr@docdefs@multilist}{\expandonce\@gls@combined@current@label}%
+ }%
+ {%
+ \xifinlist{\@gls@combined@current@label}{\@glsxtr@docdefs@multilist}%
+ {%
+ \PackageError{glossaries-extra}%
+ {Multi-entry label `\@gls@combined@current@label' already defined}%
+ {}%
+ \let\@def@multi@glossaryentry@do\@gobbletwo
+ }%
+ {%
+ \listxadd
+ {\@glsxtr@docdefs@multilist}{\expandonce\@gls@combined@current@label}%
+ }%
+ }%
+ \@def@multi@glossaryentry@do{#1}{#2}%
+}
+\newcommand*{\@multi@glossary@doifexists}{\glsdoifexists}
+\newrobustcmd{\providemultiglossaryentry}[2][]{%
+ \def\@gls@combined@current@opts{#1}%
+ \def\@gls@combined@current@label{#2}%
+ \ifcsdef{@gls@combined@\@gls@combined@current@label @main}%
+ {\def\@multi@glossentry@donext{\@provide@multi@glossaryentry@noop}}%
+ {%
+ \ifnum\@glsxtr@docdefval=1\relax
+ \def\@multi@glossentry@donext{\@def@multi@glossaryentry}%
+ \else
+ \def\@multi@glossentry@donext{\@multi@glossaryentry}%
+ \fi
+ }%
+ \@multi@glossentry@donext
+}
+\newcommand*{\@provide@multi@glossaryentry@noop}[2][]{}
+\newcommand*{\@multi@glossaryentry@list}{}
+\newcommand*{\@multi@glossary@entry}[2]{%
+ \protected@edef\@gls@combined@current@main{#1}%
+ \protected@edef\@gls@combined@currentlist{#2}%
+ \mglselementindex=0\relax
+ \@for\@gls@tmp:=\@gls@combined@currentlist\do{%
+ \advance\mglselementindex by 1\relax
+ \@multi@glossary@doifexists{\@gls@tmp}{}%
+ \let\@gls@combined@finalitem\@gls@tmp
+ \ifdefvoid\@gls@combined@current@main
+ {}%
+ {%
+ \ifx\@gls@combined@current@main\@gls@tmp
+ \ifmultiglossaryentryglobal
+ \global\cslet{@gls@combined@\@gls@combined@current@label @main}%
+ \@gls@combined@current@main
+ \csxdef{@gls@combined@\@gls@combined@current@label @mainindex}%
+ {\the\mglselementindex}%
+ \else
+ \cslet{@gls@combined@\@gls@combined@current@label @main}%
+ \@gls@combined@current@main
+ \csedef{@gls@combined@\@gls@combined@current@label @mainindex}%
+ {\the\mglselementindex}%
+ \fi
+ \else
+ \ifmultiglossaryentryglobal
+ \csxdef{@gls@combined@\@gls@combined@current@label @lastotherindex}%
+ {\the\mglselementindex}%
+ \else
+ \csedef{@gls@combined@\@gls@combined@current@label @lastotherindex}%
+ {\the\mglselementindex}%
+ \fi
+ \fi
+ }%
+ }%
+ \ifmultiglossaryentryglobal
+ \csxdef{@gls@combined@\@gls@combined@current@label @total}%
+ {\the\mglselementindex}%
+ \else
+ \csedef{@gls@combined@\@gls@combined@current@label @total}%
+ {\the\mglselementindex}%
+ \fi
+ \ifnum\mglselementindex<2\relax
+ \PackageError{glossaries-extra}{At least 2 labels required in
+ multi-entry element list (\number\mglselementindex\space found)}{}%
+ \else
+ \ifdefvoid\@gls@combined@current@main
+ {}%
+ {%
+ \ifcsundef{@gls@combined@\@gls@combined@current@label @main}%
+ {\PackageError{glossaries-extra}%
+ {Main element `\@gls@combined@current@main' not found in list}%
+ {The final element `\@gls@combined@finalitem' will be used instead}
+ \let\@gls@combined@current@main\@empty
+ }%
+ {}%
+ }%
+ \ifdefvoid\@gls@combined@current@main
+ {%
+ \ifmultiglossaryentryglobal
+ \global\cslet{@gls@combined@\@gls@combined@current@label @main}%
+ \@gls@combined@finalitem
+ \global\csletcs{@gls@combined@\@gls@combined@current@label @mainindex}%
+ {@gls@combined@\@gls@combined@current@label @total}%
+ \csxdef{@gls@combined@\@gls@combined@current@label @lastotherindex}%
+ {\the\numexpr\mglselementindex-1 }%
+ \else
+ \cslet{@gls@combined@\@gls@combined@current@label @main}%
+ \@gls@combined@finalitem
+ \csletcs{@gls@combined@\@gls@combined@current@label @mainindex}%
+ {@gls@combined@\@gls@combined@current@label @total}%
+ \csedef{@gls@combined@\@gls@combined@current@label @lastotherindex}%
+ {\the\numexpr\mglselementindex-1 }%
+ \fi
+ }%
+ {}%
+ \ifmultiglossaryentryglobal
+ \global\cslet{@gls@combined@\@gls@combined@current@label @list}%
+ \@gls@combined@currentlist
+ \protected@csxdef{@gls@combined@\@gls@combined@current@label @options}%
+ {\@gls@combined@current@opts}%
+ \expandafter\@ifdefinable
+ \csname if@gls@combined@\@gls@combined@current@label @flag\endcsname
+ {\expandafter\global\expandafter
+ \newif\csname if@gls@combined@\@gls@combined@current@label @flag\endcsname}%
+ \expandafter\global
+ \csname @gls@combined@\@gls@combined@current@label @flagfalse\endcsname
+ \else
+ \cslet{@gls@combined@\@gls@combined@current@label @list}%
+ \@gls@combined@currentlist
+ \protected@csedef{@gls@combined@\@gls@combined@current@label @options}%
+ {\@gls@combined@current@opts}%
+ \newboolean{@gls@combined@\@gls@combined@current@label @flag}%
+ \csname @gls@combined@\@gls@combined@current@label @flagfalse\endcsname
+ \fi
+ \fi
+ \writemultiglossentry
+ {\@gls@combined@current@opts}{\@gls@combined@current@label}%
+ {\csuse{@gls@combined@\@gls@combined@current@label @main}}{#2}%
+ \ifmultiglossaryentryglobal
+ \ifdefempty\@multi@glossaryentry@list
+ {\let\@multi@glossaryentry@list\@gls@combined@current@label}%
+ {%
+ \eappto\@multi@glossaryentry@list{,\expandonce\@gls@combined@current@label}%
+ }%
+ \else
+ \ifdefempty\@multi@glossaryentry@list
+ {\global\let\@multi@glossaryentry@list\@gls@combined@current@label}%
+ {%
+ \xappto\@multi@glossaryentry@list{,\expandonce\@gls@combined@current@label}%
+ }%
+ \fi
+}
+\newcommand*{\@glsxtr@multientry}[4]{%
+ \ifnum\@glsxtr@docdefval=1\relax
+ \bgroup
+ \def\@gls@combined@current@opts{#1}%
+ \def\@gls@combined@current@label{#2}%
+ \let\@multi@glossary@doifexists\@secondoftwo
+ \let\writemultiglossentry\@gobblefour
+ \multiglossaryentryglobaltrue
+ \@multi@glossary@entry{#3}{#4}%
+ \egroup
+ \fi
+}
+\newcommand*{\writemultiglossentry}[4]{%
+ \protected@write\@auxout{}{\string\@glsxtr@multientry{#1}{#2}{#3}{#4}}%
+}
+\newcommand*{\ifmglsused}[3]{%
+ \ifbool{@gls@combined@#1@flag}{#2}{#3}%
+}
+\newcommand*{\mglsunset}[1]{%
+ \gls@ifnotmeasuring
+ {%
+ \glsxtrifmulti{#1}{\@mglsunset{#1}}%
+ {%
+ \glsxtrundefaction{Multi entry `#1' hasn't been defined}%
+ {You need to define `#1' with \string\multiglossaryentry}%
+ }%
+ }%
+}
+\newcommand*{\@mglsunset}[1]{%
+ \expandafter\global\csname @gls@combined@#1@flagtrue\endcsname
+}
+\newcommand*{\mglsreset}[1]{%
+ \gls@ifnotmeasuring
+ {%
+ \glsxtrifmulti{#1}{\@mglsreset{#1}}%
+ {%
+ \glsxtrundefaction{Multi entry `#1' hasn't been defined}%
+ {You need to define `#1' with \string\multiglossaryentry}%
+ }%
+ }%
+}
+\newcommand*{\@mglsreset}[1]{%
+ \expandafter\global\csname @gls@combined@#1@flagfalse\endcsname
+}
+\newcommand*{\mglslocalunset}[1]{%
+ \gls@ifnotmeasuring
+ {%
+ \glsxtrifmulti{#1}{\@mglslocalunset{#1}}%
+ {%
+ \glsxtrundefaction{Multi entry `#1' hasn't been defined}%
+ {You need to define `#1' with \string\multiglossaryentry}%
+ }%
+ }%
+}
+\newcommand*{\@mglslocalunset}[1]{%
+ \csname @gls@combined@#1@flagtrue\endcsname
+}
+\newcommand*{\mglslocalreset}[1]{%
+ \gls@ifnotmeasuring
+ {%
+ \glsxtrifmulti{#1}{\@mglslocalreset{#1}}%
+ {%
+ \glsxtrundefaction{Multi entry `#1' hasn't been defined}%
+ {You need to define `#1' with \string\multiglossaryentry}%
+ }%
+ }%
+}
+\newcommand*{\@mglslocalreset}[1]{%
+ \csname @gls@combined@#1@flagfalse\endcsname
+}
+\newcommand*{\mglsunsetall}{%
+ \@for\@mgls@thislabel:=\@multi@glossaryentry@list\do{\mglsunset\@mgls@thislabel}%
+}%
+\newcommand*{\mglsresetall}{%
+ \@for\@mgls@thislabel:=\@multi@glossaryentry@list\do{\mglsreset\@mgls@thislabel}%
+}%
+\newrobustcmd{\mglsSetMain}[2]{%
+ \ifcsundef{@gls@combined@#1@main}%
+ {\PackageError{glossaries-extra}{Multi-entry label `#1' not defined}{}}%
+ {%
+ \protected@edef\@gls@combined@current@main{#2}%
+ \letcs\@gls@combined@currentlist{@gls@combined@#1@list}%
+ \mglselementindex=0\relax
+ \count@=0\relax
+ \@for\@gls@tmp:=\@gls@combined@currentlist\do{%
+ \advance\mglselementindex by 1\relax
+ \ifx\@gls@combined@current@main\@gls@tmp
+ \count@=\mglselementindex\relax
+ \let\@gls@combined@finalitem\@gls@tmp
+ \ifmultiglossaryentryglobal
+ \global\cslet{@gls@combined@#1@main}\@gls@combined@current@main
+ \csxdef{@gls@combined@#1@mainindex}{\the\mglselementindex}%
+ \else
+ \cslet{@gls@combined@#1@main}\@gls@combined@current@main
+ \csedef{@gls@combined@#1@mainindex}{\the\mglselementindex}%
+ \fi
+ \else
+ \ifmultiglossaryentryglobal
+ \csxdef{@gls@combined@#1@lastotherindex}{\the\mglselementindex}%
+ \else
+ \csedef{@gls@combined@#1@lastotherindex}{\the\mglselementindex}%
+ \fi
+ \fi
+ }%
+ \ifnum\count@=0\relax
+ \PackageError{glossaries-extra}{Label `#2' is not in `#1' set
+ (\@gls@combined@currentlist)}{}%
+ \ifmultiglossaryentryglobal
+ \global\cslet{@gls@combined@#1@main}\@gls@combined@finalitem
+ \csxdef{@gls@combined@#1@mainindex}{\the\mglselementindex}%
+ \csxdef{@gls@combined@#1@lastotherindex}{%
+ \number\numexpr\mglselementindex-1 }%
+ \else
+ \cslet{@gls@combined@#1@main}\@gls@combined@finalitem
+ \csedef{@gls@combined@#1@mainindex}{\the\mglselementindex}%
+ \csedef{@gls@combined@#1@lastotherindex}{%
+ \number\numexpr\mglselementindex-1 }%
+ \fi
+ \fi
+ }%
+}
+\newrobustcmd{\mglsSetOptions}[2]{%
+ \ifcsundef{@gls@combined@#1@main}%
+ {\PackageError{glossaries-extra}{Multi-entry label `#1' not defined}{}}%
+ {%
+ \csdef{@gls@combined@#1@options}{#2}%
+ }%
+}
+\newrobustcmd{\mglsAddOptions}[2]{%
+ \ifcsundef{@gls@combined@#1@main}%
+ {\PackageError{glossaries-extra}{Multi-entry label `#1' not defined}{}}%
+ {%
+ \ifcsempty{@gls@combined@#1@options}%
+ {\csdef{@gls@combined@#1@options}{#2}}%
+ {\csappto{@gls@combined@#1@options}{,#2}}%
+ }%
+}
+\newcommand*{\@mgls@all}{}
+\define@key{mgls}{all}{\renewcommand*{\@mgls@all}{#1}}
+\newcommand*{\@mgls@main}{}
+\define@key{mgls}{main}{\renewcommand*{\@mgls@main}{#1}}
+\newcommand*{\@mgls@others}{}
+\define@key{mgls}{others}{\renewcommand*{\@mgls@others}{#1}}
+\newcommand*{\@mgls@setup}{}
+\define@key{mgls}{setup}{%
+ \@mgls@setup@do{\renewcommand*{\@mgls@setup}{#1}}%
+}
+\newcommand*{\@mgls@setup@do}[1]{#1}
+\newcommand*{\@mgls@setup@do@not}[1]{%
+ \PackageError{glossaries-extra}{`setup' key not permitted inside
+ `mglsopts' value}{}%
+}
+\newcommand*{\mgls@disable@setup}{%
+ \let\@mgls@setup@do\@mgls@setup@do@not
+}
+\newcommand*{\mgls@enable@setup}{%
+ \let\@mgls@setup@do\@firstofone
+}
+\newcommand\@mgls@unsetaction{0}
+\define@choicekey{mgls}{multiunset}[\@mgls@unsetaction@val\@mgls@unsetaction]%
+ {global,local,none}{}
+\define@boolkey{mgls}{presetlocal}[true]{}
+\KV@mgls@presetlocalfalse
+\newcommand*{\@mgls@hyper}{}
+\define@choicekey{mgls}{hyper}[\@mgls@hyper@val\@mgls@hyper@nr]{true,false}[true]%
+{%
+ \renewcommand*{\@mgls@hyper}{hyper=#1}%
+ \ifnum\@mgls@hyper@nr=1\relax
+ \let\@mgls@hyperlink\@secondoftwo
+ \else
+ \let\@mgls@hyperlink\@@mgls@hyperlink
+ \fi
+}
+\newcommand*{\@@mgls@hyperlink}[2]{%
+ \ifx\@glslink\glsdonohyperlink
+ #2%
+ \else
+ \glsxtr@org@dohyperlink{\glolinkprefix#1}{#2}%
+ \fi
+}
+\let\@mgls@hyperlink\@@mgls@hyperlink
+\newcommand*{\mglsforelements}[3]{%
+ \expandafter\@for\expandafter#2\expandafter:\expandafter
+ =\csname @gls@combined@#1@list\endcsname\do{#3}%
+}
+\newcommand*{\mglsforotherelements}[3]{%
+ \expandafter\@for\expandafter#2\expandafter:\expandafter
+ =\csname @gls@combined@#1@list\endcsname\do
+ {\expandafter\ifdefequal\csname @gls@combined@#1@main\endcsname{#2}{}{#3}}%
+}
+\newcommand*{\mglsunsetothers}[1]{%
+ \mglsforotherelements{#1}{\@gls@tmp}{\glsunset{\@gls@tmp}}%
+}
+\newcommand*{\mglslocalunsetothers}[1]{%
+ \mglsforotherelements{#1}{\@gls@tmp}{\glslocalunset{\@gls@tmp}}%
+}
+\newcommand*{\mglselementreset}[1]{%
+ \ifKV@mgls@presetlocal
+ \glslocalreset{#1}%
+ \else
+ \glsreset{#1}%
+ \fi
+}
+\newcommand*{\mglselementunset}[1]{%
+ \ifKV@mgls@presetlocal
+ \glslocalunset{#1}%
+ \else
+ \glsunset{#1}%
+ \fi
+}
+\newcommand*{\@mgls@resetall}{}
+\define@choicekey{mgls}{resetall}%
+[\@mgls@resetall@val\@mgls@resetall@nr]{false,true}[true]%
+{%
+ \ifcase\@mgls@resetall@nr\relax
+ \renewcommand*{\@mgls@resetall}{}%
+ \or
+ \renewcommand*{\@mgls@resetall}{%
+ \@for\@gls@resetlabel:=\mglscurrentlist\do{\mglselementreset\@gls@resetlabel}}%
+ \renewcommand*{\@mgls@unsetall}{}%
+ \fi
+}
+\newcommand*{\@mgls@resetmain}{}
+\define@choicekey{mgls}{resetmain}
+[\@mgls@resetmain@val\@mgls@resetmain@nr]{false,true}[true]%
+{%
+ \ifcase\@mgls@resetmain@nr\relax
+ \renewcommand*{\@mgls@resetmain}{}%
+ \or
+ \renewcommand*{\@mgls@resetmain}{\mglselementreset\mglscurrentmainlabel}%
+ \renewcommand*{\@mgls@unsetmain}{}%
+ \fi
+}
+\newcommand*{\@mgls@resetothers}{}
+\define@choicekey{mgls}{resetothers}
+[\@mgls@resetothers@val\@mgls@resetothers@nr]{false,true}[true]%
+{%
+ \ifcase\@mgls@resetothers@nr\relax
+ \renewcommand*{\@mgls@resetothers}{}%
+ \or
+ \renewcommand*{\@mgls@resetothers}{%
+ \@for\@gls@resetlabel:=\mglscurrentlist\do{%
+ \ifx\@gls@resetlabel\mglscurrentmainlabel
+ \else
+ \mglselementreset\@gls@resetlabel
+ \fi
+ }%
+ }%
+ \renewcommand*{\@mgls@unsetothers}{}%
+ \fi
+}
+\newcommand*{\@mgls@unsetall}{}
+\define@choicekey{mgls}{unsetall}%
+[\@mgls@unsetall@val\@mgls@unsetall@nr]{false,true}[true]%
+{%
+ \ifcase\@mgls@unsetall@nr\relax
+ \renewcommand*{\@mgls@unsetall}{}%
+ \or
+ \renewcommand*{\@mgls@unsetall}{%
+ \@for\@gls@unsetlabel:=\mglscurrentlist\do{\mglselementunset\@gls@unsetlabel}}%
+ \renewcommand*{\@mgls@resetall}{}%
+ \fi
+}
+\newcommand*{\@mgls@unsetmain}{}
+\define@choicekey{mgls}{unsetmain}
+[\@mgls@unsetmain@val\@mgls@unsetmain@nr]{false,true}[true]%
+{%
+ \ifcase\@mgls@unsetmain@nr\relax
+ \renewcommand*{\@mgls@unsetmain}{}%
+ \or
+ \renewcommand*{\@mgls@unsetmain}{\mglselementunset\mglscurrentmainlabel}%
+ \renewcommand*{\@mgls@resetmain}{}%
+ \fi
+}
+\newcommand*{\@mgls@unsetothers}{}
+\define@choicekey{mgls}{unsetothers}
+[\@mgls@unsetothers@val\@mgls@unsetothers@nr]{false,true}[true]%
+{%
+ \ifcase\@mgls@unsetothers@nr\relax
+ \renewcommand*{\@mgls@unsetothers}{}%
+ \or
+ \renewcommand*{\@mgls@unsetothers}{%
+ \@for\@gls@unsetlabel:=\mglscurrentlist\do{%
+ \ifx\@gls@unsetlabel\mglscurrentmainlabel
+ \else
+ \mglselementunset\@gls@unsetlabel
+ \fi
+ }%
+ }%
+ \renewcommand*{\@mgls@resetothers}{}%
+ \fi
+}
+\newcommand{\glsxtr@setup@docurrent}{%
+ \ifx\mglscurrentlabel\mglscurrentmainlabel
+ \mglsisfirstuse
+ {%
+ \ifKV@glsxtrcombined@firstskipmain
+ \let\@mgls@do@current@element\@gobble
+ \else
+ \let\@mgls@do@current@element\@firstofone
+ \fi
+ }%
+ {%
+ \ifKV@glsxtrcombined@usedskipmain
+ \let\@mgls@do@current@element\@gobble
+ \else
+ \let\@mgls@do@current@element\@firstofone
+ \fi
+ }%
+ \else
+ \mglsisfirstuse
+ {%
+ \ifKV@glsxtrcombined@firstskipothers
+ \let\@mgls@do@current@element\@gobble
+ \else
+ \let\@mgls@do@current@element\@firstofone
+ \fi
+ }%
+ {%
+ \ifKV@glsxtrcombined@usedskipothers
+ \let\@mgls@do@current@element\@gobble
+ \else
+ \let\@mgls@do@current@element\@firstofone
+ \fi
+ }%
+ \fi
+}
+\newcommand*{\glsxtr@mgls@checklastelement}[2]{%
+ \ifbool{KV@glsxtrcombined@#1skipmain}%
+ {%
+ \ifbool{KV@glsxtrcombined@#1skipothers}%
+ {%
+ }%
+ {%
+ \ifnum\mglselementindex=\glsxtrmultilastotherindex{#2}\relax
+ \let\mglsiflast\@firstoftwo
+ \else
+ \let\mglsiflast\@secondoftwo
+ \fi
+ }%
+ }%
+ {%
+ \ifbool{KV@glsxtrcombined@#1skipothers}%
+ {%
+ \ifnum\mglselementindex=\glsxtrmultimainindex{#2}\relax
+ \let\mglsiflast\@firstoftwo
+ \else
+ \let\mglsiflast\@secondoftwo
+ \fi
+ }%
+ {%
+ \let\mglsiflast\@secondoftwo
+ }%
+ }%
+}
+\newcommand{\glsxtrmglsWarnAllSkipped}[3]{%
+ \GlossariesExtraWarning{#1}%
+ #3{#2}%
+}
+\newcommand*{\glsxtr@mgls@applyopts}[1]{%
+ \edef\@mgls@dooptions{\noexpand\setkeys*{mgls}{\expandonce#1}}%
+ \@mgls@dooptions
+ \ifdefvoid\XKV@rm{}{\eappto\@mgls@all{,\expandonce\XKV@rm}}%
+ \ifdefvoid\@mgls@setup
+ {}%
+ {%
+ \edef\@mgls@dooptions{%
+ \noexpand\setkeys*{glsxtrcombinedpreopts}{\expandonce\@mgls@setup}}%
+ \mgls@disable@mglsopts
+ \@mgls@dooptions
+ \mgls@enable@mglsopts
+ \ifx\@mgls@setupoptions\@empty
+ \let\@mgls@setupoptions\XKV@rm
+ \else
+ \eappto\@mgls@setupoptions{,\expandonce\XKV@rm}%
+ \fi
+ }%
+ \@mgls@resetall
+ \@mgls@unsetall
+ \@mgls@resetmain
+ \@mgls@unsetmain
+ \@mgls@resetothers
+ \@mgls@unsetothers
+ \let\@mgls@resetall\@empty
+ \let\@mgls@resetmain\@empty
+ \let\@mgls@resetothers\@empty
+ \let\@mgls@unsetall\@empty
+ \let\@mgls@unsetmain\@empty
+ \let\@mgls@unsetothers\@empty
+ \ifmglsused\mglscurrentmultilabel
+ {\let\mglsisfirstuse\@secondoftwo}%
+ {\let\mglsisfirstuse\@firstoftwo}%
+}
+\providecommand{\@firstofthree}[3]{#1}
+\providecommand{\@secondofthree}[3]{#2}
+\providecommand{\@thirdofthree}[3]{#3}
+\newcommand*{\glsxtr@mgls@inner}[7]{%
+ \let\mglslastmainlabel\@empty
+ \let\mglsiflastmainwasfirstuse\@firstoftwo
+ \let\mglsiflastmainwasplural\@secondoftwo
+ \let\mglsiflastmaincapscase\@firstofthree
+ \let\mglsiflastmainskipped\@firstoftwo
+ \bgroup
+ \ifcsundef{@gls@combined@#2@main}%
+ {%
+ \glsxtrundefaction{Multi entry `#2' hasn't been defined}%
+ {You need to define `#2' with \string\multiglossaryentry}%
+ \gdef\@mgls@post@hookdefs{%
+ \protected@edef\mglslastmultilabel{#2}%
+ \let\mglswasfirstuse\@firstoftwo
+ \let\mglslastcategory\@empty
+ \let\mglsiflastelementskipped\@firstoftwo
+ \let\mglsiflastelementwasfirstuse\@firstoftwo
+ \let\mglsiflastelementwasplural\@secondoftwo
+ \let\mglsiflastelementcapscase\@firstofthree
+ \let\mglslastelementlabel\@empty
+ \let\mgls@do@postlinkhook\relax
+ }%
+ }%
+ {%
+ \protected@edef\mglscurrentmultilabel{#2}%
+ \letcs\mglscurrentmainlabel{@gls@combined@#2@main}%
+ \letcs\mglscurrentlist{@gls@combined@#2@list}%
+ \letcs\mglscurrentoptions{@gls@combined@#2@options}%
+ \ifmglsused\mglscurrentmultilabel
+ {\let\mglsisfirstuse\@secondoftwo}%
+ {\let\mglsisfirstuse\@firstoftwo}%
+ \edef\@mgls@dooptions{%
+ \noexpand\setkeys*{glsxtrcombinedpreopts}{\expandonce\mglscurrentoptions}}%
+ \@mgls@dooptions
+ \let\@mgls@setupoptions\XKV@rm
+ \mgls@disable@setup
+ \ifdefvoid\@gls@combined@mglsopts
+ {}%
+ {\glsxtr@mgls@applyopts\@gls@combined@mglsopts}%
+ \mgls@enable@setup
+ \ifstrempty{#1}{}{\def\@mgls@options{#1}\glsxtr@mgls@applyopts\@mgls@options}%
+ \ifx\@gls@combined@category\empty
+ \else
+ \glshascategoryattribute{\@gls@combined@category}{multioptions}%
+ {%
+ \letcs\@mgls@attroptions{@glsxtr@categoryattr@@\@gls@combined@category
+ @multioptions}%
+ \let\@gls@combined@mglsopts\@empty
+ \edef\@mgls@dooptions{%
+ \noexpand\setkeys*{glsxtrcombinedpreopts}{\expandonce\@mgls@attroptions}}%
+ \@mgls@dooptions
+ \eappto\@mgls@setupoptions{,\expandonce\XKV@rm}%
+ \ifx\@gls@combined@mglsopts\@empty
+ \else
+ \let\@mgls@setup\@empty
+ \mgls@disable@setup
+ \glsxtr@mgls@applyopts\@gls@combined@mglsopts
+ \mgls@enable@setup
+ \fi
+ }%
+ {}%
+ \fi
+ \edef\@mgls@dooptions{%
+ \noexpand\setkeys{glsxtrcombined}{\expandonce\@mgls@setupoptions}}%
+ \@mgls@dooptions
+ \let\mglscurrentcategory\@gls@combined@category
+ \ifnum\@gls@combined@hyper=1\relax
+ \def\@mgls@combinedlink{\@mgls@hyperlink{\mglscurrentmainlabel}}%
+ \else
+ \def\@mgls@combinedlink{\@firstofone}%
+ \fi
+ \def\@gls@combined@encapsulator##1{%
+ \@mgls@combinedlink{\csuse{\@gls@combined@textformat}{##1}}}%
+ \let\@mgls@do@current@element\@firstofone
+ \mglsisfirstuse
+ {%
+ \ifKV@glsxtrcombined@firstskipmain
+ \ifKV@glsxtrcombined@firstskipothers
+ \let\@gls@org@combined@encapsulator\@gls@combined@encapsulator
+ \def\@gls@combined@encapsulator##1{%
+ \glsxtrmglsWarnAllSkipped{All elements skipped for
+ first use of multi-entry `#2'}{#3}%
+ {\@gls@org@combined@encapsulator}%
+ }%
+ \let\@mgls@do@current@element\@gobble
+ \fi
+ \fi
+ }%
+ {%
+ \ifKV@glsxtrcombined@usedskipmain
+ \ifKV@glsxtrcombined@usedskipothers
+ \let\@gls@org@combined@encapsulator\@gls@combined@encapsulator
+ \def\@gls@combined@encapsulator##1{%
+ \glsxtrmglsWarnAllSkipped{All elements skipped for
+ subsequent use of multi-entry `#2'}{#3}%
+ {\@gls@org@combined@encapsulator}%
+ }%
+ \let\@mgls@do@current@element\@gobble
+ \fi
+ \fi
+ }%
+ \mglsisfirstuse
+ {%
+ \let\mglscurrentprefix\@gls@combined@firstprefix
+ \let\mglscurrentsuffix\@gls@combined@firstsuffix
+ }%
+ {%
+ \let\mglscurrentprefix\@gls@combined@usedprefix
+ \let\mglscurrentsuffix\@gls@combined@usedsuffix
+ }%
+ \xdef\@mgls@post@hookdefs{%
+ \noexpand\def\noexpand\mglslastmultilabel{\expandonce\mglscurrentmultilabel}%
+ \noexpand\def\noexpand\mglslastcategory{\mglscurrentcategory}%
+ }%
+ \ifx\@mgls@do@current@element\@gobble
+ \gappto\@mgls@post@hookdefs{%
+ \let\mglsiflastelementskipped\@firstoftwo
+ \let\mglslastelementlabel\@empty
+ \let\mglsiflastelementwasfirstuse\@firstoftwo
+ \let\mglsiflastelementwasplural\@secondoftwo
+ \let\mglsiflastelementcapscase\@firstofthree
+ }%
+ \fi
+ \mglsisfirstuse
+ {%
+ \gappto\@mgls@post@hookdefs{\let\mglswasfirstuse\@firstoftwo}%
+ \ifcase\@gls@combined@mpostlink@nr\relax
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\relax}%
+ \or
+ \ifcase\@gls@combined@mpostlinkelement@nr\relax
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastelementpostlinkhook}%
+ \or
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastmainpostlinkhook}%
+ \or
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglscustompostlinkhook}%
+ \fi
+ \or
+ \ifcase\@gls@combined@mpostlinkelement@nr\relax
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastelementpostlinkhook}%
+ \or
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastmainpostlinkhook}%
+ \or
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglscustompostlinkhook}%
+ \fi
+ \or
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\relax}%
+ \fi
+ }%
+ {%
+ \gappto\@mgls@post@hookdefs{\let\mglswasfirstuse\@secondoftwo}%
+ \ifcase\@gls@combined@mpostlink@nr\relax
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\relax}%
+ \or
+ \ifcase\@gls@combined@mpostlinkelement@nr\relax
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastelementpostlinkhook}%
+ \or
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastmainpostlinkhook}%
+ \or
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglscustompostlinkhook}%
+ \fi
+ \or
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\relax}%
+ \or
+ \ifcase\@gls@combined@mpostlinkelement@nr\relax
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastelementpostlinkhook}%
+ \or
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglslastmainpostlinkhook}%
+ \or
+ \gappto\@mgls@post@hookdefs{\let\mgls@do@postlinkhook\mglscustompostlinkhook}%
+ \fi
+ \fi
+ }%
+ \let\mgls@org@postlinkhook\glspostlinkhook
+ \mglsprefix
+ \let\mglslastelementlabel\@empty
+ \@gls@combined@encapsulator
+ {%
+ \def\@mgls@previouslabel{}%
+ \mglselementindex=0\relax
+ \@for\mglscurrentlabel:=\mglscurrentlist\do{%
+ \advance\mglselementindex by 1\relax
+ \glsxtr@setup@docurrent
+ \ifx\@xfor@nextelement\@nnil
+ \let\mglsiflast\@firstoftwo
+ \else
+ \let\mglsiflast\@secondoftwo
+ \mglsisfirstuse
+ {%
+ \glsxtr@mgls@checklastelement{first}{#2}%
+ }%
+ {%
+ \glsxtr@mgls@checklastelement{used}{#2}%
+ }%
+ \fi
+ \ifcase\@gls@combined@postlinks@nr\relax
+ \let\glspostlinkhook\relax
+ \or
+ \let\glspostlinkhook\mgls@org@postlinkhook
+ \or
+ \mglsiflast
+ {%
+ \let\glspostlinkhook\relax
+ }%
+ {%
+ \let\glspostlinkhook\mgls@org@postlinkhook
+ }%
+ \or
+ \ifx\mglscurrentlabel\mglscurrentmainlabel
+ \mglsiflast
+ {%
+ \let\glspostlinkhook\relax
+ }%
+ {%
+ \let\glspostlinkhook\mgls@org@postlinkhook
+ }%
+ \else
+ \let\glspostlinkhook\relax
+ \fi
+ \or
+ \ifx\mglscurrentlabel\mglscurrentmainlabel
+ \let\glspostlinkhook\mgls@org@postlinkhook
+ \else
+ \let\glspostlinkhook\relax
+ \fi
+ \or
+ \ifx\mglscurrentlabel\mglscurrentmainlabel
+ \let\glspostlinkhook\relax
+ \else
+ \mglsiflast
+ {%
+ \let\glspostlinkhook\relax
+ }%
+ {%
+ \let\glspostlinkhook\mgls@org@postlinkhook
+ }%
+ \fi
+ \or
+ \ifx\mglscurrentlabel\mglscurrentmainlabel
+ \let\glspostlinkhook\relax
+ \else
+ \let\glspostlinkhook\mgls@org@postlinkhook
+ \fi
+ \fi
+ \mglsiflast
+ {%
+ \xappto\@mgls@post@hookdefs{%
+ \noexpand\def\noexpand\mglslastelementlabel
+ {\expandonce\mglscurrentlabel}}%
+ }%
+ {}%
+ \@mgls@do@current@element
+ {%
+ \mglselementprehook
+ \GlsXtrIfUnusedOrUndefined{\mglscurrentlabel}%
+ {\let\@mgls@current@iffirstuse\@firstoftwo}%
+ {\let\@mgls@current@iffirstuse\@secondoftwo}%
+ \ifx\mglscurrentlabel\mglscurrentmainlabel
+ \edef\@mgls@current@options{format=\@gls@combined@encapmain}%
+ \ifcase\@gls@combined@indexmain
+ \appto\@mgls@current@options{,noindex}%
+ \or
+ \appto\@mgls@current@options{,noindex=false}%
+ \or
+ \@mgls@current@iffirstuse
+ {\appto\@mgls@current@options{,noindex=false}}%
+ {\appto\@mgls@current@options{,noindex}}%
+ \fi
+ \ifcase\@gls@combined@hyper\relax
+ \appto\@mgls@current@options{,hyper=false}% none
+ \or
+ \appto\@mgls@current@options{,hyper=false}% allmain
+ \or
+ \eappto\@mgls@current@options{,\@mgls@hyper}% mainonly
+ \or
+ \eappto\@mgls@current@options{,\@mgls@hyper}% individual
+ \or
+ \appto\@mgls@current@options{,hyper=false}% otheronly
+ \or
+ \mglsisfirstuse
+ {%
+ \appto\@mgls@current@options{,hyper=false}% notmainfirst
+ }%
+ {%
+ \eappto\@mgls@current@options{,\@mgls@hyper}% notmainfirst
+ }%
+ \or
+ \eappto\@mgls@current@options{,\@mgls@hyper}% nototherfirst
+ \or
+ \mglsisfirstuse
+ {%
+ \appto\@mgls@current@options{,hyper=false}% notfirst
+ }%
+ {%
+ \eappto\@mgls@current@options{,\@mgls@hyper}% notfirst
+ }%
+ \fi
+ \eappto\@mgls@current@options{,\@mgls@all,\@mgls@main}%
+ \else
+ \edef\@mgls@current@options{format=\@gls@combined@encapothers}%
+ \ifcase\@gls@combined@indexothers\relax
+ \appto\@mgls@current@options{,noindex}%
+ \or
+ \appto\@mgls@current@options{,noindex=false}%
+ \or
+ \@mgls@current@iffirstuse
+ {\appto\@mgls@current@options{,noindex=false}}%
+ {\appto\@mgls@current@options{,noindex}}%
+ \fi
+ \ifcase\@gls@combined@hyper\relax
+ \appto\@mgls@current@options{,hyper=false}% none
+ \or
+ \appto\@mgls@current@options{,hyper=false}% allmain
+ \or
+ \appto\@mgls@current@options{,hyper=false}% mainonly
+ \or
+ \eappto\@mgls@current@options{,\@mgls@hyper}% individual
+ \or
+ \eappto\@mgls@current@options{,\@mgls@hyper}% otheronly
+ \or
+ \eappto\@mgls@current@options{,\@mgls@hyper}% notmainfirst
+ \or
+ \mglsisfirstuse
+ {%
+ \appto\@mgls@current@options{,hyper=false}% nototherfirst
+ }%
+ {%
+ \eappto\@mgls@current@options{,\@mgls@hyper}% nototherfirst
+ }%
+ \or
+ \mglsisfirstuse
+ {%
+ \appto\@mgls@current@options{,hyper=false}% notfirst
+ }%
+ {%
+ \eappto\@mgls@current@options{,\@mgls@hyper}% notfirst
+ }%
+ \fi
+ \eappto\@mgls@current@options{,\@mgls@all,\@mgls@others}%
+ \fi
+ \ifx\@mgls@previouslabel\empty
+ \ifx\mglscurrentlabel\mglscurrentmainlabel
+ \let\@mgls@cs#6\relax
+ \else
+ \let\@mgls@cs#4\relax
+ \fi
+ \else
+ \@mgls@previous@iffirstuse
+ {%
+ \@mgls@current@iffirstuse
+ {\glscombinedfirstsepfirst{\@mgls@previouslabel}{\mglscurrentlabel}}%
+ {\glscombinedfirstsep{\@mgls@previouslabel}{\mglscurrentlabel}}%
+ }%
+ {%
+ \@mgls@current@iffirstuse
+ {\glscombinedsepfirst{\@mgls@previouslabel}{\mglscurrentlabel}}%
+ {\glscombinedsep{\@mgls@previouslabel}{\mglscurrentlabel}}%
+ }%
+ \ifx\mglscurrentlabel\mglscurrentmainlabel
+ \let\@mgls@cs#7\relax
+ \else
+ \let\@mgls@cs#5\relax
+ \fi
+ \fi
+ \mglsiflast
+ {\expandafter\@mgls@cs\expandafter{\@mgls@current@options}{\mglscurrentlabel}[#3]}%
+ {\expandafter\@mgls@cs\expandafter{\@mgls@current@options}{\mglscurrentlabel}[]}%
+ \ifx\mglscurrentlabel\mglscurrentmainlabel
+ \xappto\@mgls@post@hookdefs{%
+ \noexpand\def\noexpand\mglslastmainlabel
+ {\expandonce\mglscurrentmainlabel}%
+ }%
+ \glsxtrifwasfirstuse
+ {%
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastmainwasfirstuse\@firstoftwo}%
+ }%
+ {%
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastmainwasfirstuse\@secondoftwo}%
+ }%
+ \glsifplural
+ {%
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastmainwasplural\@firstoftwo}%
+ }%
+ {%
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastmainwasplural\@secondoftwo}%
+ }%
+ \glscapscase
+ {%
+ \gappto\@mgls@post@hookdefs{%
+ \let\mglsiflastmaincapscase\@firstofthree
+ }%
+ }%
+ {%
+ \gappto\@mgls@post@hookdefs{%
+ \let\mglsiflastmaincapscase\@secondofthree
+ }%
+ }%
+ {%
+ \gappto\@mgls@post@hookdefs{%
+ \let\mglsiflastmaincapscase\@thirdofthree
+ }%
+ }%
+ \fi
+ \let\@mgls@previouslabel\mglscurrentlabel
+ \let\@mgls@previous@iffirstuse\@mgls@current@iffirstuse
+ }%
+ \mglselementposthook
+ }%
+ \ifx\mglslastmainlabel\@empty
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastmainskipped\@firstoftwo}%
+ \else
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastmainskipped\@secondoftwo}%
+ \fi
+ \ifx\@mgls@do@current@element\@gobble
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastelementskipped\@firstoftwo}%
+ \else
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastelementskipped\@secondoftwo}%
+ \fi
+ \glsxtrifwasfirstuse
+ {%
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastelementwasfirstuse\@firstoftwo}%
+ }%
+ {%
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastelementwasfirstuse\@secondoftwo}%
+ }%
+ \glsifplural
+ {%
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastelementwasplural\@firstoftwo}%
+ }%
+ {%
+ \gappto\@mgls@post@hookdefs{\let\mglsiflastelementwasplural\@secondoftwo}%
+ }%
+ \glscapscase
+ {%
+ \gappto\@mgls@post@hookdefs{%
+ \let\mglsiflastelementcapscase\@firstofthree
+ }%
+ }%
+ {%
+ \gappto\@mgls@post@hookdefs{%
+ \let\mglsiflastelementcapscase\@secondofthree
+ }%
+ }%
+ {%
+ \gappto\@mgls@post@hookdefs{%
+ \let\mglsiflastelementcapscase\@thirdofthree
+ }%
+ }%
+ }%
+ \@mgls@post@hookdefs
+ \mglssuffix
+ \ifcase\@mgls@unsetaction\relax
+ \xappto\@mgls@post@hookdefs{%
+ \noexpand\mglsunset{\expandonce\mglscurrentmultilabel}}%
+ \or
+ \xappto\@mgls@post@hookdefs{%
+ \noexpand\mglslocalunset{\expandonce\mglscurrentmultilabel}}%
+ \fi
+ }%
+ \glsxtrmglswrite{#2}%
+ \egroup
+ \@mgls@post@hookdefs
+ \mgls@do@postlinkhook
+}
+\newcommand*{\mglscustompostlinkhook}{}
+\newcommand*{\mglslastelementpostlinkhook}{%
+ \let\glsxtrifwasfirstuse\mglsiflastelementwasfirstuse
+ \let\glsifplural\mglsiflastelementwasplural
+ \let\glscapscase\mglsiflastelementcapscase
+ \let\glslabel\mglslastelementlabel
+ \glspostlinkhook
+}
+\newcommand*{\mglslastmainpostlinkhook}{%
+ \let\glsxtrifwasfirstuse\mglsiflastmainwasfirstuse
+ \let\glsifplural\mglsiflastmainwasplural
+ \let\glscapscase\mglsiflastmaincapscase
+ \let\glslabel\mglslastmainlabel
+ \glspostlinkhook
+}
+\newcommand*{\mglsdefcategoryprefix}[2]{%
+ \csdef{mglsprefix@#1}{#2}%
+}
+\newcommand*{\mglshascategoryprefix}[3]{%
+ \ifcsdef{mglsprefix@#1}{#2}{#3}%
+}
+\newcommand*{\mglsusecategoryprefix}[1]{%
+ \csuse{mglsprefix@#1}%
+}
+\newcommand*{\mglsprefix}{%
+ \ifdefempty\mglscurrentcategory
+ {\mglscurrentprefix}%
+ {%
+ \mglshascategoryprefix{\mglscurrentcategory}%
+ {\mglsusecategoryprefix{\mglscurrentcategory}}%
+ {\mglscurrentprefix}%
+ }%
+}
+\newcommand*{\mglsdefcategorysuffix}[2]{%
+ \csdef{mglssuffix@#1}{#2}%
+}
+\newcommand*{\mglshascategorysuffix}[3]{%
+ \ifcsdef{mglssuffix@#1}{#2}{#3}%
+}
+\newcommand*{\mglsusecategorysuffix}[1]{%
+ \csuse{mglssuffix@#1}%
+}
+\newcommand*{\mglssuffix}{%
+ \ifdefempty\mglscurrentcategory
+ {\ifdefempty{\mglscurrentsuffix}{}{\space(\mglscurrentsuffix)}}%
+ {%
+ \mglshascategorysuffix{\mglscurrentcategory}%
+ {\mglsusecategorysuffix{\mglscurrentcategory}}%
+ {\ifdefempty{\mglscurrentsuffix}{}{\space(\mglscurrentsuffix)}}%
+ }%
+}
+\newcommand*{\mglselementprehook}{}
+\newcommand*{\mglselementposthook}{}
+\newcommand*{\glscombinedsep}[2]{%
+ \glshasattribute{#1}{combinedsep}%
+ {\glsgetattribute{#1}{combinedsep}}%
+ { }%
+}
+\newcommand*{\glscombinedfirstsepfirst}[2]{%
+ \glshasattribute{#1}{combinedfirstsepfirst}%
+ {\glsgetattribute{#1}{combinedfirstsepfirst}}%
+ {\glscombinedsep{#1}{#2}}%
+}
+\newcommand*{\glscombinedfirstsep}[2]{%
+ \glshasattribute{#1}{combinedfirstsep}%
+ {\glsgetattribute{#1}{combinedfirstsep}}%
+ {\glscombinedsep{#1}{#2}}%
+}
+\newcommand*{\glscombinedsepfirst}[2]{%
+ \glshasattribute{#1}{combinedsepfirst}%
+ {\glsgetattribute{#1}{combinedsepfirst}}%
+ {\glscombinedsep{#1}{#2}}%
+}
+\newcommand*{\glssetcombinedsepabbrvnbsp}{%
+ \renewcommand*{\glscombinedsep}[2]{%
+ \glshasattribute{##1}{combinedsep}%
+ {\glsgetattribute{##1}{combinedsep}}%
+ {\ifhasshort{##1}{~}{ }}%
+ }%
+ \renewcommand*{\glscombinedsepfirst}[2]{%
+ \glshasattribute{##1}{combinedsepfirst}%
+ {\glsgetattribute{##1}{combinedsepfirst}}%
+ {\ifhasshort{##1}{~}{ }}%
+ }%
+ \renewcommand*{\glscombinedfirstsep}[2]{%
+ \glshasattribute{##1}{combinedfirstsep}%
+ {\glsgetattribute{##1}{combinedfirstsep}}%
+ { }%
+ }%
+ \renewcommand*{\glscombinedfirstsepfirst}[2]{%
+ \glshasattribute{##1}{combinedfirstsepfirst}%
+ {\glsgetattribute{##1}{combinedfirstsepfirst}}%
+ { }%
+ }%
+}
+\newcommand*{\glssetcombinedsepabbrvnone}{%
+ \renewcommand*{\glscombinedsep}[2]{%
+ \glshasattribute{##1}{combinedsep}%
+ {\glsgetattribute{##1}{combinedsep}}%
+ {\ifhasshort{##1}{}{\ifhasshort{##2}{}{ }}}%
+ }%
+ \renewcommand*{\glscombinedsepfirst}[2]{%
+ \glshasattribute{##1}{combinedsepfirst}%
+ {\glsgetattribute{##1}{combinedsepfirst}}%
+ {\ifhasshort{##1}{}{ }}%
+ }%
+ \renewcommand*{\glscombinedfirstsep}[2]{%
+ \glshasattribute{##1}{combinedfirstsep}%
+ {\glsgetattribute{##1}{combinedfirstsep}}%
+ {\ifhasshort{##2}{}{ }}%
+ }%
+ \renewcommand*{\glscombinedfirstsepfirst}[2]{%
+ \glshasattribute{##1}{combinedfirstsepfirst}%
+ {\glsgetattribute{##1}{combinedfirstsepfirst}}%
+ { }%
+ }%
+}
+\newcommand*{\glssetcombinedsepnarrow}[2]{%
+ \renewcommand*{\glscombinedsep}[2]{%
+ \glshasattribute{##1}{combinedsep}%
+ {\glsgetattribute{##1}{combinedsep}}%
+ {%
+ \ifhasshort{##1}%
+ {\settowidth{\dimen@}{\glsentryshort{##1}}}%
+ {\settowidth{\dimen@}{\glsentrytext{##1}}}%
+ \ifdim\dimen@<#1\relax
+ #2%
+ \else
+ \ifhasshort{##2}%
+ {\settowidth{\dimen@}{\glsentryshort{##2}}}%
+ {\settowidth{\dimen@}{\glsentrytext{##2}}}%
+ \ifdim\dimen@<#1\relax
+ #2%
+ \else
+ \space
+ \fi
+ \fi
+ }%
+ }%
+ \renewcommand*{\glscombinedsepfirst}[2]{%
+ \glshasattribute{##1}{combinedsepfirst}%
+ {\glsgetattribute{##1}{combinedsepfirst}}%
+ {%
+ \ifhasshort{##1}%
+ {\settowidth{\dimen@}{\glsentryshort{##1}}}%
+ {\settowidth{\dimen@}{\glsentrytext{##1}}}%
+ \ifdim\dimen@<#1\relax
+ #2%
+ \else
+ \ifhaslong{##2}%
+ {\settowidth{\dimen@}{\glsentrylong{##2}}}%
+ {\settowidth{\dimen@}{\glsentryfirst{##2}}}%
+ \ifdim\dimen@<#1\relax
+ #2%
+ \else
+ \space
+ \fi
+ \fi
+ }%
+ }%
+ \renewcommand*{\glscombinedfirstsep}[2]{%
+ \glshasattribute{##1}{combinedfirstsep}%
+ {\glsgetattribute{##1}{combinedfirstsep}}%
+ {%
+ \ifhaslong{##1}%
+ {\settowidth{\dimen@}{\glsentrylong{##1}}}%
+ {\settowidth{\dimen@}{\glsentryfirst{##1}}}%
+ \ifdim\dimen@<#1\relax
+ #2%
+ \else
+ \ifhasshort{##2}%
+ {\settowidth{\dimen@}{\glsentryshort{##2}}}%
+ {\settowidth{\dimen@}{\glsentrytext{##2}}}%
+ \ifdim\dimen@<#1\relax
+ #2%
+ \else
+ \space
+ \fi
+ \fi
+ }%
+ }%
+ \renewcommand*{\glscombinedfirstsepfirst}[2]{%
+ \glshasattribute{##1}{combinedfirstsepfirst}%
+ {\glsgetattribute{##1}{combinedfirstsepfirst}}%
+ {%
+ \ifhaslong{##1}%
+ {\settowidth{\dimen@}{\glsentrylong{##1}}}%
+ {\settowidth{\dimen@}{\glsentryfirst{##1}}}%
+ \ifdim\dimen@<#1\relax
+ #2%
+ \else
+ \ifhaslong{##2}%
+ {\settowidth{\dimen@}{\glsentrylong{##2}}}%
+ {\settowidth{\dimen@}{\glsentryfirst{##2}}}%
+ \ifdim\dimen@<#1\relax
+ #2%
+ \else
+ \space
+ \fi
+ \fi
+ }%
+ }%
+}
+\newcommand{\glsxtrmglswrite}[1]{%
+ \ifx\@glsxtr@record@setting\@glsxtr@record@setting@off
+ \else
+ \protected@edef\@glsxtr@mglslabel{#1}%
+ \ifdef\@glsxtr@mglsreflist
+ {%
+ \expandafter\DTLifinlist\expandafter{\@glsxtr@mglslabel}%
+ {\@glsxtr@mglsreflist}{}%
+ {%
+ \xappto\@glsxtr@mglsreflist{,\expandonce\@glsxtr@mglslabel}%
+ \if@mgls@writeseparaterefs
+ \protected@write\@auxout{}{\string\@glsxtr@mglsrefs{#1}}%
+ \fi
+ }%
+ }%
+ {%
+ \global\let\@glsxtr@mglsreflist\@glsxtr@mglslabel
+ \if@mgls@writeseparaterefs
+ \protected@write\@auxout{}{\string\@glsxtr@mglsrefs{#1}}%
+ \else
+ \AtEndDocument{\immediate\protected@write\@auxout{}%
+ {\string\@glsxtr@mglsrefs{\@glsxtr@mglsreflist}}}%
+ \fi
+ \@mgls@disable@writeseparateref@cond
+ }%
+ \fi
+}
+\newcommand{\@glsxtr@mglsrefs}[1]{}
+\newif\if@mgls@writeseparaterefs \@mgls@writeseparaterefsfalse
+\newcommand{\mglsWriteSeparateRefsTrue}{\global\@mgls@writeseparaterefstrue}
+\newcommand{\mglsWriteSeparateRefsFalse}{\global\@mgls@writeseparaterefsfalse}
+\newcommand*{\@mgls@disable@writeseparateref@cond}{%
+ \gdef\mglsWriteSeparateRefsTrue{\PackageError{glossaries-extra}%
+ {Too late to use \string\mglsWriteSeparateRefsTrue}%
+ {\string\mglsWriteSeparateRefsTrue\space can only be used before
+ the first instance of any \string\mgls-like command}}%
+ \gdef\mglsWriteSeparateRefsFalse{\PackageError{glossaries-extra}%
+ {Too late to use \string\mglsWriteSeparateRefsFalse}%
+ {\string\mglsWriteSeparateRefsFalse\space can only be used before
+ the first instance of any \string\mgls-like command}}%
+}
+\newcommand{\glsxtr@newmgls}[5]{%
+ \edef\@glsxr@newmgls@do{%
+ \noexpand\newrobustcmd*{\expandonce{\csname #1\endcsname}}%
+ {\noexpand\@gls@hyp@opt\expandonce{\csname ns@glsxtr@#1\endcsname}}%
+ \noexpand\newcommand*{\expandonce{\csname ns@glsxtr@#1\endcsname}}[2][]{%
+ \noexpand\new@ifnextchar[%
+ {\expandonce{\csname glsxtr@#1\endcsname}{####1}{####2}}%
+ {\expandonce{\csname glsxtr@#1\endcsname}{####1}{####2}[]}%
+ }%
+ \noexpand\def\expandonce{\csname glsxtr@#1\endcsname}####1####2[####3]{%
+ \noexpand\def\noexpand\glsxtrcurrentmglscsname{#1}%
+ \noexpand\glsxtr@mgls@inner{####1}{####2}{####3}%
+ {\noexpand#2}{\noexpand#3}{\noexpand#4}{\noexpand#5}%
+ }%
+ }%
+ \@glsxr@newmgls@do
+ \ifx\@glsxtr@record@setting\@glsxtr@record@setting@off
+ \else
+ \ifdef\@glsxtr@mglslikelist
+ {\xappto\@glsxtr@mglslikelist{,#1}}%
+ {%
+ \gdef\@glsxtr@mglslikelist{#1}%
+ \AtEndDocument{\immediate\protected@write\@auxout{}%
+ {\string\@glsxtr@mglslike{\@glsxtr@mglslikelist}}}%
+ }%
+ \fi
+}
+\newcommand*{\@glsxtr@mglslike}[1]{}
+\newcommand*{\GlsXtrMglsOrGls}[2]{%
+ \def\@glsxtr@mgls@or@gls@mcs{#1}%
+ \def\@glsxtr@mgls@or@gls@gcs{#2}%
+ \@ifstar{\s@GlsXtrMglsOrGls}%
+ {%
+ \@ifnextchar+{\PLUS\@firstoftwo{\p@GlsXtrMglsOrGls}}%
+ {%
+ \ifdefempty\@gls@alt@hyp@opt@char\@GlsXtrMglsOrGls\alt@GlsXtrMglsOrGls
+ }%
+ }%
+}
+\newcommand*{\alt@GlsXtrMglsOrGls}{
+ \expandafter\@ifnextchar\@gls@alt@hyp@opt@char
+ {\@firstoftwo{\@alt@GlsXtrMglsOrGls}}{\@GlsXtrMglsOrGls}%
+}
+\newcommand*{\@GlsXtrMglsOrGls}[2][]{%
+ \glsxtrifmulti{#2}%
+ {\@glsxtr@mgls@or@gls@mcs[#1]{#2}}%
+ {\@glsxtr@mgls@or@gls@gcs[#1]{#2}}%
+}
+\newcommand*{\s@GlsXtrMglsOrGls}[2][]{%
+ \glsxtrifmulti{#2}%
+ {\@glsxtr@mgls@or@gls@mcs*[#1]{#2}}%
+ {\@glsxtr@mgls@or@gls@gcs*[#1]{#2}}%
+}
+\newcommand*{\p@GlsXtrMglsOrGls}[2][]{%
+ \glsxtrifmulti{#2}%
+ {\@glsxtr@mgls@or@gls@mcs+[#1]{#2}}%
+ {\@glsxtr@mgls@or@gls@gcs+[#1]{#2}}%
+}
+\newcommand*{\@alt@GlsXtrMglsOrGls}[2][]{%
+ \glsxtrifmulti{#2}%
+ {\expandafter\@glsxtr@mgls@or@gls@mcs\@gls@alt@hyp@opt@char[#1]{#2}}%
+ {\expandafter\@glsxtr@mgls@or@gls@gcs\@gls@alt@hyp@opt@char[#1]{#2}}%
+}
+\glsxtr@newmgls{mgls}{\@gls@}{\@gls@}{\@gls@}{\@gls@}%
+\glsxtr@newmgls{mglspl}{\@glspl@}{\@glspl@}{\@glspl@}{\@glspl@}%
+\glsxtr@newmgls{mglsmainpl}{\@gls@}{\@gls@}{\@glspl@}{\@glspl@}%
+\glsxtr@newmgls{Mgls}{\@Gls@}{\@gls@}{\@Gls@}{\@gls@}%
+\glsxtr@newmgls{Mglspl}{\@Glspl@}{\@glspl@}{\@Glspl@}{\@glspl@}%
+\glsxtr@newmgls{Mglsmainpl}{\@Gls@}{\@gls@}{\@Glspl@}{\@glspl@}%
+\glsxtr@newmgls{MGls}{\@Gls@}{\@Gls@}{\@Gls@}{\@Gls@}%
+\glsxtr@newmgls{MGlspl}{\@Glspl@}{\@Glspl@}{\@Glspl@}{\@Glspl@}%
+\glsxtr@newmgls{MGlsmainpl}{\@Gls@}{\@Gls@}{\@Glspl@}{\@Glspl@}%
+\glsxtr@newmgls{MGLS}{\@GLS@}{\@GLS@}{\@GLS@}{\@GLS@}%
+\glsxtr@newmgls{MGLSpl}{\@GLSpl@}{\@GLSpl@}{\@GLSpl@}{\@GLSpl@}%
+\glsxtr@newmgls{MGLSmainpl}{\@GLS@}{\@GLS@}{\@GLSpl@}{\@GLSpl@}%
+\def\@glslongortext#1#2[#3]{%
+ \ifglshaslong{#2}{\@glsxtrlong{#1}{#2}[#3]}{\@glstext@{#1}{#2}[#3]}%
+}
+\def\@glsshortortext#1#2[#3]{%
+ \ifglshasshort{#2}{\@glsxtrshort{#1}{#2}[#3]}{\@glstext@{#1}{#2}[#3]}%
+}
+\def\@glsfullorfirst#1#2[#3]{%
+ \ifglshasshort{#2}{\@glsxtr@full{#1}{#2}[#3]}{\@glsfirst@{#1}{#2}[#3]}%
+}
+\def\@Glslongortext#1#2[#3]{%
+ \ifglshaslong{#2}{\@Glsxtrlong{#1}{#2}[#3]}{\@Glstext@{#1}{#2}[#3]}%
+}
+\def\@Glsshortortext#1#2[#3]{%
+ \ifglshasshort{#2}{\@Glsxtrshort{#1}{#2}[#3]}{\@Glstext@{#1}{#2}[#3]}%
+}
+\def\@Glsfullorfirst#1#2[#3]{%
+ \ifglshasshort{#2}{\@Glsxtr@full{#1}{#2}[#3]}{\@Glsfirst@{#1}{#2}[#3]}%
+}
+\glsxtr@newmgls{mglsshort}%
+{\@glsshortortext}{\@glsshortortext}{\@glsshortortext}{\@glsshortortext}%
+\glsxtr@newmgls{mglslong}%
+{\@glslongortext}{\@glslongortext}{\@glslongortext}{\@glslongortext}%
+\glsxtr@newmgls{mglsfull}%
+{\@glsfullorfirst}{\@glsfullorfirst}{\@glsfullorfirst}{\@glsfullorfirst}%
+\glsxtr@newmgls{Mglsshort}%
+{\@Glsshortortext}{\@glsshortortext}{\@Glsshortortext}{\@glsshortortext}%
+\glsxtr@newmgls{Mglslong}%
+{\@Glslongortext}{\@glslongortext}{\@Glslongortext}{\@glslongortext}%
+\glsxtr@newmgls{Mglsfull}%
+{\@Glsfullorfirst}{\@glsfullorfirst}{\@Glsfullorfirst}{\@glsfullorfirst}%
+\glsxtr@newmgls{mglsname}%
+ {\@glsname@}{\@glsname@}{\@glsname@}{\@glsname@}%
+\glsxtr@newmgls{Mglsname}%
+ {\@Glsname@}{\@glsname@}{\@Glsname@}{\@glsname@}%
+\glsxtr@newmgls{MGlsname}%
+ {\@Glsname@}{\@Glsname@}{\@Glsname@}{\@Glsname@}%
+\def\@glssymbolorgls#1#2[#3]{%
+ \ifglshassymbol{#2}{\@glssymbol@{#1}{#2}[#3]}{\@gls@{#1}{#2}[#3]}%
+}
+\def\@glssymbolorGls#1#2[#3]{%
+ \ifglshassymbol{#2}{\@glssymbol@{#1}{#2}[#3]}{\@Gls@{#1}{#2}[#3]}%
+}
+\glsxtr@newmgls{mglssymbol}%
+ {\@glssymbolorgls}{\@glssymbolorgls}{\@glssymbolorgls}{\@glssymbolorgls}%
+\glsxtr@newmgls{Mglssymbol}%
+ {\@glssymbolorGls}{\@glssymbolorgls}{\@glssymbolorGls}{\@glssymbolorgls}%
+\glsxtr@newmgls{MGlssymbol}%
+ {\@glssymbolorGls}{\@glssymbolorGls}{\@glssymbolorGls}{\@glssymbolorGls}%
+\newcommand{\mglsfield}{useri}
+\def\@glsfieldorgls#1#2[#3]{%
+ \glsxtrifhasfield{\mglsfield}{#2}%
+ {\@glsdisp[#1]{#2}{\glscurrentfieldvalue#3}}%
+ {\@gls@{#1}{#2}[#3]}%
+}
+\def\@Glsfieldorgls#1#2[#3]{%
+ \glsxtrifhasfield{\mglsfield}{#2}%
+ {\@glsdisp[#1]{#2}{\xmakefirstuc\glscurrentfieldvalue#3}}%
+ {\@Gls@{#1}{#2}[#3]}%
+}
+\glsxtr@newmgls{mglsusefield}%
+ {\@glsfieldorgls}{\@glsfieldorgls}{\@glsfieldorgls}{\@glsfieldorgls}%
+\glsxtr@newmgls{Mglsusefield}%
+ {\@Glsfieldorgls}{\@glsfieldorgls}{\@Glsfieldorgls}{\@glsfieldorgls}%
+\glsxtr@newmgls{MGlsusefield}%
+ {\@Glsfieldorgls}{\@Glsfieldorgls}{\@Glsfieldorgls}{\@Glsfieldorgls}%
+\newcommand*{\mpglsWarning}{%
+ \GlossariesExtraWarning{glossaries-prefix.sty is required for
+ \string\mpgls\space family of commands (either load after
+ glossaries-extra.sty or use the `prefix' package option)}%
+}
+\def\@pglsorgls#1#2[#3]{%
+ \ifdef\@pgls@{\@pgls@{#1}{#2}[#3]}{\mpglsWarning\@gls@{#1}{#2}[#3]}%
+}
+\def\@pglsorglspl#1#2[#3]{%
+ \ifdef\@pglspl@{\@pglspl@{#1}{#2}[#3]}{\mpglsWarning\@glspl@{#1}{#2}[#3]}%
+}
+\def\@Pglsorgls#1#2[#3]{%
+ \ifdef\@Pgls@{\@Pgls@{#1}{#2}[#3]}{\mpglsWarning\@Gls@{#1}{#2}[#3]}%
+}
+\def\@pglsorglspl#1#2[#3]{%
+ \ifdef\@pglspl@{\@pglspl@{#1}{#2}[#3]}{\mpglsWarning\@glspl@{#1}{#2}[#3]}%
+}
+\def\@Pglsorglspl#1#2[#3]{%
+ \ifdef\@Pglspl@{\@Pglspl@{#1}{#2}[#3]}{\mpglsWarning\@Glspl@{#1}{#2}[#3]}%
+}
+\def\@PGLSorgls#1#2[#3]{%
+ \ifdef\@PGLS@{\@PGLS@{#1}{#2}[#3]}{\mpglsWarning\@GLS@{#1}{#2}[#3]}%
+}
+\def\@PGLSorglspl#1#2[#3]{%
+ \ifdef\@PGLSpl@{\@PGLSpl@{#1}{#2}[#3]}{\mpglsWarning\@GLSpl@{#1}{#2}[#3]}%
+}
+\glsxtr@newmgls{mpgls}{\@pglsorgls@}{\@gls@}{\@pglsorgls@}{\@gls@}%
+\glsxtr@newmgls{mpglspl}{\@pglsorglspl@}{\@glspl@}{\@pglsorglspl@}{\@glspl@}%
+\glsxtr@newmgls{mpglsmainpl}{\@pglsorgls@}{\@gls@}{\@pglsorglspl@}{\@glspl@}%
+\glsxtr@newmgls{Mpgls}{\@Pglsorgls@}{\@gls@}{\@Pglsorgls@}{\@gls@}%
+\glsxtr@newmgls{Mpglspl}{\@Pglsorglspl@}{\@glspl@}{\@Pglsorglspl@}{\@glspl@}%
+\glsxtr@newmgls{Mpglsmainpl}{\@Pglsorgls@}{\@gls@}{\@Pglsorglspl@}{\@glspl@}%
+\glsxtr@newmgls{MPGls}{\@Pglsorgls@}{\@Gls@}{\@Pglsorgls@}{\@Gls@}%
+\glsxtr@newmgls{MPGlspl}{\@Pglsorglspl@}{\@Glspl@}{\@Pglsorglspl@}{\@Glspl@}%
+\glsxtr@newmgls{MPGlsmainpl}{\@Pglsorgls@}{\@Gls@}{\@Pglsorglspl@}{\@Glspl@}%
+\glsxtr@newmgls{MPGLS}{\@PGLSorgls@}{\@GLS@}{\@PGLSorgls@}{\@GLS@}%
+\glsxtr@newmgls{MPGLSpl}{\@PGLSorglspl@}{\@GLSpl@}{\@PGLSorglspl@}{\@GLSpl@}%
+\glsxtr@newmgls{MPGLSmainpl}{\@PGLSorgls@}{\@GLS@}{\@PGLSorglspl@}{\@GLSpl@}%
+\newcommand*{\RequireGlossariesExtraLang}[1]{%
+ \@ifundefined{ver@glossariesxtr-#1.ldf}{\input{glossariesxtr-#1.ldf}}{}%
+}
+\newcommand*{\ProvidesGlossariesExtraLang}[1]{%
+ \ProvidesFile{glossariesxtr-#1.ldf}%
+}
+\newcommand{\glsxtr@loaddialect}{%
+ \IfTrackedLanguageFileExists{\this@dialect}%
+ {glossariesxtr-}% prefix
+ {.ldf}%
+ {%
+ \RequireGlossariesExtraLang{\CurrentTrackedTag}%
+ }%
+ {}% not found
+ \@glsxtrdialecthook
+}
+\@ifpackageloaded{tracklang} {%
+ \AnyTrackedLanguages
+ {%
+ \ForEachTrackedDialect{\this@dialect}{\glsxtr@loaddialect}%
+ }%
+ {}%
+} {}
+\@glsxtr@redefstyles
+\@glsxtr@do@style
+% \end{macrocode}
+%\iffalse
+% \begin{macrocode}
+%</glossaries-extra-2021-11-22.sty>
+% \end{macrocode}
+%\fi
+%\iffalse
+% \begin{macrocode}
+%<*glossaries-extra-bib2gls-2021-11-22.sty>
+% \end{macrocode}
+%\fi
+%\subsection{Rollback v1.48 (glossaries-extra-bib2gls-2021-11-22.sty)}
+% Version 1.48 preserved for rollback.
+% \begin{macrocode}
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{glossaries-extra-bib2gls}[2021/11/22 v1.48 (NLCT)]
+\ifglsacronym
+ \providecommand*{\printunsrtacronyms}[1][]{%
+ \printunsrtglossary[type=\acronymtype,#1]}%
+\fi
+\ifglossaryexists{index}
+{
+ \providecommand*{\printunsrtindex}[1][]{%
+ \printunsrtglossary[type=index,#1]}%
+}{}
+\ifglossaryexists{symbols}
+{
+ \providecommand*{\printunsrtsymbols}[1][]{%
+ \printunsrtglossary[type=symbols,#1]}%
+}{}
+\ifglossaryexists{numbers}
+{
+ \providecommand*{\printunsrtnumbers}[1][]{%
+ \printunsrtglossary[type=numbers,#1]}%
+}{}
+\ifglossaryexists{abbreviations}
+{
+ \providecommand*{\printunsrtabbreviations}[1][]{%
+ \printunsrtglossary[type=abbreviations,#1]}%
+}{}
+\renewcommand*{\glsdisplaynumberlist}[1]{%
+ \glsdoifexists{#1}%
+ {%
+ {\let\bibglsdelimN\glsnumlistsep
+ \let\bibglslastDelimN\glsnumlistlastsep
+ \glsxtrusefield{#1}{location}%
+ }%
+ }%
+}
+\robustify\glsdisplaynumberlist
+\renewcommand*{\glsentrynumberlist}[1]{\glsxtrusefield{#1}{location}}
+\newcommand*{\glshex}{\string\u}
+\newcommand*{\glscapturedgroup}{\string\$}
+\newcommand*{\GlsXtrIfHasNonZeroChildCount}{%
+ \@ifstar\s@GlsXtrIfHasNonZeroChildCount\@GlsXtrIfHasNonZeroChildCount
+}
+\newcommand*{\@GlsXtrIfHasNonZeroChildCount}[3]{%
+ \@GlsXtrIfFieldNonZero{childcount}{#1}{#2}{#3}%
+}
+\newcommand*{\s@GlsXtrIfHasNonZeroChildCount}[3]{%
+ \s@GlsXtrIfFieldNonZero{childcount}{#1}{#2}{#3}%
+}
+\newcommand*{\glsxtrprovidecommand}{\providecommand}
+\newcommand*{\glsrenewcommand}{\@star@or@long\glsxtr@renewcommand}
+\newcommand*{\glsxtr@renewcommand}[1]{%
+ \begingroup \escapechar\m@ne\xdef\@gtempa{{\string#1}}\endgroup
+ \expandafter\@ifundefined\@gtempa
+ {%
+ \GlossariesExtraWarning{can't redefine \noexpand#1(not already defined)}%
+ }%
+ \relax
+ \relax
+ \let\@ifdefinable\@rc@ifdefinable
+ \new@command#1%
+}
+\newcommand*{\glsxtr@wrglossarylocation}[2]{#1}
+\ifdef\hyperref
+{%
+ \newcommand*{\GlsXtrIndexCounterLink}[2]{%
+ \glsxtrifhasfield{indexcounter}{#2}%
+ {\hyperref[wrglossary.\glscurrentfieldvalue]{#1}}%
+ {#1}%
+ }
+}
+{
+ \newcommand*{\GlsXtrIndexCounterLink}[2]{#1}
+}
+\newcommand*{\GlsXtrDualField}{dual}
+\newcommand*{\GlsXtrDualBackLink}[2]{%
+ \glsxtrifhasfield{\GlsXtrDualField}{#2}%
+ {\glshyperlink[#1]{\glscurrentfieldvalue}}%
+ {#2}%
+}
+\newcommand*{\GlsXtrBibTeXEntryAliases}{%
+ article=bibtexentry,
+ book=bibtexentry,
+ booklet=bibtexentry,
+ conference=bibtexentry,
+ inbook=bibtexentry,
+ incollection=bibtexentry,
+ inproceedings=bibtexentry,
+ manual=bibtexentry,
+ mastersthesis=bibtexentry,
+ misc=bibtexentry,
+ phdthesis=bibtexentry,
+ proceedings=bibtexentry,
+ techreport=bibtexentry,
+ unpublished=bibtexentry
+}
+\newcommand*{\GlsXtrProvideBibTeXFields}{%
+ \glsaddstoragekey{address}{}{\glsxtrbibaddress}%
+ \glsaddstoragekey{author}{}{\glsxtrbibauthor}%
+ \glsaddstoragekey{booktitle}{}{\glsxtrbibbooktitle}%
+ \glsaddstoragekey{chapter}{}{\glsxtrbibchapter}%
+ \glsaddstoragekey{edition}{}{\glsxtrbibedition}%
+ \glsaddstoragekey{howpublished}{}{\glsxtrbibhowpublished}%
+ \glsaddstoragekey{institution}{}{\glsxtrbibinstitution}%
+ \glsaddstoragekey{journal}{}{\glsxtrbibjournal}%
+ \glsaddstoragekey{month}{}{\glsxtrbibmonth}%
+ \glsaddstoragekey{note}{}{\glsxtrbibnote}%
+ \glsaddstoragekey{number}{}{\glsxtrbibnumber}%
+ \glsaddstoragekey{organization}{}{\glsxtrbiborganization}%
+ \glsaddstoragekey{pages}{}{\glsxtrbibpages}%
+ \glsaddstoragekey{publisher}{}{\glsxtrbibpublisher}%
+ \glsaddstoragekey{school}{}{\glsxtrbibschool}%
+ \glsaddstoragekey{series}{}{\glsxtrbibseries}%
+ \glsaddstoragekey{title}{}{\glsxtrbibtitle}%
+ \glsaddstoragekey{bibtextype}{}{\glsxtrbibtype}%
+ \glsaddstoragekey{volume}{}{\glsxtrbibvolume}%
+}
+\newcommand*{\glsxtrmultisupplocation}[3]{%
+ {%
+ \def\glsxtrsupplocationurl{#2}%
+ \glshypernumber{#1}%
+ }%
+}
+\newcommand*\glsxtrdisplaysupploc[5]{%
+ \setentrycounter[#1]{#2}%
+ \glsxtrmultisupplocation{#5}{#4}{#3}%
+}
+\ifundef\hyperlink
+{
+ \newcommand*{\glsxtrdisplaylocnameref}[8]{%
+ \glsnoidxdisplayloc{#1}{#2}{#3}{#4}%
+ }
+}
+{
+ \newcommand*{\glsxtrdisplaylocnameref}[8]{%
+ \ifcsdef{glsxtr#2locfmt}%
+ {\glsxtrnamereflink{#3}{\csuse{glsxtr#2locfmt}{#4}{#5}}{#2.#7}{#8}}%
+ {%
+ \ifstrempty{#5}%
+ {%
+ \glsxtrnamereflink{#3}{#4}{#2.#7}{#8}%
+ }%
+ {%
+ \ifstrequal{#2}{page}%
+ {\glsxtrnamereflink{#3}{#4}{#2.#7}{#8}}%
+ {\glsxtrnamereflink{#3}{#5}{#2.#7}{#8}}%
+ }%
+ }%
+ }
+}
+\newcommand*{\glsxtrequationlocfmt}[2]{(#1)}
+\newcommand*{\glsxtrnamereflink}[4]{%
+ \begingroup
+ \let\glshypernumber\@firstofone
+ \ifstrempty{#4}%
+ {\glsxtrfmtinternalnameref{#3}{#1}{#2}}%
+ {\glsxtrfmtexternalnameref{#3}{#1}{#2}{#4}}%
+ \endgroup
+}
+\newcommand{\glsxtrnameloclink}[6]{%
+ \begingroup
+ \setentrycounter[#1]{#2}%
+ \def\glsxtr@locationhypertext{#5}%
+ \let\glshypernumber\@firstofone
+ \def\@glsnumberformat{#3}%
+ \def\glsxtrsupplocationurl{#6}%
+ \toks@={}%
+ \@glsxtr@bibgls@removespaces#4 \@nil
+ \endgroup
+}
+\def\@glsxtr@bibgls@removespaces#1 #2\@nil{%
+ \toks@=\expandafter{\the\toks@#1}%
+ \ifx\\#2\\%
+ \edef\@glo@tmp{\the\toks@}%
+ \ifx\@glo@tmp\empty
+ \else
+ \protected@edef\@glo@tmp{\glsentrycounter\@glo@counterprefix\the\toks@}%
+ \ifdefvoid\glsxtrsupplocationurl
+ {%
+ \expandafter\glsxtrfmtinternalnameref\expandafter{\@glo@tmp}%
+ {\@glsnumberformat}{\glsxtr@locationhypertext}%
+ }%
+ {%
+ \expandafter\glsxtrfmtexternalnameref\expandafter{\@glo@tmp}%
+ {\@glsnumberformat}{\glsxtr@locationhypertext}{\glsxtrsupplocationurl}%
+ }%
+ \fi
+ \else
+ \@gls@ReturnAfterFi{%
+ \@glsxtr@bibgls@removespaces#2\@nil
+ }%
+ \fi
+}
+\newcommand*{\glsxtrfmtinternalnameref}[3]{%
+ \csuse{#2}{\glsdohyperlink{#1}{#3}}%
+}
+\newcommand*{\glsxtrfmtexternalnameref}[4]{%
+ \csuse{#2}{\hyperref{#4}{}{#1}{#3}}%
+}
+\newcommand*{\glsxtrSetWidest}[3]{%
+ \ifdef\glsupdatewidest
+ {%
+ \ifdef\glslongextraUpdateWidest
+ {%
+ \ifstrempty{#1}
+ {%
+ \glsupdatewidest[#2]{#3}%
+ \ifnum#2=0\relax
+ \glslongextraUpdateWidest{#3}%
+ \else
+ \glslongextraUpdateWidestChild{#2}{#3}%
+ \fi
+ }%
+ {%
+ \apptoglossarypreamble[#1]{\glsupdatewidest[#2]{#3}}%
+ \ifnum#2=0\relax
+ \apptoglossarypreamble[#1]{\glslongextraUpdateWidest{#3}}%
+ \else
+ \apptoglossarypreamble[#1]{\glslongextraUpdateWidestChild{#2}{#3}}%
+ \fi
+ }%
+ }%
+ {%
+ \ifstrempty{#1}
+ {%
+ \glsupdatewidest[#2]{#3}%
+ }%
+ {%
+ \apptoglossarypreamble[#1]{\glsupdatewidest[#2]{#3}}%
+ }%
+ }%
+ }%
+ {%
+ \ifdef\glssetwidest
+ {%
+ \ifdef\glslongextraUpdateWidest
+ {%
+ \ifstrempty{#1}
+ {%
+ \glssetwidest[#2]{#3}%
+ \ifnum#2=0\relax
+ \glslongextraUpdateWidest{#3}%
+ \else
+ \glslongextraUpdateWidestChild{#2}{#3}%
+ \fi
+ }%
+ {%
+ \apptoglossarypreamble[#1]{\glssetwidest[#2]{#3}}%
+ \ifnum#2=0\relax
+ \apptoglossarypreamble[#1]{\glslongextraUpdateWidest{#3}}%
+ \else
+ \apptoglossarypreamble[#1]{\glslongextraUpdateWidestChild{#2}{#3}}%
+ \fi
+ }%
+ }%
+ {%
+ \ifstrempty{#1}
+ {%
+ \glssetwidest[#2]{#3}%
+ }%
+ {%
+ \apptoglossarypreamble[#1]{\glssetwidest[#2]{#3}}%
+ }%
+ }%
+ }%
+ {%
+ \ifdef\glslongextraUpdateWidest
+ {%
+ \ifstrempty{#1}
+ {%
+ \ifnum#2=0\relax
+ \glslongextraUpdateWidest{#3}%
+ \else
+ \glslongextraUpdateWidestChild{#2}{#3}%
+ \fi
+ }%
+ {%
+ \ifnum#2=0\relax
+ \apptoglossarypreamble[#1]{\glslongextraUpdateWidest{#3}}%
+ \else
+ \apptoglossarypreamble[#1]{\glslongextraUpdateWidestChild{#2}{#3}}%
+ \fi
+ }%
+ }%
+ {}%
+ }%
+ }%
+}
+\newcommand*{\glsxtrSetWidestFallback}[2]{%
+ \ifnum#1=0\relax
+ \ifdef\glsFindWidestTopLevelName
+ {%
+ \glsFindWidestTopLevelName[#2]%
+ }%
+ {%
+ \GlossariesExtraWarning{You need stylemods={tree} to
+ provide a fallback for set-widest}%
+ }%
+ \else
+ \ifdef\glsFindWidestLevelTwo
+ {%
+ \glsFindWidestLevelTwo[#2]%
+ \ifdef\glslongextraUpdateWidestChild
+ {%
+ \glslongextraUpdateWidestChild{#1}{\csuse{@glswidestnamei}}%
+ \glslongextraUpdateWidestChild{#1}{\csuse{@glswidestnameii}}%
+ }%
+ {}%
+ }%
+ {%
+ \GlossariesExtraWarning{You need stylemods={tree} to
+ provide a fallback for set-widest}%
+ }%
+ \fi
+}
+\newcommand*{\@glsxtr@labelprefixes}{}
+\newcommand*{\glsxtrclearlabelprefixes}{%
+ \renewcommand*{\@glsxtr@labelprefixes}{}%
+}
+\newcommand*{\glsxtraddlabelprefix}[1]{%
+ \ifstrempty{#1}%
+ {\glsxtraddlabelprefix{\empty}}%
+ {%
+ \ifdefempty\@glsxtr@labelprefixes
+ {\def\@glsxtr@labelprefixes{#1}}%
+ {\appto\@glsxtr@labelprefixes{,#1}}%
+ }%
+}
+\newcommand*{\glsxtrprependlabelprefix}[1]{%
+ \ifstrempty{#1}%
+ {\glsxtrprependlabelprefix{\empty}}%
+ {%
+ \ifdefempty\@glsxtr@labelprefixes
+ {\def\@glsxtr@labelprefixes{#1}}%
+ {\preto\@glsxtr@labelprefixes{#1,}}%
+ }%
+}
+\newcommand*{\glsxtrifinlabelprefixlist}[3]{%
+ \ifstrempty{#1}%
+ {\glsxtrifinlabelprefixlist{\empty}{#2}{#3}}%
+ {%
+ \DTLifinlist{#1}{\@glsxtr@labelprefixes}{#2}{#3}%
+ }%
+}
+\AtBeginDocument{%
+ \protected@write\@auxout{}{\string\providecommand{\string\@glsxtr@prefixlabellist}[1]{}}%
+ \protected@write\@auxout{}{\string\@glsxtr@prefixlabellist{\@glsxtr@labelprefixes}}%
+}
+\newcommand*{\@glsxtr@get@prefixedlabel}[1]{%
+ \begingroup
+ \protected@edef\@gls@thislabel{#1}%
+ \@for\@glsxtr@prefix:=\@glsxtr@labelprefixes\do
+ {%
+ \protected@edef\@gls@thislabel{\@glsxtr@prefix#1}%
+ \ifglsentryexists{\@gls@thislabel}{\@endfortrue}{}%
+ }%
+ \edef\@glo@tmp{\endgroup\noexpand\def\noexpand\@gls@thislabel{\@gls@thislabel}}\@glo@tmp
+}
+\newrobustcmd*{\dgls}{\@gls@hyp@opt\@dgls}
+\newcommand*{\@dgls}[2][]{%
+ \@glsxtr@get@prefixedlabel{#2}%
+ \new@ifnextchar[{\@gls@{#1}{\@gls@thislabel}}{\@gls@{#1}{\@gls@thislabel}[]}%
+}
+\newrobustcmd*{\dglspl}{\@gls@hyp@opt\@dglspl}
+\newcommand*{\@dglspl}[2][]{%
+ \@glsxtr@get@prefixedlabel{#2}%
+ \new@ifnextchar[{\@glspl@{#1}{\@gls@thislabel}}{\@glspl@{#1}{\@gls@thislabel}[]}%
+}
+\newrobustcmd*{\dGls}{\@gls@hyp@opt\@dGls}
+\newcommand*{\@dGls}[2][]{%
+ \@glsxtr@get@prefixedlabel{#2}%
+ \new@ifnextchar[{\@Gls@{#1}{\@gls@thislabel}}{\@Gls@{#1}{\@gls@thislabel}[]}%
+}
+\newrobustcmd*{\dGlspl}{\@gls@hyp@opt\@dGlspl}
+\newcommand*{\@dGlspl}[2][]{%
+ \@glsxtr@get@prefixedlabel{#2}%
+ \new@ifnextchar[{\@Glspl@{#1}{\@gls@thislabel}}{\@Glspl@{#1}{\@gls@thislabel}[]}%
+}
+\newrobustcmd*{\dGLS}{\@gls@hyp@opt\@dGLS}
+\newcommand*{\@dGLS}[2][]{%
+ \@glsxtr@get@prefixedlabel{#2}%
+ \new@ifnextchar[{\@GLS@{#1}{\@gls@thislabel}}{\@GLS@{#1}{\@gls@thislabel}[]}%
+}
+\newrobustcmd*{\dGLSpl}{\@gls@hyp@opt\@dGLSpl}
+\newcommand*{\@dGLSpl}[2][]{%
+ \@glsxtr@get@prefixedlabel{#2}%
+ \new@ifnextchar[{\@GLSpl@{#1}{\@gls@thislabel}}{\@GLSpl@{#1}{\@gls@thislabel}[]}%
+}
+\newrobustcmd*{\dglslink}[3][]{%
+ \@glsxtr@get@prefixedlabel{#2}%
+ \glslink[#1]{\@gls@thislabel}{#3}%
+}
+\newrobustcmd*{\dglsdisp}[3][]{%
+ \@glsxtr@get@prefixedlabel{#2}%
+ \glsdisp[#1]{\@gls@thislabel}{#3}%
+}
+\newrobustcmd*{\glsxtrmultientryadjustedname}[4]{%
+ \bgroup
+ \let\@glsxtrmultientryadjustednamesep\glsxtrmultientryadjustednamesep
+ \let\@glsxtrmultientryadjustednamepresep\glsxtrmultientryadjustednamepresep
+ \let\@glsxtrmultientryadjustednamepostsep\glsxtrmultientryadjustednamepostsep
+ \let\@glsxtrmultientryadjustednameother\glsxtrmultientryadjustednameother
+ \let\@glsxtrmultientryadjustednamefmt\glsxtrmultientryadjustednamefmt
+ \let\@glsxtrmultientryadjustednamefirstother\glsxtrmultientryadjustednameother
+ \let\@glsxtrmultientryadjustednamefirstfmt\glsxtrmultientryadjustednamefmt
+ \@glsxtrmultientryadjustedname{#1}{#2}{#3}{#4}%
+ \egroup
+}
+\newrobustcmd*{\Glsxtrmultientryadjustedname}[4]{%
+ \bgroup
+ \let\@glsxtrmultientryadjustednamesep\glsxtrmultientryadjustednamesep
+ \let\@glsxtrmultientryadjustednamepresep\glsxtrmultientryadjustednamepresep
+ \let\@glsxtrmultientryadjustednamepostsep\glsxtrmultientryadjustednamepostsep
+ \let\@glsxtrmultientryadjustednameother\glsxtrmultientryadjustednameother
+ \let\@glsxtrmultientryadjustednamefmt\glsxtrmultientryadjustednamefmt
+ \let\@glsxtrmultientryadjustednamefirstother\Glsxtrmultientryadjustednameother
+ \let\@glsxtrmultientryadjustednamefirstfmt\Glsxtrmultientryadjustednamefmt
+ \@glsxtrmultientryadjustedname{#1}{#2}{#3}{#4}%
+ \egroup
+}
+\newrobustcmd*{\GlsXtrmultientryadjustedname}[4]{%
+ \bgroup
+ \let\@glsxtrmultientryadjustednamesep\glsxtrmultientryadjustednamesep
+ \let\@glsxtrmultientryadjustednamepresep\glsxtrmultientryadjustednamepresep
+ \let\@glsxtrmultientryadjustednamepostsep\glsxtrmultientryadjustednamepostsep
+ \let\@glsxtrmultientryadjustednameother\GlsXtrmultientryadjustednameother
+ \let\@glsxtrmultientryadjustednamefmt\GlsXtrmultientryadjustednamefmt
+ \let\@glsxtrmultientryadjustednamefirstother\GlsXtrmultientryadjustednameother
+ \let\@glsxtrmultientryadjustednamefirstfmt\GlsXtrmultientryadjustednamefmt
+ \@glsxtrmultientryadjustedname{#1}{#2}{#3}{#4}%
+ \egroup
+}
+\newrobustcmd*{\GLSxtrmultientryadjustedname}[4]{%
+ \bgroup
+ \let\@glsxtrmultientryadjustednamesep\glsxtrmultientryadjustednamesep
+ \let\@glsxtrmultientryadjustednamepresep\glsxtrmultientryadjustednamepresep
+ \let\@glsxtrmultientryadjustednamepostsep\glsxtrmultientryadjustednamepostsep
+ \let\@glsxtrmultientryadjustednameother\GLSxtrmultientryadjustednameother
+ \let\@glsxtrmultientryadjustednamefmt\GLSxtrmultientryadjustednamefmt
+ \let\@glsxtrmultientryadjustednamefirstother\GLSxtrmultientryadjustednameother
+ \let\@glsxtrmultientryadjustednamefirstfmt\GLSxtrmultientryadjustednamefmt
+ \@glsxtrmultientryadjustedname{#1}{#2}{#3}{#4}%
+ \egroup
+}
+\newcommand*{\@glsxtrmultientryadjustedname}[4]{%
+ \letcs\mglscurrentmainlabel{@gls@combined@#4@main}%
+ \letcs\mglscurrentmainlist{@gls@combined@#4@list}%
+ \letcs\mglscurrentmainoptions{@gls@combined@#4@options}%
+ \ifblank{#1}%
+ {%
+ \@glsxtrmultientryadjustednamefirstfmt{#2}%
+ }%
+ {%
+ \def\@mgls@previouslabel{}%
+ \let\@gls@xtradjustedother\@glsxtrmultientryadjustednamefirstother
+ \@for\mglscurrentlabel:=#1\do{%
+ \ifx\@mgls@previouslabel\empty
+ \else
+ \@glsxtrmultientryadjustednamesep{\@mgls@previouslabel}{\mglscurrentlabel}%
+ \fi
+ \@gls@xtradjustedother{\mglscurrentlabel}%
+ \let\@mgls@previouslabel\mglscurrentlabel
+ \let\@gls@xtradjustedother\@glsxtrmultientryadjustednameother
+ }%
+ \@glsxtrmultientryadjustednamepresep{\@mgls@previouslabel}{\mglscurrentmainlabel}%
+ \@glsxtrmultientryadjustednamefmt{#2}%
+ }%
+ \ifblank{#3}%
+ {}%
+ {%
+ \let\@mgls@previouslabel\mglscurrentmainlabel
+ \let\@gls@xtrmultientryadjustednamesep\@glsxtrmultientryadjustednamepostsep
+ \@for\mglscurrentlabel:=#3\do{%
+ \@gls@xtrmultientryadjustednamesep{\@mgls@previouslabel}{\mglscurrentlabel}%
+ \@glsxtrmultientryadjustednameother{\mglscurrentlabel}%
+ \let\@mgls@previouslabel\mglscurrentlabel
+ \let\@gls@xtrmultientryadjustednamesep\@glsxtrmultientryadjustednamesep
+ }%
+ }%
+}
+\newcommand*{\glsxtrmultientryadjustednamesep}{\glscombinedfirstsepfirst}
+\newcommand*{\glsxtrmultientryadjustednamepresep}{\glsxtrmultientryadjustednamesep}
+\newcommand*{\glsxtrmultientryadjustednamepostsep}{\glsxtrmultientryadjustednamesep}
+\newcommand*{\glsxtrmultientryadjustednamefmt}[1]{#1}
+\newcommand*{\glsxtrmultientryadjustednameother}[1]{\glsentryname{#1}}
+\newcommand*{\Glsxtrmultientryadjustednamefmt}[1]{\makefirstuc{#1}}
+\newcommand*{\Glsxtrmultientryadjustednameother}[1]{\Glsentryname{#1}}
+\newcommand*{\GlsXtrmultientryadjustednameother}[1]{%
+ \glsentrytitlecase{#1}{name}}
+\ifdef\glscapitalisewords
+{%
+ \newcommand*{\GlsXtrmultientryadjustednamefmt}[1]{\glscapitalisewords{#1}}
+}
+{
+ \newcommand*{\GlsXtrmultientryadjustednamefmt}[1]{\capitalisewords{#1}}
+}
+\newcommand*{\GLSxtrmultientryadjustednameother}[1]{%
+ \mfirstucMakeUppercase{\glsentryname{#1}}}
+\newcommand*{\GLSxtrmultientryadjustednamefmt}[1]{\mfirstucMakeUppercase{#1}}
+\providecommand*{\Alpha}{\mathrm{A}}
+\providecommand*{\Beta}{\mathrm{B}}
+\providecommand*{\Epsilon}{\mathrm{E}}
+\providecommand*{\Zeta}{\mathrm{Z}}
+\providecommand*{\Eta}{\mathrm{H}}
+\providecommand*{\Iota}{\mathrm{I}}
+\providecommand*{\Kappa}{\mathrm{K}}
+\providecommand*{\Mu}{\mathrm{M}}
+\providecommand*{\Nu}{\mathrm{N}}
+\providecommand*{\Omicron}{\mathrm{O}}
+\providecommand*{\Rho}{\mathrm{P}}
+\providecommand*{\Tau}{\mathrm{T}}
+\providecommand*{\Chi}{\mathrm{X}}
+\providecommand*{\Digamma}{\mathrm{F}}
+\providecommand*{\omicron}{\mathit{o}}
+\@ifpackageloaded{upgreek}%
+{
+ \providecommand*{\Upalpha}{\mathrm{A}}
+ \providecommand*{\Upbeta}{\mathrm{B}}
+ \providecommand*{\Upepsilon}{\mathrm{E}}
+ \providecommand*{\Upzeta}{\mathrm{Z}}
+ \providecommand*{\Upeta}{\mathrm{H}}
+ \providecommand*{\Upiota}{\mathrm{I}}
+ \providecommand*{\Upkappa}{\mathrm{K}}
+ \providecommand*{\Upmu}{\mathrm{M}}
+ \providecommand*{\Upnu}{\mathrm{N}}
+ \providecommand*{\Upomicron}{\mathrm{O}}
+ \providecommand*{\Uprho}{\mathrm{P}}
+ \providecommand*{\Uptau}{\mathrm{T}}
+ \providecommand*{\Upchi}{\mathrm{X}}
+ \providecommand*{\upomicron}{\mathrm{o}}
+}%
+{}% upgreek.sty not loaded
+\newcommand*{\glsxtrcontrolrules}{%
+ \string'\glshex 200B\string'\string=\glshex 200C\string=\glshex 200D
+ \string=\glshex 200E\string=\glshex 200F\string=\glshex 0000\string=\glshex 0001
+ \string=\glshex 0002\string=\glshex 0003\string=\glshex 0004\string=\glshex 0005
+ \string=\glshex 0006\string=\glshex 0007\string=\glshex 0008
+ \string=\string'\glshex 0009\string'\string=\string'\glshex 000B\string'
+ \string=\glshex 000E\string=\glshex 000F\string=\string'\glshex
+0010\string'\string=\glshex 0011
+ \string=\glshex 0012\string=\glshex 0013\string=\glshex 0014\string=\glshex 0015
+ \string=\glshex 0016\string=\glshex 0017\string=\glshex 0018\string=\glshex 0019
+ \string=\glshex 001A\string=\glshex 001B\string=\glshex 001C\string=\glshex 001D
+ \string=\glshex 001E\string=\glshex 001F\string=\glshex 007F\string=\glshex 0080
+ \string=\glshex 0081\string=\glshex 0082\string=\glshex 0083\string=\glshex 0084
+ \string=\glshex 0085\string=\glshex 0086\string=\glshex 0087\string=\glshex 0088
+ \string=\glshex 0089\string=\glshex 008A\string=\glshex 008B\string=\glshex 008C
+ \string=\glshex 008D\string=\glshex 008E\string=\glshex 008F\string=\glshex 0090
+ \string=\glshex 0091\string=\glshex 0092\string=\glshex 0093\string=\glshex 0094
+ \string=\glshex 0095\string=\glshex 0096\string=\glshex 0097\string=\glshex 0098
+ \string=\glshex 0099\string=\glshex 009A\string=\glshex 009B\string=\glshex 009C
+ \string=\glshex 009D\string=\glshex 009E\string=\glshex 009F
+}
+\newcommand*{\glsxtrspacerules}{%
+ \string' \string'\string;
+ \string'\glshex 00A0\string'\string;
+ \string'\glshex 2000\string'\string;
+ \string'\glshex 2001\string'\string;
+ \string'\glshex 2002\string'\string;
+ \string'\glshex 2003\string'\string;
+ \string'\glshex 2004\string'\string;
+ \string'\glshex 2005\string'\string;
+ \string'\glshex 2006\string'\string;
+ \string'\glshex 2007\string'\string;
+ \string'\glshex 2008\string'\string;
+ \string'\glshex 2009\string'\string;
+ \string'\glshex 200A\string'\string;
+ \string'\glshex 3000\string'
+}
+\newcommand*{\glsxtrnonprintablerules}{%
+ \string'\glshex FEFF\string'\string;
+ \string'\glshex 000A\string'\string;
+ \string'\glshex 0009\string'\string;
+ \string'\glshex 000C\string'\string;
+ \string'\glshex 000B\string'
+}
+
+\newcommand*{\glsxtrcombiningdiacriticrules}{%
+ \glsxtrcombiningdiacriticIrules\string;
+ \glsxtrcombiningdiacriticIIrules\string;
+ \glsxtrcombiningdiacriticIIIrules\string;
+ \glsxtrcombiningdiacriticIVrules
+}
+\newcommand*{\glsxtrcombiningdiacriticIrules}{%
+ \glshex 0301\string;% combining acute
+ \glshex 0300\string;% combining grave
+ \glshex 0306\string;% combining breve
+ \glshex 0302\string;% combining circumflex
+ \glshex 030C\string;% combining caron
+ \glshex 030A\string;% combining ring
+ \glshex 030D\string;% combining vertical line above
+ \glshex 0308\string;% combining diaeresis
+ \glshex 030B\string;% combining double acute
+ \glshex 0303\string;% combining tilde
+ \glshex 0307\string;% combining dot above
+ \glshex 0304% combining macron
+}
+\newcommand*{\glsxtrcombiningdiacriticIIrules}{%
+ \glshex 0337\string;% combining short solidus overlay
+ \glshex 0327\string;% combining cedilla
+ \glshex 0328\string;% combining ogonek
+ \glshex 0323\string;% combining dot below
+ \glshex 0332\string;% combining low line
+ \glshex 0305\string;% combining overline
+ \glshex 0309\string;% combining hook above
+ \glshex 030E\string;% combining double vertical line above
+ \glshex 030F\string;% combining double grave accent
+ \glshex 0310\string;% combining candrabindu
+ \glshex 0311\string;% combining inverted breve
+ \glshex 0312\string;% combining turned comma above
+ \glshex 0313\string;% combining comma above
+ \glshex 0314\string;% combining reversed comma above
+ \glshex 0315\string;% combining comma above right
+ \glshex 0316\string;% combining grave accent below
+ \glshex 0317% combining acute accent below
+}
+\newcommand*{\glsxtrcombiningdiacriticIIIrules}{%
+ \glshex 0318\string;% combining left tack below
+ \glshex 0319\string;% combining right tack below
+ \glshex 031A\string;% combining left angle above
+ \glshex 031B\string;% combining horn
+ \glshex 031C\string;% combining left half ring below
+ \glshex 031D\string;% combining up tack below
+ \glshex 031E\string;% combining down tack below
+ \glshex 031F\string;% combining plus sign below
+ \glshex 0320\string;% combining minus sign below
+ \glshex 0321\string;% combining palatalized hook below
+ \glshex 0322\string;% combining retroflex hook below
+ \glshex 0324\string;% combining diaresis below
+ \glshex 0325\string;% combining ring below
+ \glshex 0326\string;% combining comma below
+ \glshex 0329\string;% combining vertical line below
+ \glshex 032A\string;% combining bridge below
+ \glshex 032B\string;% combining inverted double arch below
+ \glshex 032C\string;% combining caron below
+ \glshex 032D\string;% combining circumflex accent below
+ \glshex 032E\string;% combining breve below
+ \glshex 032F\string;% combining inverted breve below
+ \glshex 0330\string;% combining tilde below
+ \glshex 0331\string;% combining macron below
+ \glshex 0333\string;% combining double low line
+ \glshex 0334\string;% combining tilde overlay
+ \glshex 0335\string;% combining short stroke overlay
+ \glshex 0336\string;% combining long stroke overlay
+ \glshex 0338\string;% combining long solidus overlay
+ \glshex 0339\string;% combining combining right half ring below
+ \glshex 033A\string;% combining inverted bridge below
+ \glshex 033B\string;% combining square below
+ \glshex 033C\string;% combining seagull below
+ \glshex 033D\string;% combining x above
+ \glshex 033E\string;% combining vertical tilde
+ \glshex 033F\string;% combining double overline
+ \glshex 0342\string;% combining Greek perispomeni
+ \glshex 0344\string;% combining Greek dialytika tonos
+ \glshex 0345\string;% combining Greek ypogegrammeni
+ \glshex 0360\string;% combining double tilde
+ \glshex 0361\string;% combining double inverted breve
+ \glshex 0483\string;% combining Cyrillic titlo
+ \glshex 0484\string;% combining Cyrillic palatalization
+ \glshex 0485\string;% combining Cyrillic dasia pneumata
+ \glshex 0486% combining Cyrillic psili pneumata
+}
+\newcommand*{\glsxtrcombiningdiacriticIVrules}{%
+ \glshex 20D0\string;% combining left harpoon above
+ \glshex 20D1\string;% combining right harpoon above
+ \glshex 20D2\string;% combining long vertical line overlay
+ \glshex 20D3\string;% combining short vertical line overlay
+ \glshex 20D4\string;% combining anticlockwise arrow above
+ \glshex 20D5\string;% combining clockwise arrow above
+ \glshex 20D6\string;% combining left arrow above
+ \glshex 20D7\string;% combining right arrow above
+ \glshex 20D8\string;% combining ring overlay
+ \glshex 20D9\string;% combining clockwise ring overlay
+ \glshex 20DA\string;% combining anticlockwise ring overlay
+ \glshex 20DB\string;% combining three dots above
+ \glshex 20DC\string;% combining four dots above
+ \glshex 20DD\string;% combining enclosing circle
+ \glshex 20DE\string;% combining enclosing square
+ \glshex 20DF\string;% combining enclosing diamond
+ \glshex 20E0\string;% combining enclosing circle backslash
+ \glshex 20E1% combining left right arrow above
+}
+\newcommand*{\glsxtrhyphenrules}{%
+ \string'\string-\string'\string;% ASCII hyphen
+ \glshex 00AD\string;% soft hyphen
+ \glshex 2010\string;% hyphen
+ \glshex 2011\string;% non-breaking hyphen
+ \glshex 2012\string;% figure dash
+ \glshex 2013\string;% en dash
+ \glshex 2014\string;% em dash
+ \glshex 2015\string;% horizontal bar
+ \glshex 2212\string=\glshex 207B\string=\glshex 208B% minus sign
+}
+\newcommand*{\glsxtrgeneralpuncrules}{%
+ \glsxtrgeneralpuncIrules
+ \string<\glsxtrcurrencyrules
+ \string<\glsxtrgeneralpuncIIrules
+}
+\newcommand*{\glsxtrgeneralpuncIrules}{%
+ \string'\glshex 005F\string'% underscore
+ \string<\glshex 00AF% macron
+ \string<\string'\glshex 002C\string'% comma
+ \string<\string'\glshex 003B\string'% semi-colon
+ \string<\string'\glshex 003A\string'% colon
+ \string<\string'\glshex 0021\string'% exclamation mark
+ \string<\glshex 00A1% inverted exclamation mark
+ \string<\string'\glshex 003F\string'% question mark
+ \string<\glshex 00BF% inverted question mark
+ \string<\string'\glshex 002F\string'% solidus
+ \string<\string'\glshex 002E\string'% full stop
+ \string<\glshex 00B4% acute accent
+ \string<\string'\glshex 0060\string'% grave accent
+ \string<\string'\glshex 005E\string'% circumflex accent
+ \string<\glshex 00A8% diaersis
+ \string<\string'\glshex 007E\string'% tilde
+ \string<\glshex 00B7% middle dot
+ \string<\glshex 00B8% cedilla
+ \string<\string'\glshex 0027\string'% straight apostrophe
+ \string<\string'\glshex 0022\string'% straight double quote
+ \string<\glshex 00AB% left guillemet
+ \string<\glshex 00BB% right guillemet
+ \string<\string'\glshex 0028\string'% left parenthesis
+ \string=\glshex 207D\string=\glshex 208D% super/subscript left parenthesis
+ \string<\string'\glshex 0029\string'% right parenthesis
+ \string=\glshex 207E\string=\glshex 208E% super/subscript right parenthesis
+ \string<\string'\glshex 005B\string'% left square bracket
+ \string<\string'\glshex 005D\string'% right square bracket
+ \string<\string'\glshex 007B\string'% left curly bracket
+ \string<\string'\glshex 007D\string'% right curly bracket
+ \string<\glshex 00A7% section sign
+ \string<\glshex 00B6% pilcrow sign
+ \string<\glshex 00A9% copyright sign
+ \string<\glshex 00AE% registered sign
+ \string<\string'\glshex 0040\string'% at sign
+}
+\newcommand*{\glsxtrcurrencyrules}{%
+ \glshex 00A4% currency sign
+ \string<\glshex 0E3F% Thai currency symbol baht
+ \string<\glshex 00A2% cent sign
+ \string<\glshex 20A1% colon sign
+ \string<\glshex 20A2% cruzeiro sign
+ \string<\string'\glshex 0024\string'% dollar sign
+ \string<\glshex 20AB% dong sign
+ \string<\glshex 20AC% euro sign
+ \string<\glshex 20A3% French franc sign
+ \string<\glshex 20A4% lira sign
+ \string<\glshex 20A5% mill sign
+ \string<\glshex 20A6% naira sign
+ \string<\glshex 20A7% peseta sign
+ \string<\glshex 00A3% pound sign
+ \string<\glshex 20A8% rupee sign
+ \string<\glshex 20AA% new sheqel sign
+ \string<\glshex 20A9% won sign
+ \string<\glshex 00A5% yen sign
+}
+\newcommand*{\glsxtrgeneralpuncIIrules}{%
+ \string'\glshex 002A\string'% asterisk
+ \string<\string'\glshex 005C\string'% backslash
+ \string<\string'\glshex 0026\string'% ampersand
+ \string<\string'\glshex 0023\string'% hash sign
+ \string<\string'\glshex 0025\string'% percent sign
+ \string<\string'\glshex 002B\string'% plus sign
+ \string=\glshex 207A\string=\glshex 208A% super/subscript plus sign
+ \string<\glshex 00B1% plus-minus sign
+ \string<\glshex 00F7% division sign
+ \string<\glshex 00D7% multiplication sign
+ \string<\string'\glshex 003C\string'% less-than sign
+ \string<\string'\glshex 003D\string'% equals sign
+ \string<\string'\glshex 003E\string'% greater-than sign
+ \string<\glshex 00AC% not sign
+ \string<\string'\glshex 007C\string'% vertical bar (pipe)
+ \string<\glshex 00A6% broken bar
+ \string<\glshex 00B0% degree sign
+ \string<\glshex 00B5% micron sign
+}
+\newcommand*{\glsxtrGeneralLatinIrules}{%
+ \glsxtrLatinA
+ \string<b,B%
+ \string<c,C%
+ \string<d,D%
+ \string<\glsxtrLatinE
+ \string<f,F%
+ \string<g,G%
+ \string<\glsxtrLatinH
+ \string<\glsxtrLatinI
+ \string<j,J%
+ \string<\glsxtrLatinK
+ \string<\glsxtrLatinL
+ \string<\glsxtrLatinM
+ \string<\glsxtrLatinN
+ \string<\glsxtrLatinO
+ \string<\glsxtrLatinP
+ \string<q,Q%
+ \string<r,R%
+ \string<\glsxtrLatinS
+ \string<\glsxtrLatinT
+ \string<u,U%
+ \string<v,V%
+ \string<w,W%
+ \string<\glsxtrLatinX
+ \string<y,Y%
+ \string<z,Z
+}
+\newcommand*{\glsxtrGeneralLatinIIrules}{%
+ \glsxtrLatinA
+ \string<b,B%
+ \string<c,C%
+ \string<d,D%
+ \string<\glsxtrLatinEth
+ \string<\glsxtrLatinE
+ \string<f,F%
+ \string<g,G%
+ \string<\glsxtrLatinH
+ \string<\glsxtrLatinI
+ \string<j,J%
+ \string<\glsxtrLatinK
+ \string<\glsxtrLatinL
+ \string<\glsxtrLatinM
+ \string<\glsxtrLatinN
+ \string<\glsxtrLatinO
+ \string<\glsxtrLatinP
+ \string<q,Q%
+ \string<r,R%
+ \string<\glsxtrLatinS
+ \string& SS \string, \glsxtrLatinEszettSs
+ \string<\glsxtrLatinT
+ \string<u,U%
+ \string<v,V%
+ \string<w,W%
+ \string<\glsxtrLatinX
+ \string<y,Y%
+ \string<z,Z%
+}
+\newcommand*{\glsxtrGeneralLatinIIIrules}{%
+ \glsxtrLatinA
+ \string<b,B%
+ \string<c,C%
+ \string<d,D%
+ \string<\glsxtrLatinEth
+ \string<\glsxtrLatinE
+ \string<f,F%
+ \string<g,G%
+ \string<\glsxtrLatinH
+ \string<\glsxtrLatinI
+ \string<j,J%
+ \string<\glsxtrLatinK
+ \string<\glsxtrLatinL
+ \string<\glsxtrLatinM
+ \string<\glsxtrLatinN
+ \string<\glsxtrLatinO
+ \string<\glsxtrLatinP
+ \string<q,Q%
+ \string<r,R%
+ \string<\glsxtrLatinS
+ \string& SZ, \glsxtrLatinEszettSz
+ \string<\glsxtrLatinT
+ \string<u,U%
+ \string<v,V%
+ \string<w,W%
+ \string<\glsxtrLatinX
+ \string<y,Y%
+ \string<z,Z%
+}
+\newcommand*{\glsxtrGeneralLatinIVrules}{%
+ \glsxtrLatinA
+ \string& AE , \glsxtrLatinAELigature
+ \string<b,B%
+ \string<c,C%
+ \string<d,D%
+ \string<\glsxtrLatinEth
+ \string<\glsxtrLatinE
+ \string<f,F%
+ \string<g,G%
+ \string<\glsxtrLatinH
+ \string<\glsxtrLatinI
+ \string<j,J%
+ \string<\glsxtrLatinK
+ \string<\glsxtrLatinL
+ \string<\glsxtrLatinM
+ \string<\glsxtrLatinN
+ \string<\glsxtrLatinO
+ \string& OE , \glsxtrLatinOELigature
+ \string<\glsxtrLatinP
+ \string<q,Q%
+ \string<r,R%
+ \string<\glsxtrLatinS
+ \string& SS , \glsxtrLatinEszettSs
+ \string<\glsxtrLatinT
+ \string& th =\glshex 00DE
+ \string& TH =\glshex 00FE
+ \string<u,U%
+ \string<v,V%
+ \string<w,W%
+ \string<\glsxtrLatinX
+ \string<y,Y%
+ \string<z,Z%
+}
+\newcommand*{\glsxtrGeneralLatinVrules}{%
+ \glsxtrLatinA
+ \string<b,B%
+ \string<c,C%
+ \string<d,D%
+ \string<\glsxtrLatinEth
+ \string<\glsxtrLatinE
+ \string<f,F%
+ \string<g,G%
+ \string<\glsxtrLatinH
+ \string<\glsxtrLatinI
+ \string<j,J%
+ \string<\glsxtrLatinK
+ \string<\glsxtrLatinL
+ \string<\glsxtrLatinM
+ \string<\glsxtrLatinN
+ \string<\glsxtrLatinO
+ \string<\glsxtrLatinP
+ \string<q,Q%
+ \string<r,R%
+ \string<\glsxtrLatinS
+ \string& SS , \glsxtrLatinEszettSs
+ \string<\glsxtrLatinT
+ \string& th =\glshex 00DE
+ \string& TH =\glshex 00FE
+ \string<u,U%
+ \string<v,V%
+ \string<w,W%
+ \string<\glsxtrLatinX
+ \string<y,Y%
+ \string<z,Z%
+}
+\newcommand*{\glsxtrGeneralLatinVIrules}{%
+ \glsxtrLatinA
+ \string<b,B%
+ \string<c,C%
+ \string<d,D%
+ \string<\glsxtrLatinEth
+ \string<\glsxtrLatinE
+ \string<f,F%
+ \string<g,G%
+ \string<\glsxtrLatinH
+ \string<\glsxtrLatinI
+ \string<j,J%
+ \string<\glsxtrLatinK
+ \string<\glsxtrLatinL
+ \string<\glsxtrLatinM
+ \string<\glsxtrLatinN
+ \string<\glsxtrLatinO
+ \string<\glsxtrLatinP
+ \string<q,Q%
+ \string<r,R%
+ \string<\glsxtrLatinS
+ \string& SZ , \glsxtrLatinEszettSz
+ \string<\glsxtrLatinT
+ \string& th =\glshex 00DE
+ \string& TH =\glshex 00FE
+ \string<u,U%
+ \string<v,V%
+ \string<w,W%
+ \string<\glsxtrLatinX
+ \string<y,Y%
+ \string<z,Z%
+}
+\newcommand*{\glsxtrGeneralLatinVIIrules}{%
+ \glsxtrLatinA
+ \string<\glsxtrLatinAELigature
+ \string<b,B%
+ \string<c,C%
+ \string<d,D%
+ \string<\glsxtrLatinEth
+ \string<\glsxtrLatinE
+ \string<f,F%
+ \string<\glsxtrLatinInsularG
+ \string<\glsxtrLatinH
+ \string<\glsxtrLatinI
+ \string<j,J%
+ \string<\glsxtrLatinK
+ \string<\glsxtrLatinL
+ \string<\glsxtrLatinM
+ \string<\glsxtrLatinN
+ \string<\glsxtrLatinO
+ \string<\glsxtrLatinOELigature
+ \string<\glsxtrLatinP
+ \string<q,Q%
+ \string<r,R%
+ \string<\glshex 017F=\glsxtrLatinS % s and long s
+ \string<\glsxtrLatinT
+ \string<\glsxtrLatinThorn
+ \string<u,U%
+ \string<v,V%
+ \string< w\string=\glshex 01BF, W\string=\glshex 01F7
+ \string<\glsxtrLatinX
+ \string<y,Y%
+ \string<z,Z%
+}
+\newcommand*{\glsxtrGeneralLatinVIIIrules}{%
+ \glsxtrLatinA
+ \string& AE , \glsxtrLatinAELigature
+ \string<b,B%
+ \string<c,C%
+ \string<\glshex 00F0\string;d,\glshex 00D0\string;D% D and eth
+ \string<\glsxtrLatinE
+ \string<f,F%
+ \string<g,G%
+ \string<\glsxtrLatinH
+ \string<\glsxtrLatinI
+ \string<j,J%
+ \string<\glsxtrLatinK
+ \string<\glshex 0142\string=\glsxtrLatinL\string=\glshex 0141% L and \L
+ \string<\glsxtrLatinM
+ \string<\glsxtrLatinN
+ \string<\glshex 00F8\string=\glsxtrLatinO\string=\glshex 00D8% O and \O
+ \string& OE , \glsxtrLatinOELigature
+ \string<\glsxtrLatinP
+ \string<q,Q%
+ \string<r,R%
+ \string<\glsxtrLatinS
+ \string& SS , \glsxtrLatinEszettSs
+ \string<\glsxtrLatinT
+ \string& th =\glshex 00DE
+ \string& TH =\glshex 00FE
+ \string<u,U%
+ \string<v,V%
+ \string<w,W%
+ \string<\glsxtrLatinX
+ \string<y,Y%
+ \string<z,Z%
+}
+\newcommand*{\glsxtrLatinA}{%
+ a\string=\glshex 00AA\string=\glshex 2090,A
+}
+\newcommand*{\glsxtrLatinE}{%
+ e\string=\glshex 2091,E
+}
+\newcommand*{\glsxtrLatinH}{%
+ h\string=\glshex 2095,H
+}
+\newcommand*{\glsxtrLatinI}{%
+ i\string=\glshex 2071,I
+}
+\newcommand*{\glsxtrLatinK}{%
+ k\string=\glshex 2096,K
+}
+\newcommand*{\glsxtrLatinL}{%
+ l\string=\glshex 2097,L
+}
+\newcommand*{\glsxtrLatinM}{%
+ m\string=\glshex 2098,M
+}
+\newcommand*{\glsxtrLatinN}{%
+ n\string=\glshex 207F\string=\glshex 2099,N
+}
+\newcommand*{\glsxtrLatinO}{%
+ o\string=\glshex 00BA\string=\glshex 2092,O
+}
+\newcommand*{\glsxtrLatinP}{%
+ p\string=\glshex 209A,P
+}
+\newcommand*{\glsxtrLatinS}{%
+ s\string=\glshex 209B,S
+}
+\newcommand*{\glsxtrLatinT}{%
+ t\string=\glshex 209C,T
+}
+\newcommand*{\glsxtrLatinX}{%
+ x\string=\glshex 2093,X
+}
+\newcommand*{\glsxtrLatinSchwa}{%
+ \glshex 0259\string=\glshex 2094,\glshex 018F
+}
+\newcommand*{\glsxtrLatinEszettSs}{%
+ \glshex 00DF% eszett
+ \string=\glshex 017Fs % long S s
+}
+\newcommand*{\glsxtrLatinEszettSz}{%
+ \glshex 00DF% eszett
+ \string= \glshex 017Fz % long S z
+}
+\newcommand*{\glsxtrLatinEth}{%
+ \glshex 00F0,\glshex 00D0% eth
+}
+\newcommand*{\glsxtrLatinThorn}{%
+ \glshex 00FE,\glshex 00DE% thorn
+}
+\newcommand*{\glsxtrLatinAELigature}{%
+ \glshex 00E6,\glshex 00C6% AE-ligature
+}
+\newcommand*{\glsxtrLatinOELigature}{%
+ \glshex 0153,\glshex 0152% OE-ligature
+}
+\newcommand*{\glsxtrLatinAA}{%
+ \glshex 00E5=a\glshex 030A,% \aa
+ \glshex 00C5=A\glshex 030A% \AA
+}
+\newcommand*{\glsxtrLatinWynn}{%
+ \glshex 01BF,\glshex 01F7% wynn
+}
+\newcommand*{\glsxtrLatinInsularG}{%
+ \glshex 1D79,\glshex A77D% insular G
+ \string; g, G
+}
+\newcommand*{\glsxtrLatinOslash}{%
+ \glshex 00F8,\glshex 00D8% \o, \O
+}
+\newcommand*{\glsxtrLatinLslash}{%
+ \glshex 0142,\glshex 0141% \l, \L
+}
+\newcommand*{\glsxtrMathUpGreekIrules}{%
+ \glsxtrUpAlpha
+ \string<\glsxtrUpBeta
+ \string<\glsxtrUpGamma
+ \string<\glsxtrUpDelta
+ \string<\glsxtrUpEpsilon
+ \string<\glsxtrUpDigamma
+ \string<\glsxtrUpZeta
+ \string<\glsxtrUpEta
+ \string<\glsxtrUpTheta
+ \string<\glsxtrUpIota
+ \string<\glsxtrUpKappa
+ \string<\glsxtrUpLambda
+ \string<\glsxtrUpMu
+ \string<\glsxtrUpNu
+ \string<\glsxtrUpXi
+ \string<\glsxtrUpOmicron
+ \string<\glsxtrUpPi
+ \string<\glsxtrUpRho
+ \string<\glsxtrUpSigma
+ \string<\glsxtrUpTau
+ \string<\glsxtrUpUpsilon
+ \string<\glsxtrUpPhi
+ \string<\glsxtrUpChi
+ \string<\glsxtrUpPsi
+ \string<\glsxtrUpOmega
+}
+\newcommand*{\glsxtrMathUpGreekIIrules}{%
+ \glsxtrUpAlpha
+ \string<\glsxtrUpBeta
+ \string<\glsxtrUpGamma
+ \string<\glsxtrUpDelta
+ \string<\glsxtrUpEpsilon
+ \string<\glsxtrUpZeta
+ \string<\glsxtrUpEta
+ \string<\glsxtrUpTheta
+ \string<\glsxtrUpIota
+ \string<\glsxtrUpKappa
+ \string<\glsxtrUpLambda
+ \string<\glsxtrUpMu
+ \string<\glsxtrUpNu
+ \string<\glsxtrUpXi
+ \string<\glsxtrUpOmicron
+ \string<\glsxtrUpPi
+ \string<\glsxtrUpRho
+ \string<\glsxtrUpSigma
+ \string<\glsxtrUpTau
+ \string<\glsxtrUpUpsilon
+ \string<\glsxtrUpPhi
+ \string<\glsxtrUpChi
+ \string<\glsxtrUpPsi
+ \string<\glsxtrUpOmega
+}
+\newcommand*{\glsxtrMathItalicGreekIrules}{%
+ \glsxtrMathItalicAlpha
+ \string<\glsxtrMathItalicBeta
+ \string<\glsxtrMathItalicGamma
+ \string<\glsxtrMathItalicDelta
+ \string<\glsxtrMathItalicEpsilon
+ \string<\glsxtrUpDigamma
+ \string<\glsxtrMathItalicZeta
+ \string<\glsxtrMathItalicEta
+ \string<\glsxtrMathItalicTheta
+ \string<\glsxtrMathItalicIota
+ \string<\glsxtrMathItalicKappa
+ \string<\glsxtrMathItalicLambda
+ \string<\glsxtrMathItalicMu
+ \string<\glsxtrMathItalicNu
+ \string<\glsxtrMathItalicXi
+ \string<\glsxtrMathItalicOmicron
+ \string<\glsxtrMathItalicPi
+ \string<\glsxtrMathItalicRho
+ \string<\glsxtrMathItalicSigma
+ \string<\glsxtrMathItalicTau
+ \string<\glsxtrMathItalicUpsilon
+ \string<\glsxtrMathItalicPhi
+ \string<\glsxtrMathItalicChi
+ \string<\glsxtrMathItalicPsi
+ \string<\glsxtrMathItalicOmega
+}
+\newcommand*{\glsxtrMathItalicGreekIIrules}{%
+ \glsxtrMathItalicAlpha
+ \string<\glsxtrMathItalicBeta
+ \string<\glsxtrMathItalicGamma
+ \string<\glsxtrMathItalicDelta
+ \string<\glsxtrMathItalicEpsilon
+ \string<\glsxtrMathItalicZeta
+ \string<\glsxtrMathItalicEta
+ \string<\glsxtrMathItalicTheta
+ \string<\glsxtrMathItalicIota
+ \string<\glsxtrMathItalicKappa
+ \string<\glsxtrMathItalicLambda
+ \string<\glsxtrMathItalicMu
+ \string<\glsxtrMathItalicNu
+ \string<\glsxtrMathItalicXi
+ \string<\glsxtrMathItalicOmicron
+ \string<\glsxtrMathItalicPi
+ \string<\glsxtrMathItalicRho
+ \string<\glsxtrMathItalicSigma
+ \string<\glsxtrMathItalicTau
+ \string<\glsxtrMathItalicUpsilon
+ \string<\glsxtrMathItalicPhi
+ \string<\glsxtrMathItalicChi
+ \string<\glsxtrMathItalicPsi
+ \string<\glsxtrMathItalicOmega
+}
+\newcommand*{\glsxtrMathItalicUpperGreekIrules}{%
+ \glshex 1D6E2% upper case alpha (maths italic)
+ \string<\glshex 1D6E3% upper case beta (maths italic)
+ \string<\glshex 1D6E4% upper case gamma (maths italic)
+ \string<\glshex 1D6E5% upper case delta (maths italic)
+ \string<\glshex 1D6E6% upper case epsilon (maths italic)
+ \string<\glshex 03DC% upper case digamma
+ \string<\glshex 1D6E7% upper case zeta (maths italic)
+ \string<\glshex 1D6E8% upper case eta (maths italic)
+ \string<\glshex 1D6E9% upper case theta (maths italic)
+ \string=\glshex 1D6F3% upper case theta variant (maths italic)
+ \string<\glshex 1D6EA% upper case iota (maths italic)
+ \string<\glshex 1D6EB% upper case kappa (maths italic)
+ \string<\glshex 1D6EC% upper case lambda (maths italic)
+ \string<\glshex 1D6ED% upper case mu (maths italic)
+ \string<\glshex 1D6EE% upper case nu (maths italic)
+ \string<\glshex 1D6EF% upper case xi (maths italic)
+ \string<\glshex 1D6F0% upper case omicron (maths italic)
+ \string<\glshex 1D6F1% upper case pi (maths italic)
+ \string<\glshex 1D6F2% upper case rho (maths italic)
+ \string<\glshex 1D6F4% upper case sigma (maths italic)
+ \string<\glshex 1D6F5% upper case tau (maths italic)
+ \string<\glshex 1D6F6% upper case upsilon (maths italic)
+ \string<\glshex 1D6F7% upper case phi (maths italic)
+ \string<\glshex 1D6F8% upper case chi (maths italic)
+ \string<\glshex 1D6F9% upper case psi (maths italic)
+ \string<\glshex 1D6FA% upper case omega (maths italic)
+}
+\newcommand*{\glsxtrMathItalicUpperGreekIIrules}{%
+ \glshex 1D6E2% upper case alpha (maths italic)
+ \string<\glshex 1D6E3% upper case beta (maths italic)
+ \string<\glshex 1D6E4% upper case gamma (maths italic)
+ \string<\glshex 1D6E5% upper case delta (maths italic)
+ \string<\glshex 1D6E6% upper case epsilon (maths italic)
+ \string<\glshex 1D6E7% upper case zeta (maths italic)
+ \string<\glshex 1D6E8% upper case eta (maths italic)
+ \string<\glshex 1D6E9% upper case theta (maths italic)
+ \string=\glshex 1D6F3% upper case theta variant (maths italic)
+ \string<\glshex 1D6EA% upper case iota (maths italic)
+ \string<\glshex 1D6EB% upper case kappa (maths italic)
+ \string<\glshex 1D6EC% upper case lambda (maths italic)
+ \string<\glshex 1D6ED% upper case mu (maths italic)
+ \string<\glshex 1D6EE% upper case nu (maths italic)
+ \string<\glshex 1D6EF% upper case xi (maths italic)
+ \string<\glshex 1D6F0% upper case omicron (maths italic)
+ \string<\glshex 1D6F1% upper case pi (maths italic)
+ \string<\glshex 1D6F2% upper case rho (maths italic)
+ \string<\glshex 1D6F4% upper case sigma (maths italic)
+ \string<\glshex 1D6F5% upper case tau (maths italic)
+ \string<\glshex 1D6F6% upper case upsilon (maths italic)
+ \string<\glshex 1D6F7% upper case phi (maths italic)
+ \string<\glshex 1D6F8% upper case chi (maths italic)
+ \string<\glshex 1D6F9% upper case psi (maths italic)
+ \string<\glshex 1D6FA% upper case omega (maths italic)
+}
+\newcommand*{\glsxtrMathItalicLowerGreekIrules}{%
+ \glshex 1D6FC% lower case alpha (maths italic)
+ \string<\glshex 1D6FD% lower case beta (maths italic)
+ \string<\glshex 1D6FE% lower case gamma (maths italic)
+ \string<\glshex 1D6FF% lower case delta (maths italic)
+ \string<\glshex 1D700% lower case epsilon (maths italic)
+ \string=\glshex 1D716% lower case epsilon variant (maths italic)
+ \string<\glshex 03DD% lower case digamma
+ \string<\glshex 1D701% lower case zeta (maths italic)
+ \string<\glshex 1D702% lower case eta (maths italic)
+ \string<\glshex 1D703% lower case theta (maths italic)
+ \string=\glshex 1D717% lower case theta variant (maths italic)
+ \string<\glshex 1D704% lower case iota (maths italic)
+ \string<\glshex 1D705% lower case kappa (maths italic)
+ \string=\glshex 1D718% lower case kappa variant (maths italic)
+ \string<\glshex 1D706% lower case lambda (maths italic)
+ \string<\glshex 1D707% lower case mu (maths italic)
+ \string<\glshex 1D708% lower case nu (maths italic)
+ \string<\glshex 1D709% lower case xi (maths italic)
+ \string<\glshex 1D70A% lower case omicron (maths italic)
+ \string<\glshex 1D70B% lower case pi (maths italic)
+ \string=\glshex 1D71B% lower case pi variant (maths italic)
+ \string<\glshex 1D70C% lower case rho (maths italic)
+ \string=\glshex 1D71A% lower case rho variant (maths italic)
+ \string<\glshex 1D70D% lower case final sigma (maths italic)
+ \string=\glshex 1D70E% lower case sigma (maths italic)
+ \string<\glshex 1D70F% lower case tau (maths italic)
+ \string<\glshex 1D710% lower case upsilon (maths italic)
+ \string<\glshex 1D711% lower case phi (maths italic)
+ \string=\glshex 1D719% lower case phi variant (maths italic)
+ \string<\glshex 1D712% lower case chi (maths italic)
+ \string<\glshex 1D713% lower case psi (maths italic)
+ \string<\glshex 1D714% lower case omega (maths italic)
+}
+\newcommand*{\glsxtrMathItalicLowerGreekIIrules}{%
+ \glshex 1D6FC% lower case alpha (maths italic)
+ \string<\glshex 1D6FD% lower case beta (maths italic)
+ \string<\glshex 1D6FE% lower case gamma (maths italic)
+ \string<\glshex 1D6FF% lower case delta (maths italic)
+ \string<\glshex 1D700% lower case epsilon (maths italic)
+ \string=\glshex 1D716% lower case epsilon variant (maths italic)
+ \string<\glshex 1D701% lower case zeta (maths italic)
+ \string<\glshex 1D702% lower case eta (maths italic)
+ \string<\glshex 1D703% lower case theta (maths italic)
+ \string=\glshex 1D717% lower case theta variant (maths italic)
+ \string<\glshex 1D704% lower case iota (maths italic)
+ \string<\glshex 1D705% lower case kappa (maths italic)
+ \string=\glshex 1D718% lower case kappa variant (maths italic)
+ \string<\glshex 1D706% lower case lambda (maths italic)
+ \string<\glshex 1D707% lower case mu (maths italic)
+ \string<\glshex 1D708% lower case nu (maths italic)
+ \string<\glshex 1D709% lower case xi (maths italic)
+ \string<\glshex 1D70A% lower case omicron (maths italic)
+ \string<\glshex 1D70B% lower case pi (maths italic)
+ \string=\glshex 1D71B% lower case pi variant (maths italic)
+ \string<\glshex 1D70C% lower case rho (maths italic)
+ \string=\glshex 1D71A% lower case rho variant (maths italic)
+ \string<\glshex 1D70D% lower case final sigma (maths italic)
+ \string=\glshex 1D70E% lower case sigma (maths italic)
+ \string<\glshex 1D70F% lower case tau (maths italic)
+ \string<\glshex 1D710% lower case upsilon (maths italic)
+ \string<\glshex 1D711% lower case phi (maths italic)
+ \string=\glshex 1D719% lower case phi variant (maths italic)
+ \string<\glshex 1D712% lower case chi (maths italic)
+ \string<\glshex 1D713% lower case psi (maths italic)
+ \string<\glshex 1D714% lower case omega (maths italic)
+}
+\newcommand*{\glsxtrMathGreekIrules}{%
+ \glsxtrMathItalicAlpha
+ \string;\glsxtrUpAlpha
+ \string<\glsxtrMathItalicBeta
+ \string;\glsxtrUpBeta
+ \string<\glsxtrMathItalicGamma
+ \string;\glsxtrUpGamma
+ \string<\glsxtrMathItalicDelta
+ \string;\glsxtrUpDelta
+ \string<\glsxtrMathItalicEpsilon
+ \string;\glsxtrUpEpsilon
+ \string<\glsxtrUpDigamma
+ \string<\glsxtrMathItalicZeta
+ \string;\glsxtrUpZeta
+ \string<\glsxtrMathItalicEta
+ \string;\glsxtrUpEta
+ \string<\glsxtrMathItalicTheta
+ \string;\glsxtrUpTheta
+ \string<\glsxtrMathItalicIota
+ \string;\glsxtrUpIota
+ \string<\glsxtrMathItalicKappa
+ \string;\glsxtrUpKappa
+ \string<\glsxtrMathItalicLambda
+ \string;\glsxtrUpLambda
+ \string<\glsxtrMathItalicMu
+ \string;\glsxtrUpMu
+ \string<\glsxtrMathItalicNu
+ \string;\glsxtrUpNu
+ \string<\glsxtrMathItalicXi
+ \string;\glsxtrUpXi
+ \string<\glsxtrMathItalicOmicron
+ \string;\glsxtrUpOmicron
+ \string<\glsxtrMathItalicPi
+ \string;\glsxtrUpPi
+ \string<\glsxtrMathItalicRho
+ \string;\glsxtrUpRho
+ \string<\glsxtrMathItalicSigma
+ \string;\glsxtrUpSigma
+ \string<\glsxtrMathItalicTau
+ \string;\glsxtrUpTau
+ \string<\glsxtrMathItalicUpsilon
+ \string;\glsxtrUpUpsilon
+ \string<\glsxtrMathItalicPhi
+ \string;\glsxtrUpPhi
+ \string<\glsxtrMathItalicChi
+ \string;\glsxtrUpChi
+ \string<\glsxtrMathItalicPsi
+ \string;\glsxtrUpPsi
+ \string<\glsxtrMathItalicOmega
+ \string;\glsxtrUpOmega
+}
+\newcommand*{\glsxtrMathGreekIIrules}{%
+ \glsxtrMathItalicAlpha
+ \string;\glsxtrUpAlpha
+ \string<\glsxtrMathItalicBeta
+ \string;\glsxtrUpBeta
+ \string<\glsxtrMathItalicGamma
+ \string;\glsxtrUpGamma
+ \string<\glsxtrMathItalicDelta
+ \string;\glsxtrUpDelta
+ \string<\glsxtrMathItalicEpsilon
+ \string;\glsxtrUpEpsilon
+ \string<\glsxtrMathItalicZeta
+ \string;\glsxtrUpZeta
+ \string<\glsxtrMathItalicEta
+ \string;\glsxtrUpEta
+ \string<\glsxtrMathItalicTheta
+ \string;\glsxtrUpTheta
+ \string<\glsxtrMathItalicIota
+ \string;\glsxtrUpIota
+ \string<\glsxtrMathItalicKappa
+ \string;\glsxtrUpKappa
+ \string<\glsxtrMathItalicLambda
+ \string;\glsxtrUpLambda
+ \string<\glsxtrMathItalicMu
+ \string;\glsxtrUpMu
+ \string<\glsxtrMathItalicNu
+ \string;\glsxtrUpNu
+ \string<\glsxtrMathItalicXi
+ \string;\glsxtrUpXi
+ \string<\glsxtrMathItalicOmicron
+ \string;\glsxtrUpOmicron
+ \string<\glsxtrMathItalicPi
+ \string;\glsxtrUpPi
+ \string<\glsxtrMathItalicRho
+ \string;\glsxtrUpRho
+ \string<\glsxtrMathItalicSigma
+ \string;\glsxtrUpSigma
+ \string<\glsxtrMathItalicTau
+ \string;\glsxtrUpTau
+ \string<\glsxtrMathItalicUpsilon
+ \string;\glsxtrUpUpsilon
+ \string<\glsxtrMathItalicPhi
+ \string;\glsxtrUpPhi
+ \string<\glsxtrMathItalicChi
+ \string;\glsxtrUpChi
+ \string<\glsxtrMathItalicPsi
+ \string;\glsxtrUpPsi
+ \string<\glsxtrMathItalicOmega
+ \string;\glsxtrUpOmega
+}
+\newcommand*{\glsxtrUpAlpha}{%
+ \glshex 03B1,% lower case alpha
+ \glshex 0391% upper case alpha
+}
+\newcommand*{\glsxtrUpBeta}{%
+ \glshex 03B2,% lower case beta
+ \glshex 0392% upper case beta
+}
+\newcommand*{\glsxtrUpGamma}{%
+ \glshex 03B3,% lower case gamma
+ \glshex 0393% upper case gamma
+}
+\newcommand*{\glsxtrUpDelta}{%
+ \glshex 03B4,% lower case delta
+ \glshex 0394% upper case delta
+}
+\newcommand*{\glsxtrUpEpsilon}{%
+ \glshex 03B5% lower case epsilon
+ \string=\glshex 03F5,% lower case epsilon variant
+ \glshex 0395% upper case epsilon
+}
+\newcommand*{\glsxtrUpDigamma}{%
+ \glshex 03DD,% lower case digamma
+ \glshex 03DC% upper case digamma
+}
+\newcommand*{\glsxtrUpZeta}{%
+ \glshex 03B6,% lower case zeta
+ \glshex 0396% upper case zeta
+}
+\newcommand*{\glsxtrUpEta}{%
+ \glshex 03B7,% lower case eta
+ \glshex 0397% upper case eta
+}
+\newcommand*{\glsxtrUpTheta}{%
+ \glshex 03B8% lower case theta
+ \string=\glshex 03D1,% lower case theta variant
+ \glshex 0398% upper case theta
+}
+\newcommand*{\glsxtrUpIota}{%
+ \glshex 03B9,% lower case iota
+ \glshex 0399% upper case iota
+}
+\newcommand*{\glsxtrUpKappa}{%
+ \glshex 03BA% lower case kappa
+ \string=\glshex 03F0,% lower case kappa variant
+ \glshex 039A% upper case kappa
+}
+\newcommand*{\glsxtrUpLambda}{%
+ \glshex 03BB,% lower lambda
+ \glshex 039B% upper case lambda
+}
+\newcommand*{\glsxtrUpMu}{%
+ \glshex 03BC,% lower case mu
+ \glshex 039C% upper case mu
+}
+\newcommand*{\glsxtrUpNu}{%
+ \glshex 03BD,% lower case nu
+ \glshex 039D% upper case nu
+}
+\newcommand*{\glsxtrUpXi}{%
+ \glshex 03BE,% lower case xi
+ \glshex 039E% upper case xi
+}
+\newcommand*{\glsxtrUpOmicron}{%
+ \glshex 03BF,% lower case omicron
+ \glshex 039F% upper case omicron
+}
+\newcommand*{\glsxtrUpPi}{%
+ \glshex 03C0% lower case pi
+ \string=\glshex 03D6,% lower case pi variant
+ \glshex 03A0% upper case pi
+}
+\newcommand*{\glsxtrUpRho}{%
+ \glshex 03C1% lower case rho
+ \string=\glshex 03F1,% lower case rho variant
+ \glshex 03A1% upper case rho
+}
+\newcommand*{\glsxtrUpSigma}{%
+ \glshex 03C2% lower case sigma
+ \string=\glshex 03C3,% lower case sigma
+ \glshex 03A3% upper case sigma
+}
+\newcommand*{\glsxtrUpTau}{%
+ \glshex 03C4,% lower case tau
+ \glshex 03A4% upper case tau
+}
+\newcommand*{\glsxtrUpUpsilon}{%
+ \glshex 03C5,% lower case upsilon
+ \glshex 03A5% upper case upsilon
+}
+\newcommand*{\glsxtrUpPhi}{%
+ \glshex 03C6% lower case phi
+ \string=\glshex 03D5,% lower case phi variant
+ \glshex 03A6% upper case phi
+}
+\newcommand*{\glsxtrUpChi}{%
+ \glshex 03C7,% lower case chi
+ \glshex 03A7% upper case chi
+}
+\newcommand*{\glsxtrUpPsi}{%
+ \glshex 03C8,% lower case psi
+ \glshex 03A8% upper case psi
+}
+\newcommand*{\glsxtrUpOmega}{%
+ \glshex 03C9,% lower case omega
+ \glshex 03A9% upper case omega
+}
+\newcommand*{\glsxtrMathItalicAlpha}{%
+ \glshex 1D6FC,% lower case alpha (maths italic)
+ \glshex 1D6E2% upper case alpha (maths italic)
+}
+\newcommand*{\glsxtrMathItalicBeta}{%
+ \glshex 1D6FD,% lower case beta (maths italic)
+ \glshex 1D6E3% upper case beta (maths italic)
+}
+\newcommand*{\glsxtrMathItalicGamma}{%
+ \glshex 1D6FE,% lower case gamma (maths italic)
+ \glshex 1D6E4% upper case gamma (maths italic)
+}
+\newcommand*{\glsxtrMathItalicDelta}{%
+ \glshex 1D6FF,% lower case delta (maths italic)
+ \glshex 1D6E5% upper case delta (maths italic)
+}
+\newcommand*{\glsxtrMathItalicEpsilon}{%
+ \glshex 1D700% lower case epsilon (maths italic)
+ \string=\glshex 1D716,% lower case epsilon variant (maths italic)
+ \glshex 1D6E6% upper case epsilon (maths italic)
+}
+\newcommand*{\glsxtrMathItalicZeta}{%
+ \glshex 1D701,% lower case zeta (maths italic)
+ \glshex 1D6E7% upper case zeta (maths italic)
+}
+\newcommand*{\glsxtrMathItalicEta}{%
+ \glshex 1D702,% lower case eta (maths italic)
+ \glshex 1D6E8% upper case eta (maths italic)
+}
+\newcommand*{\glsxtrMathItalicTheta}{%
+ \glshex 1D703% lower case theta (maths italic)
+ \string=\glshex 1D717,% lower case theta variant (maths italic)
+ \glshex 1D6E9% upper case theta (maths italic)
+ \string=\glshex 1D6F3% upper case theta variant (maths italic)
+}
+\newcommand*{\glsxtrMathItalicIota}{%
+ \glshex 1D704,% lower case iota (maths italic)
+ \glshex 1D6EA% upper case iota (maths italic)
+}
+\newcommand*{\glsxtrMathItalicKappa}{%
+ \glshex 1D705% lower case kappa (maths italic)
+ \string=\glshex 1D718,% lower case kappa variant (maths italic)
+ \glshex 1D6EB% upper case kappa (maths italic)
+}
+\newcommand*{\glsxtrMathItalicLambda}{%
+ \glshex 1D706,% lower case lambda (maths italic)
+ \glshex 1D6EC% upper case lambda (maths italic)
+}
+\newcommand*{\glsxtrMathItalicMu}{%
+ \glshex 1D707,% lower case mu (maths italic)
+ \glshex 1D6ED% upper case mu (maths italic)
+}
+\newcommand*{\glsxtrMathItalicNu}{%
+ \glshex 1D708,% lower case nu (maths italic)
+ \glshex 1D6EE% upper case nu (maths italic)
+}
+\newcommand*{\glsxtrMathItalicXi}{%
+ \glshex 1D709,% lower case xi (maths italic)
+ \glshex 1D6EF% upper case xi (maths italic)
+}
+\newcommand*{\glsxtrMathItalicOmicron}{%
+ \glshex 1D70A,% lower case omicron (maths italic)
+ \glshex 1D6F0% upper case omicron (maths italic)
+}
+\newcommand*{\glsxtrMathItalicPi}{%
+ \glshex 1D70B% lower case pi (maths italic)
+ \string=\glshex 1D71B,% lower case pi variant (maths italic)
+ \glshex 1D6F1% upper case pi (maths italic)
+}
+\newcommand*{\glsxtrMathItalicRho}{%
+ \glshex 1D70C% lower case rho (maths italic)
+ \string=\glshex 1D71A,% lower case rho variant (maths italic)
+ \glshex 1D6F2% upper case rho (maths italic)
+}
+\newcommand*{\glsxtrMathItalicSigma}{%
+ \glshex 1D70D% lower case final sigma (maths italic)
+ \string=\glshex 1D70E,% lower case sigma (maths italic)
+ \glshex 1D6F4% upper case sigma (maths italic)
+}
+\newcommand*{\glsxtrMathItalicTau}{%
+ \glshex 1D70F,% lower case tau (maths italic)
+ \glshex 1D6F5% upper case tau (maths italic)
+}
+\newcommand*{\glsxtrMathItalicUpsilon}{%
+ \glshex 1D710,% lower case upsilon (maths italic)
+ \glshex 1D6F6% upper case upsilon (maths italic)
+}
+\newcommand*{\glsxtrMathItalicPhi}{%
+ \glshex 1D711% lower case phi (maths italic)
+ \string=\glshex 1D719,% lower case phi variant (maths italic)
+ \glshex 1D6F7% upper case phi (maths italic)
+}
+\newcommand*{\glsxtrMathItalicChi}{%
+ \glshex 1D712,% lower case chi (maths italic)
+ \glshex 1D6F8% upper case chi (maths italic)
+}
+\newcommand*{\glsxtrMathItalicPsi}{%
+ \glshex 1D713,% lower case psi (maths italic)
+ \glshex 1D6F9% upper case psi (maths italic)
+}
+\newcommand*{\glsxtrMathItalicOmega}{%
+ \glshex 1D714,% lower case omega (maths italic)
+ \glshex 1D6FA% upper case omega (maths italic)
+}
+\newcommand*{\glsxtrMathItalicPartial}{%
+ \glshex 1D715% partial differential (maths italic)
+}
+\newcommand*{\glsxtrMathItalicNabla}{%
+ \glshex 1D6FB% nabla (maths italic)
+}
+\newcommand*{\glsxtrdigitrules}{%
+ 0\string=\glshex 2080\string=\glshex 2070
+ \string<1\string=\glshex 2081\string=\glshex 00B9
+ \string<2\string=\glshex 2082\string=\glshex 00B2
+ \string<3\string=\glshex 2083\string=\glshex 00B3
+ \string<4\string=\glshex 2084\string=\glshex 2074
+ \string<5\string=\glshex 2085\string=\glshex 2075
+ \string<6\string=\glshex 2086\string=\glshex 2076
+ \string<7\string=\glshex 2087\string=\glshex 2077
+ \string<8\string=\glshex 2088\string=\glshex 2078
+ \string<9\string=\glshex 2089\string=\glshex 2079
+}
+\newcommand*{\glsxtrBasicDigitrules}{%
+ 0\string<1\string<2\string<3\string<4%
+ \string<5\string<6\string<7\string<8\string<9%
+}
+\newcommand*{\glsxtrSubScriptDigitrules}{%
+ \glshex 2080% subscript 0
+ \string<\glshex 2081% subscript 1
+ \string<\glshex 2082% subscript 2
+ \string<\glshex 2083% subscript 3
+ \string<\glshex 2084% subscript 4
+ \string<\glshex 2085% subscript 5
+ \string<\glshex 2086% subscript 6
+ \string<\glshex 2087% subscript 7
+ \string<\glshex 2088% subscript 8
+ \string<\glshex 2089% subscript 9
+}
+\newcommand*{\glsxtrSuperScriptDigitrules}{%
+ \glshex 2070% superscript 0
+ \string<\glshex 00B9% superscript 1
+ \string<\glshex 00B2% superscript 2
+ \string<\glshex 00B3% superscript 3
+ \string<\glshex 2074% superscript 4
+ \string<\glshex 2075% superscript 5
+ \string<\glshex 2076% superscript 6
+ \string<\glshex 2077% superscript 7
+ \string<\glshex 2078% superscript 8
+ \string<\glshex 2079% superscript 9
+}
+\newcommand*{\glsxtrfractionrules}{%
+ \glshex 215F% fraction numerator one (1/)
+ \string<\glshex 2189% zero thirds (0/3 = 0)
+ \string<\glshex 2152% one tenth (1/10 = 0.1)
+ \string<\glshex 2151% one ninth (1/9 ~ 0.111)
+ \string<\glshex 215B% one eighth (1/8 = 0.125)
+ \string<\glshex 2150% one seventh (1/7 ~ 0.143)
+ \string<\glshex 2159% one sixth (1/6 ~ 0.167)
+ \string<\glshex 2155% one fifth (1/5 = 0.2)
+ \string<\glshex 00BC% one quarter (1/4 = 0.25)
+ \string<\glshex 2153% one third (1/3 ~ 0.333)
+ \string<\glshex 215C% three eighths (3/8 = 0.375)
+ \string<\glshex 2156% two fifths (2/5 = 0.4)
+ \string<\glshex 00BD% one half (1/2 = 0.5)
+ \string<\glshex 2157% three fifths (3/5 = 0.6)
+ \string<\glshex 215D% five eighths (5/8 = 0.625)
+ \string<\glshex 2154% two thirds (2/3 ~ 0.667)
+ \string<\glshex 00BE% three quarters (3/4 = 0.75)
+ \string<\glshex 2158% four fifths (4/5 = 0.8)
+ \string<\glshex 215A% five sixths (5/6 ~ 0.833)
+ \string<\glshex 215E% seven eighths (7/8 = 0.875)
+}
+\renewcommand{\@glsxtrdialecthook}{%
+ \ifundef\CurrentTrackedScript
+ {%
+ \TrackLangIfHasDefaultScript{\CurrentTrackedLanguage}%
+ {%
+ \edef\CurrentTrackedScript{%
+ \TrackLangGetDefaultScript\CurrentTrackedLanguage}%
+ }%
+ {}%
+ }%
+ {}%
+ \ifdef\CurrentTrackedScript
+ {%
+ \let\gls@orgTrackLangRequireDialectPrefix\TrackLangRequireDialectPrefix
+ \def\TrackLangRequireDialectPrefix{glossariesxtr-}%
+ \let\CurrentTrackedTag\CurrentTrackedScript
+ \IfFileExists{\TrackLangRequireDialectPrefix\CurrentTrackedTag.ldf}
+ {\RequireGlossariesExtraLang{\CurrentTrackedTag}}%
+ {}%
+ \let\TrackLangRequireDialectPrefix\gls@orgTrackLangRequireDialectPrefix
+ }%
+ {}%
+}
+\ifdef\glsxtr@loaddialect
+{%
+ \@ifpackageloaded{tracklang}
+ {%
+ \AnyTrackedLanguages
+ {%
+ \ForEachTrackedDialect{\this@dialect}{\glsxtr@loaddialect}%
+ }%
+ {}%
+ }
+ {}
+}
+{}
+% \end{macrocode}
+%\iffalse
+% \begin{macrocode}
+%</glossaries-extra-bib2gls-2021-11-22.sty>
+% \end{macrocode}
+%\fi
+%\iffalse
+% \begin{macrocode}
+%<*glossaries-extra-stylemods-2021-11-22.sty>
+% \end{macrocode}
+%\fi
+%\subsection{Rollback v1.48 (glossaries-extra-stylemods-2021-11-22.sty)}
+% Version 1.48 preserved for rollback.
+% \begin{macrocode}
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{glossaries-extra-stylemods}[2021/11/22 v1.48 (NLCT)]
+\newcommand*{\@glsxtr@loadstyles}{}
+\DeclareOption{all}{%
+ \appto\@glsxtr@loadstyles{%
+ \RequirePackage{glossary-inline}%
+ \RequirePackage{glossary-list}%
+ \RequirePackage{glossary-tree}%
+ \RequirePackage{glossary-mcols}%
+ \RequirePackage{glossary-long}%
+ \RequirePackage{glossary-longragged}%
+ \RequirePackage{glossary-longbooktabs}%
+ \RequirePackage{glossary-super}%
+ \RequirePackage{glossary-superragged}%
+ \RequirePackage{glossary-bookindex}[=v1.48]%
+ \RequirePackage{glossary-longextra}[=v1.48]%
+ \RequirePackage{glossary-topic}[=v1.48]%
+ }
+}
+\DeclareOption*{%
+ \IfFileExists{glossary-\CurrentOption.sty}
+ {\eappto\@glsxtr@loadstyles{%
+ \noexpand\RequirePackage{glossary-\CurrentOption}}%
+ }%
+ {%
+ \PackageError{glossaries-extra-styles}%
+ {Unknown option `\CurrentOption'}{}%
+ }%
+}
+\ProcessOptions
+\@glsxtr@loadstyles
+\providecommand*{\glsxtrprelocation}{\space}
+\providecommand{\renewglossarystyle}[2]{%
+ \ifcsundef{@glsstyle@#1}%
+ {%
+ \PackageError{glossaries-extra}{Glossary style `#1' isn't already defined}{}%
+ }%
+ {%
+ \csdef{@glsstyle@#1}{#2}%
+ }%
+}
+\ifdef{\@glsstyle@listdotted}
+{%
+ \renewglossarystyle{listdotted}{%
+ \setglossarystyle{list}%
+ \renewcommand*{\glossentry}[2]{%
+ \item[]\makebox[\glslistdottedwidth][l]{%
+ \glsentryitem{##1}%
+ \glstarget{##1}{\glossentryname{##1}}%
+ \unskip\leaders\hbox to 2.9mm{\hss.}\hfill\strut}%
+ \glossentrydesc{##1}\glspostdescription}%
+ \renewcommand*{\subglossentry}[3]{%
+ \item[]\makebox[\glslistdottedwidth][l]{%
+ \glssubentryitem{##2}%
+ \glstarget{##2}{\glossentryname{##2}}%
+ \unskip\leaders\hbox to 2.9mm{\hss.}\hfill\strut}%
+ \glossentrydesc{##2}\glspostdescription}%
+ }
+}
+{%
+}
+\ifdef{\@glsstyle@list}
+{%
+ \newcommand{\glslistprelocation}{\glsxtrprelocation}
+ \newcommand{\glslistchildprelocation}{\glslistprelocation}
+ \newcommand{\glslistchildpostlocation}{.}
+ \newcommand{\glslistdesc}[1]{\glossentrydesc{#1}\glspostdescription}
+ \newcommand{\glslistgroupskip}{\nobreak\indexspace\nobreak}
+ \newcommand{\glslistitem}[1]{%
+ \item[\glsentryitem{#1}%
+ \glstarget{#1}{\glossentryname{#1}}]%
+ }
+ \providecommand{\glslistinit}{%
+ \ifdef\GetTitleStringDisableCommands
+ {%
+ \GetTitleStringSetup{expand}%
+ \GetTitleStringDisableCommands{%
+ \let\glsentryitem\@gobble
+ \let\glstarget\@secondoftwo
+ \let\glossentryname\glslistexpandedname
+ \let\glslistgroupheaderfmt\@firstofone
+ \let\glsgetgrouptitle\@firstofone
+ \let\glsnavhypertarget\@secondoftwo
+ \let\glsnavigation\relax
+ }%
+ }%
+ {}%
+ }
+ \providecommand{\glslistexpandedname}[1]{%
+ \ifcsname glo@\glsdetoklabel{#1}@name\endcsname
+ \expandafter\expandonce\csname glo@\glsdetoklabel{#1}@name\expandafter\endcsname
+ \fi
+ }
+ \renewglossarystyle{list}{%
+ \renewenvironment{theglossary}%
+ {\glslistinit\begin{description}}{\end{description}}%
+ \renewcommand*{\glossaryheader}{}%
+ \renewcommand*{\glsgroupheading}[1]{}%
+ \renewcommand*{\glossentry}[2]{%
+ \glslistitem{##1}\glslistdesc{##1}\glslistprelocation ##2}%
+ \renewcommand*{\subglossentry}[3]{%
+ \glssubentryitem{##2}%
+ \glstarget{##2}{\strut}\space
+ \glslistdesc{##2}%
+ \glslistchildprelocation ##3\glslistchildpostlocation}%
+ \renewcommand*{\glsgroupskip}{\ifglsnogroupskip\else\glslistgroupskip\fi}%
+ }
+}
+{}
+\ifdef{\@glsstyle@altlist}
+{%
+ \newcommand{\glsaltlistitem}[1]{%
+ \glslistitem{#1}%
+ \mbox{}\par\nobreak\@afterheading
+ }
+ \renewglossarystyle{altlist}{%
+ \setglossarystyle{list}%
+ \renewcommand*{\glossentry}[2]{%
+ \glsaltlistitem{##1}%
+ \glslistdesc{##1}\glslistprelocation ##2}%
+ \renewcommand{\subglossentry}[3]{%
+ \par
+ \glssubentryitem{##2}%
+ \glstarget{##2}{\strut}\glslistdesc{##2}%
+ \glslistchildprelocation ##3}%
+ }
+}
+{}
+\ifdef{\@glsstyle@listgroup}
+{%
+ \newcommand{\glslistgroupheaderitem}[2]{\item[{#2}]}
+ \newcommand{\glslistgroupafterheader}{%
+ \mbox{}\par\nobreak\@afterheading
+ }
+ \renewglossarystyle{listgroup}{%
+ \setglossarystyle{list}%
+ \renewcommand*{\glsgroupheading}[1]{%
+ \glslistgroupheaderitem{##1}{\glslistgroupheaderfmt{\glsgetgrouptitle{##1}}}%
+ \glslistgroupafterheader
+ }%
+ }
+}
+{}
+\ifdef{\@glsstyle@listhypergroup}
+{%
+ \renewglossarystyle{listhypergroup}{%
+ \setglossarystyle{list}%
+ \renewcommand*{\glossaryheader}{%
+ \glslistnavigationitem{\glsnavigation}}%
+ \renewcommand*{\glsgroupheading}[1]{%
+ \glslistgroupheaderitem{##1}{\glslistgroupheaderfmt
+ {\glsnavhypertarget{##1}{\glsgetgrouptitle{##1}}}}%
+ \glslistgroupafterheader
+ }%
+ }
+}
+{}
+\ifdef{\@glsstyle@altlistgroup}
+{%
+ \renewglossarystyle{altlistgroup}{%
+ \setglossarystyle{altlist}%
+ \renewcommand*{\glsgroupheading}[1]{%
+ \glslistgroupheaderitem{##1}%
+ {\glslistgroupheaderfmt{\glsgetgrouptitle{##1}}}%
+ \glslistgroupafterheader
+ }%
+ }
+}
+{}
+\ifdef{\@glsstyle@altlisthypergroup}
+{%
+ \renewglossarystyle{altlisthypergroup}{%
+ \setglossarystyle{altlist}%
+ \renewcommand*{\glossaryheader}{%
+ \glslistnavigationitem{\glsnavigation}}%
+ \renewcommand*{\glsgroupheading}[1]{%
+ \glslistgroupheaderitem{##1}{\glslistgroupheaderfmt
+ {\glsnavhypertarget{##1}{\glsgetgrouptitle{##1}}}}%
+ \glslistgroupafterheader
+ }%
+ }
+}
+{}
+\ifcsdef{@glsstyle@long}
+{%
+ \renewglossarystyle{long}{%
+ \renewenvironment{theglossary}%
+ {\begin{longtable}{lp{\glsdescwidth}}}%
+ {\end{longtable}}%
+ \renewcommand*{\glossaryheader}{}%
+ \renewcommand*{\glsgroupheading}[1]{}%
+ \renewcommand{\glossentry}[2]{%
+ \glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
+ \glossentrydesc{##1}\glspostdescription
+ \glsxtrprelocation ##2\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ &
+ \glssubentryitem{##2}%
+ \glstarget{##2}{\strut}\glossentrydesc{##2}\glspostdescription
+ \glsxtrprelocation ##3\tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{ & \tabularnewline}%
+ \fi
+ }
+}
+{}
+\ifcsdef{@glsstyle@long3col}
+{%
+ \renewglossarystyle{long3col}{%
+ \renewenvironment{theglossary}%
+ {\begin{longtable}{lp{\glsdescwidth}p{\glspagelistwidth}}}%
+ {\end{longtable}}%
+ \renewcommand*{\glossaryheader}{}%
+ \renewcommand*{\glsgroupheading}[1]{}%
+ \renewcommand{\glossentry}[2]{%
+ \glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
+ \glossentrydesc{##1}\glspostdescription & ##2\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ &
+ \glssubentryitem{##2}%
+ \glstarget{##2}{\strut}\glossentrydesc{##2}\glspostdescription &
+ ##3\tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{& &\tabularnewline}%
+ \fi
+ }
+}
+{}
+\ifcsdef{@glsstyle@long4col}
+{%
+ \renewglossarystyle{long4col}{%
+ \renewenvironment{theglossary}%
+ {\begin{longtable}{llll}}%
+ {\end{longtable}}%
+ \renewcommand*{\glossaryheader}{}%
+ \renewcommand*{\glsgroupheading}[1]{}%
+ \renewcommand{\glossentry}[2]{%
+ \glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
+ \glossentrydesc{##1}\glspostdescription &
+ \glossentrysymbol{##1} &
+ ##2\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ &
+ \glssubentryitem{##2}%
+ \glstarget{##2}{\strut}\glossentrydesc{##2}\glspostdescription &
+ \glossentrysymbol{##2} & ##3\tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{& & &\tabularnewline}%
+ \fi
+ }
+}
+{}
+\ifcsdef{@glsstyle@longragged}
+{%
+ \renewglossarystyle{longragged}{%
+ \renewenvironment{theglossary}%
+ {\begin{longtable}{l>{\raggedright}p{\glsdescwidth}}}%
+ {\end{longtable}}%
+ \renewcommand*{\glossaryheader}{}%
+ \renewcommand*{\glsgroupheading}[1]{}%
+ \renewcommand{\glossentry}[2]{%
+ \glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
+ \glossentrydesc{##1}\glspostdescription\glsxtrprelocation ##2%
+ \tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ &
+ \glssubentryitem{##2}%
+ \glstarget{##2}{\strut}\glossentrydesc{##2}%
+ \glspostdescription\glsxtrprelocation ##3%
+ \tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{ & \tabularnewline}%
+ \fi
+ }
+}
+{}
+\ifcsdef{@glsstyle@longragged3col}
+{%
+ \renewglossarystyle{longragged3col}{%
+ \renewenvironment{theglossary}%
+ {\begin{longtable}{l>{\raggedright}p{\glsdescwidth}%
+ >{\raggedright}p{\glspagelistwidth}}}%
+ {\end{longtable}}%
+ \renewcommand*{\glossaryheader}{}%
+ \renewcommand*{\glsgroupheading}[1]{}%
+ \renewcommand{\glossentry}[2]{%
+ \glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
+ \glossentrydesc{##1}\glspostdescription & ##2\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ &
+ \glssubentryitem{##2}%
+ \glstarget{##2}{\strut}\glossentrydesc{##2}\glspostdescription &
+ ##3\tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{& &\tabularnewline}%
+ \fi
+ }
+}
+{}
+\ifcsdef{@glsstyle@altlongragged4col}
+{%
+ \renewglossarystyle{altlongragged4col}{%
+ \renewenvironment{theglossary}%
+ {\begin{longtable}{l>{\raggedright}p{\glsdescwidth}l%
+ >{\raggedright}p{\glspagelistwidth}}}%
+ {\end{longtable}}%
+ \renewcommand*{\glossaryheader}{}%
+ \renewcommand*{\glsgroupheading}[1]{}%
+ \renewcommand{\glossentry}[2]{%
+ \glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
+ \glossentrydesc{##1}\glspostdescription & \glossentrysymbol{##1} &
+ ##2\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ &
+ \glssubentryitem{##2}%
+ \glstarget{##2}{\strut}\glossentrydesc{##2}\glspostdescription &
+ \glossentrysymbol{##2} & ##3\tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{& & &\tabularnewline}%
+ \fi
+ }
+}
+{}
+\ifcsdef{@glsstyle@super}
+{%
+ \renewglossarystyle{super}{%
+ \renewenvironment{theglossary}%
+ {\tablehead{}\tabletail{}%
+ \begin{supertabular}{lp{\glsdescwidth}}}%
+ {\end{supertabular}}%
+ \renewcommand*{\glossaryheader}{}%
+ \renewcommand*{\glsgroupheading}[1]{}%
+ \renewcommand{\glossentry}[2]{%
+ \glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
+ \glossentrydesc{##1}\glspostdescription
+ \glsxtrprelocation ##2\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ &
+ \glssubentryitem{##2}%
+ \glstarget{##2}{\strut}\glossentrydesc{##2}\glspostdescription
+ \glsxtrprelocation ##3\tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{& \tabularnewline}%
+ \fi
+ }
+}
+{}
+\ifcsdef{@glsstyle@super3col}
+{%
+ \renewglossarystyle{super3col}{%
+ \renewenvironment{theglossary}%
+ {\tablehead{}\tabletail{}%
+ \begin{supertabular}{lp{\glsdescwidth}p{\glspagelistwidth}}}%
+ {\end{supertabular}}%
+ \renewcommand*{\glossaryheader}{}%
+ \renewcommand*{\glsgroupheading}[1]{}%
+ \renewcommand{\glossentry}[2]{%
+ \glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
+ \glossentrydesc{##1}\glspostdescription & ##2\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ &
+ \glssubentryitem{##2}%
+ \glstarget{##2}{\strut}\glossentrydesc{##2}\glspostdescription &
+ ##3\tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{ & &\tabularnewline}%
+ \fi
+ }
+}
+{}
+\ifcsdef{@glsstyle@super4col}
+{%
+ \renewglossarystyle{super4col}{%
+ \renewenvironment{theglossary}%
+ {\tablehead{}\tabletail{}%
+ \begin{supertabular}{llll}}{%
+ \end{supertabular}}%
+ \renewcommand*{\glossaryheader}{}%
+ \renewcommand*{\glsgroupheading}[1]{}%
+ \renewcommand{\glossentry}[2]{%
+ \glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
+ \glossentrydesc{##1}\glspostdescription &
+ \glossentrysymbol{##1} & ##2\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ &
+ \glssubentryitem{##2}%
+ \glstarget{##2}{\strut}\glossentrydesc{##2}\glspostdescription &
+ \glossentrysymbol{##2} & ##3\tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{& & &\tabularnewline}%
+ \fi
+ }
+}
+{}
+\ifcsdef{@glsstyle@superragged}
+{%
+ \renewglossarystyle{superragged}{%
+ \renewenvironment{theglossary}%
+ {\tablehead{}\tabletail{}%
+ \begin{supertabular}{l>{\raggedright}p{\glsdescwidth}}}%
+ {\end{supertabular}}%
+ \renewcommand*{\glossaryheader}{}%
+ \renewcommand*{\glsgroupheading}[1]{}%
+ \renewcommand{\glossentry}[2]{%
+ \glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
+ \glossentrydesc{##1}\glspostdescription\glsxtrprelocation ##2%
+ \tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ &
+ \glssubentryitem{##2}%
+ \glstarget{##2}{\strut}\glossentrydesc{##2}\glspostdescription
+ \glsxtrprelocation ##3%
+ \tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{& \tabularnewline}%
+ \fi
+ }
+}
+{}
+\ifcsdef{@glsstyle@superragged3col}
+{%
+ \renewglossarystyle{superragged3col}{%
+ \renewenvironment{theglossary}%
+ {\tablehead{}\tabletail{}%
+ \begin{supertabular}{l>{\raggedright}p{\glsdescwidth}%
+ >{\raggedright}p{\glspagelistwidth}}}%
+ {\end{supertabular}}%
+ \renewcommand*{\glossaryheader}{}%
+ \renewcommand*{\glsgroupheading}[1]{}%
+ \renewcommand{\glossentry}[2]{%
+ \glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
+ \glossentrydesc{##1}\glspostdescription &
+ ##2\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ &
+ \glssubentryitem{##2}%
+ \glstarget{##2}{\strut}\glossentrydesc{##2}\glspostdescription &
+ ##3\tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{ & &\tabularnewline}%
+ \fi
+ }
+}
+{}
+\ifcsdef{@glsstyle@altsuperragged4col}
+{%
+ \renewglossarystyle{altsuperragged4col}{%
+ \renewenvironment{theglossary}%
+ {\tablehead{}\tabletail{}%
+ \begin{supertabular}{l>{\raggedright}p{\glsdescwidth}l%
+ >{\raggedright}p{\glspagelistwidth}}}%
+ {\end{supertabular}}%
+ \renewcommand*{\glossaryheader}{}%
+ \renewcommand{\glossentry}[2]{%
+ \glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
+ \glossentrydesc{##1}\glspostdescription &
+ \glossentrysymbol{##1} & ##2\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ &
+ \glssubentryitem{##2}%
+ \glstarget{##2}{\strut}\glossentrydesc{##2}\glspostdescription &
+ \glossentrysymbol{##2} & ##3\tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{& & &\tabularnewline}%
+ \fi
+ }
+}
+{}
+\ifdef{\@glsstyle@inline}
+{%
+ \renewcommand*{\glspostinline}{.\spacefactor\sfcode`\.}
+ \renewcommand*{\glsinlinedescformat}[3]{%
+ \space#1\glsxtrpostdescription}
+ \renewcommand*{\glsinlinesubdescformat}[3]{%
+ #1\glsxtrpostdescription}
+}
+{}
+\ifdef\glstreenamefmt
+{
+ \newcommand{\glstreedefaultnamefmt}[1]{\textbf{#1}}
+ \renewcommand{\glstreenamefmt}[1]{\glstreedefaultnamefmt{#1}}
+ \def\glstreegroupheaderfmt#1{\glstreedefaultnamefmt{#1}}
+ \def\glstreenavigationfmt#1{\glstreedefaultnamefmt{#1}}
+ \newcommand{\glstreePreHeader}[2]{}
+}
+{}
+\ifdef{\@glsstyle@index}
+{
+ \newcommand*{\glstreeprelocation}{\glsxtrprelocation}
+ \newcommand*{\glstreechildprelocation}{\glstreeprelocation}
+ \newcommand{\glstreegroupskip}{\indexspace}
+ \newcommand{\glstreegroupheaderskip}{\nopagebreak\glstreegroupskip\nobreak}
+ \renewglossarystyle{index}{%
+ \renewenvironment{theglossary}%
+ {\setlength{\parindent}{0pt}%
+ \setlength{\parskip}{0pt plus 0.3pt}%
+ \let\item\glstreeitem
+ \let\subitem\glstreesubitem
+ \let\subsubitem\glstreesubsubitem
+ }%
+ {\par}%
+ \renewcommand*{\glossaryheader}{}%
+ \renewcommand*{\glsgroupheading}[1]{}%
+ \renewcommand*{\glossentry}[2]{%
+ \item\glsentryitem{##1}%
+ \glstreenamefmt{\glstarget{##1}{\glossentryname{##1}}}%
+ \glstreesymbol{##1}%
+ \glstreeDescLoc{##1}{##2}%
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ \ifcase##1\relax
+ \item
+ \or
+ \subitem
+ \glssubentryitem{##2}%
+ \else
+ \subsubitem
+ \fi
+ \glstreenamefmt{\glstarget{##2}{\glossentryname{##2}}}%
+ \glstreechildsymbol{##2}%
+ \glstreeChildDescLoc{##2}{##3}%
+ }%
+ \renewcommand*{\glsgroupskip}{\ifglsnogroupskip\else\glstreegroupskip\fi}%
+ }
+}
+{}
+\ifdef{\@glsstyle@indexgroup}
+{%
+ \renewglossarystyle{indexgroup}{%
+ \setglossarystyle{index}%
+ \renewcommand*{\glsgroupheading}[1]{%
+ \glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
+ \glstreePreHeader{##1}{\glsxtr@grptitle}%
+ \item\glstreegroupheaderfmt{\glsxtr@grptitle}%
+ \glstreegroupheaderskip\@afterheading
+ }%
+ }
+}
+{}
+\ifdef{\@glsstyle@indexhypergroup}
+{%
+ \renewglossarystyle{indexhypergroup}{%
+ \setglossarystyle{index}%
+ \renewcommand*{\glossaryheader}{%
+ \item\glstreenavigationfmt{\glsnavigation}%
+ \glstreegroupheaderskip\@afterheading}%
+ \renewcommand*{\glsgroupheading}[1]{%
+ \glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
+ \glstreePreHeader{##1}{\glsxtr@grptitle}%
+ \item\glstreegroupheaderfmt
+ {\glsnavhypertarget{##1}{\glsxtr@grptitle}}%
+ \glstreegroupheaderskip\@afterheading}%
+ }%
+}
+{}
+\ifdef{\@glsstyle@tree}
+{%
+\newcommand{\glsxtrtreepredesc}{\glstreepredesc}
+\newcommand{\glsxtrtreechildpredesc}{\glstreechildpredesc}
+ \newcommand{\glstreedesc}[1]{%
+ \glsxtrtreepredesc\glossentrydesc{#1}\glspostdescription
+ }
+ \newcommand{\glstreeDescLoc}[2]{%
+ \ifglshasdesc{#1}%
+ {\glstreedesc{#1}\glstreeprelocation}%
+ {\ifglshassymbol{#1}{\glstreeprelocation}{\glstreeNoDescSymbolPreLocation}}%
+ #2%
+ }
+ \newcommand{\glstreeNoDescSymbolPreLocation}{\space}
+ \newcommand{\glstreesymbol}[1]{%
+ \ifglshassymbol{#1}{\space(\glossentrysymbol{#1})}{}%
+ }%
+ \newcommand{\glstreechilddesc}[1]{%
+ \glsxtrtreechildpredesc\glossentrydesc{#1}\glspostdescription
+ }%
+ \newcommand{\glstreeChildDescLoc}[2]{%
+ \ifglshasdesc{#1}%
+ {\glstreechilddesc{#1}\glstreechildprelocation}%
+ {\ifglshassymbol{#1}{\glstreechildprelocation}%
+ {\glstreeNoDescSymbolPreLocation}%
+ }%
+ #2%
+ }%
+ \newcommand{\glstreechildsymbol}[1]{%
+ \glstreesymbol{#1}%
+ }%
+ \renewglossarystyle{tree}{%
+ \renewenvironment{theglossary}%
+ {\setlength{\parindent}{0pt}%
+ \setlength{\parskip}{0pt plus 0.3pt}}%
+ {}%
+ \renewcommand*{\glossaryheader}{}%
+ \renewcommand*{\glsgroupheading}[1]{}%
+ \renewcommand{\glossentry}[2]{%
+ \hangindent0pt\relax
+ \parindent0pt\relax
+ \glsentryitem{##1}\glstreenamefmt{\glstarget{##1}{\glossentryname{##1}}}%
+ \glstreesymbol{##1}%
+ \glstreeDescLoc{##1}{##2}\par
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ \hangindent##1\glstreeindent\relax
+ \parindent##1\glstreeindent\relax
+ \ifnum##1=1\relax
+ \glssubentryitem{##2}%
+ \fi
+ \glstreenamefmt{\glstarget{##2}{\glossentryname{##2}}}%
+ \glstreechildsymbol{##2}%
+ \glstreeChildDescLoc{##2}{##3}\par
+ }%
+ \renewcommand*{\glsgroupskip}{\ifglsnogroupskip\else\glstreegroupskip\fi}%
+ }%
+}
+{}
+\ifdef{\@glsstyle@treegroup}
+{%
+ \renewglossarystyle{treegroup}{%
+ \setglossarystyle{tree}%
+ \renewcommand{\glsgroupheading}[1]{%
+ \glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
+ \glstreePreHeader{##1}{\glsxtr@grptitle}%
+ \par\noindent\glstreegroupheaderfmt{\glsxtr@grptitle}%
+ \glstreegroupheaderskip\@afterheading}%
+ }
+}
+{}
+\ifdef{\@glsstyle@treehypergroup}
+{%
+ \renewglossarystyle{treehypergroup}{%
+ \setglossarystyle{tree}%
+ \renewcommand*{\glossaryheader}{%
+ \par\noindent\glstreenavigationfmt{\glsnavigation}%
+ \glstreegroupheaderskip\@afterheading}%
+ \renewcommand*{\glsgroupheading}[1]{%
+ \glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
+ \glstreePreHeader{##1}{\glsxtr@grptitle}%
+ \par\noindent
+ \glstreegroupheaderfmt
+ {\glsnavhypertarget{##1}{\glsxtr@grptitle}}%
+ \glstreegroupheaderskip\@afterheading}%
+ }
+}
+{}
+\ifdef{\@glsstyle@treenoname}
+{%
+ \newcommand{\glstreenonamedesc}[1]{%
+ \glstreepredesc\glossentrydesc{#1}\glspostdescription
+ }%
+ \newcommand{\glstreenonamesymbol}[1]{%
+ \ifglshassymbol{#1}{\space(\glossentrysymbol{#1})}{}%
+ }%
+ \newcommand{\glstreenonameDescLoc}[2]{%
+ \glstreenonamedesc{#1}\glstreeprelocation#2%
+ }
+ \newcommand{\glstreenonamechilddesc}[1]{%
+ \glossentrydesc{#1}\glspostdescription
+ }%
+ \newcommand{\glstreenonameChildDescLoc}[2]{%
+ \glstreenonamechilddesc{#1}\glstreechildprelocation#2%
+ }
+ \renewglossarystyle{treenoname}{%
+ \renewenvironment{theglossary}%
+ {\setlength{\parindent}{0pt}%
+ \setlength{\parskip}{0pt plus 0.3pt}}%
+ {}%
+ \renewcommand*{\glossaryheader}{}%
+ \renewcommand*{\glsgroupheading}[1]{}%
+ \renewcommand{\glossentry}[2]{%
+ \hangindent0pt\relax
+ \parindent0pt\relax
+ \glsentryitem{##1}\glstreenamefmt{\glstarget{##1}{\glossentryname{##1}}}%
+ \glstreenonamesymbol{##1}%
+ \glstreenonameDescLoc{##1}{##2}\par
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ \hangindent##1\glstreeindent\relax
+ \parindent##1\glstreeindent\relax
+ \ifnum##1=1\relax
+ \glssubentryitem{##2}%
+ \fi
+ \glstarget{##2}{\strut}%
+ \glstreenonameChildDescLoc{##2}{##3}\par
+ }%
+ \renewcommand*{\glsgroupskip}{\ifglsnogroupskip\else\glstreegroupskip\fi}%
+ }
+}
+{}
+\ifdef{\@glsstyle@treenonamegroup}
+{%
+ \renewglossarystyle{treenonamegroup}{%
+ \setglossarystyle{treenoname}%
+ \renewcommand{\glsgroupheading}[1]{%
+ \glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
+ \glstreePreHeader{##1}{\glsxtr@grptitle}%
+ \par\noindent\glstreegroupheaderfmt{\glsxtr@grptitle}%
+ \glstreegroupheaderskip\@afterheading
+ }%
+ }
+}
+{}
+\ifdef{\@glsstyle@treenonamehypergroup}
+{%
+ \renewglossarystyle{treenonamehypergroup}{%
+ \setglossarystyle{treenoname}%
+ \renewcommand*{\glossaryheader}{%
+ \par\noindent\glstreenavigationfmt{\glsnavigation}%
+ \glstreegroupheaderskip\@afterheading}%
+ \renewcommand*{\glsgroupheading}[1]{%
+ \glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
+ \glstreePreHeader{##1}{\glsxtr@grptitle}%
+ \par\noindent
+ \glstreegroupheaderfmt{\glsnavhypertarget{##1}{\glsxtr@grptitle}}%
+ \glstreegroupheaderskip\@afterheading}%
+ }
+}
+{}
+\ifdef{\@glsstyle@alttree}
+{%
+\newcommand{\glsalttreepredesc}{}
+\newcommand{\glsalttreechildpredesc}{\glsalttreepredesc}
+ \newcommand{\glsxtralttreeSymbolDescLocation}[2]{%
+ {%
+ \let\par\glsxtrAltTreePar
+ \let\glsxtrtreepredesc\glsalttreepredesc
+ \let\glsxtrtreechildpredesc\glsalttreechildpredesc
+ \ifglshassymbol{#1}{(\glossentrysymbol{#1})\space}{}%
+ \glstreeDescLoc{#1}{#2}\par
+ }%
+ }
+ \newlength\glsxtrAltTreeIndent
+ \newcommand{\glsxtrAltTreePar}{%
+ \@@par
+ \glsxtrAltTreeSetHangIndent
+ \setlength{\parindent}{\dimexpr\hangindent+\glsxtrAltTreeIndent}%
+ }
+ \newcommand{\glsxtralttreeSubSymbolDescLocation}[3]{%
+ \glsxtralttreeSymbolDescLocation{#2}{#3}%
+ }
+ \newlength\glsxtrtreetopindent
+ \newcommand*{\glsxtralttreeInit}{%
+ \settowidth{\glsxtrtreetopindent}{\glstreenamefmt{\glsgetwidestname\space}}%
+ \glsxtrAltTreeIndent=\parindent
+ }
+ \newcommand*{\gglssetwidest}[2][0]{%
+ \csgdef{@glswidestname\romannumeral#1}{#2}%
+ }
+ \newcommand*{\eglssetwidest}[2][0]{%
+ \protected@csedef{@glswidestname\romannumeral#1}{#2}%
+ }
+ \newcommand*{\xglssetwidest}[2][0]{%
+ \protected@csxdef{@glswidestname\romannumeral#1}{#2}%
+ }
+ \newcommand*{\glsupdatewidest}[2][0]{%
+ \ifcsundef{@glswidestname\romannumeral#1}%
+ {\csdef{@glswidestname\romannumeral#1}{#2}}%
+ {%
+ \settowidth{\dimen@}{\csuse{@glswidestname\romannumeral#1}}%
+ \settowidth{\dimen@ii}{#2}%
+ \ifdim\dimen@ii>\dimen@
+ \csdef{@glswidestname\romannumeral#1}{#2}%
+ \fi
+ }%
+ }
+ \newcommand*{\gglsupdatewidest}[2][0]{%
+ \ifcsundef{@glswidestname\romannumeral#1}%
+ {\csgdef{@glswidestname\romannumeral#1}{#2}}%
+ {%
+ \settowidth{\dimen@}{\csuse{@glswidestname\romannumeral#1}}%
+ \settowidth{\dimen@ii}{#2}%
+ \ifdim\dimen@ii>\dimen@
+ \csgdef{@glswidestname\romannumeral#1}{#2}%
+ \fi
+ }%
+ }
+ \newcommand*{\eglsupdatewidest}[2][0]{%
+ \ifcsundef{@glswidestname\romannumeral#1}%
+ {\protected@csedef{@glswidestname\romannumeral#1}{#2}}%
+ {%
+ \settowidth{\dimen@}{\csuse{@glswidestname\romannumeral#1}}%
+ \settowidth{\dimen@ii}{#2}%
+ \ifdim\dimen@ii>\dimen@
+ \protected@csedef{@glswidestname\romannumeral#1}{#2}%
+ \fi
+ }%
+ }
+ \newcommand*{\xglsupdatewidest}[2][0]{%
+ \ifcsundef{@glswidestname\romannumeral#1}%
+ {\protected@csxdef{@glswidestname\romannumeral#1}{#2}}%
+ {%
+ \settowidth{\dimen@}{\csuse{@glswidestname\romannumeral#1}}%
+ \settowidth{\dimen@ii}{#2}%
+ \ifdim\dimen@ii>\dimen@
+ \protected@csxdef{@glswidestname\romannumeral#1}{#2}%
+ \fi
+ }%
+ }
+ \newcommand*{\glsgetwidestname}{\@glswidestname}
+ \newcommand*{\glsgetwidestsubname}[1]{%
+ \ifcsundef{@glswidestname\romannumeral#1}%
+ {\@glswidestname}%
+ {\csuse{@glswidestname\romannumeral#1}}%
+ }
+ \let\glsFindWidestTopLevelName\glsfindwidesttoplevelname
+ \newrobustcmd*{\glsFindWidestUsedTopLevelName}[1][\@glo@types]{%
+ \dimen@=0pt\relax
+ \gls@tmplen=0pt\relax
+ \forallglossaries[#1]{\@gls@type}%
+ {%
+ \forglsentries[\@gls@type]{\@glo@label}%
+ {%
+ \ifglsused{\@glo@label}%
+ {%
+ \ifglshasparent{\@glo@label}%
+ {}%
+ {%
+ \settowidth{\dimen@}%
+ {\glstreenamefmt{\glsentryname{\@glo@label}}}%
+ \ifdim\dimen@>\gls@tmplen
+ \gls@tmplen=\dimen@
+ \eglssetwidest{\glsentryname{\@glo@label}}%
+ \fi
+ }%
+ }%
+ {}%
+ }%
+ }%
+ }
+ \newrobustcmd*{\glsFindWidestUsedAnyName}[1][\@glo@types]{%
+ \dimen@=0pt\relax
+ \gls@tmplen=0pt\relax
+ \forallglossaries[#1]{\@gls@type}%
+ {%
+ \forglsentries[\@gls@type]{\@glo@label}%
+ {%
+ \ifglsused{\@glo@label}%
+ {%
+ \settowidth{\dimen@}%
+ {\glstreenamefmt{\glsentryname{\@glo@label}}}%
+ \ifdim\dimen@>\gls@tmplen
+ \gls@tmplen=\dimen@
+ \eglssetwidest{\glsentryname{\@glo@label}}%
+ \fi
+ }%
+ {}%
+ }%
+ }%
+ }
+ \newrobustcmd*{\glsFindWidestAnyName}[1][\@glo@types]{%
+ \dimen@=0pt\relax
+ \gls@tmplen=0pt\relax
+ \forallglossaries[#1]{\@gls@type}%
+ {%
+ \forglsentries[\@gls@type]{\@glo@label}%
+ {%
+ \settowidth{\dimen@}%
+ {\glstreenamefmt{\glsentryname{\@glo@label}}}%
+ \ifdim\dimen@>\gls@tmplen
+ \gls@tmplen=\dimen@
+ \eglssetwidest{\glsentryname{\@glo@label}}%
+ \fi
+ }%
+ }%
+ }
+ \newrobustcmd*{\glsFindWidestUsedLevelTwo}[1][\@glo@types]{%
+ \dimen@=0pt\relax
+ \dimen@i=0pt\relax
+ \dimen@ii=0pt\relax
+ \forallglossaries[#1]{\@gls@type}%
+ {%
+ \forglsentries[\@gls@type]{\@glo@label}%
+ {%
+ \ifglsused{\@glo@label}%
+ {%
+ \ifglshasparent{\@glo@label}%
+ {%
+ \protected@edef\@glo@parent{\csuse{glo@\glsdetoklabel{\@glo@label}@parent}}%
+ \ifglshasparent{\@glo@parent}%
+ {%
+ \protected@edef\@glo@parent{\csuse{glo@\glsdetoklabel{\@glo@parent}@parent}}%
+ \ifglshasparent{\@glo@parent}%
+ {}%
+ {%
+ \settowidth{\gls@tmplen}%
+ {\glstreenamefmt{\glsentryname{\@glo@label}}}%
+ \ifdim\gls@tmplen>\dimen@ii
+ \dimen@ii=\gls@tmplen
+ \eglssetwidest[2]{\glsentryname{\@glo@label}}%
+ \fi
+ }%
+ }%
+ {%
+ \settowidth{\gls@tmplen}%
+ {\glstreenamefmt{\glsentryname{\@glo@label}}}%
+ \ifdim\gls@tmplen>\dimen@i
+ \dimen@i=\gls@tmplen
+ \eglssetwidest[1]{\glsentryname{\@glo@label}}%
+ \fi
+ }%
+ }%
+ {%
+ \settowidth{\gls@tmplen}%
+ {\glstreenamefmt{\glsentryname{\@glo@label}}}%
+ \ifdim\gls@tmplen>\dimen@
+ \dimen@=\gls@tmplen
+ \eglssetwidest{\glsentryname{\@glo@label}}%
+ \fi
+ }%
+ }%
+ {}%
+ }%
+ }%
+ }
+ \newrobustcmd*{\glsFindWidestLevelTwo}[1][\@glo@types]{%
+ \dimen@=0pt\relax
+ \dimen@i=0pt\relax
+ \dimen@ii=0pt\relax
+ \forallglossaries[#1]{\@gls@type}%
+ {%
+ \forglsentries[\@gls@type]{\@glo@label}%
+ {%
+ \ifglshasparent{\@glo@label}%
+ {%
+ \protected@edef\@glo@parent{\csuse{glo@\glsdetoklabel{\@glo@label}@parent}}%
+ \ifglshasparent{\@glo@parent}%
+ {%
+ \protected@edef\@glo@parent{\csuse{glo@\glsdetoklabel{\@glo@parent}@parent}}%
+ \ifglshasparent{\@glo@parent}%
+ {}%
+ {%
+ \settowidth{\gls@tmplen}%
+ {\glstreenamefmt{\glsentryname{\@glo@label}}}%
+ \ifdim\gls@tmplen>\dimen@ii
+ \dimen@ii=\gls@tmplen
+ \eglssetwidest[2]{\glsentryname{\@glo@label}}%
+ \fi
+ }%
+ }%
+ {%
+ \settowidth{\gls@tmplen}%
+ {\glstreenamefmt{\glsentryname{\@glo@label}}}%
+ \ifdim\gls@tmplen>\dimen@i
+ \dimen@i=\gls@tmplen
+ \eglssetwidest[1]{\glsentryname{\@glo@label}}%
+ \fi
+ }%
+ }%
+ {%
+ \settowidth{\gls@tmplen}%
+ {\glstreenamefmt{\glsentryname{\@glo@label}}}%
+ \ifdim\gls@tmplen>\dimen@
+ \dimen@=\gls@tmplen
+ \eglssetwidest{\glsentryname{\@glo@label}}%
+ \fi
+ }%
+ }%
+ }%
+ }
+ \newrobustcmd*{\glsFindWidestUsedAnyNameSymbol}[2][\@glo@types]{%
+ \dimen@=0pt\relax
+ \gls@tmplen=0pt\relax
+ #2=0pt\relax
+ \forallglossaries[#1]{\@gls@type}%
+ {%
+ \forglsentries[\@gls@type]{\@glo@label}%
+ {%
+ \ifglsused{\@glo@label}%
+ {%
+ \settowidth{\dimen@}%
+ {\glstreenamefmt{\glsentryname{\@glo@label}}}%
+ \ifdim\dimen@>\gls@tmplen
+ \gls@tmplen=\dimen@
+ \eglssetwidest{\glsentryname{\@glo@label}}%
+ \fi
+ \settowidth{\dimen@}%
+ {\glsentrysymbol{\@glo@label}}%
+ \ifdim\dimen@>#2\relax
+ #2=\dimen@
+ \fi
+ }%
+ {}%
+ }%
+ }%
+ }
+ \newrobustcmd*{\glsFindWidestAnyNameSymbol}[2][\@glo@types]{%
+ \dimen@=0pt\relax
+ \gls@tmplen=0pt\relax
+ #2=0pt\relax
+ \forallglossaries[#1]{\@gls@type}%
+ {%
+ \forglsentries[\@gls@type]{\@glo@label}%
+ {%
+ \settowidth{\dimen@}%
+ {\glstreenamefmt{\glsentryname{\@glo@label}}}%
+ \ifdim\dimen@>\gls@tmplen
+ \gls@tmplen=\dimen@
+ \eglssetwidest{\glsentryname{\@glo@label}}%
+ \fi
+ \settowidth{\dimen@}%
+ {\glsentrysymbol{\@glo@label}}%
+ \ifdim\dimen@>#2\relax
+ #2=\dimen@
+ \fi
+ }%
+ }%
+ }
+ \newrobustcmd*{\glsFindWidestUsedAnyNameSymbolLocation}[3][\@glo@types]{%
+ \dimen@=0pt\relax
+ \gls@tmplen=0pt\relax
+ #2=0pt\relax
+ #3=0pt\relax
+ \forallglossaries[#1]{\@gls@type}%
+ {%
+ \forglsentries[\@gls@type]{\@glo@label}%
+ {%
+ \ifglsused{\@glo@label}%
+ {%
+ \settowidth{\dimen@}%
+ {\glstreenamefmt{\glsentryname{\@glo@label}}}%
+ \ifdim\dimen@>\gls@tmplen
+ \gls@tmplen=\dimen@
+ \eglssetwidest{\glsentryname{\@glo@label}}%
+ \fi
+ \settowidth{\dimen@}%
+ {\glsentrysymbol{\@glo@label}}%
+ \ifdim\dimen@>#2\relax
+ #2=\dimen@
+ \fi
+ \settowidth{\dimen@}%
+ {\GlsXtrFormatLocationList{\glsentrynumberlist{\@glo@label}}}%
+ \ifdim\dimen@>#3\relax
+ #3=\dimen@
+ \fi
+ }%
+ {}%
+ }%
+ }%
+ }
+ \newrobustcmd*{\glsFindWidestAnyNameSymbolLocation}[3][\@glo@types]{%
+ \dimen@=0pt\relax
+ \gls@tmplen=0pt\relax
+ #2=0pt\relax
+ #3=0pt\relax
+ \forallglossaries[#1]{\@gls@type}%
+ {%
+ \forglsentries[\@gls@type]{\@glo@label}%
+ {%
+ \settowidth{\dimen@}%
+ {\glstreenamefmt{\glsentryname{\@glo@label}}}%
+ \ifdim\dimen@>\gls@tmplen
+ \gls@tmplen=\dimen@
+ \eglssetwidest{\glsentryname{\@glo@label}}%
+ \fi
+ \settowidth{\dimen@}%
+ {\glsentrysymbol{\@glo@label}}%
+ \ifdim\dimen@>#2\relax
+ #2=\dimen@
+ \fi
+ \settowidth{\dimen@}%
+ {\GlsXtrFormatLocationList{\glsentrynumberlist{\@glo@label}}}%
+ \ifdim\dimen@>#3\relax
+ #3=\dimen@
+ \fi
+ }%
+ }%
+ }
+ \newrobustcmd*{\glsFindWidestUsedAnyNameLocation}[2][\@glo@types]{%
+ \dimen@=0pt\relax
+ \gls@tmplen=0pt\relax
+ #2=0pt\relax
+ \forallglossaries[#1]{\@gls@type}%
+ {%
+ \forglsentries[\@gls@type]{\@glo@label}%
+ {%
+ \ifglsused{\@glo@label}%
+ {%
+ \settowidth{\dimen@}%
+ {\glstreenamefmt{\glsentryname{\@glo@label}}}%
+ \ifdim\dimen@>\gls@tmplen
+ \gls@tmplen=\dimen@
+ \eglssetwidest{\glsentryname{\@glo@label}}%
+ \fi
+ \settowidth{\dimen@}%
+ {\GlsXtrFormatLocationList{\glsentrynumberlist{\@glo@label}}}%
+ \ifdim\dimen@>#2\relax
+ #2=\dimen@
+ \fi
+ }%
+ {}%
+ }%
+ }%
+ }
+ \newrobustcmd*{\glsFindWidestAnyNameLocation}[2][\@glo@types]{%
+ \dimen@=0pt\relax
+ \gls@tmplen=0pt\relax
+ #2=0pt\relax
+ \forallglossaries[#1]{\@gls@type}%
+ {%
+ \forglsentries[\@gls@type]{\@glo@label}%
+ {%
+ \settowidth{\dimen@}%
+ {\glstreenamefmt{\glsentryname{\@glo@label}}}%
+ \ifdim\dimen@>\gls@tmplen
+ \gls@tmplen=\dimen@
+ \eglssetwidest{\glsentryname{\@glo@label}}%
+ \fi
+ \settowidth{\dimen@}%
+ {\GlsXtrFormatLocationList{\glsentrynumberlist{\@glo@label}}}%
+ \ifdim\dimen@>#2\relax
+ #2=\dimen@
+ \fi
+ }%
+ }%
+ }
+ \newcommand*{\glsxtrComputeTreeIndent}[1]{%
+ \glstreeindent=\glsxtrtreetopindent\relax
+ }
+ \newcommand*{\glsxtrComputeTreeSubIndent}[3]{%
+ \ifcsundef{@glswidestname\romannumeral#1}%
+ {%
+ \settowidth{#3}{\glstreenamefmt{\@glswidestname\space}}%
+ }%
+ {%
+ \settowidth{#3}{\glstreenamefmt{%
+ \csname @glswidestname\romannumeral#1\endcsname\space}}%
+ }%
+ }
+ \newcommand*{\glsxtrAltTreeSetHangIndent}{\hangindent\glstreeindent}
+ \newcommand*{\glsxtrAltTreeSetSubHangIndent}[1]{\hangindent\glstreeindent}
+ \renewglossarystyle{alttree}{%
+ \renewenvironment{theglossary}%
+ {%
+ \glsxtralttreeInit
+ \def\@gls@prevlevel{-1}%
+ \mbox{}\par}%
+ {\par}%
+ \renewcommand*{\glossaryheader}{}%
+ \renewcommand*{\glsgroupheading}[1]{}%
+ \renewcommand{\glossentry}[2]{%
+ \ifnum\@gls@prevlevel=0\relax
+ \else
+ \glsxtrComputeTreeIndent{##1}%
+ \fi
+ \parindent\glstreeindent
+ \glsxtrAltTreeSetHangIndent
+ \makebox[0pt][r]%
+ {%
+ \glstreenamebox{\glstreeindent}%
+ {%
+ \glsentryitem{##1}%
+ \glstreenamefmt{\glstarget{##1}{\glossentryname{##1}}}%
+ }%
+ }%
+ \glsxtralttreeSymbolDescLocation{##1}{##2}%
+ \def\@gls@prevlevel{0}%
+ }
+ \renewcommand{\subglossentry}[3]{%
+ \ifnum##1=1\relax
+ \glssubentryitem{##2}%
+ \fi
+ \ifnum\@gls@prevlevel=##1\relax
+ \else
+ \glsxtrComputeTreeSubIndent{##1}{##2}{\gls@tmplen}%
+ \ifnum\@gls@prevlevel<##1\relax
+ \setlength\glstreeindent\gls@tmplen
+ \addtolength\glstreeindent\parindent
+ \parindent\glstreeindent
+ \else
+ \ifnum\@gls@prevlevel=0\relax
+ \glsxtrComputeTreeIndent{##2}%
+ \else
+ \glsxtrComputeTreeSubIndent{\@gls@prevlevel}{##2}{\glstreeindent}%
+ \fi
+ \addtolength\parindent{-\glstreeindent}%
+ \setlength\glstreeindent\parindent
+ \fi
+ \fi
+ \glsxtrAltTreeSetSubHangIndent{##1}%
+ \makebox[0pt][r]{\glstreenamebox{\gls@tmplen}{%
+ \glstreenamefmt{\glstarget{##2}{\glossentryname{##2}}}}}%
+ \glsxtralttreeSubSymbolDescLocation{##1}{##2}{##3}%
+ \def\@gls@prevlevel{##1}%
+ }%
+ \renewcommand*{\glsgroupskip}{\ifglsnogroupskip\else\glstreegroupskip\fi}%
+ }
+}%
+{%
+}
+\ifdef{\@glsstyle@alttreegroup}
+{%
+ \renewglossarystyle{alttreegroup}{%
+ \setglossarystyle{alttree}%
+ \renewcommand{\glsgroupheading}[1]{\par
+ \def\@gls@prevlevel{-1}%
+ \hangindent0pt\relax
+ \parindent0pt\relax
+ \glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
+ \glstreePreHeader{##1}{\glsxtr@grptitle}%
+ \glstreegroupheaderfmt{\glsxtr@grptitle}%
+ \glstreegroupheaderskip
+ }%
+ }%
+}%
+{%
+}
+\ifdef{\@glsstyle@alttreehypergroup}
+{%
+ \renewglossarystyle{alttreehypergroup}{%
+ \setglossarystyle{alttree}%
+ \renewcommand*{\glossaryheader}{%
+ \par
+ \def\@gls@prevlevel{-1}%
+ \hangindent0pt\relax
+ \parindent0pt\relax
+ \glstreenavigationfmt{\glsnavigation}%
+ \glstreegroupheaderskip
+ }%
+ \renewcommand*{\glsgroupheading}[1]{%
+ \glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
+ \glstreePreHeader{##1}{\glsxtr@grptitle}%
+ \par
+ \def\@gls@prevlevel{-1}%
+ \hangindent0pt\relax
+ \parindent0pt\relax
+ \glstreegroupheaderfmt{\glsnavhypertarget{##1}{\glsxtr@grptitle}}%
+ \glstreegroupheaderskip
+ }%
+ }
+}%
+{%
+}
+\ifdef{\@glsstyle@mcolindexgroup}
+{%
+ \renewglossarystyle{mcolindexgroup}{%
+ \setglossarystyle{mcolindex}%
+ \renewcommand*{\glsgroupheading}[1]{%
+ \glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
+ \glstreePreHeader{##1}{\glsxtr@grptitle}%
+ \item\glstreegroupheaderfmt{\glsxtr@grptitle}%
+ \glstreegroupheaderskip\@afterheading
+ }%
+ }
+}%
+{%
+}
+\ifdef{\@glsstyle@mcolindexhypergroup}
+{%
+ \renewglossarystyle{mcolindexhypergroup}{%
+ \setglossarystyle{mcolindex}%
+ \renewcommand*{\glossaryheader}{%
+ \item\glstreenavigationfmt{\glsnavigation}%
+ \glstreegroupheaderskip\@afterheading
+ }%
+ \renewcommand*{\glsgroupheading}[1]{%
+ \glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
+ \glstreePreHeader{##1}{\glsxtr@grptitle}%
+ \item\glstreegroupheaderfmt
+ {\glsnavhypertarget{##1}{\glsxtr@grptitle}}%
+ \glstreegroupheaderskip\@afterheading
+ }%
+ }
+}%
+{%
+}
+\ifdef{\@glsstyle@mcolindexspannav}
+{%
+ \renewglossarystyle{mcolindexspannav}{%
+ \setglossarystyle{index}%
+ \renewenvironment{theglossary}%
+ {%
+ \begin{multicols}{\glsmcols}[\noindent\glstreenavigationfmt{\glsnavigation}]%
+ \setlength{\parindent}{0pt}%
+ \setlength{\parskip}{0pt plus 0.3pt}%
+ \let\item\glstreeitem}%
+ {\end{multicols}}%
+ \renewcommand*{\glsgroupheading}[1]{%
+ \glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
+ \glstreePreHeader{##1}{\glsxtr@grptitle}%
+ \item\glstreegroupheaderfmt
+ {\glsnavhypertarget{##1}{\glsxtr@grptitle}}%
+ \glstreegroupheaderskip\@afterheading
+ }%
+ }
+}%
+{%
+}
+\ifdef{\@glsstyle@mcoltreegroup}
+{%
+ \renewglossarystyle{mcoltreegroup}{%
+ \setglossarystyle{mcoltree}%
+ \renewcommand{\glsgroupheading}[1]{%
+ \glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
+ \glstreePreHeader{##1}{\glsxtr@grptitle}%
+ \par\noindent\glstreegroupheaderfmt{\glsxtr@grptitle}%
+ \glstreegroupheaderskip\@afterheading
+ }%
+ }
+}%
+{%
+}
+\ifdef{\@glsstyle@mcoltreehypergroup}
+{%
+ \renewglossarystyle{mcoltreehypergroup}{%
+ \setglossarystyle{mcoltree}%
+ \renewcommand*{\glossaryheader}{%
+ \par\noindent\glstreenavigationfmt{\glsnavigation}%
+ \glstreegroupheaderskip
+ }%
+ \renewcommand*{\glsgroupheading}[1]{%
+ \glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
+ \glstreePreHeader{##1}{\glsxtr@grptitle}%
+ \par\noindent
+ \glstreegroupheaderfmt{\glsnavhypertarget{##1}{\glsxtr@grptitle}}%
+ \glstreegroupheaderskip\@afterheading
+ }%
+ }
+}%
+{%
+}
+\ifdef{\@glsstyle@mcoltreespannav}
+{%
+ \renewglossarystyle{mcoltreespannav}{%
+ \setglossarystyle{tree}%
+ \renewenvironment{theglossary}%
+ {%
+ \begin{multicols}{\glsmcols}%
+ [\noindent\glstreenavigationfmt{\glsnavigation}]%
+ \setlength{\parindent}{0pt}%
+ \setlength{\parskip}{0pt plus 0.3pt}%
+ }%
+ {\end{multicols}}%
+ \renewcommand*{\glsgroupheading}[1]{%
+ \glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
+ \glstreePreHeader{##1}{\glsxtr@grptitle}%
+ \par\noindent
+ \glstreegroupheaderfmt{\glsnavhypertarget{##1}{\glsxtr@grptitle}}%
+ \glstreegroupheaderskip\@afterheading
+ }%
+ }
+}%
+{%
+}
+\ifdef{\@glsstyle@mcoltreenonamegroup}
+{%
+ \renewglossarystyle{mcoltreenonamegroup}{%
+ \setglossarystyle{mcoltreenoname}%
+ \renewcommand{\glsgroupheading}[1]{%
+ \glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
+ \glstreePreHeader{##1}{\glsxtr@grptitle}%
+ \par\noindent\glstreegroupheaderfmt{\glsxtr@grptitle}%
+ \glstreegroupheaderskip\@afterheading
+ }%
+ }
+}%
+{%
+}
+\ifdef{\@glsstyle@mcoltreenonamehypergroup}
+{%
+ \renewglossarystyle{mcoltreenonamehypergroup}{%
+ \setglossarystyle{mcoltreenoname}%
+ \renewcommand*{\glossaryheader}{%
+ \par\noindent\glstreenavigationfmt{\glsnavigation}%
+ \glstreegroupheaderskip
+ }%
+ \renewcommand*{\glsgroupheading}[1]{%
+ \glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
+ \glstreePreHeader{##1}{\glsxtr@grptitle}%
+ \par\noindent
+ \glstreegroupheaderfmt{\glsnavhypertarget{##1}{\glsxtr@grptitle}}%
+ \glstreegroupheaderskip\@afterheading}%
+ }
+}%
+{%
+}
+\ifdef{\@glsstyle@mcoltreenonamespannav}
+{%
+ \renewglossarystyle{mcoltreenonamespannav}{%
+ \setglossarystyle{treenoname}%
+ \renewenvironment{theglossary}%
+ {%
+ \begin{multicols}{\glsmcols}%
+ [\noindent\glstreenavigationfmt{\glsnavigation}]%
+ \setlength{\parindent}{0pt}%
+ \setlength{\parskip}{0pt plus 0.3pt}%
+ }%
+ {\end{multicols}}%
+ \renewcommand*{\glsgroupheading}[1]{%
+ \glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
+ \glstreePreHeader{##1}{\glsxtr@grptitle}%
+ \par\noindent
+ \glstreegroupheaderfmt{\glsnavhypertarget{##1}{\glsxtr@grptitle}}%
+ \glstreegroupheaderskip\@afterheading}%
+ }
+}%
+{%
+}
+\ifdef{\@glsstyle@mcolalttree}
+{%
+ \renewglossarystyle{mcolalttree}{%
+ \setglossarystyle{alttree}%
+ \renewenvironment{theglossary}%
+ {%
+ \glsxtralttreeInit
+ \def\@gls@prevlevel{-1}%
+ \begin{multicols}{\glsmcols}%
+ }%
+ {\par\end{multicols}}%
+ }
+}%
+{%
+}
+\ifdef{\@glsstyle@mcolalttreegroup}
+{%
+ \renewglossarystyle{mcolalttreegroup}{%
+ \setglossarystyle{mcolalttree}%
+ \renewcommand{\glsgroupheading}[1]{%
+ \glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
+ \glstreePreHeader{##1}{\glsxtr@grptitle}%
+ \par
+ \def\@gls@prevlevel{-1}%
+ \hangindent0pt\relax
+ \parindent0pt\relax
+ \glstreegroupheaderfmt{\glsxtr@grptitle}%
+ \glstreegroupheaderskip
+ }%
+ }
+}%
+{%
+}
+\ifdef{\@glsstyle@mcolalttreehypergroup}
+{%
+ \renewglossarystyle{mcolalttreehypergroup}{%
+ \setglossarystyle{mcolalttree}%
+ \renewcommand*{\glossaryheader}{%
+ \par
+ \def\@gls@prevlevel{-1}%
+ \hangindent0pt\relax
+ \parindent0pt\relax
+ \glstreenavigationfmt{\glsnavigation}%
+ \glstreegroupheaderskip
+ }%
+ \renewcommand*{\glsgroupheading}[1]{%
+ \glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
+ \glstreePreHeader{##1}{\glsxtr@grptitle}%
+ \par
+ \def\@gls@prevlevel{-1}%
+ \hangindent0pt\relax
+ \parindent0pt\relax
+ \glstreegroupheaderfmt{\glsnavhypertarget{##1}{\glsxtr@grptitle}}%
+ \glstreegroupheaderskip
+ }%
+ }
+}%
+{%
+}
+\ifdef{\@glsstyle@mcolalttreespannav}
+{%
+ \renewglossarystyle{mcolalttreespannav}{%
+ \setglossarystyle{alttree}%
+ \renewenvironment{theglossary}%
+ {%
+ \glsxtralttreeInit
+ \def\@gls@prevlevel{-1}%
+ \begin{multicols}{\glsmcols}%
+ [\noindent\glstreenavigationfmt{\glsnavigation}]%
+ }%
+ {\par\end{multicols}}%
+ \renewcommand*{\glsgroupheading}[1]{%
+ \glsxtrgetgrouptitle{##1}{\glsxtr@grptitle}%
+ \glstreePreHeader{##1}{\glsxtr@grptitle}%
+ \par
+ \def\@gls@prevlevel{-1}%
+ \hangindent0pt\relax
+ \parindent0pt\relax
+ \glstreegroupheaderfmt{\glsnavhypertarget{##1}{\glsxtr@grptitle}}%
+ \glstreegroupheaderskip
+ }%
+ }
+}%
+{%
+}
+\ifx\@glossary@default@style\relax
+\else
+ \setglossarystyle{\@glsxtr@current@style}
+\fi
+% \end{macrocode}
+%\iffalse
+% \begin{macrocode}
+%</glossaries-extra-stylemods-2021-11-22.sty>
+% \end{macrocode}
+%\fi
+%\iffalse
+% \begin{macrocode}
+%<*glossary-bookindex-2021-11-22.sty>
+% \end{macrocode}
+%\fi
+%\subsection{Rollback v1.48 (glossary-bookindex-2021-11-22.sty)}
+% Version 1.48 preserved for rollback.
+% \begin{macrocode}
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{glossary-bookindex}[2021/11/22 v1.48 (NLCT)]
+\RequirePackage{multicol}
+\RequirePackage{glossary-tree}
+\newcommand{\glsxtrbookindexcols}{2}
+\newcommand*{\glsxtrbookindexname}[1]{\glossentryname{#1}}
+\newcommand*{\glsxtrbookindexsubname}[1]{\glsxtrbookindexname{#1}}
+\providecommand*{\glsxtrprelocation}{\space}
+
+\newcommand*{\glsxtrbookindexprelocation}[1]{%
+ \glsxtrifhasfield{location}{#1}%
+ {,\glsxtrprelocation}%
+ {\glsxtrprelocation}%
+}
+\newcommand*{\glsxtrbookindexsubprelocation}[1]{%
+ \glsxtrbookindexprelocation{#1}%
+}
+\newcommand*{\glsxtrbookindexlocation}[2]{#2}
+\newcommand*{\glsxtrbookindexsublocation}{\glsxtrbookindexlocation}
+\newcommand{\glsxtrbookindexparentchildsep}{\nopagebreak}
+\newcommand{\glsxtrbookindexparentsubchildsep}{\glsxtrbookindexparentchildsep}
+\newcommand{\glsxtrbookindexbetween}[2]{}
+\newcommand{\glsxtrbookindexsubbetween}[2]{}
+\newcommand{\glsxtrbookindexsubsubbetween}[2]{}
+\newcommand{\glsxtrbookindexatendgroup}[1]{}
+\newcommand{\glsxtrbookindexsubatendgroup}[1]{}
+\newcommand{\glsxtrbookindexsubsubatendgroup}[1]{}
+\newcommand{\glsxtrbookindexgroupskip}{\ifglsnogroupskip\else\indexspace\fi}
+\newcommand*{\glsxtrbookindexformatheader}[1]{%
+ \par{\centering\glstreegroupheaderfmt{#1}\par}%
+}
+\ifdef\pdfbookmark
+{%
+ \newcommand*{\glsxtrbookindexbookmark}[2]{%
+ \ifdefstring{\@@glossarysec}{chapter}%
+ {\pdfbookmark[1]{#1}{#2}}%
+ {\pdfbookmark[2]{#1}{#2}}%
+ }
+}
+{%
+ \newcommand*{\glsxtrbookindexbookmark}[2]{}
+}
+\newcommand*{\glsxtrbookindexbookmarkprefix}{\currentglossary.}
+\newcommand*{\glsxtrbookindexcolspread}{}
+\newcommand*{\glsxtrbookindexmulticolsenv}{multicols}
+\newglossarystyle{bookindex}{%
+ \setglossarystyle{index}%
+ \renewenvironment{theglossary}%
+ {%
+ \ifnum\glsxtrbookindexcols>1\relax
+ \ifdefempty\glsxtrbookindexcolspread
+ {%
+ \edef\glsxtr@beginbookindex{%
+ \noexpand\begin{\glsxtrbookindexmulticolsenv}
+ {\glsxtrbookindexcols}%
+ }%
+ }%
+ {%
+ \edef\glsxtr@beginbookindex{%
+ \noexpand\begin{\glsxtrbookindexmulticolsenv}%
+ {\glsxtrbookindexcols}[\glsxtrbookindexcolspread]%
+ }%
+ }%
+ \else
+ \def\glsxtr@beginbookindex{}%
+ \fi
+ \glsxtr@beginbookindex
+ \setlength{\parindent}{0pt}%
+ \setlength{\parskip}{0pt plus 0.3pt}%
+ \let\@glsxtr@bookindex@sep\glsxtrbookindexparentchildsep
+ \let\@glsxtr@bookindex@subsep\glsxtrbookindexparentsubchildsep
+ \let\@glsxtr@bookindex@between\@gobble
+ \let\@glsxtr@bookindex@subbetween\@gobble
+ \let\@glsxtr@bookindex@subsubbetween\@gobble
+ \let\@glsxtr@bookindex@atendgroup\relax
+ \let\@glsxtr@bookindex@subatendgroup\relax
+ \let\@glsxtr@bookindex@subsubatendgroup\relax
+ \let\@glsxtr@bookindexgroupskip\relax
+ }%
+ {%
+ \@glsxtr@bookindex@subsubatendgroup
+ \@glsxtr@bookindex@subatendgroup
+ \@glsxtr@bookindex@atendgroup
+ \ifnum\glsxtrbookindexcols>1\relax
+ \edef\glsxtr@endbookindex{%
+ \noexpand\end{\glsxtrbookindexmulticolsenv}%
+ }%
+ \else
+ \def\glsxtr@endbookindex{}%
+ \fi
+ \glsxtr@endbookindex
+ }%
+ \renewcommand*{\glossaryheader}{\raggedright}%
+ \renewcommand*{\glossentry}[2]{%
+ \@glsxtr@bookindex@between{##1}%
+ \let\@glsxtr@bookindex@sep\glsxtrbookindexparentchildsep
+ \let\@glsxtr@bookindex@subsep\glsxtrbookindexparentsubchildsep
+ \let\@glsxtr@bookindex@subbetween\@gobble
+ \let\@glsxtr@bookindex@subsubbetween\@gobble
+ \edef\@glsxtr@bookindex@between{%
+ \noexpand\glsxtrbookindexbetween{##1}%
+ }%
+ \edef\@glsxtr@bookindex@atendgroup{%
+ \noexpand\glsxtrbookindexatendgroup{##1}%
+ }%
+ \let\@glsxtr@bookindex@subatendgroup\relax
+ \let\@glsxtr@bookindex@subsubatendgroup\relax
+ \glstreeitem
+ \glsentryitem{##1}%
+ \glstarget{##1}{\glsxtrbookindexname{##1}}%
+ \glsxtrbookindexprelocation{##1}%
+ \glsxtrbookindexlocation{##1}{##2}%
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ \ifcase##1\relax
+ \glstreeitem
+ \or
+ \@glsxtr@bookindex@sep
+ \@glsxtr@bookindex@subbetween{##2}%
+ \let\@glsxtr@bookindex@sep\relax
+ \let\@glsxtr@bookindex@subsubbetween\@gobble
+ \let\@glsxtr@bookindex@subsep\glsxtrbookindexparentsubchildsep
+ \edef\@glsxtr@bookindex@subbetween{%
+ \noexpand\glsxtrbookindexsubbetween{##2}%
+ }%
+ \edef\@glsxtr@bookindex@atsubendgroup{%
+ \noexpand\glsxtrbookindexatsubendgroup{##1}%
+ }%
+ \glstreesubitem
+ \glssubentryitem{##2}%
+ \else
+ \@glsxtr@bookindex@subsep
+ \@glsxtr@bookindex@subsubbetween{##2}%
+ \let\@glsxtr@bookindex@subsep\relax
+ \edef\@glsxtr@bookindex@subsubbetween{%
+ \noexpand\glsxtrbookindexsubsubbetween{##2}%
+ }%
+ \edef\@glsxtr@bookindex@atsubsubendgroup{%
+ \noexpand\glsxtrbookindexatsubsubendgroup{##1}%
+ }%
+ \glstreesubsubitem
+ \fi
+ \glstarget{##2}{\glsxtrbookindexsubname{##2}}%
+ \glsxtrbookindexsubprelocation{##2}%
+ \glsxtrbookindexsublocation{##2}{##3}%
+ }%
+ \renewcommand*{\glsgroupskip}{}%
+ \renewcommand*{\glsgroupheading}[1]{%
+ \@glsxtr@bookindex@subsubatendgroup
+ \@glsxtr@bookindex@subatendgroup
+ \@glsxtr@bookindex@atendgroup
+ \@glsxtr@bookindexgroupskip
+ \let\@glsxtr@bookindexgroupskip\glsxtrbookindexgroupskip
+ \let\@glsxtr@bookindex@between\@gobble
+ \let\@glsxtr@bookindex@atendgroup\relax
+ \let\@glsxtr@bookindex@subatendgroup\relax
+ \let\@glsxtr@bookindex@subsubatendgroup\relax
+ \glsxtrgetgrouptitle{##1}{\glsxtrcurrentgrptitle}%
+ \glsxtrbookindexbookmark{\glsxtrcurrentgrptitle}{\glsxtrbookindexbookmarkprefix##1}%
+ \glsxtrbookindexformatheader{\glsxtrcurrentgrptitle}%
+ \nopagebreak\indexspace\nopagebreak\@afterheading
+ }%
+}
+\newcommand{\glsxtrbookindexthepage}{%
+ \ifdef\currentglossary{\currentglossary.\arabic{page}}{\arabic{page}}%
+}
+\newcommand*{\glsxtrbookindexmarkentry}[1]{%
+ \protected@write\@auxout
+ {\let\glsxtrbookindexthepage\relax}%
+ {\string\glsxtr@setbookindexmark{\glsxtrbookindexthepage}{#1}}%
+}
+\newcommand*{\glsxtr@setbookindexmark}[2]{%
+ \ifcsundef{glsxtr@idxfirstmark@#1}%
+ {\csgdef{glsxtr@idxfirstmark@#1}{#2}}%
+ {}%
+ \csgdef{glsxtr@idxlastmark@#1}{#2}%
+}
+\newcommand*{\glsxtrbookindexfirstmarkfmt}[1]{%
+ \glsentryname{#1}%
+}
+\newcommand*{\glsxtrbookindexfirstmark}{%
+ \letcs{\glsxtr@label}{glsxtr@idxfirstmark@\glsxtrbookindexthepage}%
+ \ifdef\glsxtr@label
+ {\glsxtrbookindexfirstmarkfmt{\glsxtr@label}}%
+ {}%
+}
+\newcommand*{\glsxtrbookindexlastmarkfmt}[1]{%
+ \glsentryname{#1}%
+}
+\newcommand*{\glsxtrbookindexlastmark}{%
+ \letcs{\glsxtr@label}{glsxtr@idxlastmark@\glsxtrbookindexthepage}%
+ \ifdef\glsxtr@label
+ {\glsxtrbookindexlastmarkfmt{\glsxtr@label}}%
+ {}%
+}
+% \end{macrocode}
+%\iffalse
+% \begin{macrocode}
+%</glossary-bookindex-2021-11-22.sty>
+% \end{macrocode}
+%\fi
+%\iffalse
+% \begin{macrocode}
+%<*glossary-longextra-2021-11-22.sty>
+% \end{macrocode}
+%\fi
+%\subsection{Rollback v1.48 (glossary-longextra-2021-11-22.sty)}
+% Version 1.48 preserved for rollback.
+% \begin{macrocode}
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{glossary-longextra}[2021/11/22 v1.48 (NLCT)]
+\RequirePackage{glossary-longbooktabs}
+\newcommand{\glslongextraNameFmt}[1]{%
+ \glsentryitem{#1}\glstarget{#1}{\glossentryname{#1}}%
+}
+\newcommand{\glslongextraDescFmt}[1]{%
+ \glossentrydesc{#1}\glspostdescription
+}
+\newcommand{\glslongextraSymbolFmt}[1]{\glossentrysymbol{#1}}
+\newcommand{\glslongextraLocationFmt}[2]{#2}
+\newcommand{\glslongextraSubNameFmt}[2]{%
+ \glssubentryitem{#2}\glstarget{#2}{\strut}%
+}
+\newcommand{\glslongextraSubDescFmt}[2]{%
+ \glslongextraDescFmt{#2}%
+}
+\newcommand{\glslongextraSubSymbolFmt}[2]{%
+ \glslongextraSymbolFmt{#2}%
+}
+\newcommand{\glslongextraSubLocationFmt}[3]{#3}
+\newcommand{\glslongextraNameAlign}{l}
+\newcommand{\glslongextraDescAlign}{>{\raggedright}p{\glsdescwidth}}
+\newcommand{\glslongextraSymbolAlign}{c}
+\newcommand{\glslongextraLocationAlign}{>{\raggedright}p{\glspagelistwidth}}
+\newcommand{\glslongextraGroupHeading}[2]{}
+\newcommand{\glslongextraHeaderFmt}[1]{\textbf{#1}}
+\newcommand{\glslongextraNameDescHeader}{%
+ \glslongextraNameDescTabularHeader\endhead
+ \glslongextraNameDescTabularFooter\endfoot
+}
+\newcommand{\glslongextraNameDescTabularHeader}{%
+ \toprule
+ \glslongextraHeaderFmt\entryname &
+ \glslongextraHeaderFmt\descriptionname\tabularnewline
+ \midrule
+}
+\newcommand{\glslongextraNameDescTabularFooter}{%
+ \bottomrule
+}
+\newcommand*{\glslongextraSetWidest}[1]{%
+ \def\@glslongextrawidestname{#1}%
+}
+\newcommand*{\@glslongextrawidestname}{\csuse{@glswidestname}}
+\newcommand*{\glslongextraUpdateWidest}[1]{%
+ \ifundef\@glslongextrawidestname
+ {\def\@glslongextrawidestname{#1}}%
+ {%
+ \settowidth{\dimen@}{\@glslongextrawidestname}%
+ \settowidth{\dimen@ii}{#1}%
+ \ifdim\dimen@ii>\dimen@
+ \def\@glslongextrawidestname{#1}%
+ \fi
+ }%
+}
+\newcommand*{\glslongextraUpdateWidestChild}[2]{}
+\newcommand{\glslongextraSetDescWidth}{%
+ \settowidth{\gls@tmplen}{\glslongextraHeaderFmt\entryname}%
+ \settowidth{\dimen@}{\glsnamefont{\@glslongextrawidestname}}%
+ \ifdim\dimen@>\gls@tmplen
+ \gls@tmplen=\dimen@
+ \fi
+ \setlength{\glsdescwidth}{\dimexpr\linewidth-4\tabcolsep-\gls@tmplen}%
+}
+\newcommand{\glslongextraSymSetDescWidth}{%
+ \glslongextraSetDescWidth
+ \settowidth{\gls@tmplen}{\glslongextraHeaderFmt\symbolname}%
+ \setlength{\glsdescwidth}{\dimexpr\glsdescwidth-2\tabcolsep-\gls@tmplen}%
+}
+\newcommand{\glslongextraLocSetDescWidth}{%
+ \glslongextraSetDescWidth
+ \setlength{\glsdescwidth}{\dimexpr\glsdescwidth-2\tabcolsep-\glspagelistwidth}%
+}
+\newcommand{\glslongextraSymLocSetDescWidth}{%
+ \glslongextraSymSetDescWidth
+ \setlength{\glsdescwidth}{\dimexpr\glsdescwidth-2\tabcolsep-\glspagelistwidth}%
+}
+\newif\ifGlsLongExtraUseTabular
+\GlsLongExtraUseTabularfalse
+\newcommand*{\glslongextraTabularVAlign}{c}
+\newglossarystyle{long-name-desc}%
+{%
+ \ifGlsLongExtraUseTabular
+ \renewenvironment{theglossary}%
+ {%
+ \glslongextraSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{tabular}[\glslongextraTabularVAlign]{%
+ \expandonce\glslongextraNameAlign
+ \expandonce\glslongextraDescAlign}}%
+ \@glslongextra@begintab
+ }%
+ {%
+ \glslongextraNameDescTabularFooter
+ \end{tabular}%
+ }%
+ \renewcommand*{\glossaryheader}{\glslongextraNameDescTabularHeader}%
+ \else
+ \renewenvironment{theglossary}%
+ {%
+ \glspatchLToutput
+ \glslongextraSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{longtable}{%
+ \expandonce\glslongextraNameAlign
+ \expandonce\glslongextraDescAlign}}%
+ \@glslongextra@begintab
+ }%
+ {\end{longtable}}%
+ \renewcommand*{\glossaryheader}{\glslongextraNameDescHeader}%
+ \fi
+ \renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{2}{##1}}%
+ \renewcommand{\glossentry}[2]{%
+ \glslongextraNameFmt{##1} &
+ \glslongextraDescFmt{##1}\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ \glslongextraSubNameFmt{##1}{##2}
+ &
+ \glslongextraSubDescFmt{##1}{##2}%
+ \tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{\glspenaltygroupskip}%
+ \fi
+}
+\newcommand{\glslongextraNameDescLocationHeader}{%
+ \glslongextraNameDescLocationTabularHeader\endhead
+ \glslongextraNameDescLocationTabularFooter\endfoot
+}
+\newcommand{\glslongextraNameDescLocationTabularHeader}{%
+ \toprule
+ \glslongextraHeaderFmt\entryname &
+ \glslongextraHeaderFmt\descriptionname &
+ \glslongextraHeaderFmt\pagelistname\tabularnewline
+ \midrule
+}
+\newcommand{\glslongextraNameDescLocationTabularFooter}{%
+ \bottomrule
+}
+\newglossarystyle{long-name-desc-loc}%
+{%
+ \ifGlsLongExtraUseTabular
+ \renewenvironment{theglossary}%
+ {%
+ \glslongextraLocSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{tabular}[\glslongextraTabularVAlign]{%
+ \expandonce\glslongextraNameAlign
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraLocationAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {%
+ \glslongextraNameDescLocationTabularFooter
+ \end{tabular}%
+ }%
+ \renewcommand*{\glossaryheader}{\glslongextraNameDescLocationTabularHeader}%
+ \else
+ \renewenvironment{theglossary}%
+ {%
+ \glspatchLToutput
+ \glslongextraLocSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{longtable}{%
+ \expandonce\glslongextraNameAlign
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraLocationAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {\end{longtable}}%
+ \renewcommand*{\glossaryheader}{\glslongextraNameDescLocationHeader}%
+ \fi
+ \renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{3}{##1}}%
+ \renewcommand{\glossentry}[2]{%
+ \glslongextraNameFmt{##1} &
+ \glslongextraDescFmt{##1} &
+ \glslongextraLocationFmt{##1}{##2}\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ \glslongextraSubNameFmt{##1}{##2}&
+ \glslongextraSubDescFmt{##1}{##2}&
+ \glslongextraSubLocationFmt{##1}{##2}{##3}%
+ \tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{\glspenaltygroupskip}%
+ \fi
+}
+\newcommand{\glslongextraDescNameHeader}{%
+ \glslongextraDescNameTabularHeader\endhead
+ \glslongextraDescNameTabularFooter\endfoot
+}
+\newcommand{\glslongextraDescNameTabularHeader}{%
+ \toprule
+ \glslongextraHeaderFmt\descriptionname&
+ \glslongextraHeaderFmt\entryname \tabularnewline
+ \midrule
+}
+\newcommand{\glslongextraDescNameTabularFooter}{%
+ \bottomrule
+}
+\newglossarystyle{long-desc-name}%
+{%
+ \ifGlsLongExtraUseTabular
+ \renewenvironment{theglossary}%
+ {%
+ \glslongextraSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{tabular}[\glslongextraTabularVAlign]{%
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraNameAlign}}%
+ \@glslongextra@begintab
+ }%
+ {%
+ \glslongextraDescNameTabularFooter
+ \end{tabular}%
+ }%
+ \renewcommand*{\glossaryheader}{\glslongextraDescNameTabularHeader}%
+ \else
+ \renewenvironment{theglossary}%
+ {%
+ \glspatchLToutput
+ \glslongextraSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{longtable}{%
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraNameAlign}}%
+ \@glslongextra@begintab
+ }%
+ {\end{longtable}}%
+ \renewcommand*{\glossaryheader}{\glslongextraDescNameHeader}%
+ \fi
+ \renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{2}{##1}}%
+ \renewcommand{\glossentry}[2]{%
+ \glslongextraDescFmt{##1} &
+ \glslongextraNameFmt{##1}\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ \glslongextraSubDescFmt{##1}{##2} &
+ \glslongextraSubNameFmt{##1}{##2}\tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{\glspenaltygroupskip}%
+ \fi
+}
+\newcommand{\glslongextraLocationDescNameHeader}{%
+ \glslongextraLocationDescNameTabularHeader\endhead
+ \glslongextraLocationDescNameTabularFooter\endfoot
+}
+\newcommand{\glslongextraLocationDescNameTabularHeader}{%
+ \toprule
+ \glslongextraHeaderFmt\pagelistname&
+ \glslongextraHeaderFmt\descriptionname&
+ \glslongextraHeaderFmt\entryname \tabularnewline
+ \midrule
+}
+\newcommand{\glslongextraLocationDescNameTabularFooter}{%
+ \bottomrule
+}
+\newglossarystyle{long-loc-desc-name}%
+{%
+ \ifGlsLongExtraUseTabular
+ {%
+ \glslongextraLocSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{tabular}[\glslongextraTabularVAlign]{%
+ \expandonce\glslongextraLocationAlign
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraNameAlign}}%
+ \@glslongextra@begintab
+ }%
+ {%
+ \glslongextraLocationDescNameTabularFooter
+ \end{tabular}%
+ }%
+ \renewcommand*{\glossaryheader}{\glslongextraLocationDescNameTabularHeader}%
+ \else
+ \renewenvironment{theglossary}%
+ {%
+ \glspatchLToutput
+ \glslongextraLocSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{longtable}{%
+ \expandonce\glslongextraLocationAlign
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraNameAlign}}%
+ \@glslongextra@begintab
+ }%
+ {\end{longtable}}%
+ \renewcommand*{\glossaryheader}{\glslongextraLocationDescNameHeader}%
+ \fi
+ \renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{3}{##1}}%
+ \renewcommand{\glossentry}[2]{%
+ \glslongextraLocationFmt{##1}{##2} &
+ \glslongextraDescFmt{##1} &
+ \glslongextraNameFmt{##1}\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ \glslongextraSubLocationFmt{##1}{##2}{##3} &
+ \glslongextraSubDescFmt{##1}{##2} &
+ \glslongextraSubNameFmt{##1}{##2}\tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{\glspenaltygroupskip}%
+ \fi
+}
+\newcommand{\glslongextraNameDescSymHeader}{%
+ \glslongextraNameDescSymTabularHeader\endhead
+ \glslongextraNameDescSymTabularFooter\endfoot
+}
+\newcommand{\glslongextraNameDescSymTabularHeader}{%
+ \toprule
+ \glslongextraHeaderFmt\entryname &
+ \glslongextraHeaderFmt\descriptionname &
+ \glslongextraHeaderFmt\symbolname\tabularnewline
+ \midrule
+}
+\newcommand{\glslongextraNameDescSymTabularFooter}{%
+ \bottomrule
+}
+\newglossarystyle{long-name-desc-sym}%
+{%
+ \ifGlsLongExtraUseTabular
+ \renewenvironment{theglossary}%
+ {%
+ \glslongextraSymSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{tabular}[\glslongextraTabularVAlign]{%
+ \expandonce\glslongextraNameAlign
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraSymbolAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {%
+ \glslongextraNameDescSymTabularFooter
+ \end{tabular}%
+ }%
+ \renewcommand*{\glossaryheader}{\glslongextraNameDescSymTabularHeader}%
+ \else
+ \renewenvironment{theglossary}%
+ {%
+ \glspatchLToutput
+ \glslongextraSymSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{longtable}{%
+ \expandonce\glslongextraNameAlign
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraSymbolAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {\end{longtable}}%
+ \renewcommand*{\glossaryheader}{\glslongextraNameDescSymHeader}%
+ \fi
+ \renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{3}{##1}}%
+ \renewcommand{\glossentry}[2]{%
+ \glslongextraNameFmt{##1} &
+ \glslongextraDescFmt{##1} &
+ \glslongextraSymbolFmt{##1}\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ \glslongextraSubNameFmt{##1}{##2} &
+ \glslongextraSubDescFmt{##1}{##2} &
+ \glslongextraSubSymbolFmt{##1}{##2}%
+ \tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{\glspenaltygroupskip}%
+ \fi
+}
+\newcommand{\glslongextraNameDescSymLocationHeader}{%
+ \glslongextraNameDescSymLocationTabularHeader\endhead
+ \glslongextraNameDescSymLocationTabularFooter\endfoot
+}
+\newcommand{\glslongextraNameDescSymLocationTabularHeader}{%
+ \toprule
+ \glslongextraHeaderFmt\entryname &
+ \glslongextraHeaderFmt\descriptionname &
+ \glslongextraHeaderFmt\symbolname &
+ \glslongextraHeaderFmt\pagelistname\tabularnewline
+ \midrule
+}
+\newcommand{\glslongextraNameDescSymLocationTabularFooter}{%
+ \bottomrule
+}
+\newglossarystyle{long-name-desc-sym-loc}%
+{%
+ \ifGlsLongExtraUseTabular
+ \renewenvironment{theglossary}%
+ {%
+ \glslongextraSymLocSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{tabular}[\glslongextraTabularVAlign]{%
+ \expandonce\glslongextraNameAlign
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraSymbolAlign
+ \expandonce\glslongextraLocationAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {%
+ \glslongextraNameDescSymLocationTabularFooter
+ \end{tabular}%
+ }%
+ \renewcommand*{\glossaryheader}{\glslongextraNameDescSymLocationTabularHeader}%
+ \else
+ \renewenvironment{theglossary}%
+ {%
+ \glspatchLToutput
+ \glslongextraSymLocSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{longtable}{%
+ \expandonce\glslongextraNameAlign
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraSymbolAlign
+ \expandonce\glslongextraLocationAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {\end{longtable}}%
+ \renewcommand*{\glossaryheader}{\glslongextraNameDescSymLocationHeader}%
+ \fi
+ \renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{4}{##1}}%
+ \renewcommand{\glossentry}[2]{%
+ \glslongextraNameFmt{##1} &
+ \glslongextraDescFmt{##1} &
+ \glslongextraSymbolFmt{##1}&
+ \glslongextraLocationFmt{##1}{##2}\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ \glslongextraSubNameFmt{##1}{##2} &
+ \glslongextraSubDescFmt{##1}{##2} &
+ \glslongextraSubSymbolFmt{##1}{##2}&
+ \glslongextraSubLocationFmt{##1}{##2}{##3}%
+ \tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{\glspenaltygroupskip}%
+ \fi
+}
+\newcommand{\glslongextraNameSymDescHeader}{%
+ \glslongextraNameSymDescTabularHeader\endhead
+ \glslongextraNameSymDescTabularFooter\endfoot
+}
+\newcommand{\glslongextraNameSymDescTabularHeader}{%
+ \toprule
+ \glslongextraHeaderFmt\entryname &
+ \glslongextraHeaderFmt\symbolname &
+ \glslongextraHeaderFmt\descriptionname\tabularnewline
+ \midrule
+}
+\newcommand{\glslongextraNameSymDescTabularFooter}{%
+ \bottomrule
+}
+\newglossarystyle{long-name-sym-desc}%
+{%
+ \ifGlsLongExtraUseTabular
+ \renewenvironment{theglossary}%
+ {%
+ \glslongextraSymSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{tabular}[\glslongextraTabularVAlign]{%
+ \expandonce\glslongextraNameAlign
+ \expandonce\glslongextraSymbolAlign
+ \expandonce\glslongextraDescAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {%
+ \glslongextraNameSymDescTabularFooter
+ \end{tabular}%
+ }%
+ \renewcommand*{\glossaryheader}{\glslongextraNameSymDescTabularHeader}%
+ \else
+ \renewenvironment{theglossary}%
+ {%
+ \glspatchLToutput
+ \glslongextraSymSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{longtable}{%
+ \expandonce\glslongextraNameAlign
+ \expandonce\glslongextraSymbolAlign
+ \expandonce\glslongextraDescAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {\end{longtable}}%
+ \renewcommand*{\glossaryheader}{\glslongextraNameSymDescHeader}%
+ \fi
+ \renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{3}{##1}}%
+ \renewcommand{\glossentry}[2]{%
+ \glslongextraNameFmt{##1} &
+ \glslongextraSymbolFmt{##1} &
+ \glslongextraDescFmt{##1}\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ \glslongextraSubNameFmt{##1}{##2} &
+ \glslongextraSubSymbolFmt{##1}{##2} &
+ \glslongextraSubDescFmt{##1}{##2}\tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{\glspenaltygroupskip}%
+ \fi
+}
+\newcommand{\glslongextraNameSymDescLocationHeader}{%
+ \glslongextraNameSymDescLocationTabularHeader\endhead
+ \glslongextraNameSymDescLocationTabularFooter\endfoot
+}
+\newcommand{\glslongextraNameSymDescLocationTabularHeader}{%
+ \toprule
+ \glslongextraHeaderFmt\entryname &
+ \glslongextraHeaderFmt\symbolname &
+ \glslongextraHeaderFmt\descriptionname &
+ \glslongextraHeaderFmt\pagelistname\tabularnewline
+ \midrule
+}
+\newcommand{\glslongextraNameSymDescLocationTabularFooter}{%
+ \bottomrule
+}
+\newglossarystyle{long-name-sym-desc-loc}%
+{%
+ \ifGlsLongExtraUseTabular
+ \renewenvironment{theglossary}%
+ {%
+ \glslongextraSymLocSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{tabular}[\glslongextraTabularVAlign]{%
+ \expandonce\glslongextraNameAlign
+ \expandonce\glslongextraSymbolAlign
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraLocationAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {%
+ \glslongextraNameSymDescLocationTabularFooter
+ \end{tabular}%
+ }%
+ \renewcommand*{\glossaryheader}{\glslongextraNameSymDescLocationTabularHeader}%
+ \else
+ \renewenvironment{theglossary}%
+ {%
+ \glspatchLToutput
+ \glslongextraSymLocSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{longtable}{%
+ \expandonce\glslongextraNameAlign
+ \expandonce\glslongextraSymbolAlign
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraLocationAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {\end{longtable}}%
+ \renewcommand*{\glossaryheader}{\glslongextraNameSymDescLocationHeader}%
+ \fi
+ \renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{4}{##1}}%
+ \renewcommand{\glossentry}[2]{%
+ \glslongextraNameFmt{##1} &
+ \glslongextraSymbolFmt{##1} &
+ \glslongextraDescFmt{##1} &
+ \glslongextraLocationFmt{##1}{##2}\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ \glslongextraSubNameFmt{##1}{##2} &
+ \glslongextraSubSymbolFmt{##1}{##2} &
+ \glslongextraSubDescFmt{##1}{##2} &
+ \glslongextraSubLocationFmt{##1}{##2}{##3}\tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{\glspenaltygroupskip}%
+ \fi
+}
+\newcommand{\glslongextraSymDescNameHeader}{%
+ \glslongextraSymDescNameTabularHeader\endhead
+ \glslongextraSymDescNameTabularFooter\endfoot
+}
+\newcommand{\glslongextraSymDescNameTabularHeader}{%
+ \toprule
+ \glslongextraHeaderFmt\symbolname &
+ \glslongextraHeaderFmt\descriptionname &
+ \glslongextraHeaderFmt\entryname\tabularnewline
+ \midrule
+}
+\newcommand{\glslongextraSymDescNameTabularFooter}{%
+ \bottomrule
+}
+\newglossarystyle{long-sym-desc-name}%
+{%
+ \ifGlsLongExtraUseTabular
+ \renewenvironment{theglossary}%
+ {%
+ \glslongextraSymSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{tabular}[\glslongextraTabularVAlign]{%
+ \expandonce\glslongextraSymbolAlign
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraNameAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {%
+ \glslongextraSymDescNameTabularFooter
+ \end{tabular}%
+ }%
+ \renewcommand*{\glossaryheader}{\glslongextraSymDescNameTabularHeader}%
+ \else
+ \renewenvironment{theglossary}%
+ {%
+ \glspatchLToutput
+ \glslongextraSymSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{longtable}{%
+ \expandonce\glslongextraSymbolAlign
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraNameAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {\end{longtable}}%
+ \renewcommand*{\glossaryheader}{\glslongextraSymDescNameHeader}%
+ \fi
+ \renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{3}{##1}}%
+ \renewcommand{\glossentry}[2]{%
+ \glslongextraSymbolFmt{##1} &
+ \glslongextraDescFmt{##1} &
+ \glslongextraNameFmt{##1}\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ \glslongextraSubSymbolFmt{##1}{##2} &
+ \glslongextraSubDescFmt{##1}{##2} &
+ \glslongextraSubNameFmt{##1}{##2}\tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{\glspenaltygroupskip}%
+ \fi
+}
+\newcommand{\glslongextraLocationSymDescNameHeader}{%
+ \glslongextraLocationSymDescNameTabularHeader\endhead
+ \glslongextraLocationSymDescNameTabularFooter\endfoot
+}
+\newcommand{\glslongextraLocationSymDescNameTabularHeader}{%
+ \toprule
+ \glslongextraHeaderFmt\pagelistname &
+ \glslongextraHeaderFmt\symbolname &
+ \glslongextraHeaderFmt\descriptionname &
+ \glslongextraHeaderFmt\entryname\tabularnewline
+ \midrule
+}
+\newcommand{\glslongextraLocationSymDescNameTabularFooter}{%
+ \bottomrule
+}
+\newglossarystyle{long-loc-sym-desc-name}%
+{%
+ \ifGlsLongExtraUseTabular
+ \renewenvironment{theglossary}%
+ {%
+ \glslongextraSymLocSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{tabular}[\glslongextraTabularVAlign]{%
+ \expandonce\glslongextraLocationAlign
+ \expandonce\glslongextraSymbolAlign
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraNameAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {%
+ \glslongextraLocationSymDescNameTabularFooter
+ \end{tabular}%
+ }%
+ \renewcommand*{\glossaryheader}{\glslongextraLocationSymDescNameTabularHeader}%
+ \else
+ \renewenvironment{theglossary}%
+ {%
+ \glspatchLToutput
+ \glslongextraSymLocSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{longtable}{%
+ \expandonce\glslongextraLocationAlign
+ \expandonce\glslongextraSymbolAlign
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraNameAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {\end{longtable}}%
+ \renewcommand*{\glossaryheader}{\glslongextraLocationSymDescNameHeader}%
+ \fi
+ \renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{4}{##1}}%
+ \renewcommand{\glossentry}[2]{%
+ \glslongextraLocationFmt{##1}{##2} &
+ \glslongextraSymbolFmt{##1} &
+ \glslongextraDescFmt{##1} &
+ \glslongextraNameFmt{##1}\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ \glslongextraSubLocationFmt{##1}{##2}{##3} &
+ \glslongextraSubSymbolFmt{##1}{##2} &
+ \glslongextraSubDescFmt{##1}{##2} &
+ \glslongextraSubNameFmt{##1}{##2}\tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{\glspenaltygroupskip}%
+ \fi
+}
+\newcommand{\glslongextraDescSymNameHeader}{%
+ \glslongextraDescSymNameTabularHeader\endhead
+ \glslongextraDescSymNameTabularFooter\endfoot
+}
+\newcommand{\glslongextraDescSymNameTabularHeader}{%
+ \toprule
+ \glslongextraHeaderFmt\descriptionname &
+ \glslongextraHeaderFmt\symbolname &
+ \glslongextraHeaderFmt\entryname\tabularnewline
+ \midrule
+}
+\newcommand{\glslongextraDescSymNameTabularFooter}{%
+ \bottomrule
+}
+\newglossarystyle{long-desc-sym-name}%
+{%
+ \ifGlsLongExtraUseTabular
+ \renewenvironment{theglossary}%
+ {%
+ \glslongextraSymSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{tabular}[\glslongextraTabularVAlign]{%
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraSymbolAlign
+ \expandonce\glslongextraNameAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {%
+ \glslongextraDescSymNameTabularFooter
+ \end{tabular}%
+ }%
+ \renewcommand*{\glossaryheader}{\glslongextraDescSymNameTabularHeader}%
+ \else
+ \renewenvironment{theglossary}%
+ {%
+ \glspatchLToutput
+ \glslongextraSymSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{longtable}{%
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraSymbolAlign
+ \expandonce\glslongextraNameAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {\end{longtable}}%
+ \renewcommand*{\glossaryheader}{\glslongextraDescSymNameHeader}%
+ \fi
+ \renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{3}{##1}}%
+ \renewcommand{\glossentry}[2]{%
+ \glslongextraDescFmt{##1} &
+ \glslongextraSymbolFmt{##1} &
+ \glslongextraNameFmt{##1}\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ \glslongextraSubDescFmt{##1}{##2} &
+ \glslongextraSubSymbolFmt{##1}{##2} &
+ \glslongextraSubNameFmt{##1}{##2}\tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{\glspenaltygroupskip}%
+ \fi
+}
+\newcommand{\glslongextraLocationDescSymNameHeader}{%
+ \glslongextraLocationDescSymNameTabularHeader\endhead
+ \glslongextraLocationDescSymNameTabularFooter\endfoot
+}
+\newcommand{\glslongextraLocationDescSymNameTabularHeader}{%
+ \toprule
+ \glslongextraHeaderFmt\pagelistname &
+ \glslongextraHeaderFmt\descriptionname &
+ \glslongextraHeaderFmt\symbolname &
+ \glslongextraHeaderFmt\entryname\tabularnewline
+ \midrule
+}
+\newcommand{\glslongextraLocationDescSymNameTabularFooter}{%
+ \bottomrule
+}
+\newglossarystyle{long-loc-desc-sym-name}%
+{%
+ \ifGlsLongExtraUseTabular
+ \renewenvironment{theglossary}%
+ {%
+ \glslongextraSymLocSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{tabular}[\glslongextraTabularVAlign]{%
+ \expandonce\glslongextraLocationAlign
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraSymbolAlign
+ \expandonce\glslongextraNameAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {%
+ \glslongextraLocationDescSymNameTabularFooter
+ \end{tabular}%
+ }%
+ \renewcommand*{\glossaryheader}{\glslongextraLocationDescSymNameTabularHeader}%
+ \else
+ \renewenvironment{theglossary}%
+ {%
+ \glspatchLToutput
+ \glslongextraSymLocSetDescWidth
+ \edef\@glslongextra@begintab{%
+ \noexpand\begin{longtable}{%
+ \expandonce\glslongextraLocationAlign
+ \expandonce\glslongextraDescAlign
+ \expandonce\glslongextraSymbolAlign
+ \expandonce\glslongextraNameAlign
+ }}%
+ \@glslongextra@begintab
+ }%
+ {\end{longtable}}%
+ \renewcommand*{\glossaryheader}{\glslongextraLocationDescSymNameHeader}%
+ \fi
+ \renewcommand*{\glsgroupheading}[1]{\glslongextraGroupHeading{4}{##1}}%
+ \renewcommand{\glossentry}[2]{%
+ \glslongextraLocationFmt{##1}{##2} &
+ \glslongextraDescFmt{##1} &
+ \glslongextraSymbolFmt{##1} &
+ \glslongextraNameFmt{##1}\tabularnewline
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ \glslongextraSubLocationFmt{##1}{##2}{##3} &
+ \glslongextraSubDescFmt{##1}{##2} &
+ \glslongextraSubSymbolFmt{##1}{##2} &
+ \glslongextraSubNameFmt{##1}{##2}\tabularnewline
+ }%
+ \ifglsnogroupskip
+ \renewcommand*{\glsgroupskip}{}%
+ \else
+ \renewcommand*{\glsgroupskip}{\glspenaltygroupskip}%
+ \fi
+}
+% \end{macrocode}
+%\iffalse
+% \begin{macrocode}
+%</glossary-longextra-2021-11-22.sty>
+% \end{macrocode}
+%\fi
+%\iffalse
+% \begin{macrocode}
+%<*glossary-topic-2021-11-22.sty>
+% \end{macrocode}
+%\fi
+%\subsection{Rollback v1.48 (glossary-topic-2021-11-22.sty)}
+% Version 1.48 preserved for rollback.
+% \begin{macrocode}
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{glossary-topic}[2021/11/22 v1.48 (NLCT)]
+\RequirePackage{multicol}
+\newglossarystyle{topic}{%
+ \renewenvironment{theglossary}%
+ {%
+ \glstopicInit
+ \def\glstopic@prechildren{}%
+ \def\glstopic@prevlevel{-1}%
+ }%
+ {\par}%
+ \renewcommand*{\glossaryheader}{}%
+ \renewcommand*{\glsgroupheading}[1]{%
+ \def\glstopic@prevlevel{-1}%
+ \glstopicGroupHeading{##1}%
+ }%
+ \renewcommand{\glossentry}[2]{%
+ \hangindent0pt\relax
+ \parindent\glstopicParIndent\relax
+ \glstopicItem{##1}{##2}%
+ \ifglshasdesc{##1}%
+ {%
+ \def\glstopic@prechildren{}%
+ }%
+ {%
+ \def\glstopic@prechildren{\nopagebreak}%
+ }%
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ \ifnum\glstopic@prevlevel=0\relax\glstopic@prechildren\fi
+ \def\glstopic@prevlevel{##1}%
+ \begingroup
+ \glstopicAssignSubIndent{##1}%
+ \glstopicSubItem{##1}{##2}{##3}%
+ \par
+ \endgroup
+ }%
+ \renewcommand*{\glsgroupskip}{}%
+}
+\newcommand*{\glstopicGroupHeading}[1]{}
+\newcommand*{\glstopicItem}[2]{%
+ \glspar\glstopicPreSkip\glspar\noindent
+ \glstopicMarker{#1}%
+ \glstopicTitleFont
+ {%
+ \glsentryitem{#1}\glstarget{#1}{\glstopicTitle{#1}}%
+ }%
+ \ifglshasdesc{#1}%
+ {\glspar\nobreak\glstopicMidSkip\glspar\nobreak
+ \@afterheading\glstopicDesc{#1}\glspar\glstopicPostSkip}%
+ {\glspar\nobreak\glstopicPostSkip}%
+ \glstopicLoc{#1}{#2}%
+}
+\newcommand*{\glstopicMarker}[1]{}
+\newcommand*{\glstopicTitle}[1]{\Glossentryname{#1}%
+ \ifglshassymbol{#1}{\space(\glossentrysymbol{#1})}{}%
+}
+\newcommand*{\glstopicTitleFont}[1]{\textbf{\large #1}}
+\newcommand*{\glstopicDesc}[1]{\Glossentrydesc{#1}\glspostdescription}
+\newcommand*{\glstopicLoc}[2]{}
+\newlength\glstopicParIndent
+\setlength\glstopicParIndent{20pt}
+\newlength\glstopicSubIndent
+\setlength\glstopicSubIndent{20pt}
+\newcommand{\glstopicInit}{}
+\newcommand*{\glstopicAssignSubIndent}[1]{%
+ \par
+ \parindent\dimexpr#1\glstopicSubIndent-\glstopicSubIndent\relax
+ \glstopicAssignWidest{#1}%
+ \glstopicsubitemhangindent=\dimexpr\parindent+\glstopicwidest\relax
+ \hangindent\glstopicsubitemhangindent\relax
+ \everypar{\hangindent\glstopicsubitemhangindent\relax
+ \parindent\dimexpr\glstopicSubItemParIndent+\glstopicsubitemhangindent\relax}%
+}
+\newlength\glstopicsubitemhangindent
+\newlength\glstopicSubItemParIndent
+\glstopicSubItemParIndent\parindent
+\newlength\glstopicwidest
+\newcommand*{\glstopicAssignWidest}[1]{%
+ \ifcsundef{@glswidestlength\romannumeral#1}%
+ {%
+ \ifcsdef{@glswidestname\romannumeral#1}%
+ {%
+ \settowidth{\glstopicwidest}{%
+ \glstopicSubNameFont{\csuse{@glswidestname\romannumeral#1}}%
+ \glstopicSubItemSep
+ }%
+ }%
+ {\setlength{\glstopicwidest}{0pt}}%
+ \csedef{@glswidestlength\romannumeral#1}{\the\glstopicwidest}%
+ }%
+ {\setlength{\glstopicwidest}{\csuse{@glswidestlength\romannumeral#1}}}%
+}
+\newcommand*{\glstopicPreSkip}{\medskip}
+\newcommand*{\glstopicMidSkip}{\smallskip}
+\newcommand*{\glstopicPostSkip}{\smallskip}
+\newcommand*{\glstopicSubItem}[3]{%
+ \glstopicSubItemBox{#1}{\glstopicSubNameFont{\glsentryitem{#2}%
+ \glstarget{#2}{\glossentryname{#2}}}%
+ \glstopicSubItemSep
+ }%
+ \ifglshassymbol{#2}{(\glossentrysymbol{#2})\space}{}%
+ \ifglshasdesc{#2}%
+ {\glossentrydesc{#2}\glspostdescription\glstopicSubPreLocSep}{}%
+ \glstopicSubLoc{#2}{#3}%
+}
+\newcommand*{\glstopicSubItemSep}{\quad}
+\newcommand*{\glstopicSubItemBox}[2]{%
+ \ifdim\glstopicwidest>0pt\relax\makebox[\glstopicwidest][l]{#2}\else#2\fi
+}
+\newcommand*{\glstopicSubNameFont}[1]{\textbf{#1}}
+\newcommand*{\glstopicSubPreLocSep}{\space}
+\newcommand*{\glstopicSubLoc}[2]{#2}
+\newcommand*{\glstopicCols}{2}
+\newcommand*{\glstopicColsEnv}{multicols}
+\newglossarystyle{topicmcols}{%
+ \renewenvironment{theglossary}%
+ {%
+ \glstopicInit
+ \def\glstopic@prechildren{}%
+ \def\glstopic@postchildren{}%
+ \def\glstopic@prevlevel{-1}%
+ }%
+ {%
+ \ifnum\glstopic@prevlevel>0\relax\glstopic@postchildren\fi
+ \par
+ }%
+ \renewcommand*{\glossaryheader}{}%
+ \renewcommand*{\glsgroupheading}[1]{%
+ \ifnum\glstopic@prevlevel>0\relax\glstopic@postchildren\fi
+ \def\glstopic@prevlevel{-1}%
+ \glstopicGroupHeading{##1}%
+ }%
+ \renewcommand{\glossentry}[2]{%
+ \ifnum\glstopic@prevlevel>0\relax\glstopic@postchildren\fi
+ \def\glstopic@prevlevel{0}%
+ \hangindent0pt\relax
+ \parindent\glstopicParIndent\relax
+ \glstopicItem{##1}{##2}%
+ \ifnum\glstopicCols>1\relax
+ \ifglshasdesc{##1}%
+ {%
+ \edef\glstopic@prechildren{%
+ \noexpand\begin{\glstopicColsEnv}{\glstopicCols}%
+ }%
+ }%
+ {%
+ \edef\glstopic@prechildren{%
+ \noexpand\nopagebreak
+ \noexpand\begin{\glstopicColsEnv}{\glstopicCols}%
+ }%
+ }%
+ \edef\glstopic@postchildren{\noexpand\end{\glstopicColsEnv}}%
+ \fi
+ }%
+ \renewcommand{\subglossentry}[3]{%
+ \ifnum\glstopic@prevlevel=0\relax\glstopic@prechildren\fi
+ \def\glstopic@prevlevel{##1}%
+ \glstopicAssignSubIndent{##1}%
+ \glstopicSubItem{##1}{##2}{##3}%
+ }%
+ \renewcommand*{\glsgroupskip}{}%
+}
+% \end{macrocode}
+%\iffalse
+% \begin{macrocode}
+%</glossary-topic-2021-11-22.sty>
+% \end{macrocode}
+%\fi
%\Finale
\endinput
diff --git a/macros/latex/contrib/glossaries-extra/glossaries-extra.ins b/macros/latex/contrib/glossaries-extra/glossaries-extra.ins
index 5e8b9d804d..de3e13d48b 100644
--- a/macros/latex/contrib/glossaries-extra/glossaries-extra.ins
+++ b/macros/latex/contrib/glossaries-extra/glossaries-extra.ins
@@ -1,10 +1,10 @@
-% glossaries-extra.ins generated using makedtx version 1.2 2021/11/22 21:22
+% glossaries-extra.ins generated using makedtx version 1.2 2022/10/19 17:47
\input docstrip
\preamble
glossaries-extra.dtx
- Copyright 2021 Nicola Talbot
+ Copyright 2022 Nicola Talbot
This work may be distributed and/or modified under the
conditions of the LaTeX Project Public License, either version 1.3
@@ -18,7 +18,7 @@
The Current Maintainer of this work is Nicola Talbot.
- This work consists of the files glossaries-extra.dtx and glossaries-extra.ins and the derived files glossaries-extra.sty, glossaries-extra-bib2gls.sty, glossaries-extra-stylemods.sty, glossary-bookindex.sty, glossary-longextra.sty, glossary-topic.sty, example-glossaries-xr.tex, example-glossaries-acronym-desc.bib, example-glossaries-acronym.bib, example-glossaries-acronyms-lang.bib, example-glossaries-brief.bib, example-glossaries-childmultipar.bib, example-glossaries-childnoname.bib, example-glossaries-cite.bib, example-glossaries-images.bib, example-glossaries-long.bib, example-glossaries-longchild.bib, example-glossaries-multipar.bib, example-glossaries-parent.bib, example-glossaries-symbolnames.bib, example-glossaries-symbols.bib, example-glossaries-url.bib, example-glossaries-xr.bib.
+ This work consists of the files glossaries-extra.dtx and glossaries-extra.ins and the derived files glossaries-extra.sty, glossaries-extra-abbrstyles.def, glossaries-extra-bib2gls.sty, glossaries-extra-stylemods.sty, glossary-bookindex.sty, glossary-longextra.sty, glossary-topic.sty, glossary-table.sty, example-glossaries-xr.tex, example-glossaries-acronym-desc.bib, example-glossaries-acronym.bib, example-glossaries-acronyms-lang.bib, example-glossaries-brief.bib, example-glossaries-childmultipar.bib, example-glossaries-childnoname.bib, example-glossaries-cite.bib, example-glossaries-images.bib, example-glossaries-long.bib, example-glossaries-longchild.bib, example-glossaries-multipar.bib, example-glossaries-parent.bib, example-glossaries-symbolnames.bib, example-glossaries-symbols.bib, example-glossaries-url.bib, example-glossaries-xr.bib, glossaries-extra-2021-11-22.sty, glossaries-extra-bib2gls-2021-11-22.sty, glossaries-extra-stylemods-2021-11-22.sty, glossary-bookindex-2021-11-22.sty, glossary-longextra-2021-11-22.sty, glossary-topic-2021-11-22.sty.
\endpreamble
@@ -26,6 +26,8 @@
\generate{\file{glossaries-extra.sty}{\usepreamble\defaultpreamble
\usepostamble\defaultpostamble\from{glossaries-extra.dtx}{glossaries-extra.sty,package}}
+\file{glossaries-extra-abbrstyles.def}{\usepreamble\defaultpreamble
+\usepostamble\defaultpostamble\from{glossaries-extra.dtx}{glossaries-extra-abbrstyles.def,package}}
\file{glossaries-extra-bib2gls.sty}{\usepreamble\defaultpreamble
\usepostamble\defaultpostamble\from{glossaries-extra.dtx}{glossaries-extra-bib2gls.sty,package}}
\file{glossaries-extra-stylemods.sty}{\usepreamble\defaultpreamble
@@ -36,6 +38,8 @@
\usepostamble\defaultpostamble\from{glossaries-extra.dtx}{glossary-longextra.sty,package}}
\file{glossary-topic.sty}{\usepreamble\defaultpreamble
\usepostamble\defaultpostamble\from{glossaries-extra.dtx}{glossary-topic.sty,package}}
+\file{glossary-table.sty}{\usepreamble\defaultpreamble
+\usepostamble\defaultpostamble\from{glossaries-extra.dtx}{glossary-table.sty,package}}
\file{example-glossaries-xr.tex}{\usepreamble\defaultpreamble
\usepostamble\defaultpostamble\from{glossaries-extra.dtx}{example-glossaries-xr.tex,package}}
\file{example-glossaries-acronym-desc.bib}{\nopreamble\nopostamble\from{glossaries-extra.dtx}{example-glossaries-acronym-desc.bib}}
@@ -54,6 +58,18 @@
\file{example-glossaries-symbols.bib}{\nopreamble\nopostamble\from{glossaries-extra.dtx}{example-glossaries-symbols.bib}}
\file{example-glossaries-url.bib}{\nopreamble\nopostamble\from{glossaries-extra.dtx}{example-glossaries-url.bib}}
\file{example-glossaries-xr.bib}{\nopreamble\nopostamble\from{glossaries-extra.dtx}{example-glossaries-xr.bib}}
+\file{glossaries-extra-2021-11-22.sty}{\usepreamble\defaultpreamble
+\usepostamble\defaultpostamble\from{glossaries-extra.dtx}{glossaries-extra-2021-11-22.sty,package}}
+\file{glossaries-extra-bib2gls-2021-11-22.sty}{\usepreamble\defaultpreamble
+\usepostamble\defaultpostamble\from{glossaries-extra.dtx}{glossaries-extra-bib2gls-2021-11-22.sty,package}}
+\file{glossaries-extra-stylemods-2021-11-22.sty}{\usepreamble\defaultpreamble
+\usepostamble\defaultpostamble\from{glossaries-extra.dtx}{glossaries-extra-stylemods-2021-11-22.sty,package}}
+\file{glossary-bookindex-2021-11-22.sty}{\usepreamble\defaultpreamble
+\usepostamble\defaultpostamble\from{glossaries-extra.dtx}{glossary-bookindex-2021-11-22.sty,package}}
+\file{glossary-longextra-2021-11-22.sty}{\usepreamble\defaultpreamble
+\usepostamble\defaultpostamble\from{glossaries-extra.dtx}{glossary-longextra-2021-11-22.sty,package}}
+\file{glossary-topic-2021-11-22.sty}{\usepreamble\defaultpreamble
+\usepostamble\defaultpostamble\from{glossaries-extra.dtx}{glossary-topic-2021-11-22.sty,package}}
}
\endbatchfile
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-abbr-styles.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-abbr-styles.pdf
index 97fe60bfc7..ddad18e49a 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-abbr-styles.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-abbr-styles.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-abbr-styles.tex b/macros/latex/contrib/glossaries-extra/samples/sample-abbr-styles.tex
index a5caad77b6..d5625142a1 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-abbr-styles.tex
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-abbr-styles.tex
@@ -5,12 +5,18 @@
\documentclass{report}
+\usepackage[left=1cm,right=0.5cm,marginpar=2.5cm,includemp]{geometry}
\usepackage[T1]{fontenc}
\usepackage{relsize}
+\usepackage{fontawesome}
\usepackage{etoolbox}
+\usepackage{xcolor}
+\usepackage{soul}
\usepackage[colorlinks,linkcolor=magenta]{hyperref}
\usepackage{glossaries-extra}
+\newcommand*{\warningsym}{\textcolor{red}{\faExclamationTriangle}}
+
% If you get any undefined control sequences or undefined
% style errors, make sure you have the latest versions of
% glossaries-extra.sty and glossaries.sty
@@ -33,6 +39,9 @@
% for styles that don't have a designated command:
%\renewcommand{\glsfirstlongdefaultfont}[1]{\textsf{#1}}
+% Test command for "outer" formatting (applied with textformat key)
+\newcommand*{\sampleformat}[1]{\textbf{\color{teal}#1}}
+
% These commands are used by the '-hyphen' styles.
% For example, to switch to small-caps for the short form:
%\renewcommand{\glsabbrvhyphenfont}{\glsabbrvscfont}
@@ -44,16 +53,16 @@
\footnote{\glshyperlink[\glsfmtshort{#1}]{#1}: #2}%
}
-\glssetcategoryattribute{long-hyphen-short-hyphen}{markwords}{true}
-\glssetcategoryattribute{long-hyphen-postshort-hyphen}{markwords}{true}
-\glssetcategoryattribute{long-hyphen-short-hyphen-desc}{markwords}{true}
-\glssetcategoryattribute{long-hyphen-postshort-hyphen-desc}{markwords}{true}
-\glssetcategoryattribute{short-hyphen-long-hyphen}{markwords}{true}
-\glssetcategoryattribute{short-hyphen-postlong-hyphen}{markwords}{true}
-\glssetcategoryattribute{short-hyphen-long-hyphen-desc}{markwords}{true}
-\glssetcategoryattribute{short-hyphen-postlong-hyphen-desc}{markwords}{true}
-\glssetcategoryattribute{long-hyphen-noshort-desc-noreg}{markwords}{true}
-\glssetcategoryattribute{long-hyphen-noshort-noreg}{markwords}{true}
+\glssetcategoryattributes{long-hyphen-short-hyphen}{markwords,markshortwords}{true}
+\glssetcategoryattributes{long-hyphen-postshort-hyphen}{markwords,markshortwords}{true}
+\glssetcategoryattributes{long-hyphen-short-hyphen-desc}{markwords,markshortwords}{true}
+\glssetcategoryattributes{long-hyphen-postshort-hyphen-desc}{markwords,markshortwords}{true}
+\glssetcategoryattributes{short-hyphen-long-hyphen}{markwords,markshortwords}{true}
+\glssetcategoryattributes{short-hyphen-postlong-hyphen}{markwords,markshortwords}{true}
+\glssetcategoryattributes{short-hyphen-long-hyphen-desc}{markwords,markshortwords}{true}
+\glssetcategoryattributes{short-hyphen-postlong-hyphen-desc}{markwords,markshortwords}{true}
+\glssetcategoryattributes{long-hyphen-noshort-desc-noreg}{markwords,markshortwords}{true}
+\glssetcategoryattributes{long-hyphen-noshort-noreg}{markwords,markshortwords}{true}
\newcommand{\stylelist}{}
@@ -63,7 +72,7 @@
\newabbreviation[category=#1,%
%sort={#1},% order by style name
user1={user text}%
- ]{sample-#1}{short}{long form}%
+ ]{sample-#1}{short fm}{long form}%
\csdef{glsxtrpostdesc#1}{ [style: #1]}%
}
@@ -73,7 +82,7 @@
\newabbreviation[category=#1,%
%sort={#1},% order by style name
user1={user text},%
- description={sample description}]{sample-#1}{short}{long form}%
+ description={sample description}]{sample-#1}{short fm}{long form}%
\csdef{glsxtrpostdesc#1}{ [style: #1]}%
}
@@ -215,6 +224,33 @@ change the font). To make the default setting clearer, this document has done:
So any text in this document that's rendered in sans-serif would normally not have any font
change implemented.
+There are additional font changing tests implemented with outer text formatting
+(the textformat key) and inner text formatting (the innertextformat key).
+
+The hyperlink may be placed outside the outer formatting (hyperoutside=true) or
+inside of the outer formatting (hyperoutside=false). Note that when the
+hyperlink is outside, the text colour change applied by the sample formatting
+command (teal) overrides the colour change applied by the hyperlink colour
+setting (magenta). The outer text format can also be changed globally
+by redefining \verb|\glstextformat| or via the \verb|textformat| attribute.
+(Order of precedence: textformat option, textformat attribute,
+\verb|\glstextformat|.)
+
+The inner formatting is implemented within the abbreviation style, so it won't
+show up in custom styles that don't implement it. The outer formatting isn't
+applied to the post-link hook. The inner formatting may be applied to the
+post-link hook, depending whether or not it's supported by the abbreviation
+style.
+
+The outer text format is tested with the custom command defined as:
+\begin{verbatim}
+\newcommand*{\sampleformat}[1]{\textbf{\color{teal}#1}}
+\end{verbatim}
+The inner text format is tested with \verb|\hl| provided by soul.sty.
+(Complex commands such as those provided by soul can only be used
+in the inner text format. The outer format has the text content too
+deeply embedded for those commands to process.)
+
Each test entry is defined using
\begin{verbatim}
\newabbreviation[category=#1,user1={user text}]%
@@ -250,6 +286,13 @@ The test entries that use the \texttt{-hyphen} styles have had the
compound word hyphenation if the inserted text (through the final
optional argument of \verb|\gls|) starts with a hyphen.
+\raisebox{2ex}{\hypertarget{warningnote}{}}%
+\renewcommand*{\GlossariesAbbrStyleTooComplexWarning}[2]{%
+ \warningsym\marginpar{\hyperlink{warningnote}{\warningsym} too complex}}%
+The symbol \warningsym\ indicates that a warning would normally be
+issued at that point in the document for a style that's too complex
+to support the given command.
+
\tableofcontents
\pagenumbering{arabic}
@@ -259,12 +302,45 @@ First use of \verb|\gls|.
\forglsentries{\thislabel}{\glscategory{\thislabel}:
\gls{\thislabel}.\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\glsresetall
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\gls[textformat=sampleformat,hyperoutside=true]{\thislabel}.\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\glsresetall
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\gls[textformat=sampleformat,hyperoutside=false]{\thislabel}.\glspar}
+
+\section{innertextformat=hl}
+
+\glsresetall
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\gls[innertextformat=hl]{\thislabel}.\glspar}
+
\chapter{Next Use}
Next use of \verb|\gls|.
\forglsentries{\thislabel}{\glscategory{\thislabel}:
\gls{\thislabel}.\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\gls[textformat=sampleformat,hyperoutside=true]{\thislabel}.\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\gls[textformat=sampleformat,hyperoutside=false]{\thislabel}.\glspar}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\gls[innertextformat=hl]{\thislabel}.\glspar}
+
\chapter{First Use With Insert}
First use of \texttt{\string\gls\marg{label}[-insert]}. The conditional
\verb|\ifglsxtrinsertinside| is used by some styles to
@@ -299,6 +375,32 @@ differences more noticeable this document has done:
\glsreset{\thislabel}\glsxtrinsertinsidetrue
\gls{\thislabel}[-insert].\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsreset{\thislabel}\glsxtrinsertinsidefalse
+\gls[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert];
+\glsreset{\thislabel}\glsxtrinsertinsidetrue
+\gls[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert].\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsreset{\thislabel}\glsxtrinsertinsidefalse
+\gls[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert];
+\glsreset{\thislabel}\glsxtrinsertinsidetrue
+\gls[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert].\glspar}
+
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsreset{\thislabel}\glsxtrinsertinsidefalse
+\gls[innertextformat=hl]{\thislabel}[-insert];
+\glsreset{\thislabel}\glsxtrinsertinsidetrue
+\gls[innertextformat=hl]{\thislabel}[-insert].\glspar}
+
+
\chapter{Next Use With Insert}
Next use of \texttt{\string\gls\marg{label}[-insert]}.
@@ -314,6 +416,30 @@ conditional.
\glsxtrinsertinsidetrue
\gls{\thislabel}[-insert].\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\gls[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\gls[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert].\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\gls[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\gls[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert].\glspar}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\gls[innertextformat=hl]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\gls[innertextformat=hl]{\thislabel}[-insert].\glspar}
+
\chapter{Full Form}
Full form using \verb|\glsxtrfull| (inline full style).
This may differ from the display form used by \verb|\gls|
@@ -322,6 +448,21 @@ on first use, depending on the style.
\forglsentries{\thislabel}{\glscategory{\thislabel}:
\glsxtrfull{\thislabel}.\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrfull[textformat=sampleformat,hyperoutside=true]{\thislabel}.\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrfull[textformat=sampleformat,hyperoutside=false]{\thislabel}.\glspar}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrfull[innertextformat=hl]{\thislabel}.\glspar}
+
\chapter{Short Form}
Short form using \verb|\glsxtrshort|.
This may differ from the display form used by \verb|\gls|
@@ -331,12 +472,46 @@ on subsequent use, depending on the style.
\glsxtrshort{\thislabel}.\glspar
}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrshort[textformat=sampleformat,hyperoutside=true]{\thislabel}.\glspar
+}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrshort[textformat=sampleformat,hyperoutside=false]{\thislabel}.\glspar
+}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrshort[innertextformat=hl]{\thislabel}.\glspar
+}
+
+
\chapter{Long Form}
Long form using \verb|\glsxtrlong|.
\forglsentries{\thislabel}{\glscategory{\thislabel}:
\glsxtrlong{\thislabel}.\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrlong[textformat=sampleformat,hyperoutside=true]{\thislabel}.\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrlong[textformat=sampleformat,hyperoutside=false]{\thislabel}.\glspar}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrlong[innertextformat=detokenize]{\thislabel}.\glspar}
+
\chapter{Full Form With Insert}
Full form using \texttt{\string\glsxtrfull\marg{label}[-insert]} (inline full style).
In this test chapter, each entry is displayed
@@ -350,6 +525,30 @@ with \verb|\glsxtrinsertinsidefalse| and then displayed with
\glsxtrinsertinsidetrue
\glsxtrfull{\thislabel}[-insert].\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\glsxtrfull[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\glsxtrfull[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert].\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\glsxtrfull[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\glsxtrfull[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert].\glspar}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\glsxtrfull[innertextformat=hl]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\glsxtrfull[innertextformat=hl]{\thislabel}[-insert].\glspar}
+
\chapter{Short Form With Insert}
Short form using \texttt{\string\glsxtrshort\marg{label}[-insert]}.
@@ -364,6 +563,30 @@ with \verb|\glsxtrinsertinsidefalse| and then displayed with
\glsxtrinsertinsidetrue
\glsxtrshort{\thislabel}[-insert].\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\glsxtrshort[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\glsxtrshort[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert].\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\glsxtrshort[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\glsxtrshort[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert].\glspar}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\glsxtrshort[innertextformat=hl]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\glsxtrshort[innertextformat=hl]{\thislabel}[-insert].\glspar}
+
\chapter{Long Form With Insert}
Long form using \texttt{\string\glsxtrlong\marg{label}[-insert]}.
Note that the \texttt{hyphen} styles with the \texttt{markwords}
@@ -380,20 +603,82 @@ with \verb|\glsxtrinsertinsidefalse| and then displayed with
\glsxtrinsertinsidetrue
\glsxtrlong{\thislabel}[-insert].\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\glsxtrlong[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\glsxtrlong[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert].\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\glsxtrlong[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\glsxtrlong[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert].\glspar}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\glsxtrlong[innertextformat=hl]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\glsxtrlong[innertextformat=hl]{\thislabel}[-insert].\glspar}
+\glsxtrinsertinsidefalse
+
\chapter{First Form}
First form using \verb|\glsfirst|. This may be different
from the first use of \verb|\gls| depending on the style.
+In general, it's better not to use \verb|\glsfirst| with
+abbreviations. Use \verb|\gls| (possibly with a reset)
+or \verb|\glsxtrfull| instead.
+Some styles are too complicated to work with \verb|\glsfirst|.
\forglsentries{\thislabel}{\glscategory{\thislabel}:
\glsfirst{\thislabel}.\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsfirst[textformat=sampleformat,hyperoutside=true]{\thislabel}.\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsfirst[textformat=sampleformat,hyperoutside=false]{\thislabel}.\glspar}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsfirst[innertextformat=hl]{\thislabel}.\glspar}
+
\chapter{Text Form}
Text form using \verb|\glstext|. This may be different
from the subsequent use of \verb|\gls| depending on the style.
+In general, it's better not to use \verb|\glstext| with
+abbreviations. Use \verb|\gls| (possibly with an unset)
+or \verb|\glsxtrshort| instead.
\forglsentries{\thislabel}{\glscategory{\thislabel}:
\glstext{\thislabel}.\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glstext[textformat=sampleformat, hyperoutside=true]{\thislabel}.\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glstext[textformat=sampleformat, hyperoutside=false]{\thislabel}.\glspar}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glstext[innertextformat=hl]{\thislabel}.\glspar}
+
\chapter{First Form With Insert}
First form using \texttt{\string\glsfirst\marg{label}[-insert]}.
This is different from the first use of \verb|\gls|
@@ -406,30 +691,152 @@ to use \verb|\glsfirst| with abbreviations. Use either
\forglsentries{\thislabel}{\glscategory{\thislabel}:
\glsfirst{\thislabel}[-insert].\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsfirst[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert].\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsfirst[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert].\glspar}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsfirst[innertextformat=hl]{\thislabel}[-insert].\glspar}
+
\chapter{Text Form With Insert}
Text form using \texttt{\string\glstext\marg{label}[-insert]}.
This doesn't check for the conditional
\verb|\ifglsxtrinsertinside|.
+In general, it's better not to use \verb|\glstext| with
+abbreviations. Use \verb|\gls| (possibly with an unset)
+or \verb|\glsxtrshort| instead.
\forglsentries{\thislabel}{\glscategory{\thislabel}:
\glstext{\thislabel}[-insert].\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glstext[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert].\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glstext[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert].\glspar}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glstext[innertextformat=hl]{\thislabel}[-insert].\glspar}
+
\chapter{Summary}
\renewcommand{\do}[1]{\section{#1}
-First use \texttt{\string\gls\marg{label}}:
-\glsreset{sample-#1}\gls{sample-#1}.\par\noindent
-Next use \texttt{\string\gls\marg{label}}: \gls{sample-#1}.\par\noindent
-First use \texttt{\string\gls\marg{label}[-insert]}:
-\glsreset{sample-#1}\gls{sample-#1}[-insert].\par\noindent
-Next use \texttt{\string\gls\marg{label}[-insert]}:
-\gls{sample-#1}[-insert].\par\noindent
-\texttt{\string\glsxtrfull\marg{label}[-insert]}:
-\glsxtrfull{sample-#1}[-insert].\par\noindent
-\texttt{\string\glsxtrshort\marg{label}[-insert]}:
-\glsxtrshort{sample-#1}[-insert].\par\noindent
-\texttt{\string\glsxtrlong\marg{label}[-insert]}:
-\glsxtrlong{sample-#1}[-insert].\par\noindent
+\subsection{First Use}
+\texttt{\string\gls\marg{label}} / \texttt{\string\Gls\marg{label}} /
+\texttt{\string\GLS\marg{label}}:
+\gls[prereset]{sample-#1};
+\Gls[prereset]{sample-#1};
+\GLS[prereset]{sample-#1}.\par\noindent
+With insert:
+\gls[prereset]{sample-#1}[-insert];
+\Gls[prereset]{sample-#1}[-insert];
+\GLS[prereset]{sample-#1}[-insert].\par\noindent
+Plural \texttt{\string\glspl\marg{label}} / \texttt{\string\Glspl\marg{label}} /
+\texttt{\string\GLSpl\marg{label}}:
+\glspl[prereset]{sample-#1};
+\Glspl[prereset]{sample-#1};
+\GLSpl[prereset]{sample-#1}.\par\noindent
+With insert:
+\glspl[prereset]{sample-#1}[-insert];
+\Glspl[prereset]{sample-#1}[-insert];
+\GLSpl[prereset]{sample-#1}[-insert].
+\subsection{Next Use}
+\texttt{\string\gls\marg{label}} / \texttt{\string\Gls\marg{label}} /
+\texttt{\string\GLS\marg{label}}:
+\gls{sample-#1};
+\Gls{sample-#1};
+\GLS{sample-#1}.\par\noindent
+With insert:
+\gls{sample-#1}[-insert];
+\Gls{sample-#1}[-insert];
+\GLS{sample-#1}[-insert].\par\noindent
+Plural \texttt{\string\glspl\marg{label}} / \texttt{\string\Glspl\marg{label}} /
+\texttt{\string\GLSpl\marg{label}}:
+\glspl{sample-#1};
+\Glspl{sample-#1};
+\GLSpl{sample-#1}.\par\noindent
+With insert:
+\glspl{sample-#1}[-insert];
+\Glspl{sample-#1}[-insert];
+\GLSpl{sample-#1}[-insert].
+\subsection{Full Inline}
+\texttt{\string\glsxtrfull\marg{label}} /
+\texttt{\string\Glsxtrfull\marg{label}} /
+\texttt{\string\GLSxtrfull\marg{label}}:
+\glsxtrfull{sample-#1};
+\Glsxtrfull{sample-#1};
+\GLSxtrfull{sample-#1}.\par\noindent
+With insert:
+\glsxtrfull{sample-#1}[-insert];
+\Glsxtrfull{sample-#1}[-insert];
+\GLSxtrfull{sample-#1}[-insert].\par\noindent
+Plural \texttt{\string\glsxtrfullpl\marg{label}} /
+\texttt{\string\Glsxtrfullpl\marg{label}} /
+\texttt{\string\GLSxtrfullpl\marg{label}}:
+\glsxtrfullpl{sample-#1};
+\Glsxtrfullpl{sample-#1};
+\GLSxtrfullpl{sample-#1}.\par\noindent
+Plural with insert:
+\glsxtrfullpl{sample-#1}[-insert];
+\Glsxtrfullpl{sample-#1}[-insert];
+\GLSxtrfullpl{sample-#1}[-insert].
+\subsection{Short}
+\texttt{\string\glsxtrshort\marg{label}} /
+\texttt{\string\Glsxtrshort\marg{label}} /
+\texttt{\string\GLSxtrshort\marg{label}}:
+\glsxtrshort{sample-#1};
+\Glsxtrshort{sample-#1};
+\GLSxtrshort{sample-#1}.\par\noindent
+With insert:
+\glsxtrshort{sample-#1}[-insert];
+\Glsxtrshort{sample-#1}[-insert];
+\GLSxtrshort{sample-#1}[-insert].\par\noindent
+Plural \texttt{\string\glsxtrshortpl\marg{label}} /
+\texttt{\string\Glsxtrshortpl\marg{label}} /
+\texttt{\string\GLSxtrshortpl\marg{label}}:
+\glsxtrshortpl{sample-#1};
+\Glsxtrshortpl{sample-#1};
+\GLSxtrshortpl{sample-#1}.\par\noindent
+Plural with insert:
+\glsxtrshortpl{sample-#1}[-insert];
+\Glsxtrshortpl{sample-#1}[-insert];
+\GLSxtrshortpl{sample-#1}[-insert].
+\subsection{Long}
+\texttt{\string\glsxtrlong\marg{label}} /
+\texttt{\string\Glsxtrlong\marg{label}} /
+\texttt{\string\GLSxtrlong\marg{label}}:
+\glsxtrlong{sample-#1};
+\Glsxtrlong{sample-#1};
+\GLSxtrlong{sample-#1}.\par\noindent
+With insert:
+\glsxtrlong{sample-#1}[-insert];
+\Glsxtrlong{sample-#1}[-insert];
+\GLSxtrlong{sample-#1}[-insert].\par\noindent
+Plural \texttt{\string\glsxtrlongpl\marg{label}} /
+\texttt{\string\Glsxtrlongpl\marg{label}} /
+\texttt{\string\GLSxtrlongpl\marg{label}}:
+\glsxtrlongpl{sample-#1};
+\Glsxtrlongpl{sample-#1};
+\GLSxtrlongpl{sample-#1}.\par\noindent
+Plural with insert:
+\glsxtrlongpl{sample-#1}[-insert];
+\Glsxtrlongpl{sample-#1}[-insert];
+\GLSxtrlongpl{sample-#1}[-insert].
+\subsection{Other}
Name: \glsentryname{sample-#1}.\par\noindent
Sort: \texttt{\glsentrysort{sample-#1}}.\par\noindent
Description: \glsentrydesc{sample-#1}.\par
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-abbrv.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-abbrv.pdf
index a697131366..b7bca980af 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-abbrv.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-abbrv.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-accsupp.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-accsupp.pdf
index 37c57580b7..d8656327ed 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-accsupp.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-accsupp.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-acronym-desc.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-acronym-desc.pdf
index 2cafcdcaee..6372605793 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-acronym-desc.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-acronym-desc.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-acronym.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-acronym.pdf
index 76ba3b9aca..a29c48ba10 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-acronym.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-acronym.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-alias.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-alias.pdf
index ba4b5841c5..e3dac89466 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-alias.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-alias.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-altmodifier.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-altmodifier.pdf
index c9598650f1..20eeba5f36 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-altmodifier.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-altmodifier.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-alttree-marginpar.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-alttree-marginpar.pdf
index deb3f958fb..32c0013a1e 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-alttree-marginpar.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-alttree-marginpar.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-alttree-sym.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-alttree-sym.pdf
index ef8684f498..9630bb626b 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-alttree-sym.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-alttree-sym.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-alttree.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-alttree.pdf
index 9f7d115c31..29d37e1c08 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-alttree.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-alttree.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-autoindex-hyp.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-autoindex-hyp.pdf
index 19d8078f64..5081823433 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-autoindex-hyp.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-autoindex-hyp.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-autoindex.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-autoindex.pdf
index ed9ebfa5d2..797e828c06 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-autoindex.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-autoindex.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-crossref.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-crossref.pdf
index 98faf00379..be9532f557 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-crossref.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-crossref.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-crossref2.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-crossref2.pdf
index 0a1a5faa7b..16b300a658 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-crossref2.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-crossref2.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-docdef.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-docdef.pdf
index 8c71fa9125..14c4b7f66e 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-docdef.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-docdef.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-entrycount.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-entrycount.pdf
index 616a236a55..5784acfd4c 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-entrycount.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-entrycount.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-external.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-external.pdf
index 2e5a8b61c7..774a350d02 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-external.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-external.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-fmt.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-fmt.pdf
index 4ab15d3039..c44cf52026 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-fmt.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-fmt.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-footnote.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-footnote.pdf
index d9401ea0eb..0639914e7d 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-footnote.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-footnote.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-header.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-header.pdf
index 7a64e7f8fb..d24e3ffecc 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-header.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-header.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-indexhook.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-indexhook.pdf
index 3476f3ffb9..41fbbf4ae8 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-indexhook.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-indexhook.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-initialisms.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-initialisms.pdf
index 30e91037ad..39268001b7 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-initialisms.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-initialisms.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-initialisms.tex b/macros/latex/contrib/glossaries-extra/samples/sample-initialisms.tex
index 39aa4e905f..0a5fc1839d 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-initialisms.tex
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-initialisms.tex
@@ -33,6 +33,8 @@ without dots \gls{html} and the end of the sentence.
(Next use.) Abbreviations with dots \gls{eg} and \gls{si} and abbreviation
without dots \gls{html} and the end of the sentence.
+Singular: \gls{si} and at the end of a sentence \gls{si}.
+
Plural: \glspl{si} and at the end of a sentence \glspl{si}.
Reset\glsresetall. First use end of sentence:
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-linkcount.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-linkcount.pdf
index d504f07606..3191eba3dd 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-linkcount.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-linkcount.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-mixed-abbrv-styles.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-mixed-abbrv-styles.pdf
index 36e35a0036..0e69ad76e3 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-mixed-abbrv-styles.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-mixed-abbrv-styles.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-mixedsort.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-mixedsort.pdf
index 41496a03a1..49cf6cb9e2 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-mixedsort.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-mixedsort.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-mixedsort.tex b/macros/latex/contrib/glossaries-extra/samples/sample-mixedsort.tex
index a85c7c6b9b..945af5768f 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-mixedsort.tex
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-mixedsort.tex
@@ -1,3 +1,5 @@
+% arara: pdflatex
+% arara: pdflatex
\documentclass{article}
\usepackage[symbols,automake]{glossaries-extra}
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-mixture.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-mixture.pdf
index 197725e6b7..ccecdcca5a 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-mixture.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-mixture.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-multientry.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-multientry.pdf
index e663cfb884..682e5a0238 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-multientry.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-multientry.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-name-font.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-name-font.pdf
index d5f57c11b4..6853bbc904 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-name-font.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-name-font.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-nested.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-nested.pdf
index 441421bf25..2daf0cca35 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-nested.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-nested.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-nested.tex b/macros/latex/contrib/glossaries-extra/samples/sample-nested.tex
index a7c32a6908..ec57247753 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-nested.tex
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-nested.tex
@@ -14,7 +14,8 @@
\newabbreviation{ssi}{ssi}{server side includes}
\newabbreviation{html}{html}{hypertext markup language}
-%DON'T use this with upper casing commands!
+% If sentence-case is required for the following, ensure that you have glossaries
+% v4.50+ and mfirstuc v2.08+
\newabbreviation{shtml}{shtml}{\gls{ssi} enabled \gls{html}}
% Alternatively
@@ -33,6 +34,11 @@ commands like \verb|\gls| or \verb|\glsxtrshort| that occur
in fields, when any of those field is accessed through linking
commands.
+\section{\Glsxtrp{long}{html}}
+
+Make sure you have glossaries.sty v4.50+ and mfirstuc.sty v2.08+ for
+improved sentence-casing.
+
First use: \gls{shtml}.
\newpage
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-noidx-restricteddocdefs.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-noidx-restricteddocdefs.pdf
index a05a97144d..2a55474962 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-noidx-restricteddocdefs.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-noidx-restricteddocdefs.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-onelink.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-onelink.pdf
index a8aa2a5618..46e48d2d17 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-onelink.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-onelink.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-onthefly-utf8.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-onthefly-utf8.pdf
index b68e416e5d..15e61019ed 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-onthefly-utf8.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-onthefly-utf8.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-onthefly-xetex.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-onthefly-xetex.pdf
index 738c18e589..ab23b693c7 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-onthefly-xetex.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-onthefly-xetex.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-onthefly.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-onthefly.pdf
index cca87ab41e..336b0154cd 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-onthefly.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-onthefly.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-pages.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-pages.pdf
index bfae252c41..35db7aa14c 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-pages.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-pages.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-postdot.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-postdot.pdf
index aa66c978da..977735ffae 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-postdot.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-postdot.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-postlink.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-postlink.pdf
index 57d24e36f7..b12dcbd2d3 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-postlink.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-postlink.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-prefix.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-prefix.pdf
index b5be861062..6e164e2c2f 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-prefix.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-prefix.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-prefix.tex b/macros/latex/contrib/glossaries-extra/samples/sample-prefix.tex
index 7fa2f325fb..fec5e92f54 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-prefix.tex
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-prefix.tex
@@ -3,8 +3,8 @@
% arara: pdflatex
\documentclass{article}
-\usepackage{glossaries-extra}
-\usepackage{glossaries-prefix}
+\usepackage[colorlinks]{hyperref}
+\usepackage[prefix]{glossaries-extra}
\makeglossaries
@@ -14,6 +14,9 @@
{svm}{SVM}{support vector machine}
\begin{document}
+\tableofcontents
+
+\section{\Pglsfmtlong{svm}}
This is a sample document to test prefixes.
First use: \pgls{svm}.
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-record-nameref.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-record-nameref.pdf
index 3ffa713436..9398d20f26 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-record-nameref.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-record-nameref.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-record.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-record.pdf
index 8c3dc27480..831a6e3b42 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-record.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-record.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-restricteddocdefs.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-restricteddocdefs.pdf
index 86e48ef5ac..29649c4c4a 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-restricteddocdefs.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-restricteddocdefs.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-suppl-hyp.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-suppl-hyp.pdf
index afd19dd073..8d7f06953c 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-suppl-hyp.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-suppl-hyp.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-suppl-main-hyp.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-suppl-main-hyp.pdf
index 077434a94a..0e16dd138a 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-suppl-main-hyp.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-suppl-main-hyp.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-suppl-main.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-suppl-main.pdf
index df11469495..7d97db11f5 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-suppl-main.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-suppl-main.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-suppl.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-suppl.pdf
index f33fc059dc..0b86aaa2ce 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-suppl.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-suppl.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-trans.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-trans.pdf
index 0b58c5a146..33b037e5f6 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-trans.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-trans.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-undef.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-undef.pdf
index 78f3a357b8..a5e2c7368a 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-undef.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-undef.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-undef.tex b/macros/latex/contrib/glossaries-extra/samples/sample-undef.tex
index 194f4a4bc8..b4ade872ca 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-undef.tex
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-undef.tex
@@ -15,6 +15,7 @@
Defined entry: \gls{sample}, \glslink{sample}{text}.
+This paragraph will trigger a warning.
Undefined entry: \gls{undefined}, \glslink{undefined}{text}.
\printglossaries
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-unitentrycount.pdf b/macros/latex/contrib/glossaries-extra/samples/sample-unitentrycount.pdf
index e75a0fc4a7..47bfe1f3eb 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-unitentrycount.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-unitentrycount.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-unitentrycount.tex b/macros/latex/contrib/glossaries-extra/samples/sample-unitentrycount.tex
index 7979120c45..4b14bb25d8 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-unitentrycount.tex
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-unitentrycount.tex
@@ -1,4 +1,5 @@
% arara: pdflatex
+% arara: pdflatex
% arara: makeglossaries
% arara: pdflatex
\documentclass{report}
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample.pdf b/macros/latex/contrib/glossaries-extra/samples/sample.pdf
index 80d03daa53..33b78ed6d1 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample.pdf
+++ b/macros/latex/contrib/glossaries-extra/samples/sample.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample.tex b/macros/latex/contrib/glossaries-extra/samples/sample.tex
index 42e2f4d677..7d8e38efeb 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample.tex
+++ b/macros/latex/contrib/glossaries-extra/samples/sample.tex
@@ -5,9 +5,7 @@
\documentclass{article}
\usepackage[colorlinks]{hyperref}
-\usepackage{glossaries-extra}
-\usepackage{glossary-mcols}
-\setglossarystyle{mcolindex}
+\usepackage[stylemods=mcols,style=mcolindex]{glossaries-extra}
\makeglossaries
diff --git a/macros/latex/contrib/qrbill/README.md b/macros/latex/contrib/qrbill/README.md
index d04340f782..8079883d18 100644
--- a/macros/latex/contrib/qrbill/README.md
+++ b/macros/latex/contrib/qrbill/README.md
@@ -4,7 +4,7 @@ Copyright (C) Marei Peischl (peiTeX) <marei@peitex.de>, 2020–2022
This work is part of a collaborative project of Marei Peischl (peiTeX) and Alex Antener (foobar LLC).
-qrbill 2022/09/15 v1.05
+qrbill 2022/10/18 v1.06
***************************************************************************
@@ -65,12 +65,16 @@ For further information on l3build and other options please have a look at the c
* v1.03 (2021-05-10)
- Update to swiss qrbill payments standard v2.2
- Add seb-iban and sep-reference to the example files
- * v1.04 (2022/07/02)
+ * v1.04 (2022-07-02)
- add basic support for EPC QR codes
- add date parsing mechanism to preset the dates to values of `\today`
- * v1.05 (2022/09/15)
+ * v1.05 (2022-09-15)
- add option to convert all data to strings
- add mechanism to do custom replacements within the data
- fix qrcode encoding to support UTF-8
- add support for speedata's luaqrcode library for qrcode generation http://speedata.github.io/luaqrcode/
- - small layout and documentation fixes \ No newline at end of file
+ - small layout and documentation fixes
+ * v1.06 (2022-10-18)
+ - additional customization for vrule
+ - add possibilities to ignore data fields if empty
+ - allow the usage of commas within the billing info \ No newline at end of file
diff --git a/macros/latex/contrib/qrbill/qrbill.dtx b/macros/latex/contrib/qrbill/qrbill.dtx
index aa632a6845..fab4a79821 100644
--- a/macros/latex/contrib/qrbill/qrbill.dtx
+++ b/macros/latex/contrib/qrbill/qrbill.dtx
@@ -54,7 +54,7 @@
% \fi
% \iffalse
%<*driver>
-\ProvidesFile{qrbill.dtx}[2022/09/15 v1.05 \ create QR-bills based on the Swiss standard]
+\ProvidesFile{qrbill.dtx}[2022/10/18 v1.06 \ create QR-bills based on the Swiss standard]
\documentclass[english, parskip=half-]{scrartcl}
\usepackage{iftex}
\ifPDFTeX
@@ -86,9 +86,9 @@
\newcommand*\repl[1]{\meta{#1}}
\newcommand*\opt[1]{\colorbox{black!20}{\meta{#1}}}
\newcommand*\marg[1]{%
- {\ttfamily\char`\{}\repl{#1}{\ttfamily\char`\}}}
+ {\ttfamily\char`\{}\repl{#1}{\ttfamily\char`\}}}
\newcommand*\oarg[1]{%
- {\ttfamily[}\opt{#1}{\ttfamily]}
+ {\ttfamily[}\opt{#1}{\ttfamily]}
}
\newcommand*{\sarg}{\texttt{*}}
@@ -174,7 +174,7 @@
% \GetFileInfo{qrbill.dtx}
%
% \DoNotIndex{\newcommand,\newenvironment}
-% \title{qrbill v1.03}
+% \title{qrbill \fileversion}
% \subtitle{\LaTeX-package to create QR-bills based on the Swiss payments standards}
% \author{Marei Peischl \href{mailto:marei@peitex.de}{<marei@peitex.de>}}
% \publishers{A collaborative project of pei\TeX{} and foobar LLC}
@@ -192,16 +192,16 @@
% \fi
% \section{Example of use}
% The easies way to use the qrbill package is to create a bill with the standalone documentclass:
-%
+%
% \begin{doccode}
% \documentclass{standalone}
% \usepackage[ngerman]{babel}
-%
+%
% \usepackage{xcolor}
% \usepackage{qrbill}
-%
+%
% \begin{document}
-%
+%
% \QRbill[
% creditor={foobar LLC\\
% Postfach 404\\
@@ -210,7 +210,7 @@
% Account=CH1280808005649899718,
% % insert additional data here
% ]
-%
+%
% \end{document}
% \end{doccode}
%
@@ -278,6 +278,11 @@
% \item[iconwidth (length) (7mm)]
% This option allows custom scaling for custom icons.
%
+% \item[ignore-if-empty (comma list) (<empty>)]
+% Allows to define a list of fields for the qrscheme to be ignored if they have empty values.
+% For the swiss QRbill standard this is recommended for the fields \enquote{AV1-Parameters}, \enquote{AV2-Parameters} and \enquote{BillingInfo}.
+% \changes{v1.06}{2022/10/18}{Add ignore-if-empty option}
+%
% \item[qrmode (package/lua) (package)] Selects the mechanism for QRcode generation.
% With Version 2.0 the package supports usage of the the luaqrcode library \cite{luaqrcode}. This can be enabled by using the \latexinline{qmode=lua} option.
% In that case the luaqrcode libary has to be installed within the \verb+$LUAINPUTS+.
@@ -319,7 +324,11 @@
% Similarly the replace-umlauts options is mapping Umlauts to the two character representation. This can be used if UTF-8 is not supported.
% Custom replacements can be set up using \latexinline{\QRbillAddCustomReplacement} as described in section \ref{sec:custom-replacement}.
% \changes{v1.05}{2022/09/15}{Add replace-tilde/replace-umlauts options}
-%
+%
+% \item[vrule (true/false/symbol) (true)]
+% Allows customization of the vertical rule between payment part and receipt. The value \latexinline{vrule=symbol} acts similar to the \latexinline{separator=symbol} option.
+% \changes{v1.06}{2022/10/18}{Add vrule=symbol option.}
+%
% \end{optionlist}
%
% \section{Data setup}
@@ -505,7 +514,7 @@
% \section{Implementation}
% \begin{macrocode}
\RequirePackage{expl3}
-\ProvidesExplPackage{qrbill}{2022/09/15}{1.05}{
+\ProvidesExplPackage{qrbill}{2022/10/18}{1.06}{
Template for QR-bills based on the Swiss Payment Standards
}
\RequirePackage{iftex}
@@ -529,7 +538,7 @@
\keys_define:nn {qrbill} {
font .choices:nn = {Frutiger, Arial, Helvetica, Liberation Sans} {
- \tl_gset_eq:NN \g__qrbill_font_tl \l_keys_choice_tl
+ \tl_gset_eq:NN \g__qrbill_font_tl \l_keys_choice_tl
},
font .initial:n = Liberation Sans,
font / custom .code:n = {\tl_gclear:N \g__qrbill_font_tl},
@@ -545,42 +554,54 @@
qrmode .initial:n = package,
frame .choice:,
frame / false .code:n = {
- \bool_gset_false:N \g__qrbill_top_frame_bool
- \bool_gset_false:N \g__qrbill_bottom_frame_bool
- \bool_gset_false:N \g__qrbill_left_frame_bool
- \bool_gset_false:N \g__qrbill_right_frame_bool
- \bool_gset_true:N \g__qrbill_vrule_bool
+ \bool_gset_false:N \g__qrbill_top_frame_bool
+ \bool_gset_false:N \g__qrbill_bottom_frame_bool
+ \bool_gset_false:N \g__qrbill_left_frame_bool
+ \bool_gset_false:N \g__qrbill_right_frame_bool
},
frame / true .code:n = {
- \bool_gset_true:N \g__qrbill_top_frame_bool
- \bool_gset_true:N \g__qrbill_bottom_frame_bool
- \bool_gset_true:N \g__qrbill_left_frame_bool
- \bool_gset_true:N \g__qrbill_right_frame_bool
- \bool_gset_true:N \g__qrbill_vrule_bool
+ \bool_gset_true:N \g__qrbill_top_frame_bool
+ \bool_gset_true:N \g__qrbill_bottom_frame_bool
+ \bool_gset_true:N \g__qrbill_left_frame_bool
+ \bool_gset_true:N \g__qrbill_right_frame_bool
},
frame / top .code:n = {
- \bool_gset_true:N \g__qrbill_top_frame_bool
- \bool_gset_false:N \g__qrbill_bottom_frame_bool
- \bool_gset_false:N \g__qrbill_left_frame_bool
- \bool_gset_false:N \g__qrbill_right_frame_bool
- \bool_gset_true:N \g__qrbill_vrule_bool
+ \bool_gset_true:N \g__qrbill_top_frame_bool
+ \bool_gset_false:N \g__qrbill_bottom_frame_bool
+ \bool_gset_false:N \g__qrbill_left_frame_bool
+ \bool_gset_false:N \g__qrbill_right_frame_bool
},
frame / bottom .code:n = {
- \bool_gset_false:N \g__qrbill_top_frame_bool
- \bool_gset_true:N \g__qrbill_bottom_frame_bool
- \bool_gset_false:N \g__qrbill_left_frame_bool
- \bool_gset_false:N \g__qrbill_right_frame_bool
- \bool_gset_true:N \g__qrbill_vrule_bool
+ \bool_gset_false:N \g__qrbill_top_frame_bool
+ \bool_gset_true:N \g__qrbill_bottom_frame_bool
+ \bool_gset_false:N \g__qrbill_left_frame_bool
+ \bool_gset_false:N \g__qrbill_right_frame_bool
},
frame / none .code:n = {
- \bool_gset_false:N \g__qrbill_top_frame_bool
- \bool_gset_false:N \g__qrbill_bottom_frame_bool
- \bool_gset_false:N \g__qrbill_left_frame_bool
- \bool_gset_false:N \g__qrbill_right_frame_bool
- \bool_gset_false:N \g__qrbill_vrule_bool
+ \bool_gset_false:N \g__qrbill_top_frame_bool
+ \bool_gset_false:N \g__qrbill_bottom_frame_bool
+ \bool_gset_false:N \g__qrbill_left_frame_bool
+ \bool_gset_false:N \g__qrbill_right_frame_bool
+ \keys_set:nn {qrbill} {vrule=false}
},
-
frame .initial:n = true,
+ vrule .choice:,
+ vrule / true .code:n = \tl_gset:Nn \g__qrbill_vrule_tl {\rule{\g__qrbill_rule_dim}{\c_qrbill_height_dim}},
+ vrule / false .code:n = \tl_gset:Nn \g__qrbill_vrule_tl {\rule{\g__qrbill_rule_dim}{\c_zero_dim}},
+ vrule / symbol .code:n = {
+ \RequirePackage{marvosym}
+ \tl_gset:Nn \g__qrbill_vrule_tl {
+ \rotatebox{90}{
+ \hbox_to_wd:nn {\c_qrbill_height_dim}{
+ \leaders\hbox{\rule{1mm}{\g__qrbill_rule_dim}\hspace{1mm}}\hskip 0pt\@plus1 fill\relax
+ \llap{\raisebox{-.5\height}[\c_zero_dim][\c_zero_dim]{\LeftScissors}}
+ \leaders\hbox{\rule{1mm}{\g__qrbill_rule_dim}\hspace{1mm}}\hskip 0pt\@plus4 fill\relax
+ \hbox{\rule{1mm}{\g__qrbill_rule_dim}}
+ }
+ }
+ }
+ },
+ vrule .initial:n = true,
billinginfo .bool_gset:N = \g__grbill_billinginfo_auto_bool,
billinginfo .default:n = true,
billinginfo .initial:n = true,
@@ -592,31 +613,30 @@
iconwidth .initial:n = 7mm,
separate .choice:,
separate / symbol .code:n = {
- \bool_gset_true:N \g__qrbill_separateinfo_bool
- \RequirePackage{marvosym}
- \cs_set:Nn \qrbill_print_separate_info: {
- \par\leaders\vbox_to_ht:nn {1sp} {
- \smash{
- \hbox_to_wd:nn {\c_qrbill_width_dim }{
- \leaders\hbox{\rule{1mm}{\g__qrbill_rule_dim}\hspace{1mm}}\hskip 0pt\@plus1 fill\relax
- \llap{\raisebox{-.5\height}{\LeftScissors}}
- \leaders\hbox{\rule{1mm}{\g__qrbill_rule_dim}\hspace{1mm}}\hskip 0pt\@plus4 fill\relax
- }
- }
- }
- \vskip 1sp
- \vskip -1sp
- }
- },
+ \bool_gset_true:N \g__qrbill_separateinfo_bool
+ \RequirePackage{marvosym}
+ \cs_set:Nn \qrbill_print_separate_info: {
+ \par\leaders\vbox_to_ht:nn {1sp} {
+ \smash{
+ \hbox_to_wd:nn {\c_qrbill_width_dim }{
+ \leaders\hbox{\rule{1mm}{\g__qrbill_rule_dim}\hspace{1mm}}\hskip 0pt\@plus1 fill\relax
+ \llap{\raisebox{-.5\height}{\LeftScissors}}
+ \leaders\hbox{\rule{1mm}{\g__qrbill_rule_dim}\hspace{1mm}}\hskip 0pt\@plus4 fill\relax
+ }
+ }
+ }
+ \vskip 1sp
+ \vskip -1sp
+ }
+ },
separate / text .code:n = {
- \bool_gset_true:N \g__qrbill_separateinfo_bool
- \cs_set:Nn \qrbill_print_separate_info: {
- \centerline{\raisebox{\dimexpr\depth+.3ex\relax}[0pt][0pt]{\footnotesize\qrbillseparatename}}
- \par\nointerlineskip
- \rule{\c_qrbill_width_dim}{\g__qrbill_rule_dim}
- }
- }
- ,
+ \bool_gset_true:N \g__qrbill_separateinfo_bool
+ \cs_set:Nn \qrbill_print_separate_info: {
+ \centerline{\raisebox{\dimexpr\depth+.3ex\relax}[0pt][0pt]{\footnotesize\qrbillseparatename}}
+ \par\nointerlineskip
+ \rule{\c_qrbill_width_dim}{\g__qrbill_rule_dim}
+ }
+ },
separate / false .code:n = {\bool_gset_false:N \g__qrbill_separateinfo_bool},
separate .initial:n = text,
sep-iban .int_gset:N = \g__qrbill_ibansep_int,
@@ -636,6 +656,8 @@
replace-umlauts / true .code:n = \prop_gput_from_keyval:Nn \g__qrbill_replacement_prop {ä=ae,Ä=AE,ü=ue,Ü=UE,ö=oe,Ö=OE,ß=ss,ẞ=SS},
replace-umlauts / false .code:n = \clist_map_inline:nn {ä,Ä,ü,Ü,ö,Ö,ß,ẞ} {\prop_gremove:Nn \g__qrbill_replacement_prop {##1}},
data-to-string .bool_gset:N = \g__qrbill_to_string_bool,
+ ignore-if-empty .clist_gset:N = \g__qrbill_ignore_if_empty_clist,
+ ignore-if-empty .initial:n = ,
}
\ProcessKeysOptions{qrbill}
@@ -797,13 +819,13 @@
\cs_new:Nn \__qrbill_placeholder:nn {
\vbox_to_ht:nn {#2} {
- \hbox_to_wd:nn {#1} {\__qrbill_placeholder_hmark: \hfill \__qrbill_placeholder_hmark:}
- \nointerlineskip
- \hbox_to_wd:nn {#1} {\__qrbill_placeholder_vmark: \hfill \__qrbill_placeholder_vmark:}
- \vfill
- \hbox_to_wd:nn {#1} {\__qrbill_placeholder_vmark: \hfill \__qrbill_placeholder_vmark:}
- \nointerlineskip
- \hbox_to_wd:nn {#1} {\__qrbill_placeholder_hmark: \hfill \__qrbill_placeholder_hmark:}
+ \hbox_to_wd:nn {#1} {\__qrbill_placeholder_hmark: \hfill \__qrbill_placeholder_hmark:}
+ \nointerlineskip
+ \hbox_to_wd:nn {#1} {\__qrbill_placeholder_vmark: \hfill \__qrbill_placeholder_vmark:}
+ \vfill
+ \hbox_to_wd:nn {#1} {\__qrbill_placeholder_vmark: \hfill \__qrbill_placeholder_vmark:}
+ \nointerlineskip
+ \hbox_to_wd:nn {#1} {\__qrbill_placeholder_hmark: \hfill \__qrbill_placeholder_hmark:}
}
}
@@ -813,172 +835,170 @@
\qrbillfont
\setlength{\parindent}{\z@}
\parbox{\c_qrbill_width_dim }{
- \vbox to \c_qrbill_height_dim {
- \bool_if:NTF \g__qrbill_top_frame_bool
- {
- \bool_if:NTF \g__qrbill_separateinfo_bool
- {\qrbill_print_separate_info:}
- {\rule{\c_qrbill_width_dim}{\g__qrbill_rule_dim}}
- }
- {\rule{\c_zero_dim}{\g__qrbill_rule_dim}}
- \par\nointerlineskip
- \skip_vertical:n {\c_qrbill_sep_dim-\g__qrbill_rule_dim}
- \skip_horizontal:n {\c_qrbill_sep_dim-\g__qrbill_rule_dim}
- \begin{minipage}[c][95mm][t]{52mm}
- \vbox_to_ht:nn {7mm} {\qrbill_title_font:\qrbillreceiptname}
- \par\nointerlineskip
- \vbox_to_ht:nn {56mm}{
- {\qrbill_headingR_font:\qrbillaccountname\par}
- {
- \qrbill_valueR_font:
- \__qrbill_sep_tl:nV {iban} \l_qrbill_data_Account_tl\par
- \qrbill_insert_address:N \g__qrbill_creditorprefix_tl
- \par\vskip\baselineskip
- }
- \tl_if_empty:NF \l_qrbill_data_Reference_tl {
- {\qrbill_headingR_font:\qrbillreferencename\par}
- {
- \qrbill_valueR_font:
- \__qrbill_sep_tl:nV {reference} \l_qrbill_data_Reference_tl
- \par\vskip\baselineskip
- }
- }
- \tl_if_empty:cTF {l_qrbill_data_\g__qrbill_debtorprefix_tl Name_tl}
- {
- {\qrbill_headingR_font:\qrbilldebtoraddrname\par}
- \__qrbill_placeholder:nn {52mm} {20mm}
- }{
- {\qrbill_headingR_font:\qrbilldebtorname\par}
- {
- \qrbill_valueR_font:
- \qrbill_insert_address:N \g__qrbill_debtorprefix_tl
- \par
- }
- }
- }
- \par\nointerlineskip
- \vbox_to_ht:nn {14mm}{
- \qrbill_headingR_font:
- \begin{tabular}[t]{@{}ll@{}}
- \qrbillcurrencyname&\qrbill_headingR_font:\qrbillamountname\\
- \qrbill_amountR_font:\l_qrbill_data_Currency_tl
- &\qrbill_amountR_font:
- \tl_if_empty:NF \l_qrbill_data_Amount_tl
- {\numprint{\l_qrbill_data_Amount_tl}}
- \end{tabular}
- \tl_if_empty:NTF \l_qrbill_data_Amount_tl {
- \hfill
- \raisebox{\dimexpr-\height+\ht\strutbox}[\z@]{\llap{
- \__qrbill_placeholder:nn {30mm} {10mm}
- }}
- }
- \vfill
- }
- \par\nointerlineskip
- \vbox_to_ht:nn {18mm} {
- \makebox[\linewidth][r]{\qrbill_headingR_font:\qrbillacceptantname}\par
- }
- \end{minipage}%
- \skip_horizontal:n {2\c_qrbill_sep_dim}
- \begin{minipage}[c][95mm][t]{138mm}
- \begin{minipage}[c][85mm][t]{51mm}
- \parbox[t][7mm][t]{\linewidth}{\qrbill_title_font:\qrbillpaymentpartname}
- \par\nointerlineskip
- \skip_vertical:n {\c_qrbill_sep_dim}
- \qrcode_setup_QRcode:
- \leavevmode\qrbill_parse_QRcode:V \l_qrbill_data_str
- \tl_if_empty:NF \g_qrbill_icon_tl {
- \llap{\hbox_to_wd:nn {\g_qrbill_QRcode_dim} {
- \hfill
- \raisebox{\dimexpr-.5\height+.5\g_qrbill_QRcode_dim}[0pt][0pt]{
- \includegraphics[width=\g_qrbill_iconwidth_dim]{\g_qrbill_icon_tl}
- }
- \hfill
- }}
- }
- \skip_vertical:n {\c_qrbill_sep_dim}
- \vbox_to_ht:nn {22mm}{
- \begin{tabular}[b]{@{}ll@{}}
- \qrbill_headingP_font:\qrbillcurrencyname&\qrbill_headingP_font:
- \qrbillamountname\\
- \qrbill_amountP_font:\tl_use:c {l_qrbill_data_Currency_tl}&
- \tl_if_empty:NF \l_qrbill_data_Amount_tl {
- \qrbill_amountP_font:\numprint{\l_qrbill_data_Amount_tl}
- }
- \end{tabular}
- \tl_if_empty:NTF \l_qrbill_data_Amount_tl {
- \hfill
- \raisebox{\dimexpr-\height+\ht\strutbox}[\z@]{
- \llap{\__qrbill_placeholder:nn {40mm} {15mm}
- }}
- }
- }
- \end{minipage}
- \begin{minipage}[c][85mm][t]{87mm}
- \par\nointerlineskip
- {\qrbill_headingP_font:\qrbillaccountname\par}
- {
- \qrbill_valueP_font:
- \__qrbill_sep_tl:nV {iban} \l_qrbill_data_Account_tl \par
- \qrbill_insert_address:N \g__qrbill_creditorprefix_tl
- \par\vskip\baselineskip
- }
- \tl_if_empty:NF \l_qrbill_data_Reference_tl {
- {\qrbill_headingP_font:\qrbillreferencename\par}
- {\qrbill_valueP_font:
- \__qrbill_sep_tl:nV {reference} \l_qrbill_data_Reference_tl
- \par\vskip\baselineskip}
- }
- \exp_args:Nf \tl_if_empty:nF {
- \l_qrbill_data_BillingInfo_tl
- \l_qrbill_data_Message_tl
- }{
- {\qrbill_headingP_font:\qrbilladdinfoname\par}
- {
- \qrbill_valueP_font:
- \l_qrbill_data_Message_tl\par
- \tl_replace_all:Nnn \l_qrbill_data_BillingInfo_tl {/} {\discretionary{}{}{}/}
- \l_qrbill_data_BillingInfo_tl
- \par\vskip\baselineskip
- }
- }
- \tl_if_empty:cTF {l_qrbill_data_\g__qrbill_debtorprefix_tl Name_tl} {
- {\qrbill_headingP_font:\qrbilldebtoraddrname\par}
- \__qrbill_placeholder:nn {65mm} {25mm}
- }{
- {\qrbill_headingP_font:\qrbilldebtorname\par}
- {
- \qrbill_valueP_font:
- \qrbill_insert_address:N \g__qrbill_debtorprefix_tl
- \par
- }
- }
- \end{minipage}\par\nointerlineskip
- \begin{minipage}[b][10mm][t]{\linewidth}
- \strut
- \qrbill_insert_AV_parameters:NNn
- \qrbill_infoheading_font:
- \qrbill_info_font:
- {AV1,AV2}
- \end{minipage}
- \end{minipage}
- \par\nointerlineskip\skip_vertical:n {\c_qrbill_sep_dim}
- \smash{
- \bool_if:NT \g__qrbill_bottom_frame_bool
- {\rlap{\rule{\c_qrbill_width_dim}{\g__qrbill_rule_dim}}}
- \bool_if:NTF \g__qrbill_left_frame_bool
- {\rule{\g__qrbill_rule_dim}{\c_qrbill_height_dim}}
- {\rule{\g__qrbill_rule_dim}{\c_zero_dim}}
- \hspace{\dimexpr62mm-1.5\g__qrbill_rule_dim}
- \bool_if:NTF \g__qrbill_vrule_bool
- {\rule{\g__qrbill_rule_dim}{\c_qrbill_height_dim}}
- {\rule{\g__qrbill_rule_dim}{\c_zero_dim}}
- \hspace{\dimexpr148mm-1.5\g__qrbill_rule_dim}
- \bool_if:NTF \g__qrbill_right_frame_bool
- {\rule{\g__qrbill_rule_dim}{\c_qrbill_height_dim}}
- {\rule{\g__qrbill_rule_dim}{\c_zero_dim}}
- }
- }
+ \vbox to \c_qrbill_height_dim {
+ \bool_if:NTF \g__qrbill_top_frame_bool
+ {
+ \bool_if:NTF \g__qrbill_separateinfo_bool
+ {\qrbill_print_separate_info:}
+ {\rule{\c_qrbill_width_dim}{\g__qrbill_rule_dim}}
+ }
+ {\rule{\c_zero_dim}{\g__qrbill_rule_dim}}
+ \par\nointerlineskip
+ \skip_vertical:n {\c_qrbill_sep_dim-\g__qrbill_rule_dim}
+ \skip_horizontal:n {\c_qrbill_sep_dim-\g__qrbill_rule_dim}
+ \begin{minipage}[c][95mm][t]{52mm}
+ \vbox_to_ht:nn {7mm} {\qrbill_title_font:\qrbillreceiptname}
+ \par\nointerlineskip
+ \vbox_to_ht:nn {56mm}{
+ {\qrbill_headingR_font:\qrbillaccountname\par}
+ {
+ \qrbill_valueR_font:
+ \__qrbill_sep_tl:nV {iban} \l_qrbill_data_Account_tl\par
+ \qrbill_insert_address:N \g__qrbill_creditorprefix_tl
+ \par\vskip\baselineskip
+ }
+ \tl_if_empty:NF \l_qrbill_data_Reference_tl {
+ {\qrbill_headingR_font:\qrbillreferencename\par}
+ {
+ \qrbill_valueR_font:
+ \__qrbill_sep_tl:nV {reference} \l_qrbill_data_Reference_tl
+ \par\vskip\baselineskip
+ }
+ }
+ \tl_if_empty:cTF {l_qrbill_data_\g__qrbill_debtorprefix_tl Name_tl}
+ {
+ {\qrbill_headingR_font:\qrbilldebtoraddrname\par}
+ \__qrbill_placeholder:nn {52mm} {20mm}
+ }{
+ {\qrbill_headingR_font:\qrbilldebtorname\par}
+ {
+ \qrbill_valueR_font:
+ \qrbill_insert_address:N \g__qrbill_debtorprefix_tl
+ \par
+ }
+ }
+ }
+ \par\nointerlineskip
+ \vbox_to_ht:nn {14mm}{
+ \qrbill_headingR_font:
+ \begin{tabular}[t]{@{}ll@{}}
+ \qrbillcurrencyname&\qrbill_headingR_font:\qrbillamountname\\
+ \qrbill_amountR_font:\l_qrbill_data_Currency_tl
+ &\qrbill_amountR_font:
+ \tl_if_empty:NF \l_qrbill_data_Amount_tl
+ {\numprint{\l_qrbill_data_Amount_tl}}
+ \end{tabular}
+ \tl_if_empty:NTF \l_qrbill_data_Amount_tl {
+ \hfill
+ \raisebox{\dimexpr-\height+\ht\strutbox}[\z@]{\llap{
+ \__qrbill_placeholder:nn {30mm} {10mm}
+ }}
+ }
+ \vfill
+ }
+ \par\nointerlineskip
+ \vbox_to_ht:nn {18mm} {
+ \makebox[\linewidth][r]{\qrbill_headingR_font:\qrbillacceptantname}\par
+ }
+ \end{minipage}%
+ \skip_horizontal:n {2\c_qrbill_sep_dim}
+ \begin{minipage}[c][95mm][t]{138mm}
+ \begin{minipage}[c][85mm][t]{51mm}
+ \parbox[t][7mm][t]{\linewidth}{\qrbill_title_font:\qrbillpaymentpartname}
+ \par\nointerlineskip
+ \skip_vertical:n {\c_qrbill_sep_dim}
+ \qrcode_setup_QRcode:
+ \leavevmode\qrbill_parse_QRcode:V \l_qrbill_data_str
+ \tl_if_empty:NF \g_qrbill_icon_tl {
+ \llap{\hbox_to_wd:nn {\g_qrbill_QRcode_dim} {
+ \hfill
+ \raisebox{\dimexpr-.5\height+.5\g_qrbill_QRcode_dim}[0pt][0pt]{
+ \includegraphics[width=\g_qrbill_iconwidth_dim]{\g_qrbill_icon_tl}
+ }
+ \hfill
+ }}
+ }
+ \skip_vertical:n {\c_qrbill_sep_dim}
+ \vbox_to_ht:nn {22mm}{
+ \begin{tabular}[b]{@{}ll@{}}
+ \qrbill_headingP_font:\qrbillcurrencyname&\qrbill_headingP_font:
+ \qrbillamountname\\
+ \qrbill_amountP_font:\tl_use:c {l_qrbill_data_Currency_tl}&
+ \tl_if_empty:NF \l_qrbill_data_Amount_tl {
+ \qrbill_amountP_font:\numprint{\l_qrbill_data_Amount_tl}
+ }
+ \end{tabular}
+ \tl_if_empty:NTF \l_qrbill_data_Amount_tl {
+ \hfill
+ \raisebox{\dimexpr-\height+\ht\strutbox}[\z@]{
+ \llap{\__qrbill_placeholder:nn {40mm} {15mm}
+ }}
+ }
+ }
+ \end{minipage}
+ \begin{minipage}[c][85mm][t]{87mm}
+ \par\nointerlineskip
+ {\qrbill_headingP_font:\qrbillaccountname\par}
+ {
+ \qrbill_valueP_font:
+ \__qrbill_sep_tl:nV {iban} \l_qrbill_data_Account_tl \par
+ \qrbill_insert_address:N \g__qrbill_creditorprefix_tl
+ \par\vskip\baselineskip
+ }
+ \tl_if_empty:NF \l_qrbill_data_Reference_tl {
+ {\qrbill_headingP_font:\qrbillreferencename\par}
+ {\qrbill_valueP_font:
+ \__qrbill_sep_tl:nV {reference} \l_qrbill_data_Reference_tl
+ \par\vskip\baselineskip}
+ }
+ \exp_args:Nf \tl_if_empty:nF {
+ \l_qrbill_data_BillingInfo_tl
+ \l_qrbill_data_Message_tl
+ }{
+ {\qrbill_headingP_font:\qrbilladdinfoname\par}
+ {
+ \qrbill_valueP_font:
+ \l_qrbill_data_Message_tl\par
+ \tl_replace_all:Nnn \l_qrbill_data_BillingInfo_tl {/} {\discretionary{}{}{}/}
+ \l_qrbill_data_BillingInfo_tl
+ \par\vskip\baselineskip
+ }
+ }
+ \tl_if_empty:cTF {l_qrbill_data_\g__qrbill_debtorprefix_tl Name_tl} {
+ {\qrbill_headingP_font:\qrbilldebtoraddrname\par}
+ \__qrbill_placeholder:nn {65mm} {25mm}
+ }{
+ {\qrbill_headingP_font:\qrbilldebtorname\par}
+ {
+ \qrbill_valueP_font:
+ \qrbill_insert_address:N \g__qrbill_debtorprefix_tl
+ \par
+ }
+ }
+ \end{minipage}\par\nointerlineskip
+ \begin{minipage}[b][10mm][t]{\linewidth}
+ \strut
+ \qrbill_insert_AV_parameters:NNn
+ \qrbill_infoheading_font:
+ \qrbill_info_font:
+ {AV1,AV2}
+ \end{minipage}
+ \end{minipage}
+ \par\nointerlineskip\skip_vertical:n {\c_qrbill_sep_dim}
+ \smash{
+ \bool_if:NT \g__qrbill_bottom_frame_bool
+ {\rlap{\rule{\c_qrbill_width_dim}{\g__qrbill_rule_dim}}}
+ \bool_if:NTF \g__qrbill_left_frame_bool
+ {\rule{\g__qrbill_rule_dim}{\c_qrbill_height_dim}}
+ {\rule{\g__qrbill_rule_dim}{\c_zero_dim}}
+ \hspace{\dimexpr62mm-1.5\g__qrbill_rule_dim}
+ \g__qrbill_vrule_tl
+ \hspace{\dimexpr148mm-1.5\g__qrbill_rule_dim}
+ \bool_if:NTF \g__qrbill_right_frame_bool
+ {\rule{\g__qrbill_rule_dim}{\c_qrbill_height_dim}}
+ {\rule{\g__qrbill_rule_dim}{\c_zero_dim}}
+ }
+ }
}
\endgroup
}
@@ -1006,10 +1026,10 @@
\ior_str_map_inline:Nn \qrbill_ior {
\int_step_inline:nnn {2} {\l_tmpa_int } {
- \exp_args:Nnx \use:n {\exp_args:NNx \exp_args:Nnc \defcaptionname
- {\clist_item:Nn \l_qrbill_tmpa_clist {##1}}
- {qrbill\clist_item:nn {#1} {1}name}}
- {\clist_item:nn {#1} {##1}}
+ \exp_args:Nnx \use:n {\exp_args:NNx \exp_args:Nnc \defcaptionname
+ {\clist_item:Nn \l_qrbill_tmpa_clist {##1}}
+ {qrbill\clist_item:nn {#1} {1}name}}
+ {\clist_item:nn {#1} {##1}}
}
}
@@ -1026,13 +1046,13 @@
\seq_set_split:Nnn \l_qrbill_tmp_seq {\\} {#2}
}
\exp_args:Nnx \keys_set:nn {qrbill/data} {
- #1AddressType=K,
- #1Name=\seq_item:Nn \l_qrbill_tmp_seq {1},
- #1Address1=\seq_item:Nn \l_qrbill_tmp_seq {2},
- #1Address2=\seq_item:Nn \l_qrbill_tmp_seq {3},
- #1PostalCode=,
- #1City=,
- #1Country=\seq_item:Nn \l_qrbill_tmp_seq {4},
+ #1AddressType=K,
+ #1Name={\seq_item:Nn \l_qrbill_tmp_seq {1}},
+ #1Address1={\seq_item:Nn \l_qrbill_tmp_seq {2}},
+ #1Address2={\seq_item:Nn \l_qrbill_tmp_seq {3}},
+ #1PostalCode=,
+ #1City=,
+ #1Country={\seq_item:Nn \l_qrbill_tmp_seq {4}},
}
}
@@ -1045,40 +1065,40 @@
\seq_set_split:Nnn \l_qrbill_tmp_seq {\\} {#2}
}
\exp_args:Nnx \keys_set:nn {qrbill/data} {
- #1AddressType=S,
- #1Name=\seq_item:Nn \l_qrbill_tmp_seq {1},
- #1Address1=\seq_item:Nn \l_qrbill_tmp_seq {2},
- #1Address2=\seq_item:Nn \l_qrbill_tmp_seq {3},
- #1PostalCode=\seq_item:Nn \l_qrbill_tmp_seq {4},
- #1City=\seq_item:Nn \l_qrbill_tmp_seq {5},
- #1Country=\seq_item:Nn \l_qrbill_tmp_seq {6},
+ #1AddressType=S,
+ #1Name={\seq_item:Nn \l_qrbill_tmp_seq {1}},
+ #1Address1={\seq_item:Nn \l_qrbill_tmp_seq {2}},
+ #1Address2={\seq_item:Nn \l_qrbill_tmp_seq {3}},
+ #1PostalCode={\seq_item:Nn \l_qrbill_tmp_seq {4}},
+ #1City={\seq_item:Nn \l_qrbill_tmp_seq {5}},
+ #1Country={\seq_item:Nn \l_qrbill_tmp_seq {6}},
}
}
\cs_new:Nn \qrbill_insert_address:N {
\tl_use:c {l_qrbill_data_#1Name_tl}\ifhmode\\\fi
\str_case_e:nnF {\use:c {l_qrbill_data_#1AddressType_tl}}
- {
- {K} {
- \tl_use:c {l_qrbill_data_#1Address1_tl}
- \tl_if_empty:cF {l_qrbill_data_#1Address2_tl} {
- \ifhmode\\\fi
- \tl_if_empty:cF {l_qrbill_data_#1Country_tl}
- {\tl_use:c {l_qrbill_data_#1Country_tl}-}
- \tl_use:c {l_qrbill_data_#1Address2_tl}
- }
- }
- }{
- \tl_use:c {l_qrbill_data_#1Address1_tl}~
- \tl_use:c {l_qrbill_data_#1Address2_tl}
- \tl_if_empty:cF {l_qrbill_data_#1City_tl} {
- \ifhmode\\\fi
- \tl_if_empty:cF {l_qrbill_data_#1Country_tl}
- {\tl_use:c {l_qrbill_data_#1Country_tl}-}
- \tl_use:c {l_qrbill_data_#1PostalCode_tl}~
- \tl_use:c {l_qrbill_data_#1City_tl}
- }
- }
+ {
+ {K} {
+ \tl_use:c {l_qrbill_data_#1Address1_tl}
+ \tl_if_empty:cF {l_qrbill_data_#1Address2_tl} {
+ \ifhmode\\\fi
+ \tl_if_empty:cF {l_qrbill_data_#1Country_tl}
+ {\tl_use:c {l_qrbill_data_#1Country_tl}-}
+ \tl_use:c {l_qrbill_data_#1Address2_tl}
+ }
+ }
+ }{
+ \tl_use:c {l_qrbill_data_#1Address1_tl}~
+ \tl_use:c {l_qrbill_data_#1Address2_tl}
+ \tl_if_empty:cF {l_qrbill_data_#1City_tl} {
+ \ifhmode\\\fi
+ \tl_if_empty:cF {l_qrbill_data_#1Country_tl}
+ {\tl_use:c {l_qrbill_data_#1Country_tl}-}
+ \tl_use:c {l_qrbill_data_#1PostalCode_tl}~
+ \tl_use:c {l_qrbill_data_#1City_tl}
+ }
+ }
}
\cs_new:Nn \__qrbill_sep_tl:nn {
@@ -1124,15 +1144,15 @@
\clist_map_inline:nn {AV1, AV2} {
\keys_define:nn {qrbill/data} {
- #1 .code:n = {
- \tl_if_empty:nF {##1}{
- \exp_args:Nnx \keys_set:nn {qrbill/data} {
- #1-Parameters={\qrbill_av_prefix:n {#1}##1}
- }
- }
- \tl_set:cn {l_qrbill_#1_tl} {##1}
- },
- #1 .initial:n =,
+ #1 .code:n = {
+ \tl_if_empty:nF {##1}{
+ \exp_args:Nnx \keys_set:nn {qrbill/data} {
+ #1-Parameters={\qrbill_av_prefix:n {#1}##1}
+ }
+ }
+ \tl_set:cn {l_qrbill_#1_tl} {##1}
+ },
+ #1 .initial:n =,
}
}
@@ -1149,10 +1169,17 @@
\str_clear:N \l_qrbill_data_str
\bool_set_false:N \l_tmpa_bool
\seq_map_inline:Nn \g__qrbill_qrscheme_seq {
- \bool_if:NTF \l_tmpa_bool
- {\str_put_right:Nn\l_qrbill_data_str {^^J}}
- {\bool_set_true:N \l_tmpa_bool}
- \exp_args:NNv \str_put_right:Nn \l_qrbill_data_str {l_qrbill_data_##1_tl}
+ \clist_if_in:NnTF \g__qrbill_ignore_if_empty_clist {##1}
+ {
+ \tl_if_empty:cTF {l_qrbill_data_##1_tl} \use_none:n \use:n
+ }
+ \use:n
+ {
+ \bool_if:NTF \l_tmpa_bool
+ {\str_put_right:Nn\l_qrbill_data_str {^^J}}
+ {\bool_set_true:N \l_tmpa_bool}
+ \exp_args:NNv \str_put_right:Nn \l_qrbill_data_str {l_qrbill_data_##1_tl}
+ }
}
%necessary to preserve spaces!
\str_replace_all:Nnn \l_qrbill_data_str {~ } {\ }
@@ -1164,18 +1191,16 @@
\seq_new:N \g__qrbill_qrscheme_seq
\newcommand*\SetQrScheme[1]{
- \seq_gset_from_clist:Nn \g__qrbill_qrscheme_seq {#1}
- \seq_map_inline:Nn \g__qrbill_qrscheme_seq {
- \keys_define:nn {qrbill/data} {
- ##1 .tl_set:c = l_qrbill_data_##1_tl,
- ##1 .initial:n =,
- }
- }
+ \seq_gset_from_clist:Nn \g__qrbill_qrscheme_seq {#1}
+ \seq_map_inline:Nn \g__qrbill_qrscheme_seq {
+ \keys_define:nn {qrbill/data} {
+ ##1 .tl_set:c = l_qrbill_data_##1_tl,
+ ##1 .initial:n =,
+ }
+ }
}
-
-
-\prop_new:N \g__qrbill_billing_info_prop
+\prop_new:N \g__qrbill_billing_info_prop
\seq_new:N \g__qrbill_billing_info_seq
\clist_new:N \g__qrbill_billing_info_static_clist
@@ -1185,13 +1210,13 @@
\prop_gset_from_keyval:Nn \g__qrbill_billing_info_prop {#1}
\seq_gclear:N \g__qrbill_billing_info_seq
\prop_map_inline:Nn \g__qrbill_billing_info_prop {
- \clist_if_in:NnF \g__qrbill_billing_info_static_clist {##1} {
- \seq_push:Nn \g__qrbill_billing_info_seq {##1}
- }
- \keys_define:nn {qrbill/data} {
- ##2 .tl_set:c = l_qrbill_##2_tl,
- ##2 .initial:n =,
- }
+ \clist_if_in:NnF \g__qrbill_billing_info_static_clist {##1} {
+ \seq_push:Nn \g__qrbill_billing_info_seq {##1}
+ }
+ \keys_define:nn {qrbill/data} {
+ ##2 .tl_set:c = l_qrbill_##2_tl,
+ ##2 .initial:n =,
+ }
}
\seq_if_empty:NF \g__qrbill_billing_info_seq {
\prop_map_inline:Nn \g__qrbill_billing_info_prop {
@@ -1203,9 +1228,9 @@
}
}
\seq_sort:Nn \g__qrbill_billing_info_seq {
- \int_compare:nNnTF { ##1 } > { ##2 }
- { \sort_return_swapped: }
- { \sort_return_same: }
+ \int_compare:nNnTF { ##1 } > { ##2 }
+ { \sort_return_swapped: }
+ { \sort_return_same: }
}
}
@@ -1213,17 +1238,17 @@
\cs_new:Nn \qrbill_parse_BillingInfo: {
\bool_if:NT \g__grbill_billinginfo_auto_bool {
- \str_put_right:Nx \l_qrbill_data_BillingInfo_tl {
- \prop_item:Nn \g__qrbill_billing_info_prop {prefix}
- }
- \seq_map_inline:Nn \g__qrbill_billing_info_seq {
- \prop_get:NnN \g__qrbill_billing_info_prop {##1} \l_tmpa_tl
- \tl_if_empty:cF {l_qrbill_\l_tmpa_tl _tl} {
- \str_put_right:Nx \l_qrbill_data_BillingInfo_tl {
- /##1/\tl_use:c {l_qrbill_\l_tmpa_tl _tl}
- }
- }
- }
+ \str_put_right:Nx \l_qrbill_data_BillingInfo_tl {
+ \prop_item:Nn \g__qrbill_billing_info_prop {prefix}
+ }
+ \seq_map_inline:Nn \g__qrbill_billing_info_seq {
+ \prop_get:NnN \g__qrbill_billing_info_prop {##1} \l_tmpa_tl
+ \tl_if_empty:cF {l_qrbill_\l_tmpa_tl _tl} {
+ \str_put_right:Nx \l_qrbill_data_BillingInfo_tl {
+ /##1/\tl_use:c {l_qrbill_\l_tmpa_tl _tl}
+ }
+ }
+ }
}
}
@@ -1241,9 +1266,9 @@
\cs_new:Nn \qrbill_insert_AV_parameters:NNn {
\clist_map_inline:nn {#3} {
- \tl_if_empty:cF {l_qrbill_##1_tl}
- {{#1\qrbill_av_prefix:n {##1}}{#2 \tl_use:c {l_qrbill_##1_tl}}}
- }
+ \tl_if_empty:cF {l_qrbill_##1_tl}
+ {{#1\qrbill_av_prefix:n {##1}}{#2 \tl_use:c {l_qrbill_##1_tl}}}
+ }
}
\cs_new:Nn \qrbill_av_prefix:n {Name~#1:~}
@@ -1256,8 +1281,13 @@
% \section{The file swiss.qrbill-cfg.tex as a custom qrbill scheme}
%<*swiss.qrbill-cfg.tex>
\qrbillsetup{
- creditorprefix =CR-,
- debtorprefix =UD-,
+ creditorprefix=CR-,
+ debtorprefix=UD-,
+ ignore-if-empty={
+ AV1-Parameters,
+ AV2-Parameters,
+ BillingInfo
+ }
}
\SetQrScheme{
@@ -1320,12 +1350,12 @@
\ExplSyntaxOff
\SetupQrBill{
- QRType=SPC,
- Version=0200,
- CodingType=1,
- Trailer=EPD,
- Currency=CHF,
- ReferenceType=NON,
+ QRType=SPC,
+ Version=0200,
+ CodingType=1,
+ Trailer=EPD,
+ Currency=CHF,
+ ReferenceType=NON,
}
\qrbillsetdata*{
@@ -1402,24 +1432,24 @@
\QRbill[
creditor*={foobar LLC\\
- Postfach\\
- 404\\
- 2342\\
- Zurich\\
- CH},
+ Postfach\\
+ 404\\
+ 2342\\
+ Zurich\\
+ CH},
Account=CH1280808005649899718,
vat=123123123,% VAT number with stripped CH and periods
debtor*={peiTeX\\
- TeXnikerweg\\
- 78\\
- 23420\\
- Hamburg\\
- DE},
+ TeXnikerweg\\
+ 78\\
+ 23420\\
+ Hamburg\\
+ DE},
Amount=1337.42,
Message=Bestellung vom 27.06.2020,
invoicenum=100-4242,
% invoicedate=200701,%yymmdd, preset to todays values
- vatdetails=0,% 0% VAT
+ vatdetails=0,% 0% VAT
% invoicedate=200701,%yymmdd, preset to todays values
AV1=LX;F00BAR;2342,
]
@@ -1452,39 +1482,39 @@
width=\paperwidth,
height=105mm,
]{qrbill}
-
+
\begin{document}
\qrbillsetdata{
creditor*={foobar LLC\\
- Postfach\\
- 404\\
- 2342\\
- Zurich\\
- CH},
+ Postfach\\
+ 404\\
+ 2342\\
+ Zurich\\
+ CH},
Account=CH1280808005649899718,
vat=123123123,% VAT number with stripped CH and periods
debtor*={peiTeX\\
- TeXnikerweg\\
- 78\\
- 23420\\
- Hamburg\\
- DE},
+ TeXnikerweg\\
+ 78\\
+ 23420\\
+ Hamburg\\
+ DE},
Amount=1337.42,
Message=Bestellung vom 27.06.2020,
invoicenum=100-4242,
% invoicedate=200701,%yymmdd, preset to todays values
- vatdetails=0,% 0% VAT
+ vatdetails=0,% 0% VAT
% vatdate=200701,%yymmdd, preset to todays values
AV1=LX;F00BAR;2342,
}
\setkomavar{fromaddress}{\insertcreditor}
-
+
\begin{letter}{\insertdebtor}
-
+
\opening{opening}
Text
@@ -1492,13 +1522,13 @@ Text
\closing{closing}
% Add qbill on last page
-% For more details
+% For more details
\AddLayersToPageStyle{@everystyle@}{qrbill}
-
+
\end{letter}
\end{document}
% \end{macrocode}
-%
+%
% \iffalse
% \begin{macrocode}
%</qrbill-letter-demo.tex>
diff --git a/macros/latex/contrib/qrbill/qrbill.ins b/macros/latex/contrib/qrbill/qrbill.ins
index a2c98b2ab6..00a8697623 100644
--- a/macros/latex/contrib/qrbill/qrbill.ins
+++ b/macros/latex/contrib/qrbill/qrbill.ins
@@ -1,8 +1,5 @@
\input l3docstrip
-\def\filedate{2022/07/02}
-\def\fileversion{1.04}
-
\preamble
Copyright (C) 2020–2022 by Marei Peischl (peiTeX) <marei@peitex.de>
diff --git a/macros/latex/contrib/qrbill/qrbill.pdf b/macros/latex/contrib/qrbill/qrbill.pdf
index f515cbd69e..fe8ddd638a 100644
--- a/macros/latex/contrib/qrbill/qrbill.pdf
+++ b/macros/latex/contrib/qrbill/qrbill.pdf
Binary files differ